@gengage/assistant-fe 0.5.7 → 0.6.0

package/dist/native.js

@@ -1,4 +1,4 @@
-import { a, i, n as t, r, t as s } from "./native-webview-qfjm4SHx.js";
+import { a, i, n as t, r, t as s } from "./native-webview-JDC1vtde.js";
 export {
   s as DEFAULT_NATIVE_TRACKED_EVENTS,
   t as applyNativeSession,

package/dist/{overlay-CP5A0Hhf.js → overlay-BetAvpVZ.js}

@@ -72,16 +72,16 @@ var q = class {
   }
   async _initChat() {
     if (this.options.chat?.enabled === !1) return;
-    const i = this.options.middlewareUrl, e = this.options.chat?.productDetailsExtended ?? this.options.productDetailsExtended, s = this.options.chat?.isDemoWebsite ?? this.options.isDemoWebsite, t = {
+    const i = this.options.middlewareUrl, e = this.options.chat?.productDetailsExtended ?? this.options.productDetailsExtended, s = this.options.chat?.isDemoWebsite ?? this.options.isDemoWebsite, a = this.options.chat?.injectorAdapter ?? this.options.injectorAdapter, t = {
       accountId: this.options.accountId,
       middlewareUrl: i,
       session: this.session,
       pageContext: this._pageContext,
       variant: this.options.chat?.variant ?? "floating"
     };
-    this.options.theme !== void 0 && (t.theme = this.options.theme), this.options.locale !== void 0 && (t.locale = this.options.locale), this.options.pricing !== void 0 && (t.pricing = this.options.pricing), this.options.chat?.mountTarget !== void 0 && (t.mountTarget = this.options.chat.mountTarget), this.options.chat?.pillLauncher !== void 0 && (t.pillLauncher = this.options.chat.pillLauncher), this.options.chat?.floatingLauncher !== void 0 && (t.floatingLauncher = this.options.chat.floatingLauncher), this.options.chat?.launcherAnchor !== void 0 && (t.launcherAnchor = this.options.chat.launcherAnchor), this.options.chat?.launcherImageUrl !== void 0 ? t.launcherImageUrl = this.options.chat.launcherImageUrl : this.options.chat?.launcherSvg !== void 0 && (t.launcherSvg = this.options.chat.launcherSvg), this.options.chat?.mobileLauncherImageUrl !== void 0 && (t.mobileLauncherImageUrl = this.options.chat.mobileLauncherImageUrl), this.options.chat?.headerTitle !== void 0 && (t.headerTitle = this.options.chat.headerTitle), this.options.chat?.headerAvatarUrl !== void 0 && (t.headerAvatarUrl = this.options.chat.headerAvatarUrl), this.options.chat?.headerBadge !== void 0 && (t.headerBadge = this.options.chat.headerBadge), this.options.chat?.headerCartUrl !== void 0 && (t.headerCartUrl = this.options.chat.headerCartUrl), this.options.chat?.headerFavoritesToggle !== void 0 && (t.headerFavoritesToggle = this.options.chat.headerFavoritesToggle), this.options.chat?.onFavoritesClick !== void 0 && (t.onFavoritesClick = this.options.chat.onFavoritesClick), this.options.chat?.hideMobileLauncher !== void 0 && (t.hideMobileLauncher = this.options.chat.hideMobileLauncher), this.options.chat?.mobileBreakpoint !== void 0 && (t.mobileBreakpoint = this.options.chat.mobileBreakpoint), this.options.chat?.mobileInitialState !== void 0 && (t.mobileInitialState = this.options.chat.mobileInitialState), this.options.chat?.i18n !== void 0 && (t.i18n = this.options.chat.i18n), this.options.chat?.actionHandling !== void 0 && (t.actionHandling = this.options.chat.actionHandling), this.options.chat?.renderer !== void 0 && (t.renderer = this.options.chat.renderer), e !== void 0 && (t.productDetailsExtended = e), s !== void 0 && (t.isDemoWebsite = s), this.options.chat?.productPriceUi !== void 0 && (t.productPriceUi = this.options.chat.productPriceUi), this.options.chat?.hideProductDiscountBadge !== void 0 && (t.hideProductDiscountBadge = this.options.chat.hideProductDiscountBadge), this.options.chat?.hideUserReviews !== void 0 && (t.hideUserReviews = this.options.chat.hideUserReviews), this.options.chat?.hideStockStatus !== void 0 && (t.hideStockStatus = this.options.chat.hideStockStatus), this.options.onScriptCall !== void 0 && (t.onScriptCall = this.options.onScriptCall), this.options.onAddToCart !== void 0 && (t.onAddToCart = this.options.onAddToCart), this.options.onProductNavigate !== void 0 && (t.onProductNavigate = this.options.onProductNavigate), this.options.chat?.onOpen !== void 0 && (t.onOpen = this.options.chat.onOpen), this.options.chat?.onClose !== void 0 && (t.onClose = this.options.chat.onClose);
-    const { GengageChat: a } = await import("./chat-runtime.js");
-    this._chat = new a(), await this._chat.init(t);
+    this.options.theme !== void 0 && (t.theme = this.options.theme), a !== void 0 && (t.injectorAdapter = a), this.options.locale !== void 0 && (t.locale = this.options.locale), this.options.pricing !== void 0 && (t.pricing = this.options.pricing), this.options.chat?.mountTarget !== void 0 && (t.mountTarget = this.options.chat.mountTarget), this.options.chat?.pillLauncher !== void 0 && (t.pillLauncher = this.options.chat.pillLauncher), this.options.chat?.floatingLauncher !== void 0 && (t.floatingLauncher = this.options.chat.floatingLauncher), this.options.chat?.launcherAnchor !== void 0 && (t.launcherAnchor = this.options.chat.launcherAnchor), this.options.chat?.launcherImageUrl !== void 0 ? t.launcherImageUrl = this.options.chat.launcherImageUrl : this.options.chat?.launcherSvg !== void 0 && (t.launcherSvg = this.options.chat.launcherSvg), this.options.chat?.mobileLauncherImageUrl !== void 0 && (t.mobileLauncherImageUrl = this.options.chat.mobileLauncherImageUrl), this.options.chat?.headerTitle !== void 0 && (t.headerTitle = this.options.chat.headerTitle), this.options.chat?.headerAvatarUrl !== void 0 && (t.headerAvatarUrl = this.options.chat.headerAvatarUrl), this.options.chat?.headerBadge !== void 0 && (t.headerBadge = this.options.chat.headerBadge), this.options.chat?.headerCartUrl !== void 0 && (t.headerCartUrl = this.options.chat.headerCartUrl), this.options.chat?.headerFavoritesToggle !== void 0 && (t.headerFavoritesToggle = this.options.chat.headerFavoritesToggle), this.options.chat?.onFavoritesClick !== void 0 && (t.onFavoritesClick = this.options.chat.onFavoritesClick), this.options.chat?.hideMobileLauncher !== void 0 && (t.hideMobileLauncher = this.options.chat.hideMobileLauncher), this.options.chat?.mobileBreakpoint !== void 0 && (t.mobileBreakpoint = this.options.chat.mobileBreakpoint), this.options.chat?.mobileInitialState !== void 0 && (t.mobileInitialState = this.options.chat.mobileInitialState), this.options.chat?.i18n !== void 0 && (t.i18n = this.options.chat.i18n), this.options.chat?.actionHandling !== void 0 && (t.actionHandling = this.options.chat.actionHandling), this.options.chat?.renderer !== void 0 && (t.renderer = this.options.chat.renderer), e !== void 0 && (t.productDetailsExtended = e), s !== void 0 && (t.isDemoWebsite = s), this.options.chat?.productPriceUi !== void 0 && (t.productPriceUi = this.options.chat.productPriceUi), this.options.chat?.hideProductDiscountBadge !== void 0 && (t.hideProductDiscountBadge = this.options.chat.hideProductDiscountBadge), this.options.chat?.hideUserReviews !== void 0 && (t.hideUserReviews = this.options.chat.hideUserReviews), this.options.chat?.hideStockStatus !== void 0 && (t.hideStockStatus = this.options.chat.hideStockStatus), this.options.onScriptCall !== void 0 && (t.onScriptCall = this.options.onScriptCall), this.options.onAddToCart !== void 0 && (t.onAddToCart = this.options.onAddToCart), this.options.onProductNavigate !== void 0 && (t.onProductNavigate = this.options.onProductNavigate), this.options.chat?.onOpen !== void 0 && (t.onOpen = this.options.chat.onOpen), this.options.chat?.onClose !== void 0 && (t.onClose = this.options.chat.onClose);
+    const { GengageChat: h } = await import("./chat-runtime.js");
+    this._chat = new h(), await this._chat.init(t);
   }
   async _syncPdpWidgets() {
     if (this._destroyed) return;
@@ -92,15 +92,15 @@ var q = class {
     }
     const e = this.options.middlewareUrl;
     if (this.options.qna?.enabled !== !1) {
-      const s = this.options.qna?.mountTarget ?? y, t = r(s);
-      if (t)
+      const s = this.options.qna?.mountTarget ?? y, a = r(s);
+      if (a)
         if (this._warnedQnaMountMissing = !1, this._qna)
           this._qna.show(), this._qna.update({
             pageType: "pdp",
             sku: i
           });
         else {
-          const { GengageQNA: a } = await import("./qna-runtime.js"), h = new a(), o = {
+          const { GengageQNA: t } = await import("./qna-runtime.js"), h = new t(), o = {
             accountId: this.options.accountId,
             middlewareUrl: e,
             session: this.session,
@@ -108,7 +108,7 @@ var q = class {
               pageType: "pdp",
               sku: i
             },
-            mountTarget: t
+            mountTarget: a
           };
           this.options.theme !== void 0 && (o.theme = this.options.theme), this.options.qna?.chrome !== void 0 && (o.chrome = this.options.qna.chrome), this.options.qna?.ctaText !== void 0 && (o.ctaText = this.options.qna.ctaText), this.options.qna?.hideButtonRowCta !== void 0 && (o.hideButtonRowCta = this.options.qna.hideButtonRowCta), this.options.qna?.inputPlaceholder !== void 0 && (o.inputPlaceholder = this.options.qna.inputPlaceholder), this.options.qna?.inputAfterPills !== void 0 && (o.inputAfterPills = this.options.qna.inputAfterPills), this.options.qna?.i18n !== void 0 && (o.i18n = this.options.qna.i18n), this.options.qna?.renderer !== void 0 && (o.renderer = this.options.qna.renderer);
           const n = this.options.qna?.headerTitle ?? this.options.qna?.headingTitle;
@@ -119,20 +119,20 @@ var q = class {
     } else
       this._qna?.destroy(), this._qna = null;
     if (this.options.simrel !== void 0 && this.options.simrel.enabled !== !1) {
-      const s = this.options.simrel?.mountTarget ?? w, t = r(s);
-      if (t)
+      const s = this.options.simrel?.mountTarget ?? w, a = r(s);
+      if (a)
         if (this._warnedSimRelMountMissing = !1, this._simrel)
           this._simrel.show(), this._simrel.update({
             pageType: "pdp",
             sku: i
           });
         else {
-          const { GengageSimRel: a } = await import("./simrel-runtime.js"), h = new a(), o = {
+          const { GengageSimRel: t } = await import("./simrel-runtime.js"), h = new t(), o = {
             accountId: this.options.accountId,
             middlewareUrl: e,
             session: this.session,
             sku: i,
-            mountTarget: t
+            mountTarget: a
           };
           this.options.theme !== void 0 && (o.theme = this.options.theme), this.options.pricing !== void 0 && (o.pricing = this.options.pricing), this.options.simrel?.discountType !== void 0 && (o.discountType = this.options.simrel.discountType), this.options.simrel?.gridColumns !== void 0 && (o.gridColumns = this.options.simrel.gridColumns), this.options.simrel?.enableProductGroupings !== void 0 && (o.enableProductGroupings = this.options.simrel.enableProductGroupings), this.options.simrel?.renderCardElement !== void 0 && (o.renderCardElement = this.options.simrel.renderCardElement), this.options.simrel?.renderer !== void 0 && (o.renderer = this.options.simrel.renderer), this.options.onAddToCart !== void 0 && (o.onAddToCart = this.options.onAddToCart), this.options.onProductNavigate !== void 0 ? o.onProductNavigate = this.options.onProductNavigate : o.onProductNavigate = (n, u, c) => {
             g(n) && (this._chat?.saveSession(c ?? this.session.sessionId, u), window.location.href = n);
@@ -143,8 +143,8 @@ var q = class {
     } else
       this._simrel?.destroy(), this._simrel = null;
     if (this.options.simbut && this.options.simbut.enabled !== !1) {
-      const s = this.options.simbut.mountTarget ?? C, t = r(s), a = this._chat ?? this.options.simbut.onFindSimilar;
-      if (t && a)
+      const s = this.options.simbut.mountTarget ?? C, a = r(s), t = this._chat ?? this.options.simbut.onFindSimilar;
+      if (a && t)
         if (this._warnedSimButMountMissing = !1, this._warnedSimButNoChat = !1, this._simbut)
           this._simbut.show(), this._simbut.setChat(this._chat), this._simbut.update({
             pageType: "pdp",
@@ -159,13 +159,13 @@ var q = class {
               pageType: "pdp",
               sku: i
             },
-            mountTarget: t,
+            mountTarget: a,
             chat: this._chat
           };
           this.options.theme !== void 0 && (n.theme = this.options.theme), this.options.locale !== void 0 && (n.locale = this.options.locale), this.options.simbut.layout !== void 0 && (n.layout = this.options.simbut.layout), this.options.simbut.inlineCard !== void 0 && (n.inlineCard = this.options.simbut.inlineCard), this.options.simbut.imageUrl !== void 0 && (n.imageUrl = this.options.simbut.imageUrl), this.options.simbut.i18n !== void 0 && (n.i18n = this.options.simbut.i18n), this.options.simbut.onFindSimilar !== void 0 && (n.onFindSimilar = this.options.simbut.onFindSimilar), await o.init(n), this._simbut = o;
         }
       else
-        this._simbut?.destroy(), this._simbut = null, !t && !this._warnedSimButMountMissing ? (console.warn(`[gengage] SimBut mount target not found: ${s}`), this._warnedSimButMountMissing = !0) : !a && !this._warnedSimButNoChat && (console.warn("[gengage] SimBut requires chat to be enabled or simbut.onFindSimilar"), this._warnedSimButNoChat = !0);
+        this._simbut?.destroy(), this._simbut = null, !a && !this._warnedSimButMountMissing ? (console.warn(`[gengage] SimBut mount target not found: ${s}`), this._warnedSimButMountMissing = !0) : !t && !this._warnedSimButNoChat && (console.warn("[gengage] SimBut requires chat to be enabled or simbut.onFindSimilar"), this._warnedSimButNoChat = !0);
     } else
       this._simbut?.destroy(), this._simbut = null;
   }
@@ -176,10 +176,10 @@ var q = class {
   }
 };
 async function k(i) {
-  const e = p(i), s = d(), t = s.instances[e];
-  if (t) return t;
-  const a = s.pending[e];
+  const e = p(i), s = d(), a = s.instances[e];
   if (a) return a;
+  const t = s.pending[e];
+  if (t) return t;
   const h = new q(i, () => {
     const n = d();
     delete n.instances[e], delete n.pending[e];

package/dist/overlay.d.ts

@@ -0,0 +1,4 @@
+export { initOverlayWidgets, getOverlayWidgets, destroyOverlayWidgets, buildOverlayIdempotencyKey, } from './common/overlay.js';
+export type { OverlayWidgetsController, OverlayWidgetsOptions, OverlayChatOptions, OverlayQNAOptions, OverlaySimRelOptions, OverlaySimButOptions, } from './common/overlay.js';
+export { bootstrapSession, updatePageContext } from './common/context.js';
+export type { PageContext, SessionContext, WidgetTheme } from './common/types.js';

package/dist/overlay.js

@@ -1,5 +1,5 @@
 import { i as t, t as a } from "./context-BBuSsXZ9.js";
-import { i as r, n as i, r as o, t as d } from "./overlay-CP5A0Hhf.js";
+import { i as r, n as i, r as o, t as d } from "./overlay-BetAvpVZ.js";
 export {
   a as bootstrapSession,
   d as buildOverlayIdempotencyKey,

package/dist/qna/api.d.ts

@@ -0,0 +1,23 @@
+import type { UISpec } from '../common/types.js';
+import type { ChatTransportConfig } from '../common/api-paths.js';
+export interface LauncherActionRequest {
+    account_id: string;
+    session_id: string;
+    correlation_id: string;
+    sku: string;
+    user_id?: string;
+    view_id?: string;
+    page_type?: string;
+    locale?: string;
+    output_language?: string;
+    mode?: string;
+}
+export interface LauncherActionResult {
+    uiSpecs: UISpec[];
+    actions: Array<{
+        title: string;
+        type: string;
+        payload?: unknown;
+    }>;
+}
+export declare function fetchLauncherActions(request: LauncherActionRequest, transport: ChatTransportConfig, signal?: AbortSignal): Promise<LauncherActionResult>;

package/dist/qna/catalog.d.ts

@@ -0,0 +1,60 @@
+/**
+ * QNA widget — json-render catalog definition.
+ *
+ * Backend endpoint: POST /chat/launcher_action
+ * Response format: NDJSON stream, each line a StreamEvent.
+ *
+ * The backend returns a `ui_spec` event whose elements are typed to the
+ * component names defined below. The frontend renders them via ./registry.
+ *
+ * Customising:
+ *   Fork this repo and replace ./registry implementations with your own.
+ *   The catalog schema (component names + prop types) is the API contract
+ *   with the backend — do not rename components without a backend release.
+ */
+import { z } from 'zod';
+export declare const qnaCatalog: {
+    readonly components: {
+        readonly ActionButton: {
+            readonly schema: z.ZodObject<{
+                label: z.ZodString;
+                action: z.ZodObject<{
+                    title: z.ZodString;
+                    type: z.ZodString;
+                    payload: z.ZodOptional<z.ZodUnknown>;
+                }, z.core.$strip>;
+                variant: z.ZodOptional<z.ZodEnum<{
+                    primary: "primary";
+                    outline: "outline";
+                    ghost: "ghost";
+                }>>;
+            }, z.core.$strip>;
+            readonly description: "A single clickable QNA action button.";
+        };
+        readonly ButtonRow: {
+            readonly schema: z.ZodObject<{
+                orientation: z.ZodOptional<z.ZodEnum<{
+                    horizontal: "horizontal";
+                    vertical: "vertical";
+                }>>;
+                wrap: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>;
+            readonly description: "Container for a group of QNA action buttons.";
+        };
+        readonly TextInput: {
+            readonly schema: z.ZodObject<{
+                placeholder: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+                ctaLabel: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            readonly description: "Free-text input with rotating placeholder and CTA button.";
+        };
+        readonly QuestionHeading: {
+            readonly schema: z.ZodObject<{
+                text: z.ZodString;
+            }, z.core.$strip>;
+            readonly description: "A heading displayed above the QNA button group.";
+        };
+    };
+};
+export type QNACatalog = typeof qnaCatalog;
+export type QNAComponentName = keyof QNACatalog['components'];

package/dist/qna/components/ButtonRow.d.ts

@@ -0,0 +1,15 @@
+import type { ActionPayload } from '../../common/types.js';
+export interface ButtonRowOptions {
+    actions: Array<{
+        title: string;
+        type: string;
+        payload?: unknown;
+    }>;
+    onAction: (action: ActionPayload) => void;
+    ctaText?: string;
+    defaultCtaText?: string;
+    onOpenChat?: () => void;
+    orientation?: 'horizontal' | 'vertical';
+    quickQuestionsAriaLabel?: string;
+}
+export declare function renderButtonRow(options: ButtonRowOptions): HTMLElement;

package/dist/qna/components/TextInput.d.ts

@@ -0,0 +1,11 @@
+import type { ActionPayload } from '../../common/types.js';
+export interface TextInputOptions {
+    placeholders?: string | string[];
+    ctaLabel?: string;
+    defaultInputPlaceholder?: string;
+    askQuestionAriaLabel?: string;
+    sendButtonText?: string;
+    sendQuestionAriaLabel?: string;
+    onSubmit: (action: ActionPayload) => void;
+}
+export declare function renderTextInput(options: TextInputOptions): HTMLElement;

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

@@ -0,0 +1,7 @@
+import type { UISpecDomRegistry, UISpecDomUnknownRenderer } from '../../common/renderer/index.js';
+import type { UISpec } from '../../common/types.js';
+import type { QNAUISpecRenderContext } from '../types.js';
+export type QNAUISpecRegistry = UISpecDomRegistry<QNAUISpecRenderContext>;
+export declare const defaultQnaUnknownUISpecRenderer: UISpecDomUnknownRenderer<QNAUISpecRenderContext>;
+export declare function createDefaultQnaUISpecRegistry(): QNAUISpecRegistry;
+export declare function renderQnaUISpec(spec: UISpec, context: QNAUISpecRenderContext, registry?: QNAUISpecRegistry, unknownRenderer?: UISpecDomUnknownRenderer<QNAUISpecRenderContext>): HTMLElement;

package/dist/qna/index.d.ts

@@ -0,0 +1,3 @@
+export * from './runtime.js';
+export { qnaCatalog } from './catalog.js';
+export type { QNACatalog, QNAComponentName } from './catalog.js';

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

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

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

@@ -0,0 +1,4 @@
+import type { QNAI18n } from '../types.js';
+import { QNA_I18N_TR } from './tr.js';
+export declare function resolveQnaLocale(locale?: string): QNAI18n;
+export { QNA_I18N_TR };

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

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

package/dist/qna/normalize-ui-specs.d.ts

@@ -0,0 +1,15 @@
+import type { PageContext, UISpec } from '../common/types.js';
+import type { QNAI18n } from './types.js';
+/** SKUs to send with the product-context quick pill (`user_message` + sku_list). */
+export type MergeQuickPillsOptions = {
+    skuList?: string[] | undefined;
+};
+/**
+ * Resolve SKU list for QNA → chat payloads: current PDP sku, or `visible_skus` on listings.
+ */
+export declare function resolveQnaSkuListForPayload(pageContext: PageContext | undefined): string[] | undefined;
+/**
+ * Removes standalone hero `ActionButton` blocks for `findSimilar` (e.g. from `text_image`)
+ * and merges a product-context quick question pill instead (same row as other questions).
+ */
+export declare function mergeStandaloneFindSimilarIntoQuickPills(specs: UISpec[], i18n: QNAI18n, options?: MergeQuickPillsOptions): UISpec[];

package/dist/qna/runtime.d.ts

@@ -0,0 +1,73 @@
+/**
+ * QNA widget -- public entry point.
+ *
+ * Renders contextual action buttons (and an optional free-text input) on
+ * product or content pages. When a user taps a button, the widget opens
+ * the Chat widget with that action pre-loaded.
+ *
+ * Backend: POST /chat/launcher_action
+ * Protocol: NDJSON stream -> json-render UISpec -> ActionButton / ButtonRow / TextInput
+ */
+import type { ActionPayload, PageContext } from '../common/types.js';
+import { BaseWidget } from '../common/widget-base.js';
+import type { QNAWidgetConfig } from './types.js';
+import './components/qna.css';
+/**
+ * Contextual Q&A action buttons for product pages.
+ * Renders quick-action buttons that open the chat widget with a pre-built query.
+ *
+ * @example
+ * ```ts
+ * import { GengageQNA, wireQNAToChat, bootstrapSession } from '@gengage/assistant-fe';
+ *
+ * const qna = new GengageQNA();
+ * await qna.init({
+ *   accountId: 'mystore',
+ *   middlewareUrl: '<backend service location provided for your Gengage account>',
+ *   mountTarget: '#qna-section',
+ *   pageContext: { pageType: 'pdp', sku: '12345' },
+ *   session: { sessionId: bootstrapSession() },
+ * });
+ * wireQNAToChat(); // Wire button clicks to chat.openWithAction()
+ * ```
+ */
+export declare class GengageQNA extends BaseWidget<QNAWidgetConfig> {
+    private _abortController;
+    private _debounceTimer;
+    private _contentEl;
+    private _lastSku;
+    private _i18n;
+    protected onInit(config: QNAWidgetConfig): Promise<void>;
+    protected onUpdate(context: Partial<PageContext>): void;
+    protected onShow(): void;
+    protected onHide(): void;
+    protected onDestroy(): void;
+    private _abort;
+    /** `headerTitle` wins over deprecated `headingTitle`. */
+    private _resolvedQnaHeaderTitle;
+    /** Clean up TextInput placeholder rotation timers to prevent interval leaks. */
+    private _cleanupTextInputTimers;
+    private _fetchAndRender;
+    private _createLoadingIndicator;
+    private _resolveI18n;
+    private _createChrome;
+    private _resolveUISpecRegistry;
+    private _renderUISpec;
+    private _specIncludesType;
+    private _buildFallbackActionsSpec;
+    /**
+     * Free-text field when the launcher stream has no TextInput. Sits above the pills by
+     * default; set `inputAfterPills: true` in config to place it after.
+     */
+    private _insertStandaloneInputBeforePills;
+    private _appendStandaloneInput;
+    private _handleAction;
+    private _handleOpenChat;
+    private _showTransitionIndicator;
+    _actionHandler: (action: ActionPayload) => void;
+    _openChatHandler: () => void;
+}
+export declare function createQNAWidget(): GengageQNA;
+export type { QNAWidgetConfig, QNAUIComponents, QNAI18n, QNAChromeLayout, QNAChromeConfig, QNAUISpecRenderContext, QNARendererConfig, } from './types.js';
+export { renderQnaUISpec, createDefaultQnaUISpecRegistry, defaultQnaUnknownUISpecRenderer, } from './components/renderUISpec.js';
+export type { QNAUISpecRegistry } from './components/renderUISpec.js';

package/dist/qna/types.d.ts

@@ -0,0 +1,98 @@
+import type { BaseWidgetConfig, ActionPayload } from '../common/types.js';
+import type { UISpecRendererOverrides } from '../common/renderer/index.js';
+export interface QNAWidgetConfig extends BaseWidgetConfig {
+    /** Where to mount the QNA buttons container. Required. */
+    mountTarget: HTMLElement | string;
+    /** Optional SDK-owned outer chrome for merchant PDP prompts. Defaults to no chrome. */
+    chrome?: QNAChromeConfig;
+    /** CTA label for the "open chat" pill/button (default: 'Ask something else'). */
+    ctaText?: string;
+    /** Hide the CTA button inside the quick-question button row.
+     *  Useful when a TextInput is already visible and the CTA would be redundant. */
+    hideButtonRowCta?: boolean;
+    /** Placeholder text cycling inside the free-text input.
+     *  Set to `true` to use fetched action titles as rotating placeholders. */
+    inputPlaceholder?: string | string[] | true;
+    /** When true, the standalone input is placed after the question pills instead of before them. */
+    inputAfterPills?: boolean;
+    /** Locale key for SDK defaults (for example 'tr', 'en'). */
+    locale?: string;
+    i18n?: Partial<QNAI18n>;
+    renderer?: QNARendererConfig;
+    /** Show a static question above the rotating buttons. */
+    showStaticQuestion?: boolean;
+    staticQuestionText?: string;
+    /**
+     * Title above the Q&A module (e.g. "Koçtaş'a Sor", "Teknosa'ya Sor").
+     * When set, overrides the stream `QuestionHeading` text from the backend.
+     * Overlay defaults: `qna.headerTitle` → `qna.headingTitle` (deprecated) → `chat.headerTitle`.
+     */
+    headerTitle?: string;
+    /**
+     * @deprecated Use `headerTitle` — same behavior.
+     */
+    headingTitle?: string;
+    /** Called when a QNA action button is clicked. */
+    onActionSelected?: (action: ActionPayload) => void;
+    /** Called when the open-chat CTA is clicked. */
+    onOpenChat?: () => void;
+}
+export interface QNAI18n {
+    quickQuestionsAriaLabel: string;
+    askQuestionAriaLabel: string;
+    defaultInputPlaceholder: string;
+    sendButton: string;
+    sendQuestionAriaLabel: string;
+    defaultCtaText: string;
+    redirectingToChat: string;
+    /**
+     * Replaces the standalone backend “similar products” hero with this quick question pill
+     * (user_message, not findSimilar).
+     */
+    productContextQuickPillLabel: string;
+}
+export type QNAChromeLayout = 'default' | 'side-image';
+export interface QNAChromeConfig {
+    /** Optional chrome layout. `side-image` keeps the QNA body in the content column beside the image. */
+    layout?: QNAChromeLayout;
+    title?: string;
+    subtitle?: string;
+    imageUrl?: string;
+    imageAlt?: string;
+    /** Optional CSS padding value applied to the chrome image. */
+    imagePadding?: string;
+    startButtonLabel?: string;
+}
+export interface QNAUISpecRenderContext {
+    onAction: (action: ActionPayload) => void;
+    onOpenChat?: () => void;
+    ctaText?: string;
+    inputPlaceholder?: string | string[];
+    i18n: QNAI18n;
+    /** When set (from `QNAWidgetConfig.headerTitle` / `headingTitle`), replaces QuestionHeading `text` from the stream. */
+    headingTitleOverride?: string;
+}
+export type QNARendererConfig = UISpecRendererOverrides<QNAUISpecRenderContext>;
+export interface QNAUIComponents {
+    /** A single QNA action button. */
+    ActionButton: {
+        label: string;
+        action: ActionPayload;
+        /** Visual variant for the button. */
+        variant?: 'primary' | 'outline' | 'ghost';
+    };
+    /** The container holding all action buttons. */
+    ButtonRow: {
+        orientation?: 'horizontal' | 'vertical';
+        wrap?: boolean;
+    };
+    /** Free-text input field with rotating placeholder text. */
+    TextInput: {
+        placeholder?: string | string[];
+        ctaLabel?: string;
+    };
+    /** A heading or label above the buttons. */
+    QuestionHeading: {
+        text: string;
+    };
+}

package/dist/qna-runtime.js

@@ -1,4 +1,4 @@
-import { a, i as r, n, r as t, t as s } from "./runtime-BPyXOyyp.js";
+import { a, i as r, n, r as t, t as s } from "./runtime-DbZO1qG5.js";
 export {
   s as GengageQNA,
   t as createDefaultQnaUISpecRegistry,