@tooee/view 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -14,4 +14,6 @@ export type { AnyContent, Content, ContentChunk, ContentFormat, ContentProvider,
 export { getTextContent, isBuiltinContent, isCustomContent } from "./types.js";
 export { CodeBlockChrome } from "@tooee/renderers";
 export type { CodeBlockRenderer, CodeBlockRendererProps, CodeBlockHScroll } from "@tooee/renderers";
+export { localFileLinkHandler } from "./link-handlers.js";
+export type { LinkHandler, LinkHandlerContext, LinkTarget } from "./link-handlers.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,+BAA+B,EAC/B,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EACV,UAAU,EACV,OAAO,EACP,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,EACf,2BAA2B,EAC3B,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,+BAA+B,EAC/B,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EACV,UAAU,EACV,OAAO,EACP,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,EACf,2BAA2B,EAC3B,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -6,4 +6,5 @@ export { listDirectoryFiles } from "./directory-provider.js";
 export { createViewCommandContext, useProvideViewCommandContext, } from "./hooks/use-view-command-context.js";
 export { getTextContent, isBuiltinContent, isCustomContent } from "./types.js";
 export { CodeBlockChrome } from "@tooee/renderers";
+export { localFileLinkHandler } from "./link-handlers.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,qCAAqC,CAAC;AA6B7C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EACL,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,qCAAqC,CAAC;AA6B7C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/launch.d.ts

@@ -1,8 +1,13 @@
 import type { ActionDefinition } from "@tooee/commands";
 import type { CodeBlockRenderer } from "@tooee/renderers";
+import type { LinkHandler } from "./link-handlers.js";
 import type { ContentProvider, ContentRenderer } from "./types.js";
 export interface ViewLaunchOptions {
     contentProvider: ContentProvider;
+    /** Source file for standalone local Markdown navigation; omitted for stdin. */
+    filePath?: string;
+    /** Synchronous handlers tried before local file navigation. */
+    linkHandlers?: readonly LinkHandler[];
     actions?: ActionDefinition[];
     renderers?: Record<string, ContentRenderer>;
     /**

package/dist/launch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../src/launch.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnE,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,MAAM,YAAkC,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAWpF,CAAC;AAEF,eAAO,MAAM,eAAe,YACjB,sBAAsB,KAC9B,OAAO,CAAC,IAAI,CAEd,CAAC"}
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../src/launch.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnE,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,MAAM,YAAkC,iBAAiB,KAAG,OAAO,CAAC,IAAI,CAiBpF,CAAC;AAEF,eAAO,MAAM,eAAe,YACjB,sBAAsB,KAC9B,OAAO,CAAC,IAAI,CAId,CAAC"}

package/dist/launch.js

@@ -1,11 +1,22 @@
 import { jsx as _jsx } from "@opentui/react/jsx-runtime";
 import { launchCli, runCliSession } from "@tooee/shell";
-import { View } from "./view.js";
+import { Outlet, RouterProvider } from "@tooee/router";
+import { createStandaloneRouter } from "./standalone-router.js";
 import { DirectoryView } from "./directory-view.js";
 export const launch = async function launch(options) {
-    await runCliSession(() => (_jsx(View, { contentProvider: options.contentProvider, actions: options.actions, renderers: options.renderers, codeBlockRenderers: options.codeBlockRenderers })));
+    const { router } = createStandaloneRouter(options);
+    const startup = await router.start();
+    if (startup.status !== "committed") {
+        throw new Error(`View router startup ${startup.status}`);
+    }
+    await runCliSession(() => (_jsx(RouterProvider, { router: router, children: _jsx(Outlet, {}) })), {
+        stdinPolicy: "tty-if-piped",
+        stdoutPolicy: "tty-if-redirected",
+    });
 };
 export const launchDirectory = async function launchDirectory(options) {
-    await launchCli(_jsx(DirectoryView, { dirPath: options.dirPath, actions: options.actions }));
+    await launchCli(_jsx(DirectoryView, { dirPath: options.dirPath, actions: options.actions }), {
+        stdoutPolicy: "tty-if-redirected",
+    });
 };
 //# sourceMappingURL=launch.js.map

package/dist/launch.js.map

@@ -1 +1 @@
-{"version":3,"file":"launch.js","sourceRoot":"","sources":["../src/launch.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAqBpD,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,UAAU,MAAM,CAAC,OAA0B;IACpE,MAAM,aAAa,CACjB,GAAc,EAAE,CAAC,CACf,KAAC,IAAI,IACH,eAAe,EAAE,OAAO,CAAC,eAAe,EACxC,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,SAAS,EAAE,OAAO,CAAC,SAAS,EAC5B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,GAC9C,CACH,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,UAAU,eAAe,CAC3D,OAA+B;IAE/B,MAAM,SAAS,CAAC,KAAC,aAAa,IAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,GAAI,CAAC,CAAC;AACzF,CAAC,CAAC"}
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../src/launch.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAyBpD,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,UAAU,MAAM,CAAC,OAA0B;IACpE,MAAM,EAAE,MAAM,EAAE,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrC,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,aAAa,CACjB,GAAc,EAAE,CAAC,CACf,KAAC,cAAc,IAAC,MAAM,EAAE,MAAM,YAC5B,KAAC,MAAM,KAAG,GACK,CAClB,EACD;QACE,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,mBAAmB;KAClC,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,UAAU,eAAe,CAC3D,OAA+B;IAE/B,MAAM,SAAS,CAAC,KAAC,aAAa,IAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,GAAI,EAAE;QACrF,YAAY,EAAE,mBAAmB;KAClC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/link-handlers.d.ts

@@ -0,0 +1,21 @@
+import type { CommandContext } from "@tooee/commands";
+import type { NavigateHandle, RouteDefinition } from "@tooee/router";
+export interface LinkTarget {
+    href: string;
+    /** Directory that relative targets resolve against. */
+    baseDir: string;
+    /** Source document for fragment-only links. */
+    currentPath?: string;
+}
+export interface LinkHandlerContext {
+    navigate: NavigateHandle;
+    documentRoute: RouteDefinition<{
+        path?: string;
+    }>;
+    command: CommandContext;
+}
+/** Decide synchronously: true consumes the link, false tries the next handler. */
+export type LinkHandler = (link: LinkTarget, context: LinkHandlerContext) => boolean;
+export declare const localFileLinkHandler: LinkHandler;
+export declare const runLinkHandlers: (handlers: readonly LinkHandler[], link: LinkTarget, context: LinkHandlerContext) => boolean;
+//# sourceMappingURL=link-handlers.d.ts.map

package/dist/link-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-handlers.d.ts","sourceRoot":"","sources":["../src/link-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,EAAE,eAAe,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,kFAAkF;AAClF,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC;AAErF,eAAO,MAAM,oBAAoB,EAAE,WAmBlC,CAAC;AAEF,eAAO,MAAM,eAAe,aAChB,SAAS,WAAW,EAAE,QAC1B,UAAU,WACP,kBAAkB,KAC1B,OAYF,CAAC"}

package/dist/link-handlers.js

@@ -0,0 +1,35 @@
+import path from "node:path";
+import { resolveMarkdownLink } from "./markdown-links.js";
+export const localFileLinkHandler = function localFileLinkHandler(link, context) {
+    const result = resolveMarkdownLink(link.href, link.baseDir, link.currentPath);
+    if (result.status === "unsupported") {
+        return false;
+    }
+    if (result.status === "file") {
+        void context.navigate.push(context.documentRoute, { path: result.path });
+        return true;
+    }
+    const relative = path.relative(link.baseDir, result.path);
+    const target = relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)
+        ? result.path
+        : relative || ".";
+    context.command.toast?.toast({
+        level: "warning",
+        message: `${result.status === "missing" ? "File not found" : "Not a file"}: ${target}`,
+    });
+    return true;
+};
+export const runLinkHandlers = function runLinkHandlers(handlers, link, context) {
+    for (const handler of handlers) {
+        // oxlint-disable-next-line typescript/no-unnecessary-boolean-literal-compare -- preserve exact-true consumption for JavaScript callers too
+        if (handler(link, context) === true) {
+            return true;
+        }
+    }
+    if (localFileLinkHandler(link, context)) {
+        return true;
+    }
+    context.command.toast?.toast({ level: "warning", message: `Unsupported link: ${link.href}` });
+    return true;
+};
+//# sourceMappingURL=link-handlers.js.map

package/dist/link-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-handlers.js","sourceRoot":"","sources":["../src/link-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAmB1D,MAAM,CAAC,MAAM,oBAAoB,GAAgB,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO;IAC1F,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7B,KAAK,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,MAAM,GACV,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QACpF,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;IACtB,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;QAC3B,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,KAAK,MAAM,EAAE;KACvF,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,eAAe,CACrD,QAAgC,EAChC,IAAgB,EAChB,OAA2B;IAE3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,2IAA2I;QAC3I,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,IAAI,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,qBAAqB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9F,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/markdown-links.d.ts

@@ -0,0 +1,21 @@
+export type LinkResolution = {
+    status: "file";
+    path: string;
+} | {
+    status: "missing";
+    path: string;
+} | {
+    status: "directory";
+    path: string;
+} | {
+    status: "unsupported";
+};
+/** Existing local files only. Fragments are validated, then open at the file top. */
+export declare const resolveMarkdownLink: (href: string, baseDir: string, currentPath?: string) => LinkResolution;
+export interface MarkdownLink {
+    /** Link text as written in the source. */
+    text: string;
+    href: string;
+}
+export declare const markdownLinks: (line: string) => MarkdownLink[];
+//# sourceMappingURL=markdown-links.d.ts.map

package/dist/markdown-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-links.d.ts","sourceRoot":"","sources":["../src/markdown-links.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAE9B,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,SACxB,MAAM,WACH,MAAM,gBACD,MAAM,KACnB,cA6CF,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAeD,eAAO,MAAM,aAAa,SAAgC,MAAM,KAAG,YAAY,EAI9E,CAAC"}

package/dist/markdown-links.js

@@ -0,0 +1,74 @@
+import { statSync } from "node:fs";
+import nodePath from "node:path";
+import { fileURLToPath } from "node:url";
+import { Lexer } from "marked";
+/** Existing local files only. Fragments are validated, then open at the file top. */
+export const resolveMarkdownLink = function resolveMarkdownLink(href, baseDir, currentPath) {
+    try {
+        const decoded = decodeURIComponent(href);
+        if (/[\p{Cc}\\]/u.test(decoded)) {
+            return { status: "unsupported" };
+        }
+        const target = href.trim();
+        if (!target || target.startsWith("//")) {
+            return { status: "unsupported" };
+        }
+        const [rawPath] = target.split("#", 1);
+        if (rawPath.includes("?")) {
+            return { status: "unsupported" };
+        }
+        let path;
+        if (/^[a-zA-Z][a-zA-Z\d+.-]*:/u.test(rawPath)) {
+            // Check the authority before URL normalizes localhost into an empty host.
+            if (!/^file:\/\/\//iu.test(rawPath)) {
+                return { status: "unsupported" };
+            }
+            const url = new URL(rawPath);
+            if (url.hostname || url.search) {
+                return { status: "unsupported" };
+            }
+            path = fileURLToPath(url);
+        }
+        else {
+            path = rawPath
+                ? nodePath.resolve(baseDir, decodeURIComponent(rawPath))
+                : (currentPath ?? baseDir);
+        }
+        const absolute = nodePath.resolve(path);
+        try {
+            const stat = statSync(absolute);
+            if (stat.isFile()) {
+                return { path: absolute, status: "file" };
+            }
+            return stat.isDirectory()
+                ? { path: absolute, status: "directory" }
+                : { status: "unsupported" };
+        }
+        catch {
+            return { path: absolute, status: "missing" };
+        }
+    }
+    catch {
+        return { status: "unsupported" };
+    }
+};
+/** Ordinary inline links in source order, skipping images and code spans. */
+const collect = (tokens, links) => {
+    for (const token of tokens) {
+        if (token.type === "link" && "href" in token) {
+            // SAFETY: Marked's Generic token prevents discriminator narrowing.
+            // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- checked Marked link discriminator
+            const { href, text } = token;
+            links.push({ href, text });
+        }
+        else if (["strong", "em", "del"].includes(token.type) && "tokens" in token && token.tokens) {
+            collect(token.tokens, links);
+        }
+    }
+};
+export const markdownLinks = function markdownLinks(line) {
+    const links = [];
+    collect(Lexer.lexInline(line), links);
+    return links;
+};
+//# sourceMappingURL=markdown-links.js.map

package/dist/markdown-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-links.js","sourceRoot":"","sources":["../src/markdown-links.ts"],"names":[],"mappings":"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"}

package/dist/standalone-router.d.ts

@@ -0,0 +1,11 @@
+import type { RouteDefinition, RouterInstance } from "@tooee/router";
+import type { ViewLaunchOptions } from "./launch.js";
+interface StandaloneRouter {
+    documentRoute: RouteDefinition<{
+        path?: string;
+    }>;
+    router: RouterInstance;
+}
+export declare const createStandaloneRouter: (options: ViewLaunchOptions) => StandaloneRouter;
+export {};
+//# sourceMappingURL=standalone-router.d.ts.map

package/dist/standalone-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone-router.d.ts","sourceRoot":"","sources":["../src/standalone-router.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAS,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAO5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBrD,UAAU,gBAAgB;IACxB,aAAa,EAAE,eAAe,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,eAAO,MAAM,sBAAsB,YACxB,iBAAiB,KACzB,gBAyEF,CAAC"}

package/dist/standalone-router.js

@@ -0,0 +1,85 @@
+import { jsx as _jsx } from "@opentui/react/jsx-runtime";
+/* oxlint-disable no-use-before-define -- the screen closes over the route initialized before router startup */
+import { useMemo } from "react";
+import { useChooseDialog } from "@tooee/choose";
+import { useCommand } from "@tooee/commands";
+import { createRoute, createRouter, useNavigate, useParams, useRouter, useRouterCommands, } from "@tooee/router";
+import path from "node:path";
+import { createFileProvider } from "./default-provider.js";
+import { runLinkHandlers } from "./link-handlers.js";
+import { markdownLinks } from "./markdown-links.js";
+import { getTextContent } from "./types.js";
+import { View } from "./view.js";
+const documentParams = {
+    parse: (value) => {
+        /* oxlint-disable anti-slop/no-runtime-typeof -- route params are decoded at this boundary */
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            throw new TypeError("Expected document params");
+        }
+        if (!("path" in value) || value.path === undefined) {
+            return {};
+        }
+        if (typeof value.path !== "string" || !path.isAbsolute(value.path)) {
+            throw new TypeError("Expected an absolute document path");
+        }
+        /* oxlint-enable anti-slop/no-runtime-typeof */
+        return { path: value.path };
+    },
+};
+export const createStandaloneRouter = function createStandaloneRouter(options) {
+    const DocumentScreen = function DocumentScreen() {
+        useRouterCommands();
+        const { path: documentPath } = useParams(documentRoute);
+        const navigate = useNavigate();
+        const { stack } = useRouter();
+        const chooseLink = useChooseDialog();
+        const provider = useMemo(() => documentPath === undefined ? options.contentProvider : createFileProvider(documentPath), [documentPath]);
+        const activate = (href, command) => {
+            if (options.filePath === undefined) {
+                command.toast?.toast({ level: "info", message: "Links need a source file" });
+                return true;
+            }
+            const currentPath = path.resolve(documentPath ?? options.filePath);
+            return runLinkHandlers(options.linkHandlers ?? [], { baseDir: path.dirname(currentPath), currentPath, href }, { command, documentRoute, navigate });
+        };
+        useCommand({
+            handler: async (context) => {
+                // Source positions are zero-based, unlike the displayed line numbers.
+                const line = context.document?.activeAnchor?.source?.primary?.start.line;
+                const content = context.view?.content;
+                if (line === undefined || content === undefined) {
+                    return;
+                }
+                const links = markdownLinks(getTextContent(content).split("\n")[line] ?? "");
+                // One link follows directly; several open a chooser so none is silently preferred.
+                const link = links.length > 1
+                    ? await chooseLink.open({
+                        items: links,
+                        prompt: "Follow link",
+                        toItem: (item) => ({ description: item.href, text: item.text }),
+                    })
+                    : (links[0] ?? null);
+                if (link !== null) {
+                    activate(link.href, context);
+                }
+            },
+            hotkey: "enter",
+            id: "view.follow-link",
+            modes: ["cursor"],
+            title: "Follow Markdown link",
+            when: (context) => context.view?.format === "markdown",
+        });
+        return (_jsx(View, { actions: options.actions, codeBlockRenderers: options.codeBlockRenderers, contentProvider: provider, onMarkdownLinkActivate: activate, renderers: options.renderers }, `${stack.length}:${documentPath ?? ""}`));
+    };
+    const documentRoute = createRoute({
+        component: DocumentScreen,
+        id: "view.document",
+        params: documentParams,
+    });
+    const router = createRouter({
+        initial: { routeId: documentRoute.id },
+        routes: [documentRoute],
+    });
+    return { documentRoute, router };
+};
+//# sourceMappingURL=standalone-router.js.map

package/dist/standalone-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone-router.js","sourceRoot":"","sources":["../src/standalone-router.tsx"],"names":[],"mappings":";AAAA,+GAA+G;AAC/G,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,SAAS,EACT,SAAS,EACT,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,cAAc,GAA6B;IAC/C,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;QACf,6FAA6F;QAC7F,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACnD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;QAC5D,CAAC;QACD,+CAA+C;QAC/C,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;CACF,CAAC;AAOF,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,sBAAsB,CACnE,OAA0B;IAE1B,MAAM,cAAc,GAAG,SAAS,cAAc;QAC5C,iBAAiB,EAAE,CAAC;QACpB,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,eAAe,EAAgB,CAAC;QACnD,MAAM,QAAQ,GAAG,OAAO,CACtB,GAAG,EAAE,CACH,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,kBAAkB,CAAC,YAAY,CAAC,EACzF,CAAC,YAAY,CAAC,CACf,CAAC;QACF,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,OAAuB,EAAW,EAAE;YAClE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACnC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAAC;gBAC7E,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnE,OAAO,eAAe,CACpB,OAAO,CAAC,YAAY,IAAI,EAAE,EAC1B,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,EACzD,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CACrC,CAAC;QACJ,CAAC,CAAC;QACF,UAAU,CAAC;YACT,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBACzB,sEAAsE;gBACtE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC;gBACzE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;gBACtC,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAChD,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,GAAG,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC7E,mFAAmF;gBACnF,MAAM,IAAI,GACR,KAAK,CAAC,MAAM,GAAG,CAAC;oBACd,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC;wBACpB,KAAK,EAAE,KAAK;wBACZ,MAAM,EAAE,aAAa;wBACrB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;qBAChE,CAAC;oBACJ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;gBACzB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,MAAM,EAAE,OAAO;YACf,EAAE,EAAE,kBAAkB;YACtB,KAAK,EAAE,CAAC,QAAQ,CAAC;YACjB,KAAK,EAAE,sBAAsB;YAC7B,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU;SACvD,CAAC,CAAC;QACH,OAAO,CACL,KAAC,IAAI,IAEH,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAC9C,eAAe,EAAE,QAAQ,EACzB,sBAAsB,EAAE,QAAQ,EAChC,SAAS,EAAE,OAAO,CAAC,SAAS,IALvB,GAAG,KAAK,CAAC,MAAM,IAAI,YAAY,IAAI,EAAE,EAAE,CAM5C,CACH,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,aAAa,GAAG,WAAW,CAAC;QAChC,SAAS,EAAE,cAAc;QACzB,EAAE,EAAE,eAAe;QACnB,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,OAAO,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,EAAE;QACtC,MAAM,EAAE,CAAC,aAAa,CAAC;KACxB,CAAC,CAAC;IACH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tooee/view",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Terminal content viewer for markdown, code, text, images, and tables",
   "keywords": [
     "cli",
@@ -40,16 +40,18 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@tooee/commands": "0.8.0",
-    "@tooee/config": "0.8.0",
-    "@tooee/diff": "0.8.0",
-    "@tooee/layout": "0.8.0",
-    "@tooee/marks": "0.8.0",
-    "@tooee/overlays": "0.8.0",
-    "@tooee/renderers": "0.8.0",
-    "@tooee/search": "0.8.0",
-    "@tooee/shell": "0.8.0",
-    "@tooee/themes": "0.8.0",
+    "@tooee/choose": "0.9.0",
+    "@tooee/commands": "0.9.0",
+    "@tooee/config": "0.9.0",
+    "@tooee/diff": "0.9.0",
+    "@tooee/layout": "0.9.0",
+    "@tooee/marks": "0.9.0",
+    "@tooee/overlays": "0.9.0",
+    "@tooee/renderers": "0.9.0",
+    "@tooee/router": "0.9.0",
+    "@tooee/search": "0.9.0",
+    "@tooee/shell": "0.9.0",
+    "@tooee/themes": "0.9.0",
     "@xstate/store": "^4",
     "@xstate/store-react": "^2",
     "marked": "^17.0.4"

package/src/index.ts

@@ -46,3 +46,5 @@ export type {
 export { getTextContent, isBuiltinContent, isCustomContent } from "./types.js";
 export { CodeBlockChrome } from "@tooee/renderers";
 export type { CodeBlockRenderer, CodeBlockRendererProps, CodeBlockHScroll } from "@tooee/renderers";
+export { localFileLinkHandler } from "./link-handlers.js";
+export type { LinkHandler, LinkHandlerContext, LinkTarget } from "./link-handlers.js";

package/src/launch.tsx

@@ -1,13 +1,19 @@
 import { launchCli, runCliSession } from "@tooee/shell";
 import type { ActionDefinition } from "@tooee/commands";
 import type { CodeBlockRenderer } from "@tooee/renderers";
-import { View } from "./view.js";
+import { Outlet, RouterProvider } from "@tooee/router";
+import { createStandaloneRouter } from "./standalone-router.js";
+import type { LinkHandler } from "./link-handlers.js";
 import { DirectoryView } from "./directory-view.js";
 import type { ContentProvider, ContentRenderer } from "./types.js";
 import type { ReactNode } from "react";
 
 export interface ViewLaunchOptions {
   contentProvider: ContentProvider;
+  /** Source file for standalone local Markdown navigation; omitted for stdin. */
+  filePath?: string;
+  /** Synchronous handlers tried before local file navigation. */
+  linkHandlers?: readonly LinkHandler[];
   actions?: ActionDefinition[];
   renderers?: Record<string, ContentRenderer>;
   /**
@@ -24,20 +30,28 @@ export interface DirectoryLaunchOptions {
 }
 
 export const launch = async function launch(options: ViewLaunchOptions): Promise<void> {
+  const { router } = createStandaloneRouter(options);
+  const startup = await router.start();
+  if (startup.status !== "committed") {
+    throw new Error(`View router startup ${startup.status}`);
+  }
   await runCliSession<undefined>(
     (): ReactNode => (
-      <View
-        contentProvider={options.contentProvider}
-        actions={options.actions}
-        renderers={options.renderers}
-        codeBlockRenderers={options.codeBlockRenderers}
-      />
+      <RouterProvider router={router}>
+        <Outlet />
+      </RouterProvider>
     ),
+    {
+      stdinPolicy: "tty-if-piped",
+      stdoutPolicy: "tty-if-redirected",
+    },
   );
 };
 
 export const launchDirectory = async function launchDirectory(
   options: DirectoryLaunchOptions,
 ): Promise<void> {
-  await launchCli(<DirectoryView dirPath={options.dirPath} actions={options.actions} />);
+  await launchCli(<DirectoryView dirPath={options.dirPath} actions={options.actions} />, {
+    stdoutPolicy: "tty-if-redirected",
+  });
 };

package/src/link-handlers.ts

@@ -0,0 +1,60 @@
+import path from "node:path";
+import type { CommandContext } from "@tooee/commands";
+import type { NavigateHandle, RouteDefinition } from "@tooee/router";
+import { resolveMarkdownLink } from "./markdown-links.js";
+
+export interface LinkTarget {
+  href: string;
+  /** Directory that relative targets resolve against. */
+  baseDir: string;
+  /** Source document for fragment-only links. */
+  currentPath?: string;
+}
+
+export interface LinkHandlerContext {
+  navigate: NavigateHandle;
+  documentRoute: RouteDefinition<{ path?: string }>;
+  command: CommandContext;
+}
+
+/** Decide synchronously: true consumes the link, false tries the next handler. */
+export type LinkHandler = (link: LinkTarget, context: LinkHandlerContext) => boolean;
+
+export const localFileLinkHandler: LinkHandler = function localFileLinkHandler(link, context) {
+  const result = resolveMarkdownLink(link.href, link.baseDir, link.currentPath);
+  if (result.status === "unsupported") {
+    return false;
+  }
+  if (result.status === "file") {
+    void context.navigate.push(context.documentRoute, { path: result.path });
+    return true;
+  }
+  const relative = path.relative(link.baseDir, result.path);
+  const target =
+    relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)
+      ? result.path
+      : relative || ".";
+  context.command.toast?.toast({
+    level: "warning",
+    message: `${result.status === "missing" ? "File not found" : "Not a file"}: ${target}`,
+  });
+  return true;
+};
+
+export const runLinkHandlers = function runLinkHandlers(
+  handlers: readonly LinkHandler[],
+  link: LinkTarget,
+  context: LinkHandlerContext,
+): boolean {
+  for (const handler of handlers) {
+    // oxlint-disable-next-line typescript/no-unnecessary-boolean-literal-compare -- preserve exact-true consumption for JavaScript callers too
+    if (handler(link, context) === true) {
+      return true;
+    }
+  }
+  if (localFileLinkHandler(link, context)) {
+    return true;
+  }
+  context.command.toast?.toast({ level: "warning", message: `Unsupported link: ${link.href}` });
+  return true;
+};

package/src/markdown-links.ts

@@ -0,0 +1,88 @@
+import { statSync } from "node:fs";
+import nodePath from "node:path";
+import { fileURLToPath } from "node:url";
+import { Lexer } from "marked";
+import type { Token, Tokens } from "marked";
+
+export type LinkResolution =
+  | { status: "file"; path: string }
+  | { status: "missing"; path: string }
+  | { status: "directory"; path: string }
+  | { status: "unsupported" };
+
+/** Existing local files only. Fragments are validated, then open at the file top. */
+export const resolveMarkdownLink = function resolveMarkdownLink(
+  href: string,
+  baseDir: string,
+  currentPath?: string,
+): LinkResolution {
+  try {
+    const decoded = decodeURIComponent(href);
+    if (/[\p{Cc}\\]/u.test(decoded)) {
+      return { status: "unsupported" };
+    }
+    const target = href.trim();
+    if (!target || target.startsWith("//")) {
+      return { status: "unsupported" };
+    }
+    const [rawPath] = target.split("#", 1);
+    if (rawPath.includes("?")) {
+      return { status: "unsupported" };
+    }
+    let path: string;
+    if (/^[a-zA-Z][a-zA-Z\d+.-]*:/u.test(rawPath)) {
+      // Check the authority before URL normalizes localhost into an empty host.
+      if (!/^file:\/\/\//iu.test(rawPath)) {
+        return { status: "unsupported" };
+      }
+      const url = new URL(rawPath);
+      if (url.hostname || url.search) {
+        return { status: "unsupported" };
+      }
+      path = fileURLToPath(url);
+    } else {
+      path = rawPath
+        ? nodePath.resolve(baseDir, decodeURIComponent(rawPath))
+        : (currentPath ?? baseDir);
+    }
+    const absolute = nodePath.resolve(path);
+    try {
+      const stat = statSync(absolute);
+      if (stat.isFile()) {
+        return { path: absolute, status: "file" };
+      }
+      return stat.isDirectory()
+        ? { path: absolute, status: "directory" }
+        : { status: "unsupported" };
+    } catch {
+      return { path: absolute, status: "missing" };
+    }
+  } catch {
+    return { status: "unsupported" };
+  }
+};
+
+export interface MarkdownLink {
+  /** Link text as written in the source. */
+  text: string;
+  href: string;
+}
+
+/** Ordinary inline links in source order, skipping images and code spans. */
+const collect = (tokens: Token[], links: MarkdownLink[]): void => {
+  for (const token of tokens) {
+    if (token.type === "link" && "href" in token) {
+      // SAFETY: Marked's Generic token prevents discriminator narrowing.
+      // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- checked Marked link discriminator
+      const { href, text } = token as Tokens.Link;
+      links.push({ href, text });
+    } else if (["strong", "em", "del"].includes(token.type) && "tokens" in token && token.tokens) {
+      collect(token.tokens, links);
+    }
+  }
+};
+export const markdownLinks = function markdownLinks(line: string): MarkdownLink[] {
+  const links: MarkdownLink[] = [];
+  collect(Lexer.lexInline(line), links);
+  return links;
+};

package/src/standalone-router.tsx

@@ -0,0 +1,122 @@
+/* oxlint-disable no-use-before-define -- the screen closes over the route initialized before router startup */
+import { useMemo } from "react";
+import type { ReactNode } from "react";
+import { useChooseDialog } from "@tooee/choose";
+import { useCommand } from "@tooee/commands";
+import type { CommandContext } from "@tooee/commands";
+import {
+  createRoute,
+  createRouter,
+  useNavigate,
+  useParams,
+  useRouter,
+  useRouterCommands,
+} from "@tooee/router";
+import type { Codec, RouteDefinition, RouterInstance } from "@tooee/router";
+import path from "node:path";
+import { createFileProvider } from "./default-provider.js";
+import { runLinkHandlers } from "./link-handlers.js";
+import { markdownLinks } from "./markdown-links.js";
+import type { MarkdownLink } from "./markdown-links.js";
+import { getTextContent } from "./types.js";
+import type { ViewLaunchOptions } from "./launch.js";
+import { View } from "./view.js";
+
+const documentParams: Codec<{ path?: string }> = {
+  parse: (value) => {
+    /* oxlint-disable anti-slop/no-runtime-typeof -- route params are decoded at this boundary */
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+      throw new TypeError("Expected document params");
+    }
+    if (!("path" in value) || value.path === undefined) {
+      return {};
+    }
+    if (typeof value.path !== "string" || !path.isAbsolute(value.path)) {
+      throw new TypeError("Expected an absolute document path");
+    }
+    /* oxlint-enable anti-slop/no-runtime-typeof */
+    return { path: value.path };
+  },
+};
+
+interface StandaloneRouter {
+  documentRoute: RouteDefinition<{ path?: string }>;
+  router: RouterInstance;
+}
+
+export const createStandaloneRouter = function createStandaloneRouter(
+  options: ViewLaunchOptions,
+): StandaloneRouter {
+  const DocumentScreen = function DocumentScreen(): ReactNode {
+    useRouterCommands();
+    const { path: documentPath } = useParams(documentRoute);
+    const navigate = useNavigate();
+    const { stack } = useRouter();
+    const chooseLink = useChooseDialog<MarkdownLink>();
+    const provider = useMemo(
+      () =>
+        documentPath === undefined ? options.contentProvider : createFileProvider(documentPath),
+      [documentPath],
+    );
+    const activate = (href: string, command: CommandContext): boolean => {
+      if (options.filePath === undefined) {
+        command.toast?.toast({ level: "info", message: "Links need a source file" });
+        return true;
+      }
+      const currentPath = path.resolve(documentPath ?? options.filePath);
+      return runLinkHandlers(
+        options.linkHandlers ?? [],
+        { baseDir: path.dirname(currentPath), currentPath, href },
+        { command, documentRoute, navigate },
+      );
+    };
+    useCommand({
+      handler: async (context) => {
+        // Source positions are zero-based, unlike the displayed line numbers.
+        const line = context.document?.activeAnchor?.source?.primary?.start.line;
+        const content = context.view?.content;
+        if (line === undefined || content === undefined) {
+          return;
+        }
+        const links = markdownLinks(getTextContent(content).split("\n")[line] ?? "");
+        // One link follows directly; several open a chooser so none is silently preferred.
+        const link =
+          links.length > 1
+            ? await chooseLink.open({
+                items: links,
+                prompt: "Follow link",
+                toItem: (item) => ({ description: item.href, text: item.text }),
+              })
+            : (links[0] ?? null);
+        if (link !== null) {
+          activate(link.href, context);
+        }
+      },
+      hotkey: "enter",
+      id: "view.follow-link",
+      modes: ["cursor"],
+      title: "Follow Markdown link",
+      when: (context) => context.view?.format === "markdown",
+    });
+    return (
+      <View
+        key={`${stack.length}:${documentPath ?? ""}`}
+        actions={options.actions}
+        codeBlockRenderers={options.codeBlockRenderers}
+        contentProvider={provider}
+        onMarkdownLinkActivate={activate}
+        renderers={options.renderers}
+      />
+    );
+  };
+  const documentRoute = createRoute({
+    component: DocumentScreen,
+    id: "view.document",
+    params: documentParams,
+  });
+  const router = createRouter({
+    initial: { routeId: documentRoute.id },
+    routes: [documentRoute],
+  });
+  return { documentRoute, router };
+};