@wix/web5-core 1.56.0

package/dist/cjs/testUtils.js

@@ -0,0 +1,25 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.parseMarkdownToAst = parseMarkdownToAst;
+var _unified = require("unified");
+var _remarkParse = _interopRequireDefault(require("remark-parse"));
+var _remarkGfm = _interopRequireDefault(require("remark-gfm"));
+/**
+ * Test utility to parse markdown to AST
+ * This is used in tests to convert markdown strings to AST nodes
+ */
+function parseMarkdownToAst(markdown) {
+  const processor = (0, _unified.unified)().use(_remarkParse.default).use(_remarkGfm.default);
+  try {
+    return processor.parse(markdown);
+  } catch (error) {
+    console.error('Test markdown parse error:', error);
+    return {
+      type: 'root',
+      children: []
+    };
+  }
+}
+//# sourceMappingURL=testUtils.js.map

package/dist/cjs/testUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_unified","require","_remarkParse","_interopRequireDefault","_remarkGfm","parseMarkdownToAst","markdown","processor","unified","use","remarkParse","remarkGfm","parse","error","console","type","children"],"sources":["../../src/testUtils.ts"],"sourcesContent":["import { unified } from 'unified';\nimport remarkParse from 'remark-parse';\nimport remarkGfm from 'remark-gfm';\nimport type { Root } from 'mdast';\n\n/**\n * Test utility to parse markdown to AST\n * This is used in tests to convert markdown strings to AST nodes\n */\nexport function parseMarkdownToAst(markdown: string): Root {\n  const processor = unified().use(remarkParse).use(remarkGfm);\n  try {\n    return processor.parse(markdown) as Root;\n  } catch (error) {\n    console.error('Test markdown parse error:', error);\n    return { type: 'root', children: [] };\n  }\n}\n"],"mappings":";;;;;AAAA,IAAAA,QAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAC,sBAAA,CAAAF,OAAA;AACA,IAAAG,UAAA,GAAAD,sBAAA,CAAAF,OAAA;AAGA;AACA;AACA;AACA;AACO,SAASI,kBAAkBA,CAACC,QAAgB,EAAQ;EACzD,MAAMC,SAAS,GAAG,IAAAC,gBAAO,EAAC,CAAC,CAACC,GAAG,CAACC,oBAAW,CAAC,CAACD,GAAG,CAACE,kBAAS,CAAC;EAC3D,IAAI;IACF,OAAOJ,SAAS,CAACK,KAAK,CAACN,QAAQ,CAAC;EAClC,CAAC,CAAC,OAAOO,KAAK,EAAE;IACdC,OAAO,CAACD,KAAK,CAAC,4BAA4B,EAAEA,KAAK,CAAC;IAClD,OAAO;MAAEE,IAAI,EAAE,MAAM;MAAEC,QAAQ,EAAE;IAAG,CAAC;EACvC;AACF","ignoreList":[]}

package/dist/cjs/types/answerUpdatedEvent.js

@@ -0,0 +1,20 @@
+"use strict";
+
+exports.__esModule = true;
+exports.WEB5_ANSWER_UPDATED_EVENT = void 0;
+/**
+ * Cross-bundle `web5:answer-updated` broadcast event (B2B-4121).
+ *
+ * An inline answer placement (e.g. `pdpConversation`) dispatches this on
+ * `window` once it finishes rendering an answer — the conversation has
+ * advanced, so any contextual chip generator listening on the page should
+ * regenerate its suggestions against the new context.
+ *
+ * Like `web5:user-query`, this is a plain (non-cancelable) broadcast — any
+ * number of consumers may handle it; there is no "claim". The placement
+ * bundle (`embed-placement`) dispatches it and the input widget listens, so
+ * both import the name + payload from here to keep one source of truth.
+ */
+
+const WEB5_ANSWER_UPDATED_EVENT = exports.WEB5_ANSWER_UPDATED_EVENT = 'web5:answer-updated';
+//# sourceMappingURL=answerUpdatedEvent.js.map

package/dist/cjs/types/answerUpdatedEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WEB5_ANSWER_UPDATED_EVENT","exports"],"sources":["../../../src/types/answerUpdatedEvent.ts"],"sourcesContent":["/**\n * Cross-bundle `web5:answer-updated` broadcast event (B2B-4121).\n *\n * An inline answer placement (e.g. `pdpConversation`) dispatches this on\n * `window` once it finishes rendering an answer — the conversation has\n * advanced, so any contextual chip generator listening on the page should\n * regenerate its suggestions against the new context.\n *\n * Like `web5:user-query`, this is a plain (non-cancelable) broadcast — any\n * number of consumers may handle it; there is no \"claim\". The placement\n * bundle (`embed-placement`) dispatches it and the input widget listens, so\n * both import the name + payload from here to keep one source of truth.\n */\n\nexport const WEB5_ANSWER_UPDATED_EVENT = 'web5:answer-updated';\n\nexport interface Web5AnswerUpdatedEventDetail {\n  /**\n   * The conversation trigger id this answer advanced from, when known — the\n   * `web5_id` the answering turn ran under. Consumers can ignore it and read\n   * the current `web5_id` off the page URL instead.\n   */\n  web5Id?: string;\n}\n\nexport type Web5AnswerUpdatedEvent = CustomEvent<Web5AnswerUpdatedEventDetail>;\n\ndeclare global {\n  interface WindowEventMap {\n    [WEB5_ANSWER_UPDATED_EVENT]: Web5AnswerUpdatedEvent;\n  }\n}\n"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEO,MAAMA,yBAAyB,GAAAC,OAAA,CAAAD,yBAAA,GAAG,qBAAqB","ignoreList":[]}

package/dist/cjs/types/blog.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=blog.js.map

package/dist/cjs/types/blog.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/types/blog.ts"],"sourcesContent":["/**\n * Shared types for blog section components\n */\n\nexport interface BlogPost {\n  /** Unique identifier for the blog post */\n  id: string;\n  /** Post title (optional) */\n  title?: string;\n  /** Post description (required) */\n  description: string;\n  /** Post thumbnail image URL (required) */\n  imageUrl: string;\n  /** Optional action when post is clicked */\n  onClick?: string;\n  /** Publication date */\n  date?: string;\n  /** Post category */\n  category?: string;\n  /** Optional list items to display below the description */\n  listItems?: string[];\n}\n"],"mappings":"","ignoreList":[]}

package/dist/cjs/types/callout.js

@@ -0,0 +1,6 @@
+"use strict";
+
+exports.__esModule = true;
+exports.CALLOUT_KINDS = void 0;
+const CALLOUT_KINDS = exports.CALLOUT_KINDS = ['NOTE', 'TIP', 'IMPORTANT', 'WARNING', 'CAUTION', 'ECHO'];
+//# sourceMappingURL=callout.js.map

package/dist/cjs/types/callout.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CALLOUT_KINDS","exports"],"sources":["../../../src/types/callout.ts"],"sourcesContent":["export const CALLOUT_KINDS = [\n  'NOTE',\n  'TIP',\n  'IMPORTANT',\n  'WARNING',\n  'CAUTION',\n  'ECHO',\n] as const;\n\nexport type CalloutKind = (typeof CALLOUT_KINDS)[number];\n\nexport interface Callout {\n  text: string;\n  kind?: string;\n}\n"],"mappings":";;;;AAAO,MAAMA,aAAa,GAAAC,OAAA,CAAAD,aAAA,GAAG,CAC3B,MAAM,EACN,KAAK,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,MAAM,CACE","ignoreList":[]}

package/dist/cjs/types/dependencies.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=dependencies.js.map

package/dist/cjs/types/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/types/dependencies.ts"],"sourcesContent":["import type React from 'react';\nimport type { ApiPayloadItem, EntityTypeConfig } from './entity';\nimport type {\n  EntityItem,\n  EntityItemData,\n  SolutionEntityData,\n  BlogEntityData,\n} from '../component/types';\nimport type { RGB } from '../color/colorUtils';\nimport type { DiagnosticType } from '../component/diagnosticTypes';\nimport type { ImageSearchFilterString } from '../image/imageSearchFilterTypes';\nimport type { ContextualImageAsset } from '../image/contextualImageTypes';\n\n/**\n * Return type of useWeb5Link hook.\n */\nexport interface Web5LinkApi {\n  handleLinkClick: (\n    e: React.MouseEvent<HTMLAnchorElement | HTMLButtonElement>,\n    url: string | undefined,\n  ) => void;\n  sendWeb5Message: (url: string) => void;\n  navigateToUrl: (url: string) => void;\n  transformUrl: (url: string) => string | null;\n  resolveUrl: (url: string | undefined) => string | undefined;\n  isExternalUrl: (url: string) => boolean;\n  isActionRegistered: (name: string) => boolean;\n  executeAction: (\n    name: string,\n    params: Record<string, string>,\n  ) => Promise<void>;\n}\n\n/**\n * Optional tracking parameters for sendMessage.\n * When provided, analytics events are automatically dispatched.\n */\nexport interface SendMessageTrackingOptions {\n  /** Button/link text — fires web5_link_click with type 'web5' */\n  source?: string;\n  /** Prompt type — fires web5_prompt_submit instead of link_click */\n  promptType?: 'text' | 'chip';\n}\n\nexport interface ComparisonSubmitPayload {\n  intent: 'comparison';\n  entityIds: string[];\n  userPrompt?: string;\n  selectedItems?: ComparisonSelectedProduct[];\n}\n\nexport interface SendMessageOptions extends SendMessageTrackingOptions {\n  structuredPayload?: ComparisonSubmitPayload;\n}\n\n/**\n * Return type of useConversation hook.\n */\nexport interface ConversationApi {\n  sendMessage: (\n    message: string,\n    options?: SendMessageOptions,\n  ) => Promise<void>;\n  loadConversationByTriggerId: (triggerId: string) => Promise<void>;\n}\n\nexport interface ComparisonSelectedProduct {\n  entityId: string;\n  entityType: string;\n  title: string;\n  description?: string;\n  imageUrl?: string;\n  url?: string;\n  vendor?: string;\n  price?: string;\n  compareAtPrice?: string;\n  sizes?: string[];\n  variants?: EntityItemData['variants'];\n  options?: EntityItemData['options'];\n}\n\nexport interface ProductComparisonSelectionState {\n  sectionId: string | null;\n  entityIds: string[];\n  itemsById: Record<string, ComparisonSelectedProduct>;\n  maxSelectable: number;\n  submitting: boolean;\n}\n\nexport interface ProductComparisonApi {\n  state: ProductComparisonSelectionState;\n  maxSelectable: number;\n  enterComparisonMode: (input: {\n    sectionId: string;\n    maxSelectable?: number;\n  }) => void;\n  exitComparisonMode: (sectionId?: string) => void;\n  toggleComparisonProduct: (input: {\n    sectionId: string;\n    item: EntityItem;\n  }) => void;\n  removeComparisonProduct: (entityId: string) => void;\n  clearComparisonSelection: () => void;\n  setComparisonSubmitting: (submitting: boolean) => void;\n}\n\n/**\n * Entity transform functions provided by the host app.\n */\nexport interface EntityTransforms {\n  /** @deprecated Use transformToGenericEntityData */\n  transformToSolutionEntityData: (\n    payloadItem: ApiPayloadItem,\n    config: EntityTypeConfig,\n  ) => SolutionEntityData;\n  /** @deprecated Use transformToGenericEntityData */\n  transformToBlogPostEntityData: (\n    payloadItem: ApiPayloadItem,\n    config: EntityTypeConfig,\n  ) => BlogEntityData;\n  transformToGenericEntityData: (\n    payloadItem: ApiPayloadItem,\n    config: EntityTypeConfig,\n  ) => EntityItemData;\n}\n\n// SolutionEntityData, BlogEntityData, GenericEntityData are defined in component/types (single source of truth)\nexport type {\n  GenericEntityData,\n  SolutionEntityData,\n  BlogEntityData,\n} from '../component/types';\n\n/**\n * Markdown utility functions provided by the host app.\n */\nexport interface MarkdownUtils {\n  parseMarkdownToAst: (markdown: string) => any;\n  extractLinks: (ast: any) => { url: string; text: string }[];\n  extractText: (node: any) => string;\n}\n\n/**\n * Options for useResolveGenericEntityData hook.\n */\nexport interface ResolveGenericEntityDataOptions<TEntityData> {\n  transform: (raw: ApiPayloadItem, config: EntityTypeConfig) => TEntityData;\n}\n\n/**\n * Contract for all dependencies that section components need from the host app.\n * The host app provides implementations via React context.\n *\n * Each field is a hook function reference — components call them to get the actual values.\n */\nexport interface ComponentDependencies {\n  /** Hook returning Web5 link handling API */\n  useWeb5Link: () => Web5LinkApi;\n\n  /** Hook returning conversation API (sendMessage, loadConversationByTriggerId) */\n  useConversation: () => ConversationApi;\n\n  /** Hook returning product comparison selection API */\n  useProductComparison?: () => ProductComparisonApi;\n\n  /** Hook returning whether debug image mode is enabled */\n  useDebugImageContext: () => boolean;\n\n  /** Hook for resolving entity data (mixed entity types) */\n  useResolveGenericEntityData: <\n    TEntity extends {\n      entityId: string;\n      entityUrl: string;\n      entityType: string;\n      data?: TEntityData;\n    },\n    TEntityData,\n  >(\n    entities: TEntity[],\n    options: ResolveGenericEntityDataOptions<TEntityData>,\n  ) => { enrichedEntities: TEntity[]; loading: boolean };\n\n  /** Entity transform functions */\n  entityTransforms: EntityTransforms;\n\n  /** Markdown utility functions */\n  markdownUtils: MarkdownUtils;\n\n  /** Image resolver for contextual images (image:// protocol) */\n  resolveContextualImageUrl?: (\n    client: any,\n    imageKey: string,\n    options?: {\n      filter?: ImageSearchFilterString | null;\n    },\n  ) => Promise<string | null>;\n\n  /** Rich contextual image resolver used by self-resolving image components */\n  resolveContextualImageAsset?: (\n    client: any,\n    imageKey: string,\n    options?: {\n      filter?: ImageSearchFilterString | null;\n    },\n  ) => Promise<ContextualImageAsset | null>;\n\n  /** Batch resolver for contextual image searches used by collage-style UIs */\n  resolveContextualImageUrls?: (\n    client: any,\n    imageKey: string,\n    options?: {\n      count?: number;\n      threshold?: number;\n      filter?: ImageSearchFilterString | null;\n    },\n  ) => Promise<string[]>;\n\n  /** App store client accessor (for OptimizedImage) */\n  useAppClient?: () => any;\n\n  /** Hook returning a ref to the scroll container element (for parallax effects) */\n  useScrollContainerRef?: () => React.RefObject<HTMLElement | null>;\n\n  /** Bulk icon resolution: hints → SVG URL map */\n  resolveIcons?: (hints: string[]) => Promise<Record<string, string>>;\n\n  /** Set the page-level mesh gradient palette colors */\n  setMeshBackground?: (colors: RGB[]) => void;\n\n  /** Get the current mesh gradient palette colors */\n  getMeshBackground?: () => RGB[];\n\n  /** Report a markdown diagnostic at render time (e.g. broken link, filtered card) */\n  reportDiagnostic?: (\n    diagnosticType: DiagnosticType,\n    sectionType: string,\n    details: string,\n  ) => void;\n\n  /** BI logger for contextual image events (event 914) */\n  logContextualImage?: (params: {\n    imageUrl: string;\n    contextualTerm: string;\n    imageEventType: string;\n    isImageResolved: boolean;\n    isFallbackImage: boolean;\n  }) => void;\n\n  /** Conversation context for BI tracking */\n  useConversationContext?: () => {\n    conversationId?: string;\n    messageId?: string;\n    sessionId?: string;\n  };\n\n  /** Fallback image URLs used when a contextual image search returns no results */\n  fallbackImages?: string[];\n\n  /** Client-provided loader component (replaces default CSS spinner) */\n  LoaderComponent?: React.FC<{\n    className?: string;\n    size?: 'sm' | 'md' | 'lg';\n    message?: string;\n    showMessage?: boolean;\n  }>;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/cjs/types/entity.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=entity.js.map

package/dist/cjs/types/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/types/entity.ts"],"sourcesContent":["export interface ApiPayloadItem {\n  url: string;\n  features: { feature: string; value: string }[];\n  img?: string;\n  id: string;\n  title: string;\n  type: string;\n  update_ts?: string;\n  publishDate?: string;\n  published_at?: string;\n  cms_item_id?: string;\n  usage?: number;\n  author?: string;\n  authorName?: string;\n  description?: string;\n  excerpt?: string;\n  labels?: string[];\n  tags?: string[];\n  categories?: string[];\n}\n\nexport interface EntityTypeConfig {\n  payloadType: string;\n  urlMatchProperty: string;\n  urlMatchPattern?: 'endsWith' | 'contains' | 'equals';\n  imageBaseUrl?: string;\n}\n\nexport interface EntityConfig {\n  enabled: boolean;\n  entityTypes: Record<string, EntityTypeConfig>;\n}\n\nexport interface EntityExtractionContext {\n  payload?: ApiPayloadItem[];\n  entityConfig?: EntityConfig;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/cjs/types/link-types.js

@@ -0,0 +1,62 @@
+"use strict";
+
+exports.__esModule = true;
+exports.Web5UrlType = void 0;
+exports.isLegacyUrl = isLegacyUrl;
+exports.isNavigableUrl = isNavigableUrl;
+exports.isValidLinkUrl = isValidLinkUrl;
+exports.isWeb5ActionUrl = isWeb5ActionUrl;
+exports.isWeb5AskUrl = isWeb5AskUrl;
+exports.isWeb5EntityUrl = isWeb5EntityUrl;
+exports.isWeb5IconUrl = isWeb5IconUrl;
+exports.isWeb5ImageUrl = isWeb5ImageUrl;
+exports.isWeb5SearchUrl = isWeb5SearchUrl;
+exports.isWeb5Url = isWeb5Url;
+// ── Web5 URL type enum ──────────────────────────────────
+let Web5UrlType = exports.Web5UrlType = /*#__PURE__*/function (Web5UrlType) {
+  Web5UrlType["ASK"] = "ask";
+  Web5UrlType["ENTITY"] = "entity";
+  Web5UrlType["IMAGE"] = "image";
+  Web5UrlType["ICON"] = "icon";
+  Web5UrlType["ACTION"] = "action";
+  Web5UrlType["SEARCH"] = "search";
+  return Web5UrlType;
+}({}); // ── Template literal types ──────────────────────────────
+// ── Type guards ─────────────────────────────────────────
+
+function isWeb5AskUrl(url) {
+  return url.startsWith('web5://ask/');
+}
+function isWeb5EntityUrl(url) {
+  return url.startsWith('web5://entity/');
+}
+function isWeb5ImageUrl(url) {
+  return url.startsWith('web5://image/');
+}
+function isWeb5IconUrl(url) {
+  return url.startsWith('web5://icon/');
+}
+function isWeb5ActionUrl(url) {
+  return url.startsWith('web5://action/');
+}
+function isWeb5SearchUrl(url) {
+  return url.startsWith('web5://search/');
+}
+function isWeb5Url(url) {
+  if (!url.startsWith('web5://')) {
+    return false;
+  }
+  const path = url.slice('web5://'.length);
+  return Object.values(Web5UrlType).some(prefix => path === prefix || path.startsWith(prefix + '/'));
+}
+function isNavigableUrl(url) {
+  return url.startsWith('https://') || url.startsWith('http://') || url.startsWith('mailto:') || url.startsWith('/');
+}
+function isValidLinkUrl(url) {
+  return isWeb5Url(url) || isNavigableUrl(url);
+}
+const LEGACY_PREFIXES = ['entity://', 'image://', 'action://', 'ask://'];
+function isLegacyUrl(url) {
+  return LEGACY_PREFIXES.some(p => url.startsWith(p));
+}
+//# sourceMappingURL=link-types.js.map

package/dist/cjs/types/link-types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Web5UrlType","exports","isWeb5AskUrl","url","startsWith","isWeb5EntityUrl","isWeb5ImageUrl","isWeb5IconUrl","isWeb5ActionUrl","isWeb5SearchUrl","isWeb5Url","path","slice","length","Object","values","some","prefix","isNavigableUrl","isValidLinkUrl","LEGACY_PREFIXES","isLegacyUrl","p"],"sources":["../../../src/types/link-types.ts"],"sourcesContent":["// ── Web5 URL type enum ──────────────────────────────────\n\nexport enum Web5UrlType {\n  ASK = 'ask',\n  ENTITY = 'entity',\n  IMAGE = 'image',\n  ICON = 'icon',\n  ACTION = 'action',\n  SEARCH = 'search',\n}\n\n// ── Template literal types ──────────────────────────────\n\nexport type Web5AskUrl = `web5://ask/${string}`;\nexport type Web5EntityUrl = `web5://entity/${string}`;\nexport type Web5ImageUrl = `web5://image/${string}`;\nexport type Web5IconUrl = `web5://icon/${string}`;\nexport type Web5ActionUrl = `web5://action/${string}`;\nexport type Web5SearchUrl = `web5://search/${string}`;\nexport type Web5Url =\n  | Web5AskUrl\n  | Web5EntityUrl\n  | Web5ImageUrl\n  | Web5IconUrl\n  | Web5ActionUrl\n  | Web5SearchUrl;\n\nexport type HttpsUrl = `https://${string}`;\nexport type HttpUrl = `http://${string}`;\nexport type MailtoUrl = `mailto:${string}`;\nexport type RelativeUrl = `/${string}`;\nexport type NavigableUrl = HttpsUrl | HttpUrl | MailtoUrl | RelativeUrl;\n\nexport type LegacyEntityUrl = `entity://${string}`;\nexport type LegacyImageUrl = `image://${string}`;\nexport type LegacyActionUrl = `action://${string}`;\nexport type LegacyAskUrl = `ask://${string}`;\nexport type LegacyUrl =\n  | LegacyEntityUrl\n  | LegacyImageUrl\n  | LegacyActionUrl\n  | LegacyAskUrl;\n\nexport type ValidLinkUrl = Web5Url | NavigableUrl;\nexport type AnyKnownUrl = ValidLinkUrl | LegacyUrl;\n\n// ── Type guards ─────────────────────────────────────────\n\nexport function isWeb5AskUrl(url: string): url is Web5AskUrl {\n  return url.startsWith('web5://ask/');\n}\n\nexport function isWeb5EntityUrl(url: string): url is Web5EntityUrl {\n  return url.startsWith('web5://entity/');\n}\n\nexport function isWeb5ImageUrl(url: string): url is Web5ImageUrl {\n  return url.startsWith('web5://image/');\n}\n\nexport function isWeb5IconUrl(url: string): url is Web5IconUrl {\n  return url.startsWith('web5://icon/');\n}\n\nexport function isWeb5ActionUrl(url: string): url is Web5ActionUrl {\n  return url.startsWith('web5://action/');\n}\n\nexport function isWeb5SearchUrl(url: string): url is Web5SearchUrl {\n  return url.startsWith('web5://search/');\n}\n\nexport function isWeb5Url(url: string): url is Web5Url {\n  if (!url.startsWith('web5://')) {\n    return false;\n  }\n  const path = url.slice('web5://'.length);\n  return Object.values(Web5UrlType).some(\n    (prefix) => path === prefix || path.startsWith(prefix + '/'),\n  );\n}\n\nexport function isNavigableUrl(url: string): url is NavigableUrl {\n  return (\n    url.startsWith('https://') ||\n    url.startsWith('http://') ||\n    url.startsWith('mailto:') ||\n    url.startsWith('/')\n  );\n}\n\nexport function isValidLinkUrl(url: string): url is ValidLinkUrl {\n  return isWeb5Url(url) || isNavigableUrl(url);\n}\n\nconst LEGACY_PREFIXES = ['entity://', 'image://', 'action://', 'ask://'];\n\nexport function isLegacyUrl(url: string): url is LegacyUrl {\n  return LEGACY_PREFIXES.some((p) => url.startsWith(p));\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA,IAEYA,WAAW,GAAAC,OAAA,CAAAD,WAAA,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA,OASvB;AAmCA;;AAEO,SAASE,YAAYA,CAACC,GAAW,EAAqB;EAC3D,OAAOA,GAAG,CAACC,UAAU,CAAC,aAAa,CAAC;AACtC;AAEO,SAASC,eAAeA,CAACF,GAAW,EAAwB;EACjE,OAAOA,GAAG,CAACC,UAAU,CAAC,gBAAgB,CAAC;AACzC;AAEO,SAASE,cAAcA,CAACH,GAAW,EAAuB;EAC/D,OAAOA,GAAG,CAACC,UAAU,CAAC,eAAe,CAAC;AACxC;AAEO,SAASG,aAAaA,CAACJ,GAAW,EAAsB;EAC7D,OAAOA,GAAG,CAACC,UAAU,CAAC,cAAc,CAAC;AACvC;AAEO,SAASI,eAAeA,CAACL,GAAW,EAAwB;EACjE,OAAOA,GAAG,CAACC,UAAU,CAAC,gBAAgB,CAAC;AACzC;AAEO,SAASK,eAAeA,CAACN,GAAW,EAAwB;EACjE,OAAOA,GAAG,CAACC,UAAU,CAAC,gBAAgB,CAAC;AACzC;AAEO,SAASM,SAASA,CAACP,GAAW,EAAkB;EACrD,IAAI,CAACA,GAAG,CAACC,UAAU,CAAC,SAAS,CAAC,EAAE;IAC9B,OAAO,KAAK;EACd;EACA,MAAMO,IAAI,GAAGR,GAAG,CAACS,KAAK,CAAC,SAAS,CAACC,MAAM,CAAC;EACxC,OAAOC,MAAM,CAACC,MAAM,CAACf,WAAW,CAAC,CAACgB,IAAI,CACnCC,MAAM,IAAKN,IAAI,KAAKM,MAAM,IAAIN,IAAI,CAACP,UAAU,CAACa,MAAM,GAAG,GAAG,CAC7D,CAAC;AACH;AAEO,SAASC,cAAcA,CAACf,GAAW,EAAuB;EAC/D,OACEA,GAAG,CAACC,UAAU,CAAC,UAAU,CAAC,IAC1BD,GAAG,CAACC,UAAU,CAAC,SAAS,CAAC,IACzBD,GAAG,CAACC,UAAU,CAAC,SAAS,CAAC,IACzBD,GAAG,CAACC,UAAU,CAAC,GAAG,CAAC;AAEvB;AAEO,SAASe,cAAcA,CAAChB,GAAW,EAAuB;EAC/D,OAAOO,SAAS,CAACP,GAAG,CAAC,IAAIe,cAAc,CAACf,GAAG,CAAC;AAC9C;AAEA,MAAMiB,eAAe,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC;AAEjE,SAASC,WAAWA,CAAClB,GAAW,EAAoB;EACzD,OAAOiB,eAAe,CAACJ,IAAI,CAAEM,CAAC,IAAKnB,GAAG,CAACC,UAAU,CAACkB,CAAC,CAAC,CAAC;AACvD","ignoreList":[]}

package/dist/cjs/types/page-section.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=page-section.js.map

package/dist/cjs/types/page-section.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/types/page-section.ts"],"sourcesContent":["/**\n * `PageSection` — the data shape returned by `parseMarkdownToComponents`\n * (DL #088 B9.3). Lifted from `web50-server-ui/src/store/appStore.ts` so the\n * placement bundle and the full app can both consume it.\n */\nimport type { ReactElement } from 'react';\n\nexport interface PageSection {\n  id: string;\n  sectionType: string;\n  componentName?: string;\n  semantic?: string;\n  componentOptions?: Record<string, any>;\n  sourceMarkdown: string;\n  component: ReactElement | null;\n  /**\n   * V3 prompt federation (DL #106): a declared-but-not-yet-streamed section.\n   * The render layer resolves the skeleton component (client\n   * `uiSlots.SectionSkeletonComponent` override, else the core `SectionSkeleton`\n   * default) from `sectionType`/`semantic` — `component` stays null.\n   */\n  isSkeleton?: boolean;\n  error?: string;\n  warning?: string;\n  /** Only present for debug introspection — never for production rendering. */\n  debugProps?: any;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/cjs/types/placement.js

@@ -0,0 +1,4 @@
+"use strict";
+
+exports.__esModule = true;
+//# sourceMappingURL=placement.js.map

package/dist/cjs/types/placement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/types/placement.ts"],"sourcesContent":["/**\n * Placement configuration types (DL #088 D4, D15, DL #102).\n *\n * The placement bundle reads these from `ClientConfig.placementPrompts`,\n * keyed by **placement kind** — the value of `data-web5-placement=\"X\"` on\n * the slot DOM. Example: `<div data-web5-placement=\"pdpFraming\">` resolves\n * to `placementPrompts.pdpFraming`.\n *\n * An entry describes the placement's *behavior* (DL #102 — `conversational`,\n * `requiresWeb5Id`) and optionally its *content* (`prompt` XOR `markdown`,\n * DL #100). Behavior-only entries are valid: after DL #101 moves prompts to\n * the BE, a kind like `pdpFraming` keeps `{ requiresWeb5Id: true }` alone.\n */\n\n/**\n * Placement visual variant → `w5-placement--<variant>` CSS class (DL #106 D1).\n *\n * Free-form by design: core ships `informational` / `conversation` styles by\n * default (the two placement treatments — non-conversational vs conversational),\n * but a client may use any token and supply matching CSS via its UMD — no core\n * change is needed to add a new look. Kept open to match the open-ended\n * `PlacementPrompts` keys: design is as client-extensible as behavior.\n */\nexport type PlacementVariant = string;\n\n/**\n * Behavior declarations for a placement kind (DL #102).\n */\nexport interface PlacementBehaviorConfig {\n  /**\n   * Conversation placement (DL #102 D1): activated by `web5:user-query`\n   * events instead of fetching on mount. Replaces the hardcoded kind-name →\n   * activation map in embed-placement's `main.ts`. As of the DL #102\n   * amendment (2026-06-21) this no longer implies the warm guard — a\n   * conversational surface can activate on a cold page; set `requiresWeb5Id`\n   * to gate it.\n   */\n  conversational?: boolean;\n  /**\n   * Warm guard (DL #102 D2, amended): when true, the slot stays hidden and\n   * inert — no fetch, no render — unless the page URL carries `?web5_id=`.\n   * This is the sole driver of the guard; it is independent of\n   * `conversational` (e.g. `pdpFraming` sets it true, `pdpConversation`\n   * leaves it unset).\n   */\n  requiresWeb5Id?: boolean;\n  /**\n   * Visual variant → `w5-placement--<variant>` CSS class (DL #106 D2). When\n   * unset the host derives it from activation (`conversational` →\n   * `'conversation'`, else `'informational'`) so existing kinds are unchanged.\n   */\n  variant?: PlacementVariant;\n  /**\n   * Eyebrow label shown with the accent star above the answer (DL #106 D2).\n   * Defaults to `'FormAI'` when unset; an empty string hides the eyebrow.\n   */\n  eyebrow?: string;\n}\n\n/**\n * A placement kind driven by an LLM prompt. The BE composes `prompt` with the\n * entity context + user question (if any) into the final `/conversation` call.\n * Also passable inline via `additionalInfo.promptOverride` for one-off\n * experiments.\n */\nexport interface PlacementPromptConfig {\n  prompt: string;\n  /** Mutually exclusive with `prompt` — set one, never both. */\n  markdown?: never;\n}\n\n/**\n * A placement kind with pre-authored, hardcoded markdown. When set, the\n * placement renders this markdown immediately on mount with no `/conversation`\n * fetch. Honored for auto-mode kinds (e.g. `pdpFraming`) only.\n */\nexport interface PlacementMarkdownConfig {\n  markdown: string;\n  /** Mutually exclusive with `markdown` — set one, never both. */\n  prompt?: never;\n}\n\n/**\n * Single placement kind's configuration — behavior declarations plus, at\n * most, one content source (prompt-driven XOR static markdown). The\n * behavior-only arm carries neither (DL #102 Q5). Planned extensions per\n * DL #088 D4 + D8: `allowedComponents`, `excludedComponents`,\n * `maxComponents`, `fallback`.\n */\nexport type PlacementConfig =\n  | (PlacementBehaviorConfig & PlacementPromptConfig)\n  | (PlacementBehaviorConfig & PlacementMarkdownConfig)\n  | (PlacementBehaviorConfig & { prompt?: never; markdown?: never });\n\n/**\n * Map of placement kind → `PlacementConfig`. Keyed by the `data-web5-placement`\n * attribute value on the slot DOM.\n */\nexport type PlacementPrompts = Record<string, PlacementConfig>;\n"],"mappings":"","ignoreList":[]}

package/dist/cjs/types/redirectEvent.js

@@ -0,0 +1,27 @@
+"use strict";
+
+exports.__esModule = true;
+exports.WEB5_REDIRECT_EVENT = void 0;
+/**
+ * Cross-bundle `web5:redirect` broadcast event (DL #098).
+ *
+ * Any widget bundle that wants to bail out of its in-page surface and hand
+ * the visitor's question off to the full Web5 app dispatches this on `window`.
+ * The Unified Loader (embed-loader) is the consumer: it reads
+ * `searchRedirectUrl` from the event detail and navigates to
+ * `<searchRedirectUrl>?initialQuestion=<query>`. Mirrors the publisher /
+ * consumer shape of `web5:user-query` (DL #097 D2), just inverted — a widget
+ * signals intent, the loader performs the navigation.
+ *
+ * The publisher supplies the destination URL (read from its own client UMD's
+ * `clientConfig.linkConfig.searchRedirectUrl`) so the loader stays client-
+ * agnostic and the inline-bail and input-submit destinations are guaranteed
+ * to match.
+ *
+ * Today only `pdpConversation` dispatches it (when the LLM emits
+ * `<!-- redirect:context-changed -->` in the stream — DL #098 D1/D2),
+ * but the event is a general primitive and any future widget can use it.
+ */
+
+const WEB5_REDIRECT_EVENT = exports.WEB5_REDIRECT_EVENT = 'web5:redirect';
+//# sourceMappingURL=redirectEvent.js.map

package/dist/cjs/types/redirectEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WEB5_REDIRECT_EVENT","exports"],"sources":["../../../src/types/redirectEvent.ts"],"sourcesContent":["/**\n * Cross-bundle `web5:redirect` broadcast event (DL #098).\n *\n * Any widget bundle that wants to bail out of its in-page surface and hand\n * the visitor's question off to the full Web5 app dispatches this on `window`.\n * The Unified Loader (embed-loader) is the consumer: it reads\n * `searchRedirectUrl` from the event detail and navigates to\n * `<searchRedirectUrl>?initialQuestion=<query>`. Mirrors the publisher /\n * consumer shape of `web5:user-query` (DL #097 D2), just inverted — a widget\n * signals intent, the loader performs the navigation.\n *\n * The publisher supplies the destination URL (read from its own client UMD's\n * `clientConfig.linkConfig.searchRedirectUrl`) so the loader stays client-\n * agnostic and the inline-bail and input-submit destinations are guaranteed\n * to match.\n *\n * Today only `pdpConversation` dispatches it (when the LLM emits\n * `<!-- redirect:context-changed -->` in the stream — DL #098 D1/D2),\n * but the event is a general primitive and any future widget can use it.\n */\n\nexport const WEB5_REDIRECT_EVENT = 'web5:redirect';\n\nexport type Web5RedirectReason = 'context-changed';\n\nexport interface Web5RedirectEventDetail {\n  /** The original visitor query to forward as `?initialQuestion=`. */\n  query: string;\n  /**\n   * Destination URL to navigate to (e.g. `/pages/ai`). The publisher reads\n   * it from the loaded client UMD's `clientConfig.linkConfig.searchRedirectUrl`\n   * — the same value the `user-query` input widget already uses for its\n   * non-product submits, so both paths land on the same page.\n   */\n  searchRedirectUrl: string;\n  /** Coarse reason — extensible. Today: only `'context-changed'`. */\n  reason: Web5RedirectReason;\n}\n\nexport type Web5RedirectEvent = CustomEvent<Web5RedirectEventDetail>;\n\ndeclare global {\n  interface WindowEventMap {\n    [WEB5_REDIRECT_EVENT]: Web5RedirectEvent;\n  }\n}\n"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEO,MAAMA,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,GAAG,eAAe","ignoreList":[]}

package/dist/cjs/types/userQueryEvent.js

@@ -0,0 +1,19 @@
+"use strict";
+
+exports.__esModule = true;
+exports.WEB5_USER_QUERY_EVENT = void 0;
+/**
+ * Cross-bundle `web5:user-query` broadcast event (DL #097 D2).
+ *
+ * The `user-query` input widget dispatches this on `window` when configured
+ * `submitTarget: 'event'`; one or more placement bundles listen and render the
+ * answer inline. It is a plain (non-cancelable) broadcast — any number of
+ * consumers may handle it; there is no "claim".
+ *
+ * Both the input bundle (`@wix/w5-client-*`) and the placement bundle
+ * (`embed-placement`) import the name + payload from here so the contract has a
+ * single source of truth.
+ */
+
+const WEB5_USER_QUERY_EVENT = exports.WEB5_USER_QUERY_EVENT = 'web5:user-query';
+//# sourceMappingURL=userQueryEvent.js.map

package/dist/cjs/types/userQueryEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WEB5_USER_QUERY_EVENT","exports"],"sources":["../../../src/types/userQueryEvent.ts"],"sourcesContent":["/**\n * Cross-bundle `web5:user-query` broadcast event (DL #097 D2).\n *\n * The `user-query` input widget dispatches this on `window` when configured\n * `submitTarget: 'event'`; one or more placement bundles listen and render the\n * answer inline. It is a plain (non-cancelable) broadcast — any number of\n * consumers may handle it; there is no \"claim\".\n *\n * Both the input bundle (`@wix/w5-client-*`) and the placement bundle\n * (`embed-placement`) import the name + payload from here so the contract has a\n * single source of truth.\n */\n\nexport const WEB5_USER_QUERY_EVENT = 'web5:user-query';\n\nexport interface Web5UserQueryEventDetail {\n  /** The text the visitor submitted in the user-query input. */\n  query: string;\n}\n\nexport type Web5UserQueryEvent = CustomEvent<Web5UserQueryEventDetail>;\n\ndeclare global {\n  interface WindowEventMap {\n    [WEB5_USER_QUERY_EVENT]: Web5UserQueryEvent;\n  }\n}\n"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEO,MAAMA,qBAAqB,GAAAC,OAAA,CAAAD,qBAAA,GAAG,iBAAiB","ignoreList":[]}

package/dist/cjs/utils/analyticsEvents.js

@@ -0,0 +1,91 @@
+"use strict";
+
+exports.__esModule = true;
+exports.hasAnalyticsConsent = hasAnalyticsConsent;
+exports.pushEntityFiltered = pushEntityFiltered;
+exports.pushError = pushError;
+exports.pushEvent = pushEvent;
+exports.pushExit = pushExit;
+exports.pushLinkClick = pushLinkClick;
+exports.pushPromptSubmit = pushPromptSubmit;
+const ANALYTICS_CATEGORY = 'C0002';
+function hasAnalyticsConsent() {
+  if (typeof window === 'undefined') {
+    return false;
+  }
+  const groups = window.OnetrustActiveGroups;
+  if (typeof groups === 'string') {
+    return groups.includes(ANALYTICS_CATEGORY);
+  }
+
+  // No OneTrust on page — allow tracking (host is responsible for loading OneTrust)
+  return true;
+}
+
+/**
+ * Universal event dispatch: auto-detects GTM vs standalone gtag.js.
+ *
+ * GTM is checked first via `google_tag_manager` because when GTM has a GA4
+ * tag configured it also creates `window.gtag`. Using dataLayer.push()
+ * ensures GTM triggers/tags still process the event.
+ */
+function pushEvent(eventName, params = {}) {
+  if (typeof window === 'undefined') {
+    return;
+  }
+  if (!hasAnalyticsConsent()) {
+    return;
+  }
+
+  // GTM mode
+  if (window.google_tag_manager && window.dataLayer) {
+    window.dataLayer.push({
+      event: eventName,
+      ...params
+    });
+    return;
+  }
+
+  // Standalone gtag.js mode
+  if (typeof window.gtag === 'function') {
+    window.gtag('event', eventName, params);
+    return;
+  }
+
+  // No analytics SDK loaded — no-op
+}
+function pushPromptSubmit(promptType, promptText) {
+  pushEvent('web5_prompt_submit', {
+    prompt_type: promptType,
+    prompt_text: promptText
+  });
+}
+function pushLinkClick(linkUrl, linkType, linkText) {
+  pushEvent('web5_link_click', {
+    link_url: linkUrl,
+    link_type: linkType,
+    link_text: linkText ?? ''
+  });
+}
+function pushError(errorType, statusCode, errorMessage) {
+  pushEvent('web5_error', {
+    error_type: errorType,
+    status_code: statusCode,
+    error_message: errorMessage ?? ''
+  });
+}
+function pushExit(exitUrl, linkText, exitType) {
+  pushEvent('web5_exit', {
+    exit_url: exitUrl,
+    link_text: linkText,
+    exit_type: exitType
+  });
+}
+function pushEntityFiltered(reason, entityType, entityId) {
+  pushEvent('web5_entity_filtered', {
+    reason,
+    entity_type: entityType,
+    entity_id: entityId
+  });
+}
+//# sourceMappingURL=analyticsEvents.js.map

package/dist/cjs/utils/analyticsEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ANALYTICS_CATEGORY","hasAnalyticsConsent","window","groups","OnetrustActiveGroups","includes","pushEvent","eventName","params","google_tag_manager","dataLayer","push","event","gtag","pushPromptSubmit","promptType","promptText","prompt_type","prompt_text","pushLinkClick","linkUrl","linkType","linkText","link_url","link_type","link_text","pushError","errorType","statusCode","errorMessage","error_type","status_code","error_message","pushExit","exitUrl","exitType","exit_url","exit_type","pushEntityFiltered","reason","entityType","entityId","entity_type","entity_id"],"sources":["../../../src/utils/analyticsEvents.ts"],"sourcesContent":["declare global {\n  interface Window {\n    dataLayer?: Record<string, unknown>[];\n    gtag?: (...args: unknown[]) => void;\n    google_tag_manager?: Record<string, unknown>;\n    OnetrustActiveGroups?: string;\n  }\n}\n\nconst ANALYTICS_CATEGORY = 'C0002';\n\nexport function hasAnalyticsConsent(): boolean {\n  if (typeof window === 'undefined') {\n    return false;\n  }\n\n  const groups = window.OnetrustActiveGroups;\n  if (typeof groups === 'string') {\n    return groups.includes(ANALYTICS_CATEGORY);\n  }\n\n  // No OneTrust on page — allow tracking (host is responsible for loading OneTrust)\n  return true;\n}\n\n/**\n * Universal event dispatch: auto-detects GTM vs standalone gtag.js.\n *\n * GTM is checked first via `google_tag_manager` because when GTM has a GA4\n * tag configured it also creates `window.gtag`. Using dataLayer.push()\n * ensures GTM triggers/tags still process the event.\n */\nexport function pushEvent(\n  eventName: string,\n  params: Record<string, unknown> = {},\n): void {\n  if (typeof window === 'undefined') {\n    return;\n  }\n  if (!hasAnalyticsConsent()) {\n    return;\n  }\n\n  // GTM mode\n  if (window.google_tag_manager && window.dataLayer) {\n    window.dataLayer.push({ event: eventName, ...params });\n    return;\n  }\n\n  // Standalone gtag.js mode\n  if (typeof window.gtag === 'function') {\n    window.gtag('event', eventName, params);\n    return;\n  }\n\n  // No analytics SDK loaded — no-op\n}\n\nexport function pushPromptSubmit(\n  promptType: 'text' | 'chip',\n  promptText: string,\n): void {\n  pushEvent('web5_prompt_submit', {\n    prompt_type: promptType,\n    prompt_text: promptText,\n  });\n}\n\nexport function pushLinkClick(\n  linkUrl: string,\n  linkType: 'web5' | 'external' | 'internal',\n  linkText?: string,\n): void {\n  pushEvent('web5_link_click', {\n    link_url: linkUrl,\n    link_type: linkType,\n    link_text: linkText ?? '',\n  });\n}\n\nexport function pushError(\n  errorType: string,\n  statusCode: number,\n  errorMessage?: string,\n): void {\n  pushEvent('web5_error', {\n    error_type: errorType,\n    status_code: statusCode,\n    error_message: errorMessage ?? '',\n  });\n}\n\nexport function pushExit(\n  exitUrl: string,\n  linkText: string,\n  exitType: 'external' | 'internal',\n): void {\n  pushEvent('web5_exit', {\n    exit_url: exitUrl,\n    link_text: linkText,\n    exit_type: exitType,\n  });\n}\n\nexport type EntityFilteredReason = 'no_data' | 'no_url';\n\nexport function pushEntityFiltered(\n  reason: EntityFilteredReason,\n  entityType: string,\n  entityId: string,\n): void {\n  pushEvent('web5_entity_filtered', {\n    reason,\n    entity_type: entityType,\n    entity_id: entityId,\n  });\n}\n"],"mappings":";;;;;;;;;;AASA,MAAMA,kBAAkB,GAAG,OAAO;AAE3B,SAASC,mBAAmBA,CAAA,EAAY;EAC7C,IAAI,OAAOC,MAAM,KAAK,WAAW,EAAE;IACjC,OAAO,KAAK;EACd;EAEA,MAAMC,MAAM,GAAGD,MAAM,CAACE,oBAAoB;EAC1C,IAAI,OAAOD,MAAM,KAAK,QAAQ,EAAE;IAC9B,OAAOA,MAAM,CAACE,QAAQ,CAACL,kBAAkB,CAAC;EAC5C;;EAEA;EACA,OAAO,IAAI;AACb;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASM,SAASA,CACvBC,SAAiB,EACjBC,MAA+B,GAAG,CAAC,CAAC,EAC9B;EACN,IAAI,OAAON,MAAM,KAAK,WAAW,EAAE;IACjC;EACF;EACA,IAAI,CAACD,mBAAmB,CAAC,CAAC,EAAE;IAC1B;EACF;;EAEA;EACA,IAAIC,MAAM,CAACO,kBAAkB,IAAIP,MAAM,CAACQ,SAAS,EAAE;IACjDR,MAAM,CAACQ,SAAS,CAACC,IAAI,CAAC;MAAEC,KAAK,EAAEL,SAAS;MAAE,GAAGC;IAAO,CAAC,CAAC;IACtD;EACF;;EAEA;EACA,IAAI,OAAON,MAAM,CAACW,IAAI,KAAK,UAAU,EAAE;IACrCX,MAAM,CAACW,IAAI,CAAC,OAAO,EAAEN,SAAS,EAAEC,MAAM,CAAC;IACvC;EACF;;EAEA;AACF;AAEO,SAASM,gBAAgBA,CAC9BC,UAA2B,EAC3BC,UAAkB,EACZ;EACNV,SAAS,CAAC,oBAAoB,EAAE;IAC9BW,WAAW,EAAEF,UAAU;IACvBG,WAAW,EAAEF;EACf,CAAC,CAAC;AACJ;AAEO,SAASG,aAAaA,CAC3BC,OAAe,EACfC,QAA0C,EAC1CC,QAAiB,EACX;EACNhB,SAAS,CAAC,iBAAiB,EAAE;IAC3BiB,QAAQ,EAAEH,OAAO;IACjBI,SAAS,EAAEH,QAAQ;IACnBI,SAAS,EAAEH,QAAQ,IAAI;EACzB,CAAC,CAAC;AACJ;AAEO,SAASI,SAASA,CACvBC,SAAiB,EACjBC,UAAkB,EAClBC,YAAqB,EACf;EACNvB,SAAS,CAAC,YAAY,EAAE;IACtBwB,UAAU,EAAEH,SAAS;IACrBI,WAAW,EAAEH,UAAU;IACvBI,aAAa,EAAEH,YAAY,IAAI;EACjC,CAAC,CAAC;AACJ;AAEO,SAASI,QAAQA,CACtBC,OAAe,EACfZ,QAAgB,EAChBa,QAAiC,EAC3B;EACN7B,SAAS,CAAC,WAAW,EAAE;IACrB8B,QAAQ,EAAEF,OAAO;IACjBT,SAAS,EAAEH,QAAQ;IACnBe,SAAS,EAAEF;EACb,CAAC,CAAC;AACJ;AAIO,SAASG,kBAAkBA,CAChCC,MAA4B,EAC5BC,UAAkB,EAClBC,QAAgB,EACV;EACNnC,SAAS,CAAC,sBAAsB,EAAE;IAChCiC,MAAM;IACNG,WAAW,EAAEF,UAAU;IACvBG,SAAS,EAAEF;EACb,CAAC,CAAC;AACJ","ignoreList":[]}

package/dist/cjs/utils/componentTracking.js

@@ -0,0 +1,90 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.ComponentTracking = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+/**
+ * Tracks which components handle which ranges of nodes during markdown parsing.
+ * This allows you to see which components handled which node ranges and how many times each component appears.
+ *
+ * @example
+ * ```typescript
+ * const sections = parseMarkdownToComponents(markdown);
+ * const tracking = getLastComponentTracking();
+ *
+ * // Get how many times a component appears
+ * const heroCount = tracking?.getComponentCount('HeroSection'); // e.g., 1
+ *
+ * // Get all ranges for a specific component
+ * const heroRanges = tracking?.getRangesForComponent('HeroSection');
+ * // Returns: [{ componentName: 'HeroSection', startIndex: 0, endIndex: 2, sectionIndex: 0 }]
+ *
+ * // Check if a node is already handled
+ * const isHandled = tracking?.isNodeHandled(5); // true/false
+ *
+ * // Get which component handles a specific node
+ * const handler = tracking?.getComponentForNode(5);
+ * // Returns: ComponentNodeRange | null
+ *
+ * // Get a summary of all components
+ * const summary = tracking?.getSummary();
+ * // Returns: [{ componentName: 'HeroSection', count: 1, ranges: [...] }, ...]
+ * ```
+ */
+class ComponentTracking {
+  constructor() {
+    (0, _defineProperty2.default)(this, "ranges", []);
+    (0, _defineProperty2.default)(this, "componentCounts", new Map());
+    (0, _defineProperty2.default)(this, "usedImageKeywords", new Set());
+    (0, _defineProperty2.default)(this, "metadata", new Map());
+  }
+  addRange(componentName, startIndex, endIndex, sectionIndex) {
+    const range = {
+      componentName,
+      startIndex,
+      endIndex,
+      sectionIndex
+    };
+    this.ranges.push(range);
+    const currentCount = this.componentCounts.get(componentName) || 0;
+    this.componentCounts.set(componentName, currentCount + 1);
+  }
+  getRangesForComponent(componentName) {
+    return this.ranges.filter(r => r.componentName === componentName);
+  }
+  getComponentCount(componentName) {
+    return this.componentCounts.get(componentName) || 0;
+  }
+  isNodeHandled(nodeIndex) {
+    return this.ranges.some(r => nodeIndex >= r.startIndex && nodeIndex < r.endIndex);
+  }
+  getComponentForNode(nodeIndex) {
+    return this.ranges.find(r => nodeIndex >= r.startIndex && nodeIndex < r.endIndex) || null;
+  }
+  getSummary() {
+    const summary = [];
+    for (const [componentName, count] of this.componentCounts.entries()) {
+      summary.push({
+        componentName,
+        count,
+        ranges: this.getRangesForComponent(componentName)
+      });
+    }
+    return summary.sort((a, b) => b.count - a.count); // Sort by count descending
+  }
+  markImageKeywordUsed(keyword) {
+    this.usedImageKeywords.add(keyword.toLowerCase());
+  }
+  isImageKeywordUsed(keyword) {
+    return this.usedImageKeywords.has(keyword.toLowerCase());
+  }
+  setMeta(sectionType, key, value) {
+    this.metadata.set(`${sectionType}:${key}`, value);
+  }
+  getMeta(sectionType, key) {
+    return this.metadata.get(`${sectionType}:${key}`);
+  }
+}
+exports.ComponentTracking = ComponentTracking;
+//# sourceMappingURL=componentTracking.js.map

package/dist/cjs/utils/componentTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ComponentTracking","constructor","_defineProperty2","default","Map","Set","addRange","componentName","startIndex","endIndex","sectionIndex","range","ranges","push","currentCount","componentCounts","get","set","getRangesForComponent","filter","r","getComponentCount","isNodeHandled","nodeIndex","some","getComponentForNode","find","getSummary","summary","count","entries","sort","a","b","markImageKeywordUsed","keyword","usedImageKeywords","add","toLowerCase","isImageKeywordUsed","has","setMeta","sectionType","key","value","metadata","getMeta","exports"],"sources":["../../../src/utils/componentTracking.ts"],"sourcesContent":["export interface ComponentNodeRange {\n  componentName: string;\n  startIndex: number;\n  endIndex: number; // exclusive\n  sectionIndex: number; // position in the final sections array\n}\n\n/**\n * Tracks which components handle which ranges of nodes during markdown parsing.\n * This allows you to see which components handled which node ranges and how many times each component appears.\n *\n * @example\n * ```typescript\n * const sections = parseMarkdownToComponents(markdown);\n * const tracking = getLastComponentTracking();\n *\n * // Get how many times a component appears\n * const heroCount = tracking?.getComponentCount('HeroSection'); // e.g., 1\n *\n * // Get all ranges for a specific component\n * const heroRanges = tracking?.getRangesForComponent('HeroSection');\n * // Returns: [{ componentName: 'HeroSection', startIndex: 0, endIndex: 2, sectionIndex: 0 }]\n *\n * // Check if a node is already handled\n * const isHandled = tracking?.isNodeHandled(5); // true/false\n *\n * // Get which component handles a specific node\n * const handler = tracking?.getComponentForNode(5);\n * // Returns: ComponentNodeRange | null\n *\n * // Get a summary of all components\n * const summary = tracking?.getSummary();\n * // Returns: [{ componentName: 'HeroSection', count: 1, ranges: [...] }, ...]\n * ```\n */\nexport class ComponentTracking {\n  ranges: ComponentNodeRange[] = [];\n  componentCounts: Map<string, number> = new Map();\n  usedImageKeywords: Set<string> = new Set();\n  private metadata: Map<string, unknown> = new Map();\n\n  addRange(\n    componentName: string,\n    startIndex: number,\n    endIndex: number,\n    sectionIndex: number,\n  ): void {\n    const range: ComponentNodeRange = {\n      componentName,\n      startIndex,\n      endIndex,\n      sectionIndex,\n    };\n    this.ranges.push(range);\n\n    const currentCount = this.componentCounts.get(componentName) || 0;\n    this.componentCounts.set(componentName, currentCount + 1);\n  }\n\n  getRangesForComponent(componentName: string): ComponentNodeRange[] {\n    return this.ranges.filter((r) => r.componentName === componentName);\n  }\n\n  getComponentCount(componentName: string): number {\n    return this.componentCounts.get(componentName) || 0;\n  }\n\n  isNodeHandled(nodeIndex: number): boolean {\n    return this.ranges.some(\n      (r) => nodeIndex >= r.startIndex && nodeIndex < r.endIndex,\n    );\n  }\n\n  getComponentForNode(nodeIndex: number): ComponentNodeRange | null {\n    return (\n      this.ranges.find(\n        (r) => nodeIndex >= r.startIndex && nodeIndex < r.endIndex,\n      ) || null\n    );\n  }\n\n  getSummary(): {\n    componentName: string;\n    count: number;\n    ranges: ComponentNodeRange[];\n  }[] {\n    const summary: {\n      componentName: string;\n      count: number;\n      ranges: ComponentNodeRange[];\n    }[] = [];\n\n    for (const [componentName, count] of this.componentCounts.entries()) {\n      summary.push({\n        componentName,\n        count,\n        ranges: this.getRangesForComponent(componentName),\n      });\n    }\n\n    return summary.sort((a, b) => b.count - a.count); // Sort by count descending\n  }\n\n  markImageKeywordUsed(keyword: string): void {\n    this.usedImageKeywords.add(keyword.toLowerCase());\n  }\n\n  isImageKeywordUsed(keyword: string): boolean {\n    return this.usedImageKeywords.has(keyword.toLowerCase());\n  }\n\n  setMeta(sectionType: string, key: string, value: unknown): void {\n    this.metadata.set(`${sectionType}:${key}`, value);\n  }\n\n  getMeta(sectionType: string, key: string): unknown {\n    return this.metadata.get(`${sectionType}:${key}`);\n  }\n}\n"],"mappings":";;;;;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,iBAAiB,CAAC;EAAAC,YAAA;IAAA,IAAAC,gBAAA,CAAAC,OAAA,kBACE,EAAE;IAAA,IAAAD,gBAAA,CAAAC,OAAA,2BACM,IAAIC,GAAG,CAAC,CAAC;IAAA,IAAAF,gBAAA,CAAAC,OAAA,6BACf,IAAIE,GAAG,CAAC,CAAC;IAAA,IAAAH,gBAAA,CAAAC,OAAA,oBACD,IAAIC,GAAG,CAAC,CAAC;EAAA;EAElDE,QAAQA,CACNC,aAAqB,EACrBC,UAAkB,EAClBC,QAAgB,EAChBC,YAAoB,EACd;IACN,MAAMC,KAAyB,GAAG;MAChCJ,aAAa;MACbC,UAAU;MACVC,QAAQ;MACRC;IACF,CAAC;IACD,IAAI,CAACE,MAAM,CAACC,IAAI,CAACF,KAAK,CAAC;IAEvB,MAAMG,YAAY,GAAG,IAAI,CAACC,eAAe,CAACC,GAAG,CAACT,aAAa,CAAC,IAAI,CAAC;IACjE,IAAI,CAACQ,eAAe,CAACE,GAAG,CAACV,aAAa,EAAEO,YAAY,GAAG,CAAC,CAAC;EAC3D;EAEAI,qBAAqBA,CAACX,aAAqB,EAAwB;IACjE,OAAO,IAAI,CAACK,MAAM,CAACO,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAACb,aAAa,KAAKA,aAAa,CAAC;EACrE;EAEAc,iBAAiBA,CAACd,aAAqB,EAAU;IAC/C,OAAO,IAAI,CAACQ,eAAe,CAACC,GAAG,CAACT,aAAa,CAAC,IAAI,CAAC;EACrD;EAEAe,aAAaA,CAACC,SAAiB,EAAW;IACxC,OAAO,IAAI,CAACX,MAAM,CAACY,IAAI,CACpBJ,CAAC,IAAKG,SAAS,IAAIH,CAAC,CAACZ,UAAU,IAAIe,SAAS,GAAGH,CAAC,CAACX,QACpD,CAAC;EACH;EAEAgB,mBAAmBA,CAACF,SAAiB,EAA6B;IAChE,OACE,IAAI,CAACX,MAAM,CAACc,IAAI,CACbN,CAAC,IAAKG,SAAS,IAAIH,CAAC,CAACZ,UAAU,IAAIe,SAAS,GAAGH,CAAC,CAACX,QACpD,CAAC,IAAI,IAAI;EAEb;EAEAkB,UAAUA,CAAA,EAIN;IACF,MAAMC,OAIH,GAAG,EAAE;IAER,KAAK,MAAM,CAACrB,aAAa,EAAEsB,KAAK,CAAC,IAAI,IAAI,CAACd,eAAe,CAACe,OAAO,CAAC,CAAC,EAAE;MACnEF,OAAO,CAACf,IAAI,CAAC;QACXN,aAAa;QACbsB,KAAK;QACLjB,MAAM,EAAE,IAAI,CAACM,qBAAqB,CAACX,aAAa;MAClD,CAAC,CAAC;IACJ;IAEA,OAAOqB,OAAO,CAACG,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKA,CAAC,CAACJ,KAAK,GAAGG,CAAC,CAACH,KAAK,CAAC,CAAC,CAAC;EACpD;EAEAK,oBAAoBA,CAACC,OAAe,EAAQ;IAC1C,IAAI,CAACC,iBAAiB,CAACC,GAAG,CAACF,OAAO,CAACG,WAAW,CAAC,CAAC,CAAC;EACnD;EAEAC,kBAAkBA,CAACJ,OAAe,EAAW;IAC3C,OAAO,IAAI,CAACC,iBAAiB,CAACI,GAAG,CAACL,OAAO,CAACG,WAAW,CAAC,CAAC,CAAC;EAC1D;EAEAG,OAAOA,CAACC,WAAmB,EAAEC,GAAW,EAAEC,KAAc,EAAQ;IAC9D,IAAI,CAACC,QAAQ,CAAC5B,GAAG,CAAC,GAAGyB,WAAW,IAAIC,GAAG,EAAE,EAAEC,KAAK,CAAC;EACnD;EAEAE,OAAOA,CAACJ,WAAmB,EAAEC,GAAW,EAAW;IACjD,OAAO,IAAI,CAACE,QAAQ,CAAC7B,GAAG,CAAC,GAAG0B,WAAW,IAAIC,GAAG,EAAE,CAAC;EACnD;AACF;AAACI,OAAA,CAAA/C,iBAAA,GAAAA,iBAAA","ignoreList":[]}

package/dist/cjs/utils/contentKeywordMatcher.js

@@ -0,0 +1,56 @@
+"use strict";
+
+exports.__esModule = true;
+exports.getContextualImageFilename = exports.findKeywordsInContent = void 0;
+const escapeRegExp = value => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+/**
+ * Finds keywords from an allowed list that appear in the content.
+ * Returns keywords sorted by their first appearance position in the content.
+ */
+const findKeywordsInContent = (contentParts, allowedKeywords) => {
+  const content = contentParts.filter(Boolean).join(' ').toLowerCase();
+  if (!content) {
+    return [];
+  }
+  const matches = [];
+  for (const keyword of allowedKeywords) {
+    const pattern = new RegExp(`\\b${escapeRegExp(keyword)}\\b`, 'i');
+    const matchIndex = content.search(pattern);
+    if (matchIndex >= 0) {
+      matches.push({
+        keyword,
+        index: matchIndex
+      });
+    }
+  }
+  return matches.sort((a, b) => a.index - b.index).map(match => match.keyword);
+};
+
+/**
+ * Gets a contextual image filename based on keywords found in content.
+ * Returns a web5://image/ URL if a keyword is found, otherwise the default image.
+ * When tracking is provided, skips keywords that have already been used on this page.
+ */
+exports.findKeywordsInContent = findKeywordsInContent;
+const getContextualImageFilename = (contentParts, allowedKeywords, defaultImage, tracking) => {
+  const matches = findKeywordsInContent(contentParts, allowedKeywords);
+
+  // Find first keyword not already used
+  const keyword = matches.find(kw => !tracking || !tracking.isImageKeywordUsed(kw));
+  if (keyword) {
+    tracking == null || tracking.markImageKeywordUsed(keyword);
+    return {
+      filename: `web5://image/${keyword}`,
+      alt: `${keyword} image`,
+      isFromText: true
+    };
+  }
+  return {
+    filename: defaultImage,
+    alt: '',
+    isFromText: false
+  };
+};
+exports.getContextualImageFilename = getContextualImageFilename;
+//# sourceMappingURL=contentKeywordMatcher.js.map

package/dist/cjs/utils/contentKeywordMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["escapeRegExp","value","replace","findKeywordsInContent","contentParts","allowedKeywords","content","filter","Boolean","join","toLowerCase","matches","keyword","pattern","RegExp","matchIndex","search","push","index","sort","a","b","map","match","exports","getContextualImageFilename","defaultImage","tracking","find","kw","isImageKeywordUsed","markImageKeywordUsed","filename","alt","isFromText"],"sources":["../../../src/utils/contentKeywordMatcher.ts"],"sourcesContent":["import type { ComponentTracking } from './componentTracking';\nimport type { ContextualImageResult } from '../component/section-definition';\n\nconst escapeRegExp = (value: string) =>\n  value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n/**\n * Finds keywords from an allowed list that appear in the content.\n * Returns keywords sorted by their first appearance position in the content.\n */\nexport const findKeywordsInContent = (\n  contentParts: (string | undefined | null)[],\n  allowedKeywords: string[],\n): string[] => {\n  const content = contentParts.filter(Boolean).join(' ').toLowerCase();\n  if (!content) {\n    return [];\n  }\n\n  const matches: { keyword: string; index: number }[] = [];\n  for (const keyword of allowedKeywords) {\n    const pattern = new RegExp(`\\\\b${escapeRegExp(keyword)}\\\\b`, 'i');\n    const matchIndex = content.search(pattern);\n    if (matchIndex >= 0) {\n      matches.push({ keyword, index: matchIndex });\n    }\n  }\n\n  return matches\n    .sort((a, b) => a.index - b.index)\n    .map((match) => match.keyword);\n};\n\n/**\n * Gets a contextual image filename based on keywords found in content.\n * Returns a web5://image/ URL if a keyword is found, otherwise the default image.\n * When tracking is provided, skips keywords that have already been used on this page.\n */\nexport const getContextualImageFilename = (\n  contentParts: (string | undefined | null)[],\n  allowedKeywords: string[],\n  defaultImage: string,\n  tracking?: ComponentTracking,\n): ContextualImageResult => {\n  const matches = findKeywordsInContent(contentParts, allowedKeywords);\n\n  // Find first keyword not already used\n  const keyword = matches.find(\n    (kw) => !tracking || !tracking.isImageKeywordUsed(kw),\n  );\n\n  if (keyword) {\n    tracking?.markImageKeywordUsed(keyword);\n    return {\n      filename: `web5://image/${keyword}`,\n      alt: `${keyword} image`,\n      isFromText: true,\n    };\n  }\n\n  return { filename: defaultImage, alt: '', isFromText: false };\n};\n"],"mappings":";;;;AAGA,MAAMA,YAAY,GAAIC,KAAa,IACjCA,KAAK,CAACC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC;;AAE9C;AACA;AACA;AACA;AACO,MAAMC,qBAAqB,GAAGA,CACnCC,YAA2C,EAC3CC,eAAyB,KACZ;EACb,MAAMC,OAAO,GAAGF,YAAY,CAACG,MAAM,CAACC,OAAO,CAAC,CAACC,IAAI,CAAC,GAAG,CAAC,CAACC,WAAW,CAAC,CAAC;EACpE,IAAI,CAACJ,OAAO,EAAE;IACZ,OAAO,EAAE;EACX;EAEA,MAAMK,OAA6C,GAAG,EAAE;EACxD,KAAK,MAAMC,OAAO,IAAIP,eAAe,EAAE;IACrC,MAAMQ,OAAO,GAAG,IAAIC,MAAM,CAAC,MAAMd,YAAY,CAACY,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;IACjE,MAAMG,UAAU,GAAGT,OAAO,CAACU,MAAM,CAACH,OAAO,CAAC;IAC1C,IAAIE,UAAU,IAAI,CAAC,EAAE;MACnBJ,OAAO,CAACM,IAAI,CAAC;QAAEL,OAAO;QAAEM,KAAK,EAAEH;MAAW,CAAC,CAAC;IAC9C;EACF;EAEA,OAAOJ,OAAO,CACXQ,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKD,CAAC,CAACF,KAAK,GAAGG,CAAC,CAACH,KAAK,CAAC,CACjCI,GAAG,CAAEC,KAAK,IAAKA,KAAK,CAACX,OAAO,CAAC;AAClC,CAAC;;AAED;AACA;AACA;AACA;AACA;AAJAY,OAAA,CAAArB,qBAAA,GAAAA,qBAAA;AAKO,MAAMsB,0BAA0B,GAAGA,CACxCrB,YAA2C,EAC3CC,eAAyB,EACzBqB,YAAoB,EACpBC,QAA4B,KACF;EAC1B,MAAMhB,OAAO,GAAGR,qBAAqB,CAACC,YAAY,EAAEC,eAAe,CAAC;;EAEpE;EACA,MAAMO,OAAO,GAAGD,OAAO,CAACiB,IAAI,CACzBC,EAAE,IAAK,CAACF,QAAQ,IAAI,CAACA,QAAQ,CAACG,kBAAkB,CAACD,EAAE,CACtD,CAAC;EAED,IAAIjB,OAAO,EAAE;IACXe,QAAQ,YAARA,QAAQ,CAAEI,oBAAoB,CAACnB,OAAO,CAAC;IACvC,OAAO;MACLoB,QAAQ,EAAE,gBAAgBpB,OAAO,EAAE;MACnCqB,GAAG,EAAE,GAAGrB,OAAO,QAAQ;MACvBsB,UAAU,EAAE;IACd,CAAC;EACH;EAEA,OAAO;IAAEF,QAAQ,EAAEN,YAAY;IAAEO,GAAG,EAAE,EAAE;IAAEC,UAAU,EAAE;EAAM,CAAC;AAC/D,CAAC;AAACV,OAAA,CAAAC,0BAAA,GAAAA,0BAAA","ignoreList":[]}

package/dist/cjs/utils/conversationApi.js

@@ -0,0 +1,52 @@
+"use strict";
+
+exports.__esModule = true;
+exports.usesTurnApi = exports.setConversationApi = exports.getConversationApi = exports.DEFAULT_CONVERSATION_API = exports.CONVERSATION_API_KEY = void 0;
+/**
+ * Conversation API selection (debug-only).
+ *
+ * Switches the conversation between the default `Conversation` RPC
+ * (`POST /v1/conversation`) and the parallel-safe `Turn` RPC
+ * (`POST /v1/turn`, DL #110). Persisted in
+ * `localStorage["web5_conversation_api"]`, read at request time. Default
+ * `conversation` (Turn is opt-in via the debug toggle for now).
+ *
+ * `Turn` returns a flat markdown stream (no sectioned page frames), so the
+ * sectioned-stream consumption path only runs on the `Conversation` API. Lives
+ * in web5-core so any surface can honor the same toggle.
+ */
+
+const CONVERSATION_API_KEY = exports.CONVERSATION_API_KEY = 'web5_conversation_api';
+const DEFAULT_CONVERSATION_API = exports.DEFAULT_CONVERSATION_API = 'conversation';
+
+/**
+ * Read the selected conversation API from localStorage. Falls back to the
+ * default (`conversation`) when unset, invalid, or storage is unavailable.
+ */
+const getConversationApi = () => {
+  try {
+    const value = localStorage.getItem(CONVERSATION_API_KEY);
+    if (value === 'turn' || value === 'conversation') {
+      return value;
+    }
+  } catch {
+    // localStorage can throw in privacy mode / non-DOM environments.
+  }
+  return DEFAULT_CONVERSATION_API;
+};
+
+/** Persist the selected conversation API to localStorage. */
+exports.getConversationApi = getConversationApi;
+const setConversationApi = api => {
+  try {
+    localStorage.setItem(CONVERSATION_API_KEY, api);
+  } catch {
+    // Ignore — selection simply won't persist across reloads.
+  }
+};
+
+/** Whether the conversation should use the Turn RPC (opt-in; default is Conversation). */
+exports.setConversationApi = setConversationApi;
+const usesTurnApi = () => getConversationApi() === 'turn';
+exports.usesTurnApi = usesTurnApi;
+//# sourceMappingURL=conversationApi.js.map