@baishuyun/ui-base 6.3.2 → 6.4.1

package/dist/components/Gantt/GanttChart/GanttTimelineHeader/GanttTimelineHeader.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { GanttTimelineHeaderProps } from '../../types.internal';
+declare const _default: React.MemoExoticComponent<({ timelineWidth, viewportWidth, scrollLeft, trackRef, virtualColumns, lowerSegments, todayLineLeft, todayCenterMs, showTodayLine, viewMode, availableModes, formatMessage, onViewModeChange, onTodayClick, onScrollPrev, onScrollNext, }: GanttTimelineHeaderProps) => import("react/jsx-runtime").JSX.Element>;
+export default _default;

package/dist/components/Gantt/GanttChart/OffscreenTaskIndicators/OffscreenTaskIndicators.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { OffscreenTaskIndicatorsProps } from '../../types.internal';
+declare const _default: React.MemoExoticComponent<({ indicators, onJump }: OffscreenTaskIndicatorsProps) => import("react/jsx-runtime").JSX.Element | null>;
+export default _default;

package/dist/components/Gantt/GanttChart/OffscreenTaskIndicators/__tests__/OffscreenTaskIndicators.test.d.ts

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

package/dist/components/Gantt/GanttChart/TodayIndicator/TodayIndicator.d.ts

@@ -0,0 +1,3 @@
+import { TodayIndicatorProps } from '../../types.internal';
+declare const TodayIndicator: ({ left, height, className }: TodayIndicatorProps) => import("react/jsx-runtime").JSX.Element;
+export default TodayIndicator;

package/dist/components/Gantt/GanttChart/hooks/__tests__/timelineFocus.contract.test.d.ts

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

package/dist/components/Gantt/GanttChart/hooks/__tests__/useGanttColumnVirtual.test.d.ts

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

package/dist/components/Gantt/GanttChart/hooks/__tests__/useOffscreenIndicators.test.d.ts

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

package/dist/components/Gantt/GanttChart/hooks/useBarTooltipHover.d.ts

@@ -0,0 +1,19 @@
+import { MouseEvent } from 'react';
+export declare function useBarTooltipHover(): {
+    virtualReference: {
+        getBoundingClientRect: () => {
+            width: number;
+            height: number;
+            x: number;
+            y: number;
+            top: number;
+            bottom: number;
+            left: number;
+            right: number;
+            toJSON: () => {};
+        };
+    } | undefined;
+    handleMouseMove: (e: MouseEvent<HTMLDivElement>) => void;
+    handleMouseLeave: () => void;
+    handleTooltipVisibleChange: (visible: boolean) => void;
+};

package/dist/components/Gantt/GanttChart/hooks/useEdgeScroll.d.ts

@@ -0,0 +1,6 @@
+import { MutableRefObject } from 'react';
+import { ElementRef } from '../../types.internal';
+export declare function useEdgeScroll(containerRef: ElementRef<HTMLDivElement>, onScrolledRef?: MutableRefObject<(() => void) | null>): {
+    startEdgeDetection: (clientX: number) => void;
+    stopEdgeScroll: () => void;
+};

package/dist/components/Gantt/GanttChart/hooks/useGanttColumnVirtual.d.ts

@@ -0,0 +1,21 @@
+import { GanttMode } from '../../interface';
+import { LowerSegment, VirtualColumnIndex, WeekendSegment } from '../../types.internal';
+export declare function resolveColumnOverscanPx(cellWidthPx: number): number;
+export declare function selectVirtualColumns(lowerSegments: LowerSegment[], opts: {
+    scrollLeft?: number;
+    viewportWidth?: number;
+    pixelsPerDay: number;
+}): VirtualColumnIndex[];
+export declare function useGanttColumnVirtual({ lowerSegments, pixelsPerDay, scrollLeft, viewportWidth, showWeekendHighlight, timelineStartMs, timelineWidth, viewMode, }: {
+    lowerSegments: LowerSegment[];
+    pixelsPerDay: number;
+    scrollLeft: number;
+    viewportWidth: number;
+    showWeekendHighlight?: boolean;
+    timelineStartMs: number;
+    timelineWidth: number;
+    viewMode: GanttMode;
+}): {
+    virtualColumns: VirtualColumnIndex[];
+    weekendSegments: WeekendSegment[];
+};

package/dist/components/Gantt/GanttChart/hooks/useGanttDrag.d.ts

@@ -0,0 +1,15 @@
+import { MouseEvent } from 'react';
+import { CommittedRangeById, InternalDragState, NormalizedGanttItem, ResolvedDragPermission, UseGanttDragOptions } from '../../types.internal';
+export declare function useGanttDrag({ pixelsPerDay, viewMode, timelineCoords, onTaskTimeChange, containerRef, onDragInteractionChange, }: UseGanttDragOptions): {
+    dragState: InternalDragState | null;
+    committedRangeById: CommittedRangeById;
+    resetCommittedRanges: () => void;
+    forceResetAllCommittedRanges: () => void;
+    handleTaskMouseDown: (event: MouseEvent, item: NormalizedGanttItem & {
+        dragPermission?: ResolvedDragPermission;
+    }, left: number, width?: number) => void;
+    handleResizeMouseDown: (event: MouseEvent, item: NormalizedGanttItem & {
+        dragPermission?: ResolvedDragPermission;
+    }, left: number, edge: "start" | "end", width?: number) => void;
+    consumeRecentDragResult: () => boolean;
+};

package/dist/components/Gantt/GanttChart/hooks/useGanttRowVirtualScroll.d.ts

@@ -0,0 +1,12 @@
+import { NormalizedGanttItem, ElementRef } from '../../types.internal';
+export declare function useGanttRowVirtualScroll({ items, contentRef, safeRowHeight, viewportHeight, overscan, }: {
+    items: NormalizedGanttItem[];
+    contentRef: ElementRef<HTMLDivElement>;
+    safeRowHeight: number;
+    viewportHeight: number;
+    overscan?: number;
+}): {
+    virtualRows: any;
+    canvasHeight: number;
+    isScrolling: boolean;
+};

package/dist/components/Gantt/GanttChart/hooks/useGanttScrollbars.d.ts

@@ -0,0 +1,2 @@
+import { RefObject } from 'react';
+export declare function useGanttScrollbars(hostRef: RefObject<HTMLDivElement | null>, viewportRef: RefObject<HTMLDivElement | null>): boolean;

package/dist/components/Gantt/GanttChart/hooks/useNormalizedItems.d.ts

@@ -0,0 +1,11 @@
+import { GanttDataItem, GanttMode } from '../../interface';
+import { CommittedRange, NormalizedGanttItem } from '../../types.internal';
+interface UseNormalizedItemsParams<T extends GanttDataItem = GanttDataItem> {
+    visibleItems?: T[];
+    committedRangeById?: Record<string, CommittedRange>;
+    viewMode?: GanttMode | string;
+}
+export declare function useNormalizedItems<T extends GanttDataItem = GanttDataItem>({ visibleItems, committedRangeById, viewMode, }: UseNormalizedItemsParams<T>): {
+    normalizedItems: NormalizedGanttItem<T>[];
+};
+export {};

package/dist/components/Gantt/GanttChart/hooks/useOffscreenIndicators.d.ts

@@ -0,0 +1,11 @@
+import { VirtualItem } from '@tanstack/react-virtual';
+import { NormalizedGanttItem, OffscreenIndicator } from '../../types.internal';
+export declare function useOffscreenIndicators({ virtualRows, normalizedItems, visibleStartMs, visibleEndMs, enabled, excludeTaskId, }: {
+    virtualRows: VirtualItem[];
+    normalizedItems: NormalizedGanttItem[];
+    visibleStartMs: number;
+    visibleEndMs: number;
+    enabled?: boolean;
+    /** Hide indicators for the row currently being dragged. */
+    excludeTaskId?: string | null;
+}): OffscreenIndicator[];

package/dist/components/Gantt/GanttChart/hooks/useRowHoverHighlight.d.ts

@@ -0,0 +1,10 @@
+import { MouseEvent, RefObject } from 'react';
+import { NormalizedGanttItem } from '../../types.internal';
+export declare function useRowHoverHighlight({ normalizedItems, safeRowHeight, }: {
+    normalizedItems: NormalizedGanttItem[];
+    safeRowHeight: number;
+}): {
+    hoverBgRef: RefObject<HTMLDivElement | null>;
+    handleContentMouseMove: (event: MouseEvent<HTMLDivElement>) => void;
+    handleContentMouseLeave: () => void;
+};

package/dist/components/Gantt/GanttChart/hooks/useTimelineViewportController.d.ts

@@ -0,0 +1,26 @@
+import { UIEvent } from 'react';
+import { OffscreenJumpTarget, UseTimelineViewportControllerOptions } from '../../types.internal';
+/**
+ * 时间轴视口：Focus(anchorCenterMs) → Window → Scroll 单向流。
+ * 切档只重建窗口并对齐 scroll，禁止用 (oldStart, oldPpd, scrollLeft) 反推焦点。
+ */
+export declare function useTimelineViewportController({ timeRangeConfig, pixelsPerDayConfig, viewMode, contentRef, contentSize, headerTrackRef, formatMessage, isHorizontalScrollbarInteracting, isTaskBarInteracting, }: UseTimelineViewportControllerOptions): {
+    pixelsPerDay: number;
+    viewportWidth: number;
+    scrollLeft: number;
+    timelineStartMs: number;
+    timelineEndMs: number;
+    visibleStartMs: number;
+    visibleEndMs: number;
+    lowerSegments: import('../../types.internal').TimelineSegment[];
+    timelineCoords: import('../../types.internal').TimelineCoords;
+    timelineWidth: number;
+    todayCenterMs: number;
+    todayLineLeft: number | null;
+    isInitialLayoutReady: boolean;
+    handleContentScroll: (event: UIEvent<HTMLDivElement>) => void;
+    handleTodayClick: () => void;
+    handleOffscreenJump: (jumpTarget: OffscreenJumpTarget) => void;
+    handleScrollPrev: () => void;
+    handleScrollNext: () => void;
+};

package/dist/components/Gantt/GanttChart/hooks/useTodayMs.d.ts

@@ -0,0 +1,4 @@
+import { GanttMode } from '../../interface';
+export declare const getTodayCenterMs: (viewMode: GanttMode) => number;
+declare const useTodayMs: (viewMode: GanttMode) => number;
+export default useTodayMs;

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

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

package/dist/components/Gantt/GanttChart/utils/__tests__/dateRangeNormalizer.subday.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/__tests__/dragEngine.quarterMonth.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/__tests__/dragEngine.subday.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/__tests__/headerBuilder.quarterMonth.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/__tests__/headerBuilder.subday.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/__tests__/quarterMonthScale.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/__tests__/subdayScale.contract.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/__tests__/timelineMarkers.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/__tests__/timelineRange.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/__tests__/timelineViewConfig.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/__tests__/timelineViewportEngine.test.d.ts

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

package/dist/components/Gantt/GanttChart/utils/buildSummaryBarTooltipContent.d.ts

@@ -0,0 +1,6 @@
+import { GanttFormatMessage } from '../../types.internal';
+export declare function buildSummaryBarTooltipContent(item: {
+    rawStartMs?: number | null;
+    rawEndMs?: number | null;
+    progress?: number | null;
+}, formatMessage: GanttFormatMessage): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,102 @@
+export declare const HEADER_TOP_HEIGHT = 34;
+export declare const HEADER_BOTTOM_HEIGHT = 34;
+export declare const MIN_TABLE_WIDTH = 200;
+export declare const GANTT_DEFAULT_ROW_HEIGHT = 34;
+/** 左表 headerRowSpan：与 GanttTimelineHeader 双行高度（68px）对齐 */
+export declare const GANTT_TABLE_HEADER_ROW_SPAN: number;
+export declare const MS_PER_DAY: number;
+export declare const DRAG_MODE_MOVE = "move";
+export declare const DRAG_MODE_RESIZE_START = "resize-start";
+export declare const DRAG_MODE_RESIZE_END = "resize-end";
+export declare const CLICK_SUPPRESS_WINDOW_MS = 400;
+export declare const PENDING_TIMEOUT_MS = 30000;
+export declare const OFFSCREEN_SMOOTH_SCROLL_DISTANCE_RATIO = 1.5;
+export declare const MIN_DRAG_PX = 5;
+export declare const EDGE_SCROLL_ZONE_PX = 60;
+export declare const EDGE_SCROLL_MAX_SPEED = 10;
+export declare const EDGE_SCROLL_MIN_SPEED = 2;
+export declare const HOVER_SCROLL_IDLE_MS = 150;
+export declare const EMPTY_GROUP_VALUE = "__empty__";
+export declare const HEX_COLOR_REGEX: RegExp;
+export declare const BAR_MAX_HEIGHT = 26;
+/**
+ * 列向虚拟化 overscan（DOM 裁剪，≠ 时间轴 dynamicBuffer）。
+ * 按 bottom 格宽计，禁止用 pixelsPerDay（亚日 ppd = 格宽 × 每日列数，会放大 columnsPerDay 倍）。
+ */
+export declare const COLUMN_OVERSCAN_CELLS = 4;
+export declare const MIN_COLUMN_OVERSCAN_PX = 240;
+export declare const TIMELINE_REBASE_GUARD_BAND_PX = 280;
+/** 重建后的 Focus 到任一逻辑边缘必须严格越过保护区，避免立即再次 rebase。 */
+export declare const TIMELINE_REBASE_CENTER_MARGIN_PX: number;
+export declare const DEFAULT_TIME_RANGE_CONFIG: {
+    bufferDaysBefore: number;
+    bufferDaysAfter: number;
+};
+/**
+ * 亚日档初始缓冲天数（单点真相）。
+ *
+ * [核心约束] 亚日档每天会产出 columnsPerDay 个 bottom 列
+ *（tenMinute = 144 列/天；oneMinute = 1440 列/天）。
+ * 若沿用日历档 ±90 天缓冲，初次构建即产生上万个表头格，造成首屏卡顿。
+ * 这里按粒度收窄初始窗口；DOM 仍由列虚拟化控制，segment 数组可略超千级。
+ */
+export declare const DEFAULT_SUBDAY_BUFFER_DAYS: {
+    halfDay: number;
+    sixHour: number;
+    hour: number;
+    halfHour: number;
+    tenMinute: number;
+    oneMinute: number;
+};
+/**
+ * 粗粒度日历档：每侧至少保留的「本档周期」数量。
+ * week→周、month/quarterMonth→月、quarter→季、year→年。
+ */
+export declare const COARSE_MODE_SIDE_BUFFER_UNITS: {
+    readonly week: 20;
+    readonly month: 20;
+    readonly quarter: 20;
+    readonly year: 10;
+    readonly quarterMonth: 20;
+};
+/**
+ * 按 viewMode 覆盖的默认缓冲天数（前后对称）。
+ *
+ * - 亚日：收窄，避免 ±90 天炸出海量表头列
+ * - week 及以上：每侧按 {@link COARSE_MODE_SIDE_BUFFER_UNITS} 个本档周期
+ *   （大屏下 ensureCanCenter 仍可能再加宽以保证 focus 可居中）
+ * - day：不在此表，沿用 DEFAULT_TIME_RANGE_CONFIG ±90（可被 props 覆盖）
+ */
+export declare const DEFAULT_MODE_BUFFER_DAYS: {
+    week: number;
+    month: number;
+    quarter: number;
+    year: number;
+    quarterMonth: number;
+    halfDay: number;
+    sixHour: number;
+    hour: number;
+    halfHour: number;
+    tenMinute: number;
+    oneMinute: number;
+};
+/**
+ * 每个 viewMode 的「每天像素宽」。
+ *
+ * [核心约束] 单格列宽 = pixelsPerDay × (bottomCellMs / MS_PER_DAY)。
+ * 因此亚日档要达到目标列宽，pixelsPerDay 必须 = 目标列宽 × columnsPerDay，
+ * 而非直接写目标列宽（这是此前列宽被压窄的根因）。
+ */
+export declare const DEFAULT_PIXELS_PER_DAY_CONFIG: {
+    day: number;
+    week: number;
+    month: number;
+    quarter: number;
+    year: number;
+    halfDay: number;
+    sixHour: number;
+    hour: number;
+    halfHour: number;
+    tenMinute: number;
+    oneMinute: number;
+};

package/dist/components/Gantt/GanttChart/utils/dateRangeNormalizer.d.ts

@@ -0,0 +1,18 @@
+import { GanttMode } from '../../interface';
+export declare const hasTimeComponent: (ms: number | null) => boolean;
+export declare const resolveRenderRange: ({ rawStartMs, rawEndMs, baseStartMs, baseEndMs, }: {
+    rawStartMs: number | null;
+    rawEndMs: number | null;
+    baseStartMs: number | null;
+    baseEndMs: number | null;
+}, viewMode: GanttMode) => {
+    startMs: number | null;
+    endMs: number | null;
+};
+export declare const normalizeTaskDateRange: (startValue: unknown, endValue: unknown) => {
+    rawStartMs: number | null;
+    rawEndMs: number | null;
+    baseStartMs: number | null;
+    baseEndMs: number | null;
+    invalid: boolean;
+};

package/dist/components/Gantt/GanttChart/utils/dragEngine.d.ts

@@ -0,0 +1,62 @@
+import { GanttCalendarMode, GanttCalendarTaskTimeChangePayload, GanttChangeType, GanttDragPermission, GanttSubDayMode, GanttSubDayTaskTimeChangePayload } from '../../interface';
+import { ResolvedDragPermission, TimelineCoords } from '../../types.internal';
+type DraggableItem = {
+    type?: 'task' | 'summary';
+    draggable?: boolean;
+    invalid?: boolean;
+    dragPermission?: GanttDragPermission | ResolvedDragPermission;
+};
+export declare const isDraggableItem: (item: DraggableItem | null | undefined) => boolean;
+export declare const NO_DRAG_PERMISSION: ResolvedDragPermission;
+export declare const resolveItemDragPermission: (item: DraggableItem | null | undefined) => ResolvedDragPermission;
+export declare const canStartDragMode: (item: DraggableItem | null | undefined, dragMode: GanttChangeType) => boolean;
+export declare const getSnappedDeltaDays: (deltaPx: number, pixelsPerDay: number) => number;
+export declare const getSnappedDelta: (deltaPx: number, pixelsPerUnit: number) => number;
+export declare const snapTimestampToGrid: (ms: number, snapUnitMs: number, edge?: "floor" | "ceil" | "round") => number;
+export declare const shiftTimeRangeMs: (startMs: number, endMs: number, deltaMs: number) => {
+    startMs: number;
+    endMs: number;
+};
+export declare const resizeTimeRangeMs: ({ startMs, endMs, deltaMs, edge, minDurationMs, }: {
+    startMs: number;
+    endMs: number;
+    deltaMs: number;
+    edge: "start" | "end";
+    minDurationMs: number;
+}) => {
+    startMs: number;
+    endMs: number;
+};
+interface CalendarDragCurrent {
+    dragMode: GanttChangeType;
+    originStartMs: number;
+    originEndMs: number;
+    originLeftPx: number;
+    originAnchorPx?: number;
+    originAnchorMs?: number;
+}
+export declare const applyCalendarDragByCoords: (current: CalendarDragCurrent, deltaPx: number, timelineCoords: TimelineCoords, snapUnitMs: number) => {
+    deltaUnits: number;
+    previewStartMs: number;
+    previewEndMs: number;
+    previewLeftPx: number;
+};
+type BuildTaskTimeChangePayloadCommon = {
+    item: {
+        id: string | number;
+    };
+    startMs: number;
+    endMs: number;
+    deltaMs: number;
+    snapUnitMs: number;
+    changeType: GanttChangeType;
+};
+type BuildTaskTimeChangePayloadArgs = (BuildTaskTimeChangePayloadCommon & {
+    viewMode: GanttCalendarMode;
+    deltaDays: number;
+}) | (BuildTaskTimeChangePayloadCommon & {
+    viewMode: GanttSubDayMode;
+});
+export declare function buildTaskTimeChangePayload<const T extends BuildTaskTimeChangePayloadArgs>(args: T): T['viewMode'] extends GanttSubDayMode ? GanttSubDayTaskTimeChangePayload : GanttCalendarTaskTimeChangePayload;
+export declare const toPromise: <T>(result: T | Promise<T>) => Promise<T>;
+export {};

package/dist/components/Gantt/GanttChart/utils/headerBuilder.d.ts

@@ -0,0 +1,14 @@
+import { GanttMode } from '../../interface';
+import { GanttFormatMessage, LowerSegment, TopSegment } from '../../types.internal';
+export declare const buildLowerSegments: ({ viewMode, timelineStartMs, timelineEndMs, pixelsPerDay, formatMessage, }: {
+    viewMode: GanttMode;
+    timelineStartMs: number;
+    timelineEndMs: number;
+    pixelsPerDay: number;
+    formatMessage: GanttFormatMessage;
+}) => LowerSegment[];
+export declare const buildTopSegments: ({ lowerSegments, viewMode, formatMessage, }: {
+    lowerSegments: LowerSegment[];
+    viewMode: GanttMode;
+    formatMessage: GanttFormatMessage;
+}) => TopSegment[];

package/dist/components/Gantt/GanttChart/utils/quarterMonthScale.d.ts

@@ -0,0 +1,9 @@
+import { GanttFormatMessage, LowerSegment } from '../../types.internal';
+export declare const QUARTER_MONTH_CELL_WIDTH_PX: number | undefined;
+export declare const toUnclippedQuarterMonthWidth: (startMs: number, endMs: number) => number;
+export declare const formatQuarterMonthTopLabel: (startMs: number, formatMessage: GanttFormatMessage) => string;
+export declare const formatCalendarMonthLabel: (startMs: number, formatMessage: GanttFormatMessage) => string;
+export declare const formatQuarterMonthBottomLabel: (startMs: number, formatMessage: GanttFormatMessage) => string;
+export declare const toXFromMonthSegments: (timeMs: number, segments: LowerSegment[]) => number;
+export declare const toWidthFromMonthSegments: (startMs: number, endMs: number, segments: LowerSegment[]) => number;
+export declare const timeMsAtXFromMonthSegments: (x: number, segments: LowerSegment[], timelineEndMs: number) => number;

package/dist/components/Gantt/GanttChart/utils/taskBarUtils.d.ts

@@ -0,0 +1,3 @@
+export declare const buildAlphaColor: (color: string | undefined, alpha: number) => string | null;
+export declare const buildContrastColor: (color: string | undefined, minContrastRatio?: number) => string;
+export declare const measureLabelWidth: (text: string, font?: string) => number;

package/dist/components/Gantt/GanttChart/utils/timeScale.d.ts

@@ -0,0 +1,35 @@
+import { GanttMode } from '../../interface';
+import { LowerSegment, PixelsPerDayConfig, TimeRangeConfig, TimelineCoords } from '../../types.internal';
+import { MS_PER_DAY, DEFAULT_TIME_RANGE_CONFIG, DEFAULT_PIXELS_PER_DAY_CONFIG } from './constants';
+export { MS_PER_DAY, DEFAULT_TIME_RANGE_CONFIG, DEFAULT_PIXELS_PER_DAY_CONFIG };
+export declare const clampProgress: (value: unknown) => number;
+export declare const parseDateValue: (value: unknown) => number | null;
+export declare const startOfDayMs: (timestamp: number) => number;
+export declare const getPixelsPerDay: (viewMode: GanttMode, config?: PixelsPerDayConfig) => number;
+export declare const resolveTimeRangeConfigForViewMode: (viewMode: GanttMode, timeRangeConfig?: TimeRangeConfig) => Required<TimeRangeConfig>;
+export declare const buildBufferedTimelineRange: (timeRangeConfig?: TimeRangeConfig, anchorMs?: number) => {
+    startMs: number;
+    endMs: number;
+};
+export declare const buildTodayTimelineRange: (timeRangeConfig?: TimeRangeConfig, nowMs?: number) => {
+    startMs: number;
+    endMs: number;
+};
+export declare const alignRangeToViewMode: (startMs: number, endMs: number, viewMode: GanttMode) => {
+    startMs: number;
+    endMs: number;
+};
+export declare const toXByTime: (timeMs: number, timelineStartMs: number, pixelsPerDay: number, viewMode: GanttMode, monthSegments?: LowerSegment[] | null) => number;
+export declare const toWidthByRange: (startMs: number, endMs: number, pixelsPerDay: number, viewMode: GanttMode, _timelineStartMs?: number, monthSegments?: LowerSegment[] | null) => number;
+export declare const timeMsAtX: (x: number, timelineStartMs: number, pixelsPerDay: number, viewMode: GanttMode, timelineEndMs?: number, monthSegments?: LowerSegment[] | null) => number;
+export declare const buildTimelineCoords: ({ viewMode, timelineStartMs, timelineEndMs, pixelsPerDay, lowerSegments, }: {
+    viewMode: GanttMode;
+    timelineStartMs: number;
+    timelineEndMs: number;
+    pixelsPerDay: number;
+    lowerSegments: LowerSegment[];
+}) => TimelineCoords;
+export declare const buildCenteredTimelineRange: (centerMs: number, spanMs: number) => {
+    startMs: number;
+    endMs: number;
+};

package/dist/components/Gantt/GanttChart/utils/timelineFocus.d.ts

@@ -0,0 +1,8 @@
+export declare function clampScrollLeft(scrollLeft: number, viewportWidth: number, timelineWidth: number): number;
+export declare function scrollLeftForAnchor({ anchorMs, toX, viewportWidth, timelineWidth, }: {
+    anchorMs: number;
+    toX: (ms: number) => number;
+    viewportWidth: number;
+    timelineWidth: number;
+}): number;
+export declare function focusDeltaDays(actualMs: number, anchorMs: number): number;

package/dist/components/Gantt/GanttChart/utils/timelineMarkers.d.ts

@@ -0,0 +1,2 @@
+import { TimelineRange } from './timelineRange';
+export declare function shouldShowTodayMarker(showTodayLine: boolean | undefined, todayLineLeft: number | null, timelineWidth: number, todayMs: number, renderWindow: TimelineRange): boolean;

package/dist/components/Gantt/GanttChart/utils/timelineRange.d.ts

@@ -0,0 +1,8 @@
+export interface TimelineRange {
+    startMs: number;
+    endMs: number;
+}
+export declare const isValidTimelineRange: (range: TimelineRange) => boolean;
+export declare const containsTime: (range: TimelineRange, timeMs: number) => boolean;
+export declare const intersectsRange: (left: TimelineRange, right: TimelineRange) => boolean;
+export declare const clipRange: (range: TimelineRange, bounds: TimelineRange) => TimelineRange | null;

package/dist/components/Gantt/GanttChart/utils/timelineViewConfig.d.ts

@@ -0,0 +1,106 @@
+import { TimelineViewConfig } from '../../types.internal';
+import { ALL_GANTT_MODES, CALENDAR_TIER_MODES, DEFAULT_GANTT_MODE, GANTT_MODE_DISPLAY_ORDER, SUB_DAY_MODES, GanttMode } from '../../interface';
+export { ALL_GANTT_MODES, CALENDAR_TIER_MODES, DEFAULT_GANTT_MODE, GANTT_MODE_DISPLAY_ORDER, SUB_DAY_MODES, };
+export declare const MS_HOUR: number;
+export declare const MS_MIN: number;
+export declare const SUBDAY_SNAP: {
+    readonly hour: number;
+    readonly tenMinute: number;
+    readonly oneMinute: number;
+};
+/**
+ * 12 档 viewMode 配置矩阵。
+ * [核心约束] bottomCellMs 与 snapUnitMs 独立，禁止互相推导。
+ */
+export declare const TIMELINE_VIEW_CONFIG: {
+    readonly day: {
+        readonly tier: "calendar";
+        readonly headerLayout: "flat";
+        readonly topGroup: "month";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+    readonly week: {
+        readonly tier: "calendar";
+        readonly headerLayout: "flat";
+        readonly topGroup: "month";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+    readonly month: {
+        readonly tier: "calendar";
+        readonly headerLayout: "flat";
+        readonly topGroup: "year";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+    readonly quarter: {
+        readonly tier: "calendar";
+        readonly headerLayout: "flat";
+        readonly topGroup: "year";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+    readonly quarterMonth: {
+        readonly tier: "calendar";
+        readonly headerLayout: "quarterNested";
+        readonly topGroup: "quarter";
+        readonly bottomCellMs: number;
+        readonly bottomCellWidthPx: 100;
+        readonly snapUnitMs: number;
+    };
+    readonly year: {
+        readonly tier: "calendar";
+        readonly headerLayout: "flat";
+        readonly topGroup: "year";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+    readonly halfDay: {
+        readonly tier: "subDay";
+        readonly headerLayout: "dayNested";
+        readonly topGroup: "day";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+    readonly sixHour: {
+        readonly tier: "subDay";
+        readonly headerLayout: "dayNested";
+        readonly topGroup: "day";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+    readonly hour: {
+        readonly tier: "subDay";
+        readonly headerLayout: "dayNested";
+        readonly topGroup: "day";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+    readonly halfHour: {
+        readonly tier: "subDay";
+        readonly headerLayout: "hourNested";
+        readonly topGroup: "hour";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+    readonly tenMinute: {
+        readonly tier: "subDay";
+        readonly headerLayout: "hourNested";
+        readonly topGroup: "hour";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+    readonly oneMinute: {
+        readonly tier: "subDay";
+        readonly headerLayout: "hourNested";
+        readonly topGroup: "hour";
+        readonly bottomCellMs: number;
+        readonly snapUnitMs: number;
+    };
+};
+export declare const getTimelineViewConfig: (mode: GanttMode | string) => TimelineViewConfig;
+export declare const isSubDayViewMode: (mode: GanttMode | string) => boolean;
+export declare const isQuarterMonthViewMode: (mode: GanttMode | string) => boolean;
+export declare const resolveSnapUnit: (mode: GanttMode | string) => number;
+export declare const resolveBottomCellMs: (mode: GanttMode | string) => number;