@vectojs/core 0.2.7 → 0.2.9

package/dist/index.mjs

@@ -3,7 +3,7 @@ import {
   LayoutResultBuffer,
   computeLineSegments,
   createCanvasMeasurer
-} from "./chunk-SSOP3F5F.mjs";
+} from "./chunk-FNXOS7IA.mjs";
 import {
   CanvasRenderer,
   SVGRenderer,
@@ -12,7 +12,7 @@ import {
   isSafeUrl,
   parseColorToRGBA,
   sanitizeUrl
-} from "./chunk-HVJHXIKW.mjs";
+} from "./chunk-WT2XZHJQ.mjs";
 import {
   Easing,
   Entity,
@@ -24,7 +24,7 @@ import {
   TweenDriver,
   VectoJSEvent,
   isTweenConfig
-} from "./chunk-YVN3PJRC.mjs";
+} from "./chunk-PY4KGL5Y.mjs";
 import {
   ArabicShaper,
   BidiResolver,
@@ -358,6 +358,11 @@ var Scene = class _Scene {
   /** DOM nodes mirroring static text content, keyed by entity id. */
   contentElements = /* @__PURE__ */ new Map();
   contentProjectionEnabled = true;
+  // Animation/interactive flags collected during the render walk (tree-walk
+  // fusion): the loop reads last frame's answers instead of re-walking the
+  // tree up to 4× per tick. Start true so the first tick stays conservative.
+  frameHadAnimation = true;
+  frameHadInteractive = true;
   resizeHandler;
   focusedA11yElement = null;
   caretBlinkTimer = null;
@@ -711,6 +716,18 @@ var Scene = class _Scene {
    * Essential for deterministic rendering (e.g. video export).
    * Note: You should call `scene.stop()` before using this to avoid conflict with the rAF loop.
    */
+  /**
+   * The scene-graph root entity. Exposed read-only for tooling — the devtools
+   * inspector walks it to build the Virtual Math Tree view. Mutate the graph
+   * through {@link add}/{@link remove}, not by editing this node directly.
+   */
+  get rootEntity() {
+    return this.root;
+  }
+  /** The overlay layer root (see {@link showOverlay}), read-only for tooling. */
+  get overlayRootEntity() {
+    return this.overlayRoot;
+  }
   step(dt) {
     const time = this.lastTime + dt;
     this.lastTime = time;
@@ -727,21 +744,7 @@ var Scene = class _Scene {
     this.dirty = true;
   }
   /** True when any node in the subtree has a pending animation. */
-  hasAnyPendingAnimation(node) {
-    if (node.hasPendingAnimations()) return true;
-    for (const child of node.children) {
-      if (this.hasAnyPendingAnimation(child)) return true;
-    }
-    return false;
-  }
   /** True when any node in the subtree is interactive (drives a11y sync). */
-  hasAnyInteractive(node) {
-    if (node.interactive) return true;
-    for (const child of node.children) {
-      if (this.hasAnyInteractive(child)) return true;
-    }
-    return false;
-  }
   syncA11y(node) {
     if (!this.a11yRoot) return;
     if (node.isDOMPortal) {
@@ -1276,7 +1279,7 @@ var Scene = class _Scene {
   loop(time) {
     if (!this.isRunning) return;
     let cap = this.effectiveMaxFPS();
-    const isIdle = !this.dirty && !this.hasAnyPendingAnimation(this.root) && !this.hasAnyPendingAnimation(this.overlayRoot);
+    const isIdle = !this.dirty && !this.frameHadAnimation;
     if (isIdle && this.autoThrottle && this.renderMode === "always" && this.maxFPS > 0) {
       cap = Math.min(cap, 2);
     }
@@ -1292,8 +1295,8 @@ var Scene = class _Scene {
     }
     this.dirty = false;
     this.render(this.renderer, dt, time);
-    const hasActiveAnimation = this.hasAnyPendingAnimation(this.root) || this.hasAnyPendingAnimation(this.overlayRoot);
-    const hasInteractive = this.hasAnyInteractive(this.root) || this.hasAnyInteractive(this.overlayRoot);
+    const hasActiveAnimation = this.frameHadAnimation;
+    const hasInteractive = this.frameHadInteractive;
     const wantsContentSync = this.contentProjectionEnabled;
     const shouldSyncInterval = this.a11ySyncInterval <= 0 || time - this.lastA11ySync >= this.a11ySyncInterval;
     if ((hasInteractive || this.a11yElements.size > 0 || wantsContentSync) && (shouldSyncInterval || this.a11yPendingSyncAfterAnimation)) {
@@ -1450,8 +1453,14 @@ var Scene = class _Scene {
     }
     const vw = this.width;
     const vh = this.height;
+    let walkHadAnimation = false;
+    let walkHadInteractive = false;
     const renderNode = (node, pa, pb, pc, pd, pe, pf, parentOpacity) => {
-      if (isMainRenderer) node.update(dt, time);
+      if (isMainRenderer) {
+        node.update(dt, time);
+        if (!walkHadAnimation && node.hasPendingAnimations()) walkHadAnimation = true;
+        if (!walkHadInteractive && node.interactive) walkHadInteractive = true;
+      }
       const cos = Math.cos(node.rotation);
       const sin = Math.sin(node.rotation);
       const te = pa * node.x + pc * node.y + pe;
@@ -1571,7 +1580,11 @@ var Scene = class _Scene {
     for (const overlay of this.overlayRoot.children) {
       renderNode(overlay, 1, 0, 0, 1, 0, 0, 1);
     }
-    if (isMainRenderer) this.reconcilePortals();
+    if (isMainRenderer) {
+      this.frameHadAnimation = walkHadAnimation;
+      this.frameHadInteractive = walkHadInteractive;
+      this.reconcilePortals();
+    }
     renderer.flush();
     if (isMainRenderer) {
       this.pointRenderer?.flush();
@@ -1835,6 +1848,26 @@ var TextEntity = class extends Entity {
     this.applyLayout();
     return this;
   }
+  /**
+   * Set horizontal alignment (`'justify'` stretches wrapped lines flush to
+   * the wrap width; the last line stays ragged) and reflow.
+   */
+  setTextAlign(align) {
+    this.layout.textAlign = align;
+    this.applyLayout();
+    return this;
+  }
+  /**
+   * Plug a hyphenator (word → parts). Break opportunities are baked in during
+   * the cold pass, so this re-prepares the current text. Soft hyphens
+   * (U+00AD) in the text work without one.
+   */
+  setHyphenator(fn) {
+    this.layout.hyphenate = fn;
+    this.prepared = this.layout.prepare(this.text, this.atlas, this.fontSize);
+    this.applyLayout();
+    return this;
+  }
   /** Hot pass: place the cached {@link PreparedText} and refresh the a11y box. */
   applyLayout() {
     const result = this.layout.layoutPrepared(this.prepared);

package/dist/layout/LayoutEngine.d.ts

@@ -88,6 +88,11 @@ export interface PreparedWord {
     isWordLike: boolean | undefined;
     /** Pre-computed `word.trim().length === 0`. */
     isWhitespace: boolean;
+    /**
+     * Glyph indices where the word may break with a visible hyphen — from
+     * soft hyphens (U+00AD) in the source or the engine's `hyphenate` hook.
+     */
+    breakPoints?: number[];
 }
 /** A measured paragraph; `isEmpty` marks a blank line (forced newline). */
 export interface PreparedParagraph {
@@ -107,6 +112,8 @@ export interface PreparedText {
     paragraphs: PreparedParagraph[];
     fontSize: number;
     fallbackToCanvas?: boolean;
+    /** Advance width of '-' at `fontSize`, for wrap-time hyphen insertion. */
+    hyphenWidth?: number;
 }
 /**
  * A rectangular region (in the text's local coordinate space) that text must
@@ -140,6 +147,13 @@ export declare function computeLineSegments(top: number, bottom: number, maxWidt
  */
 export declare class LayoutEngine {
     maxWidth: number;
+    /**
+     * Horizontal alignment. `'justify'` stretches inter-word spaces (or, for
+     * space-less CJK lines, inter-character gaps) so wrapped lines end flush at
+     * `maxWidth`; the last line of each paragraph stays ragged. Only applies to
+     * the object layout path without exclusion shapes.
+     */
+    textAlign: 'left' | 'justify';
     maxHeight: number;
     preserveLeadingSpaces: boolean;
     private wordSegmenter;
@@ -150,6 +164,16 @@ export declare class LayoutEngine {
     private richParagraphCache;
     private lastAtlas;
     private measurer;
+    private _hyphenate;
+    /**
+     * Optional hyphenator: given a word, return its break parts (e.g.
+     * `['hyphen', 'ation']`). Used at wrap time when a word doesn't fit; a
+     * visible '-' is drawn at the chosen break. Soft hyphens (U+00AD) in the
+     * source work without any hyphenator. Setting this clears the prepared
+     * caches (break opportunities are baked in during prepare()).
+     */
+    get hyphenate(): ((word: string) => string[]) | null;
+    set hyphenate(fn: ((word: string) => string[]) | null);
     constructor(maxWidth: number, maxHeight: number, measurer?: GlyphMeasurer | null);
     private getWordSegments;
     /**

package/dist/layout.js

@@ -3,7 +3,7 @@
 
 
 
-var _chunkBWLNEJJWjs = require('./chunk-BWLNEJJW.js');
+var _chunkXLZDOFSBjs = require('./chunk-XLZDOFSB.js');
 
 
 var _chunkCTZQOM5Zjs = require('./chunk-CTZQOM5Z.js');
@@ -13,4 +13,4 @@ var _chunkCTZQOM5Zjs = require('./chunk-CTZQOM5Z.js');
 
 
 
-exports.LayoutEngine = _chunkBWLNEJJWjs.LayoutEngine; exports.LayoutResultBuffer = _chunkBWLNEJJWjs.LayoutResultBuffer; exports.LayoutWorkerManager = _chunkCTZQOM5Zjs.LayoutWorkerManager; exports.computeLineSegments = _chunkBWLNEJJWjs.computeLineSegments; exports.createCanvasMeasurer = _chunkBWLNEJJWjs.createCanvasMeasurer;
+exports.LayoutEngine = _chunkXLZDOFSBjs.LayoutEngine; exports.LayoutResultBuffer = _chunkXLZDOFSBjs.LayoutResultBuffer; exports.LayoutWorkerManager = _chunkCTZQOM5Zjs.LayoutWorkerManager; exports.computeLineSegments = _chunkXLZDOFSBjs.computeLineSegments; exports.createCanvasMeasurer = _chunkXLZDOFSBjs.createCanvasMeasurer;

package/dist/layout.mjs

@@ -3,7 +3,7 @@ import {
   LayoutResultBuffer,
   computeLineSegments,
   createCanvasMeasurer
-} from "./chunk-SSOP3F5F.mjs";
+} from "./chunk-FNXOS7IA.mjs";
 import {
   LayoutWorkerManager
 } from "./chunk-STWPTWO4.mjs";

package/dist/renderer.js

@@ -4,11 +4,11 @@
 
 
 
-var _chunkGTQRCY6Wjs = require('./chunk-GTQRCY6W.js');
+var _chunkBPMNCGU7js = require('./chunk-BPMNCGU7.js');
 
 
 
 
 
 
-exports.CanvasRenderer = _chunkGTQRCY6Wjs.CanvasRenderer; exports.SVGRenderer = _chunkGTQRCY6Wjs.SVGRenderer; exports.WebGPUParticleSystemManager = _chunkGTQRCY6Wjs.WebGPUParticleSystemManager; exports.createWebGLPointRenderer = _chunkGTQRCY6Wjs.createWebGLPointRenderer; exports.parseColorToRGBA = _chunkGTQRCY6Wjs.parseColorToRGBA;
+exports.CanvasRenderer = _chunkBPMNCGU7js.CanvasRenderer; exports.SVGRenderer = _chunkBPMNCGU7js.SVGRenderer; exports.WebGPUParticleSystemManager = _chunkBPMNCGU7js.WebGPUParticleSystemManager; exports.createWebGLPointRenderer = _chunkBPMNCGU7js.createWebGLPointRenderer; exports.parseColorToRGBA = _chunkBPMNCGU7js.parseColorToRGBA;

package/dist/renderer.mjs

@@ -4,7 +4,7 @@ import {
   WebGPUParticleSystemManager,
   createWebGLPointRenderer,
   parseColorToRGBA
-} from "./chunk-HVJHXIKW.mjs";
+} from "./chunk-WT2XZHJQ.mjs";
 export {
   CanvasRenderer,
   SVGRenderer,

package/dist/text.js

@@ -2,7 +2,7 @@
 
 
 
-var _chunkDWMQYHNCjs = require('./chunk-DWMQYHNC.js');
+var _chunkU4UYRERWjs = require('./chunk-U4UYRERW.js');
 
 
 
@@ -13,4 +13,4 @@ var _chunkCTZQOM5Zjs = require('./chunk-CTZQOM5Z.js');
 
 
 
-exports.ArabicShaper = _chunkCTZQOM5Zjs.ArabicShaper; exports.BidiResolver = _chunkCTZQOM5Zjs.BidiResolver; exports.MSDFFont = _chunkDWMQYHNCjs.MSDFFont; exports.MSDFTextEntity = _chunkDWMQYHNCjs.MSDFTextEntity; exports.SVGEntity = _chunkDWMQYHNCjs.SVGEntity;
+exports.ArabicShaper = _chunkCTZQOM5Zjs.ArabicShaper; exports.BidiResolver = _chunkCTZQOM5Zjs.BidiResolver; exports.MSDFFont = _chunkU4UYRERWjs.MSDFFont; exports.MSDFTextEntity = _chunkU4UYRERWjs.MSDFTextEntity; exports.SVGEntity = _chunkU4UYRERWjs.SVGEntity;

package/dist/text.mjs

@@ -2,7 +2,7 @@ import {
   MSDFFont,
   MSDFTextEntity,
   SVGEntity
-} from "./chunk-YVN3PJRC.mjs";
+} from "./chunk-PY4KGL5Y.mjs";
 import {
   ArabicShaper,
   BidiResolver

package/dist/tree/Entity.d.ts

@@ -262,6 +262,16 @@ export declare abstract class Entity {
     /**
      * Append a child entity to this node's children array.
      *
+     * If `child` already has a parent (including `this`), it's detached from it
+     * first — otherwise re-adding an already-added child duplicates it in
+     * `children[]` (one `remove()` call only strips the first occurrence,
+     * leaving a stale entry that keeps rendering/updating despite
+     * `child.parent` reporting `null`), and re-parenting to a different entity
+     * without an explicit `remove()` first leaves the old parent holding a
+     * stale reference whose own `.parent` disagrees with where it now lives.
+     * `child.parent` is only ever `null` or `this`'s ultimate owner, so this
+     * check is O(1) for the overwhelming common case (a brand-new entity).
+     *
      * @param child - The entity to add as a child.
      * @returns `this` for method chaining.
      */
@@ -405,8 +415,8 @@ export declare abstract class Entity {
     getWorldBounds(): Bounds;
     /**
      * Accumulated world scale factors: this entity's own `scaleX`/`scaleY` times
-     * those of every ancestor (excluding the scene root). Useful for mapping a
-     * world-space point back into local space for hit-testing.
+     * those of every ancestor. Useful for mapping a world-space point back into
+     * local space for hit-testing.
      *
      * @returns The world scale `{ x, y }`.
      */
@@ -416,7 +426,7 @@ export declare abstract class Entity {
     };
     /**
      * Accumulated world rotation: this entity's own `rotation` plus
-     * that of every ancestor (excluding the scene root).
+     * that of every ancestor.
      *
      * @returns The accumulated world rotation in radians.
      */

package/dist/tree/Scene.d.ts

@@ -158,6 +158,8 @@ export declare class Scene {
     /** DOM nodes mirroring static text content, keyed by entity id. */
     private contentElements;
     private contentProjectionEnabled;
+    private frameHadAnimation;
+    private frameHadInteractive;
     private resizeHandler;
     private focusedA11yElement;
     private caretBlinkTimer;
@@ -267,6 +269,14 @@ export declare class Scene {
      * Essential for deterministic rendering (e.g. video export).
      * Note: You should call `scene.stop()` before using this to avoid conflict with the rAF loop.
      */
+    /**
+     * The scene-graph root entity. Exposed read-only for tooling — the devtools
+     * inspector walks it to build the Virtual Math Tree view. Mutate the graph
+     * through {@link add}/{@link remove}, not by editing this node directly.
+     */
+    get rootEntity(): Entity;
+    /** The overlay layer root (see {@link showOverlay}), read-only for tooling. */
+    get overlayRootEntity(): Entity;
     step(dt: number): void;
     /**
      * Mark the scene as needing a redraw on the next frame.
@@ -276,9 +286,7 @@ export declare class Scene {
      */
     markDirty(): void;
     /** True when any node in the subtree has a pending animation. */
-    private hasAnyPendingAnimation;
     /** True when any node in the subtree is interactive (drives a11y sync). */
-    private hasAnyInteractive;
     private syncA11y;
     /**
      * Mirror one entity's static text ({@link Entity.getContentProjection}) as a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectojs/core",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "publishConfig": {
     "access": "public"
   },