@pisell/materials 6.12.26 → 6.12.27

package/es/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/es/components/pisellPhone/PisellPhone.stories.d.ts

@@ -0,0 +1,80 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellPhone } from './PisellPhone';
+/**
+ * PisellPhone 是一个电话号码输入/展示组件。
+ *
+ * ## 功能特性
+ * - 支持三种状态：只读、编辑、禁用
+ * - 国家码选择（预设24个常见国家）
+ * - 自动格式化
+ * - 格式校验
+ * - 移动端拨号
+ * - 号码脱敏
+ */
+declare const meta: Meta<typeof PisellPhone>;
+export default meta;
+declare type Story = StoryObj<typeof PisellPhone>;
+/**
+ * 基础编辑态（中国手机号）
+ */
+export declare const Basic: Story;
+/**
+ * 国家码选择器（显示所有国家）
+ */
+export declare const WithCountrySelector: Story;
+/**
+ * 国家码选择器（过滤显示）
+ */
+export declare const FilteredCountries: Story;
+/**
+ * 国家码选择器（常用国家置顶）
+ */
+export declare const CommonCountriesTop: Story;
+/**
+ * 只读态 - 格式化显示
+ */
+export declare const ReadMode: Story;
+/**
+ * 只读态 - 脱敏显示（中间）
+ */
+export declare const ReadModeMaskedMiddle: Story;
+/**
+ * 只读态 - 脱敏显示（末尾）
+ */
+export declare const ReadModeMaskedLast: Story;
+/**
+ * 只读态 - 可拨号（移动端）
+ */
+export declare const ReadModeDialable: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 必填校验
+ */
+export declare const Required: Story;
+/**
+ * 格式校验
+ */
+export declare const FormatValidation: Story;
+/**
+ * 美国号码
+ */
+export declare const USPhone: Story;
+/**
+ * 自动格式化对比
+ */
+export declare const AutoFormatComparison: Story;
+/**
+ * 多国号码展示
+ */
+export declare const MultiCountryDisplay: Story;
+/**
+ * 脱敏模式对比
+ */
+export declare const MaskingComparison: Story;
+/**
+ * 完整功能示例
+ */
+export declare const CompleteExample: Story;

package/es/components/pisellPhone/components/DisabledView.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { PisellPhoneProps } from '../types';
+/**
+ * PisellPhone 禁用态视图组件
+ *
+ * 负责渲染禁用态视图，基于原始 mode 渲染对应的视图，并添加禁用样式
+ *
+ * 设计规则：
+ * - 基于编辑态或只读态的视觉
+ * - 透明度 40%
+ * - 禁止所有交互行为（包括拨号）
+ *
+ * @param props 组件 Props
+ */
+declare const DisabledView: React.FC<PisellPhoneProps>;
+export default DisabledView;

package/es/components/pisellPhone/components/ReadOnlyView.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { PisellPhoneProps } from '../types';
+/**
+ * PisellPhone 只读态视图组件
+ *
+ * 负责渲染只读态的电话号码展示和拨号功能
+ *
+ * 功能：
+ * - 格式化或脱敏显示
+ * - 显示国旗图标（可选）
+ * - 移动端可点击拨号（tel: 协议）
+ * - 拨号图标（可选）
+ *
+ * @param props 组件 Props
+ */
+declare const ReadOnlyView: React.FC<PisellPhoneProps>;
+export default ReadOnlyView;

package/es/components/pisellPhone/constants/countryCodes.d.ts

@@ -0,0 +1,20 @@
+import type { CountryCode } from '../types';
+/**
+ * 预设的国家码列表（24个常见国家）
+ *
+ * 包含：
+ * - 亚洲：中国、香港、澳门、台湾、日本、韩国、新加坡、马来西亚、泰国、印度
+ * - 欧洲：英国、法国、德国、意大利、西班牙、俄罗斯
+ * - 美洲：美国、加拿大、墨西哥、巴西
+ * - 大洋洲：澳大利亚、新西兰
+ * - 中东：阿联酋、沙特阿拉伯
+ */
+export declare const PRESET_COUNTRY_CODES: CountryCode[];
+/**
+ * 默认国家码
+ */
+export declare const DEFAULT_COUNTRY_CODE = "+86";
+/**
+ * 常用国家码（可作为默认的 commonCountryCodes）
+ */
+export declare const COMMON_COUNTRY_CODES: string[];

package/es/components/pisellPhone/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PisellPhone 组件导出
+ */
+import PisellPhone from './PisellPhone';
+export { PisellPhone };
+export type { PisellPhoneProps, CountryCode } from './types';
+export { PRESET_COUNTRY_CODES, DEFAULT_COUNTRY_CODE, COMMON_COUNTRY_CODES } from './constants/countryCodes';
+export type { DisplayState, ValidationResult, TextInputState } from './types';

package/es/components/pisellPhone/utils/countryCodeHelper.d.ts

@@ -0,0 +1,35 @@
+import type { CountryCode, PisellPhoneProps } from '../types';
+/**
+ * 根据国家码获取国旗 emoji
+ * @param countryCode 国家码
+ * @returns 国旗 emoji
+ */
+export declare function getCountryFlag(countryCode: string): string;
+/**
+ * 根据国家码获取最大长度
+ * @param countryCode 国家码
+ * @param countryCodes 国家码列表
+ * @returns 最大长度
+ */
+export declare function getMaxLength(countryCode: string, countryCodes: CountryCode[]): number;
+/**
+ * 根据国家码获取配置
+ * @param countryCode 国家码
+ * @param countryCodes 国家码列表
+ * @returns 国家码配置
+ */
+export declare function getCountryConfig(countryCode: string, countryCodes: CountryCode[]): CountryCode | undefined;
+/**
+ * 获取最终的国家码列表
+ *
+ * 优先级：
+ * 1. props.countryCodes（完全自定义）
+ * 2. props.availableCountryCodes（从预设中过滤）
+ * 3. PRESET_COUNTRY_CODES（默认全部24个）
+ *
+ * 然后根据 props.commonCountryCodes 排序（置顶）
+ *
+ * @param props 组件 Props
+ * @returns 国家码列表
+ */
+export declare function getCountryCodes(props: PisellPhoneProps): CountryCode[];

package/es/components/pisellPhone/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 电话号码工具函数导出
+ */
+export { formatPhone, formatChinaMobile, formatUSPhone, maskPhone, detectPhoneType } from './phoneFormatter';
+export { validatePhone } from './phoneValidator';
+export { getCountryFlag, getMaxLength, getCountryConfig, getCountryCodes, } from './countryCodeHelper';

package/es/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/es/components/pisellQuickFilter/index.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+declare const pisellQuickFilter: React.ForwardRefExoticComponent<import("antd").FormInstance<any> & {
+    hasForm?: boolean | undefined;
+    children?: React.ReactNode;
+    formFiltersPrefix: string;
+    filterList?: import("../filter/types").FilterItemProps[] | undefined;
+    quickFilterMaxLength: number;
+    hiddenQuickFilter: boolean;
+    hiddenOtherFilter: boolean;
+} & React.RefAttributes<unknown>>;
+export default pisellQuickFilter;

package/es/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/es/components/pisellRating/PisellRating.stories.d.ts

@@ -0,0 +1,53 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellRating } from './PisellRating';
+declare const meta: Meta<typeof PisellRating>;
+export default meta;
+declare type Story = StoryObj<typeof PisellRating>;
+/**
+ * 基础示例
+ */
+export declare const Basic: Story;
+/**
+ * 只读态
+ */
+export declare const ReadOnly: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 半星评分
+ */
+export declare const HalfStar: Story;
+/**
+ * 显示数值
+ */
+export declare const WithValue: Story;
+/**
+ * 显示评分人数
+ */
+export declare const WithCount: Story;
+/**
+ * 带评分描述
+ */
+export declare const WithTooltips: Story;
+/**
+ * 自定义星星数量
+ */
+export declare const CustomCount: Story;
+/**
+ * 自定义图标 - 爱心
+ */
+export declare const HeartIcon: Story;
+/**
+ * 自定义图标 - 笑脸
+ */
+export declare const SmileIcon: Story;
+/**
+ * 商品评分场景
+ */
+export declare const ProductReview: Story;
+/**
+ * 不同尺寸
+ */
+export declare const Sizes: Story;

package/es/components/pisellRating/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * PisellRating 组件导出
+ */
+import PisellRating from './PisellRating';
+export { PisellRating };
+export type { PisellRatingProps } from './types';
+export type { DisplayState } from './types';

package/es/components/pisellRecordBoard/context/RecordBoardContext.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import type { RecordBoardContextValue } from '../types';
+export declare const RecordBoardContext: import("react").Context<RecordBoardContextValue | null>;

package/es/components/pisellRecordBoard/context/RecordBoardProvider.d.ts

@@ -0,0 +1,11 @@
+import React, { ReactNode } from 'react';
+import type { RecordBoardContextValue } from '../types';
+export interface RecordBoardProviderProps {
+    value: RecordBoardContextValue;
+    children: ReactNode;
+}
+/**
+ * 仅负责注入 RecordBoard 上下文。
+ * 实际的数据源、onSearch/onPageChange 由上层（如接 DataSourceContainer 或独立 fetch）提供。
+ */
+export declare const RecordBoardProvider: React.FC<RecordBoardProviderProps>;

package/es/components/pisellRecordBoard/hooks/useRecordBoardContext.d.ts

@@ -0,0 +1,16 @@
+import type { RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardGridProps } from '../types';
+export interface UseRecordBoardContextOptions {
+    /** 子组件 displayName，用于从 childComponentProps 中取对应 props */
+    displayName?: keyof RecordBoardChildComponentProps;
+    /** 上层传入的 childComponentProps（若 Context 未提供则从参数传入） */
+    childComponentProps?: RecordBoardChildComponentProps;
+}
+/**
+ * 消费 RecordBoard 上下文，供各 layout 内子组件（Search / ToolBar / Grid / CardList / Pagination）使用。
+ * 若传入 displayName，返回会合并 childComponentProps[displayName] 便于透传。
+ * 当 displayName 为 'grid' 时，返回类型包含 RecordBoardGridProps（columns、scroll、size）。
+ */
+export declare function useRecordBoardContext(options: UseRecordBoardContextOptions & {
+    displayName: 'grid';
+}): RecordBoardContextValue & RecordBoardGridProps;
+export declare function useRecordBoardContext(options?: UseRecordBoardContextOptions): RecordBoardContextValue;

package/es/components/pisellRecordBoard/layouts/CardLayout/CardList.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { RecordBoardContextValue } from '../../types';
+export interface RecordBoardCardListProps extends Partial<Pick<RecordBoardContextValue, 'data' | 'loading'>> {
+    className?: string;
+    style?: React.CSSProperties;
+    render?: (ctx: RecordBoardContextValue) => React.ReactNode;
+}
+/**
+ * Card 布局下的数据视图：从 context 取 data / loading。
+ */
+declare const RecordBoardCardList: React.FC<RecordBoardCardListProps>;
+export default RecordBoardCardList;

package/es/components/pisellRecordBoard/layouts/CardLayout/index.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import RecordBoardCardList from './CardList';
+/**
+ * Card 布局：仅内容区 = 卡片列表（不含分页）。
+ * 工具栏、多选操作栏、分页由 Shell Frame 提供，使用时用 ShellFrame 包裹：
+ * <PisellRecordBoard.ShellFrame><PisellRecordBoard.CardLayout /></PisellRecordBoard.ShellFrame>
+ */
+declare const CardLayout: React.FC<{
+    className?: string;
+    style?: React.CSSProperties;
+}>;
+export default CardLayout;
+export { RecordBoardCardList as CardLayoutCardList };

package/es/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/es/components/pisellRecordBoard/layouts/GridLayout/index.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import RecordBoardGridView from './Grid';
+/**
+ * Grid 布局：仅内容区 = 表格（不含分页）。
+ * 工具栏、多选操作栏、分页由 Shell Frame 提供，使用时用 ShellFrame 包裹：
+ * <PisellRecordBoard.ShellFrame><PisellRecordBoard.GridLayout /></PisellRecordBoard.ShellFrame>
+ */
+declare const GridLayout: React.FC<{
+    className?: string;
+    style?: React.CSSProperties;
+}>;
+export default GridLayout;
+export { RecordBoardGridView as GridLayoutGrid };

package/es/components/pisellRecordBoard/shellFrame/BatchActionBar/index.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { PisellBatchActionBarProps } from '../../../pisellBatchActionBar';
+/**
+ * RecordBoard 下的多选操作栏：从 context 取选中态与数据，渲染 PisellBatchActionBar。
+ * 仅在有选中项时展示；全选/反选/清空基于当前页 data。
+ */
+declare const RecordBoardBatchActionBar: React.FC<Partial<PisellBatchActionBarProps>>;
+export default RecordBoardBatchActionBar;

package/es/components/pisellRecordBoard/shellFrame/Calendar/RecordBoardCalendar.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { RecordBoardCalendarProps } from '../../types';
+/**
+ * RecordBoard 日历槽位：仅在 PisellRecordBoard.ShellFrame 内使用，本身不渲染 DOM。
+ * 与 GridLayout、FloorMap 并存时出现「表格 / 平面图 / 日历」切换。
+ */
+declare const RecordBoardCalendar: React.FC<RecordBoardCalendarProps>;
+export default RecordBoardCalendar;

package/es/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): "text-red-600" | "text-red-300" | "text-amber-600" | "text-amber-300" | "theme-text-muted" | "text-zinc-400";
+/**
+ * @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/es/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/es/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/es/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/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[];
+    }[];
+};