@pisell/materials 3.3.88 → 3.3.89

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

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

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * 将毫秒数格式化为持续时间字符串（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/parseTimeRange.d.ts

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * PisellUrl 工具函数导出
+ */
+export * from './urlValidator';
+export * from './urlHelper';
+export * from './urlFormatter';

package/es/components/pisellUrl/utils/urlFormatter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * URL 格式化工具函数
+ */
+/**
+ * 格式化 URL 显示
+ * @param url URL 地址
+ * @param options 格式化选项
+ * @returns 格式化后的 URL
+ *
+ * @example
+ * formatUrlDisplay('https://www.example.com/path', { showProtocol: false })
+ * // 'www.example.com/path'
+ */
+export declare function formatUrlDisplay(url: string, options: {
+    showProtocol?: boolean;
+    showWww?: boolean;
+    showPathname?: boolean;
+    displayFormat?: 'full' | 'domain' | 'custom';
+    customFormat?: (url: string) => string;
+}): string;
+/**
+ * 隐藏 URL 协议
+ * @param url URL 地址
+ * @returns 隐藏协议后的 URL
+ *
+ * @example
+ * hideUrlProtocol('https://example.com') // 'example.com'
+ */
+export declare function hideUrlProtocol(url: string): string;
+/**
+ * 隐藏 www 前缀
+ * @param url URL 地址
+ * @returns 隐藏 www 后的 URL
+ *
+ * @example
+ * hideWwwPrefix('https://www.example.com') // 'https://example.com'
+ */
+export declare function hideWwwPrefix(url: string): string;

package/es/components/pisellUrl/utils/urlHelper.d.ts

@@ -0,0 +1,63 @@
+/**
+ * URL 辅助函数
+ */
+/**
+ * 规范化 URL（补全协议）
+ * @param url URL 地址
+ * @param defaultProtocol 默认协议
+ * @returns 规范化后的 URL
+ *
+ * @example
+ * normalizeUrl('example.com', 'https://') // 'https://example.com'
+ * normalizeUrl('http://example.com', 'https://') // 'http://example.com'
+ */
+export declare function normalizeUrl(url: string, defaultProtocol?: string): string;
+/**
+ * 智能补全协议（识别 localhost）
+ * @param url URL 地址
+ * @returns 规范化后的 URL
+ *
+ * @example
+ * smartNormalizeUrl('localhost:3000') // 'http://localhost:3000'
+ * smartNormalizeUrl('example.com') // 'https://example.com'
+ */
+export declare function smartNormalizeUrl(url: string): string;
+/**
+ * 提取域名
+ * @param url URL 地址
+ * @returns 域名
+ *
+ * @example
+ * extractDomain('https://www.example.com/path') // 'www.example.com'
+ */
+export declare function extractDomain(url: string): string;
+/**
+ * 处理链接跳转（安全性保障）
+ * @param url URL 地址
+ * @param openInNewWindow 是否新窗口打开
+ * @param defaultProtocol 默认协议
+ *
+ * @example
+ * handleUrlClick('example.com', true, 'https://')
+ */
+export declare function handleUrlClick(url: string, openInNewWindow?: boolean, defaultProtocol?: string): void;
+/**
+ * 检测是否为安全链接（HTTPS）
+ * @param url URL 地址
+ * @returns 是否为 HTTPS
+ *
+ * @example
+ * isSecureUrl('https://example.com') // true
+ * isSecureUrl('http://example.com') // false
+ */
+export declare function isSecureUrl(url: string): boolean;
+/**
+ * 提取 URL 参数
+ * @param url URL 地址
+ * @returns 参数对象
+ *
+ * @example
+ * extractUrlParams('https://example.com?foo=bar&baz=qux')
+ * // { foo: 'bar', baz: 'qux' }
+ */
+export declare function extractUrlParams(url: string): Record<string, string>;

package/es/components/pisellUrl/utils/urlValidator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * URL 校验工具函数
+ */
+/**
+ * URL 格式校验（使用 URL 构造函数）
+ * @param url URL 地址
+ * @returns 是否通过校验
+ *
+ * @example
+ * validateUrl('https://example.com') // true
+ * validateUrl('invalid-url') // false
+ */
+export declare function validateUrl(url: string): boolean;
+/**
+ * URL 正则校验（备选方法）
+ * @param url URL 地址
+ * @returns 是否通过校验
+ */
+export declare function validateUrlByRegex(url: string): boolean;
+/**
+ * 解析 URL 各部分
+ * @param url URL 地址
+ * @returns URL 各部分或 null
+ *
+ * @example
+ * parseUrl('https://example.com:8080/path?key=value#hash')
+ * // { protocol: 'https', host: 'example.com', port: '8080', ... }
+ */
+export declare function parseUrl(url: string): {
+    protocol: string;
+    host: string;
+    port: string;
+    pathname: string;
+    search: string;
+    hash: string;
+} | null;
+/**
+ * 协议白名单校验
+ * @param url URL 地址
+ * @param allowedProtocols 允许的协议列表
+ * @returns 校验结果
+ */
+export declare function validateUrlProtocol(url: string, allowedProtocols: string[]): {
+    isValid: boolean;
+    errors: string[];
+};

package/es/components/productCard/components/Header/DeleteButton/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import './index.less';
+declare const DeleteButton: ({ onDelete }: any) => React.JSX.Element;
+export default DeleteButton;

package/es/components/productCard/components/Packages/utils.d.ts

@@ -6,7 +6,7 @@
  * @Author: WangHan
  * @Date: 2024-11-22 10:01
  */
-export declare const minusSign: (item: any, type?: string) => "" | "-";
+export declare const minusSign: (item: any, type?: string) => "-" | "";
 /**
  * @title: 金额格式化
  * @description:

package/es/components/productCard/components/Time/components/SelectHolder/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import './index.less';
+declare const SelectHolder: ({ lists, value, onChange, holderMode, isShowAddHolderButton, onAddHolder, addHolderButtonText, onClearHolder, isErrorHolder, allowClear, holderMaxCount, }: any) => React.JSX.Element;
+export default SelectHolder;

package/es/components/productCard/components/Time/components/SelectResource/index.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import './index.less';
+interface ResourceItem {
+    id: string | number;
+    label: string;
+    isError?: boolean;
+    [key: string]: any;
+}
+interface SelectResourceProps {
+    lists: ResourceItem[];
+    value: any;
+    onChange: (val: any) => void;
+    resourceMode?: 'multiple' | 'tags' | undefined;
+    maxLength?: number;
+    isParallelResource?: boolean;
+    [key: string]: any;
+}
+declare const SelectResource: ({ lists, value, onChange, resourceMode, allowClear, onClearResource, maxLength, isErrorResource, resourceErrorText, ...props }: SelectResourceProps) => React.JSX.Element;
+export default SelectResource;

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

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const Radio: (props: any) => import("react").JSX.Element;
 export default Radio;

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

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const Skeleton: (props: any) => import("react").JSX.Element;
 export default Skeleton;

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

@@ -0,0 +1,5 @@
+import React from 'react';
+import { SortListProps } from './types';
+import './index.less';
+declare const Sort: React.FC<SortListProps>;
+export default Sort;

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

@@ -0,0 +1,39 @@
+import { MenuProps } from "antd";
+import React from "react";
+/** 单个排序子项（如 A→Z、0→9），由组件的 getSortItems 返回 */
+export declare type SortOptionItem = {
+    key: string;
+    label: string;
+};
+export declare type SortItemProps = {
+    /** 排序类型，与 sortChildrenMap 对应；当 getSortItems 存在时可省略 */
+    type?: "date" | "string" | "number" | "option";
+    label?: string;
+    name?: string | string[];
+    isCustom: boolean;
+    columnKey?: string;
+    localFilter?: boolean;
+    isHidden?: boolean;
+    /** 由组件内置导出：直接返回该列的排序子项，优先于 type */
+    getSortItems?: (fieldKey: string) => SortOptionItem[];
+};
+/**
+ * 组件侧导出的排序支持契约（如 PisellSingleLineText.SortOptions）。
+ * 支持两种形态：
+ * - getSortItems：组件内置完整排序项（key + label），优先使用；
+ * - type：仅类型，由 Sort 的 sortChildrenMap 生成子项（兼容旧用法）。
+ */
+export declare type SortOptionType = (Pick<SortItemProps, "type"> & Partial<Pick<SortItemProps, "label" | "localFilter" | "isHidden">>) | {
+    getSortItems: (fieldKey: string) => SortOptionItem[];
+    label?: string;
+    isHidden?: boolean;
+};
+export declare type SortListProps = {
+    list: SortItemProps[];
+    onChange?: (val: string, detail: Parameters<Required<MenuProps>["onClick"]>[0]) => void;
+    button?: React.ReactNode;
+    style?: React.CSSProperties;
+    value?: any;
+    placement?: "bottom" | "bottomLeft" | "bottomRight" | "top" | "topLeft" | "topRight";
+    localPagination?: boolean;
+};

package/es/components/table/Actions/component/ViewMode/index.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+import { GridViewType, ModeType } from "../../../types";
+declare type ViewModeProps = {
+    view: GridViewType;
+    value?: ModeType;
+    onChange?: (value: ModeType) => void;
+};
+declare const ViewMode: (props: ViewModeProps) => React.JSX.Element;
+export default ViewMode;

package/es/components/table/Gallery/components/GalleryItem/index.d.ts

@@ -0,0 +1,14 @@
+import React from "react";
+import { GallerySettingType, GallerySettingValueType } from "../../../types";
+import "./index.less";
+declare type GalleryItemProps = {
+    record: Record<string, any>;
+    gallery: GallerySettingType;
+    columnsMap: Map<string, Record<string, any>>;
+    index: number;
+    gallerySetting: GallerySettingValueType;
+    columns: Record<string, any>[];
+    onClick: React.MouseEventHandler<HTMLDivElement>;
+};
+declare const GalleryItem: (props: GalleryItemProps) => React.JSX.Element;
+export default GalleryItem;

package/es/components/table/Table/fields/select/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/es/components/table/Table/fields/treeSelect/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/es/components/table/Table/fields/types/index.d.ts

@@ -0,0 +1,33 @@
+/// <reference types="react" />
+export declare type FieldPropsType = {
+    title: React.ReactNode;
+    editable: boolean;
+    dataIndex: string;
+    field_type: FieldType;
+    record: Record<string, any>;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    handleSave: () => void;
+    onChange: (value: any, record: any) => void;
+    action?: string;
+    contentClassName?: string;
+};
+export declare type FieldType = "text" | "image";
+export declare type EditPropsType = {
+    value: any;
+    onChange: (v: any) => void;
+    onPressEnter: () => void;
+    onBlur: () => void;
+    style: React.CSSProperties;
+    bordered: boolean;
+    options?: {
+        value: string;
+        label: string;
+    }[] | ((value?: string) => Promise<{
+        value: string;
+        label: string;
+    }[]>);
+    [key: string]: any;
+};

package/es/components/table/Table/utils.d.ts

@@ -155,7 +155,7 @@ export declare const getSettingKeyArrByMode: ({ filter, columnSetting, dataSourc
     sort?: SortType | undefined;
     mode: "" | "localStorage" | "remote";
     currentViewMode: ModeType;
-}) => ("view_mode" | "filter_setting" | "group_by" | "order_by" | "column_setting" | "gallery_setting" | "filters")[];
+}) => ("filters" | "column_setting" | "gallery_setting" | "order_by" | "group_by" | "view_mode" | "filter_setting")[];
 export declare const omit: (obj: Record<string, any>, keys: string[]) => Record<string, any>;
 export declare const stringify: (obj: Record<string, any>) => string;
 export {};