ice-render 1.2.0 → 1.3.0

package/dist/types/graphic/ICEComponent.d.mts

@@ -42,6 +42,8 @@ declare abstract class ICEComponent extends ICEEventTarget {
     /** 可见性缓存（代际号 + 值）：见 `isEffectivelyVisible` 的说明。 */
     private __visEpoch;
     private __visValue;
+    /** 本帧是否因为子树不透明度过 ctx.globalAlpha（见 __renderCore / __resetLeakyCtxState）。 */
+    private __opacityApplied;
     /** 声明式渐变缓存：按描述对象引用判定，`refreshParams()` 里失效（setState 必然触发它）。 */
     private __gradCache;
     /**
@@ -299,6 +301,12 @@ declare abstract class ICEComponent extends ICEEventTarget {
      * 顶层组件直接 O(1) 返回。
      */
     hasClippingAncestor(): boolean;
+    /**
+     * 有效不透明度 = 自身 `state.opacity` × 所有祖先的 `state.opacity`（默认 1）。
+     *
+     * 顶层组件直接返回（绝大多数组件没有祖先，热路径上不做遍历）；非法值按 1 处理。
+     */
+    private __effectiveOpacity;
     /**
      * 世界坐标点是否落在某个「裁剪祖先」的盒子之外。
      *

package/dist/types/graphic/ICEComponent.d.ts

@@ -42,6 +42,8 @@ declare abstract class ICEComponent extends ICEEventTarget {
     /** 可见性缓存（代际号 + 值）：见 `isEffectivelyVisible` 的说明。 */
     private __visEpoch;
     private __visValue;
+    /** 本帧是否因为子树不透明度过 ctx.globalAlpha（见 __renderCore / __resetLeakyCtxState）。 */
+    private __opacityApplied;
     /** 声明式渐变缓存：按描述对象引用判定，`refreshParams()` 里失效（setState 必然触发它）。 */
     private __gradCache;
     /**
@@ -299,6 +301,12 @@ declare abstract class ICEComponent extends ICEEventTarget {
      * 顶层组件直接 O(1) 返回。
      */
     hasClippingAncestor(): boolean;
+    /**
+     * 有效不透明度 = 自身 `state.opacity` × 所有祖先的 `state.opacity`（默认 1）。
+     *
+     * 顶层组件直接返回（绝大多数组件没有祖先，热路径上不做遍历）；非法值按 1 处理。
+     */
+    private __effectiveOpacity;
     /**
      * 世界坐标点是否落在某个「裁剪祖先」的盒子之外。
      *

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "ice-render",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A canvas engine for interactive graphics.",
   "repository": {
     "type": "git",