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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xpyjs/gantt-core",
   "private": false,
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.1-alpha.3",
   "description": "A powerful and flexible Gantt chart component library for modern web applications with TypeScript support",
   "type": "module",
   "main": "./dist/x-gantt.umd.cjs",
@@ -72,6 +72,6 @@
     "test": "vitest",
     "test:coverage": "vitest run --coverage",
     "clean": "rimraf dist types",
-    "release": "pnpm publish --access public --no-git-checks"
+    "release": "pnpm publish --access public"
   }
 }

package/types/XGantt.d.ts

@@ -27,7 +27,7 @@ import { EventMap } from "./types/event";
  * });
  *
  * // 更新配置
- * gantt.updateOptions({
+ * gantt.update({
  *   unit: 'week',
  *   primaryColor: '#007acc'
  * });
@@ -55,23 +55,23 @@ export declare class XGantt {
      *
      * @example
      * ```typescript
-     * // 更新数据源
-     * gantt.updateOptions({
+     * // 更新数据源。数据会被完全替换，除非原数据的 key 一致
+     * gantt.update({
      *   data: newTaskData
      * });
      *
      * // 更新显示单位
-     * gantt.updateOptions({
+     * gantt.update({
      *   unit: 'month'
      * });
      *
      * // 更新主题色
-     * gantt.updateOptions({
+     * gantt.update({
      *   primaryColor: '#ff6b6b'
      * });
      *
      * // 批量更新多个配置
-     * gantt.updateOptions({
+     * gantt.update({
      *   unit: 'week',
      *   primaryColor: '#4ecdc4',
      *   dateFormat: 'YYYY-MM-DD',
@@ -79,13 +79,17 @@ export declare class XGantt {
      *     height: 40
      *   }
      * });
+     *
+     * // 完全替换配置（不合并）
+     * gantt.update(newOptions, { merge: false });
      * ```
+     *
      */
-    updateOptions(options: IOptions, config?: IOptionConfig): void;
+    update(options: IOptions, config?: IOptionConfig): void;
     /**
      * 渲染甘特图视图
      *
-     * @description 此方法通常不需要主动调用，初始化以及 `updateOptions` 中都会自动更新。 如果你需要强制刷新页面，可以在合适的时候调用此方法
+     * @description 此方法通常不需要主动调用，初始化以及 `update` 中都会自动更新。 如果你需要强制刷新页面，可以在合适的时候调用此方法
      */
     render(): void;
     /**
@@ -180,6 +184,7 @@ export declare class XGantt {
      * 同一个事件注册多个，只会执行最后一个监听器。
      *
      * 支持的事件类型包括：
+     * - `loaded`: 加载完成事件，组件初始化完成后触发
      * - `error`: 错误事件，当组件发生错误时触发
      * - `update:link`: 关联线更新事件
      * - `create:link`: 关联线创建事件

package/types/event/index.d.ts

@@ -24,6 +24,7 @@ export declare class EventBus {
     offAll(): void;
 }
 export declare enum EventName {
+    LOADED = "loaded",
     COLUMN_WIDTH_CHANGE = "column-width-change",
     MOVE_GUIDELINE = "move-guideline",
     SHOW_GUIDELINE = "show-guideline",
@@ -48,6 +49,7 @@ export declare enum EventName {
     SLIDER_CLICK = "slider-click",
     SLIDER_DBL_CLICK = "slider-dbl-click",
     SLIDER_CONTEXTMENU = "slider-contextmenu",
+    SLIDER_MOVING = "slider-moving",
     ROW_HIGHLIGHT = "row-highlight",
     ROW_UNHIGHLIGHT = "row-unhighlight",
     TASK_DRAG_START = "task-drag-start",
@@ -57,9 +59,9 @@ export declare enum EventName {
 }
 export declare enum ErrorType {
     /** 连线不被允许 */
-    LINK_NOT_ALLOWED = "link:not-allowed",
+    LINK_NOT_ALLOWED = "LINK_NOT_ALLOWED",
     /** 相同节点 */
-    LINK_SAME = "link:same",
+    LINK_SAME = "LINK_SAME",
     /** 当前关联已存在 */
-    LINK_EXIST = "link:exist"
+    LINK_EXIST = "LINK_EXIST"
 }

package/types/index.d.ts

@@ -8,5 +8,6 @@ export declare const version: string;
 import type { IOptions, IOptionConfig, EmitData } from "./types";
 import type { EventMap } from "./types/event";
 import type { ILink } from "./types/link";
-import { ErrorType } from "./event";
-export type { IOptions, IOptionConfig, EmitData, EventMap, ILink, ErrorType };
+import type { ErrorType } from "./event";
+import type { XGanttUnit } from "./types/options";
+export type { IOptions, IOptionConfig, EmitData, EventMap, ILink, ErrorType, XGanttUnit };

package/types/rendering/Renderer.d.ts

@@ -14,6 +14,7 @@ export declare class Renderer {
     private _id;
     private width;
     private height;
+    private isInitialized;
     getScrollbar(): Scrollbar;
     constructor(context: IContext, // 渲染器上下文
     container: HTMLElement);

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

@@ -10,6 +10,7 @@ export declare class LinkGroup {
     private linksGroup;
     private templateArrow;
     private isDragging;
+    private isSliderMoving;
     private selectedMap;
     private width;
     private height;
@@ -48,6 +49,7 @@ export declare class LinkGroup {
      * 计算关联线位置
      */
     private calculateLinks;
+    private createId;
     /** 生成 FS 连线 */
     private createFS;
     /** 生成 FF 连线 */

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

@@ -41,7 +41,7 @@ export declare class TableRow {
     /**
      * 更新行
      */
-    update(): void;
+    update(task: Task): void;
     /**
      * 更新宽度
      */

package/types/types/event.d.ts

@@ -2,6 +2,7 @@ import { ErrorType } from "../event";
 import { ILink } from "./link";
 
 export interface EventMap {
+  loaded: () => void;
   error: (error: ErrorType) => void;
   "update:link": (link: ILink) => void;
   "create:link": (link: ILink) => void;

package/types/types/options.d.ts

@@ -1,5 +1,6 @@
 import { EmitData } from ".";
 import { IChartOptions } from "./chart";
+import { ILink } from "./link";
 import { IPattern } from "./styles";
 import { ITableOptions } from "./table";
 
@@ -85,7 +86,11 @@ export interface IGanttOptions {
        * @argument {"S"} - 允许以 S，也就是左侧起始点作为终点创建连线
        * @argument {"F"} - 允许以 F，也就是右侧结束点作为终点创建连线
        */
-      to: boolean | "S" | "F" | ((row: EmitData) => boolean | "S" | "F");
+      to:
+        | boolean
+        | "S"
+        | "F"
+        | ((row: EmitData, from: EmitData) => boolean | "S" | "F");
     };
     /** 默认关连线的颜色。每一条线可以单独配置后覆盖当前颜色。默认主色 */
     color?: string;
@@ -348,7 +353,7 @@ export interface IGanttOptions {
          *
          * - none: 不联动
          * - scale: 按比例缩放。按照伸缩比例进行联动
-         * - fixed: 按固定值缩放。进针对两边超出进行缩放
+         * - fixed: 按固定值缩放。仅针对两边超出进行缩放
          */
         child: "none" | "scale" | "fixed";
         /**
@@ -505,11 +510,13 @@ export interface IGanttOptions {
     /**
      * 配置节假日期。可以针对不同节假日配置不同的背景颜色。默认使用统一配置颜色
      */
-    holidays?: Array<{
-      date: Date | number | string | Array<Date | number | string>;
-      backgroundColor?: string;
-      opacity?: number;
-    }>;
+    holidays?: Array<
+      {
+        date: Date | number | string | Array<Date | number | string>;
+        backgroundColor?: string;
+        opacity?: number;
+      } & IPattern
+    >;
   } & IPattern;
 
   /** 滚动条配置 */

package/types/types/table.d.ts

@@ -61,7 +61,7 @@ export interface ITableColumnStandard {
    */
   merge?: (
     value: any,
-    row: any,
+    data: any,
     colIndex: number,
     level: number
   ) => { col: number; row: number } | undefined;