@codexo/exojs 0.13.0 → 0.14.0

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,CAiD5E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CA+C7E"}

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

@@ -0,0 +1,149 @@
+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.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;
+    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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"}

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;AAmVrE;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAQlF"}