@loaders.gl/scene 5.0.0-alpha.9 → 5.0.0-beta.10

package/dist/usd/lib/usd-types.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/usd/lib/usd-types.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n// loaders.gl\n\nimport type {LoaderOptions} from '@loaders.gl/core/loader-utils';\n\n/** Reference to an external OpenUSD layer and optional prim within that layer. */\nexport type USDAssetPath = {\n  /** URL or relative path to the referenced layer. */\n  assetPath: string;\n  /** Optional prim path within the referenced layer. */\n  primPath?: string;\n};\n\n/** Reference to a prim in an OpenUSD scene. */\nexport type USDScenePath = {\n  /** Absolute or relative scene path. */\n  path: string;\n};\n\n/** Value types represented by the OpenUSD ASCII parser. */\nexport type USDValue =\n  | string\n  | number\n  | boolean\n  | null\n  | USDAssetPath\n  | USDScenePath\n  | USDValue[]\n  | {[name: string]: USDValue};\n\n/** Parsed OpenUSD attribute declaration. */\nexport type USDAttribute = {\n  /** URL of the layer that authored this attribute, retained through composition. */\n  sourceUrl?: string;\n  /** Attribute name. */\n  name: string;\n  /** Authored OpenUSD type name. */\n  type: string;\n  /** Parsed attribute value. */\n  value: USDValue;\n  /** Attribute metadata. */\n  metadata: Record<string, USDValue>;\n};\n\n/** Opinions authored by one variant. */\nexport type USDVariant = {\n  /** Variant attributes. */\n  attributes: Record<string, USDAttribute>;\n  /** Variant metadata. */\n  metadata: Record<string, USDValue>;\n  /** Child prims introduced or overridden by the variant. */\n  children: USDPrim[];\n};\n\n/** Parsed and optionally composed OpenUSD prim. */\nexport type USDPrim = {\n  /** Prim name. */\n  name: string;\n  /** Absolute prim path. */\n  path: string;\n  /** URL of the layer that authored the prim. */\n  sourceUrl?: string;\n  /** Authored prim type, such as `Xform` or `Mesh`. */\n  type: string;\n  /** Prim specifier. */\n  specifier: 'def' | 'over' | 'class';\n  /** Authored attributes keyed by name. */\n  attributes: Record<string, USDAttribute>;\n  /** Prim metadata keyed by name. */\n  metadata: Record<string, USDValue>;\n  /** Variant sets keyed by set name and variant name. */\n  variants: Record<string, Record<string, USDVariant>>;\n  /** Child prims. */\n  children: USDPrim[];\n};\n\n/** Encoded file extracted from a USDZ package, without image decoding or renderer objects. */\nexport type USDEmbeddedAsset = {\n  /** Original archive-relative filename, including its directories. */\n  readonly path: string;\n  /** Exact stored bytes, owned by the returned stage rather than the input archive. */\n  readonly data: ArrayBuffer;\n  /** MIME type hint inferred from a PNG or JPEG filename; other formats omit this field. */\n  readonly mimeType?: string;\n};\n\n/** Parsed OpenUSD stage. */\nexport type USDStage = {\n  /** Container format used for the root layer. */\n  format: 'usda' | 'usdc' | 'usdz';\n  /** URL of the root layer when available. */\n  url?: string;\n  /** Root-layer metadata. */\n  metadata: Record<string, USDValue>;\n  /** Root prims in scene order. */\n  rootPrims: USDPrim[];\n  /** URLs of all layers used to compose the stage. */\n  layers: string[];\n  /** USDZ files keyed by resolved package URL; absent for standalone layers. Includes layers and textures. */\n  assets?: Record<string, USDEmbeddedAsset>;\n};\n\n/** Options for {@link USDLoader}. */\nexport type USDLoaderOptions = LoaderOptions & {\n  /** OpenUSD-specific parser and composition options. */\n  usd?: {\n    /** Compose references and variants into the returned prim hierarchy. */\n    compose?: boolean;\n    /** Load referenced layers while composing the stage. */\n    loadReferences?: boolean;\n    /** Maximum recursive composition depth. */\n    maxReferenceDepth?: number;\n    /** Variant selections that override authored selections. */\n    variantSelections?: Record<string, string>;\n  };\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/{lib → usd/lib}/usd-types.d.ts

@@ -1,4 +1,4 @@
-import type { LoaderOptions } from '@loaders.gl/loader-utils';
+import type { LoaderOptions } from '@loaders.gl/core/loader-utils';
 /** Reference to an external OpenUSD layer and optional prim within that layer. */
 export type USDAssetPath = {
     /** URL or relative path to the referenced layer. */
@@ -17,6 +17,8 @@ export type USDValue = string | number | boolean | null | USDAssetPath | USDScen
 };
 /** Parsed OpenUSD attribute declaration. */
 export type USDAttribute = {
+    /** URL of the layer that authored this attribute, retained through composition. */
+    sourceUrl?: string;
     /** Attribute name. */
     name: string;
     /** Authored OpenUSD type name. */
@@ -56,10 +58,19 @@ export type USDPrim = {
     /** Child prims. */
     children: USDPrim[];
 };
+/** Encoded file extracted from a USDZ package, without image decoding or renderer objects. */
+export type USDEmbeddedAsset = {
+    /** Original archive-relative filename, including its directories. */
+    readonly path: string;
+    /** Exact stored bytes, owned by the returned stage rather than the input archive. */
+    readonly data: ArrayBuffer;
+    /** MIME type hint inferred from a PNG or JPEG filename; other formats omit this field. */
+    readonly mimeType?: string;
+};
 /** Parsed OpenUSD stage. */
 export type USDStage = {
     /** Container format used for the root layer. */
-    format: 'usda' | 'usdz';
+    format: 'usda' | 'usdc' | 'usdz';
     /** URL of the root layer when available. */
     url?: string;
     /** Root-layer metadata. */
@@ -68,6 +79,8 @@ export type USDStage = {
     rootPrims: USDPrim[];
     /** URLs of all layers used to compose the stage. */
     layers: string[];
+    /** USDZ files keyed by resolved package URL; absent for standalone layers. Includes layers and textures. */
+    assets?: Record<string, USDEmbeddedAsset>;
 };
 /** Options for {@link USDLoader}. */
 export type USDLoaderOptions = LoaderOptions & {

package/dist/usd/lib/usd-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usd-types.d.ts","sourceRoot":"","sources":["../../../src/usd/lib/usd-types.ts"],"names":[],"mappings":"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"}

package/dist/{lib → usd/lib}/usd-types.js

@@ -1,5 +1,5 @@
-// loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
+// loaders.gl
 export {};
 //# sourceMappingURL=usd-types.js.map

package/dist/usd/lib/usd-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usd-types.js","sourceRoot":"","sources":["../../../src/usd/lib/usd-types.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,oCAAoC;AACpC,aAAa"}

package/dist/usd/libs/README.md

@@ -0,0 +1,27 @@
+# USDC decoder source
+
+`usdc-parser.js` is adapted from THREE.js r187, commit/tag r187:
+https://github.com/mrdoob/three.js/blob/r187/examples/jsm/loaders/usd/USDCParser.js
+
+Copyright © 2010–2026 three.js authors; MIT terms are in THREE-LICENSE.
+This renderer-free source has no imports or package dependencies. It remains
+vendored JavaScript; the adjacent declaration and handwritten parse-usdc.ts
+adapter define the checked TypeScript boundary. Existing libs build/coverage
+policy applies to this vendored decoder; adapter code remains fully instrumented.
+
+Local changes bound aggregate allocations, integer precision and seek offsets,
+support bounded dictionary values and reject unsupported list operations/encoding cases, validate LZ4
+copies, use null-prototype dictionaries and correct signed inline integers.
+The adapter restricts crate versions, validates section bounds, and converts the
+supported specifications into USDStage. Broader upstream behavior is not promised.
+
+Dictionary decoding uses string-table keys and forward offsets to complete value
+representations, retaining false, empty strings, empty dictionaries and asset paths.
+It rejects duplicate/invalid keys, cycles, nesting beyond 64, and unsupported
+complex dictionary value types. These checks extend the r187 source while
+preserving its MIT attribution; no THREE runtime is imported.
+
+The authored-value extension decodes inline half and signed/unsigned 64-bit scalars,
+string arrays, and compressed half/double arrays. Dictionary array support is an
+explicit allowlist; unsupported representations fail before payload decoding.
+Half integer compression uses ties-to-even rounding, and lookup indices are checked.

package/dist/usd/libs/THREE-LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright © 2010-2026 three.js authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/usd/libs/usdc-parser.d.ts

@@ -0,0 +1,78 @@
+export class USDCParser {
+    /**
+     * Parse USDC file and return raw spec data without building Three.js scene.
+     * Used by USDComposer for unified scene composition.
+     */
+    parseData(buffer: any): {
+        specsByPath: any;
+    };
+    _valueReadCount: any;
+    _activeDictionaries: Set<any> | undefined;
+    buffer: any;
+    reader: BinaryReader | undefined;
+    version: {
+        major: number;
+        minor: number;
+        patch: number;
+    } | undefined;
+    _conversionBuffer: ArrayBuffer | undefined;
+    _conversionView: DataView<ArrayBuffer> | undefined;
+    specsByPath: any;
+    _readBootstrap(): void;
+    tocOffset: number | undefined;
+    _readTOC(): void;
+    sections: any;
+    _readTokens(): void;
+    tokens: any[] | undefined;
+    _readStrings(): void;
+    strings: any[] | undefined;
+    _readFields(): void;
+    fields: any[] | undefined;
+    _readFieldSets(): void;
+    fieldSets: any[] | undefined;
+    _readPaths(): void;
+    paths: any[] | undefined;
+    _readPathsRecursive(parentPath: any, depth?: number): void;
+    /** Rebuilds compressed paths with an explicit stack instead of sibling recursion. */
+    _buildPathsFromCompressed(pathIndices: any, elementTokenIndices: any, jumps: any): void;
+    _readSpecs(): void;
+    specs: any[] | undefined;
+    _readValue(valueRep: any): any;
+    _readInlinedValue(valueRep: any): any;
+    _readTimeSamples(valueRep: any): {
+        times: any;
+        values: any[];
+    };
+    _readScalarValue(type: any): any;
+    /** Reads bounded string-keyed dictionary entries and their recursive value representations. */
+    _readDictionary(): any;
+    _readArrayValue(valueRep: any): string[] | Int32Array<any> | Uint32Array<any> | Float32Array<any> | Float64Array<any>;
+    _readCompressedArray(type: any, size: any): Int32Array<any> | Uint32Array<any> | Float32Array<any> | Float64Array<any>;
+    /** Rounds integer-compressed half samples using IEEE ties-to-even semantics. */
+    _convertHalfInteger(value: any): any;
+    _readHalf(): number;
+    _halfToFloat(h: any): number;
+    _getFieldsForSpec(spec: any): any;
+}
+declare class BinaryReader {
+    constructor(buffer: any);
+    buffer: any;
+    view: DataView<any>;
+    offset: number;
+    seek(offset: any): void;
+    tell(): number;
+    readUint8(): number;
+    readInt8(): number;
+    readUint16(): number;
+    readInt16(): number;
+    readUint32(): number;
+    readInt32(): number;
+    readUint64(): number;
+    readInt64(): number;
+    readFloat32(): number;
+    readFloat64(): number;
+    readBytes(length: any): Uint8Array<any>;
+    readString(length: any): string;
+}
+export {};
+//# sourceMappingURL=usdc-parser.d.ts.map

package/dist/usd/libs/usdc-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usdc-parser.d.ts","sourceRoot":"","sources":["../../../src/usd/libs/usdc-parser.js"],"names":[],"mappings":"AAmdA;IACE;;;OAGG;IACH;;MAiCC;IA/BC,qBAAwB;IACxB,0CAAoC;IAEpC,YAAoE;IACpE,iCAA2C;IAC3C;;;;kBAA6C;IAE7C,2CAA2C;IAC3C,mDAA2D;IAY3D,iBAAsC;IAaxC,uBAqBC;IAJC,8BAAoC;IAMtC,iBAgBC;IATC,cAAmC;IAWrC,oBA2CC;IAnCC,0BAAgB;IAqClB,qBAgBC;IAbG,2BAAiB;IAerB,oBAsDC;IA/CC,0BAAgB;IAiDlB,uBA+BC;IAxBC,6BAAmB;IA0BrB,mBAmDC;IA3CC,yBAAwD;IA6C1D,2DA+CC;IAED,qFAAqF;IACrF,wFAkDC;IAED,mBAmEC;IA5DC,yBAAe;IAkEjB,+BA2CC;IAED,sCAuGC;IAED;;;MA2DC;IAED,iCAsMC;IAED,+FAA+F;IAC/F,uBAyCC;IAED,sHA8HC;IAED,uHAmFC;IAED,gFAAgF;IAChF,qCAaC;IAED,oBAEC;IAED,6BAkBC;IAED,kCA6BC;CACF;AA5zCD;IACE,yBAIC;IAHC,YAAoB;IACpB,oBAAgC;IAChC,eAAe;IAGjB,wBAIC;IAED,eAEC;IAED,oBAIC;IAED,mBAIC;IAED,qBAIC;IAED,oBAIC;IAED,qBAIC;IAED,oBAIC;IAED,qBAQC;IAED,oBAOC;IAED,sBAIC;IAED,sBAIC;IAED,wCAIC;IAED,gCAKC;CACF"}