@baishuyun/ui-base 6.3.2 → 6.4.0

package/dist/components/Gantt/GanttTable/utils/mapGanttColumns.d.ts

@@ -0,0 +1,13 @@
+import { GanttColumn, GanttDataItem } from '../../interface';
+type MappedTableColumn = {
+    key: string;
+    title: string;
+    width: number;
+    align?: GanttColumn['align'];
+    className?: string;
+    fixed?: GanttColumn['fixed'];
+    render: (value: unknown, record: GanttDataItem, rowIndex: number) => unknown;
+    children?: MappedTableColumn[];
+};
+export declare function mapGanttColumns<T extends GanttDataItem>(columns?: GanttColumn<T>[]): MappedTableColumn[];
+export {};

package/dist/components/Gantt/GanttToolBar/GanttToolBar.d.ts

@@ -0,0 +1,3 @@
+import { GanttToolBarProps } from '../types.internal';
+declare const GanttToolBar: ({ viewMode, availableModes, onViewModeChange, onTodayClick, onScrollPrev, onScrollNext, className, }: GanttToolBarProps) => import("react/jsx-runtime").JSX.Element;
+export default GanttToolBar;

package/dist/components/Gantt/GanttToolBar/index.d.ts

@@ -0,0 +1 @@
+export { default } from './GanttToolBar';

package/dist/components/Gantt/__tests__/GanttSummaryBar.tooltip.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Gantt/__tests__/GanttToolBar.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Gantt/__tests__/filterItemsByCollapse.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Gantt/__tests__/helpers/ganttDomSetup.d.ts

@@ -0,0 +1 @@
+export declare const installGanttDomMocks: () => void;

package/dist/components/Gantt/__tests__/helpers/ganttTestFixtures.d.ts

@@ -0,0 +1,7 @@
+import { GanttDataItem, GanttMode } from '../../interface';
+import { GanttTimelineContextValue, NormalizedGanttItem } from '../../types.internal';
+export declare const makeGanttTask: (overrides?: Partial<GanttDataItem>) => GanttDataItem;
+export declare const makeGanttSummary: (overrides?: Partial<GanttDataItem>) => GanttDataItem;
+export declare const makeNormalizedGanttItem: (overrides?: Partial<NormalizedGanttItem>) => NormalizedGanttItem;
+export declare const makeTimelineContextValue: (overrides?: Partial<GanttTimelineContextValue>) => GanttTimelineContextValue;
+export declare const SUB_DAY_CELL_WIDTH_PX: Record<Extract<GanttMode, 'halfDay' | 'sixHour' | 'hour' | 'halfHour' | 'tenMinute' | 'oneMinute'>, number>;

package/dist/components/Gantt/__tests__/helpers/ganttTestMocks.d.ts

@@ -0,0 +1,8 @@
+export declare let mockSize: {
+    width: number;
+    height: number;
+};
+export declare const setMockSize: (size: {
+    width: number;
+    height: number;
+}) => void;

package/dist/components/Gantt/__tests__/helpers/renderWithLocale.d.ts

@@ -0,0 +1,3 @@
+import { RenderOptions, RenderResult } from '@testing-library/react';
+import { ReactElement } from 'react';
+export declare const renderWithLocale: (ui: ReactElement, options?: RenderOptions) => RenderResult;

package/dist/components/Gantt/__tests__/helpers/testFormatMessage.d.ts

@@ -0,0 +1,2 @@
+import { GanttFormatMessage } from '../../types.internal';
+export declare const testFormatMessage: GanttFormatMessage;

package/dist/components/Gantt/__tests__/interface.contract.types.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Gantt/__tests__/timezoneUtils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Gantt/__tests__/useBarTooltipHover.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Gantt/__tests__/useGanttHighlight.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Gantt/__tests__/useTaskBarPointer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Gantt/hooks/useGanttCollapseState.d.ts

@@ -0,0 +1,6 @@
+import { UseGanttCollapseStateOptions } from '../types.internal';
+export declare function useGanttCollapseState({ collapsedKeys, onToggleCollapse, }?: UseGanttCollapseStateOptions): {
+    collapsedKeys: import('..').GanttCollapsedKeys | null;
+    onToggleCollapse: (groupKey: string) => void;
+    isControlled: boolean;
+};

package/dist/components/Gantt/hooks/useGanttHighlight.d.ts

@@ -0,0 +1,10 @@
+import { HighlightTarget } from '../interface';
+import { GanttHighlightContextValue } from '../types.internal';
+export declare function useGanttHighlight(): {
+    highlightContextValue: GanttHighlightContextValue;
+    setHighlightTarget: (target: HighlightTarget, options?: {
+        source?: string;
+    }) => void;
+    setTableHighlightTarget: (target: HighlightTarget) => void;
+    notifyScrollActivity: () => void;
+};

package/dist/components/Gantt/hooks/useGanttLayout.d.ts

@@ -0,0 +1,7 @@
+import { UseGanttLayoutOptions } from '../types.internal';
+export declare function useGanttLayout({ id }?: UseGanttLayoutOptions): {
+    containerRef: import('react').RefObject<HTMLDivElement>;
+    resolvedTableWidth: number;
+    handleTableWidthChange: (nextWidth: number) => void;
+    handleResizeEnd: (nextWidth: number) => void;
+};

package/dist/components/Gantt/hooks/useLinkedVerticalScroll.d.ts

@@ -0,0 +1,6 @@
+import { VerticalScrollController } from '../types.internal';
+interface UseLinkedVerticalScrollOptions {
+    onScrollActivity?: () => void;
+}
+export declare function useLinkedVerticalScroll(options?: UseLinkedVerticalScrollOptions): VerticalScrollController;
+export {};

package/dist/components/Gantt/index.d.ts

@@ -0,0 +1,9 @@
+export { default } from './Gantt';
+export type { GanttProps, GanttDataItem, GanttTaskItem, GanttSummaryItem, GanttColumn, GanttMode, GanttCalendarMode, GanttSubDayMode, GanttTimeInput, GanttDragPermission, GanttTaskTimeChangePayload, GanttCalendarTaskTimeChangePayload, GanttSubDayTaskTimeChangePayload, GanttChangeType, GanttTableSlotContext, GanttCollapseProps, GanttCollapsedKeys, HighlightTarget, HighlightTargetType, } from './interface';
+export { ALL_GANTT_MODES, CALENDAR_TIER_MODES, DEFAULT_GANTT_MODE } from './interface';
+export { GANTT_DEFAULT_ROW_HEIGHT, GANTT_TABLE_HEADER_ROW_SPAN, DRAG_MODE_MOVE, DRAG_MODE_RESIZE_START, DRAG_MODE_RESIZE_END, EMPTY_GROUP_VALUE, } from './GanttChart/utils/constants';
+export { isGroupCollapsed } from './utils/collapseKeys';
+export { isHighlightMatch } from './utils/highlightTarget';
+export { useGanttTableColumnResize } from './utils/columnResize';
+export { normalizeTaskDateRange } from './GanttChart/utils/dateRangeNormalizer';
+export { isSubDayViewMode } from './GanttChart/utils/timelineViewConfig';

package/dist/components/Gantt/interface.d.ts

@@ -0,0 +1,140 @@
+import { CSSProperties, MouseEvent, ReactNode } from 'react';
+/** 日历档 viewMode（粗）——单一来源 */
+export declare const CALENDAR_TIER_MODES: readonly ["day", "week", "month", "quarter", "quarterMonth", "year"];
+/** 亚日档 viewMode（细）——单一来源 */
+export declare const SUB_DAY_MODES: readonly ["halfDay", "sixHour", "hour", "halfHour", "tenMinute", "oneMinute"];
+/** 12 档全集；GanttMode 由此推导，禁止另写字面量联合 */
+export declare const ALL_GANTT_MODES: readonly ["day", "week", "month", "quarter", "quarterMonth", "year", "halfDay", "sixHour", "hour", "halfHour", "tenMinute", "oneMinute"];
+export type GanttMode = (typeof ALL_GANTT_MODES)[number];
+export type GanttCalendarMode = (typeof CALENDAR_TIER_MODES)[number];
+export type GanttSubDayMode = (typeof SUB_DAY_MODES)[number];
+/** 工具栏展示顺序：亚日（细）→ 年（粗） */
+export declare const GANTT_MODE_DISPLAY_ORDER: readonly [...("oneMinute" | "tenMinute" | "halfHour" | "hour" | "sixHour" | "halfDay")[], "day", "week", "month", "quarter", "quarterMonth", "year"];
+export declare const DEFAULT_GANTT_MODE: GanttMode;
+export declare function isGanttMode(mode: string): mode is GanttMode;
+export declare function isCalendarViewMode(mode: GanttMode): mode is GanttCalendarMode;
+export declare function isSubDayMode(mode: GanttMode): mode is GanttSubDayMode;
+export type GanttTimeInput = string | number | Date | null;
+export interface GanttDragPermission {
+    canMove?: boolean;
+    canResizeStart?: boolean;
+    canResizeEnd?: boolean;
+}
+/** 任务 / 汇总共用字段；meta 仅透传，Gantt 禁止读取 */
+interface GanttDataItemBase {
+    id?: string | number;
+    start: GanttTimeInput;
+    end: GanttTimeInput;
+    label?: ReactNode;
+    progress?: number | null;
+    color?: string;
+    parentId?: string | number;
+    recordId?: string | number;
+    groupKey?: string | number;
+    depth?: number;
+    meta?: unknown;
+}
+/** 可拖拽任务行 */
+export interface GanttTaskItem extends GanttDataItemBase {
+    type: 'task';
+    draggable?: boolean;
+    dragPermission?: GanttDragPermission;
+}
+/** 分组汇总行（不可拖） */
+export interface GanttSummaryItem extends GanttDataItemBase {
+    type: 'summary';
+}
+/** 消费方传入的原始行（可辨识联合） */
+export type GanttDataItem = GanttTaskItem | GanttSummaryItem;
+export type GanttChangeType = 'move' | 'resize-start' | 'resize-end';
+interface GanttTaskTimeChangePayloadBase {
+    taskId: string;
+    newStart: number;
+    newEnd: number;
+    changeType: GanttChangeType;
+    /** 拖拽 snap 步长（ms） */
+    snapUnitMs: number;
+    /** 相对原点的毫秒位移 */
+    deltaMs: number;
+}
+/** 日历档改期载荷：viewMode 与 deltaDays 成对出现 */
+export interface GanttCalendarTaskTimeChangePayload extends GanttTaskTimeChangePayloadBase {
+    viewMode: GanttCalendarMode;
+    deltaDays: number;
+}
+/** 亚日档改期载荷：不含 deltaDays */
+export interface GanttSubDayTaskTimeChangePayload extends GanttTaskTimeChangePayloadBase {
+    viewMode: GanttSubDayMode;
+}
+/** 改期回调载荷（按 viewMode 可辨识联合） */
+export type GanttTaskTimeChangePayload = GanttCalendarTaskTimeChangePayload | GanttSubDayTaskTimeChangePayload;
+export interface GanttColumn<T extends GanttDataItem = GanttDataItem> {
+    key: string;
+    title?: ReactNode;
+    dataIndex?: string;
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    align?: 'left' | 'center' | 'right';
+    className?: string;
+    fixed?: 'left' | 'right';
+    children?: GanttColumn<T>[];
+    render?: (ctx: {
+        item: T;
+        rowIndex: number;
+        column: GanttColumn<T>;
+        value: unknown;
+    }) => ReactNode;
+}
+export type HighlightTargetType = 'record' | 'group';
+export type HighlightTarget = {
+    type: HighlightTargetType;
+    id: string;
+} | null;
+export type GanttCollapsedKeys = ReadonlySet<string> | string[];
+export interface GanttTableSlotContext<T extends GanttDataItem = GanttDataItem> {
+    columns?: GanttColumn<T>[];
+    tableData: unknown[];
+    setHighlightTarget: (target: HighlightTarget) => void;
+    rowHeight: number;
+    collapsedKeys?: GanttCollapsedKeys;
+    onToggleCollapse?: (groupKey: string) => void | Promise<void>;
+}
+type GanttPropsBase<T extends GanttDataItem = GanttDataItem> = {
+    data: T[];
+    columns?: GanttColumn<T>[];
+    mode?: GanttMode;
+    availableModes?: GanttMode[];
+    onModeChange?: (mode: GanttMode) => void;
+    id?: string;
+    onRowClick?: (item: T, rowIndex: number, event: MouseEvent) => void;
+    onTaskTimeChange?: (payload: GanttTaskTimeChangePayload) => void | Promise<void>;
+    tooltip?: (item: T) => ReactNode;
+    className?: string;
+    style?: CSSProperties;
+    tableData?: unknown[];
+    renderTable?: (ctx: GanttTableSlotContext<T>) => ReactNode;
+    emptyOverlay?: ReactNode;
+};
+/** 受控折叠：必须同时提供 keys 与 toggle，否则点击后无法回写 */
+type GanttCollapseControlled = {
+    collapsedKeys: GanttCollapsedKeys;
+    onToggleCollapse: (groupKey: string) => void | Promise<void>;
+};
+/** 非受控折叠：不传 collapsedKeys；onToggleCollapse 仅作通知（可选） */
+type GanttCollapseUncontrolled = {
+    collapsedKeys?: undefined;
+    onToggleCollapse?: (groupKey: string) => void | Promise<void>;
+};
+export type GanttCollapseProps = GanttCollapseControlled | GanttCollapseUncontrolled;
+/** 公开组件契约：基础 props + 折叠状态机 */
+export type GanttProps<T extends GanttDataItem = GanttDataItem> = GanttPropsBase<T> & GanttCollapseProps;
+/**
+ * 内部编排层 props：折叠字段解构后会丢失联合相关性，故用宽松形态。
+ * 运行时仍以 `collapsedKeys !== undefined` 判定受控。
+ */
+export type GanttLayoutInputProps<T extends GanttDataItem = GanttDataItem> = GanttPropsBase<T> & {
+    collapsedKeys?: GanttCollapsedKeys;
+    onToggleCollapse?: (groupKey: string) => void | Promise<void>;
+};
+export {};

package/dist/components/Gantt/internal/GanttLayout.d.ts

@@ -0,0 +1,8 @@
+import { ForwardedRef, Ref } from 'react';
+import { GanttDataItem } from '../interface';
+import { GanttLayoutProps } from '../types.internal';
+declare function GanttLayoutInner<T extends GanttDataItem>({ data, tableData, columns, mode: modeProp, availableModes, onModeChange, id, onRowClick, onTaskTimeChange, tooltip, className, style, renderTable, collapsedKeys, onToggleCollapse, emptyOverlay, }: GanttLayoutProps<T>, ref: ForwardedRef<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
+declare const GanttLayout: <T extends GanttDataItem = GanttDataItem>(props: GanttLayoutProps<T> & {
+    ref?: Ref<HTMLDivElement>;
+}) => ReturnType<typeof GanttLayoutInner>;
+export default GanttLayout;

package/dist/components/Gantt/internal/GanttTableShell.d.ts

@@ -0,0 +1,3 @@
+import { GanttTableShellProps } from '../types.internal';
+declare const GanttTableShell: import('react').ForwardRefExoticComponent<GanttTableShellProps & import('react').RefAttributes<HTMLDivElement>>;
+export default GanttTableShell;

package/dist/components/Gantt/types.internal.d.ts

@@ -0,0 +1,313 @@
+import { MouseEvent, MutableRefObject, ReactNode, RefObject } from 'react';
+import { VirtualItem } from '@tanstack/react-virtual';
+import { LocaleParams } from '../../locale/formatLocaleMessage';
+import { GanttChangeType, GanttCollapsedKeys, GanttColumn, GanttDataItem, GanttLayoutInputProps, GanttMode, GanttProps, HighlightTarget } from './interface';
+/** 运行时允许 null/undefined；公开受控契约见 GanttCollapsedKeys */
+export type CollapsedKeys = GanttCollapsedKeys | undefined | null;
+export type GanttFormatMessage = (key: string, params?: LocaleParams) => string;
+export interface ResolvedDragPermission {
+    canMove: boolean;
+    canResizeStart: boolean;
+    canResizeEnd: boolean;
+}
+export interface TimelineCoords {
+    toX: (ms: number) => number;
+    toWidth: (startMs: number, endMs: number) => number;
+    timeAtX: (x: number) => number;
+}
+export interface TimelineViewConfig {
+    tier: 'calendar' | 'subDay';
+    headerLayout: 'flat' | 'quarterNested' | 'dayNested' | 'hourNested';
+    topGroup: string;
+    bottomCellMs: number;
+    snapUnitMs: number;
+    bottomCellWidthPx?: number;
+}
+export interface TimeRangeConfig {
+    bufferDaysBefore?: number;
+    bufferDaysAfter?: number;
+}
+export type PixelsPerDayConfig = Partial<Record<GanttMode, number>>;
+export interface TimelineSegment {
+    id: string;
+    startMs: number;
+    endMs: number;
+    left: number;
+    width: number;
+    label: string;
+}
+export type LowerSegment = TimelineSegment;
+export interface TopSegment {
+    id: string;
+    left: number;
+    width: number;
+    label: string;
+}
+export interface WeekendSegment {
+    id: string;
+    left: number;
+    width: number;
+}
+export interface CommittedRange {
+    startMs: number;
+    endMs: number;
+}
+/**
+ * Chart 内部行：保留消费方扩展字段 T，收紧 id/进度/时间毫秒。
+ * 输入侧 dragPermission 经 spread 保留；已解析权限见 dragPermissionById。
+ */
+export type NormalizedGanttItem<T extends GanttDataItem = GanttDataItem> = Omit<T, 'id' | 'progress'> & {
+    id: string;
+    rowIndex: number;
+    rawStartMs: number | null;
+    rawEndMs: number | null;
+    baseStartMs: number | null;
+    baseEndMs: number | null;
+    startMs: number | null;
+    endMs: number | null;
+    invalid: boolean;
+    progress: number | null;
+};
+export interface InternalDragState {
+    taskId: string;
+    item: NormalizedGanttItem;
+    startClientX: number;
+    originLeftPx: number;
+    originStartMs: number;
+    originEndMs: number;
+    deltaUnits: number;
+    dragMode: GanttChangeType;
+    previewLeftPx: number;
+    previewStartMs: number;
+    previewEndMs: number;
+}
+/** @deprecated Use InternalDragState — kept for external references */
+export interface DragState extends InternalDragState {
+}
+export type CommittedRangeById = Record<string, CommittedRange>;
+export interface PendingDragOp {
+    opId: number;
+    startedAt: number;
+    timeoutId: ReturnType<typeof setTimeout>;
+}
+export interface VirtualColumnIndex {
+    index: number;
+}
+export interface OffscreenIndicator {
+    rowKey: string;
+    rowTop: number;
+    rowHeight: number;
+    showLeft: boolean;
+    showRight: boolean;
+    targetStartMs: number | null;
+    targetScrollLeft: number;
+}
+export interface OffscreenJumpTarget {
+    targetScrollLeft: number;
+    targetStartMs: number | null;
+}
+export interface BarTooltipHoverState {
+    x: number;
+    y: number;
+    top: number;
+    bottom: number;
+    height: number;
+}
+export interface ScrollScrollerApi {
+    setScrollTop: (top: number) => void;
+}
+export type VerticalScrollSource = 'timeline' | 'table';
+export interface VerticalScrollController {
+    registerTimelineScroller: (api: ScrollScrollerApi) => () => void;
+    registerTableScroller: (api: ScrollScrollerApi) => () => void;
+    sync: (source: VerticalScrollSource, top: number) => void;
+}
+export type HighlightListener = (target: HighlightTarget, payload?: {
+    source?: string;
+}) => void;
+export interface GanttHighlightContextValue {
+    getHighlightTarget: () => HighlightTarget;
+    setHighlightTarget: (target: HighlightTarget, options?: {
+        source?: string;
+    }) => void;
+    setTableHighlightTarget: (target: HighlightTarget) => void;
+    subscribeHighlight: (listener: HighlightListener) => () => void;
+    notifyScrollActivity: () => void;
+    getIsScrollActive: () => boolean;
+}
+export interface GanttTimelineContextValue {
+    pixelsPerDay: number;
+    timelineStartMs: number;
+    timelineCoords: TimelineCoords;
+    scrollLeft: number;
+    viewportWidth: number;
+    timelineWidth: number;
+    isInitialLayoutReady: boolean;
+}
+export interface GanttInteractionContextValue {
+    tooltip: ((item: NormalizedGanttItem) => ReactNode) | null;
+    isScrolling: boolean;
+    collapsedKeys: CollapsedKeys;
+    onBarClick: (event: MouseEvent, item: NormalizedGanttItem) => void;
+    onTaskMouseDown: (event: MouseEvent, item: NormalizedGanttItem, left: number) => void;
+    onResizeMouseDown: (event: MouseEvent, item: NormalizedGanttItem, left: number, edge: 'start' | 'end') => void;
+}
+export interface GanttChartProps<T extends GanttDataItem = GanttDataItem> {
+    items?: T[];
+    viewMode?: GanttMode;
+    availableModes?: GanttMode[];
+    onViewModeChange?: (mode: GanttMode) => void;
+    timeRangeConfig?: TimeRangeConfig;
+    pixelsPerDayConfig?: PixelsPerDayConfig;
+    onTaskTimeChange?: GanttProps<T>['onTaskTimeChange'];
+    onRowClick?: GanttProps<T>['onRowClick'];
+    tooltip?: GanttProps<T>['tooltip'];
+    verticalScrollController?: VerticalScrollController;
+    showWeekendHighlight?: boolean;
+    showTodayLine?: boolean;
+    collapsedKeys?: CollapsedKeys;
+    onToggleCollapse?: GanttProps<T>['onToggleCollapse'];
+}
+export interface GanttChartHandle {
+    scrollToToday: () => void;
+    scrollPrev: () => void;
+    scrollNext: () => void;
+}
+export interface GanttTableShellProps {
+    width?: number;
+    verticalScrollController?: VerticalScrollController;
+    dataLength?: number;
+    emptyOverlay?: ReactNode;
+    children?: ReactNode;
+}
+export type GanttLayoutProps<T extends GanttDataItem = GanttDataItem> = GanttLayoutInputProps<T>;
+export type ElementRef<T extends HTMLElement = HTMLDivElement> = RefObject<T | null> | MutableRefObject<T | null>;
+export interface GanttToolBarProps {
+    viewMode?: GanttMode;
+    availableModes?: GanttMode[];
+    onViewModeChange?: (mode: GanttMode) => void;
+    onTodayClick?: () => void;
+    onScrollPrev?: () => void;
+    onScrollNext?: () => void;
+    className?: string;
+}
+export interface GanttTimelineHeaderProps {
+    timelineWidth: number;
+    viewportWidth?: number;
+    scrollLeft: number;
+    trackRef: ElementRef<HTMLDivElement>;
+    virtualColumns: VirtualColumnIndex[];
+    lowerSegments: LowerSegment[];
+    todayLineLeft: number | null;
+    todayCenterMs: number | null;
+    showTodayLine?: boolean;
+    viewMode: GanttMode;
+    availableModes?: GanttMode[];
+    formatMessage: GanttFormatMessage;
+    onViewModeChange?: (mode: GanttMode) => void;
+    onTodayClick?: () => void;
+    onScrollPrev?: () => void;
+    onScrollNext?: () => void;
+}
+export interface GanttChartCanvasBackgroundProps {
+    canvasHeight: number;
+    weekendSegments: WeekendSegment[];
+    virtualColumns: VirtualColumnIndex[];
+    lowerSegments: LowerSegment[];
+    shouldShowTodayMarker: boolean;
+    todayLineLeft: number | null;
+}
+export interface GanttChartCanvasRowsProps {
+    virtualRows: VirtualItem[];
+    normalizedItems: NormalizedGanttItem[];
+    dragState: InternalDragState | null;
+    dragPermissionById: Record<string, ResolvedDragPermission>;
+    handleOffscreenJump: (target: OffscreenJumpTarget) => void;
+    hoverBgRef: RefObject<HTMLDivElement | null>;
+}
+export interface GanttChartCanvasProps {
+    contentRef: ElementRef<HTMLDivElement>;
+    normalizedItems: NormalizedGanttItem[];
+    safeRowHeight: number;
+    viewportHeight: number;
+    lowerSegments: LowerSegment[];
+    virtualColumns: VirtualColumnIndex[];
+    weekendSegments: WeekendSegment[];
+    dragState: InternalDragState | null;
+    dragPermissionById: Record<string, ResolvedDragPermission>;
+    tooltip?: ((item: NormalizedGanttItem) => ReactNode) | null;
+    handleTaskMouseDown: (event: MouseEvent, item: NormalizedGanttItem, left: number) => void;
+    handleResizeMouseDown: (event: MouseEvent, item: NormalizedGanttItem, left: number, edge: 'start' | 'end') => void;
+    handleBarClick: (event: MouseEvent, item: NormalizedGanttItem) => void;
+    collapsedKeys?: CollapsedKeys;
+    handleOffscreenJump: (target: OffscreenJumpTarget) => void;
+    todayLineLeft: number | null;
+    shouldShowTodayMarker: boolean;
+}
+export interface GanttTaskBarProps {
+    item: NormalizedGanttItem;
+    barTop: number;
+    dragTaskId: string | null;
+    dragPreview: InternalDragState | null;
+    dragPermission?: ResolvedDragPermission;
+}
+export interface GanttSummaryBarProps {
+    item: NormalizedGanttItem;
+    barTop: number;
+}
+export interface GanttBarTooltipProps {
+    item: NormalizedGanttItem;
+    tooltip?: ((item: NormalizedGanttItem) => ReactNode) | null;
+    disabled?: boolean;
+    children: (handlers: {
+        onMouseMove: (e: MouseEvent<HTMLDivElement>) => void;
+        onMouseLeave: () => void;
+    }) => ReactNode;
+}
+export interface GanttTableProps<T extends GanttDataItem = GanttDataItem> {
+    data?: T[];
+    columns?: GanttColumn<T>[];
+    onRowClick?: GanttProps<T>['onRowClick'];
+    rowHeight?: number;
+}
+export interface GanttResizeIndicatorProps {
+    tableWidth: number;
+    onWidthChange: (width: number) => void;
+    onResizeEnd: (width: number) => void;
+    containerRef: ElementRef<HTMLDivElement>;
+}
+export interface UseGanttDragOptions {
+    pixelsPerDay: number;
+    viewMode: GanttMode;
+    timelineCoords: TimelineCoords;
+    onTaskTimeChange?: GanttProps['onTaskTimeChange'];
+    containerRef?: ElementRef<HTMLDivElement>;
+}
+export interface UseTimelineViewportControllerOptions {
+    timeRangeConfig?: TimeRangeConfig;
+    pixelsPerDayConfig?: PixelsPerDayConfig;
+    viewMode: GanttMode;
+    contentRef: ElementRef<HTMLDivElement>;
+    contentSize?: {
+        width?: number;
+        height?: number;
+    };
+    headerTrackRef: ElementRef<HTMLDivElement>;
+    formatMessage: GanttFormatMessage;
+}
+export interface UseGanttCollapseStateOptions {
+    collapsedKeys?: CollapsedKeys;
+    onToggleCollapse?: GanttProps['onToggleCollapse'];
+}
+export interface UseGanttLayoutOptions {
+    id?: string;
+}
+export interface TodayIndicatorProps {
+    left: number;
+    height: number;
+    className?: string;
+}
+export interface OffscreenTaskIndicatorsProps {
+    indicators: OffscreenIndicator[];
+    onJump: (target: OffscreenJumpTarget) => void;
+}

package/dist/components/Gantt/utils/collapseKeys.d.ts

@@ -0,0 +1,4 @@
+import { GanttCollapsedKeys } from '../interface';
+export type CollapsedKeys = GanttCollapsedKeys | undefined | null;
+export declare function isGroupCollapsed(collapsedKeys: CollapsedKeys, groupKey: string | number | undefined | null): boolean;
+export declare function toggleCollapsedKey(collapsedKeys: CollapsedKeys, groupKey: string | number): Set<string>;

package/dist/components/Gantt/utils/columnResize.d.ts

@@ -0,0 +1,19 @@
+export declare const GANTT_TABLE_DISABLED_RESIZE_COLUMNS: string[];
+type ColumnChild = {
+    key: string;
+    width?: number;
+};
+type GanttColumn = {
+    key: string;
+    width?: number;
+    children?: ColumnChild[];
+};
+export declare function mergeColumnWidths(columns: GanttColumn[] | undefined, columnWidths: Record<string, number>): GanttColumn[] | undefined;
+/** 会话内列宽记忆（白名单导出给分组表） */
+export declare function useGanttTableColumnResize(columns: GanttColumn[]): {
+    columns: GanttColumn[];
+    onColumnResizeEnd: (columnKey: string, newWidth: number) => void;
+    resizable: boolean;
+    disabledResizeColumns: string[];
+};
+export {};

package/dist/components/Gantt/utils/constants.d.ts

@@ -0,0 +1,4 @@
+export { GANTT_DEFAULT_ROW_HEIGHT, GANTT_TABLE_HEADER_ROW_SPAN, MIN_TABLE_WIDTH, HEADER_TOP_HEIGHT, HEADER_BOTTOM_HEIGHT, } from '../GanttChart/utils/constants';
+export declare const DEFAULT_TABLE_WIDTH_FALLBACK = 333;
+export declare const TABLE_WIDTH_PLACEHOLDER = 300;
+export declare const MIN_CHART_WIDTH = 300;

package/dist/components/Gantt/utils/filterItemsByCollapse.d.ts

@@ -0,0 +1,9 @@
+import { CollapsedKeys } from './collapseKeys';
+type CollapsibleGanttItem = {
+    type?: string;
+    depth?: number;
+    groupKey?: string | number;
+};
+/** 非受控折叠：按 summary.depth 掩蔽子行 */
+export declare function filterItemsByCollapse<T extends CollapsibleGanttItem>(items: T[] | null | undefined, collapsedKeys: CollapsedKeys): T[];
+export {};

package/dist/components/Gantt/utils/highlightTarget.d.ts

@@ -0,0 +1,13 @@
+import { HighlightTarget } from '../interface';
+export type { HighlightTarget, HighlightTargetType } from '../interface';
+export declare function isSameHighlightTarget(prev: HighlightTarget | undefined, next: HighlightTarget | undefined): boolean;
+export declare function isHighlightMatch(target: HighlightTarget | undefined, current: HighlightTarget | undefined): boolean;
+type ChartHighlightItem = {
+    type?: string;
+    groupKey?: string | number;
+    parentId?: string | number;
+    recordId?: string | number;
+    id?: string | number;
+};
+/** Chart / 平坦 Table 行 → 跨容器高亮目标（仅读一级字段，不读 meta）。 */
+export declare function resolveChartHighlightTarget(item: ChartHighlightItem | null | undefined): HighlightTarget;