ice-entity-designer 0.0.21 → 0.0.23

package/dist/types/bpmn/BpmnDesigner.d.mts

@@ -0,0 +1,50 @@
+/**
+ * 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 { BpmnIssue } from './bpmn_validate.mjs';
+/**
+ * BPMN 设计器：`FlowDesigner` 的薄扩展，只补两件 BPMN 特有的事：
+ *
+ * 1. **顺序流上的条件/默认标记**（BPMN 记法要求）：标记是「派生装饰」，
+ *    放在 `ice.toolNodes`（工具层）里 —— 工具层不参与引擎序列化（我们上轮验证过），
+ *    所以文档仍然是纯粹的业务模型，标记由 `flowType/condition/isDefault` 推出来。
+ * 2. **BPMN 语义校验**：`validate()` 直接复用 `validateBpmn()`。
+ *
+ * 其余能力（建节点/连线、选择、增删改、撤销重做、快照存取、适应视图、订阅）
+ * 全部继承自 `FlowDesigner` —— 沿用同一套机制，不再造第二份。
+ */
+export default class BpmnDesigner extends FlowDesigner {
+    private __markers;
+    private __markerSyncing;
+    private __nesting;
+    constructor(ice: any);
+    /** BPMN 语义校验（事件/网关/池/连通性等，见 bpmn_validate.ts） */
+    validateBpmn(): BpmnIssue[];
+    /**
+     * 建节点：除常规流程元素外，**自动按几何把节点嵌进池/泳道**（用引擎的容器能力）。
+     *
+     * 为什么要真嵌套：外层容器（池）被拖动时，引擎的矩阵组合会让内部泳道与泳道里的节点
+     * 一起移动 —— 这正是「拖动池子，里面的东西跟着走」的正确实现；扁平结构做不到。
+     *
+     * 归属规则：取「面积最小的、包住节点中心的容器」（泳道比池小 → 优先落在泳道里）。
+     * 子组件坐标是**父容器左上角**为原点，因此嵌套时要做一次坐标换算。
+     */
+    createNode(kind: any, props?: any): any;
+    /** 把（已经在 ice 根上的）节点嵌进最内层容器 */
+    private __nestByGeometry;
+    /**
+     * 容器的**内容区**（扣掉名称带）。
+     *
+     * 池的名称带在顶部、泳道在左侧，名称带属于标题区、不该被内部元素压住；
+     * 所以归属判定按内容区算，否则泳道会盖住池标题。
+     */
+    private __contentBox;
+    /** 顺序流的条件/默认标记：按需创建、原位更新（放在工具层，不污染文档） */
+    syncFlowMarkers(): void;
+    dispose(): void;
+}

package/dist/types/bpmn/BpmnDesigner.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 type { BpmnIssue } from './bpmn_validate';
+/**
+ * BPMN 设计器：`FlowDesigner` 的薄扩展，只补两件 BPMN 特有的事：
+ *
+ * 1. **顺序流上的条件/默认标记**（BPMN 记法要求）：标记是「派生装饰」，
+ *    放在 `ice.toolNodes`（工具层）里 —— 工具层不参与引擎序列化（我们上轮验证过），
+ *    所以文档仍然是纯粹的业务模型，标记由 `flowType/condition/isDefault` 推出来。
+ * 2. **BPMN 语义校验**：`validate()` 直接复用 `validateBpmn()`。
+ *
+ * 其余能力（建节点/连线、选择、增删改、撤销重做、快照存取、适应视图、订阅）
+ * 全部继承自 `FlowDesigner` —— 沿用同一套机制，不再造第二份。
+ */
+export default class BpmnDesigner extends FlowDesigner {
+    private __markers;
+    private __markerSyncing;
+    private __nesting;
+    constructor(ice: any);
+    /** BPMN 语义校验（事件/网关/池/连通性等，见 bpmn_validate.ts） */
+    validateBpmn(): BpmnIssue[];
+    /**
+     * 建节点：除常规流程元素外，**自动按几何把节点嵌进池/泳道**（用引擎的容器能力）。
+     *
+     * 为什么要真嵌套：外层容器（池）被拖动时，引擎的矩阵组合会让内部泳道与泳道里的节点
+     * 一起移动 —— 这正是「拖动池子，里面的东西跟着走」的正确实现；扁平结构做不到。
+     *
+     * 归属规则：取「面积最小的、包住节点中心的容器」（泳道比池小 → 优先落在泳道里）。
+     * 子组件坐标是**父容器左上角**为原点，因此嵌套时要做一次坐标换算。
+     */
+    createNode(kind: any, props?: any): any;
+    /** 把（已经在 ice 根上的）节点嵌进最内层容器 */
+    private __nestByGeometry;
+    /**
+     * 容器的**内容区**（扣掉名称带）。
+     *
+     * 池的名称带在顶部、泳道在左侧，名称带属于标题区、不该被内部元素压住；
+     * 所以归属判定按内容区算，否则泳道会盖住池标题。
+     */
+    private __contentBox;
+    /** 顺序流的条件/默认标记：按需创建、原位更新（放在工具层，不污染文档） */
+    syncFlowMarkers(): void;
+    dispose(): void;
+}

package/dist/types/bpmn/bpmn_shapes.d.mts

@@ -0,0 +1,61 @@
+/**
+ * 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 { ICEPath } from '../ice-render/index.mjs';
+/**
+ * 事件（圆）：开始 / 中间 / 结束 + 触发类型图标。
+ *
+ * state.eventKind: 'start' | 'intermediate' | 'end'
+ * state.trigger:   'none' | 'message' | 'timer' | 'error' | 'terminate'
+ */
+export declare class BpmnEventShape extends ICEPath {
+    static readonly typeId = "BpmnEventShape";
+    protected createPathObject(): any;
+}
+/** 网关（菱形 + 内部符号）：排他 × / 并行 + / 包容 ○ / 事件网关（五边形） */
+export declare class BpmnGatewayShape extends ICEPath {
+    static readonly typeId = "BpmnGatewayShape";
+    protected createPathObject(): any;
+}
+/** 任务类型角标（左上角小图标，尺寸固定 12×12，由节点定位） */
+export declare class BpmnTaskIcon extends ICEPath {
+    static readonly typeId = "BpmnTaskIcon";
+    protected createPathObject(): any;
+}
+/** 子流程折叠标记（底部居中的「+」小方块） */
+export declare class BpmnSubprocessMarker extends ICEPath {
+    static readonly typeId = "BpmnSubprocessMarker";
+    protected createPathObject(): any;
+}
+/** 数据对象：右上角折角矩形 */
+export declare class BpmnDataObjectShape extends ICEPath {
+    static readonly typeId = "BpmnDataObjectShape";
+    protected createPathObject(): any;
+}
+/**
+ * 文本注释：**完整矩形** + 左侧内嵌的括号竖线（bpmn.io / Camunda 的标准画法）。
+ *
+ * 曾经画成「左括号 + 上下两条线、右侧开口」—— 那样右侧没有边框，看起来像个残缺的框；
+ * BPMN 2.0 的文本注释是闭合矩形，左侧竖线只是括号装饰，四条边都要有。
+ */
+export declare class BpmnAnnotationShape extends ICEPath {
+    static readonly typeId = "BpmnAnnotationShape";
+    protected createPathObject(): any;
+}
+/**
+ * 泳道 / 池：矩形 + 名称带分隔线。
+ * `band` = 'left'（横向泳道，默认）| 'top'（池标题带）
+ */
+export declare class BpmnLaneShape extends ICEPath {
+    static readonly typeId = "BpmnLaneShape";
+    protected createPathObject(): any;
+}
+/** 顺序流上的条件/默认标记（小菱形 / 斜杠），尺寸固定 14×14 */
+export declare class BpmnFlowMarker extends ICEPath {
+    static readonly typeId = "BpmnFlowMarker";
+    protected createPathObject(): any;
+}

package/dist/types/bpmn/bpmn_shapes.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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 { ICEPath } from '../ice-render/index';
+/**
+ * 事件（圆）：开始 / 中间 / 结束 + 触发类型图标。
+ *
+ * state.eventKind: 'start' | 'intermediate' | 'end'
+ * state.trigger:   'none' | 'message' | 'timer' | 'error' | 'terminate'
+ */
+export declare class BpmnEventShape extends ICEPath {
+    static readonly typeId = "BpmnEventShape";
+    protected createPathObject(): any;
+}
+/** 网关（菱形 + 内部符号）：排他 × / 并行 + / 包容 ○ / 事件网关（五边形） */
+export declare class BpmnGatewayShape extends ICEPath {
+    static readonly typeId = "BpmnGatewayShape";
+    protected createPathObject(): any;
+}
+/** 任务类型角标（左上角小图标，尺寸固定 12×12，由节点定位） */
+export declare class BpmnTaskIcon extends ICEPath {
+    static readonly typeId = "BpmnTaskIcon";
+    protected createPathObject(): any;
+}
+/** 子流程折叠标记（底部居中的「+」小方块） */
+export declare class BpmnSubprocessMarker extends ICEPath {
+    static readonly typeId = "BpmnSubprocessMarker";
+    protected createPathObject(): any;
+}
+/** 数据对象：右上角折角矩形 */
+export declare class BpmnDataObjectShape extends ICEPath {
+    static readonly typeId = "BpmnDataObjectShape";
+    protected createPathObject(): any;
+}
+/**
+ * 文本注释：**完整矩形** + 左侧内嵌的括号竖线（bpmn.io / Camunda 的标准画法）。
+ *
+ * 曾经画成「左括号 + 上下两条线、右侧开口」—— 那样右侧没有边框，看起来像个残缺的框；
+ * BPMN 2.0 的文本注释是闭合矩形，左侧竖线只是括号装饰，四条边都要有。
+ */
+export declare class BpmnAnnotationShape extends ICEPath {
+    static readonly typeId = "BpmnAnnotationShape";
+    protected createPathObject(): any;
+}
+/**
+ * 泳道 / 池：矩形 + 名称带分隔线。
+ * `band` = 'left'（横向泳道，默认）| 'top'（池标题带）
+ */
+export declare class BpmnLaneShape extends ICEPath {
+    static readonly typeId = "BpmnLaneShape";
+    protected createPathObject(): any;
+}
+/** 顺序流上的条件/默认标记（小菱形 / 斜杠），尺寸固定 14×14 */
+export declare class BpmnFlowMarker extends ICEPath {
+    static readonly typeId = "BpmnFlowMarker";
+    protected createPathObject(): any;
+}

package/dist/types/bpmn/bpmn_validate.d.mts

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * BPMN 2.0 语义校验（记法之外的那一层）。
+ *
+ * 只做「结构正确性」检查，不涉及具体引擎的扩展属性；返回问题列表供属性面板/工具条展示。
+ * 与 ER 侧的 `validateSchema()` 同一形态（`{ level, code, message, componentId }`）。
+ *
+ * 约定：**容器归属按几何判定**——节点落在哪个池/泳道矩形内就属于它。
+ * （真实 BPMN 里泳道是 `<laneSet>` 的显式归属；我们不做重父级，导出 XML 时按几何归类，
+ * 这样拖拽体验与文档模型都简单，且不会出现「跨容器拖动导致连线错乱」。）
+ */
+export declare type BpmnIssue = {
+    level: 'error' | 'warning';
+    code: string;
+    message: string;
+    componentId?: string;
+};
+export declare function validateBpmn(designer: any): BpmnIssue[];

package/dist/types/bpmn/bpmn_validate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * BPMN 2.0 语义校验（记法之外的那一层）。
+ *
+ * 只做「结构正确性」检查，不涉及具体引擎的扩展属性；返回问题列表供属性面板/工具条展示。
+ * 与 ER 侧的 `validateSchema()` 同一形态（`{ level, code, message, componentId }`）。
+ *
+ * 约定：**容器归属按几何判定**——节点落在哪个池/泳道矩形内就属于它。
+ * （真实 BPMN 里泳道是 `<laneSet>` 的显式归属；我们不做重父级，导出 XML 时按几何归类，
+ * 这样拖拽体验与文档模型都简单，且不会出现「跨容器拖动导致连线错乱」。）
+ */
+export declare type BpmnIssue = {
+    level: 'error' | 'warning';
+    code: string;
+    message: string;
+    componentId?: string;
+};
+export declare function validateBpmn(designer: any): BpmnIssue[];

package/dist/types/bpmn/bpmn_xml.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.
+ *
+ */
+/**
+ * BPMN 2.0 XML 互操作（`<definitions>` / `<process>` / `<collaboration>` / DI 布局）。
+ *
+ * 覆盖范围（与我们支持的元素一一对应，够和 Camunda / Flowable / bpmn.io 互通）：
+ * - 协作：`<collaboration><participant>`（池）、`<laneSet><lane>`（泳道）、`<messageFlow>`
+ * - 流程：`<startEvent>` / `<endEvent>` / `<intermediateThrowEvent>`、`<task>`（含
+ *   `userTask` / `serviceTask` / `scriptTask` / `sendTask` / `receiveTask` / `manualTask`）、
+ *   `<exclusiveGateway>` / `<parallelGateway>` / `<inclusiveGateway>` / `<eventBasedGateway>`、
+ *   `<subProcess>`、`<dataObjectReference>`、`<textAnnotation>`
+ * - 连线：`<sequenceFlow>`（带 `<conditionExpression>` 与 `default` 属性）、`<messageFlow>`、
+ *   `<association>`
+ * - 图形：`<bpmndi:BPMNDiagram><bpmndi:BPMNPlane>` + `<bpmndi:BPMNShape><dc:Bounds>` /
+ *   `<bpmndi:BPMNEdge><di:waypoint>`
+ *
+ * 未识别的元素/属性会被忽略（导入时计入 `warnings`），不会让整份文件打不开 ——
+ * 与引擎 `Deserializer` 的容错语义保持一致。
+ */
+import type FlowDesigner from '../flow/FlowDesigner.mjs';
+export declare type BpmnImportResult = {
+    nodes: number;
+    edges: number;
+    warnings: string[];
+};
+/**
+ * 导出 BPMN 2.0 XML。
+ *
+ * 容器归属按几何判定：节点落在哪个池矩形内就归到该池的 `<process>`；
+ * 池与池之间的连线导出为 `<messageFlow>`（并放进 `<collaboration>`），
+ * 池内部的顺序流导出为该 process 的 `<sequenceFlow>`。
+ */
+export declare function toBpmnXml(designer: FlowDesigner, options?: {
+    name?: string;
+}): string;
+/**
+ * 导入 BPMN 2.0 XML（覆盖范围见文件头注释）。
+ *
+ * 需要 `DOMParser`（浏览器 / jsdom 提供）。无法识别的元素会被忽略并计入 `warnings`。
+ */
+export declare function fromBpmnXml(xml: string, designer: FlowDesigner): BpmnImportResult;

package/dist/types/bpmn/bpmn_xml.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.
+ *
+ */
+/**
+ * BPMN 2.0 XML 互操作（`<definitions>` / `<process>` / `<collaboration>` / DI 布局）。
+ *
+ * 覆盖范围（与我们支持的元素一一对应，够和 Camunda / Flowable / bpmn.io 互通）：
+ * - 协作：`<collaboration><participant>`（池）、`<laneSet><lane>`（泳道）、`<messageFlow>`
+ * - 流程：`<startEvent>` / `<endEvent>` / `<intermediateThrowEvent>`、`<task>`（含
+ *   `userTask` / `serviceTask` / `scriptTask` / `sendTask` / `receiveTask` / `manualTask`）、
+ *   `<exclusiveGateway>` / `<parallelGateway>` / `<inclusiveGateway>` / `<eventBasedGateway>`、
+ *   `<subProcess>`、`<dataObjectReference>`、`<textAnnotation>`
+ * - 连线：`<sequenceFlow>`（带 `<conditionExpression>` 与 `default` 属性）、`<messageFlow>`、
+ *   `<association>`
+ * - 图形：`<bpmndi:BPMNDiagram><bpmndi:BPMNPlane>` + `<bpmndi:BPMNShape><dc:Bounds>` /
+ *   `<bpmndi:BPMNEdge><di:waypoint>`
+ *
+ * 未识别的元素/属性会被忽略（导入时计入 `warnings`），不会让整份文件打不开 ——
+ * 与引擎 `Deserializer` 的容错语义保持一致。
+ */
+import type FlowDesigner from '../flow/FlowDesigner';
+export declare type BpmnImportResult = {
+    nodes: number;
+    edges: number;
+    warnings: string[];
+};
+/**
+ * 导出 BPMN 2.0 XML。
+ *
+ * 容器归属按几何判定：节点落在哪个池矩形内就归到该池的 `<process>`；
+ * 池与池之间的连线导出为 `<messageFlow>`（并放进 `<collaboration>`），
+ * 池内部的顺序流导出为该 process 的 `<sequenceFlow>`。
+ */
+export declare function toBpmnXml(designer: FlowDesigner, options?: {
+    name?: string;
+}): string;
+/**
+ * 导入 BPMN 2.0 XML（覆盖范围见文件头注释）。
+ *
+ * 需要 `DOMParser`（浏览器 / jsdom 提供）。无法识别的元素会被忽略并计入 `warnings`。
+ */
+export declare function fromBpmnXml(xml: string, designer: FlowDesigner): BpmnImportResult;

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

@@ -1,4 +1,4 @@
-import type { ICE } from '../ice-render/index.mjs';
+import type { ICE, SvgExportOptions } from '../ice-render/index.mjs';
 import type { FlowNodeKind } from './FlowNode.mjs';
 /**
  * 流程图文档。
@@ -68,6 +68,13 @@ export default class FlowDesigner {
     constructor(ice: ICE);
     get nodes(): any[];
     get edges(): any[];
+    /**
+     * 递归展开场景树（容器型节点 —— 如 BPMN 的池/泳道 —— 里面的子节点同样算流程的一部分）。
+     *
+     * 扁平场景（纯流程图/ER）与旧行为完全一致；嵌套场景下 nodes/edges 才看得到后代节点，
+     * 校验、统计、快照、连线端点查找都因此无需特判。
+     */
+    protected __flatten(): any[];
     get selected(): any;
     /**
      * 订阅流程变更（增删改 / 连线 / 载入 / undo / redo 之后触发）。
@@ -116,6 +123,21 @@ export default class FlowDesigner {
     /** 把整个流程缩放到画布可视区内 */
     fitViewport(padding?: number): void;
     canUndo(): boolean;
+    /**
+     * 把当前流程图导出为 **SVG 矢量图**（打印、进设计工具、服务端出图都走它）。
+     *
+     * 与画布截图（`toDataURL`）的区别：这是矢量，放大不糊、可以再编辑；导出与画布**同一口径**
+     * （绘制顺序、世界矩阵、样式合并、透明度、裁剪、虚线、渐变、阴影），因此"所见即所导"。
+     *
+     * ```js
+     * const svg = designer.toSvg();                             // 内容自适应、透明背景
+     * const svg = designer.toSvg({ background: '#fff', padding: 16 });
+     * const svg = designer.toSvg({ area: 'viewport' });          // 当前视口所见即所得
+     * ```
+     *
+     * 具体实现复用引擎的 `exportSvg(this.ice, options)` —— 应用层不另造一套导出。
+     */
+    toSvg(options?: SvgExportOptions): string;
     canRedo(): boolean;
     captureHistory(): void;
     /** 清空撤销/重做栈（用于「载入示例」这类不该占用历史的初始化操作） */

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

@@ -1,4 +1,4 @@
-import type { ICE } from '../ice-render/index';
+import type { ICE, SvgExportOptions } from '../ice-render/index';
 import type { FlowNodeKind } from './FlowNode';
 /**
  * 流程图文档。
@@ -68,6 +68,13 @@ export default class FlowDesigner {
     constructor(ice: ICE);
     get nodes(): any[];
     get edges(): any[];
+    /**
+     * 递归展开场景树（容器型节点 —— 如 BPMN 的池/泳道 —— 里面的子节点同样算流程的一部分）。
+     *
+     * 扁平场景（纯流程图/ER）与旧行为完全一致；嵌套场景下 nodes/edges 才看得到后代节点，
+     * 校验、统计、快照、连线端点查找都因此无需特判。
+     */
+    protected __flatten(): any[];
     get selected(): any;
     /**
      * 订阅流程变更（增删改 / 连线 / 载入 / undo / redo 之后触发）。
@@ -116,6 +123,21 @@ export default class FlowDesigner {
     /** 把整个流程缩放到画布可视区内 */
     fitViewport(padding?: number): void;
     canUndo(): boolean;
+    /**
+     * 把当前流程图导出为 **SVG 矢量图**（打印、进设计工具、服务端出图都走它）。
+     *
+     * 与画布截图（`toDataURL`）的区别：这是矢量，放大不糊、可以再编辑；导出与画布**同一口径**
+     * （绘制顺序、世界矩阵、样式合并、透明度、裁剪、虚线、渐变、阴影），因此"所见即所导"。
+     *
+     * ```js
+     * const svg = designer.toSvg();                             // 内容自适应、透明背景
+     * const svg = designer.toSvg({ background: '#fff', padding: 16 });
+     * const svg = designer.toSvg({ area: 'viewport' });          // 当前视口所见即所得
+     * ```
+     *
+     * 具体实现复用引擎的 `exportSvg(this.ice, options)` —— 应用层不另造一套导出。
+     */
+    toSvg(options?: SvgExportOptions): string;
     canRedo(): boolean;
     captureHistory(): void;
     /** 清空撤销/重做栈（用于「载入示例」这类不该占用历史的初始化操作） */

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

@@ -19,4 +19,12 @@ export default class FlowEdge extends ICEVisioLink {
     /** 连线没有子组件；声明派生可保证将来即使加了内部装饰也不会被重复序列化 */
     hasDerivedChildren(): boolean;
     constructor(props?: any);
+    /**
+     * 改连线属性，并按 BPMN 语义重算派生样式（线型 / 虚线 / 箭头）。
+     *
+     * - sequence：实线 + 实心箭头
+     * - message：虚线 + 空心箭头（跨参与者通信）
+     * - association：点线 + 无箭头
+     */
+    applyPatch(patch?: Record<string, any>): this;
 }

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

@@ -19,4 +19,12 @@ export default class FlowEdge extends ICEVisioLink {
     /** 连线没有子组件；声明派生可保证将来即使加了内部装饰也不会被重复序列化 */
     hasDerivedChildren(): boolean;
     constructor(props?: any);
+    /**
+     * 改连线属性，并按 BPMN 语义重算派生样式（线型 / 虚线 / 箭头）。
+     *
+     * - sequence：实线 + 实心箭头
+     * - message：虚线 + 空心箭头（跨参与者通信）
+     * - association：点线 + 无箭头
+     */
+    applyPatch(patch?: Record<string, any>): this;
 }

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

@@ -6,8 +6,18 @@
  *
  */
 import { ICEGroup } from '../ice-render/index.mjs';
-/** 流程图节点类型：起止 / 处理 / 判定 / 输入输出 */
-export declare type FlowNodeKind = 'terminator' | 'process' | 'decision' | 'io';
+/**
+ * 节点类型词汇表。
+ *
+ * - 流程图：`terminator` / `process` / `decision` / `io`
+ * - BPMN 2.0：`bpmnEvent` / `bpmnTask` / `bpmnGateway` / `bpmnSubprocess` /
+ *   `bpmnDataObject` / `bpmnAnnotation` / `bpmnPool` / `bpmnLane`
+ *
+ * BPMN 复用同一套节点/连线/历史/快照机制（都是 `FlowNode`），语义差异由 `kind`
+ * 与 BPMN 专属属性（eventKind / trigger / gatewayType / taskType / band）承载，
+ * 因此文档、React 绑定、DSL 都不需要第二套实现。
+ */
+export declare type FlowNodeKind = 'terminator' | 'process' | 'decision' | 'io' | 'bpmnEvent' | 'bpmnTask' | 'bpmnGateway' | 'bpmnSubprocess' | 'bpmnDataObject' | 'bpmnAnnotation' | 'bpmnPool' | 'bpmnLane';
 export declare type FlowNodePreset = {
     label: string;
     width: number;
@@ -15,7 +25,25 @@ export declare type FlowNodePreset = {
     fill: string;
     stroke: string;
     radius?: number;
-    shape: 'rect' | 'diamond' | 'parallelogram';
+    shape: 'rect' | 'diamond' | 'parallelogram' | 'event' | 'gateway' | 'dataObject' | 'annotation' | 'lane';
+    /** 外框线宽（BPMN 结束事件用粗圈） */
+    lineWidth?: number;
+    /** 虚线（注释框） */
+    lineDash?: number[];
+    /** 名称带：泳道在左、池在顶 */
+    band?: 'left' | 'top';
+    bandSize?: number;
+    /** 标题摆放：居中（图元）或左上（池/泳道/注释） */
+    labelPlacement?: 'center' | 'top-left';
+    /** 背景透明（泳道用：相邻泳道共享边界时，填充会盖住邻居的边框） */
+    transparent?: boolean;
+    /** 默认的任务类型角标（bpmnTask 用） */
+    taskType?: string;
+    /** 默认事件种类 / 触发（bpmnEvent 用） */
+    eventKind?: string;
+    trigger?: string;
+    /** 默认网关类型（bpmnGateway 用） */
+    gatewayType?: string;
 };
 /** 各类型节点的默认尺寸与配色（同时作为属性面板的预设） */
 export declare const FLOW_NODE_KINDS: Record<FlowNodeKind, FlowNodePreset>;
@@ -31,6 +59,8 @@ export default class FlowNode extends ICEGroup {
     static readonly typeId = "FlowNode";
     protected shapeComponent: any;
     protected labelComponent: any;
+    /** BPMN 装饰件（任务角标 / 子流程标记），随形状一起重建 */
+    protected decorationComponents: any[];
     /**
      * 内部子组件（形状 + 标题）由 kind/尺寸/配色派生，构造函数会重建 →
      * 不参与引擎序列化（否则往返会重复挂载，且子组件 zIndex 抖动，见 ICEComponent.hasDerivedChildren）。
@@ -39,6 +69,13 @@ export default class FlowNode extends ICEGroup {
     constructor(props?: any);
     /** 按当前 kind / 尺寸 / 配色重建形状与标题（切换类型或改样式时调用） */
     private __buildShape;
+    /**
+     * BPMN 装饰件（任务类型角标、子流程折叠标记）。
+     *
+     * 它们与形状/标题一样由节点 state 派生，因此不需要单独序列化
+     * （见 hasDerivedChildren：整个内部子树都是派生的）。
+     */
+    private __buildDecorations;
     /** 改节点属性（标题 / 类型 / 配色 / 尺寸），必要时重建形状 */
     applyPatch(patch?: Record<string, any>): this;
 }

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

@@ -6,8 +6,18 @@
  *
  */
 import { ICEGroup } from '../ice-render/index';
-/** 流程图节点类型：起止 / 处理 / 判定 / 输入输出 */
-export declare type FlowNodeKind = 'terminator' | 'process' | 'decision' | 'io';
+/**
+ * 节点类型词汇表。
+ *
+ * - 流程图：`terminator` / `process` / `decision` / `io`
+ * - BPMN 2.0：`bpmnEvent` / `bpmnTask` / `bpmnGateway` / `bpmnSubprocess` /
+ *   `bpmnDataObject` / `bpmnAnnotation` / `bpmnPool` / `bpmnLane`
+ *
+ * BPMN 复用同一套节点/连线/历史/快照机制（都是 `FlowNode`），语义差异由 `kind`
+ * 与 BPMN 专属属性（eventKind / trigger / gatewayType / taskType / band）承载，
+ * 因此文档、React 绑定、DSL 都不需要第二套实现。
+ */
+export declare type FlowNodeKind = 'terminator' | 'process' | 'decision' | 'io' | 'bpmnEvent' | 'bpmnTask' | 'bpmnGateway' | 'bpmnSubprocess' | 'bpmnDataObject' | 'bpmnAnnotation' | 'bpmnPool' | 'bpmnLane';
 export declare type FlowNodePreset = {
     label: string;
     width: number;
@@ -15,7 +25,25 @@ export declare type FlowNodePreset = {
     fill: string;
     stroke: string;
     radius?: number;
-    shape: 'rect' | 'diamond' | 'parallelogram';
+    shape: 'rect' | 'diamond' | 'parallelogram' | 'event' | 'gateway' | 'dataObject' | 'annotation' | 'lane';
+    /** 外框线宽（BPMN 结束事件用粗圈） */
+    lineWidth?: number;
+    /** 虚线（注释框） */
+    lineDash?: number[];
+    /** 名称带：泳道在左、池在顶 */
+    band?: 'left' | 'top';
+    bandSize?: number;
+    /** 标题摆放：居中（图元）或左上（池/泳道/注释） */
+    labelPlacement?: 'center' | 'top-left';
+    /** 背景透明（泳道用：相邻泳道共享边界时，填充会盖住邻居的边框） */
+    transparent?: boolean;
+    /** 默认的任务类型角标（bpmnTask 用） */
+    taskType?: string;
+    /** 默认事件种类 / 触发（bpmnEvent 用） */
+    eventKind?: string;
+    trigger?: string;
+    /** 默认网关类型（bpmnGateway 用） */
+    gatewayType?: string;
 };
 /** 各类型节点的默认尺寸与配色（同时作为属性面板的预设） */
 export declare const FLOW_NODE_KINDS: Record<FlowNodeKind, FlowNodePreset>;
@@ -31,6 +59,8 @@ export default class FlowNode extends ICEGroup {
     static readonly typeId = "FlowNode";
     protected shapeComponent: any;
     protected labelComponent: any;
+    /** BPMN 装饰件（任务角标 / 子流程标记），随形状一起重建 */
+    protected decorationComponents: any[];
     /**
      * 内部子组件（形状 + 标题）由 kind/尺寸/配色派生，构造函数会重建 →
      * 不参与引擎序列化（否则往返会重复挂载，且子组件 zIndex 抖动，见 ICEComponent.hasDerivedChildren）。
@@ -39,6 +69,13 @@ export default class FlowNode extends ICEGroup {
     constructor(props?: any);
     /** 按当前 kind / 尺寸 / 配色重建形状与标题（切换类型或改样式时调用） */
     private __buildShape;
+    /**
+     * BPMN 装饰件（任务类型角标、子流程折叠标记）。
+     *
+     * 它们与形状/标题一样由节点 state 派生，因此不需要单独序列化
+     * （见 hasDerivedChildren：整个内部子树都是派生的）。
+     */
+    private __buildDecorations;
     /** 改节点属性（标题 / 类型 / 配色 / 尺寸），必要时重建形状 */
     applyPatch(patch?: Record<string, any>): this;
 }