@gengage/assistant-fe 0.5.7 → 0.6.0

package/dist/{runtime-C3yOvNFK.js → runtime-iCLkUjI3.js}

@@ -1,9 +1,9 @@
-import { a as x, d as L, h as j, i as q, p as F, r as I, t as N } from "./api-paths-CwzwbgQZ.js";
+import { a as x, d as L, h as j, i as q, p as F, r as I, t as N } from "./api-paths-DJFF9RuZ.js";
 import { A as z, E as S, N as D, a as k, l as H, v as $ } from "./context-BBuSsXZ9.js";
-import { o as W, t as J } from "./widget-base-UmvgIqDk.js";
+import { o as W, t as J } from "./widget-base-COP8QwU3.js";
 import { t as K } from "./locale-CfqNifrU.js";
 import { a as Q, n as V, r as Y, t as A } from "./price-formatter-xI3g9Cd4.js";
-import { n as X } from "./connection-warning-B5T_1oBn.js";
+import { n as X } from "./connection-warning-Pbvk3J8k.js";
 function R(e) {
   const t = [];
   for (const n of Object.values(e)) if (n.type === "ProductCard" && n.props) {

package/dist/simbut/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * SimBut — a "Find Similar" button for the top-right of a PDP product image.
+ * On click, it sends a `findSimilar` action through chat using the same protocol as the panel pill.
+ *
+ * Layout: the button is absolutely positioned in the mount corner and does not take layout space.
+ * The mount should be a product image wrapper with `position: relative | absolute | fixed`;
+ * static mounts are promoted to `relative` so the host layout and image size are not affected.
+ */
+import { BaseWidget } from '../common/widget-base.js';
+import type { PageContext } from '../common/types.js';
+import type { GengageChat } from '../chat/index.js';
+import type { SimButWidgetConfig } from './types.js';
+import './simbut.css';
+export declare class GengageSimBut extends BaseWidget<SimButWidgetConfig> {
+    private _button;
+    private _inlineFrame;
+    private _label;
+    protected onInit(config: SimButWidgetConfig): Promise<void>;
+    private _createInlineCard;
+    protected onUpdate(_context: Partial<PageContext>): void;
+    hide(): void;
+    show(): void;
+    protected _cleanupRoot(): void;
+    protected onShow(): void;
+    protected onHide(): void;
+    protected onDestroy(): void;
+    /** Optional hook for wiring overlay chat after initialization. */
+    setChat(chat: GengageChat | null): void;
+}
+export declare function createSimButWidget(): GengageSimBut;
+export type { SimButWidgetConfig, SimButI18n, SimButInlineCardConfig, SimButLayout } from './types.js';

package/dist/simbut/locales.d.ts

@@ -0,0 +1,3 @@
+import type { SimButI18n } from './types.js';
+export declare const SIMBUT_I18N_TR: SimButI18n;
+export declare const SIMBUT_I18N_EN: SimButI18n;

package/dist/simbut/types.d.ts

@@ -0,0 +1,43 @@
+import type { BaseWidgetConfig } from '../common/types.js';
+import type { GengageChat } from '../chat/index.js';
+export interface SimButI18n {
+    findSimilarLabel: string;
+}
+export type SimButLayout = 'overlay' | 'inline-card';
+export interface SimButInlineCardConfig {
+    title?: string;
+    description?: string;
+    imageUrl?: string;
+    imageAlt?: string;
+}
+export interface SimButWidgetConfig extends BaseWidgetConfig {
+    /**
+     * Product image element, or its `position: relative` wrapper.
+     * The button is absolutely positioned inside this element and does not take layout space.
+     */
+    mountTarget: HTMLElement | string;
+    /** Visual layout. Defaults to the existing product-image overlay pill. */
+    layout?: SimButLayout;
+    /** Content used by `layout: 'inline-card'`. Ignored for overlay layout. */
+    inlineCard?: SimButInlineCardConfig;
+    /**
+     * Product SKU. Falls back to `pageContext.sku`, including overlay context updates.
+     */
+    sku?: string;
+    /** Optional product image URL passed to custom `onFindSimilar`; chat actions use SKU when available. */
+    imageUrl?: string;
+    /**
+     * Chat instance used to open chat and send `findSimilar`. `initOverlayWidgets` wires this automatically.
+     */
+    chat?: GengageChat | null;
+    /**
+     * Overrides the default click behavior, for example for a custom integration.
+     * When defined, `chat` is not used.
+     */
+    onFindSimilar?: (detail: {
+        sku: string;
+        imageUrl?: string;
+    }) => void;
+    locale?: string;
+    i18n?: Partial<SimButI18n>;
+}

package/dist/{simbut-CiknJI6-.js → simbut-FyXolmZY.js}

@@ -1,5 +1,5 @@
 import { A as m, D as h, _ as u, j as f, v as p } from "./context-BBuSsXZ9.js";
-import { t as b } from "./widget-base-UmvgIqDk.js";
+import { t as b } from "./widget-base-COP8QwU3.js";
 import { t as y } from "./locale-CfqNifrU.js";
 var g = { findSimilarLabel: "Benzerlerini Bul" }, _ = { findSimilarLabel: "Find Similar" };
 function S(t, n) {

package/dist/simbut.iife.js

@@ -44,4 +44,4 @@
     transform: translateY(0);
   }
 }
-`,document.head.appendChild(e)}var f=null;function Y(){if(f!==null)return f;try{f=localStorage.getItem("gengage:debug")==="1"}catch{f=!1}return f}function S(e,t,i){if(!Y())return;const n=[`[gengage:${e}]`,t];i!==void 0&&n.push(i),console.debug(...n)}var j=("0.5.7".trim(),"0.5.7".trim()),J=("iife-build".trim(),"iife-build".trim());function K(){if(typeof window>"u")return;const e=window;e.__gengageSdkRuntimeInfoLogged||(e.__gengageSdkRuntimeInfoLogged=!0,console.info(`[gengage] @gengage/assistant-fe v${j} (${J})`))}var Q=class{constructor(){this.isVisible=!1,this.isInitialised=!1,this._handlers=new Map,this._cleanups=[],this._ownsRoot=!1,this._destroying=!1}async init(e){if(this.isInitialised){console.warn("[gengage] Widget already initialised. Call update() instead.");return}const t=U(e.theme);K(),this.config={...e,theme:t,session:N(e.session)},this.root=this._resolveMount(e.mountTarget),this._applyTheme(t),O();const i=x("gengage:context:update",n=>this.update(n));this._cleanups.push(i),S("lifecycle",`${this.constructor.name}.init`,{accountId:e.accountId,sku:e.pageContext?.sku});try{await this.onInit(this.config)}catch(n){throw this.destroy(),n}this._destroying||(this.isInitialised=!0,S("lifecycle",`${this.constructor.name} ready`),this.emit("ready"))}update(e){this.isInitialised&&(this.config.pageContext?this.config={...this.config,pageContext:{...this.config.pageContext,...e}}:e.pageType!==void 0&&(this.config={...this.config,pageContext:e}),this.onUpdate(e),this.emit("context-update",this.config.pageContext))}show(){this.isVisible||(this.isVisible=!0,this.root.style.display="",this.onShow(),this.emit("show"))}hide(){this.isVisible&&(this.isVisible=!1,this.root.style.display="none",this.onHide(),this.emit("hide"))}destroy(){this._destroying||(this._destroying=!0,this.emit("destroy"),this._cleanups.forEach(e=>e()),this._cleanups.length=0,this._handlers.clear(),this.onDestroy(),this._cleanupRoot(),this.isInitialised=!1)}_cleanupRoot(){this._ownsRoot?this.root.remove():this.root.innerHTML=""}on(e,t){return this._handlers.has(e)||this._handlers.set(e,new Set),this._handlers.get(e).add(t),()=>this._handlers.get(e)?.delete(t)}emit(e,...t){this._handlers.get(e)?.forEach(i=>i(...t))}addCleanup(e){this._cleanups.push(e)}_resolveMount(e){if(e instanceof HTMLElement)return e;if(typeof e=="string"){const i=document.querySelector(e);if(!i)throw new Error(`[gengage] Mount target not found: "${e}"`);return i}const t=document.createElement("div");return t.dataset.gengageWidget=this.constructor.name.toLowerCase(),document.body.insertBefore(t,document.body.firstChild),this._ownsRoot=!0,t}_applyTheme(e){if(e){for(const[t,i]of Object.entries(e))if(i!==void 0){const n=t.startsWith("--")?t:`--gengage-${X(t)}`;this.root.style.setProperty(n,i)}}}};function X(e){return e.replace(/([A-Z])/g,"-$1").toLowerCase()}function Z(e){const t=e?.trim();return t||"tr"}var C={findSimilarLabel:"Benzerlerini Bul"},ee={findSimilarLabel:"Find Similar"};function te(e,t){return t?.findSimilarLabel?t.findSimilarLabel:(e??"tr").toLowerCase().startsWith("en")?ee.findSimilarLabel:C.findSimilarLabel}function h(e){const t=typeof e.sku=="string"&&e.sku.length>0?e.sku:void 0,i=typeof e.pageContext?.sku=="string"&&e.pageContext.sku.length>0?e.pageContext.sku:void 0;return t??i}var E=class extends Q{constructor(...e){super(...e),this._button=null,this._inlineFrame=null,this._label=C.findSimilarLabel}async onInit(e){this._label=te(e.locale,e.i18n);const t=e.layout??"overlay";this.root.classList.add("gengage-simbut-root"),this.root.classList.toggle("gengage-simbut-root--overlay",t==="overlay"),this.root.classList.toggle("gengage-simbut-root--inline-card",t==="inline-card"),t==="overlay"&&window.getComputedStyle(this.root).position==="static"&&(this.root.style.position="relative");const i=document.createElement("button");i.type="button",i.className="gengage-chat-find-similar-pill",i.lang=Z(e.locale),i.textContent=this._label,this._button=i;const n=()=>{i.disabled=!(h(this.config)&&(this.config.onFindSimilar||this.config.chat))};if(i.addEventListener("click",r=>{r.stopPropagation();const s=h(this.config);if(!s)return;const o=this.config.imageUrl,g=typeof o=="string"&&L(o)?o:void 0;if(F(this._label,"findSimilar"),R(s),this.config.onFindSimilar){this.config.onFindSimilar(g?{sku:s,imageUrl:g}:{sku:s});return}const u=this.config.chat;if(!u)return;const a={title:this._label,type:"findSimilar",payload:{sku:s}};u.openWithAction(a,{sku:s})}),t==="inline-card"){const r=this._createInlineCard(e,i);this._inlineFrame=r,this.root.appendChild(r)}else this.root.appendChild(i);n(),k("simbut")}_createInlineCard(e,t){const i=e.inlineCard,n=typeof i?.title=="string"?i.title.trim():"",r=typeof i?.description=="string"?i.description.trim():"",s=typeof i?.imageUrl=="string"?i.imageUrl.trim():"",o=document.createElement("section");o.className="gengage-simbut-inline-card",o.dataset.gengagePart="simbut-inline-card";const g=document.createElement("div");if(g.className="gengage-simbut-inline-copy",g.dataset.gengagePart="simbut-inline-copy",n){const a=document.createElement("h4");a.className="gengage-simbut-inline-title",a.dataset.gengagePart="simbut-inline-title",a.textContent=n,g.appendChild(a)}if(r){const a=document.createElement("p");a.className="gengage-simbut-inline-description",a.dataset.gengagePart="simbut-inline-description",a.textContent=r,g.appendChild(a)}g.children.length>0&&o.appendChild(g);const u=document.createElement("div");if(u.className="gengage-simbut-inline-action",u.dataset.gengagePart="simbut-inline-action",u.appendChild(t),o.appendChild(u),s&&I(s)){const a=document.createElement("img");a.className="gengage-simbut-inline-image",a.dataset.gengagePart="simbut-inline-image",a.src=s,a.alt=typeof i?.imageAlt=="string"?i.imageAlt:"",a.loading="lazy",a.addEventListener("error",()=>{a.style.display="none"},{once:!0}),o.appendChild(a)}return o}onUpdate(e){if(!this._button)return;const t=!!h(this.config)&&(!!this.config.onFindSimilar||!!this.config.chat);this._button.disabled=!t}hide(){this.isVisible&&(this.isVisible=!1,this._inlineFrame&&(this._inlineFrame.style.display="none"),this._button&&(this._button.style.display="none"),this.onHide(),this.emit("hide"))}show(){this.isVisible||(this.isVisible=!0,this._inlineFrame&&(this._inlineFrame.style.display=""),this._button&&(this._button.style.display=""),this.onShow(),this.emit("show"))}_cleanupRoot(){}onShow(){}onHide(){}onDestroy(){this._inlineFrame?.remove(),this._inlineFrame=null,this._button?.remove(),this._button=null}setChat(e){if(this.config.chat=e,this._button){const t=!!h(this.config)&&(!!this.config.onFindSimilar||!!this.config.chat);this._button.disabled=!t}}};function ie(){return new E}m.GengageSimBut=E,m.createSimButWidget=ie})(this.Gengage=this.Gengage||{});
+`,document.head.appendChild(e)}var f=null;function Y(){if(f!==null)return f;try{f=localStorage.getItem("gengage:debug")==="1"}catch{f=!1}return f}function S(e,t,i){if(!Y())return;const n=[`[gengage:${e}]`,t];i!==void 0&&n.push(i),console.debug(...n)}var j=("0.6.0".trim(),"0.6.0".trim()),J=("iife-build".trim(),"iife-build".trim());function K(){if(typeof window>"u")return;const e=window;e.__gengageSdkRuntimeInfoLogged||(e.__gengageSdkRuntimeInfoLogged=!0,console.info(`[gengage] @gengage/assistant-fe v${j} (${J})`))}var Q=class{constructor(){this.isVisible=!1,this.isInitialised=!1,this._handlers=new Map,this._cleanups=[],this._ownsRoot=!1,this._destroying=!1}async init(e){if(this.isInitialised){console.warn("[gengage] Widget already initialised. Call update() instead.");return}const t=U(e.theme);K(),this.config={...e,theme:t,session:N(e.session)},this.root=this._resolveMount(e.mountTarget),this._applyTheme(t),O();const i=x("gengage:context:update",n=>this.update(n));this._cleanups.push(i),S("lifecycle",`${this.constructor.name}.init`,{accountId:e.accountId,sku:e.pageContext?.sku});try{await this.onInit(this.config)}catch(n){throw this.destroy(),n}this._destroying||(this.isInitialised=!0,S("lifecycle",`${this.constructor.name} ready`),this.emit("ready"))}update(e){this.isInitialised&&(this.config.pageContext?this.config={...this.config,pageContext:{...this.config.pageContext,...e}}:e.pageType!==void 0&&(this.config={...this.config,pageContext:e}),this.onUpdate(e),this.emit("context-update",this.config.pageContext))}show(){this.isVisible||(this.isVisible=!0,this.root.style.display="",this.onShow(),this.emit("show"))}hide(){this.isVisible&&(this.isVisible=!1,this.root.style.display="none",this.onHide(),this.emit("hide"))}destroy(){this._destroying||(this._destroying=!0,this.emit("destroy"),this._cleanups.forEach(e=>e()),this._cleanups.length=0,this._handlers.clear(),this.onDestroy(),this._cleanupRoot(),this.isInitialised=!1)}_cleanupRoot(){this._ownsRoot?this.root.remove():this.root.innerHTML=""}on(e,t){return this._handlers.has(e)||this._handlers.set(e,new Set),this._handlers.get(e).add(t),()=>this._handlers.get(e)?.delete(t)}emit(e,...t){this._handlers.get(e)?.forEach(i=>i(...t))}addCleanup(e){this._cleanups.push(e)}_resolveMount(e){if(e instanceof HTMLElement)return e;if(typeof e=="string"){const i=document.querySelector(e);if(!i)throw new Error(`[gengage] Mount target not found: "${e}"`);return i}const t=document.createElement("div");return t.dataset.gengageWidget=this.constructor.name.toLowerCase(),document.body.insertBefore(t,document.body.firstChild),this._ownsRoot=!0,t}_applyTheme(e){if(e){for(const[t,i]of Object.entries(e))if(i!==void 0){const n=t.startsWith("--")?t:`--gengage-${X(t)}`;this.root.style.setProperty(n,i)}}}};function X(e){return e.replace(/([A-Z])/g,"-$1").toLowerCase()}function Z(e){const t=e?.trim();return t||"tr"}var C={findSimilarLabel:"Benzerlerini Bul"},ee={findSimilarLabel:"Find Similar"};function te(e,t){return t?.findSimilarLabel?t.findSimilarLabel:(e??"tr").toLowerCase().startsWith("en")?ee.findSimilarLabel:C.findSimilarLabel}function h(e){const t=typeof e.sku=="string"&&e.sku.length>0?e.sku:void 0,i=typeof e.pageContext?.sku=="string"&&e.pageContext.sku.length>0?e.pageContext.sku:void 0;return t??i}var E=class extends Q{constructor(...e){super(...e),this._button=null,this._inlineFrame=null,this._label=C.findSimilarLabel}async onInit(e){this._label=te(e.locale,e.i18n);const t=e.layout??"overlay";this.root.classList.add("gengage-simbut-root"),this.root.classList.toggle("gengage-simbut-root--overlay",t==="overlay"),this.root.classList.toggle("gengage-simbut-root--inline-card",t==="inline-card"),t==="overlay"&&window.getComputedStyle(this.root).position==="static"&&(this.root.style.position="relative");const i=document.createElement("button");i.type="button",i.className="gengage-chat-find-similar-pill",i.lang=Z(e.locale),i.textContent=this._label,this._button=i;const n=()=>{i.disabled=!(h(this.config)&&(this.config.onFindSimilar||this.config.chat))};if(i.addEventListener("click",r=>{r.stopPropagation();const s=h(this.config);if(!s)return;const o=this.config.imageUrl,g=typeof o=="string"&&L(o)?o:void 0;if(F(this._label,"findSimilar"),R(s),this.config.onFindSimilar){this.config.onFindSimilar(g?{sku:s,imageUrl:g}:{sku:s});return}const u=this.config.chat;if(!u)return;const a={title:this._label,type:"findSimilar",payload:{sku:s}};u.openWithAction(a,{sku:s})}),t==="inline-card"){const r=this._createInlineCard(e,i);this._inlineFrame=r,this.root.appendChild(r)}else this.root.appendChild(i);n(),k("simbut")}_createInlineCard(e,t){const i=e.inlineCard,n=typeof i?.title=="string"?i.title.trim():"",r=typeof i?.description=="string"?i.description.trim():"",s=typeof i?.imageUrl=="string"?i.imageUrl.trim():"",o=document.createElement("section");o.className="gengage-simbut-inline-card",o.dataset.gengagePart="simbut-inline-card";const g=document.createElement("div");if(g.className="gengage-simbut-inline-copy",g.dataset.gengagePart="simbut-inline-copy",n){const a=document.createElement("h4");a.className="gengage-simbut-inline-title",a.dataset.gengagePart="simbut-inline-title",a.textContent=n,g.appendChild(a)}if(r){const a=document.createElement("p");a.className="gengage-simbut-inline-description",a.dataset.gengagePart="simbut-inline-description",a.textContent=r,g.appendChild(a)}g.children.length>0&&o.appendChild(g);const u=document.createElement("div");if(u.className="gengage-simbut-inline-action",u.dataset.gengagePart="simbut-inline-action",u.appendChild(t),o.appendChild(u),s&&I(s)){const a=document.createElement("img");a.className="gengage-simbut-inline-image",a.dataset.gengagePart="simbut-inline-image",a.src=s,a.alt=typeof i?.imageAlt=="string"?i.imageAlt:"",a.loading="lazy",a.addEventListener("error",()=>{a.style.display="none"},{once:!0}),o.appendChild(a)}return o}onUpdate(e){if(!this._button)return;const t=!!h(this.config)&&(!!this.config.onFindSimilar||!!this.config.chat);this._button.disabled=!t}hide(){this.isVisible&&(this.isVisible=!1,this._inlineFrame&&(this._inlineFrame.style.display="none"),this._button&&(this._button.style.display="none"),this.onHide(),this.emit("hide"))}show(){this.isVisible||(this.isVisible=!0,this._inlineFrame&&(this._inlineFrame.style.display=""),this._button&&(this._button.style.display=""),this.onShow(),this.emit("show"))}_cleanupRoot(){}onShow(){}onHide(){}onDestroy(){this._inlineFrame?.remove(),this._inlineFrame=null,this._button?.remove(),this._button=null}setChat(e){if(this.config.chat=e,this._button){const t=!!h(this.config)&&(!!this.config.onFindSimilar||!!this.config.chat);this._button.disabled=!t}}};function ie(){return new E}m.GengageSimBut=E,m.createSimButWidget=ie})(this.Gengage=this.Gengage||{});

package/dist/simbut.js

@@ -1,4 +1,4 @@
-import { n as e, t as a } from "./simbut-CiknJI6-.js";
+import { n as e, t as a } from "./simbut-FyXolmZY.js";
 export {
   a as GengageSimBut,
   e as createSimButWidget

package/dist/simrel/api.d.ts

@@ -0,0 +1,25 @@
+import type { NormalizedProduct } from '../common/protocol-adapter.js';
+import type { ChatTransportConfig } from '../common/api-paths.js';
+export interface SimilarProductsRequest {
+    account_id: string;
+    session_id: string;
+    correlation_id: string;
+    sku: string;
+    domain?: string;
+    limit?: number;
+    output_language?: string;
+}
+export interface ProductGroupingsRequest {
+    account_id: string;
+    session_id: string;
+    correlation_id: string;
+    skus: string[];
+    output_language?: string;
+}
+export interface ProductGroup {
+    name: string;
+    highlight?: string;
+    products: NormalizedProduct[];
+}
+export declare function fetchSimilarProducts(request: SimilarProductsRequest, transport: ChatTransportConfig, signal?: AbortSignal): Promise<NormalizedProduct[]>;
+export declare function fetchProductGroupings(request: ProductGroupingsRequest, transport: ChatTransportConfig, signal?: AbortSignal): Promise<ProductGroup[]>;

package/dist/simrel/catalog.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Similar Products (SimRel) widget — json-render catalog definition.
+ *
+ * Backend endpoints:
+ *   POST /chat/similar_products    — primary product list
+ *   POST /chat/product_groupings   — grouped/tabbed view
+ *
+ * The backend streams NDJSON events. `ui_spec` events reference
+ * component names defined below. Implementations live in ./registry.
+ */
+import { z } from 'zod';
+export declare const simRelCatalog: {
+    readonly components: {
+        readonly ProductGrid: {
+            readonly schema: z.ZodObject<{
+                layout: z.ZodOptional<z.ZodEnum<{
+                    grid: "grid";
+                    carousel: "carousel";
+                }>>;
+                columns: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>;
+            readonly description: "Outer grid or carousel container for similar products.";
+        };
+        readonly ProductCard: {
+            readonly schema: z.ZodObject<{
+                product: z.ZodObject<{
+                    sku: z.ZodString;
+                    name: z.ZodString;
+                    imageUrl: z.ZodOptional<z.ZodString>;
+                    price: z.ZodOptional<z.ZodString>;
+                    originalPrice: z.ZodOptional<z.ZodString>;
+                    discountPercent: z.ZodOptional<z.ZodNumber>;
+                    url: z.ZodString;
+                    brand: z.ZodOptional<z.ZodString>;
+                    rating: z.ZodOptional<z.ZodNumber>;
+                    reviewCount: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>;
+                index: z.ZodNumber;
+                discountType: z.ZodOptional<z.ZodEnum<{
+                    inline: "inline";
+                    "strike-through": "strike-through";
+                    badge: "badge";
+                }>>;
+            }, z.core.$strip>;
+            readonly description: "A single product card with image, title, price, and actions.";
+        };
+        readonly AddToCartButton: {
+            readonly schema: z.ZodObject<{
+                sku: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+                cartCode: z.ZodString;
+            }, z.core.$strip>;
+            readonly description: "Add-to-cart CTA rendered inside or below a product card.";
+        };
+        readonly QuickActions: {
+            readonly schema: z.ZodObject<{
+                actions: z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    action: z.ZodObject<{
+                        title: z.ZodString;
+                        type: z.ZodString;
+                        payload: z.ZodOptional<z.ZodUnknown>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            readonly description: "A row of quick-action buttons below product info.";
+        };
+        readonly EmptyState: {
+            readonly schema: z.ZodObject<{
+                message: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            readonly description: "Empty state shown when no similar products are available.";
+        };
+    };
+};
+export type SimRelCatalog = typeof simRelCatalog;
+export type SimRelComponentName = keyof SimRelCatalog['components'];

package/dist/simrel/components/GroupTabs.d.ts

@@ -0,0 +1,24 @@
+import type { NormalizedProduct } from '../../common/protocol-adapter.js';
+import type { ProductGroup } from '../api.js';
+import type { SimRelI18n } from '../types.js';
+export interface GroupTabsOptions {
+    groups: ProductGroup[];
+    discountType?: 'strike-through' | 'badge' | 'inline';
+    onClick: (product: NormalizedProduct) => void;
+    onAddToCart: (params: {
+        sku: string;
+        quantity: number;
+        cartCode: string;
+    }) => void;
+    renderCard?: (product: NormalizedProduct, index: number) => string;
+    renderCardElement?: (product: NormalizedProduct, index: number) => HTMLElement | null;
+    i18n?: SimRelI18n;
+    /** ProductGrid `columns`: number of cards per desktop row. */
+    columns?: number;
+    /** User changed grouping tab (click or keyboard). */
+    onGroupingActivate?: (detail: {
+        grouping_label: string;
+        grouping_index: number;
+    }) => void;
+}
+export declare function renderGroupTabs(options: GroupTabsOptions): HTMLElement;

package/dist/simrel/components/ProductCard.d.ts

@@ -0,0 +1,19 @@
+import type { NormalizedProduct } from '../../common/protocol-adapter.js';
+import type { SimRelI18n } from '../types.js';
+import type { PriceFormatConfig } from '../../common/price-formatter.js';
+export interface ProductCardOptions {
+    product: NormalizedProduct;
+    index: number;
+    discountType?: 'strike-through' | 'badge' | 'inline';
+    onClick: (product: NormalizedProduct) => void;
+    onAddToCart: (params: {
+        sku: string;
+        quantity: number;
+        cartCode: string;
+    }) => void;
+    renderCard?: (product: NormalizedProduct, index: number) => string;
+    renderCardElement?: (product: NormalizedProduct, index: number) => HTMLElement | null;
+    i18n?: SimRelI18n;
+    pricing?: PriceFormatConfig;
+}
+export declare function renderProductCard(options: ProductCardOptions): HTMLElement;

package/dist/simrel/components/ProductGrid.d.ts

@@ -0,0 +1,17 @@
+import type { NormalizedProduct } from '../../common/protocol-adapter.js';
+import type { SimRelI18n } from '../types.js';
+export interface ProductGridOptions {
+    products: NormalizedProduct[];
+    columns?: number;
+    discountType?: 'strike-through' | 'badge' | 'inline';
+    onClick: (product: NormalizedProduct) => void;
+    onAddToCart: (params: {
+        sku: string;
+        quantity: number;
+        cartCode: string;
+    }) => void;
+    renderCard?: (product: NormalizedProduct, index: number) => string;
+    renderCardElement?: (product: NormalizedProduct, index: number) => HTMLElement | null;
+    i18n?: SimRelI18n;
+}
+export declare function renderProductGrid(options: ProductGridOptions): HTMLElement;

package/dist/simrel/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 { SimRelUISpecRenderContext } from '../types.js';
+export type SimRelUISpecRegistry = UISpecDomRegistry<SimRelUISpecRenderContext>;
+export declare const defaultSimRelUnknownUISpecRenderer: UISpecDomUnknownRenderer<SimRelUISpecRenderContext>;
+export declare function createDefaultSimRelUISpecRegistry(): SimRelUISpecRegistry;
+export declare function renderSimRelUISpec(spec: UISpec, context: SimRelUISpecRenderContext, registry?: SimRelUISpecRegistry, unknownRenderer?: UISpecDomUnknownRenderer<SimRelUISpecRenderContext>): HTMLElement;

package/dist/simrel/index.d.ts

@@ -0,0 +1,5 @@
+export * from './runtime.js';
+export { createSimRelRenderer } from './renderers/default.js';
+export type { SimRelFieldPath, SimRelRendererFields, SimRelRendererLabels, SimRelRendererMedia, SimRelRendererOptions, } from './renderers/default.js';
+export { simRelCatalog } from './catalog.js';
+export type { SimRelCatalog, SimRelComponentName } from './catalog.js';

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

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

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

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

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

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

package/dist/simrel/renderers/default.d.ts

@@ -0,0 +1,41 @@
+import type { PriceFormatConfig } from '../../common/price-formatter.js';
+import type { SimilarProduct, SimRelRendererConfig } from '../types.js';
+import './default.css';
+export type SimRelFieldPath = string | readonly string[];
+export interface SimRelRendererLabels {
+    cta?: string;
+    productInfo?: string;
+    customBadgeAlt?: string;
+    review?: (count: number) => string;
+    imageDot?: (index: number) => string;
+    previousPromotion?: string;
+    nextPromotion?: string;
+    specialPriceBadgeAlt?: string;
+}
+export interface SimRelRendererFields {
+    images?: SimRelFieldPath[];
+    subtitle?: SimRelFieldPath[];
+    promotions?: SimRelFieldPath[];
+    warranties?: SimRelFieldPath[];
+    productInfoUrl?: SimRelFieldPath[];
+    discountReason?: SimRelFieldPath[];
+    specialPrice?: SimRelFieldPath[];
+    customBadgeFacets?: SimRelFieldPath[];
+    customBadgeText?: SimRelFieldPath[];
+    customBadgeImageUrl?: SimRelFieldPath[];
+}
+export interface SimRelRendererMedia {
+    promotionIconUrl?: string;
+    specialPriceBadgeUrl?: string;
+    imageUrlTransform?: (url: string, product: SimilarProduct) => string;
+    customBadgeImageUrl?: (product: SimilarProduct, labelText: string) => string | null | undefined;
+}
+export interface SimRelRendererOptions {
+    labels?: SimRelRendererLabels;
+    fields?: SimRelRendererFields;
+    media?: SimRelRendererMedia;
+    warrantyPromotionPattern?: RegExp;
+    specialPricePattern?: RegExp;
+    pricing?: PriceFormatConfig | undefined;
+}
+export declare function createSimRelRenderer(options?: SimRelRendererOptions): SimRelRendererConfig;

package/dist/simrel/runtime.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Similar Products (SimRel) widget — public entry point.
+ *
+ * Fetches and renders similar / related products for the current SKU.
+ * Backend: POST /chat/similar_products  +  /chat/product_groupings
+ */
+import type { PageContext } from '../common/types.js';
+import type { NormalizedProduct } from '../common/protocol-adapter.js';
+import { BaseWidget } from '../common/widget-base.js';
+import type { SimRelWidgetConfig } from './types.js';
+import './components/simrel.css';
+/**
+ * Similar / related products widget for product pages.
+ * Fetches AI-powered product recommendations and renders them as a scrollable grid.
+ *
+ * @example
+ * ```ts
+ * import { GengageSimRel, bootstrapSession } from '@gengage/assistant-fe';
+ *
+ * const simrel = new GengageSimRel();
+ * await simrel.init({
+ *   accountId: 'mystore',
+ *   middlewareUrl: '<backend service location provided for your Gengage account>',
+ *   sku: '12345',
+ *   mountTarget: '#similar-products',
+ *   session: { sessionId: bootstrapSession() },
+ *   onAddToCart: ({ sku, quantity }) => cart.add(sku, quantity),
+ * });
+ * ```
+ */
+export declare class GengageSimRel extends BaseWidget<SimRelWidgetConfig> {
+    private _abortController;
+    private _contentEl;
+    private _lastSku;
+    /** Number of products returned from the last successful fetch. Used to allow
+     *  retry when the same SKU previously produced an empty result set. */
+    private _lastResultCount;
+    private _i18n;
+    private _pendingAddToCartKeys;
+    init(config: SimRelWidgetConfig): Promise<void>;
+    protected onInit(config: SimRelWidgetConfig): Promise<void>;
+    protected onUpdate(context: Partial<PageContext>): void;
+    protected onShow(): void;
+    protected onHide(): void;
+    protected onDestroy(): void;
+    _handleProductClick(product: NormalizedProduct): void;
+    _handleAddToCart(params: {
+        sku: string;
+        quantity: number;
+        cartCode: string;
+    }): Promise<void>;
+    private _abort;
+    private _isSuperseded;
+    private _emitSimilarProductsImpression;
+    private _resolveRequestTimeoutMs;
+    private _fetchAndRender;
+    private _clampGridColumns;
+    private _resolveI18n;
+    private _resolveUISpecRegistry;
+    private _buildRenderContext;
+    private _renderUISpec;
+    private _buildProductsSpec;
+    private _buildGroupsSpec;
+}
+export declare function createSimRelWidget(): GengageSimRel;
+export type { SimRelWidgetConfig, SimilarProduct, SimRelUIComponents, SimRelI18n, SimRelUISpecRenderContext, SimRelRendererConfig, } from './types.js';
+export { renderSimRelUISpec, createDefaultSimRelUISpecRegistry, defaultSimRelUnknownUISpecRenderer, } from './components/renderUISpec.js';
+export type { SimRelUISpecRegistry } from './components/renderUISpec.js';

package/dist/simrel/types.d.ts

@@ -0,0 +1,145 @@
+import type { AddToCartHandlerResult, AddToCartParams, BaseWidgetConfig, ActionPayload } from '../common/types.js';
+import type { UISpecRendererOverrides } from '../common/renderer/index.js';
+export interface SimRelWidgetConfig extends BaseWidgetConfig {
+    /** Product SKU to find similar items for. Required. */
+    sku: string;
+    /** Where to render the product grid. Required. */
+    mountTarget: HTMLElement | string;
+    /** Called when "Add to cart" is tapped on a product card. */
+    onAddToCart?: (params: AddToCartParams) => AddToCartHandlerResult;
+    /**
+     * Called when the user taps a product card (navigation intent).
+     * Return false to prevent the widget's default navigation.
+     */
+    onProductClick?: (product: SimilarProduct) => boolean | void;
+    /**
+     * Called just before navigating to a product page.
+     * Use to call window.gengage.chat.saveSession() for cross-page session continuity.
+     */
+    onProductNavigate?: (url: string, sku: string, sessionId: string | null) => void;
+    /**
+     * Override the default product card template.
+     *
+     * ⚠️ XSS WARNING: This function returns a raw HTML string injected into the DOM.
+     * You MUST sanitize any user-controlled data (e.g. product names from the API)
+     * using DOMPurify or a similar library before returning.
+     *
+     * Glov/Gengage accepts no responsibility for XSS vulnerabilities introduced
+     * by unsafe renderCard implementations.
+     */
+    renderCard?: (product: SimilarProduct, index: number) => string;
+    /**
+     * Override the default product card with a full DOM element.
+     * Unlike `renderCard` (HTML string), this returns an HTMLElement,
+     * allowing interactive elements (event listeners, state, etc.).
+     * Takes precedence over `renderCard` when both are provided.
+     */
+    renderCardElement?: (product: SimilarProduct, index: number) => HTMLElement | null;
+    /** Show the first slot as a "special" card (e.g. a promo or bundle). */
+    useSpecialCard?: boolean;
+    renderSpecialCard?: (product: SimilarProduct) => string | null;
+    /** Discount presentation: original-price strike-through, image badge, or muted inline original price. */
+    discountType?: 'strike-through' | 'badge' | 'inline';
+    /**
+     * Number of product cards per desktop row (1-12). Default: 4.
+     * Narrow screens (<=768px) keep the horizontally scrollable carousel behavior.
+     */
+    gridColumns?: number;
+    /** Client-side abort cap for similar-products and grouping requests. Defaults to 120 seconds. */
+    requestTimeoutMs?: number;
+    /**
+     * Enables the optional `/chat/product_groupings` enhancement after similar products load.
+     * Defaults to true for backward compatibility. Set false for backends without that micro-ability.
+     */
+    enableProductGroupings?: boolean;
+    domain?: string;
+    /** Locale key for SDK defaults (for example 'tr', 'en'). */
+    locale?: string;
+    i18n?: Partial<SimRelI18n>;
+    renderer?: SimRelRendererConfig;
+}
+export interface SimilarProduct {
+    sku: string;
+    name: string;
+    imageUrl?: string;
+    price?: string;
+    originalPrice?: string;
+    discountPercent?: number;
+    url: string;
+    brand?: string;
+    rating?: number;
+    reviewCount?: number;
+    cartCode?: string;
+    inStock?: boolean;
+    /** Pass-through bag for backend fields not consumed by the SDK. */
+    extras?: Record<string, unknown>;
+}
+export interface SimRelI18n {
+    similarProductsAriaLabel: string;
+    emptyStateMessage: string;
+    addToCartButton: string;
+    ctaLabel: string;
+    outOfStockLabel: string;
+    decreaseLabel: string;
+    increaseLabel: string;
+    /** Inline error message shown when similar products fail to load. */
+    errorLoadingMessage: string;
+    /** Retry button label shown alongside the error message. */
+    retryButtonText: string;
+    /**
+     * @deprecated Prefer `pricing` config on the widget for locale-aware formatting.
+     * Kept for backwards compatibility with existing custom integrations.
+     */
+    priceSuffix: string;
+    scrollTabsLeft?: string;
+    scrollTabsRight?: string;
+}
+export interface SimRelUISpecRenderContext {
+    onClick: (product: SimilarProduct) => void;
+    onAddToCart: (params: AddToCartParams) => AddToCartHandlerResult;
+    /** Fires when the shopper selects a grouping tab (not the initial tab mount). */
+    onGroupingActivate?: (detail: {
+        grouping_label: string;
+        grouping_index: number;
+    }) => void;
+    onAction?: (action: ActionPayload) => void;
+    discountType?: 'strike-through' | 'badge' | 'inline';
+    renderCard?: (product: SimilarProduct, index: number) => string;
+    renderCardElement?: (product: SimilarProduct, index: number) => HTMLElement | null;
+    i18n: SimRelI18n;
+    pricing?: import('../common/price-formatter.js').PriceFormatConfig;
+    /** Used when the ui_spec `ProductGrid` omits `columns` (widget `gridColumns`). */
+    gridColumns?: number;
+}
+export type SimRelRendererConfig = UISpecRendererOverrides<SimRelUISpecRenderContext>;
+export interface SimRelUIComponents {
+    /** The outer grid/carousel container. */
+    ProductGrid: {
+        layout?: 'grid' | 'carousel';
+        columns?: number;
+    };
+    /** A single product card in the grid. */
+    ProductCard: {
+        product: SimilarProduct;
+        index: number;
+        discountType?: 'strike-through' | 'badge' | 'inline';
+    };
+    /** Add-to-cart button inside a card. */
+    AddToCartButton: {
+        sku: string;
+        label?: string;
+        /** Cart code / variant identifier. */
+        cartCode: string;
+    };
+    /** A "quick action" row of buttons below the product info. */
+    QuickActions: {
+        actions: Array<{
+            label: string;
+            action: ActionPayload;
+        }>;
+    };
+    /** Empty state shown when no similar products are found. */
+    EmptyState: {
+        message?: string;
+    };
+}

package/dist/{simrel-C1YN71aW.js → simrel-CbLe5OAr.js}

@@ -1,7 +1,7 @@
 import { A, j as S } from "./context-BBuSsXZ9.js";
 import { n as $, t as L } from "./price-formatter-xI3g9Cd4.js";
 import { a as C, c as f, n as q, o as h, t as k, u as H } from "./schemas-CLo8wCjs.js";
-import { o as j } from "./runtime-C3yOvNFK.js";
+import { o as j } from "./runtime-iCLkUjI3.js";
 var V = {
   images: [
     "images",

package/dist/simrel-runtime.js

@@ -1,4 +1,4 @@
-import { a, i as r, n as i, r as t, t as S } from "./runtime-C3yOvNFK.js";
+import { a, i as r, n as i, r as t, t as S } from "./runtime-iCLkUjI3.js";
 export {
   S as GengageSimRel,
   t as createDefaultSimRelUISpecRegistry,