@pisell/materials 6.11.223 → 6.11.224

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

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { RecordBoardCalendarBookingLike, RecordBoardCalendarBookingRenderArgs } 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;
+    /** 仅日视图 lane 溢出：透传宿主 `renderBooking`（RoomCard） */
+    renderBooking?: (args: RecordBoardCalendarBookingRenderArgs) => React.ReactNode;
+    onDragStart?: (item: RecordBoardCalendarBookingLike) => void;
+};
+/**
+ * 全局溢出预约列表弹层（日视图 lane 与月/周/资源 `+N` 点开后）。
+ * 日视图列表行可走宿主 RoomCard；其它视图使用内置列表行。
+ */
+export declare function BookingCalendarOverflowListLayer({ overflowPanelRef, isLight, modal, onClose, onPickItem, renderBooking, onDragStart, }: BookingCalendarOverflowListLayerProps): JSX.Element;

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

@@ -0,0 +1,30 @@
+import React from 'react';
+import { type CalendarBookingSegmentInput } from '../utils/bookingCalendarDateUtils';
+import type { RecordBoardCalendarBookingLike, RecordBoardCalendarBookingRenderArgs } from '../../../types';
+export declare type OverflowListModalVirtualListProps = {
+    items: CalendarBookingSegmentInput[];
+    dateKey: string;
+    onPickItem: (item: CalendarBookingSegmentInput) => void;
+    onClose: () => void;
+    /**
+     * 为 true 时按日视图逻辑展示状态徽标与状态底色（日视图 lane 溢出列表）。
+     * 月 / 周 / 资源 +N 弹层为 false，使用内置列表行（名称 + 时间）。
+     * @default true
+     */
+    showStatusUi?: boolean;
+    /**
+     * 为 true 且宿主提供 `renderBooking` 时，列表行复用日视图 RoomCard；
+     * 月 / 周 / 资源 +N 弹层恒为 false，不走宿主格内卡片。
+     */
+    isDayLaneOverflow?: boolean;
+    isLight?: boolean;
+    /** 仅日视图 lane 溢出：透传宿主 `renderBooking` */
+    renderBooking?: (args: RecordBoardCalendarBookingRenderArgs) => React.ReactNode;
+    onDragStart?: (item: RecordBoardCalendarBookingLike) => void;
+};
+/**
+ * 溢出预约列表弹层：`FixedSizeList` 虚拟列表。
+ * - 日视图 lane +N：宿主 `renderBooking`（RoomCard）
+ * - 月 / 周 / 资源 +N：内置列表行（名称 + 时间），不用格内自定义卡片
+ */
+export declare function OverflowListModalVirtualList({ items, dateKey, onPickItem, onClose, showStatusUi, isDayLaneOverflow, isLight, renderBooking, onDragStart, }: OverflowListModalVirtualListProps): JSX.Element | null;

package/es/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;

package/es/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/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,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/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,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/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 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 {};