@pisell/materials 6.11.14 → 6.11.16

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

@@ -1,147 +0,0 @@
-import type { CSSProperties, KeyboardEvent } from 'react';
-import type { BaseTextInputProps } from '@pisell/utils';
-/**
- * PisellLongText 组件 Props 类型定义
- *
- * 继承 BaseTextInputProps，添加长文本特有的配置
- */
-export interface PisellLongTextProps extends BaseTextInputProps {
-    /**
-     * 状态模式
-     * @default 'edit'
-     */
-    mode?: 'read' | 'edit';
-    /**
-     * 是否禁用
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * 编辑态默认显示行数
-     * @default 3
-     */
-    rows?: number;
-    /**
-     * 编辑态最小行数
-     */
-    minRows?: number;
-    /**
-     * 编辑态最大行数
-     */
-    maxRows?: number;
-    /**
-     * 自动高度调整
-     * @default false
-     * @example
-     * autoSize={true} // 自动调整
-     * autoSize={{ minRows: 3, maxRows: 10 }} // 指定范围
-     */
-    autoSize?: boolean | {
-        minRows?: number;
-        maxRows?: number;
-    };
-    /**
-     * 只读态最大显示行数（超出显示展开按钮）
-     * @default 3
-     */
-    maxLines?: number;
-    /**
-     * 是否启用展开功能（只读态）
-     * @default true
-     */
-    enableExpand?: boolean;
-    /**
-     * 展开按钮文案
-     * @default '展开'
-     */
-    expandText?: string;
-    /**
-     * 收起按钮文案
-     * @default '收起'
-     */
-    collapseText?: string;
-    /**
-     * 展开按钮位置
-     * @default 'bottom'
-     */
-    expandButtonPosition?: 'bottom' | 'inline';
-    /**
-     * 只读态是否显示字数统计
-     * @default false
-     */
-    showWordCount?: boolean;
-    /**
-     * 字号
-     * @example '14px' 或 14
-     * @default 16
-     */
-    fontSize?: string | number;
-    /**
-     * 字重
-     * @example 'bold' 或 600
-     * @default 500
-     */
-    fontWeight?: string | number;
-    /**
-     * 文本颜色
-     * @example '#000000'
-     * @default '#101828'
-     */
-    color?: string;
-    /**
-     * 行高
-     * @example '1.5' 或 1.5
-     * @default 1.5
-     */
-    lineHeight?: string | number;
-    /**
-     * 占位文本
-     */
-    placeholder?: string;
-    /**
-     * 最大长度（字符数）
-     */
-    maxLength?: number;
-    /**
-     * 是否显示字数统计（编辑态）
-     * @default false
-     */
-    showCount?: boolean;
-    /**
-     * 是否显示清空按钮
-     * @default false
-     */
-    allowClear?: boolean;
-    /**
-     * 是否自动聚焦
-     * @default false
-     */
-    autoFocus?: boolean;
-    /**
-     * 回车键回调（传递事件对象，支持判断 Ctrl+Enter）
-     * @param e 键盘事件对象
-     */
-    onPressEnter?: (e: KeyboardEvent<HTMLTextAreaElement>) => void;
-    /**
-     * 展开/收起回调
-     * @param expanded 是否已展开
-     */
-    onExpand?: (expanded: boolean) => void;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 自定义样式
-     */
-    style?: CSSProperties;
-    /**
-     * ARIA 标签
-     */
-    'aria-label'?: string;
-    /**
-     * ARIA 描述
-     */
-    'aria-describedby'?: string;
-}
-export type { DisplayState, ValidationResult, TextInputState } from '@pisell/utils';

package/es/components/pisellLookup/components/LookupTrigger.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-import type { LookupTriggerProps, LookupTriggerRef } from '../types';
-export declare const LookupTrigger: React.ForwardRefExoticComponent<LookupTriggerProps & React.RefAttributes<LookupTriggerRef>>;

package/es/components/pisellMetricCard/PisellMetricCard.d.ts

@@ -1,35 +0,0 @@
-import React from 'react';
-import type { PisellMetricCardProps } from './types';
-import './PisellMetricCard.less';
-/**
- * PisellMetricCard 指标卡片组件
- *
- * 用于展示单一核心指标的专业卡片组件
- * 支持标题、数值、环比、趋势箭头、标签等信息展示
- *
- * @example 基础用法
- * ```tsx
- * <PisellMetricCard
- *   title="Total Sales"
- *   value={1580}
- * />
- * ```
- *
- * @example 使用对象配置
- * ```tsx
- * <PisellMetricCard
- *   title="Revenue"
- *   value={1580}
- *   format={{
- *     showCurrencySymbol: true,
- *     currencySymbol: '$',
- *     useGrouping: true
- *   }}
- *   comparison={{
- *     value: 120
- *   }}
- * />
- * ```
- */
-declare const PisellMetricCard: React.FC<PisellMetricCardProps>;
-export default PisellMetricCard;

package/es/components/pisellMetricCard/PisellMetricCard.stories.d.ts

@@ -1,17 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import PisellMetricCard from './PisellMetricCard';
-declare const meta: Meta<typeof PisellMetricCard>;
-export default meta;
-declare type Story = StoryObj<typeof PisellMetricCard>;
-export declare const Basic: Story;
-export declare const WithCurrency: Story;
-export declare const PositiveTrend: Story;
-export declare const NegativeTrend: Story;
-export declare const WithGrouping: Story;
-export declare const WithPrecision: Story;
-export declare const Complete: Story;
-export declare const WithTag: Story;
-export declare const CustomStyle: Story;
-export declare const Loading: Story;
-export declare const EmptyValue: Story;
-export declare const MultipleCards: Story;

package/es/components/pisellMetricCard/components/MetricComparison.d.ts

@@ -1,14 +0,0 @@
-import React from 'react';
-import type { MetricComparisonProps } from '../types';
-/**
- * MetricComparison 环比信息组件
- *
- * 负责渲染环比数值和趋势箭头
- * - 自动根据正负值显示不同颜色
- * - 支持格式化环比数值
- * - 集成趋势箭头组件
- *
- * @param props 组件属性
- */
-declare const MetricComparison: React.FC<MetricComparisonProps>;
-export default MetricComparison;

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

@@ -1,7 +0,0 @@
-/**
- * 子组件导出
- */
-export { default as TrendIcon } from './TrendIcon';
-export { default as MetricValue } from './MetricValue';
-export { default as MetricTitle } from './MetricTitle';
-export { default as MetricComparison } from './MetricComparison';

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

@@ -1,6 +0,0 @@
-/**
- * PisellMetricCard 组件导出
- */
-export { default as PisellMetricCard } from './PisellMetricCard';
-export type { PisellMetricCardProps, TrendType, FormatOptions, MetricTitleProps, MetricValueProps, MetricComparisonProps, TrendIconProps, } from './types';
-export { default } from './PisellMetricCard';

package/es/components/pisellMetricCard/utils/formatMetricValue.d.ts

@@ -1,34 +0,0 @@
-import type { FormatOptions } from '../types';
-/**
- * 格式化指标数值
- *
- * 支持以下格式化选项：
- * - 小数精度控制
- * - 千分位分隔符
- * - 货币符号显示
- * - 自定义格式化函数
- * - 整数时隐藏小数部分
- *
- * @param value 数值
- * @param options 格式化选项
- * @returns 格式化后的字符串，null 时返回 null
- *
- * @example
- * formatMetricValue(1234.56, { precision: 2, useGrouping: true })
- * // 返回: "1,234.56"
- *
- * @example
- * formatMetricValue(1580, {
- *   showCurrencySymbol: true,
- *   currencySymbol: '$'
- * })
- * // 返回: "$1580"
- *
- * @example
- * formatMetricValue(100.00, {
- *   precision: 2,
- *   hideDecimalForWholeNumbers: true
- * })
- * // 返回: "100"
- */
-export declare function formatMetricValue(value: number | string | null | undefined, options?: FormatOptions): string | null;

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

@@ -1,5 +0,0 @@
-/**
- * 工具函数导出
- */
-export { formatMetricValue } from './formatMetricValue';
-export { calculateTrend } from './calculateTrend';

package/es/components/pisellMultipleSelect/PisellMultipleSelect.d.ts

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

package/es/components/pisellMultipleSelect/PisellMultipleSelect.stories.d.ts

@@ -1,70 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import PisellMultipleSelect from './PisellMultipleSelect';
-/**
- * PisellMultipleSelect 组件 Storybook
- *
- * 用于展示和测试组件的各种状态和配置
- */
-declare const meta: Meta<typeof PisellMultipleSelect>;
-export default meta;
-declare type Story = StoryObj<typeof PisellMultipleSelect>;
-/**
- * 基础示例
- */
-export declare const Basic: Story;
-/**
- * 带标签
- */
-export declare const WithLabel: Story;
-/**
- * 标签聚合功能
- */
-export declare const TagAggregation: Story;
-/**
- * 最大可选数量限制
- */
-export declare const WithMaxCount: Story;
-/**
- * 带搜索功能
- */
-export declare const WithSearch: Story;
-/**
- * 带清空按钮
- */
-export declare const WithClear: Story;
-/**
- * 禁用态
- */
-export declare const Disabled: Story;
-/**
- * 只读态
- */
-export declare const ReadOnly: Story;
-/**
- * 只读态 - 标签聚合
- */
-export declare const ReadOnlyWithAggregation: Story;
-/**
- * 只读态 - 空值
- */
-export declare const ReadOnlyEmpty: Story;
-/**
- * 错误状态
- */
-export declare const WithError: Story;
-/**
- * 不同尺寸
- */
-export declare const Sizes: Story;
-/**
- * 表单场景
- */
-export declare const InForm: Story;
-/**
- * 回调事件演示
- */
-export declare const WithCallbacks: Story;
-/**
- * 所有状态组合
- */
-export declare const AllStates: Story;

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

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

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

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

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

@@ -1,7 +0,0 @@
-/**
- * PisellMultipleSelect 组件导出
- */
-import PisellMultipleSelect from './PisellMultipleSelect';
-export { PisellMultipleSelect };
-export type { PisellMultipleSelectProps, MultipleSelectRef, EditViewProps, DisabledViewProps, ReadOnlyViewProps, TagRendererProps, } from './types';
-export type { SelectOption, FilterOptionFunc, SortDirection, MultipleSelectState, TagDisplayInfo, } from './types';

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

@@ -1,160 +0,0 @@
-import type { BaseSelectProps, SelectOption } from '@pisell/utils';
-/**
- * PisellMultipleSelect 组件 Props 类型定义
- *
- * 继承 BaseSelectProps，添加多选特有的配置
- * @template T 选项值的类型，默认为 string | number
- */
-export interface PisellMultipleSelectProps<T = string | number> extends BaseSelectProps<T> {
-    /**
-     * 受控模式：当前选中值数组
-     */
-    value?: T[];
-    /**
-     * 非受控模式：默认选中值数组
-     */
-    defaultValue?: T[];
-    /**
-     * 值变化回调
-     * @param value 新的选中值数组
-     * @param options 选中的选项对象数组
-     */
-    onChange?: (value: T[], options: SelectOption<T>[]) => void;
-    /**
-     * 最多显示的标签数量
-     * 超出部分会显示 "+N" 聚合标签
-     * @default 3
-     */
-    maxTagCount?: number;
-    /**
-     * 超出标签 hover 时是否显示 Tooltip
-     * @default true
-     */
-    showTooltipOnOverflow?: boolean;
-    /**
-     * 最大可选数量
-     * 达到上限时阻止继续选择
-     * @default undefined（无限制）
-     */
-    maxCount?: number;
-    /**
-     * 取消选中某项时触发
-     * @param value 被取消选中的值
-     * @param option 被取消选中的选项对象
-     */
-    onDeselect?: (value: T, option: SelectOption<T>) => void;
-    /**
-     * ARIA 标签
-     */
-    'aria-label'?: string;
-    /**
-     * ARIA 是否必填
-     */
-    'aria-required'?: boolean;
-    /**
-     * ARIA 是否无效
-     */
-    'aria-invalid'?: boolean;
-    /**
-     * ARIA 描述关联 ID
-     */
-    'aria-describedby'?: string;
-    /**
-     * ARIA 多选标识
-     * @default true
-     */
-    'aria-multiselectable'?: boolean;
-}
-/**
- * PisellMultipleSelect 组件 Ref 方法
- * @template T 选项值的类型
- */
-export interface MultipleSelectRef<T = string | number> {
-    /**
-     * 聚焦到组件
-     */
-    focus: () => void;
-    /**
-     * 失焦
-     */
-    blur: () => void;
-    /**
-     * 获取当前选中值数组
-     */
-    getValue: () => T[];
-    /**
-     * 设置选中值数组
-     */
-    setValue: (value: T[]) => void;
-    /**
-     * 清空所有选中值
-     */
-    clearValue: () => void;
-    /**
-     * 添加一个选中值
-     */
-    addValue: (value: T) => void;
-    /**
-     * 移除一个选中值
-     */
-    removeValue: (value: T) => void;
-}
-/**
- * EditView 组件 Props
- * @template T 选项值的类型
- */
-export interface EditViewProps<T = string | number> extends PisellMultipleSelectProps<T> {
-    /**
-     * 内部状态管理对象（从 useSelectState Hook 传入）
-     */
-    state?: {
-        value: T[];
-        setValue: (value: T[]) => void;
-        addValue: (value: T) => void;
-        removeValue: (value: T) => void;
-        clearValue: () => void;
-    };
-    /**
-     * 内部 onChange 处理（包含 maxCount 限制等逻辑）
-     */
-    onChangeInternal?: (value: T[]) => void;
-}
-/**
- * DisabledView 组件 Props
- * @template T 选项值的类型
- */
-export interface DisabledViewProps<T = string | number> extends PisellMultipleSelectProps<T> {
-}
-/**
- * ReadOnlyView 组件 Props
- * @template T 选项值的类型
- */
-export interface ReadOnlyViewProps<T = string | number> extends PisellMultipleSelectProps<T> {
-}
-/**
- * TagRenderer 组件 Props（可选，用于自定义标签渲染）
- * @template T 选项值的类型
- */
-export interface TagRendererProps<T = string | number> {
-    /**
-     * 当前选中值数组
-     */
-    value: T[];
-    /**
-     * 所有选项列表
-     */
-    options: SelectOption<T>[];
-    /**
-     * 最多显示的标签数量
-     */
-    maxTagCount: number;
-    /**
-     * 是否显示 Tooltip
-     */
-    showTooltip: boolean;
-    /**
-     * 移除标签回调
-     */
-    onRemove?: (value: T) => void;
-}
-export type { SelectOption, FilterOptionFunc, SortDirection, MultipleSelectState, TagDisplayInfo, } from '@pisell/utils';

package/es/components/pisellNumber/PisellNumber.d.ts

@@ -1,42 +0,0 @@
-import React from 'react';
-import type { PisellNumberProps } from './types';
-import './PisellNumber.less';
-/**
- * PisellNumber 数值组件
- *
- * 通用的数值输入/展示组件，支持只读、编辑、禁用三种状态。
- * 基于 Ant Design InputNumber 组件开发，提供完整的校验框架。
- *
- * @param props 组件 Props
- *
- * @example
- * // 受控模式
- * const [value, setValue] = useState(0);
- * <PisellNumber
- *   value={value}
- *   onChange={setValue}
- *   min={0}
- *   max={100}
- * />
- *
- * @example
- * // 非受控模式
- * <PisellNumber
- *   defaultValue={10}
- *   min={0}
- *   max={999}
- *   step={10}
- * />
- *
- * @example
- * // 只读态
- * <PisellNumber
- *   mode="read"
- *   value={1234.567}
- *   precision={2}
- *   useGrouping
- * />
- */
-export declare const PisellNumber: React.FC<PisellNumberProps>;
-declare const MemoizedPisellNumber: React.NamedExoticComponent<PisellNumberProps>;
-export default MemoizedPisellNumber;

package/es/components/pisellNumber/PisellNumber.stories.d.ts

@@ -1,66 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { PisellNumber } from './PisellNumber';
-/**
- * PisellNumber 组件 Storybook
- *
- * 用于展示和测试组件的各种状态和配置
- */
-declare const meta: Meta<typeof PisellNumber>;
-export default meta;
-declare type Story = StoryObj<typeof PisellNumber>;
-/**
- * 基础示例 - 编辑态
- */
-export declare const Basic: Story;
-/**
- * 只读态展示
- */
-export declare const ReadOnly: Story;
-/**
- * 禁用态
- */
-export declare const Disabled: Story;
-/**
- * 带范围限制
- */
-export declare const WithRange: Story;
-/**
- * 带精度控制
- */
-export declare const WithPrecision: Story;
-/**
- * 千分位分隔符
- */
-export declare const WithGrouping: Story;
-/**
- * 带前后缀
- */
-export declare const WithAddon: Story;
-/**
- * 带校验 - 必填
- */
-export declare const WithValidationRequired: Story;
-/**
- * 带校验 - 范围校验
- */
-export declare const WithValidationRange: Story;
-/**
- * 带校验 - 自定义校验
- */
-export declare const WithCustomValidation: Story;
-/**
- * 不同尺寸
- */
-export declare const Sizes: Story;
-/**
- * 只读态样式配置
- */
-export declare const ReadOnlyStyles: Story;
-/**
- * 表单场景
- */
-export declare const InForm: Story;
-/**
- * 空值处理
- */
-export declare const EmptyValue: Story;

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

@@ -1,11 +0,0 @@
-import React from 'react';
-import type { PisellNumberProps } from '../types';
-/**
- * PisellNumber 禁用态视图组件
- *
- * 负责渲染禁用态的输入框
- *
- * @param props 组件 Props
- */
-declare const DisabledView: React.FC<PisellNumberProps>;
-export default DisabledView;