rendx-engine 0.3.0 → 0.4.1

package/dist/main.cjs

@@ -477,7 +477,7 @@ getEmitter_fn = function() {
 };
 
 // src/core/graphics.ts
-var _nameMap, _classlist, _Graphics_instances, removeFromNameMap_fn, updateMat2d_fn, updateWorldMatrix_fn, updateEZ_fn;
+var _nameMap, _classlist, _Graphics_instances, removeFromNameMap_fn, inheritState_fn, updateMat2d_fn, updateWorldMatrix_fn, updateEZ_fn;
 var Graphics = class extends EventTarget {
   constructor() {
     super(...arguments);
@@ -593,6 +593,7 @@ var Graphics = class extends EventTarget {
     this.children.push(child);
     if (__privateGet(this, _nameMap).has(child.name)) throw new Error(`The name "${child.name}" is already used.`);
     if (child.name) __privateGet(this, _nameMap).set(child.name, child);
+    __privateMethod(this, _Graphics_instances, inheritState_fn).call(this, child);
     this.setDirty(true);
     return this;
   }
@@ -601,6 +602,7 @@ var Graphics = class extends EventTarget {
     child.parent = this;
     this.children.unshift(child);
     __privateMethod(this, _Graphics_instances, removeFromNameMap_fn).call(this, child);
+    __privateMethod(this, _Graphics_instances, inheritState_fn).call(this, child);
     this.setDirty(true);
     return this;
   }
@@ -610,6 +612,7 @@ var Graphics = class extends EventTarget {
       const node = this.children[index];
       this.children.splice(index, 1);
       __privateMethod(this, _Graphics_instances, removeFromNameMap_fn).call(this, node);
+      node.parent = null;
       this.setDirty(true);
     }
     return this;
@@ -796,8 +799,9 @@ var Graphics = class extends EventTarget {
   }
   /** 检查是否需要重绘（自身或子树有脏标记/更新标记） */
   sign() {
+    if (this.dirty) return true;
     if (!this.display) return false;
-    if (this.dirty || this.needUpdate || this.worldMatrixNeedUpdate) return true;
+    if (this.needUpdate || this.worldMatrixNeedUpdate) return true;
     for (let i = 0; i < this.children.length; i++) if (this.children[i].sign()) return true;
     return false;
   }
@@ -843,6 +847,22 @@ _Graphics_instances = new WeakSet();
 removeFromNameMap_fn = function(g) {
   if (__privateGet(this, _nameMap).has(g.name)) __privateGet(this, _nameMap).delete(g.name);
 };
+/**
+ * 将父节点的可继承状态（visible / display / pointerEvents）传播给新增子节点。
+ * 模拟 DOM 中 CSS 继承属性的行为：
+ * - 父级 pointer-events: none → 子级默认继承 none，除非子级显式覆盖
+ * - 父级 visibility: hidden → 同上
+ * - 父级 display: none → 整棵子树不渲染
+ *
+ * 使用 bySelf=false 调用，尊重子节点的 autoX 标记：
+ * - autoX=true（默认）→ 接受父级值
+ * - autoX=false（子节点显式设置过）→ 保持自身值不变
+ */
+inheritState_fn = function(child) {
+  if (!this.visible) child.setVisible(false, false);
+  if (!this.display) child.setDisplay(false, false);
+  if (!this.pointerEvents) child.setPointerEvents(false, false);
+};
 updateMat2d_fn = function() {
   if (!this.needUpdate) return;
   import_gl_matrix.mat2d.identity(this.matrix);
@@ -1200,7 +1220,7 @@ var Scene = class extends Graphics {
         });
       }
       queue.sort((a, b) => a.ez - b.ez);
-      this.setDirty(false);
+      this.dirty = false;
       __privateSet(this, _queue, queue);
     }
     return __privateGet(this, _queue);
@@ -1252,7 +1272,7 @@ var Group = class extends Graphics {
 
 // src/scene/node.ts
 var import_gl_matrix3 = require("gl-matrix");
-var import_rendx_bounding15 = require("rendx-bounding");
+var import_rendx_bounding16 = require("rendx-bounding");
 
 // src/shapes/symbol.ts
 var import_rendx_bounding2 = require("rendx-bounding");
@@ -1649,6 +1669,8 @@ var ArcShape = class extends Shape {
 };
 
 // src/shapes/path.ts
+var import_rendx_bounding9 = require("rendx-bounding");
+var import_rendx_path9 = require("rendx-path");
 var PathShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1657,11 +1679,19 @@ var PathShape = class extends Shape {
   from(d) {
     this.d = d;
     this.p = null;
+    if (this.autoNeedUpdate) this.needUpdate = true;
+  }
+  box() {
+    const result = (0, import_rendx_path9.pathBBox)(this.d);
+    if (result) {
+      this.boundingBox = import_rendx_bounding9.BoundingBox.fromPoints(result[0], result[1], result[2], result[3]);
+    }
+    return this.boundingBox;
   }
 };
 
 // src/shapes/text.ts
-var import_rendx_bounding9 = require("rendx-bounding");
+var import_rendx_bounding10 = require("rendx-bounding");
 var _attrs;
 var _TextShape = class _TextShape extends Shape {
   constructor() {
@@ -1694,7 +1724,7 @@ var _TextShape = class _TextShape extends Shape {
     if (measureFn && this.text) {
       const bb = measureFn(this.text, __privateGet(this, _attrs));
       if (bb) {
-        this.boundingBox = import_rendx_bounding9.BoundingBox.fromRect(this.x, this.y - bb.height, bb.width, bb.height);
+        this.boundingBox = import_rendx_bounding10.BoundingBox.fromRect(this.x, this.y - bb.height, bb.width, bb.height);
         return this.boundingBox;
       }
     }
@@ -1725,7 +1755,7 @@ _TextShape.defaultMeasure = null;
 var TextShape = _TextShape;
 
 // src/shapes/line.ts
-var import_rendx_bounding10 = require("rendx-bounding");
+var import_rendx_bounding11 = require("rendx-bounding");
 var LineShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1757,13 +1787,13 @@ var LineShape = class extends Shape {
   }
   box() {
     const { x1, y1, x2, y2 } = this;
-    this.boundingBox = import_rendx_bounding10.BoundingBox.fromPoints(x1, y1, x2, y2);
+    this.boundingBox = import_rendx_bounding11.BoundingBox.fromPoints(x1, y1, x2, y2);
     return this.boundingBox;
   }
 };
 
 // src/shapes/rect.ts
-var import_rendx_bounding11 = require("rendx-bounding");
+var import_rendx_bounding12 = require("rendx-bounding");
 var RectShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1793,13 +1823,13 @@ var RectShape = class extends Shape {
   }
   box() {
     const { x, y, width, height } = this;
-    this.boundingBox = import_rendx_bounding11.BoundingBox.fromRect(x, y, width, height);
+    this.boundingBox = import_rendx_bounding12.BoundingBox.fromRect(x, y, width, height);
     return this.boundingBox;
   }
 };
 
 // src/shapes/circle.ts
-var import_rendx_bounding12 = require("rendx-bounding");
+var import_rendx_bounding13 = require("rendx-bounding");
 var CircleShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1826,13 +1856,13 @@ var CircleShape = class extends Shape {
   }
   box() {
     const { cx, cy, r } = this;
-    this.boundingBox = import_rendx_bounding12.BoundingBox.fromPoints(cx - r, cy - r, cx + r, cy + r);
+    this.boundingBox = import_rendx_bounding13.BoundingBox.fromPoints(cx - r, cy - r, cx + r, cy + r);
     return this.boundingBox;
   }
 };
 
 // src/shapes/image.ts
-var import_rendx_bounding13 = require("rendx-bounding");
+var import_rendx_bounding14 = require("rendx-bounding");
 var ImageShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1876,15 +1906,15 @@ var ImageShape = class extends Shape {
   }
   box() {
     const { x, y, width, height } = this;
-    this.boundingBox = import_rendx_bounding13.BoundingBox.fromRect(x, y, width, height);
+    this.boundingBox = import_rendx_bounding14.BoundingBox.fromRect(x, y, width, height);
     return this.boundingBox;
   }
 };
 
 // src/shapes/rect-buffer.ts
-var import_rendx_bounding14 = require("rendx-bounding");
+var import_rendx_bounding15 = require("rendx-bounding");
 var import_rendx_shape8 = require("rendx-shape");
-var import_rendx_path9 = require("rendx-path");
+var import_rendx_path10 = require("rendx-path");
 var RectBufferShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1901,7 +1931,7 @@ var RectBufferShape = class extends Shape {
   build() {
     if (!this.needUpdate) return;
     if (this.mode === "render") {
-      if (!this.creator) this.creator = new import_rendx_path9.Path();
+      if (!this.creator) this.creator = new import_rendx_path10.Path();
       else this.creator.clear();
       const { buffer } = this;
       for (let i = 0; i < buffer.length; i += 4) {
@@ -1948,7 +1978,7 @@ var RectBufferShape = class extends Shape {
       x1 = Math.max(x1, x + width);
       y1 = Math.max(y1, y + height);
     }
-    this.boundingBox = import_rendx_bounding14.BoundingBox.fromPoints(x0, y0, x1, y1);
+    this.boundingBox = import_rendx_bounding15.BoundingBox.fromPoints(x0, y0, x1, y1);
     return this.boundingBox;
   }
 };
@@ -2051,7 +2081,7 @@ var _Node = class _Node extends Graphics {
     if (wx > maxX) maxX = wx;
     if (wy < minY) minY = wy;
     if (wy > maxY) maxY = wy;
-    return import_rendx_bounding15.BoundingBox.fromPoints(minX, minY, maxX, maxY);
+    return import_rendx_bounding16.BoundingBox.fromPoints(minX, minY, maxX, maxY);
   }
   /**
    * 命中检测：将屏幕坐标通过逆世界矩阵变换为本地坐标，然后检测是否命中
@@ -2213,7 +2243,7 @@ var Layer = class extends Group {
         if (node.type === 3) queue.push(node);
       });
       queue.sort((a, b) => a.ez - b.ez);
-      this.setDirty(false);
+      this.dirty = false;
       __privateSet(this, _queue2, queue);
     }
     return __privateGet(this, _queue2);
@@ -2228,6 +2258,7 @@ var Layer = class extends Group {
     if (this.isEventLayer) return;
     this.update();
     const queue = this.getQueue();
+    this.setDirty(false);
     this.renderer.draw(this.culling ? __privateMethod(this, _Layer_instances, cullViewport_fn).call(this, queue) : queue);
   }
   resize(size) {
@@ -2997,6 +3028,26 @@ var _App = class _App {
       plugin.resize?.(width, height);
     }
   }
+  // ========================
+  // Cursor
+  // ========================
+  /**
+   * 设置容器的鼠标光标样式。
+   * @param cursor - CSS cursor 值（如 'pointer'、'crosshair'、'grab'）
+   */
+  setCursor(cursor) {
+    if (__privateGet(this, _container)) {
+      __privateGet(this, _container).style.cursor = cursor;
+    }
+  }
+  /**
+   * 重置鼠标光标为默认值。
+   */
+  resetCursor() {
+    if (__privateGet(this, _container)) {
+      __privateGet(this, _container).style.cursor = "";
+    }
+  }
   clear() {
     if (__privateGet(this, _rafId) !== null) {
       cancelAnimationFrame(__privateGet(this, _rafId));

package/dist/main.d.cts

@@ -618,6 +618,7 @@ declare class ArcShape extends Shape {
 declare class PathShape extends Shape {
     command: "path";
     from(d: string): void;
+    box(): BoundingBox;
 }
 
 /**
@@ -946,6 +947,15 @@ declare class App {
      * @param height - 新高度（像素）
      */
     resize(width: number, height: number): void;
+    /**
+     * 设置容器的鼠标光标样式。
+     * @param cursor - CSS cursor 值（如 'pointer'、'crosshair'、'grab'）
+     */
+    setCursor(cursor: string): void;
+    /**
+     * 重置鼠标光标为默认值。
+     */
+    resetCursor(): void;
     clear(): void;
     dispose(): void;
     /** 将所有渲染层合成到一个 Canvas 上并返回 */

package/dist/main.d.ts

@@ -618,6 +618,7 @@ declare class ArcShape extends Shape {
 declare class PathShape extends Shape {
     command: "path";
     from(d: string): void;
+    box(): BoundingBox;
 }
 
 /**
@@ -946,6 +947,15 @@ declare class App {
      * @param height - 新高度（像素）
      */
     resize(width: number, height: number): void;
+    /**
+     * 设置容器的鼠标光标样式。
+     * @param cursor - CSS cursor 值（如 'pointer'、'crosshair'、'grab'）
+     */
+    setCursor(cursor: string): void;
+    /**
+     * 重置鼠标光标为默认值。
+     */
+    resetCursor(): void;
     clear(): void;
     dispose(): void;
     /** 将所有渲染层合成到一个 Canvas 上并返回 */

package/dist/main.js

@@ -403,7 +403,7 @@ getEmitter_fn = function() {
 };
 
 // src/core/graphics.ts
-var _nameMap, _classlist, _Graphics_instances, removeFromNameMap_fn, updateMat2d_fn, updateWorldMatrix_fn, updateEZ_fn;
+var _nameMap, _classlist, _Graphics_instances, removeFromNameMap_fn, inheritState_fn, updateMat2d_fn, updateWorldMatrix_fn, updateEZ_fn;
 var Graphics = class extends EventTarget {
   constructor() {
     super(...arguments);
@@ -519,6 +519,7 @@ var Graphics = class extends EventTarget {
     this.children.push(child);
     if (__privateGet(this, _nameMap).has(child.name)) throw new Error(`The name "${child.name}" is already used.`);
     if (child.name) __privateGet(this, _nameMap).set(child.name, child);
+    __privateMethod(this, _Graphics_instances, inheritState_fn).call(this, child);
     this.setDirty(true);
     return this;
   }
@@ -527,6 +528,7 @@ var Graphics = class extends EventTarget {
     child.parent = this;
     this.children.unshift(child);
     __privateMethod(this, _Graphics_instances, removeFromNameMap_fn).call(this, child);
+    __privateMethod(this, _Graphics_instances, inheritState_fn).call(this, child);
     this.setDirty(true);
     return this;
   }
@@ -536,6 +538,7 @@ var Graphics = class extends EventTarget {
       const node = this.children[index];
       this.children.splice(index, 1);
       __privateMethod(this, _Graphics_instances, removeFromNameMap_fn).call(this, node);
+      node.parent = null;
       this.setDirty(true);
     }
     return this;
@@ -722,8 +725,9 @@ var Graphics = class extends EventTarget {
   }
   /** 检查是否需要重绘（自身或子树有脏标记/更新标记） */
   sign() {
+    if (this.dirty) return true;
     if (!this.display) return false;
-    if (this.dirty || this.needUpdate || this.worldMatrixNeedUpdate) return true;
+    if (this.needUpdate || this.worldMatrixNeedUpdate) return true;
     for (let i = 0; i < this.children.length; i++) if (this.children[i].sign()) return true;
     return false;
   }
@@ -769,6 +773,22 @@ _Graphics_instances = new WeakSet();
 removeFromNameMap_fn = function(g) {
   if (__privateGet(this, _nameMap).has(g.name)) __privateGet(this, _nameMap).delete(g.name);
 };
+/**
+ * 将父节点的可继承状态（visible / display / pointerEvents）传播给新增子节点。
+ * 模拟 DOM 中 CSS 继承属性的行为：
+ * - 父级 pointer-events: none → 子级默认继承 none，除非子级显式覆盖
+ * - 父级 visibility: hidden → 同上
+ * - 父级 display: none → 整棵子树不渲染
+ *
+ * 使用 bySelf=false 调用，尊重子节点的 autoX 标记：
+ * - autoX=true（默认）→ 接受父级值
+ * - autoX=false（子节点显式设置过）→ 保持自身值不变
+ */
+inheritState_fn = function(child) {
+  if (!this.visible) child.setVisible(false, false);
+  if (!this.display) child.setDisplay(false, false);
+  if (!this.pointerEvents) child.setPointerEvents(false, false);
+};
 updateMat2d_fn = function() {
   if (!this.needUpdate) return;
   mat2d.identity(this.matrix);
@@ -1126,7 +1146,7 @@ var Scene = class extends Graphics {
         });
       }
       queue.sort((a, b) => a.ez - b.ez);
-      this.setDirty(false);
+      this.dirty = false;
       __privateSet(this, _queue, queue);
     }
     return __privateGet(this, _queue);
@@ -1178,7 +1198,7 @@ var Group = class extends Graphics {
 
 // src/scene/node.ts
 import { mat2d as mat2d3, vec2 as vec23 } from "gl-matrix";
-import { BoundingBox as BoundingBox15 } from "rendx-bounding";
+import { BoundingBox as BoundingBox16 } from "rendx-bounding";
 
 // src/shapes/symbol.ts
 import { BoundingBox as BoundingBox2 } from "rendx-bounding";
@@ -1575,6 +1595,8 @@ var ArcShape = class extends Shape {
 };
 
 // src/shapes/path.ts
+import { BoundingBox as BoundingBox9 } from "rendx-bounding";
+import { pathBBox } from "rendx-path";
 var PathShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1583,11 +1605,19 @@ var PathShape = class extends Shape {
   from(d) {
     this.d = d;
     this.p = null;
+    if (this.autoNeedUpdate) this.needUpdate = true;
+  }
+  box() {
+    const result = pathBBox(this.d);
+    if (result) {
+      this.boundingBox = BoundingBox9.fromPoints(result[0], result[1], result[2], result[3]);
+    }
+    return this.boundingBox;
   }
 };
 
 // src/shapes/text.ts
-import { BoundingBox as BoundingBox9 } from "rendx-bounding";
+import { BoundingBox as BoundingBox10 } from "rendx-bounding";
 var _attrs;
 var _TextShape = class _TextShape extends Shape {
   constructor() {
@@ -1620,7 +1650,7 @@ var _TextShape = class _TextShape extends Shape {
     if (measureFn && this.text) {
       const bb = measureFn(this.text, __privateGet(this, _attrs));
       if (bb) {
-        this.boundingBox = BoundingBox9.fromRect(this.x, this.y - bb.height, bb.width, bb.height);
+        this.boundingBox = BoundingBox10.fromRect(this.x, this.y - bb.height, bb.width, bb.height);
         return this.boundingBox;
       }
     }
@@ -1651,7 +1681,7 @@ _TextShape.defaultMeasure = null;
 var TextShape = _TextShape;
 
 // src/shapes/line.ts
-import { BoundingBox as BoundingBox10 } from "rendx-bounding";
+import { BoundingBox as BoundingBox11 } from "rendx-bounding";
 var LineShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1683,13 +1713,13 @@ var LineShape = class extends Shape {
   }
   box() {
     const { x1, y1, x2, y2 } = this;
-    this.boundingBox = BoundingBox10.fromPoints(x1, y1, x2, y2);
+    this.boundingBox = BoundingBox11.fromPoints(x1, y1, x2, y2);
     return this.boundingBox;
   }
 };
 
 // src/shapes/rect.ts
-import { BoundingBox as BoundingBox11 } from "rendx-bounding";
+import { BoundingBox as BoundingBox12 } from "rendx-bounding";
 var RectShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1719,13 +1749,13 @@ var RectShape = class extends Shape {
   }
   box() {
     const { x, y, width, height } = this;
-    this.boundingBox = BoundingBox11.fromRect(x, y, width, height);
+    this.boundingBox = BoundingBox12.fromRect(x, y, width, height);
     return this.boundingBox;
   }
 };
 
 // src/shapes/circle.ts
-import { BoundingBox as BoundingBox12 } from "rendx-bounding";
+import { BoundingBox as BoundingBox13 } from "rendx-bounding";
 var CircleShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1752,13 +1782,13 @@ var CircleShape = class extends Shape {
   }
   box() {
     const { cx, cy, r } = this;
-    this.boundingBox = BoundingBox12.fromPoints(cx - r, cy - r, cx + r, cy + r);
+    this.boundingBox = BoundingBox13.fromPoints(cx - r, cy - r, cx + r, cy + r);
     return this.boundingBox;
   }
 };
 
 // src/shapes/image.ts
-import { BoundingBox as BoundingBox13 } from "rendx-bounding";
+import { BoundingBox as BoundingBox14 } from "rendx-bounding";
 var ImageShape = class extends Shape {
   constructor() {
     super(...arguments);
@@ -1802,13 +1832,13 @@ var ImageShape = class extends Shape {
   }
   box() {
     const { x, y, width, height } = this;
-    this.boundingBox = BoundingBox13.fromRect(x, y, width, height);
+    this.boundingBox = BoundingBox14.fromRect(x, y, width, height);
     return this.boundingBox;
   }
 };
 
 // src/shapes/rect-buffer.ts
-import { BoundingBox as BoundingBox14 } from "rendx-bounding";
+import { BoundingBox as BoundingBox15 } from "rendx-bounding";
 import { createShape as createShape7 } from "rendx-shape";
 import { Path as Path9 } from "rendx-path";
 var RectBufferShape = class extends Shape {
@@ -1874,7 +1904,7 @@ var RectBufferShape = class extends Shape {
       x1 = Math.max(x1, x + width);
       y1 = Math.max(y1, y + height);
     }
-    this.boundingBox = BoundingBox14.fromPoints(x0, y0, x1, y1);
+    this.boundingBox = BoundingBox15.fromPoints(x0, y0, x1, y1);
     return this.boundingBox;
   }
 };
@@ -1977,7 +2007,7 @@ var _Node = class _Node extends Graphics {
     if (wx > maxX) maxX = wx;
     if (wy < minY) minY = wy;
     if (wy > maxY) maxY = wy;
-    return BoundingBox15.fromPoints(minX, minY, maxX, maxY);
+    return BoundingBox16.fromPoints(minX, minY, maxX, maxY);
   }
   /**
    * 命中检测：将屏幕坐标通过逆世界矩阵变换为本地坐标，然后检测是否命中
@@ -2139,7 +2169,7 @@ var Layer = class extends Group {
         if (node.type === 3) queue.push(node);
       });
       queue.sort((a, b) => a.ez - b.ez);
-      this.setDirty(false);
+      this.dirty = false;
       __privateSet(this, _queue2, queue);
     }
     return __privateGet(this, _queue2);
@@ -2154,6 +2184,7 @@ var Layer = class extends Group {
     if (this.isEventLayer) return;
     this.update();
     const queue = this.getQueue();
+    this.setDirty(false);
     this.renderer.draw(this.culling ? __privateMethod(this, _Layer_instances, cullViewport_fn).call(this, queue) : queue);
   }
   resize(size) {
@@ -2923,6 +2954,26 @@ var _App = class _App {
       plugin.resize?.(width, height);
     }
   }
+  // ========================
+  // Cursor
+  // ========================
+  /**
+   * 设置容器的鼠标光标样式。
+   * @param cursor - CSS cursor 值（如 'pointer'、'crosshair'、'grab'）
+   */
+  setCursor(cursor) {
+    if (__privateGet(this, _container)) {
+      __privateGet(this, _container).style.cursor = cursor;
+    }
+  }
+  /**
+   * 重置鼠标光标为默认值。
+   */
+  resetCursor() {
+    if (__privateGet(this, _container)) {
+      __privateGet(this, _container).style.cursor = "";
+    }
+  }
   clear() {
     if (__privateGet(this, _rafId) !== null) {
       cancelAnimationFrame(__privateGet(this, _rafId));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rendx-engine",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "2D scene graph engine with animation, events, and plugin system",
   "license": "MIT",
   "author": "wei.liang (https://github.com/weiliang0121)",
@@ -36,8 +36,8 @@
     "rendx-canvas": "^0.1.1",
     "rendx-ease": "^0.1.1",
     "rendx-interpolate": "^0.1.1",
-    "rendx-path": "^0.1.1",
-    "rendx-shape": "^0.1.1",
+    "rendx-path": "^0.2.0",
+    "rendx-shape": "^0.1.2",
     "rendx-svg": "^0.1.1",
     "rendx-core": "^0.1.1"
   },