@encorekit/web-sdk 2.2.1 → 2.4.0

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

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