@pisell/materials 6.11.223 → 6.11.225

package/lib/components/pisellRecordBoard/utils/partitionShellFrameChildren.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { RecordBoardFloorMapProps, RecordBoardCalendarProps, RecordBoardResourceWallProps } from '../types';
+/** 与 shellFrame/FloorMap 上定义的 displayName 一致，用于从 ShellFrame children 中识别平面图槽 */
+export declare const RECORD_BOARD_FLOOR_MAP_DISPLAY_NAME = "RecordBoard.FloorMap";
+/** 与 shellFrame/Calendar 上定义的 displayName 一致 */
+export declare const RECORD_BOARD_CALENDAR_DISPLAY_NAME = "RecordBoard.Calendar";
+/** 与 shellFrame/ResourceWall 上定义的 displayName 一致 */
+export declare const RECORD_BOARD_RESOURCE_WALL_DISPLAY_NAME = "RecordBoard.ResourceWall";
+/**
+ * 将 ShellFrame 的 children 拆成：供表格区渲染的子树 + 可选的 FloorMap / Calendar 透传 props。
+ * 支持 Fragment 嵌套；多个同槽时以最后一个为准。
+ */
+export declare function partitionShellFrameChildren(children: React.ReactNode): {
+    gridChildren: React.ReactNode;
+    /** 是否出现 FloorMap 槽位节点（props 可为空，可与根级 floorMap 合并） */
+    hasFloorMapChild: boolean;
+    floorMapPropsFromChild?: RecordBoardFloorMapProps;
+    hasCalendarChild: boolean;
+    calendarPropsFromChild?: RecordBoardCalendarProps;
+    hasResourceWallChild: boolean;
+    resourceWallPropsFromChild?: RecordBoardResourceWallProps;
+    hasGridContent: boolean;
+};

package/lib/components/pisellRecordBoard/utils/recordBoardColumns.d.ts

@@ -0,0 +1,52 @@
+import React from 'react';
+import type { RecordBoardColumnType } from '../types';
+import type { FilterValueType } from '../../filter/components/FilterButton/types';
+import type { SortItemProps } from '../../sort/types';
+/** 获取列唯一 key，供列显示隐藏等使用 */
+export declare function getRecordBoardColumnKey(column: RecordBoardColumnType): string;
+/**
+ * 同值列总结栏不展示的内容：null/undefined、空串、纯空白、占位「-」。
+ * 列仍可折叠；仅用于不生成总结栏条目（避免「-」、空白等占位）。
+ */
+export declare function isTrivialUniformSummaryDisplayValue(v: any): boolean;
+/**
+ * 总结区实际渲染的 React 节点是否视为无展示价值（与 {@link isTrivialUniformSummaryDisplayValue} 对齐，含一层子节点）。
+ */
+export declare function isTrivialUniformSummaryReactContent(node: React.ReactNode): boolean;
+export interface UniformColumnSummaryItem {
+    columnKey: string;
+    title: string;
+    type: 'uniform' | 'empty';
+    /** 无 render 时的回退展示 */
+    displayValue?: string;
+    /** 仅用于判断是否相等的值（uniformCompare 的返回值或 dataIndex 取值），不参与 render */
+    value?: any;
+    /** 表格里该列单元格的值（dataIndex 从 record 取值），传给 render 的与表格单元格一致 */
+    cellValue?: any;
+    /** 代表行（如首行），供列 render 使用 */
+    record?: any;
+}
+/**
+ * 根据当前页 data 计算：哪些列「全列同值」或「全空」应隐藏，以及总结区展示项。
+ * 折叠列与总结项可不一一对应：全空、整列「-」/空白等同值仍折叠，但不生成无信息总结项。
+ * 仅当 grid.collapseUniformColumns 为 true 时使用。
+ */
+export declare function computeUniformColumnSummary(data: any[], columns: RecordBoardColumnType[]): {
+    uniformHiddenColumnKeys: string[];
+    summaryItems: UniformColumnSummaryItem[];
+};
+/**
+ * 处理列配置：对带 type 的列注入基于 Pisell 组件的 render，其余列保持不变。
+ * 有 type 时若列上传入了 render 则优先使用（覆盖自动派生）。
+ */
+export declare function processColumnsForGrid<RecordType = any>(columns: RecordBoardColumnType<RecordType>[] | undefined): RecordBoardColumnType<RecordType>[];
+/**
+ * 从 columns 派生排序列表（SortItemProps[]）。
+ * 有 type 的列：根据组件 SortOptions（或默认）生成；无 type 的列：根据 sortable + sort 生成。
+ */
+export declare function deriveSortFromColumns(columns: RecordBoardColumnType[] | undefined): SortItemProps[];
+/**
+ * 从 columns 派生 filter 列表（quickFilter + otherFilter）。
+ * 有 type 的列：根据 type + fieldProps 生成筛选项；无 type 的列：根据 filterable + filter 生成。
+ */
+export declare function deriveFilterFromColumns(columns: RecordBoardColumnType[] | undefined): FilterValueType;

package/lib/components/pisellRecordBoard/utils/recordBoardPhoneGrid.d.ts

@@ -0,0 +1,27 @@
+import type { RecordBoardColumnType } from '../types';
+/** Grid 根节点在 `layoutVariant="phone"` 时追加的 class，用于收紧单元格 padding 等 */
+export declare const RECORD_BOARD_PHONE_GRID_CLASS = "pisell-record-board-grid--phone";
+export interface AdaptColumnsForPhoneLayoutOptions {
+    /** 列 key → 最大宽度（px），在比例缩放后再取 min */
+    widthCapsByKey?: Record<string, number>;
+    /** 列 key → 宽度缩放比例（相对原 width）；未配置则用 defaultWidthRatio */
+    widthRatioByKey?: Record<string, number>;
+    /** 默认 numeric width 缩放比例 @default 5/6 */
+    defaultWidthRatio?: number;
+    /** 是否去掉 fixed 列（手机横向滚动场景） @default true */
+    unsetFixed?: boolean;
+}
+/**
+ * 手机 Table：收窄列宽并去掉 fixed，供 RecordBoard Grid 在 layoutVariant=phone 时统一调用。
+ * 业务可通过 grid.phoneColumnWidthCaps / phoneColumnWidthRatioByKey 覆盖特定列。
+ */
+export declare function adaptColumnsForPhoneLayout(columns: RecordBoardColumnType[], options?: AdaptColumnsForPhoneLayoutOptions): RecordBoardColumnType[];
+export declare function mergeRecordBoardPhoneGridClassName(className?: string): string | undefined;
+/**
+ * 手机 Table：`scroll.x: 'max-content'` 会按内容撑出比「列宽之和」更宽的滚动区域，
+ * 列宽已被 adaptColumnsForPhoneLayout 收窄后仍保留 max-content 时，右侧会出现可滚动的空白。
+ * 与预约 buildReservationMobileTableGridConfig 去掉横向 scroll 的策略一致，改为数值宽度。
+ */
+export declare function resolveRecordBoardPhoneScrollX(scrollX: number | string | undefined, sumColumnWidths: number, options?: {
+    selectionColumnWidth?: number;
+}): number | string | undefined;

package/lib/components/pisellRecordBoard/utils/withRecordBoard.d.ts

@@ -0,0 +1,9 @@
+import React, { ComponentType } from 'react';
+import type { RecordBoardContextValue, RecordBoardChildComponentProps } from '../types';
+declare type RecordBoardDisplayName = keyof RecordBoardChildComponentProps;
+/**
+ * 为 RecordBoard 下的子组件注入 context，并合并 childComponentProps[displayName]。
+ * 用于 Search / ToolBar / Pagination / Grid / CardList 等「被接管」的通用组件封装。
+ */
+declare function withRecordBoard<P extends object, R = any>(WrappedComponent: ComponentType<P & RecordBoardContextValue>, displayName: RecordBoardDisplayName): React.ForwardRefExoticComponent<React.PropsWithoutRef<P> & React.RefAttributes<R>>;
+export default withRecordBoard;

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/PisellReservationScheduleBand.stories.d.ts

@@ -0,0 +1,16 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellReservationScheduleBand } from './PisellReservationScheduleBand';
+/**
+ * PisellReservationScheduleBand：营业日条 + 横向时间轴顶栏组合，统一 value `{ date, at }`。
+ * 详见组件目录下 docs/PisellReservationScheduleBand.md。
+ */
+declare const meta: Meta<typeof PisellReservationScheduleBand>;
+export default meta;
+declare type Story = StoryObj<typeof PisellReservationScheduleBand>;
+export declare const Default: Story;
+export declare const CustomTimeNavigator: Story;
+export declare const ScheduleMinMax: Story;
+export declare const Controlled: Story;
+export declare const InitialPastDay: Story;
+/** 日程行左右插槽：左标题 + 中间 PisellReservationSchedule + 右操作区（整条顶栏暗色背景需在业务外层自行包一层，避免压住下方时间轴） */
+export declare const WithScheduleSlots: Story;

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

@@ -0,0 +1,3 @@
+export { PisellReservationScheduleBand } from './PisellReservationScheduleBand';
+export { formatScheduleAtLabel } from './utils/formatScheduleAtLabel';
+export type { PisellReservationScheduleBandProps, ReservationScheduleBandValue, TimeNavigatorPassthroughProps, } from './types';

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/pisellShellFrame/PisellShellFrame.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { PisellShellFrameProps } from './types';
+import './PisellShellFrame.less';
+/**
+ * PisellShellFrame：通用壳层布局组件。
+ * 支持通过 config 控制各区域显隐，不同展示类型（表格/看板/日历/楼层图等）复用同一壳层。
+ *
+ * - 顶部：标题区（标题/副标题/辅助信息）、工具区（Toolbar）、统计区（Statistic List，可选折叠）
+ * - 中间：滚动承载（可选）+ Layout 插槽（children）
+ * - 底部：批量操作条（按选中状态出现）、状态提示区（加载/错误/同步提示等）
+ */
+export declare const PisellShellFrame: React.FC<PisellShellFrameProps>;
+export default PisellShellFrame;

package/lib/components/pisellShellFrame/PisellShellFrame.stories.d.ts

@@ -0,0 +1,15 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellShellFrame } from './PisellShellFrame';
+declare const meta: Meta<typeof PisellShellFrame>;
+export default meta;
+declare type Story = StoryObj<typeof PisellShellFrame>;
+/** 仅标题区 */
+export declare const TitleOnly: Story;
+/** 标题 + 工具区 */
+export declare const WithToolbar: Story;
+/** 标题 + 统计区（可折叠，国际化） */
+export declare const WithStatisticCollapsible: Story;
+/** 中间滚动 + 底部批量条 + 状态区 */
+export declare const WithScrollBatchAndStatus: Story;
+/** 全区域展示（默认展开统计） */
+export declare const Full: Story;

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

@@ -0,0 +1,2 @@
+export { PisellShellFrame, default } from './PisellShellFrame';
+export type { PisellShellFrameProps, PisellShellFrameConfig, PisellShellFrameScrollConfig, } from './types';

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

@@ -0,0 +1,62 @@
+import type { ReactNode, CSSProperties } from 'react';
+/**
+ * 滚动配置：为 true 时使用默认滚动；为对象时传入样式或 scroll 相关配置。
+ */
+export declare type PisellShellFrameScrollConfig = boolean | {
+    style?: CSSProperties;
+    className?: string;
+};
+/**
+ * PisellShellFrame 配置：控制各区域的展示与行为。
+ * 不同展示类型（表格/看板/日历等）复用同一壳层，通过配置控制显隐。
+ */
+export interface PisellShellFrameConfig {
+    /** 是否展示顶部标题区（标题/副标题/辅助信息） */
+    showTitle?: boolean;
+    /** 是否展示顶部工具区（Toolbar） */
+    showToolbar?: boolean;
+    /** 是否展示顶部统计区（Statistic List） */
+    showStatistic?: boolean;
+    /** 统计区是否支持折叠，仅 showStatistic 为 true 时有效 */
+    statisticCollapsible?: boolean;
+    /** 中间内容区是否使用滚动承载包裹；为 true 时默认 overflow auto */
+    scroll?: PisellShellFrameScrollConfig;
+    /** 是否展示底部批量操作条（按选中状态出现由调用方控制，此处仅控制是否渲染该槽位） */
+    showBatchActionBar?: boolean;
+    /** 是否展示底部状态提示区（加载/错误/同步提示等） */
+    showStatusArea?: boolean;
+}
+/**
+ * PisellShellFrame 组件 Props。
+ * 通过 config 控制各区域显隐，通过 slot props 传入各区域内容。
+ */
+export interface PisellShellFrameProps {
+    /** 类名 */
+    className?: string;
+    /** 内联样式 */
+    style?: CSSProperties;
+    /** 区域显隐与行为配置，未传则默认不展示可选区域 */
+    config?: PisellShellFrameConfig;
+    /** 标题 */
+    title?: ReactNode;
+    /** 副标题 */
+    subtitle?: ReactNode;
+    /** 标题区右侧辅助信息 */
+    titleExtra?: ReactNode;
+    /** 工具栏内容 */
+    toolbar?: ReactNode;
+    /**
+     * 工具栏正下方、统计/正文之上的"附加条"插槽，渲染于 header 内部。
+     * 适用于「统计摘要 / 当前所选筛选标签」等需要紧贴 toolbar 的轻量条目。
+     * 当为空时不占位、不渲染外壳。
+     */
+    belowToolbar?: ReactNode;
+    /** 统计列表内容（如 PisellStatisticList 或自定义） */
+    statisticList?: ReactNode;
+    /** 主内容（表格/看板/日历/楼层图等），当 config.scroll 为 true 时会被滚动容器包裹 */
+    children?: ReactNode;
+    /** 批量操作条，通常按选中状态显隐由调用方控制 */
+    batchActionBar?: ReactNode;
+    /** 状态提示（加载/错误/同步提示等） */
+    statusArea?: ReactNode;
+}

package/lib/components/pisellSingleLineText/PisellSingleLineText.stories.d.ts

@@ -0,0 +1,102 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellSingleLineText } from './PisellSingleLineText';
+/**
+ * PisellSingleLineText 是一个通用的单行文本输入/展示组件。
+ *
+ * ## 功能特性
+ * - 支持三种状态：只读、编辑、禁用
+ * - 完整的校验框架
+ * - 受控/非受控模式
+ * - 丰富的配置项
+ */
+declare const meta: Meta<typeof PisellSingleLineText>;
+export default meta;
+declare type Story = StoryObj<typeof PisellSingleLineText>;
+/**
+ * 基础编辑态示例
+ */
+export declare const Basic: Story;
+/**
+ * 只读态示例 - 展示文本内容
+ */
+export declare const ReadMode: Story;
+/**
+ * 只读态 - 超长文本截断
+ */
+export declare const ReadModeEllipsis: Story;
+/**
+ * 禁用态示例
+ */
+export declare const Disabled: Story;
+/**
+ * 必填校验示例
+ */
+export declare const Required: Story;
+/**
+ * 长度校验示例
+ */
+export declare const LengthValidation: Story;
+/**
+ * 正则校验 - 仅数字
+ */
+export declare const PatternValidation: Story;
+/**
+ * 自定义校验函数
+ */
+export declare const CustomValidator: Story;
+/**
+ * 前缀图标
+ */
+export declare const WithPrefix: Story;
+/**
+ * 后缀文本
+ */
+export declare const WithSuffix: Story;
+/**
+ * 前置标签
+ */
+export declare const WithAddonBefore: Story;
+/**
+ * 后置标签 - 按钮
+ */
+export declare const WithAddonAfter: Story;
+/**
+ * 完整配置示例
+ */
+export declare const FullFeatures: Story;
+/**
+ * 自定义样式 - 只读态
+ */
+export declare const CustomStyle: Story;
+/**
+ * 只读态 - 普通文本样式（默认）
+ */
+export declare const DisplayVariantText: Story;
+/**
+ * 只读态 - 超链接样式
+ */
+export declare const DisplayVariantLink: Story;
+/**
+ * 只读态 - 徽标样式（圆形红色徽标）
+ */
+export declare const DisplayVariantBadge: Story;
+/**
+ * 只读态 - 徽标样式（文本内容）
+ */
+export declare const DisplayVariantBadgeText: Story;
+/**
+ * 只读态 - 标签样式（默认灰色边框）
+ */
+export declare const DisplayVariantTag: Story;
+/**
+ * 只读态 - 标签样式（自定义颜色）
+ */
+export declare const DisplayVariantTagColored: Story;
+/**
+ * 只读态 - 标签样式（可关闭）
+ */
+export declare const DisplayVariantTagClosable: Story;
+/**
+ * 展示样式对比 - 所有变体（基于 Figma 设计）
+ */
+export declare const AllDisplayVariants: Story;

package/lib/components/pisellSingleLineText/components/DisabledView.d.ts

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

package/lib/components/pisellSingleLineText/components/ReadOnlyView.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { PisellSingleLineTextProps } from '../types';
+/**
+ * PisellSingleLineText 只读态视图组件
+ *
+ * 负责渲染只读态的文本展示，支持多种展示样式变体（基于 Figma 设计规范）
+ *
+ * 功能：
+ * - 普通文本展示（默认）- 16px, Medium, Gray/900
+ * - 超链接样式 - 链接色，带下划线
+ * - 徽标样式 - 圆形红色徽标（类似通知数量）
+ * - 标签样式 - 灰色边框标签
+ * - 文本截断（ellipsis）
+ * - Tooltip 悬停提示完整内容
+ * - 自定义样式（字号、字重、颜色、对齐）
+ *
+ * @param props 组件 Props
+ */
+declare const ReadOnlyView: React.FC<PisellSingleLineTextProps>;
+export default ReadOnlyView;

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

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

package/lib/components/pisellSingleSelect/PisellSingleSelect.stories.d.ts

@@ -0,0 +1,66 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import PisellSingleSelect from './PisellSingleSelect';
+/**
+ * PisellSingleSelect 组件 Storybook
+ *
+ * 用于展示和测试组件的各种状态和配置
+ */
+declare const meta: Meta<typeof PisellSingleSelect>;
+export default meta;
+declare type Story = StoryObj<typeof PisellSingleSelect>;
+/**
+ * 基础示例
+ */
+export declare const Basic: Story;
+/**
+ * 带标签
+ */
+export declare const WithLabel: Story;
+/**
+ * 带辅助文本
+ */
+export declare const WithHelperText: Story;
+/**
+ * 带搜索功能
+ */
+export declare const WithSearch: Story;
+/**
+ * 带清空按钮
+ */
+export declare const WithClear: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 只读态
+ */
+export declare const ReadOnly: Story;
+/**
+ * 只读态 - 空值
+ */
+export declare const ReadOnlyEmpty: Story;
+/**
+ * 错误状态
+ */
+export declare const WithError: Story;
+/**
+ * 不同尺寸
+ */
+export declare const Sizes: Story;
+/**
+ * 表单场景
+ */
+export declare const InForm: Story;
+/**
+ * 自定义过滤
+ */
+export declare const CustomFilter: Story;
+/**
+ * 回调事件演示
+ */
+export declare const WithCallbacks: Story;
+/**
+ * 所有状态组合
+ */
+export declare const AllStates: Story;

package/lib/components/pisellSingleSelect/components/DisabledView.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PisellSingleSelect - DisabledView (禁用态视图)
+ * 禁用状态下的渲染
+ */
+import React from 'react';
+import type { DisabledViewProps } from '../types';
+declare const DisabledView: React.ForwardRefExoticComponent<DisabledViewProps<string | number> & React.RefAttributes<any>>;
+export default DisabledView;

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

@@ -0,0 +1,7 @@
+/**
+ * PisellSingleSelect 组件导出
+ */
+import PisellSingleSelect from './PisellSingleSelect';
+export { PisellSingleSelect };
+export type { PisellSingleSelectProps, SingleSelectRef, EditViewProps, DisabledViewProps, ReadOnlyViewProps, } from './types';
+export type { SelectOption, FilterOptionFunc, SortDirection, SelectState, } from './types';

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

@@ -0,0 +1,3 @@
+import { PisellSortProps } from './type';
+declare const PisellSort: (props: PisellSortProps) => JSX.Element;
+export default PisellSort;

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