@codexo/exojs 0.12.0 → 0.14.0

package/dist/esm/extensions/materialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../../../src/extensions/materialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAgB,eAAe,EAAE,MAAM,aAAa,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAsB9G;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAsChG"}
+{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../../../src/extensions/materialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAgB,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAElG;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAsB9G;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CA6ChG;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,qBAAqB,EAAE,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI,CAI3H"}

package/dist/esm/extensions/materialize.js

@@ -53,9 +53,24 @@ function materializeAssetBindings(loader, bindings) {
     // --- Materialise: all pre-validation passed ---
     for (const binding of bindings) {
         const handler = binding.create(loader);
-        loader.bindAsset({ type: binding.type, typeNames: binding.typeNames, extensions: binding.extensions }, handler);
+        loader.bindAsset({
+            type: binding.type,
+            ...(binding.typeNames !== undefined && { typeNames: binding.typeNames }),
+            ...(binding.extensions !== undefined && { extensions: binding.extensions }),
+        }, handler);
+    }
+}
+/**
+ * Materialise all serializer bindings into the scene serialization registry.
+ * Called once per Application construction. A conflict (same type name bound to
+ * a different constructor) throws via {@link SerializationRegistry.register}.
+ * @internal
+ */
+function materializeSerializerBindings(registry, bindings) {
+    for (const binding of bindings) {
+        registry.register(binding.typeName, binding.target, binding.serializer);
     }
 }
 
-export { materializeAssetBindings, materializeRendererBindings };
+export { materializeAssetBindings, materializeRendererBindings, materializeSerializerBindings };
 //# sourceMappingURL=materialize.js.map

package/dist/esm/extensions/materialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"materialize.js","sources":["../../../../src/extensions/materialize.ts"],"sourcesContent":[null],"names":[],"mappings":"AAOA;;;;AAIG;AACG,SAAU,2BAA2B,CAAC,OAAsB,EAAE,QAAoC,EAAA;AACtG,IAAA,MAAM,WAAW,GAAG,IAAI,GAAG,EAAuB;AAElD,IAAA,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;QAC9B,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;AAChC,YAAA,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC;QACxE;AAEA,QAAA,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE;AACpC,YAAA,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;gBAC3B,MAAM,IAAI,KAAK,CAAC,CAAA,2CAAA,EAA8C,MAAM,CAAC,IAAI,CAAA,yCAAA,CAA2C,CAAC;YACvH;AAEA,YAAA,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC;QACzB;QAEA,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;QAExC,IAAI,QAAQ,KAAK,SAAS;YAAE;QAE5B,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,QAA2C,CAAC;IACrG;AACF;AAEA;;;;AAIG;AACG,SAAU,wBAAwB,CAAC,MAAc,EAAE,QAAiC,EAAA;;AAExF,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB;AAC7C,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU;AACnC,IAAA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU;AAElC,IAAA,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;AAC9B,QAAA,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACnE,MAAM,IAAI,KAAK,CAAC,CAAA,2CAAA,EAA8C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,CAAA,CAAG,CAAC;QACrF;QAEA,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE,EAAE;AAC1C,YAAA,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE;AACpD,gBAAA,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAA,wDAAA,CAA0D,CAAC;YACrG;AAEA,YAAA,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;QACrB;QAEA,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,EAAE;AAC1C,YAAA,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE;AAEhD,YAAA,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE;AACjD,gBAAA,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAA,qEAAA,CAAuE,CAAC;YACjH;AAEA,YAAA,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QACnB;AAEA,QAAA,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7B;;AAGA,IAAA,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;QAC9B,MAAM,OAAO,GAAiB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QAEpD,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC;IACjH;AACF;;;;"}
+{"version":3,"file":"materialize.js","sources":["../../../../src/extensions/materialize.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/extensions/snapshot.d.ts

@@ -1,14 +1,25 @@
-import type { AssetBinding, Extension, RendererBinding } from './Extension';
+import type { AssetBinding, Extension, RendererBinding, SerializerBinding } from './Extension';
 export interface ExtensionSnapshot {
     readonly extensions: ReadonlyArray<Readonly<Extension>>;
     readonly renderers: readonly RendererBinding[];
     readonly assets: readonly AssetBinding[];
+    readonly serializers: readonly SerializerBinding[];
 }
 declare const emptySnapshot: ExtensionSnapshot;
 export { emptySnapshot as EMPTY_SNAPSHOT };
 /**
- * Flatten an ordered extension list into a snapshot.
- * De-duplicates same-id/same-object entries; throws on same-id/different-object.
+ * Freeze an extension descriptor and its nested arrays in development builds.
+ * Idempotent — safe to call on already-frozen descriptors.
+ * Called from buildSnapshot (every visited extension) so global and local
+ * descriptors receive consistent treatment.
+ * @param ext — the descriptor to freeze
+ * @internal
+ */
+export declare function freezeExtension(ext: Extension): void;
+/**
+ * Flatten an ordered extension list into a snapshot using stable depth-first
+ * post-order traversal. Dependencies are materialised before their dependents.
+ * De-duplicates same-object entries; throws on same-id/different-object or cycles.
  * Binding-level conflicts are checked per Application at materialisation time.
  * @internal
  */

package/dist/esm/extensions/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/extensions/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAGD,QAAA,MAAM,aAAa,EAAE,iBAInB,CAAC;AAEH,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,iBAAiB,CAuC5E"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/extensions/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG/F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACpD;AAGD,QAAA,MAAM,aAAa,EAAE,iBAKnB,CAAC;AAEH,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CA2CpD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,iBAAiB,CAuF5E"}

package/dist/esm/extensions/snapshot.js

@@ -3,10 +3,12 @@ const emptySnapshot = Object.freeze({
     extensions: Object.freeze([]),
     renderers: Object.freeze([]),
     assets: Object.freeze([]),
+    serializers: Object.freeze([]),
 });
 /**
- * Flatten an ordered extension list into a snapshot.
- * De-duplicates same-id/same-object entries; throws on same-id/different-object.
+ * Flatten an ordered extension list into a snapshot using stable depth-first
+ * post-order traversal. Dependencies are materialised before their dependents.
+ * De-duplicates same-object entries; throws on same-id/different-object or cycles.
  * Binding-level conflicts are checked per Application at materialisation time.
  * @internal
  */
@@ -14,19 +16,48 @@ function buildSnapshot(input) {
     if (input.length === 0) {
         return emptySnapshot;
     }
-    const seenById = new Map();
-    const extensions = [];
+    const byId = new Map();
+    const visiting = new Set();
+    const visited = new Set();
+    const stack = [];
+    const ordered = [];
+    function visit(ext) {
+        // (1) Reserve ID + mismatch check FIRST — before dependency traversal.
+        //     This catches nested same-id/different-object descriptors immediately.
+        const existing = byId.get(ext.id);
+        if (existing !== undefined && existing !== ext) {
+            throw new Error(`Extension "${ext.id}" was provided by multiple descriptor objects.`);
+        }
+        if (existing === undefined) {
+            byId.set(ext.id, ext);
+        }
+        // (2) Already fully processed — diamond / shared dependency.
+        if (visited.has(ext))
+            return;
+        // (3) Back-edge in current DFS stack — cycle.
+        if (visiting.has(ext)) {
+            const cyclePath = [...stack.slice(stack.indexOf(ext)), ext].map(e => e.id).join(' → ');
+            throw new Error(`Extension dependency cycle detected: ${cyclePath}`);
+        }
+        // (4) Recurse into dependencies (post-order: deps before this extension).
+        visiting.add(ext);
+        stack.push(ext);
+        for (const dep of ext.dependencies ?? []) {
+            visit(dep);
+        }
+        stack.pop();
+        visiting.delete(ext);
+        // (5) Finalise — remove from in-progress, mark as fully processed, push to output.
+        visited.add(ext);
+        ordered.push(ext);
+    }
+    for (const ext of input)
+        visit(ext);
+    // Flatten in topological (post-order) order — deps before dependents.
     const renderers = [];
     const assets = [];
-    for (const ext of input) {
-        const existing = seenById.get(ext.id);
-        if (existing !== undefined) {
-            if (existing === ext)
-                continue;
-            throw new Error(`Duplicate extension id "${ext.id}" with a different descriptor in the provided extensions list.`);
-        }
-        seenById.set(ext.id, ext);
-        extensions.push(ext);
+    const serializers = [];
+    for (const ext of ordered) {
         if (ext.renderers) {
             for (const binding of ext.renderers) {
                 renderers.push(binding);
@@ -37,11 +68,17 @@ function buildSnapshot(input) {
                 assets.push(binding);
             }
         }
+        if (ext.serializers) {
+            for (const binding of ext.serializers) {
+                serializers.push(binding);
+            }
+        }
     }
     return Object.freeze({
-        extensions: Object.freeze(extensions),
+        extensions: Object.freeze(ordered),
         renderers: Object.freeze(renderers),
         assets: Object.freeze(assets),
+        serializers: Object.freeze(serializers),
     });
 }
 

package/dist/esm/extensions/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","sources":["../../../../src/extensions/snapshot.ts"],"sourcesContent":[null],"names":[],"mappings":"AASA;AACA,MAAM,aAAa,GAAsB,MAAM,CAAC,MAAM,CAAC;AACrD,IAAA,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7B,IAAA,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5B,IAAA,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1B,CAAA;AAID;;;;;AAKG;AACG,SAAU,aAAa,CAAC,KAA2B,EAAA;AACvD,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,QAAA,OAAO,aAAa;IACtB;AAEA,IAAA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB;IAC7C,MAAM,UAAU,GAAgB,EAAE;IAClC,MAAM,SAAS,GAAsB,EAAE;IACvC,MAAM,MAAM,GAAmB,EAAE;AAEjC,IAAA,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE;QACvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;AAErC,QAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;YAC1B,IAAI,QAAQ,KAAK,GAAG;gBAAE;YACtB,MAAM,IAAI,KAAK,CAAC,CAAA,wBAAA,EAA2B,GAAG,CAAC,EAAE,CAAA,8DAAA,CAAgE,CAAC;QACpH;QAEA,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC;AACzB,QAAA,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;AAEpB,QAAA,IAAI,GAAG,CAAC,SAAS,EAAE;AACjB,YAAA,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,SAAS,EAAE;AACnC,gBAAA,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;YACzB;QACF;AAEA,QAAA,IAAI,GAAG,CAAC,MAAM,EAAE;AACd,YAAA,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE;AAChC,gBAAA,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YACtB;QACF;IACF;IAEA,OAAO,MAAM,CAAC,MAAM,CAAC;AACnB,QAAA,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;AACrC,QAAA,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;AACnC,QAAA,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;AAC9B,KAAA,CAAC;AACJ;;;;"}
+{"version":3,"file":"snapshot.js","sources":["../../../../src/extensions/snapshot.ts"],"sourcesContent":[null],"names":[],"mappings":"AAUA;AACA,MAAM,aAAa,GAAsB,MAAM,CAAC,MAAM,CAAC;AACrD,IAAA,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7B,IAAA,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5B,IAAA,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACzB,IAAA,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC/B,CAAA;AAyDD;;;;;;AAMG;AACG,SAAU,aAAa,CAAC,KAA2B,EAAA;AACvD,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,QAAA,OAAO,aAAa;IACtB;AAEA,IAAA,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB;AACzC,IAAA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAa;AACrC,IAAA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAa;IACpC,MAAM,KAAK,GAAgB,EAAE;IAC7B,MAAM,OAAO,GAAgB,EAAE;IAE/B,SAAS,KAAK,CAAC,GAAc,EAAA;;;QAG3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAEjC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,GAAG,EAAE;YAC9C,MAAM,IAAI,KAAK,CAAC,CAAA,WAAA,EAAc,GAAG,CAAC,EAAE,CAAA,8CAAA,CAAgD,CAAC;QACvF;AAEA,QAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC;QACvB;;AAGA,QAAA,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE;;AAGtB,QAAA,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;AACrB,YAAA,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;AACtF,YAAA,MAAM,IAAI,KAAK,CAAC,wCAAwC,SAAS,CAAA,CAAE,CAAC;QACtE;;AAGA,QAAA,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;AACjB,QAAA,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAEf,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,IAAI,EAAE,EAAE;YACxC,KAAK,CAAC,GAAG,CAAC;QACZ;QAEA,KAAK,CAAC,GAAG,EAAE;AACX,QAAA,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;;AAGpB,QAAA,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAChB,QAAA,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;IAMnB;IAEA,KAAK,MAAM,GAAG,IAAI,KAAK;QAAE,KAAK,CAAC,GAAG,CAAC;;IAGnC,MAAM,SAAS,GAAsB,EAAE;IACvC,MAAM,MAAM,GAAmB,EAAE;IACjC,MAAM,WAAW,GAAwB,EAAE;AAE3C,IAAA,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE;AACzB,QAAA,IAAI,GAAG,CAAC,SAAS,EAAE;AACjB,YAAA,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,SAAS,EAAE;AACnC,gBAAA,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;YACzB;QACF;AAEA,QAAA,IAAI,GAAG,CAAC,MAAM,EAAE;AACd,YAAA,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE;AAChC,gBAAA,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YACtB;QACF;AAEA,QAAA,IAAI,GAAG,CAAC,WAAW,EAAE;AACnB,YAAA,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE;AACrC,gBAAA,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;YAC3B;QACF;IACF;IAEA,OAAO,MAAM,CAAC,MAAM,CAAC;AACnB,QAAA,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;AAClC,QAAA,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;AACnC,QAAA,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;AAC7B,QAAA,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;AACxC,KAAA,CAAC;AACJ;;;;"}

package/dist/esm/index.d.ts

@@ -4,6 +4,7 @@ export * from '#core/index';
 export type { AssetLoadRequest, Extension } from '#extensions/index';
 export * from '#input/index';
 export * from '#math/index';
-export * from '#rendering/index';
+export * from '#rendering/public';
 export * from '#resources/index';
+export * from '#ui/index';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACrE,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACrE,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC"}

package/dist/esm/index.js

@@ -2,31 +2,21 @@ export { Ease } from './animation/Easing.js';
 export { Tween } from './animation/Tween.js';
 export { TweenManager } from './animation/TweenManager.js';
 export { TweenState } from './animation/types.js';
-export { AbstractMedia } from './audio/AbstractMedia.js';
 export { decodeAudioData, getAudioContext, getOfflineAudioContext, isAudioContextReady, onAudioContextReady } from './audio/audio-context.js';
-export { AudioAnalyser } from './audio/AudioAnalyser.js';
 export { AudioBus } from './audio/AudioBus.js';
-export { AudioFilter } from './audio/AudioFilter.js';
+export { AudioEffect } from './audio/AudioEffect.js';
+export { AudioGenerator } from './audio/AudioGenerator.js';
+export { AudioInput } from './audio/AudioInput.js';
 export { AudioListener } from './audio/AudioListener.js';
-export { AudioManager, disposeAudioManager, getAudioManager } from './audio/AudioManager.js';
-export { BeatDetector } from './audio/BeatDetector.js';
+export { AudioManager } from './audio/AudioManager.js';
+export { AudioStream } from './audio/AudioStream.js';
+export { BiquadEffect } from './audio/BiquadEffect.js';
 export { crossFade } from './audio/crossFade.js';
 export { Envelope } from './audio/Envelope.js';
-export { ChorusFilter } from './audio/filters/ChorusFilter.js';
-export { CompressorFilter } from './audio/filters/CompressorFilter.js';
-export { DelayFilter } from './audio/filters/DelayFilter.js';
-export { DuckingFilter } from './audio/filters/DuckingFilter.js';
-export { EqualizerFilter } from './audio/filters/EqualizerFilter.js';
-export { GranularFilter } from './audio/filters/GranularFilter.js';
 export { HighpassFilter } from './audio/filters/HighpassFilter.js';
 export { LowpassFilter } from './audio/filters/LowpassFilter.js';
-export { PitchShiftFilter } from './audio/filters/PitchShiftFilter.js';
-export { ReverbFilter } from './audio/filters/ReverbFilter.js';
-export { VocoderFilter } from './audio/filters/VocoderFilter.js';
-export { WorkletFilter } from './audio/filters/WorkletFilter.js';
-export { Music } from './audio/Music.js';
-export { OscillatorSound } from './audio/OscillatorSound.js';
 export { Sound, SoundPoolStrategy } from './audio/Sound.js';
+export { WorkletEffect } from './audio/WorkletEffect.js';
 export { registerAudioWorkletProcessor } from './audio/worklet/registerWorklet.js';
 export { Application, ApplicationStatus } from './core/Application.js';
 export { Bounds } from './core/Bounds.js';
@@ -34,20 +24,24 @@ export { buildInfo } from './core/BuildInfo.js';
 export { Capabilities } from './core/capabilities.js';
 export { Clock } from './core/Clock.js';
 export { Color } from './core/Color.js';
-export { perfClearMarks, perfClearMeasures, perfMark, perfMeasure } from './core/Perf.js';
+export { DisposalScope } from './core/DisposalScope.js';
+export { Perf } from './core/Perf.js';
 export { Scene } from './core/Scene.js';
 export { SceneManager } from './core/SceneManager.js';
 export { SceneNode } from './core/SceneNode.js';
+export { Prefab } from './core/serialization/Prefab.js';
+export { SerializationRegistry, registerSerializer } from './core/serialization/SerializationRegistry.js';
+export { SERIALIZATION_VERSION } from './core/serialization/types.js';
 export { Signal } from './core/Signal.js';
+export { SystemRegistry } from './core/SystemRegistry.js';
 export { Time } from './core/Time.js';
 export { Timer } from './core/Timer.js';
-export { canvasSourceToDataUrl, emptyArrayBuffer, getCanvasSourceSize, getPreciseTime, getTextureSourceSize, hours, milliseconds, minutes, noop, rand, removeArrayItems, seconds, stopEvent, supportsCodec, supportsEventOptions, supportsIndexedDb, supportsPointerEvents, supportsTouchEvents, supportsWebAudio, vibrate } from './core/utils.js';
 export { ArcadeStickGamepadMapping } from './input/ArcadeStickGamepadMapping.js';
+export { FocusManager } from './input/FocusManager.js';
 export { GameCubeGamepadMapping } from './input/GameCubeGamepadMapping.js';
 export { Gamepad } from './input/Gamepad.js';
 export { GamepadAxis } from './input/GamepadAxis.js';
 export { GamepadButton } from './input/GamepadButton.js';
-export { builtInGamepadDefinitions, matchesIds, parseGamepadDescriptor, resolveDefinition, resolveGamepadDefinition } from './input/GamepadDefinitions.js';
 export { GamepadMapping, GamepadMappingFamily } from './input/GamepadMapping.js';
 export { GamepadPromptLayouts } from './input/GamepadPromptLayouts.js';
 export { GenericDualAnalogGamepadMapping } from './input/GenericDualAnalogGamepadMapping.js';
@@ -57,6 +51,7 @@ export { InteractionEvent } from './input/InteractionEvent.js';
 export { InteractionManager } from './input/InteractionManager.js';
 export { JoyConLeftGamepadMapping } from './input/JoyConLeftGamepadMapping.js';
 export { JoyConRightGamepadMapping } from './input/JoyConRightGamepadMapping.js';
+export { KeyEvent } from './input/KeyEvent.js';
 export { PlayStationGamepadMapping } from './input/PlayStationGamepadMapping.js';
 export { Pointer, PointerState, PointerStateFlag } from './input/Pointer.js';
 export { SteamControllerGamepadMapping } from './input/SteamControllerGamepadMapping.js';
@@ -66,10 +61,10 @@ export { ChannelOffset, ChannelSize, Keyboard, maxPointers, pointerSlotSize } fr
 export { XboxGamepadMapping } from './input/XboxGamepadMapping.js';
 export { Circle } from './math/Circle.js';
 export { CollisionType } from './math/Collision.js';
-export { getCollisionCircleCircle, getCollisionCircleRectangle, getCollisionEllipseCircle, getCollisionEllipseEllipse, getCollisionEllipseRectangle, getCollisionPolygonCircle, getCollisionRectangleRectangle, getCollisionSat, intersectionCircleCircle, intersectionCircleEllipse, intersectionCirclePoly, intersectionEllipseEllipse, intersectionEllipsePoly, intersectionLineCircle, intersectionLineEllipse, intersectionLineLine, intersectionLinePoly, intersectionLineRect, intersectionPointCircle, intersectionPointEllipse, intersectionPointLine, intersectionPointPoint, intersectionPointPoly, intersectionPointRect, intersectionPolyPoly, intersectionRectCircle, intersectionRectEllipse, intersectionRectPoly, intersectionRectRect, intersectionSat } from './math/collision-detection.js';
+export { Collision } from './math/collision-detection.js';
 export { Ellipse } from './math/Ellipse.js';
 export { Flags } from './math/Flags.js';
-export { buildCircle, buildEllipse, buildLine, buildPath, buildPolygon, buildRectangle, buildStar } from './math/geometry.js';
+export { MeshBuilder } from './math/geometry.js';
 export { Interval } from './math/Interval.js';
 export { Line } from './math/Line.js';
 export { Matrix } from './math/Matrix.js';
@@ -82,15 +77,15 @@ export { Random } from './math/Random.js';
 export { Rectangle } from './math/Rectangle.js';
 export { Segment } from './math/Segment.js';
 export { Size } from './math/Size.js';
-export { substepSweep, sweepCircleAgainst, sweepCircleVsCircle, sweepCircleVsRectangle, sweepRectangle, sweepRectangleAgainst } from './math/swept-collision.js';
-export { VoronoiRegion, bezierCurveTo, clamp, degreesPerRadian, degreesToRadians, getDistance, getVoronoiRegion, inRange, isPowerOfTwo, lerp, quadraticCurveTo, radiansPerDegree, radiansToDegrees, sign, tau, trimRotation } from './math/utils.js';
+export { Sweep } from './math/swept-collision.js';
+export { MathUtils } from './math/utils.js';
 export { Vector } from './math/Vector.js';
 export { CallbackRenderPass } from './rendering/CallbackRenderPass.js';
 export { Camera } from './rendering/Camera.js';
 export { Container } from './rendering/Container.js';
 export { Drawable } from './rendering/Drawable.js';
 export { RenderBackendType } from './rendering/RenderBackendType.js';
-export { RendererRegistry } from './rendering/RendererRegistry.js';
+export { RenderBatch } from './rendering/RenderBatch.js';
 export { RenderingContext } from './rendering/RenderingContext.js';
 export { RenderNode } from './rendering/RenderNode.js';
 export { RenderNodePass } from './rendering/RenderNodePass.js';
@@ -119,59 +114,40 @@ export { Graphics } from './rendering/primitives/Graphics.js';
 export { Shader } from './rendering/shader/Shader.js';
 export { ShaderAttribute } from './rendering/shader/ShaderAttribute.js';
 export { ShaderUniform } from './rendering/shader/ShaderUniform.js';
-export { upgradeFragmentShaderToGl300 } from './rendering/shader/upgradeFragmentShaderToGl300.js';
 export { AnimatedSprite } from './rendering/sprite/AnimatedSprite.js';
+export { NineSliceSprite } from './rendering/sprite/NineSliceSprite.js';
+export { RepeatingSprite } from './rendering/sprite/RepeatingSprite.js';
 export { Sprite, SpriteFlags } from './rendering/sprite/Sprite.js';
 export { Spritesheet } from './rendering/sprite/Spritesheet.js';
 export { AbstractText } from './rendering/text/AbstractText.js';
 export { BitmapText, BmFontAdapter } from './rendering/text/BitmapText.js';
 export { BmFont } from './rendering/text/BmFont.js';
-export { AtlasPage, GlyphAtlas, SDF_RADIUS } from './rendering/text/GlyphAtlas.js';
-export { GlyphAtlasPool, getDefaultGlyphAtlasPool, resetDefaultGlyphAtlasPool } from './rendering/text/GlyphAtlasPool.js';
+export { GlyphAtlas } from './rendering/text/GlyphAtlas.js';
 export { HTMLText } from './rendering/text/HTMLText.js';
 export { Text } from './rendering/text/Text.js';
-export { buildTextPageQuads, layoutText, measureText } from './rendering/text/TextLayout.js';
 export { TextStyle } from './rendering/text/TextStyle.js';
 export { DataTexture } from './rendering/texture/DataTexture.js';
 export { RenderTexture } from './rendering/texture/RenderTexture.js';
 export { Sampler } from './rendering/texture/Sampler.js';
 export { Texture } from './rendering/texture/Texture.js';
+export { TextureRegion } from './rendering/texture/TextureRegion.js';
 export { Video } from './rendering/video/Video.js';
-export { AbstractWebGl2BatchedRenderer } from './rendering/webgl2/AbstractWebGl2BatchedRenderer.js';
-export { AbstractWebGl2Renderer } from './rendering/webgl2/AbstractWebGl2Renderer.js';
-export { WebGl2Backend } from './rendering/webgl2/WebGl2Backend.js';
-export { WebGl2MeshRenderer } from './rendering/webgl2/WebGl2MeshRenderer.js';
-export { WebGl2RenderBuffer } from './rendering/webgl2/WebGl2RenderBuffer.js';
-export { WebGl2ShaderBlock } from './rendering/webgl2/WebGl2ShaderBlock.js';
-export { webGl2PrimitiveArrayConstructors, webGl2PrimitiveByteSizeMapping, webGl2PrimitiveTypeNames } from './rendering/webgl2/WebGl2ShaderMappings.js';
-export { createWebGl2ShaderProgram } from './rendering/webgl2/WebGl2ShaderProgram.js';
-export { WebGl2SpriteRenderer } from './rendering/webgl2/WebGl2SpriteRenderer.js';
-export { WebGl2TextRenderer } from './rendering/webgl2/WebGl2TextRenderer.js';
-export { WebGl2VertexArrayObject } from './rendering/webgl2/WebGl2VertexArrayObject.js';
-export { AbstractWebGpuRenderer } from './rendering/webgpu/AbstractWebGpuRenderer.js';
-export { WebGpuComputePipeline } from './rendering/webgpu/compute/WebGpuComputePipeline.js';
-export { WebGpuStorageBuffer } from './rendering/webgpu/compute/WebGpuStorageBuffer.js';
-export { WebGpuBackend } from './rendering/webgpu/WebGpuBackend.js';
-export { getWebGpuBlendState } from './rendering/webgpu/WebGpuBlendState.js';
-export { WebGpuMeshRenderer } from './rendering/webgpu/WebGpuMeshRenderer.js';
-export { WebGpuSpriteRenderer } from './rendering/webgpu/WebGpuSpriteRenderer.js';
-export { WebGpuTextRenderer } from './rendering/webgpu/WebGpuTextRenderer.js';
 export { AbstractAssetFactory } from './resources/AbstractAssetFactory.js';
-export { Asset, AssetImpl } from './resources/Asset.js';
+export { Asset } from './resources/Asset.js';
 export { BundleLoadError, defineAssetManifest } from './resources/AssetManifest.js';
-export { Assets, AssetsImpl } from './resources/Assets.js';
+export { Assets } from './resources/Assets.js';
 export { CacheFirstStrategy } from './resources/CacheFirstStrategy.js';
-export { FactoryRegistry } from './resources/FactoryRegistry.js';
 export { IndexedDbDatabase } from './resources/IndexedDbDatabase.js';
+export { IndexedDbKeyValueStore } from './resources/IndexedDbKeyValueStore.js';
 export { IndexedDbStore } from './resources/IndexedDbStore.js';
-export { JsonStore } from './resources/JsonStore.js';
 export { Loader } from './resources/Loader.js';
 export { LoadingQueue } from './resources/LoadingQueue.js';
+export { MemoryStore } from './resources/MemoryStore.js';
 export { NetworkOnlyStrategy } from './resources/NetworkOnlyStrategy.js';
 export { BinaryAsset, CsvAsset, FontAsset, ImageAsset, Json, SubtitleAsset, SvgAsset, TextAsset, WasmAsset, XmlAsset } from './resources/tokens.js';
-export { determineMimeType } from './resources/utils.js';
+export { WebStorageStore } from './resources/WebStorageStore.js';
 export { BinaryFactory } from './resources/factories/BinaryFactory.js';
-export { BmFontLoaderFactory, parseBmFontText } from './resources/factories/BmFontFactory.js';
+export { BmFontLoaderFactory } from './resources/factories/BmFontFactory.js';
 export { CsvFactory } from './resources/factories/CsvFactory.js';
 export { FontFactory } from './resources/factories/FontFactory.js';
 export { ImageFactory } from './resources/factories/ImageFactory.js';
@@ -185,4 +161,11 @@ export { TextureFactory } from './resources/factories/TextureFactory.js';
 export { VideoFactory } from './resources/factories/VideoFactory.js';
 export { WasmFactory } from './resources/factories/WasmFactory.js';
 export { XmlFactory } from './resources/factories/XmlFactory.js';
+export { Button } from './ui/Button.js';
+export { Label } from './ui/Label.js';
+export { Panel } from './ui/Panel.js';
+export { ProgressBar } from './ui/ProgressBar.js';
+export { Stack } from './ui/Stack.js';
+export { UIRoot } from './ui/UIRoot.js';
+export { Widget } from './ui/Widget.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/input/FocusManager.d.ts

@@ -0,0 +1,59 @@
+import type { Application } from '#core/Application';
+import type { FocusHooks } from '#core/Stage';
+import type { RenderNode } from '#rendering/RenderNode';
+/**
+ * Per-Application keyboard-focus service. Tracks the single focused
+ * {@link RenderNode}, routes keyboard input from the {@link InputManager} to
+ * it, and provides Tab-order traversal across the focusable nodes of the active
+ * focus scope.
+ *
+ * A node reaches this service through its {@link Stage} (`stage.focus`); app
+ * code reaches it through `app.focus`. Constructed automatically by
+ * {@link Application}; you do not instantiate this class yourself.
+ *
+ * Built-in key handling: `Tab` / `Shift+Tab` move focus to the next / previous
+ * focusable node. A focused node can call {@link KeyEvent.preventDefault} on its
+ * `onKeyDown` event to opt out of this and consume the key itself.
+ */
+export declare class FocusManager implements FocusHooks {
+    private readonly _app;
+    private _focused;
+    private _shiftDown;
+    private readonly _scopeStack;
+    private readonly _onKeyDownHandler;
+    private readonly _onKeyUpHandler;
+    constructor(app: Application);
+    /** The node that currently holds keyboard focus, or `null`. */
+    get focused(): RenderNode | null;
+    /**
+     * Move keyboard focus to `node`. No-op when `node` is already focused or is
+     * not {@link RenderNode.focusable}. Fires `onBlur` on the previously focused
+     * node, then `onFocus` on `node`.
+     */
+    focus(node: RenderNode): void;
+    /** Clear focus, or only clear it when `node` currently holds it. Fires `onBlur`. */
+    blur(node?: RenderNode): void;
+    /** Push a subtree root that bounds subsequent Tab traversal (e.g. a modal dialog). */
+    pushScope(root: RenderNode): void;
+    /** Pop the most recently pushed focus scope. */
+    popScope(): void;
+    /** Move focus to the next focusable node in the active scope (Tab order). */
+    focusNext(): void;
+    /** Move focus to the previous focusable node in the active scope (Shift+Tab order). */
+    focusPrevious(): void;
+    /** @internal — clear focus when a focused node (or an ancestor of it) leaves the tree. */
+    _notifyNodeRemoved(node: RenderNode): void;
+    destroy(): void;
+    private _handleKeyDown;
+    private _handleKeyUp;
+    /** Advance focus by `direction` (+1 next, -1 previous), wrapping around the scope. */
+    private _step;
+    /**
+     * Collect the focusable nodes of the active scope (the topmost pushed scope,
+     * else the active scene root) in Tab order: ascending `tabIndex`, ties broken
+     * by document (tree) order.
+     */
+    private _collectFocusables;
+    private _collectInto;
+}
+//# sourceMappingURL=FocusManager.d.ts.map

package/dist/esm/input/FocusManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusManager.d.ts","sourceRoot":"","sources":["../../../src/input/FocusManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxD;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,YAAW,UAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,UAAU,CAAS;IAG3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAEhD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;gBAEzC,GAAG,EAAE,WAAW;IASnC,+DAA+D;IAC/D,IAAW,OAAO,IAAI,UAAU,GAAG,IAAI,CAEtC;IAED;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAUpC,oFAAoF;IAC7E,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI;IAWpC,sFAAsF;IAC/E,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIxC,gDAAgD;IACzC,QAAQ,IAAI,IAAI;IAIvB,6EAA6E;IACtE,SAAS,IAAI,IAAI;IAIxB,uFAAuF;IAChF,aAAa,IAAI,IAAI;IAI5B,0FAA0F;IACnF,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAc1C,OAAO,IAAI,IAAI;IAOtB,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,YAAY;IAYpB,sFAAsF;IACtF,OAAO,CAAC,KAAK;IAsBb;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,YAAY;CAerB"}

package/dist/esm/input/FocusManager.js

@@ -0,0 +1,175 @@
+import { Container } from '../rendering/Container.js';
+import { KeyEvent } from './KeyEvent.js';
+import { Keyboard } from './types.js';
+
+/**
+ * Per-Application keyboard-focus service. Tracks the single focused
+ * {@link RenderNode}, routes keyboard input from the {@link InputManager} to
+ * it, and provides Tab-order traversal across the focusable nodes of the active
+ * focus scope.
+ *
+ * A node reaches this service through its {@link Stage} (`stage.focus`); app
+ * code reaches it through `app.focus`. Constructed automatically by
+ * {@link Application}; you do not instantiate this class yourself.
+ *
+ * Built-in key handling: `Tab` / `Shift+Tab` move focus to the next / previous
+ * focusable node. A focused node can call {@link KeyEvent.preventDefault} on its
+ * `onKeyDown` event to opt out of this and consume the key itself.
+ */
+class FocusManager {
+    _app;
+    _focused = null;
+    _shiftDown = false;
+    // Stack of subtree roots that bound Tab traversal; a modal dialog pushes one.
+    _scopeStack = [];
+    _onKeyDownHandler;
+    _onKeyUpHandler;
+    constructor(app) {
+        this._app = app;
+        this._onKeyDownHandler = this._handleKeyDown.bind(this);
+        this._onKeyUpHandler = this._handleKeyUp.bind(this);
+        app.input.onKeyDown.add(this._onKeyDownHandler);
+        app.input.onKeyUp.add(this._onKeyUpHandler);
+    }
+    /** The node that currently holds keyboard focus, or `null`. */
+    get focused() {
+        return this._focused;
+    }
+    /**
+     * Move keyboard focus to `node`. No-op when `node` is already focused or is
+     * not {@link RenderNode.focusable}. Fires `onBlur` on the previously focused
+     * node, then `onFocus` on `node`.
+     */
+    focus(node) {
+        if (node === this._focused || !node.focusable) {
+            return;
+        }
+        this.blur();
+        this._focused = node;
+        node._peekFocusSignal('focus')?.dispatch(node);
+    }
+    /** Clear focus, or only clear it when `node` currently holds it. Fires `onBlur`. */
+    blur(node) {
+        const previous = this._focused;
+        if (previous === null || (node !== undefined && node !== previous)) {
+            return;
+        }
+        this._focused = null;
+        previous._peekFocusSignal('blur')?.dispatch(previous);
+    }
+    /** Push a subtree root that bounds subsequent Tab traversal (e.g. a modal dialog). */
+    pushScope(root) {
+        this._scopeStack.push(root);
+    }
+    /** Pop the most recently pushed focus scope. */
+    popScope() {
+        this._scopeStack.pop();
+    }
+    /** Move focus to the next focusable node in the active scope (Tab order). */
+    focusNext() {
+        this._step(1);
+    }
+    /** Move focus to the previous focusable node in the active scope (Shift+Tab order). */
+    focusPrevious() {
+        this._step(-1);
+    }
+    /** @internal — clear focus when a focused node (or an ancestor of it) leaves the tree. */
+    _notifyNodeRemoved(node) {
+        let current = this._focused;
+        while (current !== null) {
+            if (current === node) {
+                this.blur();
+                return;
+            }
+            current = current.parent;
+        }
+    }
+    destroy() {
+        this._app.input.onKeyDown.remove(this._onKeyDownHandler);
+        this._app.input.onKeyUp.remove(this._onKeyUpHandler);
+        this._scopeStack.length = 0;
+        this._focused = null;
+    }
+    _handleKeyDown(channel) {
+        if (channel === Keyboard.Shift) {
+            this._shiftDown = true;
+        }
+        const focused = this._focused;
+        let defaultPrevented = false;
+        if (focused !== null) {
+            const event = new KeyEvent('keydown', channel, focused);
+            focused._peekKeySignal('keydown')?.dispatch(event);
+            defaultPrevented = event.defaultPrevented;
+        }
+        if (!defaultPrevented && channel === Keyboard.Tab) {
+            if (this._shiftDown) {
+                this.focusPrevious();
+            }
+            else {
+                this.focusNext();
+            }
+        }
+    }
+    _handleKeyUp(channel) {
+        if (channel === Keyboard.Shift) {
+            this._shiftDown = false;
+        }
+        const focused = this._focused;
+        if (focused !== null) {
+            focused._peekKeySignal('keyup')?.dispatch(new KeyEvent('keyup', channel, focused));
+        }
+    }
+    /** Advance focus by `direction` (+1 next, -1 previous), wrapping around the scope. */
+    _step(direction) {
+        const focusables = this._collectFocusables();
+        if (focusables.length === 0) {
+            return;
+        }
+        const currentIndex = this._focused === null ? -1 : focusables.indexOf(this._focused);
+        const count = focusables.length;
+        let nextIndex;
+        if (currentIndex === -1) {
+            nextIndex = direction === 1 ? 0 : count - 1;
+        }
+        else {
+            nextIndex = (currentIndex + direction + count) % count;
+        }
+        const next = focusables[nextIndex];
+        if (next !== undefined) {
+            this.focus(next);
+        }
+    }
+    /**
+     * Collect the focusable nodes of the active scope (the topmost pushed scope,
+     * else the active scene root) in Tab order: ascending `tabIndex`, ties broken
+     * by document (tree) order.
+     */
+    _collectFocusables() {
+        const root = this._scopeStack.at(-1) ?? this._app.scene.currentScene?.root ?? null;
+        if (root === null) {
+            return [];
+        }
+        const collected = [];
+        this._collectInto(root, collected);
+        return collected
+            .map((node, index) => ({ node, index }))
+            .sort((a, b) => a.node.tabIndex - b.node.tabIndex || a.index - b.index)
+            .map(entry => entry.node);
+    }
+    _collectInto(node, out) {
+        if (!node.visible) {
+            return;
+        }
+        if (node.focusable) {
+            out.push(node);
+        }
+        if (node instanceof Container) {
+            for (const child of node.children) {
+                this._collectInto(child, out);
+            }
+        }
+    }
+}
+
+export { FocusManager };
+//# sourceMappingURL=FocusManager.js.map