@vgai/engine 0.2.0 → 0.3.0

package/dist/scene/schema/ui.d.ts

@@ -0,0 +1,880 @@
+import { z } from 'zod';
+/**
+ * A declarative binding to the game's reactive data source. The runtime resolves
+ * `source` (a dotted path, e.g. "player.health") against the UIDataSource the
+ * game provides; `mode` controls write-back for input controls (two-way / MVVM).
+ */
+export declare const UIBindingSchema: z.ZodObject<{
+    source: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+        "one-way": "one-way";
+        "two-way": "two-way";
+    }>>;
+    transform: z.ZodOptional<z.ZodString>;
+    fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>;
+export type UIBinding = z.infer<typeof UIBindingSchema>;
+export declare const UILayoutSchema: z.ZodObject<{
+    position: z.ZodOptional<z.ZodEnum<{
+        flow: "flow";
+        absolute: "absolute";
+    }>>;
+    anchor: z.ZodOptional<z.ZodObject<{
+        left: z.ZodNumber;
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+    }, z.core.$strip>>;
+    offset: z.ZodOptional<z.ZodObject<{
+        left: z.ZodNumber;
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+    }, z.core.$strip>>;
+    pivot: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    height: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    minWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    maxWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    minHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    maxHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    aspectRatio: z.ZodOptional<z.ZodNumber>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        column: "column";
+        row: "row";
+        "row-reverse": "row-reverse";
+        "column-reverse": "column-reverse";
+    }>>;
+    justify: z.ZodOptional<z.ZodEnum<{
+        start: "start";
+        center: "center";
+        end: "end";
+        "space-between": "space-between";
+        "space-around": "space-around";
+        "space-evenly": "space-evenly";
+    }>>;
+    align: z.ZodOptional<z.ZodEnum<{
+        start: "start";
+        center: "center";
+        end: "end";
+        stretch: "stretch";
+        baseline: "baseline";
+    }>>;
+    wrap: z.ZodOptional<z.ZodBoolean>;
+    gap: z.ZodOptional<z.ZodNumber>;
+    columns: z.ZodOptional<z.ZodNumber>;
+    grow: z.ZodOptional<z.ZodNumber>;
+    shrink: z.ZodOptional<z.ZodNumber>;
+    basis: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    alignSelf: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        start: "start";
+        center: "center";
+        end: "end";
+        stretch: "stretch";
+        baseline: "baseline";
+    }>>;
+    padding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    margin: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    zIndex: z.ZodOptional<z.ZodNumber>;
+    overflow: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        visible: "visible";
+        hidden: "hidden";
+        scroll: "scroll";
+    }>>;
+}, z.core.$strip>;
+export type UILayout = z.infer<typeof UILayoutSchema>;
+/**
+ * A flat style bag. Values are literal CSS-ish values OR theme-token refs
+ * ("$accent"). Kept open (record) for forward-compat, with the common authored
+ * properties documented. Numbers are treated as px where a length is expected.
+ */
+export declare const UIStyleSchema: z.ZodObject<{
+    backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    backgroundImage: z.ZodOptional<z.ZodString>;
+    backgroundSize: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    fontFamily: z.ZodOptional<z.ZodString>;
+    fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    fontStyle: z.ZodOptional<z.ZodString>;
+    textAlign: z.ZodOptional<z.ZodEnum<{
+        center: "center";
+        left: "left";
+        right: "right";
+        justify: "justify";
+    }>>;
+    lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    borderStyle: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        solid: "solid";
+        dashed: "dashed";
+        dotted: "dotted";
+    }>>;
+    boxShadow: z.ZodOptional<z.ZodString>;
+    sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    transition: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UIStyle = z.infer<typeof UIStyleSchema>;
+/** Per-state style overrides (F3): normal is the base style; these layer on top. */
+export declare const UIStateStylesSchema: z.ZodObject<{
+    hover: z.ZodOptional<z.ZodObject<{
+        backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        backgroundImage: z.ZodOptional<z.ZodString>;
+        backgroundSize: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontStyle: z.ZodOptional<z.ZodString>;
+        textAlign: z.ZodOptional<z.ZodEnum<{
+            center: "center";
+            left: "left";
+            right: "right";
+            justify: "justify";
+        }>>;
+        lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderStyle: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        boxShadow: z.ZodOptional<z.ZodString>;
+        sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        cursor: z.ZodOptional<z.ZodString>;
+        transition: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    pressed: z.ZodOptional<z.ZodObject<{
+        backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        backgroundImage: z.ZodOptional<z.ZodString>;
+        backgroundSize: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontStyle: z.ZodOptional<z.ZodString>;
+        textAlign: z.ZodOptional<z.ZodEnum<{
+            center: "center";
+            left: "left";
+            right: "right";
+            justify: "justify";
+        }>>;
+        lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderStyle: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        boxShadow: z.ZodOptional<z.ZodString>;
+        sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        cursor: z.ZodOptional<z.ZodString>;
+        transition: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    disabled: z.ZodOptional<z.ZodObject<{
+        backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        backgroundImage: z.ZodOptional<z.ZodString>;
+        backgroundSize: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontStyle: z.ZodOptional<z.ZodString>;
+        textAlign: z.ZodOptional<z.ZodEnum<{
+            center: "center";
+            left: "left";
+            right: "right";
+            justify: "justify";
+        }>>;
+        lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderStyle: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        boxShadow: z.ZodOptional<z.ZodString>;
+        sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        cursor: z.ZodOptional<z.ZodString>;
+        transition: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    focus: z.ZodOptional<z.ZodObject<{
+        backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        backgroundImage: z.ZodOptional<z.ZodString>;
+        backgroundSize: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontStyle: z.ZodOptional<z.ZodString>;
+        textAlign: z.ZodOptional<z.ZodEnum<{
+            center: "center";
+            left: "left";
+            right: "right";
+            justify: "justify";
+        }>>;
+        lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderStyle: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        boxShadow: z.ZodOptional<z.ZodString>;
+        sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        cursor: z.ZodOptional<z.ZodString>;
+        transition: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * A reusable theme/style resource (F1). `tokens` is a flat map of token name ->
+ * value referenced by style props as "$name". `variants` are named style
+ * variations of a base look (F4 / Godot type variations). Authored inline on a
+ * UI root OR as a standalone `.uitheme.json` referenced by `themeRef`.
+ */
+export declare const UIThemeSchema: z.ZodObject<{
+    name: z.ZodString;
+    tokens: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        backgroundImage: z.ZodOptional<z.ZodString>;
+        backgroundSize: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontStyle: z.ZodOptional<z.ZodString>;
+        textAlign: z.ZodOptional<z.ZodEnum<{
+            center: "center";
+            left: "left";
+            right: "right";
+            justify: "justify";
+        }>>;
+        lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderStyle: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        boxShadow: z.ZodOptional<z.ZodString>;
+        sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        cursor: z.ZodOptional<z.ZodString>;
+        transition: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type UITheme = z.infer<typeof UIThemeSchema>;
+/** Standalone theme asset file (.uitheme.json) — the chosen theme file boundary. */
+export declare const UIThemeFileSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    theme: z.ZodObject<{
+        name: z.ZodString;
+        tokens: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            backgroundImage: z.ZodOptional<z.ZodString>;
+            backgroundSize: z.ZodOptional<z.ZodString>;
+            color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+            fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontStyle: z.ZodOptional<z.ZodString>;
+            textAlign: z.ZodOptional<z.ZodEnum<{
+                center: "center";
+                left: "left";
+                right: "right";
+                justify: "justify";
+            }>>;
+            lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            opacity: z.ZodOptional<z.ZodNumber>;
+            borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderStyle: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                solid: "solid";
+                dashed: "dashed";
+                dotted: "dotted";
+            }>>;
+            boxShadow: z.ZodOptional<z.ZodString>;
+            sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            cursor: z.ZodOptional<z.ZodString>;
+            transition: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type UIThemeFile = z.infer<typeof UIThemeFileSchema>;
+/**
+ * Node kinds. Containers (canvas/box/grid/stack/scroll/panel/tab/center/wrap/
+ * aspect/sizebox) arrange children; controls (text/richtext/button/image/input/
+ * toggle/slider/dropdown/progress) are leaves; `component` references a reusable
+ * React component or a saved UI prefab.
+ */
+export declare const UINodeKindSchema: z.ZodEnum<{
+    input: "input";
+    toggle: "toggle";
+    box: "box";
+    grid: "grid";
+    center: "center";
+    wrap: "wrap";
+    scroll: "scroll";
+    canvas: "canvas";
+    stack: "stack";
+    panel: "panel";
+    aspect: "aspect";
+    sizebox: "sizebox";
+    tab: "tab";
+    text: "text";
+    richtext: "richtext";
+    button: "button";
+    image: "image";
+    slider: "slider";
+    dropdown: "dropdown";
+    progress: "progress";
+    component: "component";
+}>;
+export type UINodeKind = z.infer<typeof UINodeKindSchema>;
+/** Easing applied to the segment LEAVING a keyframe toward the next. */
+export declare const UIEasingSchema: z.ZodEnum<{
+    linear: "linear";
+    "ease-in": "ease-in";
+    "ease-out": "ease-out";
+    "ease-in-out": "ease-in-out";
+    step: "step";
+}>;
+export type UIEasing = z.infer<typeof UIEasingSchema>;
+/**
+ * The animatable properties. Curated so each maps to a GPU-friendly CSS output
+ * (transform/opacity/color/size) — animating these does not reflow per frame.
+ */
+export declare const UIAnimatablePropertySchema: z.ZodEnum<{
+    color: "color";
+    width: "width";
+    height: "height";
+    scale: "scale";
+    opacity: "opacity";
+    backgroundColor: "backgroundColor";
+    translateX: "translateX";
+    translateY: "translateY";
+    rotate: "rotate";
+}>;
+export type UIAnimatableProperty = z.infer<typeof UIAnimatablePropertySchema>;
+/** A single keyframe: a value at a time (seconds), with the easing leaving it. */
+export declare const UIKeyframeSchema: z.ZodObject<{
+    time: z.ZodNumber;
+    value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    easing: z.ZodOptional<z.ZodEnum<{
+        linear: "linear";
+        "ease-in": "ease-in";
+        "ease-out": "ease-out";
+        "ease-in-out": "ease-in-out";
+        step: "step";
+    }>>;
+}, z.core.$strip>;
+export type UIKeyframe = z.infer<typeof UIKeyframeSchema>;
+/** A track animates ONE property via an ordered list of keyframes (S1). */
+export declare const UITrackSchema: z.ZodObject<{
+    property: z.ZodEnum<{
+        color: "color";
+        width: "width";
+        height: "height";
+        scale: "scale";
+        opacity: "opacity";
+        backgroundColor: "backgroundColor";
+        translateX: "translateX";
+        translateY: "translateY";
+        rotate: "rotate";
+    }>;
+    keyframes: z.ZodArray<z.ZodObject<{
+        time: z.ZodNumber;
+        value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+        easing: z.ZodOptional<z.ZodEnum<{
+            linear: "linear";
+            "ease-in": "ease-in";
+            "ease-out": "ease-out";
+            "ease-in-out": "ease-in-out";
+            step: "step";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UITrack = z.infer<typeof UITrackSchema>;
+/** A named animation clip: multiple tracks (multi-property), duration, loop (S1). */
+declare const UIAnimationBase: z.ZodObject<{
+    name: z.ZodString;
+    duration: z.ZodNumber;
+    loop: z.ZodOptional<z.ZodBoolean>;
+    autoplay: z.ZodOptional<z.ZodBoolean>;
+    playOnEvent: z.ZodOptional<z.ZodString>;
+    tracks: z.ZodArray<z.ZodObject<{
+        property: z.ZodEnum<{
+            color: "color";
+            width: "width";
+            height: "height";
+            scale: "scale";
+            opacity: "opacity";
+            backgroundColor: "backgroundColor";
+            translateX: "translateX";
+            translateY: "translateY";
+            rotate: "rotate";
+        }>;
+        keyframes: z.ZodArray<z.ZodObject<{
+            time: z.ZodNumber;
+            value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+            easing: z.ZodOptional<z.ZodEnum<{
+                linear: "linear";
+                "ease-in": "ease-in";
+                "ease-out": "ease-out";
+                "ease-in-out": "ease-in-out";
+                step: "step";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const UIAnimationSchema: z.ZodObject<{
+    name: z.ZodString;
+    duration: z.ZodNumber;
+    loop: z.ZodOptional<z.ZodBoolean>;
+    autoplay: z.ZodOptional<z.ZodBoolean>;
+    playOnEvent: z.ZodOptional<z.ZodString>;
+    tracks: z.ZodArray<z.ZodObject<{
+        property: z.ZodEnum<{
+            color: "color";
+            width: "width";
+            height: "height";
+            scale: "scale";
+            opacity: "opacity";
+            backgroundColor: "backgroundColor";
+            translateX: "translateX";
+            translateY: "translateY";
+            rotate: "rotate";
+        }>;
+        keyframes: z.ZodArray<z.ZodObject<{
+            time: z.ZodNumber;
+            value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+            easing: z.ZodOptional<z.ZodEnum<{
+                linear: "linear";
+                "ease-in": "ease-in";
+                "ease-out": "ease-out";
+                "ease-in-out": "ease-in-out";
+                step: "step";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UIAnimation = z.infer<typeof UIAnimationBase>;
+/**
+ * Recursive UI node. Typed via z.lazy like SceneEntity. `children` nest the tree.
+ */
+export type UINode = z.infer<typeof UINodeBase> & {
+    children?: UINode[] | undefined;
+};
+declare const UINodeBase: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    kind: z.ZodEnum<{
+        input: "input";
+        toggle: "toggle";
+        box: "box";
+        grid: "grid";
+        center: "center";
+        wrap: "wrap";
+        scroll: "scroll";
+        canvas: "canvas";
+        stack: "stack";
+        panel: "panel";
+        aspect: "aspect";
+        sizebox: "sizebox";
+        tab: "tab";
+        text: "text";
+        richtext: "richtext";
+        button: "button";
+        image: "image";
+        slider: "slider";
+        dropdown: "dropdown";
+        progress: "progress";
+        component: "component";
+    }>;
+    visible: z.ZodOptional<z.ZodBoolean>;
+    locked: z.ZodOptional<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    layout: z.ZodOptional<z.ZodObject<{
+        position: z.ZodOptional<z.ZodEnum<{
+            flow: "flow";
+            absolute: "absolute";
+        }>>;
+        anchor: z.ZodOptional<z.ZodObject<{
+            left: z.ZodNumber;
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+        }, z.core.$strip>>;
+        offset: z.ZodOptional<z.ZodObject<{
+            left: z.ZodNumber;
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+        }, z.core.$strip>>;
+        pivot: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        height: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        minWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        maxWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        minHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        maxHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        aspectRatio: z.ZodOptional<z.ZodNumber>;
+        direction: z.ZodOptional<z.ZodEnum<{
+            column: "column";
+            row: "row";
+            "row-reverse": "row-reverse";
+            "column-reverse": "column-reverse";
+        }>>;
+        justify: z.ZodOptional<z.ZodEnum<{
+            start: "start";
+            center: "center";
+            end: "end";
+            "space-between": "space-between";
+            "space-around": "space-around";
+            "space-evenly": "space-evenly";
+        }>>;
+        align: z.ZodOptional<z.ZodEnum<{
+            start: "start";
+            center: "center";
+            end: "end";
+            stretch: "stretch";
+            baseline: "baseline";
+        }>>;
+        wrap: z.ZodOptional<z.ZodBoolean>;
+        gap: z.ZodOptional<z.ZodNumber>;
+        columns: z.ZodOptional<z.ZodNumber>;
+        grow: z.ZodOptional<z.ZodNumber>;
+        shrink: z.ZodOptional<z.ZodNumber>;
+        basis: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        alignSelf: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            start: "start";
+            center: "center";
+            end: "end";
+            stretch: "stretch";
+            baseline: "baseline";
+        }>>;
+        padding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        margin: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        zIndex: z.ZodOptional<z.ZodNumber>;
+        overflow: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            visible: "visible";
+            hidden: "hidden";
+            scroll: "scroll";
+        }>>;
+    }, z.core.$strip>>;
+    style: z.ZodOptional<z.ZodObject<{
+        backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        backgroundImage: z.ZodOptional<z.ZodString>;
+        backgroundSize: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        fontStyle: z.ZodOptional<z.ZodString>;
+        textAlign: z.ZodOptional<z.ZodEnum<{
+            center: "center";
+            left: "left";
+            right: "right";
+            justify: "justify";
+        }>>;
+        lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        borderStyle: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            solid: "solid";
+            dashed: "dashed";
+            dotted: "dotted";
+        }>>;
+        boxShadow: z.ZodOptional<z.ZodString>;
+        sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        cursor: z.ZodOptional<z.ZodString>;
+        transition: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    states: z.ZodOptional<z.ZodObject<{
+        hover: z.ZodOptional<z.ZodObject<{
+            backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            backgroundImage: z.ZodOptional<z.ZodString>;
+            backgroundSize: z.ZodOptional<z.ZodString>;
+            color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+            fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontStyle: z.ZodOptional<z.ZodString>;
+            textAlign: z.ZodOptional<z.ZodEnum<{
+                center: "center";
+                left: "left";
+                right: "right";
+                justify: "justify";
+            }>>;
+            lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            opacity: z.ZodOptional<z.ZodNumber>;
+            borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderStyle: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                solid: "solid";
+                dashed: "dashed";
+                dotted: "dotted";
+            }>>;
+            boxShadow: z.ZodOptional<z.ZodString>;
+            sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            cursor: z.ZodOptional<z.ZodString>;
+            transition: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        pressed: z.ZodOptional<z.ZodObject<{
+            backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            backgroundImage: z.ZodOptional<z.ZodString>;
+            backgroundSize: z.ZodOptional<z.ZodString>;
+            color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+            fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontStyle: z.ZodOptional<z.ZodString>;
+            textAlign: z.ZodOptional<z.ZodEnum<{
+                center: "center";
+                left: "left";
+                right: "right";
+                justify: "justify";
+            }>>;
+            lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            opacity: z.ZodOptional<z.ZodNumber>;
+            borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderStyle: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                solid: "solid";
+                dashed: "dashed";
+                dotted: "dotted";
+            }>>;
+            boxShadow: z.ZodOptional<z.ZodString>;
+            sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            cursor: z.ZodOptional<z.ZodString>;
+            transition: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        disabled: z.ZodOptional<z.ZodObject<{
+            backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            backgroundImage: z.ZodOptional<z.ZodString>;
+            backgroundSize: z.ZodOptional<z.ZodString>;
+            color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+            fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontStyle: z.ZodOptional<z.ZodString>;
+            textAlign: z.ZodOptional<z.ZodEnum<{
+                center: "center";
+                left: "left";
+                right: "right";
+                justify: "justify";
+            }>>;
+            lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            opacity: z.ZodOptional<z.ZodNumber>;
+            borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderStyle: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                solid: "solid";
+                dashed: "dashed";
+                dotted: "dotted";
+            }>>;
+            boxShadow: z.ZodOptional<z.ZodString>;
+            sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            cursor: z.ZodOptional<z.ZodString>;
+            transition: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        focus: z.ZodOptional<z.ZodObject<{
+            backgroundColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            backgroundImage: z.ZodOptional<z.ZodString>;
+            backgroundSize: z.ZodOptional<z.ZodString>;
+            color: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontFamily: z.ZodOptional<z.ZodString>;
+            fontWeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            fontStyle: z.ZodOptional<z.ZodString>;
+            textAlign: z.ZodOptional<z.ZodEnum<{
+                center: "center";
+                left: "left";
+                right: "right";
+                justify: "justify";
+            }>>;
+            lineHeight: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            opacity: z.ZodOptional<z.ZodNumber>;
+            borderRadius: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderColor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            borderStyle: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                solid: "solid";
+                dashed: "dashed";
+                dotted: "dotted";
+            }>>;
+            boxShadow: z.ZodOptional<z.ZodString>;
+            sliceInset: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            cursor: z.ZodOptional<z.ZodString>;
+            transition: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    variant: z.ZodOptional<z.ZodString>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodNumber>, z.ZodObject<{
+        $bind: z.ZodObject<{
+            source: z.ZodString;
+            mode: z.ZodOptional<z.ZodEnum<{
+                "one-way": "one-way";
+                "two-way": "two-way";
+            }>>;
+            transform: z.ZodOptional<z.ZodString>;
+            fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>]>>>;
+    bindings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        source: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<{
+            "one-way": "one-way";
+            "two-way": "two-way";
+        }>>;
+        transform: z.ZodOptional<z.ZodString>;
+        fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>>>;
+    events: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    component: z.ZodOptional<z.ZodString>;
+    repeat: z.ZodOptional<z.ZodObject<{
+        items: z.ZodObject<{
+            source: z.ZodString;
+            mode: z.ZodOptional<z.ZodEnum<{
+                "one-way": "one-way";
+                "two-way": "two-way";
+            }>>;
+            transform: z.ZodOptional<z.ZodString>;
+            fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        }, z.core.$strip>;
+        as: z.ZodString;
+        keyPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    animations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        duration: z.ZodNumber;
+        loop: z.ZodOptional<z.ZodBoolean>;
+        autoplay: z.ZodOptional<z.ZodBoolean>;
+        playOnEvent: z.ZodOptional<z.ZodString>;
+        tracks: z.ZodArray<z.ZodObject<{
+            property: z.ZodEnum<{
+                color: "color";
+                width: "width";
+                height: "height";
+                scale: "scale";
+                opacity: "opacity";
+                backgroundColor: "backgroundColor";
+                translateX: "translateX";
+                translateY: "translateY";
+                rotate: "rotate";
+            }>;
+            keyframes: z.ZodArray<z.ZodObject<{
+                time: z.ZodNumber;
+                value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+                easing: z.ZodOptional<z.ZodEnum<{
+                    linear: "linear";
+                    "ease-in": "ease-in";
+                    "ease-out": "ease-out";
+                    "ease-in-out": "ease-in-out";
+                    step: "step";
+                }>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const UINodeSchema: z.ZodType<UINode>;
+/** Responsive scaling config for a UI root (I1/I2). */
+declare const UIScalingSchema: z.ZodObject<{
+    referenceWidth: z.ZodNumber;
+    referenceHeight: z.ZodNumber;
+    mode: z.ZodOptional<z.ZodEnum<{
+        "scale-with-size": "scale-with-size";
+        "constant-pixel": "constant-pixel";
+        "constant-physical": "constant-physical";
+    }>>;
+    aspect: z.ZodOptional<z.ZodEnum<{
+        expand: "expand";
+        keep: "keep";
+        "keep-width": "keep-width";
+        "keep-height": "keep-height";
+    }>>;
+    match: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * A UI root — a canvas placed screen-space or screen-tracked to a 3D entity (A3).
+ * Carries the responsive scaling config and an optional inline theme / theme ref.
+ */
+export declare const UIRootSchema: z.ZodType<UIRoot>;
+export type UIRoot = z.infer<typeof UINodeBase> & {
+    kind: 'canvas';
+    space?: 'screen' | 'world-tracked' | undefined;
+    trackEntity?: string | undefined;
+    scaling?: z.infer<typeof UIScalingSchema> | undefined;
+    theme?: UITheme | undefined;
+    themeRef?: string | undefined;
+    locale?: string | undefined;
+    children?: UINode[] | undefined;
+};
+/**
+ * A saved reusable UI prefab/component (H1). Mirrors PrefabFile but for a UI
+ * subtree, with declared exposed props/slots (H3).
+ */
+export declare const UIPrefabFileSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    name: z.ZodString;
+    root: z.ZodType<UINode, unknown, z.core.$ZodTypeInternals<UINode, unknown>>;
+    exposedProps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type UIPrefabFile = z.infer<typeof UIPrefabFileSchema>;
+export {};
+//# sourceMappingURL=ui.d.ts.map