ice-entity-designer 0.0.24 → 0.0.26

package/dist/types/gantt/GanttDependency.d.mts

@@ -0,0 +1,18 @@
+/**
+ * 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 GanttDependency 甘特任务之间的依赖（完成 → 开始）
+ *
+ * 记法：实线 + 实心箭头，从「前置任务的右端」指向「后置任务的左端」，走正交路由（`visio`）。
+ * 依赖只表达约束，不改变条的位置（自动排程是后续能力，不属于本包 v1）。
+ */
+export default class GanttDependency extends ICEPolyLine {
+    static readonly typeId = "GanttDependency";
+    constructor(props?: any);
+}

package/dist/types/gantt/GanttDependency.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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 GanttDependency 甘特任务之间的依赖（完成 → 开始）
+ *
+ * 记法：实线 + 实心箭头，从「前置任务的右端」指向「后置任务的左端」，走正交路由（`visio`）。
+ * 依赖只表达约束，不改变条的位置（自动排程是后续能力，不属于本包 v1）。
+ */
+export default class GanttDependency extends ICEPolyLine {
+    static readonly typeId = "GanttDependency";
+    constructor(props?: any);
+}

package/dist/types/gantt/GanttDesigner.d.mts

@@ -0,0 +1,80 @@
+/**
+ * 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 GanttRuler from './GanttRuler.mjs';
+export declare type GanttIssue = {
+    level: 'error' | 'warning';
+    message: string;
+    id?: string;
+};
+export declare type GanttTaskInput = {
+    title?: string;
+    /** `YYYY-MM-DD` */
+    start: string;
+    days?: number;
+    row?: number;
+    progress?: number;
+};
+/**
+ * @class GanttDesigner 甘特图设计器（第三个 domain pack）
+ *
+ * 与前两个包同一套结构（`FlowDesigner` 薄扩展 + 类型过滤 + 语义校验 + 复用快照/导出），
+ * 额外引入两件甘特特有的东西：
+ *
+ * 1. **时间轴**：日期 ↔ 像素的统一换算（`dayWidth` / `originDate` / `labelColumnWidth`），
+ *    框架（左列任务名 + 日期刻度 + 行线）由一个派生的 `GanttRuler` 组件渲染并在模型变化时重建；
+ * 2. **吸附**：任务条的拖拽按「整天」吸附（见 `GanttTask.setPosition`），排期不会出现小数天。
+ */
+export default class GanttDesigner extends FlowDesigner {
+    /** 左列（任务名）宽度 */
+    labelColumnWidth: number;
+    /** 时间轴顶部标尺高度 */
+    headerHeight: number;
+    /** 行高 */
+    rowHeight: number;
+    /** 每天像素 */
+    dayWidth: number;
+    /** 项目起点（自动取最早任务开始日） */
+    originDate: string;
+    ruler: GanttRuler;
+    private __syncing;
+    constructor(ice: any);
+    get nodes(): any[];
+    get edges(): any[];
+    /**
+     * 建一条任务（条）：坐标由「起始日期 × 每日像素」算出，不接受任意 left/top
+     * —— 甘特的横轴是时间，不是自由画布。
+     */
+    createTask(props: GanttTaskInput & {
+        id?: string;
+    }): any;
+    /** 建一条依赖（完成 → 开始），两端必须都是任务 */
+    createDependency(props?: any): any;
+    /** 改每日像素（时间轴缩放）：所有任务与依赖一起重排 */
+    setDayWidth(dayWidth: number): void;
+    /** 项目起点 = 最早任务的开始日；没有任务时留空 */
+    computeOrigin(): string;
+    /** 项目区间（天数）：至少 1 天，用于刻度与画布宽度 */
+    dayCount(): number;
+    /**
+     * 重建图表框架（左列任务名 + 日期刻度 + 行线）并同步所有任务的几何。
+     *
+     * 模型任何变化（增删任务、改日期、改每日像素）都要走这里 —— 时间轴是**派生**的，
+     * 不允许任务自己维护「我在哪一天的哪一像素上」。
+     */
+    syncChrome(): void;
+    /**
+     * 甘特语义校验：
+     * - **依赖成环**（排期不成立）；
+     * - 进度越界（0..1）；
+     * - 持续天数非法（<1）；
+     * - 任务早于项目起点（起点是自动取最早的，因此这条主要防手工改坐标）。
+     */
+    validateGantt(): GanttIssue[];
+    private __anchor;
+}

package/dist/types/gantt/GanttDesigner.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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';
+import GanttRuler from './GanttRuler';
+export declare type GanttIssue = {
+    level: 'error' | 'warning';
+    message: string;
+    id?: string;
+};
+export declare type GanttTaskInput = {
+    title?: string;
+    /** `YYYY-MM-DD` */
+    start: string;
+    days?: number;
+    row?: number;
+    progress?: number;
+};
+/**
+ * @class GanttDesigner 甘特图设计器（第三个 domain pack）
+ *
+ * 与前两个包同一套结构（`FlowDesigner` 薄扩展 + 类型过滤 + 语义校验 + 复用快照/导出），
+ * 额外引入两件甘特特有的东西：
+ *
+ * 1. **时间轴**：日期 ↔ 像素的统一换算（`dayWidth` / `originDate` / `labelColumnWidth`），
+ *    框架（左列任务名 + 日期刻度 + 行线）由一个派生的 `GanttRuler` 组件渲染并在模型变化时重建；
+ * 2. **吸附**：任务条的拖拽按「整天」吸附（见 `GanttTask.setPosition`），排期不会出现小数天。
+ */
+export default class GanttDesigner extends FlowDesigner {
+    /** 左列（任务名）宽度 */
+    labelColumnWidth: number;
+    /** 时间轴顶部标尺高度 */
+    headerHeight: number;
+    /** 行高 */
+    rowHeight: number;
+    /** 每天像素 */
+    dayWidth: number;
+    /** 项目起点（自动取最早任务开始日） */
+    originDate: string;
+    ruler: GanttRuler;
+    private __syncing;
+    constructor(ice: any);
+    get nodes(): any[];
+    get edges(): any[];
+    /**
+     * 建一条任务（条）：坐标由「起始日期 × 每日像素」算出，不接受任意 left/top
+     * —— 甘特的横轴是时间，不是自由画布。
+     */
+    createTask(props: GanttTaskInput & {
+        id?: string;
+    }): any;
+    /** 建一条依赖（完成 → 开始），两端必须都是任务 */
+    createDependency(props?: any): any;
+    /** 改每日像素（时间轴缩放）：所有任务与依赖一起重排 */
+    setDayWidth(dayWidth: number): void;
+    /** 项目起点 = 最早任务的开始日；没有任务时留空 */
+    computeOrigin(): string;
+    /** 项目区间（天数）：至少 1 天，用于刻度与画布宽度 */
+    dayCount(): number;
+    /**
+     * 重建图表框架（左列任务名 + 日期刻度 + 行线）并同步所有任务的几何。
+     *
+     * 模型任何变化（增删任务、改日期、改每日像素）都要走这里 —— 时间轴是**派生**的，
+     * 不允许任务自己维护「我在哪一天的哪一像素上」。
+     */
+    syncChrome(): void;
+    /**
+     * 甘特语义校验：
+     * - **依赖成环**（排期不成立）；
+     * - 进度越界（0..1）；
+     * - 持续天数非法（<1）；
+     * - 任务早于项目起点（起点是自动取最早的，因此这条主要防手工改坐标）。
+     */
+    validateGantt(): GanttIssue[];
+    private __anchor;
+}

package/dist/types/gantt/GanttRuler.d.mts

@@ -0,0 +1,42 @@
+/**
+ * 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 '../ice-render/index.mjs';
+export declare type GanttRulerOptions = {
+    dayWidth: number;
+    labelColumnWidth: number;
+    headerHeight: number;
+    rowHeight: number;
+    originDate: string;
+    dayCount: number;
+    tasks: Array<{
+        title: string;
+        row: number;
+    }>;
+    totalWidth: number;
+    totalHeight: number;
+};
+/**
+ * @class GanttRuler 甘特的「图表框架」：左列任务名 + 日期刻度 + 行分隔线
+ *
+ * 它是**派生装饰**（由设计器按任务模型重建），不是业务图元 —— 因此：
+ * - 不进 `designer.nodes`（类型过滤按 typeId 认 GanttTask）；
+ * - 但仍然进文档与导出（它是画布内容的一部分，和任务条一起被截图/导出 SVG）。
+ *
+ * 时间轴刻度是「一次性画完」的：40 天以内每天一个刻度，超过就按周一/每月聚合，
+ * 避免长排期把画布画满文字（这也是甘特工具通行做法）。
+ */
+export default class GanttRuler extends ICEGroup {
+    static readonly typeId = "GanttRuler";
+    constructor();
+    hasDerivedChildren(): boolean;
+    /** 按当前任务模型重建框架 */
+    sync(options: GanttRulerOptions): void;
+    /** 只给日期字符串加天数（保持与 gantt_date 同一套 UTC 口径） */
+    private __addDays;
+    private __text;
+}

package/dist/types/gantt/GanttRuler.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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 '../ice-render/index';
+export declare type GanttRulerOptions = {
+    dayWidth: number;
+    labelColumnWidth: number;
+    headerHeight: number;
+    rowHeight: number;
+    originDate: string;
+    dayCount: number;
+    tasks: Array<{
+        title: string;
+        row: number;
+    }>;
+    totalWidth: number;
+    totalHeight: number;
+};
+/**
+ * @class GanttRuler 甘特的「图表框架」：左列任务名 + 日期刻度 + 行分隔线
+ *
+ * 它是**派生装饰**（由设计器按任务模型重建），不是业务图元 —— 因此：
+ * - 不进 `designer.nodes`（类型过滤按 typeId 认 GanttTask）；
+ * - 但仍然进文档与导出（它是画布内容的一部分，和任务条一起被截图/导出 SVG）。
+ *
+ * 时间轴刻度是「一次性画完」的：40 天以内每天一个刻度，超过就按周一/每月聚合，
+ * 避免长排期把画布画满文字（这也是甘特工具通行做法）。
+ */
+export default class GanttRuler extends ICEGroup {
+    static readonly typeId = "GanttRuler";
+    constructor();
+    hasDerivedChildren(): boolean;
+    /** 按当前任务模型重建框架 */
+    sync(options: GanttRulerOptions): void;
+    /** 只给日期字符串加天数（保持与 gantt_date 同一套 UTC 口径） */
+    private __addDays;
+    private __text;
+}

package/dist/types/gantt/GanttTask.d.mts

@@ -0,0 +1,41 @@
+/**
+ * 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, ICERect, ICEText } from '../ice-render/index.mjs';
+/**
+ * @class GanttTask 甘特图的一条任务（= 时间轴上的那个条）
+ *
+ * 复合组件（`hasDerivedChildren`）：条、进度覆盖、文字都由 state 派生。
+ *
+ * **拖拽吸附**是排期语义的核心：`setPosition()` 会把 x 吸附到「整天」的格子上，
+ * 并据此反推起始日期 —— 拖动不会产生「3 月 5 日的 13:47 开工」这种排期。
+ */
+export default class GanttTask extends ICEGroup {
+    static readonly typeId = "GanttTask";
+    protected barComponent: ICERect | null;
+    protected progressComponent: ICERect | null;
+    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;
+    /**
+     * @overwrite
+     * 拖拽吸附：x 吸附到整天网格并反推起始日期（y 吸附到行网格）。
+     */
+    setPosition(left: number, top: number, evt?: any): void;
+    /** 时间轴上的左边缘（= state.left，设计器负责由日期算出它） */
+    barLeft(): number;
+    /** 进度覆盖条宽度 */
+    progressWidth(): number;
+    /** 由 start/days 反推几何（日期改了、或设计器换了 dayWidth/origin 时调用） */
+    syncGeometry(): void;
+    protected syncBar(): void;
+    private __clearDerivedChildren;
+}

package/dist/types/gantt/GanttTask.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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, ICERect, ICEText } from '../ice-render/index';
+/**
+ * @class GanttTask 甘特图的一条任务（= 时间轴上的那个条）
+ *
+ * 复合组件（`hasDerivedChildren`）：条、进度覆盖、文字都由 state 派生。
+ *
+ * **拖拽吸附**是排期语义的核心：`setPosition()` 会把 x 吸附到「整天」的格子上，
+ * 并据此反推起始日期 —— 拖动不会产生「3 月 5 日的 13:47 开工」这种排期。
+ */
+export default class GanttTask extends ICEGroup {
+    static readonly typeId = "GanttTask";
+    protected barComponent: ICERect | null;
+    protected progressComponent: ICERect | null;
+    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;
+    /**
+     * @overwrite
+     * 拖拽吸附：x 吸附到整天网格并反推起始日期（y 吸附到行网格）。
+     */
+    setPosition(left: number, top: number, evt?: any): void;
+    /** 时间轴上的左边缘（= state.left，设计器负责由日期算出它） */
+    barLeft(): number;
+    /** 进度覆盖条宽度 */
+    progressWidth(): number;
+    /** 由 start/days 反推几何（日期改了、或设计器换了 dayWidth/origin 时调用） */
+    syncGeometry(): void;
+    protected syncBar(): void;
+    private __clearDerivedChildren;
+}

package/dist/types/gantt/gantt_date.d.mts

@@ -0,0 +1,12 @@
+/** `YYYY-MM-DD` → UTC 时间戳（非法输入返回 NaN） */
+export declare function parseDate(iso: string): number;
+/** UTC 时间戳 → `YYYY-MM-DD` */
+export declare function formatDate(timestamp: number): string;
+/** 加天数 */
+export declare function addDays(iso: string, days: number): string;
+/** 相差天数（to - from） */
+export declare function diffDays(from: string, to: string): number;
+/** 两个日期之间（含）的每一天，用于渲染刻度 */
+export declare function eachDay(from: string, to: string, limit?: number): string[];
+/** 刻度文案：`03-02`（月-日）；月初额外给出月份，便于阅读 */
+export declare function tickLabel(iso: string): string;

package/dist/types/gantt/gantt_date.d.ts

@@ -0,0 +1,12 @@
+/** `YYYY-MM-DD` → UTC 时间戳（非法输入返回 NaN） */
+export declare function parseDate(iso: string): number;
+/** UTC 时间戳 → `YYYY-MM-DD` */
+export declare function formatDate(timestamp: number): string;
+/** 加天数 */
+export declare function addDays(iso: string, days: number): string;
+/** 相差天数（to - from） */
+export declare function diffDays(from: string, to: string): number;
+/** 两个日期之间（含）的每一天，用于渲染刻度 */
+export declare function eachDay(from: string, to: string, limit?: number): string[];
+/** 刻度文案：`03-02`（月-日）；月初额外给出月份，便于阅读 */
+export declare function tickLabel(iso: string): string;

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

@@ -31,6 +31,18 @@ export { default as UmlRelation, UML_RELATION_KINDS, UML_RELATION_STYLE } from '
 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 { default as GanttTask } from './gantt/GanttTask.mjs';
+export { default as GanttDependency } from './gantt/GanttDependency.mjs';
+export { default as GanttRuler } from './gantt/GanttRuler.mjs';
+export type { GanttRulerOptions } from './gantt/GanttRuler.mjs';
+export { default as GanttDesigner } from './gantt/GanttDesigner.mjs';
+export type { GanttIssue, GanttTaskInput } from './gantt/GanttDesigner.mjs';
+export { parseDate, formatDate, addDays, diffDays, eachDay, tickLabel } from './gantt/gantt_date.mjs';
 export { toPlantUml, fromPlantUml, arrowOf, detectUmlDialect } from './uml/uml_text.mjs';
 export type { UmlTextImportResult } from './uml/uml_text.mjs';
 /**

package/dist/types/index.d.ts

@@ -31,6 +31,18 @@ export { default as UmlRelation, UML_RELATION_KINDS, UML_RELATION_STYLE } from '
 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 { default as GanttTask } from './gantt/GanttTask';
+export { default as GanttDependency } from './gantt/GanttDependency';
+export { default as GanttRuler } from './gantt/GanttRuler';
+export type { GanttRulerOptions } from './gantt/GanttRuler';
+export { default as GanttDesigner } from './gantt/GanttDesigner';
+export type { GanttIssue, GanttTaskInput } from './gantt/GanttDesigner';
+export { parseDate, formatDate, addDays, diffDays, eachDay, tickLabel } from './gantt/gantt_date';
 export { toPlantUml, fromPlantUml, arrowOf, detectUmlDialect } from './uml/uml_text';
 export type { UmlTextImportResult } from './uml/uml_text';
 /**

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;
+}