@wix/web5-core 1.56.0

package/dist/types/types/blog.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared types for blog section components
+ */
+export interface BlogPost {
+    /** Unique identifier for the blog post */
+    id: string;
+    /** Post title (optional) */
+    title?: string;
+    /** Post description (required) */
+    description: string;
+    /** Post thumbnail image URL (required) */
+    imageUrl: string;
+    /** Optional action when post is clicked */
+    onClick?: string;
+    /** Publication date */
+    date?: string;
+    /** Post category */
+    category?: string;
+    /** Optional list items to display below the description */
+    listItems?: string[];
+}
+//# sourceMappingURL=blog.d.ts.map

package/dist/types/types/blog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../../src/types/blog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,QAAQ;IACvB,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/dist/types/types/callout.d.ts

@@ -0,0 +1,7 @@
+export declare const CALLOUT_KINDS: readonly ["NOTE", "TIP", "IMPORTANT", "WARNING", "CAUTION", "ECHO"];
+export type CalloutKind = (typeof CALLOUT_KINDS)[number];
+export interface Callout {
+    text: string;
+    kind?: string;
+}
+//# sourceMappingURL=callout.d.ts.map

package/dist/types/types/callout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callout.d.ts","sourceRoot":"","sources":["../../../src/types/callout.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,qEAOhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types/types/dependencies.d.ts

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

package/dist/types/types/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../src/types/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,CACf,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,EAC1D,GAAG,EAAE,MAAM,GAAG,SAAS,KACpB,IAAI,CAAC;IACV,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC7C,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;IAC5D,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,aAAa,EAAE,CACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,yBAAyB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAmB,SAAQ,0BAA0B;IACpE,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,CACX,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,2BAA2B,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,+BAA+B,CAAC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,CAAC,KAAK,EAAE;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,KAAK,IAAI,CAAC;IACX,kBAAkB,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,uBAAuB,EAAE,CAAC,KAAK,EAAE;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,UAAU,CAAC;KAClB,KAAK,IAAI,CAAC;IACX,uBAAuB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,wBAAwB,EAAE,MAAM,IAAI,CAAC;IACrC,uBAAuB,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,6BAA6B,EAAE,CAC7B,WAAW,EAAE,cAAc,EAC3B,MAAM,EAAE,gBAAgB,KACrB,kBAAkB,CAAC;IACxB,mDAAmD;IACnD,6BAA6B,EAAE,CAC7B,WAAW,EAAE,cAAc,EAC3B,MAAM,EAAE,gBAAgB,KACrB,cAAc,CAAC;IACpB,4BAA4B,EAAE,CAC5B,WAAW,EAAE,cAAc,EAC3B,MAAM,EAAE,gBAAgB,KACrB,cAAc,CAAC;CACrB;AAGD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,CAAC;IAC9C,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B,CAAC,WAAW;IAC1D,SAAS,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,KAAK,WAAW,CAAC;CAC3E;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,WAAW,CAAC;IAE/B,iFAAiF;IACjF,eAAe,EAAE,MAAM,eAAe,CAAC;IAEvC,sDAAsD;IACtD,oBAAoB,CAAC,EAAE,MAAM,oBAAoB,CAAC;IAElD,yDAAyD;IACzD,oBAAoB,EAAE,MAAM,OAAO,CAAC;IAEpC,0DAA0D;IAC1D,2BAA2B,EAAE,CAC3B,OAAO,SAAS;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,WAAW,CAAC;KACpB,EACD,WAAW,EAEX,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,+BAA+B,CAAC,WAAW,CAAC,KAClD;QAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAEvD,iCAAiC;IACjC,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,iCAAiC;IACjC,aAAa,EAAE,aAAa,CAAC;IAE7B,+DAA+D;IAC/D,yBAAyB,CAAC,EAAE,CAC1B,MAAM,EAAE,GAAG,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;KACzC,KACE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE5B,6EAA6E;IAC7E,2BAA2B,CAAC,EAAE,CAC5B,MAAM,EAAE,GAAG,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;KACzC,KACE,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAE1C,6EAA6E;IAC7E,0BAA0B,CAAC,EAAE,CAC3B,MAAM,EAAE,GAAG,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;KACzC,KACE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC;IAEzB,kFAAkF;IAClF,qBAAqB,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAElE,gDAAgD;IAChD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEpE,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAE5C,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC;IAEhC,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,CACjB,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC;IAEV,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,OAAO,CAAC;QACzB,eAAe,EAAE,OAAO,CAAC;KAC1B,KAAK,IAAI,CAAC;IAEX,2CAA2C;IAC3C,sBAAsB,CAAC,EAAE,MAAM;QAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,sEAAsE;IACtE,eAAe,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC,CAAC;CACJ"}

package/dist/types/types/entity.d.ts

@@ -0,0 +1,38 @@
+export interface ApiPayloadItem {
+    url: string;
+    features: {
+        feature: string;
+        value: string;
+    }[];
+    img?: string;
+    id: string;
+    title: string;
+    type: string;
+    update_ts?: string;
+    publishDate?: string;
+    published_at?: string;
+    cms_item_id?: string;
+    usage?: number;
+    author?: string;
+    authorName?: string;
+    description?: string;
+    excerpt?: string;
+    labels?: string[];
+    tags?: string[];
+    categories?: string[];
+}
+export interface EntityTypeConfig {
+    payloadType: string;
+    urlMatchProperty: string;
+    urlMatchPattern?: 'endsWith' | 'contains' | 'equals';
+    imageBaseUrl?: string;
+}
+export interface EntityConfig {
+    enabled: boolean;
+    entityTypes: Record<string, EntityTypeConfig>;
+}
+export interface EntityExtractionContext {
+    payload?: ApiPayloadItem[];
+    entityConfig?: EntityConfig;
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/types/types/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/types/entity.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B"}

package/dist/types/types/link-types.d.ts

@@ -0,0 +1,38 @@
+export declare enum Web5UrlType {
+    ASK = "ask",
+    ENTITY = "entity",
+    IMAGE = "image",
+    ICON = "icon",
+    ACTION = "action",
+    SEARCH = "search"
+}
+export type Web5AskUrl = `web5://ask/${string}`;
+export type Web5EntityUrl = `web5://entity/${string}`;
+export type Web5ImageUrl = `web5://image/${string}`;
+export type Web5IconUrl = `web5://icon/${string}`;
+export type Web5ActionUrl = `web5://action/${string}`;
+export type Web5SearchUrl = `web5://search/${string}`;
+export type Web5Url = Web5AskUrl | Web5EntityUrl | Web5ImageUrl | Web5IconUrl | Web5ActionUrl | Web5SearchUrl;
+export type HttpsUrl = `https://${string}`;
+export type HttpUrl = `http://${string}`;
+export type MailtoUrl = `mailto:${string}`;
+export type RelativeUrl = `/${string}`;
+export type NavigableUrl = HttpsUrl | HttpUrl | MailtoUrl | RelativeUrl;
+export type LegacyEntityUrl = `entity://${string}`;
+export type LegacyImageUrl = `image://${string}`;
+export type LegacyActionUrl = `action://${string}`;
+export type LegacyAskUrl = `ask://${string}`;
+export type LegacyUrl = LegacyEntityUrl | LegacyImageUrl | LegacyActionUrl | LegacyAskUrl;
+export type ValidLinkUrl = Web5Url | NavigableUrl;
+export type AnyKnownUrl = ValidLinkUrl | LegacyUrl;
+export declare function isWeb5AskUrl(url: string): url is Web5AskUrl;
+export declare function isWeb5EntityUrl(url: string): url is Web5EntityUrl;
+export declare function isWeb5ImageUrl(url: string): url is Web5ImageUrl;
+export declare function isWeb5IconUrl(url: string): url is Web5IconUrl;
+export declare function isWeb5ActionUrl(url: string): url is Web5ActionUrl;
+export declare function isWeb5SearchUrl(url: string): url is Web5SearchUrl;
+export declare function isWeb5Url(url: string): url is Web5Url;
+export declare function isNavigableUrl(url: string): url is NavigableUrl;
+export declare function isValidLinkUrl(url: string): url is ValidLinkUrl;
+export declare function isLegacyUrl(url: string): url is LegacyUrl;
+//# sourceMappingURL=link-types.d.ts.map

package/dist/types/types/link-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-types.d.ts","sourceRoot":"","sources":["../../../src/types/link-types.ts"],"names":[],"mappings":"AAEA,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAID,MAAM,MAAM,UAAU,GAAG,cAAc,MAAM,EAAE,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG,iBAAiB,MAAM,EAAE,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,gBAAgB,MAAM,EAAE,CAAC;AACpD,MAAM,MAAM,WAAW,GAAG,eAAe,MAAM,EAAE,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,iBAAiB,MAAM,EAAE,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,iBAAiB,MAAM,EAAE,CAAC;AACtD,MAAM,MAAM,OAAO,GACf,UAAU,GACV,aAAa,GACb,YAAY,GACZ,WAAW,GACX,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,MAAM,QAAQ,GAAG,WAAW,MAAM,EAAE,CAAC;AAC3C,MAAM,MAAM,OAAO,GAAG,UAAU,MAAM,EAAE,CAAC;AACzC,MAAM,MAAM,SAAS,GAAG,UAAU,MAAM,EAAE,CAAC;AAC3C,MAAM,MAAM,WAAW,GAAG,IAAI,MAAM,EAAE,CAAC;AACvC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG,YAAY,MAAM,EAAE,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,WAAW,MAAM,EAAE,CAAC;AACjD,MAAM,MAAM,eAAe,GAAG,YAAY,MAAM,EAAE,CAAC;AACnD,MAAM,MAAM,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;AAC7C,MAAM,MAAM,SAAS,GACjB,eAAe,GACf,cAAc,GACd,eAAe,GACf,YAAY,CAAC;AAEjB,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,YAAY,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;AAInD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,UAAU,CAE3D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,aAAa,CAEjE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,YAAY,CAE/D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,WAAW,CAE7D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,aAAa,CAEjE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,aAAa,CAEjE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,OAAO,CAQrD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,YAAY,CAO/D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,YAAY,CAE/D;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,SAAS,CAEzD"}

package/dist/types/types/page-section.d.ts

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

package/dist/types/types/page-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-section.d.ts","sourceRoot":"","sources":["../../../src/types/page-section.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB"}

package/dist/types/types/placement.d.ts

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

package/dist/types/types/placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement.d.ts","sourceRoot":"","sources":["../../../src/types/placement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB,CAAC,uBAAuB,GAAG,qBAAqB,CAAC,GACjD,CAAC,uBAAuB,GAAG,uBAAuB,CAAC,GACnD,CAAC,uBAAuB,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC"}

package/dist/types/types/redirectEvent.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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.
+ */
+export declare const WEB5_REDIRECT_EVENT = "web5:redirect";
+export type Web5RedirectReason = 'context-changed';
+export interface Web5RedirectEventDetail {
+    /** The original visitor query to forward as `?initialQuestion=`. */
+    query: string;
+    /**
+     * Destination URL to navigate to (e.g. `/pages/ai`). The publisher reads
+     * it from the loaded client UMD's `clientConfig.linkConfig.searchRedirectUrl`
+     * — the same value the `user-query` input widget already uses for its
+     * non-product submits, so both paths land on the same page.
+     */
+    searchRedirectUrl: string;
+    /** Coarse reason — extensible. Today: only `'context-changed'`. */
+    reason: Web5RedirectReason;
+}
+export type Web5RedirectEvent = CustomEvent<Web5RedirectEventDetail>;
+declare global {
+    interface WindowEventMap {
+        [WEB5_REDIRECT_EVENT]: Web5RedirectEvent;
+    }
+}
+//# sourceMappingURL=redirectEvent.d.ts.map

package/dist/types/types/redirectEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirectEvent.d.ts","sourceRoot":"","sources":["../../../src/types/redirectEvent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEnD,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAErE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,cAAc;QACtB,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;KAC1C;CACF"}

package/dist/types/types/userQueryEvent.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ */
+export declare const WEB5_USER_QUERY_EVENT = "web5:user-query";
+export interface Web5UserQueryEventDetail {
+    /** The text the visitor submitted in the user-query input. */
+    query: string;
+}
+export type Web5UserQueryEvent = CustomEvent<Web5UserQueryEventDetail>;
+declare global {
+    interface WindowEventMap {
+        [WEB5_USER_QUERY_EVENT]: Web5UserQueryEvent;
+    }
+}
+//# sourceMappingURL=userQueryEvent.d.ts.map

package/dist/types/types/userQueryEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userQueryEvent.d.ts","sourceRoot":"","sources":["../../../src/types/userQueryEvent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACvC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,wBAAwB,CAAC,CAAC;AAEvE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,cAAc;QACtB,CAAC,qBAAqB,CAAC,EAAE,kBAAkB,CAAC;KAC7C;CACF"}

package/dist/types/utils/analyticsEvents.d.ts

@@ -0,0 +1,24 @@
+declare global {
+    interface Window {
+        dataLayer?: Record<string, unknown>[];
+        gtag?: (...args: unknown[]) => void;
+        google_tag_manager?: Record<string, unknown>;
+        OnetrustActiveGroups?: string;
+    }
+}
+export declare function hasAnalyticsConsent(): boolean;
+/**
+ * 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.
+ */
+export declare function pushEvent(eventName: string, params?: Record<string, unknown>): void;
+export declare function pushPromptSubmit(promptType: 'text' | 'chip', promptText: string): void;
+export declare function pushLinkClick(linkUrl: string, linkType: 'web5' | 'external' | 'internal', linkText?: string): void;
+export declare function pushError(errorType: string, statusCode: number, errorMessage?: string): void;
+export declare function pushExit(exitUrl: string, linkText: string, exitType: 'external' | 'internal'): void;
+export type EntityFilteredReason = 'no_data' | 'no_url';
+export declare function pushEntityFiltered(reason: EntityFilteredReason, entityType: string, entityId: string): void;
+//# sourceMappingURL=analyticsEvents.d.ts.map

package/dist/types/utils/analyticsEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyticsEvents.d.ts","sourceRoot":"","sources":["../../../src/utils/analyticsEvents.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7C,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B;CACF;AAID,wBAAgB,mBAAmB,IAAI,OAAO,CAY7C;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,IAAI,CAqBN;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,UAAU,EAAE,MAAM,GACjB,IAAI,CAKN;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,EAC1C,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAMN;AAED,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAMN;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,UAAU,GAAG,UAAU,GAChC,IAAI,CAMN;AAED,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,IAAI,CAMN"}

package/dist/types/utils/componentTracking.d.ts

@@ -0,0 +1,55 @@
+export interface ComponentNodeRange {
+    componentName: string;
+    startIndex: number;
+    endIndex: number;
+    sectionIndex: number;
+}
+/**
+ * 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: [...] }, ...]
+ * ```
+ */
+export declare class ComponentTracking {
+    ranges: ComponentNodeRange[];
+    componentCounts: Map<string, number>;
+    usedImageKeywords: Set<string>;
+    private metadata;
+    addRange(componentName: string, startIndex: number, endIndex: number, sectionIndex: number): void;
+    getRangesForComponent(componentName: string): ComponentNodeRange[];
+    getComponentCount(componentName: string): number;
+    isNodeHandled(nodeIndex: number): boolean;
+    getComponentForNode(nodeIndex: number): ComponentNodeRange | null;
+    getSummary(): {
+        componentName: string;
+        count: number;
+        ranges: ComponentNodeRange[];
+    }[];
+    markImageKeywordUsed(keyword: string): void;
+    isImageKeywordUsed(keyword: string): boolean;
+    setMeta(sectionType: string, key: string, value: unknown): void;
+    getMeta(sectionType: string, key: string): unknown;
+}
+//# sourceMappingURL=componentTracking.d.ts.map

package/dist/types/utils/componentTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentTracking.d.ts","sourceRoot":"","sources":["../../../src/utils/componentTracking.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,iBAAiB;IAC5B,MAAM,EAAE,kBAAkB,EAAE,CAAM;IAClC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IACjD,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IAC3C,OAAO,CAAC,QAAQ,CAAmC;IAEnD,QAAQ,CACN,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,IAAI;IAaP,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAIlE,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAIhD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMzC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAQjE,UAAU,IAAI;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,kBAAkB,EAAE,CAAC;KAC9B,EAAE;IAkBH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3C,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI5C,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI/D,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;CAGnD"}

package/dist/types/utils/contentKeywordMatcher.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentTracking } from './componentTracking';
+import type { ContextualImageResult } from '../component/section-definition';
+/**
+ * Finds keywords from an allowed list that appear in the content.
+ * Returns keywords sorted by their first appearance position in the content.
+ */
+export declare const findKeywordsInContent: (contentParts: (string | undefined | null)[], allowedKeywords: string[]) => string[];
+/**
+ * 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.
+ */
+export declare const getContextualImageFilename: (contentParts: (string | undefined | null)[], allowedKeywords: string[], defaultImage: string, tracking?: ComponentTracking) => ContextualImageResult;
+//# sourceMappingURL=contentKeywordMatcher.d.ts.map