@vectojs/core 0.2.0 → 0.2.2

package/dist/{chunk-Y2N7TGEH.mjs → chunk-H3QIE77O.mjs}

@@ -729,15 +729,23 @@ var Entity = class {
     return null;
   }
   /**
-   * Whether this entity still has a queued/running tween animation.
+   * Whether this entity still has a queued/running tween animation, or an
+   * active {@link setTransition}/{@link animateTo}/{@link springTo} property
+   * driver.
    *
-   * Used by {@link Scene}'s `onDemand` render mode to keep redrawing while an
-   * animation is in flight.
+   * Used by {@link Scene} to keep rendering continuously while an animation
+   * is in flight — both in `onDemand` render mode, and to hold off the
+   * `always`-mode idle auto-throttle. Without checking `_drivers` here, a
+   * property driver becomes invisible to that throttle: `markDirty()` called
+   * from inside `update()`/`tickDrivers()` is wiped by the loop's own
+   * `dirty = false` at the end of that same tick, so once the throttle
+   * engages an in-flight spring/tween only advances one animation-frame per
+   * external `markDirty()` trigger instead of every render frame.
    *
-   * @returns `true` if at least one animation remains.
+   * @returns `true` if at least one animation or property driver remains.
    */
   hasPendingAnimations() {
-    return this.animations.length > 0;
+    return this.animations.length > 0 || this._drivers.size > 0;
   }
 };
 

package/dist/{chunk-W3SFIVXO.js → chunk-LA3FJLP2.js}

@@ -729,15 +729,23 @@ var Entity = (_class4 = class {
     return null;
   }
   /**
-   * Whether this entity still has a queued/running tween animation.
+   * Whether this entity still has a queued/running tween animation, or an
+   * active {@link setTransition}/{@link animateTo}/{@link springTo} property
+   * driver.
    *
-   * Used by {@link Scene}'s `onDemand` render mode to keep redrawing while an
-   * animation is in flight.
+   * Used by {@link Scene} to keep rendering continuously while an animation
+   * is in flight — both in `onDemand` render mode, and to hold off the
+   * `always`-mode idle auto-throttle. Without checking `_drivers` here, a
+   * property driver becomes invisible to that throttle: `markDirty()` called
+   * from inside `update()`/`tickDrivers()` is wiped by the loop's own
+   * `dirty = false` at the end of that same tick, so once the throttle
+   * engages an in-flight spring/tween only advances one animation-frame per
+   * external `markDirty()` trigger instead of every render frame.
    *
-   * @returns `true` if at least one animation remains.
+   * @returns `true` if at least one animation or property driver remains.
    */
   hasPendingAnimations() {
-    return this.animations.length > 0;
+    return this.animations.length > 0 || this._drivers.size > 0;
   }
 }, _class4);
 

package/dist/index.js

@@ -22,7 +22,7 @@ var _chunkLIX7DJTIjs = require('./chunk-LIX7DJTI.js');
 
 
 
-var _chunkW3SFIVXOjs = require('./chunk-W3SFIVXO.js');
+var _chunkLA3FJLP2js = require('./chunk-LA3FJLP2.js');
 
 
 
@@ -39,7 +39,7 @@ var PARTICLE_OFFSET_ORIGIN_X = 4;
 var PARTICLE_OFFSET_ORIGIN_Y = 5;
 var PARTICLE_OFFSET_SIZE = 6;
 var PARTICLE_OFFSET_LIFE = 7;
-var ComputeParticleEntity = (_class = class extends _chunkW3SFIVXOjs.Entity {
+var ComputeParticleEntity = (_class = class extends _chunkLA3FJLP2js.Entity {
   
   
   
@@ -318,16 +318,18 @@ var Scene = (_class2 = class _Scene {
    */
   __init9() {this.renderMode = "always"}
   __init10() {this.dirty = true}
+  /** Whether to throttle rendering to 2 FPS when the scene is static to save power. */
+  __init11() {this.autoThrottle = true}
   /**
    * 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}.
    */
-  __init11() {this.maxFPS = 60}
+  __init12() {this.maxFPS = 60}
   /** Whether the OS prefers-reduced-motion setting auto-caps the loop. */
-  __init12() {this.respectReducedMotion = true}
+  __init13() {this.respectReducedMotion = true}
   /** Cached media-query list; `.matches` is read live each frame. */
-  __init13() {this.reducedMotionQuery = null}
+  __init14() {this.reducedMotionQuery = 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', _13 => _13.reducedMotionQuery, 'optionalAccess', _14 => _14.matches]);
@@ -336,58 +338,58 @@ var Scene = (_class2 = class _Scene {
    * Throttle interval (ms) for the a11y/automation shadow sync. `0` = every
    * frame. See {@link SceneOptions.a11ySyncInterval}.
    */
-  __init14() {this.a11ySyncInterval = 0}
+  __init15() {this.a11ySyncInterval = 0}
   /** Timestamp of the last a11y sync, for throttling. */
-  __init15() {this.lastA11ySync = -Infinity}
+  __init16() {this.lastA11ySync = -Infinity}
   /** True if we skipped an a11y sync during animation and need to sync when at rest. */
-  __init16() {this.a11yPendingSyncAfterAnimation = false}
+  __init17() {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.
   
-  __init17() {this.a11yElements = /* @__PURE__ */ new Map()}
+  __init18() {this.a11yElements = /* @__PURE__ */ new Map()}
   
-  __init18() {this.focusedA11yElement = null}
-  __init19() {this.caretBlinkTimer = null}
-  __init20() {this.a11yNeedsReorder = true}
-  __init21() {this.portalRoot = null}
-  __init22() {this.fullViewportElements = []}
-  __init23() {this.normalElements = []}
-  __init24() {this.activeIds = /* @__PURE__ */ new Set()}
-  __init25() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
-  __init26() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
-  __init27() {this.portalEntities = /* @__PURE__ */ new Map()}
-  __init28() {this.renderOrderCounter = 0}
+  __init19() {this.focusedA11yElement = null}
+  __init20() {this.caretBlinkTimer = null}
+  __init21() {this.a11yNeedsReorder = true}
+  __init22() {this.portalRoot = null}
+  __init23() {this.fullViewportElements = []}
+  __init24() {this.normalElements = []}
+  __init25() {this.activeIds = /* @__PURE__ */ new Set()}
+  __init26() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
+  __init27() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
+  __init28() {this.portalEntities = /* @__PURE__ */ new Map()}
+  __init29() {this.renderOrderCounter = 0}
   // Optional WebGL point-cloud layer (see SceneOptions.pointBackend).
-  __init29() {this.pointRenderer = null}
-  __init30() {this.glCanvas = null}
+  __init30() {this.pointRenderer = null}
+  __init31() {this.glCanvas = null}
   
   
   
-  __init31() {this.disableWindowResize = false}
+  __init32() {this.disableWindowResize = false}
   // WebGPU properties
-  __init32() {this.destroyed = false}
-  __init33() {this.device = null}
-  __init34() {this.deviceLost = false}
-  __init35() {this.particleBackend = "auto"}
-  __init36() {this._webgpuDisabled = false}
+  __init33() {this.destroyed = false}
+  __init34() {this.device = null}
+  __init35() {this.deviceLost = false}
+  __init36() {this.particleBackend = "auto"}
+  __init37() {this._webgpuDisabled = false}
   get webgpuDisabled() {
     return this._webgpuDisabled || this.particleBackend === "cpu";
   }
   set webgpuDisabled(value) {
     this._webgpuDisabled = value;
   }
-  __init37() {this.recoveryTimerId = null}
-  __init38() {this.manager = null}
-  __init39() {this.initializingWebGPU = false}
-  __init40() {this.gpuCanvas = null}
-  __init41() {this.gpuContext = null}
-  __init42() {this.mouseX = -9999}
-  __init43() {this.mouseY = -9999}
-  __init44() {this.pointerMoveListener = null}
-  __init45() {this.pointerLeaveListener = null}
-  __init46() {this.hasWarnedZeroSize = false}
-  constructor(canvas, options = {}) {;_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);_class2.prototype.__init11.call(this);_class2.prototype.__init12.call(this);_class2.prototype.__init13.call(this);_class2.prototype.__init14.call(this);_class2.prototype.__init15.call(this);_class2.prototype.__init16.call(this);_class2.prototype.__init17.call(this);_class2.prototype.__init18.call(this);_class2.prototype.__init19.call(this);_class2.prototype.__init20.call(this);_class2.prototype.__init21.call(this);_class2.prototype.__init22.call(this);_class2.prototype.__init23.call(this);_class2.prototype.__init24.call(this);_class2.prototype.__init25.call(this);_class2.prototype.__init26.call(this);_class2.prototype.__init27.call(this);_class2.prototype.__init28.call(this);_class2.prototype.__init29.call(this);_class2.prototype.__init30.call(this);_class2.prototype.__init31.call(this);_class2.prototype.__init32.call(this);_class2.prototype.__init33.call(this);_class2.prototype.__init34.call(this);_class2.prototype.__init35.call(this);_class2.prototype.__init36.call(this);_class2.prototype.__init37.call(this);_class2.prototype.__init38.call(this);_class2.prototype.__init39.call(this);_class2.prototype.__init40.call(this);_class2.prototype.__init41.call(this);_class2.prototype.__init42.call(this);_class2.prototype.__init43.call(this);_class2.prototype.__init44.call(this);_class2.prototype.__init45.call(this);_class2.prototype.__init46.call(this);
+  __init38() {this.recoveryTimerId = null}
+  __init39() {this.manager = null}
+  __init40() {this.initializingWebGPU = false}
+  __init41() {this.gpuCanvas = null}
+  __init42() {this.gpuContext = null}
+  __init43() {this.mouseX = -9999}
+  __init44() {this.mouseY = -9999}
+  __init45() {this.pointerMoveListener = null}
+  __init46() {this.pointerLeaveListener = null}
+  __init47() {this.hasWarnedZeroSize = false}
+  constructor(canvas, options = {}) {;_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);_class2.prototype.__init11.call(this);_class2.prototype.__init12.call(this);_class2.prototype.__init13.call(this);_class2.prototype.__init14.call(this);_class2.prototype.__init15.call(this);_class2.prototype.__init16.call(this);_class2.prototype.__init17.call(this);_class2.prototype.__init18.call(this);_class2.prototype.__init19.call(this);_class2.prototype.__init20.call(this);_class2.prototype.__init21.call(this);_class2.prototype.__init22.call(this);_class2.prototype.__init23.call(this);_class2.prototype.__init24.call(this);_class2.prototype.__init25.call(this);_class2.prototype.__init26.call(this);_class2.prototype.__init27.call(this);_class2.prototype.__init28.call(this);_class2.prototype.__init29.call(this);_class2.prototype.__init30.call(this);_class2.prototype.__init31.call(this);_class2.prototype.__init32.call(this);_class2.prototype.__init33.call(this);_class2.prototype.__init34.call(this);_class2.prototype.__init35.call(this);_class2.prototype.__init36.call(this);_class2.prototype.__init37.call(this);_class2.prototype.__init38.call(this);_class2.prototype.__init39.call(this);_class2.prototype.__init40.call(this);_class2.prototype.__init41.call(this);_class2.prototype.__init42.call(this);_class2.prototype.__init43.call(this);_class2.prototype.__init44.call(this);_class2.prototype.__init45.call(this);_class2.prototype.__init46.call(this);_class2.prototype.__init47.call(this);
     this.canvas = canvas;
     this.debugA11y = _nullishCoalesce(options.debugA11y, () => ( false));
     this.disableWindowResize = _nullishCoalesce(options.disableWindowResize, () => ( false));
@@ -402,10 +404,11 @@ var Scene = (_class2 = class _Scene {
     const isTest = globalProcess && (_optionalChain([globalProcess, 'access', _15 => _15.env, 'optionalAccess', _16 => _16.NODE_ENV]) === "test" || _optionalChain([globalProcess, 'access', _17 => _17.env, 'optionalAccess', _18 => _18.VITEST]) === "true");
     this.maxFPS = _nullishCoalesce(options.maxFPS, () => ( (isTest ? 0 : 60)));
     this.respectReducedMotion = _nullishCoalesce(options.respectReducedMotion, () => ( true));
+    this.autoThrottle = _nullishCoalesce(options.autoThrottle, () => ( true));
     this.particleBackend = _nullishCoalesce(options.particleBackend, () => ( "auto"));
     this.a11ySyncInterval = _nullishCoalesce(options.a11ySyncInterval, () => ( 0));
     this.reducedMotionQuery = typeof window !== "undefined" && typeof window.matchMedia === "function" ? window.matchMedia("(prefers-reduced-motion: reduce)") : null;
-    this.root = new class RootEntity extends _chunkW3SFIVXOjs.Entity {
+    this.root = new class RootEntity extends _chunkLA3FJLP2js.Entity {
       isPointInside() {
         return false;
       }
@@ -414,7 +417,7 @@ var Scene = (_class2 = class _Scene {
       }
     }("root");
     this.root._scene = this;
-    this.overlayRoot = new class OverlayRoot extends _chunkW3SFIVXOjs.Entity {
+    this.overlayRoot = new class OverlayRoot extends _chunkLA3FJLP2js.Entity {
       isPointInside() {
         return false;
       }
@@ -653,6 +656,17 @@ var Scene = (_class2 = class _Scene {
       this.caretBlinkTimer = null;
     }
   }
+  /**
+   * Manually advance the scene clock by `dt` milliseconds and render synchronously.
+   * Essential for deterministic rendering (e.g. video export).
+   * Note: You should call `scene.stop()` before using this to avoid conflict with the rAF loop.
+   */
+  step(dt) {
+    const time = this.lastTime + dt;
+    this.lastTime = time;
+    this.render(this.renderer, dt, time);
+    this.dirty = false;
+  }
   /**
    * Mark the scene as needing a redraw on the next frame.
    *
@@ -722,42 +736,42 @@ var Scene = (_class2 = class _Scene {
           el.style.background = "transparent";
         }
         el.addEventListener("click", (e) => {
-          node.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)("click", node, e));
+          node.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)("click", node, e));
         });
         el.addEventListener("mouseenter", (e) => {
           if (this.debugA11y) el.style.backgroundColor = "rgba(56, 189, 248, 0.2)";
-          node.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)("hover", node, e, false));
+          node.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)("hover", node, e, false));
         });
         el.addEventListener("mouseleave", (e) => {
           if (this.debugA11y) el.style.backgroundColor = "rgba(56, 189, 248, 0.05)";
-          node.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)("pointerleave", node, e, false));
+          node.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)("pointerleave", node, e, false));
         });
         const capEl = el;
         el.addEventListener("pointerdown", (e) => {
           if (typeof capEl.setPointerCapture === "function") capEl.setPointerCapture(e.pointerId);
-          node.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)("pointerdown", node, e));
+          node.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)("pointerdown", node, e));
         });
         el.addEventListener("pointerup", (e) => {
           if (typeof capEl.releasePointerCapture === "function")
             capEl.releasePointerCapture(e.pointerId);
-          node.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)("pointerup", node, e));
+          node.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)("pointerup", node, e));
         });
         el.addEventListener(
           "pointermove",
-          (e) => node.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)("pointermove", node, e))
+          (e) => node.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)("pointermove", node, e))
         );
         el.addEventListener(
           "wheel",
           (e) => {
-            node.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)("wheel", node, e));
+            node.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)("wheel", node, e));
           },
           { passive: false }
         );
         el.addEventListener("keydown", (e) => {
-          node.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)("keydown", node, e));
+          node.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)("keydown", node, e));
         });
         el.addEventListener("keyup", (e) => {
-          node.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)("keyup", node, e));
+          node.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)("keyup", node, e));
         });
         if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
           const input = el;
@@ -829,7 +843,7 @@ var Scene = (_class2 = class _Scene {
           el.addEventListener("keydown", (e) => {
             if (e.key === "Enter" || e.key === " ") {
               e.preventDefault();
-              node.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)("click", node, e));
+              node.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)("click", node, e));
             }
           });
         }
@@ -1090,7 +1104,7 @@ var Scene = (_class2 = class _Scene {
   loop(time) {
     if (!this.isRunning) return;
     let cap = this.effectiveMaxFPS();
-    const isStatic = !this.dirty && !this.hasAnyPendingAnimation(this.root) && !this.hasAnyPendingAnimation(this.overlayRoot);
+    const isStatic = this.autoThrottle && !this.dirty && !this.hasAnyPendingAnimation(this.root) && !this.hasAnyPendingAnimation(this.overlayRoot);
     if (isStatic && this.renderMode === "always" && this.maxFPS > 0) {
       cap = Math.min(cap, 2);
     }
@@ -1106,19 +1120,17 @@ var Scene = (_class2 = class _Scene {
     }
     this.render(this.renderer, dt, time);
     const hasActiveAnimation = this.hasAnyPendingAnimation(this.root) || this.hasAnyPendingAnimation(this.overlayRoot);
-    if (hasActiveAnimation) {
+    const hasInteractive = this.hasAnyInteractive(this.root) || this.hasAnyInteractive(this.overlayRoot);
+    const shouldSyncInterval = this.a11ySyncInterval <= 0 || time - this.lastA11ySync >= this.a11ySyncInterval;
+    if ((hasInteractive || this.a11yElements.size > 0) && (shouldSyncInterval || this.a11yPendingSyncAfterAnimation)) {
+      this.lastA11ySync = time;
+      if (hasInteractive) {
+        this.syncA11y(this.root);
+      }
+      this.enforceA11yDomOrder();
+      this.a11yPendingSyncAfterAnimation = hasActiveAnimation;
+    } else if (hasActiveAnimation) {
       this.a11yPendingSyncAfterAnimation = true;
-    } else {
-      const hasInteractive = this.hasAnyInteractive(this.root) || this.hasAnyInteractive(this.overlayRoot);
-      const shouldSyncInterval = this.a11ySyncInterval <= 0 || time - this.lastA11ySync >= this.a11ySyncInterval;
-      if ((hasInteractive || this.a11yElements.size > 0) && (shouldSyncInterval || this.a11yPendingSyncAfterAnimation)) {
-        this.lastA11ySync = time;
-        if (hasInteractive) {
-          this.syncA11y(this.root);
-        }
-        this.enforceA11yDomOrder();
-        this.a11yPendingSyncAfterAnimation = false;
-      }
     }
     this.dirty = false;
     this.scheduleFrame();
@@ -1523,20 +1535,20 @@ function defaultMeasurer() {
   if (sharedMeasurer === void 0) sharedMeasurer = _chunk72WVPMSJjs.createCanvasMeasurer.call(void 0, "sans-serif");
   return sharedMeasurer;
 }
-var TextEntity = (_class3 = class extends _chunkW3SFIVXOjs.Entity {
+var TextEntity = (_class3 = class extends _chunkLA3FJLP2js.Entity {
   
   
   
   
-  __init47() {this.nodes = []}
+  __init48() {this.nodes = []}
   
-  __init48() {this.fillStyle = "#94a3b8"}
-  __init49() {this.strokeStyle = null}
-  __init50() {this.hoveredFillStyle = "#ffffff"}
-  __init51() {this.lineWidth = 1}
-  __init52() {this.isHovered = false}
+  __init49() {this.fillStyle = "#94a3b8"}
+  __init50() {this.strokeStyle = null}
+  __init51() {this.hoveredFillStyle = "#ffffff"}
+  __init52() {this.lineWidth = 1}
+  __init53() {this.isHovered = false}
   constructor(text, atlas, maxWidth, fontSize = 24) {
-    super();_class3.prototype.__init47.call(this);_class3.prototype.__init48.call(this);_class3.prototype.__init49.call(this);_class3.prototype.__init50.call(this);_class3.prototype.__init51.call(this);_class3.prototype.__init52.call(this);;
+    super();_class3.prototype.__init48.call(this);_class3.prototype.__init49.call(this);_class3.prototype.__init50.call(this);_class3.prototype.__init51.call(this);_class3.prototype.__init52.call(this);_class3.prototype.__init53.call(this);;
     this.text = text;
     this.atlas = atlas;
     this.fontSize = fontSize;
@@ -1622,17 +1634,17 @@ var TextEntity = (_class3 = class extends _chunkW3SFIVXOjs.Entity {
 }, _class3);
 
 // src/components/GridTextEntity.ts
-var GridTextEntity = (_class4 = class extends _chunkW3SFIVXOjs.Entity {
+var GridTextEntity = (_class4 = class extends _chunkLA3FJLP2js.Entity {
   
-  __init53() {this.fillStyle = "#ffffff"}
-  __init54() {this.grid = []}
+  __init54() {this.fillStyle = "#ffffff"}
+  __init55() {this.grid = []}
   // Array of rows
-  __init55() {this.cols = 0}
-  __init56() {this.rows = 0}
+  __init56() {this.cols = 0}
+  __init57() {this.rows = 0}
   
   
   constructor(_atlas, fontSize = 10) {
-    super();_class4.prototype.__init53.call(this);_class4.prototype.__init54.call(this);_class4.prototype.__init55.call(this);_class4.prototype.__init56.call(this);;
+    super();_class4.prototype.__init54.call(this);_class4.prototype.__init55.call(this);_class4.prototype.__init56.call(this);_class4.prototype.__init57.call(this);;
     this.fontSize = fontSize;
     this.charWidth = fontSize * 1;
     this.charHeight = fontSize * 1.1;
@@ -1716,7 +1728,7 @@ function distSqToSegment(px, py, x1, y1, x2, y2) {
   const ey = py - cy;
   return ex * ex + ey * ey;
 }
-var SplineEntity = (_class5 = class extends _chunkW3SFIVXOjs.Entity {
+var SplineEntity = (_class5 = class extends _chunkLA3FJLP2js.Entity {
   
   
   
@@ -1724,18 +1736,18 @@ var SplineEntity = (_class5 = class extends _chunkW3SFIVXOjs.Entity {
   
   
   
-  __init57() {this.offscreen = null}
-  __init58() {this.baked = false}
+  __init58() {this.offscreen = null}
+  __init59() {this.baked = false}
   /** Lazily-flattened polylines (one Float32Array of [x,y,...] per segment) for hit-testing. */
-  __init59() {this.polylines = null}
+  __init60() {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`.
    */
-  __init60() {this.showBounds = false}
+  __init61() {this.showBounds = false}
   constructor(doc, opts = {}) {
-    super();_class5.prototype.__init57.call(this);_class5.prototype.__init58.call(this);_class5.prototype.__init59.call(this);_class5.prototype.__init60.call(this);;
+    super();_class5.prototype.__init58.call(this);_class5.prototype.__init59.call(this);_class5.prototype.__init60.call(this);_class5.prototype.__init61.call(this);;
     this.doc = doc;
     this.lineWidth = _nullishCoalesce(opts.lineWidth, () => ( 2));
     this.cache = _nullishCoalesce(opts.cache, () => ( true));
@@ -1982,9 +1994,9 @@ async function loadSpline(url) {
 // src/math/SpatialHashGrid.ts
 var SpatialHashGrid = (_class6 = class {
   
-  __init61() {this.grid = /* @__PURE__ */ new Map()}
-  __init62() {this.entityCells = /* @__PURE__ */ new Map()}
-  constructor(cellSize = 64) {;_class6.prototype.__init61.call(this);_class6.prototype.__init62.call(this);
+  __init62() {this.grid = /* @__PURE__ */ new Map()}
+  __init63() {this.entityCells = /* @__PURE__ */ new Map()}
+  constructor(cellSize = 64) {;_class6.prototype.__init62.call(this);_class6.prototype.__init63.call(this);
     this.cellSize = cellSize;
   }
   hash(cx, cy) {
@@ -2074,19 +2086,19 @@ var SpatialHashGrid = (_class6 = class {
 }, _class6);
 
 // src/tree/DOMPortalEntity.ts
-var DOMPortalEntity = (_class7 = class extends _chunkW3SFIVXOjs.Entity {
+var DOMPortalEntity = (_class7 = class extends _chunkLA3FJLP2js.Entity {
   
-  __init63() {this.isDOMPortal = true}
-  __init64() {this.domListeners = []}
-  __init65() {this.resizeObserver = null}
-  __init66() {this.cachedWidth = 100}
-  __init67() {this.cachedHeight = 100}
-  __init68() {this.lastWidth = ""}
-  __init69() {this.lastHeight = ""}
-  __init70() {this.lastTransform = ""}
-  __init71() {this.lastZIndex = ""}
+  __init64() {this.isDOMPortal = true}
+  __init65() {this.domListeners = []}
+  __init66() {this.resizeObserver = null}
+  __init67() {this.cachedWidth = 100}
+  __init68() {this.cachedHeight = 100}
+  __init69() {this.lastWidth = ""}
+  __init70() {this.lastHeight = ""}
+  __init71() {this.lastTransform = ""}
+  __init72() {this.lastZIndex = ""}
   constructor(domElement, width, height, id) {
-    super(id);_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);;
+    super(id);_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);;
     this.domElement = domElement;
     this.width = _nullishCoalesce(width, () => ( 0));
     this.height = _nullishCoalesce(height, () => ( 0));
@@ -2108,7 +2120,7 @@ var DOMPortalEntity = (_class7 = class extends _chunkW3SFIVXOjs.Entity {
       const events = ["click", "pointerdown", "pointerup", "pointermove", "wheel"];
       for (const type of events) {
         const handler = (e) => {
-          this.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)(type, this, e));
+          this.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)(type, this, e));
         };
         this.domElement.addEventListener(type, handler);
         this.domListeners.push({ type, handler, capture: false });
@@ -2119,7 +2131,7 @@ var DOMPortalEntity = (_class7 = class extends _chunkW3SFIVXOjs.Entity {
       ];
       for (const { native, vecto } of hoverEvents) {
         const handler = (e) => {
-          this.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)(vecto, this, e, false));
+          this.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)(vecto, this, e, false));
         };
         this.domElement.addEventListener(native, handler);
         this.domListeners.push({ type: native, handler, capture: false });
@@ -2127,7 +2139,7 @@ var DOMPortalEntity = (_class7 = class extends _chunkW3SFIVXOjs.Entity {
       const focusEvents = ["focus", "blur"];
       for (const type of focusEvents) {
         const handler = (e) => {
-          this.dispatchEvent(new (0, _chunkW3SFIVXOjs.VectoJSEvent)(type, this, e, true));
+          this.dispatchEvent(new (0, _chunkLA3FJLP2js.VectoJSEvent)(type, this, e, true));
         };
         this.domElement.addEventListener(type, handler, true);
         this.domListeners.push({ type, handler, capture: true });
@@ -2217,4 +2229,4 @@ Scene.registerWebGPUParticleSystemManager(_chunkLIX7DJTIjs.WebGPUParticleSystemM
 
 
 
-exports.ArabicShaper = _chunkRW6NC4RBjs.ArabicShaper; exports.BidiResolver = _chunkRW6NC4RBjs.BidiResolver; exports.CanvasRenderer = _chunkLIX7DJTIjs.CanvasRenderer; exports.ComputeParticleEntity = ComputeParticleEntity; exports.DOMPortalEntity = DOMPortalEntity; exports.Easing = _chunkW3SFIVXOjs.Easing; exports.Entity = _chunkW3SFIVXOjs.Entity; exports.GridTextEntity = GridTextEntity; exports.LayoutEngine = _chunk72WVPMSJjs.LayoutEngine; exports.LayoutResultBuffer = _chunk72WVPMSJjs.LayoutResultBuffer; exports.LayoutWorkerManager = _chunkRW6NC4RBjs.LayoutWorkerManager; exports.MSDFFont = _chunkW3SFIVXOjs.MSDFFont; exports.MSDFTextEntity = _chunkW3SFIVXOjs.MSDFTextEntity; exports.PARTICLE_OFFSET_LIFE = PARTICLE_OFFSET_LIFE; exports.PARTICLE_OFFSET_ORIGIN_X = PARTICLE_OFFSET_ORIGIN_X; exports.PARTICLE_OFFSET_ORIGIN_Y = PARTICLE_OFFSET_ORIGIN_Y; exports.PARTICLE_OFFSET_POSITION_X = PARTICLE_OFFSET_POSITION_X; exports.PARTICLE_OFFSET_POSITION_Y = PARTICLE_OFFSET_POSITION_Y; exports.PARTICLE_OFFSET_SIZE = PARTICLE_OFFSET_SIZE; exports.PARTICLE_OFFSET_VELOCITY_X = PARTICLE_OFFSET_VELOCITY_X; exports.PARTICLE_OFFSET_VELOCITY_Y = PARTICLE_OFFSET_VELOCITY_Y; exports.PARTICLE_STRIDE_FLOATS = PARTICLE_STRIDE_FLOATS; exports.REDUCED_MOTION_FPS = REDUCED_MOTION_FPS; exports.SVGEntity = _chunkW3SFIVXOjs.SVGEntity; exports.SVGRenderer = _chunkLIX7DJTIjs.SVGRenderer; exports.Scene = Scene; exports.SpatialHashGrid = SpatialHashGrid; exports.SplineEntity = SplineEntity; exports.SpringDriver = _chunkW3SFIVXOjs.SpringDriver; exports.SpringPhysics = _chunkW3SFIVXOjs.SpringPhysics; exports.TextEntity = TextEntity; exports.TweenDriver = _chunkW3SFIVXOjs.TweenDriver; exports.VectoJSEvent = _chunkW3SFIVXOjs.VectoJSEvent; exports.WebGPUParticleSystemManager = _chunkLIX7DJTIjs.WebGPUParticleSystemManager; exports.computeLineSegments = _chunk72WVPMSJjs.computeLineSegments; exports.createCanvasMeasurer = _chunk72WVPMSJjs.createCanvasMeasurer; exports.createWebGLPointRenderer = _chunkLIX7DJTIjs.createWebGLPointRenderer; exports.isTweenConfig = _chunkW3SFIVXOjs.isTweenConfig; exports.loadSpline = loadSpline; exports.parseColorToRGBA = _chunkLIX7DJTIjs.parseColorToRGBA; exports.polySegmentToBezier = polySegmentToBezier;
+exports.ArabicShaper = _chunkRW6NC4RBjs.ArabicShaper; exports.BidiResolver = _chunkRW6NC4RBjs.BidiResolver; exports.CanvasRenderer = _chunkLIX7DJTIjs.CanvasRenderer; exports.ComputeParticleEntity = ComputeParticleEntity; exports.DOMPortalEntity = DOMPortalEntity; exports.Easing = _chunkLA3FJLP2js.Easing; exports.Entity = _chunkLA3FJLP2js.Entity; exports.GridTextEntity = GridTextEntity; exports.LayoutEngine = _chunk72WVPMSJjs.LayoutEngine; exports.LayoutResultBuffer = _chunk72WVPMSJjs.LayoutResultBuffer; exports.LayoutWorkerManager = _chunkRW6NC4RBjs.LayoutWorkerManager; exports.MSDFFont = _chunkLA3FJLP2js.MSDFFont; exports.MSDFTextEntity = _chunkLA3FJLP2js.MSDFTextEntity; exports.PARTICLE_OFFSET_LIFE = PARTICLE_OFFSET_LIFE; exports.PARTICLE_OFFSET_ORIGIN_X = PARTICLE_OFFSET_ORIGIN_X; exports.PARTICLE_OFFSET_ORIGIN_Y = PARTICLE_OFFSET_ORIGIN_Y; exports.PARTICLE_OFFSET_POSITION_X = PARTICLE_OFFSET_POSITION_X; exports.PARTICLE_OFFSET_POSITION_Y = PARTICLE_OFFSET_POSITION_Y; exports.PARTICLE_OFFSET_SIZE = PARTICLE_OFFSET_SIZE; exports.PARTICLE_OFFSET_VELOCITY_X = PARTICLE_OFFSET_VELOCITY_X; exports.PARTICLE_OFFSET_VELOCITY_Y = PARTICLE_OFFSET_VELOCITY_Y; exports.PARTICLE_STRIDE_FLOATS = PARTICLE_STRIDE_FLOATS; exports.REDUCED_MOTION_FPS = REDUCED_MOTION_FPS; exports.SVGEntity = _chunkLA3FJLP2js.SVGEntity; exports.SVGRenderer = _chunkLIX7DJTIjs.SVGRenderer; exports.Scene = Scene; exports.SpatialHashGrid = SpatialHashGrid; exports.SplineEntity = SplineEntity; exports.SpringDriver = _chunkLA3FJLP2js.SpringDriver; exports.SpringPhysics = _chunkLA3FJLP2js.SpringPhysics; exports.TextEntity = TextEntity; exports.TweenDriver = _chunkLA3FJLP2js.TweenDriver; exports.VectoJSEvent = _chunkLA3FJLP2js.VectoJSEvent; exports.WebGPUParticleSystemManager = _chunkLIX7DJTIjs.WebGPUParticleSystemManager; exports.computeLineSegments = _chunk72WVPMSJjs.computeLineSegments; exports.createCanvasMeasurer = _chunk72WVPMSJjs.createCanvasMeasurer; exports.createWebGLPointRenderer = _chunkLIX7DJTIjs.createWebGLPointRenderer; exports.isTweenConfig = _chunkLA3FJLP2js.isTweenConfig; exports.loadSpline = loadSpline; exports.parseColorToRGBA = _chunkLIX7DJTIjs.parseColorToRGBA; exports.polySegmentToBezier = polySegmentToBezier;

package/dist/index.mjs

@@ -22,7 +22,7 @@ import {
   TweenDriver,
   VectoJSEvent,
   isTweenConfig
-} from "./chunk-Y2N7TGEH.mjs";
+} from "./chunk-H3QIE77O.mjs";
 import {
   ArabicShaper,
   BidiResolver,
@@ -318,6 +318,8 @@ var Scene = class _Scene {
    */
   renderMode = "always";
   dirty = true;
+  /** Whether to throttle rendering to 2 FPS when the scene is static to save power. */
+  autoThrottle = true;
   /**
    * Frame-rate cap (power saving). `0` = uncapped (native refresh). When set,
    * the loop renders at most `maxFPS` times per second; animations still run,
@@ -402,6 +404,7 @@ var Scene = class _Scene {
     const isTest = globalProcess && (globalProcess.env?.NODE_ENV === "test" || globalProcess.env?.VITEST === "true");
     this.maxFPS = options.maxFPS ?? (isTest ? 0 : 60);
     this.respectReducedMotion = options.respectReducedMotion ?? true;
+    this.autoThrottle = options.autoThrottle ?? true;
     this.particleBackend = options.particleBackend ?? "auto";
     this.a11ySyncInterval = options.a11ySyncInterval ?? 0;
     this.reducedMotionQuery = typeof window !== "undefined" && typeof window.matchMedia === "function" ? window.matchMedia("(prefers-reduced-motion: reduce)") : null;
@@ -653,6 +656,17 @@ var Scene = class _Scene {
       this.caretBlinkTimer = null;
     }
   }
+  /**
+   * Manually advance the scene clock by `dt` milliseconds and render synchronously.
+   * Essential for deterministic rendering (e.g. video export).
+   * Note: You should call `scene.stop()` before using this to avoid conflict with the rAF loop.
+   */
+  step(dt) {
+    const time = this.lastTime + dt;
+    this.lastTime = time;
+    this.render(this.renderer, dt, time);
+    this.dirty = false;
+  }
   /**
    * Mark the scene as needing a redraw on the next frame.
    *
@@ -1090,7 +1104,7 @@ var Scene = class _Scene {
   loop(time) {
     if (!this.isRunning) return;
     let cap = this.effectiveMaxFPS();
-    const isStatic = !this.dirty && !this.hasAnyPendingAnimation(this.root) && !this.hasAnyPendingAnimation(this.overlayRoot);
+    const isStatic = this.autoThrottle && !this.dirty && !this.hasAnyPendingAnimation(this.root) && !this.hasAnyPendingAnimation(this.overlayRoot);
     if (isStatic && this.renderMode === "always" && this.maxFPS > 0) {
       cap = Math.min(cap, 2);
     }
@@ -1106,19 +1120,17 @@ var Scene = class _Scene {
     }
     this.render(this.renderer, dt, time);
     const hasActiveAnimation = this.hasAnyPendingAnimation(this.root) || this.hasAnyPendingAnimation(this.overlayRoot);
-    if (hasActiveAnimation) {
+    const hasInteractive = this.hasAnyInteractive(this.root) || this.hasAnyInteractive(this.overlayRoot);
+    const shouldSyncInterval = this.a11ySyncInterval <= 0 || time - this.lastA11ySync >= this.a11ySyncInterval;
+    if ((hasInteractive || this.a11yElements.size > 0) && (shouldSyncInterval || this.a11yPendingSyncAfterAnimation)) {
+      this.lastA11ySync = time;
+      if (hasInteractive) {
+        this.syncA11y(this.root);
+      }
+      this.enforceA11yDomOrder();
+      this.a11yPendingSyncAfterAnimation = hasActiveAnimation;
+    } else if (hasActiveAnimation) {
       this.a11yPendingSyncAfterAnimation = true;
-    } else {
-      const hasInteractive = this.hasAnyInteractive(this.root) || this.hasAnyInteractive(this.overlayRoot);
-      const shouldSyncInterval = this.a11ySyncInterval <= 0 || time - this.lastA11ySync >= this.a11ySyncInterval;
-      if ((hasInteractive || this.a11yElements.size > 0) && (shouldSyncInterval || this.a11yPendingSyncAfterAnimation)) {
-        this.lastA11ySync = time;
-        if (hasInteractive) {
-          this.syncA11y(this.root);
-        }
-        this.enforceA11yDomOrder();
-        this.a11yPendingSyncAfterAnimation = false;
-      }
     }
     this.dirty = false;
     this.scheduleFrame();

package/dist/text.js

@@ -2,7 +2,7 @@
 
 
 
-var _chunkW3SFIVXOjs = require('./chunk-W3SFIVXO.js');
+var _chunkLA3FJLP2js = require('./chunk-LA3FJLP2.js');
 
 
 
@@ -13,4 +13,4 @@ var _chunkRW6NC4RBjs = require('./chunk-RW6NC4RB.js');
 
 
 
-exports.ArabicShaper = _chunkRW6NC4RBjs.ArabicShaper; exports.BidiResolver = _chunkRW6NC4RBjs.BidiResolver; exports.MSDFFont = _chunkW3SFIVXOjs.MSDFFont; exports.MSDFTextEntity = _chunkW3SFIVXOjs.MSDFTextEntity; exports.SVGEntity = _chunkW3SFIVXOjs.SVGEntity;
+exports.ArabicShaper = _chunkRW6NC4RBjs.ArabicShaper; exports.BidiResolver = _chunkRW6NC4RBjs.BidiResolver; exports.MSDFFont = _chunkLA3FJLP2js.MSDFFont; exports.MSDFTextEntity = _chunkLA3FJLP2js.MSDFTextEntity; exports.SVGEntity = _chunkLA3FJLP2js.SVGEntity;

package/dist/text.mjs

@@ -2,7 +2,7 @@ import {
   MSDFFont,
   MSDFTextEntity,
   SVGEntity
-} from "./chunk-Y2N7TGEH.mjs";
+} from "./chunk-H3QIE77O.mjs";
 import {
   ArabicShaper,
   BidiResolver

package/dist/tree/Entity.d.ts

@@ -413,12 +413,20 @@ export declare abstract class Entity {
      */
     getBatchRect(): BatchRect | null;
     /**
-     * Whether this entity still has a queued/running tween animation.
+     * Whether this entity still has a queued/running tween animation, or an
+     * active {@link setTransition}/{@link animateTo}/{@link springTo} property
+     * driver.
      *
-     * Used by {@link Scene}'s `onDemand` render mode to keep redrawing while an
-     * animation is in flight.
+     * Used by {@link Scene} to keep rendering continuously while an animation
+     * is in flight — both in `onDemand` render mode, and to hold off the
+     * `always`-mode idle auto-throttle. Without checking `_drivers` here, a
+     * property driver becomes invisible to that throttle: `markDirty()` called
+     * from inside `update()`/`tickDrivers()` is wiped by the loop's own
+     * `dirty = false` at the end of that same tick, so once the throttle
+     * engages an in-flight spring/tween only advances one animation-frame per
+     * external `markDirty()` trigger instead of every render frame.
      *
-     * @returns `true` if at least one animation remains.
+     * @returns `true` if at least one animation or property driver remains.
      */
     hasPendingAnimations(): boolean;
     abstract isPointInside(globalX: number, globalY: number): boolean;

package/dist/tree/Scene.d.ts

@@ -70,6 +70,11 @@ export interface SceneOptions {
      * Useful when Vecto is running inside a custom layout container or offscreen canvas.
      */
     disableWindowResize?: boolean;
+    /**
+     * Enable automatic throttling to 2 FPS when the scene is static (no active transitions
+     * and not marked dirty) to save power/CPU. Default is `true`.
+     */
+    autoThrottle?: boolean;
 }
 /** Frame-rate the loop is capped to when the OS requests reduced motion. */
 export declare const REDUCED_MOTION_FPS = 30;
@@ -117,6 +122,8 @@ export declare class Scene {
      */
     renderMode: 'always' | 'onDemand';
     private dirty;
+    /** Whether to throttle rendering to 2 FPS when the scene is static to save power. */
+    autoThrottle: boolean;
     /**
      * Frame-rate cap (power saving). `0` = uncapped (native refresh). When set,
      * the loop renders at most `maxFPS` times per second; animations still run,
@@ -236,6 +243,12 @@ export declare class Scene {
      * Call {@link start} again to resume rendering.
      */
     stop(): void;
+    /**
+     * Manually advance the scene clock by `dt` milliseconds and render synchronously.
+     * Essential for deterministic rendering (e.g. video export).
+     * Note: You should call `scene.stop()` before using this to avoid conflict with the rAF loop.
+     */
+    step(dt: number): void;
     /**
      * Mark the scene as needing a redraw on the next frame.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectojs/core",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "publishConfig": {
     "access": "public"
   },