ct-gantt-core 1.0.1

package/dist/index.d.cts

@@ -0,0 +1,235 @@
+type ViewMode = "day" | "week" | "month" | "quarter" | "year";
+type LinkType = "FS" | "SS" | "FF" | "SF";
+type LagUnit = "calendar" | "working";
+type Result<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: GanttError;
+};
+interface GanttError {
+    code: "CYCLE_DEPENDENCY" | "INVALID_DATE" | "MISSING_TASK" | "ORPHAN_DEPENDENCY" | "INVALID_DEPENDENCY";
+    message: string;
+    details?: unknown;
+}
+interface DateRange {
+    start: string | Date;
+    end: string | Date;
+    progress?: number;
+}
+interface Dependency {
+    id?: string;
+    predecessorId: string;
+    type: LinkType;
+    lag: number;
+    lagUnit: LagUnit;
+}
+interface GanttTask {
+    id: string;
+    name: string;
+    type: "task" | "milestone" | "summary";
+    plan: DateRange;
+    actual: Required<DateRange>;
+    dependencies?: Dependency[];
+    parentId?: string | null;
+    color?: string;
+    planColor?: string;
+    calendarId?: string;
+    resources?: string[];
+    segments?: Array<{
+        start: string | Date;
+        end: string | Date;
+    }>;
+    constraint?: {
+        type: "SNET" | "SNLT" | "MSO" | "MFO" | "ASAP" | "ALAP";
+        date?: string | Date;
+    };
+    schedulingMode?: "auto" | "manual";
+    duration?: number;
+    custom?: Record<string, unknown>;
+}
+interface GanttMarker {
+    id: string;
+    name: string;
+    date: string | Date;
+    color?: string;
+}
+interface GanttEditorField {
+    key: string;
+    label: string;
+    visible?: boolean;
+    editable?: boolean;
+    type?: "text" | "number" | "date" | "select";
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    placeholder?: string;
+}
+interface CustomColumn {
+    key: string;
+    label: string;
+    width?: number;
+    visible?: boolean;
+    align?: "left" | "center" | "right";
+    editable?: boolean;
+    type?: "text" | "number" | "date" | "select";
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    placeholder?: string;
+    editor?: Omit<GanttEditorField, "key" | "label">;
+    formatter?: (value: unknown, task: GanttTask) => string;
+    cellClass?: string | ((task: GanttTask) => string);
+    cellStyle?: Record<string, string | number> | ((task: GanttTask) => Record<string, string | number>);
+    render?: (task: GanttTask) => {
+        text: string;
+        className?: string;
+    };
+}
+interface GanttConfig {
+    viewMode: ViewMode;
+    rowHeight: number;
+    columnWidth: number;
+    headerHeight: number;
+    taskListWidth: number;
+    width?: string | number;
+    height?: string | number;
+    locale: string;
+    firstDayOfWeek: 0 | 1;
+    dateFormat: string;
+    customColumns?: CustomColumn[];
+    columns?: CustomColumn[];
+    editorFields?: GanttEditorField[];
+    columnWidths?: Partial<Record<ViewMode, number>>;
+    theme?: "light" | "dark" | string;
+    visibleRange?: {
+        start: string | Date;
+        end: string | Date;
+    };
+    showPlanBar?: boolean;
+    showActualBar?: boolean;
+    showTimelineWhenEmpty?: boolean;
+    builtInTaskEditor?: boolean;
+    builtInMarkerEditor?: boolean;
+    editablePlan?: boolean;
+    editableActual?: boolean;
+    enableLinkCreation?: boolean;
+    showLinkRejectionNotice?: boolean;
+    virtualScroll?: boolean;
+    taskColors?: {
+        task?: string;
+        summary?: string;
+        milestone?: string;
+        plan?: string;
+        progress?: string;
+    };
+    autoSchedule?: boolean;
+    editable?: boolean;
+}
+interface GanttLink {
+    id: string;
+    sourceId: string;
+    targetId: string;
+    type: LinkType;
+    lag?: number;
+    lagUnit?: LagUnit;
+}
+interface TaskLayout {
+    taskId: string;
+    rowIndex: number;
+    left: number;
+    width: number;
+    top: number;
+    depth: number;
+    isCritical: boolean;
+}
+interface FlatTask {
+    task: GanttTask;
+    depth: number;
+    rowIndex: number;
+    hasChildren: boolean;
+    collapsed: boolean;
+}
+interface Calendar {
+    id: string;
+    workingDays: number[];
+    holidays: string[];
+    hours: [number, number][];
+}
+interface TimeScale {
+    start: Date;
+    end: Date;
+    left: number;
+    width: number;
+}
+interface Viewport {
+    scrollTop: number;
+    scrollLeft: number;
+    clientWidth: number;
+    clientHeight: number;
+    dpr: number;
+}
+interface AffectedTasks {
+    changed: Array<{
+        taskId: string;
+        actualStart: string | Date;
+        actualEnd: string | Date;
+        rowIndex: number;
+    }>;
+    conflicts: Array<{
+        taskId: string;
+        constraintType: string;
+        message: string;
+    }>;
+}
+interface PatchTask {
+    planStart?: string | Date;
+    planEnd?: string | Date;
+    actualStart?: string | Date;
+    actualEnd?: string | Date;
+    progress?: number;
+    name?: string;
+    type?: GanttTask["type"];
+    parentId?: string | null;
+    color?: string;
+    planColor?: string;
+    duration?: number;
+    schedulingMode?: "auto" | "manual";
+    resources?: string[];
+    calendarId?: string;
+    custom?: Record<string, unknown>;
+}
+declare const defaultConfig: GanttConfig;
+
+declare function checkCyclicDependency(links: GanttLink[]): {
+    hasCycle: boolean;
+    cyclePath?: string[];
+};
+
+declare function normalizeLinks(tasks: GanttTask[], standaloneLinks?: GanttLink[]): GanttLink[];
+
+declare function flattenTasks(tasks: GanttTask[], collapsedIds?: Set<string>): FlatTask[];
+
+declare function computeTimeScale(start: Date, end: Date, viewMode: ViewMode, columnWidth: number, firstDayOfWeek: 0 | 1): TimeScale[];
+
+declare function computeLayout(tasks: GanttTask[], links: GanttLink[], config: Partial<GanttConfig>, collapsedIds?: Set<string>, viewport?: Viewport): Result<TaskLayout[]>;
+
+declare function computeImpact(taskId: string, patch: PatchTask, tasks: GanttTask[], links: GanttLink[], config: Partial<GanttConfig>): Result<AffectedTasks>;
+
+declare function scheduleByDependencies(tasks: GanttTask[], links: GanttLink[]): Result<GanttTask[]>;
+declare function shiftTask(task: GanttTask, start: string | Date): GanttTask;
+
+declare const DAY_MS: number;
+declare function toDate(value: string | Date): Date;
+declare function startOfDay(date: Date): Date;
+declare function addDays(date: string | Date, days: number): Date;
+declare function diffDays(start: string | Date, end: string | Date): number;
+declare function inclusiveDays(start: string | Date, end: string | Date): number;
+declare function isValidDate(value: string | Date): boolean;
+declare function formatDate(date: string | Date): string;
+declare function resultInvalidDate<T>(message: string, details?: unknown): Result<T>;
+
+export { type AffectedTasks, type Calendar, type CustomColumn, DAY_MS, type DateRange, type Dependency, type FlatTask, type GanttConfig, type GanttEditorField, type GanttError, type GanttLink, type GanttMarker, type GanttTask, type LagUnit, type LinkType, type PatchTask, type Result, type TaskLayout, type TimeScale, type ViewMode, type Viewport, addDays, checkCyclicDependency, computeImpact, computeLayout, computeTimeScale, defaultConfig, diffDays, flattenTasks, formatDate, inclusiveDays, isValidDate, normalizeLinks, resultInvalidDate, scheduleByDependencies, shiftTask, startOfDay, toDate };

package/dist/index.d.ts

@@ -0,0 +1,235 @@
+type ViewMode = "day" | "week" | "month" | "quarter" | "year";
+type LinkType = "FS" | "SS" | "FF" | "SF";
+type LagUnit = "calendar" | "working";
+type Result<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: GanttError;
+};
+interface GanttError {
+    code: "CYCLE_DEPENDENCY" | "INVALID_DATE" | "MISSING_TASK" | "ORPHAN_DEPENDENCY" | "INVALID_DEPENDENCY";
+    message: string;
+    details?: unknown;
+}
+interface DateRange {
+    start: string | Date;
+    end: string | Date;
+    progress?: number;
+}
+interface Dependency {
+    id?: string;
+    predecessorId: string;
+    type: LinkType;
+    lag: number;
+    lagUnit: LagUnit;
+}
+interface GanttTask {
+    id: string;
+    name: string;
+    type: "task" | "milestone" | "summary";
+    plan: DateRange;
+    actual: Required<DateRange>;
+    dependencies?: Dependency[];
+    parentId?: string | null;
+    color?: string;
+    planColor?: string;
+    calendarId?: string;
+    resources?: string[];
+    segments?: Array<{
+        start: string | Date;
+        end: string | Date;
+    }>;
+    constraint?: {
+        type: "SNET" | "SNLT" | "MSO" | "MFO" | "ASAP" | "ALAP";
+        date?: string | Date;
+    };
+    schedulingMode?: "auto" | "manual";
+    duration?: number;
+    custom?: Record<string, unknown>;
+}
+interface GanttMarker {
+    id: string;
+    name: string;
+    date: string | Date;
+    color?: string;
+}
+interface GanttEditorField {
+    key: string;
+    label: string;
+    visible?: boolean;
+    editable?: boolean;
+    type?: "text" | "number" | "date" | "select";
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    placeholder?: string;
+}
+interface CustomColumn {
+    key: string;
+    label: string;
+    width?: number;
+    visible?: boolean;
+    align?: "left" | "center" | "right";
+    editable?: boolean;
+    type?: "text" | "number" | "date" | "select";
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    placeholder?: string;
+    editor?: Omit<GanttEditorField, "key" | "label">;
+    formatter?: (value: unknown, task: GanttTask) => string;
+    cellClass?: string | ((task: GanttTask) => string);
+    cellStyle?: Record<string, string | number> | ((task: GanttTask) => Record<string, string | number>);
+    render?: (task: GanttTask) => {
+        text: string;
+        className?: string;
+    };
+}
+interface GanttConfig {
+    viewMode: ViewMode;
+    rowHeight: number;
+    columnWidth: number;
+    headerHeight: number;
+    taskListWidth: number;
+    width?: string | number;
+    height?: string | number;
+    locale: string;
+    firstDayOfWeek: 0 | 1;
+    dateFormat: string;
+    customColumns?: CustomColumn[];
+    columns?: CustomColumn[];
+    editorFields?: GanttEditorField[];
+    columnWidths?: Partial<Record<ViewMode, number>>;
+    theme?: "light" | "dark" | string;
+    visibleRange?: {
+        start: string | Date;
+        end: string | Date;
+    };
+    showPlanBar?: boolean;
+    showActualBar?: boolean;
+    showTimelineWhenEmpty?: boolean;
+    builtInTaskEditor?: boolean;
+    builtInMarkerEditor?: boolean;
+    editablePlan?: boolean;
+    editableActual?: boolean;
+    enableLinkCreation?: boolean;
+    showLinkRejectionNotice?: boolean;
+    virtualScroll?: boolean;
+    taskColors?: {
+        task?: string;
+        summary?: string;
+        milestone?: string;
+        plan?: string;
+        progress?: string;
+    };
+    autoSchedule?: boolean;
+    editable?: boolean;
+}
+interface GanttLink {
+    id: string;
+    sourceId: string;
+    targetId: string;
+    type: LinkType;
+    lag?: number;
+    lagUnit?: LagUnit;
+}
+interface TaskLayout {
+    taskId: string;
+    rowIndex: number;
+    left: number;
+    width: number;
+    top: number;
+    depth: number;
+    isCritical: boolean;
+}
+interface FlatTask {
+    task: GanttTask;
+    depth: number;
+    rowIndex: number;
+    hasChildren: boolean;
+    collapsed: boolean;
+}
+interface Calendar {
+    id: string;
+    workingDays: number[];
+    holidays: string[];
+    hours: [number, number][];
+}
+interface TimeScale {
+    start: Date;
+    end: Date;
+    left: number;
+    width: number;
+}
+interface Viewport {
+    scrollTop: number;
+    scrollLeft: number;
+    clientWidth: number;
+    clientHeight: number;
+    dpr: number;
+}
+interface AffectedTasks {
+    changed: Array<{
+        taskId: string;
+        actualStart: string | Date;
+        actualEnd: string | Date;
+        rowIndex: number;
+    }>;
+    conflicts: Array<{
+        taskId: string;
+        constraintType: string;
+        message: string;
+    }>;
+}
+interface PatchTask {
+    planStart?: string | Date;
+    planEnd?: string | Date;
+    actualStart?: string | Date;
+    actualEnd?: string | Date;
+    progress?: number;
+    name?: string;
+    type?: GanttTask["type"];
+    parentId?: string | null;
+    color?: string;
+    planColor?: string;
+    duration?: number;
+    schedulingMode?: "auto" | "manual";
+    resources?: string[];
+    calendarId?: string;
+    custom?: Record<string, unknown>;
+}
+declare const defaultConfig: GanttConfig;
+
+declare function checkCyclicDependency(links: GanttLink[]): {
+    hasCycle: boolean;
+    cyclePath?: string[];
+};
+
+declare function normalizeLinks(tasks: GanttTask[], standaloneLinks?: GanttLink[]): GanttLink[];
+
+declare function flattenTasks(tasks: GanttTask[], collapsedIds?: Set<string>): FlatTask[];
+
+declare function computeTimeScale(start: Date, end: Date, viewMode: ViewMode, columnWidth: number, firstDayOfWeek: 0 | 1): TimeScale[];
+
+declare function computeLayout(tasks: GanttTask[], links: GanttLink[], config: Partial<GanttConfig>, collapsedIds?: Set<string>, viewport?: Viewport): Result<TaskLayout[]>;
+
+declare function computeImpact(taskId: string, patch: PatchTask, tasks: GanttTask[], links: GanttLink[], config: Partial<GanttConfig>): Result<AffectedTasks>;
+
+declare function scheduleByDependencies(tasks: GanttTask[], links: GanttLink[]): Result<GanttTask[]>;
+declare function shiftTask(task: GanttTask, start: string | Date): GanttTask;
+
+declare const DAY_MS: number;
+declare function toDate(value: string | Date): Date;
+declare function startOfDay(date: Date): Date;
+declare function addDays(date: string | Date, days: number): Date;
+declare function diffDays(start: string | Date, end: string | Date): number;
+declare function inclusiveDays(start: string | Date, end: string | Date): number;
+declare function isValidDate(value: string | Date): boolean;
+declare function formatDate(date: string | Date): string;
+declare function resultInvalidDate<T>(message: string, details?: unknown): Result<T>;
+
+export { type AffectedTasks, type Calendar, type CustomColumn, DAY_MS, type DateRange, type Dependency, type FlatTask, type GanttConfig, type GanttEditorField, type GanttError, type GanttLink, type GanttMarker, type GanttTask, type LagUnit, type LinkType, type PatchTask, type Result, type TaskLayout, type TimeScale, type ViewMode, type Viewport, addDays, checkCyclicDependency, computeImpact, computeLayout, computeTimeScale, defaultConfig, diffDays, flattenTasks, formatDate, inclusiveDays, isValidDate, normalizeLinks, resultInvalidDate, scheduleByDependencies, shiftTask, startOfDay, toDate };