@vectojs/core 1.22.0 → 1.23.0

package/dist/index.js

@@ -308,12 +308,16 @@ var ComputeParticleEntity = (_class = class extends _chunkAGP4VLF4js.Entity {
    * The backend holds one resident SoA store, so a Scene with multiple particle
    * entities reuses it sequentially — origin is therefore re-gathered each call
    * (not upload-once), a couple of extra f32 reads per particle.
+   *
+   * Returns `false` if the kernel declined the call and {@link updateCPU} ran
+   * instead, so the Scene can report which path actually simulated this frame
+   * rather than assuming an installed backend did the work.
    */
   stepWithBackend(backend, dt, mouseX, mouseY, width, height) {
     const count = this.maxParticles;
     backend.ensure(count);
     backend.gather(this.particleData, count, true);
-    this._wasmPending = backend.step(count, {
+    const pending = backend.step(count, {
       dt,
       mouseX,
       mouseY,
@@ -325,8 +329,14 @@ var ComputeParticleEntity = (_class = class extends _chunkAGP4VLF4js.Entity {
       maxVelocity: this.maxVelocity,
       explosion: this.pendingExplosion
     });
+    if (pending === null) {
+      this.updateCPU(dt, mouseX, mouseY, width, height);
+      return false;
+    }
+    this._wasmPending = pending;
     backend.scatter(this.particleData, count);
     this.pendingExplosion = null;
+    return true;
   }
   destroy() {
     this.destroyGPUResources();
@@ -470,148 +480,6 @@ function buildTreeStore(root) {
   return { store, indexOf };
 }
 
-// src/wasm/hit-store.ts
-function gatherHitAABBs(root, currentFrame) {
-  const slotEntity = [];
-  const boundless = [];
-  const minxs = [];
-  const minys = [];
-  const maxxs = [];
-  const maxys = [];
-  const scratch = { a: 1, b: 0, c: 0, d: 1, e: 0, f: 0 };
-  const visit = (node) => {
-    const index = slotEntity.length;
-    slotEntity.push(node);
-    const bounds = node.getBounds();
-    if (bounds === null) {
-      boundless.push({ entity: node, index });
-      minxs.push(0);
-      minys.push(0);
-      maxxs.push(0);
-      maxys.push(0);
-    } else {
-      if (!node._readWorldCache(currentFrame, scratch)) {
-        const t = node.getWorldTransform();
-        scratch.a = t.a;
-        scratch.b = t.b;
-        scratch.c = t.c;
-        scratch.d = t.d;
-        scratch.e = t.e;
-        scratch.f = t.f;
-      }
-      const { a, b, c, d, e, f } = scratch;
-      let minX = Infinity;
-      let minY = Infinity;
-      let maxX = -Infinity;
-      let maxY = -Infinity;
-      for (let i = 0; i < 4; i++) {
-        const lx = i & 1 ? bounds.x + bounds.width : bounds.x;
-        const ly = i & 2 ? bounds.y + bounds.height : bounds.y;
-        const wx = a * lx + c * ly + e;
-        const wy = b * lx + d * ly + f;
-        if (wx < minX) minX = wx;
-        if (wx > maxX) maxX = wx;
-        if (wy < minY) minY = wy;
-        if (wy > maxY) maxY = wy;
-      }
-      minxs.push(minX);
-      minys.push(minY);
-      maxxs.push(maxX);
-      maxys.push(maxY);
-    }
-    const kids = node.children;
-    for (let i = 0; i < kids.length; i++) visit(kids[i]);
-  };
-  visit(root);
-  return {
-    count: slotEntity.length,
-    slotEntity,
-    boundless,
-    minx: Float64Array.from(minxs),
-    miny: Float64Array.from(minys),
-    maxx: Float64Array.from(maxxs),
-    maxy: Float64Array.from(maxys)
-  };
-}
-
-// src/wasm/hit-store-fused.ts
-function gatherHitAABBsFromStore(root, aabbs, storeSlotEntity, out) {
-  const slotEntity = out.slotEntity;
-  const boundless = out.boundless;
-  slotEntity.length = 0;
-  boundless.length = 0;
-  let count = 0;
-  let capacity = out.minx.length;
-  let minx = out.minx;
-  let miny = out.miny;
-  let maxx = out.maxx;
-  let maxy = out.maxy;
-  const grow = (needed) => {
-    if (needed <= capacity) return;
-    let next = capacity || 256;
-    while (next < needed) next *= 2;
-    const nminx = new Float64Array(next);
-    const nminy = new Float64Array(next);
-    const nmaxx = new Float64Array(next);
-    const nmaxy = new Float64Array(next);
-    nminx.set(minx);
-    nminy.set(miny);
-    nmaxx.set(maxx);
-    nmaxy.set(maxy);
-    minx = nminx;
-    miny = nminy;
-    maxx = nmaxx;
-    maxy = nmaxy;
-    capacity = next;
-  };
-  let bailed = false;
-  const visit = (node) => {
-    if (bailed) return;
-    const index = count;
-    slotEntity.push(node);
-    count++;
-    grow(count);
-    if (node.getBounds() === null) {
-      boundless.push({ entity: node, index });
-      minx[index] = 0;
-      miny[index] = 0;
-      maxx[index] = 0;
-      maxy[index] = 0;
-    } else {
-      const slot = node._storeSlot;
-      if (slot < 0 || slot >= aabbs.aminx.length || storeSlotEntity[slot] !== node) {
-        bailed = true;
-        return;
-      }
-      minx[index] = aabbs.aminx[slot];
-      miny[index] = aabbs.aminy[slot];
-      maxx[index] = aabbs.amaxx[slot];
-      maxy[index] = aabbs.amaxy[slot];
-    }
-    const children = node.children;
-    for (let i = 0; i < children.length; i++) visit(children[i]);
-  };
-  visit(root);
-  if (bailed) return null;
-  out.count = count;
-  out.minx = minx;
-  out.miny = miny;
-  out.maxx = maxx;
-  out.maxy = maxy;
-  return out;
-}
-function createHitGatherBuffer() {
-  return {
-    count: 0,
-    slotEntity: [],
-    boundless: [],
-    minx: new Float64Array(256),
-    miny: new Float64Array(256),
-    maxx: new Float64Array(256),
-    maxy: new Float64Array(256)
-  };
-}
-
 // src/wasm/backend.ts
 var WASM_STATUS = {
   OK: 0,
@@ -704,7 +572,10 @@ var WasmTransformBackend = (_class2 = class {
     return status;
   }
   /** Upload only the run table + count (topology), leaving per-entity inputs to
-   *  the resident views. Call when the tree structure changes, not per frame. */
+   *  the resident views. Call when the tree structure changes, not per frame.
+   *  Returns `false` if the crate rejected the run count, in which case the
+   *  PREVIOUS topology is still published and any kernel run against it would
+   *  compose the wrong tree — the caller must not proceed. */
   uploadRuns(store) {
     this.ensure(store.count, store.runCount);
     const rc = store.runCount;
@@ -712,6 +583,7 @@ var WasmTransformBackend = (_class2 = class {
     this.vrs.set(store.runStart.subarray(0, rc));
     this.vrl.set(store.runLen.subarray(0, rc));
     this.lastStatus = this.ex.set_run_count(rc);
+    return this.lastStatus === WASM_STATUS.OK;
   }
   /**
    * Status of the most recent kernel or run-table call. `WASM_STATUS.OK` unless
@@ -760,7 +632,8 @@ var WasmTransformBackend = (_class2 = class {
     this.vby.set(store.by.subarray(0, n));
     this.vbw.set(store.bw.subarray(0, n));
     this.vbh.set(store.bh.subarray(0, n));
-    this.ex.compute_aabbs(n);
+    this.lastStatus = this.ex.compute_aabbs(n);
+    if (this.lastStatus !== WASM_STATUS.OK) return;
     store.aminx.set(this.vaminx.subarray(0, n));
     store.aminy.set(this.vaminy.subarray(0, n));
     store.amaxx.set(this.vamaxx.subarray(0, n));
@@ -768,9 +641,12 @@ var WasmTransformBackend = (_class2 = class {
   }
   /** Run the AABB pass only, over `count` entities already resident in wasm
    *  memory (bounds written via {@link boundsView}, world matrices already
-   *  composed). No upload/readback — the per-frame resident path. */
+   *  composed). No upload/readback — the per-frame resident path. Returns
+   *  `false` if the kernel rejected `count` (beyond capacity, or uninitialized),
+   *  in which case {@link aabbView} still holds the previous frame's bounds. */
   runAabbs(count) {
-    this.ex.compute_aabbs(count);
+    this.lastStatus = this.ex.compute_aabbs(count);
+    return this.lastStatus === WASM_STATUS.OK;
   }
   /** Resident wasm local-bounds input views (`bx,by,bw,bh`) for the AABB pass. */
   boundsView() {
@@ -844,6 +720,148 @@ var WasmTransformBackend = (_class2 = class {
   }
 }, _class2);
 
+// src/wasm/hit-store.ts
+function gatherHitAABBs(root, currentFrame) {
+  const slotEntity = [];
+  const boundless = [];
+  const minxs = [];
+  const minys = [];
+  const maxxs = [];
+  const maxys = [];
+  const scratch = { a: 1, b: 0, c: 0, d: 1, e: 0, f: 0 };
+  const visit = (node) => {
+    const index = slotEntity.length;
+    slotEntity.push(node);
+    const bounds = node.getBounds();
+    if (bounds === null) {
+      boundless.push({ entity: node, index });
+      minxs.push(0);
+      minys.push(0);
+      maxxs.push(0);
+      maxys.push(0);
+    } else {
+      if (!node._readWorldCache(currentFrame, scratch)) {
+        const t = node.getWorldTransform();
+        scratch.a = t.a;
+        scratch.b = t.b;
+        scratch.c = t.c;
+        scratch.d = t.d;
+        scratch.e = t.e;
+        scratch.f = t.f;
+      }
+      const { a, b, c, d, e, f } = scratch;
+      let minX = Infinity;
+      let minY = Infinity;
+      let maxX = -Infinity;
+      let maxY = -Infinity;
+      for (let i = 0; i < 4; i++) {
+        const lx = i & 1 ? bounds.x + bounds.width : bounds.x;
+        const ly = i & 2 ? bounds.y + bounds.height : bounds.y;
+        const wx = a * lx + c * ly + e;
+        const wy = b * lx + d * ly + f;
+        if (wx < minX) minX = wx;
+        if (wx > maxX) maxX = wx;
+        if (wy < minY) minY = wy;
+        if (wy > maxY) maxY = wy;
+      }
+      minxs.push(minX);
+      minys.push(minY);
+      maxxs.push(maxX);
+      maxys.push(maxY);
+    }
+    const kids = node.children;
+    for (let i = 0; i < kids.length; i++) visit(kids[i]);
+  };
+  visit(root);
+  return {
+    count: slotEntity.length,
+    slotEntity,
+    boundless,
+    minx: Float64Array.from(minxs),
+    miny: Float64Array.from(minys),
+    maxx: Float64Array.from(maxxs),
+    maxy: Float64Array.from(maxys)
+  };
+}
+
+// src/wasm/hit-store-fused.ts
+function gatherHitAABBsFromStore(root, aabbs, storeSlotEntity, out) {
+  const slotEntity = out.slotEntity;
+  const boundless = out.boundless;
+  slotEntity.length = 0;
+  boundless.length = 0;
+  let count = 0;
+  let capacity = out.minx.length;
+  let minx = out.minx;
+  let miny = out.miny;
+  let maxx = out.maxx;
+  let maxy = out.maxy;
+  const grow = (needed) => {
+    if (needed <= capacity) return;
+    let next = capacity || 256;
+    while (next < needed) next *= 2;
+    const nminx = new Float64Array(next);
+    const nminy = new Float64Array(next);
+    const nmaxx = new Float64Array(next);
+    const nmaxy = new Float64Array(next);
+    nminx.set(minx);
+    nminy.set(miny);
+    nmaxx.set(maxx);
+    nmaxy.set(maxy);
+    minx = nminx;
+    miny = nminy;
+    maxx = nmaxx;
+    maxy = nmaxy;
+    capacity = next;
+  };
+  let bailed = false;
+  const visit = (node) => {
+    if (bailed) return;
+    const index = count;
+    slotEntity.push(node);
+    count++;
+    grow(count);
+    if (node.getBounds() === null) {
+      boundless.push({ entity: node, index });
+      minx[index] = 0;
+      miny[index] = 0;
+      maxx[index] = 0;
+      maxy[index] = 0;
+    } else {
+      const slot = node._storeSlot;
+      if (slot < 0 || slot >= aabbs.aminx.length || storeSlotEntity[slot] !== node) {
+        bailed = true;
+        return;
+      }
+      minx[index] = aabbs.aminx[slot];
+      miny[index] = aabbs.aminy[slot];
+      maxx[index] = aabbs.amaxx[slot];
+      maxy[index] = aabbs.amaxy[slot];
+    }
+    const children = node.children;
+    for (let i = 0; i < children.length; i++) visit(children[i]);
+  };
+  visit(root);
+  if (bailed) return null;
+  out.count = count;
+  out.minx = minx;
+  out.miny = miny;
+  out.maxx = maxx;
+  out.maxy = maxy;
+  return out;
+}
+function createHitGatherBuffer() {
+  return {
+    count: 0,
+    slotEntity: [],
+    boundless: [],
+    minx: new Float64Array(256),
+    miny: new Float64Array(256),
+    maxx: new Float64Array(256),
+    maxy: new Float64Array(256)
+  };
+}
+
 // src/wasm/anim-backend.ts
 var PAD3 = 8;
 var AnimBackend = (_class3 = class {
@@ -852,7 +870,7 @@ var AnimBackend = (_class3 = class {
   __init13() {this.tweenCap = 0}
   
   
-  constructor(instance) {;_class3.prototype.__init12.call(this);_class3.prototype.__init13.call(this);
+  constructor(instance) {;_class3.prototype.__init12.call(this);_class3.prototype.__init13.call(this);_class3.prototype.__init14.call(this);
     this.ex = instance.exports;
   }
   /** The resident spring SoA input/output views, valid until the next capacity
@@ -878,14 +896,33 @@ var AnimBackend = (_class3 = class {
     this.ex.anim_init(this.springCap, this.tweenCap);
     this.refreshViews();
   }
-  /** Advance `count` springs (from index 0) by `dtMs` milliseconds, in place. */
+  /**
+   * Advance `count` springs (from index 0) by `dtMs` milliseconds, in place.
+   * Returns `true` when the kernel ran. `false` means it rejected the call
+   * (count beyond the capacity {@link ensure} allocated, or no `anim_init` yet)
+   * and wrote nothing, so the caller must tick those drivers in JS instead of
+   * scattering back a pack the kernel never touched. See {@link lastStatus}.
+   */
   stepSprings(dtMs, count) {
-    this.ex.spring_step(dtMs / 1e3, count);
+    this.lastStatus = this.ex.spring_step(dtMs / 1e3, count);
+    return this.lastStatus === WASM_STATUS.OK;
   }
-  /** Advance `count` tweens (from index 0) by `dtMs` milliseconds, writing `val`. */
+  /**
+   * Advance `count` tweens (from index 0) by `dtMs` milliseconds, writing `val`.
+   * Returns `true` when the kernel ran; `false` means it rejected the call and
+   * wrote nothing (see {@link stepSprings}). `elapsed` is kernel-side state, so
+   * a rejected tween pack must not be read back — it is unadvanced, not
+   * partially advanced.
+   */
   stepTweens(dtMs, count) {
-    this.ex.tween_step(dtMs, count);
+    this.lastStatus = this.ex.tween_step(dtMs, count);
+    return this.lastStatus === WASM_STATUS.OK;
   }
+  /**
+   * Status of the most recent kernel call — `WASM_STATUS.OK` unless the kernel
+   * declined it. Mirrors {@link TransformBackend.lastStatus}.
+   */
+  __init14() {this.lastStatus = WASM_STATUS.OK}
   refreshViews() {
     const buf = this.ex.memory.buffer;
     const sCap = this.springCap;
@@ -915,9 +952,9 @@ var PAD4 = 8;
 var CELLS_PER_ENTITY_HINT = 4;
 var HitTestBackend = (_class4 = class {
   
-  __init14() {this.entityCap = 0}
-  __init15() {this.cellCap = 0}
-  __init16() {this.itemCap = 0}
+  __init15() {this.entityCap = 0}
+  __init16() {this.cellCap = 0}
+  __init17() {this.itemCap = 0}
   
   
   
@@ -926,10 +963,10 @@ var HitTestBackend = (_class4 = class {
   
   
   /** Grid geometry from the last {@link ensure} call. */
-  __init17() {this.gridW = 0}
-  __init18() {this.gridH = 0}
-  __init19() {this.cellSize = 64}
-  constructor(instance) {;_class4.prototype.__init14.call(this);_class4.prototype.__init15.call(this);_class4.prototype.__init16.call(this);_class4.prototype.__init17.call(this);_class4.prototype.__init18.call(this);_class4.prototype.__init19.call(this);
+  __init18() {this.gridW = 0}
+  __init19() {this.gridH = 0}
+  __init20() {this.cellSize = 64}
+  constructor(instance) {;_class4.prototype.__init15.call(this);_class4.prototype.__init16.call(this);_class4.prototype.__init17.call(this);_class4.prototype.__init18.call(this);_class4.prototype.__init19.call(this);_class4.prototype.__init20.call(this);
     this.ex = instance.exports;
   }
   /** The resident AABB input views (`minx/miny/maxx/maxy`), valid until the
@@ -1013,9 +1050,9 @@ var HitTestBackend = (_class4 = class {
 var PAD5 = 8;
 var ParticleBackend = (_class5 = class {
   
-  __init20() {this.cap = 0}
+  __init21() {this.cap = 0}
   
-  constructor(instance) {;_class5.prototype.__init20.call(this);
+  constructor(instance) {;_class5.prototype.__init21.call(this);_class5.prototype.__init22.call(this);
     this.ex = instance.exports;
   }
   /** The resident SoA views, valid until the next capacity growth. */
@@ -1036,6 +1073,12 @@ var ParticleBackend = (_class5 = class {
    * Advance `count` particles one step in place. Returns `true` when at least
    * one live particle is still moving or off-origin beyond epsilon (the fused
    * `hasPendingAnimations` flag), so the caller need not re-scan the buffer.
+   *
+   * Returns `null` when the kernel REJECTED the call — `count` beyond the
+   * capacity {@link ensure} allocated, or no `particle_init` yet. Nothing was
+   * written, so the caller must NOT {@link scatter} (that would write the
+   * gathered pre-step values back and freeze the simulation) and should fall
+   * back to the JS `updateCPU` path for this frame. See {@link lastStatus}.
    */
   step(count, p) {
     const e = p.explosion;
@@ -1055,8 +1098,18 @@ var ParticleBackend = (_class5 = class {
       e ? e.force : 0,
       count
     );
+    if (flag < 0) {
+      this.lastStatus = -flag;
+      return null;
+    }
+    this.lastStatus = WASM_STATUS.OK;
     return flag !== 0;
   }
+  /**
+   * Status of the most recent {@link step} — `WASM_STATUS.OK` unless the kernel
+   * declined it. Mirrors {@link TransformBackend.lastStatus}.
+   */
+  __init22() {this.lastStatus = WASM_STATUS.OK}
   /** Transpose the AoS stride-8 buffer into the SoA views (position/velocity/
    *  life every frame; origin upload-once when `withOrigin`). */
   gather(data, count, withOrigin) {
@@ -1147,11 +1200,11 @@ async function loadCoreWasmModule(source) {
 }
 var CoreWasmRuntime = (_class6 = class {
   
-  __init21() {this.transformBackend = null}
-  __init22() {this.animBackend = null}
-  __init23() {this.hitBackend = null}
-  __init24() {this.particleBackendInstance = null}
-  constructor(instance) {;_class6.prototype.__init21.call(this);_class6.prototype.__init22.call(this);_class6.prototype.__init23.call(this);_class6.prototype.__init24.call(this);
+  __init23() {this.transformBackend = null}
+  __init24() {this.animBackend = null}
+  __init25() {this.hitBackend = null}
+  __init26() {this.particleBackendInstance = null}
+  constructor(instance) {;_class6.prototype.__init23.call(this);_class6.prototype.__init24.call(this);_class6.prototype.__init25.call(this);_class6.prototype.__init26.call(this);
     this.instance = instance;
   }
   /**
@@ -1520,15 +1573,15 @@ var Scene = (_class7 = class _Scene {
   
   
   
-  __init25() {this.isRunning = false}
+  __init27() {this.isRunning = false}
   /** Whether the canvas is at least partially in the viewport. When it scrolls
    *  fully off-screen the rAF loop pauses (stops rescheduling) instead of
    *  burning frames on a scene nobody can see; an IntersectionObserver resumes
    *  it on re-entry. Defaults true (and stays true where IntersectionObserver
    *  is unavailable, e.g. SSR/jsdom, so behavior is unchanged there). */
-  __init26() {this._canvasOnScreen = true}
-  __init27() {this._canvasObserver = null}
-  __init28() {this.lastTime = 0}
+  __init28() {this._canvasOnScreen = true}
+  __init29() {this._canvasObserver = null}
+  __init30() {this.lastTime = 0}
   
   /**
    * Redraw strategy:
@@ -1537,11 +1590,11 @@ var Scene = (_class7 = class _Scene {
    *   {@link markDirty}) or while an animation is pending. Ideal for static /
    *   event-driven UIs where idle frames should cost ~0.
    */
-  __init29() {this.renderMode = "always"}
+  __init31() {this.renderMode = "always"}
   /** Cap on distinct recorded dirty reasons (see `recordDirtyReason`). */
   static __initStatic4() {this.MAX_DIRTY_REASONS = 200}
-  __init30() {this._phaseTiming = false}
-  __init31() {this._phaseTotals = /* @__PURE__ */ new Map()}
+  __init32() {this._phaseTiming = false}
+  __init33() {this._phaseTotals = /* @__PURE__ */ new Map()}
   /**
    * Start or stop per-phase render timing.
    *
@@ -1604,32 +1657,32 @@ var Scene = (_class7 = class _Scene {
   clearRenderPhases() {
     this._phaseTotals.clear();
   }
-  __init32() {this._dirtyTracking = false}
-  __init33() {this._dirtyReasons = /* @__PURE__ */ new Map()}
-  __init34() {this.dirty = true}
+  __init34() {this._dirtyTracking = false}
+  __init35() {this._dirtyReasons = /* @__PURE__ */ new Map()}
+  __init36() {this.dirty = true}
   /** Whether to throttle rendering to 2 FPS when the scene is static to save power. */
-  __init35() {this.autoThrottle = true}
+  __init37() {this.autoThrottle = true}
   // --- Frame telemetry (read via `frameStats`) ---------------------------
   /** Wall-clock ms spent inside the last `render()` call. */
-  __init36() {this._lastFrameMs = 0}
+  __init38() {this._lastFrameMs = 0}
   /** Rolling exponential average of rendered-frame intervals, in ms. */
-  __init37() {this._avgFrameIntervalMs = 0}
+  __init39() {this._avgFrameIntervalMs = 0}
   /** dt (ms) handed to the last rendered frame. */
-  __init38() {this._lastDt = 0}
+  __init40() {this._lastDt = 0}
   /** Count of frames actually rendered since the loop started. */
-  __init39() {this._renderedFrames = 0}
+  __init41() {this._renderedFrames = 0}
   /** Count of rAF ticks skipped (idle / capped) since the loop started. */
-  __init40() {this._skippedFrames = 0}
+  __init42() {this._skippedFrames = 0}
   /** `time` of the previous *rendered* frame, for interval measurement. */
-  __init41() {this._lastRenderTick = 0}
+  __init43() {this._lastRenderTick = 0}
   /**
    * Frame-rate cap (power saving). `0` = uncapped (native refresh). When set,
    * the loop renders at most `maxFPS` times per second; animations still run,
    * just less often. See {@link SceneOptions.maxFPS}.
    */
-  __init42() {this.maxFPS = 60}
+  __init44() {this.maxFPS = 60}
   /** Whether the OS prefers-reduced-motion setting auto-caps the loop. */
-  __init43() {this.respectReducedMotion = true}
+  __init45() {this.respectReducedMotion = true}
   /**
    * Reading direction for accessibility tab/traversal order (`'ltr'` default,
    * `'rtl'`). Controls the inline sort within a visual row in
@@ -1645,15 +1698,15 @@ var Scene = (_class7 = class _Scene {
       this.a11yNeedsReorder = true;
     }
   }
-  __init44() {this._readingDirection = "ltr"}
+  __init46() {this._readingDirection = "ltr"}
   /** Cached media-query list; `.matches` is read live each frame. */
-  __init45() {this.reducedMotionQuery = null}
+  __init47() {this.reducedMotionQuery = null}
   /** Cached `(forced-colors: active)` query (Windows High Contrast etc.). A
    *  canvas gets NO automatic forced-colors treatment from the browser (it's
    *  opaque pixels), so components must read {@link forcedColors} and repaint
    *  with system colors themselves; a change listener repaints idle scenes. */
-  __init46() {this.forcedColorsQuery = null}
-  __init47() {this.forcedColorsChangeHandler = null}
+  __init48() {this.forcedColorsQuery = null}
+  __init49() {this.forcedColorsChangeHandler = null}
   /** True when the OS asks for reduced motion and we respect it. Read by the animation drivers. */
   get prefersReducedMotion() {
     return this.respectReducedMotion && !!_optionalChain([this, 'access', _21 => _21.reducedMotionQuery, 'optionalAccess', _22 => _22.matches]);
@@ -1673,22 +1726,22 @@ var Scene = (_class7 = class _Scene {
    * Throttle interval (ms) for the a11y/automation shadow sync. `0` = every
    * frame. See {@link SceneOptions.a11ySyncInterval}.
    */
-  __init48() {this.a11ySyncInterval = 0}
+  __init50() {this.a11ySyncInterval = 0}
   /** Timestamp of the last a11y sync, for throttling. */
-  __init49() {this.lastA11ySync = -Infinity}
+  __init51() {this.lastA11ySync = -Infinity}
   /** True if we skipped an a11y sync during animation and need to sync when at rest. */
-  __init50() {this.a11yPendingSyncAfterAnimation = false}
+  __init52() {this.a11yPendingSyncAfterAnimation = false}
   // A11y / Automation Layer. `null` in non-DOM (SSR/Node) environments — the
   // whole projection degrades to a no-op so the engine's logic stays usable
   // server-side (e.g. headless layout / vector export) without jsdom.
   
-  __init51() {this.a11yElements = /* @__PURE__ */ new Map()}
+  __init53() {this.a11yElements = /* @__PURE__ */ new Map()}
   /** DOM nodes mirroring static text content, keyed by entity id. */
-  __init52() {this.contentElements = /* @__PURE__ */ new Map()}
+  __init54() {this.contentElements = /* @__PURE__ */ new Map()}
   /** Pending cold font-calibration frame per projected grid entity. */
-  __init53() {this.contentGridCalibrationFrames = /* @__PURE__ */ new Map()}
+  __init55() {this.contentGridCalibrationFrames = /* @__PURE__ */ new Map()}
   /** Detached, untransformed font probes used by the cold calibration pass. */
-  __init54() {this.contentGridCalibrationProbes = /* @__PURE__ */ new Map()}
+  __init56() {this.contentGridCalibrationProbes = /* @__PURE__ */ new Map()}
   /**
    * Monotonic stamp identifying the conditions grid cells were calibrated under.
    *
@@ -1709,69 +1762,69 @@ var Scene = (_class7 = class _Scene {
    * A plain incrementing integer rather than the descriptive calibration key,
    * because it goes into an attribute selector and must not need escaping.
    */
-  __init55() {this.contentGridCalibrationGeneration = 0}
+  __init57() {this.contentGridCalibrationGeneration = 0}
   /** The `(fontEpoch, pageScale)` pair the current generation corresponds to. */
-  __init56() {this.contentGridCalibrationStamp = ""}
+  __init58() {this.contentGridCalibrationStamp = ""}
   /** Invalidates grid font calibration after browser font availability changes. */
-  __init57() {this.contentFontEpoch = 0}
+  __init59() {this.contentFontEpoch = 0}
   /** Cached Canvas-to-client scale for the current font/viewport epoch. */
-  __init58() {this.contentMetricScaleEpoch = -1}
-  __init59() {this.contentMetricScaleX = 1}
-  __init60() {this.contentProjectionEnabled = true}
+  __init60() {this.contentMetricScaleEpoch = -1}
+  __init61() {this.contentMetricScaleX = 1}
+  __init62() {this.contentProjectionEnabled = true}
   // Virtualization margin (px) for content projection; `undefined` → one
   // viewport height, resolved at sync time. `Infinity` = materialize everything.
-  __init61() {this.contentProjectionMargin = void 0}
+  __init63() {this.contentProjectionMargin = void 0}
   /**
    * True while a text-selection drag that started on a projection's blank
    * region (no text node under the press) is being driven manually — the
    * browser has no native anchor for it, so mousemove extends the Selection
    * from the position we resolved ourselves.
    */
-  __init62() {this.blankRegionSelectionDrag = false}
-  __init63() {this.contentSelectionAnchor = null}
-  __init64() {this.contentSelectionEndListener = null}
+  __init64() {this.blankRegionSelectionDrag = false}
+  __init65() {this.contentSelectionAnchor = null}
+  __init66() {this.contentSelectionEndListener = null}
   // Animation/interactive flags collected during the render walk (tree-walk
   // fusion): the loop reads last frame's answers instead of re-walking the
   // tree up to 4× per tick. Start true so the first tick stays conservative.
-  __init65() {this.frameHadAnimation = true}
-  __init66() {this.frameHadInteractive = true}
+  __init67() {this.frameHadAnimation = true}
+  __init68() {this.frameHadInteractive = true}
   
   /** Active `(resolution: Ndppx)` media query watching for a runtime DPR change
    *  (window moved between monitors, browser zoom) so the canvas backing store
    *  can be re-scaled — otherwise it stays rasterized at the old DPR and blurs.
    *  A resolution media query only fires when leaving its exact value, so the
    *  handler re-arms a fresh query for the new DPR each time. */
-  __init67() {this.dprMediaQuery = null}
+  __init69() {this.dprMediaQuery = null}
   /** For embedded (`disableWindowResize`) scenes: observes the canvas element so
    *  a CSS/layout-driven size change re-runs `resize()`. A window `resize`
    *  listener never fires for these (the window isn't what changed), so without
    *  this an embedded canvas stayed at its initial size forever. */
-  __init68() {this.canvasResizeObserver = null}
-  __init69() {this.dprChangeHandler = null}
-  __init70() {this.focusedA11yElement = null}
+  __init70() {this.canvasResizeObserver = null}
+  __init71() {this.dprChangeHandler = null}
+  __init72() {this.focusedA11yElement = null}
   /** Last geometry `syncOverlayGeometry` wrote, so an unchanged frame can skip the
    *  style writes entirely. Reset to `null` to force the next sync (a new overlay
    *  layer was created and has never been positioned). */
-  __init71() {this._overlayGeometry = null}
+  __init73() {this._overlayGeometry = null}
   /** Shadow elements the pointer is currently inside. Lets a removal that happens
    *  mid-hover synthesize the `pointerleave` the browser never sends for a
    *  detached element, so the entity doesn't keep its hover state. */
-  __init72() {this.hoveredA11yElements = /* @__PURE__ */ new WeakSet()}
+  __init74() {this.hoveredA11yElements = /* @__PURE__ */ new WeakSet()}
   /** Persistent tabindex=-1 element in a11yRoot. When the focused a11y mirror is
    *  pruned (virtualization/streaming/removal) while it holds focus, we move
    *  focus here instead of letting the browser drop it to <body> — keeping the
    *  screen-reader virtual cursor inside the scene's a11y region. */
-  __init73() {this.focusSentinel = null}
-  __init74() {this.caretBlinkTimer = null}
-  __init75() {this.a11yNeedsReorder = true}
-  __init76() {this.portalRoot = null}
-  __init77() {this.fullViewportElements = []}
-  __init78() {this.normalElements = []}
-  __init79() {this.activeIds = /* @__PURE__ */ new Set()}
-  __init80() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
-  __init81() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
-  __init82() {this.portalEntities = /* @__PURE__ */ new Map()}
-  __init83() {this.renderOrderCounter = 0}
+  __init75() {this.focusSentinel = null}
+  __init76() {this.caretBlinkTimer = null}
+  __init77() {this.a11yNeedsReorder = true}
+  __init78() {this.portalRoot = null}
+  __init79() {this.fullViewportElements = []}
+  __init80() {this.normalElements = []}
+  __init81() {this.activeIds = /* @__PURE__ */ new Set()}
+  __init82() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
+  __init83() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
+  __init84() {this.portalEntities = /* @__PURE__ */ new Map()}
+  __init85() {this.renderOrderCounter = 0}
   /**
    * Monotonic render-frame counter, bumped once per authoritative `render()`
    * pass. Entities stamp their per-frame world-matrix cache with this value and
@@ -1780,7 +1833,7 @@ var Scene = (_class7 = class _Scene {
    * back to the ancestor walk. Public for the same reason `Entity._getTrig`/
    * `_setWorldCache` are: it is a cross-class render-internal contract.
    */
-  __init84() {this.currentFrame = 0}
+  __init86() {this.currentFrame = 0}
   // ── WASM transform backend (invisible accelerator) ──────────────────────────
   // When `_transformBackend === 'wasm'`, the main render walk sources each
   // entity's world matrix from an SoA store composed by `_wasm` (see
@@ -1788,24 +1841,24 @@ var Scene = (_class7 = class _Scene {
   // fallback and the default: a null backend, a non-main renderer, or any entity
   // absent from the store all fall back to the JS composition, so WASM can only
   // ever change *how fast* a world matrix is produced, never *what* it is.
-  __init85() {this._wasm = null}
-  __init86() {this._transformBackend = "js"}
+  __init87() {this._wasm = null}
+  __init88() {this._transformBackend = "js"}
   // Resident store state (Stage 3). The store layout — slot assignment + sibling
   // runs — depends only on tree TOPOLOGY, so it is rebuilt only when the
   // structure changes (add/remove/reparent bump `_structureVersion`). Between
   // rebuilds the per-frame cost is: gather each entity's transform into the
   // resident wasm input view + run the kernel — no reallocation, no readback.
-  __init87() {this._treeStore = null}
-  __init88() {this._slotEntity = []}
+  __init89() {this._treeStore = null}
+  __init90() {this._slotEntity = []}
   // store slot -> entity (also validates slots)
-  __init89() {this._wasmInputs = null}
-  __init90() {this._wasmWorld = null}
-  __init91() {this._structureVersion = 0}
-  __init92() {this._storeStructureVersion = -1}
+  __init91() {this._wasmInputs = null}
+  __init92() {this._wasmWorld = null}
+  __init93() {this._structureVersion = 0}
+  __init94() {this._storeStructureVersion = -1}
   // Cached list of ComputeParticleEntity instances in the tree, keyed by the
   // structure version it was gathered at. Rebuilt only on a topology change.
-  __init93() {this._computeEntities = []}
-  __init94() {this._computeEntitiesVersion = -1}
+  __init95() {this._computeEntities = []}
+  __init96() {this._computeEntitiesVersion = -1}
   /** Invalidate the resident WASM store layout; the next wasm-mode frame rebuilds
    *  it. Called by `Entity.add`/`remove` (topology changes only). */
   markStructureChanged() {
@@ -1867,10 +1920,13 @@ var Scene = (_class7 = class _Scene {
     return true;
   }
   // ── WASM hit-test backend (invisible accelerator, G3) ───────────────────────
-  // A separate WASM module instance from the transform backend (each crate
-  // export lives in independent linear memory per instance, so there is no
-  // shared-state hazard in running both) that indexes the main tree's world
-  // AABBs into a dense viewport grid for findEntityAt. The JS depth-first walk
+  // Served by the same instance as every other accelerator (see
+  // `_wasmRuntime`): the crate keeps transform/anim/hit/particle in distinct
+  // statics, so one instance runs them all without aliasing. It indexes the
+  // main tree's world AABBs into a dense viewport grid for findEntityAt. Note
+  // that sharing one linear memory means an allocation here can grow it and
+  // detach views built over the old buffer, so each backend re-checks buffer
+  // identity (`revalidateViews`) before use. The JS depth-first walk
   // (findHitRecursively) is the permanent fallback: a null backend, a build
   // that overflows its item budget, or the overlay tree (never indexed — small
   // and rare, not worth accelerating) all fall through to it, so WASM can only
@@ -1887,7 +1943,7 @@ var Scene = (_class7 = class _Scene {
    * cached globally; the instance is per-Scene, which is the isolation that
    * actually matters.
    */
-  __init95() {this._wasmRuntime = null}
+  __init97() {this._wasmRuntime = null}
   /**
    * Load (or reuse) this Scene's shared WASM runtime.
    *
@@ -1915,34 +1971,98 @@ var Scene = (_class7 = class _Scene {
   get wasmRuntime() {
     return this._wasmRuntime;
   }
-  __init96() {this._hitWasm = null}
+  __init98() {this._hitWasm = null}
   // Cache key: which frame + structure version the grid was last (successfully,
   // non-overflowing) built for. findEntityAt is called ad-hoc (pointer
   // hover/click), not every frame, so the grid is refreshed lazily on demand
   // rather than proactively every render() — unlike the transform store, which
   // every frame's draw depends on.
-  __init97() {this._hitGridFrame = -1}
-  __init98() {this._hitGridOk = false}
-  __init99() {this._hitSlotEntity = []}
-  __init100() {this._hitBoundless = []}
+  __init99() {this._hitGridFrame = -1}
+  __init100() {this._hitGridOk = false}
+  __init101() {this._hitSlotEntity = []}
+  __init102() {this._hitBoundless = []}
   /** Reused buffer for the fused gather, so a pointer query allocates nothing. */
-  __init101() {this._hitGatherBuffer = null}
+  __init103() {this._hitGatherBuffer = null}
   /**
    * Whether the last grid build sourced its AABBs from the WASM transform store
    * rather than recomputing them in JS. Diagnostic only — both paths must
    * produce the same entity for a given point.
    */
-  __init102() {this._hitFusedGather = false}
+  __init104() {this._hitFusedGather = false}
   /**
    * Whether `compute_aabbs` has run against the current frame's world matrices.
    * The AABB pass is only meaningful after a `compose_*`, so the fused gather
    * must not read the views before then.
    */
-  __init103() {this._wasmAabbsFresh = false}
+  __init105() {this._wasmAabbsFresh = false}
   /** Did the last hit-grid build use the fused (WASM-store) gather? */
   get hitGatherPath() {
     return this._hitFusedGather ? "fused" : "js";
   }
+  /**
+   * Why the transform accelerator did or did not run on the most recent frame.
+   * Written by the render walk and `_syncWasmStore`.
+   */
+  __init106() {this._transformReason = "not-installed"}
+  /** Why the batched-driver accelerator did or did not run. */
+  __init107() {this._animReason = "not-installed"}
+  /**
+   * Why the hit-test accelerator did or did not serve the last pointer query.
+   * The grid is built lazily on demand, not every frame, so this describes the
+   * most recent BUILD. Starts at `'not-installed'` because that is the truth
+   * before a backend exists; `_ensureHitGrid` moves it to `'not-applicable'`
+   * once one is installed but nothing has queried yet.
+   */
+  __init108() {this._hitReason = "not-installed"}
+  /** Why the particle accelerator did or did not run. */
+  __init109() {this._particleReason = "not-applicable"}
+  /** Which particle implementation actually simulated the most recent frame. */
+  __init110() {this._particlePath = "none"}
+  /**
+   * Per-frame status of every invisible accelerator: whether each is installed,
+   * whether it actually ran on the most recent frame, and why.
+   *
+   * This exists because the older per-accelerator getters
+   * ({@link transformBackend}, {@link animBackend}, {@link hitTestBackend},
+   * {@link particleBackend}) report only that a backend is INSTALLED. Reading
+   * `'wasm'` from one of those and concluding the accelerator is doing work is
+   * wrong whenever a gate never opens, a kernel rejects its arguments, or a
+   * faster backend takes the pass instead. Read {@link AcceleratorStatus.reason}
+   * for which of those happened.
+   *
+   * Reflects the most recent main-renderer frame; a secondary renderer (SVG
+   * export, offscreen snapshot) does not overwrite it.
+   */
+  get accelerators() {
+    return {
+      transform: {
+        available: this._wasm !== null && this._transformBackend === "wasm",
+        activeThisFrame: this._transformReason === "active",
+        reason: this._transformReason,
+        path: this._transformReason === "active" ? "wasm" : "js"
+      },
+      animation: {
+        available: this._animWasm !== null,
+        activeThisFrame: this._animBatchedLastFrame,
+        reason: this._animReason,
+        path: this._animBatchedLastFrame ? "wasm" : "js"
+      },
+      hitTest: {
+        available: this._hitWasm !== null,
+        // The grid is built lazily on a pointer query, not every frame, so this
+        // describes the last BUILD rather than the last frame.
+        activeThisFrame: this._hitReason === "active",
+        reason: this._hitReason,
+        path: this._hitReason !== "active" ? "js" : this._hitFusedGather ? "wasm-fused" : "wasm"
+      },
+      particle: {
+        available: this._particleWasm !== null || this.webgpuActive,
+        activeThisFrame: this._particleReason === "active",
+        reason: this._particleReason,
+        path: this._particlePath
+      }
+    };
+  }
   /** Which backend answers `findEntityAt` for the main tree. */
   get hitTestBackend() {
     return this._hitWasm ? "wasm" : "js";
@@ -1952,6 +2072,7 @@ var Scene = (_class7 = class _Scene {
   setHitTestBackend(backend) {
     this._hitWasm = backend;
     this._hitGridFrame = -1;
+    this._hitReason = backend ? "not-applicable" : "not-installed";
   }
   /**
    * Asynchronously instantiate the WASM hit-test core and, on success, hot-swap
@@ -1978,7 +2099,10 @@ var Scene = (_class7 = class _Scene {
    */
   _ensureHitGrid() {
     const backend = this._hitWasm;
-    if (!backend) return false;
+    if (!backend) {
+      this._hitReason = "not-installed";
+      return false;
+    }
     if (this._hitGridFrame === this.currentFrame) return this._hitGridOk;
     let gathered = null;
     if (this._wasm && this._ensureWasmAabbs()) {
@@ -2007,6 +2131,7 @@ var Scene = (_class7 = class _Scene {
     this._hitBoundless = gathered.boundless;
     this._hitGridFrame = this.currentFrame;
     this._hitGridOk = ok;
+    this._hitReason = ok ? "active" : "rejected";
     return ok;
   }
   /**
@@ -2052,25 +2177,25 @@ var Scene = (_class7 = class _Scene {
   // EasingFn (which cannot cross into WASM) all fall through to it — WASM can
   // only ever change *how* a driver is advanced, never *what* value it lands
   // on.
-  __init104() {this._animWasm = null}
+  __init111() {this._animWasm = null}
   // Entities with at least one active driver, added by Entity._spawnDriver.
   // Self-pruning: _tickBatchedDrivers drops an entry the first time it visits
   // an entity whose drivers have since all completed or been removed. This is
   // what lets the batch pass find its candidates in O(active drivers), not
   // O(tree size) — the exact mistake G3's first integrated benchmark made.
-  __init105() {this._activeDriverEntities = /* @__PURE__ */ new Set()}
+  __init112() {this._activeDriverEntities = /* @__PURE__ */ new Set()}
   // Reused across frames instead of allocating a fresh array + N {entity,prop,
   // driver} objects every call — the integrated benchmark
   // (benchmarks/anim-wasm-scene) found that allocation churn was the
   // dominant integrated cost, not the wasm kernel itself. Parallel arrays,
   // truncated to the live count after each use so a stale tail slot never
   // pins a no-longer-active entity/driver in memory.
-  __init106() {this._springEntities = []}
-  __init107() {this._springProps = []}
-  __init108() {this._springDrivers = []}
-  __init109() {this._tweenEntities = []}
-  __init110() {this._tweenProps = []}
-  __init111() {this._tweenDrivers = []}
+  __init113() {this._springEntities = []}
+  __init114() {this._springProps = []}
+  __init115() {this._springDrivers = []}
+  __init116() {this._tweenEntities = []}
+  __init117() {this._tweenProps = []}
+  __init118() {this._tweenDrivers = []}
   /**
    * Minimum number of batchable (spring, or named-easing tween) active drivers
    * before a frame engages the WASM batch path at all; below it, every driver
@@ -2142,7 +2267,7 @@ var Scene = (_class7 = class _Scene {
    * Setting {@link animDriverGateCount} overwrites all three, so existing code
    * that tuned the single knob keeps working unchanged.
    */
-  __init112() {this._animBatchedLastFrame = false}
+  __init119() {this._animBatchedLastFrame = false}
   /**
    * Whether the WASM batch path actually ran on the most recent frame.
    *
@@ -2154,7 +2279,7 @@ var Scene = (_class7 = class _Scene {
   get animBatchedLastFrame() {
     return this._animBatchedLastFrame;
   }
-  __init113() {this.animGate = {
+  __init120() {this.animGate = {
     spring: 128,
     tween: 256,
     mixed: 128
@@ -2192,7 +2317,7 @@ var Scene = (_class7 = class _Scene {
   // (benchmarks/particle-wasm). f32 (matches the WGSL shader), bit-identical to
   // a JS f32 reference oracle; updateCPU (f64) stays the permanent fallback when
   // no backend is installed or a scene runs on WebGPU.
-  __init114() {this._particleWasm = null}
+  __init121() {this._particleWasm = null}
   /** Which backend runs the CPU particle simulation. Reflects only whether a
    *  backend is installed (the WebGPU compute path, when active, is used first
    *  regardless). */
@@ -2272,7 +2397,10 @@ var Scene = (_class7 = class _Scene {
    * pre-pass.
    */
   _tickBatchedDrivers(dt) {
-    if (this._activeDriverEntities.size === 0) return;
+    if (this._activeDriverEntities.size === 0) {
+      this._animReason = "not-applicable";
+      return;
+    }
     let springBatchable = 0;
     let tweenBatchable = 0;
     for (const entity of this._activeDriverEntities) {
@@ -2289,10 +2417,17 @@ var Scene = (_class7 = class _Scene {
     const batchable = springBatchable + tweenBatchable;
     const backend = this._animWasm;
     this._animBatchedLastFrame = false;
-    if (!backend) return;
+    if (!backend) {
+      this._animReason = "not-installed";
+      return;
+    }
     const gate = springBatchable > 0 && tweenBatchable > 0 ? this.animGate.mixed : tweenBatchable > 0 ? this.animGate.tween : this.animGate.spring;
-    if (batchable < gate) return;
+    if (batchable < gate) {
+      this._animReason = "below-gate";
+      return;
+    }
     this._animBatchedLastFrame = true;
+    this._animReason = "active";
     const sE = this._springEntities;
     const sP = this._springProps;
     const sD = this._springDrivers;
@@ -2339,8 +2474,13 @@ var Scene = (_class7 = class _Scene {
         sv.damp[i] = phys.damping;
         sv.mass[i] = phys.mass;
       }
-      backend.stepSprings(dt, springCount);
-      for (let i = 0; i < springCount; i++) sD[i].syncExternal(sv.val[i], sv.vel[i]);
+      if (backend.stepSprings(dt, springCount)) {
+        for (let i = 0; i < springCount; i++) sD[i].syncExternal(sv.val[i], sv.vel[i]);
+      } else {
+        for (let i = 0; i < springCount; i++) sD[i].tick(dt);
+        this._animReason = "rejected";
+        this._animBatchedLastFrame = false;
+      }
     }
     if (tweenCount > 0) {
       const tv = backend.tweenView();
@@ -2353,8 +2493,13 @@ var Scene = (_class7 = class _Scene {
         tv.delay[i] = d.delayMs;
         tv.ease[i] = d.wasmEasingId;
       }
-      backend.stepTweens(dt, tweenCount);
-      for (let i = 0; i < tweenCount; i++) tD[i].syncExternal(tv.val[i], tv.elapsed[i]);
+      if (backend.stepTweens(dt, tweenCount)) {
+        for (let i = 0; i < tweenCount; i++) tD[i].syncExternal(tv.val[i], tv.elapsed[i]);
+      } else {
+        for (let i = 0; i < tweenCount; i++) tD[i].tick(dt);
+        this._animReason = "rejected";
+        this._animBatchedLastFrame = false;
+      }
     }
     for (let i = 0; i < springCount; i++) sE[i]._applyDriverTick(sP[i], sD[i]);
     for (let i = 0; i < tweenCount; i++) tE[i]._applyDriverTick(tP[i], tD[i]);
@@ -2376,7 +2521,10 @@ var Scene = (_class7 = class _Scene {
         slotEntity2[slot] = entity;
         entity._storeSlot = slot;
       }
-      backend.uploadRuns(built.store);
+      if (!backend.uploadRuns(built.store)) {
+        this._transformReason = "rejected";
+        return null;
+      }
       this._treeStore = built.store;
       this._slotEntity = slotEntity2;
       this._wasmInputs = backend.inputView();
@@ -2401,8 +2549,12 @@ var Scene = (_class7 = class _Scene {
       inp.sin[slot] = trig.sin;
       inp.opacity[slot] = e.opacity;
     }
-    backend.runKernel("simd");
+    if (backend.runKernel("simd") !== WASM_STATUS.OK) {
+      this._transformReason = "rejected";
+      return null;
+    }
     this._wasmAabbsFresh = false;
+    this._transformReason = "active";
     return this._wasmWorld;
   }
   /**
@@ -2432,7 +2584,7 @@ var Scene = (_class7 = class _Scene {
       bounds.bw[slot] = b ? b.width : 0;
       bounds.bh[slot] = b ? b.height : 0;
     }
-    backend.runAabbs(slotEntity.length);
+    if (!backend.runAabbs(slotEntity.length)) return false;
     this._wasmAabbsFresh = true;
     return true;
   }
@@ -2442,24 +2594,24 @@ var Scene = (_class7 = class _Scene {
    * sync, so retaining the order prevents a newly opened overlay from spending
    * its first frame below previously projected controls.
    */
-  __init115() {this.a11yRenderOrders = /* @__PURE__ */ new Map()}
+  __init122() {this.a11yRenderOrders = /* @__PURE__ */ new Map()}
   // Optional WebGL point-cloud layer (see SceneOptions.pointBackend).
-  __init116() {this.pointRenderer = null}
-  __init117() {this.glCanvas = null}
-  __init118() {this.glContextLostHandler = null}
-  __init119() {this.glContextRestoredHandler = null}
+  __init123() {this.pointRenderer = null}
+  __init124() {this.glCanvas = null}
+  __init125() {this.glContextLostHandler = null}
+  __init126() {this.glContextRestoredHandler = null}
   
   
   
-  __init120() {this.disableWindowResize = false}
+  __init127() {this.disableWindowResize = false}
   /** See {@link SceneOptions.maxDPR}. `undefined` = uncapped (real DPR). */
   
   // WebGPU properties
-  __init121() {this.destroyed = false}
-  __init122() {this.device = null}
-  __init123() {this.deviceLost = false}
-  __init124() {this.particleBackend = "auto"}
-  __init125() {this._webgpuDisabled = false}
+  __init128() {this.destroyed = false}
+  __init129() {this.device = null}
+  __init130() {this.deviceLost = false}
+  __init131() {this.particleBackend = "auto"}
+  __init132() {this._webgpuDisabled = false}
   get webgpuDisabled() {
     return this._webgpuDisabled || this.particleBackend === "cpu";
   }
@@ -2487,22 +2639,22 @@ var Scene = (_class7 = class _Scene {
   set webgpuDisabled(value) {
     this._webgpuDisabled = value;
   }
-  __init126() {this.recoveryTimerId = null}
-  __init127() {this.manager = null}
-  __init128() {this.initializingWebGPU = false}
-  __init129() {this.gpuCanvas = null}
-  __init130() {this.gpuContext = null}
+  __init133() {this.recoveryTimerId = null}
+  __init134() {this.manager = null}
+  __init135() {this.initializingWebGPU = false}
+  __init136() {this.gpuCanvas = null}
+  __init137() {this.gpuContext = null}
   /** True while the GPU canvas holds a presented particle frame (needs clearing when they leave). */
-  __init131() {this.gpuHasContent = false}
-  __init132() {this.mouseX = -9999}
-  __init133() {this.mouseY = -9999}
-  __init134() {this.pointerMoveListener = null}
-  __init135() {this.pointerLeaveListener = null}
+  __init138() {this.gpuHasContent = false}
+  __init139() {this.mouseX = -9999}
+  __init140() {this.mouseY = -9999}
+  __init141() {this.pointerMoveListener = null}
+  __init142() {this.pointerLeaveListener = null}
   /** Element the pointer listeners are bound to (parent container if present,
    *  else the canvas). Stored so `destroy()` detaches from the same element. */
-  __init136() {this.pointerEventTarget = null}
-  __init137() {this.hasWarnedZeroSize = false}
-  __init138() {this.fontLoadHandler = null}
+  __init143() {this.pointerEventTarget = null}
+  __init144() {this.hasWarnedZeroSize = false}
+  __init145() {this.fontLoadHandler = null}
   // ── Dev-mode warning infrastructure ──────────────────────────────
   //
   // Enable with `Scene.devMode = true` or by setting `globalThis.__DEV__`.
@@ -2520,7 +2672,7 @@ var Scene = (_class7 = class _Scene {
     return false;
   }
   
-  __init139() {this._devFrameCount = 0}
+  __init146() {this._devFrameCount = 0}
   _devWarn(message) {
     if (!this._devActive) return;
     console.warn(`[vectojs/dev] ${message}`);
@@ -2564,7 +2716,7 @@ var Scene = (_class7 = class _Scene {
     };
     walkProjections(this.root);
   }
-  constructor(canvas, options = {}) {;_class7.prototype.__init25.call(this);_class7.prototype.__init26.call(this);_class7.prototype.__init27.call(this);_class7.prototype.__init28.call(this);_class7.prototype.__init29.call(this);_class7.prototype.__init30.call(this);_class7.prototype.__init31.call(this);_class7.prototype.__init32.call(this);_class7.prototype.__init33.call(this);_class7.prototype.__init34.call(this);_class7.prototype.__init35.call(this);_class7.prototype.__init36.call(this);_class7.prototype.__init37.call(this);_class7.prototype.__init38.call(this);_class7.prototype.__init39.call(this);_class7.prototype.__init40.call(this);_class7.prototype.__init41.call(this);_class7.prototype.__init42.call(this);_class7.prototype.__init43.call(this);_class7.prototype.__init44.call(this);_class7.prototype.__init45.call(this);_class7.prototype.__init46.call(this);_class7.prototype.__init47.call(this);_class7.prototype.__init48.call(this);_class7.prototype.__init49.call(this);_class7.prototype.__init50.call(this);_class7.prototype.__init51.call(this);_class7.prototype.__init52.call(this);_class7.prototype.__init53.call(this);_class7.prototype.__init54.call(this);_class7.prototype.__init55.call(this);_class7.prototype.__init56.call(this);_class7.prototype.__init57.call(this);_class7.prototype.__init58.call(this);_class7.prototype.__init59.call(this);_class7.prototype.__init60.call(this);_class7.prototype.__init61.call(this);_class7.prototype.__init62.call(this);_class7.prototype.__init63.call(this);_class7.prototype.__init64.call(this);_class7.prototype.__init65.call(this);_class7.prototype.__init66.call(this);_class7.prototype.__init67.call(this);_class7.prototype.__init68.call(this);_class7.prototype.__init69.call(this);_class7.prototype.__init70.call(this);_class7.prototype.__init71.call(this);_class7.prototype.__init72.call(this);_class7.prototype.__init73.call(this);_class7.prototype.__init74.call(this);_class7.prototype.__init75.call(this);_class7.prototype.__init76.call(this);_class7.prototype.__init77.call(this);_class7.prototype.__init78.call(this);_class7.prototype.__init79.call(this);_class7.prototype.__init80.call(this);_class7.prototype.__init81.call(this);_class7.prototype.__init82.call(this);_class7.prototype.__init83.call(this);_class7.prototype.__init84.call(this);_class7.prototype.__init85.call(this);_class7.prototype.__init86.call(this);_class7.prototype.__init87.call(this);_class7.prototype.__init88.call(this);_class7.prototype.__init89.call(this);_class7.prototype.__init90.call(this);_class7.prototype.__init91.call(this);_class7.prototype.__init92.call(this);_class7.prototype.__init93.call(this);_class7.prototype.__init94.call(this);_class7.prototype.__init95.call(this);_class7.prototype.__init96.call(this);_class7.prototype.__init97.call(this);_class7.prototype.__init98.call(this);_class7.prototype.__init99.call(this);_class7.prototype.__init100.call(this);_class7.prototype.__init101.call(this);_class7.prototype.__init102.call(this);_class7.prototype.__init103.call(this);_class7.prototype.__init104.call(this);_class7.prototype.__init105.call(this);_class7.prototype.__init106.call(this);_class7.prototype.__init107.call(this);_class7.prototype.__init108.call(this);_class7.prototype.__init109.call(this);_class7.prototype.__init110.call(this);_class7.prototype.__init111.call(this);_class7.prototype.__init112.call(this);_class7.prototype.__init113.call(this);_class7.prototype.__init114.call(this);_class7.prototype.__init115.call(this);_class7.prototype.__init116.call(this);_class7.prototype.__init117.call(this);_class7.prototype.__init118.call(this);_class7.prototype.__init119.call(this);_class7.prototype.__init120.call(this);_class7.prototype.__init121.call(this);_class7.prototype.__init122.call(this);_class7.prototype.__init123.call(this);_class7.prototype.__init124.call(this);_class7.prototype.__init125.call(this);_class7.prototype.__init126.call(this);_class7.prototype.__init127.call(this);_class7.prototype.__init128.call(this);_class7.prototype.__init129.call(this);_class7.prototype.__init130.call(this);_class7.prototype.__init131.call(this);_class7.prototype.__init132.call(this);_class7.prototype.__init133.call(this);_class7.prototype.__init134.call(this);_class7.prototype.__init135.call(this);_class7.prototype.__init136.call(this);_class7.prototype.__init137.call(this);_class7.prototype.__init138.call(this);_class7.prototype.__init139.call(this);
+  constructor(canvas, options = {}) {;_class7.prototype.__init27.call(this);_class7.prototype.__init28.call(this);_class7.prototype.__init29.call(this);_class7.prototype.__init30.call(this);_class7.prototype.__init31.call(this);_class7.prototype.__init32.call(this);_class7.prototype.__init33.call(this);_class7.prototype.__init34.call(this);_class7.prototype.__init35.call(this);_class7.prototype.__init36.call(this);_class7.prototype.__init37.call(this);_class7.prototype.__init38.call(this);_class7.prototype.__init39.call(this);_class7.prototype.__init40.call(this);_class7.prototype.__init41.call(this);_class7.prototype.__init42.call(this);_class7.prototype.__init43.call(this);_class7.prototype.__init44.call(this);_class7.prototype.__init45.call(this);_class7.prototype.__init46.call(this);_class7.prototype.__init47.call(this);_class7.prototype.__init48.call(this);_class7.prototype.__init49.call(this);_class7.prototype.__init50.call(this);_class7.prototype.__init51.call(this);_class7.prototype.__init52.call(this);_class7.prototype.__init53.call(this);_class7.prototype.__init54.call(this);_class7.prototype.__init55.call(this);_class7.prototype.__init56.call(this);_class7.prototype.__init57.call(this);_class7.prototype.__init58.call(this);_class7.prototype.__init59.call(this);_class7.prototype.__init60.call(this);_class7.prototype.__init61.call(this);_class7.prototype.__init62.call(this);_class7.prototype.__init63.call(this);_class7.prototype.__init64.call(this);_class7.prototype.__init65.call(this);_class7.prototype.__init66.call(this);_class7.prototype.__init67.call(this);_class7.prototype.__init68.call(this);_class7.prototype.__init69.call(this);_class7.prototype.__init70.call(this);_class7.prototype.__init71.call(this);_class7.prototype.__init72.call(this);_class7.prototype.__init73.call(this);_class7.prototype.__init74.call(this);_class7.prototype.__init75.call(this);_class7.prototype.__init76.call(this);_class7.prototype.__init77.call(this);_class7.prototype.__init78.call(this);_class7.prototype.__init79.call(this);_class7.prototype.__init80.call(this);_class7.prototype.__init81.call(this);_class7.prototype.__init82.call(this);_class7.prototype.__init83.call(this);_class7.prototype.__init84.call(this);_class7.prototype.__init85.call(this);_class7.prototype.__init86.call(this);_class7.prototype.__init87.call(this);_class7.prototype.__init88.call(this);_class7.prototype.__init89.call(this);_class7.prototype.__init90.call(this);_class7.prototype.__init91.call(this);_class7.prototype.__init92.call(this);_class7.prototype.__init93.call(this);_class7.prototype.__init94.call(this);_class7.prototype.__init95.call(this);_class7.prototype.__init96.call(this);_class7.prototype.__init97.call(this);_class7.prototype.__init98.call(this);_class7.prototype.__init99.call(this);_class7.prototype.__init100.call(this);_class7.prototype.__init101.call(this);_class7.prototype.__init102.call(this);_class7.prototype.__init103.call(this);_class7.prototype.__init104.call(this);_class7.prototype.__init105.call(this);_class7.prototype.__init106.call(this);_class7.prototype.__init107.call(this);_class7.prototype.__init108.call(this);_class7.prototype.__init109.call(this);_class7.prototype.__init110.call(this);_class7.prototype.__init111.call(this);_class7.prototype.__init112.call(this);_class7.prototype.__init113.call(this);_class7.prototype.__init114.call(this);_class7.prototype.__init115.call(this);_class7.prototype.__init116.call(this);_class7.prototype.__init117.call(this);_class7.prototype.__init118.call(this);_class7.prototype.__init119.call(this);_class7.prototype.__init120.call(this);_class7.prototype.__init121.call(this);_class7.prototype.__init122.call(this);_class7.prototype.__init123.call(this);_class7.prototype.__init124.call(this);_class7.prototype.__init125.call(this);_class7.prototype.__init126.call(this);_class7.prototype.__init127.call(this);_class7.prototype.__init128.call(this);_class7.prototype.__init129.call(this);_class7.prototype.__init130.call(this);_class7.prototype.__init131.call(this);_class7.prototype.__init132.call(this);_class7.prototype.__init133.call(this);_class7.prototype.__init134.call(this);_class7.prototype.__init135.call(this);_class7.prototype.__init136.call(this);_class7.prototype.__init137.call(this);_class7.prototype.__init138.call(this);_class7.prototype.__init139.call(this);_class7.prototype.__init140.call(this);_class7.prototype.__init141.call(this);_class7.prototype.__init142.call(this);_class7.prototype.__init143.call(this);_class7.prototype.__init144.call(this);_class7.prototype.__init145.call(this);_class7.prototype.__init146.call(this);
     this.canvas = canvas;
     this.debugA11y = _nullishCoalesce(options.debugA11y, () => ( false));
     this.disableWindowResize = _nullishCoalesce(options.disableWindowResize, () => ( false));
@@ -4706,6 +4858,10 @@ var Scene = (_class7 = class _Scene {
     const computeEntities = this._computeEntitiesFor(this._structureVersion);
     if (computeEntities.length > 0) {
       const isMainRenderPath = renderer === this.renderer;
+      if (isMainRenderPath) {
+        this._particleReason = this._particleWasm ? "active" : "not-installed";
+        this._particlePath = this._particleWasm ? "wasm" : "js";
+      }
       if (isMainRenderPath && !this.device && !this.webgpuDisabled && !this.initializingWebGPU && !this.deviceLost) {
         this.initializingWebGPU = true;
         this.initWebGPUContext(computeEntities).then((newDevice) => {
@@ -4781,6 +4937,8 @@ var Scene = (_class7 = class _Scene {
           }
           this.device.queue.submit([commandEncoder.finish()]);
           if (this.gpuContext) this.gpuHasContent = true;
+          this._particleReason = "active";
+          this._particlePath = "webgpu";
         } catch (e) {
           console.error("WebGPU frame execution failed. Falling back.", e);
           this.deviceLost = true;
@@ -4802,13 +4960,25 @@ var Scene = (_class7 = class _Scene {
             }
           }
           if (this._particleWasm) {
-            entity.stepWithBackend(this._particleWasm, dt / 1e3, mx, my, this.width, this.height);
+            if (!entity.stepWithBackend(
+              this._particleWasm,
+              dt / 1e3,
+              mx,
+              my,
+              this.width,
+              this.height
+            )) {
+              this._particleReason = "rejected";
+              this._particlePath = "js";
+            }
           } else {
             entity.updateCPU(dt / 1e3, mx, my, this.width, this.height);
           }
         }
       }
     } else if (isMainRenderer) {
+      this._particleReason = "not-applicable";
+      this._particlePath = "none";
       this.clearGPUCanvasIfStale();
     }
     renderer.clear();
@@ -4837,6 +5007,9 @@ var Scene = (_class7 = class _Scene {
       }
     };
     const wasmMain = isMainRenderer && this._wasm !== null && this._transformBackend === "wasm";
+    if (isMainRenderer) {
+      this._transformReason = wasmMain ? "active" : "not-installed";
+    }
     if (wasmMain) {
       const updateWalk = (node) => {
         runUpdate(node);
@@ -5340,15 +5513,15 @@ var TextEntity = (_class8 = class extends _chunkAGP4VLF4js.Entity {
   
   
   
-  __init140() {this.nodes = []}
+  __init147() {this.nodes = []}
   
-  __init141() {this.fillStyle = "#94a3b8"}
-  __init142() {this.strokeStyle = null}
-  __init143() {this.hoveredFillStyle = "#ffffff"}
-  __init144() {this.lineWidth = 1}
-  __init145() {this.isHovered = false}
+  __init148() {this.fillStyle = "#94a3b8"}
+  __init149() {this.strokeStyle = null}
+  __init150() {this.hoveredFillStyle = "#ffffff"}
+  __init151() {this.lineWidth = 1}
+  __init152() {this.isHovered = false}
   constructor(text, atlas, maxWidth, fontSize = 24) {
-    super();_class8.prototype.__init140.call(this);_class8.prototype.__init141.call(this);_class8.prototype.__init142.call(this);_class8.prototype.__init143.call(this);_class8.prototype.__init144.call(this);_class8.prototype.__init145.call(this);;
+    super();_class8.prototype.__init147.call(this);_class8.prototype.__init148.call(this);_class8.prototype.__init149.call(this);_class8.prototype.__init150.call(this);_class8.prototype.__init151.call(this);_class8.prototype.__init152.call(this);;
     this.text = text;
     this.atlas = atlas;
     this.fontSize = fontSize;
@@ -5463,15 +5636,15 @@ var TextEntity = (_class8 = class extends _chunkAGP4VLF4js.Entity {
 // src/components/GridTextEntity.ts
 var GridTextEntity = (_class9 = class extends _chunkAGP4VLF4js.Entity {
   
-  __init146() {this.fillStyle = "#ffffff"}
-  __init147() {this.grid = []}
+  __init153() {this.fillStyle = "#ffffff"}
+  __init154() {this.grid = []}
   // Array of rows
-  __init148() {this.cols = 0}
-  __init149() {this.rows = 0}
+  __init155() {this.cols = 0}
+  __init156() {this.rows = 0}
   
   
   constructor(_atlas, fontSize = 10) {
-    super();_class9.prototype.__init146.call(this);_class9.prototype.__init147.call(this);_class9.prototype.__init148.call(this);_class9.prototype.__init149.call(this);;
+    super();_class9.prototype.__init153.call(this);_class9.prototype.__init154.call(this);_class9.prototype.__init155.call(this);_class9.prototype.__init156.call(this);;
     this.fontSize = fontSize;
     this.charWidth = fontSize * 1;
     this.charHeight = fontSize * 1.1;
@@ -5563,23 +5736,23 @@ var SplineEntity = (_class10 = class extends _chunkAGP4VLF4js.Entity {
   
   
   
-  __init150() {this.offscreen = null}
-  __init151() {this.baked = false}
+  __init157() {this.offscreen = null}
+  __init158() {this.baked = false}
   /** Logical (CSS-pixel) size of the baked bitmap — the blit destination size. */
-  __init152() {this.bakedWidth = 0}
-  __init153() {this.bakedHeight = 0}
+  __init159() {this.bakedWidth = 0}
+  __init160() {this.bakedHeight = 0}
   /** Gradient strokes can't be baked to a solid-color bitmap; they render per-frame. */
   
   /** Lazily-flattened polylines (one Float32Array of [x,y,...] per segment) for hit-testing. */
-  __init154() {this.polylines = null}
+  __init161() {this.polylines = null}
   /**
    * When `true`, the renderer draws a rounded-rect outline of the entity's
    * local bounds after painting the curves. Useful for drag feedback and
    * debugging hit areas. Defaults to `false`.
    */
-  __init155() {this.showBounds = false}
+  __init162() {this.showBounds = false}
   constructor(doc, opts = {}) {
-    super();_class10.prototype.__init150.call(this);_class10.prototype.__init151.call(this);_class10.prototype.__init152.call(this);_class10.prototype.__init153.call(this);_class10.prototype.__init154.call(this);_class10.prototype.__init155.call(this);;
+    super();_class10.prototype.__init157.call(this);_class10.prototype.__init158.call(this);_class10.prototype.__init159.call(this);_class10.prototype.__init160.call(this);_class10.prototype.__init161.call(this);_class10.prototype.__init162.call(this);;
     this.doc = doc;
     this.lineWidth = _nullishCoalesce(opts.lineWidth, () => ( 2));
     this.cache = _nullishCoalesce(opts.cache, () => ( true));
@@ -5960,19 +6133,19 @@ var _math = require('@vectojs/math'); _createStarExport(_math);
 // src/tree/DOMPortalEntity.ts
 var DOMPortalEntity = (_class11 = class extends _chunkAGP4VLF4js.Entity {
   
-  __init156() {this.isDOMPortal = true}
-  __init157() {this.domListeners = []}
-  __init158() {this.resizeObserver = null}
-  __init159() {this.domBound = false}
-  __init160() {this.cachedWidth = 100}
-  __init161() {this.cachedHeight = 100}
-  __init162() {this.lastWidth = ""}
-  __init163() {this.lastHeight = ""}
-  __init164() {this.lastTransform = ""}
-  __init165() {this.lastZIndex = ""}
-  __init166() {this.lastOpacity = ""}
+  __init163() {this.isDOMPortal = true}
+  __init164() {this.domListeners = []}
+  __init165() {this.resizeObserver = null}
+  __init166() {this.domBound = false}
+  __init167() {this.cachedWidth = 100}
+  __init168() {this.cachedHeight = 100}
+  __init169() {this.lastWidth = ""}
+  __init170() {this.lastHeight = ""}
+  __init171() {this.lastTransform = ""}
+  __init172() {this.lastZIndex = ""}
+  __init173() {this.lastOpacity = ""}
   constructor(domElement, width, height, id) {
-    super(id);_class11.prototype.__init156.call(this);_class11.prototype.__init157.call(this);_class11.prototype.__init158.call(this);_class11.prototype.__init159.call(this);_class11.prototype.__init160.call(this);_class11.prototype.__init161.call(this);_class11.prototype.__init162.call(this);_class11.prototype.__init163.call(this);_class11.prototype.__init164.call(this);_class11.prototype.__init165.call(this);_class11.prototype.__init166.call(this);;
+    super(id);_class11.prototype.__init163.call(this);_class11.prototype.__init164.call(this);_class11.prototype.__init165.call(this);_class11.prototype.__init166.call(this);_class11.prototype.__init167.call(this);_class11.prototype.__init168.call(this);_class11.prototype.__init169.call(this);_class11.prototype.__init170.call(this);_class11.prototype.__init171.call(this);_class11.prototype.__init172.call(this);_class11.prototype.__init173.call(this);;
     this.domElement = domElement;
     this.width = _nullishCoalesce(width, () => ( 0));
     this.height = _nullishCoalesce(height, () => ( 0));