dsh-better-display 0.1.1

package/lib/types/client/live-turn.js

@@ -0,0 +1,144 @@
+import { assistantSegments, hasVisibleBody } from './projection.js';
+export function liveFoldEnabled(boundary) {
+    return boundary.status === 'open';
+}
+export function foldSummary(steps) {
+    let reasoning = 0;
+    let body = 0;
+    let tool = 0;
+    let extra = 0;
+    for (const step of steps) {
+        if (step.kind === 'reasoning')
+            reasoning += 1;
+        else if (step.kind === 'body')
+            body += 1;
+        else if (step.kind === 'tool')
+            tool += 1;
+        else if (step.kind !== 'user')
+            extra += 1;
+    }
+    const parts = [];
+    if (reasoning)
+        parts.push(`思考×${reasoning}`);
+    if (body)
+        parts.push(`输出×${body}`);
+    if (tool)
+        parts.push(`工具×${tool}`);
+    if (extra)
+        parts.push(`记录×${extra}`);
+    return parts.join(' · ') || '此前步骤';
+}
+/** One chain: fold only when a new reasoning step has prior body/tool/reasoning. */
+export function splitChain(chain) {
+    const lastReasoning = chain.findLastIndex(step => step.kind === 'reasoning');
+    if (lastReasoning < 0)
+        return { fold: null, open: chain };
+    const prior = chain.slice(0, lastReasoning);
+    if (!prior.length)
+        return { fold: null, open: chain };
+    const trigger = prior.some(step => step.kind === 'reasoning' || step.kind === 'body' || step.kind === 'tool');
+    if (!trigger)
+        return { fold: null, open: chain };
+    return { fold: prior, open: chain.slice(lastReasoning) };
+}
+function skipReasoning(part) {
+    return part.kind === 'reasoning' && !part.blocks.some(block => block.kind === 'reasoning' && block.text.trim() !== '');
+}
+function skipBody(part) {
+    return part.kind === 'body' && !hasVisibleBody(part.blocks);
+}
+function stepsFromAssistant(nodeKey, data, toolsByCallId, consumed) {
+    const marks = [];
+    for (const part of assistantSegments(data.blocks)) {
+        if (skipReasoning(part) || skipBody(part))
+            continue;
+        marks.push({
+            at: part.start,
+            step: {
+                kind: part.kind,
+                key: `${nodeKey}:${part.kind}:${part.start}`,
+                nodeKey,
+                start: part.start,
+                blocks: part.blocks,
+                step: data.step,
+            },
+        });
+    }
+    data.blocks.forEach((block, index) => {
+        if (block.kind !== 'tool-call' || !block.callId)
+            return;
+        const tool = toolsByCallId.get(block.callId);
+        if (!tool || consumed.has(tool.callId))
+            return;
+        consumed.add(tool.callId);
+        marks.push({ at: index, step: { kind: 'tool', key: tool.key, entry: tool } });
+    });
+    marks.sort((left, right) => left.at - right.at || left.step.key.localeCompare(right.step.key));
+    return marks.map(mark => mark.step);
+}
+/** Expand readerFlow into source-ordered live steps using existing block boundaries. */
+export function segmentLiveTurn(flow, get) {
+    const steps = [];
+    const consumed = new Set();
+    const toolsByCallId = new Map();
+    for (const entry of flow) {
+        if (entry.kind === 'tool')
+            toolsByCallId.set(entry.callId, entry);
+    }
+    for (const entry of flow) {
+        if (entry.kind === 'tool') {
+            if (!consumed.has(entry.callId)) {
+                steps.push({ kind: 'tool', key: entry.key, entry });
+                consumed.add(entry.callId);
+            }
+            continue;
+        }
+        const node = get(entry.nodeKey);
+        if (!node || node.visibility === 'hidden' || node.kind === 'turn-tail')
+            continue;
+        if (node.kind === 'user' || node.kind === 'steering') {
+            steps.push({ kind: 'user', key: entry.key, nodeKey: entry.nodeKey });
+            continue;
+        }
+        if (node.kind === 'assistant-step') {
+            steps.push(...stepsFromAssistant(entry.nodeKey, node.data, toolsByCallId, consumed));
+            continue;
+        }
+        steps.push({ kind: 'other', key: entry.key, nodeKey: entry.nodeKey });
+    }
+    return steps;
+}
+export function presentLiveTurn(steps, boundary, autoFold = true) {
+    const live = autoFold && liveFoldEnabled(boundary);
+    const items = [];
+    let chain = [];
+    const flush = () => {
+        if (!chain.length)
+            return;
+        if (!live) {
+            for (const step of chain)
+                items.push({ kind: 'open', key: step.key, step });
+            chain = [];
+            return;
+        }
+        const { fold, open } = splitChain(chain);
+        if (fold?.length) {
+            items.push({ kind: 'fold', key: `live-fold:${chain[0].key}`, steps: fold, summary: foldSummary(fold) });
+        }
+        for (const step of open)
+            items.push({ kind: 'open', key: step.key, step });
+        chain = [];
+    };
+    for (const step of steps) {
+        if (step.kind === 'user') {
+            flush();
+            items.push({ kind: 'user', key: step.key, step });
+        }
+        else {
+            chain.push(step);
+        }
+    }
+    flush();
+    return items;
+}
+//# sourceMappingURL=live-turn.js.map

package/lib/types/client/live-turn.js.map

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

package/lib/types/client/markdown/MarkdownText.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Untrusted assistant-Markdown renderer over the direct mdast pipeline:
+ * `parse.ts` grammars, the incremental streaming parser, and `render.tsx`.
+ * While a message streams, all but the trailing two blocks freeze as cached
+ * React elements and only the source tail behind them re-parses per chunk,
+ * so per-chunk work tracks the tail size instead of the whole reply. Frozen
+ * blocks keep their source-offset keys when they cross the freeze boundary,
+ * so React reconciles instead of remounting. Known deviation while
+ * streaming: a reference-style link or footnote whose definition sits on the
+ * other side of the freeze boundary renders literally until the settled
+ * full parse self-heals it.
+ */
+import type { MarkdownCodeLabels, MarkdownFileMentions, MarkdownRenderContext } from './render.js';
+export type { MarkdownCodeLabels, MarkdownFileMentions } from './render.js';
+/**
+ * Render untrusted assistant-authored Markdown as semantic React elements.
+ * @param props - Markdown source text preserved by the session projection;
+ * `streaming` renders fences and TeX plain (highlighting and KaTeX land on
+ * the finalize swap) and parses incrementally across chunks; `codeLabels`
+ * forwards localized copy-button labels to fence CodeBlocks — pass a
+ * reference-stable object (memoized per locale revision), because a new
+ * identity discards the streaming render cache mid-message. `fileMentions`
+ * links inline-code tokens its resolver recognizes as real files; this is
+ * the single streaming gate — it applies to settled renders only, because a
+ * streaming message's vocabulary is not final and frozen cached elements
+ * must not bake in handlers that could go stale.
+ * @returns A GFM document with TeX math rendered through KaTeX; raw HTML,
+ * relative links, and unsafe protocols are disabled, while absolute HTTP(S)
+ * images render directly.
+ */
+export declare const MarkdownText: import("react").MemoExoticComponent<({ text, streaming, codeLabels, fileMentions, renderText, renderAtom }: {
+    text: string;
+    streaming?: boolean;
+    codeLabels?: MarkdownCodeLabels | undefined;
+    fileMentions?: MarkdownFileMentions | undefined;
+    renderText?: MarkdownRenderContext["renderText"];
+    renderAtom?: MarkdownRenderContext["renderAtom"];
+}) => import("react").JSX.Element>;
+//# sourceMappingURL=MarkdownText.d.ts.map

package/lib/types/client/markdown/MarkdownText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownText.d.ts","sourceRoot":"","sources":["../../../../src/client/markdown/MarkdownText.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAUH,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAAoB,MAAM,aAAa,CAAA;AAIpH,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AA0H3E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,8GAA6G;IACpI,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAA;IAC3C,YAAY,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAA;IAC/C,UAAU,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAA;IAChD,UAAU,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAA;CACjD,iCAeC,CAAA"}

package/lib/types/client/markdown/MarkdownText.js

@@ -0,0 +1,171 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// Adapted from DeepSeek Harness b150a551b8d465e31e418e1b2eaf5e79bbb7d28e (MIT). See THIRD_PARTY_NOTICES.md.
+/**
+ * Untrusted assistant-Markdown renderer over the direct mdast pipeline:
+ * `parse.ts` grammars, the incremental streaming parser, and `render.tsx`.
+ * While a message streams, all but the trailing two blocks freeze as cached
+ * React elements and only the source tail behind them re-parses per chunk,
+ * so per-chunk work tracks the tail size instead of the whole reply. Frozen
+ * blocks keep their source-offset keys when they cross the freeze boundary,
+ * so React reconciles instead of remounting. Known deviation while
+ * streaming: a reference-style link or footnote whose definition sits on the
+ * other side of the freeze boundary renders literally until the settled
+ * full parse self-heals it.
+ */
+import { memo, useMemo, useRef } from 'react';
+import { IncrementalMarkdownParser } from './incremental.js';
+import { parseGfm, parseGfmWithMath } from './parse.js';
+import { collectReferenceTargets, createReferenceTargets, renderBlocks, renderFootnoteSection, wrapBlockChildren, } from './render.js';
+// KaTeX CSS is supplied once by the shared DSH UI-primitives client bundle.
+import css from './MarkdownText.module.css';
+/** One settled full render: parse with math, resolve references, append the footnote section. */
+function renderSettled(text, codeLabels, fileMentions, renderText, renderAtom) {
+    const root = parseGfmWithMath(text);
+    const targets = createReferenceTargets();
+    collectReferenceTargets(root.children, targets);
+    const context = {
+        renderText,
+        renderAtom,
+        streaming: false,
+        codeLabels,
+        fileMentions,
+        targets,
+        footnoteOrder: [],
+        footnoteCounts: new Map(),
+    };
+    const blocks = wrapBlockChildren(renderBlocks(root.children.map((node, index) => ({ node, key: node.position?.start.offset ?? -(index + 1) })), context), false);
+    const section = renderFootnoteSection(context);
+    return section === null ? blocks : [...blocks, '\n', section];
+}
+/**
+ * Streaming render state for one growing message: the incremental parser,
+ * the frozen blocks' cached elements, and the reference/footnote state their
+ * rendering consumed (footnote numbering assigned to frozen references is
+ * final, so the tail continues from a copy of it each frame).
+ */
+class StreamingRenderer {
+    codeLabels;
+    renderText;
+    renderAtom;
+    parser = new IncrementalMarkdownParser(parseGfm);
+    generation = -1;
+    frozenCount = 0;
+    frozenElements = [];
+    frozenTargets = createReferenceTargets();
+    frozenFootnoteOrder = [];
+    frozenFootnoteCounts = new Map();
+    lastText = null;
+    lastRendered = [];
+    /** @param codeLabels - Fence copy labels baked into cached elements; the owner replaces the renderer when they change. */
+    constructor(codeLabels, renderText, renderAtom) {
+        this.codeLabels = codeLabels;
+        this.renderText = renderText;
+        this.renderAtom = renderAtom;
+    }
+    /**
+     * Render the current accumulated text. Idempotent per text value, so React
+     * may re-execute the calling render freely.
+     * @param text - The full accumulated markdown source.
+     * @returns Frozen elements, re-rendered tail, and the footnote section.
+     */
+    render(text) {
+        if (text === this.lastText)
+            return this.lastRendered;
+        const { frozen, tail, generation } = this.parser.update(text);
+        if (generation !== this.generation) {
+            this.generation = generation;
+            this.frozenCount = 0;
+            this.frozenElements = [];
+            this.frozenTargets = createReferenceTargets();
+            this.frozenFootnoteOrder = [];
+            this.frozenFootnoteCounts = new Map();
+        }
+        const newlyFrozen = frozen.slice(this.frozenCount);
+        collectReferenceTargets(newlyFrozen.map(block => block.node), this.frozenTargets);
+        // Targets visible this frame: everything frozen so far plus the current
+        // tail parse — a newly frozen block's references resolved against the
+        // same parse tree its definitions came from.
+        const frameTargets = {
+            definitions: new Map(this.frozenTargets.definitions),
+            footnotes: new Map(this.frozenTargets.footnotes),
+        };
+        collectReferenceTargets(tail.map(block => block.node), frameTargets);
+        if (newlyFrozen.length > 0) {
+            const frozenContext = {
+                renderText: this.renderText,
+                renderAtom: this.renderAtom,
+                streaming: true,
+                codeLabels: this.codeLabels,
+                fileMentions: undefined,
+                targets: frameTargets,
+                footnoteOrder: this.frozenFootnoteOrder,
+                footnoteCounts: this.frozenFootnoteCounts,
+            };
+            // Separator newlines are cached alongside the elements so the
+            // assembled children match the settled pipeline's block wrapping.
+            const batch = [...this.frozenElements];
+            for (const element of renderBlocks(newlyFrozen, frozenContext)) {
+                if (batch.length > 0)
+                    batch.push('\n');
+                batch.push(element);
+            }
+            this.frozenElements = batch;
+            this.frozenCount = frozen.length;
+        }
+        const tailContext = {
+            renderText: this.renderText,
+            renderAtom: this.renderAtom,
+            streaming: true,
+            codeLabels: this.codeLabels,
+            fileMentions: undefined,
+            targets: frameTargets,
+            footnoteOrder: [...this.frozenFootnoteOrder],
+            footnoteCounts: new Map(this.frozenFootnoteCounts),
+        };
+        const children = [...this.frozenElements];
+        for (const element of renderBlocks(tail, tailContext)) {
+            if (children.length > 0)
+                children.push('\n');
+            children.push(element);
+        }
+        const section = renderFootnoteSection(tailContext);
+        if (section !== null)
+            children.push('\n', section);
+        this.lastText = text;
+        this.lastRendered = children;
+        return this.lastRendered;
+    }
+}
+/**
+ * Render untrusted assistant-authored Markdown as semantic React elements.
+ * @param props - Markdown source text preserved by the session projection;
+ * `streaming` renders fences and TeX plain (highlighting and KaTeX land on
+ * the finalize swap) and parses incrementally across chunks; `codeLabels`
+ * forwards localized copy-button labels to fence CodeBlocks — pass a
+ * reference-stable object (memoized per locale revision), because a new
+ * identity discards the streaming render cache mid-message. `fileMentions`
+ * links inline-code tokens its resolver recognizes as real files; this is
+ * the single streaming gate — it applies to settled renders only, because a
+ * streaming message's vocabulary is not final and frozen cached elements
+ * must not bake in handlers that could go stale.
+ * @returns A GFM document with TeX math rendered through KaTeX; raw HTML,
+ * relative links, and unsafe protocols are disabled, while absolute HTTP(S)
+ * images render directly.
+ */
+export const MarkdownText = memo(function MarkdownText({ text, streaming = false, codeLabels, fileMentions, renderText, renderAtom }) {
+    const streamRef = useRef(null);
+    const streamLabelsRef = useRef(codeLabels);
+    const children = useMemo(() => {
+        if (!streaming) {
+            streamRef.current = null;
+            return renderSettled(text, codeLabels, fileMentions, renderText, renderAtom);
+        }
+        if (streamRef.current === null || streamLabelsRef.current !== codeLabels) {
+            streamRef.current = new StreamingRenderer(codeLabels, renderText, renderAtom);
+            streamLabelsRef.current = codeLabels;
+        }
+        return streamRef.current.render(text);
+    }, [text, streaming, codeLabels, fileMentions, renderText, renderAtom]);
+    return _jsx("div", { className: css.markdown, children: children });
+});
+//# sourceMappingURL=MarkdownText.js.map

package/lib/types/client/markdown/MarkdownText.js.map

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

package/lib/types/client/markdown/cjkFriendlyStrong.d.ts

@@ -0,0 +1,9 @@
+/** Let asterisk strong emphasis close after punctuation when CJK prose continues without whitespace. */
+import type { Extension } from 'micromark-util-types';
+/**
+ * Extend CommonMark asterisk strong emphasis for punctuation-delimited CJK
+ * prose, as a micromark syntax extension for `fromMarkdown`.
+ * @returns The micromark syntax extension.
+ */
+export declare function cjkFriendlyStrong(): Extension;
+//# sourceMappingURL=cjkFriendlyStrong.d.ts.map

package/lib/types/client/markdown/cjkFriendlyStrong.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cjkFriendlyStrong.d.ts","sourceRoot":"","sources":["../../../../src/client/markdown/cjkFriendlyStrong.ts"],"names":[],"mappings":"AACA,wGAAwG;AAMxG,OAAO,KAAK,EAAa,SAAS,EAAoB,MAAM,sBAAsB,CAAA;AAqElF;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,CAE7C"}

package/lib/types/client/markdown/cjkFriendlyStrong.js

@@ -0,0 +1,73 @@
+// Adapted from DeepSeek Harness b150a551b8d465e31e418e1b2eaf5e79bbb7d28e (MIT). See THIRD_PARTY_NOTICES.md.
+/** Let asterisk strong emphasis close after punctuation when CJK prose continues without whitespace. */
+import { attention } from 'micromark-core-commonmark';
+import { unicodePunctuation } from 'micromark-util-character';
+import { classifyCharacter } from 'micromark-util-classify-character';
+import { codes, constants } from 'micromark-util-symbol';
+const cjkCharacter = new RegExp([
+    '\\p{Script_Extensions=Han}',
+    '\\p{Script_Extensions=Hiragana}',
+    '\\p{Script_Extensions=Katakana}',
+    '\\p{Script_Extensions=Hangul}',
+    '\\p{Script_Extensions=Bopomofo}',
+].join('|'), 'u');
+function isCjkCharacter(code) {
+    return code !== null && code >= 0 && cjkCharacter.test(String.fromCodePoint(code));
+}
+const tokenizeCjkFriendlyAttention = function (effects, ok, nok) {
+    const configuredAttentionMarkers = this.parser.constructs.attentionMarkers.null;
+    if (configuredAttentionMarkers === undefined) {
+        throw new Error('micromark CommonMark attention markers are unavailable');
+    }
+    const attentionMarkers = configuredAttentionMarkers;
+    const previous = this.previous;
+    const before = classifyCharacter(previous);
+    let marker = codes.eof;
+    return start;
+    function start(code) {
+        /* v8 ignore next -- this text construct is dispatched only for an asterisk. */
+        if (code !== codes.asterisk)
+            return nok(code);
+        marker = code;
+        effects.enter('attentionSequence');
+        return inside(code);
+    }
+    function inside(code) {
+        if (code === marker) {
+            effects.consume(code);
+            return inside;
+        }
+        const token = effects.exit('attentionSequence');
+        const after = classifyCharacter(code);
+        const open = !after || (after === constants.characterGroupPunctuation && Boolean(before))
+            || attentionMarkers.includes(code);
+        const commonMarkClose = !before
+            || (before === constants.characterGroupPunctuation && Boolean(after))
+            || attentionMarkers.includes(previous);
+        const markerCount = token.end.offset - token.start.offset;
+        const cjkStrongClose = markerCount >= 2
+            && unicodePunctuation(previous)
+            && isCjkCharacter(code);
+        const close = commonMarkClose || cjkStrongClose;
+        token._open = open;
+        token._close = close;
+        return ok(code);
+    }
+};
+const cjkFriendlyAttention = {
+    name: 'cjkFriendlyAttention',
+    resolveAll: attention.resolveAll,
+    tokenize: tokenizeCjkFriendlyAttention,
+};
+const cjkFriendlyStrongExtension = {
+    text: { [codes.asterisk]: cjkFriendlyAttention },
+};
+/**
+ * Extend CommonMark asterisk strong emphasis for punctuation-delimited CJK
+ * prose, as a micromark syntax extension for `fromMarkdown`.
+ * @returns The micromark syntax extension.
+ */
+export function cjkFriendlyStrong() {
+    return cjkFriendlyStrongExtension;
+}
+//# sourceMappingURL=cjkFriendlyStrong.js.map

package/lib/types/client/markdown/cjkFriendlyStrong.js.map

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

package/lib/types/client/markdown/incremental.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Incremental block-level markdown parsing for an append-only text stream.
+ *
+ * Re-parsing the whole accumulated document on every streaming chunk is
+ * quadratic in the final reply length. CommonMark block parsing is line-based
+ * and appended text can only reshape the parse frontier — the last top-level
+ * block (a paragraph becoming a setext heading or a table, a list continuing
+ * after a blank line, an unclosed fence swallowing lines) — so earlier blocks
+ * are final. This parser therefore freezes all but the trailing
+ * {@link UNSTABLE_TAIL_BLOCKS} blocks and re-parses only the source tail
+ * behind them: each source region is parsed O(1) times over the stream
+ * instead of once per chunk.
+ *
+ * The freeze boundary comes from the parser's own `position` offsets, never
+ * from custom source scanning. The cut sits at the *end offset* of the last
+ * frozen block (not the next block's start): a following block's start offset
+ * excludes up to three spaces of insignificant leading indentation, which is
+ * harmless to drop, but cutting at the previous end also keeps the
+ * inter-block blank lines in the tail so the sliced source stays verbatim.
+ *
+ * Known deviation, shared with any prefix-freeze scheme: micromark resolves
+ * reference-style links and footnotes document-wide at parse time, so a
+ * reference whose definition lands on the other side of the freeze boundary
+ * renders literally until the settled full parse self-heals it.
+ */
+import type { Root, RootContent } from 'mdast';
+/** A top-level mdast block plus a render key that is stable across chunks. */
+export interface PositionedBlock {
+    /** The parsed block. Positions inside it are relative to its parse slice. */
+    readonly node: RootContent;
+    /**
+     * The block's start offset in the full source text. Stable from the frame
+     * a block first appears through freezing, so React reconciles rather than
+     * remounts when a block crosses the freeze boundary.
+     */
+    readonly key: number;
+}
+/** One {@link IncrementalMarkdownParser.update} result. */
+export interface IncrementalBlocks {
+    /** Blocks that can no longer change; grows monotonically per generation. */
+    readonly frozen: readonly PositionedBlock[];
+    /** The re-parsed unstable tail (at most {@link UNSTABLE_TAIL_BLOCKS} blocks plus growth). */
+    readonly tail: readonly PositionedBlock[];
+    /** Bumped whenever non-append input discards the frozen prefix; callers drop caches keyed on it. */
+    readonly generation: number;
+}
+/**
+ * Append-only incremental parser over a caller-supplied grammar. One instance
+ * accumulates one streaming document; non-append input resets it.
+ */
+export declare class IncrementalMarkdownParser {
+    private readonly parse;
+    private prevText;
+    private tailStart;
+    private frozen;
+    private generation;
+    private cached;
+    /** @param parse - Grammar shared with whatever renders the blocks, so boundaries agree. */
+    constructor(parse: (text: string) => Root);
+    /**
+     * Fold the current accumulated text and return the frozen/tail split.
+     * Idempotent for identical input (the previous result is returned as-is),
+     * so callers may invoke it from render paths that re-execute.
+     * @param text - The full accumulated markdown source.
+     * @returns Frozen and tail blocks with stream-stable render keys.
+     */
+    update(text: string): IncrementalBlocks;
+}
+//# sourceMappingURL=incremental.d.ts.map

package/lib/types/client/markdown/incremental.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental.d.ts","sourceRoot":"","sources":["../../../../src/client/markdown/incremental.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAS9C,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;IAC3C,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAA;IACzC,oGAAoG;IACpG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAeD;;;GAGG;AACH,qBAAa,yBAAyB;IAQxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAPlC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,MAAM,CAAiC;IAE/C,2FAA2F;gBAC9D,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IAE1D;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;CAsCxC"}