@pisell/materials 6.11.49 → 6.11.50

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

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

package/es/components/pisellSort/type.d.ts

@@ -1,7 +0,0 @@
-import { SortListProps } from '../sort/types';
-import { FormInstance } from 'antd';
-export declare type PisellSortProps = SortListProps & {
-    name?: string;
-} & FormInstance & {
-    hasForm?: boolean;
-};

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

package/es/components/pisellTimeRangeDisplay/components/DurationBlock.d.ts

@@ -1,19 +0,0 @@
-import React from 'react';
-import type { TextStyleConfig } from '../types';
-export interface DurationBlockProps {
-    /** 持续时间（毫秒） */
-    durationMs: number;
-    /** 是否显示秒 */
-    showSeconds?: boolean;
-    /** 语言代码，zh 时使用「天/时/分/秒」 */
-    locale?: string;
-    /** 文本样式 */
-    style?: TextStyleConfig;
-    /** 自定义类名 */
-    className?: string;
-}
-/**
- * 持续时长展示块（d h m s 或 天/时/分/秒，按 locale i18n）
- */
-export declare const DurationBlock: React.FC<DurationBlockProps>;
-export default DurationBlock;

package/es/components/pisellTimeRangeDisplay/components/TimeRangeBlock.d.ts

@@ -1,30 +0,0 @@
-import React from 'react';
-import { type Dayjs } from 'dayjs';
-import type { TimeFormatConfig, DateFormatConfig, WeekdayFormatConfig, TextStyleConfig } from '../types';
-export interface TimeRangeBlockProps {
-    /** 开始时间 */
-    start: Dayjs;
-    /** 结束时间 */
-    end: Dayjs;
-    /** 是否同一天 */
-    isSameDay: boolean;
-    /** 时间格式配置 */
-    timeFormat?: TimeFormatConfig;
-    /** 日期格式配置（跨天时用于起止日期，含 showRelativeDay） */
-    dateFormat?: DateFormatConfig;
-    /** 星期格式配置（跨天时用于「Sat, 22 Jan」） */
-    weekdayFormat?: WeekdayFormatConfig;
-    /** 参考日期，用于相对日判定，默认 dayjs() */
-    referenceDate?: Dayjs;
-    /** 文本样式 */
-    style?: TextStyleConfig;
-    /** 自定义类名 */
-    className?: string;
-}
-/**
- * 时间区间展示块
- * - 同一天：HH:mm-HH:mm
- * - 跨天：起止完整日期时间；若某端为相对日（今天/昨天/明天）则只显示「时间 相对日」，不显示星期+日期
- */
-export declare const TimeRangeBlock: React.FC<TimeRangeBlockProps>;
-export default TimeRangeBlock;

package/es/components/pisellTimeRangeDisplay/components/WeekdayBlock.d.ts

@@ -1,18 +0,0 @@
-import React from 'react';
-import type { Dayjs } from 'dayjs';
-import type { WeekdayFormatConfig, TextStyleConfig } from '../types';
-export interface WeekdayBlockProps {
-    /** 日期对象（用于获取星期） */
-    weekday: Dayjs;
-    /** 星期格式配置 */
-    format?: WeekdayFormatConfig;
-    /** 文本样式 */
-    style?: TextStyleConfig;
-    /** 自定义类名 */
-    className?: string;
-}
-/**
- * 星期展示块（复用 PisellDateTimeDisplay 的 formatWeekday）
- */
-export declare const WeekdayBlock: React.FC<WeekdayBlockProps>;
-export default WeekdayBlock;

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

@@ -1,8 +0,0 @@
-export { TimeRangeBlock } from './TimeRangeBlock';
-export { DateBlock } from './DateBlock';
-export { WeekdayBlock } from './WeekdayBlock';
-export { DurationBlock } from './DurationBlock';
-export type { TimeRangeBlockProps } from './TimeRangeBlock';
-export type { DateBlockProps } from './DateBlock';
-export type { WeekdayBlockProps } from './WeekdayBlock';
-export type { DurationBlockProps } from './DurationBlock';

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

@@ -1,3 +0,0 @@
-export { PisellTimeRangeDisplay, default } from './PisellTimeRangeDisplay';
-export type { PisellTimeRangeDisplayProps, LayoutDirection, TimeRangeFieldType, TimeRangeFieldConfig, DurationFormatConfig, DayjsLike, } from './types';
-export type { TimeFormatConfig, DateFormatConfig, WeekdayFormatConfig, ContainerStyleConfig, TextStyleConfig, TextAlign, } from './types';

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

@@ -1,137 +0,0 @@
-import type { CSSProperties } from 'react';
-import type { Dayjs } from 'dayjs';
-import type { TimeFormatConfig, DateFormatConfig, WeekdayFormatConfig, ContainerStyleConfig, TextStyleConfig, TextAlign } from '../pisellDateTimeDisplay/types';
-export type { TimeFormatConfig, DateFormatConfig, WeekdayFormatConfig, ContainerStyleConfig, TextStyleConfig, TextAlign, };
-/**
- * 字段类型（时间区间、日期、星期、持续时长）
- * - time: 时间区间块（HH:mm-HH:mm 或跨天起止）
- * - date: 日期块
- * - weekday: 星期块
- * - duration: 持续时长块
- */
-export declare type TimeRangeFieldType = 'time' | 'date' | 'weekday' | 'duration';
-/**
- * 持续时长格式配置
- */
-export interface DurationFormatConfig {
-    /**
-     * 是否显示秒
-     * @default false
-     * @example true -> "2h30m23s" | false -> "2h30m"
-     */
-    showSeconds?: boolean;
-}
-/**
- * 字段配置
- */
-export interface TimeRangeFieldConfig {
-    /**
-     * 是否显示时间区间块
-     * @default true
-     */
-    showTimeRange?: boolean;
-    /**
-     * 是否显示日期块
-     * @default true
-     */
-    showDate?: boolean;
-    /**
-     * 是否显示星期块
-     * @default true
-     */
-    showWeekday?: boolean;
-    /**
-     * 是否显示持续时长块
-     * @default true
-     */
-    showDuration?: boolean;
-    /**
-     * 字段顺序（四类块可任意排序；默认 时间 日期 星期 持续时长，可实现「持续时间在前」等）
-     * @default ['weekday', 'date', 'time', 'duration'] 换行顺序：先持续时间 → 结束时间（跨天）→ 开始/结束时间与日期 → 星期
-     */
-    fieldOrder?: TimeRangeFieldType[];
-}
-/**
- * startAt / endAt 的 dayjs 兼容值
- */
-export declare type DayjsLike = Dayjs | string | number;
-/**
- * PisellTimeRangeDisplay 组件 Props
- */
-export interface PisellTimeRangeDisplayProps {
-    /**
-     * 开始时间（dayjs 兼容值）
-     */
-    startAt: DayjsLike;
-    /**
-     * 结束时间（dayjs 兼容值）
-     */
-    endAt: DayjsLike;
-    /**
-     * 文本对齐方式（单行/多行均生效）
-     * @default 'center'
-     */
-    textAlign?: TextAlign;
-    /**
-     * 字段显示与排序配置
-     */
-    fields?: TimeRangeFieldConfig;
-    /**
-     * 同一天时是否显示具体日期
-     * @default true
-     */
-    showDateForSameDay?: boolean;
-    /**
-     * 时间格式配置（复用 PisellDateTimeDisplay）
-     */
-    timeFormat?: TimeFormatConfig;
-    /**
-     * 日期格式配置（复用 PisellDateTimeDisplay）
-     */
-    dateFormat?: DateFormatConfig;
-    /**
-     * 星期格式配置（复用 PisellDateTimeDisplay）
-     */
-    weekdayFormat?: WeekdayFormatConfig;
-    /**
-     * 持续时长格式配置
-     */
-    durationFormat?: DurationFormatConfig;
-    /**
-     * 容器样式
-     */
-    containerStyle?: ContainerStyleConfig;
-    /**
-     * 时间区间文本样式
-     */
-    timeStyle?: TextStyleConfig;
-    /**
-     * 日期文本样式
-     */
-    dateStyle?: TextStyleConfig;
-    /**
-     * 星期文本样式
-     */
-    weekdayStyle?: TextStyleConfig;
-    /**
-     * 持续时长文本样式
-     */
-    durationStyle?: TextStyleConfig;
-    /**
-     * dayjs locale（语言代码）
-     * @default 优先使用全局配置，其次浏览器语言
-     */
-    locale?: string;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 自定义样式
-     */
-    style?: CSSProperties;
-    /**
-     * 点击回调
-     */
-    onClick?: () => void;
-}

package/es/components/pisellTimeRangeDisplay/utils/formatDuration.d.ts

@@ -1,14 +0,0 @@
-/**
- * 将毫秒数格式化为持续时间字符串（d h m s 或 天/时/分/秒）
- *
- * @param ms 持续时间（毫秒）
- * @param showSeconds 是否显示秒，默认 false
- * @param locale 语言代码，zh 时使用「天/时/分/秒」，否则使用 d/h/m/s
- * @returns 如 "2h30m"、"1d2h30m23s" 或 "2时30分"、"1天2时30分23秒"
- *
- * @example
- * formatDuration(9000000, false)        // => "2h30m"
- * formatDuration(9000000, false, 'zh-cn') // => "2时30分"
- * formatDuration(86400000, false)       // => "1d"
- */
-export declare function formatDuration(ms: number, showSeconds?: boolean, locale?: string): string;

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

@@ -1,4 +0,0 @@
-export { parseTimeRange } from './parseTimeRange';
-export type { ParseTimeRangeResult } from './parseTimeRange';
-export { formatDuration } from './formatDuration';
-export { formatTime, formatDate, formatWeekday, getDayjsLocale, getRelativeDay, getRelativeDayLabel, getDatePartDisplay, } from '../../pisellDateTimeDisplay/utils';

package/es/components/pisellTimeRangeDisplay/utils/parseTimeRange.d.ts

@@ -1,23 +0,0 @@
-import { type Dayjs } from 'dayjs';
-import type { DayjsLike } from '../types';
-export interface ParseTimeRangeResult {
-    /** 开始时间（已应用 locale） */
-    start: Dayjs;
-    /** 结束时间（已应用 locale） */
-    end: Dayjs;
-    /** 是否同一天（按本地时区自然日判定） */
-    isSameDay: boolean;
-}
-/**
- * 解析 startAt / endAt 为 Dayjs，并判定是否同一天
- *
- * @param startAt 开始时间（dayjs 兼容值）
- * @param endAt 结束时间（dayjs 兼容值）
- * @param locale dayjs locale，可选
- * @returns { start, end, isSameDay }
- *
- * @example
- * parseTimeRange('2026-02-04 09:00', '2026-02-04 18:00', 'zh-cn')
- * // => { start: Dayjs, end: Dayjs, isSameDay: true }
- */
-export declare function parseTimeRange(startAt: DayjsLike, endAt: DayjsLike, locale?: string): ParseTimeRangeResult;

package/es/components/pisellUrl/PisellUrl.d.ts

@@ -1,37 +0,0 @@
-import React from 'react';
-import type { PisellUrlProps } from './types';
-import './PisellUrl.less';
-/**
- * PisellUrl URL 链接组件
- *
- * URL 链接输入/展示组件，支持只读、编辑、禁用三种状态。
- * 基于 Ant Design Input 组件开发，提供 URL 格式校验、协议自动补全、
- * 链接跳转和协议/路径显示控制功能。
- *
- * @param props 组件 Props
- *
- * @example
- * // 编辑态（URL 输入）
- * <PisellUrl
- *   placeholder="请输入网址"
- *   required
- * />
- *
- * @example
- * // 只读态（可跳转）
- * <PisellUrl
- *   mode="read"
- *   value="https://www.example.com"
- *   enableLinkClick
- * />
- *
- * @example
- * // 协议自动补全
- * <PisellUrl
- *   autoCompleteProtocol
- *   defaultProtocol="https://"
- * />
- */
-export declare const PisellUrl: React.FC<PisellUrlProps>;
-declare const _default: React.NamedExoticComponent<PisellUrlProps>;
-export default _default;