@encorekit/web-sdk 2.3.0 → 2.4.0

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

@@ -0,0 +1,138 @@
+/**
+ * What every element renderer does with style, in one place.
+ *
+ * Applying CSS is only half of it. `planStyle` hands back structural intents
+ * that are not declarations: `overlay` and `backgroundElement` are child NODES,
+ * and both need a positioned wrapper. Doing that per renderer is how one of
+ * them ends up quietly unimplemented on a single element.
+ */
+import type { CompileServices, Rendered } from "../compile";
+import type { SduiEvaluationContext } from "../context";
+import type { SduiNode } from "../model";
+import type { ColorResolver } from "../style";
+import type { MotionSheet } from "../motion";
+import type { TriggerKit } from "../triggerKit";
+/** What a trigger (inline) mount adds; a sheet has none. */
+export interface TriggerDeps {
+    /** Multiplies every text font size (`maxFontScale` already applied). */
+    readonly fontScale: number;
+    /** The trigger-only engine code, loaded with the trigger chunk (`triggerKit.ts`). */
+    readonly kit: TriggerKit;
+    /** This look's text `scaleGroup`s (one per mount): members shrink by one shared factor. */
+    readonly scaleGroups: InstanceType<TriggerKit["ScaleGroups"]>;
+}
+/** Injected once by the host, so renderers stay free of theme knowledge. */
+export interface RenderDeps {
+    readonly color: ColorResolver;
+    /** Present only in a trigger (inline) mount, where the trigger vocabulary renders. */
+    readonly trigger?: TriggerDeps;
+    /** Trigger mounts only: where `style.loop` and `marquee` keyframes go. */
+    readonly motion?: MotionSheet;
+}
+/**
+ * Resolve a colour operand now, and again whenever a key it binds moves.
+ *
+ * A `binding` colour resolves at RENDER time. Only `fillColor` and
+ * `highlightColor` ever passed `values`, so every other colour in the vocabulary
+ * resolved once with none and painted its fallback for ever.
+ */
+export declare function bindColor(operand: unknown, ctx: SduiEvaluationContext, services: CompileServices, deps: RenderDeps, apply: (css: string | undefined) => void): void;
+/** The layout properties a parent hands to a child. */
+export type ChildFill = Partial<Record<"alignSelf" | "justifySelf" | "flexGrow" | "flexShrink" | "flexBasis" | "minWidth" | "minHeight" | "maxWidth" | "maxHeight" | "marginInline" | "width" | "height" | "zIndex" | "gridArea" | "pointerEvents" | "scrollSnapAlign", string>>;
+/**
+ * Give a child a layout property, THROUGH any `display: contents` wrapper.
+ *
+ * A `conditional` and a `forEach` compile to a wrapper with no box, so a
+ * property set on one does nothing: the branch or the row is the real flex or
+ * grid item. The wrapper carries the intent instead, and re-applies it to
+ * whatever it mounts, because a conditional swaps branches and a `forEach`
+ * builds rows long after this runs.
+ *
+ * This is why the offer rows stayed three different widths after the stacks
+ * started handing out the fill: every one of them sits behind a `forEach` host.
+ */
+export declare function setChildFill(el: HTMLElement, fill: ChildFill): void;
+export declare function readChildFill(el: HTMLElement): ChildFill;
+/** Pass a host's carried fill to a node it has just mounted. */
+export declare function inheritChildFill(host: HTMLElement, mounted: Node): void;
+export declare function applyCss(el: HTMLElement, css: Readonly<Record<string, string>>): void;
+/**
+ * Apply a node's style to `el`, mounting any structural intent.
+ *
+ * The overlay and background wrappers make `el` a positioning context. That is
+ * a real layout change, so it happens ONLY when an intent is present.
+ */
+export declare function applyNodeStyle(el: HTMLElement, node: SduiNode, ctx: SduiEvaluationContext, services: CompileServices, deps: RenderDeps): void;
+/**
+ * Whether this subtree holds a `spacer` that is greedy on the HORIZONTAL axis.
+ *
+ * Only an `hStack`'s spacer is: in a `vStack` a spacer eats height instead. The
+ * greed propagates up, because the space a spacer claims is space its ancestors
+ * had to be offered first. An explicit `frame.width` stops it, since that is the
+ * author fixing the size.
+ */
+export declare function hasGreedySpacer(node: SduiNode, depth?: number): boolean;
+/**
+ * What this child asks to fill, looking THROUGH the wrappers that have no box.
+ *
+ * A `conditional` and a `forEach` compile to `display: contents`, so the node
+ * the parent sees carries no frame of its own: the intent is on the branch or
+ * the row template inside it. Reading only the wrapper's own style missed every
+ * one of them, which is most of this variant. The thank-you column asks for
+ * `maxHeight: .infinity` from inside a `conditional`, so it never filled the
+ * sheet and the spacers that should push the buttons to the bottom stayed flat.
+ *
+ * An explicit `frame.width` is the author fixing the size, so it wins.
+ */
+export declare function fillIntent(node: SduiNode, depth?: number): {
+    wide: boolean;
+    tall: boolean;
+};
+/**
+ * Elements whose own size is their single child's, so the intent is inside.
+ *
+ * The bottom sheet's dim backdrop is a `button` wrapping a rectangle that asks
+ * for both infinities, so reading only the button gave it no height and the
+ * screen behind the sheet was never dimmed.
+ */
+export declare const PASSTHROUGH: Set<string>;
+/**
+ * Hand a single-content container's fill to the content it holds.
+ *
+ * Only a stack hands out fill, and a `button` is not a stack, so the sheet's
+ * dim backdrop stretched to the screen while the rectangle inside it stayed
+ * 0px high and nothing was dimmed. Applied only when the content asks, so an
+ * ordinary button keeps the layout it had.
+ */
+export declare function applyContentFill(el: HTMLElement, node: SduiNode): void;
+/** A container element with its children compiled in order. */
+export declare function container(tag: string, node: SduiNode, ctx: SduiEvaluationContext, services: CompileServices, deps: RenderDeps): {
+    el: HTMLElement;
+    rendered: Rendered;
+};
+declare const rec: (v: unknown) => Record<string, unknown> | undefined;
+/**
+ * A gradient stroke drawn OVER the element, as Swift's `strokeBorder` overlay
+ * is: the element keeps its background and its size. A masked child rather than
+ * a border, because CSS has no gradient border that follows a radius.
+ */
+declare function applyGradientBorder(el: HTMLElement, raw: Record<string, unknown>, deps: RenderDeps, ctx: SduiEvaluationContext): void;
+/**
+ * Scroll-driven transforms.
+ *
+ * Compose hands Android `phase` and `centerDistance` from its scroll state; the
+ * DOM hands us neither, so both are computed from geometry here. The arithmetic
+ * itself is `scrollMath`, ported from Android, which until now was imported by
+ * nothing but its own test.
+ */
+declare function attachScrollEffects(el: HTMLElement, transition: Record<string, unknown>, faded: {
+    opacity: number;
+}): () => void;
+export { applyGradientBorder, attachScrollEffects, rec };
+/**
+ * Collapse a `group` whose content renders nothing, and restore it when content
+ * returns. Swift styles a SwiftUI `Group`, whose modifiers vanish with an
+ * `EmptyView`, so an empty `maxHeight: infinity` group took no space on iOS.
+ */
+export declare function syncGroupVacancy(from: Element | null): void;
+//# sourceMappingURL=shared.d.ts.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * The SF Symbols a variant may reference.
+ *
+ * SF Symbols are an Apple font with no web equivalent, so each one used by a
+ * shipped variant is drawn here as inline SVG. The set is exactly the eleven
+ * that appear across every checked-in variant, matching Android's
+ * `SduiSymbol.kt`, plus the three the trigger vocabulary adds: a deliberately
+ * small CLOSED set, because each addition is bytes in every host page.
+ *
+ * 🔴 THESE ARE APPROXIMATIONS AND NEED DESIGN SIGN-OFF. They are simple
+ * geometric stand-ins drawn to the same 24x24 box and stroke weight, not
+ * reproductions of Apple's artwork, which is not ours to copy. Parity of
+ * MEANING is the bar they meet today; parity of appearance is a design pass
+ * that has not happened. An unknown name renders nothing rather than a
+ * placeholder glyph, because a wrong icon reads as a bug and a missing one
+ * reads as an empty slot.
+ */
+/** Wire name to SVG body, drawn in a 0 0 24 24 box. */
+export declare const SF_SYMBOLS: Readonly<Record<string, string>>;
+/** An unknown symbol renders nothing. A wrong icon is worse than none. */
+export declare function symbolSvg(name: unknown, size: number): string | undefined;
+//# sourceMappingURL=symbols.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/sdui/elements/symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAkBH,uDAAuD;AACvD,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BvD,CAAC;AAQF,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE"}

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

@@ -0,0 +1,55 @@
+/**
+ * The trigger-only text treatments: a ticking countdown and one-line shrink to fit.
+ * Part of the trigger kit (`../triggerKit.ts`), loaded with the trigger chunk on first
+ * mount, so a page that only shows sheets never downloads them.
+ */
+import type { SduiEvaluationContext } from "../context";
+import type { Dependency } from "../deps";
+import type { ContentDeps } from "./content";
+/**
+ * A `text.countdown` (trigger mounts): the time left to a host time key, in the
+ * countdown's `format`, re-rendered whenever the clock or the keys move. The
+ * `units` are `${...}` text, resolved as any text is.
+ */
+export declare function countdownText(el: HTMLElement, countdown: Readonly<Record<string, unknown>>, deps: ContentDeps): {
+    node: Node;
+    deps: Dependency[];
+    update(c: SduiEvaluationContext): void;
+};
+/**
+ * Trigger vocabulary `minimumScaleFactor` (0.5..1) on a one-line text: shrink the font
+ * to fit the width before truncating, never below the factor, then the line clamp
+ * ellipsizes. Measured with wrapping off, from the authored size each time, so a
+ * string that gets shorter grows back. Refits when the element's box changes size
+ * (e.g. once it is attached). Undefined when it does not apply.
+ */
+export declare function oneLineFit(el: HTMLElement, props: Readonly<Record<string, unknown>>): (() => void) | undefined;
+/**
+ * The widest text a countdown format can show, so a scale group measures its countdown
+ * the same at every tick ("88:88" for hoursMinutes). Empty for a format whose width
+ * follows its words (`largestUnit`): that member is measured as shown.
+ */
+export declare function widestCountdownText(format: unknown): string;
+/**
+ * What a countdown member is measured at: the format's widest sample, or the shown text with every
+ * digit at its widest when that is longer (a reminder window past 99 hours shows three hour digits,
+ * "719:59:59", which the two-digit sample would under-measure).
+ */
+export declare function countdownMeasureText(sample: string, shown: string | null): string;
+/**
+ * Text `scaleGroup`s of one look: every member shrinks by one shared factor, the smallest
+ * any member needs to fit (each over its own lineLimit; a countdown at its widest text),
+ * never below the members' minimumScaleFactor, and keeps its own font size times that
+ * factor. A member that still does not fit truncates. Refits when a member's space or
+ * text changes.
+ */
+export declare class ScaleGroups {
+    #private;
+    /**
+     * Add `el` (its font size already set) to `group`. `countdownFormat`: the member is a
+     * countdown in that format. Returns the call that refits the whole group.
+     */
+    join(group: string, el: HTMLElement, props: Readonly<Record<string, unknown>>, countdownFormat?: unknown): () => void;
+    fit(group: string): void;
+}
+//# sourceMappingURL=triggerText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triggerText.d.ts","sourceRoot":"","sources":["../../../src/sdui/elements/triggerText.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAW7C;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC5C,IAAI,EAAE,WAAW,GAChB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,CAAC,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAA;CAAE,CAuB5E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CA+B1B;AAqBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAa3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGjF;AAyCD;;;;;;GAMG;AACH,qBAAa,WAAW;;IAGtB;;;OAGG;IACH,IAAI,CACF,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,eAAe,CAAC,EAAE,OAAO,GACxB,MAAM,IAAI;IA8Bb,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CA4CzB"}

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"}