@reticlehq/browser 2.13.1 → 2.14.0

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

@@ -1,22 +1,3 @@
-/**
- * The artwork constants are annotated `: string` deliberately.
- *
- * Without the annotation TypeScript infers a literal type, and every one of these SVG and HTML
- * strings is copied verbatim into the emitted `.d.ts` as its own type. That duplicated the artwork
- * into the published package twice over: this file's declarations alone were 16KB of a 900KB
- * budget, carrying type information nobody can use - no caller cares about the literal type of a
- * `<path d=...>`.
- */
-/**
- * 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 mark
- * lives here as a string (same precedent as SEND_ICON in presenter-controls.ts).
- * Minified - editor metadata, clip paths, masks and sub-0.01 precision stripped - and painted
- * with `currentColor` so the mark tracks --reticle-fg instead of hardcoding the export's #FAFAFA.
- */
-/** Accessible name of the HUD. */
 export declare const BRAND_NAME = "Reticle";
-/** Mark alone (shown in the FAB and compact toolbar). */
 export declare const MARK_SVG: string;
-/** Collapsed FAB control - Reticle mark only. */
 export declare const FAB_TOGGLE_HTML: string;

package/dist/presenter/presenter-brand.js

@@ -1,26 +1,5 @@
-/**
- * The artwork constants are annotated `: string` deliberately.
- *
- * Without the annotation TypeScript infers a literal type, and every one of these SVG and HTML
- * strings is copied verbatim into the emitted `.d.ts` as its own type. That duplicated the artwork
- * into the published package twice over: this file's declarations alone were 16KB of a 900KB
- * budget, carrying type information nobody can use - no caller cares about the literal type of a
- * `<path d=...>`.
- */
-/**
- * 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 mark
- * lives here as a string (same precedent as SEND_ICON in presenter-controls.ts).
- * Minified - editor metadata, clip paths, masks and sub-0.01 precision stripped - and painted
- * with `currentColor` so the mark tracks --reticle-fg instead of hardcoding the export's #FAFAFA.
- */
-/** Accessible name of the HUD. */
 export const BRAND_NAME = 'Reticle';
-/** The two glyph paths of the mark. */
 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 in the FAB and compact toolbar). */
 export const MARK_SVG = `<svg class="reticle-mark" viewBox="0 0 96 94" fill="currentColor" aria-hidden="true">${MARK_PATHS}</svg>`;
-/** FAB-sized mark for the collapsed circular control. */
 const FAB_MARK_SVG = `<svg class="reticle-fab-mark" viewBox="0 0 96 94" fill="currentColor" aria-hidden="true">${MARK_PATHS}</svg>`;
-/** Collapsed FAB control - Reticle mark only. */
 export const FAB_TOGGLE_HTML = `<button type="button" class="reticle-fab" data-reticle-fab aria-label="Start ${BRAND_NAME}" aria-expanded="false">${FAB_MARK_SVG}<span class="reticle-fab-pulse" aria-hidden="true"></span><span data-reticle-mark-count class="reticle-fab-badge" hidden>0</span></button>`;

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

@@ -1,14 +1,4 @@
 import type { ControlHandler } from './presenter-controls.js';
-/**
- * Presenter tunables + option surface. Split out of presenter.ts so that file is just the controller
- * under the size cap; these are pure declarations (interfaces + named constants), no behavior. None
- * cross the browser↔bridge↔agent wire, so they live here, not in @reticlehq/core.
- */
-/**
- * Border behavior.
- * - 'session': base border persists connect→disconnect; the busy machine drives only the shimmer.
- * - 'busy': back-compat - the busy machine toggles the base border on/off.
- */
 export declare const BorderMode: {
     readonly SESSION: "session";
     readonly BUSY: "busy";
@@ -20,179 +10,85 @@ export declare const BUSY_ON = "1";
 export declare const BUSY_OFF = "0";
 export interface PresenterOptions {
     paceMs?: number;
-    /** Injected monotonic clock for the glow state machine (tests drive transitions). */
     now?: () => number;
-    /** Quiet window before busy -> fading. Overridable so tests run fast. */
     idleAfterMs?: number;
-    /** Fade duration before fading -> idle (keep in sync with the glow CSS opacity transition). */
     glowFadeMs?: number;
-    /** Liveness heartbeat interval (ms). Overridable so tests run fast. */
     heartbeatMs?: number;
-    /** Quiet (ms) after which the act strip shows the live "idle · {duration}" clock. Test-overridable. */
     idleNoticeMs?: number;
-    /** Quiet (ms) after which the session AUTO-ENDS (glow off, panel kept). Default 5min; agent-tunable. */
     idleEndMs?: number;
-    /** Session id, surfaced in the exported run state. */
     sessionId?: string;
-    /** Deprecated: accepted for source compat; the live log no longer auto-expires. */
     narrationDwellMs?: number;
-    /**
-     * 'session' (default): base border persists connect→disconnect, busy machine drives only the
-     * shimmer. 'busy': back-compat - busy machine toggles the base border on/off.
-     */
     border?: BorderMode;
-    /** Max accumulated activity-log rows before the oldest are pruned. Default 50. */
     logMax?: number;
-    /** Called when the human clicks pause/resume/end or sends a message from the panel. */
     onControl?: ControlHandler;
-    /** Overridable ended-border fade delay (native timer). Default 4000. */
     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
- * uninterrupted - no per-action restart/strobe), then fades OUT once after a quiet window.
- */
 export declare const GlowPhase: {
     readonly IDLE: "idle";
     readonly BUSY: "busy";
     readonly FADING: "fading";
 };
 export type GlowPhase = (typeof GlowPhase)[keyof typeof GlowPhase];
-/** Quiet window before busy -> fading. */
 export declare const IDLE_AFTER_MS = 700;
-/** Liveness heartbeat: how often the act strip refreshes its "idle · {duration}" clock. */
 export declare const HEARTBEAT_MS = 1000;
-/**
- * After this much quiet, the act strip stops showing the last action and starts a LIVE, ticking
- * "◌ idle · {duration} since last action" - so a watcher can tell a 3s think from a dead agent
- * (the killer gap: a frozen panel used to look identical whether the agent paused or stopped).
- */
 export declare const IDLE_NOTICE_MS = 4000;
-/** Act-strip copy (presenter-only UI). */
 export declare const ACT_STRIP: {
     readonly READY: "Ready";
     readonly IDLE_PREFIX: "idle · ";
     readonly NOW: "now";
     readonly SINCE_LAST: " since last action";
 };
-/** Default session-idle-end: after this much quiet the session auto-ends (glow off, panel persists
- * for analysis). Agent-tweakable via reticle_session { idleEndMs } for the app's needs. */
 export declare const IDLE_END_MS = 300000;
-/** Floor for a tweaked idle-end so the agent can't set a uselessly tiny window. */
 export declare const IDLE_END_MIN_MS = 5000;
-/** Must match the glow CSS opacity transition.25s) so phase reaches idle after the fade paints. */
 export declare const GLOW_FADE_MS = 250;
 export declare const GLOW_ON = "1";
 export declare const GLOW_OFF = "0";
 export declare const DATA_ON = "data-on";
-/** The overlay root's state attribute, which the shell styles resolve colour against. */
 export declare const STATE_ATTR = "data-reticle-state";
-/**
- * Not a SessionState: there is no session. It is the absence of one, said out loud.
- *
- * Kept off `SessionState` deliberately — that enum crosses the wire, and this state exists only
- * because nothing crossed the wire.
- */
 export declare const UNREACHABLE_STATE = "unreachable";
-/** Overlay-root attribute toggled when the HUD is collapsed to the FAB. */
 export declare const MIN_ATTR = "data-reticle-min";
-/** Overlay-root attribute toggled when the agent chat panel is open. */
 export declare const CHAT_ATTR = "data-reticle-chat";
-/** Fixed dock wrapper that stacks chat above the morphing HUD shell. */
 export declare const DOCK_ATTR = "data-reticle-dock";
-/** Collapsed circular control that expands the toolbar. */
 export declare const FAB_ATTR = "data-reticle-fab";
-/** Toolbar chat toggle button. */
 export declare const CHAT_TOGGLE_ATTR = "data-reticle-chat-toggle";
-/** Agent chat panel anchored to the dock. */
 export declare const CHAT_PANEL_ATTR = "data-reticle-chat-panel";
-/** Chat panel opens above or below the HUD bar depending on viewport space. */
 export declare const CHAT_PLACEMENT_ATTR = "data-reticle-chat-placement";
-/** Settings card opens above or below the HUD bar depending on viewport space. */
 export declare const SETTINGS_PLACEMENT_ATTR = "data-reticle-settings-placement";
-/** Horizontal alignment of dock-anchored panels (start = left, end = right). */
 export declare const DOCK_ALIGN_ATTR = "data-reticle-dock-align";
 export declare const Placement: {
     readonly ABOVE: "above";
     readonly BELOW: "below";
 };
-/** Show/hide annotation markers. */
 export declare const MARKERS_BTN_ATTR = "data-reticle-markers-btn";
-/** Clear every annotation on the page. */
 export declare const CLEAR_MARKS_ATTR = "data-reticle-clear-marks";
-/** Collapsed FAB annotation-count badge. */
 export declare const MARK_COUNT_ATTR = "data-reticle-mark-count";
-/**
- * Turn annotation on and off from the toolbar.
- *
- * Annotation used to be reachable only as a side effect of expanding the HUD, which meant there was
- * no way to keep the HUD open and stop annotating, and nothing on screen said the mode existed at
- * all. It is a mode the user chooses, so it gets a control they can see and press.
- */
 export declare const ANNOTATE_BTN_ATTR = "data-reticle-annotate-btn";
-/** Minimise the agent chat back to the toolbar, without collapsing the whole HUD. */
 export declare const CHAT_MIN_ATTR = "data-reticle-chat-min";
-/** Overlay flag: is the impact report on screen. */
 export declare const REPORT_ATTR = "data-reticle-report";
-/** The report panel itself. */
 export declare const REPORT_PANEL_ATTR = "data-reticle-report-panel";
-/** The report's close button. */
 export declare const REPORT_CLOSE_ATTR = "data-reticle-report-close";
-/** The toolbar button that opens the report. */
 export declare const REPORT_BTN_ATTR = "data-reticle-report-btn";
-/** The capsule that stands in for the chat while it is minimised - state dot + last action. */
 export declare const CHAT_PILL_ATTR = "data-reticle-chat-pill";
-/** Settings gear is open - the card sits above the dock. */
 export declare const SETTINGS_ATTR = "data-reticle-settings";
 export declare const SETTINGS_BTN_ATTR = "data-reticle-settings-btn";
 export declare const SETTINGS_PANEL_ATTR = "data-reticle-settings-panel";
 export declare const SETTINGS_CLOSE_ATTR = "data-reticle-settings-close";
 export declare const SETTING_KEY_ATTR = "data-reticle-setting";
 export declare const SETTINGS_STORAGE_KEY = "reticle-presenter-settings";
-/** Accent swatch applied to the dock chrome. */
-/** Overlay flag: is the page-edge glow wanted at all (user setting). */
 export declare const AMBIENT_GLOW_ATTR = "data-reticle-ambient-glow";
-/** Overlay mirror of the activity strip's liveness, so CSS can pick the ACTIVE status colour. */
 export declare const LIVENESS_ATTR = "data-reticle-live";
-/** When 1, a transparent blocker captures page pointer events. */
 export declare const BLOCK_ATTR = "data-reticle-block";
-/** When 1, the dock is hidden until the page reloads. */
 export declare const HIDDEN_UNTIL_RESTART_ATTR = "data-reticle-hidden";
-/** When 0, activity-log timestamps are hidden. */
 export declare const LOG_TIMESTAMPS_ATTR = "data-reticle-log-ts";
-/** When 1, the chat panel uses a narrower width. */
-/** When 1, HUD motion is reduced for accessibility. */
 export declare const REDUCE_MOTION_ATTR = "data-reticle-reduce-motion";
-/** Docs opened from the settings footer. */
 export declare const MCP_DOCS_URL: string;
-/** HUD has been dragged off the default dock - positioned with explicit left/top. */
 export declare const HUD_DRAGGED_ATTR = "data-dragged";
-/** CSS custom properties written when the HUD is dragged. */
 export declare const HUD_POS_X_VAR = "--reticle-hud-x";
 export declare const HUD_POS_Y_VAR = "--reticle-hud-y";
-/** Pointer movement below this threshold is treated as a click, not a drag. */
 export declare const HUD_DRAG_THRESHOLD_PX = 4;
-/** Minimum gap between a dragged HUD and the viewport edge. */
 export declare const HUD_DOCK_MARGIN_PX = 8;
-/** Interactive nodes inside the drag handle that must not start a drag (not the FAB itself). */
 export declare const HUD_DRAG_IGNORE_SEL: string;
 export declare const THROTTLED_ATTR = "data-reticle-throttled";
+export declare const Z_HUD_TOOLTIP = 100;

package/dist/presenter/presenter-config.js

@@ -1,163 +1,74 @@
-/**
- * Presenter tunables + option surface. Split out of presenter.ts so that file is just the controller
- * under the size cap; these are pure declarations (interfaces + named constants), no behavior. None
- * cross the browser↔bridge↔agent wire, so they live here, not in @reticlehq/core.
- */
-/**
- * Border behavior.
- * - 'session': base border persists connect→disconnect; the busy machine drives only the shimmer.
- * - 'busy': back-compat - the busy machine toggles the base border on/off.
- */
 export const BorderMode = { SESSION: 'session', BUSY: 'busy' };
 export const DEFAULT_BORDER_MODE = BorderMode.SESSION;
 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
- * uninterrupted - no per-action restart/strobe), then fades OUT once after a quiet window.
- */
 export const GlowPhase = {
     IDLE: 'idle',
     BUSY: 'busy',
     FADING: 'fading',
 };
-/** Quiet window before busy -> fading. */
 export const IDLE_AFTER_MS = 700;
-/** Liveness heartbeat: how often the act strip refreshes its "idle · {duration}" clock. */
 export const HEARTBEAT_MS = 1000;
-/**
- * After this much quiet, the act strip stops showing the last action and starts a LIVE, ticking
- * "◌ idle · {duration} since last action" - so a watcher can tell a 3s think from a dead agent
- * (the killer gap: a frozen panel used to look identical whether the agent paused or stopped).
- */
 export const IDLE_NOTICE_MS = 4000;
-/** Act-strip copy (presenter-only UI). */
 export const ACT_STRIP = {
     READY: 'Ready',
     IDLE_PREFIX: 'idle · ',
     NOW: 'now',
     SINCE_LAST: ' since last action',
 };
-/** Default session-idle-end: after this much quiet the session auto-ends (glow off, panel persists
- * for analysis). Agent-tweakable via reticle_session { idleEndMs } for the app's needs. */
 export const IDLE_END_MS = 300_000;
-/** Floor for a tweaked idle-end so the agent can't set a uselessly tiny window. */
 export const IDLE_END_MIN_MS = 5_000;
-/** Must match the glow CSS opacity transition.25s) so phase reaches idle after the fade paints. */
 export const GLOW_FADE_MS = 250;
 export const GLOW_ON = '1';
 export const GLOW_OFF = '0';
 export const DATA_ON = 'data-on';
-/** The overlay root's state attribute, which the shell styles resolve colour against. */
 export const STATE_ATTR = 'data-reticle-state';
-/**
- * Not a SessionState: there is no session. It is the absence of one, said out loud.
- *
- * Kept off `SessionState` deliberately — that enum crosses the wire, and this state exists only
- * because nothing crossed the wire.
- */
 export const UNREACHABLE_STATE = 'unreachable';
-/** Overlay-root attribute toggled when the HUD is collapsed to the FAB. */
 export const MIN_ATTR = 'data-reticle-min';
-/** Overlay-root attribute toggled when the agent chat panel is open. */
 export const CHAT_ATTR = 'data-reticle-chat';
-/** Fixed dock wrapper that stacks chat above the morphing HUD shell. */
 export const DOCK_ATTR = 'data-reticle-dock';
-/** Collapsed circular control that expands the toolbar. */
 export const FAB_ATTR = 'data-reticle-fab';
-/** Toolbar chat toggle button. */
 export const CHAT_TOGGLE_ATTR = 'data-reticle-chat-toggle';
-/** Agent chat panel anchored to the dock. */
 export const CHAT_PANEL_ATTR = 'data-reticle-chat-panel';
-/** Chat panel opens above or below the HUD bar depending on viewport space. */
 export const CHAT_PLACEMENT_ATTR = 'data-reticle-chat-placement';
-/** Settings card opens above or below the HUD bar depending on viewport space. */
 export const SETTINGS_PLACEMENT_ATTR = 'data-reticle-settings-placement';
-/** Horizontal alignment of dock-anchored panels (start = left, end = right). */
 export const DOCK_ALIGN_ATTR = 'data-reticle-dock-align';
 export const Placement = { ABOVE: 'above', BELOW: 'below' };
-/** Show/hide annotation markers. */
 export const MARKERS_BTN_ATTR = 'data-reticle-markers-btn';
-/** Clear every annotation on the page. */
 export const CLEAR_MARKS_ATTR = 'data-reticle-clear-marks';
-/** Collapsed FAB annotation-count badge. */
 export const MARK_COUNT_ATTR = 'data-reticle-mark-count';
-/**
- * Turn annotation on and off from the toolbar.
- *
- * Annotation used to be reachable only as a side effect of expanding the HUD, which meant there was
- * no way to keep the HUD open and stop annotating, and nothing on screen said the mode existed at
- * all. It is a mode the user chooses, so it gets a control they can see and press.
- */
 export const ANNOTATE_BTN_ATTR = 'data-reticle-annotate-btn';
-/** Minimise the agent chat back to the toolbar, without collapsing the whole HUD. */
 export const CHAT_MIN_ATTR = 'data-reticle-chat-min';
-/** Overlay flag: is the impact report on screen. */
 export const REPORT_ATTR = 'data-reticle-report';
-/** The report panel itself. */
 export const REPORT_PANEL_ATTR = 'data-reticle-report-panel';
-/** The report's close button. */
 export const REPORT_CLOSE_ATTR = 'data-reticle-report-close';
-/** The toolbar button that opens the report. */
 export const REPORT_BTN_ATTR = 'data-reticle-report-btn';
-/** The capsule that stands in for the chat while it is minimised - state dot + last action. */
 export const CHAT_PILL_ATTR = 'data-reticle-chat-pill';
-/** Settings gear is open - the card sits above the dock. */
 export const SETTINGS_ATTR = 'data-reticle-settings';
 export const SETTINGS_BTN_ATTR = 'data-reticle-settings-btn';
 export const SETTINGS_PANEL_ATTR = 'data-reticle-settings-panel';
 export const SETTINGS_CLOSE_ATTR = 'data-reticle-settings-close';
 export const SETTING_KEY_ATTR = 'data-reticle-setting';
 export const SETTINGS_STORAGE_KEY = 'reticle-presenter-settings';
-/** Accent swatch applied to the dock chrome. */
-/** Overlay flag: is the page-edge glow wanted at all (user setting). */
 export const AMBIENT_GLOW_ATTR = 'data-reticle-ambient-glow';
-/** Overlay mirror of the activity strip's liveness, so CSS can pick the ACTIVE status colour. */
 export const LIVENESS_ATTR = 'data-reticle-live';
-/** When 1, a transparent blocker captures page pointer events. */
 export const BLOCK_ATTR = 'data-reticle-block';
-/** When 1, the dock is hidden until the page reloads. */
 export const HIDDEN_UNTIL_RESTART_ATTR = 'data-reticle-hidden';
-/** When 0, activity-log timestamps are hidden. */
 export const LOG_TIMESTAMPS_ATTR = 'data-reticle-log-ts';
-/** When 1, the chat panel uses a narrower width. */
-/** When 1, HUD motion is reduced for accessibility. */
 export const REDUCE_MOTION_ATTR = 'data-reticle-reduce-motion';
-/** Docs opened from the settings footer. */
 export const MCP_DOCS_URL = 'https://github.com/reticlehq/reticle/blob/main/docs/getting-started.md';
-/** HUD has been dragged off the default dock - positioned with explicit left/top. */
 export const HUD_DRAGGED_ATTR = 'data-dragged';
-/** CSS custom properties written when the HUD is dragged. */
 export const HUD_POS_X_VAR = '--reticle-hud-x';
 export const HUD_POS_Y_VAR = '--reticle-hud-y';
-/** Pointer movement below this threshold is treated as a click, not a drag. */
 export const HUD_DRAG_THRESHOLD_PX = 4;
-/** Minimum gap between a dragged HUD and the viewport edge. */
 export const HUD_DOCK_MARGIN_PX = 8;
-/** Interactive nodes inside the drag handle that must not start a drag (not the FAB itself). */
-export const HUD_DRAG_IGNORE_SEL = '[data-reticle-pause], [data-reticle-annotate-btn], [data-reticle-markers-btn], [data-reticle-clear-marks], [data-reticle-end], [data-reticle-min-btn], [data-reticle-settings-btn], [data-reticle-settings-panel], [data-reticle-report-btn], [data-reticle-report-panel], [data-reticle-chat-panel], [data-reticle-chat-toggle], [data-reticle-workspace-btn], [data-reticle-workspace-menu], [data-reticle-copy], [data-reticle-export], [data-reticle-send], input, textarea, select, a, .reticle-head-ctl, [data-reticle-tally], .reticle-maxhint';
+export const HUD_DRAG_IGNORE_SEL = '[data-reticle-pause], [data-reticle-annotate-btn], [data-reticle-markers-btn], [data-reticle-clear-marks], [data-reticle-end], [data-reticle-min-btn], [data-reticle-settings-btn], [data-reticle-settings-panel], [data-reticle-report-btn], [data-reticle-report-panel], [data-reticle-chat-panel], [data-reticle-chat-toggle], [data-reticle-workspace-btn], [data-reticle-workspace-menu], [data-reticle-copy], [data-reticle-export], input, textarea, select, a, .reticle-head-ctl, [data-reticle-tally], .reticle-maxhint';
 export const THROTTLED_ATTR = 'data-reticle-throttled';
+export const Z_HUD_TOOLTIP = 100;

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

@@ -1,21 +1,14 @@
 import { HumanControlKind, PresenterTone, SessionState } from '@reticlehq/core';
-/** Border fade-out delay after a session ends (native timer; presenter-only tunable). */
 export declare const ENDED_FADE_MS = 4000;
-/** Payload the panel hands to its host when the human drives a control. */
 export interface ControlIntent {
     kind: HumanControlKind;
     text?: string;
 }
 export type ControlHandler = (intent: ControlIntent) => void;
-/** CSS for the control surface (injected with the rest of the presenter stylesheet). */
 export declare const CONTROLS_CSS: string;
-/** Icon toolbar: pause, chat, markers, end, clear - copy/export appear after a run ends. */
 export declare const CONTROLS_TOOLBAR_HTML: string;
-/** Banner markup (between head and log, hidden unless ended). */
 export declare const CONTROLS_BANNER_HTML = "<div data-reticle-banner class=\"reticle-banner\">Session ended</div>";
-/** Replay-a-flow row (between log and footer); buttons are filled in by setFlows once flows arrive. */
 export declare const CONTROLS_FLOWS_HTML = "<div data-reticle-flows class=\"reticle-flows\"><span class=\"reticle-flows-cap\">Replay a flow</span></div>";
-/** Footer markup: composer only (export icons live in the toolbar). */
 export declare const CONTROLS_FOOT_HTML: string;
 interface ControlPanelHost {
     emit: (kind: HumanControlKind, text?: string) => void;
@@ -25,36 +18,14 @@ interface ControlPanelHost {
     clearRunLog?: () => void;
     onStateChange?: (state: SessionState) => void;
 }
-/**
- * The live-control panel: owns the control element refs, the SessionState, the ended-fade timer,
- * the DOM wiring, and the data-reticle-state visual machine. Split out of Presenter to keep both files
- * under the 500-line cap. A click handler both emits a control AND optimistically applies state; the
- * server's PRESENTER echo re-syncs via setState only (never emits) so a control is delivered once.
- */
 export declare class ControlPanel {
     #private;
     constructor(host: ControlPanelHost);
     get state(): SessionState;
-    /** Query control refs out of the mounted root and bind the DOM listeners, then paint active. */
     mount(root: HTMLElement, glow: HTMLElement | undefined): void;
-    /** Clear any pending ended-fade timer (called from Presenter.destroy). */
     teardown(): void;
-    /** Render the replayable-flow chips from the server push. Each ▶ click re-runs that flow, no agent.
-     * Takes the raw wire value and narrows it here (the panel is the consumer of this push). */
     setFlows(flows: unknown): void;
-    /**
-     * Re-render the replay chips for the CURRENT page. A flow "starts here" iff its first step's anchor
-     * (a testid `start` hint) is present in the live DOM; flows with no start hint (signal/role-first,
-     * un-checkable) always show. Called on connect and on every route change so the list tracks the page -
-     * so you never see (or click) a flow that can't replay from where you are. Existing flows benefit
-     * without re-recording, since the hint is derived from the first step, not stored on the flow.
-     */
     refilterFlows(): void;
-    /**
-     * Drive the panel's visual state. Idempotent; NEVER emits a control - the shared path for both the
-     * optimistic local click and the authoritative server PRESENTER echo. Only the ended-border fade
-     * touches a clock, via the injected native timer.
-     */
     setState(state: SessionState, text?: string, tone?: PresenterTone): void;
 }
 export {};