@gengage/assistant-fe 0.5.7 → 0.6.0

package/dist/chat/components/ChatDrawer.d.ts

@@ -0,0 +1,362 @@
+import type { ChatI18n, ChatMessage } from '../types.js';
+/** SVG icon map for suggested action chips/pills. Keys match backend icon names. */
+declare const SUGGESTED_ACTION_ICONS: Record<string, string>;
+export { SUGGESTED_ACTION_ICONS };
+export interface ChatDrawerOptions {
+    i18n: ChatI18n;
+    onSend: (text: string, attachment?: File) => void;
+    /** Callback fired when the cart icon button in the header is clicked. */
+    onCartClick?: (() => void) | undefined;
+    onClose: () => void;
+    onAttachment?: (file: File) => void;
+    onPanelToggle?: () => void;
+    /**
+     * Fired when side panel visibility/content changes so the parent can refresh host scroll lock
+     * and backdrop classes. Not related to the Google Chrome browser — “host shell” means the
+     * surrounding page/document integration.
+     */
+    onHostShellSync?: () => void;
+    onRollback?: (messageId: string) => void;
+    headerTitle?: string | undefined;
+    headerAvatarUrl?: string | undefined;
+    /** Launcher image URL — used as avatar fallback when headerAvatarUrl is not set. */
+    launcherImageUrl?: string | undefined;
+    headerBadge?: string | undefined;
+    /** URL for the cart icon link in the header (e.g. "/sepetim"). */
+    /** @deprecated Use onCartClick instead. If set, the cart button will navigate to this URL. */
+    headerCartUrl?: string | undefined;
+    /** When true, render the header favorites (heart) button. */
+    showHeaderFavorites?: boolean | undefined;
+    onFavoritesClick?: (() => void) | undefined;
+    /** Callback fired when the history button in the header is clicked. */
+    onHistoryClick?: (() => void) | undefined;
+    /** Callback fired when the panel back button is clicked. */
+    onPanelBack?: (() => void) | undefined;
+    /** Callback fired when the panel forward button is clicked. */
+    onPanelForward?: (() => void) | undefined;
+    /** Callback fired when the mobile panel close (✕) button is tapped.
+     *  Should clear panel history and comparison state in the caller. */
+    onPanelClose?: (() => void) | undefined;
+    /**
+     * Fired when the user drags the mobile handle and releases.
+     * 'half' | 'full' → switch to that snap position.
+     * 'close'          → close the drawer.
+     */
+    onMobileSnap?: ((state: 'half' | 'full' | 'close') => void) | undefined;
+    /** Returns the current mobile sheet state so the drag handler knows which snap to target. */
+    getMobileState?: (() => 'half' | 'full') | undefined;
+    /** Returns true when the chat is displayed as a mobile bottom-sheet. Used to keep the side-panel back button always enabled. */
+    getMobileViewport?: (() => boolean) | undefined;
+    /** Callback fired when a link in bot HTML is clicked. */
+    onLinkClick?: ((url: string) => void) | undefined;
+    /** Render a frontend-owned message UI payload inside the bubble, when present. */
+    renderMessageUISpec?: ((message: ChatMessage) => HTMLElement | null) | undefined;
+    /** Enable voice input (Web Speech API STT). Default: false. */
+    voiceEnabled?: boolean | undefined;
+    /** BCP 47 language for speech recognition. Default: 'tr-TR'. */
+    voiceLang?: string | undefined;
+    /** Callback fired when the "New Chat" button is clicked. */
+    onNewChat?: (() => void) | undefined;
+    /**
+     * Transcript presentation hooks (focus thread, pin-to-bottom heuristics).
+     * Optional — when omitted, legacy scroll behaviour is unchanged.
+     */
+    presentation?: {
+        onPinnedToBottomChange?: (pinned: boolean) => void;
+        onUserInteractingChange?: (interacting: boolean) => void;
+        /** User scrolled up while a thread focus is active — parent may show "former messages" */
+        onFormerMessagesHint?: () => void;
+        /** When true, stream-driven soft scroll-to-bottom is suppressed */
+        shouldBlockSoftAutoScroll?: () => boolean;
+        /** User tapped "show former messages" */
+        onReleasePresentationFocus?: () => void;
+    };
+}
+type SetPanelContentOptions = {
+    preserveAiZone?: boolean;
+};
+type TypingIndicatorMode = 'full' | 'presence';
+export declare class ChatDrawer {
+    private root;
+    private messagesEl;
+    private inputEl;
+    private sendBtn;
+    private _sendStopHandler;
+    private i18n;
+    private onSend;
+    private _panelEl;
+    private _panelVisible;
+    private _panelCollapsed;
+    private _dividerEl;
+    private _onPanelToggle;
+    private _onHostShellSync;
+    private _pendingAttachment;
+    private _fileInput;
+    private _previewStrip;
+    private _previewName;
+    private _onAttachment;
+    private _onRollback;
+    private _onLinkClick;
+    private _pillsEl;
+    private _kvkkSlot;
+    private _panelTopBar;
+    private _userScrolledUp;
+    private _scrollLockedUntil;
+    private _inputChipsEl;
+    private _panelFloatingEl;
+    /** Mobile: overlay host for comparison dock (above panel scroll; avoids transformed panel containing block). */
+    private _comparisonDockSlotEl;
+    /** Slot between panel top bar and main scroll content (desktop AI picks / analyzing strip). */
+    private _panelAiZoneEl;
+    private _favBadgeEl;
+    private _thinkingSteps;
+    private _firstBotMessageIds;
+    private _voiceInput;
+    private _micBtn;
+    private _voiceEnabled;
+    private _voiceLang;
+    private _ignoreNextDividerClick;
+    private readonly _cleanups;
+    private _focusTrapHandler;
+    private _previouslyFocusedElement;
+    private _conversationEl;
+    private readonly _options;
+    private _reopenPanelBtn;
+    private _presentationFocusThreadId;
+    private _formerMessagesBtn;
+    private _programmaticScrollUntil;
+    private _userInteractionUntil;
+    private _touchStartY;
+    private _presentationPinned;
+    private _presentationUserInteracting;
+    private _resizeRafId;
+    private _cartBtn;
+    private _attachWrapEl;
+    private _attachMenuEl;
+    private _attachBtn;
+    private _attachMenuCleanup;
+    private _attachMenuClickTimerId;
+    private _typingLoadingBinding;
+    private _panelLoadingBinding;
+    private _panelAiZoneLoadingBinding;
+    private _beautyPhotoStepEl;
+    private _renderPhotoAnalysisCard;
+    constructor(container: HTMLElement, options: ChatDrawerOptions);
+    addMessage(message: ChatMessage): void;
+    /** Remove one transcript bubble (e.g. superseded empty assistant placeholder). */
+    removeMessageBubble(messageId: string): void;
+    showTypingIndicator(searchText?: string, mode?: TypingIndicatorMode | 'auto'): void;
+    /** Accumulate a new thinking step (shown as a checklist in the typing indicator). */
+    addThinkingStep(text: string): void;
+    setThinkingSteps(steps: string[]): void;
+    removeTypingIndicator(): void;
+    setTypingIndicatorMode(mode: TypingIndicatorMode | 'auto'): void;
+    private _panelOwnsProgressSurface;
+    /** Show a "Stop generating" button below the typing indicator. */
+    showStopButton(onStop: () => void): void;
+    /** Remove the stop-generating button if present. */
+    hideStopButton(): void;
+    showError(message?: string, onRetry?: () => void): void;
+    /** Show error with recovery action pills ("Try again" + "Ask something else"). */
+    showErrorWithRecovery(message: string, actions: {
+        onRetry: () => void;
+        onNewQuestion: () => void;
+    }): void;
+    /** Recovery pills only — error copy is shown as a normal assistant message. */
+    showRecoveryPillsOnly(actions: {
+        onRetry: () => void;
+        onNewQuestion: () => void;
+    }): void;
+    private setRecoveryPills;
+    clearMessages(): void;
+    /** Replace suggestion pills. Pass empty array to hide. */
+    setPills(pills: Array<{
+        label: string;
+        onAction: () => void;
+        icon?: string;
+        image?: string;
+        description?: string;
+    }>): void;
+    focusInput(): void;
+    showKvkkBanner(html: string, onDismiss: () => void): void;
+    hideKvkkBanner(): void;
+    /** True when the KVKK banner is mounted (user has not dismissed it yet). */
+    isKvkkBannerVisible(): boolean;
+    getElement(): HTMLElement;
+    /** Opens the hidden file picker used by the attachment flow. */
+    openAttachmentPicker(): void;
+    /** Show/hide camera attach controls in the input shell. */
+    setAttachmentControlsVisible(visible: boolean): void;
+    /** Beauty mode selfie helper card shown above the input area. */
+    setBeautyPhotoStepCard(options: {
+        visible: boolean;
+        processing?: boolean;
+        onSkip?: (() => void) | undefined;
+        title?: string | undefined;
+        description?: string | undefined;
+        uploadLabel?: string | undefined;
+        skipLabel?: string | undefined;
+    }): void;
+    /** Stage a file attachment for sending. Shows preview. */
+    stageAttachment(file: File): void;
+    /** Remove the staged attachment and hide preview. */
+    clearAttachment(): void;
+    private _routeAttachmentFile;
+    private _closeAttachMenu;
+    private _openAttachMenu;
+    private _toggleAttachMenu;
+    private _pasteImageFromClipboardMenu;
+    /** Get the currently staged attachment file, or null. */
+    getPendingAttachment(): File | null;
+    /**
+     * Area above the main panel body for “analyzing” + AITopPicks / AIGroupingCards
+     * so they stay in the main pane instead of the chat column.
+     */
+    setPanelAiZoneState(state: 'hidden' | 'analyzing' | 'results', options?: {
+        resultEl?: HTMLElement;
+        analyzingLabel?: string;
+    }): void;
+    private _clearPanelAiZoneState;
+    private _resetPanelAiZoneElement;
+    private _emitHostShellSync;
+    private _applyPanelCollapsedState;
+    private _syncPanelTopBarFromContent;
+    private _syncPanelTopBarTitleFromContent;
+    /** Replace panel content and show the panel. */
+    setPanelContent(el: HTMLElement, options?: SetPanelContentOptions): void;
+    /**
+     * Targeted content swap for an already-visible panel. Replaces the skeleton
+     * or the current content element with `el`, leaving topbar / AI zone /
+     * floating element attached. Also resets topbar actions
+     * because the incoming content provides its own toolbar.
+     */
+    private _swapPanelContent;
+    /** Append content to the panel without replacing existing content. */
+    appendPanelContent(el: HTMLElement): void;
+    /** Return the panel element's content child (after topbar), or null. */
+    getPanelContentElement(): HTMLElement | null;
+    /**
+     * After in-place mutations to panel content (e.g. consulting grid streaming patch),
+     * refresh top bar title derivation without replacing the content node.
+     */
+    resyncPanelTopBarFromCurrentContent(): void;
+    /** Whether the panel is currently visible (may be empty). */
+    isPanelVisible(): boolean;
+    /** Whether the panel is currently visible and has rendered content beyond chrome elements. */
+    hasPanelContent(): boolean;
+    /** Whether panel currently shows loading skeleton blocks. */
+    isPanelLoading(): boolean;
+    /** Show loading skeleton in the panel. Variant depends on contentType hint. */
+    showPanelLoading(contentType?: string): void;
+    /** Update the panel top bar navigation state. */
+    updatePanelTopBar(canBack: boolean, canForward: boolean, title: string): void;
+    getPanelTopBarTitle(): string;
+    /** Update the favorites badge count. Pass 0 to hide the badge. */
+    updateFavoritesBadge(count: number): void;
+    /**
+     * Hide the panel and clear its content. Always hides — even in force-expanded mode.
+     * Callers: _hideDrawer (stale panel cleanup), stream onDone (loading skeleton cleanup),
+     * thread navigation (no snapshot to restore). All require full hide.
+     * Keeps `_panelCollapsed` untouched so user collapse preference survives future panel renders.
+     */
+    clearPanel(): void;
+    private _syncComparisonDockVisibility;
+    /**
+     * Mobile-only slot (see CSS): pins the comparison dock above panel scroll.
+     * Pass null to clear.
+     */
+    setComparisonDockContent(el: HTMLElement | null): void;
+    /**
+     * On mobile: hide the side panel overlay without clearing its content.
+     * Shows the reopen button in the header so the user can slide the panel back in.
+     */
+    hideMobilePanel(): void;
+    private _showMobilePanelFromBtn;
+    showMobilePanel(): void;
+    /** Expand panel without locking — user can still toggle via divider. */
+    expandPanel(): void;
+    /**
+     * Ensure the panel starts expanded (panelMode: 'expanded').
+     * Users can still collapse/expand via the divider chevron.
+     */
+    setForceExpanded(): void;
+    /**
+     * Reset the left panel scroll to the top after new list/grid content is mounted.
+     * innerHTML assignment already resets scrollTop to 0; this is a defensive pin in
+     * case subsequent DOM mutations (appended children, layout) shift it.
+     */
+    private _smoothScrollPanelListToTop;
+    private _getChoicePrompterRevealScrollThreshold;
+    /** Update scroll affordance (bottom fade gradient) on the panel. */
+    private _updateScrollAffordance;
+    /** Horizontal swipe on conversation/panel areas to toggle the panel (mobile only). */
+    private _setupHorizontalSwipe;
+    /** Toggle panel between collapsed and expanded. */
+    togglePanel(): void;
+    /** Whether the panel is currently collapsed by the user. */
+    isPanelCollapsed(): boolean;
+    /** Programmatically set panel collapsed state. */
+    setPanelCollapsed(collapsed: boolean): void;
+    /** Save panel collapsed state to sessionStorage. */
+    persistPanelState(accountId: string): void;
+    /** Restore panel collapsed state from sessionStorage. Returns true when restored as collapsed. */
+    restorePanelState(accountId: string): boolean;
+    private _createLoadingSequence;
+    private _applyLoadingSteps;
+    private _clearLoadingBindingInterval;
+    private _destroyLoadingBinding;
+    private _updateSendEnabled;
+    private _renderSendButtonIcon;
+    private _submit;
+    private _toggleVoice;
+    /** Lock auto-scroll for 500ms after session history restore to prevent visual jump. */
+    lockScrollForRestore(): void;
+    /** Scroll to bottom only if user hasn't scrolled up. Force=true always scrolls. */
+    private _scrollToBottom;
+    /** Public method for typewriter ticks — scrolls only if user is near bottom. */
+    scrollToBottomIfNeeded(): void;
+    /** Update a bot message's text content in the DOM (e.g. for fallback messages). */
+    updateBotMessage(messageId: string, html: string, renderHint?: string, photoAnalysis?: {
+        summary: string;
+        strengths?: string[];
+        focusPoints?: string[];
+        celebStyle?: string;
+        celebStyleReason?: string;
+        nextQuestion?: string;
+    }): void;
+    /** Mark a message as the first bot message in its thread (for special styling). */
+    markFirstBotMessage(messageId: string): void;
+    /** Scroll to the first message of the last thread (for restore targeting). */
+    scrollToLastThread(): void;
+    /** Scroll transcript so the thread’s first visible element sits near the top; skips
+     * empty/zero-height bubbles (silent or not-yet-streamed) so real content anchors instead. */
+    scrollThreadIntoView(threadId: string, behavior?: ScrollBehavior): boolean;
+    /** Programmatic scroll to bottom (e.g. host bridge) — bypasses “user scrolled up” until next frame. */
+    scrollToBottomPresentation(behavior?: ScrollBehavior): void;
+    private _scrollMessagesTo;
+    /** Collapse transcript to a single thread (null = show full history). */
+    setPresentationFocus(threadId: string | null): void;
+    setFormerMessagesButtonVisible(visible: boolean): void;
+    setInputPlaceholder(placeholder: string): void;
+    private _applyPresentationCollapsed;
+    /** Call after inline chat DOM (e.g. ProductSummaryCard) is appended — reapplies thread collapse. */
+    refreshPresentationCollapsed(): void;
+    /** Set compact input-area chips (search/info/review shortcuts above input). */
+    setInputAreaChips(chips: Array<{
+        label: string;
+        onAction: () => void;
+        icon?: string;
+    }>): void;
+    /** Clear input-area chips. */
+    clearInputAreaChips(): void;
+    /** Activate focus trap — Tab/Shift+Tab cycles within the drawer. */
+    trapFocus(): void;
+    /** Release the focus trap and restore previously focused element. */
+    releaseFocus(): void;
+    /** Briefly animate the cart icon button to signal a successful add-to-cart. */
+    flashCartBadge(): void;
+    /** Show a temporary success toast inside the shadow root. */
+    showCartToast(message: string): void;
+    /** Clean up event listeners and child resources (VoiceInput, timers). */
+    destroy(): void;
+}

package/dist/chat/components/ChoicePrompter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Floating card that suggests the user try comparison mode.
+ *
+ * Shows in the panel bottom-right when a ProductGrid is displayed and
+ * comparison mode is not active.
+ */
+export interface ChoicePrompterOptions {
+    heading: string;
+    suggestion: string;
+    ctaLabel: string;
+    threadId: string;
+    onCtaClick: () => void;
+    onDismiss?: () => void;
+    dismissAriaLabel?: string;
+}
+export declare function createChoicePrompter(options: ChoicePrompterOptions): HTMLElement;
+/** Called when a new user search starts so the card can be shown again. */
+export declare function clearChoicePrompterDismissState(): void;
+export declare function isChoicePrompterDismissed(threadId: string): boolean;
+/** Records the same dismiss state as the CTA for external toolbar actions. */
+export declare function recordChoicePrompterDismissedForThread(threadId: string): void;

package/dist/chat/components/ComparisonTable.d.ts

@@ -0,0 +1,66 @@
+/**
+ * ComparisonTable — renders a product comparison table with recommended pick,
+ * attribute rows, highlights, and optional special cases.
+ *
+ * XSS safety: All text is set via textContent. Image URLs are validated
+ * for safe protocols before being assigned to img.src.
+ */
+import type { PriceFormatConfig } from '../../common/price-formatter.js';
+/**
+ * Map a raw criteria field name to a human-readable label.
+ * Checks locale-specific `criteriaLabels` first (from i18n), then the
+ * built-in fallback map, then applies a formatting heuristic.
+ */
+export declare function formatCriteriaName(rawName: string, criteriaLabels?: Record<string, string>, locale?: string): string;
+export interface ComparisonProduct {
+    sku: string;
+    name: string;
+    price: string;
+    url?: string | undefined;
+    imageUrl?: string | undefined;
+    rating?: number | undefined;
+    reviewCount?: number | undefined;
+}
+export interface ComparisonAttribute {
+    label: string;
+    values: string[];
+}
+interface ComparisonTableI18n {
+    comparisonHeading?: string;
+    recommendedChoiceLabel?: string;
+    highlightsLabel?: string;
+    keyDifferencesLabel?: string;
+    specialCasesLabel?: string;
+    viewMoreLabel?: string;
+    addToCartButton?: string;
+    /** Locale-specific attribute display names (e.g., { screen_size: 'Screen Size' }). */
+    criteriaLabels?: Record<string, string>;
+}
+export interface ComparisonTableOptions {
+    recommended: ComparisonProduct;
+    products: ComparisonProduct[];
+    attributes: ComparisonAttribute[];
+    highlights: string[];
+    specialCases?: string[] | undefined;
+    onProductClick: (params: {
+        sku: string;
+        name: string;
+    }) => void;
+    onAddToCart?: ((sku: string) => void) | undefined;
+    recommendedText?: string | undefined;
+    winnerHits?: Record<string, {
+        positive?: string[];
+        negative?: string[];
+    }> | undefined;
+    productActions?: Record<string, {
+        title: string;
+        type: string;
+        payload?: unknown;
+    }> | undefined;
+    keyDifferencesHtml?: string | undefined;
+    locale?: string | undefined;
+    i18n?: ComparisonTableI18n | undefined;
+    pricing?: PriceFormatConfig | undefined;
+}
+export declare function renderComparisonTable(options: ComparisonTableOptions): HTMLElement;
+export {};

package/dist/chat/components/ConsultingStylePicker.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Consulting Style Picker — renders a tabbed style variation picker
+ * for beauty consulting and grouped account-expert flows.
+ *
+ * Extracted from renderProductGrid() to keep renderUISpec.ts focused
+ * on generic component dispatch.
+ *
+ * Streaming: the first non-`loading` variation can paint immediately; later
+ * chunks update tabs + product grid in place via {@link patchConsultingStylePickerDom}
+ * so the panel is not fully replaced (no skeleton→full flash).
+ */
+import type { ChatUISpecRenderContext } from '../types.js';
+type StyleVariationProduct = Record<string, unknown>;
+export type StyleVariation = {
+    style_label?: string;
+    style_mood?: string;
+    image_url?: string;
+    status?: string;
+    product_list?: StyleVariationProduct[];
+    recommendation_groups?: Array<{
+        label?: string;
+        reason?: string;
+        skus?: string[];
+    }>;
+};
+/**
+ * Renders the consulting style picker UI (variation buttons + grouped product grid).
+ *
+ * @param wrapper   Container to append into.
+ * @param grid      The product grid element (cleared and repopulated per variation).
+ * @param styleVariations  Non-empty filtered variation list.
+ * @param ctx       Render context (i18n, callbacks).
+ */
+export declare function renderConsultingStylePicker(wrapper: HTMLElement, grid: HTMLElement, styleVariations: StyleVariation[], ctx?: ChatUISpecRenderContext): void;
+/**
+ * Apply streaming updates to an existing consulting picker without replacing the
+ * whole panel DOM. Returns false if `wrapper` is not a consulting grid shell.
+ */
+export declare function patchConsultingStylePickerDom(wrapper: HTMLElement, styleVariations: StyleVariation[], ctx?: ChatUISpecRenderContext): boolean;
+export {};

package/dist/chat/components/FloatingComparisonButton.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Slim bottom-docked comparison bar for the main panel.
+ *
+ * Keeps compare mode visible without the oversized floating prompt.
+ */
+import type { ChatUISpecRenderContext } from '../types.js';
+export declare function renderFloatingComparisonButton(selectedSkus: string[], ctx: ChatUISpecRenderContext): HTMLElement;

package/dist/chat/components/FloatingLauncher.d.ts

@@ -0,0 +1,79 @@
+/**
+ * FloatingLauncher — Customizable search-bar style launcher that mounts inside
+ * the chat widget's shadow DOM.
+ *
+ * Follows the same pattern as `makePillLauncher`: the chat widget runtime
+ * calls `createFloatingLauncher()` internally when `config.floatingLauncher`
+ * is set — no host-side `apply()` step is needed.
+ *
+ * In the injector, just pass the option through chat config:
+ *
+ *   chat: {
+ *     floatingLauncher: {
+ *       primaryColor: '#ec6e00',
+ *       placeholders: ['Ürün ara', 'Karşılaştır', 'Soru sor'],
+ *     },
+ *   }
+ */
+export interface FloatingLauncherOptions {
+    /** Brand accent color — focus ring, wave bars, border animation. Default: '#6366f1' */
+    primaryColor?: string;
+    /** Input bar background. Default: '#ffffff' */
+    backgroundColor?: string;
+    /** Input text color. Default: '#111827' */
+    textColor?: string;
+    /** Placeholder text color. Default: '#9ca3af' */
+    placeholderColor?: string;
+    /** Icon / button color. Default: '#6b7280' */
+    iconColor?: string;
+    /** Normal-state border color. Default: '#e5e7eb' */
+    borderColor?: string;
+    /** Input bar corner radius. Default: '999px' */
+    borderRadius?: string;
+    /** Input bar height. Default: '56px' */
+    height?: string;
+    /**
+     * Maximum width of the input bar.
+     * Can also be set via CSS: `--gengage-floating-launcher-max-width`.
+     * Default: '680px'
+     */
+    maxWidth?: string;
+    /** CSS font-family string. Default: 'inherit' */
+    fontFamily?: string;
+    /**
+     * Placeholder texts that cycle in sequence.
+     * Default: ['Ürün ara', 'Karşılaştır', 'Soru sor']
+     */
+    placeholders?: string[];
+    /** Milliseconds between placeholder rotations. Default: 2000 */
+    placeholderInterval?: number;
+    /**
+     * Web Speech API language code.
+     * Default: 'tr-TR'
+     */
+    voiceLang?: string;
+    /**
+     * Animate a rainbow border ring while voice recording is active.
+     * Default: true
+     */
+    showBorderAnimation?: boolean;
+    sendAriaLabel?: string;
+    micAriaLabel?: string;
+    cancelAriaLabel?: string;
+    openChatAriaLabel?: string;
+}
+export interface FloatingLauncherKit {
+    /** Root container element — the runtime appends this to the shadow DOM. */
+    readonly container: HTMLElement;
+    /**
+     * Show the "open chat" icon button. The runtime calls this after the user's
+     * first message has been successfully sent.
+     */
+    showOpenChatButton(): void;
+    /** Release all resources. Called by the widget's `destroy()`. */
+    destroy(): void;
+}
+export declare function createFloatingLauncher(options: FloatingLauncherOptions, callbacks: {
+    onSend: (text: string) => void;
+    onOpenChat: () => void;
+}, shadowRoot: ShadowRoot): FloatingLauncherKit;

package/dist/chat/components/GroundingReviewCard.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Grounding Review Card renderer.
+ *
+ * Renders a clickable card for review grounding data with title,
+ * review count, and a CTA arrow. The entire card is clickable.
+ *
+ * XSS safety: All text is set via textContent. No innerHTML.
+ */
+import type { UIElement } from '../../common/types.js';
+import type { ChatUISpecRenderContext } from '../types.js';
+export declare function renderGroundingReviewCard(element: UIElement, ctx: ChatUISpecRenderContext): HTMLElement;

package/dist/chat/components/HandoffNotice.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Renders a handoff notice when the backend escalates to a human agent.
+ *
+ * XSS safety: All text is set via textContent. No innerHTML.
+ */
+import type { ChatUISpecRenderContext } from '../types.js';
+export declare function renderHandoffNotice(element: {
+    props?: Record<string, unknown>;
+}, context: ChatUISpecRenderContext): HTMLElement;

package/dist/chat/components/KvkkBanner.d.ts

@@ -0,0 +1,6 @@
+export interface KvkkBannerOptions {
+    htmlContent: string;
+    onDismiss: () => void;
+    closeAriaLabel?: string;
+}
+export declare function createKvkkBanner(options: KvkkBannerOptions): HTMLElement;

package/dist/chat/components/Launcher.d.ts

@@ -0,0 +1,28 @@
+export interface LauncherOptions {
+    onClick: () => void;
+    svgMarkup?: string;
+    /** Full-size image URL — renders launcher as an image button (no circular bg). */
+    imageUrl?: string;
+    /** Mobile-specific image URL. When set, shown on mobile; `imageUrl` shown on desktop. */
+    mobileImageUrl?: string;
+    ariaLabel?: string;
+    hideMobile?: boolean;
+    mobileBreakpoint?: number;
+    tooltip?: string;
+}
+/**
+ * Result of createLauncher — the container wraps the button and exposes
+ * content-area slots where the QNA widget or host page can inject engagement
+ * actions (buying-hesitation questions, "Find Similar" buttons, etc.).
+ */
+export interface LauncherElements {
+    /** Outer container — append this to the DOM. */
+    container: HTMLElement;
+    /** The clickable FAB button. */
+    button: HTMLButtonElement;
+    /** Slot above the button (primary QNA actions). */
+    contentArea: HTMLElement;
+    /** Slot below the button (secondary content). */
+    contentAreaBottom: HTMLElement;
+}
+export declare function createLauncher(options: LauncherOptions): LauncherElements;

package/dist/chat/components/PanelRestoreCard.d.ts

@@ -0,0 +1,4 @@
+import type { UIElement } from '../../common/types.js';
+import type { ChatUISpecRenderContext } from '../types.js';
+export declare const FRONTEND_PANEL_RESTORE_ACTION = "frontend_restore_panel_message";
+export declare function renderPanelRestoreCard(element: UIElement, ctx: ChatUISpecRenderContext): HTMLElement;

package/dist/chat/components/PanelTopBar.d.ts

@@ -0,0 +1,32 @@
+/**
+ * PanelTopBar — navigation bar at the top of the panel pane.
+ *
+ * Shows back/forward arrow buttons and a title derived from the current
+ * panel content type.  On mobile a close (✕) button is also rendered so
+ * users can dismiss all panel layers with a single tap and return to the
+ * conversation, without having to navigate back through every history entry.
+ */
+export interface PanelTopBarOptions {
+    onBack: () => void;
+    onForward: () => void;
+    /** Called when the mobile close (✕) button is tapped. Should clear all panel history. */
+    onClose?: () => void;
+    backAriaLabel?: string;
+    forwardAriaLabel?: string;
+    /** Aria label for the close button (mobile only). */
+    closePanelAriaLabel?: string;
+}
+export declare class PanelTopBar {
+    private _el;
+    private _backBtn;
+    private _forwardBtn;
+    private _titleEl;
+    private _actionsEl;
+    private _closeBtn;
+    constructor(options: PanelTopBarOptions);
+    update(canBack: boolean, canForward: boolean, title: string): void;
+    getElement(): HTMLElement;
+    setTitle(title: string): void;
+    setActions(actionsEl: HTMLElement | null): void;
+    getTitle(): string;
+}