ice-entity-designer 0.0.23 → 0.0.25

package/dist/types/flow/FlowDesigner.d.mts

@@ -81,16 +81,19 @@ export default class FlowDesigner {
      * 回调参数是当前流程的快照（与 serialize() 一致）。
      */
     subscribe(listener: (snapshot: string, designer: FlowDesigner) => void): () => void;
-    private __emitChange;
+    protected __emitChange(): void;
     /** 订阅节点的拖拽事件：拖动是画布侧的行为，designer 需要感知才能广播与记历史 */
-    private __attachNodeListeners;
+    protected __attachNodeListeners(node: any): void;
     private __detachNodeListeners;
     private __onBeforeMove;
     private __onAfterMove;
     private __endMoveSession;
     select(id: string | null): this;
     /** 没有给坐标时，按已有节点包围盒的下方网格错开摆放，避免新建节点互相压住 */
-    private __defaultPlacement;
+    protected __defaultPlacement(width: number, height: number): {
+        left: number;
+        top: number;
+    };
     createNode(kind: FlowNodeKind, props?: any): any;
     /** 由节点的插槽位置算出连线端点（引擎按插槽吸附，端点需要给出初始坐标） */
     private __slotPoint;
@@ -142,7 +145,7 @@ export default class FlowDesigner {
     captureHistory(): void;
     /** 清空撤销/重做栈（用于「载入示例」这类不该占用历史的初始化操作） */
     resetHistory(): void;
-    private __captureHistory;
+    protected __captureHistory(): void;
     private __applySnapshot;
     /**
      * 撤销：先记账（把当前状态压入 redo、从 undo 弹出目标），再回放目标快照，

package/dist/types/flow/FlowDesigner.d.ts

@@ -81,16 +81,19 @@ export default class FlowDesigner {
      * 回调参数是当前流程的快照（与 serialize() 一致）。
      */
     subscribe(listener: (snapshot: string, designer: FlowDesigner) => void): () => void;
-    private __emitChange;
+    protected __emitChange(): void;
     /** 订阅节点的拖拽事件：拖动是画布侧的行为，designer 需要感知才能广播与记历史 */
-    private __attachNodeListeners;
+    protected __attachNodeListeners(node: any): void;
     private __detachNodeListeners;
     private __onBeforeMove;
     private __onAfterMove;
     private __endMoveSession;
     select(id: string | null): this;
     /** 没有给坐标时，按已有节点包围盒的下方网格错开摆放，避免新建节点互相压住 */
-    private __defaultPlacement;
+    protected __defaultPlacement(width: number, height: number): {
+        left: number;
+        top: number;
+    };
     createNode(kind: FlowNodeKind, props?: any): any;
     /** 由节点的插槽位置算出连线端点（引擎按插槽吸附，端点需要给出初始坐标） */
     private __slotPoint;
@@ -142,7 +145,7 @@ export default class FlowDesigner {
     captureHistory(): void;
     /** 清空撤销/重做栈（用于「载入示例」这类不该占用历史的初始化操作） */
     resetHistory(): void;
-    private __captureHistory;
+    protected __captureHistory(): void;
     private __applySnapshot;
     /**
      * 撤销：先记账（把当前状态压入 redo、从 undo 弹出目标），再回放目标快照，

package/dist/types/ice-render/ICE.d.mts

@@ -57,6 +57,8 @@ declare class ICE {
      * backing store 尺寸也会被边框撑大。这里在刷新 rect 时一并读取 computedStyle 补偿。
      */
     private __contentBox;
+    /** 上次用于「位移增量」的矩形快照（不持有 DOMRect 引用，见 __rememberInputRect）。 */
+    private __inputRectSnapshot;
     selectionList: Array<any>;
     /** 插件宿主：组件 / 渲染 / 交互工具三层注册点，见 `src/plugin/PluginHost.ts`。 */
     plugins: PluginHost;
@@ -265,6 +267,23 @@ declare class ICE {
      */
     private __applyDevicePixelRatio;
     updateCanvasBoundingRect(): any;
+    /** 记下上次用于「位移增量」的矩形快照。
+     *
+     * 不能直接复用 `canvasBoundingClientRect` 做差：某些运行时（桩 / 小程序）返回的是
+     * **同一个可变对象**，此时 `rect === prev`，增量恒为 0，内容盒就再也不会跟着走。
+     */
+    private __rememberInputRect;
+    /**
+     * 输入路径的**轻量**刷新：只重读一次 `getBoundingClientRect()`，尺寸没变时把已缓存的
+     * 内容盒按位移平移，跳过一次 `getComputedStyle`（border/padding 不会每帧变）。
+     *
+     * 为什么移动事件必须每帧重读：页面滚动、画布上方插入内容（提示条 / 错误信息 / 广告位）
+     * 都会让缓存整体过期，过期期间 `clientX - rect.left` 恒定偏移 —— 命中检测、悬停、
+     * 拖拽全部错位，而移动事件恰恰是唯一高频入口，不刷新就没人来纠正它。
+     *
+     * 尺寸变化（窗口缩放、布局改动导致画布变大变小）时退回完整刷新，保证 border/padding 补偿正确。
+     */
+    refreshInputRect(): any;
     /**
      * 读取 canvas 内容盒：把 border-box 的 rect 补偿成「绘制区」的偏移与尺寸。
      * 无 getComputedStyle 的运行时（如小程序）补偿为 0，退回 rect 原值。

package/dist/types/ice-render/ICE.d.ts

@@ -57,6 +57,8 @@ declare class ICE {
      * backing store 尺寸也会被边框撑大。这里在刷新 rect 时一并读取 computedStyle 补偿。
      */
     private __contentBox;
+    /** 上次用于「位移增量」的矩形快照（不持有 DOMRect 引用，见 __rememberInputRect）。 */
+    private __inputRectSnapshot;
     selectionList: Array<any>;
     /** 插件宿主：组件 / 渲染 / 交互工具三层注册点，见 `src/plugin/PluginHost.ts`。 */
     plugins: PluginHost;
@@ -265,6 +267,23 @@ declare class ICE {
      */
     private __applyDevicePixelRatio;
     updateCanvasBoundingRect(): any;
+    /** 记下上次用于「位移增量」的矩形快照。
+     *
+     * 不能直接复用 `canvasBoundingClientRect` 做差：某些运行时（桩 / 小程序）返回的是
+     * **同一个可变对象**，此时 `rect === prev`，增量恒为 0，内容盒就再也不会跟着走。
+     */
+    private __rememberInputRect;
+    /**
+     * 输入路径的**轻量**刷新：只重读一次 `getBoundingClientRect()`，尺寸没变时把已缓存的
+     * 内容盒按位移平移，跳过一次 `getComputedStyle`（border/padding 不会每帧变）。
+     *
+     * 为什么移动事件必须每帧重读：页面滚动、画布上方插入内容（提示条 / 错误信息 / 广告位）
+     * 都会让缓存整体过期，过期期间 `clientX - rect.left` 恒定偏移 —— 命中检测、悬停、
+     * 拖拽全部错位，而移动事件恰恰是唯一高频入口，不刷新就没人来纠正它。
+     *
+     * 尺寸变化（窗口缩放、布局改动导致画布变大变小）时退回完整刷新，保证 border/padding 补偿正确。
+     */
+    refreshInputRect(): any;
     /**
      * 读取 canvas 内容盒：把 border-box 的 rect 补偿成「绘制区」的偏移与尺寸。
      * 无 getComputedStyle 的运行时（如小程序）补偿为 0，退回 rect 原值。

package/dist/types/ice-render/event/DOMEventDispatcher.d.mts

@@ -47,8 +47,15 @@ declare class DOMEventDispatcher {
     private __dispatch;
     /**
      * 取 canvas 矩形用于坐标换算。
-     * 移动类事件频率高（每帧可能多次），复用缓存；其余事件刷新一次，
-     * 保证页面滚动 / 布局变化后命中检测不错位。
+     *
+     * **移动类事件也必须刷新**（走 `refreshInputRect` 轻量路径：只重读一次
+     * `getBoundingClientRect`，尺寸没变就平移已缓存的内容盒、不读 computedStyle），
+     * 其余事件走完整 `updateCanvasBoundingRect`。
+     *
+     * 为什么不做「一帧一次」的节流：布局变化（页面滚动、画布上方插入内容）可能就发生在
+     * 两次事件之间，节流会让第二次事件继续用过期矩形 —— 命中检测整体偏移、悬停直接落空。
+     * 实测一次 `getBoundingClientRect()` 在布局干净时约 0.22µs、强制重排的最坏情况约 2.8µs，
+     * 相对每帧渲染可忽略（见 AGENTS「性能相关铁律」）。
      */
     private __resolveCanvasRect;
     set stopped(flag: boolean);

package/dist/types/ice-render/event/DOMEventDispatcher.d.ts

@@ -47,8 +47,15 @@ declare class DOMEventDispatcher {
     private __dispatch;
     /**
      * 取 canvas 矩形用于坐标换算。
-     * 移动类事件频率高（每帧可能多次），复用缓存；其余事件刷新一次，
-     * 保证页面滚动 / 布局变化后命中检测不错位。
+     *
+     * **移动类事件也必须刷新**（走 `refreshInputRect` 轻量路径：只重读一次
+     * `getBoundingClientRect`，尺寸没变就平移已缓存的内容盒、不读 computedStyle），
+     * 其余事件走完整 `updateCanvasBoundingRect`。
+     *
+     * 为什么不做「一帧一次」的节流：布局变化（页面滚动、画布上方插入内容）可能就发生在
+     * 两次事件之间，节流会让第二次事件继续用过期矩形 —— 命中检测整体偏移、悬停直接落空。
+     * 实测一次 `getBoundingClientRect()` 在布局干净时约 0.22µs、强制重排的最坏情况约 2.8µs，
+     * 相对每帧渲染可忽略（见 AGENTS「性能相关铁律」）。
      */
     private __resolveCanvasRect;
     set stopped(flag: boolean);

package/dist/types/ice-render/graphic/link/ICEPolyLine.d.mts

@@ -232,6 +232,13 @@ declare class ICEPolyLine extends ICEDotPath {
      * 先绘制折线，再绘制连线标签（若 label 非空）。
      */
     protected doRender(): void;
+    /**
+     * 用「线色」把端点箭头三角形填实（`arrowStyle: 'filled'`，默认）。
+     *
+     * 面顶点由 `getArrowFaces()` 提供 —— 与 SVG 导出共用同一份口径（导出器也读它），
+     * 避免「画布填了、导出没填」（实心箭头在导出里变空心）。
+     */
+    getArrowFaces(): number[][][];
     /**
      * 用「线色」把端点箭头三角形填实（`arrowStyle: 'filled'`，默认）。
      *

package/dist/types/ice-render/graphic/link/ICEPolyLine.d.ts

@@ -232,6 +232,13 @@ declare class ICEPolyLine extends ICEDotPath {
      * 先绘制折线，再绘制连线标签（若 label 非空）。
      */
     protected doRender(): void;
+    /**
+     * 用「线色」把端点箭头三角形填实（`arrowStyle: 'filled'`，默认）。
+     *
+     * 面顶点由 `getArrowFaces()` 提供 —— 与 SVG 导出共用同一份口径（导出器也读它），
+     * 避免「画布填了、导出没填」（实心箭头在导出里变空心）。
+     */
+    getArrowFaces(): number[][][];
     /**
      * 用「线色」把端点箭头三角形填实（`arrowStyle: 'filled'`，默认）。
      *

package/dist/types/index.d.mts

@@ -25,6 +25,19 @@ export { validateBpmn } from './bpmn/bpmn_validate.mjs';
 export type { BpmnIssue } from './bpmn/bpmn_validate.mjs';
 export { toBpmnXml, fromBpmnXml } from './bpmn/bpmn_xml.mjs';
 export type { BpmnImportResult } from './bpmn/bpmn_xml.mjs';
+export { default as UmlClass } from './uml/UmlClass.mjs';
+export type { UmlClassKind } from './uml/UmlClass.mjs';
+export { default as UmlRelation, UML_RELATION_KINDS, UML_RELATION_STYLE } from './uml/UmlRelation.mjs';
+export type { UmlRelationKind, UmlMarker } from './uml/UmlRelation.mjs';
+export { default as UmlDesigner } from './uml/UmlDesigner.mjs';
+export type { UmlIssue } from './uml/UmlDesigner.mjs';
+export { default as StateNode, STATECHART_NODE_KINDS } from './statechart/StateNode.mjs';
+export type { StatechartNodeKind } from './statechart/StateNode.mjs';
+export { default as StateTransition } from './statechart/StateTransition.mjs';
+export { default as StatechartDesigner } from './statechart/StatechartDesigner.mjs';
+export type { StatechartIssue } from './statechart/StatechartDesigner.mjs';
+export { toPlantUml, fromPlantUml, arrowOf, detectUmlDialect } from './uml/uml_text.mjs';
+export type { UmlTextImportResult } from './uml/uml_text.mjs';
 /**
  * 引擎内核（ice-render）在构建时已被打包进本包，这里一并导出。
  *

package/dist/types/index.d.ts

@@ -25,6 +25,19 @@ export { validateBpmn } from './bpmn/bpmn_validate';
 export type { BpmnIssue } from './bpmn/bpmn_validate';
 export { toBpmnXml, fromBpmnXml } from './bpmn/bpmn_xml';
 export type { BpmnImportResult } from './bpmn/bpmn_xml';
+export { default as UmlClass } from './uml/UmlClass';
+export type { UmlClassKind } from './uml/UmlClass';
+export { default as UmlRelation, UML_RELATION_KINDS, UML_RELATION_STYLE } from './uml/UmlRelation';
+export type { UmlRelationKind, UmlMarker } from './uml/UmlRelation';
+export { default as UmlDesigner } from './uml/UmlDesigner';
+export type { UmlIssue } from './uml/UmlDesigner';
+export { default as StateNode, STATECHART_NODE_KINDS } from './statechart/StateNode';
+export type { StatechartNodeKind } from './statechart/StateNode';
+export { default as StateTransition } from './statechart/StateTransition';
+export { default as StatechartDesigner } from './statechart/StatechartDesigner';
+export type { StatechartIssue } from './statechart/StatechartDesigner';
+export { toPlantUml, fromPlantUml, arrowOf, detectUmlDialect } from './uml/uml_text';
+export type { UmlTextImportResult } from './uml/uml_text';
 /**
  * 引擎内核（ice-render）在构建时已被打包进本包，这里一并导出。
  *

package/dist/types/statechart/StateNode.d.mts

@@ -0,0 +1,43 @@
+/**
+ * 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, ICEText } from '../ice-render/index.mjs';
+export declare const STATECHART_NODE_KINDS: readonly ["initial", "final", "state", "composite"];
+export declare type StatechartNodeKind = (typeof STATECHART_NODE_KINDS)[number];
+/**
+ * @class StateNode 状态机的节点（伪状态 / 状态 / 复合状态）
+ *
+ * 复合组件（`hasDerivedChildren() === true`）：内部形状与名字由 state 派生、不进文档。
+ * 四种记法：
+ * - `initial` 初始伪状态：实心圆
+ * - `final`   终止伪状态：同心圆（外圈 + 实心内圈）
+ * - `state`   普通状态：圆角矩形 + 居中名字
+ * - `composite` 复合状态：**容器** —— 名字靠左上，框里留给子状态；拖动它子状态一起走（引擎容器能力）
+ */
+export default class StateNode extends ICEGroup {
+    static readonly typeId = "StateNode";
+    protected shapeComponent: any;
+    protected innerRingComponent: any;
+    protected labelComponent: ICEText | null;
+    hasDerivedChildren(): boolean;
+    constructor(props?: any);
+    protected static arrangeParam(props?: any): any;
+    /** 只有这些键变化才需要重建内部形状（拖动位置、选中态都不该重建） */
+    private static readonly __shapeKeys;
+    setState(patch: any): void;
+    applyPatch(patch?: any): void;
+    /** 伪状态（初始/终止）不显示名字 */
+    isPseudoState(): boolean;
+    /**
+     * 按 kind 重建内部形状与名字。
+     *
+     * zIndex 必须显式给：引擎在**构造时**分配自增 zIndex，后构造的会盖住先构造的
+     * （UML 那边就踩过「底色带盖住类名」），这里统一「形状在下、文字在上」。
+     */
+    protected syncShape(): void;
+    private __clearDerivedChildren;
+}

package/dist/types/statechart/StateNode.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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, ICEText } from '../ice-render/index';
+export declare const STATECHART_NODE_KINDS: readonly ["initial", "final", "state", "composite"];
+export declare type StatechartNodeKind = (typeof STATECHART_NODE_KINDS)[number];
+/**
+ * @class StateNode 状态机的节点（伪状态 / 状态 / 复合状态）
+ *
+ * 复合组件（`hasDerivedChildren() === true`）：内部形状与名字由 state 派生、不进文档。
+ * 四种记法：
+ * - `initial` 初始伪状态：实心圆
+ * - `final`   终止伪状态：同心圆（外圈 + 实心内圈）
+ * - `state`   普通状态：圆角矩形 + 居中名字
+ * - `composite` 复合状态：**容器** —— 名字靠左上，框里留给子状态；拖动它子状态一起走（引擎容器能力）
+ */
+export default class StateNode extends ICEGroup {
+    static readonly typeId = "StateNode";
+    protected shapeComponent: any;
+    protected innerRingComponent: any;
+    protected labelComponent: ICEText | null;
+    hasDerivedChildren(): boolean;
+    constructor(props?: any);
+    protected static arrangeParam(props?: any): any;
+    /** 只有这些键变化才需要重建内部形状（拖动位置、选中态都不该重建） */
+    private static readonly __shapeKeys;
+    setState(patch: any): void;
+    applyPatch(patch?: any): void;
+    /** 伪状态（初始/终止）不显示名字 */
+    isPseudoState(): boolean;
+    /**
+     * 按 kind 重建内部形状与名字。
+     *
+     * zIndex 必须显式给：引擎在**构造时**分配自增 zIndex，后构造的会盖住先构造的
+     * （UML 那边就踩过「底色带盖住类名」），这里统一「形状在下、文字在上」。
+     */
+    protected syncShape(): void;
+    private __clearDerivedChildren;
+}

package/dist/types/statechart/StateTransition.d.mts

@@ -0,0 +1,32 @@
+/**
+ * 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 { ICEPolyLine } from '../ice-render/index.mjs';
+/**
+ * @class StateTransition 状态机的一次转移
+ *
+ * 记法：实线 + **实心箭头**，标签是 `事件 [守卫] / 动作`（UML 状态机与 PlantUML 状态图的通行写法）。
+ * 复用引擎折线（插槽吸附 / 正交·贝塞尔路由 / 跟随宿主 / 矢量导出），只把标签的三个部分拼好。
+ *
+ * 之所以单独一个类而不是直接用 ICEPolyLine：给一个**稳定 typeId**，
+ * 判型与序列化都靠它（应用层不要用 constructor.name，打包会 mangle）。
+ */
+export default class StateTransition extends ICEPolyLine {
+    static readonly typeId = "StateTransition";
+    constructor(props?: any);
+    protected static arrangeParam(props?: any): any;
+    /**
+     * 标签拼装：`事件 [守卫] / 动作` —— 缺哪个省哪个（不会出现空括号或光秃秃的斜杠）。
+     */
+    static composeLabel(parts: {
+        event?: string;
+        guard?: string;
+        action?: string;
+    }): string;
+    setState(patch: any): void;
+    applyPatch(patch?: any): void;
+}

package/dist/types/statechart/StateTransition.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 { ICEPolyLine } from '../ice-render/index';
+/**
+ * @class StateTransition 状态机的一次转移
+ *
+ * 记法：实线 + **实心箭头**，标签是 `事件 [守卫] / 动作`（UML 状态机与 PlantUML 状态图的通行写法）。
+ * 复用引擎折线（插槽吸附 / 正交·贝塞尔路由 / 跟随宿主 / 矢量导出），只把标签的三个部分拼好。
+ *
+ * 之所以单独一个类而不是直接用 ICEPolyLine：给一个**稳定 typeId**，
+ * 判型与序列化都靠它（应用层不要用 constructor.name，打包会 mangle）。
+ */
+export default class StateTransition extends ICEPolyLine {
+    static readonly typeId = "StateTransition";
+    constructor(props?: any);
+    protected static arrangeParam(props?: any): any;
+    /**
+     * 标签拼装：`事件 [守卫] / 动作` —— 缺哪个省哪个（不会出现空括号或光秃秃的斜杠）。
+     */
+    static composeLabel(parts: {
+        event?: string;
+        guard?: string;
+        action?: string;
+    }): string;
+    setState(patch: any): void;
+    applyPatch(patch?: any): void;
+}

package/dist/types/statechart/StatechartDesigner.d.mts

@@ -0,0 +1,46 @@
+/**
+ * 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 FlowDesigner from '../flow/FlowDesigner.mjs';
+export declare type StatechartIssue = {
+    level: 'error' | 'warning';
+    message: string;
+    id?: string;
+};
+/**
+ * @class StatechartDesigner 状态机设计器（第二个 domain pack）
+ *
+ * 与 `UmlDesigner` 同构：`FlowDesigner` 的薄扩展，只做四件事 ——
+ * 建状态机图元、类型过滤、**几何自动嵌套**（复合状态是容器）、语义校验。
+ * 选择 / 增删改 / 连线 / 撤销重做 / 快照 / 适应视图 / 矢量导出全部继承。
+ */
+export default class StatechartDesigner extends FlowDesigner {
+    private __nesting;
+    constructor(ice: any);
+    get nodes(): any[];
+    get edges(): any[];
+    /** 建状态（initial / final / state / composite），复合状态会自动把落在框内的状态收进容器 */
+    createState(props?: any): any;
+    /** 建一次转移；两端必须都是状态（否则抛错，与 FlowDesigner.createEdge 同一契约） */
+    createTransition(props?: any): any;
+    /**
+     * 几何自动嵌套：新状态的中心落在某个**复合状态**的框内就嵌进去（引擎容器能力）。
+     *
+     * 与 BPMN 的池/泳道同一套做法：`adoptChild`（**不能**用 removeChild —— 它会 destory 组件），
+     * 再把坐标换算成「以父容器左上角为原点」。
+     */
+    private __nestByGeometry;
+    /**
+     * 状态机语义校验：
+     * - 每个状态机要有**初始状态**（否则没有入口）；
+     * - **终止状态不应有出边**（它表示流程结束）；
+     * - **可达性**：从初始状态出发沿转移走不到的普通状态要提醒（画了但永远到不了）；
+     * - 未连接的状态（既没有入边也没有出边）单独提示，和「不可达」区分开。
+     */
+    validateStatechart(): StatechartIssue[];
+    private __portPoint;
+}

package/dist/types/statechart/StatechartDesigner.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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 FlowDesigner from '../flow/FlowDesigner';
+export declare type StatechartIssue = {
+    level: 'error' | 'warning';
+    message: string;
+    id?: string;
+};
+/**
+ * @class StatechartDesigner 状态机设计器（第二个 domain pack）
+ *
+ * 与 `UmlDesigner` 同构：`FlowDesigner` 的薄扩展，只做四件事 ——
+ * 建状态机图元、类型过滤、**几何自动嵌套**（复合状态是容器）、语义校验。
+ * 选择 / 增删改 / 连线 / 撤销重做 / 快照 / 适应视图 / 矢量导出全部继承。
+ */
+export default class StatechartDesigner extends FlowDesigner {
+    private __nesting;
+    constructor(ice: any);
+    get nodes(): any[];
+    get edges(): any[];
+    /** 建状态（initial / final / state / composite），复合状态会自动把落在框内的状态收进容器 */
+    createState(props?: any): any;
+    /** 建一次转移；两端必须都是状态（否则抛错，与 FlowDesigner.createEdge 同一契约） */
+    createTransition(props?: any): any;
+    /**
+     * 几何自动嵌套：新状态的中心落在某个**复合状态**的框内就嵌进去（引擎容器能力）。
+     *
+     * 与 BPMN 的池/泳道同一套做法：`adoptChild`（**不能**用 removeChild —— 它会 destory 组件），
+     * 再把坐标换算成「以父容器左上角为原点」。
+     */
+    private __nestByGeometry;
+    /**
+     * 状态机语义校验：
+     * - 每个状态机要有**初始状态**（否则没有入口）；
+     * - **终止状态不应有出边**（它表示流程结束）；
+     * - **可达性**：从初始状态出发沿转移走不到的普通状态要提醒（画了但永远到不了）；
+     * - 未连接的状态（既没有入边也没有出边）单独提示，和「不可达」区分开。
+     */
+    validateStatechart(): StatechartIssue[];
+    private __portPoint;
+}

package/dist/types/uml/UmlClass.d.mts

@@ -0,0 +1,46 @@
+/**
+ * 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, ICEPolyLine, ICERect, ICEText } from '../ice-render/index.mjs';
+export declare type UmlClassKind = 'class' | 'interface' | 'enum';
+/**
+ * @class UmlClass UML 类图的类框（三段式：类名 / 属性 / 方法）
+ *
+ * 与 ER 的 `Entity` 同一套做法：**复合组件** —— 类名、属性、方法、分隔线都是按 state
+ * 派生的内部子组件（`hasDerivedChildren() === true`），不写进文档、载入时重建。
+ *
+ * 与 Entity 的三点差异（这也是它值得单独做域包的原因）：
+ * - 三段式：类名带（含构造型）+ 属性区 + 方法区，分隔线两条；
+ * - 成员是**自由文本**（`- id: string`、`+ pay(): void`），可见性/静态/泛型都由文本表达 ——
+ *   这是 UML 工具与文本格式（PlantUML/Mermaid）通行的做法，也让 AI 生成不必学一套结构化语法；
+ * - **高度随成员自动增长**，不允许成员画出框外。
+ */
+export default class UmlClass extends ICEGroup {
+    /** 稳定类型标识（判型/序列化都用它，不要用 constructor.name：打包会被 mangle） */
+    static readonly typeId = "UmlClass";
+    protected stereotypeComponent: ICEText | null;
+    protected nameComponent: ICEText | null;
+    protected headerBackgroundComponent: ICERect | null;
+    protected memberComponents: ICEText[];
+    protected dividerComponents: ICEPolyLine[];
+    /** 内部子组件由 state 派生 → 不参与序列化 */
+    hasDerivedChildren(): boolean;
+    constructor(props?: any);
+    protected static arrangeParam(props: any): any;
+    /** 只需要重建内部排版的 state 键（拖动位置不该触发重建） */
+    private static readonly __layoutKeys;
+    setState(patch: any): void;
+    /** 应用层（属性面板 / DSL）改成员走这里，语义与 FlowNode.applyPatch 一致 */
+    applyPatch(patch?: any): void;
+    /**
+     * 按 state 重建三段式排版，并把**内容高度**写回自身（成员不会被画出框外）。
+     *
+     * 高度用 `this.state.height = h` 直接写：`setState()` 会再次触发重建，形成循环。
+     */
+    protected syncCompartments(): void;
+    private __clearDerivedChildren;
+}

package/dist/types/uml/UmlClass.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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, ICEPolyLine, ICERect, ICEText } from '../ice-render/index';
+export declare type UmlClassKind = 'class' | 'interface' | 'enum';
+/**
+ * @class UmlClass UML 类图的类框（三段式：类名 / 属性 / 方法）
+ *
+ * 与 ER 的 `Entity` 同一套做法：**复合组件** —— 类名、属性、方法、分隔线都是按 state
+ * 派生的内部子组件（`hasDerivedChildren() === true`），不写进文档、载入时重建。
+ *
+ * 与 Entity 的三点差异（这也是它值得单独做域包的原因）：
+ * - 三段式：类名带（含构造型）+ 属性区 + 方法区，分隔线两条；
+ * - 成员是**自由文本**（`- id: string`、`+ pay(): void`），可见性/静态/泛型都由文本表达 ——
+ *   这是 UML 工具与文本格式（PlantUML/Mermaid）通行的做法，也让 AI 生成不必学一套结构化语法；
+ * - **高度随成员自动增长**，不允许成员画出框外。
+ */
+export default class UmlClass extends ICEGroup {
+    /** 稳定类型标识（判型/序列化都用它，不要用 constructor.name：打包会被 mangle） */
+    static readonly typeId = "UmlClass";
+    protected stereotypeComponent: ICEText | null;
+    protected nameComponent: ICEText | null;
+    protected headerBackgroundComponent: ICERect | null;
+    protected memberComponents: ICEText[];
+    protected dividerComponents: ICEPolyLine[];
+    /** 内部子组件由 state 派生 → 不参与序列化 */
+    hasDerivedChildren(): boolean;
+    constructor(props?: any);
+    protected static arrangeParam(props: any): any;
+    /** 只需要重建内部排版的 state 键（拖动位置不该触发重建） */
+    private static readonly __layoutKeys;
+    setState(patch: any): void;
+    /** 应用层（属性面板 / DSL）改成员走这里，语义与 FlowNode.applyPatch 一致 */
+    applyPatch(patch?: any): void;
+    /**
+     * 按 state 重建三段式排版，并把**内容高度**写回自身（成员不会被画出框外）。
+     *
+     * 高度用 `this.state.height = h` 直接写：`setState()` 会再次触发重建，形成循环。
+     */
+    protected syncCompartments(): void;
+    private __clearDerivedChildren;
+}

package/dist/types/uml/UmlDesigner.d.mts

@@ -0,0 +1,53 @@
+/**
+ * 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 FlowDesigner from '../flow/FlowDesigner.mjs';
+import type { UmlRelationKind } from './UmlRelation.mjs';
+export declare type UmlIssue = {
+    level: 'error' | 'warning';
+    message: string;
+    id?: string;
+};
+/**
+ * @class UmlDesigner UML 类图设计器（域包 = 形状 + 应用层 + 校验 + 互操作 + 文档）
+ *
+ * 它是 `FlowDesigner` 的**薄扩展**，只做四件事，其余（选择、增删改、连线、撤销重做、
+ * 快照存取、适应视图、订阅）全部继承：
+ *
+ * 1. 建 UML 图元（`UmlClass` / `UmlRelation`）而不是流程图的 FlowNode/FlowEdge；
+ * 2. 节点/连线的**类型过滤**换成 UML 类型；
+ * 3. UML **语义校验**（重名类、悬空关系、继承环）。
+ *
+ * 之所以能这么薄：类框是复合组件（内部三段由 state 派生），关系是折线（标记进路径点集），
+ * 快照直接复用引擎序列化（typeId 注册表 + hasDerivedChildren）。
+ */
+export default class UmlDesigner extends FlowDesigner {
+    constructor(ice: any);
+    /** 只认 UML 类框（继承来的 FlowNode 过滤换掉） */
+    get nodes(): any[];
+    /** 只认 UML 关系线 */
+    get edges(): any[];
+    /** 建一个类/接口/枚举（`createNode` 的 UML 语义版本） */
+    createClass(props?: any): any;
+    /** 建一条 UML 关系（继承 / 实现 / 关联 / 聚合 / 组合 / 依赖） */
+    createRelation(props?: any): any;
+    /** 改关系种类：记法（线型 + 端点标记 + 填充）随之一并更新 */
+    setRelationKind(id: string, relationKind: UmlRelationKind): any;
+    /** 关系种类清单（属性面板/DSL 共用同一份词汇表） */
+    get relationKinds(): string[];
+    /**
+     * UML 语义校验（结构之外的部分）：
+     * - 类名重复（同一张图里两个类无法区分）；
+     * - 关系两端必须都还在（删除类时引擎会级联删关系，这里是防御性的）；
+     * - 继承/实现的**成环**（A 继承 B、B 又继承 A —— 类型系统不成立）。
+     */
+    validateUml(): UmlIssue[];
+    /** 关系记法的可读描述（属性面板/文档共用，避免三处各写一份文案） */
+    static describeRelationKind(kind: UmlRelationKind): string;
+    /** 端口点：与 FlowDesigner 的插槽语义一致（T/R/B/L/C），这里按 UML 常用左右出发 */
+    private __portPoint;
+}