@vectojs/core 1.9.2 → 1.11.0

package/dist/{chunk-GKLTTGBR.js → chunk-2Z23LTH3.js}

@@ -710,6 +710,25 @@ var Entity = (_class4 = class {
       handlers.forEach((h) => h(payload));
     }
   }
+  /**
+   * Programmatically focus the entity's projected a11y shadow element, if one
+   * exists. After `scene.add(entity)` the shadow element is typically created
+   * on the next a11y sync (within one animation frame), so this method retries
+   * once on the next rAF if the element isn't immediately available — matching
+   * the timing pattern the prior workaround described in findings.md achieved
+   * with `requestAnimationFrame(() => document.getElementById(id)?.focus())`.
+   */
+  focus() {
+    const el = _optionalChain([this, 'access', _57 => _57.scene, 'optionalAccess', _58 => _58.getA11yElement, 'call', _59 => _59(this.id)]);
+    if (el) {
+      el.focus();
+      return;
+    }
+    requestAnimationFrame(() => {
+      const retry = _optionalChain([this, 'access', _60 => _60.scene, 'optionalAccess', _61 => _61.getA11yElement, 'call', _62 => _62(this.id)]);
+      if (retry) retry.focus();
+    });
+  }
   /** Run one node's listeners for the event, honoring stopImmediatePropagation. */
   fireListeners(node, map, event) {
     const handlers = map.get(event.type);
@@ -1141,7 +1160,7 @@ var MSDFTextEntity = (_class6 = class extends Entity {
         if (res.seqId < this.lastRenderedSeqId) return;
         this.lastRenderedSeqId = res.seqId;
         this.layoutResult = res;
-        _optionalChain([this, 'access', _57 => _57.scene, 'optionalAccess', _58 => _58.markDirty, 'call', _59 => _59()]);
+        _optionalChain([this, 'access', _63 => _63.scene, 'optionalAccess', _64 => _64.markDirty, 'call', _65 => _65()]);
       }
     });
   }

package/dist/{chunk-BPMNCGU7.js → chunk-ORCPCIJ7.js}

@@ -7,6 +7,15 @@ var CanvasRenderer = (_class = class _CanvasRenderer {
   
   
   
+  /**
+   * Cap on the effective device pixel ratio applied by the constructor and
+   * {@link resize}. `undefined` (default) uses the real, uncapped
+   * `devicePixelRatio` — unchanged from prior versions. Set directly, or via
+   * the constructor's third argument; `Scene` (see `SceneOptions.maxDPR`)
+   * keeps this in sync on every {@link resize} call, since the real DPR can
+   * change at runtime (e.g. a window dragged between displays).
+   */
+  
   /**
    * Max circles per batched `fill()`. A single Canvas 2D `fill()` over a path is
    * superlinear in sub-path count, so an unbounded batch is *slower* than many
@@ -27,9 +36,11 @@ var CanvasRenderer = (_class = class _CanvasRenderer {
    *   fullscreen canvas and sizes to the window — pass this for embedded /
    *   custom-container canvases (the Scene does when `disableWindowResize` is
    *   set) so the canvas's own dimensions aren't clobbered by the window's.
+   * @param maxDPR - See {@link maxDPR}.
    */
-  constructor(canvas, size) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);
-    const dpr = getDevicePixelRatio();
+  constructor(canvas, size, maxDPR) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);
+    this.maxDPR = maxDPR;
+    const dpr = this.effectiveDPR();
     this.width = _nullishCoalesce(_optionalChain([size, 'optionalAccess', _ => _.width]), () => ( (typeof window !== "undefined" ? window.innerWidth : canvas.width || 0)));
     this.height = _nullishCoalesce(_optionalChain([size, 'optionalAccess', _2 => _2.height]), () => ( (typeof window !== "undefined" ? window.innerHeight : canvas.height || 0)));
     canvas.width = this.width * dpr;
@@ -51,6 +62,11 @@ var CanvasRenderer = (_class = class _CanvasRenderer {
   getContext() {
     return this.ctx;
   }
+  /** Real `devicePixelRatio`, clamped to {@link maxDPR} when set. */
+  effectiveDPR() {
+    const real = getDevicePixelRatio();
+    return this.maxDPR !== void 0 ? Math.min(real, this.maxDPR) : real;
+  }
   /**
    * Resize the backing canvas buffer and re-apply DPR scaling.
    *
@@ -60,7 +76,7 @@ var CanvasRenderer = (_class = class _CanvasRenderer {
    * @param height - New logical height in CSS pixels.
    */
   resize(width, height) {
-    const dpr = getDevicePixelRatio();
+    const dpr = this.effectiveDPR();
     this.width = width;
     this.height = height;
     this.ctx.canvas.width = width * dpr;
@@ -1028,11 +1044,13 @@ function createWebGLPointRenderer(canvas) {
     gl.bindVertexArray(null);
     glyphCount = 0;
   };
-  return {
+  const renderer = {
+    maxDPR: void 0,
     resize(width, height) {
       logicalW = width;
       logicalH = height;
-      dpr = typeof devicePixelRatio !== "undefined" ? devicePixelRatio || 1 : 1;
+      const realDpr = typeof devicePixelRatio !== "undefined" ? devicePixelRatio || 1 : 1;
+      dpr = renderer.maxDPR !== void 0 ? Math.min(realDpr, renderer.maxDPR) : realDpr;
       canvas.width = Math.round(width * dpr);
       canvas.height = Math.round(height * dpr);
       canvas.style.width = `${width}px`;
@@ -1290,6 +1308,7 @@ function createWebGLPointRenderer(canvas) {
       if (msdfTexture) gl.deleteTexture(msdfTexture);
     }
   };
+  return renderer;
 }
 
 // src/renderer/WebGPUParticleSystemManager.ts

package/dist/{chunk-J2P6QZJV.mjs → chunk-XIEQHSBB.mjs}

@@ -710,6 +710,25 @@ var Entity = class {
       handlers.forEach((h) => h(payload));
     }
   }
+  /**
+   * Programmatically focus the entity's projected a11y shadow element, if one
+   * exists. After `scene.add(entity)` the shadow element is typically created
+   * on the next a11y sync (within one animation frame), so this method retries
+   * once on the next rAF if the element isn't immediately available — matching
+   * the timing pattern the prior workaround described in findings.md achieved
+   * with `requestAnimationFrame(() => document.getElementById(id)?.focus())`.
+   */
+  focus() {
+    const el = this.scene?.getA11yElement(this.id);
+    if (el) {
+      el.focus();
+      return;
+    }
+    requestAnimationFrame(() => {
+      const retry = this.scene?.getA11yElement(this.id);
+      if (retry) retry.focus();
+    });
+  }
   /** Run one node's listeners for the event, honoring stopImmediatePropagation. */
   fireListeners(node, map, event) {
     const handlers = map.get(event.type);

package/dist/{chunk-WT2XZHJQ.mjs → chunk-XZEPHCDZ.mjs}

@@ -7,6 +7,15 @@ var CanvasRenderer = class _CanvasRenderer {
   ctx;
   width;
   height;
+  /**
+   * Cap on the effective device pixel ratio applied by the constructor and
+   * {@link resize}. `undefined` (default) uses the real, uncapped
+   * `devicePixelRatio` — unchanged from prior versions. Set directly, or via
+   * the constructor's third argument; `Scene` (see `SceneOptions.maxDPR`)
+   * keeps this in sync on every {@link resize} call, since the real DPR can
+   * change at runtime (e.g. a window dragged between displays).
+   */
+  maxDPR;
   /**
    * Max circles per batched `fill()`. A single Canvas 2D `fill()` over a path is
    * superlinear in sub-path count, so an unbounded batch is *slower* than many
@@ -27,9 +36,11 @@ var CanvasRenderer = class _CanvasRenderer {
    *   fullscreen canvas and sizes to the window — pass this for embedded /
    *   custom-container canvases (the Scene does when `disableWindowResize` is
    *   set) so the canvas's own dimensions aren't clobbered by the window's.
+   * @param maxDPR - See {@link maxDPR}.
    */
-  constructor(canvas, size) {
-    const dpr = getDevicePixelRatio();
+  constructor(canvas, size, maxDPR) {
+    this.maxDPR = maxDPR;
+    const dpr = this.effectiveDPR();
     this.width = size?.width ?? (typeof window !== "undefined" ? window.innerWidth : canvas.width || 0);
     this.height = size?.height ?? (typeof window !== "undefined" ? window.innerHeight : canvas.height || 0);
     canvas.width = this.width * dpr;
@@ -51,6 +62,11 @@ var CanvasRenderer = class _CanvasRenderer {
   getContext() {
     return this.ctx;
   }
+  /** Real `devicePixelRatio`, clamped to {@link maxDPR} when set. */
+  effectiveDPR() {
+    const real = getDevicePixelRatio();
+    return this.maxDPR !== void 0 ? Math.min(real, this.maxDPR) : real;
+  }
   /**
    * Resize the backing canvas buffer and re-apply DPR scaling.
    *
@@ -60,7 +76,7 @@ var CanvasRenderer = class _CanvasRenderer {
    * @param height - New logical height in CSS pixels.
    */
   resize(width, height) {
-    const dpr = getDevicePixelRatio();
+    const dpr = this.effectiveDPR();
     this.width = width;
     this.height = height;
     this.ctx.canvas.width = width * dpr;
@@ -1028,11 +1044,13 @@ function createWebGLPointRenderer(canvas) {
     gl.bindVertexArray(null);
     glyphCount = 0;
   };
-  return {
+  const renderer = {
+    maxDPR: void 0,
     resize(width, height) {
       logicalW = width;
       logicalH = height;
-      dpr = typeof devicePixelRatio !== "undefined" ? devicePixelRatio || 1 : 1;
+      const realDpr = typeof devicePixelRatio !== "undefined" ? devicePixelRatio || 1 : 1;
+      dpr = renderer.maxDPR !== void 0 ? Math.min(realDpr, renderer.maxDPR) : realDpr;
       canvas.width = Math.round(width * dpr);
       canvas.height = Math.round(height * dpr);
       canvas.style.width = `${width}px`;
@@ -1290,6 +1308,7 @@ function createWebGLPointRenderer(canvas) {
       if (msdfTexture) gl.deleteTexture(msdfTexture);
     }
   };
+  return renderer;
 }
 
 // src/renderer/WebGPUParticleSystemManager.ts