Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
Link inline code file paths in chat markdown (#4726)
Julius Marminge55dd01612efc
diff --git a/apps/web/src/components/ChatMarkdown.tsx b/apps/web/src/components/ChatMarkdown.tsxindex fac3bf7d2..d86fe39a7 100644--- a/apps/web/src/components/ChatMarkdown.tsx+++ b/apps/web/src/components/ChatMarkdown.tsx@@ -67,8 +67,10 @@ import {import { remarkNormalizeListItemIndentation } from "../markdown-list-indentation";import {normalizeMarkdownLinkDestination,+ resolveInlineCodeFileLinkMeta,resolveMarkdownFileLinkMeta,rewriteMarkdownFileUriHref,+ type MarkdownFileLinkMeta,} from "../markdown-links";import { readLocalApi } from "../localApi";import { cn } from "../lib/utils";@@ -162,7 +164,7 @@ const CHAT_MARKDOWN_SANITIZE_SCHEMA = {attributes: {...defaultSchema.attributes,"*": (defaultSchema.attributes?.["*"] ?? []).filter((attribute) => attribute !== "title"),- code: [...(defaultSchema.attributes?.code ?? []), "dataCodeMeta"],+ code: [...(defaultSchema.attributes?.code ?? []), "dataCodeMeta", "dataInlineCode"],},protocols: {...defaultSchema.protocols,@@ -174,6 +176,7 @@ const CHAT_MARKDOWN_REMARK_PLUGINS = [remarkGfm,remarkNormalizeListItemIndentation,remarkPreserveCodeMeta,+ remarkTagInlineCode,] satisfies NonNullable<ReactMarkdownOptions["remarkPlugins"]>;const CHAT_MARKDOWN_REMARK_PLUGINS_WITH_BREAKS = [@@ -181,6 +184,7 @@ const CHAT_MARKDOWN_REMARK_PLUGINS_WITH_BREAKS = [remarkNormalizeListItemIndentation,remarkBreaks,remarkPreserveCodeMeta,+ remarkTagInlineCode,] satisfies NonNullable<ReactMarkdownOptions["remarkPlugins"]>;const CHAT_MARKDOWN_REHYPE_PLUGINS = [@@ -253,6 +257,33 @@ function remarkPreserveCodeMeta() {};}+/**+ * Fenced code also lands on the `code` component, and inline vs block is no+ * longer distinguishable there once both render `<code>` — so inline spans are+ * tagged on the mdast, where the distinction still exists. Code inside a link+ * label stays untagged: linkifying it would nest an anchor inside the link's+ * anchor and steal its clicks.+ */+function remarkTagInlineCode() {+ return (tree: MarkdownAstNode) => {+ const visit = (node: MarkdownAstNode, insideLink: boolean) => {+ if (node.type === "inlineCode" && !insideLink) {+ node.data = {+ ...node.data,+ hProperties: {+ ...node.data?.hProperties,+ dataInlineCode: "",+ },+ };+ }+ const childInsideLink = insideLink || node.type === "link" || node.type === "linkReference";+ node.children?.forEach((child) => visit(child, childInsideLink));+ };++ visit(tree, false);+ };+}+function nodeToPlainText(node: ReactNode): string {if (typeof node === "string" || typeof node === "number") {return String(node);@@ -276,11 +307,17 @@ function extractCodeBlock(const onlyChild = childNodes[0];if (- !isValidElement<{ className?: string; children?: ReactNode }>(onlyChild) ||- onlyChild.type !== "code"+ !isValidElement<{ className?: string; children?: ReactNode; node?: { tagName?: string } }>(+ onlyChild,+ )) {return null;}+ // With a custom `code` component the child's type is that component, not+ // the "code" tag — the hast node react-markdown attaches still names it.+ if (onlyChild.type !== "code" && onlyChild.props.node?.tagName !== "code") {+ return null;+ }return {className: onlyChild.props.className,@@ -816,6 +853,21 @@ function buildFileLinkParentSuffixByPath(filePaths: ReadonlyArray<string>): Map<return suffixByPath;}+const FENCED_CODE_SEGMENT_PATTERN = /(```[\s\S]*?(?:```|$))/;+const INLINE_CODE_SPAN_PATTERN = /`([^`\n]+)`/g;++function extractInlineCodeSpans(text: string): string[] {+ const spans: string[] = [];+ const segments = text.split(FENCED_CODE_SEGMENT_PATTERN);+ for (let index = 0; index < segments.length; index += 2) {+ for (const match of (segments[index] ?? "").matchAll(INLINE_CODE_SPAN_PATTERN)) {+ const span = match[1]?.trim();+ if (span) spans.push(span);+ }+ }+ return spans;+}+function extractMarkdownLinkHrefs(text: string): string[] {const hrefs: string[] = [];for (const match of text.matchAll(MARKDOWN_LINK_HREF_PATTERN)) {@@ -1281,10 +1333,24 @@ function ChatMarkdown({}return metaByHref;}, [cwd, text]);+ const inlineCodeFileLinkMetaByText = useMemo(() => {+ const metaByText = new Map<string, MarkdownFileLinkMeta>();+ for (const span of extractInlineCodeSpans(text)) {+ if (metaByText.has(span)) continue;+ const meta = resolveInlineCodeFileLinkMeta(span, cwd);+ if (meta) {+ metaByText.set(span, meta);+ }+ }+ return metaByText;+ }, [cwd, text]);const fileLinkParentSuffixByPath = useMemo(() => {- const filePaths = [...markdownFileLinkMetaByHref.values()].map((meta) => meta.filePath);+ const filePaths = [+ ...[...markdownFileLinkMetaByHref.values()].map((meta) => meta.filePath),+ ...[...inlineCodeFileLinkMetaByText.values()].map((meta) => meta.filePath),+ ];return buildFileLinkParentSuffixByPath(filePaths);- }, [markdownFileLinkMetaByHref]);+ }, [inlineCodeFileLinkMetaByText, markdownFileLinkMetaByHref]);const markdownUrlTransform = useCallback((href: string) => {return rewriteMarkdownFileUriHref(href) ?? defaultUrlTransform(href);}, []);@@ -1339,8 +1405,49 @@ function ChatMarkdown({},[createAssetUrl, openPreview, preparedConnection, threadRef],);- const markdownComponents = useMemo<Components>(- () => ({+ const markdownComponents = useMemo<Components>(() => {+ const fileLinkChip = (+ fileLinkMeta: MarkdownFileLinkMeta,+ copyMarkdown: string,+ className?: string,+ ) => {+ const parentSuffix = fileLinkParentSuffixByPath.get(fileLinkMeta.filePath);+ const labelParts = [fileLinkMeta.basename];+ if (typeof parentSuffix === "string" && parentSuffix.length > 0) {+ labelParts.push(parentSuffix);+ }+ if (fileLinkMeta.line) {+ labelParts.push(+ `L${fileLinkMeta.line}${fileLinkMeta.column ? `:C${fileLinkMeta.column}` : ""}`,+ );+ }++ return (+ <MarkdownFileLink+ href={fileLinkMeta.targetPath}+ targetPath={fileLinkMeta.targetPath}+ iconPath={fileLinkMeta.filePath}+ displayPath={fileLinkMeta.displayPath}+ workspaceRelativePath={fileLinkMeta.workspaceRelativePath}+ line={fileLinkMeta.line}+ label={labelParts.join(" · ")}+ copyMarkdown={copyMarkdown}+ theme={resolvedTheme}+ threadRef={threadRef}+ onOpen={openInPreferredEditor}+ onOpenInBrowser={+ threadRef &&+ isPreviewSupportedInRuntime() &&+ isBrowserPreviewFile(fileLinkMeta.filePath)+ ? () => openMarkdownFileInPreview(fileLinkMeta.filePath)+ : undefined+ }+ className={className}+ />+ );+ };++ return {p({ node: _node, children, ...props }) {return <p {...props}>{renderSkillInlineMarkdownChildren(children, skills)}</p>;},@@ -1455,39 +1562,26 @@ function ChatMarkdown({);}- const parentSuffix = fileLinkParentSuffixByPath.get(fileLinkMeta.filePath);- const labelParts = [fileLinkMeta.basename];- if (typeof parentSuffix === "string" && parentSuffix.length > 0) {- labelParts.push(parentSuffix);- }- if (fileLinkMeta.line) {- labelParts.push(- `L${fileLinkMeta.line}${fileLinkMeta.column ? `:C${fileLinkMeta.column}` : ""}`,- );+ return fileLinkChip(+ fileLinkMeta,+ `[${fileLinkMeta.basename}](${normalizedHref})`,+ props.className,+ );+ },+ code({ node, children, className, ...props }) {+ if (node?.properties?.dataInlineCode != null) {+ const codeText = nodeToPlainText(children);+ const fileLinkMeta =+ inlineCodeFileLinkMetaByText.get(codeText.trim()) ??+ resolveInlineCodeFileLinkMeta(codeText, cwd);+ if (fileLinkMeta) {+ return fileLinkChip(fileLinkMeta, `\`${codeText}\``);+ }}-return (- <MarkdownFileLink- href={fileLinkMeta.targetPath}- targetPath={fileLinkMeta.targetPath}- iconPath={fileLinkMeta.filePath}- displayPath={fileLinkMeta.displayPath}- workspaceRelativePath={fileLinkMeta.workspaceRelativePath}- line={fileLinkMeta.line}- label={labelParts.join(" · ")}- copyMarkdown={`[${fileLinkMeta.basename}](${normalizedHref})`}- theme={resolvedTheme}- threadRef={threadRef}- onOpen={openInPreferredEditor}- onOpenInBrowser={- threadRef &&- isPreviewSupportedInRuntime() &&- isBrowserPreviewFile(fileLinkMeta.filePath)- ? () => openMarkdownFileInPreview(fileLinkMeta.filePath)- : undefined- }- className={props.className}- />+ <code {...props} className={className}>+ {children}+ </code>);},table({ node: _node, ...props }) {@@ -1524,22 +1618,23 @@ function ChatMarkdown({</MarkdownCodeBlock>);},- }),- [- diffThemeName,- fileLinkParentSuffixByPath,- isStreaming,- markdownFileLinkMetaByHref,- onTaskListChange,- openInPreferredEditor,- openExternalLinkInPreview,- openMarkdownFileInPreview,- resolvedTheme,- skills,- text,- threadRef,- ],- );+ };+ }, [+ cwd,+ diffThemeName,+ fileLinkParentSuffixByPath,+ inlineCodeFileLinkMetaByText,+ isStreaming,+ markdownFileLinkMetaByHref,+ onTaskListChange,+ openInPreferredEditor,+ openExternalLinkInPreview,+ openMarkdownFileInPreview,+ resolvedTheme,+ skills,+ text,+ threadRef,+ ]);return (<divdiff --git a/apps/web/src/components/chat/SkillInlineText.tsx b/apps/web/src/components/chat/SkillInlineText.tsxindex 444f35b42..0acff1a8f 100644--- a/apps/web/src/components/chat/SkillInlineText.tsx+++ b/apps/web/src/components/chat/SkillInlineText.tsx@@ -52,10 +52,13 @@ export function renderSkillInlineMarkdownChildren(if (typeof child === "string") {return <SkillInlineText text={child} skills={skills} />;}- if (!isValidElement<{ children?: ReactNode }>(child)) {+ if (!isValidElement<{ children?: ReactNode; node?: { tagName?: string } }>(child)) {return child;}- if (child.type === "code" || child.type === "a") {+ // Custom react-markdown components replace the intrinsic type, so also+ // check the hast node they carry.+ const markdownTagName = typeof child.type === "string" ? child.type : child.props.node?.tagName;+ if (markdownTagName === "code" || markdownTagName === "a") {return child;}if (!("children" in child.props)) {diff --git a/apps/web/src/markdown-links.test.ts b/apps/web/src/markdown-links.test.tsindex 5691ffa88..9fc296138 100644--- a/apps/web/src/markdown-links.test.ts+++ b/apps/web/src/markdown-links.test.ts@@ -1,6 +1,7 @@import { describe, expect, it } from "vite-plus/test";import {+ resolveInlineCodeFileLinkMeta,resolveMarkdownFileLinkMeta,resolveMarkdownFileLinkTarget,rewriteMarkdownFileUriHref,@@ -127,3 +128,148 @@ describe("resolveMarkdownFileLinkTarget", () => {expect(resolveMarkdownFileLinkTarget("/chat/settings")).toBeNull();});});++describe("resolveInlineCodeFileLinkMeta", () => {+ it("links relative paths with file extensions", () => {+ expect(+ resolveInlineCodeFileLinkMeta(".plans/worktree-management-v1.md", "/Users/julius/project"),+ ).toMatchObject({+ targetPath: "/Users/julius/project/.plans/worktree-management-v1.md",+ basename: "worktree-management-v1.md",+ });+ });++ it("links absolute posix paths", () => {+ expect(resolveInlineCodeFileLinkMeta("/Users/julius/project/AGENTS.md")).toMatchObject({+ targetPath: "/Users/julius/project/AGENTS.md",+ });+ expect(resolveInlineCodeFileLinkMeta("/usr/local/bin/tool")).toMatchObject({+ targetPath: "/usr/local/bin/tool",+ });+ expect(resolveInlineCodeFileLinkMeta("/workspace/Makefile")).toMatchObject({+ basename: "Makefile",+ });+ expect(resolveInlineCodeFileLinkMeta("/chat/settings")).toBeNull();+ });++ it("links windows drive paths", () => {+ expect(resolveInlineCodeFileLinkMeta("C:\\Users\\mike\\project\\src\\main.ts")).toMatchObject({+ basename: "main.ts",+ });+ });++ it("links relative paths with line positions", () => {+ expect(+ resolveInlineCodeFileLinkMeta("src/processRunner.ts:71", "/Users/julius/project"),+ ).toMatchObject({+ targetPath: "/Users/julius/project/src/processRunner.ts:71",+ line: 71,+ });+ });++ it("links bare filenames only when a line suffix marks them as file references", () => {+ expect(resolveInlineCodeFileLinkMeta("script.ts:10", "/Users/julius/project")).toMatchObject({+ targetPath: "/Users/julius/project/script.ts:10",+ line: 10,+ });+ expect(resolveInlineCodeFileLinkMeta("AGENTS.md", "/Users/julius/project")).toBeNull();+ });++ it("links extensionless bare filenames with a line suffix", () => {+ expect(resolveInlineCodeFileLinkMeta("Makefile:12", "/Users/julius/project")).toMatchObject({+ targetPath: "/Users/julius/project/Makefile:12",+ basename: "Makefile",+ line: 12,+ });+ expect(resolveInlineCodeFileLinkMeta("Dockerfile:8:2", "/Users/julius/project")).toMatchObject({+ line: 8,+ column: 2,+ });+ expect(resolveInlineCodeFileLinkMeta("Makefile:12")).toBeNull();+ });++ it("does not treat arbitrary name:digits shapes as files", () => {+ expect(resolveInlineCodeFileLinkMeta("error:1", "/Users/julius/project")).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("TODO:12", "/Users/julius/project")).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("exit:0", "/Users/julius/project")).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("port:3000", "/Users/julius/project")).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("http:80", "/Users/julius/project")).toBeNull();+ });++ it("links dot-prefixed relative paths without extensions", () => {+ expect(+ resolveInlineCodeFileLinkMeta("./scripts/deploy", "/Users/julius/project"),+ ).toMatchObject({+ basename: "deploy",+ });+ });++ it("links relative windows-style paths by normalizing backslashes", () => {+ expect(resolveInlineCodeFileLinkMeta("src\\main.ts", "/Users/julius/project")).toMatchObject({+ targetPath: "/Users/julius/project/src/main.ts",+ basename: "main.ts",+ });+ expect(+ resolveInlineCodeFileLinkMeta(".\\scripts\\deploy", "/Users/julius/project"),+ ).toMatchObject({+ basename: "deploy",+ });+ });++ it("ignores hosts, ports, and versions", () => {+ expect(resolveInlineCodeFileLinkMeta("127.0.0.1:3000", "/Users/julius/project")).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("localhost:3000", "/Users/julius/project")).toBeNull();+ expect(+ resolveInlineCodeFileLinkMeta("example.com/index.html", "/Users/julius/project"),+ ).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("example.com:8080", "/Users/julius/project")).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("10.0.0.1:80:1", "/Users/julius/project")).toBeNull();+ expect(+ resolveInlineCodeFileLinkMeta("localhost/index.html", "/Users/julius/project"),+ ).toBeNull();+ expect(+ resolveInlineCodeFileLinkMeta("example.uk/index.html", "/Users/julius/project"),+ ).toBeNull();+ });++ it("still links files whose extension merely resembles a tld", () => {+ expect(resolveInlineCodeFileLinkMeta("script.ts:10", "/Users/julius/project")).not.toBeNull();+ expect(resolveInlineCodeFileLinkMeta("src/setup.sh:3", "/Users/julius/project")).not.toBeNull();+ expect(resolveInlineCodeFileLinkMeta("Makefile.in:12", "/Users/julius/project")).not.toBeNull();+ expect(+ resolveInlineCodeFileLinkMeta("conf.d/nginx.conf", "/Users/julius/project"),+ ).not.toBeNull();+ });++ it("prefers file over country-code host when a line suffix is present", () => {+ expect(resolveInlineCodeFileLinkMeta("script.pl:10", "/Users/julius/project")).toMatchObject({+ targetPath: "/Users/julius/project/script.pl:10",+ line: 10,+ });+ expect(resolveInlineCodeFileLinkMeta("model.pt:3", "/Users/julius/project")).not.toBeNull();+ expect(+ resolveInlineCodeFileLinkMeta("example.pl/index.html", "/Users/julius/project"),+ ).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("example.com:8080", "/Users/julius/project")).toBeNull();+ });++ it("ignores commands, flags, and expressions", () => {+ expect(resolveInlineCodeFileLinkMeta("git worktree list --porcelain")).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("node.meta", "/Users/julius/project")).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("pnpm install", "/Users/julius/project")).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("src/**/*.ts", "/Users/julius/project")).toBeNull();+ });++ it("ignores extension-less relative segments like git refs and directories", () => {+ expect(resolveInlineCodeFileLinkMeta("origin/main", "/Users/julius/project")).toBeNull();+ expect(resolveInlineCodeFileLinkMeta("apps/web", "/Users/julius/project")).toBeNull();+ });++ it("ignores external urls", () => {+ expect(resolveInlineCodeFileLinkMeta("https://example.com/docs.html")).toBeNull();+ });++ it("ignores relative paths without a cwd to resolve against", () => {+ expect(resolveInlineCodeFileLinkMeta(".plans/worktree-management-v1.md")).toBeNull();+ });+});diff --git a/apps/web/src/markdown-links.ts b/apps/web/src/markdown-links.tsindex 1e24de8bb..a6dba941b 100644--- a/apps/web/src/markdown-links.ts+++ b/apps/web/src/markdown-links.ts@@ -9,6 +9,8 @@ const RELATIVE_FILE_PATH_PATTERN = /^[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)+(?::\dconst RELATIVE_FILE_NAME_PATTERN = /^[A-Za-z0-9._-]+\.[A-Za-z0-9_-]+(?::\d+){0,2}$/;const POSITION_SUFFIX_PATTERN = /:\d+(?::\d+)?$/;const POSITION_ONLY_PATTERN = /^\d+(?::\d+)?$/;+// Standard OS and dev-container roots; deliberately excludes app-route-ish+// prefixes like /app/ or /chat/ so SPA routes never read as files.const POSIX_FILE_ROOT_PREFIXES = ["/Users/","/home/",@@ -20,6 +22,20 @@ const POSIX_FILE_ROOT_PREFIXES = ["/Volumes/","/private/","/root/",+ "/usr/",+ "/bin/",+ "/sbin/",+ "/lib/",+ "/lib64/",+ "/srv/",+ "/dev/",+ "/proc/",+ "/sys/",+ "/run/",+ "/boot/",+ "/media/",+ "/workspace/",+ "/workspaces/",] as const;export interface MarkdownFileLinkMeta {@@ -170,6 +186,178 @@ export function resolveMarkdownFileLinkTarget(return resolvePathLinkTarget(pathWithPosition, cwd);}+const INLINE_CODE_DISQUALIFIER_PATTERN = /[\s`]/;+const PATH_SEPARATOR_PATTERN = /[\\/]/;+const FILE_EXTENSION_PATTERN = /\.[A-Za-z0-9_-]+$/;+const NUMERIC_DOTTED_PATTERN = /^\d+(?:\.\d+)+$/;+const BARE_EXTENSIONLESS_POSITION_PATTERN = /^[A-Za-z0-9_-]+(?::\d+){1,2}$/;+// Any `Name:digits` shape also matches `error:1`, `port:3000`, `TODO:12`, so+// extensionless linking is limited to conventional filenames.+const EXTENSIONLESS_FILE_NAMES = new Set([+ "Makefile",+ "makefile",+ "GNUmakefile",+ "Dockerfile",+ "Containerfile",+ "Justfile",+ "justfile",+ "Rakefile",+ "Gemfile",+ "Procfile",+ "Brewfile",+ "Caddyfile",+ "Vagrantfile",+ "Jenkinsfile",+ "Podfile",+ "Fastfile",+ "BUILD",+ "WORKSPACE",+ "LICENSE",+ "LICENCE",+ "COPYING",+ "NOTICE",+ "AUTHORS",+ "CONTRIBUTORS",+ "CHANGELOG",+ "README",+ "CODEOWNERS",+]);+const SINGLE_LABEL_HOSTNAMES = new Set(["localhost"]);+// Allowlists, not full public-suffix detection: treating every dotted first+// segment as a host would swallow real paths like `conf.d/x.conf` or+// `Makefile.in:12`. Extensions that double as filename suffixes (`sh`, `md`,+// `ts`, `rs`, `in`, ...) are deliberately absent from both sets.+const GENERIC_HOSTNAME_TLDS = new Set([+ "com",+ "net",+ "org",+ "io",+ "dev",+ "app",+ "ai",+ "co",+ "edu",+ "gov",+ "mil",+ "info",+ "biz",+ "xyz",+ "me",+ "tv",+ "cc",+ "gg",+ "chat",+ "cloud",+ "site",+ "online",+ "tech",+ "store",+ "link",+]);+// Country codes collide with file extensions (`.pl` Perl, `.pt` PyTorch,+// `.es` ES modules), so they only count as host evidence when the candidate+// lacks a :line suffix — an explicit line reference marks a file and wins.+const COUNTRY_HOSTNAME_TLDS = new Set([+ "uk",+ "de",+ "fr",+ "nl",+ "se",+ "no",+ "fi",+ "dk",+ "pl",+ "ch",+ "at",+ "be",+ "es",+ "it",+ "pt",+ "eu",+ "us",+ "ca",+ "au",+ "nz",+ "jp",+ "kr",+ "cn",+ "br",+ "ru",+ "mx",+ "ie",+ "cz",+ "tr",+ "sg",+ "hk",+]);++/** `127.0.0.1`, `localhost`, `example.com`, `1.2.3` — hosts and versions, not files. */+function looksLikeHostname(segment: string, hasPosition: boolean): boolean {+ if (segment.startsWith(".")) return false;+ const lowered = segment.toLowerCase();+ if (SINGLE_LABEL_HOSTNAMES.has(lowered)) return true;+ if (NUMERIC_DOTTED_PATTERN.test(segment)) return true;+ const labels = lowered.split(".");+ const lastLabel = labels[labels.length - 1];+ if (labels.length < 2 || lastLabel === undefined) return false;+ if (GENERIC_HOSTNAME_TLDS.has(lastLabel)) return true;+ return !hasPosition && COUNTRY_HOSTNAME_TLDS.has(lastLabel);+}++/**+ * Inline code spans mostly hold identifiers, commands, and refs (`node.meta`,+ * `origin/main`) rather than deliberate link destinations, so auto-linking+ * them demands stronger path evidence than an explicit markdown link does:+ * an unambiguous path prefix, a file extension, or a :line suffix.+ */+export function resolveInlineCodeFileLinkMeta(+ codeText: string,+ cwd?: string,+): MarkdownFileLinkMeta | null {+ const trimmed = codeText.trim();+ if (trimmed.length === 0 || INLINE_CODE_DISQUALIFIER_PATTERN.test(trimmed)) return null;++ // Windows drive/UNC paths keep their backslashes; any other backslashes are+ // relative Windows-style paths, which neither the shape checks nor the+ // downstream resolver understand — normalize them to forward slashes.+ const candidate =+ WINDOWS_DRIVE_PATH_PATTERN.test(trimmed) || WINDOWS_UNC_PATH_PATTERN.test(trimmed)+ ? trimmed+ : trimmed.replaceAll("\\", "/");++ const hasPosition = POSITION_SUFFIX_PATTERN.test(candidate);+ if (!hasPosition && !PATH_SEPARATOR_PATTERN.test(candidate)) return null;++ const hasExplicitPathShape =+ RELATIVE_PATH_PREFIX_PATTERN.test(candidate) ||+ candidate.startsWith("/") ||+ WINDOWS_DRIVE_PATH_PATTERN.test(candidate) ||+ WINDOWS_UNC_PATH_PATTERN.test(candidate);+ if (!hasExplicitPathShape) {+ const withoutPosition = candidate.replace(POSITION_SUFFIX_PATTERN, "");+ const firstSegment = withoutPosition.split("/")[0] ?? withoutPosition;+ if (looksLikeHostname(firstSegment, hasPosition)) return null;+ if (!hasPosition && !FILE_EXTENSION_PATTERN.test(basenameOfPath(withoutPosition))) {+ return null;+ }+ }++ const resolved = resolveMarkdownFileLinkMeta(candidate, cwd);+ if (resolved) return resolved;++ // `Makefile:12` — conventional extensionless names fail the generic+ // markdown-link candidate patterns, but here the :line suffix already+ // marked the span as a file reference.+ if (+ cwd &&+ BARE_EXTENSIONLESS_POSITION_PATTERN.test(candidate) &&+ EXTENSIONLESS_FILE_NAMES.has(candidate.replace(POSITION_SUFFIX_PATTERN, ""))+ ) {+ return buildFileLinkMetaFromTarget(resolvePathLinkTarget(candidate, cwd), cwd);+ }+ return null;+}+function basenameOfPath(path: string): string {const separatorIndex = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));return separatorIndex >= 0 ? path.slice(separatorIndex + 1) : path;@@ -194,7 +382,10 @@ export function resolveMarkdownFileLinkMeta(): MarkdownFileLinkMeta | null {const targetPath = resolveMarkdownFileLinkTarget(href, cwd);if (!targetPath) return null;+ return buildFileLinkMetaFromTarget(targetPath, cwd);+}+function buildFileLinkMetaFromTarget(targetPath: string, cwd?: string): MarkdownFileLinkMeta {const { path, line, column } = splitPathAndPosition(targetPath);const parsedLine = line ? Number.parseInt(line, 10) : Number.NaN;const parsedColumn = column ? Number.parseInt(column, 10) : Number.NaN;