@wix/web5-core 1.56.0 → 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.0",
+  "version": "1.57.0",
   "author": {
     "name": "tsachis",
     "email": "tsachis@wix.com"
@@ -14,7 +14,8 @@
     "dist/cjs",
     "dist/esm",
     "dist/types",
-    "src/styles"
+    "src/styles",
+    "src/components/**/*.css"
   ],
   "scripts": {
     "build": "yoshi-library build && node scripts/fix-esm-extensions.js",
@@ -99,5 +100,5 @@
   "wallaby": {
     "autoDetect": true
   },
-  "falconPackageHash": "85aa415503e1949c89b77d043271b71ca3bd64f50d7027e8d8b1e0c8"
+  "falconPackageHash": "d81e7d4252b50b94d46bdb6c4a55696d95b2787761303c708cb8bf9e"
 }

package/src/components/placement/PlacementResponseRenderer.css

@@ -0,0 +1,265 @@
+/* PlacementResponseRenderer — placement card chrome (DL #097 —
+   Figma 128:5251 framing / 128:5258 conversation).
+   Renders the streamed answer as a warm card with a FormAI eyebrow and a
+   gradient highlight ring (accent → transparent, top-left → bottom-right)
+   that holds while the answer streams, spins twice once it settles, and then
+   stays put. The conversation variant additionally shows the user's question
+   as a chip.
+   Re-skin via the `--w5-placement-*` tokens below.
+   The loading skeleton's styles live in `../ui/PlacementLoader.css`. */
+
+/* Outer host-page spacing — matches the loader's `--w5-placement-spacing` so
+   the gap to surrounding content doesn't change at swap time. */
+[data-w5-placement-renderer] {
+  margin-block: var(--w5-placement-spacing, 24px);
+}
+
+/* The loader→content swap is height-animated by the PlacementSmoothHeight
+   wrapper (`.w5-placement__body` below); this fade-in covers the paint swap
+   itself so the card doesn't pop in while the height glides. Plays once per
+   renderer mount (so again after each re-submit). */
+[data-w5-placement-renderer] {
+  animation: w5-placement-content-in 240ms ease-out both;
+}
+
+@keyframes w5-placement-content-in {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+
+[data-w5-placement-renderer].w5-placement {
+  box-sizing: border-box;
+  padding: var(--w5-placement-card-padding, 30px);
+  border-radius: var(--w5-placement-card-radius, 4px);
+  background: var(--w5-placement-card-bg, #f1f0ee);
+  /* Section components inside the answer use `bg-background`
+     (= var(--color-background), white), which would paint a white block over
+     the card. Re-point that token within the placement so those sections
+     inherit the card colour instead — one shared background across the whole
+     placement. Change --w5-placement-card-bg to re-theme card + sections. */
+  --color-background: var(--w5-placement-card-bg, #f1f0ee);
+  /* Reserve the border box so the conversation highlight ring (the
+     `::before` gradient below) doesn't shift layout when it fades in/out. */
+  border: 2px solid transparent;
+}
+
+/* Height smoothing for the whole placement slot: PlacementSmoothHeight
+   (mounted around the loader/content swap in embed-placement) measures the
+   current child (ResizeObserver) and sets an explicit `height` here, so the
+   loader→content swap and each streamed section appending animate instead
+   of snapping. Until the first measurement lands there's no inline height
+   and the box sizes naturally. */
+.w5-placement__body {
+  overflow: clip;
+  transition: height var(--w5-placement-grow-duration, 350ms) ease-out;
+}
+
+/* flow-root so children's top/bottom margins can't collapse out of the
+   measured inner box (they'd be clipped by the wrapper otherwise). */
+.w5-placement__body-inner {
+  display: flow-root;
+}
+
+/* Height clamp + "Show more" (DL #113) — Google-AI-Overview style. Opt-in via
+   the slot's `data-clamp` attribute; the renderer adds `--clamped` to the card
+   ROOT and caps it directly (no inner wrapper), so the answer sections stay
+   direct children of the placement root — clients lay them out with
+   `:has(> …)` direct-child grids (feature-com's search-overview two-column
+   layout) that a wrapper would break. The cap is also what
+   `PlacementSmoothHeight` then measures, so the slot animates to the capped
+   height rather than the full content. */
+.w5-placement--clamped {
+  position: relative;
+  max-height: var(--w5-placement-clamp-height, 220px);
+  overflow: hidden;
+}
+
+/* The variant highlight ring is a `::before` at `inset: -2px` (outside the
+   padding box) — `overflow: hidden` above would clip it to a stub. Drop it on
+   clamped cards; the clamp + fade is its own treatment. */
+.w5-placement--clamped::before {
+  content: none;
+}
+
+/* Fade the cut-off bottom edge to the card background (a wash, like Google —
+   not a mask that makes text vanish). Rendered only when the content overflows
+   (the renderer omits it otherwise), pinned to the bottom of the capped root. */
+.w5-placement__fade {
+  position: absolute;
+  inset-inline: 0;
+  bottom: 0;
+  height: var(--w5-placement-fade-height, 96px);
+  background: linear-gradient(
+    to bottom,
+    transparent,
+    var(--w5-placement-card-bg, #f1f0ee)
+  );
+  pointer-events: none;
+}
+
+/* "Show more" pill, pinned over the fade. Re-skins via the shared
+   `--w5-placement-*` tokens. */
+.w5-placement__show-more {
+  position: absolute;
+  bottom: 14px;
+  left: 50%;
+  transform: translateX(-50%);
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 8px 18px;
+  border-radius: 999px;
+  border: 1px solid var(--w5-placement-show-more-border, #d8d5cf);
+  background: var(--w5-placement-show-more-bg, #fff);
+  color: var(--w5-placement-show-more-color, #000);
+  font-size: 14px;
+  line-height: 15px;
+  font-weight: 500;
+  text-decoration: none;
+  cursor: pointer;
+  white-space: nowrap;
+}
+
+.w5-placement__show-more:hover {
+  background: var(--w5-placement-show-more-bg-hover, #f6f5f3);
+}
+
+.w5-placement__show-more:focus-visible {
+  outline: 2px solid var(--w5-placement-accent, #ef1b28);
+  outline-offset: 2px;
+}
+
+.w5-placement__eyebrow {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  margin-bottom: 20px;
+}
+
+.w5-placement__eyebrow-icon {
+  flex: none;
+  color: var(--w5-placement-accent, #ef1b28);
+}
+
+.w5-placement__eyebrow-label {
+  font-size: 14px;
+  line-height: 15px;
+  font-weight: 500;
+  color: var(--w5-placement-eyebrow-color, #000);
+}
+
+/* The user's question (conversation variant). */
+.w5-placement__query {
+  display: inline-block;
+  margin: 0 0 20px;
+  padding: 7px 10px;
+  border-radius: 3px;
+  background: var(--w5-placement-query-bg, #e2dfd9);
+  font-size: 14px;
+  line-height: 15px;
+  color: var(--w5-placement-query-color, #000);
+}
+
+/* Placement highlight (conversation + informational): a gradient ring — fully
+   opaque accent at the top-left corner fading to transparent toward the
+   bottom-right. A solid `border-color` can't render a gradient, so the ring
+   is a masked pseudo-element: the gradient paints the whole box, and the
+   mask punches out the padding box so only the 2px border area remains.
+   The ring shows as soon as the placement starts to render, holds for the
+   whole streamed render (the `--streaming` modifier below); once the answer
+   settles the modifier drops and the animation plays — the gradient spins
+   two full counter-clockwise turns, then the ring stays in place. Replays
+   after each re-submit since the renderer remounts via the loader. */
+.w5-placement--conversation,
+.w5-placement--informational {
+  position: relative;
+}
+
+/* Registered so the gradient angle interpolates in the keyframes below.
+   Browsers without `@property` (Firefox < 128) apply custom-property
+   keyframes discretely — harmless here, since -585deg ≡ 135deg (mod 360°)
+   the jump is invisible and only the hold + fade-out remains. */
+@property --w5-placement-highlight-angle {
+  syntax: '<angle>';
+  inherits: false;
+  initial-value: 135deg;
+}
+
+.w5-placement--conversation::before,
+.w5-placement--informational::before {
+  content: '';
+  position: absolute;
+  /* Cover the reserved 2px transparent border (absolute positioning is
+     relative to the padding box, which excludes it). */
+  inset: -2px;
+  padding: 2px;
+  /* Outer radius of the card's border box: card radius + border width. */
+  border-radius: calc(var(--w5-placement-card-radius, 4px) + 2px);
+  background: linear-gradient(
+    var(--w5-placement-highlight-angle, 135deg),
+    var(--w5-placement-accent, #ef1b28),
+    transparent
+  );
+  /* Keep only the ring: padding-box ⊖ full box. */
+  -webkit-mask:
+    linear-gradient(#fff 0 0) content-box,
+    linear-gradient(#fff 0 0);
+  -webkit-mask-composite: xor;
+  mask:
+    linear-gradient(#fff 0 0) content-box,
+    linear-gradient(#fff 0 0);
+  mask-composite: exclude;
+  pointer-events: none;
+  /* ~9.4s default for the 2.5 counter-clockwise turns (same angular speed as
+     the original 2 turns in 7.5s); the ring then holds its final state
+     (`both` fill mode) and stays visible. */
+  animation: w5-placement-highlight
+    var(--w5-placement-highlight-duration, 9375ms) linear both;
+}
+
+/* Still streaming: hold the ring fully visible; the spin only starts
+   when this class is removed (answer settled) and the animation kicks in. */
+.w5-placement--conversation.w5-placement--streaming::before,
+.w5-placement--informational.w5-placement--streaming::before {
+  animation: none;
+  opacity: 1;
+}
+
+@keyframes w5-placement-highlight {
+  /* Two and a half counter-clockwise turns (135° → -765° ≡ 315°) at constant
+     speed, so the accent settles on the opposite side (bottom-right); the
+     ring stays fully visible throughout and after. */
+  0% {
+    --w5-placement-highlight-angle: 135deg;
+    opacity: 1;
+  }
+  100% {
+    --w5-placement-highlight-angle: -765deg;
+    opacity: 1;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  /* No spin — show the ring statically in its settled position
+     (accent at the bottom-right). */
+  .w5-placement--conversation::before,
+  .w5-placement--informational::before,
+  .w5-placement--conversation.w5-placement--streaming::before,
+  .w5-placement--informational.w5-placement--streaming::before {
+    animation: none;
+    opacity: 1;
+    --w5-placement-highlight-angle: 315deg;
+  }
+
+  .w5-placement__body {
+    transition: none;
+  }
+
+  [data-w5-placement-renderer] {
+    animation: none;
+  }
+}

package/src/components/ui/Disclaimer.css

@@ -0,0 +1,35 @@
+/* "AI can make mistakes. Learn more" footer. Mounted by the host app
+   alongside the FeedbackBar; clients can override the whole component via
+   the DisclaimerComponent UI slot.
+
+   Typography defaults mirror `.web5-feedback-bar` so a single client-side
+   override (`--web5-feedback-bar-color`) re-skins both together. The
+   disclaimer-specific vars stay as escape hatches when divergence is
+   needed. */
+
+.web5-disclaimer {
+  margin: 0;
+  font-size: var(
+    --web5-disclaimer-font-size,
+    var(--web5-feedback-bar-font-size, 13px)
+  );
+  font-weight: 400;
+  line-height: normal;
+  color: var(
+    --web5-disclaimer-color,
+    var(--web5-feedback-bar-color, var(--web5-feedback-label-color, #6b7280))
+  );
+  text-align: var(--web5-disclaimer-text-align, left);
+}
+
+.web5-disclaimer__link {
+  color: inherit;
+  text-decoration: underline;
+  text-decoration-skip-ink: none;
+  cursor: pointer;
+}
+
+.web5-disclaimer__link:hover,
+.web5-disclaimer__link:focus-visible {
+  color: var(--web5-disclaimer-link-hover-color, inherit);
+}