@pisell/materials 6.11.2 → 6.11.3

package/lib/components/pisellLongText/PisellLongText.stories.d.ts

@@ -1,123 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { PisellLongText } from './PisellLongText';
-/**
- * PisellLongText 是一个多行文本输入/展示组件。
- *
- * ## 功能特性
- * - 支持三种状态：只读、编辑、禁用
- * - 展开/折叠功能（只读态）
- * - 自动高度调整
- * - 完整的校验框架
- * - 字数统计
- */
-declare const meta: Meta<typeof PisellLongText>;
-export default meta;
-declare type Story = StoryObj<typeof PisellLongText>;
-/**
- * 基础编辑态示例
- */
-export declare const Basic: Story;
-/**
- * 只读态示例 - 短文本
- */
-export declare const ReadMode: Story;
-/**
- * 只读态 - 展开/折叠功能（核心）
- */
-export declare const ReadModeExpandCollapse: Story;
-/**
- * 只读态 - 自定义展开/收起文案
- */
-export declare const ReadModeCustomExpandText: Story;
-/**
- * 只读态 - 禁用展开功能
- */
-export declare const ReadModeDisableExpand: Story;
-/**
- * 只读态 - 字数统计
- */
-export declare const ReadModeWithWordCount: Story;
-/**
- * 只读态 - 展开 + 字数统计
- */
-export declare const ReadModeExpandAndWordCount: Story;
-/**
- * 禁用态示例
- */
-export declare const Disabled: Story;
-/**
- * 编辑态 - 默认行数
- */
-export declare const EditModeCustomRows: Story;
-/**
- * 编辑态 - 自动高度（boolean）
- */
-export declare const EditModeAutoSize: Story;
-/**
- * 编辑态 - 自动高度（范围限定）
- */
-export declare const EditModeAutoSizeRange: Story;
-/**
- * 编辑态 - minRows 和 maxRows
- */
-export declare const EditModeMinMaxRows: Story;
-/**
- * 编辑态 - 字数统计
- */
-export declare const EditModeWithCount: Story;
-/**
- * 编辑态 - 清空按钮
- */
-export declare const EditModeWithClear: Story;
-/**
- * 必填校验
- */
-export declare const Required: Story;
-/**
- * 长度校验
- */
-export declare const LengthValidation: Story;
-/**
- * 自定义校验 - 段落数量限制
- */
-export declare const CustomValidatorParagraphs: Story;
-/**
- * 组合校验
- */
-export declare const CombinedValidation: Story;
-/**
- * 自动高度 + 字数统计
- */
-export declare const AutoSizeWithCount: Story;
-/**
- * 保留换行和空格
- */
-export declare const PreserveWhitespace: Story;
-/**
- * 自定义样式（只读态）
- */
-export declare const CustomStyle: Story;
-/**
- * 完整功能示例
- */
-export declare const FullFeatures: Story;
-/**
- * 所有展开/折叠场景对比
- */
-export declare const AllExpandScenarios: Story;
-/**
- * 所有自动高度场景对比
- */
-export declare const AllAutoSizeScenarios: Story;
-/**
- * 校验场景对比
- */
-export declare const ValidationScenarios: Story;
-/**
- * 边界情况测试
- */
-export declare const EdgeCases: Story;
-/**
- * 完整功能演示
- */
-export declare const CompleteExample: Story;

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

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

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

@@ -1,18 +0,0 @@
-import React from 'react';
-import type { PisellLongTextProps } from '../types';
-/**
- * PisellLongText 只读态视图组件
- *
- * 负责渲染只读态的多行文本展示，支持展开/折叠功能
- *
- * 功能：
- * - 多行文本展示
- * - 根据 maxLines 截断内容
- * - 展开/收起按钮（超出行数时显示）
- * - 字数统计（可选）
- * - 保留换行和空格（whiteSpace: 'pre-wrap'）
- *
- * @param props 组件 Props
- */
-declare const ReadOnlyView: React.FC<PisellLongTextProps>;
-export default ReadOnlyView;

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

@@ -1,6 +0,0 @@
-/**
- * PisellLongText 组件导出
- */
-export { default as PisellLongText } from './PisellLongText';
-export type { PisellLongTextProps } from './types';
-export type { DisplayState, ValidationResult, TextInputState } from './types';

package/lib/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/lib/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/lib/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/lib/components/pisellMetricCard/components/MetricTitle.d.ts

@@ -1,12 +0,0 @@
-import React from 'react';
-import type { MetricTitleProps } from '../types';
-/**
- * MetricTitle 标题组件
- *
- * 负责渲染标题、副标题和提示信息
- * 支持自定义字号、字重、颜色等样式
- *
- * @param props 组件属性
- */
-declare const MetricTitle: React.FC<MetricTitleProps>;
-export default MetricTitle;

package/lib/components/pisellMetricCard/components/MetricValue.d.ts

@@ -1,12 +0,0 @@
-import React from 'react';
-import type { MetricValueProps } from '../types';
-/**
- * MetricValue 数值展示组件
- *
- * 负责渲染格式化后的主数值
- * 支持自定义字号、字重、颜色等样式
- *
- * @param props 组件属性
- */
-declare const MetricValue: React.FC<MetricValueProps>;
-export default MetricValue;

package/lib/components/pisellMetricCard/components/TrendIcon.d.ts

@@ -1,14 +0,0 @@
-import React from 'react';
-import type { TrendIconProps } from '../types';
-/**
- * TrendIcon 趋势箭头组件
- *
- * 根据趋势类型显示上升或下降箭头
- * - up: 显示上升箭头 ↑
- * - down: 显示下降箭头 ↓
- * - neutral: 不显示箭头
- *
- * @param props 组件属性
- */
-declare const TrendIcon: React.FC<TrendIconProps>;
-export default TrendIcon;

package/lib/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/lib/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/lib/components/pisellMetricCard/types.d.ts

@@ -1,201 +0,0 @@
-import type { CSSProperties, ReactNode } from 'react';
-/**
- * 趋势类型
- */
-export declare type TrendType = 'up' | 'down' | 'neutral';
-/**
- * 数值格式化配置
- */
-export interface ValueFormatConfig {
-    /** 小数精度（小数位数），默认 0 */
-    precision?: number;
-    /** 是否使用千分位分隔符，默认 false */
-    useGrouping?: boolean;
-    /** 是否显示货币符号，默认 false */
-    showCurrencySymbol?: boolean;
-    /** 货币符号（如 $, ¥），默认 '' */
-    currencySymbol?: string;
-    /** 自定义格式化函数 */
-    formatter?: (value: number | null) => string;
-    /** 整数时隐藏小数部分，默认 true */
-    hideDecimalForWholeNumbers?: boolean;
-}
-/**
- * 环比配置
- */
-export interface ComparisonConfig {
-    /** 环比数值（支持正负值） */
-    value: number | string | null;
-    /** 环比前缀文本，默认 'v.s. pre' */
-    text?: string;
-    /** 是否显示趋势箭头，默认 true */
-    showTrendIcon?: boolean;
-    /** 正向趋势颜色，默认 '#52c41a' */
-    positiveColor?: string;
-    /** 负向趋势颜色，默认 '#ff4d4f' */
-    negativeColor?: string;
-    /** 环比字号，默认 14 */
-    size?: number | string;
-}
-/**
- * 样式配置
- */
-export interface MetricCardStyleConfig {
-    /** 卡片容器样式 */
-    card?: {
-        /** 是否显示边框，默认 true */
-        bordered?: boolean;
-        /** 圆角大小（px），默认 12 */
-        borderRadius?: number;
-        /** 内边距（px），默认 16 */
-        padding?: number;
-        /** 阴影效果，默认 true */
-        shadow?: boolean | string;
-        /** 背景色，默认 '#ffffff' */
-        background?: string;
-        /** 卡片宽度，默认 'auto' */
-        width?: string | number;
-    };
-    /** 标题样式 */
-    title?: {
-        /** 字号，默认 14 */
-        size?: number | string;
-        /** 字重，默认 400 */
-        weight?: number | string;
-        /** 颜色，默认 'rgba(0, 0, 0, 0.45)' */
-        color?: string;
-    };
-    /** 数值样式 */
-    value?: {
-        /** 字号，默认 30 */
-        size?: number | string;
-        /** 字重，默认 600 */
-        weight?: number | string;
-        /** 颜色，默认 'rgba(0, 0, 0, 0.85)' */
-        color?: string;
-    };
-}
-/**
- * PisellMetricCard 组件 Props
- *
- * 采用扁平 + 对象组合的设计，降低复杂度和耦合
- *
- * @example 基础用法
- * ```tsx
- * <PisellMetricCard
- *   title="Total Sales"
- *   value={1580}
- * />
- * ```
- *
- * @example 带格式化和环比
- * ```tsx
- * <PisellMetricCard
- *   title="Revenue"
- *   value={1580}
- *   format={{
- *     showCurrencySymbol: true,
- *     currencySymbol: '$',
- *     useGrouping: true
- *   }}
- *   comparison={{
- *     value: 120,
- *     text: 'v.s. last month'
- *   }}
- * />
- * ```
- */
-export interface PisellMetricCardProps {
-    /** 标题文本 */
-    title: string | ReactNode;
-    /** 主数值 */
-    value: number | string | null;
-    /** 副标题文本（可选） */
-    subtitle?: string | ReactNode;
-    /** 标签内容（可选） */
-    tag?: ReactNode;
-    /** 提示信息内容（可选） */
-    tooltip?: string | ReactNode;
-    /**
-     * 数值格式化配置
-     * @example format={{ precision: 2, useGrouping: true, currencySymbol: '$' }}
-     */
-    format?: ValueFormatConfig;
-    /**
-     * 环比配置
-     * @example comparison={{ value: 120, text: 'v.s. pre' }}
-     */
-    comparison?: ComparisonConfig;
-    /**
-     * 样式配置
-     * @example
-     * styleConfig={{
-     *   card: { borderRadius: 8, padding: 24 },
-     *   title: { size: 16, weight: 600 },
-     *   value: { size: 36, color: '#1890ff' }
-     * }}
-     */
-    styleConfig?: MetricCardStyleConfig;
-    /** 是否显示副标题，默认 false */
-    showSubtitle?: boolean;
-    /** 是否显示标签，默认 false */
-    showTag?: boolean;
-    /** 是否显示提示信息，默认 false */
-    showTooltip?: boolean;
-    /** 是否显示加载状态，默认 false */
-    loading?: boolean;
-    /** 鼠标悬停是否有交互效果，默认 true */
-    hoverable?: boolean;
-    /** 自定义类名 */
-    className?: string;
-    /** 自定义样式 */
-    style?: CSSProperties;
-    /** 点击卡片回调 */
-    onClick?: () => void;
-}
-/**
- * FormatOptions (别名，用于导出)
- */
-export interface FormatOptions extends ValueFormatConfig {
-}
-/**
- * MetricTitle 组件 Props
- */
-export interface MetricTitleProps {
-    title: string | ReactNode;
-    subtitle?: string | ReactNode;
-    tooltip?: string | ReactNode;
-    titleSize?: number | string;
-    titleWeight?: number | string;
-    titleColor?: string;
-}
-/**
- * MetricValue 组件 Props
- */
-export interface MetricValueProps {
-    value: string | null;
-    valueSize?: number | string;
-    valueWeight?: number | string;
-    valueColor?: string;
-}
-/**
- * MetricComparison 组件 Props
- */
-export interface MetricComparisonProps {
-    comparison: number | string | null;
-    comparisonText?: string;
-    showTrendIcon?: boolean;
-    positiveColor?: string;
-    negativeColor?: string;
-    comparisonSize?: number | string;
-    precision?: number;
-    showCurrencySymbol?: boolean;
-    currencySymbol?: string;
-}
-/**
- * TrendIcon 组件 Props
- */
-export interface TrendIconProps {
-    trend: TrendType;
-    color?: string;
-}

package/lib/components/pisellMetricCard/utils/calculateTrend.d.ts

@@ -1,14 +0,0 @@
-import type { TrendType } from '../types';
-/**
- * 计算趋势方向
- *
- * @param comparison 环比数值
- * @returns 'up' | 'down' | 'neutral'
- *
- * @example
- * calculateTrend(120) // 'up'
- * calculateTrend(-230) // 'down'
- * calculateTrend(0) // 'neutral'
- * calculateTrend(null) // 'neutral'
- */
-export declare function calculateTrend(comparison: number | string | null | undefined): TrendType;

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

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

package/lib/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/lib/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/lib/components/pisellMultipleSelect/index.d.ts

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

package/lib/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/lib/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;

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

@@ -1,6 +0,0 @@
-/**
- * PisellNumber 子组件导出
- */
-export { default as ReadOnlyView } from './ReadOnlyView';
-export { default as EditView } from './EditView';
-export { default as DisabledView } from './DisabledView';