@runtypelabs/persona 3.34.0 → 3.35.0

package/src/components/widget-view.ts

@@ -0,0 +1,234 @@
+import { AgentWidgetConfig } from "../types";
+import { AgentWidgetPlugin } from "../plugins/types";
+import { createWrapper, buildPanel, PanelElements } from "./panel";
+import { HeaderElements } from "./header-builder";
+import { createLauncherButton, LauncherButton } from "./launcher";
+
+/**
+ * Widget view assembly layer.
+ *
+ * `ui.ts` owns behavior (session dispatch, streaming, scroll, voice, events);
+ * this module owns the one-time structural assembly of the widget's DOM and
+ * groups the resulting element references into named regions so callers read
+ * `view.composer.textarea` instead of destructuring a ~30-field flat object.
+ *
+ * The grouped refs are a view over the same nodes returned by `buildPanel`;
+ * the raw flat `PanelElements` is still exposed as `view.panelElements` for
+ * incremental migration. No framework, no virtual DOM: these are the real
+ * elements built by the existing `panel.ts` / `composer-*` / `header-*`
+ * builders.
+ */
+
+export interface WidgetShellRefs {
+  wrapper: HTMLElement;
+  panel: HTMLElement;
+  /** Composer-bar mode only: viewport-fixed sibling that owns the pill. */
+  pillRoot?: HTMLElement;
+}
+
+export interface WidgetTranscriptRefs {
+  container: HTMLElement;
+  body: HTMLElement;
+  messagesWrapper: HTMLElement;
+  /** Absolute slot above the composer where interactive sheets mount. */
+  composerOverlay: HTMLElement;
+  introTitle: HTMLElement;
+  introSubtitle: HTMLElement;
+}
+
+export interface WidgetHeaderRefs {
+  /** The header root element currently mounted in the container. */
+  element: HTMLElement;
+  iconHolder: HTMLElement;
+  headerTitle: HTMLElement;
+  headerSubtitle: HTMLElement;
+  closeButton: HTMLButtonElement;
+  closeButtonWrapper: HTMLElement | null;
+  clearChatButton: HTMLButtonElement | null;
+  clearChatButtonWrapper: HTMLElement | null;
+}
+
+export interface WidgetComposerRefs {
+  /** The footer root element currently mounted in the panel. */
+  footer: HTMLElement;
+  form: HTMLFormElement;
+  textarea: HTMLTextAreaElement;
+  sendButton: HTMLButtonElement;
+  sendButtonWrapper: HTMLElement;
+  micButton: HTMLButtonElement | null;
+  micButtonWrapper: HTMLElement | null;
+  statusText: HTMLElement;
+  suggestions: HTMLElement;
+  attachmentButton: HTMLButtonElement | null;
+  attachmentButtonWrapper: HTMLElement | null;
+  attachmentInput: HTMLInputElement | null;
+  attachmentPreviewsContainer: HTMLElement | null;
+  actionsRow: HTMLElement;
+  leftActions: HTMLElement;
+  rightActions: HTMLElement;
+  setSendButtonMode: (mode: "send" | "stop") => void;
+  /** Composer-bar peek banner (undefined for non-composer-bar modes). */
+  peekBanner?: HTMLButtonElement;
+  peekTextNode?: HTMLElement;
+}
+
+export interface WidgetView {
+  shell: WidgetShellRefs;
+  /** Raw flat refs from `buildPanel`, retained for incremental migration. */
+  panelElements: PanelElements;
+  transcript: WidgetTranscriptRefs;
+  header: WidgetHeaderRefs;
+  composer: WidgetComposerRefs;
+  /**
+   * Swap the mounted header element for `next.header` and mirror the header
+   * sub-refs (icon/title/subtitle/close) onto `view.header`. Used by the
+   * header-layout rebuild path. Returns the new `HeaderElements` for the
+   * caller to mirror into its own locals during incremental migration.
+   */
+  replaceHeader: (next: HeaderElements) => HeaderElements;
+  /**
+   * Swap the mounted footer element for `nextFooter` and update
+   * `view.composer.footer`. The remaining composer sub-refs become stale
+   * after a plugin-provided composer replaces the footer; callers re-derive
+   * them from the new footer (see `bindComposerRefsFromFooter` in ui.ts).
+   */
+  replaceComposer: (nextFooter: HTMLElement) => void;
+}
+
+export interface CreateWidgetViewOptions {
+  config: AgentWidgetConfig;
+  /** Whether the panel renders a close affordance (panel is toggleable). */
+  showClose: boolean;
+}
+
+/**
+ * Build the widget shell + panel once and group the element references into
+ * named regions. Equivalent to the previous `createWrapper(config)` +
+ * `buildPanel(config, showClose)` pair, plus the grouping/replacement helpers.
+ */
+export const createWidgetView = ({
+  config,
+  showClose,
+}: CreateWidgetViewOptions): WidgetView => {
+  const { wrapper, panel, pillRoot } = createWrapper(config);
+  const panelElements = buildPanel(config, showClose);
+
+  const shell: WidgetShellRefs = { wrapper, panel, pillRoot };
+
+  const transcript: WidgetTranscriptRefs = {
+    container: panelElements.container,
+    body: panelElements.body,
+    messagesWrapper: panelElements.messagesWrapper,
+    composerOverlay: panelElements.composerOverlay,
+    introTitle: panelElements.introTitle,
+    introSubtitle: panelElements.introSubtitle,
+  };
+
+  const header: WidgetHeaderRefs = {
+    element: panelElements.header,
+    iconHolder: panelElements.iconHolder,
+    headerTitle: panelElements.headerTitle,
+    headerSubtitle: panelElements.headerSubtitle,
+    closeButton: panelElements.closeButton,
+    closeButtonWrapper: panelElements.closeButtonWrapper,
+    clearChatButton: panelElements.clearChatButton,
+    clearChatButtonWrapper: panelElements.clearChatButtonWrapper,
+  };
+
+  const composer: WidgetComposerRefs = {
+    footer: panelElements.footer,
+    form: panelElements.composerForm,
+    textarea: panelElements.textarea,
+    sendButton: panelElements.sendButton,
+    sendButtonWrapper: panelElements.sendButtonWrapper,
+    micButton: panelElements.micButton,
+    micButtonWrapper: panelElements.micButtonWrapper,
+    statusText: panelElements.statusText,
+    suggestions: panelElements.suggestions,
+    attachmentButton: panelElements.attachmentButton,
+    attachmentButtonWrapper: panelElements.attachmentButtonWrapper,
+    attachmentInput: panelElements.attachmentInput,
+    attachmentPreviewsContainer: panelElements.attachmentPreviewsContainer,
+    actionsRow: panelElements.actionsRow,
+    leftActions: panelElements.leftActions,
+    rightActions: panelElements.rightActions,
+    setSendButtonMode: panelElements.setSendButtonMode,
+    peekBanner: panelElements.peekBanner,
+    peekTextNode: panelElements.peekTextNode,
+  };
+
+  const replaceHeader = (next: HeaderElements): HeaderElements => {
+    header.element.replaceWith(next.header);
+    header.element = next.header;
+    header.iconHolder = next.iconHolder;
+    header.headerTitle = next.headerTitle;
+    header.headerSubtitle = next.headerSubtitle;
+    header.closeButton = next.closeButton;
+    header.closeButtonWrapper = next.closeButtonWrapper;
+    header.clearChatButton = next.clearChatButton;
+    header.clearChatButtonWrapper = next.clearChatButtonWrapper;
+    return next;
+  };
+
+  const replaceComposer = (nextFooter: HTMLElement): void => {
+    composer.footer.replaceWith(nextFooter);
+    composer.footer = nextFooter;
+  };
+
+  return {
+    shell,
+    panelElements,
+    transcript,
+    header,
+    composer,
+    replaceHeader,
+    replaceComposer,
+  };
+};
+
+export interface ResolveLauncherOptions {
+  config: AgentWidgetConfig;
+  plugins: AgentWidgetPlugin[];
+  /** Toggles the panel open/closed; wired to the launcher's click. */
+  onToggle: () => void;
+}
+
+export interface ResolvedLauncher {
+  /**
+   * The default launcher controller (with `update`/`destroy`), or null when a
+   * plugin supplied a custom launcher element.
+   */
+  instance: LauncherButton | null;
+  /** The element to mount: either the default button or the plugin's element. */
+  element: HTMLElement;
+}
+
+/**
+ * Resolve the launcher element, honoring a `renderLauncher` plugin if present.
+ * De-duplicates the identical default-or-plugin logic that previously lived at
+ * both the initial-build and re-enable call sites in ui.ts.
+ *
+ * When a plugin returns a custom element, `instance` is null (the plugin owns
+ * its own updates); otherwise the default `LauncherButton` controller is
+ * returned so the caller can drive `update()`/`destroy()`.
+ */
+export const resolveLauncher = ({
+  config,
+  plugins,
+  onToggle,
+}: ResolveLauncherOptions): ResolvedLauncher => {
+  const launcherPlugin = plugins.find((p) => p.renderLauncher);
+  if (launcherPlugin?.renderLauncher) {
+    const customLauncher = launcherPlugin.renderLauncher({
+      config,
+      defaultRenderer: () => createLauncherButton(config, onToggle).element,
+      onToggle,
+    });
+    if (customLauncher) {
+      return { instance: null, element: customLauncher };
+    }
+  }
+
+  const instance = createLauncherButton(config, onToggle);
+  return { instance, element: instance.element };
+};

package/src/defaults.ts

@@ -1,4 +1,4 @@
-import type { AgentWidgetConfig } from "./types";
+import type { AgentWidgetConfig, AgentWidgetLauncherConfig } from "./types";
 import type { DeepPartial, PersonaTheme } from "./types/theme";
 import { deepMerge } from "./utils/deep-merge";
 
@@ -12,6 +12,58 @@ export const DEFAULT_FLOATING_LAUNCHER_WIDTH = "min(440px, calc(100vw - 24px))";
 /** Max width cap paired with {@link DEFAULT_FLOATING_LAUNCHER_WIDTH} for theme defaults. */
 export const DEFAULT_FLOATING_LAUNCHER_MAX_WIDTH = "440px";
 
+export const DEFAULT_LAUNCHER_CONFIG: AgentWidgetLauncherConfig = {
+  enabled: true,
+  mountMode: "floating",
+  dock: {
+    side: "right",
+    width: "420px",
+  },
+  title: "Chat Assistant",
+  subtitle: "Here to help you get answers fast",
+  agentIconText: "💬",
+  agentIconName: "bot",
+  headerIconName: "bot",
+  position: "bottom-right",
+  width: DEFAULT_FLOATING_LAUNCHER_WIDTH,
+  heightOffset: 0,
+  autoExpand: false,
+  callToActionIconHidden: false,
+  agentIconSize: "40px",
+  headerIconSize: "40px",
+  closeButtonSize: "32px",
+  // Zero out browser-default <button> padding so the icon gets the full
+  // 32x32 content box, matching clearChat.paddingX/Y below. Without this,
+  // UA stylesheets add ~1-2px vertical and ~6px horizontal padding that
+  // eats into the border-box width and shrinks the rendered icon.
+  closeButtonPaddingX: "0px",
+  closeButtonPaddingY: "0px",
+  callToActionIconName: "arrow-up-right",
+  callToActionIconText: "",
+  callToActionIconSize: "32px",
+  callToActionIconPadding: "5px",
+  callToActionIconColor: undefined,
+  callToActionIconBackgroundColor: undefined,
+  // closeButtonColor / clearChat.iconColor omitted so theme.components.header.actionIconForeground applies.
+  closeButtonBackgroundColor: "transparent",
+  clearChat: {
+    backgroundColor: "transparent",
+    borderColor: "transparent",
+    enabled: true,
+    placement: "inline",
+    iconName: "refresh-cw",
+    size: "32px",
+    showTooltip: true,
+    tooltipText: "Clear chat",
+    paddingX: "0px",
+    paddingY: "0px",
+  },
+  headerIconHidden: false,
+  border: undefined,
+  shadow:
+    "0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)",
+};
+
 /**
  * Default widget configuration
  * Single source of truth for all default values
@@ -23,56 +75,7 @@ export const DEFAULT_WIDGET_CONFIG: Partial<AgentWidgetConfig> = {
   theme: undefined,
   darkTheme: undefined,
   colorScheme: "light",
-  launcher: {
-    enabled: true,
-    mountMode: "floating",
-    dock: {
-      side: "right",
-      width: "420px",
-    },
-    title: "Chat Assistant",
-    subtitle: "Here to help you get answers fast",
-    agentIconText: "💬",
-    agentIconName: "bot",
-    headerIconName: "bot",
-    position: "bottom-right",
-    width: DEFAULT_FLOATING_LAUNCHER_WIDTH,
-    heightOffset: 0,
-    autoExpand: false,
-    callToActionIconHidden: false,
-    agentIconSize: "40px",
-    headerIconSize: "40px",
-    closeButtonSize: "32px",
-    // Zero out browser-default <button> padding so the icon gets the full
-    // 32x32 content box, matching clearChat.paddingX/Y below. Without this,
-    // UA stylesheets add ~1-2px vertical and ~6px horizontal padding that
-    // eats into the border-box width and shrinks the rendered icon.
-    closeButtonPaddingX: "0px",
-    closeButtonPaddingY: "0px",
-    callToActionIconName: "arrow-up-right",
-    callToActionIconText: "",
-    callToActionIconSize: "32px",
-    callToActionIconPadding: "5px",
-    callToActionIconColor: undefined,
-    callToActionIconBackgroundColor: undefined,
-    // closeButtonColor / clearChat.iconColor omitted so theme.components.header.actionIconForeground applies.
-    closeButtonBackgroundColor: "transparent",
-    clearChat: {
-      backgroundColor: "transparent",
-      borderColor: "transparent",
-      enabled: true,
-      placement: "inline",
-      iconName: "refresh-cw",
-      size: "32px",
-      showTooltip: true,
-      tooltipText: "Clear chat",
-      paddingX: "0px",
-      paddingY: "0px",
-    },
-    headerIconHidden: false,
-    border: undefined,
-    shadow: "0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1)",
-  },
+  launcher: DEFAULT_LAUNCHER_CONFIG,
   copy: {
     welcomeTitle: "Hello 👋",
     welcomeSubtitle: "Ask anything about your account or products.",

package/src/generated/runtype-openapi-contract.ts

@@ -285,6 +285,7 @@ export type RuntypeFlowSSEEvent = {
   totalSteps?: number;
   type: "flow_start";
 } | {
+  claudeManagedAgentId?: string;
   completedAt?: string;
   completedSteps?: number;
   duration?: number;
@@ -399,6 +400,7 @@ export type RuntypeFlowSSEEvent = {
   toolId: string;
 };
   type: "step_complete";
+  unresolvedVariables?: Array<string>;
 }) | {
   error: string;
   executionId?: string;
@@ -836,6 +838,7 @@ export type RuntypeDispatchSSEEvent = {
   totalSteps?: number;
   type: "flow_start";
 } | {
+  claudeManagedAgentId?: string;
   completedAt?: string;
   completedSteps?: number;
   duration?: number;
@@ -950,6 +953,7 @@ export type RuntypeDispatchSSEEvent = {
   toolId: string;
 };
   type: "step_complete";
+  unresolvedVariables?: Array<string>;
 }) | {
   error: string;
   executionId?: string;
@@ -1253,6 +1257,7 @@ export type RuntypeClientFeedbackRequest = {
   metadata?: Record<string, unknown>;
   rating?: number;
   sessionId: string;
+  token: string;
   type: "upvote" | "downvote" | "copy" | "csat" | "nps";
 };
 

package/src/index-core.ts

@@ -82,7 +82,7 @@ export type {
   AgentWidgetApproval,
   AgentWidgetApprovalConfig,
   AgentWidgetApprovalDecisionOptions,
-  // WebMCP — page-discovered tool consumption
+  // WebMCP: page-discovered tool consumption
   AgentWidgetWebMcpConfig,
   ClientToolDefinition,
   WebMcpConfirmHandler,
@@ -98,6 +98,7 @@ export type {
   EventStreamPayloadRenderContext,
   // Controller event map
   AgentWidgetControllerEventMap,
+  AgentWidgetReadAloudEvent,
   // Ask-user-question (built-in answer-pill sheet) types
   AskUserQuestionPayload,
   AskUserQuestionPrompt,
@@ -245,7 +246,7 @@ export type { AgentWidgetInitHandle };
 export type { AgentWidgetPlugin } from "./plugins/types";
 export { pluginRegistry } from "./plugins/registry";
 
-// Stream animation plugin API — lets consumers register custom animations
+// Stream animation plugin API: lets consumers register custom animations
 // that match the built-in surface (typewriter, pop-bubble) and subpath
 // modules (letter-rise, word-fade, wipe, glyph-cycle).
 export {
@@ -263,7 +264,7 @@ export type {
   AgentWidgetStreamAnimationPlaceholder,
 } from "./types";
 
-// Action system types — needed to type the `actionHandlers` / `actionParsers`
+// Action system types: needed to type the `actionHandlers` / `actionParsers`
 // config options and to author custom handlers/parsers.
 export type {
   AgentWidgetActionHandler,
@@ -435,7 +436,32 @@ export type {
   VoiceProvider,
   VoiceResult,
   VoiceStatus,
-  VoiceConfig
+  VoiceConfig,
+  VoiceMetrics,
+  VoicePlaybackEngine,
+  PcmStreamPlayer,
+  AgentWidgetVoiceStatusEvent,
+  ReadAloudState,
+  SpeechEngine,
+  SpeechRequest,
+  SpeechCallbacks
 } from "./types";
 
+export {
+  BrowserSpeechEngine,
+  pickBestVoice,
+  ReadAloudController
+} from "./voice";
+export type {
+  BrowserSpeechEngineOptions,
+  ReadAloudListener,
+  FallbackSpeechEngineOptions
+} from "./voice";
+// RuntypeSpeechEngine + FallbackSpeechEngine ship from the
+// `@runtypelabs/persona/voice-worklet-player` subpath, not here: keeping the
+// hosted read-aloud engine out of the main bundle lets the IIFE/CDN build defer
+// it to the `runtype-tts.js` chunk (loaded only for `provider: 'runtype'`). The
+// blessed way to use it is `textToSpeech: { provider: 'runtype' }` — no import
+// needed.
+
 export default initAgentWidgetFn;

package/src/index-global.ts

@@ -1,18 +1,18 @@
 /**
- * IIFE entry point — bundled for `<script>` tag consumers.
+ * IIFE entry point: bundled for `<script>` tag consumers.
  *
  * This file re-exports everything from the main entry AND side-imports all
  * built-in subpath animations so they register automatically. Script-tag
  * users who include the global build don't need extra script tags or
- * registration calls — setting `features.streamAnimation.type` to any
+ * registration calls: setting `features.streamAnimation.type` to any
  * built-in name just works.
  *
  * npm consumers continue to import from the main entry (`import ... from
- * "@runtypelabs/persona"`) — those animations stay in their subpath
+ * "@runtypelabs/persona"`): those animations stay in their subpath
  * modules so bundlers can tree-shake them.
  */
 
-// Re-export the full public API — from `index-core` (NOT `index`) so the
+// Re-export the full public API: from `index-core` (NOT `index`) so the
 // dev-only helpers (`generateCodeSnippet`, `createDemoCarousel`) stay out of the
 // CDN/IIFE bundle. npm consumers still get them via the `index.ts` barrel.
 export * from "./index-core";
@@ -35,7 +35,7 @@ export type { StreamAnimationPlugin, StreamAnimationContext } from "./types";
 // ---------------------------------------------------------------------------
 // Deferred WebMCP polyfill loading.
 //
-// This bundle is built with `@mcp-b/webmcp-polyfill` external — the bridge's
+// This bundle is built with `@mcp-b/webmcp-polyfill` external: the bridge's
 // default `import("@mcp-b/webmcp-polyfill")` is a bare specifier no browser
 // can resolve, so register a loader that imports the self-contained
 // `webmcp-polyfill.js` chunk from a sibling URL instead. Mirrors how
@@ -44,7 +44,7 @@ export type { StreamAnimationPlugin, StreamAnimationContext } from "./types";
 
 import { setWebMcpPolyfillLoader } from "./webmcp-bridge";
 
-// Capture at module-evaluation time — `document.currentScript` is null once
+// Capture at module-evaluation time: `document.currentScript` is null once
 // execution leaves the script's initial synchronous run.
 const widgetScriptSrc: string | null =
   typeof document !== "undefined"
@@ -70,3 +70,70 @@ setWebMcpPolyfillLoader(() => {
   // leaves it untouched (and must not try to bundle it).
   return import(/* @vite-ignore */ chunkUrl);
 });
+
+// ---------------------------------------------------------------------------
+// Deferred Markdown Parsers (marked + dompurify) loading.
+//
+// This bundle is built with `./markdown-parsers-entry` external: the Markdown
+// and HTML sanitization libraries are kept out of the CDN payload. Register a
+// loader that imports the self-contained `markdown-parsers.js` chunk from a sibling
+// URL. The session prefetches it at init so it's warm before the first message.
+// ---------------------------------------------------------------------------
+
+import { setMarkdownParsersLoader, loadMarkdownParsers } from "./markdown-parsers-loader";
+
+setMarkdownParsersLoader(() => {
+  const chunkUrl = widgetScriptSrc?.replace(
+    /index\.global\.js($|\?)/,
+    "markdown-parsers.js$1",
+  );
+  if (!chunkUrl || chunkUrl === widgetScriptSrc) {
+    return Promise.reject(
+      new Error(
+        "Could not derive the markdown-parsers.js URL from the widget script URL " +
+          `(${widgetScriptSrc ?? "unavailable"}). Self-hosted deployments that ` +
+          "rename index.global.js should host markdown-parsers.js alongside it.",
+      ),
+    );
+  }
+  return import(/* @vite-ignore */ chunkUrl);
+});
+
+// Kick off the load immediately since it will likely be needed.
+loadMarkdownParsers().catch(err => {
+  // It's okay if this fails (e.g. ad blocker), it'll just fall back to plain text.
+  if (typeof console !== "undefined") {
+    console.warn("[Persona] Failed to pre-load markdown parsers", err);
+  }
+});
+// ---------------------------------------------------------------------------
+// Deferred Runtype TTS engine loading.
+//
+// This bundle is built with `./runtype-speech-engine` external (see
+// `tsup.global.config.ts`): the hosted read-aloud engine + the
+// AudioPlaybackManager it bundles are kept out of the CDN payload. Register a
+// loader that imports the self-contained `runtype-tts.js` chunk from a sibling
+// URL; the session prefetches it at init when `textToSpeech.provider:'runtype'`
+// is set, so it's warm before the first click. Same pattern as the WebMCP
+// polyfill above.
+// ---------------------------------------------------------------------------
+
+import { setRuntypeTtsLoader } from "./voice/runtype-tts-loader";
+
+setRuntypeTtsLoader(() => {
+  const chunkUrl = widgetScriptSrc?.replace(
+    /index\.global\.js($|\?)/,
+    "runtype-tts.js$1",
+  );
+  if (!chunkUrl || chunkUrl === widgetScriptSrc) {
+    return Promise.reject(
+      new Error(
+        "Could not derive the runtype-tts.js URL from the widget script URL " +
+          `(${widgetScriptSrc ?? "unavailable"}). Self-hosted deployments that ` +
+          "rename index.global.js should host runtype-tts.js alongside it, or set " +
+          "textToSpeech.createEngine to supply a speech engine directly.",
+      ),
+    );
+  }
+  return import(/* @vite-ignore */ chunkUrl);
+});

package/src/index.ts

@@ -2,7 +2,7 @@
  * npm package entry (`@runtypelabs/persona`).
  *
  * This is a thin barrel over `index-core.ts` (the shared public API) that adds
- * back the **dev/config-tool-only** helpers — `generateCodeSnippet` and
+ * back the **dev/config-tool-only** helpers: `generateCodeSnippet` and
  * `createDemoCarousel`. Those are kept out of `index-core.ts` so the IIFE/CDN
  * build (`index-global.ts`, which re-exports from `index-core.ts`) doesn't ship
  * them: a running widget never needs them, only build-time/demo tooling does.
@@ -12,6 +12,12 @@
  * `createDemoCarousel`.
  */
 
+// Register `marked` + `dompurify` synchronously for the bundled npm build so
+// the synchronous markdown/sanitize API renders on first paint. The IIFE/CDN
+// entry (`index-global.ts`) does NOT import this; it lazy-loads the parsers
+// from the `markdown-parsers.js` chunk instead. Must run before any render.
+import "./markdown-parsers-eager";
+
 // Full public API (everything except the two dev-only helpers below).
 export * from "./index-core";
 export { default } from "./index-core";

package/src/install.test.ts

@@ -70,7 +70,7 @@ function provideLauncherBundle() {
 /**
  * Force the next dynamically-inserted <script> to error. jsdom never fires
  * load/error on injected scripts, so we trigger `onerror` on a fake timer that
- * `runAllTimersAsync()` flushes — deterministic under fake timers.
+ * `runAllTimersAsync()` flushes: deterministic under fake timers.
  */
 function failNextScriptLoad() {
   const head = document.head;
@@ -137,15 +137,15 @@ afterEach(() => {
   vi.restoreAllMocks();
 });
 
-describe("install.ts — onScriptLoad beacon", () => {
+describe("install.ts: onScriptLoad beacon", () => {
   it("fires synchronously on script execution, before any loading or gating", async () => {
     const events = recordEvents();
     const onScriptLoad = vi.fn();
 
-    // No config at all — the beacon must still fire (diagnostics: "did my embed run").
+    // No config at all: the beacon must still fire (diagnostics: "did my embed run").
     await install({ onScriptLoad });
 
-    // Fired during module evaluation — no timer flush needed.
+    // Fired during module evaluation: no timer flush needed.
     expect(onScriptLoad).toHaveBeenCalledTimes(1);
     expect(onScriptLoad).toHaveBeenCalledWith({ version: "latest" });
     expect(events.types()[0]).toBe("persona:script-load");
@@ -160,7 +160,7 @@ describe("install.ts — onScriptLoad beacon", () => {
   });
 });
 
-describe("install.ts — deferred launcher path", () => {
+describe("install.ts: deferred launcher path", () => {
   it("mounts the critical launcher, fires onLauncherShown, and defers onChatReady until open", async () => {
     markCssLoaded();
     provideFullBundle(); // so loadJS resolves instantly when the user opens
@@ -186,7 +186,7 @@ describe("install.ts — deferred launcher path", () => {
     expect(launcherMount).toHaveBeenCalledTimes(1);
     expect(onLauncherShown).toHaveBeenCalledTimes(1);
     expect(onLauncherShown).toHaveBeenCalledWith({ deferred: true, element: launcherElement });
-    // The full widget has NOT been initialized yet — that waits for first open.
+    // The full widget has NOT been initialized yet: that waits for first open.
     expect(initAgentWidget).not.toHaveBeenCalled();
     expect(onChatReady).not.toHaveBeenCalled();
 
@@ -230,7 +230,7 @@ describe("install.ts — deferred launcher path", () => {
   });
 });
 
-describe("install.ts — eager path", () => {
+describe("install.ts: eager path", () => {
   it("non-floating (launcher disabled) eager-loads, fires onChatReady, and does NOT fire onLauncherShown", async () => {
     markCssLoaded();
     provideFullBundle();
@@ -272,7 +272,7 @@ describe("install.ts — eager path", () => {
   });
 });
 
-describe("install.ts — deferral gate", () => {
+describe("install.ts: deferral gate", () => {
   async function expectDecision(config: any, { defers }: { defers: boolean }) {
     markCssLoaded();
     provideFullBundle();
@@ -345,7 +345,7 @@ describe("install.ts — deferral gate", () => {
   });
 });
 
-describe("install.ts — onReady deprecation alias", () => {
+describe("install.ts: onReady deprecation alias", () => {
   it("still calls the deprecated onReady and warns once", async () => {
     markCssLoaded();
     provideFullBundle();
@@ -376,7 +376,7 @@ describe("install.ts — onReady deprecation alias", () => {
   });
 });
 
-describe("install.ts — onError", () => {
+describe("install.ts: onError", () => {
   it("fires onError with phase 'init' and dispatches persona:error when initialization throws", async () => {
     markCssLoaded();
     provideFullBundle();
@@ -420,7 +420,7 @@ describe("install.ts — onError", () => {
   });
 });
 
-describe("install.ts — lifecycle callback safety", () => {
+describe("install.ts: lifecycle callback safety", () => {
   it("a throwing onScriptLoad callback does not break the rest of installation", async () => {
     markCssLoaded();
     provideFullBundle();