@sigrun/tui 0.1.1 → 0.2.0

package/dist/blocks/surface.js

@@ -1,468 +0,0 @@
-/**
- * SurfaceState (UI-blocks U2 Task 4, spec §6.3): the confirmed-data plus
- * optimistic-overlay model every TUI surface renders through — the TUI
- * port of U1's `useSurface.ts`, with EXACTLY the same overlay rules:
- *
- * - **Confirmed data** changes ONLY from server data or ops (load,
- *   fetch, accepted actions carrying ops).
- * - **The overlay** is a list of pending moves `{actionId, payload,
- *   target, untilRev?}`, keyed by `actionId`; the rendered `view` is
- *   confirmed data with the overlay applied on top.
- * - `{ok: true, rev, ops}` → apply the ops to confirmed, drop the entry.
- * - `{ok: true, rev}` (no ops) → keep the entry with `untilRev = rev`
- *   until a fetch at ≥ that rev arrives, then drop it — the item stays
- *   where the user dropped it with no snap-back flicker.
- * - `{ok: false}` or the 10 s timeout → drop the entry and surface a
- *   NOTICE. U1 toasts; the TUI's notice is a line the app flashes in
- *   the status bar — `SurfaceState` collects `notices` and the host
- *   drains them through `consumeNotices` (the status-bar wiring is the
- *   app's seam, Task 6's surface host).
- * - A `rev` gap (ops land behind the announced rev) or a `DataOpError`
- *   applying ops → a full refetch.
- * - `access: "none"` → the not-found state (§6.5); a `treeRev` change
- *   → a full reload.
- *
- * The overlay locates a move in the data by scanning the loaded tree
- * for the collection whose `onMove` handler name matches the action —
- * identical to U1 (a move against an unknown handler still goes to the
- * transport, unoverlaid).
- */
-import { DataOpError, applyOps, resolvePointer } from "@sigrun/shared/blocks";
-/** An action has 10 s to answer before it counts as a reject (§6.3). */
-export const ACT_TIMEOUT_MS = 10_000;
-/** The notice cap: pending notices drop oldest-first past 50 (a flood
- *  of failures must not grow the list without bound; the host drains
- *  them through `consumeNotices`). */
-export const NOTICE_CAP = 50;
-/** Recursive block search (children/main/sidebar/detail, plus the
- *  columns/grid `{block}` wrapper). */
-function findCollection(block, name) {
-    if (typeof block !== "object" || block === null || Array.isArray(block)) {
-        return undefined;
-    }
-    const record = block;
-    if (record.type === "collection") {
-        const collection = block;
-        if (collection.onMove === name)
-            return collection;
-    }
-    for (const key of ["children", "main", "sidebar", "detail"]) {
-        const nested = record[key];
-        if (Array.isArray(nested)) {
-            for (const child of nested) {
-                const wrapped = typeof child === "object" && child !== null && !Array.isArray(child)
-                    ? child.block
-                    : undefined;
-                const hit = findCollection(child, name) ?? findCollection(wrapped, name);
-                if (hit !== undefined)
-                    return hit;
-            }
-        }
-    }
-    return undefined;
-}
-/** The move target for a handler name (undefined when no collection
- *  declares it — the action still goes to the transport, unoverlaid). */
-function findMoveTarget(tree, name) {
-    if (tree === undefined)
-        return undefined;
-    const found = findCollection(tree.root, name);
-    if (found === undefined)
-        return undefined;
-    if (typeof found.items.$ !== "string")
-        return undefined;
-    return {
-        itemsPath: found.items.$,
-        groupBy: found.groupBy,
-        timeStart: found.time?.start,
-        timeEnd: found.time?.end,
-    };
-}
-/** Read a move endpoint from a payload value. */
-function spot(value) {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return undefined;
-    }
-    const record = value;
-    return {
-        group: typeof record.group === "string" ? record.group : undefined,
-        index: typeof record.index === "number" ? record.index : undefined,
-        start: typeof record.start === "string" ? record.start : undefined,
-        end: typeof record.end === "string" ? record.end : undefined,
-    };
-}
-/** Write the items array back at its pointer, immutably along the path. */
-function writeItems(data, itemsPath, items) {
-    const tokens = itemsPath
-        .replace(/^\//, "")
-        .split("/")
-        .map((token) => token.replaceAll("~1", "/").replaceAll("~0", "~"));
-    if (tokens.length === 0)
-        return data;
-    const rebuild = (node, depth) => {
-        if (depth === tokens.length)
-            return [...items];
-        if (Array.isArray(node)) {
-            const index = Number(tokens[depth]);
-            const copy = [...node];
-            copy[index] = rebuild(copy[index], depth + 1);
-            return copy;
-        }
-        if (typeof node === "object" && node !== null) {
-            const record = node;
-            const key = tokens[depth];
-            return { ...record, [key]: rebuild(record[key], depth + 1) };
-        }
-        return node;
-    };
-    return rebuild(data, 0);
-}
-/** Apply one overlay entry to `data` (unknown shapes leave the data
- *  untouched so a stale entry never corrupts the render). */
-function applyMoveOverlay(data, entry) {
-    const target = entry.target;
-    if (target === undefined)
-        return data;
-    const payload = entry.payload;
-    const itemId = typeof payload.itemId === "string" ? payload.itemId : undefined;
-    const to = spot(payload.to);
-    if (itemId === undefined || to === undefined)
-        return data;
-    const items = resolvePointer(data, target.itemsPath);
-    if (!Array.isArray(items))
-        return data;
-    const fromIndex = items.findIndex((item) => typeof item === "object" &&
-        item !== null &&
-        !Array.isArray(item) &&
-        item.id === itemId);
-    if (fromIndex < 0)
-        return data;
-    const item = items[fromIndex];
-    const next = [...items];
-    next.splice(fromIndex, 1);
-    // A time move (calendar): set start/end, keep the item's position.
-    if (to.start !== undefined && target.timeStart !== undefined) {
-        const moved = { ...item, [target.timeStart]: to.start };
-        if (to.end !== undefined && target.timeEnd !== undefined) {
-            moved[target.timeEnd] = to.end;
-        }
-        next.splice(fromIndex, 0, moved);
-        return writeItems(data, target.itemsPath, next);
-    }
-    // A group/index move (lanes, list reorder).
-    if (to.group === undefined || to.index === undefined)
-        return data;
-    const moved = target.groupBy === undefined ? item : { ...item, [target.groupBy]: to.group };
-    const lanePositions = next
-        .map((entry, index) => ({ entry, index }))
-        .filter(({ entry }) => target.groupBy !== undefined &&
-        typeof entry === "object" &&
-        entry !== null &&
-        !Array.isArray(entry) &&
-        entry[target.groupBy] === to.group)
-        .map(({ index }) => index);
-    const at = to.index < lanePositions.length ? lanePositions[to.index] ?? next.length : next.length;
-    next.splice(at, 0, moved);
-    return writeItems(data, target.itemsPath, next);
-}
-/** The surface state container (class shape — the TUI has no hook layer). */
-export class SurfaceState {
-    #transport;
-    #status = "loading";
-    #tree;
-    #confirmed = {};
-    #rev = 0;
-    #treeRev = 0;
-    #access = "read";
-    #overlay = [];
-    #notices = [];
-    /** Server-side field errors from the latest rejected action
-     *  (`{error: {field}}`, spec §5.6), keyed by field name; a success
-     *  clears them. */
-    #serverErrors = {};
-    /** The channel-owned `/view/` branch (spec §6.2): live forms bound
-     *  under `/view/` write it through {@link SurfaceState.setView}; it
-     *  never reaches the transport. */
-    #viewBranch = {};
-    #actionSeq = 0;
-    /** The highest rev a change event announced (gap detect). */
-    #announcedRev = 0;
-    #timers = new Map();
-    #listeners = new Set();
-    #unsubscribe;
-    constructor(transport) {
-        this.#transport = transport;
-    }
-    /** The current snapshot: confirmed data with the overlay applied. */
-    get view() {
-        let data = this.#confirmed;
-        for (const entry of this.#overlay) {
-            data = applyMoveOverlay(data, entry);
-        }
-        return {
-            status: this.#status,
-            tree: this.#tree,
-            data,
-            rev: this.#rev,
-            treeRev: this.#treeRev,
-            access: this.#access,
-            notices: this.#notices,
-        };
-    }
-    /** Subscribe to state changes (returns the unsubscribe). */
-    onChange(cb) {
-        this.#listeners.add(cb);
-        return () => {
-            this.#listeners.delete(cb);
-        };
-    }
-    #emit() {
-        for (const listener of [...this.#listeners])
-            listener();
-    }
-    #notice(message) {
-        this.#notices = [...this.#notices, message].slice(-NOTICE_CAP);
-        this.#emit();
-    }
-    /** Drain the pending notices (the host flashes them in the status bar). */
-    consumeNotices() {
-        const drained = this.#notices;
-        this.#notices = [];
-        return drained;
-    }
-    /** The channel-owned `/view/` branch (spec §6.2) — a BlockCtx's
-     *  `view.values` reads this object. */
-    get viewValues() {
-        return this.#viewBranch;
-    }
-    /** The server field errors from the latest rejected action. */
-    get serverErrors() {
-        return this.#serverErrors;
-    }
-    /** Write a pointer under the `/view/` branch (the form's live
-     *  `/view/`-bound flush lands here; the write never dispatches). */
-    setView(path, value) {
-        const tokens = path
-            .replace(/^\/+/, "")
-            .split("/")
-            .filter((token) => token !== "")
-            .map((token) => token.replaceAll("~1", "/").replaceAll("~0", "~"));
-        const write = (node, depth) => {
-            if (depth >= tokens.length) {
-                return typeof value === "object" && value !== null && !Array.isArray(value)
-                    ? { ...value }
-                    : node;
-            }
-            const key = tokens[depth];
-            if (depth === tokens.length - 1)
-                return { ...node, [key]: value };
-            const child = node[key];
-            const childObject = typeof child === "object" && child !== null && !Array.isArray(child)
-                ? child
-                : {};
-            return { ...node, [key]: write(childObject, depth + 1) };
-        };
-        if (tokens.length === 0) {
-            if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-                this.#viewBranch = { ...value };
-            }
-        }
-        else {
-            this.#viewBranch = write(this.#viewBranch, 0);
-        }
-        this.#emit();
-    }
-    /** Reload after an error (SurfaceView's `r` key). */
-    async retry() {
-        this.#status = "loading";
-        this.#emit();
-        await this.#doLoad();
-    }
-    /** Load the tree and initial data; subscribe to change events. */
-    async load() {
-        await this.#doLoad();
-        if (this.#unsubscribe === undefined) {
-            this.#unsubscribe = this.#transport.onChanged((event) => {
-                this.#announcedRev = Math.max(this.#announcedRev, event.rev);
-                if (event.treeRev !== this.#treeRev) {
-                    void this.#doLoad();
-                    return;
-                }
-                void (async () => {
-                    try {
-                        this.#applyFetch(await this.#transport.fetchData(this.#rev));
-                    }
-                    catch {
-                        // Keep confirmed; the next event retries (§7.3).
-                    }
-                })();
-            });
-        }
-    }
-    /** Stop listening and cancel every pending action timer. */
-    dispose() {
-        this.#unsubscribe?.();
-        this.#unsubscribe = undefined;
-        for (const timer of this.#timers.values())
-            clearTimeout(timer);
-        this.#timers.clear();
-    }
-    async #doLoad() {
-        try {
-            const result = await this.#transport.load();
-            if (result.access === "none") {
-                this.#status = "notFound";
-                this.#access = "none";
-                this.#emit();
-                return;
-            }
-            this.#announcedRev = result.rev;
-            this.#status = "ready";
-            this.#tree = result.tree;
-            this.#confirmed = result.data;
-            this.#rev = result.rev;
-            this.#treeRev = result.treeRev;
-            this.#access = result.access;
-            this.#overlay = [];
-            this.#emit();
-        }
-        catch {
-            this.#status = "error";
-            this.#emit();
-        }
-    }
-    #dropEntry(actionId) {
-        const timer = this.#timers.get(actionId);
-        if (timer !== undefined) {
-            clearTimeout(timer);
-            this.#timers.delete(actionId);
-        }
-        this.#overlay = this.#overlay.filter((entry) => entry.actionId !== actionId);
-        this.#emit();
-    }
-    #applyFetch(result) {
-        if (result.treeRev !== this.#treeRev) {
-            void this.#doLoad();
-            return;
-        }
-        if (result.data !== undefined) {
-            this.#confirmed = result.data;
-            this.#rev = result.rev;
-            this.#overlay = this.#overlay.filter((entry) => entry.untilRev === undefined || result.rev < entry.untilRev);
-            this.#emit();
-            return;
-        }
-        if (result.ops !== undefined) {
-            // Gap: the ops land behind the rev the event announced.
-            if (result.rev < this.#announcedRev) {
-                void this.#fullRefetch();
-                return;
-            }
-            try {
-                this.#confirmed = applyOps(this.#confirmed, result.ops);
-            }
-            catch (error) {
-                if (error instanceof DataOpError) {
-                    void this.#fullRefetch();
-                    return;
-                }
-                throw error;
-            }
-            this.#rev = result.rev;
-            this.#overlay = this.#overlay.filter((entry) => entry.untilRev === undefined || result.rev < entry.untilRev);
-            this.#emit();
-        }
-    }
-    async #fullRefetch() {
-        try {
-            this.#applyFetch(await this.#transport.fetchData());
-        }
-        catch {
-            // A failed refetch keeps the last confirmed data; the next
-            // event or keepalive retries (§7.3).
-        }
-    }
-    /** Dispatch an action to the surface; a move joins the overlay first. */
-    dispatch(action, payload) {
-        const payloadObject = typeof payload === "object" && payload !== null && !Array.isArray(payload)
-            ? payload
-            : {};
-        const actionId = `act-${(this.#actionSeq += 1)}`;
-        const name = "name" in action ? action.name : action.type;
-        const isMove = action.type === "move";
-        if (isMove) {
-            const target = findMoveTarget(this.#tree, name);
-            this.#overlay = [...this.#overlay, { actionId, payload: payloadObject, target }];
-            this.#timers.set(actionId, setTimeout(() => {
-                this.#dropEntry(actionId);
-                this.#notice("The action timed out");
-            }, ACT_TIMEOUT_MS));
-            this.#emit();
-        }
-        void this.#transport
-            .act({ action: name, payload, actionId })
-            .then((result) => {
-            // A move whose entry is already gone (the 10 s timeout fired)
-            // is STALE: no ops, no notice — the user already saw it fail.
-            if (isMove &&
-                !this.#overlay.some((entry) => entry.actionId === actionId)) {
-                return;
-            }
-            if (!result.ok) {
-                if (isMove)
-                    this.#dropEntry(actionId);
-                // A rejected action's `{error: {field}}` surfaces under
-                // that field (spec §5.6); an unfielded rejection clears
-                // any previous field error.
-                this.#serverErrors =
-                    result.error.field === undefined
-                        ? {}
-                        : { [result.error.field]: result.error.message };
-                this.#notice(result.error.message);
-                return;
-            }
-            this.#serverErrors = {};
-            if (result.toast !== undefined)
-                this.#notice(result.toast);
-            if (!isMove)
-                return;
-            if (result.ops !== undefined) {
-                try {
-                    this.#confirmed = applyOps(this.#confirmed, result.ops);
-                }
-                catch (error) {
-                    if (error instanceof DataOpError) {
-                        void this.#fullRefetch();
-                        return;
-                    }
-                    throw error;
-                }
-                this.#rev = result.rev;
-                const timer = this.#timers.get(actionId);
-                if (timer !== undefined) {
-                    clearTimeout(timer);
-                    this.#timers.delete(actionId);
-                }
-                this.#overlay = this.#overlay.filter((entry) => entry.actionId !== actionId);
-                this.#emit();
-            }
-            else {
-                // Accept without ops: hold the entry until confirmed reaches
-                // the accepted rev (no snap-back flicker, §6.3).
-                const timer = this.#timers.get(actionId);
-                if (timer !== undefined) {
-                    clearTimeout(timer);
-                    this.#timers.delete(actionId);
-                }
-                this.#rev = Math.max(this.#rev, result.rev);
-                this.#overlay = this.#overlay.map((entry) => entry.actionId === actionId ? { ...entry, untilRev: result.rev } : entry);
-                this.#emit();
-            }
-        })
-            .catch(() => {
-            if (isMove)
-                this.#dropEntry(actionId);
-            this.#notice("The action failed");
-        });
-    }
-}

package/dist/blocks/tones.d.ts

@@ -1,23 +0,0 @@
-/**
- * Tone → terminal styling (UI-blocks spec §10.1): extensions set
- * MEANING (`neutral | accent | good | warn | bad | info`); this module
- * is the one place a tone becomes visual treatment, mapped through
- * {@link TuiTheme} tokens only — never raw SGR in block code.
- *
- * The TUI's tone treatment is a left marker column plus colour: the
- * marker makes tone legible without colour (NO_COLOR, Review Focus 5)
- * and doubles as the accent stripe `card.tone` calls for. On a
- * terminal that cannot render Unicode (`ctx.unicode === false`) the
- * markers take their ASCII forms (§10.2) so tone stays legible there
- * too.
- */
-import type { Tone } from "@sigrun/shared/blocks";
-import type { TuiTheme } from "../theme.js";
-/** Style `text` in the tone's colour. */
-export declare function toneFg(theme: TuiTheme, tone: Tone): (s: string) => string;
-/**
- * The tone's one-character marker (shown in addition to colour);
- * `ascii` selects the no-Unicode form (§10.2 — callers pass
- * `!ctx.unicode`).
- */
-export declare function toneMarker(tone: Tone, ascii: boolean): string;

package/dist/blocks/tones.js

@@ -1,63 +0,0 @@
-/**
- * Tone → terminal styling (UI-blocks spec §10.1): extensions set
- * MEANING (`neutral | accent | good | warn | bad | info`); this module
- * is the one place a tone becomes visual treatment, mapped through
- * {@link TuiTheme} tokens only — never raw SGR in block code.
- *
- * The TUI's tone treatment is a left marker column plus colour: the
- * marker makes tone legible without colour (NO_COLOR, Review Focus 5)
- * and doubles as the accent stripe `card.tone` calls for. On a
- * terminal that cannot render Unicode (`ctx.unicode === false`) the
- * markers take their ASCII forms (§10.2) so tone stays legible there
- * too.
- */
-/**
- * The palette token each tone paints with (the TUI's tone table,
- * twin of the webui's `TONE_VARS`: `info` is a quiet emphasis, not a
- * state colour, so it maps to `muted` exactly as the webui maps it to
- * `--muted`).
- */
-const TONE_TOKEN = {
-    neutral: "text",
-    accent: "accent",
-    good: "ok",
-    warn: "warn",
-    bad: "bad",
-    info: "muted",
-};
-/** The colourless marker: tone legible with NO_COLOR set (Focus 5). */
-const TONE_MARKER = {
-    neutral: "•",
-    accent: "◆",
-    good: "✓",
-    warn: "▲",
-    bad: "!",
-    info: "·",
-};
-/**
- * The marker on a no-Unicode terminal (§10.2's ASCII path): the same
- * shapes in printable ASCII — `good` is `v`, matching `icons.ts`'s
- * `check` fallback, so a tone and its icon degrade alike. `bad` is
- * already ASCII.
- */
-const TONE_MARKER_ASCII = {
-    neutral: "-",
-    accent: "*",
-    good: "v",
-    warn: "^",
-    bad: "!",
-    info: ".",
-};
-/** Style `text` in the tone's colour. */
-export function toneFg(theme, tone) {
-    return theme.fg(TONE_TOKEN[tone] ?? "text");
-}
-/**
- * The tone's one-character marker (shown in addition to colour);
- * `ascii` selects the no-Unicode form (§10.2 — callers pass
- * `!ctx.unicode`).
- */
-export function toneMarker(tone, ascii) {
-    const table = ascii ? TONE_MARKER_ASCII : TONE_MARKER;
-    return table[tone] ?? (ascii ? "-" : "•");
-}

package/dist/blocks/treeview.d.ts

@@ -1,22 +0,0 @@
-/**
- * The `tree` block (UI-blocks spec §5.3): a `nodes` binding of
- * `{id, label, icon?, hasChildren?, children?}[]` with a cursor row,
- * arrow-key movement, and Enter to expand/collapse or activate.
- *
- * A node with inline `children` toggles locally and never dispatches;
- * a node with `hasChildren` and no inline children dispatches
- * `onExpand` (an `edit`-shaped action carrying the handler NAME — the
- * handler returns `DataOps` inserting the children). A leaf runs
- * `onActivate` with `{id}`. Markers: `▸`/`▾` (ASCII `>`/`v`).
- */
-import type { Component } from "@earendil-works/pi-tui";
-import type { TreeBlock } from "@sigrun/shared/blocks";
-import { type BlockCtx } from "./context.js";
-/** `tree`: cursor + expand/collapse + activate. */
-export declare class TreeComponent implements Component {
-    #private;
-    constructor(block: TreeBlock, ctx: BlockCtx);
-    render(width: number): string[];
-    handleInput(data: string): void;
-    invalidate(): void;
-}

package/dist/blocks/treeview.js

@@ -1,121 +0,0 @@
-/**
- * The `tree` block (UI-blocks spec §5.3): a `nodes` binding of
- * `{id, label, icon?, hasChildren?, children?}[]` with a cursor row,
- * arrow-key movement, and Enter to expand/collapse or activate.
- *
- * A node with inline `children` toggles locally and never dispatches;
- * a node with `hasChildren` and no inline children dispatches
- * `onExpand` (an `edit`-shaped action carrying the handler NAME — the
- * handler returns `DataOps` inserting the children). A leaf runs
- * `onActivate` with `{id}`. Markers: `▸`/`▾` (ASCII `>`/`v`).
- */
-import { bindRaw } from "./context.js";
-import { iconGlyph } from "./icons.js";
-import { truncate } from "./width.js";
-/** The markers for expandable nodes. */
-const MARKERS = { collapsed: "▸", expanded: "▾", collapsedAscii: ">", expandedAscii: "v" };
-/** Read the bound nodes, dropping malformed entries. */
-function treeNodes(block, ctx) {
-    const raw = bindRaw(block.nodes, ctx);
-    if (!Array.isArray(raw))
-        return [];
-    const out = [];
-    for (const entry of raw) {
-        if (entry === null || typeof entry !== "object" || Array.isArray(entry))
-            continue;
-        const record = entry;
-        if (typeof record.id !== "string" || typeof record.label !== "string")
-            continue;
-        out.push({
-            id: record.id,
-            label: record.label,
-            icon: typeof record.icon === "string" ? record.icon : undefined,
-            hasChildren: record.hasChildren === true,
-            children: Array.isArray(record.children)
-                ? record.children
-                : undefined,
-        });
-    }
-    return out;
-}
-/** `tree`: cursor + expand/collapse + activate. */
-export class TreeComponent {
-    #block;
-    #ctx;
-    #cursor = 0;
-    #expanded = new Set();
-    constructor(block, ctx) {
-        this.#block = block;
-        this.#ctx = ctx;
-    }
-    /** The visible rows (children of expanded nodes interleave). */
-    #rows() {
-        const out = [];
-        const walk = (nodes, depth) => {
-            for (const node of nodes) {
-                out.push({ node, depth });
-                if (this.#expanded.has(node.id) && node.children !== undefined) {
-                    walk(node.children, depth + 1);
-                }
-            }
-        };
-        walk(treeNodes(this.#block, this.#ctx), 0);
-        return out;
-    }
-    render(width) {
-        const unicode = this.#ctx.unicode;
-        return this.#rows().map((row, index) => {
-            const cursor = index === this.#cursor ? "> " : "  ";
-            // Every row carries a state marker; leaves show the collapsed
-            // glyph as their bullet so icon rows align with parent rows.
-            const marker = (this.#expanded.has(row.node.id)
-                ? unicode
-                    ? MARKERS.expanded
-                    : MARKERS.expandedAscii
-                : unicode
-                    ? MARKERS.collapsed
-                    : MARKERS.collapsedAscii) + " ";
-            const icon = row.node.icon === undefined
-                ? ""
-                : `${iconGlyph(row.node.icon, !unicode)} `;
-            const indent = "  ".repeat(row.depth);
-            return truncate(`${cursor}${indent}${marker}${icon}${row.node.label}`, width);
-        });
-    }
-    handleInput(data) {
-        const rows = this.#rows();
-        if (data === "\x1b[B") {
-            this.#cursor = Math.min(rows.length - 1, this.#cursor + 1);
-            return;
-        }
-        if (data === "\x1b[A") {
-            this.#cursor = Math.max(0, this.#cursor - 1);
-            return;
-        }
-        if (data !== "\r")
-            return;
-        const row = rows[this.#cursor];
-        if (row === undefined)
-            return;
-        const node = row.node;
-        if (node.children !== undefined) {
-            // Inline children toggle locally; nothing dispatches.
-            if (this.#expanded.has(node.id))
-                this.#expanded.delete(node.id);
-            else
-                this.#expanded.add(node.id);
-            return;
-        }
-        if (node.hasChildren === true && this.#block.onExpand !== undefined) {
-            const action = { type: "edit", name: this.#block.onExpand };
-            this.#ctx.dispatch(action, { id: node.id });
-            return;
-        }
-        if (this.#block.onActivate !== undefined) {
-            this.#ctx.dispatch(this.#block.onActivate, { id: node.id });
-        }
-    }
-    invalidate() {
-        // Cursor and expansion survive re-renders.
-    }
-}