@pisell/materials 6.11.16 → 6.11.18

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

@@ -0,0 +1,146 @@
+import React from 'react';
+import './index.less';
+export interface FormatOption {
+    /** 原始 DOM 元素 */
+    originDom: React.ReactNode;
+    /** 是否选中状态 */
+    active: boolean;
+    /** 完整的组件数据 */
+    data: PisellWalletPassCardProps;
+}
+export interface PisellWalletPassCardProps {
+    id: number;
+    /** 卡片样式 */
+    type: 'default' | 'mini';
+    /** 商品名称 */
+    name: string;
+    /** 二维码 */
+    qrCode: string;
+    /** 共享店铺名称 */
+    storeName: string;
+    /** 余额 */
+    balance?: number;
+    /** 识别码编号 */
+    code: string;
+    /** 有效期 */
+    validDate: string;
+    /** 使用金额 */
+    redeem?: number;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 禁用原因 */
+    disabledReason?: string;
+    /** 是否展示禁用原因 */
+    showDisabledReason?: boolean;
+    /** 封面图 */
+    cover?: string;
+    /** 余额标题文案 */
+    balanceTitle?: string;
+    /** 使用金额标题文案 */
+    redeemTitle?: string;
+    /** 是否选中 */
+    active?: boolean;
+    /** 是否展示商品名称 */
+    showName?: boolean;
+    /** 是否展示共享店铺名称 */
+    showStoreName?: boolean | ((data: any) => boolean);
+    /** 是否展示使用金额 */
+    showRedeem?: boolean;
+    /** 是否展示余额 */
+    showBalance?: boolean;
+    /** 是否展示识别码编号 */
+    showCode?: boolean;
+    /** 是否展示有效期 */
+    showValidDate?: boolean;
+    /** 使用日程信息计算有效期 */
+    validDateBySchedule?: boolean;
+    /** 日程列表 */
+    scheduleList?: any[];
+    /** 是否展示右上角详情按钮 */
+    showDetail?: boolean;
+    /** 是否展示qrCode */
+    showQrCode?: boolean;
+    /** 是否展示封面 */
+    showCover?: boolean;
+    /** 是否展示余额货币符号 */
+    showBalanceSymbol?: boolean;
+    /** 展示操作按钮 */
+    showActions?: boolean;
+    /** 操作按钮配置 */
+    actions?: {
+        /** 按钮展示方式 */
+        layout: 'expanded' | 'collapsed';
+        /** detail 按钮配置 */
+        detail?: {
+            visible: boolean;
+            iconColor: string;
+        };
+        /** edit按钮配置 */
+        edit?: {
+            visible: boolean;
+            iconColor: string;
+            dialogTitle: string;
+            enableDialog: boolean;
+            fields: {
+                name: string;
+                label: string;
+            };
+        };
+    };
+    /** 编辑编辑按钮后，弹窗展示之前 */
+    beforeEdit?: (value: any) => Promise<any> | boolean | void;
+    /** 编辑弹窗点击提交 */
+    onConfirmEdit?: (value: any) => void;
+    /** 编辑金额事件 */
+    onConfirmEditAmount?: (value: number) => void;
+    /** 详情按钮点击事件 */
+    onDetail?: (data: {
+        id: number;
+        name: string;
+        storeName: string;
+        balance?: number;
+        redeem?: number;
+        code: string;
+        validDate: string;
+        originData?: any;
+    }) => void;
+    /** 是否使用外部详情处理（当为 true 且提供了 onDetail 时，不显示内部模态框） */
+    useExternalDetail?: boolean;
+    /** 单选或者多选 */
+    mode?: 'multiple' | 'single';
+    /** 是否展示选中图标 */
+    showActiveIcon?: boolean;
+    /** 开启编辑金额 */
+    enableEditAmount?: boolean;
+    /** 显示状态标识 */
+    showStatus?: boolean;
+    /** 名称标题字号字重颜色配置 */
+    nameTitleStyle?: {
+        fontSize: number;
+        fontWeight: number;
+        color: string;
+    };
+    /** 卡片状态 */
+    cardStatus?: 'used' | 'expired' | 'disabled' | 'conflict' | 'lastPayment';
+    /** 自定义余额格式化函数，如果提供则优先使用 */
+    formatBalance?: (balance?: number, option?: FormatOption) => React.ReactNode;
+    /** 自定义余额标题格式化函数，如果提供则优先使用 */
+    formatBalanceTitle?: (balanceTitle?: string, option?: FormatOption) => React.ReactNode;
+    /** 自定义使用金额格式化函数，如果提供则优先使用 */
+    formatRedeem?: (redeem?: number, option?: FormatOption) => React.ReactNode;
+    /** 自定义使用金额标题格式化函数，如果提供则优先使用 */
+    formatRedeemTitle?: (redeemTitle?: string, option?: FormatOption) => React.ReactNode;
+    /** 最大使用金额 */
+    maxRedeem?: number;
+    /** 编辑金额前事件 */
+    onBeforeEditAmount?: (value: any) => Promise<any> | boolean | void;
+    /** 是否显示持有人 */
+    showHolderName?: boolean;
+    /** 持有人, 表单记录，展示时一般取main_field */
+    holder?: any;
+    /** 持有人点击回调 */
+    onSetHolder?: (currentValue?: any) => void;
+    [key: string]: any;
+}
+declare const PisellWalletPassCard: (props: PisellWalletPassCardProps) => React.JSX.Element;
+export default PisellWalletPassCard;

package/es/components/pisellWalletPassCard/index.js

@@ -757,7 +757,7 @@ var PisellWalletPassCard = function PisellWalletPassCard(props) {
   }, /*#__PURE__*/React.createElement(PisellQrcode, {
     value: qrCode,
     size: 60
-  }))), checkedDom, (disabled || disabledReason) && showDisabledReason && /*#__PURE__*/React.createElement("div", {
+  }))), checkedDom, disabled && disabledReason && showDisabledReason && /*#__PURE__*/React.createElement("div", {
     className: "pisell-card-warn-message",
     ref: warnMessageRef
   }, /*#__PURE__*/React.createElement(Iconfont, {

package/es/components/productCard/cartSkuCard/components/AmountFooter/index.d.ts

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

package/es/components/productCard/cartSkuCard/components/Gift/index.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { IGiftProps } from './types';
+import './index.less';
+declare const Gift: (props: IGiftProps) => React.JSX.Element | null;
+export default Gift;

package/es/components/productCard/cartSkuCard/components/Gift/types.d.ts

@@ -0,0 +1,29 @@
+/// <reference types="react" />
+/**
+ * 赠品项数据结构
+ */
+export interface IGiftItem {
+    /** 图片 URL */
+    image?: string;
+    /** 标题 */
+    title?: string;
+    /** 唯一标识 */
+    id?: string;
+}
+/**
+ * Gift 组件 Props
+ */
+export interface IGiftProps {
+    /** 是否显示赠品组件 */
+    isShow?: boolean;
+    /** 赠品总数量（可选择的总数） */
+    totalCount?: number;
+    /** 已选择的赠品列表 */
+    selectedGifts?: IGiftItem[];
+    /** 选择的赠品原始数据列表 */
+    _selectedOriginGifts?: any[];
+    /** 提示文本（未选择时显示） */
+    promptText?: string;
+    /** 点击事件回调 */
+    onClick?: (e: React.MouseEvent) => void;
+}

package/es/components/productCard/cartSkuCard/components/MultiDay/index.d.ts

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

package/es/components/productCard/cartSkuCard/components/Note/index.d.ts

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

package/es/components/productCard/cartSkuCard/components/Promotion/index.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+interface IPromotionProps {
+    promotions: any[];
+    onClick?: (item: any) => void;
+}
+declare const Promotion: (props: IPromotionProps) => React.JSX.Element;
+export default Promotion;

package/es/components/productCard/cartSkuCard/components/basicInfo/index.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+import './index.less';
+interface IProps {
+    isShowImage?: boolean;
+    dataSource: {
+        image?: string;
+        bundle?: any[];
+        options?: any[];
+        product_option_string?: string;
+        name?: string;
+        symbol?: string;
+        price?: string | number;
+        total?: number;
+        origin_total?: number;
+        num?: number;
+        holder_id?: any;
+        isFormSubject?: boolean;
+        totalDifference?: number;
+    };
+    style?: React.CSSProperties;
+    /** 作为主商品卡片展示
+     * 1. 影响商品数量 tag 的位置
+     * 2. isMain 且 type 为 a5，展示holder
+     */
+    isMainProduct?: boolean;
+    maxSpecsCount?: number;
+    type?: 'a2' | 'a5' | 'a9';
+    isBundle?: boolean;
+    showFooter?: boolean;
+    isShowOriginalPrice?: boolean;
+    isShowEditProduct?: boolean;
+    onEditProduct?: (val: any) => void;
+    disabledEditClick?: boolean;
+}
+declare const BasicInfo: (props: IProps) => React.JSX.Element;
+export default BasicInfo;

package/es/components/productCard/cartSkuCard/components/basicInfo/index.js

@@ -96,14 +96,16 @@ var BasicInfo = function BasicInfo(props) {
         width: 20
       }
     }) : null, /*#__PURE__*/React.createElement("div", {
-      className: "product-info"
+      className: "product-info product-info-a5"
     }, /*#__PURE__*/React.createElement("div", {
-      className: "product-name"
+      className: "product-basic-info-wrap"
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "product-name ".concat(renderEdit ? 'product-name-edit' : '')
     }, name), (!holder_id || !(holder_id !== null && holder_id !== void 0 && holder_id.length)) && !isFormSubject ? /*#__PURE__*/React.createElement("div", {
       className: "product-price"
     }, formatAmount(price, 2, symbol)) : /*#__PURE__*/React.createElement(Holders, {
       dataSource: dataSource
-    })));
+    })), renderEdit));
   }
   if (type === 'a9') {
     var showAmount = isBundle && !showFooter;

package/es/components/productCard/cartSkuCard/components/basicInfo/index.less

@@ -151,7 +151,7 @@
       }
     }
 
-    .product-info-a9 {
+    .product-info-a9, .product-info-a5 {
       display: flex;
       justify-content: space-between;
       align-items: start;

package/es/components/productCard/cartSkuCard/components/discountReason/index.d.ts

@@ -1,2 +1,3 @@
-declare const DiscountReason: (props: any) => JSX.Element;
+import React from 'react';
+declare const DiscountReason: (props: any) => React.JSX.Element;
 export default DiscountReason;

package/es/components/productCard/cartSkuCard/components/holders/index.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import './index.less';
-declare const Holders: (props: any) => JSX.Element | null;
+declare const Holders: (props: any) => React.JSX.Element | null;
 export default Holders;