@gengage/assistant-fe 0.3.35 → 0.3.36

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

@@ -73,6 +73,9 @@ export interface ChatDrawerOptions {
         onReleasePresentationFocus?: () => void;
     };
 }
+type SetPanelContentOptions = {
+    preserveAiZone?: boolean;
+};
 export declare class ChatDrawer {
     private root;
     private messagesEl;
@@ -116,8 +119,6 @@ export declare class ChatDrawer {
     private _voiceEnabled;
     private _voiceLang;
     private _ignoreNextDividerClick;
-    /** Cancels in-flight panel list scroll-to-top tween when a new one starts. */
-    private _panelListScrollAnimToken;
     private readonly _cleanups;
     private _focusTrapHandler;
     private _previouslyFocusedElement;
@@ -216,12 +217,20 @@ export declare class ChatDrawer {
         resultEl?: HTMLElement;
         analyzingLabel?: string;
     }): void;
+    private _clearPanelAiZoneState;
     private _resetPanelAiZoneElement;
     private _emitHostShellSync;
     private _syncPanelTopBarFromContent;
     private _syncPanelTopBarTitleFromContent;
     /** Replace panel content and show the panel. */
-    setPanelContent(el: HTMLElement): void;
+    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 /
+     * thumbnails column / 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. */
@@ -265,9 +274,9 @@ export declare class ChatDrawer {
      */
     setForceExpanded(): void;
     /**
-     * After new list/grid content is mounted, scroll the left panel toward the top smoothly.
-     * InnerHTML resets scrollTop to 0, so we nudge down first; a rAF tween (ease-out quint) replaces
-     * native smooth scroll for a softer deceleration.
+     * 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;
     /** Update scroll affordance (bottom fade gradient) on the panel. */
@@ -312,10 +321,8 @@ export declare class ChatDrawer {
     markFirstBotMessage(messageId: string): void;
     /** Scroll to the first message of the last thread (for restore targeting). */
     scrollToLastThread(): void;
-    /**
-     * Smooth scroll transcript so the given thread’s first bubble is near the top.
-     * Used by centralized presentation scroll requests.
-     */
+    /** 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;

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

@@ -4,7 +4,7 @@ import { PriceFormatConfig } from '../../common/price-formatter.js';
  * 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>): string;
+export declare function formatCriteriaName(rawName: string, criteriaLabels?: Record<string, string>, locale?: string): string;
 export interface ComparisonProduct {
     sku: string;
     name: string;
@@ -50,6 +50,7 @@ export interface ComparisonTableOptions {
         payload?: unknown;
     }> | undefined;
     keyDifferencesHtml?: string | undefined;
+    locale?: string | undefined;
     i18n?: ComparisonTableI18n | undefined;
     pricing?: PriceFormatConfig | undefined;
 }

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

@@ -16,3 +16,13 @@ export declare function detectConsultingGrid(element: UIElement): ConsultingGrid
  * Call only when `detectConsultingGrid` returned `isConsulting: true`.
  */
 export declare function renderConsultingGrid(wrapper: HTMLElement, grid: HTMLElement, detected: ConsultingGridResult, ctx?: ChatUISpecRenderContext): void;
+/**
+ * Whether every variation in a consulting grid has completed (not `loading`).
+ *
+ * Backend may stream a consulting ProductGrid twice in one response: once
+ * with some variations still `loading`, then again with everything `ready`.
+ * The panel renderer uses this to skip the partial render and avoid a
+ * skeleton→partial→final flash; the skeleton stays visible until every
+ * variation is ready (or the stream ends with the partial spec as fallback).
+ */
+export declare function isConsultingGridReady(detected: ConsultingGridResult): boolean;

package/dist/chat/index.d.ts

@@ -1,4 +1,4 @@
-import { ActionPayload, PageContext } from '../common/types.js';
+import { ActionPayload, PageContext, UIElement } from '../common/types.js';
 import { BaseWidget } from '../common/widget-base.js';
 import { ChatWidgetConfig } from './types.js';
 import { AssistantMode } from './assistant-mode.js';
@@ -18,6 +18,7 @@ import { AssistantMode } from './assistant-mode.js';
  * chat.open(); // Programmatically open the drawer
  * ```
  */
+export declare function isSimilarsAppendGrid(element: UIElement | undefined): boolean;
 export declare class GengageChat extends BaseWidget<ChatWidgetConfig> {
     private static readonly _MAX_COMPARISON_SELECTION;
     private _shadow;
@@ -169,6 +170,8 @@ export declare class GengageChat extends BaseWidget<ChatWidgetConfig> {
     private _clearAssistantPanelLikeStreamClearPanel;
     private _flushPresentationScroll;
     private _focusPresentationThread;
+    /** Align inline UISpec render so the thread’s first visible node stays at the top. */
+    private _scrollInlineIntoView;
     private _releasePresentationFocus;
     private _hasMultipleThreadIds;
     private _orderedThreadIds;

package/dist/chat/session-persistence.d.ts

@@ -4,6 +4,7 @@ import { BackendContext, UISpec } from '../common/types.js';
 import { ChatMessage } from './types.js';
 import { ThumbnailEntry } from './components/ThumbnailsColumn.js';
 export type { FavoriteData };
+type NavigateFn = (url: string) => void;
 export interface PersistSessionParams {
     userId: string;
     appId: string;
@@ -44,7 +45,7 @@ export declare class SessionPersistence {
      * after posting saveSessionAndOpenURL to the iframe. The clean-room runs in
      * the same window (Shadow DOM, not iframe), so it navigates directly.
      */
-    saveAndOpenURL(url: string, persistFn: () => Promise<void>, bridge: CommunicationBridge | null): Promise<void>;
+    saveAndOpenURL(url: string, persistFn: () => Promise<void>, bridge: CommunicationBridge | null, navigate?: NavigateFn): Promise<void>;
     /**
      * Load a UISpec payload from IndexedDB with retry logic.
      * Returns null if not found or all retries fail.

package/dist/chat/types.d.ts

@@ -329,6 +329,7 @@ export interface ProductPriceUiConfig {
     campaignBadgeLogoUrl?: string;
 }
 export interface ChatUISpecRenderContext {
+    locale?: string | undefined;
     onAction: (action: ActionPayload) => void;
     onProductClick?: (params: {
         sku: string;