@pisell/materials 1.8.23 → 1.8.25

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,3 @@
+import './index.less';
+declare const Footer: ({ item, hideDivider, type, isOnlyTotal }: any) => JSX.Element;
+export default Footer;

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

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

package/lib/components/productCard/components/MultiDay/index.d.ts

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

package/lib/components/productCard/components/Note/index.d.ts

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

package/lib/components/productCard/components/Packages/components/collapsibleList/utils.d.ts

@@ -1,2 +1 @@
-/// <reference types="react" />
 export declare const renderBundles: (item: any, hidePrice?: boolean, isShowPackageNote?: boolean) => JSX.Element;

package/lib/components/productCard/components/Packages/components/options/index.d.ts

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

package/lib/components/productCard/components/Packages/index.d.ts

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

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

@@ -0,0 +1,13 @@
+import './index.less';
+interface SelectHolderModalProps {
+    visible: boolean;
+    onClose: () => void;
+    onConfirm: (value: any) => void;
+    lists: any[];
+    value: any[];
+    holderMaxCount: number;
+    addHolderButtonText: string;
+    onAdd: () => void;
+}
+declare const SelectHolderModal: (props: SelectHolderModalProps) => JSX.Element;
+export default SelectHolderModal;

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

@@ -0,0 +1,18 @@
+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) => JSX.Element;
+export default SelectResource;

package/lib/components/productCard/components/Time/index.d.ts

@@ -0,0 +1,3 @@
+import './index.less';
+declare const Time: ({ item, isShowHolder, onLike, isShowChangeResource, changeResource, changeHolder, isShowChangeHolder, holderMode, onAddHolder, isShowAddHolderButton, onClearHolder, onClearResource, }: any) => JSX.Element | null;
+export default Time;

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

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

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

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

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

@@ -0,0 +1,9 @@
+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/select-time/RightPanel/index.d.ts

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

package/lib/components/select-time/index.js

@@ -131,6 +131,7 @@ var SelectTime = (props) => {
     /* @__PURE__ */ import_react.default.createElement(
       import_antd.TimePicker,
       {
+        key: previewValueString || "",
         format: "HH:mm",
         size: "large",
         inputReadOnly: true,

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

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

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

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

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

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

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