@pisell/materials 6.11.49 → 6.11.50

package/lib/components/pisellUrl/PisellUrl.stories.d.ts

@@ -1,108 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { PisellUrl } from './PisellUrl';
-/**
- * PisellUrl 是一个 URL 地址输入/展示组件。
- *
- * ## 功能特性
- * - 支持三种状态：只读、编辑、禁用
- * - URL 格式校验
- * - 协议自动补全
- * - 链接跳转（新窗口，安全性保障）
- * - 协议/路径显示控制
- * - 协议白名单限制
- */
-declare const meta: Meta<typeof PisellUrl>;
-export default meta;
-declare type Story = StoryObj<typeof PisellUrl>;
-/**
- * 基础编辑态
- */
-export declare const Basic: Story;
-/**
- * 协议自动补全
- */
-export declare const WithProtocolAutoComplete: Story;
-/**
- * 只读态 - 可跳转
- */
-export declare const ReadMode: Story;
-/**
- * 只读态 - 隐藏协议
- */
-export declare const ReadModeHideProtocol: Story;
-/**
- * 只读态 - 仅域名
- */
-export declare const ReadModeDomainOnly: Story;
-/**
- * 禁用态（编辑）
- */
-export declare const DisabledEdit: Story;
-/**
- * 禁用态（只读）
- */
-export declare const DisabledRead: Story;
-/**
- * 必填校验
- */
-export declare const Required: Story;
-/**
- * 格式校验（实时）
- */
-export declare const FormatValidation: Story;
-/**
- * 协议限制（仅 HTTPS）
- */
-export declare const HttpsOnly: Story;
-/**
- * 协议必需
- */
-export declare const RequireProtocol: Story;
-/**
- * 显示清空按钮
- */
-export declare const WithClearButton: Story;
-/**
- * 自动聚焦
- */
-export declare const WithAutoFocus: Story;
-/**
- * 自定义样式（只读态）
- */
-export declare const CustomStyle: Story;
-/**
- * 显示控制对比
- */
-export declare const DisplayFormatComparison: Story;
-/**
- * 校验时机对比
- */
-export declare const ValidateTriggerComparison: Story;
-/**
- * 所有状态展示
- */
-export declare const AllStates: Story;
-/**
- * 完整功能示例
- */
-export declare const CompleteExample: Story;
-/**
- * 协议补全演示
- */
-export declare const ProtocolCompleteDemo: Story;
-/**
- * 链接跳转演示
- */
-export declare const LinkClickDemo: Story;
-/**
- * 协议限制演示
- */
-export declare const ProtocolRestrictionDemo: Story;
-/**
- * 完整交互示例
- */
-export declare const InteractiveExample: Story;
-/**
- * 协议默认值对比
- */
-export declare const ProtocolDefaultComparison: Story;

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

@@ -1,14 +0,0 @@
-import React from 'react';
-import type { PisellUrlProps } from '../types';
-/**
- * PisellUrl 禁用态视图组件
- *
- * 职责：
- * - 渲染禁用状态的 URL 组件
- * - 根据原始 mode 选择渲染 ReadOnlyView 或 EditView
- * - 应用禁用样式（透明度 40%）
- *
- * @param props 组件 Props
- */
-declare const DisabledView: React.FC<PisellUrlProps>;
-export default DisabledView;

package/lib/components/pisellUrl/components/EditView.d.ts

@@ -1,15 +0,0 @@
-import React from 'react';
-import type { PisellUrlProps } from '../types';
-/**
- * PisellUrl 编辑态视图组件
- *
- * 职责：
- * - 渲染编辑态 URL 输入框
- * - 失焦时自动补全协议
- * - 实时格式校验
- * - 错误提示展示
- *
- * @param props 组件 Props
- */
-declare const EditView: React.FC<PisellUrlProps>;
-export default EditView;

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

@@ -1,15 +0,0 @@
-import React from 'react';
-import type { PisellUrlProps } from '../types';
-/**
- * PisellUrl 只读态视图组件
- *
- * 职责：
- * - 渲染只读态 URL 链接展示
- * - 支持点击新窗口打开链接（安全性保障）
- * - 支持协议/路径隐藏
- * - 支持链接图标
- *
- * @param props 组件 Props
- */
-declare const ReadOnlyView: React.FC<PisellUrlProps>;
-export default ReadOnlyView;

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

@@ -1,7 +0,0 @@
-/**
- * PisellUrl 组件导出文件
- */
-import PisellUrl from './PisellUrl';
-export { PisellUrl };
-export default PisellUrl;
-export type { PisellUrlProps } from './types';

package/lib/components/pisellUrl/types.d.ts

@@ -1,160 +0,0 @@
-import type { CSSProperties } from 'react';
-import type { BaseTextInputProps } from '@pisell/utils';
-/**
- * PisellUrl 组件 Props 类型定义
- *
- * 继承 BaseTextInputProps，添加 URL 特有的配置
- */
-export interface PisellUrlProps extends BaseTextInputProps {
-    /**
-     * 状态模式
-     * @default 'edit'
-     */
-    mode?: 'read' | 'edit';
-    /**
-     * 是否禁用
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * 是否使用严格校验
-     * @default true
-     */
-    strictValidation?: boolean;
-    /**
-     * 允许的协议列表
-     * @example ['http', 'https']
-     * @default ['http', 'https']
-     */
-    allowedProtocols?: string[];
-    /**
-     * 是否要求必须有协议
-     * @default false
-     */
-    requireProtocol?: boolean;
-    /**
-     * 是否自动补全协议
-     * @default true
-     */
-    autoCompleteProtocol?: boolean;
-    /**
-     * 默认协议
-     * @default 'https://'
-     */
-    defaultProtocol?: 'http://' | 'https://';
-    /**
-     * 协议补全回调
-     * @param url 补全后的 URL
-     */
-    onProtocolComplete?: (url: string) => void;
-    /**
-     * 是否启用链接跳转（只读态）
-     * @default true
-     */
-    enableLinkClick?: boolean;
-    /**
-     * 是否新窗口打开
-     * @default true
-     */
-    openInNewWindow?: boolean;
-    /**
-     * 是否显示链接图标
-     * @default true
-     */
-    showLinkIcon?: boolean;
-    /**
-     * 链接点击回调
-     * @param url URL 地址
-     */
-    onLinkClick?: (url: string) => void;
-    /**
-     * 是否显示协议（只读态）
-     * @default false
-     */
-    showProtocol?: boolean;
-    /**
-     * 是否显示 www 前缀（只读态）
-     * @default false
-     */
-    showWww?: boolean;
-    /**
-     * 是否显示路径（只读态）
-     * @default true
-     */
-    showPathname?: boolean;
-    /**
-     * 显示格式（只读态）
-     * - full: 完整 URL
-     * - domain: 仅域名
-     * - custom: 自定义格式
-     * @default 'full'
-     */
-    displayFormat?: 'full' | 'domain' | 'custom';
-    /**
-     * 自定义格式化函数（只读态）
-     * @param url URL 地址
-     * @returns 格式化后的显示文本
-     */
-    customFormat?: (url: string) => string;
-    /**
-     * 字号
-     * @example '14px' 或 14
-     * @default 16
-     */
-    fontSize?: string | number;
-    /**
-     * 字重
-     * @example 'bold' 或 600
-     * @default 500
-     */
-    fontWeight?: string | number;
-    /**
-     * 文本颜色
-     * @example '#000000'
-     * @default '#101828'
-     */
-    color?: string;
-    /**
-     * 链接颜色（只读态）
-     * @example '#1890ff'
-     * @default '#7F56DA'
-     */
-    linkColor?: string;
-    /**
-     * 占位文本
-     * @default '请输入 URL 地址'
-     */
-    placeholder?: string;
-    /**
-     * 最大长度
-     * @default 2048
-     */
-    maxLength?: number;
-    /**
-     * 是否显示清空按钮
-     * @default false
-     */
-    allowClear?: boolean;
-    /**
-     * 是否自动聚焦
-     * @default false
-     */
-    autoFocus?: boolean;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 自定义样式
-     */
-    style?: CSSProperties;
-    /**
-     * ARIA 标签
-     */
-    'aria-label'?: string;
-    /**
-     * ARIA 描述
-     */
-    'aria-describedby'?: string;
-}
-export type { DisplayState, ValidationResult, TextInputState } from '@pisell/utils';

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

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

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

@@ -1,38 +0,0 @@
-/**
- * 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/lib/components/pisellUrl/utils/urlHelper.d.ts

@@ -1,63 +0,0 @@
-/**
- * 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/lib/components/pisellUrl/utils/urlValidator.d.ts

@@ -1,46 +0,0 @@
-/**
- * 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/lib/components/select/index.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-import { Select as OriginalSelect } from 'antd';
-import type { SelectProps } from 'antd';
-import './index.less';
-interface CompoundedComponent extends React.ForwardRefExoticComponent<SelectProps> {
-    Option: typeof OriginalSelect.Option;
-}
-declare const Select: CompoundedComponent;
-export default Select;

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

@@ -1,39 +0,0 @@
-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/lib/components/table/Actions/component/GallerySetting/index.d.ts

@@ -1,8 +0,0 @@
-import { GallerySettingType, ModeType } from "../../../types";
-import "./index.less";
-declare type GallerySettingProps = {
-    setting: GallerySettingType;
-    currentViewMode: ModeType;
-};
-declare const GallerySetting: (props: GallerySettingProps) => JSX.Element;
-export default GallerySetting;

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

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

package/lib/components/table/Table/fields/select/Edit/index.d.ts

@@ -1,4 +0,0 @@
-import React from "react";
-import { EditPropsType } from "../../types";
-declare const _default: React.ForwardRefExoticComponent<Omit<EditPropsType, "ref"> & React.RefAttributes<any>>;
-export default _default;

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

@@ -1,33 +0,0 @@
-/// <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/lib/components/virtualInput/BaseVirtualInput/index.d.ts

@@ -1,44 +0,0 @@
-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/lib/components/virtualInput/index.d.ts

@@ -1,29 +0,0 @@
-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/lib/hooks/useMobile.d.ts

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

package/lib/hooks/useThemeTokens.d.ts

@@ -1,7 +0,0 @@
-declare type ThemeInput = {
-    token?: {
-        colorPrimary?: string;
-    };
-};
-declare const useThemeTokens: (themeInput?: ThemeInput) => any;
-export default useThemeTokens;