@gengage/assistant-fe 0.4.20 → 0.4.21

package/dist/chat/types.d.ts

@@ -1,543 +0,0 @@
-import { BaseWidgetConfig, ActionPayload } from '../common/types.js';
-import { UnknownActionPolicy } from '../common/config-schema.js';
-import { PillLauncherOptions } from '../common/pill-launcher.js';
-import { FloatingLauncherOptions } from './components/FloatingLauncher.js';
-import { UISpecDomRegistry, UISpecRendererOverrides } from '../common/renderer/index.js';
-export type { FloatingLauncherOptions };
-export interface ChatWidgetConfig extends BaseWidgetConfig {
-    /**
-     * Widget display variant:
-     *   - 'floating'  : Launcher button + slide-in drawer (default)
-     *   - 'inline'    : Renders directly into mountTarget, no launcher
-     *   - 'overlay'   : Full-screen modal, triggered programmatically
-     */
-    variant?: 'floating' | 'inline' | 'overlay';
-    /**
-     * Initial open state for mobile.
-     * 'half' shows a half-height sheet; 'full' is full-screen.
-     */
-    mobileInitialState?: 'half' | 'full';
-    /** Custom launcher button SVG markup. */
-    launcherSvg?: string;
-    /**
-     * Launcher image URL — renders the launcher as a full-size image button
-     * (no circular background, no padding). The image fills the entire button.
-     * Takes precedence over launcherSvg when set.
-     * Ignored when `pillLauncher` is set (pill derives `launcherImageUrl` from `pillLauncher.avatarUrl`).
-     */
-    launcherImageUrl?: string;
-    /**
-     * Mobile-specific launcher image URL. When set alongside `launcherImageUrl`,
-     * this image is shown on mobile viewports and `launcherImageUrl` on desktop.
-     */
-    mobileLauncherImageUrl?: string;
-    /**
-     * Declarative pill-shaped floating launcher (label + avatar). The widget calls
-     * `makePillLauncher` and `apply()` internally after mount — no host `apply()` needed.
-     * Floating variant only; omit manual `launcherImageUrl` when using this.
-     */
-    pillLauncher?: PillLauncherOptions;
-    /**
-     * Search-bar style floating launcher with voice input. Replaces the standard
-     * FAB button with a full-width pill input bar. The widget mounts it inside the
-     * shadow DOM — no host-side `apply()` needed.
-     * Floating variant only; mutually exclusive with `pillLauncher` and `launcherImageUrl`.
-     */
-    floatingLauncher?: FloatingLauncherOptions;
-    /** Tooltip text shown on launcher hover. */
-    launcherTooltip?: string;
-    /** Header display title (overrides i18n.headerTitle). */
-    headerTitle?: string;
-    /** Header avatar image URL. */
-    headerAvatarUrl?: string;
-    /** Header badge text (e.g. "BETA"). */
-    headerBadge?: string;
-    /**
-     * Header background color (CSS color value, e.g. "#1d2939" or "hsl(220 26% 14%)").
-     * Sets the `--gengage-chat-header-bg` CSS custom property.
-     * Can also be set via `theme['--gengage-chat-header-bg']`.
-     */
-    headerBg?: string;
-    /**
-     * Header foreground (text/icon) color.
-     * Sets the `--gengage-chat-header-foreground` CSS custom property.
-     * Can also be set via `theme['--gengage-chat-header-foreground']`.
-     */
-    headerForeground?: string;
-    /** Header cart link URL (e.g. "/sepetim"). Shows a cart icon in the header. */
-    headerCartUrl?: string;
-    /**
-     * Legacy: show the header favorites (heart) button without `onFavoritesClick`.
-     * Opens the built-in favorites list in the side panel (IDB-backed).
-     */
-    headerFavoritesToggle?: boolean;
-    /**
-     * When set, shows the header favorites button. On click, only this callback runs — use it to
-     * open the merchant's favorites page (same pattern as `onCartClick`). The built-in favorites panel is not opened.
-     */
-    onFavoritesClick?: () => void;
-    /** Callback fired when the cart icon button in the header is clicked (when headerCartUrl is not set). */
-    onCartClick?: () => void;
-    /** Hide the launcher on mobile viewports. */
-    hideMobileLauncher?: boolean;
-    /** Mobile breakpoint in px (default: 768). */
-    mobileBreakpoint?: number;
-    /**
-     * Dynamically positions the launcher relative to a page element per viewport.
-     * ResizeObserver tracks the element and updates the launcher CSS variables on
-     * every resize — no static overrides needed. Call `syncLauncherAnchor()` from
-     * SPA navigation handlers to re-query anchors after page transitions.
-     *
-     * Offset semantics:
-     *   - `0`   → launcher edge aligns with the element's same edge (overlap, no gap)
-     *   - `N>0` → launcher is N px outside the element's far edge
-     *
-     *   `bottomOffset`: 0 = align with el.bottom, N = N px above el.top
-     *   `rightOffset`:  0 = align with el.right,  N = N px left of el.left
-     */
-    launcherAnchor?: {
-        mobile?: {
-            /**
-             * Anchor source element selector. If omitted, `bottom` / `right` offsets are
-             * applied directly from viewport edges (without element tracking).
-             */
-            selector?: string;
-            /**
-             * Vertical anchor. `offset` is the distance in px; `type` controls the reference:
-             * - `'gap'` (default): offset=0 → launcher bottom = element bottom;
-             *   offset>0 → launcher sits N px above the element's top edge.
-             * - `'root'`: offset always measured from the element's bottom edge;
-             *   offset=0 → launcher bottom = element bottom; N > 0 → N px above element's bottom.
-             */
-            bottom?: {
-                offset: number;
-                type?: 'gap' | 'root';
-            };
-            /**
-             * Horizontal anchor. `offset` is the distance in px; `type` controls the reference:
-             * - `'gap'` (default): offset=0 → launcher right = element right;
-             *   offset>0 → launcher sits N px to the left of the element's left edge.
-             * - `'root'`: offset always measured from the element's right edge;
-             *   offset=0 → launcher right = element right; N > 0 → N px inward from element's right.
-             */
-            right?: {
-                offset: number;
-                type?: 'gap' | 'root';
-            };
-            /**
-             * When true, launcher animates to the anchored position when the element
-             * scrolls into view, and returns to default when it scrolls out.
-             */
-            dynamicRelocate?: boolean;
-        };
-        desktop?: {
-            /**
-             * Anchor source element selector. If omitted, `bottom` / `right` offsets are
-             * applied directly from viewport edges (without element tracking).
-             */
-            selector?: string;
-            bottom?: {
-                offset: number;
-                type?: 'gap' | 'root';
-            };
-            right?: {
-                offset: number;
-                type?: 'gap' | 'root';
-            };
-            dynamicRelocate?: boolean;
-        };
-    };
-    /**
-     * Panel display mode:
-     *   - 'auto'      : Panel appears/hides with content; user can toggle (default)
-     *   - 'collapsed'  : Panel starts collapsed; fresh panel content reopens it
-     *   - 'expanded'   : Panel starts expanded (users can still collapse/expand)
-     */
-    panelMode?: 'auto' | 'collapsed' | 'expanded';
-    /**
-     * Locale for built-in i18n strings.
-     * Provide a custom `i18n` object to override any string.
-     */
-    locale?: string;
-    i18n?: Partial<ChatI18n>;
-    renderer?: ChatRendererConfig;
-    /** Controls how streamed actions are routed (policy for unknowns, script_call gating). */
-    actionHandling?: {
-        unknownActionPolicy?: UnknownActionPolicy;
-        allowScriptCall?: boolean;
-    };
-    /** Welcome message shown on first drawer open with empty history. */
-    welcomeMessage?: string;
-    /** Starter action pills shown with welcome message. */
-    welcomeActions?: string[];
-    /** Context-specific starter action pills for blank/home/listing/PDP entry states. */
-    welcomeActionsByContext?: ChatWelcomeActionsByContext;
-    /** Context-specific opening copy that is forwarded to the backend entry-opening flow. */
-    openingMessagesByContext?: ChatContextualCopyByContext;
-    /** Context-specific steering notes forwarded to the backend entry-opening flow. */
-    openingGuidanceByContext?: ChatContextualCopyByContext;
-    /**
-     * Whether this is a demo website. When combined with `productDetailsExtended: true`,
-     * `productDetails` content triggers the extended panel (host PDP maximize).
-     * Regular accounts render product details inline in the chat pane.
-     */
-    isDemoWebsite?: boolean;
-    /**
-     * When `true`, full `ProductDetailsPanel` and PDP similar products (`similarsAppend` grid) use
-     * the assistant side panel; demo extended mode includes `productDetails`. Default `false`/omitted:
-     * product details and similar products render only in the chat stream; the side panel is cleared.
-     * `ProductSummaryCard` always renders inline (except for silent messages).
-     */
-    productDetailsExtended?: boolean;
-    /** Product price presentation (cards, summary, details, AI Top Picks). */
-    productPriceUi?: ProductPriceUiConfig;
-    /**
-     * When true, hides the circular percent discount badge on product card images and the
-     * inline percent badge in the product details price row. List/sale price and campaign badges are unchanged.
-     */
-    hideProductDiscountBadge?: boolean;
-    /** When true, hides the ReviewHighlights component in chat responses. */
-    hideUserReviews?: boolean;
-    /** When true, hides in-stock / out-of-stock labels on product cards. */
-    hideStockStatus?: boolean;
-    /** Enable browser-native voice input. Default: false. */
-    voiceEnabled?: boolean;
-    onOpen?: () => void;
-    onClose?: () => void;
-    onReady?: () => void;
-    onScriptCall?: (params: {
-        name: string;
-        payload?: Record<string, unknown>;
-    }) => void;
-    onAddToCart?: (params: import('../common/types.js').AddToCartParams) => void;
-    /**
-     * Allowed origins for the postMessage communication bridge.
-     * Defaults to `[location.origin]` (same-origin only).
-     * Pass `['*']` to allow any origin (not recommended for production).
-     */
-    allowedOrigins?: string[];
-}
-export interface ChatI18n {
-    headerTitle: string;
-    inputPlaceholder: string;
-    sendButton: string;
-    closeButton: string;
-    openButton: string;
-    newChatButton: string;
-    poweredBy: string;
-    errorMessage: string;
-    retryButton: string;
-    loadingMessage: string;
-    loadingSequenceGeneric: string[];
-    loadingSequencePanel: string[];
-    loadingSequenceComparison: string[];
-    productCtaLabel: string;
-    /** CTA label in the product details panel when navigating to the product URL (distinct from the card "İncele" CTA). */
-    viewOnSiteLabel: string;
-    attachImageButton: string;
-    /** Image attach popup: pick from device. */
-    attachMenuSelectPhoto: string;
-    /** Image attach popup: paste from clipboard. */
-    attachMenuPaste: string;
-    /** When clipboard has no image (paste menu or unsupported API). */
-    clipboardNoImageMessage: string;
-    removeAttachmentButton: string;
-    invalidFileType: string;
-    fileTooLarge: string;
-    aiTopPicksTitle: string;
-    roleWinner: string;
-    roleBestValue: string;
-    roleBestAlternative: string;
-    viewDetails: string;
-    groundingReviewCta: string;
-    groundingReviewSubtitle: string;
-    variantsLabel: string;
-    sortRelated: string;
-    sortPriceAsc: string;
-    sortPriceDesc: string;
-    sortToolbarAriaLabel: string;
-    compareSelected: string;
-    compareMinHint: string;
-    compareMaxHint: string;
-    comparisonSelectLabel: string;
-    comparisonSelectedLabel: string;
-    /** Shown on product cards while comparison mode is on — whole card toggles selection. */
-    comparisonSelectCardHint: string;
-    /** Shown on the main panel while the comparison table is being generated. */
-    comparisonPreparingLabel: string;
-    panelTitleProductDetails: string;
-    panelTitleSimilarProducts: string;
-    panelTitleComparisonResults: string;
-    panelTitleCategories: string;
-    panelTitleSearchResults: string;
-    inStockLabel: string;
-    outOfStockLabel: string;
-    findSimilarLabel: string;
-    /** Product details gallery: previous / next image controls */
-    galleryPrevAriaLabel: string;
-    galleryNextAriaLabel: string;
-    /** Title shown above consultant style cards. Supports {count} placeholder. */
-    beautyStylesPreparedTitle: string;
-    /** Title shown above watch-expert style cards. Supports {count} placeholder. */
-    watchStylesPreparedTitle: string;
-    /** Label for products that were not included in a backend recommendation group. */
-    consultingOtherCompatibleProductsLabel: string;
-    /** Fallback label for an unnamed consulting recommendation group. */
-    consultingFallbackGroupLabel: string;
-    /** Fallback label for a consulting style card. Supports {index} placeholder. */
-    consultingFallbackStyleLabel: string;
-    consultingStyleLoadingDescription: string;
-    consultingStyleUnavailableDescription: string;
-    consultingStyleLoadingBadge: string;
-    consultingStyleUnavailableBadge: string;
-    choicePrompterHeading: string;
-    choicePrompterSuggestion: string;
-    choicePrompterCta: string;
-    viewMoreLabel: string;
-    similarProductsLabel: string;
-    addToCartButton: string;
-    addedToCartToast: string;
-    shareButton: string;
-    productInfoTab: string;
-    specificationsTab: string;
-    recommendedChoiceLabel: string;
-    highlightsLabel: string;
-    keyDifferencesLabel: string;
-    specialCasesLabel: string;
-    emptyReviewsMessage: string;
-    closeAriaLabel: string;
-    startChatLabel: string;
-    voiceButton: string;
-    voiceListening: string;
-    voiceNotSupported: string;
-    voicePermissionDenied: string;
-    voiceError: string;
-    handoffHeading: string;
-    productNotFoundMessage: string;
-    stopGenerating: string;
-    offlineMessage: string;
-    cartAriaLabel: string;
-    favoritesAriaLabel: string;
-    historyAriaLabel: string;
-    historyPageTitle: string;
-    emptyHistoryMessage: string;
-    historyDeleteLabel: string;
-    historyDeleteConfirmMessage: string;
-    showPanelAriaLabel: string;
-    addToFavoritesLabel: string;
-    customerReviewsTitle: string;
-    togglePanelAriaLabel: string;
-    chatMessagesAriaLabel: string;
-    suggestionsAriaLabel: string;
-    moreSuggestionsAriaLabel: string;
-    rollbackAriaLabel: string;
-    backAriaLabel: string;
-    forwardAriaLabel: string;
-    /** Aria label for the panel close (✕) button shown on mobile. */
-    closePanelAriaLabel: string;
-    dismissAriaLabel: string;
-    cartAddErrorMessage: string;
-    /** Shown when a host `gengage-product-favorite` callback fails (returns false or throws). */
-    favoriteToggleErrorMessage: string;
-    /** Used as lowercase suffix for positive mention counts, e.g. "3 positive". */
-    reviewFilterPositive: string;
-    /** Used as lowercase suffix for negative mention counts, e.g. "2 negative". */
-    reviewFilterNegative: string;
-    decreaseLabel: string;
-    increaseLabel: string;
-    reviewCustomersMentionSingular: string;
-    reviewCustomersMentionPlural: string;
-    reviewSubjectsHeading: string;
-    tryAgainButton: string;
-    askSomethingElseButton: string;
-    accountInactiveMessage: string;
-    favoritesPageTitle: string;
-    emptyFavoritesMessage: string;
-    /** Sticky control when transcript is focused on the latest thread — restores full history */
-    showFormerMessagesButton: string;
-    /** Shown above the product grid on desktop while AI picks/groupings are still streaming. */
-    aiAnalysisAnalyzingLabel: string;
-    /** Section heading above AI grouping cards (panel browse categories). */
-    aiBrowseCategoriesTitle: string;
-    /** Badge text on photo analysis message cards. */
-    photoAnalysisBadge: string;
-    /** Photo analysis section label: strengths. */
-    photoAnalysisStrengthsLabel: string;
-    /** Photo analysis section label: focus points. */
-    photoAnalysisFocusLabel: string;
-    /** Photo analysis section label: celeb style match. */
-    photoAnalysisCelebStyleLabel: string;
-    /** Beauty photo step card: title. */
-    beautyPhotoStepTitle: string;
-    /** Beauty photo step card: description. */
-    beautyPhotoStepDescription: string;
-    /** Beauty photo step card: upload button label. */
-    beautyPhotoStepUpload: string;
-    /** Beauty photo step card: processing state label. */
-    beautyPhotoStepProcessing: string;
-    /** Beauty photo step card: skip button label. */
-    beautyPhotoStepSkip: string;
-    /** Message sent to backend when user clicks skip on beauty photo step. */
-    beautyPhotoStepSkipMessage: string;
-}
-export type OpeningContextKey = 'home' | 'listing' | 'product' | 'default';
-export interface ChatActionChip {
-    title: string;
-    icon?: string;
-}
-export interface ChatWelcomeActionsByContext {
-    home?: ChatActionChip[];
-    listing?: ChatActionChip[];
-    product?: ChatActionChip[];
-    default?: ChatActionChip[];
-}
-export interface ChatContextualCopyByContext {
-    home?: string;
-    listing?: string;
-    product?: string;
-    default?: string;
-}
-/** List vs sale price row: strike-through or inline with separator. */
-export type ProductPriceOriginalStyle = 'strikethrough' | 'inline';
-/** Sale price text color: body default or brand (`--client-primary`). */
-export type DiscountedPriceColor = 'default' | 'client';
-export interface ProductPriceUiConfig {
-    /**
-     * How the list price is shown. Override per product via `originalPriceStyle` / `price_original_style`.
-     * `strikethrough`: crossed-out list price. `inline`: current, separator, muted list price (no line).
-     */
-    originalPriceStyle?: ProductPriceOriginalStyle;
-    /**
-     * When true, show a campaign / discount reason line when the payload includes `discount_reason` (or aliases).
-     */
-    showCampaignReason?: boolean;
-    /**
-     * Sale price color. Sets `--gengage-discounted-price-color` on the widget host when `client`.
-     */
-    discountedPriceColor?: DiscountedPriceColor;
-    /**
-     * Optional default image URL for the left column of the campaign price badge (logo).
-     * Override per product via `campaignReasonLogoUrl` / `campaign_reason_logo_url` (or `discountBadgeLogoUrl`).
-     */
-    campaignBadgeLogoUrl?: string;
-}
-export interface ChatUISpecRenderContext {
-    locale?: string | undefined;
-    onAction: (action: ActionPayload) => void;
-    onProductClick?: (params: {
-        sku: string;
-        url: string;
-        name?: string;
-    }) => void;
-    onAddToCart?: (params: import('../common/types.js').AddToCartParams) => void;
-    onProductSelect?: (product: Record<string, unknown>) => void;
-    pricing?: import('../common/price-formatter.js').PriceFormatConfig | undefined;
-    productPriceUi?: ProductPriceUiConfig | undefined;
-    hideProductDiscountBadge?: boolean | undefined;
-    hideUserReviews?: boolean | undefined;
-    hideStockStatus?: boolean | undefined;
-    i18n?: Pick<ChatI18n, 'productCtaLabel' | 'viewOnSiteLabel' | 'aiTopPicksTitle' | 'roleWinner' | 'roleBestValue' | 'roleBestAlternative' | 'viewDetails' | 'groundingReviewCta' | 'groundingReviewSubtitle' | 'variantsLabel' | 'sortRelated' | 'sortPriceAsc' | 'sortPriceDesc' | 'sortToolbarAriaLabel' | 'compareSelected' | 'compareMinHint' | 'comparisonSelectLabel' | 'comparisonSelectedLabel' | 'comparisonSelectCardHint' | 'panelTitleProductDetails' | 'panelTitleSimilarProducts' | 'panelTitleComparisonResults' | 'panelTitleCategories' | 'panelTitleSearchResults' | 'inStockLabel' | 'outOfStockLabel' | 'findSimilarLabel' | 'galleryPrevAriaLabel' | 'galleryNextAriaLabel' | 'beautyStylesPreparedTitle' | 'watchStylesPreparedTitle' | 'consultingOtherCompatibleProductsLabel' | 'consultingFallbackGroupLabel' | 'consultingFallbackStyleLabel' | 'consultingStyleLoadingDescription' | 'consultingStyleUnavailableDescription' | 'consultingStyleLoadingBadge' | 'consultingStyleUnavailableBadge' | 'viewMoreLabel' | 'similarProductsLabel' | 'addToCartButton' | 'shareButton' | 'productInfoTab' | 'specificationsTab' | 'recommendedChoiceLabel' | 'highlightsLabel' | 'keyDifferencesLabel' | 'specialCasesLabel' | 'emptyReviewsMessage' | 'closeAriaLabel' | 'dismissAriaLabel' | 'startChatLabel' | 'handoffHeading' | 'customerReviewsTitle' | 'addToFavoritesLabel' | 'showPanelAriaLabel' | 'reviewFilterPositive' | 'reviewFilterNegative' | 'decreaseLabel' | 'increaseLabel' | 'reviewCustomersMentionSingular' | 'reviewCustomersMentionPlural' | 'reviewSubjectsHeading' | 'aiBrowseCategoriesTitle' | 'photoAnalysisBadge' | 'photoAnalysisStrengthsLabel' | 'photoAnalysisFocusLabel' | 'photoAnalysisCelebStyleLabel' | 'beautyPhotoStepTitle' | 'beautyPhotoStepDescription' | 'beautyPhotoStepUpload' | 'beautyPhotoStepProcessing' | 'beautyPhotoStepSkip'>;
-    productSort?: ProductSortState | undefined;
-    onSortChange?: ((sort: ProductSortState) => void) | undefined;
-    comparisonSelectMode?: boolean | undefined;
-    comparisonSelectedSkus?: string[] | undefined;
-    comparisonMaxSelection?: number | undefined;
-    comparisonSelectionWarning?: string | null | undefined;
-    onToggleComparisonSku?: ((sku: string) => void) | undefined;
-    favoritedSkus?: Set<string> | undefined;
-    onFavoriteToggle?: ((sku: string, product: Record<string, unknown>) => void) | undefined;
-    topPicksLoadingSku?: string | null | undefined;
-    /** When true the stream is still in progress — defer compare CTA until stream ends. */
-    isStreaming?: boolean | undefined;
-    /** True when the widget is displayed in mobile viewport. Replaces hardcoded 768px check. */
-    isMobile?: boolean | undefined;
-    /** ProductGrid: heading on the same row as sort/compare (panel list / Benzer Ürünler). */
-    panelProductListHeading?: string | undefined;
-}
-export interface ProductSortState {
-    type: 'related' | 'price';
-    direction?: 'asc' | 'desc' | undefined;
-}
-export type ChatUISpecRegistry = UISpecDomRegistry<ChatUISpecRenderContext>;
-export type ChatRendererConfig = UISpecRendererOverrides<ChatUISpecRenderContext>;
-export interface ChatMessage {
-    id: string;
-    threadId?: string;
-    role: 'user' | 'assistant';
-    /** Plain text content. */
-    content?: string;
-    /** json-render UI spec attached to this message (e.g. product cards). */
-    uiSpec?: import('../common/types.js').UISpec;
-    /** Frontend-synthesized visible message; exclude from backend chat history. */
-    frontendOnly?: boolean;
-    /** Image attachment (user-uploaded). Stored in-memory until send. */
-    attachment?: File;
-    /** Snapshot of panel DOM at time this message's stream completed. */
-    panelSnapshot?: HTMLElement;
-    /** Silent messages are hidden from the conversation but kept for context. */
-    silent?: boolean;
-    /** Backend render hint for special rendering (e.g. "photo_analysis"). */
-    renderHint?: string;
-    /** Structured photo analysis data from PhotoAnalysisCard UISpec. */
-    photoAnalysis?: {
-        summary: string;
-        strengths?: string[];
-        focusPoints?: string[];
-        celebStyle?: string;
-        celebStyleReason?: string;
-        nextQuestion?: string;
-    };
-    timestamp: number;
-    status: 'streaming' | 'done' | 'error';
-}
-export interface ChatSession {
-    sessionId: string;
-    messages: ChatMessage[];
-    /** SKU associated with this session (for cross-page restore). */
-    sku?: string;
-}
-/**
- * Serializable subset of ChatMessage for IndexedDB persistence.
- * Omits `attachment` (File) and `panelSnapshot` (HTMLElement) which are not
- * structurally cloneable.
- */
-export interface SerializableChatMessage {
-    id: string;
-    threadId?: string | undefined;
-    role: 'user' | 'assistant';
-    content?: string | undefined;
-    frontendOnly?: boolean | undefined;
-    silent?: boolean | undefined;
-    timestamp: number;
-    status: 'streaming' | 'done' | 'error';
-}
-export interface ChatUIComponents {
-    /** A single text message bubble. */
-    MessageBubble: {
-        role: 'user' | 'assistant';
-        content: string;
-        timestamp?: number;
-    };
-    /** A product card shown inline in the chat stream. */
-    ProductCard: {
-        sku: string;
-        name: string;
-        imageUrl?: string;
-        price?: string;
-        originalPrice?: string;
-        url: string;
-    };
-    /** A row of quick-reply action buttons. */
-    ActionButtons: {
-        buttons: Array<{
-            label: string;
-            action: ActionPayload;
-        }>;
-    };
-    /** A "typing..." indicator. */
-    TypingIndicator: Record<string, never>;
-    /** A divider with an optional label (e.g. "New conversation"). */
-    Divider: {
-        label?: string;
-    };
-}

package/dist/chat/utils/chat-presentation-debug.d.ts

@@ -1,19 +0,0 @@
-/**
- * Opt-in debug logging for chat presentation (query ?chat_debug=1 or localStorage gengage_chat_debug=1).
- */
-type Entry = {
-    seq: number;
-    time: string;
-    scope: string;
-    message: string;
-    payload?: unknown;
-};
-declare global {
-    interface Window {
-        __gengageChatPresentationDebugLog?: Entry[];
-        __gengageChatPresentationDebugSeq?: number;
-    }
-}
-export declare function isChatPresentationDebugEnabled(): boolean;
-export declare function logChatPresentation(scope: string, message: string, payload?: unknown): void;
-export {};

package/dist/chat/utils/get-chat-scroll-element.d.ts

@@ -1,10 +0,0 @@
-/**
- * Resolves the chat transcript scroll container (messages pane).
- * Prefers a widget-registered element (Shadow DOM–safe); falls back to #gengage-chat-scroll in light DOM.
- */
-/** DOM id on the transcript scroller — stable for host tooling */
-export declare const CHAT_SCROLL_ELEMENT_ID = "gengage-chat-scroll";
-/** Called when the chat drawer mounts / updates its messages scroller */
-export declare function registerChatScrollElement(el: HTMLElement | null): void;
-export declare function getChatScrollElement(): HTMLElement | null;
-export declare function invalidateChatScrollCache(): void;

package/dist/chat/utils/ui.d.ts

@@ -1,10 +0,0 @@
-/**
- * UI Utilities for the Gengage Chat components.
- */
-/**
- * Creates a Lucide-style SVG icon from paths.
- * @param paths SVG path strings (the 'd' attribute).
- * @param size Icon width/height in pixels.
- * @returns An SVGElement.
- */
-export declare function createLucideIcon(paths: string[], size?: number): SVGElement;

package/dist/common/action-router.d.ts

@@ -1,26 +0,0 @@
-import { UnknownActionPolicy } from './config-schema.js';
-import { ActionPayload, AddToCartParams, StreamEventAction } from './types.js';
-export interface HostActionHandlers {
-    openChat?: (payload?: ActionPayload | unknown) => void;
-    navigate?: (params: {
-        url: string;
-        newTab?: boolean;
-    }) => void;
-    saveSession?: (params: {
-        sessionId: string;
-        sku: string;
-    }) => void;
-    addToCart?: (params: AddToCartParams) => void;
-    scriptCall?: (params: {
-        name: string;
-        payload?: Record<string, unknown>;
-    }) => void;
-    unknown?: (action: StreamEventAction['action']) => void;
-}
-export interface ActionRouterOptions {
-    allowScriptCall?: boolean;
-    unknownActionPolicy?: UnknownActionPolicy;
-    logger?: Pick<Console, 'warn' | 'error' | 'debug'>;
-    defaultNavigate?: (url: string, newTab?: boolean) => void;
-}
-export declare function routeStreamAction(event: StreamEventAction, handlers: HostActionHandlers, options?: ActionRouterOptions): void;

package/dist/common/activity-tracker.d.ts

@@ -1,37 +0,0 @@
-/**
- * Tracks user activity signals (page views, idle, scroll depth) for
- * engagement analytics.
- */
-export interface ActivityEvent {
-    type: 'pageview' | 'idle' | 'scroll' | 'focus' | 'blur';
-    timestamp: number;
-    data?: Record<string, unknown>;
-}
-export interface ActivityTrackerOptions {
-    /** Idle threshold in ms (default: 30000). */
-    idleThresholdMs?: number;
-    /** Scroll depth granularity in percent (default: 25). */
-    scrollGranularity?: number;
-    /** Callback when an activity event fires. */
-    onActivity?: (event: ActivityEvent) => void;
-}
-export declare class ActivityTracker {
-    private _idleTimer;
-    private _idleThreshold;
-    private _scrollGranularity;
-    private _maxScrollDepth;
-    private _lastReportedDepth;
-    private _onActivity;
-    private _listeners;
-    private _destroyed;
-    constructor(options?: ActivityTrackerOptions);
-    private _setup;
-    private _listen;
-    private _resetIdleTimer;
-    private _onScroll;
-    private _onVisibility;
-    private _emit;
-    /** Current max scroll depth reached (0-100). */
-    get maxScrollDepth(): number;
-    destroy(): void;
-}