@vectojs/core 1.39.0 → 1.39.1

package/README.md

@@ -1,18 +1,12 @@
 # @vectojs/core
 
-> Scene, layout, interaction, text, rendering, and semantic projection for canvas-native interfaces.
-
-[![npm](https://img.shields.io/npm/v/@vectojs/core?color=22d3ee)](https://www.npmjs.com/package/@vectojs/core)
-[![CI](https://github.com/vectojs/vectojs/actions/workflows/ci.yml/badge.svg)](https://github.com/vectojs/vectojs/actions/workflows/ci.yml)
-[![MIT](https://img.shields.io/badge/license-MIT-6366f1.svg)](https://github.com/vectojs/vectojs/blob/main/LICENSE)
-
-`@vectojs/core` is the runtime beneath VectoJS. It owns the retained `Scene`/`Entity` tree, affine
-transforms, render scheduling, layout, text flow, spatial hit-testing, event propagation, renderer
-backends, and the accessibility/automation projection layer.
-
-[Core guide](https://vectojs.org/learn/core-scene/) ·
-[API reference](https://vectojs.org/reference/core-api/) ·
-[Main repository](https://github.com/vectojs/vectojs)
+`@vectojs/core` is the runtime at the root of the VectoJS dependency graph: a retained
+`Scene`/`Entity` scene graph (the Virtual Math Tree) that renders to a single canvas, with
+transforms, render scheduling, spatial hit-testing, DOM-like event propagation, layout and text
+engines, Canvas/SVG/WebGL/WebGPU renderer backends, and the accessibility/automation projection
+layer. It is also the composition point of the framework — it depends on and re-exports
+`@vectojs/layout`, `@vectojs/text`, `@vectojs/math`, and `@vectojs/animation`, so `@vectojs/ui`
+and every higher-level package build directly on it.
 
 ## Install
 
@@ -20,7 +14,7 @@ backends, and the accessibility/automation projection layer.
 bun add @vectojs/core
 ```
 
-## Minimal scene
+## Usage
 
 ```ts
 import { Entity, type IRenderer, Scene } from '@vectojs/core';
@@ -57,124 +51,38 @@ scene.add(new Dot().setPosition(80, 80));
 scene.start();
 ```
 
-## Runtime building blocks
-
-| Area        | Main APIs                                       | Purpose                                                                |
-| ----------- | ----------------------------------------------- | ---------------------------------------------------------------------- |
-| Scene graph | `Scene`, `Entity`                               | ownership, transforms, lifecycle, update/render traversal              |
-| Layout      | `LayoutEngine`, layout subpath                  | prepared text/rich-text layout, wrapping, exclusions, reusable buffers |
-| Interaction | entity events, `SpatialHashGrid`                | hit-testing and DOM-like capture/bubble dispatch                       |
-| Text        | `TextEntity`, `MSDFTextEntity`, `SplineEntity`  | Canvas text, GPU text, and mathematical curves                         |
-| Rendering   | `IRenderer`, `CanvasRenderer`, renderer subpath | backend-neutral drawing contract and concrete renderers                |
-| GPU paths   | WebGL point batching, WebGPU particles          | high-volume points/rects and compute-driven particles                  |
-| Semantics   | `A11yAttributes`, Scene projection              | role/name/state, native inputs, screen readers, Playwright/agents      |
-| Animation   | `animate`, springs, transitions, `Scene.step()` | real-time or deterministic fixed-step motion                           |
-
-## Scene lifecycle
-
-```ts
-const scene = new Scene(canvas, {
-  maxFPS: 60,
-  pointBackend: 'canvas', // or 'webgl'
-  particleBackend: 'cpu', // or 'webgpu' when supported
-});
-scene.renderMode = 'onDemand'; // redraw only when dirty
-
-scene.resize(width, height); // logical CSS pixels
-scene.markDirty();
-scene.start();
-scene.stop();
-scene.step(1000 / 60); // deterministic single step
-scene.destroy(); // release renderers, workers, observers, and semantic DOM
-```
-
-Always call `destroy()` when a framework component unmounts. A `Scene` owns browser observers,
-renderer resources, layout work, and projected DOM nodes.
-
-## Package entry points
-
-```ts
-import { Scene, Entity } from '@vectojs/core';
-import { LayoutEngine } from '@vectojs/core/layout';
-import type { IRenderer } from '@vectojs/core/renderer';
-import { TextEntity } from '@vectojs/core/text';
-```
-
-Both ESM and CommonJS outputs are published with TypeScript declarations.
-
-## Accessibility and automation
-
-Canvas pixels have no semantics. Interactive entities can implement `getA11yAttributes()`; the
-Scene projects transparent DOM nodes over their world-space bounds and forwards native input back
-into the VectoJS event system.
-
-This projection is intentionally thin. Applications still own accessible names, keyboard behavior,
-focus order, contrast, and correct control semantics. See the
-[accessibility guide](https://vectojs.org/learn/accessibility/).
-
-Non-control workspaces that own keyboard shortcuts can opt into focus order
-explicitly: return `{ role: 'region', label: 'Canvas workspace', tabIndex: 0 }`.
-The Scene refreshes the projected `tabindex` when attributes change. Keep native
-text inputs and editable content in charge of their own editing shortcuts.
-
-Interactive projected nodes capture the active pointer on `pointerdown` and route
-`pointermove`, `pointerup`, and `pointercancel` through normal VMT capture/bubble propagation.
-Treat `pointercancel` as rollback: discard transient gesture state and do not create durable
-history. Pointer capture is released safely on both completion paths.
-
-## Static content projection
-
-Canvas-rendered text can opt into browser-native find, translation, selection, and copy without
-turning the application into a DOM layout. Override `getContentProjection()` on the owning Entity;
-the Scene creates a transparent, position-synchronized mirror while the VMT remains authoritative:
-
-```ts
-class SelectableLabel extends Entity {
-  getContentProjection() {
-    return {
-      text: 'Selectable canvas text',
-      font: '18px Inter',
-      lineHeight: 24,
-      selectable: true,
-    };
-  }
-}
-```
-
-`selectable` controls whether the mirror receives pointer input. The Scene keeps projection order
-aligned with VMT order, removes descendant mirrors with their subtree, and hides mirrors fully
-outside the viewport or a `clipChildren` ancestor. Tooling can inspect the currently materialized
-node with `scene.getContentElement(entityId)`. Virtualized or non-materialized off-viewport text is
-not searchable until the application brings it into the active scene.
-
-Code-like renderers can compile their logical source once with `prepareContentGrid()` and return the
-same immutable plan as `ContentProjection.grid`. The plan retains UTF-16 source ranges, legal
-grapheme carets, CR/LF ownership, tab stops, wide CJK/emoji advances, Arabic shaping, and Unicode
-bidi positions. Scene projects those cells in logical source order, performs font calibration in a
-cold offscreen batch, and uses the plan's local geometry for pointer selection even when the entity
-is rotated, scaled, or the page is zoomed.
-
-Selection routing preserves forward/reverse drag direction, Shift extension, word and line
-selection, and exact clipboard source. Projection rebuild/removal/destroy paths release active
-selection and pending calibration ownership before replacing DOM carriers.
-
-## Performance model
-
-Useful levers include on-demand rendering, viewport culling, spatial hashing, prepared text layout,
-typed reusable buffers, batched WebGL points, and optional WebGPU particle compute. None makes every
-workload allocation-free or GPU-bound; profile the renderer and entity types used by your app.
-
-Run the repository benchmarks with `bun run benchmark`, `bun run compare:dom`, and
-`bun run compare`. Prepared-grid scaling can be measured independently with
-`bun run --cwd packages/core benchmark:grid`; benchmark timing is release evidence rather than a
-wall-clock CI gate.
-
-## Related packages
-
-- [`@vectojs/ui`](https://github.com/vectojs/vectojs/tree/main/packages/ui) — high-level accessible components
-- [`@vectojs/three`](https://github.com/vectojs/vectojs/tree/main/packages/three) — Three.js/WebXR projection and raycast routing
-- [`@vectojs/video-exporter`](https://github.com/vectojs/vectojs/tree/main/packages/video-exporter) — deterministic H.264 capture
-
-## License
-
-[MIT](https://github.com/vectojs/vectojs/blob/main/LICENSE) © 2026 Xuepoo
+## Highlights
+
+- Retained `Scene`/`Entity` tree with affine transforms, capture/bubble event dispatch,
+  viewport culling, and dirty-flag `renderMode: 'onDemand'` rendering; `scene.step(dt)` drives a
+  deterministic frame for tests and video export.
+- Backend-neutral `IRenderer` drawing contract with modular backends: `CanvasRenderer`,
+  `SVGRenderer`, batched WebGL points (`WebGLPointRenderer`), and WebGPU particle compute
+  (`WebGPUParticleSystemManager`) — registered on load via `Scene.register*`, selected through
+  `pointBackend` / `particleBackend` options.
+- Optional Rust WASM kernels (`crates/vectojs-core-rs`) hot-swapped per subsystem with
+  `scene.enableWasmTransforms / enableWasmHitTest / enableWasmAnimBatching / enableWasmParticles`;
+  fallible exports return `WASM_STATUS` codes (`OK`/`CAPACITY`/`UNINITIALIZED`/`BAD_RUN`/
+  `OVERFLOW`) so any rejected batch degrades to the JS path instead of rendering half-written state.
+- Semantic accessibility projection: entities implementing `getA11yAttributes()` get transparent,
+  position-synchronized DOM mirrors for screen readers, keyboard users, Playwright, and AI agents;
+  static text opts into browser-native selection/find/copy through `getContentProjection()` and
+  Core's prepared content grid (`prepareContentGrid()`).
+- Entity-based text renderers stay here because they extend `Entity`: `TextEntity`,
+  `GridTextEntity`, GPU-resolved `MSDFTextEntity` (off-thread layout via `LayoutWorkerManager`),
+  `SVGEntity`, and `DOMPortalEntity`.
+- The standalone engines are re-exported from this barrel and remain available as subpaths, so
+  existing imports keep working:
+  `@vectojs/core/layout`, `@vectojs/core/text`, `@vectojs/core/renderer`.
+- Lifecycle ownership is explicit: a `Scene` owns renderers, workers, observers, and projected DOM
+  nodes; `scene.destroy()` releases all of them.
+
+> Documents @vectojs/core@1.39.0.
+
+## Documentation
+
+- [Core Scene architecture](https://vectojs.org/learn/core-scene/)
+- [`@vectojs/core` API reference](https://vectojs.org/reference/core-api/)
+- [`Entity` reference](https://vectojs.org/reference/core-entity/)
+- [Renderers reference](https://vectojs.org/reference/core-renderer/)
+- [Accessibility & automation guide](https://vectojs.org/learn/accessibility/)

package/dist/{chunk-RUM2KEDI.mjs → chunk-AISSDI6U.mjs}

@@ -63,7 +63,8 @@ function emptyDrawCounters() {
 }
 var TWO_PI = Math.PI * 2;
 function getDevicePixelRatio() {
-  return typeof window !== "undefined" ? window.devicePixelRatio || 1 : 1;
+  const raw = typeof window !== "undefined" ? window.devicePixelRatio : 1;
+  return Number.isFinite(raw) && raw > 0 ? raw : 1;
 }
 var CanvasRenderer = class _CanvasRenderer {
   ctx;
@@ -209,7 +210,9 @@ var CanvasRenderer = class _CanvasRenderer {
   /** Real `devicePixelRatio`, clamped to {@link maxDPR} when set. */
   effectiveDPR() {
     const real = getDevicePixelRatio();
-    return this.maxDPR !== void 0 ? Math.min(real, this.maxDPR) : real;
+    if (this.maxDPR === void 0) return real;
+    if (!Number.isFinite(this.maxDPR) || this.maxDPR <= 0) return real;
+    return Math.min(real, this.maxDPR);
   }
   /**
    * @inheritdoc
@@ -240,14 +243,18 @@ var CanvasRenderer = class _CanvasRenderer {
    */
   resize(width, height) {
     const dpr = this.effectiveDPR();
+    const safeWidth = Number.isFinite(width) && width >= 0 ? width : this.width;
+    const safeHeight = Number.isFinite(height) && height >= 0 ? height : this.height;
+    const backingW = Number.isFinite(safeWidth * dpr) ? Math.max(1, Math.round(safeWidth * dpr)) : 1;
+    const backingH = Number.isFinite(safeHeight * dpr) ? Math.max(1, Math.round(safeHeight * dpr)) : 1;
     this.appliedDPR = dpr;
-    this.width = width;
-    this.height = height;
-    this.ctx.canvas.width = width * dpr;
-    this.ctx.canvas.height = height * dpr;
+    this.width = safeWidth;
+    this.height = safeHeight;
+    this.ctx.canvas.width = backingW;
+    this.ctx.canvas.height = backingH;
     if (this.ctx.canvas.style) {
-      this.ctx.canvas.style.width = `${width}px`;
-      this.ctx.canvas.style.height = `${height}px`;
+      this.ctx.canvas.style.width = `${safeWidth}px`;
+      this.ctx.canvas.style.height = `${safeHeight}px`;
     }
     this.ctx.scale(dpr, dpr);
     this._cachedFont = "";

package/dist/{chunk-KRUDTGNR.js → chunk-BKXERWAD.js}

@@ -65,7 +65,8 @@ function emptyDrawCounters() {
 }
 var TWO_PI = Math.PI * 2;
 function getDevicePixelRatio() {
-  return typeof window !== "undefined" ? window.devicePixelRatio || 1 : 1;
+  const raw = typeof window !== "undefined" ? window.devicePixelRatio : 1;
+  return Number.isFinite(raw) && raw > 0 ? raw : 1;
 }
 var CanvasRenderer = (_class = class _CanvasRenderer {
   
@@ -211,7 +212,9 @@ var CanvasRenderer = (_class = class _CanvasRenderer {
   /** Real `devicePixelRatio`, clamped to {@link maxDPR} when set. */
   effectiveDPR() {
     const real = getDevicePixelRatio();
-    return this.maxDPR !== void 0 ? Math.min(real, this.maxDPR) : real;
+    if (this.maxDPR === void 0) return real;
+    if (!Number.isFinite(this.maxDPR) || this.maxDPR <= 0) return real;
+    return Math.min(real, this.maxDPR);
   }
   /**
    * @inheritdoc
@@ -242,14 +245,18 @@ var CanvasRenderer = (_class = class _CanvasRenderer {
    */
   resize(width, height) {
     const dpr = this.effectiveDPR();
+    const safeWidth = Number.isFinite(width) && width >= 0 ? width : this.width;
+    const safeHeight = Number.isFinite(height) && height >= 0 ? height : this.height;
+    const backingW = Number.isFinite(safeWidth * dpr) ? Math.max(1, Math.round(safeWidth * dpr)) : 1;
+    const backingH = Number.isFinite(safeHeight * dpr) ? Math.max(1, Math.round(safeHeight * dpr)) : 1;
     this.appliedDPR = dpr;
-    this.width = width;
-    this.height = height;
-    this.ctx.canvas.width = width * dpr;
-    this.ctx.canvas.height = height * dpr;
+    this.width = safeWidth;
+    this.height = safeHeight;
+    this.ctx.canvas.width = backingW;
+    this.ctx.canvas.height = backingH;
     if (this.ctx.canvas.style) {
-      this.ctx.canvas.style.width = `${width}px`;
-      this.ctx.canvas.style.height = `${height}px`;
+      this.ctx.canvas.style.width = `${safeWidth}px`;
+      this.ctx.canvas.style.height = `${safeHeight}px`;
     }
     this.ctx.scale(dpr, dpr);
     this._cachedFont = "";

package/dist/index.js

@@ -12,7 +12,7 @@
 
 
 
-var _chunkKRUDTGNRjs = require('./chunk-KRUDTGNR.js');
+var _chunkBKXERWADjs = require('./chunk-BKXERWAD.js');
 
 
 
@@ -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
@@ -4179,8 +4182,10 @@ var Scene = (_class15 = class _Scene {
    *  this an embedded canvas stayed at its initial size forever. */
   __init140() {this.canvasResizeObserver = null}
   __init141() {this.dprChangeHandler = null}
+  __init142() {this.dprPollInterval = null}
+  __init143() {this.lastDpr = 1}
   // --- domain: a11y-projection — focus, overlay geometry, DOM ordering, portals ---
-  __init142() {this.focusedA11yElement = null}
+  __init144() {this.focusedA11yElement = null}
   /**
    * Canvas box geometry: the CSS↔logical mapping, overlay layer alignment, and
    * the DPR math (extraction 5, `DEC-0024`).
@@ -4207,7 +4212,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()}
+  __init145() {this.hoveredA11yElements = /* @__PURE__ */ new WeakSet()}
   /**
    * Entity ids the application has pinned via {@link requestA11yProjection}.
    *
@@ -4215,13 +4220,13 @@ var Scene = (_class15 = class _Scene {
    * a stale id simply never matches. Cleared per-entity by
    * {@link releaseA11yProjection}.
    */
-  __init144() {this.a11yProjectionRequests = /* @__PURE__ */ new Set()}
+  __init146() {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}
+  __init147() {this.focusSentinel = null}
+  __init148() {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 +4236,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()}
+  __init149() {this.a11yOrder = new A11yProjectionManager()}
   /**
    * The content projection's selection preservation and grid calibration
    * (extraction 3, `DEC-0022`).
@@ -4283,11 +4288,11 @@ 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}
+  __init150() {this.portalRoot = null}
+  __init151() {this.activePortalsThisFrame = /* @__PURE__ */ new Set()}
+  __init152() {this.activePortalsPrevFrame = /* @__PURE__ */ new Set()}
+  __init153() {this.portalEntities = /* @__PURE__ */ new Map()}
+  __init154() {this.renderOrderCounter = 0}
   // --- domain: render-scheduler — authoritative frame counter ---
   /**
    * Monotonic render-frame counter, bumped once per authoritative `render()`
@@ -4297,7 +4302,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}
+  __init155() {this.currentFrame = 0}
   // --- domain: wasm-backend-facade — EXTRACTED (see scene/WasmBackendFacade.ts) ---
   /**
    * The four invisible WASM accelerators and the resident transform store.
@@ -4367,8 +4372,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}
+  __init156() {this._computeEntities = []}
+  __init157() {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 +4612,7 @@ var Scene = (_class15 = class _Scene {
   get animBatchedLastFrame() {
     return this._wasmBackend.animBatchedLastFrame;
   }
-  __init156() {this.animGate = {
+  __init158() {this.animGate = {
     spring: 128,
     tween: 256,
     mixed: 128
@@ -4703,7 +4708,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}
+  __init159() {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 +4736,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()}
+  __init160() {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}
+  __init161() {this.pointRenderer = null}
+  __init162() {this.glCanvas = null}
+  __init163() {this.glContextLostHandler = null}
+  __init164() {this.glContextRestoredHandler = null}
   
   
   
-  __init163() {this.disableWindowResize = false}
+  __init165() {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}
+  __init166() {this.destroyed = false}
+  __init167() {this.device = null}
+  __init168() {this.deviceLost = false}
+  __init169() {this.particleBackend = "auto"}
+  __init170() {this._webgpuDisabled = false}
   get webgpuDisabled() {
     return this._webgpuDisabled || this.particleBackend === "cpu";
   }
@@ -4777,28 +4782,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}
+  __init171() {this.recoveryTimerId = null}
+  __init172() {this.manager = null}
+  __init173() {this.initializingWebGPU = false}
+  __init174() {this.gpuCanvas = null}
+  __init175() {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}
+  __init176() {this.gpuHasContent = false}
+  __init177() {this.mouseX = -9999}
+  __init178() {this.mouseY = -9999}
+  __init179() {this.pointerMoveListener = null}
+  __init180() {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}
+  __init181() {this.pointerEventTarget = null}
   // --- scene-level keyboard channel state (see on/off/registerShortcut) ---
-  __init180() {this.keydownHandlers = []}
-  __init181() {this.keyupHandlers = []}
+  __init182() {this.keydownHandlers = []}
+  __init183() {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}
+  __init184() {this.shortcuts = []}
+  __init185() {this.windowKeyDownHandler = null}
+  __init186() {this.windowKeyUpHandler = null}
+  __init187() {this.hasWarnedZeroSize = false}
   /**
    * Latch for {@link Scene.resize}'s invalid-dimension warning.
    *
@@ -4808,8 +4813,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}
+  __init188() {this.hasWarnedInvalidResize = false}
+  __init189() {this.fontLoadHandler = null}
   // --- domain: scene-facade — dev-mode diagnostics ---
   // ── Dev-mode warning infrastructure ──────────────────────────────
   //
@@ -4834,7 +4839,7 @@ 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;
@@ -4844,7 +4849,7 @@ var Scene = (_class15 = class _Scene {
     return false;
   }
   
-  __init188() {this._devFrameCount = 0}
+  __init190() {this._devFrameCount = 0}
   _devWarn(message) {
     if (!this._devActive) return;
     console.warn(`[vectojs/dev] ${message}`);
@@ -4922,7 +4927,7 @@ 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);
     this.canvas = canvas;
     this.debugA11y = _nullishCoalesce(options.debugA11y, () => ( false));
     this.disableWindowResize = _nullishCoalesce(options.disableWindowResize, () => ( false));
@@ -4933,8 +4938,13 @@ var Scene = (_class15 = class _Scene {
       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");
@@ -4952,7 +4962,7 @@ 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") {
@@ -4983,7 +4993,7 @@ 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
@@ -5166,16 +5176,52 @@ var Scene = (_class15 = class _Scene {
     if (this.dprMediaQuery && this.dprChangeHandler) {
       _optionalChain([this, 'access', _128 => _128.dprMediaQuery, 'access', _129 => _129.removeEventListener, 'optionalCall', _130 => _130("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', _131 => _131.renderer, 'access', _132 => _132.isContextLost, 'optionalCall', _133 => _133()]) !== 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)]);
     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', _136 => _136.renderer, 'access', _137 => _137.isContextLost, 'optionalCall', _138 => _138()]) !== 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 +5239,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', _139 => _139.pointRenderer, 'optionalAccess', _140 => _140.destroy, 'call', _141 => _141()]);
       this.pointRenderer = null;
     };
     this.glContextRestoredHandler = () => {
@@ -5209,6 +5255,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', _142 => _142[0], 'optionalAccess', _143 => _143.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.
@@ -5390,12 +5465,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', _144 => _144.dprMediaQuery, 'access', _145 => _145.removeEventListener, 'optionalCall', _146 => _146("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', _147 => _147.forcedColorsQuery, 'access', _148 => _148.removeEventListener, 'optionalCall', _149 => _149("change", this.forcedColorsChangeHandler)]);
       this.forcedColorsQuery = null;
       this.forcedColorsChangeHandler = null;
     }
@@ -5426,9 +5505,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', _150 => _150.a11yRoot, 'optionalAccess', _151 => _151.remove, 'call', _152 => _152()]);
     this.focusSentinel = null;
-    _optionalChain([this, 'access', _148 => _148.portalRoot, 'optionalAccess', _149 => _149.remove, 'call', _150 => _150()]);
+    _optionalChain([this, 'access', _153 => _153.portalRoot, 'optionalAccess', _154 => _154.remove, 'call', _155 => _155()]);
     this.a11yElements.clear();
     for (const el of this.contentElements.values()) el.remove();
     this.contentElements.clear();
@@ -5444,10 +5523,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', _156 => _156.pointRenderer, 'optionalAccess', _157 => _157.destroy, 'call', _158 => _158()]);
+    _optionalChain([this, 'access', _159 => _159.renderer, 'access', _160 => _160.dispose, 'optionalCall', _161 => _161()]);
+    _optionalChain([this, 'access', _162 => _162.glCanvas, 'optionalAccess', _163 => _163.remove, 'call', _164 => _164()]);
+    _optionalChain([this, 'access', _165 => _165.gpuCanvas, 'optionalAccess', _166 => _166.remove, 'call', _167 => _167()]);
     this.gpuCanvas = null;
     this.gpuContext = null;
     if (this.recoveryTimerId) {
@@ -5459,7 +5538,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', _168 => _168.device, 'access', _169 => _169.destroy, 'optionalCall', _170 => _170()]);
       this.device = null;
     }
   }
@@ -5467,6 +5546,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];
@@ -5911,7 +5991,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', _171 => _171.a11yElements, 'optionalAccess', _172 => _172.get, 'call', _173 => _173(node.id)]);
     if (existing && typeof document !== "undefined" && document.activeElement === existing) {
       return true;
     }
@@ -5925,8 +6005,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', _174 => _174.getContentProjection, 'optionalCall', _175 => _175()]);
+    return !!_optionalChain([projection, 'optionalAccess', _176 => _176.text]) && projection.selectable !== false;
   }
   /**
    * Keep `entity`'s a11y shadow node projected while it has
@@ -6128,7 +6208,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', _177 => _177.start]), () => ( 0)),
               length: data.length
             };
             forward();
@@ -6210,7 +6290,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 +6459,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', _178 => _178()]);
     }
     if (this.phases.enabled) {
       const projectionStart = performance.now();
@@ -6840,8 +6920,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', _179 => _179.minY]), () => ( 0));
+      next.bandMax = _nullishCoalesce(_optionalChain([lineBand, 'optionalAccess', _180 => _180.maxY]), () => ( 0));
       next.visible = visible;
       next.width = node.width;
       next.height = node.height;
@@ -7027,7 +7107,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', _181 => _181.reducedMotionQuery, 'optionalAccess', _182 => _182.matches]);
     if (reduced)
       return this.maxFPS > 0 ? Math.min(this.maxFPS, REDUCED_MOTION_FPS) : REDUCED_MOTION_FPS;
     return this.maxFPS;
@@ -7122,7 +7202,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', _183 => _183.isContextLost, 'optionalCall', _184 => _184()])) return;
     const isMainRenderer = renderer === this.renderer;
     if (isMainRenderer && this.a11yRoot && this.canvas.parentElement) {
       const parentStyle = this.canvas.parentElement.style;
@@ -7272,7 +7352,7 @@ 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', _185 => _185.pointRenderer, 'optionalAccess', _186 => _186.begin, 'call', _187 => _187()]);
     }
     const vw = this.width;
     const vh = this.height;
@@ -7523,9 +7603,9 @@ var Scene = (_class15 = class _Scene {
     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', _188 => _188.pointRenderer, 'optionalAccess', _189 => _189.flush, 'call', _190 => _190()]);
     }
-    _optionalChain([renderer, 'access', _186 => _186.present, 'optionalCall', _187 => _187()]);
+    _optionalChain([renderer, 'access', _191 => _191.present, 'optionalCall', _192 => _192()]);
     if (this.phases.enabled) this.phases.record("flush", performance.now() - flushT0);
     if (flushTiming) endVectoUserTiming(flushTiming);
     if (this._devActive) {
@@ -7538,7 +7618,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();
   }
@@ -7756,15 +7836,15 @@ var TextEntity = (_class16 = class extends _chunkPOPXUPKRjs.Entity {
   
   
   
-  __init189() {this.nodes = []}
+  __init191() {this.nodes = []}
   
-  __init190() {this.fillStyle = "#94a3b8"}
-  __init191() {this.strokeStyle = null}
-  __init192() {this.hoveredFillStyle = "#ffffff"}
-  __init193() {this.lineWidth = 1}
-  __init194() {this.isHovered = false}
+  __init192() {this.fillStyle = "#94a3b8"}
+  __init193() {this.strokeStyle = null}
+  __init194() {this.hoveredFillStyle = "#ffffff"}
+  __init195() {this.lineWidth = 1}
+  __init196() {this.isHovered = false}
   /** Bumped by {@link applyLayout}; read by `Scene` to skip an unchanged sync. */
-  __init195() {this.contentEpoch = 0}
+  __init197() {this.contentEpoch = 0}
   /**
    * Visual lines with real canvas geometry, rebuilt by {@link applyLayout}
    * exactly when `this.nodes` changes.
@@ -7776,9 +7856,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 = []}
+  __init198() {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.__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);_class16.prototype.__init197.call(this);_class16.prototype.__init198.call(this);;
     this.text = text;
     this.atlas = atlas;
     this.fontSize = fontSize;
@@ -7957,15 +8037,15 @@ var TextEntity = (_class16 = class extends _chunkPOPXUPKRjs.Entity {
 // src/components/GridTextEntity.ts
 var GridTextEntity = (_class17 = class extends _chunkPOPXUPKRjs.Entity {
   
-  __init197() {this.fillStyle = "#ffffff"}
-  __init198() {this.grid = []}
+  __init199() {this.fillStyle = "#ffffff"}
+  __init200() {this.grid = []}
   // Array of rows
-  __init199() {this.cols = 0}
-  __init200() {this.rows = 0}
+  __init201() {this.cols = 0}
+  __init202() {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();_class17.prototype.__init199.call(this);_class17.prototype.__init200.call(this);_class17.prototype.__init201.call(this);_class17.prototype.__init202.call(this);;
     this.fontSize = fontSize;
     this.charWidth = fontSize * 1;
     this.charHeight = fontSize * 1.1;
@@ -7974,7 +8054,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', _193 => _193.length]), () => ( 0))), 0);
   }
   isPointInside(_globalX, _globalY) {
     return false;
@@ -8057,17 +8137,17 @@ var SplineEntity = (_class18 = class extends _chunkPOPXUPKRjs.Entity {
   
   
   
-  __init201() {this.offscreen = null}
-  __init202() {this.baked = false}
+  __init203() {this.offscreen = null}
+  __init204() {this.baked = false}
   /** Logical (CSS-pixel) size of the baked bitmap — the blit destination size. */
-  __init203() {this.bakedWidth = 0}
-  __init204() {this.bakedHeight = 0}
+  __init205() {this.bakedWidth = 0}
+  __init206() {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}
+  __init207() {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 +8155,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}
+  __init208() {this.polylines = null}
   /**
    * The spline document to render. Assigning a new document invalidates all
    * caches (baked canvas, flattened polylines, bounds).
@@ -8109,9 +8189,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}
+  __init209() {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();_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);_class18.prototype.__init208.call(this);_class18.prototype.__init209.call(this);;
     this._doc = doc;
     this._lineWidth = _nullishCoalesce(opts.lineWidth, () => ( 2));
     this.cache = _nullishCoalesce(opts.cache, () => ( true));
@@ -8131,7 +8211,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', _194 => _194._doc, 'access', _195 => _195.equations, 'optionalAccess', _196 => _196.some, 'call', _197 => _197((eq) => isGradient(eq.color_rgb))]), () => ( false))) || (_nullishCoalesce(_optionalChain([this, 'access', _198 => _198._doc, 'access', _199 => _199.paths, 'optionalAccess', _200 => _200.some, 'call', _201 => _201((p) => isGradient(p.color_rgb))]), () => ( false)));
   }
   /** Clear cached baked canvas and hit-test polylines. */
   invalidateCache() {
@@ -8518,19 +8598,19 @@ var _math = require('@vectojs/math'); _createStarExport(_math);
 // src/tree/DOMPortalEntity.ts
 var DOMPortalEntity = (_class19 = class extends _chunkPOPXUPKRjs.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 = ""}
+  __init210() {this.isDOMPortal = true}
+  __init211() {this.domListeners = []}
+  __init212() {this.resizeObserver = null}
+  __init213() {this.domBound = false}
+  __init214() {this.cachedWidth = 100}
+  __init215() {this.cachedHeight = 100}
+  __init216() {this.lastWidth = ""}
+  __init217() {this.lastHeight = ""}
+  __init218() {this.lastTransform = ""}
+  __init219() {this.lastZIndex = ""}
+  __init220() {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);_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);_class19.prototype.__init219.call(this);_class19.prototype.__init220.call(this);;
     this.domElement = domElement;
     this.width = _nullishCoalesce(width, () => ( 0));
     this.height = _nullishCoalesce(height, () => ( 0));
@@ -8642,8 +8722,8 @@ var DOMPortalEntity = (_class19 = class extends _chunkPOPXUPKRjs.Entity {
 }, _class19);
 
 // src/index.ts
-Scene.registerWebGLPointRendererCreator(_chunkKRUDTGNRjs.createWebGLPointRenderer);
-Scene.registerWebGPUParticleSystemManager(_chunkKRUDTGNRjs.WebGPUParticleSystemManager);
+Scene.registerWebGLPointRendererCreator(_chunkBKXERWADjs.createWebGLPointRenderer);
+Scene.registerWebGPUParticleSystemManager(_chunkBKXERWADjs.WebGPUParticleSystemManager);
 
 
 
@@ -8692,4 +8772,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.DOMPortalEntity = DOMPortalEntity; exports.Entity = _chunkPOPXUPKRjs.Entity; exports.GlyphRasterAtlas = _chunkBKXERWADjs.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 = _chunkBKXERWADjs.SVGRenderer; exports.Scene = Scene; exports.SplineEntity = SplineEntity; exports.TextEntity = TextEntity; exports.TextRasterCache = _chunkBKXERWADjs.TextRasterCache; exports.VECTO_USER_TIMING = VECTO_USER_TIMING; exports.VectoJSEvent = _chunkPOPXUPKRjs.VectoJSEvent; exports.WebGPUParticleSystemManager = _chunkBKXERWADjs.WebGPUParticleSystemManager; exports.beginVectoUserTiming = beginVectoUserTiming; exports.contentLineInHint = _chunkPOPXUPKRjs.contentLineInHint; exports.createWebGLPointRenderer = _chunkBKXERWADjs.createWebGLPointRenderer; exports.endVectoUserTiming = endVectoUserTiming; exports.installRendererDevTraps = _chunkBKXERWADjs.installRendererDevTraps; 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.sanitizeUrl = _chunkBKXERWADjs.sanitizeUrl; exports.setRendererDevMode = _chunkBKXERWADjs.setRendererDevMode;

package/dist/index.mjs

@@ -11,7 +11,7 @@ import {
   parseColorToRGBA,
   sanitizeUrl,
   setRendererDevMode
-} from "./chunk-RUM2KEDI.mjs";
+} from "./chunk-AISSDI6U.mjs";
 import {
   Entity,
   MSDFTextEntity,
@@ -1069,8 +1069,11 @@ var CanvasGeometry = 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
@@ -4178,6 +4181,8 @@ var Scene = class _Scene {
    *  this an embedded canvas stayed at its initial size forever. */
   canvasResizeObserver = null;
   dprChangeHandler = null;
+  dprPollInterval = null;
+  lastDpr = 1;
   // --- domain: a11y-projection — focus, overlay geometry, DOM ordering, portals ---
   focusedA11yElement = null;
   /**
@@ -4932,8 +4937,13 @@ var Scene = class _Scene {
       this.width = styleWidth ?? (canvas.width || canvas.clientWidth || 0);
       this.height = 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 && (globalProcess.env?.NODE_ENV === "test" || globalProcess.env?.VITEST === "true");
@@ -5165,16 +5175,52 @@ var Scene = class _Scene {
     if (this.dprMediaQuery && this.dprChangeHandler) {
       this.dprMediaQuery.removeEventListener?.("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 (this.renderer.isContextLost?.() !== 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 (this.renderer.isContextLost?.() !== true) this.render(this.renderer);
+      } catch (err) {
+        console.warn("[VectoJS] DPR repaint failed", err);
+      }
       this.watchDevicePixelRatio();
     };
     query.addEventListener?.("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 (this.renderer.isContextLost?.() !== 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,
@@ -5208,6 +5254,35 @@ var Scene = 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 = entries[0]?.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.
@@ -5393,6 +5468,10 @@ var Scene = class _Scene {
       this.dprMediaQuery = null;
       this.dprChangeHandler = null;
     }
+    if (this.dprPollInterval !== null) {
+      clearInterval(this.dprPollInterval);
+      this.dprPollInterval = null;
+    }
     if (this.forcedColorsQuery && this.forcedColorsChangeHandler) {
       this.forcedColorsQuery.removeEventListener?.("change", this.forcedColorsChangeHandler);
       this.forcedColorsQuery = null;
@@ -5466,6 +5545,7 @@ var Scene = 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];

package/dist/renderer.js

@@ -10,7 +10,7 @@
 
 
 
-var _chunkKRUDTGNRjs = require('./chunk-KRUDTGNR.js');
+var _chunkBKXERWADjs = require('./chunk-BKXERWAD.js');
 
 
 
@@ -22,4 +22,4 @@ var _chunkKRUDTGNRjs = require('./chunk-KRUDTGNR.js');
 
 
 
-exports.CanvasRenderer = _chunkKRUDTGNRjs.CanvasRenderer; exports.GlyphRasterAtlas = _chunkKRUDTGNRjs.GlyphRasterAtlas; exports.SVGRenderer = _chunkKRUDTGNRjs.SVGRenderer; exports.TextRasterCache = _chunkKRUDTGNRjs.TextRasterCache; exports.WebGPUParticleSystemManager = _chunkKRUDTGNRjs.WebGPUParticleSystemManager; exports.createWebGLPointRenderer = _chunkKRUDTGNRjs.createWebGLPointRenderer; exports.installRendererDevTraps = _chunkKRUDTGNRjs.installRendererDevTraps; exports.isRendererDevMode = _chunkKRUDTGNRjs.isRendererDevMode; exports.parseColorToRGBA = _chunkKRUDTGNRjs.parseColorToRGBA; exports.setRendererDevMode = _chunkKRUDTGNRjs.setRendererDevMode;
+exports.CanvasRenderer = _chunkBKXERWADjs.CanvasRenderer; exports.GlyphRasterAtlas = _chunkBKXERWADjs.GlyphRasterAtlas; exports.SVGRenderer = _chunkBKXERWADjs.SVGRenderer; exports.TextRasterCache = _chunkBKXERWADjs.TextRasterCache; exports.WebGPUParticleSystemManager = _chunkBKXERWADjs.WebGPUParticleSystemManager; exports.createWebGLPointRenderer = _chunkBKXERWADjs.createWebGLPointRenderer; exports.installRendererDevTraps = _chunkBKXERWADjs.installRendererDevTraps; exports.isRendererDevMode = _chunkBKXERWADjs.isRendererDevMode; exports.parseColorToRGBA = _chunkBKXERWADjs.parseColorToRGBA; exports.setRendererDevMode = _chunkBKXERWADjs.setRendererDevMode;

package/dist/renderer.mjs

@@ -9,7 +9,7 @@ import {
   isRendererDevMode,
   parseColorToRGBA,
   setRendererDevMode
-} from "./chunk-RUM2KEDI.mjs";
+} from "./chunk-AISSDI6U.mjs";
 export {
   CanvasRenderer,
   GlyphRasterAtlas,

package/dist/tree/Scene.d.ts

@@ -603,6 +603,8 @@ export declare class Scene {
      *  this an embedded canvas stayed at its initial size forever. */
     private canvasResizeObserver;
     private dprChangeHandler;
+    private dprPollInterval;
+    private lastDpr;
     private focusedA11yElement;
     /**
      * Canvas box geometry: the CSS↔logical mapping, overlay layer alignment, and
@@ -1155,6 +1157,21 @@ export declare class Scene {
      *     on the same canvas, restore DPR/size, and repaint.
      */
     private setupGLContextRecovery;
+    /**
+     * 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).
+     */
+    private armAttachmentViewportLatch;
     /**
      * Expose the underlying {@link IRenderer} for advanced direct-draw operations.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectojs/core",
-  "version": "1.39.0",
+  "version": "1.39.1",
   "publishConfig": {
     "access": "public"
   },
@@ -71,11 +71,11 @@
   },
   "devDependencies": {
     "@guidepup/virtual-screen-reader": "0.32.1",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/coverage-v8": "^4.1.11",
     "esbuild": "^0.28.1",
     "jsdom": "^30.0.1",
-    "puppeteer-core": "^25.7.0",
+    "puppeteer-core": "^25.8.0",
     "tsup": "^8.3.5",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   }
 }