@tooee/view 0.11.0 → 0.12.0

package/dist/outline/outline-panel.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import type { FoldActions } from "../folds/use-folds.js";
+import type { OutlineEntry } from "./markdown-outline.js";
+import type { OutlineState } from "./use-outline.js";
+/** One outline line: indent, current-heading marker and text, cut to `width` columns. */
+export declare const outlineLabel: (entry: OutlineEntry, current: boolean, closed: boolean, width: number) => string;
+/**
+ * The outline as a side panel. A controlled group with one panel: the panel
+ * is active only while the outline has focus, so the document keeps the root
+ * surface the rest of the time. Built-in Tab switching is off, so Tab keeps
+ * its multi-select meaning in the document.
+ */
+export declare const OutlinePanel: ({ outline, foldActions, }: {
+    outline: OutlineState;
+    foldActions: FoldActions;
+}) => ReactNode;
+//# sourceMappingURL=outline-panel.d.ts.map

package/dist/outline/outline-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline-panel.d.ts","sourceRoot":"","sources":["../../src/outline/outline-panel.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AASrD,yFAAyF;AACzF,eAAO,MAAM,YAAY,UAChB,YAAY,WACV,OAAO,UACR,OAAO,SACR,MAAM,KACZ,MAMF,CAAC;AA0GF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,8BAGtB;IACD,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;CAC1B,KAAG,SAoBH,CAAC"}

package/dist/outline/outline-panel.js

@@ -0,0 +1,106 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@opentui/react/jsx-runtime";
+import { useActions } from "@tooee/commands";
+import { Panel, PanelGroup } from "@tooee/panels";
+import { useTheme } from "@tooee/themes";
+import { useEffect, useRef } from "react";
+import { foldActionDefinitions } from "../folds/use-folds.js";
+const OUTLINE_PANEL_ID = "outline";
+const INDENT = "  ";
+/** Columns the panel border and the list padding take from the panel width. */
+const OUTLINE_CHROME_WIDTH = 4;
+const entryId = (entry) => `outline-entry-${entry.row}`;
+/** One outline line: indent, current-heading marker and text, cut to `width` columns. */
+export const outlineLabel = function outlineLabel(entry, current, closed, width) {
+    const suffix = closed ? " ⋯" : "";
+    const label = `${INDENT.repeat(entry.level)}${current ? "▸ " : "  "}${entry.text}`;
+    const room = Math.max(1, width - suffix.length);
+    const cut = label.length > room ? `${label.slice(0, Math.max(0, room - 1))}…` : label;
+    return `${cut}${suffix}`;
+};
+/**
+ * The panel-owned outline commands. They register on the outline panel's
+ * surface, so they only dispatch while the outline has focus, and they shadow
+ * the root commands on the same keys. `g o` closes the outline here, because
+ * the panel's `g g` holds the `g` chord. The fold keys act on the selected
+ * heading's section, so the panel registers the whole `z` set.
+ */
+const OutlineCommands = function OutlineCommands({ outline, foldActions, }) {
+    const next = () => {
+        outline.move(1);
+    };
+    const previous = () => {
+        outline.move(-1);
+    };
+    const first = () => {
+        outline.select(0);
+    };
+    const last = () => {
+        outline.select(outline.entries.length - 1);
+    };
+    const jump = () => {
+        outline.jump(outline.selectedIndex);
+    };
+    const commands = [
+        ["j", "outline.down", "Next heading", next],
+        ["down", "outline.down-arrow", "Next heading", next],
+        ["k", "outline.up", "Previous heading", previous],
+        ["up", "outline.up-arrow", "Previous heading", previous],
+        ["g g", "outline.first", "First heading", first],
+        ["shift+g", "outline.last", "Last heading", last],
+        ["enter", "outline.jump", "Jump to heading", jump],
+        ["escape", "outline.focus-content", "Return to document", outline.focusContent],
+        ["g o", "outline.close", "Close outline", outline.close],
+    ];
+    const selectedRow = () => outline.entries[outline.selectedIndex]?.row;
+    useActions([
+        ...commands.map(([hotkey, id, title, run]) => ({
+            category: "Outline",
+            handler: run,
+            hotkey,
+            id,
+            modes: ["cursor"],
+            title,
+        })),
+        ...foldActionDefinitions(foldActions, selectedRow, "outline.fold", "No fold at heading"),
+    ]);
+    return null;
+};
+const OutlineList = function OutlineList({ outline }) {
+    const { theme } = useTheme();
+    const scrollRef = useRef(null);
+    const textWidth = Math.max(1, outline.width - OUTLINE_CHROME_WIDTH);
+    const selected = outline.entries[outline.selectedIndex];
+    useEffect(() => {
+        if (selected !== undefined) {
+            scrollRef.current?.scrollChildIntoView(entryId(selected));
+        }
+    }, [selected]);
+    if (outline.entries.length === 0) {
+        return _jsx("text", { content: "No headings", fg: theme.textMuted, paddingLeft: 1 });
+    }
+    return (_jsx("scrollbox", { ref: scrollRef, style: { flexGrow: 1 }, focused: false, verticalScrollbarOptions: { visible: false }, children: outline.entries.map((entry, index) => {
+            const current = index === outline.currentIndex;
+            const highlighted = outline.focused && index === outline.selectedIndex;
+            return (_jsx("box", { id: entryId(entry), paddingLeft: 1, paddingRight: 1, backgroundColor: highlighted ? theme.cursorLine : undefined, onMouseDown: (event) => {
+                    event.stopPropagation();
+                    outline.jump(index);
+                }, children: _jsx("text", { content: outlineLabel(entry, current, outline.closedRows.has(entry.row), textWidth), fg: current ? theme.accent : theme.text }) }, entry.row));
+        }) }));
+};
+/**
+ * The outline as a side panel. A controlled group with one panel: the panel
+ * is active only while the outline has focus, so the document keeps the root
+ * surface the rest of the time. Built-in Tab switching is off, so Tab keeps
+ * its multi-select meaning in the document.
+ */
+export const OutlinePanel = function OutlinePanel({ outline, foldActions, }) {
+    if (!outline.visible) {
+        return null;
+    }
+    // The only panel asks for activation on a mouse-down inside it.
+    const handleActivePanelChange = () => {
+        outline.focus();
+    };
+    return (_jsx(PanelGroup, { activePanelId: outline.focused ? OUTLINE_PANEL_ID : null, onActivePanelChange: handleActivePanelChange, switchKeys: null, children: _jsxs(Panel, { id: OUTLINE_PANEL_ID, title: "Outline", style: { flexShrink: 0, width: outline.width }, children: [_jsx(OutlineCommands, { outline: outline, foldActions: foldActions }), _jsx(OutlineList, { outline: outline })] }) }));
+};
+//# sourceMappingURL=outline-panel.js.map

package/dist/outline/outline-panel.js.map

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

package/dist/outline/use-outline.d.ts

@@ -0,0 +1,53 @@
+import type { FlatBlock } from "@tooee/renderers";
+import type { DocumentController, NavigationState } from "@tooee/shell";
+import type { FoldState } from "../folds/use-folds.js";
+import type { OutlineEntry } from "./markdown-outline.js";
+/** Below this terminal width the outline is not shown. */
+export declare const OUTLINE_MIN_TERMINAL_WIDTH = 60;
+/**
+ * Lines of the document kept above a heading after a jump. The heading lands
+ * near the top of the view, with a little of the text before it for context.
+ */
+export declare const OUTLINE_JUMP_MARGIN = 3;
+/** Columns for the outline at a terminal width, or 0 when the terminal is too narrow. */
+export declare const outlineWidth: (terminalWidth: number) => number;
+/** State and actions of a document outline. */
+export interface OutlineState {
+    entries: readonly OutlineEntry[];
+    /** Entry of the heading that contains the document cursor, or -1. */
+    currentIndex: number;
+    /** Entry the outline highlights as selected: the current heading unless the outline has focus. */
+    selectedIndex: number;
+    /** Full-array rows whose own heading fold is closed. */
+    closedRows: ReadonlySet<number>;
+    /** True when the outline is open and the terminal is wide enough to show it. */
+    visible: boolean;
+    /** True when the visible outline owns keyboard input. */
+    focused: boolean;
+    /** Outline width in columns, or 0 when the terminal is too narrow. */
+    width: number;
+    focus: () => void;
+    focusContent: () => void;
+    close: () => void;
+    move: (delta: number) => void;
+    select: (index: number) => void;
+    /** Move the document cursor to an entry's heading and give focus back to the content. */
+    jump: (index: number) => void;
+}
+interface UseOutlineOptions {
+    blocks: readonly FlatBlock[];
+    folds: FoldState<FlatBlock>;
+    navigation: Pick<NavigationState, "cursor" | "setCursor">;
+    /** Scrolls a jumped-to heading near the top of the document view. */
+    revealRow: DocumentController<FlatBlock>["revealRow"];
+    initialOpen?: boolean;
+}
+/**
+ * Outline state for a Markdown document, and the root `g o` command that
+ * opens, focuses and closes it. A jump to a heading inside closed folds opens
+ * those folds, then moves the cursor once the new rows are in place. Every
+ * jump scrolls the heading to near the top of the view.
+ */
+export declare const useMarkdownOutline: ({ blocks, folds, navigation, revealRow, initialOpen, }: UseOutlineOptions) => OutlineState;
+export {};
+//# sourceMappingURL=use-outline.d.ts.map

package/dist/outline/use-outline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-outline.d.ts","sourceRoot":"","sources":["../../src/outline/use-outline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAIxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAM1D,0DAA0D;AAC1D,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,yFAAyF;AACzF,eAAO,MAAM,YAAY,kBAAwC,MAAM,KAAG,MAKzE,CAAC;AAEF,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,aAAa,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,yFAAyF;IACzF,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,UAAU,iBAAiB;IACzB,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5B,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;IAC1D,qEAAqE;IACrE,SAAS,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,2DAM5B,iBAAiB,KAAG,YA+GtB,CAAC"}

package/dist/outline/use-outline.js

@@ -0,0 +1,131 @@
+import { useTerminalDimensions } from "@opentui/react";
+import { useCommand } from "@tooee/commands";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { closedFoldsHiding } from "../folds/fold-model.js";
+import { markdownOutline, outlineIndexAt } from "./markdown-outline.js";
+/** Outline width in columns, border included. */
+const OUTLINE_WIDTH = 32;
+/** The outline never takes more than this share of the terminal width. */
+const OUTLINE_MAX_SHARE = 0.4;
+/** Below this terminal width the outline is not shown. */
+export const OUTLINE_MIN_TERMINAL_WIDTH = 60;
+/**
+ * Lines of the document kept above a heading after a jump. The heading lands
+ * near the top of the view, with a little of the text before it for context.
+ */
+export const OUTLINE_JUMP_MARGIN = 3;
+/** Columns for the outline at a terminal width, or 0 when the terminal is too narrow. */
+export const outlineWidth = function outlineWidth(terminalWidth) {
+    if (terminalWidth < OUTLINE_MIN_TERMINAL_WIDTH) {
+        return 0;
+    }
+    return Math.min(OUTLINE_WIDTH, Math.floor(terminalWidth * OUTLINE_MAX_SHARE));
+};
+/**
+ * Outline state for a Markdown document, and the root `g o` command that
+ * opens, focuses and closes it. A jump to a heading inside closed folds opens
+ * those folds, then moves the cursor once the new rows are in place. Every
+ * jump scrolls the heading to near the top of the view.
+ */
+export const useMarkdownOutline = function useMarkdownOutline({ blocks, folds, navigation, revealRow, initialOpen = false, }) {
+    const entries = useMemo(() => markdownOutline(blocks), [blocks]);
+    const { width: terminalWidth } = useTerminalDimensions();
+    const width = outlineWidth(terminalWidth);
+    const [open, setOpen] = useState(initialOpen);
+    const [focusRequested, setFocusRequested] = useState(false);
+    const [selected, setSelected] = useState(0);
+    const { closedKeys, ranges, setClosedKeys, view } = folds;
+    const { cursor, setCursor } = navigation;
+    const visible = open && width > 0;
+    const moveTo = useCallback((index) => {
+        setCursor(index);
+        revealRow(index, { align: "start", margin: OUTLINE_JUMP_MARGIN });
+    }, [setCursor, revealRow]);
+    const focused = visible && focusRequested;
+    const sourceRow = cursor === null ? undefined : view.visibleToSource[cursor];
+    const currentIndex = sourceRow === undefined ? -1 : outlineIndexAt(entries, sourceRow);
+    const selectedIndex = focused ? Math.min(selected, entries.length - 1) : currentIndex;
+    const closedRows = useMemo(() => new Set(ranges.filter((range) => closedKeys.has(range.key)).map((range) => range.start)), [ranges, closedKeys]);
+    // A jump that opens folds waits for the new fold view, then moves the
+    // cursor. This effect runs after the controller's own rows effect, so the
+    // store already holds the new rows.
+    const pendingRowRef = useRef(null);
+    useEffect(() => {
+        const row = pendingRowRef.current;
+        const index = row === null ? -1 : (view.sourceToVisible[row] ?? -1);
+        if (index !== -1) {
+            pendingRowRef.current = null;
+            moveTo(index);
+        }
+    }, [view, moveTo]);
+    const focus = () => {
+        setSelected(Math.max(currentIndex, 0));
+        setFocusRequested(true);
+    };
+    const focusContent = () => {
+        setFocusRequested(false);
+    };
+    const close = () => {
+        setOpen(false);
+        setFocusRequested(false);
+    };
+    const select = (index) => {
+        setSelected(Math.max(0, Math.min(index, entries.length - 1)));
+    };
+    const move = (delta) => {
+        select(selectedIndex + delta);
+    };
+    const jump = (index) => {
+        const entry = entries[index];
+        setFocusRequested(false);
+        if (entry === undefined) {
+            return;
+        }
+        const hiding = closedFoldsHiding(ranges, closedKeys, entry.row);
+        if (hiding.length === 0) {
+            moveTo(view.sourceToVisible[entry.row] ?? 0);
+            return;
+        }
+        const next = new Set(closedKeys);
+        for (const key of hiding) {
+            next.delete(key);
+        }
+        pendingRowRef.current = entry.row;
+        setClosedKeys(next);
+    };
+    useCommand({
+        category: "Outline",
+        handler: (ctx) => {
+            if (width === 0) {
+                ctx.toast?.toast({ level: "info", message: "The outline needs a wider terminal" });
+                return;
+            }
+            if (open && focused) {
+                close();
+                return;
+            }
+            setOpen(true);
+            focus();
+        },
+        hotkey: "g o",
+        id: "outline.toggle",
+        modes: ["cursor"],
+        title: "Toggle outline",
+    });
+    return {
+        close,
+        closedRows,
+        currentIndex,
+        entries,
+        focus,
+        focusContent,
+        focused,
+        jump,
+        move,
+        select,
+        selectedIndex,
+        visible,
+        width,
+    };
+};
+//# sourceMappingURL=use-outline.js.map

package/dist/outline/use-outline.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"standalone-router.d.ts","sourceRoot":"","sources":["../src/standalone-router.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAS,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAM5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAwBrD,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"}
+{"version":3,"file":"standalone-router.d.ts","sourceRoot":"","sources":["../src/standalone-router.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAS,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAM5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAwBrD,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,gBA0EF,CAAC"}

package/dist/standalone-router.js

@@ -69,7 +69,7 @@ export const createStandaloneRouter = function createStandaloneRouter(options) {
             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 ?? ""}`));
+        return (_jsx(View, { actions: options.actions, codeBlockRenderers: options.codeBlockRenderers, contentProvider: provider, onMarkdownLinkActivate: activate, outline: options.outline, renderers: options.renderers }, `${stack.length}:${documentPath ?? ""}`));
     };
     const documentRoute = createRoute({
         component: DocumentScreen,

package/dist/standalone-router.js.map

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

package/dist/view.d.ts

@@ -13,7 +13,9 @@ interface ViewProps {
     codeBlockRenderers?: Record<string, CodeBlockRenderer>;
     /** Handles primary-button activation of inline Markdown links. */
     onMarkdownLinkActivate?: MarkdownLinkActivateHandler;
+    /** Open the heading outline beside Markdown content at start. Other formats ignore it. */
+    outline?: boolean;
 }
-export declare const View: ({ contentProvider, actions, renderers, codeBlockRenderers, onMarkdownLinkActivate, }: ViewProps) => ReactNode;
+export declare const View: ({ contentProvider, actions, renderers, codeBlockRenderers, onMarkdownLinkActivate, outline, }: ViewProps) => ReactNode;
 export {};
 //# sourceMappingURL=view.d.ts.map

package/dist/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAavC,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEhG,UAAU,SAAS;IACjB,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACvD,kEAAkE;IAClE,sBAAsB,CAAC,EAAE,2BAA2B,CAAC;CACtD;AAED,eAAO,MAAM,IAAI,yFAMd,SAAS,KAAG,SAoFd,CAAC"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAavC,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEhG,UAAU,SAAS;IACjB,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACvD,kEAAkE;IAClE,sBAAsB,CAAC,EAAE,2BAA2B,CAAC;IACrD,0FAA0F;IAC1F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,IAAI,kGAOd,SAAS,KAAG,SAqFd,CAAC"}

package/dist/view.js

@@ -6,7 +6,7 @@ import { MarkdownSubview, CodeSubview, TableSubview, ImageSubview, DiffSubview,
 import { ViewState } from "./components/view-state.js";
 import { useContentLoader } from "./hooks/use-content-loader.js";
 import { isCustomContent } from "./types.js";
-export const View = function View({ contentProvider, actions, renderers, codeBlockRenderers, onMarkdownLinkActivate, }) {
+export const View = function View({ contentProvider, actions, renderers, codeBlockRenderers, onMarkdownLinkActivate, outline, }) {
     const { theme } = useTheme();
     const { content, streaming, error, providerMarks, reload } = useContentLoader(contentProvider);
     const [userMarks, setUserMarks] = useState([]);
@@ -50,7 +50,7 @@ export const View = function View({ contentProvider, actions, renderers, codeBlo
     }
     switch (content.format) {
         case "markdown": {
-            return (_jsx(MarkdownSubview, { content: content, codeBlockRenderers: mergedCodeBlockRenderers, onLinkActivate: onMarkdownLinkActivate, ...shared }));
+            return (_jsx(MarkdownSubview, { content: content, codeBlockRenderers: mergedCodeBlockRenderers, onLinkActivate: onMarkdownLinkActivate, outline: outline, ...shared }));
         }
         case "code":
         case "text": {

package/dist/view.js.map

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

package/package.json

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

package/src/components/subviews/markdown-subview.tsx

@@ -1,4 +1,5 @@
 import type { TextBufferRenderable } from "@opentui/core";
+import { useTerminalDimensions } from "@opentui/react";
 import { useBuildCommandContext, useCommand } from "@tooee/commands";
 import { MarkdownView, flattenMarkdown, getFlatBlockText } from "@tooee/renderers";
 import type { CodeBlockRenderer, FlatBlock } from "@tooee/renderers";
@@ -7,8 +8,10 @@ import { useMemo, useRef } from "react";
 import type { ReactNode } from "react";
 
 import { markdownHeadingFoldRanges } from "../../folds/markdown-heading-folds.js";
-import { useFoldCommands, useFoldState } from "../../folds/use-folds.js";
+import { useFoldActions, useFoldCommands, useFoldState } from "../../folds/use-folds.js";
 import { useContentDocument } from "../../hooks/use-content-document.js";
+import { OutlinePanel } from "../../outline/outline-panel.js";
+import { useMarkdownOutline } from "../../outline/use-outline.js";
 import type { MarkdownContent, MarkdownLinkActivateHandler } from "../../types.js";
 import { ViewScreen } from "../view-screen.js";
 import type { SubviewProps } from "./types.js";
@@ -17,6 +20,8 @@ interface MarkdownSubviewProps extends SubviewProps {
   content: MarkdownContent;
   codeBlockRenderers?: Record<string, CodeBlockRenderer>;
   onLinkActivate?: MarkdownLinkActivateHandler;
+  /** Open the heading outline beside the document at start. */
+  outline?: boolean;
 }
 
 /** Columns moved per h/l press when scrolling a wide block horizontally. */
@@ -44,6 +49,7 @@ export const MarkdownSubview = function MarkdownSubview({
   content,
   codeBlockRenderers,
   onLinkActivate,
+  outline: initialOutline = false,
   decorations,
   actions,
   ...screen
@@ -70,7 +76,18 @@ export const MarkdownSubview = function MarkdownSubview({
       ],
     }
   );
-  useFoldCommands(folds, document.navigation);
+  const foldActions = useFoldActions(folds, document.navigation);
+  useFoldCommands(folds, foldActions, document.navigation);
+  // Declared after the controller, so its jump effect runs after the
+  // controller has taken the new rows.
+  const outline = useMarkdownOutline({
+    blocks,
+    folds,
+    initialOpen: initialOutline,
+    navigation: document.navigation,
+    revealRow: document.revealRow,
+  });
+  const { width: terminalWidth } = useTerminalDimensions();
   const buildCommandContext = useBuildCommandContext();
   const handleLinkActivate = onLinkActivate
     ? (href: string) => onLinkActivate(href, buildCommandContext())
@@ -114,6 +131,7 @@ export const MarkdownSubview = function MarkdownSubview({
       controller={document}
       actions={actions}
       statusItems={statusItems}
+      aside={<OutlinePanel outline={outline} foldActions={foldActions} />}
       {...screen}
     >
       <MarkdownView
@@ -127,6 +145,7 @@ export const MarkdownSubview = function MarkdownSubview({
         codeBlockRenderers={codeBlockRenderers}
         onLinkActivate={handleLinkActivate}
         imageBasePath={content.imageBasePath}
+        width={outline.visible ? terminalWidth - outline.width : undefined}
       />
     </ViewScreen>
   );

package/src/components/view-screen.tsx

@@ -21,6 +21,8 @@ export interface ViewScreenProps<T> {
   setMarkSet: (set: MarkSet) => void;
   clearMarkNamespace: (namespace: string) => void;
   clearAllUserMarks: () => void;
+  /** Optional side region beside the content, such as the Markdown outline. */
+  aside?: ReactNode;
   children: ReactNode;
 }
 
@@ -41,6 +43,7 @@ export const ViewScreen = function ViewScreen<T>({
   setMarkSet,
   clearMarkNamespace,
   clearAllUserMarks,
+  aside,
   children,
 }: ViewScreenProps<T>): ReactNode {
   useProvideViewCommandContext({
@@ -71,6 +74,7 @@ export const ViewScreen = function ViewScreen<T>({
       statusItems={items}
       actions={actions}
       context={{ kind: content.format, reload, title: content.title }}
+      aside={aside}
     >
       {children}
     </DocumentScreen>

package/src/folds/fold-model.ts

@@ -70,6 +70,20 @@ export const foldsAt = function foldsAt(
     .toSorted((left, right) => right.start - left.start || left.end - right.end);
 };
 
+/**
+ * Keys of the closed ranges that hide `row`: closed ranges whose body
+ * (`start + 1 ..= end`) contains it. Opening them all makes `row` visible.
+ */
+export const closedFoldsHiding = function closedFoldsHiding(
+  ranges: readonly FoldRange[],
+  closedKeys: ReadonlySet<Key>,
+  row: number
+): Key[] {
+  return ranges
+    .filter((range) => closedKeys.has(range.key) && range.start < row && row <= range.end)
+    .map((range) => range.key);
+};
+
 /**
  * The full-array row the cursor should rest on once `view` applies: `row`
  * itself when it stays visible, otherwise the nearest visible row before it,

package/src/folds/markdown-heading-folds.ts

@@ -3,13 +3,18 @@ import type { Tokens } from "marked";
 
 import type { FoldRange } from "./fold-model.js";
 
-const headingDepth = function headingDepth(block: FlatBlock): number | null {
+/** The Marked heading token of a flattened block, or `null` when the block is not a heading. */
+export const headingToken = function headingToken(block: FlatBlock): Tokens.Heading | null {
   if (block.token.type !== "heading") {
     return null;
   }
   // SAFETY: Marked creates a Heading token for the checked "heading" discriminator.
   // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- Marked's Generic fallback prevents discriminator narrowing
-  return (block.token as Tokens.Heading).depth;
+  return block.token as Tokens.Heading;
+};
+
+const headingDepth = function headingDepth(block: FlatBlock): number | null {
+  return headingToken(block)?.depth ?? null;
 };
 
 /**