@pisell/materials 6.11.241 → 6.11.242

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 {};

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

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;