@corenel/web-ui 0.6.0 → 0.8.0

package/dist/fx/MatrixRain.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+export declare function MatrixRain({ active }: {
+    active: boolean;
+}): React.JSX.Element | null;
+//# sourceMappingURL=MatrixRain.d.ts.map

package/dist/fx/MatrixRain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatrixRain.d.ts","sourceRoot":"","sources":["../../fx/MatrixRain.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAMjD,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,4BAsDzD"}

package/dist/fx/MatrixRain.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/* The faint falling-glyph rain behind the in-progress turn under the Matrix
+ * rain effect. Decorative: aria-hidden, never takes clicks, and stops the
+ * moment it is inactive or unmounted. Needs a positioned parent. */
+import { useEffect, useRef } from 'react';
+const GLYPHS = 'ｱｲｳｴｵｶｷｸｹｺｻｼｽｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚﾛﾜ0123456789';
+const COL = 14;
+const FRAME_MS = 55;
+export function MatrixRain({ active }) {
+    const ref = useRef(null);
+    useEffect(() => {
+        const cv = ref.current;
+        if (!active || !cv)
+            return;
+        const ctx = cv.getContext('2d');
+        if (!ctx)
+            return;
+        // Drawn in CSS pixels on a device-pixel canvas (sharp on HiDPI). Resized
+        // only when the size really changes: assigning width wipes the canvas, and
+        // the live box grows a little with every streamed line.
+        let W = 0;
+        let H = 0;
+        const size = () => {
+            const p = cv.parentElement;
+            const w = p?.clientWidth ?? 0, h = p?.clientHeight ?? 0, dpr = window.devicePixelRatio || 1;
+            if (w === W && h === H && cv.width === Math.round(w * dpr))
+                return;
+            W = w;
+            H = h;
+            cv.width = Math.round(w * dpr);
+            cv.height = Math.round(h * dpr);
+            ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+        };
+        size();
+        const ro = typeof ResizeObserver !== 'undefined' ? new ResizeObserver(size) : null;
+        if (ro && cv.parentElement)
+            ro.observe(cv.parentElement);
+        let drops = Array.from({ length: Math.max(1, Math.ceil(W / COL)) }, () => Math.random() * -30);
+        let last = 0;
+        let raf = 0;
+        const frame = (now) => {
+            if (now - last >= FRAME_MS) {
+                last = now;
+                const cols = Math.max(1, Math.ceil(W / COL));
+                if (drops.length !== cols)
+                    drops = Array.from({ length: cols }, (_, i) => drops[i] ?? Math.random() * -30);
+                // Fade old glyphs to transparent, not to black: painting black would
+                // build a dark veil behind the text on light skins.
+                ctx.globalCompositeOperation = 'destination-out';
+                ctx.fillStyle = 'rgba(0,0,0,0.12)';
+                ctx.fillRect(0, 0, W, H);
+                ctx.globalCompositeOperation = 'source-over';
+                ctx.fillStyle = '#33ff33';
+                ctx.font = '13px monospace';
+                drops = drops.map((y, i) => {
+                    ctx.fillText(GLYPHS[Math.floor(Math.random() * GLYPHS.length)], i * COL, y * 16);
+                    return y * 16 > H && Math.random() > 0.96 ? 0 : y + 1;
+                });
+            }
+            raf = window.requestAnimationFrame(frame);
+        };
+        raf = window.requestAnimationFrame(frame);
+        return () => { window.cancelAnimationFrame(raf); ro?.disconnect(); };
+    }, [active]);
+    if (!active)
+        return null;
+    return _jsx("canvas", { ref: ref, "aria-hidden": "true", style: S.canvas });
+}
+const S = {
+    // Behind the answer: the live box sets isolation so -1 stays inside it.
+    canvas: { position: 'absolute', inset: 0, width: '100%', height: '100%', pointerEvents: 'none', opacity: 0.25, zIndex: -1 },
+};
+//# sourceMappingURL=MatrixRain.js.map

package/dist/fx/MatrixRain.js.map

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

package/dist/fx/NetsplitJoin.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+export declare function NetsplitJoin(): React.JSX.Element;
+//# sourceMappingURL=NetsplitJoin.d.ts.map

package/dist/fx/NetsplitJoin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetsplitJoin.d.ts","sourceRoot":"","sources":["../../fx/NetsplitJoin.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,wBAAgB,YAAY,sBAM3B"}

package/dist/fx/NetsplitJoin.js

@@ -0,0 +1,13 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { IRC_AGENT_NICK } from '../transcriptSkinCss';
+export function NetsplitJoin() {
+    return (_jsxs("div", { "data-fx-join": "", "aria-hidden": "true", style: S.join, children: ["* ", IRC_AGENT_NICK, " has joined"] }));
+}
+const S = {
+    // The skin's success tint where it has one, else the text colour, dimmed.
+    join: {
+        userSelect: 'none', pointerEvents: 'none', color: 'var(--success, currentColor)', opacity: 0.8,
+        fontFamily: 'var(--font-mono, ui-monospace, monospace)', fontSize: '0.92em', marginBottom: 2,
+    },
+};
+//# sourceMappingURL=NetsplitJoin.js.map

package/dist/fx/NetsplitJoin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetsplitJoin.js","sourceRoot":"","sources":["../../fx/NetsplitJoin.tsx"],"names":[],"mappings":";AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,UAAU,YAAY;IAC1B,OAAO,CACL,+BAAkB,EAAE,iBAAa,MAAM,EAAC,KAAK,EAAE,CAAC,CAAC,IAAI,mBAChD,cAAc,mBACb,CACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,GAAwC;IAC7C,0EAA0E;IAC1E,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,8BAA8B,EAAE,OAAO,EAAE,GAAG;QAC9F,UAAU,EAAE,2CAA2C,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;KAC7F;CACF,CAAC"}

package/dist/fx/arrivalModes.d.ts

@@ -0,0 +1,27 @@
+import type { ArrivalEffect } from '../arrivalEffect';
+/** Reveal step per tick: typewriter keys at ~30 characters a second, the rest ~60. */
+export declare function paceFor(effect: ArrivalEffect): number;
+/** The end of the word containing (or starting at) `i`: the next whitespace. */
+export declare function bandEnd(text: string, i: number): number;
+/** How much of `text` Markdown renders once `shown` characters are revealed.
+ * `complete`: the text is final (the stream ended). Only then does catching
+ * up commit everything; while it streams, being caught up is just a pause,
+ * and the effect's own rule still applies (netsplit holds back a partial
+ * line, a band keeps its last words as decoration). */
+export declare function committedAt(effect: ArrivalEffect, text: string, shown: number, complete?: boolean): number;
+/** True for the effects whose decoration is the trailing band of words. */
+export declare function isBandEffect(effect: ArrivalEffect): boolean;
+/** A band's words as decoration: Markdown markers dropped (the decoration must
+ * never show raw syntax), whitespace collapsed. */
+export declare function bandText(raw: string): string;
+/** Line breaks in the first `n` characters (teleprinter feeds, signal rolls). */
+export declare function lineCount(text: string, n: number): number;
+export declare const NOISE = "#%&@$*+=?/\\|<>~^!";
+/** At ~60 characters a second a character spends ~0.7 s crossing a tail this
+ * long, which is how long the signal takes to lock. */
+export declare const SIGNAL_TAIL = 42;
+/** The signal tail: the rest of the current line (capped), each character
+ * static or already locked. Characters nearest the reveal point are the most
+ * likely to have locked. Spaces stay spaces. */
+export declare function signalGlyphs(pending: string, rand?: () => number): string[];
+//# sourceMappingURL=arrivalModes.d.ts.map

package/dist/fx/arrivalModes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrivalModes.d.ts","sourceRoot":"","sources":["../../fx/arrivalModes.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AActD,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAErD;AAID,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIvD;AA6BD;;;;uDAIuD;AACvD,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,MAAM,CAWvG;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE3D;AAED;mDACmD;AACnD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,eAAO,MAAM,KAAK,uBAAuB,CAAC;AAC1C;uDACuD;AACvD,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B;;gDAEgD;AAChD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,MAAoB,GAAG,MAAM,EAAE,CAQxF"}

package/dist/fx/arrivalModes.js

@@ -0,0 +1,107 @@
+const MODE = {
+    none: 'char', matrix: 'char', splitflap: 'char', typewriter: 'char', decode: 'char', teleprinter: 'char', signal: 'char',
+    radar: 'band', pencil: 'band', netsplit: 'line',
+};
+/** How far a band trails the reveal, in characters: at ~60 characters a second
+ * a radar contact glows about half a second, and a pencil sketch inks a beat
+ * (~0.55 s) after it is drawn. */
+const BAND_LAG = { radar: 30, pencil: 33 };
+/** Reveal step per tick: typewriter keys at ~30 characters a second, the rest ~60. */
+export function paceFor(effect) {
+    return effect === 'typewriter' ? 1 : 2;
+}
+const isSpace = (ch) => ch !== undefined && /\s/.test(ch);
+/** The end of the word containing (or starting at) `i`: the next whitespace. */
+export function bandEnd(text, i) {
+    let j = Math.min(i, text.length);
+    while (j < text.length && !isSpace(text[j]))
+        j++;
+    return j;
+}
+// A block marker opening a line ("- ", "12. ", "## ", "> ", "| "), possibly
+// nested ("> - "). Committed with the line's first word so Markdown already
+// renders the block, and the marker never shows as raw text.
+const BLOCK_MARKER = /^(?:(?:[-*+]|\d+[.)]|#{1,6}|>|\|)[ \t]+)+/;
+function bandCommit(text, shown, lag) {
+    let c = Math.max(0, shown - lag);
+    // Back to a word start: a band holds whole words.
+    while (c > 0 && !isSpace(text[c - 1]))
+        c--;
+    // Never leave a line start inside the band. The decoration sits in the
+    // newest rendered block, so the newest line must already be one: commit
+    // through its block marker, if any, and its first word. The answer's own
+    // first line needs this only when it opens with a marker.
+    // The line's prefix is its indent, any (stacked) markers and their
+    // whitespace; `word` is where its first real word starts. A band starting
+    // anywhere in that prefix -- not only at the line start -- would show a raw
+    // marker ("  - nested", "> - item").
+    const lineStart = text.lastIndexOf('\n', shown - 1) + 1;
+    let word = lineStart;
+    while (word < text.length && isSpace(text[word]))
+        word++;
+    const marker = BLOCK_MARKER.exec(text.slice(word));
+    if (marker)
+        word += marker[0].length;
+    while (word < text.length && isSpace(text[word]))
+        word++;
+    if (c <= word && (lineStart > 0 || marker))
+        c = Math.max(c, bandEnd(text, word));
+    return c;
+}
+/** How much of `text` Markdown renders once `shown` characters are revealed.
+ * `complete`: the text is final (the stream ended). Only then does catching
+ * up commit everything; while it streams, being caught up is just a pause,
+ * and the effect's own rule still applies (netsplit holds back a partial
+ * line, a band keeps its last words as decoration). */
+export function committedAt(effect, text, shown, complete = true) {
+    if (complete && shown >= text.length)
+        return text.length;
+    const at = Math.min(shown, text.length);
+    switch (MODE[effect]) {
+        case 'band': return bandCommit(text, at, BAND_LAG[effect] ?? 30);
+        case 'line': {
+            const nl = text.lastIndexOf('\n', at - 1);
+            return nl < 0 ? 0 : nl + 1;
+        }
+        default: return at;
+    }
+}
+/** True for the effects whose decoration is the trailing band of words. */
+export function isBandEffect(effect) {
+    return MODE[effect] === 'band';
+}
+/** A band's words as decoration: Markdown markers dropped (the decoration must
+ * never show raw syntax), whitespace collapsed. */
+export function bandText(raw) {
+    return raw
+        .replace(/\]\([^)]*\)/g, '')
+        .replace(/[*_`~#>|\\[\]]/g, '')
+        .replace(/\s+/g, ' ');
+}
+/** Line breaks in the first `n` characters (teleprinter feeds, signal rolls). */
+export function lineCount(text, n) {
+    let count = 0;
+    const end = Math.min(n, text.length);
+    for (let i = 0; i < end; i++)
+        if (text.charCodeAt(i) === 10)
+            count++;
+    return count;
+}
+export const NOISE = '#%&@$*+=?/\\|<>~^!';
+/** At ~60 characters a second a character spends ~0.7 s crossing a tail this
+ * long, which is how long the signal takes to lock. */
+export const SIGNAL_TAIL = 42;
+/** The signal tail: the rest of the current line (capped), each character
+ * static or already locked. Characters nearest the reveal point are the most
+ * likely to have locked. Spaces stay spaces. */
+export function signalGlyphs(pending, rand = Math.random) {
+    const nl = pending.indexOf('\n');
+    const line = [...pending.slice(0, nl < 0 ? SIGNAL_TAIL : Math.min(nl, SIGNAL_TAIL))];
+    return line.map((ch, i) => {
+        if (isSpace(ch))
+            return ' ';
+        const lock = 1 - i / SIGNAL_TAIL;
+        return rand() < lock * lock ? ch : NOISE[Math.floor(rand() * NOISE.length)];
+    });
+}
+//# sourceMappingURL=arrivalModes.js.map

package/dist/fx/arrivalModes.js.map

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

package/dist/fx/tail.d.ts

@@ -0,0 +1,16 @@
+import type { ArrivalEffect } from '../arrivalEffect';
+export declare const TAIL_MAX = 14;
+/** A random glyph standing in for `ch` under `effect`; whitespace stays a space,
+ * and an effect without glyphs returns `ch` itself. */
+export declare function glyphFor(effect: ArrivalEffect, ch: string, rand?: () => number): string;
+/** One glyph per pending character (spaces kept), capped at TAIL_MAX. Effects
+ * without a glyph tail return none. */
+export declare function tailGlyphs(effect: ArrivalEffect, pending: string, rand?: () => number): string[];
+/** The element to append the tail to: the deepest last element of the newest
+ * block. Null when the newest block is one the tail must not enter (a code
+ * block still streaming), so no tail is drawn at all rather than one in the
+ * wrong place. */
+export declare function tailHost(root: Element, opts?: {
+    outsideInline?: boolean;
+}): Element | null;
+//# sourceMappingURL=tail.d.ts.map

package/dist/fx/tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["../../fx/tail.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,eAAO,MAAM,QAAQ,KAAK,CAAC;AAQ3B;uDACuD;AACvD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,MAAoB,GAAG,MAAM,CAIpG;AAED;uCACuC;AACvC,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,MAAoB,GAAG,MAAM,EAAE,CAG7G;AAQD;;;kBAGkB;AAClB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,GAAG,IAAI,CAkB9F"}

package/dist/fx/tail.js

@@ -0,0 +1,54 @@
+export const TAIL_MAX = 14;
+const KATAKANA = 'ｦｧｨｩｪｫｬｭｮｯｱｲｳｴｵｶｷｸｹｺｻｼｽｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚﾛﾜﾝ0123456789';
+const FLAP = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+const DECODE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+const ALPHABET = { matrix: KATAKANA, splitflap: FLAP, decode: DECODE };
+/** A random glyph standing in for `ch` under `effect`; whitespace stays a space,
+ * and an effect without glyphs returns `ch` itself. */
+export function glyphFor(effect, ch, rand = Math.random) {
+    const set = ALPHABET[effect];
+    if (!set)
+        return ch;
+    return /\s/.test(ch) ? ' ' : set[Math.floor(rand() * set.length)];
+}
+/** One glyph per pending character (spaces kept), capped at TAIL_MAX. Effects
+ * without a glyph tail return none. */
+export function tailGlyphs(effect, pending, rand = Math.random) {
+    if (!ALPHABET[effect])
+        return [];
+    return [...pending.slice(0, TAIL_MAX)].map((ch) => glyphFor(effect, ch, rand));
+}
+// Blocks the tail must never enter: it would read as part of the code, or break
+// the element's layout.
+const STOP = new Set(['PRE', 'TABLE', 'IMG', 'SVG', 'svg', 'HR', 'BR']);
+// Inline formatting a band tail stays outside of.
+const INLINE = new Set(['STRONG', 'B', 'EM', 'I', 'A', 'DEL', 'S', 'U', 'MARK', 'SPAN', 'SUB', 'SUP', 'SMALL', 'KBD']);
+/** The element to append the tail to: the deepest last element of the newest
+ * block. Null when the newest block is one the tail must not enter (a code
+ * block still streaming), so no tail is drawn at all rather than one in the
+ * wrong place. */
+export function tailHost(root, opts = {}) {
+    let el = root.querySelector('.agent-md') ?? root;
+    for (;;) {
+        // The last thing that is not blank. Descend only while it is an element:
+        // when text follows inline markup ("Use <code>x</code> then more") the
+        // tail belongs after that text, in this element, not inside the markup.
+        let last = el.lastChild;
+        while (last && last.nodeType === Node.TEXT_NODE && !last.textContent?.trim())
+            last = last.previousSibling;
+        if (!last || last.nodeType !== Node.ELEMENT_NODE)
+            return el;
+        const child = last;
+        if (STOP.has(child.tagName))
+            return null;
+        // Inline code that ends a line: the tail goes after it, never inside it.
+        if (child.tagName === 'CODE')
+            return el;
+        // Band tails (real words, not glyphs) go after inline formatting, never
+        // inside it: inside <strong> they would read bold, inside <a> clickable.
+        if (opts.outsideInline && INLINE.has(child.tagName))
+            return el;
+        el = child;
+    }
+}
+//# sourceMappingURL=tail.js.map

package/dist/fx/tail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.js","sourceRoot":"","sources":["../../fx/tail.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAE3B,MAAM,QAAQ,GAAG,mEAAmE,CAAC;AACrF,MAAM,IAAI,GAAG,sCAAsC,CAAC;AACpD,MAAM,MAAM,GAAG,gEAAgE,CAAC;AAEhF,MAAM,QAAQ,GAA2C,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAE/G;uDACuD;AACvD,MAAM,UAAU,QAAQ,CAAC,MAAqB,EAAE,EAAU,EAAE,OAAqB,IAAI,CAAC,MAAM;IAC1F,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;uCACuC;AACvC,MAAM,UAAU,UAAU,CAAC,MAAqB,EAAE,OAAe,EAAE,OAAqB,IAAI,CAAC,MAAM;IACjG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,gFAAgF;AAChF,wBAAwB;AACxB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACxE,kDAAkD;AAClD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAEvH;;;kBAGkB;AAClB,MAAM,UAAU,QAAQ,CAAC,IAAa,EAAE,OAAoC,EAAE;IAC5E,IAAI,EAAE,GAAY,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;IAC1D,SAAS,CAAC;QACR,yEAAyE;QACzE,uEAAuE;QACvE,wEAAwE;QACxE,IAAI,IAAI,GAAqB,EAAE,CAAC,SAAS,CAAC;QAC1C,OAAO,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE;YAAE,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC;QAC1G,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,IAAe,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,yEAAyE;QACzE,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM;YAAE,OAAO,EAAE,CAAC;QACxC,wEAAwE;QACxE,yEAAyE;QACzE,IAAI,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,CAAC;QAC/D,EAAE,GAAG,KAAK,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/fx/useReveal.d.ts

@@ -0,0 +1,2 @@
+export declare function useReveal(text: string, active: boolean, minStep?: number, start?: number): number;
+//# sourceMappingURL=useReveal.d.ts.map

package/dist/fx/useReveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReveal.d.ts","sourceRoot":"","sources":["../../fx/useReveal.ts"],"names":[],"mappings":"AAiBA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAE,MAAiB,EAAE,KAAK,SAAI,GAAG,MAAM,CA2CtG"}

package/dist/fx/useReveal.js

@@ -0,0 +1,59 @@
+/* Paced reveal for arrival effects: how much of the streamed answer to show.
+ *
+ * About 60 characters a second (callers can go slower), but never more than
+ * about 2.5 s behind: when the text grows, the pace is re-derived so the whole
+ * backlog clears within CATCH_UP_TICKS. A fixed rate per backlog, not a
+ * fraction of what is left: a fraction decays geometrically.
+ *
+ * ONE timer for the life of the reveal. The live answer re-renders on every
+ * streamed delta, often faster than a tick; a timer keyed on the text was
+ * cleared and restarted by each delta and never got to tick. The text's
+ * length and the pace live in refs the timer reads instead. */
+import { useEffect, useLayoutEffect, useRef, useState } from 'react';
+const TICK_MS = 33;
+const MIN_STEP = 2; // ~60 cps
+const CATCH_UP_TICKS = 75; // ~2.5 s
+export function useReveal(text, active, minStep = MIN_STEP, start = 0) {
+    // `start`: a hand-off resumes where the in-progress turn left off.
+    const [shown, setShown] = useState(start);
+    const [prevLen, setPrevLen] = useState(text.length);
+    const shownRef = useRef(start);
+    const lenRef = useRef(text.length);
+    const stepRef = useRef(minStep);
+    shownRef.current = shown;
+    // Switched on mid-answer: keep what is already shown, reveal only what
+    // arrives next. Starting from 0 would blank the answer and replay it.
+    const [prevActive, setPrevActive] = useState(active);
+    if (active !== prevActive) {
+        setPrevActive(active);
+        if (active)
+            setShown(text.length);
+    }
+    // A shorter text is a new answer: start it from the beginning.
+    if (text.length !== prevLen) {
+        setPrevLen(text.length);
+        if (text.length < prevLen)
+            setShown(0);
+    }
+    // Re-derive the pace whenever the text changes.
+    useLayoutEffect(() => {
+        lenRef.current = text.length;
+        const from = text.length < shownRef.current ? 0 : shownRef.current;
+        stepRef.current = Math.max(minStep, Math.floor((text.length - from) / CATCH_UP_TICKS));
+    }, [text, minStep]);
+    useEffect(() => {
+        if (!active)
+            return;
+        const id = setInterval(() => {
+            setShown((s) => {
+                const len = lenRef.current;
+                return s >= len ? s : Math.min(len, s + stepRef.current);
+            });
+        }, TICK_MS);
+        return () => clearInterval(id);
+    }, [active]);
+    if (!active)
+        return text.length;
+    return Math.min(shown, text.length);
+}
+//# sourceMappingURL=useReveal.js.map

package/dist/fx/useReveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReveal.js","sourceRoot":"","sources":["../../fx/useReveal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;+DAU+D;AAC/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAErE,MAAM,OAAO,GAAG,EAAE,CAAC;AACnB,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,UAAU;AAC9B,MAAM,cAAc,GAAG,EAAE,CAAC,CAAC,SAAS;AAEpC,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAAe,EAAE,UAAkB,QAAQ,EAAE,KAAK,GAAG,CAAC;IAC5F,mEAAmE;IACnE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IAEzB,uEAAuE;IACvE,sEAAsE;IACtE,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,aAAa,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,+DAA+D;IAC/D,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC5B,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO;YAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,gDAAgD;IAChD,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;IACzF,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE;YAC1B,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;gBACb,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;gBAC3B,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC;IAChC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/observed.d.ts

@@ -0,0 +1,16 @@
+import type { TurnVerificationCounts } from '@corenel/protocol';
+/** Fixed-order, non-zero segments: "2 writes confirmed", "1 didn't take", … */
+export declare function observedSegments(c: TurnVerificationCounts): string[];
+/** "Observed: 2 writes confirmed · 1 didn't take · …" — zero segments omitted,
+ * fixed order. Shared with the timeline marker label. */
+export declare function observedSummary(c: TurnVerificationCounts): string;
+/** The label for a run whose audit log lost entries or could not confirm them
+ * written -- shared by the transcript's Observed row and the editor Run
+ * surface so both say it the same way. A known loss is stated as a count --
+ * a lower bound when the finish also timed out, so it says "possibly more";
+ * a finish that timed out with nothing known lost says it could not confirm. */
+export declare function auditIncompleteText(a: {
+    lost: number;
+    unconfirmed?: boolean;
+}): string;
+//# sourceMappingURL=observed.d.ts.map

package/dist/observed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed.d.ts","sourceRoot":"","sources":["../observed.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAQpE;AAED;yDACyD;AACzD,wBAAgB,eAAe,CAAC,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAEjE;AAED;;;;gFAIgF;AAChF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAMtF"}

package/dist/observed.js

@@ -0,0 +1,33 @@
+/** Fixed-order, non-zero segments: "2 writes confirmed", "1 didn't take", … */
+export function observedSegments(c) {
+    const seg = [];
+    if (c.confirmed)
+        seg.push(`${c.confirmed} ${c.confirmed === 1 ? 'write' : 'writes'} confirmed`);
+    if (c.didNotTake)
+        seg.push(`${c.didNotTake} didn't take`);
+    if (c.failed)
+        seg.push(`${c.failed} failed`);
+    if (c.denied)
+        seg.push(`${c.denied} denied`);
+    if (c.unverifiable)
+        seg.push(`${c.unverifiable} unverifiable`);
+    return seg;
+}
+/** "Observed: 2 writes confirmed · 1 didn't take · …" — zero segments omitted,
+ * fixed order. Shared with the timeline marker label. */
+export function observedSummary(c) {
+    return `Observed: ${observedSegments(c).join(' · ')}`;
+}
+/** The label for a run whose audit log lost entries or could not confirm them
+ * written -- shared by the transcript's Observed row and the editor Run
+ * surface so both say it the same way. A known loss is stated as a count --
+ * a lower bound when the finish also timed out, so it says "possibly more";
+ * a finish that timed out with nothing known lost says it could not confirm. */
+export function auditIncompleteText(a) {
+    if (a.lost > 0) {
+        const more = a.unconfirmed ? ', possibly more' : '';
+        return `Audit incomplete (${a.lost} ${a.lost === 1 ? 'entry' : 'entries'} not recorded${more})`;
+    }
+    return 'Audit incomplete (could not confirm entries were recorded)';
+}
+//# sourceMappingURL=observed.js.map

package/dist/observed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed.js","sourceRoot":"","sources":["../observed.ts"],"names":[],"mappings":"AAMA,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,CAAyB;IACxD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,CAAC,SAAS;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,YAAY,CAAC,CAAC;IAChG,IAAI,CAAC,CAAC,UAAU;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,cAAc,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC,MAAM;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,MAAM;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,YAAY;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,eAAe,CAAC,CAAC;IAC/D,OAAO,GAAG,CAAC;AACb,CAAC;AAED;yDACyD;AACzD,MAAM,UAAU,eAAe,CAAC,CAAyB;IACvD,OAAO,aAAa,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;;;gFAIgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,CAA0C;IAC5E,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,qBAAqB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,gBAAgB,IAAI,GAAG,CAAC;IAClG,CAAC;IACD,OAAO,4DAA4D,CAAC;AACtE,CAAC"}

package/dist/toolRender.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { ArrivalEffect } from './arrivalEffect';
 /** A tool call normalized for rendering — surface-agnostic. */
 export interface ToolInvocation {
     name: string;
@@ -13,19 +14,22 @@ type ToolStatus = 'running' | 'ok' | 'warn' | 'error';
 export declare function toolStatusOf(name: string, result: string, isError: boolean): ToolStatus;
 /** One tool's glanceable status line. Shared by the card header, the summary
  * renderer, and AgentPanel's live (in-flight) list so a call resolves in place. */
-export declare function ToolLine({ name, args, result, isError, running, ms }: {
+export declare function ToolLine({ name, args, result, isError, running, ms, nameFx }: {
     name: string;
     args: Record<string, unknown>;
     result?: string;
     isError?: boolean;
     running?: boolean;
     ms?: number;
+    /** Animate the name in once (live turn under an arrival effect). */
+    nameFx?: ArrivalEffect;
 }): React.JSX.Element;
 /** STANDARD tool renderer (normal + expanded): a collapsible card. `defaultOpen`
  * is the only difference between the two views — expanded opens every card. */
-export declare function ToolResultCard({ inv, defaultOpen }: {
+export declare function ToolResultCard({ inv, defaultOpen, nameFx }: {
     inv: ToolInvocation;
     defaultOpen?: boolean;
+    nameFx?: ArrivalEffect;
 }): React.JSX.Element;
 /** The expandable body of a tool invocation — arguments (JSON) + the rich result
  * renderer. Shared by ToolResultCard and any other surface that wants the SAME

package/dist/toolRender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolRender.d.ts","sourceRoot":"","sources":["../toolRender.tsx"],"names":[],"mappings":"AAcA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAUnD,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,KAAK,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAiEtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAQvF;AA0BD;mFACmF;AACnF,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE;IACrE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACjH,qBA0BA;AAED;+EAC+E;AAC/E,wBAAgB,cAAc,CAAC,EAAE,GAAG,EAAE,WAAmB,EAAE,EAAE;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,qBAc1G;AAED;;wEAEwE;AACxE,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,qBAYnH"}
+{"version":3,"file":"toolRender.d.ts","sourceRoot":"","sources":["../toolRender.tsx"],"names":[],"mappings":"AAcA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAKnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOrD,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,KAAK,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAoEtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAQvF;AA0BD;mFACmF;AACnF,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAe,EAAE,EAAE;IACtF,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAChH,oEAAoE;IACpE,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,qBA0BA;AAED;+EAC+E;AAC/E,wBAAgB,cAAc,CAAC,EAAE,GAAG,EAAE,WAAmB,EAAE,MAAe,EAAE,EAAE;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAAE,qBAcnJ;AAED;;wEAEwE;AACxE,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,qBAYnH"}