@codexo/exojs 0.13.0 → 0.15.0

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

@@ -0,0 +1,49 @@
+import type { SceneNode } from '#core/SceneNode';
+import type { Loader } from '#resources/Loader';
+import type { SerializationRegistry } from './SerializationRegistry';
+import type { SerializedNode } from './types';
+/**
+ * A reusable, data-driven template captured from a configured scene-graph
+ * subtree. Capture once with {@link Prefab.from}; stamp out independent copies
+ * with {@link instantiate} as many times as needed — no re-serialization per
+ * instance.
+ *
+ * A prefab holds the same **data, not behaviour** a scene serializer captures
+ * (structure, transforms, visuals, asset references). Re-attach behaviour
+ * (signal handlers, systems) in code after {@link instantiate}.
+ *
+ * ```ts
+ * const coin = Prefab.from(buildCoin(), loader);
+ * for (let i = 0; i < 10; i++) {
+ *   const node = coin.instantiate(loader);
+ *   node.setPosition(i * 32, 0);
+ *   scene.addChild(node);
+ * }
+ * ```
+ */
+export declare class Prefab {
+    private readonly _descriptor;
+    private constructor();
+    /**
+     * Capture `node`'s subtree as a prefab. Pass the {@link Loader} so texture and
+     * other asset references resolve to their source keys. Pass `app.serializers`
+     * as `registry` to resolve app-scoped (extension) serializers; defaults to the
+     * global registry.
+     */
+    static from(node: SceneNode, loader?: Loader | null, registry?: SerializationRegistry): Prefab;
+    /**
+     * Build a prefab from a previously serialized descriptor — e.g. one produced
+     * by {@link toJSON} and persisted to disk or fetched over the network.
+     */
+    static fromJSON(descriptor: SerializedNode): Prefab;
+    /**
+     * Instantiate a fresh, independent copy of the captured subtree. Referenced
+     * assets must be pre-loaded into `loader`. Call repeatedly for many instances.
+     * Pass `app.serializers` as `registry` to resolve app-scoped (extension)
+     * serializers; defaults to the global registry.
+     */
+    instantiate(loader?: Loader | null, registry?: SerializationRegistry): SceneNode;
+    /** The underlying JSON descriptor (JSON-serialisable). Treat as read-only. The standard `JSON.stringify(prefab)` hook. */
+    toJSON(): SerializedNode;
+}
+//# sourceMappingURL=Prefab.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Prefab.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/Prefab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,MAAM;IACG,OAAO,CAAC,QAAQ,CAAC,WAAW;IAAhD,OAAO;IAEP;;;;;OAKG;WACW,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,MAAM;IAI3G;;;OAGG;WAEW,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM;IAI1D;;;;;OAKG;IACI,WAAW,CAAC,MAAM,GAAE,MAAM,GAAG,IAAW,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,SAAS;IAI7F,0HAA0H;IAEnH,MAAM,IAAI,cAAc;CAGhC"}

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

@@ -0,0 +1,61 @@
+import { serializeTree, deserializeTree } from './serialize.js';
+
+/**
+ * A reusable, data-driven template captured from a configured scene-graph
+ * subtree. Capture once with {@link Prefab.from}; stamp out independent copies
+ * with {@link instantiate} as many times as needed — no re-serialization per
+ * instance.
+ *
+ * A prefab holds the same **data, not behaviour** a scene serializer captures
+ * (structure, transforms, visuals, asset references). Re-attach behaviour
+ * (signal handlers, systems) in code after {@link instantiate}.
+ *
+ * ```ts
+ * const coin = Prefab.from(buildCoin(), loader);
+ * for (let i = 0; i < 10; i++) {
+ *   const node = coin.instantiate(loader);
+ *   node.setPosition(i * 32, 0);
+ *   scene.addChild(node);
+ * }
+ * ```
+ */
+class Prefab {
+    _descriptor;
+    constructor(_descriptor) {
+        this._descriptor = _descriptor;
+    }
+    /**
+     * Capture `node`'s subtree as a prefab. Pass the {@link Loader} so texture and
+     * other asset references resolve to their source keys. Pass `app.serializers`
+     * as `registry` to resolve app-scoped (extension) serializers; defaults to the
+     * global registry.
+     */
+    static from(node, loader = null, registry) {
+        return new Prefab(serializeTree(node, loader, registry));
+    }
+    /**
+     * Build a prefab from a previously serialized descriptor — e.g. one produced
+     * by {@link toJSON} and persisted to disk or fetched over the network.
+     */
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- mirrors the standard `toJSON` JSON convention
+    static fromJSON(descriptor) {
+        return new Prefab(descriptor);
+    }
+    /**
+     * Instantiate a fresh, independent copy of the captured subtree. Referenced
+     * assets must be pre-loaded into `loader`. Call repeatedly for many instances.
+     * Pass `app.serializers` as `registry` to resolve app-scoped (extension)
+     * serializers; defaults to the global registry.
+     */
+    instantiate(loader = null, registry) {
+        return deserializeTree(this._descriptor, loader, registry);
+    }
+    /** The underlying JSON descriptor (JSON-serialisable). Treat as read-only. The standard `JSON.stringify(prefab)` hook. */
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- `toJSON` is the standard JSON.stringify hook name
+    toJSON() {
+        return this._descriptor;
+    }
+}
+
+export { Prefab };
+//# sourceMappingURL=Prefab.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Prefab.js","sources":["../../../../../src/core/serialization/Prefab.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAOA;;;;;;;;;;;;;;;;;;AAkBG;MACU,MAAM,CAAA;AACoB,IAAA,WAAA;AAArC,IAAA,WAAA,CAAqC,WAA2B,EAAA;QAA3B,IAAA,CAAA,WAAW,GAAX,WAAW;IAAmB;AAEnE;;;;;AAKG;IACI,OAAO,IAAI,CAAC,IAAe,EAAE,MAAA,GAAwB,IAAI,EAAE,QAAgC,EAAA;AAChG,QAAA,OAAO,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1D;AAEA;;;AAGG;;IAEI,OAAO,QAAQ,CAAC,UAA0B,EAAA;AAC/C,QAAA,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC;IAC/B;AAEA;;;;;AAKG;AACI,IAAA,WAAW,CAAC,MAAA,GAAwB,IAAI,EAAE,QAAgC,EAAA;QAC/E,OAAO,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC;IAC5D;;;IAIO,MAAM,GAAA;QACX,OAAO,IAAI,CAAC,WAAW;IACzB;AACD;;;;"}

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

@@ -0,0 +1,95 @@
+import type { SceneNode } from '#core/SceneNode';
+import type { NodeSerializer } from './NodeSerializer';
+/**
+ * Any abstract or concrete {@link SceneNode} constructor usable as a
+ * serialization key.
+ */
+export type SceneNodeConstructor<T extends SceneNode = SceneNode> = abstract new (...args: any[]) => T;
+/**
+ * Resolved registry record pairing a type name with its constructor and
+ * serializer.
+ * @internal
+ */
+export interface SerializerEntry {
+    readonly typeName: string;
+    readonly ctor: SceneNodeConstructor;
+    readonly serializer: NodeSerializer;
+}
+/**
+ * Bidirectional name ↔ constructor ↔ {@link NodeSerializer} registry backing
+ * the scene serializer.
+ *
+ * Serialize resolves a node to its serializer by walking the constructor's
+ * prototype chain (so a subclass without its own registration inherits the
+ * nearest registered base serializer); deserialize resolves by type name.
+ * Core registers the built-in node types; extensions contribute their own via
+ * the {@link Extension.serializers} binding.
+ *
+ * @see registerSerializer for the convenience entry point onto the
+ * {@link defaultSerializationRegistry}.
+ */
+export declare class SerializationRegistry {
+    private readonly _fallback;
+    private readonly _byCtor;
+    private readonly _byName;
+    /**
+     * @param _fallback Optional parent registry consulted when this registry has
+     *   no own entry for a lookup. An {@link Application} owns its own registry
+     *   chained to the {@link defaultSerializationRegistry}, so app-scoped
+     *   extension serializers stay isolated per Application while core and
+     *   globally-registered serializers remain shared.
+     */
+    constructor(_fallback?: SerializationRegistry | null);
+    /**
+     * Register `serializer` for `ctor` under `typeName`. Re-registering the same
+     * `(typeName, ctor)` pair overwrites silently; registering an existing
+     * `typeName` against a **different** constructor throws.
+     */
+    register<T extends SceneNode>(typeName: string, ctor: SceneNodeConstructor<T>, serializer: NodeSerializer<T>): void;
+    /**
+     * Resolve the serializer for `node` by walking its constructor's prototype
+     * chain. Returns `undefined` if no registration matches.
+     * @internal
+     */
+    resolveByNode(node: SceneNode): SerializerEntry | undefined;
+    /**
+     * Resolve the serializer registered under `typeName`, or `undefined`.
+     * @internal
+     */
+    resolveByName(typeName: string): SerializerEntry | undefined;
+    /** Returns `true` if a serializer is registered under `typeName`. */
+    hasType(typeName: string): boolean;
+    /**
+     * Remove every own registration (both the name and constructor maps). The
+     * fallback chain is left untouched. Test infrastructure only — used to reset
+     * the {@link defaultSerializationRegistry} between suites so process-wide
+     * registrations do not leak across them.
+     * @internal
+     */
+    clear(): void;
+}
+/**
+ * Process-wide default registry. Core node serializers register here lazily on
+ * first use; extension serializers are materialised here at Application
+ * construction.
+ */
+export declare const defaultSerializationRegistry: SerializationRegistry;
+/**
+ * Register a custom {@link NodeSerializer}. Defaults to the
+ * {@link defaultSerializationRegistry}; pass `app.serializers` to register the
+ * type only for that {@link Application} (it stays isolated from other apps and
+ * from the global registry, resolving through the fallback chain).
+ *
+ * Use this to make your own {@link SceneNode} subclasses serializable. Delegate
+ * to a base type's behaviour by composing with the framework helpers, or
+ * register a fully custom serializer.
+ *
+ * ```ts
+ * registerSerializer('PowerUp', PowerUp, {
+ *   write: (node) => ({ kind: node.kind }),
+ *   read: (data) => new PowerUp(typeof data.kind === 'string' ? data.kind : ''),
+ * });
+ * ```
+ */
+export declare function registerSerializer<T extends SceneNode>(typeName: string, ctor: SceneNodeConstructor<T>, serializer: NodeSerializer<T>, registry?: SerializationRegistry): void;
+//# sourceMappingURL=SerializationRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/SerializationRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;GAGG;AAEH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEvG;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;CACrC;AASD;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAqB;IAWb,OAAO,CAAC,QAAQ,CAAC,SAAS;IAV7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgF;IACxG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAE9D;;;;;;OAMG;gBACiC,SAAS,GAAE,qBAAqB,GAAG,IAAW;IAElF;;;;OAIG;IACI,QAAQ,CAAC,CAAC,SAAS,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAa1H;;;;OAIG;IACI,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS;IAIlE;;;OAGG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAInE,qEAAqE;IAC9D,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;;OAMG;IACI,KAAK,IAAI,IAAI;CAIrB;AAED;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,uBAA8B,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS,EACpD,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAC7B,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,EAC7B,QAAQ,GAAE,qBAAoD,GAC7D,IAAI,CAEN"}

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

@@ -0,0 +1,108 @@
+import { Registry } from '../Registry.js';
+
+/** Walk one step up the constructor's prototype chain, or stop at the base. */
+const walkPrototype = (ctor) => {
+    const parent = Object.getPrototypeOf(ctor);
+    return typeof parent === 'function' && parent !== Function.prototype ? parent : null;
+};
+/**
+ * Bidirectional name ↔ constructor ↔ {@link NodeSerializer} registry backing
+ * the scene serializer.
+ *
+ * Serialize resolves a node to its serializer by walking the constructor's
+ * prototype chain (so a subclass without its own registration inherits the
+ * nearest registered base serializer); deserialize resolves by type name.
+ * Core registers the built-in node types; extensions contribute their own via
+ * the {@link Extension.serializers} binding.
+ *
+ * @see registerSerializer for the convenience entry point onto the
+ * {@link defaultSerializationRegistry}.
+ */
+class SerializationRegistry {
+    _fallback;
+    _byCtor = new Registry({ walk: walkPrototype });
+    _byName = new Map();
+    /**
+     * @param _fallback Optional parent registry consulted when this registry has
+     *   no own entry for a lookup. An {@link Application} owns its own registry
+     *   chained to the {@link defaultSerializationRegistry}, so app-scoped
+     *   extension serializers stay isolated per Application while core and
+     *   globally-registered serializers remain shared.
+     */
+    constructor(_fallback = null) {
+        this._fallback = _fallback;
+    }
+    /**
+     * Register `serializer` for `ctor` under `typeName`. Re-registering the same
+     * `(typeName, ctor)` pair overwrites silently; registering an existing
+     * `typeName` against a **different** constructor throws.
+     */
+    register(typeName, ctor, serializer) {
+        const existing = this._byName.get(typeName);
+        if (existing !== undefined && existing.ctor !== ctor) {
+            throw new Error(`A serializer for type name "${typeName}" is already registered for a different constructor.`);
+        }
+        const entry = { typeName, ctor, serializer };
+        this._byCtor.set(ctor, entry);
+        this._byName.set(typeName, entry);
+    }
+    /**
+     * Resolve the serializer for `node` by walking its constructor's prototype
+     * chain. Returns `undefined` if no registration matches.
+     * @internal
+     */
+    resolveByNode(node) {
+        return this._byCtor.resolve(node.constructor) ?? this._fallback?.resolveByNode(node);
+    }
+    /**
+     * Resolve the serializer registered under `typeName`, or `undefined`.
+     * @internal
+     */
+    resolveByName(typeName) {
+        return this._byName.get(typeName) ?? this._fallback?.resolveByName(typeName);
+    }
+    /** Returns `true` if a serializer is registered under `typeName`. */
+    hasType(typeName) {
+        return this._byName.has(typeName) || (this._fallback?.hasType(typeName) ?? false);
+    }
+    /**
+     * Remove every own registration (both the name and constructor maps). The
+     * fallback chain is left untouched. Test infrastructure only — used to reset
+     * the {@link defaultSerializationRegistry} between suites so process-wide
+     * registrations do not leak across them.
+     * @internal
+     */
+    clear() {
+        this._byName.clear();
+        this._byCtor.destroy();
+    }
+}
+/**
+ * Process-wide default registry. Core node serializers register here lazily on
+ * first use; extension serializers are materialised here at Application
+ * construction.
+ */
+const defaultSerializationRegistry = new SerializationRegistry();
+/**
+ * Register a custom {@link NodeSerializer}. Defaults to the
+ * {@link defaultSerializationRegistry}; pass `app.serializers` to register the
+ * type only for that {@link Application} (it stays isolated from other apps and
+ * from the global registry, resolving through the fallback chain).
+ *
+ * Use this to make your own {@link SceneNode} subclasses serializable. Delegate
+ * to a base type's behaviour by composing with the framework helpers, or
+ * register a fully custom serializer.
+ *
+ * ```ts
+ * registerSerializer('PowerUp', PowerUp, {
+ *   write: (node) => ({ kind: node.kind }),
+ *   read: (data) => new PowerUp(typeof data.kind === 'string' ? data.kind : ''),
+ * });
+ * ```
+ */
+function registerSerializer(typeName, ctor, serializer, registry = defaultSerializationRegistry) {
+    registry.register(typeName, ctor, serializer);
+}
+
+export { SerializationRegistry, defaultSerializationRegistry, registerSerializer };
+//# sourceMappingURL=SerializationRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SerializationRegistry.js","sources":["../../../../../src/core/serialization/SerializationRegistry.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAuBA;AACA,MAAM,aAAa,GAAG,CAAC,IAA0B,KAAiC;IAChF,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAY;AAErD,IAAA,OAAO,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,QAAQ,CAAC,SAAS,GAAI,MAA+B,GAAG,IAAI;AAChH,CAAC;AAED;;;;;;;;;;;;AAYG;MACU,qBAAqB,CAAA;AAWI,IAAA,SAAA;IAVnB,OAAO,GAAG,IAAI,QAAQ,CAAwC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AACtF,IAAA,OAAO,GAAG,IAAI,GAAG,EAA2B;AAE7D;;;;;;AAMG;AACH,IAAA,WAAA,CAAoC,YAA0C,IAAI,EAAA;QAA9C,IAAA,CAAA,SAAS,GAAT,SAAS;IAAwC;AAErF;;;;AAIG;AACI,IAAA,QAAQ,CAAsB,QAAgB,EAAE,IAA6B,EAAE,UAA6B,EAAA;QACjH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAE3C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE;AACpD,YAAA,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAA,oDAAA,CAAsD,CAAC;QAChH;QAEA,MAAM,KAAK,GAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE;QAE7D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC;IACnC;AAEA;;;;AAIG;AACI,IAAA,aAAa,CAAC,IAAe,EAAA;AAClC,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,WAAmC,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC;IAC9G;AAEA;;;AAGG;AACI,IAAA,aAAa,CAAC,QAAgB,EAAA;AACnC,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC;IAC9E;;AAGO,IAAA,OAAO,CAAC,QAAgB,EAAA;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;IACnF;AAEA;;;;;;AAMG;IACI,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;AACpB,QAAA,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;IACxB;AACD;AAED;;;;AAIG;AACI,MAAM,4BAA4B,GAAG,IAAI,qBAAqB;AAErE;;;;;;;;;;;;;;;;AAgBG;AACG,SAAU,kBAAkB,CAChC,QAAgB,EAChB,IAA6B,EAC7B,UAA6B,EAC7B,QAAA,GAAkC,4BAA4B,EAAA;IAE9D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC;AAC/C;;;;"}

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

@@ -0,0 +1,20 @@
+import type { SceneNode } from '#core/SceneNode';
+import type { SerializedNode } from './types';
+/**
+ * Write the common `SceneNode` (+ `Drawable`) fields of `node` into `out`.
+ *
+ * Only non-default values are written, so a freshly-constructed node
+ * contributes nothing here. Transforms are emitted in logical units
+ * (px / degrees); the `Drawable` tint is `[r, g, b, a]` with `r/g/b` in 0..255
+ * and `a` in 0..1. Runtime caches, matrices and dirty flags are never written.
+ */
+export declare function writeCommonFields(node: SceneNode, out: SerializedNode): void;
+/**
+ * Apply the common fields from `data` onto an already-constructed `node`.
+ *
+ * Called by the framework after a {@link NodeSerializer.read} returns, so it
+ * overrides any transform side-effects of construction (e.g. a `Sprite` frame
+ * resetting scale). Absent fields keep the node's constructed defaults.
+ */
+export declare function applyCommonFields(node: SceneNode, data: SerializedNode): void;
+//# sourceMappingURL=commonFields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commonFields.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/commonFields.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAOjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAkD5E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAsD7E"}

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

@@ -0,0 +1,155 @@
+import { Color } from '../Color.js';
+import { Rectangle } from '../../math/Rectangle.js';
+import { Drawable } from '../../rendering/Drawable.js';
+import { isPixelSnapMode } from '../../rendering/pixelSnap.js';
+import { RenderNode } from '../../rendering/RenderNode.js';
+import { BlendModes } from '../../rendering/types.js';
+
+/**
+ * Write the common `SceneNode` (+ `Drawable`) fields of `node` into `out`.
+ *
+ * Only non-default values are written, so a freshly-constructed node
+ * contributes nothing here. Transforms are emitted in logical units
+ * (px / degrees); the `Drawable` tint is `[r, g, b, a]` with `r/g/b` in 0..255
+ * and `a` in 0..1. Runtime caches, matrices and dirty flags are never written.
+ */
+function writeCommonFields(node, out) {
+    if (node.x !== 0)
+        out.x = node.x;
+    if (node.y !== 0)
+        out.y = node.y;
+    if (node.rotation !== 0)
+        out.rotation = node.rotation;
+    if (node.scale.x !== 1)
+        out.scaleX = node.scale.x;
+    if (node.scale.y !== 1)
+        out.scaleY = node.scale.y;
+    if (node.skewX !== 0)
+        out.skewX = node.skewX;
+    if (node.skewY !== 0)
+        out.skewY = node.skewY;
+    if (node.origin.x !== 0)
+        out.originX = node.origin.x;
+    if (node.origin.y !== 0)
+        out.originY = node.origin.y;
+    if (!node.visible)
+        out.visible = false;
+    if (node.zIndex !== 0)
+        out.zIndex = node.zIndex;
+    if (!node.cullable)
+        out.cullable = false;
+    if (node.cullArea !== null)
+        out.cullArea = [node.cullArea.x, node.cullArea.y, node.cullArea.width, node.cullArea.height];
+    if (node.name !== null)
+        out.name = node.name;
+    if (node instanceof RenderNode) {
+        if (node.interactive)
+            out.interactive = true;
+        if (node.draggable)
+            out.draggable = true;
+        if (node.focusable)
+            out.focusable = true;
+        if (node.tabIndex !== 0)
+            out.tabIndex = node.tabIndex;
+        if (node.cursor !== null)
+            out.cursor = node.cursor;
+        if (node.clip)
+            out.clip = true;
+        if (node.preserveDrawOrder)
+            out.preserveDrawOrder = true;
+        if (node.cacheAsBitmap)
+            out.cacheAsBitmap = true;
+        const clipShape = node.clipShape;
+        if (clipShape instanceof Rectangle) {
+            out.clipShape = [clipShape.x, clipShape.y, clipShape.width, clipShape.height];
+        }
+    }
+    if (node instanceof Drawable) {
+        const tint = node.tint;
+        if (tint.r !== 255 || tint.g !== 255 || tint.b !== 255 || tint.a !== 1) {
+            out.tint = [tint.r, tint.g, tint.b, tint.a];
+        }
+        if (node.blendMode !== BlendModes.Normal) {
+            out.blendMode = node.blendMode;
+        }
+        if (node.pixelSnapMode !== 'none') {
+            out.pixelSnapMode = node.pixelSnapMode;
+        }
+    }
+}
+/**
+ * Apply the common fields from `data` onto an already-constructed `node`.
+ *
+ * Called by the framework after a {@link NodeSerializer.read} returns, so it
+ * overrides any transform side-effects of construction (e.g. a `Sprite` frame
+ * resetting scale). Absent fields keep the node's constructed defaults.
+ */
+function applyCommonFields(node, data) {
+    if (typeof data.x === 'number')
+        node.x = data.x;
+    if (typeof data.y === 'number')
+        node.y = data.y;
+    if (typeof data.rotation === 'number')
+        node.rotation = data.rotation;
+    if (typeof data.scaleX === 'number')
+        node.scale.x = data.scaleX;
+    if (typeof data.scaleY === 'number')
+        node.scale.y = data.scaleY;
+    if (typeof data.skewX === 'number')
+        node.skewX = data.skewX;
+    if (typeof data.skewY === 'number')
+        node.skewY = data.skewY;
+    if (typeof data.originX === 'number')
+        node.origin.x = data.originX;
+    if (typeof data.originY === 'number')
+        node.origin.y = data.originY;
+    if (data.visible === false)
+        node.visible = false;
+    if (typeof data.zIndex === 'number')
+        node.zIndex = data.zIndex;
+    if (data.cullable === false)
+        node.cullable = false;
+    const cullArea = data.cullArea;
+    if (Array.isArray(cullArea) && cullArea.length === 4) {
+        node.cullArea = new Rectangle(Number(cullArea[0]), Number(cullArea[1]), Number(cullArea[2]), Number(cullArea[3]));
+    }
+    if (typeof data.name === 'string')
+        node.name = data.name;
+    if (node instanceof RenderNode) {
+        if (data.interactive === true)
+            node.interactive = true;
+        if (data.draggable === true)
+            node.draggable = true;
+        if (data.focusable === true)
+            node.focusable = true;
+        if (typeof data.tabIndex === 'number')
+            node.tabIndex = data.tabIndex;
+        if (typeof data.cursor === 'string')
+            node.cursor = data.cursor;
+        if (data.clip === true)
+            node.clip = true;
+        if (data.preserveDrawOrder === true)
+            node.preserveDrawOrder = true;
+        if (data.cacheAsBitmap === true)
+            node.cacheAsBitmap = true;
+        const clipShape = data.clipShape;
+        if (Array.isArray(clipShape) && clipShape.length === 4) {
+            node.clipShape = new Rectangle(Number(clipShape[0]), Number(clipShape[1]), Number(clipShape[2]), Number(clipShape[3]));
+        }
+    }
+    if (node instanceof Drawable) {
+        const tint = data.tint;
+        if (Array.isArray(tint) && tint.length === 4) {
+            node.tint = new Color(Number(tint[0]), Number(tint[1]), Number(tint[2]), Number(tint[3]));
+        }
+        if (typeof data.blendMode === 'number') {
+            node.blendMode = data.blendMode;
+        }
+        if (typeof data.pixelSnapMode === 'string' && isPixelSnapMode(data.pixelSnapMode)) {
+            node.pixelSnapMode = data.pixelSnapMode;
+        }
+    }
+}
+
+export { applyCommonFields, writeCommonFields };
+//# sourceMappingURL=commonFields.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { SerializationRegistry } from './SerializationRegistry';
+/**
+ * Register all built-in node serializers (core leaf types + rendering package +
+ * UI widgets) on `registry`. Called once, lazily, from the serialization
+ * framework.
+ * @internal
+ */
+export declare function registerCoreSerializers(registry: SerializationRegistry): void;
+//# sourceMappingURL=coreSerializers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreSerializers.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/coreSerializers.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAoGrE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAO7E"}

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

@@ -0,0 +1,101 @@
+import { Rectangle } from '../../math/Rectangle.js';
+import { Container } from '../../rendering/Container.js';
+import { Sprite } from '../../rendering/sprite/Sprite.js';
+import { Text } from '../../rendering/text/Text.js';
+import { Texture } from '../../rendering/texture/Texture.js';
+import { asSerializedNode } from './read.js';
+import { registerRenderingSerializers } from './renderingSerializers.js';
+import { readLayoutOptions, compact, deserializeStyleOptions, serializeStyle } from './serializerHelpers.js';
+import { registerUiSerializers } from './uiSerializers.js';
+import { SDF_RADIUS } from '../../rendering/text/GlyphAtlas.js';
+
+// ── Container ────────────────────────────────────────────────────────────────
+const containerSerializer = {
+    write(node, ctx) {
+        if (node.children.length === 0) {
+            return {};
+        }
+        return { children: node.children.map(child => ctx.writeNode(child)) };
+    },
+    read(data, ctx) {
+        const node = new Container();
+        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;
+    },
+};
+// ── Sprite ─────────────────────────────────────────────────────────────────
+const spriteSerializer = {
+    write(node, ctx) {
+        const out = {};
+        const source = ctx.keyFor(node.texture);
+        if (source !== null) {
+            out.texture = source;
+        }
+        if (node.material !== null) ;
+        const texture = node.texture;
+        const frame = node.textureFrame;
+        // Emit the frame only for sub-regions (spritesheets); a full-texture frame
+        // is reconstructed for free by `new Sprite(texture)`.
+        if (texture !== null && (frame.x !== 0 || frame.y !== 0 || frame.width !== texture.width || frame.height !== texture.height)) {
+            out.frame = [frame.x, frame.y, frame.width, frame.height];
+        }
+        return out;
+    },
+    read(data, ctx) {
+        const texture = ctx.resolveAsset(typeof data.texture === 'string' ? data.texture : null, Texture);
+        const sprite = new Sprite(texture);
+        const frame = data.frame;
+        if (texture !== null && Array.isArray(frame) && frame.length === 4) {
+            sprite.setTextureFrame(Rectangle.temp.set(Number(frame[0]), Number(frame[1]), Number(frame[2]), Number(frame[3])));
+        }
+        return sprite;
+    },
+};
+// ── Text ─────────────────────────────────────────────────────────────────────
+const textSerializer = {
+    write(node) {
+        const out = { text: node.text };
+        const style = serializeStyle(node.style);
+        if (style !== undefined)
+            out.style = style;
+        if (Object.keys(node.layout).length > 0)
+            out.layout = { ...node.layout };
+        if (node.colorGlyphs)
+            out.colorGlyphs = true;
+        if (node.sdfRadius !== SDF_RADIUS)
+            out.sdfRadius = node.sdfRadius;
+        return out;
+    },
+    read(data) {
+        const layout = readLayoutOptions(data.layout);
+        return new Text(typeof data.text === 'string' ? data.text : '', compact({
+            ...deserializeStyleOptions(data.style),
+            ...layout,
+            colorGlyphs: data.colorGlyphs === true,
+            sdfRadius: typeof data.sdfRadius === 'number' ? data.sdfRadius : undefined,
+        }));
+    },
+};
+/**
+ * Register all built-in node serializers (core leaf types + rendering package +
+ * UI widgets) on `registry`. Called once, lazily, from the serialization
+ * framework.
+ * @internal
+ */
+function registerCoreSerializers(registry) {
+    registry.register('Container', Container, containerSerializer);
+    registry.register('Sprite', Sprite, spriteSerializer);
+    registry.register('Text', Text, textSerializer);
+    registerRenderingSerializers(registry);
+    registerUiSerializers(registry);
+}
+
+export { registerCoreSerializers };
+//# sourceMappingURL=coreSerializers.js.map

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

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