murow 0.0.71 → 0.0.72

package/dist/webgpu/cjs/index.js

@@ -95,7 +95,6 @@ __export(src_exports, {
   STATIC_OFFSET_UV_MAX_Y: () => STATIC_OFFSET_UV_MAX_Y,
   STATIC_OFFSET_UV_MIN_X: () => STATIC_OFFSET_UV_MIN_X,
   STATIC_OFFSET_UV_MIN_Y: () => STATIC_OFFSET_UV_MIN_Y,
-  SkeletalAnimation: () => SkeletalAnimation,
   SkinnedStaticMesh: () => SkinnedStaticMesh,
   SpriteAccessor: () => SpriteAccessor,
   SpriteUniforms: () => SpriteUniforms,
@@ -105,14 +104,11 @@ __export(src_exports, {
   StaticSprite: () => StaticSprite,
   WebGPU2DRenderer: () => WebGPU2DRenderer,
   WebGPU3DRenderer: () => WebGPU3DRenderer,
-  computeGridUVs: () => computeGridUVs,
-  computeTexturePackerUVs: () => computeTexturePackerUVs,
   createGeometryDataLayout: () => createGeometryDataLayout,
   createTextureFromBitmap: () => createTextureFromBitmap,
   d: () => d,
   getFieldFloats: () => getFieldFloats,
   inverseLerp: () => inverseLerp,
-  loadImage: () => loadImage,
   remap: () => remap,
   resolveBuiltInGeometry: () => resolveBuiltInGeometry,
   rotate2d: () => rotate2d,
@@ -133,7 +129,7 @@ var std = { ..._std };
 var import_typegpu6 = __toESM(require("typegpu"), 1);
 var d4 = __toESM(require("typegpu/data"), 1);
 var import_free_list2 = require("murow/core/free-list");
-var import_base_2d_renderer = require("murow/renderer/base-2d-renderer");
+var import_renderer2 = require("murow/renderer");
 
 // src/core/constants.ts
 var DYNAMIC_OFFSET_PREV_X = 0;
@@ -652,6 +648,7 @@ function createSpriteFragment(_spriteLayout, textureLayout) {
 }
 
 // src/spritesheet/spritesheet.ts
+var import_renderer = require("murow/renderer");
 var Spritesheet = class {
   constructor(id, texture, textureView, sampler, uvs, width, height) {
     this.id = id;
@@ -676,41 +673,6 @@ var Spritesheet = class {
     return this._height;
   }
 };
-function computeGridUVs(imageWidth, imageHeight, frameWidth, frameHeight) {
-  const cols = Math.floor(imageWidth / frameWidth);
-  const rows = Math.floor(imageHeight / frameHeight);
-  const uvs = [];
-  for (let row = 0; row < rows; row++) {
-    for (let col = 0; col < cols; col++) {
-      uvs.push({
-        minX: col * frameWidth / imageWidth,
-        minY: row * frameHeight / imageHeight,
-        maxX: (col + 1) * frameWidth / imageWidth,
-        maxY: (row + 1) * frameHeight / imageHeight
-      });
-    }
-  }
-  return uvs;
-}
-function computeTexturePackerUVs(data) {
-  const { w, h } = data.meta.size;
-  const uvs = [];
-  for (const key of Object.keys(data.frames)) {
-    const frame = data.frames[key].frame;
-    uvs.push({
-      minX: frame.x / w,
-      minY: frame.y / h,
-      maxX: (frame.x + frame.w) / w,
-      maxY: (frame.y + frame.h) / h
-    });
-  }
-  return uvs;
-}
-async function loadImage(url) {
-  const response = await fetch(url);
-  const blob = await response.blob();
-  return createImageBitmap(blob);
-}
 function createTextureFromBitmap(device, bitmap) {
   const texture = device.createTexture({
     size: [bitmap.width, bitmap.height, 1],
@@ -725,6 +687,9 @@ function createTextureFromBitmap(device, bitmap) {
   return { texture, view: texture.createView() };
 }
 
+// src/2d/renderer.ts
+var import_renderer3 = require("murow/renderer");
+
 // src/geometry/geometry-builder.ts
 var import_typegpu2 = __toESM(require("typegpu"), 1);
 
@@ -2203,9 +2168,23 @@ var ComputeBuilder = class {
 };
 
 // src/2d/renderer.ts
-var WebGPU2DRenderer = class extends import_base_2d_renderer.Base2DRenderer {
+var prefab2DHandles = /* @__PURE__ */ new WeakMap();
+function isPrefab2D(value) {
+  return value.type === "spritesheet";
+}
+function resolveSpritePrefabHandle(prefab) {
+  const h = prefab2DHandles.get(prefab);
+  if (!h) {
+    throw new Error(
+      `Prefab '${prefab.id}' has no GPU handle \u2014 has the renderer's init() been called with this bucket?`
+    );
+  }
+  return h;
+}
+var WebGPU2DRenderer = class extends import_renderer2.Base2DRenderer {
   constructor(canvas, options) {
-    super(canvas, options);
+    const resolvedMaxSprites = options.maxSprites ?? options.maxInstances ?? 1024;
+    super(canvas, { ...options, maxSprites: resolvedMaxSprites });
     this.staticDirty = false;
     // Per-sheet bind groups
     this.sheetBindGroups = /* @__PURE__ */ new Map();
@@ -2214,12 +2193,13 @@ var WebGPU2DRenderer = class extends import_base_2d_renderer.Base2DRenderer {
     this.uniformData = new Float32Array(20);
     this.resizeObserver = null;
     this.resizeCallbacks = [];
+    this._prefabs = options.prefabs ?? null;
     this.camera = new Camera2D(canvas.width || 800, canvas.height || 600);
-    this.freeList = new import_free_list2.FreeList(options.maxSprites);
-    this.batcher = new import_sparse_batcher.SparseBatcher(options.maxSprites);
-    this.dynamicData = new Float32Array(options.maxSprites * DYNAMIC_FLOATS_PER_SPRITE);
-    this.staticData = new Float32Array(options.maxSprites * STATIC_FLOATS_PER_SPRITE);
-    this.slotIndexData = new Uint32Array(options.maxSprites);
+    this.freeList = new import_free_list2.FreeList(resolvedMaxSprites);
+    this.batcher = new import_sparse_batcher.SparseBatcher(resolvedMaxSprites);
+    this.dynamicData = new Float32Array(resolvedMaxSprites * DYNAMIC_FLOATS_PER_SPRITE);
+    this.staticData = new Float32Array(resolvedMaxSprites * STATIC_FLOATS_PER_SPRITE);
+    this.slotIndexData = new Uint32Array(resolvedMaxSprites);
   }
   get device() {
     return this._device;
@@ -2273,9 +2253,25 @@ var WebGPU2DRenderer = class extends import_base_2d_renderer.Base2DRenderer {
     this.rawStaticBuffer = this.root.unwrap(this.staticBuffer);
     this.rawSlotIndexBuffer = this.root.unwrap(this.slotIndexBuffer);
     this.rawUniformBuffer = this.root.unwrap(this.uniformBuffer);
+    if (this._prefabs) {
+      this.uploadPrefabBucket(this._prefabs);
+    }
     this.setupResizeObserver();
     this._initialized = true;
   }
+  /**
+   * Upload every prefab in the bucket to the GPU and stash the resulting
+   * SpritesheetHandle on each prefab so `bucket.get(id)` returns something
+   * usable as a sprite source.
+   */
+  uploadPrefabBucket(bucket) {
+    for (const prefab of bucket.entries()) {
+      if (prefab.type === "spritesheet") {
+        const handle = this.uploadParsedSpritesheet(prefab.parsed);
+        prefab2DHandles.set(prefab, handle);
+      }
+    }
+  }
   setupResizeObserver() {
     const supportsDevicePixelBox = (() => {
       try {
@@ -2329,24 +2325,22 @@ var WebGPU2DRenderer = class extends import_base_2d_renderer.Base2DRenderer {
     this.resizeCallbacks.push(callback);
   }
   async loadSpritesheet(source) {
-    const bitmap = await loadImage(source.image);
-    const { texture, view } = createTextureFromBitmap(this._device, bitmap);
+    const parsed = await (0, import_renderer3.parseSpritesheet)(source);
+    return this.uploadParsedSpritesheet(parsed);
+  }
+  /**
+   * Upload a previously-parsed spritesheet to the GPU. Returns a SpritesheetHandle.
+   * Splitting parse (CPU) from upload (GPU) lets callers parse spritesheets in parallel
+   * before a renderer exists.
+   */
+  uploadParsedSpritesheet(parsed) {
+    const { texture, view } = createTextureFromBitmap(this._device, parsed.bitmap);
     const sampler = this._device.createSampler({
       magFilter: "nearest",
       minFilter: "nearest"
     });
-    let uvs;
-    if (source.data) {
-      const resp = await fetch(source.data);
-      const json = await resp.json();
-      uvs = computeTexturePackerUVs(json);
-    } else if (source.frameWidth && source.frameHeight) {
-      uvs = computeGridUVs(bitmap.width, bitmap.height, source.frameWidth, source.frameHeight);
-    } else {
-      uvs = [{ minX: 0, minY: 0, maxX: 1, maxY: 1 }];
-    }
     const id = this.nextSheetId++;
-    const sheet = new Spritesheet(id, texture, view, sampler, uvs, bitmap.width, bitmap.height);
+    const sheet = new Spritesheet(id, texture, view, sampler, parsed.uvs, parsed.width, parsed.height);
     this.sheets.set(id, sheet);
     const bindGroup = this._device.createBindGroup({
       layout: this.rawTextureLayout,
@@ -2364,18 +2358,20 @@ var WebGPU2DRenderer = class extends import_base_2d_renderer.Base2DRenderer {
       throw new Error(`Max sprites (${this.maxSprites}) reached`);
     const dynBase = slot * DYNAMIC_FLOATS_PER_SPRITE;
     const statBase = slot * STATIC_FLOATS_PER_SPRITE;
-    const x = opts.x ?? 0;
-    const y = opts.y ?? 0;
-    this.dynamicData[dynBase + DYNAMIC_OFFSET_PREV_X] = x;
-    this.dynamicData[dynBase + DYNAMIC_OFFSET_PREV_Y] = y;
-    this.dynamicData[dynBase + DYNAMIC_OFFSET_CURR_X] = x;
-    this.dynamicData[dynBase + DYNAMIC_OFFSET_CURR_Y] = y;
+    const sheet = isPrefab2D(opts.sheet) ? resolveSpritePrefabHandle(opts.sheet) : opts.sheet;
+    const [px, py] = opts.position ?? [0, 0];
+    this.dynamicData[dynBase + DYNAMIC_OFFSET_PREV_X] = px;
+    this.dynamicData[dynBase + DYNAMIC_OFFSET_PREV_Y] = py;
+    this.dynamicData[dynBase + DYNAMIC_OFFSET_CURR_X] = px;
+    this.dynamicData[dynBase + DYNAMIC_OFFSET_CURR_Y] = py;
     const rotation = opts.rotation ?? 0;
     this.dynamicData[dynBase + DYNAMIC_OFFSET_PREV_ROTATION] = rotation;
     this.dynamicData[dynBase + DYNAMIC_OFFSET_CURR_ROTATION] = rotation;
-    this.staticData[statBase + STATIC_OFFSET_SCALE_X] = opts.scaleX ?? 1;
-    this.staticData[statBase + STATIC_OFFSET_SCALE_Y] = opts.scaleY ?? 1;
-    const uv = opts.sheet.getUV(opts.sprite ?? 0);
+    const s = opts.scale;
+    const [sx, sy] = typeof s === "number" ? [s, s] : s ?? [1, 1];
+    this.staticData[statBase + STATIC_OFFSET_SCALE_X] = sx;
+    this.staticData[statBase + STATIC_OFFSET_SCALE_Y] = sy;
+    const uv = sheet.getUV(opts.sprite ?? 0);
     this.staticData[statBase + STATIC_OFFSET_UV_MIN_X] = uv.minX;
     this.staticData[statBase + STATIC_OFFSET_UV_MIN_Y] = uv.minY;
     this.staticData[statBase + STATIC_OFFSET_UV_MAX_X] = uv.maxX;
@@ -2390,12 +2386,12 @@ var WebGPU2DRenderer = class extends import_base_2d_renderer.Base2DRenderer {
     this.staticData[statBase + STATIC_OFFSET_TINT_B] = tint[2];
     this.staticData[statBase + STATIC_OFFSET_TINT_A] = tint[3];
     this.staticDirty = true;
-    this.batcher.add(opts.layer ?? 0, opts.sheet.id, slot);
+    this.batcher.add(opts.layer ?? 0, sheet.id, slot);
     return new SpriteAccessor(
       this.dynamicData,
       this.staticData,
       slot,
-      opts.sheet.id,
+      sheet.id,
       () => {
         this.staticDirty = true;
       }
@@ -2517,9 +2513,112 @@ var WebGPU2DRenderer = class extends import_base_2d_renderer.Base2DRenderer {
   }
 };
 
+// src/2d/animation.ts
+var AnimationController = class {
+  constructor() {
+    this.clips = [];
+    this.clipsByName = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Register an animation clip. Returns the clip ID.
+   */
+  loadClip(config) {
+    const id = this.clips.length;
+    const clip = {
+      id,
+      name: config.name,
+      frames: new Uint16Array(config.frames),
+      durations: new Float32Array(config.durations),
+      frameCount: config.frames.length,
+      totalDuration: config.durations.reduce((sum, d7) => sum + d7, 0),
+      loop: config.loop
+    };
+    this.clips.push(clip);
+    this.clipsByName.set(config.name, id);
+    return id;
+  }
+  /**
+   * Get a clip by name.
+   */
+  getClipId(name) {
+    const id = this.clipsByName.get(name);
+    if (id === void 0)
+      throw new Error(`Animation clip "${name}" not found`);
+    return id;
+  }
+  /**
+   * Get a clip by ID.
+   */
+  getClip(id) {
+    return this.clips[id];
+  }
+  /**
+   * Create a new animation state for an entity. This is the per-entity data
+   * that tracks playback progress. Store it however you like (flat array, component, etc).
+   */
+  createState(clipId, speed = 1, playing = true) {
+    return { clipId, frame: 0, time: 0, speed, playing };
+  }
+  /**
+   * Advance an animation state by deltaTime (in seconds).
+   * Returns the current sprite frame ID, or -1 if not playing.
+   * Zero allocations.
+   */
+  update(state, deltaTime) {
+    if (!state.playing) {
+      return this.clips[state.clipId].frames[state.frame];
+    }
+    const clip = this.clips[state.clipId];
+    state.time += deltaTime * state.speed * 1e3;
+    while (state.time >= clip.durations[state.frame]) {
+      state.time -= clip.durations[state.frame];
+      state.frame++;
+      if (state.frame >= clip.frameCount) {
+        if (clip.loop) {
+          state.frame = 0;
+        } else {
+          state.frame = clip.frameCount - 1;
+          state.playing = false;
+          break;
+        }
+      }
+    }
+    return clip.frames[state.frame];
+  }
+  /**
+   * Play a different clip on an existing state. Resets frame and time.
+   */
+  play(state, clipId, speed) {
+    state.clipId = clipId;
+    state.frame = 0;
+    state.time = 0;
+    state.playing = true;
+    if (speed !== void 0)
+      state.speed = speed;
+  }
+  /**
+   * Stop playback.
+   */
+  stop(state) {
+    state.playing = false;
+  }
+  /**
+   * Resume playback.
+   */
+  resume(state) {
+    state.playing = true;
+  }
+  /**
+   * Number of loaded clips.
+   */
+  get clipCount() {
+    return this.clips.length;
+  }
+};
+
 // src/3d/renderer.ts
 var import_typegpu9 = __toESM(require("typegpu"), 1);
-var import_base_3d_renderer = require("murow/renderer/base-3d-renderer");
+var import_renderer4 = require("murow/renderer");
 var import_free_list3 = require("murow/core/free-list");
 var import_sparse_batcher2 = require("murow/core/sparse-batcher");
 
@@ -3164,661 +3263,8 @@ function createSkinnedMeshVertex(layout) {
   });
 }
 
-// src/core/math.ts
-function mat4IdentityNew() {
-  const m = new Float32Array(16);
-  m[0] = 1;
-  m[5] = 1;
-  m[10] = 1;
-  m[15] = 1;
-  return m;
-}
-function trsToMat4(tx, ty, tz, qx, qy, qz, qw, sx, sy, sz, dst, offset) {
-  const xx = qx * qx, yy = qy * qy, zz = qz * qz;
-  const xy = qx * qy, xz = qx * qz, yz = qy * qz;
-  const wx = qw * qx, wy = qw * qy, wz = qw * qz;
-  dst[offset] = (1 - 2 * (yy + zz)) * sx;
-  dst[offset + 1] = 2 * (xy + wz) * sx;
-  dst[offset + 2] = 2 * (xz - wy) * sx;
-  dst[offset + 3] = 0;
-  dst[offset + 4] = 2 * (xy - wz) * sy;
-  dst[offset + 5] = (1 - 2 * (xx + zz)) * sy;
-  dst[offset + 6] = 2 * (yz + wx) * sy;
-  dst[offset + 7] = 0;
-  dst[offset + 8] = 2 * (xz + wy) * sz;
-  dst[offset + 9] = 2 * (yz - wx) * sz;
-  dst[offset + 10] = (1 - 2 * (xx + yy)) * sz;
-  dst[offset + 11] = 0;
-  dst[offset + 12] = tx;
-  dst[offset + 13] = ty;
-  dst[offset + 14] = tz;
-  dst[offset + 15] = 1;
-}
-function nodeToMat4(node) {
-  const m = new Float32Array(16);
-  if (node.matrix) {
-    m.set(node.matrix);
-    return m;
-  }
-  const t = node.translation ?? [0, 0, 0];
-  const r = node.rotation ?? [0, 0, 0, 1];
-  const s = node.scale ?? [1, 1, 1];
-  trsToMat4(t[0], t[1], t[2], r[0], r[1], r[2], r[3], s[0], s[1], s[2], m, 0);
-  return m;
-}
-var _mulTemp = new Float32Array(16);
-function mat4Mul(a, aO, b, bO, dst, dO) {
-  for (let i = 0; i < 4; i++) {
-    for (let j = 0; j < 4; j++) {
-      _mulTemp[j * 4 + i] = a[aO + i] * b[bO + j * 4] + a[aO + 4 + i] * b[bO + j * 4 + 1] + a[aO + 8 + i] * b[bO + j * 4 + 2] + a[aO + 12 + i] * b[bO + j * 4 + 3];
-    }
-  }
-  dst.set(_mulTemp, dO);
-}
-function mat4MulNew(a, b) {
-  const o = new Float32Array(16);
-  for (let i = 0; i < 4; i++) {
-    for (let j = 0; j < 4; j++) {
-      o[j * 4 + i] = a[i] * b[j * 4] + a[4 + i] * b[j * 4 + 1] + a[8 + i] * b[j * 4 + 2] + a[12 + i] * b[j * 4 + 3];
-    }
-  }
-  return o;
-}
-
-// src/3d/gltf-skin-parser.ts
-function parseSkin(gltf, skinIndex, getAccessorData) {
-  const skin = gltf.skins[skinIndex];
-  const joints = skin.joints;
-  const jointCount = joints.length;
-  const ibmAccess = getAccessorData(skin.inverseBindMatrices);
-  const inverseBindMatrices = new Float32Array(ibmAccess.data);
-  const jointNodeIndices = new Uint16Array(joints);
-  const nodeToJoint = /* @__PURE__ */ new Map();
-  for (let j = 0; j < jointCount; j++) {
-    nodeToJoint.set(joints[j], j);
-  }
-  const nodeParent = /* @__PURE__ */ new Map();
-  for (let i = 0; i < gltf.nodes.length; i++) {
-    const children = gltf.nodes[i].children;
-    if (children) {
-      for (const child of children) {
-        nodeParent.set(child, i);
-      }
-    }
-  }
-  const parentJointIndices = new Int16Array(jointCount).fill(-1);
-  for (let j = 0; j < jointCount; j++) {
-    let parentNode = nodeParent.get(joints[j]);
-    while (parentNode !== void 0) {
-      const parentJoint = nodeToJoint.get(parentNode);
-      if (parentJoint !== void 0) {
-        parentJointIndices[j] = parentJoint;
-        break;
-      }
-      parentNode = nodeParent.get(parentNode);
-    }
-  }
-  let skeletonRootMatrix = null;
-  for (let j = 0; j < jointCount; j++) {
-    if (parentJointIndices[j] !== -1)
-      continue;
-    let ancestorNode = nodeParent.get(joints[j]);
-    const ancestorChain = [];
-    while (ancestorNode !== void 0 && !nodeToJoint.has(ancestorNode)) {
-      ancestorChain.push(ancestorNode);
-      ancestorNode = nodeParent.get(ancestorNode);
-    }
-    if (ancestorChain.length > 0) {
-      skeletonRootMatrix = mat4IdentityNew();
-      for (let i = ancestorChain.length - 1; i >= 0; i--) {
-        const nodeMat = nodeToMat4(gltf.nodes[ancestorChain[i]]);
-        skeletonRootMatrix = mat4MulNew(skeletonRootMatrix, nodeMat);
-      }
-    }
-    break;
-  }
-  return {
-    jointCount,
-    jointNodeIndices,
-    inverseBindMatrices,
-    parentJointIndices,
-    skeletonRootMatrix
-  };
-}
-function parseAnimations(gltf, skinData, getAccessorData) {
-  if (!gltf.animations?.length)
-    return [];
-  const nodeToJoint = /* @__PURE__ */ new Map();
-  for (let j = 0; j < skinData.jointCount; j++) {
-    nodeToJoint.set(skinData.jointNodeIndices[j], j);
-  }
-  const clips = [];
-  for (const anim of gltf.animations) {
-    const channels = [];
-    let maxTime = 0;
-    for (const channel of anim.channels) {
-      const targetNode = channel.target.node;
-      const jointIndex = nodeToJoint.get(targetNode);
-      if (jointIndex === void 0)
-        continue;
-      const path = channel.target.path;
-      if (path !== "translation" && path !== "rotation" && path !== "scale")
-        continue;
-      const sampler = anim.samplers[channel.sampler];
-      const interpolation = sampler.interpolation ?? "LINEAR";
-      if (interpolation !== "LINEAR" && interpolation !== "STEP")
-        continue;
-      const inputAccess = getAccessorData(sampler.input);
-      const timestamps = new Float32Array(inputAccess.data);
-      const outputAccess = getAccessorData(sampler.output);
-      const values = new Float32Array(outputAccess.data);
-      if (timestamps.length > 0) {
-        const lastTime = timestamps[timestamps.length - 1];
-        if (lastTime > maxTime)
-          maxTime = lastTime;
-      }
-      channels.push({
-        jointIndex,
-        path,
-        timestamps,
-        values,
-        interpolation
-      });
-    }
-    if (channels.length > 0) {
-      clips.push({
-        name: anim.name ?? `animation_${clips.length}`,
-        duration: maxTime,
-        channels
-      });
-    }
-  }
-  return clips;
-}
-function parsePrimitiveSkinAttributes(primitive, getAccessorData) {
-  if (primitive.attributes.JOINTS_0 === void 0 || primitive.attributes.WEIGHTS_0 === void 0) {
-    return null;
-  }
-  const jointsAccess = getAccessorData(primitive.attributes.JOINTS_0);
-  const weightsAccess = getAccessorData(primitive.attributes.WEIGHTS_0);
-  const joints = jointsAccess.data instanceof Uint16Array ? jointsAccess.data : new Uint16Array(jointsAccess.data);
-  let weights;
-  if (weightsAccess.data instanceof Float32Array) {
-    weights = weightsAccess.data;
-  } else if (weightsAccess.data instanceof Uint8Array) {
-    weights = new Float32Array(weightsAccess.data.length);
-    for (let i = 0; i < weightsAccess.data.length; i++) {
-      weights[i] = weightsAccess.data[i] / 255;
-    }
-  } else if (weightsAccess.data instanceof Uint16Array) {
-    weights = new Float32Array(weightsAccess.data.length);
-    for (let i = 0; i < weightsAccess.data.length; i++) {
-      weights[i] = weightsAccess.data[i] / 65535;
-    }
-  } else {
-    weights = new Float32Array(weightsAccess.data);
-  }
-  return { joints, weights };
-}
-function getNodeTRS(node) {
-  const trs = new Float32Array(10);
-  if (node.matrix) {
-    trs[0] = node.matrix[12];
-    trs[1] = node.matrix[13];
-    trs[2] = node.matrix[14];
-    trs[3] = 0;
-    trs[4] = 0;
-    trs[5] = 0;
-    trs[6] = 1;
-    trs[7] = 1;
-    trs[8] = 1;
-    trs[9] = 1;
-    return trs;
-  }
-  const t = node.translation ?? [0, 0, 0];
-  const r = node.rotation ?? [0, 0, 0, 1];
-  const s = node.scale ?? [1, 1, 1];
-  trs[0] = t[0];
-  trs[1] = t[1];
-  trs[2] = t[2];
-  trs[3] = r[0];
-  trs[4] = r[1];
-  trs[5] = r[2];
-  trs[6] = r[3];
-  trs[7] = s[0];
-  trs[8] = s[1];
-  trs[9] = s[2];
-  return trs;
-}
-function createPackedAnimationData() {
-  return {
-    channels: [],
-    keyframeData: [],
-    clips: [],
-    skins: [],
-    parentIndices: [],
-    topoOrder: [],
-    ibmData: [],
-    restTRS: [],
-    skelRootMats: [],
-    jointChannelLookup: []
-  };
-}
-function packSkinAndAnimations(packed, skinData, clips, gltfNodes) {
-  const skinIndex = packed.skins.length;
-  const jc = skinData.jointCount;
-  const parentOffset = packed.parentIndices.length;
-  const topoOffset = packed.topoOrder.length;
-  const ibmOffset = packed.ibmData.length / 16;
-  const restTRSOffset = packed.restTRS.length / 10;
-  const skelRootMatIndex = packed.skelRootMats.length / 16;
-  for (let j = 0; j < jc; j++) {
-    packed.parentIndices.push(skinData.parentJointIndices[j]);
-  }
-  const visited = new Uint8Array(jc);
-  const visit = (j) => {
-    if (visited[j])
-      return;
-    visited[j] = 1;
-    const parent = skinData.parentJointIndices[j];
-    if (parent !== -1)
-      visit(parent);
-    packed.topoOrder.push(j);
-  };
-  for (let j = 0; j < jc; j++)
-    visit(j);
-  for (let i = 0; i < skinData.inverseBindMatrices.length; i++) {
-    packed.ibmData.push(skinData.inverseBindMatrices[i]);
-  }
-  for (let j = 0; j < jc; j++) {
-    const trs = getNodeTRS(gltfNodes[skinData.jointNodeIndices[j]]);
-    for (let k = 0; k < 10; k++)
-      packed.restTRS.push(trs[k]);
-  }
-  if (skinData.skeletonRootMatrix) {
-    for (let i = 0; i < 16; i++)
-      packed.skelRootMats.push(skinData.skeletonRootMatrix[i]);
-  } else {
-    const id = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
-    for (let i = 0; i < 16; i++)
-      packed.skelRootMats.push(id[i]);
-  }
-  const clipOffset = packed.clips.length;
-  const jointLookupStart = packed.jointChannelLookup.length;
-  packed.skins.push({ jointCount: jc, parentOffset, topoOffset, ibmOffset, restTRSOffset, skelRootMatIndex, clipOffset, jointLookupStart });
-  const nodeToJoint = /* @__PURE__ */ new Map();
-  for (let j = 0; j < jc; j++) {
-    nodeToJoint.set(skinData.jointNodeIndices[j], j);
-  }
-  for (const clip of clips) {
-    const channelStart = packed.channels.length;
-    const sortedChannels = [...clip.channels].sort((a, b) => a.jointIndex - b.jointIndex);
-    for (const ch of sortedChannels) {
-      const pathCode = ch.path === "translation" ? 0 : ch.path === "rotation" ? 1 : 2;
-      const isStep = ch.interpolation === "STEP" ? 4 : 0;
-      const dataOffset = packed.keyframeData.length;
-      const n = ch.timestamps.length;
-      const compCount = ch.path === "rotation" ? 4 : 3;
-      for (let i = 0; i < n; i++)
-        packed.keyframeData.push(ch.timestamps[i]);
-      for (let i = 0; i < n * compCount; i++)
-        packed.keyframeData.push(ch.values[i]);
-      packed.channels.push({
-        jointIndex: ch.jointIndex,
-        pathAndInterp: pathCode | isStep,
-        keyframeCount: n,
-        dataOffset
-      });
-    }
-    const clipChannelCount = sortedChannels.length;
-    let ci = 0;
-    for (let j = 0; j < jc; j++) {
-      const lookupStart = ci;
-      while (ci < clipChannelCount && sortedChannels[ci].jointIndex === j)
-        ci++;
-      packed.jointChannelLookup.push(channelStart + lookupStart);
-      packed.jointChannelLookup.push(ci - lookupStart);
-    }
-    packed.clips.push({
-      channelStart,
-      channelCount: clipChannelCount,
-      duration: clip.duration,
-      looping: 1
-    });
-  }
-  return skinIndex;
-}
-
-// src/3d/skeletal-animation.ts
-var SkeletalAnimation = class {
-  // 16 floats, identity if no non-joint ancestors
-  constructor(skinData, clips, gltfNodes) {
-    this.clips = [];
-    this.clipsByName = /* @__PURE__ */ new Map();
-    this._scratchVec3 = new Float32Array(3);
-    this._scratchQuat = new Float32Array(4);
-    this.skinData = skinData;
-    const jc = skinData.jointCount;
-    this.localMatrices = new Float32Array(jc * 16);
-    this.worldMatrices = new Float32Array(jc * 16);
-    this.blendScratch = new Float32Array(jc * 16);
-    this.originalRestPoseTRS = new Float32Array(jc * 10);
-    this.currentTRS = new Float32Array(jc * 10);
-    for (let j = 0; j < jc; j++) {
-      const nodeTRS = getNodeTRS(gltfNodes[skinData.jointNodeIndices[j]]);
-      this.originalRestPoseTRS.set(nodeTRS, j * 10);
-    }
-    this.skelRootMat = new Float32Array(16);
-    if (skinData.skeletonRootMatrix) {
-      this.skelRootMat.set(skinData.skeletonRootMatrix);
-    } else {
-      this.skelRootMat[0] = 1;
-      this.skelRootMat[5] = 1;
-      this.skelRootMat[10] = 1;
-      this.skelRootMat[15] = 1;
-    }
-    this.topoOrder = new Uint16Array(jc);
-    const visited = new Uint8Array(jc);
-    let writeIdx = 0;
-    const visit = (j) => {
-      if (visited[j])
-        return;
-      visited[j] = 1;
-      const parent = skinData.parentJointIndices[j];
-      if (parent !== -1)
-        visit(parent);
-      this.topoOrder[writeIdx++] = j;
-    };
-    for (let j = 0; j < jc; j++)
-      visit(j);
-    for (const clip of clips) {
-      this.loadClip(clip);
-    }
-  }
-  loadClip(clip, loop = true) {
-    const id = this.clips.length;
-    this.clips.push({
-      id,
-      name: clip.name,
-      duration: clip.duration,
-      channels: clip.channels,
-      loop
-    });
-    this.clipsByName.set(clip.name, id);
-    return id;
-  }
-  getClipId(name) {
-    const id = this.clipsByName.get(name);
-    if (id === void 0)
-      throw new Error(`Skeletal clip "${name}" not found`);
-    return id;
-  }
-  getClipNames() {
-    return this.clips.map((c) => c.name);
-  }
-  getClip(id) {
-    return this.clips[id] ?? null;
-  }
-  get clipCount() {
-    return this.clips.length;
-  }
-  createState(clipIdOrName, speed = 1, playing = true) {
-    const clipId = typeof clipIdOrName === "string" ? this.getClipId(clipIdOrName) : clipIdOrName;
-    return { clipId, time: 0, speed, playing, loop: true, prevClipId: -1, prevTime: 0, prevSpeed: 1, blendWeight: 1, blendDuration: 0, onEnd: () => null };
-  }
-  play(state, clipIdOrName, opts) {
-    const newClipId = typeof clipIdOrName === "string" ? this.getClipId(clipIdOrName) : clipIdOrName;
-    const crossfade = opts?.crossfade ?? 0;
-    if (crossfade > 0 && state.playing) {
-      state.prevClipId = state.clipId;
-      state.prevTime = state.time;
-      state.prevSpeed = state.speed;
-      state.blendWeight = 0;
-      state.blendDuration = crossfade;
-    } else {
-      state.prevClipId = -1;
-      state.blendWeight = 1;
-      state.blendDuration = 0;
-    }
-    state.onEnd = opts?.onEnd ?? (() => null);
-    state.loop = opts?.loop ?? true;
-    state.clipId = newClipId;
-    state.time = 0;
-    state.playing = true;
-    if (opts?.speed !== void 0)
-      state.speed = opts.speed;
-  }
-  stop(state) {
-    state.playing = false;
-  }
-  resume(state) {
-    state.playing = true;
-  }
-  /**
-   * Advance time and compute bone matrices.
-   * Writes jointCount mat4s into `output` starting at float index `outputOffset`.
-   * Handles crossfade blending automatically.
-   */
-  update(state, deltaTime, output, outputOffset = 0) {
-    const jc = this.skinData.jointCount;
-    if (state.playing) {
-      this.advanceTime(state, deltaTime);
-    }
-    const blending = state.prevClipId !== -1 && state.blendDuration > 0 && state.blendWeight < 1;
-    if (blending) {
-      state.blendWeight += deltaTime / state.blendDuration;
-      if (state.blendWeight >= 1) {
-        state.blendWeight = 1;
-        state.prevClipId = -1;
-        state.blendDuration = 0;
-      }
-    }
-    if (blending && state.prevClipId !== -1) {
-      const prevClip = this.clips[state.prevClipId];
-      if (prevClip) {
-        state.prevTime += deltaTime * state.prevSpeed;
-        if (prevClip.loop && state.prevTime >= prevClip.duration) {
-          state.prevTime %= prevClip.duration;
-        }
-      }
-      this.evaluateClip(state.prevClipId, state.prevTime, this.blendScratch, 0);
-      this.evaluateClip(state.clipId, state.time, output, outputOffset);
-      const w = state.blendWeight;
-      const oneMinusW = 1 - w;
-      const scratch = this.blendScratch;
-      const floatCount = jc * 16;
-      for (let i = 0; i < floatCount; i++) {
-        output[outputOffset + i] = scratch[i] * oneMinusW + output[outputOffset + i] * w;
-      }
-    } else {
-      this.evaluateClip(state.clipId, state.time, output, outputOffset);
-    }
-  }
-  /** Advance clip time with looping/clamping. */
-  advanceTime(state, deltaTime) {
-    const clip = this.clips[state.clipId];
-    if (!clip || clip.duration <= 0)
-      return;
-    state.time += deltaTime * state.speed;
-    if (state.time >= clip.duration) {
-      if (clip.loop)
-        state.time %= clip.duration;
-      else {
-        state.time = clip.duration - 1e-4;
-        state.playing = false;
-      }
-    }
-    if (state.time < 0) {
-      if (clip.loop)
-        state.time = clip.duration + state.time % clip.duration;
-      else {
-        state.time = 0;
-        state.playing = false;
-      }
-    }
-  }
-  /** Evaluate a clip at a specific time and write bone matrices. */
-  evaluateClip(clipId, time, output, outputOffset) {
-    const clip = this.clips[clipId];
-    if (!clip)
-      return;
-    const skin = this.skinData;
-    const jc = skin.jointCount;
-    const local = this.localMatrices;
-    const world = this.worldMatrices;
-    const cur = this.currentTRS;
-    cur.set(this.originalRestPoseTRS);
-    for (const ch of clip.channels) {
-      const j = ch.jointIndex;
-      if (j >= jc)
-        continue;
-      const ro = j * 10;
-      const sampled = this.sampleChannel(ch, time);
-      if (ch.path === "translation") {
-        cur[ro] = sampled[0];
-        cur[ro + 1] = sampled[1];
-        cur[ro + 2] = sampled[2];
-      } else if (ch.path === "rotation") {
-        cur[ro + 3] = sampled[0];
-        cur[ro + 4] = sampled[1];
-        cur[ro + 5] = sampled[2];
-        cur[ro + 6] = sampled[3];
-      } else if (ch.path === "scale") {
-        cur[ro + 7] = sampled[0];
-        cur[ro + 8] = sampled[1];
-        cur[ro + 9] = sampled[2];
-      }
-    }
-    for (let j = 0; j < jc; j++) {
-      const ro = j * 10;
-      trsToMat4(
-        cur[ro],
-        cur[ro + 1],
-        cur[ro + 2],
-        cur[ro + 3],
-        cur[ro + 4],
-        cur[ro + 5],
-        cur[ro + 6],
-        cur[ro + 7],
-        cur[ro + 8],
-        cur[ro + 9],
-        local,
-        j * 16
-      );
-    }
-    const topo = this.topoOrder;
-    const srm = this.skelRootMat;
-    for (let i = 0; i < jc; i++) {
-      const j = topo[i];
-      const parentJ = skin.parentJointIndices[j];
-      if (parentJ === -1) {
-        mat4Mul(srm, 0, local, j * 16, world, j * 16);
-      } else {
-        mat4Mul(world, parentJ * 16, local, j * 16, world, j * 16);
-      }
-    }
-    const ibm = skin.inverseBindMatrices;
-    for (let j = 0; j < jc; j++) {
-      mat4Mul(world, j * 16, ibm, j * 16, output, outputOffset + j * 16);
-    }
-  }
-  /**
-   * Compute bone matrices for the rest/bind pose (no animation).
-   */
-  computeRestPose(output, outputOffset = 0) {
-    const skin = this.skinData;
-    const jc = skin.jointCount;
-    const local = this.localMatrices;
-    const world = this.worldMatrices;
-    const rest = this.originalRestPoseTRS;
-    for (let j = 0; j < jc; j++) {
-      const ro = j * 10;
-      trsToMat4(
-        rest[ro],
-        rest[ro + 1],
-        rest[ro + 2],
-        rest[ro + 3],
-        rest[ro + 4],
-        rest[ro + 5],
-        rest[ro + 6],
-        rest[ro + 7],
-        rest[ro + 8],
-        rest[ro + 9],
-        local,
-        j * 16
-      );
-    }
-    const topo = this.topoOrder;
-    const srm = this.skelRootMat;
-    for (let i = 0; i < jc; i++) {
-      const j = topo[i];
-      const parentJ = skin.parentJointIndices[j];
-      if (parentJ === -1) {
-        mat4Mul(srm, 0, local, j * 16, world, j * 16);
-      } else {
-        mat4Mul(world, parentJ * 16, local, j * 16, world, j * 16);
-      }
-    }
-    const ibm = skin.inverseBindMatrices;
-    for (let j = 0; j < jc; j++) {
-      mat4Mul(world, j * 16, ibm, j * 16, output, outputOffset + j * 16);
-    }
-  }
-  // --- Private helpers (zero-alloc, operate on Float32Array sub-regions) ---
-  /** Sample an animation channel at time t. Returns 3 or 4 floats. */
-  sampleChannel(ch, t) {
-    const ts = ch.timestamps;
-    const vals = ch.values;
-    const compCount = ch.path === "rotation" ? 4 : 3;
-    if (t <= ts[0])
-      return vals.subarray(0, compCount);
-    if (t >= ts[ts.length - 1])
-      return vals.subarray((ts.length - 1) * compCount, ts.length * compCount);
-    let lo = 0, hi = ts.length - 1;
-    while (lo < hi - 1) {
-      const mid = lo + hi >> 1;
-      if (ts[mid] <= t)
-        lo = mid;
-      else
-        hi = mid;
-    }
-    if (ch.interpolation === "STEP") {
-      return vals.subarray(lo * compCount, lo * compCount + compCount);
-    }
-    const t0 = ts[lo], t1 = ts[hi];
-    const f = t1 > t0 ? (t - t0) / (t1 - t0) : 0;
-    const a = lo * compCount;
-    const b = hi * compCount;
-    if (ch.path === "rotation") {
-      return this.nlerpQuat(vals, a, vals, b, f);
-    }
-    const out = this._scratchVec3;
-    out[0] = vals[a] + (vals[b] - vals[a]) * f;
-    out[1] = vals[a + 1] + (vals[b + 1] - vals[a + 1]) * f;
-    out[2] = vals[a + 2] + (vals[b + 2] - vals[a + 2]) * f;
-    return out;
-  }
-  /** Normalized lerp for quaternions (nlerp). */
-  nlerpQuat(a, ao, b, bo, t) {
-    const out = this._scratchQuat;
-    let dot2 = a[ao] * b[bo] + a[ao + 1] * b[bo + 1] + a[ao + 2] * b[bo + 2] + a[ao + 3] * b[bo + 3];
-    const sign = dot2 < 0 ? -1 : 1;
-    const oneMinusT = 1 - t;
-    out[0] = oneMinusT * a[ao] + t * b[bo] * sign;
-    out[1] = oneMinusT * a[ao + 1] + t * b[bo + 1] * sign;
-    out[2] = oneMinusT * a[ao + 2] + t * b[bo + 2] * sign;
-    out[3] = oneMinusT * a[ao + 3] + t * b[bo + 3] * sign;
-    const len = Math.sqrt(out[0] * out[0] + out[1] * out[1] + out[2] * out[2] + out[3] * out[3]);
-    if (len > 0) {
-      const inv = 1 / len;
-      out[0] *= inv;
-      out[1] *= inv;
-      out[2] *= inv;
-      out[3] *= inv;
-    }
-    return out;
-  }
-};
+// src/3d/renderer.ts
+var import_renderer5 = require("murow/renderer");
 
 // src/3d/skeletal-animation-compute/packer.ts
 function packAnimationData(packed) {
@@ -3900,14 +3346,14 @@ function packAnimationData(packed) {
 
 // src/3d/skeletal-animation-compute/kernel.ts
 var WORKGROUP_SIZE = 64;
-function buildAnimationKernel(root, packed, maxInstances, maxTotalBones) {
+function buildAnimationKernel(root, packed, maxInstances, maxTotalBones, budgets) {
   const pb = packAnimationData(packed);
   const kernel = new ComputeBuilder("skeletal-animation", { workgroupSize: WORKGROUP_SIZE }, root).buffers({
     uniforms: { uniform: AnimComputeUniforms },
     instances: { storage: d.arrayOf(InstanceAnimStateGPU, maxInstances) },
-    skelI32: { storage: d.arrayOf(d.i32, pb.skelI32.length) },
-    animF32: { storage: d.arrayOf(d.f32, pb.animF32.length) },
-    matrices: { storage: d.arrayOf(d.mat4x4f, pb.totalMats) },
+    skelI32: { storage: d.arrayOf(d.i32, budgets.skelI32Capacity) },
+    animF32: { storage: d.arrayOf(d.f32, budgets.animF32Capacity) },
+    matrices: { storage: d.arrayOf(d.mat4x4f, budgets.matricesCapacity) },
     boneMatrices: { storage: d.arrayOf(d.mat4x4f, maxTotalBones), readwrite: true }
   }).shader(({ uniforms, instances, skelI32, animF32, matrices, boneMatrices }, { globalId }) => {
     const idx = globalId.x;
@@ -4249,14 +3695,51 @@ function buildAnimationKernel(root, packed, maxInstances, maxTotalBones) {
       }
     }
   }).build();
-  kernel.write("skelI32", Array.from(pb.skelI32));
-  kernel.write("animF32", Array.from(pb.animF32));
-  const matBuffer = kernel.getBuffer("matrices");
-  const rawMatBuffer = root.unwrap(matBuffer);
-  root.device.queue.writeBuffer(rawMatBuffer, 0, pb.matFloats);
-  return { kernel, packedBuffers: pb };
+  uploadPackedToKernel(root, kernel, pb);
+  return { kernel, packedBuffers: pb, budgets };
+}
+function uploadPackedToKernel(root, kernel, pb) {
+  const queue = root.device.queue;
+  const skelBuf = root.unwrap(kernel.getBuffer("skelI32"));
+  queue.writeBuffer(skelBuf, 0, pb.skelI32);
+  const animBuf = root.unwrap(kernel.getBuffer("animF32"));
+  queue.writeBuffer(animBuf, 0, pb.animF32);
+  const matBuf = root.unwrap(kernel.getBuffer("matrices"));
+  queue.writeBuffer(matBuf, 0, pb.matFloats);
 }
 
+// src/3d/clip-resync-coordinator.ts
+var GltfClipResyncCoordinator = class {
+  constructor(bucket) {
+    this.bucket = bucket;
+    this.skinIndexByPrefabId = /* @__PURE__ */ new Map();
+    this._pending = /* @__PURE__ */ new Set();
+    this.bucket.events.on("clips-changed", ({ prefabId }) => {
+      const skinIndex = this.skinIndexByPrefabId.get(prefabId);
+      if (skinIndex !== void 0)
+        this._pending.add(skinIndex);
+    });
+  }
+  /** Map a prefab id to its index in the renderer's `skinnedModels` list. */
+  registerSkin(prefabId, skinIndex) {
+    this.skinIndexByPrefabId.set(prefabId, skinIndex);
+  }
+  /** Skin indices whose clip set has changed since the last `clear()`. */
+  get pending() {
+    return this._pending;
+  }
+  clear() {
+    this._pending.clear();
+  }
+  /** Unsubscribe from the bucket and reset its animation clip sets. */
+  dispose() {
+    this.bucket.events.clear("clips-changed");
+    this.bucket.resetAnimations();
+    this.skinIndexByPrefabId.clear();
+    this._pending.clear();
+  }
+};
+
 // src/3d/renderer.ts
 var DYN_PREV_PX = 0;
 var DYN_PREV_PY = 1;
@@ -4283,9 +3766,44 @@ var SSTAT_CR = 3;
 var SSTAT_CG = 4;
 var SSTAT_CB = 5;
 var SSTAT_BONE_OFFSET = 6;
-var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
+var prefabHandles = /* @__PURE__ */ new WeakMap();
+function isPrefab3D(value) {
+  return value.type === "gltf" || value.type === "grid";
+}
+function resolveTransform(opts) {
+  const [px, py, pz] = opts.position ?? [0, 0, 0];
+  const [rx, ry, rz] = opts.rotation ?? [0, 0, 0];
+  const s = opts.scale;
+  const [sx, sy, sz] = typeof s === "number" ? [s, s, s] : s ?? [1, 1, 1];
+  const [cr, cg, cb] = opts.color ?? [1, 1, 1];
+  return { px, py, pz, rx, ry, rz, sx, sy, sz, cr, cg, cb };
+}
+function resolvePrefabHandle(prefab) {
+  const h = prefabHandles.get(prefab);
+  if (!h) {
+    throw new Error(
+      `Prefab '${prefab.id}' has no GPU handle \u2014 has the renderer's init() been called with this bucket?`
+    );
+  }
+  return h;
+}
+function computeBucketStats(bucket) {
+  let maxSkinnedParts = 0;
+  let maxJointCount = 0;
+  for (const prefab of bucket.entries()) {
+    if (prefab.type === "gltf") {
+      if (prefab.skinnedPartCount > maxSkinnedParts)
+        maxSkinnedParts = prefab.skinnedPartCount;
+      if (prefab.jointCount > maxJointCount)
+        maxJointCount = prefab.jointCount;
+    }
+  }
+  return { maxSkinnedParts, maxJointCount };
+}
+var WebGPU3DRenderer = class extends import_renderer4.Base3DRenderer {
   constructor(canvas, options) {
-    super(canvas, options);
+    const resolvedMaxModels = options.maxModels ?? (options.prefabs ? options.prefabs.size + 16 : 32);
+    super(canvas, { ...options, maxModels: resolvedMaxModels });
     this.resizeObserver = null;
     this.resizeCallbacks = [];
     // layer=0, sheetId=modelId
@@ -4295,11 +3813,15 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
     this.nextModelId = 0;
     // Skinned model data
     this.skinnedModels = [];
+    // Null when constructed without a `prefabs` bucket; lazy load/unload requires it as event source.
+    this.clipResync = null;
     this.boneMatrixDirty = true;
     // GPU animation compute
-    this.packedAnimData = createPackedAnimationData();
+    this.packedAnimData = (0, import_renderer5.createPackedAnimationData)();
     this.animComputeKernel = null;
     this.animComputeNeedsRebuild = false;
+    // Capacities the active kernel was built with — used to gate the in-place upload path on resync.
+    this.animKernelBudgets = null;
     this.animClipTableOffset = 0;
     this.animChannelTableOffset = 0;
     this.animJointLookupOffset = 0;
@@ -4313,16 +3835,20 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
     // mat4x4 (16) + alpha (1) + lightDir (3) + padding (4)
     this.lastRenderTime = 0;
     this.camera = new Camera3D();
-    this.maxSkinnedInstances = options.maxSkinnedInstances ?? 5e3;
-    this.maxBonesPerSkin = options.maxBonesPerSkin ?? 64;
+    this._prefabs = options.prefabs ?? null;
+    const SKINNED_PARTS_PER_INSTANCE_DEFAULT_CAP = 3;
+    const bucketStats = this._prefabs ? computeBucketStats(this._prefabs) : null;
+    const maxInstances = options.maxInstances ?? resolvedMaxModels;
+    this.maxSkinnedInstances = options.maxSkinnedInstances ?? (bucketStats ? maxInstances * Math.max(1, Math.min(bucketStats.maxSkinnedParts, SKINNED_PARTS_PER_INSTANCE_DEFAULT_CAP)) : 5e3);
+    this.maxBonesPerSkin = options.maxBonesPerSkin ?? (bucketStats ? Math.max(1, bucketStats.maxJointCount) : 64);
     this.maxTotalBones = this.maxSkinnedInstances * this.maxBonesPerSkin * 2;
     this.updatedBoneOffsets = new Uint8Array(this.maxTotalBones);
-    this.freeList = new import_free_list3.FreeList(options.maxModels);
-    this.batcher = new import_sparse_batcher2.SparseBatcher(options.maxModels);
-    this.dynamicData = new Float32Array(options.maxModels * DYNAMIC_MESH_FLOATS);
-    this.staticData = new Float32Array(options.maxModels * STATIC_MESH_FLOATS);
-    this.slotIndexData = new Uint32Array(options.maxModels);
-    this.instanceModelIds = new Uint8Array(options.maxModels);
+    this.freeList = new import_free_list3.FreeList(resolvedMaxModels);
+    this.batcher = new import_sparse_batcher2.SparseBatcher(resolvedMaxModels);
+    this.dynamicData = new Float32Array(resolvedMaxModels * DYNAMIC_MESH_FLOATS);
+    this.staticData = new Float32Array(resolvedMaxModels * STATIC_MESH_FLOATS);
+    this.slotIndexData = new Uint32Array(resolvedMaxModels);
+    this.instanceModelIds = new Uint8Array(resolvedMaxModels);
     const msi = this.maxSkinnedInstances;
     this.skinnedFreeList = new import_free_list3.FreeList(msi);
     this.skinnedBatcher = new import_sparse_batcher2.SparseBatcher(msi);
@@ -4478,9 +4004,38 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
         { binding: 4, resource: { buffer: this.rawBoneMatrixBuffer } }
       ]
     });
+    if (this._prefabs) {
+      this.uploadPrefabBucket(this._prefabs);
+    }
     this.setupResizeObserver();
     this._initialized = true;
   }
+  /**
+   * Upload every prefab in the bucket to the GPU and stash the handle on
+   * each prefab so `bucket.get(id)` resolves to a usable model. Also
+   * subscribes the resync coordinator to the bucket's `clips-changed`
+   * channel for lazy load/unload.
+   */
+  uploadPrefabBucket(bucket) {
+    this.clipResync = new GltfClipResyncCoordinator(bucket);
+    for (const prefab of bucket.entries()) {
+      if (prefab.type === "gltf") {
+        const beforeSkinCount = this.skinnedModels.length;
+        const model = this.uploadParsedGltf(prefab.parsed);
+        prefabHandles.set(prefab, model);
+        if (this.skinnedModels.length > beforeSkinCount) {
+          this.clipResync.registerSkin(prefab.id, beforeSkinCount);
+        }
+      } else if (prefab.type === "grid") {
+        const model = this.createGrid({
+          size: prefab.size,
+          step: prefab.step,
+          lineWidth: prefab.lineWidth
+        });
+        prefabHandles.set(prefab, model);
+      }
+    }
+  }
   setupResizeObserver() {
     const supportsDevicePixelBox = (() => {
       try {
@@ -4814,108 +4369,20 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
    * ```
    */
   async loadGltf(url, opts) {
-    const response = await fetch(url);
-    const baseUrl = url.substring(0, url.lastIndexOf("/") + 1);
-    let gltf;
-    let glbBinaryChunk = null;
-    const arrayBuffer = await response.arrayBuffer();
-    const magic = new Uint32Array(arrayBuffer, 0, 1)[0];
-    if (magic === 1179937895) {
-      let offset = 12;
-      while (offset < arrayBuffer.byteLength) {
-        const chunkLength = new Uint32Array(arrayBuffer, offset, 1)[0];
-        const chunkType = new Uint32Array(arrayBuffer, offset + 4, 1)[0];
-        offset += 8;
-        if (chunkType === 1313821514) {
-          const jsonBytes = new Uint8Array(arrayBuffer, offset, chunkLength);
-          gltf = JSON.parse(new TextDecoder().decode(jsonBytes));
-        } else if (chunkType === 5130562) {
-          glbBinaryChunk = arrayBuffer.slice(offset, offset + chunkLength);
-        }
-        offset += chunkLength;
-      }
-      if (!gltf)
-        throw new Error(`Invalid GLB: no JSON chunk in ${url}`);
-    } else {
-      gltf = JSON.parse(new TextDecoder().decode(arrayBuffer));
-    }
-    if (!gltf.meshes?.length)
-      throw new Error(`No meshes found in ${url}`);
-    const buffers = [];
-    for (let i = 0; i < (gltf.buffers?.length ?? 0); i++) {
-      const buf = gltf.buffers[i];
-      if (glbBinaryChunk && (!buf.uri || buf.uri === "")) {
-        buffers.push(glbBinaryChunk);
-      } else if (buf.uri) {
-        const r = await fetch(baseUrl + buf.uri);
-        buffers.push(await r.arrayBuffer());
-      }
-    }
-    const getAccessorData = (accessorIndex) => {
-      const accessor = gltf.accessors[accessorIndex];
-      const bufferView = gltf.bufferViews[accessor.bufferView];
-      const buffer = buffers[bufferView.buffer];
-      const typeMap = { 5120: Int8Array, 5121: Uint8Array, 5122: Int16Array, 5123: Uint16Array, 5125: Uint32Array, 5126: Float32Array };
-      const byteSizeMap = { 5120: 1, 5121: 1, 5122: 2, 5123: 2, 5125: 4, 5126: 4 };
-      const sizeMap = { SCALAR: 1, VEC2: 2, VEC3: 3, VEC4: 4, MAT2: 4, MAT3: 9, MAT4: 16 };
-      const TypedArray = typeMap[accessor.componentType];
-      const componentBytes = byteSizeMap[accessor.componentType];
-      const elementSize = sizeMap[accessor.type] ?? 1;
-      const baseOffset = (bufferView.byteOffset ?? 0) + (accessor.byteOffset ?? 0);
-      const stride = bufferView.byteStride ?? componentBytes * elementSize;
-      const tightStride = componentBytes * elementSize;
-      if (stride === tightStride) {
-        const data = new TypedArray(buffer, baseOffset, accessor.count * elementSize);
-        return { data, count: accessor.count, elementSize };
-      }
-      const out = new TypedArray(accessor.count * elementSize);
-      const src = new Uint8Array(buffer);
-      const dst = new Uint8Array(out.buffer);
-      for (let i = 0; i < accessor.count; i++) {
-        const srcOff = baseOffset + i * stride;
-        const dstOff = i * tightStride;
-        for (let b = 0; b < tightStride; b++) {
-          dst[dstOff + b] = src[srcOff + b];
-        }
-      }
-      return { data: out, count: accessor.count, elementSize };
-    };
-    const textureCache = /* @__PURE__ */ new Map();
-    const loadTexture = async (imageIndex) => {
-      if (textureCache.has(imageIndex))
-        return textureCache.get(imageIndex);
-      const image = gltf.images?.[imageIndex];
-      if (!image)
-        return void 0;
-      let blob;
-      if (image.bufferView !== void 0) {
-        const bv = gltf.bufferViews[image.bufferView];
-        const buf = buffers[bv.buffer];
-        const data = new Uint8Array(buf, bv.byteOffset ?? 0, bv.byteLength);
-        blob = new Blob([data], { type: image.mimeType ?? "image/png" });
-      } else if (image.uri) {
-        const imgUrl = image.uri.startsWith("data:") ? image.uri : baseUrl + image.uri;
-        blob = await (await fetch(imgUrl)).blob();
-      }
-      if (blob) {
-        const bmp = await createImageBitmap(blob);
-        textureCache.set(imageIndex, bmp);
-        return bmp;
-      }
-      return void 0;
-    };
-    const meshNodeIndex = gltf.nodes?.findIndex((n) => n.mesh !== void 0) ?? -1;
-    const skinIndex = meshNodeIndex !== -1 ? gltf.nodes?.[meshNodeIndex]?.skin : void 0;
-    let skinData = null;
-    let animClips = [];
+    const parsed = await (0, import_renderer5.parseGltf)(url, opts);
+    return this.uploadParsedGltf(parsed);
+  }
+  /**
+   * Upload a previously-parsed glTF to the GPU. Returns a GltfModel handle.
+   * Splitting parse (CPU) from upload (GPU) lets callers parse models in parallel
+   * before a renderer exists and inspect joint counts / vertex totals to size the
+   * renderer appropriately.
+   */
+  uploadParsedGltf(parsed) {
     let skinnedModelSkinIndex = -1;
-    if (skinIndex !== void 0 && gltf.skins?.[skinIndex]) {
-      skinData = parseSkin(gltf, skinIndex, getAccessorData);
-      animClips = parseAnimations(gltf, skinData, getAccessorData);
-      if (opts?.animations) {
-        animClips = animClips.filter((clip) => opts.animations.includes(clip.name));
-      }
-      const animation = new SkeletalAnimation(skinData, animClips, gltf.nodes);
+    if (parsed.skin) {
+      const { data: skinData, animClips } = parsed.skin;
+      const animation = new import_renderer5.SkeletalAnimation(skinData, animClips);
       const ibm = skinData.inverseBindMatrices;
       let maxRadSq = 0;
       for (let j = 0; j < skinData.jointCount; j++) {
@@ -4929,91 +4396,34 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
       this.skinnedModels.push({
         animation,
         jointCount: skinData.jointCount,
-        boundingRadius: skinnedRadius
+        boundingRadius: skinnedRadius,
+        parsedSkin: parsed.skin
       });
-      packSkinAndAnimations(this.packedAnimData, skinData, animClips, gltf.nodes);
+      (0, import_renderer5.packSkinAndAnimations)(this.packedAnimData, skinData, animClips);
       this.animComputeNeedsRebuild = true;
     }
     const handles = [];
-    const meshNodeIndices = [];
-    for (let i = 0; i < gltf.nodes.length; i++) {
-      if (gltf.nodes[i].mesh !== void 0)
-        meshNodeIndices.push(i);
-    }
-    const meshIndicesToLoad = meshNodeIndices.length > 0 ? meshNodeIndices.map((ni) => gltf.nodes[ni].mesh) : [0];
-    for (const meshIdx of meshIndicesToLoad) {
-      const mesh = gltf.meshes[meshIdx];
-      if (!mesh)
-        continue;
-      const meshNodeForThis = gltf.nodes.find((n) => n.mesh === meshIdx);
-      const meshSkinIndex = meshNodeForThis?.skin;
-      const isSkinned = skinData && meshSkinIndex !== void 0;
-      let thisMeshNodeMatrix = null;
-      if (meshNodeForThis && !isSkinned) {
-        if (meshNodeForThis.scale || meshNodeForThis.rotation || meshNodeForThis.translation || meshNodeForThis.matrix) {
-          thisMeshNodeMatrix = nodeToMat4(meshNodeForThis);
-        }
-      }
-      for (const primitive of mesh.primitives) {
-        const posAccess = getAccessorData(primitive.attributes.POSITION);
-        const positions = new Float32Array(posAccess.data);
-        let normals;
-        if (primitive.attributes.NORMAL !== void 0) {
-          normals = new Float32Array(getAccessorData(primitive.attributes.NORMAL).data);
-        }
-        let uvs;
-        if (primitive.attributes.TEXCOORD_0 !== void 0) {
-          uvs = new Float32Array(getAccessorData(primitive.attributes.TEXCOORD_0).data);
-        }
-        let indices;
-        if (primitive.indices !== void 0) {
-          const idxAccess = getAccessorData(primitive.indices);
-          indices = idxAccess.data.length > 65535 ? new Uint32Array(idxAccess.data) : new Uint16Array(idxAccess.data);
-        }
-        if (thisMeshNodeMatrix && !isSkinned) {
-          const meshNodeMatrix = thisMeshNodeMatrix;
-          const mm = meshNodeMatrix;
-          const vertexCount = positions.length / 3;
-          for (let v = 0; v < vertexCount; v++) {
-            const o = v * 3;
-            const px = positions[o], py = positions[o + 1], pz = positions[o + 2];
-            positions[o] = mm[0] * px + mm[4] * py + mm[8] * pz + mm[12];
-            positions[o + 1] = mm[1] * px + mm[5] * py + mm[9] * pz + mm[13];
-            positions[o + 2] = mm[2] * px + mm[6] * py + mm[10] * pz + mm[14];
-            if (normals) {
-              const nx = normals[o], ny = normals[o + 1], nz = normals[o + 2];
-              const tnx = mm[0] * nx + mm[4] * ny + mm[8] * nz;
-              const tny = mm[1] * nx + mm[5] * ny + mm[9] * nz;
-              const tnz = mm[2] * nx + mm[6] * ny + mm[10] * nz;
-              const len = Math.sqrt(tnx * tnx + tny * tny + tnz * tnz);
-              if (len > 0) {
-                normals[o] = tnx / len;
-                normals[o + 1] = tny / len;
-                normals[o + 2] = tnz / len;
-              }
-            }
-          }
-        }
-        let texture;
-        if (primitive.material !== void 0) {
-          const material = gltf.materials?.[primitive.material];
-          const texIndex = material?.pbrMetallicRoughness?.baseColorTexture?.index;
-          if (texIndex !== void 0 && gltf.textures?.[texIndex]) {
-            texture = await loadTexture(gltf.textures[texIndex].source);
-          }
-        }
-        if (isSkinned) {
-          const skinAttrs = parsePrimitiveSkinAttributes(primitive, getAccessorData);
-          if (skinAttrs) {
-            handles.push(this.loadSkinnedModel(
-              { positions, normals, uvs, indices, texture },
-              skinAttrs,
-              skinnedModelSkinIndex
-            ));
-            continue;
-          }
-        }
-        handles.push(this.loadModel({ positions, normals, uvs, indices, texture }));
+    for (const prim of parsed.primitives) {
+      if (prim.skinned && prim.skinAttrs) {
+        handles.push(this.loadSkinnedModel(
+          {
+            positions: prim.positions,
+            normals: prim.normals,
+            uvs: prim.uvs,
+            indices: prim.indices,
+            texture: prim.texture
+          },
+          prim.skinAttrs,
+          skinnedModelSkinIndex
+        ));
+      } else {
+        handles.push(this.loadModel({
+          positions: prim.positions,
+          normals: prim.normals,
+          uvs: prim.uvs,
+          indices: prim.indices,
+          texture: prim.texture
+        }));
       }
     }
     let totalVertexCount = 0;
@@ -5025,7 +4435,7 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
       totalVertexCount,
       skinned: handles.some((h) => h.skinned),
       animations: animNames,
-      src: url
+      src: parsed.src
     };
   }
   /**
@@ -5033,7 +4443,7 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
    * with another instance (e.g., when spawning all parts of a character).
    */
   addInstance(opts) {
-    const modelOrGltf = opts.model;
+    const modelOrGltf = isPrefab3D(opts.model) ? resolvePrefabHandle(opts.model) : opts.model;
     if ("parts" in modelOrGltf) {
       return this.addGltfInstance(opts, modelOrGltf);
     }
@@ -5047,27 +4457,25 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
       throw new Error(`Max instances (${this.maxModels}) reached`);
     const dynBase = slot * DYNAMIC_MESH_FLOATS;
     const statBase = slot * STATIC_MESH_FLOATS;
-    const x = opts.x ?? 0, y = opts.y ?? 0, z = opts.z ?? 0;
-    this.dynamicData[dynBase + DYN_PREV_PX] = x;
-    this.dynamicData[dynBase + DYN_PREV_PY] = y;
-    this.dynamicData[dynBase + DYN_PREV_PZ] = z;
-    this.dynamicData[dynBase + DYN_CURR_PX] = x;
-    this.dynamicData[dynBase + DYN_CURR_PY] = y;
-    this.dynamicData[dynBase + DYN_CURR_PZ] = z;
-    const rx = opts.rotX ?? 0, ry = opts.rotY ?? 0, rz = opts.rotZ ?? 0;
-    this.dynamicData[dynBase + DYN_PREV_RX] = rx;
-    this.dynamicData[dynBase + DYN_PREV_RY] = ry;
-    this.dynamicData[dynBase + DYN_PREV_RZ] = rz;
-    this.dynamicData[dynBase + DYN_CURR_RX] = rx;
-    this.dynamicData[dynBase + DYN_CURR_RY] = ry;
-    this.dynamicData[dynBase + DYN_CURR_RZ] = rz;
-    this.staticData[statBase + STAT_SX] = opts.scaleX ?? 1;
-    this.staticData[statBase + STAT_SY] = opts.scaleY ?? 1;
-    this.staticData[statBase + STAT_SZ] = opts.scaleZ ?? 1;
-    const color = opts.color ?? [1, 1, 1];
-    this.staticData[statBase + STAT_CR] = color[0];
-    this.staticData[statBase + STAT_CG] = color[1];
-    this.staticData[statBase + STAT_CB] = color[2];
+    const t = resolveTransform(opts);
+    this.dynamicData[dynBase + DYN_PREV_PX] = t.px;
+    this.dynamicData[dynBase + DYN_PREV_PY] = t.py;
+    this.dynamicData[dynBase + DYN_PREV_PZ] = t.pz;
+    this.dynamicData[dynBase + DYN_CURR_PX] = t.px;
+    this.dynamicData[dynBase + DYN_CURR_PY] = t.py;
+    this.dynamicData[dynBase + DYN_CURR_PZ] = t.pz;
+    this.dynamicData[dynBase + DYN_PREV_RX] = t.rx;
+    this.dynamicData[dynBase + DYN_PREV_RY] = t.ry;
+    this.dynamicData[dynBase + DYN_PREV_RZ] = t.rz;
+    this.dynamicData[dynBase + DYN_CURR_RX] = t.rx;
+    this.dynamicData[dynBase + DYN_CURR_RY] = t.ry;
+    this.dynamicData[dynBase + DYN_CURR_RZ] = t.rz;
+    this.staticData[statBase + STAT_SX] = t.sx;
+    this.staticData[statBase + STAT_SY] = t.sy;
+    this.staticData[statBase + STAT_SZ] = t.sz;
+    this.staticData[statBase + STAT_CR] = t.cr;
+    this.staticData[statBase + STAT_CG] = t.cg;
+    this.staticData[statBase + STAT_CB] = t.cb;
     this.staticDirty = true;
     this.instanceModelIds[slot] = modelHandle.id;
     this.batcher.add(0, modelHandle.id, slot);
@@ -5153,27 +4561,25 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
     this.skinnedAnimStates[slot] = animState;
     const dynBase = slot * DYNAMIC_MESH_FLOATS;
     const statBase = slot * SKINNED_STATIC_MESH_FLOATS;
-    const x = opts.x ?? 0, y = opts.y ?? 0, z = opts.z ?? 0;
-    this.skinnedDynamicData[dynBase + DYN_PREV_PX] = x;
-    this.skinnedDynamicData[dynBase + DYN_PREV_PY] = y;
-    this.skinnedDynamicData[dynBase + DYN_PREV_PZ] = z;
-    this.skinnedDynamicData[dynBase + DYN_CURR_PX] = x;
-    this.skinnedDynamicData[dynBase + DYN_CURR_PY] = y;
-    this.skinnedDynamicData[dynBase + DYN_CURR_PZ] = z;
-    const rx = opts.rotX ?? 0, ry = opts.rotY ?? 0, rz = opts.rotZ ?? 0;
-    this.skinnedDynamicData[dynBase + DYN_PREV_RX] = rx;
-    this.skinnedDynamicData[dynBase + DYN_PREV_RY] = ry;
-    this.skinnedDynamicData[dynBase + DYN_PREV_RZ] = rz;
-    this.skinnedDynamicData[dynBase + DYN_CURR_RX] = rx;
-    this.skinnedDynamicData[dynBase + DYN_CURR_RY] = ry;
-    this.skinnedDynamicData[dynBase + DYN_CURR_RZ] = rz;
-    this.skinnedStaticData[statBase + SSTAT_SX] = opts.scaleX ?? 1;
-    this.skinnedStaticData[statBase + SSTAT_SY] = opts.scaleY ?? 1;
-    this.skinnedStaticData[statBase + SSTAT_SZ] = opts.scaleZ ?? 1;
-    const color = opts.color ?? [1, 1, 1];
-    this.skinnedStaticData[statBase + SSTAT_CR] = color[0];
-    this.skinnedStaticData[statBase + SSTAT_CG] = color[1];
-    this.skinnedStaticData[statBase + SSTAT_CB] = color[2];
+    const t = resolveTransform(opts);
+    this.skinnedDynamicData[dynBase + DYN_PREV_PX] = t.px;
+    this.skinnedDynamicData[dynBase + DYN_PREV_PY] = t.py;
+    this.skinnedDynamicData[dynBase + DYN_PREV_PZ] = t.pz;
+    this.skinnedDynamicData[dynBase + DYN_CURR_PX] = t.px;
+    this.skinnedDynamicData[dynBase + DYN_CURR_PY] = t.py;
+    this.skinnedDynamicData[dynBase + DYN_CURR_PZ] = t.pz;
+    this.skinnedDynamicData[dynBase + DYN_PREV_RX] = t.rx;
+    this.skinnedDynamicData[dynBase + DYN_PREV_RY] = t.ry;
+    this.skinnedDynamicData[dynBase + DYN_PREV_RZ] = t.rz;
+    this.skinnedDynamicData[dynBase + DYN_CURR_RX] = t.rx;
+    this.skinnedDynamicData[dynBase + DYN_CURR_RY] = t.ry;
+    this.skinnedDynamicData[dynBase + DYN_CURR_RZ] = t.rz;
+    this.skinnedStaticData[statBase + SSTAT_SX] = t.sx;
+    this.skinnedStaticData[statBase + SSTAT_SY] = t.sy;
+    this.skinnedStaticData[statBase + SSTAT_SZ] = t.sz;
+    this.skinnedStaticData[statBase + SSTAT_CR] = t.cr;
+    this.skinnedStaticData[statBase + SSTAT_CG] = t.cg;
+    this.skinnedStaticData[statBase + SSTAT_CB] = t.cb;
     new DataView(this.skinnedStaticData.buffer).setUint32(
       (statBase + SSTAT_BONE_OFFSET) * 4,
       boneOffset,
@@ -5217,16 +4623,102 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
       }
     };
   }
+  /**
+   * Drain pending resyncs from the coordinator. Per affected skin: rebuild
+   * its `SkeletalAnimation` clip list densely, remap in-flight animStates,
+   * then full-repack `packedAnimData`. Falls back to a kernel rebuild only
+   * when the new data exceeds the kernel's allocated budgets.
+   *
+   * The dense renumbering is load-bearing: the kernel reads each clip by
+   * its per-skin index, which must equal `SkeletalAnimation`'s clip id.
+   */
+  syncLazyAnimationChanges() {
+    const resync = this.clipResync;
+    if (!resync || resync.pending.size === 0)
+      return;
+    const remapsBySkin = /* @__PURE__ */ new Map();
+    for (const skinIndex of resync.pending) {
+      const sm = this.skinnedModels[skinIndex];
+      if (!sm)
+        continue;
+      remapsBySkin.set(skinIndex, sm.animation.replaceClips(sm.parsedSkin.animClips));
+    }
+    resync.clear();
+    for (let slot = 0; slot < this.maxSkinnedInstances; slot++) {
+      const animState = this.skinnedAnimStates[slot];
+      if (!animState)
+        continue;
+      const modelId = this.skinnedInstanceModelIds[slot];
+      const model = this.models[modelId];
+      if (!model || model.skinIndex < 0)
+        continue;
+      const remap3 = remapsBySkin.get(model.skinIndex);
+      if (!remap3)
+        continue;
+      if (animState.clipId >= 0 && animState.clipId < remap3.length) {
+        const next = remap3[animState.clipId];
+        if (next < 0) {
+          animState.clipId = -1;
+          animState.playing = false;
+        } else {
+          animState.clipId = next;
+        }
+      }
+      if (animState.prevClipId >= 0 && animState.prevClipId < remap3.length) {
+        animState.prevClipId = remap3[animState.prevClipId];
+      }
+    }
+    this.packedAnimData = (0, import_renderer5.createPackedAnimationData)();
+    for (const sm of this.skinnedModels) {
+      (0, import_renderer5.packSkinAndAnimations)(this.packedAnimData, sm.parsedSkin.data, sm.parsedSkin.animClips);
+    }
+    if (this.tryUploadInPlace())
+      return;
+    this.animComputeNeedsRebuild = true;
+  }
+  /** Doubling-growth budgets for kernel storage buffers, with sensible floors. */
+  growBudgetsForPacked(packed, previous) {
+    const pb = packAnimationData(packed);
+    const grow = (cur, prev, floor) => Math.max(cur * 2, prev, floor);
+    return {
+      skelI32Capacity: grow(pb.skelI32.length, previous?.skelI32Capacity ?? 0, 256),
+      animF32Capacity: grow(pb.animF32.length, previous?.animF32Capacity ?? 0, 4096),
+      matricesCapacity: grow(pb.totalMats, previous?.matricesCapacity ?? 0, 8)
+    };
+  }
+  /** Upload `packedAnimData` to the existing kernel iff it fits the current budgets. Returns false to force a rebuild. */
+  tryUploadInPlace() {
+    const kernel = this.animComputeKernel;
+    const budgets = this.animKernelBudgets;
+    if (!kernel || !budgets)
+      return false;
+    const pb = packAnimationData(this.packedAnimData);
+    if (pb.skelI32.length > budgets.skelI32Capacity)
+      return false;
+    if (pb.animF32.length > budgets.animF32Capacity)
+      return false;
+    if (pb.totalMats > budgets.matricesCapacity)
+      return false;
+    uploadPackedToKernel(this.root, kernel, pb);
+    this.animClipTableOffset = pb.clipTableOffset;
+    this.animChannelTableOffset = pb.channelTableOffset;
+    this.animJointLookupOffset = pb.jointLookupOffset;
+    return true;
+  }
   updateAnimations(deltaTime) {
+    this.syncLazyAnimationChanges();
     if (this.animComputeNeedsRebuild && this.packedAnimData.clips.length > 0) {
       this.animComputeKernel?.destroy();
+      const budgets = this.growBudgetsForPacked(this.packedAnimData, null);
       const { kernel, packedBuffers } = buildAnimationKernel(
         this.root,
         this.packedAnimData,
         this.maxSkinnedInstances,
-        this.maxTotalBones
+        this.maxTotalBones,
+        budgets
       );
       this.animComputeKernel = kernel;
+      this.animKernelBudgets = budgets;
       this.animClipTableOffset = packedBuffers.clipTableOffset;
       this.animChannelTableOffset = packedBuffers.channelTableOffset;
       this.animJointLookupOffset = packedBuffers.jointLookupOffset;
@@ -5243,6 +4735,14 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
           { binding: 4, resource: { buffer: rawBoneBuffer } }
         ]
       });
+      this.device.queue.writeBuffer(
+        this.rawBoneMatrixBuffer,
+        0,
+        this.boneMatrixData.buffer,
+        this.boneMatrixData.byteOffset,
+        this.boneMatrixData.byteLength
+      );
+      this.boneMatrixDirty = false;
       this.animComputeNeedsRebuild = false;
     }
     this.updatedBoneOffsets.fill(0);
@@ -5643,6 +5143,8 @@ var WebGPU3DRenderer = class extends import_base_3d_renderer.Base3DRenderer {
     this.resizeObserver?.disconnect();
     this.resizeObserver = null;
     this.resizeCallbacks.length = 0;
+    this.clipResync?.dispose();
+    this.clipResync = null;
     this.dynamicBuffer?.destroy();
     this.staticBuffer?.destroy();
     this.uniformBuffer?.destroy();
@@ -5790,10 +5292,8 @@ var ParticleEmitter = class {
         const sprite = this.renderer.addSprite({
           sheet: this.config.sheet,
           sprite: this.config.sprite ?? 0,
-          x,
-          y,
-          scaleX: size,
-          scaleY: size,
+          position: [x, y],
+          scale: size,
           opacity: 1,
           tint: this.config.color,
           layer: 255
@@ -5845,109 +5345,6 @@ var ParticleEmitter = class {
   }
 };
 
-// src/2d/animation.ts
-var AnimationController = class {
-  constructor() {
-    this.clips = [];
-    this.clipsByName = /* @__PURE__ */ new Map();
-  }
-  /**
-   * Register an animation clip. Returns the clip ID.
-   */
-  loadClip(config) {
-    const id = this.clips.length;
-    const clip = {
-      id,
-      name: config.name,
-      frames: new Uint16Array(config.frames),
-      durations: new Float32Array(config.durations),
-      frameCount: config.frames.length,
-      totalDuration: config.durations.reduce((sum, d7) => sum + d7, 0),
-      loop: config.loop
-    };
-    this.clips.push(clip);
-    this.clipsByName.set(config.name, id);
-    return id;
-  }
-  /**
-   * Get a clip by name.
-   */
-  getClipId(name) {
-    const id = this.clipsByName.get(name);
-    if (id === void 0)
-      throw new Error(`Animation clip "${name}" not found`);
-    return id;
-  }
-  /**
-   * Get a clip by ID.
-   */
-  getClip(id) {
-    return this.clips[id];
-  }
-  /**
-   * Create a new animation state for an entity. This is the per-entity data
-   * that tracks playback progress. Store it however you like (flat array, component, etc).
-   */
-  createState(clipId, speed = 1, playing = true) {
-    return { clipId, frame: 0, time: 0, speed, playing };
-  }
-  /**
-   * Advance an animation state by deltaTime (in seconds).
-   * Returns the current sprite frame ID, or -1 if not playing.
-   * Zero allocations.
-   */
-  update(state, deltaTime) {
-    if (!state.playing) {
-      return this.clips[state.clipId].frames[state.frame];
-    }
-    const clip = this.clips[state.clipId];
-    state.time += deltaTime * state.speed * 1e3;
-    while (state.time >= clip.durations[state.frame]) {
-      state.time -= clip.durations[state.frame];
-      state.frame++;
-      if (state.frame >= clip.frameCount) {
-        if (clip.loop) {
-          state.frame = 0;
-        } else {
-          state.frame = clip.frameCount - 1;
-          state.playing = false;
-          break;
-        }
-      }
-    }
-    return clip.frames[state.frame];
-  }
-  /**
-   * Play a different clip on an existing state. Resets frame and time.
-   */
-  play(state, clipId, speed) {
-    state.clipId = clipId;
-    state.frame = 0;
-    state.time = 0;
-    state.playing = true;
-    if (speed !== void 0)
-      state.speed = speed;
-  }
-  /**
-   * Stop playback.
-   */
-  stop(state) {
-    state.playing = false;
-  }
-  /**
-   * Resume playback.
-   */
-  resume(state) {
-    state.playing = true;
-  }
-  /**
-   * Number of loaded clips.
-   */
-  get clipCount() {
-    return this.clips.length;
-  }
-};
-
 // src/shaders/utils.ts
 var import_typegpu11 = __toESM(require("typegpu"), 1);
 var d6 = __toESM(require("typegpu/data"), 1);