@codexo/exojs 0.12.0 → 0.14.0

package/dist/esm/core/serialization/serializerHelpers.js

@@ -0,0 +1,161 @@
+import { Color } from '../Color.js';
+import { readNumber, readEnum, readBoolean, FONT_WEIGHTS, TEXT_ALIGNMENTS } from './read.js';
+
+// ── Options bags ───────────────────────────────────────────────────────────────
+/**
+ * Return a shallow copy of `options` with every `undefined`-valued key removed,
+ * so an optional property is *omitted* rather than set to `undefined`. Lets a
+ * deserializer build an options bag from sparse JSON without forcing a default
+ * past a constructor's own `?? default` (and stays valid under
+ * `exactOptionalPropertyTypes`).
+ */
+function compact(options) {
+    const out = {};
+    for (const [key, value] of Object.entries(options)) {
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+// ── Colour ───────────────────────────────────────────────────────────────────
+/** Serialize a colour to `[r, g, b, a]` (r/g/b 0..255, a 0..1). */
+const colorToArray = (color) => [color.r, color.g, color.b, color.a];
+/** Deserialize a `[r, g, b, a]` tuple back to a {@link Color}, or `undefined`. */
+const arrayToColor = (value) => Array.isArray(value) && value.length === 4 ? new Color(Number(value[0]), Number(value[1]), Number(value[2]), Number(value[3])) : undefined;
+const colorEquals = (color, r, g, b, a) => color.r === r && color.g === g && color.b === b && color.a === a;
+// ── TextStyle ────────────────────────────────────────────────────────────────
+/** Serialize the plain-data fields of a {@link TextStyle}, omitting defaults. */
+function serializeStyle(style) {
+    const out = {};
+    if (style.fontFamily !== 'Arial')
+        out.fontFamily = style.fontFamily;
+    if (style.fontWeight !== 'normal')
+        out.fontWeight = style.fontWeight;
+    if (style.fontStyle !== 'normal')
+        out.fontStyle = style.fontStyle;
+    if (style.fontSize !== 20)
+        out.fontSize = style.fontSize;
+    if (!colorEquals(style.fillColor, 255, 255, 255, 1))
+        out.fillColor = colorToArray(style.fillColor);
+    if (!colorEquals(style.outlineColor, 0, 0, 0, 1))
+        out.outlineColor = colorToArray(style.outlineColor);
+    if (style.outlineWidth !== 0)
+        out.outlineWidth = style.outlineWidth;
+    if (style.align !== 'left')
+        out.align = style.align;
+    if (style.lineHeight !== 1.2)
+        out.lineHeight = style.lineHeight;
+    if (style.leading !== 0)
+        out.leading = style.leading;
+    if (!colorEquals(style.shadowColor, 0, 0, 0, 1))
+        out.shadowColor = colorToArray(style.shadowColor);
+    if (style.shadowOffsetX !== 0)
+        out.shadowOffsetX = style.shadowOffsetX;
+    if (style.shadowOffsetY !== 0)
+        out.shadowOffsetY = style.shadowOffsetY;
+    if (style.shadowAlpha !== 0)
+        out.shadowAlpha = style.shadowAlpha;
+    if (style.shadowBlur !== 0)
+        out.shadowBlur = style.shadowBlur;
+    if (style.gradientColors !== null) {
+        out.gradientColors = [colorToArray(style.gradientColors[0]), colorToArray(style.gradientColors[1])];
+    }
+    if (style.gradientAxis !== 'vertical')
+        out.gradientAxis = style.gradientAxis;
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/** Rebuild {@link TextStyleOptions} from serialized style data, or `undefined`. */
+function deserializeStyleOptions(data) {
+    if (typeof data !== 'object' || data === null) {
+        return undefined;
+    }
+    const source = data;
+    const options = {};
+    if (typeof source.fontFamily === 'string')
+        options.fontFamily = source.fontFamily;
+    const fontWeight = readEnum(source, 'fontWeight', FONT_WEIGHTS);
+    if (fontWeight !== undefined)
+        options.fontWeight = fontWeight;
+    if (source.fontStyle === 'italic' || source.fontStyle === 'normal')
+        options.fontStyle = source.fontStyle;
+    if (typeof source.fontSize === 'number')
+        options.fontSize = source.fontSize;
+    const fillColor = arrayToColor(source.fillColor);
+    if (fillColor !== undefined)
+        options.fillColor = fillColor;
+    const outlineColor = arrayToColor(source.outlineColor);
+    if (outlineColor !== undefined)
+        options.outlineColor = outlineColor;
+    if (typeof source.outlineWidth === 'number')
+        options.outlineWidth = source.outlineWidth;
+    const align = readEnum(source, 'align', TEXT_ALIGNMENTS);
+    if (align !== undefined)
+        options.align = align;
+    if (typeof source.lineHeight === 'number')
+        options.lineHeight = source.lineHeight;
+    if (typeof source.leading === 'number')
+        options.leading = source.leading;
+    const shadowColor = arrayToColor(source.shadowColor);
+    if (shadowColor !== undefined)
+        options.shadowColor = shadowColor;
+    if (typeof source.shadowOffsetX === 'number')
+        options.shadowOffsetX = source.shadowOffsetX;
+    if (typeof source.shadowOffsetY === 'number')
+        options.shadowOffsetY = source.shadowOffsetY;
+    if (typeof source.shadowAlpha === 'number')
+        options.shadowAlpha = source.shadowAlpha;
+    if (typeof source.shadowBlur === 'number')
+        options.shadowBlur = source.shadowBlur;
+    if (Array.isArray(source.gradientColors) && source.gradientColors.length === 2) {
+        const top = arrayToColor(source.gradientColors[0]);
+        const bottom = arrayToColor(source.gradientColors[1]);
+        if (top !== undefined && bottom !== undefined) {
+            options.gradientColors = [top, bottom];
+        }
+    }
+    if (source.gradientAxis === 'horizontal' || source.gradientAxis === 'vertical') {
+        options.gradientAxis = source.gradientAxis;
+    }
+    return options;
+}
+// ── LayoutOptions ─────────────────────────────────────────────────────────────
+const OVERFLOWS = ['visible', 'clip', 'ellipsis'];
+const DIRECTIONS = ['ltr', 'rtl'];
+const WHITE_SPACES = ['normal', 'pre', 'pre-line'];
+/**
+ * Rebuild {@link LayoutOptions} from a serialized layout object, dropping
+ * unknown or mistyped fields. Returns `undefined` when nothing valid remains,
+ * so a corrupt `layout` value degrades to the node's constructor defaults.
+ */
+function readLayoutOptions(value) {
+    if (typeof value !== 'object' || value === null) {
+        return undefined;
+    }
+    const source = value;
+    const out = {};
+    const maxWidth = readNumber(source, 'maxWidth');
+    if (maxWidth !== undefined)
+        out.maxWidth = maxWidth;
+    const maxHeight = readNumber(source, 'maxHeight');
+    if (maxHeight !== undefined)
+        out.maxHeight = maxHeight;
+    const overflow = readEnum(source, 'overflow', OVERFLOWS);
+    if (overflow !== undefined)
+        out.overflow = overflow;
+    const letterSpacing = readNumber(source, 'letterSpacing');
+    if (letterSpacing !== undefined)
+        out.letterSpacing = letterSpacing;
+    const direction = readEnum(source, 'direction', DIRECTIONS);
+    if (direction !== undefined)
+        out.direction = direction;
+    const breakWords = readBoolean(source, 'breakWords');
+    if (breakWords !== undefined)
+        out.breakWords = breakWords;
+    const whiteSpace = readEnum(source, 'whiteSpace', WHITE_SPACES);
+    if (whiteSpace !== undefined)
+        out.whiteSpace = whiteSpace;
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+
+export { arrayToColor, colorToArray, compact, deserializeStyleOptions, readLayoutOptions, serializeStyle };
+//# sourceMappingURL=serializerHelpers.js.map

package/dist/esm/core/serialization/serializerHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializerHelpers.js","sources":["../../../../../src/core/serialization/serializerHelpers.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAMA;AAEA;;;;;;AAMG;AACG,SAAU,OAAO,CAAmB,OAAU,EAAA;IAClD,MAAM,GAAG,GAA4B,EAAE;AAEvC,IAAA,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QAClD,IAAI,KAAK,KAAK,SAAS;AAAE,YAAA,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK;IAC3C;AAEA,IAAA,OAAO,GAAmD;AAC5D;AAEA;AAEA;AACO,MAAM,YAAY,GAAG,CAAC,KAAY,KAAuC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAEnH;AACO,MAAM,YAAY,GAAG,CAAC,KAAc,KACzC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;AAEnI,MAAM,WAAW,GAAG,CAAC,KAAY,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,KAAc,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC;AAE3J;AAEA;AACM,SAAU,cAAc,CAAC,KAkB9B,EAAA;IACC,MAAM,GAAG,GAA4B,EAAE;AAEvC,IAAA,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO;AAAE,QAAA,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU;AACnE,IAAA,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ;AAAE,QAAA,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU;AACpE,IAAA,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ;AAAE,QAAA,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS;AACjE,IAAA,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE;AAAE,QAAA,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ;AACxD,IAAA,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAAE,GAAG,CAAC,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC;AAClG,IAAA,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAAE,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC;AACrG,IAAA,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC;AAAE,QAAA,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY;AACnE,IAAA,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM;AAAE,QAAA,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK;AACnD,IAAA,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG;AAAE,QAAA,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU;AAC/D,IAAA,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC;AAAE,QAAA,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO;AACpD,IAAA,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAAE,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC;AAClG,IAAA,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC;AAAE,QAAA,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa;AACtE,IAAA,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC;AAAE,QAAA,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa;AACtE,IAAA,IAAI,KAAK,CAAC,WAAW,KAAK,CAAC;AAAE,QAAA,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW;AAChE,IAAA,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC;AAAE,QAAA,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU;AAE7D,IAAA,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI,EAAE;QACjC,GAAG,CAAC,cAAc,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACrG;AAEA,IAAA,IAAI,KAAK,CAAC,YAAY,KAAK,UAAU;AAAE,QAAA,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY;AAE5E,IAAA,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,GAAG,GAAG,SAAS;AACtD;AAEA;AACM,SAAU,uBAAuB,CAAC,IAAa,EAAA;IACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE;AAC7C,QAAA,OAAO,SAAS;IAClB;IAEA,MAAM,MAAM,GAAG,IAA+B;IAC9C,MAAM,OAAO,GAAqB,EAAE;AAEpC,IAAA,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU;IAEjF,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC;IAC/D,IAAI,UAAU,KAAK,SAAS;AAAE,QAAA,OAAO,CAAC,UAAU,GAAG,UAAU;IAE7D,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS;AACxG,IAAA,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ;IAE3E,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC;IAChD,IAAI,SAAS,KAAK,SAAS;AAAE,QAAA,OAAO,CAAC,SAAS,GAAG,SAAS;IAE1D,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC;IACtD,IAAI,YAAY,KAAK,SAAS;AAAE,QAAA,OAAO,CAAC,YAAY,GAAG,YAAY;AAEnE,IAAA,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY;IAEvF,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC;IACxD,IAAI,KAAK,KAAK,SAAS;AAAE,QAAA,OAAO,CAAC,KAAK,GAAG,KAAK;AAE9C,IAAA,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU;AACjF,IAAA,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO;IAExE,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC;IACpD,IAAI,WAAW,KAAK,SAAS;AAAE,QAAA,OAAO,CAAC,WAAW,GAAG,WAAW;AAEhE,IAAA,IAAI,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa;AAC1F,IAAA,IAAI,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa;AAC1F,IAAA,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW;AACpF,IAAA,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;AAAE,QAAA,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU;AAEjF,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE;QAC9E,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAErD,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE;YAC7C,OAAO,CAAC,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC;QACxC;IACF;AAEA,IAAA,IAAI,MAAM,CAAC,YAAY,KAAK,YAAY,IAAI,MAAM,CAAC,YAAY,KAAK,UAAU,EAAE;AAC9E,QAAA,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY;IAC5C;AAEA,IAAA,OAAO,OAAO;AAChB;AAEA;AAEA,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAA0E;AAC1H,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,KAAK,CAA2E;AAC3G,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAA4E;AAE7H;;;;AAIG;AACG,SAAU,iBAAiB,CAAC,KAAc,EAAA;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE;AAC/C,QAAA,OAAO,SAAS;IAClB;IAEA,MAAM,MAAM,GAAG,KAAgC;IAC/C,MAAM,GAAG,GAAkB,EAAE;IAE7B,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS;AAAE,QAAA,GAAG,CAAC,QAAQ,GAAG,QAAQ;IAEnD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC;IACjD,IAAI,SAAS,KAAK,SAAS;AAAE,QAAA,GAAG,CAAC,SAAS,GAAG,SAAS;IAEtD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC;IACxD,IAAI,QAAQ,KAAK,SAAS;AAAE,QAAA,GAAG,CAAC,QAAQ,GAAG,QAAQ;IAEnD,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,EAAE,eAAe,CAAC;IACzD,IAAI,aAAa,KAAK,SAAS;AAAE,QAAA,GAAG,CAAC,aAAa,GAAG,aAAa;IAElE,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC;IAC3D,IAAI,SAAS,KAAK,SAAS;AAAE,QAAA,GAAG,CAAC,SAAS,GAAG,SAAS;IAEtD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC;IACpD,IAAI,UAAU,KAAK,SAAS;AAAE,QAAA,GAAG,CAAC,UAAU,GAAG,UAAU;IAEzD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC;IAC/D,IAAI,UAAU,KAAK,SAAS;AAAE,QAAA,GAAG,CAAC,UAAU,GAAG,UAAU;AAEzD,IAAA,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,GAAG,GAAG,SAAS;AACtD;;;;"}

package/dist/esm/core/serialization/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Current scene-serialization format version. Written into every
+ * {@link SerializedScene} and checked on deserialize so saved data can outlive
+ * the code that produced it (see the migration chain in `migrate`).
+ */
+export declare const SERIALIZATION_VERSION = 1;
+/**
+ * Plain-old-JSON description of a single scene-graph node.
+ *
+ * Always carries a `type` tag (the registered type name) plus an open set of
+ * common transform/visual fields and type-specific fields. Every field is
+ * JSON-serialisable; runtime-only state (caches, dirty flags, matrices,
+ * signals, GPU resources) is never present.
+ *
+ * Common fields are written by the framework and omitted when they hold their
+ * default value, so a freshly-constructed node serialises to `{ type }` alone.
+ */
+export interface SerializedNode {
+    /** Registered type name, e.g. `"Container"`, `"Sprite"`, `"Text"`. */
+    type: string;
+    /** Optional node identity ({@link SceneNode.name}); omitted when `null`. */
+    name?: string;
+    /** Type-specific and common fields. */
+    [key: string]: unknown;
+}
+/**
+ * Top-level serialized form of a {@link Scene} produced by
+ * {@link Scene.serialize} and consumed by {@link Scene.deserialize}.
+ */
+export interface SerializedScene {
+    /** Format version this document was written with ({@link SERIALIZATION_VERSION}). */
+    version: number;
+    /** The scene's structural root container subtree. */
+    root: SerializedNode;
+    /** The scene's screen-fixed UI layer ({@link Scene.ui}), if it was materialized. */
+    ui?: SerializedNode;
+}
+/**
+ * Serialized reference to a loaded asset (e.g. a {@link Texture}).
+ *
+ * Stores the loader **source key** the asset was loaded under, not the asset
+ * data itself. The contract is that referenced assets are pre-loaded into the
+ * target {@link Loader} before {@link Scene.deserialize} runs.
+ */
+export interface AssetRef {
+    /** Loader alias/source the asset was originally loaded under. */
+    source: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/core/serialization/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,IAAI,EAAE,cAAc,CAAC;IACrB,oFAAoF;IACpF,EAAE,CAAC,EAAE,cAAc,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/esm/core/serialization/types.js

@@ -0,0 +1,9 @@
+/**
+ * Current scene-serialization format version. Written into every
+ * {@link SerializedScene} and checked on deserialize so saved data can outlive
+ * the code that produced it (see the migration chain in `migrate`).
+ */
+const SERIALIZATION_VERSION = 1;
+
+export { SERIALIZATION_VERSION };
+//# sourceMappingURL=types.js.map

package/dist/esm/core/serialization/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../../../../src/core/serialization/types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;AAIG;AACI,MAAM,qBAAqB,GAAG;;;;"}

package/dist/esm/core/serialization/uiSerializers.d.ts

@@ -0,0 +1,7 @@
+import type { SerializationRegistry } from './SerializationRegistry';
+/**
+ * Register the UI widget node serializers on `registry`.
+ * @internal
+ */
+export declare function registerUiSerializers(registry: SerializationRegistry): void;
+//# sourceMappingURL=uiSerializers.d.ts.map

package/dist/esm/core/serialization/uiSerializers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiSerializers.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/uiSerializers.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAyNrE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAO3E"}

package/dist/esm/core/serialization/uiSerializers.js

@@ -0,0 +1,206 @@
+import { Button } from '../../ui/Button.js';
+import { Label } from '../../ui/Label.js';
+import { Panel } from '../../ui/Panel.js';
+import { ProgressBar } from '../../ui/ProgressBar.js';
+import { Stack } from '../../ui/Stack.js';
+import { UIRoot } from '../../ui/UIRoot.js';
+import { asSerializedNode } from './read.js';
+import { deserializeStyleOptions, serializeStyle, compact, arrayToColor, colorToArray } from './serializerHelpers.js';
+
+const num = (value) => (typeof value === 'number' && Number.isFinite(value) ? value : undefined);
+// Widget composition note: widgets own internal children (a Label's Text, a
+// Panel's background Graphics, etc.) that their constructors rebuild — those are
+// never serialized. Only user-added children of the container widgets (Panel,
+// Stack, UIRoot) round-trip. Anchoring (anchorIn) references a UIRoot and is not
+// serialized; the resolved position still round-trips via the common fields.
+// ── Label ────────────────────────────────────────────────────────────────────
+const labelSerializer = {
+    write(node) {
+        const out = { text: node.text };
+        const style = serializeStyle(node.textNode.style);
+        if (style !== undefined)
+            out.style = style;
+        if (!node.enabled)
+            out.enabled = false;
+        return out;
+    },
+    read(data) {
+        const label = new Label(typeof data.text === 'string' ? data.text : '', deserializeStyleOptions(data.style));
+        if (data.enabled === false)
+            label.enabled = false;
+        return label;
+    },
+};
+// ── Panel ────────────────────────────────────────────────────────────────────
+const panelSerializer = {
+    write(node, ctx) {
+        const out = {
+            width: node.uiWidth,
+            height: node.uiHeight,
+            color: colorToArray(node.color),
+            borderColor: colorToArray(node.borderColor),
+            borderWidth: node.borderWidth,
+            cornerRadius: node.cornerRadius,
+        };
+        if (!node.enabled)
+            out.enabled = false;
+        const userChildren = node.children.filter(child => child !== node.background);
+        if (userChildren.length > 0)
+            out.children = userChildren.map(child => ctx.writeNode(child));
+        return out;
+    },
+    read(data, ctx) {
+        const panel = new Panel(compact({
+            width: num(data.width),
+            height: num(data.height),
+            color: arrayToColor(data.color),
+            borderColor: arrayToColor(data.borderColor),
+            borderWidth: num(data.borderWidth),
+            cornerRadius: num(data.cornerRadius),
+        }));
+        if (data.enabled === false)
+            panel.enabled = false;
+        const children = data.children;
+        if (Array.isArray(children)) {
+            for (const child of children) {
+                const childNode = asSerializedNode(child);
+                if (childNode !== null)
+                    panel.addChild(ctx.readNode(childNode));
+            }
+        }
+        return panel;
+    },
+};
+// ── Button ───────────────────────────────────────────────────────────────────
+const buttonSerializer = {
+    write(node) {
+        const out = {
+            width: node.uiWidth,
+            height: node.uiHeight,
+            label: node.label,
+            cornerRadius: node.cornerRadius,
+            color: colorToArray(node.colors.normal),
+            hoverColor: colorToArray(node.colors.hover),
+            pressedColor: colorToArray(node.colors.pressed),
+            disabledColor: colorToArray(node.colors.disabled),
+            textColor: colorToArray(node.textColor),
+            fontSize: node.fontSize,
+        };
+        if (!node.enabled)
+            out.enabled = false;
+        return out;
+    },
+    read(data) {
+        const button = new Button(compact({
+            width: num(data.width),
+            height: num(data.height),
+            label: typeof data.label === 'string' ? data.label : undefined,
+            cornerRadius: num(data.cornerRadius),
+            color: arrayToColor(data.color),
+            hoverColor: arrayToColor(data.hoverColor),
+            pressedColor: arrayToColor(data.pressedColor),
+            disabledColor: arrayToColor(data.disabledColor),
+            textColor: arrayToColor(data.textColor),
+            fontSize: num(data.fontSize),
+        }));
+        if (data.enabled === false)
+            button.enabled = false;
+        return button;
+    },
+};
+// ── ProgressBar ──────────────────────────────────────────────────────────────
+const progressBarSerializer = {
+    write(node) {
+        const out = {
+            width: node.uiWidth,
+            height: node.uiHeight,
+            value: node.value,
+            trackColor: colorToArray(node.trackColor),
+            fillColor: colorToArray(node.fillColor),
+            cornerRadius: node.cornerRadius,
+        };
+        if (!node.enabled)
+            out.enabled = false;
+        return out;
+    },
+    read(data) {
+        const bar = new ProgressBar(compact({
+            width: num(data.width),
+            height: num(data.height),
+            value: num(data.value),
+            trackColor: arrayToColor(data.trackColor),
+            fillColor: arrayToColor(data.fillColor),
+            cornerRadius: num(data.cornerRadius),
+        }));
+        if (data.enabled === false)
+            bar.enabled = false;
+        return bar;
+    },
+};
+// ── Stack ────────────────────────────────────────────────────────────────────
+const stackSerializer = {
+    write(node, ctx) {
+        const out = {
+            direction: node.direction,
+            spacing: node.spacing,
+            padding: node.padding,
+        };
+        if (!node.enabled)
+            out.enabled = false;
+        if (node.children.length > 0)
+            out.children = node.children.map(child => ctx.writeNode(child));
+        return out;
+    },
+    read(data, ctx) {
+        const stack = new Stack(compact({
+            direction: data.direction === 'row' || data.direction === 'column' ? data.direction : undefined,
+            spacing: num(data.spacing),
+            padding: num(data.padding),
+        }));
+        if (data.enabled === false)
+            stack.enabled = false;
+        const children = data.children;
+        if (Array.isArray(children)) {
+            for (const child of children) {
+                const childNode = asSerializedNode(child);
+                if (childNode !== null)
+                    stack.addChild(ctx.readNode(childNode));
+            }
+            stack.layout();
+        }
+        return stack;
+    },
+};
+// ── UIRoot ───────────────────────────────────────────────────────────────────
+const uiRootSerializer = {
+    write(node, ctx) {
+        return node.children.length > 0 ? { children: node.children.map(child => ctx.writeNode(child)) } : {};
+    },
+    read(data, ctx) {
+        const root = new UIRoot();
+        const children = data.children;
+        if (Array.isArray(children)) {
+            for (const child of children) {
+                const childNode = asSerializedNode(child);
+                if (childNode !== null)
+                    root.addChild(ctx.readNode(childNode));
+            }
+        }
+        return root;
+    },
+};
+/**
+ * Register the UI widget node serializers on `registry`.
+ * @internal
+ */
+function registerUiSerializers(registry) {
+    registry.register('Label', Label, labelSerializer);
+    registry.register('Panel', Panel, panelSerializer);
+    registry.register('Button', Button, buttonSerializer);
+    registry.register('ProgressBar', ProgressBar, progressBarSerializer);
+    registry.register('Stack', Stack, stackSerializer);
+    registry.register('UIRoot', UIRoot, uiRootSerializer);
+}
+
+export { registerUiSerializers };
+//# sourceMappingURL=uiSerializers.js.map

package/dist/esm/core/serialization/uiSerializers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uiSerializers.js","sources":["../../../../../src/core/serialization/uiSerializers.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;AAaA,MAAM,GAAG,GAAG,CAAC,KAAc,MAA0B,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,SAAS,CAAC;AAE7H;AACA;AACA;AACA;AACA;AAEA;AAEA,MAAM,eAAe,GAA0B;AAC7C,IAAA,KAAK,CAAC,IAAI,EAAA;QACR,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACxD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAEjD,IAAI,KAAK,KAAK,SAAS;AAAE,YAAA,GAAG,CAAC,KAAK,GAAG,KAAK;QAC1C,IAAI,CAAC,IAAI,CAAC,OAAO;AAAE,YAAA,GAAG,CAAC,OAAO,GAAG,KAAK;AAEtC,QAAA,OAAO,GAAG;IACZ,CAAC;AACD,IAAA,IAAI,CAAC,IAAI,EAAA;AACP,QAAA,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,GAAG,IAAI,CAAC,IAAI,GAAG,EAAE,EAAE,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAE5G,QAAA,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK;AAAE,YAAA,KAAK,CAAC,OAAO,GAAG,KAAK;AAEjD,QAAA,OAAO,KAAK;IACd,CAAC;CACF;AAED;AAEA,MAAM,eAAe,GAA0B;IAC7C,KAAK,CAAC,IAAI,EAAE,GAAG,EAAA;AACb,QAAA,MAAM,GAAG,GAA4B;YACnC,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,MAAM,EAAE,IAAI,CAAC,QAAQ;AACrB,YAAA,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;AAC/B,YAAA,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;YAC3C,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO;AAAE,YAAA,GAAG,CAAC,OAAO,GAAG,KAAK;AAEtC,QAAA,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC;AAC7E,QAAA,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;AAAE,YAAA,GAAG,CAAC,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAE3F,QAAA,OAAO,GAAG;IACZ,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,GAAG,EAAA;AACZ,QAAA,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,OAAO,CAAC;AACN,YAAA,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;AACtB,YAAA,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;AACxB,YAAA,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;AAC/B,YAAA,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;AAC3C,YAAA,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC;AAClC,YAAA,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC;AACrC,SAAA,CAAC,CACH;AAED,QAAA,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK;AAAE,YAAA,KAAK,CAAC,OAAO,GAAG,KAAK;AAEjD,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ;AAC9B,QAAA,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;AAC3B,YAAA,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE;AAC5B,gBAAA,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC;gBACzC,IAAI,SAAS,KAAK,IAAI;oBAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAe,CAAC;YAC/E;QACF;AAEA,QAAA,OAAO,KAAK;IACd,CAAC;CACF;AAED;AAEA,MAAM,gBAAgB,GAA2B;AAC/C,IAAA,KAAK,CAAC,IAAI,EAAA;AACR,QAAA,MAAM,GAAG,GAA4B;YACnC,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,MAAM,EAAE,IAAI,CAAC,QAAQ;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACvC,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3C,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAC/C,aAAa,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;AACjD,YAAA,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;YACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB;QAED,IAAI,CAAC,IAAI,CAAC,OAAO;AAAE,YAAA,GAAG,CAAC,OAAO,GAAG,KAAK;AAEtC,QAAA,OAAO,GAAG;IACZ,CAAC;AACD,IAAA,IAAI,CAAC,IAAI,EAAA;AACP,QAAA,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,OAAO,CAAC;AACN,YAAA,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;AACtB,YAAA,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;AACxB,YAAA,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,GAAG,IAAI,CAAC,KAAK,GAAG,SAAS;AAC9D,YAAA,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC;AACpC,YAAA,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;AAC/B,YAAA,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;AACzC,YAAA,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC;AAC7C,YAAA,aAAa,EAAE,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC;AAC/C,YAAA,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;AACvC,YAAA,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC7B,SAAA,CAAC,CACH;AAED,QAAA,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK;AAAE,YAAA,MAAM,CAAC,OAAO,GAAG,KAAK;AAElD,QAAA,OAAO,MAAM;IACf,CAAC;CACF;AAED;AAEA,MAAM,qBAAqB,GAAgC;AACzD,IAAA,KAAK,CAAC,IAAI,EAAA;AACR,QAAA,MAAM,GAAG,GAA4B;YACnC,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,MAAM,EAAE,IAAI,CAAC,QAAQ;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;AACjB,YAAA,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;AACzC,YAAA,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;YACvC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO;AAAE,YAAA,GAAG,CAAC,OAAO,GAAG,KAAK;AAEtC,QAAA,OAAO,GAAG;IACZ,CAAC;AACD,IAAA,IAAI,CAAC,IAAI,EAAA;AACP,QAAA,MAAM,GAAG,GAAG,IAAI,WAAW,CACzB,OAAO,CAAC;AACN,YAAA,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;AACtB,YAAA,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;AACxB,YAAA,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;AACtB,YAAA,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;AACzC,YAAA,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;AACvC,YAAA,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC;AACrC,SAAA,CAAC,CACH;AAED,QAAA,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK;AAAE,YAAA,GAAG,CAAC,OAAO,GAAG,KAAK;AAE/C,QAAA,OAAO,GAAG;IACZ,CAAC;CACF;AAED;AAEA,MAAM,eAAe,GAA0B;IAC7C,KAAK,CAAC,IAAI,EAAE,GAAG,EAAA;AACb,QAAA,MAAM,GAAG,GAA4B;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB;QAED,IAAI,CAAC,IAAI,CAAC,OAAO;AAAE,YAAA,GAAG,CAAC,OAAO,GAAG,KAAK;AACtC,QAAA,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAE7F,QAAA,OAAO,GAAG;IACZ,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,GAAG,EAAA;AACZ,QAAA,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,OAAO,CAAC;YACN,SAAS,EAAE,IAAI,CAAC,SAAS,KAAK,KAAK,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,GAAG,IAAI,CAAC,SAAS,GAAG,SAAS;AAC/F,YAAA,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;AAC1B,YAAA,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;AAC3B,SAAA,CAAC,CACH;AAED,QAAA,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK;AAAE,YAAA,KAAK,CAAC,OAAO,GAAG,KAAK;AAEjD,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ;AAC9B,QAAA,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;AAC3B,YAAA,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE;AAC5B,gBAAA,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC;gBACzC,IAAI,SAAS,KAAK,IAAI;oBAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAe,CAAC;YAC/E;YAEA,KAAK,CAAC,MAAM,EAAE;QAChB;AAEA,QAAA,OAAO,KAAK;IACd,CAAC;CACF;AAED;AAEA,MAAM,gBAAgB,GAA2B;IAC/C,KAAK,CAAC,IAAI,EAAE,GAAG,EAAA;AACb,QAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE;IACvG,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,GAAG,EAAA;AACZ,QAAA,MAAM,IAAI,GAAG,IAAI,MAAM,EAAE;AACzB,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ;AAE9B,QAAA,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;AAC3B,YAAA,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE;AAC5B,gBAAA,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC;gBACzC,IAAI,SAAS,KAAK,IAAI;oBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAe,CAAC;YAC9E;QACF;AAEA,QAAA,OAAO,IAAI;IACb,CAAC;CACF;AAED;;;AAGG;AACG,SAAU,qBAAqB,CAAC,QAA+B,EAAA;IACnE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW,EAAE,qBAAqB,CAAC;IACpE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC;AACvD;;;;"}

package/dist/esm/core/types.d.ts

@@ -27,7 +27,7 @@ export type Mutable<T> = {
  * been assigned yet.
  */
 export type TextureSource = HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | ImageBitmap | null;
-/** Common playback configuration for both {@link Sound} and {@link Music}. */
+/** Common playback configuration for {@link Sound} and {@link AudioStream}. */
 export interface PlaybackOptions {
     volume: number;
     playbackRate: number;

package/dist/esm/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,iBAAiB,GAAG,YAAY,GAAG,YAAY,CAAC;AAExJ;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,IAAI;KAAG,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI;CAAE,CAAC;AAElE,kFAAkF;AAClF,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpC,8DAA8D;AAC9D,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IACvB,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,WAAW,GAAG,IAAI,CAAC;AAEzG,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,SAAS,IAAI,SAAS,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,YAAY,GAAG,SAAS,GAAG,gBAAgB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,iBAAiB,GAAG,YAAY,GAAG,YAAY,CAAC;AAExJ;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,IAAI;KAAG,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI;CAAE,CAAC;AAElE,kFAAkF;AAClF,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpC,8DAA8D;AAC9D,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IACvB,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,WAAW,GAAG,IAAI,CAAC;AAEzG,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,SAAS,IAAI,SAAS,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,YAAY,GAAG,SAAS,GAAG,gBAAgB,CAAC"}

package/dist/esm/core/utils.d.ts

@@ -1,12 +1,5 @@
 import { Size } from '#math/Size';
-import { Time } from './Time';
 import type { TextureSource } from './types';
-/**
- * Random number in the range `[min, max]` from the module-level shared
- * {@link Random} instance. Pass no arguments for `[0, 1)`. For deterministic
- * sequences create your own seeded `Random` instance instead.
- */
-export declare const rand: (min?: number, max?: number) => number;
 /** Empty function literal — useful as a default callback that does nothing. */
 export declare const noop: () => void;
 /** `preventDefault()` + `stopImmediatePropagation()` on an event in one call. */
@@ -25,16 +18,8 @@ export declare const supportsPointerEvents: boolean;
  * object and treat it as the boolean `useCapture`. Probed once on first call.
  */
 export declare const supportsEventOptions: () => boolean;
-/** High-resolution monotonic clock reading in milliseconds. Wraps `performance.now()`. */
+/** High-resolution monotonic clock reading in milliseconds. Wraps `performance.now()`. @internal */
 export declare const getPreciseTime: () => number;
-/** Construct a {@link Time} value from a millisecond count. */
-export declare const milliseconds: (value: number) => Time;
-/** Construct a {@link Time} value from a second count. */
-export declare const seconds: (value: number) => Time;
-/** Construct a {@link Time} value from a minute count. */
-export declare const minutes: (value: number) => Time;
-/** Construct a {@link Time} value from an hour count. */
-export declare const hours: (value: number) => Time;
 /**
  * Trigger a device vibration pattern via the
  * [Vibration API](https://developer.mozilla.org/en-US/docs/Web/API/Vibration_API).

package/dist/esm/core/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAkE7C;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,MAAoC,CAAC;AAEvF,+EAA+E;AAC/E,eAAO,MAAM,IAAI,QAAO,IAEvB,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,KAAG,IAGxC,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,EAAE,OAA6C,CAAC;AAC7E,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,EAAE,OAA0C,CAAC;AAC3E,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,EAAE,OAAoD,CAAC;AACvF,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,EAAE,OAA6C,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,OA6BvC,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,cAAc,QAAO,MAA2B,CAAC;AAE9D,+DAA+D;AAC/D,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,IAA0C,CAAC;AACxF,0DAA0D;AAC1D,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,KAAG,IAAqC,CAAC;AAC9E,0DAA0D;AAC1D,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,KAAG,IAAqC,CAAC;AAC9E,yDAAyD;AACzD,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,KAAG,IAAmC,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,cAAc,KAAG,OAKjD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,aAAqB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,YAAY,MAAM,EAAE,QAAQ,MAAM,KAAG,CAAC,EAc/F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,QAAQ,MAAM,EAAE,KAAG,OAA2G,CAAC;AAEhK;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,iBAAiB,KAAG,IAwB/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,aAAa,KAAG,IAM5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,iBAAiB,KAAG,MAUjE,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAyD7C,+EAA+E;AAC/E,eAAO,MAAM,IAAI,QAAO,IAEvB,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,KAAG,IAGxC,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,EAAE,OAA6C,CAAC;AAC7E,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,EAAE,OAA0C,CAAC;AAC3E,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,EAAE,OAAoD,CAAC;AACvF,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,EAAE,OAA6C,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,OA6BvC,CAAC;AAEF,oGAAoG;AACpG,eAAO,MAAM,cAAc,QAAO,MAA2B,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,cAAc,KAAG,OAKjD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,aAAqB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,YAAY,MAAM,EAAE,QAAQ,MAAM,KAAG,CAAC,EAc/F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,QAAQ,MAAM,EAAE,KAAG,OAA2G,CAAC;AAEhK;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,iBAAiB,KAAG,IAwB/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,aAAa,KAAG,IAM5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,iBAAiB,KAAG,MAUjE,CAAC"}