@pisell/materials 1.0.1054 → 1.0.1056

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

@@ -1,102 +0,0 @@
-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

@@ -1,16 +0,0 @@
-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/EditView.d.ts

@@ -1,19 +0,0 @@
-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/lib/components/pisellSingleLineText/components/ReadOnlyView.d.ts

@@ -1,20 +0,0 @@
-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

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

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

@@ -1,139 +0,0 @@
-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/lib/components/pisellSingleSelect/PisellSingleSelect.d.ts

@@ -1,9 +0,0 @@
-/**
- * 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;

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

@@ -1,66 +0,0 @@
-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

@@ -1,8 +0,0 @@
-/**
- * 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/components/EditView.d.ts

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

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

@@ -1,8 +0,0 @@
-/**
- * PisellSingleSelect - ReadOnlyView (只读态视图)
- * 只读状态下使用 Tag 展示选中值
- */
-import React from 'react';
-import type { ReadOnlyViewProps } from '../types';
-declare const ReadOnlyView: React.FC<ReadOnlyViewProps>;
-export default ReadOnlyView;

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

@@ -1,7 +0,0 @@
-/**
- * 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/pisellSingleSelect/types.d.ts

@@ -1,92 +0,0 @@
-import type { BaseSelectProps, SelectOption } from '@pisell/utils';
-/**
- * PisellSingleSelect 组件 Props 类型定义
- *
- * 继承 BaseSelectProps，添加单选特有的配置
- * @template T 选项值的类型，默认为 string | number
- */
-export interface PisellSingleSelectProps<T = string | number> extends BaseSelectProps<T> {
-    /**
-     * 受控模式：当前选中值
-     */
-    value?: T | null;
-    /**
-     * 非受控模式：默认选中值
-     */
-    defaultValue?: T;
-    /**
-     * 值变化回调
-     * @param value 新的选中值
-     * @param option 选中的选项对象（如果值为 null 则 option 也为 null）
-     */
-    onChange?: (value: T | null, option: SelectOption<T> | null) => void;
-    /**
-     * ARIA 标签
-     */
-    'aria-label'?: string;
-    /**
-     * ARIA 是否必填
-     */
-    'aria-required'?: boolean;
-    /**
-     * ARIA 是否无效
-     */
-    'aria-invalid'?: boolean;
-    /**
-     * ARIA 描述关联 ID
-     */
-    'aria-describedby'?: string;
-}
-/**
- * PisellSingleSelect 组件 Ref 方法
- * @template T 选项值的类型
- */
-export interface SingleSelectRef<T = string | number> {
-    /**
-     * 聚焦到组件
-     */
-    focus: () => void;
-    /**
-     * 失焦
-     */
-    blur: () => void;
-    /**
-     * 获取当前选中值
-     */
-    getValue: () => T | null;
-    /**
-     * 设置选中值
-     */
-    setValue: (value: T | null) => void;
-    /**
-     * 清空选中值
-     */
-    clearValue: () => void;
-}
-/**
- * EditView 组件 Props
- * @template T 选项值的类型
- */
-export interface EditViewProps<T = string | number> extends PisellSingleSelectProps<T> {
-    /**
-     * 内部状态管理对象（从 useSelectState Hook 传入）
-     */
-    state?: {
-        value: T | null | undefined;
-        setValue: (value: T | null) => void;
-        clearValue: () => void;
-    };
-}
-/**
- * DisabledView 组件 Props
- * @template T 选项值的类型
- */
-export interface DisabledViewProps<T = string | number> extends PisellSingleSelectProps<T> {
-}
-/**
- * ReadOnlyView 组件 Props
- * @template T 选项值的类型
- */
-export interface ReadOnlyViewProps<T = string | number> extends PisellSingleSelectProps<T> {
-}
-export type { SelectOption, FilterOptionFunc, SortDirection, SelectState, } from '@pisell/utils';

package/lib/components/pisellText/components/Amount/index.d.ts

@@ -1,20 +0,0 @@
-import React from 'react';
-import { PisellContextType } from '../../../pisell-config-provider/context';
-export interface AmountProps extends React.HTMLAttributes<HTMLSpanElement> {
-    /** 平台 */
-    platform?: PisellContextType['platform'];
-    /** 当前数值  */
-    value?: number | string;
-    /** 小数点后位数 默认是小数点后2位 */
-    precision?: number;
-    /** 显示货币符号 指的是 ¥$ 等货币符号等显隐，默认是展示 */
-    showCurrencySymbol?: boolean;
-    /** 千分位 指的是长金额的千分位逗号隔开，比如“123, 245, 315” 这种展现形式，默认是关闭 */
-    useThousandsSeparator?: boolean;
-    /** 整数位隐藏小数 指的是如果价格为整数，后面的".00" 将被省略以节省页面空间 */
-    hideDecimalForWholeNumbers?: boolean;
-    /** 货币符号 */
-    symbol?: string;
-}
-declare const Amount: (props: AmountProps) => JSX.Element;
-export default Amount;

package/lib/components/pisellText/components/Editable/index.d.ts

@@ -1,32 +0,0 @@
-import React from 'react';
-import './index.less';
-export declare type MultiLanguageValue = {
-    en: string;
-    'zh-CN': string;
-    'zh-HK': string;
-    'ja': string;
-    'pt': string;
-    original: string;
-};
-export interface EditableConfig {
-    /** 是否禁用编辑 */
-    disabled?: boolean;
-    /** 最大长度 */
-    maxLength?: number;
-    /** 编辑图标 */
-    icon?: React.ReactNode;
-}
-export interface EditableProps extends React.HTMLAttributes<HTMLSpanElement> {
-    /** 文本内容，支持字符串或多语言对象 */
-    value?: string | MultiLanguageValue;
-    /** 子节点内容，优先级高于 value */
-    children?: string;
-    /** 可编辑配置，boolean 时使用默认配置 */
-    editable?: boolean | EditableConfig;
-    /** 编辑变更回调 */
-    onChange?: (value: string | MultiLanguageValue) => void;
-    /** 输入框尺寸 */
-    size?: 'large' | 'middle' | 'small';
-}
-declare const Editable: React.FC<EditableProps>;
-export default Editable;

package/lib/components/pisellTimeRangeDisplay/PisellTimeRangeDisplay.d.ts

@@ -1,32 +0,0 @@
-import React from 'react';
-import 'dayjs/locale/zh-cn';
-import 'dayjs/locale/en';
-import type { PisellTimeRangeDisplayProps } from './types';
-import './PisellTimeRangeDisplay.less';
-/**
- * PisellTimeRangeDisplay 组件
- *
- * @description
- * 纯展示型时间区间组件，将 startAt / endAt 格式化为「时间区间 + 持续时间」。
- * - 同一天：HH:mm-HH:mm，可选显示日期/星期
- * - 跨天：起止日期时间
- * - 持续时间：d h m s 格式
- * - 字段顺序由 fieldOrder 控制，可将 duration 放在中间
- *
- * @example
- * <PisellTimeRangeDisplay
- *   startAt="2026-02-04 09:00"
- *   endAt="2026-02-04 18:00"
- * />
- * // => "09:00-18:00" + "9h"
- *
- * <PisellTimeRangeDisplay
- *   startAt={start}
- *   endAt={end}
- *   fields={{ fieldOrder: ['time', 'duration', 'date', 'weekday'] }}
- *   showDateForSameDay
- * />
- */
-export declare const PisellTimeRangeDisplay: React.FC<PisellTimeRangeDisplayProps>;
-declare const _default: React.NamedExoticComponent<PisellTimeRangeDisplayProps>;
-export default _default;

package/lib/components/pisellTimeRangeDisplay/PisellTimeRangeDisplay.stories.d.ts

@@ -1,61 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { PisellTimeRangeDisplay } from './PisellTimeRangeDisplay';
-/**
- * PisellTimeRangeDisplay 组件 Storybook
- * 用于时间区间 + 持续时长的展示（同一天 / 跨天）
- */
-declare const meta: Meta<typeof PisellTimeRangeDisplay>;
-export default meta;
-declare type Story = StoryObj<typeof PisellTimeRangeDisplay>;
-/**
- * 默认：同一天时间区间 + 持续时长
- */
-export declare const Default: Story;
-/**
- * 同一天 + 显示日期与星期
- */
-export declare const SameDayWithDate: Story;
-/**
- * 跨天时间区间
- */
-export declare const CrossDay: Story;
-/**
- * 跨年
- */
-export declare const CrossYear: Story;
-/**
- * 持续时间在中间（默认 fieldOrder）
- */
-export declare const DurationInMiddle: Story;
-/**
- * 持续时长在前
- */
-export declare const DurationFirst: Story;
-/**
- * 持续时长显示秒
- */
-export declare const DurationWithSeconds: Story;
-/**
- * 仅时间区间 + 持续时长（不显示日期星期）
- */
-export declare const TimeAndDurationOnly: Story;
-/**
- * 12 小时制
- */
-export declare const Time12Hour: Story;
-/**
- * 中文（日期 + 持续时长「天/时/分/秒」i18n）
- */
-export declare const LocaleZhCN: Story;
-/**
- * 英文（日期 + 持续时长 d/h/m/s）
- */
-export declare const LocaleEn: Story;
-/**
- * 小宽度：容器较窄时按块换行
- */
-export declare const NarrowWidth: Story;
-/**
- * 自定义容器样式
- */
-export declare const CustomContainerStyle: Story;

package/lib/components/pisellTimeRangeDisplay/components/DateBlock.d.ts

@@ -1,20 +0,0 @@
-import React from 'react';
-import { type Dayjs } from 'dayjs';
-import type { DateFormatConfig, TextStyleConfig } from '../types';
-export interface DateBlockProps {
-    /** 日期对象 */
-    date: Dayjs;
-    /** 日期格式配置（含 showRelativeDay：今天/昨天/明天） */
-    format?: DateFormatConfig;
-    /** 参考日期，用于相对日判定，默认 dayjs() */
-    referenceDate?: Dayjs;
-    /** 文本样式 */
-    style?: TextStyleConfig;
-    /** 自定义类名 */
-    className?: string;
-}
-/**
- * 日期展示块（复用 PisellDateTimeDisplay 的 formatDate 与相对日逻辑）
- */
-export declare const DateBlock: React.FC<DateBlockProps>;
-export default DateBlock;