@pisell/materials 3.3.104 → 3.3.105

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/Divider/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 declare const Divider: ({ type }: any) => JSX.Element;
 export default Divider;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 declare const DeleteButton: ({ onDelete }: any) => JSX.Element;
 export default DeleteButton;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 declare const Like: ({ status, onLike, className, style, isShowChangeResource, }: {
     style?: any;

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

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

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { SegmentedProps } from "antd";
 import "./index.less";
 declare const Segmented: (props: SegmentedProps) => JSX.Element;

package/es/components/select-time/RightPanel/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 interface RightPanelProps {
     value: string;

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

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

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

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

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { MenuProps } from "antd";
 import "./index.less";
 interface InlineMenuProps {

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/ExportImport/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { ExportImportType } from '../../../types';
 import './index.less';
 declare type ExportImportProps = {

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { GallerySettingType, ModeType } from "../../../types";
 import "./index.less";
 declare type GallerySettingProps = {

package/es/components/table/Actions/component/Group/PopoverContent.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './PopoverContent.less';
 declare type FieldType = string | number;
 export declare type GroupValue = {

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { DataSourceGroupType } from "../../../types";
 declare type GroupProps = {
     setting: DataSourceGroupType;

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { GallerySettingType, GallerySettingValueType } from "../../../../../types";
 declare type CoverProps = {
     cover?: GallerySettingType["cover"];

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { GallerySettingType } from "../../../../../types";
 import "./index.less";
 declare type TitleProps = GallerySettingType["title"] & {

package/es/components/table/Summary/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import "./index.less";
 declare const Summary: ({ summary }: any) => JSX.Element | null;
 export default Summary;

package/es/components/table/Table/SelectField/index.d.ts

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

package/es/components/table/Table/fields/date/Config/index.d.ts

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

package/es/components/table/Table/fields/date/Sort/index.d.ts

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

package/es/components/table/Table/fields/image/Config/index.d.ts

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

package/es/components/table/Table/fields/image/Sort/index.d.ts

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

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

@@ -198,12 +198,12 @@ export declare const fieldList: ({
     field_icon: string;
     field_name: string;
     field_type: string;
-    default_value: string;
+    default_value: boolean;
 } | {
     field_icon: string;
     field_name: string;
     field_type: string;
-    default_value: boolean;
+    default_value: string;
 } | {
     field_icon: string;
     field_name: string;

package/es/components/table/Table/fields/link/Config/index.d.ts

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

package/es/components/table/Table/fields/link/Sort/index.d.ts

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

package/es/components/table/Table/fields/number/Config/index.d.ts

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

package/es/components/table/Table/fields/number/Sort/index.d.ts

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

package/es/components/table/Table/fields/numberRange/Config/index.d.ts

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

package/es/components/table/Table/fields/numberRange/Sort/index.d.ts

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

package/es/components/table/Table/fields/oldRangePicker/Config/index.d.ts

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

package/es/components/table/Table/fields/oldRangePicker/Sort/index.d.ts

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

package/es/components/table/Table/fields/pSwitch/Config/index.d.ts

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

package/es/components/table/Table/fields/pSwitch/Sort/index.d.ts

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

package/es/components/table/Table/fields/rangePicker/Config/index.d.ts

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

package/es/components/table/Table/fields/rangePicker/Sort/index.d.ts

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

package/es/components/table/Table/fields/search/Config/index.d.ts

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

package/es/components/table/Table/fields/search/Sort/index.d.ts

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

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

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

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

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

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/text/Config/index.d.ts

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

package/es/components/table/Table/fields/text/Show/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { FieldPropsType } from "../../types";
 import "./index.less";
 declare const Show: (props: FieldPropsType) => JSX.Element;

package/es/components/table/Table/fields/text/Sort/index.d.ts

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

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

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

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

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

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

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

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/tableConfig/summary/index.d.ts

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

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;
-}) => ("filters" | "column_setting" | "gallery_setting" | "order_by" | "group_by" | "filter_setting" | "view_mode")[];
+}) => ("filters" | "filter_setting" | "group_by" | "order_by" | "column_setting" | "view_mode" | "gallery_setting")[];
 export declare const omit: (obj: Record<string, any>, keys: string[]) => Record<string, any>;
 export declare const stringify: (obj: Record<string, any>) => string;
 export {};

package/es/components/table/TableFilter/SortIcon.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 interface SortIconProps {
     sortOrder: null | "ascend" | "descend";
 }

package/es/components/table/View/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { GridViewProps } from '../types';
 declare const View: (props: GridViewProps & {
     setTableSetting: (values: Record<string, any>) => void;

package/es/components/time-picker/index.d.ts

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

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

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

package/es/components/virtual-keyboard/Time/utils.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 export declare const formatStringToTime: (value: string) => {
     valueArray: string[];
     valueString: string;

package/es/components/virtualInput/BaseVirtualInput/index.d.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+import './index.less';
+export interface BaseVirtualInputProps {
+    /** 输入值 */
+    value?: string | React.ReactNode;
+    /** 占位符 */
+    placeholder?: string;
+    /** 是否自动聚焦 */
+    autoFocus?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 组件高度，默认60px */
+    height?: number | string;
+    /** 字体大小，默认48px，如果不设置会根据高度自动计算 */
+    fontSize?: number | string;
+    /** 聚焦回调 */
+    onFocus?: () => void;
+    /** 失焦回调 */
+    onBlur?: () => void;
+    /** 文字位置 */
+    textAlign?: 'start' | 'center' | 'end';
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 自定义类名 */
+    className?: string;
+    /** showCursor  */
+    showCursor?: boolean;
+    /** 防止失焦的元素选择器或ref */
+    preventBlurElements?: Array<string | React.RefObject<HTMLElement>>;
+    /** 是否聚焦（受控模式） */
+    focused?: boolean;
+    /** 是否选中全部文本（类似浏览器选中效果） */
+    selected?: boolean;
+    /** 选中状态的背景色，默认为主题色 */
+    selectedColor?: string;
+}
+export interface BaseVirtualInputRef {
+    /** 手动聚焦 */
+    focus: () => void;
+    /** 手动失焦 */
+    blur: () => void;
+}
+declare const BaseVirtualInput: React.ForwardRefExoticComponent<BaseVirtualInputProps & React.RefAttributes<BaseVirtualInputRef>>;
+export default BaseVirtualInput;

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

@@ -0,0 +1,29 @@
+import React from 'react';
+import { BaseVirtualInputProps, BaseVirtualInputRef } from './BaseVirtualInput';
+import './index.less';
+export type { BaseVirtualInputProps, BaseVirtualInputRef } from './BaseVirtualInput';
+export interface VirtualInputProps extends BaseVirtualInputProps {
+    /** 在VirtualInput上方显示的额外内容 */
+    topContent?: React.ReactNode;
+    /** 在VirtualInput下方显示的额外内容 */
+    bottomContent?: React.ReactNode;
+    /** wrapper class */
+    wrapperClassName?: string;
+    /** 虚拟输入框包装器的样式 */
+    wrapperStyle?: React.CSSProperties;
+    /** 是否允许清除输入框中的内容 */
+    allowClear?: boolean;
+    /** 清除输入框内容的回调函数 */
+    onClear?: () => void;
+    /** 自定义清除按钮的样式 */
+    clearButtonStyle?: React.CSSProperties;
+    theme?: {
+        token?: {
+            colorPrimary?: string;
+        };
+    };
+}
+export interface VirtualInputRef extends BaseVirtualInputRef {
+}
+declare const VirtualInput: React.ForwardRefExoticComponent<VirtualInputProps & React.RefAttributes<VirtualInputRef>>;
+export default VirtualInput;

package/es/components/walletCard/Guest/index.d.ts

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

package/es/components/walletCard/Guide/index.d.ts

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

package/es/hooks/useMobile.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 响应式监听 Hook
+ * 监听窗口大小变化，返回当前是否为移动端
+ *
+ * @param breakpoint - 断点宽度（默认 768px）
+ * @returns 是否为移动端
+ */
+export declare function useMobile(breakpoint?: number): boolean;