@syntrologie/adapt-search 2.8.0-canary.568

package/dist/SearchSurfaceElement.d.ts

@@ -0,0 +1,140 @@
+/**
+ * adaptive-search — `<syntro-search-surface>`
+ *
+ * The surface paints a layout skeleton the moment the shopper presses Enter,
+ * then fills each named region in place as content arrives. Nothing ever
+ * moves after the first paint: a shopper reading the first region must not
+ * have it slide out from under them when the second one resolves.
+ *
+ * Shadow DOM, deliberately. This element covers a merchant's whole viewport
+ * over their own markup, so their stylesheet must not reach in and ours must
+ * not leak out. The `--sc-*` theme tokens inherit through the boundary, which
+ * is how the surface ends up wearing the merchant's brand without this file
+ * naming a single colour.
+ *
+ * The tag must start with `syntro-`: the search interceptor bails on any
+ * element whose tag has that prefix, which is what keeps a shopper's Enter
+ * inside our own follow-up bar from re-triggering the takeover.
+ */
+import { LitElement, nothing, type TemplateResult } from 'lit';
+import { type SurfaceRegion, type SurfaceVariant } from './variants';
+export declare const SEARCH_SURFACE_TAG = "syntro-search-surface";
+export declare class SearchSurfaceElement extends LitElement {
+    static properties: {
+        _variant: {
+            state: boolean;
+        };
+        _query: {
+            state: boolean;
+        };
+        _filled: {
+            state: boolean;
+        };
+        _suppressed: {
+            state: boolean;
+        };
+        _dismissed: {
+            state: boolean;
+        };
+        _frozen: {
+            state: boolean;
+        };
+        _announcement: {
+            state: boolean;
+        };
+    };
+    private _variant;
+    private _query;
+    private _filled;
+    private _suppressed;
+    /**
+     * Handles the shopper hid, as a Set so the render path is a lookup rather
+     * than a scan of every tile. Replaced, never mutated in place: Lit's dirty
+     * check is identity-based and a mutated Set would not repaint.
+     */
+    private _dismissed;
+    private _frozen;
+    private _announcement;
+    constructor();
+    static styles: import("lit").CSSResult;
+    /**
+     * Paint the variant's skeleton. Ignored once the surface is frozen, because
+     * a server plan that lands after the first content has painted would
+     * otherwise throw away what the shopper is already reading.
+     */
+    showSkeleton(variant: SurfaceVariant, query: string): void;
+    /**
+     * Fill one region in place. The region keeps its position, so the page does
+     * not reflow around the shopper. A region id this variant does not own, or
+     * one already retired by `suppressRegion`, has nowhere to paint.
+     *
+     * Returns whether the region actually painted. The runtime needs that answer
+     * to tell "the plan filled a region" from "the plan addressed a variant this
+     * surface is not showing": a dropped fill counted as content would leave the
+     * shopper on a skeleton the SDK had already scored as a success.
+     */
+    fillRegion(region: SurfaceRegion): boolean;
+    /** Content this renderer can display, including payload validation and dismissals. */
+    getRegionContent(id: string): {
+        productCount: number;
+        hasAnswer: boolean;
+    };
+    /**
+     * Retire a slot the plan decided not to fill. The slot leaves the grid
+     * entirely — no skeleton, no `aria-busy`, nothing for the live region to
+     * count — and every other slot keeps its order. Left in place, a region that
+     * is never going to fill pulses beside real results for as long as the
+     * shopper reads them.
+     *
+     * Idempotent, ignored for an id this variant does not own, and allowed after
+     * the surface has frozen: suppression is not a repaint, it only removes a
+     * slot that was never going to say anything.
+     */
+    suppressRegion(id: string): void;
+    /**
+     * Hide one product, everywhere, for the rest of this surface.
+     *
+     * Optimistic on purpose: the shopper tapped the tile's own dismiss button,
+     * so the tile goes now rather than after a round trip that may legitimately
+     * come back with nothing to patch. And it OUTLIVES the payload it was tapped
+     * in — a later repaint of the same region, or a whole new plan on a surface
+     * with no server session, must not hand back the product just rejected.
+     */
+    dismissProduct(handle: string): void;
+    /**
+     * Drop one chip from the follow-up bar without waiting for a server repaint.
+     *
+     * Only reachable when the bar is showing server chips and the surface has no
+     * live session to patch — an expired one, in practice. With a session the
+     * server repaints the bar and this is never called.
+     */
+    removeChip(key: string): void;
+    /**
+     * The container a widget mounts into for this region, or `null` when the
+     * region paints no mountable module.
+     *
+     * The surface renders `search:chat` as an empty box and nothing else: the
+     * conversation here is the SDK's own chat widget, mounted by the runtime
+     * through its widget registry, never a second chat implementation living in
+     * this package. This is the whole affordance that makes that possible.
+     */
+    mountTarget(regionId: string): HTMLElement | null;
+    /** The query region as the plan filled it, if the plan filled it at all. */
+    private _filledQueryRegion;
+    /** Hold the current variant for the rest of this turn. */
+    freeze(): void;
+    /**
+     * Only ever called after a region has filled, so "nothing here" is a
+     * finished answer, not a loading state. The skeleton is what says "still
+     * loading", and it says it visually while the live region stays silent.
+     */
+    private _announce;
+    private _onSeeStoreResults;
+    private _renderQueryRegion;
+    private _renderRegion;
+    private _renderSkeleton;
+    render(): TemplateResult | typeof nothing;
+}
+/** Define `<syntro-search-surface>` once. Safe to call from every entry point. */
+export declare function registerSearchSurfaceElement(): void;
+//# sourceMappingURL=SearchSurfaceElement.d.ts.map

package/dist/SearchSurfaceElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchSurfaceElement.d.ts","sourceRoot":"","sources":["../src/SearchSurfaceElement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAa,UAAU,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAU1E,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAc1D,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,OAAgB,UAAU;;;;;;;;;;;;;;;;;;;;;;MAQxB;IAKF,QAAgB,QAAQ,CAAwB;IAChD,QAAgB,MAAM,CAAS;IAC/B,QAAgB,OAAO,CAAgC;IACvD,QAAgB,WAAW,CAAoB;IAC/C;;;;OAIG;IACH,QAAgB,UAAU,CAAsB;IAChD,QAAgB,OAAO,CAAU;IACjC,QAAgB,aAAa,CAAS;;IAatC,OAAgB,MAAM,0BA4RpB;IAEF;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS1D;;;;;;;;;OASG;IACH,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAU1C,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;IAU1E;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAYhC;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOpC;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAS7B;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAOjD,4EAA4E;IAC5E,OAAO,CAAC,kBAAkB;IAU1B,0DAA0D;IAC1D,MAAM,IAAI,IAAI;IAId;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,kBAAkB,CAExB;IAEF,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,eAAe;IASd,MAAM,IAAI,cAAc,GAAG,OAAO,OAAO;CAiBnD;AAED,kFAAkF;AAClF,wBAAgB,4BAA4B,IAAI,IAAI,CAKnD"}

package/dist/cdn.d.ts

@@ -0,0 +1,52 @@
+/**
+ * CDN Entry Point for Adaptive Search
+ *
+ * Bundled for CDN delivery and loaded on demand by the host runtime's
+ * AppLoader when the search takeover is armed for a workspace. Mirrors
+ * adaptive-faq/src/cdn.ts: builds the manifest from the runtime export, then
+ * self-registers with the host's app registry on import.
+ *
+ * Without this entry, build-adaptives-only.js silently skips the package,
+ * `widgets.has('adaptive-search:surface')` is false forever, and the takeover
+ * never fires on a real storefront however green the tests are.
+ */
+export declare const manifest: {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    runtime: {
+        actions: {
+            kind: never;
+            executor: never;
+        }[];
+        widgets: {
+            id: string;
+            component: {
+                mount(container: HTMLElement, config?: (import("./schema").SearchSurfaceConfig & import("packages/sdk-contracts/dist").MountPlumbing) | null): () => void;
+            };
+            metadata: {
+                name: string;
+                description: string;
+                icon: string;
+                slots: string[];
+            };
+        }[];
+        notifyWatchers: unknown;
+        events: unknown;
+    };
+    metadata: {
+        isBuiltIn: boolean;
+    };
+};
+declare global {
+    interface Window {
+        SynOS?: {
+            appRegistry?: {
+                register?: (m: unknown) => void;
+            };
+        };
+    }
+}
+export default manifest;
+//# sourceMappingURL=cdn.d.ts.map

package/dist/cdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn.d.ts","sourceRoot":"","sources":["../src/cdn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcpB,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,KAAK,CAAC,EAAE;YACN,WAAW,CAAC,EAAE;gBACZ,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;aACjC,CAAC;SACH,CAAC;KACH;CACF;AASD,eAAe,QAAQ,CAAC"}

package/dist/cdn.js

@@ -0,0 +1,33 @@
+import {
+  runtime
+} from "./chunk-3KPQ5AOG.js";
+import "./chunk-NKOTQPVZ.js";
+
+// src/cdn.ts
+var manifest = {
+  id: runtime.id,
+  version: runtime.version,
+  name: runtime.name,
+  description: runtime.description,
+  runtime: {
+    actions: (runtime.executors ?? []).map(({ kind, executor }) => ({ kind, executor })),
+    widgets: runtime.widgets,
+    notifyWatchers: runtime.notifyWatchers,
+    events: runtime.eventHandlers
+  },
+  metadata: {
+    isBuiltIn: false
+  }
+};
+if (typeof window !== "undefined") {
+  const registry = window.SynOS?.appRegistry;
+  if (registry && typeof registry.register === "function") {
+    registry.register(manifest);
+  }
+}
+var cdn_default = manifest;
+export {
+  cdn_default as default,
+  manifest
+};
+//# sourceMappingURL=cdn.js.map

package/dist/cdn.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/cdn.ts"],
+  "sourcesContent": ["/**\n * CDN Entry Point for Adaptive Search\n *\n * Bundled for CDN delivery and loaded on demand by the host runtime's\n * AppLoader when the search takeover is armed for a workspace. Mirrors\n * adaptive-faq/src/cdn.ts: builds the manifest from the runtime export, then\n * self-registers with the host's app registry on import.\n *\n * Without this entry, build-adaptives-only.js silently skips the package,\n * `widgets.has('adaptive-search:surface')` is false forever, and the takeover\n * never fires on a real storefront however green the tests are.\n */\n\nimport { runtime } from './runtime';\n\nexport const manifest = {\n  id: runtime.id,\n  version: runtime.version,\n  name: runtime.name,\n  description: runtime.description,\n  runtime: {\n    actions: (runtime.executors ?? []).map(({ kind, executor }) => ({ kind, executor })),\n    widgets: runtime.widgets,\n    notifyWatchers: (runtime as { notifyWatchers?: unknown }).notifyWatchers,\n    events: (runtime as { eventHandlers?: unknown }).eventHandlers,\n  },\n  metadata: {\n    isBuiltIn: false,\n  },\n};\n\ndeclare global {\n  interface Window {\n    SynOS?: {\n      appRegistry?: {\n        register?: (m: unknown) => void;\n      };\n    };\n  }\n}\n\nif (typeof window !== 'undefined') {\n  const registry = window.SynOS?.appRegistry;\n  if (registry && typeof registry.register === 'function') {\n    registry.register(manifest);\n  }\n}\n\nexport default manifest;\n"],
+  "mappings": ";;;;;;AAeO,IAAM,WAAW;AAAA,EACtB,IAAI,QAAQ;AAAA,EACZ,SAAS,QAAQ;AAAA,EACjB,MAAM,QAAQ;AAAA,EACd,aAAa,QAAQ;AAAA,EACrB,SAAS;AAAA,IACP,UAAU,QAAQ,aAAa,CAAC,GAAG,IAAI,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAS,EAAE;AAAA,IACnF,SAAS,QAAQ;AAAA,IACjB,gBAAiB,QAAyC;AAAA,IAC1D,QAAS,QAAwC;AAAA,EACnD;AAAA,EACA,UAAU;AAAA,IACR,WAAW;AAAA,EACb;AACF;AAYA,IAAI,OAAO,WAAW,aAAa;AACjC,QAAM,WAAW,OAAO,OAAO;AAC/B,MAAI,YAAY,OAAO,SAAS,aAAa,YAAY;AACvD,aAAS,SAAS,QAAQ;AAAA,EAC5B;AACF;AAEA,IAAO,cAAQ;",
+  "names": []
+}