@pisell/private-materials 6.3.82 → 6.3.83

package/lib/plus/walletPassGallery/serve.d.ts

@@ -0,0 +1,243 @@
+/**
+ * 钱包列表查询参数接口
+ */
+export interface IWalletListParmsProps {
+    tags?: string[];
+    sales_status?: 1 | 0 | -1;
+    machine_search?: string;
+    createdDate?: string;
+    limit_status?: string;
+    relation_id?: string;
+    relation_type?: string;
+    customer_id?: number;
+    sort?: 'desc' | 'asc';
+    order_by?: string;
+    used_status?: string;
+    num?: number;
+    skip?: number;
+    filter_wallet_id?: string;
+    filter_holder_id?: string;
+    available: 0 | 1;
+    with?: string[];
+}
+/**
+ * 钱包列表项属性接口
+ */
+export interface IWalletListItemProps {
+    id?: number | string;
+    encoded?: string;
+    code?: string;
+    limit_status?: string;
+    customer_id?: number;
+    generate_method?: 'not_settable' | 'before_order' | 'after_order';
+    created_at?: string;
+    product_id?: number;
+    sales_status?: 1 | 0;
+    tag?: string;
+    status?: string;
+    redeemed_at?: string;
+    collection_time?: string;
+    order_id?: number;
+    par_value?: string;
+    write_status?: number;
+    expire_date?: string;
+    balance?: string;
+    extension_id?: string;
+    product_title?: string;
+    product_cover?: string;
+    product?: IProductProps;
+    unified_available_status?: 0 | 1;
+    unified_error_code?: number;
+    shop: IShop;
+    unified_messages: any;
+    machinecode_config?: {
+        hide_recharge?: number;
+    };
+}
+/**
+ * 商店信息接口
+ */
+export interface IShop {
+    name: string;
+    id: number;
+}
+/**
+ * 商品属性接口
+ */
+export interface IProductProps {
+    id?: number;
+    title?: string;
+    description?: string;
+}
+/**
+ * API响应接口
+ */
+export interface ApiResponse<T> {
+    data: T;
+    code?: number;
+    message?: string;
+}
+/**
+ * 错误处理函数类型
+ */
+export declare type ErrorCallback = () => void;
+/**
+ * 获取钱包列表
+ * @param params 查询参数
+ * @returns Promise<{list: IWalletListItemProps[], count: number}> 钱包列表和总数
+ * @throws 请求失败时抛出错误
+ */
+export declare const getWalletPassList: (params?: IWalletListParmsProps) => Promise<{
+    list: IWalletListItemProps[];
+    count: number;
+}>;
+/**
+ * 通过code绑定客户
+ * @param params 请求参数，包含code
+ * @param errCallback 错误回调
+ * @returns Promise<any> 绑定结果
+ */
+export declare const bindCodeToCustomer: (params: {
+    code: string;
+}) => Promise<any>;
+/**
+ * 用户根据code查询待绑定识别码列表
+ * @param params 请求参数，包含code和tag
+ * @param errCallback 错误回调函数
+ * @returns Promise<IWalletListItemProps[] | null> 未绑定的钱包卡列表
+ */
+export declare const getUnbindList: (params: {
+    code: string;
+    tag?: string;
+}) => Promise<IWalletListItemProps[] | null>;
+/**
+ * 下单请求参数接口
+ */
+export interface IOrderParams {
+    voucher_id: string;
+    product_id: string;
+    product_variant_id: string;
+    quantity: number;
+    type: string;
+    platform: string;
+    currency_code: {
+        currency_code: string;
+        currency_symbol: string;
+        currency_format: string;
+    };
+}
+/**
+ * 下单
+ * @param params 下单参数
+ * @returns Promise<any> 下单结果
+ * @throws 请求失败时抛出错误
+ */
+export declare const goOrder: (params: IOrderParams) => Promise<any>;
+/**
+ * 设置请求对象
+ * @param req 请求对象
+ */
+export declare const setRequest: (req: any) => void;
+interface IAssetListProps {
+    skip?: string;
+    num?: string;
+    card_id?: string;
+    sourceType?: string;
+    business_object?: string;
+    tag?: string;
+}
+export interface IAssetItem {
+    id?: string;
+    tag?: 'gift_card' | 'product_voucher' | 'point_card' | 'product_discount_card';
+    shop_id?: string;
+    transaction_id?: string;
+    title?: string;
+    created_at?: string;
+    amount?: string;
+    balance?: string;
+    currency_symbol?: string;
+    action?: 'recharge' | 'order_expend' | 'order_refund' | 'expire';
+}
+/**
+ * 资产明细列表
+ * @param params 接口请求参数
+ * @returns 资产明细列表
+ */
+export declare const getAssetList: (params: IAssetListProps) => Promise<{
+    list: IAssetItem[];
+}>;
+/**
+ * 资产明细（admin）
+ */
+export declare const getActiveLogs: (params: {
+    filter_card_id: string;
+}) => Promise<{
+    list: IAssetItem[];
+}>;
+/**
+ * 获取资产详情
+ * @param params 接口请求参数
+ * @returns 资产详情
+ */
+export declare const getDetailApi: (params: {
+    id: string;
+    order_behavior_count_customer_id: string;
+    apiPrefix: string;
+}) => Promise<IDetailResponse>;
+/**
+ * 详情响应数据结构，供组件消费
+ */
+export interface IDetailResponse {
+    detailId?: string;
+    productId?: string;
+    gift_option?: Array<{
+        id: string;
+        name: string;
+        gift_price: number;
+        price: number;
+        variant_id?: string;
+    }>;
+    [key: string]: any;
+}
+interface OrderParams {
+    voucher_id: string;
+    product_id: string;
+    product_variant_id: string;
+    quantity: number;
+    type: string;
+    platform: string;
+    currency_code: {
+        currency_code: string;
+        currency_symbol: string;
+        currency_format: string;
+    };
+}
+interface OrderResponse {
+    order_id: string;
+}
+/**
+ * 下单接口
+ * @param params - 订单参数
+ * @returns 订单响应数据
+ */
+export declare const orderRechargeProduct: (params: OrderParams) => Promise<OrderResponse>;
+/**
+ * @desc: 获取钱包信息
+ * @author: Arthur
+ * @date: 2025-11-03 15:30
+ */
+export declare const getWalletDetail: (id: string | number) => Promise<any>;
+/**
+ * 更新卡券持有人
+ * @param id 卡券ID
+ * @param params 更新参数
+ * @returns 更新结果
+ */
+export declare const updateWalletPassHolder: (id: string, params: any) => Promise<any>;
+/**
+ * 获取卡券详情
+ * @param id 卡券ID
+ * @returns 卡券详情
+ */
+export declare const getWalletPassDetail: (id: string, params: any) => Promise<any>;
+export {};

package/lib/pro/Login2.0/components/PhoneInput.d.ts

@@ -0,0 +1,53 @@
+import React from 'react';
+import './PhoneInput.less';
+/** 国家/地区配置（后端返回格式） */
+export interface CountryOption {
+    /** 国家/地区名称 */
+    name: string;
+    /** 国家/地区代码 */
+    code: string;
+    /** 区号（不带+号） */
+    calling_code: string;
+    /** 货币代码 */
+    currency_code: string;
+}
+/** 手机号对象格式 */
+export interface PhoneValueObject {
+    /** 手机号（不含区号） */
+    phone: string;
+    /** 国家区号（不带+号） */
+    country_calling_code: string;
+}
+/** 值格式类型 */
+export declare type ValueFormat = 'string' | 'object';
+/** 手机号输入组件属性 */
+export interface PhoneInputProps {
+    /** 完整的手机号值（包含区号），格式：+86138****，或 +1555****（字符串模式） */
+    value?: string | PhoneValueObject;
+    /** 值变化回调 */
+    onChange?: (value: string | PhoneValueObject) => void;
+    /** Placeholder */
+    placeholder?: string;
+    /** 大小 */
+    size?: 'large' | 'middle' | 'small';
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 可用的国家/地区列表 */
+    countries?: CountryOption[];
+    /** 默认国家/地区代码 */
+    defaultCountry?: string;
+    /** 值格式：'string' 返回 "+8613800138000"，'object' 返回 { phone: "13800138000", country_calling_code: "86" } */
+    valueFormat?: ValueFormat;
+    /** 键盘按键事件回调 */
+    onKeyDown?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+}
+/**
+ * 手机号输入组件
+ *
+ * 支持国际区号选择和手机号输入
+ * 值格式：+区号+手机号，例如：+8613800138000 或 +15551234567
+ */
+declare function PhoneInput({ value, onChange, placeholder, onKeyDown, size, disabled, className, countries, defaultCountry, valueFormat, }: PhoneInputProps): JSX.Element;
+export default PhoneInput;

package/lib/pro/Login2.0/shared/types.d.ts

@@ -0,0 +1,232 @@
+/**
+ * 登录注册 2.0 共享类型定义
+ */
+/** 验证方式枚举 */
+export declare type VerificationMethod = 'verification_code' | 'password';
+/** 邮箱注册验证方式 */
+export declare type EmailRegistrationVerification = 'verification_link' | 'verification_code' | 'none';
+/** 手机注册验证方式 */
+export declare type PhoneRegistrationVerification = 'verification_code';
+/** 认证方式类型 */
+export declare type AuthMethodType = 'email' | 'phone' | 'google' | 'facebook' | 'apple' | 'guest';
+/** 登录方式项类型 */
+export declare type LoginMethodType = 'email' | 'phone' | 'google' | 'facebook' | 'apple' | 'guest';
+export interface PhoneValueObject {
+    phone: string;
+    country_calling_code: string;
+}
+/** 邮箱登录方式项 */
+export interface EmailLoginMethod {
+    type: 'email';
+    /** 启用的验证方式（按顺序），第一个为默认方式 */
+    verificationMethods: Array<'password' | 'verification_code'>;
+    /** 密码登录是否分步骤填写（先输入邮箱，再输入密码） */
+    stepByStep?: boolean;
+}
+/** 手机登录方式项 */
+export interface PhoneLoginMethod {
+    type: 'phone';
+    /** 启用的验证方式（按顺序），第一个为默认方式 */
+    verificationMethods: Array<'password' | 'verification_code'>;
+    /** 密码登录是否分步骤填写（先输入手机号，再输入密码） */
+    stepByStep?: boolean;
+}
+/** Google 登录方式项 */
+export interface GoogleLoginMethod {
+    type: 'google';
+    /** Google Client ID */
+    clientId?: string;
+}
+/** Facebook 登录方式项 */
+export interface FacebookLoginMethod {
+    type: 'facebook';
+    /** Facebook App ID */
+    appId?: string;
+}
+/** Apple 登录方式项 */
+export interface AppleLoginMethod {
+    type: 'apple';
+    /** Apple Client ID */
+    clientId?: string;
+}
+/** Guest 登录方式项 */
+export interface GuestLoginMethod {
+    type: 'guest';
+}
+/** 注册方式类型 */
+export declare type RegistrationMethodType = 'email' | 'phone' | 'google' | 'facebook' | 'apple';
+/** 邮箱注册方式项 */
+export interface EmailRegistrationMethod {
+    type: 'email';
+    /** 注册验证方式（邮箱支持验证链接/验证码/无需验证） */
+    verificationMethod: 'verification_link' | 'verification_code' | 'none';
+}
+/** 手机注册方式项 */
+export interface PhoneRegistrationMethod {
+    type: 'phone';
+    /** 注册验证方式（手机仅支持验证码） */
+    verificationMethod: 'verification_code';
+}
+/** Google 注册方式项 */
+export interface GoogleRegistrationMethod {
+    type: 'google';
+    /** Google Client ID */
+    clientId?: string;
+}
+/** Facebook 注册方式项 */
+export interface FacebookRegistrationMethod {
+    type: 'facebook';
+    /** Facebook App ID */
+    appId?: string;
+}
+/** Apple 注册方式项 */
+export interface AppleRegistrationMethod {
+    type: 'apple';
+    /** Apple Client ID */
+    clientId?: string;
+}
+/** 注册方式项联合类型 */
+export declare type RegistrationMethodItem = EmailRegistrationMethod | PhoneRegistrationMethod | GoogleRegistrationMethod | FacebookRegistrationMethod | AppleRegistrationMethod;
+/** 法律条款项 */
+export interface LegalTermItem {
+    /** 条款名称 - 支持国际化对象或简单字符串 */
+    name: string | {
+        en?: string;
+        'zh-CN'?: string;
+        'zh-HK'?: string;
+        original?: string;
+    };
+    /** 条款链接 */
+    url: string;
+}
+/** 法律条款配置 */
+export interface LegalTermsConfig {
+    /** 是否显示法律条款区域 */
+    enabled?: boolean;
+    /** 法律条款列表 */
+    terms?: LegalTermItem[];
+    /** 条款文本模板 */
+    textTemplate?: string;
+    /** 当前模式：login 或 register */
+    mode?: 'login' | 'register';
+}
+/** 登录方式项联合类型 */
+export declare type LoginMethodItem = EmailLoginMethod | PhoneLoginMethod | GoogleLoginMethod | FacebookLoginMethod | AppleLoginMethod | GuestLoginMethod;
+/** 邮箱认证配置 */
+export interface EmailAuthConfig {
+    /** 是否启用邮箱认证 */
+    enable_email: boolean;
+    /** 注册验证方式 */
+    registration_verification?: EmailRegistrationVerification;
+    /** 登录验证方式列表 */
+    login_verification_methods?: VerificationMethod[];
+}
+/** 手机认证配置 */
+export interface PhoneAuthConfig {
+    /** 是否启用手机认证 */
+    enable_phone_number: boolean;
+    /** 注册验证方式 */
+    registration_verification?: PhoneRegistrationVerification;
+    /** 登录验证方式列表 */
+    login_verification_methods?: VerificationMethod[];
+}
+/** 三方 OAuth 配置 */
+export interface OAuthConfig {
+    /** Google 登录 */
+    google?: {
+        enabled: boolean;
+        client_id?: string;
+    };
+    /** Facebook 登录 */
+    facebook?: {
+        enabled: boolean;
+        app_id?: string;
+    };
+    /** Apple 登录 */
+    apple?: {
+        enabled: boolean;
+        client_id?: string;
+    };
+}
+/** UI 配置 */
+export interface UIConfig {
+    /** Logo 配置 */
+    logo?: {
+        show: boolean;
+        url?: string;
+        position?: 'left' | 'center' | 'right';
+        size?: {
+            width: number;
+            height: number;
+        };
+    };
+    /** 标题配置 */
+    title?: {
+        show: boolean;
+        text?: string;
+        align?: 'left' | 'center' | 'right';
+    };
+    /** 副标题配置 */
+    subtitle?: {
+        show: boolean;
+        text?: string;
+        align?: 'left' | 'center' | 'right';
+    };
+    /** 描述配置 */
+    desc?: {
+        show: boolean;
+        text?: string;
+        align?: 'left' | 'center' | 'right';
+    };
+    /** 表单标签配置 */
+    formLabels?: {
+        /** 邮箱标签配置 */
+        email?: {
+            show: boolean;
+            text?: string;
+        };
+        /** 手机标签配置 */
+        phone?: {
+            show: boolean;
+            text?: string;
+        };
+        /** 密码标签配置 */
+        password?: {
+            show: boolean;
+            text?: string;
+        };
+        /** 验证码标签配置 */
+        verificationCode?: {
+            show: boolean;
+            text?: string;
+        };
+    };
+    /** 密码规则 */
+    passwordRules?: any;
+    /** 主题色 */
+    themeColor?: string;
+}
+/** 登录表单数据 */
+export interface LoginFormData {
+    /** 邮箱或手机号 */
+    account: string | PhoneValueObject;
+    /** 密码 */
+    password?: string;
+    /** 验证码 */
+    verification_code?: string;
+    /** 记住我 */
+    remember_me?: boolean;
+}
+/** 注册表单数据 */
+export interface RegisterFormData {
+    /** 邮箱或手机号 */
+    account: string;
+    /** 密码 */
+    password?: string;
+    /** 确认密码 */
+    confirm_password?: string;
+    /** 验证码 */
+    verification_code?: string;
+    /** 验证链接 token */
+    verification_token?: string;
+}

package/lib/pro/NumericStepper/index.d.ts

@@ -0,0 +1,68 @@
+import * as React from 'react';
+import './index.less';
+declare global {
+    namespace JSX {
+        interface IntrinsicElements {
+            [elemName: string]: any;
+        }
+    }
+}
+/**
+ * 样式变体类型
+ * - separated: 分离式，按钮独立显示（默认）
+ * - capsule: 胶囊式，按钮和数字在一个圆角容器内
+ */
+export declare type NumericStepperVariant = 'separated' | 'capsule';
+export interface NumericStepperProps {
+    /** 当前值 */
+    value?: number;
+    /** 默认值 */
+    defaultValue?: number;
+    /** 最小值 */
+    min?: number;
+    /** 最大值 */
+    max?: number;
+    /** 步长 */
+    step?: number;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 值变化回调 */
+    onChange?: (value: number) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    styles?: {
+        container?: React.CSSProperties;
+    };
+    horizontalPadding?: number | string;
+    /** 尺寸 */
+    size?: 'small' | 'middle' | 'large';
+    /** 按钮形状（仅在 variant='separated' 时生效） */
+    shape?: 'round' | 'square';
+    /** 减号按钮的自定义内容 */
+    minusIcon?: React.ReactNode;
+    /** 加号按钮的自定义内容 */
+    plusIcon?: React.ReactNode;
+    /**
+     * 样式变体
+     * - separated: 分离式，按钮独立显示（默认）
+     * - capsule: 胶囊式，按钮和数字在一个圆角容器内
+     * @default 'separated'
+     */
+    variant?: NumericStepperVariant;
+    /**
+     * 是否启用输入功能（点击数字弹出键盘）
+     * - 开启时：展示区域 cursor 为 pointer，点击弹出键盘
+     * - 关闭后：展示区域无边框，点击不会弹出键盘
+     * @default true
+     */
+    enableInput?: boolean;
+    /**
+     * 展示区域最大宽度（仅胶囊模式生效）
+     * - 设置后：展示区域最大宽度受限，超出部分截断
+     * - 不设置：展示区域宽度随内容自适应
+     */
+    displayMaxWidth?: number | string;
+}
+declare const NumericStepper: React.FC<NumericStepperProps>;
+export default NumericStepper;

package/lib/pro/Selector/Selector.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { ItemLayout, ItemProps, PresetConfig, SelectorProps, SelectorVariant } from './types';
+import './selector.less';
+export declare const SelectorContext: React.Context<{
+    disabled?: boolean | undefined;
+    mode?: "multiple" | "single" | undefined;
+    itemLayout?: ItemLayout | undefined;
+    valueType?: "object" | "primitive" | undefined;
+    variant?: SelectorVariant | undefined;
+    itemProps?: ItemProps | undefined;
+    preset?: PresetConfig | undefined;
+}>;
+declare const Selector: React.ForwardRefExoticComponent<SelectorProps<import("./types").OptionKey> & React.RefAttributes<unknown>>;
+export default Selector;

package/lib/pro/Selector/Selector.stories.d.ts

@@ -0,0 +1,78 @@
+import { Meta, StoryObj } from '@storybook/react';
+import Selector from './index';
+/**
+ * Selector 组件 - 高级选择器
+ *
+ * 支持单选/多选、数量控制、校验规则、互斥组等功能
+ *
+ * 查看文档：
+ * - [开发文档](https://studio.picoding-dev.com/pro-components/selector?tab=dev)
+ * - [需求文档](https://m1ed09stz4r.feishu.cn/wiki/NL5AwOs0ei5ZBekT4i6cuzIOnoM)
+ */
+declare const meta: Meta<typeof Selector>;
+export default meta;
+declare type Story = StoryObj<typeof Selector>;
+/**
+ * 默认单选模式 - 原始值类型
+ */
+export declare const Default: Story;
+/**
+ * 多选模式 - 原始值数组
+ */
+export declare const Multiple: Story;
+/**
+ * 单选 + 数量 - 对象值类型
+ */
+export declare const SingleWithQuantity: Story;
+/**
+ * 多选 + 数量 - 卡片样式
+ */
+export declare const MultipleWithQuantity: Story;
+/**
+ * 网格布局 - 2列
+ */
+export declare const GridLayout2Columns: Story;
+/**
+ * 网格布局 - 3列
+ */
+export declare const GridLayout3Columns: Story;
+/**
+ * 校验规则 - 必选、最小/最大数量
+ */
+export declare const WithValidation: Story;
+/**
+ * 互斥组 - 同组只能选一个
+ */
+export declare const MutexGroups: Story;
+/**
+ * 禁用状态
+ */
+export declare const Disabled: Story;
+/**
+ * Select 变体 - 下拉选择
+ */
+export declare const SelectVariant: Story;
+/**
+ * Select 变体 - 多选下拉
+ */
+export declare const SelectVariantMultiple: Story;
+/**
+ * 卡片样式变体 - 不同选中态
+ */
+export declare const CardVariants: Story;
+/**
+ * 自定义图标
+ */
+export declare const CustomIcon: Story;
+/**
+ * 自定义渲染
+ */
+export declare const CustomRender: Story;
+/**
+ * SelectorGroup 基础示例
+ */
+export declare const SelectorGroupBasic: StoryObj;
+/**
+ * SelectorGroup 联动规则示例
+ */
+export declare const SelectorGroupWithLinkage: StoryObj;