@pisell/materials 6.12.23 → 6.12.26

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

@@ -1,7 +0,0 @@
-/**
- * 看板日历子模块导出：持久化守卫、日历根视图、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/lib/components/pisellRecordBoard/shellFrame/Calendar/modal/MoveConfirmModal.d.ts

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

package/lib/components/pisellRecordBoard/shellFrame/Calendar/modal/OverflowListModal.d.ts

@@ -1,30 +0,0 @@
-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/BookingCalendarStyle.d.ts

@@ -1,10 +0,0 @@
-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/lib/components/pisellRecordBoard/shellFrame/Calendar/utils/bookingCalendarAxis.d.ts

@@ -1,32 +0,0 @@
-/**
- * 日历主轴映射纯函数：把一条 booking 在主轴方向的连续区间 [startUnit, endUnit)
- * 按「精确比例 proportional」或「补全到刻度结束 snap」映射成 { offset, size }。
- * 单位无关：scalePerUnit 既可是 px（固定列宽视图）也可是 %（弹性列视图）。
- */
-export declare type TickFillMode = 'proportional' | 'snap';
-export declare type CalendarViewKind = 'day' | 'week' | 'resource' | 'month';
-export interface TickAxis {
-    /** 主轴起点对应的"绝对单位坐标"（日视图=firstTimelineHour；天维度=0） */
-    originUnit: number;
-    /** 每 1 单位的输出量（日视图=每小时 px；天维度=每列 px 或 %） */
-    scalePerUnit: number;
-    /** snap 的对齐粒度（单位）（日视图=slotStepHours；天维度=1） */
-    tickUnit: number;
-    /** 输出尺寸下限（与 scalePerUnit 同量纲），比例模式兜底可点击宽度 */
-    minSize: number;
-}
-export interface AxisSpan {
-    offset: number;
-    size: number;
-}
-export declare function mapAxisSpan(axis: TickAxis, startUnit: number, endUnit: number, mode: TickFillMode): AxisSpan;
-/**
- * 天维度：把（列下标, 当天浮点小时）折算成连续「天单位」坐标。
- * frac 限制在 [0,1]，使跨日首尾按当天营业小时占比收口。
- *
- * 营业窗口起点 `dayGridMin` 可能不是 0 点、甚至接近午夜（跨午夜营业，如 23:59 起）。
- * 此时 `hour - dayGridMin` 对白天小时会变负而被 clamp 成 0，导致所有预约挤到格子开头。
- * 因此先对 24h 做环绕，得到「距营业起点的正向偏移」，再按 span 归一化。
- */
-export declare function dayGridUnit(colIndex: number, hour: number, dayGridMin: number, dayGridSpan: number): number;
-export declare function resolveTickFillMode(view: CalendarViewKind, override: TickFillMode | undefined): TickFillMode;

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

@@ -1,330 +0,0 @@
-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/BookingCalendarDaySelectionBar.d.ts

@@ -1,21 +0,0 @@
-import React from '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): React.JSX.Element | null;

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

@@ -1,52 +0,0 @@
-/** 日视图：横向虚拟滚动时间轴 + 资源行，预约条按 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/BookingCalendarGroupRowHeader.d.ts

@@ -1,23 +0,0 @@
-/**
- * 日视图 / 周视图共用的分组头左侧 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): React.JSX.Element;

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

@@ -1,22 +0,0 @@
-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

@@ -1,57 +0,0 @@
-/**
- * 资源视图（按月）：与日视图同款骨架——冻结左列 + 横向滚动 + 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

@@ -1,26 +0,0 @@
-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/Calendar/view/bookingCalendarDayViewContext.d.ts

@@ -1,12 +0,0 @@
-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;
-}): React.JSX.Element;
-export declare function useBookingCalendarDayChrome(): BookingCalendarDayChromeContextValue;

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

@@ -1,4 +0,0 @@
-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): any;