@inhuman.tools/harness-tui 0.0.0-stage → 0.3.0

package/dist/tui/paint-transport.js

@@ -0,0 +1,207 @@
+/**
+ * paint_init + sequenced paint_patch. Worker accumulates MST onPatch into one
+ * microtask batch. Host applyPatch is one MobX action. Protocol faults are
+ * fatal; valid structural patches are transported without heuristic rejection.
+ *
+ * Growing strings (speech, live receipts) travel as `splice` so a token does
+ * not recopy the whole prefix. The reader expands each splice to an MST
+ * replace against the replica's current value.
+ */
+import { trace } from "@inhuman.tools/harness-diagnostics";
+import { runInAction } from "mobx";
+import { applyPatch, destroy, getSnapshot, onPatch, protect } from "mobx-state-tree";
+import { RootPaint } from "./paint-dom.js";
+export class PaintProtocolError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "PaintProtocolError";
+        this.code = code;
+    }
+}
+export function createPaintWriter(epoch, post) {
+    let root = null;
+    let queued = [];
+    let scheduled = false;
+    let seq = 0;
+    let open = true;
+    let detachPatch = null;
+    const flush = () => {
+        scheduled = false;
+        if (!open || queued.length === 0) {
+            queued = [];
+            return;
+        }
+        const patches = queued;
+        queued = [];
+        seq += 1;
+        if (patches.length > 40)
+            trace("harness:paint", `patch seq=${seq} n=${patches.length}`);
+        post({ kind: "paint_patch", epoch, seq, patches });
+    };
+    return {
+        epoch,
+        attach(next) {
+            if (root !== null) {
+                throw new Error("paint writer already attached");
+            }
+            root = next;
+            detachPatch = onPatch(next, (patch, reversePatch) => {
+                if (!open)
+                    return;
+                enqueuePatch(queued, compressReplace(patch, reversePatch));
+                if (scheduled)
+                    return;
+                scheduled = true;
+                queueMicrotask(flush);
+            });
+            post({
+                kind: "paint_init",
+                epoch,
+                snapshot: getSnapshot(next),
+            });
+        },
+        flush,
+        close(mode) {
+            if (!open)
+                return;
+            if (mode === "flush")
+                flush();
+            else
+                queued = [];
+            open = false;
+            scheduled = false;
+        },
+        dispose() {
+            this.close("discard");
+            detachPatch?.();
+            detachPatch = null;
+            root = null;
+        },
+    };
+}
+export function createPaintReader() {
+    let root = null;
+    let epoch = null;
+    let seq = 0;
+    const remount = (nextEpoch, snapshot) => {
+        if (root !== null)
+            destroy(root);
+        root = RootPaint.create(snapshot);
+        protect(root);
+        epoch = nextEpoch;
+        seq = 0;
+        return root;
+    };
+    return {
+        get root() {
+            return root;
+        },
+        get epoch() {
+            return epoch;
+        },
+        get seq() {
+            return seq;
+        },
+        apply(message) {
+            if (message.kind === "paint_init") {
+                return remount(message.epoch, message.snapshot);
+            }
+            if (root === null || epoch === null) {
+                throw new PaintProtocolError("patch_before_init", "paint_patch before paint_init");
+            }
+            if (message.epoch !== epoch) {
+                throw new PaintProtocolError("epoch_mismatch", `paint_patch epoch ${message.epoch} != ${epoch}`);
+            }
+            if (message.seq !== seq + 1) {
+                throw new PaintProtocolError("seq_gap", `paint_patch seq ${message.seq} != ${seq + 1}`);
+            }
+            try {
+                runInAction(() => {
+                    applyPaintPatches(root, message.patches);
+                });
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error);
+                throw new PaintProtocolError("apply_failed", detail);
+            }
+            seq = message.seq;
+            return root;
+        },
+        dispose() {
+            if (root !== null)
+                destroy(root);
+            root = null;
+            epoch = null;
+            seq = 0;
+        },
+    };
+}
+function compressReplace(patch, reversePatch) {
+    if (patch.op !== "replace" || typeof patch.value !== "string")
+        return patch;
+    const old = reversePatch.value;
+    if (typeof old !== "string")
+        return patch;
+    if (patch.value.startsWith(old)) {
+        return {
+            op: "splice",
+            path: patch.path,
+            from: old.length,
+            deleteCount: 0,
+            insert: patch.value.slice(old.length),
+        };
+    }
+    if (old.startsWith(patch.value)) {
+        return {
+            op: "splice",
+            path: patch.path,
+            from: patch.value.length,
+            deleteCount: old.length - patch.value.length,
+            insert: "",
+        };
+    }
+    return patch;
+}
+function enqueuePatch(queued, next) {
+    const last = queued.at(-1);
+    if (last?.op === "splice" &&
+        next.op === "splice" &&
+        last.path === next.path &&
+        last.deleteCount === 0 &&
+        next.deleteCount === 0 &&
+        last.from + last.insert.length === next.from) {
+        queued[queued.length - 1] = { ...last, insert: last.insert + next.insert };
+        return;
+    }
+    queued.push(next);
+}
+function isSplice(patch) {
+    return patch.op === "splice";
+}
+function valueAtPath(root, path) {
+    let cur = root;
+    for (const part of path.split("/")) {
+        if (part === "")
+            continue;
+        if (cur == null || typeof cur !== "object")
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+function expandSplice(root, patch) {
+    const current = valueAtPath(root, patch.path);
+    const text = typeof current === "string" ? current : "";
+    return {
+        op: "replace",
+        path: patch.path,
+        value: text.slice(0, patch.from) + patch.insert + text.slice(patch.from + patch.deleteCount),
+    };
+}
+function applyPaintPatches(root, patches) {
+    for (const patch of patches) {
+        applyPatch(root, isSplice(patch) ? expandSplice(root, patch) : patch);
+    }
+}
+//# sourceMappingURL=paint-transport.js.map

package/dist/tui/paint-transport.js.map

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

package/dist/tui/paint-types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Host-facing paint bags. Structural types live in Quickdraw; MountLocal
+ * and paint-mode unions stay here next to the MST models.
+ */
+/** TUI-only per-mount display. Keyed by the reader PaintNode pointer. */
+export interface MountLocal {
+    collapsed: boolean;
+    hitKey: string;
+}
+export type ComposerPaintMode = "normal" | "secret" | "isolated" | "waiting";
+export type CompletionPaintState = "live" | "successful" | "failed";
+export type WorkCellPaintState = "live" | "ok" | "fail" | "ask" | "judging";
+export type WorkReceiptKind = "none" | "text" | "markdown" | "diff" | "stream" | "syntax" | "number" | "boolean" | "parts";
+export type ComposerErrorLevel = "warning" | "error";
+//# sourceMappingURL=paint-types.d.ts.map

package/dist/tui/paint-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint-types.d.ts","sourceRoot":"","sources":["../../src/tui/paint-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAC5E,MAAM,MAAM,eAAe,GACzB,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAC/F,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAAC"}

package/dist/tui/paint-types.js

@@ -0,0 +1,6 @@
+/**
+ * Host-facing paint bags. Structural types live in Quickdraw; MountLocal
+ * and paint-mode unions stay here next to the MST models.
+ */
+export {};
+//# sourceMappingURL=paint-types.js.map

package/dist/tui/paint-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint-types.js","sourceRoot":"","sources":["../../src/tui/paint-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/tui/paint-widgets.d.ts

@@ -0,0 +1,94 @@
+import { type LayoutNode, type ProgressSite } from "@inhuman.tools/quickdraw/layout";
+import { type BirthSite, type PaintLocal, type PaintSink } from "@inhuman.tools/quickdraw/runtime";
+import { type SyntaxPolarity, type TranscriptPart } from "@inhuman.tools/quickdraw/widgets";
+import { type PaintNodeInstance } from "./paint-dom.js";
+import { WidgetHost, type PreparedSubtree, type RetainedWidget } from "./widget-host.js";
+type PatchTally = {
+    rebuilt: string[];
+    cached: string[];
+};
+export declare function armPatchTally(): void;
+export declare function dropPatchTally(): void;
+export declare function takePatchTally(): PatchTally | null;
+export type PaintWidgetContext = {
+    host: WidgetHost;
+    sink: PaintSink;
+    local: PaintLocal | null;
+    /**
+     * Ambient shiki polarity and warmth — both MobX-observable, read inside
+     * each widget's `reaction` data function so a flip or warm-up marks the
+     * baked-token subtree dirty. Not a counter: these are the actual inputs
+     * `highlightCodeSync` derives token colors from.
+     */
+    syntaxPolarity: () => SyntaxPolarity;
+    syntaxWarm: () => boolean;
+};
+export declare function createPaintWidgetHost(sink: PaintSink, syntaxPolarity?: () => SyntaxPolarity, syntaxWarm?: () => boolean, local?: PaintLocal | null): WidgetHost;
+declare abstract class RetainedAdapter implements RetainedWidget {
+    #private;
+    readonly node: PaintNodeInstance;
+    readonly parent: RetainedWidget | null;
+    readonly ctx: PaintWidgetContext;
+    disposed: boolean;
+    constructor(node: PaintNodeInstance, parent: RetainedWidget | null, ctx: PaintWidgetContext);
+    protected observe(data: () => unknown): void;
+    protected abstract watch(): void;
+    protected abstract rebuild(width: number): LayoutNode;
+    markDirty(): void;
+    prepare(width: number): PreparedSubtree;
+    /** Stack/turn rebuild already asked child widgets; reuse their site lists. */
+    protected takeSites(root: LayoutNode): {
+        birth: readonly BirthSite[];
+        progress: readonly ProgressSite[];
+    };
+    protected keepSites(birth: BirthSite[], progress: ProgressSite[]): void;
+    dispose(): void;
+}
+export declare class SpeechWidget extends RetainedAdapter {
+    #private;
+    expands: number;
+    protected watch(): void;
+    protected rebuild(width: number): LayoutNode;
+}
+export declare class ThinkingWidget extends RetainedAdapter {
+    protected watch(): void;
+    protected rebuild(width: number): LayoutNode;
+}
+export declare class FailureWidget extends RetainedAdapter {
+    protected watch(): void;
+    protected rebuild(width: number): LayoutNode;
+}
+export declare class RecallWidget extends RetainedAdapter {
+    protected watch(): void;
+    protected rebuild(_width: number): LayoutNode;
+}
+export declare class CompletionWidget extends RetainedAdapter {
+    protected watch(): void;
+    protected rebuild(width: number): LayoutNode;
+}
+export declare class WorkCellWidget extends RetainedAdapter {
+    protected watch(): void;
+    protected rebuild(width: number): LayoutNode;
+}
+export declare class ComposerWidget extends RetainedAdapter {
+    protected watch(): void;
+    protected rebuild(width: number): LayoutNode;
+}
+export declare class AgentsWidget extends RetainedAdapter {
+    protected watch(): void;
+    protected rebuild(width: number): LayoutNode;
+}
+export declare class StackWidget extends RetainedAdapter {
+    #private;
+    protected watch(): void;
+    markDirty(): void;
+    collectParts(width: number): TapeCollect;
+    protected rebuild(width: number): LayoutNode;
+}
+type TapeCollect = {
+    parts: TranscriptPart[];
+    birth: BirthSite[];
+    progress: ProgressSite[];
+};
+export {};
+//# sourceMappingURL=paint-widgets.d.ts.map

package/dist/tui/paint-widgets.d.ts.map

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