@baishuyun/ui-base 6.3.2 → 6.4.1

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

@@ -0,0 +1,44 @@
+import { GanttMode } from '../../interface';
+import { TimelineCoords, TimeRangeConfig } from '../../types.internal';
+import { TimelineRange } from './timelineRange';
+export interface TimelineViewport {
+    renderWindow: TimelineRange;
+    visibleRange: TimelineRange;
+    focusMs: number;
+}
+export type RebaseGuardBand = 'left' | 'right' | null;
+interface DeriveTimelineViewportOptions {
+    renderWindow: TimelineRange;
+    timelineCoords: TimelineCoords;
+    scrollLeft: number;
+    viewportWidth: number;
+}
+interface RebaseGuardBandOptions {
+    scrollLeft: number;
+    viewportWidth: number;
+    timelineWidth: number;
+    guardBandPx: number;
+}
+interface BuildBoundedRenderWindowOptions {
+    focusMs: number;
+    fallbackFocusMs?: number;
+    viewMode: GanttMode;
+    timeRangeConfig: TimeRangeConfig;
+    viewportWidth: number;
+    pixelsPerDay: number;
+}
+interface BuildFocusPreservingAlignmentOptions {
+    focusMs: number;
+    fallbackFocusMs?: number;
+    timelineCoords: TimelineCoords;
+    viewportWidth: number;
+    timelineWidth: number;
+}
+export declare const deriveTimelineViewport: ({ renderWindow, timelineCoords, scrollLeft, viewportWidth, }: DeriveTimelineViewportOptions) => TimelineViewport;
+export declare const getRebaseGuardBand: ({ scrollLeft, viewportWidth, timelineWidth, guardBandPx, }: RebaseGuardBandOptions) => RebaseGuardBand;
+export declare const buildBoundedRenderWindow: ({ focusMs, fallbackFocusMs, viewMode, timeRangeConfig, viewportWidth, pixelsPerDay, }: BuildBoundedRenderWindowOptions) => TimelineRange;
+export declare const buildFocusPreservingAlignment: ({ focusMs, fallbackFocusMs, timelineCoords, viewportWidth, timelineWidth, }: BuildFocusPreservingAlignmentOptions) => {
+    focusMs: number;
+    scrollLeft: number;
+};
+export {};

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

@@ -0,0 +1,11 @@
+import { default as dayjs, OpUnitType } from 'dayjs';
+export declare const getSysTimezoneOffsetHours: () => number | null;
+export declare const getTimezoneShiftMs: () => number;
+export declare const toLocalRepresentation: (utcMs: number) => number;
+export declare const fromLocalRepresentation: (localMs: number) => number;
+export declare const getSystemNowMs: () => number;
+export declare const startOfDayInTz: (utcTimestampMs: number) => number;
+export declare const startOfPeriodInTz: (utcTimestampMs: number, unit: OpUnitType) => number;
+export declare const endOfPeriodInTz: (utcTimestampMs: number, unit: OpUnitType) => number;
+export declare const getWeekdayInTz: (utcTimestampMs: number) => number;
+export declare const toDayjsInTz: (utcTimestampMs: number) => dayjs.Dayjs;

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

@@ -0,0 +1,3 @@
+import { GanttHighlightContextValue } from './types.internal';
+declare const GanttHighlightContext: import('use-context-selector').Context<GanttHighlightContextValue>;
+export default GanttHighlightContext;

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

@@ -0,0 +1,3 @@
+import { GanttResizeIndicatorProps } from './types.internal';
+declare const GanttResizeIndicator: ({ tableWidth, onWidthChange, onResizeEnd, containerRef, }: GanttResizeIndicatorProps) => import("react/jsx-runtime").JSX.Element;
+export default GanttResizeIndicator;

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

@@ -0,0 +1,7 @@
+import { GanttDataItem } from '../interface';
+import { GanttTableProps } from '../types.internal';
+declare const GanttTable: {
+    <T extends GanttDataItem = GanttDataItem>({ data, columns, onRowClick, rowHeight, }: GanttTableProps<T>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export default GanttTable;

package/dist/components/Gantt/GanttTable/hooks/useGanttTableHighlightDomSync.d.ts

@@ -0,0 +1,2 @@
+import { RefObject } from 'react';
+export declare function useGanttTableHighlightDomSync(tableRef: RefObject<HTMLElement | null>): void;

package/dist/components/Gantt/GanttTable/hooks/useGanttTableLinkedScroll.d.ts

@@ -0,0 +1,7 @@
+import { RefObject } from 'react';
+import { VerticalScrollController } from '../../types.internal';
+export declare function useGanttTableLinkedScroll({ tableRef, verticalScrollController, dataLength, }: {
+    tableRef: RefObject<HTMLElement | null>;
+    verticalScrollController?: VerticalScrollController;
+    dataLength?: number;
+}): void;

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

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

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__/GanttBars.renderWindow.test.d.ts

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

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;