ice-render 1.0.4 → 1.0.5

package/dist/types/graphic/link/ICEVisioLink.d.mts

@@ -0,0 +1,163 @@
+import ICEPolyLine from './ICEPolyLine.mjs';
+/**
+ * ! FIXME: 删掉对 GeoPoint/GeoLine/GeoUtil 的依赖
+ * @class ICEVisioLink
+ *
+ * Visio 型的连接线
+ *
+ * 模拟 Microsoft Visio 中的折线算法，此实现从 diagramo 改进而来：http://diagramo.com/ 。
+ *
+ * 基本特性：
+ *
+ * - ICEVisioLink 只有 2 个端点，起点和终点。
+ * - 除起始点和终点坐标之外，其它点会自动插值计算。
+ * - ICEVisioLink 只能连接 2 个非线条类的组件。
+ * - 线条互相之间不能连接，在 ICE 引擎中，不能用线条连接线条。
+ * - 每一个可以被连接的组件上都有 4 个插槽（Slot），4 个插槽分布在组件最小边界盒子 4 条边的几何中点位置上。
+ * - ICEVisioLink 的端点在移动时会判断是否与某个插槽发生碰撞，如果与某个插槽发生碰撞， ICEVisioLink 会连接到插槽所在的组件上。
+ * - 同一个插槽（Slot）上可以连 N 根线，Slot 与 ICEVisioLink 之间的关系是 1->N 。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+export default class ICEVisioLink extends ICEPolyLine {
+    /**
+     * FIXME:补全 props 配置项的描述
+     */
+    constructor(props?: any);
+    protected static arrangeParam(props: any): any;
+    /**
+     * ICEVisioLink 有自己特殊的计算方式。
+     *
+     * @overwrite
+     * @returns
+     */
+    protected __calcDots(): any;
+    /**
+     * 贝塞尔形态：从两端点与插槽法线构造三次贝塞尔，等分采样后写回 points/dots。
+     *
+     * **为什么要把采样点写回 `state.points`**（而不是只算 dots）：`ICEPolyLine.isDotsOnSameLine()`
+     * 与 `getLabelPosition()` 都只读 `state.points`。若 points 只剩首尾两点会被判「共线」，
+     * 包围盒就会走 `splitEndpointsTo4Points()`、只按线宽沿弦外扩 → 曲线鼓出的部分落在盒外
+     * → dirty-rect 上屏快照盒偏小、局部重绘会把曲线裁掉。写回之后包围盒/标签/命中都自然正确。
+     *
+     * @returns
+     */
+    protected __calcBezierDots(): any;
+    /**
+     * 由两端点构造三次贝塞尔并等分采样（世界坐标）。
+     *
+     * 控制点：`C1 = start + dir(start 插槽) * offset`、`C2 = end + dir(end 插槽) * offset`，
+     * `offset = max(|end-start| * 0.45, 24)`，方向为插槽**外法线**（与正交布线的语义一致）。
+     */
+    protected buildBezierPoints(start: number[], end: number[]): number[][];
+    /**
+     * 某端插槽的外法线方向；C 槽 / 未连接 / 未知位置回落到弦方向。
+     *
+     * 注意 start 端用 `+chord`、end 端用 `-chord`（指向弦的内侧）：两端都取 `+chord` 的话，
+     * 控制点会落在两端点连线之外，曲线会先冲出去再拐回来（终点被越过）。
+     */
+    protected slotDirection(terminal: string, chord: number[]): number[];
+    /**
+     * @overwrite
+     * 贝塞尔形态不走正交路由。
+     *
+     * 应用层（如 ice-entity-designer 的 `routeRelations()`）会在布局后无条件把 `routeType` 设为
+     * `'orthogonal'`；不拦掉的话每次布局/移动都会用正交折线整体覆盖 `state.points`：
+     * 虽然下一帧 `__calcDots` 会把曲线重新采样回来，但语义错乱且白算一次。
+     */
+    protected recalculateRoute(): void;
+    /**
+     * 在起点和终点之间插值。
+     *
+     * @returns
+     */
+    protected interpolate(): any[];
+    /**
+     * Tests if a vector of points is an orthogonal path (moving in multiples of 90 degrees).
+     *
+     *
+     * 正交判定。Visio 连接线上的每一段要么平行于 X 轴，要么平行于 Y 轴。
+     * @param {Array} v - an {Array} of {Point}s
+     * @return {Boolean} - true if path is valid, false otherwise
+     */
+    private orthogonalPath;
+    /**
+     * FIXME: 用更好的数学方法进行计算。
+     * Test to see if 2 {Line}s intersects. They are considered finite segments
+     * and not the infinite lines from geometry
+     * @param {Line} l1 - fist line/segment
+     * @param {Line} l2 - last line/segment
+     * @return {Boolean} true - if the lines intersect or false if not
+     */
+    private lineIntersectsLine;
+    /**
+     * Tests if a a polyline defined by a set of points intersects a rectangle
+     * @param {Array} points - and {Array} of {Point}s
+     * @param {Array} boundingRect - the boundingRect
+     * @param {Boolean} closedPolyline - incase polyline is closed figure then true, else false
+     * @return true - if line intersects the rectangle, false - if not
+     */
+    private polylineIntersectsRectangle;
+    /**
+     * Score a ortogonal path made out of Points
+     * Iterates over a set of points (minimum 3)
+     * For each 3 points (i, i+1, i+2) :
+     *  - if the 3rd one is after the 2nd on the same line we add +1
+     *  - if the 3rd is up or down related to the 2nd we do not do anything +0
+     *  - if the 3rd goes back we imediatelly return -1
+     * @param {Array} v - an array of {Point}s
+     * @return {Number} - -1 if the path is wrong (goes back) or something >= 0 if is fine.The bigger the number the smooth the path is.
+     */
+    private scorePath;
+    /**
+     * Returns the sign of a number
+     * @param {Number} x - the number
+     * @returns {Number}
+     * @see <a href="http://en.wikipedia.org/wiki/Sign_function">http://en.wikipedia.org/wiki/Sign_function</a>
+     */
+    private signum;
+    /**
+     * Tests if a vector of points is a valid path (not going back)
+     * There are a few problems here. If you have p1, p2, p3 and p4 and p2 = p3 you need to ignore that
+     * @param {Array} v - an {Array} of {Point}s
+     * @return {Boolean} - true if path is valid, false otherwise
+     */
+    private forwardPath;
+    /**
+     * @method distance
+     * Calculate the distance between two points.
+     *
+     *
+     * 计算两点之间的距离。
+     * @param {Point} p1 - first {Point}
+     * @param {Point} p2 - second {Point}
+     * @return {Number} - the distance between those 2 points. It is always positive.
+     */
+    private distance;
+    /**
+     * Returns the max of a vector
+     * @param {Array} v - vector of {Number}s
+     * @return {Number} - the maximum number from the vector or NaN if vector is empty
+     */
+    private max;
+    /**
+     * Returns the min of a vector
+     * @param {Array} v - vector of {Number}s
+     * @return {Number} - the minimum number from the vector or NaN if vector is empty
+     * @author alex@scriptoid.com
+     */
+    private min;
+    /**
+     * ICEVisioLink 中的点都是自动计算出来的，手动添加点没有意义。
+     * @overwrite
+     * @param point
+     * @param index
+     */
+    addDot(point: [number, number], index: number): void;
+    /**
+     * ICEVisioLink 中的点都是自动计算出来的，手动删除点没有意义。
+     * @overwrite
+     * @param index
+     */
+    rmDot(index: number): boolean;
+}

package/dist/types/graphic/link/ICEVisioLink.d.ts

@@ -1,129 +1,163 @@
-import ICEPolyLine from './ICEPolyLine';
-/**
- * ! FIXME: 删掉对 GeoPoint/GeoLine/GeoUtil 的依赖
- * @class ICEVisioLink
- *
- * Visio 型的连接线
- *
- * 模拟 Microsoft Visio 中的折线算法，此实现从 diagramo 改进而来：http://diagramo.com/ 。
- *
- * 基本特性：
- *
- * - ICEVisioLink 只有 2 个端点，起点和终点。
- * - 除起始点和终点坐标之外，其它点会自动插值计算。
- * - ICEVisioLink 只能连接 2 个非线条类的组件。
- * - 线条互相之间不能连接，在 ICE 引擎中，不能用线条连接线条。
- * - 每一个可以被连接的组件上都有 4 个插槽（Slot），4 个插槽分布在组件最小边界盒子 4 条边的几何中点位置上。
- * - ICEVisioLink 的端点在移动时会判断是否与某个插槽发生碰撞，如果与某个插槽发生碰撞， ICEVisioLink 会连接到插槽所在的组件上。
- * - 同一个插槽（Slot）上可以连 N 根线，Slot 与 ICEVisioLink 之间的关系是 1->N 。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export default class ICEVisioLink extends ICEPolyLine {
-    /**
-     * FIXME:补全 props 配置项的描述
-     */
-    constructor(props?: any);
-    protected static arrangeParam(props: any): any;
-    /**
-     * ICEVisioLink 有自己特殊的计算方式。
-     *
-     * @overwrite
-     * @returns
-     */
-    protected calcDots(): any;
-    /**
-     * 在起点和终点之间插值。
-     *
-     * @returns
-     */
-    protected interpolate(): any[];
-    /**
-     * Tests if a vector of points is an orthogonal path (moving in multiples of 90 degrees).
-     *
-     *
-     * 正交判定。Visio 连接线上的每一段要么平行于 X 轴，要么平行于 Y 轴。
-     * @param {Array} v - an {Array} of {Point}s
-     * @return {Boolean} - true if path is valid, false otherwise
-     */
-    private orthogonalPath;
-    /**
-     * FIXME: 用更好的数学方法进行计算。
-     * Test to see if 2 {Line}s intersects. They are considered finite segments
-     * and not the infinite lines from geometry
-     * @param {Line} l1 - fist line/segment
-     * @param {Line} l2 - last line/segment
-     * @return {Boolean} true - if the lines intersect or false if not
-     */
-    private lineIntersectsLine;
-    /**
-     * Tests if a a polyline defined by a set of points intersects a rectangle
-     * @param {Array} points - and {Array} of {Point}s
-     * @param {Array} boundingRect - the boundingRect
-     * @param {Boolean} closedPolyline - incase polyline is closed figure then true, else false
-     * @return true - if line intersects the rectangle, false - if not
-     */
-    private polylineIntersectsRectangle;
-    /**
-     * Score a ortogonal path made out of Points
-     * Iterates over a set of points (minimum 3)
-     * For each 3 points (i, i+1, i+2) :
-     *  - if the 3rd one is after the 2nd on the same line we add +1
-     *  - if the 3rd is up or down related to the 2nd we do not do anything +0
-     *  - if the 3rd goes back we imediatelly return -1
-     * @param {Array} v - an array of {Point}s
-     * @return {Number} - -1 if the path is wrong (goes back) or something >= 0 if is fine.The bigger the number the smooth the path is.
-     */
-    private scorePath;
-    /**
-     * Returns the sign of a number
-     * @param {Number} x - the number
-     * @returns {Number}
-     * @see <a href="http://en.wikipedia.org/wiki/Sign_function">http://en.wikipedia.org/wiki/Sign_function</a>
-     */
-    private signum;
-    /**
-     * Tests if a vector of points is a valid path (not going back)
-     * There are a few problems here. If you have p1, p2, p3 and p4 and p2 = p3 you need to ignore that
-     * @param {Array} v - an {Array} of {Point}s
-     * @return {Boolean} - true if path is valid, false otherwise
-     */
-    private forwardPath;
-    /**
-     * @method distance
-     * Calculate the distance between two points.
-     *
-     *
-     * 计算两点之间的距离。
-     * @param {Point} p1 - first {Point}
-     * @param {Point} p2 - second {Point}
-     * @return {Number} - the distance between those 2 points. It is always positive.
-     */
-    private distance;
-    /**
-     * Returns the max of a vector
-     * @param {Array} v - vector of {Number}s
-     * @return {Number} - the maximum number from the vector or NaN if vector is empty
-     */
-    private max;
-    /**
-     * Returns the min of a vector
-     * @param {Array} v - vector of {Number}s
-     * @return {Number} - the minimum number from the vector or NaN if vector is empty
-     * @author alex@scriptoid.com
-     */
-    private min;
-    /**
-     * ICEVisioLink 中的点都是自动计算出来的，手动添加点没有意义。
-     * @overwrite
-     * @param point
-     * @param index
-     */
-    addDot(point: [number, number], index: number): void;
-    /**
-     * ICEVisioLink 中的点都是自动计算出来的，手动删除点没有意义。
-     * @overwrite
-     * @param index
-     */
-    rmDot(index: number): boolean;
-}
+import ICEPolyLine from './ICEPolyLine';
+/**
+ * ! FIXME: 删掉对 GeoPoint/GeoLine/GeoUtil 的依赖
+ * @class ICEVisioLink
+ *
+ * Visio 型的连接线
+ *
+ * 模拟 Microsoft Visio 中的折线算法，此实现从 diagramo 改进而来：http://diagramo.com/ 。
+ *
+ * 基本特性：
+ *
+ * - ICEVisioLink 只有 2 个端点，起点和终点。
+ * - 除起始点和终点坐标之外，其它点会自动插值计算。
+ * - ICEVisioLink 只能连接 2 个非线条类的组件。
+ * - 线条互相之间不能连接，在 ICE 引擎中，不能用线条连接线条。
+ * - 每一个可以被连接的组件上都有 4 个插槽（Slot），4 个插槽分布在组件最小边界盒子 4 条边的几何中点位置上。
+ * - ICEVisioLink 的端点在移动时会判断是否与某个插槽发生碰撞，如果与某个插槽发生碰撞， ICEVisioLink 会连接到插槽所在的组件上。
+ * - 同一个插槽（Slot）上可以连 N 根线，Slot 与 ICEVisioLink 之间的关系是 1->N 。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+export default class ICEVisioLink extends ICEPolyLine {
+    /**
+     * FIXME:补全 props 配置项的描述
+     */
+    constructor(props?: any);
+    protected static arrangeParam(props: any): any;
+    /**
+     * ICEVisioLink 有自己特殊的计算方式。
+     *
+     * @overwrite
+     * @returns
+     */
+    protected __calcDots(): any;
+    /**
+     * 贝塞尔形态：从两端点与插槽法线构造三次贝塞尔，等分采样后写回 points/dots。
+     *
+     * **为什么要把采样点写回 `state.points`**（而不是只算 dots）：`ICEPolyLine.isDotsOnSameLine()`
+     * 与 `getLabelPosition()` 都只读 `state.points`。若 points 只剩首尾两点会被判「共线」，
+     * 包围盒就会走 `splitEndpointsTo4Points()`、只按线宽沿弦外扩 → 曲线鼓出的部分落在盒外
+     * → dirty-rect 上屏快照盒偏小、局部重绘会把曲线裁掉。写回之后包围盒/标签/命中都自然正确。
+     *
+     * @returns
+     */
+    protected __calcBezierDots(): any;
+    /**
+     * 由两端点构造三次贝塞尔并等分采样（世界坐标）。
+     *
+     * 控制点：`C1 = start + dir(start 插槽) * offset`、`C2 = end + dir(end 插槽) * offset`，
+     * `offset = max(|end-start| * 0.45, 24)`，方向为插槽**外法线**（与正交布线的语义一致）。
+     */
+    protected buildBezierPoints(start: number[], end: number[]): number[][];
+    /**
+     * 某端插槽的外法线方向；C 槽 / 未连接 / 未知位置回落到弦方向。
+     *
+     * 注意 start 端用 `+chord`、end 端用 `-chord`（指向弦的内侧）：两端都取 `+chord` 的话，
+     * 控制点会落在两端点连线之外，曲线会先冲出去再拐回来（终点被越过）。
+     */
+    protected slotDirection(terminal: string, chord: number[]): number[];
+    /**
+     * @overwrite
+     * 贝塞尔形态不走正交路由。
+     *
+     * 应用层（如 ice-entity-designer 的 `routeRelations()`）会在布局后无条件把 `routeType` 设为
+     * `'orthogonal'`；不拦掉的话每次布局/移动都会用正交折线整体覆盖 `state.points`：
+     * 虽然下一帧 `__calcDots` 会把曲线重新采样回来，但语义错乱且白算一次。
+     */
+    protected recalculateRoute(): void;
+    /**
+     * 在起点和终点之间插值。
+     *
+     * @returns
+     */
+    protected interpolate(): any[];
+    /**
+     * Tests if a vector of points is an orthogonal path (moving in multiples of 90 degrees).
+     *
+     *
+     * 正交判定。Visio 连接线上的每一段要么平行于 X 轴，要么平行于 Y 轴。
+     * @param {Array} v - an {Array} of {Point}s
+     * @return {Boolean} - true if path is valid, false otherwise
+     */
+    private orthogonalPath;
+    /**
+     * FIXME: 用更好的数学方法进行计算。
+     * Test to see if 2 {Line}s intersects. They are considered finite segments
+     * and not the infinite lines from geometry
+     * @param {Line} l1 - fist line/segment
+     * @param {Line} l2 - last line/segment
+     * @return {Boolean} true - if the lines intersect or false if not
+     */
+    private lineIntersectsLine;
+    /**
+     * Tests if a a polyline defined by a set of points intersects a rectangle
+     * @param {Array} points - and {Array} of {Point}s
+     * @param {Array} boundingRect - the boundingRect
+     * @param {Boolean} closedPolyline - incase polyline is closed figure then true, else false
+     * @return true - if line intersects the rectangle, false - if not
+     */
+    private polylineIntersectsRectangle;
+    /**
+     * Score a ortogonal path made out of Points
+     * Iterates over a set of points (minimum 3)
+     * For each 3 points (i, i+1, i+2) :
+     *  - if the 3rd one is after the 2nd on the same line we add +1
+     *  - if the 3rd is up or down related to the 2nd we do not do anything +0
+     *  - if the 3rd goes back we imediatelly return -1
+     * @param {Array} v - an array of {Point}s
+     * @return {Number} - -1 if the path is wrong (goes back) or something >= 0 if is fine.The bigger the number the smooth the path is.
+     */
+    private scorePath;
+    /**
+     * Returns the sign of a number
+     * @param {Number} x - the number
+     * @returns {Number}
+     * @see <a href="http://en.wikipedia.org/wiki/Sign_function">http://en.wikipedia.org/wiki/Sign_function</a>
+     */
+    private signum;
+    /**
+     * Tests if a vector of points is a valid path (not going back)
+     * There are a few problems here. If you have p1, p2, p3 and p4 and p2 = p3 you need to ignore that
+     * @param {Array} v - an {Array} of {Point}s
+     * @return {Boolean} - true if path is valid, false otherwise
+     */
+    private forwardPath;
+    /**
+     * @method distance
+     * Calculate the distance between two points.
+     *
+     *
+     * 计算两点之间的距离。
+     * @param {Point} p1 - first {Point}
+     * @param {Point} p2 - second {Point}
+     * @return {Number} - the distance between those 2 points. It is always positive.
+     */
+    private distance;
+    /**
+     * Returns the max of a vector
+     * @param {Array} v - vector of {Number}s
+     * @return {Number} - the maximum number from the vector or NaN if vector is empty
+     */
+    private max;
+    /**
+     * Returns the min of a vector
+     * @param {Array} v - vector of {Number}s
+     * @return {Number} - the minimum number from the vector or NaN if vector is empty
+     * @author alex@scriptoid.com
+     */
+    private min;
+    /**
+     * ICEVisioLink 中的点都是自动计算出来的，手动添加点没有意义。
+     * @overwrite
+     * @param point
+     * @param index
+     */
+    addDot(point: [number, number], index: number): void;
+    /**
+     * ICEVisioLink 中的点都是自动计算出来的，手动删除点没有意义。
+     * @overwrite
+     * @param index
+     */
+    rmDot(index: number): boolean;
+}

package/dist/types/graphic/shape/ICECircle.d.mts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import ICEEllipse from './ICEEllipse.mjs';
+/**
+ * @class ICECircle 正圆形
+ *
+ * 采用椭圆绘制方法，正圆形作为椭圆的特殊情况。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICECircle extends ICEEllipse {
+    constructor(props?: any);
+}
+export default ICECircle;

package/dist/types/graphic/shape/ICECircle.d.ts

@@ -1,19 +1,19 @@
-/**
- * Copyright (c) 2022 大漠穷秋.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
-import ICEEllipse from './ICEEllipse';
-/**
- * @class ICECircle 正圆形
- *
- * 采用椭圆绘制方法，正圆形作为椭圆的特殊情况。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare class ICECircle extends ICEEllipse {
-    constructor(props?: any);
-}
-export default ICECircle;
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import ICEEllipse from './ICEEllipse';
+/**
+ * @class ICECircle 正圆形
+ *
+ * 采用椭圆绘制方法，正圆形作为椭圆的特殊情况。
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICECircle extends ICEEllipse {
+    constructor(props?: any);
+}
+export default ICECircle;

package/dist/types/graphic/shape/ICEEllipse.d.mts

@@ -0,0 +1,29 @@
+import ICEPath from '../ICEPath.mjs';
+/**
+ * @class ICEEllipse 椭圆形
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEEllipse extends ICEPath {
+    constructor(props?: any);
+    /**
+     * 所有坐标点的坐标都是相对于父层组件，而不是全局坐标。
+     * @returns
+     */
+    protected createPathObject(): any;
+    /**
+     * 精确命中判定：点是否位于椭圆内部（圆心为本地原点）。
+     * 圆作为椭圆的特例（radiusX === radiusY）自动继承此实现。
+     * @overwrite
+     */
+    protected containsLocalPoint(localX: number, localY: number): boolean;
+    /**
+     * setState 仅仅修改参数，不会立即导致重新渲染，需要等待 FrameManager 调度，最小延迟时间约为 1/60=16.67 ms 。
+     *
+     * - 如果 setState 时指定了 radiusX 参数，则 width 会被重新计算，如果指定了 radiusY 参数则 height 会被重新计算。
+     * - 如果 setState 时仅仅指定 width 参数，则 radiusX 会被重新计算，如果仅仅指定了 height 参数，则 radiusY 会被重新计算。
+     * @overwrite
+     * @param newState
+     */
+    setState(newState: any): void;
+}
+export default ICEEllipse;

package/dist/types/graphic/shape/ICEEllipse.d.ts

@@ -1,23 +1,29 @@
-import ICEPath from '../ICEPath';
-/**
- * @class ICEEllipse 椭圆形
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare class ICEEllipse extends ICEPath {
-    constructor(props?: any);
-    /**
-     * 所有坐标点的坐标都是相对于父层组件，而不是全局坐标。
-     * @returns
-     */
-    protected createPathObject(): Path2D;
-    /**
-     * setState 仅仅修改参数，不会立即导致重新渲染，需要等待 FrameManager 调度，最小延迟时间约为 1/60=16.67 ms 。
-     *
-     * - 如果 setState 时指定了 radiusX 参数，则 width 会被重新计算，如果指定了 radiusY 参数则 height 会被重新计算。
-     * - 如果 setState 时仅仅指定 width 参数，则 radiusX 会被重新计算，如果仅仅指定了 height 参数，则 radiusY 会被重新计算。
-     * @overwrite
-     * @param newState
-     */
-    setState(newState: any): void;
-}
-export default ICEEllipse;
+import ICEPath from '../ICEPath';
+/**
+ * @class ICEEllipse 椭圆形
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEEllipse extends ICEPath {
+    constructor(props?: any);
+    /**
+     * 所有坐标点的坐标都是相对于父层组件，而不是全局坐标。
+     * @returns
+     */
+    protected createPathObject(): any;
+    /**
+     * 精确命中判定：点是否位于椭圆内部（圆心为本地原点）。
+     * 圆作为椭圆的特例（radiusX === radiusY）自动继承此实现。
+     * @overwrite
+     */
+    protected containsLocalPoint(localX: number, localY: number): boolean;
+    /**
+     * setState 仅仅修改参数，不会立即导致重新渲染，需要等待 FrameManager 调度，最小延迟时间约为 1/60=16.67 ms 。
+     *
+     * - 如果 setState 时指定了 radiusX 参数，则 width 会被重新计算，如果指定了 radiusY 参数则 height 会被重新计算。
+     * - 如果 setState 时仅仅指定 width 参数，则 radiusX 会被重新计算，如果仅仅指定了 height 参数，则 radiusY 会被重新计算。
+     * @overwrite
+     * @param newState
+     */
+    setState(newState: any): void;
+}
+export default ICEEllipse;

package/dist/types/graphic/shape/ICEIsogon.d.mts

@@ -0,0 +1,52 @@
+import ICEDotPath from '../ICEDotPath.mjs';
+/**
+ *
+ * @class ICEIsogon 正N边形
+ *
+ * @author 大漠穷秋<damoqiongqiu@126.com>
+ */
+declare class ICEIsogon extends ICEDotPath {
+    /**
+     * @method constructor
+     * radius, edges 会暴露给 AnimationManager ，可能会动态变化。
+     * @param props
+     */
+    constructor(props?: any);
+    /**
+     * @overwrite
+     * @method __calcDots
+     *
+     * 计算路径上的关键点:
+     * - 默认的坐标原点是 (0,0) 位置。
+     * - 这些点没有经过 transform 矩阵变换。
+     *
+     * @returns
+     */
+    protected __calcDots(): any;
+    /**
+     * @overwrite
+     * @method calcComponentParams
+     * - 计算组件最原始的宽高和位置，此时没有经过任何变换，也没有移动坐标原点。
+     * - 在计算组件的原始尺寸时还没有确定原点坐标，所以只能基于组件本地坐标系的左上角 (0,0) 点进行计算。
+     * - 此方法不能依赖原点位置和 transform 矩阵。
+     * - 此方法会在 render() 中调用，所以不需要在构造函数中调用。
+     * - 此方法中不能使用 setState() ，如果需要修改状态，直接赋值，如：this.state.width = 100;
+     * - 子类可以覆盖此方法，实现自己的计算逻辑。
+     * @returns
+     */
+    protected calcComponentParams(): {
+        width: any;
+        height: any;
+    };
+    /**
+     * @overwrite
+     * @method setState
+     * setState 仅仅修改参数，不会立即导致重新渲染，需要等待 FrameManager 调度，最小延迟时间约为 1/60=16.67 ms 。
+     *
+     * - 如果 setState 时指定了 radius 参数，则 width 会被重新计算，如果指定了 radius 参数则 height 会被重新计算。
+     * - 如果 setState 时仅仅指定 width 参数，则 radius 会被重新计算，如果仅仅指定了 height 参数，则 radius 会被重新计算。
+     * @param newState
+     */
+    setState(newState: any): void;
+}
+export default ICEIsogon;