@codexo/exojs 0.13.0 → 0.15.0

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

@@ -0,0 +1,6 @@
+export type { DeserializeContext, NodeSerializer, SerializeContext } from './NodeSerializer';
+export { Prefab } from './Prefab';
+export { registerSerializer, type SceneNodeConstructor, SerializationRegistry } from './SerializationRegistry';
+export type { AssetRef, SerializedNode, SerializedScene } from './types';
+export { SERIALIZATION_VERSION } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC/G,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,65 @@
+import type { SerializedNode } from './types';
+/**
+ * Validating read helpers for deserialization — **check instead of cast**.
+ *
+ * Deserialized JSON is treated as untrusted input (it may come from a save
+ * file, cloud sync, shared prefab, or user-generated content). Every field
+ * access goes through one of these helpers so a manipulated or corrupt document
+ * can only ever cause a field to be *ignored* (falling back to the constructor
+ * default) — never to inject an unchecked value of the wrong type/domain into
+ * the engine. Structural top-level errors are rejected at the boundary
+ * (`migrate` / `Scene.deserialize`); per-field garbage degrades to defaults.
+ *
+ * The `read*` helpers take `(data, key)` for field access; the `as*` helpers
+ * narrow an already-extracted value (used for nested elements).
+ *
+ * @internal
+ */
+type Data = Record<string, unknown>;
+/** Read a string field; `fallback` (or `undefined`) when absent or not a string. */
+export declare function readString(data: Data, key: string): string | undefined;
+export declare function readString(data: Data, key: string, fallback: string): string;
+/**
+ * Read a finite-number field; `fallback` (or `undefined`) when absent, not a
+ * number, or non-finite. The finite check rejects `NaN`/`Infinity` smuggled in
+ * through a hand-edited document.
+ */
+export declare function readNumber(data: Data, key: string): number | undefined;
+export declare function readNumber(data: Data, key: string, fallback: number): number;
+/** Read a boolean field; `fallback` (or `undefined`) when absent or not a boolean. */
+export declare function readBoolean(data: Data, key: string): boolean | undefined;
+export declare function readBoolean(data: Data, key: string, fallback: boolean): boolean;
+/**
+ * Read a string field constrained to `allowed`; `fallback` (or `undefined`)
+ * when absent or not a member. The cast is performed **after** the runtime
+ * membership check, so it is sound — this is the helper that replaces the bare
+ * `data.x as SomeEnum` casts.
+ */
+export declare function readEnum<T extends string>(data: Data, key: string, allowed: readonly T[]): T | undefined;
+export declare function readEnum<T extends string>(data: Data, key: string, allowed: readonly T[], fallback: T): T;
+/** Read an object-valued (non-array) field as a record, or `undefined`. */
+export declare function readObject(data: Data, key: string): Data | undefined;
+/** Narrow an already-extracted value to a plain object record, or `null`. */
+export declare function asObject(value: unknown): Data | null;
+/**
+ * Narrow an already-extracted value to a {@link SerializedNode} (an object
+ * carrying a string `type` tag), or `null`. Guards the recursive child descent
+ * so a `children` array containing non-objects is skipped rather than crashing
+ * with `Cannot read 'type' of …`.
+ */
+export declare function asSerializedNode(value: unknown): SerializedNode | null;
+/**
+ * Narrow an already-extracted value to an array of finite numbers (non-numeric
+ * or non-finite entries collapse to `0`), or `null` when not an array.
+ */
+export declare function asNumberArray(value: unknown): number[] | null;
+/** Allowed {@link FontWeight} values for {@link readEnum}. */
+export declare const FONT_WEIGHTS: readonly ["normal", "bold", "100", "200", "300", "400", "500", "600", "700", "800", "900"];
+/** Allowed {@link TextAlignment} values for {@link readEnum}. */
+export declare const TEXT_ALIGNMENTS: readonly ["left", "center", "right", "justify"];
+/** Allowed {@link RepeatMode} values for {@link readEnum}. */
+export declare const REPEAT_MODES: readonly ["stretch", "repeat", "mirror-repeat"];
+/** Allowed {@link RepeatFit} values for {@link readEnum}. */
+export declare const REPEAT_FITS: readonly ["clip", "round"];
+export {};
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/read.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;;;;;;;;GAeG;AAEH,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpC,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;AAO9E;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;AAO9E,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAC1E,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;AAOjF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;AAC1G,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;AAO3G,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAEpE;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAEtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAE7D;AAQD,8DAA8D;AAC9D,eAAO,MAAM,YAAY,4FAA6H,CAAC;AAEvJ,iEAAiE;AACjE,eAAO,MAAM,eAAe,iDAAqF,CAAC;AAElH,8DAA8D;AAC9D,eAAO,MAAM,YAAY,iDAAkF,CAAC;AAE5G,6DAA6D;AAC7D,eAAO,MAAM,WAAW,4BAA4D,CAAC"}

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

@@ -0,0 +1,48 @@
+function readNumber(data, key, fallback) {
+    const value = data[key];
+    return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+}
+function readBoolean(data, key, fallback) {
+    const value = data[key];
+    return typeof value === 'boolean' ? value : fallback;
+}
+function readEnum(data, key, allowed, fallback) {
+    const value = data[key];
+    return typeof value === 'string' && allowed.includes(value) ? value : fallback;
+}
+/** Narrow an already-extracted value to a plain object record, or `null`. */
+function asObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : null;
+}
+/**
+ * Narrow an already-extracted value to a {@link SerializedNode} (an object
+ * carrying a string `type` tag), or `null`. Guards the recursive child descent
+ * so a `children` array containing non-objects is skipped rather than crashing
+ * with `Cannot read 'type' of …`.
+ */
+function asSerializedNode(value) {
+    return typeof value === 'object' && value !== null && typeof value.type === 'string' ? value : null;
+}
+/**
+ * Narrow an already-extracted value to an array of finite numbers (non-numeric
+ * or non-finite entries collapse to `0`), or `null` when not an array.
+ */
+function asNumberArray(value) {
+    return Array.isArray(value) ? value.map(entry => (typeof entry === 'number' && Number.isFinite(entry) ? entry : 0)) : null;
+}
+// ── Serialized-enum value lists ──────────────────────────────────────────────
+// `satisfies readonly T[]` makes a typo here a compile error (a listed value
+// that is not a union member fails to type-check). If a new union member is
+// added upstream, an omission here only makes an otherwise-valid value fall
+// back to its default — never unsafe — so keep these in sync deliberately.
+/** Allowed {@link FontWeight} values for {@link readEnum}. */
+const FONT_WEIGHTS = ['normal', 'bold', '100', '200', '300', '400', '500', '600', '700', '800', '900'];
+/** Allowed {@link TextAlignment} values for {@link readEnum}. */
+const TEXT_ALIGNMENTS = ['left', 'center', 'right', 'justify'];
+/** Allowed {@link RepeatMode} values for {@link readEnum}. */
+const REPEAT_MODES = ['stretch', 'repeat', 'mirror-repeat'];
+/** Allowed {@link RepeatFit} values for {@link readEnum}. */
+const REPEAT_FITS = ['clip', 'round'];
+
+export { FONT_WEIGHTS, REPEAT_FITS, REPEAT_MODES, TEXT_ALIGNMENTS, asNumberArray, asObject, asSerializedNode, readBoolean, readEnum, readNumber };
+//# sourceMappingURL=read.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sources":["../../../../../src/core/serialization/read.ts"],"sourcesContent":[null],"names":[],"mappings":"SAyCgB,UAAU,CAAC,IAAU,EAAE,GAAW,EAAE,QAAiB,EAAA;AACnE,IAAA,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;AAEvB,IAAA,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,QAAQ;AAC/E;SAKgB,WAAW,CAAC,IAAU,EAAE,GAAW,EAAE,QAAkB,EAAA;AACrE,IAAA,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;AAEvB,IAAA,OAAO,OAAO,KAAK,KAAK,SAAS,GAAG,KAAK,GAAG,QAAQ;AACtD;AAUM,SAAU,QAAQ,CAAmB,IAAU,EAAE,GAAW,EAAE,OAAqB,EAAE,QAAY,EAAA;AACrG,IAAA,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;AAEvB,IAAA,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAI,KAAW,GAAG,QAAQ;AAC9G;AAOA;AACM,SAAU,QAAQ,CAAC,KAAc,EAAA;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAI,KAAc,GAAG,IAAI;AACtG;AAEA;;;;;AAKG;AACG,SAAU,gBAAgB,CAAC,KAAc,EAAA;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAAc,CAAC,IAAI,KAAK,QAAQ,GAAI,KAAwB,GAAG,IAAI;AACnI;AAEA;;;AAGG;AACG,SAAU,aAAa,CAAC,KAAc,EAAA;AAC1C,IAAA,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI;AAC5H;AAEA;AACA;AACA;AACA;AACA;AAEA;AACO,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;AAE5G;AACO,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS;AAEpE;AACO,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,eAAe;AAEjE;MACa,WAAW,GAAG,CAAC,MAAM,EAAE,OAAO;;;;"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderingSerializers.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/renderingSerializers.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AA+VrE;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAQlF"}

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

@@ -0,0 +1,320 @@
+import { Rectangle } from '../../math/Rectangle.js';
+import { Mesh } from '../../rendering/mesh/Mesh.js';
+import { Graphics } from '../../rendering/primitives/Graphics.js';
+import { AnimatedSprite } from '../../rendering/sprite/AnimatedSprite.js';
+import { NineSliceSprite } from '../../rendering/sprite/NineSliceSprite.js';
+import { RepeatingSprite } from '../../rendering/sprite/RepeatingSprite.js';
+import { BitmapText } from '../../rendering/text/BitmapText.js';
+import { BmFont } from '../../rendering/text/BmFont.js';
+import { Texture } from '../../rendering/texture/Texture.js';
+import { Video } from '../../rendering/video/Video.js';
+import { asSerializedNode, asObject, readEnum, asNumberArray, REPEAT_MODES, REPEAT_FITS } from './read.js';
+import { compact, readLayoutOptions, deserializeStyleOptions, serializeStyle } from './serializerHelpers.js';
+
+// ── Small helpers ────────────────────────────────────────────────────────────
+const toF32 = (value) => (Array.isArray(value) ? new Float32Array(value.map(Number)) : new Float32Array());
+const toU16 = (value) => (Array.isArray(value) ? new Uint16Array(value.map(Number)) : new Uint16Array());
+const toU32 = (value) => (Array.isArray(value) ? new Uint32Array(value.map(Number)) : new Uint32Array());
+const num = (value) => (typeof value === 'number' && Number.isFinite(value) ? value : undefined);
+/** Read a {@link NineSliceInsets} from JSON, defaulting any missing/invalid edge to 0 (never `undefined` — `slices` is required and `undefined` would crash `normalizeInsets`). */
+const readInsets = (value) => {
+    const source = asObject(value);
+    return {
+        left: num(source?.left) ?? 0,
+        top: num(source?.top) ?? 0,
+        right: num(source?.right) ?? 0,
+        bottom: num(source?.bottom) ?? 0,
+    };
+};
+/** Read {@link NineSliceModes} from JSON, keeping only valid enum fields (invalid ones fall back to the renderer's defaults). */
+const readModes = (value) => {
+    const source = asObject(value);
+    if (source === null) {
+        return undefined;
+    }
+    const out = {};
+    const edges = readEnum(source, 'edges', REPEAT_MODES);
+    if (edges !== undefined)
+        out.edges = edges;
+    const center = readEnum(source, 'center', REPEAT_MODES);
+    if (center !== undefined)
+        out.center = center;
+    const top = readEnum(source, 'top', REPEAT_MODES);
+    if (top !== undefined)
+        out.top = top;
+    const right = readEnum(source, 'right', REPEAT_MODES);
+    if (right !== undefined)
+        out.right = right;
+    const bottom = readEnum(source, 'bottom', REPEAT_MODES);
+    if (bottom !== undefined)
+        out.bottom = bottom;
+    const left = readEnum(source, 'left', REPEAT_MODES);
+    if (left !== undefined)
+        out.left = left;
+    const edgeFit = readEnum(source, 'edgeFit', REPEAT_FITS);
+    if (edgeFit !== undefined)
+        out.edgeFit = edgeFit;
+    const centerFit = readEnum(source, 'centerFit', REPEAT_FITS);
+    if (centerFit !== undefined)
+        out.centerFit = centerFit;
+    return out;
+};
+// ── Mesh ─────────────────────────────────────────────────────────────────────
+const meshSerializer = {
+    write(node, ctx) {
+        const out = { vertices: [...node.vertices] };
+        if (node.indices !== null)
+            out.indices = [...node.indices];
+        if (node.uvs !== null)
+            out.uvs = [...node.uvs];
+        if (node.colors !== null)
+            out.colors = [...node.colors];
+        const source = ctx.keyFor(node.texture);
+        if (source !== null)
+            out.texture = source;
+        if (node.material !== null) ;
+        return out;
+    },
+    read(data, ctx) {
+        return new Mesh(compact({
+            vertices: toF32(data.vertices),
+            indices: data.indices !== undefined ? toU16(data.indices) : undefined,
+            uvs: data.uvs !== undefined ? toF32(data.uvs) : undefined,
+            colors: data.colors !== undefined ? toU32(data.colors) : undefined,
+            texture: ctx.resolveAsset(typeof data.texture === 'string' ? data.texture : null, Texture),
+        }));
+    },
+};
+// ── Graphics ───────────────────────────────────────────────────────────────
+// Graphics is immediate-mode: its authored result is the baked Mesh children it
+// accumulates. Round-trips the rendered geometry (gradient fills, drawn via
+// runtime DataTextures, degrade to their vertex colours — texture refs are
+// unkeyed and dropped). The pen state is transient and not serialized.
+const graphicsSerializer = {
+    write(node, ctx) {
+        if (node.children.length === 0) {
+            return {};
+        }
+        return { children: node.children.map(child => ctx.writeNode(child)) };
+    },
+    read(data, ctx) {
+        const node = new Graphics();
+        const children = data.children;
+        if (Array.isArray(children)) {
+            for (const child of children) {
+                const childNode = asSerializedNode(child);
+                if (childNode !== null)
+                    node.addChild(ctx.readNode(childNode));
+            }
+        }
+        return node;
+    },
+};
+// ── NineSliceSprite ──────────────────────────────────────────────────────────
+const nineSliceSerializer = {
+    write(node, ctx) {
+        const out = {
+            slices: { ...node.slices },
+            border: { ...node.border },
+            modes: { ...node.modes },
+            width: node.width,
+            height: node.height,
+        };
+        const source = ctx.keyFor(node.texture);
+        if (source !== null)
+            out.texture = source;
+        return out;
+    },
+    read(data, ctx) {
+        const texture = ctx.resolveAsset(typeof data.texture === 'string' ? data.texture : null, Texture);
+        if (texture === null) {
+            throw new Error('NineSliceSprite deserialize requires its texture to be pre-loaded into the Loader.');
+        }
+        return new NineSliceSprite(texture, compact({
+            slices: readInsets(data.slices),
+            border: asObject(data.border) !== null ? readInsets(data.border) : undefined,
+            modes: readModes(data.modes),
+            width: num(data.width),
+            height: num(data.height),
+        }));
+    },
+};
+// ── RepeatingSprite ──────────────────────────────────────────────────────────
+const repeatingSerializer = {
+    write(node, ctx) {
+        const out = {
+            width: node.width,
+            height: node.height,
+            modeX: node.modeX,
+            modeY: node.modeY,
+            fitX: node.fitX,
+            fitY: node.fitY,
+            offsetX: node.offsetX,
+            offsetY: node.offsetY,
+        };
+        const source = ctx.keyFor(node.texture);
+        if (source !== null)
+            out.texture = source;
+        return out;
+    },
+    read(data, ctx) {
+        const texture = ctx.resolveAsset(typeof data.texture === 'string' ? data.texture : null, Texture);
+        if (texture === null) {
+            throw new Error('RepeatingSprite deserialize requires its texture to be pre-loaded into the Loader.');
+        }
+        return new RepeatingSprite(texture, compact({
+            width: num(data.width),
+            height: num(data.height),
+            modeX: readEnum(data, 'modeX', REPEAT_MODES),
+            modeY: readEnum(data, 'modeY', REPEAT_MODES),
+            fitX: readEnum(data, 'fitX', REPEAT_FITS),
+            fitY: readEnum(data, 'fitY', REPEAT_FITS),
+            offsetX: num(data.offsetX),
+            offsetY: num(data.offsetY),
+        }));
+    },
+};
+// ── AnimatedSprite ───────────────────────────────────────────────────────────
+// Clips round-trip fully; playback resumes at the active clip's first frame
+// (the exact current frame / elapsed time is runtime state and not restored).
+const animatedSpriteSerializer = {
+    write(node, ctx) {
+        const out = {};
+        const source = ctx.keyFor(node.texture);
+        if (source !== null)
+            out.texture = source;
+        const clips = {};
+        for (const [name, clip] of Object.entries(node._getClipDefinitions())) {
+            clips[name] = compact({
+                frames: clip.frames.map(frame => [frame.x, frame.y, frame.width, frame.height]),
+                fps: clip.fps,
+                repeat: clip.repeat,
+                frameDurations: clip.frameDurations ? [...clip.frameDurations] : undefined,
+                frameOffsets: clip.frameOffsets ? clip.frameOffsets.map(offset => [offset.x, offset.y]) : undefined,
+            });
+        }
+        out.clips = clips;
+        if (node.currentClip !== null)
+            out.currentClip = node.currentClip;
+        if (node.playing)
+            out.playing = true;
+        return out;
+    },
+    read(data, ctx) {
+        const texture = ctx.resolveAsset(typeof data.texture === 'string' ? data.texture : null, Texture);
+        const clips = {};
+        const clipsData = data.clips;
+        const clipsObject = asObject(clipsData);
+        if (clipsObject !== null) {
+            for (const [name, raw] of Object.entries(clipsObject)) {
+                const clip = asObject(raw);
+                if (clip === null) {
+                    continue;
+                }
+                const frames = Array.isArray(clip.frames)
+                    ? clip.frames.map(frame => {
+                        const values = asNumberArray(frame) ?? [];
+                        return new Rectangle(values[0] ?? 0, values[1] ?? 0, values[2] ?? 0, values[3] ?? 0);
+                    })
+                    : [];
+                const frameDurations = Array.isArray(clip.frameDurations) ? (asNumberArray(clip.frameDurations) ?? undefined) : undefined;
+                const frameOffsets = Array.isArray(clip.frameOffsets)
+                    ? clip.frameOffsets.map(entry => {
+                        const values = asNumberArray(entry) ?? [];
+                        return { x: values[0] ?? 0, y: values[1] ?? 0 };
+                    })
+                    : undefined;
+                clips[name] = compact({ frames, fps: num(clip.fps), repeat: num(clip.repeat), frameDurations, frameOffsets });
+            }
+        }
+        const sprite = new AnimatedSprite(texture, clips);
+        if (typeof data.currentClip === 'string' && data.currentClip in clips) {
+            sprite.play(data.currentClip);
+            if (data.playing !== true) {
+                sprite.pause();
+            }
+        }
+        return sprite;
+    },
+};
+// ── BitmapText ─────────────────────────────────────────────────────────────
+const bitmapTextSerializer = {
+    write(node, ctx) {
+        const out = { text: node.text };
+        const source = ctx.keyFor(node.font);
+        if (source !== null)
+            out.font = source;
+        if (node.msdf)
+            out.msdf = true;
+        if (node.fontScale !== 1)
+            out.scale = node.fontScale;
+        const style = serializeStyle(node.style);
+        if (style !== undefined)
+            out.style = style;
+        if (Object.keys(node.layout).length > 0)
+            out.layout = { ...node.layout };
+        return out;
+    },
+    read(data, ctx) {
+        const font = ctx.resolveAsset(typeof data.font === 'string' ? data.font : null, BmFont);
+        if (font === null) {
+            throw new Error('BitmapText deserialize requires its BmFont to be pre-loaded into the Loader.');
+        }
+        const layout = readLayoutOptions(data.layout);
+        return new BitmapText(typeof data.text === 'string' ? data.text : '', font, compact({
+            ...deserializeStyleOptions(data.style),
+            msdf: data.msdf === true,
+            scale: num(data.scale),
+            layout,
+        }));
+    },
+};
+// ── Video ────────────────────────────────────────────────────────────────────
+// Captures the source URL + playback options. Deserialize creates a fresh
+// `<video>` element (requires a DOM); the live decode/audio graph is rebuilt by
+// the Video constructor.
+const videoSerializer = {
+    write(node) {
+        const out = { src: node.videoElement.src };
+        if (node.volume !== 1)
+            out.volume = node.volume;
+        if (node.loop)
+            out.loop = true;
+        if (node.playbackRate !== 1)
+            out.playbackRate = node.playbackRate;
+        if (node.muted)
+            out.muted = true;
+        if (node.currentTime > 0)
+            out.time = node.currentTime;
+        return out;
+    },
+    read(data) {
+        const element = document.createElement('video');
+        if (typeof data.src === 'string') {
+            element.src = data.src;
+        }
+        return new Video(element, compact({
+            volume: num(data.volume),
+            loop: data.loop === true ? true : undefined,
+            playbackRate: num(data.playbackRate),
+            muted: data.muted === true ? true : undefined,
+            time: num(data.time),
+        }));
+    },
+};
+/**
+ * Register the rendering-package node serializers on `registry`.
+ * @internal
+ */
+function registerRenderingSerializers(registry) {
+    registry.register('Mesh', Mesh, meshSerializer);
+    registry.register('Graphics', Graphics, graphicsSerializer);
+    registry.register('NineSliceSprite', NineSliceSprite, nineSliceSerializer);
+    registry.register('RepeatingSprite', RepeatingSprite, repeatingSerializer);
+    registry.register('AnimatedSprite', AnimatedSprite, animatedSpriteSerializer);
+    registry.register('BitmapText', BitmapText, bitmapTextSerializer);
+    registry.register('Video', Video, videoSerializer);
+}
+
+export { registerRenderingSerializers };
+//# sourceMappingURL=renderingSerializers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderingSerializers.js","sources":["../../../../../src/core/serialization/renderingSerializers.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

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

@@ -0,0 +1,56 @@
+import type { SceneNode } from '#core/SceneNode';
+import type { Container } from '#rendering/Container';
+import type { Loader } from '#resources/Loader';
+import { type SerializationRegistry } from './SerializationRegistry';
+import { type SerializedNode, type SerializedScene } from './types';
+/**
+ * Reset the process-wide serialization state so test suites do not leak
+ * registrations into one another. Clears both module-level states: the
+ * {@link defaultSerializationRegistry} **and** the `_coreRegistered` latch. Both
+ * are mandatory — clearing the registry alone would leave the latch `true`, so
+ * the core serializers would never re-register and later round-trips would fail
+ * with spurious "No serializer registered" errors.
+ *
+ * Not exported from the public barrel; import via the direct module path in
+ * tests.
+ * @internal — For unit tests only.
+ */
+export declare function _resetDefaultSerializers(): void;
+/**
+ * Serialize a single node and its subtree to a {@link SerializedNode}. Pass a
+ * {@link Loader} so texture/asset references resolve to their source keys.
+ * @internal
+ */
+export declare function serializeTree(node: SceneNode, loader?: Loader | null, registry?: SerializationRegistry): SerializedNode;
+/**
+ * Reconstruct a node subtree from a {@link SerializedNode}. Referenced assets
+ * must be pre-loaded into `loader`.
+ * @internal
+ */
+export declare function deserializeTree(data: SerializedNode, loader?: Loader | null, registry?: SerializationRegistry): SceneNode;
+/**
+ * Rebuild `container`'s contents from `data` in place: clears existing
+ * children, applies `data`'s common fields to the container, then deserializes
+ * and re-adds its children. Used by {@link Scene.deserialize} to reuse the
+ * eagerly-created scene root.
+ * @internal
+ */
+export declare function deserializeInto(container: Container, data: SerializedNode, loader?: Loader | null, registry?: SerializationRegistry): void;
+/**
+ * Validate and migrate a serialized scene document to the current
+ * {@link SERIALIZATION_VERSION}, returning a structurally-sound
+ * {@link SerializedScene}.
+ *
+ * This is the **untrusted top-level boundary**: the parameter is `unknown`
+ * because a save file / cloud document is not guaranteed to match the type. The
+ * frame (`version`/`root`/`ui`) is validated here so downstream `deserialize*`
+ * paths can rely on `root` being a real node. Throws on a non-object document,
+ * a version newer than supported, or a missing/invalid root; an invalid `ui` is
+ * dropped (it is optional) rather than thrown.
+ *
+ * The migration chain is empty at v1; future version bumps register
+ * version→version+1 transforms here.
+ * @internal
+ */
+export declare function migrate(data: unknown): SerializedScene;
+//# sourceMappingURL=serialize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/serialize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,KAAK,EAAY,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAM1D,OAAO,EAAgC,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,EAAyB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAiB3F;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C;AAqFD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,EAAE,QAAQ,GAAE,qBAAoD,GAAG,cAAc,CAI3J;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,EAAE,QAAQ,GAAE,qBAAoD,GAAG,SAAS,CAI7J;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,cAAc,EACpB,MAAM,GAAE,MAAM,GAAG,IAAW,EAC5B,QAAQ,GAAE,qBAAoD,GAC7D,IAAI,CAgBN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAsBtD"}