@encorekit/web-sdk 2.0.0 → 2.0.1

package/types/types.d.ts

@@ -95,166 +95,75 @@ export interface AppearanceConfig {
     accentColor?: string;
 }
 /**
- * `'thankYou'`-only priming copy shown ABOVE the offers — the lead-in pair between
- * the payment status and the carousel, context for why offers are being shown (never
- * any one offer's own copy). Ignored by the `'list'` layout, whose top heading is
- * `header` instead: one name means one thing in every layout.
- */
-export interface OfferContextConfig {
-    title?: string;
-    /**
-     * Context subtitle. When the active offer's campaign carries a `perk` line (e.g.
-     * "Enjoy 30 days of Apple Music free") the perk takes this slot and follows the
-     * carousel as it pages; this value is the per-placement fallback.
-     */
-    subtitle?: string;
-}
-/**
- * Layout template for a placement presentation.
- * - `'list'` (default): today's offer sheet — header copy + offer carousel.
- * - `'thankYou'`: post-purchase success composition — status check + payment-status
- *   header + intro copy + carousel + optional trust footer.
- */
-export type PlacementLayout = 'list' | 'thankYou';
-/**
- * WHY a placement presents — Encore's platform-wide use-case dimension, distinct from
- * `PlacementLayout` (which composes this SDK's own UI) and from the publisher's free-text
- * placement id. Byte-identical across every Encore SDK — see `contracts/publisher-sdk.json`.
+ * WHY a placement presents — Encore's platform-wide use-case dimension, and the ONLY
+ * thing that selects a composition. It is distinct from the publisher's free-text
+ * placement id.
  *
- * Renamed in backend `V107__Use_Case_Value_Driven_Identifiers.sql` (PR #418, merged
- * 2026-08-11, already deployed): `paywall` → `churn-intervention`, `reward` →
- * `post-action-reward`. `paywall`/`reward` no longer exist in the Postgres enum at
- * all — a client sending either is rejected. There is no dual-accept window; the
- * backend went straight from old to new because the SDK had never shipped.
+ * - `'reduceChurn'` (default): the offer carousel — a save attempt at a moment the
+ *   user is leaving.
+ * - `'rewardUsers'`: celebrates a user moment (a purchase, a milestone, a streak) —
+ *   claim-only, no in-app-purchase ask anywhere in it. Renders the reward
+ *   composition: its own headline chrome around a paged carousel.
  *
- * - `'churn-intervention'` (default): today's offer sheet. Byte-identical behavior to
- *   before this dimension existed.
- * - `'post-action-reward'`: celebrates a user moment (a purchase, a milestone, a
- *   streak) — claim-only, no in-app-purchase ask anywhere in it. Rendered here via a
- *   bundled UI variant (this SDK has no server-driven-UI renderer, unlike iOS/Android).
+ * These symbols match the native SDKs verbatim — iOS `.reduceChurn`/`.rewardUsers`,
+ * Android `REDUCE_CHURN`/`REWARD_USERS` — so a cross-platform integration reads one
+ * vocabulary.
  *
- * Requesting a surface the app is not enabled for (or that has no eligible variant) is not
- * an error: it resolves as a no-op (`ShowResult: 'unavailable'`,
- * `sdk_offer_presentation_failed` reason `'no_template'`) and NEVER falls back to another
- * use case's cached copy — see `core/useCase.ts` for the value-level allow-list this is
- * paired with.
- */
-export type UseCase = 'churn-intervention' | 'post-action-reward';
-/**
- * The sheet's top heading block — in EVERY layout. In `'list'` it is the modal
- * title/subtitle above the offers (local override of the remote copy); in
- * `'thankYou'` it is the payment-status block (check + title + subtitle). The host
- * supplies the copy — the SDK never invents payment facts.
+ * 🔴 THE WIRE VALUES ARE DIFFERENT STRINGS AND ARE FROZEN. `/config`, `/transactions`
+ * and the `use_case` analytics property still carry `churn-intervention` /
+ * `post-action-reward`; `core/useCase.ts` is the only place the two meet. You never
+ * type a wire value — passing one is rejected as an unrecognised use case.
+ *
+ * Requesting a surface the app is not enabled for (or that has no resolved copy) is
+ * not an error: it resolves as a no-op (`ShowResult: 'unavailable'`,
+ * `sdk_offer_presentation_failed` reason `'no_template'`) and NEVER falls back to
+ * another use case's cached copy — see `core/useCase.ts` for the value-level
+ * allow-list this is paired with.
  */
-export interface PlacementHeaderConfig {
-    /**
-     * Status icon (`'thankYou'` only). `'success'` (default) renders a green-circle
-     * check; `'none'` hides it. Ignored by `'list'`.
-     */
-    icon?: 'success' | 'none';
-    /**
-     * Heading title. In `'list'` the sheet title (falls back to remote copy when
-     * omitted); in `'thankYou'` the status title, e.g. "Payment Successful"
-     * (omitted → not rendered).
-     */
-    title?: string;
-    /**
-     * Heading subtitle (a plain constant string). In `'list'` the sheet subtitle; in
-     * `'thankYou'` the muted status line, where a `receipt` passed to `show()` takes
-     * precedence over this slot.
-     */
-    subtitle?: string;
-}
-/** Trust footer for the `'thankYou'` layout. Omitted → not rendered. */
-export interface PlacementFooterConfig {
-    /** Small muted centered line, e.g. "🔒 Secured by Acme". */
-    text?: string;
-}
+export type UseCase = 'reduceChurn' | 'rewardUsers';
 /**
- * Host-product display nouns for the deferred flow's SDK-composed copy (the S1
- * header default, the primer screen, the redemption screen). Every field is optional
- * in the TYPE because each resolves through a chain — local value, else remote
- * /config (app name, native entitlement, app icon) — and requiredness is enforced at
- * RUNTIME by the display contract (see core/DisplayResolver.ts). Display only;
- * nothing here gates behavior.
+ * Everything a placement can be configured with. One flat shape: the composition is
+ * DERIVED from {@link useCase}, never selected separately.
  */
-export interface HostDisplay {
-    /** Host product name, e.g. "PlanetVPN". Falls back to the remote app name. */
-    appDisplayName?: string;
+export interface PlacementOptions {
     /**
-     * Display-only trial length, e.g. "1 month" — never parsed. Falls back to the
-     * remote native-entitlement value + unit.
-     */
-    trialPeriod?: string;
-    /** Host logo URL (https). Falls back to the remote app icon when available. */
-    logoUrl?: string;
-}
-/**
- * Options shared by every layout. Layout-specific options extend this — see
- * ListPlacementOptions / ThankYouPlacementOptions; PlacementOptions is their union,
- * discriminated on `layout`.
- */
-export interface BasePlacementOptions {
-    /**
-     * Why this placement presents. Defaults to `'churn-intervention'`, the value
-     * every existing caller already got before this dimension shipped (renamed
-     * from `'paywall'` in backend PR #418 — see {@link UseCase}). Every existing
-     * caller is unaffected.
+     * Why this placement presents, which is also what it renders. Defaults to
+     * `'reduceChurn'` — the offer carousel. See {@link UseCase}.
      */
     useCase?: UseCase;
-    appearance?: AppearanceConfig;
-    /** Top heading block: modal title in `'list'`, payment status in `'thankYou'`. */
-    header?: PlacementHeaderConfig;
-    /** Host display nouns — local override of the remote-config defaults. */
-    display?: HostDisplay;
     /**
-     * Per-placement override of the configure() redemptionMode. Layout and mode are
-     * ORTHOGONAL axes: layout composes the UI; redemptionMode decides whether the
-     * claim redirects now ('immediate') or is decoupled from redemption ('deferred'
-     * — the host calls redeem() after its own conversion). Unusual combinations
-     * (e.g. 'thankYou' + 'deferred') are allowed and warned, not forbidden.
+     * The sheet's headline for THIS presentation — the same slot the native SDKs'
+     * `.headline(...)` fills, and the primary way to supply reward copy.
+     *
+     * A per-call override, and it applies to both use cases: it beats the
+     * backend-resolved copy, which in turn beats the SDK's built-in fallback. Blank or
+     * whitespace-only falls THROUGH to the resolved copy rather than blanking the
+     * sheet — omit the field instead of passing `''`.
      */
-    redemptionMode?: 'deferred' | 'immediate';
-}
-/** The default offer sheet. */
-export interface ListPlacementOptions extends BasePlacementOptions {
-    layout?: 'list';
-}
-/** The post-purchase success composition. */
-export interface ThankYouPlacementOptions extends BasePlacementOptions {
-    layout: 'thankYou';
-    /** Priming pair above the offers. */
-    offerContext?: OfferContextConfig;
-    /** Trust footer. Omitted → not rendered. */
-    footer?: PlacementFooterConfig;
-}
-export type PlacementOptions = ListPlacementOptions | ThankYouPlacementOptions;
-/**
- * Per-transaction receipt details for the `'thankYou'` layout. Rendered by the SDK as
- * "You paid {amount} for {purpose}" (or "You paid {amount}" without a purpose) in the
- * payment-status subtitle slot. Values are rendered verbatim as text — pre-format the
- * currency on your side.
- */
-export interface Receipt {
-    /** Pre-formatted amount, e.g. "NGN 100". */
-    amount: string;
-    /** What was paid for, e.g. "Demo". */
-    purpose?: string;
-}
-/**
- * Per-call options for show().
- */
-export interface ShowOptions {
+    headline?: string;
+    /** Counterpart to {@link headline}: same precedence, same blank-falls-through rule. */
+    subheadline?: string;
     /**
-     * Per-transaction receipt for the `'thankYou'` layout. When provided it owns the
-     * payment-status subtitle (overriding `header.subtitle`). Ignored by `'list'`.
+     * Status icon above the headline. Defaults to `'none'` — nothing renders unless
+     * you explicitly ask for `'success'`, which draws a green-circle check.
+     *
+     * Only the `'rewardUsers'` composition has a status block to put it in;
+     * `'reduceChurn'` renders the carousel bare and ignores this.
+     *
+     * The default is `'none'` deliberately, and it MATCHES THE NATIVE SDKS: the
+     * reward variant (`streaksCarousel.json`, the same screen iOS and Android render)
+     * contains no checkmark at all — it opens with layered gradients and a confetti
+     * burst. A green success check is a payment-status icon; a reward sheet has not
+     * finished anything yet, it is still asking the user to choose a gift. Opting in
+     * is supported for the rare integration that wants one.
      */
-    receipt?: Receipt;
+    statusIcon?: 'success' | 'none';
+    appearance?: AppearanceConfig;
 }
 /**
- * Presentation callbacks and show-time options
+ * Presentation callbacks for the bare `Encore.show()` form.
  */
-export interface PresentationOptions extends ShowOptions {
+export interface PresentationOptions {
     /**
      * Fires when the user completes the offer flow (provisional grant). The argument is the
      * deprecated, display-derived entitlement and may be `undefined`.
@@ -270,28 +179,20 @@ export interface PresentationOptions extends ShowOptions {
  */
 export interface PlacementBuilder {
     /**
-     * Set this placement's use case (default `'churn-intervention'`) — the same
+     * Set this placement's use case (default `'reduceChurn'`) — the same
      * `.useCase(...)` step the native SDKs expose. See {@link UseCase}.
      */
     useCase(useCase: UseCase): PlacementBuilder;
-    /**
-     * Set the sheet's headline for this presentation — the same `.headline(...)` the
-     * native SDKs expose, and the primary way to supply reward copy.
-     *
-     * A per-call override: it beats the backend-resolved copy, and applies to both
-     * use cases. Blank or whitespace-only falls THROUGH to the resolved copy rather
-     * than blanking the sheet — omit the call instead of passing `''`.
-     */
-    headline(headline: string): PlacementBuilder;
-    /** Counterpart to {@link PlacementBuilder.headline}, same precedence and rules. */
-    subheadline(subheadline: string): PlacementBuilder;
     /** Fires when the sheet closes without a claim — carries the dismissal reason. */
     onNotGranted(callback: (reason: NotGrantedReason) => void): PlacementBuilder;
     onLoadingStateChange(callback: (isLoading: boolean) => void): PlacementBuilder;
-    /** Same bare ShowResult contract as Encore.show(). Never rejects. */
-    show(options?: ShowOptions): Promise<ShowResult>;
-    /** Redeem the transaction made at this placement — phase 2 of the two-phase flow. */
-    redeem(): Promise<RedeemResult>;
+    /**
+     * Present the sheet. Takes no arguments — everything a placement can be
+     * configured with lives in {@link PlacementOptions}, passed to `placement()` or
+     * set through the builder steps above. Same bare ShowResult contract as
+     * `Encore.show()`. Never rejects.
+     */
+    show(): Promise<ShowResult>;
 }
 /**
  * Error codes used throughout the SDK
@@ -353,83 +254,37 @@ export interface EncoreConfig {
     apiKey: string;
     environment?: 'production' | 'development' | 'staging' | 'localhost';
     logLevel?: 'none' | 'debug';
-    /**
-     * Redemption flow:
-     * - 'deferred' (default): show() resolves when the user CLAIMS an offer (a transaction
-     *   record is created, NO redirect). The host runs its own conversion, then calls
-     *   redeem() to render the redemption screen + send the user to the advertiser.
-     * - 'immediate': the legacy one-step flow — claiming an offer redirects to the
-     *   advertiser and shows the success screen inline (no separate redeem() call).
-     * This is a control-flow contract (it changes what host code must call), so it is
-     * a LOCAL config value, not remote.
-     */
-    redemptionMode?: 'deferred' | 'immediate';
-}
-/**
- * Offer descriptor carried on a transaction — enough to render the redemption screen AND
- * to rebuild the advertiser redirect at redeem() time (so the deferred flow never
- * needs the live offer again). `advertiserUrl` may contain a TRANSACTION_ID
- * placeholder, substituted with the transaction id when the redemption fires.
- */
-export interface OfferRef {
-    id: string;
-    campaignId: string;
-    advertiserUrl: string;
-    trackingParameters?: Record<string, string>;
-    advertiserName?: string;
-    /** Display-only reward copy (e.g. "30 days of Apple Music"). NOT an entitlement. */
-    reward?: string;
-    imageUrl?: string;
-    logoUrl?: string;
-}
-/**
- * A claimed offer awaiting redemption. Claiming starts a transaction, and the
- * returned `transactionId` is this transaction's durable handle (the same id used by
- * `didGrant`, `waitForVerification`, and the backend).
- */
-export interface Transaction {
-    id: string;
-    /** The persistent account identity this transaction is bound to (app_account_id). */
-    appAccountId: string;
-    /** The placement the offer was claimed at, if any (keys the local placement->transaction map). */
-    placementId?: string;
-    offer: OfferRef;
-    /**
-     * The layout of the placement the claim happened on — claim provenance (a
-     * transactional fact, like placementId). Drives which redemption narrative
-     * renders: a 'list' claim earns the activation story (host trial + ledger); a
-     * 'thankYou' claim renders the minimal reward story. Absent on legacy
-     * transactions → reward (the safe minimal narrative).
-     */
-    claimLayout?: PlacementLayout;
-    /**
-     * The use case this claim was made under. Omitted for `'churn-intervention'`
-     * (absent means churn-intervention, same convention as everywhere else this
-     * dimension appears) — persisted so `redeem()`, which may run on a later page
-     * load with only this record in hand, can still tell a post-action-reward claim
-     * apart from a churn-intervention one. See {@link UseCase} and
-     * `grantsEntitlementOnClaim` in `core/Encore.ts`.
-     */
-    useCase?: UseCase;
-    status: 'claimed' | 'redeemed';
-    /** ISO-8601 timestamps. */
-    createdAt: string;
-    expiresAt: string;
-    redeemedAt?: string;
 }
 /** Result of `show()` / `present()`. */
 export type ShowResult = 
 /**
- * The user claimed an offer. A transaction was recorded SDK-side, and in
- * 'immediate' mode the advertiser was also opened in a new tab; the SDK
- * renders nothing after a claim — the host owns that moment. Deliberately
- * NOT a conversion claim: advertiser conversion is asynchronous and
- * server-authoritative; check it server-side by user (never from the client).
- * In 'deferred' mode, call redeem() after your own conversion work — the SDK
- * resolves the pending transaction internally; no handle needed.
+ * The user claimed an offer: the advertiser was opened in a new tab. The SDK
+ * renders nothing after a claim — the host owns that moment.
+ *
+ * 🔴 A CLAIM IS NOT A CONVERSION. This reports a presentation fact — the user
+ * tapped Claim and was handed off. Advertiser conversion happens later, is
+ * asynchronous, and is server-authoritative: check it on your backend, never
+ * from the client.
+ *
+ * The payload mirrors iOS's and Android's `ClaimedOffer` field-for-field so the
+ * React Native and Flutter bridges line up:
+ *
+ * - `transactionId` is the claim's durable handle — the id the backend keys on,
+ *   and the argument `didGrant()` and `waitForVerification()` take. It is how a
+ *   completion that lands days later is traced back to this user and app, so
+ *   keep it. It is OPTIONAL because the transaction write can fail while the
+ *   claim itself genuinely happened; the SDK logs a warning when that occurs
+ *   rather than fabricating a placeholder.
+ * - `offerId` / `campaignId` identify what was claimed. (On iOS these are the
+ *   same value; on web they are distinct, and both are reported.)
+ * - `advertiserName` is the merchant's display name.
  */
 {
     status: 'claimed';
+    offerId: string;
+    campaignId: string;
+    advertiserName: string;
+    transactionId?: string;
 }
 /** The user dismissed the carousel without claiming. */
  | {
@@ -440,48 +295,6 @@ export type ShowResult =
  | {
     status: 'unavailable';
 };
-/** Options for `redeem()`. */
-export interface RedeemOptions {
-    /**
-     * Resolve the transaction made at this placement (the local placement->transaction map). When
-     * passed via Encore.placement(id).redeem() this is the placement id. If no transaction
-     * exists for the placement, resolves `none` — it never crosses to another placement.
-     */
-    placement?: string;
-    /**
-     * Host product row for the redemption screen's deal ledger. Override-only: name
-     * and logo default from the same display resolution show() uses (live remote
-     * config), so most integrations never pass this. The trial-end detail line is
-     * always DERIVED (remote durationDays + the redemption moment) — not settable.
-     */
-    host?: {
-        name?: string;
-        status?: string;
-        logoUrl?: string;
-    };
-}
-/** Result of `redeem()`. */
-export type RedeemResult = 
-/** The advertiser redirect was performed for the pending transaction. */
-{
-    status: 'redeemed';
-}
-/**
- * The sheet closed without redeeming. `reason` mirrors show(): user-driven
- * closes carry no reason or a user reason; internal failures carry
- * `{ type: 'error', error }` — redeem() never rejects. On an error the pending
- * transaction is untouched, so calling redeem() again later is safe.
- */
- | {
-    status: 'dismissed';
-    reason?: NotGrantedReason;
-} | {
-    status: 'expired';
-}
-/** STRICTLY "no pending transaction to redeem" — never an error disguise. */
- | {
-    status: 'none';
-};
 /**
  * A subscription/conversion event forwarded from the host (Tier-1 client signal).
  * NON-AUTHORITATIVE — posted via the pk-authed analytics channel, never the HMAC

package/types/types.d.ts.map

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

package/types/ui/OfferCarousel.d.ts

@@ -18,11 +18,33 @@ export interface OfferCarouselOptions {
      * carry paywall-flavored copy (a titleText/customHeadline default, or the hardcoded
      * "Unlock 10 free articles…" fallback when neither is configured) or the thankYou
      * layout's offerContext priming pair — reward has neither: its own headline already
-     * renders in the ThankYouLayout chrome above this carousel, and the modal's
+     * renders in the reward chrome above this carousel, and the modal's
      * accessible name is already pointed at THAT title (see THANKYOU_TITLE_ID), so
      * hiding this header is a11y-safe, not just visually tidier.
      */
     hideHeader?: boolean;
+    /**
+     * SELECTION MODE (reward composition). Turns the carousel from "N self-contained
+     * offer tiles, each with its own Claim" into "a list you pick ONE offer from",
+     * matching `streaksCarousel.json`'s `autoSelectFirstOffer` + `selectOffer` model
+     * that iOS and Android already render. Three things change:
+     *
+     *   - Cards lose their per-card Claim button (see OfferCardOptions.selectable) and
+     *     become selection targets. The host drives the claim via `claimSelected()`.
+     *   - The prev/next chevrons are replaced by a compact dot page indicator, the
+     *     variant's `compactPageIndicator`.
+     *   - The cards container becomes a real `role="listbox"`.
+     *
+     * SELECTION HAS EXACTLY ONE SOURCE: `#currentIndex`. Paging IS selecting and
+     * selecting IS paging — the centered card is the selected card, always. This is
+     * deliberate: iOS shipped a version where the CTA's offer and the carousel's
+     * position were two independent pieces of state, they diverged, and `claimOffer`
+     * silently dropped a nil offer (EncoreKit/swift#106). One index cannot diverge
+     * from itself.
+     *
+     * Off by default, so the churn-intervention and thankYou carousels are untouched.
+     */
+    selectable?: boolean;
 }
 interface CarouselEventMap extends Record<string, unknown> {
     offerClaim: {
@@ -51,6 +73,16 @@ interface CarouselEventMap extends Record<string, unknown> {
     complete: {
         claimed: boolean;
     };
+    /**
+     * The selected offer changed (selection mode only). A STATE notification, not an
+     * analytics event — it exists so the sheet's single CTA can name what it will
+     * claim. It fires once at mount for the auto-selected first offer, which is what
+     * makes the CTA correct before the user touches anything.
+     */
+    offerSelect: {
+        offer: Offer;
+        index: number;
+    };
 }
 export declare class OfferCarousel {
     #private;
@@ -77,6 +109,32 @@ export declare class OfferCarousel {
      * scroll as an effect. The highlight is not touched — it follows the motion.
      */
     next(): void;
+    /**
+     * The offer the sheet's single CTA acts on. In selection mode this is the
+     * centered/selected card; elsewhere it is simply the current one. Never
+     * undefined for a rendered carousel (the constructor rejects an empty list),
+     * but typed honestly so callers cannot assume.
+     */
+    getSelectedOffer(): Offer | undefined;
+    /**
+     * Claim the SELECTED offer — the reward sheet's one bottom CTA (the variant's
+     * `claimOffer` action).
+     *
+     * It emits the SAME `offerClaim` event a per-card Claim button emits, on purpose:
+     * every downstream guarantee (transaction creation and its `transactionId`, the
+     * `use_case` stamp on claim analytics, the synchronous advertiser-window open that
+     * survives mobile popup blockers, the deferred/immediate branch) lives in that one
+     * handler in Encore.ts. Routing the new CTA through it means reward inherits all of
+     * it rather than growing a second, drifting claim path.
+     */
+    claimSelected(): void;
+    /**
+     * Select the offer at `index` — the variant's `selectOffer` action, reached by
+     * tapping a card or by arrowing within the listbox. A user INTENT, so it follows
+     * exactly the same path as next()/previous(): commit domain state, render the
+     * semantic view, then run the scroll as an effect.
+     */
+    selectOffer(index: number): void;
     /**
      * Navigate to previous offer — see next().
      */

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;AAMhD,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAC9B;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,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;CAChC;AAED,qBAAa,aAAa;;gBAsDZ,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAevF;;OAEG;IACH,MAAM,IAAI,WAAW;IA8MrB;;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;;OAEG;IACH,QAAQ,IAAI,IAAI;IAsZhB;;OAEG;IACH,OAAO,IAAI,IAAI;CAqBhB"}
+{"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,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;CACtB;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;;gBAkEZ,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAiBvF;;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;IAqnBhB;;OAEG;IACH,OAAO,IAAI,IAAI;CA2BhB"}

package/types/ui/RewardActions.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Reward action block — the bottom of the post-action-reward sheet.
+ *
+ * Trust line, then a two-button CTA stack: ONE primary that claims the SELECTED
+ * offer, and a secondary that dismisses. This is the interaction model
+ * `streaksCarousel.json` describes and that iOS and Android already render; web
+ * previously put a Claim button on every card and offered no explicit decline.
+ *
+ * NOT a renderer. Every value below is read off the variant and hard-coded here —
+ * web has no SDUI engine, and the variant JSON is a design spec this file tracks by
+ * hand, never something the SDK parses:
+ *
+ *   trust line   14 / regular, onBackground @ 0.55, 2-line clamp
+ *   primary      "Claim gift", 16 / bold, onAccent on accent, radius 12, 16px y-padding
+ *   secondary    "No thanks",  16 / medium, muted, 1px border, radius 12, 14px y-padding
+ *   stack        vStack spacing 8, inside a group of spacing 12, 20px gutters
+ *
+ * Callbacks rather than an EventEmitter: there are exactly two, both fire at most
+ * once per sheet, and neither has a second subscriber. The emitter would be
+ * ceremony around a pair of function calls.
+ */
+/** Copy the variant hard-codes. Named so the tests can assert parity by symbol. */
+export declare const REWARD_COPY: {
+    readonly trust: "No charges until trial ends, cancel anytime.";
+    readonly primary: "Claim gift";
+    readonly secondary: "No thanks";
+};
+export interface RewardActionsOptions {
+    /** Claim the selected offer (the variant's `claimOffer` action). */
+    onClaim: () => void;
+    /** Dismiss the sheet (the variant's `close` action). */
+    onDecline: () => void;
+    /**
+     * 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;
+}
+export declare class RewardActions {
+    #private;
+    constructor(options: RewardActionsOptions);
+    render(): HTMLElement;
+    /**
+     * Name the offer the CTA will claim.
+     *
+     * "Claim gift" alone is ambiguous the moment there is more than one card on
+     * screen and no per-card button left to disambiguate — a screen-reader user
+     * arrowing the listbox has no way to tell what the single bottom button now acts
+     * on. The visible label stays exactly "Claim gift" (the variant's copy, and what
+     * a sighted user reads), and the accessible name EXTENDS it rather than replacing
+     * it, which is what WCAG 2.5.3 Label in Name requires.
+     *
+     * Falls back to removing the label entirely — never to a half-built sentence —
+     * when the offer has no advertiser name, so the button is announced by its text.
+     */
+    setSelectedOffer(advertiserName?: string): void;
+    destroy(): void;
+}
+//# sourceMappingURL=RewardActions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RewardActions.d.ts","sourceRoot":"","sources":["../../src/ui/RewardActions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,mFAAmF;AACnF,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wDAAwD;IACxD,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;;gBAaZ,OAAO,EAAE,oBAAoB;IAIzC,MAAM,IAAI,WAAW;IAmCrB;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAe/C,OAAO,IAAI,IAAI;CAKhB"}