@encorekit/web-sdk 2.2.1 → 2.4.0

package/types/sdui/host.d.ts

@@ -0,0 +1,274 @@
+/**
+ * Turns the served template `Encore.ts` caches into DOM. Every entry point returns
+ * `undefined` rather than throwing, so a variant this build cannot draw keeps the
+ * built-in surface: a half-rendered sheet is worse than the surface that works.
+ */
+import type { CompiledTree } from "./compile";
+import type { SduiEvaluationContext, SduiOfferBindingData, SduiTextDefaults, SduiHostListItem } from "./context";
+import type { ActionHost } from "./actions";
+import type { SduiAction } from "./model";
+import type { ColorResolver } from "./style";
+import type { TextEnvironment } from "./elements/content";
+import type { MotionSheet } from "./motion";
+import type { TriggerKit } from "./triggerKit";
+/** The SDK's offer shape, narrowed to what the engine reads. */
+export interface HostOffer {
+    id: string;
+    title?: string;
+    description?: string;
+    ctaText?: string;
+    merchantName?: string;
+    imageUrl?: string;
+    logoUrl?: string;
+    heroImageUrl?: string;
+    termsUrl?: string;
+    shareUrl?: string;
+    perk?: string;
+    badgeLabel?: string;
+    category?: string;
+    quickInstructions?: string;
+    instructions?: {
+        title: string;
+        subtitle: string;
+        ctaButtonText?: string;
+        imageUrl?: string;
+    }[];
+    displayProperties?: Record<string, string>;
+}
+/**
+ * Map the SDK's offer onto the engine's.
+ *
+ * `shareUrl` is carried only when the backend minted one, so `hasOfferAttribute:
+ * "shareUrl"` stays false for an offer with no link and its share control does not
+ * draw: a link the backend never minted cannot be attributed. `newPrice` and
+ * `oldPrice` are absent because `OfferModel` carries neither.
+ */
+export declare function toBindingData(offer: HostOffer): SduiOfferBindingData;
+/**
+ * What the ENGINE knows and the host cannot see, for the `sdk_sdui_*` events.
+ *
+ * The engine reports facts, not events: it has no analytics client, no
+ * `distinctId`, and no `presentationId`, `variantId`, `useCase` or
+ * `placementId`. Those are the host's, and Swift passes them INTO its context
+ * (`SDUIContext.swift:508-556`). So the engine hands over the half only it
+ * holds and the host stamps the rest, which is also how a host drops an event
+ * that has no presentation yet, the way Swift's `guard let presentationId`
+ * does.
+ */
+export type SduiAnalyticsEvent = {
+    readonly kind: "stateTransition";
+    readonly fromState: string;
+    readonly toState: string;
+    readonly timeInPreviousStateMs: number;
+} | {
+    readonly kind: "valueSet";
+    readonly key: string;
+    readonly value: string;
+    /** Set when `value` is a selected offer's id, so the host can report its campaign. */
+    readonly offerId?: string;
+} | {
+    readonly kind: "buttonTapped";
+    readonly actionType: string;
+    readonly currentState: string;
+};
+export interface SduiSurfaceOptions {
+    /** The tree cached by `Encore.ts`, exactly as served. */
+    readonly template: unknown;
+    readonly offers: readonly HostOffer[];
+    readonly textEnvironment: TextEnvironment;
+    readonly actionHost: ActionHost;
+    /** Resolves an SDUI colour operand. Wrapped in the cssSafe grammar here. */
+    readonly color: ColorResolver;
+    readonly initialState?: string;
+    readonly initialIndex?: number;
+    readonly document?: Document;
+    /** Fire and forget. Never throws into the engine; see `#report`. */
+    readonly analytics?: (event: SduiAnalyticsEvent) => void;
+    /** Reads a logo's brand colour. Defaults to the canvas extractor. */
+    readonly dominantColor?: (url: string) => Promise<string | null>;
+    /** False dims and disables every claim button, as Swift does. */
+    readonly claimEnabled?: boolean;
+    /**
+     * `inline`: a trigger mount. Draws inside a host element at the root's own
+     * `frame.height` instead of filling a sheet, decodes the trigger vocabulary
+     * (`TRIGGER_*` in `vocabulary.ts`), and reads `lists`. A root without a
+     * positive numeric height does not mount. Absent is the sheet, unchanged.
+     */
+    readonly mode?: "sheet" | "inline";
+    /**
+     * Inline mounts only, and required there: the trigger-only engine code
+     * (`triggerKit.ts`), which the trigger chunk loads and passes in.
+     */
+    readonly kit?: TriggerKit;
+    /**
+     * Inline mounts only: whether a colour operand names a colour its owner chose
+     * exactly, so the operand's `opacity` does not apply (`lighten` and `darken` still
+     * do). A trigger's `secondary` or `track` is faded only when it falls back to the
+     * text colour, never when the publisher set it.
+     */
+    readonly exactColor?: (raw: unknown) => boolean;
+    /** Inline mounts only: the trigger host's named lists, for `hostList` rows. */
+    readonly lists?: Readonly<Record<string, readonly SduiHostListItem[]>>;
+    /**
+     * Inline mounts only: the host's time keys (`start`, `deadline`), ms since the
+     * epoch, read by `text.countdown` and `progress`.
+     */
+    readonly times?: Readonly<Record<string, number>>;
+    /** Inline mounts only: the clock at mount, ms since the epoch. Defaults to `Date.now()`. */
+    readonly now?: number;
+    /** Inline mounts only: loops and marquees hold still (§2.6; the host computes it). */
+    readonly motionPaused?: boolean;
+    /** Inline mounts only: the host's reduce-motion read (web: `prefers-reduced-motion`). */
+    readonly reduceMotion?: boolean;
+}
+/**
+ * How much an inline mount scales its text: the user's default text size (what the
+ * browser computes for `font-size: medium`, which the page's own CSS cannot move)
+ * against 16px, clamped to [1, `maxFontScale`]. Never below 1. Read from a probe,
+ * not the root element: a page that sets a larger root size as a design choice is
+ * not a user asking for larger text.
+ */
+export declare function inlineFontScale(doc: Document, maxFontScale: unknown): number;
+/**
+ * The positive numeric `frame.height` on the template's root element, or
+ * undefined. Read from the wire: the root is one `{ element: payload }` object.
+ */
+export declare function rootFrameHeight(template: unknown): number | undefined;
+/**
+ * A mounted variant.
+ *
+ * State changes go through the setters, which compute the dependencies that
+ * moved and re-run only the sites that read them. Nothing here re-walks the
+ * tree.
+ */
+export declare class SduiSurface {
+    #private;
+    readonly root: Node;
+    /** The root's height in an inline mount; undefined for a sheet. */
+    readonly inlineHeight?: number;
+    constructor(root: Node, tree: CompiledTree, ctx: SduiEvaluationContext, stateActions?: Readonly<Record<string, {
+        onEnter?: SduiAction;
+    }>>, analytics?: (event: SduiAnalyticsEvent) => void, extractColor?: (url: string) => Promise<string | null>, inlineHeight?: number, motion?: MotionSheet);
+    /** Take the surface out of the page, with its generated keyframes. */
+    destroy(): void;
+    /** Extract every offer logo's colour, as Swift does on first render. */
+    requestDominantColors(): void;
+    /**
+     * Hand a fact to the host's sink, and survive a sink that throws.
+     *
+     * The repo's rule is that analytics never blocks UX. A host callback that
+     * throws must not take the state machine with it, so the write has already
+     * happened by the time this runs.
+     */
+    report(event: SduiAnalyticsEvent): void;
+    get context(): SduiEvaluationContext;
+    /** The action a state declares for being entered, or undefined. */
+    onEnter(state: string): SduiAction | undefined;
+    /**
+     * Move to a state, and hand back the action it declares for being entered.
+     *
+     * The engine does NOT run it, exactly as Swift's `setState` does not: it
+     * returns the action and the host decides. That matters, because the host has
+     * policy the engine cannot have. On a claim success Swift fires the success
+     * state's `onEnter` WITHOUT transitioning to it
+     * (`OfferSheetViewModel.swift:1354-1359`), and an `onEnter` never counts as the
+     * user answering a question, because no tap happened.
+     */
+    setState(state: string): SduiAction | undefined;
+    /**
+     * A text field's keystroke, as Swift writes it: the value with no analytics
+     * event (it can be an email address), and `<key>Error` removed on edit.
+     */
+    editValue(key: string, value: string): void;
+    setValue(key: string, value: string): void;
+    /**
+     * Move what the sheet is focused on, and publish the offer it lands on.
+     *
+     * Writing only `currentIndex` was the bug Swift's own comment
+     * (`SDUIContext.swift:441-444`) describes: the carousel moves while
+     * `${selectedAdvertiserName}` and `selectedOfferId` stay on the card the user
+     * scrolled away from, so the CTA names one advertiser and the claim targets
+     * another. `scopedOfferId` is selection-first, so a claim after an advance hit
+     * the OLD offer.
+     *
+     * An out-of-range index is a no-op, as it is in Swift.
+     */
+    setOfferIndex(index: number, targetKey?: string): void;
+    /**
+     * Move an offer to `index`, reordering the list the rows are keyed against.
+     *
+     * An unknown id, an unchanged position and an empty list are all no-ops, and
+     * the target is clamped into range. `promoteToIndex` rides `selectOffer`, so
+     * this runs first and `selectOffer` then finds the offer where the user will
+     * see it.
+     */
+    promoteOffer(offerId: string, index: number): void;
+    /**
+     * Commit to an offer: write the whole selection snapshot AND re-centre.
+     *
+     * Both halves are load bearing, and writing only the id was wrong twice over.
+     * Swift's `writeSelectionValues` (`SDUIContext.swift:387`) publishes the
+     * advertiser, logo, description, perk and free-trial flag, which is what
+     * `${selectedAdvertiserName}` and the free-trial copy gates read. And moving
+     * `currentIndex` is what Android's `selectOffer` carries Swift's comment
+     * about: without it a tap wrote the selection while the centred card stayed
+     * put, so the CTA named one advertiser and the claim button targeted another.
+     *
+     * `selectedOfferIsFreeTrial` publishes "false" when the backend labelled
+     * nothing. Never promise a free month the offer does not carry.
+     */
+    selectOffer(offerId: string, targetKey?: string): void;
+    /**
+     * The mount-time selection, which is NOT a user choice and reports nothing.
+     *
+     * `initialSelection: "first"` pre-seeds the selection keys so
+     * `${selectedAdvertiserName}` resolves on the first frame. Swift seeds it the
+     * same way, through the direct write, because at that point no user has acted
+     * and it has no `presentationId` yet (`SDUIContext.swift:380-385`). Routing it
+     * through `selectOffer` would open every presentation with a selection event
+     * nobody made.
+     */
+    seedSelection(offerId: string, targetKey?: string): void;
+    setOffers(offers: readonly HostOffer[]): void;
+    /** Trigger mounts: replace the host's lists, re-running every row and count that reads them. */
+    setLists(lists: Readonly<Record<string, readonly SduiHostListItem[]>>): void;
+    /**
+     * Trigger mounts: advance the clock. Re-runs only the sites that read time
+     * (`countdown`, `progress`); the host owns the interval and when to call it.
+     */
+    setNow(now: number): void;
+    /** Trigger mounts: replace the host's time keys, as `setNow` re-running only what reads time. */
+    setTimes(times: Readonly<Record<string, number>>): void;
+    /**
+     * Trigger mounts: the host's motion flags. `data-paused` on the root mirrors
+     * `paused`, and every loop and marquee re-reads both.
+     */
+    setMotion(motion: {
+        readonly paused: boolean;
+        readonly reduce: boolean;
+    }): void;
+    /** Re-run everything. For a wholesale context swap, not for a single change. */
+    refresh(): void;
+}
+/**
+ * Why a served template cannot render on web, or undefined: the checks
+ * `mountSduiSurface` runs. Read before a presentation is stamped.
+ */
+export declare function templateRejection(raw: unknown): string | undefined;
+/**
+ * Decode, compile and mount a served template.
+ *
+ * Returns `undefined` on ANY failure, so the caller keeps its hard-coded
+ * surface. The reason is logged, never thrown.
+ */
+export declare function mountSduiSurface(options: SduiSurfaceOptions): SduiSurface | undefined;
+/**
+ * Display order from ORIGINAL indices, as Swift's `applyOfferDisplayOrder`: each
+ * valid, unused index in turn, then every offer not listed, in original order.
+ */
+export declare function applyOfferDisplayOrder<T>(order: readonly number[] | undefined, offers: readonly T[]): T[];
+/** Swift's `SDUIInitialSelection.resolvedIndex`; any other value rejects the config. */
+export declare function initialSelectionIndex(raw: unknown, count: number): number | undefined;
+/** Re-exported so a host need not reach into the engine's internals. */
+export type { SduiTextDefaults, TextEnvironment, ActionHost };
+//# sourceMappingURL=host.d.ts.map

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

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

package/types/sdui/inlineMarkup.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `*marked*` inline markup, ported from Swift's `SDUIInlineMarkup`.
+ *
+ * A single asterisk rather than markdown's `**`, because the copy is written by
+ * humans in a CMS field, not by a markdown author.
+ *
+ * Deliberately conservative. This runs on publisher-authored copy, so the
+ * failure mode has to be "renders as typed", never "eats the sentence":
+ *
+ *   - An unmatched marker is literal: `"5 * 3"` stays `"5 * 3"`.
+ *   - An empty pair `**` contributes nothing but is still consumed.
+ *   - Nesting is not a concept; the first close ends the run.
+ *
+ * Returns one un-highlighted run when there is nothing to mark, which lets the
+ * caller treat "no markup" and "no highlightColor" as the same path.
+ */
+export interface MarkupRun {
+    readonly text: string;
+    readonly isHighlighted: boolean;
+}
+export declare function parseInlineMarkup(text: string): MarkupRun[];
+//# sourceMappingURL=inlineMarkup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inlineMarkup.d.ts","sourceRoot":"","sources":["../../src/sdui/inlineMarkup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAiC3D"}

package/types/sdui/lookValues.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Look values: an app's own words and numbers in a trigger's look, as
+ * `${values.K}` (trigger vocabulary §2.2). The look declares a default for every key
+ * it uses in a root `values` block; the app may pass its own on the mount. They are
+ * filled on the device and never leave it: no request, event, log or store.
+ *
+ * One rule set for the strict pre-check (the look's defaults) and the host (the
+ * mount's values), the same on every platform.
+ */
+/** A value key: what follows `values.`. */
+export declare const LOOK_VALUE_KEY: RegExp;
+/** At most this many keys, in the look's defaults and on a mount. */
+export declare const MAX_LOOK_VALUES = 16;
+/** At most this many characters in one value. */
+export declare const MAX_LOOK_VALUE_LENGTH = 64;
+/** The token prefix. */
+export declare const LOOK_VALUE_PREFIX = "values.";
+/**
+ * The text slots' names (triggers/host/textSlots.ts): set with their own options, never a
+ * value key, on a look or on a mount.
+ */
+export declare const TEXT_SLOT_NAMES: readonly string[];
+/** Plain text a value may hold: 1 to 64 characters, no `${`, newline or control character. */
+export declare function isPlainValue(value: unknown): value is string;
+/** A look's own default: plain, and digits and punctuation only. */
+export declare function isLookDefault(value: unknown): value is string;
+/**
+ * The values a mount passed, as the look may use them: each entry checked on its own
+ * (a bad key or value is dropped, so the look's default shows), then the first 16
+ * keys in code-point order. `dropped` hears each dropped key, never its value.
+ */
+export declare function mountLookValues(raw: unknown, dropped?: (key: string) => void): Readonly<Record<string, string>>;
+/** A look's `values` defaults, already through the pre-check; anything unusable is skipped. */
+export declare function lookValueDefaults(template: unknown): Readonly<Record<string, string>>;
+/** Every `${values.K}` key in `text`. */
+export declare function lookValueKeysIn(text: string): string[];
+/**
+ * Fill one look string, in one pass that is never rescanned: `${values.K}` from
+ * `values` (the mount's over the look's defaults), and the host's `advertiserName`
+ * and `claimCount`. Any other token is left for the engine. A string that still holds
+ * a `${values.` token (a translation that lost its default) becomes `fallback` (the
+ * built-in English for that key), else empty: never a raw token, drawn or spoken.
+ */
+export declare function fillLookString(text: string, values: Readonly<Record<string, string>>, host: Readonly<{
+    advertiserName?: string;
+    claimCount?: string;
+}>, fallback?: string): string;
+/** Every string the look declares (`template.strings`), as served. */
+export declare function lookStringsOf(template: unknown): Readonly<Record<string, string>>;
+//# sourceMappingURL=lookValues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lookValues.d.ts","sourceRoot":"","sources":["../../src/sdui/lookValues.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,cAAc,QAA6B,CAAC;AACzD,qEAAqE;AACrE,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,wBAAwB;AACxB,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAuC,CAAC;AAQrF,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQ5D;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAY/G;AAED,+FAA+F;AAC/F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQrF;AAED,yCAAyC;AACzC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAItD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACxC,IAAI,EAAE,QAAQ,CAAC;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAChE,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAiBR;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQjF"}

package/types/sdui/model.d.ts

@@ -0,0 +1,130 @@
+/**
+ * The decoded SDUI tree.
+ *
+ * WHAT THIS COMMIT OWNS, and what it deliberately does not. The decoder proves
+ * the wire vocabulary and the STRUCTURE: which element each node is, its
+ * children, its condition, its action, its data source, its style keys. Leaf
+ * visual props (a text's font, an image's contentMode) stay in `props` as raw
+ * values, because the element that reads them does not exist yet. Each later
+ * element commit narrows what it reads out of `props`; none of them re-decodes
+ * the tree.
+ *
+ * `SduiNode` is a single shape with an `element` tag rather than a 22-arm
+ * discriminated union. The union looks tidier and is wrong for this engine: the
+ * compile pass in commit 3 walks EVERY node the same way (style, children,
+ * bindings) and dispatches on `element` only at the leaf, so a union would force
+ * 22 near-identical branches through the generic walker.
+ */
+import type { SduiActionType, SduiAlignment, SduiConditionName, SduiDataSource, SduiElementName, SduiOfferAttribute, SduiSemanticColor, SduiStyleProperty } from "./vocabulary";
+/**
+ * A value operand. `literal` covers both wire forms: a bare string, and
+ * `{"value": "..."}`.
+ */
+export type SduiValueRef = {
+    kind: "literal";
+    value: string;
+} | {
+    kind: "binding";
+    key: string;
+} | {
+    kind: "state";
+} | {
+    kind: "offerIndex";
+} | {
+    kind: "offerAttribute";
+    attribute: SduiOfferAttribute;
+} | {
+    kind: "categoryName";
+};
+/**
+ * A condition. `operands` carries nested conditions for `and`/`or`/`not`;
+ * everything else carries its own payload in `payload`.
+ *
+ * `not` is normalised to a single-element `operands`, so a combinator always
+ * reads the same way.
+ */
+export interface SduiCondition {
+    readonly name: SduiConditionName;
+    readonly operands?: readonly SduiCondition[];
+    readonly payload?: unknown;
+}
+/** An action. Both wire forms decode to this; `params` is empty for the bare string. */
+export interface SduiAction {
+    readonly type: SduiActionType;
+    readonly params: Readonly<Record<string, unknown>>;
+    /** `setValueRef`, decoded. A malformed ref fails the variant, as in Swift. */
+    readonly valueRef?: SduiValueRef;
+}
+/** A colour operand. The four arms are `hex`, `semantic`, `appearance`, `binding`. */
+export type SduiColor = {
+    kind: "hex";
+    hex: string;
+    opacity?: number;
+} | {
+    kind: "semantic";
+    semantic: SduiSemanticColor;
+} | {
+    kind: "appearance";
+    appearance: string;
+} | {
+    kind: "binding";
+    binding: string;
+};
+/**
+ * Style as decoded: known keys only, values still raw.
+ *
+ * Commit 4 owns turning these into CSS. Keeping the values raw here means the
+ * style commit can change its representation without touching the decoder.
+ */
+export type SduiStyle = Partial<Record<SduiStyleProperty, unknown>> & {
+    /** Decoded, because both are child elements rather than values. */
+    readonly overlay?: SduiNode;
+    readonly backgroundElement?: SduiNode;
+};
+/** One node of the tree. */
+export interface SduiNode {
+    readonly element: SduiElementName;
+    /** Raw element payload, minus the keys promoted onto this interface. */
+    readonly props: Readonly<Record<string, unknown>>;
+    readonly style?: SduiStyle;
+    readonly children?: readonly SduiNode[];
+    /** `button`, `scrollView` and `group` carry a single child under `content`. */
+    readonly content?: SduiNode;
+    /** `forEach` only. Its repeated body, named `itemTemplate` on the wire. */
+    readonly itemTemplate?: SduiNode;
+    /** `forEach` only. Rows failing it are not drawn. */
+    readonly filter?: SduiCondition;
+    /** `toggle` only, and REQUIRED there in Swift. */
+    readonly label?: SduiNode;
+    readonly alignment?: SduiAlignment;
+    /** `conditional` only. */
+    readonly condition?: SduiCondition;
+    readonly ifTrue?: SduiNode;
+    readonly ifFalse?: SduiNode;
+    /** `forEach` only. */
+    readonly dataSource?: SduiDataSource;
+    /** `button` and `slideButton` only. */
+    readonly action?: SduiAction;
+    /** Trigger vocabulary, `asyncImage` only: drawn while loading, with no url, and on error. */
+    readonly fallback?: SduiNode;
+    /** Trigger vocabulary, `marquee` only: animate only while this holds. */
+    readonly animateWhen?: SduiCondition;
+}
+/** A whole variant template. */
+export interface SduiTemplate {
+    readonly version?: string;
+    readonly useCase?: string;
+    readonly root: SduiNode;
+    /** Sheet chrome the root does not describe. Raw: the host reads it, not the engine. */
+    readonly presentation: Readonly<Record<string, unknown>>;
+    /**
+     * Per-state actions, keyed by state name.
+     *
+     * Decoded rather than passed through raw, so an action inside an `onEnter` is
+     * held to the same vocabulary a button's is.
+     */
+    readonly stateActions?: Readonly<Record<string, {
+        onEnter?: SduiAction;
+    }>>;
+}
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/sdui/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAEtB;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,kBAAkB,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wFAAwF;AACxF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;CAClC;AAED,sFAAsF;AACtF,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,GAAG;IACpE,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC;CACvC,CAAC;AAEF,4BAA4B;AAC5B,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC;IACjC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAG1B,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IACnC,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;IAC5B,sBAAsB;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;IACrC,uCAAuC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;CACtC;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,uFAAuF;IACvF,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC,CAAC;CAC5E"}

package/types/sdui/motion.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Trigger motion (contract §3.3 G3 `style.loop`, §3.4 G4 `marquee`) as CSS
+ * keyframes generated per element.
+ *
+ * Trigger mounts only: the host creates a {@link MotionSheet} for an inline
+ * mount and nothing else does, so a sheet never animates anything new. The
+ * keyframes live in one `<style>` inside the mount, named per element, so they
+ * neither collide across mounts nor outlive the mount they belong to.
+ *
+ * Reduced motion, and a pause before a loop has ever run, are static poses written
+ * inline, computed here because the contract fixes WHICH pose (the `reducedMotion`
+ * pose, or progress 0 with `phaseOffset`). A pause after the loop has run holds
+ * wherever it is (`animation-play-state: paused`) and resumes from there.
+ */
+import type { CompileServices } from "./compile";
+/** The `@keyframes` of one mount, one rule per owning element. */
+export declare class MotionSheet {
+    #private;
+    readonly element: HTMLStyleElement;
+    constructor(doc: Document);
+    /** A keyframes name no other element, mount or SDK copy uses. */
+    name(): string;
+    /** Set (or replace) `name`'s rule. Rules of owners no longer in the mount are dropped. */
+    define(name: string, owner: Element, css: string): void;
+    /** Drop every rule and the `<style>` itself. */
+    destroy(): void;
+}
+/**
+ * Run `style.loop` on `el`: forever while the host lets it, held where it is while
+ * paused after it has run, a frozen pose under reduce motion or paused before it ran. `base` is the element's own transform and
+ * opacity from `planStyle`, which the loop composes after.
+ */
+export declare function attachLoop(el: HTMLElement, raw: unknown, base: {
+    readonly transform: string;
+    readonly opacity: string;
+}, sheet: MotionSheet, services: CompileServices): void;
+//# sourceMappingURL=motion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"motion.d.ts","sourceRoot":"","sources":["../../src/sdui/motion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAMjD,kEAAkE;AAClE,qBAAa,WAAW;;IACtB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAKvB,GAAG,EAAE,QAAQ;IASzB,iEAAiE;IACjE,IAAI,IAAI,MAAM;IAKd,0FAA0F;IAC1F,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAgBvD,gDAAgD;IAChD,OAAO,IAAI,IAAI;CAIhB;AAqJD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,WAAW,EACf,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC9D,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,eAAe,GACxB,IAAI,CA8CN"}

package/types/sdui/precheck.d.ts

@@ -0,0 +1,94 @@
+/**
+ * The strict pre-check a trigger host runs on the raw template before it hands
+ * the tree to the engine (trigger SDUI vocabulary contract v1, §5).
+ *
+ * The decoder is strict about element names, conditions and enum values, and
+ * lenient about FIELDS: an unknown field is ignored so the backend can roll one
+ * out ahead of the clients. Behind that, an unknown action decodes to a dead
+ * button and an unknown symbol draws nothing. For a sheet that trade is right.
+ * For a trigger it is not: a trigger that draws wrong still counts an
+ * impression, so a broken file would read as a low click rate. So a trigger tree
+ * may use only `TRIGGER_ALLOW`, the contract's list, and anything else makes it
+ * unrenderable: the host draws nothing and reports `unrenderable`.
+ *
+ * Mirrors the contract's `check-fixtures.py`, which the backend validator runs
+ * at sync and in CI. Nested value shapes (font, frame, padding, loop keyframes,
+ * countdown, value, shadow) are left to the decoder.
+ */
+export declare const TRIGGER_ALLOW: {
+    readonly elements: readonly ["text", "systemImage", "asyncImage", "button", "vStack", "hStack", "zStack", "spacer", "shape", "gradient", "forEach", "conditional", "group", "empty", "progress", "marquee"];
+    readonly fields: {
+        readonly text: readonly ["text", "countdown", "font", "color", "lineLimit", "minimumScaleFactor", "multilineAlignment", "segments", "scaleGroup", "style"];
+        readonly systemImage: readonly ["systemName", "font", "color", "style"];
+        readonly asyncImage: readonly ["url", "contentMode", "placeholderColor", "fallback", "style"];
+        readonly button: readonly ["content", "action", "disabled", "accessibilityLabel", "accessibilityHint", "pressedStyle", "style"];
+        readonly vStack: readonly ["alignment", "spacing", "children", "style"];
+        readonly hStack: readonly ["alignment", "spacing", "children", "style"];
+        readonly zStack: readonly ["alignment", "children", "style"];
+        readonly spacer: readonly ["minLength"];
+        readonly shape: readonly ["type", "cornerRadius", "fillColor", "strokeColor", "strokeWidth", "style"];
+        readonly gradient: readonly ["type", "direction", "colors", "startRadius", "endRadius", "style"];
+        readonly forEach: readonly ["dataSource", "list", "itemTemplate", "limit", "offset"];
+        readonly conditional: readonly ["condition", "ifTrue", "ifFalse"];
+        readonly group: readonly ["content", "style"];
+        readonly empty: readonly [];
+        readonly progress: readonly ["value", "fillColor", "trackColor", "style"];
+        readonly marquee: readonly ["axis", "duration", "reverse", "spacing", "animateWhen", "content", "style"];
+    };
+    readonly style: readonly ["padding", "frame", "cornerRadius", "backgroundColor", "shadow", "opacity", "clipShape", "clipped", "borderWidth", "borderColor", "offset", "scale", "rotation", "overlay", "backgroundElement", "fixedSize", "layoutPriority", "stateStyles", "stateAnimation", "loop", "layoutDirection", "accessibilityHidden"];
+    readonly actions: readonly ["trigger", "dismissTrigger"];
+    readonly targets: readonly ["card", "arrow", "button"];
+    readonly symbols: readonly ["gift", "gift.fill", "chevron.forward", "arrow.forward", "xmark"];
+    readonly conditions: readonly ["hasValue", "valueEquals", "stateEquals", "and", "or", "not", "listCountAtLeast"];
+    readonly appearance: readonly ["background", "onBackground", "surface", "onSurface", "accent", "onAccent", "inkOnAccent", "border", "secondary", "track", "backgroundEnd"];
+    readonly countdownFormats: readonly ["clock", "hoursMinutes", "hours", "minutes", "seconds", "largestUnit"];
+    readonly curves: readonly ["linear", "easeIn", "easeOut", "easeInOut"];
+    readonly shapeTypes: readonly ["rectangle", "roundedRectangle", "circle", "capsule", "ellipse"];
+    readonly dataSources: readonly ["hostList"];
+    readonly values: {
+        readonly giftsButton: readonly ["title", "subtitle", "cta", "layout", "icon", "appIconUrl", "offersTitle"];
+        readonly claimReminder: readonly ["title", "subtitle", "cta", "layout", "dismiss", "hours", "minutes", "seconds", "advertiserName", "advertiserInitial", "advertiserLogoUrl", "accessibilityTitle", "icon", "appIconUrl", "offerTitle", "titleMany", "claimCount", "perk", "accessibilityHint", "left"];
+    };
+    readonly times: {
+        readonly giftsButton: readonly [];
+        readonly claimReminder: readonly ["start", "deadline"];
+    };
+    readonly lists: {
+        readonly giftsButton: readonly ["offerLogos", "offerLogosA", "offerLogosB"];
+        readonly claimReminder: readonly ["claims", "marqueeLogos", "marqueeLogosA", "marqueeLogosB"];
+    };
+    readonly itemFields: {
+        readonly claims: readonly ["transactionId", "advertiserName", "advertiserInitial", "advertiserLogoUrl"];
+        readonly marqueeLogos: readonly ["logoUrl"];
+        readonly marqueeLogosA: readonly ["logoUrl"];
+        readonly marqueeLogosB: readonly ["logoUrl"];
+        readonly offerLogos: readonly ["logoUrl", "advertiserName", "advertiserInitial"];
+        readonly offerLogosA: readonly ["logoUrl", "advertiserName", "advertiserInitial"];
+        readonly offerLogosB: readonly ["logoUrl", "advertiserName", "advertiserInitial"];
+    };
+    readonly behavior: Readonly<Record<string, Readonly<Record<string, readonly string[] | "layout">>>>;
+    readonly ranges: Readonly<Record<string, readonly (number | string)[]>>;
+    readonly renders: Readonly<Record<string, readonly string[]>>;
+};
+/**
+ * The next-step rules a look carries, as this build reads them: each of the trigger's steps
+ * with its default, overridden by a value the look sets that the step allows. An unknown
+ * step, a value the step does not allow, or a `behavior` that is not an object is skipped,
+ * so that step keeps its default; none of them fails the look.
+ */
+export declare function effectiveBehavior(template: Record<string, unknown>, trigger: string): Record<string, string>;
+export declare const isPinnableLayout: (value: unknown) => value is string;
+export type TriggerPrecheckId = keyof typeof TRIGGER_ALLOW.values;
+export interface PrecheckFailure {
+    /** What is wrong, e.g. `style key "blur"`. */
+    readonly reason: string;
+    /** Where, as a JSON path from the template. */
+    readonly path: string;
+}
+/**
+ * The first thing in a trigger template this build must not render, or undefined.
+ * `trigger` is the trigger the host is mounting, whose values, times and lists
+ * the tree may name.
+ */
+export declare function precheckTrigger(template: unknown, trigger: TriggerPrecheckId): PrecheckFailure | undefined;
+//# sourceMappingURL=precheck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"precheck.d.ts","sourceRoot":"","sources":["../../src/sdui/precheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA4EnB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;qBAmChF,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;sBAEwB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CACtH,CAAC;AAIX;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAc5G;AAQD,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACiC,CAAC;AAY7F,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,aAAa,CAAC,MAAM,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAoCD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,iBAAiB,GACzB,eAAe,GAAG,SAAS,CAkZ7B"}