@xpyjs/gantt-core 0.0.1-alpha.3 → 0.0.1-alpha.5

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xpyjs/gantt-core",
   "private": false,
-  "version": "0.0.1-alpha.3",
+  "version": "0.0.1-alpha.5",
   "description": "A powerful and flexible Gantt chart component library for modern web applications with TypeScript support",
   "type": "module",
   "main": "./dist/x-gantt.umd.cjs",

package/types/event/index.d.ts

@@ -29,6 +29,7 @@ export declare enum EventName {
     MOVE_GUIDELINE = "move-guideline",
     SHOW_GUIDELINE = "show-guideline",
     HIDE_GUIDELINE = "hide-guideline",
+    TOGGLE_COLLAPSE = "toggle-collapse",
     SCROLL = "scroll",
     CHART_OFFSET_CHANGE = "chart_offset_change",
     DATA_UPDATE = "data-update",
@@ -43,6 +44,7 @@ export declare enum EventName {
     TASK_UNSELECTED = "task_unselected",
     SELECT_LINK = "select_link",
     CHECK_TASK = "check_task",
+    CONTEXT_LINK = "context_link",
     ROW_CLICK = "row-click",
     ROW_DBL_CLICK = "row-dbl-click",
     ROW_CONTEXTMENU = "row-contextmenu",
@@ -50,11 +52,17 @@ export declare enum EventName {
     SLIDER_DBL_CLICK = "slider-dbl-click",
     SLIDER_CONTEXTMENU = "slider-contextmenu",
     SLIDER_MOVING = "slider-moving",
+    SLIDER_HOVER = "slider-hover",
+    SLIDER_LEAVE = "slider-leave",
     ROW_HIGHLIGHT = "row-highlight",
     ROW_UNHIGHLIGHT = "row-unhighlight",
     TASK_DRAG_START = "task-drag-start",
     TASK_DRAG_MOVE = "task-drag-move",
     TASK_DRAG_END = "task-drag-end",
+    BASELINE_CLICK = "baseline-click",
+    BASELINE_CONTEXTMENU = "baseline-contextmenu",
+    BASELINE_MOUSEOVER = "baseline-mouseover",
+    BASELINE_MOUSEOUT = "baseline-mouseout",
     ERROR = "error"
 }
 export declare enum ErrorType {

package/types/models/Baseline.d.ts

@@ -0,0 +1,37 @@
+import type { Dayjs } from "dayjs";
+import { Store } from "@/store";
+import { type EventBus } from "../event";
+import { BaselineDiff } from "../types/baseline";
+/**
+ * 基线数据模型
+ */
+export declare class Baseline {
+    private store;
+    private event;
+    /** 基线ID */
+    id: string;
+    /** 任务ID */
+    taskId: string;
+    /** 开始时间 */
+    startTime?: Dayjs;
+    /** 结束时间 */
+    endTime?: Dayjs;
+    /** 基线名称 */
+    name?: string;
+    /** 原始数据 */
+    data: any;
+    /** 是否高亮 */
+    highlight: boolean;
+    /** 是否为指示器对比基线 */
+    target: boolean;
+    constructor(store: Store, event: EventBus, data: any);
+    getField(field: string): any;
+    /**
+     * 验证基线的有效性
+     */
+    validate(): boolean;
+    /**
+     * 获取基线与任务的时间差异分析
+     */
+    getTimeDiff(): BaselineDiff | null;
+}

package/types/models/Task.d.ts

@@ -1,5 +1,6 @@
 import type { Dayjs } from "dayjs";
 import { type EventBus } from "../event";
+import { TaskType } from "../types/options";
 import { EmitData } from "@/types";
 import { Store } from "@/store";
 export declare class Task {
@@ -29,6 +30,8 @@ export declare class Task {
      * 任务进度
      */
     progress?: number;
+    /** 任务类型 */
+    type: TaskType;
     /**
      * 是否展开
      * 如果没有提供，则默认为 true
@@ -52,6 +55,10 @@ export declare class Task {
      * 在扁平化列表中的索引位置，从0开始
      */
     flatIndex: number;
+    /**
+     * 时间持续间隔
+     */
+    private duration;
     /**
      * 原始数据
      */
@@ -59,9 +66,13 @@ export declare class Task {
     private fields;
     constructor(store: Store, event: EventBus, data: any, parent?: Task, _id?: string);
     getField(field: string): any;
+    /** 切换展示模式时，需要调整时间 */
+    updateMode(): void;
     updateData(data: any): void;
     updateTime(startTime: Dayjs, endTime: Dayjs): void;
     clone(): Task;
     getEmitData(): EmitData;
     getAllChildren(): Task[];
+    isMilestone(): boolean;
+    isSummary(): boolean;
 }

package/types/rendering/chart/ChartBaseline.d.ts

@@ -0,0 +1,50 @@
+import Konva from "konva";
+import { Task } from "../../models/Task";
+import { IContext } from "@/types/render";
+export declare class ChartBaseline {
+    private context;
+    private stage;
+    private layer;
+    private tasks;
+    private chartBaselineGroup;
+    private indicatorGroup;
+    private baselineGroup;
+    private width;
+    private height;
+    private offsetX;
+    private offsetY;
+    constructor(context: IContext, stage: Konva.Stage, layer: Konva.Layer);
+    /**
+     * 注册事件
+     */
+    private registerEvents;
+    /**
+     * 调整基线大小
+     */
+    resize(width: number, height: number): void;
+    /**
+     * 设置偏移量 (响应滚动)
+     */
+    setOffset(x: number, y: number): void;
+    /**
+     * 更新数据
+     */
+    update(): void;
+    /**
+     * 渲染基线
+     */
+    render(tasks: Task[]): void;
+    /**
+     * 销毁关联线
+     */
+    destroy(): void;
+    /**
+     * 计算并渲染基线
+     */
+    private calculateBaselines;
+    private renderBaselineBar;
+    private renderText;
+    private renderCompareHighlight;
+    private renderCompareIndicator;
+    private bindEvents;
+}

package/types/rendering/chart/ChartLink.d.ts

@@ -50,6 +50,7 @@ export declare class LinkGroup {
      */
     private calculateLinks;
     private createId;
+    private getPoints;
     /** 生成 FS 连线 */
     private createFS;
     /** 生成 FF 连线 */

package/types/rendering/chart/ChartSlider.d.ts

@@ -11,9 +11,10 @@ export declare class ChartSlider {
     private offsetY;
     sliderGroup: Konva.Group;
     private slider;
-    private sliderBg;
-    private leftHandler;
-    private rightHandler;
+    private sliderBar;
+    private sliderType;
+    private leftHandleGroup;
+    private rightHandleGroup;
     private progressGroup;
     private handlerWidth;
     private autoMoveTimer;
@@ -29,7 +30,8 @@ export declare class ChartSlider {
     constructor(context: IContext, x: number, y: number, task: Task, rowWidth: number);
     update(x: number, y: number): void;
     setOffset(x: number, y: number): void;
-    private updateSize;
+    /** 太多需要 function 的判断，搞一个统一的转换 */
+    private unpackFunc;
     private render;
     private renderText;
     private renderProgress;
@@ -51,4 +53,6 @@ export declare class ChartSlider {
     private handleMouseEnter;
     private handleMouseLeave;
     private handleResizeHighlight;
+    /** 鼠标移入高亮 */
+    private handleBarHighlight;
 }

package/types/rendering/chart/index.d.ts

@@ -11,6 +11,7 @@ export declare class Chart {
     private holidayGroup;
     private todayLayer;
     private linkGroup;
+    private baselineGroup;
     private bgLayer;
     private bodyLayer;
     private width;

package/types/rendering/other/MiddleResizeLine.d.ts

@@ -5,6 +5,7 @@ export declare class MiddleResizeLine {
     private line;
     private initialX;
     private initialWidth;
+    private collapseButton;
     constructor(root: IContext, container: HTMLElement);
     setOffset(x: number): void;
     /**

package/types/rendering/scrollbar/index.d.ts

@@ -75,6 +75,7 @@ export declare class Scrollbar {
     private applyThumbStyles;
     private bindEvents;
     private unbindEvents;
+    private emit;
     private handleRootMouseMove;
     private handleScrollbarMouseEnter;
     private handleScrollbarMouseLeave;

package/types/store/ColumnManager.d.ts

@@ -46,6 +46,10 @@ export declare class ColumnManager {
      * Map<task_id, Map<col_index, object>>
      */
     private mergeInfo;
+    /**
+     * 收起表格
+     */
+    private collapseTable;
     constructor(context: IContext);
     /**
      * 初始化列数据
@@ -72,4 +76,6 @@ export declare class ColumnManager {
     clearMergeInfo(): void;
     getHandlerColumn(): IColumn<ITableColumnStandard>;
     isMultiHeader(): boolean;
+    collapse(): void;
+    isCollapsed(): boolean;
 }

package/types/store/DataManager.d.ts

@@ -2,6 +2,7 @@ import type { Dayjs } from "dayjs";
 import { type EventBus } from "../event";
 import { Task } from "../models/Task";
 import type { Store } from ".";
+import { Baseline } from "../models/Baseline";
 export declare class DataManager {
     private store;
     private event;
@@ -30,6 +31,12 @@ export declare class DataManager {
     private selectedTaskId;
     /** 选中列表 */
     private checkedList;
+    /** 基线数据 */
+    private baselines;
+    /** 基线映射，使用ID作为键 */
+    private baselineMap;
+    /** 任务与基线映射，使用任务ID作为键。 一个任务可以对应多条基线 */
+    private baselineTaskMap;
     /** 数据最大层级。 0 开始 */
     dataLevel: number;
     constructor(store: Store, event: EventBus);
@@ -116,4 +123,10 @@ export declare class DataManager {
     toggleAllChecked(checked: boolean): void;
     isTaskChecked(task: Task): boolean;
     updateTaskTime(task: Task, startTime: Dayjs, endTime: Dayjs, direction?: "left" | "right" | "both", oldTasks?: Task[]): void;
+    setBaselines(baselines: any[]): void;
+    getBaselines(): Baseline[];
+    /** 根据ID获取基线 */
+    getBaselineById(id: string): Baseline | undefined;
+    /** 根据任务ID获取基线 */
+    getBaselinesByTaskId(taskId: string): Baseline[];
 }

package/types/store/OptionManager.d.ts

@@ -8,4 +8,5 @@ export declare class OptionManager {
     setOptions(options: IOptions, config?: IOptionConfig): void;
     update(newOptions: IOptions): void;
     getRowBackgroundColor(task: Task): string;
+    unpackFunc<T>(value: T | ((data: any) => T), task: Task): T;
 }

package/types/types/baseline.d.ts

@@ -0,0 +1,16 @@
+export type BaselineDiffStatus = 'ahead' | 'ontime' | 'delayed';
+
+export interface BaselineDiff {
+    /** 开始时间差异 */
+    startDiff: number;
+    /** 开始状态 */
+    startStatus?: BaselineDiffStatus;
+    /** 结束时间差异 */
+    endDiff: number;
+    /** 结束状态 */
+    endStatus?: BaselineDiffStatus;
+    /** 差异单位 */
+    unit: string;
+    /** 进度偏差 */
+    progressDiff?: number;
+}

package/types/types/event.d.ts

@@ -11,6 +11,7 @@ export interface EventMap {
     cancel: ILink | null,
     all: ILink[]
   ) => void;
+  "contextmenu:link": (e: MouseEvent, link: ILink) => void;
   select: (data: any[], checked: boolean, all: any[]) => void;
   "click:row": (e: MouseEvent, data: any) => void;
   "dblclick:row": (e: MouseEvent, data: any) => void;
@@ -19,4 +20,10 @@ export interface EventMap {
   "dblclick:slider": (e: MouseEvent, data: any) => void;
   "contextmenu:slider": (e: MouseEvent, data: any) => void;
   move: (data: { row: any; old: any }[]) => void;
+  "hover:slider": (e: MouseEvent, data: any) => void;
+  "leave:slider": (e: MouseEvent, data: any) => void;
+  "click:baseline": (e: MouseEvent, data: any, baseline: any) => void;
+  "contextmenu:baseline": (e: MouseEvent, data: any, baseline: any) => void;
+  "hover:baseline": (e: MouseEvent, data: any, baseline: any) => void;
+  "leave:baseline": (e: MouseEvent, data: any, baseline: any) => void;
 }

package/types/types/index.d.ts

@@ -19,3 +19,8 @@ export interface EmitData {
   /** 当前数据的层级。 1 开始 */
   level: number;
 }
+
+export interface EmitBaseline extends EmitData {
+  /** 基线数据 */
+  baseline: any;
+}