@gengage/assistant-fe 0.4.20 → 0.4.21

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

@@ -1,28 +0,0 @@
-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

@@ -1,4 +0,0 @@
-import { UIElement } from '../../common/types.js';
-import { 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

@@ -1,32 +0,0 @@
-/**
- * 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;
-}

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

@@ -1,20 +0,0 @@
-import { UIElement } from '../../common/types.js';
-import { ChatUISpecRenderContext } from '../types.js';
-export interface PhotoAnalysisData {
-    summary: string;
-    strengths?: string[];
-    focusPoints?: string[];
-    celebStyle?: string;
-    celebStyleReason?: string;
-    nextQuestion?: string;
-}
-/** Extract structured photo-analysis data from a UISpec element's props. */
-export declare function parsePhotoAnalysisProps(props: Record<string, unknown>): PhotoAnalysisData | null;
-export declare function renderPhotoAnalysisCard(element: UIElement, ctx: ChatUISpecRenderContext): HTMLElement;
-/** Renders the structured PhotoAnalysisCard data captured from the UISpec. */
-export declare function renderPhotoAnalysisBubble(container: HTMLElement, labels: {
-    badge: string;
-    strengths: string;
-    focus: string;
-    celebStyle: string;
-}, structured?: PhotoAnalysisData): void;

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

@@ -1,3 +0,0 @@
-import { UIElement } from '../../common/types.js';
-import { ChatUISpecRenderContext } from '../types.js';
-export declare function renderProductSummaryCard(element: UIElement, ctx: ChatUISpecRenderContext): HTMLElement;

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

@@ -1,8 +0,0 @@
-/**
- * Renders a Pros & Cons list for a product.
- *
- * XSS safety: All text is set via textContent. No innerHTML.
- */
-export declare function renderProsAndCons(element: {
-    props?: Record<string, unknown>;
-}): HTMLElement;

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

@@ -1,9 +0,0 @@
-import { UIElement } from '../../common/types.js';
-export declare function renderReviewHighlights(element: UIElement, options?: {
-    emptyReviewsMessage?: string | undefined;
-    reviewFilterPositive?: string | undefined;
-    reviewFilterNegative?: string | undefined;
-    reviewCustomersMentionSingular?: string | undefined;
-    reviewCustomersMentionPlural?: string | undefined;
-    reviewSubjectsHeading?: string | undefined;
-}): HTMLElement;

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

@@ -1,12 +0,0 @@
-/**
- * Classifies suggested actions into input-area chips vs message-flow pills.
- *
- * Input-area chips: compact shortcuts above the input field (search, info, review, similar).
- * Message-flow pills: larger interactive cards in the suggestion row.
- */
-export declare function isInputAreaAction(btn: {
-    icon?: string;
-    action?: {
-        type?: string;
-    };
-}): boolean;

package/dist/chat/components/product-price-layout.d.ts

@@ -1,18 +0,0 @@
-import { ChatUISpecRenderContext, ProductPriceOriginalStyle } from '../types.js';
-export declare function discountReasonFromProduct(product: Record<string, unknown> | undefined): string | undefined;
-export declare function campaignReasonForDisplay(ctx: ChatUISpecRenderContext, product: Record<string, unknown> | undefined): string | undefined;
-/**
- * Per-product `originalPriceStyle` / `price_original_style` override config.
- * Default `strikethrough`; `inline` uses a separator row without a strike line.
- */
-export declare function resolveOriginalPriceStyle(ctx: ChatUISpecRenderContext, product: Record<string, unknown> | undefined): ProductPriceOriginalStyle;
-export declare function createCampaignReasonElement(text: string): HTMLDivElement;
-export declare function resolveCampaignBadgeLogoUrl(ctx: ChatUISpecRenderContext, product: Record<string, unknown> | undefined): string | undefined;
-/**
- * Single bordered badge: optional logo, campaign line (body text), sale price — gradient border, transparent fill.
- */
-export declare function createCampaignPriceBadge(options: {
-    reasonText: string;
-    salePriceFormatted: string;
-    logoUrl?: string;
-}): HTMLElement;

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

@@ -1,25 +0,0 @@
-/**
- * Product mention linker.
- *
- * After sanitiseHtml() renders bot text, this module walks text nodes and
- * wraps product name occurrences with clickable links that dispatch a
- * `launchSingleProduct` action.
- *
- * XSS safety: Uses DOM text-node manipulation only — no innerHTML.
- */
-export interface ProductMention {
-    sku: string;
-    short_name: string;
-}
-export interface ProductMentionLinkerOptions {
-    container: HTMLElement;
-    mentions: ProductMention[];
-    onProductClick: (sku: string) => void;
-}
-/**
- * Walk text nodes in `container` and wrap occurrences of each mention's
- * `short_name` with a clickable `<a>` element.
- *
- * Only the first occurrence of each mention is linked to avoid visual clutter.
- */
-export declare function linkProductMentions(options: ProductMentionLinkerOptions): void;

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

@@ -1,11 +0,0 @@
-import { UISpec, UIElement } from '../../common/types.js';
-import { UISpecDomRegistry, UISpecDomUnknownRenderer } from '../../common/renderer/index.js';
-import { ChatUISpecRenderContext } from '../types.js';
-import { PriceFormatConfig } from '../../common/price-formatter.js';
-export type UISpecRenderContext = ChatUISpecRenderContext;
-export type ChatUISpecRegistry = UISpecDomRegistry<UISpecRenderContext>;
-export type { PriceFormatConfig };
-export declare const defaultChatUnknownUISpecRenderer: UISpecDomUnknownRenderer<UISpecRenderContext>;
-export declare function createDefaultChatUISpecRegistry(): ChatUISpecRegistry;
-export declare function renderUISpec(spec: UISpec, ctx: UISpecRenderContext, registry?: ChatUISpecRegistry, unknownRenderer?: UISpecDomUnknownRenderer<UISpecRenderContext>): HTMLElement;
-export declare function renderProductCard(element: UIElement, ctx: UISpecRenderContext): HTMLElement;

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

@@ -1,24 +0,0 @@
-/**
- * Block-by-block HTML typewriter effect.
- *
- * Parses sanitised HTML into top-level blocks and reveals them one at a time
- * with a configurable stagger delay. Respects prefers-reduced-motion.
- */
-export interface TypewriterOptions {
-    container: HTMLElement;
-    html: string;
-    /** Delay in ms between block reveals (default: 30). */
-    delayMs?: number;
-    /** Called after each block is revealed — useful for scroll tracking. */
-    onTick?: () => void;
-    /** Called when all blocks have been revealed. */
-    onComplete?: () => void;
-}
-export interface TypewriterHandle {
-    /** Skip animation and show all content immediately. */
-    complete(): void;
-    /** Cancel animation, leave content as-is. */
-    cancel(): void;
-    readonly isRunning: boolean;
-}
-export declare function typewriteHtml(options: TypewriterOptions): TypewriterHandle;

package/dist/chat/extendedModeManager.d.ts

@@ -1,32 +0,0 @@
-/**
- * Extended Mode Manager — production lock-count system for panel extension.
- *
- * Controls whether the host page PDP area should be maximized or minimized
- * based on a combination of conditions: lock count, user visibility preference,
- * favorites mode, panel content type, and chat visibility.
- */
-export type PanelContentType = 'comparisonTable' | 'groupList' | 'productDetails' | 'productDetailsSimilars' | 'productList';
-export interface ExtendedModeManagerOptions {
-    onChange: (extended: boolean) => void;
-    /** Whether `productDetails` should trigger panel extension (default: false, true for demo sites). */
-    productDetailsInPanel?: boolean;
-}
-export declare class ExtendedModeManager {
-    private _lockCount;
-    private _hiddenByUser;
-    private _lastPanelContentType;
-    private _chatShown;
-    private _isFavoritesMode;
-    private _lastExtended;
-    private _onChange;
-    private _panelContentTypes;
-    constructor(options: ExtendedModeManagerOptions);
-    get isExtended(): boolean;
-    unlock(): void;
-    lock(): void;
-    setHiddenByUser(hidden: boolean): void;
-    setChatShown(shown: boolean): void;
-    setFavoritesMode(fav: boolean): void;
-    setPanelContentType(type: PanelContentType | null): void;
-    private _checkStateChange;
-}

package/dist/chat/features/beauty-consulting/consulting-grid.d.ts

@@ -1,31 +0,0 @@
-import { UIElement } from '../../../common/types.js';
-import { ChatUISpecRenderContext } from '../../types.js';
-import { StyleVariation } from '../../components/ConsultingStylePicker.js';
-export interface ConsultingGridResult {
-    isConsulting: boolean;
-    source: string | undefined;
-    styleVariations: StyleVariation[];
-}
-/**
- * Check whether a ProductGrid element should render as a consulting style picker.
- * Returns the check result plus pre-parsed data for {@link renderConsultingGrid}.
- */
-export declare function detectConsultingGrid(element: UIElement): ConsultingGridResult;
-/**
- * Render a consulting style picker into the ProductGrid wrapper.
- * Call only when `detectConsultingGrid` returned `isConsulting: true`.
- */
-export declare function renderConsultingGrid(wrapper: HTMLElement, grid: HTMLElement, detected: ConsultingGridResult, ctx?: ChatUISpecRenderContext): void;
-/**
- * Whether at least one variation is not actively `loading`, so the panel can
- * paint the first ready style immediately (fast-first). Remaining `loading`
- * tabs stream in and update in place via {@link patchConsultingGridDom} without
- * replacing the whole panel.
- */
-export declare function isConsultingGridReady(detected: ConsultingGridResult): boolean;
-/**
- * Apply a streaming consulting ProductGrid update to the visible panel without
- * `setPanelContent` (avoids full DOM swap / blink). Returns false if the
- * panel is not currently showing a consulting picker.
- */
-export declare function patchConsultingGridDom(wrapper: HTMLElement, detected: ConsultingGridResult, ctx?: ChatUISpecRenderContext): boolean;

package/dist/chat/features/beauty-consulting/drawer-extensions.d.ts

@@ -1,20 +0,0 @@
-import { ChatI18n } from '../../types.js';
-export interface BeautyPhotoStepCardOptions {
-    visible: boolean;
-    processing?: boolean;
-    onSkip?: (() => void) | undefined;
-    title?: string | undefined;
-    description?: string | undefined;
-    uploadLabel?: string | undefined;
-    skipLabel?: string | undefined;
-}
-/**
- * Lazily create the beauty photo step slot element and insert it before
- * the input area. Returns the created or existing element.
- */
-export declare function ensureBeautyPhotoStepSlot(existing: HTMLElement | null, conversationEl: HTMLElement | null): HTMLElement;
-/**
- * Show or hide the beauty photo step card.
- * Returns the slot element (possibly newly created).
- */
-export declare function applyBeautyPhotoStepCard(slotEl: HTMLElement | null, conversationEl: HTMLElement | null, options: BeautyPhotoStepCardOptions, i18n: ChatI18n, openAttachmentPicker: () => void): HTMLElement | null;

package/dist/chat/features/beauty-consulting/mode-controller.d.ts

@@ -1,53 +0,0 @@
-import { AssistantMode } from '../../assistant-mode.js';
-/**
- * Minimal drawer interface consumed by the mode controller.
- * Keeps the controller decoupled from ChatDrawer internals.
- */
-export interface ModeDrawerAdapter {
-    setAttachmentControlsVisible(visible: boolean): void;
-    setInputPlaceholder(text: string): void;
-    setBeautyPhotoStepCard(options: {
-        visible: boolean;
-    }): void;
-}
-export declare class AssistantModeController {
-    private _mode;
-    private _uiHints;
-    get mode(): AssistantMode;
-    set mode(value: AssistantMode);
-    get uiHints(): Record<string, unknown> | null;
-    set uiHints(value: Record<string, unknown> | null);
-    get isShopping(): boolean;
-    get isBeautyConsulting(): boolean;
-    /** Whether choice prompter is hidden by backend ui_hints. */
-    get isChoicePrompterHidden(): boolean;
-    /**
-     * Apply backend ui_hints to the drawer.
-     *
-     * @param drawer  Drawer adapter (null when drawer not yet created).
-     * @param defaultPlaceholder  Default input placeholder for shopping mode.
-     * @param removePersistentChoicePrompter  Callback to remove persistent choice prompter from Shadow DOM.
-     */
-    applyUiHints(drawer: ModeDrawerAdapter | null, defaultPlaceholder: string, removePersistentChoicePrompter?: () => void): void;
-    /**
-     * Handle redirect metadata from a backend metadata event.
-     * Returns true if the mode actually switched.
-     */
-    handleRedirect(redirectPayload: unknown): boolean;
-    /** Switch to a new assistant mode. */
-    switchMode(mode: AssistantMode): void;
-    /**
-     * Derive mode and ui_hints from a backend CONTEXT panel payload.
-     * Missing `assistant_mode` field preserves current mode (old backends).
-     * Explicit `null` resets to shopping.
-     */
-    updateFromContext(panel: Record<string, unknown>): void;
-    /**
-     * Reset to shopping mode. Returns true if mode was non-shopping before reset.
-     */
-    reset(): boolean;
-    /** Resolve attachment action type based on current mode. */
-    resolveAttachmentActionType(): 'user_message' | 'findSimilar';
-    /** Non-shopping modes condense thinking step lists. */
-    shouldCondenseThinking(): boolean;
-}

package/dist/chat/features/beauty-consulting/registry.d.ts

@@ -1,3 +0,0 @@
-import { UISpecDomRegistry } from '../../../common/renderer/index.js';
-import { ChatUISpecRenderContext } from '../../types.js';
-export declare const beautyConsultingRegistry: Partial<UISpecDomRegistry<ChatUISpecRenderContext>>;

package/dist/chat/features/beauty-consulting/stream-handler.d.ts

@@ -1,38 +0,0 @@
-import { PhotoAnalysisData } from '../../components/PhotoAnalysisCard.js';
-import { ChatMessage } from '../../types.js';
-/** Per-stream state for beauty consulting features. */
-export interface BeautyStreamState {
-    streamIncludedBeautyPhotoStep: boolean;
-    pendingPhotoStepSkip: boolean;
-}
-export declare function createBeautyStreamState(): BeautyStreamState;
-/** Callbacks needed by the beauty stream handler. */
-export interface BeautyStreamContext {
-    drawer: {
-        updateBotMessage(messageId: string, html: string, renderHint?: string, photoAnalysis?: PhotoAnalysisData): void;
-        setBeautyPhotoStepCard(options: {
-            visible: boolean;
-            processing?: boolean;
-            onSkip?: (() => void) | undefined;
-            title?: string | undefined;
-            description?: string | undefined;
-            uploadLabel?: string | undefined;
-            skipLabel?: string | undefined;
-        }): void;
-    } | null;
-    ensureRendered: () => void;
-    cancelTypewriter: () => void;
-    sendSkipMessage: () => void;
-    streamDone: boolean;
-}
-/**
- * Handle a beauty-specific UISpec component during stream processing.
- * Returns true if the component was handled (caller should `return`).
- */
-export declare function handleBeautyUISpec(componentType: string, rootElementProps: Record<string, unknown>, state: BeautyStreamState, ctx: BeautyStreamContext, botMsg: ChatMessage): boolean;
-/** Returns true if the bot message should render as a photo analysis card. */
-export declare function isPhotoAnalysisMessage(botMsg: ChatMessage): boolean;
-/** Flush pending beauty photo step state on stream complete. */
-export declare function flushBeautyStreamComplete(state: BeautyStreamState, ctx: BeautyStreamContext): void;
-/** Flush pending beauty photo step skip on stream error. */
-export declare function flushBeautyStreamError(state: BeautyStreamState, ctx: BeautyStreamContext): void;

package/dist/chat/history-storage.d.ts

@@ -1,85 +0,0 @@
-import { BackendContext, UISpec } from '../common/types.js';
-import { ChatMessage } from './types.js';
-type LegacyThumbnailEntry = {
-    sku: string;
-    imageUrl: string;
-    threadId: string;
-};
-export interface StoredHistoryMessage {
-    id: string;
-    threadId?: string | undefined;
-    role: 'user' | 'assistant';
-    content?: string | undefined;
-    uiSpec?: UISpec | undefined;
-    frontendOnly?: boolean | undefined;
-    silent?: boolean | undefined;
-    renderHint?: string | undefined;
-    photoAnalysis?: {
-        summary: string;
-        strengths?: string[];
-        focusPoints?: string[];
-        celebStyle?: string;
-        celebStyleReason?: string;
-        nextQuestion?: string;
-    } | undefined;
-    timestamp: number;
-    status: 'done' | 'error';
-}
-export interface ChatHistoryIndexEntry {
-    id: string;
-    title: string;
-    preview: string;
-    createdAt: string;
-    updatedAt: string;
-    messageCount: number;
-    pageType?: string | undefined;
-    sku?: string | undefined;
-    sourceSessionId: string;
-}
-export interface ChatHistorySessionRecord extends ChatHistoryIndexEntry {
-    version: number;
-    userId: string;
-    appId: string;
-    messages: StoredHistoryMessage[];
-    currentThreadId: string | null;
-    lastThreadId: string | null;
-    panelThreads?: string[] | undefined;
-    /** Legacy thumbnail-strip data kept optional for backward compatibility with older local history. */
-    thumbnailEntries?: LegacyThumbnailEntry[] | undefined;
-    panelSnapshotHtml?: Record<string, string> | undefined;
-    panelSnapshotTypes?: Record<string, string> | undefined;
-    panelAiSpecByThread?: Record<string, UISpec> | undefined;
-    lastBackendContext: BackendContext | null;
-}
-export interface SaveHistorySessionParams {
-    historyId: string;
-    userId: string;
-    appId: string;
-    sourceSessionId: string;
-    messages: ChatMessage[];
-    currentThreadId: string | null;
-    lastThreadId: string | null;
-    chatCreatedAt: string;
-    panelSnapshots: Map<string, HTMLElement>;
-    panelSnapshotTypes: Map<string, string>;
-    panelThreads: string[];
-    panelAiSpecByThread?: Map<string, UISpec> | undefined;
-    lastBackendContext: BackendContext | null;
-    pageType?: string | undefined;
-    sku?: string | undefined;
-}
-export declare class ChatHistoryStorage {
-    private readonly _appId;
-    private readonly _userId;
-    private readonly _storage;
-    private readonly _scope;
-    constructor(_appId: string, _userId: string, _storage?: Storage | null);
-    createHistoryId(): string;
-    findSessionId(sourceSessionId: string, createdAt: string): string | null;
-    listSessions(): ChatHistoryIndexEntry[];
-    loadSession(historyId: string): ChatHistorySessionRecord | null;
-    saveSession(params: SaveHistorySessionParams): ChatHistorySessionRecord | null;
-    deleteSession(historyId: string): void;
-    private _commitRecord;
-}
-export {};

package/dist/chat/index.d.ts

@@ -1,5 +0,0 @@
-export * from './runtime.js';
-export { chatCatalog } from './catalog.js';
-export type { ChatCatalog, ChatComponentName } from './catalog.js';
-export { createFloatingLauncher } from './components/FloatingLauncher.js';
-export type { FloatingLauncherOptions } from './components/FloatingLauncher.js';

package/dist/chat/kvkk.d.ts

@@ -1,20 +0,0 @@
-/**
- * KVKK notice filtering and caching helpers.
- *
- * KVKK (Kişisel Verilerin Korunması Kanunu) is Turkey's data protection law.
- * When the backend streams a response containing a KVKK notice, we:
- * 1. Strip the KVKK block from the visible bot text
- * 2. Show a banner on first encounter (per account)
- * 3. Mark it as shown in localStorage to avoid repeat banners
- */
-export declare function containsKvkk(html: string): boolean;
-export declare function isKvkkShown(accountId: string): boolean;
-export declare function markKvkkShown(accountId: string): void;
-/**
- * Strip the KVKK portion from bot HTML.
- * KVKK is typically wrapped in a `<div style="...">` at the start.
- * We remove the first block-level element that contains a KVKK marker.
- */
-export declare function stripKvkkBlock(html: string): string;
-export declare function extractKvkkBlock(html: string): string | null;
-export declare function localeToOutputLanguage(locale?: string): string;

package/dist/chat/locales/en.d.ts

@@ -1,2 +0,0 @@
-import { ChatI18n } from '../types.js';
-export declare const CHAT_I18N_EN: ChatI18n;

package/dist/chat/locales/index.d.ts

@@ -1,5 +0,0 @@
-import { ChatI18n } from '../types.js';
-import { CHAT_I18N_TR } from './tr.js';
-import { CHAT_I18N_EN } from './en.js';
-export declare function resolveChatLocale(locale?: string): ChatI18n;
-export { CHAT_I18N_TR, CHAT_I18N_EN };

package/dist/chat/locales/tr.d.ts

@@ -1,2 +0,0 @@
-import { ChatI18n } from '../types.js';
-export declare const CHAT_I18N_TR: ChatI18n;

package/dist/chat/panel-manager.d.ts

@@ -1,126 +0,0 @@
-import { ChatDrawer } from './components/ChatDrawer.js';
-import { CommunicationBridge } from '../common/communication-bridge.js';
-import { ExtendedModeManager } from './extendedModeManager.js';
-import { ChatI18n } from './types.js';
-import { UISpec } from '../common/types.js';
-/** Minimal interface the panel manager needs from its host widget. */
-export interface PanelManagerDeps {
-    drawer: () => ChatDrawer | null;
-    shadow: () => ShadowRoot | null;
-    currentThreadId: () => string | null;
-    bridge: () => CommunicationBridge | null;
-    extendedModeManager: () => ExtendedModeManager | null;
-    i18n: () => ChatI18n;
-    rollbackToThread: (threadId: string) => void;
-}
-/**
- * Rebuild source for local drilldown history and stream-end snapshots.
- * `productDetailsWithSimilars` keeps PDP + appended similar grid in sync when
- * similars arrive in a second stream chunk (DOM append does not update `spec` alone).
- */
-export type PanelSource = {
-    kind: 'spec';
-    spec: UISpec;
-} | {
-    kind: 'productDetailsWithSimilars';
-    pdpSpec: UISpec;
-    similarsSpec: UISpec;
-} | {
-    kind: 'favorites';
-} | {
-    kind: 'history';
-};
-export type PanelSnapshotOptions = {
-    rebuild?: (() => HTMLElement) | undefined;
-    source?: PanelSource | undefined;
-    threadId?: string | undefined;
-};
-export declare class PanelManager {
-    private readonly deps;
-    /** Panel content snapshots keyed by bot message ID for history navigation. */
-    readonly snapshots: Map<string, HTMLElement>;
-    /** Rebuild functions keyed by message ID — produce fresh DOM with live event listeners. */
-    private readonly _snapshotRebuilders;
-    private readonly _snapshotSources;
-    private readonly _threadSources;
-    /** Component type for each panel snapshot (for topbar title restoration). */
-    readonly snapshotTypes: Map<string, string>;
-    /** Currently active (highlighted) message ID in the chat pane. */
-    activePanelMessageId: string | null;
-    /** Current panel component type. */
-    currentType: string | null;
-    /** Thread IDs that have panel content, in order of creation. */
-    threads: string[];
-    /** Action type that triggered the current stream (for panel title disambiguation). */
-    lastActionType: string | null;
-    constructor(deps: PanelManagerDeps);
-    clearSnapshots(): void;
-    sourceForMessage(messageId: string): PanelSource | null;
-    sourceForThread(threadId: string): PanelSource | null;
-    componentTypeForSource(source: PanelSource): string;
-    /**
-     * Snapshot the current panel state for a message. Stores a rebuild function
-     * (preferred — produces fresh DOM with live event listeners) alongside a
-     * static DOM clone as fallback.
-     */
-    snapshotForMessage(messageId: string, options?: PanelSnapshotOptions | (() => HTMLElement) | undefined): void;
-    /**
-     * Restore the panel content snapshot associated with a given message ID.
-     * Highlights the active message and de-highlights the previous one.
-     * Also restores the panel topbar title for the snapshot's component type.
-     * Returns true if the snapshot was found and restored.
-     */
-    restoreForMessage(messageId: string, highlightMessageId?: string): boolean;
-    /**
-     * Send maximize-pdp / minify-pdp bridge messages with production-matching delays.
-     * Called by the extended mode manager when panel extension state changes.
-     */
-    notifyExtension(extended: boolean): void;
-    /**
-     * Derive panel title from UISpec root element type using i18n strings.
-     * When the backend provides a `panelTitle` prop, it takes precedence.
-     */
-    titleForComponent(componentType: string, backendTitle?: string): string;
-    /**
-     * Update the panel top bar navigation state and title.
-     * When the backend provides a `panelTitle`, it takes precedence over i18n defaults.
-     */
-    /** @param displayTitle When passed (including empty string), used instead of titleForComponent. */
-    updateTopBar(componentType: string, backendTitle?: string, displayTitle?: string): void;
-    /**
-     * Set panel topbar title during loading (before actual panel content arrives).
-     * Maps backend pending types to the same i18n titles used for final content.
-     */
-    updateTopBarForLoading(pendingType: string): void;
-    /**
-     * Map UISpec component types to PanelContentType for the extended mode manager.
-     */
-    updateExtendedMode(componentType: string): void;
-    /** Navigate to the previous panel thread. */
-    navigateBack(): void;
-    /** Navigate to the next panel thread. */
-    navigateForward(): void;
-    /**
-     * Panel route shaping:
-     * - product details => expanded LHS panel (`ProductDetailsPanel`)
-     * - all other panel-routed specs keep their original component types
-     */
-    toPanelSpec(spec: UISpec): UISpec;
-    destroy(): void;
-}
-/**
- * Decide how to apply incoming panel UISpec content.
- *
- * - `'replace'` — set as sole panel content (new search, comparison, product details)
- * - `'append'` — add below existing content (similar products grid after product details)
- * - `'appendSimilars'` — append via the dedicated similars helper
- */
-export type PanelUpdateAction = 'replace' | 'append' | 'appendSimilars';
-export declare function determinePanelUpdateAction(opts: {
-    componentType: string;
-    similarsAppend: boolean;
-    currentPanelType: string | null;
-    hasPanelContent: boolean;
-    isPanelLoading: boolean;
-    isFirstPanelContentInStream: boolean;
-}): PanelUpdateAction;