dsh-better-display 0.3.7 → 0.3.9

package/lib/types/client/rewind-cut.js

@@ -0,0 +1,321 @@
+/**
+ * Which chat rows a `/rewind` withdrew, expressed as a pure function of the
+ * chat snapshot.
+ *
+ * WHY THIS EXISTS. A rewind never deletes history: the host appends one
+ * replacement `user/message` marker whose `surfaceOp` shadows everything after
+ * the target, and the transcript must then read as it did *before* the target
+ * was sent. The official ChatView is a per-node renderer, so the rewind plugin
+ * (`dsh-rewind-plugin`) hides withdrawn rows by DOM: it computes the shadowed
+ * anchor seqs from the command node and sets `display:none` on every element
+ * carrying the official `data-chat-anchor-key` seat attribute.
+ *
+ * The Reader replaces ChatView's message list and renders its own row shapes
+ * (turn sections, answer articles, tool rows), so it does not republish that
+ * seat attribute on every row. DOM hiding therefore reaches only the user and
+ * steering bubbles, and every other withdrawn row — the answer, the tool rows,
+ * and the `/rewind` command row itself — stayed on screen. That is the reported
+ * defect: the command is recorded as a rewind row instead of the Reader rolling
+ * back to the state before the message was sent.
+ *
+ * The Reader decides visibility from React state, so it must apply the same
+ * contract itself instead of waiting for a third-party MutationObserver. The
+ * marker node is not admitted as a chat node (only append-origin surface events
+ * become nodes), so the command node's `outcome.sourceEventSeq` — the marker's
+ * log seq — plus the `@<seq>` target in its `args` are the only client-side
+ * signal for the shadowed range. This mirrors the plugin's own reader of that
+ * contract, and is pinned by `tests/rewind-cut.test.ts` so a plugin or host
+ * change cannot silently regress it.
+ *
+ * @module dsh-better-display/rewind-cut
+ */
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function safeSeq(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+}
+/** The command payload of a `command` chat node, when it is structurally readable. */
+function commandOf(node) {
+    if (node.kind !== 'command')
+        return undefined;
+    return asRecord(node.data);
+}
+/**
+ * The engine names an executed rewind command node can carry. The plugin
+ * registers its command as `rewind-plugin` (`ENGINE_COMMANDS = new
+ * Set(['rewind-plugin', 'rewind'])` in dsh-rewind-plugin's
+ * `src/client/hidden.ts`), and that is the name the client projection actually
+ * publishes — the session log's `command/run.name` is not what the Reader sees.
+ * `rewind` stays accepted because older logs and the bili-side proxy record the
+ * shorter spelling.
+ */
+const REWIND_COMMANDS = new Set(['rewind-plugin', 'rewind']);
+/** True when a command payload is the rewind engine command, in either spelling. */
+function isRewindCommand(command) {
+    return typeof command.name === 'string' && REWIND_COMMANDS.has(command.name);
+}
+/**
+ * The render POSITION a row is anchored at: the view node's `anchorSeq`, else
+ * its payload seq.
+ *
+ * This is deliberately NOT integer-only. The host anchors synthetic rows at
+ * fractional offsets off a real seq (`CHAT_SYNTHETIC_SEQ_OFFSETS` in the
+ * official ChatView: `turn-process` at `controlAnchorSeq - 0.1`, `turn-tail` at
+ * `seq + 0.1`, an interrupted assistant step at `seq - 0.9`). An integer-only
+ * read made those rows invisible to the cut, so the last `turn-process` of a
+ * withdrawn turn survived on its own. Log seqs (marker, target) stay integer:
+ * see `safeSeq`.
+ */
+export function anchorSeqOf(node) {
+    const raw = node.anchorSeq ?? asRecord(node.data)?.seq;
+    return typeof raw === 'number' && Number.isFinite(raw) && raw >= 0 ? raw : undefined;
+}
+/**
+ * Extract the rewind target seq from a `/rewind` command's structured `args`
+ * (e.g. `@5 chat`, `preview @5 both`). Locale-independent: it never parses the
+ * host's human outcome copy.
+ */
+export function rewindTargetOfArgs(args) {
+    if (typeof args !== 'string')
+        return undefined;
+    const match = args.match(/@(\d+)/);
+    return match === null ? undefined : Number(match[1]);
+}
+/** True for the internal candidate-list probe (`/rewind __candidates`). */
+function isCandidateCommand(command) {
+    return typeof command.args === 'string' && command.args.includes('__candidates');
+}
+/** True for an impact preview (`/rewind preview @5 both`). */
+function isPreviewCommand(command) {
+    return typeof command.args === 'string' && command.args.includes('preview');
+}
+/**
+ * Merge overlapping or touching shadow ranges.
+ *
+ * Spans are kept SEPARATE unless they genuinely overlap: collapsing every cut
+ * to `[min target, max marker]` would hide a still-on-surface gap of new traffic
+ * between an earlier marker and a later target.
+ */
+export function coalesceCutSpans(spans) {
+    if (spans.length < 2)
+        return [...spans];
+    const sorted = [...spans].sort((left, right) => left.start - right.start || left.end - right.end);
+    const merged = [];
+    for (const span of sorted) {
+        const last = merged.at(-1);
+        if (last !== undefined && span.start <= last.end) {
+            if (span.end > last.end)
+                last.end = span.end;
+            continue;
+        }
+        merged.push({ start: span.start, end: span.end });
+    }
+    return merged;
+}
+/**
+ * True when a row anchored at `seq` falls inside one of the cut spans.
+ *
+ * A cut runs from the target seq through the marker's own log seq, inclusive
+ * (`target <= anchorSeq && anchorSeq <= marker`), the same comparison
+ * `dsh-rewind-plugin`'s `RewindVisibilityBuilder` uses. The upper bound stops
+ * at the marker. Extending it to the next integer hides the following turn's
+ * process row, which the host anchors at `startSeq - 0.1` and therefore in
+ * `[marker, marker + 1)`. Fractional anchors inside the closed range still
+ * match: `anchorSeqOf` keeps them. A process or tail row parked outside the
+ * range is handled by `summaryTurns`, not by widening the cut. Spans stay
+ * disjoint, so new traffic between two rewinds survives.
+ */
+export function cutContains(cuts, seq) {
+    let low = 0;
+    let high = cuts.length - 1;
+    let found = -1;
+    while (low <= high) {
+        const middle = (low + high) >> 1;
+        const cut = cuts[middle];
+        if (cut === undefined)
+            return false;
+        if (seq < cut.start)
+            high = middle - 1;
+        else {
+            found = middle;
+            low = middle + 1;
+        }
+    }
+    const span = found < 0 ? undefined : cuts[found];
+    return span !== undefined && seq <= span.end;
+}
+/** The turn id a node belongs to (absent outside a turn). */
+function turnIdOf(node) {
+    // The location's own `kind` varies (`turn` for a turn's synthetic rows,
+    // `step` for one of its messages); only the turn it carries matters here.
+    const turn = asRecord(asRecord(node.location)?.turn);
+    if (turn === undefined || !Object.hasOwn(turn, 'turn'))
+        return undefined;
+    return turn.turn;
+}
+/**
+ * Node kinds that SUMMARIZE a turn instead of carrying its content, so the host
+ * anchors them at the turn's edges rather than at an event inside it.
+ */
+const TURN_SUMMARY_KINDS = new Set(['turn-process', 'turn-tail']);
+/**
+ * True for a rewind command row the transcript should not keep.
+ *
+ * Probes (`preview`, `__candidates`) exist only to feed the popover. An
+ * executed rewind — success plus a marker seq — is the command that performed
+ * the cut, and the plugin hides that row even when its anchor sits outside
+ * the numeric range. A failed or still-running command stays visible.
+ */
+function commandHidden(node) {
+    const command = commandOf(node);
+    if (command === undefined || !isRewindCommand(command))
+        return false;
+    if (isPreviewCommand(command) || isCandidateCommand(command))
+        return true;
+    const outcome = asRecord(command.outcome);
+    return outcome?.kind === 'success' && safeSeq(outcome.sourceEventSeq) !== undefined;
+}
+/** True when the row's own anchor falls in a cut, or the row is a rewind command to hide. */
+function anchorWithdrawn(node, cuts) {
+    if (commandHidden(node))
+        return true;
+    const seq = anchorSeqOf(node);
+    return seq !== undefined && cutContains(cuts, seq);
+}
+/**
+ * Turns whose process and tail rows must leave.
+ *
+ * The host opens a turn before its user message is logged and anchors
+ * `turn-process` at `controlAnchorSeq - 0.1`, below the first withdrawn
+ * event, and `turn-tail` at `turn.end.seq + 0.1`, which can sit past the
+ * marker. Containment therefore misses those two rows, and the transcript
+ * kept announcing `执行过程 / 本轮已停止，已生成的内容仍保留。`
+ *
+ * A summary leaves only when every content row of its turn is already
+ * withdrawn — the same rule as the plugin's `deriveTurnProcess`. One content
+ * row before the target (a mid-turn steering rewind) keeps the summary and
+ * that earlier message. A turn with no content rows is left alone.
+ */
+function summaryTurns(chat, cuts) {
+    const stays = new Map();
+    for (const key of chat.order) {
+        const node = chat.nodes.get(key);
+        if (node === undefined || TURN_SUMMARY_KINDS.has(node.kind ?? ''))
+            continue;
+        const id = turnIdOf(node);
+        if (id === undefined)
+            continue;
+        const visible = node.visibility !== 'hidden' && !anchorWithdrawn(node, cuts);
+        stays.set(id, (stays.get(id) ?? false) || visible);
+    }
+    const withdrawn = new Set();
+    for (const [id, visible] of stays)
+        if (!visible)
+            withdrawn.add(id);
+    return withdrawn;
+}
+/** True when this row is a summary of a turn whose content is fully withdrawn. */
+function summaryWithdrawn(node, summaries) {
+    if (!TURN_SUMMARY_KINDS.has(node.kind ?? ''))
+        return false;
+    const id = turnIdOf(node);
+    return id !== undefined && summaries.has(id);
+}
+/**
+ * The shadow ranges a session's executed rewinds produced, newest state last.
+ * An executed rewind cuts `[target, marker]` — the target itself is included,
+ * because a rewind restores the state *before* that message was sent (its text
+ * goes back to the composer).
+ */
+export function rewindCutSpans(chat) {
+    if (chat === undefined)
+        return [];
+    const spans = [];
+    for (const key of chat.order) {
+        const node = chat.nodes.get(key);
+        if (node === undefined)
+            continue;
+        const command = commandOf(node);
+        if (command === undefined || !isRewindCommand(command))
+            continue;
+        // Probes never open a span, even when a later host stamps them with a
+        // success marker. Matching them would roll the transcript back on preview.
+        if (isPreviewCommand(command) || isCandidateCommand(command))
+            continue;
+        const outcome = asRecord(command.outcome);
+        if (outcome?.kind !== 'success')
+            continue;
+        const marker = safeSeq(outcome.sourceEventSeq);
+        if (marker === undefined)
+            continue;
+        const target = rewindTargetOfArgs(command.args);
+        if (target === undefined || target > marker)
+            continue;
+        spans.push({ start: target, end: marker });
+    }
+    return coalesceCutSpans(spans);
+}
+/**
+ * The anchor seqs the Reader must not render: every withdrawn message (the
+ * target, everything after it, and the unrendered marker), plus every `/rewind`
+ * row that exists only to feed the popover — the candidate-list probe and each
+ * impact preview. A SUCCESSFUL executed command row is covered by its own cut;
+ * a failed or unsettled one stays visible as an ordinary command record.
+ */
+export function hiddenRewindSeqs(chat) {
+    const hidden = new Set();
+    if (chat === undefined)
+        return hidden;
+    const cuts = rewindCutSpans(chat);
+    const summaries = summaryTurns(chat, cuts);
+    for (const key of chat.order) {
+        const node = chat.nodes.get(key);
+        if (node === undefined)
+            continue;
+        if (!anchorWithdrawn(node, cuts) && !summaryWithdrawn(node, summaries))
+            continue;
+        const seq = anchorSeqOf(node);
+        if (seq !== undefined)
+            hidden.add(seq);
+    }
+    return hidden;
+}
+/**
+ * The chat keys the Reader should render, in snapshot order: withdrawn rows and
+ * rows the host itself marked hidden are dropped, everything else keeps its
+ * position. Returns the snapshot's own `order` array when nothing is filtered,
+ * so React selectors see a stable reference.
+ */
+export function visibleChatKeys(chat) {
+    const cuts = rewindCutSpans(chat);
+    const summaries = summaryTurns(chat, cuts);
+    const visible = [];
+    for (const key of chat.order) {
+        const node = chat.nodes.get(key);
+        if (node === undefined)
+            continue;
+        if (node.visibility === 'hidden')
+            continue;
+        if (anchorWithdrawn(node, cuts) || summaryWithdrawn(node, summaries))
+            continue;
+        visible.push(key);
+    }
+    return visible.length === chat.order.length ? chat.order : visible;
+}
+/**
+ * A comparable signal for the visible row set, built for
+ * `useSyncExternalStore`-style subscription: the host re-runs a chat selector
+ * on every publish and compares the RESULT by `Object.is`, and a rewind
+ * publishes an in-place upsert of an existing command row. The snapshot's
+ * `order` array and node store are therefore both reference-stable across a
+ * rewind, so a selector on them never re-renders; a string does change exactly
+ * when the visible set does. Never return the array itself from a selector —
+ * a fresh array fails the `Object.is` check on every publish.
+ */
+export function visibleChatSignature(chat) {
+    return visibleChatKeys(chat).join('\u0000');
+}
+//# sourceMappingURL=rewind-cut.js.map

package/lib/types/client/rewind-cut.js.map

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

package/lib/types/client/styles.d.ts

@@ -0,0 +1,3 @@
+/** Retain injected CSS across host cleanup and restore it before Reader paints. */
+export declare function ensureStyles(): void;
+//# sourceMappingURL=styles.d.ts.map

package/lib/types/client/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/client/styles.ts"],"names":[],"mappings":"AAGA,mFAAmF;AACnF,wBAAgB,YAAY,IAAI,IAAI,CAiBnC"}

package/lib/types/client/styles.js

@@ -0,0 +1,25 @@
+const plugin = 'dsh-better-display';
+const styles = new Map();
+/** Retain injected CSS across host cleanup and restore it before Reader paints. */
+export function ensureStyles() {
+    if (typeof document === 'undefined')
+        return;
+    const live = new Set();
+    for (const tag of document.querySelectorAll(`style[data-plugin="${plugin}"][data-plugin-css]`)) {
+        const id = tag.dataset.pluginCss;
+        if (id === undefined)
+            continue;
+        styles.set(id, tag.textContent ?? '');
+        live.add(id);
+    }
+    for (const [id, text] of styles) {
+        if (live.has(id))
+            continue;
+        const tag = document.createElement('style');
+        tag.dataset.plugin = plugin;
+        tag.dataset.pluginCss = id;
+        tag.textContent = text;
+        document.head.appendChild(tag);
+    }
+}
+//# sourceMappingURL=styles.js.map

package/lib/types/client/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../../src/client/styles.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,oBAAoB,CAAC;AACpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEzC,mFAAmF;AACnF,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,gBAAgB,CAAmB,sBAAsB,MAAM,qBAAqB,CAAC,EAAE,CAAC;QACjH,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;QACjC,IAAI,EAAE,KAAK,SAAS;YAAE,SAAS;QAC/B,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IACD,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5C,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAC5B,GAAG,CAAC,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC;QAC3B,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/lib/types/client/text-transform.d.ts

@@ -0,0 +1,93 @@
+import type { ReaderBlockOwner, ReaderBlockPresentation } from './types.js';
+/**
+ * Cordis service name. Another client plugin lists this in `inject` and
+ * registers a transformer. The reading view paints the result. The session
+ * block, transcript, and fold inputs stay on the original text.
+ */
+export declare const TEXT_TRANSFORM_SERVICE = "dsh-better-display.text-transform";
+export type DisplayTextKind = 'reasoning' | 'body';
+export interface DisplayTextRequest {
+    /** Original block text. Registrants must not write it back onto the block. */
+    text: string;
+    streaming: boolean;
+    /** Opaque id of this mounted block. Stable until the block unmounts. */
+    blockKey: string;
+    kind: DisplayTextKind;
+    /** Assistant body and reasoning are the usual targets. Tool prose uses `tool`. */
+    source?: ReaderBlockOwner['source'];
+}
+export interface DisplayText {
+    text: string;
+    /**
+     * True when this string is the settled display for the current source.
+     * False keeps the live reveal open, including after the model has stopped
+     * but a translation batch is still outstanding.
+     */
+    final: boolean;
+}
+/**
+ * Sync `read` on every paint, plus `subscribe` when a later batch changes
+ * what `read` returns. `subscribe` may be called once per kind and must
+ * accept more than one listener.
+ */
+export interface DisplayTextTransformer {
+    read(request: DisplayTextRequest): DisplayText | string | undefined;
+    subscribe?(listener: () => void): () => void;
+}
+export interface DisplayCursor extends DisplayText {
+    /**
+     * Increments when the displayed string or its `final` bit changes.
+     * This is not the reveal clock. Passing it to the word timeline as the
+     * motion revision replays or snaps the paragraph.
+     */
+    transformRevision: number;
+    /**
+     * Reveal identity. Stays put when the new string extends the previous
+     * display string, so an appended translation batch continues the fade.
+     * Increments only when the string is replaced, which settles the new
+     * text instead of typing it again from the first grapheme.
+     */
+    motionRevision: number;
+}
+export interface TextTransformRegistry {
+    register(kind: DisplayTextKind | readonly DisplayTextKind[], transformer: DisplayTextTransformer): () => void;
+    has(kind: DisplayTextKind): boolean;
+    read(request: DisplayTextRequest): DisplayCursor;
+    subscribe(kind: DisplayTextKind, listener: () => void): () => void;
+    release(kind: DisplayTextKind, blockKey: string): void;
+}
+/**
+ * Appends keep the motion revision. A replacement gets a new one so the
+ * timeline treats the swapped string as already settled.
+ */
+export declare function nextDisplayCursor(previous: DisplayCursor | undefined, display: DisplayText): DisplayCursor;
+/**
+ * Streaming flag fed to the reveal. With no transformer this is the model's
+ * flag. A transformer that reports `final: !streaming` produces the same flag.
+ */
+export declare function displayStreaming(sourceStreaming: boolean, shown: Pick<DisplayCursor, 'final'>, active: boolean): boolean;
+/** No registry, or none for this kind: the source string, and no cursor write. */
+export declare function readDisplayText(registry: TextTransformRegistry | undefined, request: DisplayTextRequest): DisplayCursor;
+export declare function createTextTransformRegistry(): TextTransformRegistry;
+/** Points the reading view at the registry this client plugin provides. */
+export declare function installTextTransformRegistry(registry: TextTransformRegistry | undefined): () => void;
+export declare function activeTextTransform(): TextTransformRegistry | undefined;
+/**
+ * Subscribe while mounted. The reveal components call this only after
+ * `has(kind)`, so an empty registry adds no hook and no listener.
+ */
+export declare function useDisplayText(registry: TextTransformRegistry, request: DisplayTextRequest): DisplayCursor;
+/** Chain-slot owner. Extra fields are optional so older callers still type-check. */
+export declare function readerBlockOwner(block: ReaderBlockOwner['block'], streaming: boolean, source: ReaderBlockOwner['source'], presentation: ReaderBlockPresentation, holdFormatting: boolean): ReaderBlockOwner;
+/** Copy actions read this. Display text never replaces it. */
+export declare function originalAnswerText(blocks: readonly {
+    readonly kind: string;
+    readonly text?: string;
+}[]): string;
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** Display-only reader text transforms. Present after this client plugin applies. */
+        'dsh-better-display.text-transform'?: TextTransformRegistry;
+    }
+}
+//# sourceMappingURL=text-transform.d.ts.map

package/lib/types/client/text-transform.d.ts.map

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

package/lib/types/client/text-transform.js

@@ -0,0 +1,183 @@
+import { useEffect, useMemo, useState } from 'react';
+/**
+ * Cordis service name. Another client plugin lists this in `inject` and
+ * registers a transformer. The reading view paints the result. The session
+ * block, transcript, and fold inputs stay on the original text.
+ */
+export const TEXT_TRANSFORM_SERVICE = 'dsh-better-display.text-transform';
+const KINDS = new Set(['reasoning', 'body']);
+function isKind(value) {
+    return KINDS.has(value);
+}
+function reportTransformError(error) {
+    console.warn('[dsh-better-display] text transform failed; showing original text', error);
+}
+function passthrough(request) {
+    return { text: request.text, final: !request.streaming, transformRevision: 0, motionRevision: 0 };
+}
+function normalize(value, request) {
+    if (typeof value === 'string')
+        return { text: value, final: !request.streaming };
+    if (!value || typeof value.text !== 'string')
+        return { text: request.text, final: !request.streaming };
+    return { text: value.text, final: typeof value.final === 'boolean' ? value.final : !request.streaming };
+}
+/**
+ * Appends keep the motion revision. A replacement gets a new one so the
+ * timeline treats the swapped string as already settled.
+ */
+export function nextDisplayCursor(previous, display) {
+    if (!previous)
+        return { ...display, transformRevision: 0, motionRevision: 0 };
+    if (previous.text === display.text && previous.final === display.final)
+        return previous;
+    const appended = display.text.startsWith(previous.text);
+    return {
+        text: display.text,
+        final: display.final,
+        transformRevision: previous.transformRevision + 1,
+        motionRevision: appended ? previous.motionRevision : previous.motionRevision + 1,
+    };
+}
+/**
+ * Streaming flag fed to the reveal. With no transformer this is the model's
+ * flag. A transformer that reports `final: !streaming` produces the same flag.
+ */
+export function displayStreaming(sourceStreaming, shown, active) {
+    return active ? !shown.final : sourceStreaming;
+}
+/** No registry, or none for this kind: the source string, and no cursor write. */
+export function readDisplayText(registry, request) {
+    if (!registry?.has(request.kind))
+        return passthrough(request);
+    return registry.read(request);
+}
+class TextTransformRegistryImpl {
+    stacks = new Map();
+    listeners = new Map();
+    cursors = new Map();
+    register(kind, transformer) {
+        const requested = [...new Set(Array.isArray(kind) ? kind : [kind])];
+        for (const item of requested) {
+            if (!isKind(item))
+                throw new Error(`Unknown display text kind: ${String(item)}`);
+        }
+        const bound = [];
+        for (const item of requested) {
+            const entry = { transformer };
+            try {
+                entry.unsubscribe = transformer.subscribe?.(() => { this.emit(item); });
+            }
+            catch (error) {
+                reportTransformError(error);
+            }
+            const stack = this.stacks.get(item) ?? [];
+            stack.push(entry);
+            this.stacks.set(item, stack);
+            bound.push({ kind: item, entry });
+            this.emit(item);
+        }
+        return () => {
+            for (const { kind: item, entry } of bound) {
+                try {
+                    entry.unsubscribe?.();
+                }
+                catch (error) {
+                    reportTransformError(error);
+                }
+                const stack = this.stacks.get(item);
+                if (!stack)
+                    continue;
+                const next = stack.filter(candidate => candidate !== entry);
+                if (next.length > 0)
+                    this.stacks.set(item, next);
+                else
+                    this.stacks.delete(item);
+                this.emit(item);
+            }
+        };
+    }
+    has(kind) {
+        return (this.stacks.get(kind)?.length ?? 0) > 0;
+    }
+    read(request) {
+        const transformer = this.stacks.get(request.kind)?.at(-1)?.transformer;
+        if (!transformer)
+            return passthrough(request);
+        let display;
+        try {
+            display = normalize(transformer.read(request), request);
+        }
+        catch (error) {
+            // A broken transformer must never hide the original text. Show it and
+            // ask again on the next text change or notify, so a recovered
+            // transformer takes over without a remount.
+            reportTransformError(error);
+            display = { text: request.text, final: !request.streaming };
+        }
+        const key = `${request.kind}\u0000${request.blockKey}`;
+        const next = nextDisplayCursor(this.cursors.get(key), display);
+        this.cursors.set(key, next);
+        return next;
+    }
+    subscribe(kind, listener) {
+        const set = this.listeners.get(kind) ?? new Set();
+        set.add(listener);
+        this.listeners.set(kind, set);
+        return () => { set.delete(listener); };
+    }
+    release(kind, blockKey) {
+        this.cursors.delete(`${kind}\u0000${blockKey}`);
+    }
+    emit(kind) {
+        const set = this.listeners.get(kind);
+        if (!set)
+            return;
+        for (const listener of [...set])
+            listener();
+    }
+}
+export function createTextTransformRegistry() {
+    return new TextTransformRegistryImpl();
+}
+let active;
+/** Points the reading view at the registry this client plugin provides. */
+export function installTextTransformRegistry(registry) {
+    const previous = active;
+    active = registry;
+    return () => { active = previous; };
+}
+export function activeTextTransform() {
+    return active;
+}
+/**
+ * Subscribe while mounted. The reveal components call this only after
+ * `has(kind)`, so an empty registry adds no hook and no listener.
+ */
+export function useDisplayText(registry, request) {
+    const [epoch, setEpoch] = useState(0);
+    const { text, streaming, blockKey, kind, source } = request;
+    useEffect(() => registry.subscribe(kind, () => { setEpoch(value => value + 1); }), [registry, kind]);
+    useEffect(() => () => { registry.release(kind, blockKey); }, [registry, kind, blockKey]);
+    return useMemo(() => registry.read({ text, streaming, blockKey, kind, source }), [registry, text, streaming, blockKey, kind, source, epoch]);
+}
+/** Chain-slot owner. Extra fields are optional so older callers still type-check. */
+export function readerBlockOwner(block, streaming, source, presentation, holdFormatting) {
+    return {
+        block,
+        streaming,
+        source,
+        presentation: {
+            startedAt: presentation.startedAt,
+            interrupted: presentation.interrupted,
+            liveText: presentation.liveText,
+        },
+        holdFormatting,
+        liveText: presentation.liveText,
+    };
+}
+/** Copy actions read this. Display text never replaces it. */
+export function originalAnswerText(blocks) {
+    return blocks.flatMap(block => block.kind === 'text' && typeof block.text === 'string' ? [block.text] : []).join('\n\n');
+}
+//# sourceMappingURL=text-transform.js.map