@encorekit/web-sdk 2.3.0 → 2.4.0

package/types/core/claimStatusCheck.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Whether the user's open claims ended, asked of the server
+ * (`GET /transactions/{id}/status`, the stored status: never `verify`, which would call
+ * the advertiser; the server's poller keeps the stored status current) and written to
+ * the claim log. INTERNAL.
+ *
+ * Callers run it before the reminder draws (a mount, a page visible again, and a
+ * GiftsButton spot's own re-reads at a window's end or midnight) and when a tap re-opens
+ * the sheet for a claim (without waiting: on the web the
+ * sheet must open inside the click, where native waits up to 1.5 s). It asks about the
+ * newest open claims only, each at most once per 5 minutes (jittered; a failed ask
+ * counts), until the claim is past its 720 hour window, one claim at a time. Callers at
+ * the same time share one request per claim, and a 429 stops the round and pauses every
+ * check. The answers' times and the pause are kept in storage, so they hold across page
+ * loads and tabs. The bounds are in
+ * {@link CLAIM_CHECK_BOUNDS}, the same on every platform.
+ */
+import type { ClaimLog } from './claimLog';
+export interface ClaimCheckBounds {
+    /** The newest open claims asked about per check. */
+    maxPerCheck: number;
+    /** How long one claim's answer (or failure) stands before it is asked again. Jittered. */
+    cacheMs: number;
+    /** No check once the claim is this old (its longest reminder window). */
+    windowMs: number;
+    /** Every check pauses this long after a 429. */
+    rateLimitPauseMs: number;
+}
+export declare const CLAIM_CHECK_BOUNDS: Readonly<ClaimCheckBounds>;
+/** The server's status for a transaction (the backend's raw value), or null. Rejects on failure. */
+export type ClaimStatusRead = (transactionId: string) => Promise<string | null | undefined>;
+/**
+ * Where the per-claim answers and the 429 pause are kept across page loads and tabs, so
+ * the 5 minutes and the pause hold for the browser, not one page. StorageManager's slot.
+ */
+export interface ClaimStatusStore {
+    get(): unknown;
+    set(value: unknown): void;
+}
+export declare class ClaimStatusCheck {
+    #private;
+    /** Called whenever a check ends a claim, even one answered after its caller stopped waiting. */
+    onEnded: (() => void) | null;
+    constructor(status: ClaimStatusRead, now?: () => number, jitter?: () => number, bounds?: Readonly<ClaimCheckBounds>, store?: ClaimStatusStore | null);
+    /**
+     * Before the reminder draws: ask about the newest open claims that are due (skipping
+     * the ones `dismissed` names), and finish
+     * the ones that ended. Resolves true when one of them ended (here, or in a request
+     * this check joined). Never rejects.
+     */
+    run(log: ClaimLog, userId: string, dismissed?: (transactionId: string) => boolean): Promise<boolean>;
+    /**
+     * A tap on a reminder for this claim, about to open the sheet: false when the log
+     * already knows it ended. Otherwise true, and the claim is asked about now if it is
+     * due, without waiting: the sheet must open inside the click, so an answer lands
+     * through `onEnded`. Never throws.
+     */
+    beforeTap(transactionId: string, log: ClaimLog, userId: string): boolean;
+    /** Another person: what this page knew about the last one's claims no longer applies. */
+    forget(): void;
+}
+//# sourceMappingURL=claimStatusCheck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claimStatusCheck.d.ts","sourceRoot":"","sources":["../../src/core/claimStatusCheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,gBAAgB,CAKxD,CAAC;AAOH,oGAAoG;AACpG,MAAM,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAQ5F;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,IAAI,OAAO,CAAC;IACf,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAiCD,qBAAa,gBAAgB;;IAa3B,gGAAgG;IAChG,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;gBAGlC,MAAM,EAAE,eAAe,EACvB,GAAG,GAAE,MAAM,MAAyB,EACpC,MAAM,GAAE,MAAM,MAAwC,EACtD,MAAM,GAAE,QAAQ,CAAC,gBAAgB,CAAsB,EACvD,KAAK,GAAE,gBAAgB,GAAG,IAAW;IAoCvC;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA6B1G;;;;;OAKG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAcxE,yFAAyF;IACzF,MAAM,IAAI,IAAI;CAoDf"}

package/types/core/giftVariant.d.ts

@@ -70,4 +70,9 @@ export declare function rewardSurfaceKind(variantName: string | null | undefined
  * callers pass one argument.
  */
 table?: Readonly<Record<string, RewardSurfaceKind>>): RewardSurfaceKind | null;
+/**
+ * The web control arm. The backend serves it with a placeholder tree and says web
+ * draws its default carousel, so control cells carry a real variant id.
+ */
+export declare function isCarouselControlArm(variantName: string | null | undefined): boolean;
 //# sourceMappingURL=giftVariant.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"giftVariant.d.ts","sourceRoot":"","sources":["../../src/core/giftVariant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,eAAe,CAAC;AAEpB;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAU3E,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;AACtC;;;;;;GAMG;AACH,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAwB,GACxE,iBAAiB,GAAG,IAAI,CAO1B"}
+{"version":3,"file":"giftVariant.d.ts","sourceRoot":"","sources":["../../src/core/giftVariant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,eAAe,CAAC;AAEpB;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAU3E,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;AACtC;;;;;;GAMG;AACH,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAwB,GACxE,iBAAiB,GAAG,IAAI,CAO1B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEpF"}

package/types/core/hostDisplay.d.ts

@@ -29,22 +29,29 @@ export interface RemoteHostSource {
     appIconUrl?: string;
     /** `entitlements.native.durationDays` — the trial-end line's only input. */
     trialDurationDays?: number;
+    /**
+     * `entitlements.iap.premiumTierName` — the publisher's own name for its paid
+     * tier, which served variants address as `${premiumTierName}`.
+     */
+    premiumTierName?: string;
 }
 /** Resolve the host nouns. Every field independently optional. */
 export declare function resolveHostDisplay(source: RemoteHostSource): HostDisplay;
 /** The deferred flow's sentences, each with exactly one definition. */
 export declare const displayCopy: {
     readonly primerTitle: (app: string, trial?: string) => string;
-    readonly primerSubtitle: (app: string) => string;
+    readonly primerSubtitle: (app: string, knownTrial?: boolean) => string;
     readonly primerCta: (app: string, trial?: string) => string;
     /** The holding story: the host is unnamed, so the sentence is about the reward. */
     readonly holdingTitle: () => string;
-    readonly holdingSubtitle: (advertiser?: string) => string;
+    readonly holdingSubtitle: (advertiser?: string, knownTrial?: boolean) => string;
     readonly holdingCta: () => string;
     readonly s2Title: (app: string, trial?: string) => string;
     readonly s2Subtitle: (app: string) => string;
     /** Host-row detail composed from the remote durationDays and the redemption moment. */
     readonly s2HostDetail: (trialEnd: Date) => string;
     readonly s2Cta: () => string;
+    /** The line above the redemption CTA; undefined when there is nothing true to say. */
+    readonly redemptionNote: (advertiser: string | undefined, knownTrial: boolean) => string | undefined;
 };
 //# sourceMappingURL=hostDisplay.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hostDisplay.d.ts","sourceRoot":"","sources":["../../src/core/hostDisplay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AA+BD,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CASxE;AAED,uEAAuE;AACvE,eAAO,MAAM,WAAW;gCACH,MAAM,UAAU,MAAM,KAAG,MAAM;mCAE5B,MAAM,KAAG,MAAM;8BAEpB,MAAM,UAAU,MAAM,KAAG,MAAM;IAEhD,mFAAmF;iCACjE,MAAM;4CACO,MAAM,KAAG,MAAM;+BAI9B,MAAM;4BACP,MAAM,UAAU,MAAM,KAAG,MAAM;+BAI5B,MAAM,KAAG,MAAM;IACjC,uFAAuF;sCAC9D,IAAI,KAAG,MAAM;0BAM3B,MAAM;CACT,CAAC"}
+{"version":3,"file":"hostDisplay.d.ts","sourceRoot":"","sources":["../../src/core/hostDisplay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4CD,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CASxE;AAED,uEAAuE;AACvE,eAAO,MAAM,WAAW;gCACH,MAAM,UAAU,MAAM,KAAG,MAAM;mCAW5B,MAAM,2BAAuB,MAAM;8BAMxC,MAAM,UAAU,MAAM,KAAG,MAAM;IAIhD,mFAAmF;iCACjE,MAAM;4CACO,MAAM,2BAAuB,MAAM;+BAgBlD,MAAM;4BACP,MAAM,UAAU,MAAM,KAAG,MAAM;+BAI5B,MAAM,KAAG,MAAM;IAEjC,uFAAuF;sCAC9D,IAAI,KAAG,MAAM;0BAK3B,MAAM;IACjB,sFAAsF;0CACzD,MAAM,GAAG,SAAS,cAAc,OAAO,KAAG,MAAM,GAAG,SAAS;CAYjF,CAAC"}

package/types/core/sduiVariables.d.ts

@@ -0,0 +1,20 @@
+import type { RemoteHostSource } from './hostDisplay';
+/**
+ * The `${token}` variables a served template reads, built as Swift's
+ * `OfferContext.allVariables` builds them. Web has no purchases, so the IAP
+ * variables Swift adds are absent.
+ */
+export interface SduiVariableSources {
+    /** `values.text`. Loosely typed, so a null can reach here. */
+    text: Readonly<Record<string, unknown>> | null | undefined;
+    /** `values.appearance`. */
+    appearance: Readonly<Record<string, unknown>> | null | undefined;
+    host: RemoteHostSource;
+    /** Churn reads `customHeadline`; reward reads `rewardHeadline`. */
+    churn: boolean;
+    /** The placement's own `headline` and `subheadline`, already blank-checked. */
+    headline: string | undefined;
+    subheadline: string | undefined;
+}
+export declare function sduiTemplateVariables(src: SduiVariableSources): Record<string, string>;
+//# sourceMappingURL=sduiVariables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sduiVariables.d.ts","sourceRoot":"","sources":["../../src/core/sduiVariables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3D,2BAA2B;IAC3B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACjE,IAAI,EAAE,gBAAgB,CAAC;IACvB,mEAAmE;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAgBD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsCtF"}

package/types/core/strings.d.ts

@@ -0,0 +1,114 @@
+/**
+ * The ONE strings provider: every sentence the SDK itself says, looked up by a stable
+ * string id, with the shipped English as the fallback.
+ *
+ * WHY THIS SHAPE. SDK-owned copy is served by the backend in a `strings` block on
+ * `/config`, and the English literals stay in code as the last fallback. No per-language dictionary is bundled, so the
+ * bundle stays flat however many languages Encore turns on.
+ *
+ * `/config` serves the block as `ui.values.strings` and `ui.values.plurals`, holding
+ * only the ids the resolved locale has an APPROVED translation for; every other id
+ * keeps its English here. {@link setServedCopy} adopts both maps together with the
+ * locale they were resolved in. Nothing is served for English, so an English session
+ * renders byte-identically to before.
+ *
+ * TEMPLATES use `${name}` placeholders, the token syntax the backend's copy tokens and
+ * its machine-translation token protection already use, so a served string survives
+ * translation with its holes intact. A placeholder with no value is left visible
+ * rather than printed as `undefined`.
+ *
+ * PLURALS are CLDR forms (`zero`, `one`, `two`, `few`, `many`, `other`; only `other`
+ * is required). The category is chosen with `Intl.PluralRules` in the SERVED locale
+ * when the served block supplied the forms, and in English when the fallback is
+ * used: Arabic rules over English forms would pick "few" and land on the wrong one.
+ *
+ * Module state, not instance state, because `Encore` is itself a module singleton
+ * and the UI modules read copy at render time without a handle to it.
+ */
+export type Vars = Record<string, string | number>;
+/** CLDR plural forms. `other` is the only one every language has. */
+export interface PluralForms {
+    zero?: string;
+    one?: string;
+    two?: string;
+    few?: string;
+    many?: string;
+    other: string;
+}
+/**
+ * Adopt a served strings block. TOLERANT by design, because it is remote data: only a
+ * non-blank string or a well-formed plural (with `other`) is kept; anything else
+ * falls through to English for that id alone. Replaces the previous block wholesale,
+ * so a language change never leaves the old language's strings behind.
+ */
+export declare function setServedStrings(...blocks: unknown[]): void;
+/**
+ * Adopt one `/config` answer: the locale it resolved and, when it carries `values`,
+ * that locale's `strings` and `plurals` (one id namespace). The maps live and die with
+ * their locale: an answer with no `values` keeps the maps only while the locale is
+ * unchanged, so strings of one language never sit under another's `lang`.
+ */
+export declare function setServedCopy(tag: unknown, values: {
+    strings?: unknown;
+    plurals?: unknown;
+} | null | undefined): void;
+/** The locale the backend says it served (`/config` `locale`), or undefined. */
+export declare function setServedLocale(tag: unknown): void;
+export declare function servedLocale(): string | undefined;
+/** Forget every served string and the served locale. */
+export declare function resetStrings(): void;
+/** One sentence by id: the served string when there is one, else `fallback`. */
+export declare function str(id: string, fallback: string, vars?: Vars): string;
+/**
+ * A count-dependent sentence. `${count}` is always available to the template.
+ * The served forms are chosen by the served locale's rules, the English fallback by
+ * English rules.
+ */
+export declare function plural(id: string, count: number, fallback: PluralForms, vars?: Vars): string;
+/** A count-dependent string only when the server sent its forms, as Swift's `servedPlural`. */
+export declare function servedPlural(id: string, count: number): string | undefined;
+/**
+ * A sentence whose holes hold ELEMENTS (a link, a styled amount), as DOM nodes in
+ * reading order. The sentence is ONE template (`'By proceeding you agree to our
+ * ${link}'`), so a translation can put the element anywhere in it; splitting it into
+ * a lead and a tail would fix English word order into every language.
+ *
+ * A `${name}` in `nodes` becomes that node (its first occurrence); one in `vars` is
+ * filled as text; any other stays visible, as in {@link str}. A node the template
+ * never places is appended after a space, so a translation that dropped the
+ * placeholder never loses the control. `text` wraps each text run (to style it);
+ * by default runs are plain text nodes. Empty runs are skipped.
+ */
+export declare function fillNodes(template: string, nodes: Record<string, Node>, vars?: Vars, text?: (run: string) => Node): Node[];
+/**
+ * A copy table whose every key reads through {@link str} under `namespace`, so
+ * `GIFT_COPY.headline` is the id `gift.headline` with its English beside it. Keeps
+ * the property-access shape the UI modules and their tests already use.
+ */
+export declare function copyTable<T extends Record<string, string>>(namespace: string, english: T): T;
+/**
+ * Languages written right to left, by language subtag: the same 18 as iOS and Android
+ * (`ServedLayoutDirection` on both), so a served locale mirrors the sheet on every
+ * platform or on none.
+ */
+export declare const RTL_LANGUAGES: ReadonlySet<string>;
+export declare function isRtlLocale(tag: string | undefined): boolean;
+/**
+ * Stamp `lang` and `dir` on an SDK root from the served locale. With no served
+ * locale the attributes are REMOVED, so the host page's own language and direction
+ * apply exactly as before.
+ */
+export declare function applyLocaleAttributes(el: HTMLElement): void;
+/** Whether `el` renders right to left, by the nearest `dir` attribute. */
+export declare function isRtlElement(el: Element | null): boolean;
+/**
+ * A keydown's key in READING order: ArrowLeft and ArrowRight swap inside a
+ * right-to-left subtree, so "ArrowRight means next" holds for every handler without
+ * each one knowing about direction. Every other key passes through.
+ */
+export declare function logicalArrowKey(key: string, el: Element | null): string;
+/** A date in the served locale (the browser's when none was served). */
+export declare function formatDate(date: Date, options: Intl.DateTimeFormatOptions): string;
+/** A number in the served locale (the browser's when none was served). */
+export declare function formatNumber(value: number): string;
+//# sourceMappingURL=strings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../src/core/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAEnD,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAyBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAQ3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAClE,IAAI,CAKN;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,gFAAgF;AAChF,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAGrE;AAUD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAQ5F;AAED,+FAA+F;AAC/F,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAC3B,IAAI,CAAC,EAAE,IAAI,EACX,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAA4C,GAClE,IAAI,EAAE,CAgCR;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAS5F;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAG5C,CAAC;AAEH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAQ3D;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAKvE;AAaD,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAElF;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/types/core/unlockCode.d.ts

@@ -17,7 +17,14 @@ 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.
+ * an offer states a reward value. Only a short money amount is accepted, never free text:
+ * a currency symbol or code before or after a number of up to five digits and optional
+ * cents.
+ *
+ * Returned verbatim unless the server named a locale; then it is written the way that
+ * locale writes money. A symbol the page wrote stays narrow, so "$" stays "$" rather
+ * than "US$"; a currency CODE keeps its currency visible ("CA$", "AU$"), because the
+ * narrow symbol would print CAD and AUD as a bare "$".
  */
 export declare function unlockValueAmount(raw: unknown): string | null;
 /**

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

@@ -1 +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;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAExE"}
+{"version":3,"file":"unlockCode.d.ts","sourceRoot":"","sources":["../../src/core/unlockCode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,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;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAqB7D;AAOD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAExE"}

package/types/core/userKeys.d.ts

@@ -0,0 +1,7 @@
+/** One user's pending grant signals (SignalManager). */
+export declare function signalQueueKey(userId: string): string;
+/** One user's strict-mode claim awaiting verification (StrictUnlockReconciler). */
+export declare function strictPendingKey(userId: string): string;
+/** Whether `key` holds some user's still-owed record: queued grant signals or a strict claim. */
+export declare function isUserPendingKey(key: string): boolean;
+//# sourceMappingURL=userKeys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"userKeys.d.ts","sourceRoot":"","sources":["../../src/core/userKeys.ts"],"names":[],"mappings":"AAKA,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}

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.3.0";
+export declare const SDK_VERSION = "2.4.0";
 //# sourceMappingURL=version.d.ts.map

package/types/experiments/ExposureOutbox.d.ts

@@ -7,6 +7,7 @@
  */
 import { ReliableOutbox } from '../analytics/ReliableOutbox';
 import type { StorageManager } from '../core/StorageManager';
+export declare const EXPOSURE_OUTBOX_KEY = "ncl_exposure_outbox";
 export declare class ExposureOutbox extends ReliableOutbox {
     constructor(apiKey: string, analyticsBaseURL: string, storage: StorageManager);
 }

package/types/experiments/ExposureOutbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExposureOutbox.d.ts","sourceRoot":"","sources":["../../src/experiments/ExposureOutbox.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,qBAAa,cAAe,SAAQ,cAAc;gBACpC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;CAG9E"}
+{"version":3,"file":"ExposureOutbox.d.ts","sourceRoot":"","sources":["../../src/experiments/ExposureOutbox.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,qBAAa,cAAe,SAAQ,cAAc;gBACpC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;CAG9E"}

package/types/preview.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `@encorekit/web-sdk/preview` — 🔴 INTERNAL, for the Encore admin portal only. Not a
+ * public API: no semver promise, and it may change with any release.
+ *
+ * Renders the SDK's REAL churn or reward sheet inline, from what the portal already
+ * has: the `/config` `ui` object (strings and plurals included) and the `/offers/search`
+ * `offers`. It is the live presentation code with its I/O replaced, so the preview is
+ * what users see. Guarantees:
+ *
+ *   - no fetch, XHR or beacon: /config and /offers/search answer from the input;
+ *   - no analytics and no storage write, from import to destroy();
+ *   - claim, decline, share and close do nothing, and nothing navigates;
+ *   - inline in `container` (an element or a shadow root), stylesheet included; nothing
+ *     is added to `document.head` or `document.body`, and no global is created;
+ *   - after destroy(), no window or document listener, timer or node is left behind;
+ *   - no React.
+ *
+ * LIMITS. Served strings are module state, so render one locale per page at a time (an
+ * iframe per locale for side by side). The mobile/desktop layout follows the viewport,
+ * so preview a phone in an iframe that width. Offer images load from their URLs. While
+ * mounted, the churn carousel listens for arrow keys on the document, as it does live.
+ *
+ * TRIGGERS. `renderTriggerPreview` draws one trigger look (a GiftsButton or ClaimReminder
+ * variant file) with sample offers and claims, in a device state, through the live
+ * plug-ins, under the same guarantees. See `triggers/preview.ts`.
+ */
+import type { ConfigResponse, OffersSearchResponse } from './api/contract';
+export { renderTriggerPreview, type TriggerPreviewClaim, type TriggerPreviewHandle, type TriggerPreviewInput, type TriggerPreviewOffer, type TriggerPreviewResult, type TriggerPreviewState, } from './triggers/preview';
+/** What one preview renders. */
+export interface PreviewInput {
+    /** BCP 47 locale the payload was resolved in: drives `lang`/`dir`, Intl and plurals. */
+    locale: string;
+    /**
+     * The `/publisher/sdk/v1/config` response's `ui`: `useCase` (wire value, e.g.
+     * `'churn-intervention'`, `'post-action-reward'`), `variantName` (picks the reward
+     * surface), `template`, and `values` with `text`, `strings` and `plurals`.
+     */
+    ui: NonNullable<ConfigResponse['ui']>;
+    /** The `/offers/search` response's `offers` (campaigns with creatives). */
+    offers: OffersSearchResponse['offers'];
+}
+/** A mounted preview. */
+export interface PreviewHandle {
+    /** Re-render with new input in the same container. */
+    update(input: PreviewInput): void;
+    /** Remove everything the preview added. Safe to call more than once. */
+    destroy(): void;
+}
+/** Mount a preview of the sheet `input` describes in `container`. */
+export declare function renderPreview(container: HTMLElement | ShadowRoot, input: PreviewInput): PreviewHandle;
+//# sourceMappingURL=preview.d.ts.map

package/types/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,EAAE,EAAE,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,2EAA2E;IAC3E,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;CACxC;AAED,yBAAyB;AACzB,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,wEAAwE;IACxE,OAAO,IAAI,IAAI,CAAC;CACjB;AAKD,qEAAqE;AACrE,wBAAgB,aAAa,CAC3B,SAAS,EAAE,WAAW,GAAG,UAAU,EACnC,KAAK,EAAE,YAAY,GAClB,aAAa,CAqEf"}

package/types/react.d.ts

@@ -1,10 +1,62 @@
 import { type ReactNode } from 'react';
-import type { EncoreConfig } from '@encorekit/web-sdk';
+import type { ClaimTarget, EncoreClaimOptions, EncoreClaimState, ClaimReminderOptions, TriggerMountOptions, EncoreConfig, GiftsButtonOptions, ShowResult } from '@encorekit/web-sdk';
 type EncoreProviderProps = {
     children: ReactNode;
 } & EncoreConfig;
 export declare function EncoreProvider({ children, ...config }: EncoreProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useEncore(): import("./core/Encore").EncoreSDK;
+export type EncoreTriggerProps = TriggerMountOptions & {
+    /** The trigger id, such as `'claimReminder'`. */
+    id: string;
+};
+/**
+ * An Encore trigger. Render it inside your `EncoreProvider`, where it should sit.
+ * It takes no space until it has something to show, and renders nothing for an id
+ * this SDK version does not ship.
+ *
+ * Remounts when `id`, `placement`, `useCase`, `autoOpen`, `icon`, an `appearance` field a trigger reads, the prize, an `options` entry or a `values` entry
+ * changes; a new `appearance`, `options` or
+ * `publisherReward` object with the same values does not. A new `alignment` only moves it, and new
+ * `headline`, `subheadline` or `cta` only redraws it, with no request.
+ */
+export declare function EncoreTrigger({ id, ...rest }: EncoreTriggerProps): import("react/jsx-runtime").JSX.Element;
+export type ClaimReminderProps = ClaimReminderOptions;
+/**
+ * The claim reminder card: `<EncoreTrigger id="claimReminder" ... />`. It takes no
+ * space until there is a claim to remind about, and a tap opens the Encore sheet for
+ * `useCase` (default `'rewardUsers'`) at `placement`.
+ */
+export declare function ClaimReminder(props: ClaimReminderProps): import("react/jsx-runtime").JSX.Element;
+export type GiftsButtonProps = GiftsButtonOptions;
+/**
+ * The gifts button: `<EncoreTrigger id="giftsButton" ... />`. A tap opens the Encore
+ * sheet for `useCase` (default `'rewardUsers'`) at `placement`. It takes no space while
+ * that sheet has no offers.
+ */
+export declare function GiftsButton(props: GiftsButtonProps): import("react/jsx-runtime").JSX.Element;
 export { Encore } from '@encorekit/web-sdk';
 export type * from '@encorekit/web-sdk';
+/** What `useEncoreClaim` gives you. */
+export interface UseEncoreClaim {
+    /** What to draw now. */
+    state: EncoreClaimState;
+    /** Put on your view's element: Encore counts its impression and opens the sheet on a click. */
+    ref: (element: HTMLElement | null) => void;
+    /** Open the sheet yourself (a view with its own buttons). */
+    tap: (target?: ClaimTarget) => Promise<ShowResult>;
+    /** Hide the reminder. */
+    dismiss: () => void;
+    /** Report how much of your view is visible (0 to 1), when you do not use `ref`. */
+    setVisible: (fraction: number) => void;
+}
+/**
+ * Your own gifts button or claim reminder, as `Encore.claim()` in React. Draw from
+ * `state`, and put `ref` on the element that should count as seen and open the sheet.
+ * Starts over when `placement`, `useCase`, `autoOpen` or the prize changes; the newest
+ * `onResult` is called without starting over.
+ */
+export declare function useEncoreClaim(options: EncoreClaimOptions & {
+    target?: ClaimTarget;
+    tap?: boolean;
+}): UseEncoreClaim;
 //# sourceMappingURL=react.d.ts.map

package/types/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,YAAY,CAAC;AAIjB,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,mBAAmB,2CAa1E;AAED,wBAAgB,SAAS,sCAExB;AAGD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,mBAAmB,oBAAoB,CAAC"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgF,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAErH,OAAO,KAAK,EAEV,WAAW,EAEX,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EAGpB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACX,MAAM,oBAAoB,CAAC;AAE5B,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,YAAY,CAAC;AAIjB,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,mBAAmB,2CAa1E;AAED,wBAAgB,SAAS,sCAExB;AAED,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IACrD,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AA4KF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,kBAAkB,2CAShE;AAED,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAGtD;AAED,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAElD;AAGD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,mBAAmB,oBAAoB,CAAC;AAIxC,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,+FAA+F;IAC/F,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,6DAA6D;IAC7D,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,yBAAyB;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mFAAmF;IACnF,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,kBAAkB,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACpE,cAAc,CAmGhB"}

package/types/sdui/actions.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Dispatching the 11 actions, and the no-op an unknown one becomes.
+ *
+ * The engine resolves WHAT to do and the host does it. Everything here is a
+ * lookup against the evaluation context; nothing touches the network, the
+ * claim path or the sheet, because those belong to `Encore.ts` and differ
+ * between the surfaces this engine renders on.
+ *
+ * 🔴 ONE RULE WORTH STATING. `openUrl` names an OFFER ATTRIBUTE to read its link
+ * from. When that attribute is absent the action does NOTHING: it must never
+ * fall back to a literal URL, because a terms link pointing at the wrong
+ * advertiser is worse than no link. Swift's `openOfferLink` is a bare `guard let
+ * attribute = action.urlAttribute else { return }`.
+ *
+ * `share` is NOT that shape, and treating it as one gave both served share
+ * variants a dead button. Neither native reads `urlAttribute` for it: Swift
+ * delegates to `handleShare(offer, onSuccessState:)`, which resolves the link
+ * from the offer itself and fires a terminal event even when there is none, and
+ * Android calls `handler.share(offer, onSuccessState)`. `shareFromHeader` and
+ * `shareForLater` author `{"type": "share"}` with no attribute at all.
+ */
+import type { SduiAction } from "./model";
+import type { SduiEvaluationContext } from "./context";
+/** Implemented by the host. Every method is optional so a surface may ignore one. */
+export interface ActionHost {
+    close?(): void;
+    /**
+     * `onSuccessState` is the state the sheet moves to once the claim lands.
+     * Swift holds it as `pendingClaimSuccessState` and transitions on return, so
+     * a host that drops it can never show the post-claim screen. `streaksCarousel`
+     * is at rollout weight 100 and gates its whole success branch on this.
+     */
+    claimOffer?(offerId: string | undefined, onSuccessState: string | undefined): void;
+    openUrl?(url: string): void;
+    setState?(state: string): void;
+    setValue?(key: string, value: string): void;
+    selectOffer?(offerId: string, targetKey: string): void;
+    /**
+     * Move an offer to `index` BEFORE the selection is written.
+     *
+     * Swift promotes first so `selectOffer` resolves `currentIndex` against the
+     * list the user will see rather than the one it is replacing.
+     */
+    promoteOffer?(offerId: string, index: number): void;
+    setOfferIndex?(index: number, targetKey: string): void;
+    /** `onCancelAction` is the state to move to when the purchase is cancelled. */
+    triggerIAP?(onSuccessState: string | undefined, onCancelAction: string | undefined): void;
+    submitLead?(values: Readonly<Record<string, string>>, onSuccessState: string | undefined): void;
+    /**
+     * The HOST resolves the link, from the offer. The engine cannot: the SDK's
+     * offer carries no `shareUrl`, and the natives do not read one off the action.
+     */
+    share?(offerId: string | undefined, onSuccessState: string | undefined): void;
+    /**
+     * Trigger mounts only: open the sheet for this trigger, reporting `target`
+     * (`card`, `arrow` or `button`) on `sdk_trigger_clicked`. A sheet host leaves
+     * it unset, so the action stays the no-op it always was there.
+     */
+    trigger?(target: string): void;
+    /** Trigger mounts only: the host's dismiss (store plus `sdk_trigger_dismissed`). */
+    dismissTrigger?(): void;
+    /** The user says they finished the claimed offer. Only a TAP means this. */
+    reportCompletion?(offerId: string | undefined, onSuccessState: string | undefined): void;
+}
+/**
+ * Only http and https may be navigated to.
+ *
+ * This is the engine's job, not the host's: the engine is the layer that knows
+ * the string came from a served template. Images already go through
+ * `safeImageSrc` and colours through `sanitizeColor`; an action URL had no
+ * guard at all, so `javascript:alert(1)` reached the host verbatim.
+ */
+export declare function safeActionUrl(raw: string | undefined): string | undefined;
+/**
+ * Resolve the link an `openUrl` or `share` should use.
+ *
+ * `urlAttribute` reads the scoped offer and returns undefined when the offer
+ * carries nothing. A literal `url` is used ONLY when no attribute was named.
+ */
+export declare function resolveActionUrl(action: SduiAction, ctx: SduiEvaluationContext): string | undefined;
+/**
+ * The index a `setOfferIndex` moves to, or undefined for a no-op.
+ *
+ * `offerIndex` is absolute and out of range is a no-op. `offerIndexDelta` is
+ * relative to the focused card and clamped into the list.
+ */
+export declare function resolveOfferIndex(action: SduiAction, ctx: SduiEvaluationContext): number | undefined;
+/**
+ * Runs an action. Returns whether the host actually handled it. An error in the
+ * action or the host is logged here, never thrown into the host page's click.
+ */
+export declare function dispatch(action: SduiAction, ctx: SduiEvaluationContext, host: ActionHost): boolean;
+//# sourceMappingURL=actions.d.ts.map

package/types/sdui/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/sdui/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAMvD,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,IAAI,IAAI,CAAC;IACf;;;;;OAKG;IACH,UAAU,CAAC,CACT,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,IAAI,CAAC;IACR,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,WAAW,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD;;;;;OAKG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,+EAA+E;IAC/E,UAAU,CAAC,CACT,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,IAAI,CAAC;IACR,UAAU,CAAC,CACT,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACxC,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,IAAI,CAAC;IACR;;;OAGG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC9E;;;;OAIG;IACH,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oFAAoF;IACpF,cAAc,CAAC,IAAI,IAAI,CAAC;IACxB,4EAA4E;IAC5E,gBAAgB,CAAC,CACf,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,IAAI,CAAC;CACT;AAWD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAazE;AAOD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,qBAAqB,GACzB,MAAM,GAAG,SAAS,CAapB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,qBAAqB,GACzB,MAAM,GAAG,SAAS,CAcpB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,qBAAqB,EAC1B,IAAI,EAAE,UAAU,GACf,OAAO,CAOT"}

package/types/sdui/bindings.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Text and image binding resolution, and `${variable}` substitution.
+ *
+ * The fallbacks here are not decoration. A binding that resolves to nothing
+ * returns `""` for offer copy (the element simply renders empty) but a real
+ * string for the three context bindings, because a sheet with no title reads as
+ * a broken integration rather than as an offer without a perk.
+ */
+import type { SduiCreativeBinding, SduiTextBinding } from "./vocabulary";
+import type { SduiInstructionStep, SduiOfferBindingData, SduiTextDefaults } from "./context";
+export declare const FALLBACK_CTA_TEXT = "Get";
+export declare const FALLBACK_CLAIM_TEXT = "Claim";
+export declare const FALLBACK_TITLE_TEXT = "Get 1 month";
+/** Leading space is deliberate: this is concatenated onto the title. */
+export declare const FALLBACK_ACCENT_TITLE_TEXT = " for free";
+export declare const FALLBACK_SUBTITLE_TEXT = "Claim an exclusive offer and get free access to all features";
+/**
+ * `${variable}` substitution, in two passes.
+ *
+ * 1. `variables`, the immutable session context (remote config, entitlements,
+ *    IAP product data).
+ * 2. `values`, the mutable state dictionary, so a variant can write
+ *    `${selectedAdvertiserName}` in bottom copy and have it follow the tap.
+ *
+ * The second pass is skipped unless a token survives the first, which is the
+ * common case. The guard avoids scanning every value for every string.
+ */
+export declare function resolveTemplate(text: string, variables: Readonly<Record<string, string>>, values?: Readonly<Record<string, string>>): string;
+/**
+ * Resolve a text binding.
+ *
+ * The offer-scoped bindings read `offer`; inside a `forEach` the caller passes
+ * the ROW offer, elsewhere the current one. The context bindings ignore it.
+ */
+export declare function resolveTextBinding(binding: SduiTextBinding, offer: SduiOfferBindingData | undefined, defaults: SduiTextDefaults, category?: string, step?: SduiInstructionStep): string;
+export declare function resolveCreativeUrl(binding: SduiCreativeBinding, offer: SduiOfferBindingData | undefined, step?: SduiInstructionStep): string | undefined;
+/** Inputs to {@link resolveText}, gathered so the signature stays readable. */
+export interface TextResolutionInput {
+    readonly valueKey?: string;
+    readonly textMapKey?: string;
+    readonly textMapValueKey?: string;
+    readonly textBinding?: SduiTextBinding;
+    readonly text?: string;
+}
+/**
+ * Full text resolution for a `text` node. First match wins:
+ *
+ * 1. `valueKey` into `values`, then template-resolved.
+ * 2. `textMapKey` into `textMaps[map][values[textMapValueKey ?? map]]`, then
+ *    template-resolved. A MISS falls through rather than rendering empty.
+ * 3. `textBinding`.
+ * 4. template-resolved static `text`.
+ */
+export declare function resolveText(config: TextResolutionInput, args: {
+    readonly values: Readonly<Record<string, string>>;
+    readonly textMaps: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    readonly variables: Readonly<Record<string, string>>;
+    readonly offer?: SduiOfferBindingData;
+    readonly defaults: SduiTextDefaults;
+    readonly category?: string;
+    readonly step?: SduiInstructionStep;
+}): string;
+//# sourceMappingURL=bindings.d.ts.map

package/types/sdui/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../src/sdui/bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAEnB,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AACvC,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAC3C,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,cAAc,CAAC;AACtD,eAAO,MAAM,sBAAsB,iEAC6B,CAAC;AAIjE;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC3C,MAAM,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC5C,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,oBAAoB,GAAG,SAAS,EACvC,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,mBAAmB,GACzB,MAAM,CAqCR;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,oBAAoB,GAAG,SAAS,EACvC,IAAI,CAAC,EAAE,mBAAmB,GACzB,MAAM,GAAG,SAAS,CAYpB;AAED,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE;IACJ,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CACzB,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CACjD,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;CACrC,GACA,MAAM,CA2BR"}