@encorekit/web-sdk 2.1.4 → 2.2.1

package/types/core/share.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The `share` action: hand the link the backend minted for an offer to the user.
+ *
+ * THE LINK IS THE SERVER'S, NEVER THIS SDK'S. It arrives as `OfferModel.shareUrl` and
+ * is shared exactly as served. An offer without one shares nothing and reports
+ * `missing_share_link`; there is no fallback to the advertiser URL or to any link this
+ * SDK could assemble, because a client-built link is forgeable and unattributed. Same
+ * rule as iOS (swift#156) and Android (android#93).
+ *
+ * TWO ROUTES, in order:
+ *   1. `navigator.share`, the system share sheet. It resolves when the user sent the
+ *      link and rejects when they backed out, so web, like iOS, can tell a completed
+ *      share from a cancel. A cancel is reported as `completed=false`, never as a
+ *      failure, and it is not always spelled `AbortError`: `NotAllowedError` and
+ *      `InvalidStateError` count too (see `CANCEL_NAMES`).
+ *   2. The clipboard, where there is no share sheet (most desktop browsers) or the
+ *      sheet rejected the data itself. The caller shows a visible confirmation; the
+ *      completed event says `clipboard`.
+ * When neither takes the link the tap fails with `share_unavailable`.
+ *
+ * 🔴 CALLED INSIDE THE CLICK. `navigator.share` and, on Safari, the clipboard need
+ * transient user activation, so nothing may be awaited before the first call. An
+ * `async` function runs synchronously up to its first `await`, which is what keeps
+ * the `navigator.share` call inside the gesture.
+ *
+ * NEVER THROWS. Every browser call is guarded; the worst outcome is a reported failure.
+ */
+import { type ShareDestinationValue, type ShareFailureReasonValue } from '../analytics/events';
+export type ShareOutcome = {
+    status: 'shared';
+    destination: ShareDestinationValue;
+} | {
+    status: 'cancelled';
+} | {
+    status: 'failed';
+    reason: ShareFailureReasonValue;
+};
+/** Send `url` through the share sheet, else the clipboard. Resolves; never rejects. */
+export declare function sendShareLink(url: string): Promise<ShareOutcome>;
+/** Receives the three share events. Thrown errors are contained, never surfaced. */
+export interface ShareReporter<C> {
+    tapped(ctx: C): void;
+    failed(ctx: C, reason: ShareFailureReasonValue): void;
+    completed(ctx: C, destination: ShareDestinationValue | undefined, completed: boolean): void;
+}
+export interface ShareAction<C> {
+    /**
+     * Share `link` for the offer `ctx` describes. Returns null, reporting nothing, when a
+     * share is already in flight or the action is locked: a double tap must not stack two
+     * share sheets or count one tap twice. Otherwise every call reports `tapped` and then
+     * exactly one of `completed` or `failed`, before the returned promise settles.
+     */
+    run(link: string | undefined, ctx: C): Promise<ShareOutcome> | null;
+    /** Refuse every later call. For a presentation that is closing after a share. */
+    lock(): void;
+}
+export declare function createShareAction<C>(reporter: ShareReporter<C>, send?: (url: string) => Promise<ShareOutcome>): ShareAction<C>;
+//# sourceMappingURL=share.d.ts.map

package/types/core/share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../../src/core/share.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAG7B,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,qBAAqB,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAW1D,uFAAuF;AACvF,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAgBtE;AAwDD,oFAAoF;AACpF,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACtD,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7F;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IACpE,iFAAiF;IACjF,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAiB,GAC3D,WAAW,CAAC,CAAC,CAAC,CA6ChB"}

package/types/core/unlockCode.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The one place a `codeUnlock` code is judged. PLACEHOLDER: any non-empty code passes.
+ * The code is never sent anywhere; a real check replaces `checkUnlockCode` alone.
+ */
+/** Longest code the input accepts. A code is a short word, not a payload. */
+export declare const UNLOCK_CODE_MAX_LENGTH = 64;
+export type UnlockCodeVerdict = {
+    ok: true;
+}
+/** `rejected` is for a real check; the placeholder only ever says `empty`. */
+ | {
+    ok: false;
+    reason: 'empty' | 'rejected';
+};
+/** A code as typed or linked, trimmed and capped. Anything but a string is empty. */
+export declare function normalizeUnlockCode(raw: unknown): string;
+/**
+ * The "Up to {amount} in rewards" amount, or null for no line. Page-supplied: a campaign's
+ * oldPrice/newPrice are free-text display prices with no currency or period, so nothing on
+ * an offer states a reward value. Only a short money amount is accepted, never free text.
+ */
+export declare function unlockValueAmount(raw: unknown): string | null;
+/** Does `code` unlock the offers? Placeholder: yes, for any non-empty code. */
+export declare function checkUnlockCode(code: string): Promise<UnlockCodeVerdict>;
+//# sourceMappingURL=unlockCode.d.ts.map

package/types/core/unlockCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlockCode.d.ts","sourceRoot":"","sources":["../../src/core/unlockCode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE;AACd,8EAA8E;GAC5E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAAA;CAAE,CAAC;AAEhD,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ7D;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAExE"}

package/types/core/version.d.ts

@@ -1,3 +1,3 @@
 /** SDK version — single source of truth (also kept in sync with package.json via scripts/update-version.sh) */
-export declare const SDK_VERSION = "2.1.4";
+export declare const SDK_VERSION = "2.2.1";
 //# sourceMappingURL=version.d.ts.map

package/types/types.d.ts

@@ -254,6 +254,10 @@ export interface PlacementOptions {
      * On the reward composition the "No thanks" button becomes "Next offer"
      * rather than disappearing — see `RewardActionsOptions.secondary`. A button
      * reading "No thanks" on a sheet with no way out is a control that lies.
+     *
+     * The `codeUnlock` code screen ignores `false` while it is showing: its × and
+     * Escape stay, so a code that is not accepted can never trap the user on a
+     * full-screen page. The option applies from the moment the offers show.
      */
     dismissible?: boolean;
     /**
@@ -272,6 +276,25 @@ export interface PlacementOptions {
      */
     statusIcon?: 'success' | 'none';
     appearance?: AppearanceConfig;
+    /**
+     * A code to type into the `codeUnlock` screen ahead of time — the code a link or an
+     * email carried. The user still presses Unlock. Ignored by every other surface.
+     *
+     * The SDK never reads the page URL for it: the page that owns the URL decides which
+     * parameter holds the code and passes it here. The code is not sent anywhere; see
+     * `core/unlockCode.ts`. Trimmed and capped at 64 characters; a non-string is ignored.
+     */
+    unlockCode?: string;
+    /**
+     * The most the `codeUnlock` offers are worth, as a short amount: `'$45'`, `'£20'`,
+     * `'45 USD'`. Shown as "Up to $45 in rewards" on the code screen. Anything that is not
+     * a short money amount shows no line, so a link cannot put its own text on the page.
+     *
+     * Supplied by the page, not derived: no offer field states a reward value today
+     * (`oldPrice`/`newPrice` are free-text display prices with no currency). Ignored by
+     * every other surface.
+     */
+    unlockValueLabel?: string;
 }
 /**
  * Presentation callbacks for the bare `Encore.show()` form.
@@ -434,14 +457,15 @@ export interface EncoreConfig {
      * `'giftUnwrap'` — so a tester can pick a flow instead of taking whichever one the
      * server would have picked.
      *
-     * **It never affects live traffic.** All it does is add a `demoVariant` query
-     * parameter to the two `/config` fetches. The backend honours that parameter only
-     * on a TEST KEY (`pk_test_*`) — where it works for any app, so you can preview
-     * our reward variants against your own test key — and ignores it on a live key.
-     * Set it on a `pk_live_*` key and you get exactly the response, and exactly the
-     * surface, you would have got without it; the SDK logs one `[DEMO]` line saying
-     * so rather than leaving you to wonder. It never renders anything the server did
-     * not serve.
+     * **It never affects a publisher's live traffic.** All it does is add a
+     * `demoVariant` query parameter to the two `/config` fetches. The backend honours
+     * that parameter on a TEST KEY (`pk_test_*`) — where it works for any app, so you
+     * can preview our reward variants against your own test key — and on a live key
+     * only for Encore's own demo apps. For every other app it is ignored on a live
+     * key: set it on a `pk_live_*` key and you get exactly the response, and exactly
+     * the surface, you would have got without it; the SDK logs one `[DEMO]` line
+     * saying so rather than leaving you to wonder. It never renders anything the
+     * server did not serve.
      *
      * Changing it between presentations drops every in-memory answer the previous
      * flow produced, so the next `show()` asks the server again. Blank,
@@ -458,6 +482,35 @@ export interface EncoreConfig {
      * was honoured. Absent for everyone else.
      */
     demoVariant?: string;
+    /**
+     * Let a labelled reward placement resolve its own variant. Defaults to `false`.
+     *
+     * Encore can serve a different reward variant per placement label (for example
+     * one flow for `'email_code'` and another for `'email'`). The variant the SDK
+     * prefetches at `configure()` is chosen before any placement is known, so it
+     * cannot carry that choice. With this on, a `rewardUsers` presentation that has a
+     * placement label — `Encore.placement('email_code', { useCase: 'rewardUsers' })`,
+     * or `show(options, { useCase: 'rewardUsers' }, 'email_code')` — makes one
+     * `GET /config?useCase=post-action-reward&placementId=<label>` before the sheet
+     * renders and presents the variant that response names. Analytics for that
+     * presentation carry that variant's id.
+     *
+     * - The label is trimmed and capped at 64 characters, exactly as it is on the
+     *   offers request and on analytics.
+     * - A settled answer is reused for every presentation of that label for the rest
+     *   of the session (until `reset()`), while a failed or discarded request is
+     *   retried on the next presentation.
+     * - It never blocks or breaks a presentation. If the request fails, is slow, or
+     *   resolves nothing, the surface resolves exactly as it would with this off:
+     *   the prefetched variant when there is one, otherwise the SDK's usual
+     *   on-demand `/config?useCase=` fetch.
+     * - Paywall (`reduceChurn`) presentations and unlabelled ones are unaffected.
+     *
+     * Off, the SDK's requests are exactly what they were before the option existed.
+     * Only a literal `true` turns it on. Like the other options it is read from the
+     * first `configure()` call.
+     */
+    resolveVariantsByPlacement?: boolean;
 }
 /** Result of `show()` / `present()`. */
 export type ShowResult = 

package/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM/C;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,aAAa,GAAG,KAAK,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,aAAa,GAAG,UAAU,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CAClD;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAMD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,oBAAoB,GACpB,uBAAuB,GACvB,mBAAmB;AACrB,sFAAsF;GACpF,mBAAmB;AACrB;;;;GAIG;GACD,eAAe,GACf;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,oDAAoD;IACpD,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,wEAAwE;IACxE,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,OAAO,GAAG,aAAa,GAAG,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IACpD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACzC,oEAAoE;IACpE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC5C,kFAAkF;IAClF,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,gBAAgB,CAAC;IAC7E,oBAAoB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAAG,gBAAgB,CAAC;IAC/E;;;;;OAKG;IACH,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CACjC;AAMD;;GAEG;AACH,oBAAY,SAAS;IACnB,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,mBAAmB,wBAAwB;IAC3C,oBAAoB,yBAAyB;IAC7C,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAM7F;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gGAAgG;IAChG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,CAAC;IACrE;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IACrC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,wCAAwC;AACxC,MAAM,MAAM,UAAU;AACpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AACH,wDAAwD;GACtD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAAE;AACpD,8DAA8D;GAC5D;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAM9B;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,qFAAqF;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,QAAQ,CAAC;IAChB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IAC/B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAED,4BAA4B;AAC5B,MAAM,MAAM,YAAY;AACtB,2EAA2E;AACzE;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE;AACxB;;;;;GAKG;GACD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAAE;AACpD;;;GAGG;GACD;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/types/ui/CodeUnlock.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Code unlock — the screen the `codeUnlock` variant puts in front of the gift picker.
+ *
+ * Two screens in one root, in the order the user meets them:
+ *
+ *   1. CODE. A full-screen landing page at every width, the way a page reached from an
+ *      email should read: the host's name, a value card ("Up to $45 in rewards" when the
+ *      page supplies an amount, `PlacementOptions.unlockValueLabel`), "Your rewards are
+ *      waiting", one line and an inline code field with "Unlock my rewards" attached;
+ *      then a preview of the loaded offers (logos and names, no count),
+ *      then three short steps. Two columns from 900px, stacked below. A code from the
+ *      link (`PlacementOptions.unlockCode`) is already typed in; the user still
+ *      presses Unlock, because pressing it is the moment.
+ *   2. OFFERS. THE SAME PAGE. The header and the value card stay where they were (the
+ *      card now open), the code form gives way to "Your exclusive offers" under an
+ *      "Exclusive offers unlocked" badge, and the picker's own rows, "More gifts", CTA
+ *      and terms line render INLINE where the preview strip was. No modal frame and no
+ *      backdrop: `Encore` hands this class the picker's surface and action block
+ *      ({@link CodeUnlockParts}) and it lays them out on the page, under the picker's
+ *      own class names so the styling is the picker's rather than a copy of it.
+ *
+ * ## The keyboard
+ *
+ * The screen fills the layout viewport, which an on-screen keyboard covers without
+ * resizing on iOS and on Android's default. While the code screen shows, the gate follows
+ * `visualViewport` and pads the screen by the covered height (`--encore-cu-kb`), so the
+ * centred content moves up and the input and Unlock stay above the keyboard.
+ *
+ * 🔴 THIS IS A GATE, NOT A SURFACE. It never selects, claims or reports an offer: the
+ * picker behind it does all of that through the one claim path (see `rewardSurface.ts`),
+ * so a `codeUnlock` claim is byte-for-byte a `giftPicker` claim.
+ *
+ * ## The code goes nowhere
+ *
+ * The typed code is read by {@link checkUnlockCode} in `core/unlockCode.ts` and nothing
+ * else. It is not an analytics property and not a request parameter. Today that check
+ * is a placeholder that accepts any non-empty code; making codes real means changing
+ * that one function (it is injectable here only so tests can stand in for it).
+ *
+ * ## Impressions wait for the unlock
+ *
+ * The offers screen is `hidden` (display: none) until the reveal ends, so the shared
+ * impression gate's paint check refuses every row behind the code screen, and the
+ * offers' entrance fade holds them until it finishes. An offer is billed only once the
+ * user can actually see it, which is the same rule every other surface keeps.
+ *
+ * ## The reveal (see codeUnlockStyles in styles.ts)
+ *
+ * One timeline in two halves, about 850ms in all. On the code screen the shackle lifts
+ * and swings open while the form fades away ({@link CODE_UNLOCK_REVEAL_MS}); then the
+ * screens swap and the badge pops in as the offers slide up ({@link CODE_UNLOCK_ENTER_MS}). The swap is a
+ * timer, not `animationend`, so a hidden tab or disabled animations still arrive at the
+ * offers. Every base rule is the finished state; reduced motion swaps at once.
+ */
+import type { OfferModel as Offer } from '../api/models';
+import { type UnlockCodeVerdict } from '../core/unlockCode';
+/** The code screen's half of the reveal. The stylesheet carries the same number. */
+export declare const CODE_UNLOCK_REVEAL_MS = 450;
+/** The offers' entrance after the swap. The stylesheet carries the same number. */
+export declare const CODE_UNLOCK_ENTER_MS = 400;
+/**
+ * How long both screens are on screen together at the swap.
+ *
+ * THE TWO SCREENS CROSS-FADE, they do not take turns. Hiding the code screen and then
+ * fading the offers in leaves a beat with neither on screen, which reads as a white
+ * flash; for that beat the outgoing screen is laid over the incoming one and fades out
+ * while it rises. The stylesheet carries the same number.
+ */
+export declare const CODE_UNLOCK_CROSSFADE_MS = 220;
+/** The id on the code screen's heading, which names the dialog while it shows. */
+export declare const CODE_UNLOCK_TITLE_ID: string;
+/** Forget that a code was accepted. Called by `Encore.reset()`, and by tests. */
+export declare function forgetUnlock(): void;
+/** Every sentence the gate says. */
+export declare const CODE_UNLOCK_COPY: {
+    readonly title: "Your rewards are waiting";
+    readonly inputLabel: "Your code";
+    readonly inputPlaceholder: "Enter your code";
+    readonly cta: "Unlock my rewards";
+    readonly emptyError: "Enter your code to continue.";
+    readonly rejectedError: "That code didn’t work. Check it and try again.";
+    readonly unlocked: "Exclusive offers unlocked";
+    readonly cardFallback: "Rewards picked for you";
+    readonly previewTitle: "Rewards you can choose from";
+    readonly previewNote: "Unlock to pick yours.";
+    readonly howTitle: "How it works";
+    readonly steps: readonly [readonly ["Enter your code", "It’s in the email we sent you."], readonly ["Pick a reward", "Choose the one you like best."], readonly ["Enjoy it", "Finish on the brand’s site."]];
+    /** The picker's headline behind the gate, in place of the served one. */
+    readonly offersHeadline: "Your exclusive offers";
+    readonly offersSubline: "Pick one, it’s on us";
+};
+/** The line under the heading, naming the amount when the page supplied one. */
+export declare function unlockSubline(amount: string | null): string;
+export interface CodeUnlockOptions {
+    /** The code from the link, typed in ahead of time. Trimmed and capped; not checked until Unlock. */
+    initialCode?: string;
+    /**
+     * The most the offers are worth, as the page states it ("$45"). Publisher-supplied;
+     * see {@link unlockValueAmount} for why and for what is accepted. No valid amount, no line.
+     */
+    valueLabel?: string;
+    /**
+     * The offers the picker behind the gate will show. The landing page previews them
+     * (logo and name) and counts them; it never links, selects or reports them.
+     */
+    offers?: readonly Offer[];
+    /** The host app's name for the page header (`values.text.appName`). No name, no header. */
+    hostName?: string;
+    /** The host app's icon beside that name. */
+    hostIconUrl?: string;
+    /** Called once, when the offers screen is showing. */
+    onUnlock?: () => void;
+    /** The code check. Tests only: production always uses {@link checkUnlockCode}. */
+    check?: (code: string) => Promise<UnlockCodeVerdict>;
+}
+/**
+ * The unlocked screen's content, built by `Encore`: the picker's surface element and
+ * its action block, plus the copy the reward chain resolved. The gate lays them out; it
+ * never builds a row or claims anything itself.
+ */
+export interface CodeUnlockParts {
+    /** The resolved headline, which also names the dialog once unlocked. */
+    title: string;
+    subtitle?: string;
+    /** `GiftPicker.render()`: the rows, "More gifts" and its sheet. */
+    surface: HTMLElement;
+    /** `RewardActions.render()`: the CTA and the terms line. */
+    actions?: HTMLElement;
+}
+export interface CodeUnlockComposeOptions {
+    /**
+     * Point the dialog's `aria-labelledby` at `id`: the code screen's heading while it
+     * shows, `REWARD_TITLE_ID` after the unlock. A callback because the modal is Encore's.
+     */
+    setLabelledBy?: (id: string) => void;
+}
+export declare class CodeUnlock {
+    #private;
+    constructor(options?: CodeUnlockOptions);
+    isUnlocked(): boolean;
+    /**
+     * Build both screens of the page and return the root to hand the modal.
+     *
+     * The code screen shows; the unlocked screen is built now and kept `hidden`, so the
+     * picker's rows are laid out but painted by nothing until the unlock — which is what
+     * keeps their impressions until then.
+     */
+    compose(parts: CodeUnlockParts, options?: CodeUnlockComposeOptions): HTMLElement;
+    destroy(): void;
+}
+//# sourceMappingURL=CodeUnlock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CodeUnlock.d.ts","sourceRoot":"","sources":["../../src/ui/CodeUnlock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAWH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,QAA2B,CAAC;AAgB7D,iFAAiF;AACjF,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAKD,oCAAoC;AACpC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;IAiB3B,yEAAyE;;;CAGjE,CAAC;AAEX,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI3D;AAiBD,MAAM,WAAW,iBAAiB;IAChC,oGAAoG;IACpG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAC1B,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,kFAAkF;IAClF,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,OAAO,EAAE,WAAW,CAAC;IACrB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,qBAAa,UAAU;;gBAsBT,OAAO,GAAE,iBAAsB;IAI3C,UAAU,IAAI,OAAO;IAIrB;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,GAAE,wBAA6B,GAAG,WAAW;IAifpF,OAAO,IAAI,IAAI;CAkBhB"}

package/types/ui/GiftSheet.d.ts

@@ -63,10 +63,16 @@ export interface GiftSheetOptions {
     onCommit: (index: number) => void;
     /** The pick changed: the picked offer, or null once cleared. The footer follows it. */
     onPick?: (offer: Offer | null) => void;
-    /** The surface's impression gate. Cards are registered only while the sheet is open. */
-    impressions: ImpressionGate;
+    /**
+     * The surface's impression gate. Cards are registered only while the sheet is open.
+     * Omitted, the sheet reports no impressions at all: `giftUnwrap`'s keep-for-later
+     * panel lists gifts the rows already reported, and the variant marks it
+     * `impressionProbe: none`. Registering there would spend the gate's once-per-offer
+     * budget on a card that must not count.
+     */
+    impressions?: ImpressionGate;
     /** The gate judged the card for `index` shown. The surface emits the impression. */
-    onShown: (index: number) => void;
+    onShown?: (index: number) => void;
     /** The surface's listener lifetime; aborting it detaches every sheet listener. */
     signal: AbortSignal;
     /** The sheet's heading and group name. Defaults to `GIFT_COPY.sheetTitle` ("Other gifts"). */
@@ -92,6 +98,30 @@ export interface GiftSheetOptions {
      * passes a label that does not promise a claim.
      */
     ctaLabel?: (offer: Offer) => string;
+    /** A line under the heading. Newlines are kept. Absent by default. */
+    subtitle?: string;
+    /**
+     * What the close control AND Escape do. Defaults to closing the sheet. The
+     * keep-for-later panel's close is the presentation's real close, so it passes one
+     * that dismisses. The scrim always just closes the sheet.
+     */
+    onClose?: () => void;
+    /** An extra class on the layer, for a sheet styled as something else (the panel). */
+    layerClass?: string;
+    /**
+     * `false` never draws the category tab strip. The keep-for-later panel lists a
+     * handful of gifts in one row, as the native panel does, and a strip would hide the
+     * selection it opens on behind another tab. Defaults to the data-driven strip.
+     */
+    tabs?: boolean;
+    /**
+     * Whether the CTA is drawn for this pick. Defaults to always. The keep-for-later
+     * panel draws it only for a gift with a share link, as the native CTA's
+     * `hasOfferAttribute: shareUrl` gate does.
+     */
+    ctaFor?: (offer: Offer) => boolean;
+    /** Called once the sheet has closed, whatever closed it: the scrim or `close()`. */
+    onClosed?: () => void;
 }
 export declare class GiftSheet {
     #private;
@@ -119,7 +149,21 @@ export declare class GiftSheet {
      * categories the sheet holds; the selected tab survives when it still exists.
      */
     renderList(): void;
+    /**
+     * Pick the card for `index` from outside, as the keep-for-later panel does with the
+     * surface's selection so its CTA can act at once. Ignored when that card is not
+     * listed: the CTA must never name an offer the sheet does not show.
+     */
+    pick(index: number): void;
     open(opener?: HTMLElement): void;
+    /**
+     * Freeze the sheet while something it started finishes (the keep-for-later panel's
+     * wait before it closes): every card and the CTA are disabled and the scrim does
+     * nothing. The close control and Escape still work, as ways out. `true` restores.
+     */
+    setInteractive(interactive: boolean): void;
+    /** True from `open()` until `close()`: whether the sheet is up, or on its way up. */
+    isOpen(): boolean;
     close(): void;
     destroy(): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"GiftSheet.d.ts","sourceRoot":"","sources":["../../src/ui/GiftSheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAKzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAUvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAqB1E;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,GAAG,iBAAiB,EAAE,CAU3F;AAKD,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,yEAAyE;IACzE,MAAM,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IAChC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACjC,uFAAuF;IACvF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,uFAAuF;IACvF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;IACvC,wFAAwF;IACxF,WAAW,EAAE,cAAc,CAAC;IAC5B,oFAAoF;IACpF,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,kFAAkF;IAClF,MAAM,EAAE,WAAW,CAAC;IACpB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACrD;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;CACrC;AAED,qBAAa,SAAS;;gBAiCR,OAAO,EAAE,gBAAgB;IAKrC;;;;;;;;;;;;OAYG;IACH,MAAM,IAAI,WAAW;IAyHrB;;;;;;;OAOG;IACH,UAAU,IAAI,IAAI;IAsTlB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI;IAuChC,KAAK,IAAI,IAAI;IAqDb,OAAO,IAAI,IAAI;CAahB"}
+{"version":3,"file":"GiftSheet.d.ts","sourceRoot":"","sources":["../../src/ui/GiftSheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAKzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAUvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAqB1E;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,GAAG,iBAAiB,EAAE,CAU3F;AAKD,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,yEAAyE;IACzE,MAAM,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IAChC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACjC,uFAAuF;IACvF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,uFAAuF;IACvF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;IACvC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,oFAAoF;IACpF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,kFAAkF;IAClF,MAAM,EAAE,WAAW,CAAC;IACpB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACrD;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IACpC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IACnC,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,qBAAa,SAAS;;gBAmCR,OAAO,EAAE,gBAAgB;IAKrC;;;;;;;;;;;;OAYG;IACH,MAAM,IAAI,WAAW;IAoIrB;;;;;;;OAOG;IACH,UAAU,IAAI,IAAI;IA+QlB;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAwDzB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI;IAuChC;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI;IAe1C,qFAAqF;IACrF,MAAM,IAAI,OAAO;IAIjB,KAAK,IAAI,IAAI;IA0Db,OAAO,IAAI,IAAI;CAahB"}

package/types/ui/GiftUnwrap.d.ts

@@ -47,6 +47,23 @@
  * 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.
  *
+ * ## Share designs (backend#659)
+ *
+ * `shareFromHeader` and `shareForLater` derive from the same `threeLightSteps` file this
+ * surface renders, so they are this surface plus a `share` design, not new surfaces:
+ *
+ *   - `'header'`: a share control at the top right of screen 1, sharing the selection.
+ *     `Encore` moves the × to the top left. A share leaves the user on the sheet.
+ *   - `'forLater'`: the "Keep your gift for later" panel, a second `GiftSheet` over a
+ *     scrim with the first {@link KEEP_PANEL_LIMIT} gifts and a "Share {gift}" CTA.
+ *     `Encore` opens it from the ×, Escape and the backdrop; its own close (and Escape
+ *     inside it) is the presentation's real close; the scrim returns to the sheet.
+ *
+ * Both emit `offerShare` (subscribe with `onShareEvent`) for the SELECTED offer, synchronously inside the click. The
+ * surface shares nothing itself: the link, the events and what a completed share does
+ * are `Encore`'s. The panel's cards report no impressions (the variant's
+ * `impressionProbe: none`); the rows already did.
+ *
  * ## The reveal (see giftUnwrapStyles in styles.ts)
  *
  * Four elements, four tracks, one 1752ms timeline with the design's keyframe stops on
@@ -58,6 +75,19 @@ import type { OfferModel as Offer } from '../api/models';
 import { type ButtonSlot } from './appearance';
 import type { RewardSurface, RewardSurfaceEventMap } from './rewardSurface';
 import { ImpressionGate } from './impressionGate';
+/**
+ * The shared surface events plus the two only the share designs emit. Kept off
+ * `RewardSurfaceEventMap`, which the carousel implements too.
+ */
+export type GiftUnwrapEventMap = RewardSurfaceEventMap & {
+    /** Share this offer's link. Emitted synchronously inside the click. */
+    offerShare: {
+        offer: Offer;
+        index: number;
+    };
+    /** The keep-for-later panel's close, which is the presentation's real close. */
+    closeRequest: undefined;
+};
 /** How many gifts screen 1 shows as rows. The rest go behind "Show more gifts". */
 export declare const UNWRAP_ROW_LIMIT = 3;
 /**
@@ -66,6 +96,12 @@ export declare const UNWRAP_ROW_LIMIT = 3;
  */
 export declare const UNWRAP_REVEAL_MS = 1752;
 export type UnwrapScreen = 'pick' | 'ready';
+/** Which "share for later" design this surface carries, if any. See the header. */
+export type ShareDesign = 'header' | 'forLater';
+/** How many gifts the keep-for-later panel lists: the variant's `limit: 5`. */
+export declare const KEEP_PANEL_LIMIT = 5;
+/** How long "Link copied" stays up. `Encore` closes `forLater` after the same wait. */
+export declare const SHARE_NOTICE_MS = 1500;
 /** 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 {
@@ -76,6 +112,11 @@ export interface GiftUnwrapComposeOptions {
      * screen the user is no longer on. A callback because the modal is Encore's.
      */
     setLabelledBy?: (id: string) => void;
+    /**
+     * Called with the screen on every switch. The share designs hide the modal's × on the
+     * ready screen, whose Back takes the corner the × would otherwise share.
+     */
+    onScreenChange?: (screen: UnwrapScreen) => void;
 }
 export interface GiftUnwrapOptions {
     /**
@@ -97,11 +138,18 @@ export interface GiftUnwrapOptions {
      * unarmed gate, which never fires.
      */
     impressions?: ImpressionGate;
+    /** The "share for later" design to add, from the served variant. Absent: none. */
+    share?: ShareDesign;
 }
 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;
+    /**
+     * The share designs' own events, off `on()` so its signature stays the one every
+     * `RewardSurface` shares (a union of surfaces must stay callable).
+     */
+    onShareEvent<E extends 'offerShare' | 'closeRequest'>(event: E, handler: (payload: GiftUnwrapEventMap[E]) => void): () => void;
     getTotalOffers(): number;
     getCurrentIndex(): number;
     getSelectedOffer(): Offer | undefined;
@@ -125,6 +173,28 @@ export declare class GiftUnwrap implements RewardSurface {
      * {@link render} and the action block.
      */
     compose(pickScreen: HTMLElement, options?: GiftUnwrapComposeOptions): HTMLElement;
+    /**
+     * Open the keep-for-later panel with the selection picked, so its CTA can share at
+     * once. Focus returns to `opener` when the scrim closes it.
+     *
+     * Returns false, opening nothing, on a surface without one, once the surface has left
+     * the page (a deferred claim swaps in the primer), and on the ready screen. That last
+     * one matters: the panel commits a SELECTION, and the ready screen is filled once on
+     * entry, so a pick made over it would leave the screen naming one gift while its CTA
+     * claims another. The variant's panel is only reachable from the list, too.
+     */
+    openKeepForLater(opener?: HTMLElement): boolean;
+    isKeepForLaterOpen(): boolean;
+    /**
+     * Freeze the panel while a completed share waits to close the presentation, so a
+     * second gift cannot be picked or shared in that window. Its close still works.
+     */
+    lockKeepForLater(): void;
+    /**
+     * Say `text` in the surface's status line, then clear it after {@link SHARE_NOTICE_MS}.
+     * A live region, so a screen reader announces it too.
+     */
+    showShareNotice(text: string): void;
     /**
      * 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

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

@@ -1 +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"}
+{"version":3,"file":"GiftUnwrap.d.ts","sourceRoot":"","sources":["../../src/ui/GiftUnwrap.ts"],"names":[],"mappings":"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"}