@reticlehq/browser 2.3.0 → 2.5.0

package/dist/observers/health.js

@@ -1,4 +1,4 @@
-import { EventType, HealthReason, RETICLE_IPC_GLOBAL, SESSION_HEALTH } from '@reticlehq/core';
+import { BrowserBrand, EventType, HealthReason, RETICLE_IPC_GLOBAL, SESSION_HEALTH, } from '@reticlehq/core';
 import { nativeSetInterval } from '../timers/native-timers.js';
 /**
  * Which shell this page runs in. Reported with health because it is what makes a timeout
@@ -27,12 +27,80 @@ function detectEngine() {
         return 'gecko';
     return 'webkit';
 }
+/**
+ * Brand names as the Chromium family and the UA string spell them, mapped to our closed vocabulary.
+ * Matched on the WHOLE lowercased name, never a substring: brand strings are attacker-influenced
+ * free text, and a substring rule is how "Search Browser" becomes `arc`.
+ */
+const BRAND_BY_NAME = {
+    'google chrome': BrowserBrand.CHROME,
+    chrome: BrowserBrand.CHROME,
+    'microsoft edge': BrowserBrand.EDGE,
+    edge: BrowserBrand.EDGE,
+    brave: BrowserBrand.BRAVE,
+    opera: BrowserBrand.OPERA,
+    arc: BrowserBrand.ARC,
+    dia: BrowserBrand.DIA,
+    firefox: BrowserBrand.FIREFOX,
+    safari: BrowserBrand.SAFARI,
+};
+/** Chromium's own filler entries: the greased `Not_A Brand` (spelt differently every release) and the generic engine name. */
+function isFiller(name) {
+    return 'chromium' === name || (name.includes('not') && name.includes('brand'));
+}
+/**
+ * The brand, from `navigator.userAgentData.brands` where it exists and the UA string where it does
+ * not (Firefox and Safari expose no userAgentData at all). Every fork claims `Google Chrome`
+ * alongside its own entry, so a non-Chrome match always wins; a Chromium that names nothing but
+ * filler is `other`, because calling it Chrome would be a guess.
+ *
+ * Never throws — a desktop webview may expose a `userAgentData` of any shape, and health reporting
+ * must survive it.
+ */
+function detectBrand() {
+    try {
+        const nav = navigator;
+        const brands = nav.userAgentData?.brands;
+        if (Array.isArray(brands)) {
+            let chrome;
+            for (const entry of brands) {
+                const name = 'string' === typeof entry?.brand ? entry.brand.toLowerCase() : '';
+                if ('' === name || isFiller(name))
+                    continue;
+                const known = BRAND_BY_NAME[name];
+                if (known === undefined)
+                    continue;
+                if (BrowserBrand.CHROME === known)
+                    chrome = known;
+                else
+                    return known;
+            }
+            return chrome ?? BrowserBrand.OTHER;
+        }
+    }
+    catch {
+        /* a health report must never depend on an exotic userAgentData */
+    }
+    const ua = navigator.userAgent;
+    if (/Edg\//.test(ua))
+        return BrowserBrand.EDGE;
+    if (/OPR\/|Opera/.test(ua))
+        return BrowserBrand.OPERA;
+    if (/Firefox/.test(ua))
+        return BrowserBrand.FIREFOX;
+    if (/Chrome|Chromium/.test(ua))
+        return BrowserBrand.CHROME;
+    if (/Safari/.test(ua))
+        return BrowserBrand.SAFARI;
+    return BrowserBrand.OTHER;
+}
 function snapshotHealth() {
     return {
-        hidden: document.visibilityState === 'hidden',
+        hidden: 'hidden' === document.visibilityState,
         focused: document.hasFocus(),
         runtime: detectRuntime(),
         engine: detectEngine(),
+        brand: detectBrand(),
     };
 }
 /**

package/dist/observers/install-all.d.ts

@@ -1,5 +1,6 @@
 import type { Emit, Teardown } from './types.js';
-export interface InstallOptions {
+interface InstallOptions {
     captureBodies: boolean;
 }
 export declare function installAllObservers(emit: Emit, options: InstallOptions): Teardown[];
+export {};

package/dist/observers/ipc.d.ts

@@ -1,10 +1,4 @@
 import type { Emit, Teardown } from './types.js';
-/**
- * How Tauri v2 reports a command's verdict. The transport answers HTTP 200 whether the Rust command
- * returned Ok or Err — the verdict is in this response header, which Tauri explicitly CORS-exposes so
- * JS may read it. Without translating it, every failed command is recorded as a successful request.
- */
-export declare const TAURI_RESPONSE_HEADER_NAME = "Tauri-Response";
 /**
  * Fields to override on a NET_REQUEST that turned out to be a Tauri IPC call, or null when the
  * request was ordinary HTTP. Pure — the network observer calls this with the response header it
@@ -15,8 +9,9 @@ export declare function ipcNetOverrides(url: string, header: (name: string) => s
  * Subscribe to the Electron preload shim, if this app installed it. Inert on Tauri (whose calls the
  * network observer handles) and on a plain web page.
  */
-export interface IpcOptions {
+interface IpcOptions {
     /** Forward the IPC payloads the preload recorded. Off by default, like the HTTP body capture. */
     captureBodies?: boolean;
 }
 export declare function installIpc(emit: Emit, options?: IpcOptions): Teardown;
+export {};

package/dist/observers/ipc.js

@@ -5,7 +5,7 @@ import { observeSafely } from './types.js';
  * returned Ok or Err — the verdict is in this response header, which Tauri explicitly CORS-exposes so
  * JS may read it. Without translating it, every failed command is recorded as a successful request.
  */
-export const TAURI_RESPONSE_HEADER_NAME = 'Tauri-Response';
+const TAURI_RESPONSE_HEADER_NAME = 'Tauri-Response';
 const TAURI_RESPONSE_ERROR = 'error';
 /** Rust/IPC vocabulary rather than HTTP's, so the text never claims a transport status it lacks. */
 const IPC_STATUS_TEXT = { OK: 'Ok', ERROR: 'Err' };
@@ -70,7 +70,7 @@ export function installIpc(emit, options = {}) {
     const token = channel.subscribe((record) => {
         observeSafely(() => {
             const url = `${IPC_URL_SCHEME}${record.channel}`;
-            if (record.phase === 'start') {
+            if ('start' === record.phase) {
                 emit(EventType.NET_PENDING, {
                     id: record.id,
                     method: NetInitiator.IPC,
@@ -83,18 +83,18 @@ export function installIpc(emit, options = {}) {
             // main process handled it. Emitting `ok/status` anyway would manufacture the success nobody
             // reported, so both are omitted and `oneWay` says why. `reticle_network { ok }` then matches
             // such a record in neither direction, which is the honest answer to "did it work".
-            const verdictless = record.oneWay === true && record.ok === undefined;
+            const verdictless = true === record.oneWay && record.ok === undefined;
             // Declared, not inferred: the server cannot tell "no verdict" from "not yet settled" without
             // being told, and a send with nothing to observe must not read as a clean green.
             if (verdictless)
                 emit(EventType.BLIND_SPOT, { kind: BlindSpotKind.VERDICTLESS_SEND, count: 1 });
-            const ok = record.ok === true;
+            const ok = true === record.ok;
             emit(EventType.NET_REQUEST, {
                 id: record.id,
                 method: NetInitiator.IPC,
                 url,
                 ...(verdictless ? {} : { ok, status: ok ? IpcStatus.OK : IpcStatus.ERROR }),
-                ...(record.oneWay === true ? { oneWay: true } : {}),
+                ...(true === record.oneWay ? { oneWay: true } : {}),
                 durationMs: record.durationMs ?? 0,
                 initiator: NetInitiator.IPC,
                 ...(record.error === undefined ? {} : { error: record.error }),
@@ -102,11 +102,11 @@ export function installIpc(emit, options = {}) {
                 // write returned ok and its payload went unread" from the size alone, and it cannot infer that
                 // from an absent field — an unread payload and an empty one would look identical.
                 ...(record.responseSize === undefined ? {} : { responseSize: record.responseSize }),
-                ...(options.captureBodies === true
+                ...(true === options.captureBodies
                     ? {
                         ...(record.requestBody === undefined ? {} : { requestBody: record.requestBody }),
                         ...(record.responseBody === undefined ? {} : { responseBody: record.responseBody }),
-                        ...(record.responseBodyTruncated === true ? { responseBodyTruncated: true } : {}),
+                        ...(true === record.responseBodyTruncated ? { responseBodyTruncated: true } : {}),
                     }
                     : {}),
             });

package/dist/observers/network-body.js

@@ -45,7 +45,7 @@ const ENDLESS_BY_DESIGN = /event-stream/i;
 export function isStreamingBody(contentType, contentLength) {
     if (contentType !== null && ENDLESS_BY_DESIGN.test(contentType))
         return false;
-    return contentLength === null;
+    return null === contentLength;
 }
 /**
  * Longest the SDK will wait on a response-body clone before emitting without it.
@@ -84,7 +84,7 @@ export async function withBodyDeadline(read) {
     }
 }
 export function isCapturableType(contentType) {
-    if (contentType === null)
+    if (null === contentType)
         return false;
     if (STREAMING_CONTENT.test(contentType))
         return false;

package/dist/observers/network-redact.js

@@ -12,11 +12,11 @@ const PATH_TOKEN_MIN_LENGTH = 12;
  */
 export function redactUrl(raw) {
     const hashStart = raw.indexOf('#');
-    const hash = hashStart === -1 ? '' : raw.slice(hashStart);
-    const beforeHash = hashStart === -1 ? raw : raw.slice(0, hashStart);
+    const hash = -1 === hashStart ? '' : raw.slice(hashStart);
+    const beforeHash = -1 === hashStart ? raw : raw.slice(0, hashStart);
     const queryStart = beforeHash.indexOf('?');
-    const pathPart = queryStart === -1 ? beforeHash : beforeHash.slice(0, queryStart);
-    const query = queryStart === -1 ? '' : beforeHash.slice(queryStart + 1);
+    const pathPart = -1 === queryStart ? beforeHash : beforeHash.slice(0, queryStart);
+    const query = -1 === queryStart ? '' : beforeHash.slice(queryStart + 1);
     let changed = false;
     // Credentials in the authority (`scheme://user:pass@host`) never belong in a transcript.
     // Match to the LAST `@` before the path (`[^/]*@`, greedy), not the first — a password containing
@@ -64,6 +64,6 @@ export function redactUrl(raw) {
     }
     if (!changed)
         return raw;
-    const queryOut = queryStart === -1 ? '' : `?${newQuery}`;
+    const queryOut = -1 === queryStart ? '' : `?${newQuery}`;
     return `${segments.join('/')}${queryOut}${newHash}`;
 }

package/dist/observers/network-stream.js

@@ -53,7 +53,7 @@ export function watchStreamedBody(emit, res, id, url, contentType, contentLength
         return; // already consumed or locked — the app owns it; observing it would take it away
     }
     const body = clone.body;
-    if (body === null)
+    if (null === body)
         return;
     emit(EventType.NET_STREAM, {
         transport: StreamTransport.FETCH,
@@ -75,7 +75,7 @@ export function watchStreamedBody(emit, res, id, url, contentType, contentLength
         try {
             for (;;) {
                 const next = await Promise.race([reader.read(), expired]);
-                if (next === 'expired') {
+                if ('expired' === next) {
                     gaveUp = true;
                     void reader.cancel().catch(() => undefined);
                     break;

package/dist/observers/network.d.ts

@@ -10,8 +10,8 @@ export { redactUrl };
  * succeeded means nothing to a network observer — so the knowledge lives in the IPC observer and is
  * passed IN, rather than this module importing it. Returns undefined to leave the record untouched.
  */
-export type NetResponseReinterpreter = (url: string, header: (name: string) => string | null) => Record<string, unknown> | undefined;
-export interface NetworkOptions {
+type NetResponseReinterpreter = (url: string, header: (name: string) => string | null) => Record<string, unknown> | undefined;
+interface NetworkOptions {
     /** Capture request/response bodies (text-like content only, redacted, per-body capped). */
     captureBodies?: boolean;
     /** Optional hook that reinterprets a completed request — see NetResponseReinterpreter. */
@@ -20,7 +20,7 @@ export interface NetworkOptions {
 /** Pure: the first real app-code frame in a stack string, capped. Exported for unit testing. */
 export declare function firstAppFrame(stack: string | undefined): string | undefined;
 /** The timing fields we lift from a resource entry — TTFB is the perf signal a duration alone hides. */
-export interface NetTiming {
+interface NetTiming {
     ttfbMs?: number;
     transferSize?: number;
 }

package/dist/observers/network.js

@@ -44,7 +44,7 @@ function projectRequestBody(body, captureBodies) {
         return {};
     let text;
     let contentType = 'application/json';
-    if (typeof body === 'string') {
+    if ('string' === typeof body) {
         text = body;
     }
     else if (typeof URLSearchParams !== 'undefined' && body instanceof URLSearchParams) {
@@ -55,7 +55,7 @@ function projectRequestBody(body, captureBodies) {
         const shape = body.constructor?.name ?? typeof body;
         return { requestBodyType: shape };
     }
-    if (text === undefined || text.length === 0)
+    if (text === undefined || 0 === text.length)
         return {};
     const { body: out, truncated } = projectBody(text, contentType);
     return truncated ? { requestBody: out, requestBodyTruncated: true } : { requestBody: out };
@@ -78,7 +78,7 @@ function netResponseMeta(statusText, contentType, contentLength) {
     return out;
 }
 function urlOf(input) {
-    if (typeof input === 'string')
+    if ('string' === typeof input)
         return input;
     if (input instanceof URL)
         return input.href;
@@ -112,7 +112,7 @@ export function firstAppFrame(stack) {
         if (NON_APP_FRAME.test(line))
             continue;
         const trimmed = line.trim();
-        if (trimmed.length === 0)
+        if (0 === trimmed.length)
             continue;
         return trimmed.slice(0, 300);
     }
@@ -191,7 +191,7 @@ function isNativeFetch(fn) {
 /** Wrappers this module installed, so a re-install does not report itself as a foreign wrapper. */
 const OURS = new WeakSet();
 export function installNetwork(emit, opts = {}) {
-    const captureBodies = opts.captureBodies === true;
+    const captureBodies = true === opts.captureBodies;
     const reinterpret = opts.reinterpret;
     // Keep the true original for teardown identity, plus a window-bound copy to invoke
     // (fetch throws "Illegal invocation" if called with the wrong `this`).
@@ -365,7 +365,7 @@ export function installNetwork(emit, opts = {}) {
                     const xhrContentType = this.getResponseHeader('content-type');
                     let responseBodyFields = {};
                     // responseText throws unless responseType is '' or 'text' — guard before reading.
-                    const textReadable = this.responseType === '' || this.responseType === 'text';
+                    const textReadable = '' === this.responseType || 'text' === this.responseType;
                     if (captureBodies && textReadable && isCapturableType(xhrContentType)) {
                         try {
                             const { body: rb, truncated } = projectBody(this.responseText, xhrContentType);
@@ -403,7 +403,7 @@ export function installNetwork(emit, opts = {}) {
     const origWebSocket = window.WebSocket;
     let patchedEventSource;
     let patchedWebSocket;
-    if (captureBodies && typeof origEventSource === 'function') {
+    if (captureBodies && 'function' === typeof origEventSource) {
         window.EventSource = class extends origEventSource {
             constructor(u, init) {
                 super(u, init);
@@ -425,7 +425,7 @@ export function installNetwork(emit, opts = {}) {
         };
         patchedEventSource = window.EventSource;
     }
-    if (captureBodies && typeof origWebSocket === 'function') {
+    if (captureBodies && 'function' === typeof origWebSocket) {
         window.WebSocket = class extends origWebSocket {
             /** Reticle's own bridge socket is never observed — see isBridgeSocket. */
             #isBridge;
@@ -470,7 +470,7 @@ export function installNetwork(emit, opts = {}) {
     // getPrototypeOf, robust whether or not the Navigator global exists); the descriptor read avoids an
     // unbound-method access; the send is synchronous so we emit one completed NET_REQUEST with its result.
     const navProto = (typeof navigator !== 'undefined' ? Object.getPrototypeOf(navigator) : null);
-    const origBeacon = (navProto === null ? undefined : Object.getOwnPropertyDescriptor(navProto, 'sendBeacon')?.value);
+    const origBeacon = (null === navProto ? undefined : Object.getOwnPropertyDescriptor(navProto, 'sendBeacon')?.value);
     let patchedBeacon;
     if (navProto !== null && origBeacon !== undefined) {
         patchedBeacon = function (url, data) {

package/dist/observers/perf.js

@@ -42,7 +42,7 @@ export function installPerf(emit) {
     observe('layout-shift', (e) => {
         const ls = e;
         // Shifts within 500ms of a user input are expected (not CLS) — the spec's hadRecentInput flag.
-        if (ls.hadRecentInput === true)
+        if (true === ls.hadRecentInput)
             return;
         cls += ls.value ?? 0;
         emit(EventType.PERF, { metric: PerfMetric.CLS, value: cls, at: Math.round(e.startTime) });

package/dist/observers/scroll.js

@@ -41,7 +41,7 @@ export function installScroll(emit) {
     };
     window.addEventListener('scroll', onScroll, { passive: true });
     let io;
-    if (typeof IntersectionObserver === 'function') {
+    if ('function' === typeof IntersectionObserver) {
         io = new IntersectionObserver((entries) => {
             for (const entry of entries) {
                 if (entry.isIntersecting) {

package/dist/observers/state.js

@@ -2,7 +2,7 @@ import { EventType, REDACTED_VALUE } from '@reticlehq/core';
 import { subscribableStores, onStoreRegistered, } from '../registry/stores.js';
 import { isSensitiveKey, sanitizeForTransport } from '../security/serialization.js';
 function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
+    return 'object' === typeof value && value !== null && !Array.isArray(value);
 }
 /**
  * Shallow top-level diff of two store states — the keys whose value changed. Immutable updates

package/dist/observers/storage.js

@@ -12,11 +12,11 @@ function safeArea(get) {
 }
 function readArea(storage) {
     const out = {};
-    if (storage === null)
+    if (null === storage)
         return out;
     for (let i = 0; i < storage.length; i += 1) {
         const key = storage.key(i);
-        if (key === null)
+        if (null === key)
             continue;
         // Redact credential-bearing keys (token/session/password/…) so auth state never leaks verbatim.
         out[key] = isSensitiveKey(key) ? REDACTED_VALUE : (storage.getItem(key) ?? '');
@@ -36,10 +36,10 @@ function readCookies() {
     }
     for (const part of raw.split(';')) {
         const eq = part.indexOf('=');
-        if (eq === -1)
+        if (-1 === eq)
             continue;
         const key = part.slice(0, eq).trim();
-        if (key === '')
+        if ('' === key)
             continue;
         if (isSensitiveKey(key)) {
             out[key] = REDACTED_VALUE;
@@ -65,7 +65,7 @@ export function readStorage(area) {
         return readArea(safeArea(() => window.localStorage));
     if (area === StorageArea.SESSION)
         return readArea(safeArea(() => window.sessionStorage));
-    if (area === 'cookies')
+    if ('cookies' === area)
         return readCookies();
     return {
         local: readArea(safeArea(() => window.localStorage)),
@@ -75,7 +75,7 @@ export function readStorage(area) {
 }
 /** Redact a value when its key is credential-bearing — the same rule the pull path applies. */
 function redactFor(key, value) {
-    if (value === null)
+    if (null === value)
         return undefined;
     return isSensitiveKey(key) ? REDACTED_VALUE : value;
 }
@@ -87,7 +87,7 @@ function redactFor(key, value) {
  * method access) and re-dispatched via `.call(this)`. Fully reversible; values redacted like the reads.
  */
 export function installStorage(emit) {
-    if (typeof Storage === 'undefined')
+    if ('undefined' === typeof Storage)
         return () => undefined;
     const proto = Storage.prototype;
     const origSet = Object.getOwnPropertyDescriptor(proto, 'setItem')?.value;

package/dist/presenter/presenter-brand.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Brand marks, inlined. The SDK is bundled into someone else's page: it cannot read
+ * `assets/logo/*.svg` from disk at runtime and must never fetch from our own domain, so the two
+ * artwork files live here as strings (same precedent as SEND_ICON in presenter-controls.ts).
+ * Both are minified — editor metadata, clip paths, masks and sub-0.01 precision stripped — and paint
+ * with `currentColor` so the mark tracks --reticle-fg instead of hardcoding the export's #FAFAFA.
+ */
+/** Accessible name of the HUD — the wordmark is artwork, this is what a screen reader reads. */
+export declare const BRAND_NAME = "Reticle";
+/** Mark alone (shown when the HUD is collapsed to a pill). */
+export declare const MARK_SVG = "<svg class=\"reticle-mark\" viewBox=\"0 0 96 94\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M92.82 92.16C93.07 93.4 91.77 94.4 90.63 93.83C89.62 93.33 88.62 92.82 87.63 92.3C71.14 83.78 54.79 72.27 39.61 57.96C39.09 57.49 38.57 56.98 38.06 56.49C22.45 41.52 9.78 25.14 .33 8.52C0.29 8.45 .25 8.38 .2 8.31C-0.44 7.2 .51 5.84 1.79 6.05L24.07 9.71C43.06 12.83 60.63 11.75 75.55 6.53L93.95 .09C95.15-0.33 96.31 .78 95.93 1.98L90.1 20.49C85.37 35.48 84.9 52.97 88.69 71.73L92.83 92.16H92.82Z\"/><path d=\"M58.72 89.23L6.15 92.8C5.24 92.86 4.48 92.13 4.51 91.22L6.56 30.39C6.61 28.91 8.51 28.36 9.35 29.57C16.23 39.43 24.98 52.35 33.01 61.26C41.05 70.17 50.6 78.72 59.62 86.56C60.65 87.45 60.08 89.13 58.72 89.23Z\"/></svg>";
+/** Mark + "reticle" lettering (shown when the HUD is expanded). */
+export declare const WORDMARK_SVG = "<svg class=\"reticle-wordmark\" viewBox=\"0 0 347 96\" fill=\"currentColor\" aria-hidden=\"true\"><g transform=\"translate(1 1)\"><path d=\"M92.82 92.16C93.07 93.4 91.77 94.4 90.63 93.83C89.62 93.33 88.62 92.82 87.63 92.3C71.14 83.78 54.79 72.27 39.61 57.96C39.09 57.49 38.57 56.98 38.06 56.49C22.45 41.52 9.78 25.14 .33 8.52C0.29 8.45 .25 8.38 .2 8.31C-0.44 7.2 .51 5.84 1.79 6.05L24.07 9.71C43.06 12.83 60.63 11.75 75.55 6.53L93.95 .09C95.15-0.33 96.31 .78 95.93 1.98L90.1 20.49C85.37 35.48 84.9 52.97 88.69 71.73L92.83 92.16H92.82Z\"/><path d=\"M58.72 89.23L6.15 92.8C5.24 92.86 4.48 92.13 4.51 91.22L6.56 30.39C6.61 28.91 8.51 28.36 9.35 29.57C16.23 39.43 24.98 52.35 33.01 61.26C41.05 70.17 50.6 78.72 59.62 86.56C60.65 87.45 60.08 89.13 58.72 89.23Z\"/></g><path d=\"M116.43 78V27.09H136.51C140.35 27.09 143.64 27.78 146.35 29.15C149.09 30.51 151.17 32.44 152.59 34.95C154.04 37.43 154.76 40.36 154.76 43.72C154.76 47.1 154.03 50.01 152.57 52.45C151.11 54.87 149 56.72 146.23 58.01C143.48 59.31 140.15 59.95 136.24 59.95H122.79V51.3H134.5C136.55 51.3 138.26 51.02 139.62 50.46C140.98 49.89 141.99 49.05 142.65 47.92C143.33 46.8 143.67 45.39 143.67 43.72C143.67 42.03 143.33 40.61 142.65 39.45C141.99 38.29 140.97 37.41 139.59 36.81C138.23 36.2 136.52 35.89 134.45 35.89H127.19V78H116.43ZM143.92 54.83L156.57 78H144.69L132.31 54.83H143.92ZM178.95 78.75C175.02 78.75 171.64 77.95 168.81 76.36C165.99 74.75 163.82 72.48 162.29 69.55C160.77 66.6 160.01 63.11 160.01 59.08C160.01 55.16 160.77 51.71 162.29 48.74C163.82 45.78 165.97 43.46 168.73 41.81C171.52 40.15 174.78 39.32 178.53 39.32C181.05 39.32 183.39 39.73 185.56 40.54C187.75 41.33 189.65 42.54 191.28 44.14C192.92 45.75 194.2 47.77 195.11 50.21C196.02 52.63 196.47 55.46 196.47 58.71V61.62H164.23V55.06H186.51C186.51 53.53 186.17 52.18 185.51 51C184.85 49.83 183.93 48.91 182.75 48.25C181.59 47.57 180.24 47.23 178.7 47.23C177.09 47.23 175.67 47.6 174.43 48.34C173.2 49.07 172.24 50.06 171.54 51.3C170.85 52.53 170.49 53.9 170.47 55.4V61.64C170.47 63.53 170.82 65.17 171.52 66.54C172.23 67.92 173.23 68.98 174.52 69.72C175.82 70.47 177.35 70.84 179.12 70.84C180.3 70.84 181.38 70.68 182.35 70.34C183.33 70.01 184.17 69.52 184.87 68.85C185.56 68.19 186.09 67.38 186.46 66.42L196.25 67.06C195.75 69.42 194.73 71.47 193.19 73.23C191.67 74.97 189.7 76.33 187.28 77.3C184.87 78.27 182.1 78.75 178.95 78.75ZM223.69 39.82V47.77H200.7V39.82H223.69ZM205.92 30.67H216.51V66.27C216.51 67.24 216.66 68.01 216.96 68.55C217.26 69.08 217.67 69.46 218.2 69.67C218.75 69.89 219.38 70 220.09 70C220.59 70 221.08 69.95 221.58 69.87C222.08 69.77 222.46 69.7 222.72 69.65L224.39 77.53C223.86 77.69 223.11 77.88 222.15 78.1C221.19 78.33 220.02 78.47 218.65 78.52C216.1 78.62 213.86 78.28 211.94 77.5C210.03 76.72 208.55 75.51 207.49 73.87C206.43 72.23 205.9 70.16 205.92 67.66V30.67ZM230.59 78V39.82H241.18V78H230.59ZM235.91 34.9C234.34 34.9 232.99 34.37 231.86 33.33C230.75 32.27 230.19 31 230.19 29.53C230.19 28.07 230.75 26.82 231.86 25.77C232.99 24.71 234.34 24.18 235.91 24.18C237.49 24.18 238.83 24.71 239.94 25.77C241.07 26.82 241.63 28.07 241.63 29.53C241.63 31 241.07 32.27 239.94 33.33C238.83 34.37 237.49 34.9 235.91 34.9ZM266.92 78.75C263 78.75 259.64 77.92 256.82 76.26C254.02 74.59 251.87 72.27 250.36 69.3C248.87 66.33 248.12 62.92 248.12 59.06C248.12 55.15 248.88 51.72 250.38 48.77C251.91 45.8 254.07 43.49 256.87 41.83C259.67 40.16 263 39.32 266.87 39.32C270.2 39.32 273.11 39.93 275.62 41.14C278.12 42.35 280.1 44.04 281.56 46.23C283.01 48.42 283.82 50.99 283.97 53.94H273.97C273.69 52.03 272.95 50.5 271.74 49.34C270.54 48.16 268.98 47.57 267.04 47.57C265.4 47.57 263.96 48.02 262.74 48.92C261.53 49.79 260.58 51.08 259.9 52.77C259.23 54.46 258.89 56.51 258.89 58.91C258.89 61.35 259.22 63.42 259.88 65.12C260.56 66.83 261.51 68.13 262.74 69.03C263.96 69.92 265.4 70.37 267.04 70.37C268.25 70.37 269.33 70.12 270.3 69.62C271.27 69.13 272.08 68.4 272.71 67.46C273.35 66.5 273.78 65.35 273.97 64.01H283.97C283.8 66.92 283.01 69.49 281.58 71.71C280.17 73.92 278.23 75.64 275.74 76.88C273.25 78.12 270.31 78.75 266.92 78.75ZM301.34 27.09V78H290.75V27.09H301.34ZM327.22 78.75C323.29 78.75 319.91 77.95 317.08 76.36C314.26 74.75 312.09 72.48 310.57 69.55C309.04 66.6 308.28 63.11 308.28 59.08C308.28 55.16 309.04 51.71 310.57 48.74C312.09 45.78 314.24 43.46 317 41.81C319.79 40.15 323.05 39.32 326.8 39.32C329.32 39.32 331.66 39.73 333.83 40.54C336.02 41.33 337.93 42.54 339.55 44.14C341.19 45.75 342.47 47.77 343.38 50.21C344.29 52.63 344.75 55.46 344.75 58.71V61.62H312.5V55.06H334.78C334.78 53.53 334.45 52.18 333.78 51C333.12 49.83 332.2 48.91 331.02 48.25C329.86 47.57 328.51 47.23 326.97 47.23C325.36 47.23 323.94 47.6 322.7 48.34C321.47 49.07 320.51 50.06 319.81 51.3C319.12 52.53 318.76 53.9 318.74 55.4V61.64C318.74 63.53 319.09 65.17 319.79 66.54C320.5 67.92 321.5 68.98 322.8 69.72C324.09 70.47 325.62 70.84 327.39 70.84C328.57 70.84 329.65 70.68 330.63 70.34C331.6 70.01 332.44 69.52 333.14 68.85C333.83 68.19 334.36 67.38 334.73 66.42L344.52 67.06C344.02 69.42 343.01 71.47 341.46 73.23C339.94 74.97 337.97 76.33 335.55 77.3C333.15 78.27 330.37 78.75 327.22 78.75Z\"/></svg>";
+/**
+ * Header brand block. Both marks are always in the DOM and CSS picks one off the collapsed
+ * attribute, so there is no JS state to keep in sync. The artwork is decorative (aria-hidden);
+ * the visually-hidden name is what keeps the HUD identifiable to a screen reader in BOTH states.
+ */
+export declare const BRAND_HTML = "<span class=\"reticle-brand\"><svg class=\"reticle-mark\" viewBox=\"0 0 96 94\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M92.82 92.16C93.07 93.4 91.77 94.4 90.63 93.83C89.62 93.33 88.62 92.82 87.63 92.3C71.14 83.78 54.79 72.27 39.61 57.96C39.09 57.49 38.57 56.98 38.06 56.49C22.45 41.52 9.78 25.14 .33 8.52C0.29 8.45 .25 8.38 .2 8.31C-0.44 7.2 .51 5.84 1.79 6.05L24.07 9.71C43.06 12.83 60.63 11.75 75.55 6.53L93.95 .09C95.15-0.33 96.31 .78 95.93 1.98L90.1 20.49C85.37 35.48 84.9 52.97 88.69 71.73L92.83 92.16H92.82Z\"/><path d=\"M58.72 89.23L6.15 92.8C5.24 92.86 4.48 92.13 4.51 91.22L6.56 30.39C6.61 28.91 8.51 28.36 9.35 29.57C16.23 39.43 24.98 52.35 33.01 61.26C41.05 70.17 50.6 78.72 59.62 86.56C60.65 87.45 60.08 89.13 58.72 89.23Z\"/></svg><svg class=\"reticle-wordmark\" viewBox=\"0 0 347 96\" fill=\"currentColor\" aria-hidden=\"true\"><g transform=\"translate(1 1)\"><path d=\"M92.82 92.16C93.07 93.4 91.77 94.4 90.63 93.83C89.62 93.33 88.62 92.82 87.63 92.3C71.14 83.78 54.79 72.27 39.61 57.96C39.09 57.49 38.57 56.98 38.06 56.49C22.45 41.52 9.78 25.14 .33 8.52C0.29 8.45 .25 8.38 .2 8.31C-0.44 7.2 .51 5.84 1.79 6.05L24.07 9.71C43.06 12.83 60.63 11.75 75.55 6.53L93.95 .09C95.15-0.33 96.31 .78 95.93 1.98L90.1 20.49C85.37 35.48 84.9 52.97 88.69 71.73L92.83 92.16H92.82Z\"/><path d=\"M58.72 89.23L6.15 92.8C5.24 92.86 4.48 92.13 4.51 91.22L6.56 30.39C6.61 28.91 8.51 28.36 9.35 29.57C16.23 39.43 24.98 52.35 33.01 61.26C41.05 70.17 50.6 78.72 59.62 86.56C60.65 87.45 60.08 89.13 58.72 89.23Z\"/></g><path d=\"M116.43 78V27.09H136.51C140.35 27.09 143.64 27.78 146.35 29.15C149.09 30.51 151.17 32.44 152.59 34.95C154.04 37.43 154.76 40.36 154.76 43.72C154.76 47.1 154.03 50.01 152.57 52.45C151.11 54.87 149 56.72 146.23 58.01C143.48 59.31 140.15 59.95 136.24 59.95H122.79V51.3H134.5C136.55 51.3 138.26 51.02 139.62 50.46C140.98 49.89 141.99 49.05 142.65 47.92C143.33 46.8 143.67 45.39 143.67 43.72C143.67 42.03 143.33 40.61 142.65 39.45C141.99 38.29 140.97 37.41 139.59 36.81C138.23 36.2 136.52 35.89 134.45 35.89H127.19V78H116.43ZM143.92 54.83L156.57 78H144.69L132.31 54.83H143.92ZM178.95 78.75C175.02 78.75 171.64 77.95 168.81 76.36C165.99 74.75 163.82 72.48 162.29 69.55C160.77 66.6 160.01 63.11 160.01 59.08C160.01 55.16 160.77 51.71 162.29 48.74C163.82 45.78 165.97 43.46 168.73 41.81C171.52 40.15 174.78 39.32 178.53 39.32C181.05 39.32 183.39 39.73 185.56 40.54C187.75 41.33 189.65 42.54 191.28 44.14C192.92 45.75 194.2 47.77 195.11 50.21C196.02 52.63 196.47 55.46 196.47 58.71V61.62H164.23V55.06H186.51C186.51 53.53 186.17 52.18 185.51 51C184.85 49.83 183.93 48.91 182.75 48.25C181.59 47.57 180.24 47.23 178.7 47.23C177.09 47.23 175.67 47.6 174.43 48.34C173.2 49.07 172.24 50.06 171.54 51.3C170.85 52.53 170.49 53.9 170.47 55.4V61.64C170.47 63.53 170.82 65.17 171.52 66.54C172.23 67.92 173.23 68.98 174.52 69.72C175.82 70.47 177.35 70.84 179.12 70.84C180.3 70.84 181.38 70.68 182.35 70.34C183.33 70.01 184.17 69.52 184.87 68.85C185.56 68.19 186.09 67.38 186.46 66.42L196.25 67.06C195.75 69.42 194.73 71.47 193.19 73.23C191.67 74.97 189.7 76.33 187.28 77.3C184.87 78.27 182.1 78.75 178.95 78.75ZM223.69 39.82V47.77H200.7V39.82H223.69ZM205.92 30.67H216.51V66.27C216.51 67.24 216.66 68.01 216.96 68.55C217.26 69.08 217.67 69.46 218.2 69.67C218.75 69.89 219.38 70 220.09 70C220.59 70 221.08 69.95 221.58 69.87C222.08 69.77 222.46 69.7 222.72 69.65L224.39 77.53C223.86 77.69 223.11 77.88 222.15 78.1C221.19 78.33 220.02 78.47 218.65 78.52C216.1 78.62 213.86 78.28 211.94 77.5C210.03 76.72 208.55 75.51 207.49 73.87C206.43 72.23 205.9 70.16 205.92 67.66V30.67ZM230.59 78V39.82H241.18V78H230.59ZM235.91 34.9C234.34 34.9 232.99 34.37 231.86 33.33C230.75 32.27 230.19 31 230.19 29.53C230.19 28.07 230.75 26.82 231.86 25.77C232.99 24.71 234.34 24.18 235.91 24.18C237.49 24.18 238.83 24.71 239.94 25.77C241.07 26.82 241.63 28.07 241.63 29.53C241.63 31 241.07 32.27 239.94 33.33C238.83 34.37 237.49 34.9 235.91 34.9ZM266.92 78.75C263 78.75 259.64 77.92 256.82 76.26C254.02 74.59 251.87 72.27 250.36 69.3C248.87 66.33 248.12 62.92 248.12 59.06C248.12 55.15 248.88 51.72 250.38 48.77C251.91 45.8 254.07 43.49 256.87 41.83C259.67 40.16 263 39.32 266.87 39.32C270.2 39.32 273.11 39.93 275.62 41.14C278.12 42.35 280.1 44.04 281.56 46.23C283.01 48.42 283.82 50.99 283.97 53.94H273.97C273.69 52.03 272.95 50.5 271.74 49.34C270.54 48.16 268.98 47.57 267.04 47.57C265.4 47.57 263.96 48.02 262.74 48.92C261.53 49.79 260.58 51.08 259.9 52.77C259.23 54.46 258.89 56.51 258.89 58.91C258.89 61.35 259.22 63.42 259.88 65.12C260.56 66.83 261.51 68.13 262.74 69.03C263.96 69.92 265.4 70.37 267.04 70.37C268.25 70.37 269.33 70.12 270.3 69.62C271.27 69.13 272.08 68.4 272.71 67.46C273.35 66.5 273.78 65.35 273.97 64.01H283.97C283.8 66.92 283.01 69.49 281.58 71.71C280.17 73.92 278.23 75.64 275.74 76.88C273.25 78.12 270.31 78.75 266.92 78.75ZM301.34 27.09V78H290.75V27.09H301.34ZM327.22 78.75C323.29 78.75 319.91 77.95 317.08 76.36C314.26 74.75 312.09 72.48 310.57 69.55C309.04 66.6 308.28 63.11 308.28 59.08C308.28 55.16 309.04 51.71 310.57 48.74C312.09 45.78 314.24 43.46 317 41.81C319.79 40.15 323.05 39.32 326.8 39.32C329.32 39.32 331.66 39.73 333.83 40.54C336.02 41.33 337.93 42.54 339.55 44.14C341.19 45.75 342.47 47.77 343.38 50.21C344.29 52.63 344.75 55.46 344.75 58.71V61.62H312.5V55.06H334.78C334.78 53.53 334.45 52.18 333.78 51C333.12 49.83 332.2 48.91 331.02 48.25C329.86 47.57 328.51 47.23 326.97 47.23C325.36 47.23 323.94 47.6 322.7 48.34C321.47 49.07 320.51 50.06 319.81 51.3C319.12 52.53 318.76 53.9 318.74 55.4V61.64C318.74 63.53 319.09 65.17 319.79 66.54C320.5 67.92 321.5 68.98 322.8 69.72C324.09 70.47 325.62 70.84 327.39 70.84C328.57 70.84 329.65 70.68 330.63 70.34C331.6 70.01 332.44 69.52 333.14 68.85C333.83 68.19 334.36 67.38 334.73 66.42L344.52 67.06C344.02 69.42 343.01 71.47 341.46 73.23C339.94 74.97 337.97 76.33 335.55 77.3C333.15 78.27 330.37 78.75 327.22 78.75Z\"/></svg><span class=\"reticle-brand-sr\">Reticle</span></span>";

package/dist/presenter/presenter-brand.js

@@ -0,0 +1,21 @@
+/**
+ * Brand marks, inlined. The SDK is bundled into someone else's page: it cannot read
+ * `assets/logo/*.svg` from disk at runtime and must never fetch from our own domain, so the two
+ * artwork files live here as strings (same precedent as SEND_ICON in presenter-controls.ts).
+ * Both are minified — editor metadata, clip paths, masks and sub-0.01 precision stripped — and paint
+ * with `currentColor` so the mark tracks --reticle-fg instead of hardcoding the export's #FAFAFA.
+ */
+/** Accessible name of the HUD — the wordmark is artwork, this is what a screen reader reads. */
+export const BRAND_NAME = 'Reticle';
+/** The two glyph paths of the mark, shared by both marks — the wordmark just offsets them by (1,1). */
+const MARK_PATHS = `<path d="M92.82 92.16C93.07 93.4 91.77 94.4 90.63 93.83C89.62 93.33 88.62 92.82 87.63 92.3C71.14 83.78 54.79 72.27 39.61 57.96C39.09 57.49 38.57 56.98 38.06 56.49C22.45 41.52 9.78 25.14 .33 8.52C0.29 8.45 .25 8.38 .2 8.31C-0.44 7.2 .51 5.84 1.79 6.05L24.07 9.71C43.06 12.83 60.63 11.75 75.55 6.53L93.95 .09C95.15-0.33 96.31 .78 95.93 1.98L90.1 20.49C85.37 35.48 84.9 52.97 88.69 71.73L92.83 92.16H92.82Z"/><path d="M58.72 89.23L6.15 92.8C5.24 92.86 4.48 92.13 4.51 91.22L6.56 30.39C6.61 28.91 8.51 28.36 9.35 29.57C16.23 39.43 24.98 52.35 33.01 61.26C41.05 70.17 50.6 78.72 59.62 86.56C60.65 87.45 60.08 89.13 58.72 89.23Z"/>`;
+/** Mark alone (shown when the HUD is collapsed to a pill). */
+export const MARK_SVG = `<svg class="reticle-mark" viewBox="0 0 96 94" fill="currentColor" aria-hidden="true">${MARK_PATHS}</svg>`;
+/** Mark + "reticle" lettering (shown when the HUD is expanded). */
+export const WORDMARK_SVG = `<svg class="reticle-wordmark" viewBox="0 0 347 96" fill="currentColor" aria-hidden="true"><g transform="translate(1 1)">${MARK_PATHS}</g><path d="M116.43 78V27.09H136.51C140.35 27.09 143.64 27.78 146.35 29.15C149.09 30.51 151.17 32.44 152.59 34.95C154.04 37.43 154.76 40.36 154.76 43.72C154.76 47.1 154.03 50.01 152.57 52.45C151.11 54.87 149 56.72 146.23 58.01C143.48 59.31 140.15 59.95 136.24 59.95H122.79V51.3H134.5C136.55 51.3 138.26 51.02 139.62 50.46C140.98 49.89 141.99 49.05 142.65 47.92C143.33 46.8 143.67 45.39 143.67 43.72C143.67 42.03 143.33 40.61 142.65 39.45C141.99 38.29 140.97 37.41 139.59 36.81C138.23 36.2 136.52 35.89 134.45 35.89H127.19V78H116.43ZM143.92 54.83L156.57 78H144.69L132.31 54.83H143.92ZM178.95 78.75C175.02 78.75 171.64 77.95 168.81 76.36C165.99 74.75 163.82 72.48 162.29 69.55C160.77 66.6 160.01 63.11 160.01 59.08C160.01 55.16 160.77 51.71 162.29 48.74C163.82 45.78 165.97 43.46 168.73 41.81C171.52 40.15 174.78 39.32 178.53 39.32C181.05 39.32 183.39 39.73 185.56 40.54C187.75 41.33 189.65 42.54 191.28 44.14C192.92 45.75 194.2 47.77 195.11 50.21C196.02 52.63 196.47 55.46 196.47 58.71V61.62H164.23V55.06H186.51C186.51 53.53 186.17 52.18 185.51 51C184.85 49.83 183.93 48.91 182.75 48.25C181.59 47.57 180.24 47.23 178.7 47.23C177.09 47.23 175.67 47.6 174.43 48.34C173.2 49.07 172.24 50.06 171.54 51.3C170.85 52.53 170.49 53.9 170.47 55.4V61.64C170.47 63.53 170.82 65.17 171.52 66.54C172.23 67.92 173.23 68.98 174.52 69.72C175.82 70.47 177.35 70.84 179.12 70.84C180.3 70.84 181.38 70.68 182.35 70.34C183.33 70.01 184.17 69.52 184.87 68.85C185.56 68.19 186.09 67.38 186.46 66.42L196.25 67.06C195.75 69.42 194.73 71.47 193.19 73.23C191.67 74.97 189.7 76.33 187.28 77.3C184.87 78.27 182.1 78.75 178.95 78.75ZM223.69 39.82V47.77H200.7V39.82H223.69ZM205.92 30.67H216.51V66.27C216.51 67.24 216.66 68.01 216.96 68.55C217.26 69.08 217.67 69.46 218.2 69.67C218.75 69.89 219.38 70 220.09 70C220.59 70 221.08 69.95 221.58 69.87C222.08 69.77 222.46 69.7 222.72 69.65L224.39 77.53C223.86 77.69 223.11 77.88 222.15 78.1C221.19 78.33 220.02 78.47 218.65 78.52C216.1 78.62 213.86 78.28 211.94 77.5C210.03 76.72 208.55 75.51 207.49 73.87C206.43 72.23 205.9 70.16 205.92 67.66V30.67ZM230.59 78V39.82H241.18V78H230.59ZM235.91 34.9C234.34 34.9 232.99 34.37 231.86 33.33C230.75 32.27 230.19 31 230.19 29.53C230.19 28.07 230.75 26.82 231.86 25.77C232.99 24.71 234.34 24.18 235.91 24.18C237.49 24.18 238.83 24.71 239.94 25.77C241.07 26.82 241.63 28.07 241.63 29.53C241.63 31 241.07 32.27 239.94 33.33C238.83 34.37 237.49 34.9 235.91 34.9ZM266.92 78.75C263 78.75 259.64 77.92 256.82 76.26C254.02 74.59 251.87 72.27 250.36 69.3C248.87 66.33 248.12 62.92 248.12 59.06C248.12 55.15 248.88 51.72 250.38 48.77C251.91 45.8 254.07 43.49 256.87 41.83C259.67 40.16 263 39.32 266.87 39.32C270.2 39.32 273.11 39.93 275.62 41.14C278.12 42.35 280.1 44.04 281.56 46.23C283.01 48.42 283.82 50.99 283.97 53.94H273.97C273.69 52.03 272.95 50.5 271.74 49.34C270.54 48.16 268.98 47.57 267.04 47.57C265.4 47.57 263.96 48.02 262.74 48.92C261.53 49.79 260.58 51.08 259.9 52.77C259.23 54.46 258.89 56.51 258.89 58.91C258.89 61.35 259.22 63.42 259.88 65.12C260.56 66.83 261.51 68.13 262.74 69.03C263.96 69.92 265.4 70.37 267.04 70.37C268.25 70.37 269.33 70.12 270.3 69.62C271.27 69.13 272.08 68.4 272.71 67.46C273.35 66.5 273.78 65.35 273.97 64.01H283.97C283.8 66.92 283.01 69.49 281.58 71.71C280.17 73.92 278.23 75.64 275.74 76.88C273.25 78.12 270.31 78.75 266.92 78.75ZM301.34 27.09V78H290.75V27.09H301.34ZM327.22 78.75C323.29 78.75 319.91 77.95 317.08 76.36C314.26 74.75 312.09 72.48 310.57 69.55C309.04 66.6 308.28 63.11 308.28 59.08C308.28 55.16 309.04 51.71 310.57 48.74C312.09 45.78 314.24 43.46 317 41.81C319.79 40.15 323.05 39.32 326.8 39.32C329.32 39.32 331.66 39.73 333.83 40.54C336.02 41.33 337.93 42.54 339.55 44.14C341.19 45.75 342.47 47.77 343.38 50.21C344.29 52.63 344.75 55.46 344.75 58.71V61.62H312.5V55.06H334.78C334.78 53.53 334.45 52.18 333.78 51C333.12 49.83 332.2 48.91 331.02 48.25C329.86 47.57 328.51 47.23 326.97 47.23C325.36 47.23 323.94 47.6 322.7 48.34C321.47 49.07 320.51 50.06 319.81 51.3C319.12 52.53 318.76 53.9 318.74 55.4V61.64C318.74 63.53 319.09 65.17 319.79 66.54C320.5 67.92 321.5 68.98 322.8 69.72C324.09 70.47 325.62 70.84 327.39 70.84C328.57 70.84 329.65 70.68 330.63 70.34C331.6 70.01 332.44 69.52 333.14 68.85C333.83 68.19 334.36 67.38 334.73 66.42L344.52 67.06C344.02 69.42 343.01 71.47 341.46 73.23C339.94 74.97 337.97 76.33 335.55 77.3C333.15 78.27 330.37 78.75 327.22 78.75Z"/></svg>`;
+/**
+ * Header brand block. Both marks are always in the DOM and CSS picks one off the collapsed
+ * attribute, so there is no JS state to keep in sync. The artwork is decorative (aria-hidden);
+ * the visually-hidden name is what keeps the HUD identifiable to a screen reader in BOTH states.
+ */
+export const BRAND_HTML = `<span class="reticle-brand">${MARK_SVG}${WORDMARK_SVG}<span class="reticle-brand-sr">${BRAND_NAME}</span></span>`;

package/dist/presenter/presenter-config.d.ts

@@ -49,6 +49,23 @@ export interface PresenterOptions {
     endedFadeMs?: number;
 }
 export declare const DEFAULT_PACE = 450;
+/**
+ * The pace to actually use: the default in a browser a human is watching, zero in an automated one.
+ *
+ * The HUD paces `beforeAct` so a person can see the cursor reach the element before it fires. In a
+ * headless browser that is 450ms of nothing, charged to the agent, on every action. Measured with
+ * RETICLE_TRACE across the e2e battery: 42 `act` round-trips, 40 of them in a 452–460ms band —
+ * a fixed cost, not app work — 19.7 SECONDS in total, 98.5% of all time the battery spent in the
+ * browser, while every other command ran in 1–4ms.
+ *
+ * `navigator.webdriver` is the discriminator because it is exactly the question being asked: true
+ * under automation (Playwright, CDP, the browser pool's leased tabs, CI), false in the dev browser
+ * a human has open — the case the HUD exists for, which keeps its pacing untouched.
+ *
+ * An EXPLICIT `paceMs` always wins: a recorded demo runs under automation and still wants the glide,
+ * and an option that quietly ignores what the caller asked for is worse than no option.
+ */
+export declare function effectivePaceMs(requested: number | undefined, nav?: Navigator | undefined): number;
 /**
  * Glow state machine phases (exposed via glowPhase for tests). A burst of activity flips the
  * border IN once on the first activity, holds steady (the slow reticle-pulse breathing keeps running

package/dist/presenter/presenter-config.js

@@ -15,6 +15,27 @@ export const DATA_BUSY = 'data-busy';
 export const BUSY_ON = '1';
 export const BUSY_OFF = '0';
 export const DEFAULT_PACE = 450;
+/**
+ * The pace to actually use: the default in a browser a human is watching, zero in an automated one.
+ *
+ * The HUD paces `beforeAct` so a person can see the cursor reach the element before it fires. In a
+ * headless browser that is 450ms of nothing, charged to the agent, on every action. Measured with
+ * RETICLE_TRACE across the e2e battery: 42 `act` round-trips, 40 of them in a 452–460ms band —
+ * a fixed cost, not app work — 19.7 SECONDS in total, 98.5% of all time the battery spent in the
+ * browser, while every other command ran in 1–4ms.
+ *
+ * `navigator.webdriver` is the discriminator because it is exactly the question being asked: true
+ * under automation (Playwright, CDP, the browser pool's leased tabs, CI), false in the dev browser
+ * a human has open — the case the HUD exists for, which keeps its pacing untouched.
+ *
+ * An EXPLICIT `paceMs` always wins: a recorded demo runs under automation and still wants the glide,
+ * and an option that quietly ignores what the caller asked for is worse than no option.
+ */
+export function effectivePaceMs(requested, nav = 'undefined' === typeof navigator ? undefined : navigator) {
+    if (requested !== undefined)
+        return requested;
+    return true === nav?.webdriver ? 0 : DEFAULT_PACE;
+}
 /**
  * Glow state machine phases (exposed via glowPhase for tests). A burst of activity flips the
  * border IN once on the first activity, holds steady (the slow reticle-pulse breathing keeps running

package/dist/presenter/presenter-controls.d.ts

@@ -1,16 +1,6 @@
 import { HumanControlKind, PresenterTone, SessionState } from '@reticlehq/core';
-/** data-reticle-state attribute on the overlay root; its value is always a SessionState. */
-declare const DATA_RETICLE_STATE = "data-reticle-state";
 /** Border fade-out delay after a session ends (native timer; presenter-only tunable). */
 export declare const ENDED_FADE_MS = 4000;
-/**
- * One replayable flow as pushed to the panel. `start` is the first step's testid anchor — a page hint
- * used to show a flow only where it can actually begin. Absent when the first step isn't testid-anchored.
- */
-export interface FlowChip {
-    name: string;
-    start?: string;
-}
 /** Payload the panel hands to its host when the human drives a control. */
 export interface ControlIntent {
     kind: HumanControlKind;
@@ -70,4 +60,4 @@ export declare class ControlPanel {
      */
     setState(state: SessionState, text?: string, tone?: PresenterTone): void;
 }
-export { DATA_RETICLE_STATE };
+export {};

package/dist/presenter/presenter-controls.js

@@ -178,7 +178,7 @@ export class ControlPanel {
         this.#refs.sendBtn?.addEventListener('click', () => this.#onSend());
         this.#refs.input?.addEventListener('keydown', (e) => {
             // Enter sends; Shift+Enter inserts a newline (falls through to the textarea's default).
-            if (e instanceof KeyboardEvent && e.key === 'Enter' && !e.shiftKey) {
+            if (e instanceof KeyboardEvent && 'Enter' === e.key && !e.shiftKey) {
                 e.preventDefault();
                 this.#onSend();
             }
@@ -248,7 +248,7 @@ export class ControlPanel {
         if (this.#state === SessionState.ENDED)
             return;
         const text = (this.#refs.input?.value ?? '').trim();
-        if (text.length === 0)
+        if (0 === text.length)
             return;
         this.#host.emit(HumanControlKind.MESSAGE, text);
         this.#host.logHuman(text);
@@ -271,15 +271,15 @@ export class ControlPanel {
         const list = Array.isArray(flows) ? flows : [];
         this.#flowItems = list
             .map((f) => {
-            if (typeof f === 'string')
+            if ('string' === typeof f)
                 return f.length > 0 ? { name: f } : null;
-            if (typeof f === 'object' && f !== null) {
+            if ('object' === typeof f && f !== null) {
                 const rec = f;
                 const name = rec['name'];
-                if (typeof name !== 'string' || name.length === 0)
+                if (typeof name !== 'string' || 0 === name.length)
                     return null;
                 const start = rec['start'];
-                return typeof start === 'string' && start.length > 0 ? { name, start } : { name };
+                return 'string' === typeof start && start.length > 0 ? { name, start } : { name };
             }
             return null;
         })
@@ -364,4 +364,3 @@ export class ControlPanel {
         }
     }
 }
-export { DATA_RETICLE_STATE };

package/dist/presenter/presenter-log.js

@@ -74,9 +74,9 @@ export function humanDuration(ms) {
         return `${s}s`;
     const m = Math.floor(s / 60);
     if (m < 60)
-        return s % 60 === 0 ? `${m}m` : `${m}m ${s % 60}s`;
+        return 0 === s % 60 ? `${m}m` : `${m}m ${s % 60}s`;
     const h = Math.floor(m / 60);
-    return m % 60 === 0 ? `${h}h` : `${h}h ${m % 60}m`;
+    return 0 === m % 60 ? `${h}h` : `${h}h ${m % 60}m`;
 }
 /** Per-row timestamp: time since the session's first row, human-readable (e.g. "2m", not "+132.4s"). */
 export function formatElapsed(ms) {