@vectojs/core 0.2.8 → 1.0.0

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

@@ -701,6 +701,7 @@ var SVGRenderer = (_class2 = class {
 }, _class2);
 
 // src/renderer/colorParse.ts
+var CACHE_MAX = 1e3;
 var cache = /* @__PURE__ */ new Map();
 var fallbackCtx;
 function fromHex(hex) {
@@ -744,10 +745,17 @@ function fromCanvas(css) {
 }
 function parseColorToRGBA(css) {
   const hit = cache.get(css);
-  if (hit) return hit;
+  if (hit) {
+    cache.delete(css);
+    cache.set(css, hit);
+    return hit;
+  }
   const trimmed = css.trim();
   const rgba = _nullishCoalesce(_nullishCoalesce(_nullishCoalesce((trimmed[0] === "#" ? fromHex(trimmed) : null), () => ( fromRgbFunc(trimmed))), () => ( fromCanvas(trimmed))), () => ( [0, 0, 0, 1]));
   cache.set(css, rgba);
+  if (cache.size > CACHE_MAX) {
+    cache.delete(cache.keys().next().value);
+  }
   return rgba;
 }
 

package/dist/{chunk-G6GQO7W2.mjs → chunk-PY4KGL5Y.mjs}

@@ -360,10 +360,21 @@ var Entity = class {
   /**
    * 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.
    */
   add(child) {
+    if (child.parent) child.parent.remove(child);
     child.parent = this;
     this.children.push(child);
     const s = this.scene;
@@ -716,9 +727,9 @@ var Entity = class {
    * Return the exact accumulated Canvas `T * S * R` transform for this entity.
    */
   getWorldTransform() {
-    const path = this.id === "root" ? [] : [this];
+    const path = [this];
     let ancestor = this.parent;
-    while (ancestor && ancestor.id !== "root") {
+    while (ancestor) {
       path.push(ancestor);
       ancestor = ancestor.parent;
     }
@@ -802,8 +813,8 @@ var Entity = class {
   }
   /**
    * 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 }`.
    */
@@ -811,7 +822,7 @@ var Entity = class {
     let sx = this.scaleX;
     let sy = this.scaleY;
     let curr = this.parent;
-    while (curr && curr.id !== "root") {
+    while (curr) {
       sx *= curr.scaleX;
       sy *= curr.scaleY;
       curr = curr.parent;
@@ -820,14 +831,14 @@ var Entity = class {
   }
   /**
    * 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.
    */
   getWorldRotation() {
     let rot = this.rotation;
     let curr = this.parent;
-    while (curr && curr.id !== "root") {
+    while (curr) {
       rot += curr.rotation;
       curr = curr.parent;
     }

package/dist/{chunk-XRWZS2DM.js → chunk-U4UYRERW.js}

@@ -360,10 +360,21 @@ var Entity = (_class4 = class {
   /**
    * 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.
    */
   add(child) {
+    if (child.parent) child.parent.remove(child);
     child.parent = this;
     this.children.push(child);
     const s = this.scene;
@@ -716,9 +727,9 @@ var Entity = (_class4 = class {
    * Return the exact accumulated Canvas `T * S * R` transform for this entity.
    */
   getWorldTransform() {
-    const path = this.id === "root" ? [] : [this];
+    const path = [this];
     let ancestor = this.parent;
-    while (ancestor && ancestor.id !== "root") {
+    while (ancestor) {
       path.push(ancestor);
       ancestor = ancestor.parent;
     }
@@ -802,8 +813,8 @@ var Entity = (_class4 = class {
   }
   /**
    * 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 }`.
    */
@@ -811,7 +822,7 @@ var Entity = (_class4 = class {
     let sx = this.scaleX;
     let sy = this.scaleY;
     let curr = this.parent;
-    while (curr && curr.id !== "root") {
+    while (curr) {
       sx *= curr.scaleX;
       sy *= curr.scaleY;
       curr = curr.parent;
@@ -820,14 +831,14 @@ var Entity = (_class4 = class {
   }
   /**
    * 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.
    */
   getWorldRotation() {
     let rot = this.rotation;
     let curr = this.parent;
-    while (curr && curr.id !== "root") {
+    while (curr) {
       rot += curr.rotation;
       curr = curr.parent;
     }

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

@@ -701,6 +701,7 @@ var SVGRenderer = class {
 };
 
 // src/renderer/colorParse.ts
+var CACHE_MAX = 1e3;
 var cache = /* @__PURE__ */ new Map();
 var fallbackCtx;
 function fromHex(hex) {
@@ -744,10 +745,17 @@ function fromCanvas(css) {
 }
 function parseColorToRGBA(css) {
   const hit = cache.get(css);
-  if (hit) return hit;
+  if (hit) {
+    cache.delete(css);
+    cache.set(css, hit);
+    return hit;
+  }
   const trimmed = css.trim();
   const rgba = (trimmed[0] === "#" ? fromHex(trimmed) : null) ?? fromRgbFunc(trimmed) ?? fromCanvas(trimmed) ?? [0, 0, 0, 1];
   cache.set(css, rgba);
+  if (cache.size > CACHE_MAX) {
+    cache.delete(cache.keys().next().value);
+  }
   return rgba;
 }
 

package/dist/index.js

@@ -12,7 +12,7 @@ var _chunkXLZDOFSBjs = require('./chunk-XLZDOFSB.js');
 
 
 
-var _chunkXB3ZY5MFjs = require('./chunk-XB3ZY5MF.js');
+var _chunkBPMNCGU7js = require('./chunk-BPMNCGU7.js');
 
 
 
@@ -24,7 +24,7 @@ var _chunkXB3ZY5MFjs = require('./chunk-XB3ZY5MF.js');
 
 
 
-var _chunkXRWZS2DMjs = require('./chunk-XRWZS2DM.js');
+var _chunkU4UYRERWjs = require('./chunk-U4UYRERW.js');
 
 
 
@@ -41,7 +41,7 @@ var PARTICLE_OFFSET_ORIGIN_X = 4;
 var PARTICLE_OFFSET_ORIGIN_Y = 5;
 var PARTICLE_OFFSET_SIZE = 6;
 var PARTICLE_OFFSET_LIFE = 7;
-var ComputeParticleEntity = (_class = class extends _chunkXRWZS2DMjs.Entity {
+var ComputeParticleEntity = (_class = class extends _chunkU4UYRERWjs.Entity {
   
   
   
@@ -428,7 +428,7 @@ var Scene = (_class2 = class _Scene {
     this.a11ySyncInterval = _nullishCoalesce(options.a11ySyncInterval, () => ( 0));
     this.contentProjectionEnabled = _nullishCoalesce(options.contentProjection, () => ( true));
     this.reducedMotionQuery = typeof window !== "undefined" && typeof window.matchMedia === "function" ? window.matchMedia("(prefers-reduced-motion: reduce)") : null;
-    this.root = new class RootEntity extends _chunkXRWZS2DMjs.Entity {
+    this.root = new class RootEntity extends _chunkU4UYRERWjs.Entity {
       isPointInside() {
         return false;
       }
@@ -437,7 +437,7 @@ var Scene = (_class2 = class _Scene {
       }
     }("root");
     this.root._scene = this;
-    this.overlayRoot = new class OverlayRoot extends _chunkXRWZS2DMjs.Entity {
+    this.overlayRoot = new class OverlayRoot extends _chunkU4UYRERWjs.Entity {
       isPointInside() {
         return false;
       }
@@ -448,7 +448,7 @@ var Scene = (_class2 = class _Scene {
     if (options.renderer) {
       this.renderer = options.renderer;
     } else {
-      this.renderer = new (0, _chunkXB3ZY5MFjs.CanvasRenderer)(
+      this.renderer = new (0, _chunkBPMNCGU7js.CanvasRenderer)(
         canvas,
         this.disableWindowResize ? { width: this.width, height: this.height } : void 0
       );
@@ -790,42 +790,42 @@ var Scene = (_class2 = class _Scene {
           el.style.background = "transparent";
         }
         el.addEventListener("click", (e) => {
-          node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("click", node, e));
+          node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("click", node, e));
         });
         el.addEventListener("mouseenter", (e) => {
           if (this.debugA11y) el.style.backgroundColor = "rgba(56, 189, 248, 0.2)";
-          node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("hover", node, e, false));
+          node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("hover", node, e, false));
         });
         el.addEventListener("mouseleave", (e) => {
           if (this.debugA11y) el.style.backgroundColor = "rgba(56, 189, 248, 0.05)";
-          node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("pointerleave", node, e, false));
+          node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("pointerleave", node, e, false));
         });
         const capEl = el;
         el.addEventListener("pointerdown", (e) => {
           if (typeof capEl.setPointerCapture === "function") capEl.setPointerCapture(e.pointerId);
-          node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("pointerdown", node, e));
+          node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("pointerdown", node, e));
         });
         el.addEventListener("pointerup", (e) => {
           if (typeof capEl.releasePointerCapture === "function")
             capEl.releasePointerCapture(e.pointerId);
-          node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("pointerup", node, e));
+          node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("pointerup", node, e));
         });
         el.addEventListener(
           "pointermove",
-          (e) => node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("pointermove", node, e))
+          (e) => node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("pointermove", node, e))
         );
         el.addEventListener(
           "wheel",
           (e) => {
-            node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("wheel", node, e));
+            node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("wheel", node, e));
           },
           { passive: false }
         );
         el.addEventListener("keydown", (e) => {
-          node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("keydown", node, e));
+          node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("keydown", node, e));
         });
         el.addEventListener("keyup", (e) => {
-          node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("keyup", node, e));
+          node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("keyup", node, e));
         });
         if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
           const input = el;
@@ -898,7 +898,7 @@ var Scene = (_class2 = class _Scene {
           el.addEventListener("keydown", (e) => {
             if (e.key === "Enter" || e.key === " ") {
               e.preventDefault();
-              node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("click", node, e));
+              node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("click", node, e));
             }
           });
         }
@@ -923,7 +923,7 @@ var Scene = (_class2 = class _Scene {
         if (el.placeholder !== attrs.placeholder) el.placeholder = attrs.placeholder;
       }
       if (attrs.href !== void 0 && el instanceof HTMLAnchorElement) {
-        const safeHref = _chunkXB3ZY5MFjs.sanitizeUrl.call(void 0, attrs.href);
+        const safeHref = _chunkBPMNCGU7js.sanitizeUrl.call(void 0, attrs.href);
         if (el.getAttribute("href") !== safeHref) el.setAttribute("href", safeHref);
       }
       if (el instanceof HTMLImageElement) {
@@ -1032,7 +1032,7 @@ var Scene = (_class2 = class _Scene {
       el.addEventListener(
         "wheel",
         (e2) => {
-          node.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)("wheel", node, e2));
+          node.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)("wheel", node, e2));
         },
         { passive: false }
       );
@@ -1595,7 +1595,7 @@ var Scene = (_class2 = class _Scene {
    * Export the current scene state to a lightweight, flat SVG XML string.
    */
   toSVG() {
-    const renderer = new (0, _chunkXB3ZY5MFjs.SVGRenderer)(this.width, this.height);
+    const renderer = new (0, _chunkBPMNCGU7js.SVGRenderer)(this.width, this.height);
     this.render(renderer, 0, 0);
     return renderer.toXMLString();
   }
@@ -1792,7 +1792,7 @@ function defaultMeasurer() {
   if (sharedMeasurer === void 0) sharedMeasurer = _chunkXLZDOFSBjs.createCanvasMeasurer.call(void 0, "sans-serif");
   return sharedMeasurer;
 }
-var TextEntity = (_class3 = class extends _chunkXRWZS2DMjs.Entity {
+var TextEntity = (_class3 = class extends _chunkU4UYRERWjs.Entity {
   
   
   
@@ -1918,7 +1918,7 @@ var TextEntity = (_class3 = class extends _chunkXRWZS2DMjs.Entity {
 }, _class3);
 
 // src/components/GridTextEntity.ts
-var GridTextEntity = (_class4 = class extends _chunkXRWZS2DMjs.Entity {
+var GridTextEntity = (_class4 = class extends _chunkU4UYRERWjs.Entity {
   
   __init59() {this.fillStyle = "#ffffff"}
   __init60() {this.grid = []}
@@ -2012,7 +2012,7 @@ function distSqToSegment(px, py, x1, y1, x2, y2) {
   const ey = py - cy;
   return ex * ex + ey * ey;
 }
-var SplineEntity = (_class5 = class extends _chunkXRWZS2DMjs.Entity {
+var SplineEntity = (_class5 = class extends _chunkU4UYRERWjs.Entity {
   
   
   
@@ -2381,7 +2381,7 @@ var SpatialHashGrid = (_class6 = class {
 }, _class6);
 
 // src/tree/DOMPortalEntity.ts
-var DOMPortalEntity = (_class7 = class extends _chunkXRWZS2DMjs.Entity {
+var DOMPortalEntity = (_class7 = class extends _chunkU4UYRERWjs.Entity {
   
   __init71() {this.isDOMPortal = true}
   __init72() {this.domListeners = []}
@@ -2416,7 +2416,7 @@ var DOMPortalEntity = (_class7 = class extends _chunkXRWZS2DMjs.Entity {
       const events = ["click", "pointerdown", "pointerup", "pointermove", "wheel"];
       for (const type of events) {
         const handler = (e) => {
-          this.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)(type, this, e));
+          this.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)(type, this, e));
         };
         this.domElement.addEventListener(type, handler);
         this.domListeners.push({ type, handler, capture: false });
@@ -2427,7 +2427,7 @@ var DOMPortalEntity = (_class7 = class extends _chunkXRWZS2DMjs.Entity {
       ];
       for (const { native, vecto } of hoverEvents) {
         const handler = (e) => {
-          this.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)(vecto, this, e, false));
+          this.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)(vecto, this, e, false));
         };
         this.domElement.addEventListener(native, handler);
         this.domListeners.push({ type: native, handler, capture: false });
@@ -2435,7 +2435,7 @@ var DOMPortalEntity = (_class7 = class extends _chunkXRWZS2DMjs.Entity {
       const focusEvents = ["focus", "blur"];
       for (const type of focusEvents) {
         const handler = (e) => {
-          this.dispatchEvent(new (0, _chunkXRWZS2DMjs.VectoJSEvent)(type, this, e, true));
+          this.dispatchEvent(new (0, _chunkU4UYRERWjs.VectoJSEvent)(type, this, e, true));
         };
         this.domElement.addEventListener(type, handler, true);
         this.domListeners.push({ type, handler, capture: true });
@@ -2474,8 +2474,8 @@ var DOMPortalEntity = (_class7 = class extends _chunkXRWZS2DMjs.Entity {
 }, _class7);
 
 // src/index.ts
-Scene.registerWebGLPointRendererCreator(_chunkXB3ZY5MFjs.createWebGLPointRenderer);
-Scene.registerWebGPUParticleSystemManager(_chunkXB3ZY5MFjs.WebGPUParticleSystemManager);
+Scene.registerWebGLPointRendererCreator(_chunkBPMNCGU7js.createWebGLPointRenderer);
+Scene.registerWebGPUParticleSystemManager(_chunkBPMNCGU7js.WebGPUParticleSystemManager);
 
 
 
@@ -2520,4 +2520,4 @@ Scene.registerWebGPUParticleSystemManager(_chunkXB3ZY5MFjs.WebGPUParticleSystemM
 
 
 
-exports.ArabicShaper = _chunkCTZQOM5Zjs.ArabicShaper; exports.BidiResolver = _chunkCTZQOM5Zjs.BidiResolver; exports.CanvasRenderer = _chunkXB3ZY5MFjs.CanvasRenderer; exports.ComputeParticleEntity = ComputeParticleEntity; exports.DOMPortalEntity = DOMPortalEntity; exports.Easing = _chunkXRWZS2DMjs.Easing; exports.Entity = _chunkXRWZS2DMjs.Entity; exports.GridTextEntity = GridTextEntity; exports.LayoutEngine = _chunkXLZDOFSBjs.LayoutEngine; exports.LayoutResultBuffer = _chunkXLZDOFSBjs.LayoutResultBuffer; exports.LayoutWorkerManager = _chunkCTZQOM5Zjs.LayoutWorkerManager; exports.MSDFFont = _chunkXRWZS2DMjs.MSDFFont; exports.MSDFTextEntity = _chunkXRWZS2DMjs.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.SVGEntity = _chunkXRWZS2DMjs.SVGEntity; exports.SVGRenderer = _chunkXB3ZY5MFjs.SVGRenderer; exports.Scene = Scene; exports.SpatialHashGrid = SpatialHashGrid; exports.SplineEntity = SplineEntity; exports.SpringDriver = _chunkXRWZS2DMjs.SpringDriver; exports.SpringPhysics = _chunkXRWZS2DMjs.SpringPhysics; exports.TextEntity = TextEntity; exports.TweenDriver = _chunkXRWZS2DMjs.TweenDriver; exports.VectoJSEvent = _chunkXRWZS2DMjs.VectoJSEvent; exports.WebGPUParticleSystemManager = _chunkXB3ZY5MFjs.WebGPUParticleSystemManager; exports.computeLineSegments = _chunkXLZDOFSBjs.computeLineSegments; exports.createCanvasMeasurer = _chunkXLZDOFSBjs.createCanvasMeasurer; exports.createWebGLPointRenderer = _chunkXB3ZY5MFjs.createWebGLPointRenderer; exports.isSafeUrl = _chunkXB3ZY5MFjs.isSafeUrl; exports.isTweenConfig = _chunkXRWZS2DMjs.isTweenConfig; exports.loadSpline = loadSpline; exports.parseColorToRGBA = _chunkXB3ZY5MFjs.parseColorToRGBA; exports.polySegmentToBezier = polySegmentToBezier; exports.sanitizeUrl = _chunkXB3ZY5MFjs.sanitizeUrl;
+exports.ArabicShaper = _chunkCTZQOM5Zjs.ArabicShaper; exports.BidiResolver = _chunkCTZQOM5Zjs.BidiResolver; exports.CanvasRenderer = _chunkBPMNCGU7js.CanvasRenderer; exports.ComputeParticleEntity = ComputeParticleEntity; exports.DOMPortalEntity = DOMPortalEntity; exports.Easing = _chunkU4UYRERWjs.Easing; exports.Entity = _chunkU4UYRERWjs.Entity; exports.GridTextEntity = GridTextEntity; exports.LayoutEngine = _chunkXLZDOFSBjs.LayoutEngine; exports.LayoutResultBuffer = _chunkXLZDOFSBjs.LayoutResultBuffer; exports.LayoutWorkerManager = _chunkCTZQOM5Zjs.LayoutWorkerManager; exports.MSDFFont = _chunkU4UYRERWjs.MSDFFont; exports.MSDFTextEntity = _chunkU4UYRERWjs.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.SVGEntity = _chunkU4UYRERWjs.SVGEntity; exports.SVGRenderer = _chunkBPMNCGU7js.SVGRenderer; exports.Scene = Scene; exports.SpatialHashGrid = SpatialHashGrid; exports.SplineEntity = SplineEntity; exports.SpringDriver = _chunkU4UYRERWjs.SpringDriver; exports.SpringPhysics = _chunkU4UYRERWjs.SpringPhysics; exports.TextEntity = TextEntity; exports.TweenDriver = _chunkU4UYRERWjs.TweenDriver; exports.VectoJSEvent = _chunkU4UYRERWjs.VectoJSEvent; exports.WebGPUParticleSystemManager = _chunkBPMNCGU7js.WebGPUParticleSystemManager; exports.computeLineSegments = _chunkXLZDOFSBjs.computeLineSegments; exports.createCanvasMeasurer = _chunkXLZDOFSBjs.createCanvasMeasurer; exports.createWebGLPointRenderer = _chunkBPMNCGU7js.createWebGLPointRenderer; exports.isSafeUrl = _chunkBPMNCGU7js.isSafeUrl; exports.isTweenConfig = _chunkU4UYRERWjs.isTweenConfig; exports.loadSpline = loadSpline; exports.parseColorToRGBA = _chunkBPMNCGU7js.parseColorToRGBA; exports.polySegmentToBezier = polySegmentToBezier; exports.sanitizeUrl = _chunkBPMNCGU7js.sanitizeUrl;

package/dist/index.mjs

@@ -12,7 +12,7 @@ import {
   isSafeUrl,
   parseColorToRGBA,
   sanitizeUrl
-} from "./chunk-YBW7ECZP.mjs";
+} from "./chunk-WT2XZHJQ.mjs";
 import {
   Easing,
   Entity,
@@ -24,7 +24,7 @@ import {
   TweenDriver,
   VectoJSEvent,
   isTweenConfig
-} from "./chunk-G6GQO7W2.mjs";
+} from "./chunk-PY4KGL5Y.mjs";
 import {
   ArabicShaper,
   BidiResolver,

package/dist/renderer.js

@@ -4,11 +4,11 @@
 
 
 
-var _chunkXB3ZY5MFjs = require('./chunk-XB3ZY5MF.js');
+var _chunkBPMNCGU7js = require('./chunk-BPMNCGU7.js');
 
 
 
 
 
 
-exports.CanvasRenderer = _chunkXB3ZY5MFjs.CanvasRenderer; exports.SVGRenderer = _chunkXB3ZY5MFjs.SVGRenderer; exports.WebGPUParticleSystemManager = _chunkXB3ZY5MFjs.WebGPUParticleSystemManager; exports.createWebGLPointRenderer = _chunkXB3ZY5MFjs.createWebGLPointRenderer; exports.parseColorToRGBA = _chunkXB3ZY5MFjs.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-YBW7ECZP.mjs";
+} from "./chunk-WT2XZHJQ.mjs";
 export {
   CanvasRenderer,
   SVGRenderer,

package/dist/text.js

@@ -2,7 +2,7 @@
 
 
 
-var _chunkXRWZS2DMjs = require('./chunk-XRWZS2DM.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 = _chunkXRWZS2DMjs.MSDFFont; exports.MSDFTextEntity = _chunkXRWZS2DMjs.MSDFTextEntity; exports.SVGEntity = _chunkXRWZS2DMjs.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-G6GQO7W2.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/package.json

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