@pisell/materials 6.11.223 → 6.11.225

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

@@ -0,0 +1,330 @@
+import type { Dayjs } from 'dayjs';
+import type { RecordBoardCalendarBookingLike } from '../../../types';
+/**
+ * 日历日期与时间轴纯函数：`fmtDate`、占用矩阵、月格、overlay 分段、周范围等，供 BookingCalendar 三视图共用。
+ */
+/** 与 {@link RecordBoardCalendarBookingLike} 一致，并支持跨日 endDate */
+export declare type CalendarBookingSegmentInput = RecordBoardCalendarBookingLike & {
+    endDate?: string;
+};
+export interface BookingSegmentForDate {
+    startHour: number;
+    endHour: number;
+    continuesPrev: boolean;
+    continuesNext: boolean;
+}
+export interface ViewNowReference {
+    dateKey: string;
+    hourFloat: number;
+}
+export declare function fmtDate(date: Date): string;
+/** 本地当前日期键与「日历时」小数小时，用于状态徽标与当前时刻线 */
+export declare function getViewNowReference(): ViewNowReference;
+export declare function parseDate(str: string): Date;
+export declare function addDays(date: Date, n: number): Date;
+export declare function startOfWeek(date: Date): Date;
+export declare function rangeDays(anchor: Date): Date[];
+/**
+ * 锚定日所在自然月的每一天（1 号至月末），用于资源视图横向「日」列。
+ */
+export declare function monthCalendarDays(anchor: Date): Date[];
+export declare function isHourInTimelineSlots(hour: number, hourSlots: number[] | undefined): boolean;
+export declare function formatHourLabel(hour: number): string;
+/**
+ * `YYYY-MM-DD` → `M/D`，跨日 booking 的 pill 内时间行用这个短日期前缀，
+ * 视觉上不挤占 pill 宽度（24px 左右）。
+ */
+export declare function formatShortMonthDay(dateKey: string): string;
+export declare function buildTimeOptions(start?: number, end?: number, sliceMinutes?: number): number[];
+export declare function monthGrid(date: Date, bookings: CalendarBookingSegmentInput[], courtsList: {
+    id: string;
+}[] | undefined, hourSlotsIn: number[] | undefined, slotStepHours?: number): {
+    date: Date;
+    key: string;
+    inMonth: boolean;
+    bookingCount: number;
+    blockCount: number;
+    fullyBooked: boolean;
+}[];
+export declare function getBookingSegmentForDate(item: CalendarBookingSegmentInput, dateKey: string): BookingSegmentForDate | null;
+/**
+ * 是否跨自然日（`endDate` 存在且与 `date` 不同）。单日 booking 返回 false。
+ */
+export declare function isCrossDayBooking(item: CalendarBookingSegmentInput): boolean;
+/**
+ * 把 booking 整段转成绝对毫秒区间：
+ * - `startMs = parseDate(date).setHours(...)`，按浮点小时拆出小时 / 分钟（30 min 步进）
+ * - `endMs` 同理；`endHour = 24` 时归一为「次日 00:00」
+ *
+ * 用于跨视图统一的 lane 抢占与重叠判定，避免「按格切」假设。
+ */
+export declare function getBookingFullSpanMs(item: CalendarBookingSegmentInput): {
+    startMs: number;
+    endMs: number;
+};
+/**
+ * 同 court 内两条 booking 的时间区间是否相交（`[startMs, endMs)` 半开区间，端点相邻不算交）。
+ * 跨 court 永远不算冲突（不同资源各画各的）。
+ */
+export declare function bookingsOverlap(a: CalendarBookingSegmentInput, b: CalendarBookingSegmentInput): boolean;
+/**
+ * 把 booking 整段转成「按日」的毫秒区间：
+ * - `startMs = parseDate(date).getTime()`
+ * - `endMs   = parseDate(endDate ?? date).getTime() + 1 day`
+ *
+ * 用于资源 / 月视图这类「一格 = 一天」的视图：同一天内不同小时的两条 booking
+ * 视觉上需要垂直 stack（占两个 lane），即使时间不重叠也不能合并到同一 lane。
+ */
+export declare function getBookingDaySpanMs(item: CalendarBookingSegmentInput): {
+    startMs: number;
+    endMs: number;
+};
+/**
+ * booking 的 day-span `[date, endDate]` 是否与 `[windowFirstKey, windowLastKey]` 相交。
+ *
+ * 用于 lane 抢占 / 行高计算阶段过滤掉与当前视口不相交的 booking：
+ * 后端为支持跨日 banner 续画把 `booking_time_start_between` 的下界外推 30 天，
+ * 这会把上月／前周的 booking 也带回 `bookings` 列表；视图层若直接用全量算 lane，
+ * 切到「当月没数据但上月有」的资源行时会保留上月 lane 数 → 行高被撑高。
+ *
+ * 只比较 `YYYY-MM-DD` 字符串（同 `monthGrid` 的 key 格式），不构造 Date 对象。
+ */
+export declare function bookingIntersectsDateWindow(item: {
+    date?: unknown;
+    endDate?: unknown;
+} | null | undefined, windowFirstKey: string, windowLastKey: string): boolean;
+/**
+ * 将 booking 的 day-span 截断到窗口 `[windowFirstKey, windowLastKey]`，超出窗口的部分裁掉，
+ * 用于月视图「按周独立 lane 抢占 + 跨周续画」：
+ *   - 与窗口完全不相交 → 返回 `null`；
+ *   - `date` 早于窗口 → 起点截到 `windowFirstKey`（视觉上 `clippedLeft`）；
+ *   - `endDate` 晚于窗口 → 终点截到 `windowLastKey`（视觉上 `clippedRight`）；
+ *   - 截断后只占一天的，回退为单日（`endDate` 设为 `undefined`）。
+ *
+ * 截断后的对象保留原 `id`、`courtId` 等字段，让 lane 抢占在窗口内独立判断重叠。
+ */
+export declare function clipBookingDaySpanToWindow(item: CalendarBookingSegmentInput, windowFirstKey: string, windowLastKey: string): CalendarBookingSegmentInput | null;
+/**
+ * 月 / 资源视图按日 lane：跨日 booking 在命中各日占**同一** lane；单日 booking 再逐日找空位。
+ *
+ * 1. 跨日优先（跨度长的先占），在 span 覆盖的每个自然日上取同一最小可用 lane；
+ * 2. 单日 booking 仅在各自命中日抢剩余 lane，不影响跨日条的纵向对齐。
+ */
+export declare function assignPerDateLanesCrossDayUnified(items: CalendarBookingSegmentInput[], dateKeysInOrder: string[]): {
+    perDateLanes: Map<string, Map<string, number>>;
+    laneCount: number;
+};
+/**
+ * 通用 lane 分配：返回 `Map<itemId, laneIndex>` 与 `laneCount`。
+ *
+ * @param granularity
+ *   - `'hour'`（默认，周 / 日视图）：用 `getBookingFullSpanMs`，同小时内不重叠的两条
+ *     booking 可以共享同一 lane（`bookingTime` 紧排）。
+ *   - `'day'`（资源 / 月视图）：用 `getBookingDaySpanMs`，同一天的两条 booking 一定占两 lane，
+ *     即使小时不重叠也要垂直 stack（一格只有一天宽，无法在水平方向区分）。
+ *
+ * 排序优先级（与设计约定一致）：
+ * 1. 跨日 booking 优先（先排，整段占顶 lane）；
+ * 2. 同类内按「跨度（endMs - startMs）降序」：跨度更长的先占 lane 0/1，
+ *    保证视觉上"长 pill 顶贴"，避免短 pill 把长 pill 推到下方造成"上方一周空白"；
+ * 3. 同跨度按 `startMs` 升序（更早开始的先占）；
+ * 4. 仍相同则按 `id` 字典序，保证渲染稳定。
+ *
+ * 然后逐条分配到第一个 `lastEndMs <= 当前 startMs` 的 lane（贪心区间着色）。
+ */
+export declare function assignLanesByInterval(items: CalendarBookingSegmentInput[], granularity?: 'hour' | 'day'): {
+    lanes: Map<string, number>;
+    laneCount: number;
+};
+export declare function dayOccupancy(courtId: string, dateKey: string, bookings: CalendarBookingSegmentInput[], hourSlots: number[] | undefined, slotStepHours: number): Record<number, CalendarBookingSegmentInput | null>;
+export interface SelectedSlotLike {
+    courtId: string;
+    date: string;
+    hour: number;
+}
+export declare function groupSelectedSlots(slots: SelectedSlotLike[], slotStepHours?: number): Array<{
+    courtId: string;
+    date: string;
+    startHour: number;
+    endHour: number;
+}>;
+/**
+ * 日视图空闲格：仅当全部为同一 court、同一日，且时间上首尾相接成一段时返回 true（与 {@link groupSelectedSlots} 合并规则一致）。
+ */
+export declare function isFreeSelectionContiguousSameResource(slots: SelectedSlotLike[], slotStepHours?: number): boolean;
+export declare function hasConflict(bookings: CalendarBookingSegmentInput[], courtId: string, date: string, startHour: number, endHour: number, ignoreId?: string | null): boolean;
+export declare function overlappingBookings(bookings: CalendarBookingSegmentInput[], courtId: string, date: string, startHour: number, endHour: number): CalendarBookingSegmentInput[];
+export declare function courtDaySummary(courtId: string, dateKey: string, bookings: CalendarBookingSegmentInput[], hourSlots: number[] | undefined, slotStepHours: number): {
+    occupiedHours: number[];
+    hasBlock: boolean;
+    fullyBooked: boolean;
+    items: CalendarBookingSegmentInput[];
+};
+export declare function sameSlot(a: SelectedSlotLike, b: SelectedSlotLike): boolean;
+/** 营业日 `dateStr` + 浮点小时（含半格）→ dayjs */
+export declare function dayAndHourToDayjs(dateStr: string, hourFloat: number): Dayjs;
+export declare function getDisplayStatusTag(item: CalendarBookingSegmentInput, dateKey: string): string | null;
+export declare function getLateMinutes(item: CalendarBookingSegmentInput, dateKey: string): number | null;
+export declare function currentTimeLabel(): string;
+export declare function formatDateLoose(str: string | undefined): string;
+export declare function formatTimelineStamp(value: string | undefined | null): {
+    date: string;
+    time: string;
+};
+/** 日视图 overlay 条（可原地写入 lane） */
+export declare type DayOverlayLaneMutable = {
+    courtId: string;
+    start: number;
+    span: number;
+    lane?: number;
+    laneCount?: number;
+};
+/**
+ * 同一 court 上时间重叠的 overlay 分配纵向 lane，避免多张卡片完全叠在同一矩形里。
+ * 使用按开始时间排序 + 贪心：每条预约放入「上一条已结束时间不晚于本段开始」的最小编号线。
+ */
+export declare function assignDayOverlapLanesInPlace(overlays: DayOverlayLaneMutable[]): void;
+/** 扫描时间轴：同一 court 在任一时刻的最大并行条数（用于行高，与分 lane 一致） */
+export declare function maxConcurrentBookingsOnCourt(overlays: Array<{
+    courtId: string;
+    start: number;
+    span: number;
+}>, courtId: string): number;
+/** 并行超过 cap 时：cap 条内容 + 1 行「+N」占位 */
+export declare function effectiveDayOverlayDisplayLaneCount(rawConcurrent: number): number;
+/** 同一 court 下时间轴区间相交的 overlay 归为一簇（用于 3+N 合并展示） */
+export declare function clusterDayCourtOverlaysByOverlap<T extends {
+    courtId: string;
+    start: number;
+    span: number;
+}>(overlays: T[], courtId: string): T[][];
+export declare function dayOverlayHiddenKey(item: {
+    id?: string | number;
+} | null | undefined, dayKey: string, courtId: string): string;
+/**
+ * 将 totalInner 像素整数分给 n 条竖向 lane（含缝），保证 Σheight + Σgap === totalInner，消除底部留白缝。
+ */
+export declare function dayOverlayLaneMetrics(totalInner: number, laneCount: number, gap: number): {
+    topFor: (lane: number) => number;
+    heightFor: (lane: number) => number;
+};
+export interface BuildOverlayBookingRow {
+    kind: string;
+    id: string;
+}
+export interface BuiltDayOverlay {
+    item: CalendarBookingSegmentInput;
+    rowIndex: number;
+    rowTop: number;
+    rowHeight: number;
+    courtId: string;
+    start: number;
+    end: number;
+    span: number;
+    continuesNext?: boolean;
+    continuesPrev?: boolean;
+    lane?: number;
+    laneCount?: number;
+}
+export declare function buildOverlayBookings(visibleCourtRows: BuildOverlayBookingRow[], dayKey: string, bookings: CalendarBookingSegmentInput[], rowTopMap: Record<string, number> | undefined, hourSlots: number[] | undefined, dayRowHeights: number[], slotStepHours?: number): BuiltDayOverlay[];
+/** 日视图：按行高累加每行 rowTop（court / group） */
+export declare function buildDayRowTopMap(visibleCourtRows: Array<{
+    id: string;
+}>, heights: number[]): Record<string, number>;
+/** 日历状态徽标：返回 i18n key + className；文案在 UI 层通过 tCal 解析，便于 utils 单测 */
+export declare function statusTagMetaParts(tag: string | null | undefined): {
+    labelI18nKey: string;
+    className: string;
+} | null;
+export declare type CalendarCourtNameRow = {
+    id: string;
+    name?: string | null;
+};
+export declare function getBookingDetailData(item: CalendarBookingSegmentInput, courtsList?: CalendarCourtNameRow[]): {
+    rawSales: null;
+    bookingId: string;
+    orderNumber: string;
+    shopOrderNumber: string;
+    orderStatus: string;
+    appointmentStatus: string;
+    paymentStatus: string;
+    customer: {
+        id: null;
+        name: string;
+        email: string;
+        phone: string;
+    };
+    guestCount: number;
+    checkedInCount: number;
+    guests: never[];
+    schedule: {
+        startDate: string;
+        startTime: string;
+        endDate: string;
+        endTime: string;
+        duration: number;
+        arrivedAt: null;
+        completedAt: null;
+    };
+    resources: never[];
+    summaryItems: never[];
+    items: never[];
+    note: string;
+    files: {
+        form: never[];
+        uploaded: never[];
+        invoice: never[];
+    };
+    payments: never[];
+    history: never[];
+    summary: {};
+    paymentSummary: {
+        totalAmount: number;
+        paidAmount: number;
+        balanceAmount: number;
+        currencySymbol: string;
+        isFullyPaid: boolean;
+    };
+    itemSummary: {
+        itemCount: number;
+        itemQtyTotal: number;
+    };
+    headerSummary: {
+        customerName: string;
+        guestCount: number;
+        checkedInCount: number;
+        timeLabel: string;
+        resourceLabel: string;
+    };
+    headerTags: {
+        paymentTag: string;
+        fulfillmentTag: string;
+        hasNote: boolean;
+        paymentStatus: string;
+        orderStatus: string;
+    };
+    fileCount: number;
+    canChangeCustomer: boolean;
+    noteCount: number;
+    noteGroups: {
+        internal: never[];
+        order: {
+            id: string;
+            label: string;
+            text: string;
+        }[];
+        item: never[];
+    };
+    metaFlags: {
+        itemsChanged: boolean;
+        paymentsChanged: boolean;
+        guestChanged: boolean;
+        filesChanged: boolean;
+        notesChanged: boolean;
+        formChanged: boolean;
+        uploadedChanged: boolean;
+        invoiceChanged: boolean;
+        historyChanged: boolean;
+    };
+    actions: never[];
+};

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

@@ -0,0 +1,7 @@
+import type { ResourceCellPick } from '../bookingCalendarInternalTypes';
+/**
+ * 资源视图选区是否「同一 court + 连续多天」：
+ * 仅当满足时才允许 Block / Create Booking（与日视图「同 court 连续多小时」语义对应）。
+ * 单天选中（n === 1）也算连续。
+ */
+export declare function isResourceSelectionContiguousSameCourt(selections: ResourceCellPick[]): boolean;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarDaySelectionBar.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+import { type SelectedSlotLike } from '../utils/bookingCalendarDateUtils';
+export declare type BookingCalendarDaySelectionBarProps = {
+    slotStepHours: number;
+    selectedFreeSlots: SelectedSlotLike[];
+    /**
+     * 资源视图：真实选中记在「按日格子」上，不向栏传入展开后的小时槽数组（避免与格数等价的巨数组 + 栏内重复排序）。
+     * 传此对象时，用其字段驱动显隐与锁台按钮，忽略 selected*Slots 的长度（传 [] 即可）。
+     */
+    resourceSelectionSummary?: {
+        freePickCount: number;
+        blockPickCount: number;
+        /** 资源视图：仅单选时可点「屏蔽」 */
+        freeAllowsBlockPanel: boolean;
+    } | null;
+    deselectAll: () => void;
+    onOpenBlockPanel: () => void;
+    createBookingFromSelection: () => void;
+};
+/** 日视图底部：多选空闲 / 锁台后的固定操作条 */
+export declare function BookingCalendarDaySelectionBar({ slotStepHours, selectedFreeSlots, resourceSelectionSummary, deselectAll, onOpenBlockPanel, createBookingFromSelection, }: BookingCalendarDaySelectionBarProps): JSX.Element | null;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarDayView.d.ts

@@ -0,0 +1,52 @@
+/** 日视图：横向虚拟滚动时间轴 + 资源行，预约条按 lane 叠放与 +N 溢出 */
+import React from 'react';
+import { type TickFillMode } from '../utils/bookingCalendarAxis';
+import type { RecordBoardCalendarProps } from '../../../types';
+/** 日视图（含底部多选操作条） */
+export declare function BookingCalendarDayView(dayProps: {
+    calendarProps: RecordBoardCalendarProps;
+    isLight: boolean;
+    view: string;
+    anchorDate: Date;
+    dayKey: string;
+    hourSlots: number[];
+    resolvedSlotMinutes: number;
+    slotColWidth: number;
+    firstTimelineHour: number;
+    endTimelineExclusive: number;
+    isBusinessHour: (h: number) => boolean;
+    dayHourRemaining: Record<number, {
+        remaining: number;
+        total: number;
+        ratio: number;
+    }>;
+    timelinePxPerHour: number;
+    dayContentHeight: number;
+    dayRowHeights: number[];
+    visibleCourtRows: any[];
+    overlayBookings: any[];
+    dayOverlayOverflowPluses: any[];
+    setCollapsedGroups: React.Dispatch<React.SetStateAction<any>>;
+    visibleCourts: any[];
+    bookings: any[];
+    slotStepHours: number;
+    isFreeSelected: (courtId: string, hour: number) => boolean;
+    isBlockSelected: (courtId: string, hour: number) => boolean;
+    toggleSlot: (courtId: string, hour: number) => void;
+    handleDropMove: (courtId: string, date: string, hour: number) => void;
+    hiddenDayOverlayIdSet: Set<string>;
+    courtDayDisplayLaneCount: Record<string, number>;
+    openBookingDetail: (item: any) => void;
+    setDraggingItem: (item: any) => void;
+    setNavDirection: (n: number) => void;
+    commitAnchor: (d: Date) => void;
+    setFocusedCourtId: (id: string | null) => void;
+    setOverflowListModal: React.Dispatch<React.SetStateAction<any>>;
+    selectedFreeSlots: any[];
+    selectedBlockSlots: any[];
+    focusedCourtId: string | null;
+    /** >0 表示刚从周/月切入日视图，需将横向滚动对准「当前时间」（仅当 dayKey 为今天时生效） */
+    dayTimelineScrollToNowToken: number;
+    /** 预约条在主轴刻度上的填充方式（由 BookingCalendar 按视图默认解析后传入） */
+    tickFillMode: TickFillMode;
+}): JSX.Element;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarGroupRowHeader.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 日视图 / 周视图共用的分组头左侧 sticky 单元（折叠箭头 + 分组名 + 数量角标）。
+ * 样式单点维护，与 {@link buildGroupedCourtRows} 的 group 行对应。
+ */
+import React from 'react';
+import type { RecordBoardCalendarProps } from '../../../types';
+export interface BookingCalendarGroupRowModel {
+    id: string;
+    label: string;
+    count: number;
+    collapsed: boolean;
+}
+export interface BookingCalendarGroupRowHeaderProps {
+    isLight: boolean;
+    /** 透传给 `renderResourceCell`（低代码自定义左侧格） */
+    view: 'day' | 'week' | 'resource';
+    row: BookingCalendarGroupRowModel;
+    renderResourceCell?: RecordBoardCalendarProps['renderResourceCell'];
+    setCollapsedGroups: React.Dispatch<React.SetStateAction<Record<string, boolean>>>;
+    /** 日视图虚拟格子/grid 定位时使用 */
+    style?: React.CSSProperties;
+}
+export declare function BookingCalendarGroupRowHeader(props: BookingCalendarGroupRowHeaderProps): JSX.Element;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarMonthView.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="react" />
+/**
+ * 月视图：5 行 × 7 列。
+ *
+ * 跨日 booking 用 absolute overlay 跨日列 banner 渲染（M1：跨自然周边界续画 + 端部 ◀/▶）：
+ *   - 每周内跨日 booking 占统一 lane，单日 booking 逐日填剩余空位；
+ *   - 行高内自适应 effectiveMaxLane，超出 → cell 级 `+N` tile；
+ *   - cell 层只负责日期 header / 点击跳日 / drop 改期，不再渲染 booking 列表（被 overlay 替代）。
+ */
+export declare function BookingCalendarMonthView({ isLight, anchorDate, monthDays, bookings, goToDayFromCell, handleGridDropMove, setDraggingItem, openBookingDetail, setOverflowListModal, renderMonthWeekBooking, tickFillMode, }: {
+    isLight: any;
+    anchorDate: any;
+    monthDays: any;
+    bookings: any;
+    goToDayFromCell: any;
+    handleGridDropMove: any;
+    setDraggingItem: any;
+    openBookingDetail: any;
+    setOverflowListModal: any;
+    renderMonthWeekBooking: any;
+    tickFillMode: any;
+}): JSX.Element;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarResourceView.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 资源视图（按月）：与日视图同款骨架——冻结左列 + 横向滚动 + sticky 顶部表头。
+ *
+ * 与日视图的唯一差异：
+ *   - 日视图：横轴 = 营业小时槽，cell = 一个小时；booking 通过 overlay 跨 cell 横铺。
+ *   - 资源视图：横轴 = 当月每一天，cell = 一个 (court, date)；booking 通过 overlay 在 cell 内
+ *     垂直 stack 渲染（最多 3 条 + `+N` 溢出 tile）。
+ *
+ * 性能策略（与日视图对齐）：
+ *   - cell 是「轻 placeholder」：只渲染背景色 + selected ring + 空 dashed slot/Selected 文本。
+ *   - 所有 booking 卡片 / `+N` tile 由 `BookingOverlay` 单独 absolute 渲染，独立于 grid。
+ *   - 这样 grid 内 DOM 极轻，浏览器每帧 paint/layout 与日视图同档（cell 内含复杂 booking
+ *     卡片时实测每列 ~7ms paint 成本，整月 30 列 → ~150ms；overlay 化后接近零）。
+ *
+ * 选中：与日视图 `toggleSlot(courtId, hour)` 等价的「`toggleResourceCell(courtId, dateKey)`」。
+ * 选中态合并到 cell 自身 className（与日视图一致），不插入额外 grid item，避免 CSS Grid 整表 reflow。
+ */
+import React from 'react';
+import { type TickFillMode } from '../utils/bookingCalendarAxis';
+import type { RecordBoardCalendarProps } from '../../../types';
+declare type ResourceCellPick = {
+    courtId: string;
+    dateKey: string;
+};
+export declare const BookingCalendarResourceView: React.MemoExoticComponent<typeof BookingCalendarResourceViewInner>;
+declare function BookingCalendarResourceViewInner({ calendarProps, isLight, anchorDate, monthDays, slotColWidth, bookings, visibleCourts, visibleCourtRows, hourSlots, slotStepHours, handleGridDropMove, openBookingDetail, setDraggingItem, setCollapsedGroups, setOverflowListModal, resourceMonthScrollToTodayToken, resourceDayHeaderRemaining, toggleResourceCell, selectedResourceCells, tickFillMode, }: {
+    calendarProps: RecordBoardCalendarProps;
+    isLight: boolean;
+    anchorDate: Date;
+    monthDays: Date[];
+    slotColWidth: number;
+    bookings: any[];
+    visibleCourts: any[];
+    visibleCourtRows: any[];
+    hourSlots: number[];
+    slotStepHours: number;
+    handleGridDropMove: (dateKey: string, courtId?: string | null) => void;
+    openBookingDetail: (item: any) => void;
+    setDraggingItem: (item: any) => void;
+    setCollapsedGroups: React.Dispatch<React.SetStateAction<any>>;
+    setOverflowListModal: React.Dispatch<React.SetStateAction<any>>;
+    /** 切入资源视图时递增，用于将横向滚动对准「今天」列 */
+    resourceMonthScrollToTodayToken: number;
+    /** 顶部表头当日空闲率（与日视图 freeRatio 同口径） */
+    resourceDayHeaderRemaining: Record<string, {
+        remaining: number;
+        total: number;
+        ratio: number;
+    }>;
+    /** 与日视图 `toggleSlot` 同义：点击 cell 切换 (court, date) 的整天选中态 */
+    toggleResourceCell: (courtId: string, dateKey: string) => void;
+    /** 当前所有「资源月视图」选中的 cell（同 court 连续多天 → SelectionBar 显示 Block/Create） */
+    selectedResourceCells: ResourceCellPick[];
+    /** 预约条在主轴刻度上的填充方式（由 BookingCalendar 按视图默认解析后传入） */
+    tickFillMode: TickFillMode;
+}): JSX.Element;
+export {};

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarWeekView.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { RecordBoardCalendarProps } from '../../../types';
+import { type TickFillMode } from '../utils/bookingCalendarAxis';
+/**
+ * 周视图：7 日网格 + 左侧分组（可折叠），单元格调起日视图；格内 drop 触发改期草稿。
+ */
+export declare function BookingCalendarWeekView({ calendarProps, isLight, weekDays, bookings, courts, hourSlots, slotStepHours, visibleCourts, visibleCourtRows, isBusinessHour, goToDayFromCell, handleGridDropMove, openBookingDetail, setDraggingItem, setCollapsedGroups, setOverflowListModal, tickFillMode, }: {
+    calendarProps: RecordBoardCalendarProps;
+    isLight: boolean;
+    weekDays: Date[];
+    bookings: any[];
+    courts: any[];
+    hourSlots: number[];
+    slotStepHours: number;
+    visibleCourts: any[];
+    visibleCourtRows: any[];
+    isBusinessHour: (h: number) => boolean;
+    goToDayFromCell: (d: Date, courtId: string | null, src: string) => void;
+    handleGridDropMove: (dateKey: string, courtId?: string | null) => void;
+    openBookingDetail: (item: any) => void;
+    setDraggingItem: (item: any) => void;
+    setCollapsedGroups: React.Dispatch<React.SetStateAction<any>>;
+    setOverflowListModal: React.Dispatch<React.SetStateAction<any>>;
+    /** 预约条在主轴刻度上的填充方式（由 BookingCalendar 按视图默认解析后传入） */
+    tickFillMode: TickFillMode;
+}): JSX.Element;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/bookingCalendarDayViewContext.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { RecordBoardCalendarProps } from '../../../types';
+/** 供日视图拆分出的子组件读取 `calendarProps` / 明暗，避免每层透传（可选使用） */
+export declare type BookingCalendarDayChromeContextValue = {
+    calendarProps: RecordBoardCalendarProps;
+    isLight: boolean;
+};
+export declare function BookingCalendarDayChromeProvider({ children, value, }: {
+    children: React.ReactNode;
+    value: BookingCalendarDayChromeContextValue;
+}): JSX.Element;
+export declare function useBookingCalendarDayChrome(): BookingCalendarDayChromeContextValue;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/day/useBookingCalendarDayHourRemaining.d.ts

@@ -0,0 +1,10 @@
+import type { CalendarBookingSegmentInput } from '../../utils/bookingCalendarDateUtils';
+export declare function useBookingCalendarDayHourRemaining(visibleCourts: Array<{
+    id: string;
+}>, dayKey: string, bookings: CalendarBookingSegmentInput[], hourSlots: number[], slotStepHours: number, isBusinessHour: (h: number) => boolean): {
+    [k: string]: {
+        remaining: number;
+        total: number;
+        ratio: number;
+    };
+};

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/day/useBookingCalendarDaySelection.d.ts

@@ -0,0 +1,11 @@
+import type { Dispatch, SetStateAction } from 'react';
+import { type CalendarBookingSegmentInput } from '../../utils/bookingCalendarDateUtils';
+import type { FreeSlotSelection } from '../../bookingCalendarInternalTypes';
+export declare function useBookingCalendarDaySelection(dayKey: string, bookings: CalendarBookingSegmentInput[], hourSlots: number[], slotStepHours: number, courts: Array<{
+    id: string;
+    name?: string;
+}>, selectedFreeSlots: FreeSlotSelection[], selectedBlockSlots: FreeSlotSelection[], setSelectedFreeSlots: Dispatch<SetStateAction<FreeSlotSelection[]>>, setSelectedBlockSlots: Dispatch<SetStateAction<FreeSlotSelection[]>>): {
+    isFreeSelected: (courtId: string, hour: number) => boolean;
+    isBlockSelected: (courtId: string, hour: number) => boolean;
+    toggleSlot: (courtId: string, hour: number) => void;
+};

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/resource/useBookingCalendarResourceCellToggle.d.ts

@@ -0,0 +1,3 @@
+import type { Dispatch, SetStateAction } from 'react';
+import type { ResourceCellPick } from '../../bookingCalendarInternalTypes';
+export declare function useBookingCalendarResourceCellToggle(setSelectedResourceCells: Dispatch<SetStateAction<ResourceCellPick[]>>): (courtId: string, dateKey: string) => void;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/resource/useBookingCalendarResourceDayHeaderRemaining.d.ts

@@ -0,0 +1,8 @@
+import type { CalendarBookingSegmentInput } from '../../utils/bookingCalendarDateUtils';
+export declare function useBookingCalendarResourceDayHeaderRemaining(resourceMonthDays: Date[], visibleCourts: Array<{
+    id: string;
+}>, bookings: CalendarBookingSegmentInput[], hourSlots: number[], slotStepHours: number): Record<string, {
+    remaining: number;
+    total: number;
+    ratio: number;
+}>;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/view/useBookingCalendarGoToDayFromCell.d.ts

@@ -0,0 +1,3 @@
+import type { Dispatch, SetStateAction } from 'react';
+import type { CalendarViewMode, FreeSlotSelection, ResourceCellPick, TransitioningToDayState } from '../bookingCalendarInternalTypes';
+export declare function useBookingCalendarGoToDayFromCell(anchorDate: Date, commitAnchor: (d: Date) => void, commitView: (v: CalendarViewMode) => void, setNavDirection: Dispatch<SetStateAction<number>>, setTransitioningToDay: Dispatch<SetStateAction<TransitioningToDayState | null>>, setSelectedFreeSlots: Dispatch<SetStateAction<FreeSlotSelection[]>>, setSelectedBlockSlots: Dispatch<SetStateAction<FreeSlotSelection[]>>, setSelectedResourceCells: Dispatch<SetStateAction<ResourceCellPick[]>>, setFocusedCourtId: Dispatch<SetStateAction<string | null>>): (day: Date, courtId: string | null, source: string) => void;

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

@@ -0,0 +1,8 @@
+/**
+ * RecordBoard 列显示隐藏设置（仅控制表格列展示，不控制 filter/sort）。
+ * 参考 table Actions ColumnsSetting，仅保留显隐切换，无拖拽排序。
+ */
+import React from 'react';
+import './index.less';
+declare const RecordBoardColumnSetting: React.FC;
+export default RecordBoardColumnSetting;

package/lib/components/pisellRecordBoard/shellFrame/FloorMap.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { RecordBoardFloorMapProps } from '../types';
+/**
+ * RecordBoard 平面图槽位：仅在 PisellRecordBoard.ShellFrame 内使用，本身不渲染 DOM。
+ * 将 PisellFloorMapLayout 所需 props 声明在树结构上；与 GridLayout 并存时出现「表格 / 平面图」切换。
+ *
+ * @example
+ * <PisellRecordBoard.ShellFrame>
+ *   <PisellRecordBoard.GridLayout />
+ *   <PisellRecordBoard.FloorMap floorMapConfig={...} dataSources={...} />
+ * </PisellRecordBoard.ShellFrame>
+ */
+declare const RecordBoardFloorMap: React.FC<RecordBoardFloorMapProps>;
+export default RecordBoardFloorMap;

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

@@ -0,0 +1,14 @@
+import React from 'react';
+import './index.less';
+import type { RecordBoardContextValue } from '../../types';
+export interface RecordBoardPaginationProps extends Partial<Pick<RecordBoardContextValue, 'pagination' | 'total' | 'onPageChange' | 'loading'>> {
+    className?: string;
+    style?: React.CSSProperties;
+    render?: (ctx: RecordBoardContextValue) => React.ReactNode;
+}
+/**
+ * RecordBoard 下的分页：接入 packages/materials 的 Pagination，从 context 取 pagination / total / onPageChange；可透传 childComponentProps.pagination。
+ * 当 context 中 pagination 缺失时使用默认分页，避免在 Storybook 或未完整注入 context 时报错。
+ */
+declare const RecordBoardPagination: React.FC<RecordBoardPaginationProps>;
+export default RecordBoardPagination;

package/lib/components/pisellRecordBoard/shellFrame/ResourceWall/NoteTicker.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import './VenueWallMarquee.less';
+export interface NoteTickerProps {
+    text: string;
+    color: string;
+    /** 跑完一整段所需秒数 */
+    duration?: number;
+    shouldMarquee: boolean;
+}
+/**
+ * 底部说明条：短文案省略静态展示，长文案无缝跑马灯（多段 copy 与 `VenueWallMarquee.less` 中 -33.333% 动画配套）。
+ * 系统「减少动态效果」时强制静态展示；跑马灯区对读屏 `aria-hidden` 避免重复朗读。
+ */
+export declare const NoteTicker: React.NamedExoticComponent<NoteTickerProps>;