@vectojs/core 1.39.0 → 1.40.0

package/dist/index.js

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _createStarExport(obj) { Object.keys(obj) .filter((key) => key !== "default" && key !== "__esModule") .forEach((key) => { if (exports.hasOwnProperty(key)) { return; } Object.defineProperty(exports, key, {enumerable: true, configurable: true, get: () => obj[key]}); }); } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7; var _class8; var _class9; var _class10; var _class11; var _class12; var _class13; var _class14; var _class15; var _class16; var _class17; var _class18; var _class19;const __vecto_cjs_url=require("url").pathToFileURL(__filename).href;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _createStarExport(obj) { Object.keys(obj) .filter((key) => key !== "default" && key !== "__esModule") .forEach((key) => { if (exports.hasOwnProperty(key)) { return; } Object.defineProperty(exports, key, {enumerable: true, configurable: true, get: () => obj[key]}); }); } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7; var _class8; var _class9; var _class10; var _class11; var _class12; var _class13; var _class14; var _class15; var _class16; var _class17; var _class18; var _class19; var _class20; var _class21;const __vecto_cjs_url=require("url").pathToFileURL(__filename).href;
 
 
 
@@ -12,14 +12,14 @@
 
 
 
-var _chunkKRUDTGNRjs = require('./chunk-KRUDTGNR.js');
+var _chunkBKXERWADjs = require('./chunk-BKXERWAD.js');
 
 
 
 
 
 
-var _chunkPOPXUPKRjs = require('./chunk-POPXUPKR.js');
+var _chunkHC5EZOZJjs = require('./chunk-HC5EZOZJ.js');
 
 // src/tree/ComputeParticleEntity.ts
 var PARTICLE_STRIDE_FLOATS = 8;
@@ -31,7 +31,7 @@ var PARTICLE_OFFSET_ORIGIN_X = 4;
 var PARTICLE_OFFSET_ORIGIN_Y = 5;
 var PARTICLE_OFFSET_SIZE = 6;
 var PARTICLE_OFFSET_LIFE = 7;
-var ComputeParticleEntity = (_class = class extends _chunkPOPXUPKRjs.Entity {
+var ComputeParticleEntity = (_class = class extends _chunkHC5EZOZJjs.Entity {
   
   
   
@@ -1070,8 +1070,11 @@ var CanvasGeometry = (_class3 = class {
   /** Effective device pixel ratio, matching CanvasRenderer: real DPR clamped to
    *  `maxDPR` when set. */
   effectiveDPR(maxDPR) {
-    const real = typeof window !== "undefined" ? window.devicePixelRatio || 1 : 1;
-    return maxDPR !== void 0 ? Math.min(real, maxDPR) : real;
+    const raw = typeof window !== "undefined" ? window.devicePixelRatio : 1;
+    const real = Number.isFinite(raw) && raw > 0 ? raw : 1;
+    if (maxDPR === void 0) return real;
+    if (!Number.isFinite(maxDPR) || maxDPR <= 0) return real;
+    return Math.min(real, maxDPR);
   }
   /** Size the WebGPU particle canvas: backing store at logical × DPR, CSS box at
    *  the logical size. Sizing the backing store in logical px (the old
@@ -1596,6 +1599,62 @@ var HitTester = (_class6 = class {
   findEntityAt(x, y, frame, width, height) {
     const overlayHit = this.findHitRecursively(this.overlayRoot, x, y);
     if (overlayHit) return overlayHit;
+    return this.findMainTreeHit(x, y, frame, width, height);
+  }
+  /**
+   * The merged hit list (RFC5 §2, CTX-0600): the canvas spatial test plus
+   * caller-observed DOM-native candidates (mirror / portal / `dom-visual`
+   * extension point for CTX-0598) as ONE ordered candidate list.
+   *
+   * Query API only — no dispatch change: `findEntityAt` keeps its single
+   * topmost answer byte-for-byte. Coordinates enter in scene space (callers
+   * map client coordinates first, e.g. `Scene.findHitsAtClient`); backend
+   * attribution follows. DOM candidates pass through the same
+   * `disabled` / `pointerEvents: 'none'` predicate as the canvas paths
+   * (RFC5 §2 rule 4); the browser's hit test is their geometric authority,
+   * so scene-space `isPointInside` is not re-checked.
+   *
+   * Overlay order is authoritative (RFC5 §2 rule 2): overlay-subtree
+   * candidates sort above main-tree candidates, DOM-native backends above
+   * canvas within one subtree. Sorted descending by `priority`; ties keep
+   * insertion order (canvas overlay, canvas main, then DOM in caller order).
+   */
+  findHitsAt(x, y, frame, width, height, domCandidates = []) {
+    const results = [];
+    const overlayHit = this.findHitRecursively(this.overlayRoot, x, y);
+    if (overlayHit) results.push(this.toHitResult(overlayHit, "canvas", x, y));
+    const mainHit = this.findMainTreeHit(x, y, frame, width, height);
+    if (mainHit) results.push(this.toHitResult(mainHit, "canvas", x, y));
+    for (const candidate of domCandidates) {
+      if (!this.isHitEligible(candidate.node, x, y)) continue;
+      results.push(this.toHitResult(candidate.node, candidate.backend, x, y));
+    }
+    results.sort((a, b) => b.priority - a.priority);
+    return results;
+  }
+  /**
+   * Attribute one candidate: scene-space point plus node-local point, with
+   * the compositor-layer priority (overlay subtree above main tree,
+   * DOM-native backends above canvas within one subtree).
+   */
+  toHitResult(node, backend, x, y) {
+    return {
+      node,
+      backend,
+      localPoint: node.worldToLocal(x, y),
+      worldPoint: { x, y },
+      priority: (this.isInOverlaySubtree(node) ? 2 : 0) + (backend === "canvas" ? 0 : 1)
+    };
+  }
+  /** Whether `node` lives under the overlay root (drawn above the main tree). */
+  isInOverlaySubtree(node) {
+    for (let current = node; current; current = current.parent) {
+      if (current === this.overlayRoot) return true;
+    }
+    return false;
+  }
+  /** Main-tree arm of {@link findEntityAt}, shared with {@link findHitsAt}. */
+  findMainTreeHit(x, y, frame, width, height) {
     if (this.backends.hit && this.ensureHitGrid(frame, width, height)) {
       return this.findEntityAtWasm(x, y);
     }
@@ -3499,6 +3558,207 @@ function normalizeChord(input) {
   return ordered.join("+");
 }
 
+// src/tree/scene/SemanticProjectionPolicy.ts
+var DEFAULT_SEMANTIC_PROJECTION_POLICY = {
+  choose: () => "project"
+};
+function getSemanticProjectionCapabilities() {
+  return {
+    htmlInCanvas: supportsHTMLInCanvas(),
+    canvasTextRecovery: false
+  };
+}
+var CONTROL_SEMANTIC_ROLES = /* @__PURE__ */ new Set([
+  "button",
+  "link",
+  "checkbox",
+  "radio",
+  "switch",
+  "slider",
+  "spinbutton",
+  "combobox",
+  "listbox",
+  "option",
+  "menuitem",
+  "menuitemcheckbox",
+  "menuitemradio",
+  "tab",
+  "textbox",
+  "searchbox",
+  "progressbar",
+  "scrollbar",
+  "meter"
+]);
+function isDeferrableSemanticNode(node) {
+  const attrs = node.getA11yAttributes();
+  if (attrs.tag !== void 0 && attrs.tag !== "div") return false;
+  if (attrs.role !== void 0 && CONTROL_SEMANTIC_ROLES.has(attrs.role)) return false;
+  if (typeof attrs.tabIndex === "number" && attrs.tabIndex >= 0) return false;
+  const projection = _optionalChain([node, 'access', _86 => _86.getContentProjection, 'optionalCall', _87 => _87()]);
+  if (_optionalChain([projection, 'optionalAccess', _88 => _88.selectable])) return false;
+  return true;
+}
+function describeHTMLInCanvasSupport() {
+  if (typeof document === "undefined") return { supported: false, reason: "no-dom" };
+  try {
+    const canvas = document.createElement("canvas");
+    const ctx = canvas.getContext("2d");
+    const native2D = typeof CanvasRenderingContext2D !== "undefined" && ctx instanceof CanvasRenderingContext2D;
+    if (native2D && typeof ctx["drawElementImage"] === "function") {
+      return { supported: true };
+    }
+  } catch (e15) {
+    return { supported: false, reason: "no-backend" };
+  }
+  return { supported: false, reason: "no-backend" };
+}
+function supportsHTMLInCanvas() {
+  return describeHTMLInCanvasSupport().supported;
+}
+
+// src/tree/scene/ProjectionPolicy.ts
+var DEFAULT_PROJECTION_CAPABILITIES = {
+  /** Static text (short): findability already covered by content projection. */
+  text: {
+    domSupported: true,
+    nativeValue: "medium",
+    domCost: "low",
+    canvasCost: "low",
+    autoDefault: "canvas"
+  },
+  /** Long/selectable text, Markdown blocks: selection, Ctrl+F, translation. */
+  prose: {
+    domSupported: true,
+    nativeValue: "high",
+    domCost: "medium",
+    canvasCost: "high",
+    autoDefault: "dom"
+  },
+  /** Code blocks: selectable source, but canvas carriers already serve selection — rests canvas until measured (RFC4 §6 hybrid mapping). */
+  code: {
+    domSupported: true,
+    nativeValue: "medium",
+    domCost: "medium",
+    canvasCost: "high",
+    autoDefault: "canvas"
+  },
+  /** Text input / editable: IME, caret, clipboard, BiDi come free in DOM. */
+  input: {
+    domSupported: true,
+    nativeValue: "high",
+    domCost: "low",
+    canvasCost: "prohibitive",
+    autoDefault: "dom"
+  },
+  /** Button / Link: cheap either way, native wins on focus + AT clicks. */
+  button: {
+    domSupported: true,
+    nativeValue: "medium",
+    domCost: "low",
+    canvasCost: "low",
+    autoDefault: "dom"
+  },
+  link: {
+    domSupported: true,
+    nativeValue: "medium",
+    domCost: "low",
+    canvasCost: "low",
+    autoDefault: "dom"
+  },
+  /** Select / Dropdown / Checkbox / Radio: popup, keyboard, form semantics. */
+  select: {
+    domSupported: true,
+    nativeValue: "high",
+    domCost: "low",
+    canvasCost: "high",
+    autoDefault: "dom"
+  },
+  /** Container / layout group: no direct representation, children negotiate. */
+  container: {
+    domSupported: true,
+    nativeValue: "none",
+    domCost: "n/a",
+    canvasCost: "low",
+    autoDefault: "canvas"
+  },
+  /** Transform / camera rig: owns space, not pixels — never materialized. */
+  transform: {
+    domSupported: true,
+    nativeValue: "none",
+    domCost: "n/a",
+    canvasCost: "n/a",
+    autoDefault: "canvas"
+  },
+  /** Image / video frame: blit is cheap, one element per item is not. */
+  image: {
+    domSupported: true,
+    nativeValue: "low",
+    domCost: "medium",
+    canvasCost: "low",
+    autoDefault: "canvas"
+  },
+  /** Particles / danmaku / chart glyphs: bulk stays canvas, unconditionally. */
+  particles: {
+    domSupported: true,
+    nativeValue: "none",
+    domCost: "prohibitive",
+    canvasCost: "low",
+    autoDefault: "canvas"
+  },
+  /** Graph nodes/edges (interactive, moderate count): canvas until measured. */
+  graph: {
+    domSupported: true,
+    nativeValue: "low",
+    domCost: "medium",
+    canvasCost: "medium",
+    autoDefault: "canvas"
+  },
+  /** Custom shader / GPU particles: no DOM representation exists. */
+  shader: {
+    domSupported: false,
+    nativeValue: "none",
+    domCost: "unsupported",
+    canvasCost: "low",
+    autoDefault: "canvas"
+  }
+};
+var UNKNOWN_PROJECTION_CAPABILITY = {
+  domSupported: false,
+  nativeValue: "none",
+  domCost: "unsupported",
+  canvasCost: "low",
+  autoDefault: "canvas"
+};
+var PROJECTION_AUTO_HYSTERESIS_FRAMES = 3;
+var PROJECTION_AUTO_DOM_BUDGET = 500;
+function resolveProjection(want, cap, ctx) {
+  if (want === "canvas") return { resolved: "canvas", reason: null };
+  if (!ctx.hasDOM || !ctx.domBackendMounted) {
+    return { resolved: "canvas", reason: "no-dom-backend" };
+  }
+  if (!cap.domSupported) return { resolved: "canvas", reason: "unsupported-kind" };
+  if (want === "dom") {
+    if (cap.domCost === "prohibitive") return { resolved: "canvas", reason: "prohibitive-cost" };
+    return { resolved: "dom", reason: null };
+  }
+  if (cap.nativeValue === "high" && cap.domCost !== "prohibitive") {
+    return { resolved: "dom", reason: null };
+  }
+  if (cap.canvasCost === "prohibitive" && cap.domSupported) {
+    return { resolved: "dom", reason: null };
+  }
+  if (cap.autoDefault === "dom") return { resolved: "dom", reason: null };
+  return { resolved: "canvas", reason: null };
+}
+function hysteresisVote(current, desired, consecutive, hysteresisFrames) {
+  if (current === void 0 || current === desired) {
+    return { resolved: desired, consecutive: 0, flipped: false };
+  }
+  const next = consecutive + 1;
+  if (next >= hysteresisFrames) return { resolved: desired, consecutive: 0, flipped: true };
+  return { resolved: current, consecutive: next, flipped: false };
+}
+
 // src/tree/Scene.ts
 var RANGE_VALUE_ROLES = /* @__PURE__ */ new Set(["slider", "spinbutton", "progressbar", "scrollbar", "meter"]);
 var INTERACTIVE_A11Y_ROLES = /* @__PURE__ */ new Set([
@@ -3522,7 +3782,8 @@ var KEYBOARD_OWNING_ROLES = /* @__PURE__ */ new Set([
 ]);
 function ownsKeyboard(el) {
   if (!el) return false;
-  if (el === document.body || el === document.documentElement) return false;
+  if (typeof document !== "undefined" && (el === document.body || el === document.documentElement))
+    return false;
   if (el.hasAttribute("data-vecto-a11y-root")) return false;
   const tag = el.tagName;
   if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return true;
@@ -3562,6 +3823,7 @@ var SCENE_OPTION_KEYS = [
   "renderer",
   "renderMode",
   "respectReducedMotion",
+  "semanticProjectionPolicy",
   "userTiming"
 ];
 var SCENE_FIELD_NOT_OPTION = {
@@ -3678,9 +3940,9 @@ function parseCssMatrix(transform) {
 }
 function clientToGridLocal(contentEl, canvas, clientX, clientY) {
   const line = contentEl.querySelector("[data-vecto-grid-line]");
-  const originMarker = _optionalChain([line, 'optionalAccess', _86 => _86.querySelector, 'call', _87 => _87('[data-vecto-grid-basis="origin"]')]);
-  const xMarker = _optionalChain([line, 'optionalAccess', _88 => _88.querySelector, 'call', _89 => _89('[data-vecto-grid-basis="x"]')]);
-  const yMarker = _optionalChain([line, 'optionalAccess', _90 => _90.querySelector, 'call', _91 => _91('[data-vecto-grid-basis="y"]')]);
+  const originMarker = _optionalChain([line, 'optionalAccess', _89 => _89.querySelector, 'call', _90 => _90('[data-vecto-grid-basis="origin"]')]);
+  const xMarker = _optionalChain([line, 'optionalAccess', _91 => _91.querySelector, 'call', _92 => _92('[data-vecto-grid-basis="x"]')]);
+  const yMarker = _optionalChain([line, 'optionalAccess', _93 => _93.querySelector, 'call', _94 => _94('[data-vecto-grid-basis="y"]')]);
   if (line && originMarker && xMarker && yMarker) {
     const origin = originMarker.getBoundingClientRect();
     const xPoint = xMarker.getBoundingClientRect();
@@ -3764,7 +4026,7 @@ function nearestTextPositionInLine(line, x, y) {
       nearest = { position: { node, offset }, distance: candidate.distance };
     }
   }
-  return _nullishCoalesce(_optionalChain([nearest, 'optionalAccess', _92 => _92.position]), () => ( null));
+  return _nullishCoalesce(_optionalChain([nearest, 'optionalAccess', _95 => _95.position]), () => ( null));
 }
 function nearestTextPositionInProjection(contentEl, canvas, x, y, eventTarget) {
   if (contentEl.dataset.vectoContentGrid !== void 0) {
@@ -3778,7 +4040,7 @@ function nearestTextPositionInProjection(contentEl, canvas, x, y, eventTarget) {
     }
     targetLine = targetLine.parentElement;
   }
-  if (_optionalChain([targetLine, 'optionalAccess', _93 => _93.parentElement]) === contentEl) {
+  if (_optionalChain([targetLine, 'optionalAccess', _96 => _96.parentElement]) === contentEl) {
     return nearestTextPositionInLine(targetLine, x, y);
   }
   let bestLine = null;
@@ -3840,13 +4102,13 @@ function extendSelection(selection, anchor, focus) {
   try {
     selection.setBaseAndExtent(anchor.node, anchor.offset, focus.node, focus.offset);
     return;
-  } catch (e15) {
+  } catch (e16) {
   }
   try {
     selection.collapse(anchor.node, anchor.offset);
     selection.extend(focus.node, focus.offset);
     return;
-  } catch (e16) {
+  } catch (e17) {
   }
   const anchorRange = document.createRange();
   anchorRange.setStart(anchor.node, anchor.offset);
@@ -4040,7 +4302,7 @@ var Scene = (_class15 = class _Scene {
   __init108() {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', _94 => _94.reducedMotionQuery, 'optionalAccess', _95 => _95.matches]);
+    return this.respectReducedMotion && !!_optionalChain([this, 'access', _97 => _97.reducedMotionQuery, 'optionalAccess', _98 => _98.matches]);
   }
   /**
    * True when the OS is in a forced-colors mode (Windows High Contrast, and the
@@ -4051,7 +4313,7 @@ var Scene = (_class15 = class _Scene {
    * when the setting toggles.
    */
   get forcedColors() {
-    return !!_optionalChain([this, 'access', _96 => _96.forcedColorsQuery, 'optionalAccess', _97 => _97.matches]);
+    return !!_optionalChain([this, 'access', _99 => _99.forcedColorsQuery, 'optionalAccess', _100 => _100.matches]);
   }
   // --- domain: a11y-projection — sync throttle and shadow-DOM state ---
   /**
@@ -4059,21 +4321,41 @@ var Scene = (_class15 = class _Scene {
    * frame. See {@link SceneOptions.a11ySyncInterval}.
    */
   __init109() {this.a11ySyncInterval = 0}
+  /**
+   * Per-node semantic projection policy (RFC3 §5, CTX-0599). Consulted once
+   * per node by {@link shouldProjectA11y}; the default projects everything
+   * the legacy predicate projects, so reassigning nothing changes nothing.
+   * See {@link SceneOptions.semanticProjectionPolicy}.
+   */
+  __init110() {this.semanticProjectionPolicy = DEFAULT_SEMANTIC_PROJECTION_POLICY}
+  /**
+   * Consecutive syncs an `'auto'`-policy node must keep voting for the other
+   * backend before its sticky resolution flips (RFC4 §3 rule 3, CTX-0601).
+   * Documented tunable — see {@link PROJECTION_AUTO_HYSTERESIS_FRAMES}.
+   */
+  __init111() {this.projectionHysteresisFrames = PROJECTION_AUTO_HYSTERESIS_FRAMES}
+  /**
+   * Maximum `'auto'`-resolved DOM residents per scene per frame (RFC4 §4
+   * particle-row backstop: bulk-count nodes stay canvas). Explicit `'dom'`
+   * requests bypass it. Documented tunable — see
+   * {@link PROJECTION_AUTO_DOM_BUDGET}.
+   */
+  __init112() {this.projectionAutoDomBudget = PROJECTION_AUTO_DOM_BUDGET}
   /** Timestamp of the last a11y sync, for throttling. */
-  __init110() {this.lastA11ySync = -Infinity}
+  __init113() {this.lastA11ySync = -Infinity}
   /** True if we skipped an a11y sync during animation and need to sync when at rest. */
-  __init111() {this.a11yPendingSyncAfterAnimation = false}
+  __init114() {this.a11yPendingSyncAfterAnimation = false}
   // A11y / Automation Layer. `null` in non-DOM (SSR/Node) environments — the
   // whole projection degrades to a no-op so the engine's logic stays usable
   // server-side (e.g. headless layout / vector export) without jsdom.
   
-  __init112() {this.a11yElements = /* @__PURE__ */ new Map()}
+  __init115() {this.a11yElements = /* @__PURE__ */ new Map()}
   /** Elements that already have the synthetic Enter/Space activation handler
    *  (see the syncA11y refresh pass) — install-once bookkeeping (#694). */
-  __init113() {this.keyboardActivatedA11y = /* @__PURE__ */ new WeakSet()}
+  __init116() {this.keyboardActivatedA11y = /* @__PURE__ */ new WeakSet()}
   // --- domain: content-projection — projected DOM, sync state, calibration, selection ---
   /** DOM nodes mirroring static text content, keyed by entity id. */
-  __init114() {this.contentElements = /* @__PURE__ */ new Map()}
+  __init117() {this.contentElements = /* @__PURE__ */ new Map()}
   /**
    * What the last completed content-projection sync was built from, per entity.
    *
@@ -4082,9 +4364,9 @@ var Scene = (_class15 = class _Scene {
    * build. Only populated for entities that opt in via
    * {@link Entity.getContentEpoch}. (carryctx CTX-0199)
    */
-  __init115() {this.contentSyncState = /* @__PURE__ */ new Map()}
+  __init118() {this.contentSyncState = /* @__PURE__ */ new Map()}
   /** Invalidates grid font calibration after browser font availability changes. */
-  __init116() {this.contentFontEpoch = 0}
+  __init119() {this.contentFontEpoch = 0}
   /**
    * Bumped whenever the viewport itself changes shape, which re-tiers blocks
    * without moving any of them.
@@ -4097,7 +4379,7 @@ var Scene = (_class15 = class _Scene {
    * carriers it no longer needs. Scrolling needs no such epoch: it moves the root,
    * so every block's parent world transform changes and the check fails honestly.
    */
-  __init117() {this.contentViewportEpoch = 0}
+  __init120() {this.contentViewportEpoch = 0}
   /**
    * One-entry memo for a parent's world transform, held as scalars.
    *
@@ -4112,16 +4394,16 @@ var Scene = (_class15 = class _Scene {
    * sync, so a memo can never survive into a frame in which the parent has
    * moved.
    */
-  __init118() {this._pwNode = null}
-  __init119() {this._pwSerial = -1}
-  __init120() {this._pwa = 1}
-  __init121() {this._pwb = 0}
-  __init122() {this._pwc = 0}
-  __init123() {this._pwd = 1}
-  __init124() {this._pwe = 0}
-  __init125() {this._pwf = 0}
+  __init121() {this._pwNode = null}
+  __init122() {this._pwSerial = -1}
+  __init123() {this._pwa = 1}
+  __init124() {this._pwb = 0}
+  __init125() {this._pwc = 0}
+  __init126() {this._pwd = 1}
+  __init127() {this._pwe = 0}
+  __init128() {this._pwf = 0}
   /** Incremented once per top-level `syncA11y`, invalidating `_pwNode`. */
-  __init126() {this._syncSerial = 0}
+  __init129() {this._syncSerial = 0}
   /**
    * Disables the settled-walk fast path in {@link syncContentProjection}.
    *
@@ -4133,38 +4415,38 @@ var Scene = (_class15 = class _Scene {
    * Not part of the public API and not documented as an option: turning it on only
    * makes a settled document slower, never more correct.
    */
-  __init127() {this.disableSettledFastPath = false}
+  __init130() {this.disableSettledFastPath = false}
   /** Cached Canvas-to-client scale for the current font/viewport epoch. */
-  __init128() {this.contentMetricScaleEpoch = -1}
-  __init129() {this.contentMetricScaleX = 1}
-  __init130() {this.contentProjectionEnabled = true}
+  __init131() {this.contentMetricScaleEpoch = -1}
+  __init132() {this.contentMetricScaleX = 1}
+  __init133() {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).
-  __init131() {this.contentProjectionMargin = void 0}
+  __init134() {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.
-  __init132() {this.contentSemanticMargin = void 0}
+  __init135() {this.contentSemanticMargin = void 0}
   // How many coarse-tier blocks may be MATERIALIZED per sync, spreading the
   // resident tier's document-open cost across frames. `Infinity` = one
   // synchronous pass.
-  __init133() {this.contentSemanticBudget = DEFAULT_CONTENT_SEMANTIC_BUDGET}
+  __init136() {this.contentSemanticBudget = DEFAULT_CONTENT_SEMANTIC_BUDGET}
   // Remaining materializations in the CURRENT sync. Reset at the start of each
   // a11y walk; decremented per coarse block that creates its element.
-  __init134() {this.contentSemanticBudgetLeft = 0}
+  __init137() {this.contentSemanticBudgetLeft = 0}
   // Set when a sync deferred at least one block, so the scene knows to keep
   // drawing frames until the resident tier is complete. Without it a static
   // scene in `onDemand` mode would stop rendering with the document half
   // materialized and never finish.
-  __init135() {this.contentSemanticDeferred = false}
-  __init136() {this.contentSelectionEndListener = null}
+  __init138() {this.contentSemanticDeferred = false}
+  __init139() {this.contentSelectionEndListener = null}
   // --- domain: render-scheduler — per-frame walk flags ---
   // Animation/interactive flags collected during the render walk (tree-walk
   // fusion): the loop reads last frame's answers instead of re-walking the
   // tree up to 4× per tick. Start true so the first tick stays conservative.
-  __init137() {this.frameHadAnimation = true}
-  __init138() {this.frameHadInteractive = true}
+  __init140() {this.frameHadAnimation = true}
+  __init141() {this.frameHadInteractive = true}
   // --- domain: context-and-resize — resize handler, DPR query, canvas observer ---
   
   /** Active `(resolution: Ndppx)` media query watching for a runtime DPR change
@@ -4172,15 +4454,17 @@ var Scene = (_class15 = class _Scene {
    *  can be re-scaled — otherwise it stays rasterized at the old DPR and blurs.
    *  A resolution media query only fires when leaving its exact value, so the
    *  handler re-arms a fresh query for the new DPR each time. */
-  __init139() {this.dprMediaQuery = null}
+  __init142() {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. */
-  __init140() {this.canvasResizeObserver = null}
-  __init141() {this.dprChangeHandler = null}
+  __init143() {this.canvasResizeObserver = null}
+  __init144() {this.dprChangeHandler = null}
+  __init145() {this.dprPollInterval = null}
+  __init146() {this.lastDpr = 1}
   // --- domain: a11y-projection — focus, overlay geometry, DOM ordering, portals ---
-  __init142() {this.focusedA11yElement = null}
+  __init147() {this.focusedA11yElement = null}
   /**
    * Canvas box geometry: the CSS↔logical mapping, overlay layer alignment, and
    * the DPR math (extraction 5, `DEC-0024`).
@@ -4207,7 +4491,7 @@ var Scene = (_class15 = class _Scene {
   /** Shadow elements the pointer is currently inside. Lets a removal that happens
    *  mid-hover synthesize the `pointerleave` the browser never sends for a
    *  detached element, so the entity doesn't keep its hover state. */
-  __init143() {this.hoveredA11yElements = /* @__PURE__ */ new WeakSet()}
+  __init148() {this.hoveredA11yElements = /* @__PURE__ */ new WeakSet()}
   /**
    * Entity ids the application has pinned via {@link requestA11yProjection}.
    *
@@ -4215,13 +4499,13 @@ var Scene = (_class15 = class _Scene {
    * a stale id simply never matches. Cleared per-entity by
    * {@link releaseA11yProjection}.
    */
-  __init144() {this.a11yProjectionRequests = /* @__PURE__ */ new Set()}
+  __init149() {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. */
-  __init145() {this.focusSentinel = null}
-  __init146() {this.caretBlinkTimer = null}
+  __init150() {this.focusSentinel = null}
+  __init151() {this.caretBlinkTimer = null}
   /**
    * The projected DOM's ordering engine — the reorder flag, the per-pass scratch
    * collections, the visual reading-order sort and the cursor-based
@@ -4231,7 +4515,7 @@ var Scene = (_class15 = class _Scene {
    * delegate here; the collect-and-prune walk stays behind because it needs
    * {@link shouldProjectA11y} and the focus/caret state.
    */
-  __init147() {this.a11yOrder = new A11yProjectionManager()}
+  __init152() {this.a11yOrder = new A11yProjectionManager()}
   /**
    * The content projection's selection preservation and grid calibration
    * (extraction 3, `DEC-0022`).
@@ -4283,11 +4567,35 @@ var Scene = (_class15 = class _Scene {
   set a11yNeedsReorder(value) {
     this.a11yOrder.needsReorder = value;
   }
-  __init148() {this.portalRoot = null}
-  __init149() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
-  __init150() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
-  __init151() {this.portalEntities = /* @__PURE__ */ new Map()}
-  __init152() {this.renderOrderCounter = 0}
+  __init153() {this.portalRoot = null}
+  __init154() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
+  __init155() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
+  __init156() {this.portalEntities = /* @__PURE__ */ new Map()}
+  /**
+   * Generic projection backends (RFC1 §5 vocabulary, `tree/scene/ProjectionBackend.ts`).
+   * Render-independent: the interface exchanges only node identity, world
+   * matrix, and lifecycle calls, so registering a DOM backend adds no
+   * `HTMLElement` surface to core. `@vectojs/dom` owns the only implementation.
+   */
+  __init157() {this.projectionBackends = []}
+  /** Per-frame seen-sets driving {@link pruneProjectionBackends} (portal-precedent). */
+  __init158() {this.domSeenPrevFrame = /* @__PURE__ */ new Set()}
+  __init159() {this.domSeenThisFrame = /* @__PURE__ */ new Set()}
+  __init160() {this.domSeenNodes = /* @__PURE__ */ new Map()}
+  /**
+   * Negotiation state (RFC4 §3, CTX-0601): last resolution per node (the
+   * per-scene queryable surface behind {@link getProjectionResolutions}),
+   * hysteresis votes, per-kind capability overrides, and explicit gesture
+   * pins. Plain data only — no `HTMLElement` surface in core.
+   */
+  __init161() {this.projectionResolutions = /* @__PURE__ */ new Map()}
+  __init162() {this.projectionHysteresis = /* @__PURE__ */ new Map()}
+  __init163() {this.projectionCapabilityOverrides = /* @__PURE__ */ new Map()}
+  __init164() {this.projectionGesturePins = /* @__PURE__ */ new Map()}
+  /** Frame id the `'auto'` DOM budget count belongs to (bulk backstop). */
+  __init165() {this.projectionBudgetFrame = -1}
+  __init166() {this.projectionDomAutoCount = 0}
+  __init167() {this.renderOrderCounter = 0}
   // --- domain: render-scheduler — authoritative frame counter ---
   /**
    * Monotonic render-frame counter, bumped once per authoritative `render()`
@@ -4297,7 +4605,7 @@ var Scene = (_class15 = class _Scene {
    * back to the ancestor walk. Public for the same reason `Entity._getTrig`/
    * `_setWorldCache` are: it is a cross-class render-internal contract.
    */
-  __init153() {this.currentFrame = 0}
+  __init168() {this.currentFrame = 0}
   // --- domain: wasm-backend-facade — EXTRACTED (see scene/WasmBackendFacade.ts) ---
   /**
    * The four invisible WASM accelerators and the resident transform store.
@@ -4367,8 +4675,8 @@ var Scene = (_class15 = class _Scene {
   // Stays on `Scene`: it walks `root` *and* `overlayRoot` for entities the
   // render walk consumes, so only its cache key is store state. The facade owns
   // the key; the walk stays here.
-  __init154() {this._computeEntities = []}
-  __init155() {this._computeEntitiesVersion = -1}
+  __init169() {this._computeEntities = []}
+  __init170() {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() {
@@ -4607,7 +4915,7 @@ var Scene = (_class15 = class _Scene {
   get animBatchedLastFrame() {
     return this._wasmBackend.animBatchedLastFrame;
   }
-  __init156() {this.animGate = {
+  __init171() {this.animGate = {
     spring: 128,
     tween: 256,
     mixed: 128
@@ -4703,7 +5011,7 @@ var Scene = (_class15 = class _Scene {
    * `tickDrivers()`'s per-frame stamp would skip it a full frame — a one-frame
    * JS/WASM divergence. Written in {@link render} next to `_tickBatchedDrivers`.
    */
-  __init157() {this._updateWalkDt = null}
+  __init172() {this._updateWalkDt = null}
   // --- domain: render-scheduler — batched driver tick (extraction 6), reads the anim backend ---
   /**
    * Advance every registered entity's active drivers for this frame, batching
@@ -4731,25 +5039,25 @@ var Scene = (_class15 = class _Scene {
    * sync, so retaining the order prevents a newly opened overlay from spending
    * its first frame below previously projected controls.
    */
-  __init158() {this.a11yRenderOrders = /* @__PURE__ */ new Map()}
+  __init173() {this.a11yRenderOrders = /* @__PURE__ */ new Map()}
   // --- domain: context-and-resize — GL/GPU canvases, device state, pointer, size warnings ---
   // Optional WebGL point-cloud layer (see SceneOptions.pointBackend).
-  __init159() {this.pointRenderer = null}
-  __init160() {this.glCanvas = null}
-  __init161() {this.glContextLostHandler = null}
-  __init162() {this.glContextRestoredHandler = null}
+  __init174() {this.pointRenderer = null}
+  __init175() {this.glCanvas = null}
+  __init176() {this.glContextLostHandler = null}
+  __init177() {this.glContextRestoredHandler = null}
   
   
   
-  __init163() {this.disableWindowResize = false}
+  __init178() {this.disableWindowResize = false}
   /** See {@link SceneOptions.maxDPR}. `undefined` = uncapped (real DPR). */
   
   // WebGPU properties
-  __init164() {this.destroyed = false}
-  __init165() {this.device = null}
-  __init166() {this.deviceLost = false}
-  __init167() {this.particleBackend = "auto"}
-  __init168() {this._webgpuDisabled = false}
+  __init179() {this.destroyed = false}
+  __init180() {this.device = null}
+  __init181() {this.deviceLost = false}
+  __init182() {this.particleBackend = "auto"}
+  __init183() {this._webgpuDisabled = false}
   get webgpuDisabled() {
     return this._webgpuDisabled || this.particleBackend === "cpu";
   }
@@ -4763,7 +5071,7 @@ var Scene = (_class15 = class _Scene {
    * active.
    */
   get webglDrawStats() {
-    return _nullishCoalesce(_optionalChain([this, 'access', _98 => _98.pointRenderer, 'optionalAccess', _99 => _99.stats, 'optionalCall', _100 => _100()]), () => ( null));
+    return _nullishCoalesce(_optionalChain([this, 'access', _101 => _101.pointRenderer, 'optionalAccess', _102 => _102.stats, 'optionalCall', _103 => _103()]), () => ( null));
   }
   /**
    * Whether a WebGPU device is currently live for particle compute.
@@ -4777,28 +5085,28 @@ var Scene = (_class15 = class _Scene {
   set webgpuDisabled(value) {
     this._webgpuDisabled = value;
   }
-  __init169() {this.recoveryTimerId = null}
-  __init170() {this.manager = null}
-  __init171() {this.initializingWebGPU = false}
-  __init172() {this.gpuCanvas = null}
-  __init173() {this.gpuContext = null}
+  __init184() {this.recoveryTimerId = null}
+  __init185() {this.manager = null}
+  __init186() {this.initializingWebGPU = false}
+  __init187() {this.gpuCanvas = null}
+  __init188() {this.gpuContext = null}
   /** True while the GPU canvas holds a presented particle frame (needs clearing when they leave). */
-  __init174() {this.gpuHasContent = false}
-  __init175() {this.mouseX = -9999}
-  __init176() {this.mouseY = -9999}
-  __init177() {this.pointerMoveListener = null}
-  __init178() {this.pointerLeaveListener = null}
+  __init189() {this.gpuHasContent = false}
+  __init190() {this.mouseX = -9999}
+  __init191() {this.mouseY = -9999}
+  __init192() {this.pointerMoveListener = null}
+  __init193() {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. */
-  __init179() {this.pointerEventTarget = null}
+  __init194() {this.pointerEventTarget = null}
   // --- scene-level keyboard channel state (see on/off/registerShortcut) ---
-  __init180() {this.keydownHandlers = []}
-  __init181() {this.keyupHandlers = []}
+  __init195() {this.keydownHandlers = []}
+  __init196() {this.keyupHandlers = []}
   /** Chord-normalized shortcut table, matched on keydown only. */
-  __init182() {this.shortcuts = []}
-  __init183() {this.windowKeyDownHandler = null}
-  __init184() {this.windowKeyUpHandler = null}
-  __init185() {this.hasWarnedZeroSize = false}
+  __init197() {this.shortcuts = []}
+  __init198() {this.windowKeyDownHandler = null}
+  __init199() {this.windowKeyUpHandler = null}
+  __init200() {this.hasWarnedZeroSize = false}
   /**
    * Latch for {@link Scene.resize}'s invalid-dimension warning.
    *
@@ -4808,8 +5116,8 @@ var Scene = (_class15 = class _Scene {
    * because `resize()` is commonly driven from a `ResizeObserver`, which would
    * otherwise warn on every frame of a drag.
    */
-  __init186() {this.hasWarnedInvalidResize = false}
-  __init187() {this.fontLoadHandler = null}
+  __init201() {this.hasWarnedInvalidResize = false}
+  __init202() {this.fontLoadHandler = null}
   // --- domain: scene-facade — dev-mode diagnostics ---
   // ── Dev-mode warning infrastructure ──────────────────────────────
   //
@@ -4834,17 +5142,17 @@ var Scene = (_class15 = class _Scene {
   }
   static set devMode(active) {
     _Scene._devMode = active;
-    _chunkKRUDTGNRjs.setRendererDevMode.call(void 0, active);
+    _chunkBKXERWADjs.setRendererDevMode.call(void 0, active);
   }
   static _devModeDetected() {
     if (_Scene._devMode) return true;
     const gp = typeof globalThis !== "undefined" ? globalThis : void 0;
-    if (_optionalChain([gp, 'optionalAccess', _101 => _101.__DEV__])) return true;
-    if (_optionalChain([gp, 'optionalAccess', _102 => _102.process, 'optionalAccess', _103 => _103.env, 'optionalAccess', _104 => _104.NODE_ENV]) === "development") return true;
+    if (_optionalChain([gp, 'optionalAccess', _104 => _104.__DEV__])) return true;
+    if (_optionalChain([gp, 'optionalAccess', _105 => _105.process, 'optionalAccess', _106 => _106.env, 'optionalAccess', _107 => _107.NODE_ENV]) === "development") return true;
     return false;
   }
   
-  __init188() {this._devFrameCount = 0}
+  __init203() {this._devFrameCount = 0}
   _devWarn(message) {
     if (!this._devActive) return;
     console.warn(`[vectojs/dev] ${message}`);
@@ -4902,9 +5210,9 @@ var Scene = (_class15 = class _Scene {
     let checked = 0;
     const walkProjections = (node) => {
       if (checked > 10) return;
-      const proj = _optionalChain([node, 'access', _105 => _105.getContentProjection, 'optionalCall', _106 => _106()]);
-      if (_optionalChain([proj, 'optionalAccess', _107 => _107.text]) && proj.selectable !== false) {
-        const el = _optionalChain([this, 'access', _108 => _108.contentElements, 'optionalAccess', _109 => _109.get, 'call', _110 => _110(node.id)]);
+      const proj = _optionalChain([node, 'access', _108 => _108.getContentProjection, 'optionalCall', _109 => _109()]);
+      if (_optionalChain([proj, 'optionalAccess', _110 => _110.text]) && proj.selectable !== false) {
+        const el = _optionalChain([this, 'access', _111 => _111.contentElements, 'optionalAccess', _112 => _112.get, 'call', _113 => _113(node.id)]);
         if (el) {
           const projectedText = el.textContent || "";
           const windowed = el.dataset.vectoProjectionWindow !== void 0;
@@ -4922,22 +5230,27 @@ var Scene = (_class15 = class _Scene {
     walkProjections(this.root);
   }
   // --- domain: scene-facade — construction (wires every collaborator) ---
-  constructor(canvas, options = {}) {;_class15.prototype.__init88.call(this);_class15.prototype.__init89.call(this);_class15.prototype.__init90.call(this);_class15.prototype.__init91.call(this);_class15.prototype.__init92.call(this);_class15.prototype.__init93.call(this);_class15.prototype.__init94.call(this);_class15.prototype.__init95.call(this);_class15.prototype.__init96.call(this);_class15.prototype.__init97.call(this);_class15.prototype.__init98.call(this);_class15.prototype.__init99.call(this);_class15.prototype.__init100.call(this);_class15.prototype.__init101.call(this);_class15.prototype.__init102.call(this);_class15.prototype.__init103.call(this);_class15.prototype.__init104.call(this);_class15.prototype.__init105.call(this);_class15.prototype.__init106.call(this);_class15.prototype.__init107.call(this);_class15.prototype.__init108.call(this);_class15.prototype.__init109.call(this);_class15.prototype.__init110.call(this);_class15.prototype.__init111.call(this);_class15.prototype.__init112.call(this);_class15.prototype.__init113.call(this);_class15.prototype.__init114.call(this);_class15.prototype.__init115.call(this);_class15.prototype.__init116.call(this);_class15.prototype.__init117.call(this);_class15.prototype.__init118.call(this);_class15.prototype.__init119.call(this);_class15.prototype.__init120.call(this);_class15.prototype.__init121.call(this);_class15.prototype.__init122.call(this);_class15.prototype.__init123.call(this);_class15.prototype.__init124.call(this);_class15.prototype.__init125.call(this);_class15.prototype.__init126.call(this);_class15.prototype.__init127.call(this);_class15.prototype.__init128.call(this);_class15.prototype.__init129.call(this);_class15.prototype.__init130.call(this);_class15.prototype.__init131.call(this);_class15.prototype.__init132.call(this);_class15.prototype.__init133.call(this);_class15.prototype.__init134.call(this);_class15.prototype.__init135.call(this);_class15.prototype.__init136.call(this);_class15.prototype.__init137.call(this);_class15.prototype.__init138.call(this);_class15.prototype.__init139.call(this);_class15.prototype.__init140.call(this);_class15.prototype.__init141.call(this);_class15.prototype.__init142.call(this);_class15.prototype.__init143.call(this);_class15.prototype.__init144.call(this);_class15.prototype.__init145.call(this);_class15.prototype.__init146.call(this);_class15.prototype.__init147.call(this);_class15.prototype.__init148.call(this);_class15.prototype.__init149.call(this);_class15.prototype.__init150.call(this);_class15.prototype.__init151.call(this);_class15.prototype.__init152.call(this);_class15.prototype.__init153.call(this);_class15.prototype.__init154.call(this);_class15.prototype.__init155.call(this);_class15.prototype.__init156.call(this);_class15.prototype.__init157.call(this);_class15.prototype.__init158.call(this);_class15.prototype.__init159.call(this);_class15.prototype.__init160.call(this);_class15.prototype.__init161.call(this);_class15.prototype.__init162.call(this);_class15.prototype.__init163.call(this);_class15.prototype.__init164.call(this);_class15.prototype.__init165.call(this);_class15.prototype.__init166.call(this);_class15.prototype.__init167.call(this);_class15.prototype.__init168.call(this);_class15.prototype.__init169.call(this);_class15.prototype.__init170.call(this);_class15.prototype.__init171.call(this);_class15.prototype.__init172.call(this);_class15.prototype.__init173.call(this);_class15.prototype.__init174.call(this);_class15.prototype.__init175.call(this);_class15.prototype.__init176.call(this);_class15.prototype.__init177.call(this);_class15.prototype.__init178.call(this);_class15.prototype.__init179.call(this);_class15.prototype.__init180.call(this);_class15.prototype.__init181.call(this);_class15.prototype.__init182.call(this);_class15.prototype.__init183.call(this);_class15.prototype.__init184.call(this);_class15.prototype.__init185.call(this);_class15.prototype.__init186.call(this);_class15.prototype.__init187.call(this);_class15.prototype.__init188.call(this);
+  constructor(canvas, options = {}) {;_class15.prototype.__init88.call(this);_class15.prototype.__init89.call(this);_class15.prototype.__init90.call(this);_class15.prototype.__init91.call(this);_class15.prototype.__init92.call(this);_class15.prototype.__init93.call(this);_class15.prototype.__init94.call(this);_class15.prototype.__init95.call(this);_class15.prototype.__init96.call(this);_class15.prototype.__init97.call(this);_class15.prototype.__init98.call(this);_class15.prototype.__init99.call(this);_class15.prototype.__init100.call(this);_class15.prototype.__init101.call(this);_class15.prototype.__init102.call(this);_class15.prototype.__init103.call(this);_class15.prototype.__init104.call(this);_class15.prototype.__init105.call(this);_class15.prototype.__init106.call(this);_class15.prototype.__init107.call(this);_class15.prototype.__init108.call(this);_class15.prototype.__init109.call(this);_class15.prototype.__init110.call(this);_class15.prototype.__init111.call(this);_class15.prototype.__init112.call(this);_class15.prototype.__init113.call(this);_class15.prototype.__init114.call(this);_class15.prototype.__init115.call(this);_class15.prototype.__init116.call(this);_class15.prototype.__init117.call(this);_class15.prototype.__init118.call(this);_class15.prototype.__init119.call(this);_class15.prototype.__init120.call(this);_class15.prototype.__init121.call(this);_class15.prototype.__init122.call(this);_class15.prototype.__init123.call(this);_class15.prototype.__init124.call(this);_class15.prototype.__init125.call(this);_class15.prototype.__init126.call(this);_class15.prototype.__init127.call(this);_class15.prototype.__init128.call(this);_class15.prototype.__init129.call(this);_class15.prototype.__init130.call(this);_class15.prototype.__init131.call(this);_class15.prototype.__init132.call(this);_class15.prototype.__init133.call(this);_class15.prototype.__init134.call(this);_class15.prototype.__init135.call(this);_class15.prototype.__init136.call(this);_class15.prototype.__init137.call(this);_class15.prototype.__init138.call(this);_class15.prototype.__init139.call(this);_class15.prototype.__init140.call(this);_class15.prototype.__init141.call(this);_class15.prototype.__init142.call(this);_class15.prototype.__init143.call(this);_class15.prototype.__init144.call(this);_class15.prototype.__init145.call(this);_class15.prototype.__init146.call(this);_class15.prototype.__init147.call(this);_class15.prototype.__init148.call(this);_class15.prototype.__init149.call(this);_class15.prototype.__init150.call(this);_class15.prototype.__init151.call(this);_class15.prototype.__init152.call(this);_class15.prototype.__init153.call(this);_class15.prototype.__init154.call(this);_class15.prototype.__init155.call(this);_class15.prototype.__init156.call(this);_class15.prototype.__init157.call(this);_class15.prototype.__init158.call(this);_class15.prototype.__init159.call(this);_class15.prototype.__init160.call(this);_class15.prototype.__init161.call(this);_class15.prototype.__init162.call(this);_class15.prototype.__init163.call(this);_class15.prototype.__init164.call(this);_class15.prototype.__init165.call(this);_class15.prototype.__init166.call(this);_class15.prototype.__init167.call(this);_class15.prototype.__init168.call(this);_class15.prototype.__init169.call(this);_class15.prototype.__init170.call(this);_class15.prototype.__init171.call(this);_class15.prototype.__init172.call(this);_class15.prototype.__init173.call(this);_class15.prototype.__init174.call(this);_class15.prototype.__init175.call(this);_class15.prototype.__init176.call(this);_class15.prototype.__init177.call(this);_class15.prototype.__init178.call(this);_class15.prototype.__init179.call(this);_class15.prototype.__init180.call(this);_class15.prototype.__init181.call(this);_class15.prototype.__init182.call(this);_class15.prototype.__init183.call(this);_class15.prototype.__init184.call(this);_class15.prototype.__init185.call(this);_class15.prototype.__init186.call(this);_class15.prototype.__init187.call(this);_class15.prototype.__init188.call(this);_class15.prototype.__init189.call(this);_class15.prototype.__init190.call(this);_class15.prototype.__init191.call(this);_class15.prototype.__init192.call(this);_class15.prototype.__init193.call(this);_class15.prototype.__init194.call(this);_class15.prototype.__init195.call(this);_class15.prototype.__init196.call(this);_class15.prototype.__init197.call(this);_class15.prototype.__init198.call(this);_class15.prototype.__init199.call(this);_class15.prototype.__init200.call(this);_class15.prototype.__init201.call(this);_class15.prototype.__init202.call(this);_class15.prototype.__init203.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', _111 => _111.style, 'optionalAccess', _112 => _112.width]));
-      const styleHeight = parseInlinePx(_optionalChain([canvas, 'access', _113 => _113.style, 'optionalAccess', _114 => _114.height]));
+      const styleWidth = parseInlinePx(_optionalChain([canvas, 'access', _114 => _114.style, 'optionalAccess', _115 => _115.width]));
+      const styleHeight = parseInlinePx(_optionalChain([canvas, 'access', _116 => _116.style, 'optionalAccess', _117 => _117.height]));
       this.width = _nullishCoalesce(styleWidth, () => ( (canvas.width || canvas.clientWidth || 0)));
       this.height = _nullishCoalesce(styleHeight, () => ( (canvas.height || canvas.clientHeight || 0)));
     } else {
-      this.width = typeof window !== "undefined" ? window.innerWidth : canvas.clientWidth || canvas.width || 800;
-      this.height = typeof window !== "undefined" ? window.innerHeight : canvas.clientHeight || canvas.height || 600;
+      if (typeof canvas.isConnected === "boolean" && !canvas.isConnected) {
+        this.width = 0;
+        this.height = 0;
+      } else {
+        this.width = typeof window !== "undefined" ? window.innerWidth : canvas.clientWidth || canvas.width || 800;
+        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', _115 => _115.env, 'optionalAccess', _116 => _116.NODE_ENV]) === "test" || _optionalChain([globalProcess, 'access', _117 => _117.env, 'optionalAccess', _118 => _118.VITEST]) === "true");
+    const isTest = globalProcess && (_optionalChain([globalProcess, 'access', _118 => _118.env, 'optionalAccess', _119 => _119.NODE_ENV]) === "test" || _optionalChain([globalProcess, 'access', _120 => _120.env, 'optionalAccess', _121 => _121.VITEST]) === "true");
     this.maxFPS = _nullishCoalesce(options.maxFPS, () => ( (isTest ? 0 : 60)));
     this.respectReducedMotion = _nullishCoalesce(options.respectReducedMotion, () => ( true));
     this.autoThrottle = _nullishCoalesce(options.autoThrottle, () => ( true));
@@ -4945,6 +5258,9 @@ var Scene = (_class15 = class _Scene {
     this.phases.userTiming = _nullishCoalesce(options.userTiming, () => ( false));
     this.particleBackend = _nullishCoalesce(options.particleBackend, () => ( "auto"));
     this.a11ySyncInterval = _nullishCoalesce(options.a11ySyncInterval, () => ( 0));
+    this.semanticProjectionPolicy = _nullishCoalesce(options.semanticProjectionPolicy, () => ( DEFAULT_SEMANTIC_PROJECTION_POLICY));
+    this.projectionHysteresisFrames = _nullishCoalesce(options.projectionHysteresisFrames, () => ( PROJECTION_AUTO_HYSTERESIS_FRAMES));
+    this.projectionAutoDomBudget = _nullishCoalesce(options.projectionAutoDomBudget, () => ( PROJECTION_AUTO_DOM_BUDGET));
     this.contentProjectionEnabled = _nullishCoalesce(options.contentProjection, () => ( true));
     this.contentProjectionMargin = options.contentProjectionMargin;
     this.contentSemanticMargin = options.contentSemanticMargin;
@@ -4952,15 +5268,15 @@ var Scene = (_class15 = class _Scene {
     this.readingDirection = _nullishCoalesce(options.readingDirection, () => ( "ltr"));
     this.renderMode = _nullishCoalesce(options.renderMode, () => ( "always"));
     this._devActive = _Scene._devModeDetected();
-    _chunkKRUDTGNRjs.setRendererDevMode.call(void 0, this._devActive);
+    _chunkBKXERWADjs.setRendererDevMode.call(void 0, this._devActive);
     this._warnUnknownOptions(options);
     this.reducedMotionQuery = typeof window !== "undefined" && typeof window.matchMedia === "function" ? window.matchMedia("(prefers-reduced-motion: reduce)") : null;
     if (typeof window !== "undefined" && typeof window.matchMedia === "function") {
       this.forcedColorsQuery = window.matchMedia("(forced-colors: active)");
       this.forcedColorsChangeHandler = () => this.markDirty();
-      _optionalChain([this, 'access', _119 => _119.forcedColorsQuery, 'access', _120 => _120.addEventListener, 'optionalCall', _121 => _121("change", this.forcedColorsChangeHandler)]);
+      _optionalChain([this, 'access', _122 => _122.forcedColorsQuery, 'access', _123 => _123.addEventListener, 'optionalCall', _124 => _124("change", this.forcedColorsChangeHandler)]);
     }
-    this.root = new class RootEntity extends _chunkPOPXUPKRjs.Entity {
+    this.root = new class RootEntity extends _chunkHC5EZOZJjs.Entity {
       isPointInside() {
         return false;
       }
@@ -4970,7 +5286,7 @@ var Scene = (_class15 = class _Scene {
     }("root");
     this.root._scene = this;
     this._wasmBackend = new WasmBackendFacade(this.root);
-    this.overlayRoot = new class OverlayRoot extends _chunkPOPXUPKRjs.Entity {
+    this.overlayRoot = new class OverlayRoot extends _chunkHC5EZOZJjs.Entity {
       isPointInside() {
         return false;
       }
@@ -4983,15 +5299,15 @@ var Scene = (_class15 = class _Scene {
     if (options.renderer) {
       this.renderer = options.renderer;
     } else {
-      this.renderer = new (0, _chunkKRUDTGNRjs.CanvasRenderer)(
+      this.renderer = new (0, _chunkBKXERWADjs.CanvasRenderer)(
         canvas,
         this.disableWindowResize ? { width: this.width, height: this.height } : void 0,
         this.maxDPR
       );
     }
-    _optionalChain([this, 'access', _122 => _122.renderer, 'access', _123 => _123.onContextRestored, 'optionalCall', _124 => _124(() => {
+    _optionalChain([this, 'access', _125 => _125.renderer, 'access', _126 => _126.onContextRestored, 'optionalCall', _127 => _127(() => {
       this.markDirty();
-      if (_optionalChain([this, 'access', _125 => _125.renderer, 'access', _126 => _126.isContextLost, 'optionalCall', _127 => _127()]) !== true) this.render(this.renderer);
+      if (_optionalChain([this, 'access', _128 => _128.renderer, 'access', _129 => _129.isContextLost, 'optionalCall', _130 => _130()]) !== true) this.render(this.renderer);
     })]);
     if (typeof document !== "undefined") {
       this.a11yRoot = document.createElement("div");
@@ -5164,18 +5480,54 @@ var Scene = (_class15 = class _Scene {
   watchDevicePixelRatio() {
     if (typeof window === "undefined" || typeof window.matchMedia !== "function") return;
     if (this.dprMediaQuery && this.dprChangeHandler) {
-      _optionalChain([this, 'access', _128 => _128.dprMediaQuery, 'access', _129 => _129.removeEventListener, 'optionalCall', _130 => _130("change", this.dprChangeHandler)]);
+      _optionalChain([this, 'access', _131 => _131.dprMediaQuery, 'access', _132 => _132.removeEventListener, 'optionalCall', _133 => _133("change", this.dprChangeHandler)]);
     }
-    const dpr = window.devicePixelRatio || 1;
+    const raw = window.devicePixelRatio;
+    const dpr = Number.isFinite(raw) && raw > 0 ? raw : 1;
     const query = window.matchMedia(`(resolution: ${dpr}dppx)`);
     const handler = () => {
-      this.resize(this.width, this.height);
-      if (_optionalChain([this, 'access', _131 => _131.renderer, 'access', _132 => _132.isContextLost, 'optionalCall', _133 => _133()]) !== true) this.render(this.renderer);
+      const curRaw = window.devicePixelRatio;
+      const cur = Number.isFinite(curRaw) && curRaw > 0 ? curRaw : 1;
+      if (Math.abs(cur - dpr) <= 1e-3) {
+        this.watchDevicePixelRatio();
+        return;
+      }
+      this.lastDpr = cur;
+      try {
+        this.resize(this.width, this.height);
+      } catch (err) {
+        console.warn("[VectoJS] DPR resize failed", err);
+      }
+      try {
+        if (_optionalChain([this, 'access', _134 => _134.renderer, 'access', _135 => _135.isContextLost, 'optionalCall', _136 => _136()]) !== true) this.render(this.renderer);
+      } catch (err) {
+        console.warn("[VectoJS] DPR repaint failed", err);
+      }
       this.watchDevicePixelRatio();
     };
-    _optionalChain([query, 'access', _134 => _134.addEventListener, 'optionalCall', _135 => _135("change", handler)]);
+    _optionalChain([query, 'access', _137 => _137.addEventListener, 'optionalCall', _138 => _138("change", handler)]);
     this.dprMediaQuery = query;
     this.dprChangeHandler = handler;
+    this.lastDpr = dpr;
+    if (this.dprPollInterval === null && typeof setInterval === "function") {
+      this.dprPollInterval = setInterval(() => {
+        const rawPoll = window.devicePixelRatio;
+        const curPoll = Number.isFinite(rawPoll) && rawPoll > 0 ? rawPoll : 1;
+        if (Math.abs(curPoll - this.lastDpr) <= 1e-3) return;
+        this.lastDpr = curPoll;
+        try {
+          this.resize(this.width, this.height);
+        } catch (err) {
+          console.warn("[VectoJS] DPR poll resize failed", err);
+        }
+        try {
+          if (_optionalChain([this, 'access', _139 => _139.renderer, 'access', _140 => _140.isContextLost, 'optionalCall', _141 => _141()]) !== true) this.render(this.renderer);
+        } catch (err) {
+          console.warn("[VectoJS] DPR poll repaint failed", err);
+        }
+        this.watchDevicePixelRatio();
+      }, 1e3);
+    }
   }
   /**
    * Recover the WebGL point layer from a GPU context loss (driver TDR reset,
@@ -5193,7 +5545,7 @@ var Scene = (_class15 = class _Scene {
     if (typeof gl.addEventListener !== "function") return;
     this.glContextLostHandler = (e) => {
       e.preventDefault();
-      _optionalChain([this, 'access', _136 => _136.pointRenderer, 'optionalAccess', _137 => _137.destroy, 'call', _138 => _138()]);
+      _optionalChain([this, 'access', _142 => _142.pointRenderer, 'optionalAccess', _143 => _143.destroy, 'call', _144 => _144()]);
       this.pointRenderer = null;
     };
     this.glContextRestoredHandler = () => {
@@ -5209,6 +5561,35 @@ var Scene = (_class15 = class _Scene {
     gl.addEventListener("webglcontextlost", this.glContextLostHandler);
     gl.addEventListener("webglcontextrestored", this.glContextRestoredHandler);
   }
+  /**
+   * One-shot adoption of the window viewport once an initially-detached canvas
+   * gains layout (#817). A full-window scene constructed before its canvas is
+   * attached starts at 0×0, and no window `resize` fires on attachment — so
+   * without this latch the scene would stay unsized forever. The first nonzero
+   * layout box adopts `window.innerWidth/innerHeight` (the same sizing the
+   * window resize handler applies, keeping the full-window contract), then the
+   * observer disconnects: steady-state sizing stays exactly as if the canvas
+   * had been attached before construction. An explicit user `resize()` between
+   * construction and attachment is respected and skips adoption.
+   *
+   * No-op when the scene already has a size (attached at construction) or when
+   * `ResizeObserver` is unavailable (the caller then drives sizing explicitly).
+   */
+  armAttachmentViewportLatch() {
+    if (this.width > 0 && this.height > 0) return;
+    if (typeof ResizeObserver === "undefined") return;
+    const observer = new ResizeObserver((entries) => {
+      const box = _optionalChain([entries, 'access', _145 => _145[0], 'optionalAccess', _146 => _146.contentRect]);
+      if (!box || !(box.width > 0) || !(box.height > 0)) return;
+      observer.disconnect();
+      this.canvasResizeObserver = null;
+      if (this.width === 0 || this.height === 0) {
+        this.resize(window.innerWidth, window.innerHeight);
+      }
+    });
+    this.canvasResizeObserver = observer;
+    observer.observe(this.canvas);
+  }
   // --- domain: scene-facade — renderer accessor ---
   /**
    * Expose the underlying {@link IRenderer} for advanced direct-draw operations.
@@ -5231,6 +5612,37 @@ var Scene = (_class15 = class _Scene {
   findEntityAt(x, y) {
     return this._hitTester.findEntityAt(x, y, this.currentFrame, this.width, this.height);
   }
+  // --- domain: hit-test — merged HitResult query (RFC5 §2, CTX-0600) ---
+  /**
+   * The merged hit list for a scene-space point: the canvas spatial test
+   * plus caller-observed DOM-native candidates (mirror / portal /
+   * `dom-visual` extension point for CTX-0598) as ONE ordered candidate
+   * list (`HitResult`, overlay order authoritative).
+   *
+   * Query API alongside {@link findEntityAt} — no dispatch change:
+   * `findEntityAt` keeps its single topmost answer byte-for-byte, keyboard
+   * and AT flows are untouched. For browser pointer coordinates use
+   * {@link findHitsAtClient}, which maps through {@link clientToScene} first.
+   */
+  findHitsAt(x, y, domCandidates = []) {
+    return this._hitTester.findHitsAt(
+      x,
+      y,
+      this.currentFrame,
+      this.width,
+      this.height,
+      domCandidates
+    );
+  }
+  /**
+   * {@link findHitsAt} for browser viewport coordinates: maps through
+   * {@link clientToScene} so coordinates enter in scene space (RFC5 §2
+   * rule 3) and backend attribution follows.
+   */
+  findHitsAtClient(clientX, clientY, domCandidates = []) {
+    const point = this.clientToScene(clientX, clientY);
+    return this.findHitsAt(point.x, point.y, domCandidates);
+  }
   // --- domain: hit-test — client-to-scene mapping ---
   /** Convert browser viewport coordinates into this Scene's logical coordinates. */
   clientToScene(clientX, clientY) {
@@ -5271,6 +5683,15 @@ var Scene = (_class15 = class _Scene {
       this.activePortalsThisFrame.delete(node.id);
       this.activePortalsPrevFrame.delete(node.id);
     }
+    if (node.domPolicy === "dom" || node.domResident) {
+      for (const backend of this.projectionBackends) backend.unmount(node);
+      this.domSeenThisFrame.delete(node.id);
+      this.domSeenPrevFrame.delete(node.id);
+      this.domSeenNodes.delete(node.id);
+    }
+    this.projectionResolutions.delete(node.id);
+    this.projectionHysteresis.delete(node.id);
+    this.projectionGesturePins.delete(node.id);
     const contentEl = this.contentElements.get(node.id);
     if (contentEl) {
       this._contentProjection.clearGridState(node.id, contentEl);
@@ -5290,7 +5711,7 @@ var Scene = (_class15 = class _Scene {
       }
       if (this.hoveredA11yElements.has(el)) {
         this.hoveredA11yElements.delete(el);
-        node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("pointerleave", node, void 0, false));
+        node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("pointerleave", node, void 0, false));
       }
       this.preserveFocusOnRemoval(el);
       el.remove();
@@ -5390,12 +5811,16 @@ var Scene = (_class15 = class _Scene {
       this.canvasResizeObserver = null;
     }
     if (this.dprMediaQuery && this.dprChangeHandler) {
-      _optionalChain([this, 'access', _139 => _139.dprMediaQuery, 'access', _140 => _140.removeEventListener, 'optionalCall', _141 => _141("change", this.dprChangeHandler)]);
+      _optionalChain([this, 'access', _147 => _147.dprMediaQuery, 'access', _148 => _148.removeEventListener, 'optionalCall', _149 => _149("change", this.dprChangeHandler)]);
       this.dprMediaQuery = null;
       this.dprChangeHandler = null;
     }
+    if (this.dprPollInterval !== null) {
+      clearInterval(this.dprPollInterval);
+      this.dprPollInterval = null;
+    }
     if (this.forcedColorsQuery && this.forcedColorsChangeHandler) {
-      _optionalChain([this, 'access', _142 => _142.forcedColorsQuery, 'access', _143 => _143.removeEventListener, 'optionalCall', _144 => _144("change", this.forcedColorsChangeHandler)]);
+      _optionalChain([this, 'access', _150 => _150.forcedColorsQuery, 'access', _151 => _151.removeEventListener, 'optionalCall', _152 => _152("change", this.forcedColorsChangeHandler)]);
       this.forcedColorsQuery = null;
       this.forcedColorsChangeHandler = null;
     }
@@ -5426,9 +5851,9 @@ var Scene = (_class15 = class _Scene {
       }
       this.pointerEventTarget = null;
     }
-    _optionalChain([this, 'access', _145 => _145.a11yRoot, 'optionalAccess', _146 => _146.remove, 'call', _147 => _147()]);
+    _optionalChain([this, 'access', _153 => _153.a11yRoot, 'optionalAccess', _154 => _154.remove, 'call', _155 => _155()]);
     this.focusSentinel = null;
-    _optionalChain([this, 'access', _148 => _148.portalRoot, 'optionalAccess', _149 => _149.remove, 'call', _150 => _150()]);
+    _optionalChain([this, 'access', _156 => _156.portalRoot, 'optionalAccess', _157 => _157.remove, 'call', _158 => _158()]);
     this.a11yElements.clear();
     for (const el of this.contentElements.values()) el.remove();
     this.contentElements.clear();
@@ -5444,10 +5869,10 @@ var Scene = (_class15 = class _Scene {
     }
     this.glContextLostHandler = null;
     this.glContextRestoredHandler = null;
-    _optionalChain([this, 'access', _151 => _151.pointRenderer, 'optionalAccess', _152 => _152.destroy, 'call', _153 => _153()]);
-    _optionalChain([this, 'access', _154 => _154.renderer, 'access', _155 => _155.dispose, 'optionalCall', _156 => _156()]);
-    _optionalChain([this, 'access', _157 => _157.glCanvas, 'optionalAccess', _158 => _158.remove, 'call', _159 => _159()]);
-    _optionalChain([this, 'access', _160 => _160.gpuCanvas, 'optionalAccess', _161 => _161.remove, 'call', _162 => _162()]);
+    _optionalChain([this, 'access', _159 => _159.pointRenderer, 'optionalAccess', _160 => _160.destroy, 'call', _161 => _161()]);
+    _optionalChain([this, 'access', _162 => _162.renderer, 'access', _163 => _163.dispose, 'optionalCall', _164 => _164()]);
+    _optionalChain([this, 'access', _165 => _165.glCanvas, 'optionalAccess', _166 => _166.remove, 'call', _167 => _167()]);
+    _optionalChain([this, 'access', _168 => _168.gpuCanvas, 'optionalAccess', _169 => _169.remove, 'call', _170 => _170()]);
     this.gpuCanvas = null;
     this.gpuContext = null;
     if (this.recoveryTimerId) {
@@ -5459,7 +5884,7 @@ var Scene = (_class15 = class _Scene {
       this.manager = null;
     }
     if (this.device) {
-      _optionalChain([this, 'access', _163 => _163.device, 'access', _164 => _164.destroy, 'optionalCall', _165 => _165()]);
+      _optionalChain([this, 'access', _171 => _171.device, 'access', _172 => _172.destroy, 'optionalCall', _173 => _173()]);
       this.device = null;
     }
   }
@@ -5467,6 +5892,7 @@ var Scene = (_class15 = class _Scene {
   setupEvents() {
     if (typeof window !== "undefined" && !this.disableWindowResize) {
       window.addEventListener("resize", this.resizeHandler);
+      this.armAttachmentViewportLatch();
     } else if (this.disableWindowResize && typeof ResizeObserver !== "undefined" && this.canvas && typeof this.canvas.getBoundingClientRect === "function") {
       this.canvasResizeObserver = new ResizeObserver((entries) => {
         const entry = entries[0];
@@ -5875,15 +6301,48 @@ var Scene = (_class15 = class _Scene {
   shouldProjectA11y(node) {
     if (!node.interactive) return false;
     if (!(node.width > 0 || node.a11yFullViewport)) return false;
+    if (node.domPolicy === "dom" || this.resolveProjectionFor(node) === "dom") return false;
     switch (node.a11yProjection) {
       case "never":
         return false;
       case "onDemand":
-        return this.a11yEngaged(node);
+        return this.a11yEngaged(node) && this.resolveSemanticProjection(node);
       default:
-        return true;
+        return this.resolveSemanticProjection(node);
     }
   }
+  /**
+   * Policy half of {@link shouldProjectA11y} (RFC3 §5, CTX-0599).
+   *
+   * The legacy gates above (interactive, box, `a11yProjection` engagement)
+   * are unchanged; this only maps a {@link SemanticProjectionPolicy} decision
+   * onto project/suppress. Out of the box the default policy returns
+   * `'project'`, so behaviour is identical to having no policy.
+   *
+   * `'defer-to-browser'` always falls back to projection today: no deferral
+   * backend exists (`supportsHTMLInCanvas()` is `false`), so deferring would
+   * silently drop semantics — the exact failure RFC §3 rules out. When a
+   * backend lands, only allow-listed plain display text
+   * ({@link isDeferrableSemanticNode}; never controls) may actually defer. A
+   * throwing policy likewise falls back to projection: a policy must never be
+   * able to drop semantics by accident.
+   */
+  resolveSemanticProjection(node) {
+    const policy = _nullishCoalesce(this.semanticProjectionPolicy, () => ( DEFAULT_SEMANTIC_PROJECTION_POLICY));
+    let decision;
+    try {
+      decision = policy.choose(node, getSemanticProjectionCapabilities(), {
+        hasDOM: this.a11yRoot !== null
+      });
+    } catch (e18) {
+      decision = "project";
+    }
+    if (decision === "never") return false;
+    if (decision === "defer-to-browser" && isDeferrableSemanticNode(node) && supportsHTMLInCanvas()) {
+      return false;
+    }
+    return true;
+  }
   /**
    * Whether an `a11yProjection: 'onDemand'` entity is currently engaged enough to
    * deserve a shadow node.
@@ -5911,7 +6370,7 @@ var Scene = (_class15 = class _Scene {
     if (this.mouseX > -9e3 && !this.projectsSelectableText(node)) {
       if (node.isPointInside(this.mouseX, this.mouseY)) return true;
     }
-    const existing = _optionalChain([this, 'access', _166 => _166.a11yElements, 'optionalAccess', _167 => _167.get, 'call', _168 => _168(node.id)]);
+    const existing = _optionalChain([this, 'access', _174 => _174.a11yElements, 'optionalAccess', _175 => _175.get, 'call', _176 => _176(node.id)]);
     if (existing && typeof document !== "undefined" && document.activeElement === existing) {
       return true;
     }
@@ -5925,8 +6384,8 @@ var Scene = (_class15 = class _Scene {
    * selection.
    */
   projectsSelectableText(node) {
-    const projection = _optionalChain([node, 'access', _169 => _169.getContentProjection, 'optionalCall', _170 => _170()]);
-    return !!_optionalChain([projection, 'optionalAccess', _171 => _171.text]) && projection.selectable !== false;
+    const projection = _optionalChain([node, 'access', _177 => _177.getContentProjection, 'optionalCall', _178 => _178()]);
+    return !!_optionalChain([projection, 'optionalAccess', _179 => _179.text]) && projection.selectable !== false;
   }
   /**
    * Keep `entity`'s a11y shadow node projected while it has
@@ -6021,20 +6480,20 @@ var Scene = (_class15 = class _Scene {
           el.style.background = "transparent";
         }
         el.addEventListener("click", (e) => {
-          node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("click", node, e));
+          node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("click", node, e));
         });
         el.addEventListener("dblclick", (e) => {
-          node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("dblclick", node, e));
+          node.dispatchEvent(new (0, _chunkHC5EZOZJjs.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, _chunkPOPXUPKRjs.VectoJSEvent)("hover", node, e, false));
+          node.dispatchEvent(new (0, _chunkHC5EZOZJjs.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, _chunkPOPXUPKRjs.VectoJSEvent)("pointerleave", node, e, false));
+          node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("pointerleave", node, e, false));
         });
         const capEl = el;
         const releasePointer = (event) => {
@@ -6052,24 +6511,27 @@ var Scene = (_class15 = class _Scene {
           if (e.target === capEl && typeof capEl.setPointerCapture === "function") {
             capEl.setPointerCapture(e.pointerId);
           }
-          node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("pointerdown", node, e));
+          this.pinProjectionForGesture(node);
+          node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("pointerdown", node, e));
         });
         el.addEventListener("pointerup", (e) => {
           releasePointer(e);
-          node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("pointerup", node, e));
+          this.unpinProjectionForGesture(node);
+          node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("pointerup", node, e));
         });
         el.addEventListener("pointercancel", (e) => {
           releasePointer(e);
-          node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("pointercancel", node, e));
+          this.unpinProjectionForGesture(node);
+          node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("pointercancel", node, e));
         });
         el.addEventListener(
           "pointermove",
-          (e) => node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("pointermove", node, e))
+          (e) => node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("pointermove", node, e))
         );
         el.addEventListener(
           "wheel",
           (e) => {
-            node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("wheel", node, e));
+            node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("wheel", node, e));
           },
           { passive: false }
         );
@@ -6094,10 +6556,10 @@ var Scene = (_class15 = class _Scene {
         );
         emitInitialScroll = emitScroll;
         el.addEventListener("keydown", (e) => {
-          node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("keydown", node, e));
+          node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("keydown", node, e));
         });
         el.addEventListener("keyup", (e) => {
-          node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("keyup", node, e));
+          node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("keyup", node, e));
         });
         if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
           const input = el;
@@ -6128,7 +6590,7 @@ var Scene = (_class15 = class _Scene {
           el.addEventListener("compositionupdate", (e) => {
             const data = _nullishCoalesce(e.data, () => ( ""));
             composition = {
-              start: _nullishCoalesce(_optionalChain([composition, 'optionalAccess', _172 => _172.start]), () => ( 0)),
+              start: _nullishCoalesce(_optionalChain([composition, 'optionalAccess', _180 => _180.start]), () => ( 0)),
               length: data.length
             };
             forward();
@@ -6182,14 +6644,14 @@ var Scene = (_class15 = class _Scene {
         el.addEventListener("keydown", (e) => {
           if (e.key === "Enter") {
             e.preventDefault();
-            node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("click", node, e));
+            node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("click", node, e));
           } else if (e.key === " ") {
             e.preventDefault();
           }
         });
         el.addEventListener("keyup", (e) => {
           if (e.key === " ") {
-            node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("click", node, e));
+            node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("click", node, e));
           }
         });
         this.keyboardActivatedA11y.add(el);
@@ -6210,7 +6672,7 @@ var Scene = (_class15 = class _Scene {
         this.syncOptionalAttribute(
           el,
           "href",
-          attrs.href === void 0 ? void 0 : _chunkKRUDTGNRjs.sanitizeUrl.call(void 0, attrs.href)
+          attrs.href === void 0 ? void 0 : _chunkBKXERWADjs.sanitizeUrl.call(void 0, attrs.href)
         );
         this.syncOptionalAttribute(el, "target", attrs.target);
       }
@@ -6379,7 +6841,7 @@ var Scene = (_class15 = class _Scene {
         const display = visible ? "" : "none";
         if (el.style.display !== display) el.style.display = display;
       }
-      _optionalChain([emitInitialScroll, 'optionalCall', _173 => _173()]);
+      _optionalChain([emitInitialScroll, 'optionalCall', _181 => _181()]);
     }
     if (this.phases.enabled) {
       const projectionStart = performance.now();
@@ -6609,7 +7071,7 @@ var Scene = (_class15 = class _Scene {
       el.addEventListener(
         "wheel",
         (e2) => {
-          node.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)("wheel", node, e2));
+          node.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)("wheel", node, e2));
         },
         { passive: false }
       );
@@ -6840,8 +7302,8 @@ var Scene = (_class15 = class _Scene {
       next.f = f2;
       next.tier = tier;
       next.hasBand = lineBand !== null;
-      next.bandMin = _nullishCoalesce(_optionalChain([lineBand, 'optionalAccess', _174 => _174.minY]), () => ( 0));
-      next.bandMax = _nullishCoalesce(_optionalChain([lineBand, 'optionalAccess', _175 => _175.maxY]), () => ( 0));
+      next.bandMin = _nullishCoalesce(_optionalChain([lineBand, 'optionalAccess', _182 => _182.minY]), () => ( 0));
+      next.bandMax = _nullishCoalesce(_optionalChain([lineBand, 'optionalAccess', _183 => _183.maxY]), () => ( 0));
       next.visible = visible;
       next.width = node.width;
       next.height = node.height;
@@ -7020,6 +7482,197 @@ var Scene = (_class15 = class _Scene {
     this.activePortalsPrevFrame = new Set(this.activePortalsThisFrame);
     this.activePortalsThisFrame.clear();
   }
+  /**
+   * Register a generic projection backend (RFC1 §5, RFC2 P1 CTX-0598).
+   * Registration is idempotent per backend instance. Core drives
+   * mount/update/unmount from the render walk; the backend owns all
+   * medium-specific state.
+   */
+  addProjectionBackend(backend) {
+    if (!this.projectionBackends.includes(backend)) this.projectionBackends.push(backend);
+    return this;
+  }
+  /**
+   * Remove a previously registered projection backend by instance or
+   * {@link ProjectionBackendKind | kind}. Removing does not unmount resident
+   * nodes — unmount the backend first if teardown order matters.
+   */
+  removeProjectionBackend(backend) {
+    this.projectionBackends = this.projectionBackends.filter(
+      (b) => typeof backend === "string" ? b.kind !== backend : b !== backend
+    );
+    return this;
+  }
+  /**
+   * Scene-level projection capabilities (RFC4 §3 rule 2, CTX-0601).
+   *
+   * Plain-data feature detection in the shape of the proposed
+   * `scene.inputCapabilities` (input-dispatch-contract-v2 §4): apps and
+   * devtools query where a node _would_ materialize and why, without touching
+   * any backend. Additive only — no existing surface moves.
+   */
+  get projectionCapabilities() {
+    return {
+      hasDOM: typeof document !== "undefined",
+      domBackendMounted: this.projectionBackends.some((b) => b.kind === "dom"),
+      backends: this.projectionBackends.map((b) => b.kind),
+      autoHysteresisFrames: this.projectionHysteresisFrames,
+      autoDomBudget: this.projectionAutoDomBudget
+    };
+  }
+  /**
+   * Register (or replace) the Capability Matrix row for one `domKind`
+   * (RFC4 §4, CTX-0601). Custom kinds start at the unknown-kind default
+   * (`unsupported-kind` → canvas); registering a row is how a custom backend
+   * kind opts into `'auto'` resolution and how tests drive oscillating costs.
+   */
+  registerProjectionCapability(domKind, row) {
+    this.projectionCapabilityOverrides.set(domKind, row);
+    return this;
+  }
+  /** Matrix row for a node's `domKind` (override wins, unknown → canvas). */
+  getProjectionCapability(node) {
+    return _nullishCoalesce(_nullishCoalesce(this.projectionCapabilityOverrides.get(node.domKind), () => ( DEFAULT_PROJECTION_CAPABILITIES[node.domKind])), () => ( UNKNOWN_PROJECTION_CAPABILITY));
+  }
+  /**
+   * Pin a node's backend for the duration of an active gesture (RFC4 §5 +
+   * input-dispatch-contract-v2 §4 gesture stickiness: no mid-gesture handoff).
+   * The a11y-mirror pointerdown/up/cancel listeners maintain this; DOM-side
+   * gestures are consulted through
+   * {@link ProjectionBackend.hasActiveGesture | backend.hasActiveGesture}.
+   * Refcounted so multi-pointer gestures on one node unpin exactly once.
+   */
+  pinProjectionForGesture(node) {
+    this.projectionGesturePins.set(node.id, (_nullishCoalesce(this.projectionGesturePins.get(node.id), () => ( 0))) + 1);
+  }
+  /** Release one gesture pin taken by {@link pinProjectionForGesture}. */
+  unpinProjectionForGesture(node) {
+    const count = (_nullishCoalesce(this.projectionGesturePins.get(node.id), () => ( 0))) - 1;
+    if (count <= 0) this.projectionGesturePins.delete(node.id);
+    else this.projectionGesturePins.set(node.id, count);
+  }
+  /** Whether `node` currently owns an active gesture on a core mirror. */
+  isProjectionPinned(node) {
+    return (_nullishCoalesce(this.projectionGesturePins.get(node.id), () => ( 0))) > 0;
+  }
+  /**
+   * Last negotiation for one node, if it was ever resolved on this scene.
+   * Accepts the node or its id; returns the stored record (not a copy — treat
+   * as read-only).
+   */
+  getProjectionResolution(node) {
+    return this.projectionResolutions.get(typeof node === "string" ? node : node.id);
+  }
+  /** Every node's last negotiation, in first-resolution order. */
+  getProjectionResolutions() {
+    return [...this.projectionResolutions.values()];
+  }
+  /**
+   * Resolve one node's `domPolicy` to its effective backend (RFC4 §3, CTX-0601).
+   *
+   * Memoized per main frame (`currentFrame`, bumped once per authoritative
+   * render): the render walk and the later a11y sync must agree within a
+   * frame, or a node could lose its mirror the same frame it gains an element.
+   * `'auto'` applies, in order: no-DOM short-circuit → pure negotiation →
+   * gesture/focus hard bars (a pinned node keeps its current backend, never
+   * flips mid-gesture, focus is preserved-or-moved never dropped to `body` per
+   * input-dispatch-contract-v2 §4) → hysteresis stickiness → bulk budget.
+   * Every outcome is recorded on the per-scene queryable surface
+   * ({@link getProjectionResolutions}) with its reason — fallbacks are
+   * reported, not silent (§3 rule 2).
+   */
+  resolveProjectionFor(node) {
+    const want = node.domPolicy;
+    if (this.projectionBackends.length === 0 && want === "canvas") return "canvas";
+    const memo = this.projectionHysteresis.get(node.id);
+    if (memo && memo.lastFrame === this.currentFrame) return memo.resolved;
+    const hasDOM = typeof document !== "undefined";
+    const domBackendMounted = this.projectionBackends.some((b) => b.kind === "dom");
+    const outcome = resolveProjection(want, this.getProjectionCapability(node), {
+      hasDOM,
+      domBackendMounted
+    });
+    let resolved = outcome.resolved;
+    let reason = outcome.reason;
+    if (want === "auto" && memo !== void 0) {
+      if (resolved !== memo.resolved) {
+        const gesturePinned = this.isProjectionPinned(node) || this.projectionBackends.some((b) => _optionalChain([b, 'access', _184 => _184.hasActiveGesture, 'optionalCall', _185 => _185(node)]) === true);
+        if (gesturePinned) {
+          resolved = memo.resolved;
+          reason = "active-gesture";
+        } else if (this.ownsProjectionFocus(node)) {
+          resolved = memo.resolved;
+          reason = "focus-pinned";
+        } else {
+          const vote = hysteresisVote(
+            memo.resolved,
+            resolved,
+            memo.consecutive,
+            this.projectionHysteresisFrames
+          );
+          resolved = vote.resolved;
+          memo.consecutive = vote.consecutive;
+          reason = vote.flipped ? reason : "hysteresis";
+        }
+      } else {
+        memo.consecutive = 0;
+      }
+    }
+    if (want === "auto" && resolved === "dom") {
+      if (this.projectionBudgetFrame !== this.currentFrame) {
+        this.projectionBudgetFrame = this.currentFrame;
+        this.projectionDomAutoCount = 0;
+      }
+      this.projectionDomAutoCount += 1;
+      if (this.projectionDomAutoCount > this.projectionAutoDomBudget) {
+        resolved = "canvas";
+        reason = "bulk-budget";
+      }
+    }
+    this.projectionHysteresis.set(node.id, {
+      resolved,
+      consecutive: _nullishCoalesce(_optionalChain([memo, 'optionalAccess', _186 => _186.consecutive]), () => ( 0)),
+      lastFrame: this.currentFrame
+    });
+    const prev = this.projectionResolutions.get(node.id);
+    if (!prev || prev.want !== want || prev.resolved !== resolved || prev.reason !== reason) {
+      this.projectionResolutions.set(node.id, { nodeId: node.id, want, resolved, reason });
+    }
+    return resolved;
+  }
+  /**
+   * Whether `node`'s a11y mirror currently owns browser focus (RFC4 §5 focus
+   * rule, input-dispatch-contract-v2 §4: focus stays DOM-based; flipping
+   * `projection` must preserve or deliberately move focus, never drop it to
+   * `body`). A focused node keeps its backend until blur — the actual move, if
+   * any, goes through the existing sentinels (`preserveFocusOnRemoval`, the
+   * DOM backend's own fallback), never a bare removal.
+   */
+  ownsProjectionFocus(node) {
+    if (typeof document === "undefined") return false;
+    const mirror = this.a11yElements.get(node.id);
+    if (!mirror || mirror !== this.focusedA11yElement) return false;
+    return document.activeElement === mirror;
+  }
+  /**
+   * RFC2 P1 (CTX-0598): unmount DOM-projection residents the walk did not see
+   * this frame (viewport-culled, removed without `remove()`, policy-flipped).
+   * Mirrors {@link reconcilePortals} above; unmount is idempotent per the
+   * `ProjectionBackend` contract so notifying every backend is safe.
+   */
+  pruneProjectionBackends() {
+    for (const id of this.domSeenPrevFrame) {
+      if (!this.domSeenThisFrame.has(id)) {
+        const node = this.domSeenNodes.get(id);
+        if (node) {
+          for (const backend of this.projectionBackends) backend.unmount(node);
+          this.domSeenNodes.delete(id);
+        }
+      }
+    }
+    this.domSeenPrevFrame = new Set(this.domSeenThisFrame);
+    this.domSeenThisFrame.clear();
+  }
   // --- domain: render-scheduler — the loop and the render walk ---
   /**
    * The frame-rate cap actually in effect: the explicit {@link maxFPS}, further
@@ -7027,7 +7680,7 @@ var Scene = (_class15 = class _Scene {
    * (and {@link respectReducedMotion} is on). `0` means uncapped.
    */
   effectiveMaxFPS() {
-    const reduced = this.respectReducedMotion && !!_optionalChain([this, 'access', _176 => _176.reducedMotionQuery, 'optionalAccess', _177 => _177.matches]);
+    const reduced = this.respectReducedMotion && !!_optionalChain([this, 'access', _187 => _187.reducedMotionQuery, 'optionalAccess', _188 => _188.matches]);
     if (reduced)
       return this.maxFPS > 0 ? Math.min(this.maxFPS, REDUCED_MOTION_FPS) : REDUCED_MOTION_FPS;
     return this.maxFPS;
@@ -7097,6 +7750,12 @@ var Scene = (_class15 = class _Scene {
   /**
    * Render the entire scene graph onto the specified renderer.
    *
+   * This is the `CanvasProjection` row of {@link ProjectionBackend}:
+   * the per-frame materialization of scene semantics into pixels through the
+   * backend-agnostic `IRenderer` contract. (The `A11yProjection` /
+   * `ContentProjection` rows run on the same cadence via {@link Scene.syncA11y}
+   * below; the `DOMProjection` row does not exist yet — RFC2/CTX-0598.)
+   *
    * Main-frame causal order is a correctness contract:
    *
    * 1. Browser/input callbacks finish before the scheduled frame begins.
@@ -7122,7 +7781,7 @@ var Scene = (_class15 = class _Scene {
    * @param time - Current absolute time in milliseconds (default 0).
    */
   render(renderer, dt = 0, time = 0) {
-    if (_optionalChain([renderer, 'access', _178 => _178.isContextLost, 'optionalCall', _179 => _179()])) return;
+    if (_optionalChain([renderer, 'access', _189 => _189.isContextLost, 'optionalCall', _190 => _190()])) return;
     const isMainRenderer = renderer === this.renderer;
     if (isMainRenderer && this.a11yRoot && this.canvas.parentElement) {
       const parentStyle = this.canvas.parentElement.style;
@@ -7272,14 +7931,14 @@ var Scene = (_class15 = class _Scene {
     }
     renderer.clear();
     if (isMainRenderer) {
-      _optionalChain([this, 'access', _180 => _180.pointRenderer, 'optionalAccess', _181 => _181.begin, 'call', _182 => _182()]);
+      _optionalChain([this, 'access', _191 => _191.pointRenderer, 'optionalAccess', _192 => _192.begin, 'call', _193 => _193()]);
     }
     const vw = this.width;
     const vh = this.height;
     let walkHadAnimation = false;
     let walkHadInteractive = false;
     const runUpdate = (node) => {
-      const overridesUpdate = node.update !== _chunkPOPXUPKRjs.Entity.prototype.update;
+      const overridesUpdate = node.update !== _chunkHC5EZOZJjs.Entity.prototype.update;
       let pending = node.hasPendingAnimations();
       if (pending || overridesUpdate) {
         node.update(dt, time);
@@ -7288,7 +7947,7 @@ var Scene = (_class15 = class _Scene {
       if (pending) walkHadAnimation = true;
       if (!walkHadInteractive && node.interactive) walkHadInteractive = true;
       if (this._devActive && this._devFrameCount % 120 === 0) {
-        if (overridesUpdate && node.hasPendingAnimations === _chunkPOPXUPKRjs.Entity.prototype.hasPendingAnimations) {
+        if (overridesUpdate && node.hasPendingAnimations === _chunkHC5EZOZJjs.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 slow the animation. Override hasPendingAnimations() to return true while motion is in flight.`
           );
@@ -7389,6 +8048,16 @@ var Scene = (_class15 = class _Scene {
         visible = maxX >= 0 && minX <= vw && maxY >= 0 && minY <= vh;
       }
       if (!visible && node.children.length === 0) return;
+      if (isMainRenderer && this.projectionBackends.length > 0 && this.resolveProjectionFor(node) === "dom" && visible) {
+        for (const backend of this.projectionBackends) {
+          backend.update(node, { a, b, c, d, e: te, f: tf });
+        }
+        if (node.domResident) {
+          this.domSeenThisFrame.add(node.id);
+          this.domSeenNodes.set(node.id, node);
+          if (node.children.length === 0) return;
+        }
+      }
       if (node.children.length === 0 && node.scaleX === node.scaleY) {
         const bc = node.getBatchCircle();
         if (bc) {
@@ -7518,14 +8187,15 @@ var Scene = (_class15 = class _Scene {
       this.frameHadAnimation = walkHadAnimation;
       this.frameHadInteractive = walkHadInteractive;
       this.reconcilePortals();
+      this.pruneProjectionBackends();
     }
     const flushTiming = this.phases.userTiming ? beginVectoUserTiming(VECTO_USER_TIMING.scene.flush) : null;
     const flushT0 = this.phases.enabled ? performance.now() : 0;
     renderer.flush();
     if (isMainRenderer) {
-      _optionalChain([this, 'access', _183 => _183.pointRenderer, 'optionalAccess', _184 => _184.flush, 'call', _185 => _185()]);
+      _optionalChain([this, 'access', _194 => _194.pointRenderer, 'optionalAccess', _195 => _195.flush, 'call', _196 => _196()]);
     }
-    _optionalChain([renderer, 'access', _186 => _186.present, 'optionalCall', _187 => _187()]);
+    _optionalChain([renderer, 'access', _197 => _197.present, 'optionalCall', _198 => _198()]);
     if (this.phases.enabled) this.phases.record("flush", performance.now() - flushT0);
     if (flushTiming) endVectoUserTiming(flushTiming);
     if (this._devActive) {
@@ -7538,7 +8208,7 @@ var Scene = (_class15 = class _Scene {
    * Export the current scene state to a lightweight, flat SVG XML string.
    */
   toSVG() {
-    const renderer = new (0, _chunkKRUDTGNRjs.SVGRenderer)(this.width, this.height);
+    const renderer = new (0, _chunkBKXERWADjs.SVGRenderer)(this.width, this.height);
     this.render(renderer, 0, 0);
     return renderer.toXMLString();
   }
@@ -7616,7 +8286,7 @@ var Scene = (_class15 = class _Scene {
       });
       pass.end();
       this.device.queue.submit([encoder.finish()]);
-    } catch (e17) {
+    } catch (e19) {
     }
     this.gpuHasContent = false;
   }
@@ -7751,20 +8421,20 @@ function defaultMeasurer() {
   sharedMeasurer ??= _layout.resolveGlyphMeasurer.call(void 0, "sans-serif");
   return sharedMeasurer;
 }
-var TextEntity = (_class16 = class extends _chunkPOPXUPKRjs.Entity {
+var TextEntity = (_class16 = class extends _chunkHC5EZOZJjs.Entity {
   
   
   
   
-  __init189() {this.nodes = []}
+  __init204() {this.nodes = []}
   
-  __init190() {this.fillStyle = "#94a3b8"}
-  __init191() {this.strokeStyle = null}
-  __init192() {this.hoveredFillStyle = "#ffffff"}
-  __init193() {this.lineWidth = 1}
-  __init194() {this.isHovered = false}
+  __init205() {this.fillStyle = "#94a3b8"}
+  __init206() {this.strokeStyle = null}
+  __init207() {this.hoveredFillStyle = "#ffffff"}
+  __init208() {this.lineWidth = 1}
+  __init209() {this.isHovered = false}
   /** Bumped by {@link applyLayout}; read by `Scene` to skip an unchanged sync. */
-  __init195() {this.contentEpoch = 0}
+  __init210() {this.contentEpoch = 0}
   /**
    * Visual lines with real canvas geometry, rebuilt by {@link applyLayout}
    * exactly when `this.nodes` changes.
@@ -7776,9 +8446,9 @@ var TextEntity = (_class16 = class extends _chunkPOPXUPKRjs.Entity {
    * ~0.35 em per line for a 24 px font, Firefox). Per-line carriers pin the DOM
    * baseline to the canvas baseline by construction, same as `ui/Text`.
    */
-  __init196() {this.projectionLines = []}
+  __init211() {this.projectionLines = []}
   constructor(text, atlas, maxWidth, fontSize = 24) {
-    super();_class16.prototype.__init189.call(this);_class16.prototype.__init190.call(this);_class16.prototype.__init191.call(this);_class16.prototype.__init192.call(this);_class16.prototype.__init193.call(this);_class16.prototype.__init194.call(this);_class16.prototype.__init195.call(this);_class16.prototype.__init196.call(this);;
+    super();_class16.prototype.__init204.call(this);_class16.prototype.__init205.call(this);_class16.prototype.__init206.call(this);_class16.prototype.__init207.call(this);_class16.prototype.__init208.call(this);_class16.prototype.__init209.call(this);_class16.prototype.__init210.call(this);_class16.prototype.__init211.call(this);;
     this.text = text;
     this.atlas = atlas;
     this.fontSize = fontSize;
@@ -7954,18 +8624,250 @@ var TextEntity = (_class16 = class extends _chunkPOPXUPKRjs.Entity {
   }
 }, _class16);
 
+// src/components/VirtualizedSetAggregate.ts
+var VirtualizedSetAggregate = (_class17 = class extends _chunkHC5EZOZJjs.Entity {
+  
+  
+  
+  
+  
+  
+  
+  /** First item index currently bound to the pool (the scroll window). */
+  __init212() {this._visibleStart = 0}
+  /** Item id owning the roving tab stop / keyboard focus. */
+  __init213() {this._activeId = null}
+  __init214() {this._selectedId = null}
+  /** One focusable hotspot per visible slot; re-bound, never rebuilt per item. */
+  __init215() {this._hotspots = []}
+  constructor(opts = {}) {
+    super();_class17.prototype.__init212.call(this);_class17.prototype.__init213.call(this);_class17.prototype.__init214.call(this);_class17.prototype.__init215.call(this);;
+    this._items = _nullishCoalesce(opts.items, () => ( []));
+    this._label = _nullishCoalesce(opts.label, () => ( "Items"));
+    this._role = _nullishCoalesce(opts.role, () => ( "list"));
+    this._itemRole = _nullishCoalesce(opts.itemRole, () => ( "listitem"));
+    this._rowHeight = _nullishCoalesce(opts.rowHeight, () => ( 28));
+    this._visibleCapacity = opts.visibleCapacity;
+    this._onActivate = opts.onActivate;
+    this.width = _nullishCoalesce(opts.width, () => ( 0));
+    this.height = _nullishCoalesce(opts.height, () => ( 0));
+    this.interactive = true;
+    this._syncHotspots();
+  }
+  /** Full item count — the number the container label states. */
+  get itemCount() {
+    return this._items.length;
+  }
+  /** Live pool size (bounded by the visible capacity, never by the item count). */
+  get poolSize() {
+    return this._hotspots.length;
+  }
+  /** First item index currently bound to the pool. */
+  get visibleStart() {
+    return this._visibleStart;
+  }
+  getA11yAttributes() {
+    return {
+      role: this._role,
+      label: `${this._label}, ${this._items.length} items`,
+      pointerEvents: "none"
+    };
+  }
+  render(_renderer) {
+  }
+  /** Axis-aligned hit-test against the container box (the `UIComponent` default). */
+  isPointInside(globalX, globalY) {
+    const local = this.worldToLocal(globalX, globalY);
+    if (!local) return false;
+    return local.x >= 0 && local.x <= this.width && local.y >= 0 && local.y <= this.height;
+  }
+  /** Replace the item set; the pool re-binds and the label count follows. */
+  setItems(items) {
+    this._items = items;
+    if (this._activeId !== null && !items.some((item) => item.id === this._activeId)) {
+      this._activeId = null;
+    }
+    if (this._selectedId !== null && !items.some((item) => item.id === this._selectedId)) {
+      this._selectedId = null;
+    }
+    this._visibleStart = Math.max(0, Math.min(this._visibleStart, Math.max(0, items.length - 1)));
+    this._syncHotspots();
+    _optionalChain([this, 'access', _199 => _199.scene, 'optionalAccess', _200 => _200.markDirty, 'call', _201 => _201()]);
+  }
+  /** Move the pool window to start at `start` (the scroll position). */
+  setVisibleStart(start) {
+    const clamped = Math.max(0, Math.min(start, Math.max(0, this._items.length - 1)));
+    if (clamped === this._visibleStart) return;
+    this._visibleStart = clamped;
+    this._syncHotspots();
+    _optionalChain([this, 'access', _202 => _202.scene, 'optionalAccess', _203 => _203.markDirty, 'call', _204 => _204()]);
+  }
+  /**
+   * Keep one hotspot per visible slot, positioned over it. The pool is sized
+   * to the viewport (capacity), each slot re-bound to whatever item currently
+   * occupies it — the `Tree._syncHotspots` shape, minus tree structure.
+   */
+  _syncHotspots() {
+    const capacity = _nullishCoalesce(this._visibleCapacity, () => ( Math.max(1, Math.ceil(this.height / this._rowHeight))));
+    const need = Math.max(0, Math.min(capacity, this._items.length - this._visibleStart));
+    while (this._hotspots.length < need) {
+      const hotspot = new AggregateItemHotspot(this);
+      this._hotspots.push(hotspot);
+      this.add(hotspot);
+    }
+    while (this._hotspots.length > need) {
+      const hotspot = this._hotspots.pop();
+      _optionalChain([this, 'access', _205 => _205.scene, 'optionalAccess', _206 => _206.detachA11y, 'call', _207 => _207(hotspot)]);
+      this.remove(hotspot);
+    }
+    for (let slot = 0; slot < need; slot++) {
+      const index = this._visibleStart + slot;
+      const hotspot = this._hotspots[slot];
+      hotspot.bind(index, this._items[index]);
+      hotspot.x = 0;
+      hotspot.y = slot * this._rowHeight;
+      hotspot.width = this.width;
+      hotspot.height = this._rowHeight;
+    }
+  }
+  /** Whether `id` owns the roving tab stop: active, else selected, else first. */
+  isTabStop(id) {
+    const anchor = _nullishCoalesce(_nullishCoalesce((this._activeId !== null && this._items.some((item) => item.id === this._activeId) ? this._activeId : null), () => ( (this._selectedId !== null && this._items.some((item) => item.id === this._selectedId) ? this._selectedId : null))), () => ( _optionalChain([this, 'access', _208 => _208._items, 'access', _209 => _209[0], 'optionalAccess', _210 => _210.id])));
+    return id === anchor;
+  }
+  isSelected(id) {
+    return this._selectedId === id;
+  }
+  /** Item role the hotspots announce (kept on the parent: one source of truth). */
+  get itemRole() {
+    return this._itemRole;
+  }
+  /** Activate an item (pointer tap-through or Enter/Space): selects and notifies. */
+  activateItem(id, focusIt = false) {
+    const index = this._items.findIndex((item) => item.id === id);
+    if (index === -1) return;
+    this._activeId = id;
+    this._selectedId = id;
+    _optionalChain([this, 'access', _211 => _211._onActivate, 'optionalCall', _212 => _212(this._items[index], index)]);
+    if (focusIt) this.focusItem(id);
+    _optionalChain([this, 'access', _213 => _213.scene, 'optionalAccess', _214 => _214.markDirty, 'call', _215 => _215()]);
+  }
+  /** Move keyboard focus to the hotspot currently bound to `id`, if any. */
+  focusItem(id) {
+    _optionalChain([this, 'access', _216 => _216._hotspots, 'access', _217 => _217.find, 'call', _218 => _218((hotspot) => hotspot.itemId === id), 'optionalAccess', _219 => _219.focus, 'call', _220 => _220()]);
+  }
+  /**
+   * Aggregate keyboard model: Up/Down move the active item (scrolling the pool
+   * window so it stays bound), Home/End jump, Enter/Space activate. The active
+   * item is focused as it moves so focus is never stranded on a re-bound slot.
+   */
+  handleItemKey(e, id) {
+    const index = this._items.findIndex((item) => item.id === id);
+    if (index === -1) return;
+    let next = -1;
+    switch (e.key) {
+      case "ArrowDown":
+        next = Math.min(index + 1, this._items.length - 1);
+        break;
+      case "ArrowUp":
+        next = Math.max(index - 1, 0);
+        break;
+      case "Home":
+        next = 0;
+        break;
+      case "End":
+        next = this._items.length - 1;
+        break;
+      case "Enter":
+      case " ":
+        e.preventDefault();
+        this.activateItem(id, true);
+        return;
+      default:
+        return;
+    }
+    e.preventDefault();
+    this._activeId = this._items[next].id;
+    this._ensureVisible(next);
+    this.focusItem(this._activeId);
+    _optionalChain([this, 'access', _221 => _221.scene, 'optionalAccess', _222 => _222.markDirty, 'call', _223 => _223()]);
+  }
+  /** Scroll the pool window just enough to keep `index` bound. */
+  _ensureVisible(index) {
+    const capacity = _nullishCoalesce(this._visibleCapacity, () => ( Math.max(1, Math.ceil(this.height / this._rowHeight))));
+    if (index < this._visibleStart) this.setVisibleStart(index);
+    else if (index >= this._visibleStart + capacity) {
+      this.setVisibleStart(index - capacity + 1);
+    } else {
+      this._syncHotspots();
+    }
+  }
+  update(_dt, _time) {
+    super.update(_dt, _time);
+    this._syncHotspots();
+  }
+}, _class17);
+var AggregateItemHotspot = (_class18 = class extends _chunkHC5EZOZJjs.Entity {
+  constructor(aggregate) {
+    super();_class18.prototype.__init216.call(this);_class18.prototype.__init217.call(this);_class18.prototype.__init218.call(this);;
+    this.aggregate = aggregate;
+    this.interactive = true;
+    this.on("click", () => this.aggregate.activateItem(this.itemId, true));
+    this.on("keydown", (e) => this.aggregate.handleItemKey(e, this.itemId));
+  }
+  
+  __init216() {this.itemId = ""}
+  __init217() {this._index = 0}
+  __init218() {this._label = ""}
+  bind(index, item) {
+    this._index = index;
+    this.itemId = item.id;
+    this._label = item.label;
+  }
+  /** The aggregate positions and sizes one pooled hotspot per visible slot. */
+  getLayoutControlledProperties() {
+    return ["x", "y", "width", "height"];
+  }
+  getA11yAttributes() {
+    return {
+      role: this.aggregate.itemRole,
+      label: this._label,
+      // 1-based position within the FULL set, not the pool: without these a
+      // virtualized window announces the pool position as the set position.
+      posInSet: this._index + 1,
+      setSize: this.aggregate.itemCount,
+      selected: this.aggregate.isSelected(this.itemId),
+      // Roving tabindex: only the active item is a tab stop; arrows move within.
+      tabIndex: this.aggregate.isTabStop(this.itemId) ? 0 : -1,
+      // The owner keeps the pointer (canvas handling or an underlying
+      // selectable-text mirror); this hotspot exists for semantics + keyboard
+      // focus, so it opts out of hit-testing. Keyboard focus and
+      // AT-synthesized `click` still work under `pointer-events:none`.
+      pointerEvents: "none"
+    };
+  }
+  render() {
+  }
+  /** Axis-aligned hit-test against the hotspot slot (the `UIComponent` default). */
+  isPointInside(globalX, globalY) {
+    const local = this.worldToLocal(globalX, globalY);
+    if (!local) return false;
+    return local.x >= 0 && local.x <= this.width && local.y >= 0 && local.y <= this.height;
+  }
+}, _class18);
+
 // src/components/GridTextEntity.ts
-var GridTextEntity = (_class17 = class extends _chunkPOPXUPKRjs.Entity {
+var GridTextEntity = (_class19 = class extends _chunkHC5EZOZJjs.Entity {
   
-  __init197() {this.fillStyle = "#ffffff"}
-  __init198() {this.grid = []}
+  __init219() {this.fillStyle = "#ffffff"}
+  __init220() {this.grid = []}
   // Array of rows
-  __init199() {this.cols = 0}
-  __init200() {this.rows = 0}
+  __init221() {this.cols = 0}
+  __init222() {this.rows = 0}
   
   
   constructor(_atlas, fontSize = 10) {
-    super();_class17.prototype.__init197.call(this);_class17.prototype.__init198.call(this);_class17.prototype.__init199.call(this);_class17.prototype.__init200.call(this);;
+    super();_class19.prototype.__init219.call(this);_class19.prototype.__init220.call(this);_class19.prototype.__init221.call(this);_class19.prototype.__init222.call(this);;
     this.fontSize = fontSize;
     this.charWidth = fontSize * 1;
     this.charHeight = fontSize * 1.1;
@@ -7974,7 +8876,7 @@ var GridTextEntity = (_class17 = class extends _chunkPOPXUPKRjs.Entity {
   updateGrid(ascii) {
     this.grid = ascii;
     this.rows = ascii.length;
-    this.cols = ascii.reduce((widest, row) => Math.max(widest, _nullishCoalesce(_optionalChain([row, 'optionalAccess', _188 => _188.length]), () => ( 0))), 0);
+    this.cols = ascii.reduce((widest, row) => Math.max(widest, _nullishCoalesce(_optionalChain([row, 'optionalAccess', _224 => _224.length]), () => ( 0))), 0);
   }
   isPointInside(_globalX, _globalY) {
     return false;
@@ -7996,7 +8898,7 @@ var GridTextEntity = (_class17 = class extends _chunkPOPXUPKRjs.Entity {
       }
     }
   }
-}, _class17);
+}, _class19);
 
 // src/components/SplineEntity.ts
 function polySegmentToBezier(seg) {
@@ -8049,7 +8951,7 @@ function distSqToSegment(px, py, x1, y1, x2, y2) {
   const ey = py - cy;
   return ex * ex + ey * ey;
 }
-var SplineEntity = (_class18 = class extends _chunkPOPXUPKRjs.Entity {
+var SplineEntity = (_class20 = class extends _chunkHC5EZOZJjs.Entity {
   
   
   
@@ -8057,17 +8959,17 @@ var SplineEntity = (_class18 = class extends _chunkPOPXUPKRjs.Entity {
   
   
   
-  __init201() {this.offscreen = null}
-  __init202() {this.baked = false}
+  __init223() {this.offscreen = null}
+  __init224() {this.baked = false}
   /** Logical (CSS-pixel) size of the baked bitmap — the blit destination size. */
-  __init203() {this.bakedWidth = 0}
-  __init204() {this.bakedHeight = 0}
+  __init225() {this.bakedWidth = 0}
+  __init226() {this.bakedHeight = 0}
   /**
    * Device-pixel ratio the bitmap was rasterized at. Tracked so a DPR change
    * (browser zoom, a monitor move, a renderer whose clamp changed) re-bakes
    * instead of blitting a bitmap at the wrong device density forever.
    */
-  __init205() {this.bakedDPR = 0}
+  __init227() {this.bakedDPR = 0}
   /**
    * Gradient strokes can't be baked to a solid-color bitmap; they render
    * per-frame. Derived from `_doc`, so it is NOT readonly — assigning a new
@@ -8075,7 +8977,7 @@ var SplineEntity = (_class18 = class extends _chunkPOPXUPKRjs.Entity {
    */
   
   /** Lazily-flattened polylines (one Float32Array of [x,y,...] per segment) for hit-testing. */
-  __init206() {this.polylines = null}
+  __init228() {this.polylines = null}
   /**
    * The spline document to render. Assigning a new document invalidates all
    * caches (baked canvas, flattened polylines, bounds).
@@ -8109,9 +9011,9 @@ var SplineEntity = (_class18 = class extends _chunkPOPXUPKRjs.Entity {
    * local bounds after painting the curves. Useful for drag feedback and
    * debugging hit areas. Defaults to `false`.
    */
-  __init207() {this.showBounds = false}
+  __init229() {this.showBounds = false}
   constructor(doc, opts = {}) {
-    super();_class18.prototype.__init201.call(this);_class18.prototype.__init202.call(this);_class18.prototype.__init203.call(this);_class18.prototype.__init204.call(this);_class18.prototype.__init205.call(this);_class18.prototype.__init206.call(this);_class18.prototype.__init207.call(this);;
+    super();_class20.prototype.__init223.call(this);_class20.prototype.__init224.call(this);_class20.prototype.__init225.call(this);_class20.prototype.__init226.call(this);_class20.prototype.__init227.call(this);_class20.prototype.__init228.call(this);_class20.prototype.__init229.call(this);;
     this._doc = doc;
     this._lineWidth = _nullishCoalesce(opts.lineWidth, () => ( 2));
     this.cache = _nullishCoalesce(opts.cache, () => ( true));
@@ -8131,7 +9033,7 @@ var SplineEntity = (_class18 = class extends _chunkPOPXUPKRjs.Entity {
    */
   computeContainsGradient() {
     const isGradient = (c) => c !== null && !Array.isArray(c);
-    return (_nullishCoalesce(_optionalChain([this, 'access', _189 => _189._doc, 'access', _190 => _190.equations, 'optionalAccess', _191 => _191.some, 'call', _192 => _192((eq) => isGradient(eq.color_rgb))]), () => ( false))) || (_nullishCoalesce(_optionalChain([this, 'access', _193 => _193._doc, 'access', _194 => _194.paths, 'optionalAccess', _195 => _195.some, 'call', _196 => _196((p) => isGradient(p.color_rgb))]), () => ( false)));
+    return (_nullishCoalesce(_optionalChain([this, 'access', _225 => _225._doc, 'access', _226 => _226.equations, 'optionalAccess', _227 => _227.some, 'call', _228 => _228((eq) => isGradient(eq.color_rgb))]), () => ( false))) || (_nullishCoalesce(_optionalChain([this, 'access', _229 => _229._doc, 'access', _230 => _230.paths, 'optionalAccess', _231 => _231.some, 'call', _232 => _232((p) => isGradient(p.color_rgb))]), () => ( false)));
   }
   /** Clear cached baked canvas and hit-test polylines. */
   invalidateCache() {
@@ -8370,14 +9272,14 @@ var SplineEntity = (_class18 = class extends _chunkPOPXUPKRjs.Entity {
       r.stroke("rgba(0, 150, 255, 0.8)", 2);
     }
   }
-}, _class18);
+}, _class20);
 async function loadSpline(url) {
   const res = await fetch(url);
   return await res.json();
 }
 
 // src/components/Rect.ts
-var Rect = class extends _chunkPOPXUPKRjs.Entity {
+var Rect = class extends _chunkHC5EZOZJjs.Entity {
   
   
   
@@ -8433,7 +9335,7 @@ var Rect = class extends _chunkPOPXUPKRjs.Entity {
 };
 
 // src/components/Circle.ts
-var Circle = class extends _chunkPOPXUPKRjs.Entity {
+var Circle = class extends _chunkHC5EZOZJjs.Entity {
   
   
   
@@ -8497,7 +9399,7 @@ var Circle = class extends _chunkPOPXUPKRjs.Entity {
 };
 
 // src/components/Group.ts
-var Group = class extends _chunkPOPXUPKRjs.Entity {
+var Group = class extends _chunkHC5EZOZJjs.Entity {
   constructor(...children) {
     super();
     if (children.length > 0) this.add(...children);
@@ -8516,21 +9418,21 @@ var _math = require('@vectojs/math'); _createStarExport(_math);
 
 
 // src/tree/DOMPortalEntity.ts
-var DOMPortalEntity = (_class19 = class extends _chunkPOPXUPKRjs.Entity {
+var DOMPortalEntity = (_class21 = class extends _chunkHC5EZOZJjs.Entity {
   
-  __init208() {this.isDOMPortal = true}
-  __init209() {this.domListeners = []}
-  __init210() {this.resizeObserver = null}
-  __init211() {this.domBound = false}
-  __init212() {this.cachedWidth = 100}
-  __init213() {this.cachedHeight = 100}
-  __init214() {this.lastWidth = ""}
-  __init215() {this.lastHeight = ""}
-  __init216() {this.lastTransform = ""}
-  __init217() {this.lastZIndex = ""}
-  __init218() {this.lastOpacity = ""}
+  __init230() {this.isDOMPortal = true}
+  __init231() {this.domListeners = []}
+  __init232() {this.resizeObserver = null}
+  __init233() {this.domBound = false}
+  __init234() {this.cachedWidth = 100}
+  __init235() {this.cachedHeight = 100}
+  __init236() {this.lastWidth = ""}
+  __init237() {this.lastHeight = ""}
+  __init238() {this.lastTransform = ""}
+  __init239() {this.lastZIndex = ""}
+  __init240() {this.lastOpacity = ""}
   constructor(domElement, width, height, id) {
-    super(id);_class19.prototype.__init208.call(this);_class19.prototype.__init209.call(this);_class19.prototype.__init210.call(this);_class19.prototype.__init211.call(this);_class19.prototype.__init212.call(this);_class19.prototype.__init213.call(this);_class19.prototype.__init214.call(this);_class19.prototype.__init215.call(this);_class19.prototype.__init216.call(this);_class19.prototype.__init217.call(this);_class19.prototype.__init218.call(this);;
+    super(id);_class21.prototype.__init230.call(this);_class21.prototype.__init231.call(this);_class21.prototype.__init232.call(this);_class21.prototype.__init233.call(this);_class21.prototype.__init234.call(this);_class21.prototype.__init235.call(this);_class21.prototype.__init236.call(this);_class21.prototype.__init237.call(this);_class21.prototype.__init238.call(this);_class21.prototype.__init239.call(this);_class21.prototype.__init240.call(this);;
     this.domElement = domElement;
     this.width = _nullishCoalesce(width, () => ( 0));
     this.height = _nullishCoalesce(height, () => ( 0));
@@ -8572,7 +9474,7 @@ var DOMPortalEntity = (_class19 = class extends _chunkPOPXUPKRjs.Entity {
     ];
     for (const type of events) {
       const handler = (e) => {
-        this.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)(type, this, e));
+        this.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)(type, this, e));
       };
       this.domElement.addEventListener(type, handler);
       this.domListeners.push({ type, handler, capture: false });
@@ -8583,7 +9485,7 @@ var DOMPortalEntity = (_class19 = class extends _chunkPOPXUPKRjs.Entity {
     ];
     for (const { native, vecto } of hoverEvents) {
       const handler = (e) => {
-        this.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)(vecto, this, e, false));
+        this.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)(vecto, this, e, false));
       };
       this.domElement.addEventListener(native, handler);
       this.domListeners.push({ type: native, handler, capture: false });
@@ -8591,7 +9493,7 @@ var DOMPortalEntity = (_class19 = class extends _chunkPOPXUPKRjs.Entity {
     const focusEvents = ["focus", "blur"];
     for (const type of focusEvents) {
       const handler = (e) => {
-        this.dispatchEvent(new (0, _chunkPOPXUPKRjs.VectoJSEvent)(type, this, e, true));
+        this.dispatchEvent(new (0, _chunkHC5EZOZJjs.VectoJSEvent)(type, this, e, true));
       };
       this.domElement.addEventListener(type, handler, true);
       this.domListeners.push({ type, handler, capture: true });
@@ -8639,11 +9541,23 @@ var DOMPortalEntity = (_class19 = class extends _chunkPOPXUPKRjs.Entity {
     }
     super.destroy();
   }
-}, _class19);
+}, _class21);
 
 // src/index.ts
-Scene.registerWebGLPointRendererCreator(_chunkKRUDTGNRjs.createWebGLPointRenderer);
-Scene.registerWebGPUParticleSystemManager(_chunkKRUDTGNRjs.WebGPUParticleSystemManager);
+Scene.registerWebGLPointRendererCreator(_chunkBKXERWADjs.createWebGLPointRenderer);
+Scene.registerWebGPUParticleSystemManager(_chunkBKXERWADjs.WebGPUParticleSystemManager);
+
+
+
+
+
+
+
+
+
+
+
+
 
 
 
@@ -8692,4 +9606,4 @@ Scene.registerWebGPUParticleSystemManager(_chunkKRUDTGNRjs.WebGPUParticleSystemM
 
 
 
-exports.CanvasRenderer = _chunkKRUDTGNRjs.CanvasRenderer; exports.Circle = Circle; exports.ComputeParticleEntity = ComputeParticleEntity; exports.DEFAULT_CONTENT_SEMANTIC_BUDGET = DEFAULT_CONTENT_SEMANTIC_BUDGET; exports.DOMPortalEntity = DOMPortalEntity; exports.Entity = _chunkPOPXUPKRjs.Entity; exports.GlyphRasterAtlas = _chunkKRUDTGNRjs.GlyphRasterAtlas; exports.GridTextEntity = GridTextEntity; exports.Group = Group; exports.KEYBOARD_OWNING_ROLES = KEYBOARD_OWNING_ROLES; exports.MSDFTextEntity = _chunkPOPXUPKRjs.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 = _chunkPOPXUPKRjs.SVGEntity; exports.SVGRenderer = _chunkKRUDTGNRjs.SVGRenderer; exports.Scene = Scene; exports.SplineEntity = SplineEntity; exports.TextEntity = TextEntity; exports.TextRasterCache = _chunkKRUDTGNRjs.TextRasterCache; exports.VECTO_USER_TIMING = VECTO_USER_TIMING; exports.VectoJSEvent = _chunkPOPXUPKRjs.VectoJSEvent; exports.WebGPUParticleSystemManager = _chunkKRUDTGNRjs.WebGPUParticleSystemManager; exports.beginVectoUserTiming = beginVectoUserTiming; exports.contentLineInHint = _chunkPOPXUPKRjs.contentLineInHint; exports.createWebGLPointRenderer = _chunkKRUDTGNRjs.createWebGLPointRenderer; exports.endVectoUserTiming = endVectoUserTiming; exports.installRendererDevTraps = _chunkKRUDTGNRjs.installRendererDevTraps; exports.isRendererDevMode = _chunkKRUDTGNRjs.isRendererDevMode; exports.isSafeUrl = _chunkKRUDTGNRjs.isSafeUrl; exports.loadSpline = loadSpline; exports.measureVectoUserTiming = measureVectoUserTiming; exports.normalizeChord = normalizeChord; exports.ownsKeyboard = ownsKeyboard; exports.parseColorToRGBA = _chunkKRUDTGNRjs.parseColorToRGBA; exports.polySegmentToBezier = polySegmentToBezier; exports.sanitizeUrl = _chunkKRUDTGNRjs.sanitizeUrl; exports.setRendererDevMode = _chunkKRUDTGNRjs.setRendererDevMode;
+exports.CanvasRenderer = _chunkBKXERWADjs.CanvasRenderer; exports.Circle = Circle; exports.ComputeParticleEntity = ComputeParticleEntity; exports.DEFAULT_CONTENT_SEMANTIC_BUDGET = DEFAULT_CONTENT_SEMANTIC_BUDGET; exports.DEFAULT_PROJECTION_CAPABILITIES = DEFAULT_PROJECTION_CAPABILITIES; exports.DEFAULT_SEMANTIC_PROJECTION_POLICY = DEFAULT_SEMANTIC_PROJECTION_POLICY; exports.DOMPortalEntity = DOMPortalEntity; exports.Entity = _chunkHC5EZOZJjs.Entity; exports.GlyphRasterAtlas = _chunkBKXERWADjs.GlyphRasterAtlas; exports.GridTextEntity = GridTextEntity; exports.Group = Group; exports.KEYBOARD_OWNING_ROLES = KEYBOARD_OWNING_ROLES; exports.MSDFTextEntity = _chunkHC5EZOZJjs.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.PROJECTION_AUTO_DOM_BUDGET = PROJECTION_AUTO_DOM_BUDGET; exports.PROJECTION_AUTO_HYSTERESIS_FRAMES = PROJECTION_AUTO_HYSTERESIS_FRAMES; exports.REDUCED_MOTION_FPS = REDUCED_MOTION_FPS; exports.Rect = Rect; exports.SCENE_OPTION_KEYS = SCENE_OPTION_KEYS; exports.SVGEntity = _chunkHC5EZOZJjs.SVGEntity; exports.SVGRenderer = _chunkBKXERWADjs.SVGRenderer; exports.Scene = Scene; exports.SplineEntity = SplineEntity; exports.TextEntity = TextEntity; exports.TextRasterCache = _chunkBKXERWADjs.TextRasterCache; exports.UNKNOWN_PROJECTION_CAPABILITY = UNKNOWN_PROJECTION_CAPABILITY; exports.VECTO_USER_TIMING = VECTO_USER_TIMING; exports.VectoJSEvent = _chunkHC5EZOZJjs.VectoJSEvent; exports.VirtualizedSetAggregate = VirtualizedSetAggregate; exports.WebGPUParticleSystemManager = _chunkBKXERWADjs.WebGPUParticleSystemManager; exports.beginVectoUserTiming = beginVectoUserTiming; exports.contentLineInHint = _chunkHC5EZOZJjs.contentLineInHint; exports.createWebGLPointRenderer = _chunkBKXERWADjs.createWebGLPointRenderer; exports.describeHTMLInCanvasSupport = describeHTMLInCanvasSupport; exports.endVectoUserTiming = endVectoUserTiming; exports.getSemanticProjectionCapabilities = getSemanticProjectionCapabilities; exports.hysteresisVote = hysteresisVote; exports.installRendererDevTraps = _chunkBKXERWADjs.installRendererDevTraps; exports.isDeferrableSemanticNode = isDeferrableSemanticNode; exports.isRendererDevMode = _chunkBKXERWADjs.isRendererDevMode; exports.isSafeUrl = _chunkBKXERWADjs.isSafeUrl; exports.loadSpline = loadSpline; exports.measureVectoUserTiming = measureVectoUserTiming; exports.normalizeChord = normalizeChord; exports.ownsKeyboard = ownsKeyboard; exports.parseColorToRGBA = _chunkBKXERWADjs.parseColorToRGBA; exports.polySegmentToBezier = polySegmentToBezier; exports.resolveProjection = resolveProjection; exports.sanitizeUrl = _chunkBKXERWADjs.sanitizeUrl; exports.setRendererDevMode = _chunkBKXERWADjs.setRendererDevMode; exports.supportsHTMLInCanvas = supportsHTMLInCanvas;