@marketrix.ai/widget 4.0.109 → 4.0.111

package/dist/src/components/base/Surface.d.ts

@@ -1,27 +1,21 @@
 /**
  * `Surface` is the canonical container primitive: a polymorphic `forwardRef` element (`as`, default
  * `div`) that composes the shared layout-token vocabulary with a `background` token, a `SHADOW`
- * `elevation` token and a `paddingPreset`, all emitted as inline style. `SurfaceBackground` and
- * `SurfacePadding` are those token unions, `backgroundStyles` and `paddingPresetStyles` their lookup
- * tables — the `default`/`none` entries are empty, so a bare `Surface` is a plain element — and
- * `SurfaceProps` the prop surface: `LayoutProps` plus the host element's HTML attributes.
+ * `elevation` token and a `paddingPreset`, all emitted as inline style — the `default`/`none` lookup
+ * entries are empty, so a bare `Surface` is a plain element. `className` is dropped from the host
+ * attributes and re-declared because it is INTERNAL to `blocks/`: layout props are the styling API
+ * everywhere else, and the only legitimate classes are the `index.css` hooks the block components key on.
  *
  * `floatingCard` is a `variant` shorthand for the card-background/border/card-elevation/card-padding/xl-
  * rounded/margin bundle both `HomeView`'s recent-conversation card and `ChatView`'s composer card use —
  * the margin lives in `variantStyles` since both call sites want it, while `ChatView`'s extra
  * `marginTop: 'auto'` stays an override on its own `style` prop rather than joining the preset.
  *
- * `className` is dropped from those attributes and re-declared because it is INTERNAL to `blocks/`:
- * layout props are the styling API everywhere else, and the only legitimate classes are the
- * `index.css` hooks the block components key on.
- *
- * Style order is fixed and load-bearing: background → padding preset → elevation → layout props →
- * the caller's own `style` last, so an inline style always wins. `Flex` depends on that tail
- * position, resolving `display` itself because `resolveLayoutStyle` is applied ahead of it.
- *
- * `resolveLayoutStyle` is handed the whole `props` (it reads only layout keys), while the DOM spread
- * goes through `stripLayoutProps` — a layout token left on the props bag reaches the element as an
- * unknown attribute.
+ * Style order is fixed and load-bearing: background → padding preset → elevation → layout props → the
+ * caller's own `style` last, so an inline style always wins; `Flex` depends on that tail position,
+ * resolving `display` itself because `resolveLayoutStyle` is applied ahead of it. `resolveLayoutStyle`
+ * is handed the whole `props` (it reads only layout keys), while the DOM spread goes through
+ * `stripLayoutProps` — a layout token left on the props bag reaches the element as an unknown attribute.
  */
 import { type ElementType } from 'react';
 import { type ShadowToken } from '../../design-system/component-tokens';

package/dist/src/components/base/layoutProps.d.ts

@@ -3,25 +3,23 @@
  * `resolveLayoutStyle` which reduces them to a `CSSProperties` object, and `stripLayoutProps` which
  * removes them from a props bag so the remainder can be spread onto a DOM element. `SPACING_SCALE` is
  * the exported `SpacingToken`→pixel table, declared smallest-first so a token name orders the same way
- * as the pixels it emits (`__tests__/layoutProps.test.ts` pins that); `ALIGN`, `JUSTIFY`, `ANIMATION`
- * and `BORDER_SIDE` are the private lookups for the remaining token families.
+ * as the pixels it emits.
  *
  * Layout props resolve to a style object rather than class names: as classes they were interpolated
- * (`p-${token}`), which no scanner could see, so a build-time safelist emitting the whole 8x7 matrix
- * was the only thing keeping them alive and a missing entry failed silently at runtime.
- * `resolveLayoutStyle` emits a property only for a prop set to a non-default value — `grow: false`,
- * `shrink: true`, `border: false`, `rounded: false` and `animate: 'none'` deliberately emit nothing —
- * and its `ANIMATION` values name `mtx-*` keyframes `index.css` must define
- * (`__tests__/stylesheet-contract.test.ts` pins the pairing).
+ * (`p-${token}`), which no scanner could see, so a build-time safelist emitting the whole 8x7 matrix was
+ * the only thing keeping them alive and a missing entry failed silently at runtime. `resolveLayoutStyle`
+ * emits a property only for a prop set to a non-default value (`grow: false`, `shrink: true`, `border:
+ * false`, `rounded: false` and `animate: 'none'` deliberately emit nothing), and its `ANIMATION` values
+ * name `mtx-*` keyframes `index.css` must define.
  *
  * `LAYOUT_KEYS` must list every key of `LayoutProps`: `stripLayoutProps` filters by that set, so a
  * layout prop missing from it reaches the DOM as an unknown attribute. `as` and `style` are in it
  * because the consuming component (`Surface`) applies them itself rather than forwarding them.
  *
- * `withClass(base, extra)` appends an optional caller `className` to a component's fixed base class
- * (`Button`, `Icon`, `Avatar`). It is NOT the banned `cn()`: there is no variant list to merge or
- * dedup, just a plain conditional concat of one fixed string and one optional string — variants stay
- * on `data-*` attributes per the styling rule in `../../../CLAUDE.md`.
+ * `withClass(base, extra)` appends an optional caller `className` to a component's fixed base class. It
+ * is NOT the banned `cn()`: there is no variant list to merge or dedup, just a plain conditional concat
+ * of one fixed string and one optional string — variants stay on `data-*` attributes per the styling
+ * rule in `../../../CLAUDE.md`.
  */
 import type { CSSProperties, ElementType } from 'react';
 import { type RadiusToken } from '../../design-system/component-tokens';

package/dist/src/hooks/useFocusTrap.d.ts

@@ -1,23 +1,20 @@
 /**
  * Focus trap for the messenger panel: while `isActive`, focus starts inside `containerRef`, Tab cycles
  * within it, Escape calls `onEscape`, and on deactivation focus returns to whatever held it before.
- *
- * The tabbable candidates come from `utils/dom`'s shared `focusablesIn` (built on `TABBABLE_SELECTOR`,
- * visibility and `aria-hidden` ancestry — the same filter `keySimulation`'s Tab simulation uses, so the
- * widget's own tab order and the host page's can't re-diverge); `activeElementIn` reads the focused
- * element as seen from a container's own root; and `useFocusTrap(containerRef, isActive, {onEscape,
- * focusTargetRef})` focuses `focusTargetRef` (else the first focusable), installs one capture-phase
- * `keydown` listener on `document`, and restores focus on the active→inactive edge.
+ * `useFocusTrap(containerRef, isActive, {onEscape, focusTargetRef})` focuses `focusTargetRef` (else the
+ * first focusable), installs one capture-phase `keydown` listener on `document`, and restores focus on
+ * the active→inactive edge. The tabbable candidates come from `utils/dom`'s shared `focusablesIn`, the
+ * same filter `keySimulation`'s Tab simulation uses, so the widget's own tab order and the host page's
+ * can't re-diverge.
  *
  * Inside the widget's closed shadow root `document.activeElement` retargets to the HOST, never naming
  * an element of the widget's own tree; `activeElementIn` reads through `container.getRootNode()`
  * instead and is the ONE home for that retargeting — eslint's `no-restricted-properties` bans the bare
- * read everywhere else. Hand-rolled on purpose: `MessengerShell` is a NON-modal panel, not a Dialog,
- * and Base UI exposes no standalone focus trap; reaching it by making the panel a Dialog would inert
- * the customer's page. Both key arms bail unless focus is currently inside the container, since the
+ * read everywhere else. Hand-rolled on purpose: `MessengerShell` is a NON-modal panel, not a Dialog, and
+ * Base UI exposes no standalone focus trap; reaching it by making the panel a Dialog would inert the
+ * customer's page. Both key arms bail unless focus is currently inside the container, since the
  * listener sits on `document` ahead of host-page handlers and an unguarded Escape would close the
- * widget mid-typing. Tab `preventDefault`s only at the two ends; `previousActiveRef` edge-triggers the
- * restore once on close.
+ * widget mid-typing.
  */
 export declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, isActive: boolean, options?: {
     onEscape?: () => void;

package/dist/src/sdk/contracts/common.d.ts

@@ -60,6 +60,13 @@ export declare const ToolCallRecordSchema: z.ZodObject<{
     params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     result: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strict>;
+export declare const SessionStateSchema: z.ZodObject<{
+    cookies: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    local_storage: z.ZodArray<z.ZodObject<{
+        origin: z.ZodString;
+        items: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 export declare const SlackWebhookUrlSchema: z.ZodURL;
 export declare const GraphEdgeSchema: z.ZodObject<{
     start: z.ZodString;

package/dist/src/sdk/contracts/entities.d.ts

@@ -362,7 +362,391 @@ export declare const WidgetPublicSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type WidgetPublicData = z.infer<typeof WidgetPublicSchema>;
-export declare const ActivityLogMetadataSchema: z.ZodUnion<[z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, ...z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]]>;
+export declare const ActivityLogMetadataSchema: z.ZodUnion<[z.ZodObject<{
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+    target_user_id: z.ZodNumber;
+    target_user_email: z.ZodString;
+    reason: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    target_user_id: z.ZodNumber;
+    details: z.ZodString;
+}, z.core.$strict>]> | z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        app: "app";
+        website: "website";
+    }>;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    widget_type: z.ZodEnum<{
+        widget: "widget";
+    }>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    file_name: z.ZodString;
+    file_size: z.ZodNumber;
+    file_type: z.ZodString;
+    file_url: z.ZodString;
+    source_url: z.ZodOptional<z.ZodString>;
+}, z.core.$strict> | z.ZodObject<{
+    id: z.ZodNumber;
+    file_name: z.ZodString;
+    source_url: z.ZodString;
+    action: z.ZodLiteral<"refreshed">;
+}, z.core.$strict> | z.ZodObject<{
+    id: z.ZodNumber;
+    file_name: z.ZodString;
+    file_type: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    target_user_email: z.ZodString;
+    reminder: z.ZodOptional<z.ZodLiteral<true>>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    target_user_email: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    slug: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    session_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    invoice_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    invoice_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    chat_id: z.ZodString;
+    mode: z.ZodString;
+    question: z.ZodString;
+    timestamp: z.ZodString;
+    user_id: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    simulation_id: z.ZodNumber;
+}, z.core.$strict> | z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    enabled: z.ZodBoolean;
+    id: z.ZodNumber;
+    name: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    slack_user_id: z.ZodString;
+    slack_channel_id: z.ZodNullable<z.ZodString>;
+    raw_text: z.ZodString;
+    detected_intent: z.ZodString;
+    extracted_params: z.ZodObject<{
+        qaFlowId: z.ZodOptional<z.ZodNumber>;
+        appId: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        channel: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        workflowName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    status: z.ZodEnum<{
+        received: "received";
+        classifying: "classifying";
+        dispatched: "dispatched";
+        completed: "completed";
+        failed: "failed";
+    }>;
+    response_text: z.ZodNullable<z.ZodString>;
+    error_message: z.ZodNullable<z.ZodString>;
+    duration_ms: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict> | z.ZodObject<{
+    survey_id: z.ZodNumber;
+    details: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+    target_user_id: z.ZodNumber;
+    target_user_email: z.ZodString;
+    reason: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    target_user_id: z.ZodNumber;
+    details: z.ZodString;
+}, z.core.$strict>]> | z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        app: "app";
+        website: "website";
+    }>;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    widget_type: z.ZodEnum<{
+        widget: "widget";
+    }>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    file_name: z.ZodString;
+    file_size: z.ZodNumber;
+    file_type: z.ZodString;
+    file_url: z.ZodString;
+    source_url: z.ZodOptional<z.ZodString>;
+}, z.core.$strict> | z.ZodObject<{
+    id: z.ZodNumber;
+    file_name: z.ZodString;
+    source_url: z.ZodString;
+    action: z.ZodLiteral<"refreshed">;
+}, z.core.$strict> | z.ZodObject<{
+    id: z.ZodNumber;
+    file_name: z.ZodString;
+    file_type: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    target_user_email: z.ZodString;
+    reminder: z.ZodOptional<z.ZodLiteral<true>>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    target_user_email: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    slug: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    session_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    invoice_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    invoice_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    chat_id: z.ZodString;
+    mode: z.ZodString;
+    question: z.ZodString;
+    timestamp: z.ZodString;
+    user_id: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    simulation_id: z.ZodNumber;
+}, z.core.$strict> | z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    enabled: z.ZodBoolean;
+    id: z.ZodNumber;
+    name: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    slack_user_id: z.ZodString;
+    slack_channel_id: z.ZodNullable<z.ZodString>;
+    raw_text: z.ZodString;
+    detected_intent: z.ZodString;
+    extracted_params: z.ZodObject<{
+        qaFlowId: z.ZodOptional<z.ZodNumber>;
+        appId: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        channel: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        workflowName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    status: z.ZodEnum<{
+        received: "received";
+        classifying: "classifying";
+        dispatched: "dispatched";
+        completed: "completed";
+        failed: "failed";
+    }>;
+    response_text: z.ZodNullable<z.ZodString>;
+    error_message: z.ZodNullable<z.ZodString>;
+    duration_ms: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict> | z.ZodObject<{
+    survey_id: z.ZodNumber;
+    details: z.ZodString;
+}, z.core.$strict>, ...(z.ZodObject<{
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+    target_user_id: z.ZodNumber;
+    target_user_email: z.ZodString;
+    reason: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    target_user_id: z.ZodNumber;
+    details: z.ZodString;
+}, z.core.$strict>]> | z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        app: "app";
+        website: "website";
+    }>;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    widget_type: z.ZodEnum<{
+        widget: "widget";
+    }>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    file_name: z.ZodString;
+    file_size: z.ZodNumber;
+    file_type: z.ZodString;
+    file_url: z.ZodString;
+    source_url: z.ZodOptional<z.ZodString>;
+}, z.core.$strict> | z.ZodObject<{
+    id: z.ZodNumber;
+    file_name: z.ZodString;
+    source_url: z.ZodString;
+    action: z.ZodLiteral<"refreshed">;
+}, z.core.$strict> | z.ZodObject<{
+    id: z.ZodNumber;
+    file_name: z.ZodString;
+    file_type: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    target_user_email: z.ZodString;
+    reminder: z.ZodOptional<z.ZodLiteral<true>>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    target_user_email: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    slug: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    subscription_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    session_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    invoice_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    invoice_id: z.ZodString;
+    plan: z.ZodOptional<z.ZodString>;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    chat_id: z.ZodString;
+    mode: z.ZodString;
+    question: z.ZodString;
+    timestamp: z.ZodString;
+    user_id: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict> | z.ZodObject<{
+    application_id: z.ZodNumber;
+    simulation_id: z.ZodNumber;
+}, z.core.$strict> | z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    enabled: z.ZodBoolean;
+    id: z.ZodNumber;
+    name: z.ZodString;
+    details: z.ZodString;
+}, z.core.$strict> | z.ZodObject<{
+    slack_user_id: z.ZodString;
+    slack_channel_id: z.ZodNullable<z.ZodString>;
+    raw_text: z.ZodString;
+    detected_intent: z.ZodString;
+    extracted_params: z.ZodObject<{
+        qaFlowId: z.ZodOptional<z.ZodNumber>;
+        appId: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        channel: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        workflowName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    status: z.ZodEnum<{
+        received: "received";
+        classifying: "classifying";
+        dispatched: "dispatched";
+        completed: "completed";
+        failed: "failed";
+    }>;
+    response_text: z.ZodNullable<z.ZodString>;
+    error_message: z.ZodNullable<z.ZodString>;
+    duration_ms: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict> | z.ZodObject<{
+    survey_id: z.ZodNumber;
+    details: z.ZodString;
+}, z.core.$strict>)[]]>;
 export declare const ActivityLogEntitySchema: z.ZodObject<{
     id: z.ZodNumber;
     created_at: z.ZodCoercedDate<unknown>;
@@ -402,7 +786,391 @@ export declare const ActivityLogEntitySchema: z.ZodObject<{
         unpublish_survey: "unpublish_survey";
         delete_survey_response: "delete_survey_response";
     }>;
-    metadata: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, ...z.ZodTypeAny<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]]>>>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodObject<{
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+        target_user_id: z.ZodNumber;
+        target_user_email: z.ZodString;
+        reason: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        target_user_id: z.ZodNumber;
+        details: z.ZodString;
+    }, z.core.$strict>]> | z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            app: "app";
+            website: "website";
+        }>;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        widget_type: z.ZodEnum<{
+            widget: "widget";
+        }>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        file_name: z.ZodString;
+        file_size: z.ZodNumber;
+        file_type: z.ZodString;
+        file_url: z.ZodString;
+        source_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict> | z.ZodObject<{
+        id: z.ZodNumber;
+        file_name: z.ZodString;
+        source_url: z.ZodString;
+        action: z.ZodLiteral<"refreshed">;
+    }, z.core.$strict> | z.ZodObject<{
+        id: z.ZodNumber;
+        file_name: z.ZodString;
+        file_type: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        target_user_email: z.ZodString;
+        reminder: z.ZodOptional<z.ZodLiteral<true>>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        target_user_email: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        slug: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        session_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        invoice_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        invoice_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        chat_id: z.ZodString;
+        mode: z.ZodString;
+        question: z.ZodString;
+        timestamp: z.ZodString;
+        user_id: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        simulation_id: z.ZodNumber;
+    }, z.core.$strict> | z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        enabled: z.ZodBoolean;
+        id: z.ZodNumber;
+        name: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        slack_user_id: z.ZodString;
+        slack_channel_id: z.ZodNullable<z.ZodString>;
+        raw_text: z.ZodString;
+        detected_intent: z.ZodString;
+        extracted_params: z.ZodObject<{
+            qaFlowId: z.ZodOptional<z.ZodNumber>;
+            appId: z.ZodOptional<z.ZodNumber>;
+            instructions: z.ZodOptional<z.ZodString>;
+            query: z.ZodOptional<z.ZodString>;
+            channel: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            workflowName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        status: z.ZodEnum<{
+            received: "received";
+            classifying: "classifying";
+            dispatched: "dispatched";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        response_text: z.ZodNullable<z.ZodString>;
+        error_message: z.ZodNullable<z.ZodString>;
+        duration_ms: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict> | z.ZodObject<{
+        survey_id: z.ZodNumber;
+        details: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+        target_user_id: z.ZodNumber;
+        target_user_email: z.ZodString;
+        reason: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        target_user_id: z.ZodNumber;
+        details: z.ZodString;
+    }, z.core.$strict>]> | z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            app: "app";
+            website: "website";
+        }>;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        widget_type: z.ZodEnum<{
+            widget: "widget";
+        }>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        file_name: z.ZodString;
+        file_size: z.ZodNumber;
+        file_type: z.ZodString;
+        file_url: z.ZodString;
+        source_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict> | z.ZodObject<{
+        id: z.ZodNumber;
+        file_name: z.ZodString;
+        source_url: z.ZodString;
+        action: z.ZodLiteral<"refreshed">;
+    }, z.core.$strict> | z.ZodObject<{
+        id: z.ZodNumber;
+        file_name: z.ZodString;
+        file_type: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        target_user_email: z.ZodString;
+        reminder: z.ZodOptional<z.ZodLiteral<true>>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        target_user_email: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        slug: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        session_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        invoice_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        invoice_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        chat_id: z.ZodString;
+        mode: z.ZodString;
+        question: z.ZodString;
+        timestamp: z.ZodString;
+        user_id: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        simulation_id: z.ZodNumber;
+    }, z.core.$strict> | z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        enabled: z.ZodBoolean;
+        id: z.ZodNumber;
+        name: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        slack_user_id: z.ZodString;
+        slack_channel_id: z.ZodNullable<z.ZodString>;
+        raw_text: z.ZodString;
+        detected_intent: z.ZodString;
+        extracted_params: z.ZodObject<{
+            qaFlowId: z.ZodOptional<z.ZodNumber>;
+            appId: z.ZodOptional<z.ZodNumber>;
+            instructions: z.ZodOptional<z.ZodString>;
+            query: z.ZodOptional<z.ZodString>;
+            channel: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            workflowName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        status: z.ZodEnum<{
+            received: "received";
+            classifying: "classifying";
+            dispatched: "dispatched";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        response_text: z.ZodNullable<z.ZodString>;
+        error_message: z.ZodNullable<z.ZodString>;
+        duration_ms: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict> | z.ZodObject<{
+        survey_id: z.ZodNumber;
+        details: z.ZodString;
+    }, z.core.$strict>, ...(z.ZodObject<{
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodUnion<readonly [z.ZodObject<{
+        target_user_id: z.ZodNumber;
+        target_user_email: z.ZodString;
+        reason: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        target_user_id: z.ZodNumber;
+        details: z.ZodString;
+    }, z.core.$strict>]> | z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            app: "app";
+            website: "website";
+        }>;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        widget_type: z.ZodEnum<{
+            widget: "widget";
+        }>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        file_name: z.ZodString;
+        file_size: z.ZodNumber;
+        file_type: z.ZodString;
+        file_url: z.ZodString;
+        source_url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict> | z.ZodObject<{
+        id: z.ZodNumber;
+        file_name: z.ZodString;
+        source_url: z.ZodString;
+        action: z.ZodLiteral<"refreshed">;
+    }, z.core.$strict> | z.ZodObject<{
+        id: z.ZodNumber;
+        file_name: z.ZodString;
+        file_type: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        target_user_email: z.ZodString;
+        reminder: z.ZodOptional<z.ZodLiteral<true>>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        target_user_email: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        slug: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        subscription_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        session_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        invoice_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        invoice_id: z.ZodString;
+        plan: z.ZodOptional<z.ZodString>;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        chat_id: z.ZodString;
+        mode: z.ZodString;
+        question: z.ZodString;
+        timestamp: z.ZodString;
+        user_id: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict> | z.ZodObject<{
+        application_id: z.ZodNumber;
+        simulation_id: z.ZodNumber;
+    }, z.core.$strict> | z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        enabled: z.ZodBoolean;
+        id: z.ZodNumber;
+        name: z.ZodString;
+        details: z.ZodString;
+    }, z.core.$strict> | z.ZodObject<{
+        slack_user_id: z.ZodString;
+        slack_channel_id: z.ZodNullable<z.ZodString>;
+        raw_text: z.ZodString;
+        detected_intent: z.ZodString;
+        extracted_params: z.ZodObject<{
+            qaFlowId: z.ZodOptional<z.ZodNumber>;
+            appId: z.ZodOptional<z.ZodNumber>;
+            instructions: z.ZodOptional<z.ZodString>;
+            query: z.ZodOptional<z.ZodString>;
+            channel: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            workflowName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        status: z.ZodEnum<{
+            received: "received";
+            classifying: "classifying";
+            dispatched: "dispatched";
+            completed: "completed";
+            failed: "failed";
+        }>;
+        response_text: z.ZodNullable<z.ZodString>;
+        error_message: z.ZodNullable<z.ZodString>;
+        duration_ms: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict> | z.ZodObject<{
+        survey_id: z.ZodNumber;
+        details: z.ZodString;
+    }, z.core.$strict>)[]]>>>;
 }, z.core.$strip>;
 export type ActivityLogData = z.infer<typeof ActivityLogEntitySchema>;
 export declare const WidgetQuestionLogSchema: z.ZodObject<{

package/dist/src/services/StorageService.d.ts

@@ -1,31 +1,28 @@
 /**
- * Browser-local persistence for the widget: the one door to `localStorage`, and the per-tenant chat context
- * (chat_id, transcript, composer mode, open state, resolved config) behind the `storageService` singleton.
- * `tenantScope` is the scope suffix for every browser-local key — the credential id, else the application id, else
- * `default` — shared with the drag-position and resize keys so all of them partition the same way. `readLocal` /
- * `writeLocal` are the only `localStorage` access in `src/`; a host page can deny storage outright (third-party
- * cookies off, sandboxed iframe) where even reading throws, so both degrade to a warn and the widget keeps working
- * unpersisted. `loadContext` parses one key merged over `DEFAULT_CONTEXT`, so a payload from an older widget
- * version reads as incomplete rather than corrupt, and discards anything older than `CONTEXT_EXPIRY_MS` (7 days).
- * `StorageService`'s `getContext`, `updateContext` (merges, restamps `timestamp`, writes through), `getChatId` /
- * `setChatId`, `getCredentialedConfig` (null unless both `mtxId` and `mtxKey` are present, so callers cannot
- * dispatch half-credentialed) and `setConfig` sit behind the singleton; `readChatSnapshot` / `writeChatSnapshot`
- * are the UI-facing view of the context. `setConfig` re-keys storage to `${STORAGE_KEY}_${tenantScope}` and
- * reloads from that key, since without it two applications embedded on one origin would share a stored chat_id and
- * one tenant's transcript would leak into another's.
+ * Browser-local persistence for the widget: the one door to `localStorage`, and the per-tenant chat
+ * context (chat_id, transcript, composer mode, open state, resolved config) behind the `storageService`
+ * singleton. `tenantScope` (credential id, else application id, else `default`) is the scope suffix every
+ * browser-local key shares via `scopedKey`, so the chat-context, drag-position and resize keys all
+ * partition by tenant identically. `readLocal`/`writeLocal` are the only `localStorage` access in `src/`;
+ * a host page can deny storage outright (third-party cookies off, sandboxed iframe), so both degrade to
+ * a warn and the widget keeps working unpersisted.
  *
- * The snapshot is `{messages, currentMode, isOpen}` — chat_id, config and timestamp are deliberately excluded.
- * Reading revives `timestamp` to a `Date` and backfills a text part for messages stored before `parts` existed;
- * writing drops `videoStream` (unserializable, dead on reload), rewriting it as `Screen sharing ended`.
+ * `loadContext` merges one parsed key over `DEFAULT_CONTEXT`, so an older widget version's payload reads
+ * as incomplete rather than corrupt, and discards anything past `CONTEXT_EXPIRY_MS` (7 days).
+ * `getCredentialedConfig` is null unless both `mtxId` and `mtxKey` are present, so callers cannot
+ * dispatch half-credentialed. `setConfig` re-keys storage to `${STORAGE_KEY}_${tenantScope}` and reloads
+ * from it, since without that two applications on one origin would leak one tenant's transcript into
+ * another's.
  *
- * `scopedKey(name, config)` is the one place `<name>_<tenantScope>` is assembled — the position and resize-size
- * keys share it with the chat context key, so all three browser-local entries partition by tenant identically.
+ * The chat snapshot is `{messages, currentMode, isOpen}` — chat_id, config and timestamp are deliberately
+ * excluded. Reading revives `timestamp` to a `Date` and backfills a text part for messages stored before
+ * `parts` existed; writing drops `videoStream` (unserializable, dead on reload), rewriting it as "Screen
+ * sharing ended".
  *
- * `sanitizeStoredContext` is the boundary guard for the parsed JSON: hand-rolled (not zod) per the
- * package-level rule that a schema imported as a VALUE anywhere reachable from `src/index.tsx` pulls
- * zod's whole runtime into the bundle. Each field is checked against its own type and falls back to
- * `DEFAULT_CONTEXT`'s value individually, so a partially-corrupt payload (e.g. a bad `currentMode` from
- * an older widget version) keeps the fields that DID parse rather than discarding the whole context.
+ * `sanitizeStoredContext` is hand-rolled, not zod, per the package-level rule that a schema imported as a
+ * VALUE anywhere reachable from `src/index.tsx` pulls zod's whole runtime into the bundle. Each field
+ * falls back to `DEFAULT_CONTEXT`'s value individually, so a partially-corrupt payload keeps the fields
+ * that DID parse rather than discarding the whole context.
  */
 import type { ChatMessage, InstructionType, MarketrixConfig, ValidWidgetConfig } from '../types';
 type StoredMessage = Omit<ChatMessage, 'videoStream' | 'timestamp'> & {

package/dist/src/utils/dom.d.ts

@@ -1,29 +1,27 @@
 /**
  * Predicates the agent's element index runs against the HOST page's DOM — what counts as a control and
- * whether it is reachable — plus `WIDGET_SHADOW_HOST_CLASS`, set by `bootstrap` on the shadow host so
- * `DomService` can recognise its own overlay chrome instead of reporting it as obscuring the host page, and
- * `TABBABLE_SELECTOR`, the one tab-order candidate query: `send_keys`' Tab simulation walks the host page
- * with it and `useFocusTrap` the widget's own tree, and they must agree on what the browser would focus next.
+ * whether it is reachable. `TABBABLE_SELECTOR` is the one tab-order candidate query: `send_keys`'s Tab
+ * simulation walks the host page with it and `useFocusTrap` the widget's own tree, and they must agree
+ * on what the browser would focus next. `WIDGET_SHADOW_HOST_CLASS`, set by `bootstrap` on the shadow
+ * host, lets `DomService` recognise its own overlay chrome instead of reporting it as obscuring the host
+ * page.
  *
- * `ancestry` walks element → `parentElement`, crossing each shadow boundary at its host; a bare
- * `parentElement` walk stops dead at a `ShadowRoot`, so a control inside a host-page web component
- * would read as top-level. `disabledReason` names why an element cannot be operated (disabled control,
- * `aria-disabled`, or an `inert` ancestor) as a sentence fragment completing `DomService`'s
- * `Element <n> …` message — reword both together; `disabled` is read duck-typed since it sits on
- * several unrelated control interfaces. `isIndexable`, checked against `INTERACTIVE_ROLES`, is
- * `DomService`'s geometry-aware fallback after its cheap selector/handler checks. Visibility there is more
- * than computed style: an element scrolled out of an `overflow: hidden|clip` ancestor is unreachable despite
- * a non-zero rect (that walk stops at `document.body`), and a zero-size shadow host hides its whole tree, so
- * both chains are climbed. Its one `try` is deliberate — the host page owns this DOM and may have patched
- * anything on it, so a poisoned element is logged with the real error and skipped rather than aborting the
- * whole indexing pass.
+ * `ancestry` walks element → `parentElement`, crossing each shadow boundary at its host, since a bare
+ * `parentElement` walk stops dead at a `ShadowRoot` and a control inside a host-page web component would
+ * read as top-level. `disabledReason` names why an element cannot be operated (disabled control,
+ * `aria-disabled`, or an `inert` ancestor) as a sentence fragment completing `DomService`'s `Element
+ * <n> …` message — reword both together. `isIndexable` is `DomService`'s geometry-aware fallback after
+ * its cheap selector/handler checks; visibility there climbs both the `overflow: hidden|clip` chain
+ * (that walk stops at `document.body`) and the shadow-host size, since either can hide an element
+ * despite a non-zero rect. Its one `try` is deliberate — the host page owns this DOM and may have
+ * patched anything on it, so a poisoned element is logged with the real error and skipped rather than
+ * aborting the whole indexing pass.
  *
  * `focusablesIn` is the one home for "which `TABBABLE_SELECTOR` matches are actually reachable" —
- * `useFocusTrap` (the widget's own tree) and `keySimulation`'s Tab simulation (the host page) both call
- * it so they can't re-diverge. Per WAI-ARIA, `aria-hidden="true"` removes an element (and its whole
- * subtree) from the accessibility tree, so it must not receive focus — `isAriaHidden` walks ancestors,
- * not just the element itself, since a hidden container hides everything under it even though none of
- * those descendants carry the attribute.
+ * `useFocusTrap` and `keySimulation`'s Tab simulation both call it so they can't re-diverge.
+ * `isAriaHidden` walks ancestors, not just the element itself, since a hidden container hides everything
+ * under it (per WAI-ARIA, `aria-hidden="true"` removes an element and its whole subtree from the
+ * accessibility tree) even though none of those descendants carry the attribute.
  */
 export declare const WIDGET_SHADOW_HOST_CLASS = "marketrix-widget-container";
 export declare const TABBABLE_SELECTOR = "a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marketrix.ai/widget",
-  "version": "4.0.109",
+  "version": "4.0.111",
   "type": "module",
   "packageManager": "bun@1.4.2",
   "sideEffects": false,