@encorekit/web-sdk 2.3.0 → 2.4.0

package/types/sdui/compile.d.ts

@@ -0,0 +1,88 @@
+/**
+ * The compile pass: tree in, DOM out, plus a registry of update sites.
+ *
+ * 🔴 WHY THIS IS NOT AN INTERPRETER. Both natives re-read the tree on every
+ * render, because SwiftUI and Compose rebuild declaratively and diff for you.
+ * The DOM does not. Replacing a subtree destroys state the BROWSER owns: a
+ * focused `textField` loses its caret, a `scrollView` loses its offset (which
+ * breaks `scrollTargetLayout` and the page indicator), a video restarts, an
+ * in-flight drag is dropped, and a CSS transition cannot run because the node it
+ * would animate is gone. Diffing instead would mean a virtual DOM, and this SDK
+ * ships zero runtime dependencies.
+ *
+ * 🔴 A SITE CARRIES ITS SCOPE, AND ITS LIFETIME.
+ *
+ * Both halves were missing at first and both were wrong in the same way: the
+ * site list was flat, so a site registered while compiling a `forEach` row ran
+ * later against the TREE context. Every row then resolved `scopedOffer` to
+ * `offers[currentIndex]` and rendered the same offer, which is every list and
+ * carousel variant silently wrong. A site therefore stores the scope it was
+ * compiled under, and `run` applies it.
+ *
+ * Lifetime is the same bug one step on. Sites for a dropped row or an unmounted
+ * branch used to stay in the list for ever, running against detached nodes and
+ * holding them alive. Sites now belong to a GROUP that can be deactivated or
+ * dropped with the DOM it drives.
+ */
+import type { SduiNode, SduiTemplate } from "./model";
+import type { SduiElementName } from "./vocabulary";
+import type { SduiEvaluationContext } from "./context";
+import type { Dependency } from "./deps";
+/** Thrown when the tree names an element no renderer has been registered for. */
+export declare class SduiCompileError extends Error {
+    constructor(message: string);
+}
+/** Narrows the tree context to what a site was compiled under. */
+export type Scope = (ctx: SduiEvaluationContext) => SduiEvaluationContext;
+interface Group {
+    readonly id: number;
+    readonly parent: Group | undefined;
+    active: boolean;
+}
+interface SiteEntry {
+    readonly deps: readonly Dependency[];
+    readonly scope: Scope;
+    readonly group: Group;
+    run(ctx: SduiEvaluationContext): void;
+}
+/** What a renderer returns. `update` is folded into the registry as a site. */
+export interface Rendered {
+    readonly node: Node;
+    readonly deps?: readonly Dependency[];
+    update?(ctx: SduiEvaluationContext): void;
+}
+/** Services a renderer needs from the compiler, so renderers stay leaf-shaped. */
+export interface CompileServices {
+    /** Compile a child node, registering its sites under the current scope. */
+    compileChild(node: SduiNode, ctx: SduiEvaluationContext): Rendered;
+    /**
+     * Register an extra site, for a renderer that needs more than the one its
+     * `Rendered` carries. It takes the CURRENT scope and group, like any other.
+     */
+    addSite(site: {
+        deps: readonly Dependency[];
+        run(ctx: SduiEvaluationContext): void;
+    }): void;
+    readonly document: Document;
+}
+export type ElementRenderer = (node: SduiNode, ctx: SduiEvaluationContext, services: CompileServices) => Rendered;
+export declare class ElementRegistry {
+    #private;
+    register(name: SduiElementName, renderer: ElementRenderer): this;
+    get(name: SduiElementName): ElementRenderer | undefined;
+    get registered(): readonly SduiElementName[];
+}
+/** A compiled tree. `update` re-runs only live sites whose dependencies moved. */
+export declare class CompiledTree {
+    #private;
+    readonly root: Node;
+    constructor(root: Node, sites: SiteEntry[]);
+    /** Live sites. A dropped row's sites are gone, not merely skipped. */
+    get siteCount(): number;
+    /** Sites that would actually run, i.e. whose group chain is active. */
+    get activeSiteCount(): number;
+    update(ctx: SduiEvaluationContext, changed?: Iterable<Dependency>): number;
+}
+export declare function compile(template: SduiTemplate, ctx: SduiEvaluationContext, registry: ElementRegistry, doc?: Document): CompiledTree;
+export {};
+//# sourceMappingURL=compile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/sdui/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAiB,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAuB,MAAM,WAAW,CAAC;AAK5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,iFAAiF;AACjF,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,kEAAkE;AAClE,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,qBAAqB,KAAK,qBAAqB,CAAC;AAI1E,UAAU,KAAK;IACb,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,SAAS;IACjB,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,GAAG,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACvC;AAKD,+EAA+E;AAC/E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,MAAM,CAAC,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC3C;AAED,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,qBAAqB,GAAG,QAAQ,CAAC;IACnE;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE;QACZ,IAAI,EAAE,SAAS,UAAU,EAAE,CAAC;QAC5B,GAAG,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAAC;KACvC,GAAG,IAAI,CAAC;IACT,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,qBAAqB,EAC1B,QAAQ,EAAE,eAAe,KACtB,QAAQ,CAAC;AAEd,qBAAa,eAAe;;IAG1B,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAKhE,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS;IAIvD,IAAI,UAAU,IAAI,SAAS,eAAe,EAAE,CAE3C;CACF;AAED,kFAAkF;AAClF,qBAAa,YAAY;;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;gBAGR,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;IAK1C,sEAAsE;IACtE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,uEAAuE;IACvE,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,MAAM,CAAC,GAAG,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM;CAa3E;AAED,wBAAgB,OAAO,CACrB,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,qBAAqB,EAC1B,QAAQ,EAAE,eAAe,EACzB,GAAG,GAAE,QAAmB,GACvB,YAAY,CA+Sd"}

package/types/sdui/conditions.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Condition evaluation.
+ *
+ * Pure and total: every branch returns a boolean and nothing throws. Recursion
+ * follows the authored JSON, which the backend's variant validation bounds.
+ *
+ * Three rules carry the weight, and all three are easy to get subtly wrong:
+ *
+ *  1. `hasValue` tests PRESENCE, not non-emptiness. An empty string counts.
+ *  2. `equals` with two UNSET operands is NOT a match. `offerAttribute` made
+ *     that the common case: most campaigns carry no badge, so comparing a row's
+ *     badge against an unwritten binding would be true on exactly the rows that
+ *     have no badge.
+ *  3. A value ref that resolves to nothing is `undefined`, never `""`, so an
+ *     `equals` against an authored empty string is false rather than a match.
+ */
+import type { SduiCondition, SduiValueRef } from "./model";
+import type { SduiEvaluationContext } from "./context";
+/** Resolves an operand to a comparable string, or undefined when it holds nothing. */
+export declare function resolveValueRef(ref: SduiValueRef, ctx: SduiEvaluationContext): string | undefined;
+export declare function evaluate(condition: SduiCondition, ctx: SduiEvaluationContext): boolean;
+//# sourceMappingURL=conditions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../src/sdui/conditions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAO3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAGvD,sFAAsF;AACtF,wBAAgB,eAAe,CAC7B,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,qBAAqB,GACzB,MAAM,GAAG,SAAS,CAiBpB;AAqCD,wBAAgB,QAAQ,CACtB,SAAS,EAAE,aAAa,EACxB,GAAG,EAAE,qBAAqB,GACzB,OAAO,CA+GT"}

package/types/sdui/context.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Everything a condition or binding can read, as plain data.
+ *
+ * Offers are held in DISPLAY order, after `offerDisplayOrder` has been applied,
+ * so every position predicate operates in the space the user actually sees.
+ * They are whole offers rather than ids, because `offerAttribute` reads a row's
+ * own campaign fields: passing positions without the attributes that go with
+ * them resolved every attribute to null on Android, with nothing to say so.
+ *
+ * This is the engine's own shape, not the SDK's offer model. Commit 8 maps one
+ * to the other at the host boundary, which is what keeps this file pure.
+ */
+/** Applied when `initialState` is absent. */
+export declare const DEFAULT_STATE = "default";
+/** Default key written by `selectOffer` when no `targetKey` is given. */
+export declare const DEFAULT_SELECTION_KEY = "selectedOfferId";
+export interface SduiInstructionStep {
+    readonly title?: string;
+    readonly subtitle?: string;
+    readonly ctaButtonText?: string;
+    readonly imageUrl?: string;
+    /** 1-based, assigned AFTER the blank steps are dropped so there are no gaps. */
+    readonly position?: number;
+}
+export interface SduiOfferBindingData {
+    readonly id: string;
+    readonly advertiserName?: string;
+    /** `primaryCreative.description`, the advertiser copy shown on the card. */
+    readonly description?: string;
+    readonly perk?: string;
+    readonly ctaText?: string;
+    readonly newPrice?: string;
+    readonly oldPrice?: string;
+    readonly primaryImageUrl?: string;
+    readonly logoUrl?: string;
+    /** The promo badge as it arrives, `free_trial` or `discount`. */
+    readonly badgeLabel?: string;
+    readonly category?: string;
+    readonly heroImageUrl?: string;
+    readonly shareUrl?: string;
+    readonly termsUrl?: string;
+    readonly quickInstructions?: string;
+    readonly instructions?: readonly SduiInstructionStep[];
+    /** Admin copy by key, read by `propertyKey`. Blank values are already absent. */
+    readonly displayProperties?: Readonly<Record<string, string>>;
+}
+/** Copy that is not offer-scoped. Absent entries fall back to the constants in `bindings.ts`. */
+export interface SduiTextDefaults {
+    readonly titleText?: string;
+    readonly accentTitleText?: string;
+    readonly subtitleText?: string;
+    /** `offerCtaText` with no offer bound (`card.get`), and for an offer with none (`card.claim`). */
+    readonly getText?: string;
+    readonly claimText?: string;
+    /** Chip labels by category group key, as Swift's `giftCategory` translates them. */
+    readonly categoryLabels?: Readonly<Record<string, string>>;
+    /** The accessible name of a button that holds only this symbol, by symbol name. */
+    readonly symbolLabels?: Readonly<Record<string, string>>;
+}
+export interface SduiEvaluationContext {
+    readonly offers: readonly SduiOfferBindingData[];
+    /** Index of the centred card, or undefined when nothing is current. */
+    readonly currentIndex?: number;
+    readonly currentState: string;
+    readonly values: Readonly<Record<string, string>>;
+    /** The flag the renderer threads down for `isCurrentPageBinding`. */
+    readonly isCurrentPage: boolean;
+    /** The `forEach` row's offer id; undefined outside a row. */
+    readonly rowOfferId?: string;
+    /** The `categories` forEach chip's category; undefined outside one. */
+    readonly rowCategory?: string;
+    /** The `instructions` forEach step; undefined outside one. */
+    readonly rowStep?: SduiInstructionStep;
+    /**
+     * IAP product facts. False whenever no product info was fetched, which matches
+     * iOS evaluating against a nil product.
+     */
+    readonly hasIntroOffer: boolean;
+    readonly hasFreeTrial: boolean;
+    /** Logo URL to extracted brand colour, filled in as extractions land. */
+    readonly dominantColors?: Readonly<Record<string, string>>;
+    /** The host app's icon, whose colour is `appDominantColor`. */
+    readonly appIconUrl?: string;
+    /**
+     * Trigger mounts only: the host's named lists (`forEach` `hostList`), each a
+     * list of string maps, e.g. `marqueeLogos: [{ logoUrl }]`.
+     */
+    readonly lists?: Readonly<Record<string, readonly SduiHostListItem[]>>;
+    /** The `hostList` row's item; undefined outside one. Read as `${item.<field>}`. */
+    readonly rowItem?: SduiHostListItem;
+    /** Trigger mounts only: the host's time keys (`start`, `deadline`), ms since the epoch. */
+    readonly times?: Readonly<Record<string, number>>;
+    /** Trigger mounts only: the host's clock, ms since the epoch, advanced by `setNow`. */
+    readonly now?: number;
+    /** Trigger mounts only, set by the host: loops and marquees hold still. */
+    readonly motionPaused?: boolean;
+    /** Trigger mounts only: the platform's reduce-motion setting, read by the host. */
+    readonly reduceMotion?: boolean;
+}
+/** One entry of a trigger host's list. */
+export type SduiHostListItem = Readonly<Record<string, string>>;
+/** The `${item.<field>}` keys a `hostList` row exposes, as values. */
+export declare function itemValues(item: SduiHostListItem): Record<string, string>;
+export declare function emptyContext(over?: Partial<SduiEvaluationContext>): SduiEvaluationContext;
+/**
+ * The row's offer inside a `forEach`, else the SELECTED one, else the current
+ * card.
+ *
+ * Selection beats index, matching Swift's `currentOffer` (`SDUIContext.swift:227`).
+ * Resolving index-first is what left a congratulations screen blank and a claim
+ * button inert after a pick made somewhere other than the centred card. Android
+ * resolves index-first and documents it as a known gap against iOS; Swift is
+ * canonical, so this follows Swift.
+ */
+export declare function scopedOfferId(ctx: SduiEvaluationContext): string | undefined;
+/**
+ * Index of the scoped offer, or undefined outside a row with no current offer,
+ * so position predicates are false there rather than accidentally zero.
+ */
+export declare function scopedOfferIndex(ctx: SduiEvaluationContext): number | undefined;
+export declare function scopedOffer(ctx: SduiEvaluationContext): SduiOfferBindingData | undefined;
+/** The row-scoped view used when rendering a `forEach` item. */
+export declare function forRow(ctx: SduiEvaluationContext, offerId: string, isCurrentPage?: boolean): SduiEvaluationContext;
+/**
+ * The values a colour resolves against: `values`, plus the two logo colours.
+ *
+ * Swift's `colorValues`. `offerDominantColor` is the row's offer, else the
+ * current one, and `selectedOfferDominantColor` is the selected logo. Each is
+ * set only once a real colour exists, so the JSON `fallback` paints until then.
+ */
+export declare function colorValues(ctx: SduiEvaluationContext): Readonly<Record<string, string>>;
+//# sourceMappingURL=context.d.ts.map

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

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

package/types/sdui/countdown.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Time arithmetic for a trigger mount's `text.countdown` and `progress` (trigger
+ * vocabulary contract v1, §3.1 and §3.2). Pure: the host owns the clock and the
+ * time keys, and hands both in.
+ */
+/** The host's time keys (`start`, `deadline`), as ms since the epoch. */
+export type SduiTimes = Readonly<Record<string, number>>;
+/**
+ * Whole seconds from `now` to `to`, floored and clamped at 0. Non-finite input,
+ * or more than ten years left, is 0.
+ */
+export declare function remainingSeconds(to: number | undefined, now: number | undefined): number;
+/**
+ * The countdown text for `seconds` left. `clock` is `HH:MM:SS` (hours may pass
+ * 99); `hoursMinutes` is `HH:MM`, the clock without its seconds (minutes floored); `hours`, `minutes` and `seconds` are that part alone, two digits;
+ * `largestUnit` is `"<n> <unit>"` for the largest non-zero part, with the unit
+ * text from `units` (already resolved).
+ */
+export declare function formatCountdown(format: unknown, seconds: number, units: Readonly<{
+    hours?: string;
+    minutes?: string;
+    seconds?: string;
+}>): string;
+/**
+ * A `progress.value`, clamped to 0..1: `{ timeRemaining: { from, to } }` is
+ * `(to - now) / (to - from)`, draining to 0; `{ literal: n }` is `n`. Anything
+ * the engine cannot read (a missing time key, an empty window, another shape)
+ * is 0, so the bar draws empty rather than failing.
+ */
+export declare function progressFraction(value: unknown, times: SduiTimes | undefined, now: number | undefined): number;
+//# sourceMappingURL=countdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"countdown.d.ts","sourceRoot":"","sources":["../../src/sdui/countdown.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,yEAAyE;AACzE,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,CAKR;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,QAAQ,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACtE,MAAM,CAqBR;AASD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,CAiBR"}

package/types/sdui/decode.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Strict decode of a served SDUI template.
+ *
+ * 🔴 THE ONE RULE, and it is asymmetric on purpose:
+ *
+ *   - An unknown enum VALUE, element name or condition name FAILS the whole
+ *     config. A variant naming something this build cannot render is a variant
+ *     this build must not render PARTLY: half a sheet is worse than the
+ *     hard-coded fallback, and it is invisible in analytics.
+ *   - An unknown FIELD is IGNORED. That is what lets the backend add a field
+ *     and roll it out before every client ships, which is the whole point of
+ *     `min_sdk_versions` gating values rather than fields.
+ *
+ * Both natives behave this way; web must match or the same variant renders on
+ * three clients and fails on one.
+ *
+ * Failure is a throw, not a null. The caller catches, keeps its hard-coded
+ * surface, and reports. A null return would invite a silent `?? fallback` at
+ * one call site and an unchecked deref at the next.
+ */
+import type { SduiTemplate } from "./model";
+/** Thrown for anything the closed sets reject. `path` locates it in the tree. */
+export declare class SduiDecodeError extends Error {
+    readonly path: string;
+    constructor(message: string, path: string);
+}
+/**
+ * Decode a template served under `ui.template` or `useCases[x].template`.
+ *
+ * @throws {SduiDecodeError} on any closed-set violation.
+ */
+export declare function decodeTemplate(raw: unknown, options?: {
+    readonly trigger?: boolean;
+}): SduiTemplate;
+//# sourceMappingURL=decode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/sdui/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAiDH,OAAO,KAAK,EAKV,YAAY,EAEb,MAAM,SAAS,CAAC;AAEjB,iFAAiF;AACjF,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C;AAkcD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3C,YAAY,CAQd"}

package/types/sdui/deps.d.ts

@@ -0,0 +1,43 @@
+/**
+ * What a binding READS, so an update can touch only what changed.
+ *
+ * This is the half of "compile once, then bind" that makes the second half
+ * cheap. Every update site records its dependencies at compile time, and a
+ * state change invalidates only the sites that named the thing that moved.
+ * Without this the engine would walk the whole tree per change, which is the
+ * interpret model the DOM cannot afford.
+ *
+ * Dependencies are strings rather than an enum because `value:` is parameterised
+ * by key, and a variant may write any key it likes. Over-reporting is safe (a
+ * site updates when it need not); under-reporting is a stale screen, so every
+ * derivation below errs toward listing more.
+ */
+import type { SduiCondition, SduiValueRef } from "./model";
+export type Dependency = string;
+/** The current state name. */
+export declare const DEP_STATE = "state";
+/** The offers list itself: length, order, membership. */
+export declare const DEP_OFFERS = "offers";
+/** Which card is current. */
+export declare const DEP_INDEX = "index";
+/** The row scope a `forEach` item renders under. */
+export declare const DEP_ROW = "row";
+/** IAP product facts. Fetched once, but not always before first paint. */
+export declare const DEP_IAP = "iap";
+/** A trigger host's lists (`hostList`, `listCountAtLeast`). */
+export declare const DEP_LISTS = "lists";
+/** A trigger host's clock and time keys (`countdown`, `progress`). */
+export declare const DEP_TIME = "time";
+/** A trigger host's motion flags (`motionPaused`, `reduceMotion`). */
+export declare const DEP_MOTION = "motion";
+/** One entry of the mutable values dictionary. */
+export declare const depValue: (key: string) => Dependency;
+/**
+ * What a colour binding reads. The two logo colours also move with the offer
+ * they are scoped to, so they depend on that too.
+ */
+export declare function colorKeyDeps(keys: readonly string[]): Dependency[];
+export declare function valueRefDeps(ref: SduiValueRef): Dependency[];
+/** Every dependency a condition tree reads, deduplicated. */
+export declare function conditionDeps(condition: SduiCondition): Dependency[];
+//# sourceMappingURL=deps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/sdui/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,8BAA8B;AAC9B,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,yDAAyD;AACzD,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,oDAAoD;AACpD,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,0EAA0E;AAC1E,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,+DAA+D;AAC/D,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,sEAAsE;AACtE,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,sEAAsE;AACtE,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,kDAAkD;AAClD,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,KAAG,UAA4B,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,EAAE,CAQlE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,UAAU,EAAE,CAe5D;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,UAAU,EAAE,CAIpE"}

package/types/sdui/dominantColor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Reduce RGBA pixels to `#RRGGBB`, or `null` for a white or transparent logo.
+ *
+ * The pixels are premultiplied first, because Swift draws into a premultiplied
+ * context and a canvas hands back straight alpha.
+ */
+export declare function dominantHexFromPixels(data: Uint8ClampedArray): string | null;
+/**
+ * Load a logo and reduce it. Resolves `null` on every failure: a host that
+ * sends no CORS header, a decode error, a timeout, or no 2D canvas (jsdom).
+ */
+export declare function extractDominantHex(url: string, doc?: Document): Promise<string | null>;
+/** The colours already known, so a second presentation paints on frame one. */
+export declare function knownDominantColors(): Record<string, string>;
+/**
+ * Extract once per URL, and report each colour that lands.
+ *
+ * A URL that yields nothing is not cached, which is what Swift does: it tries
+ * again on the next presentation.
+ */
+export declare function requestDominantColors(urls: readonly string[], extract: (url: string) => Promise<string | null>, onColor: (url: string, hex: string) => void): void;
+/** @internal Tests only. */
+export declare function resetDominantColorsForTests(): void;
+//# sourceMappingURL=dominantColor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dominantColor.d.ts","sourceRoot":"","sources":["../../src/sdui/dominantColor.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAsE5E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,QAAmB,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuCxB;AAMD,+EAA+E;AAC/E,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAChD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1C,IAAI,CAkBN;AAED,4BAA4B;AAC5B,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

package/types/sdui/elements/confetti.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The SDUI `confetti` burst, with Swift's `ConfettiEmitterUIView` numbers: it
+ * emits `intensity` pieces a second for `duration` seconds, from a line across
+ * the top or from a point, and each piece falls for up to 7.5 seconds.
+ *
+ * The settled `scatter` layer is not drawn. No served variant uses it.
+ */
+export interface ConfettiSpec {
+    colors: readonly string[];
+    intensity: number;
+    duration: number;
+    originY: number;
+    originX: number | undefined;
+}
+interface Piece {
+    born: number;
+    life: number;
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+    spin: number;
+    rotation: number;
+    scale: number;
+    color: string;
+    round: boolean;
+}
+/** Swift's `configure` clamps, applied to the served values. */
+export declare function confettiSpec(props: Readonly<Record<string, unknown>>, color: (hex: string) => string | undefined): ConfettiSpec;
+/** Every piece the burst will emit, with its birth time in seconds. */
+export declare function emitPieces(spec: ConfettiSpec, width: number, height: number): Piece[];
+/**
+ * Draw the burst into `host` and remove the canvas when the last piece is gone.
+ * Returns a stop function. Does nothing where a canvas cannot run.
+ */
+export declare function runConfetti(host: HTMLElement, spec: ConfettiSpec): () => void;
+export {};
+//# sourceMappingURL=confetti.d.ts.map

package/types/sdui/elements/confetti.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confetti.d.ts","sourceRoot":"","sources":["../../../src/sdui/elements/confetti.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAKD,gEAAgE;AAChE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GACzC,YAAY,CAkBd;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CACxB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,KAAK,EAAE,CA+BT;AAKD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,IAAI,CA6D7E"}

package/types/sdui/elements/content.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The content elements: `text`, `systemImage`, `asyncImage`, `asyncVideo`,
+ * `appIcon`, `shape`, `gradient`, `empty`.
+ *
+ * `text` is the only one with real runtime behaviour, because it is the only
+ * one whose content can change without the tree changing. Everything else is
+ * static once compiled, which is why most of this file has no update site.
+ */
+import type { ElementRegistry } from "../compile";
+import type { SduiTextDefaults } from "../context";
+import type { RenderDeps, TriggerDeps } from "./shared";
+/** Runtime copy the host owns, read fresh on every text update. */
+export interface TextEnvironment {
+    readonly values: Readonly<Record<string, string>>;
+    readonly textMaps: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    readonly variables: Readonly<Record<string, string>>;
+    readonly defaults: SduiTextDefaults;
+}
+export interface ContentDeps extends RenderDeps {
+    /** Read on every update, so a host may swap copy without recompiling. */
+    textEnvironment(): TextEnvironment;
+    /** Trigger (inline) mounts only; a sheet has none and draws as before. */
+    readonly trigger?: TriggerDeps;
+}
+export declare function templateKeys(text: string | undefined): string[];
+export declare function registerContentElements(registry: ElementRegistry, deps: ContentDeps): ElementRegistry;
+//# sourceMappingURL=content.d.ts.map

package/types/sdui/elements/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/sdui/elements/content.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA0BnD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAMxD,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,yEAAyE;IACzE,eAAe,IAAI,eAAe,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;CAChC;AA2BD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAO/D;AA0DD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,WAAW,GAChB,eAAe,CA4gBjB"}

package/types/sdui/elements/interactive.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The interactive elements: `button`, `textField`, `toggle`, `slideButton`,
+ * `compactPageIndicator`, `confetti`.
+ *
+ * These are the elements the compile model exists for. Every one of them holds
+ * state the BROWSER owns rather than state the engine holds, so every one of
+ * them breaks under a renderer that rebuilds: a focused field loses its caret,
+ * a half-completed drag is dropped, a running confetti burst restarts.
+ */
+import type { ElementRegistry } from "../compile";
+import type { TextEnvironment } from "./content";
+import type { SduiEvaluationContext } from "../context";
+import type { ActionHost } from "../actions";
+import type { RenderDeps } from "./shared";
+export interface InteractiveDeps extends RenderDeps {
+    readonly actionHost: ActionHost;
+    /** Latest context, for an event firing long after compile. */
+    currentContext(): SduiEvaluationContext;
+    /**
+     * Report a tap. Swift reports it FIRST in `handleAction`, before the switch
+     * (`SDUIElementRenderer.swift:634`), so a tap that changes state carries the
+     * state it was made IN, and an action this build does not recognise is still
+     * counted rather than vanishing.
+     */
+    reportTap?(actionType: string, currentState: string): void;
+    /** False when the host switched claiming off. */
+    readonly claimEnabled?: boolean;
+    /** A text field's write: silent, and it clears `<key>Error`. */
+    editValue?(key: string, value: string): void;
+    /** The accessible name for a button that holds only this symbol. */
+    symbolLabel?(name: string): string | undefined;
+    /** Copy for a trigger button's `${...}` label and hint. */
+    textEnvironment?(): TextEnvironment;
+}
+export declare function registerInteractiveElements(registry: ElementRegistry, deps: InteractiveDeps): ElementRegistry;
+/**
+ * The dots Swift's `CompactPageIndicator` draws: at most five, centred on the
+ * current page, the active one a capsule, and an edge dot at half size when more
+ * pages lie beyond it. Web drew one unsized span per offer, so eighteen offers
+ * made eighteen invisible dots.
+ */
+export declare function compactWindow(total: number, current: number): {
+    index: number;
+    active: boolean;
+    width: number;
+    height: number;
+}[];
+//# sourceMappingURL=interactive.d.ts.map

package/types/sdui/elements/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../src/sdui/elements/interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,YAAY,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAW7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,8DAA8D;IAC9D,cAAc,IAAI,qBAAqB,CAAC;IACxC;;;;;OAKG;IACH,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,iDAAiD;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,gEAAgE;IAChE,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,oEAAoE;IACpE,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/C,2DAA2D;IAC3D,eAAe,CAAC,IAAI,eAAe,CAAC;CACrC;AAOD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,eAAe,GACpB,eAAe,CAyWjB;AAqJD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,CAuBrE"}

package/types/sdui/elements/layout.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The layout elements: `vStack`, `hStack`, `zStack`, `spacer`, `group`,
+ * `scrollView`.
+ *
+ * `forEach` and `conditional` are NOT here. Both change the shape of the DOM
+ * rather than the contents of one node, so both live in the compiler.
+ *
+ * Alignment is the one place SwiftUI and CSS genuinely differ. SwiftUI's
+ * `alignment` on a stack sets the CROSS axis, so `leading` on a `vStack` is
+ * horizontal and on an `hStack` is vertical. Mapping it to `align-items`
+ * without knowing the axis produces a layout that looks plausible and is wrong.
+ */
+import type { ElementRegistry } from "../compile";
+import type { RenderDeps } from "./shared";
+/**
+ * The mask for a scroller with more content before (`head`) or after (`tail`).
+ *
+ * Empty when there is nothing more either way, so a list that fits is drawn
+ * exactly as authored.
+ */
+export declare function edgeFadeMask(horizontal: boolean, head: boolean, tail: boolean): string;
+/**
+ * Bind a carousel's position to the focused offer, both ways, as Swift's
+ * `SDUICarouselPositionModifier` does with `.scrollPosition(id:)`.
+ *
+ * Neither direction existed. Tapping a side card selected it but never brought
+ * it to the centre, and swiping moved the cards while the page indicator, the
+ * CTA and the selection all stayed on the first offer.
+ */
+/**
+ * The margin that lets the first and last card reach the centre, as Swift's
+ * `SDUICenteredScrollMarginsModifier` derives it: `(viewport - card) / 2`.
+ *
+ * The template's `contentMargins` is only the fallback until both widths are
+ * known. It is sized for a phone (76 against 82 on a 375pt screen), so in the
+ * 720 desktop square the first card stopped 180px short of the centre, and sat
+ * there tilted by its own distance from it.
+ */
+export declare function centringMargin(viewport: number, card: number): number | undefined;
+export declare function registerLayoutElements(registry: ElementRegistry, deps: RenderDeps): ElementRegistry;
+//# sourceMappingURL=layout.d.ts.map

package/types/sdui/elements/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/sdui/elements/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAalD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAiQ3C;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,OAAO,GACZ,MAAM,CAOR;AAyND;;;;;;;GAOG;AACH;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAGpB;AA0VD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,UAAU,GACf,eAAe,CAwOjB"}

package/types/sdui/elements/marquee.d.ts

@@ -0,0 +1,17 @@
+/**
+ * G4 `marquee` (trigger contract §3.4): content that scrolls on a loop.
+ *
+ * The items of `content` (a `forEach`) sit in a flex track along `axis` with
+ * `spacing`. Animating, the track holds the live content plus aria-hidden
+ * copies, enough to fill the viewport plus one cycle, and a generated
+ * `@keyframes` moves it one cycle per `duration`. Static (when `animateWhen`
+ * is false, reduce motion is on, or the host pauses it before it has moved), it
+ * holds the items once, centred on the axis. Paused after it has moved, it holds
+ * its place and resumes from there.
+ *
+ * Only a trigger mount decodes `marquee`, so only it ever reaches this.
+ */
+import type { ElementRegistry } from "../compile";
+import type { RenderDeps } from "./shared";
+export declare function registerMarqueeElement(registry: ElementRegistry, deps: RenderDeps): ElementRegistry;
+//# sourceMappingURL=marquee.d.ts.map

package/types/sdui/elements/marquee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marquee.d.ts","sourceRoot":"","sources":["../../../src/sdui/elements/marquee.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAiB3C,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,UAAU,GACf,eAAe,CAmKjB"}

package/types/sdui/elements/progress.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The `progress` element (trigger vocabulary contract v1, §3.2): a capsule track
+ * with a capsule fill grown from the leading edge to the value's fraction.
+ *
+ * Registered for inline (trigger) mounts only; a sheet never decodes `progress`.
+ */
+import type { ElementRegistry } from "../compile";
+import type { RenderDeps } from "./shared";
+export declare function registerProgressElement(registry: ElementRegistry, deps: RenderDeps): ElementRegistry;
+//# sourceMappingURL=progress.d.ts.map

package/types/sdui/elements/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/sdui/elements/progress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAO3C,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,UAAU,GACf,eAAe,CA4CjB"}