@opencx/widget-react 4.0.61 → 5.0.0-beta.0

package/dist/src/page-marks/agent-mark.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+export declare const highlightElementInputSchema: z.ZodObject<{
+    selector: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    type: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+        circle: "circle";
+        underline: "underline";
+        box: "box";
+        arrow: "arrow";
+        bracket: "bracket";
+    }>>>;
+}, z.core.$strip>;
+type HighlightElementInput = z.infer<typeof highlightElementInputSchema>;
+/** How long a highlight stays before un-drawing itself (`pageMarkHighlightDurationMs`). */
+export declare const DEFAULT_HIGHLIGHT_DURATION_MS = 8000;
+/** Programmatically clear the current highlight (also used by tests). */
+export declare function dismissActiveHighlight(): void;
+/**
+ * Ink a mark on an element of the host page: scroll it into view, hand-draw
+ * the mark on it (the ink is glued to the element, so it rides along with the
+ * smooth scroll), and float an optional pointing callout. The page stays fully
+ * interactive throughout — nothing is dimmed and no click is trapped.
+ *
+ * Returns false when the hint doesn't resolve to an element (the page may have
+ * changed since the context was captured) — callers treat that as a no-op.
+ */
+export declare function highlightElementOnHostPage(input: HighlightElementInput, { accentColor, surfaceColor, foregroundColor, zIndex, durationMs, seed, }?: {
+    accentColor?: string;
+    surfaceColor?: string;
+    foregroundColor?: string;
+    zIndex?: number;
+    durationMs?: number | undefined;
+    seed?: number;
+}): boolean;
+export {};
+//# sourceMappingURL=agent-mark.d.ts.map

package/dist/src/page-marks/agent-mark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-mark.d.ts","sourceRoot":"","sources":["../../../src/page-marks/agent-mark.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwCxB,eAAO,MAAM,2BAA2B;;;;;;;;;;;iBAStC,CAAC;AAEH,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzE,2FAA2F;AAC3F,eAAO,MAAM,6BAA6B,OAAO,CAAC;AA2BlD,yEAAyE;AACzE,wBAAgB,sBAAsB,SAErC;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,qBAAqB,EAC5B,EACE,WAA4B,EAC5B,YAA6B,EAC7B,eAAiC,EACjC,MAAmB,EACnB,UAA0C,EAC1C,IAAI,GACL,GAAE;IACD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACV,GACL,OAAO,CAmLT"}

package/dist/src/page-marks/mark-thumbnail.d.ts

@@ -0,0 +1,25 @@
+/** Kick off (and register) a snapshot keyed by its annotation object. */
+export declare function beginThumbnail(key: object, el: HTMLElement): void;
+/**
+ * Upload the mark's thumbnail once it settles and write the resulting URL
+ * onto the mark. Registered like the thumbnail so a send can wait for an
+ * upload still in flight (`awaitSnapshotUrl`). A failed capture or upload
+ * resolves null and leaves the mark without a snapshot — never throws.
+ */
+export declare function beginSnapshotUpload(mark: {
+    snapshotUrl?: string;
+}, upload: (file: File) => Promise<string | null>): void;
+/**
+ * The mark's snapshot URL, waiting at most `maxWaitMs` for an in-flight
+ * upload. A send must not hang on a slow upload: past the cap the mark goes
+ * out without its picture (text fallback), and the URL, if it lands later,
+ * is simply never persisted.
+ */
+export declare function awaitSnapshotUrl(mark: {
+    snapshotUrl?: string;
+}, maxWaitMs: number): Promise<string | null>;
+/** A `data:` URL (as `toJpeg` returns) as an uploadable File. */
+export declare function fileFromDataUrl(dataUrl: string, name: string): File | null;
+/** The key's in-flight/settled snapshot, if one was started. */
+export declare function getThumbnail(key: object): Promise<string | null> | undefined;
+//# sourceMappingURL=mark-thumbnail.d.ts.map

package/dist/src/page-marks/mark-thumbnail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-thumbnail.d.ts","sourceRoot":"","sources":["../../../src/page-marks/mark-thumbnail.ts"],"names":[],"mappings":"AA6DA,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,QAE1D;AAID;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,QAe/C;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAa1E;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,SAAS,CAE5E"}

package/dist/src/page-marks/page-element.d.ts

@@ -0,0 +1,89 @@
+/**
+ * The page vocabulary shared by every mark on the host page — the visitor's
+ * (`page-mark.ts`) and the agent's (`agent-mark.ts`).
+ *
+ * The widget's React code runs in the HOST page realm (only the chat UI is
+ * portaled into a same-origin iframe), so `document` here is the host page
+ * document — these helpers read the customer's page directly.
+ */
+/** A viewport-relative box, rounded to whole pixels. */
+export type Rect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * How one host-page element is described to the AI. Deliberately the minimum
+ * that carries meaning: a name to reason about, a selector to point back at
+ * (`highlight_element`), the tag, and the visible text.
+ */
+export type MarkedElement = {
+    /** Human-readable name, e.g. `button "Create Key"`. */
+    name: string;
+    /** Resolvable CSS selector (verified unique against the document). */
+    selector: string;
+    /** Lowercased tag name. */
+    tag: string;
+    /** The element's own visible text, truncated. */
+    text?: string;
+};
+/**
+ * Human-readable name for an element — what the context pill shows and what
+ * the LLM reads. Buttons are named by their text, inputs by placeholder/name,
+ * images by alt.
+ */
+export declare function identifyElementName(el: HTMLElement): string;
+/**
+ * A CSS selector that resolves back to `el`. Prefers a unique `#id`; otherwise
+ * builds a `:nth-of-type` chain upward, stopping as soon as the partial chain
+ * is unique in the document.
+ */
+export declare function computeUniqueSelector(el: HTMLElement): string;
+/** The element's viewport-relative bounding box, rounded to whole pixels. */
+export declare function rectOf(el: Element): Rect;
+/**
+ * Breathing room kept between a mark's box and the viewport edge: the hover
+ * frame inflates the rect by 4px and paints a ~4px ring outside that, which
+ * is also enough for the ink's stroke and its wobble.
+ */
+export declare const VIEWPORT_MARGIN_PX = 8;
+/**
+ * Clamp a viewport rect so everything drawn around it stays on the page. An
+ * element taller or wider than the viewport — a full-height sidebar, a wide
+ * table — otherwise gets a frame whose edges land outside the visible page,
+ * and the visitor sees a border running off the screen instead of a box.
+ */
+export declare function clampRectToViewport(rect: Rect, margin?: number): Rect;
+/** Describe an element for the AI. */
+export declare function describeElement(el: HTMLElement): MarkedElement;
+/**
+ * The single source of truth for "this node belongs to the widget": the embed
+ * root, host-portaled chrome, and every mark overlay. Both the `closest()`
+ * ownership check below and the mark-mode cursor's injected `:not()` chain
+ * derive from this list — add new widget-owned markers HERE.
+ */
+export declare const WIDGET_OWNED_SELECTOR: readonly ["#opencx-root", "[data-opencx-root]", "[data-opencx-overlay]"];
+/**
+ * True for nodes that belong to the widget itself — no mark may ever target
+ * the widget's own UI.
+ */
+export declare function isWidgetOwned(el: Element): boolean;
+/**
+ * The markable element under a viewport point. Keep the hit in the document
+ * tree: selectors serialized into page-mark context must resolve through
+ * `document.querySelector`, so piercing a shadow root would create an element
+ * the selector contract cannot point back to. SVG children normalize to their
+ * nearest semantic HTML control (or nearest HTML owner).
+ */
+export declare function elementAt(x: number, y: number): HTMLElement | null;
+/**
+ * Find an element again from an LLM-provided hint: try the CSS selector first
+ * (invalid model-authored selectors are non-fatal), then fall back to the
+ * smallest element whose text contains the hint text.
+ */
+export declare function resolveElementByHint(hint: {
+    selector?: string;
+    text?: string;
+}): HTMLElement | null;
+//# sourceMappingURL=page-element.d.ts.map

package/dist/src/page-marks/page-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-element.d.ts","sourceRoot":"","sources":["../../../src/page-marks/page-element.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wDAAwD;AACxD,MAAM,MAAM,IAAI,GAAG;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAiDF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAoC3D;AAcD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CA+B7D;AAED,6EAA6E;AAC7E,wBAAgB,MAAM,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAQxC;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,MAA2B,GAClC,IAAI,CAiBN;AAED,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,aAAa,CAQ9D;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,0EAIxB,CAAC;AAIX;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAmBlE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,WAAW,GAAG,IAAI,CA8BrB"}

package/dist/src/page-marks/page-mark-theme.d.ts

@@ -0,0 +1,30 @@
+import { CSSProperties } from 'react';
+export type PageMarkTheme = {
+    accent: string;
+    surface: string;
+    foreground: string;
+    mutedForeground: string;
+    border: string;
+    /**
+     * Document layers, relative to the widget's own. Drawn marks and the hover
+     * frame sit just UNDER the widget: they belong to the page, and a mark
+     * that runs beneath the panel reads as the page being marked, not as
+     * scribble on the chat. The note editor alone sits above, so it can be
+     * typed into wherever the mark landed.
+     */
+    inkZIndex: number;
+    chromeZIndex: number;
+    editorZIndex: number;
+};
+type PageMarkCssVars = CSSProperties | {
+    [key: `--opencx-${string}`]: string | number | undefined;
+};
+/** Concrete colors and document layers for page-mark UI, which is portaled
+ * outside the iframe and therefore cannot inherit the widget's CSS variables. */
+export declare function resolvePageMarkTheme({ cssVars, primaryColor, contentZIndex, }: {
+    cssVars: PageMarkCssVars;
+    primaryColor: string;
+    contentZIndex: number;
+}): PageMarkTheme;
+export {};
+//# sourceMappingURL=page-mark-theme.d.ts.map

package/dist/src/page-marks/page-mark-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-mark-theme.d.ts","sourceRoot":"","sources":["../../../src/page-marks/page-mark-theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,eAAe,GAChB,aAAa,GACb;IAAE,CAAC,GAAG,EAAE,YAAY,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAUjE;iFACiF;AACjF,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,YAAY,EACZ,aAAa,GACd,EAAE;IACD,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,aAAa,CAWhB"}

package/dist/src/page-marks/page-mark.d.ts

@@ -0,0 +1,103 @@
+import { MarkedElement, Rect } from './page-element';
+/**
+ * A mark the visitor put on the host page to ask about: a hand-drawn shape
+ * around a region, an optional note, and the elements it covers.
+ *
+ * Every mark on the page — the visitor's here, the agent's in `agent-mark.ts`
+ * — is drawn by the same pen (`@shardsui/notation`), so the conversation has
+ * one visual language.
+ */
+/**
+ * The mark shapes the visitor can choose. The full notation set: a mark can
+ * point at a thing (`arrow`), enclose it (`box`, `circle`, `bracket`),
+ * emphasize a line of text (`underline`, `highlight`), or say it is wrong
+ * (`strike-through`, `crossed-off`) — all of which are real things people
+ * mean when they mark up a page to ask about it.
+ *
+ * `highlight` is safe here (it is not on the agent's pen) because a visitor
+ * mark is anchored to the widget's OWN placeholder, never to a customer
+ * element — the one type that writes `position`/`z-index` onto its target
+ * can only ever write them onto ours.
+ */
+export declare const MARK_SHAPES: readonly ["box", "circle", "arrow", "bracket", "underline", "highlight", "strike-through", "crossed-off"];
+export type MarkShape = (typeof MARK_SHAPES)[number];
+/**
+ * Serialized as `clientContext.page_marks` on the send payload — every field
+ * must be JSON-safe. The ink handle stays in the Widget-scoped page-mark
+ * provider and the pill thumbnail's base64 in a WeakMap, never in the
+ * payload; only the uploaded snapshot's URL rides along.
+ */
+export type PageMark = {
+    /** The shape the visitor chose (boxed it / circled it / struck it out). */
+    shape: MarkShape;
+    /** The visitor's note, when they wrote one. */
+    note?: string;
+    /** Page URL at mark time. */
+    pageUrl: string;
+    /** Viewport bounding box of the marked region. */
+    rect: Rect;
+    /** Elements inside the region (deduped, focus element first, capped). */
+    elements: MarkedElement[];
+    /**
+     * The region's pixels as a message file, once the thumbnail's upload lands
+     * (`mark-thumbnail.ts` writes it onto the very object the composer holds,
+     * so the send carries it and reloads show the image, not the tag names).
+     * Absent when the capture or upload failed — surfaces fall back to text.
+     */
+    snapshotUrl?: string;
+};
+/**
+ * One marked element as the BACKEND has understood it since the element
+ * picker: an entry of `clientContext.picked_elements`.
+ */
+export type PickedElement = MarkedElement & {
+    /** The note written on the mark this element came from, if any. */
+    note?: string;
+};
+/**
+ * The marks' elements under the key the backend actually reads and KEEPS.
+ * `page_marks` is the richer payload (shape, note, region) but it is only
+ * rendered into the current turn's client-context block; what the backend
+ * re-surfaces on later turns — and what customer-facing surfaces read back —
+ * is `picked_elements`. So both ride along: the marks for this turn's
+ * reasoning, the flat elements for everything that outlives it.
+ *
+ * Deduped across marks (two marks on the same control are one element), and
+ * the visitor's note travels on the element it was placed on, so a follow-up
+ * turn still knows what was asked, not just what was clicked.
+ */
+export declare function pickedElementsFromMarks(marks: PageMark[]): PickedElement[];
+/** A region can never be resized smaller than this, per side. */
+export declare const MIN_REGION_SIZE_PX = 20;
+/**
+ * Post-`show()` dressing for notation's sibling-inserted SVGs: mark them
+ * widget-owned (no mark may ever target the widget's own ink) and keep the
+ * stroke legible over any host page — the faint white drop-shadow is what
+ * saves a near-black theme color on a dark page.
+ */
+export declare function adoptNotationInk(target: Element, zIndex: number): void;
+export type MarkInk = {
+    /**
+     * Re-anchor the mark to a new PAGE rect (live move/resize). Notation
+     * redraws with the mark's stable seed — same hand, new place.
+     */
+    setRect(pageRect: Rect): void;
+    /** Switch the mark shape in place. */
+    setShape(shape: MarkShape): void;
+    /** Reverse-plays the mark off the page, then releases it. */
+    undraw(): void;
+    /** Immediate teardown. */
+    remove(): void;
+};
+/**
+ * Ink a region as a hand-drawn mark, anchored to a widget-owned PLACEHOLDER
+ * positioned at the region's page coordinates. Notation needs a target
+ * element and a bare region has none — the placeholder gives it one without
+ * touching a single node of the customer's DOM, and because it lives in page
+ * coordinates the mark scrolls with the content for free.
+ *
+ * Never throws: a mark is decoration, and a draw failure must not break the
+ * composer.
+ */
+export declare function createMarkInk(pageRect: Rect, shape: MarkShape, color: string, zIndex: number): MarkInk;
+//# sourceMappingURL=page-mark.d.ts.map

package/dist/src/page-marks/page-mark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-mark.d.ts","sourceRoot":"","sources":["../../../src/page-marks/page-mark.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAG1D;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,2GASd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,2EAA2E;IAC3E,KAAK,EAAE,SAAS,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,IAAI,EAAE,IAAI,CAAC;IACX,yEAAyE;IACzE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IAC1C,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,CA2B1E;AAED,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAIrC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAU/D;AAED,MAAM,MAAM,OAAO,GAAG;IACpB;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,6DAA6D;IAC7D,MAAM,IAAI,IAAI,CAAC;IACf,0BAA0B;IAC1B,MAAM,IAAI,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,IAAI,EACd,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CA2ET"}

package/dist/src/page-marks/useMarkThumbnail.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The snapshot taken for a mark, once it lands. Keyed by the mark OBJECT, so
+ * the composer pill and the sent bubble — which carries the same reference —
+ * resolve the very same capture. Null until (or unless) it settles; every
+ * caller has a text form to fall back on.
+ */
+export declare function useMarkThumbnail(mark: object | undefined): string | null;
+//# sourceMappingURL=useMarkThumbnail.d.ts.map

package/dist/src/page-marks/useMarkThumbnail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkThumbnail.d.ts","sourceRoot":"","sources":["../../../src/page-marks/useMarkThumbnail.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAgBxE"}

package/dist/src/page-marks/usePageMarking.d.ts

@@ -0,0 +1,53 @@
+import { Rect } from './page-element';
+import { MarkShape, PageMark } from './page-mark';
+/** The live, editable mark — everything the overlay renders. */
+export type MarkDraft = {
+    /** Viewport rect (state-driven; the ink mirrors it in page coords). */
+    rect: Rect;
+    shape: MarkShape;
+};
+/** The element under the cursor while armed and nothing is placed yet. */
+export type MarkHover = {
+    rect: Rect;
+    /** Changes per hovered ELEMENT — the overlay keys the frame on it. */
+    key: number;
+};
+/**
+ * The composer's page-marking tool: while armed, a hover frame tracks the
+ * element under the cursor and a CLICK lands a box mark snapped around it.
+ * The mark is then an editable object — drag inside to move, drag a corner to
+ * resize, switch shapes, type a note — and the cursor says which of those the
+ * pointer is currently on. Clicking somewhere else re-places the mark there
+ * (pointing at a different thing is the common case, not an accident); Enter
+ * attaches it; Esc drops it, and Esc again disarms.
+ *
+ * All pointer listeners are capture-phase on the HOST document (the widget's
+ * React code runs in the host realm), widget-owned nodes are exempt so the
+ * editor card stays usable, and the complete pointer/click sequence is
+ * swallowed so marking a button never activates it.
+ */
+export declare function usePageMarking({ enabled, onAttach, uploadSnapshot, accentColor, zIndex, }: {
+    /** Whether this composer currently exposes page marking. */
+    enabled: boolean;
+    /** Notification only — the provider owns the mark either way. */
+    onAttach?: (mark: PageMark) => void;
+    /**
+     * Uploads a mark's thumbnail as a message file and resolves its URL (null
+     * on failure). Without it, marks are sent text-only after a reload.
+     */
+    uploadSnapshot?: (file: File) => Promise<string | null>;
+    accentColor: string;
+    /** Host-page ink layer, normally resolved from the configured widget z-index. */
+    zIndex: number;
+}): {
+    isActive: boolean;
+    draft: MarkDraft | null;
+    hover: MarkHover | null;
+    setShape: (shape: MarkShape) => void;
+    attach: (note: string) => void;
+    /** Esc-equivalent for the editor card's discard affordance. */
+    dropDraft: () => void;
+    disarm: () => void;
+    toggle: () => void;
+};
+//# sourceMappingURL=usePageMarking.d.ts.map

package/dist/src/page-marks/usePageMarking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageMarking.d.ts","sourceRoot":"","sources":["../../../src/page-marks/usePageMarking.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,IAAI,EACV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAuBrB,gEAAgE;AAChE,MAAM,MAAM,SAAS,GAAG;IACtB,uEAAuE;IACvE,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAQF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,cAAc,EACd,WAAW,EACX,MAAM,GACP,EAAE;IACD,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;CAChB;;;;sBA8BsC,SAAS;mBAoSrC,MAAM;IA2Cb,+DAA+D;;;;EAKlE"}

package/dist/src/screens/chat/ChatCanvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatCanvas.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/ChatCanvas.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAIxC,wBAAgB,UAAU,6BA8BzB"}
+{"version":3,"file":"ChatCanvas.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/ChatCanvas.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAC;AASxC,wBAAgB,UAAU,6BA8BzB"}

package/dist/src/screens/chat/ChatFooter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatFooter.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/ChatFooter.tsx"],"names":[],"mappings":"AA2BA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAoZ3D,wBAAgB,UAAU,sBA2CzB"}
+{"version":3,"file":"ChatFooter.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/ChatFooter.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,MAAM,OAAO,CAAC;AAoE1B,wBAAgB,UAAU,sBA2CzB"}

package/dist/src/screens/chat/ChatFooterItems.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatFooterItems.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/ChatFooterItems.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,wBAAgB,eAAe,sBA2B9B"}
+{"version":3,"file":"ChatFooterItems.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/ChatFooterItems.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,wBAAgB,eAAe,sBA4B9B"}

package/dist/src/screens/chat/ChatInput.d.ts

@@ -0,0 +1,27 @@
+import { default as React } from 'react';
+/**
+ * The stock composer — white card, multi-line textarea, attach + send.
+ * Exported so companion's quick-ask state renders the exact same composer
+ * (not a bespoke bar), inheriting every customization automatically.
+ */
+export declare function ChatInput({ trailingActions, placeholder, hideAttachTools, }?: {
+    /**
+     * Extra controls rendered in the composer's action row, just before the
+     * send button. Companion uses it to slot a conversation-history button into
+     * the quick-ask bar; popover mode passes nothing.
+     */
+    trailingActions?: React.ReactNode;
+    /**
+     * Override the composer placeholder. Companion's quick-ask bar uses it to
+     * read "Follow up…" while continuing an open conversation. Defaults to the
+     * localized "Write a message…".
+     */
+    placeholder?: string;
+    /**
+     * Hide the attach + page-mark buttons. Companion's docked quick-ask
+     * bar sets it so the resting composer carries ONLY the history control —
+     * the full tool row lives in the expanded chat panel.
+     */
+    hideAttachTools?: boolean;
+}): React.JSX.Element;
+//# sourceMappingURL=ChatInput.d.ts.map

package/dist/src/screens/chat/ChatInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatInput.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/ChatInput.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAuD,MAAM,OAAO,CAAC;AA+C5E;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EACxB,eAAe,EACf,WAAW,EACX,eAAe,GAChB,GAAE;IACD;;;;OAIG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,qBAipBL"}

package/dist/src/screens/chat/ChatMain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatMain.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/ChatMain.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAiB1D,wBAAgB,QAAQ,sBA0GvB"}
+{"version":3,"file":"ChatMain.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/ChatMain.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAa1D,wBAAgB,QAAQ,sBAkEvB"}

package/dist/src/screens/chat/DictationMicButton.d.ts

@@ -0,0 +1,18 @@
+import { DictationStatus } from '@opencx/widget-core';
+import { default as React } from 'react';
+/**
+ * Composer microphone toggle, mirroring the attach button. States:
+ *   idle       → quiet mic glyph
+ *   connecting → spinning arc around the mic
+ *   listening  → the mic crossfades into live voice bars that move as you talk
+ */
+export declare function DictationMicButton({ status, levelRef, onToggle, onPrewarm, }: {
+    status: DictationStatus;
+    levelRef: {
+        current: number;
+    };
+    onToggle: () => void;
+    /** Hover/focus pre-mints the session token so the click starts instantly. */
+    onPrewarm: () => void;
+}): React.JSX.Element;
+//# sourceMappingURL=DictationMicButton.d.ts.map

package/dist/src/screens/chat/DictationMicButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DictationMicButton.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/DictationMicButton.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,KAA4B,MAAM,OAAO,CAAC;AA2DjD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,GACV,EAAE;IACD,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB,qBA6CA"}

package/dist/src/screens/chat/InitialMessages.d.ts

@@ -1,3 +1,9 @@
 import { default as React } from 'react';
-export declare function InitialMessages(): React.JSX.Element;
+/**
+ * The greeting shown at the top of a fresh conversation.
+ * `advancedInitialMessages` wins over the plain `initialMessages` strings;
+ * with neither configured, a default greeting shows. Renders nothing once the
+ * conversation has real messages.
+ */
+export declare function InitialMessages(): React.JSX.Element | null;
 //# sourceMappingURL=InitialMessages.d.ts.map

package/dist/src/screens/chat/InitialMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InitialMessages.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/InitialMessages.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,wBAAgB,eAAe,sBA6C9B"}
+{"version":3,"file":"InitialMessages.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/InitialMessages.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B;;;;;GAKG;AACH,wBAAgB,eAAe,6BAyC9B"}

package/dist/src/screens/chat/MentionPicker.d.ts

@@ -0,0 +1,39 @@
+import { WidgetMention } from '@opencx/widget-core';
+import { default as React, RefObject } from 'react';
+import { MentionGroup } from './useMentions';
+/**
+ * The @-mention menu, sitting right above the `@` it belongs to (its start
+ * edge on the `@`, its bottom edge on that line): results grouped by type under a small header, one line
+ * per item (icon + title), a "See N more" row where a group is cut, and —
+ * when `mentions.preview` is on and the frame is wide enough — the
+ * highlighted item's description in a card beside the menu. Keyboard-driven
+ * from the textarea (the hook handles ↑/↓/Enter/Tab/Escape there, so focus
+ * never leaves the text); the mouse hovers to highlight and clicks to pick.
+ *
+ * Portaled to the frame's themed root and positioned against the composer:
+ * the composer sits inside a footer that clips its overflow, so a menu that
+ * grew upward in place was cut off at the footer's top edge. The root (not
+ * the body) is the host because it carries the palette variables the menu's
+ * colors resolve from — outside it `bg-background` paints nothing. The
+ * composer changes height as pills and files come and go, so the placement
+ * follows the anchor's size, not just the result list.
+ */
+export declare function MentionPicker({ anchorRef, inputRef, anchorIndex, preview, groups, visible, searching, highlighted, onHighlight, onPick, onExpand, }: {
+    /** The composer root the menu sits above. */
+    anchorRef: RefObject<HTMLElement | null>;
+    /** The textarea holding the `@`; the menu's start edge lines up with it. */
+    inputRef: RefObject<HTMLTextAreaElement | null>;
+    /** Index of that `@` in the text. */
+    anchorIndex: number | null;
+    /** Show the highlighted item's description beside the menu. */
+    preview: boolean;
+    groups: MentionGroup[];
+    /** The rows top to bottom; `highlighted` indexes into it. */
+    visible: WidgetMention[];
+    searching: boolean;
+    highlighted: number;
+    onHighlight: (index: number) => void;
+    onPick: (item: WidgetMention) => void;
+    onExpand: (type: string) => void;
+}): React.ReactPortal | null;
+//# sourceMappingURL=MentionPicker.d.ts.map

package/dist/src/screens/chat/MentionPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MentionPicker.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/MentionPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAOzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAUlD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,QAAQ,EACR,WAAW,EACX,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,WAAW,EACX,WAAW,EACX,MAAM,EACN,QAAQ,GACT,EAAE;IACD,6CAA6C;IAC7C,SAAS,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACzC,4EAA4E;IAC5E,QAAQ,EAAE,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAChD,qCAAqC;IACrC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,6DAA6D;IAC7D,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,4BA8IA"}

package/dist/src/screens/chat/MentionText.d.ts

@@ -0,0 +1,16 @@
+import { WidgetMention } from '@opencx/widget-core';
+import { default as React } from 'react';
+/**
+ * Text with its `@Title` mentions highlighted in place — the composer's
+ * mirror layer and the sent bubble both read the same way, so a mention
+ * looks like one thing from typing to transcript. Longer titles are matched
+ * first so `@Ann` never claims the front of `@Anna Lee`. Text without
+ * mentions comes back as-is.
+ */
+export declare function MentionText({ text, mentions, tokenClassName, }: {
+    text: string;
+    mentions: readonly WidgetMention[] | undefined;
+    /** The token's look on this surface (ink on the composer, on primary in the bubble). */
+    tokenClassName: string;
+}): React.JSX.Element;
+//# sourceMappingURL=MentionText.d.ts.map

package/dist/src/screens/chat/MentionText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MentionText.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/MentionText.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,cAAc,GACf,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,CAAC;IAC/C,wFAAwF;IACxF,cAAc,EAAE,MAAM,CAAC;CACxB,qBAmCA"}

package/dist/src/screens/chat/MessageGroups.d.ts

@@ -0,0 +1,12 @@
+import { WidgetMessageU } from '@opencx/widget-core';
+import { default as React } from 'react';
+/**
+ * Renders grouped transcript messages — the rule shared by the bot-chat and
+ * agent-chat lists. Bot (AI) groups carry the configured bot identity
+ * (server-resolved agent branding wins); human-agent groups prefer the
+ * server-provided sender, patched by the `humanAgent` config override.
+ */
+export declare function MessageGroups({ groups }: {
+    groups: WidgetMessageU[][];
+}): React.JSX.Element;
+//# sourceMappingURL=MessageGroups.d.ts.map

package/dist/src/screens/chat/MessageGroups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageGroups.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/MessageGroups.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,cAAc,EAAE,EAAE,CAAA;CAAE,qBAuDvE"}

package/dist/src/screens/chat/UploadPreview.d.ts

@@ -0,0 +1,23 @@
+import { FileWithProgress } from '@opencx/widget-react-headless';
+import { default as React } from 'react';
+export declare const MAX_FILE_BYTES: number;
+export declare const BASE_FILE_ACCEPT: {
+    'application/pdf': string[];
+};
+export declare const HANDED_OFF_FILE_ACCEPT: {
+    'application/pdf': string[];
+    'text/*': string[];
+    'image/*': string[];
+};
+export declare const AI_FILE_ACCEPT: {
+    'application/pdf': string[];
+    'image/png': string[];
+    'image/jpeg': string[];
+    'image/gif': string[];
+    'image/webp': string[];
+};
+export declare function UploadPreview({ file: { status, file, error }, onCancel, }: {
+    file: FileWithProgress;
+    onCancel: () => void;
+}): React.JSX.Element;
+//# sourceMappingURL=UploadPreview.d.ts.map

package/dist/src/screens/chat/UploadPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadPreview.d.ts","sourceRoot":"","sources":["../../../../src/screens/chat/UploadPreview.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAWtE,OAAO,KAA8B,MAAM,OAAO,CAAC;AAYnD,eAAO,MAAM,cAAc,QAAmB,CAAC;AAG/C,eAAO,MAAM,gBAAgB;;CAIX,CAAC;AAEnB,eAAO,MAAM,sBAAsB;;;;CAIjB,CAAC;AAEnB,eAAO,MAAM,cAAc;;;;;;CAMT,CAAC;AA8CnB,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAC7B,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,qBAyDA"}

package/dist/src/screens/chat/__tests__/chat-input-clarification.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat-input-clarification.spec.d.ts.map

package/dist/src/screens/chat/__tests__/chat-input-clarification.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-input-clarification.spec.d.ts","sourceRoot":"","sources":["../../../../../src/screens/chat/__tests__/chat-input-clarification.spec.tsx"],"names":[],"mappings":""}

package/dist/src/screens/chat/__tests__/chatInput.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chatInput.spec.d.ts.map

package/dist/src/screens/chat/__tests__/chatInput.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatInput.spec.d.ts","sourceRoot":"","sources":["../../../../../src/screens/chat/__tests__/chatInput.spec.tsx"],"names":[],"mappings":""}

package/dist/src/screens/chat/__tests__/use-mentions.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-mentions.spec.d.ts.map

package/dist/src/screens/chat/__tests__/use-mentions.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mentions.spec.d.ts","sourceRoot":"","sources":["../../../../../src/screens/chat/__tests__/use-mentions.spec.tsx"],"names":[],"mappings":""}

package/dist/src/screens/chat/__tests__/useSentTextRecall.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useSentTextRecall.spec.d.ts.map

package/dist/src/screens/chat/__tests__/useSentTextRecall.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSentTextRecall.spec.d.ts","sourceRoot":"","sources":["../../../../../src/screens/chat/__tests__/useSentTextRecall.spec.tsx"],"names":[],"mappings":""}