feat(web): file references can name a span of lines

[Brechard]

Fixes #6295.

Foo.ts:20-40 and Foo.ts#L20-L40 weren't links at all. The position pattern only took :12 and :12:5, and the external-scheme guard read :20-40 as a URI scheme and gave up.

Both parse now. splitPathAndPosition checks for a span before anything else, since the trailing number would otherwise read as a column and leave the - stranded on the path. The end line travels with the file surface into the preview, which marks every row in the range and centres the first one — the same reveal a single-line reference already used, applied to more than one row. It scans the mounted rows rather than querying each number, so a long span costs one pass and virtualized rows pick the mark up as they scroll in. A span that runs backwards, or names one line twice, is treated as its start line.

The same target also reaches the external editor, and no editor takes a span. --goto editors get the argument rebuilt as path:line, --line editors get the end dropped; both open at the range's first line instead of failing on a filename that doesn't exist. Rebuilding leaves every non-span shape byte-identical to what it was, which the launcher test pins.

No screenshots: a Foo.ts:20-40 chip opens the file with rows 20 to 40 highlighted in the existing reveal styling.

🤖 Generated with Claude Code

---

Note

Medium Risk
Touches shared path parsing used by chat links, file preview reveal, and external editor launch; regressions could break existing single-line or column references, though tests pin non-span behavior.

Overview
File references can now name a line span (Foo.ts:20-40 or GitHub-style #L20-L40), which previously failed to link at all.

Path parsing recognizes spans alongside existing line / line:column forms. Chat chips show Lstart-end, and opening a span reveals the file with every row in the range highlighted while scrolling to the start line. Backwards or degenerate spans collapse to the start line.

External editor launches also accept spans but collapse them to the first line (path:line / --line), since no editor CLI takes a range. Non-span targets stay byte-identical.

^{Reviewed by Cursor Bugbot for commit 470ea62. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add line span support to file references in chat, preview, and editor launch

• Updates regex patterns in markdown-links.ts and terminal-links.ts to parse :start-end span suffixes alongside existing :line and :line:column forms; GitHub-style #Lstart-Lend anchors are also converted.
• Chat file link chips in ChatMarkdown.tsx now display Lstart-end labels and pass span bounds to the file preview.
• FilePreviewPanel.tsx highlights the full line range by iterating over all matching data-line elements instead of selecting a single element.
• rightPanelStore.ts stores revealEndLine on file surfaces; non-forward spans (end ≤ start) are collapsed to single-line reveals.
• externalLauncher.ts collapses spans to their start line when building editor launch arguments, handling goto, direct-path, and line-column editor styles correctly.

^{Macroscope summarized 470ea62.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: cc24eef2-6cc4-45d7-a533-34f74be1e636

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit c494c8e. Configure here.}

[macroscopeapp]

Approvability

Verdict: Needs human review

This PR introduces a new feature allowing file references to specify line spans (e.g., file.ts:20-40), with changes across parsing logic, store state management, and UI rendering. New user-facing capabilities warrant human review to validate the intended behavior.

^{You can customize Macroscope's approvability policy. Learn more.}