@xpyjs/gantt-core 0.0.1-alpha.2 → 0.0.1-alpha.4

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

@@ -0,0 +1,132 @@
+import { IGanttOptions } from "@/types/options";
+import { IContext } from "@/types/render";
+type ScrollbarOptions = NonNullable<IGanttOptions["scrollbar"]>;
+/**
+ * 滚动事件数据
+ */
+interface ScrollEventData {
+    x: number;
+    y: number;
+    source: "drag" | "wheel" | "api" | "track";
+}
+/**
+ * 自定义滚动区域，用于替代原生滚动条，提供更好的样式控制和交互体验。
+ * 负责容器元素的滚动条显示、隐藏、拖拽滚动、程序化滚动等。
+ * 监听整个根元素的滚动事件，实现平滑统一的滚动效果。
+ *
+ * @example
+ * // 实例化
+ * const scrollbar = new Scrollbar(rootElement, ganttInstance.events, options);
+ *
+ * // 当内容或视口尺寸变化时更新
+ * scrollbar.updateSize(viewportWidth, viewportHeight, contentWidth, contentHeight);
+ *
+ * // 程序化滚动 (会平滑滚动)
+ * scrollbar.scrollTo({x: 100, y: 100});
+ *
+ * // 获取当前滚动位置
+ * const { x, y } = scrollbar.getScrollPosition();
+ *
+ * // 销毁
+ * scrollbar.destroy();
+ */
+export declare class Scrollbar {
+    private root;
+    private rootElement;
+    private options;
+    private hScrollbar;
+    private vScrollbar;
+    private hScrollThumb;
+    private vScrollThumb;
+    private scrollbarContainer;
+    private viewportWidth;
+    private viewportHeight;
+    private contentWidth;
+    private contentHeight;
+    private scrollLeft;
+    private scrollTop;
+    private isDraggingHScroll;
+    private isDraggingVScroll;
+    private isMouseOverRoot;
+    private isMouseOverScrollbar;
+    private hideTimeout;
+    private showTimeout;
+    private isVisible;
+    private dragStartX;
+    private dragStartY;
+    private thumbStartScrollLeft;
+    private thumbStartScrollTop;
+    private isAnimating;
+    private animationFrameId;
+    private animationStartTime;
+    private animationStartScrollLeft;
+    private animationStartScrollTop;
+    private animationTargetScrollLeft;
+    private animationTargetScrollTop;
+    private animationSource;
+    private throttledHandleMouseMove;
+    private throttledHandleWheel;
+    constructor(root: IContext, rootElement: HTMLElement, options?: Partial<ScrollbarOptions>);
+    private createElements;
+    private createScrollbarElement;
+    private createScrollThumbElement;
+    private applyStyles;
+    private applyScrollbarStyles;
+    private applyThumbStyles;
+    private bindEvents;
+    private unbindEvents;
+    private emit;
+    private handleRootMouseMove;
+    private handleScrollbarMouseEnter;
+    private handleScrollbarMouseLeave;
+    private handleMouseEnter;
+    private handleMouseLeave;
+    private handleHorizontalThumbMouseDown;
+    private handleVerticalThumbMouseDown;
+    private handleHorizontalTrackMouseDown;
+    private handleVerticalTrackMouseDown;
+    private handleMouseMove;
+    private handleMouseUp;
+    private handleWheel;
+    private animateWheelScroll;
+    private clearTimeouts;
+    private scheduleShow;
+    private showScrollbars;
+    private scheduleHide;
+    private hideScrollbars;
+    /**
+     * 更新视口和内容尺寸，并重新计算滚动条状态。
+     * @param viewportWidth 可见区域宽度
+     * @param viewportHeight 可见区域高度
+     * @param contentWidth 内容总宽度
+     * @param contentHeight 内容总高度
+     * @param tableWidth 左侧表格宽度 (用于调整水平滚动条的起始位置和宽度)
+     * @param headerHeight 头部高度 (用于调整垂直滚动条的起始位置和高度)
+     */
+    updateSize(viewportWidth: number, viewportHeight: number, contentWidth: number, contentHeight: number, tableWidth?: number, // 甘特图左侧表格宽度
+    headerHeight?: number): void;
+    private updateThumbStyles;
+    private canScrollHorizontal;
+    private canScrollVertical;
+    private clampScroll;
+    /**
+     * 滚动到指定位置
+     * @param pos 目标滚动位置 {x, y}
+     * @param source 滚动来源
+     */
+    scrollTo(pos: {
+        x?: number;
+        y?: number;
+    }, source?: ScrollEventData["source"]): void;
+    private animationStep;
+    private cancelAnimation;
+    /**
+     * 获取当前滚动位置
+     */
+    getScrollPosition(): {
+        x: number;
+        y: number;
+    };
+    destroy(): void;
+}
+export {};

package/types/rendering/table/Checkbox.d.ts

@@ -0,0 +1,39 @@
+import { IContext } from "@/types/render";
+import type { Task } from "@/models/Task";
+export declare enum CheckboxState {
+    UNCHECKED = 0,// 未选中
+    CHECKED = 1,// 选中
+    INDETERMINATE = 2
+}
+export interface CheckboxOptions {
+    initialState: CheckboxState;
+    size: number;
+}
+export declare class Checkbox {
+    private context;
+    private container?;
+    private task?;
+    private element;
+    private iconElement;
+    private _state;
+    private options;
+    constructor(context: IContext, container?: HTMLDivElement | undefined, task?: Task | undefined);
+    private createElement;
+    private updateIcon;
+    private bindEvents;
+    private registerEvents;
+    /** 获取元素 */
+    getElement(): HTMLDivElement;
+    /**
+     * 设置状态
+     */
+    private setState;
+    /**
+     * 更新状态
+     */
+    private updateState;
+    /**
+     * 销毁组件
+     */
+    destroy(): void;
+}

package/types/rendering/table/TableBody.d.ts

@@ -0,0 +1,25 @@
+import { IContext } from "@/types/render";
+import type { Task } from "@/models/Task";
+export declare class TableBody {
+    private context;
+    private container;
+    private element;
+    private rows;
+    private mergeRows;
+    constructor(context: IContext, container: HTMLElement);
+    render(top: number, tasks: Task[]): void;
+    /**
+     * 刷新所有行
+     */
+    refresh(top: number, tasks: Task[]): void;
+    /**
+     * 更新任务
+     */
+    updateTask(task: Task): void;
+    /** 更新全部行 */
+    update(): void;
+    /**
+     * 更新列宽
+     */
+    updateWidth(): void;
+}

package/types/rendering/table/TableCell.d.ts

@@ -0,0 +1,43 @@
+import { IContext } from "@/types/render";
+import { ITableColumnStandard } from "@/types/table";
+import type { Task } from "@/models/Task";
+import { IColumn } from "@/store/ColumnManager";
+export declare class TableCell {
+    private context;
+    private container;
+    private column;
+    private task;
+    private rowIndex;
+    private colIndex;
+    private colspan;
+    private rowspan;
+    private element;
+    private isEmpty;
+    private isHandler;
+    /**
+     * 创建表格单元格
+     * @param container 父容器（tr元素）
+     * @param column 列配置
+     * @param task 任务数据
+     * @param level 任务层级
+     * @param rowIndex 行索引
+     * @param colIndex 列索引
+     * @param colspan 横向合并的列数
+     * @param rowspan 纵向合并的行数
+     */
+    constructor(context: IContext, container: HTMLDivElement, column: IColumn<ITableColumnStandard>, task: Task, rowIndex: number, colIndex: number, colspan?: number, rowspan?: number, type?: "empty" | "handler");
+    private setContent;
+    private setHandler;
+    /**
+     * 移除单元格
+     */
+    remove(): void;
+    /**
+     * 更新宽度
+     */
+    updateWidth(): void;
+    /**
+     * 更新高度
+     */
+    updateHeight(): void;
+}

package/types/rendering/table/TableHeader.d.ts

@@ -0,0 +1,13 @@
+import { IContext } from "@/types/render";
+export declare class TableHeader {
+    private context;
+    private container;
+    private headerElement;
+    private headerColumns;
+    constructor(context: IContext, container: HTMLElement);
+    private initElement;
+    /**
+     * 渲染表头
+     */
+    render(): void;
+}

package/types/rendering/table/TableHeaderCell.d.ts

@@ -0,0 +1,20 @@
+import { ITableColumnStandard } from "@/types/table";
+import { IContext } from "@/types/render";
+import { IColumn } from "@/store/ColumnManager";
+export declare class TableHeaderCell {
+    private context;
+    private root;
+    private container;
+    private column;
+    private columnElement;
+    constructor(context: IContext, root: HTMLElement, container: HTMLElement, column: IColumn<ITableColumnStandard>);
+    private initElement;
+    /**
+     * 设置列宽
+     */
+    private setWidth;
+    /**
+     * 添加拖拽把手
+     */
+    private addResizeHandle;
+}

package/types/rendering/table/TableHeaderGroup.d.ts

@@ -0,0 +1,15 @@
+import { IContext } from "@/types/render";
+import { IColumn } from "@/store/ColumnManager";
+export declare class TableHeaderGroup {
+    private context;
+    private root;
+    private container;
+    private column;
+    private groupElement;
+    private titleContainer;
+    private childContainer;
+    private children;
+    constructor(context: IContext, root: HTMLElement, container: HTMLElement, column: IColumn);
+    private initElement;
+    private initChildren;
+}

package/types/rendering/table/TableRow.d.ts

@@ -0,0 +1,57 @@
+import { IContext } from "@/types/render";
+import type { Task } from "@/models/Task";
+export declare class TableRow {
+    private context;
+    private container;
+    private task;
+    private top;
+    element: HTMLDivElement;
+    private cells;
+    /**
+     * 创建表格行
+     * @param context 上下文
+     * @param container 父容器
+     * @param task 任务数据
+     */
+    constructor(context: IContext, container: HTMLDivElement, task: Task, top: number, raising?: boolean);
+    /**
+     * 绑定触发事件
+     */
+    private bindEvents;
+    /**
+     * 注册全局接收事件
+     */
+    private registerEvents;
+    /**
+     * 更新行样式
+     */
+    private updateStyles;
+    /**
+     * 对元素提级
+     */
+    raise(): void;
+    /**
+     * 更新 top 值
+     */
+    updateTop(top: number): void;
+    /**
+     * 创建单元格
+     */
+    create(): void;
+    /**
+     * 更新行
+     */
+    update(task: Task): void;
+    /**
+     * 更新宽度
+     */
+    updateWidth(): void;
+    /**
+     * 清除单元格
+     */
+    private clearCells;
+    /**
+     * 移除行
+     */
+    remove(): void;
+}

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

@@ -0,0 +1,15 @@
+import { IContext } from "@/types/render";
+import type { Task } from "@/models/Task";
+export declare class Table {
+    private context;
+    private container;
+    private tableContainer;
+    private tableHeader;
+    private tableBody;
+    constructor(context: IContext, container: HTMLElement);
+    render(top: number, tasks: Task[]): void;
+    refresh(top: number, tasks: Task[]): void;
+    updateWidth(): void;
+    updateTask(task: Task): void;
+    private listenEvents;
+}

package/types/store/ColumnManager.d.ts

@@ -0,0 +1,81 @@
+import { ITableColumn, ITableColumnStandard } from "@/types/table";
+import { IContext } from "@/types/render";
+import type { Task } from "@/models/Task";
+/**
+ * 内部列数据结构
+ */
+export interface IColumn<T extends ITableColumn = ITableColumn> {
+    /** 显示文本 */
+    label: string;
+    /** 层级，默认为1 */
+    level: number;
+    /** 当前列最大层级 */
+    maxLevel: number;
+    /** 原始列数据 */
+    column: T;
+    /** 子项 */
+    children: IColumn[];
+    /** 列标识符，用于查找 */
+    key: string;
+    /** 标识数组，用于查找。从根到当前列的路径 */
+    path: string[];
+    /** 是否为叶子节点 */
+    isLeaf: boolean;
+    /** 列宽度 */
+    width: number | "auto";
+}
+export interface MergeInfo {
+    task: Task;
+    originColumnIndex: number;
+    colspan: number;
+    rowspan: number;
+}
+export declare class ColumnManager {
+    private context;
+    /** 源列数据 */
+    private sourceColumns;
+    /** 处理后的所有列数据 */
+    private columns;
+    /** 叶子列数据，只包含最终显示的列 */
+    private leafColumns;
+    /** 临时叶子列数据，用于更新源数据，读取宽度等原信息 */
+    private temporaryLeafColumns;
+    /**
+     * 保存所有行列合并的信息
+     *
+     * Map<task_id, Map<col_index, object>>
+     */
+    private mergeInfo;
+    /**
+     * 收起表格
+     */
+    private collapseTable;
+    constructor(context: IContext);
+    /**
+     * 初始化列数据
+     */
+    init(columns?: ITableColumn[]): void;
+    /**
+     * 处理列数据，将源数据转换为内部数据结构
+     */
+    private processColumns;
+    /**
+     * 根据 key 查找列
+     */
+    private findColumnByKey;
+    update(columns: ITableColumn[]): void;
+    getColumns(): IColumn[];
+    getColumn(key: string): IColumn | undefined;
+    getLeafColumns(): IColumn<ITableColumnStandard>[];
+    getTotalWidth(): number;
+    getColumnWidth(key: string): number;
+    setColumnWidth(key: string, width: number): void;
+    isLastColumn(key: string): boolean;
+    addMergeInfo(id: string, colIndex: number, info: MergeInfo): void;
+    getMergeInfo(id: string, colIndex: number): MergeInfo | undefined;
+    clearMergeInfo(): void;
+    getHandlerColumn(): IColumn<ITableColumnStandard>;
+    isMultiHeader(): boolean;
+    collapse(): void;
+    isCollapsed(): boolean;
+}

package/types/store/DataManager.d.ts

@@ -0,0 +1,132 @@
+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;
+    /**
+     * 原始数据
+     */
+    private rawData;
+    /**
+     * 任务列表。树形结构
+     */
+    private tasks;
+    /**
+     * 任务映射，使用ID作为键，便于快速查找
+     */
+    private taskMap;
+    /**
+     * 缓存扁平化的可视任务列表
+     * 用于提高性能，避免每次都遍历树形结构
+     */
+    private visibleTasksCache;
+    /** 标记缓存是否需要更新 */
+    private isDirty;
+    /** 缓存被折叠的任务 ID */
+    private collapsedTaskIds;
+    /** 存储当前选中的任务ID */
+    private selectedTaskId;
+    /** 选中列表 */
+    private checkedList;
+    /** 基线数据 */
+    private baselines;
+    /** 基线映射，使用ID作为键 */
+    private baselineMap;
+    /** 任务与基线映射，使用任务ID作为键。 一个任务可以对应多条基线 */
+    private baselineTaskMap;
+    /** 数据最大层级。 0 开始 */
+    dataLevel: number;
+    constructor(store: Store, event: EventBus);
+    /**
+     * 设置源数据并初始化任务
+     */
+    setData(data: any[], init?: boolean): void;
+    /**
+     * 初始化任务
+     */
+    private initTasks;
+    private createTask;
+    private updateTask;
+    /**
+     * 获取源数据
+     */
+    getData(): any[];
+    /**
+     * 获取所有任务
+     */
+    getTasks(asTree?: boolean): Task[];
+    /**
+     * 通过 ID 获取任务
+     */
+    getTaskById(id: string): Task | undefined;
+    /**
+     * 移动任务位置
+     */
+    /**
+     * 展开任务
+     */
+    expandTask(id: string, recursive?: boolean): boolean;
+    /**
+     * 按条件筛选任务
+     */
+    /**
+     * 排序任务
+     */
+    /**
+     * 获取扁平化的任务列表，包括已展开的子任务
+     * 使用缓存提高性能，只有在必要时才会重建列表
+     */
+    getVisibleTasks(): Task[];
+    /**
+     * 获取可展示任务数量
+     */
+    getVisibleSize(): number;
+    /** 检查任务是否可见 */
+    isTaskVisible(task: Task): boolean;
+    /**
+     * 清空所有数据
+     */
+    clear(): void;
+    /**
+     * 更新子任务的层级
+     */
+    /**
+     * 使缓存失效，标记需要重新生成扁平化任务列表
+     */
+    private invalidateCache;
+    /**
+     * 选择任务
+     * @param taskId 任务ID
+     * @returns 是否选择成功
+     */
+    selectTask(taskId: string): boolean;
+    /**
+     * 取消任务选择
+     */
+    unselectTask(): void;
+    /**
+     * 检查任务是否被选中
+     * @param taskId 任务ID
+     * @returns 是否被选中
+     */
+    isTaskSelected(taskId: string): boolean;
+    /**
+     * 获取当前选中的任务
+     * @returns 选中的任务，如果没有则返回undefined
+     */
+    getSelectedTask(): Task | undefined;
+    getCheckedList(): Task[];
+    updateCheckedList(checked: boolean, task: Task): void;
+    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

@@ -0,0 +1,12 @@
+import { Task } from "@/models/Task";
+import { IOptionConfig, IOptions } from "@/types";
+import { IGanttOptions } from "@/types/options";
+export declare class OptionManager {
+    private options;
+    constructor();
+    getOptions(): IGanttOptions;
+    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/store/TimeAxis.d.ts

@@ -0,0 +1,88 @@
+import dayjs, { type Dayjs } from "../utils/time";
+import { IGanttOptions } from "@/types/options";
+/** 表头项 */
+export interface TimelineItem {
+    /** 时间对象 */
+    date: Dayjs;
+    /** 展示的文本，支持自定义 */
+    label: string;
+    /** 子项内容 */
+    children?: TimelineItem[];
+    /** 是否隐藏 */
+    hide?: boolean;
+}
+export declare class TimeAxis {
+    private startTime;
+    private endTime;
+    /** 结束的标准时间。切换单位会影响结尾的扩展，需要单独记录一个标准时间 */
+    private targetEnd;
+    /** 固定起始日期 */
+    private strictStart;
+    /** 固定截止日期 */
+    private strictEnd;
+    /** 是否锁定时间范围 */
+    private isStrict;
+    /** 是否自适应宽度 */
+    private isAuto;
+    /** 表头的日期列表 */
+    private timeline;
+    private headerGroupFormat?;
+    private headerCellFormat?;
+    private isDirty;
+    /** 是否第一次赋值，如果第一次赋值，允许全部赋值 */
+    private isFirstTime;
+    /** 总宽度 */
+    private allWidth;
+    /** 每一格的宽度 */
+    private cellWidth;
+    /** 用户设定的单位 */
+    private unit;
+    constructor();
+    getStartTime(): dayjs.Dayjs;
+    getEndTime(): dayjs.Dayjs;
+    getCellWidth(): number;
+    getCellCount(): number;
+    getCellUnit(): "day" | "hour";
+    setAllWidth(width: number): void;
+    getTimeLeft(time: Dayjs): number;
+    /**
+     * 根据横向位置计算对应的时间
+     * @param left 横向位置
+     * @returns 对应的时间对象
+     */
+    getTimeByLeft(left: number): Dayjs;
+    init(options: IGanttOptions): void;
+    update(options: IGanttOptions): void;
+    setDate(start?: Dayjs, end?: Dayjs): void;
+    /** 获取表头的日期列表 */
+    getTimeline(): TimelineItem[];
+    clear(): void;
+    /**
+     * 缓存失效标记
+     */
+    private invalidateCache;
+    /** 获取细粒度单位 */
+    private getFinelyUnit;
+    /** 获取下层单位 */
+    private getChildUnit;
+    /** 获取上层单位 */
+    private getGroupUnit;
+    /** 格式化上层文本 */
+    private formatterGroupLabel;
+    /**
+     * 格式化下层文本
+     */
+    private formatterCellLabel;
+    /**
+     * 获取时间轴的总宽度
+     * @returns 时间轴总宽度（像素）
+     */
+    getTotalWidth(): number;
+    expand(type: "left" | "right" | "all", count?: number): void;
+    /**
+     * 判定一个时间是否在时间轴上
+     * @param time 时间
+     * @returns 是否在时间轴上
+     */
+    isInTimeAxis(time: Dayjs): boolean;
+}