@vectojs/core 1.32.7 → 1.33.0

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

@@ -322,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)}`;
   }
   /**
@@ -1168,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"));
@@ -1459,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-YTGGL4I4.mjs → chunk-VFQMETOR.mjs}

@@ -320,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;