ice-entity-designer 0.0.25 → 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/index.d.mts

@@ -36,6 +36,13 @@ 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

@@ -36,6 +36,13 @@ 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/package.json

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