@pisell/materials 1.8.23 → 1.8.24

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

@@ -0,0 +1,10 @@
+import React from 'react';
+export interface RecordBoardSearchProps {
+    [key: string]: any;
+}
+/**
+ * RecordBoard 下的独立搜索槽：使用 PisellFind，绑定 context.searchParams.keyword 与 onSearch。
+ * 可通过 childComponentProps.search 透传 PisellFind 的 props。
+ */
+declare const RecordBoardSearch: React.FC<RecordBoardSearchProps>;
+export default RecordBoardSearch;

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

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { RecordBoardToolBarProps as ToolBarPropsType } from '../../types';
+import './ToolBarFilter.less';
+import './recordBoardToolbar.less';
+/**
+ * RecordBoard 下的工具栏：使用 PisellToolBar。
+ * 左侧默认 PisellFind（inline）；右侧默认 PisellFilter。通过 childComponentProps.toolBar.search / toolBar.filter 为对象时透传对应组件 props，为 false 时不渲染。
+ * 可透传 topLeft、topRight、bottomLeft、bottomRight、tabs。
+ */
+declare const RecordBoardToolBar: React.FC<RecordBoardToolBarProps>;
+export declare type RecordBoardToolBarProps = ToolBarPropsType;
+export default RecordBoardToolBar;

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

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { FilterItemProps } from '../../../filter/types';
+export interface ToolBarQuickFilterProps {
+    /** 快速筛选项列表（与 Filter 的 quickFilter 同结构），不传则从 columns 派生时由父级传入 */
+    filterList?: FilterItemProps[];
+    /** 表单字段前缀，与 PisellFilter 保持一致，默认 '' */
+    formFiltersPrefix?: string;
+    /** 表单项尺寸 */
+    size?: 'small' | 'middle' | 'large';
+}
+/**
+ * RecordBoard 工具栏左侧内联快速筛选：将 quickFilter 直接展示在 ToolBar 左侧，不放入 Filter 弹层。
+ * 与 searchParams.filter 联动，变更写入 searchParams.filter.values 并触发 onSearch。
+ * 启用时建议 ToolBar 对 PisellFilter 传 hiddenQuickFilter: true，仅保留高级筛选在弹层内。
+ */
+declare const ToolBarQuickFilter: React.FC<ToolBarQuickFilterProps>;
+export default ToolBarQuickFilter;

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

@@ -0,0 +1,16 @@
+import React from 'react';
+import './index.less';
+export interface ToolBarResetProps {
+    /** 按钮尺寸，与 antd Button 一致，默认与筛选按钮对齐为 large */
+    size?: 'small' | 'middle' | 'large';
+    /** 按钮类型 */
+    type?: 'default' | 'primary' | 'link' | 'text';
+    /** 按钮文案，默认使用多语言「重置」 */
+    children?: React.ReactNode;
+}
+/**
+ * RecordBoard 工具栏重置按钮：清空筛选与排序并刷新表格。
+ * 点击后以空 filter.values、清空 sort 调用 onSearch，并调用 onReset（若提供）。
+ */
+declare const ToolBarReset: React.FC<ToolBarResetProps>;
+export default ToolBarReset;

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

@@ -0,0 +1,22 @@
+import React from 'react';
+import RecordBoardToolBar from './ToolBar';
+import RecordBoardBatchActionBar from './BatchActionBar';
+import RecordBoardPagination from './Pagination';
+import RecordBoardSearch from './Search';
+import './shellFrameFloorMap.less';
+import ToolBarReset from './ToolBarReset';
+import ToolBarQuickFilter from './ToolBarQuickFilter';
+import RecordBoardFloorMap from './FloorMap';
+/**
+ * Shell Frame：基于 PisellShellFrame 的 RecordBoard 壳层。
+ * 解析子节点：**GridLayout / CardLayout 等** 与可选 **\<PisellRecordBoard.FloorMap /\>**；
+ * 仅表格侧、仅平面图侧、或双视图（出现 Segmented 切换）由子节点组合决定。根级 `floorMap` props 仍支持（如低代码透传），与 FloorMap 子组件 props 合并，**子组件优先**。
+ */
+declare const RecordBoardShellFrame: React.FC<{
+    children?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}>;
+export default RecordBoardShellFrame;
+export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, RecordBoardFloorMap };
+export { useRecordBoardShellBodyMeta } from './ShellBodyMetaContext';

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

@@ -0,0 +1,41 @@
+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;
+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/es/components/pisellRecordBoard/utils/recordBoardColumns.js

@@ -25,6 +25,7 @@ import { PisellRating } from "../../pisellRating";
 import { PisellSingleSelect } from "../../pisellSingleSelect";
 import { PisellMultipleSelect } from "../../pisellMultipleSelect";
 import { PisellDateTimeDisplay } from "../../pisellDateTimeDisplay";
+import { getText } from "../../../locales";
 var FIELD_TYPE_TO_READ_COMPONENT = {
   singleLineText: PisellSingleLineText,
   longText: PisellLongText,
@@ -329,7 +330,7 @@ function columnToFilterItem(column) {
   if (column.filterable === false) return null;
   var hasExplicitFilter = column.filter && (column.filter.type != null || column.filter.component);
   if (column.type && !hasExplicitFilter) {
-    var _column$fieldProps2, _fieldProps$options, _fieldProps$placehold;
+    var _column$fieldProps2, _fieldProps$options, _fieldProps$placehold, _getText;
     var fieldType = column.type;
     var _filterType = FIELD_TYPE_TO_FILTER_TYPE[fieldType];
     var fieldProps = (_column$fieldProps2 = column.fieldProps) !== null && _column$fieldProps2 !== void 0 ? _column$fieldProps2 : {};
@@ -349,7 +350,7 @@ function columnToFilterItem(column) {
         options: options !== null && options !== void 0 ? options : [],
         getOptions: fieldProps.getOptions
       }, fieldProps) : _objectSpread({
-        placeholder: (_fieldProps$placehold = fieldProps.placeholder) !== null && _fieldProps$placehold !== void 0 ? _fieldProps$placehold : "\u8BF7\u8F93\u5165".concat(label)
+        placeholder: (_fieldProps$placehold = fieldProps.placeholder) !== null && _fieldProps$placehold !== void 0 ? _fieldProps$placehold : String((_getText = getText('pisell2.recordBoard.filter.placeholderEnter')) !== null && _getText !== void 0 ? _getText : '').replace(/\{label\}/g, label)
       }, fieldProps),
       other: _objectSpread({
         fieldType: fieldType,

package/es/components/pisellReservationSchedule/PisellReservationSchedule.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import type { PisellReservationScheduleProps } from './types';
+import './PisellReservationSchedule.less';
+/**
+ * 营业日导航条：上一日、中间日期文案、下一日（深色条样式，适配预约顶栏）
+ */
+export declare function PisellReservationSchedule(props: PisellReservationScheduleProps): JSX.Element;
+export declare namespace PisellReservationSchedule {
+    var displayName: string;
+}

package/es/components/pisellReservationSchedule/PisellReservationSchedule.stories.d.ts

@@ -0,0 +1,12 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellReservationSchedule } from './PisellReservationSchedule';
+/**
+ * PisellReservationSchedule：预约营业日导航（上一天 / 日期文案 / 下一天）。
+ * 多语言与日期格式依赖 LowCode 引擎 locale。详见组件目录下 docs/PisellReservationSchedule.md。
+ */
+declare const meta: Meta<typeof PisellReservationSchedule>;
+export default meta;
+declare type Story = StoryObj<typeof PisellReservationSchedule>;
+export declare const Default: Story;
+export declare const WithMinMax: Story;
+export declare const Controlled: Story;

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

@@ -0,0 +1,2 @@
+export { PisellReservationSchedule } from './PisellReservationSchedule';
+export type { PisellReservationScheduleProps, ReservationScheduleValue, } from './types';

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

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

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

@@ -0,0 +1,49 @@
+import type { CSSProperties, ReactNode } from 'react';
+import type { Dayjs } from 'dayjs';
+import type { PisellTimeNavigatorProps } from '../pisellTimeNavigator/types';
+import type { PisellReservationScheduleProps } from '../pisellReservationSchedule/types';
+/** 组合值：日历日 + 该日上的时刻（与 PisellTimeNavigator 对齐） */
+export interface ReservationScheduleBandValue {
+    date: Dayjs;
+    at: Dayjs;
+}
+export declare type TimeNavigatorPassthroughProps = Omit<PisellTimeNavigatorProps, 'value' | 'onChange' | 'referenceDate' | '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;
+    className?: string;
+    style?: CSSProperties;
+}

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

@@ -0,0 +1,22 @@
+import React from 'react';
+import { PisellContextType } from '../pisell-config-provider/context';
+import './index.less';
+export interface PisellRowProps extends React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement> {
+    platform?: PisellContextType['platform'];
+    gap?: number;
+    padding?: number;
+    leftContent?: React.ReactNode;
+    rightContent?: React.ReactNode;
+    centerContent?: React.ReactNode;
+    centerContentFill?: boolean;
+}
+/**
+ * @title: Pisell Row
+ * @description:  左中右布局组件
+ * @param {PisellRowProps} props
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2024-08-16 10:38
+ */
+declare const PisellRow: (props: PisellRowProps) => JSX.Element;
+export default PisellRow;

package/es/components/pisellSingleLineText/PisellSingleLineText.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { PisellSingleLineTextProps } from './types';
+import './PisellSingleLineText.less';
+/**
+ * PisellSingleLineText 单行文本组件
+ *
+ * 通用的单行文本输入/展示组件，支持只读、编辑、禁用三种状态。
+ * 基于 Ant Design Input 组件开发，提供完整的校验框架。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 受控模式
+ * const [value, setValue] = useState('');
+ * <PisellSingleLineText
+ *   value={value}
+ *   onChange={(v) => setValue(v)}
+ *   placeholder="请输入"
+ * />
+ *
+ * @example
+ * // 非受控模式
+ * <PisellSingleLineText
+ *   defaultValue="初始值"
+ *   required
+ *   minLength={3}
+ * />
+ *
+ * @example
+ * // 只读态
+ * <PisellSingleLineText
+ *   mode="read"
+ *   value="这是一段很长的文本内容"
+ *   ellipsis
+ *   showTooltip
+ * />
+ */
+export declare const PisellSingleLineText: React.FC<PisellSingleLineTextProps>;
+declare const _default: React.NamedExoticComponent<PisellSingleLineTextProps>;
+export default _default;

package/es/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/es/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/es/components/pisellSingleLineText/components/EditView.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { PisellSingleLineTextProps } from '../types';
+/**
+ * PisellSingleLineText 编辑态视图组件
+ *
+ * 负责渲染编辑态的输入框，基于 Ant Design Input 组件
+ *
+ * 功能：
+ * - 文本输入
+ * - 实时或失焦校验
+ * - 错误提示展示
+ * - 字数统计
+ * - 清空按钮
+ * - 前后缀、前后置标签
+ *
+ * @param props 组件 Props
+ */
+declare const EditView: React.FC<PisellSingleLineTextProps>;
+export default EditView;

package/es/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/es/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/es/components/pisellSingleLineText/types.d.ts

@@ -0,0 +1,139 @@
+import type { CSSProperties, ReactNode } from 'react';
+import type { BaseTextInputProps } from '@pisell/utils';
+/**
+ * PisellSingleLineText 组件 Props 类型定义
+ *
+ * 继承 BaseTextInputProps，添加单行文本特有的配置
+ */
+export interface PisellSingleLineTextProps extends BaseTextInputProps {
+    /**
+     * 状态模式
+     * @default 'edit'
+     */
+    mode?: 'read' | 'edit';
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 展示样式变体
+     * - text: 普通文本（默认）
+     * - link: 超链接样式
+     * - badge: 徽标样式
+     * - tag: 标签样式
+     * @default 'text'
+     */
+    displayVariant?: 'text' | 'link' | 'badge' | 'tag';
+    /**
+     * 超链接点击回调（displayVariant='link' 时有效）
+     */
+    onLinkClick?: () => void;
+    /**
+     * 徽标状态（displayVariant='badge' 时有效）
+     */
+    badgeStatus?: 'success' | 'processing' | 'default' | 'error' | 'warning';
+    /**
+     * 标签颜色（displayVariant='tag' 时有效）
+     */
+    tagColor?: string;
+    /**
+     * 标签是否可关闭（displayVariant='tag' 时有效）
+     */
+    tagClosable?: boolean;
+    /**
+     * 标签关闭回调（displayVariant='tag' 时有效）
+     */
+    onTagClose?: () => void;
+    /**
+     * 超出是否省略
+     * @default true
+     */
+    ellipsis?: boolean;
+    /**
+     * 悬停是否显示完整内容（Tooltip）
+     * @default true
+     */
+    showTooltip?: boolean;
+    /**
+     * 字号
+     * @example '14px' 或 14
+     */
+    fontSize?: string | number;
+    /**
+     * 字重
+     * @example 'bold' 或 600
+     */
+    fontWeight?: string | number;
+    /**
+     * 文本颜色
+     * @example '#000000'
+     */
+    color?: string;
+    /**
+     * 文本对齐方式
+     * @default 'left'
+     */
+    textAlign?: 'left' | 'center' | 'right';
+    /**
+     * 占位文本
+     */
+    placeholder?: string;
+    /**
+     * 最大长度（字符数）
+     */
+    maxLength?: number;
+    /**
+     * 是否显示字数统计
+     * @default false
+     */
+    showCount?: boolean;
+    /**
+     * 是否显示清空按钮
+     * @default false
+     */
+    allowClear?: boolean;
+    /**
+     * 是否自动聚焦
+     * @default false
+     */
+    autoFocus?: boolean;
+    /**
+     * 前缀图标或文本
+     */
+    prefix?: ReactNode;
+    /**
+     * 后缀图标或文本
+     */
+    suffix?: ReactNode;
+    /**
+     * 前置标签
+     */
+    addonBefore?: ReactNode;
+    /**
+     * 后置标签
+     */
+    addonAfter?: ReactNode;
+    /**
+     * 回车键回调
+     * @param value 当前值
+     */
+    onPressEnter?: (value: string) => void;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * ARIA 标签
+     */
+    'aria-label'?: string;
+    /**
+     * ARIA 描述
+     */
+    'aria-describedby'?: string;
+}
+export type { DisplayState, ValidationResult, TextInputState } from '@pisell/utils';

package/es/components/pisellSingleSelect/PisellSingleSelect.d.ts

@@ -0,0 +1,9 @@
+/**
+ * PisellSingleSelect - 单选下拉组件
+ * 基于 Ant Design Select 封装，提供符合 Pisell 设计规范的单选功能
+ */
+import React from 'react';
+import type { PisellSingleSelectProps, SingleSelectRef } from './types';
+import './PisellSingleSelect.less';
+declare const PisellSingleSelect: React.ForwardRefExoticComponent<PisellSingleSelectProps<string | number> & React.RefAttributes<SingleSelectRef<string | number>>>;
+export default PisellSingleSelect;