@codexo/exojs 0.13.0 → 0.14.0

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

@@ -50,11 +50,26 @@ export declare class Time implements Cloneable {
     static readonly seconds: TimeInterval;
     static readonly minutes: TimeInterval;
     static readonly hours: TimeInterval;
+    /** Current high-resolution monotonic time (`performance.now()`) as a {@link Time}. */
+    static now(): Time;
+    /** Construct a {@link Time} from a millisecond count. */
+    static fromMilliseconds(value: number): Time;
+    /** Construct a {@link Time} from a second count. */
+    static fromSeconds(value: number): Time;
+    /** Construct a {@link Time} from a minute count. */
+    static fromMinutes(value: number): Time;
+    /** Construct a {@link Time} from an hour count. */
+    static fromHours(value: number): Time;
     static readonly zero: Time;
     static readonly oneMillisecond: Time;
     static readonly oneSecond: Time;
     static readonly oneMinute: Time;
     static readonly oneHour: Time;
+    /**
+     * Shared scratch {@link Time} instance for intermediate calculations. Never
+     * retain the reference across frames or async boundaries.
+     * @internal
+     */
     static get temp(): Time;
 }
 //# sourceMappingURL=Time.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../../src/core/Time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvD;;;;;;;;;;;GAWG;AACH,qBAAa,IAAK,YAAW,SAAS;IACpC,OAAO,CAAC,aAAa,CAAS;gBAEX,IAAI,SAAI,EAAE,MAAM,GAAE,YAAgC;IAIrE,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,YAAY,CAAC,YAAY,EAAE,MAAM,EAE3C;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,OAAO,CAAC,OAAO,EAAE,MAAM,EAEjC;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,OAAO,CAAC,OAAO,EAAE,MAAM,EAEjC;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED;;;;OAIG;IACI,GAAG,CAAC,IAAI,SAAI,EAAE,MAAM,GAAE,YAAgC,GAAG,IAAI;IAM7D,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAM3C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B,MAAM,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAE,OAAO,CAAC,IAAI,CAAM,GAAG,OAAO;IAS9E,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAIhC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAI7B,KAAK,IAAI,IAAI;IAIb,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAM7B,yEAAyE;IAClE,GAAG,CAAC,KAAK,SAAI,EAAE,MAAM,GAAE,YAAgC,GAAG,IAAI;IAMrE,gEAAgE;IACzD,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAMhC,8EAA8E;IACvE,QAAQ,CAAC,KAAK,SAAI,EAAE,MAAM,GAAE,YAAgC,GAAG,IAAI;IAM1E,qEAAqE;IAC9D,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAM9B,OAAO,IAAI,IAAI;IAItB,gBAAuB,YAAY,EAAE,YAAY,CAAK;IACtD,gBAAuB,OAAO,EAAE,YAAY,CAAQ;IACpD,gBAAuB,OAAO,EAAE,YAAY,CAAS;IACrD,gBAAuB,KAAK,EAAE,YAAY,CAAW;IAErD,gBAAuB,IAAI,OAAe;IAC1C,gBAAuB,cAAc,OAAe;IACpD,gBAAuB,SAAS,OAA6B;IAC7D,gBAAuB,SAAS,OAA6B;IAC7D,gBAAuB,OAAO,OAA2B;IAEzD,WAAkB,IAAI,IAAI,IAAI,CAM7B;CACF"}
+{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../../src/core/Time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvD;;;;;;;;;;;GAWG;AACH,qBAAa,IAAK,YAAW,SAAS;IACpC,OAAO,CAAC,aAAa,CAAS;gBAEX,IAAI,SAAI,EAAE,MAAM,GAAE,YAAgC;IAIrE,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED,IAAW,YAAY,CAAC,YAAY,EAAE,MAAM,EAE3C;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,OAAO,CAAC,OAAO,EAAE,MAAM,EAEjC;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,OAAO,CAAC,OAAO,EAAE,MAAM,EAEjC;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED;;;;OAIG;IACI,GAAG,CAAC,IAAI,SAAI,EAAE,MAAM,GAAE,YAAgC,GAAG,IAAI;IAM7D,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAM3C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B,MAAM,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAE,OAAO,CAAC,IAAI,CAAM,GAAG,OAAO;IAS9E,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAIhC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO;IAI7B,KAAK,IAAI,IAAI;IAIb,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAM7B,yEAAyE;IAClE,GAAG,CAAC,KAAK,SAAI,EAAE,MAAM,GAAE,YAAgC,GAAG,IAAI;IAMrE,gEAAgE;IACzD,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAMhC,8EAA8E;IACvE,QAAQ,CAAC,KAAK,SAAI,EAAE,MAAM,GAAE,YAAgC,GAAG,IAAI;IAM1E,qEAAqE;IAC9D,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAM9B,OAAO,IAAI,IAAI;IAItB,gBAAuB,YAAY,EAAE,YAAY,CAAK;IACtD,gBAAuB,OAAO,EAAE,YAAY,CAAQ;IACpD,gBAAuB,OAAO,EAAE,YAAY,CAAS;IACrD,gBAAuB,KAAK,EAAE,YAAY,CAAW;IAErD,sFAAsF;WACxE,GAAG,IAAI,IAAI;IAIzB,yDAAyD;WAC3C,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInD,oDAAoD;WACtC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9C,oDAAoD;WACtC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9C,mDAAmD;WACrC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5C,gBAAuB,IAAI,OAAe;IAC1C,gBAAuB,cAAc,OAAe;IACpD,gBAAuB,SAAS,OAA6B;IAC7D,gBAAuB,SAAS,OAA6B;IAC7D,gBAAuB,OAAO,OAA2B;IAEzD;;;;OAIG;IACH,WAAkB,IAAI,IAAI,IAAI,CAM7B;CACF"}

package/dist/esm/core/Time.js

@@ -111,11 +111,36 @@ class Time {
     static seconds = 1000;
     static minutes = 60000;
     static hours = 3600000;
+    /** Current high-resolution monotonic time (`performance.now()`) as a {@link Time}. */
+    static now() {
+        return new Time(performance.now());
+    }
+    /** Construct a {@link Time} from a millisecond count. */
+    static fromMilliseconds(value) {
+        return new Time(value, Time.milliseconds);
+    }
+    /** Construct a {@link Time} from a second count. */
+    static fromSeconds(value) {
+        return new Time(value, Time.seconds);
+    }
+    /** Construct a {@link Time} from a minute count. */
+    static fromMinutes(value) {
+        return new Time(value, Time.minutes);
+    }
+    /** Construct a {@link Time} from an hour count. */
+    static fromHours(value) {
+        return new Time(value, Time.hours);
+    }
     static zero = new Time(0);
     static oneMillisecond = new Time(1);
     static oneSecond = new Time(1, Time.seconds);
     static oneMinute = new Time(1, Time.minutes);
     static oneHour = new Time(1, Time.hours);
+    /**
+     * Shared scratch {@link Time} instance for intermediate calculations. Never
+     * retain the reference across frames or async boundaries.
+     * @internal
+     */
     static get temp() {
         if (temp === null) {
             temp = new Time();

package/dist/esm/core/Time.js.map

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

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

@@ -1,16 +1,21 @@
 /**
  * Assert `condition` at dev/test time. Throws with `[ExoJS] message` when the
  * condition is falsy and `__DEV__` is true. No-op in production builds.
+ *
+ * `message` is optional — omit it for invariant/in-bounds checks where the
+ * stack trace already localizes the failure. Prefer a constant string over a
+ * template literal: arguments are evaluated before the (stripped) body runs, so
+ * an interpolated message still allocates in production.
  */
-export declare function assert(condition: boolean, message: string): asserts condition;
+export declare function assert(condition: boolean, message?: string): asserts condition;
 /**
  * Assert that `value` is neither `null` nor `undefined`. Returns the value so
  * it can be used inline in an expression. No-op in production builds (returns
- * the value cast to `T` without checking).
+ * the value cast to `T` without checking). `message` is optional.
  */
-export declare function assertDefined<T>(value: T | null | undefined, message: string): T;
+export declare function assertDefined<T>(value: T | null | undefined, message?: string): T;
 /** @internal — alias for {@link assert}; kept for backward compatibility. */
-export declare function invariant(condition: boolean, message: string): asserts condition;
+export declare function invariant(condition: boolean, message?: string): asserts condition;
 /**
  * Print a `console.warn` at most once per unique `key`.
  * Subsequent calls with the same key are silenced to avoid per-frame spam.

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

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/core/dev.ts"],"names":[],"mappings":"AAiCA;;;GAGG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAKhF;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAM3D;AAED,mEAAmE;AACnE,wBAAgB,cAAc,IAAI,IAAI,CAErC"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/core/dev.ts"],"names":[],"mappings":"AAiCA;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAI9E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAKjF;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAM3D;AAED,mEAAmE;AACnE,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/esm/core/dev.js

@@ -31,6 +31,11 @@
 /**
  * Assert `condition` at dev/test time. Throws with `[ExoJS] message` when the
  * condition is falsy and `false` is true. No-op in production builds.
+ *
+ * `message` is optional — omit it for invariant/in-bounds checks where the
+ * stack trace already localizes the failure. Prefer a constant string over a
+ * template literal: arguments are evaluated before the (stripped) body runs, so
+ * an interpolated message still allocates in production.
  */
 function assert(condition, message) {
 }

package/dist/esm/core/dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.js","sources":["../../../../src/core/dev.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAIA;;;AAGG;AACG,SAAU,MAAM,CAAC,SAAkB,EAAE,OAAe,EAAA;AAI1D;;;;"}
+{"version":3,"file":"dev.js","sources":["../../../../src/core/dev.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAIA;;;;;;;;AAQG;AACG,SAAU,MAAM,CAAC,SAAkB,EAAE,OAAgB,EAAA;AAI3D;;;;"}

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

@@ -1,16 +1,27 @@
-export * from './Application';
-export * from './Bounds';
-export * from './BuildInfo';
-export * from './capabilities';
-export * from './Clock';
-export * from './Color';
-export * from './Perf';
-export * from './Scene';
-export * from './SceneManager';
-export * from './SceneNode';
-export * from './Signal';
-export * from './Time';
-export * from './Timer';
-export * from './types';
-export * from './utils';
+export type { ApplicationOptions, AutoBackendConfig, BackendConfig, CanvasApplicationOptions, CanvasSizingMode, InputApplicationOptions, RenderingApplicationOptions, WebGl2BackendConfig, WebGpuBackendConfig, } from './Application';
+export { Application, ApplicationStatus } from './Application';
+export { Bounds } from './Bounds';
+export type { BuildInfo } from './BuildInfo';
+export { buildInfo } from './BuildInfo';
+export { Capabilities } from './capabilities';
+export { Clock } from './Clock';
+export { Color } from './Color';
+export { DisposalScope } from './DisposalScope';
+export { Perf } from './Perf';
+export { Scene } from './Scene';
+export type { FadeSceneTransition, SceneTransition, SetSceneOptions } from './SceneManager';
+export { SceneManager } from './SceneManager';
+export { SceneNode } from './SceneNode';
+export type { DeserializeContext, NodeSerializer, SerializeContext } from './serialization/NodeSerializer';
+export { Prefab } from './serialization/Prefab';
+export type { SceneNodeConstructor } from './serialization/SerializationRegistry';
+export { registerSerializer, SerializationRegistry } from './serialization/SerializationRegistry';
+export type { AssetRef, SerializedNode, SerializedScene } from './serialization/types';
+export { SERIALIZATION_VERSION } from './serialization/types';
+export { Signal } from './Signal';
+export type { System } from './System';
+export { SystemRegistry } from './SystemRegistry';
+export { Time } from './Time';
+export { Timer } from './Timer';
+export type { Cloneable, Destroyable, HasBoundingBox, Mutable, PlaybackOptions, StreamingLoadEvent, TextureSource, TimeInterval, TypedArray, TypedEnum, ValueOf, } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAClG,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,SAAS,EACT,WAAW,EACX,cAAc,EACd,OAAO,EACP,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,SAAS,EACT,OAAO,GACR,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Geometry for the `'letterbox'` canvas sizing mode. Pure math, split out from
+ * {@link Application} so it can be unit-tested without a render backend.
+ * @internal
+ */
+/** Result of fitting a fixed design space into a parent for letterbox sizing. @internal */
+export interface LetterboxLayout {
+    /** CSS width of the centered canvas — the design-aspect content area. */
+    contentWidthCss: number;
+    /** CSS height of the centered canvas. */
+    contentHeightCss: number;
+    /** Backing-store width (`content × pixelRatio`) — the crisp native resolution. */
+    backingWidth: number;
+    /** Backing-store height. */
+    backingHeight: number;
+}
+/**
+ * Fit a `designWidth × designHeight` space into a parent of the given CSS size,
+ * preserving aspect ratio (letterbox — never crop, never stretch). Returns the
+ * centered content rectangle's CSS size and its native backing-store size at
+ * `pixelRatio`. The larger axis of the parent becomes the bars.
+ * @internal
+ */
+export declare const computeLetterboxLayout: (parentWidthCss: number, parentHeightCss: number, designWidth: number, designHeight: number, pixelRatio: number) => LetterboxLayout;
+//# sourceMappingURL=letterbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"letterbox.d.ts","sourceRoot":"","sources":["../../../src/core/letterbox.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,gBAAgB,MAAM,EACtB,iBAAiB,MAAM,EACvB,aAAa,MAAM,EACnB,cAAc,MAAM,EACpB,YAAY,MAAM,KACjB,eAWF,CAAC"}

package/dist/esm/core/letterbox.js

@@ -0,0 +1,26 @@
+/**
+ * Geometry for the `'letterbox'` canvas sizing mode. Pure math, split out from
+ * {@link Application} so it can be unit-tested without a render backend.
+ * @internal
+ */
+/**
+ * Fit a `designWidth × designHeight` space into a parent of the given CSS size,
+ * preserving aspect ratio (letterbox — never crop, never stretch). Returns the
+ * centered content rectangle's CSS size and its native backing-store size at
+ * `pixelRatio`. The larger axis of the parent becomes the bars.
+ * @internal
+ */
+const computeLetterboxLayout = (parentWidthCss, parentHeightCss, designWidth, designHeight, pixelRatio) => {
+    const scale = Math.min(parentWidthCss / designWidth, parentHeightCss / designHeight);
+    const contentWidthCss = designWidth * scale;
+    const contentHeightCss = designHeight * scale;
+    return {
+        contentWidthCss,
+        contentHeightCss,
+        backingWidth: Math.max(1, Math.round(contentWidthCss * pixelRatio)),
+        backingHeight: Math.max(1, Math.round(contentHeightCss * pixelRatio)),
+    };
+};
+
+export { computeLetterboxLayout };
+//# sourceMappingURL=letterbox.js.map

package/dist/esm/core/letterbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"letterbox.js","sources":["../../../../src/core/letterbox.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;AAIG;AAcH;;;;;;AAMG;AACI,MAAM,sBAAsB,GAAG,CACpC,cAAsB,EACtB,eAAuB,EACvB,WAAmB,EACnB,YAAoB,EACpB,UAAkB,KACC;AACnB,IAAA,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,WAAW,EAAE,eAAe,GAAG,YAAY,CAAC;AACpF,IAAA,MAAM,eAAe,GAAG,WAAW,GAAG,KAAK;AAC3C,IAAA,MAAM,gBAAgB,GAAG,YAAY,GAAG,KAAK;IAE7C,OAAO;QACL,eAAe;QACf,gBAAgB;AAChB,QAAA,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,UAAU,CAAC,CAAC;AACnE,QAAA,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,UAAU,CAAC,CAAC;KACtE;AACH;;;;"}

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

@@ -0,0 +1,71 @@
+import type { SceneNode } from '#core/SceneNode';
+import type { AssetConstructor } from '#resources/FactoryRegistry';
+import type { Loader } from '#resources/Loader';
+import type { SerializedNode } from './types';
+/**
+ * Context handed to {@link NodeSerializer.write}. Carries the framework
+ * services a type serializer needs: recursion into children and asset-key
+ * resolution. The framework writes the `SceneNode`/`RenderNode`/`Drawable`
+ * common fields and the `type` tag itself — a serializer only returns its own
+ * type-specific fields.
+ */
+export interface SerializeContext {
+    /** Format version being written ({@link SERIALIZATION_VERSION}). */
+    readonly version: number;
+    /** The loader used to resolve asset references, or `null` if none is available. */
+    readonly loader: Loader | null;
+    /**
+     * Fully serialize a child node — writes its `type` tag, common fields, and
+     * type-specific fields. Use this from container-like serializers to recurse.
+     */
+    writeNode(node: SceneNode): SerializedNode;
+    /**
+     * Resolve a loaded asset object to the loader source key it was loaded under,
+     * or `null` for runtime-created / unkeyed resources (a one-time warning is
+     * emitted in that case).
+     */
+    keyFor(resource: object | null | undefined): string | null;
+}
+/**
+ * Context handed to {@link NodeSerializer.read}. Mirror of
+ * {@link SerializeContext} for the inverse direction: child recursion and
+ * asset lookup. The framework applies the common fields after `read` returns,
+ * so a serializer only constructs the node and sets its type-specific fields.
+ */
+export interface DeserializeContext {
+    /** Format version of the document being read (after migration). */
+    readonly version: number;
+    /** The loader used to resolve asset references, or `null` if none is available. */
+    readonly loader: Loader | null;
+    /** Fully deserialize a child node (inverse of {@link SerializeContext.writeNode}). */
+    readNode(data: SerializedNode): SceneNode;
+    /**
+     * Resolve a serialized asset source key back to a loaded resource of `type`,
+     * or `null` if the source is missing/unset or the asset was not pre-loaded
+     * (a one-time warning is emitted in the not-loaded case).
+     */
+    resolveAsset<T>(source: string | null | undefined, type: AssetConstructor<T>): T | null;
+}
+/**
+ * Bidirectional serializer for one scene-graph node type. Registered against a
+ * type name + constructor in a {@link SerializationRegistry}. The framework
+ * owns the common transform/visual fields and the `type` tag; an implementation
+ * handles only the fields unique to its type.
+ *
+ * @typeParam T - the node type this serializer handles.
+ */
+export interface NodeSerializer<T extends SceneNode = SceneNode> {
+    /**
+     * Return the type-specific fields for `node` as a JSON-serialisable record.
+     * Do **not** include the `type` tag or common transform/visual fields — the
+     * framework adds those. Recurse into children via {@link SerializeContext.writeNode}.
+     */
+    write(node: T, ctx: SerializeContext): Record<string, unknown>;
+    /**
+     * Construct a fresh node from `data` and set its type-specific fields. The
+     * framework applies the common transform/visual fields afterwards, so do not
+     * read them here. Recurse into children via {@link DeserializeContext.readNode}.
+     */
+    read(data: SerializedNode, ctx: DeserializeContext): T;
+}
+//# sourceMappingURL=NodeSerializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSerializer.d.ts","sourceRoot":"","sources":["../../../../src/core/serialization/NodeSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc,CAAC;IAC3C;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;CAC5D;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,CAAC;IAC1C;;;;OAIG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;CACzF;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAC7D;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/D;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,kBAAkB,GAAG,CAAC,CAAC;CACxD"}

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"}