@pisell/materials 6.11.108 → 6.11.109

package/lib/components/pisellPhone/types.d.ts

@@ -0,0 +1,209 @@
+import type { CSSProperties } from 'react';
+import type { BaseTextInputProps } from '@pisell/utils';
+/**
+ * 国家码配置类型
+ */
+export interface CountryCode {
+    /**
+     * 国家码
+     * @example '+86', '+1', '+44'
+     */
+    code: string;
+    /**
+     * 国家名称
+     * @example '中国', '美国', '英国'
+     */
+    name: string;
+    /**
+     * 国旗 emoji 或图标
+     * @example '🇨🇳', '🇺🇸', '🇬🇧'
+     */
+    flag: string;
+    /**
+     * 号码格式（可选，用于显示占位符）
+     * @example 'XXX XXXX XXXX', '(XXX) XXX-XXXX'
+     */
+    format?: string;
+    /**
+     * 最大长度
+     * @example 11 (中国), 10 (美国)
+     */
+    maxLength: number;
+    /**
+     * 校验正则
+     * @example /^1[3-9]\d{9}$/ (中国手机号)
+     */
+    pattern: RegExp;
+}
+/**
+ * PisellPhone 组件 Props 类型定义
+ *
+ * 继承 BaseTextInputProps，添加电话号码特有的配置
+ */
+export interface PisellPhoneProps extends BaseTextInputProps {
+    /**
+     * 状态模式
+     * @default 'edit'
+     */
+    mode?: 'read' | 'edit';
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 当前选中的国家码
+     * @default '+86'
+     * @example '+86', '+1', '+44'
+     */
+    countryCode?: string;
+    /**
+     * 默认国家码（非受控模式）
+     * @default '+86'
+     */
+    defaultCountryCode?: string;
+    /**
+     * 是否显示国家码选择器
+     * @default true
+     */
+    showCountrySelector?: boolean;
+    /**
+     * 可用的国家码列表（从预设24个中过滤）
+     * @example ['+86', '+1', '+44']
+     */
+    availableCountryCodes?: string[];
+    /**
+     * 常用国家码（置顶显示）
+     * @example ['+86', '+1']
+     */
+    commonCountryCodes?: string[];
+    /**
+     * 完全自定义国家码列表（覆盖预设）
+     */
+    countryCodes?: CountryCode[];
+    /**
+     * 国家码变更回调
+     * @param code 新的国家码
+     */
+    onCountryCodeChange?: (code: string) => void;
+    /**
+     * 是否自动格式化
+     * @default true
+     */
+    autoFormat?: boolean;
+    /**
+     * 格式化规则
+     * @default 'auto'
+     */
+    formatRule?: 'mobile' | 'landline' | 'auto';
+    /**
+     * 格式化分隔符
+     * @default ' '
+     */
+    separator?: string;
+    /**
+     * 是否启用拨号（移动端）
+     * @default true
+     */
+    enableDial?: boolean;
+    /**
+     * 是否显示拨号图标
+     * @default false
+     */
+    showDialIcon?: boolean;
+    /**
+     * 拨号回调
+     * @param phone 完整的电话号码（含国家码）
+     */
+    onDial?: (phone: string) => void;
+    /**
+     * 是否脱敏显示（只读态）
+     * @default false
+     */
+    enableMasking?: boolean;
+    /**
+     * 脱敏模式
+     * - middle: 中间4位脱敏（138****0000）
+     * - last: 后4位脱敏（1380000****）
+     * - custom: 使用自定义函数
+     * @default 'middle'
+     */
+    maskPattern?: 'middle' | 'last' | 'custom';
+    /**
+     * 自定义脱敏函数
+     * @param phone 电话号码
+     * @returns 脱敏后的号码
+     */
+    customMask?: (phone: string) => string;
+    /**
+     * 是否显示国旗图标
+     * @default true
+     */
+    showFlag?: boolean;
+    /**
+     * 字号
+     * @example '14px' 或 14
+     * @default 16
+     */
+    fontSize?: string | number;
+    /**
+     * 字重
+     * @example 'bold' 或 600
+     * @default 500
+     */
+    fontWeight?: string | number;
+    /**
+     * 文本颜色
+     * @example '#000000'
+     * @default '#101828'
+     */
+    color?: string;
+    /**
+     * 占位文本
+     * @default '请输入电话号码'
+     */
+    placeholder?: string;
+    /**
+     * 最大长度（根据国家码自动设置）
+     */
+    maxLength?: number;
+    /**
+     * 是否显示清空按钮
+     * @default false
+     */
+    allowClear?: boolean;
+    /**
+     * 是否自动聚焦
+     * @default false
+     */
+    autoFocus?: boolean;
+    /**
+     * 是否校验格式
+     * @default true
+     */
+    validateFormat?: boolean;
+    /**
+     * 自定义校验函数
+     * @param phone 电话号码（纯数字）
+     * @param countryCode 国家码
+     * @returns true 表示校验通过，string 表示错误信息
+     */
+    customValidator?: (phone: string, countryCode: string) => boolean | string;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * ARIA 标签
+     */
+    'aria-label'?: string;
+    /**
+     * ARIA 描述
+     */
+    'aria-describedby'?: string;
+}
+export type { DisplayState, ValidationResult, TextInputState } from '@pisell/utils';

package/lib/components/pisellPhone/utils/countryCodeHelper.d.ts

@@ -0,0 +1,35 @@
+import type { CountryCode, PisellPhoneProps } from '../types';
+/**
+ * 根据国家码获取国旗 emoji
+ * @param countryCode 国家码
+ * @returns 国旗 emoji
+ */
+export declare function getCountryFlag(countryCode: string): string;
+/**
+ * 根据国家码获取最大长度
+ * @param countryCode 国家码
+ * @param countryCodes 国家码列表
+ * @returns 最大长度
+ */
+export declare function getMaxLength(countryCode: string, countryCodes: CountryCode[]): number;
+/**
+ * 根据国家码获取配置
+ * @param countryCode 国家码
+ * @param countryCodes 国家码列表
+ * @returns 国家码配置
+ */
+export declare function getCountryConfig(countryCode: string, countryCodes: CountryCode[]): CountryCode | undefined;
+/**
+ * 获取最终的国家码列表
+ *
+ * 优先级：
+ * 1. props.countryCodes（完全自定义）
+ * 2. props.availableCountryCodes（从预设中过滤）
+ * 3. PRESET_COUNTRY_CODES（默认全部24个）
+ *
+ * 然后根据 props.commonCountryCodes 排序（置顶）
+ *
+ * @param props 组件 Props
+ * @returns 国家码列表
+ */
+export declare function getCountryCodes(props: PisellPhoneProps): CountryCode[];

package/lib/components/pisellRating/PisellRating.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import type { PisellRatingProps } from './types';
+import './PisellRating.less';
+/**
+ * PisellRating 评分组件
+ *
+ * 基于 Ant Design Rate 组件开发，提供直观的星级评分交互。
+ * 支持只读、编辑、禁用三种状态。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 基础使用
+ * const [rating, setRating] = useState(0);
+ * <PisellRating value={rating} onChange={setRating} />
+ *
+ * @example
+ * // 只读态
+ * <PisellRating mode="read" value={4.5} allowHalf />
+ *
+ * @example
+ * // 带评分描述
+ * <PisellRating
+ *   value={rating}
+ *   onChange={setRating}
+ *   tooltips={['很差', '差', '一般', '好', '很好']}
+ * />
+ */
+export declare const PisellRating: React.FC<PisellRatingProps>;
+declare const _default: React.NamedExoticComponent<PisellRatingProps>;
+export default _default;

package/lib/components/pisellRecordBoard/PisellRecordBoard.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { RecordBoardProps } from './types';
+/**
+ * RecordBoard 容器：提供统一的 data / pagination / search 上下文。
+ * 打散 props：列表/分页/搜索/多选、grid/toolBar/…；可选根级 **floorMap**（兼容透传）。
+ * 平面图推荐在 ShellFrame 内使用 **PisellRecordBoard.FloorMap** 声明，与根级 `floorMap` 合并（子优先）。
+ */
+declare const PisellRecordBoard: React.FC<RecordBoardProps>;
+export default PisellRecordBoard;

package/lib/components/pisellRecordBoard/index.d.ts

@@ -0,0 +1,53 @@
+import React from 'react';
+import GridLayout from './layouts/GridLayout';
+import CardLayout from './layouts/CardLayout';
+import RecordBoardShellFrame, { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, RecordBoardFloorMap, RecordBoardCalendar, RecordBoardResourceWall } from './shellFrame';
+import RecordBoardGridView from './layouts/GridLayout/Grid';
+import RecordBoardCardList from './layouts/CardLayout/CardList';
+import { useRecordBoardContext } from './hooks/useRecordBoardContext';
+import type { RecordBoardProps } from './types';
+/** RecordBoard 复合组件类型 */
+interface PisellRecordBoardType extends React.FC<RecordBoardProps> {
+    /** Shell Frame：对 Layout 的扩展，提供 ToolBar + BatchActionBar + children（Layout） */
+    ShellFrame: typeof RecordBoardShellFrame;
+    /** Grid 布局：仅内容区（表格 + 分页），需配合 ShellFrame 使用 */
+    GridLayout: typeof GridLayout;
+    /** 卡片布局：仅内容区（卡片列表 + 分页），需配合 ShellFrame 使用 */
+    CardLayout: typeof CardLayout;
+    /**
+     * 平面图槽位：仅在 ShellFrame 内声明，无 DOM； props 与 PisellFloorMapLayout 对齐。
+     * 与 GridLayout 同时存在时出现「表格 / 平面图」切换。
+     */
+    FloorMap: typeof RecordBoardFloorMap;
+    /**
+     * 日历槽位：仅在 ShellFrame 内声明，无 DOM；与 GridLayout / FloorMap 并存时出现「表格 / 平面图 / 日历」切换。
+     */
+    Calendar: typeof RecordBoardCalendar;
+    /**
+     * 大屏资源墙槽位：仅在 ShellFrame 内声明，无 DOM；与其它主区并存时出现视图切换。
+     */
+    ResourceWall: typeof RecordBoardResourceWall;
+    /** 单独使用：搜索槽（PisellFind，绑定 searchParams.keyword / onSearch） */
+    Search: typeof RecordBoardSearch;
+    /** 单独使用：工具栏（PisellToolBar，含搜索/导出，可透传 topLeft/topRight 等） */
+    ToolBar: typeof RecordBoardToolBar;
+    /** 单独使用：分页槽 */
+    Pagination: typeof RecordBoardPagination;
+    /** 单独使用：Grid 视图（表格） */
+    Grid: typeof RecordBoardGridView;
+    /** 单独使用：卡片列表视图 */
+    CardList: typeof RecordBoardCardList;
+    /** 多选操作栏（基于 PisellBatchActionBar，有选中项时展示） */
+    BatchActionBar: typeof RecordBoardBatchActionBar;
+    /** 消费 RecordBoard 上下文 */
+    useRecordBoardContext: typeof useRecordBoardContext;
+}
+declare const PisellRecordBoard: PisellRecordBoardType;
+export default PisellRecordBoard;
+export type { RecordBoardProps, RecordBoardLayoutType, RecordBoardLayoutVariant, RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardGridProps, RecordBoardColumnType, RecordBoardFieldType, RecordBoardColumnFilterConfig, RecordBoardOptionItem, RecordBoardGetOptions, RecordBoardBodyView, RecordBoardFloorMapProps, RecordBoardCalendarProps, RecordBoardCalendarBlockedTimePayload, RecordBoardCalendarResource, RecordBoardCalendarBookingLike, RecordBoardCalendarDayOverlayBooking, RecordBoardCalendarTimelineHeaderGroup, RecordBoardCalendarTimelineHeaderRenderContext, RecordBoardCalendarResourceRenderArgs, RecordBoardCalendarBookingRenderArgs, RecordBoardBookingMoveDraft, RecordBoardBlockedTimeMergedRange, RecordBoardBlockedTimePanelPayload, RecordBoardCreateBookingDayGroup, RecordBoardCreateBookingFromSelectionPayload, RecordBoardCalendarSelectedFreeSlot, RecordBoardToolBarProps, RecordBoardResourceWallProps, RecordBoardResourceWallCardModel, RecordBoardResourceWallLayoutPersist, } from './types';
+export { DEFAULT_RESOURCE_WALL_LAYOUT_PERSIST } from './types';
+export { useRecordBoardContext } from './hooks/useRecordBoardContext';
+export { useRecordBoardShellBodyMeta } from './shellFrame';
+export { DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY } from './shellFrame/ResourceWall/PisellRecordBoardResourceWallView';
+export { adaptColumnsForPhoneLayout, RECORD_BOARD_PHONE_GRID_CLASS, } from './utils/recordBoardPhoneGrid';
+export type { AdaptColumnsForPhoneLayoutOptions } from './utils/recordBoardPhoneGrid';

package/lib/components/pisellRecordBoard/layouts/GridLayout/Grid.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { TableProps } from 'antd';
+import type { RecordBoardContextValue } from '../../types';
+import './Grid.less';
+export interface RecordBoardGridViewProps extends Omit<TableProps<any>, 'dataSource' | 'loading' | 'pagination'>, Partial<Pick<RecordBoardContextValue, 'data' | 'loading'>> {
+    /** 列配置，同 antd Table columns */
+    columns?: TableProps<any>['columns'];
+    className?: string;
+    style?: React.CSSProperties;
+    /** 自定义渲染，传入后不再使用内置 Table */
+    render?: (ctx: RecordBoardContextValue) => React.ReactNode;
+}
+declare const RecordBoardGridView: React.FC<RecordBoardGridViewProps>;
+export default RecordBoardGridView;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/BookingCalendar.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="react" />
+import type { RecordBoardCalendarProps } from '../../types';
+import './BookingCalendar.less';
+/** 看板日历根组件：内含主题 CSS 与 Spin，按 `view` 挂载月 / 周 / 日子组件 */
+export default function BookingCalendar(props?: RecordBoardCalendarProps): JSX.Element;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/PisellRecordBoardCalendarView.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="react" />
+import type { RecordBoardCalendarProps } from '../../types';
+export declare type PisellRecordBoardCalendarViewProps = RecordBoardCalendarProps;
+/**
+ * RecordBoard 日历视图：内嵌 `BookingCalendar`（Tailwind 由包入口 `pisell-materials.tw.css` 注入）。
+ *
+ * **布局分工**：外层 Shell 上 `pisell-record-board-calendar-viewport`（flex:1 / min-height:0 / overflow:hidden）
+ * 只做「占位与裁剪高度」；本组件根节点负责在同一 flex 列里向下传递 **min-height:0**，避免 `BookingCalendar`
+ * 撑破壳层（一层即可，历史上曾双包一层重复 flex+overflow）。
+ */
+export declare function PisellRecordBoardCalendarView(props: PisellRecordBoardCalendarViewProps): JSX.Element;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/bookingCalendarInternalTypes.d.ts

@@ -0,0 +1,43 @@
+/**
+ * BookingCalendar 专用类型（不放入全局 RecordBoard types，避免对外膨胀）。
+ */
+import type { RecordBoardCalendarBookingLike } from '../../types';
+import type { CalendarBookingSegmentInput, SelectedSlotLike } from './utils/bookingCalendarDateUtils';
+import type { Dayjs } from 'dayjs';
+/** 资源视图格子选中：仅记 court + 日 */
+export declare type ResourceCellPick = {
+    courtId: string;
+    dateKey: string;
+};
+/** 顶栏粒度切换 */
+export declare type CalendarViewMode = 'resource' | 'day' | 'week' | 'month';
+export declare type FreeSlotSelection = SelectedSlotLike & {
+    court?: string;
+};
+export declare type OverflowListModalState = {
+    scope: string;
+    date: string;
+    title: string;
+    items: CalendarBookingSegmentInput[];
+};
+export declare type OverflowPopoverState = {
+    courtId: string;
+    date: string;
+    items: CalendarBookingSegmentInput[];
+    pinned?: boolean;
+};
+export declare type MoveConfirmState = {
+    item: RecordBoardCalendarBookingLike;
+    targetCourtId: string;
+    targetDate: string;
+    targetHour: number;
+};
+export declare type MoveDraftState = {
+    targetCourtId: string;
+    targetDate: string;
+    targetHour: number;
+};
+export declare type TransitioningToDayState = {
+    source: string;
+};
+export declare type BlockTimeRange = [Dayjs, Dayjs] | null;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/bookingCalendarViewShared.d.ts

@@ -0,0 +1,26 @@
+/** UI 层：状态徽标文案走 i18n（utils 侧为 {@link statusTagMetaParts}） */
+export declare function statusTagMeta(tag: string | null | undefined): {
+    label: string;
+    className: string;
+} | null;
+/** 锁台卡片副标题：操作人、锁台时间等拼接一行 */
+export declare function getBlockMetaLine(item: any): string;
+export declare function getRemainingToneClass(ratio: any, isLight?: boolean): "text-red-600" | "text-red-300" | "text-amber-600" | "text-amber-300" | "theme-text-muted" | "text-zinc-400";
+/**
+ * @param options.flattenWhenAllGroupsCollapsed
+ *   若为 `true`：全部分组折叠时仅有 group 头、无 court 行，会退化为平铺 court（易与「全部展开」混淆）。
+ *   日/周/月日历统一为默认 `false`，保留分组头行与折叠态（与底部「全部关闭」预期一致）。
+ *
+ * 若全部资源只属于**一个**分组（含仅 VIP、仅 Standard、或仅一种自定义 type），日/周视图不展示分组头行，
+ * 直接平铺资源行（单组折叠时也同样平铺资源，避免只剩一条分组栏）。
+ */
+export declare function buildGroupedCourtRows(courts: any, collapsedGroups?: {}, options?: {}): any;
+/** 日视图 overlay 内单条预约/锁台：窄宽自适应与 Tooltip */
+export declare function BookingCard({ booking, dayKey, onOpenDetail, onDragStart, onJumpNext, overlayWidthPx, }: {
+    booking: any;
+    dayKey: any;
+    onOpenDetail: any;
+    onDragStart: any;
+    onJumpNext: any;
+    overlayWidthPx: any;
+}): any;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/hooks/useBookingCalendarDayOverlayLayout.d.ts

@@ -0,0 +1,18 @@
+import { type CalendarBookingSegmentInput } from '../utils/bookingCalendarDateUtils';
+export declare function useBookingCalendarDayOverlayLayout(visibleCourtRows: unknown[], dayKey: string, bookings: CalendarBookingSegmentInput[], hourSlots: number[], slotStepHours: number): {
+    dayRowHeights: number[];
+    dayRowTopMap: Record<string, number>;
+    overlayBookings: import("../utils/bookingCalendarDateUtils").BuiltDayOverlay[];
+    courtDayDisplayLaneCount: Record<string, number>;
+    hiddenDayOverlayIdSet: Set<string>;
+    dayOverlayOverflowPluses: {
+        key: string;
+        courtId: string;
+        rowTop: number;
+        rowHeight: number;
+        start: number;
+        span: number;
+        plusCount: number;
+        overflowItems: CalendarBookingSegmentInput[];
+    }[];
+};

package/lib/components/pisellRecordBoard/shellFrame/Calendar/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 看板日历子模块导出：持久化守卫、日历根视图、Shell 槽位占位组件。
+ */
+export { CalendarPersistProvider, useCalendarPersist, } from './calendarPersistGuard';
+export type { CalendarPersistContextValue, CalendarPersistKind, } from './calendarPersistGuard';
+export { PisellRecordBoardCalendarView, type PisellRecordBoardCalendarViewProps, } from './PisellRecordBoardCalendarView';
+export { default as RecordBoardCalendar } from './RecordBoardCalendar';

package/lib/components/pisellRecordBoard/shellFrame/Calendar/modal/BookingCalendarBlockPanel.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { BlockTimeRange } from '../bookingCalendarInternalTypes';
+export declare type BookingCalendarBlockPanelProps = {
+    blockPanelRef: React.RefObject<HTMLDivElement | null>;
+    isLight: boolean;
+    blockFormName: string;
+    setBlockFormName: (v: string) => void;
+    blockModalNote: string;
+    setBlockModalNote: (v: string) => void;
+    blockResourceId: string;
+    setBlockResourceId: (v: string) => void;
+    blockTimeRange: BlockTimeRange;
+    setBlockTimeRange: (v: BlockTimeRange) => void;
+    resolvedSlotMinutes: number;
+    visibleCourts: Array<{
+        id: string;
+        name: string;
+    }>;
+    blockSaving: boolean;
+    onClose: () => void;
+    onSave: () => void;
+};
+/**
+ * 内置锁台 / 屏蔽时间表单（宿主未传 `onBlockedTimePanelRequest` 时使用）。
+ */
+export declare function BookingCalendarBlockPanel({ blockPanelRef, isLight, blockFormName, setBlockFormName, blockModalNote, setBlockModalNote, blockResourceId, setBlockResourceId, blockTimeRange, setBlockTimeRange, resolvedSlotMinutes, visibleCourts, blockSaving, onClose, onSave, }: BookingCalendarBlockPanelProps): JSX.Element;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/modal/BookingCalendarOverflowListLayer.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { RecordBoardCalendarBookingLike } from '../../../types';
+import type { OverflowListModalState } from '../bookingCalendarInternalTypes';
+export declare type BookingCalendarOverflowListLayerProps = {
+    overflowPanelRef: React.RefObject<HTMLDivElement | null>;
+    isLight: boolean;
+    modal: OverflowListModalState;
+    onClose: () => void;
+    onPickItem: (item: RecordBoardCalendarBookingLike) => void;
+};
+/**
+ * 全局溢出预约列表弹层（月/周/资源格 `+N` 点开后）。
+ */
+export declare function BookingCalendarOverflowListLayer({ overflowPanelRef, isLight, modal, onClose, onPickItem, }: BookingCalendarOverflowListLayerProps): JSX.Element;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/modal/MoveConfirmModal.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="react" />
+/** 拖拽改期后的确认弹窗（Court / 日期 / 起止时间） */
+export declare function MoveConfirmModal({ moveConfirm, moveDraft, setMoveDraft, panelRef, isLight, courts, visibleCourts, hourSlots, isBusinessHour, firstTimelineHour, endTimelineExclusive, onConfirm, onClose, }: {
+    moveConfirm: any;
+    moveDraft: any;
+    setMoveDraft: any;
+    panelRef: any;
+    isLight: any;
+    courts: any;
+    visibleCourts: any;
+    hourSlots: any;
+    isBusinessHour: any;
+    firstTimelineHour: any;
+    endTimelineExclusive: any;
+    onConfirm: any;
+    onClose: any;
+}): JSX.Element | null;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/modal/OverflowListModal.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="react" />
+import { type CalendarBookingSegmentInput } from '../utils/bookingCalendarDateUtils';
+export declare type OverflowListModalVirtualListProps = {
+    items: CalendarBookingSegmentInput[];
+    dateKey: string;
+    onPickItem: (item: CalendarBookingSegmentInput) => void;
+    onClose: () => void;
+    /**
+     * 为 true 时按日视图逻辑展示状态徽标与状态底色（如日视图 lane 溢出列表）。
+     * 月 / 周打开的列表传 false，仅默认 booking / block 样式。
+     * @default true
+     */
+    showStatusUi?: boolean;
+};
+/**
+ * 溢出预约列表弹层：`FixedSizeList` 虚拟列表；视口宽高由 `AutoSizer` 跟随 flex 剩余区域，
+ * 列表可视高度取 `min(内容总高, 可用高度)`，避免条数少时底部大块空白。
+ */
+export declare function OverflowListModalVirtualList({ items, dateKey, onPickItem, onClose, showStatusUi, }: OverflowListModalVirtualListProps): JSX.Element | null;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/modal/OverflowPopover.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+import { type CalendarBookingSegmentInput } from '../utils/bookingCalendarDateUtils';
+export declare type MonthGridOverflowVirtualListProps = {
+    items: CalendarBookingSegmentInput[];
+    listWidth: number;
+    onPickItem: (item: CalendarBookingSegmentInput) => void;
+};
+/** 月/周格「+N」悬停层内的虚拟列表（overflowPopover） */
+export declare function MonthGridOverflowVirtualList({ items, listWidth, onPickItem, }: MonthGridOverflowVirtualListProps): JSX.Element | null;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/utils/BookingCalendarStyle.d.ts

@@ -0,0 +1,10 @@
+import { type CalendarBookingSegmentInput } from './bookingCalendarDateUtils';
+export declare function getDrawerStatusTheme(item: CalendarBookingSegmentInput, dateKey: string): "bg-red-700/88 border-b-4 border-red-300/55" | "bg-zinc-700/88 border-b-4 border-zinc-400/45" | "bg-zinc-700/88 border-b-4 border-red-400/75" | "bg-violet-700/92 border-b-4 border-amber-400/95" | "bg-violet-700/92 border-b-4 border-zinc-300/45" | "bg-violet-700/92 border-b-4 border-violet-300/30";
+export declare function paymentTagClass(label: string, isLight?: boolean): "theme-success-chip border" | "bg-emerald-500 text-white" | "theme-warning-chip border" | "bg-amber-500 text-white" | "theme-info-chip border" | "bg-sky-500 text-white" | "theme-danger-chip border" | "bg-red-500 text-white";
+export declare function fulfillmentTagClass(label: string, isLight?: boolean): "bg-violet-600 text-white" | "theme-success-chip border" | "theme-warning-chip border" | "bg-amber-500 text-white" | "theme-info-chip border" | "theme-danger-chip border" | "bg-emerald-600 text-white" | "bg-cyan-500 text-white" | "bg-red-600 text-white" | "border border-[var(--border-strong)] bg-[var(--bg-input)] theme-text-soft" | "bg-zinc-600 text-white" | "border border-[var(--brand-light)] bg-[var(--brand-surface)] theme-brand-text";
+export declare function getBookingStateClasses(item: CalendarBookingSegmentInput, dateKey: string): "bg-zinc-700/55 border border-zinc-500/70 text-zinc-100 grayscale-[0.2]" | "bg-zinc-700/55 border border-red-500/70 text-zinc-200 grayscale-[0.15]" | "bg-violet-700/90 border border-amber-400/80 text-violet-50" | "bg-red-700/70 text-red-100" | "bg-violet-700/90 text-violet-50";
+/**
+ * 月 / 周紧凑格：不按签到/取消/迟到等状态变色，仅区分 booking（默认紫）与 block（红）。
+ * 与 {@link getBookingStateClasses} 在无状态分支时一致，但不读取 `dateKey`。
+ */
+export declare function getGridBookingRowStateClasses(item: CalendarBookingSegmentInput): string;