@relu-interactives/spatial-ecs 0.11.0 → 0.11.1

package/dist/{chunk-GSWC6LLD.js → chunk-GMSFEXUZ.js}

@@ -43,6 +43,7 @@ function restPositions(root) {
   return out;
 }
 __name(restPositions, "restPositions");
+var NUMBERED_NAME = /_\d+$/;
 function splitBoneName(raw) {
   let n = raw.replace(/^.*[:|]/, "").replace(/^(mixamorig\d*|def[-_]|org[-_]|mch[-_]|bip\d*[ _]|b[-_])/i, "").trim();
   let side = null;
@@ -144,6 +145,37 @@ function findHips(root) {
 __name(findHips, "findHips");
 var isSpineLike = /* @__PURE__ */ __name((base) => /^(spine|chest|upperchest|torso|back)\d*$/.test(base), "isSpineLike");
 function detectRig(root) {
+  const plain = readRig(root);
+  if (plain.missing.length === 0) return plain;
+  const stems = /* @__PURE__ */ new Map();
+  const count = /* @__PURE__ */ __name((n) => {
+    const stem = n.name.replace(NUMBERED_NAME, "");
+    stems.set(stem, (stems.get(stem) ?? 0) + 1);
+    n.children.forEach(count);
+  }, "count");
+  count(root);
+  const real = /* @__PURE__ */ new Map();
+  const strip = /* @__PURE__ */ __name((n) => {
+    const stem = n.name.replace(NUMBERED_NAME, "");
+    const name = stems.get(stem) === 1 ? stem : n.name;
+    real.set(name, n.name);
+    return { ...n, name, children: n.children.map(strip) };
+  }, "strip");
+  const found = readRig(strip(root));
+  if (found.missing.length >= plain.missing.length) return plain;
+  const realName = /* @__PURE__ */ __name((name) => real.get(name) ?? name, "realName");
+  const bones = {};
+  for (const [bone, name] of Object.entries(found.bones)) {
+    bones[bone] = realName(name);
+  }
+  return {
+    ...found,
+    bones,
+    byName: new Map([...found.byName].map(([name, bone]) => [realName(name), bone]))
+  };
+}
+__name(detectRig, "detectRig");
+function readRig(root) {
   const all = [];
   const collect = /* @__PURE__ */ __name((n) => {
     all.push(n);
@@ -217,7 +249,7 @@ function detectRig(root) {
     missing: REQUIRED_HUMANOID_BONES.filter((b) => !bones[b])
   };
 }
-__name(detectRig, "detectRig");
+__name(readRig, "readRig");
 function mirrorHumanoidBone(b) {
   if (b.startsWith("left")) return `right${b.slice(4)}`;
   if (b.startsWith("right")) return `left${b.slice(5)}`;
@@ -237,5 +269,5 @@ function skeletonFromObject3D(object) {
 __name(skeletonFromObject3D, "skeletonFromObject3D");
 
 export { REQUIRED_HUMANOID_BONES, detectRig, mirrorHumanoidBone, qinv, qmul, qrot, restPositions, skeletonFromObject3D, splitBoneName };
-//# sourceMappingURL=chunk-GSWC6LLD.js.map
-//# sourceMappingURL=chunk-GSWC6LLD.js.map
+//# sourceMappingURL=chunk-GMSFEXUZ.js.map
+//# sourceMappingURL=chunk-GMSFEXUZ.js.map

package/dist/chunk-GMSFEXUZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../core/animation/humanoid.ts"],"names":[],"mappings":"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","file":"chunk-GMSFEXUZ.js","sourcesContent":["/**\n * One vocabulary for humanoid skeletons.\n *\n * Every source names its bones differently: Mixamo `mixamorig:LeftForeArm`,\n * Meshy `LeftForeArm` with its spine numbered top-down (`Spine02` is the\n * LOWEST), Unreal / Quaternius UAL `lowerarm_l` with `spine_01` lowest,\n * Blender rigify `forearm.L`, VRM `leftLowerArm`. Retargeting, the animation\n * editor and bone sockets all need \"the left forearm\" regardless, so a\n * skeleton is mapped once onto VRM's humanoid bone names (the closest thing\n * to a standard) and everything downstream speaks those.\n *\n * Pure data + math, no three.js: the editor's Node tools (gltf-transform\n * documents) and the runtime (THREE.Bone trees) both build a `SkeletonNode`\n * tree and call `detectRig`.\n */\n\nexport type HumanoidBone =\n  | \"hips\"\n  | \"spine\"\n  | \"chest\"\n  | \"upperChest\"\n  | \"neck\"\n  | \"head\"\n  | \"leftShoulder\"\n  | \"leftUpperArm\"\n  | \"leftLowerArm\"\n  | \"leftHand\"\n  | \"rightShoulder\"\n  | \"rightUpperArm\"\n  | \"rightLowerArm\"\n  | \"rightHand\"\n  | \"leftUpperLeg\"\n  | \"leftLowerLeg\"\n  | \"leftFoot\"\n  | \"leftToes\"\n  | \"rightUpperLeg\"\n  | \"rightLowerLeg\"\n  | \"rightFoot\"\n  | \"rightToes\"\n  | `${\"left\" | \"right\"}${Finger}${FingerJoint}`;\n\ntype Finger = \"Thumb\" | \"Index\" | \"Middle\" | \"Ring\" | \"Little\";\ntype FingerJoint = \"Metacarpal\" | \"Proximal\" | \"Intermediate\" | \"Distal\";\n\n/** The bones a humanoid must have to retarget a full-body clip. */\nexport const REQUIRED_HUMANOID_BONES: readonly HumanoidBone[] = [\n  \"hips\",\n  \"spine\",\n  \"head\",\n  \"leftUpperArm\",\n  \"leftLowerArm\",\n  \"leftHand\",\n  \"rightUpperArm\",\n  \"rightLowerArm\",\n  \"rightHand\",\n  \"leftUpperLeg\",\n  \"leftLowerLeg\",\n  \"leftFoot\",\n  \"rightUpperLeg\",\n  \"rightLowerLeg\",\n  \"rightFoot\",\n];\n\n/** Vector [x, y, z] and quaternion [x, y, z, w]. */\nexport type Vec3 = [number, number, number];\nexport type Quat = [number, number, number, number];\n\n/** A bone (or any node) with its LOCAL rest transform. */\nexport interface SkeletonNode {\n  name: string;\n  translation: Vec3;\n  rotation: Quat;\n  scale?: Vec3;\n  children: SkeletonNode[];\n}\n\nexport type RigProfile =\n  | \"mixamo\"\n  | \"meshy\"\n  | \"unreal\"\n  | \"rigify\"\n  | \"vrm\"\n  | \"generic\";\n\nexport interface RigDetection {\n  profile: RigProfile;\n  /** Humanoid bone → the rig's own bone name. */\n  bones: Partial<Record<HumanoidBone, string>>;\n  /** Rig bone name → humanoid bone. */\n  byName: Map<string, HumanoidBone>;\n  /** Arms level (T), angled down (A), or neither. */\n  restPose: \"T\" | \"A\" | \"unknown\";\n  /** Degrees the left upper arm points below horizontal at rest. */\n  armDrop: number | null;\n  /** Required bones the rig lacks (empty = can retarget). */\n  missing: HumanoidBone[];\n}\n\n// ── quaternion helpers ───────────────────────────────────────────────────────\n\nexport const qmul = (a: Quat, b: Quat): Quat => [\n  a[3] * b[0] + a[0] * b[3] + a[1] * b[2] - a[2] * b[1],\n  a[3] * b[1] - a[0] * b[2] + a[1] * b[3] + a[2] * b[0],\n  a[3] * b[2] + a[0] * b[1] - a[1] * b[0] + a[2] * b[3],\n  a[3] * b[3] - a[0] * b[0] - a[1] * b[1] - a[2] * b[2],\n];\nexport const qinv = (q: Quat): Quat => [-q[0], -q[1], -q[2], q[3]];\nexport const qrot = (q: Quat, v: Vec3): Vec3 => {\n  const r = qmul(qmul(q, [v[0], v[1], v[2], 0]), qinv(q));\n  return [r[0], r[1], r[2]];\n};\n\n/** World (rig-space) rest position of every node, by name. */\nexport function restPositions(root: SkeletonNode): Map<string, Vec3> {\n  const out = new Map<string, Vec3>();\n  const walk = (n: SkeletonNode, pq: Quat, pp: Vec3, ps: number) => {\n    const t = qrot(pq, [n.translation[0] * ps, n.translation[1] * ps, n.translation[2] * ps]);\n    const p: Vec3 = [pp[0] + t[0], pp[1] + t[1], pp[2] + t[2]];\n    out.set(n.name, p);\n    const q = qmul(pq, n.rotation);\n    const s = ps * (n.scale?.[0] ?? 1);\n    for (const c of n.children) walk(c, q, p, s);\n  };\n  walk(root, [0, 0, 0, 1], [0, 0, 0], 1);\n  return out;\n}\n\n// ── names ────────────────────────────────────────────────────────────────────\n\n/** The number an exporter puts on the end of a name. */\nconst NUMBERED_NAME = /_\\d+$/;\n\n/**\n * `mixamorig1:LeftForeArm` → { side: \"left\", base: \"forearm\" };\n * `upperarm_l` → { side: \"left\", base: \"upperarm\" }; `forearm.L` → left.\n */\nexport function splitBoneName(raw: string): { side: \"left\" | \"right\" | null; base: string } {\n  let n = raw\n    .replace(/^.*[:|]/, \"\") // mixamorig:, Armature|, rig:\n    .replace(/^(mixamorig\\d*|def[-_]|org[-_]|mch[-_]|bip\\d*[ _]|b[-_])/i, \"\")\n    .trim();\n  let side: \"left\" | \"right\" | null = null;\n  const sided = [\n    [/^left[\\s_.-]*/i, \"left\"],\n    [/^right[\\s_.-]*/i, \"right\"],\n    [/^l[\\s_.-]+/i, \"left\"],\n    [/^r[\\s_.-]+/i, \"right\"],\n    [/[\\s_.-]+l$/i, \"left\"],\n    [/[\\s_.-]+r$/i, \"right\"],\n    [/[\\s_.-]*left$/i, \"left\"],\n    [/[\\s_.-]*right$/i, \"right\"],\n  ] as const;\n  for (const [re, s] of sided) {\n    if (re.test(n)) {\n      side = s;\n      n = n.replace(re, \"\");\n      break;\n    }\n  }\n  return { side, base: n.toLowerCase().replace(/[^a-z0-9]/g, \"\") };\n}\n\n/** Bases for sided limb bones. Order matters: first match wins. */\nconst LIMB_BASES: Array<[RegExp, string]> = [\n  [/^(shoulder|clavicle|collar(bone)?)$/, \"Shoulder\"],\n  [/^(upperarm|uparm|arm)$/, \"UpperArm\"],\n  [/^(forearm|lowerarm|elbow|loarm)$/, \"LowerArm\"],\n  [/^(hand|wrist)$/, \"Hand\"],\n  [/^(upleg|upperleg|thigh|hipjoint)$/, \"UpperLeg\"],\n  [/^(leg|lowerleg|calf|shin|knee)$/, \"LowerLeg\"],\n  [/^(foot|ankle)$/, \"Foot\"],\n  [/^(toebase|toe|toes|ball)$/, \"Toes\"],\n];\n\nconst FINGERS: Array<[RegExp, Finger]> = [\n  [/^thumb/, \"Thumb\"],\n  [/^(index|pointer)/, \"Index\"],\n  [/^(middle|fingers)/, \"Middle\"],\n  [/^ring/, \"Ring\"],\n  [/^(pinky|little|small)/, \"Little\"],\n];\n\nfunction fingerJoint(finger: Finger, digits: string): FingerJoint | null {\n  // Mixamo/UE number 1-3 (4 = tip); a bare \"Thumb\"/\"Fingers\" (Meshy after\n  // fix-rig) is the first joint.\n  const n = digits === \"\" ? 1 : Number(digits);\n  const joints: FingerJoint[] =\n    finger === \"Thumb\"\n      ? [\"Metacarpal\", \"Proximal\", \"Distal\"]\n      : [\"Proximal\", \"Intermediate\", \"Distal\"];\n  return joints[n - 1] ?? null;\n}\n\n/** A sided bone from its name alone, or null. */\nfunction sidedBone(base: string, side: \"left\" | \"right\"): HumanoidBone | null {\n  for (const [re, part] of LIMB_BASES) {\n    if (re.test(base)) return `${side}${part}` as HumanoidBone;\n  }\n  // Mixamo writes fingers as LeftHandIndex1.\n  const f = base.replace(/^hand(?=(thumb|index|middle|ring|pinky|little))/, \"\");\n  for (const [re, finger] of FINGERS) {\n    if (!re.test(f)) continue;\n    const digits = /(\\d+)$/.exec(f)?.[1] ?? \"\";\n    const joint = fingerJoint(finger, digits.replace(/^0+/, \"\"));\n    return joint ? (`${side}${finger}${joint}` as HumanoidBone) : null;\n  }\n  return null;\n}\n\n// VRM names, recognised directly (leftUpperArm → lowercase \"leftupperarm\").\nconst VRM_LOWER = new Map<string, HumanoidBone>();\n\nconst VRM_FINGER = /^(left|right)(Thumb|Index|Middle|Ring|Little)(Metacarpal|Proximal|Intermediate|Distal)$/;\n\nfunction vrmBone(raw: string): HumanoidBone | null {\n  const name = raw.replace(/^.*[:|]/, \"\");\n  if (VRM_FINGER.test(name)) return name as HumanoidBone;\n  if (VRM_LOWER.size === 0) {\n    const sides = [\"left\", \"right\"] as const;\n    const parts = [\"Shoulder\", \"UpperArm\", \"LowerArm\", \"Hand\", \"UpperLeg\", \"LowerLeg\", \"Foot\", \"Toes\"];\n    for (const s of sides) for (const p of parts) VRM_LOWER.set(`${s}${p}`.toLowerCase(), `${s}${p}` as HumanoidBone);\n    for (const b of [\"hips\", \"spine\", \"chest\", \"upperChest\", \"neck\", \"head\"] as const)\n      VRM_LOWER.set(b.toLowerCase(), b);\n  }\n  return VRM_LOWER.get(name.toLowerCase()) ?? null;\n}\n\nfunction profileOf(names: string[]): RigProfile {\n  if (names.some((n) => /^mixamorig/i.test(n))) return \"mixamo\";\n  if (names.some((n) => /^(upperarm|lowerarm|thigh|calf)_[lr]$/i.test(n))) return \"unreal\";\n  if (names.some((n) => /\\.[LR]$/.test(n))) return \"rigify\";\n  if (names.some((n) => /^leftUpperArm$/.test(n))) return \"vrm\";\n  if (names.some((n) => /^Spine0[12]$/.test(n))) return \"meshy\";\n  return \"generic\";\n}\n\nfunction findHips(root: SkeletonNode): SkeletonNode | null {\n  let found: SkeletonNode | null = null;\n  const walk = (n: SkeletonNode) => {\n    if (found) return;\n    const { base } = splitBoneName(n.name);\n    if (/^(hips|hip|pelvis)$/.test(base)) {\n      found = n;\n      return;\n    }\n    for (const c of n.children) walk(c);\n  };\n  walk(root);\n  return found;\n}\n\nconst isSpineLike = (base: string) => /^(spine|chest|upperchest|torso|back)\\d*$/.test(base);\n\n/**\n * Map a skeleton onto humanoid bones. Pass the scene root (the armature's\n * own transform included): the rest-pose check measures \"down\" in that space,\n * and a Mixamo armature is Z-up under a 90° turn.\n *\n * Limbs and fingers come from their names (any of the conventions above, side\n * from prefixes/suffixes, or from which side of the body they sit when the\n * name has none). The spine comes from the CHAIN between the hips and the\n * neck, not from names, because conventions number it in opposite\n * directions: its first bone is `spine`, the second `chest`, a third\n * `upperChest`.\n */\nexport function detectRig(root: SkeletonNode): RigDetection {\n  const plain = readRig(root);\n  if (plain.missing.length === 0) return plain;\n  // Sketchfab's exporter numbers every bone (`mixamorigLeftArm_9`), which hides\n  // the rig. Meshes get numbers too (`Object_2`, `Object_3`), so a number only\n  // comes off where the name stays unique.\n  const stems = new Map<string, number>();\n  const count = (n: SkeletonNode) => {\n    const stem = n.name.replace(NUMBERED_NAME, \"\");\n    stems.set(stem, (stems.get(stem) ?? 0) + 1);\n    n.children.forEach(count);\n  };\n  count(root);\n  const real = new Map<string, string>();\n  const strip = (n: SkeletonNode): SkeletonNode => {\n    const stem = n.name.replace(NUMBERED_NAME, \"\");\n    const name = stems.get(stem) === 1 ? stem : n.name;\n    real.set(name, n.name);\n    return { ...n, name, children: n.children.map(strip) };\n  };\n  const found = readRig(strip(root));\n  if (found.missing.length >= plain.missing.length) return plain;\n  const realName = (name: string) => real.get(name) ?? name;\n  const bones: RigDetection[\"bones\"] = {};\n  for (const [bone, name] of Object.entries(found.bones) as [HumanoidBone, string][]) {\n    bones[bone] = realName(name);\n  }\n  return {\n    ...found,\n    bones,\n    byName: new Map([...found.byName].map(([name, bone]) => [realName(name), bone])),\n  };\n}\n\nfunction readRig(root: SkeletonNode): RigDetection {\n  const all: SkeletonNode[] = [];\n  const collect = (n: SkeletonNode) => {\n    all.push(n);\n    for (const c of n.children) collect(c);\n  };\n  collect(root);\n  const profile = profileOf(all.map((n) => n.name));\n  const bones: Partial<Record<HumanoidBone, string>> = {};\n  const set = (b: HumanoidBone, name: string) => {\n    if (!bones[b]) bones[b] = name;\n  };\n\n  const hips = findHips(root);\n  const positions = restPositions(root);\n  if (hips) {\n    set(\"hips\", hips.name);\n    // The spine chain: follow spine-like children upward from the hips.\n    const chain: SkeletonNode[] = [];\n    let cur: SkeletonNode | undefined = hips;\n    while (cur) {\n      const next: SkeletonNode | undefined = cur.children.find((c) => isSpineLike(splitBoneName(c.name).base));\n      if (!next) break;\n      chain.push(next);\n      cur = next;\n    }\n    if (chain[0]) set(\"spine\", chain[0].name);\n    if (chain[1]) set(\"chest\", chain[1].name);\n    if (chain[2]) set(\"upperChest\", chain[chain.length - 1].name);\n  }\n\n  for (const n of all) {\n    const vrm = vrmBone(n.name);\n    if (vrm) {\n      set(vrm, n.name);\n      continue;\n    }\n    const { side, base } = splitBoneName(n.name);\n    if (/^neck\\d*$/.test(base)) {\n      set(\"neck\", n.name);\n      continue;\n    }\n    if (/^head$/.test(base)) {\n      set(\"head\", n.name);\n      continue;\n    }\n    if (base === \"hips\" || base === \"pelvis\" || isSpineLike(base)) continue;\n    // No side in the name: decide by which side of the hips it sits (glTF\n    // humanoids face +Z, so their left is +X).\n    const s =\n      side ??\n      (() => {\n        const p = positions.get(n.name);\n        const h = hips ? positions.get(hips.name) : undefined;\n        if (!p || !h || Math.abs(p[0] - h[0]) < 1e-4) return null;\n        return p[0] > h[0] ? \"left\" : \"right\";\n      })();\n    if (!s) continue;\n    const b = sidedBone(base, s);\n    if (b) set(b, n.name);\n  }\n\n  const byName = new Map<string, HumanoidBone>();\n  for (const [b, name] of Object.entries(bones)) byName.set(name as string, b as HumanoidBone);\n\n  // Rest pose from the left upper arm's direction.\n  let armDrop: number | null = null;\n  const ua = bones.leftUpperArm && positions.get(bones.leftUpperArm);\n  const la = bones.leftLowerArm && positions.get(bones.leftLowerArm);\n  if (ua && la) {\n    const d: Vec3 = [la[0] - ua[0], la[1] - ua[1], la[2] - ua[2]];\n    const len = Math.hypot(d[0], d[1], d[2]) || 1;\n    armDrop = (Math.asin(Math.max(-1, Math.min(1, -d[1] / len))) * 180) / Math.PI;\n  }\n  const restPose = armDrop === null ? \"unknown\" : armDrop < 15 ? \"T\" : armDrop <= 65 ? \"A\" : \"unknown\";\n\n  return {\n    profile,\n    bones,\n    byName,\n    restPose,\n    armDrop,\n    missing: REQUIRED_HUMANOID_BONES.filter((b) => !bones[b]),\n  };\n}\n\n/** The same bone on the other side (`leftHand` ↔ `rightHand`). */\nexport function mirrorHumanoidBone(b: HumanoidBone): HumanoidBone {\n  if (b.startsWith(\"left\")) return `right${b.slice(4)}` as HumanoidBone;\n  if (b.startsWith(\"right\")) return `left${b.slice(5)}` as HumanoidBone;\n  return b;\n}\n\n/**\n * Duck-typed adapter for a three.js Object3D/Bone tree (position: Vector3,\n * quaternion: Quaternion), so the runtime can call `detectRig` without this\n * module importing three.\n */\nexport function skeletonFromObject3D(object: {\n  name: string;\n  position: { x: number; y: number; z: number };\n  quaternion: { x: number; y: number; z: number; w: number };\n  scale?: { x: number; y: number; z: number };\n  children: unknown[];\n}): SkeletonNode {\n  const o = object;\n  return {\n    name: o.name,\n    translation: [o.position.x, o.position.y, o.position.z],\n    rotation: [o.quaternion.x, o.quaternion.y, o.quaternion.z, o.quaternion.w],\n    scale: o.scale ? [o.scale.x, o.scale.y, o.scale.z] : undefined,\n    children: (o.children as (typeof object)[]).map(skeletonFromObject3D),\n  };\n}\n"]}

package/dist/{chunk-JEPUCLZX.js → chunk-QAZCVCMP.js}

@@ -1,7 +1,7 @@
-import { AnimationComponent, AudioComponent, Object3DRef, CameraComponent, MeshGeometryComponent, PhysicsComponent, Environment, EntityType, ImageComponent, ImageTargetAnchor, ImageTarget, LightComponent, MaterialComponent, MeshComponent, ModelComponent, Name, ParentId, Postprocessing, ScriptComponent, ScriptObjectComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, InstancedMeshComponent, InstanceSlotComponent, VideoComponent, XRRigComponent, VRTeleportAreaComponent, XRHandPoseComponent, XRAnchorComponent, BoneAttachmentComponent, IKComponent, NetworkIdentityComponent, NetworkTransformComponent, NetworkedPropsComponent, NetworkSpawnerComponent, XRInteractableComponent, XRInteractorComponent, XRInteractorSideComponent, UIButtonComponent, UIPanelComponent, UISliderComponent, UITextComponent, UIToggleComponent, setModelLoadState } from './chunk-JNYPJB55.js';
-import { detectRig, skeletonFromObject3D } from './chunk-GSWC6LLD.js';
+import { AnimationComponent, AudioComponent, Object3DRef, CameraComponent, MeshGeometryComponent, PhysicsComponent, Environment, EntityType, ImageComponent, ImageTargetAnchor, ImageTarget, LightComponent, MaterialComponent, MeshComponent, ModelComponent, Name, ParentId, Postprocessing, ScriptComponent, ScriptObjectComponent, Selectable, SelectionTransformState, SpriteComponent, TransformComponent, InstancedMeshComponent, InstanceSlotComponent, VideoComponent, XRRigComponent, VRTeleportAreaComponent, XRHandPoseComponent, XRAnchorComponent, BoneAttachmentComponent, IKComponent, NetworkIdentityComponent, NetworkTransformComponent, NetworkedPropsComponent, NetworkSpawnerComponent, XRInteractableComponent, XRInteractorComponent, XRInteractorSideComponent, UIButtonComponent, UIPanelComponent, UISliderComponent, UITextComponent, UIToggleComponent, setModelLoadState } from './chunk-T7SRBLPJ.js';
+import { detectRig, skeletonFromObject3D } from './chunk-GMSFEXUZ.js';
 import { __name } from './chunk-XE4OXN2W.js';
-import * as THREE from 'three';
+import * as THREE6 from 'three';
 import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 import { MeshoptDecoder } from 'three/examples/jsm/libs/meshopt_decoder.module.js';
@@ -23,11 +23,11 @@ function normalizeDistanceModel(distanceModel) {
 }
 __name(normalizeDistanceModel, "normalizeDistanceModel");
 function createConfiguredAudio(listener, options) {
-  const sound = options.positional ? new THREE.PositionalAudio(listener) : new THREE.Audio(listener);
+  const sound = options.positional ? new THREE6.PositionalAudio(listener) : new THREE6.Audio(listener);
   sound.setLoop(options.loop);
   sound.setVolume(options.volume);
   sound.setPlaybackRate(options.pitch);
-  if (sound instanceof THREE.PositionalAudio) {
+  if (sound instanceof THREE6.PositionalAudio) {
     sound.setRefDistance(options.refDistance);
     sound.setDistanceModel(normalizeDistanceModel(options.distanceModel));
     sound.setRolloffFactor(options.rolloffFactor);
@@ -37,16 +37,16 @@ function createConfiguredAudio(listener, options) {
 __name(createConfiguredAudio, "createConfiguredAudio");
 function createAudioEditorHelper() {
   if (typeof document === "undefined") {
-    const geometry = new THREE.EdgesGeometry(
-      new THREE.OctahedronGeometry(0.22, 0)
+    const geometry = new THREE6.EdgesGeometry(
+      new THREE6.OctahedronGeometry(0.22, 0)
     );
-    const material2 = new THREE.LineBasicMaterial({
+    const material2 = new THREE6.LineBasicMaterial({
       color: "#8bc8ff",
       transparent: true,
       opacity: 0.95,
       depthTest: false
     });
-    const fallback = new THREE.LineSegments(geometry, material2);
+    const fallback = new THREE6.LineSegments(geometry, material2);
     fallback.renderOrder = 10;
     fallback.userData.ecsHelper = true;
     fallback.visible = false;
@@ -58,7 +58,7 @@ function createAudioEditorHelper() {
   canvas.height = size;
   const ctx = canvas.getContext("2d");
   if (!ctx) {
-    return new THREE.Object3D();
+    return new THREE6.Object3D();
   }
   ctx.clearRect(0, 0, size, size);
   ctx.fillStyle = "rgba(27, 35, 52, 0.9)";
@@ -89,14 +89,14 @@ function createAudioEditorHelper() {
   ctx.beginPath();
   ctx.arc(56, 48, 16, -0.8, 0.8);
   ctx.stroke();
-  const texture = new THREE.CanvasTexture(canvas);
+  const texture = new THREE6.CanvasTexture(canvas);
   texture.needsUpdate = true;
-  const material = new THREE.SpriteMaterial({
+  const material = new THREE6.SpriteMaterial({
     map: texture,
     transparent: true,
     depthTest: false
   });
-  const helper = new THREE.Sprite(material);
+  const helper = new THREE6.Sprite(material);
   helper.scale.set(0.68, 0.68, 0.68);
   helper.renderOrder = 10;
   helper.userData.ecsHelper = true;
@@ -123,7 +123,7 @@ function createAudioComponent(world, entityId, path = "", options = {}, context)
 __name(createAudioComponent, "createAudioComponent");
 function createCameraComponent(world, entityId, payload = {}) {
   const object = world.getComponent(entityId, Object3DRef)?.object;
-  const objectCamera = object instanceof THREE.Camera ? object : void 0;
+  const objectCamera = object instanceof THREE6.Camera ? object : void 0;
   const component = new CameraComponent({
     ...payload,
     camera: payload.camera ?? objectCamera
@@ -569,7 +569,7 @@ function findModelBone(root, ref) {
   for (const b of bones) if (!byName.has(b.name)) byName.set(b.name, b);
   const name = ref.bone ?? "";
   if (name) {
-    const hit = byName.get(name) ?? byName.get(THREE.PropertyBinding.sanitizeNodeName(name));
+    const hit = byName.get(name) ?? byName.get(THREE6.PropertyBinding.sanitizeNodeName(name));
     if (hit) return hit;
   }
   if (ref.humanoid) {
@@ -628,7 +628,7 @@ var SHARED_MODEL_RESOURCE_FLAG = "spatialEcsSharedModelResource";
 var modelCache = /* @__PURE__ */ new Map();
 function markSharedResources(root) {
   root.traverse((child) => {
-    if (!(child instanceof THREE.Mesh)) {
+    if (!(child instanceof THREE6.Mesh)) {
       return;
     }
     if (child.geometry) {
@@ -703,7 +703,7 @@ function createModel({
   payload,
   isEditor
 }) {
-  const anchor = new THREE.Object3D();
+  const anchor = new THREE6.Object3D();
   const modelPath = payload.path ?? "";
   const entityId = createBaseEntity(world, anchor, {
     label: payload.name ?? "Model",
@@ -808,8 +808,17 @@ __name(reloadModelEntity, "reloadModelEntity");
 
 // core/systems/ObjectManagementSystem.ts
 var BONE_SOCKET_FLAG = "__reluBoneSocket";
-var _boneScale = new THREE.Vector3();
-var _anchorScale = new THREE.Vector3();
+var _boneScale = new THREE6.Vector3();
+var _anchorScale = new THREE6.Vector3();
+var _holdPosition = new THREE6.Vector3();
+var _holdRotation = new THREE6.Quaternion();
+var _heldPosition = new THREE6.Vector3();
+var _heldRotation = new THREE6.Quaternion();
+var _holdMatrix = new THREE6.Matrix4();
+var _heldMatrix = new THREE6.Matrix4();
+var _holdEuler = new THREE6.Euler();
+var _unitScale = new THREE6.Vector3(1, 1, 1);
+var _ignoredScale = new THREE6.Vector3();
 function createTransform(input) {
   return new TransformComponent(input);
 }
@@ -836,6 +845,8 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
     this.boneSockets = /* @__PURE__ */ new Map();
     /** Attachments whose bone wasn't found in a given model (skip re-searching every frame). */
     this.boneMisses = /* @__PURE__ */ new Map();
+    /** Attachments with holds, and which one the current clip calls for (`null`: none). */
+    this.boneHolds = /* @__PURE__ */ new Map();
     this.scene = scene;
     this.camera = camera;
     this.isEditor = isEditor;
@@ -848,10 +859,10 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
   }
   getOrCreateAudioListener() {
     const existing = this.camera.userData.ecsAudioListener;
-    if (existing instanceof THREE.AudioListener) {
+    if (existing instanceof THREE6.AudioListener) {
       return existing;
     }
-    const listener = new THREE.AudioListener();
+    const listener = new THREE6.AudioListener();
     this.camera.add(listener);
     this.camera.userData.ecsAudioListener = listener;
     return listener;
@@ -925,7 +936,7 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
     }
     if (dispose && object3d) {
       object3d.traverse((child) => {
-        if (child instanceof THREE.Mesh) {
+        if (child instanceof THREE6.Mesh) {
           if (!child.geometry?.userData?.[SHARED_MODEL_RESOURCE_FLAG]) {
             child.geometry?.dispose();
           }
@@ -1022,6 +1033,9 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
     for (const entityId of [...this.boneSockets.keys()]) {
       if (!world.hasEntity(entityId)) this.dropBoneSocket(entityId);
     }
+    for (const entityId of [...this.boneHolds.keys()]) {
+      if (!world.hasEntity(entityId)) this.boneHolds.delete(entityId);
+    }
     for (const [entityId, object] of worldObjects.entries()) {
       const parentEntityId = world.getComponent(entityId, ParentId)?.value;
       const parentObject = typeof parentEntityId === "number" ? worldObjects.get(parentEntityId) : void 0;
@@ -1055,6 +1069,7 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
     if (!attachment) {
       if (this.boneSockets.has(entityId)) this.dropBoneSocket(entityId);
       this.boneMisses.delete(entityId);
+      this.boneHolds.delete(entityId);
       return null;
     }
     const root = attachment.enabled && parentEntityId !== null ? world.getComponent(parentEntityId, ModelComponent)?.object ?? null : null;
@@ -1062,7 +1077,9 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
       this.dropBoneSocket(entityId);
       return null;
     }
-    const key = `${attachment.bone}|${attachment.humanoid ?? ""}|${attachment.compensateScale}`;
+    const hold = this.boneHolds.get(entityId);
+    const ref = hold?.bone || hold?.humanoid ? hold : attachment;
+    const key = `${ref.bone ?? ""}|${ref.humanoid ?? ""}|${attachment.compensateScale}`;
     const current = this.boneSockets.get(entityId);
     if (current && current.modelUuid === root.uuid && current.key === key && current.socket.parent === current.bone) {
       this.fitSocketScale(world, current, parentEntityId, attachment.compensateScale);
@@ -1071,13 +1088,13 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
     this.dropBoneSocket(entityId);
     const missKey = `${root.uuid}|${key}`;
     if (this.boneMisses.get(entityId) === missKey) return null;
-    const bone = findModelBone(root, attachment);
+    const bone = findModelBone(root, ref);
     if (!bone) {
       this.boneMisses.set(entityId, missKey);
       return null;
     }
     this.boneMisses.delete(entityId);
-    const socket = new THREE.Object3D();
+    const socket = new THREE6.Object3D();
     socket.name = `socket:${bone.name}`;
     socket.userData[BONE_SOCKET_FLAG] = entityId;
     bone.add(socket);
@@ -1109,6 +1126,50 @@ var _ObjectManagementSystem = class _ObjectManagementSystem {
       _anchorScale.z / safe(_boneScale.z)
     );
   }
+  /** Whether {@link applyBoneHold} is managing this attachment. */
+  hasBoneHold(entityId) {
+    return this.boneHolds.has(entityId);
+  }
+  /**
+   * Put an attachment in a hold for the clip now playing (`hold` null: the
+   * attachment's own bone and Transform), moving it to the hold's bone if that
+   * changed. Called each frame, since a socket can be rebuilt under it.
+   */
+  applyBoneHold(world, entityId, hold, hidden) {
+    const before = this.boneHolds.get(entityId) ?? null;
+    this.boneHolds.set(entityId, hold);
+    if ((before?.bone ?? null) !== (hold?.bone ?? null) || (before?.humanoid ?? null) !== (hold?.humanoid ?? null)) {
+      this.boneMisses.delete(entityId);
+      this.reconcileSceneFromWorld(world);
+    }
+    const socket = this.boneSockets.get(entityId)?.socket;
+    if (!socket) return;
+    socket.visible = !hidden;
+    if (!hold?.position && !hold?.rotation) {
+      socket.position.set(0, 0, 0);
+      socket.quaternion.identity();
+      return;
+    }
+    const held = world.getComponent(entityId, TransformComponent);
+    if (!held) return;
+    const own = held.position;
+    _heldPosition.set(own.x, own.y, own.z);
+    _heldRotation.setFromEuler(_holdEuler.set(held.rotation.x, held.rotation.y, held.rotation.z));
+    if (hold.position) _holdPosition.set(hold.position.x, hold.position.y, hold.position.z);
+    else _holdPosition.copy(_heldPosition);
+    if (hold.rotation) {
+      _holdRotation.setFromEuler(_holdEuler.set(hold.rotation.x, hold.rotation.y, hold.rotation.z));
+    } else {
+      _holdRotation.copy(_heldRotation);
+    }
+    _holdMatrix.compose(_holdPosition, _holdRotation, _unitScale).multiply(_heldMatrix.compose(_heldPosition, _heldRotation, _unitScale).invert()).decompose(socket.position, socket.quaternion, _ignoredScale);
+    socket.position.multiply(socket.scale);
+  }
+  /** Stop managing an attachment that no longer has holds, and put it back. */
+  releaseBoneHold(world, entityId) {
+    this.applyBoneHold(world, entityId, null, false);
+    this.boneHolds.delete(entityId);
+  }
   /**
    * Load a model entity's file again and swap it in (the file was rewritten);
    * the entity, its components and children stay, attachments re-home.
@@ -1233,5 +1294,5 @@ __name(_ObjectManagementSystem, "ObjectManagementSystem");
 var ObjectManagementSystem = _ObjectManagementSystem;
 
 export { ObjectManagementSystem, SHARED_MODEL_RESOURCE_FLAG, applyTransform, clearModelCache, createAnimationComponent, createAudioComponent, createBaseEntity, createBoneAttachmentComponent, createCameraComponent, createEntityTypeComponent, createEnvironmentComponent, createGLTFLoader, createIKComponent, createImageComponent, createImageTargetAnchorComponent, createImageTargetComponent, createInstanceSlotComponent, createInstancedMeshComponent, createLightComponent, createMaterialComponent, createMeshComponent, createMeshGeometryComponent, createModel, createModelComponent, createNameComponent, createNetworkIdentityComponent, createNetworkSpawnerComponent, createNetworkTransformComponent, createNetworkedPropsComponent, createObject3DRefComponent, createParentIdComponent, createPhysicsComponent, createPostprocessingComponent, createScriptComponent, createScriptObjectComponent, createSelectableComponent, createSelectionTransformStateComponent, createSpriteComponent, createTransform, createTransformComponent, createUIButtonComponent, createUIPanelComponent, createUISliderComponent, createUITextComponent, createUIToggleComponent, createVRTeleportAreaComponent, createVideoComponent, createXRAnchorComponent, createXRHandPoseComponent, createXRInteractableComponent, createXRInteractorComponent, createXRInteractorSideComponent, createXRRigComponent, findModelBone, listModelBones, loadSharedGltf, resolveDracoDecoderPath, setDracoDecoderPath };
-//# sourceMappingURL=chunk-JEPUCLZX.js.map
-//# sourceMappingURL=chunk-JEPUCLZX.js.map
+//# sourceMappingURL=chunk-QAZCVCMP.js.map
+//# sourceMappingURL=chunk-QAZCVCMP.js.map