@openusd-wasm/three-loader 0.0.2 → 0.0.4

package/README.md

@@ -74,6 +74,18 @@ When the entry layer references a known asset root, such as `resource/` or
 pass `files` to `parseAsync` for explicit virtual filesystem entries, or set
 `autoResolveAssets: false` to disable this behavior.
 
+When generating USDA files that reference assets written next to the layer, use
+`toLayerRelativeAssetPath` before authoring the reference. OpenUSD treats
+`@assets/model.usdz@` as a search-path asset, while `@./assets/model.usdz@`
+is anchored to the current layer directory and packages without transient
+`0/model.usdz` remap warnings.
+
+```ts
+import { toLayerRelativeAssetPath } from '@openusd-wasm/utils'
+
+refs.AddReference(toLayerRelativeAssetPath('assets/gearbox.usdz'), '')
+```
+
 ## Textures
 
 USD asset paths do not always map directly to browser URLs. The loader creates

package/dist/openusd_three_loader.d.ts

@@ -1,6 +1,7 @@
 import { Pxr } from "@openusd-wasm/pxr";
 import * as THREE from "three";
 import { Loader, LoadingManager } from "three";
+import { USDAssetValue, USDTextureResolver as USDTextureResolver$1, USDTextureResolverContext as USDTextureResolverContext$1 } from "@openusd-wasm/utils";
 
 //#region src/types.d.ts
 type USDSourceInput = string | ArrayBuffer | ArrayBufferView | Blob;
@@ -13,9 +14,9 @@ interface USDStageInfo {
   rootLayerIdentifier: string;
   defaultPrim: string | null;
   upAxis: string;
-  startTimeCode?: number | null;
-  endTimeCode?: number | null;
-  timeCodesPerSecond?: number;
+  startTimeCode: number;
+  endTimeCode: number;
+  timeCodesPerSecond: number;
 }
 interface USDViewPrim {
   path: string;
@@ -110,17 +111,8 @@ interface ExtractUSDModelDataOptions {
   sourcePath?: string;
   rootLayerIdentifier?: string;
 }
-interface USDTextureResolverContext {
-  sourcePath: string;
-  material?: USDMaterialInfo;
-  shader?: USDShaderInfo;
-}
-interface USDAssetValue {
-  path?: string;
-  resolvedPath?: string;
-  url?: string;
-}
-type USDTextureResolver = (asset: USDAssetValue, context: USDTextureResolverContext) => string | null | undefined;
+type USDTextureResolverContext = USDTextureResolverContext$1<USDMaterialInfo, USDShaderInfo>;
+type USDTextureResolver = USDTextureResolver$1<USDMaterialInfo, USDShaderInfo>;
 interface BuildUSDObjectOptions {
   sourcePath?: string;
   convertZUp?: boolean;
@@ -233,18 +225,6 @@ declare class USDManipulationControls {
   private restoreHighlight;
 }
 //#endregion
-//#region src/asset-resolver.d.ts
-declare function autoResolveAssetFiles(rootData: Uint8Array, options: USDLoaderParseOptions): Promise<Record<string, Uint8Array>>;
-declare function autoResolveTextureFiles(metadata: USDModelData, existingFiles: Record<string, Uint8Array>, options: USDLoaderParseOptions): Promise<Record<string, Uint8Array>>;
-declare function createTextureResolverFromEntries(entries: Map<string, Uint8Array>): {
-  resolve: USDTextureResolver;
-  urls: Map<string, string>;
-} | null;
-declare function createPackageTextureResolver(data: Uint8Array): {
-  resolve: USDTextureResolver;
-  urls: Map<string, string>;
-} | null;
-//#endregion
 //#region src/metadata.d.ts
 declare function extractUSDModelData(pxr: Pxr, stage: PxrObject, options?: ExtractUSDModelDataOptions): USDModelData;
 //#endregion
@@ -252,4 +232,4 @@ declare function extractUSDModelData(pxr: Pxr, stage: PxrObject, options?: Extra
 declare function buildUSDObject(data: USDModelData, options?: BuildUSDObjectOptions): THREE.Group;
 declare function createUSDLoadedModel(data: USDModelData, pxr: USDLoadedModel['pxr'], rootLayerIdentifier: string, options?: BuildUSDObjectOptions, stage?: unknown): USDLoadedModel;
 //#endregion
-export { type BuildUSDObjectOptions, type ExtractUSDModelDataOptions, type PxrObject, type USDAnimationInfo, type USDAssetValue, type USDFileExtension, type USDJointDriveInfo, type USDJointInfo, type USDLoadedModel, USDLoader, type USDLoaderOptions, type USDLoaderParseOptions, type USDManipulationChangeEvent, USDManipulationControls, type USDManipulationControlsOptions, type USDManipulationHoverEvent, type USDMaterialInfo, type USDMeshElement, type USDMeshGeometryData, type USDModelData, type USDShaderInfo, type USDSourceInput, type USDStageInfo, type USDTextureResolver, type USDTextureResolverContext, type USDTransformAnimation, type USDTransformAnimationSample, type USDVector2, type USDVector3, type USDVector4, type USDViewPrim, autoResolveAssetFiles, autoResolveTextureFiles, buildUSDObject, createPackageTextureResolver, createTextureResolverFromEntries, createUSDLoadedModel, extractUSDModelData };
+export { type BuildUSDObjectOptions, type ExtractUSDModelDataOptions, type PxrObject, type USDAnimationInfo, type USDAssetValue, type USDFileExtension, type USDJointDriveInfo, type USDJointInfo, type USDLoadedModel, USDLoader, type USDLoaderOptions, type USDLoaderParseOptions, type USDManipulationChangeEvent, USDManipulationControls, type USDManipulationControlsOptions, type USDManipulationHoverEvent, type USDMaterialInfo, type USDMeshElement, type USDMeshGeometryData, type USDModelData, type USDShaderInfo, type USDSourceInput, type USDStageInfo, type USDTextureResolver, type USDTextureResolverContext, type USDTransformAnimation, type USDTransformAnimationSample, type USDVector2, type USDVector3, type USDVector4, type USDViewPrim, buildUSDObject, createUSDLoadedModel, extractUSDModelData };