@openusd-wasm/three-loader 0.0.1 → 0.0.3

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;