three-usd-robot 0.9.0 → 0.10.0

package/README.md

@@ -23,10 +23,13 @@ exported back to `.usda` / `.usdz` in the browser.
   instanceable prims are composed for you.
 - **Robots** — links, joints (fixed / revolute / continuous / prismatic), limits,
   drives and the initial pose become a `setJointValue`-able hierarchy.
-- **Rendering** — meshes and solid gprims (`Cube` / `Sphere` / `Cylinder` /
-  `Capsule` / `Cone`) with `UsdShade` materials (UsdPreviewSurface / OmniPBR)
-  and textures; up-axis and units normalized automatically. Articulation-free
-  stages load as static scenes.
+- **Rendering** — meshes, solid gprims (`Cube` / `Sphere` / `Cylinder` /
+  `Capsule` / `Cone`), point clouds (`Points`) and curves (`BasisCurves`:
+  linear / bezier / bspline / catmullRom, periodic wrap, and an opt-in
+  `curveTubes` mode that turns authored widths into tube meshes) with
+  `UsdShade` materials (UsdPreviewSurface / OmniPBR) and textures; up-axis
+  and units normalized automatically. Articulation-free stages load as
+  static scenes.
 - **Animation** — plays back time-sampled joint trajectories.
 - **Export** — write robots and whole cells back to `.usda` / `.usdz`,
   simulation-ready for Isaac Sim.
@@ -50,8 +53,15 @@ The CDN is public and CORS-enabled, so this works in the browser too. Try
 FK check, and a re-export to one self-contained file), or open the Vite example
 and pick a robot from the preset list.
 
-Not yet supported: time samples stored inside binary crate files, point/curve
-gprims (`Points`, `BasisCurves`, …), and full material/shader fidelity.
+Materials target **UsdPreviewSurface fidelity plus an OmniPBR mapping**:
+constant and textured inputs, faceVarying / indexed UVs, multiple UV sets,
+per-vertex display colors, physical extensions (`ior` / `clearcoat` /
+specular workflow → `MeshPhysicalMaterial`), packed ORM maps,
+`sourceColorSpace`, and purpose/strength-aware bindings. Executing MDL or
+MaterialX shader graphs is out of scope. Not yet supported:
+collection-based material bindings, and the exotic curve schemas
+(`NurbsCurves`, `HermiteCurves`, `NurbsPatch`) which load with a warning and
+are skipped.
 
 ## Install
 

package/dist/{ThreeUsdRobot-BAh-48DD.d.ts → ThreeUsdRobot-B7Z4oORO.d.ts}

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { J as JointType, A as Axis, a as JointDescription, L as LinkDescription, R as RobotDescription, K as KinematicTree, S as Stage } from './buildKinematicTree-DQ4Vr4sJ.js';
+import { J as JointType, A as Axis, a as JointDescription, L as LinkDescription, R as RobotDescription, K as KinematicTree, S as Stage } from './buildKinematicTree-BCySuZZn.js';
 
 /**
  * The articulated "motion" node of a joint, inserted between the joint's two

package/dist/{ThreeUsdRobotLoader-DYtvelif.d.ts → ThreeUsdRobotLoader-NdFAVN96.d.ts}

@@ -1,6 +1,6 @@
-import { R as RobotDescription } from './buildKinematicTree-DQ4Vr4sJ.js';
+import { R as RobotDescription } from './buildKinematicTree-BCySuZZn.js';
 import { A as AssetResolver, U as UsdSource, B as BinarySource } from './bytes-MOJ2oN-u.js';
-import { W as WorldUpAxis, T as ThreeUsdRobot } from './ThreeUsdRobot-BAh-48DD.js';
+import { W as WorldUpAxis, T as ThreeUsdRobot } from './ThreeUsdRobot-B7Z4oORO.js';
 
 type ThreeUsdRobotLoaderOptions = {
     /** Resolver for references / payloads / sublayers (default {@link DefaultAssetResolver}). */
@@ -18,6 +18,11 @@ type ThreeUsdRobotLoaderOptions = {
     loadSceneGeometry?: boolean;
     /** Load diffuse textures referenced by materials (default `true`). */
     loadTextures?: boolean;
+    /**
+     * Render `BasisCurves` that author `widths` as tube meshes instead of
+     * 1-px lines (default `false`, M18).
+     */
+    curveTubes?: boolean;
     /**
      * Target world up-axis. Any stage (Y-up or Z-up) is normalized into this
      * convention: `"Y"` for a standard three.js scene (the default behavior),
@@ -82,6 +87,8 @@ declare class ThreeUsdRobotLoader {
     private openSource;
     private openUsdzStage;
     private buildFromStage;
+    /** Surface recognized-but-unrenderable gprim schemas instead of silence (M18). */
+    private warnUnsupportedGprims;
     private composeStage;
     /** Compose a layer from raw bytes, sniffing binary crate vs USDA text. */
     private composeStageFromBytes;

package/dist/{buildKinematicTree-DQ4Vr4sJ.d.ts → buildKinematicTree-BCySuZZn.d.ts}

@@ -364,6 +364,8 @@ declare class Attribute {
     Get(time?: number): UsdValue | undefined;
     GetTimeSamples(): Map<number, UsdValue>;
     GetConnections(): SdfPath[];
+    /** Authored attribute metadata (`interpolation`, `elementSize`, …). */
+    GetMetadata(key: string): UsdValue | undefined;
 }
 /** A relationship on a prim (`UsdRelationship`-like). */
 declare class Relationship {
@@ -378,6 +380,8 @@ declare class Relationship {
     GetNamespace(): string;
     IsCustom(): boolean;
     GetTargets(): SdfPath[];
+    /** Authored relationship metadata (`bindMaterialAs`, …). */
+    GetMetadata(key: string): UsdValue | undefined;
 }
 
 /**