@tooee/view 0.10.2 → 0.11.0

package/dist/components/subviews/markdown-subview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-subview.d.ts","sourceRoot":"","sources":["../../../src/components/subviews/markdown-subview.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAa,MAAM,kBAAkB,CAAC;AAGrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAEnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,UAAU,oBAAqB,SAAQ,YAAY;IACjD,OAAO,EAAE,eAAe,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACvD,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC9C;AAeD,eAAO,MAAM,eAAe,qFAOzB,oBAAoB,KAAG,SA0EzB,CAAC"}
+{"version":3,"file":"markdown-subview.d.ts","sourceRoot":"","sources":["../../../src/components/subviews/markdown-subview.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAa,MAAM,kBAAkB,CAAC;AAGrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAEnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,UAAU,oBAAqB,SAAQ,YAAY;IACjD,OAAO,EAAE,eAAe,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACvD,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC9C;AAuBD,eAAO,MAAM,eAAe,qFAOzB,oBAAoB,KAAG,SAmFzB,CAAC"}

package/dist/components/subviews/markdown-subview.js

@@ -2,6 +2,8 @@ import { jsx as _jsx } from "@opentui/react/jsx-runtime";
 import { useBuildCommandContext, useCommand } from "@tooee/commands";
 import { MarkdownView, flattenMarkdown, getFlatBlockText } from "@tooee/renderers";
 import { useMemo, useRef } from "react";
+import { markdownHeadingFoldRanges } from "../../folds/markdown-heading-folds.js";
+import { useFoldCommands, useFoldState } from "../../folds/use-folds.js";
 import { useContentDocument } from "../../hooks/use-content-document.js";
 import { ViewScreen } from "../view-screen.js";
 /** Columns moved per h/l press when scrolling a wide block horizontally. */
@@ -9,23 +11,36 @@ const BLOCK_HSCROLL_STEP = 4;
 /**
  * Blocks are the row unit. `getFlatBlockText` keeps search/copy in step with the
  * source mapping (notably for synthetic bullet rows), and `getSource` projects
- * each block's Markdown provenance onto the controller's anchors.
+ * each block's Markdown provenance onto the controller's anchors. The key is
+ * the block's index in the full flattened document, so it stays the same when
+ * folds hide the blocks around it.
  */
-const MARKDOWN_BLOCK_ADAPTER = {
-    getSource: (block) => block.source,
-    getText: (block) => getFlatBlockText(block),
+const markdownBlockAdapter = function markdownBlockAdapter(blocks) {
+    const indices = new Map(blocks.map((block, index) => [block, index]));
+    return {
+        getKey: (block, index) => indices.get(block) ?? index,
+        getSource: (block) => block.source,
+        getText: (block) => getFlatBlockText(block),
+    };
 };
 export const MarkdownSubview = function MarkdownSubview({ content, codeBlockRenderers, onLinkActivate, decorations, actions, ...screen }) {
     const textContent = content.markdown;
     const lineCount = useMemo(() => textContent.split("\n").length, [textContent]);
     const blocks = useMemo(() => flattenMarkdown(content.markdown), [content.markdown]);
-    const { document, showLineNumbers, statusItems } = useContentDocument(blocks, MARKDOWN_BLOCK_ADAPTER, { actions, content, decorations, textContent }, {
+    const adapter = useMemo(() => markdownBlockAdapter(blocks), [blocks]);
+    const foldRanges = useMemo(() => markdownHeadingFoldRanges(blocks), [blocks]);
+    // Closed heading folds filter `blocks`; `folds.rows` is the one array both
+    // the controller and the renderer see.
+    const folds = useFoldState(blocks, foldRanges, decorations);
+    const { document, showLineNumbers, statusItems } = useContentDocument(folds.rows, adapter, { actions, content, decorations: folds.decorations, textContent }, {
         multiSelect: true,
+        preserveCursorByKey: true,
         statusItems: [
             { label: "Format:", value: content.format },
             { label: "Lines:", value: String(lineCount) },
         ],
     });
+    useFoldCommands(folds, document.navigation);
     const buildCommandContext = useBuildCommandContext();
     const handleLinkActivate = onLinkActivate
         ? (href) => onLinkActivate(href, buildCommandContext())
@@ -60,6 +75,6 @@ export const MarkdownSubview = function MarkdownSubview({ content, codeBlockRend
         title: "Scroll block right",
         when: () => cursorScrollable() !== undefined,
     });
-    return (_jsx(ViewScreen, { content: content, controller: document, actions: actions, statusItems: statusItems, ...screen, children: _jsx(MarkdownView, { content: content.markdown, blocks: blocks, showLineNumbers: showLineNumbers, document: document, hScrollableBlocksRef: hScrollableBlocksRef, codeBlockRenderers: codeBlockRenderers, onLinkActivate: handleLinkActivate, imageBasePath: content.imageBasePath }) }));
+    return (_jsx(ViewScreen, { content: content, controller: document, actions: actions, statusItems: statusItems, ...screen, children: _jsx(MarkdownView, { content: content.markdown, blocks: folds.rows, rowNumbers: folds.rowNumbers, foldedBlocks: folds.view.hiddenCounts, showLineNumbers: showLineNumbers, document: document, hScrollableBlocksRef: hScrollableBlocksRef, codeBlockRenderers: codeBlockRenderers, onLinkActivate: handleLinkActivate, imageBasePath: content.imageBasePath }) }));
 };
 //# sourceMappingURL=markdown-subview.js.map

package/dist/components/subviews/markdown-subview.js.map

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

package/dist/folds/fold-decorations.d.ts

@@ -0,0 +1,8 @@
+import type { DecorationLayer } from "@tooee/renderers";
+import type { FoldView } from "./fold-model.js";
+/**
+ * Map decoration layers written against full-array rows onto the visible rows
+ * of `view`. Decorations on rows that a closed fold hides are dropped.
+ */
+export declare const projectDecorationLayers: (layers: readonly DecorationLayer[], view: FoldView) => DecorationLayer[];
+//# sourceMappingURL=fold-decorations.d.ts.map

package/dist/folds/fold-decorations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-decorations.d.ts","sourceRoot":"","sources":["../../src/folds/fold-decorations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,kBAAkB,CAAC;AAEvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,WAC1B,SAAS,eAAe,EAAE,QAC5B,QAAQ,KACb,eAAe,EAkBjB,CAAC"}

package/dist/folds/fold-decorations.js

@@ -0,0 +1,24 @@
+/**
+ * Map decoration layers written against full-array rows onto the visible rows
+ * of `view`. Decorations on rows that a closed fold hides are dropped.
+ */
+export const projectDecorationLayers = function projectDecorationLayers(layers, view) {
+    const { visibleToSource, sourceToVisible } = view;
+    return layers.map((layer) => ({
+        *forVisibleRows(from, to) {
+            const sourceFrom = visibleToSource[from];
+            const sourceTo = visibleToSource[Math.min(to, visibleToSource.length - 1)];
+            if (sourceFrom === undefined || sourceTo === undefined) {
+                return;
+            }
+            for (const decoration of layer.forVisibleRows(sourceFrom, sourceTo)) {
+                const row = sourceToVisible[decoration.row] ?? -1;
+                if (row !== -1) {
+                    yield { ...decoration, row };
+                }
+            }
+        },
+        priority: layer.priority,
+    }));
+};
+//# sourceMappingURL=fold-decorations.js.map

package/dist/folds/fold-decorations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-decorations.js","sourceRoot":"","sources":["../../src/folds/fold-decorations.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,uBAAuB,CACrE,MAAkC,EAClC,IAAc;IAEd,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAClD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,CAAC;QAC7C,CAAC,cAAc,CAAC,IAAY,EAAE,EAAU;YACtC,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;YAC3E,IAAI,UAAU,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACvD,OAAO;YACT,CAAC;YACD,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACpE,MAAM,GAAG,GAAG,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;gBAClD,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;oBACf,MAAM,EAAE,GAAG,UAAU,EAAE,GAAG,EAAE,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC,CAAC;AACN,CAAC,CAAC"}

package/dist/folds/fold-model.d.ts

@@ -0,0 +1,36 @@
+import type { Key } from "react";
+/**
+ * A foldable range of rows. `start` is the header row that stays visible;
+ * `start + 1 ..= end` are the rows a closed fold hides. Indices point into the
+ * full row array, and `key` is the header row's key, so closed state survives
+ * row changes that keep keys stable.
+ */
+export interface FoldRange {
+    key: Key;
+    start: number;
+    end: number;
+}
+/** The visible projection of a full row array under a set of closed folds. */
+export interface FoldView {
+    /** Full-array index of each visible row, in order. */
+    visibleToSource: readonly number[];
+    /** Visible index of each full-array row, or `-1` when a closed fold hides it. */
+    sourceToVisible: readonly number[];
+    /** Hidden row count for each closed header, keyed by the header's visible index. */
+    hiddenCounts: ReadonlyMap<number, number>;
+}
+/**
+ * Project `rowCount` rows through the closed folds. A closed range hides its
+ * body even when it sits inside another closed range; the outermost header
+ * shown carries the count of every row hidden below it.
+ */
+export declare const computeFoldView: (rowCount: number, ranges: readonly FoldRange[], closedKeys: ReadonlySet<Key>) => FoldView;
+/** Ranges that contain `row` (header included), innermost first. */
+export declare const foldsAt: (ranges: readonly FoldRange[], row: number) => readonly FoldRange[];
+/**
+ * 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,
+ * which is the header of the outermost closed fold that hides it.
+ */
+export declare const visibleAnchorRow: (view: FoldView, row: number) => number;
+//# sourceMappingURL=fold-model.d.ts.map

package/dist/folds/fold-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-model.d.ts","sourceRoot":"","sources":["../../src/folds/fold-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,GAAG,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,sDAAsD;IACtD,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iFAAiF;IACjF,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,oFAAoF;IACpF,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,aAChB,MAAM,UACR,SAAS,SAAS,EAAE,cAChB,WAAW,CAAC,GAAG,CAAC,KAC3B,QA2BF,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,OAAO,WACV,SAAS,SAAS,EAAE,OACvB,MAAM,KACV,SAAS,SAAS,EAIpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,SAAmC,QAAQ,OAAO,MAAM,KAAG,MAOvF,CAAC"}

package/dist/folds/fold-model.js

@@ -0,0 +1,51 @@
+/**
+ * Project `rowCount` rows through the closed folds. A closed range hides its
+ * body even when it sits inside another closed range; the outermost header
+ * shown carries the count of every row hidden below it.
+ */
+export const computeFoldView = function computeFoldView(rowCount, ranges, closedKeys) {
+    const closedEnds = new Map();
+    for (const range of ranges) {
+        if (range.end > range.start && closedKeys.has(range.key)) {
+            closedEnds.set(range.start, Math.max(closedEnds.get(range.start) ?? range.end, range.end));
+        }
+    }
+    const visibleToSource = [];
+    const sourceToVisible = Array.from({ length: rowCount }, () => -1);
+    const hiddenCounts = new Map();
+    let hiddenUntil = -1;
+    for (let index = 0; index < rowCount; index += 1) {
+        if (index <= hiddenUntil) {
+            continue;
+        }
+        const visibleIndex = visibleToSource.length;
+        visibleToSource.push(index);
+        sourceToVisible[index] = visibleIndex;
+        const end = closedEnds.get(index);
+        if (end !== undefined) {
+            hiddenUntil = Math.min(end, rowCount - 1);
+            hiddenCounts.set(visibleIndex, hiddenUntil - index);
+        }
+    }
+    return { hiddenCounts, sourceToVisible, visibleToSource };
+};
+/** Ranges that contain `row` (header included), innermost first. */
+export const foldsAt = function foldsAt(ranges, row) {
+    return ranges
+        .filter((range) => range.end > range.start && range.start <= row && row <= range.end)
+        .toSorted((left, right) => right.start - left.start || left.end - right.end);
+};
+/**
+ * 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,
+ * which is the header of the outermost closed fold that hides it.
+ */
+export const visibleAnchorRow = function visibleAnchorRow(view, row) {
+    for (let index = Math.min(row, view.sourceToVisible.length - 1); index >= 0; index -= 1) {
+        if ((view.sourceToVisible[index] ?? -1) !== -1) {
+            return index;
+        }
+    }
+    return row;
+};
+//# sourceMappingURL=fold-model.js.map

package/dist/folds/fold-model.js.map

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

package/dist/folds/markdown-heading-folds.d.ts

@@ -0,0 +1,10 @@
+import type { FlatBlock } from "@tooee/renderers";
+import type { FoldRange } from "./fold-model.js";
+/**
+ * Heading fold ranges over flattened Markdown blocks. A heading at depth `d`
+ * folds every following block up to the next heading of depth `d` or less, or
+ * the end of the document. A heading with no body yields no range. Keys are
+ * the heading's block index, the same key the Markdown row adapter uses.
+ */
+export declare const markdownHeadingFoldRanges: (blocks: readonly FlatBlock[]) => FoldRange[];
+//# sourceMappingURL=markdown-heading-folds.d.ts.map

package/dist/folds/markdown-heading-folds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-heading-folds.d.ts","sourceRoot":"","sources":["../../src/folds/markdown-heading-folds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAWjD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,WAC5B,SAAS,SAAS,EAAE,KAC3B,SAAS,EA2BX,CAAC"}

package/dist/folds/markdown-heading-folds.js

@@ -0,0 +1,41 @@
+const headingDepth = function headingDepth(block) {
+    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.depth;
+};
+/**
+ * Heading fold ranges over flattened Markdown blocks. A heading at depth `d`
+ * folds every following block up to the next heading of depth `d` or less, or
+ * the end of the document. A heading with no body yields no range. Keys are
+ * the heading's block index, the same key the Markdown row adapter uses.
+ */
+export const markdownHeadingFoldRanges = function markdownHeadingFoldRanges(blocks) {
+    const ranges = [];
+    const open = [];
+    const close = (start, end) => {
+        if (end > start) {
+            ranges.push({ end, key: start, start });
+        }
+    };
+    for (const [index, block] of blocks.entries()) {
+        const depth = headingDepth(block);
+        if (depth === null) {
+            continue;
+        }
+        while (open.length > 0 && (open.at(-1)?.depth ?? 0) >= depth) {
+            const finished = open.pop();
+            if (finished) {
+                close(finished.start, index - 1);
+            }
+        }
+        open.push({ depth, start: index });
+    }
+    for (const finished of open) {
+        close(finished.start, blocks.length - 1);
+    }
+    return ranges.toSorted((left, right) => left.start - right.start);
+};
+//# sourceMappingURL=markdown-heading-folds.js.map

package/dist/folds/markdown-heading-folds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-heading-folds.js","sourceRoot":"","sources":["../../src/folds/markdown-heading-folds.ts"],"names":[],"mappings":"AAKA,MAAM,YAAY,GAAG,SAAS,YAAY,CAAC,KAAgB;IACzD,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,kFAAkF;IAClF,6HAA6H;IAC7H,OAAQ,KAAK,CAAC,KAAwB,CAAC,KAAK,CAAC;AAC/C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,yBAAyB,CACzE,MAA4B;IAE5B,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAuC,EAAE,CAAC;IACpD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,EAAE;QAC3C,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,SAAS;QACX,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;YAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC5B,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC,CAAC"}

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

@@ -0,0 +1,34 @@
+import type { DecorationLayer } from "@tooee/renderers";
+import type { NavigationState } from "@tooee/shell";
+import type { Key } from "react";
+import type { FoldRange, FoldView } from "./fold-model.js";
+/** Fold state over a full row array and the visible projection it produces. */
+export interface FoldState<T> {
+    /** The visible rows: pass this array to the document controller and the renderer. */
+    rows: readonly T[];
+    /** The full-array row count. */
+    rowCount: number;
+    ranges: readonly FoldRange[];
+    view: FoldView;
+    closedKeys: ReadonlySet<Key>;
+    setClosedKeys: (keys: ReadonlySet<Key>) => void;
+    /** External decoration layers projected onto the visible rows. */
+    decorations: DecorationLayer[];
+    /** One-based full-array row number for each visible row, or `undefined` when nothing is hidden. */
+    rowNumbers: readonly number[] | undefined;
+}
+/**
+ * Hold the closed fold keys for `rows` and project the rows, decorations and
+ * gutter numbers onto what stays visible. `ranges` and `decorations` use
+ * full-array row indices. With no closed fold, `rows` and `decorations` pass
+ * through unchanged.
+ */
+export declare const useFoldState: <T>(rows: readonly T[], ranges: readonly FoldRange[], decorations: DecorationLayer[]) => FoldState<T>;
+/**
+ * Register the Vim fold commands (`z a`, `z c`, `z o`, `z shift+m`,
+ * `z shift+r`) against a fold state and the controller's navigation. When a
+ * close hides the cursor row, the cursor moves first to the header of the
+ * outermost closed fold, and key preservation keeps it there.
+ */
+export declare const useFoldCommands: <T>(folds: FoldState<T>, navigation: Pick<NavigationState, "cursor" | "setCursor">) => void;
+//# sourceMappingURL=use-folds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-folds.d.ts","sourceRoot":"","sources":["../../src/folds/use-folds.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAIjC,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI3D,+EAA+E;AAC/E,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,qFAAqF;IACrF,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACnB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAChD,kEAAkE;IAClE,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,mGAAmG;IACnG,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAyB,CAAC,QAC3C,SAAS,CAAC,EAAE,UACV,SAAS,SAAS,EAAE,eACf,eAAe,EAAE,KAC7B,SAAS,CAAC,CAAC,CAqCb,CAAC;AAMF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAA4B,CAAC,SAChD,SAAS,CAAC,CAAC,CAAC,cACP,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,WAAW,CAAC,KACxD,IAiGF,CAAC"}

package/dist/folds/use-folds.js

@@ -0,0 +1,136 @@
+import { useCommand, useCommandGroup } from "@tooee/commands";
+import { useMemo, useState } from "react";
+import { projectDecorationLayers } from "./fold-decorations.js";
+import { computeFoldView, foldsAt, visibleAnchorRow } from "./fold-model.js";
+const EMPTY_KEYS = new Set();
+/**
+ * Hold the closed fold keys for `rows` and project the rows, decorations and
+ * gutter numbers onto what stays visible. `ranges` and `decorations` use
+ * full-array row indices. With no closed fold, `rows` and `decorations` pass
+ * through unchanged.
+ */
+export const useFoldState = function useFoldState(rows, ranges, decorations) {
+    const [closedKeys, setClosedKeys] = useState(EMPTY_KEYS);
+    const view = useMemo(() => computeFoldView(rows.length, ranges, closedKeys), [rows.length, ranges, closedKeys]);
+    const folded = view.visibleToSource.length < rows.length;
+    const visibleRows = useMemo(() => folded
+        ? view.visibleToSource.flatMap((index) => {
+            const row = rows[index];
+            return row === undefined ? [] : [row];
+        })
+        : rows, [folded, rows, view]);
+    const visibleDecorations = useMemo(() => (folded ? projectDecorationLayers(decorations, view) : decorations), [folded, decorations, view]);
+    const rowNumbers = useMemo(() => (folded ? view.visibleToSource.map((index) => index + 1) : undefined), [folded, view]);
+    return {
+        closedKeys,
+        decorations: visibleDecorations,
+        ranges,
+        rowCount: rows.length,
+        rowNumbers,
+        rows: visibleRows,
+        setClosedKeys,
+        view,
+    };
+};
+const warnNoFold = function warnNoFold(ctx) {
+    ctx.toast?.toast({ level: "warning", message: "No fold at cursor" });
+};
+/**
+ * Register the Vim fold commands (`z a`, `z c`, `z o`, `z shift+m`,
+ * `z shift+r`) against a fold state and the controller's navigation. When a
+ * close hides the cursor row, the cursor moves first to the header of the
+ * outermost closed fold, and key preservation keeps it there.
+ */
+export const useFoldCommands = function useFoldCommands(folds, navigation) {
+    const { closedKeys, ranges, rowCount, setClosedKeys, view } = folds;
+    const { cursor, setCursor } = navigation;
+    const sourceRow = cursor === null ? undefined : view.visibleToSource[cursor];
+    const atCursor = sourceRow === undefined ? [] : foldsAt(ranges, sourceRow);
+    const apply = (next) => {
+        if (sourceRow !== undefined) {
+            const anchor = visibleAnchorRow(computeFoldView(rowCount, ranges, next), sourceRow);
+            const anchorIndex = view.sourceToVisible[anchor] ?? -1;
+            if (anchor !== sourceRow && anchorIndex !== -1) {
+                setCursor(anchorIndex);
+            }
+        }
+        setClosedKeys(next);
+    };
+    const withKey = (key, closed) => {
+        const next = new Set(closedKeys);
+        if (closed) {
+            next.add(key);
+        }
+        else {
+            next.delete(key);
+        }
+        apply(next);
+    };
+    useCommandGroup({ id: "fold", prefix: "z", title: "Fold" });
+    useCommand({
+        category: "Fold",
+        handler: (ctx) => {
+            const [innermost] = atCursor;
+            if (innermost === undefined) {
+                warnNoFold(ctx);
+                return;
+            }
+            withKey(innermost.key, !closedKeys.has(innermost.key));
+        },
+        hotkey: "z a",
+        id: "fold.toggle",
+        modes: ["cursor"],
+        title: "Toggle fold",
+    });
+    useCommand({
+        category: "Fold",
+        handler: (ctx) => {
+            const target = atCursor.find((range) => !closedKeys.has(range.key));
+            if (target === undefined) {
+                warnNoFold(ctx);
+                return;
+            }
+            withKey(target.key, true);
+        },
+        hotkey: "z c",
+        id: "fold.close",
+        modes: ["cursor"],
+        title: "Close fold",
+    });
+    useCommand({
+        category: "Fold",
+        handler: (ctx) => {
+            const target = atCursor.find((range) => closedKeys.has(range.key));
+            if (target === undefined) {
+                warnNoFold(ctx);
+                return;
+            }
+            withKey(target.key, false);
+        },
+        hotkey: "z o",
+        id: "fold.open",
+        modes: ["cursor"],
+        title: "Open fold",
+    });
+    useCommand({
+        category: "Fold",
+        handler: () => {
+            apply(new Set(ranges.map((range) => range.key)));
+        },
+        hotkey: "z shift+m",
+        id: "fold.close-all",
+        modes: ["cursor"],
+        title: "Close all folds",
+    });
+    useCommand({
+        category: "Fold",
+        handler: () => {
+            apply(EMPTY_KEYS);
+        },
+        hotkey: "z shift+r",
+        id: "fold.open-all",
+        modes: ["cursor"],
+        title: "Open all folds",
+    });
+};
+//# sourceMappingURL=use-folds.js.map

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

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

package/package.json

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

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

@@ -6,6 +6,8 @@ import type { DocumentRowAdapter } from "@tooee/shell";
 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 { useContentDocument } from "../../hooks/use-content-document.js";
 import type { MarkdownContent, MarkdownLinkActivateHandler } from "../../types.js";
 import { ViewScreen } from "../view-screen.js";
@@ -23,11 +25,19 @@ const BLOCK_HSCROLL_STEP = 4;
 /**
  * Blocks are the row unit. `getFlatBlockText` keeps search/copy in step with the
  * source mapping (notably for synthetic bullet rows), and `getSource` projects
- * each block's Markdown provenance onto the controller's anchors.
+ * each block's Markdown provenance onto the controller's anchors. The key is
+ * the block's index in the full flattened document, so it stays the same when
+ * folds hide the blocks around it.
  */
-const MARKDOWN_BLOCK_ADAPTER: DocumentRowAdapter<FlatBlock> = {
-  getSource: (block) => block.source,
-  getText: (block) => getFlatBlockText(block),
+const markdownBlockAdapter = function markdownBlockAdapter(
+  blocks: readonly FlatBlock[]
+): DocumentRowAdapter<FlatBlock> {
+  const indices = new Map(blocks.map((block, index) => [block, index]));
+  return {
+    getKey: (block, index) => indices.get(block) ?? index,
+    getSource: (block) => block.source,
+    getText: (block) => getFlatBlockText(block),
+  };
 };
 
 export const MarkdownSubview = function MarkdownSubview({
@@ -41,19 +51,26 @@ export const MarkdownSubview = function MarkdownSubview({
   const textContent = content.markdown;
   const lineCount = useMemo(() => textContent.split("\n").length, [textContent]);
   const blocks = useMemo(() => flattenMarkdown(content.markdown), [content.markdown]);
+  const adapter = useMemo(() => markdownBlockAdapter(blocks), [blocks]);
+  const foldRanges = useMemo(() => markdownHeadingFoldRanges(blocks), [blocks]);
+  // Closed heading folds filter `blocks`; `folds.rows` is the one array both
+  // the controller and the renderer see.
+  const folds = useFoldState(blocks, foldRanges, decorations);
 
   const { document, showLineNumbers, statusItems } = useContentDocument<FlatBlock>(
-    blocks,
-    MARKDOWN_BLOCK_ADAPTER,
-    { actions, content, decorations, textContent },
+    folds.rows,
+    adapter,
+    { actions, content, decorations: folds.decorations, textContent },
     {
       multiSelect: true,
+      preserveCursorByKey: true,
       statusItems: [
         { label: "Format:", value: content.format },
         { label: "Lines:", value: String(lineCount) },
       ],
     }
   );
+  useFoldCommands(folds, document.navigation);
   const buildCommandContext = useBuildCommandContext();
   const handleLinkActivate = onLinkActivate
     ? (href: string) => onLinkActivate(href, buildCommandContext())
@@ -101,7 +118,9 @@ export const MarkdownSubview = function MarkdownSubview({
     >
       <MarkdownView
         content={content.markdown}
-        blocks={blocks}
+        blocks={folds.rows}
+        rowNumbers={folds.rowNumbers}
+        foldedBlocks={folds.view.hiddenCounts}
         showLineNumbers={showLineNumbers}
         document={document}
         hScrollableBlocksRef={hScrollableBlocksRef}

package/src/folds/fold-decorations.ts

@@ -0,0 +1,30 @@
+import type { DecorationLayer, RowDecoration } from "@tooee/renderers";
+
+import type { FoldView } from "./fold-model.js";
+
+/**
+ * Map decoration layers written against full-array rows onto the visible rows
+ * of `view`. Decorations on rows that a closed fold hides are dropped.
+ */
+export const projectDecorationLayers = function projectDecorationLayers(
+  layers: readonly DecorationLayer[],
+  view: FoldView
+): DecorationLayer[] {
+  const { visibleToSource, sourceToVisible } = view;
+  return layers.map((layer): DecorationLayer => ({
+    *forVisibleRows(from: number, to: number): Generator<RowDecoration> {
+      const sourceFrom = visibleToSource[from];
+      const sourceTo = visibleToSource[Math.min(to, visibleToSource.length - 1)];
+      if (sourceFrom === undefined || sourceTo === undefined) {
+        return;
+      }
+      for (const decoration of layer.forVisibleRows(sourceFrom, sourceTo)) {
+        const row = sourceToVisible[decoration.row] ?? -1;
+        if (row !== -1) {
+          yield { ...decoration, row };
+        }
+      }
+    },
+    priority: layer.priority,
+  }));
+};

package/src/folds/fold-model.ts

@@ -0,0 +1,85 @@
+import type { Key } from "react";
+
+/**
+ * A foldable range of rows. `start` is the header row that stays visible;
+ * `start + 1 ..= end` are the rows a closed fold hides. Indices point into the
+ * full row array, and `key` is the header row's key, so closed state survives
+ * row changes that keep keys stable.
+ */
+export interface FoldRange {
+  key: Key;
+  start: number;
+  end: number;
+}
+
+/** The visible projection of a full row array under a set of closed folds. */
+export interface FoldView {
+  /** Full-array index of each visible row, in order. */
+  visibleToSource: readonly number[];
+  /** Visible index of each full-array row, or `-1` when a closed fold hides it. */
+  sourceToVisible: readonly number[];
+  /** Hidden row count for each closed header, keyed by the header's visible index. */
+  hiddenCounts: ReadonlyMap<number, number>;
+}
+
+/**
+ * Project `rowCount` rows through the closed folds. A closed range hides its
+ * body even when it sits inside another closed range; the outermost header
+ * shown carries the count of every row hidden below it.
+ */
+export const computeFoldView = function computeFoldView(
+  rowCount: number,
+  ranges: readonly FoldRange[],
+  closedKeys: ReadonlySet<Key>
+): FoldView {
+  const closedEnds = new Map<number, number>();
+  for (const range of ranges) {
+    if (range.end > range.start && closedKeys.has(range.key)) {
+      closedEnds.set(range.start, Math.max(closedEnds.get(range.start) ?? range.end, range.end));
+    }
+  }
+
+  const visibleToSource: number[] = [];
+  const sourceToVisible: number[] = Array.from({ length: rowCount }, () => -1);
+  const hiddenCounts = new Map<number, number>();
+  let hiddenUntil = -1;
+  for (let index = 0; index < rowCount; index += 1) {
+    if (index <= hiddenUntil) {
+      continue;
+    }
+    const visibleIndex = visibleToSource.length;
+    visibleToSource.push(index);
+    sourceToVisible[index] = visibleIndex;
+    const end = closedEnds.get(index);
+    if (end !== undefined) {
+      hiddenUntil = Math.min(end, rowCount - 1);
+      hiddenCounts.set(visibleIndex, hiddenUntil - index);
+    }
+  }
+
+  return { hiddenCounts, sourceToVisible, visibleToSource };
+};
+
+/** Ranges that contain `row` (header included), innermost first. */
+export const foldsAt = function foldsAt(
+  ranges: readonly FoldRange[],
+  row: number
+): readonly FoldRange[] {
+  return ranges
+    .filter((range) => range.end > range.start && range.start <= row && row <= range.end)
+    .toSorted((left, right) => right.start - left.start || left.end - right.end);
+};
+
+/**
+ * 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,
+ * which is the header of the outermost closed fold that hides it.
+ */
+export const visibleAnchorRow = function visibleAnchorRow(view: FoldView, row: number): number {
+  for (let index = Math.min(row, view.sourceToVisible.length - 1); index >= 0; index -= 1) {
+    if ((view.sourceToVisible[index] ?? -1) !== -1) {
+      return index;
+    }
+  }
+  return row;
+};

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

@@ -0,0 +1,50 @@
+import type { FlatBlock } from "@tooee/renderers";
+import type { Tokens } from "marked";
+
+import type { FoldRange } from "./fold-model.js";
+
+const headingDepth = function headingDepth(block: FlatBlock): number | 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;
+};
+
+/**
+ * Heading fold ranges over flattened Markdown blocks. A heading at depth `d`
+ * folds every following block up to the next heading of depth `d` or less, or
+ * the end of the document. A heading with no body yields no range. Keys are
+ * the heading's block index, the same key the Markdown row adapter uses.
+ */
+export const markdownHeadingFoldRanges = function markdownHeadingFoldRanges(
+  blocks: readonly FlatBlock[]
+): FoldRange[] {
+  const ranges: FoldRange[] = [];
+  const open: { depth: number; start: number }[] = [];
+  const close = (start: number, end: number) => {
+    if (end > start) {
+      ranges.push({ end, key: start, start });
+    }
+  };
+
+  for (const [index, block] of blocks.entries()) {
+    const depth = headingDepth(block);
+    if (depth === null) {
+      continue;
+    }
+    while (open.length > 0 && (open.at(-1)?.depth ?? 0) >= depth) {
+      const finished = open.pop();
+      if (finished) {
+        close(finished.start, index - 1);
+      }
+    }
+    open.push({ depth, start: index });
+  }
+  for (const finished of open) {
+    close(finished.start, blocks.length - 1);
+  }
+
+  return ranges.toSorted((left, right) => left.start - right.start);
+};

package/src/folds/use-folds.ts

@@ -0,0 +1,189 @@
+import { useCommand, useCommandGroup } from "@tooee/commands";
+import type { CommandContext } from "@tooee/commands";
+import type { DecorationLayer } from "@tooee/renderers";
+import type { NavigationState } from "@tooee/shell";
+import { useMemo, useState } from "react";
+import type { Key } from "react";
+
+import { projectDecorationLayers } from "./fold-decorations.js";
+import { computeFoldView, foldsAt, visibleAnchorRow } from "./fold-model.js";
+import type { FoldRange, FoldView } from "./fold-model.js";
+
+const EMPTY_KEYS: ReadonlySet<Key> = new Set();
+
+/** Fold state over a full row array and the visible projection it produces. */
+export interface FoldState<T> {
+  /** The visible rows: pass this array to the document controller and the renderer. */
+  rows: readonly T[];
+  /** The full-array row count. */
+  rowCount: number;
+  ranges: readonly FoldRange[];
+  view: FoldView;
+  closedKeys: ReadonlySet<Key>;
+  setClosedKeys: (keys: ReadonlySet<Key>) => void;
+  /** External decoration layers projected onto the visible rows. */
+  decorations: DecorationLayer[];
+  /** One-based full-array row number for each visible row, or `undefined` when nothing is hidden. */
+  rowNumbers: readonly number[] | undefined;
+}
+
+/**
+ * Hold the closed fold keys for `rows` and project the rows, decorations and
+ * gutter numbers onto what stays visible. `ranges` and `decorations` use
+ * full-array row indices. With no closed fold, `rows` and `decorations` pass
+ * through unchanged.
+ */
+export const useFoldState = function useFoldState<T>(
+  rows: readonly T[],
+  ranges: readonly FoldRange[],
+  decorations: DecorationLayer[]
+): FoldState<T> {
+  const [closedKeys, setClosedKeys] = useState<ReadonlySet<Key>>(EMPTY_KEYS);
+  const view = useMemo(
+    () => computeFoldView(rows.length, ranges, closedKeys),
+    [rows.length, ranges, closedKeys]
+  );
+  const folded = view.visibleToSource.length < rows.length;
+
+  const visibleRows = useMemo(
+    () =>
+      folded
+        ? view.visibleToSource.flatMap((index) => {
+            const row = rows[index];
+            return row === undefined ? [] : [row];
+          })
+        : rows,
+    [folded, rows, view]
+  );
+  const visibleDecorations = useMemo(
+    () => (folded ? projectDecorationLayers(decorations, view) : decorations),
+    [folded, decorations, view]
+  );
+  const rowNumbers = useMemo(
+    () => (folded ? view.visibleToSource.map((index) => index + 1) : undefined),
+    [folded, view]
+  );
+
+  return {
+    closedKeys,
+    decorations: visibleDecorations,
+    ranges,
+    rowCount: rows.length,
+    rowNumbers,
+    rows: visibleRows,
+    setClosedKeys,
+    view,
+  };
+};
+
+const warnNoFold = function warnNoFold(ctx: CommandContext): void {
+  ctx.toast?.toast({ level: "warning", message: "No fold at cursor" });
+};
+
+/**
+ * Register the Vim fold commands (`z a`, `z c`, `z o`, `z shift+m`,
+ * `z shift+r`) against a fold state and the controller's navigation. When a
+ * close hides the cursor row, the cursor moves first to the header of the
+ * outermost closed fold, and key preservation keeps it there.
+ */
+export const useFoldCommands = function useFoldCommands<T>(
+  folds: FoldState<T>,
+  navigation: Pick<NavigationState, "cursor" | "setCursor">
+): void {
+  const { closedKeys, ranges, rowCount, setClosedKeys, view } = folds;
+  const { cursor, setCursor } = navigation;
+  const sourceRow = cursor === null ? undefined : view.visibleToSource[cursor];
+  const atCursor = sourceRow === undefined ? [] : foldsAt(ranges, sourceRow);
+
+  const apply = (next: ReadonlySet<Key>) => {
+    if (sourceRow !== undefined) {
+      const anchor = visibleAnchorRow(computeFoldView(rowCount, ranges, next), sourceRow);
+      const anchorIndex = view.sourceToVisible[anchor] ?? -1;
+      if (anchor !== sourceRow && anchorIndex !== -1) {
+        setCursor(anchorIndex);
+      }
+    }
+    setClosedKeys(next);
+  };
+  const withKey = (key: Key, closed: boolean) => {
+    const next = new Set(closedKeys);
+    if (closed) {
+      next.add(key);
+    } else {
+      next.delete(key);
+    }
+    apply(next);
+  };
+
+  useCommandGroup({ id: "fold", prefix: "z", title: "Fold" });
+
+  useCommand({
+    category: "Fold",
+    handler: (ctx) => {
+      const [innermost] = atCursor;
+      if (innermost === undefined) {
+        warnNoFold(ctx);
+        return;
+      }
+      withKey(innermost.key, !closedKeys.has(innermost.key));
+    },
+    hotkey: "z a",
+    id: "fold.toggle",
+    modes: ["cursor"],
+    title: "Toggle fold",
+  });
+
+  useCommand({
+    category: "Fold",
+    handler: (ctx) => {
+      const target = atCursor.find((range) => !closedKeys.has(range.key));
+      if (target === undefined) {
+        warnNoFold(ctx);
+        return;
+      }
+      withKey(target.key, true);
+    },
+    hotkey: "z c",
+    id: "fold.close",
+    modes: ["cursor"],
+    title: "Close fold",
+  });
+
+  useCommand({
+    category: "Fold",
+    handler: (ctx) => {
+      const target = atCursor.find((range) => closedKeys.has(range.key));
+      if (target === undefined) {
+        warnNoFold(ctx);
+        return;
+      }
+      withKey(target.key, false);
+    },
+    hotkey: "z o",
+    id: "fold.open",
+    modes: ["cursor"],
+    title: "Open fold",
+  });
+
+  useCommand({
+    category: "Fold",
+    handler: () => {
+      apply(new Set(ranges.map((range) => range.key)));
+    },
+    hotkey: "z shift+m",
+    id: "fold.close-all",
+    modes: ["cursor"],
+    title: "Close all folds",
+  });
+
+  useCommand({
+    category: "Fold",
+    handler: () => {
+      apply(EMPTY_KEYS);
+    },
+    hotkey: "z shift+r",
+    id: "fold.open-all",
+    modes: ["cursor"],
+    title: "Open all folds",
+  });
+};