@vectojs/core 1.38.1 → 1.39.0

package/dist/{chunk-QVTCKWDO.mjs → chunk-7PYD5UDX.mjs}

@@ -398,6 +398,18 @@ var Entity = class {
   }
   /** Attach a single child (the O(1) common path). See {@link add}. */
   _addOne(child) {
+    if (child === this) {
+      throw new Error(`Entity.add(): cannot add entity "${child.id}" under itself.`);
+    }
+    let ancestor = this.parent;
+    while (ancestor) {
+      if (ancestor === child) {
+        throw new Error(
+          `Entity.add(): cannot add entity "${child.id}" under "${this.id}" \u2014 an entity cannot be added under its own descendant.`
+        );
+      }
+      ancestor = ancestor.parent;
+    }
     if (child.parent) child.parent.remove(child);
     child.parent = this;
     this.children.push(child);
@@ -485,6 +497,19 @@ var Entity = class {
    * @example entity.animate({ x: 400, opacity: 0 }, 500);
    */
   animate(targetProps, durationMs) {
+    if (!Number.isFinite(durationMs) || durationMs <= 0) {
+      for (const key in targetProps) {
+        const end = targetProps[key];
+        if (typeof end !== "number") continue;
+        if (ANIMATABLE_PROPS.has(key)) {
+          this._applyAnimated(key, end);
+        } else {
+          this[key] = end;
+        }
+      }
+      this.scene?.markDirty({ entity: this.id, reason: "animation-start" });
+      return this;
+    }
     (this.animations ??= []).push({
       target: targetProps,
       duration: durationMs,
@@ -566,6 +591,11 @@ var Entity = class {
     const from = this._currentOf(prop);
     const driver = isTweenConfig(cfg) ? new TweenDriver(from, to, cfg) : new SpringDriver(from, to, cfg === "spring" ? {} : cfg);
     (this._drivers ??= /* @__PURE__ */ new Map()).set(prop, driver);
+    const s = this.scene;
+    if (s && this._driversTickedFrame === s.currentFrame && s._updateWalkDt !== null) {
+      driver.tick(s._updateWalkDt);
+      this._applyDriverTick(prop, driver);
+    }
     this.scene?.markDirty({ entity: this.id, reason: "driver-added" });
     this.scene?._registerActiveDriverEntity(this);
   }
@@ -652,10 +682,6 @@ var Entity = class {
       this._applyAnimated(prop, driver.value);
     }
   }
-  /** Internal: true if this entity currently has any active property driver. */
-  _hasActiveDrivers() {
-    return !!this._drivers && this._drivers.size > 0;
-  }
   /**
    * Advance the entity's internal state for one frame.
    *
@@ -1024,6 +1050,14 @@ var Entity = class {
    * Accumulated world rotation: this entity's own `rotation` plus
    * that of every ancestor.
    *
+   * Valid only under positive scales: the sum models the composed matrix
+   * `T*S*R` correctly while every ancestor's `scaleX`/`scaleY` is positive,
+   * but a mirrored (negative-scale) ancestor flips handedness, which an
+   * additive sum cannot represent — the result is then off by the mirror.
+   * For mirror-safe rotation, derive the angle from
+   * {@link getWorldTransform}'s matrix (e.g. `atan2(b, a)`), as SVGEntity's
+   * signed-scale handling already does.
+   *
    * @returns The accumulated world rotation in radians.
    */
   getWorldRotation() {
@@ -1242,7 +1276,6 @@ var MSDFTextEntity = class extends Entity {
   // long-lived shared atlas image would retain the whole entity.
   atlasDecodeTarget = null;
   atlasDecodeHandler = null;
-  rgbColorCache = /* @__PURE__ */ new Map();
   fontStringCache = [];
   layoutResult = null;
   /**
@@ -1429,7 +1462,12 @@ var MSDFTextEntity = class extends Entity {
       shaped.push(String.fromCodePoint(res.codePoints[i]));
     }
     const sourceWithoutNewlines = this.text.replace(/\n/g, "");
-    if (this.textAlign !== "left" || shaped.join("") !== sourceWithoutNewlines || res.yCoords.length !== res.codePoints.length) {
+    if (this.textAlign !== "left" || // The layout worker breaks lines on \n only, so a \r survives as a real
+    // glyph — a phantom ~1em advance at every CRLF line end — yet would
+    // still compare equal below after \n is stripped from both sides. The
+    // contract promises the coarse branch whenever the reply cannot
+    // reproduce the source exactly, and that includes any \r (#692).
+    this.text.includes("\r") || shaped.join("") !== sourceWithoutNewlines || res.yCoords.length !== res.codePoints.length) {
       this.projectionLines = [];
       return;
     }
@@ -1438,9 +1476,19 @@ var MSDFTextEntity = class extends Entity {
     const desc = metrics?.descender ?? -0.2;
     const actualLineHeight = this.lineHeight ?? this.fontSize * (asc - desc);
     const baseline = asc * this.fontSize;
-    const srcIdx = [];
-    for (let i = 0; i < this.text.length; i++) {
-      if (this.text[i] !== "\n") srcIdx.push(i);
+    const srcStart = [];
+    const srcEnd = [];
+    {
+      let cursor = 0;
+      while (cursor < this.text.length) {
+        const code = this.text.codePointAt(cursor);
+        const width = code > 65535 ? 2 : 1;
+        if (code !== 10) {
+          srcStart.push(cursor);
+          srcEnd.push(cursor + width);
+        }
+        cursor += width;
+      }
     }
     const glyphsByLine = /* @__PURE__ */ new Map();
     let maxIdx = -1;
@@ -1456,8 +1504,8 @@ var MSDFTextEntity = class extends Entity {
     let previousEnd = 0;
     for (let i = 0; i <= maxIdx; i++) {
       const glyphs = glyphsByLine.get(i) ?? [];
-      const start = glyphs.length > 0 ? srcIdx[glyphs[0]] : previousEnd;
-      const end = glyphs.length > 0 ? srcIdx[glyphs[glyphs.length - 1]] + 1 : start;
+      const start = glyphs.length > 0 ? srcStart[glyphs[0]] : previousEnd;
+      const end = glyphs.length > 0 ? srcEnd[glyphs[glyphs.length - 1]] : start;
       starts.push(start);
       ends.push(end);
       previousEnd = Math.max(previousEnd, end);
@@ -1510,7 +1558,6 @@ var MSDFTextEntity = class extends Entity {
         const code = this.layoutResult.codePoints[i];
         const nodeX = this.layoutResult.xCoords[i];
         const nodeY = this.layoutResult.yCoords[i];
-        const packedStyle = this.layoutResult.packedStyles[i];
         const def = this.font.getGlyph(code);
         if (!def || !def.atlasBounds || !def.planeBounds) continue;
         const { atlasBounds: ab, planeBounds: pb } = def;
@@ -1524,15 +1571,6 @@ var MSDFTextEntity = class extends Entity {
         const glyphH = (pb.top - pb.bottom) * this.fontSize * worldScaleY;
         const v0 = this.font.data.atlas.yOrigin === "bottom" ? 1 - ab.top / ah : ab.top / ah;
         const v1 = this.font.data.atlas.yOrigin === "bottom" ? 1 - ab.bottom / ah : ab.bottom / ah;
-        const colorVal = packedStyle >>> 8;
-        let runColor = this.rgbColorCache.get(colorVal);
-        if (!runColor) {
-          const r = colorVal >> 16 & 255;
-          const g = colorVal >> 8 & 255;
-          const b = colorVal & 255;
-          runColor = `rgb(${r},${g},${b})`;
-          this.rgbColorCache.set(colorVal, runColor);
-        }
         scene.pointRenderer.addGlyph(
           glyphX,
           glyphY,
@@ -1542,7 +1580,7 @@ var MSDFTextEntity = class extends Entity {
           v0,
           ab.right / aw,
           v1,
-          runColor,
+          this.color,
           worldOpacity,
           worldRot
         );
@@ -1562,16 +1600,7 @@ var MSDFTextEntity = class extends Entity {
       const nodeY = this.layoutResult.yCoords[i];
       const packedStyle = this.layoutResult.packedStyles[i];
       const fontString = this.fontStringCache[packedStyle & 3];
-      const colorVal = packedStyle >>> 8;
-      let runColor = this.rgbColorCache.get(colorVal);
-      if (!runColor) {
-        const r = colorVal >> 16 & 255;
-        const g = colorVal >> 8 & 255;
-        const b = colorVal & 255;
-        runColor = `rgb(${r},${g},${b})`;
-        this.rgbColorCache.set(colorVal, runColor);
-      }
-      renderer.fillText(String.fromCodePoint(code), nodeX, nodeY, fontString, runColor);
+      renderer.fillText(String.fromCodePoint(code), nodeX, nodeY, fontString, this.color);
     }
   }
   destroy() {
@@ -1586,11 +1615,32 @@ var SVG_NAMESPACE = "http://www.w3.org/2000/svg";
 function isSvgWhitespace(ch) {
   return ch === " " || ch === "	" || ch === "\n" || ch === "\r";
 }
+function findSvgTagEnd(source, from) {
+  let quote = null;
+  for (let i = from; i < source.length; i++) {
+    const ch = source[i];
+    if (quote !== null) {
+      if (ch === quote) quote = null;
+    } else if (ch === '"' || ch === "'") {
+      quote = ch;
+    } else if (ch === ">") {
+      return i;
+    }
+  }
+  return -1;
+}
+function isPercentDimension(value) {
+  return value.trim().endsWith("%");
+}
+function viewBoxDimensions(value) {
+  const parts = value.split(/[\s,]+/).map(parseFloat);
+  return parts.length === 4 && parts.every(Number.isFinite) ? { width: parts[2], height: parts[3] } : null;
+}
 function readSvgAttribute(source, name) {
   const lowerSource = source.toLowerCase();
   const svgStart = lowerSource.indexOf("<svg");
   if (svgStart < 0) return null;
-  const tagEnd = source.indexOf(">", svgStart + 4);
+  const tagEnd = findSvgTagEnd(source, svgStart + 4);
   if (tagEnd < 0) return null;
   const tag = source.slice(svgStart + 4, tagEnd);
   const lowerTag = tag.toLowerCase();
@@ -1662,14 +1712,14 @@ var SVGEntity = class extends Entity {
           const wAttr = svgEl.getAttribute("width");
           const hAttr = svgEl.getAttribute("height");
           const vbAttr = svgEl.getAttribute("viewBox");
-          if (wAttr && hAttr) {
+          if (wAttr && hAttr && !isPercentDimension(wAttr) && !isPercentDimension(hAttr)) {
             width = parseFloat(wAttr) || 100;
             height = parseFloat(hAttr) || 100;
           } else if (vbAttr) {
-            const parts = vbAttr.split(/[\s,]+/).map(parseFloat);
-            if (parts.length === 4) {
-              width = parts[2];
-              height = parts[3];
+            const dims = viewBoxDimensions(vbAttr);
+            if (dims) {
+              width = dims.width;
+              height = dims.height;
             }
           }
         }
@@ -1681,14 +1731,14 @@ var SVGEntity = class extends Entity {
       const wAttr = readSvgAttribute(this.svgSource, "width");
       const hAttr = readSvgAttribute(this.svgSource, "height");
       const vbAttr = readSvgAttribute(this.svgSource, "viewBox");
-      if (wAttr && hAttr) {
+      if (wAttr && hAttr && !isPercentDimension(wAttr) && !isPercentDimension(hAttr)) {
         width = parseFloat(wAttr) || 100;
         height = parseFloat(hAttr) || 100;
       } else if (vbAttr) {
-        const parts = vbAttr.split(/[\s,]+/).map(parseFloat);
-        if (parts.length === 4) {
-          width = parts[2];
-          height = parts[3];
+        const dims = viewBoxDimensions(vbAttr);
+        if (dims) {
+          width = dims.width;
+          height = dims.height;
         }
       }
     }