@pisell/materials 6.11.108 → 6.11.109

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

@@ -0,0 +1,236 @@
+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;
+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;
+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/es/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/es/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/es/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarDayView.d.ts

@@ -0,0 +1,49 @@
+/** 日视图：横向虚拟滚动时间轴 + 资源行，预约条按 lane 叠放与 +N 溢出 */
+import React from 'react';
+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;
+}): JSX.Element;

package/es/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/es/components/pisellRecordBoard/shellFrame/Calendar/view/BookingCalendarMonthView.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="react" />
+/** 月视图：由 BookingCalendar 传入数据与交互，本文件仅负责渲染结构 */
+export declare function BookingCalendarMonthView({ isLight, anchorDate, monthDays, bookings, goToDayFromCell, handleGridDropMove, setDraggingItem, openBookingDetail, overflowPopover, setOverflowPopover, overflowListModal, setOverflowListModal, overflowPanelRef, renderMonthWeekBooking, }: {
+    isLight: any;
+    anchorDate: any;
+    monthDays: any;
+    bookings: any;
+    goToDayFromCell: any;
+    handleGridDropMove: any;
+    setDraggingItem: any;
+    openBookingDetail: any;
+    overflowPopover: any;
+    setOverflowPopover: any;
+    overflowListModal: any;
+    setOverflowListModal: any;
+    overflowPanelRef: any;
+    renderMonthWeekBooking: any;
+}): JSX.Element;

package/es/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 { 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, overflowPopover, setOverflowPopover, setOverflowListModal, overflowPanelRef, resourceMonthScrollToTodayToken, resourceDayHeaderRemaining, toggleResourceCell, selectedResourceCells, }: {
+    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>>;
+    overflowPopover: any;
+    setOverflowPopover: React.Dispatch<React.SetStateAction<any>>;
+    setOverflowListModal: React.Dispatch<React.SetStateAction<any>>;
+    overflowPanelRef: React.RefObject<HTMLDivElement | null>;
+    /** 切入资源视图时递增，用于将横向滚动对准「今天」列 */
+    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[];
+}): JSX.Element;
+export {};

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

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { RecordBoardCalendarProps } from '../../../types';
+/**
+ * 周视图：7 日网格 + 左侧分组（可折叠），单元格调起日视图；格内 drop 触发改期草稿。
+ */
+export declare function BookingCalendarWeekView({ calendarProps, isLight, weekDays, bookings, courts, hourSlots, slotStepHours, visibleCourts, visibleCourtRows, isBusinessHour, goToDayFromCell, handleGridDropMove, openBookingDetail, setDraggingItem, setCollapsedGroups, overflowPopover, setOverflowPopover, overflowListModal, setOverflowListModal, overflowPanelRef, }: {
+    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>>;
+    overflowPopover: any;
+    setOverflowPopover: React.Dispatch<React.SetStateAction<any>>;
+    overflowListModal: any;
+    setOverflowListModal: React.Dispatch<React.SetStateAction<any>>;
+    overflowPanelRef: React.RefObject<HTMLDivElement | null>;
+}): JSX.Element;

package/es/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/es/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/es/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/es/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/es/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/es/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/es/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/es/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/es/components/pisellRecordBoard/shellFrame/ResourceWall/PisellRecordBoardResourceWallView.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { RecordBoardResourceWallProps } from '../../types';
+import './ResourceWallViewport.less';
+/** 与 {@link RecordBoardResourceWallProps.filterFieldKey} 默认一致 */
+export declare const DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY = "resource_wall_resource_ids";
+/**
+ * RecordBoard 大屏资源墙主视口：`cards` 提供全量卡数据；可见列表由
+ * `searchParams.filter.values[filterFieldKey]` 中的资源 id 与 `cards` 交集决定。
+ * 若 ToolBar `searchParams.sort` 指向状态列（默认字段名 `status`），则按占用态重排展示顺序。
+ * 支持网格分页轮播、浅深外观、伪全屏与控制台（布局 / 配色 / 选中资源）。
+ */
+export declare const PisellRecordBoardResourceWallView: React.FC<RecordBoardResourceWallProps>;

package/es/components/pisellRecordBoard/shellFrame/ResourceWall/RecordBoardResourceWall.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { RecordBoardResourceWallProps } from '../../types';
+/**
+ * RecordBoard 大屏资源墙槽位：仅在 PisellRecordBoard.ShellFrame 内使用，本身不渲染 DOM。
+ * 与 GridLayout / FloorMap / Calendar 并存时出现视图切换。
+ */
+declare const RecordBoardResourceWall: React.FC<RecordBoardResourceWallProps>;
+export default RecordBoardResourceWall;

package/es/components/pisellRecordBoard/shellFrame/ResourceWall/ResourceWallControlPanel.d.ts

@@ -0,0 +1,50 @@
+import React from 'react';
+import { type VenueWallStatusToneOverrides } from './venueWallUtils';
+export declare type ResourceWallLayoutPreset = {
+    key: string;
+    label: string;
+    cols: number;
+    rows: number;
+};
+export declare type ResourceWallControlPanelApplyPayload = {
+    resourceIds: string[];
+    layoutKey: string;
+    customCols: number;
+    customRows: number;
+    pageDurationSec: number;
+    occupiedCardColor: string;
+    availableCardColor: string;
+    boardingSoonBeforeMin: number;
+    statusToneOverrides: VenueWallStatusToneOverrides;
+    /** 与 test.tsx「主文案基准宽度占比」对接，写入 {@link VenueWallCard} */
+    heroMaxWidthRatio: number;
+};
+export interface ResourceWallControlPanelProps {
+    open: boolean;
+    onClose: () => void;
+    isDark: boolean;
+    layoutPresets: readonly ResourceWallLayoutPreset[];
+    layoutKey: string;
+    customCols: number;
+    customRows: number;
+    pageDurationSec: number;
+    occupiedCardColor: string;
+    availableCardColor: string;
+    boardingSoonBeforeMin: number;
+    statusToneOverrides: VenueWallStatusToneOverrides | undefined;
+    selectedResourceIds: string[];
+    onApply: (payload: ResourceWallControlPanelApplyPayload) => void;
+    /** 与 test.tsx「当前分页 / 倒计时」展示一致（1-based current） */
+    carouselPager: {
+        currentPage: number;
+        totalPages: number;
+    };
+    /** 主文案宽度占比初值，与 {@link VenueWallCardProps.heroMaxWidthRatio} 一致 */
+    heroMaxWidthRatio?: number;
+}
+/**
+ * 资源墙管理台（Portal）：选资源、网格预设/自定义行列、翻页秒数、占用/空闲色、六态说明与色值；
+ * `onApply` 回传负载中含 `diffVenueWallStatusToneOverrides` 压缩结果。
+ * 源自 test `showAdmin` 对接；关闭（Close / Escape / 遮罩）时提交草稿并关闭。
+ */
+export declare const ResourceWallControlPanel: React.FC<ResourceWallControlPanelProps>;

package/es/components/pisellRecordBoard/shellFrame/ResourceWall/ResourceWallControlPanelColorTab.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { type VenueWallStatusKey, type VenueWallStatusTone } from './venueWallUtils';
+export interface ResourceWallControlPanelColorTabProps {
+    adminSectionBg: string;
+    adminInputBg: string;
+    headerText: string;
+    mutedText: string;
+    divider: string;
+    draftOcc: string;
+    setDraftOcc: (v: string) => void;
+    draftAvail: string;
+    setDraftAvail: (v: string) => void;
+    draftTones: Record<VenueWallStatusKey, VenueWallStatusTone>;
+    setDraftTones: React.Dispatch<React.SetStateAction<Record<VenueWallStatusKey, VenueWallStatusTone>>>;
+}
+/** 控制台「外观 / 颜色」分页：占用/空闲底色与六态表格 */
+export declare const ResourceWallControlPanelColorTab: React.FC<ResourceWallControlPanelColorTabProps>;

package/es/components/pisellRecordBoard/shellFrame/ResourceWall/ResourceWallControlPanelLayoutTab.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+export interface ResourceWallControlPanelLayoutTabProps {
+    adminSectionBg: string;
+    adminInputBg: string;
+    headerText: string;
+    mutedText: string;
+    layoutPresets: readonly {
+        key: string;
+        label: string;
+        cols: number;
+        rows: number;
+    }[];
+    draftLayoutKey: string;
+    setDraftLayoutKey: (v: string) => void;
+    draftCustomCols: number;
+    setDraftCustomCols: (v: number) => void;
+    draftCustomRows: number;
+    setDraftCustomRows: (v: number) => void;
+    draftPageSec: number;
+    setDraftPageSec: (v: number) => void;
+    draftHeroRatio: number;
+    setDraftHeroRatio: (v: number) => void;
+    carouselCur: number;
+    carouselTot: number;
+    isDark: boolean;
+}
+/** 控制台「资源 / 布局」分页：预设、自定义行列、翻页停留、主文案宽度 */
+export declare const ResourceWallControlPanelLayoutTab: React.FC<ResourceWallControlPanelLayoutTabProps>;