@usedocent/sdk-core 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,392 @@
+import { MascotState, AnchorRef, ToolResult, TurnRecord, VoiceGrant, Snapshot, MascotPaletteInput, SnapshotNode, ClientFrame, ServerFrame } from '@usedocent/shared';
+import { DotHandle, DotOptions, PresetName } from '@usedocent/mascot';
+
+type Corner = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+type Edge = 'left' | 'right';
+type Placement = {
+    kind: 'corner';
+    corner: Corner;
+} | {
+    kind: 'edge';
+    edge: Edge;
+    y: number;
+};
+interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+declare const INSET = 10;
+declare const DEFAULT_PLACEMENT: Placement;
+declare const nearestCorner: (cx: number, cy: number, vw: number, vh: number) => Corner;
+declare const cornerOrder: (from: Corner, vw: number, vh: number, size: number) => Corner[];
+declare const placementToPoint: (p: Placement, vw: number, vh: number, size: number) => {
+    x: number;
+    y: number;
+};
+declare const rectsOverlap: (a: Rect, b: Rect) => boolean;
+declare const rectNear: (a: Rect, b: Rect, gap: number) => boolean;
+declare const resolveKeepOut: (p: Placement, blockers: Rect[], vw: number, vh: number, size: number) => Placement;
+declare const snapPlacement: (cx: number, cy: number, vw: number, vh: number, size: number, mobile: boolean) => Placement;
+
+interface PresenceStorage {
+    loadPlacement(): Placement | null;
+    savePlacement(p: Placement): void;
+    hasSeen(): boolean;
+    markSeen(): void;
+    dismissals(): number;
+    addDismissal(): number;
+}
+declare const createStorage: (appId: string, userId: string, win?: Window) => PresenceStorage;
+
+declare const STATE_ANNOUNCEMENTS: Record<MascotState, string>;
+interface LiveRegion {
+    el: HTMLElement;
+    announce(text: string): void;
+}
+declare const createLiveRegion: (root: ShadowRoot | HTMLElement) => LiveRegion;
+
+declare const FIRST_RUN_CAPTION = "I'm Docent. Tap if you want a hand.";
+interface CaptionPanelOptions {
+    reducedMotion: boolean;
+    onClose(): void;
+    onToggleMute(muted: boolean): void;
+    returnFocusTo: HTMLElement;
+    /** Retained for compatibility; captions now stream by character, not by word. */
+    wordMs?: number;
+}
+interface CaptionPanel {
+    el: HTMLElement;
+    readonly isOpen: boolean;
+    readonly isMuted: boolean;
+    readonly composer: HTMLInputElement | null;
+    open(focus?: boolean): void;
+    close(returnFocus?: boolean): void;
+    setMuted(muted: boolean): void;
+    addCaption(role: 'docent' | 'user', text: string): HTMLElement;
+    setComposer(onSubmit: (text: string) => void): void;
+    streamCaption(role: 'docent', el: HTMLElement, delta: string): void;
+    /** Finishes a caption at once: shows all of it and drops the caret. */
+    settleCaption(el: HTMLElement): void;
+    /**
+     * Asks the user to confirm an action the guard withheld, and returns whether it was shown.
+     *
+     * The guide proposes; the guard withholds; the user decides. Pressing the button here IS the
+     * explicit request PRD rule 1 requires, in the same turn, so nothing about the guarantee moves:
+     * it just stops the user having to phrase the request again to get what they already meant.
+     */
+    offer(label: string, onAccept: () => void): boolean;
+    /** Drops any pending offer. A stale offer belongs to a turn that is over. */
+    clearOffer(): void;
+    showFirstRun(): void;
+    destroy(): void;
+}
+declare const createCaptionPanel: (root: ShadowRoot, options: CaptionPanelOptions) => CaptionPanel;
+
+declare const overlayStyles = "\n:host {\n  /* Read the host's value, fall back to ours. Declaring --docent-accent here instead would set\n     the property ON the host element, which beats the value inherited from the page: the\n     documented theming hook silently did nothing, and every overlay stayed purple inside every\n     customer's app no matter what they set. The rules below use the internal names, so the\n     public --docent-* names stay purely inputs. */\n  --dk-accent: var(--docent-accent, #7f77dd);\n  --dk-radius: var(--docent-radius, 16px);\n  --dk-font: var(--docent-font, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif);\n  --dk-ink: var(--docent-ink, #130e30);\n  --dk-surface: var(--docent-surface, #ffffff);\n  --docent-ease: cubic-bezier(0.2, 0, 0, 1);\n  /* A drop is not a state change. --docent-ease decelerates hard, which is right for a face\n     changing expression and wrong for an object being put down: it spends its last 200ms\n     crawling the final 20px, and a mascot with visible weight reads that crawl as lag rather\n     than as easing. The snap curve keeps speed most of the way and settles quickly. */\n  --docent-snap: cubic-bezier(0.32, 0.72, 0, 1);\n  --docent-snap-dur: 260ms;\n  position: fixed;\n  inset: 0;\n  pointer-events: none;\n  z-index: 2147483000;\n  font-family: var(--dk-font);\n  color: var(--dk-ink);\n}\n.docent-dot {\n  position: absolute;\n  left: 0;\n  top: 0;\n  translate: var(--docent-x, 0px) var(--docent-y, 0px);\n  transition-property: translate;\n  transition-duration: var(--docent-snap-dur);\n  transition-timing-function: var(--docent-snap);\n  pointer-events: auto;\n  touch-action: none;\n  appearance: none;\n  border: 0;\n  padding: 0;\n  margin: 0;\n  background: transparent;\n  line-height: 0;\n  cursor: grab;\n  border-radius: 9999px;\n}\n.docent-dot[data-dragging='true'] { transition-duration: 0ms; cursor: grabbing; }\n.docent-dot:active { scale: 0.96; transition-property: translate, scale; }\n.docent-dot:focus-visible { outline: 3px solid var(--dk-accent); outline-offset: 2px; }\n.docent-panel {\n  position: absolute;\n  width: min(360px, calc(100vw - 20px));\n  max-height: min(60vh, 480px);\n  display: flex;\n  flex-direction: column;\n  pointer-events: auto;\n  /* Glass, so the panel reads as sitting on the host's page rather than as a white card\n     dropped over it. The surface colour still comes from the host token, just at low alpha,\n     so a dark app gets dark glass. */\n  background: color-mix(in oklab, var(--dk-surface) 55%, transparent);\n  -webkit-backdrop-filter: blur(20px) saturate(180%);\n  backdrop-filter: blur(20px) saturate(180%);\n  color: var(--dk-ink);\n  border-radius: var(--dk-radius);\n  /* A hairline rather than a border: enough to hold an edge against a busy page. */\n  border: 1px solid color-mix(in oklab, var(--dk-ink) 8%, transparent);\n  box-shadow: 0 1px 2px rgb(0 0 0 / 0.04), 0 8px 24px rgb(0 0 0 / 0.08);\n  font-size: 14px;\n  line-height: 1.4;\n}\n/* Without backdrop-filter there is no glass, only a see-through panel over live text, so this\n   falls back to the opaque surface instead. */\n@supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {\n  .docent-panel { background: var(--dk-surface); }\n}\n.docent-panel[hidden] { display: none; }\n.docent-panel header { display: flex; align-items: center; gap: 4px; padding: 8px 8px 8px 16px; }\n.docent-panel h2 { flex: 1; margin: 0; font-size: 14px; font-weight: 600; }\n.docent-panel h2:focus { outline: none; }\n.docent-iconbtn {\n  appearance: none; border: 0; background: transparent; color: inherit; cursor: pointer;\n  width: 40px; height: 40px; border-radius: 9999px; display: inline-grid; place-items: center; font: inherit;\n}\n.docent-iconbtn:hover { background: rgb(0 0 0 / 0.06); }\n.docent-iconbtn:focus-visible { outline: 2px solid var(--dk-accent); outline-offset: -2px; }\n.docent-iconbtn[aria-pressed='true'] { color: var(--dk-accent); }\n@media (pointer: coarse) { .docent-iconbtn { width: 44px; height: 44px; } }\n.docent-transcript { list-style: none; margin: 0; padding: 0 16px 16px; overflow-y: auto; display: flex; flex-direction: column; gap: 8px; }\n.docent-transcript li { padding: 6px 2px; border-radius: 12px; max-width: 92%; }\n/* Docent's own words sit directly on the glass. A filled bubble here would put a card inside\n   a card, which is the thing the glass is meant to get rid of. */\n.docent-transcript li[data-role='docent'] { align-self: flex-start; }\n.docent-transcript li[data-role='user'] {\n  padding: 8px 12px;\n  background: color-mix(in oklab, var(--dk-accent) 88%, transparent);\n  color: #fff;\n  align-self: flex-end;\n}\n/* The caret marks text still arriving, and goes when the sentence is complete. */\n.docent-caret {\n  display: inline-block; width: 2px; height: 1em; margin-left: 2px; vertical-align: -0.15em;\n  background: currentColor; opacity: 0.7; animation: docent-caret-blink 1s steps(1) infinite;\n}\n@keyframes docent-caret-blink { 0%, 49% { opacity: 0.7; } 50%, 100% { opacity: 0; } }\n.docent-sr-only {\n  position: absolute; width: 1px; height: 1px; margin: -1px; padding: 0; overflow: hidden;\n  clip: rect(0 0 0 0); clip-path: inset(50%); white-space: nowrap; border: 0;\n}\n.docent-overlay { position: absolute; inset: 0; pointer-events: none; }\n.docent-overlay[hidden] { display: none; }\n.docent-dim { position: absolute; inset: 0; width: 100%; height: 100%; }\n.docent-dim[hidden] { display: none; }\n.docent-marker {\n  position: absolute; left: 0; top: 0; width: 24px; height: 24px;\n  translate: 0 0; transition-property: translate; transition-duration: 700ms; transition-timing-function: var(--docent-ease);\n}\n.docent-cursor {\n  position: absolute; inset: 0; width: 24px; height: 24px;\n  fill: var(--dk-accent);\n  /* Derived, never configured: the edge contrasts with the host's accent, so a pale brand does\n     not lose its silhouette on a pale page. Computed in tools/contrast.ts. */\n  stroke: var(--docent-pointer-edge, #fff); stroke-width: 2.25; stroke-linejoin: round;\n  paint-order: stroke fill;\n  /* Separation from the page behind is the shadow's job; the edge separates fill from outline.\n     Two jobs, two devices. */\n  filter: drop-shadow(0 1px 2px rgb(0 0 0 / 0.28));\n}\n/* Mirrored about the tip, so the body swings away from the control rather than across it. */\n.docent-marker[data-facing='left'] .docent-cursor { transform: scaleX(-1); transform-origin: 4px 2px; }\n/* The click: two rings leaving the tip. */\n.docent-pulse, .docent-pulse::after {\n  position: absolute; left: 4px; top: 2px; width: 14px; height: 14px; margin: -7px 0 0 -7px;\n  border-radius: 9999px; border: 2px solid var(--dk-accent); opacity: 0;\n}\n.docent-pulse { content: ''; }\n.docent-pulse::after { content: ''; left: 7px; top: 7px; animation-delay: 260ms; }\n.docent-marker[data-arrived] .docent-pulse,\n.docent-marker[data-arrived] .docent-pulse::after {\n  animation: docent-click 1200ms var(--docent-ease) 3;\n}\n@keyframes docent-click {\n  from { opacity: 0.75; scale: 0.4; }\n  to { opacity: 0; scale: 2.2; }\n}\n.docent-marker[hidden] { display: none; }\n.docent-composer { display: flex; gap: 6px; padding: 8px 12px 12px; }\n.docent-offer {\n  display: flex; align-items: center; gap: 8px; padding: 8px 12px 0; font-size: 13px;\n}\n.docent-offer span { flex: 1; min-width: 0; }\n.docent-offer button {\n  font: inherit; font-size: 12px; padding: 6px 10px; border-radius: 9999px; cursor: pointer;\n  transition-property: scale; transition-duration: 120ms;\n}\n.docent-offer button:active { scale: 0.96; }\n.docent-offer-yes { border: 0; background: var(--dk-accent); color: #fff; font-weight: 600; }\n.docent-offer-no {\n  border: 1px solid color-mix(in oklab, var(--dk-ink) 20%, transparent);\n  background: transparent; color: inherit;\n}\n.docent-offer[hidden] { display: none; }\n.docent-composer input { flex: 1; min-width: 0; height: 40px; padding: 0 12px; border-radius: 9999px; border: 1px solid color-mix(in oklab, var(--dk-ink) 20%, transparent); background: transparent; color: inherit; font: inherit; }\n.docent-composer input:focus-visible { outline: 2px solid var(--dk-accent); outline-offset: 1px; }\n.docent-send { height: 40px; padding: 0 14px; border-radius: 9999px; border: 0; background: var(--dk-accent); color: #fff; font: inherit; font-weight: 600; cursor: pointer; transition-property: scale; transition-duration: 120ms; }\n.docent-send:active { scale: 0.96; }\n.docent-send:focus-visible { outline: 2px solid var(--dk-accent); outline-offset: 1px; }\n@media (pointer: coarse) { .docent-composer input, .docent-send { height: 44px; } }\n@media (prefers-reduced-motion: reduce) {\n  .docent-dot, .docent-panel { transition-duration: 0ms !important; }\n  .docent-marker { transition-duration: 0ms !important; }\n  /* The caret still marks unfinished text, it just stops blinking (PRD rule 6). */\n  .docent-caret { animation: none !important; }\n  /* The cursor still arrives and still points; it just does not pulse. */\n  .docent-pulse, .docent-pulse::after { animation: none !important; }\n}\n";
+
+interface RouterAdapter {
+    navigate(path: string): void | Promise<void>;
+    currentPath(): string;
+}
+/** Fallback for hosts without a router adapter: pushState and let listeners react to popstate. */
+declare const locationAdapter: (win: Window) => RouterAdapter;
+
+interface ToolsOptions {
+    presence: PresenceHandle;
+    doc?: Document;
+    router?: RouterAdapter;
+    threshold?: number;
+}
+interface Tools {
+    spotlight(anchor: AnchorRef): ToolResult;
+    point(anchor: AnchorRef): ToolResult;
+    scroll_to(anchor: AnchorRef): ToolResult;
+    navigate(route: string): Promise<ToolResult>;
+    act(anchor: AnchorRef, action: 'click' | 'fill', opts: {
+        userRequested: boolean;
+        value?: string;
+    }): ToolResult;
+    clear(): void;
+    destroy(): void;
+}
+declare const createTools: (options: ToolsOptions) => Tools;
+
+interface VoiceInput {
+    grant: VoiceGrant;
+    tools: Tools;
+    presence: PresenceHandle;
+    onEnd(): void;
+    /** Origin of the Docent API, for vendors whose signalling goes through our Worker. */
+    apiUrl: string;
+    /** Proves this browser owns the session. Never sent to the vendor, only to our own Worker. */
+    clientSecret: string;
+    /**
+     * Hand a user turn to the Durable Object and get back what it decided to say.
+     *
+     * This is the delegation bridge. A vendor that delegates reasoning (GPT-Live) calls this when
+     * it wants an answer, so the knowledge pack, the goals, the tools and the action guard all run
+     * exactly as they do in text mode. The audio chunk never reasons and never picks a tool.
+     */
+    delegate(text: string): Promise<string>;
+}
+interface VoiceHandle {
+    end(): Promise<void>;
+    setMuted(muted: boolean): void;
+}
+interface AudioModule {
+    startVoice(input: VoiceInput): Promise<VoiceHandle>;
+}
+type DocentEvent = {
+    type: 'handoff';
+    reason: string;
+    route: string;
+    transcript: TurnRecord[];
+} | {
+    type: 'open_docs';
+    url: string;
+    title?: string;
+} | {
+    type: 'goal_done';
+    goalKey: string;
+} | {
+    type: 'error';
+    code: string;
+    message: string;
+};
+interface DocentOptions {
+    appId: string;
+    publishableKey: string;
+    apiUrl: string;
+    user: {
+        id: string;
+        traits?: Record<string, string | number | boolean>;
+    };
+    userToken?: string;
+    router?: RouterAdapter;
+    presence?: Partial<Omit<PresenceOptions, 'appId' | 'user'>>;
+    /**
+     * Loads the audio chunk for the vendor this session was granted. Takes the vendor so the host
+     * can code-split per vendor and ship only the one a given session needs; the grant is resolved
+     * before this is called, so the choice is never a guess.
+     */
+    loadAudio?: (vendor: VoiceGrant['vendor']) => Promise<AudioModule>;
+    /**
+     * Loads the presence the owner chose in the Console, by library slug.
+     *
+     * Injected for the same reason `loadAudio` is: naming the presences here would make `sdk-core`
+     * import all fourteen, and an app showing one would ship the bytes of every other. The host
+     * passes `(slug) => PRESENCE_LOADERS[slug]?.()` from `@usedocent/mascot/library/loaders`, which is
+     * a chunk per presence and none fetched until one is chosen. Omitting it keeps Dot.
+     */
+    loadPresence?: (slug: string) => Promise<MascotFactory>;
+    debug?: boolean;
+    fetchImpl?: typeof fetch;
+    WebSocketImpl?: typeof WebSocket;
+}
+interface DocentHandle {
+    readonly presence: PresenceHandle;
+    readonly tools: Tools;
+    readonly sessionId: string | null;
+    readonly ready: Promise<void>;
+    ask(text: string): Promise<void>;
+    track(event: string, payload?: Record<string, unknown>): void;
+    on(cb: (e: DocentEvent) => void): () => void;
+    startVoice(): Promise<void>;
+    endVoice(): Promise<void>;
+    destroy(): void;
+}
+declare const createDocent: (options: DocentOptions) => DocentHandle;
+
+/**
+ * A mascot constructor. Every presence exposes the same handle, so swapping one is a factory
+ * swap and nothing else changes.
+ *
+ * Injected rather than selected by name for the same reason `loadAudio` is: naming it here would
+ * mean `sdk-core` statically imports every presence, and an app running Dot would pay for Lumen's
+ * bytes. The host imports the one it wants.
+ */
+type MascotFactory = (host: HTMLElement, options?: DotOptions) => DotHandle;
+interface PresenceOptions {
+    appId: string;
+    user?: {
+        id: string;
+    };
+    palette?: PresetName | MascotPaletteInput;
+    /** Defaults to Dot. Pass `createLumen` from `@usedocent/mascot/lumen` for the signature presence. */
+    mascot?: MascotFactory;
+    mount?: HTMLElement;
+    arrivalMs?: {
+        first: number;
+        later: number;
+    };
+    debug?: boolean;
+}
+interface PresenceHandle {
+    readonly host: HTMLElement;
+    readonly root: ShadowRoot;
+    readonly dot: DotHandle;
+    readonly trigger: HTMLButtonElement;
+    readonly panel: CaptionPanel;
+    readonly placement: Placement;
+    readonly isOpen: boolean;
+    readonly isMuted: boolean;
+    readonly proactiveMuted: boolean;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    setMuted(muted: boolean): void;
+    /** Fires whenever mute changes, however it changed. Returns an unsubscribe. */
+    onMuteChange(cb: (muted: boolean) => void): () => void;
+    /**
+     * Fires when the user actively dismisses the guide, by the close control or by tapping Dot
+     * shut. Not fired by the arrival beat settling on its own, which the user did not ask for.
+     * Returns an unsubscribe.
+     */
+    onDismiss(cb: () => void): () => void;
+    setPlacement(p: Placement, animate?: boolean): void;
+    setState(state: MascotState): void;
+    /**
+     * Replaces the mascot in place, keeping the current state, size and placement.
+     *
+     * Exists because the owner's choice of presence arrives with the session mint, which is one
+     * network round trip after the presence is on screen. Constructing nothing until the mint
+     * returns would cost the arrival beat its timing and leave the corner empty on a slow network.
+     */
+    setMascot(factory: MascotFactory): void;
+    addCaption(role: 'docent' | 'user', text: string): HTMLElement;
+    relayout(): void;
+    destroy(): void;
+}
+declare global {
+    interface Window {
+        __docent?: {
+            presence: PresenceHandle;
+            tools?: Tools;
+            snapshot?: () => Snapshot | null;
+            docent?: DocentHandle;
+        };
+    }
+}
+declare const createPresence: (options: PresenceOptions) => PresenceHandle;
+
+declare const NAME_FROM_CONTENT: ReadonlySet<string>;
+declare const isInteractiveRole: (role: string) => boolean;
+declare const implicitRole: (el: Element) => string | null;
+/** the label element(s) accessibleName reads text from for this element, explicit for- label first */
+declare const labelElements: (el: Element) => Element[];
+/** the elements aria-labelledby points at, in order, skipping ids that don't resolve */
+declare const labelledByTargets: (el: Element) => Element[];
+declare const accessibleName: (el: Element) => string;
+
+declare const MASK = "\u2022\u2022\u2022";
+declare const redactPII: (text: string) => string;
+declare const isMasked: (el: Element) => boolean;
+/**
+ * true when el is inside a mask, contains one, or draws its accessible name from an
+ * element that is inside a mask or contains one (aria-labelledby target, explicit
+ * label[for], or wrapping label) — either way its text must not leave the page
+ */
+declare const containsMask: (el: Element) => boolean;
+declare const safeMask: <T>(fn: () => T) => T | null;
+
+interface CaptureOptions {
+    maxNodes?: number;
+    includeLandmarks?: boolean;
+}
+declare const nodeKey: (el: Element, role: string, name: string, ordinal?: number) => string;
+declare const captureSnapshot: (doc: Document, opts?: CaptureOptions) => Snapshot | null;
+declare const elementFor: (node: SnapshotNode, doc: Document) => Element | null;
+
+interface SnapshotDelta {
+    added: SnapshotNode[];
+    removed: string[];
+    changed: SnapshotNode[];
+    route: string;
+    scrollY: number;
+}
+declare const DELTA_BUDGET_BYTES: number;
+declare const diffSnapshots: (prev: Snapshot | null, next: Snapshot) => SnapshotDelta;
+declare const deltaBytes: (d: SnapshotDelta) => number;
+
+interface WatchOptions {
+    debounceMs?: number;
+}
+declare const watchDOM: (doc: Document, onChange: () => void, opts?: WatchOptions) => (() => void);
+
+type AnchorMethod = 'guide' | 'role-name' | 'text' | 'position';
+interface Resolution {
+    el: Element;
+    confidence: number;
+    method: AnchorMethod;
+    describe: string;
+}
+declare const CONFIDENCE: {
+    readonly guide: 1;
+    readonly roleNameExact: 0.9;
+    readonly roleNameContains: 0.7;
+    readonly text: 0.6;
+    readonly position: 0.4;
+};
+declare const DEFAULT_THRESHOLD = 0.6;
+declare const describeElement: (el: Element) => string;
+declare const resolveAnchor: (ref: AnchorRef, doc: Document) => Resolution | null;
+
+type GuardAction = 'click' | 'fill';
+interface GuardContext {
+    userRequested: boolean;
+}
+type GuardDecision = {
+    allowed: true;
+} | {
+    allowed: false;
+    reason: 'forbidden' | 'not_allowlisted' | 'not_requested' | 'unsupported';
+};
+declare const DESTRUCTIVE_PATTERN: RegExp;
+declare const evaluateAction: (el: Element, action: GuardAction, ctx: GuardContext) => GuardDecision;
+
+/** Docent's deep ink, used when the accent is too light for a white edge to register. */
+declare const EDGE_DARK = "#130e30";
+declare const EDGE_LIGHT = "#ffffff";
+/** WCAG 2.2 relative luminance. Channels are 0..1. */
+declare const relativeLuminance: (r: number, g: number, b: number) => number;
+/**
+ * The outline for a given accent, from a computed `rgb()` / `rgba()` string. Anything
+ * unparseable falls back to the white edge, which is the right default for the purple the
+ * overlay ships with.
+ */
+declare const edgeForAccent: (computedColor: string) => string;
+
+interface Overlay {
+    spotlight(target: DOMRect): void;
+    point(from: {
+        x: number;
+        y: number;
+    }, target: DOMRect): void;
+    clear(): void;
+    destroy(): void;
+}
+declare const createOverlay: (root: ShadowRoot, opts: {
+    reducedMotion: boolean;
+}) => Overlay;
+
+interface Transport {
+    send(frame: ClientFrame): void;
+    onFrame(cb: (f: ServerFrame) => void): () => void;
+    readonly connected: boolean;
+    close(): void;
+}
+interface TransportOptions {
+    WebSocketImpl?: typeof WebSocket;
+    backoffMs?: number[];
+    queueLimit?: number;
+}
+declare const createTransport: (url: string, opts?: TransportOptions) => Transport;
+
+interface SyncOptions {
+    debounceMs?: number;
+}
+declare const startSync: (doc: Document, transport: Transport, opts?: SyncOptions) => (() => void);
+
+export { type AnchorMethod, type AudioModule, CONFIDENCE, type CaptionPanel, type CaptionPanelOptions, type CaptureOptions, type Corner, DEFAULT_PLACEMENT, DEFAULT_THRESHOLD, DELTA_BUDGET_BYTES, DESTRUCTIVE_PATTERN, type DocentEvent, type DocentHandle, type DocentOptions, EDGE_DARK, EDGE_LIGHT, type Edge, FIRST_RUN_CAPTION, type GuardAction, type GuardContext, type GuardDecision, INSET, type LiveRegion, MASK, type MascotFactory, NAME_FROM_CONTENT, type Overlay, type Placement, type PresenceHandle, type PresenceOptions, type PresenceStorage, type Rect, type Resolution, type RouterAdapter, STATE_ANNOUNCEMENTS, type SnapshotDelta, type SyncOptions, type Tools, type ToolsOptions, type Transport, type TransportOptions, type VoiceHandle, type VoiceInput, type WatchOptions, accessibleName, captureSnapshot, containsMask, cornerOrder, createCaptionPanel, createDocent, createLiveRegion, createOverlay, createPresence, createStorage, createTools, createTransport, deltaBytes, describeElement, diffSnapshots, edgeForAccent, elementFor, evaluateAction, implicitRole, isInteractiveRole, isMasked, labelElements, labelledByTargets, locationAdapter, nearestCorner, nodeKey, overlayStyles, placementToPoint, rectNear, rectsOverlap, redactPII, relativeLuminance, resolveAnchor, resolveKeepOut, safeMask, snapPlacement, startSync, watchDOM };