@xpyjs/gantt-core 0.0.1-alpha.4 → 0.0.1-beta.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xpyjs/gantt-core",
   "private": false,
-  "version": "0.0.1-alpha.4",
+  "version": "0.0.1-beta.0",
   "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/models/Task.d.ts

@@ -74,4 +74,5 @@ export declare class Task {
     getEmitData(): EmitData;
     getAllChildren(): Task[];
     isMilestone(): boolean;
+    isSummary(): boolean;
 }

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

@@ -0,0 +1,36 @@
+import Konva from "konva";
+import { IContext } from "@/types/render";
+/**
+ * 标志日期的渲染
+ */
+export declare class FlagGroup {
+    private context;
+    private layer;
+    private width;
+    private height;
+    private offsetX;
+    private offsetY;
+    private flagGroup;
+    constructor(context: IContext, layer: Konva.Layer);
+    /**
+     * 调整标志日期大小
+     */
+    resize(width: number, height: number): void;
+    /**
+     * 设置偏移量 (响应滚动)
+     */
+    setOffset(x: number, y: number): void;
+    /**
+     * 渲染标志日期
+     */
+    render(): void;
+    /**
+     * 销毁标志日期层
+     */
+    destroy(): void;
+    private clearFlag;
+    /**
+     * 计算标志日期
+     */
+    private calculateFlag;
+}

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/ChartToday.d.ts

@@ -6,6 +6,7 @@ export declare class ChartToday {
     private headerLayer;
     private arrowAnimation?;
     private todayLine?;
+    private todayTextGroup?;
     private triangle?;
     private width;
     private height;

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

@@ -9,6 +9,7 @@ export declare class Chart {
     private gridGroup;
     private weekendGroup;
     private holidayGroup;
+    private flagGroup;
     private todayLayer;
     private linkGroup;
     private baselineGroup;

package/types/store/TimeAxis.d.ts

@@ -20,8 +20,6 @@ export declare class TimeAxis {
     private strictStart;
     /** 固定截止日期 */
     private strictEnd;
-    /** 是否锁定时间范围 */
-    private isStrict;
     /** 是否自适应宽度 */
     private isAuto;
     /** 表头的日期列表 */

package/types/types/options.d.ts

@@ -63,6 +63,18 @@ export interface IGanttOptions {
     key: string;
     /** 是否展示关联线。不支持单独配置 */
     show: boolean;
+    /** 移动相关设置 */
+    move: {
+      /**
+       * 是否允许移动连线到新节点。
+       *
+       * @default false
+       *
+       * @description 开启时，所有连线将按照 from 与 to 属性规则允许移动
+       * @description 需要注意的是，开启移动后，需要主动添加对应 'update:link' 事件，否则会导致显示异常
+       */
+      enabled: boolean;
+    };
     /** 创建相关设置 */
     create: {
       /**
@@ -387,6 +399,34 @@ export interface IGanttOptions {
     };
   };
 
+  /** 汇总集合配置 */
+  summary: {
+    /**
+     * 是否启用汇总集合
+     *
+     * @default false
+     *
+     * @description 启用后，所有标记为汇总集合的任务将会被特殊处理。
+     */
+    show: boolean;
+    /** 汇总集合的颜色。默认与 bar 颜色保持一致 */
+    color?: string | ((row: EmitData) => string | undefined);
+    /** 移动相关配置 */
+    move: {
+      /** 是否启用移动。默认情况，汇总是不允许主动移动的 */
+      enabled: boolean;
+    };
+    /**
+     * 展示模式
+     *
+     * @default 'expand'
+     *
+     * - 'always' 永远展示为汇总集合形式
+     * - 'expand' 展开时展示为汇总集合形式，当任务收起后，展示为普通类型
+     */
+    mode: "always" | "expand"
+  };
+
   /** 主色调。默认 #eca710 */
   primaryColor: string;
 
@@ -736,6 +776,25 @@ export interface IGanttOptions {
      * @default 1
      */
     width: number;
+    /**
+     * 今日时间线的文本
+     */
+    text?: {
+      /** 是否显示文本 */
+      show?: boolean;
+      /** 文本内容。默认为 '今天' */
+      content?: string;
+      /** 文本颜色 */
+      color?: string;
+      /** 背景颜色 */
+      backgroundColor?: string;
+      /** 透明度 */
+      opacity?: number;
+      /** 文本字体大小 */
+      fontSize?: number;
+      /** 文本字体 */
+      fontFamily?: string;
+    }
   };
 
   /** 周末配置 */
@@ -783,10 +842,92 @@ export interface IGanttOptions {
         date: Date | number | string | Array<Date | number | string>;
         backgroundColor?: string;
         opacity?: number;
+        /**
+         * 自定义节假日期的文本
+         */
+        text?: {
+          /** 是否显示文本 */
+          show?: boolean;
+          /** 文本内容 */
+          content?: string;
+          /** 文本颜色 */
+          color?: string;
+          /** 背景颜色 */
+          backgroundColor?: string;
+          /** 透明度 */
+          opacity?: number;
+          /** 文本字体大小 */
+          fontSize?: number;
+          /** 文本字体 */
+          fontFamily?: string;
+        }
       } & IPattern
     >;
   } & IPattern;
 
+  /** 标志配置。它用于配置一个或多个标志性日期 */
+  flag?: {
+    /**
+     * 是否展示标志
+     *
+     * @default false
+     */
+    show: boolean;
+    /**
+     * 标志的背景颜色。默认使用主色调
+     */
+    backgroundColor?: string;
+    /**
+     * 透明度
+     *
+     * @description 它会影响标志的整体透明度
+     */
+    opacity?: number;
+    /** 文本颜色 */
+    color?: string;
+    /** 文本字体大小 */
+    fontSize?: number;
+    /** 文本字体 */
+    fontFamily?: string;
+    /** 标志日期的数据以及配置 */
+    data: Array<{
+      /**
+       * 标志的背景颜色
+       */
+      backgroundColor?: string;
+      /**
+       * 透明度
+       *
+       * @description 它会影响标志的整体透明度
+       */
+      opacity?: number;
+      /**
+       * 标志时间。支持精准时间，会根据最精度位置展示
+       */
+      date: Date | number | string;
+      /** 文本内容。展示文本就是普通文本旗帜 */
+      content?: string;
+      /**
+       * 如果不展示文本，支持几种特殊旗帜符号
+       *
+       * @description 它与文本内容互斥，如果 content 不为空，则不会展示特殊旗帜
+       *
+       * @param banner 横幅旗（比带文本旗帜略小）
+       * @param pennant 三角信号旗
+       * @param tag 矩形带缺口旗
+       * @param wedge 锥形旗
+       * @param ribbon 丝带旗
+       */
+      flag?: "banner" | "pennant" | "tag" | "wedge" | "ribbon";
+      /** 文本颜色 */
+      color?: string;
+      /** 文本字体大小 */
+      fontSize?: number;
+      /** 文本字体 */
+      fontFamily?: string;
+    }>
+  }
+
   /** 滚动条配置 */
   scrollbar?: {
     /** 是否显示水平滚动条 */