three-usd-robot 0.11.0 → 0.13.0

package/dist/helpers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/helpers/appearance.ts","../src/helpers/JointAxisHelper.ts","../src/helpers/JointLimitHelper.ts","../src/helpers/LinkFrameHelper.ts","../src/helpers/attach.ts"],"names":["THREE","THREE2","lo","hi","THREE4"],"mappings":"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","file":"helpers.js","sourcesContent":["/**\n * Per-link appearance helpers: highlight (tint), material replacement, and\n * translucent \"ghost\" clones for pose previews.\n *\n * Material overrides are reversible — the original materials are kept aside on\n * first override and put back exactly by {@link restoreLinkMaterials} /\n * {@link restoreAllLinkMaterials}. Links are addressed like everywhere else:\n * by key or by full prim path.\n */\n\nimport * as THREE from \"three\";\nimport { ThreeUsdRobot } from \"../three/ThreeUsdRobot.js\";\n\n/** Which meshes of a link an operation affects. */\nexport type LinkMeshKind = \"visual\" | \"collision\" | \"all\";\n\n/** Originals saved on first override (per mesh; first save wins until restore). */\nconst savedMaterials = new WeakMap<THREE.Mesh, THREE.Material | THREE.Material[]>();\n\n/** Marks materials created by {@link highlightLink}, so restore can dispose them. */\nconst HIGHLIGHT_FLAG = \"__threeUsdRobotHighlight\";\n\n/**\n * The meshes belonging to exactly this link — not those of child links, which\n * live under their own `LinkObject` deeper in the kinematic chain. Helpers and\n * joint-frame groups are excluded.\n */\nexport function getLinkMeshes(\n  robot: ThreeUsdRobot,\n  link: string,\n  kind: LinkMeshKind = \"all\",\n): THREE.Mesh[] {\n  const obj = robot.getLinkObject(link);\n  if (!obj) return [];\n  const out: THREE.Mesh[] = [];\n  for (const child of obj.children) {\n    const mesh = child as THREE.Mesh;\n    if (!mesh.isMesh) continue;\n    const k = (mesh.userData as { kind?: string }).kind;\n    if (k !== \"visual\" && k !== \"collision\") continue;\n    if (kind !== \"all\" && k !== kind) continue;\n    out.push(mesh);\n  }\n  return out;\n}\n\nexport type HighlightLinkOptions = {\n  /** Highlight color (default red `0xff4444`). */\n  color?: THREE.ColorRepresentation;\n  /** Emissive strength of the tint (default `0.8`). */\n  emissiveIntensity?: number;\n  /** Force translucency while highlighted (e.g. `0.5`); default keeps the material's own. */\n  opacity?: number;\n  /** Which meshes of the link to affect (default `\"visual\"`). */\n  kind?: LinkMeshKind;\n};\n\n/**\n * Tint a link's meshes (emissive red by default) while keeping their maps and\n * base colors — e.g. to flag a colliding link. Repeated calls re-tint from the\n * *original* materials, so highlights don't stack; restore with\n * {@link restoreLinkMaterials}. Returns `false` when the link has no matching\n * meshes.\n */\nexport function highlightLink(\n  robot: ThreeUsdRobot,\n  link: string,\n  options: HighlightLinkOptions = {},\n): boolean {\n  const meshes = getLinkMeshes(robot, link, options.kind ?? \"visual\");\n  if (meshes.length === 0) return false;\n\n  const color = new THREE.Color(options.color ?? 0xff4444);\n  for (const mesh of meshes) {\n    if (!savedMaterials.has(mesh)) savedMaterials.set(mesh, mesh.material);\n    const base = savedMaterials.get(mesh)!;\n    disposeHighlightClones(mesh.material);\n    mesh.material = Array.isArray(base)\n      ? base.map((m) => tintClone(m, color, options))\n      : tintClone(base, color, options);\n  }\n  return true;\n}\n\nfunction tintClone(\n  base: THREE.Material,\n  color: THREE.Color,\n  options: HighlightLinkOptions,\n): THREE.Material {\n  const m = base.clone();\n  m.userData[HIGHLIGHT_FLAG] = true;\n  const std = m as THREE.MeshStandardMaterial;\n  if (std.isMeshStandardMaterial) {\n    std.emissive.copy(color);\n    std.emissiveIntensity = options.emissiveIntensity ?? 0.8;\n  } else if (\"color\" in m) {\n    (m as THREE.MeshBasicMaterial).color.copy(color);\n  }\n  if (options.opacity !== undefined) {\n    m.transparent = options.opacity < 1;\n    m.opacity = options.opacity;\n  }\n  return m;\n}\n\n/**\n * Replace a link's mesh materials with `material` (one shared instance). The\n * caller keeps ownership — it is never disposed here. Restore the originals\n * with {@link restoreLinkMaterials}. Returns `false` when the link has no\n * matching meshes.\n */\nexport function setLinkMaterial(\n  robot: ThreeUsdRobot,\n  link: string,\n  material: THREE.Material,\n  kind: LinkMeshKind = \"visual\",\n): boolean {\n  const meshes = getLinkMeshes(robot, link, kind);\n  if (meshes.length === 0) return false;\n  for (const mesh of meshes) {\n    if (!savedMaterials.has(mesh)) savedMaterials.set(mesh, mesh.material);\n    disposeHighlightClones(mesh.material);\n    mesh.material = material;\n  }\n  return true;\n}\n\n/** Put back a link's original materials (no-op for untouched meshes). */\nexport function restoreLinkMaterials(robot: ThreeUsdRobot, link: string): void {\n  for (const mesh of getLinkMeshes(robot, link, \"all\")) {\n    const original = savedMaterials.get(mesh);\n    if (original === undefined) continue;\n    disposeHighlightClones(mesh.material);\n    mesh.material = original;\n    savedMaterials.delete(mesh);\n  }\n}\n\n/** Put back the original materials of every link of the robot. */\nexport function restoreAllLinkMaterials(robot: ThreeUsdRobot): void {\n  for (const name of robot.getLinkNames()) restoreLinkMaterials(robot, name);\n}\n\n/** Dispose materials created by {@link highlightLink} (never user-supplied ones). */\nfunction disposeHighlightClones(current: THREE.Material | THREE.Material[]): void {\n  for (const m of Array.isArray(current) ? current : [current]) {\n    if (m.userData[HIGHLIGHT_FLAG]) m.dispose();\n  }\n}\n\nexport type GhostRobotOptions = {\n  /** Ghost tint (default `0x66aaff`). */\n  color?: THREE.ColorRepresentation;\n  /** Ghost opacity (default `0.35`). */\n  opacity?: number;\n  /** Complete material override; `color` / `opacity` are ignored when given. */\n  material?: THREE.Material;\n  /** Which meshes to clone (default `\"visual\"`). */\n  kind?: \"visual\" | \"collision\";\n  /** Joint overrides applied on top of the source robot's current pose. */\n  jointValues?: Record<string, number>;\n};\n\n/**\n * Build a translucent clone of the robot for pose previews (target pose,\n * onion-skinning). Geometry is shared with the source; every mesh uses one\n * ghost material and is tagged `userData.kind = \"ghost\"`, so the source's\n * `showVisual` / `showCollision` toggles never affect it. The clone is a full\n * {@link ThreeUsdRobot} — drive it with `setJointValues` — starting from the\n * source's current joint values (plus `jointValues` overrides) and mirroring\n * its root transform. Add it to the same parent/scene as the source.\n */\nexport function createGhostRobot(\n  robot: ThreeUsdRobot,\n  options: GhostRobotOptions = {},\n): ThreeUsdRobot {\n  const ghost = new ThreeUsdRobot(robot.robot, robot.tree, {\n    clampJointLimits: robot.clampJointLimits,\n    applyInitialPose: false,\n    upAxisConversion: \"none\",\n  });\n  ghost.name = `${robot.name}_ghost`;\n  // Mirror the source root exactly (stage normalization + any user transform).\n  ghost.position.copy(robot.position);\n  ghost.quaternion.copy(robot.quaternion);\n  ghost.scale.copy(robot.scale);\n\n  const material =\n    options.material ??\n    new THREE.MeshStandardMaterial({\n      color: options.color ?? 0x66aaff,\n      transparent: true,\n      opacity: options.opacity ?? 0.35,\n      depthWrite: false,\n      metalness: 0,\n      roughness: 1,\n    });\n\n  const kind = options.kind ?? \"visual\";\n  for (const key of robot.getLinkNames()) {\n    const target = ghost.getLinkObject(key);\n    if (!target) continue;\n    for (const src of getLinkMeshes(robot, key, kind)) {\n      const mesh = new THREE.Mesh(src.geometry, material);\n      mesh.name = `${src.name}_ghost`;\n      mesh.userData.kind = \"ghost\";\n      mesh.userData.primPath = (src.userData as { primPath?: string }).primPath;\n      mesh.matrixAutoUpdate = false;\n      mesh.matrix.copy(src.matrix);\n      mesh.matrixWorldNeedsUpdate = true;\n      target.add(mesh);\n    }\n  }\n\n  for (const name of robot.getJointNames()) {\n    const value = robot.getJointValue(name);\n    if (value !== undefined) ghost.setJointValue(name, value);\n  }\n  if (options.jointValues) ghost.setJointValues(options.jointValues);\n  return ghost;\n}\n","import * as THREE from \"three\";\nimport type { JointObject } from \"../three/JointObject.js\";\n\n/**\n * An arrow drawn along a joint's motion axis (the rotation axis for\n * revolute/continuous joints, the slide direction for prismatic). Add it to the\n * joint's motion node so it tracks the joint.\n */\nexport class JointAxisHelper extends THREE.ArrowHelper {\n  readonly isJointAxisHelper = true;\n\n  constructor(joint: JointObject, length = 0.2, color: THREE.ColorRepresentation = 0xffd000) {\n    super(joint.axis.clone().normalize(), new THREE.Vector3(0, 0, 0), length, color);\n    this.name = `${joint.jointName}:axis`;\n  }\n}\n","import * as THREE from \"three\";\nimport type { JointObject } from \"../three/JointObject.js\";\n\n/**\n * Visualizes a joint's range of motion: an arc swept between the lower and\n * upper limits (revolute/continuous) or a line segment between them\n * (prismatic). A limitless revolute joint draws a full circle. Add it to the\n * joint's motion node's parent frame (or the joint node) to anchor it.\n */\nexport class JointLimitHelper extends THREE.Line {\n  readonly isJointLimitHelper = true;\n\n  constructor(joint: JointObject, radius = 0.15, color: THREE.ColorRepresentation = 0x00aaff) {\n    super(buildLimitGeometry(joint, radius), new THREE.LineBasicMaterial({ color }));\n    this.name = `${joint.jointName}:limit`;\n  }\n}\n\nfunction buildLimitGeometry(joint: JointObject, radius: number): THREE.BufferGeometry {\n  const axis = joint.axis.clone().normalize();\n\n  if (joint.jointType === \"prismatic\") {\n    const lo = joint.lower ?? -radius;\n    const hi = joint.upper ?? radius;\n    return new THREE.BufferGeometry().setFromPoints([\n      axis.clone().multiplyScalar(lo),\n      axis.clone().multiplyScalar(hi),\n    ]);\n  }\n\n  // Revolute / continuous: sweep an arc in the plane perpendicular to the axis.\n  const lo = joint.lower ?? 0;\n  const hi = joint.upper ?? Math.PI * 2;\n  const { u, v } = perpendicularBasis(axis);\n  const segments = 48;\n  const points: THREE.Vector3[] = [];\n  for (let i = 0; i <= segments; i++) {\n    const t = lo + ((hi - lo) * i) / segments;\n    points.push(\n      u\n        .clone()\n        .multiplyScalar(Math.cos(t) * radius)\n        .addScaledVector(v, Math.sin(t) * radius),\n    );\n  }\n  return new THREE.BufferGeometry().setFromPoints(points);\n}\n\nfunction perpendicularBasis(axis: THREE.Vector3): { u: THREE.Vector3; v: THREE.Vector3 } {\n  const ref = Math.abs(axis.x) < 0.9 ? new THREE.Vector3(1, 0, 0) : new THREE.Vector3(0, 1, 0);\n  const u = new THREE.Vector3().crossVectors(axis, ref).normalize();\n  const v = new THREE.Vector3().crossVectors(axis, u).normalize();\n  return { u, v };\n}\n","import * as THREE from \"three\";\n\n/** A small RGB axes gizmo for a link's local frame. Add it to a `LinkObject`. */\nexport class LinkFrameHelper extends THREE.AxesHelper {\n  readonly isLinkFrameHelper = true;\n\n  constructor(size = 0.2) {\n    super(size);\n    this.name = \"linkFrame\";\n  }\n}\n","import type * as THREE from \"three\";\nimport type { ThreeUsdRobot } from \"../three/ThreeUsdRobot.js\";\nimport { JointAxisHelper } from \"./JointAxisHelper.js\";\nimport { JointLimitHelper } from \"./JointLimitHelper.js\";\nimport { LinkFrameHelper } from \"./LinkFrameHelper.js\";\n\n/** Attach a {@link JointAxisHelper} to every articulated joint. Returns the helpers. */\nexport function addJointAxisHelpers(\n  robot: ThreeUsdRobot,\n  length?: number,\n  color?: THREE.ColorRepresentation,\n): JointAxisHelper[] {\n  const out: JointAxisHelper[] = [];\n  for (const name of robot.getJointNames()) {\n    const joint = robot.getJointObject(name);\n    if (!joint?.articulated) continue;\n    const helper = new JointAxisHelper(joint, length, color);\n    joint.add(helper);\n    out.push(helper);\n  }\n  return out;\n}\n\n/** Attach a {@link JointLimitHelper} to every articulated joint. Returns the helpers. */\nexport function addJointLimitHelpers(\n  robot: ThreeUsdRobot,\n  radius?: number,\n  color?: THREE.ColorRepresentation,\n): JointLimitHelper[] {\n  const out: JointLimitHelper[] = [];\n  for (const name of robot.getJointNames()) {\n    const joint = robot.getJointObject(name);\n    if (!joint?.articulated) continue;\n    const helper = new JointLimitHelper(joint, radius, color);\n    joint.add(helper);\n    out.push(helper);\n  }\n  return out;\n}\n\n/** Attach a {@link LinkFrameHelper} to every link. Returns the helpers. */\nexport function addLinkFrameHelpers(robot: ThreeUsdRobot, size?: number): LinkFrameHelper[] {\n  const out: LinkFrameHelper[] = [];\n  for (const name of robot.getLinkNames()) {\n    const link = robot.getLinkObject(name);\n    if (!link) continue;\n    const helper = new LinkFrameHelper(size);\n    link.add(helper);\n    out.push(helper);\n  }\n  return out;\n}\n"]}
+{"version":3,"sources":["../src/helpers/appearance.ts","../src/helpers/JointAxisHelper.ts","../src/helpers/JointLimitHelper.ts","../src/helpers/LinkFrameHelper.ts","../src/helpers/attach.ts"],"names":["THREE","THREE2","lo","hi","THREE4"],"mappings":"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","file":"helpers.js","sourcesContent":["/**\n * Per-link appearance helpers: highlight (tint), material replacement, and\n * translucent \"ghost\" clones for pose previews.\n *\n * Material overrides are reversible — the original materials are kept aside on\n * first override and put back exactly by {@link restoreLinkMaterials} /\n * {@link restoreAllLinkMaterials}. Links are addressed like everywhere else:\n * by key or by full prim path.\n */\n\nimport * as THREE from \"three\";\nimport { ThreeUsdRobot } from \"../three/ThreeUsdRobot.js\";\n\n/** Which meshes of a link an operation affects. */\nexport type LinkMeshKind = \"visual\" | \"collision\" | \"all\";\n\n/** Originals saved on first override (per mesh; first save wins until restore). */\nconst savedMaterials = new WeakMap<THREE.Mesh, THREE.Material | THREE.Material[]>();\n\n/** Marks materials created by {@link highlightLink}, so restore can dispose them. */\nconst HIGHLIGHT_FLAG = \"__threeUsdRobotHighlight\";\n\n/**\n * The meshes belonging to exactly this link — not those of child links, which\n * live under their own `LinkObject` deeper in the kinematic chain. Helpers and\n * joint-frame groups are excluded.\n */\nexport function getLinkMeshes(\n  robot: ThreeUsdRobot,\n  link: string,\n  kind: LinkMeshKind = \"all\",\n): THREE.Mesh[] {\n  const obj = robot.getLinkObject(link);\n  if (!obj) return [];\n  const out: THREE.Mesh[] = [];\n  for (const child of obj.children) {\n    const mesh = child as THREE.Mesh;\n    if (!mesh.isMesh) continue;\n    const k = (mesh.userData as { kind?: string }).kind;\n    if (k !== \"visual\" && k !== \"collision\") continue;\n    if (kind !== \"all\" && k !== kind) continue;\n    out.push(mesh);\n  }\n  return out;\n}\n\nexport type HighlightLinkOptions = {\n  /** Highlight color (default red `0xff4444`). */\n  color?: THREE.ColorRepresentation;\n  /** Emissive strength of the tint (default `0.8`). */\n  emissiveIntensity?: number;\n  /** Force translucency while highlighted (e.g. `0.5`); default keeps the material's own. */\n  opacity?: number;\n  /** Which meshes of the link to affect (default `\"visual\"`). */\n  kind?: LinkMeshKind;\n};\n\n/**\n * Tint a link's meshes (emissive red by default) while keeping their maps and\n * base colors — e.g. to flag a colliding link. Repeated calls re-tint from the\n * *original* materials, so highlights don't stack; restore with\n * {@link restoreLinkMaterials}. Returns `false` when the link has no matching\n * meshes.\n */\nexport function highlightLink(\n  robot: ThreeUsdRobot,\n  link: string,\n  options: HighlightLinkOptions = {},\n): boolean {\n  const meshes = getLinkMeshes(robot, link, options.kind ?? \"visual\");\n  if (meshes.length === 0) return false;\n\n  const color = new THREE.Color(options.color ?? 0xff4444);\n  for (const mesh of meshes) {\n    if (!savedMaterials.has(mesh)) savedMaterials.set(mesh, mesh.material);\n    const base = savedMaterials.get(mesh)!;\n    disposeHighlightClones(mesh.material);\n    mesh.material = Array.isArray(base)\n      ? base.map((m) => tintClone(m, color, options))\n      : tintClone(base, color, options);\n  }\n  return true;\n}\n\nfunction tintClone(\n  base: THREE.Material,\n  color: THREE.Color,\n  options: HighlightLinkOptions,\n): THREE.Material {\n  const m = base.clone();\n  m.userData[HIGHLIGHT_FLAG] = true;\n  const std = m as THREE.MeshStandardMaterial;\n  if (std.isMeshStandardMaterial) {\n    std.emissive.copy(color);\n    std.emissiveIntensity = options.emissiveIntensity ?? 0.8;\n  } else if (\"color\" in m) {\n    (m as THREE.MeshBasicMaterial).color.copy(color);\n  }\n  if (options.opacity !== undefined) {\n    m.transparent = options.opacity < 1;\n    m.opacity = options.opacity;\n  }\n  return m;\n}\n\n/**\n * Replace a link's mesh materials with `material` (one shared instance). The\n * caller keeps ownership — it is never disposed here. Restore the originals\n * with {@link restoreLinkMaterials}. Returns `false` when the link has no\n * matching meshes.\n */\nexport function setLinkMaterial(\n  robot: ThreeUsdRobot,\n  link: string,\n  material: THREE.Material,\n  kind: LinkMeshKind = \"visual\",\n): boolean {\n  const meshes = getLinkMeshes(robot, link, kind);\n  if (meshes.length === 0) return false;\n  for (const mesh of meshes) {\n    if (!savedMaterials.has(mesh)) savedMaterials.set(mesh, mesh.material);\n    disposeHighlightClones(mesh.material);\n    mesh.material = material;\n  }\n  return true;\n}\n\n/** Put back a link's original materials (no-op for untouched meshes). */\nexport function restoreLinkMaterials(robot: ThreeUsdRobot, link: string): void {\n  for (const mesh of getLinkMeshes(robot, link, \"all\")) {\n    const original = savedMaterials.get(mesh);\n    if (original === undefined) continue;\n    disposeHighlightClones(mesh.material);\n    mesh.material = original;\n    savedMaterials.delete(mesh);\n  }\n}\n\n/** Put back the original materials of every link of the robot. */\nexport function restoreAllLinkMaterials(robot: ThreeUsdRobot): void {\n  for (const name of robot.getLinkNames()) restoreLinkMaterials(robot, name);\n}\n\n/** Dispose materials created by {@link highlightLink} (never user-supplied ones). */\nfunction disposeHighlightClones(current: THREE.Material | THREE.Material[]): void {\n  for (const m of Array.isArray(current) ? current : [current]) {\n    if (m.userData[HIGHLIGHT_FLAG]) m.dispose();\n  }\n}\n\nexport type GhostRobotOptions = {\n  /** Ghost tint (default `0x66aaff`). */\n  color?: THREE.ColorRepresentation;\n  /** Ghost opacity (default `0.35`). */\n  opacity?: number;\n  /** Complete material override; `color` / `opacity` are ignored when given. */\n  material?: THREE.Material;\n  /** Which meshes to clone (default `\"visual\"`). */\n  kind?: \"visual\" | \"collision\";\n  /** Joint overrides applied on top of the source robot's current pose. */\n  jointValues?: Record<string, number>;\n};\n\n/**\n * Build a translucent clone of the robot for pose previews (target pose,\n * onion-skinning). Geometry is shared with the source; every mesh uses one\n * ghost material and is tagged `userData.kind = \"ghost\"`, so the source's\n * `showVisual` / `showCollision` toggles never affect it. The clone is a full\n * {@link ThreeUsdRobot} — drive it with `setJointValues` — starting from the\n * source's current joint values (plus `jointValues` overrides) and mirroring\n * its root transform. Add it to the same parent/scene as the source.\n */\nexport function createGhostRobot(\n  robot: ThreeUsdRobot,\n  options: GhostRobotOptions = {},\n): ThreeUsdRobot {\n  const ghost = new ThreeUsdRobot(robot.robot, robot.tree, {\n    clampJointLimits: robot.clampJointLimits,\n    applyInitialPose: false,\n    upAxisConversion: \"none\",\n  });\n  ghost.name = `${robot.name}_ghost`;\n  // Mirror the source root exactly (stage normalization + any user transform).\n  ghost.position.copy(robot.position);\n  ghost.quaternion.copy(robot.quaternion);\n  ghost.scale.copy(robot.scale);\n\n  const material =\n    options.material ??\n    new THREE.MeshStandardMaterial({\n      color: options.color ?? 0x66aaff,\n      transparent: true,\n      opacity: options.opacity ?? 0.35,\n      depthWrite: false,\n      metalness: 0,\n      roughness: 1,\n    });\n\n  const kind = options.kind ?? \"visual\";\n  for (const key of robot.getLinkNames()) {\n    const target = ghost.getLinkObject(key);\n    if (!target) continue;\n    for (const src of getLinkMeshes(robot, key, kind)) {\n      const mesh = new THREE.Mesh(src.geometry, material);\n      mesh.name = `${src.name}_ghost`;\n      mesh.userData.kind = \"ghost\";\n      mesh.userData.primPath = (src.userData as { primPath?: string }).primPath;\n      mesh.matrixAutoUpdate = false;\n      mesh.matrix.copy(src.matrix);\n      mesh.matrixWorldNeedsUpdate = true;\n      target.add(mesh);\n    }\n  }\n\n  for (const name of robot.getJointNames()) {\n    const value = robot.getJointValue(name);\n    if (value !== undefined) ghost.setJointValue(name, value);\n  }\n  if (options.jointValues) ghost.setJointValues(options.jointValues);\n  return ghost;\n}\n","import * as THREE from \"three\";\nimport type { JointObject } from \"../three/JointObject.js\";\n\n/**\n * An arrow drawn along a joint's motion axis (the rotation axis for\n * revolute/continuous joints, the slide direction for prismatic). Add it to the\n * joint's motion node so it tracks the joint.\n */\nexport class JointAxisHelper extends THREE.ArrowHelper {\n  readonly isJointAxisHelper = true;\n\n  constructor(joint: JointObject, length = 0.2, color: THREE.ColorRepresentation = 0xffd000) {\n    super(joint.axis.clone().normalize(), new THREE.Vector3(0, 0, 0), length, color);\n    this.name = `${joint.jointName}:axis`;\n  }\n}\n","import * as THREE from \"three\";\nimport type { JointObject } from \"../three/JointObject.js\";\n\n/**\n * Visualizes a joint's range of motion: an arc swept between the lower and\n * upper limits (revolute/continuous) or a line segment between them\n * (prismatic). A limitless revolute joint draws a full circle. Add it to the\n * joint's motion node's parent frame (or the joint node) to anchor it.\n */\nexport class JointLimitHelper extends THREE.Line {\n  readonly isJointLimitHelper = true;\n\n  constructor(joint: JointObject, radius = 0.15, color: THREE.ColorRepresentation = 0x00aaff) {\n    super(buildLimitGeometry(joint, radius), new THREE.LineBasicMaterial({ color }));\n    this.name = `${joint.jointName}:limit`;\n  }\n}\n\nfunction buildLimitGeometry(joint: JointObject, radius: number): THREE.BufferGeometry {\n  const axis = joint.axis.clone().normalize();\n\n  if (joint.jointType === \"prismatic\") {\n    const lo = joint.lower ?? -radius;\n    const hi = joint.upper ?? radius;\n    return new THREE.BufferGeometry().setFromPoints([\n      axis.clone().multiplyScalar(lo),\n      axis.clone().multiplyScalar(hi),\n    ]);\n  }\n\n  // Revolute / continuous: sweep an arc in the plane perpendicular to the axis.\n  const lo = joint.lower ?? 0;\n  const hi = joint.upper ?? Math.PI * 2;\n  const { u, v } = perpendicularBasis(axis);\n  const segments = 48;\n  const points: THREE.Vector3[] = [];\n  for (let i = 0; i <= segments; i++) {\n    const t = lo + ((hi - lo) * i) / segments;\n    points.push(\n      u\n        .clone()\n        .multiplyScalar(Math.cos(t) * radius)\n        .addScaledVector(v, Math.sin(t) * radius),\n    );\n  }\n  return new THREE.BufferGeometry().setFromPoints(points);\n}\n\nfunction perpendicularBasis(axis: THREE.Vector3): { u: THREE.Vector3; v: THREE.Vector3 } {\n  const ref = Math.abs(axis.x) < 0.9 ? new THREE.Vector3(1, 0, 0) : new THREE.Vector3(0, 1, 0);\n  const u = new THREE.Vector3().crossVectors(axis, ref).normalize();\n  const v = new THREE.Vector3().crossVectors(axis, u).normalize();\n  return { u, v };\n}\n","import * as THREE from \"three\";\n\n/** A small RGB axes gizmo for a link's local frame. Add it to a `LinkObject`. */\nexport class LinkFrameHelper extends THREE.AxesHelper {\n  readonly isLinkFrameHelper = true;\n\n  constructor(size = 0.2) {\n    super(size);\n    this.name = \"linkFrame\";\n  }\n}\n","import type * as THREE from \"three\";\nimport type { ThreeUsdRobot } from \"../three/ThreeUsdRobot.js\";\nimport { JointAxisHelper } from \"./JointAxisHelper.js\";\nimport { JointLimitHelper } from \"./JointLimitHelper.js\";\nimport { LinkFrameHelper } from \"./LinkFrameHelper.js\";\n\n/** Attach a {@link JointAxisHelper} to every articulated joint. Returns the helpers. */\nexport function addJointAxisHelpers(\n  robot: ThreeUsdRobot,\n  length?: number,\n  color?: THREE.ColorRepresentation,\n): JointAxisHelper[] {\n  const out: JointAxisHelper[] = [];\n  for (const name of robot.getJointNames()) {\n    const joint = robot.getJointObject(name);\n    if (!joint?.articulated) continue;\n    const helper = new JointAxisHelper(joint, length, color);\n    joint.add(helper);\n    out.push(helper);\n  }\n  return out;\n}\n\n/** Attach a {@link JointLimitHelper} to every articulated joint. Returns the helpers. */\nexport function addJointLimitHelpers(\n  robot: ThreeUsdRobot,\n  radius?: number,\n  color?: THREE.ColorRepresentation,\n): JointLimitHelper[] {\n  const out: JointLimitHelper[] = [];\n  for (const name of robot.getJointNames()) {\n    const joint = robot.getJointObject(name);\n    if (!joint?.articulated) continue;\n    const helper = new JointLimitHelper(joint, radius, color);\n    joint.add(helper);\n    out.push(helper);\n  }\n  return out;\n}\n\n/** Attach a {@link LinkFrameHelper} to every link. Returns the helpers. */\nexport function addLinkFrameHelpers(robot: ThreeUsdRobot, size?: number): LinkFrameHelper[] {\n  const out: LinkFrameHelper[] = [];\n  for (const name of robot.getLinkNames()) {\n    const link = robot.getLinkObject(name);\n    if (!link) continue;\n    const helper = new LinkFrameHelper(size);\n    link.add(helper);\n    out.push(helper);\n  }\n  return out;\n}\n"]}

package/dist/index.d.ts

@@ -1,269 +1,18 @@
-import { MdlModuleProvider, CollisionApproximation, ExportPhysicsMaterial, RobotGeometryProvider, ExportRobotOptions, ExportMaterial, ExportMesh } from './core.js';
-export { ARTICULATION_ROOT_API, COLLISION_API, ComposeOptions, CrateReader, ExtractOptions, JointDofInput, JointRelativeDecomposition, MASS_API, MESH_COLLISION_API, MdlMaterialDecl, MdlModule, MdlTextureValue, MdlValue, PACKAGE_NAME, PHYSICS_MATERIAL_API, ParseError, RIGID_BODY_API, ResolvedXform, TextureChannel, TokenizeError, UsdzPackage, VERSION, ValidateRobotOptions, ValidationIssue, ValidationSeverity, collectMdlAssetPaths, composeFile, composeLayer, computeLocalTransform, computeWorldTransform, crateToUsdaFile, decomposeJointRelative, driveKindFor, exportRobotUsda, extractRobotDescription, gatherGprimDescendants, gatherMeshDescendants, getJointAxis, getJointBodies, getJointDrive, getJointLimits, getJointLocalFrame, getJointStatePosition, getJointType, getMassProperties, hasArticulationRootAPI, hasCollisionAPI, hasRigidBodyAPI, isBasisCurves, isMdlTexture, isMesh, isPoints, isRenderableGprim, isScope, isSolidGprim, isUnsupportedGprim, isXform, isZip, iterDescendants, jointValueFromSI, jointValueToSI, loadMdlModules, nearestAngleBranch, normalizeJointLimits, openUsdz, parseMdl, parseMdlLiteral, parseOpType, parseUsda, refineJointType, serializeUsda, stageGeometryProvider, tokenize, validateRobotDescription, writeUsdz } from './core.js';
+import { CollisionApproximation, ExportPhysicsMaterial, RobotGeometryProvider, ExportRobotOptions, ExportMaterial, ExportMesh } from './core.js';
+export { ARTICULATION_ROOT_API, COLLISION_API, ComposeOptions, CrateReader, ExtractOptions, JointDofInput, JointRelativeDecomposition, MASS_API, MESH_COLLISION_API, PACKAGE_NAME, PHYSICS_MATERIAL_API, ParseError, RIGID_BODY_API, ResolvedXform, TextureChannel, TokenizeError, UsdzPackage, VERSION, ValidateRobotOptions, ValidationIssue, ValidationSeverity, collectMdlAssetPaths, composeFile, composeLayer, computeLocalTransform, computeWorldTransform, crateToUsdaFile, decomposeJointRelative, driveKindFor, exportRobotUsda, extractRobotDescription, gatherGprimDescendants, gatherMeshDescendants, getJointAxis, getJointBodies, getJointDrive, getJointLimits, getJointLocalFrame, getJointStatePosition, getJointType, getMassProperties, hasArticulationRootAPI, hasCollisionAPI, hasRigidBodyAPI, isBasisCurves, isMesh, isPoints, isRenderableGprim, isScope, isSolidGprim, isUnsupportedGprim, isXform, isZip, iterDescendants, jointValueFromSI, jointValueToSI, loadMdlModules, nearestAngleBranch, normalizeJointLimits, openUsdz, parseOpType, parseUsda, refineJointType, serializeUsda, stageGeometryProvider, tokenize, validateRobotDescription, writeUsdz } from './core.js';
 import * as THREE from 'three';
-import { A as Axis, V as Vec2, b as Vec3, S as Stage, P as Prim, R as RobotDescription, c as JointDriveDescription, d as LinkInertialDescription, K as KinematicTree, U as UsdaFile, M as Mat4 } from './buildKinematicTree-BCySuZZn.js';
-export { e as AssetPath, f as Attribute, g as AttributeSpec, B as BuildTreeOptions, C as CompositionArc, D as DEFAULT_METERS_PER_UNIT, h as DEG2RAD, a as JointDescription, J as JointType, i as KinematicNode, j as Layer, L as LinkDescription, k as ListOp, l as MetadataMap, m as PrimSpec, n as PropertySpec, Q as Quat, o as RAD2DEG, p as Relationship, q as RelationshipSpec, r as SampleChannel, s as SdfPath, t as Specifier, T as TreeEdge, u as UpAxis, v as UsdDictionary, w as UsdMatrix, x as UsdValue, y as Variability, z as Vec4, E as buildKinematicTree, F as channelFromSamples, G as decomposeRigid, H as fromUsdMatrix, I as getTranslation, N as identity4, O as interpolate, W as invert, X as makeEuler, Y as makeRotationFromQuat, Z as makeRotationX, _ as makeRotationY, $ as makeRotationZ, a0 as makeScale, a1 as makeTranslation, a2 as multiply, a3 as multiplyAll, a4 as toUsdMatrix } from './buildKinematicTree-BCySuZZn.js';
-import { T as ThreeUsdRobot } from './ThreeUsdRobot-BxnCluuK.js';
-export { J as JointObject, b as JointResidual, c as JointValuesFromLinkTransformsOptions, L as LinkObject, d as LinkPose, e as LinkPoseSpace, f as LinkPosesOptions, a as ThreeUsdRobotOptions, W as WorldUpAxis } from './ThreeUsdRobot-BxnCluuK.js';
-import { A as AssetResolver } from './bytes-MOJ2oN-u.js';
-export { B as BinarySource, D as DefaultAssetResolver, U as UsdSource, c as createMemoryResolver, j as joinPosix, t as toBytes } from './bytes-MOJ2oN-u.js';
-export { a as ThreeUsdRobotLoader, T as ThreeUsdRobotLoaderOptions } from './ThreeUsdRobotLoader-C-E9uwEe.js';
+import { A as Axis, J as JointDriveDescription, L as LinkInertialDescription, R as RobotDescription, K as KinematicTree, U as UsdaFile, S as Stage, M as Mat4 } from './buildKinematicTree-Q9JOjAjM.js';
+export { a as AssetPath, b as Attribute, c as AttributeSpec, B as BuildTreeOptions, C as CompositionArc, D as DEFAULT_METERS_PER_UNIT, d as DEG2RAD, e as JointDescription, f as JointMimicDescription, g as JointType, h as KinematicNode, i as Layer, j as LinkDescription, k as ListOp, l as MetadataMap, P as Prim, m as PrimSpec, n as PropertySpec, Q as Quat, o as RAD2DEG, p as Relationship, q as RelationshipSpec, r as SampleChannel, s as SdfPath, t as Specifier, T as TreeEdge, u as UpAxis, v as UsdDictionary, w as UsdMatrix, x as UsdValue, V as Variability, y as Vec2, z as Vec3, E as Vec4, F as buildKinematicTree, G as channelFromSamples, H as decomposeRigid, I as fromUsdMatrix, N as getTranslation, O as identity4, W as interpolate, X as invert, Y as makeEuler, Z as makeRotationFromQuat, _ as makeRotationX, $ as makeRotationY, a0 as makeRotationZ, a1 as makeScale, a2 as makeTranslation, a3 as multiply, a4 as multiplyAll, a5 as toUsdMatrix } from './buildKinematicTree-Q9JOjAjM.js';
+import { T as ThreeUsdRobot } from './ThreeUsdRobot-X1zbpRZo.js';
+export { J as JointObject, b as JointResidual, c as JointValuesFromLinkTransformsOptions, L as LinkObject, d as LinkPose, e as LinkPoseSpace, f as LinkPosesOptions, a as ThreeUsdRobotOptions, W as WorldUpAxis } from './ThreeUsdRobot-X1zbpRZo.js';
+export { B as BindMeshesOptions, a as BuildGprimOptions, M as MaterialFactory, b as MeshKind, R as ResolveMaterialOptions, c as ResolvedMaterial, d as ResolvedTexture, e as TextureColorSpace, f as TextureOptions, T as TextureProvider, g as TextureTransform, h as TextureWrap, i as bindRobotMeshes, j as bindSceneMeshes, k as buildGprimGeometry, l as buildGprimObject, m as buildMeshGeometry, n as buildMeshMaterial, o as createTextureProvider, p as findBoundSurfaceShader, r as resolveBoundMaterial } from './MeshBinding-B_8RhuQE.js';
+export { a as ThreeUsdRobotLoader, T as ThreeUsdRobotLoaderOptions } from './ThreeUsdRobotLoader-u3d1yoLM.js';
+export { A as AssetResolver, D as DefaultAssetResolver, M as MdlMaterialDecl, a as MdlModule, b as MdlModuleProvider, c as MdlTextureValue, d as MdlValue, e as createMemoryResolver, i as isMdlTexture, j as joinPosix, p as parseMdl, f as parseMdlLiteral } from './parseMdl-vfzBGoMr.js';
+export { B as BinarySource, U as UsdSource, t as toBytes } from './bytes-CxGRGry_.js';
 
 /** Unit vector for a USD joint axis token. Returns a fresh vector each call. */
 declare function axisVector(axis: Axis): THREE.Vector3;
 
-/**
- * Resolves `UsdShade` material bindings to flat PBR parameters.
- *
- * Follows a prim's (or an ancestor's) `material:binding` to a `Material`, finds
- * its surface `Shader`, and reads constant color/metalness/roughness/opacity/
- * emissive inputs plus the **texture** asset paths for the diffuse, normal,
- * roughness, metallic, occlusion and emissive channels. Handles both
- * `UsdPreviewSurface` (constant inputs or a connected `UsdUVTexture` network)
- * and the Omniverse MDL material families (M20): `OmniPBR` (and derivatives
- * such as `OmniPBR_Opacity`), `OmniPBR_ClearCoat`, `OmniGlass`, and an
- * `OmniSurface(Lite)` constants subset. MDL shaders are identified by
- * `info:mdl:sourceAsset` / `:subIdentifier`; when the referenced `.mdl` module
- * text is available (see `loadMdlModules`), parameter values fall back from
- * authored USD inputs to the module's wrapper arguments and declaration
- * defaults. Executing MDL remains out of scope.
- */
-
-/** `UsdUVTexture` wrap mode for one axis (`black` ≈ clamp; three has no border). */
-type TextureWrap = "repeat" | "clamp" | "mirror" | "black";
-/** `UsdTransform2d` applied to the `st` coords feeding a texture. */
-type TextureTransform = {
-    /** `inputs:translation` (UV offset). */
-    translation?: Vec2;
-    /** `inputs:rotation` in degrees (CCW about the origin). */
-    rotation?: number;
-    /** `inputs:scale` (UV tiling). */
-    scale?: Vec2;
-};
-/** A resolved texture reference plus its `UsdUVTexture` sampler/transform state. */
-type ResolvedTexture = {
-    /** Authored asset path of the image. */
-    path: string;
-    wrapS?: TextureWrap;
-    wrapT?: TextureWrap;
-    /** `UsdTransform2d` on the `st` input, if any. */
-    transform?: TextureTransform;
-    /** `inputs:scale` — multiplies the sampled value (folded into material factors). */
-    scale?: [number, number, number, number];
-    /** `inputs:bias` — added to the sampled value. */
-    bias?: [number, number, number, number];
-    /**
-     * UV-set (primvar) name the texture reads, resolved through the `inputs:st`
-     * connection to a `UsdPrimvarReader_float2.inputs:varname`. Absent ⇒ `"st"`.
-     */
-    uvSet?: string;
-    /** `inputs:sourceColorSpace` — overrides the per-channel colorspace default. */
-    sourceColorSpace?: "raw" | "sRGB" | "auto";
-    /**
-     * Which output the consuming input connects to (`outputs:r` → `"r"`, …).
-     * three.js samples fixed channels (roughness = G, metalness = B, ao = R);
-     * a mismatch is surfaced as a load warning.
-     */
-    outputChannel?: "r" | "g" | "b" | "a" | "rgb";
-};
-type ResolvedMaterial = {
-    /** Name of the bound `Material` prim, for round-tripping and debugging. */
-    name?: string;
-    color?: Vec3;
-    opacity?: number;
-    metalness?: number;
-    roughness?: number;
-    emissiveColor?: Vec3;
-    /**
-     * `inputs:opacityThreshold`. When `> 0`, opacity is a binary mask (alpha
-     * clip / cutout); when `0`/absent, sub-unit opacity blends translucently.
-     */
-    opacityThreshold?: number;
-    /** `inputs:ior` — promotes the three material to `MeshPhysicalMaterial`. */
-    ior?: number;
-    /** `inputs:clearcoat` (physical promotion). */
-    clearcoat?: number;
-    /** `inputs:clearcoatRoughness` (physical promotion). */
-    clearcoatRoughness?: number;
-    /** `inputs:specularColor`, only when `inputs:useSpecularWorkflow = 1`. */
-    specularColor?: Vec3;
-    /** OmniPBR `inputs:emissive_intensity` — multiplies the emissive color. */
-    emissiveIntensity?: number;
-    /** OmniGlass — `1` marks a transmissive dielectric (physical promotion, M20). */
-    transmission?: number;
-    /** OmniGlass `inputs:depth` — refraction volume thickness (scene units, M20). */
-    thickness?: number;
-    /** Diffuse/albedo texture, if any. */
-    colorTexture?: ResolvedTexture;
-    /** Opacity / alpha texture (may be the same image as `colorTexture`). */
-    opacityTexture?: ResolvedTexture;
-    /** Tangent-space normal map, if any. */
-    normalTexture?: ResolvedTexture;
-    /** Roughness map, if any. */
-    roughnessTexture?: ResolvedTexture;
-    /** Metallic map, if any. */
-    metalnessTexture?: ResolvedTexture;
-    /** Ambient-occlusion map, if any. */
-    occlusionTexture?: ResolvedTexture;
-    /** Emissive map, if any. */
-    emissiveTexture?: ResolvedTexture;
-    /** OmniPBR_ClearCoat `clearcoat_normalmap_texture` (physical promotion, M20). */
-    clearcoatNormalTexture?: ResolvedTexture;
-};
-type ResolveMaterialOptions = {
-    /** Parsed `.mdl` modules for MDL family detection and value fallback (M20). */
-    mdl?: MdlModuleProvider;
-    /** Receives diagnostics (unknown MDL material families). */
-    onWarn?: (message: string) => void;
-};
-/** Resolve the bound material's flat parameters for `prim`, or `undefined`. */
-declare function resolveBoundMaterial(stage: Stage, prim: Prim, options?: ResolveMaterialOptions): ResolvedMaterial | undefined;
-
-/**
- * Loads texture image assets referenced by `UsdShade` materials.
- *
- * A {@link TextureProvider} maps an authored asset path (plus sampler/transform
- * options) to a `THREE.Texture`. The default provider fetches the image **bytes**
- * through the {@link AssetResolver} and decodes them via a blob URL — so it works
- * uniformly for textures served over HTTP and for images embedded inside a
- * `.usdz` package (whose resolver serves zip entries, not real URLs). Decoded
- * images are cached per resolved URL and shared across every texture that uses
- * them; each `THREE.Texture` carries its own color space / wrap / transform.
- */
-
-/**
- * Color space to interpret a texture in. Color/albedo and emissive maps are
- * `"srgb"`; data maps (normal, roughness, metalness, occlusion) are `"linear"`.
- */
-type TextureColorSpace = "srgb" | "linear";
-/** Per-use sampler state applied to the returned `THREE.Texture`. */
-type TextureOptions = {
-    /** Defaults to `"srgb"`. */
-    colorSpace?: TextureColorSpace;
-    wrapS?: TextureWrap;
-    wrapT?: TextureWrap;
-    transform?: TextureTransform;
-    /** UV channel index (0 = `uv`, 1 = `uv1`, …) for multi-UV-set meshes. */
-    channel?: number;
-};
-/** Resolve an authored texture asset path to a `THREE.Texture` (or `null`). */
-type TextureProvider = (assetPath: string, options?: TextureOptions) => THREE.Texture | null;
-/**
- * A {@link TextureProvider} backed by the {@link AssetResolver}, resolving paths
- * against `baseUrl`. Image bytes are fetched once per URL (works for HTTP and
- * `.usdz` entries alike) and the decoded image is shared; each call returns a
- * distinct `THREE.Texture` carrying the requested color space / wrap / transform.
- */
-declare function createTextureProvider(resolver: AssetResolver, baseUrl: string): TextureProvider;
-
-/**
- * Binds renderable gprims — `UsdGeom.Mesh` plus the parametric solids (`Cube` /
- * `Sphere` / `Cylinder` / `Capsule` / `Cone`) — to Three.js geometry and
- * attaches them under the robot's link objects.
- *
- * Meshes are triangulated with a simple fan. Primvars (`st` UV sets, `normals`,
- * `displayColor`) resolve with USD interpolation semantics — `:indices`
- * de-referencing, vertex vs faceVarying (de-indexed) layouts, multiple UV
- * channels. Solids tessellate from their schema attributes. Geometry is left
- * in stage units; the global `metersPerUnit` scale is applied at the root in M9.
- */
-
-type MeshKind = "visual" | "collision";
-type BindMeshesOptions = {
-    loadVisuals?: boolean;
-    loadCollisions?: boolean;
-    /** Resolves diffuse texture asset paths to `THREE.Texture` (M-tex). */
-    textureProvider?: TextureProvider;
-    /** Render `BasisCurves` with authored `widths` as tube meshes (M18). */
-    curveTubes?: boolean;
-    /** Receives fidelity diagnostics (channel-packing mismatches, M19). */
-    onWarn?: (message: string) => void;
-    /** Parsed `.mdl` modules for MDL material family/value resolution (M20). */
-    mdl?: MdlModuleProvider;
-};
-/**
- * Build a `BufferGeometry` from a Mesh prim, or `null` if it has no points.
- *
- * Primvars resolve with full interpolation semantics (M19): `:indices` arrays
- * are de-referenced, vertex-interpolated `st` sets / `normals` /
- * `displayColor` bind onto the shared vertices, and any faceVarying primvar
- * (or per-face color) switches the mesh to a de-indexed layout where every
- * face corner owns its vertex. Extra UV sets become `uv1`, `uv2`, … in
- * {@link meshUvSetNames} order.
- *
- * When the mesh carries `materialBind` face subsets, the triangles are ordered
- * subset by subset and a geometry group is added for each — so the mesh can be
- * drawn with one material per subset (see {@link buildMeshMaterials}). Group
- * order matches {@link getMaterialSubsets}, with any unassigned faces last.
- */
-declare function buildMeshGeometry(meshPrim: Prim): THREE.BufferGeometry | null;
-/**
- * Build geometry for any renderable gprim: `Mesh` via {@link buildMeshGeometry},
- * parametric solids from their schema attributes. Solids follow UsdGeom
- * semantics — sizes in stage units, centered at the origin, `axis` (default
- * `"Z"`) along the spine, and a capsule's `height` spans only its cylindrical
- * section. Returns `null` for unsupported prim types.
- */
-declare function buildGprimGeometry(prim: Prim): THREE.BufferGeometry | null;
-type BuildGprimOptions = {
-    /** Resolves texture asset paths for mesh materials. */
-    textureProvider?: TextureProvider;
-    /**
-     * Render `BasisCurves` that author `widths` as tube meshes instead of
-     * 1-px lines (default `false`).
-     */
-    curveTubes?: boolean;
-    /** Receives fidelity diagnostics (channel-packing mismatches, M19). */
-    onWarn?: (message: string) => void;
-    /** Parsed `.mdl` modules for MDL material family/value resolution (M20). */
-    mdl?: MdlModuleProvider;
-};
-/**
- * Build a renderable `THREE.Object3D` for any supported gprim (M18):
- * `Mesh` and the parametric solids become a `THREE.Mesh` (via
- * {@link buildGprimGeometry} + {@link buildMeshMaterials}), `Points` a
- * `THREE.Points`, and `BasisCurves` a `THREE.Group` holding one line — or,
- * with {@link BuildGprimOptions.curveTubes}, one tube mesh — per curve.
- * Returns `null` for unsupported prim types and degenerate geometry.
- */
-declare function buildGprimObject(prim: Prim, stage?: Stage, options?: BuildGprimOptions): THREE.Object3D | null;
-/**
- * Build a material for a gprim. Color priority: bound `UsdShade` material
- * (when `stage` is given) → `primvars:displayColor` → default gray. Textures
- * (via `textures`) become the matching `MeshStandardMaterial` maps — diffuse →
- * `map` (sRGB), plus `normalMap` / `roughnessMap` / `metalnessMap` / `aoMap`
- * (linear data) and emissive `emissiveMap`. Metalness / roughness / opacity /
- * emissive constants come from the bound material when present.
- */
-declare function buildMeshMaterial(meshPrim: Prim, stage?: Stage, textures?: TextureProvider, 
-/** Resolve the material binding from here instead (a `GeomSubset`). */
-bindingPrim?: Prim, 
-/** Receives fidelity diagnostics (channel-packing mismatches, M19). */
-onWarn?: (message: string) => void, 
-/** Parsed `.mdl` modules for MDL material family/value resolution (M20). */
-mdl?: MdlModuleProvider): THREE.Material;
-/**
- * Attach visual (and optionally collision) meshes to every link of a built
- * {@link ThreeUsdRobot}. Each mesh is positioned by its transform relative to
- * the owning link prim.
- */
-declare function bindRobotMeshes(stage: Stage, robot3d: ThreeUsdRobot, desc: RobotDescription, options?: BindMeshesOptions): void;
-/**
- * Attach the gprims that belong to no link — the static scenery of a cell that
- * also contains robots. The authored prim hierarchy is mirrored with
- * `THREE.Group` nodes (each carrying `userData.primPath` and its prim's local
- * transform), so grouped scenery — a pallet and its cartons, a fence and its
- * wires — stays one movable subtree. World placements are unchanged, and the
- * loader's up-axis and unit normalization still applies at the robot root.
- * Collision-only and guide/proxy prims are skipped.
- */
-declare function bindSceneMeshes(stage: Stage, robot3d: ThreeUsdRobot, desc: RobotDescription, options?: {
-    textureProvider?: TextureProvider;
-    curveTubes?: boolean;
-    onWarn?: (message: string) => void;
-    mdl?: MdlModuleProvider;
-}): number;
-
 /**
  * Authoring API (M14): assemble a robot from Three.js objects and export it.
  *
@@ -317,6 +66,16 @@ type AddJointOptions = {
     /** Initial joint value in SI, exported as `PhysicsJointStateAPI`. */
     initialValue?: number;
     drive?: JointDriveDescription;
+    /**
+     * Follow another joint: `value = multiplier · leader + offset` (SI), exported
+     * as `NewtonMimicAPI`. The leader must be declared (in any order) and share
+     * the motion kind. `multiplier` defaults to `1`, `offset` to `0`.
+     */
+    mimic?: {
+        joint: string;
+        multiplier?: number;
+        offset?: number;
+    };
 };
 declare class RobotBuilder {
     private readonly robotName;
@@ -330,7 +89,7 @@ declare class RobotBuilder {
     private materialAutoId;
     constructor(options: RobotBuilderOptions);
     addLink(options: AddLinkOptions): this;
-    addFixedJoint(options: Omit<AddJointOptions, "axis" | "lower" | "upper">): this;
+    addFixedJoint(options: Omit<AddJointOptions, "axis" | "lower" | "upper" | "mimic">): this;
     addRevoluteJoint(options: AddJointOptions): this;
     addPrismaticJoint(options: AddJointOptions): this;
     private addJoint;
@@ -397,4 +156,4 @@ type ExportThreeUsdRobotOptions = Omit<ExportRobotOptions, "geometry"> & {
 /** Export a loaded robot back to a USDA AST (pass the result to `serializeUsda`). */
 declare function exportThreeUsdRobot(robot: ThreeUsdRobot, options?: ExportThreeUsdRobotOptions): UsdaFile;
 
-export { type AddJointOptions, type AddLinkOptions, AssetResolver, Axis, type BindMeshesOptions, type BuildGprimOptions, CollisionApproximation, ExportMaterial, ExportMesh, ExportPhysicsMaterial, ExportRobotOptions, type ExportThreeUsdRobotOptions, type GeometryToExportMeshOptions, JointDriveDescription, KinematicTree, LinkInertialDescription, Mat4, MdlModuleProvider, type MeshKind, Prim, type ResolveMaterialOptions, type ResolvedMaterial, type ResolvedTexture, RobotBuilder, type RobotBuilderOptions, RobotDescription, RobotGeometryProvider, Stage, type TextureColorSpace, type TextureOptions, type TextureProvider, type TextureTransform, type TextureWrap, ThreeUsdRobot, UsdaFile, Vec2, Vec3, type WorldFrame, axisVector, bindRobotMeshes, bindSceneMeshes, buildGprimGeometry, buildGprimObject, buildMeshGeometry, buildMeshMaterial, createTextureProvider, exportThreeUsdRobot, geometryToExportMesh, materialToExportMaterial, resolveBoundMaterial, threeGeometryProvider };
+export { type AddJointOptions, type AddLinkOptions, Axis, CollisionApproximation, ExportMaterial, ExportMesh, ExportPhysicsMaterial, ExportRobotOptions, type ExportThreeUsdRobotOptions, type GeometryToExportMeshOptions, JointDriveDescription, KinematicTree, LinkInertialDescription, Mat4, RobotBuilder, type RobotBuilderOptions, RobotDescription, RobotGeometryProvider, Stage, ThreeUsdRobot, UsdaFile, type WorldFrame, axisVector, exportThreeUsdRobot, geometryToExportMesh, materialToExportMaterial, threeGeometryProvider };

package/dist/index.js

@@ -1,11 +1,13 @@
-import { stageGeometryProvider, exportRobotUsda } from './chunk-BCRRXGNB.js';
-export { PACKAGE_NAME, VERSION, exportRobotUsda, stageGeometryProvider, validateRobotDescription, writeUsdz } from './chunk-BCRRXGNB.js';
-export { ThreeUsdRobotLoader, bindRobotMeshes, bindSceneMeshes, buildGprimGeometry, buildGprimObject, buildMeshGeometry, buildMeshMaterial, createTextureProvider } from './chunk-5SVRTKS4.js';
-import { refineJointType, buildKinematicTree } from './chunk-AXPMXEQC.js';
-export { ARTICULATION_ROOT_API, Attribute, COLLISION_API, CrateReader, DEFAULT_METERS_PER_UNIT, DefaultAssetResolver, Layer, MASS_API, MESH_COLLISION_API, PHYSICS_MATERIAL_API, ParseError, Prim, RIGID_BODY_API, Relationship, Stage, TokenizeError, buildKinematicTree, collectMdlAssetPaths, composeFile, composeLayer, computeLocalTransform, computeWorldTransform, crateToUsdaFile, createMemoryResolver, driveKindFor, extractRobotDescription, gatherGprimDescendants, gatherMeshDescendants, getJointAxis, getJointBodies, getJointDrive, getJointLimits, getJointLocalFrame, getJointStatePosition, getJointType, getMassProperties, hasArticulationRootAPI, hasCollisionAPI, hasRigidBodyAPI, isBasisCurves, isMdlTexture, isMesh, isPoints, isRenderableGprim, isScope, isSolidGprim, isUnsupportedGprim, isXform, isZip, iterDescendants, joinPosix, jointValueFromSI, jointValueToSI, loadMdlModules, normalizeJointLimits, openUsdz, parseMdl, parseMdlLiteral, parseOpType, parseUsda, refineJointType, resolveBoundMaterial, serializeUsda, toBytes, tokenize } from './chunk-AXPMXEQC.js';
-export { JointObject, LinkObject, ThreeUsdRobot, axisVector } from './chunk-ENWFOYHU.js';
-import { identity4, multiply, invert } from './chunk-LDO5FKQS.js';
-export { AssetPath, DEG2RAD, Quat, RAD2DEG, UsdMatrix, channelFromSamples, decomposeJointRelative, decomposeRigid, fromUsdMatrix, getTranslation, identity4, interpolate, invert, makeEuler, makeRotationFromQuat, makeRotationX, makeRotationY, makeRotationZ, makeScale, makeTranslation, multiply, multiplyAll, nearestAngleBranch, toUsdMatrix } from './chunk-LDO5FKQS.js';
+import { stageGeometryProvider, exportRobotUsda } from './chunk-5ZPHZ5ZH.js';
+export { PACKAGE_NAME, VERSION, exportRobotUsda, stageGeometryProvider, validateRobotDescription, writeUsdz } from './chunk-5ZPHZ5ZH.js';
+export { ThreeUsdRobotLoader, bindRobotMeshes, bindSceneMeshes, buildGprimGeometry, buildGprimObject, buildMeshGeometry, buildMeshMaterial, createTextureProvider } from './chunk-GRJGPHLW.js';
+import { refineJointType, buildKinematicTree } from './chunk-FUVHAORT.js';
+export { ARTICULATION_ROOT_API, Attribute, COLLISION_API, CrateReader, DEFAULT_METERS_PER_UNIT, Layer, MASS_API, MESH_COLLISION_API, PHYSICS_MATERIAL_API, ParseError, Prim, RIGID_BODY_API, Relationship, Stage, TokenizeError, buildKinematicTree, collectMdlAssetPaths, composeFile, composeLayer, computeLocalTransform, computeWorldTransform, crateToUsdaFile, driveKindFor, extractRobotDescription, gatherGprimDescendants, gatherMeshDescendants, getJointAxis, getJointBodies, getJointDrive, getJointLimits, getJointLocalFrame, getJointStatePosition, getJointType, getMassProperties, hasArticulationRootAPI, hasCollisionAPI, hasRigidBodyAPI, isBasisCurves, isMesh, isPoints, isRenderableGprim, isScope, isSolidGprim, isUnsupportedGprim, isXform, isZip, iterDescendants, jointValueFromSI, jointValueToSI, loadMdlModules, normalizeJointLimits, openUsdz, parseOpType, parseUsda, refineJointType, serializeUsda, toBytes, tokenize } from './chunk-FUVHAORT.js';
+export { JointObject, LinkObject, ThreeUsdRobot, axisVector } from './chunk-JN2QPDB3.js';
+import { identity4, multiply, invert } from './chunk-YGJ23CG3.js';
+export { DEG2RAD, RAD2DEG, channelFromSamples, decomposeJointRelative, decomposeRigid, fromUsdMatrix, getTranslation, identity4, interpolate, invert, makeEuler, makeRotationFromQuat, makeRotationX, makeRotationY, makeRotationZ, makeScale, makeTranslation, multiply, multiplyAll, nearestAngleBranch, toUsdMatrix } from './chunk-YGJ23CG3.js';
+export { DefaultAssetResolver, createMemoryResolver, findBoundSurfaceShader, isMdlTexture, joinPosix, parseMdl, parseMdlLiteral, resolveBoundMaterial } from './chunk-PPPRB6KE.js';
+export { AssetPath, Quat, UsdMatrix } from './chunk-JGIVJXBU.js';
 import * as THREE from 'three';
 
 function geometryToExportMesh(geometry, options) {
@@ -233,6 +235,23 @@ var RobotBuilder = class {
       const jointWorld = pending.world ?? childLink.world;
       const parentWorld = parent === "" ? identity4() : this.links.get(parent).world;
       const type = refineJointType(pending.type, options.lower, options.upper);
+      if (options.mimic) {
+        const leader = this.joints.get(options.mimic.joint);
+        if (!leader) {
+          throw new Error(
+            `RobotBuilder: joint "${name}" mimics unknown joint "${options.mimic.joint}"`
+          );
+        }
+        if (options.mimic.joint === name) {
+          throw new Error(`RobotBuilder: joint "${name}" cannot mimic itself`);
+        }
+        const linear = (t) => t === "prismatic";
+        if (leader.type === "fixed" || linear(leader.type) !== linear(pending.type)) {
+          throw new Error(
+            `RobotBuilder: joint "${name}" (${pending.type}) cannot mimic "${options.mimic.joint}" (${leader.type})`
+          );
+        }
+      }
       joints[name] = {
         name,
         primPath: `/${this.robotName}/${name}`,
@@ -245,7 +264,14 @@ var RobotBuilder = class {
         ...options.lower !== void 0 ? { lower: options.lower } : {},
         ...options.upper !== void 0 ? { upper: options.upper } : {},
         ...options.initialValue !== void 0 ? { initialValue: options.initialValue } : {},
-        ...options.drive ? { drive: options.drive } : {}
+        ...options.drive ? { drive: options.drive } : {},
+        ...options.mimic ? {
+          mimic: {
+            joint: options.mimic.joint,
+            multiplier: options.mimic.multiplier ?? 1,
+            offset: options.mimic.offset ?? 0
+          }
+        } : {}
       };
     }
     if (this.articulationRoot !== void 0 && !this.links.has(this.articulationRoot)) {