@vectojs/core 1.35.3 → 1.36.0

package/dist/{chunk-CHDJEHML.mjs → chunk-QJC4VZ2E.mjs}

@@ -1241,8 +1241,8 @@ var MSDFTextEntity = class extends Entity {
    *
    * Measured on Chromium and Firefox (2026-07-31) with a 600 ms atlas: the
    * scene's own rAF loop never uploaded a decoded atlas in EITHER render mode.
-   * `onDemand` skips idle frames outright; `always` throttles to 2 FPS when
-   * idle, so whether it recovers is down to whether a throttled tick happens to
+   * `onDemand` skips idle frames outright; `always` throttles to the idle FPS
+   * floor when idle, so whether it recovers is down to whether a throttled tick happens to
    * land after the decode — Chromium got one, Firefox did not. Neither is a
    * mechanism, which is why this listener exists rather than relying on the
    * frame loop to come back around.

package/dist/{chunk-XHPUCU5P.js → chunk-XE6K7T5S.js}

@@ -1243,8 +1243,8 @@ var MSDFTextEntity = (_class3 = class extends Entity {
    *
    * Measured on Chromium and Firefox (2026-07-31) with a 600 ms atlas: the
    * scene's own rAF loop never uploaded a decoded atlas in EITHER render mode.
-   * `onDemand` skips idle frames outright; `always` throttles to 2 FPS when
-   * idle, so whether it recovers is down to whether a throttled tick happens to
+   * `onDemand` skips idle frames outright; `always` throttles to the idle FPS
+   * floor when idle, so whether it recovers is down to whether a throttled tick happens to
    * land after the decode — Chromium got one, Firefox did not. Neither is a
    * mechanism, which is why this listener exists rather than relying on the
    * frame loop to come back around.

package/dist/index.js

@@ -19,7 +19,7 @@ var _chunkMO24PVGTjs = require('./chunk-MO24PVGT.js');
 
 
 
-var _chunkXHPUCU5Pjs = require('./chunk-XHPUCU5P.js');
+var _chunkXE6K7T5Sjs = require('./chunk-XE6K7T5S.js');
 
 // src/tree/ComputeParticleEntity.ts
 var PARTICLE_STRIDE_FLOATS = 8;
@@ -31,7 +31,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 _chunkXHPUCU5Pjs.Entity {
+var ComputeParticleEntity = (_class = class extends _chunkXE6K7T5Sjs.Entity {
   
   
   
@@ -179,8 +179,8 @@ var ComputeParticleEntity = (_class = class extends _chunkXHPUCU5Pjs.Entity {
    * render-tree walk, but this entity is still a normal tree member that
    * walk visits — without this override, the base `Entity.hasPendingAnimations()`
    * (always `false`) is what Scene sees, so `renderMode: 'always'`'s idle
-   * auto-throttle drops the WHOLE scene to ~2fps the instant nothing else in
-   * the tree is animating, even while thousands of particles are visibly
+   * auto-throttle drops the WHOLE scene to the idle FPS floor the instant
+   * nothing else in the tree is animating, even while thousands of particles are visibly
    * drifting or spring-settling. A spring+damping system asymptotically
    * approaches zero velocity but never reaches it exactly, so this checks
    * against a small epsilon rather than `!== 0` — otherwise this would
@@ -3436,6 +3436,7 @@ var SCENE_OPTION_KEYS = [
   "contentSemanticMargin",
   "debugA11y",
   "disableWindowResize",
+  "idleFPS",
   "maxDPR",
   "maxFPS",
   "particleBackend",
@@ -3864,29 +3865,38 @@ var Scene = (_class15 = class _Scene {
     if (value) this._dirty.mark(void 0, this.currentFrame);
     else this._dirty.clear();
   }
-  /** Whether to throttle rendering to 2 FPS when the scene is static to save power. */
+  /**
+   * Whether to throttle the `'always'` loop when the scene is static to save
+   * power. The idle floor is {@link Scene.idleFPS} (default 60).
+   */
   __init90() {this.autoThrottle = true}
+  /**
+   * Frame-rate floor for an idle `'always'` scene when {@link Scene.autoThrottle}
+   * is on. Default `60`. Set `2` for the legacy aggressive idle sleep, `0` to
+   * keep the scene's `maxFPS` cadence while idle.
+   */
+  __init91() {this.idleFPS = 60}
   // --- Frame telemetry (read via `frameStats`) ---------------------------
   /** Wall-clock ms spent inside the last `render()` call. */
-  __init91() {this._lastFrameMs = 0}
+  __init92() {this._lastFrameMs = 0}
   /** Rolling exponential average of rendered-frame intervals, in ms. */
-  __init92() {this._avgFrameIntervalMs = 0}
+  __init93() {this._avgFrameIntervalMs = 0}
   /** dt (ms) handed to the last rendered frame. */
-  __init93() {this._lastDt = 0}
+  __init94() {this._lastDt = 0}
   /** Count of frames actually rendered since the loop started. */
-  __init94() {this._renderedFrames = 0}
+  __init95() {this._renderedFrames = 0}
   /** Count of rAF ticks skipped (idle / capped) since the loop started. */
-  __init95() {this._skippedFrames = 0}
+  __init96() {this._skippedFrames = 0}
   /** `time` of the previous *rendered* frame, for interval measurement. */
-  __init96() {this._lastRenderTick = 0}
+  __init97() {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}.
    */
-  __init97() {this.maxFPS = 60}
+  __init98() {this.maxFPS = 60}
   /** Whether the OS prefers-reduced-motion setting auto-caps the loop. */
-  __init98() {this.respectReducedMotion = true}
+  __init99() {this.respectReducedMotion = true}
   /**
    * Reading direction for accessibility tab/traversal order (`'ltr'` default,
    * `'rtl'`). Controls the inline sort within a visual row in
@@ -3902,15 +3912,15 @@ var Scene = (_class15 = class _Scene {
       this.a11yOrder.markNeedsReorder();
     }
   }
-  __init99() {this._readingDirection = "ltr"}
+  __init100() {this._readingDirection = "ltr"}
   /** Cached media-query list; `.matches` is read live each frame. */
-  __init100() {this.reducedMotionQuery = null}
+  __init101() {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. */
-  __init101() {this.forcedColorsQuery = null}
-  __init102() {this.forcedColorsChangeHandler = null}
+  __init102() {this.forcedColorsQuery = null}
+  __init103() {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', _93 => _93.reducedMotionQuery, 'optionalAccess', _94 => _94.matches]);
@@ -3931,19 +3941,19 @@ var Scene = (_class15 = class _Scene {
    * Throttle interval (ms) for the a11y/automation shadow sync. `0` = every
    * frame. See {@link SceneOptions.a11ySyncInterval}.
    */
-  __init103() {this.a11ySyncInterval = 0}
+  __init104() {this.a11ySyncInterval = 0}
   /** Timestamp of the last a11y sync, for throttling. */
-  __init104() {this.lastA11ySync = -Infinity}
+  __init105() {this.lastA11ySync = -Infinity}
   /** True if we skipped an a11y sync during animation and need to sync when at rest. */
-  __init105() {this.a11yPendingSyncAfterAnimation = false}
+  __init106() {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.
   
-  __init106() {this.a11yElements = /* @__PURE__ */ new Map()}
+  __init107() {this.a11yElements = /* @__PURE__ */ new Map()}
   // --- domain: content-projection — projected DOM, sync state, calibration, selection ---
   /** DOM nodes mirroring static text content, keyed by entity id. */
-  __init107() {this.contentElements = /* @__PURE__ */ new Map()}
+  __init108() {this.contentElements = /* @__PURE__ */ new Map()}
   /**
    * What the last completed content-projection sync was built from, per entity.
    *
@@ -3952,9 +3962,9 @@ var Scene = (_class15 = class _Scene {
    * build. Only populated for entities that opt in via
    * {@link Entity.getContentEpoch}. (carryctx CTX-0199)
    */
-  __init108() {this.contentSyncState = /* @__PURE__ */ new Map()}
+  __init109() {this.contentSyncState = /* @__PURE__ */ new Map()}
   /** Invalidates grid font calibration after browser font availability changes. */
-  __init109() {this.contentFontEpoch = 0}
+  __init110() {this.contentFontEpoch = 0}
   /**
    * Bumped whenever the viewport itself changes shape, which re-tiers blocks
    * without moving any of them.
@@ -3967,7 +3977,7 @@ var Scene = (_class15 = class _Scene {
    * carriers it no longer needs. Scrolling needs no such epoch: it moves the root,
    * so every block's parent world transform changes and the check fails honestly.
    */
-  __init110() {this.contentViewportEpoch = 0}
+  __init111() {this.contentViewportEpoch = 0}
   /**
    * One-entry memo for a parent's world transform, held as scalars.
    *
@@ -3982,16 +3992,16 @@ var Scene = (_class15 = class _Scene {
    * sync, so a memo can never survive into a frame in which the parent has
    * moved.
    */
-  __init111() {this._pwNode = null}
-  __init112() {this._pwSerial = -1}
-  __init113() {this._pwa = 1}
-  __init114() {this._pwb = 0}
-  __init115() {this._pwc = 0}
-  __init116() {this._pwd = 1}
-  __init117() {this._pwe = 0}
-  __init118() {this._pwf = 0}
+  __init112() {this._pwNode = null}
+  __init113() {this._pwSerial = -1}
+  __init114() {this._pwa = 1}
+  __init115() {this._pwb = 0}
+  __init116() {this._pwc = 0}
+  __init117() {this._pwd = 1}
+  __init118() {this._pwe = 0}
+  __init119() {this._pwf = 0}
   /** Incremented once per top-level `syncA11y`, invalidating `_pwNode`. */
-  __init119() {this._syncSerial = 0}
+  __init120() {this._syncSerial = 0}
   /**
    * Disables the settled-walk fast path in {@link syncContentProjection}.
    *
@@ -4003,38 +4013,38 @@ var Scene = (_class15 = class _Scene {
    * Not part of the public API and not documented as an option: turning it on only
    * makes a settled document slower, never more correct.
    */
-  __init120() {this.disableSettledFastPath = false}
+  __init121() {this.disableSettledFastPath = false}
   /** Cached Canvas-to-client scale for the current font/viewport epoch. */
-  __init121() {this.contentMetricScaleEpoch = -1}
-  __init122() {this.contentMetricScaleX = 1}
-  __init123() {this.contentProjectionEnabled = true}
+  __init122() {this.contentMetricScaleEpoch = -1}
+  __init123() {this.contentMetricScaleX = 1}
+  __init124() {this.contentProjectionEnabled = true}
   // Virtualization margin (px) for the content-projection CARRIER band;
   // `undefined` → one viewport height, resolved at sync time. `Infinity` is
   // unsupported here: it unwindows every carrier, which is O(total glyphs).
-  __init124() {this.contentProjectionMargin = void 0}
+  __init125() {this.contentProjectionMargin = void 0}
   // Virtualization margin (px) for the SEMANTIC tier — whether a block has
   // any projected DOM. `undefined` → falls back to contentProjectionMargin, so
   // the default keeps one gate. `Infinity` = every block keeps resident text.
-  __init125() {this.contentSemanticMargin = void 0}
+  __init126() {this.contentSemanticMargin = void 0}
   // How many coarse-tier blocks may be MATERIALIZED per sync, spreading the
   // resident tier's document-open cost across frames. `Infinity` = one
   // synchronous pass.
-  __init126() {this.contentSemanticBudget = DEFAULT_CONTENT_SEMANTIC_BUDGET}
+  __init127() {this.contentSemanticBudget = DEFAULT_CONTENT_SEMANTIC_BUDGET}
   // Remaining materializations in the CURRENT sync. Reset at the start of each
   // a11y walk; decremented per coarse block that creates its element.
-  __init127() {this.contentSemanticBudgetLeft = 0}
+  __init128() {this.contentSemanticBudgetLeft = 0}
   // Set when a sync deferred at least one block, so the scene knows to keep
   // drawing frames until the resident tier is complete. Without it a static
   // scene in `onDemand` mode would stop rendering with the document half
   // materialized and never finish.
-  __init128() {this.contentSemanticDeferred = false}
-  __init129() {this.contentSelectionEndListener = null}
+  __init129() {this.contentSemanticDeferred = false}
+  __init130() {this.contentSelectionEndListener = null}
   // --- domain: render-scheduler — per-frame walk flags ---
   // 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.
-  __init130() {this.frameHadAnimation = true}
-  __init131() {this.frameHadInteractive = true}
+  __init131() {this.frameHadAnimation = true}
+  __init132() {this.frameHadInteractive = true}
   // --- domain: context-and-resize — resize handler, DPR query, canvas observer ---
   
   /** Active `(resolution: Ndppx)` media query watching for a runtime DPR change
@@ -4042,15 +4052,15 @@ var Scene = (_class15 = class _Scene {
    *  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. */
-  __init132() {this.dprMediaQuery = null}
+  __init133() {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. */
-  __init133() {this.canvasResizeObserver = null}
-  __init134() {this.dprChangeHandler = null}
+  __init134() {this.canvasResizeObserver = null}
+  __init135() {this.dprChangeHandler = null}
   // --- domain: a11y-projection — focus, overlay geometry, DOM ordering, portals ---
-  __init135() {this.focusedA11yElement = null}
+  __init136() {this.focusedA11yElement = null}
   /**
    * Canvas box geometry: the CSS↔logical mapping, overlay layer alignment, and
    * the DPR math (extraction 5, `DEC-0024`).
@@ -4077,7 +4087,7 @@ var Scene = (_class15 = class _Scene {
   /** 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. */
-  __init136() {this.hoveredA11yElements = /* @__PURE__ */ new WeakSet()}
+  __init137() {this.hoveredA11yElements = /* @__PURE__ */ new WeakSet()}
   /**
    * Entity ids the application has pinned via {@link requestA11yProjection}.
    *
@@ -4085,13 +4095,13 @@ var Scene = (_class15 = class _Scene {
    * a stale id simply never matches. Cleared per-entity by
    * {@link releaseA11yProjection}.
    */
-  __init137() {this.a11yProjectionRequests = /* @__PURE__ */ new Set()}
+  __init138() {this.a11yProjectionRequests = /* @__PURE__ */ new Set()}
   /** 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. */
-  __init138() {this.focusSentinel = null}
-  __init139() {this.caretBlinkTimer = null}
+  __init139() {this.focusSentinel = null}
+  __init140() {this.caretBlinkTimer = null}
   /**
    * The projected DOM's ordering engine — the reorder flag, the per-pass scratch
    * collections, the visual reading-order sort and the cursor-based
@@ -4101,7 +4111,7 @@ var Scene = (_class15 = class _Scene {
    * delegate here; the collect-and-prune walk stays behind because it needs
    * {@link shouldProjectA11y} and the focus/caret state.
    */
-  __init140() {this.a11yOrder = new A11yProjectionManager()}
+  __init141() {this.a11yOrder = new A11yProjectionManager()}
   /**
    * The content projection's selection preservation and grid calibration
    * (extraction 3, `DEC-0022`).
@@ -4153,11 +4163,11 @@ var Scene = (_class15 = class _Scene {
   set a11yNeedsReorder(value) {
     this.a11yOrder.needsReorder = value;
   }
-  __init141() {this.portalRoot = null}
-  __init142() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
-  __init143() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
-  __init144() {this.portalEntities = /* @__PURE__ */ new Map()}
-  __init145() {this.renderOrderCounter = 0}
+  __init142() {this.portalRoot = null}
+  __init143() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
+  __init144() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
+  __init145() {this.portalEntities = /* @__PURE__ */ new Map()}
+  __init146() {this.renderOrderCounter = 0}
   // --- domain: render-scheduler — authoritative frame counter ---
   /**
    * Monotonic render-frame counter, bumped once per authoritative `render()`
@@ -4167,7 +4177,7 @@ var Scene = (_class15 = class _Scene {
    * back to the ancestor walk. Public for the same reason `Entity._getTrig`/
    * `_setWorldCache` are: it is a cross-class render-internal contract.
    */
-  __init146() {this.currentFrame = 0}
+  __init147() {this.currentFrame = 0}
   // --- domain: wasm-backend-facade — EXTRACTED (see scene/WasmBackendFacade.ts) ---
   /**
    * The four invisible WASM accelerators and the resident transform store.
@@ -4237,8 +4247,8 @@ var Scene = (_class15 = class _Scene {
   // Stays on `Scene`: it walks `root` *and* `overlayRoot` for entities the
   // render walk consumes, so only its cache key is store state. The facade owns
   // the key; the walk stays here.
-  __init147() {this._computeEntities = []}
-  __init148() {this._computeEntitiesVersion = -1}
+  __init148() {this._computeEntities = []}
+  __init149() {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() {
@@ -4477,7 +4487,7 @@ var Scene = (_class15 = class _Scene {
   get animBatchedLastFrame() {
     return this._wasmBackend.animBatchedLastFrame;
   }
-  __init149() {this.animGate = {
+  __init150() {this.animGate = {
     spring: 128,
     tween: 256,
     mixed: 128
@@ -4592,25 +4602,25 @@ var Scene = (_class15 = class _Scene {
    * sync, so retaining the order prevents a newly opened overlay from spending
    * its first frame below previously projected controls.
    */
-  __init150() {this.a11yRenderOrders = /* @__PURE__ */ new Map()}
+  __init151() {this.a11yRenderOrders = /* @__PURE__ */ new Map()}
   // --- domain: context-and-resize — GL/GPU canvases, device state, pointer, size warnings ---
   // Optional WebGL point-cloud layer (see SceneOptions.pointBackend).
-  __init151() {this.pointRenderer = null}
-  __init152() {this.glCanvas = null}
-  __init153() {this.glContextLostHandler = null}
-  __init154() {this.glContextRestoredHandler = null}
+  __init152() {this.pointRenderer = null}
+  __init153() {this.glCanvas = null}
+  __init154() {this.glContextLostHandler = null}
+  __init155() {this.glContextRestoredHandler = null}
   
   
   
-  __init155() {this.disableWindowResize = false}
+  __init156() {this.disableWindowResize = false}
   /** See {@link SceneOptions.maxDPR}. `undefined` = uncapped (real DPR). */
   
   // WebGPU properties
-  __init156() {this.destroyed = false}
-  __init157() {this.device = null}
-  __init158() {this.deviceLost = false}
-  __init159() {this.particleBackend = "auto"}
-  __init160() {this._webgpuDisabled = false}
+  __init157() {this.destroyed = false}
+  __init158() {this.device = null}
+  __init159() {this.deviceLost = false}
+  __init160() {this.particleBackend = "auto"}
+  __init161() {this._webgpuDisabled = false}
   get webgpuDisabled() {
     return this._webgpuDisabled || this.particleBackend === "cpu";
   }
@@ -4638,21 +4648,21 @@ var Scene = (_class15 = class _Scene {
   set webgpuDisabled(value) {
     this._webgpuDisabled = value;
   }
-  __init161() {this.recoveryTimerId = null}
-  __init162() {this.manager = null}
-  __init163() {this.initializingWebGPU = false}
-  __init164() {this.gpuCanvas = null}
-  __init165() {this.gpuContext = null}
+  __init162() {this.recoveryTimerId = null}
+  __init163() {this.manager = null}
+  __init164() {this.initializingWebGPU = false}
+  __init165() {this.gpuCanvas = null}
+  __init166() {this.gpuContext = null}
   /** True while the GPU canvas holds a presented particle frame (needs clearing when they leave). */
-  __init166() {this.gpuHasContent = false}
-  __init167() {this.mouseX = -9999}
-  __init168() {this.mouseY = -9999}
-  __init169() {this.pointerMoveListener = null}
-  __init170() {this.pointerLeaveListener = null}
+  __init167() {this.gpuHasContent = false}
+  __init168() {this.mouseX = -9999}
+  __init169() {this.mouseY = -9999}
+  __init170() {this.pointerMoveListener = null}
+  __init171() {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. */
-  __init171() {this.pointerEventTarget = null}
-  __init172() {this.hasWarnedZeroSize = false}
+  __init172() {this.pointerEventTarget = null}
+  __init173() {this.hasWarnedZeroSize = false}
   /**
    * Latch for {@link Scene.resize}'s invalid-dimension warning.
    *
@@ -4662,8 +4672,8 @@ var Scene = (_class15 = class _Scene {
    * because `resize()` is commonly driven from a `ResizeObserver`, which would
    * otherwise warn on every frame of a drag.
    */
-  __init173() {this.hasWarnedInvalidResize = false}
-  __init174() {this.fontLoadHandler = null}
+  __init174() {this.hasWarnedInvalidResize = false}
+  __init175() {this.fontLoadHandler = null}
   // --- domain: scene-facade — dev-mode diagnostics ---
   // ── Dev-mode warning infrastructure ──────────────────────────────
   //
@@ -4698,7 +4708,7 @@ var Scene = (_class15 = class _Scene {
     return false;
   }
   
-  __init175() {this._devFrameCount = 0}
+  __init176() {this._devFrameCount = 0}
   _devWarn(message) {
     if (!this._devActive) return;
     console.warn(`[vectojs/dev] ${message}`);
@@ -4776,7 +4786,7 @@ var Scene = (_class15 = class _Scene {
     walkProjections(this.root);
   }
   // --- domain: scene-facade — construction (wires every collaborator) ---
-  constructor(canvas, options = {}) {;_class15.prototype.__init83.call(this);_class15.prototype.__init84.call(this);_class15.prototype.__init85.call(this);_class15.prototype.__init86.call(this);_class15.prototype.__init87.call(this);_class15.prototype.__init88.call(this);_class15.prototype.__init89.call(this);_class15.prototype.__init90.call(this);_class15.prototype.__init91.call(this);_class15.prototype.__init92.call(this);_class15.prototype.__init93.call(this);_class15.prototype.__init94.call(this);_class15.prototype.__init95.call(this);_class15.prototype.__init96.call(this);_class15.prototype.__init97.call(this);_class15.prototype.__init98.call(this);_class15.prototype.__init99.call(this);_class15.prototype.__init100.call(this);_class15.prototype.__init101.call(this);_class15.prototype.__init102.call(this);_class15.prototype.__init103.call(this);_class15.prototype.__init104.call(this);_class15.prototype.__init105.call(this);_class15.prototype.__init106.call(this);_class15.prototype.__init107.call(this);_class15.prototype.__init108.call(this);_class15.prototype.__init109.call(this);_class15.prototype.__init110.call(this);_class15.prototype.__init111.call(this);_class15.prototype.__init112.call(this);_class15.prototype.__init113.call(this);_class15.prototype.__init114.call(this);_class15.prototype.__init115.call(this);_class15.prototype.__init116.call(this);_class15.prototype.__init117.call(this);_class15.prototype.__init118.call(this);_class15.prototype.__init119.call(this);_class15.prototype.__init120.call(this);_class15.prototype.__init121.call(this);_class15.prototype.__init122.call(this);_class15.prototype.__init123.call(this);_class15.prototype.__init124.call(this);_class15.prototype.__init125.call(this);_class15.prototype.__init126.call(this);_class15.prototype.__init127.call(this);_class15.prototype.__init128.call(this);_class15.prototype.__init129.call(this);_class15.prototype.__init130.call(this);_class15.prototype.__init131.call(this);_class15.prototype.__init132.call(this);_class15.prototype.__init133.call(this);_class15.prototype.__init134.call(this);_class15.prototype.__init135.call(this);_class15.prototype.__init136.call(this);_class15.prototype.__init137.call(this);_class15.prototype.__init138.call(this);_class15.prototype.__init139.call(this);_class15.prototype.__init140.call(this);_class15.prototype.__init141.call(this);_class15.prototype.__init142.call(this);_class15.prototype.__init143.call(this);_class15.prototype.__init144.call(this);_class15.prototype.__init145.call(this);_class15.prototype.__init146.call(this);_class15.prototype.__init147.call(this);_class15.prototype.__init148.call(this);_class15.prototype.__init149.call(this);_class15.prototype.__init150.call(this);_class15.prototype.__init151.call(this);_class15.prototype.__init152.call(this);_class15.prototype.__init153.call(this);_class15.prototype.__init154.call(this);_class15.prototype.__init155.call(this);_class15.prototype.__init156.call(this);_class15.prototype.__init157.call(this);_class15.prototype.__init158.call(this);_class15.prototype.__init159.call(this);_class15.prototype.__init160.call(this);_class15.prototype.__init161.call(this);_class15.prototype.__init162.call(this);_class15.prototype.__init163.call(this);_class15.prototype.__init164.call(this);_class15.prototype.__init165.call(this);_class15.prototype.__init166.call(this);_class15.prototype.__init167.call(this);_class15.prototype.__init168.call(this);_class15.prototype.__init169.call(this);_class15.prototype.__init170.call(this);_class15.prototype.__init171.call(this);_class15.prototype.__init172.call(this);_class15.prototype.__init173.call(this);_class15.prototype.__init174.call(this);_class15.prototype.__init175.call(this);
+  constructor(canvas, options = {}) {;_class15.prototype.__init83.call(this);_class15.prototype.__init84.call(this);_class15.prototype.__init85.call(this);_class15.prototype.__init86.call(this);_class15.prototype.__init87.call(this);_class15.prototype.__init88.call(this);_class15.prototype.__init89.call(this);_class15.prototype.__init90.call(this);_class15.prototype.__init91.call(this);_class15.prototype.__init92.call(this);_class15.prototype.__init93.call(this);_class15.prototype.__init94.call(this);_class15.prototype.__init95.call(this);_class15.prototype.__init96.call(this);_class15.prototype.__init97.call(this);_class15.prototype.__init98.call(this);_class15.prototype.__init99.call(this);_class15.prototype.__init100.call(this);_class15.prototype.__init101.call(this);_class15.prototype.__init102.call(this);_class15.prototype.__init103.call(this);_class15.prototype.__init104.call(this);_class15.prototype.__init105.call(this);_class15.prototype.__init106.call(this);_class15.prototype.__init107.call(this);_class15.prototype.__init108.call(this);_class15.prototype.__init109.call(this);_class15.prototype.__init110.call(this);_class15.prototype.__init111.call(this);_class15.prototype.__init112.call(this);_class15.prototype.__init113.call(this);_class15.prototype.__init114.call(this);_class15.prototype.__init115.call(this);_class15.prototype.__init116.call(this);_class15.prototype.__init117.call(this);_class15.prototype.__init118.call(this);_class15.prototype.__init119.call(this);_class15.prototype.__init120.call(this);_class15.prototype.__init121.call(this);_class15.prototype.__init122.call(this);_class15.prototype.__init123.call(this);_class15.prototype.__init124.call(this);_class15.prototype.__init125.call(this);_class15.prototype.__init126.call(this);_class15.prototype.__init127.call(this);_class15.prototype.__init128.call(this);_class15.prototype.__init129.call(this);_class15.prototype.__init130.call(this);_class15.prototype.__init131.call(this);_class15.prototype.__init132.call(this);_class15.prototype.__init133.call(this);_class15.prototype.__init134.call(this);_class15.prototype.__init135.call(this);_class15.prototype.__init136.call(this);_class15.prototype.__init137.call(this);_class15.prototype.__init138.call(this);_class15.prototype.__init139.call(this);_class15.prototype.__init140.call(this);_class15.prototype.__init141.call(this);_class15.prototype.__init142.call(this);_class15.prototype.__init143.call(this);_class15.prototype.__init144.call(this);_class15.prototype.__init145.call(this);_class15.prototype.__init146.call(this);_class15.prototype.__init147.call(this);_class15.prototype.__init148.call(this);_class15.prototype.__init149.call(this);_class15.prototype.__init150.call(this);_class15.prototype.__init151.call(this);_class15.prototype.__init152.call(this);_class15.prototype.__init153.call(this);_class15.prototype.__init154.call(this);_class15.prototype.__init155.call(this);_class15.prototype.__init156.call(this);_class15.prototype.__init157.call(this);_class15.prototype.__init158.call(this);_class15.prototype.__init159.call(this);_class15.prototype.__init160.call(this);_class15.prototype.__init161.call(this);_class15.prototype.__init162.call(this);_class15.prototype.__init163.call(this);_class15.prototype.__init164.call(this);_class15.prototype.__init165.call(this);_class15.prototype.__init166.call(this);_class15.prototype.__init167.call(this);_class15.prototype.__init168.call(this);_class15.prototype.__init169.call(this);_class15.prototype.__init170.call(this);_class15.prototype.__init171.call(this);_class15.prototype.__init172.call(this);_class15.prototype.__init173.call(this);_class15.prototype.__init174.call(this);_class15.prototype.__init175.call(this);_class15.prototype.__init176.call(this);
     this.canvas = canvas;
     this.debugA11y = _nullishCoalesce(options.debugA11y, () => ( false));
     this.disableWindowResize = _nullishCoalesce(options.disableWindowResize, () => ( false));
@@ -4795,6 +4805,7 @@ var Scene = (_class15 = class _Scene {
     this.maxFPS = _nullishCoalesce(options.maxFPS, () => ( (isTest ? 0 : 60)));
     this.respectReducedMotion = _nullishCoalesce(options.respectReducedMotion, () => ( true));
     this.autoThrottle = _nullishCoalesce(options.autoThrottle, () => ( true));
+    this.idleFPS = _nullishCoalesce(options.idleFPS, () => ( 60));
     this.phases.userTiming = _nullishCoalesce(options.userTiming, () => ( false));
     this.particleBackend = _nullishCoalesce(options.particleBackend, () => ( "auto"));
     this.a11ySyncInterval = _nullishCoalesce(options.a11ySyncInterval, () => ( 0));
@@ -4813,7 +4824,7 @@ var Scene = (_class15 = class _Scene {
       this.forcedColorsChangeHandler = () => this.markDirty();
       _optionalChain([this, 'access', _118 => _118.forcedColorsQuery, 'access', _119 => _119.addEventListener, 'optionalCall', _120 => _120("change", this.forcedColorsChangeHandler)]);
     }
-    this.root = new class RootEntity extends _chunkXHPUCU5Pjs.Entity {
+    this.root = new class RootEntity extends _chunkXE6K7T5Sjs.Entity {
       isPointInside() {
         return false;
       }
@@ -4823,7 +4834,7 @@ var Scene = (_class15 = class _Scene {
     }("root");
     this.root._scene = this;
     this._wasmBackend = new WasmBackendFacade(this.root);
-    this.overlayRoot = new class OverlayRoot extends _chunkXHPUCU5Pjs.Entity {
+    this.overlayRoot = new class OverlayRoot extends _chunkXE6K7T5Sjs.Entity {
       isPointInside() {
         return false;
       }
@@ -5143,7 +5154,7 @@ var Scene = (_class15 = class _Scene {
       }
       if (this.hoveredA11yElements.has(el)) {
         this.hoveredA11yElements.delete(el);
-        node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("pointerleave", node, void 0, false));
+        node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("pointerleave", node, void 0, false));
       }
       this.preserveFocusOnRemoval(el);
       el.remove();
@@ -5734,20 +5745,20 @@ var Scene = (_class15 = class _Scene {
           el.style.background = "transparent";
         }
         el.addEventListener("click", (e) => {
-          node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("click", node, e));
+          node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("click", node, e));
         });
         el.addEventListener("dblclick", (e) => {
-          node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("dblclick", node, e));
+          node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("dblclick", node, e));
         });
         el.addEventListener("mouseenter", (e) => {
           if (this.debugA11y) el.style.backgroundColor = "rgba(56, 189, 248, 0.2)";
           this.hoveredA11yElements.add(el);
-          node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("hover", node, e, false));
+          node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("hover", node, e, false));
         });
         el.addEventListener("mouseleave", (e) => {
           if (this.debugA11y) el.style.backgroundColor = "rgba(56, 189, 248, 0.05)";
           this.hoveredA11yElements.delete(el);
-          node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("pointerleave", node, e, false));
+          node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("pointerleave", node, e, false));
         });
         const capEl = el;
         const releasePointer = (event) => {
@@ -5763,24 +5774,24 @@ var Scene = (_class15 = class _Scene {
         };
         el.addEventListener("pointerdown", (e) => {
           if (typeof capEl.setPointerCapture === "function") capEl.setPointerCapture(e.pointerId);
-          node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("pointerdown", node, e));
+          node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("pointerdown", node, e));
         });
         el.addEventListener("pointerup", (e) => {
           releasePointer(e);
-          node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("pointerup", node, e));
+          node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("pointerup", node, e));
         });
         el.addEventListener("pointercancel", (e) => {
           releasePointer(e);
-          node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("pointercancel", node, e));
+          node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("pointercancel", node, e));
         });
         el.addEventListener(
           "pointermove",
-          (e) => node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("pointermove", node, e))
+          (e) => node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("pointermove", node, e))
         );
         el.addEventListener(
           "wheel",
           (e) => {
-            node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("wheel", node, e));
+            node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("wheel", node, e));
           },
           { passive: false }
         );
@@ -5805,10 +5816,10 @@ var Scene = (_class15 = class _Scene {
         );
         emitInitialScroll = emitScroll;
         el.addEventListener("keydown", (e) => {
-          node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("keydown", node, e));
+          node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("keydown", node, e));
         });
         el.addEventListener("keyup", (e) => {
-          node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("keyup", node, e));
+          node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("keyup", node, e));
         });
         if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
           const input = el;
@@ -5874,7 +5885,7 @@ var Scene = (_class15 = class _Scene {
           el.addEventListener("keydown", (e) => {
             if (e.key === "Enter" || e.key === " ") {
               e.preventDefault();
-              node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("click", node, e));
+              node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("click", node, e));
             }
           });
         }
@@ -6311,7 +6322,7 @@ var Scene = (_class15 = class _Scene {
       el.addEventListener(
         "wheel",
         (e2) => {
-          node.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)("wheel", node, e2));
+          node.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)("wheel", node, e2));
         },
         { passive: false }
       );
@@ -6740,7 +6751,7 @@ var Scene = (_class15 = class _Scene {
     let cap = this.effectiveMaxFPS();
     const isIdle = !this.dirty && !this.frameHadAnimation && !this.contentSemanticDeferred;
     if (isIdle && this.autoThrottle && this.renderMode === "always" && this.maxFPS > 0) {
-      cap = Math.min(cap, 2);
+      cap = Math.min(cap, this.idleFPS);
     }
     if (cap > 0 && time - this.lastTime < 1e3 / cap - 1) {
       this._skippedFrames++;
@@ -6980,7 +6991,7 @@ var Scene = (_class15 = class _Scene {
     let walkHadAnimation = false;
     let walkHadInteractive = false;
     const runUpdate = (node) => {
-      const overridesUpdate = node.update !== _chunkXHPUCU5Pjs.Entity.prototype.update;
+      const overridesUpdate = node.update !== _chunkXE6K7T5Sjs.Entity.prototype.update;
       let pending = node.hasPendingAnimations();
       if (pending || overridesUpdate) {
         node.update(dt, time);
@@ -6989,9 +7000,9 @@ var Scene = (_class15 = class _Scene {
       if (pending) walkHadAnimation = true;
       if (!walkHadInteractive && node.interactive) walkHadInteractive = true;
       if (this._devActive && this._devFrameCount % 120 === 0) {
-        if (overridesUpdate && node.hasPendingAnimations === _chunkXHPUCU5Pjs.Entity.prototype.hasPendingAnimations) {
+        if (overridesUpdate && node.hasPendingAnimations === _chunkXE6K7T5Sjs.Entity.prototype.hasPendingAnimations) {
           this._devWarn(
-            `Entity "${node.id}" overrides update() but not hasPendingAnimations(). Custom motion in update() without overriding hasPendingAnimations() causes the idle throttle to drop the animation to ~2fps. Override hasPendingAnimations() to return true while motion is in flight.`
+            `Entity "${node.id}" overrides update() but not hasPendingAnimations(). Custom motion in update() without overriding hasPendingAnimations() causes the idle throttle to slow the animation. Override hasPendingAnimations() to return true while motion is in flight.`
           );
         }
       }
@@ -7415,20 +7426,20 @@ function defaultMeasurer() {
   sharedMeasurer ??= _layout.resolveGlyphMeasurer.call(void 0, "sans-serif");
   return sharedMeasurer;
 }
-var TextEntity = (_class16 = class extends _chunkXHPUCU5Pjs.Entity {
+var TextEntity = (_class16 = class extends _chunkXE6K7T5Sjs.Entity {
   
   
   
   
-  __init176() {this.nodes = []}
+  __init177() {this.nodes = []}
   
-  __init177() {this.fillStyle = "#94a3b8"}
-  __init178() {this.strokeStyle = null}
-  __init179() {this.hoveredFillStyle = "#ffffff"}
-  __init180() {this.lineWidth = 1}
-  __init181() {this.isHovered = false}
+  __init178() {this.fillStyle = "#94a3b8"}
+  __init179() {this.strokeStyle = null}
+  __init180() {this.hoveredFillStyle = "#ffffff"}
+  __init181() {this.lineWidth = 1}
+  __init182() {this.isHovered = false}
   /** Bumped by {@link applyLayout}; read by `Scene` to skip an unchanged sync. */
-  __init182() {this.contentEpoch = 0}
+  __init183() {this.contentEpoch = 0}
   /**
    * Visual lines with real canvas geometry, rebuilt by {@link applyLayout}
    * exactly when `this.nodes` changes.
@@ -7440,9 +7451,9 @@ var TextEntity = (_class16 = class extends _chunkXHPUCU5Pjs.Entity {
    * ~0.35 em per line for a 24 px font, Firefox). Per-line carriers pin the DOM
    * baseline to the canvas baseline by construction, same as `ui/Text`.
    */
-  __init183() {this.projectionLines = []}
+  __init184() {this.projectionLines = []}
   constructor(text, atlas, maxWidth, fontSize = 24) {
-    super();_class16.prototype.__init176.call(this);_class16.prototype.__init177.call(this);_class16.prototype.__init178.call(this);_class16.prototype.__init179.call(this);_class16.prototype.__init180.call(this);_class16.prototype.__init181.call(this);_class16.prototype.__init182.call(this);_class16.prototype.__init183.call(this);;
+    super();_class16.prototype.__init177.call(this);_class16.prototype.__init178.call(this);_class16.prototype.__init179.call(this);_class16.prototype.__init180.call(this);_class16.prototype.__init181.call(this);_class16.prototype.__init182.call(this);_class16.prototype.__init183.call(this);_class16.prototype.__init184.call(this);;
     this.text = text;
     this.atlas = atlas;
     this.fontSize = fontSize;
@@ -7619,17 +7630,17 @@ var TextEntity = (_class16 = class extends _chunkXHPUCU5Pjs.Entity {
 }, _class16);
 
 // src/components/GridTextEntity.ts
-var GridTextEntity = (_class17 = class extends _chunkXHPUCU5Pjs.Entity {
+var GridTextEntity = (_class17 = class extends _chunkXE6K7T5Sjs.Entity {
   
-  __init184() {this.fillStyle = "#ffffff"}
-  __init185() {this.grid = []}
+  __init185() {this.fillStyle = "#ffffff"}
+  __init186() {this.grid = []}
   // Array of rows
-  __init186() {this.cols = 0}
-  __init187() {this.rows = 0}
+  __init187() {this.cols = 0}
+  __init188() {this.rows = 0}
   
   
   constructor(_atlas, fontSize = 10) {
-    super();_class17.prototype.__init184.call(this);_class17.prototype.__init185.call(this);_class17.prototype.__init186.call(this);_class17.prototype.__init187.call(this);;
+    super();_class17.prototype.__init185.call(this);_class17.prototype.__init186.call(this);_class17.prototype.__init187.call(this);_class17.prototype.__init188.call(this);;
     this.fontSize = fontSize;
     this.charWidth = fontSize * 1;
     this.charHeight = fontSize * 1.1;
@@ -7713,7 +7724,7 @@ function distSqToSegment(px, py, x1, y1, x2, y2) {
   const ey = py - cy;
   return ex * ex + ey * ey;
 }
-var SplineEntity = (_class18 = class extends _chunkXHPUCU5Pjs.Entity {
+var SplineEntity = (_class18 = class extends _chunkXE6K7T5Sjs.Entity {
   
   
   
@@ -7721,17 +7732,17 @@ var SplineEntity = (_class18 = class extends _chunkXHPUCU5Pjs.Entity {
   
   
   
-  __init188() {this.offscreen = null}
-  __init189() {this.baked = false}
+  __init189() {this.offscreen = null}
+  __init190() {this.baked = false}
   /** Logical (CSS-pixel) size of the baked bitmap — the blit destination size. */
-  __init190() {this.bakedWidth = 0}
-  __init191() {this.bakedHeight = 0}
+  __init191() {this.bakedWidth = 0}
+  __init192() {this.bakedHeight = 0}
   /**
    * Device-pixel ratio the bitmap was rasterized at. Tracked so a DPR change
    * (browser zoom, a monitor move, a renderer whose clamp changed) re-bakes
    * instead of blitting a bitmap at the wrong device density forever.
    */
-  __init192() {this.bakedDPR = 0}
+  __init193() {this.bakedDPR = 0}
   /**
    * Gradient strokes can't be baked to a solid-color bitmap; they render
    * per-frame. Derived from `_doc`, so it is NOT readonly — assigning a new
@@ -7739,7 +7750,7 @@ var SplineEntity = (_class18 = class extends _chunkXHPUCU5Pjs.Entity {
    */
   
   /** Lazily-flattened polylines (one Float32Array of [x,y,...] per segment) for hit-testing. */
-  __init193() {this.polylines = null}
+  __init194() {this.polylines = null}
   /**
    * The spline document to render. Assigning a new document invalidates all
    * caches (baked canvas, flattened polylines, bounds).
@@ -7773,9 +7784,9 @@ var SplineEntity = (_class18 = class extends _chunkXHPUCU5Pjs.Entity {
    * local bounds after painting the curves. Useful for drag feedback and
    * debugging hit areas. Defaults to `false`.
    */
-  __init194() {this.showBounds = false}
+  __init195() {this.showBounds = false}
   constructor(doc, opts = {}) {
-    super();_class18.prototype.__init188.call(this);_class18.prototype.__init189.call(this);_class18.prototype.__init190.call(this);_class18.prototype.__init191.call(this);_class18.prototype.__init192.call(this);_class18.prototype.__init193.call(this);_class18.prototype.__init194.call(this);;
+    super();_class18.prototype.__init189.call(this);_class18.prototype.__init190.call(this);_class18.prototype.__init191.call(this);_class18.prototype.__init192.call(this);_class18.prototype.__init193.call(this);_class18.prototype.__init194.call(this);_class18.prototype.__init195.call(this);;
     this._doc = doc;
     this._lineWidth = _nullishCoalesce(opts.lineWidth, () => ( 2));
     this.cache = _nullishCoalesce(opts.cache, () => ( true));
@@ -8041,7 +8052,7 @@ async function loadSpline(url) {
 }
 
 // src/components/Rect.ts
-var Rect = class extends _chunkXHPUCU5Pjs.Entity {
+var Rect = class extends _chunkXE6K7T5Sjs.Entity {
   
   
   
@@ -8097,7 +8108,7 @@ var Rect = class extends _chunkXHPUCU5Pjs.Entity {
 };
 
 // src/components/Circle.ts
-var Circle = class extends _chunkXHPUCU5Pjs.Entity {
+var Circle = class extends _chunkXE6K7T5Sjs.Entity {
   
   
   
@@ -8161,7 +8172,7 @@ var Circle = class extends _chunkXHPUCU5Pjs.Entity {
 };
 
 // src/components/Group.ts
-var Group = class extends _chunkXHPUCU5Pjs.Entity {
+var Group = class extends _chunkXE6K7T5Sjs.Entity {
   constructor(...children) {
     super();
     if (children.length > 0) this.add(...children);
@@ -8180,21 +8191,21 @@ var _math = require('@vectojs/math'); _createStarExport(_math);
 
 
 // src/tree/DOMPortalEntity.ts
-var DOMPortalEntity = (_class19 = class extends _chunkXHPUCU5Pjs.Entity {
+var DOMPortalEntity = (_class19 = class extends _chunkXE6K7T5Sjs.Entity {
   
-  __init195() {this.isDOMPortal = true}
-  __init196() {this.domListeners = []}
-  __init197() {this.resizeObserver = null}
-  __init198() {this.domBound = false}
-  __init199() {this.cachedWidth = 100}
-  __init200() {this.cachedHeight = 100}
-  __init201() {this.lastWidth = ""}
-  __init202() {this.lastHeight = ""}
-  __init203() {this.lastTransform = ""}
-  __init204() {this.lastZIndex = ""}
-  __init205() {this.lastOpacity = ""}
+  __init196() {this.isDOMPortal = true}
+  __init197() {this.domListeners = []}
+  __init198() {this.resizeObserver = null}
+  __init199() {this.domBound = false}
+  __init200() {this.cachedWidth = 100}
+  __init201() {this.cachedHeight = 100}
+  __init202() {this.lastWidth = ""}
+  __init203() {this.lastHeight = ""}
+  __init204() {this.lastTransform = ""}
+  __init205() {this.lastZIndex = ""}
+  __init206() {this.lastOpacity = ""}
   constructor(domElement, width, height, id) {
-    super(id);_class19.prototype.__init195.call(this);_class19.prototype.__init196.call(this);_class19.prototype.__init197.call(this);_class19.prototype.__init198.call(this);_class19.prototype.__init199.call(this);_class19.prototype.__init200.call(this);_class19.prototype.__init201.call(this);_class19.prototype.__init202.call(this);_class19.prototype.__init203.call(this);_class19.prototype.__init204.call(this);_class19.prototype.__init205.call(this);;
+    super(id);_class19.prototype.__init196.call(this);_class19.prototype.__init197.call(this);_class19.prototype.__init198.call(this);_class19.prototype.__init199.call(this);_class19.prototype.__init200.call(this);_class19.prototype.__init201.call(this);_class19.prototype.__init202.call(this);_class19.prototype.__init203.call(this);_class19.prototype.__init204.call(this);_class19.prototype.__init205.call(this);_class19.prototype.__init206.call(this);;
     this.domElement = domElement;
     this.width = _nullishCoalesce(width, () => ( 0));
     this.height = _nullishCoalesce(height, () => ( 0));
@@ -8236,7 +8247,7 @@ var DOMPortalEntity = (_class19 = class extends _chunkXHPUCU5Pjs.Entity {
     ];
     for (const type of events) {
       const handler = (e) => {
-        this.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)(type, this, e));
+        this.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)(type, this, e));
       };
       this.domElement.addEventListener(type, handler);
       this.domListeners.push({ type, handler, capture: false });
@@ -8247,7 +8258,7 @@ var DOMPortalEntity = (_class19 = class extends _chunkXHPUCU5Pjs.Entity {
     ];
     for (const { native, vecto } of hoverEvents) {
       const handler = (e) => {
-        this.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)(vecto, this, e, false));
+        this.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)(vecto, this, e, false));
       };
       this.domElement.addEventListener(native, handler);
       this.domListeners.push({ type: native, handler, capture: false });
@@ -8255,7 +8266,7 @@ var DOMPortalEntity = (_class19 = class extends _chunkXHPUCU5Pjs.Entity {
     const focusEvents = ["focus", "blur"];
     for (const type of focusEvents) {
       const handler = (e) => {
-        this.dispatchEvent(new (0, _chunkXHPUCU5Pjs.VectoJSEvent)(type, this, e, true));
+        this.dispatchEvent(new (0, _chunkXE6K7T5Sjs.VectoJSEvent)(type, this, e, true));
       };
       this.domElement.addEventListener(type, handler, true);
       this.domListeners.push({ type, handler, capture: true });
@@ -8353,4 +8364,4 @@ Scene.registerWebGPUParticleSystemManager(_chunkMO24PVGTjs.WebGPUParticleSystemM
 
 
 
-exports.CanvasRenderer = _chunkMO24PVGTjs.CanvasRenderer; exports.Circle = Circle; exports.ComputeParticleEntity = ComputeParticleEntity; exports.DEFAULT_CONTENT_SEMANTIC_BUDGET = DEFAULT_CONTENT_SEMANTIC_BUDGET; exports.DOMPortalEntity = DOMPortalEntity; exports.Entity = _chunkXHPUCU5Pjs.Entity; exports.GlyphRasterAtlas = _chunkMO24PVGTjs.GlyphRasterAtlas; exports.GridTextEntity = GridTextEntity; exports.Group = Group; exports.MSDFTextEntity = _chunkXHPUCU5Pjs.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.Rect = Rect; exports.SCENE_OPTION_KEYS = SCENE_OPTION_KEYS; exports.SVGEntity = _chunkXHPUCU5Pjs.SVGEntity; exports.SVGRenderer = _chunkMO24PVGTjs.SVGRenderer; exports.Scene = Scene; exports.SplineEntity = SplineEntity; exports.TextEntity = TextEntity; exports.TextRasterCache = _chunkMO24PVGTjs.TextRasterCache; exports.VECTO_USER_TIMING = VECTO_USER_TIMING; exports.VectoJSEvent = _chunkXHPUCU5Pjs.VectoJSEvent; exports.WebGPUParticleSystemManager = _chunkMO24PVGTjs.WebGPUParticleSystemManager; exports.beginVectoUserTiming = beginVectoUserTiming; exports.contentLineInHint = _chunkXHPUCU5Pjs.contentLineInHint; exports.createWebGLPointRenderer = _chunkMO24PVGTjs.createWebGLPointRenderer; exports.endVectoUserTiming = endVectoUserTiming; exports.installRendererDevTraps = _chunkMO24PVGTjs.installRendererDevTraps; exports.isRendererDevMode = _chunkMO24PVGTjs.isRendererDevMode; exports.isSafeUrl = _chunkMO24PVGTjs.isSafeUrl; exports.loadSpline = loadSpline; exports.measureVectoUserTiming = measureVectoUserTiming; exports.parseColorToRGBA = _chunkMO24PVGTjs.parseColorToRGBA; exports.polySegmentToBezier = polySegmentToBezier; exports.sanitizeUrl = _chunkMO24PVGTjs.sanitizeUrl; exports.setRendererDevMode = _chunkMO24PVGTjs.setRendererDevMode;
+exports.CanvasRenderer = _chunkMO24PVGTjs.CanvasRenderer; exports.Circle = Circle; exports.ComputeParticleEntity = ComputeParticleEntity; exports.DEFAULT_CONTENT_SEMANTIC_BUDGET = DEFAULT_CONTENT_SEMANTIC_BUDGET; exports.DOMPortalEntity = DOMPortalEntity; exports.Entity = _chunkXE6K7T5Sjs.Entity; exports.GlyphRasterAtlas = _chunkMO24PVGTjs.GlyphRasterAtlas; exports.GridTextEntity = GridTextEntity; exports.Group = Group; exports.MSDFTextEntity = _chunkXE6K7T5Sjs.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.Rect = Rect; exports.SCENE_OPTION_KEYS = SCENE_OPTION_KEYS; exports.SVGEntity = _chunkXE6K7T5Sjs.SVGEntity; exports.SVGRenderer = _chunkMO24PVGTjs.SVGRenderer; exports.Scene = Scene; exports.SplineEntity = SplineEntity; exports.TextEntity = TextEntity; exports.TextRasterCache = _chunkMO24PVGTjs.TextRasterCache; exports.VECTO_USER_TIMING = VECTO_USER_TIMING; exports.VectoJSEvent = _chunkXE6K7T5Sjs.VectoJSEvent; exports.WebGPUParticleSystemManager = _chunkMO24PVGTjs.WebGPUParticleSystemManager; exports.beginVectoUserTiming = beginVectoUserTiming; exports.contentLineInHint = _chunkXE6K7T5Sjs.contentLineInHint; exports.createWebGLPointRenderer = _chunkMO24PVGTjs.createWebGLPointRenderer; exports.endVectoUserTiming = endVectoUserTiming; exports.installRendererDevTraps = _chunkMO24PVGTjs.installRendererDevTraps; exports.isRendererDevMode = _chunkMO24PVGTjs.isRendererDevMode; exports.isSafeUrl = _chunkMO24PVGTjs.isSafeUrl; exports.loadSpline = loadSpline; exports.measureVectoUserTiming = measureVectoUserTiming; exports.parseColorToRGBA = _chunkMO24PVGTjs.parseColorToRGBA; exports.polySegmentToBezier = polySegmentToBezier; exports.sanitizeUrl = _chunkMO24PVGTjs.sanitizeUrl; exports.setRendererDevMode = _chunkMO24PVGTjs.setRendererDevMode;

package/dist/index.mjs

@@ -18,7 +18,7 @@ import {
   SVGEntity,
   VectoJSEvent,
   contentLineInHint
-} from "./chunk-CHDJEHML.mjs";
+} from "./chunk-QJC4VZ2E.mjs";
 
 // src/tree/ComputeParticleEntity.ts
 var PARTICLE_STRIDE_FLOATS = 8;
@@ -178,8 +178,8 @@ var ComputeParticleEntity = class extends Entity {
    * render-tree walk, but this entity is still a normal tree member that
    * walk visits — without this override, the base `Entity.hasPendingAnimations()`
    * (always `false`) is what Scene sees, so `renderMode: 'always'`'s idle
-   * auto-throttle drops the WHOLE scene to ~2fps the instant nothing else in
-   * the tree is animating, even while thousands of particles are visibly
+   * auto-throttle drops the WHOLE scene to the idle FPS floor the instant
+   * nothing else in the tree is animating, even while thousands of particles are visibly
    * drifting or spring-settling. A spring+damping system asymptotically
    * approaches zero velocity but never reaches it exactly, so this checks
    * against a small epsilon rather than `!== 0` — otherwise this would
@@ -3435,6 +3435,7 @@ var SCENE_OPTION_KEYS = [
   "contentSemanticMargin",
   "debugA11y",
   "disableWindowResize",
+  "idleFPS",
   "maxDPR",
   "maxFPS",
   "particleBackend",
@@ -3863,8 +3864,17 @@ var Scene = class _Scene {
     if (value) this._dirty.mark(void 0, this.currentFrame);
     else this._dirty.clear();
   }
-  /** Whether to throttle rendering to 2 FPS when the scene is static to save power. */
+  /**
+   * Whether to throttle the `'always'` loop when the scene is static to save
+   * power. The idle floor is {@link Scene.idleFPS} (default 60).
+   */
   autoThrottle = true;
+  /**
+   * Frame-rate floor for an idle `'always'` scene when {@link Scene.autoThrottle}
+   * is on. Default `60`. Set `2` for the legacy aggressive idle sleep, `0` to
+   * keep the scene's `maxFPS` cadence while idle.
+   */
+  idleFPS = 60;
   // --- Frame telemetry (read via `frameStats`) ---------------------------
   /** Wall-clock ms spent inside the last `render()` call. */
   _lastFrameMs = 0;
@@ -4794,6 +4804,7 @@ var Scene = class _Scene {
     this.maxFPS = options.maxFPS ?? (isTest ? 0 : 60);
     this.respectReducedMotion = options.respectReducedMotion ?? true;
     this.autoThrottle = options.autoThrottle ?? true;
+    this.idleFPS = options.idleFPS ?? 60;
     this.phases.userTiming = options.userTiming ?? false;
     this.particleBackend = options.particleBackend ?? "auto";
     this.a11ySyncInterval = options.a11ySyncInterval ?? 0;
@@ -6739,7 +6750,7 @@ var Scene = class _Scene {
     let cap = this.effectiveMaxFPS();
     const isIdle = !this.dirty && !this.frameHadAnimation && !this.contentSemanticDeferred;
     if (isIdle && this.autoThrottle && this.renderMode === "always" && this.maxFPS > 0) {
-      cap = Math.min(cap, 2);
+      cap = Math.min(cap, this.idleFPS);
     }
     if (cap > 0 && time - this.lastTime < 1e3 / cap - 1) {
       this._skippedFrames++;
@@ -6990,7 +7001,7 @@ var Scene = class _Scene {
       if (this._devActive && this._devFrameCount % 120 === 0) {
         if (overridesUpdate && node.hasPendingAnimations === Entity.prototype.hasPendingAnimations) {
           this._devWarn(
-            `Entity "${node.id}" overrides update() but not hasPendingAnimations(). Custom motion in update() without overriding hasPendingAnimations() causes the idle throttle to drop the animation to ~2fps. Override hasPendingAnimations() to return true while motion is in flight.`
+            `Entity "${node.id}" overrides update() but not hasPendingAnimations(). Custom motion in update() without overriding hasPendingAnimations() causes the idle throttle to slow the animation. Override hasPendingAnimations() to return true while motion is in flight.`
           );
         }
       }

package/dist/text/MSDFTextEntity.d.ts

@@ -59,8 +59,8 @@ export declare class MSDFTextEntity extends Entity {
      *
      * Measured on Chromium and Firefox (2026-07-31) with a 600 ms atlas: the
      * scene's own rAF loop never uploaded a decoded atlas in EITHER render mode.
-     * `onDemand` skips idle frames outright; `always` throttles to 2 FPS when
-     * idle, so whether it recovers is down to whether a throttled tick happens to
+     * `onDemand` skips idle frames outright; `always` throttles to the idle FPS
+     * floor when idle, so whether it recovers is down to whether a throttled tick happens to
      * land after the decode — Chromium got one, Firefox did not. Neither is a
      * mechanism, which is why this listener exists rather than relying on the
      * frame loop to come back around.

package/dist/text.js

@@ -2,11 +2,11 @@
 
 
 
-var _chunkXHPUCU5Pjs = require('./chunk-XHPUCU5P.js');
+var _chunkXE6K7T5Sjs = require('./chunk-XE6K7T5S.js');
 
 // src/text/index.ts
 var _text = require('@vectojs/text'); _createStarExport(_text);
 
 
 
-exports.MSDFTextEntity = _chunkXHPUCU5Pjs.MSDFTextEntity; exports.SVGEntity = _chunkXHPUCU5Pjs.SVGEntity;
+exports.MSDFTextEntity = _chunkXE6K7T5Sjs.MSDFTextEntity; exports.SVGEntity = _chunkXE6K7T5Sjs.SVGEntity;

package/dist/text.mjs

@@ -1,7 +1,7 @@
 import {
   MSDFTextEntity,
   SVGEntity
-} from "./chunk-CHDJEHML.mjs";
+} from "./chunk-QJC4VZ2E.mjs";
 
 // src/text/index.ts
 export * from "@vectojs/text";

package/dist/tree/ComputeParticleEntity.d.ts

@@ -113,8 +113,8 @@ export declare class ComputeParticleEntity extends Entity {
      * render-tree walk, but this entity is still a normal tree member that
      * walk visits — without this override, the base `Entity.hasPendingAnimations()`
      * (always `false`) is what Scene sees, so `renderMode: 'always'`'s idle
-     * auto-throttle drops the WHOLE scene to ~2fps the instant nothing else in
-     * the tree is animating, even while thousands of particles are visibly
+     * auto-throttle drops the WHOLE scene to the idle FPS floor the instant
+     * nothing else in the tree is animating, even while thousands of particles are visibly
      * drifting or spring-settling. A spring+damping system asymptotically
      * approaches zero velocity but never reaches it exactly, so this checks
      * against a small epsilon rather than `!== 0` — otherwise this would

package/dist/tree/Scene.d.ts

@@ -98,10 +98,22 @@ export interface SceneOptions {
      */
     maxDPR?: number;
     /**
-     * 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`.
+     * Enable automatic throttling of the `'always'` loop when the scene is
+     * static (no active transitions and not marked dirty) to save power/CPU.
+     * The idle floor is 60 FPS by default; raise or lower it with
+     * {@link SceneOptions.idleFPS}. Default is `true`.
      */
     autoThrottle?: boolean;
+    /**
+     * Frame-rate floor for an idle `'always'` scene when
+     * {@link SceneOptions.autoThrottle} is on. Default `60` — an idle scene
+     * keeps animating smoothly instead of stuttering at the old 2 FPS floor.
+     * Set e.g. `2` to restore the aggressive deep sleep for battery-critical
+     * scenes (the developer's explicit choice); `0` means "keep the scene's
+     * `maxFPS` cadence while idle". Ignored when `autoThrottle` is `false` or
+     * `renderMode` is `'onDemand'` (onDemand already renders zero idle frames).
+     */
+    idleFPS?: number;
     /**
      * Emit User Timing marks and measures for render phases. Default `false`.
      * Intended for short profiler captures; enable only while collecting one.
@@ -196,8 +208,9 @@ export interface SceneOptions {
     readingDirection?: 'ltr' | 'rtl';
     /**
      * When to repaint:
-     * - `'always'` (default): drive a continuous rAF loop, throttling to 2 FPS
-     *   while the scene is idle if {@link SceneOptions.autoThrottle} is on.
+     * - `'always'` (default): drive a continuous rAF loop, throttling to the
+     *   {@link SceneOptions.idleFPS} floor (default 60) while the scene is idle
+     *   if {@link SceneOptions.autoThrottle} is on.
      * - `'onDemand'`: paint only after {@link Scene.markDirty} (or an active
      *   transition), so a genuinely static scene costs zero frames.
      *
@@ -217,14 +230,14 @@ export interface SceneOptions {
  * plain untranspiled JS, gets no diagnostic at all. `renderMode` was a public
  * field with no matching option for several releases, and four `@vectojs` demos
  * shipped `new Scene(canvas, { renderMode: 'onDemand' })` — reading correctly,
- * doing nothing, and sitting on the 2 FPS idle floor.
+ * doing nothing, and sitting on the idle FPS floor.
  *
  * Kept as a literal rather than derived from a type: `keyof SceneOptions` does
  * not survive to runtime, so this list is the only form a constructor can check
  * against. A new option must be added here too — the test suite asserts the two
  * stay in sync.
  */
-export declare const SCENE_OPTION_KEYS: readonly ['a11ySyncInterval', 'autoThrottle', 'contentProjection', 'contentProjectionMargin', 'contentSemanticBudget', 'contentSemanticMargin', 'debugA11y', 'disableWindowResize', 'maxDPR', 'maxFPS', 'particleBackend', 'pointBackend', 'readingDirection', 'renderer', 'renderMode', 'respectReducedMotion', 'userTiming'];
+export declare const SCENE_OPTION_KEYS: readonly ['a11ySyncInterval', 'autoThrottle', 'contentProjection', 'contentProjectionMargin', 'contentSemanticBudget', 'contentSemanticMargin', 'debugA11y', 'disableWindowResize', 'idleFPS', 'maxDPR', 'maxFPS', 'particleBackend', 'pointBackend', 'readingDirection', 'renderer', 'renderMode', 'respectReducedMotion', 'userTiming'];
 /** Frame-rate the loop is capped to when the OS requests reduced motion. */
 export declare const REDUCED_MOTION_FPS = 30;
 export type { AcceleratorReason, AcceleratorStatus, AcceleratorReport };
@@ -406,8 +419,17 @@ export declare class Scene {
      */
     private get dirty();
     private set dirty(value);
-    /** Whether to throttle rendering to 2 FPS when the scene is static to save power. */
+    /**
+     * Whether to throttle the `'always'` loop when the scene is static to save
+     * power. The idle floor is {@link Scene.idleFPS} (default 60).
+     */
     autoThrottle: boolean;
+    /**
+     * Frame-rate floor for an idle `'always'` scene when {@link Scene.autoThrottle}
+     * is on. Default `60`. Set `2` for the legacy aggressive idle sleep, `0` to
+     * keep the scene's `maxFPS` cadence while idle.
+     */
+    idleFPS: number;
     /** Wall-clock ms spent inside the last `render()` call. */
     private _lastFrameMs;
     /** Rolling exponential average of rendered-frame intervals, in ms. */

package/package.json

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