@codexo/exojs 0.11.0 → 0.12.0

package/dist/esm/debug/RenderPassInspectorLayer.js

@@ -1,6 +1,7 @@
 import { Color } from '../core/Color.js';
 import { Container } from '../rendering/Container.js';
 import { Graphics } from '../rendering/primitives/Graphics.js';
+import { RenderPipeline } from '../rendering/RenderPipeline.js';
 import { Text } from '../rendering/text/Text.js';
 import { TextStyle } from '../rendering/text/TextStyle.js';
 import { DebugLayer } from './DebugLayer.js';
@@ -38,9 +39,27 @@ class RenderPassInspectorLayer extends DebugLayer {
     _bg = null;
     _header = null;
     _lines = [];
+    _pipeline = null;
     constructor(app) {
         super(app);
     }
+    /**
+     * Flatten a {@link RenderPipeline} into depth-tagged rows, recursing into nested pipelines. Pure and
+     * app-independent: identity is the pass object and `label` is display-only — no names are required.
+     */
+    static describePipeline(pipeline) {
+        const rows = [];
+        RenderPassInspectorLayer._collectPipelineRows(pipeline, 0, rows);
+        return rows;
+    }
+    static _collectPipelineRows(pipeline, depth, rows) {
+        for (const pass of pipeline) {
+            rows.push({ depth, label: pass.label, enabled: pass.enabled, isPipeline: pass instanceof RenderPipeline });
+            if (pass instanceof RenderPipeline) {
+                RenderPassInspectorLayer._collectPipelineRows(pass, depth + 1, rows);
+            }
+        }
+    }
     get viewMode() {
         return 'screen';
     }
@@ -74,6 +93,7 @@ class RenderPassInspectorLayer extends DebugLayer {
         this._header = null;
         this._lines = [];
         this._entries.length = 0;
+        this._pipeline = null;
     }
     /**
      * Read-only snapshot of the entries collected on the most recent
@@ -94,6 +114,19 @@ class RenderPassInspectorLayer extends DebugLayer {
         }
         return total;
     }
+    /** Set a {@link RenderPipeline} to list beneath the filter chains, or `null` to clear it. */
+    setPipeline(pipeline) {
+        this._pipeline = pipeline;
+        return this;
+    }
+    /** The pipeline currently being inspected, or `null`. */
+    get pipeline() {
+        return this._pipeline;
+    }
+    /** Depth-tagged rows for the inspected pipeline (empty if none is set). */
+    pipelineRows() {
+        return this._pipeline !== null ? RenderPassInspectorLayer.describePipeline(this._pipeline) : [];
+    }
     // -----------------------------------------------------------------------
     _collect(node) {
         if (!node.visible)
@@ -166,6 +199,14 @@ class RenderPassInspectorLayer extends DebugLayer {
                 }
             }
         }
+        const pipelineRows = this.pipelineRows();
+        if (pipelineRows.length > 0) {
+            lines.push({ text: 'Pipeline:', dim: true });
+            for (const row of pipelineRows) {
+                const indent = '  '.repeat(row.depth + 1);
+                lines.push({ text: `${indent}${row.label}${row.enabled ? '' : ' [off]'}`, dim: !row.enabled });
+            }
+        }
         this._header.text = `Render Passes: ${this.totalPasses}`;
         const visibleCount = Math.min(lines.length, this._lines.length);
         for (let i = 0; i < this._lines.length; i++) {

package/dist/esm/debug/RenderPassInspectorLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"RenderPassInspectorLayer.js","sources":["../../../../src/debug/RenderPassInspectorLayer.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;AAaA,MAAM,MAAM,GAAG,GAAG,CAAC;AACnB,MAAM,MAAM,GAAG,CAAC;AAChB,MAAM,SAAS,GAAG,GAAG;AACrB,MAAM,aAAa,GAAG,EAAE;AACxB,MAAM,UAAU,GAAG,EAAE;AACrB,MAAM,YAAY,GAAG,CAAC;AACtB,MAAM,QAAQ,GAAG,EAAE;AAEnB,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC;AACvC,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;AACrC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;AAsB5C;;;;;;;;;;;;;;;AAeG;AACG,MAAO,wBAAyB,SAAQ,UAAU,CAAA;IACrC,QAAQ,GAA+B,EAAE;IAClD,KAAK,GAAqB,IAAI;IAC9B,GAAG,GAAoB,IAAI;IAC3B,OAAO,GAAgB,IAAI;IAC3B,MAAM,GAAW,EAAE;AAE3B,IAAA,WAAA,CAAmB,GAAgB,EAAA;QACjC,KAAK,CAAC,GAAG,CAAC;IACZ;AAEA,IAAA,IAAoB,QAAQ,GAAA;AAC1B,QAAA,OAAO,QAAQ;IACjB;AAEA;;;;;AAKG;AACa,IAAA,MAAM,CAAC,MAAY,EAAA;AACjC,QAAA,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE;QACf;AAEA,QAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAExB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI;QAC/C,IAAI,IAAI,EAAE;AACR,YAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrB;QAEA,IAAI,CAAC,aAAa,EAAE;IACtB;;AAGgB,IAAA,MAAM,CAAC,OAAsB,EAAA;AAC3C,QAAA,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;IAC7B;IAEgB,OAAO,GAAA;AACrB,QAAA,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE;AACvB,YAAA,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;AACpB,YAAA,IAAI,CAAC,KAAK,GAAG,IAAI;QACnB;AACA,QAAA,IAAI,CAAC,GAAG,GAAG,IAAI;AACf,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI;AACnB,QAAA,IAAI,CAAC,MAAM,GAAG,EAAE;AAChB,QAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;IAC1B;AAEA;;;;;AAKG;AACH,IAAA,IAAW,OAAO,GAAA;QAChB,OAAO,IAAI,CAAC,QAAQ;IACtB;;AAGA,IAAA,IAAW,WAAW,GAAA;QACpB,IAAI,KAAK,GAAG,CAAC;AACb,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;AACjC,YAAA,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM;YAC7B,IAAI,KAAK,CAAC,OAAO;AAAE,gBAAA,KAAK,EAAE;QAC5B;AACA,QAAA,OAAO,KAAK;IACd;;AAIQ,IAAA,QAAQ,CAAC,IAAgB,EAAA;QAC/B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE;QAEnB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;AAC3B,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE;AAC/B,YAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;AACjB,gBAAA,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;AACpC,gBAAA,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;AAC1B,gBAAA,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3C,gBAAA,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC7C,gBAAA,OAAO,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI;gBAC3B,cAAc,EAAE,IAAI,CAAC,aAAa;AACnC,aAAA,CAAC;QACJ;QAEA,MAAM,SAAS,GAAG,IAA2C;QAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;AACrC,YAAA,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,QAAQ,EAAE;AACtC,gBAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YACtB;QACF;IACF;IAEQ,MAAM,GAAA;AACZ,QAAA,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC;AAC1B,YAAA,QAAQ,EAAE,QAAQ;AAClB,YAAA,UAAU,EAAE,OAAO;AACnB,YAAA,UAAU,EAAE,QAAQ;AACpB,YAAA,SAAS,EAAE,SAAS;AACrB,SAAA,CAAC;AAEF,QAAA,IAAI,CAAC,GAAG,GAAG,IAAI,QAAQ,EAAE;AACzB,QAAA,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,EAAE;AACjC,QAAA,WAAW,CAAC,SAAS,GAAG,WAAW;QACnC,IAAI,CAAC,OAAO,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,YAAY;QACtC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,YAAY;AAEtC,QAAA,IAAI,CAAC,MAAM,GAAG,EAAE;AAChB,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC,EAAE,EAAE;AACtC,YAAA,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AACxC,YAAA,IAAI,CAAC,CAAC,GAAG,MAAM,GAAG,YAAY;AAC9B,YAAA,IAAI,CAAC,CAAC,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,CAAC,GAAG,UAAU;AAC5D,YAAA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACxB;AAEA,QAAA,IAAI,CAAC,KAAK,GAAG,IAAI,SAAS,EAAE;QAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;AACjC,QAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM;AAAE,YAAA,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC3D;IAEQ,aAAa,GAAA;QACnB,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI;YAAE;QAEhD,MAAM,KAAK,GAA0C,EAAE;QAEvD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;AAC9B,YAAA,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,2BAA2B,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QAC9D;aAAO;AACL,YAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;gBACjC,MAAM,KAAK,GAAa,EAAE;gBAC1B,IAAI,KAAK,CAAC,OAAO;AAAE,oBAAA,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;gBACrC,IAAI,KAAK,CAAC,cAAc;AAAE,oBAAA,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC9C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,CAAA,EAAA,EAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE;gBACjE,KAAK,CAAC,IAAI,CAAC;AACT,oBAAA,IAAI,EAAE,CAAA,EAAG,KAAK,CAAC,aAAa,CAAA,CAAA,EAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAA,EAAG,SAAS,CAAA,CAAE;AACzE,oBAAA,GAAG,EAAE,KAAK;AACX,iBAAA,CAAC;AACF,gBAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;oBAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAA,EAAA,EAAK,CAAC,CAAA,EAAA,EAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAA,CAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;gBAClF;YACF;QACF;QAEA,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,kBAAkB,IAAI,CAAC,WAAW,CAAA,CAAE;AAExD,QAAA,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;AAC/D,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3B,YAAA,IAAI,CAAC,GAAG,YAAY,EAAE;AACpB,gBAAA,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;AACtB,gBAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;AACtB,gBAAA,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,GAAG,QAAQ,GAAG,SAAS;AACvD,gBAAA,IAAI,CAAC,OAAO,GAAG,IAAI;YACrB;iBAAO;AACL,gBAAA,IAAI,CAAC,IAAI,GAAG,EAAE;AACd,gBAAA,IAAI,CAAC,OAAO,GAAG,KAAK;YACtB;QACF;QAEA,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;AACrC,YAAA,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM;AAClD,YAAA,IAAI,CAAC,IAAI,GAAG,CAAA,MAAA,EAAS,QAAQ,QAAQ;AACrC,YAAA,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,QAAQ;AAC/B,YAAA,IAAI,CAAC,OAAO,GAAG,IAAI;QACrB;;AAGA,QAAA,MAAM,WAAW,GAAG,YAAY,GAAG,CAAC,GAAG,UAAU,IAAI,CAAC,GAAG,YAAY,CAAC;AACtE,QAAA,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE;AAChB,QAAA,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,OAAO;AAC5B,QAAA,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC;IAChE;AACD;;;;"}
+{"version":3,"file":"RenderPassInspectorLayer.js","sources":["../../../../src/debug/RenderPassInspectorLayer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

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

@@ -4,4 +4,5 @@ export { DebugOverlay } from './DebugOverlay';
 export { HitTestLayer } from './HitTestLayer';
 export { PerformanceLayer } from './PerformanceLayer';
 export { PointerStackLayer } from './PointerStackLayer';
-export { type RenderPassInspectorEntry, RenderPassInspectorLayer } from './RenderPassInspectorLayer';
+export { type RenderPassInspectorEntry, RenderPassInspectorLayer, type RenderPipelineRow } from './RenderPassInspectorLayer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/debug/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,wBAAwB,EAAE,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}

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

@@ -0,0 +1,70 @@
+import type { Drawable } from '#rendering/Drawable';
+import type { RenderBackend } from '#rendering/RenderBackend';
+import type { DrawableConstructor, Renderer } from '#rendering/Renderer';
+import type { AssetConstructor } from '#resources/FactoryRegistry';
+import type { AssetLoaderContext, Loader } from '#resources/Loader';
+/**
+ * Per-load request passed to {@link AssetHandler.load}.
+ * @advanced
+ */
+export interface AssetLoadRequest {
+    readonly source: string;
+    readonly options?: Readonly<Record<string, unknown>>;
+}
+/**
+ * A loader-local instance produced by {@link AssetBinding.create}; owned and destroyed
+ * by the Loader. May hold state. Called once per `loader.load(...)` invocation.
+ * Sub-assets loaded via `context.loader.load(...)` are owned by the Loader's cache —
+ * NOT by this handler or the asset returned by `load`.
+ * @advanced
+ */
+export interface AssetHandler<Result = unknown> {
+    load(request: AssetLoadRequest, context: AssetLoaderContext): Promise<Result>;
+    destroy?(): void;
+}
+/**
+ * Binds one or more drawable constructors to a renderer factory.
+ * Pure descriptor — no active renderer, no GPU resources, no side effects
+ * until `create` is called once per backend during Application construction.
+ *
+ * `targets` must contain at least one entry. All targets share the single renderer
+ * instance produced by `create`. Returning `undefined` from `create` means the
+ * backend is unsupported; the entire binding is skipped for that backend.
+ * @advanced
+ */
+export interface RendererBinding<Target extends Drawable = Drawable> {
+    readonly targets: ReadonlyArray<DrawableConstructor<Target>>;
+    create(backend: RenderBackend): Renderer<RenderBackend, Target> | undefined;
+}
+/**
+ * Binds an asset type and its lookup keys to a loader-local handler factory.
+ * `create(loader)` is called once per Loader at Application construction, producing
+ * an {@link AssetHandler} instance that the Loader owns for its entire lifetime.
+ * The handler may hold loader-local state (Workers, WASM modules, parsed caches).
+ * @advanced
+ */
+export interface AssetBinding<Result = unknown> {
+    readonly type: AssetConstructor<Result>;
+    /**
+     * Config-map type names that resolve to this handler, e.g. `['tiledMap']`.
+     * Most bindings declare exactly one name; a binding may declare several when a
+     * single asset type is reachable under multiple aliases (e.g. `['vtt', 'srt']`).
+     * Each name maps the config-map form `{ type: '<name>', source }` to this handler.
+     */
+    readonly typeNames?: readonly string[];
+    readonly extensions?: readonly string[];
+    create(loader: Loader): AssetHandler<Result>;
+}
+/**
+ * An ExoJS extension: an immutable descriptor that contributes renderer bindings
+ * and/or asset bindings. Holds no Application, backend, GPU, or loader instances.
+ * Register via {@link ExtensionRegistry.register} (official packages do this as
+ * an import side effect), or pass explicitly via {@link ApplicationOptions.extensions}.
+ * @advanced
+ */
+export interface Extension {
+    readonly id: string;
+    readonly renderers?: readonly RendererBinding[];
+    readonly assets?: readonly AssetBinding[];
+}
+//# sourceMappingURL=Extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/Extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ;IACjE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC7E;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C"}

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

@@ -0,0 +1,35 @@
+import type { Extension } from './Extension';
+import { type ExtensionSnapshot } from './snapshot';
+/** @internal — used by testing.ts only; NOT re-exported from barrel */
+export declare function _clearRegistryStore(): void;
+/** @internal */
+export declare function getGlobalSnapshotInternal(): ExtensionSnapshot;
+/**
+ * Process-wide static catalogue of {@link Extension} descriptors. Stores
+ * descriptors only — never Application, backend, GPU, or loader instances — and
+ * is read exactly once per Application (at construction). Not read in any hot path.
+ *
+ * Extension authors import from `@codexo/exojs/extensions`:
+ *   import { ExtensionRegistry } from '@codexo/exojs/extensions';
+ * @advanced
+ */
+export declare class ExtensionRegistry {
+    private constructor();
+    /**
+     * Register an extension descriptor. Idempotent for the *same object* under the
+     * same `id` (no-op). Throws if a *different* object is already registered under
+     * that `id` — this detects duplicate package installations.
+     */
+    static register(extension: Extension): void;
+    /** True if an extension with `id` is currently registered. */
+    static has(id: string): boolean;
+    /** The registered descriptor for `id`, or `undefined`. */
+    static get(id: string): Readonly<Extension> | undefined;
+    /**
+     * All registered descriptors in registration order.
+     * Returns a cached readonly view; no allocation on repeated calls while the
+     * registry is unchanged. Invalidated only after a new registration.
+     */
+    static list(): ReadonlyArray<Readonly<Extension>>;
+}
+//# sourceMappingURL=ExtensionRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionRegistry.d.ts","sourceRoot":"","sources":["../../../src/extensions/ExtensionRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOnE,uEAAuE;AACvE,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,gBAAgB;AAChB,wBAAgB,yBAAyB,IAAI,iBAAiB,CAS7D;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO;IAEP;;;;OAIG;WACW,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAyClD,8DAA8D;WAChD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAItC,0DAA0D;WAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS;IAI9D;;;;OAIG;WACW,IAAI,IAAI,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;CAGzD"}

package/dist/esm/extensions/ExtensionRegistry.js

@@ -0,0 +1,63 @@
+import { buildSnapshot } from './snapshot.js';
+
+// Module-level store — accessible to testing.ts via _clearRegistryStore.
+let _byId = new Map();
+let _revision = 0;
+let _cache;
+/** @internal */
+function getGlobalSnapshotInternal() {
+    if (_cache?.revision === _revision) {
+        return _cache.snapshot;
+    }
+    const snapshot = buildSnapshot([..._byId.values()]);
+    _cache = { revision: _revision, snapshot };
+    return snapshot;
+}
+/**
+ * Process-wide static catalogue of {@link Extension} descriptors. Stores
+ * descriptors only — never Application, backend, GPU, or loader instances — and
+ * is read exactly once per Application (at construction). Not read in any hot path.
+ *
+ * Extension authors import from `@codexo/exojs/extensions`:
+ *   import { ExtensionRegistry } from '@codexo/exojs/extensions';
+ * @advanced
+ */
+class ExtensionRegistry {
+    constructor() { }
+    /**
+     * Register an extension descriptor. Idempotent for the *same object* under the
+     * same `id` (no-op). Throws if a *different* object is already registered under
+     * that `id` — this detects duplicate package installations.
+     */
+    static register(extension) {
+        const existing = _byId.get(extension.id);
+        if (existing !== undefined) {
+            if (existing === extension)
+                return;
+            throw new Error(`An extension with id "${extension.id}" is already registered with a different descriptor. ` +
+                `Ensure only one copy of the extension package is installed (check for duplicate or mismatched versions).`);
+        }
+        _byId.set(extension.id, extension);
+        _revision++;
+        _cache = undefined;
+    }
+    /** True if an extension with `id` is currently registered. */
+    static has(id) {
+        return _byId.has(id);
+    }
+    /** The registered descriptor for `id`, or `undefined`. */
+    static get(id) {
+        return _byId.get(id);
+    }
+    /**
+     * All registered descriptors in registration order.
+     * Returns a cached readonly view; no allocation on repeated calls while the
+     * registry is unchanged. Invalidated only after a new registration.
+     */
+    static list() {
+        return getGlobalSnapshotInternal().extensions;
+    }
+}
+
+export { ExtensionRegistry, getGlobalSnapshotInternal };
+//# sourceMappingURL=ExtensionRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionRegistry.js","sources":["../../../../src/extensions/ExtensionRegistry.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;AACA,IAAI,KAAK,GAAG,IAAI,GAAG,EAAqB;AACxC,IAAI,SAAS,GAAG,CAAC;AACjB,IAAI,MAAqE;AASzE;SACgB,yBAAyB,GAAA;AACvC,IAAA,IAAI,MAAM,EAAE,QAAQ,KAAK,SAAS,EAAE;QAClC,OAAO,MAAM,CAAC,QAAQ;IACxB;AAEA,IAAA,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;AAE1C,IAAA,OAAO,QAAQ;AACjB;AAEA;;;;;;;;AAQG;MACU,iBAAiB,CAAA;AAC5B,IAAA,WAAA,GAAA,EAAuB;AAEvB;;;;AAIG;IACI,OAAO,QAAQ,CAAC,SAAoB,EAAA;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;AAExC,QAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;YAC1B,IAAI,QAAQ,KAAK,SAAS;gBAAE;AAC5B,YAAA,MAAM,IAAI,KAAK,CACb,yBAAyB,SAAS,CAAC,EAAE,CAAA,qDAAA,CAAuD;AAC1F,gBAAA,CAAA,wGAAA,CAA0G,CAC7G;QACH;QAEA,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC;AAClC,QAAA,SAAS,EAAE;QACX,MAAM,GAAG,SAAS;IA0BpB;;IAGO,OAAO,GAAG,CAAC,EAAU,EAAA;AAC1B,QAAA,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACtB;;IAGO,OAAO,GAAG,CAAC,EAAU,EAAA;AAC1B,QAAA,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACtB;AAEA;;;;AAIG;AACI,IAAA,OAAO,IAAI,GAAA;AAChB,QAAA,OAAO,yBAAyB,EAAE,CAAC,UAAU;IAC/C;AACD;;;;"}

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

@@ -0,0 +1,3 @@
+export type { AssetBinding, AssetHandler, AssetLoadRequest, Extension, RendererBinding } from './Extension';
+export { ExtensionRegistry } from './ExtensionRegistry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5G,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/extensions/index.js

@@ -0,0 +1,2 @@
+export { ExtensionRegistry } from './ExtensionRegistry.js';
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,16 @@
+import type { RenderBackend } from '#rendering/RenderBackend';
+import type { Loader } from '#resources/Loader';
+import type { AssetBinding, RendererBinding } from './Extension';
+/**
+ * Materialise all renderer bindings into the backend's renderer registry.
+ * Called once per backend from createBackend in Application.
+ * @internal
+ */
+export declare function materializeRendererBindings(backend: RenderBackend, bindings: readonly RendererBinding[]): void;
+/**
+ * Materialise all asset bindings into the loader.
+ * Called once per Application construction.
+ * @internal
+ */
+export declare function materializeAssetBindings(loader: Loader, bindings: readonly AssetBinding[]): void;
+//# sourceMappingURL=materialize.d.ts.map

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

@@ -0,0 +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"}

package/dist/esm/extensions/materialize.js

@@ -0,0 +1,61 @@
+/**
+ * Materialise all renderer bindings into the backend's renderer registry.
+ * Called once per backend from createBackend in Application.
+ * @internal
+ */
+function materializeRendererBindings(backend, bindings) {
+    const seenTargets = new Set();
+    for (const binding of bindings) {
+        if (binding.targets.length === 0) {
+            throw new Error('A RendererBinding must declare at least one target.');
+        }
+        for (const target of binding.targets) {
+            if (seenTargets.has(target)) {
+                throw new Error(`Two bindings target the same drawable type ${target.name}. Remove one of the conflicting bindings.`);
+            }
+            seenTargets.add(target);
+        }
+        const renderer = binding.create(backend);
+        if (renderer === undefined)
+            continue;
+        backend.rendererRegistry.bindRenderer(binding.targets, renderer);
+    }
+}
+/**
+ * Materialise all asset bindings into the loader.
+ * Called once per Application construction.
+ * @internal
+ */
+function materializeAssetBindings(loader, bindings) {
+    // --- Cross-binding pre-validation (no mutation yet) ---
+    const seenTypes = new Set();
+    const seenNames = new Set();
+    const seenExts = new Set();
+    for (const binding of bindings) {
+        if (seenTypes.has(binding.type) || loader.hasLoadable(binding.type)) {
+            throw new Error(`An asset handler is already registered for ${binding.type.name}.`);
+        }
+        for (const name of binding.typeNames ?? []) {
+            if (seenNames.has(name) || loader.hasAssetType(name)) {
+                throw new Error(`Asset type name "${name}" is already registered. Remove the conflicting binding.`);
+            }
+            seenNames.add(name);
+        }
+        for (const ext of binding.extensions ?? []) {
+            const key = ext.replace(/^\./, '').toLowerCase();
+            if (seenExts.has(key) || loader.hasExtension(key)) {
+                throw new Error(`File extension ".${key}" is already mapped to an asset type. Remove the conflicting binding.`);
+            }
+            seenExts.add(key);
+        }
+        seenTypes.add(binding.type);
+    }
+    // --- 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);
+    }
+}
+
+export { materializeAssetBindings, materializeRendererBindings };
+//# sourceMappingURL=materialize.js.map

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

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

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

@@ -0,0 +1,16 @@
+import type { AssetBinding, Extension, RendererBinding } from './Extension';
+export interface ExtensionSnapshot {
+    readonly extensions: ReadonlyArray<Readonly<Extension>>;
+    readonly renderers: readonly RendererBinding[];
+    readonly assets: readonly AssetBinding[];
+}
+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.
+ * Binding-level conflicts are checked per Application at materialisation time.
+ * @internal
+ */
+export declare function buildSnapshot(input: readonly Extension[]): ExtensionSnapshot;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +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"}

package/dist/esm/extensions/snapshot.js

@@ -0,0 +1,49 @@
+// Shared empty singleton — zero allocation for extensions: [] selection.
+const emptySnapshot = Object.freeze({
+    extensions: Object.freeze([]),
+    renderers: Object.freeze([]),
+    assets: Object.freeze([]),
+});
+/**
+ * Flatten an ordered extension list into a snapshot.
+ * De-duplicates same-id/same-object entries; throws on same-id/different-object.
+ * Binding-level conflicts are checked per Application at materialisation time.
+ * @internal
+ */
+function buildSnapshot(input) {
+    if (input.length === 0) {
+        return emptySnapshot;
+    }
+    const seenById = new Map();
+    const extensions = [];
+    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);
+        if (ext.renderers) {
+            for (const binding of ext.renderers) {
+                renderers.push(binding);
+            }
+        }
+        if (ext.assets) {
+            for (const binding of ext.assets) {
+                assets.push(binding);
+            }
+        }
+    }
+    return Object.freeze({
+        extensions: Object.freeze(extensions),
+        renderers: Object.freeze(renderers),
+        assets: Object.freeze(assets),
+    });
+}
+
+export { emptySnapshot as EMPTY_SNAPSHOT, buildSnapshot };
+//# sourceMappingURL=snapshot.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Reset the global ExtensionRegistry to empty state.
+ * For use in test suites only. Import via direct source path:
+ *   import { resetExtensionRegistryForTesting } from 'src/extensions/testing';
+ */
+export declare function resetExtensionRegistryForTesting(): void;
+//# sourceMappingURL=testing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/extensions/testing.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}

package/dist/esm/index.d.ts

@@ -1,8 +1,9 @@
-export * from './animation/index';
-export * from './audio/index';
-export * from './core/index';
-export * from './input/index';
-export * from './math/index';
-export * from './particles/index';
-export * from './rendering/index';
-export * from './resources/index';
+export * from '#animation/index';
+export * from '#audio/index';
+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 '#resources/index';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}