@pisell/materials 6.11.224 → 6.12.1

package/lib/components/pisellLookup/utils/storage.d.ts

@@ -0,0 +1,42 @@
+/**
+ * localStorage 工具函数
+ * 用于管理搜索历史的存储
+ */
+/**
+ * 从 localStorage 加载历史记录
+ * @param key 存储的 key
+ * @returns 历史记录数组
+ */
+export declare const loadHistory: (key: string) => string[];
+/**
+ * 保存历史记录到 localStorage
+ * @param key 存储的 key
+ * @param history 历史记录数组
+ * @param maxCount 最大数量限制
+ */
+export declare const saveHistory: (key: string, history: string[], maxCount: number) => void;
+/**
+ * 清除历史记录
+ * @param key 存储的 key
+ */
+export declare const clearHistory: (key: string) => void;
+/**
+ * 添加历史记录项
+ * @param key 存储的 key
+ * @param item 新的历史记录项
+ * @param maxCount 最大数量限制
+ * @returns 更新后的历史记录数组
+ */
+export declare const addHistoryItem: (key: string, item: string, maxCount: number) => string[];
+/**
+ * 删除历史记录项
+ * @param key 存储的 key
+ * @param item 要删除的历史记录项
+ * @returns 更新后的历史记录数组
+ */
+export declare const removeHistoryItem: (key: string, item: string) => string[];
+/**
+ * 检查 localStorage 是否可用
+ * @returns 是否可用
+ */
+export declare const isLocalStorageAvailable: () => boolean;

package/lib/components/pisellMetricCard/components/MetricTitle.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { MetricTitleProps } from '../types';
+/**
+ * MetricTitle 标题组件
+ *
+ * 负责渲染标题、副标题和提示信息
+ * 支持自定义字号、字重、颜色等样式
+ *
+ * @param props 组件属性
+ */
+declare const MetricTitle: React.FC<MetricTitleProps>;
+export default MetricTitle;

package/lib/components/pisellMetricCard/components/MetricValue.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { MetricValueProps } from '../types';
+/**
+ * MetricValue 数值展示组件
+ *
+ * 负责渲染格式化后的主数值
+ * 支持自定义字号、字重、颜色等样式
+ *
+ * @param props 组件属性
+ */
+declare const MetricValue: React.FC<MetricValueProps>;
+export default MetricValue;

package/lib/components/pisellMetricCard/components/TrendIcon.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { TrendIconProps } from '../types';
+/**
+ * TrendIcon 趋势箭头组件
+ *
+ * 根据趋势类型显示上升或下降箭头
+ * - up: 显示上升箭头 ↑
+ * - down: 显示下降箭头 ↓
+ * - neutral: 不显示箭头
+ *
+ * @param props 组件属性
+ */
+declare const TrendIcon: React.FC<TrendIconProps>;
+export default TrendIcon;

package/lib/components/pisellMetricCard/types.d.ts

@@ -0,0 +1,201 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 趋势类型
+ */
+export declare type TrendType = 'up' | 'down' | 'neutral';
+/**
+ * 数值格式化配置
+ */
+export interface ValueFormatConfig {
+    /** 小数精度（小数位数），默认 0 */
+    precision?: number;
+    /** 是否使用千分位分隔符，默认 false */
+    useGrouping?: boolean;
+    /** 是否显示货币符号，默认 false */
+    showCurrencySymbol?: boolean;
+    /** 货币符号（如 $, ¥），默认 '' */
+    currencySymbol?: string;
+    /** 自定义格式化函数 */
+    formatter?: (value: number | null) => string;
+    /** 整数时隐藏小数部分，默认 true */
+    hideDecimalForWholeNumbers?: boolean;
+}
+/**
+ * 环比配置
+ */
+export interface ComparisonConfig {
+    /** 环比数值（支持正负值） */
+    value: number | string | null;
+    /** 环比前缀文本，默认 'v.s. pre' */
+    text?: string;
+    /** 是否显示趋势箭头，默认 true */
+    showTrendIcon?: boolean;
+    /** 正向趋势颜色，默认 '#52c41a' */
+    positiveColor?: string;
+    /** 负向趋势颜色，默认 '#ff4d4f' */
+    negativeColor?: string;
+    /** 环比字号，默认 14 */
+    size?: number | string;
+}
+/**
+ * 样式配置
+ */
+export interface MetricCardStyleConfig {
+    /** 卡片容器样式 */
+    card?: {
+        /** 是否显示边框，默认 true */
+        bordered?: boolean;
+        /** 圆角大小（px），默认 12 */
+        borderRadius?: number;
+        /** 内边距（px），默认 16 */
+        padding?: number;
+        /** 阴影效果，默认 true */
+        shadow?: boolean | string;
+        /** 背景色，默认 '#ffffff' */
+        background?: string;
+        /** 卡片宽度，默认 'auto' */
+        width?: string | number;
+    };
+    /** 标题样式 */
+    title?: {
+        /** 字号，默认 14 */
+        size?: number | string;
+        /** 字重，默认 400 */
+        weight?: number | string;
+        /** 颜色，默认 'rgba(0, 0, 0, 0.45)' */
+        color?: string;
+    };
+    /** 数值样式 */
+    value?: {
+        /** 字号，默认 30 */
+        size?: number | string;
+        /** 字重，默认 600 */
+        weight?: number | string;
+        /** 颜色，默认 'rgba(0, 0, 0, 0.85)' */
+        color?: string;
+    };
+}
+/**
+ * PisellMetricCard 组件 Props
+ *
+ * 采用扁平 + 对象组合的设计，降低复杂度和耦合
+ *
+ * @example 基础用法
+ * ```tsx
+ * <PisellMetricCard
+ *   title="Total Sales"
+ *   value={1580}
+ * />
+ * ```
+ *
+ * @example 带格式化和环比
+ * ```tsx
+ * <PisellMetricCard
+ *   title="Revenue"
+ *   value={1580}
+ *   format={{
+ *     showCurrencySymbol: true,
+ *     currencySymbol: '$',
+ *     useGrouping: true
+ *   }}
+ *   comparison={{
+ *     value: 120,
+ *     text: 'v.s. last month'
+ *   }}
+ * />
+ * ```
+ */
+export interface PisellMetricCardProps {
+    /** 标题文本 */
+    title: string | ReactNode;
+    /** 主数值 */
+    value: number | string | null;
+    /** 副标题文本（可选） */
+    subtitle?: string | ReactNode;
+    /** 标签内容（可选） */
+    tag?: ReactNode;
+    /** 提示信息内容（可选） */
+    tooltip?: string | ReactNode;
+    /**
+     * 数值格式化配置
+     * @example format={{ precision: 2, useGrouping: true, currencySymbol: '$' }}
+     */
+    format?: ValueFormatConfig;
+    /**
+     * 环比配置
+     * @example comparison={{ value: 120, text: 'v.s. pre' }}
+     */
+    comparison?: ComparisonConfig;
+    /**
+     * 样式配置
+     * @example
+     * styleConfig={{
+     *   card: { borderRadius: 8, padding: 24 },
+     *   title: { size: 16, weight: 600 },
+     *   value: { size: 36, color: '#1890ff' }
+     * }}
+     */
+    styleConfig?: MetricCardStyleConfig;
+    /** 是否显示副标题，默认 false */
+    showSubtitle?: boolean;
+    /** 是否显示标签，默认 false */
+    showTag?: boolean;
+    /** 是否显示提示信息，默认 false */
+    showTooltip?: boolean;
+    /** 是否显示加载状态，默认 false */
+    loading?: boolean;
+    /** 鼠标悬停是否有交互效果，默认 true */
+    hoverable?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 点击卡片回调 */
+    onClick?: () => void;
+}
+/**
+ * FormatOptions (别名，用于导出)
+ */
+export interface FormatOptions extends ValueFormatConfig {
+}
+/**
+ * MetricTitle 组件 Props
+ */
+export interface MetricTitleProps {
+    title: string | ReactNode;
+    subtitle?: string | ReactNode;
+    tooltip?: string | ReactNode;
+    titleSize?: number | string;
+    titleWeight?: number | string;
+    titleColor?: string;
+}
+/**
+ * MetricValue 组件 Props
+ */
+export interface MetricValueProps {
+    value: string | null;
+    valueSize?: number | string;
+    valueWeight?: number | string;
+    valueColor?: string;
+}
+/**
+ * MetricComparison 组件 Props
+ */
+export interface MetricComparisonProps {
+    comparison: number | string | null;
+    comparisonText?: string;
+    showTrendIcon?: boolean;
+    positiveColor?: string;
+    negativeColor?: string;
+    comparisonSize?: number | string;
+    precision?: number;
+    showCurrencySymbol?: boolean;
+    currencySymbol?: string;
+}
+/**
+ * TrendIcon 组件 Props
+ */
+export interface TrendIconProps {
+    trend: TrendType;
+    color?: string;
+}

package/lib/components/pisellMetricCard/utils/calculateTrend.d.ts

@@ -0,0 +1,14 @@
+import type { TrendType } from '../types';
+/**
+ * 计算趋势方向
+ *
+ * @param comparison 环比数值
+ * @returns 'up' | 'down' | 'neutral'
+ *
+ * @example
+ * calculateTrend(120) // 'up'
+ * calculateTrend(-230) // 'down'
+ * calculateTrend(0) // 'neutral'
+ * calculateTrend(null) // 'neutral'
+ */
+export declare function calculateTrend(comparison: number | string | null | undefined): TrendType;

package/lib/components/pisellMobileDateRangePicker/PisellMobileDateRangePicker.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { PisellMobileDateRangePickerProps } from './types';
+import 'antd-mobile/es/global/global.css';
+import './PisellMobileDateRangePicker.less';
+/**
+ * antd-mobile CalendarPicker（range）薄封装：受控 value/onChange 与 RecordBoard 快筛 dayjs[] 对齐。
+ */
+export declare const PisellMobileDateRangePicker: React.FC<PisellMobileDateRangePickerProps>;

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

@@ -0,0 +1,2 @@
+export { PisellMobileDateRangePicker } from './PisellMobileDateRangePicker';
+export type { PisellMobileDateRangePickerProps } from './types';

package/lib/components/pisellMobileDateRangePicker/types.d.ts

@@ -0,0 +1,28 @@
+import type { Dayjs } from 'dayjs';
+import type { CSSProperties, ReactNode } from 'react';
+import type { CalendarPickerProps } from 'antd-mobile';
+/** toolbar：顶栏快筛 32px；filter：Filter 弹层内与 Select 对齐的 48px 触发器 */
+export declare type PisellMobileDateRangePickerVariant = 'toolbar' | 'filter';
+export declare const PISELL_MOBILE_DATE_RANGE_PICKER_FILTER_POPUP_CLASS = "pisell-mobile-date-range-picker__popup";
+export interface PisellMobileDateRangePickerProps {
+    value?: unknown;
+    onChange?: (value: [Dayjs, Dayjs] | undefined) => void;
+    /** 展示格式，默认 DD/MM/YYYY */
+    format?: string;
+    placeholder?: string;
+    className?: string;
+    style?: CSSProperties;
+    title?: ReactNode;
+    confirmText?: string;
+    allowClear?: boolean;
+    min?: Date;
+    max?: Date;
+    /** 默认 toolbar；filter 用于手机 Filter 弹层 */
+    variant?: PisellMobileDateRangePickerVariant;
+    getContainer?: CalendarPickerProps['getContainer'];
+    popupClassName?: CalendarPickerProps['popupClassName'];
+    popupStyle?: CalendarPickerProps['popupStyle'];
+    /** Filter 弹层：日历打开时通知外层保持 Popover 不收起 */
+    onOpen?: () => void;
+    onClose?: () => void;
+}

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { PcModalProps } from '../PcModal';
 export interface IpadModalProps extends PcModalProps {
 }

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { PcModalProps } from '../PcModal';
 import './index.less';
 export interface MobileModalProps extends PcModalProps {

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/pisellPercent/utils/rangeConverter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 百分比范围转换工具函数
+ */
+/**
+ * 将值转换为百分比（0-100）
+ *
+ * @param value 原始值
+ * @param range 值的范围
+ * @returns 转换后的百分比值（0-100）
+ *
+ * @example
+ * // [0, 100] 范围 - 直接返回
+ * convertToPercent(85.5, [0, 100])  // 返回: 85.5
+ *
+ * @example
+ * // [0, 1] 范围 - 乘以 100
+ * convertToPercent(0.855, [0, 1])  // 返回: 85.5
+ *
+ * @example
+ * // 自定义范围 - 按比例计算
+ * convertToPercent(855, [0, 1000])  // 返回: 85.5
+ */
+export declare function convertToPercent(value: number | null | undefined, range: [number, number]): number | null;
+/**
+ * 将百分比值转换回原始范围
+ *
+ * @param percent 百分比值（0-100）
+ * @param range 目标范围
+ * @returns 转换后的值
+ *
+ * @example
+ * convertFromPercent(85.5, [0, 100])  // 返回: 85.5
+ * convertFromPercent(85.5, [0, 1])    // 返回: 0.855
+ * convertFromPercent(85.5, [0, 1000]) // 返回: 855
+ */
+export declare function convertFromPercent(percent: number | null | undefined, range: [number, number]): number | null;

package/lib/components/pisellPhone/utils/phoneFormatter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 电话号码格式化工具
+ */
+/**
+ * 中国大陆手机号格式化：138 0000 0000
+ */
+export declare function formatChinaMobile(phone: string): string;
+/**
+ * 美国/加拿大号码格式化：(555) 123-4567
+ */
+export declare function formatUSPhone(phone: string): string;
+/**
+ * 英国号码格式化：1234 567 8900
+ */
+export declare function formatUKPhone(phone: string): string;
+/**
+ * 根据国家码格式化电话号码
+ * @param phone 电话号码（纯数字）
+ * @param countryCode 国家码
+ * @returns 格式化后的电话号码
+ */
+export declare function formatPhone(phone: string, countryCode: string): string;
+/**
+ * 电话号码脱敏
+ * @param phone 电话号码
+ * @param pattern 脱敏模式
+ * @returns 脱敏后的号码
+ *
+ * @example
+ * maskPhone('13800000000', 'middle') // '138****0000'
+ * maskPhone('13800000000', 'last')   // '1380000****'
+ */
+export declare function maskPhone(phone: string, pattern?: 'middle' | 'last'): string;
+/**
+ * 检测号码类型（中国）
+ * @param phone 电话号码
+ * @returns 号码类型
+ */
+export declare function detectPhoneType(phone: string): 'mobile' | 'landline' | 'unknown';

package/lib/components/pisellQuickFilter/type.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+import { FilterItemProps } from '../filter/types';
+import { FormInstance } from 'antd';
+export declare type PisellQuickFilterProps = FormInstance & {
+    hasForm?: boolean;
+    children?: React.ReactNode;
+    formFiltersPrefix: string;
+    filterList?: FilterItemProps[];
+    quickFilterMaxLength: number;
+    hiddenQuickFilter: boolean;
+    hiddenOtherFilter: boolean;
+};

package/lib/components/pisellRecordBoard/PisellRecordBoard.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { RecordBoardProps } from './types';
+/**
+ * RecordBoard 容器：提供统一的 data / pagination / search 上下文。
+ * 打散 props：列表/分页/搜索/多选、grid/toolBar/…；可选根级 **floorMap**（兼容透传）。
+ * 平面图推荐在 ShellFrame 内使用 **PisellRecordBoard.FloorMap** 声明，与根级 `floorMap` 合并（子优先）。
+ */
+declare const PisellRecordBoard: React.FC<RecordBoardProps>;
+export default PisellRecordBoard;

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

@@ -6,7 +6,7 @@ export declare function statusTagMeta(tag: string | null | undefined): {
 } | null;
 /** 锁台卡片副标题：操作人、锁台时间等拼接一行 */
 export declare function getBlockMetaLine(item: any): string;
-export declare function getRemainingToneClass(ratio: any, isLight?: boolean): "text-red-600" | "text-red-300" | "text-amber-600" | "text-amber-300" | "theme-text-muted" | "text-zinc-400";
+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（易与「全部展开」混淆）。

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

@@ -0,0 +1,4 @@
+/** 日历视图文案：占位符 `{name}`、`{date}` 等由调用方替换 */
+export declare function tCal(id: string, vars?: Record<string, string | number>): string;
+/** 月/周表头：周一为 0（与 rangeDays / startOfWeek 一致） */
+export declare const CALENDAR_WEEKDAY_IDS: readonly ["pisell2.recordBoard.calendar.weekday.mon", "pisell2.recordBoard.calendar.weekday.tue", "pisell2.recordBoard.calendar.weekday.wed", "pisell2.recordBoard.calendar.weekday.thu", "pisell2.recordBoard.calendar.weekday.fri", "pisell2.recordBoard.calendar.weekday.sat", "pisell2.recordBoard.calendar.weekday.sun"];

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

@@ -0,0 +1,18 @@
+import React from 'react';
+/** 日历内会改本地预约数据的动作类型，供业务层拦截（如平面图未支持写接口时 toast） */
+export declare type CalendarPersistKind = 'moveBooking' | 'createBooking' | 'removeBlocks' | 'createBlock' | 'checkin' | 'checkinReschedule' | 'mergeOrder' | 'other';
+export interface CalendarPersistContextValue {
+    /**
+     * 返回 false 时日历组件应取消本次本地数据变更（由调用方决定是否已 toast）。
+     * 未提供时默认允许所有本地变更（Story / 独立演示）。
+     */
+    beforePersist?: (kind: CalendarPersistKind) => boolean;
+}
+export declare const CalendarPersistProvider: React.FC<{
+    children: React.ReactNode;
+    value?: CalendarPersistContextValue;
+}>;
+/**
+ * 在日历 Demo 内判断某类写操作是否允许执行本地 state 更新。
+ */
+export declare function useCalendarPersist(): (kind: CalendarPersistKind) => boolean;

package/lib/components/pisellRecordBoard/shellFrame/Calendar/const/bookingCalendarConstants.d.ts

@@ -0,0 +1,102 @@
+/** BookingCalendarDemo：布局数值与虚拟列表高度等（无演示种子数据）。 */
+export declare const timeSliceMinutes = 60;
+/** 未传 timelineRange 时默认营业日界钟 */
+export declare const DEFAULT_CALENDAR_TIMELINE: {
+    start: string;
+    end: string;
+};
+export declare const frozenColWidth = 132;
+export declare const dayColWidth = 92;
+/**
+ * 日历「资源视图」横向每一「日」列宽度（按月天数铺开）。
+ * 略大于 {@link dayColWidth}，仅作用于资源视图；日视图时间轴仍用 dayColWidth。
+ */
+export declare const resourceViewDayColWidth = 102;
+/**
+ * 日/周视图空档虚线框：在父级为 column flex 且占满格高时 `flex-1 min-h-0` 纵向铺满剩余区域。
+ */
+export declare const CALENDAR_EMPTY_DASHED_SLOT_CLASSNAME = "flex min-h-0 flex-1 w-full flex-col items-center justify-center rounded-lg border border-dashed px-2 py-1 text-xs";
+/** 日视图无 overlay 时资源行默认高度；周视图 court 行与各日期格 `minHeight` 与之对齐 */
+export declare const dayRowHeight = 44;
+/**
+ * 资源视图月格：单条预约卡片**实际 min-height** 与「行高估算」共用此值。
+ * 调整此常量即可同步改变卡片显示高度与父行预留高度，避免行高与卡片高度不一致导致的截断 / 留白。
+ */
+export declare const RESOURCE_VIEW_BOOKING_CARD_EST_PX = 48;
+/** 资源视图「+N」tile 的 min-height */
+export declare const RESOURCE_VIEW_MORE_TILE_MIN_PX = 48;
+/** 资源视图单元格 p-1 上下合计 */
+export declare const RESOURCE_VIEW_CELL_PADDING_Y_PX = 8;
+/** 资源视图 fullyBooked 占位块 min-height */
+export declare const RESOURCE_VIEW_FULLY_BOOKED_BLOCK_PX = 28;
+/**
+ * 资源视图：单 court 行最多展示的 lane 数；超出 → 该天落入 cell 级 `+N` 溢出
+ */
+export declare const RESOURCE_VIEW_MAX_LANE = 3;
+/**
+ * 周视图：单 court 行最多展示的 lane 数（含 pill）。
+ * 比资源视图小：周列宽 ≈ 1 天，行高过大会让 5/27–5/31 这种"中间天"出现大块底部空白
+ * （短跨日 pill 只占 5/25–5/26 的 lane 2，但行高被全周 max 撑到 3 lane）。
+ * 这里取 2 → 长跨日两条占顶 lane 0/1，短跨日和单日全部进 cell 级 +N tile，行高紧凑。
+ */
+export declare const WEEK_VIEW_MAX_LANE = 2;
+/** 月视图：每周内最多展示的 lane 数；超出 → cell 级 `+N` 溢出（M1：跨自然周续画时端部加 ◀/▶） */
+export declare const MONTH_VIEW_MAX_LANE = 3;
+/** 月视图 banner 高度（细于周视图 pill，节省每个 cell 的垂直空间） */
+export declare const MONTH_VIEW_BANNER_H = 22;
+/** 月视图 banner 之间纵向间距 */
+export declare const MONTH_VIEW_BANNER_GAP = 2;
+/** 月视图 banner 区域顶部留白（cell header 已留 padding，这里只补 banner 自身上边距） */
+export declare const MONTH_VIEW_BANNER_PAD_Y = 2;
+/** 月视图 cell header 估算高度：日期数字 + 占用 dot，banner 起点的 top 偏移 */
+export declare const MONTH_VIEW_DAY_HEADER_H = 52;
+/** 月视图 +N tile 高度（与 banner 一致以对齐 lane 槽） */
+export declare const MONTH_VIEW_MORE_TILE_PX = 22;
+/** 月视图：给定可见 lane 数与是否有 +N，banner 区所需高度（px） */
+export declare function monthWeekBannerContentHeightPx(visibleLanes: number, hasOverflow: boolean): number;
+/**
+ * 月视图：在固定行高、不可滚动的前提下，根据 banner 区可用高度推算本行最多展示几条。
+ * 超出部分走 cell 级 +N，避免底部 banner 被裁切却看不到 +N。
+ */
+export declare function monthViewEffectiveMaxLanes(bannerZoneHeightPx: number, totalLaneCount: number): number;
+/** 日视图分组行默认高度（须容纳左侧折叠按钮等） */
+export declare const groupRowHeight = 38;
+export declare const dayHeaderHeight = 56;
+/** 日视图 overlay 内单条预约卡片区最小高度（与 BookingCard、行高计算一致） */
+export declare const DAY_BOOKING_CARD_MIN_PX = 64;
+/** 日视图同一资源行内每条 lane 的最小高度（须 ≥ DAY_BOOKING_CARD_MIN_PX）；并行时抬高该行 */
+export declare const DAY_OVERLAY_LANE_MIN_PX = 64;
+export declare const DAY_OVERLAY_INNER_TOP = 8;
+export declare const DAY_OVERLAY_INNER_BOTTOM = 8;
+export declare const DAY_OVERLAY_LANE_GAP = 2;
+/** 同一重叠簇内最多展示的预约条数；超出合并为第 4 行的 +N（与日/周时间轴 overlay 一致） */
+export declare const DAY_OVERLAY_VISIBLE_BOOKING_CAP = 3;
+/**
+ * 日视图：某 court 行在「有预约 overlay」时的总高度（px），随并行展示条数 `displayLaneCount` 变高而变高（非固定常数）。
+ * `displayLaneCount` 由 `effectiveDayOverlayDisplayLaneCount(最大并行数)` 得到，与 3+N 截断规则一致。
+ */
+export declare function dayCourtOverlayRowHeightPx(displayLaneCount: number): number;
+/**
+ * 资源视图：按某一格「courtDaySummary」结果估算该格所需最小高度（px）。
+ * 用于横向虚拟化仅挂载可见日期列时，仍按**全月**最大内容撑开行高，避免日程只在屏幕外列时出现行高塌陷。
+ */
+export declare function estimateResourceViewCourtCellHeightPx(summary: {
+    fullyBooked: boolean;
+    items: unknown[];
+}): number;
+/** 低于该宽度时日视图预约条内难以排下两行文案，默认用 Tooltip 展示完整信息 */
+export declare const DAY_BOOKING_NARROW_PX = 88;
+/** 低于该宽度时条内仅保留居中首字/圆点，避免文字竖排或完全不可读 */
+export declare const DAY_BOOKING_MICRO_PX = 32;
+/** 日视图横向：视口外多渲染的槽列数（减轻快速滚动白边） */
+export declare const DAY_VIEW_COL_BUFFER = 5;
+/** 日视图纵向：视口外多渲染的像素边距 */
+export declare const DAY_VIEW_ROW_BUFFER_PX = 240;
+/** 月/周/资源 +N 弹层内置列表行内容区高度（名称 + 时间） */
+export declare const OVERFLOW_MODAL_SIMPLE_CARD_H = 56;
+/** 日视图 lane +N：RoomCard 单行内容区高度（略大于格内条 min，可裁切次要信息） */
+export declare const OVERFLOW_MODAL_DAY_CARD_H = 80;
+export declare const OVERFLOW_MODAL_ROW_GAP = 8;
+export declare const OVERFLOW_MODAL_SIMPLE_ROW_H: number;
+export declare const OVERFLOW_MODAL_DAY_ROW_H: number;
+export declare const OVERFLOW_MODAL_LIST_MAX_H = 420;

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

@@ -0,0 +1,32 @@
+/**
+ * 日历主轴映射纯函数：把一条 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/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;