@onerjs/loaders 8.56.1 → 8.56.2

package/USD/usdFileLoader.pure.js

@@ -0,0 +1,341 @@
+/** This file must only contain pure code and pure imports */
+/* eslint-disable @typescript-eslint/naming-convention */
+import { RegisterInstancedMesh } from "@onerjs/core/Meshes/instancedMesh.pure.js";
+import { RegisterThinInstanceMesh } from "@onerjs/core/Meshes/thinInstanceMesh.pure.js";
+import { RegisterPbrMaterial } from "@onerjs/core/Materials/PBR/pbrMaterial.pure.js";
+import { Tools } from "@onerjs/core/Misc/tools.pure.js";
+import { AssetContainer } from "@onerjs/core/assetContainer.js";
+import { RegisterSceneLoaderPlugin, } from "@onerjs/core/Loading/sceneLoader.js";
+import { USDFileLoaderMetadata } from "./usdFileLoader.metadata.js";
+import { materializeCommandBuffers } from "./usdSceneMaterializer.js";
+import { PROTOCOL_VERSION } from "./usdCommandProtocol.js";
+const _DefaultAssetRootUrl = `${Tools._DefaultCdnUrl}/babylonUsdImporter/${PROTOCOL_VERSION}/`;
+const _SupportedExtension = /\.(?:usd|usda|usdc|usdz)$/i;
+function _toBytes(input) {
+    if (input instanceof Uint8Array) {
+        return input.slice();
+    }
+    if (input instanceof ArrayBuffer) {
+        return new Uint8Array(input.slice(0));
+    }
+    return new Uint8Array(input.buffer.slice(input.byteOffset, input.byteOffset + input.byteLength));
+}
+function _normalizeFiles(files) {
+    if (!files) {
+        return undefined;
+    }
+    const normalized = {};
+    for (const [path, input] of Object.entries(files)) {
+        normalized[path] = _toBytes(input);
+    }
+    return normalized;
+}
+function _stagedFileName(fileName, bytes, preserveUrlCharacters) {
+    const normalizedFileName = fileName?.replace(/\\/g, "/").replace(/^\.\/+/, "");
+    const cleanFileName = preserveUrlCharacters ? normalizedFileName : normalizedFileName?.split(/[?#]/, 1)[0];
+    const pathParts = cleanFileName?.split("/").filter(Boolean);
+    if (cleanFileName && !cleanFileName.startsWith("/") && pathParts?.length && !pathParts.includes("..") && _SupportedExtension.test(cleanFileName)) {
+        return pathParts.join("/");
+    }
+    const isZip = bytes.length >= 4 && bytes[0] === 0x50 && bytes[1] === 0x4b && bytes[2] === 0x03 && bytes[3] === 0x04;
+    return isZip ? "scene.usdz" : "scene.usd";
+}
+function _toAsyncResult(container) {
+    return {
+        meshes: container.meshes,
+        particleSystems: container.particleSystems,
+        skeletons: container.skeletons,
+        animationGroups: container.animationGroups,
+        transformNodes: container.transformNodes,
+        geometries: container.geometries,
+        lights: container.lights,
+        spriteManagers: container.spriteManagers,
+    };
+}
+/**
+ * OpenUSD scene loader backed by a WebAssembly command-buffer extractor.
+ */
+export class USDFileLoader {
+    /**
+     * Creates a USD loader.
+     * @param options Options controlling worker assets, supporting files, and diagnostics.
+     */
+    constructor(options = {}) {
+        /**
+         * Defines the name of the plugin.
+         */
+        this.name = USDFileLoaderMetadata.name;
+        /**
+         * Defines the extensions the plugin can load.
+         */
+        this.extensions = USDFileLoaderMetadata.extensions;
+        this._nextRequestId = 1;
+        this._pending = new Map();
+        this._activeLoads = new Set();
+        this._options = {
+            ...options,
+            resolveByFileName: options.resolveByFileName ?? true,
+            glueUrl: options.glueUrl ?? USDFileLoader.DefaultConfiguration.glueUrl,
+            wasmUrl: options.wasmUrl ?? USDFileLoader.DefaultConfiguration.wasmUrl,
+            dataUrl: options.dataUrl ?? USDFileLoader.DefaultConfiguration.dataUrl,
+            workerUrl: options.workerUrl ?? USDFileLoader.DefaultConfiguration.workerUrl,
+        };
+    }
+    /**
+     * Creates a configured plugin instance for a SceneLoader operation.
+     * @param options SceneLoader plugin options.
+     * @returns The configured USD loader.
+     */
+    createPlugin(options) {
+        _RegisterUSDLoaderDependencies();
+        return new USDFileLoader(options[USDFileLoaderMetadata.name]);
+    }
+    /**
+     * Imports all objects from a USD stage into a scene.
+     * @param _meshesNames Mesh name filtering is not currently supported.
+     * @param scene The scene receiving the imported objects.
+     * @param data The USD, USDA, USDC, or USDZ bytes.
+     * @param rootUrl The source root URL.
+     * @param onProgress SceneLoader progress callback.
+     * @param fileName Name of the root USD layer.
+     * @returns The imported Babylon.js objects.
+     */
+    async importMeshAsync(_meshesNames, scene, data, rootUrl, onProgress, fileName) {
+        const result = await this._loadAsync(scene, data, rootUrl, onProgress, fileName, true);
+        return _toAsyncResult(result.container);
+    }
+    /**
+     * Loads a USD stage into a scene.
+     * @param scene The scene receiving the imported objects.
+     * @param data The USD, USDA, USDC, or USDZ bytes.
+     * @param rootUrl The source root URL.
+     * @param onProgress SceneLoader progress callback.
+     * @param fileName Name of the root USD layer.
+     */
+    async loadAsync(scene, data, rootUrl, onProgress, fileName) {
+        await this._loadAsync(scene, data, rootUrl, onProgress, fileName, true);
+    }
+    /**
+     * Loads a USD stage into an asset container.
+     * @param scene The scene used to create imported objects.
+     * @param data The USD, USDA, USDC, or USDZ bytes.
+     * @param rootUrl The source root URL.
+     * @param onProgress SceneLoader progress callback.
+     * @param fileName Name of the root USD layer.
+     * @returns The populated asset container.
+     */
+    async loadAssetContainerAsync(scene, data, rootUrl, onProgress, fileName) {
+        const container = (await this._loadAsync(scene, data, rootUrl, onProgress, fileName, false)).container;
+        if (!(container instanceof AssetContainer)) {
+            throw new Error("USDFileLoader failed to create an asset container.");
+        }
+        return container;
+    }
+    /**
+     * Releases the worker and rejects pending loads.
+     */
+    dispose() {
+        this._terminateWorker();
+        const error = new Error("USDFileLoader was disposed.");
+        for (const controller of this._activeLoads) {
+            controller.abort(error);
+        }
+        for (const request of this._pending.values()) {
+            request.reject(error);
+        }
+        this._pending.clear();
+    }
+    async _loadAsync(scene, data, _rootUrl, onProgress, fileName, addToScene) {
+        if (!(data instanceof ArrayBuffer) && !ArrayBuffer.isView(data)) {
+            throw new Error("USDFileLoader expects binary USD data.");
+        }
+        const bytes = _toBytes(data);
+        const files = _normalizeFiles(this._options.files);
+        const requestId = this._nextRequestId++;
+        const request = {
+            type: "extract",
+            requestId,
+            asset: {
+                bytes,
+                files,
+                fileName: _stagedFileName(this._options.rootFileName ?? fileName, bytes, this._options.rootFileName !== undefined),
+                resolveByFileName: this._options.resolveByFileName ?? true,
+                glueUrl: this._options.glueUrl,
+                wasmUrl: this._options.wasmUrl,
+                dataUrl: this._options.dataUrl,
+            },
+        };
+        const transfer = [...new Set([bytes.buffer, ...Object.values(files ?? {}).map((file) => file.buffer)])];
+        const controller = new AbortController();
+        const signal = controller.signal;
+        this._activeLoads.add(controller);
+        try {
+            const worker = this._getWorker(this._options.workerUrl);
+            const response = await new Promise((resolve, reject) => {
+                this._pending.set(requestId, {
+                    resolve,
+                    reject,
+                    onProgress: (progress) => {
+                        this._options.onProgress?.(progress);
+                        onProgress?.({
+                            lengthComputable: false,
+                            loaded: _ProgressPhaseIndex[progress.phase],
+                            total: 4,
+                        });
+                    },
+                    onLog: this._options.onLog,
+                });
+                try {
+                    worker.postMessage(request, transfer);
+                }
+                catch (error) {
+                    this._pending.delete(requestId);
+                    reject(error instanceof Error ? error : new Error(String(error)));
+                }
+            });
+            const materializingProgress = {
+                phase: "materializing",
+                message: "Creating Babylon.js objects...",
+            };
+            this._options.onProgress?.(materializingProgress);
+            onProgress?.({ lengthComputable: false, loaded: 4, total: 4 });
+            signal.throwIfAborted();
+            const materialized = await materializeCommandBuffers(scene, response.commands, response.data, addToScene, signal);
+            const result = {
+                container: materialized.container,
+                timings: {
+                    ...response.timings,
+                    materializeMs: materialized.materializeMs,
+                },
+                statistics: response.statistics,
+                missingAssets: response.missingAssets,
+            };
+            try {
+                signal.throwIfAborted();
+                this._options.onComplete?.({
+                    timings: result.timings,
+                    statistics: result.statistics,
+                    missingAssets: result.missingAssets,
+                });
+                signal.throwIfAborted();
+            }
+            catch (error) {
+                materialized.container.dispose();
+                throw error;
+            }
+            return result;
+        }
+        finally {
+            this._activeLoads.delete(controller);
+            if (this._pending.size === 0) {
+                this._terminateWorker();
+            }
+        }
+    }
+    _getWorker(workerUrl) {
+        if (!workerUrl) {
+            throw new Error("The USD worker URL was not configured.");
+        }
+        const currentLocation = globalThis.location;
+        const resolvedUrl = new URL(String(workerUrl), currentLocation?.href ?? "http://localhost/").href;
+        if (this._worker && this._workerUrl !== resolvedUrl) {
+            if (this._pending.size > 0) {
+                throw new Error("Cannot change the USD worker URL while requests are pending.");
+            }
+            this._terminateWorker();
+        }
+        if (this._worker) {
+            return this._worker;
+        }
+        this._workerUrl = resolvedUrl;
+        if (!currentLocation || new URL(resolvedUrl).origin === currentLocation.origin) {
+            this._worker = new Worker(resolvedUrl, { type: "module" });
+        }
+        else {
+            this._workerBlobUrl = URL.createObjectURL(new Blob([`import ${JSON.stringify(resolvedUrl)};`], { type: "application/javascript" }));
+            this._worker = new Worker(this._workerBlobUrl, { type: "module" });
+        }
+        this._worker.addEventListener("message", (event) => {
+            const response = event.data;
+            const pending = this._pending.get(response.requestId);
+            if (!pending) {
+                return;
+            }
+            if (response.type === "progress") {
+                pending.onProgress?.(response.progress);
+                return;
+            }
+            if (response.type === "log") {
+                pending.onLog?.(response.level >= 2 ? "error" : response.level === 1 ? "warning" : "info", response.message);
+                return;
+            }
+            this._pending.delete(response.requestId);
+            if (response.type === "error") {
+                const error = new Error(response.message);
+                error.stack = response.stack;
+                pending.reject(error);
+            }
+            else {
+                pending.resolve(response);
+            }
+        });
+        const fail = (error) => {
+            this._terminateWorker();
+            for (const request of this._pending.values()) {
+                request.reject(error);
+            }
+            this._pending.clear();
+        };
+        this._worker.addEventListener("error", (event) => {
+            fail(event.error ?? new Error(event.message || `Could not load the USD worker from '${resolvedUrl}'.`));
+        });
+        this._worker.addEventListener("messageerror", () => {
+            fail(new Error("The USD worker returned a message that could not be deserialized."));
+        });
+        return this._worker;
+    }
+    _terminateWorker() {
+        this._worker?.terminate();
+        this._worker = undefined;
+        this._workerUrl = undefined;
+        if (this._workerBlobUrl) {
+            URL.revokeObjectURL(this._workerBlobUrl);
+            this._workerBlobUrl = undefined;
+        }
+    }
+}
+/**
+ * Default URLs for the prebuilt OpenUSD importer assets.
+ */
+USDFileLoader.DefaultConfiguration = {
+    glueUrl: `${_DefaultAssetRootUrl}babylon-usd-importer.js`,
+    wasmUrl: `${_DefaultAssetRootUrl}babylon-usd-importer.wasm`,
+    dataUrl: `${_DefaultAssetRootUrl}babylon-usd-importer.data`,
+    workerUrl: `${_DefaultAssetRootUrl}babylon-usd-importer.worker.js`,
+};
+const _ProgressPhaseIndex = {
+    initializing: 1,
+    staging: 2,
+    extracting: 3,
+    materializing: 4,
+};
+let _Registered = false;
+/** @internal */
+export function _RegisterUSDLoaderDependencies() {
+    RegisterPbrMaterial();
+    RegisterInstancedMesh();
+    RegisterThinInstanceMesh();
+}
+/**
+ * Registers the USD scene loader plugin and its Babylon.js runtime dependencies.
+ * Safe to call multiple times; only the first call has an effect.
+ */
+export function RegisterUSDFileLoader() {
+    if (_Registered) {
+        return;
+    }
+    _Registered = true;
+    _RegisterUSDLoaderDependencies();
+    RegisterSceneLoaderPlugin(new USDFileLoader());
+}
+//# sourceMappingURL=usdFileLoader.pure.js.map

package/USD/usdFileLoader.pure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usdFileLoader.pure.js","sourceRoot":"","sources":["../../../../dev/loaders/src/USD/usdFileLoader.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,yDAAyD;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAA+B,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAMH,yBAAyB,GAC5B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAUjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAiBxD,MAAM,oBAAoB,GAAG,GAAG,KAAK,CAAC,cAAc,uBAAuB,gBAAgB,GAAG,CAAC;AAC/F,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;AAEzD,SAAS,QAAQ,CAAC,KAAqB;IACnC,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QAC/B,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,SAAS,eAAe,CAAC,KAAuB;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,UAAU,GAA+B,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,SAAS,eAAe,CAAC,QAA4B,EAAE,KAAiB,EAAE,qBAA8B;IACpG,MAAM,kBAAkB,GAAG,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,qBAAqB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3G,MAAM,SAAS,GAAG,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,aAAa,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,EAAE,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/I,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACpH,OAAO,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;AAC9C,CAAC;AAED,SAAS,cAAc,CAAC,SAAiC;IACrD,OAAO;QACH,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,eAAe,EAAE,SAAS,CAAC,eAAe;QAC1C,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,eAAe,EAAE,SAAS,CAAC,eAAe;QAC1C,cAAc,EAAE,SAAS,CAAC,cAAc;QACxC,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,cAAc,EAAE,SAAS,CAAC,cAAc;KAC3C,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,aAAa;IA6BtB;;;OAGG;IACH,YAAmB,UAAyC,EAAE;QAtB9D;;WAEG;QACa,SAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC;QAElD;;WAEG;QACa,eAAU,GAAG,qBAAqB,CAAC,UAAU,CAAC;QAMtD,mBAAc,GAAG,CAAC,CAAC;QACV,aAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;QAC7C,iBAAY,GAAG,IAAI,GAAG,EAAmB,CAAC;QAOvD,IAAI,CAAC,QAAQ,GAAG;YACZ,GAAG,OAAO;YACV,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI;YACpD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,aAAa,CAAC,oBAAoB,CAAC,OAAO;YACtE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,aAAa,CAAC,oBAAoB,CAAC,OAAO;YACtE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,aAAa,CAAC,oBAAoB,CAAC,OAAO;YACtE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,aAAa,CAAC,oBAAoB,CAAC,SAAS;SAC/E,CAAC;IACN,CAAC;IAED;;;;OAIG;IACI,YAAY,CAAC,OAAiC;QACjD,8BAA8B,EAAE,CAAC;QACjC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;OASG;IACI,KAAK,CAAC,eAAe,CACxB,YAA2D,EAC3D,KAAY,EACZ,IAAa,EACb,OAAe,EACf,UAAuD,EACvD,QAAiB;QAEjB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvF,OAAO,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,SAAS,CAAC,KAAY,EAAE,IAAa,EAAE,OAAe,EAAE,UAAuD,EAAE,QAAiB;QAC3I,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,uBAAuB,CAChC,KAAY,EACZ,IAAa,EACb,OAAe,EACf,UAAuD,EACvD,QAAiB;QAEjB,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACvG,IAAI,CAAC,CAAC,SAAS,YAAY,cAAc,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;OAEG;IACI,OAAO;QACV,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACvD,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACzC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,UAAU,CACpB,KAAY,EACZ,IAAa,EACb,QAAgB,EAChB,UAAoE,EACpE,QAA4B,EAC5B,UAAmB;QAEnB,IAAI,CAAC,CAAC,IAAI,YAAY,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,MAAM,OAAO,GAAmB;YAC5B,IAAI,EAAE,SAAS;YACf,SAAS;YACT,KAAK,EAAE;gBACH,KAAK;gBACL,KAAK;gBACL,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,IAAI,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,CAAC;gBAClH,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,IAAI;gBAC1D,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAC9B,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;aACjC;SACJ,CAAC;QACF,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACxG,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAA8C,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAChG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE;oBACzB,OAAO;oBACP,MAAM;oBACN,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE;wBACrB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;wBACrC,UAAU,EAAE,CAAC;4BACT,gBAAgB,EAAE,KAAK;4BACvB,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC;4BAC3C,KAAK,EAAE,CAAC;yBACX,CAAC,CAAC;oBACP,CAAC;oBACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK;iBAC7B,CAAC,CAAC;gBACH,IAAI,CAAC;oBACD,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC1C,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBAChC,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtE,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,MAAM,qBAAqB,GAAG;gBAC1B,KAAK,EAAE,eAAe;gBACtB,OAAO,EAAE,gCAAgC;aACnC,CAAC;YACX,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,qBAAqB,CAAC,CAAC;YAClD,UAAU,EAAE,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAC/D,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,MAAM,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;YAClH,MAAM,MAAM,GAAG;gBACX,SAAS,EAAE,YAAY,CAAC,SAAS;gBACjC,OAAO,EAAE;oBACL,GAAG,QAAQ,CAAC,OAAO;oBACnB,aAAa,EAAE,YAAY,CAAC,aAAa;iBAC5C;gBACD,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,aAAa,EAAE,QAAQ,CAAC,aAAa;aACxC,CAAC;YACF,IAAI,CAAC;gBACD,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;oBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;iBACP,CAAC,CAAC;gBAClC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,YAAY,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACjC,MAAM,KAAK,CAAC;YAChB,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC5B,CAAC;QACL,CAAC;IACL,CAAC;IAEO,UAAU,CAAC,SAAwB;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,eAAe,GAAG,UAAU,CAAC,QAAQ,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,IAAI,IAAI,mBAAmB,CAAC,CAAC,IAAI,CAAC;QAClG,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;YAClD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;YACpF,CAAC;YACD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,OAAO,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC;QAC9B,IAAI,CAAC,eAAe,IAAI,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;YAC7E,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAC,CAAC;YACpI,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAmC,EAAE,EAAE;YAC7E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACtD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,OAAO;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC/B,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACxC,OAAO;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC1B,OAAO,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC7G,OAAO;YACX,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC1C,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;gBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,KAAY,EAAE,EAAE;YAC1B,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC7C,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,uCAAuC,WAAW,IAAI,CAAC,CAAC,CAAC;QAC5G,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,EAAE,GAAG,EAAE;YAC/C,IAAI,CAAC,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAEO,gBAAgB;QACpB,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACzC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QACpC,CAAC;IACL,CAAC;;AA/RD;;GAEG;AACW,kCAAoB,GAAG;IACjC,OAAO,EAAE,GAAG,oBAAoB,yBAAyB;IACzD,OAAO,EAAE,GAAG,oBAAoB,2BAA2B;IAC3D,OAAO,EAAE,GAAG,oBAAoB,2BAA2B;IAC3D,SAAS,EAAE,GAAG,oBAAoB,gCAAgC;CACrE,AALiC,CAKhC;AA0RN,MAAM,mBAAmB,GAA6C;IAClE,YAAY,EAAE,CAAC;IACf,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,CAAC;CACnB,CAAC;AAEF,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,gBAAgB;AAChB,MAAM,UAAU,8BAA8B;IAC1C,mBAAmB,EAAE,CAAC;IACtB,qBAAqB,EAAE,CAAC;IACxB,wBAAwB,EAAE,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACjC,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;IACX,CAAC;IACD,WAAW,GAAG,IAAI,CAAC;IACnB,8BAA8B,EAAE,CAAC;IACjC,yBAAyB,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC;AACnD,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\n/* eslint-disable @typescript-eslint/naming-convention */\n\nimport { RegisterInstancedMesh } from \"core/Meshes/instancedMesh.pure\";\nimport { RegisterThinInstanceMesh } from \"core/Meshes/thinInstanceMesh.pure\";\nimport { RegisterPbrMaterial } from \"core/Materials/PBR/pbrMaterial.pure\";\nimport { Tools } from \"core/Misc/tools.pure\";\nimport { type AbstractAssetContainer, AssetContainer } from \"core/assetContainer\";\nimport {\n    type ISceneLoaderAsyncResult,\n    type ISceneLoaderPluginAsync,\n    type ISceneLoaderPluginFactory,\n    type ISceneLoaderProgressEvent,\n    type SceneLoaderPluginOptions,\n    RegisterSceneLoaderPlugin,\n} from \"core/Loading/sceneLoader\";\nimport { type Scene } from \"core/scene.pure\";\n\nimport { USDFileLoaderMetadata } from \"./usdFileLoader.metadata\";\nimport {\n    type USDBinaryInput,\n    type USDFileLoaderOptions,\n    type USDImportDiagnostics,\n    type USDImportStatistics,\n    type USDImportTimings,\n    type USDLoadProgress,\n    type USDVirtualFiles,\n} from \"./usdLoadingOptions\";\nimport { materializeCommandBuffers } from \"./usdSceneMaterializer\";\nimport { PROTOCOL_VERSION } from \"./usdCommandProtocol\";\nimport { type ExtractRequest, type WorkerResponse } from \"./usdWorkerMessages\";\n\ninterface PendingRequest {\n    resolve: (response: Extract<WorkerResponse, { type: \"result\" }>) => void;\n    reject: (error: Error) => void;\n    onProgress?: (progress: USDLoadProgress) => void;\n    onLog?: USDFileLoaderOptions[\"onLog\"];\n}\n\ninterface USDLoadResult {\n    container: AbstractAssetContainer;\n    timings: USDImportTimings;\n    statistics: USDImportStatistics;\n    missingAssets: string[];\n}\n\nconst _DefaultAssetRootUrl = `${Tools._DefaultCdnUrl}/babylonUsdImporter/${PROTOCOL_VERSION}/`;\nconst _SupportedExtension = /\\.(?:usd|usda|usdc|usdz)$/i;\n\nfunction _toBytes(input: USDBinaryInput): Uint8Array {\n    if (input instanceof Uint8Array) {\n        return input.slice();\n    }\n    if (input instanceof ArrayBuffer) {\n        return new Uint8Array(input.slice(0));\n    }\n    return new Uint8Array(input.buffer.slice(input.byteOffset, input.byteOffset + input.byteLength));\n}\n\nfunction _normalizeFiles(files?: USDVirtualFiles): Record<string, Uint8Array> | undefined {\n    if (!files) {\n        return undefined;\n    }\n    const normalized: Record<string, Uint8Array> = {};\n    for (const [path, input] of Object.entries(files)) {\n        normalized[path] = _toBytes(input);\n    }\n    return normalized;\n}\n\nfunction _stagedFileName(fileName: string | undefined, bytes: Uint8Array, preserveUrlCharacters: boolean): string {\n    const normalizedFileName = fileName?.replace(/\\\\/g, \"/\").replace(/^\\.\\/+/, \"\");\n    const cleanFileName = preserveUrlCharacters ? normalizedFileName : normalizedFileName?.split(/[?#]/, 1)[0];\n    const pathParts = cleanFileName?.split(\"/\").filter(Boolean);\n    if (cleanFileName && !cleanFileName.startsWith(\"/\") && pathParts?.length && !pathParts.includes(\"..\") && _SupportedExtension.test(cleanFileName)) {\n        return pathParts.join(\"/\");\n    }\n    const isZip = bytes.length >= 4 && bytes[0] === 0x50 && bytes[1] === 0x4b && bytes[2] === 0x03 && bytes[3] === 0x04;\n    return isZip ? \"scene.usdz\" : \"scene.usd\";\n}\n\nfunction _toAsyncResult(container: AbstractAssetContainer): ISceneLoaderAsyncResult {\n    return {\n        meshes: container.meshes,\n        particleSystems: container.particleSystems,\n        skeletons: container.skeletons,\n        animationGroups: container.animationGroups,\n        transformNodes: container.transformNodes,\n        geometries: container.geometries,\n        lights: container.lights,\n        spriteManagers: container.spriteManagers,\n    };\n}\n\n/**\n * OpenUSD scene loader backed by a WebAssembly command-buffer extractor.\n */\nexport class USDFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPluginFactory {\n    /**\n     * Default URLs for the prebuilt OpenUSD importer assets.\n     */\n    public static DefaultConfiguration = {\n        glueUrl: `${_DefaultAssetRootUrl}babylon-usd-importer.js`,\n        wasmUrl: `${_DefaultAssetRootUrl}babylon-usd-importer.wasm`,\n        dataUrl: `${_DefaultAssetRootUrl}babylon-usd-importer.data`,\n        workerUrl: `${_DefaultAssetRootUrl}babylon-usd-importer.worker.js`,\n    };\n\n    /**\n     * Defines the name of the plugin.\n     */\n    public readonly name = USDFileLoaderMetadata.name;\n\n    /**\n     * Defines the extensions the plugin can load.\n     */\n    public readonly extensions = USDFileLoaderMetadata.extensions;\n\n    private readonly _options: USDFileLoaderOptions;\n    private _worker: Worker | undefined;\n    private _workerUrl: string | undefined;\n    private _workerBlobUrl: string | undefined;\n    private _nextRequestId = 1;\n    private readonly _pending = new Map<number, PendingRequest>();\n    private readonly _activeLoads = new Set<AbortController>();\n\n    /**\n     * Creates a USD loader.\n     * @param options Options controlling worker assets, supporting files, and diagnostics.\n     */\n    public constructor(options: Partial<USDFileLoaderOptions> = {}) {\n        this._options = {\n            ...options,\n            resolveByFileName: options.resolveByFileName ?? true,\n            glueUrl: options.glueUrl ?? USDFileLoader.DefaultConfiguration.glueUrl,\n            wasmUrl: options.wasmUrl ?? USDFileLoader.DefaultConfiguration.wasmUrl,\n            dataUrl: options.dataUrl ?? USDFileLoader.DefaultConfiguration.dataUrl,\n            workerUrl: options.workerUrl ?? USDFileLoader.DefaultConfiguration.workerUrl,\n        };\n    }\n\n    /**\n     * Creates a configured plugin instance for a SceneLoader operation.\n     * @param options SceneLoader plugin options.\n     * @returns The configured USD loader.\n     */\n    public createPlugin(options: SceneLoaderPluginOptions): ISceneLoaderPluginAsync {\n        _RegisterUSDLoaderDependencies();\n        return new USDFileLoader(options[USDFileLoaderMetadata.name]);\n    }\n\n    /**\n     * Imports all objects from a USD stage into a scene.\n     * @param _meshesNames Mesh name filtering is not currently supported.\n     * @param scene The scene receiving the imported objects.\n     * @param data The USD, USDA, USDC, or USDZ bytes.\n     * @param rootUrl The source root URL.\n     * @param onProgress SceneLoader progress callback.\n     * @param fileName Name of the root USD layer.\n     * @returns The imported Babylon.js objects.\n     */\n    public async importMeshAsync(\n        _meshesNames: string | readonly string[] | null | undefined,\n        scene: Scene,\n        data: unknown,\n        rootUrl: string,\n        onProgress?: (event: ISceneLoaderProgressEvent) => void,\n        fileName?: string\n    ): Promise<ISceneLoaderAsyncResult> {\n        const result = await this._loadAsync(scene, data, rootUrl, onProgress, fileName, true);\n        return _toAsyncResult(result.container);\n    }\n\n    /**\n     * Loads a USD stage into a scene.\n     * @param scene The scene receiving the imported objects.\n     * @param data The USD, USDA, USDC, or USDZ bytes.\n     * @param rootUrl The source root URL.\n     * @param onProgress SceneLoader progress callback.\n     * @param fileName Name of the root USD layer.\n     */\n    public async loadAsync(scene: Scene, data: unknown, rootUrl: string, onProgress?: (event: ISceneLoaderProgressEvent) => void, fileName?: string): Promise<void> {\n        await this._loadAsync(scene, data, rootUrl, onProgress, fileName, true);\n    }\n\n    /**\n     * Loads a USD stage into an asset container.\n     * @param scene The scene used to create imported objects.\n     * @param data The USD, USDA, USDC, or USDZ bytes.\n     * @param rootUrl The source root URL.\n     * @param onProgress SceneLoader progress callback.\n     * @param fileName Name of the root USD layer.\n     * @returns The populated asset container.\n     */\n    public async loadAssetContainerAsync(\n        scene: Scene,\n        data: unknown,\n        rootUrl: string,\n        onProgress?: (event: ISceneLoaderProgressEvent) => void,\n        fileName?: string\n    ): Promise<AssetContainer> {\n        const container = (await this._loadAsync(scene, data, rootUrl, onProgress, fileName, false)).container;\n        if (!(container instanceof AssetContainer)) {\n            throw new Error(\"USDFileLoader failed to create an asset container.\");\n        }\n        return container;\n    }\n\n    /**\n     * Releases the worker and rejects pending loads.\n     */\n    public dispose(): void {\n        this._terminateWorker();\n        const error = new Error(\"USDFileLoader was disposed.\");\n        for (const controller of this._activeLoads) {\n            controller.abort(error);\n        }\n        for (const request of this._pending.values()) {\n            request.reject(error);\n        }\n        this._pending.clear();\n    }\n\n    private async _loadAsync(\n        scene: Scene,\n        data: unknown,\n        _rootUrl: string,\n        onProgress: ((event: ISceneLoaderProgressEvent) => void) | undefined,\n        fileName: string | undefined,\n        addToScene: boolean\n    ): Promise<USDLoadResult> {\n        if (!(data instanceof ArrayBuffer) && !ArrayBuffer.isView(data)) {\n            throw new Error(\"USDFileLoader expects binary USD data.\");\n        }\n        const bytes = _toBytes(data);\n        const files = _normalizeFiles(this._options.files);\n        const requestId = this._nextRequestId++;\n        const request: ExtractRequest = {\n            type: \"extract\",\n            requestId,\n            asset: {\n                bytes,\n                files,\n                fileName: _stagedFileName(this._options.rootFileName ?? fileName, bytes, this._options.rootFileName !== undefined),\n                resolveByFileName: this._options.resolveByFileName ?? true,\n                glueUrl: this._options.glueUrl,\n                wasmUrl: this._options.wasmUrl,\n                dataUrl: this._options.dataUrl,\n            },\n        };\n        const transfer = [...new Set([bytes.buffer, ...Object.values(files ?? {}).map((file) => file.buffer)])];\n        const controller = new AbortController();\n        const signal = controller.signal;\n        this._activeLoads.add(controller);\n        try {\n            const worker = this._getWorker(this._options.workerUrl);\n            const response = await new Promise<Extract<WorkerResponse, { type: \"result\" }>>((resolve, reject) => {\n                this._pending.set(requestId, {\n                    resolve,\n                    reject,\n                    onProgress: (progress) => {\n                        this._options.onProgress?.(progress);\n                        onProgress?.({\n                            lengthComputable: false,\n                            loaded: _ProgressPhaseIndex[progress.phase],\n                            total: 4,\n                        });\n                    },\n                    onLog: this._options.onLog,\n                });\n                try {\n                    worker.postMessage(request, transfer);\n                } catch (error) {\n                    this._pending.delete(requestId);\n                    reject(error instanceof Error ? error : new Error(String(error)));\n                }\n            });\n\n            const materializingProgress = {\n                phase: \"materializing\",\n                message: \"Creating Babylon.js objects...\",\n            } as const;\n            this._options.onProgress?.(materializingProgress);\n            onProgress?.({ lengthComputable: false, loaded: 4, total: 4 });\n            signal.throwIfAborted();\n            const materialized = await materializeCommandBuffers(scene, response.commands, response.data, addToScene, signal);\n            const result = {\n                container: materialized.container,\n                timings: {\n                    ...response.timings,\n                    materializeMs: materialized.materializeMs,\n                },\n                statistics: response.statistics,\n                missingAssets: response.missingAssets,\n            };\n            try {\n                signal.throwIfAborted();\n                this._options.onComplete?.({\n                    timings: result.timings,\n                    statistics: result.statistics,\n                    missingAssets: result.missingAssets,\n                } satisfies USDImportDiagnostics);\n                signal.throwIfAborted();\n            } catch (error) {\n                materialized.container.dispose();\n                throw error;\n            }\n            return result;\n        } finally {\n            this._activeLoads.delete(controller);\n            if (this._pending.size === 0) {\n                this._terminateWorker();\n            }\n        }\n    }\n\n    private _getWorker(workerUrl?: string | URL): Worker {\n        if (!workerUrl) {\n            throw new Error(\"The USD worker URL was not configured.\");\n        }\n        const currentLocation = globalThis.location;\n        const resolvedUrl = new URL(String(workerUrl), currentLocation?.href ?? \"http://localhost/\").href;\n        if (this._worker && this._workerUrl !== resolvedUrl) {\n            if (this._pending.size > 0) {\n                throw new Error(\"Cannot change the USD worker URL while requests are pending.\");\n            }\n            this._terminateWorker();\n        }\n        if (this._worker) {\n            return this._worker;\n        }\n        this._workerUrl = resolvedUrl;\n        if (!currentLocation || new URL(resolvedUrl).origin === currentLocation.origin) {\n            this._worker = new Worker(resolvedUrl, { type: \"module\" });\n        } else {\n            this._workerBlobUrl = URL.createObjectURL(new Blob([`import ${JSON.stringify(resolvedUrl)};`], { type: \"application/javascript\" }));\n            this._worker = new Worker(this._workerBlobUrl, { type: \"module\" });\n        }\n        this._worker.addEventListener(\"message\", (event: MessageEvent<WorkerResponse>) => {\n            const response = event.data;\n            const pending = this._pending.get(response.requestId);\n            if (!pending) {\n                return;\n            }\n            if (response.type === \"progress\") {\n                pending.onProgress?.(response.progress);\n                return;\n            }\n            if (response.type === \"log\") {\n                pending.onLog?.(response.level >= 2 ? \"error\" : response.level === 1 ? \"warning\" : \"info\", response.message);\n                return;\n            }\n            this._pending.delete(response.requestId);\n            if (response.type === \"error\") {\n                const error = new Error(response.message);\n                error.stack = response.stack;\n                pending.reject(error);\n            } else {\n                pending.resolve(response);\n            }\n        });\n        const fail = (error: Error) => {\n            this._terminateWorker();\n            for (const request of this._pending.values()) {\n                request.reject(error);\n            }\n            this._pending.clear();\n        };\n        this._worker.addEventListener(\"error\", (event) => {\n            fail(event.error ?? new Error(event.message || `Could not load the USD worker from '${resolvedUrl}'.`));\n        });\n        this._worker.addEventListener(\"messageerror\", () => {\n            fail(new Error(\"The USD worker returned a message that could not be deserialized.\"));\n        });\n        return this._worker;\n    }\n\n    private _terminateWorker(): void {\n        this._worker?.terminate();\n        this._worker = undefined;\n        this._workerUrl = undefined;\n        if (this._workerBlobUrl) {\n            URL.revokeObjectURL(this._workerBlobUrl);\n            this._workerBlobUrl = undefined;\n        }\n    }\n}\n\nconst _ProgressPhaseIndex: Record<USDLoadProgress[\"phase\"], number> = {\n    initializing: 1,\n    staging: 2,\n    extracting: 3,\n    materializing: 4,\n};\n\nlet _Registered = false;\n\n/** @internal */\nexport function _RegisterUSDLoaderDependencies(): void {\n    RegisterPbrMaterial();\n    RegisterInstancedMesh();\n    RegisterThinInstanceMesh();\n}\n\n/**\n * Registers the USD scene loader plugin and its Babylon.js runtime dependencies.\n * Safe to call multiple times; only the first call has an effect.\n */\nexport function RegisterUSDFileLoader(): void {\n    if (_Registered) {\n        return;\n    }\n    _Registered = true;\n    _RegisterUSDLoaderDependencies();\n    RegisterSceneLoaderPlugin(new USDFileLoader());\n}\n"]}

package/USD/usdFileLoader.types.d.ts

@@ -0,0 +1,11 @@
+export {};
+import { type USDFileLoaderMetadata } from "./usdFileLoader.metadata.js";
+import { type USDFileLoaderOptions } from "./usdLoadingOptions.js";
+declare module "@onerjs/core/Loading/sceneLoader.js" {
+    interface SceneLoaderPluginOptions {
+        /**
+         * Defines options for the USD loader.
+         */
+        [USDFileLoaderMetadata.name]: Partial<USDFileLoaderOptions>;
+    }
+}

package/USD/usdFileLoader.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=usdFileLoader.types.js.map

package/USD/usdFileLoader.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usdFileLoader.types.js","sourceRoot":"","sources":["../../../../dev/loaders/src/USD/usdFileLoader.types.ts"],"names":[],"mappings":"","sourcesContent":["export {};\n\nimport { type USDFileLoaderMetadata } from \"./usdFileLoader.metadata\";\nimport { type USDFileLoaderOptions } from \"./usdLoadingOptions\";\n\ndeclare module \"core/Loading/sceneLoader\" {\n    // eslint-disable-next-line jsdoc/require-jsdoc, @typescript-eslint/naming-convention\n    export interface SceneLoaderPluginOptions {\n        /**\n         * Defines options for the USD loader.\n         */\n        [USDFileLoaderMetadata.name]: Partial<USDFileLoaderOptions>;\n    }\n}\n"]}

package/USD/usdLoadingOptions.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Binary input accepted for supporting USD layers and assets.
+ */
+export type USDBinaryInput = ArrayBuffer | ArrayBufferView;
+/**
+ * Virtual files supplied alongside the root USD layer, keyed by their path relative to the
+ * root layer.
+ */
+export type USDVirtualFiles = Readonly<Record<string, USDBinaryInput>>;
+/**
+ * Progress phases reported by the USD worker and Babylon materializer.
+ */
+export interface USDLoadProgress {
+    /**
+     * Current importer phase.
+     */
+    phase: "initializing" | "staging" | "extracting" | "materializing";
+    /**
+     * Human-readable phase description.
+     */
+    message: string;
+}
+/**
+ * Options for the OpenUSD scene loader.
+ */
+export interface USDFileLoaderOptions {
+    /**
+     * Virtual path used to stage the root layer. Set this when supporting files need
+     * to resolve relative to a directory hierarchy.
+     */
+    rootFileName?: string;
+    /**
+     * Supporting layers, payloads, and textures keyed by virtual path in the same
+     * virtual file system as `rootFileName`.
+     */
+    files?: USDVirtualFiles;
+    /**
+     * Enables conservative file-name fallback for unresolved absolute references.
+     * Defaults to true.
+     */
+    resolveByFileName?: boolean;
+    /**
+     * URL of the module worker. Defaults to the protocol-versioned worker hosted on the Babylon.js CDN.
+     */
+    workerUrl?: string | URL;
+    /**
+     * URL of the generated Emscripten JavaScript module.
+     */
+    glueUrl?: string;
+    /**
+     * URL of the OpenUSD WebAssembly binary.
+     */
+    wasmUrl?: string;
+    /**
+     * URL of the OpenUSD preloaded resource bundle.
+     */
+    dataUrl?: string;
+    /**
+     * Called when the importer moves to a new processing phase.
+     */
+    onProgress?: (progress: USDLoadProgress) => void;
+    /**
+     * Called for OpenUSD diagnostic messages.
+     */
+    onLog?: (level: "info" | "warning" | "error", message: string) => void;
+    /**
+     * Called after extraction and Babylon.js object creation complete.
+     */
+    onComplete?: (diagnostics: USDImportDiagnostics) => void;
+}
+/**
+ * Timing data measured by the OpenUSD worker and Babylon materializer.
+ */
+export interface USDImportTimings {
+    /** Total extraction time, including the final Wasm heap copy. */
+    totalMs: number;
+    /** Time spent opening and composing the USD stage. */
+    stageOpenMs: number;
+    /** Time spent traversing the composed stage. */
+    stageReadMs: number;
+    /** Time spent preparing renderable vertex streams. */
+    preparationMs: number;
+    /** Time spent packing the command and raw-data buffers. */
+    packingMs: number;
+    /** Time spent copying command and data buffers from the Wasm heap. */
+    heapCopyMs: number;
+    /** Time spent creating Babylon.js objects. */
+    materializeMs: number;
+}
+/**
+ * Statistics reported for an imported USD stage.
+ */
+export interface USDImportStatistics {
+    /** Number of transform nodes extracted from the composed stage. */
+    nodes: number;
+    /** Number of polygonal `UsdGeomMesh` sources. */
+    meshes: number;
+    /** Number of analytic cube, sphere, cylinder, and cone sources. */
+    analyticPrimitives: number;
+    /** Number of native Babylon instances created from shared USD geometry. */
+    instances: number;
+    /** Number of authored USD materials translated. */
+    materials: number;
+    /** Number of unique vertices in polygonal source meshes. */
+    vertices: number;
+    /** Number of unique triangles in polygonal source meshes. */
+    triangles: number;
+    /** Size of the command buffer in bytes. */
+    commandBytes: number;
+    /** Size of the raw-data buffer in bytes. */
+    dataBytes: number;
+}
+/**
+ * Diagnostics reported after a USD import completes.
+ */
+export interface USDImportDiagnostics {
+    /** Timing data for extraction and Babylon.js object creation. */
+    timings: USDImportTimings;
+    /** Counts and buffer sizes reported by the OpenUSD extractor. */
+    statistics: USDImportStatistics;
+    /** Asset references OpenUSD could not resolve from the supplied virtual files. */
+    missingAssets: readonly string[];
+}

package/USD/usdLoadingOptions.js

@@ -0,0 +1,3 @@
+/* eslint-disable @typescript-eslint/naming-convention */
+export {};
+//# sourceMappingURL=usdLoadingOptions.js.map

package/USD/usdLoadingOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usdLoadingOptions.js","sourceRoot":"","sources":["../../../../dev/loaders/src/USD/usdLoadingOptions.ts"],"names":[],"mappings":"AAAA,yDAAyD","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention */\n\n/**\n * Binary input accepted for supporting USD layers and assets.\n */\nexport type USDBinaryInput = ArrayBuffer | ArrayBufferView;\n\n/**\n * Virtual files supplied alongside the root USD layer, keyed by their path relative to the\n * root layer.\n */\nexport type USDVirtualFiles = Readonly<Record<string, USDBinaryInput>>;\n\n/**\n * Progress phases reported by the USD worker and Babylon materializer.\n */\nexport interface USDLoadProgress {\n    /**\n     * Current importer phase.\n     */\n    phase: \"initializing\" | \"staging\" | \"extracting\" | \"materializing\";\n\n    /**\n     * Human-readable phase description.\n     */\n    message: string;\n}\n\n/**\n * Options for the OpenUSD scene loader.\n */\nexport interface USDFileLoaderOptions {\n    /**\n     * Virtual path used to stage the root layer. Set this when supporting files need\n     * to resolve relative to a directory hierarchy.\n     */\n    rootFileName?: string;\n\n    /**\n     * Supporting layers, payloads, and textures keyed by virtual path in the same\n     * virtual file system as `rootFileName`.\n     */\n    files?: USDVirtualFiles;\n\n    /**\n     * Enables conservative file-name fallback for unresolved absolute references.\n     * Defaults to true.\n     */\n    resolveByFileName?: boolean;\n\n    /**\n     * URL of the module worker. Defaults to the protocol-versioned worker hosted on the Babylon.js CDN.\n     */\n    workerUrl?: string | URL;\n\n    /**\n     * URL of the generated Emscripten JavaScript module.\n     */\n    glueUrl?: string;\n\n    /**\n     * URL of the OpenUSD WebAssembly binary.\n     */\n    wasmUrl?: string;\n\n    /**\n     * URL of the OpenUSD preloaded resource bundle.\n     */\n    dataUrl?: string;\n\n    /**\n     * Called when the importer moves to a new processing phase.\n     */\n    onProgress?: (progress: USDLoadProgress) => void;\n\n    /**\n     * Called for OpenUSD diagnostic messages.\n     */\n    onLog?: (level: \"info\" | \"warning\" | \"error\", message: string) => void;\n\n    /**\n     * Called after extraction and Babylon.js object creation complete.\n     */\n    onComplete?: (diagnostics: USDImportDiagnostics) => void;\n}\n\n/**\n * Timing data measured by the OpenUSD worker and Babylon materializer.\n */\nexport interface USDImportTimings {\n    /** Total extraction time, including the final Wasm heap copy. */\n    totalMs: number;\n    /** Time spent opening and composing the USD stage. */\n    stageOpenMs: number;\n    /** Time spent traversing the composed stage. */\n    stageReadMs: number;\n    /** Time spent preparing renderable vertex streams. */\n    preparationMs: number;\n    /** Time spent packing the command and raw-data buffers. */\n    packingMs: number;\n    /** Time spent copying command and data buffers from the Wasm heap. */\n    heapCopyMs: number;\n    /** Time spent creating Babylon.js objects. */\n    materializeMs: number;\n}\n\n/**\n * Statistics reported for an imported USD stage.\n */\nexport interface USDImportStatistics {\n    /** Number of transform nodes extracted from the composed stage. */\n    nodes: number;\n    /** Number of polygonal `UsdGeomMesh` sources. */\n    meshes: number;\n    /** Number of analytic cube, sphere, cylinder, and cone sources. */\n    analyticPrimitives: number;\n    /** Number of native Babylon instances created from shared USD geometry. */\n    instances: number;\n    /** Number of authored USD materials translated. */\n    materials: number;\n    /** Number of unique vertices in polygonal source meshes. */\n    vertices: number;\n    /** Number of unique triangles in polygonal source meshes. */\n    triangles: number;\n    /** Size of the command buffer in bytes. */\n    commandBytes: number;\n    /** Size of the raw-data buffer in bytes. */\n    dataBytes: number;\n}\n\n/**\n * Diagnostics reported after a USD import completes.\n */\nexport interface USDImportDiagnostics {\n    /** Timing data for extraction and Babylon.js object creation. */\n    timings: USDImportTimings;\n    /** Counts and buffer sizes reported by the OpenUSD extractor. */\n    statistics: USDImportStatistics;\n    /** Asset references OpenUSD could not resolve from the supplied virtual files. */\n    missingAssets: readonly string[];\n}\n"]}

package/USD/usdSceneMaterializer.d.ts

@@ -0,0 +1,9 @@
+import { AbstractAssetContainer } from "@onerjs/core/assetContainer.js";
+import { type Scene } from "@onerjs/core/scene.pure.js";
+export interface MaterializationResult {
+    container: AbstractAssetContainer & {
+        dispose(): void;
+    };
+    materializeMs: number;
+}
+export declare function materializeCommandBuffers(scene: Scene, commandBuffer: ArrayBuffer, dataBuffer: ArrayBuffer, addToScene: boolean, signal?: AbortSignal): Promise<MaterializationResult>;