@reticlehq/browser 2.0.0

package/dist/review/annotator.js

@@ -0,0 +1,321 @@
+import { EventType } from '@reticlehq/core';
+import { resolveMarkAnchor } from './mark-anchor.js';
+import { nativeSetTimeout, nativeClearTimeout } from '../timers/native-timers.js';
+/** The cursor must rest this long before the outline boxes the element under it — calm, not jumpy. */
+const HIGHLIGHT_REST_MS = 130;
+/** Single base attribute on every UI node (varied by VALUE) so `closest('[data-reticle-mark]')`
+ *  catches the FAB, popover, and pins in one check, and the SDK's observers ignore them all. */
+const MARK_ATTR = 'data-reticle-mark';
+const ACTIVE_ATTR = 'data-reticle-mark-active';
+const Z = 2147483640;
+const sel = (role) => `[${MARK_ATTR}="${role}"]`;
+const CSS = `
+${sel('fab')}{position:fixed;left:18px;bottom:18px;z-index:${String(Z + 2)};
+  font:500 13px/1 "Inter",system-ui,sans-serif;display:inline-flex;align-items:center;gap:7px;
+  padding:9px 13px;border-radius:11px;cursor:pointer;color:#e9ebf2;
+  background:linear-gradient(180deg,rgba(19,22,32,.92),rgba(13,15,22,.92));
+  border:1px solid rgba(255,255,255,.12);box-shadow:0 10px 30px -10px rgba(0,0,0,.6);
+  -webkit-backdrop-filter:blur(20px);backdrop-filter:blur(20px);transition:transform .12s,border-color .15s;}
+${sel('fab')}:hover{transform:translateY(-1px);border-color:rgba(124,131,255,.55);}
+${sel('fab')}[data-on="1"]{color:#fff;border-color:#7c83ff;background:linear-gradient(180deg,#6366f1,#4f46e5);}
+${sel('dot')}{width:8px;height:8px;border-radius:50%;background:#ff7a7a;flex:none;}
+${sel('fab')}[data-on="1"] ${sel('dot')}{background:#fff;}
+html[${ACTIVE_ATTR}] *{cursor:crosshair !important;}
+/* The Flag button + its popover are interactive — keep the pointer cursor over them, not crosshair. */
+html[${ACTIVE_ATTR}] ${sel('fab')},html[${ACTIVE_ATTR}] ${sel('fab')} *,html[${ACTIVE_ATTR}] ${sel('pop')},html[${ACTIVE_ATTR}] ${sel('pop')} *{cursor:pointer !important;}
+/* The outline glides to the rested element with an ease (soothing), and fades rather than snapping. */
+${sel('hi')}{position:fixed;z-index:${String(Z + 1)};pointer-events:none;opacity:0;box-sizing:border-box;
+  border:2px solid #7c83ff;border-radius:6px;background:rgba(124,131,255,.12);box-shadow:0 0 0 2px rgba(124,131,255,.22);
+  transition:left .22s cubic-bezier(.22,1,.36,1),top .22s cubic-bezier(.22,1,.36,1),width .22s cubic-bezier(.22,1,.36,1),height .22s cubic-bezier(.22,1,.36,1),opacity .18s ease;}
+${sel('hi')}[data-on="1"]{opacity:1;}
+${sel('hilabel')}{position:absolute;top:-21px;left:-2px;background:#6366f1;color:#fff;
+  font:600 10.5px/1 "Inter",system-ui,sans-serif;padding:3px 6px;border-radius:5px;white-space:nowrap;
+  max-width:300px;overflow:hidden;text-overflow:ellipsis;}
+${sel('pin')}{position:fixed;z-index:${String(Z + 1)};width:22px;height:22px;margin:-11px 0 0 -11px;
+  border-radius:50% 50% 50% 2px;background:#ff5d5d;border:2px solid #fff;box-shadow:0 4px 12px -2px rgba(0,0,0,.5);
+  color:#fff;font:700 11px/18px "Inter",system-ui,sans-serif;text-align:center;pointer-events:none;}
+${sel('pop')}{position:fixed;z-index:${String(Z + 3)};width:280px;box-sizing:border-box;
+  background:linear-gradient(180deg,rgba(19,22,32,.96),rgba(13,15,22,.96));border:1px solid rgba(255,255,255,.14);
+  border-radius:14px;padding:12px;box-shadow:0 24px 60px -16px rgba(0,0,0,.7);
+  -webkit-backdrop-filter:blur(24px);backdrop-filter:blur(24px);font:13px/1.5 "Inter",system-ui,sans-serif;color:#e9ebf2;}
+${sel('pop')} .reticle-mark-where{color:#9aa0b2;font-size:11.5px;margin-bottom:7px;
+  white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}
+${sel('pop')} textarea{width:100%;box-sizing:border-box;min-height:62px;resize:vertical;
+  background:rgba(0,0,0,.3);border:1px solid rgba(255,255,255,.12);border-radius:9px;color:#e9ebf2;
+  font:13px/1.45 "Inter",system-ui,sans-serif;padding:8px;outline:none;}
+${sel('pop')} textarea:focus{border-color:#7c83ff;}
+${sel('pop')} .reticle-mark-row{display:flex;gap:8px;align-items:center;margin-top:9px;}
+${sel('pop')} .reticle-mark-hint{margin-right:auto;color:#6a7186;font-size:10.5px;letter-spacing:.02em;}
+${sel('pop')} button{font:600 12px/1 "Inter",system-ui,sans-serif;padding:8px 12px;border-radius:9px;cursor:pointer;border:1px solid rgba(255,255,255,.12);background:rgba(255,255,255,.05);color:#cdd2e2;}
+${sel('pop')} button[data-send]{background:#6366f1;border-color:#7c83ff;color:#fff;}
+${sel('pop')} button[data-send]:disabled{opacity:.5;cursor:default;}`;
+export class Annotator {
+    #emit;
+    #now;
+    #onMark;
+    #root;
+    #fab;
+    #pop;
+    /** Hover outline box that shows WHICH element a click would flag (agentation-style). */
+    #hi;
+    #hiLabel;
+    /** Debounce timer — boxes the element only once the cursor rests, so a fast sweep doesn't flicker. */
+    #hiTimer;
+    #active = false;
+    #markCount = 0;
+    #onClick;
+    #onKeydown;
+    #onMove;
+    constructor(deps) {
+        this.#emit = deps.emit;
+        this.#now = deps.now;
+        this.#onMark = deps.onMark;
+    }
+    /** Whether annotate mode is currently capturing clicks. */
+    get active() {
+        return this.#active;
+    }
+    /** Number of marks sent this session (drives the pin numbering). */
+    get markCount() {
+        return this.#markCount;
+    }
+    mount() {
+        if (this.#root !== undefined || typeof document === 'undefined')
+            return;
+        const style = document.createElement('style');
+        style.setAttribute(MARK_ATTR, 'style');
+        style.textContent = CSS;
+        document.head.appendChild(style);
+        const root = document.createElement('div');
+        root.setAttribute(MARK_ATTR, 'root');
+        root.innerHTML = `<button type="button" ${MARK_ATTR}="fab" aria-label="Flag a bug for the agent">
+      <span ${MARK_ATTR}="dot"></span><span>Flag a bug</span></button>
+      <div ${MARK_ATTR}="hi"><span ${MARK_ATTR}="hilabel"></span></div>`;
+        document.body.appendChild(root);
+        this.#root = root;
+        this.#fab = root.querySelector(sel('fab')) ?? undefined;
+        this.#hi = root.querySelector(sel('hi')) ?? undefined;
+        this.#hiLabel = root.querySelector(sel('hilabel')) ?? undefined;
+        this.#fab?.addEventListener('click', (e) => {
+            e.stopPropagation();
+            this.toggle();
+        });
+        // Capture-phase click: intercept the FIRST click on a real page element while active.
+        this.#onClick = (ev) => this.#handleClick(ev);
+        document.addEventListener('click', this.#onClick, { capture: true });
+        // Hover outline: while active, box the element a click would flag — so you see what you're pointing at.
+        this.#onMove = (ev) => this.#scheduleMove(ev);
+        document.addEventListener('mousemove', this.#onMove, { passive: true, capture: true });
+        // Escape is the universal "back out": close an open popover, else leave annotate mode.
+        this.#onKeydown = (ev) => {
+            if (ev.key !== 'Escape' || !this.#active)
+                return;
+            if (this.#pop !== undefined)
+                this.#closePopover();
+            else
+                this.toggle(false);
+        };
+        document.addEventListener('keydown', this.#onKeydown);
+    }
+    destroy() {
+        if (this.#onClick !== undefined) {
+            document.removeEventListener('click', this.#onClick, { capture: true });
+            this.#onClick = undefined;
+        }
+        if (this.#onKeydown !== undefined) {
+            document.removeEventListener('keydown', this.#onKeydown);
+            this.#onKeydown = undefined;
+        }
+        if (this.#onMove !== undefined) {
+            document.removeEventListener('mousemove', this.#onMove, { capture: true });
+            this.#onMove = undefined;
+        }
+        if (this.#hiTimer !== undefined) {
+            nativeClearTimeout(this.#hiTimer);
+            this.#hiTimer = undefined;
+        }
+        this.#closePopover();
+        document.documentElement.removeAttribute(ACTIVE_ATTR);
+        this.#root?.remove();
+        document.querySelectorAll(`style[${MARK_ATTR}="style"]`).forEach((s) => s.remove());
+        this.#root = undefined;
+        this.#fab = undefined;
+        this.#active = false;
+    }
+    /** Turn annotate mode on/off. With no argument, flips the current state. */
+    toggle(on) {
+        this.#active = on ?? !this.#active;
+        this.#fab?.setAttribute('data-on', this.#active ? '1' : '0');
+        if (this.#active)
+            document.documentElement.setAttribute(ACTIVE_ATTR, '1');
+        else {
+            document.documentElement.removeAttribute(ACTIVE_ATTR);
+            this.#hideHighlight();
+            this.#closePopover();
+        }
+    }
+    #handleClick(ev) {
+        if (!this.#active)
+            return;
+        const target = ev.target;
+        if (!(target instanceof Element))
+            return;
+        if (target.closest(`[${MARK_ATTR}]`) !== null)
+            return; // never mark our own UI
+        ev.preventDefault();
+        ev.stopPropagation();
+        this.#openPopover(target, ev.clientX, ev.clientY);
+    }
+    /**
+     * Debounce the outline: while the cursor is moving the human is still travelling, so we wait for a
+     * brief rest before boxing the element under it (the box then eases into place via CSS). A pending
+     * timer is replaced on every move, so only the resting position ever paints.
+     */
+    #scheduleMove(ev) {
+        if (this.#hiTimer !== undefined)
+            nativeClearTimeout(this.#hiTimer);
+        this.#hiTimer = nativeSetTimeout(() => {
+            this.#hiTimer = undefined;
+            this.#handleMove(ev);
+        }, HIGHLIGHT_REST_MS);
+    }
+    /** Box the element under the cursor (when active, no popover open) so you see what a click flags. */
+    #handleMove(ev) {
+        if (this.#hi === undefined)
+            return;
+        const target = ev.target;
+        const skip = !this.#active ||
+            this.#pop !== undefined ||
+            !(target instanceof Element) ||
+            target.closest(`[${MARK_ATTR}]`) !== null;
+        if (skip) {
+            this.#hi.setAttribute('data-on', '0');
+            return;
+        }
+        const rect = target.getBoundingClientRect();
+        if (rect.width === 0 && rect.height === 0) {
+            this.#hi.setAttribute('data-on', '0');
+            return;
+        }
+        this.#hi.style.left = `${String(rect.left)}px`;
+        this.#hi.style.top = `${String(rect.top)}px`;
+        this.#hi.style.width = `${String(rect.width)}px`;
+        this.#hi.style.height = `${String(rect.height)}px`;
+        this.#hi.setAttribute('data-on', '1');
+        if (this.#hiLabel !== undefined)
+            this.#hiLabel.textContent = describeEl(target);
+    }
+    /** Hide the hover outline (annotate mode off, or a popover took over). Cancels any pending box. */
+    #hideHighlight() {
+        if (this.#hiTimer !== undefined) {
+            nativeClearTimeout(this.#hiTimer);
+            this.#hiTimer = undefined;
+        }
+        this.#hi?.setAttribute('data-on', '0');
+    }
+    #openPopover(el, x, y) {
+        this.#closePopover();
+        this.#hideHighlight(); // the popover is now the focus; drop the hover box
+        const resolved = resolveMarkAnchor(el);
+        const pop = document.createElement('div');
+        pop.setAttribute(MARK_ATTR, 'pop');
+        const where = resolved.source !== undefined
+            ? `${resolved.label} · ${resolved.source.file}:${String(resolved.source.line)}`
+            : resolved.label;
+        pop.innerHTML = `<div class="reticle-mark-where"></div>
+      <textarea placeholder="What's wrong here? The agent will read this and fix it."></textarea>
+      <div class="reticle-mark-row"><span class="reticle-mark-hint">⌘↵ send · esc cancel</span><button type="button" data-cancel>Cancel</button>
+      <button type="button" data-send disabled>Send to agent</button></div>`;
+        const whereEl = pop.querySelector('.reticle-mark-where');
+        if (whereEl !== null)
+            whereEl.textContent = where;
+        const left = Math.min(x, window.innerWidth - 296);
+        const top = Math.min(y + 12, window.innerHeight - 170);
+        pop.style.left = `${String(Math.max(8, left))}px`;
+        pop.style.top = `${String(Math.max(8, top))}px`;
+        document.body.appendChild(pop);
+        this.#pop = pop;
+        const textarea = pop.querySelector('textarea');
+        const send = pop.querySelector('button[data-send]');
+        const submit = () => {
+            const note = textarea?.value.trim() ?? '';
+            if (note.length === 0)
+                return; // never send an empty mark
+            this.#sendMark(note, resolved, x, y);
+            this.#closePopover();
+        };
+        textarea?.addEventListener('input', () => {
+            if (send !== null)
+                send.disabled = textarea.value.trim().length === 0;
+        });
+        // Keyboard ergonomics devs expect: ⌘/Ctrl+Enter sends, Esc cancels — without leaving the textarea.
+        textarea?.addEventListener('keydown', (e) => {
+            if (e.key === 'Escape') {
+                e.preventDefault();
+                this.#closePopover();
+            }
+            else if (e.key === 'Enter' && (e.metaKey || e.ctrlKey)) {
+                e.preventDefault();
+                submit();
+            }
+        });
+        textarea?.focus();
+        pop.querySelector('button[data-cancel]')?.addEventListener('click', () => this.#closePopover());
+        send?.addEventListener('click', submit);
+    }
+    #sendMark(note, resolved, x, y) {
+        const data = {
+            note,
+            anchor: resolved.anchor,
+            strategy: resolved.strategy,
+            label: resolved.label,
+            route: typeof location === 'undefined' ? '' : location.pathname + location.search,
+        };
+        if (resolved.source !== undefined)
+            data['source'] = resolved.source;
+        this.#emit(EventType.HUMAN_MARK, data);
+        this.#onMark?.(note, resolved.label); // echo into the live panel so the human sees the flag land
+        this.#markCount += 1;
+        this.#dropPin(x, y, this.#markCount);
+    }
+    #dropPin(x, y, n) {
+        if (this.#root === undefined)
+            return;
+        const pin = document.createElement('div');
+        pin.setAttribute(MARK_ATTR, 'pin');
+        pin.style.left = `${String(x)}px`;
+        pin.style.top = `${String(y)}px`;
+        pin.textContent = String(n);
+        this.#root.appendChild(pin);
+        // The pin fades after a moment so it confirms the mark landed without cluttering the page.
+        const ref = pin;
+        this.#now(); // touch the injected clock (kept for parity with the SDK's timing seams)
+        window.setTimeout(() => ref.remove(), 2600);
+    }
+    #closePopover() {
+        this.#pop?.remove();
+        this.#pop = undefined;
+    }
+}
+/**
+ * A short label for the hovered element — testid > aria-label > tag + text. Cheap on purpose (runs
+ * on every mousemove, so it does NOT call resolveMarkAnchor; the full anchor is resolved on click).
+ */
+function describeEl(el) {
+    const testid = el.getAttribute('data-testid');
+    if (testid !== null && testid.length > 0)
+        return testid;
+    const tag = el.tagName.toLowerCase();
+    const aria = el.getAttribute('aria-label');
+    if (aria !== null && aria.length > 0)
+        return `${tag} "${aria}"`;
+    const text = (el.textContent ?? '').trim().replace(/\s+/g, ' ').slice(0, 40);
+    return text.length > 0 ? `${tag} "${text}"` : tag;
+}
+/** Construct + mount the annotator (mirrors installRecorder's ergonomics). */
+export function installAnnotator(deps) {
+    const annotator = new Annotator(deps);
+    annotator.mount();
+    return annotator;
+}
+//# sourceMappingURL=annotator.js.map

package/dist/review/annotator.js.map

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

package/dist/review/mark-anchor.d.ts

@@ -0,0 +1,23 @@
+import { MarkAnchorStrategy } from '@reticlehq/core';
+/**
+ * The element address carried by a human review mark: a re-resolvable anchor (auto-anchor's most
+ * durable tier for this element), its durability strategy, a human-legible label, and — crucially —
+ * the source file:line the agent should open. Source is reported INDEPENDENTLY of the anchor tier:
+ * a role-anchored element still carries its babel-stamped source so the agent can jump to the code.
+ */
+export interface MarkAnchor {
+    anchor: string;
+    strategy: MarkAnchorStrategy;
+    label: string;
+    source?: {
+        file: string;
+        line: number;
+    };
+}
+/**
+ * Resolve a clicked element into the address a human review mark carries. Reuses the same
+ * auto-anchor machinery a recorded flow uses, so a mark pins to the element the way Reticle addresses
+ * it everywhere else — and always reports the source file:line when one is available.
+ */
+export declare function resolveMarkAnchor(el: Element): MarkAnchor;
+//# sourceMappingURL=mark-anchor.d.ts.map

package/dist/review/mark-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-anchor.d.ts","sourceRoot":"","sources":["../../src/review/mark-anchor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AASrD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAqCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,GAAG,UAAU,CAuBzD"}

package/dist/review/mark-anchor.js

@@ -0,0 +1,74 @@
+import { MarkAnchorStrategy } from '@reticlehq/core';
+import { AnchorStrategy, synthesizeAnchor } from '../dom/auto-anchor.js';
+import { getAccessibleName, getRole } from '../dom/a11y.js';
+import { identifyComponent } from '../registry/adapters.js';
+/** Attribute names — defined locally per the recorder/query convention (no shared free string). */
+const TESTID_ATTR = 'data-testid';
+const SOURCE_ATTR = 'data-reticle-source';
+/** AnchorStrategy and MarkAnchorStrategy share string values; map explicitly (no cross-cast). */
+const STRATEGY = {
+    [AnchorStrategy.TESTID]: MarkAnchorStrategy.TESTID,
+    [AnchorStrategy.COMPONENT]: MarkAnchorStrategy.COMPONENT,
+    [AnchorStrategy.ROLE]: MarkAnchorStrategy.ROLE,
+    [AnchorStrategy.POSITION]: MarkAnchorStrategy.POSITION,
+};
+/** Parse a `data-reticle-source="file:line:column"` value into `{ file, line }` (column dropped). */
+function parseSourceAttr(value) {
+    if (value === null)
+        return undefined;
+    const m = /^(.*):(\d+):(\d+)$/.exec(value);
+    if (m === null)
+        return undefined;
+    const file = m[1];
+    const line = Number(m[2]);
+    if (file === undefined || file.length === 0 || !Number.isFinite(line))
+        return undefined;
+    return { file, line };
+}
+/** Best source for the element: the framework adapter's, else the nearest babel-stamped attribute. */
+function sourceFor(el, adapterSource) {
+    if (adapterSource !== undefined)
+        return { file: adapterSource.file, line: adapterSource.line };
+    const host = el.closest(`[${SOURCE_ATTR}]`);
+    return host !== null ? parseSourceAttr(host.getAttribute(SOURCE_ATTR)) : undefined;
+}
+/** A short, human-legible label for the element: `role "name"`, falling back to role / tag name. */
+function labelFor(el, role, name) {
+    if (name.length > 0)
+        return role.length > 0 ? `${role} "${name}"` : `"${name}"`;
+    return role.length > 0 ? role : el.tagName.toLowerCase();
+}
+/**
+ * Resolve a clicked element into the address a human review mark carries. Reuses the same
+ * auto-anchor machinery a recorded flow uses, so a mark pins to the element the way Reticle addresses
+ * it everywhere else — and always reports the source file:line when one is available.
+ */
+export function resolveMarkAnchor(el) {
+    const testid = el.getAttribute(TESTID_ATTR) ?? undefined;
+    const info = identifyComponent(el);
+    const component = info?.componentStack[0];
+    const source = sourceFor(el, info?.source);
+    const role = getRole(el);
+    const name = getAccessibleName(el);
+    const input = {};
+    if (testid !== undefined)
+        input.testid = testid;
+    if (component !== undefined)
+        input.component = component;
+    if (source !== undefined)
+        input.source = source;
+    if (role.length > 0)
+        input.role = role;
+    if (name.length > 0)
+        input.name = name;
+    const synthesized = synthesizeAnchor(input);
+    const out = {
+        anchor: synthesized.value,
+        strategy: STRATEGY[synthesized.strategy],
+        label: labelFor(el, role, name),
+    };
+    if (source !== undefined)
+        out.source = source;
+    return out;
+}
+//# sourceMappingURL=mark-anchor.js.map

package/dist/review/mark-anchor.js.map

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

package/dist/security/serialization.d.ts

@@ -0,0 +1,6 @@
+export declare function isSensitiveKey(key: string): boolean;
+/** Convert arbitrary app state into a bounded, redacted JSON-compatible value. */
+export declare function sanitizeForTransport(value: unknown): unknown;
+/** Serialize without allowing cycles, BigInt, getters, or secrets to break the transport. */
+export declare function safeStringify(value: unknown): string;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/security/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/security/serialization.ts"],"names":[],"mappings":"AAgBA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAmFD,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAW5D;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMpD"}

package/dist/security/serialization.js

@@ -0,0 +1,103 @@
+import { REDACTED_VALUE, TRANSPORT_LIMITS } from '@reticlehq/core';
+const TRUNCATED_VALUE = '[TRUNCATED]';
+const UNSERIALIZABLE_VALUE = '[UNSERIALIZABLE]';
+const OMIT_VALUE = Symbol('omit');
+const MAX_KEY_LENGTH = 256;
+const MAX_TOTAL_CHARACTERS = Math.floor(TRANSPORT_LIMITS.MAX_MESSAGE_BYTES / 8);
+const MAX_TOTAL_NODES = TRANSPORT_LIMITS.MAX_COLLECTION_ITEMS * 5;
+// `token` must match auth CREDENTIALS, not compound design fields. Bare/separated `token(s)` and
+// auth-prefixed tokens (accessToken, auth_token, sessionToken, …) are redacted; `colorToken`,
+// `backgroundToken`, `tokenCount`, `designToken` are NOT — they were false-positives that redacted
+// legitimate reticle_inspect/reticle_state output.
+const SENSITIVE_KEY = /password|passwd|passcode|secret|(?:(?:access|refresh|auth|bearer|api|id|session|csrf|client)[-_]?tokens?|(?:^|[-_])tokens?(?=$|[-_]))|authorization|api[-_]?key|access[-_]?key|private[-_]?key|client[-_]?secret|credit[-_]?card|card[-_]?number|cvv|cvc|ssn/i;
+export function isSensitiveKey(key) {
+    return SENSITIVE_KEY.test(key);
+}
+function boundedString(value, state, max) {
+    const allowed = Math.max(0, Math.min(max, state.remainingCharacters));
+    if (value.length <= allowed) {
+        state.remainingCharacters -= value.length;
+        return value;
+    }
+    const truncated = allowed <= TRUNCATED_VALUE.length
+        ? TRUNCATED_VALUE.slice(0, allowed)
+        : `${value.slice(0, allowed - TRUNCATED_VALUE.length)}${TRUNCATED_VALUE}`;
+    state.remainingCharacters -= truncated.length;
+    return truncated;
+}
+function sanitize(value, state, depth, key) {
+    if (key !== undefined && isSensitiveKey(key))
+        return REDACTED_VALUE;
+    if (depth > TRANSPORT_LIMITS.MAX_SERIALIZE_DEPTH || state.nodes >= MAX_TOTAL_NODES) {
+        return TRUNCATED_VALUE;
+    }
+    state.nodes += 1;
+    if (value === null || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'string') {
+        return boundedString(value, state, key?.toLowerCase() === 'error'
+            ? TRANSPORT_LIMITS.MAX_ERROR_LENGTH
+            : TRANSPORT_LIMITS.MAX_STRING_LENGTH);
+    }
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : null;
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (typeof value === 'undefined' || typeof value === 'function' || typeof value === 'symbol') {
+        return OMIT_VALUE;
+    }
+    if (value instanceof Date)
+        return value.toISOString();
+    if (value instanceof Error) {
+        return {
+            name: boundedString(value.name, state, 256),
+            message: boundedString(value.message, state, TRANSPORT_LIMITS.MAX_ERROR_LENGTH),
+        };
+    }
+    if (state.seen.has(value))
+        return '[CIRCULAR]';
+    state.seen.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return value.slice(0, TRANSPORT_LIMITS.MAX_COLLECTION_ITEMS).map((item) => {
+                const sanitized = sanitize(item, state, depth + 1);
+                return sanitized === OMIT_VALUE ? null : sanitized;
+            });
+        }
+        const out = Object.create(null);
+        for (const rawKey of Object.keys(value).slice(0, TRANSPORT_LIMITS.MAX_OBJECT_KEYS)) {
+            const safeKey = boundedString(rawKey, state, MAX_KEY_LENGTH);
+            try {
+                const sanitized = sanitize(value[rawKey], state, depth + 1, rawKey);
+                if (sanitized !== OMIT_VALUE)
+                    out[safeKey] = sanitized;
+            }
+            catch {
+                out[safeKey] = UNSERIALIZABLE_VALUE;
+            }
+        }
+        return out;
+    }
+    finally {
+        state.seen.delete(value);
+    }
+}
+/** Convert arbitrary app state into a bounded, redacted JSON-compatible value. */
+export function sanitizeForTransport(value) {
+    const sanitized = sanitize(value, {
+        seen: new WeakSet(),
+        remainingCharacters: MAX_TOTAL_CHARACTERS,
+        nodes: 0,
+    }, 0);
+    return sanitized === OMIT_VALUE ? null : sanitized;
+}
+/** Serialize without allowing cycles, BigInt, getters, or secrets to break the transport. */
+export function safeStringify(value) {
+    try {
+        return JSON.stringify(sanitizeForTransport(value));
+    }
+    catch {
+        return JSON.stringify(UNSERIALIZABLE_VALUE);
+    }
+}
+//# sourceMappingURL=serialization.js.map

package/dist/security/serialization.js.map

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

package/dist/timers/clock.d.ts

@@ -0,0 +1,6 @@
+export declare function isClockFrozen(): boolean;
+export declare function freezeClock(): void;
+/** Run all timers due within the next `ms` of virtual time, in order. */
+export declare function advanceClock(ms: number): void;
+export declare function resetClock(): void;
+//# sourceMappingURL=clock.d.ts.map

package/dist/timers/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/timers/clock.ts"],"names":[],"mappings":"AA2BA,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,WAAW,IAAI,IAAI,CAgClC;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAkB7C;AAED,wBAAgB,UAAU,IAAI,IAAI,CAWjC"}