@pisell/materials 3.3.100 → 3.3.101

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

@@ -0,0 +1,85 @@
+import { CSSProperties } from 'react';
+import { Props as TreeItem } from "../pisellDraggable/components/TreeItem/TreeItem";
+export interface NavigationMenuItem {
+    id: string;
+    /** 标题 */
+    title: string;
+    /** 图标 */
+    icon?: string;
+    /** 描述 */
+    description?: string;
+    /** 子菜单 */
+    children?: NavigationMenuItem[];
+    /** 版本 */
+    version?: string;
+    /** 是否是分组 */
+    isGroup?: boolean;
+    /** 是否允许添加子菜单 */
+    allowAddChild?: boolean;
+    /** 是否允许删除 */
+    allowDelete?: boolean;
+    /** 是否允许编辑 */
+    allowEdit?: boolean;
+    /** 是否允许添加子菜单 */
+    allowAddSubmenu?: boolean;
+    /** 是否允许添加页面 */
+    allowAddPage?: boolean;
+    /** 其他属性 */
+    [key: string]: any;
+}
+export interface PisellNavigationMenuProps {
+    /** 导航菜单数据 */
+    value: NavigationMenuItem[];
+    /** 是否允许拖拽排序 */
+    allowDrag?: boolean;
+    /** 是否允许删除菜单项 */
+    allowDelete?: boolean;
+    /** 是否允许添加子菜单 */
+    allowAddChild?: boolean;
+    /** 是否允许添加根菜单 */
+    allowAddRoot?: boolean;
+    /** 是否允许显示隐藏 */
+    allowIsShow?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 菜单项间距 */
+    spacing?: number;
+    /** 最大层级数 */
+    maxLevel?: number;
+    /** 样式 */
+    style?: CSSProperties;
+    /** 类名 */
+    className?: string;
+    /** 数据变化回调 */
+    onChange?: (items: NavigationMenuItem[]) => void;
+    /** 设计模式 */
+    __designMode?: string;
+    /** 标题 */
+    title?: string;
+    /** 添加子菜单回调 */
+    onAddSubMenu?: (item?: NavigationMenuItem) => void;
+    /** 添加页面回调 */
+    onAddPage?: (item?: NavigationMenuItem) => void;
+    /** 编辑回调 */
+    onEdit?: (item: NavigationMenuItem) => void;
+    /** 删除回调 */
+    onDelete?: (item: NavigationMenuItem) => void;
+    /** 左侧自定义内容 */
+    leftContent?: React.ReactNode;
+    /** 右侧自定义内容 */
+    rightContent?: React.ReactNode;
+    /** 获取item样式 */
+    getItemStyle?: (itemProps: TreeItem) => React.CSSProperties;
+    /** 自定义拖拽判断函数，返回false时阻止拖拽 */
+    canDrop?: (dragItem: NavigationMenuItem, dropTarget: NavigationMenuItem, parentId: string | number | null) => boolean;
+    /** 显示隐藏回调 */
+    onIsShow?: (item: NavigationMenuItem) => void;
+    /** 节点缩进宽度 */
+    indentationWidth?: number;
+    /** 隐藏描述 */
+    hideDescription?: boolean;
+    /** 悬浮时展示action */
+    showActionOnHover?: boolean;
+    /** 是否展示标题标签 */
+    showTitleTags?: boolean;
+}

package/lib/components/pisellNavigationMenu/utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 树节点的基本接口
+ */
+export interface TreeNode {
+    [key: string]: any;
+    children?: TreeNode[];
+}
+/**
+ * 格式化树结构数据
+ * @param tree 要格式化的树结构数据
+ * @param formatter 格式化函数，用于处理每个节点
+ * @param childrenField 子节点字段名，默认为 'children'
+ * @returns 格式化后的树结构
+ */
+export declare function formatTree<T extends TreeNode, R = T>(tree: T[], formatter: (node: T, level: number, parent: T | null) => R, childrenField?: string): R[];

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/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,73 @@
+/** 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;
+/** 日视图分组行默认高度（须容纳左侧折叠按钮等） */
+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」悬停层：卡片区约 64px + 行间 8px，与 react-window itemSize 一致 */
+export declare const MONTH_OVERFLOW_POPOVER_CARD_H = 64;
+export declare const MONTH_OVERFLOW_POPOVER_ROW_GAP = 8;
+export declare const MONTH_OVERFLOW_POPOVER_ITEM_H: number;
+export declare const MONTH_OVERFLOW_POPOVER_LIST_MAX_H = 280;
+export declare const OVERFLOW_MODAL_CARD_H = 100;
+export declare const OVERFLOW_MODAL_ROW_GAP = 8;
+export declare const OVERFLOW_MODAL_ROW_H: number;
+export declare const OVERFLOW_MODAL_LIST_MAX_H = 420;

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

@@ -2,7 +2,7 @@ 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";
+export declare function getBookingStateClasses(item: CalendarBookingSegmentInput, dateKey: string): "bg-red-700/70 text-red-100" | "bg-violet-700/90 text-violet-50" | "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";
 /**
  * 月 / 周紧凑格：不按签到/取消/迟到等状态变色，仅区分 booking（默认紫）与 block（红）。
  * 与 {@link getBookingStateClasses} 在无状态分支时一致，但不读取 `dateKey`。

package/lib/components/pisellRecordBoard/shellFrame/ResourceWall/NoteTicker.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import './VenueWallMarquee.less';
+export interface NoteTickerProps {
+    text: string;
+    color: string;
+    /** 跑完一整段所需秒数 */
+    duration?: number;
+    shouldMarquee: boolean;
+}
+/**
+ * 底部说明条：短文案省略静态展示，长文案无缝跑马灯（多段 copy 与 `VenueWallMarquee.less` 中 -33.333% 动画配套）。
+ * 系统「减少动态效果」时强制静态展示；跑马灯区对读屏 `aria-hidden` 避免重复朗读。
+ */
+export declare const NoteTicker: React.NamedExoticComponent<NoteTickerProps>;

package/lib/components/pisellRecordBoard/shellFrame/ResourceWall/resourceWallConstants.d.ts

@@ -0,0 +1,2 @@
+/** 说明文案超过该长度时用跑马灯（与 NoteTicker / VenueWallCard 共用） */
+export declare const RESOURCE_WALL_NOTE_MARQUEE_MIN_CHARS = 32;

package/lib/components/pisellRecordBoard/shellFrame/ToolBar/recordBoardToolBarConstants.d.ts

@@ -0,0 +1,8 @@
+/** 与 RecordBoard ToolBar 行为绑定的 searchParams 字段名 */
+export declare const DEFAULT_SEARCH_FIELD = "keyword";
+/** 筛选在 searchParams 中的字段名 */
+export declare const FILTER_PARAMS_FIELD = "filter";
+/** 排序在 searchParams 中的字段名 */
+export declare const SORT_PARAMS_FIELD = "sort";
+/** 与 ResourceWall 默认 `filterFieldKey` 一致 */
+export declare const RESOURCE_WALL_QUICK_FILTER_KEY = "resource_wall_resource_ids";

package/lib/components/pisellReservationSchedule/locales.d.ts

@@ -0,0 +1,43 @@
+/** PisellReservationSchedule 多语言；使用前 locales.init 合并 */
+declare const _default: {
+    en: {
+        'pisell-reservation-schedule.today': string;
+        'pisell-reservation-schedule.prev': string;
+        'pisell-reservation-schedule.next': string;
+        'pisell-reservation-schedule.prev-week': string;
+        'pisell-reservation-schedule.next-week': string;
+        'pisell-reservation-schedule.prev-month': string;
+        'pisell-reservation-schedule.next-month': string;
+        'pisell-reservation-schedule.pick-date': string;
+        'pisell-reservation-schedule.pick-date-title': string;
+        'pisell-reservation-schedule.pick-week-title': string;
+        'pisell-reservation-schedule.pick-month-title': string;
+    };
+    'zh-CN': {
+        'pisell-reservation-schedule.today': string;
+        'pisell-reservation-schedule.prev': string;
+        'pisell-reservation-schedule.next': string;
+        'pisell-reservation-schedule.prev-week': string;
+        'pisell-reservation-schedule.next-week': string;
+        'pisell-reservation-schedule.prev-month': string;
+        'pisell-reservation-schedule.next-month': string;
+        'pisell-reservation-schedule.pick-date': string;
+        'pisell-reservation-schedule.pick-date-title': string;
+        'pisell-reservation-schedule.pick-week-title': string;
+        'pisell-reservation-schedule.pick-month-title': string;
+    };
+    'zh-HK': {
+        'pisell-reservation-schedule.today': string;
+        'pisell-reservation-schedule.prev': string;
+        'pisell-reservation-schedule.next': string;
+        'pisell-reservation-schedule.prev-week': string;
+        'pisell-reservation-schedule.next-week': string;
+        'pisell-reservation-schedule.prev-month': string;
+        'pisell-reservation-schedule.next-month': string;
+        'pisell-reservation-schedule.pick-date': string;
+        'pisell-reservation-schedule.pick-date-title': string;
+        'pisell-reservation-schedule.pick-week-title': string;
+        'pisell-reservation-schedule.pick-month-title': string;
+    };
+};
+export default _default;

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

@@ -0,0 +1,52 @@
+import type { CSSProperties } from 'react';
+import type { Dayjs } from 'dayjs';
+/** 与 PisellTimeNavigator 一致：dayjs 或可解析字符串 */
+export declare type ReservationScheduleValue = Dayjs | string | null | undefined;
+/**
+ * PisellReservationSchedule：营业日切换条（上一日 / 文案 / 下一日）
+ */
+export interface PisellReservationScheduleProps {
+    /**
+     * 当前选中日（受控），日历日语义，建议使用 startOf('day') 对齐
+     */
+    value?: ReservationScheduleValue;
+    /**
+     * 选中日变更
+     */
+    onChange?: (date: Dayjs) => void;
+    /**
+     * 非受控初始日
+     */
+    defaultValue?: ReservationScheduleValue;
+    /**
+     * 不可早于该日（含）
+     */
+    minDate?: ReservationScheduleValue;
+    /**
+     * 不可晚于该日（含）
+     */
+    maxDate?: ReservationScheduleValue;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 根节点样式
+     */
+    style?: CSSProperties;
+    /**
+     * 为 true 时禁用上一日/下一日、日期点选（弹日历）；用于「跟随当前时刻」等只读日期条
+     * @default false
+     */
+    navigationLocked?: boolean;
+    /**
+     * `navigationLocked` 时的展示形态：`full` 保留左右箭头占位；`labelOnly` 仅展示中间日期文案（如场控页）。
+     * @default 'full'
+     */
+    navigationLockedDisplay?: 'full' | 'labelOnly';
+    /**
+     * 顶栏切换步长：`day` 按日；`week` 按周；`month` 按月（与 RecordBoard 日历视图联动）。
+     * @default 'day'
+     */
+    navigationUnit?: 'day' | 'week' | 'month';
+}

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

@@ -0,0 +1,68 @@
+import type { CSSProperties, ReactNode } from 'react';
+import type { Dayjs } from 'dayjs';
+import type { PisellTimeNavigatorProps } from '../pisellTimeNavigator/types';
+import type { PisellReservationScheduleProps } from '../pisellReservationSchedule/types';
+/**
+ * 组合值：顶栏选中日（营业日锚定）+ 时间轴游标绝对时刻 `at`。
+ * 跨日营业时 `at` 可为其它自然日时刻，顶栏 `date` 通常不变；展示用 {@link formatScheduleAtLabel}（带日期）。
+ */
+export interface ReservationScheduleBandValue {
+    date: Dayjs;
+    at: Dayjs;
+}
+export declare type TimeNavigatorPassthroughProps = Omit<PisellTimeNavigatorProps, 'value' | 'onChange' | 'defaultValue'>;
+/**
+ * PisellReservationScheduleBand：营业日条 + 横向时间轴
+ */
+export interface PisellReservationScheduleBandProps {
+    /**
+     * 受控：选中日 + 轴上时刻
+     */
+    value?: ReservationScheduleBandValue;
+    /**
+     * 日历日或时刻任一变化时触发
+     */
+    onChange?: (next: ReservationScheduleBandValue) => void;
+    /**
+     * 非受控初始值（可只传部分字段）
+     */
+    defaultValue?: Partial<ReservationScheduleBandValue>;
+    /**
+     * 透传给 PisellReservationSchedule（如 minDate / maxDate）
+     */
+    scheduleProps?: Omit<PisellReservationScheduleProps, 'value' | 'onChange' | 'defaultValue'>;
+    /**
+     * 透传给 PisellTimeNavigator（不含 value/onChange/referenceDate）
+     */
+    timeNavigatorProps?: TimeNavigatorPassthroughProps;
+    /**
+     * 顶栏日程行：PisellReservationSchedule 左侧自定义内容（如标题）
+     */
+    scheduleStartSlot?: ReactNode;
+    /**
+     * 顶栏日程行：PisellReservationSchedule 右侧自定义内容（如状态、主按钮）
+     */
+    scheduleEndSlot?: ReactNode;
+    /**
+     * 顶栏日程行：紧挨在选日组件之后（如「跟随当前」），与中间列同一 flex 区
+     */
+    scheduleAfterDateSlot?: ReactNode;
+    /**
+     * 为 true 时隐藏下方时间导航轴（如日历视图仅需要选日/选周/选月）
+     */
+    hideTimeNavigator?: boolean;
+    /**
+     * 为 true 时在整个日程带上叠加载层（如切换营业日后拉预约列表期间）
+     */
+    dataLoading?: boolean;
+    /**
+     * 加载层内文案，由业务侧 {@link locales.getText} 等注入
+     */
+    dataLoadingTip?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+    /**
+     * 追加到内部 `.pisell-reservation-schedule-band-schedule-row` 的类名（如手机端无视图切换时改为一行布局）。
+     */
+    scheduleRowClassName?: string;
+}

package/lib/components/pisellReservationScheduleBand/utils/formatScheduleAtLabel.d.ts

@@ -0,0 +1,9 @@
+import type { Dayjs } from 'dayjs';
+/**
+ * 预约顶栏游标文案：与顶栏锚定日同一天只显示 HH:mm；跨自然日则带日期（MM-DD HH:mm）。
+ * 顶栏 `date` 不变，仅展示层标明 `at` 的真实日历日。
+ *
+ * @param at 时间轴绝对时刻（可落在锚定日的次日等）
+ * @param anchorDate 顶栏选中的日历日（营业日锚定，不因拖轴而改）
+ */
+export declare function formatScheduleAtLabel(at: Dayjs, anchorDate: Dayjs): string;

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

@@ -0,0 +1,23 @@
+import React from 'react';
+import { BrowserMultiFormatReader } from '@zxing/library';
+import './index.less';
+export interface PisellScanProps extends Omit<React.HTMLAttributes<HTMLVideoElement>, 'onChange'> {
+    /** 当前scan展示宽度 */
+    width: string | number;
+    /** 当前scan展示高度 */
+    height?: string | number;
+    /** 当前scan圆角 */
+    borderRadius?: string | number;
+    /** 扫描完成回调 */
+    onChange?: (val: string) => void;
+    /** 扫描间隔时间 毫秒 */
+    timeBetweenScansMillis?: number;
+}
+export declare type PisellScanRef = {
+    codeReader: BrowserMultiFormatReader | null;
+};
+/**
+ * 二维码条形码扫描组件
+ */
+declare const PisellScan: React.ForwardRefExoticComponent<PisellScanProps & React.RefAttributes<PisellScanRef>>;
+export default PisellScan;

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

@@ -0,0 +1,21 @@
+import React from 'react';
+import './index.less';
+export interface PisellSectionHeadersProps {
+    /** 是否占据空间（true: 占据空间, false: 不占据空间） */
+    /** 左侧返回区域 */
+    backNode?: React.ReactNode;
+    /** 中间内容区域 */
+    centerNode?: React.ReactNode;
+    /** 右侧操作区域 */
+    actionNode?: React.ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 返回按钮点击事件 */
+    onBack?: () => void;
+    /** 操作区域点击事件 */
+    onAction?: () => void;
+}
+declare const PisellSectionHeaders: React.FC<PisellSectionHeadersProps>;
+export default PisellSectionHeaders;

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

@@ -0,0 +1,7 @@
+import { SortListProps } from '../sort/types';
+import { FormInstance } from 'antd';
+export declare type PisellSortProps = SortListProps & {
+    name?: string;
+} & FormInstance & {
+    hasForm?: boolean;
+};

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

@@ -0,0 +1,13 @@
+import React from 'react';
+import './index.less';
+export declare type PisellTagsType = 'pill_color' | 'pill_outline';
+export declare type PisellTagsColor = 'success' | 'warning' | 'error' | 'gray' | string;
+export interface PisellTagsProps extends React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement> {
+    children?: React.ReactNode;
+    others?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>;
+    type: PisellTagsType;
+    icon?: React.ReactNode;
+    color?: PisellTagsColor;
+}
+declare const PisellTags: (props: PisellTagsProps) => JSX.Element;
+export default PisellTags;

package/lib/components/pisellTags/utils.d.ts

@@ -0,0 +1 @@
+export declare const generateColorShades: (color: string) => Record<string, string>;

package/lib/components/pisellTimeNavigator/components/BackgroundLayer.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+export interface BackgroundLayerProps {
+    orientation: 'horizontal' | 'vertical';
+    /** 过去时间淡化色 */
+    pastTimeFade?: string;
+    /** 营业时间区间 [startPx, endPx]，用于视觉高亮 */
+    businessHoursPx?: [number, number];
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * 背景区间层：营业时间高亮、过去时间淡化等（当前时间渐变已拆为独立块，见 axis-wrap 内 .pisell-time-navigator-current-gradient）
+ */
+export declare function BackgroundLayer({ orientation, pastTimeFade, businessHoursPx, className, style, }: BackgroundLayerProps): JSX.Element;

package/lib/components/pisellTimeNavigator/components/CursorLayer.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { Dayjs } from 'dayjs';
+export interface CursorLayerProps {
+    orientation: 'horizontal' | 'vertical';
+    value: Dayjs | null;
+    timeFormat: string;
+    /** 优先于 timeFormat + locale */
+    formatTimeLabel?: (value: Dayjs) => string;
+    locale?: string;
+    isRealtime: boolean;
+    offsetPx: number;
+    /** axis-moves 时固定于视口中央，不应用 offsetPx */
+    fixedCenter?: boolean;
+    style?: React.CSSProperties;
+    className?: string;
+    /** cursor-moves：允许拖指针改时间 */
+    dragInteractive?: boolean;
+    /** 当前是否正处于拖拽（按下未抬起）：用于驱动气泡放大反馈样式 */
+    isDragging?: boolean;
+    onDragPointerDown?: React.PointerEventHandler<HTMLDivElement>;
+    onDragPointerMove?: React.PointerEventHandler<HTMLDivElement>;
+    onDragPointerUp?: React.PointerEventHandler<HTMLDivElement>;
+    onDragPointerCancel?: React.PointerEventHandler<HTMLDivElement>;
+}
+/**
+ * 时间指示器层：横向为「顶三角 + 竖长方条」SVG，竖向为横线 + 时间气泡
+ * 对齐基准为几何中心。Realtime 态 #FF692E，浏览态 #344054
+ */
+export declare function CursorLayer({ orientation, value, timeFormat, formatTimeLabel, locale, isRealtime, offsetPx, fixedCenter, style, className, dragInteractive, isDragging, onDragPointerDown, onDragPointerMove, onDragPointerUp, onDragPointerCancel, }: CursorLayerProps): JSX.Element | null;

package/lib/components/pisellTimeNavigator/components/GestureLayer.d.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+import type { Dayjs } from 'dayjs';
+export interface GestureLayerProps {
+    orientation: 'horizontal' | 'vertical';
+    cellSizePx: number;
+    /** 轴在滚动内容中的起始边距（左/上），用于把「滚动内容坐标」转为「轴内偏移」（与 dot 对齐） */
+    axisStartMarginPx: number;
+    /**
+     * 偏移 → 整点对齐的「最近 tick」时间。`snapToStep=true` 时点击 / 方向键吸到 step 网格上用。
+     */
+    offsetToTime: (offset: number) => Dayjs | null;
+    /**
+     * 偏移 → 连续时间（不吸附）。`snapToStep=false` 时点击与方向键都走这条，
+     * 让用户点哪儿就跳到哪一秒，不再被 stepMinutes 强行回弹。
+     */
+    offsetToTimeContinuous: (offset: number) => Dayjs | null;
+    onSelectTime: (t: Dayjs) => void;
+    isInDisabledRanges: (t: Dayjs) => boolean;
+    snapToStep: boolean;
+    stepMinutes: number;
+    snapFn: (t: Dayjs) => Dayjs;
+    scrollPosition: {
+        scrollLeft: number;
+        scrollTop: number;
+    };
+    viewportSize: {
+        w: number;
+        h: number;
+    };
+    onPointerDown?: React.PointerEventHandler;
+    onPointerMove?: React.PointerEventHandler;
+    onPointerUp?: React.PointerEventHandler;
+    onPointerLeave?: React.PointerEventHandler;
+    /** 轴上任意指针按下（含惯性拖轴） */
+    onUserInteraction?: () => void;
+    children: React.ReactNode;
+}
+/**
+ * 交互层：点击刻度跳转、键盘左右/上下 + 回车
+ */
+export declare function GestureLayer({ orientation, cellSizePx, axisStartMarginPx, offsetToTime, offsetToTimeContinuous, onSelectTime, isInDisabledRanges, snapToStep, stepMinutes, snapFn, scrollPosition, viewportSize, onPointerDown, onPointerMove, onPointerUp, onPointerLeave, onUserInteraction, children, }: GestureLayerProps): JSX.Element;