@vectojs/core 1.32.6 → 1.33.0

package/dist/{chunk-TRT2TRCW.js → chunk-UEIZDNK7.js}

@@ -73,62 +73,66 @@ var VectoJSEvent = (_class = class {
   get deltaY() {
     return _optionalChain([this, 'access', _9 => _9.nativeEvent, 'optionalAccess', _10 => _10.deltaY]);
   }
+  /** Native wheel delta mode (0=pixels, 1=lines, 2=pages), if this wraps a `WheelEvent`. */
+  get deltaMode() {
+    return _optionalChain([this, 'access', _11 => _11.nativeEvent, 'optionalAccess', _12 => _12.deltaMode]);
+  }
   /** Native pointer X, if this wraps a pointer/mouse event. */
   get clientX() {
-    return _optionalChain([this, 'access', _11 => _11.nativeEvent, 'optionalAccess', _12 => _12.clientX]);
+    return _optionalChain([this, 'access', _13 => _13.nativeEvent, 'optionalAccess', _14 => _14.clientX]);
   }
   /** Native pointer Y, if this wraps a pointer/mouse event. */
   get clientY() {
-    return _optionalChain([this, 'access', _13 => _13.nativeEvent, 'optionalAccess', _14 => _14.clientY]);
+    return _optionalChain([this, 'access', _15 => _15.nativeEvent, 'optionalAccess', _16 => _16.clientY]);
   }
   get resolvedScenePoint() {
     if (this.explicitScenePoint) return this.explicitScenePoint;
     const native = this.nativeEvent;
-    if (_optionalChain([native, 'optionalAccess', _15 => _15.vectoSceneX]) !== void 0 && native.vectoSceneY !== void 0) {
+    if (_optionalChain([native, 'optionalAccess', _17 => _17.vectoSceneX]) !== void 0 && native.vectoSceneY !== void 0) {
       return { x: native.vectoSceneX, y: native.vectoSceneY };
     }
-    if (_optionalChain([native, 'optionalAccess', _16 => _16.clientX]) === void 0 || native.clientY === void 0) return void 0;
+    if (_optionalChain([native, 'optionalAccess', _18 => _18.clientX]) === void 0 || native.clientY === void 0) return void 0;
     const scene = this.target.scene;
-    return _nullishCoalesce(_optionalChain([scene, 'optionalAccess', _17 => _17.clientToScene, 'optionalCall', _18 => _18(native.clientX, native.clientY)]), () => ( {
+    return _nullishCoalesce(_optionalChain([scene, 'optionalAccess', _19 => _19.clientToScene, 'optionalCall', _20 => _20(native.clientX, native.clientY)]), () => ( {
       x: native.clientX,
       y: native.clientY
     }));
   }
   /** Pointer X in the Scene's logical coordinate space. */
   get sceneX() {
-    return _optionalChain([this, 'access', _19 => _19.resolvedScenePoint, 'optionalAccess', _20 => _20.x]);
+    return _optionalChain([this, 'access', _21 => _21.resolvedScenePoint, 'optionalAccess', _22 => _22.x]);
   }
   /** Pointer Y in the Scene's logical coordinate space. */
   get sceneY() {
-    return _optionalChain([this, 'access', _21 => _21.resolvedScenePoint, 'optionalAccess', _22 => _22.y]);
+    return _optionalChain([this, 'access', _23 => _23.resolvedScenePoint, 'optionalAccess', _24 => _24.y]);
   }
   /** Pointer X local to the entity whose listener is currently running. */
   get localX() {
     const point = this.resolvedScenePoint;
     if (!point) return void 0;
-    return _optionalChain([this, 'access', _23 => _23.currentTarget, 'access', _24 => _24.worldToLocal, 'call', _25 => _25(point.x, point.y), 'optionalAccess', _26 => _26.x]);
+    return _optionalChain([this, 'access', _25 => _25.currentTarget, 'access', _26 => _26.worldToLocal, 'call', _27 => _27(point.x, point.y), 'optionalAccess', _28 => _28.x]);
   }
   /** Pointer Y local to the entity whose listener is currently running. */
   get localY() {
     const point = this.resolvedScenePoint;
     if (!point) return void 0;
-    return _optionalChain([this, 'access', _27 => _27.currentTarget, 'access', _28 => _28.worldToLocal, 'call', _29 => _29(point.x, point.y), 'optionalAccess', _30 => _30.y]);
+    return _optionalChain([this, 'access', _29 => _29.currentTarget, 'access', _30 => _30.worldToLocal, 'call', _31 => _31(point.x, point.y), 'optionalAccess', _32 => _32.y]);
   }
   get shiftKey() {
-    return !!_optionalChain([this, 'access', _31 => _31.nativeEvent, 'optionalAccess', _32 => _32.shiftKey]);
+    return !!_optionalChain([this, 'access', _33 => _33.nativeEvent, 'optionalAccess', _34 => _34.shiftKey]);
   }
   get ctrlKey() {
-    return !!_optionalChain([this, 'access', _33 => _33.nativeEvent, 'optionalAccess', _34 => _34.ctrlKey]);
+    return !!_optionalChain([this, 'access', _35 => _35.nativeEvent, 'optionalAccess', _36 => _36.ctrlKey]);
   }
   get altKey() {
-    return !!_optionalChain([this, 'access', _35 => _35.nativeEvent, 'optionalAccess', _36 => _36.altKey]);
+    return !!_optionalChain([this, 'access', _37 => _37.nativeEvent, 'optionalAccess', _38 => _38.altKey]);
   }
   get metaKey() {
-    return !!_optionalChain([this, 'access', _37 => _37.nativeEvent, 'optionalAccess', _38 => _38.metaKey]);
+    return !!_optionalChain([this, 'access', _39 => _39.nativeEvent, 'optionalAccess', _40 => _40.metaKey]);
   }
   /** Native key, if this wraps a keyboard event. */
   get key() {
-    return _optionalChain([this, 'access', _39 => _39.nativeEvent, 'optionalAccess', _40 => _40.key]);
+    return _optionalChain([this, 'access', _41 => _41.nativeEvent, 'optionalAccess', _42 => _42.key]);
   }
 }, _class);
 var Entity = (_class2 = class {
@@ -318,13 +322,40 @@ var Entity = (_class2 = class {
    * fixed viewport. Off by default (children render unclipped). Canvas2D only.
    */
   __init36() {this.clipChildren = false}
+  /**
+   * Group this subtree's projected text into its own accessibility **region**,
+   * without clipping anything.
+   *
+   * The projection sorts every mirror into visual reading order, and it bands
+   * them into rows per region so that side-by-side columns stay contiguous runs
+   * in the DOM. That matters beyond reading order: a native `Selection` covers
+   * everything between its anchor and focus in DOM order, so two columns banded
+   * together let a vertical drag through one of them swallow the other.
+   *
+   * {@link clipChildren} also establishes a region, because a clipper is
+   * usually the column boundary you want. Reach for this flag when the two
+   * needs come apart — a sidebar, a card deck or any column that must not be
+   * absorbed by its neighbour's drag, but that draws nothing and has no reason
+   * to clip. Measured in a real app before this existed: a table-of-contents
+   * sidebar had to switch `clipChildren` on purely to escape the body column's
+   * bands, buying a per-frame `save`/`clip`/`restore` for an entity that paints
+   * nothing.
+   *
+   * Unlike `clipChildren`, this is honoured regardless of the node's box. The
+   * zero-area exemption on the clipping path exists because a zero-area clipper
+   * clips nothing; grouping is a declaration of intent that never consults
+   * geometry, and a pure grouping container often leaves `width`/`height` at 0.
+   *
+   * Off by default. Regions nest: the nearest enclosing region wins.
+   */
+  __init37() {this.a11yRegion = false}
   // Lazily allocated (see _drivers above). Most entities never register a
   // listener or an imperative animate() tween.
-  __init37() {this.listeners = null}
+  __init38() {this.listeners = null}
   /** Capture-phase listeners (fired root→target before bubble). */
-  __init38() {this.captureListeners = null}
-  __init39() {this.animations = null}
-  constructor(id) {;_class2.prototype.__init3.call(this);_class2.prototype.__init4.call(this);_class2.prototype.__init5.call(this);_class2.prototype.__init6.call(this);_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);_class2.prototype.__init11.call(this);_class2.prototype.__init12.call(this);_class2.prototype.__init13.call(this);_class2.prototype.__init14.call(this);_class2.prototype.__init15.call(this);_class2.prototype.__init16.call(this);_class2.prototype.__init17.call(this);_class2.prototype.__init18.call(this);_class2.prototype.__init19.call(this);_class2.prototype.__init20.call(this);_class2.prototype.__init21.call(this);_class2.prototype.__init22.call(this);_class2.prototype.__init23.call(this);_class2.prototype.__init24.call(this);_class2.prototype.__init25.call(this);_class2.prototype.__init26.call(this);_class2.prototype.__init27.call(this);_class2.prototype.__init28.call(this);_class2.prototype.__init29.call(this);_class2.prototype.__init30.call(this);_class2.prototype.__init31.call(this);_class2.prototype.__init32.call(this);_class2.prototype.__init33.call(this);_class2.prototype.__init34.call(this);_class2.prototype.__init35.call(this);_class2.prototype.__init36.call(this);_class2.prototype.__init37.call(this);_class2.prototype.__init38.call(this);_class2.prototype.__init39.call(this);
+  __init39() {this.captureListeners = null}
+  __init40() {this.animations = null}
+  constructor(id) {;_class2.prototype.__init3.call(this);_class2.prototype.__init4.call(this);_class2.prototype.__init5.call(this);_class2.prototype.__init6.call(this);_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);_class2.prototype.__init11.call(this);_class2.prototype.__init12.call(this);_class2.prototype.__init13.call(this);_class2.prototype.__init14.call(this);_class2.prototype.__init15.call(this);_class2.prototype.__init16.call(this);_class2.prototype.__init17.call(this);_class2.prototype.__init18.call(this);_class2.prototype.__init19.call(this);_class2.prototype.__init20.call(this);_class2.prototype.__init21.call(this);_class2.prototype.__init22.call(this);_class2.prototype.__init23.call(this);_class2.prototype.__init24.call(this);_class2.prototype.__init25.call(this);_class2.prototype.__init26.call(this);_class2.prototype.__init27.call(this);_class2.prototype.__init28.call(this);_class2.prototype.__init29.call(this);_class2.prototype.__init30.call(this);_class2.prototype.__init31.call(this);_class2.prototype.__init32.call(this);_class2.prototype.__init33.call(this);_class2.prototype.__init34.call(this);_class2.prototype.__init35.call(this);_class2.prototype.__init36.call(this);_class2.prototype.__init37.call(this);_class2.prototype.__init38.call(this);_class2.prototype.__init39.call(this);_class2.prototype.__init40.call(this);
     this.id = id || `entity_${Math.random().toString(36).substring(2, 9)}`;
   }
   /**
@@ -358,7 +389,7 @@ var Entity = (_class2 = class {
     const s = this.scene;
     if (s) {
       s.a11yNeedsReorder = true;
-      _optionalChain([s, 'access', _41 => _41.markStructureChanged, 'optionalCall', _42 => _42()]);
+      _optionalChain([s, 'access', _43 => _43.markStructureChanged, 'optionalCall', _44 => _44()]);
       s.markDirty({ entity: this.id, reason: "child-added" });
       child._notifyMounted();
     }
@@ -388,7 +419,7 @@ var Entity = (_class2 = class {
       if (s) {
         s.detachA11y(child);
         s.a11yNeedsReorder = true;
-        _optionalChain([s, 'access', _43 => _43.markStructureChanged, 'optionalCall', _44 => _44()]);
+        _optionalChain([s, 'access', _45 => _45.markStructureChanged, 'optionalCall', _46 => _46()]);
         s.markDirty({ entity: this.id, reason: "child-removed" });
       }
     }
@@ -443,7 +474,7 @@ var Entity = (_class2 = class {
       startTime: -1,
       startProps: {}
     });
-    _optionalChain([this, 'access', _45 => _45.scene, 'optionalAccess', _46 => _46.markDirty, 'call', _47 => _47({ entity: this.id, reason: "animation-start" })]);
+    _optionalChain([this, 'access', _47 => _47.scene, 'optionalAccess', _48 => _48.markDirty, 'call', _49 => _49({ entity: this.id, reason: "animation-start" })]);
     return this;
   }
   /** Write a driver-computed value to a backing field without re-triggering the setter. */
@@ -490,26 +521,26 @@ var Entity = (_class2 = class {
    * that need to seed a starting state (e.g. the presence helper's enter `from`).
    */
   setImmediate(prop, v) {
-    const existing = _optionalChain([this, 'access', _48 => _48._drivers, 'optionalAccess', _49 => _49.get, 'call', _50 => _50(prop)]);
+    const existing = _optionalChain([this, 'access', _50 => _50._drivers, 'optionalAccess', _51 => _51.get, 'call', _52 => _52(prop)]);
     if (existing) this._settleDriver(existing);
-    _optionalChain([this, 'access', _51 => _51._drivers, 'optionalAccess', _52 => _52.delete, 'call', _53 => _53(prop)]);
+    _optionalChain([this, 'access', _53 => _53._drivers, 'optionalAccess', _54 => _54.delete, 'call', _55 => _55(prop)]);
     this._applyAnimated(prop, v);
   }
   _settleDriver(driver) {
     const active = driver;
     const onDone = active.onDone;
     active.onDone = void 0;
-    _optionalChain([onDone, 'optionalCall', _54 => _54()]);
+    _optionalChain([onDone, 'optionalCall', _56 => _56()]);
   }
   _spawnDriver(prop, to, cfg) {
-    if (prop !== "opacity" && _optionalChain([this, 'access', _55 => _55.scene, 'optionalAccess', _56 => _56.prefersReducedMotion])) {
-      const existing2 = _optionalChain([this, 'access', _57 => _57._drivers, 'optionalAccess', _58 => _58.get, 'call', _59 => _59(prop)]);
+    if (prop !== "opacity" && _optionalChain([this, 'access', _57 => _57.scene, 'optionalAccess', _58 => _58.prefersReducedMotion])) {
+      const existing2 = _optionalChain([this, 'access', _59 => _59._drivers, 'optionalAccess', _60 => _60.get, 'call', _61 => _61(prop)]);
       if (existing2) this._settleDriver(existing2);
-      _optionalChain([this, 'access', _60 => _60._drivers, 'optionalAccess', _61 => _61.delete, 'call', _62 => _62(prop)]);
+      _optionalChain([this, 'access', _62 => _62._drivers, 'optionalAccess', _63 => _63.delete, 'call', _64 => _64(prop)]);
       this._applyAnimated(prop, to);
       return;
     }
-    const existing = _optionalChain([this, 'access', _63 => _63._drivers, 'optionalAccess', _64 => _64.get, 'call', _65 => _65(prop)]);
+    const existing = _optionalChain([this, 'access', _65 => _65._drivers, 'optionalAccess', _66 => _66.get, 'call', _67 => _67(prop)]);
     if (existing) {
       this._settleDriver(existing);
       existing.retarget(to);
@@ -518,12 +549,12 @@ var Entity = (_class2 = class {
     const from = this._currentOf(prop);
     const driver = _animation.isTweenConfig.call(void 0, cfg) ? new (0, _animation.TweenDriver)(from, to, cfg) : new (0, _animation.SpringDriver)(from, to, cfg === "spring" ? {} : cfg);
     (this._drivers ??= /* @__PURE__ */ new Map()).set(prop, driver);
-    _optionalChain([this, 'access', _66 => _66.scene, 'optionalAccess', _67 => _67.markDirty, 'call', _68 => _68({ entity: this.id, reason: "driver-added" })]);
-    _optionalChain([this, 'access', _69 => _69.scene, 'optionalAccess', _70 => _70._registerActiveDriverEntity, 'call', _71 => _71(this)]);
+    _optionalChain([this, 'access', _68 => _68.scene, 'optionalAccess', _69 => _69.markDirty, 'call', _70 => _70({ entity: this.id, reason: "driver-added" })]);
+    _optionalChain([this, 'access', _71 => _71.scene, 'optionalAccess', _72 => _72._registerActiveDriverEntity, 'call', _73 => _73(this)]);
   }
   /** Assignment path when a declarative transition is configured for `prop`. */
   _animateProp(prop, to) {
-    const cfg = _optionalChain([this, 'access', _72 => _72._transitions, 'optionalAccess', _73 => _73.get, 'call', _74 => _74(prop)]);
+    const cfg = _optionalChain([this, 'access', _74 => _74._transitions, 'optionalAccess', _75 => _75.get, 'call', _76 => _76(prop)]);
     if (!cfg) {
       this._applyAnimated(prop, to);
       return;
@@ -552,7 +583,7 @@ var Entity = (_class2 = class {
       entries.map(
         (e) => new Promise((resolve) => {
           this._spawnDriver(e[0], e[1], cfg);
-          const d = _optionalChain([this, 'access', _75 => _75._drivers, 'optionalAccess', _76 => _76.get, 'call', _77 => _77(e[0])]);
+          const d = _optionalChain([this, 'access', _77 => _77._drivers, 'optionalAccess', _78 => _78.get, 'call', _79 => _79(e[0])]);
           if (!d)
             resolve();
           else d.onDone = resolve;
@@ -574,7 +605,7 @@ var Entity = (_class2 = class {
         this._applyAnimated(prop, driver.value);
       }
     }
-    _optionalChain([this, 'access', _78 => _78.scene, 'optionalAccess', _79 => _79.markDirty, 'call', _80 => _80({ entity: this.id, reason: "driver-tick" })]);
+    _optionalChain([this, 'access', _80 => _80.scene, 'optionalAccess', _81 => _81.markDirty, 'call', _82 => _82({ entity: this.id, reason: "driver-tick" })]);
   }
   /**
    * Internal: this entity's active-driver map (read-only view), or `null` if
@@ -599,7 +630,7 @@ var Entity = (_class2 = class {
     if (driver.isDone()) {
       this._applyAnimated(prop, driver.target);
       this._settleDriver(driver);
-      _optionalChain([this, 'access', _81 => _81._drivers, 'optionalAccess', _82 => _82.delete, 'call', _83 => _83(prop)]);
+      _optionalChain([this, 'access', _83 => _83._drivers, 'optionalAccess', _84 => _84.delete, 'call', _85 => _85(prop)]);
     } else {
       this._applyAnimated(prop, driver.value);
     }
@@ -660,7 +691,7 @@ var Entity = (_class2 = class {
    * @example entity.on('click', (e) => console.log('clicked', e));
    */
   on(event, callback, options) {
-    const map = _optionalChain([options, 'optionalAccess', _84 => _84.capture]) ? this.captureListeners ??= /* @__PURE__ */ new Map() : this.listeners ??= /* @__PURE__ */ new Map();
+    const map = _optionalChain([options, 'optionalAccess', _86 => _86.capture]) ? this.captureListeners ??= /* @__PURE__ */ new Map() : this.listeners ??= /* @__PURE__ */ new Map();
     if (!map.has(event)) {
       map.set(event, []);
     }
@@ -676,7 +707,7 @@ var Entity = (_class2 = class {
    * @returns `this` for method chaining.
    */
   off(event, callback, options) {
-    const handlers = _optionalChain([(_optionalChain([options, 'optionalAccess', _85 => _85.capture]) ? this.captureListeners : this.listeners), 'optionalAccess', _86 => _86.get, 'call', _87 => _87(event)]);
+    const handlers = _optionalChain([(_optionalChain([options, 'optionalAccess', _87 => _87.capture]) ? this.captureListeners : this.listeners), 'optionalAccess', _88 => _88.get, 'call', _89 => _89(event)]);
     if (handlers) {
       const idx = handlers.indexOf(callback);
       if (idx !== -1) handlers.splice(idx, 1);
@@ -713,8 +744,8 @@ var Entity = (_class2 = class {
       }
       this._drivers.clear();
     }
-    _optionalChain([this, 'access', _88 => _88.listeners, 'optionalAccess', _89 => _89.clear, 'call', _90 => _90()]);
-    _optionalChain([this, 'access', _91 => _91.captureListeners, 'optionalAccess', _92 => _92.clear, 'call', _93 => _93()]);
+    _optionalChain([this, 'access', _90 => _90.listeners, 'optionalAccess', _91 => _91.clear, 'call', _92 => _92()]);
+    _optionalChain([this, 'access', _93 => _93.captureListeners, 'optionalAccess', _94 => _94.clear, 'call', _95 => _95()]);
     if (this.parent) {
       this.parent.remove(this);
     }
@@ -729,7 +760,7 @@ var Entity = (_class2 = class {
    * @param payload - Arbitrary data forwarded to each listener.
    */
   emit(event, payload) {
-    const handlers = _optionalChain([this, 'access', _94 => _94.listeners, 'optionalAccess', _95 => _95.get, 'call', _96 => _96(event)]);
+    const handlers = _optionalChain([this, 'access', _96 => _96.listeners, 'optionalAccess', _97 => _97.get, 'call', _98 => _98(event)]);
     if (handlers) {
       handlers.forEach((h) => h(payload));
     }
@@ -743,19 +774,19 @@ var Entity = (_class2 = class {
    * with `requestAnimationFrame(() => document.getElementById(id)?.focus())`.
    */
   focus() {
-    const el = _optionalChain([this, 'access', _97 => _97.scene, 'optionalAccess', _98 => _98.getA11yElement, 'call', _99 => _99(this.id)]);
+    const el = _optionalChain([this, 'access', _99 => _99.scene, 'optionalAccess', _100 => _100.getA11yElement, 'call', _101 => _101(this.id)]);
     if (el) {
       el.focus();
       return;
     }
     requestAnimationFrame(() => {
-      const retry = _optionalChain([this, 'access', _100 => _100.scene, 'optionalAccess', _101 => _101.getA11yElement, 'call', _102 => _102(this.id)]);
+      const retry = _optionalChain([this, 'access', _102 => _102.scene, 'optionalAccess', _103 => _103.getA11yElement, 'call', _104 => _104(this.id)]);
       if (retry) retry.focus();
     });
   }
   /** Run one node's listeners for the event, honoring stopImmediatePropagation. */
   fireListeners(node, map, event) {
-    const handlers = _optionalChain([map, 'optionalAccess', _103 => _103.get, 'call', _104 => _104(event.type)]);
+    const handlers = _optionalChain([map, 'optionalAccess', _105 => _105.get, 'call', _106 => _106(event.type)]);
     if (!handlers) return;
     event.currentTarget = node;
     for (const h of handlers.slice()) {
@@ -1142,7 +1173,7 @@ var Entity = (_class2 = class {
    * @returns `true` if at least one animation or property driver remains.
    */
   hasPendingAnimations() {
-    return (_nullishCoalesce(_optionalChain([this, 'access', _105 => _105.animations, 'optionalAccess', _106 => _106.length]), () => ( 0))) > 0 || (_nullishCoalesce(_optionalChain([this, 'access', _107 => _107._drivers, 'optionalAccess', _108 => _108.size]), () => ( 0))) > 0;
+    return (_nullishCoalesce(_optionalChain([this, 'access', _107 => _107.animations, 'optionalAccess', _108 => _108.length]), () => ( 0))) > 0 || (_nullishCoalesce(_optionalChain([this, 'access', _109 => _109._drivers, 'optionalAccess', _110 => _110.size]), () => ( 0))) > 0;
   }
 }, _class2);
 
@@ -1164,22 +1195,22 @@ var MSDFTextEntity = (_class3 = class extends Entity {
   // joined by soft hyphens (U+00AD); the worker then treats those as break
   // opportunities. `text` keeps the original string for a11y/content
   // projection; `layoutText` is the soft-hyphen-annotated string sent to layout.
-  __init40() {this.hyphenator = null}
-  __init41() {this.layoutText = ""}
-  __init42() {this.text = ""}
-  __init43() {this.lastRenderedSeqId = 0}
+  __init41() {this.hyphenator = null}
+  __init42() {this.layoutText = ""}
+  __init43() {this.text = ""}
+  __init44() {this.lastRenderedSeqId = 0}
   /** Bumped by {@link queueLayout}; read by `Scene` to skip an unchanged sync. */
-  __init44() {this.contentEpoch = 0}
+  __init45() {this.contentEpoch = 0}
   // Atlas-decode subscription (see watchAtlasDecode). Held so `destroy()` can
   // release it: the handler closes over `this`, so leaving it attached to a
   // long-lived shared atlas image would retain the whole entity.
-  __init45() {this.atlasDecodeTarget = null}
-  __init46() {this.atlasDecodeHandler = null}
-  __init47() {this.rgbColorCache = /* @__PURE__ */ new Map()}
-  __init48() {this.fontStringCache = []}
-  __init49() {this.layoutResult = null}
+  __init46() {this.atlasDecodeTarget = null}
+  __init47() {this.atlasDecodeHandler = null}
+  __init48() {this.rgbColorCache = /* @__PURE__ */ new Map()}
+  __init49() {this.fontStringCache = []}
+  __init50() {this.layoutResult = null}
   constructor(text, options) {
-    super();_class3.prototype.__init40.call(this);_class3.prototype.__init41.call(this);_class3.prototype.__init42.call(this);_class3.prototype.__init43.call(this);_class3.prototype.__init44.call(this);_class3.prototype.__init45.call(this);_class3.prototype.__init46.call(this);_class3.prototype.__init47.call(this);_class3.prototype.__init48.call(this);_class3.prototype.__init49.call(this);;
+    super();_class3.prototype.__init41.call(this);_class3.prototype.__init42.call(this);_class3.prototype.__init43.call(this);_class3.prototype.__init44.call(this);_class3.prototype.__init45.call(this);_class3.prototype.__init46.call(this);_class3.prototype.__init47.call(this);_class3.prototype.__init48.call(this);_class3.prototype.__init49.call(this);_class3.prototype.__init50.call(this);;
     this.font = options.font;
     this.texture = options.texture;
     this.fallbackFont = _nullishCoalesce(options.fallbackFont, () => ( "sans-serif"));
@@ -1224,7 +1255,7 @@ var MSDFTextEntity = (_class3 = class extends Entity {
     const target = this.texture;
     this.atlasDecodeHandler = () => {
       this.detachAtlasDecodeListener();
-      _optionalChain([this, 'access', _109 => _109.scene, 'optionalAccess', _110 => _110.markDirty, 'call', _111 => _111()]);
+      _optionalChain([this, 'access', _111 => _111.scene, 'optionalAccess', _112 => _112.markDirty, 'call', _113 => _113()]);
     };
     target.addEventListener("load", this.atlasDecodeHandler);
     target.addEventListener("error", this.atlasDecodeHandler);
@@ -1303,7 +1334,7 @@ var MSDFTextEntity = (_class3 = class extends Entity {
         if (res.seqId < this.lastRenderedSeqId) return;
         this.lastRenderedSeqId = res.seqId;
         this.layoutResult = res;
-        _optionalChain([this, 'access', _112 => _112.scene, 'optionalAccess', _113 => _113.markDirty, 'call', _114 => _114()]);
+        _optionalChain([this, 'access', _114 => _114.scene, 'optionalAccess', _115 => _115.markDirty, 'call', _116 => _116()]);
       }
     });
   }
@@ -1455,23 +1486,23 @@ var SVGEntity = (_class4 = class extends Entity {
    * rasterized. Set to `'transparent'` to opt out and keep the box empty.
    * Default `'rgba(248,113,113,0.9)'`.
    */
-  __init50() {this.fallbackStroke = "rgba(248,113,113,0.9)"}
+  __init51() {this.fallbackStroke = "rgba(248,113,113,0.9)"}
   /** Fill behind the fallback marker. Default `'rgba(248,113,113,0.12)'`. */
-  __init51() {this.fallbackFill = "rgba(248,113,113,0.12)"}
-  __init52() {this.svgSource = ""}
-  __init53() {this.imageBitmap = null}
-  __init54() {this.imageElement = null}
-  __init55() {this.blobURL = null}
-  __init56() {this.currentImg = null}
-  __init57() {this.lodTimeout = null}
-  __init58() {this.rasterFailed = false}
-  __init59() {this.cachedDoc = null}
-  __init60() {this.baseWidth = 100}
-  __init61() {this.baseHeight = 100}
-  __init62() {this.lastRasterizedScale = 1}
-  __init63() {this.targetScale = 1}
+  __init52() {this.fallbackFill = "rgba(248,113,113,0.12)"}
+  __init53() {this.svgSource = ""}
+  __init54() {this.imageBitmap = null}
+  __init55() {this.imageElement = null}
+  __init56() {this.blobURL = null}
+  __init57() {this.currentImg = null}
+  __init58() {this.lodTimeout = null}
+  __init59() {this.rasterFailed = false}
+  __init60() {this.cachedDoc = null}
+  __init61() {this.baseWidth = 100}
+  __init62() {this.baseHeight = 100}
+  __init63() {this.lastRasterizedScale = 1}
+  __init64() {this.targetScale = 1}
   constructor(svgSource, id) {
-    super(id);_class4.prototype.__init50.call(this);_class4.prototype.__init51.call(this);_class4.prototype.__init52.call(this);_class4.prototype.__init53.call(this);_class4.prototype.__init54.call(this);_class4.prototype.__init55.call(this);_class4.prototype.__init56.call(this);_class4.prototype.__init57.call(this);_class4.prototype.__init58.call(this);_class4.prototype.__init59.call(this);_class4.prototype.__init60.call(this);_class4.prototype.__init61.call(this);_class4.prototype.__init62.call(this);_class4.prototype.__init63.call(this);;
+    super(id);_class4.prototype.__init51.call(this);_class4.prototype.__init52.call(this);_class4.prototype.__init53.call(this);_class4.prototype.__init54.call(this);_class4.prototype.__init55.call(this);_class4.prototype.__init56.call(this);_class4.prototype.__init57.call(this);_class4.prototype.__init58.call(this);_class4.prototype.__init59.call(this);_class4.prototype.__init60.call(this);_class4.prototype.__init61.call(this);_class4.prototype.__init62.call(this);_class4.prototype.__init63.call(this);_class4.prototype.__init64.call(this);;
     this.setSVGSource(svgSource);
   }
   setSVGSource(svgSource) {

package/dist/{chunk-RWN3ITBD.mjs → chunk-VFQMETOR.mjs}

@@ -71,6 +71,10 @@ var VectoJSEvent = class {
   get deltaY() {
     return this.nativeEvent?.deltaY;
   }
+  /** Native wheel delta mode (0=pixels, 1=lines, 2=pages), if this wraps a `WheelEvent`. */
+  get deltaMode() {
+    return this.nativeEvent?.deltaMode;
+  }
   /** Native pointer X, if this wraps a pointer/mouse event. */
   get clientX() {
     return this.nativeEvent?.clientX;
@@ -316,6 +320,33 @@ var Entity = class {
    * fixed viewport. Off by default (children render unclipped). Canvas2D only.
    */
   clipChildren = false;
+  /**
+   * Group this subtree's projected text into its own accessibility **region**,
+   * without clipping anything.
+   *
+   * The projection sorts every mirror into visual reading order, and it bands
+   * them into rows per region so that side-by-side columns stay contiguous runs
+   * in the DOM. That matters beyond reading order: a native `Selection` covers
+   * everything between its anchor and focus in DOM order, so two columns banded
+   * together let a vertical drag through one of them swallow the other.
+   *
+   * {@link clipChildren} also establishes a region, because a clipper is
+   * usually the column boundary you want. Reach for this flag when the two
+   * needs come apart — a sidebar, a card deck or any column that must not be
+   * absorbed by its neighbour's drag, but that draws nothing and has no reason
+   * to clip. Measured in a real app before this existed: a table-of-contents
+   * sidebar had to switch `clipChildren` on purely to escape the body column's
+   * bands, buying a per-frame `save`/`clip`/`restore` for an entity that paints
+   * nothing.
+   *
+   * Unlike `clipChildren`, this is honoured regardless of the node's box. The
+   * zero-area exemption on the clipping path exists because a zero-area clipper
+   * clips nothing; grouping is a declaration of intent that never consults
+   * geometry, and a pure grouping container often leaves `width`/`height` at 0.
+   *
+   * Off by default. Regions nest: the nearest enclosing region wins.
+   */
+  a11yRegion = false;
   // Lazily allocated (see _drivers above). Most entities never register a
   // listener or an imperative animate() tween.
   listeners = null;

package/dist/components/SplineEntity.d.ts

@@ -87,8 +87,8 @@ export declare function polySegmentToBezier(seg: SplineSegment): BezierControlPo
  * scene.add(new SplineEntity(doc).setPosition(100, 100));
  */
 export declare class SplineEntity extends Entity {
-    doc: SplineDocument;
-    lineWidth: number;
+    private _doc;
+    private _lineWidth;
     defaultColor: string;
     hitTolerance: number;
     private cache;
@@ -99,10 +99,26 @@ export declare class SplineEntity extends Entity {
     /** Logical (CSS-pixel) size of the baked bitmap — the blit destination size. */
     private bakedWidth;
     private bakedHeight;
-    /** Gradient strokes can't be baked to a solid-color bitmap; they render per-frame. */
-    private readonly containsGradient;
+    /**
+     * 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
+     * document has to recompute it (see the `doc` setter).
+     */
+    private containsGradient;
     /** Lazily-flattened polylines (one Float32Array of [x,y,...] per segment) for hit-testing. */
     private polylines;
+    /**
+     * The spline document to render. Assigning a new document invalidates all
+     * caches (baked canvas, flattened polylines, bounds).
+     */
+    get doc(): SplineDocument;
+    set doc(value: SplineDocument);
+    /**
+     * Stroke width in local units. Assigning a new value invalidates the baked
+     * canvas and hit-test polylines so visual and hit geometry stay consistent.
+     */
+    get lineWidth(): number;
+    set lineWidth(value: number);
     /**
      * When `true`, the renderer draws a rounded-rect outline of the entity's
      * local bounds after painting the curves. Useful for drag feedback and
@@ -110,6 +126,14 @@ export declare class SplineEntity extends Entity {
      */
     showBounds: boolean;
     constructor(doc: SplineDocument, opts?: SplineOptions);
+    /**
+     * Whether any stroke in the current document is a gradient. Shared by the
+     * constructor and the `doc` setter so both stay in agreement — the flag picks
+     * the render path, so a stale value renders a gradient as a flat color.
+     */
+    private computeContainsGradient;
+    /** Clear cached baked canvas and hit-test polylines. */
+    private invalidateCache;
     private computeBounds;
     /** @inheritdoc */
     getBounds(): Bounds;