@pisell/private-materials 6.3.146 → 6.3.147

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

@@ -0,0 +1,234 @@
+/**
+ * 登录注册 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;
+        'ja'?: string;
+        'pt'?: 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,96 @@
+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 NumericStepperChangeMeta {
+    action: 'increase' | 'decrease' | 'input';
+    event?: React.MouseEvent<HTMLDivElement>;
+}
+/**
+ * 达到上/下限时触发的额外上下文。
+ * - reason='max': 已达最大值（还想继续增加）
+ * - reason='min': 已达最小值（还想继续减少）
+ */
+export interface NumericStepperLimitExceededMeta {
+    reason: 'max' | 'min';
+    currentValue: number;
+    min: number;
+    max: number;
+    event?: React.MouseEvent<HTMLDivElement>;
+}
+export interface NumericStepperProps {
+    /** 当前值 */
+    value?: number;
+    /** 默认值 */
+    defaultValue?: number;
+    /** 最小值 */
+    min?: number;
+    /** 最大值 */
+    max?: number;
+    /** 步长 */
+    step?: number;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 值变化回调 */
+    onChange?: (value: number, meta?: NumericStepperChangeMeta) => void;
+    /**
+     * 达到 min/max 限制时点击对应按钮的回调。
+     * - 仅在 currentValue 已到达上/下限时触发，不会再触发 onChange。
+     * - 组件本身未被 `disabled` 整体禁用时才会触发；整体 `disabled` 仍保持"完全屏蔽"语义。
+     * 常见用途：在加号被禁用时弹出 toast 告知用户已达限购上限。
+     */
+    onLimitExceeded?: (meta: NumericStepperLimitExceededMeta) => void;
+    /** 自定义类名 */
+    className?: string;
+    theme?: {
+        token?: {
+            colorPrimary?: 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.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;

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

@@ -0,0 +1,24 @@
+import { LayoutConfig, ItemLayout, PresetConfig, SelectorVariant, SelectorProps } from '../types';
+interface UsePresetPropsParams {
+    layout?: LayoutConfig;
+    mode?: 'single' | 'multiple';
+    preset?: PresetConfig;
+    itemLayout?: ItemLayout;
+    variant?: SelectorVariant;
+    indicatorProps?: SelectorProps['indicatorProps'];
+}
+interface UsePresetPropsResult {
+    layout: LayoutConfig | null;
+    indicatorProps: SelectorProps['indicatorProps'];
+}
+/**
+ * 根据预设配置生成 layout 和 indicatorProps
+ * Layout 规则：
+ * - 根据 variant 和 preset.variant 计算布局样式
+ * IndicatorProps 规则：
+ * 1. 当 variant='card' 且 preset.variant='2' 时，indicator 默认 variant='filled'
+ * 2. 当 variant='media' 时，indicator 默认 variant='filled'
+ * 3. 外部传入的 indicatorProps 优先级更高（会合并到预设配置中）
+ */
+declare const usePresetProps: ({ layout, mode, preset, itemLayout, variant, indicatorProps, }: UsePresetPropsParams) => UsePresetPropsResult;
+export default usePresetProps;

package/lib/pro/pisellNumberSelector/example.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const Example: React.FC;
+export default Example;

package/lib/pro/pisellPaymentList/example.d.ts

@@ -4,6 +4,7 @@
  * 这个文件演示了如何使用 PisellPaymentList 和 PisellPaymentListItem 组件
  * 包括如何通过 Context 访问父组件配置
  */
+/// <reference types="react" />
 export declare const BasicExample: () => JSX.Element;
 export declare const ChildrenExample: () => JSX.Element;
 export declare const CustomItemExample: () => JSX.Element;

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

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

package/lib/test/setup.d.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom/vitest';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pisell/private-materials",
-  "version": "6.3.146",
+  "version": "6.3.147",
   "scripts": {
     "dev": "father dev",
     "build": "father build",