@codexo/exojs 0.13.0 → 0.15.0

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

@@ -0,0 +1,144 @@
+import { applyCommonFields, writeCommonFields } from './commonFields.js';
+import { registerCoreSerializers } from './coreSerializers.js';
+import { asSerializedNode, asObject } from './read.js';
+import { defaultSerializationRegistry } from './SerializationRegistry.js';
+import { SERIALIZATION_VERSION } from './types.js';
+
+// Core serializers register lazily (not as an import side effect) so they
+// survive `sideEffects: false` tree-shaking: the registration is reachable
+// only through the framework entry points below, which a consumer must call.
+let _coreRegistered = false;
+/** Idempotently register the built-in node serializers on first use. @internal */
+function ensureCoreSerializers() {
+    if (_coreRegistered) {
+        return;
+    }
+    _coreRegistered = true;
+    registerCoreSerializers(defaultSerializationRegistry);
+}
+function createSerializeContext(loader, registry) {
+    const ctx = {
+        version: SERIALIZATION_VERSION,
+        loader,
+        writeNode: node => writeNodeWith(node, ctx, registry),
+        keyFor: resource => {
+            if (resource === null || resource === undefined || typeof resource !== 'object' || loader === null) {
+                return null;
+            }
+            const key = loader.keyFor(resource);
+            if (key === null) {
+                return null;
+            }
+            return key.source;
+        },
+    };
+    return ctx;
+}
+function createDeserializeContext(loader, version, registry) {
+    const ctx = {
+        version,
+        loader,
+        readNode: data => readNodeWith(data, ctx, registry),
+        resolveAsset: (source, type) => {
+            if (source === null || source === undefined || loader === null) {
+                return null;
+            }
+            const resource = loader.peek(type, source);
+            return resource;
+        },
+    };
+    return ctx;
+}
+function writeNodeWith(node, ctx, registry) {
+    const entry = registry.resolveByNode(node);
+    if (entry === undefined) {
+        throw new Error(`No serializer registered for node type "${node.constructor.name}". Register one via registerSerializer().`);
+    }
+    const out = { type: entry.typeName };
+    writeCommonFields(node, out);
+    Object.assign(out, entry.serializer.write(node, ctx));
+    return out;
+}
+function readNodeWith(data, ctx, registry) {
+    const entry = registry.resolveByName(data.type);
+    if (entry === undefined) {
+        throw new Error(`No serializer registered for type "${data.type}". Register one via registerSerializer().`);
+    }
+    const node = entry.serializer.read(data, ctx);
+    applyCommonFields(node, data);
+    return node;
+}
+/**
+ * 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
+ */
+function serializeTree(node, loader = null, registry = defaultSerializationRegistry) {
+    ensureCoreSerializers();
+    return writeNodeWith(node, createSerializeContext(loader, registry), registry);
+}
+/**
+ * Reconstruct a node subtree from a {@link SerializedNode}. Referenced assets
+ * must be pre-loaded into `loader`.
+ * @internal
+ */
+function deserializeTree(data, loader = null, registry = defaultSerializationRegistry) {
+    ensureCoreSerializers();
+    return readNodeWith(data, createDeserializeContext(loader, SERIALIZATION_VERSION, registry), registry);
+}
+/**
+ * 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
+ */
+function deserializeInto(container, data, loader = null, registry = defaultSerializationRegistry) {
+    ensureCoreSerializers();
+    const ctx = createDeserializeContext(loader, SERIALIZATION_VERSION, registry);
+    container.removeChildren();
+    applyCommonFields(container, data);
+    const children = data.children;
+    if (Array.isArray(children)) {
+        for (const child of children) {
+            const childNode = asSerializedNode(child);
+            if (childNode !== null)
+                container.addChild(ctx.readNode(childNode));
+        }
+    }
+}
+/**
+ * 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
+ */
+function migrate(data) {
+    const scene = asObject(data);
+    if (scene === null) {
+        throw new Error('Cannot deserialize scene: the document is not an object.');
+    }
+    const version = typeof scene.version === 'number' ? scene.version : 0;
+    if (version > SERIALIZATION_VERSION) {
+        throw new Error(`Cannot deserialize scene: data version ${version} is newer than the supported version ${SERIALIZATION_VERSION}.`);
+    }
+    const root = asSerializedNode(scene.root);
+    if (root === null) {
+        throw new Error('Cannot deserialize scene: the document has no valid root node.');
+    }
+    const ui = asSerializedNode(scene.ui);
+    return ui !== null ? { version, root, ui } : { version, root };
+}
+
+export { deserializeInto, deserializeTree, migrate, serializeTree };
+//# sourceMappingURL=serialize.js.map

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

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

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

@@ -0,0 +1,46 @@
+import { Color } from '#core/Color';
+import type { LayoutOptions } from '#rendering/text/LayoutOptions';
+import type { TextStyleOptions } from '#rendering/text/TextStyle';
+/**
+ * Return a shallow copy of `options` with every `undefined`-valued key removed,
+ * so an optional property is *omitted* rather than set to `undefined`. Lets a
+ * deserializer build an options bag from sparse JSON without forcing a default
+ * past a constructor's own `?? default` (and stays valid under
+ * `exactOptionalPropertyTypes`).
+ */
+export declare function compact<T extends object>(options: T): {
+    [K in keyof T]: Exclude<T[K], undefined>;
+};
+/** Serialize a colour to `[r, g, b, a]` (r/g/b 0..255, a 0..1). */
+export declare const colorToArray: (color: Color) => [number, number, number, number];
+/** Deserialize a `[r, g, b, a]` tuple back to a {@link Color}, or `undefined`. */
+export declare const arrayToColor: (value: unknown) => Color | undefined;
+/** Serialize the plain-data fields of a {@link TextStyle}, omitting defaults. */
+export declare function serializeStyle(style: {
+    fontFamily: string;
+    fontWeight: string;
+    fontStyle: string;
+    fontSize: number;
+    fillColor: Color;
+    outlineColor: Color;
+    outlineWidth: number;
+    align: string;
+    lineHeight: number;
+    leading: number;
+    shadowColor: Color;
+    shadowOffsetX: number;
+    shadowOffsetY: number;
+    shadowAlpha: number;
+    shadowBlur: number;
+    gradientColors: [Color, Color] | null;
+    gradientAxis: string;
+}): Record<string, unknown> | undefined;
+/** Rebuild {@link TextStyleOptions} from serialized style data, or `undefined`. */
+export declare function deserializeStyleOptions(data: unknown): TextStyleOptions | undefined;
+/**
+ * Rebuild {@link LayoutOptions} from a serialized layout object, dropping
+ * unknown or mistyped fields. Returns `undefined` when nothing valid remains,
+ * so a corrupt `layout` value degrades to the node's constructor defaults.
+ */
+export declare function readLayoutOptions(value: unknown): LayoutOptions | undefined;
+//# sourceMappingURL=serializerHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serializerHelpers.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/serializerHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CAAE,CAQlG;AAID,mEAAmE;AACnE,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,KAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAyC,CAAC;AAErH,kFAAkF;AAClF,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,KAAK,GAAG,SACsF,CAAC;AAM7I,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC;IACjB,YAAY,EAAE,KAAK,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,KAAK,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CA0BtC;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAoDnF;AAQD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CA8B3E"}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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