ice-entity-designer 0.0.39 → 0.1.0

package/dist/types/ice-render/control-panel/ICEControlPanel.d.ts

@@ -1,37 +0,0 @@
-/**
- * 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 ICEGroup from '../graphic/container/ICEGroup';
-import ICEComponent from '../graphic/ICEComponent';
-/**
- * @class ICEControlPanel 控制面板
- *
- * - ICEControlPanel 用来辅助用户操作图形，控制面板可以控制图形的属性，比如组件的属性，线条的属性，文本的属性等等。
- * - ICEControlPanel 本身总是直接画在 canvas 上，不是任何组件的孩子。
- * - ICEControlPanel 本身不会被序列化。
- * - ICEControlPanel 的 zIndex 总是大于其它组件，当 ICEControlPanel 显示时，总是会优先判定为被选中的组件，会导致对应的 _targetComponent 收不到鼠标和键盘事件，所以 ICEControlPanel 的实现类需要自己考虑是否需要进行事件转发。
- * - 控制面板的所有实例都在 ICEControlPanelManager 中创建和管理。
- *
- * @see ICEControlPanelManager
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export default abstract class ICEControlPanel extends ICEGroup {
-    /**
-     * 类型标识
-     * 用来解决 TypeScript 的 instanceof 兼容性问题， https://github.com/microsoft/TypeScript/issues/22585
-     * 仅供内部使用，业务代码不可依赖此属性
-     */
-    isControlPanel: boolean;
-    protected _targetComponent: ICEComponent;
-    constructor(props: any);
-    protected abstract initControls(): void;
-    protected abstract updateControlPositions(): void;
-    protected doRender(): void;
-    moveGlobalPosition(tx: number, ty: number, evt?: any): void;
-    abstract enable(): any;
-    abstract disable(): any;
-}

package/dist/types/ice-render/control-panel/ICEControlPanelManager.d.mts

@@ -1,25 +0,0 @@
-import ICE from '../ICE.mjs';
-import LineControlPanel from './link-controls/LineControlPanel.mjs';
-import TransformControlPanel from './transform-controls/TransformControlPanel.mjs';
-/**
- * @class ICEControlPanelManager
- *
- * 控制面板管理器
- *
- * - ICEControlPanelManager 负责管理所有类型的控制面板（ControlPanel）。
- * - ICEControlPanelManager 是全局单例的，一个 ICE 实例上只能有一个实例。
- * - ICEControlPanelManager 是纯逻辑组件，没有外观。
- *
- * @see ICE
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare class ICEControlPanelManager {
-    private ice;
-    transformControlPanel: TransformControlPanel;
-    lineControlPanel: LineControlPanel;
-    constructor(ice: ICE);
-    start(): this;
-    stop(): this;
-    private mouseDownHandler;
-}
-export default ICEControlPanelManager;

package/dist/types/ice-render/control-panel/ICEControlPanelManager.d.ts

@@ -1,25 +0,0 @@
-import ICE from '../ICE';
-import LineControlPanel from './link-controls/LineControlPanel';
-import TransformControlPanel from './transform-controls/TransformControlPanel';
-/**
- * @class ICEControlPanelManager
- *
- * 控制面板管理器
- *
- * - ICEControlPanelManager 负责管理所有类型的控制面板（ControlPanel）。
- * - ICEControlPanelManager 是全局单例的，一个 ICE 实例上只能有一个实例。
- * - ICEControlPanelManager 是纯逻辑组件，没有外观。
- *
- * @see ICE
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare class ICEControlPanelManager {
-    private ice;
-    transformControlPanel: TransformControlPanel;
-    lineControlPanel: LineControlPanel;
-    constructor(ice: ICE);
-    start(): this;
-    stop(): this;
-    private mouseDownHandler;
-}
-export default ICEControlPanelManager;

package/dist/types/ice-render/control-panel/link-controls/LineControlPanel.d.mts

@@ -1,39 +0,0 @@
-import ICEComponent from '../../graphic/ICEComponent.mjs';
-import ICEControlPanel from '../ICEControlPanel.mjs';
-/**
- *
- * @class LineControlPanel
- *
- * 线条变换控制面板
- *
- * LineControlPanel 只作为空的逻辑容器存在，控制面板内部的操作手柄需要全屏幕自由移动位置，手柄位置不固定，对 LineControlPanel 本身的参数完全没有影响。
- *
- * LineControlPanel 功能：
- *
- * - 移动线条的位置
- * - 调整线条起点和终点的位置
- * - 将线条连接到其它组件上
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export default class LineControlPanel extends ICEControlPanel {
-    private controlSize;
-    private startControl;
-    private endControl;
-    constructor(props: any);
-    protected initControls(): void;
-    protected initEvents(): void;
-    enable(): void;
-    disable(): void;
-    /**
-     * 设置所有手柄在父组件中的位置，相对于父组件的本地坐标系。
-     * LineControlPanel 不强制操作手柄的位置，操作手柄可以自由移动。
-     */
-    protected updateControlPositions(): void;
-    private resizeEvtHandler;
-    protected updatePosition(): void;
-    set targetComponent(component: ICEComponent);
-    get targetComponent(): ICEComponent;
-    showHooks(): void;
-    hideHooks(): void;
-}

package/dist/types/ice-render/control-panel/link-controls/LineControlPanel.d.ts

@@ -1,39 +0,0 @@
-import ICEComponent from '../../graphic/ICEComponent';
-import ICEControlPanel from '../ICEControlPanel';
-/**
- *
- * @class LineControlPanel
- *
- * 线条变换控制面板
- *
- * LineControlPanel 只作为空的逻辑容器存在，控制面板内部的操作手柄需要全屏幕自由移动位置，手柄位置不固定，对 LineControlPanel 本身的参数完全没有影响。
- *
- * LineControlPanel 功能：
- *
- * - 移动线条的位置
- * - 调整线条起点和终点的位置
- * - 将线条连接到其它组件上
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export default class LineControlPanel extends ICEControlPanel {
-    private controlSize;
-    private startControl;
-    private endControl;
-    constructor(props: any);
-    protected initControls(): void;
-    protected initEvents(): void;
-    enable(): void;
-    disable(): void;
-    /**
-     * 设置所有手柄在父组件中的位置，相对于父组件的本地坐标系。
-     * LineControlPanel 不强制操作手柄的位置，操作手柄可以自由移动。
-     */
-    protected updateControlPositions(): void;
-    private resizeEvtHandler;
-    protected updatePosition(): void;
-    set targetComponent(component: ICEComponent);
-    get targetComponent(): ICEComponent;
-    showHooks(): void;
-    hideHooks(): void;
-}

package/dist/types/ice-render/control-panel/transform-controls/ResizeControl.d.mts

@@ -1,38 +0,0 @@
-import ICERect from '../../graphic/shape/ICERect.mjs';
-/**
- * @class ResizeControl 调整尺寸的操作手柄
- *
- * - 调整尺寸的操作手柄不能独立存在，只能依附在某个宿主对象上。
- * - 此手柄只能调整尺寸，不能实现翻转
- *
- */
-export default class ResizeControl extends ICERect {
-    /**
-     * props:
-     * {
-     *   direction: 改变的方向，共有3个可选的值： x/y/both
-     *   position: 手柄在变换矩形4个边上的位置，共有8个：lt/t/rt/r/rb/b/lb/l
-     *   quadrant: 当前所在的象限
-     * }
-     * @param props
-     */
-    constructor(props: any);
-    protected initEvents(): void;
-    /**
-     * @param evt
-     */
-    private resizeEvtHandler;
-    /**
-     * @overwrite
-     * @method moveGlobalPosition
-     * ResizeControl 不能自由移动自己的位置，自能在X轴、Y轴，以及矩形的2条对角线上移动位置。
-     *
-     * 在全局空间(canvas)中移动指定的位移。
-     * 注意：此方法用于直接设置组件在全局空间中的位移，而不是相对于其它坐标系。
-     *
-     * @param tx
-     * @param ty
-     * @param evt
-     */
-    moveGlobalPosition(tx: number, ty: number, evt?: any): void;
-}

package/dist/types/ice-render/control-panel/transform-controls/ResizeControl.d.ts

@@ -1,38 +0,0 @@
-import ICERect from '../../graphic/shape/ICERect';
-/**
- * @class ResizeControl 调整尺寸的操作手柄
- *
- * - 调整尺寸的操作手柄不能独立存在，只能依附在某个宿主对象上。
- * - 此手柄只能调整尺寸，不能实现翻转
- *
- */
-export default class ResizeControl extends ICERect {
-    /**
-     * props:
-     * {
-     *   direction: 改变的方向，共有3个可选的值： x/y/both
-     *   position: 手柄在变换矩形4个边上的位置，共有8个：lt/t/rt/r/rb/b/lb/l
-     *   quadrant: 当前所在的象限
-     * }
-     * @param props
-     */
-    constructor(props: any);
-    protected initEvents(): void;
-    /**
-     * @param evt
-     */
-    private resizeEvtHandler;
-    /**
-     * @overwrite
-     * @method moveGlobalPosition
-     * ResizeControl 不能自由移动自己的位置，自能在X轴、Y轴，以及矩形的2条对角线上移动位置。
-     *
-     * 在全局空间(canvas)中移动指定的位移。
-     * 注意：此方法用于直接设置组件在全局空间中的位移，而不是相对于其它坐标系。
-     *
-     * @param tx
-     * @param ty
-     * @param evt
-     */
-    moveGlobalPosition(tx: number, ty: number, evt?: any): void;
-}

package/dist/types/ice-render/control-panel/transform-controls/RotateControl.d.mts

@@ -1,12 +0,0 @@
-import ICECircle from '../../graphic/shape/ICECircle.mjs';
-/**
- * @class RotateControl 旋转操作手柄
- *
- * - 旋转手柄不能独立存在，只能依附在某个宿主对象上。
- * - 此手柄仅用来修改组件的旋转角度。
- */
-export default class RotateControl extends ICECircle {
-    constructor(props: any);
-    protected initEvents(): void;
-    private rotateEvtHandler;
-}

package/dist/types/ice-render/control-panel/transform-controls/RotateControl.d.ts

@@ -1,12 +0,0 @@
-import ICECircle from '../../graphic/shape/ICECircle';
-/**
- * @class RotateControl 旋转操作手柄
- *
- * - 旋转手柄不能独立存在，只能依附在某个宿主对象上。
- * - 此手柄仅用来修改组件的旋转角度。
- */
-export default class RotateControl extends ICECircle {
-    constructor(props: any);
-    protected initEvents(): void;
-    private rotateEvtHandler;
-}

package/dist/types/ice-render/control-panel/transform-controls/TransformControlPanel.d.mts

@@ -1,83 +0,0 @@
-import ICEComponent from '../../graphic/ICEComponent.mjs';
-import ICEControlPanel from '../ICEControlPanel.mjs';
-/**
- * @class TransformControlPanel
- *
- * 变换控制面板
- *
- * - TransformControlPanel 本身总是直接画在 canvas 上，不是任何组件的孩子。
- * - TransformControlPanel 是全局单例，在任意时刻，不可能同时出现多个 TransformControlPanel 的实例，因为在图形化的用户交互模式下，用户无法同时操控多个控制面板。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export default class TransformControlPanel extends ICEControlPanel {
-    private rotateControlInstance;
-    private rotateControlSize;
-    private rotateControlOffsetY;
-    private resizeControlInstanceCache;
-    private resizeControlSize;
-    constructor(props: any);
-    /**
-     * @method initControls
-     * 添加尺寸和旋转变换手柄，初始化时添加在内部的[0,0]位置，此方法只创建对象实例，不执行渲染操作。
-     * 创建 8 个 ResizeControl
-     * 计算手柄位于父组件的哪一个象限中，有以下取值：
-     *  - 1: 第1象限；
-     *  - 2: 第2象限；
-     *  - 3: 第3象限；
-     *  - 4: 第4象限；
-     *  - 5: 位于X轴上方，y值为负，不属于任何象限；
-     *  - 6: 位于X轴下方，y值为正，不属于任何象限；
-     *  - 7: 位于Y轴左侧，x值为负，不属于任何象限；
-     *  - 8: 位于Y轴右侧，x值为正，不属于任何象限；
-     * 默认创建顺序，从左上角开始顺时针：tl:2/t:5/tr:1/r:8/rb:4/b:6/lb:3/l:7
-     * 第1和第3象限可以交换位置
-     * 第2和第4象限可以交换位置
-     * X 轴正负可以交换位置
-     * Y 轴正负可以交换位置
-     * TODO:添加斜切手柄？
-     */
-    protected initControls(): void;
-    protected initEvents(): void;
-    enable(): void;
-    disable(): void;
-    /**
-     * @overwrite
-     * @method keyboardEvtHandler 键盘事件处理
-     * !ICEControlPanel 的 zIndex 总是大于其它组件，当 ICEControlPanel 显示时，总是会优先判定为被选中的组件，会导致对应的 _targetComponent 收不到鼠标和键盘事件，所以 ICEControlPanel 的实现类需要自己考虑是否需要进行事件转发。
-     * !如果当前的 targetComponent 不为空，转发键盘事件。
-     * @see {ICEControlPanel}
-     * @see {ICEComponent}
-     * @param evt
-     * @returns
-     */
-    protected keyboardEvtHandler(evt: any): void;
-    private rotateEvtHandler;
-    private resizeEvtHandler;
-    /**
-     * @overwrite
-     * @method updateControlPositions 更新内部控制手柄的位置
-     *
-     * 控制面板每次重绘时，会在 doRender() 方法内部会调用 updateControlPositions() 来 更新控制手柄的位置。
-     * @see ICEConrolPanel.doRender()
-     */
-    protected updateControlPositions(): void;
-    protected updatePanel(): void;
-    /**
-     * 目标被移除时的处理。
-     *
-     * 必须是**稳定引用**：旧实现用 `once(BEFORE_REMOVE, () => {...})`，而 `once` 内部会把回调
-     * 再包一层，导致这个箭头函数永远无法被 `off` —— 反复选中组件会在每个组件上累积
-     * 无法回收的监听（内存泄漏 + 幽灵回调）。这里改为具名属性 + `on`，
-     * 由 setter 负责在切换目标时 `off` 掉（`on` 本身对 (fn, scope) 幂等，也不会重复注册）。
-     */
-    private __onTargetRemoved;
-    set targetComponent(component: ICEComponent);
-    get targetComponent(): ICEComponent;
-    /**
-     * 交换两个 Control 的象限
-     * @param control
-     * @param quadrant
-     */
-    toggleControlQuadrant(control: any, oldQuadrant: number, newQuadrant: number): void;
-}

package/dist/types/ice-render/control-panel/transform-controls/TransformControlPanel.d.ts

@@ -1,83 +0,0 @@
-import ICEComponent from '../../graphic/ICEComponent';
-import ICEControlPanel from '../ICEControlPanel';
-/**
- * @class TransformControlPanel
- *
- * 变换控制面板
- *
- * - TransformControlPanel 本身总是直接画在 canvas 上，不是任何组件的孩子。
- * - TransformControlPanel 是全局单例，在任意时刻，不可能同时出现多个 TransformControlPanel 的实例，因为在图形化的用户交互模式下，用户无法同时操控多个控制面板。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export default class TransformControlPanel extends ICEControlPanel {
-    private rotateControlInstance;
-    private rotateControlSize;
-    private rotateControlOffsetY;
-    private resizeControlInstanceCache;
-    private resizeControlSize;
-    constructor(props: any);
-    /**
-     * @method initControls
-     * 添加尺寸和旋转变换手柄，初始化时添加在内部的[0,0]位置，此方法只创建对象实例，不执行渲染操作。
-     * 创建 8 个 ResizeControl
-     * 计算手柄位于父组件的哪一个象限中，有以下取值：
-     *  - 1: 第1象限；
-     *  - 2: 第2象限；
-     *  - 3: 第3象限；
-     *  - 4: 第4象限；
-     *  - 5: 位于X轴上方，y值为负，不属于任何象限；
-     *  - 6: 位于X轴下方，y值为正，不属于任何象限；
-     *  - 7: 位于Y轴左侧，x值为负，不属于任何象限；
-     *  - 8: 位于Y轴右侧，x值为正，不属于任何象限；
-     * 默认创建顺序，从左上角开始顺时针：tl:2/t:5/tr:1/r:8/rb:4/b:6/lb:3/l:7
-     * 第1和第3象限可以交换位置
-     * 第2和第4象限可以交换位置
-     * X 轴正负可以交换位置
-     * Y 轴正负可以交换位置
-     * TODO:添加斜切手柄？
-     */
-    protected initControls(): void;
-    protected initEvents(): void;
-    enable(): void;
-    disable(): void;
-    /**
-     * @overwrite
-     * @method keyboardEvtHandler 键盘事件处理
-     * !ICEControlPanel 的 zIndex 总是大于其它组件，当 ICEControlPanel 显示时，总是会优先判定为被选中的组件，会导致对应的 _targetComponent 收不到鼠标和键盘事件，所以 ICEControlPanel 的实现类需要自己考虑是否需要进行事件转发。
-     * !如果当前的 targetComponent 不为空，转发键盘事件。
-     * @see {ICEControlPanel}
-     * @see {ICEComponent}
-     * @param evt
-     * @returns
-     */
-    protected keyboardEvtHandler(evt: any): void;
-    private rotateEvtHandler;
-    private resizeEvtHandler;
-    /**
-     * @overwrite
-     * @method updateControlPositions 更新内部控制手柄的位置
-     *
-     * 控制面板每次重绘时，会在 doRender() 方法内部会调用 updateControlPositions() 来 更新控制手柄的位置。
-     * @see ICEConrolPanel.doRender()
-     */
-    protected updateControlPositions(): void;
-    protected updatePanel(): void;
-    /**
-     * 目标被移除时的处理。
-     *
-     * 必须是**稳定引用**：旧实现用 `once(BEFORE_REMOVE, () => {...})`，而 `once` 内部会把回调
-     * 再包一层，导致这个箭头函数永远无法被 `off` —— 反复选中组件会在每个组件上累积
-     * 无法回收的监听（内存泄漏 + 幽灵回调）。这里改为具名属性 + `on`，
-     * 由 setter 负责在切换目标时 `off` 掉（`on` 本身对 (fn, scope) 幂等，也不会重复注册）。
-     */
-    private __onTargetRemoved;
-    set targetComponent(component: ICEComponent);
-    get targetComponent(): ICEComponent;
-    /**
-     * 交换两个 Control 的象限
-     * @param control
-     * @param quadrant
-     */
-    toggleControlQuadrant(control: any, oldQuadrant: number, newQuadrant: number): void;
-}

package/dist/types/ice-render/control-panel/transform-controls/constraints.d.mts

@@ -1,24 +0,0 @@
-/**
- * 变换手柄的约束算法（纯函数，便于单测）。
- *
- * 这些约束由输入层透传的修饰键驱动（`evt.shiftKey` 等）——注意 DOM 事件的修饰键是原型上的
- * 不可枚举 getter，`ICEEvent` 的 `for...in` 拷贝带不过来，必须由 `input-normalize` 显式透传。
- */
-/** 旋转吸附的默认步进（度）。 */
-export declare const ROTATE_SNAP_STEP = 15;
-/**
- * 等比约束：在「目标尺寸」基础上保持 `currentWidth : currentHeight` 不变。
- *
- * 取两个方向中**相对变化更大**的那个作为基准，另一个方向按比例跟随 —— 这样拖动角手柄时
- * 跟随手感更贴近手指，也不会出现「一个方向已到目标、另一个方向还没动」的粘滞感。
- * 尺寸取绝对值（翻转由调用方决定，不在这里处理）。
- */
-export declare function applyAspectLock(currentWidth: number, currentHeight: number, nextWidth: number, nextHeight: number): {
-    width: number;
-    height: number;
-};
-/**
- * 角度吸附：把角度吸附到 `step` 的整数倍（默认 15°）。
- * 吸附在**最终角度**上做（调用方已把补偿角加上），避免补偿把吸附结果带偏。
- */
-export declare function snapAngle(angle: number, step?: number): number;

package/dist/types/ice-render/control-panel/transform-controls/constraints.d.ts

@@ -1,24 +0,0 @@
-/**
- * 变换手柄的约束算法（纯函数，便于单测）。
- *
- * 这些约束由输入层透传的修饰键驱动（`evt.shiftKey` 等）——注意 DOM 事件的修饰键是原型上的
- * 不可枚举 getter，`ICEEvent` 的 `for...in` 拷贝带不过来，必须由 `input-normalize` 显式透传。
- */
-/** 旋转吸附的默认步进（度）。 */
-export declare const ROTATE_SNAP_STEP = 15;
-/**
- * 等比约束：在「目标尺寸」基础上保持 `currentWidth : currentHeight` 不变。
- *
- * 取两个方向中**相对变化更大**的那个作为基准，另一个方向按比例跟随 —— 这样拖动角手柄时
- * 跟随手感更贴近手指，也不会出现「一个方向已到目标、另一个方向还没动」的粘滞感。
- * 尺寸取绝对值（翻转由调用方决定，不在这里处理）。
- */
-export declare function applyAspectLock(currentWidth: number, currentHeight: number, nextWidth: number, nextHeight: number): {
-    width: number;
-    height: number;
-};
-/**
- * 角度吸附：把角度吸附到 `step` 的整数倍（默认 15°）。
- * 吸附在**最终角度**上做（调用方已把补偿角加上），避免补偿把吸附结果带偏。
- */
-export declare function snapAngle(angle: number, step?: number): number;

package/dist/types/ice-render/cross-platform/Path2DRecorder.d.mts

@@ -1,76 +0,0 @@
-/**
- * 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.
- *
- */
-/**
- * @class Path2DRecorder
- *
- * 路径对象的**唯一入口**：一边把命令写给内存里的命令流，一边转发给运行时的原生 Path2D。
- *
- * 为什么需要它：原生 `Path2D` 是不透明的 —— 画得出来，但拿不到「这条路径到底是什么形状」。
- * 而引擎的这几件事都需要**路径的几何描述**，不只是「画出来」：
- *
- * - 导出（SVG / 打印 / 服务端出图）：要把路径转成 `d` 属性；
- * - 服务端 / 小程序（无原生 Path2D）：要靠命令流重放到 ctx（原先只有 PolyfillPath2D 能做到）；
- * - 测试与调试：可以直接断言「这个形状生成了哪几条命令」，不必截图比对像素。
- *
- * 设计取舍：
- * - **有原生 Path2D 时仍然用原生对象上屏**（`native`），命令流只是顺带记录，渲染路径与旧版
- *   完全一致；`ICEPath.doRender()` 用 `path2D.native || path2D` 取上屏对象。
- * - **没有原生 Path2D 时**（小程序低版本 / Node）退化为纯记录器：`_isPolyfill` 为真，
- *   `ICEPath` 走「重放命令到 ctx」的老路径，行为与之前的 PolyfillPath2D 一致。
- * - 路径是**几何变化时才重建**（`doRender` 只在 dirty 时调用 `createPathObject()`），因此
- *   记录带来的开销只发生在路径重建时，不在每帧热路径上。
- *
- * 命令格式与 PolyfillPath2D 一致（也被 `replayPath()` 复用）：
- * `[['moveTo', x, y], ['rect', x, y, w, h], ...]`
- */
-export default class Path2DRecorder {
-    /** 标记「没有原生 Path2D，需要重放命令」——与 PolyfillPath2D 的语义保持一致 */
-    _isPolyfill: boolean;
-    /** 记录的命令序列 */
-    _commands: Array<Array<any>>;
-    /** closePath 是幂等标记（doRender 每帧调用），不重复入队 */
-    _closed: boolean;
-    /** 原生 Path2D（有则上屏直接用它，命令流仍然记录）；无则为 null */
-    readonly native: any;
-    /** 当前点（画布 arcTo / 圆弧的语义依赖它），[x, y]；空表示没有当前子路径 */
-    private __current;
-    /** 当前子路径的起点（closePath 后当前点回到这里） */
-    private __subpathStart;
-    constructor(native?: any);
-    /** 上屏对象：有原生就用原生，否则用记录器自己（配合 replayPath 重放） */
-    get drawable(): any;
-    moveTo(x: number, y: number): void;
-    lineTo(x: number, y: number): void;
-    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number): void;
-    quadraticCurveTo(cpx: number, cpy: number, x: number, y: number): void;
-    /**
-     * 圆角/切线圆弧。
-     *
-     * canvas 的 `arcTo` 依赖「当前点 + 控制点 + 半径」的切线关系，**SVG 没有对应命令**。
-     * 这里在记录阶段就把它**还原成 `lineTo(切点) + arc(圆心, 半径, 起止角)`**：
-     *
-     * - 出口是标准命令流，SVG 导出（以及任何重放到 ctx 的运行时）都不需要再懂 arcTo；
-     * - 原生 Path2D 收到的是等价的 lineTo/arc，渲染结果与直接 arcTo 一致；
-     * - 圆角矩形（ICERect 的 radius）就是靠它才能导出成真正的圆角，否则导出会变成切角。
-     *
-     * 数学：设 P0 = 当前点、P1 = 控制点、P2 = 终点，u = 单位(P0−P1)、v = 单位(P2−P1)，
-     * 夹角 θ = ∠(u,v)，切点到 P1 的距离 t = r / tan(θ/2)，圆心在角平分线上距 P1 为 r / sin(θ/2)。
-     */
-    arcTo(x1: number, y1: number, x2: number, y2: number, radius: number): void;
-    rect(x: number, y: number, width: number, height: number): void;
-    /**
-     * 圆弧。**必须实现**：事件圆等形状用的是 `arc`，此前 PolyfillPath2D 没有它，
-     * 于是「无原生 Path2D」的运行时（Node / 小程序低版本）画这类形状会直接抛
-     * `path.arc is not a function` —— 这正是服务端出图要修的第一件事。
-     */
-    arc(x: number, y: number, radius: number, startAngle: number, endAngle: number, counterclockwise?: boolean): void;
-    ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number, startAngle: number, endAngle: number, counterclockwise: boolean): void;
-    closePath(): void;
-    /** 当前点（只读；调试与测试用） */
-    get currentPoint(): [number, number] | null;
-}

package/dist/types/ice-render/cross-platform/Path2DRecorder.d.ts

@@ -1,76 +0,0 @@
-/**
- * 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.
- *
- */
-/**
- * @class Path2DRecorder
- *
- * 路径对象的**唯一入口**：一边把命令写给内存里的命令流，一边转发给运行时的原生 Path2D。
- *
- * 为什么需要它：原生 `Path2D` 是不透明的 —— 画得出来，但拿不到「这条路径到底是什么形状」。
- * 而引擎的这几件事都需要**路径的几何描述**，不只是「画出来」：
- *
- * - 导出（SVG / 打印 / 服务端出图）：要把路径转成 `d` 属性；
- * - 服务端 / 小程序（无原生 Path2D）：要靠命令流重放到 ctx（原先只有 PolyfillPath2D 能做到）；
- * - 测试与调试：可以直接断言「这个形状生成了哪几条命令」，不必截图比对像素。
- *
- * 设计取舍：
- * - **有原生 Path2D 时仍然用原生对象上屏**（`native`），命令流只是顺带记录，渲染路径与旧版
- *   完全一致；`ICEPath.doRender()` 用 `path2D.native || path2D` 取上屏对象。
- * - **没有原生 Path2D 时**（小程序低版本 / Node）退化为纯记录器：`_isPolyfill` 为真，
- *   `ICEPath` 走「重放命令到 ctx」的老路径，行为与之前的 PolyfillPath2D 一致。
- * - 路径是**几何变化时才重建**（`doRender` 只在 dirty 时调用 `createPathObject()`），因此
- *   记录带来的开销只发生在路径重建时，不在每帧热路径上。
- *
- * 命令格式与 PolyfillPath2D 一致（也被 `replayPath()` 复用）：
- * `[['moveTo', x, y], ['rect', x, y, w, h], ...]`
- */
-export default class Path2DRecorder {
-    /** 标记「没有原生 Path2D，需要重放命令」——与 PolyfillPath2D 的语义保持一致 */
-    _isPolyfill: boolean;
-    /** 记录的命令序列 */
-    _commands: Array<Array<any>>;
-    /** closePath 是幂等标记（doRender 每帧调用），不重复入队 */
-    _closed: boolean;
-    /** 原生 Path2D（有则上屏直接用它，命令流仍然记录）；无则为 null */
-    readonly native: any;
-    /** 当前点（画布 arcTo / 圆弧的语义依赖它），[x, y]；空表示没有当前子路径 */
-    private __current;
-    /** 当前子路径的起点（closePath 后当前点回到这里） */
-    private __subpathStart;
-    constructor(native?: any);
-    /** 上屏对象：有原生就用原生，否则用记录器自己（配合 replayPath 重放） */
-    get drawable(): any;
-    moveTo(x: number, y: number): void;
-    lineTo(x: number, y: number): void;
-    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number): void;
-    quadraticCurveTo(cpx: number, cpy: number, x: number, y: number): void;
-    /**
-     * 圆角/切线圆弧。
-     *
-     * canvas 的 `arcTo` 依赖「当前点 + 控制点 + 半径」的切线关系，**SVG 没有对应命令**。
-     * 这里在记录阶段就把它**还原成 `lineTo(切点) + arc(圆心, 半径, 起止角)`**：
-     *
-     * - 出口是标准命令流，SVG 导出（以及任何重放到 ctx 的运行时）都不需要再懂 arcTo；
-     * - 原生 Path2D 收到的是等价的 lineTo/arc，渲染结果与直接 arcTo 一致；
-     * - 圆角矩形（ICERect 的 radius）就是靠它才能导出成真正的圆角，否则导出会变成切角。
-     *
-     * 数学：设 P0 = 当前点、P1 = 控制点、P2 = 终点，u = 单位(P0−P1)、v = 单位(P2−P1)，
-     * 夹角 θ = ∠(u,v)，切点到 P1 的距离 t = r / tan(θ/2)，圆心在角平分线上距 P1 为 r / sin(θ/2)。
-     */
-    arcTo(x1: number, y1: number, x2: number, y2: number, radius: number): void;
-    rect(x: number, y: number, width: number, height: number): void;
-    /**
-     * 圆弧。**必须实现**：事件圆等形状用的是 `arc`，此前 PolyfillPath2D 没有它，
-     * 于是「无原生 Path2D」的运行时（Node / 小程序低版本）画这类形状会直接抛
-     * `path.arc is not a function` —— 这正是服务端出图要修的第一件事。
-     */
-    arc(x: number, y: number, radius: number, startAngle: number, endAngle: number, counterclockwise?: boolean): void;
-    ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number, startAngle: number, endAngle: number, counterclockwise: boolean): void;
-    closePath(): void;
-    /** 当前点（只读；调试与测试用） */
-    get currentPoint(): [number, number] | null;
-}