@encorekit/web-sdk 2.0.7 → 2.1.1

package/types/ui/GiftUnwrap.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Gift unwrap — the `giftUnwrap` reward surface (Figma "hypothesis 5").
+ *
+ * Two screens in one surface:
+ *
+ *   1. PICK. A closed gift box under a falling confetti pass, the headline, up to three
+ *      gift rows, "Show more gifts" for the rest, a plain "Continue" and the terms line.
+ *   2. READY. "‹ Back", the box opening with the picked gift's logo rising out of it,
+ *      "Your gift is ready", what happens next as check bullets, and "Continue to
+ *      {advertiser}" — which is the claim.
+ *
+ * Screen 1 is the ordinary reward composition, built the same way `giftList`'s is:
+ * `Encore` resolves the headline chain and `RewardLayout` renders it (the dialog's
+ * labelled heading, FREE accented only for the gift default); `RewardActions` renders
+ * "Continue" with the shared terms line under it and no trust line. This class supplies
+ * three pieces and joins them: `renderHero()` (the closed box), `render()` (rows and the
+ * sheet), and `compose(pickScreen)`, which takes the laid-out screen 1 and returns the
+ * two-screen root with screen 2 beside it.
+ *
+ * ## What is a claim
+ *
+ * 🔴 ONLY SCREEN 2's CTA CLAIMS. Screen 1's "Continue" (wired by Encore to
+ * `showReady()`) and the sheet's CTA are navigation: they move to the ready screen and
+ * emit nothing. `claimSelected()` is the one path to `offerClaim`, the single claim
+ * path every surface feeds (see `rewardSurface.ts`), and it is reached from a click on
+ * screen 2 so the advertiser window still opens inside the user's gesture.
+ *
+ * ## Selection has exactly one source
+ *
+ * `#selectedIndex`, an index into the FULL offer array, as in `GiftReveal` and
+ * `GiftList`. A gift picked in the sheet is PROMOTED into the rows rather than tracked
+ * beside them, so the row the user sees checked, the logo that rises out of the box,
+ * and the offer the CTA claims can never disagree. Back keeps it intact.
+ *
+ * ## Events
+ *
+ * `offerView` once per offer the impression gate judges shown (a row, a promoted gift,
+ * a sheet card while the sheet is open), `offerSelect` on every selection change including
+ * the initial auto-selection during `render()` (Encore subscribes first, for the
+ * advertiser preconnect), and `offerClaim` from screen 2 only. All carry
+ * `{ offer, index }` with `index` into the array Encore passed in.
+ *
+ * ## Not built, deliberately
+ *
+ * The design's "Most claimed" pill and the sheet variant with "Watch & listen" /
+ * "Everyday" chips need a popularity count and a category, and the offer model has
+ * neither (see `api/models.ts`). Inventing either from list order or brand names would
+ * be a guess that looks like data, so both wait on a real field.
+ *
+ * ## The reveal (see giftUnwrapStyles in styles.ts)
+ *
+ * Four elements, four tracks, one 1752ms timeline with the design's keyframe stops on
+ * the individual `translate` / `scale` / `rotate` properties plus `opacity`. The base
+ * rules ARE the end state, so any entry where the animation never runs still shows the
+ * open box and the logo. The play class is re-added across a reflow on every entry.
+ */
+import type { OfferModel as Offer } from '../api/models';
+import { type ButtonSlot } from './appearance';
+import type { RewardSurface, RewardSurfaceEventMap } from './rewardSurface';
+import { ImpressionGate } from './impressionGate';
+/** How many gifts screen 1 shows as rows. The rest go behind "Show more gifts". */
+export declare const UNWRAP_ROW_LIMIT = 3;
+/**
+ * The reveal's length: all four tracks (closed box, open box, logo tile, glow) share
+ * it. The stylesheet carries the same number; exported so a test can pin the two.
+ */
+export declare const UNWRAP_REVEAL_MS = 1752;
+export type UnwrapScreen = 'pick' | 'ready';
+/** The id on "Your gift is ready", which names the dialog while screen 2 is showing. */
+export declare const UNWRAP_READY_TITLE_ID: string;
+export interface GiftUnwrapComposeOptions {
+    /**
+     * Point the dialog's `aria-labelledby` at `id`. Called with the ready heading's id on
+     * entering screen 2 and with `REWARD_TITLE_ID` on Back: screen 1's headline is
+     * `hidden` while screen 2 shows, and a dialog named by a hidden heading announces a
+     * screen the user is no longer on. A callback because the modal is Encore's.
+     */
+    setLabelledBy?: (id: string) => void;
+}
+export interface GiftUnwrapOptions {
+    /**
+     * Whether claiming is switched on (`Encore.isClaimEnabled`). `false` disables every
+     * control that leads to a claim: screen 2's CTA, and the sheet's CTA like on the
+     * other gift surfaces. Screen 1's "Continue" is gated the same way by `RewardActions`.
+     */
+    claimEnabled?: boolean;
+    /**
+     * The publisher's `appearance.claimButton`. It styles screen 2's CTA, because that is
+     * the button that claims; screen 1's "Continue" only navigates and keeps the
+     * surface's own styling. Appearance only: the action stays `claimSelected()`, and
+     * the claim switch still gates it (see `createActionSlot`).
+     */
+    claimSlot?: ButtonSlot;
+    /**
+     * The presentation's impression gate (see `impressionGate.ts`): rows and sheet cards
+     * report `offerView` only once it judges them shown. Without one the surface owns an
+     * unarmed gate, which never fires.
+     */
+    impressions?: ImpressionGate;
+}
+export declare class GiftUnwrap implements RewardSurface {
+    #private;
+    constructor(offers: readonly Offer[], options?: GiftUnwrapOptions);
+    on<E extends keyof RewardSurfaceEventMap>(event: E, handler: (payload: RewardSurfaceEventMap[E]) => void): () => void;
+    getTotalOffers(): number;
+    getCurrentIndex(): number;
+    getSelectedOffer(): Offer | undefined;
+    /** True when some gift did not fit in the rows. */
+    hasMoreGifts(): boolean;
+    getScreen(): UnwrapScreen;
+    /**
+     * The closed box, placed by `RewardLayout` above the headline. `aria-hidden`: it is
+     * decoration, and the copy under it says everything it depicts.
+     */
+    renderHero(): HTMLElement;
+    /**
+     * Screen 1's body: the rows, then "Show more gifts" with its sheet. Announces the
+     * auto-selected first gift and reports the rows as seen.
+     */
+    render(): HTMLElement;
+    /**
+     * Join the laid-out screen 1 with screen 2, and start screen 1's confetti.
+     *
+     * `pickScreen` is what `RewardLayout` built around {@link renderHero},
+     * {@link render} and the action block.
+     */
+    compose(pickScreen: HTMLElement, options?: GiftUnwrapComposeOptions): HTMLElement;
+    /**
+     * Select the offer at `index` into the full array. Out of range is IGNORED rather
+     * than clamped: claiming a neighbouring advertiser would hide a caller's bug behind a
+     * real transaction.
+     */
+    selectOffer(index: number): void;
+    next(): void;
+    /**
+     * Claim the SELECTED offer. The only emitter of `offerClaim`, and wired only to
+     * screen 2's CTA. Honours the host's claim switch here as well as on the button, so
+     * a programmatic call cannot claim what the disabled control could not.
+     */
+    claimSelected(): void;
+    /**
+     * Go to "Your gift is ready" for the current selection, and replay the reveal.
+     *
+     * Each entry is a fresh reveal: the tile and bullets are rebuilt for whatever is
+     * selected now, and the play class is removed and re-added across a reflow so the
+     * keyframes start again from 0%.
+     */
+    showReady(): void;
+    /** Back to the list, selection intact. The confetti does not replay. */
+    showPick(): void;
+    openSheet(opener?: HTMLElement): void;
+    closeSheet(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=GiftUnwrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GiftUnwrap.d.ts","sourceRoot":"","sources":["../../src/ui/GiftUnwrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AASzD,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAUlF,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAEnE,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AASrC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C,wFAAwF;AACxF,eAAO,MAAM,qBAAqB,QAA4B,CAAC;AAE/D,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED,qBAAa,UAAW,YAAW,aAAa;;gBAyClC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,GAAE,iBAAsB;IASrE,EAAE,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACtC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,GACnD,MAAM,IAAI;IAIb,cAAc,IAAI,MAAM;IAIxB,eAAe,IAAI,MAAM;IAIzB,gBAAgB,IAAI,KAAK,GAAG,SAAS;IAIrC,mDAAmD;IACnD,YAAY,IAAI,OAAO;IAIvB,SAAS,IAAI,YAAY;IAMzB;;;OAGG;IACH,UAAU,IAAI,WAAW;IAazB;;;OAGG;IACH,MAAM,IAAI,WAAW;IA2BrB;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,GAAE,wBAA6B,GAAG,WAAW;IAgErF;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAahC,IAAI,IAAI,IAAI;IA4CZ;;;;OAIG;IACH,aAAa,IAAI,IAAI;IAerB;;;;;;OAMG;IACH,SAAS,IAAI,IAAI;IA8BjB,wEAAwE;IACxE,QAAQ,IAAI,IAAI;IAuLhB,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI;IAKrC,UAAU,IAAI,IAAI;IAyDlB,OAAO,IAAI,IAAI;CA8BhB"}

package/types/ui/OfferCarousel.d.ts

@@ -4,6 +4,7 @@
  */
 import type { OfferModel as Offer } from '../api/models';
 import type { UIConfiguration } from '../types';
+import { ImpressionGate } from './impressionGate';
 export interface OfferCarouselOptions {
     /**
      * 'responsive' (default): today's behavior — horizontal carousel on desktop, vertical
@@ -58,6 +59,12 @@ export interface OfferCarouselOptions {
      */
     dotColor?: string;
     dotActiveColor?: string;
+    /**
+     * The presentation's impression gate (see `impressionGate.ts`). Cards report
+     * `offerView` once it judges them shown and, in horizontal mode, only once the scroll
+     * is at rest. Without one the carousel owns an unarmed gate, which never fires.
+     */
+    impressions?: ImpressionGate;
 }
 interface CarouselEventMap extends Record<string, unknown> {
     offerClaim: {
@@ -73,9 +80,9 @@ interface CarouselEventMap extends Record<string, unknown> {
     };
     /**
      * The user moved to a different card, by any means (gesture, arrows, keyboard).
-     * Distinct from `offerView`, which is an IMPRESSION and stays deduped to
-     * once-per-index-per-rest: this is the navigation itself, so a user paging
-     * 0→1→0 produces three scrolls and two impressions. `axis` is a real dimension
+     * Distinct from `offerView`, which is an IMPRESSION and fires once per offer per
+     * presentation: this is the navigation itself, so a user paging 0→1→0 produces
+     * three scrolls and two impressions. `axis` is a real dimension
      * on web — the same carousel is horizontal on desktop and a vertical list on
      * mobile — and is what `sdk_sdui_scroll` reports.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"OfferCarousel.d.ts","sourceRoot":"","sources":["../../src/ui/OfferCarousel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAQhD,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAC9B;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD,UAAU,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,UAAU,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,SAAS,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C;;;;;;;OAOG;IACH,MAAM,EAAE;QAAE,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,QAAQ,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/B;;;;;OAKG;IACH,WAAW,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,qBAAa,aAAa;;gBAuEZ,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAoBvF;;OAEG;IACH,MAAM,IAAI,WAAW;IA8PrB;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACjC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC9C,MAAM,IAAI;IAIb;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAUZ;;;;;OAKG;IACH,gBAAgB,IAAI,KAAK,GAAG,SAAS;IAIrC;;;;;;;;;;OAUG;IACH,aAAa,IAAI,IAAI;IASrB;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAiBhC;;OAEG;IACH,QAAQ,IAAI,IAAI;IA4nBhB;;OAEG;IACH,OAAO,IAAI,IAAI;CA2BhB"}
+{"version":3,"file":"OfferCarousel.d.ts","sourceRoot":"","sources":["../../src/ui/OfferCarousel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAOhD,OAAO,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAC9B;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAQD,UAAU,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,UAAU,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,SAAS,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C;;;;;;;OAOG;IACH,MAAM,EAAE;QAAE,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,QAAQ,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/B;;;;;OAKG;IACH,WAAW,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,qBAAa,aAAa;;gBA0EZ,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAuBvF;;OAEG;IACH,MAAM,IAAI,WAAW;IA8QrB;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACjC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC9C,MAAM,IAAI;IAIb;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAUZ;;;;;OAKG;IACH,gBAAgB,IAAI,KAAK,GAAG,SAAS;IAIrC;;;;;;;;;;OAUG;IACH,aAAa,IAAI,IAAI;IASrB;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAiBhC;;OAEG;IACH,QAAQ,IAAI,IAAI;IA4qBhB;;OAEG;IACH,OAAO,IAAI,IAAI;CA6BhB"}

package/types/ui/OfferModal.d.ts

@@ -8,6 +8,7 @@ interface ModalEventMap extends Record<string, unknown> {
     backdropClick: void;
     show: void;
     hide: void;
+    visibility: boolean;
 }
 export interface OfferModalOptions {
     /**
@@ -64,6 +65,12 @@ export declare class OfferModal {
      * Hide and remove the modal
      */
     hide(): void;
+    /**
+     * Subscribe to whether the sheet is on screen: `true` on the frame its show transition
+     * starts (never at `show()`, which is still opacity 0), `false` when `hide()` begins.
+     * Called at once with `true` when subscribing to a sheet that is already on screen.
+     */
+    onVisibilityChange(handler: (visible: boolean) => void): () => void;
     /**
      * Check if modal is currently visible
      */

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

@@ -1 +1 @@
-{"version":3,"file":"OfferModal.d.ts","sourceRoot":"","sources":["../../src/ui/OfferModal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,UAAU,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,KAAK,EAAE,IAAI,CAAC;IACZ,aAAa,EAAE,IAAI,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,UAAU;;gBAsBT,KAAK,GAAE,cAAmB,EAAE,OAAO,GAAE,iBAAsB;IAavE;;OAEG;IACH,IAAI,IAAI,IAAI;IAqCZ;;OAEG;IACH,IAAI,IAAI,IAAI;IA4CZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IA4BtC;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,EAC9B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,MAAM,IAAI;IAmKb;;OAEG;IACH,OAAO,IAAI,IAAI;CAoBhB"}
+{"version":3,"file":"OfferModal.d.ts","sourceRoot":"","sources":["../../src/ui/OfferModal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C,UAAU,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,KAAK,EAAE,IAAI,CAAC;IACZ,aAAa,EAAE,IAAI,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,UAAU;;gBAwBT,KAAK,GAAE,cAAmB,EAAE,OAAO,GAAE,iBAAsB;IAavE;;OAEG;IACH,IAAI,IAAI,IAAI;IAwCZ;;OAEG;IACH,IAAI,IAAI,IAAI;IA8CZ;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAYnE;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IA4BtC;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,EAC9B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,GAC3C,MAAM,IAAI;IAuKb;;OAEG;IACH,OAAO,IAAI,IAAI;CAoBhB"}

package/types/ui/RewardActions.d.ts

@@ -23,11 +23,28 @@ import type { UseCase } from '../types';
 import { type ButtonSlot } from './appearance';
 /** Copy the variant hard-codes. Named so the tests can assert parity by symbol. */
 export declare const REWARD_COPY: {
+    /**
+     * ⚠️ ASSERTS A FREE TRIAL, so it is only correct under an offer that IS one. Used
+     * when `badgeLabel` says `free_trial`; otherwise `trustUnknown` below. It stays the
+     * shipped wording for that case because it is the variant's own line.
+     */
     readonly trust: "No charges until trial ends, cancel anytime.";
+    /**
+     * The line for every offer that is not a KNOWN free trial — a discount, or the
+     * common case where the campaign carries no badge at all.
+     *
+     * It has to be true without knowing the terms, so it claims nothing about price,
+     * trials or cancellation. The old default asserted "no charges until trial ends"
+     * over live inventory that charges on day one (Disney+ at $4.99/mo), which is the
+     * bigger half of the same false claim the card pill was making.
+     */
+    readonly trustUnknown: "Terms apply. See the offer for details.";
     readonly primary: "Claim gift";
     readonly secondary: "No thanks";
     /** The secondary's other job — see `RewardActionsOptions.secondary`. */
     readonly next: "Next offer";
+    /** The secondary's third job: open the gift flow's "other gifts" sheet. */
+    readonly more: "Other gifts";
 };
 export interface RewardActionsOptions {
     /** Claim the selected offer (the variant's `claimOffer` action). */
@@ -39,6 +56,10 @@ export interface RewardActionsOptions {
      * ignored otherwise, so a decline-mode caller need not supply one.
      */
     onNext?: () => void;
+    /**
+     * Open the "other gifts" sheet. Required only for `secondary: 'more'`.
+     */
+    onMore?: () => void;
     /**
      * WHAT THE SECONDARY BUTTON DOES. Defaults to `'decline'`, which is the
      * "No thanks" every integration has today.
@@ -50,20 +71,55 @@ export interface RewardActionsOptions {
      * lies about what it does, and the slot is better spent on the thing they
      * actually want, which is to see the other offers.
      *
-     * `'none'` renders nothing. Only for `'next'` with a single offer, where the
-     * button would be permanently inert.
+     * `'more'` makes it "Other gifts": it opens the gift flow's sheet of the offers
+     * that did not fit in the box. The gift composition uses it INSTEAD of "No
+     * thanks" and restores the modal's × in exchange, matching the design — the
+     * user still has a way out, it is just the × rather than a second CTA, and the
+     * slot goes to the thing they are far more likely to want.
+     *
+     * `'none'` renders nothing. Only for `'next'` with a single offer, or `'more'`
+     * with nothing left to show, where the button would be permanently inert.
      *
      * ⚠️ A publisher's own site keeps `'decline'`. `enabled` below can switch
      * CLAIMING off and the decline stays live precisely so a user can always
-     * leave; anything but `'decline'` is for a host that leaves for them.
+     * leave; anything but `'decline'` is for a host that leaves for them, or — for
+     * `'more'` — a composition that has restored the ×.
      */
-    secondary?: 'decline' | 'next' | 'none';
+    secondary?: 'decline' | 'next' | 'none' | 'more';
     /**
      * Overrides the default trust line. Present so a publisher whose reward is not a
      * free trial is not stuck asserting "No charges until trial ends" — the default
      * is the variant's copy, not a universal truth.
      */
     trustText?: string;
+    /**
+     * The gift flow's terms line, rendered UNDER the primary CTA ("One gift per
+     * person"). Absent for every other composition, which has no such line.
+     */
+    termsText?: string;
+    /**
+     * A ready-built terms element rendered where `termsText` would be, under the primary
+     * CTA. The `giftList` and `giftUnwrap` compositions pass the shared terms line (`ui/termsLine.ts`), whose
+     * underlined "offer terms" run is markup a plain string cannot carry. Takes
+     * precedence over `termsText` when both are given.
+     */
+    termsElement?: HTMLElement;
+    /**
+     * Whether to render the trust line above the CTA stack. Defaults to `true`.
+     *
+     * `false` only for a composition whose terms line REPLACES the per-offer fine print
+     * (`giftList` and `giftUnwrap`): there the design has nothing above the CTA, and `setTrustText` becomes
+     * a no-op because there is no line to write.
+     */
+    showTrust?: boolean;
+    /**
+     * The primary CTA's copy, replacing "Claim gift".
+     *
+     * The gift flow names the selected gift here, and re-words it on every selection
+     * change via {@link RewardActions.setPrimaryLabel}. A publisher's own copy still
+     * wins — see `ActionSlot.setLabel`.
+     */
+    primaryLabel?: string;
     /**
      * When false the primary CTA renders disabled — the host has switched claiming
      * off via `Encore.isClaimEnabled`. "No thanks" stays live: a user must always be
@@ -105,6 +161,34 @@ export declare class RewardActions {
      * when the offer has no advertiser name, so the button is announced by its text.
      */
     setSelectedOffer(advertiserName?: string): void;
+    /**
+     * The secondary control's element, or `undefined` when the mode renders none.
+     *
+     * Exists so a caller that opens something over the sheet can hand focus BACK to the
+     * control the user pressed. Read-only by intent: callers position and focus it, they
+     * do not rewire it — the behaviour stays owned here.
+     */
+    getSecondaryElement(): HTMLElement | undefined;
+    /**
+     * Replace the trust line, because WHICH LINE IS TRUE depends on the selected offer.
+     *
+     * Called on every selection change: one sheet can hold a free trial and a paid
+     * discount, so a line chosen once at render is wrong as soon as the user moves. A
+     * blank or absent value falls back to the shipped default rather than blanking the
+     * line, matching how `setPrimaryLabel` treats an empty label.
+     */
+    setTrustText(text: string | undefined): void;
+    /**
+     * Re-word the primary CTA — the gift flow naming the currently selected gift.
+     *
+     * Held as STATE for the same reason `#selectedAdvertiser` is: the selection is
+     * announced during the gift rows' own render, which runs before this block exists,
+     * so the first call always lands on a button that has not been built yet.
+     *
+     * Blank input is ignored rather than blanking the button: an offer that produced no
+     * name keeps whatever the CTA already said, which is at worst the shipped default.
+     */
+    setPrimaryLabel(label: string | undefined): void;
     destroy(): void;
 }
 //# sourceMappingURL=RewardActions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RewardActions.d.ts","sourceRoot":"","sources":["../../src/ui/RewardActions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAElF,mFAAmF;AACnF,eAAO,MAAM,WAAW;;;;IAItB,wEAAwE;;CAEhE,CAAC;AAEX,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wDAAwD;IACxD,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,aAAa;;gBAwBZ,OAAO,EAAE,oBAAoB;IAIzC,MAAM,IAAI,WAAW;IA8DrB;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAW/C,OAAO,IAAI,IAAI;CAWhB"}
+{"version":3,"file":"RewardActions.d.ts","sourceRoot":"","sources":["../../src/ui/RewardActions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAIlF,mFAAmF;AACnF,eAAO,MAAM,WAAW;IACtB;;;;OAIG;;IAEH;;;;;;;;OAQG;;;;IAIH,wEAAwE;;IAExE,2EAA2E;;CAEnE,CAAC;AAYX,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wDAAwD;IACxD,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,aAAa;;gBAkCZ,OAAO,EAAE,oBAAoB;IAyBzC,MAAM,IAAI,WAAW;IAyFrB;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAK/C;;;;;;OAMG;IACH,mBAAmB,IAAI,WAAW,GAAG,SAAS;IAI9C;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAW5C;;;;;;;;;OASG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IA0BhD,OAAO,IAAI,IAAI;CAWhB"}

package/types/ui/RewardCard.d.ts

@@ -27,15 +27,23 @@ import type { OfferModel as Offer } from '../api/models';
 /**
  * Copy the card hard-codes, mirroring `RewardActions`' REWARD_COPY.
  *
- * The badge is SDK-owned rather than per-offer because no field carries it: the
- * contract has no badge/category on `Creative`, and the Figma's own cards disagree
- * with each other (a "Free 30 days trial" pill above a "50% discount for 3 month"
- * line). It is overridable for the same reason the trust line is — a publisher whose
- * reward is not a trial must not be stuck asserting one.
+ * THE BADGE IS PER-OFFER, and this comment used to say the opposite — "no field
+ * carries it: the contract has no badge/category on Creative". That was wrong about
+ * where to look: `badgeLabel` is on the CAMPAIGN, a constrained enum the contract
+ * explicitly tells clients to map to display text. The SDK simply never read it, so
+ * every card asserted "Free trial" including for offers that charge on day one.
+ *
+ * The mapping lives in `ui/offerBadge.ts`; absent or unrecognised reads as
+ * "Exclusive", which promises nothing.
+ *
+ * ⚠️ `badgeText` IS NOT A PUBLISHER ESCAPE HATCH, despite reading like one. Nothing
+ * passes it: `OfferCarousel` constructs `new RewardCard()` with no options, and it is
+ * absent from `types.ts`, so it is not reachable through `appearance`. The same is
+ * true of `RewardActionsOptions.trustText`, whose only caller is the SDK itself. So
+ * every reward publisher gets the derived badge and the derived fine print — there is
+ * no per-publisher override of either today, and any claim that there is should be
+ * checked against these two call sites before it is repeated.
  */
-export declare const REWARD_CARD_COPY: {
-    readonly badge: "Free trial";
-};
 export interface RewardCardOptions {
     /** Overrides the badge pill. Blank/absent keeps the variant's copy. */
     badgeText?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"RewardCard.d.ts","sourceRoot":"","sources":["../../src/ui/RewardCard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAMzD;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB;;CAEnB,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,UAAU;;gBAMT,OAAO,GAAE,iBAAsB;IAI3C,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW;IA2GjC,OAAO,IAAI,IAAI;CAKhB"}
+{"version":3,"file":"RewardCard.d.ts","sourceRoot":"","sources":["../../src/ui/RewardCard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAOzD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,UAAU;;gBAMT,OAAO,GAAE,iBAAsB;IAI3C,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW;IA2GjC,OAAO,IAAI,IAAI;CAKhB"}

package/types/ui/RewardConfetti.d.ts

@@ -26,6 +26,28 @@ export declare const CONFETTI_SPEC: {
     readonly scatter: 46;
     readonly scatterHeight: 0.3;
 };
+/**
+ * A point inside the host, in CSS pixels from its top-left, that particles fire OUT
+ * of — see {@link ConfettiOptions.origin}.
+ */
+export interface ConfettiOrigin {
+    x: number;
+    y: number;
+}
+export interface ConfettiOptions {
+    /**
+     * Emit as a BURST from this point instead of the variant's default rain.
+     *
+     * The reward sheet's own confetti falls from the top edge (`originY: 0.0`), which is
+     * what `streaksCarousel.json` specifies and what iOS and Android render. The gift
+     * hero needs the other shape: everything leaves the mouth of the box at once and
+     * arcs outward. That is a different set of initial conditions for the SAME particle
+     * system, not a different particle system — same canvas, same gravity, same drag,
+     * same fade, same reduced-motion skip — so it is an option here rather than a second
+     * confetti implementation.
+     */
+    origin?: ConfettiOrigin;
+}
 export declare class RewardConfetti {
     #private;
     /**
@@ -40,7 +62,7 @@ export declare class RewardConfetti {
      * Mount the burst inside `host` and start it. Returns silently if confetti cannot
      * run; the caller never has to branch.
      */
-    start(host: HTMLElement): void;
+    start(host: HTMLElement, options?: ConfettiOptions): void;
     destroy(): void;
 }
 //# sourceMappingURL=RewardConfetti.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RewardConfetti.d.ts","sourceRoot":"","sources":["../../src/ui/RewardConfetti.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,wEAAwE;AACxE,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAkCX,qBAAa,cAAc;;IASzB;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,IAAI,OAAO;IAU5B;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAmI9B,OAAO,IAAI,IAAI;CAWhB"}
+{"version":3,"file":"RewardConfetti.d.ts","sourceRoot":"","sources":["../../src/ui/RewardConfetti.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,wEAAwE;AACxE,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAkCX;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAMD,qBAAa,cAAc;;IASzB;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,IAAI,OAAO;IAU5B;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI;IAwK7D,OAAO,IAAI,IAAI;CAWhB"}

package/types/ui/RewardLayout.d.ts

@@ -54,6 +54,41 @@ export interface RewardLayoutOptions {
      */
     headlineSlot?: TextSlot;
     subheadlineSlot?: TextSlot;
+    /**
+     * A ready-built visual placed ABOVE the status block — the gift flow's opening box.
+     *
+     * An ELEMENT for the same reason `actions` is: the hero owns an animation, a
+     * confetti canvas and a teardown, all three of which this pure render function must
+     * not acquire. It only positions it.
+     *
+     * Above the headline rather than below it because the hero IS the headline's
+     * subject: the copy reads "here is a gift for you" and the box has to have opened
+     * before that sentence means anything.
+     */
+    hero?: HTMLElement;
+    /**
+     * Marks this as the GIFT composition, which pins the artifact's own palette and copy
+     * instead of following the publisher/variant theme.
+     *
+     * A class on the root rather than a prop threaded into every child: the override is
+     * entirely a matter of which colours win, and scoping it to one ancestor keeps every
+     * other composition — `reduceChurn`, and any future reward surface — reading the
+     * theme exactly as before. See the gift block in styles.ts.
+     */
+    giftMode?: boolean;
+    /**
+     * An extra BEM modifier on the root, as `thankyou--{rootModifier}` — how a bespoke
+     * reward surface scopes its own palette and composition rules (`gift-list`) without
+     * borrowing another surface's. Same reasoning as `giftMode`: one ancestor class, so
+     * every other composition keeps reading the theme exactly as before.
+     */
+    rootModifier?: string;
+    /**
+     * Set FREE in the accent colour in the headline, independently of `giftMode`.
+     * Defaults to `giftMode`, so the `giftReveal` composition is unchanged. The caller
+     * decides it because only the caller knows which tier of the copy chain won.
+     */
+    emphasizeFree?: boolean;
     /** Passed to the slot renderers as context. Defaults to the only use case that composes this chrome. */
     useCase?: UseCase;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"RewardLayout.d.ts","sourceRoot":"","sources":["../../src/ui/RewardLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAwB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAChC;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,eAAe,CAAC,EAAE,QAAQ,CAAC;IAC3B,wGAAwG;IACxG,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,WAAW,EAC5B,OAAO,GAAE,mBAAwB,GAChC,WAAW,CA+Db"}
+{"version":3,"file":"RewardLayout.d.ts","sourceRoot":"","sources":["../../src/ui/RewardLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG3D;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAAwB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAChC;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,eAAe,CAAC,EAAE,QAAQ,CAAC;IAC3B;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wGAAwG;IACxG,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,WAAW,EAC5B,OAAO,GAAE,mBAAwB,GAChC,WAAW,CAwFb"}

package/types/ui/advertiserPreconnect.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Warm the connection to the SELECTED offer's advertiser origin while the user is
+ * still deciding, so the tap pays for the navigation rather than for DNS + TCP + TLS.
+ *
+ * The origin is known as soon as the surface renders — `advertiserUrl` arrives with
+ * `offers/search` — while only the transaction id is missing until the claim resolves.
+ * So there is a whole deliberation window in which the handshake can already be done.
+ *
+ * Measured in a WKWebView on an iPhone 16 Pro against the real brokered origin the
+ * captured production payload ships (`https://www.searchcactus.com`), one cold sample
+ * per app launch, six launches per arm:
+ *
+ *   no preconnect          372 408 418 357 359 383   median 378ms
+ *   preconnect             97  89  104 128 99  114   median 102ms
+ *   preconnect crossorigin 87  92  102 99  91  92    median  92ms
+ *
+ * ~276ms of the pre-navigation cost, for one handshake.
+ *
+ * 🔴 THE ORIGIN ONLY, NEVER THE URL — and this is a money-pipeline rule, not a
+ * performance trade-off to weigh. The final advertiser URL is the ATTRIBUTED CLICK:
+ * requesting it records a click against a transaction. Speculatively fetching it would
+ * book attribution for users who never tapped and corrupt the conversion data. So
+ * nothing here may ever become `rel=prefetch`, `rel=prerender`, `rel=preload`, a
+ * `fetch()`, or an image against the advertiser URL. `preconnect` and `dns-prefetch`
+ * open a socket and resolve a name; they send no request and no path.
+ *
+ * NO `crossorigin`, deliberately, and the brief that asked for this suggested it. The
+ * crossorigin form warms the ANONYMOUS connection pool (fonts, CORS `fetch`), while the
+ * thing that follows is a TOP-LEVEL NAVIGATION, which uses the ordinary one. Measured
+ * above, the two are indistinguishable in this webview — so `crossorigin` buys nothing
+ * here and the plain form is the one that can definitely serve a navigation. The
+ * `dns-prefetch` sibling stays as the fallback for engines that ignore preconnect.
+ *
+ * ONCE PER PRESENTATION, ON THE FIRST SELECTION — Junaid's call, and it is a privacy
+ * decision rather than a performance one. A preconnect is a TLS handshake from the
+ * user's IP, so an advertiser learns a user is there before the user has engaged with
+ * that offer; today they learn nothing until the click. Warming on every selection
+ * change would disclose one advertiser per row the user browses. Warming once
+ * discloses exactly one per presentation and keeps most of the ~276ms, because the
+ * first selection is the auto-selected offer and therefore the one most likely to be
+ * claimed. The same instinct as `no-referrer` on the hosted offer page.
+ *
+ * So `point()` is a LATCH: the first warmable origin wins and later calls are ignored.
+ * That also makes the concurrent-preconnect cap (~6) a non-issue and costs the user
+ * exactly one handshake.
+ *
+ * NOT WIRED AT ALL WHEN CLAIMING IS OFF. With `claimEnabled: false` the CTA is
+ * disabled and no navigation to the advertiser can happen, so a handshake there is
+ * cost with no possible benefit — and, given the disclosure question this raises, it
+ * would be telling an advertiser about a user in a flow that cannot convert.
+ *
+ * For a BROKERED campaign `advertiserUrl` is the tracking network's host rather than
+ * the advertiser's own — that is still the right thing to warm, because it is the first
+ * hop the browser actually makes. The redirect to `expectedDomain` happens afterwards,
+ * so warming that instead would warm a host this navigation never contacts first.
+ */
+/**
+ * The origin to warm, or `null` when there is nothing safe to warm.
+ *
+ * Exported for the tests, which is worth it: the parsing is the part that must never
+ * throw, and it is far easier to prove that against a list of hostile strings than
+ * through the DOM.
+ */
+export declare function warmableOrigin(advertiserUrl: string | undefined | null): string | null;
+export declare class AdvertiserPreconnect {
+    #private;
+    /**
+     * @param doc The document to hang the hints on. `null` means "there is no DOM here",
+     *   which must degrade to doing nothing rather than throwing. It is `null` and not
+     *   `undefined` on purpose: `undefined` is what a caller passes when it wants the
+     *   default, so it cannot also mean "none" — a parameter default is applied to
+     *   `undefined`, which made the no-DOM case impossible to express or to test.
+     */
+    constructor(doc?: Document | null);
+    /** The origin currently being warmed, or `null`. Exposed for assertions. */
+    get origin(): string | null;
+    /**
+     * Warm this offer's advertiser origin, if nothing has been warmed yet.
+     *
+     * Safe to call on every selection change, and deliberately DOES NOTHING after the
+     * first success: this is a latch, not a follower. See the header — warming per
+     * selection would disclose the user to one advertiser per row they browse.
+     *
+     * A call that resolves no warmable origin does not spend the latch, so a first
+     * selection with a malformed `advertiserUrl` still lets the next one warm.
+     */
+    point(advertiserUrl: string | undefined | null): void;
+    destroy(): void;
+}
+//# sourceMappingURL=advertiserPreconnect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"advertiserPreconnect.d.ts","sourceRoot":"","sources":["../../src/ui/advertiserPreconnect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAKH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAoBtF;AAED,qBAAa,oBAAoB;;IAM/B;;;;;;OAMG;gBACS,GAAG,GAAE,QAAQ,GAAG,IAAwD;IAIpF,4EAA4E;IAC5E,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI;IA6BrD,OAAO,IAAI,IAAI;CAWhB"}

package/types/ui/appearance.d.ts

@@ -136,6 +136,33 @@ export interface ActionSlotOptions {
 export interface ActionSlot {
     element: HTMLElement;
     setAccessibleName: (name: string | undefined) => void;
+    /**
+     * Re-word the control's VISIBLE label.
+     *
+     * For the gift flow's CTA, which names the gift the user has currently selected and
+     * therefore changes as they move through the radio group. Distinct from
+     * `setAccessibleName`, which EXTENDS the label for screen readers without altering
+     * what is drawn (WCAG 2.5.3); this replaces the drawn text outright.
+     *
+     * 🔴 A NO-OP WHENEVER THE PUBLISHER OWNS THE TEXT. If they supplied their own element
+     * or overrode the copy through a style config, that copy stands — the appearance API
+     * is theirs, and silently rewriting a button they worded is exactly the boundary
+     * violation `createActionSlot` exists to prevent. A custom element with no text of
+     * its own (an icon, an image) still gets its accessible-name fallback updated, since
+     * the SDK owns that string in the first place.
+     */
+    setLabel: (text: string) => void;
+    /**
+     * The control's EFFECTIVE VISIBLE label — the publisher's copy when they supplied
+     * any, the SDK's otherwise.
+     *
+     * Exists because WCAG 2.5.3 (Label in Name) constrains the accessible name to CONTAIN
+     * the visible one, so anything that extends the name has to extend what is actually
+     * drawn rather than what the SDK would have drawn. Reading it back from the control
+     * is the only way to be right in the two cases where those differ: a style config
+     * that replaced the copy, and a publisher element carrying its own text.
+     */
+    getLabel: () => string;
     /**
      * Detach the SDK's listeners and release the publisher's element.
      *