@chances-ai/ui-core 17.0.0

package/dist/diff-model.d.ts

@@ -0,0 +1,64 @@
+/**
+ * (5.9 / v14) Pure parser that turns the `linesDiff` text block (carried in a
+ * write/edit `tool:permission` summary — see `view-model.ts`) into structured,
+ * renderable rows. NO React/Ink here — this is the correctness core, fully
+ * unit-tested in isolation.
+ *
+ * `linesDiff` (`packages/tools/src/diff.ts`) emits, in order:
+ *   `@@ -start,rem +start,add @@`
+ *   `- <removed line>` × rem
+ *   `+ <added line>`   × add
+ * — i.e. ALL removes then ALL adds, NO context lines; with a `… (N lines
+ * elided)` marker injected in the middle when the block exceeds its 14-body-row
+ * cap (so a full block is up to 15 lines incl. the header — codex R1 SHOULD-5).
+ *
+ * Line numbers (codex R1 MUST-1): `write` diffs are whole-file-anchored
+ * (`linesDiff(before, content)`), so `@@ -start` is the real file line — render
+ * the gutter. `edit` diffs are `find`↔`replace` snippets, so `@@ -1` is
+ * snippet-relative — the caller passes `anchored: false` and no gutter is shown.
+ */
+/** Threshold above which a remove/add pair renders as whole-line (not word-level).
+ *  Matches claude-code `StructuredDiff/Fallback.tsx` `CHANGE_THRESHOLD`. */
+export declare const CHANGE_THRESHOLD = 0.4;
+export interface WordSeg {
+    text: string;
+    /** True ⇒ this word was added (on an add row) or removed (on a remove row). */
+    changed: boolean;
+}
+export interface DiffRow {
+    kind: "add" | "remove" | "elision";
+    /** Code content with the `+`/`-`/space sigil stripped (the raw elision text
+     *  for `kind:"elision"`). */
+    text: string;
+    /** Assigned line number, or null when unanchored (edit) or an elision row. */
+    lineNo: number | null;
+    /** Word-level segments when this row is part of a sub-threshold pair; null ⇒
+     *  render the whole line with the line background. */
+    words: WordSeg[] | null;
+}
+export interface ParsedDiff {
+    rows: DiffRow[];
+    /** The hunk's old start line (1-based) parsed from the `@@` header, or null. */
+    startLine: number | null;
+}
+/**
+ * Detect whether a text block is a renderable diff (the non-diff guard, 5.9 §3):
+ * true only when it contains a `@@ -d +d @@` hunk header.
+ */
+export declare function looksLikeDiff(text: string): boolean;
+/**
+ * Parse a `linesDiff` block. `anchored` (write=true, edit=false) controls
+ * whether line numbers are assigned. Returns rows in source order with
+ * word-level segments computed for sub-threshold remove/add pairs.
+ */
+export declare function parseDiff(text: string, opts: {
+    anchored: boolean;
+}): ParsedDiff;
+/**
+ * Word-level segments for one side of a pair. `side:"remove"` keeps common +
+ * removed words; `side:"add"` keeps common + added words. Returns null when the
+ * pair changed more than {@link CHANGE_THRESHOLD} of its total length (render
+ * whole-line instead).
+ */
+export declare function wordSegs(removeText: string, addText: string, side: "add" | "remove"): WordSeg[] | null;
+//# sourceMappingURL=diff-model.d.ts.map

package/dist/diff-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-model.d.ts","sourceRoot":"","sources":["../src/diff-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;4EAC4E;AAC5E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnC;iCAC6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;0DACsD;IACtD,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,gFAAgF;IAChF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAQD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAOD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,UAAU,CAuB/E;AAqED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,EAAE,GAAG,IAAI,CAiBtG"}

package/dist/diff-model.js

@@ -0,0 +1,156 @@
+/**
+ * (5.9 / v14) Pure parser that turns the `linesDiff` text block (carried in a
+ * write/edit `tool:permission` summary — see `view-model.ts`) into structured,
+ * renderable rows. NO React/Ink here — this is the correctness core, fully
+ * unit-tested in isolation.
+ *
+ * `linesDiff` (`packages/tools/src/diff.ts`) emits, in order:
+ *   `@@ -start,rem +start,add @@`
+ *   `- <removed line>` × rem
+ *   `+ <added line>`   × add
+ * — i.e. ALL removes then ALL adds, NO context lines; with a `… (N lines
+ * elided)` marker injected in the middle when the block exceeds its 14-body-row
+ * cap (so a full block is up to 15 lines incl. the header — codex R1 SHOULD-5).
+ *
+ * Line numbers (codex R1 MUST-1): `write` diffs are whole-file-anchored
+ * (`linesDiff(before, content)`), so `@@ -start` is the real file line — render
+ * the gutter. `edit` diffs are `find`↔`replace` snippets, so `@@ -1` is
+ * snippet-relative — the caller passes `anchored: false` and no gutter is shown.
+ */
+import { diffWordsWithSpace } from "diff";
+/** Threshold above which a remove/add pair renders as whole-line (not word-level).
+ *  Matches claude-code `StructuredDiff/Fallback.tsx` `CHANGE_THRESHOLD`. */
+export const CHANGE_THRESHOLD = 0.4;
+const HUNK_RE = /^@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)? @@/;
+// Anchored + exact: `linesDiff` emits the marker as `… (N lines elided)`. A
+// loose `lines elided)` alternative (codex R2 SHOULD-4) would misclassify a
+// real source line that merely contains that phrase.
+const ELISION_RE = /^… \(\d+ lines elided\)$/;
+/**
+ * Detect whether a text block is a renderable diff (the non-diff guard, 5.9 §3):
+ * true only when it contains a `@@ -d +d @@` hunk header.
+ */
+export function looksLikeDiff(text) {
+    return text.split("\n").some((l) => HUNK_RE.test(l));
+}
+/**
+ * Parse a `linesDiff` block. `anchored` (write=true, edit=false) controls
+ * whether line numbers are assigned. Returns rows in source order with
+ * word-level segments computed for sub-threshold remove/add pairs.
+ */
+export function parseDiff(text, opts) {
+    const lines = text.split("\n");
+    let startLine = null;
+    const raw = [];
+    for (const line of lines) {
+        const hunk = HUNK_RE.exec(line);
+        if (hunk) {
+            if (startLine === null)
+                startLine = Number(hunk[1]);
+            continue;
+        }
+        if (ELISION_RE.test(line)) {
+            raw.push({ kind: "elision", text: line });
+            continue;
+        }
+        if (line.startsWith("- "))
+            raw.push({ kind: "remove", text: line.slice(2) });
+        else if (line.startsWith("+ "))
+            raw.push({ kind: "add", text: line.slice(2) });
+        else if (line === "-" || line === "+")
+            raw.push({ kind: line === "+" ? "add" : "remove", text: "" });
+        // Anything else (stray context / blank) is ignored: linesDiff never emits it.
+    }
+    const rows = numberAndPair(raw, startLine ?? 1, opts.anchored);
+    return { rows, startLine };
+}
+/**
+ * Assign line numbers (anchored only) and compute word-level pairing. Mirrors
+ * claude-code's `numberDiffLines` + `processAdjacentLines`: a run of removes
+ * followed by a run of adds pairs index-wise; the line counter rewinds by the
+ * number of removes so the matching add reuses the same displayed number.
+ */
+function numberAndPair(raw, startLine, anchored) {
+    const out = [];
+    let i = 0;
+    let lineNo = startLine;
+    while (i < raw.length) {
+        const cur = raw[i];
+        if (cur.kind === "elision") {
+            out.push({ kind: "elision", text: cur.text, lineNo: null, words: null });
+            i++;
+            continue;
+        }
+        if (cur.kind === "remove") {
+            // Collect the remove run, then the following add run.
+            const removes = [];
+            while (i < raw.length && raw[i].kind === "remove")
+                removes.push(raw[i++]);
+            const adds = [];
+            while (i < raw.length && raw[i].kind === "add")
+                adds.push(raw[i++]);
+            const removeBase = lineNo;
+            removes.forEach((r, k) => {
+                const paired = adds[k];
+                out.push({
+                    kind: "remove",
+                    text: r.text,
+                    lineNo: anchored ? removeBase + k : null,
+                    words: paired ? wordSegs(r.text, paired.text, "remove") : null,
+                });
+            });
+            // Rewind: removed lines don't exist in the new file — adds reuse the numbers.
+            adds.forEach((a, k) => {
+                const paired = removes[k];
+                out.push({
+                    kind: "add",
+                    text: a.text,
+                    lineNo: anchored ? removeBase + k : null,
+                    // wordSegs always takes (removeText, addText); here the add's pair is
+                    // the remove at the same index.
+                    words: paired ? wordSegs(paired.text, a.text, "add") : null,
+                });
+            });
+            lineNo = removeBase + Math.max(removes.length, adds.length);
+            continue;
+        }
+        // A lone add run (pure insertion, no preceding removes).
+        if (cur.kind === "add") {
+            while (i < raw.length && raw[i].kind === "add") {
+                const a = raw[i++];
+                out.push({ kind: "add", text: a.text, lineNo: anchored ? lineNo++ : null, words: null });
+            }
+            continue;
+        }
+        i++;
+    }
+    return out;
+}
+/**
+ * Word-level segments for one side of a pair. `side:"remove"` keeps common +
+ * removed words; `side:"add"` keeps common + added words. Returns null when the
+ * pair changed more than {@link CHANGE_THRESHOLD} of its total length (render
+ * whole-line instead).
+ */
+export function wordSegs(removeText, addText, side) {
+    const parts = diffWordsWithSpace(removeText, addText);
+    const total = removeText.length + addText.length;
+    const changedLen = parts.reduce((sum, p) => (p.added || p.removed ? sum + p.value.length : sum), 0);
+    if (total === 0 || changedLen / total > CHANGE_THRESHOLD)
+        return null;
+    const segs = [];
+    for (const p of parts) {
+        if (side === "remove") {
+            if (p.added)
+                continue;
+            segs.push({ text: p.value, changed: !!p.removed });
+        }
+        else {
+            if (p.removed)
+                continue;
+            segs.push({ text: p.value, changed: !!p.added });
+        }
+    }
+    return segs;
+}
+//# sourceMappingURL=diff-model.js.map

package/dist/diff-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-model.js","sourceRoot":"","sources":["../src/diff-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,MAAM,CAAC;AAE1C;4EAC4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AA0BpC,MAAM,OAAO,GAAG,yCAAyC,CAAC;AAC1D,4EAA4E;AAC5E,4EAA4E;AAC5E,qDAAqD;AACrD,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAA2B;IACjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,SAAS,KAAK,IAAI;gBAAE,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aACxE,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aAC1E,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACrG,8EAA8E;IAChF,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,GAAa,EAAE,SAAiB,EAAE,QAAiB;IACxE,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,MAAM,GAAG,SAAS,CAAC;IAEvB,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACzE,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,sDAAsD;YACtD,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC,CAAC;YAC5E,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC,CAAC;YAEtE,MAAM,UAAU,GAAG,MAAM,CAAC;YAC1B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACvB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACvB,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;oBACxC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;iBAC/D,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,8EAA8E;YAC9E,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACpB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC1B,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,KAAK;oBACX,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;oBACxC,sEAAsE;oBACtE,gCAAgC;oBAChC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;iBAC5D,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5D,SAAS;QACX,CAAC;QAED,yDAAyD;QACzD,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAE,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAChD,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAE,CAAC;gBACpB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3F,CAAC;YACD,SAAS;QACX,CAAC;QAED,CAAC,EAAE,CAAC;IACN,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,UAAkB,EAAE,OAAe,EAAE,IAAsB;IAClF,MAAM,KAAK,GAAG,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACpG,IAAI,KAAK,KAAK,CAAC,IAAI,UAAU,GAAG,KAAK,GAAG,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAEtE,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,KAAK;gBAAE,SAAS;YACtB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,CAAC,OAAO;gBAAE,SAAS;YACxB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/event-bus.d.ts

@@ -0,0 +1,48 @@
+/**
+ * (v17 M1 / docs/6.1 §4) A browser-safe `AppEvent` pub/sub for the shared UI
+ * tier. `ChatViewModel.attach` consumes events through the structural
+ * {@link AppEventBus} interface (not the engine's nominal `EventBus` class), so
+ * BOTH inputs satisfy it:
+ *   - the TUI passes the engine's `@chances-ai/runtime` `EventBus` (in-process,
+ *     the engine emits straight onto it), and
+ *   - the web/desktop client builds a {@link LocalEventBus} and emits AppEvents
+ *     reverse-mapped from the wire (`client-core`).
+ *
+ * Why a second bus instead of importing the engine's: the engine's `EventBus`
+ * has `private` fields, so TS types it NOMINALLY — only a real instance is
+ * assignable to it, which would force the browser client to value-import
+ * `@chances-ai/runtime` (dragging node-bound modules into the bundle). Keeping
+ * `attach`'s parameter a structural interface lets the client supply this
+ * 15-line, dependency-free implementation and stay genuinely browser-safe (the
+ * established "type-only runtime" rule for this tier). The two buses are unified
+ * by {@link AppEventBus}; there is no logic to drift.
+ */
+import type { AppEvent, AppEventType } from "@chances-ai/runtime";
+/** An AppEvent of a specific discriminant. */
+type EventOf<T extends AppEventType> = Extract<AppEvent, {
+    type: T;
+}>;
+/**
+ * The structural subset of an event bus `ChatViewModel.attach` needs: typed,
+ * per-discriminant subscription returning an unsubscribe. The engine's
+ * `EventBus` (more methods: `onAny`, `emit`) is assignable to this; so is
+ * {@link LocalEventBus}.
+ */
+export interface AppEventBus {
+    on<T extends AppEventType>(type: T, handler: (event: EventOf<T>) => void): () => void;
+}
+/**
+ * A minimal, browser-safe {@link AppEventBus}. Structurally identical to the
+ * engine's `EventBus` (intentionally — it is the SAME 15-line primitive, not a
+ * fork of any logic) but with zero dependencies, so the web/desktop client can
+ * own one without importing the engine runtime.
+ */
+export declare class LocalEventBus implements AppEventBus {
+    private readonly handlers;
+    private readonly anyHandlers;
+    on<T extends AppEventType>(type: T, handler: (event: EventOf<T>) => void): () => void;
+    onAny(handler: (event: AppEvent) => void): () => void;
+    emit(event: AppEvent): void;
+}
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAElE,8CAA8C;AAC9C,KAAK,OAAO,CAAC,CAAC,SAAS,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACvF;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuD;IAChF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoC;IAEhE,EAAE,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAWrF,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAKrD,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAI5B"}

package/dist/event-bus.js

@@ -0,0 +1,50 @@
+/**
+ * (v17 M1 / docs/6.1 §4) A browser-safe `AppEvent` pub/sub for the shared UI
+ * tier. `ChatViewModel.attach` consumes events through the structural
+ * {@link AppEventBus} interface (not the engine's nominal `EventBus` class), so
+ * BOTH inputs satisfy it:
+ *   - the TUI passes the engine's `@chances-ai/runtime` `EventBus` (in-process,
+ *     the engine emits straight onto it), and
+ *   - the web/desktop client builds a {@link LocalEventBus} and emits AppEvents
+ *     reverse-mapped from the wire (`client-core`).
+ *
+ * Why a second bus instead of importing the engine's: the engine's `EventBus`
+ * has `private` fields, so TS types it NOMINALLY — only a real instance is
+ * assignable to it, which would force the browser client to value-import
+ * `@chances-ai/runtime` (dragging node-bound modules into the bundle). Keeping
+ * `attach`'s parameter a structural interface lets the client supply this
+ * 15-line, dependency-free implementation and stay genuinely browser-safe (the
+ * established "type-only runtime" rule for this tier). The two buses are unified
+ * by {@link AppEventBus}; there is no logic to drift.
+ */
+/**
+ * A minimal, browser-safe {@link AppEventBus}. Structurally identical to the
+ * engine's `EventBus` (intentionally — it is the SAME 15-line primitive, not a
+ * fork of any logic) but with zero dependencies, so the web/desktop client can
+ * own one without importing the engine runtime.
+ */
+export class LocalEventBus {
+    handlers = new Map();
+    anyHandlers = new Set();
+    on(type, handler) {
+        let set = this.handlers.get(type);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(type, set);
+        }
+        const wrapped = handler;
+        set.add(wrapped);
+        return () => set.delete(wrapped);
+    }
+    onAny(handler) {
+        this.anyHandlers.add(handler);
+        return () => this.anyHandlers.delete(handler);
+    }
+    emit(event) {
+        for (const handler of this.handlers.get(event.type) ?? [])
+            handler(event);
+        for (const handler of this.anyHandlers)
+            handler(event);
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAiBH;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACP,QAAQ,GAAG,IAAI,GAAG,EAA4C,CAAC;IAC/D,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEhE,EAAE,CAAyB,IAAO,EAAE,OAAoC;QACtE,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,OAAO,GAAG,OAAgC,CAAC;QACjD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjB,OAAO,GAAG,EAAE,CAAC,GAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAkC;QACtC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,KAAe;QAClB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1E,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/frame-scheduler.d.ts

@@ -0,0 +1,44 @@
+/**
+ * (5.8 / v13) Frame-coalescing scheduler.
+ *
+ * Streaming `assistant:delta` events arrive one-per-token (engine.ts emits a
+ * bump per stream chunk). Before v13 each one drove a full React re-render of
+ * the whole scrollback. The view-model now routes delta-driven re-renders
+ * through `schedule()` so at most ONE render happens per ~16 ms frame, while
+ * structural events (a finished message, a tool call/result, turn end) still
+ * flush immediately via the view-model's force-flush path (which `cancel()`s
+ * any pending frame first).
+ *
+ * The scheduler is injectable so tests run deterministically with no timers:
+ * inject {@link ManualFrameScheduler}, drive events, then `flush()` — the
+ * assertion is "N deltas → exactly one notification", which a real
+ * `setTimeout` clock can't express without flakiness.
+ */
+/** Opaque handle returned by {@link FrameScheduler.schedule}; pass it back to
+ *  `cancel()`. Callers must not inspect it. */
+export type FrameHandle = unknown;
+export interface FrameScheduler {
+    /** Run `cb` on a later frame; returns a handle for {@link cancel}. */
+    schedule(cb: () => void): FrameHandle;
+    /** Cancel a scheduled `cb` if it has not run yet. Idempotent. */
+    cancel(handle: FrameHandle): void;
+}
+/** Default production scheduler: a single `setTimeout` per coalescing window. */
+export declare const defaultFrameScheduler: FrameScheduler;
+/**
+ * Deterministic scheduler for tests. `schedule()` enqueues a callback (no
+ * timer), `cancel()` removes it, `flush()` runs all queued callbacks in FIFO
+ * order and clears the queue. `pending` exposes the queue depth so a test can
+ * assert coalescing ("after N deltas, exactly one callback is queued").
+ */
+export declare class ManualFrameScheduler implements FrameScheduler {
+    private readonly queue;
+    private nextId;
+    schedule(cb: () => void): FrameHandle;
+    cancel(handle: FrameHandle): void;
+    /** Number of callbacks queued but not yet run or cancelled. */
+    get pending(): number;
+    /** Run every queued callback (FIFO) and clear the queue. */
+    flush(): void;
+}
+//# sourceMappingURL=frame-scheduler.d.ts.map

package/dist/frame-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-scheduler.d.ts","sourceRoot":"","sources":["../src/frame-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;+CAC+C;AAC/C,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAElC,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;IACtC,iEAAiE;IACjE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACnC;AAMD,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,EAAE,cAKnC,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,MAAM,CAAK;IAEnB,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW;IAMrC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIjC,+DAA+D;IAC/D,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,4DAA4D;IAC5D,KAAK,IAAI,IAAI;CAKd"}

package/dist/frame-scheduler.js

@@ -0,0 +1,58 @@
+/**
+ * (5.8 / v13) Frame-coalescing scheduler.
+ *
+ * Streaming `assistant:delta` events arrive one-per-token (engine.ts emits a
+ * bump per stream chunk). Before v13 each one drove a full React re-render of
+ * the whole scrollback. The view-model now routes delta-driven re-renders
+ * through `schedule()` so at most ONE render happens per ~16 ms frame, while
+ * structural events (a finished message, a tool call/result, turn end) still
+ * flush immediately via the view-model's force-flush path (which `cancel()`s
+ * any pending frame first).
+ *
+ * The scheduler is injectable so tests run deterministically with no timers:
+ * inject {@link ManualFrameScheduler}, drive events, then `flush()` — the
+ * assertion is "N deltas → exactly one notification", which a real
+ * `setTimeout` clock can't express without flakiness.
+ */
+/** ~1 frame at 60fps. One coalesced render per frame is imperceptible while
+ *  capping re-renders during a fast token stream. */
+const FRAME_MS = 16;
+/** Default production scheduler: a single `setTimeout` per coalescing window. */
+export const defaultFrameScheduler = {
+    schedule: (cb) => setTimeout(cb, FRAME_MS),
+    cancel: (handle) => {
+        if (handle !== undefined)
+            clearTimeout(handle);
+    },
+};
+/**
+ * Deterministic scheduler for tests. `schedule()` enqueues a callback (no
+ * timer), `cancel()` removes it, `flush()` runs all queued callbacks in FIFO
+ * order and clears the queue. `pending` exposes the queue depth so a test can
+ * assert coalescing ("after N deltas, exactly one callback is queued").
+ */
+export class ManualFrameScheduler {
+    queue = new Map();
+    nextId = 1;
+    schedule(cb) {
+        const id = this.nextId++;
+        this.queue.set(id, cb);
+        return id;
+    }
+    cancel(handle) {
+        if (typeof handle === "number")
+            this.queue.delete(handle);
+    }
+    /** Number of callbacks queued but not yet run or cancelled. */
+    get pending() {
+        return this.queue.size;
+    }
+    /** Run every queued callback (FIFO) and clear the queue. */
+    flush() {
+        const callbacks = [...this.queue.values()];
+        this.queue.clear();
+        for (const cb of callbacks)
+            cb();
+    }
+}
+//# sourceMappingURL=frame-scheduler.js.map

package/dist/frame-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-scheduler.js","sourceRoot":"","sources":["../src/frame-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAaH;qDACqD;AACrD,MAAM,QAAQ,GAAG,EAAE,CAAC;AAEpB,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC;IAC1C,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,IAAI,MAAM,KAAK,SAAS;YAAE,YAAY,CAAC,MAAuC,CAAC,CAAC;IAClF,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IACd,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC/C,MAAM,GAAG,CAAC,CAAC;IAEnB,QAAQ,CAAC,EAAc;QACrB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,MAAmB;QACxB,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;IAED,+DAA+D;IAC/D,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,4DAA4D;IAC5D,KAAK;QACH,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,EAAE,IAAI,SAAS;YAAE,EAAE,EAAE,CAAC;IACnC,CAAC;CACF"}

package/dist/highlight-to-segments.d.ts

@@ -0,0 +1,18 @@
+import type { Theme } from "./theme.js";
+/** Stable highlight scopes we color. Everything else → `"plain"` (no color). */
+export type HlScope = "plain" | "keyword" | "string" | "comment" | "number" | "function" | "type" | "literal" | "attr";
+export interface Segment {
+    text: string;
+    scope: HlScope;
+}
+/** scope → theme color role (used by views to pick the `<Text color>`). */
+export declare const SCOPE_TO_THEME: Record<HlScope, keyof Theme | undefined>;
+/** Resolve a user-supplied language label to a registered grammar, or null. */
+export declare function resolveLanguage(lang: string | undefined): string | null;
+/**
+ * Highlight `code` as `lang` into themed segments. Unknown/absent language or
+ * any highlighter error → a single `"plain"` segment with the original code
+ * (callers render it as plain text).
+ */
+export declare function highlightToSegments(code: string, lang: string | undefined): Segment[];
+//# sourceMappingURL=highlight-to-segments.d.ts.map

package/dist/highlight-to-segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight-to-segments.d.ts","sourceRoot":"","sources":["../src/highlight-to-segments.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AA4ExC,gFAAgF;AAChF,MAAM,MAAM,OAAO,GACf,OAAO,GACP,SAAS,GACT,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,UAAU,GACV,MAAM,GACN,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AA6CD,2EAA2E;AAC3E,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,KAAK,GAAG,SAAS,CAUnE,CAAC;AAgBF,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAMvE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,EAAE,CAWrF"}