@encorekit/web-sdk 2.2.1 → 2.4.0

package/types/sdui/scrollMath.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Scroll-driven visual maths, ported from Android's `SduiScrollMath`.
+ *
+ * Swift gets this free from `.scrollTransition(.interactive)`, whose contract is
+ * that `phase` is -1 at the leading edge, 0 at centre and +1 at the trailing
+ * edge, and that magnitude is used so both sides converge to identity at centre.
+ * That contract is the specification; the arithmetic below is Android's way of
+ * meeting it without such a modifier, which is the position web is in too.
+ *
+ * Pure functions on purpose. `phase` and `centreDistance` come from Compose's
+ * scroll state on Android and have to be COMPUTED here from scroll offset and
+ * element geometry, which is the one part that does not port.
+ */
+export interface ScrollTransitionSpec {
+    readonly rotation?: number;
+    readonly scale?: number;
+    readonly opacity?: number;
+    readonly yOffset?: number;
+}
+export declare const scrollTransitionScale: (t: ScrollTransitionSpec, phase: number) => number;
+export declare const scrollTransitionOpacity: (t: ScrollTransitionSpec, phase: number) => number;
+/** Signed, not magnitude: the two sides rotate opposite ways. */
+export declare const scrollTransitionRotation: (t: ScrollTransitionSpec, phase: number) => number;
+export declare const scrollTransitionYOffset: (t: ScrollTransitionSpec, phase: number) => number;
+/** Distance 0 is centred. Values outside 0..1 clamp. */
+export declare function scrollFadeOpacity(distance: number, centeredOpacity?: number, offCenterOpacity?: number): number;
+/**
+ * Phase for an element inside a horizontal scroller: -1 leading, 0 centred,
+ * +1 trailing. This is the input Compose supplies and the DOM does not.
+ */
+export declare function phaseOf(elementCentre: number, viewportCentre: number, halfSpan: number): number;
+//# sourceMappingURL=scrollMath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrollMath.d.ts","sourceRoot":"","sources":["../../src/sdui/scrollMath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAKD,eAAO,MAAM,qBAAqB,GAChC,GAAG,oBAAoB,EACvB,OAAO,MAAM,KACZ,MAAqD,CAAC;AAEzD,eAAO,MAAM,uBAAuB,GAClC,GAAG,oBAAoB,EACvB,OAAO,MAAM,KACZ,MAAuD,CAAC;AAE3D,iEAAiE;AACjE,eAAO,MAAM,wBAAwB,GACnC,GAAG,oBAAoB,EACvB,OAAO,MAAM,KACZ,MAAmC,CAAC;AAEvC,eAAO,MAAM,uBAAuB,GAClC,GAAG,oBAAoB,EACvB,OAAO,MAAM,KACZ,MAA6C,CAAC;AAEjD,wDAAwD;AACxD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,eAAe,SAAI,EACnB,gBAAgB,SAAI,GACnB,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,OAAO,CACrB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR"}

package/types/sdui/style.d.ts

@@ -0,0 +1,99 @@
+/**
+ * The 30 wire style properties, as CSS.
+ *
+ * Three groups, and the split is what makes this layer estimable:
+ *
+ *  - 16 are a direct declaration.
+ *  - 6 need a wrapper or a pseudo-element, so they return an intent for the
+ *    element renderer to honour rather than a property.
+ *  - 8 have no CSS equivalent at all. Four of those are SwiftUI layout
+ *    concepts, and four are scroll-driven. Each is approximated deliberately
+ *    and the approximation is named, because a silent near-miss in layout is
+ *    the hardest kind of parity bug to find later.
+ *
+ * Values arrive raw from the decoder. Anything reaching CSS goes through
+ * `cssSafe`, because a style value is server-supplied.
+ */
+import type { SduiStyle } from "./model";
+import type { SduiNode } from "./model";
+/**
+ * What the style layer cannot express as a declaration, handed back for the
+ * element renderer to build. Keeping these OUT of the CSS map is deliberate:
+ * an overlay is a child element, and pretending otherwise is how it ends up
+ * silently dropped.
+ */
+export interface StructuralIntent {
+    /** A node to absolutely position ON TOP of the element. */
+    readonly overlay?: SduiNode;
+    /** A node to absolutely position BEHIND it. */
+    readonly backgroundElement?: SduiNode;
+    /** Gradient stroke: no CSS property exists, so a pseudo-element draws it. */
+    readonly gradientBorder?: Record<string, unknown>;
+    /** Per-state styles, applied by toggling a class so CSS transitions can run. */
+    readonly stateStyles?: Record<string, unknown>;
+    readonly stateAnimation?: Record<string, unknown>;
+    /** Mark this container's CHILDREN as snap targets, not the container itself. */
+    readonly scrollTargetLayout?: boolean;
+    /** Scroll-driven, so it needs a scroll listener rather than a declaration. */
+    readonly scrollTransition?: Record<string, unknown>;
+    readonly scrollFade?: Record<string, unknown>;
+    /**
+     * A corner radius clips the CONTENT, never the shadow (Swift's
+     * `SDUISurfaceModifier`). Structural so a re-planned bound colour cannot undo
+     * a scroller's own overflow.
+     */
+    readonly clipContent?: boolean;
+}
+export interface StylePlan {
+    /** CSS property to value. Already sanitised. */
+    readonly css: Readonly<Record<string, string>>;
+    readonly structural: StructuralIntent;
+}
+/**
+ * Resolves an SDUI colour operand to a CSS colour string.
+ *
+ * The resolver is the ONLY place a server-supplied string reaches CSS: every
+ * other value here is built by this file out of decoded numbers, so it cannot
+ * carry a `;` or a `}`. Wrap any resolver with {@link safeColorResolver} unless
+ * it already guarantees an allow-listed colour.
+ */
+export type ColorResolver = (raw: unknown, 
+/**
+ * The live values dictionary. A `binding` colour resolves against it at
+ * RENDER time in Swift (`SDUIColor.resolved(in:values:)`), so a resolver with
+ * no access to it can never resolve one. `streaksCarousel` binds
+ * `selectedOfferDominantColor` on its page indicator and its cards.
+ */
+values?: Readonly<Record<string, string>>) => string | undefined;
+/** Wraps a resolver so anything it returns must pass `cssSafe`'s colour grammar. */
+/**
+ * The value keys a colour operand reads, so a renderer can depend on them.
+ *
+ * A `binding` colour resolves at render time, so an element painting one has to
+ * re-run when that key moves. Without this the page indicator and any
+ * bound-fill shape were painted once at mount and never again.
+ */
+export declare function colorBindingKeys(raw: unknown): string[];
+/**
+ * Swift's `SDUIColor.Transforms`: lighten, then darken, then opacity, on ANY
+ * base form. Authored as sibling keys of `hex`/`semantic`/`appearance`/`binding`.
+ *
+ * Wrap a resolver that already sanitizes, not the other way round: the colour
+ * grammar rejects a nested `color-mix` on purpose, and everything composed here
+ * is a number this file clamped, so nothing new can escape the declaration.
+ *
+ * Transforms on a `fallback` are not applied, only those on the outer object. No
+ * served variant authors one, and Swift would apply both.
+ */
+export declare function withColorTransforms(css: string | undefined, raw: unknown): string | undefined;
+export declare const safeColorResolver: (inner: ColorResolver) => ColorResolver;
+/**
+ * Every value key any colour anywhere in a style object binds.
+ *
+ * A style resolves its colours through `planStyle`, which ran ONCE with no
+ * values, so a bound `backgroundColor`, `borderColor`, shadow or gradient-border
+ * stop painted its fallback for ever. `featuredOfferCarousel` binds 31 operands.
+ */
+export declare function styleBindingKeys(style: unknown, depth?: number): string[];
+export declare function planStyle(style: SduiStyle | undefined, color: ColorResolver): StylePlan;
+//# sourceMappingURL=style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../src/sdui/style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAcxC;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,OAAO;AACZ;;;;;GAKG;AACH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KACtC,MAAM,GAAG,SAAS,CAAC;AAExB,oFAAoF;AACpF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAcvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,EAAE,OAAO,GACX,MAAM,GAAG,SAAS,CAYpB;AAQD,eAAO,MAAM,iBAAiB,GAC3B,OAAO,aAAa,KAAG,aAIW,CAAC;AAEtC;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CASpE;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,KAAK,EAAE,aAAa,GACnB,SAAS,CAiNX"}

package/types/sdui/triggerKit.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The engine code only a trigger (inline) mount uses: the `progress` and `marquee`
+ * elements, `style.loop`, ticking countdown text, one-line shrink to fit and text scale groups.
+ *
+ * The engine refers to it by type only. The trigger view (`triggers/host/sduiView.ts`),
+ * which loads with the trigger chunk on first mount, imports it and hands it to
+ * `mountSduiSurface({ mode: "inline", kit })`, so a page that only shows sheets never
+ * downloads any of it.
+ */
+import { registerProgressElement } from "./elements/progress";
+import { registerMarqueeElement } from "./elements/marquee";
+import { MotionSheet, attachLoop } from "./motion";
+import { ScaleGroups, countdownText, oneLineFit } from "./elements/triggerText";
+export declare const TRIGGER_KIT: Readonly<{
+    registerProgressElement: typeof registerProgressElement;
+    registerMarqueeElement: typeof registerMarqueeElement;
+    MotionSheet: typeof MotionSheet;
+    attachLoop: typeof attachLoop;
+    countdownText: typeof countdownText;
+    oneLineFit: typeof oneLineFit;
+    ScaleGroups: typeof ScaleGroups;
+}>;
+export type TriggerKit = typeof TRIGGER_KIT;
+//# sourceMappingURL=triggerKit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triggerKit.d.ts","sourceRoot":"","sources":["../../src/sdui/triggerKit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEhF,eAAO,MAAM,WAAW;;;;;;;;EAQtB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC"}

package/types/sdui/unrunnable.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Actions a template needs that web cannot run, as Swift's `templateReferencesIAP`:
+ * a template that needs a purchase or a lead falls back to the built-in surface.
+ */
+/** The actions no web surface can run. */
+export declare const UNRUNNABLE_ON_WEB: ReadonlySet<string>;
+/** Every action type the raw template names, on a button, a toggle or a state's `onEnter`. */
+export declare function referencedActions(raw: unknown): Set<string>;
+/** The first action the template needs that web cannot run, or undefined. */
+export declare function unrunnableAction(raw: unknown): string | undefined;
+//# sourceMappingURL=unrunnable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unrunnable.d.ts","sourceRoot":"","sources":["../../src/sdui/unrunnable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAGhD,CAAC;AAEH,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAyB3D;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKjE"}

package/types/sdui/vocabulary.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The SDUI wire vocabulary, as the backend actually serves it.
+ *
+ * 🔴 THE CLOSED SETS ARE THE CONTRACT. An unknown enum VALUE fails the whole
+ * config; an unknown FIELD is ignored. That asymmetry is deliberate and is why
+ * these live as frozen arrays rather than TypeScript unions alone: a union is
+ * erased at runtime, and the decoder has to REJECT at runtime, not just fail to
+ * compile. See `decode.ts` for the rule and the reason.
+ *
+ * Every list here was read off `swift` `origin/main` and cross-checked against
+ * `android` `origin/main` on 2026-09-22. The two agree on every value. Swift is
+ * canonical where they ever disagree: it is the reference implementation and the
+ * vocabulary was designed against it.
+ */
+/** 22 element types. The element is a node's single KEY, never a `type` field. */
+export declare const ELEMENTS: readonly ["text", "systemImage", "asyncImage", "asyncVideo", "appIcon", "button", "vStack", "hStack", "zStack", "spacer", "shape", "gradient", "scrollView", "forEach", "conditional", "group", "textField", "toggle", "slideButton", "compactPageIndicator", "confetti", "empty"];
+/** 21 conditions, Swift's full set, diffed name by name. */
+export declare const CONDITIONS: readonly ["hasMultipleOffers", "isCurrentPage", "isCurrentPageBinding", "stateEquals", "valueEquals", "hasValue", "hasIntroOffer", "hasFreeTrial", "isSelectedOffer", "and", "or", "not", "equals", "hasOfferAttribute", "hasOfferProperty", "hasInstructionSubtitle", "hasInstructionImage", "isFirstOffer", "isLastOffer", "isMiddleOffer", "offerIndexEquals"];
+/** Conditions that take nested conditions rather than a leaf operand. */
+export declare const COMBINATORS: readonly ["and", "or", "not"];
+/**
+ * The 11 wire actions. Accepted as a bare string OR an object with `type`.
+ *
+ * Anything else decodes to the `unknown` sentinel and does nothing, so one new
+ * action costs a dead button instead of the whole variant. `unknown` is not in
+ * this list: it is not a wire value, and a literal `"unknown"` lands on the
+ * sentinel by the same route as any other name this build does not know.
+ */
+export declare const ACTIONS: readonly ["close", "claimOffer", "openUrl", "setState", "setValue", "selectOffer", "setOfferIndex", "triggerIAP", "submitLead", "share", "reportCompletion"];
+export declare const OFFER_ATTRIBUTES: readonly ["badgeLabel", "perk", "advertiserName", "description", "category", "shareUrl", "termsUrl", "quickInstructions", "instructions"];
+export declare const DATA_SOURCES: readonly ["offers", "pageIndicators", "categories", "instructions"];
+export declare const TEXT_BINDINGS: readonly ["offerAdvertiserName", "offerDescription", "offerPerk", "offerCtaText", "offerQuickInstructions", "offerNewPrice", "offerOldPrice", "titleText", "accentTitleText", "subtitleText", "categoryName", "instructionTitle", "instructionSubtitle", "instructionCtaText", "instructionNumber"];
+export declare const CREATIVE_BINDINGS: readonly ["offerPrimaryCreative", "offerLogoImage", "offerHeroImage", "instructionImage"];
+/**
+ * The theme tokens a colour may name. Both natives decode this strictly, so an
+ * unknown one fails the whole config rather than painting nothing.
+ */
+export declare const APPEARANCE_COLORS: readonly ["accent", "onAccent", "accentTitle", "background", "onBackground", "surface", "onSurface", "border", "muted", "error"];
+export declare const SEMANTIC_COLORS: readonly ["label", "secondaryLabel", "tertiaryLabel", "systemBackground", "secondarySystemBackground", "systemGroupedBackground", "secondarySystemGroupedBackground", "separator", "tertiarySystemFill"];
+export declare const FONT_WEIGHTS: readonly ["ultraLight", "thin", "light", "regular", "medium", "semibold", "bold", "heavy", "black"];
+export declare const ALIGNMENTS: readonly ["leading", "trailing", "center", "top", "bottom", "topLeading", "topTrailing", "bottomLeading", "bottomTrailing"];
+export declare const SHAPE_TYPES: readonly ["rectangle", "roundedRectangle", "circle", "capsule"];
+export declare const CLIP_SHAPES: readonly ["rectangle", "circle", "capsule"];
+export declare const GRADIENT_DIRECTIONS: readonly ["topToBottom", "bottomToTop", "leadingToTrailing", "trailingToLeading"];
+export declare const ANIMATION_CURVES: readonly ["linear", "easeIn", "easeOut", "easeInOut", "spring"];
+export declare const SCROLL_AXES: readonly ["horizontal", "vertical"];
+export declare const SCROLL_TARGET_BEHAVIORS: readonly ["viewAligned", "paging"];
+export declare const SCROLL_ALIGNMENTS: readonly ["leading", "center"];
+export declare const CONTENT_MODES: readonly ["fit", "fill"];
+export declare const IMPRESSION_SOURCES: readonly ["row", "creative"];
+/** `none` is the wire spelling, NOT `off`. */
+export declare const IMPRESSION_PROBES: readonly ["row", "none"];
+export declare const KEYBOARD_TYPES: readonly ["emailAddress"];
+export declare const TEXT_CONTENT_TYPES: readonly ["emailAddress"];
+/**
+ * The 30 style properties. Kept as a set so the decoder can tell a style key it
+ * does not know (ignored, per the field rule) from one it must still carry.
+ */
+export declare const STYLE_PROPERTIES: readonly ["padding", "frame", "cornerRadius", "cornerRadii", "backgroundColor", "shadow", "innerShadow", "opacity", "clipShape", "clipped", "ignoresSafeArea", "layoutPriority", "containerRelativeFrame", "scrollTargetLayout", "borderWidth", "borderColor", "fixedSize", "offset", "stateStyles", "stateAnimation", "scale", "rotation", "relativeWidth", "relativeHeight", "overlay", "backgroundElement", "gradientBorder", "scrollTransition", "scrollFade", "safeAreaPadding"];
+/**
+ * Vocabulary a TRIGGER mount decodes and a sheet does not (the trigger SDUI
+ * vocabulary contract, v1). Kept apart from the sheet lists so a sheet naming
+ * one keeps failing exactly as before: no existing sheet decodes differently.
+ */
+export declare const TRIGGER_ELEMENTS: readonly ["progress", "marquee"];
+export declare const TRIGGER_CONDITIONS: readonly ["listCountAtLeast"];
+/** The trigger host's two actions; a sheet decodes them as the unknown no-op, as today. */
+export declare const TRIGGER_ACTIONS: readonly ["trigger", "dismissTrigger"];
+export declare const TRIGGER_ACTION_TARGETS: readonly ["card", "arrow", "button"];
+export declare const TRIGGER_DATA_SOURCES: readonly ["hostList"];
+export declare const TRIGGER_APPEARANCE_COLORS: readonly ["inkOnAccent", "secondary", "track", "backgroundEnd"];
+export declare const TRIGGER_SHAPE_TYPES: readonly ["ellipse"];
+export declare const TRIGGER_STYLE_PROPERTIES: readonly ["loop", "layoutDirection", "accessibilityHidden"];
+/** `gradient.type`. Absent is `linear`, the existing `direction` form; `radial` is trigger-only. */
+export declare const GRADIENT_TYPES: readonly ["linear", "radial"];
+export declare const COUNTDOWN_FORMATS: readonly ["clock", "hoursMinutes", "hours", "minutes", "seconds", "largestUnit"];
+/** `style.loop.curve`: the animation curves except `spring`. */
+export declare const LOOP_CURVES: readonly ["linear", "easeIn", "easeOut", "easeInOut"];
+export declare const MARQUEE_AXES: readonly ["horizontal", "vertical"];
+export declare const LAYOUT_DIRECTIONS: readonly ["ltr"];
+export type SduiElementName = (typeof ELEMENTS)[number] | (typeof TRIGGER_ELEMENTS)[number];
+export type SduiConditionName = (typeof CONDITIONS)[number] | (typeof TRIGGER_CONDITIONS)[number];
+export type SduiCombinator = (typeof COMBINATORS)[number];
+/** The wire actions, plus the sentinel a name this build does not know lands on. */
+export type SduiActionType = (typeof ACTIONS)[number] | (typeof TRIGGER_ACTIONS)[number] | "unknown";
+export type SduiOfferAttribute = (typeof OFFER_ATTRIBUTES)[number];
+export type SduiDataSource = (typeof DATA_SOURCES)[number] | (typeof TRIGGER_DATA_SOURCES)[number];
+export type SduiTextBinding = (typeof TEXT_BINDINGS)[number];
+export type SduiCreativeBinding = (typeof CREATIVE_BINDINGS)[number];
+export type SduiSemanticColor = (typeof SEMANTIC_COLORS)[number];
+export type SduiAppearanceColor = (typeof APPEARANCE_COLORS)[number];
+export type SduiFontWeight = (typeof FONT_WEIGHTS)[number];
+export type SduiAlignment = (typeof ALIGNMENTS)[number];
+export type SduiShapeType = (typeof SHAPE_TYPES)[number];
+export type SduiClipShapeType = (typeof CLIP_SHAPES)[number];
+export type SduiGradientDirection = (typeof GRADIENT_DIRECTIONS)[number];
+export type SduiAnimationCurve = (typeof ANIMATION_CURVES)[number];
+export type SduiScrollAxis = (typeof SCROLL_AXES)[number];
+export type SduiScrollTargetBehavior = (typeof SCROLL_TARGET_BEHAVIORS)[number];
+export type SduiScrollAlignment = (typeof SCROLL_ALIGNMENTS)[number];
+export type SduiContentMode = (typeof CONTENT_MODES)[number];
+export type SduiImpressionSource = (typeof IMPRESSION_SOURCES)[number];
+export type SduiImpressionProbe = (typeof IMPRESSION_PROBES)[number];
+export type SduiStyleProperty = (typeof STYLE_PROPERTIES)[number] | (typeof TRIGGER_STYLE_PROPERTIES)[number];
+export declare const ELEMENT_SET: ReadonlySet<string>;
+export declare const CONDITION_SET: ReadonlySet<string>;
+export declare const COMBINATOR_SET: ReadonlySet<string>;
+export declare const ACTION_SET: ReadonlySet<string>;
+export declare const OFFER_ATTRIBUTE_SET: ReadonlySet<string>;
+export declare const DATA_SOURCE_SET: ReadonlySet<string>;
+export declare const TEXT_BINDING_SET: ReadonlySet<string>;
+export declare const CREATIVE_BINDING_SET: ReadonlySet<string>;
+export declare const STYLE_PROPERTY_SET: ReadonlySet<string>;
+export declare const TRIGGER_ELEMENT_SET: ReadonlySet<string>;
+export declare const TRIGGER_CONDITION_SET: ReadonlySet<string>;
+export declare const TRIGGER_ACTION_SET: ReadonlySet<string>;
+export declare const TRIGGER_DATA_SOURCE_SET: ReadonlySet<string>;
+export declare const TRIGGER_STYLE_PROPERTY_SET: ReadonlySet<string>;
+//# sourceMappingURL=vocabulary.d.ts.map

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

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

package/types/triggers/claimReminder/ClaimReminder.d.ts

@@ -0,0 +1,65 @@
+/**
+ * ClaimReminder, trigger plug-in #1: a card that reminds the user of their newest
+ * open claim, and on tap opens the Encore sheet for its use case and placement,
+ * where that offer is still listed. Behaviour is the cross-platform contract
+ * (contract.md, "Trigger behaviour"); the drawing is the served SDUI tree, fed by
+ * bindings.ts (trigger SDUI vocabulary contract §2). Everything every
+ * trigger shares (the config request, events, visibility, dismiss storage, identity
+ * re-runs, the sheet's presentation id) is the host's (triggers/host/TriggerHost.ts).
+ */
+import type { UseCase } from '../../types';
+import type { SheetCheck, TriggerPlugin } from '../host/types';
+import { type ReminderConfig } from './config';
+import type { ClaimReminderSource, ReminderClaim } from './source';
+import { type TriggerSduiModel } from '../host/sduiView';
+export declare const CLAIM_REMINDER_ID: "claimReminder";
+/** What the gate found: the open claims, and the campaigns the sheet holds for the tap. */
+export interface ReminderContent {
+    useCase: UseCase;
+    /** The open claims the sheet still holds; empty when only a completion is left. */
+    claims: ReminderClaim[];
+    campaignIds: ReadonlySet<string>;
+    /**
+     * No claim to remind about, and an offer finished today that was not thanked yet (the
+     * request's `completed` state): its claim's id. Encore answers with the thanks look or
+     * nothing, as the look's behavior says.
+     */
+    completion?: string;
+    /** The reminder window the gate used (the one last served here), in hours. */
+    windowHours?: number;
+}
+/** What one render of the card shows: the served tree and what it binds. */
+export interface ReminderModel extends TriggerSduiModel {
+    useCase: UseCase;
+    placement: string | undefined;
+    /** The thanks look is drawn: a tap opens the sheet and ends it. */
+    thanks?: true;
+}
+export interface ClaimReminderDeps {
+    /**
+     * The claims adapter, read at call time. The SDK's is never null: this browser's claim
+     * log, merged with the claims bank once one is bound. Null renders nothing.
+     */
+    source(): ClaimReminderSource | null;
+    /**
+     * Whether the sheet for `useCase` at `placement` would open with offers, and which
+     * campaigns it holds (the same gate as GiftsButton's). `fresh` skips the held search.
+     */
+    checkSheet(useCase: UseCase, placement: string | undefined, fresh: boolean): Promise<SheetCheck>;
+    /**
+     * A tap about to open the sheet: false when the shown claim is known to have ended
+     * (synchronous: the sheet opens inside the click). Absent: always open.
+     */
+    claimTapped?(transactionId: string): boolean;
+    /**
+     * An offer finished today with none claimed since, not thanked yet: its claim's id
+     * (the `completed` state). Absent or null: none.
+     */
+    thanksFor?(): string | null;
+    /** The thanks look was tapped: it ends for the user's latest completion. */
+    thanksTapped?(): void;
+    /** Device storage for the window last served at each placement. Absent: the 24 hour default. */
+    storage?(): Storage | null;
+}
+export declare function claimReminderPlugin(deps: ClaimReminderDeps): TriggerPlugin<ReminderContent, ReminderConfig, ReminderModel>;
+//# sourceMappingURL=ClaimReminder.d.ts.map

package/types/triggers/claimReminder/ClaimReminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaimReminder.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/ClaimReminder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAqB,MAAM,eAAe,CAAC;AAElF,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAIvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGnE,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,eAAO,MAAM,iBAAiB,iBAA2B,CAAC;AAK1D,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,mEAAmE;IACnE,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,IAAI,mBAAmB,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjG;;;OAGG;IACH,WAAW,CAAC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7C;;;OAGG;IACH,SAAS,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC;IAC5B,4EAA4E;IAC5E,YAAY,CAAC,IAAI,IAAI,CAAC;IACtB,gGAAgG;IAChG,OAAO,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC;CAC5B;AA2BD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,GACtB,aAAa,CAAC,eAAe,EAAE,cAAc,EAAE,aAAa,CAAC,CAwO/D"}

package/types/triggers/claimReminder/bindings.d.ts

@@ -0,0 +1,40 @@
+/**
+ * What the claim reminder hands the SDUI engine (trigger SDUI contract §2.2 to
+ * §2.5): its values, its two time keys and its lists, built from the eligible
+ * claims. The served tree draws them; nothing here draws.
+ */
+import type { TriggerIconValues } from '../host/theme';
+import type { SduiHostListItem } from '../../sdui/context';
+import type { ReminderCopy } from './config';
+import type { ReminderClaim } from './source';
+export interface ReminderBindings {
+    values: Record<string, string>;
+    times: {
+        start: number;
+        deadline: number;
+    };
+    lists: Record<string, SduiHostListItem[]>;
+}
+export interface ReminderBindingInput {
+    copy: ReminderCopy;
+    windowHours: number;
+    /** The served layout name, exposed as `${layout}`. */
+    layout: string;
+    /** The icon the look draws, exposed as `${icon}` and `${appIconUrl}`. */
+    icon: TriggerIconValues;
+    /** Every string the served look declares (`template.strings`), each exposed as a value. */
+    lookStrings?: Readonly<Record<string, string>>;
+    /** The look's value defaults with the mount's values over them, for `${values.K}`. */
+    lookValues?: Readonly<Record<string, string>>;
+    /**
+     * The string the look's headline text slot names (`textSlots.headline`), already holding
+     * the app's headline when it set one: the spoken title on a named claim, as the card draws it.
+     */
+    headlineKey?: string | null;
+}
+/**
+ * The bindings for the newest eligible claim. `eligible` is newest first, as
+ * `eligibleClaims` returns it, and not empty.
+ */
+export declare function reminderBindings(eligible: readonly ReminderClaim[], input: ReminderBindingInput): ReminderBindings;
+//# sourceMappingURL=bindings.d.ts.map

package/types/triggers/claimReminder/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/bindings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQ9C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,IAAI,EAAE,iBAAiB,CAAC;IACxB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,sFAAsF;IACtF,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAsDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,KAAK,EAAE,oBAAoB,GAC1B,gBAAgB,CAqFlB"}

package/types/triggers/claimReminder/config.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Reading the claim reminder's served template. The host has already checked the
+ * envelope (`template.trigger == 'claimReminder'`) and owns the variant ids and the
+ * served locale.
+ *
+ * The variant is an SDUI tree plus the keys the host reads (trigger SDUI
+ * vocabulary contract §1):
+ *
+ *   { trigger: 'claimReminder', layout, windowHours, dismissible, colors, strings, root }
+ *
+ * `root` is drawn by the engine; `layout` is only a label (events, `${layout}`).
+ * Everything here is tolerant: a missing or malformed field takes its default.
+ */
+import type { TriggerColors } from '../host/theme';
+/** The copy the trigger draws. `${advertiserName}` is filled at render. */
+export interface ReminderCopy {
+    title: string;
+    subtitle: string;
+    /** The open control's accessible name; the designs show no CTA text. */
+    cta: string;
+    /** The close control's accessible name. */
+    dismiss: string;
+    hours: string;
+    minutes: string;
+    seconds: string;
+    /** The title naming the claim's advertiser: "Finish your ${advertiserName} gift". */
+    offerTitle: string;
+    /** logoMarquee's title for several claims: "${claimCount} gifts still waiting". */
+    titleMany: string;
+    /** The word after the featured look's countdown: "23:32 left". */
+    left: string;
+}
+/**
+ * Built-in English, used per key when the template lacks one. Pinned across every
+ * platform to the backend fixture's values. The tone stays true for a reader who has
+ * already finished, and never says the offer ends or is lost.
+ */
+export declare const DEFAULT_REMINDER_COPY: Readonly<ReminderCopy>;
+export type ReminderColors = TriggerColors;
+export interface ReminderConfig {
+    /** The look's light colours (`lightColors`), used in the light scheme. */
+    lightColors: ReminderColors;
+    /** The served template, drawn by the SDUI engine. */
+    template: Record<string, unknown>;
+    /** The served layout name: a label, never a code path. */
+    layout: string;
+    windowHours: number;
+    dismissible: boolean;
+    colors: ReminderColors;
+    copy: ReminderCopy;
+}
+type Dict = Record<string, unknown>;
+/** The config to draw from the served `ui.template`. */
+export declare function decodeReminderTemplate(template: Dict): ReminderConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/types/triggers/claimReminder/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAWvD,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,WAAW,EAAE,cAAc,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;CACpB;AAGD,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoBpC,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,IAAI,GAAG,cAAc,CAUrE"}

package/types/triggers/claimReminder/eligibility.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Which claims the reminder may show (contract.md, behaviour 2).
+ *
+ * Eligible = available, inside the reminder window, with an advertiser to name, and
+ * not dismissed on this device. The window is the REMINDER's, not the offer's: when
+ * it ends the banner hides and the claim itself is untouched.
+ */
+import type { ReminderClaim } from './source';
+/**
+ * How far ahead of this device's clock a claim time may be: the server stamps it, and
+ * a device clock running up to this far behind must still show a claim just made.
+ */
+export declare const CLOCK_SKEW_MS: number;
+/** When the reminder for this claim hides. NaN for an unparseable claim time. */
+export declare function reminderEndsAt(claim: ReminderClaim, windowHours: number): number;
+/** The eligible claims, newest first. The first one is the one to show. */
+export declare function eligibleClaims(claims: readonly ReminderClaim[], windowHours: number, nowMs: number, dismissed: {
+    has(transactionId: string): boolean;
+}): ReminderClaim[];
+/** The longest reminder window any variant may serve (the backend validates 1..720). */
+export declare const MAX_WINDOW_HOURS = 720;
+/**
+ * Whether any claim could be shown: the gate before the config request, which assigns
+ * the experiment arm. Same rules as eligibility, under `windowHours`, the window last
+ * served at this placement (servedWindow.ts), capped at the longest any variant serves.
+ */
+export declare function hasReminderCandidate(claims: readonly ReminderClaim[], nowMs: number, dismissed: {
+    has(transactionId: string): boolean;
+}, windowHours: number): boolean;
+/**
+ * When `hasReminderCandidate` next turns false by the clock alone: the first epoch ms past
+ * the window of the claim that leaves it first. Null when no claim is in it.
+ */
+export declare function reminderCandidateEnds(claims: readonly ReminderClaim[], nowMs: number, dismissed: {
+    has(transactionId: string): boolean;
+}, windowHours: number): number | null;
+//# sourceMappingURL=eligibility.d.ts.map

package/types/triggers/claimReminder/eligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAgB,CAAC;AAM3C,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE;IAAE,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACjD,aAAa,EAAE,CAYjB;AAED,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE;IAAE,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAClD,WAAW,EAAE,MAAM,GAClB,OAAO,CAWT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE;IAAE,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAClD,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CASf"}

package/types/triggers/claimReminder/servedWindow.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The reminder window last served at each placement, kept on the device so it outlives
+ * a reload: an open claim asks for the reminder (`state=claimOpen`) only inside it. The
+ * window is only known from a served look, so before one is served here it is the
+ * 24 hour default. Storage that fails, or holds anything but a window of 1..720 hours,
+ * reads as that default; nothing here throws.
+ */
+export declare const SERVED_WINDOW_KEY = "encore.trigger.claimReminder.window";
+/** Before any window was served at a placement (also the decoder's default). */
+export declare const DEFAULT_WINDOW_HOURS = 24;
+/** The window last served at `placement` on this device, else the 24 hour default. */
+export declare function servedWindowHours(storage: Storage | null, placement: string | undefined): number;
+/** Keep the window a look at `placement` was served with. */
+export declare function rememberServedWindow(storage: Storage | null, placement: string | undefined, hours: number): void;
+//# sourceMappingURL=servedWindow.d.ts.map

package/types/triggers/claimReminder/servedWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"servedWindow.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/servedWindow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,eAAO,MAAM,iBAAiB,wCAAwC,CAAC;AAEvE,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAqBvC,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEhG;AAED,6DAA6D;AAC7D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWhH"}

package/types/triggers/claimReminder/source.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The claim reminder's view of the user's claims. INTERNAL.
+ *
+ * The trigger never reads the claims bank directly. It reads this adapter, so the
+ * trigger can be built and tested before the bank's `claims()` lands on main, and so
+ * the binding to it is one thin mapper (contract.md, "Dependency strategy"). The SDK's
+ * source is the claim log (the claims this browser saw), merged with the claims bank
+ * once one is bound (core/claimLog.ts).
+ *
+ * The same adapter exists on iOS and Android. A tap opens the Encore sheet, so
+ * the adapter only reads; nothing here reopens a claim.
+ */
+/** One open claim, reduced to what the reminder needs. */
+export interface ReminderClaim {
+    transactionId: string;
+    campaignId: string;
+    advertiserName: string;
+    advertiserLogoUrl?: string | null;
+    /** The claimed offer's perk ("3 months free"), when known. */
+    perk?: string;
+    /** ISO-8601. The latest claim time when the server exposes it, else the creation time. */
+    claimedAt: string;
+    availability: 'available' | 'unavailable';
+}
+export interface ClaimReminderSource {
+    /** The user's open claims, freshly read. Rejects when the read fails. */
+    openClaims(): Promise<ReminderClaim[]>;
+}
+//# sourceMappingURL=source.d.ts.map

package/types/triggers/claimReminder/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/triggers/claimReminder/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,WAAW,GAAG,aAAa,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CACxC"}