@wix/web5-core 1.56.1 → 1.57.0

package/dist/types/utils/entityLinkParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entityLinkParser.d.ts","sourceRoot":"","sources":["../../../src/utils/entityLinkParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,WAAW,EAEX,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,gBAAgB,CAAC;AAIrB;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA6E9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,YAAY,GAAG,SAAS,CA8B1B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GACV;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0BjD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW/D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY,GAAG,IAAI,CAgClE"}
+{"version":3,"file":"entityLinkParser.d.ts","sourceRoot":"","sources":["../../../src/utils/entityLinkParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACL,WAAW,EAEX,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,gBAAgB,CAAC;AAIrB;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA+E9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAKD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,YAAY,GAAG,SAAS,CA8B1B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GACV;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0BjD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW/D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY,GAAG,IAAI,CAgClE"}

package/dist/types/utils/imageBackdrop.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Result of inspecting an image's edges to decide how it should sit in a slot
+ * whose aspect ratio differs from the image's own.
+ *
+ * The problem: a single CSS `object-fit` can't serve both kinds of imagery a
+ * conversational page surfaces. Product cutouts (subject on a seamless white
+ * sweep, or a transparent PNG) must never be cropped — `cover` chops the
+ * product. Full-bleed scenes (a model in a street, a flat-lay that fills the
+ * frame) look broken when letterboxed — they want `cover`.
+ *
+ * We can't tell these apart from the resolver metadata (it only exposes url +
+ * optional dimensions), so we sniff the pixels: sample the image's border ring
+ * and ask "is there a consistent backdrop colour behind the subject?".
+ *  - Consistent border  → seamless backdrop → render `contain` and paint the
+ *    slot that backdrop colour, so the "letterbox" becomes an invisible
+ *    extension of the image's own sweep (white shoe → white fill; green
+ *    sweater sweep → green fill). The whole subject is always visible.
+ *  - Noisy border       → edge-to-edge scene → render `cover`; cropping the
+ *    margins is safe and letterboxing would look wrong.
+ */
+export interface BackdropAnalysis {
+    /** True when the border reads as a seamless backdrop (uniform or transparent). */
+    hasBackdrop: boolean;
+    /**
+     * CSS colour to paint behind a `contain`ed image so the letterbox blends.
+     * `'transparent'` for cutouts with an alpha border (the page background then
+     * shows through). Undefined when `hasBackdrop` is false.
+     */
+    backgroundColor?: string;
+}
+/**
+ * Inspect the 1px border ring of an RGBA buffer and classify the backdrop.
+ * Pure and synchronous so it can be unit-tested without a DOM.
+ */
+export declare function analyzeBackdrop(data: Uint8ClampedArray, width: number, height: number): BackdropAnalysis;
+/**
+ * Bounding box of the non-background content in a probed image, in sample-grid
+ * coordinates (0..size-1), plus the sampled background colour. Used by callers
+ * that need *where the subject sits* (e.g. crop-safety in a fixed-aspect slot),
+ * which is a different question from `analyzeBackdrop`'s "is there a backdrop".
+ */
+export interface ContentBBox {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+    /** Background colour, sampled from the top-left pixel. */
+    background: {
+        r: number;
+        g: number;
+        b: number;
+    };
+}
+/**
+ * Find the bounding box of the subject by treating the top-left pixel as the
+ * background colour and flagging every pixel that differs from it (or is
+ * transparent). Pure and synchronous. Returns null for an all-background frame.
+ *
+ * `backgroundTolerance`/`alphaThreshold` default to the values tuned for
+ * uniform studio catalog shots; callers can override.
+ */
+export declare function computeContentBBox(data: Uint8ClampedArray, size: number, options?: {
+    backgroundTolerance?: number;
+    alphaThreshold?: number;
+}): ContentBBox | null;
+/**
+ * Build the URL of a tiny, aspect-preserving (`fit`) version of an image so we
+ * can read its true edges. Wix media is downscaled by the CDN; other URLs are
+ * probed at full size (still drawn onto a small canvas).
+ */
+export declare function buildProbeUrl(effectiveFilename: string): string;
+/** RGBA pixels of a probed image, drawn onto a `size`×`size` grid, alongside the
+ *  source's true intrinsic dimensions (needed for aspect-aware crop math). */
+export interface ImagePixels {
+    data: Uint8ClampedArray;
+    size: number;
+    naturalWidth: number;
+    naturalHeight: number;
+}
+/**
+ * Shared probe plumbing: load a (downscaled, for Wix) version of the image
+ * cross-origin, draw it onto a `size`×`size` canvas, and return its pixels plus
+ * intrinsic dimensions. Resolves to `null` on any failure — missing DOM, a
+ * data/blob source, a load error, or a tainted canvas (if CORS ever regresses)
+ * — so every caller can fall back to its own default. Browser-only.
+ *
+ * Both the backdrop classifier (`loadBackdropAnalysis`) and bounding-box callers
+ * build on this so the canvas/CORS/taint handling lives in exactly one place.
+ */
+export declare function loadImagePixels(effectiveFilename: string, options?: {
+    size?: number;
+}, signal?: {
+    aborted: boolean;
+}): Promise<ImagePixels | null>;
+/**
+ * Load a probe image and analyze its backdrop. Resolves to `NO_BACKDROP` on any
+ * failure so callers fall back to their default fit. Browser-only.
+ */
+export declare function loadBackdropAnalysis(effectiveFilename: string, signal?: {
+    aborted: boolean;
+}): Promise<BackdropAnalysis>;
+//# sourceMappingURL=imageBackdrop.d.ts.map

package/dist/types/utils/imageBackdrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageBackdrop.d.ts","sourceRoot":"","sources":["../../../src/utils/imageBackdrop.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAwBD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,gBAAgB,CAkElB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE,WAAW,GAAG,IAAI,CAmCpB;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAa/D;AAED;8EAC8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,iBAAiB,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3B,MAAM,CAAC,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA+C7B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,MAAM,EACzB,MAAM,CAAC,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAO3B"}

package/dist/types/utils/intentExtractor.d.ts

@@ -1,11 +1,28 @@
-import { Intent } from '../registry/Intent';
 export type ResponseState = 'full' | 'partial';
 export interface IntentInfo {
-    intent: Intent;
+    intent: string;
     stage?: string;
     reason?: string;
     state?: ResponseState;
 }
-export declare function extractIntentFromMarkdown(markdown: string): IntentInfo | null;
-export declare function getIntentFromMarkdown(markdown: string, defaultIntent?: Intent): IntentInfo;
+/**
+ * Controls how a raw intent string is validated / defaulted during extraction.
+ * Core holds NO intent list of its own — the taxonomy is client-specific. A
+ * caller supplies the client's list (typically `registry.getKnownIntents()`) to
+ * make the FE honour that client's intents; with no list, any emitted intent is
+ * accepted verbatim (resolution then falls back to the section default when the
+ * intent has no registered variant).
+ */
+export interface IntentExtractionOptions {
+    /**
+     * The intents to accept (matched case-insensitively). An emitted intent
+     * outside this list is treated as absent. When omitted, no filtering is
+     * applied and the emitted intent passes through as-is.
+     */
+    validIntents?: readonly string[];
+    /** Intent assumed when the markdown carries no intent annotation. Defaults to ''. */
+    defaultIntent?: string;
+}
+export declare function extractIntentFromMarkdown(markdown: string, options?: IntentExtractionOptions): IntentInfo | null;
+export declare function getIntentFromMarkdown(markdown: string, options?: IntentExtractionOptions): IntentInfo;
 //# sourceMappingURL=intentExtractor.d.ts.map

package/dist/types/utils/intentExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intentExtractor.d.ts","sourceRoot":"","sources":["../../../src/utils/intentExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAiBD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAwB7E;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,GAAE,MAAyB,GACvC,UAAU,CAOZ"}
+{"version":3,"file":"intentExtractor.d.ts","sourceRoot":"","sources":["../../../src/utils/intentExtractor.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAsBD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,UAAU,GAAG,IAAI,CAwBnB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,UAAU,CAOZ"}

package/dist/types/utils/productBackHandoff.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Product-page → full-app "back" context hand-off (DL #114).
+ *
+ * A PDP placement writes the product context to `sessionStorage` immediately
+ * before redirecting the visitor to the full Web5 page; the app reads it once
+ * on load and renders a back-to-product badge in the conversation header.
+ *
+ * The context never enters the URL, so there is no shareable/tamperable link
+ * that could spoof the header (the security driver in DL #114). The hand-off
+ * relies on the redirect being a same-origin, same-tab top-level navigation
+ * (`searchRedirectUrl`, e.g. `/ai`), which is what keeps `sessionStorage`
+ * readable on the other side. Cross-origin → nothing is read → no badge.
+ */
+export declare const PRODUCT_BACK_SESSION_KEY = "web5:productBack";
+export interface ProductBackHandoff {
+    /** Product display name (first-party; e.g. the PDP `og:title`). */
+    title?: string;
+    /** Product thumbnail URL (first-party; e.g. the PDP `og:image`). */
+    imageUrl?: string;
+    /** The product page to return to — the PDP's own URL. */
+    backUrl?: string;
+    /** Epoch ms when written; the reader drops stale entries. */
+    ts?: number;
+}
+/**
+ * Write the back-context just before navigating away from a product page.
+ * Values default to the page's own first-party Open Graph tags and URL, so a
+ * standard PDP needs no extra wiring; pass `overrides` to supply exact data.
+ * No-op outside the browser or when no product title can be determined.
+ */
+export declare function writeProductBackHandoff(overrides?: {
+    title?: string;
+    imageUrl?: string;
+    backUrl?: string;
+}): void;
+/**
+ * Read and immediately delete the back-context (consume-once: survives exactly
+ * one page load, so a reload or bfcache restore won't replay it). Returns null
+ * when absent or unparseable. Callers must still validate the values before use
+ * (freshness window, allowed-domain check on `backUrl`, `https:` on `imageUrl`).
+ */
+export declare function readProductBackHandoff(): ProductBackHandoff | null;
+//# sourceMappingURL=productBackHandoff.d.ts.map

package/dist/types/utils/productBackHandoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"productBackHandoff.d.ts","sourceRoot":"","sources":["../../../src/utils/productBackHandoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAoCD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,CAAC,EAAE;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAuBP;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,GAAG,IAAI,CAmBlE"}

package/dist/types/utils/refreshPrompts.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Refresh-prompts flag (debug-only).
+ *
+ * When active, the Turn RPC request (`POST /v1/turn`, DL #110) carries
+ * `additionalData.refresh_prompts: 'true'`, asking the BE to re-pull prompts
+ * instead of serving cached ones.
+ *
+ * Keeping it on slows the app, so the flag self-expires: rather than a bare
+ * boolean we persist an expiry timestamp in
+ * `localStorage["web5_refresh_prompts_until"]`. `shouldRefreshPrompts()` is
+ * true only while now < expiry, so the cap holds even across reloads or if a
+ * UI timer never fires. Lives in web5-core so the request builder and any
+ * surface honor the same toggle.
+ */
+export declare const REFRESH_PROMPTS_UNTIL_KEY = "web5_refresh_prompts_until";
+/** How long the flag stays active once enabled (2 minutes). */
+export declare const REFRESH_PROMPTS_WINDOW_MS: number;
+/**
+ * Read the expiry timestamp (ms epoch) from localStorage. Returns 0 when
+ * unset, invalid, or storage is unavailable.
+ */
+export declare const getRefreshPromptsExpiry: () => number;
+/** Whether the refresh-prompts flag is currently active (within its window). */
+export declare const shouldRefreshPrompts: () => boolean;
+/**
+ * Activate the flag for `windowMs` from now and return the new expiry
+ * timestamp. Re-enabling restarts the window.
+ */
+export declare const enableRefreshPrompts: (windowMs?: number) => number;
+/** Deactivate the flag immediately (proactive off). */
+export declare const disableRefreshPrompts: () => void;
+//# sourceMappingURL=refreshPrompts.d.ts.map

package/dist/types/utils/refreshPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refreshPrompts.d.ts","sourceRoot":"","sources":["../../../src/utils/refreshPrompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,yBAAyB,+BAA+B,CAAC;AAEtE,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB,QAAgB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAO,MAY1C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,QAAO,OACA,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,cACrB,MAAM,KACf,MAQF,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,QAAO,IAMxC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wix/web5-core",
   "license": "MIT",
-  "version": "1.56.1",
+  "version": "1.57.0",
   "author": {
     "name": "tsachis",
     "email": "tsachis@wix.com"
@@ -100,5 +100,5 @@
   "wallaby": {
     "autoDetect": true
   },
-  "falconPackageHash": "ddcfd2461f54a7f6bce7c9799d570b3aa2f85da1923cca6e4afb6bb4"
+  "falconPackageHash": "d81e7d4252b50b94d46bdb6c4a55696d95b2787761303c708cb8bf9e"
 }

package/src/components/placement/PlacementResponseRenderer.css

@@ -133,10 +133,6 @@
   outline-offset: 2px;
 }
 
-.w5-placement__show-more-icon {
-  flex: none;
-}
-
 .w5-placement__eyebrow {
   display: flex;
   align-items: center;

package/src/components/ui/SectionSkeleton.css

@@ -9,6 +9,25 @@
   pointer-events: none;
   user-select: none;
   padding-block: 4rem;
+  /* `min-height` (per-shape, below) includes the block padding so the reserved
+     space matches the eventual section regardless of the consuming app's reset. */
+  box-sizing: border-box;
+}
+
+/* Per-section-type height reservation (DL #114 C) — approximate the eventual
+   section so the skeleton→content swap causes near-zero layout shift below it.
+   Erring slightly tall is preferable (content settles up, not down). */
+.w5-skeleton--cards {
+  min-height: 28rem;
+}
+.w5-skeleton--tiles {
+  min-height: 14rem;
+}
+.w5-skeleton--rows {
+  min-height: 18rem;
+}
+.w5-skeleton--lines {
+  min-height: 10rem;
 }
 
 @media (min-width: 64rem) {

package/src/components/ui/UserQuery.css

@@ -0,0 +1,72 @@
+/* Product-page back badge (DL #114) — self-contained CSS so the badge renders
+   styled even where the consumer doesn't compile Tailwind from web5-core/src.
+   Mounted inside the shared `UserQuery` header; clients can re-skin via the
+   `--web5-product-back-*` custom properties, or replace the whole header via
+   the `UserQueryComponent` UI slot. */
+
+/* Left column: the badge row stacked above the user's query, with the row→query
+   gap. Used whether or not a badge is present (harmless with a single child). */
+.web5-user-query__left {
+  display: flex;
+  flex-direction: column;
+  gap: var(--web5-user-query-row-gap, 11px);
+  min-width: 0;
+}
+
+/* Badge row: back arrow + thumbnail + product name. */
+.web5-user-query__product-back {
+  display: flex;
+  align-items: center;
+  gap: var(--web5-product-back-gap, 11px);
+  min-width: 0;
+  max-width: var(--web5-product-back-max-width, 440px);
+  margin: 0;
+  padding: 0;
+  background: transparent;
+  border: 0;
+  text-align: left;
+  color: inherit;
+  cursor: pointer;
+  transition: color 0.15s ease;
+}
+
+/* Non-clickable variant (no validated backUrl). */
+.web5-user-query__product-back--static {
+  cursor: default;
+}
+
+.web5-user-query__product-back-icon {
+  flex: none;
+}
+
+.web5-user-query__product-back-thumb {
+  flex: none;
+  width: var(--web5-product-thumb-size, 34px);
+  height: var(--web5-product-thumb-size, 34px);
+  border-radius: var(--web5-product-thumb-radius, 3px);
+  border: 1px solid var(--web5-product-thumb-border, #f1f0ee);
+  overflow: hidden;
+  background: #fff;
+}
+
+.web5-user-query__product-back-thumb img {
+  display: block;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.web5-user-query__product-back-title {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: var(--web5-product-back-title-size, 16px);
+  line-height: var(--web5-product-back-title-line-height, 20px);
+  font-weight: var(--web5-product-back-title-weight, 500);
+  color: var(--web5-product-back-title-color, var(--body-text-color, #2b2b2b));
+}
+
+.web5-user-query__product-back:hover .web5-user-query__product-back-title {
+  text-decoration: underline;
+}

package/src/styles/base-utilities.css

@@ -378,6 +378,41 @@
   100% { background-position: 200% 0; }
 }
 
+/* Section content reveal (DL #114 C) — a one-shot fade/slide-in applied the first
+   time a streamed section swaps from its skeleton to real content, so it appears
+   smoothly instead of popping in. Motion is suppressed under reduced-motion. */
+@keyframes w5-section-in {
+  from { opacity: 0; transform: translateY(16px); }
+  to { opacity: 1; transform: none; }
+}
+.w5-section-enter {
+  animation: w5-section-in 360ms ease-out both;
+}
+@media (prefers-reduced-motion: reduce) {
+  .w5-section-enter {
+    animation: none;
+  }
+}
+
+/* Section skeleton entrance (DL #114 C) — when a section's skeleton first shows
+   up it unfolds from the top (scaleY) so it grows into place instead of popping
+   in at full height. Transform-based, so it doesn't shift the sections below
+   (their space is already reserved). Shared by every client skeleton (core
+   default + per-client overrides) via `w5-skeleton-expand`. Reduced-motion off. */
+@keyframes w5-skeleton-expand {
+  from { opacity: 0; transform: scaleY(0); }
+  to { opacity: 1; transform: scaleY(1); }
+}
+.w5-skeleton-expand {
+  transform-origin: top center;
+  animation: w5-skeleton-expand 320ms ease-out both;
+}
+@media (prefers-reduced-motion: reduce) {
+  .w5-skeleton-expand {
+    animation: none;
+  }
+}
+
 /* Global accessible focus indicator — only visible on keyboard navigation */
 :focus-visible {
   outline: 2px solid rgba(128, 0, 177, 0.5);

package/src/styles/components.css

@@ -2,5 +2,6 @@
 @import '../components/ui/PromptEntryEmptyState.css';
 @import '../components/ui/FeedbackBar.css';
 @import '../components/ui/Disclaimer.css';
+@import '../components/ui/UserQuery.css';
 @import '../components/ui/PlacementLoader.css';
 @import '../components/placement/PlacementResponseRenderer.css';

package/src/styles/host-reset.css

@@ -0,0 +1,81 @@
+/*
+ * host-reset.css — re-establishes the Web5 typographic baseline inside the
+ * mount root.
+ *
+ * Tailwind's preflight already neutralises most of what a host theme imposes
+ * (margins, list markers, heading font-size/weight, link decoration), and the
+ * build scopes it to the root, so inside Web5 it outranks the theme. What
+ * preflight does NOT cover is everything it expects to inherit from `html`:
+ * font-family, line-height, letter-spacing, text-transform and colour. A theme
+ * that sets those on its rich-text wrapper — `.rte p { line-height: 1.4 }`,
+ * `.rte h1 { font-family: … }` — still wins there, because inheritance loses to
+ * any matching rule.
+ *
+ * So each of those properties is re-asserted here at element specificity. After
+ * scoping these become `(1,0,1)`: above a theme's `(0,1,1)` descendant rules,
+ * below our own `(1,1,0)` utilities. That ordering is the whole point — the
+ * theme is overridden, atoms still win.
+ *
+ * Wrapped in `@layer base` so Storybook (which compiles this file without the
+ * scoping pass) keeps the same relationship to utilities as the shipped bundle.
+ *
+ * `#root` is rewritten to the scope selector by `config/scope-css.ts`.
+ */
+
+@layer base {
+  /*
+   * The baseline every descendant inherits. Without it the root inherits the
+   * theme's body type — 14px/1.4 on the reference store — and every element we
+   * do not explicitly size comes out wrong.
+   *
+   * `--w5-root-font-size` is the escape hatch for themes that rescale the root
+   * (`html { font-size: 62.5% }` is a common pattern): a client sets it in
+   * `users/<msid>/theme.css` to bring our rem-based scale back to intent.
+   */
+  #root {
+    font-family: var(--font-sans);
+    font-size: var(--w5-root-font-size, 1rem);
+    font-style: normal;
+    font-weight: 400;
+    line-height: 1.5;
+    letter-spacing: normal;
+    text-align: start;
+    text-transform: none;
+    color: hsl(var(--foreground));
+  }
+
+  /* Headings take the display face regardless of what the theme sets on its
+   * rich-text headings. Sizes and weights come from the Heading atom. */
+  :is(h1, h2, h3, h4, h5, h6) {
+    font-family: var(--font-display);
+    letter-spacing: inherit;
+    text-transform: none;
+    color: inherit;
+  }
+
+  /* Everything that carries body copy inherits our baseline rather than the
+   * theme's rich-text rules. */
+  :is(p, li, dd, dt, blockquote, figcaption, label, td, th, address, small) {
+    font-family: inherit;
+    font-size: inherit;
+    line-height: inherit;
+    letter-spacing: inherit;
+    text-transform: none;
+    color: inherit;
+  }
+
+  /* Links: preflight already inherits colour and decoration; themes also set
+   * the face and casing on them. */
+  a {
+    font-family: inherit;
+    letter-spacing: inherit;
+    text-transform: none;
+  }
+
+  /* Form controls inherit the face from preflight but not the rest, and the
+   * conversation input is a form control. */
+  :is(button, input, optgroup, select, textarea) {
+    letter-spacing: inherit;
+    text-transform: none;
+  }
+}

package/src/styles/tailwind-theme.css

@@ -117,12 +117,12 @@
   --leading-body-sm: var(--body-small-text-line-height);
   --leading-callout: 36px;
 
-  /* Placement card body copy — short framing / conversation answers.
-     Figma 128:5257 (Web5_Proto): 20/30, medium weight body with bold
-     leading-phrase emphasis. Used by `PlacementGeneralTextSection` (the
-     placement variant of the fallback section). */
-  --text-placement-body: 20px;
-  --leading-placement-body: 30px;
+  /* Placement card body copy — short framing / conversation answers and the
+     search-overview lead block. Medium weight body with bold leading-phrase
+     emphasis. Used by `PlacementGeneralTextSection` (the placement variant of
+     the fallback section) and `SearchOverviewSection`. */
+  --text-placement-body: 16px;
+  --leading-placement-body: 24px;
 }
 
 /* Font tokens use @theme inline so utilities emit `font-family: var(--font-*)`

package/dist/cjs/registry/Intent.js

@@ -1,19 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.Intent = void 0;
-let Intent = exports.Intent = /*#__PURE__*/function (Intent) {
-  // New intent taxonomy
-  Intent["COMPARISON"] = "COMPARISON";
-  Intent["DECISION"] = "DECISION";
-  Intent["VALIDATION"] = "VALIDATION";
-  Intent["STRATEGY"] = "STRATEGY";
-  Intent["EXPLORATION"] = "EXPLORATION";
-  Intent["INQUIRY"] = "INQUIRY";
-  // Legacy intents (still used in hero registrations and intentExtractor)
-  Intent["DISCOVERY"] = "DISCOVERY";
-  Intent["LEARN"] = "LEARN";
-  Intent["EVALUATE"] = "EVALUATE";
-  return Intent;
-}({});
-//# sourceMappingURL=Intent.js.map

package/dist/cjs/registry/Intent.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["Intent","exports"],"sources":["../../../src/registry/Intent.ts"],"sourcesContent":["export enum Intent {\n  // New intent taxonomy\n  COMPARISON = 'COMPARISON',\n  DECISION = 'DECISION',\n  VALIDATION = 'VALIDATION',\n  STRATEGY = 'STRATEGY',\n  EXPLORATION = 'EXPLORATION',\n  INQUIRY = 'INQUIRY',\n  // Legacy intents (still used in hero registrations and intentExtractor)\n  DISCOVERY = 'DISCOVERY',\n  LEARN = 'LEARN',\n  EVALUATE = 'EVALUATE',\n}\n"],"mappings":";;;;IAAYA,MAAM,GAAAC,OAAA,CAAAD,MAAA,0BAANA,MAAM;EAChB;EADUA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAQhB;EARUA,MAAM;EAANA,MAAM;EAANA,MAAM;EAAA,OAANA,MAAM;AAAA","ignoreList":[]}

package/dist/cjs/utils/conversationApi.js

@@ -1,52 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.usesTurnApi = exports.setConversationApi = exports.getConversationApi = exports.DEFAULT_CONVERSATION_API = exports.CONVERSATION_API_KEY = void 0;
-/**
- * Conversation API selection (debug-only).
- *
- * Switches the conversation between the default `Conversation` RPC
- * (`POST /v1/conversation`) and the parallel-safe `Turn` RPC
- * (`POST /v1/turn`, DL #110). Persisted in
- * `localStorage["web5_conversation_api"]`, read at request time. Default
- * `conversation` (Turn is opt-in via the debug toggle for now).
- *
- * `Turn` returns a flat markdown stream (no sectioned page frames), so the
- * sectioned-stream consumption path only runs on the `Conversation` API. Lives
- * in web5-core so any surface can honor the same toggle.
- */
-
-const CONVERSATION_API_KEY = exports.CONVERSATION_API_KEY = 'web5_conversation_api';
-const DEFAULT_CONVERSATION_API = exports.DEFAULT_CONVERSATION_API = 'conversation';
-
-/**
- * Read the selected conversation API from localStorage. Falls back to the
- * default (`conversation`) when unset, invalid, or storage is unavailable.
- */
-const getConversationApi = () => {
-  try {
-    const value = localStorage.getItem(CONVERSATION_API_KEY);
-    if (value === 'turn' || value === 'conversation') {
-      return value;
-    }
-  } catch {
-    // localStorage can throw in privacy mode / non-DOM environments.
-  }
-  return DEFAULT_CONVERSATION_API;
-};
-
-/** Persist the selected conversation API to localStorage. */
-exports.getConversationApi = getConversationApi;
-const setConversationApi = api => {
-  try {
-    localStorage.setItem(CONVERSATION_API_KEY, api);
-  } catch {
-    // Ignore — selection simply won't persist across reloads.
-  }
-};
-
-/** Whether the conversation should use the Turn RPC (opt-in; default is Conversation). */
-exports.setConversationApi = setConversationApi;
-const usesTurnApi = () => getConversationApi() === 'turn';
-exports.usesTurnApi = usesTurnApi;
-//# sourceMappingURL=conversationApi.js.map

package/dist/cjs/utils/conversationApi.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["CONVERSATION_API_KEY","exports","DEFAULT_CONVERSATION_API","getConversationApi","value","localStorage","getItem","setConversationApi","api","setItem","usesTurnApi"],"sources":["../../../src/utils/conversationApi.ts"],"sourcesContent":["/**\n * Conversation API selection (debug-only).\n *\n * Switches the conversation between the default `Conversation` RPC\n * (`POST /v1/conversation`) and the parallel-safe `Turn` RPC\n * (`POST /v1/turn`, DL #110). Persisted in\n * `localStorage[\"web5_conversation_api\"]`, read at request time. Default\n * `conversation` (Turn is opt-in via the debug toggle for now).\n *\n * `Turn` returns a flat markdown stream (no sectioned page frames), so the\n * sectioned-stream consumption path only runs on the `Conversation` API. Lives\n * in web5-core so any surface can honor the same toggle.\n */\n\nexport type ConversationApiKind = 'turn' | 'conversation';\n\nexport const CONVERSATION_API_KEY = 'web5_conversation_api';\n\nexport const DEFAULT_CONVERSATION_API: ConversationApiKind = 'conversation';\n\n/**\n * Read the selected conversation API from localStorage. Falls back to the\n * default (`conversation`) when unset, invalid, or storage is unavailable.\n */\nexport const getConversationApi = (): ConversationApiKind => {\n  try {\n    const value = localStorage.getItem(CONVERSATION_API_KEY);\n    if (value === 'turn' || value === 'conversation') {\n      return value;\n    }\n  } catch {\n    // localStorage can throw in privacy mode / non-DOM environments.\n  }\n  return DEFAULT_CONVERSATION_API;\n};\n\n/** Persist the selected conversation API to localStorage. */\nexport const setConversationApi = (api: ConversationApiKind): void => {\n  try {\n    localStorage.setItem(CONVERSATION_API_KEY, api);\n  } catch {\n    // Ignore — selection simply won't persist across reloads.\n  }\n};\n\n/** Whether the conversation should use the Turn RPC (opt-in; default is Conversation). */\nexport const usesTurnApi = (): boolean => getConversationApi() === 'turn';\n"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIO,MAAMA,oBAAoB,GAAAC,OAAA,CAAAD,oBAAA,GAAG,uBAAuB;AAEpD,MAAME,wBAA6C,GAAAD,OAAA,CAAAC,wBAAA,GAAG,cAAc;;AAE3E;AACA;AACA;AACA;AACO,MAAMC,kBAAkB,GAAGA,CAAA,KAA2B;EAC3D,IAAI;IACF,MAAMC,KAAK,GAAGC,YAAY,CAACC,OAAO,CAACN,oBAAoB,CAAC;IACxD,IAAII,KAAK,KAAK,MAAM,IAAIA,KAAK,KAAK,cAAc,EAAE;MAChD,OAAOA,KAAK;IACd;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAEF,OAAOF,wBAAwB;AACjC,CAAC;;AAED;AAAAD,OAAA,CAAAE,kBAAA,GAAAA,kBAAA;AACO,MAAMI,kBAAkB,GAAIC,GAAwB,IAAW;EACpE,IAAI;IACFH,YAAY,CAACI,OAAO,CAACT,oBAAoB,EAAEQ,GAAG,CAAC;EACjD,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ,CAAC;;AAED;AAAAP,OAAA,CAAAM,kBAAA,GAAAA,kBAAA;AACO,MAAMG,WAAW,GAAGA,CAAA,KAAeP,kBAAkB,CAAC,CAAC,KAAK,MAAM;AAACF,OAAA,CAAAS,WAAA,GAAAA,WAAA","ignoreList":[]}

package/dist/cjs/utils/conversationMode.js

@@ -1,23 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.resolveConversationMode = exports.CONVERSATION_MODE = void 0;
-/**
- * Conversation wire mode.
- *
- * There is a single conversation engine: the page streams section-by-section
- * (each markdown frame tagged with a numeric section `id` + `status`). The
- * `additionalData.mode` sent on every `/conversation` request is fixed.
- *
- * A `?mode=` query param, when present, overrides this value and is sent to the
- * backend verbatim (callers read the param themselves); the frontend always
- * uses the sectioned-stream consumption path regardless.
- */
-
-/** `additionalData.mode` sent on a `/conversation` request. */
-const CONVERSATION_MODE = exports.CONVERSATION_MODE = 'markdown_history_v3';
-
-/** Resolve the `additionalData.mode` to send on a `/conversation` request. */
-const resolveConversationMode = () => CONVERSATION_MODE;
-exports.resolveConversationMode = resolveConversationMode;
-//# sourceMappingURL=conversationMode.js.map

package/dist/cjs/utils/conversationMode.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["CONVERSATION_MODE","exports","resolveConversationMode"],"sources":["../../../src/utils/conversationMode.ts"],"sourcesContent":["/**\n * Conversation wire mode.\n *\n * There is a single conversation engine: the page streams section-by-section\n * (each markdown frame tagged with a numeric section `id` + `status`). The\n * `additionalData.mode` sent on every `/conversation` request is fixed.\n *\n * A `?mode=` query param, when present, overrides this value and is sent to the\n * backend verbatim (callers read the param themselves); the frontend always\n * uses the sectioned-stream consumption path regardless.\n */\n\n/** `additionalData.mode` sent on a `/conversation` request. */\nexport const CONVERSATION_MODE = 'markdown_history_v3';\n\n/** Resolve the `additionalData.mode` to send on a `/conversation` request. */\nexport const resolveConversationMode = (): string => CONVERSATION_MODE;\n"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACO,MAAMA,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,GAAG,qBAAqB;;AAEtD;AACO,MAAME,uBAAuB,GAAGA,CAAA,KAAcF,iBAAiB;AAACC,OAAA,CAAAC,uBAAA,GAAAA,uBAAA","ignoreList":[]}

package/dist/esm/registry/Intent.js

@@ -1,15 +0,0 @@
-export let Intent = /*#__PURE__*/function (Intent) {
-  // New intent taxonomy
-  Intent["COMPARISON"] = "COMPARISON";
-  Intent["DECISION"] = "DECISION";
-  Intent["VALIDATION"] = "VALIDATION";
-  Intent["STRATEGY"] = "STRATEGY";
-  Intent["EXPLORATION"] = "EXPLORATION";
-  Intent["INQUIRY"] = "INQUIRY";
-  // Legacy intents (still used in hero registrations and intentExtractor)
-  Intent["DISCOVERY"] = "DISCOVERY";
-  Intent["LEARN"] = "LEARN";
-  Intent["EVALUATE"] = "EVALUATE";
-  return Intent;
-}({});
-//# sourceMappingURL=Intent.js.map