@encorekit/web-sdk 2.0.7 → 2.1.1

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

@@ -1 +1 @@
-{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../src/ui/appearance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAgBxC,wFAAwF;AACxF,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,cAAc,EAAE,WAAW,CAAC;CAC7B;AAED,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,qBAAqB,KAC3B,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;AAEpC,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;CAC3D;AAED,qFAAqF;AACrF,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qCAAqC;AACrC,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,WAAW,GAAG,kBAAkB,CAAC;AAEzE,mFAAmF;AACnF,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,WAAW,GAAG,kBAAkB,CAAC;AAwF7E,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAO9E;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CASlF;AAmBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,QAAQ,GAAG,SAAS,GACzB,WAAW,CAoBb;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE/E;AAMD,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACtD;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAoGvE"}
+{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../src/ui/appearance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAgBxC,wFAAwF;AACxF,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,cAAc,EAAE,WAAW,CAAC;CAC7B;AAED,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,qBAAqB,KAC3B,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;AAEpC,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;CAC3D;AAED,qFAAqF;AACrF,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qCAAqC;AACrC,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,WAAW,GAAG,kBAAkB,CAAC;AAEzE,mFAAmF;AACnF,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,WAAW,GAAG,kBAAkB,CAAC;AAwF7E,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAO9E;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CASlF;AAmBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,QAAQ,GAAG,SAAS,GACzB,WAAW,CAoBb;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE/E;AAMD,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACtD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAyKvE"}

package/types/ui/focusable.d.ts

@@ -0,0 +1,41 @@
+/**
+ * What counts as a tab stop, for every focus trap in the SDK.
+ *
+ * There are two traps — `OfferModal`'s, and `GiftSheet`'s for while the sheet is open —
+ * and the sheet's swallows Tab outright (`preventDefault` plus `stopPropagation`), so
+ * the modal never sees the key and the two lists are never reconciled at runtime. A
+ * control the sheet's list omits is therefore not merely visited late, it is
+ * unreachable: the "offer terms" `<a>` `setTermsLink` renders in the sheet's footer was
+ * exactly that. One definition, used by both, is what keeps them from drifting again.
+ */
+/**
+ * `:not([tabindex="-1"])` on EVERY branch, not just the generic one. An element
+ * explicitly removed from the tab order is not a tab stop, and a trap must agree —
+ * otherwise a publisher's custom CTA, which `createActionSlot` neutralizes by setting
+ * `tabindex="-1"` on it and its focusable descendants, would still be matched by
+ * `button:not([disabled])` and Tab would visit the same control twice, the second time
+ * landing on a `pointer-events: none` element that does nothing.
+ */
+export declare const FOCUSABLE_SELECTOR: string;
+/**
+ * The tab stops inside `root`, in document order, minus anything inside a hidden
+ * subtree.
+ *
+ * A composition may mount a panel that is present from the start and only revealed
+ * later (the gift flow's "other gifts" sheet). Its controls are real tab stops the
+ * moment it opens and must not be tab stops while it is closed, and Tab is fully
+ * trapped, so a list that ignored visibility would land Tab on a control the user
+ * cannot see or act on.
+ *
+ * `aria-hidden` as well as `hidden`, because a panel can be removed from the
+ * accessibility tree BEFORE it is removed from layout — the gift sheet marks itself
+ * `aria-hidden` the moment it starts sliding away, and stays in the DOM and
+ * un-`hidden` for the ~300ms that takes. A trap that only understood `hidden` would
+ * hand focus to a control the user is watching leave.
+ *
+ * Nothing here depends on layout — `offsetParent` would be the obvious visibility test
+ * and is uniformly null in a jsdom-like environment, which would empty the trap
+ * entirely.
+ */
+export declare function tabbableWithin(root: ParentNode): HTMLElement[];
+//# sourceMappingURL=focusable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focusable.d.ts","sourceRoot":"","sources":["../../src/ui/focusable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAOnB,CAAC;AAEb;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,CAI9D"}

package/types/ui/giftCategoryGroups.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The gift sheet's tab groups, and the map from the backend's campaign category
+ * taxonomy onto them.
+ *
+ * The backend serves one of 18 taxonomy names per campaign (V167). A tab per name
+ * would put five long tabs on a nine-offer sheet, three of them holding one offer, so
+ * the sheet shows the design's short groups instead. The map is the ONLY place a
+ * taxonomy name is interpreted: a name it does not know (a renamed or newly added
+ * entry) goes to Everyday and is logged once, so a taxonomy change never hides an
+ * offer and never fails silently for a developer with debug logging on.
+ */
+/** The tabs, in the order the sheet shows them. */
+export declare const GIFT_CATEGORY_GROUPS: readonly ["Watch & listen", "Money", "Everyday"];
+export type GiftCategoryGroup = (typeof GIFT_CATEGORY_GROUPS)[number];
+/** Where an absent, blank or unknown category is filed. */
+export declare const DEFAULT_GIFT_CATEGORY_GROUP: GiftCategoryGroup;
+/** Backend taxonomy name → tab. Matched case-insensitively after trimming. */
+export declare const GIFT_CATEGORY_GROUP_BY_TAXONOMY: Readonly<Record<string, GiftCategoryGroup>>;
+/** The tab for a served category. Absent, blank and unknown all file under Everyday. */
+export declare function giftCategoryGroup(category: string | null | undefined): GiftCategoryGroup;
+//# sourceMappingURL=giftCategoryGroups.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"giftCategoryGroups.d.ts","sourceRoot":"","sources":["../../src/ui/giftCategoryGroups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,kDAAmD,CAAC;AAErF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,2DAA2D;AAC3D,eAAO,MAAM,2BAA2B,EAAE,iBAA8B,CAAC;AAEzE,8EAA8E;AAC9E,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAmBvF,CAAC;AAYF,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,CAaxF"}

package/types/ui/giftCopy.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Gift-flow copy derivation — every sentence the gift presentation says, in one place.
+ *
+ * The same discipline as `core/hostDisplay.ts`: the screens never concatenate nouns
+ * themselves, so one sentence has exactly one definition and one test.
+ *
+ * ⚠️ THE DESIGN NAMES BRANDS; THE CONTRACT DOES NOT GUARANTEE THEM. The artifact this
+ * tracks shows "6 months Amazon Prime for FREE" and a CTA reading "Claim 6 months of
+ * Amazon Prime". Those strings are ILLUSTRATIVE. Real rows are built from whatever the
+ * offers endpoint returned, which routinely means an offer with no `perk`, no
+ * `merchantName`, no `logoUrl`, or no `advertiserUrl` at all. Every function below is
+ * total: it takes the offer as it is and returns something a human can read, rather
+ * than parsing a shape the contract never promised.
+ *
+ * In particular NOTHING here tries to extract a duration ("6 months") or a plan name
+ * ("Amazon Prime") out of free text. The perk line is remote, publisher-authored copy
+ * in an unknown language; splitting it on English prepositions would produce confident
+ * nonsense on the first non-English campaign. Where the design wants a short noun
+ * phrase and the data cannot supply one, the copy degrades to a shorter true sentence
+ * instead of a longer invented one.
+ */
+import type { OfferModel as Offer } from '../api/models';
+/**
+ * Copy the gift presentation hard-codes, mirroring `RewardActions`' REWARD_COPY.
+ * Named so tests can assert by symbol rather than by literal.
+ */
+export declare const GIFT_COPY: {
+    /** Row / CTA fallback when the offer carries no usable name at all. */
+    readonly unnamedGift: "your gift";
+    /**
+     * The same fallback for sentences that supply their own possessive.
+     * Separate from {@link unnamedGift} because "and your your gift starts" is what
+     * one shared constant produces.
+     */
+    readonly unnamedGiftBare: "gift";
+    /** The CTA when nothing short enough to name survived. Matches REWARD_COPY.primary. */
+    readonly claimFallback: "Claim gift";
+    /**
+     * THE ARTIFACT'S OWN COPY, and the gift surface's built-in defaults.
+     *
+     * These sit at the BOTTOM of the copy chain, below a per-call override and below
+     * whatever the backend variant resolves — a publisher who has written reward copy
+     * keeps it. What changed is what the SDK says when nobody has said anything, which
+     * used to be the carousel-era `REWARD_FALLBACK_*` strings and is now the design's.
+     */
+    readonly headline: "Here’s a FREE gift for you";
+    readonly subline: "A free present from us. Pick one.";
+    /**
+     * Above the CTA. Replaces REWARD_COPY.trust for this surface.
+     *
+     * ⚠️ ASSERTS A FREE TRIAL, so it is only correct under an offer that IS one — the
+     * same rule, and for the same reason, as `REWARD_COPY.trust`. Its one caller gates
+     * it on `isKnownFreeTrial(offer)`; a discount, an unrecognised badge, and the common
+     * case of no `badgeLabel` at all are NOT known trials and get
+     * `REWARD_COPY.trustUnknown` instead.
+     *
+     * 🔴 NEVER A DEFAULT. Positive knowledge only — the asymmetry `ui/offerBadge.ts`
+     * is built around. An offer whose terms we were not told must not be described as
+     * free, as a trial, or as cancellable, and a constant reached when nothing is known
+     * is exactly how that claim gets made. This used to be the fallback at the foot of
+     * the "Other gifts" sheet, over a LIST that routinely mixes a free trial with a paid
+     * discount (Disney+ at $4.99/mo is live inventory).
+     */
+    readonly finePrint: "FREE trial. You can cancel anytime.";
+    /** The sheet's CTA before anything is picked. The artifact's word, and NOT a claim
+     *  label: "Claim gift" there reads as a live claim for a gift not yet chosen. */
+    readonly sheetContinue: "Continue";
+    /**
+     * Sheet heading. The CONTROL that opens it is worded by `REWARD_COPY.more`, which
+     * lives with the other secondary-button labels; one string, one home.
+     */
+    readonly sheetTitle: "Other gifts";
+    /** Under the CTA. A middot separator, matching the artifact. */
+    readonly terms: "One gift per person · Offer terms";
+    /**
+     * The `giftList` / `giftUnwrap` terms line, in two parts because the second is the
+     * link: "By proceeding you agree to our offer terms". Rendered by `ui/termsLine.ts`,
+     * which supplies the space between them.
+     */
+    readonly termsLead: "By proceeding you agree to our";
+    readonly termsLink: "offer terms";
+    /** The gift radio group's accessible name. Screen-reader copy is still copy. */
+    readonly chooseLabel: "Choose your gift";
+    /** The sheet's close control. */
+    readonly closeSheetLabel: "Close other gifts";
+    /** The sheet's category tab strip, for assistive tech. Only rendered with 2+ tabs. */
+    readonly sheetCategoriesLabel: "Gift categories";
+    /**
+     * `giftList`: the word beside the host app's icon above the headline, so the pair
+     * reads "{icon} Presents". The icon IS the subject; without one the row is omitted.
+     */
+    readonly presents: "Presents";
+    /** `giftList`: the link under the rows that opens the "Other gifts" sheet. */
+    readonly showMore: "Show more gifts";
+};
+/**
+ * The advertiser as a display noun — who the user is about to be handed off to.
+ *
+ * `merchantName` is the intended source but is optional on the model, so the hostname
+ * of the destination is the fallback: an offer that can send a user somewhere can name
+ * that somewhere. `www.` is dropped because "www.audiobooks.com opens next" reads like
+ * a URL, not a brand.
+ *
+ * Returns `undefined` rather than a placeholder: callers phrase a DIFFERENT sentence
+ * when the host cannot be named, instead of one with a hole in it.
+ */
+export declare function giftHost(offer: Offer): string | undefined;
+/**
+ * WHAT the user is getting, as the offer itself describes it.
+ *
+ * The campaign's `perk` line is the field written for exactly this slot ("Enjoy 30
+ * days of Apple Music free"); `description` and `title` are the progressively less
+ * specific fallbacks. Returned verbatim — see this file's header for why it is never
+ * reshaped.
+ */
+export declare function giftWhat(offer: Partial<Pick<Offer, 'perk' | 'description' | 'title'>>): string | undefined;
+/** One row's two text lines. `secondary` is omitted when it would merely repeat. */
+export interface GiftRowText {
+    primary: string;
+    secondary?: string;
+}
+/**
+ * The label for one gift row.
+ *
+ * `primary` is what the gift IS; `secondary` names the brand underneath it, through
+ * `giftHost` (merchant, else the destination hostname, else the title), so every
+ * surface names the advertiser by one ladder. The brand line is dropped when the
+ * primary already contains it, which is the common case — a perk line usually names
+ * its own advertiser, and "1 month of Apple Music" above a second line reading "Apple
+ * Music" is noise, not context.
+ *
+ * Never returns an empty primary: a row the user can select must say something, and an
+ * offer that names nothing at all is still selectable.
+ */
+export declare function giftRowText(offer: Offer): GiftRowText;
+/** One brand-first row's two lines: the advertiser on top, the perk underneath. */
+export interface GiftBrandFirstText {
+    brand: string;
+    perk?: string;
+}
+/**
+ * The lines for a row that leads with the BRAND (`giftList`, `giftUnwrap`), the
+ * design's order for those surfaces. Same ladder as `giftRowText`, the other way up:
+ * the brand is `giftHost`, else what the gift is, else the shipped fallback; the perk
+ * line is dropped when it would only repeat the brand.
+ */
+export declare function giftBrandFirstText(offer: Offer): GiftBrandFirstText;
+/**
+ * The CTA, which NAMES the gift where the data supports naming it.
+ *
+ * The design's whole argument for this button is that "Claim 6 months of Amazon Prime"
+ * converts better than "Claim gift" because the user reads back what they chose. That
+ * argument only holds while the name is short and true, so the ladder degrades twice:
+ *
+ *   1. a short perk line                    → "Claim 1 month of Apple Music"
+ *   2. an advertiser that fits, no short perk → "Claim your Apple Music gift"
+ *   3. neither                               → "Claim gift"
+ *
+ * Rung 2 exists because a long perk is common and a missing brand is not: an offer
+ * whose perk runs to a sentence still knows who it is from, and naming the brand keeps
+ * the button specific without letting it wrap. The brand is `giftHost`, so an offer
+ * with a destination but no merchant name is still named rather than dropping to rung 3.
+ */
+export declare function giftCtaLabel(offer: Offer): string;
+/**
+ * The handoff sentence: what happens after the claim.
+ *
+ * ⚠️ STAGED, NOT YET RENDERED — deliberately, and this is the only thing in this file
+ * nothing calls. The design's post-claim card is not built: `rewardUsers` is
+ * `claimBehavior: 'immediate'`, which opens the advertiser window synchronously inside
+ * the click gesture so it survives mobile popup blockers, and an interstitial means
+ * either a blank tab held open while the user reads or moving the redirect out of that
+ * gesture. That is a money-path change to a frozen behaviour (see `core/claimBehavior`),
+ * so it is a separate decision. The sentence is derived and tested here so that
+ * decision does not also have to relitigate the copy.
+ *
+ * Two shapes, because a sentence about an unnamed destination is worse than a shorter
+ * one. Both avoid promising that anything is already active — the claim creates a
+ * transaction, and the advertiser conversion is asynchronous and only knowable later.
+ */
+export declare function giftHandoffLine(host: string | undefined, what: string | undefined): string;
+/**
+ * The accessible name for a gift row.
+ *
+ * A radio whose visible label is two separate lines is announced as a run-on; naming
+ * it explicitly keeps the brand attached to the perk. Mirrors what
+ * `RewardActions.setSelectedOffer` does for the CTA.
+ */
+export declare function giftRowAccessibleName(offer: Offer): string;
+/**
+ * The accessible name for a BRAND-FIRST row, in the order the row shows its text, so
+ * a voice-control user reading the visible brand off the row is saying the start of
+ * its name (WCAG 2.5.3, label in name).
+ */
+export declare function giftBrandFirstAccessibleName(offer: Offer): string;
+/**
+ * Fill `el` with `text`, wrapping any occurrence of FREE in an accent span.
+ *
+ * TEXT NODES ONLY — the host's copy never goes through `innerHTML`, which is the same
+ * rule `RewardLayout` states for its own title. A publisher headline containing markup
+ * renders as the characters they wrote, not as elements.
+ */
+export declare function fillRowLabel(el: HTMLElement, text: string, spanClass: string): void;
+export declare function fillWithEmphasis(el: HTMLElement, text: string, spanClass: string): void;
+/**
+ * Fill `el` with a `giftList` perk line: the design's "10 meals for FREE" and
+ * "$4.99/month", with FREE or the amount in the accent and the rest muted.
+ *
+ * The FREE rule is `fillRowLabel`'s, unchanged, so the word is treated the same on
+ * every gift surface. Only when the line has no FREE to accent does the FIRST price
+ * amount take the accent instead — one accent per line, which is what the design does
+ * ("$4.99" accented, "/month" not). Text nodes only, like every filler here.
+ */
+export declare function fillPerkLine(el: HTMLElement, text: string, spanClass: string): void;
+//# sourceMappingURL=giftCopy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"giftCopy.d.ts","sourceRoot":"","sources":["../../src/ui/giftCopy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAGzD;;;GAGG;AACH,eAAO,MAAM,SAAS;IACpB,uEAAuE;;IAEvE;;;;OAIG;;IAEH,uFAAuF;;IAEvF;;;;;;;OAOG;;;IASH;;;;;;;;;;;;;;;OAeG;;IAEH;qFACiF;;IAEjF;;;OAGG;;IAEH,gEAAgE;;IAEhE;;;;OAIG;;;IAGH,gFAAgF;;IAEhF,iCAAiC;;IAEjC,sFAAsF;;IAEtF;;;OAGG;;IAEH,8EAA8E;;CAEtE,CAAC;AAeX;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAUzD;AAsBD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAItB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,GAC5D,MAAM,GAAG,SAAS,CAEpB;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAKrD;AAED,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB,CAInE;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAYjD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAO1F;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAGjE;AA4BD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAoBnF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAavF;AAWD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAenF"}

package/types/ui/giftUnwrapArt.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The `giftUnwrap` surface's artwork, as SDK-owned inline SVG.
+ *
+ * The design's box is a 3D raster (Figma "hypothesis 5", 1024px renders). The SDK
+ * ships no raster: an image here would be a network dependency on a decorative
+ * element and several hundred KB, so the box is redrawn as flat vector faces in a
+ * three-quarter view that matches the raster's silhouette, with the tones sampled
+ * off it (body #F7E3A8 → #F7C882, ribbon #F69300, bow #ED6A00 / #E95200; the open
+ * box is the warmer #FFE0A7 / #FFB871 with an #FF9900 ribbon).
+ *
+ * Every string here is static markup built from numbers this module owns, which is
+ * the only thing `innerHTML` is allowed to receive. No offer data reaches it: the
+ * selected offer's logo is an `<img>` element laid BETWEEN the open box's two layers
+ * by `GiftUnwrap`, never markup inside them.
+ *
+ * GRADIENT IDS ARE PER INSTANCE. The closed box is drawn twice (screen 1's hero and
+ * the first frame of screen 2's reveal) and `url(#id)` resolves to the FIRST element
+ * with that id in the document. When that first copy sits inside a `hidden` screen,
+ * Chrome and Safari paint the reference as nothing, so a shared id would draw the
+ * visible box with no fill. `nextArtId()` suffixes every id.
+ *
+ * The three icons (check circle, selected radio, back chevron) are the
+ * design's exported vectors with their path data unchanged; only the Figma layer ids
+ * were dropped, because duplicate `id` attributes are invalid in one document.
+ */
+/**
+ * The closed, wrapped box in a 200×200 frame: body, lid, the ribbon crossing both
+ * faces and the lid, and the bow on top. Symmetric about x=100.
+ */
+export declare function closedBoxSvg(): string;
+/**
+ * The open box, BEHIND the logo tile: the lid lifted and tipped back, and the inside
+ * of the box. Pairs with {@link openBoxFrontSvg}; the tile sits between the two.
+ */
+export declare function openBoxBackSvg(): string;
+/** The open box IN FRONT of the logo tile: the two front walls and their ribbon. */
+export declare function openBoxFrontSvg(): string;
+/**
+ * The soft blue bloom behind the open box: `bg-ellipse-glow-ready.svg`, with its
+ * layer opacity lifted OUT of the markup. The design's 0.5 is the glow track's
+ * resting value, so it lives on the element the reveal animates instead of being
+ * multiplied in twice.
+ */
+export declare function readyGlowSvg(): string;
+/** `icon-check-circle.svg`, 20×20, #17171A. */
+export declare const CHECK_CIRCLE_SVG: string;
+/**
+ * `icon-radio-selected.svg`: the ring and the dot. The unselected state is the same
+ * ring with no dot, drawn by CSS on the same element (see the radio rules in the
+ * unwrap block of styles.ts), so this markup is only ever the selected one.
+ */
+export declare const RADIO_SELECTED_SVG: string;
+/** `icon-back-chevron.svg`, 20×20. */
+export declare const BACK_CHEVRON_SVG: string;
+//# sourceMappingURL=giftUnwrapArt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"giftUnwrapArt.d.ts","sourceRoot":"","sources":["../../src/ui/giftUnwrapArt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAaH;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAyCrC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CA8BvC;AAED,oFAAoF;AACpF,wBAAgB,eAAe,IAAI,MAAM,CAoBxC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAWrC;AAED,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,QAGnB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAIrB,CAAC;AAEX,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,QAGnB,CAAC"}

package/types/ui/giftUnwrapCopy.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Every sentence the `giftUnwrap` surface says that the shared gift copy does not.
+ *
+ * Its own module rather than more keys on `GIFT_COPY`, because these strings belong to
+ * one design (Figma "hypothesis 5") and nothing else renders them. The shared helpers
+ * (`giftHost`, `giftWhat`, `giftCtaLabel`, `fillRowLabel`) are still the source for
+ * anything the other gift surfaces also say, so a brand or a perk line reads the same
+ * on every one of them.
+ *
+ * 🔴 POSITIVE KNOWLEDGE ONLY, the rule `ui/offerBadge.ts` is built around. The "ready"
+ * screen lists what happens next, and the design's example bullets assert a free trial
+ * ("will ask for a card", "nothing is charged before the trial ends"). Those two are
+ * true only for an offer the backend told us is a free trial, so they are gated on
+ * `isKnownFreeTrial`, and every other offer gets a sentence that holds whatever its
+ * terms turn out to be.
+ */
+import type { OfferModel as Offer } from '../api/models';
+export declare const UNWRAP_COPY: {
+    /** The sheet's heading, and the radio group inside it. */
+    readonly sheetTitle: "More gifts";
+    /** The sheet's close control, for keyboard and screen-reader users. */
+    readonly closeSheetLabel: "Close more gifts";
+    /** Screen 1's CTA, and screen 2's when nothing names the advertiser. Screen 1's is
+     *  navigation to the ready screen, never a claim. */
+    readonly continue: "Continue";
+    /** Screen 2's way back to the list, with the selection intact. */
+    readonly back: "Back";
+    readonly readyTitle: "Your gift is ready";
+};
+/**
+ * The line under "Your gift is ready". The design says "our partner’s app"; this names
+ * the destination when the offer does, and on the web the destination is the
+ * advertiser's site rather than an app. With nothing to name, the sentence is
+ * rephrased around the gap instead of carrying a stand-in noun. U+2019 throughout,
+ * matching `GIFT_COPY.headline`.
+ */
+export declare function unwrapReadySubline(offer: Offer): string;
+/**
+ * Screen 2's CTA: "Continue to {advertiser}", or plain "Continue" when nothing names
+ * the destination. A sentence with a hole in it is worse than a shorter true one.
+ */
+export declare function unwrapClaimLabel(offer: Offer): string;
+/**
+ * The bullets under "Your gift is ready", at most three.
+ *
+ *   1. what the gift is, in the offer's own words (`giftWhat`), whenever it has any
+ *   2. KNOWN free trial: "{advertiser} will ask for a card"
+ *   3. KNOWN free trial: "Cancel anytime, nothing is charged before the {advertiser} trial ends"
+ *   otherwise, in place of 2 and 3: "You'll finish claiming on {advertiser}"
+ *
+ * Nothing here parses a duration or a price out of the perk line (see the header of
+ * `giftCopy.ts`): the first bullet is the perk verbatim, so "Free for 6 months" is
+ * what a campaign that wrote "Free for 6 months" gets, and a campaign in another
+ * language keeps its own words.
+ */
+export declare function unwrapReadyBullets(offer: Offer): string[];
+//# sourceMappingURL=giftUnwrapCopy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"giftUnwrapCopy.d.ts","sourceRoot":"","sources":["../../src/ui/giftUnwrapCopy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAIzD,eAAO,MAAM,WAAW;IACtB,0DAA0D;;IAE1D,uEAAuE;;IAEvE;yDACqD;;IAErD,kEAAkE;;;CAG1D,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAKvD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAGrD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAiBzD"}

package/types/ui/impressionGate.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The one rule for when an offer impression (`offerView` → `sdk_offer_presented`) fires.
+ *
+ * An offer element counts as SHOWN only when all of these hold at the same moment:
+ *   (a) `document.visibilityState === 'visible'`;
+ *   (b) the container presenting it is visible (the modal's show transition has begun,
+ *       reported through `setContainerVisible`, never sniffed from a class);
+ *   (c) at least half of it is on screen, per IntersectionObserver (root null, so
+ *       ancestor clipping — a scroller, a sheet — is honoured). See {@link visibleShare}
+ *       for what "half of it" is measured against;
+ *   (d) it is actually PAINTED — not mid-entrance, not inside a container still fading
+ *       in. An observer reports layout geometry and is blind to `opacity` and
+ *       `visibility`, and every surface here animates in, so this is a separate check;
+ *   (e) the registering surface's own condition, when it has one (the carousel's
+ *       "this is the card the user is on, and the scroll is at rest").
+ * Each key (the offer id) fires at most once for the life of the gate, which is one
+ * presentation. Impressions feed billing, so every failure path under-reports rather
+ * than over-reports, and nothing here throws into the host page.
+ */
+/** The share of an element that must be inside the viewport for it to count as seen. */
+export declare const IMPRESSION_VISIBLE_RATIO = 0.5;
+/**
+ * How much of an element counts as on screen, as a share of the SMALLER of the element
+ * and the viewport.
+ *
+ * For anything that fits on screen this is exactly `intersectionRatio`. For anything
+ * larger, "half the element" is a bar it cannot clear — a 2200px card on an 844px
+ * viewport tops out at 38% — so the bar becomes "it covers half the screen" instead.
+ * Both readings answer the same question; the lesser one is the reachable one.
+ */
+export declare function visibleShare(entry: IntersectionObserverEntry): number;
+export interface ImpressionRegistrationOptions {
+    /** A surface-owned condition, re-read on every evaluation and after `recheck()`. */
+    eligible?: () => boolean;
+}
+export declare class ImpressionGate {
+    #private;
+    constructor(options?: {
+        threshold?: number;
+    });
+    /**
+     * Watch `element` and call `onShown` once it is shown. A key that has already fired
+     * is not watched again. Returns the disposer for this one registration.
+     */
+    register(element: Element, key: string, onShown: () => void, options?: ImpressionRegistrationOptions): () => void;
+    /** The presenting container became visible (true) or started hiding (false). */
+    setContainerVisible(visible: boolean): void;
+    /** Re-evaluate every pending registration against the latest known state. */
+    recheck(): void;
+    hasShown(key: string): boolean;
+    destroy(): void;
+}
+/**
+ * A set of registrations a surface replaces together (its rows, the sheet's cards).
+ * `clear()` drops the watches without forgetting what has already been shown.
+ */
+export declare class ImpressionGroup {
+    #private;
+    constructor(gate: ImpressionGate);
+    register(element: Element, key: string, onShown: () => void, options?: ImpressionRegistrationOptions): void;
+    clear(): void;
+}
+//# sourceMappingURL=impressionGate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"impressionGate.d.ts","sourceRoot":"","sources":["../../src/ui/impressionGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,wFAAwF;AACxF,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAuB5C;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAWrE;AAED,MAAM,WAAW,6BAA6B;IAC5C,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;CAC1B;AASD,qBAAa,cAAc;;gBAgBb,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAIhD;;;OAGG;IACH,QAAQ,CACN,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,IAAI,EACnB,OAAO,GAAE,6BAAkC,GAC1C,MAAM,IAAI;IAwBb,gFAAgF;IAChF,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAM3C,6EAA6E;IAC7E,OAAO,IAAI,IAAI;IAKf,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI9B,OAAO,IAAI,IAAI;CAmNhB;AAED;;;GAGG;AACH,qBAAa,eAAe;;gBAId,IAAI,EAAE,cAAc;IAIhC,QAAQ,CACN,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,IAAI,EACnB,OAAO,CAAC,EAAE,6BAA6B,GACtC,IAAI;IAIP,KAAK,IAAI,IAAI;CAKd"}

package/types/ui/offerBadge.d.ts

@@ -0,0 +1,56 @@
+/**
+ * What an offer's promo badge SAYS, and whether that offer is actually a free trial.
+ *
+ * One module for both because they are one question asked twice. The card pill and the
+ * sheet's fine print were each asserting a free trial independently and unconditionally
+ * — `REWARD_CARD_COPY.badge = 'Free trial'` and `'FREE trial. You can cancel anytime.'`
+ * — on inventory where that is not true. Disney+ at $4.99/mo is live right now.
+ *
+ * THE ONLY SIGNAL IS `badgeLabel`, a constrained enum on the campaign
+ * (`'free_trial' | 'discount' | null`). The contract says plainly that clients map it
+ * to display text AND to free-trial-vs-discount logic, so this is that mapping, in one
+ * place, rather than two components each guessing.
+ *
+ * 🔴 ABSENT MEANS "WE DO NOT KNOW", AND MUST NOT READ AS "FREE". That is the whole
+ * point of the default. `null` is by far the common case — measured on the live shelf,
+ * all five current PayRange offers have `badgeLabel: null` — so the default is what
+ * most users will actually see, and it has to be a word that promises nothing:
+ * "Exclusive" says the offer is special without claiming it is free, a trial, or
+ * discounted. Junaid's call, and the reason is exactly that we might not know.
+ *
+ * An unrecognised value lands here too. `APIClient` drops anything outside the enum,
+ * so a future badge this SDK version has never heard of degrades to "Exclusive" rather
+ * than rendering a raw wire string in a pill.
+ */
+import type { OfferModel } from '../api/models';
+/**
+ * The fields this module reads: the badge, and the words shown beside it.
+ *
+ * ALL OPTIONAL, because every one of them is genuinely optional in practice —
+ * `badgeLabel` is null on eleven of twelve live offers and `perk` is null on one — and
+ * because these helpers only ever read them through `firstNonBlank`. A `Pick` of the
+ * required fields would have forced every caller to hold a whole `OfferModel` to ask
+ * what badge to show.
+ */
+type BadgedOffer = Partial<Pick<OfferModel, 'badgeLabel' | 'perk' | 'description' | 'title'>>;
+/**
+ * The badge shown when the campaign carries none, or one this SDK does not recognise.
+ *
+ * Deliberately not free/trial/discount language: it is the honest thing to say about an
+ * offer whose terms we were not told.
+ */
+export declare const DEFAULT_BADGE = "Exclusive";
+/** The pill text for an offer. Never empty — every card gets a badge. */
+export declare function offerBadgeText(offer: BadgedOffer | undefined): string;
+/**
+ * Whether this offer is a KNOWN free trial.
+ *
+ * Positive knowledge only: `discount`, absent and unrecognised are all `false`. This is
+ * what gates any copy that asserts a trial — "no charges until trial ends", "cancel
+ * anytime" — so defaulting it to `true` would put a false claim under an offer that
+ * charges on day one. The asymmetry is the point: we say "free trial" only when the
+ * backend told us so.
+ */
+export declare function isKnownFreeTrial(offer: BadgedOffer | undefined): boolean;
+export {};
+//# sourceMappingURL=offerBadge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"offerBadge.d.ts","sourceRoot":"","sources":["../../src/ui/offerBadge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD;;;;;;;;GAQG;AACH,KAAK,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;AA2C9F;;;;;GAKG;AACH,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CASrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAExE"}

package/types/ui/rewardSurface.d.ts

@@ -0,0 +1,82 @@
+/**
+ * The seam between a presentation's offer SURFACE and the claim flow that drives it.
+ *
+ * `Encore.#runOfferFlow` owns the part that must never fork: creating the transaction,
+ * stamping `use_case` on the funnel events, opening the advertiser window inside the
+ * click gesture, and settling the presentation exactly once. Four surfaces feed it, and
+ * WHICH ONE is not decided by use case alone: `OfferCarousel` serves `reduceChurn` and
+ * every `rewardUsers` publisher whose served variant names no gift surface, while
+ * `GiftReveal`, `GiftList` and `GiftUnwrap` serve `rewardUsers` only when the backend
+ * serves their variant name (`rewardSurfaceKind` in `core/giftVariant.ts`). This
+ * interface is what lets the flow be written once instead of four times.
+ *
+ * 🔴 THE POINT IS THAT THERE IS ONE CLAIM PATH. A surface does not claim; it says
+ * `offerClaim` and the flow does the rest. Adding a surface that redirects, creates a
+ * transaction, or emits its own analytics would reintroduce exactly the split this
+ * seam exists to prevent.
+ *
+ * Not every member is meaningful on every surface, and that is deliberate rather than
+ * sloppy: `scroll` and `complete` describe a carousel and are simply never emitted by
+ * a surface with nothing to scroll and no last card to decline. A subscriber to an
+ * event that never fires costs nothing, where branching on the surface type at each of
+ * a dozen call sites in the claim flow would put a conditional through the money path
+ * for no behavioural gain.
+ */
+import type { OfferModel as Offer } from '../api/models';
+/**
+ * A TYPE ALIAS, not `interface … extends Record<string, unknown>` — and the lint
+ * exception below is the whole reason.
+ *
+ * The `extends` form is what the older event maps in this repo use, and it adds an
+ * INDEX SIGNATURE: `keyof` widens to `string | number | symbol`, so a MISSPELLED name
+ * — `on('oferClaim')`, one `f`, and yes that is deliberate — compiles happily and its
+ * payload degrades to `unknown`. Dropping the `extends` is not
+ * an option either — an interface has no implicit index signature, so it does not
+ * satisfy `EventEmitter`'s `Record<string, unknown>` constraint at all.
+ *
+ * A type alias satisfies that constraint AND keeps `keyof` to the six literal names, so
+ * a typo in an event name stays a compile error. `consistent-type-definitions` has no
+ * way to express that distinction, so it is disabled here specifically.
+ */
+export type RewardSurfaceEventMap = {
+    /** The user asked to claim the given offer. The ONLY entry point to the claim flow. */
+    offerClaim: {
+        offer: Offer;
+        index: number;
+    };
+    /** An impression: this offer was seen. Grain differs per surface — see GiftReveal. */
+    offerView: {
+        offer: Offer;
+        index: number;
+    };
+    /** The selection changed. State, not analytics — it names the CTA. */
+    offerSelect: {
+        offer: Offer;
+        index: number;
+    };
+    /** Carousel only. */
+    offerDecline: {
+        index: number;
+    };
+    /** Carousel only — nothing scrolls on the gift surface. */
+    scroll: {
+        axis: 'horizontal' | 'vertical';
+        position: number;
+    };
+    /** Carousel only — the gift surface has no last card to run out of. */
+    complete: {
+        claimed: boolean;
+    };
+};
+export interface RewardSurface {
+    on<E extends keyof RewardSurfaceEventMap>(event: E, handler: (payload: RewardSurfaceEventMap[E]) => void): () => void;
+    render(): HTMLElement;
+    destroy(): void;
+    /** Claim whatever is currently selected. Emits `offerClaim`; never claims directly. */
+    claimSelected(): void;
+    getTotalOffers(): number;
+    getCurrentIndex(): number;
+    selectOffer(index: number): void;
+    next(): void;
+}
+//# sourceMappingURL=rewardSurface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rewardSurface.d.ts","sourceRoot":"","sources":["../../src/ui/rewardSurface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,qBAAqB,GAAG;IAClC,uFAAuF;IACvF,UAAU,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,sFAAsF;IACtF,SAAS,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,sEAAsE;IACtE,WAAW,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,qBAAqB;IACrB,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,2DAA2D;IAC3D,MAAM,EAAE;QAAE,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,uEAAuE;IACvE,QAAQ,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAChC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,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,CAAC;IACd,MAAM,IAAI,WAAW,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;IAChB,uFAAuF;IACvF,aAAa,IAAI,IAAI,CAAC;IACtB,cAAc,IAAI,MAAM,CAAC;IACzB,eAAe,IAAI,MAAM,CAAC;IAC1B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,IAAI,IAAI,CAAC;CACd"}