@marketrix.ai/widget 4.0.113 → 4.0.115

package/dist/src/components/views/ChatView.d.ts

@@ -20,7 +20,9 @@
  *
  * `useScreenShare` (this file's only other consumer) owns the screen-share lifecycle: the in-transcript
  * permission card, the browser picker, the live share message, and ending a share. `useLatest` keeps a
- * value readable from a callback that must not be re-created (the polling interval below, mounted once).
+ * value readable from a callback that must not be re-created (the polling interval below, mounted once);
+its refs are listed in that effect's deps for the linter, but since `useRef` identity never changes,
+listing them cannot re-arm the interval.
  * The hook returns `requestScreenAccess` — posting a request card carrying the queued turn, no-oping if
  * one is already open — plus that card's Allow/Deny handlers, the toolbar dialog's Allow/Dismiss
  * handlers, and `toggleScreenShareRef`, a toggle stopping a live share or opening that dialog.

package/dist/src/context/WidgetProviders.d.ts

@@ -13,10 +13,14 @@
  * mounted before the read, its first effect would overwrite the stored transcript on every remount.
  * `previewMode` skips init entirely: no chat session is minted, no stream opened, nothing persisted.
  *
- * The init effect's deps are empty on purpose — once per mount — and `cancelled` drops the connect when
- * a StrictMode double-invoke or an unmount cleans up before the chat_id resolves. A failed connect is
- * logged only, since `StreamClient` owns the backoff reconnect; a failed init is logged AND surfaced
- * through `uiActions.setError`.
+ * The init effect lists `previewMode`, `uiActions` and `chatActions` for the linter, but runs once per
+ * mount in practice — `uiActions` is a `useMemo([])` and `chatActions` bottoms out in `commit`
+ * (`useCallback([])`), both stable for the component's lifetime, and `previewMode` is fixed by the
+ * caller. `cancelled` drops the connect when a StrictMode double-invoke or an unmount cleans up before
+ * the chat_id resolves. `streamClient.connect` never rejects — it catches internally and owns its own
+ * backoff reconnect and warn-level log — so the call here is fire-and-forget; a failed INIT (the
+ * snapshot restore or `getOrCreateChatId`) is the one thing this bridge logs and surfaces through
+ * `uiActions.setError`.
  */
 import React from 'react';
 export declare const PortalContainerContext: React.Context<HTMLElement | null>;

package/dist/src/design-system/component-tokens.d.ts

@@ -8,7 +8,10 @@
  *
  * `LAYER_TOKENS` is the z-index ladder (screen-edge glow < panel < dialog < toast), based just above the
  * 2^31-ish ceiling most host pages use so the widget sits over everything without the values overflowing a
- * 32-bit int.
+ * 32-bit int. `showHighlight`/`showPopup` are a separate, much higher pair near the int32 ceiling: Show
+ * mode's coaching overlay (`ShowModeService`) mounts to the HOST page, outside the shadow root, to point at
+ * the widget's OWN chrome — it must outrank every value in this ladder by a wide margin, not sit one step
+ * above `toast`.
  */
 import type { CSSProperties } from 'react';
 export type RadiusToken = 'none' | 'sm' | 'md' | 'lg' | 'xl' | 'pill';
@@ -33,6 +36,8 @@ export declare const LAYER_TOKENS: {
     panel: number;
     dialog: number;
     toast: number;
+    showHighlight: number;
+    showPopup: number;
 };
 export declare const notificationToneStyles: Record<NotificationTone, {
     background: string;

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

@@ -17,6 +17,9 @@
  * highlight is sized and placed over its element, so the first paint and every reposition run through it;
  * placement takes the first of right/left/above/below that fits then clamps, its 120px height an assumption,
  * and the watchdog tests `document.body.contains` first, covering removal as well as occlusion.
+ * `ACCENT_COLOR`/`TEXT_COLOR` are raw literals rather than design-system tokens: the highlight and popup
+ * mount to `document.body` on the HOST page, outside the shadow root, so `index.css`'s `:host`-scoped
+ * CSS custom properties never reach them.
  */
 interface ShowModeOptions {
     element: HTMLElement;

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

@@ -0,0 +1,2 @@
+export declare function logWarn(message: string, cause?: unknown): void;
+export declare function logError(message: string, cause?: unknown): void;