@encorekit/web-sdk 2.3.0 → 2.4.0

package/types/ui/sheetDetents.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A served variant's `presentationDetents`, on phones.
+ *
+ * iOS presents a sheet at fractions of the screen and lets a drag move it
+ * between them or dismiss it (`OfferSheetView.detentsForCurrentState`). Web
+ * opened every variant full height. Above a phone the SDUI stage is a square,
+ * and a partial sheet only fits its height to its content.
+ */
+/** Swift's detents when a variant names none. */
+export declare const DEFAULT_DETENTS: readonly number[];
+/**
+ * The detents for `state`, or null when the variant is not a partial sheet:
+ * a `fullScreenCover`, or detents that are all full height.
+ */
+export declare function resolveDetents(template: unknown, state: string): number[] | null;
+export interface SheetDetentOptions {
+    /** The detents now, or null for a full-height screen. Read on every refresh. */
+    detents: () => readonly number[] | null;
+    cornerRadius?: number;
+    /** Called when a drag dismisses the sheet. Absent means it cannot be dragged away. */
+    onDismiss?: () => void;
+}
+export interface SheetDetents {
+    refresh(): void;
+    destroy(): void;
+}
+export declare function attachSheetDetents(sheet: HTMLElement, options: SheetDetentOptions): SheetDetents;
+//# sourceMappingURL=sheetDetents.d.ts.map

package/types/ui/sheetDetents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheetDetents.d.ts","sourceRoot":"","sources":["../../src/ui/sheetDetents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,iDAAiD;AACjD,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAiB,CAAC;AAa/D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAYhF;AAED,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,OAAO,EAAE,MAAM,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;CACjB;AAWD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,GAAG,YAAY,CA0IhG"}

package/types/ui/styles.d.ts

@@ -13,14 +13,12 @@ export declare const BREAKPOINTS: {
 };
 /**
  * REWARD_VISUAL_NOTES — why the reward block in the stylesheet below looks the way
- * it does. Deliberately a JS comment and NOT a CSS one.
+ * it does.
  *
- * The stylesheet is one big template literal, so every `/* … *\/` inside it is STRING
- * CONTENT that terser cannot strip and every user downloads. This file's house style
- * is long prose; in the literal that prose is payload. Keep in-literal comments to a
- * terse line or two and put the reasoning here, where it is free. (Trimming this
- * block's CSS prose cut 3.9KB of raw bundle — it had been 46% of the whole
- * stylesheet delta.)
+ * The stylesheet is template literals, so a `/* … *\/` inside one is string content
+ * terser cannot strip. The build removes them (scripts/strip-css-comments.mjs), so CSS
+ * comments here cost nothing in the bundle; one that straddles a `${…}` is kept and
+ * warned about, so keep each comment on one side of an interpolation.
  *
  * SOURCE OF TRUTH. The interaction model tracks `streaksCarousel.json`; the visuals
  * track Figma frame 18304:2399 (393×852). Where they disagree the Figma wins — see
@@ -304,8 +302,13 @@ export interface ThemeVariables {
     fontFamily?: string;
 }
 /**
- * Inject styles into document head
+ * 🔴 INTERNAL (`@encorekit/web-sdk/preview`): stop writing the stylesheet into
+ * `document.head`. The preview puts {@link stylesheet} in its own container instead, so
+ * it works inside a shadow root and leaves nothing on the page after destroy().
  */
+export declare function disableDocumentStyles(): void;
+/** The whole stylesheet as text, for a caller that places it itself (the preview). */
+export declare function stylesheet(theme?: ThemeVariables): string;
 export declare function injectStyles(theme?: ThemeVariables): void;
 /**
  * Remove styles from document head

package/types/ui/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/ui/styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAGX,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmOG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;IAI/B,0FAA0F;;CAElF,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4+KD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,cAAmB,GAAG,IAAI,CAgB7D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAMnC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAe1D;AAED;;GAEG;AACH,wBAAgB,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7C"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/ui/styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,eAAO,MAAM,OAAO;;;CAGV,CAAC;AAGX,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiOG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;IAI/B,0FAA0F;;CAElF,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqoLD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,KAAK,GAAE,cAAmB,GAAG,MAAM,CAE7D;AAED,wBAAgB,YAAY,CAAC,KAAK,GAAE,cAAmB,GAAG,IAAI,CAiB7D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAMnC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAe1D;AAED;;GAEG;AACH,wBAAgB,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/types/ui/termsLine.d.ts

@@ -3,7 +3,7 @@
  * "By proceeding you agree to our offer terms", with "offer terms" underlined.
  *
  * It REPLACES the per-offer fine print on those surfaces, and `giftPicker` renders it
- * in its own words ("One gift per person · Offer terms") via `lead`/`linkText`.
+ * in its own words ("One gift per person · Offer terms") via `template`/`linkText`.
  * `giftReveal` keeps `GIFT_COPY.terms` through `RewardActions.termsText`, and the
  * carousel keeps its trust line; neither calls this.
  *
@@ -26,8 +26,8 @@ export interface TermsLineOptions {
     onOpen?: () => void;
     /** The selected offer's terms URL. https only; anything else renders as text. */
     termsUrl?: string;
-    /** The words before the link. Defaults to `GIFT_COPY.termsLead`. */
-    lead?: string;
+    /** The sentence, with `${link}` where the link goes. Defaults to `GIFT_COPY.termsLine`. */
+    template?: string;
     /** The link's own words. Defaults to `GIFT_COPY.termsLink`. */
     linkText?: string;
 }

package/types/ui/termsLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"termsLine.d.ts","sourceRoot":"","sources":["../../src/ui/termsLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAQ3E;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUlF"}
+{"version":3,"file":"termsLine.d.ts","sourceRoot":"","sources":["../../src/ui/termsLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAO3E;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUlF"}

package/types/ui/toast.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A short status message at the bottom of the page.
+ *
+ * On the PAGE, not in the sheet: a share whose `onSuccessState` is `close` ends
+ * the sheet the moment the link is copied, and a message inside it would go
+ * with it. `role="status"` so a screen reader announces it without moving focus.
+ */
+/** How long the message stays before it fades. */
+export declare const TOAST_MS = 2200;
+export declare function showToast(text: string, doc?: Document | undefined): void;
+//# sourceMappingURL=toast.d.ts.map

package/types/ui/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../src/ui/toast.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,kDAAkD;AAClD,eAAO,MAAM,QAAQ,OAAO,CAAC;AAG7B,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,QAAQ,GAAG,SAA+B,GAAG,IAAI,CAgB7F"}

package/types/utils/logger.d.ts

@@ -21,6 +21,16 @@ declare class Logger {
     info(...args: unknown[]): void;
     warn(...args: unknown[]): void;
     error(...args: unknown[]): void;
+    /**
+     * Always logs regardless of log level: a publisher calling a deprecated API has to
+     * hear about it before the next major removes it, and the default level is none.
+     */
+    deprecated(...args: unknown[]): void;
+    /**
+     * Always logs regardless of log level: a value the host passed that the SDK
+     * ignores (it never throws into the host page), so the host can see why.
+     */
+    ignored(...args: unknown[]): void;
     /**
      * Always logs regardless of log level (for critical errors)
      */

package/types/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,qDAAsD,CAAC;AAE9E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAOnD,cAAM,MAAM;;IAGV,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAIlC,WAAW,IAAI,QAAQ;IAQvB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/B;;OAEG;IACH,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGnC;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,qDAAsD,CAAC;AAE9E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAOnD,cAAM,MAAM;;IAGV,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAIlC,WAAW,IAAI,QAAQ;IAQvB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/B;;;OAGG;IACH,UAAU,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIpC;;;OAGG;IACH,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIjC;;OAEG;IACH,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGnC;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/types/utils/text.d.ts

@@ -35,4 +35,21 @@ export declare function firstNonBlank(...values: (string | null | undefined)[]):
  * and folds to `(unlabeled)` on the other.
  */
 export declare function normalizePlacementId(placementId: string | undefined): string | undefined;
+/**
+ * The tag `Encore.setLanguage()` stores and sends, in BCP 47 case (RFC 5646
+ * §2.1.1: `PT-br` → `pt-BR`, `zh-hant` → `zh-Hant`, `en-US-X-Twain` →
+ * `en-US-x-twain`) with a deprecated language code replaced (`iw` → `he`), or
+ * null when it is not well-formed. Nothing is trimmed and `_` is refused, as on
+ * every other SDK: the server would otherwise fall back to another language
+ * without saying so. (`$` without the `m` flag matches only at the very end, so
+ * `'fr\n'` is refused too.)
+ */
+export declare function normalizeLanguageTag(value: unknown): string | null;
+/**
+ * The deprecated `UserAttributes.language`, and a value it saved, read a locale
+ * identifier as its tag: trimmed, cut at `@` (`de_DE@currency=EUR`), `_` as `-`.
+ * The server accepted such values there, so a host that sent one keeps its
+ * language after the upgrade. `setLanguage()` stays strict.
+ */
+export declare function normalizeLegacyLanguageTag(value: unknown): string | null;
 //# sourceMappingURL=text.d.ts.map

package/types/utils/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,GAAG,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,GAAG,SAAS,CAM1F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMxF"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,GAAG,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,GAAG,SAAS,CAM1F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMxF;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkBlE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIxE"}