@encorekit/web-sdk 2.2.1 → 2.4.0

package/types/sdui/actions.d.ts

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

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

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

package/types/sdui/bindings.d.ts

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

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

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

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