@pisell/materials 6.11.241 → 6.11.243

package/lib/components/pisellFloorMapLayout/utils/floorMapCanvasDisplay.d.ts

@@ -0,0 +1,27 @@
+import type { FloorMapCanvas, FloorMapCanvasNameI18n } from '../types';
+/**
+ * 合并平面图 Tab 用多语言包（与业务侧 `locales.init` 可叠加）。
+ */
+export declare function initFloorMapLayoutLocales(engineLocale: string): void;
+/** 与 List / 预约等物料一致：storage → 宿主 getLocale → native_locale → materials 当前语言 */
+export declare function getFloorMapDisplayLocale(engineCtx?: unknown): string;
+/**
+ * 按当前语言（或显式传入语言）从平面图语言包取文案，**不依赖全局激活语言**
+ * （避免多组件 init 竞态），缺失时回退英文，再回退 key 本身。
+ */
+export declare function getFloorMapLayoutText(id: string, displayLocale?: string): string;
+/**
+ * 从多语言对象中取当前 locale 下展示字符串，缺省按 en → 其余首个非空。
+ */
+export declare function pickFloorMapCanvasI18nString(obj: FloorMapCanvasNameI18n, engineLocale: string): string;
+/**
+ * 画布在 Tab / 下拉中的展示名：
+ * 1. `name` 为多语言对象时 **优先** 按引擎 locale 取字段（与配置内嵌文案一致）；
+ * 2. 否则 `nameKey` + `locales.getText`（需业务侧已 init 对应语言包）；
+ * 3. 否则 `name` 字符串。
+ */
+export declare function getFloorMapCanvasDisplayName(canvas: FloorMapCanvas, engineLocale: string): string;
+/**
+ * 打开重命名弹层时的初始多语言值（与 Translation 表单一致）。
+ */
+export declare function seedFloorMapCanvasNameI18n(canvas: FloorMapCanvas, displayFallback: string): FloorMapCanvasNameI18n;

package/lib/components/pisellFloorMapLayout/utils/floorMapConfigMerge.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 将当前画布的 sceneElements 合并为 Layout 使用的 FloorMapMergedItem[]
+ */
+import type { FloorMapViewConfig, FloorMapMergedItem } from '../types';
+/**
+ * 合并指定画布下的 sceneElements 为一份 items（用于 ItemLayer / EditableItemLayer）
+ */
+export declare function mergeCanvasItems(canvasId: string, config: Pick<FloorMapViewConfig, 'sceneElements' | 'elementKinds'>, defaultCellSize?: number): FloorMapMergedItem[];

package/lib/components/pisellFloorMapLayout/utils/floorMapFallbackRender.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 无 renderItemByKind 时的占位渲染（装饰、舞台等），避免画布上不显示
+ */
+import React from 'react';
+import type { FloorMapMergedItem } from '../types';
+/**
+ * @returns 与 PisellFloorMapLayout 内联 fallback 一致的渲染函数（useCallback 由调用方包裹）
+ */
+/** 绑定校验失败或 renderItemByKind 抛错时的占位 */
+export declare function renderFloorMapRenderError(message: string): React.ReactNode;
+export declare function renderFloorMapFallbackPlaceholder(item: FloorMapMergedItem): React.ReactNode;

package/lib/components/pisellFloorMapLayout/utils/floorMapSelectionZone.d.ts

@@ -0,0 +1,24 @@
+import type { FloorMapMergedItem } from '../types';
+export interface SelectionZoneRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** 该图元是否为选区 */
+export declare function isSelectionZoneItem(item: {
+    elementKind?: string;
+}): boolean;
+/** zoneRect 是否「完全包含」itemRect（含边界，允许 1px 容差以抵消取整误差） */
+export declare function rectFullyContains(zoneRect: SelectionZoneRect, itemRect: SelectionZoneRect, tolerance?: number): boolean;
+/**
+ * 计算选区成员 id 列表（输入为像素矩形坐标系）。
+ *
+ * @param zoneId      选区自身 id（排除自身）
+ * @param zoneRect    选区矩形（像素）
+ * @param itemRects   画布上全部图元及其像素矩形
+ */
+export declare function computeSelectionZoneMemberIds(zoneId: string, zoneRect: SelectionZoneRect, itemRects: Array<{
+    item: FloorMapMergedItem;
+    rect: SelectionZoneRect;
+}>): string[];

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import IpadModal from './IpadModal';
 import MobileModal from './MobileModal';
 import PcModal from './PcModal';

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,9 @@
+/**
+ * RecordBoard 预约日历：月 / 周 / 日三视图，资源分组与折叠、锁台、拖拽改期、日视图多 lane overlay。
+ * 受控：`calendarView`、`anchorDate`、`bookings` 等见 {@link RecordBoardCalendarProps}；未传时由内部 state 驱动（便于 Story）。
+ */
+import React from 'react';
+import type { RecordBoardCalendarProps } from '../../types';
+import './BookingCalendar.less';
+/** 看板日历根组件：内含主题 CSS 与 Spin，按 `view` 挂载月 / 周 / 日子组件 */
+export default function BookingCalendar(props?: RecordBoardCalendarProps): React.JSX.Element;

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

@@ -0,0 +1,34 @@
+import React from 'react';
+/** 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): "theme-text-muted" | "text-zinc-400" | "text-red-600" | "text-red-300" | "text-amber-600" | "text-amber-300";
+/**
+ * @param options.flattenWhenAllGroupsCollapsed
+ *   若为 `true`：全部分组折叠时仅有 group 头、无 court 行，会退化为平铺 court（易与「全部展开」混淆）。
+ *   日/周/月日历统一为默认 `false`，保留分组头行与折叠态（与底部「全部关闭」预期一致）。
+ *
+ * 若全部资源只属于**一个**分组（含仅 VIP、仅 Standard、或仅一种自定义 type），日/周视图不展示分组头行，
+ * 直接平铺资源行（单组折叠时也同样平铺资源，避免只剩一条分组栏）。
+ */
+export declare function buildGroupedCourtRows(courts: any, collapsedGroups?: {}, options?: {}): any;
+/** 周/月/资源跨窗口 pill 左右续画标记（◀/▶）；自定义 `renderMonthWeekBooking` 时由格容器包裹渲染 */
+export declare function CalendarGridBookingClipMarkers({ clippedLeft, clippedRight, size, }: {
+    clippedLeft?: boolean;
+    clippedRight?: boolean;
+    /** `xs` 月视图 banner；`sm` 周/资源 pill */
+    size?: 'xs' | 'sm';
+}): React.JSX.Element;
+/** 日视图 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/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): React.JSX.Element;

package/lib/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): React.JSX.Element | null;

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/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;
+}): React.JSX.Element;

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

@@ -0,0 +1,22 @@
+import React from '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;
+}): React.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;
+}): React.JSX.Element;
+export {};