@vectojs/core 1.29.0 → 1.31.0

package/dist/index.js

@@ -18,7 +18,8 @@ var _chunkM73XB4ZKjs = require('./chunk-M73XB4ZK.js');
 
 
 
-var _chunkZ3HFY75Rjs = require('./chunk-Z3HFY75R.js');
+
+var _chunkTRT2TRCWjs = require('./chunk-TRT2TRCW.js');
 
 // src/tree/Scene.ts
 var _animation = require('@vectojs/animation'); _createStarExport(_animation);
@@ -33,7 +34,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 _chunkZ3HFY75Rjs.Entity {
+var ComputeParticleEntity = (_class = class extends _chunkTRT2TRCWjs.Entity {
   
   
   
@@ -1379,6 +1380,7 @@ var SCENE_OPTION_KEYS = [
   "autoThrottle",
   "contentProjection",
   "contentProjectionMargin",
+  "contentSemanticMargin",
   "debugA11y",
   "disableWindowResize",
   "maxDPR",
@@ -1431,6 +1433,45 @@ function parseInlinePx(value) {
   const n = parseFloat(value);
   return Number.isFinite(n) && n > 0 ? n : null;
 }
+function projectionGridLineWindow(grid, projectionLines, band) {
+  const count = grid.lines.length;
+  const all = { start: 0, end: count, gated: false };
+  if (!band || count === 0) return all;
+  const lines = [];
+  for (let i = 0; i < count; i++) {
+    const projected = _optionalChain([projectionLines, 'optionalAccess', _24 => _24[i]]);
+    lines.push({
+      y: _nullishCoalesce(_optionalChain([projected, 'optionalAccess', _25 => _25.y]), () => ( i * grid.lineHeight)),
+      lineHeight: _nullishCoalesce(_optionalChain([projected, 'optionalAccess', _26 => _26.lineHeight]), () => ( grid.lineHeight))
+    });
+  }
+  return projectionLineWindow(lines, band, grid.lineHeight);
+}
+function projectionLineWindow(lines, band, fallbackLineHeight) {
+  const all = {
+    start: 0,
+    end: lines.length,
+    gated: false
+  };
+  if (!band || lines.length === 0) return all;
+  let start = -1;
+  let end = -1;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const h = _nullishCoalesce(line.lineHeight, () => ( fallbackLineHeight));
+    if (line.y + h >= band.minY && line.y <= band.maxY) {
+      if (start === -1) start = i;
+      end = i + 1;
+    } else if (start !== -1 && line.y > band.maxY) {
+      break;
+    }
+  }
+  if (start === -1) {
+    return { start: 0, end: Math.min(1, lines.length), gated: true };
+  }
+  if (start === 0 && end === lines.length) return all;
+  return { start, end, gated: true };
+}
 function collectTextNodes(root) {
   const out = [];
   const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
@@ -1510,9 +1551,9 @@ function parseCssMatrix(transform) {
 }
 function clientToGridLocal(contentEl, canvas, clientX, clientY) {
   const line = contentEl.querySelector("[data-vecto-grid-line]");
-  const originMarker = _optionalChain([line, 'optionalAccess', _24 => _24.querySelector, 'call', _25 => _25('[data-vecto-grid-basis="origin"]')]);
-  const xMarker = _optionalChain([line, 'optionalAccess', _26 => _26.querySelector, 'call', _27 => _27('[data-vecto-grid-basis="x"]')]);
-  const yMarker = _optionalChain([line, 'optionalAccess', _28 => _28.querySelector, 'call', _29 => _29('[data-vecto-grid-basis="y"]')]);
+  const originMarker = _optionalChain([line, 'optionalAccess', _27 => _27.querySelector, 'call', _28 => _28('[data-vecto-grid-basis="origin"]')]);
+  const xMarker = _optionalChain([line, 'optionalAccess', _29 => _29.querySelector, 'call', _30 => _30('[data-vecto-grid-basis="x"]')]);
+  const yMarker = _optionalChain([line, 'optionalAccess', _31 => _31.querySelector, 'call', _32 => _32('[data-vecto-grid-basis="y"]')]);
   if (line && originMarker && xMarker && yMarker) {
     const origin = originMarker.getBoundingClientRect();
     const xPoint = xMarker.getBoundingClientRect();
@@ -1596,7 +1637,7 @@ function nearestTextPositionInLine(line, x, y) {
       nearest = { position: { node, offset }, distance: candidate.distance };
     }
   }
-  return _nullishCoalesce(_optionalChain([nearest, 'optionalAccess', _30 => _30.position]), () => ( null));
+  return _nullishCoalesce(_optionalChain([nearest, 'optionalAccess', _33 => _33.position]), () => ( null));
 }
 function nearestTextPositionInProjection(contentEl, canvas, x, y, eventTarget) {
   if (contentEl.dataset.vectoContentGrid !== void 0) {
@@ -1610,7 +1651,7 @@ function nearestTextPositionInProjection(contentEl, canvas, x, y, eventTarget) {
     }
     targetLine = targetLine.parentElement;
   }
-  if (_optionalChain([targetLine, 'optionalAccess', _31 => _31.parentElement]) === contentEl) {
+  if (_optionalChain([targetLine, 'optionalAccess', _34 => _34.parentElement]) === contentEl) {
     return nearestTextPositionInLine(targetLine, x, y);
   }
   let bestLine = null;
@@ -1888,7 +1929,7 @@ var Scene = (_class7 = class _Scene {
   __init50() {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', _32 => _32.reducedMotionQuery, 'optionalAccess', _33 => _33.matches]);
+    return this.respectReducedMotion && !!_optionalChain([this, 'access', _35 => _35.reducedMotionQuery, 'optionalAccess', _36 => _36.matches]);
   }
   /**
    * True when the OS is in a forced-colors mode (Windows High Contrast, and the
@@ -1899,7 +1940,7 @@ var Scene = (_class7 = class _Scene {
    * when the setting toggles.
    */
   get forcedColors() {
-    return !!_optionalChain([this, 'access', _34 => _34.forcedColorsQuery, 'optionalAccess', _35 => _35.matches]);
+    return !!_optionalChain([this, 'access', _37 => _37.forcedColorsQuery, 'optionalAccess', _38 => _38.matches]);
   }
   /**
    * Throttle interval (ms) for the a11y/automation shadow sync. `0` = every
@@ -1917,10 +1958,19 @@ var Scene = (_class7 = class _Scene {
   __init54() {this.a11yElements = /* @__PURE__ */ new Map()}
   /** DOM nodes mirroring static text content, keyed by entity id. */
   __init55() {this.contentElements = /* @__PURE__ */ new Map()}
+  /**
+   * What the last completed content-projection sync was built from, per entity.
+   *
+   * Compared at the top of {@link syncContentProjection} to skip a block whose
+   * content AND geometry are both unchanged, before the O(glyphs) projection
+   * build. Only populated for entities that opt in via
+   * {@link Entity.getContentEpoch}. (carryctx CTX-0199)
+   */
+  __init56() {this.contentSyncState = /* @__PURE__ */ new Map()}
   /** Pending cold font-calibration frame per projected grid entity. */
-  __init56() {this.contentGridCalibrationFrames = /* @__PURE__ */ new Map()}
+  __init57() {this.contentGridCalibrationFrames = /* @__PURE__ */ new Map()}
   /** Detached, untransformed font probes used by the cold calibration pass. */
-  __init57() {this.contentGridCalibrationProbes = /* @__PURE__ */ new Map()}
+  __init58() {this.contentGridCalibrationProbes = /* @__PURE__ */ new Map()}
   /**
    * Monotonic stamp identifying the conditions grid cells were calibrated under.
    *
@@ -1941,69 +1991,82 @@ var Scene = (_class7 = class _Scene {
    * A plain incrementing integer rather than the descriptive calibration key,
    * because it goes into an attribute selector and must not need escaping.
    */
-  __init58() {this.contentGridCalibrationGeneration = 0}
+  __init59() {this.contentGridCalibrationGeneration = 0}
   /** The `(fontEpoch, pageScale)` pair the current generation corresponds to. */
-  __init59() {this.contentGridCalibrationStamp = ""}
+  __init60() {this.contentGridCalibrationStamp = ""}
   /** Invalidates grid font calibration after browser font availability changes. */
-  __init60() {this.contentFontEpoch = 0}
+  __init61() {this.contentFontEpoch = 0}
   /** Cached Canvas-to-client scale for the current font/viewport epoch. */
-  __init61() {this.contentMetricScaleEpoch = -1}
-  __init62() {this.contentMetricScaleX = 1}
-  __init63() {this.contentProjectionEnabled = true}
-  // Virtualization margin (px) for content projection; `undefined` → one
-  // viewport height, resolved at sync time. `Infinity` = materialize everything.
-  __init64() {this.contentProjectionMargin = void 0}
+  __init62() {this.contentMetricScaleEpoch = -1}
+  __init63() {this.contentMetricScaleX = 1}
+  __init64() {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).
+  __init65() {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.
+  __init66() {this.contentSemanticMargin = void 0}
   /**
    * True while a text-selection drag that started on a projection's blank
    * region (no text node under the press) is being driven manually — the
    * browser has no native anchor for it, so mousemove extends the Selection
    * from the position we resolved ourselves.
    */
-  __init65() {this.blankRegionSelectionDrag = false}
-  __init66() {this.contentSelectionAnchor = null}
-  __init67() {this.contentSelectionEndListener = null}
+  __init67() {this.blankRegionSelectionDrag = false}
+  __init68() {this.contentSelectionAnchor = null}
+  __init69() {this.contentSelectionEndListener = null}
   // Animation/interactive flags collected during the render walk (tree-walk
   // fusion): the loop reads last frame's answers instead of re-walking the
   // tree up to 4× per tick. Start true so the first tick stays conservative.
-  __init68() {this.frameHadAnimation = true}
-  __init69() {this.frameHadInteractive = true}
+  __init70() {this.frameHadAnimation = true}
+  __init71() {this.frameHadInteractive = true}
   
   /** Active `(resolution: Ndppx)` media query watching for a runtime DPR change
    *  (window moved between monitors, browser zoom) so the canvas backing store
    *  can be re-scaled — otherwise it stays rasterized at the old DPR and blurs.
    *  A resolution media query only fires when leaving its exact value, so the
    *  handler re-arms a fresh query for the new DPR each time. */
-  __init70() {this.dprMediaQuery = null}
+  __init72() {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. */
-  __init71() {this.canvasResizeObserver = null}
-  __init72() {this.dprChangeHandler = null}
-  __init73() {this.focusedA11yElement = null}
+  __init73() {this.canvasResizeObserver = null}
+  __init74() {this.dprChangeHandler = null}
+  __init75() {this.focusedA11yElement = null}
   /** Last geometry `syncOverlayGeometry` wrote, so an unchanged frame can skip the
    *  style writes entirely. Reset to `null` to force the next sync (a new overlay
    *  layer was created and has never been positioned). */
-  __init74() {this._overlayGeometry = null}
+  __init76() {this._overlayGeometry = null}
   /** Shadow elements the pointer is currently inside. Lets a removal that happens
    *  mid-hover synthesize the `pointerleave` the browser never sends for a
    *  detached element, so the entity doesn't keep its hover state. */
-  __init75() {this.hoveredA11yElements = /* @__PURE__ */ new WeakSet()}
+  __init77() {this.hoveredA11yElements = /* @__PURE__ */ new WeakSet()}
+  /**
+   * Entity ids the application has pinned via {@link requestA11yProjection}.
+   *
+   * Ids rather than entities so a removed entity cannot be retained by this set;
+   * a stale id simply never matches. Cleared per-entity by
+   * {@link releaseA11yProjection}.
+   */
+  __init78() {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. */
-  __init76() {this.focusSentinel = null}
-  __init77() {this.caretBlinkTimer = null}
-  __init78() {this.a11yNeedsReorder = true}
-  __init79() {this.portalRoot = null}
-  __init80() {this.fullViewportElements = []}
-  __init81() {this.normalElements = []}
-  __init82() {this.activeIds = /* @__PURE__ */ new Set()}
+  __init79() {this.focusSentinel = null}
+  __init80() {this.caretBlinkTimer = null}
+  __init81() {this.a11yNeedsReorder = true}
+  __init82() {this.portalRoot = null}
+  __init83() {this.fullViewportElements = []}
+  __init84() {this.normalElements = []}
+  __init85() {this.activeIds = /* @__PURE__ */ new Set()}
   /** Per-parent insertion cursor, reused by `enforceA11yDomOrder`. */
-  __init83() {this.a11yOrderCursors = /* @__PURE__ */ new Map()}
+  __init86() {this.a11yOrderCursors = /* @__PURE__ */ new Map()}
   /** Membership set for the elements being ordered, reused per reorder pass. */
-  __init84() {this.a11yOrderMembers = /* @__PURE__ */ new Set()}
+  __init87() {this.a11yOrderMembers = /* @__PURE__ */ new Set()}
   /**
    * Elements that are an *ancestor* of another ordered element, reused per pass.
    *
@@ -2011,11 +2074,11 @@ var Scene = (_class7 = class _Scene {
    * items) spans every descendant row, so it must not extend a visual row band —
    * see {@link sortNormalElementsVisually}.
    */
-  __init85() {this.a11yOrderContainers = /* @__PURE__ */ new Set()}
-  __init86() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
-  __init87() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
-  __init88() {this.portalEntities = /* @__PURE__ */ new Map()}
-  __init89() {this.renderOrderCounter = 0}
+  __init88() {this.a11yOrderContainers = /* @__PURE__ */ new Set()}
+  __init89() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
+  __init90() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
+  __init91() {this.portalEntities = /* @__PURE__ */ new Map()}
+  __init92() {this.renderOrderCounter = 0}
   /**
    * Monotonic render-frame counter, bumped once per authoritative `render()`
    * pass. Entities stamp their per-frame world-matrix cache with this value and
@@ -2024,7 +2087,7 @@ var Scene = (_class7 = class _Scene {
    * back to the ancestor walk. Public for the same reason `Entity._getTrig`/
    * `_setWorldCache` are: it is a cross-class render-internal contract.
    */
-  __init90() {this.currentFrame = 0}
+  __init93() {this.currentFrame = 0}
   // ── WASM transform backend (invisible accelerator) ──────────────────────────
   // When `_transformBackend === 'wasm'`, the main render walk sources each
   // entity's world matrix from an SoA store composed by `_wasm` (see
@@ -2032,24 +2095,24 @@ var Scene = (_class7 = class _Scene {
   // fallback and the default: a null backend, a non-main renderer, or any entity
   // absent from the store all fall back to the JS composition, so WASM can only
   // ever change *how fast* a world matrix is produced, never *what* it is.
-  __init91() {this._wasm = null}
-  __init92() {this._transformBackend = "js"}
+  __init94() {this._wasm = null}
+  __init95() {this._transformBackend = "js"}
   // Resident store state (Stage 3). The store layout — slot assignment + sibling
   // runs — depends only on tree TOPOLOGY, so it is rebuilt only when the
   // structure changes (add/remove/reparent bump `_structureVersion`). Between
   // rebuilds the per-frame cost is: gather each entity's transform into the
   // resident wasm input view + run the kernel — no reallocation, no readback.
-  __init93() {this._treeStore = null}
-  __init94() {this._slotEntity = []}
+  __init96() {this._treeStore = null}
+  __init97() {this._slotEntity = []}
   // store slot -> entity (also validates slots)
-  __init95() {this._wasmInputs = null}
-  __init96() {this._wasmWorld = null}
-  __init97() {this._structureVersion = 0}
-  __init98() {this._storeStructureVersion = -1}
+  __init98() {this._wasmInputs = null}
+  __init99() {this._wasmWorld = null}
+  __init100() {this._structureVersion = 0}
+  __init101() {this._storeStructureVersion = -1}
   // Cached list of ComputeParticleEntity instances in the tree, keyed by the
   // structure version it was gathered at. Rebuilt only on a topology change.
-  __init99() {this._computeEntities = []}
-  __init100() {this._computeEntitiesVersion = -1}
+  __init102() {this._computeEntities = []}
+  __init103() {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() {
@@ -2134,7 +2197,7 @@ var Scene = (_class7 = class _Scene {
    * cached globally; the instance is per-Scene, which is the isolation that
    * actually matters.
    */
-  __init101() {this._wasmRuntime = null}
+  __init104() {this._wasmRuntime = null}
   /**
    * Load (or reuse) this Scene's shared WASM runtime.
    *
@@ -2162,30 +2225,30 @@ var Scene = (_class7 = class _Scene {
   get wasmRuntime() {
     return this._wasmRuntime;
   }
-  __init102() {this._hitWasm = null}
+  __init105() {this._hitWasm = null}
   // Cache key: which frame + structure version the grid was last (successfully,
   // non-overflowing) built for. findEntityAt is called ad-hoc (pointer
   // hover/click), not every frame, so the grid is refreshed lazily on demand
   // rather than proactively every render() — unlike the transform store, which
   // every frame's draw depends on.
-  __init103() {this._hitGridFrame = -1}
-  __init104() {this._hitGridOk = false}
-  __init105() {this._hitSlotEntity = []}
-  __init106() {this._hitBoundless = []}
+  __init106() {this._hitGridFrame = -1}
+  __init107() {this._hitGridOk = false}
+  __init108() {this._hitSlotEntity = []}
+  __init109() {this._hitBoundless = []}
   /** Reused buffer for the fused gather, so a pointer query allocates nothing. */
-  __init107() {this._hitGatherBuffer = null}
+  __init110() {this._hitGatherBuffer = null}
   /**
    * Whether the last grid build sourced its AABBs from the WASM transform store
    * rather than recomputing them in JS. Diagnostic only — both paths must
    * produce the same entity for a given point.
    */
-  __init108() {this._hitFusedGather = false}
+  __init111() {this._hitFusedGather = false}
   /**
    * Whether `compute_aabbs` has run against the current frame's world matrices.
    * The AABB pass is only meaningful after a `compose_*`, so the fused gather
    * must not read the views before then.
    */
-  __init109() {this._wasmAabbsFresh = false}
+  __init112() {this._wasmAabbsFresh = false}
   /** Did the last hit-grid build use the fused (WASM-store) gather? */
   get hitGatherPath() {
     return this._hitFusedGather ? "fused" : "js";
@@ -2194,9 +2257,9 @@ var Scene = (_class7 = class _Scene {
    * Why the transform accelerator did or did not run on the most recent frame.
    * Written by the render walk and `_syncWasmStore`.
    */
-  __init110() {this._transformReason = "not-installed"}
+  __init113() {this._transformReason = "not-installed"}
   /** Why the batched-driver accelerator did or did not run. */
-  __init111() {this._animReason = "not-installed"}
+  __init114() {this._animReason = "not-installed"}
   /**
    * Why the hit-test accelerator did or did not serve the last pointer query.
    * The grid is built lazily on demand, not every frame, so this describes the
@@ -2204,11 +2267,11 @@ var Scene = (_class7 = class _Scene {
    * before a backend exists; `_ensureHitGrid` moves it to `'not-applicable'`
    * once one is installed but nothing has queried yet.
    */
-  __init112() {this._hitReason = "not-installed"}
+  __init115() {this._hitReason = "not-installed"}
   /** Why the particle accelerator did or did not run. */
-  __init113() {this._particleReason = "not-applicable"}
+  __init116() {this._particleReason = "not-applicable"}
   /** Which particle implementation actually simulated the most recent frame. */
-  __init114() {this._particlePath = "none"}
+  __init117() {this._particlePath = "none"}
   /**
    * Per-frame status of every invisible accelerator: whether each is installed,
    * whether it actually ran on the most recent frame, and why.
@@ -2345,7 +2408,7 @@ var Scene = (_class7 = class _Scene {
         const idx = cell[k];
         if (x < minx[idx] || x > maxx[idx] || y < miny[idx] || y > maxy[idx]) continue;
         const entity = this._hitSlotEntity[idx];
-        if (_optionalChain([entity, 'optionalAccess', _36 => _36.isPointInside, 'call', _37 => _37(x, y)]) && this.isHitEligible(entity, x, y)) {
+        if (_optionalChain([entity, 'optionalAccess', _39 => _39.isPointInside, 'call', _40 => _40(x, y)]) && this.isHitEligible(entity, x, y)) {
           bestIndex = idx;
           bestEntity = entity;
           break;
@@ -2368,25 +2431,25 @@ var Scene = (_class7 = class _Scene {
   // EasingFn (which cannot cross into WASM) all fall through to it — WASM can
   // only ever change *how* a driver is advanced, never *what* value it lands
   // on.
-  __init115() {this._animWasm = null}
+  __init118() {this._animWasm = null}
   // Entities with at least one active driver, added by Entity._spawnDriver.
   // Self-pruning: _tickBatchedDrivers drops an entry the first time it visits
   // an entity whose drivers have since all completed or been removed. This is
   // what lets the batch pass find its candidates in O(active drivers), not
   // O(tree size) — the exact mistake G3's first integrated benchmark made.
-  __init116() {this._activeDriverEntities = /* @__PURE__ */ new Set()}
+  __init119() {this._activeDriverEntities = /* @__PURE__ */ new Set()}
   // Reused across frames instead of allocating a fresh array + N {entity,prop,
   // driver} objects every call — the integrated benchmark
   // (benchmarks/anim-wasm-scene) found that allocation churn was the
   // dominant integrated cost, not the wasm kernel itself. Parallel arrays,
   // truncated to the live count after each use so a stale tail slot never
   // pins a no-longer-active entity/driver in memory.
-  __init117() {this._springEntities = []}
-  __init118() {this._springProps = []}
-  __init119() {this._springDrivers = []}
-  __init120() {this._tweenEntities = []}
-  __init121() {this._tweenProps = []}
-  __init122() {this._tweenDrivers = []}
+  __init120() {this._springEntities = []}
+  __init121() {this._springProps = []}
+  __init122() {this._springDrivers = []}
+  __init123() {this._tweenEntities = []}
+  __init124() {this._tweenProps = []}
+  __init125() {this._tweenDrivers = []}
   /**
    * Minimum number of batchable (spring, or named-easing tween) active drivers
    * before a frame engages the WASM batch path at all; below it, every driver
@@ -2458,7 +2521,7 @@ var Scene = (_class7 = class _Scene {
    * Setting {@link animDriverGateCount} overwrites all three, so existing code
    * that tuned the single knob keeps working unchanged.
    */
-  __init123() {this._animBatchedLastFrame = false}
+  __init126() {this._animBatchedLastFrame = false}
   /**
    * Whether the WASM batch path actually ran on the most recent frame.
    *
@@ -2470,7 +2533,7 @@ var Scene = (_class7 = class _Scene {
   get animBatchedLastFrame() {
     return this._animBatchedLastFrame;
   }
-  __init124() {this.animGate = {
+  __init127() {this.animGate = {
     spring: 128,
     tween: 256,
     mixed: 128
@@ -2508,7 +2571,7 @@ var Scene = (_class7 = class _Scene {
   // (benchmarks/particle-wasm). f32 (matches the WGSL shader), bit-identical to
   // a JS f32 reference oracle; updateCPU (f64) stays the permanent fallback when
   // no backend is installed or a scene runs on WebGPU.
-  __init125() {this._particleWasm = null}
+  __init128() {this._particleWasm = null}
   /** Which backend runs the CPU particle simulation. Reflects only whether a
    *  backend is installed (the WebGPU compute path, when active, is used first
    *  regardless). */
@@ -2785,24 +2848,24 @@ var Scene = (_class7 = class _Scene {
    * sync, so retaining the order prevents a newly opened overlay from spending
    * its first frame below previously projected controls.
    */
-  __init126() {this.a11yRenderOrders = /* @__PURE__ */ new Map()}
+  __init129() {this.a11yRenderOrders = /* @__PURE__ */ new Map()}
   // Optional WebGL point-cloud layer (see SceneOptions.pointBackend).
-  __init127() {this.pointRenderer = null}
-  __init128() {this.glCanvas = null}
-  __init129() {this.glContextLostHandler = null}
-  __init130() {this.glContextRestoredHandler = null}
+  __init130() {this.pointRenderer = null}
+  __init131() {this.glCanvas = null}
+  __init132() {this.glContextLostHandler = null}
+  __init133() {this.glContextRestoredHandler = null}
   
   
   
-  __init131() {this.disableWindowResize = false}
+  __init134() {this.disableWindowResize = false}
   /** See {@link SceneOptions.maxDPR}. `undefined` = uncapped (real DPR). */
   
   // WebGPU properties
-  __init132() {this.destroyed = false}
-  __init133() {this.device = null}
-  __init134() {this.deviceLost = false}
-  __init135() {this.particleBackend = "auto"}
-  __init136() {this._webgpuDisabled = false}
+  __init135() {this.destroyed = false}
+  __init136() {this.device = null}
+  __init137() {this.deviceLost = false}
+  __init138() {this.particleBackend = "auto"}
+  __init139() {this._webgpuDisabled = false}
   get webgpuDisabled() {
     return this._webgpuDisabled || this.particleBackend === "cpu";
   }
@@ -2816,7 +2879,7 @@ var Scene = (_class7 = class _Scene {
    * active.
    */
   get webglDrawStats() {
-    return _nullishCoalesce(_optionalChain([this, 'access', _38 => _38.pointRenderer, 'optionalAccess', _39 => _39.stats, 'optionalCall', _40 => _40()]), () => ( null));
+    return _nullishCoalesce(_optionalChain([this, 'access', _41 => _41.pointRenderer, 'optionalAccess', _42 => _42.stats, 'optionalCall', _43 => _43()]), () => ( null));
   }
   /**
    * Whether a WebGPU device is currently live for particle compute.
@@ -2830,22 +2893,22 @@ var Scene = (_class7 = class _Scene {
   set webgpuDisabled(value) {
     this._webgpuDisabled = value;
   }
-  __init137() {this.recoveryTimerId = null}
-  __init138() {this.manager = null}
-  __init139() {this.initializingWebGPU = false}
-  __init140() {this.gpuCanvas = null}
-  __init141() {this.gpuContext = null}
+  __init140() {this.recoveryTimerId = null}
+  __init141() {this.manager = null}
+  __init142() {this.initializingWebGPU = false}
+  __init143() {this.gpuCanvas = null}
+  __init144() {this.gpuContext = null}
   /** True while the GPU canvas holds a presented particle frame (needs clearing when they leave). */
-  __init142() {this.gpuHasContent = false}
-  __init143() {this.mouseX = -9999}
-  __init144() {this.mouseY = -9999}
-  __init145() {this.pointerMoveListener = null}
-  __init146() {this.pointerLeaveListener = null}
+  __init145() {this.gpuHasContent = false}
+  __init146() {this.mouseX = -9999}
+  __init147() {this.mouseY = -9999}
+  __init148() {this.pointerMoveListener = null}
+  __init149() {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. */
-  __init147() {this.pointerEventTarget = null}
-  __init148() {this.hasWarnedZeroSize = false}
-  __init149() {this.fontLoadHandler = null}
+  __init150() {this.pointerEventTarget = null}
+  __init151() {this.hasWarnedZeroSize = false}
+  __init152() {this.fontLoadHandler = null}
   // ── Dev-mode warning infrastructure ──────────────────────────────
   //
   // Enable with `Scene.devMode = true` or by setting `globalThis.__DEV__`.
@@ -2874,12 +2937,12 @@ var Scene = (_class7 = class _Scene {
   static _devModeDetected() {
     if (_Scene._devMode) return true;
     const gp = typeof globalThis !== "undefined" ? globalThis : void 0;
-    if (_optionalChain([gp, 'optionalAccess', _41 => _41.__DEV__])) return true;
-    if (_optionalChain([gp, 'optionalAccess', _42 => _42.process, 'optionalAccess', _43 => _43.env, 'optionalAccess', _44 => _44.NODE_ENV]) === "development") return true;
+    if (_optionalChain([gp, 'optionalAccess', _44 => _44.__DEV__])) return true;
+    if (_optionalChain([gp, 'optionalAccess', _45 => _45.process, 'optionalAccess', _46 => _46.env, 'optionalAccess', _47 => _47.NODE_ENV]) === "development") return true;
     return false;
   }
   
-  __init150() {this._devFrameCount = 0}
+  __init153() {this._devFrameCount = 0}
   _devWarn(message) {
     if (!this._devActive) return;
     console.warn(`[vectojs/dev] ${message}`);
@@ -2937,12 +3000,14 @@ var Scene = (_class7 = class _Scene {
     let checked = 0;
     const walkProjections = (node) => {
       if (checked > 10) return;
-      const proj = _optionalChain([node, 'access', _45 => _45.getContentProjection, 'optionalCall', _46 => _46()]);
-      if (_optionalChain([proj, 'optionalAccess', _47 => _47.text]) && proj.selectable !== false) {
-        const el = _optionalChain([this, 'access', _48 => _48.contentElements, 'optionalAccess', _49 => _49.get, 'call', _50 => _50(node.id)]);
+      const proj = _optionalChain([node, 'access', _48 => _48.getContentProjection, 'optionalCall', _49 => _49()]);
+      if (_optionalChain([proj, 'optionalAccess', _50 => _50.text]) && proj.selectable !== false) {
+        const el = _optionalChain([this, 'access', _51 => _51.contentElements, 'optionalAccess', _52 => _52.get, 'call', _53 => _53(node.id)]);
         if (el) {
           const projectedText = el.textContent || "";
-          if (projectedText !== "" && projectedText !== proj.text) {
+          const windowed = el.dataset.vectoProjectionWindow !== void 0;
+          const mismatched = windowed ? !proj.text.includes(projectedText) : projectedText !== proj.text;
+          if (projectedText !== "" && mismatched) {
             this._devWarn(
               `Content projection mismatch for entity "${node.id}": projection says "${proj.text.slice(0, 60)}" but DOM shows "${projectedText.slice(0, 60)}". Ensure getContentProjection() output matches what drawSelf renders.`
             );
@@ -2954,14 +3019,14 @@ var Scene = (_class7 = class _Scene {
     };
     walkProjections(this.root);
   }
-  constructor(canvas, options = {}) {;_class7.prototype.__init27.call(this);_class7.prototype.__init28.call(this);_class7.prototype.__init29.call(this);_class7.prototype.__init30.call(this);_class7.prototype.__init31.call(this);_class7.prototype.__init32.call(this);_class7.prototype.__init33.call(this);_class7.prototype.__init34.call(this);_class7.prototype.__init35.call(this);_class7.prototype.__init36.call(this);_class7.prototype.__init37.call(this);_class7.prototype.__init38.call(this);_class7.prototype.__init39.call(this);_class7.prototype.__init40.call(this);_class7.prototype.__init41.call(this);_class7.prototype.__init42.call(this);_class7.prototype.__init43.call(this);_class7.prototype.__init44.call(this);_class7.prototype.__init45.call(this);_class7.prototype.__init46.call(this);_class7.prototype.__init47.call(this);_class7.prototype.__init48.call(this);_class7.prototype.__init49.call(this);_class7.prototype.__init50.call(this);_class7.prototype.__init51.call(this);_class7.prototype.__init52.call(this);_class7.prototype.__init53.call(this);_class7.prototype.__init54.call(this);_class7.prototype.__init55.call(this);_class7.prototype.__init56.call(this);_class7.prototype.__init57.call(this);_class7.prototype.__init58.call(this);_class7.prototype.__init59.call(this);_class7.prototype.__init60.call(this);_class7.prototype.__init61.call(this);_class7.prototype.__init62.call(this);_class7.prototype.__init63.call(this);_class7.prototype.__init64.call(this);_class7.prototype.__init65.call(this);_class7.prototype.__init66.call(this);_class7.prototype.__init67.call(this);_class7.prototype.__init68.call(this);_class7.prototype.__init69.call(this);_class7.prototype.__init70.call(this);_class7.prototype.__init71.call(this);_class7.prototype.__init72.call(this);_class7.prototype.__init73.call(this);_class7.prototype.__init74.call(this);_class7.prototype.__init75.call(this);_class7.prototype.__init76.call(this);_class7.prototype.__init77.call(this);_class7.prototype.__init78.call(this);_class7.prototype.__init79.call(this);_class7.prototype.__init80.call(this);_class7.prototype.__init81.call(this);_class7.prototype.__init82.call(this);_class7.prototype.__init83.call(this);_class7.prototype.__init84.call(this);_class7.prototype.__init85.call(this);_class7.prototype.__init86.call(this);_class7.prototype.__init87.call(this);_class7.prototype.__init88.call(this);_class7.prototype.__init89.call(this);_class7.prototype.__init90.call(this);_class7.prototype.__init91.call(this);_class7.prototype.__init92.call(this);_class7.prototype.__init93.call(this);_class7.prototype.__init94.call(this);_class7.prototype.__init95.call(this);_class7.prototype.__init96.call(this);_class7.prototype.__init97.call(this);_class7.prototype.__init98.call(this);_class7.prototype.__init99.call(this);_class7.prototype.__init100.call(this);_class7.prototype.__init101.call(this);_class7.prototype.__init102.call(this);_class7.prototype.__init103.call(this);_class7.prototype.__init104.call(this);_class7.prototype.__init105.call(this);_class7.prototype.__init106.call(this);_class7.prototype.__init107.call(this);_class7.prototype.__init108.call(this);_class7.prototype.__init109.call(this);_class7.prototype.__init110.call(this);_class7.prototype.__init111.call(this);_class7.prototype.__init112.call(this);_class7.prototype.__init113.call(this);_class7.prototype.__init114.call(this);_class7.prototype.__init115.call(this);_class7.prototype.__init116.call(this);_class7.prototype.__init117.call(this);_class7.prototype.__init118.call(this);_class7.prototype.__init119.call(this);_class7.prototype.__init120.call(this);_class7.prototype.__init121.call(this);_class7.prototype.__init122.call(this);_class7.prototype.__init123.call(this);_class7.prototype.__init124.call(this);_class7.prototype.__init125.call(this);_class7.prototype.__init126.call(this);_class7.prototype.__init127.call(this);_class7.prototype.__init128.call(this);_class7.prototype.__init129.call(this);_class7.prototype.__init130.call(this);_class7.prototype.__init131.call(this);_class7.prototype.__init132.call(this);_class7.prototype.__init133.call(this);_class7.prototype.__init134.call(this);_class7.prototype.__init135.call(this);_class7.prototype.__init136.call(this);_class7.prototype.__init137.call(this);_class7.prototype.__init138.call(this);_class7.prototype.__init139.call(this);_class7.prototype.__init140.call(this);_class7.prototype.__init141.call(this);_class7.prototype.__init142.call(this);_class7.prototype.__init143.call(this);_class7.prototype.__init144.call(this);_class7.prototype.__init145.call(this);_class7.prototype.__init146.call(this);_class7.prototype.__init147.call(this);_class7.prototype.__init148.call(this);_class7.prototype.__init149.call(this);_class7.prototype.__init150.call(this);
+  constructor(canvas, options = {}) {;_class7.prototype.__init27.call(this);_class7.prototype.__init28.call(this);_class7.prototype.__init29.call(this);_class7.prototype.__init30.call(this);_class7.prototype.__init31.call(this);_class7.prototype.__init32.call(this);_class7.prototype.__init33.call(this);_class7.prototype.__init34.call(this);_class7.prototype.__init35.call(this);_class7.prototype.__init36.call(this);_class7.prototype.__init37.call(this);_class7.prototype.__init38.call(this);_class7.prototype.__init39.call(this);_class7.prototype.__init40.call(this);_class7.prototype.__init41.call(this);_class7.prototype.__init42.call(this);_class7.prototype.__init43.call(this);_class7.prototype.__init44.call(this);_class7.prototype.__init45.call(this);_class7.prototype.__init46.call(this);_class7.prototype.__init47.call(this);_class7.prototype.__init48.call(this);_class7.prototype.__init49.call(this);_class7.prototype.__init50.call(this);_class7.prototype.__init51.call(this);_class7.prototype.__init52.call(this);_class7.prototype.__init53.call(this);_class7.prototype.__init54.call(this);_class7.prototype.__init55.call(this);_class7.prototype.__init56.call(this);_class7.prototype.__init57.call(this);_class7.prototype.__init58.call(this);_class7.prototype.__init59.call(this);_class7.prototype.__init60.call(this);_class7.prototype.__init61.call(this);_class7.prototype.__init62.call(this);_class7.prototype.__init63.call(this);_class7.prototype.__init64.call(this);_class7.prototype.__init65.call(this);_class7.prototype.__init66.call(this);_class7.prototype.__init67.call(this);_class7.prototype.__init68.call(this);_class7.prototype.__init69.call(this);_class7.prototype.__init70.call(this);_class7.prototype.__init71.call(this);_class7.prototype.__init72.call(this);_class7.prototype.__init73.call(this);_class7.prototype.__init74.call(this);_class7.prototype.__init75.call(this);_class7.prototype.__init76.call(this);_class7.prototype.__init77.call(this);_class7.prototype.__init78.call(this);_class7.prototype.__init79.call(this);_class7.prototype.__init80.call(this);_class7.prototype.__init81.call(this);_class7.prototype.__init82.call(this);_class7.prototype.__init83.call(this);_class7.prototype.__init84.call(this);_class7.prototype.__init85.call(this);_class7.prototype.__init86.call(this);_class7.prototype.__init87.call(this);_class7.prototype.__init88.call(this);_class7.prototype.__init89.call(this);_class7.prototype.__init90.call(this);_class7.prototype.__init91.call(this);_class7.prototype.__init92.call(this);_class7.prototype.__init93.call(this);_class7.prototype.__init94.call(this);_class7.prototype.__init95.call(this);_class7.prototype.__init96.call(this);_class7.prototype.__init97.call(this);_class7.prototype.__init98.call(this);_class7.prototype.__init99.call(this);_class7.prototype.__init100.call(this);_class7.prototype.__init101.call(this);_class7.prototype.__init102.call(this);_class7.prototype.__init103.call(this);_class7.prototype.__init104.call(this);_class7.prototype.__init105.call(this);_class7.prototype.__init106.call(this);_class7.prototype.__init107.call(this);_class7.prototype.__init108.call(this);_class7.prototype.__init109.call(this);_class7.prototype.__init110.call(this);_class7.prototype.__init111.call(this);_class7.prototype.__init112.call(this);_class7.prototype.__init113.call(this);_class7.prototype.__init114.call(this);_class7.prototype.__init115.call(this);_class7.prototype.__init116.call(this);_class7.prototype.__init117.call(this);_class7.prototype.__init118.call(this);_class7.prototype.__init119.call(this);_class7.prototype.__init120.call(this);_class7.prototype.__init121.call(this);_class7.prototype.__init122.call(this);_class7.prototype.__init123.call(this);_class7.prototype.__init124.call(this);_class7.prototype.__init125.call(this);_class7.prototype.__init126.call(this);_class7.prototype.__init127.call(this);_class7.prototype.__init128.call(this);_class7.prototype.__init129.call(this);_class7.prototype.__init130.call(this);_class7.prototype.__init131.call(this);_class7.prototype.__init132.call(this);_class7.prototype.__init133.call(this);_class7.prototype.__init134.call(this);_class7.prototype.__init135.call(this);_class7.prototype.__init136.call(this);_class7.prototype.__init137.call(this);_class7.prototype.__init138.call(this);_class7.prototype.__init139.call(this);_class7.prototype.__init140.call(this);_class7.prototype.__init141.call(this);_class7.prototype.__init142.call(this);_class7.prototype.__init143.call(this);_class7.prototype.__init144.call(this);_class7.prototype.__init145.call(this);_class7.prototype.__init146.call(this);_class7.prototype.__init147.call(this);_class7.prototype.__init148.call(this);_class7.prototype.__init149.call(this);_class7.prototype.__init150.call(this);_class7.prototype.__init151.call(this);_class7.prototype.__init152.call(this);_class7.prototype.__init153.call(this);
     this.canvas = canvas;
     this.debugA11y = _nullishCoalesce(options.debugA11y, () => ( false));
     this.disableWindowResize = _nullishCoalesce(options.disableWindowResize, () => ( false));
     this.maxDPR = options.maxDPR;
     if (this.disableWindowResize) {
-      const styleWidth = parseInlinePx(_optionalChain([canvas, 'access', _51 => _51.style, 'optionalAccess', _52 => _52.width]));
-      const styleHeight = parseInlinePx(_optionalChain([canvas, 'access', _53 => _53.style, 'optionalAccess', _54 => _54.height]));
+      const styleWidth = parseInlinePx(_optionalChain([canvas, 'access', _54 => _54.style, 'optionalAccess', _55 => _55.width]));
+      const styleHeight = parseInlinePx(_optionalChain([canvas, 'access', _56 => _56.style, 'optionalAccess', _57 => _57.height]));
       this.width = _nullishCoalesce(styleWidth, () => ( (canvas.width || canvas.clientWidth || 0)));
       this.height = _nullishCoalesce(styleHeight, () => ( (canvas.height || canvas.clientHeight || 0)));
     } else {
@@ -2969,7 +3034,7 @@ var Scene = (_class7 = class _Scene {
       this.height = typeof window !== "undefined" ? window.innerHeight : canvas.clientHeight || canvas.height || 600;
     }
     const globalProcess = typeof globalThis !== "undefined" ? globalThis.process : void 0;
-    const isTest = globalProcess && (_optionalChain([globalProcess, 'access', _55 => _55.env, 'optionalAccess', _56 => _56.NODE_ENV]) === "test" || _optionalChain([globalProcess, 'access', _57 => _57.env, 'optionalAccess', _58 => _58.VITEST]) === "true");
+    const isTest = globalProcess && (_optionalChain([globalProcess, 'access', _58 => _58.env, 'optionalAccess', _59 => _59.NODE_ENV]) === "test" || _optionalChain([globalProcess, 'access', _60 => _60.env, 'optionalAccess', _61 => _61.VITEST]) === "true");
     this.maxFPS = _nullishCoalesce(options.maxFPS, () => ( (isTest ? 0 : 60)));
     this.respectReducedMotion = _nullishCoalesce(options.respectReducedMotion, () => ( true));
     this.autoThrottle = _nullishCoalesce(options.autoThrottle, () => ( true));
@@ -2978,6 +3043,7 @@ var Scene = (_class7 = class _Scene {
     this.a11ySyncInterval = _nullishCoalesce(options.a11ySyncInterval, () => ( 0));
     this.contentProjectionEnabled = _nullishCoalesce(options.contentProjection, () => ( true));
     this.contentProjectionMargin = options.contentProjectionMargin;
+    this.contentSemanticMargin = options.contentSemanticMargin;
     this.readingDirection = _nullishCoalesce(options.readingDirection, () => ( "ltr"));
     this.renderMode = _nullishCoalesce(options.renderMode, () => ( "always"));
     this._devActive = _Scene._devModeDetected();
@@ -2987,9 +3053,9 @@ var Scene = (_class7 = class _Scene {
     if (typeof window !== "undefined" && typeof window.matchMedia === "function") {
       this.forcedColorsQuery = window.matchMedia("(forced-colors: active)");
       this.forcedColorsChangeHandler = () => this.markDirty();
-      _optionalChain([this, 'access', _59 => _59.forcedColorsQuery, 'access', _60 => _60.addEventListener, 'optionalCall', _61 => _61("change", this.forcedColorsChangeHandler)]);
+      _optionalChain([this, 'access', _62 => _62.forcedColorsQuery, 'access', _63 => _63.addEventListener, 'optionalCall', _64 => _64("change", this.forcedColorsChangeHandler)]);
     }
-    this.root = new class RootEntity extends _chunkZ3HFY75Rjs.Entity {
+    this.root = new class RootEntity extends _chunkTRT2TRCWjs.Entity {
       isPointInside() {
         return false;
       }
@@ -2998,7 +3064,7 @@ var Scene = (_class7 = class _Scene {
       }
     }("root");
     this.root._scene = this;
-    this.overlayRoot = new class OverlayRoot extends _chunkZ3HFY75Rjs.Entity {
+    this.overlayRoot = new class OverlayRoot extends _chunkTRT2TRCWjs.Entity {
       isPointInside() {
         return false;
       }
@@ -3015,9 +3081,9 @@ var Scene = (_class7 = class _Scene {
         this.maxDPR
       );
     }
-    _optionalChain([this, 'access', _62 => _62.renderer, 'access', _63 => _63.onContextRestored, 'optionalCall', _64 => _64(() => {
+    _optionalChain([this, 'access', _65 => _65.renderer, 'access', _66 => _66.onContextRestored, 'optionalCall', _67 => _67(() => {
       this.markDirty();
-      if (_optionalChain([this, 'access', _65 => _65.renderer, 'access', _66 => _66.isContextLost, 'optionalCall', _67 => _67()]) !== true) this.render(this.renderer);
+      if (_optionalChain([this, 'access', _68 => _68.renderer, 'access', _69 => _69.isContextLost, 'optionalCall', _70 => _70()]) !== true) this.render(this.renderer);
     })]);
     if (typeof document !== "undefined") {
       this.a11yRoot = document.createElement("div");
@@ -3187,7 +3253,7 @@ var Scene = (_class7 = class _Scene {
   watchDevicePixelRatio() {
     if (typeof window === "undefined" || typeof window.matchMedia !== "function") return;
     if (this.dprMediaQuery && this.dprChangeHandler) {
-      _optionalChain([this, 'access', _68 => _68.dprMediaQuery, 'access', _69 => _69.removeEventListener, 'optionalCall', _70 => _70("change", this.dprChangeHandler)]);
+      _optionalChain([this, 'access', _71 => _71.dprMediaQuery, 'access', _72 => _72.removeEventListener, 'optionalCall', _73 => _73("change", this.dprChangeHandler)]);
     }
     const dpr = window.devicePixelRatio || 1;
     const query = window.matchMedia(`(resolution: ${dpr}dppx)`);
@@ -3195,7 +3261,7 @@ var Scene = (_class7 = class _Scene {
       this.resize(this.width, this.height);
       this.watchDevicePixelRatio();
     };
-    _optionalChain([query, 'access', _71 => _71.addEventListener, 'optionalCall', _72 => _72("change", handler)]);
+    _optionalChain([query, 'access', _74 => _74.addEventListener, 'optionalCall', _75 => _75("change", handler)]);
     this.dprMediaQuery = query;
     this.dprChangeHandler = handler;
   }
@@ -3215,7 +3281,7 @@ var Scene = (_class7 = class _Scene {
     if (typeof gl.addEventListener !== "function") return;
     this.glContextLostHandler = (e) => {
       e.preventDefault();
-      _optionalChain([this, 'access', _73 => _73.pointRenderer, 'optionalAccess', _74 => _74.destroy, 'call', _75 => _75()]);
+      _optionalChain([this, 'access', _76 => _76.pointRenderer, 'optionalAccess', _77 => _77.destroy, 'call', _78 => _78()]);
       this.pointRenderer = null;
     };
     this.glContextRestoredHandler = () => {
@@ -3245,26 +3311,26 @@ var Scene = (_class7 = class _Scene {
    * to the live DOM selection.
    */
   contentGridSelectionLine(el) {
-    const candidates = [_optionalChain([this, 'access', _76 => _76.contentSelectionAnchor, 'optionalAccess', _77 => _77.node])];
+    const candidates = [_optionalChain([this, 'access', _79 => _79.contentSelectionAnchor, 'optionalAccess', _80 => _80.node])];
     if (typeof window !== "undefined" && typeof window.getSelection === "function") {
       const selection = window.getSelection();
-      candidates.push(_optionalChain([selection, 'optionalAccess', _78 => _78.anchorNode]), _optionalChain([selection, 'optionalAccess', _79 => _79.focusNode]));
+      candidates.push(_optionalChain([selection, 'optionalAccess', _81 => _81.anchorNode]), _optionalChain([selection, 'optionalAccess', _82 => _82.focusNode]));
     }
     for (const candidate of candidates) {
       if (!candidate || !el.contains(candidate)) continue;
       let cursor = candidate;
       while (cursor && cursor.parentNode !== el) cursor = cursor.parentNode;
-      const lineIndex = _optionalChain([cursor, 'optionalAccess', _80 => _80.dataset, 'optionalAccess', _81 => _81.vectoGridLine]);
+      const lineIndex = _optionalChain([cursor, 'optionalAccess', _83 => _83.dataset, 'optionalAccess', _84 => _84.vectoGridLine]);
       if (lineIndex !== void 0) return Number(lineIndex);
     }
     return null;
   }
   releaseContentSelectionForRebuild(el) {
     const selection = typeof window !== "undefined" && typeof window.getSelection === "function" ? window.getSelection() : null;
-    const ownsSelection = this.contentSelectionAnchor && el.contains(this.contentSelectionAnchor.node) || (_optionalChain([selection, 'optionalAccess', _82 => _82.anchorNode]) ? el.contains(selection.anchorNode) : false) || (_optionalChain([selection, 'optionalAccess', _83 => _83.focusNode]) ? el.contains(selection.focusNode) : false);
+    const ownsSelection = this.contentSelectionAnchor && el.contains(this.contentSelectionAnchor.node) || (_optionalChain([selection, 'optionalAccess', _85 => _85.anchorNode]) ? el.contains(selection.anchorNode) : false) || (_optionalChain([selection, 'optionalAccess', _86 => _86.focusNode]) ? el.contains(selection.focusNode) : false);
     if (!ownsSelection) return;
     this.endContentSelectionDrag();
-    _optionalChain([selection, 'optionalAccess', _84 => _84.removeAllRanges, 'call', _85 => _85()]);
+    _optionalChain([selection, 'optionalAccess', _87 => _87.removeAllRanges, 'call', _88 => _88()]);
   }
   /**
    * Rebuild a content-projection element's DOM (`rebuild`) while preserving a
@@ -3323,7 +3389,7 @@ var Scene = (_class7 = class _Scene {
   }
   /** Convert browser viewport coordinates into this Scene's logical coordinates. */
   clientToScene(clientX, clientY) {
-    const rect = _optionalChain([this, 'access', _86 => _86.canvas, 'access', _87 => _87.getBoundingClientRect, 'optionalCall', _88 => _88()]);
+    const rect = _optionalChain([this, 'access', _89 => _89.canvas, 'access', _90 => _90.getBoundingClientRect, 'optionalCall', _91 => _91()]);
     if (!rect) return { x: clientX, y: clientY };
     const cssWidth = rect.width || this.canvas.clientWidth || this.width;
     const cssHeight = rect.height || this.canvas.clientHeight || this.height;
@@ -3361,7 +3427,7 @@ var Scene = (_class7 = class _Scene {
       cancelAnimationFrame(calibrationFrame);
     }
     this.contentGridCalibrationFrames.delete(entityId);
-    _optionalChain([this, 'access', _89 => _89.contentGridCalibrationProbes, 'access', _90 => _90.get, 'call', _91 => _91(entityId), 'optionalAccess', _92 => _92.remove, 'call', _93 => _93()]);
+    _optionalChain([this, 'access', _92 => _92.contentGridCalibrationProbes, 'access', _93 => _93.get, 'call', _94 => _94(entityId), 'optionalAccess', _95 => _95.remove, 'call', _96 => _96()]);
     this.contentGridCalibrationProbes.delete(entityId);
     delete el.dataset.vectoGridCalibrationPending;
     delete el.dataset.vectoGridCalibration;
@@ -3400,6 +3466,7 @@ var Scene = (_class7 = class _Scene {
       this.clearContentGridState(node.id, contentEl);
       contentEl.remove();
       this.contentElements.delete(node.id);
+      this.contentSyncState.delete(node.id);
       this.a11yNeedsReorder = true;
     }
     const el = this.a11yElements.get(node.id);
@@ -3413,7 +3480,7 @@ var Scene = (_class7 = class _Scene {
       }
       if (this.hoveredA11yElements.has(el)) {
         this.hoveredA11yElements.delete(el);
-        node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("pointerleave", node, void 0, false));
+        node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("pointerleave", node, void 0, false));
       }
       this.preserveFocusOnRemoval(el);
       el.remove();
@@ -3515,12 +3582,12 @@ var Scene = (_class7 = class _Scene {
       this.canvasResizeObserver = null;
     }
     if (this.dprMediaQuery && this.dprChangeHandler) {
-      _optionalChain([this, 'access', _94 => _94.dprMediaQuery, 'access', _95 => _95.removeEventListener, 'optionalCall', _96 => _96("change", this.dprChangeHandler)]);
+      _optionalChain([this, 'access', _97 => _97.dprMediaQuery, 'access', _98 => _98.removeEventListener, 'optionalCall', _99 => _99("change", this.dprChangeHandler)]);
       this.dprMediaQuery = null;
       this.dprChangeHandler = null;
     }
     if (this.forcedColorsQuery && this.forcedColorsChangeHandler) {
-      _optionalChain([this, 'access', _97 => _97.forcedColorsQuery, 'access', _98 => _98.removeEventListener, 'optionalCall', _99 => _99("change", this.forcedColorsChangeHandler)]);
+      _optionalChain([this, 'access', _100 => _100.forcedColorsQuery, 'access', _101 => _101.removeEventListener, 'optionalCall', _102 => _102("change", this.forcedColorsChangeHandler)]);
       this.forcedColorsQuery = null;
       this.forcedColorsChangeHandler = null;
     }
@@ -3538,12 +3605,13 @@ var Scene = (_class7 = class _Scene {
       }
       this.pointerEventTarget = null;
     }
-    _optionalChain([this, 'access', _100 => _100.a11yRoot, 'optionalAccess', _101 => _101.remove, 'call', _102 => _102()]);
+    _optionalChain([this, 'access', _103 => _103.a11yRoot, 'optionalAccess', _104 => _104.remove, 'call', _105 => _105()]);
     this.focusSentinel = null;
-    _optionalChain([this, 'access', _103 => _103.portalRoot, 'optionalAccess', _104 => _104.remove, 'call', _105 => _105()]);
+    _optionalChain([this, 'access', _106 => _106.portalRoot, 'optionalAccess', _107 => _107.remove, 'call', _108 => _108()]);
     this.a11yElements.clear();
     for (const el of this.contentElements.values()) el.remove();
     this.contentElements.clear();
+    this.contentSyncState.clear();
     if (typeof cancelAnimationFrame === "function") {
       for (const frame of this.contentGridCalibrationFrames.values()) {
         cancelAnimationFrame(frame);
@@ -3563,10 +3631,10 @@ var Scene = (_class7 = class _Scene {
     }
     this.glContextLostHandler = null;
     this.glContextRestoredHandler = null;
-    _optionalChain([this, 'access', _106 => _106.pointRenderer, 'optionalAccess', _107 => _107.destroy, 'call', _108 => _108()]);
-    _optionalChain([this, 'access', _109 => _109.renderer, 'access', _110 => _110.dispose, 'optionalCall', _111 => _111()]);
-    _optionalChain([this, 'access', _112 => _112.glCanvas, 'optionalAccess', _113 => _113.remove, 'call', _114 => _114()]);
-    _optionalChain([this, 'access', _115 => _115.gpuCanvas, 'optionalAccess', _116 => _116.remove, 'call', _117 => _117()]);
+    _optionalChain([this, 'access', _109 => _109.pointRenderer, 'optionalAccess', _110 => _110.destroy, 'call', _111 => _111()]);
+    _optionalChain([this, 'access', _112 => _112.renderer, 'access', _113 => _113.dispose, 'optionalCall', _114 => _114()]);
+    _optionalChain([this, 'access', _115 => _115.glCanvas, 'optionalAccess', _116 => _116.remove, 'call', _117 => _117()]);
+    _optionalChain([this, 'access', _118 => _118.gpuCanvas, 'optionalAccess', _119 => _119.remove, 'call', _120 => _120()]);
     this.gpuCanvas = null;
     this.gpuContext = null;
     if (this.recoveryTimerId) {
@@ -3578,7 +3646,7 @@ var Scene = (_class7 = class _Scene {
       this.manager = null;
     }
     if (this.device) {
-      _optionalChain([this, 'access', _118 => _118.device, 'access', _119 => _119.destroy, 'optionalCall', _120 => _120()]);
+      _optionalChain([this, 'access', _121 => _121.device, 'access', _122 => _122.destroy, 'optionalCall', _123 => _123()]);
       this.device = null;
     }
   }
@@ -3886,7 +3954,92 @@ var Scene = (_class7 = class _Scene {
    * predicate, which is only tractable while it has one home.
    */
   shouldProjectA11y(node) {
-    return node.interactive && (node.width > 0 || node.a11yFullViewport);
+    if (!node.interactive) return false;
+    if (!(node.width > 0 || node.a11yFullViewport)) return false;
+    switch (node.a11yProjection) {
+      case "never":
+        return false;
+      case "onDemand":
+        return this.a11yEngaged(node);
+      default:
+        return true;
+    }
+  }
+  /**
+   * Whether an `a11yProjection: 'onDemand'` entity is currently engaged enough to
+   * deserve a shadow node.
+   *
+   * Deliberately **not** hover alone. A keyboard or assistive-technology user
+   * generates no pointer events, so a hover-only trigger would withhold the
+   * semantic node from precisely the users it exists for. Three signals, any of
+   * which counts:
+   *
+   * - **Focus.** Covers keyboard traversal and AT-driven focus. Checked against
+   *   the live element so a node keeps its own focus rather than being pruned out
+   *   from under the user mid-interaction.
+   * - **Pointer target.** The entity under the pointer, so a mouse user gets the
+   *   same node a hover-gated design would have given them.
+   * - **Explicit request.** {@link Scene.requestA11yProjection}, for anything the
+   *   app knows is significant — the selected item, a search hit, a
+   *   just-announced element. This is the escape hatch that keeps the mode usable
+   *   when neither focus nor pointer applies.
+   *
+   * The entity stays hit-testable on canvas regardless, so a click always reaches
+   * it and promotes it on the next sync.
+   */
+  a11yEngaged(node) {
+    if (this.a11yProjectionRequests.has(node.id)) return true;
+    if (this.mouseX > -9e3 && !this.projectsSelectableText(node)) {
+      if (node.isPointInside(this.mouseX, this.mouseY)) return true;
+    }
+    const existing = _optionalChain([this, 'access', _124 => _124.a11yElements, 'optionalAccess', _125 => _125.get, 'call', _126 => _126(node.id)]);
+    if (existing && typeof document !== "undefined" && document.activeElement === existing) {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Whether `node` mirrors selectable text of its own.
+   *
+   * Such an entity must not be promoted by the pointer: its interactive a11y node
+   * would sit above the text mirror and eat the mousedown that starts a native
+   * selection.
+   */
+  projectsSelectableText(node) {
+    const projection = _optionalChain([node, 'access', _127 => _127.getContentProjection, 'optionalCall', _128 => _128()]);
+    return !!_optionalChain([projection, 'optionalAccess', _129 => _129.text]) && projection.selectable !== false;
+  }
+  /**
+   * Keep `entity`'s a11y shadow node projected while it has
+   * `a11yProjection: 'onDemand'`.
+   *
+   * For anything the application knows matters but the engine cannot infer — the
+   * selected danmaku, a search hit, a node just announced in a live region.
+   * Without this, `'onDemand'` would be reachable only by focus or pointer, and
+   * an app-driven selection change would leave the selected entity semantically
+   * invisible.
+   *
+   * Idempotent. Has no effect on an `'eager'` entity, which is always projected.
+   */
+  requestA11yProjection(entity) {
+    const id = typeof entity === "string" ? entity : entity.id;
+    if (this.a11yProjectionRequests.has(id)) return;
+    this.a11yProjectionRequests.add(id);
+    this.a11yNeedsReorder = true;
+    this.markDirty({ entity: id, reason: "a11y-reorder" });
+  }
+  /**
+   * Drop a projection request made by {@link requestA11yProjection}.
+   *
+   * The node is not removed immediately: it survives while it is focused or under
+   * the pointer, and is pruned on the next sync that finds it unengaged. Releasing
+   * a request the scene does not hold is a no-op.
+   */
+  releaseA11yProjection(entity) {
+    const id = typeof entity === "string" ? entity : entity.id;
+    if (!this.a11yProjectionRequests.delete(id)) return;
+    this.a11yNeedsReorder = true;
+    this.markDirty({ entity: id, reason: "a11y-reorder" });
   }
   syncA11y(node, container = null) {
     if (!this.a11yRoot) return;
@@ -3941,20 +4094,20 @@ var Scene = (_class7 = class _Scene {
           el.style.background = "transparent";
         }
         el.addEventListener("click", (e) => {
-          node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("click", node, e));
+          node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("click", node, e));
         });
         el.addEventListener("dblclick", (e) => {
-          node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("dblclick", node, e));
+          node.dispatchEvent(new (0, _chunkTRT2TRCWjs.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, _chunkZ3HFY75Rjs.VectoJSEvent)("hover", node, e, false));
+          node.dispatchEvent(new (0, _chunkTRT2TRCWjs.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, _chunkZ3HFY75Rjs.VectoJSEvent)("pointerleave", node, e, false));
+          node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("pointerleave", node, e, false));
         });
         const capEl = el;
         const releasePointer = (event) => {
@@ -3970,24 +4123,24 @@ var Scene = (_class7 = class _Scene {
         };
         el.addEventListener("pointerdown", (e) => {
           if (typeof capEl.setPointerCapture === "function") capEl.setPointerCapture(e.pointerId);
-          node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("pointerdown", node, e));
+          node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("pointerdown", node, e));
         });
         el.addEventListener("pointerup", (e) => {
           releasePointer(e);
-          node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("pointerup", node, e));
+          node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("pointerup", node, e));
         });
         el.addEventListener("pointercancel", (e) => {
           releasePointer(e);
-          node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("pointercancel", node, e));
+          node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("pointercancel", node, e));
         });
         el.addEventListener(
           "pointermove",
-          (e) => node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("pointermove", node, e))
+          (e) => node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("pointermove", node, e))
         );
         el.addEventListener(
           "wheel",
           (e) => {
-            node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("wheel", node, e));
+            node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("wheel", node, e));
           },
           { passive: false }
         );
@@ -4012,10 +4165,10 @@ var Scene = (_class7 = class _Scene {
         );
         emitInitialScroll = emitScroll;
         el.addEventListener("keydown", (e) => {
-          node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("keydown", node, e));
+          node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("keydown", node, e));
         });
         el.addEventListener("keyup", (e) => {
-          node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("keyup", node, e));
+          node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("keyup", node, e));
         });
         if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
           const input = el;
@@ -4046,7 +4199,7 @@ var Scene = (_class7 = class _Scene {
           el.addEventListener("compositionupdate", (e) => {
             const data = _nullishCoalesce(e.data, () => ( ""));
             composition = {
-              start: _nullishCoalesce(_optionalChain([composition, 'optionalAccess', _121 => _121.start]), () => ( 0)),
+              start: _nullishCoalesce(_optionalChain([composition, 'optionalAccess', _130 => _130.start]), () => ( 0)),
               length: data.length
             };
             forward();
@@ -4081,7 +4234,7 @@ var Scene = (_class7 = class _Scene {
           el.addEventListener("keydown", (e) => {
             if (e.key === "Enter" || e.key === " ") {
               e.preventDefault();
-              node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("click", node, e));
+              node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("click", node, e));
             }
           });
         }
@@ -4288,7 +4441,7 @@ var Scene = (_class7 = class _Scene {
         const display = visible ? "" : "none";
         if (el.style.display !== display) el.style.display = display;
       }
-      _optionalChain([emitInitialScroll, 'optionalCall', _122 => _122()]);
+      _optionalChain([emitInitialScroll, 'optionalCall', _131 => _131()]);
     }
     if (this._phaseTiming) {
       const projectionStart = performance.now();
@@ -4360,6 +4513,57 @@ var Scene = (_class7 = class _Scene {
     }
     return true;
   }
+  /**
+   * The band of an entity's own y coordinates that is worth projecting, or
+   * `null` to project everything.
+   *
+   * {@link projectionBoxVisible} answers "is this entity near the viewport",
+   * which frees whole blocks that scroll away. It cannot help a single entity
+   * *taller* than the viewport: that entity's box always intersects, so every
+   * one of its visual lines was materialized — a `<span>` per line and, on the
+   * grid path, a `<span>` per glyph cluster. That is where "14.8k elements for a
+   * 346KB Markdown doc" comes from, and it is O(document) rather than
+   * O(viewport) in both element count and per-frame walk cost.
+   *
+   * Measured on one entity scrolled to its middle, real headed browsers
+   * (`benchmarks/projection-per-line/`): at 4000 lines, materializing every line
+   * costs 6.28 ms/frame on Chrome and 6.51 ms on Firefox with 36,000 child
+   * elements, against 0.28/0.16 ms and 963 elements when only the visible band
+   * is emitted. The gated cost is *flat* across a 20x document-size range, so
+   * this converts an asymptote rather than shaving a constant.
+   *
+   * Returns local-y bounds in the entity's own coordinate space, already
+   * expanded by `margin` and intersected with every `clipChildren` ancestor, so
+   * a line inside a scrolled container is measured against the container rather
+   * than the window. `null` means "no useful bound" — a degenerate transform, a
+   * rotation/skew that makes a y-band meaningless, or a boundless entity — and
+   * the caller must then project every line, because emitting nothing would
+   * silently drop text from selection, find-in-page and screen readers.
+   */
+  projectionVisibleLocalYBand(node, tf, margin) {
+    const { b, d, f } = tf;
+    if (b !== 0 || d === 0 || !Number.isFinite(d) || !Number.isFinite(f)) return null;
+    const top = (-margin - f) / d;
+    const bottom = (this.height + margin - f) / d;
+    let minY = Math.min(top, bottom);
+    let maxY = Math.max(top, bottom);
+    for (let ancestor = node.parent; ancestor; ancestor = ancestor.parent) {
+      if (!ancestor.clipChildren || ancestor.width <= 0 || ancestor.height <= 0) continue;
+      const originWorldY = f;
+      const unitWorldY = d + f;
+      const originLocal = ancestor.worldToLocal(tf.e, originWorldY);
+      const unitLocal = ancestor.worldToLocal(tf.e + tf.c, unitWorldY);
+      if (!originLocal || !unitLocal) return null;
+      const slope = unitLocal.y - originLocal.y;
+      if (slope === 0 || !Number.isFinite(slope)) return null;
+      const a1 = (-margin - originLocal.y) / slope;
+      const a2 = (ancestor.height + margin - originLocal.y) / slope;
+      minY = Math.max(minY, Math.min(a1, a2));
+      maxY = Math.min(maxY, Math.max(a1, a2));
+    }
+    if (!Number.isFinite(minY) || !Number.isFinite(maxY) || maxY < minY) return null;
+    return { minY, maxY };
+  }
   syncContentProjection(node) {
     if (!this.contentProjectionEnabled || !this.a11yRoot) return;
     let el = this.contentElements.get(node.id);
@@ -4370,14 +4574,30 @@ var Scene = (_class7 = class _Scene {
         this.contentElements.delete(node.id);
         this.a11yNeedsReorder = true;
       }
+      this.contentSyncState.delete(node.id);
     };
     const worldTf = node.getWorldTransform();
-    const margin = _nullishCoalesce(this.contentProjectionMargin, () => ( this.height));
-    if (Number.isFinite(margin) && !this.projectionBoxVisible(node, worldTf, margin)) {
+    const interactionMargin = _nullishCoalesce(this.contentProjectionMargin, () => ( this.height));
+    const semanticMargin = _nullishCoalesce(this.contentSemanticMargin, () => ( interactionMargin));
+    if (Number.isFinite(semanticMargin) && !this.projectionBoxVisible(node, worldTf, semanticMargin)) {
       releaseProjectionEl();
       return;
     }
-    const projection = node.getContentProjection();
+    const inInteractionBand = !Number.isFinite(interactionMargin) || this.projectionBoxVisible(node, worldTf, interactionMargin);
+    const tier = inInteractionBand ? "fine" : "coarse";
+    const lineBand = tier === "coarse" ? null : Number.isFinite(interactionMargin) ? this.projectionVisibleLocalYBand(node, worldTf, interactionMargin) : null;
+    const visible = this.projectionBoxVisible(node, worldTf, 0);
+    const epoch = node.getContentEpoch();
+    const prior = this.contentSyncState.get(node.id);
+    if (epoch !== null && el && prior !== void 0) {
+      const { a: a2, b: b2, c: c2, d: d2, e: e2, f: f2 } = worldTf;
+      if (prior.epoch === epoch && prior.fontEpoch === this.contentFontEpoch && prior.a === a2 && prior.b === b2 && prior.c === c2 && prior.d === d2 && prior.e === e2 && prior.f === f2 && prior.tier === tier && prior.hasBand === (lineBand !== null) && (lineBand === null || prior.bandMin === lineBand.minY && prior.bandMax === lineBand.maxY) && prior.visible === visible && prior.width === node.width && prior.height === node.height && prior.interactive === node.interactive) {
+        return;
+      }
+    }
+    const projection = node.getContentProjection(
+      lineBand ? { minY: lineBand.minY, maxY: lineBand.maxY } : void 0
+    );
     if (!projection || !projection.text) {
       releaseProjectionEl();
       return;
@@ -4398,7 +4618,7 @@ var Scene = (_class7 = class _Scene {
       el.addEventListener(
         "wheel",
         (e2) => {
-          node.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)("wheel", node, e2));
+          node.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)("wheel", node, e2));
         },
         { passive: false }
       );
@@ -4407,23 +4627,30 @@ var Scene = (_class7 = class _Scene {
       this.a11yNeedsReorder = true;
     }
     const lines = projection.lines;
-    if (!projection.grid && el.dataset.vectoContentGrid !== void 0) {
+    const useCarriers = tier === "fine";
+    if ((!projection.grid || !useCarriers) && el.dataset.vectoContentGrid !== void 0) {
       this.clearContentGridState(node.id, el);
     }
-    if (projection.grid) {
+    if (projection.grid && useCarriers) {
       const gridSyncStart = this._phaseTiming ? performance.now() : 0;
-      this.syncContentGridProjection(node, el, projection, projection.grid);
+      this.syncContentGridProjection(node, el, projection, projection.grid, lineBand);
       if (this._phaseTiming) this._recordPhase("gridSync", performance.now() - gridSyncStart);
-    } else if (lines && lines.length > 0) {
+    } else if (useCarriers && lines && lines.length > 0) {
+      const lineWindow = projectionLineWindow(lines, lineBand, _nullishCoalesce(projection.lineHeight, () => ( 16)));
       const signature = JSON.stringify({
         lines,
         fallbackFont: _nullishCoalesce(projection.font, () => ( "")),
-        fallbackLineHeight: _nullishCoalesce(projection.lineHeight, () => ( 16))
+        fallbackLineHeight: _nullishCoalesce(projection.lineHeight, () => ( 16)),
+        // Part of the signature, or scrolling would not rebuild the carriers and
+        // the window would stay frozen where it was first built. Quantized to
+        // whole line indices by construction, so a sub-pixel scroll inside one
+        // line does not churn the DOM.
+        window: lineWindow.gated ? `${lineWindow.start}-${lineWindow.end}` : "all"
       });
       if (el.dataset.vectoProjectionLines !== signature) {
         this.preserveContentSelectionAcrossRebuild(el, () => {
           el.replaceChildren();
-          for (let index = 0; index < lines.length; index++) {
+          for (let index = lineWindow.start; index < lineWindow.end; index++) {
             const line = lines[index];
             const lineElement = document.createElement("span");
             const lineFont = _nullishCoalesce(_nullishCoalesce(line.font, () => ( projection.font)), () => ( ""));
@@ -4464,13 +4691,20 @@ var Scene = (_class7 = class _Scene {
           }
         });
         el.dataset.vectoProjectionLines = signature;
+        if (lineWindow.gated) {
+          el.dataset.vectoProjectionWindow = `${lineWindow.start}-${lineWindow.end}/${lines.length}`;
+        } else {
+          delete el.dataset.vectoProjectionWindow;
+        }
       }
     } else {
-      if (el.textContent !== projection.text) {
+      const demoted = tier === "coarse" && el.children.length > 0;
+      if (el.textContent !== projection.text || demoted) {
         this.releaseContentSelectionForRebuild(el);
         el.textContent = projection.text;
       }
       delete el.dataset.vectoProjectionLines;
+      if (tier === "coarse") delete el.dataset.vectoProjectionWindow;
     }
     const font = _nullishCoalesce(projection.font, () => ( ""));
     if (el.style.font !== font) el.style.font = font;
@@ -4503,20 +4737,41 @@ var Scene = (_class7 = class _Scene {
     if (node.width > 0) el.style.width = `${node.width}px`;
     if (node.height > 0) el.style.height = `${node.height}px`;
     el.style.transform = `matrix(${a}, ${b}, ${c}, ${d}, 0, 0)`;
-    const visible = this.projectionBoxVisible(node, worldTf, 0);
     const display = visible ? "" : "none";
     if (el.style.display !== display) el.style.display = display;
+    if (epoch !== null) {
+      const { a: a2, b: b2, c: c2, d: d2, e: e2, f: f2 } = worldTf;
+      const next = _nullishCoalesce(prior, () => ( {}));
+      next.epoch = epoch;
+      next.fontEpoch = this.contentFontEpoch;
+      next.a = a2;
+      next.b = b2;
+      next.c = c2;
+      next.d = d2;
+      next.e = e2;
+      next.f = f2;
+      next.tier = tier;
+      next.hasBand = lineBand !== null;
+      next.bandMin = _nullishCoalesce(_optionalChain([lineBand, 'optionalAccess', _132 => _132.minY]), () => ( 0));
+      next.bandMax = _nullishCoalesce(_optionalChain([lineBand, 'optionalAccess', _133 => _133.maxY]), () => ( 0));
+      next.visible = visible;
+      next.width = node.width;
+      next.height = node.height;
+      next.interactive = node.interactive;
+      if (prior === void 0) this.contentSyncState.set(node.id, next);
+    }
   }
   /**
    * Materialize a prepared grid in logical source order while positioning each
    * carrier from the shared canvas geometry. Browser font measurement happens
    * later in one cold read/write batch, never inside projection synchronization.
    */
-  syncContentGridProjection(node, el, projection, grid) {
+  syncContentGridProjection(node, el, projection, grid, lineBand) {
     if (grid.source !== projection.text) {
       throw new Error("ContentProjection.grid.source must equal ContentProjection.text");
     }
-    const signature = `${grid.revision}`;
+    const gridWindow = projectionGridLineWindow(grid, projection.lines, lineBand);
+    const signature = gridWindow.gated ? `${grid.revision}:${gridWindow.start}-${gridWindow.end}` : `${grid.revision}`;
     if (el.dataset.vectoContentGrid !== signature) {
       const materializeStart = typeof performance !== "undefined" ? performance.now() : 0;
       this.clearContentGridState(node.id, el, false);
@@ -4524,12 +4779,13 @@ var Scene = (_class7 = class _Scene {
       const selectionLine = this.contentGridSelectionLine(el);
       let rebuiltSelectionLine = false;
       const existingLines = el.children;
-      for (let lineIndex = 0; lineIndex < grid.lines.length; lineIndex++) {
+      for (let lineIndex = gridWindow.start; lineIndex < gridWindow.end; lineIndex++) {
+        const domIndex = lineIndex - gridWindow.start;
         const gridLine = grid.lines[lineIndex];
         const projectedLine = projectionLines[lineIndex];
-        const lineHeight = _nullishCoalesce(_optionalChain([projectedLine, 'optionalAccess', _123 => _123.lineHeight]), () => ( grid.lineHeight));
-        const baseline = _nullishCoalesce(_optionalChain([projectedLine, 'optionalAccess', _124 => _124.baseline]), () => ( grid.baseline));
-        const lineFont = _nullishCoalesce(_optionalChain([projectedLine, 'optionalAccess', _125 => _125.font]), () => ( grid.font));
+        const lineHeight = _nullishCoalesce(_optionalChain([projectedLine, 'optionalAccess', _134 => _134.lineHeight]), () => ( grid.lineHeight));
+        const baseline = _nullishCoalesce(_optionalChain([projectedLine, 'optionalAccess', _135 => _135.baseline]), () => ( grid.baseline));
+        const lineFont = _nullishCoalesce(_optionalChain([projectedLine, 'optionalAccess', _136 => _136.font]), () => ( grid.font));
         const lineSignature = contentGridLineSignature(
           grid,
           gridLine,
@@ -4539,7 +4795,7 @@ var Scene = (_class7 = class _Scene {
           lineFont,
           lineIndex === 0
         );
-        const reusable = existingLines[lineIndex];
+        const reusable = existingLines[domIndex];
         if (reusable !== void 0 && reusable.dataset.vectoGridLineSig === lineSignature && reusable.dataset.vectoGridLine === `${lineIndex}`) {
           continue;
         }
@@ -4549,8 +4805,8 @@ var Scene = (_class7 = class _Scene {
         lineElement.dir = "ltr";
         lineElement.dataset.vectoGridLine = `${lineIndex}`;
         lineElement.style.position = "absolute";
-        lineElement.style.left = `${_nullishCoalesce(_optionalChain([projectedLine, 'optionalAccess', _126 => _126.x]), () => ( 0))}px`;
-        lineElement.style.top = `${(_nullishCoalesce(_optionalChain([projectedLine, 'optionalAccess', _127 => _127.y]), () => ( lineIndex * grid.lineHeight))) + baseline - _text.cssLineBoxBaseline.call(void 0, lineFont, lineHeight)}px`;
+        lineElement.style.left = `${_nullishCoalesce(_optionalChain([projectedLine, 'optionalAccess', _137 => _137.x]), () => ( 0))}px`;
+        lineElement.style.top = `${(_nullishCoalesce(_optionalChain([projectedLine, 'optionalAccess', _138 => _138.y]), () => ( lineIndex * grid.lineHeight))) + baseline - _text.cssLineBoxBaseline.call(void 0, lineFont, lineHeight)}px`;
         lineElement.style.width = `${gridLine.width}px`;
         lineElement.style.height = `${lineHeight}px`;
         lineElement.style.whiteSpace = "pre";
@@ -4612,19 +4868,25 @@ var Scene = (_class7 = class _Scene {
             lineElement.appendChild(marker);
           }
         }
-        const occupant = el.children[lineIndex];
+        const occupant = el.children[domIndex];
         if (occupant) el.replaceChild(lineElement, occupant);
         else el.appendChild(lineElement);
       }
-      while (el.children.length > grid.lines.length) {
-        if (selectionLine !== null && selectionLine >= grid.lines.length) {
+      const windowLength = gridWindow.end - gridWindow.start;
+      while (el.children.length > windowLength) {
+        if (selectionLine !== null && selectionLine >= gridWindow.end) {
           rebuiltSelectionLine = true;
         }
-        _optionalChain([el, 'access', _128 => _128.lastElementChild, 'optionalAccess', _129 => _129.remove, 'call', _130 => _130()]);
+        _optionalChain([el, 'access', _139 => _139.lastElementChild, 'optionalAccess', _140 => _140.remove, 'call', _141 => _141()]);
       }
       if (rebuiltSelectionLine) this.releaseContentSelectionForRebuild(el);
       el.dataset.vectoProjectionLines = signature;
       el.dataset.vectoContentGrid = signature;
+      if (gridWindow.gated) {
+        el.dataset.vectoProjectionWindow = `${gridWindow.start}-${gridWindow.end}/${grid.lines.length}`;
+      } else {
+        delete el.dataset.vectoProjectionWindow;
+      }
       el.dataset.vectoGridCarriers = `${el.querySelectorAll("[data-vecto-grid-cell]").length}`;
       if (typeof performance !== "undefined") {
         const materializeMs = performance.now() - materializeStart;
@@ -4684,7 +4946,7 @@ var Scene = (_class7 = class _Scene {
     if (previous !== void 0 && typeof cancelAnimationFrame === "function") {
       cancelAnimationFrame(previous);
     }
-    _optionalChain([this, 'access', _131 => _131.contentGridCalibrationProbes, 'access', _132 => _132.get, 'call', _133 => _133(entityId), 'optionalAccess', _134 => _134.remove, 'call', _135 => _135()]);
+    _optionalChain([this, 'access', _142 => _142.contentGridCalibrationProbes, 'access', _143 => _143.get, 'call', _144 => _144(entityId), 'optionalAccess', _145 => _145.remove, 'call', _146 => _146()]);
     this.contentGridCalibrationProbes.delete(entityId);
     const calibrationStart = typeof performance !== "undefined" ? performance.now() : 0;
     const probe = document.createElement("div");
@@ -4718,7 +4980,7 @@ var Scene = (_class7 = class _Scene {
         target.dataset.vectoGridCalib = generation;
         continue;
       }
-      const sourceText = _nullishCoalesce(_optionalChain([target, 'access', _136 => _136.textContent, 'optionalAccess', _137 => _137.slice, 'call', _138 => _138(0, sourceLength)]), () => ( ""));
+      const sourceText = _nullishCoalesce(_optionalChain([target, 'access', _147 => _147.textContent, 'optionalAccess', _148 => _148.slice, 'call', _149 => _149(0, sourceLength)]), () => ( ""));
       if (!sourceText) {
         target.dataset.vectoGridCalib = generation;
         continue;
@@ -4965,12 +5227,12 @@ var Scene = (_class7 = class _Scene {
   syncOverlayGeometry() {
     const parent = this.canvas.parentElement;
     if (!parent) return;
-    const canvasRect = _optionalChain([this, 'access', _139 => _139.canvas, 'access', _140 => _140.getBoundingClientRect, 'optionalCall', _141 => _141()]);
-    const parentRect = _optionalChain([parent, 'access', _142 => _142.getBoundingClientRect, 'optionalCall', _143 => _143()]);
-    const cssWidth = _optionalChain([canvasRect, 'optionalAccess', _144 => _144.width]) || this.canvas.clientWidth || this.width;
-    const cssHeight = _optionalChain([canvasRect, 'optionalAccess', _145 => _145.height]) || this.canvas.clientHeight || this.height;
-    const left = (_nullishCoalesce(_optionalChain([canvasRect, 'optionalAccess', _146 => _146.left]), () => ( 0))) - (_nullishCoalesce(_optionalChain([parentRect, 'optionalAccess', _147 => _147.left]), () => ( 0))) - (parent.clientLeft || 0) + parent.scrollLeft;
-    const top = (_nullishCoalesce(_optionalChain([canvasRect, 'optionalAccess', _148 => _148.top]), () => ( 0))) - (_nullishCoalesce(_optionalChain([parentRect, 'optionalAccess', _149 => _149.top]), () => ( 0))) - (parent.clientTop || 0) + parent.scrollTop;
+    const canvasRect = _optionalChain([this, 'access', _150 => _150.canvas, 'access', _151 => _151.getBoundingClientRect, 'optionalCall', _152 => _152()]);
+    const parentRect = _optionalChain([parent, 'access', _153 => _153.getBoundingClientRect, 'optionalCall', _154 => _154()]);
+    const cssWidth = _optionalChain([canvasRect, 'optionalAccess', _155 => _155.width]) || this.canvas.clientWidth || this.width;
+    const cssHeight = _optionalChain([canvasRect, 'optionalAccess', _156 => _156.height]) || this.canvas.clientHeight || this.height;
+    const left = (_nullishCoalesce(_optionalChain([canvasRect, 'optionalAccess', _157 => _157.left]), () => ( 0))) - (_nullishCoalesce(_optionalChain([parentRect, 'optionalAccess', _158 => _158.left]), () => ( 0))) - (parent.clientLeft || 0) + parent.scrollLeft;
+    const top = (_nullishCoalesce(_optionalChain([canvasRect, 'optionalAccess', _159 => _159.top]), () => ( 0))) - (_nullishCoalesce(_optionalChain([parentRect, 'optionalAccess', _160 => _160.top]), () => ( 0))) - (parent.clientTop || 0) + parent.scrollTop;
     const scaleX = this.width > 0 ? cssWidth / this.width : 1;
     const scaleY = this.height > 0 ? cssHeight / this.height : 1;
     const prev = this._overlayGeometry;
@@ -5109,7 +5371,7 @@ var Scene = (_class7 = class _Scene {
    * (and {@link respectReducedMotion} is on). `0` means uncapped.
    */
   effectiveMaxFPS() {
-    const reduced = this.respectReducedMotion && !!_optionalChain([this, 'access', _150 => _150.reducedMotionQuery, 'optionalAccess', _151 => _151.matches]);
+    const reduced = this.respectReducedMotion && !!_optionalChain([this, 'access', _161 => _161.reducedMotionQuery, 'optionalAccess', _162 => _162.matches]);
     if (reduced)
       return this.maxFPS > 0 ? Math.min(this.maxFPS, REDUCED_MOTION_FPS) : REDUCED_MOTION_FPS;
     return this.maxFPS;
@@ -5204,7 +5466,7 @@ var Scene = (_class7 = class _Scene {
    * @param time - Current absolute time in milliseconds (default 0).
    */
   render(renderer, dt = 0, time = 0) {
-    if (_optionalChain([renderer, 'access', _152 => _152.isContextLost, 'optionalCall', _153 => _153()])) return;
+    if (_optionalChain([renderer, 'access', _163 => _163.isContextLost, 'optionalCall', _164 => _164()])) return;
     const isMainRenderer = renderer === this.renderer;
     if (isMainRenderer && this.a11yRoot && this.canvas.parentElement) {
       const parentStyle = this.canvas.parentElement.style;
@@ -5348,14 +5610,14 @@ var Scene = (_class7 = class _Scene {
     }
     renderer.clear();
     if (isMainRenderer) {
-      _optionalChain([this, 'access', _154 => _154.pointRenderer, 'optionalAccess', _155 => _155.begin, 'call', _156 => _156()]);
+      _optionalChain([this, 'access', _165 => _165.pointRenderer, 'optionalAccess', _166 => _166.begin, 'call', _167 => _167()]);
     }
     const vw = this.width;
     const vh = this.height;
     let walkHadAnimation = false;
     let walkHadInteractive = false;
     const runUpdate = (node) => {
-      const overridesUpdate = node.update !== _chunkZ3HFY75Rjs.Entity.prototype.update;
+      const overridesUpdate = node.update !== _chunkTRT2TRCWjs.Entity.prototype.update;
       let pending = node.hasPendingAnimations();
       if (pending || overridesUpdate) {
         node.update(dt, time);
@@ -5364,7 +5626,7 @@ var Scene = (_class7 = class _Scene {
       if (pending) walkHadAnimation = true;
       if (!walkHadInteractive && node.interactive) walkHadInteractive = true;
       if (this._devActive && this._devFrameCount % 120 === 0) {
-        if (overridesUpdate && node.hasPendingAnimations === _chunkZ3HFY75Rjs.Entity.prototype.hasPendingAnimations) {
+        if (overridesUpdate && node.hasPendingAnimations === _chunkTRT2TRCWjs.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.`
           );
@@ -5562,9 +5824,9 @@ var Scene = (_class7 = class _Scene {
     const flushT0 = this._phaseTiming ? performance.now() : 0;
     renderer.flush();
     if (isMainRenderer) {
-      _optionalChain([this, 'access', _157 => _157.pointRenderer, 'optionalAccess', _158 => _158.flush, 'call', _159 => _159()]);
+      _optionalChain([this, 'access', _168 => _168.pointRenderer, 'optionalAccess', _169 => _169.flush, 'call', _170 => _170()]);
     }
-    _optionalChain([renderer, 'access', _160 => _160.present, 'optionalCall', _161 => _161()]);
+    _optionalChain([renderer, 'access', _171 => _171.present, 'optionalCall', _172 => _172()]);
     if (this._phaseTiming) this._recordPhase("flush", performance.now() - flushT0);
     if (flushTiming) endVectoUserTiming(flushTiming);
     if (this._devActive) {
@@ -5845,8 +6107,8 @@ function pointInBounds(b, x, y) {
 function contentGridLineSignature(grid, line, projected, lineHeight, baseline, font, isFirstLine) {
   const parts = [
     // Line box: position, size, and the font that resolves its baseline.
-    `${_nullishCoalesce(_optionalChain([projected, 'optionalAccess', _162 => _162.x]), () => ( 0))}`,
-    `${_nullishCoalesce(_optionalChain([projected, 'optionalAccess', _163 => _163.y]), () => ( ""))}`,
+    `${_nullishCoalesce(_optionalChain([projected, 'optionalAccess', _173 => _173.x]), () => ( 0))}`,
+    `${_nullishCoalesce(_optionalChain([projected, 'optionalAccess', _174 => _174.y]), () => ( ""))}`,
     `${lineHeight}`,
     `${baseline}`,
     font,
@@ -5888,20 +6150,22 @@ function defaultMeasurer() {
   sharedMeasurer ??= _layout.resolveGlyphMeasurer.call(void 0, "sans-serif");
   return sharedMeasurer;
 }
-var TextEntity = (_class8 = class extends _chunkZ3HFY75Rjs.Entity {
+var TextEntity = (_class8 = class extends _chunkTRT2TRCWjs.Entity {
   
   
   
   
-  __init151() {this.nodes = []}
+  __init154() {this.nodes = []}
   
-  __init152() {this.fillStyle = "#94a3b8"}
-  __init153() {this.strokeStyle = null}
-  __init154() {this.hoveredFillStyle = "#ffffff"}
-  __init155() {this.lineWidth = 1}
-  __init156() {this.isHovered = false}
+  __init155() {this.fillStyle = "#94a3b8"}
+  __init156() {this.strokeStyle = null}
+  __init157() {this.hoveredFillStyle = "#ffffff"}
+  __init158() {this.lineWidth = 1}
+  __init159() {this.isHovered = false}
+  /** Bumped by {@link applyLayout}; read by `Scene` to skip an unchanged sync. */
+  __init160() {this.contentEpoch = 0}
   constructor(text, atlas, maxWidth, fontSize = 24) {
-    super();_class8.prototype.__init151.call(this);_class8.prototype.__init152.call(this);_class8.prototype.__init153.call(this);_class8.prototype.__init154.call(this);_class8.prototype.__init155.call(this);_class8.prototype.__init156.call(this);;
+    super();_class8.prototype.__init154.call(this);_class8.prototype.__init155.call(this);_class8.prototype.__init156.call(this);_class8.prototype.__init157.call(this);_class8.prototype.__init158.call(this);_class8.prototype.__init159.call(this);_class8.prototype.__init160.call(this);;
     this.text = text;
     this.atlas = atlas;
     this.fontSize = fontSize;
@@ -5920,6 +6184,9 @@ var TextEntity = (_class8 = class extends _chunkZ3HFY75Rjs.Entity {
     if (!this.text) return null;
     return { text: this.text, font: `${this.fontSize}px sans-serif` };
   }
+  getContentEpoch() {
+    return this.contentEpoch;
+  }
   /**
    * Replace the text content. Runs the **cold** measurement pass (re-segment +
    * re-measure) since the glyphs changed, then re-lays out.
@@ -5966,6 +6233,7 @@ var TextEntity = (_class8 = class extends _chunkZ3HFY75Rjs.Entity {
   }
   /** Hot pass: place the cached {@link PreparedText} and refresh the a11y box. */
   applyLayout() {
+    this.contentEpoch++;
     const result = this.layout.layoutPrepared(this.prepared);
     this.nodes = result.nodes;
     this.width = result.totalWidth;
@@ -6014,17 +6282,17 @@ var TextEntity = (_class8 = class extends _chunkZ3HFY75Rjs.Entity {
 }, _class8);
 
 // src/components/GridTextEntity.ts
-var GridTextEntity = (_class9 = class extends _chunkZ3HFY75Rjs.Entity {
+var GridTextEntity = (_class9 = class extends _chunkTRT2TRCWjs.Entity {
   
-  __init157() {this.fillStyle = "#ffffff"}
-  __init158() {this.grid = []}
+  __init161() {this.fillStyle = "#ffffff"}
+  __init162() {this.grid = []}
   // Array of rows
-  __init159() {this.cols = 0}
-  __init160() {this.rows = 0}
+  __init163() {this.cols = 0}
+  __init164() {this.rows = 0}
   
   
   constructor(_atlas, fontSize = 10) {
-    super();_class9.prototype.__init157.call(this);_class9.prototype.__init158.call(this);_class9.prototype.__init159.call(this);_class9.prototype.__init160.call(this);;
+    super();_class9.prototype.__init161.call(this);_class9.prototype.__init162.call(this);_class9.prototype.__init163.call(this);_class9.prototype.__init164.call(this);;
     this.fontSize = fontSize;
     this.charWidth = fontSize * 1;
     this.charHeight = fontSize * 1.1;
@@ -6033,7 +6301,7 @@ var GridTextEntity = (_class9 = class extends _chunkZ3HFY75Rjs.Entity {
   updateGrid(ascii) {
     this.grid = ascii;
     this.rows = ascii.length;
-    this.cols = _optionalChain([ascii, 'access', _164 => _164[0], 'optionalAccess', _165 => _165.length]) || 0;
+    this.cols = _optionalChain([ascii, 'access', _175 => _175[0], 'optionalAccess', _176 => _176.length]) || 0;
   }
   isPointInside(_globalX, _globalY) {
     return false;
@@ -6108,7 +6376,7 @@ function distSqToSegment(px, py, x1, y1, x2, y2) {
   const ey = py - cy;
   return ex * ex + ey * ey;
 }
-var SplineEntity = (_class10 = class extends _chunkZ3HFY75Rjs.Entity {
+var SplineEntity = (_class10 = class extends _chunkTRT2TRCWjs.Entity {
   
   
   
@@ -6116,23 +6384,23 @@ var SplineEntity = (_class10 = class extends _chunkZ3HFY75Rjs.Entity {
   
   
   
-  __init161() {this.offscreen = null}
-  __init162() {this.baked = false}
+  __init165() {this.offscreen = null}
+  __init166() {this.baked = false}
   /** Logical (CSS-pixel) size of the baked bitmap — the blit destination size. */
-  __init163() {this.bakedWidth = 0}
-  __init164() {this.bakedHeight = 0}
+  __init167() {this.bakedWidth = 0}
+  __init168() {this.bakedHeight = 0}
   /** Gradient strokes can't be baked to a solid-color bitmap; they render per-frame. */
   
   /** Lazily-flattened polylines (one Float32Array of [x,y,...] per segment) for hit-testing. */
-  __init165() {this.polylines = null}
+  __init169() {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`.
    */
-  __init166() {this.showBounds = false}
+  __init170() {this.showBounds = false}
   constructor(doc, opts = {}) {
-    super();_class10.prototype.__init161.call(this);_class10.prototype.__init162.call(this);_class10.prototype.__init163.call(this);_class10.prototype.__init164.call(this);_class10.prototype.__init165.call(this);_class10.prototype.__init166.call(this);;
+    super();_class10.prototype.__init165.call(this);_class10.prototype.__init166.call(this);_class10.prototype.__init167.call(this);_class10.prototype.__init168.call(this);_class10.prototype.__init169.call(this);_class10.prototype.__init170.call(this);;
     this.doc = doc;
     this.lineWidth = _nullishCoalesce(opts.lineWidth, () => ( 2));
     this.cache = _nullishCoalesce(opts.cache, () => ( true));
@@ -6143,7 +6411,7 @@ var SplineEntity = (_class10 = class extends _chunkZ3HFY75Rjs.Entity {
     this.width = this.bounds.width;
     this.height = this.bounds.height;
     const isGradient = (c) => c !== null && !Array.isArray(c);
-    this.containsGradient = (_nullishCoalesce(_optionalChain([this, 'access', _166 => _166.doc, 'access', _167 => _167.equations, 'optionalAccess', _168 => _168.some, 'call', _169 => _169((eq) => isGradient(eq.color_rgb))]), () => ( false))) || (_nullishCoalesce(_optionalChain([this, 'access', _170 => _170.doc, 'access', _171 => _171.paths, 'optionalAccess', _172 => _172.some, 'call', _173 => _173((p) => isGradient(p.color_rgb))]), () => ( false)));
+    this.containsGradient = (_nullishCoalesce(_optionalChain([this, 'access', _177 => _177.doc, 'access', _178 => _178.equations, 'optionalAccess', _179 => _179.some, 'call', _180 => _180((eq) => isGradient(eq.color_rgb))]), () => ( false))) || (_nullishCoalesce(_optionalChain([this, 'access', _181 => _181.doc, 'access', _182 => _182.paths, 'optionalAccess', _183 => _183.some, 'call', _184 => _184((p) => isGradient(p.color_rgb))]), () => ( false)));
     this.interactive = true;
   }
   computeBounds() {
@@ -6383,7 +6651,7 @@ async function loadSpline(url) {
 }
 
 // src/components/Rect.ts
-var Rect = class extends _chunkZ3HFY75Rjs.Entity {
+var Rect = class extends _chunkTRT2TRCWjs.Entity {
   
   
   
@@ -6432,7 +6700,7 @@ var Rect = class extends _chunkZ3HFY75Rjs.Entity {
 };
 
 // src/components/Circle.ts
-var Circle = class extends _chunkZ3HFY75Rjs.Entity {
+var Circle = class extends _chunkTRT2TRCWjs.Entity {
   
   
   
@@ -6492,7 +6760,7 @@ var Circle = class extends _chunkZ3HFY75Rjs.Entity {
 };
 
 // src/components/Group.ts
-var Group = class extends _chunkZ3HFY75Rjs.Entity {
+var Group = class extends _chunkTRT2TRCWjs.Entity {
   constructor(...children) {
     super();
     if (children.length > 0) this.add(...children);
@@ -6511,21 +6779,21 @@ var _math = require('@vectojs/math'); _createStarExport(_math);
 
 
 // src/tree/DOMPortalEntity.ts
-var DOMPortalEntity = (_class11 = class extends _chunkZ3HFY75Rjs.Entity {
+var DOMPortalEntity = (_class11 = class extends _chunkTRT2TRCWjs.Entity {
   
-  __init167() {this.isDOMPortal = true}
-  __init168() {this.domListeners = []}
-  __init169() {this.resizeObserver = null}
-  __init170() {this.domBound = false}
-  __init171() {this.cachedWidth = 100}
-  __init172() {this.cachedHeight = 100}
-  __init173() {this.lastWidth = ""}
-  __init174() {this.lastHeight = ""}
-  __init175() {this.lastTransform = ""}
-  __init176() {this.lastZIndex = ""}
-  __init177() {this.lastOpacity = ""}
+  __init171() {this.isDOMPortal = true}
+  __init172() {this.domListeners = []}
+  __init173() {this.resizeObserver = null}
+  __init174() {this.domBound = false}
+  __init175() {this.cachedWidth = 100}
+  __init176() {this.cachedHeight = 100}
+  __init177() {this.lastWidth = ""}
+  __init178() {this.lastHeight = ""}
+  __init179() {this.lastTransform = ""}
+  __init180() {this.lastZIndex = ""}
+  __init181() {this.lastOpacity = ""}
   constructor(domElement, width, height, id) {
-    super(id);_class11.prototype.__init167.call(this);_class11.prototype.__init168.call(this);_class11.prototype.__init169.call(this);_class11.prototype.__init170.call(this);_class11.prototype.__init171.call(this);_class11.prototype.__init172.call(this);_class11.prototype.__init173.call(this);_class11.prototype.__init174.call(this);_class11.prototype.__init175.call(this);_class11.prototype.__init176.call(this);_class11.prototype.__init177.call(this);;
+    super(id);_class11.prototype.__init171.call(this);_class11.prototype.__init172.call(this);_class11.prototype.__init173.call(this);_class11.prototype.__init174.call(this);_class11.prototype.__init175.call(this);_class11.prototype.__init176.call(this);_class11.prototype.__init177.call(this);_class11.prototype.__init178.call(this);_class11.prototype.__init179.call(this);_class11.prototype.__init180.call(this);_class11.prototype.__init181.call(this);;
     this.domElement = domElement;
     this.width = _nullishCoalesce(width, () => ( 0));
     this.height = _nullishCoalesce(height, () => ( 0));
@@ -6567,7 +6835,7 @@ var DOMPortalEntity = (_class11 = class extends _chunkZ3HFY75Rjs.Entity {
     ];
     for (const type of events) {
       const handler = (e) => {
-        this.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)(type, this, e));
+        this.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)(type, this, e));
       };
       this.domElement.addEventListener(type, handler);
       this.domListeners.push({ type, handler, capture: false });
@@ -6578,7 +6846,7 @@ var DOMPortalEntity = (_class11 = class extends _chunkZ3HFY75Rjs.Entity {
     ];
     for (const { native, vecto } of hoverEvents) {
       const handler = (e) => {
-        this.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)(vecto, this, e, false));
+        this.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)(vecto, this, e, false));
       };
       this.domElement.addEventListener(native, handler);
       this.domListeners.push({ type: native, handler, capture: false });
@@ -6586,7 +6854,7 @@ var DOMPortalEntity = (_class11 = class extends _chunkZ3HFY75Rjs.Entity {
     const focusEvents = ["focus", "blur"];
     for (const type of focusEvents) {
       const handler = (e) => {
-        this.dispatchEvent(new (0, _chunkZ3HFY75Rjs.VectoJSEvent)(type, this, e, true));
+        this.dispatchEvent(new (0, _chunkTRT2TRCWjs.VectoJSEvent)(type, this, e, true));
       };
       this.domElement.addEventListener(type, handler, true);
       this.domListeners.push({ type, handler, capture: true });
@@ -6682,4 +6950,5 @@ Scene.registerWebGPUParticleSystemManager(_chunkM73XB4ZKjs.WebGPUParticleSystemM
 
 
 
-exports.CanvasRenderer = _chunkM73XB4ZKjs.CanvasRenderer; exports.Circle = Circle; exports.ComputeParticleEntity = ComputeParticleEntity; exports.DOMPortalEntity = DOMPortalEntity; exports.Entity = _chunkZ3HFY75Rjs.Entity; exports.GlyphRasterAtlas = _chunkM73XB4ZKjs.GlyphRasterAtlas; exports.GridTextEntity = GridTextEntity; exports.Group = Group; exports.MSDFTextEntity = _chunkZ3HFY75Rjs.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 = _chunkZ3HFY75Rjs.SVGEntity; exports.SVGRenderer = _chunkM73XB4ZKjs.SVGRenderer; exports.Scene = Scene; exports.SplineEntity = SplineEntity; exports.TextEntity = TextEntity; exports.TextRasterCache = _chunkM73XB4ZKjs.TextRasterCache; exports.VECTO_USER_TIMING = VECTO_USER_TIMING; exports.VectoJSEvent = _chunkZ3HFY75Rjs.VectoJSEvent; exports.WebGPUParticleSystemManager = _chunkM73XB4ZKjs.WebGPUParticleSystemManager; exports.beginVectoUserTiming = beginVectoUserTiming; exports.createWebGLPointRenderer = _chunkM73XB4ZKjs.createWebGLPointRenderer; exports.endVectoUserTiming = endVectoUserTiming; exports.installRendererDevTraps = _chunkM73XB4ZKjs.installRendererDevTraps; exports.isRendererDevMode = _chunkM73XB4ZKjs.isRendererDevMode; exports.isSafeUrl = _chunkM73XB4ZKjs.isSafeUrl; exports.loadSpline = loadSpline; exports.measureVectoUserTiming = measureVectoUserTiming; exports.parseColorToRGBA = _chunkM73XB4ZKjs.parseColorToRGBA; exports.polySegmentToBezier = polySegmentToBezier; exports.sanitizeUrl = _chunkM73XB4ZKjs.sanitizeUrl; exports.setRendererDevMode = _chunkM73XB4ZKjs.setRendererDevMode;
+
+exports.CanvasRenderer = _chunkM73XB4ZKjs.CanvasRenderer; exports.Circle = Circle; exports.ComputeParticleEntity = ComputeParticleEntity; exports.DOMPortalEntity = DOMPortalEntity; exports.Entity = _chunkTRT2TRCWjs.Entity; exports.GlyphRasterAtlas = _chunkM73XB4ZKjs.GlyphRasterAtlas; exports.GridTextEntity = GridTextEntity; exports.Group = Group; exports.MSDFTextEntity = _chunkTRT2TRCWjs.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 = _chunkTRT2TRCWjs.SVGEntity; exports.SVGRenderer = _chunkM73XB4ZKjs.SVGRenderer; exports.Scene = Scene; exports.SplineEntity = SplineEntity; exports.TextEntity = TextEntity; exports.TextRasterCache = _chunkM73XB4ZKjs.TextRasterCache; exports.VECTO_USER_TIMING = VECTO_USER_TIMING; exports.VectoJSEvent = _chunkTRT2TRCWjs.VectoJSEvent; exports.WebGPUParticleSystemManager = _chunkM73XB4ZKjs.WebGPUParticleSystemManager; exports.beginVectoUserTiming = beginVectoUserTiming; exports.contentLineInHint = _chunkTRT2TRCWjs.contentLineInHint; exports.createWebGLPointRenderer = _chunkM73XB4ZKjs.createWebGLPointRenderer; exports.endVectoUserTiming = endVectoUserTiming; exports.installRendererDevTraps = _chunkM73XB4ZKjs.installRendererDevTraps; exports.isRendererDevMode = _chunkM73XB4ZKjs.isRendererDevMode; exports.isSafeUrl = _chunkM73XB4ZKjs.isSafeUrl; exports.loadSpline = loadSpline; exports.measureVectoUserTiming = measureVectoUserTiming; exports.parseColorToRGBA = _chunkM73XB4ZKjs.parseColorToRGBA; exports.polySegmentToBezier = polySegmentToBezier; exports.sanitizeUrl = _chunkM73XB4ZKjs.sanitizeUrl; exports.setRendererDevMode = _chunkM73XB4ZKjs.setRendererDevMode;