ice-entity-designer 0.0.39 → 0.1.0

package/dist/types/ice-render/animation/AnimationManager.d.ts

@@ -1,96 +0,0 @@
-import ICEComponent from '../graphic/ICEComponent';
-import ICE from '../ICE';
-/**
- * @class AnimationManager
- *
- * 动画管理器
- *
- * - 全局单例，一个 ICE 实例上只能有一个 AnimationManager 的实例。
- *
- * @singleton
- * @see ICE
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare class AnimationManager {
-    private animationMap;
-    private ice;
-    private paused;
-    private pausedAt;
-    private warned;
-    constructor(ice: ICE);
-    start(): this;
-    stop(): this;
-    private frameEventHandler;
-    /**
-     * 把值按点路径写入目标对象（支持 `transform.rotate` / `style.globalAlpha` 这类嵌套字段）。
-     *
-     * 旧实现直接 `newState[key] = value`，键里的点会被当成**字面量键名**，
-     * 于是 `animations: { 'transform.rotate': ... }` 静默失效（既不报错也不生效）。
-     * 多段路径共用同一父级时会逐段合并（`transform.rotate` 与 `transform.scale` 不互相覆盖）。
-     */
-    private __writeValue;
-    /**
-     * 每一帧推进动画：计算各属性的取值。
-     *
-     * 支持三种配置形态（同一组件上可混用）：
-     * 1. 单段补间：`{ from, to, duration }`
-     * 2. 关键帧时间轴：`{ keyframes: [{ offset, value, easing? }], duration }`
-     *    - `offset` 为 0~1 的时间占比，缺省时按数组顺序均分，超出 [0,1] 会被夹紧；
-     *    - `easing` 写在**段起始关键帧**上，作用于「该帧 → 下一帧」这一段；未写则用动画级 `easing`；
-     *    - 时间轴之外的取值分别是首帧 / 末帧的值（保持，不外推）。
-     * 3. 缓动可用主题 motion token 语义名（`duration: 'normal'` / `easing: 'out'`）或 EasingProgress 方法名。
-     *
-     * 取值可以是**数值**，也可以是**等长的数字数组**（`transform.scale` / `transform.translate` /
-     * `transform.skew` 等逐元素补间）。
-     *
-     * 结束判定按**已流逝时间**而非「值是否越过 to」：弹簧类缓动中途会过冲（越过 to 再回落），
-     * 若按值判定，第一帧过冲就会被误判成结束、动画提前停在过冲点上。
-     */
-    private tween;
-    /** 取进度 p 处的值：单段在 from→to 之间插值；关键帧按段插值（段内进度再经该段缓动）。 */
-    private __sampleValue;
-    /** 按进度 p 在 from/to 之间插值：数值直接线性，等长数字数组逐元素。 */
-    private __interpolate;
-    /** 补间取值是否合法：都是数字，或都是**等长**的数字数组。 */
-    private __isTweenable;
-    /** 取值种类：number | array（非空且全为数字） | null（不支持）。 */
-    private __valueKind;
-    /** 归一化关键帧到 animation.__frames（只做一次）：夹紧 offset、排序、校验各帧取值同型。 */
-    private __normalizeKeyframes;
-    /** 解析缓动名 → 归一化进度函数；未知名称回退 linear 并只提示一次。 */
-    private __easingFn;
-    /** round: true 时对补间结果取整（数组逐元素）。 */
-    private __roundIfNeeded;
-    /** 供告警信息使用的取值描述。 */
-    private __describe;
-    /** 拒绝一个非法的动画配置：标记结束（不再每帧重试）并只提示一次。 */
-    private __reject;
-    /** 同一个动画配置只告警一次，避免非法配置每帧刷屏。 */
-    private __warnOnce;
-    /**
-     * 把动画配置里的 motion token 语义名解析成实际值（首次触发时执行，结果写回 animation 对象缓存）：
-     * - duration: 'fast' | 'normal' | 'slow' | 'slower' → 主题 motion.duration 里的 ms。
-     * - easing: 'linear' | 'out' | 'inOut' | 'outQuart' | 'spring' | 'springSoft' | 'springSnappy'
-     *   → 主题 motion.easing 里的缓动方法名。
-     * 若传的是数字/已存在的 Easing 方法名，则原样保留（向后兼容）。
-     */
-    private __resolveMotion;
-    /**
-     * 判断动画到达终点后是否重复播放：
-     * - loop === true：无限循环；
-     * - iterationCount > 1：剩余次数递减，直到 1 次后结束。
-     */
-    private shouldRepeat;
-    /**
-     * 暂停所有动画（冻结进度，恢复时从暂停处继续）。
-     */
-    pause(): void;
-    /**
-     * 恢复所有动画：把每个动画的 startTime 往后移，抵消暂停期间的流逝。
-     */
-    resume(): void;
-    isPaused(): boolean;
-    add(component: ICEComponent): void;
-    remove(el: any): void;
-}
-export default AnimationManager;

package/dist/types/ice-render/animation/Easing.d.mts

@@ -1,33 +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.
- *
- */
-/**
- * 一组缓动工具函数
- *
- * 本文件有两层：
- *
- * ① `EasingProgress`：**归一化进度函数**，定义域 [0,1]（时间占比），值域通常为 [0,1]，
- *    弹簧这类缓动会短暂越过 1（过冲）。纯函数、不读时钟 —— 关键帧的**段内缓动**
- *    需要一个可按任意局部进度求值的函数，用它才能避免「合成 startTime」式的硬凑。
- *
- * ② `Easing`：对外保持历史上的**值**语义签名 `(from, to, duration, startTime)`，
- *    内部自读 `Date.now()`。其中 9 个函数是与既有实现逐字一致的转写（刻意不改），
- *    `tests/animation/easing-progress.test.ts` 在网格上锁定它们与 `EasingProgress`
- *    的等价关系（实测最大偏差 < 1e-12），防止两层实现漂移。
- *
- * 原始来源：https://github.com/AndrewRayCode/easing-utils/blob/master/src/easing.js
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-/** 归一化进度函数：t 为时间占比（0 → 起点，1 → 终点），返回进度（弹簧类可 > 1 表示过冲）。 */
-export type EasingProgress = (t: number) => number;
-export declare const EasingProgress: {
-    [name: string]: EasingProgress;
-};
-declare const Easing: {
-    [name: string]: (from: number, to: number, duration: number, startTime: number) => number;
-};
-export default Easing;

package/dist/types/ice-render/animation/Easing.d.ts

@@ -1,33 +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.
- *
- */
-/**
- * 一组缓动工具函数
- *
- * 本文件有两层：
- *
- * ① `EasingProgress`：**归一化进度函数**，定义域 [0,1]（时间占比），值域通常为 [0,1]，
- *    弹簧这类缓动会短暂越过 1（过冲）。纯函数、不读时钟 —— 关键帧的**段内缓动**
- *    需要一个可按任意局部进度求值的函数，用它才能避免「合成 startTime」式的硬凑。
- *
- * ② `Easing`：对外保持历史上的**值**语义签名 `(from, to, duration, startTime)`，
- *    内部自读 `Date.now()`。其中 9 个函数是与既有实现逐字一致的转写（刻意不改），
- *    `tests/animation/easing-progress.test.ts` 在网格上锁定它们与 `EasingProgress`
- *    的等价关系（实测最大偏差 < 1e-12），防止两层实现漂移。
- *
- * 原始来源：https://github.com/AndrewRayCode/easing-utils/blob/master/src/easing.js
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-/** 归一化进度函数：t 为时间占比（0 → 起点，1 → 终点），返回进度（弹簧类可 > 1 表示过冲）。 */
-export type EasingProgress = (t: number) => number;
-export declare const EasingProgress: {
-    [name: string]: EasingProgress;
-};
-declare const Easing: {
-    [name: string]: (from: number, to: number, duration: number, startTime: number) => number;
-};
-export default Easing;

package/dist/types/ice-render/consts/BIG_ZINDEX_NUMBER.d.mts

@@ -1,14 +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.
- *
- */
-/**
- * zIndex 最大值，这里使用一千万是安全的，在一张画布上渲染一千万个图形的可能性很小
- * zIndex 用来控制组件在画布中的堆叠次序
- * @see ICEComponent.state.zIndex
- */
-declare const bigZIndexNum: number;
-export default bigZIndexNum;

package/dist/types/ice-render/consts/BIG_ZINDEX_NUMBER.d.ts

@@ -1,14 +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.
- *
- */
-/**
- * zIndex 最大值，这里使用一千万是安全的，在一张画布上渲染一千万个图形的可能性很小
- * zIndex 用来控制组件在画布中的堆叠次序
- * @see ICEComponent.state.zIndex
- */
-declare const bigZIndexNum: number;
-export default bigZIndexNum;

package/dist/types/ice-render/consts/COMPONENT_TYPE_MAPPING.d.mts

@@ -1,45 +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.mjs';
-import ICEImage from '../graphic/ICEImage.mjs';
-import ICEBezier from '../graphic/link/ICEBezier.mjs';
-import ICEPolyLine from '../graphic/link/ICEPolyLine.mjs';
-import ICEVisioLink from '../graphic/link/ICEVisioLink.mjs';
-import ICECircle from '../graphic/shape/ICECircle.mjs';
-import ICEEllipse from '../graphic/shape/ICEEllipse.mjs';
-import ICEIsogon from '../graphic/shape/ICEIsogon.mjs';
-import ICERect from '../graphic/shape/ICERect.mjs';
-import ICERose from '../graphic/shape/ICERose.mjs';
-import ICEStar from '../graphic/shape/ICEStar.mjs';
-import ICEText from '../graphic/text/ICEText.mjs';
-/**
- * 组件名称和构造函数引用之间的映射关系，把序列化之后的 JSON 字符串重新解析成图形时需要用到此映射关系。
- *
- * key 是**稳定的类型名（typeId）**，与类的 JS 名解耦：序列化时由构造函数反查这张表得到 typeId，
- * 因此压缩/改名（terser mangle）不会破坏已存数据；只有**未注册**的类型才回退到 `constructor.name`。
- * 表里的 key 同时充当反序列化的查找键，所以旧数据里写类名的历史格式仍然能加载。
- *
- * 注意：工具层组件（ICELinkSlot / ICELinkHook / 各类 ControlPanel）不进这张表，它们不被序列化。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare const componentTypeMap: {
-    ICERect: typeof ICERect;
-    ICECircle: typeof ICECircle;
-    ICEEllipse: typeof ICEEllipse;
-    ICEStar: typeof ICEStar;
-    ICEIsogon: typeof ICEIsogon;
-    ICERose: typeof ICERose;
-    ICEText: typeof ICEText;
-    ICEImage: typeof ICEImage;
-    ICEGroup: typeof ICEGroup;
-    ICEVisioLink: typeof ICEVisioLink;
-    ICEPolyLine: typeof ICEPolyLine;
-    ICEBezier: typeof ICEBezier;
-};
-export default componentTypeMap;

package/dist/types/ice-render/consts/COMPONENT_TYPE_MAPPING.d.ts

@@ -1,45 +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 ICEImage from '../graphic/ICEImage';
-import ICEBezier from '../graphic/link/ICEBezier';
-import ICEPolyLine from '../graphic/link/ICEPolyLine';
-import ICEVisioLink from '../graphic/link/ICEVisioLink';
-import ICECircle from '../graphic/shape/ICECircle';
-import ICEEllipse from '../graphic/shape/ICEEllipse';
-import ICEIsogon from '../graphic/shape/ICEIsogon';
-import ICERect from '../graphic/shape/ICERect';
-import ICERose from '../graphic/shape/ICERose';
-import ICEStar from '../graphic/shape/ICEStar';
-import ICEText from '../graphic/text/ICEText';
-/**
- * 组件名称和构造函数引用之间的映射关系，把序列化之后的 JSON 字符串重新解析成图形时需要用到此映射关系。
- *
- * key 是**稳定的类型名（typeId）**，与类的 JS 名解耦：序列化时由构造函数反查这张表得到 typeId，
- * 因此压缩/改名（terser mangle）不会破坏已存数据；只有**未注册**的类型才回退到 `constructor.name`。
- * 表里的 key 同时充当反序列化的查找键，所以旧数据里写类名的历史格式仍然能加载。
- *
- * 注意：工具层组件（ICELinkSlot / ICELinkHook / 各类 ControlPanel）不进这张表，它们不被序列化。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare const componentTypeMap: {
-    ICERect: typeof ICERect;
-    ICECircle: typeof ICECircle;
-    ICEEllipse: typeof ICEEllipse;
-    ICEStar: typeof ICEStar;
-    ICEIsogon: typeof ICEIsogon;
-    ICERose: typeof ICERose;
-    ICEText: typeof ICEText;
-    ICEImage: typeof ICEImage;
-    ICEGroup: typeof ICEGroup;
-    ICEVisioLink: typeof ICEVisioLink;
-    ICEPolyLine: typeof ICEPolyLine;
-    ICEBezier: typeof ICEBezier;
-};
-export default componentTypeMap;

package/dist/types/ice-render/consts/DOM_EVENT_MAPPING_CONSTS.d.mts

@@ -1,37 +0,0 @@
-/**
- * 原生 DOM 事件与 ICE 内部转发事件之间的对应关系。
- * 原生 DOM 事件的名称在 ICE 中不变，ICE 自定义事件名仅仅用来在事件总线中进行转发。
- *
- * 输入通道策略（见 docs/architecture/05-event-system.md）：
- * - 运行时支持 PointerEvent → 只监听 pointer*（统一覆盖鼠标 / 触控笔 / 触摸），
- *   并额外监听没有 pointer 对应事件的 click / dblclick / contextmenu。
- * - 否则（老浏览器 / 小程序）→ 监听 mouse* + touch*，touch 通道由派发器
- *   归一化后以鼠标语义名转发，上层组件无需区分。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-/** 指针输入通道（鼠标 / 触控笔 / 触摸统一） */
-export declare const pointerEvents: Array<[string, string]>;
-/**
- * 鼠标输入通道。在支持 PointerEvent 的运行时只保留「没有 pointer 对应事件」的那几个，
- * 避免 pointer 与 mouse 兼容事件双重触发。
- */
-export declare const mouseEvents: Array<[string, string]>;
-/** PointerEvent 世界下仍需单独监听的鼠标事件（无 pointer 等价物）。 */
-export declare const nonPointerMouseEvents: Array<[string, string]>;
-/** 触摸输入通道（无 PointerEvent 的运行时使用，如小程序）。 */
-export declare const touchEvents: Array<[string, string]>;
-/** 滚轮通道（视口缩放等，由应用层消费）。 */
-export declare const wheelEvents: Array<[string, string]>;
-/**
- * 原生 DOM 键盘事件与 ICE 内部转发事件之间的对应关系。
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export declare const keyboardEvents: Array<[string, string]>;
-/** 高频「移动」类 ICE 事件名：派发器对其跳过命中检测（避免每次移动都全量扫描组件树）。 */
-export declare const MOVE_ICE_EVENTS: string[];
-/**
- * 按运行时能力构建待监听的 DOM 事件表。
- * @param hasPointerEvent 运行时是否存在 PointerEvent 构造器
- */
-export declare function buildDomEventList(hasPointerEvent: boolean): Array<[string, string]>;

package/dist/types/ice-render/consts/DOM_EVENT_MAPPING_CONSTS.d.ts

@@ -1,37 +0,0 @@
-/**
- * 原生 DOM 事件与 ICE 内部转发事件之间的对应关系。
- * 原生 DOM 事件的名称在 ICE 中不变，ICE 自定义事件名仅仅用来在事件总线中进行转发。
- *
- * 输入通道策略（见 docs/architecture/05-event-system.md）：
- * - 运行时支持 PointerEvent → 只监听 pointer*（统一覆盖鼠标 / 触控笔 / 触摸），
- *   并额外监听没有 pointer 对应事件的 click / dblclick / contextmenu。
- * - 否则（老浏览器 / 小程序）→ 监听 mouse* + touch*，touch 通道由派发器
- *   归一化后以鼠标语义名转发，上层组件无需区分。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-/** 指针输入通道（鼠标 / 触控笔 / 触摸统一） */
-export declare const pointerEvents: Array<[string, string]>;
-/**
- * 鼠标输入通道。在支持 PointerEvent 的运行时只保留「没有 pointer 对应事件」的那几个，
- * 避免 pointer 与 mouse 兼容事件双重触发。
- */
-export declare const mouseEvents: Array<[string, string]>;
-/** PointerEvent 世界下仍需单独监听的鼠标事件（无 pointer 等价物）。 */
-export declare const nonPointerMouseEvents: Array<[string, string]>;
-/** 触摸输入通道（无 PointerEvent 的运行时使用，如小程序）。 */
-export declare const touchEvents: Array<[string, string]>;
-/** 滚轮通道（视口缩放等，由应用层消费）。 */
-export declare const wheelEvents: Array<[string, string]>;
-/**
- * 原生 DOM 键盘事件与 ICE 内部转发事件之间的对应关系。
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export declare const keyboardEvents: Array<[string, string]>;
-/** 高频「移动」类 ICE 事件名：派发器对其跳过命中检测（避免每次移动都全量扫描组件树）。 */
-export declare const MOVE_ICE_EVENTS: string[];
-/**
- * 按运行时能力构建待监听的 DOM 事件表。
- * @param hasPointerEvent 运行时是否存在 PointerEvent 构造器
- */
-export declare function buildDomEventList(hasPointerEvent: boolean): Array<[string, string]>;

package/dist/types/ice-render/consts/ICE_EVENT_NAME_CONSTS.d.mts

@@ -1,27 +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.
- *
- */
-declare const ICE_EVENT_NAME_CONSTS: {
-    ICE_FRAME_EVENT: string;
-    BEFORE_RENDER: string;
-    AFTER_RENDER: string;
-    BEFORE_ADD: string;
-    AFTER_ADD: string;
-    BEFORE_REMOVE: string;
-    AFTER_REMOVE: string;
-    ROUND_FINISH: string;
-    HOOK_MOUSEDOWN: string;
-    HOOK_MOUSEMOVE: string;
-    HOOK_MOUSEUP: string;
-    BEFORE_RESIZE: string;
-    AFTER_RESIZE: string;
-    BEFORE_ROTATE: string;
-    AFTER_ROTATE: string;
-    BEFORE_MOVE: string;
-    AFTER_MOVE: string;
-};
-export default ICE_EVENT_NAME_CONSTS;

package/dist/types/ice-render/consts/ICE_EVENT_NAME_CONSTS.d.ts

@@ -1,27 +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.
- *
- */
-declare const ICE_EVENT_NAME_CONSTS: {
-    ICE_FRAME_EVENT: string;
-    BEFORE_RENDER: string;
-    AFTER_RENDER: string;
-    BEFORE_ADD: string;
-    AFTER_ADD: string;
-    BEFORE_REMOVE: string;
-    AFTER_REMOVE: string;
-    ROUND_FINISH: string;
-    HOOK_MOUSEDOWN: string;
-    HOOK_MOUSEMOVE: string;
-    HOOK_MOUSEUP: string;
-    BEFORE_RESIZE: string;
-    AFTER_RESIZE: string;
-    BEFORE_ROTATE: string;
-    AFTER_ROTATE: string;
-    BEFORE_MOVE: string;
-    AFTER_MOVE: string;
-};
-export default ICE_EVENT_NAME_CONSTS;

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

@@ -1,92 +0,0 @@
-/**
- * 对齐吸附管理器（smart guides + snapping）。
- *
- * 拖拽组件时，把「被拖组件的关键坐标」与「其他组件的关键坐标」做最近匹配，
- * 命中阈值内自动吸附，并在工具层显示提示线。默认禁用，应用层显式 enable 后才生效。
- *
- * 性能设计（保证拖拽顺滑）：
- *   1. mousedown 时缓存所有目标组件的世界盒，拖拽过程复用（目标组件不移动，不重复 compose）；
- *   2. 提示线是两根复用的隐藏 ICERect，只改坐标 + display，不 addTool/removeTool，不重建渲染队列；
- *   3. 滞回（hysteresis）：已吸附的轴用更大的脱离阈值，避免阈值边界来回抖。
- */
-import ICE from '../ICE.mjs';
-export interface SnapBox {
-    minX: number;
-    minY: number;
-    maxX: number;
-    maxY: number;
-    centerX: number;
-    centerY: number;
-}
-export interface SnapResult {
-    axis: 'x' | 'y';
-    type: 'edge' | 'center' | 'spacing';
-    /** 对齐目标坐标 - 源坐标，吸附时应加到 left/top。 */
-    delta: number;
-    /** 对齐线的世界坐标（X 对齐是 x 值，Y 对齐是 y 值）。 */
-    guideValue: number;
-    /** 提示线在另一轴上的起点/终点（世界坐标）。 */
-    guideStart: number;
-    guideEnd: number;
-}
-export interface SnapAxes {
-    x: SnapResult | null;
-    y: SnapResult | null;
-}
-export interface AlignmentGuideOptions {
-    /** 磁吸阈值（屏幕像素），默认 5。 */
-    threshold?: number;
-    /** 滞回余量（屏幕像素）：已吸附轴脱离阈值 = threshold + hysteresis，默认 2。 */
-    hysteresis?: number;
-    /** 边缘对齐，默认 true。 */
-    edge?: boolean;
-    /** 中心对齐，默认 true。 */
-    center?: boolean;
-    /** 等间距对齐，默认 true。 */
-    spacing?: boolean;
-    /** 提示线完整样式（透传给 canvas ctx），默认 { fillStyle: '#EC4899' }。 */
-    guideStyle?: Record<string, any>;
-    /** 提示线 zIndex，默认在控制面板之上。 */
-    guideZIndex?: number;
-    /** 提示线宽（屏幕像素，按视口换算），默认 1。 */
-    guideWidth?: number;
-}
-/**
- * 纯几何吸附计算：X/Y 两轴各自返回 |delta| 最小的命中候选。
- * thresholdX / thresholdY 分别是两轴的世界坐标阈值（调用方按视口与滞回换算）。
- */
-export declare function computeSnap(source: SnapBox, targets: SnapBox[], thresholdX: number, thresholdY: number, options: Required<AlignmentGuideOptions>): SnapAxes;
-declare class AlignmentGuideManager {
-    private ice;
-    private options;
-    private enabled;
-    private active;
-    private snapping;
-    private intentLeft;
-    private intentTop;
-    private cachedTargets;
-    private engagedX;
-    private engagedY;
-    private guideX;
-    private guideY;
-    constructor(ice: ICE);
-    enable(options?: AlignmentGuideOptions): this;
-    disable(): this;
-    isEnabled(): boolean;
-    setOptions(options: AlignmentGuideOptions): this;
-    private __onMouseDown;
-    private __onDrag;
-    private __onMouseUp;
-    private __detach;
-    private __boxOf;
-    private __computeTargets;
-    /**
-     * 判断组件是否可以参与对齐决策。
-     * 排除：连接线、控制面板、变换手柄、不可交互组件、不可拖动组件。
-     */
-    private __isAlignmentParticipant;
-    private __ensureGuides;
-    private __updateGuides;
-    private __hideGuides;
-}
-export default AlignmentGuideManager;

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

@@ -1,92 +0,0 @@
-/**
- * 对齐吸附管理器（smart guides + snapping）。
- *
- * 拖拽组件时，把「被拖组件的关键坐标」与「其他组件的关键坐标」做最近匹配，
- * 命中阈值内自动吸附，并在工具层显示提示线。默认禁用，应用层显式 enable 后才生效。
- *
- * 性能设计（保证拖拽顺滑）：
- *   1. mousedown 时缓存所有目标组件的世界盒，拖拽过程复用（目标组件不移动，不重复 compose）；
- *   2. 提示线是两根复用的隐藏 ICERect，只改坐标 + display，不 addTool/removeTool，不重建渲染队列；
- *   3. 滞回（hysteresis）：已吸附的轴用更大的脱离阈值，避免阈值边界来回抖。
- */
-import ICE from '../ICE';
-export interface SnapBox {
-    minX: number;
-    minY: number;
-    maxX: number;
-    maxY: number;
-    centerX: number;
-    centerY: number;
-}
-export interface SnapResult {
-    axis: 'x' | 'y';
-    type: 'edge' | 'center' | 'spacing';
-    /** 对齐目标坐标 - 源坐标，吸附时应加到 left/top。 */
-    delta: number;
-    /** 对齐线的世界坐标（X 对齐是 x 值，Y 对齐是 y 值）。 */
-    guideValue: number;
-    /** 提示线在另一轴上的起点/终点（世界坐标）。 */
-    guideStart: number;
-    guideEnd: number;
-}
-export interface SnapAxes {
-    x: SnapResult | null;
-    y: SnapResult | null;
-}
-export interface AlignmentGuideOptions {
-    /** 磁吸阈值（屏幕像素），默认 5。 */
-    threshold?: number;
-    /** 滞回余量（屏幕像素）：已吸附轴脱离阈值 = threshold + hysteresis，默认 2。 */
-    hysteresis?: number;
-    /** 边缘对齐，默认 true。 */
-    edge?: boolean;
-    /** 中心对齐，默认 true。 */
-    center?: boolean;
-    /** 等间距对齐，默认 true。 */
-    spacing?: boolean;
-    /** 提示线完整样式（透传给 canvas ctx），默认 { fillStyle: '#EC4899' }。 */
-    guideStyle?: Record<string, any>;
-    /** 提示线 zIndex，默认在控制面板之上。 */
-    guideZIndex?: number;
-    /** 提示线宽（屏幕像素，按视口换算），默认 1。 */
-    guideWidth?: number;
-}
-/**
- * 纯几何吸附计算：X/Y 两轴各自返回 |delta| 最小的命中候选。
- * thresholdX / thresholdY 分别是两轴的世界坐标阈值（调用方按视口与滞回换算）。
- */
-export declare function computeSnap(source: SnapBox, targets: SnapBox[], thresholdX: number, thresholdY: number, options: Required<AlignmentGuideOptions>): SnapAxes;
-declare class AlignmentGuideManager {
-    private ice;
-    private options;
-    private enabled;
-    private active;
-    private snapping;
-    private intentLeft;
-    private intentTop;
-    private cachedTargets;
-    private engagedX;
-    private engagedY;
-    private guideX;
-    private guideY;
-    constructor(ice: ICE);
-    enable(options?: AlignmentGuideOptions): this;
-    disable(): this;
-    isEnabled(): boolean;
-    setOptions(options: AlignmentGuideOptions): this;
-    private __onMouseDown;
-    private __onDrag;
-    private __onMouseUp;
-    private __detach;
-    private __boxOf;
-    private __computeTargets;
-    /**
-     * 判断组件是否可以参与对齐决策。
-     * 排除：连接线、控制面板、变换手柄、不可交互组件、不可拖动组件。
-     */
-    private __isAlignmentParticipant;
-    private __ensureGuides;
-    private __updateGuides;
-    private __hideGuides;
-}
-export default AlignmentGuideManager;

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

@@ -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.mjs';
-import ICEComponent from '../graphic/ICEComponent.mjs';
-/**
- * @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;
-}