ice-entity-designer 0.0.26 → 0.0.28

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

@@ -0,0 +1,92 @@
+/**
+ * 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 { ICECircle } from '../ice-render/index.mjs';
+/**
+ * 仿真令牌的点：一个普通的引擎圆，只是给了稳定的 `typeId`。
+ *
+ * 它挂在 `ice.toolNodes`（工具层）—— 工具层**不参与引擎序列化**，因此仿真不会污染文档、
+ * 快照与 BPMN XML 导出，一旦 `stop()` 就干净退场。
+ */
+export declare class SimTokenDot extends ICECircle {
+    static readonly typeId = "SimToken";
+    constructor(props?: any);
+}
+export declare type SimToken = {
+    id: string;
+    /** 当前所在节点 */
+    nodeId: string;
+    /** 正在走的连线（在节点上停留时为 null） */
+    edgeId: string | null;
+    /** 在连线上的进度 0..1 */
+    progress: number;
+    /** 世界坐标（画布上的位置，测试与渲染都用它） */
+    position: number[];
+    /** 在当前节点还要停留多少毫秒 */
+    dwellRemaining: number;
+    component: any;
+};
+export declare type BpmnSimulatorOptions = {
+    /** 任务/网关等节点上的默认停留时长（毫秒） */
+    nodeDuration?: number;
+    /** 走一条连线默认花多久（毫秒） */
+    edgeDuration?: number;
+};
+/**
+ * @class BpmnSimulator BPMN 令牌仿真
+ *
+ * 把「流程怎么走」演示出来：令牌从开始事件出发，沿顺序流前进，在任务上停留，
+ * 在排他网关选一条分支、在并行网关一分为多，最终到达结束事件消失。
+ *
+ * 设计上刻意**不引入新的时间机制**：
+ * - 推进是显式的 `step(dtMs)`：浏览器里由引擎的帧事件驱动，测试里手动推进（确定性、可断言）；
+ * - 令牌位置就在连线的**实际折点**上插值（`points`），因此令牌始终贴在画出来的线上；
+ * - 令牌是工具层组件：不写文档、不影响快照与导出。
+ */
+export default class BpmnSimulator {
+    private designer;
+    private tokens;
+    private visited;
+    private running;
+    private finished;
+    private started;
+    private nodeDurations;
+    private nodeDuration;
+    private edgeDuration;
+    private seq;
+    private lastFrameAt;
+    private frameHandler;
+    constructor(designer: any, options?: BpmnSimulatorOptions);
+    /** 单个节点上的停留时长（例如让某个任务看得清） */
+    setNodeDuration(nodeId: string, duration: number): void;
+    setEdgeDuration(duration: number): void;
+    isRunning(): boolean;
+    isFinished(): boolean;
+    getTokens(): SimToken[];
+    getVisitedNodeIds(): string[];
+    /** 开始：每个「开始事件」放一个令牌，并挂到帧循环上 */
+    start(): void;
+    stop(): void;
+    /** 清空令牌与访问记录（可重跑） */
+    reset(): void;
+    /**
+     * 推进 `dtMs` 毫秒。
+     *
+     * 令牌的状态机很直白：在节点上倒计时停留 → 到时选出口（可能分裂）→ 在连线上按进度前进
+     * → 到达目标节点。结束事件上不再有出口，令牌随之消失。
+     */
+    step(dtMs: number): void;
+    /** 选中一条出口连线（排他网关优先选带条件的，其次是显式非默认的） */
+    private __pickExclusive;
+    private __spawn;
+    private __arriveAtNode;
+    /** 离开节点：选出口；并行/包容网关分裂成多条令牌 */
+    private __leaveNode;
+    private __syncPosition;
+    private __nodePosition;
+    private __removeComponent;
+}

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

@@ -0,0 +1,92 @@
+/**
+ * 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 { ICECircle } from '../ice-render/index';
+/**
+ * 仿真令牌的点：一个普通的引擎圆，只是给了稳定的 `typeId`。
+ *
+ * 它挂在 `ice.toolNodes`（工具层）—— 工具层**不参与引擎序列化**，因此仿真不会污染文档、
+ * 快照与 BPMN XML 导出，一旦 `stop()` 就干净退场。
+ */
+export declare class SimTokenDot extends ICECircle {
+    static readonly typeId = "SimToken";
+    constructor(props?: any);
+}
+export declare type SimToken = {
+    id: string;
+    /** 当前所在节点 */
+    nodeId: string;
+    /** 正在走的连线（在节点上停留时为 null） */
+    edgeId: string | null;
+    /** 在连线上的进度 0..1 */
+    progress: number;
+    /** 世界坐标（画布上的位置，测试与渲染都用它） */
+    position: number[];
+    /** 在当前节点还要停留多少毫秒 */
+    dwellRemaining: number;
+    component: any;
+};
+export declare type BpmnSimulatorOptions = {
+    /** 任务/网关等节点上的默认停留时长（毫秒） */
+    nodeDuration?: number;
+    /** 走一条连线默认花多久（毫秒） */
+    edgeDuration?: number;
+};
+/**
+ * @class BpmnSimulator BPMN 令牌仿真
+ *
+ * 把「流程怎么走」演示出来：令牌从开始事件出发，沿顺序流前进，在任务上停留，
+ * 在排他网关选一条分支、在并行网关一分为多，最终到达结束事件消失。
+ *
+ * 设计上刻意**不引入新的时间机制**：
+ * - 推进是显式的 `step(dtMs)`：浏览器里由引擎的帧事件驱动，测试里手动推进（确定性、可断言）；
+ * - 令牌位置就在连线的**实际折点**上插值（`points`），因此令牌始终贴在画出来的线上；
+ * - 令牌是工具层组件：不写文档、不影响快照与导出。
+ */
+export default class BpmnSimulator {
+    private designer;
+    private tokens;
+    private visited;
+    private running;
+    private finished;
+    private started;
+    private nodeDurations;
+    private nodeDuration;
+    private edgeDuration;
+    private seq;
+    private lastFrameAt;
+    private frameHandler;
+    constructor(designer: any, options?: BpmnSimulatorOptions);
+    /** 单个节点上的停留时长（例如让某个任务看得清） */
+    setNodeDuration(nodeId: string, duration: number): void;
+    setEdgeDuration(duration: number): void;
+    isRunning(): boolean;
+    isFinished(): boolean;
+    getTokens(): SimToken[];
+    getVisitedNodeIds(): string[];
+    /** 开始：每个「开始事件」放一个令牌，并挂到帧循环上 */
+    start(): void;
+    stop(): void;
+    /** 清空令牌与访问记录（可重跑） */
+    reset(): void;
+    /**
+     * 推进 `dtMs` 毫秒。
+     *
+     * 令牌的状态机很直白：在节点上倒计时停留 → 到时选出口（可能分裂）→ 在连线上按进度前进
+     * → 到达目标节点。结束事件上不再有出口，令牌随之消失。
+     */
+    step(dtMs: number): void;
+    /** 选中一条出口连线（排他网关优先选带条件的，其次是显式非默认的） */
+    private __pickExclusive;
+    private __spawn;
+    private __arriveAtNode;
+    /** 离开节点：选出口；并行/包容网关分裂成多条令牌 */
+    private __leaveNode;
+    private __syncPosition;
+    private __nodePosition;
+    private __removeComponent;
+}

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

@@ -19,6 +19,8 @@ export declare type GanttTaskInput = {
     days?: number;
     row?: number;
     progress?: number;
+    /** 负责人 / 资源名（用于资源冲突检查；空表示不参与） */
+    resource?: string;
 };
 /**
  * @class GanttDesigner 甘特图设计器（第三个 domain pack）
@@ -57,6 +59,23 @@ export default class GanttDesigner extends FlowDesigner {
     createDependency(props?: any): any;
     /** 改每日像素（时间轴缩放）：所有任务与依赖一起重排 */
     setDayWidth(dayWidth: number): void;
+    /** 改任务（属性面板 / 应用层用）：走 setState，几何与框架自动跟着更新 */
+    updateTask(id: string, patch?: any): any;
+    /**
+     * **自动排程**：把每个任务推到「所有前置任务结束之后」（完成 → 开始，结束日不含当天）。
+     *
+     * 语义：任务占 `[start, start + days)`，因此后置任务最早在前置任务 `start + days` 那天开工。
+     * 只在**推后**时生效（不提前任何任务）—— 人力排期里"提前"通常意味着别处的约束被破坏。
+     * 依赖图必须先无环（有环时本方法不动，交给 `validateGantt()` 报错）。
+     */
+    autoSchedule(): void;
+    /**
+     * **关键路径**：依赖图上「时长最长」的那条链（浮时为 0 的任务）。
+     *
+     * 用最早/最晚开工时间算总浮时：`float = 最晚开工 - 最早开工`，浮时为 0 的任务即在关键路径上。
+     * 有环时返回空数组（无关键路径可言）。
+     */
+    criticalPath(): any[];
     /** 项目起点 = 最早任务的开始日；没有任务时留空 */
     computeOrigin(): string;
     /** 项目区间（天数）：至少 1 天，用于刻度与画布宽度 */

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

@@ -19,6 +19,8 @@ export declare type GanttTaskInput = {
     days?: number;
     row?: number;
     progress?: number;
+    /** 负责人 / 资源名（用于资源冲突检查；空表示不参与） */
+    resource?: string;
 };
 /**
  * @class GanttDesigner 甘特图设计器（第三个 domain pack）
@@ -57,6 +59,23 @@ export default class GanttDesigner extends FlowDesigner {
     createDependency(props?: any): any;
     /** 改每日像素（时间轴缩放）：所有任务与依赖一起重排 */
     setDayWidth(dayWidth: number): void;
+    /** 改任务（属性面板 / 应用层用）：走 setState，几何与框架自动跟着更新 */
+    updateTask(id: string, patch?: any): any;
+    /**
+     * **自动排程**：把每个任务推到「所有前置任务结束之后」（完成 → 开始，结束日不含当天）。
+     *
+     * 语义：任务占 `[start, start + days)`，因此后置任务最早在前置任务 `start + days` 那天开工。
+     * 只在**推后**时生效（不提前任何任务）—— 人力排期里"提前"通常意味着别处的约束被破坏。
+     * 依赖图必须先无环（有环时本方法不动，交给 `validateGantt()` 报错）。
+     */
+    autoSchedule(): void;
+    /**
+     * **关键路径**：依赖图上「时长最长」的那条链（浮时为 0 的任务）。
+     *
+     * 用最早/最晚开工时间算总浮时：`float = 最晚开工 - 最早开工`，浮时为 0 的任务即在关键路径上。
+     * 有环时返回空数组（无关键路径可言）。
+     */
+    criticalPath(): any[];
     /** 项目起点 = 最早任务的开始日；没有任务时留空 */
     computeOrigin(): string;
     /** 项目区间（天数）：至少 1 天，用于刻度与画布宽度 */

package/dist/types/index.d.mts

@@ -23,6 +23,8 @@ export { FlowDiamond, FlowParallelogram } from './flow/flow_shapes.mjs';
 export { default as BpmnDesigner } from './bpmn/BpmnDesigner.mjs';
 export { validateBpmn } from './bpmn/bpmn_validate.mjs';
 export type { BpmnIssue } from './bpmn/bpmn_validate.mjs';
+export { default as BpmnSimulator } from './bpmn/BpmnSimulator.mjs';
+export type { SimToken, BpmnSimulatorOptions } from './bpmn/BpmnSimulator.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';

package/dist/types/index.d.ts

@@ -23,6 +23,8 @@ export { FlowDiamond, FlowParallelogram } from './flow/flow_shapes';
 export { default as BpmnDesigner } from './bpmn/BpmnDesigner';
 export { validateBpmn } from './bpmn/bpmn_validate';
 export type { BpmnIssue } from './bpmn/bpmn_validate';
+export { default as BpmnSimulator } from './bpmn/BpmnSimulator';
+export type { SimToken, BpmnSimulatorOptions } from './bpmn/BpmnSimulator';
 export { toBpmnXml, fromBpmnXml } from './bpmn/bpmn_xml';
 export type { BpmnImportResult } from './bpmn/bpmn_xml';
 export { default as UmlClass } from './uml/UmlClass';

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "ice-entity-designer",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "description": "An entity designer based on ice-render.",
   "repository": {
     "type": "git",