@pisell/private-materials 6.3.147 → 6.3.149

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

@@ -1,53 +0,0 @@
-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/es/pro/Login2.0/components/phoneValidation.d.ts

@@ -1,17 +0,0 @@
-import { PhoneValueObject } from './PhoneInput';
-declare type GetTextFunction = (key: string) => string;
-/**
- * 手机号校验函数，用于 Ant Design Form 的 rules
- * @param value 手机号值，可以是字符串或对象格式
- * @param getText 国际化文本获取函数
- * @returns Promise<void> 校验通过时 resolve，失败时 reject 并返回错误信息
- */
-export declare const validatePhoneNumber: (value: string | PhoneValueObject, getText: GetTextFunction) => Promise<void>;
-/**
- * 创建手机号校验规则，用于 Form.Item 的 rules 属性
- * @param getText 国际化文本获取函数
- * @param required 是否必填
- * @returns Form 校验规则数组
- */
-export declare const createPhoneValidationRules: (getText: GetTextFunction, required?: boolean) => any[];
-export {};

package/es/pro/Login2.0/shared/registerFlow.d.ts

@@ -1,117 +0,0 @@
-/**
- * 注册流程配置和状态管理
- * 支持多种验证方式的不同步骤流程
- */
-import type { PhoneValueObject } from './types';
-/** 注册步骤类型 */
-export declare enum RegisterStep {
-    /** 初始表单 - 输入账号密码 */
-    INITIAL_FORM = "INITIAL_FORM",
-    /** 等待邮件链接验证 */
-    WAIT_EMAIL_LINK = "WAIT_EMAIL_LINK",
-    /** 输入验证码 */
-    INPUT_VERIFICATION_CODE = "INPUT_VERIFICATION_CODE",
-    /** 验证成功提示 */
-    VERIFICATION_SUCCESS = "VERIFICATION_SUCCESS",
-    /** 设置密码 */
-    SET_PASSWORD = "SET_PASSWORD",
-    /** 邮箱已注册错误 */
-    EMAIL_ALREADY_REGISTERED = "EMAIL_ALREADY_REGISTERED",
-    /** 注册完成 */
-    COMPLETE = "COMPLETE"
-}
-/** 验证方式类型 */
-export declare enum VerificationMethod {
-    /** 邮件链接验证 */
-    EMAIL_LINK = "EMAIL_LINK",
-    /** 邮箱验证码验证 */
-    EMAIL_CODE = "EMAIL_CODE",
-    /** 手机验证码验证 */
-    PHONE_CODE = "PHONE_CODE",
-    /** 密码验证（无需验证码） */
-    PASSWORD_ONLY = "PASSWORD_ONLY"
-}
-/** 注册流程配置 */
-export interface RegisterFlowConfig {
-    /** 验证方式 */
-    verificationMethod: VerificationMethod;
-    /** 是否需要密码（某些流程可能在验证后才设置密码） */
-    requirePasswordAtStart?: boolean;
-    /** 自动跳转设置（某些步骤后自动跳转到下一步） */
-    autoTransition?: {
-        [key in RegisterStep]?: {
-            delay: number;
-            nextStep: RegisterStep;
-        };
-    };
-}
-/** 注册流程步骤定义 */
-export interface RegisterStepDefinition {
-    /** 步骤标识 */
-    step: RegisterStep;
-    /** 步骤显示的组件类型 */
-    component: 'form' | 'waiting' | 'error' | 'success' | 'code-input' | 'password-set';
-    /** 步骤配置 */
-    config?: {
-        /** 是否显示返回按钮 */
-        showBack?: boolean;
-        /** 是否显示关闭按钮 */
-        showClose?: boolean;
-        /** 是否可以编辑账号 */
-        canEditAccount?: boolean;
-        /** 是否显示重发按钮 */
-        showResend?: boolean;
-    };
-}
-/** 注册流程数据 */
-export interface RegisterFlowData {
-    /** 当前步骤 */
-    currentStep: RegisterStep;
-    /** 账号（邮箱字符串或手机号对象） */
-    account: string | PhoneValueObject;
-    /** 账号类型 */
-    accountType: 'email' | 'phone';
-    /** 密码（如果在第一步就输入了） */
-    password?: string;
-    /** 验证码 */
-    verificationCode?: string;
-    /** 邮件链接验证码 */
-    emailLinkCode?: string;
-    /** 验证方式 */
-    verificationMethod: VerificationMethod;
-    /** 错误信息 */
-    error?: {
-        code: string;
-        message: string;
-    };
-    /** 额外数据 */
-    extraData?: Record<string, any>;
-}
-/** 预定义流程配置 */
-export declare const REGISTER_FLOW_CONFIGS: Record<VerificationMethod, RegisterFlowConfig>;
-/** 步骤流转映射 */
-export declare const STEP_TRANSITIONS: Record<VerificationMethod, Record<RegisterStep, RegisterStep[]>>;
-/** 步骤定义映射 */
-export declare const STEP_DEFINITIONS: Record<RegisterStep, RegisterStepDefinition>;
-/**
- * 验证步骤流转是否合法
- */
-export declare function isValidTransition(verificationMethod: VerificationMethod, fromStep: RegisterStep, toStep: RegisterStep): boolean;
-/**
- * 获取步骤配置
- */
-export declare function getStepDefinition(step: RegisterStep): RegisterStepDefinition;
-/**
- * 获取流程配置
- */
-export declare function getFlowConfig(verificationMethod: VerificationMethod): RegisterFlowConfig;
-/**
- * 根据认证配置决定使用哪种验证方式
- */
-export declare function determineVerificationMethod(accountType: 'email' | 'phone', emailConfig?: {
-    enable_email?: boolean;
-    require_email_verification?: boolean;
-}, phoneConfig?: {
-    enable_phone_number?: boolean;
-    require_phone_verification?: boolean;
-}): VerificationMethod;

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

@@ -1,234 +0,0 @@
-/**
- * 登录注册 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/es/pro/Login2.0/steps/CodeInput.d.ts

@@ -1,24 +0,0 @@
-/// <reference types="react" />
-import type { RegisterFlowData } from '../shared/registerFlow';
-export interface CodeInputProps {
-    /** 流程数据 */
-    flowData: RegisterFlowData;
-    /** 验证码长度 */
-    codeLength?: number;
-    /** 提交验证码 */
-    onSubmit?: (code: string) => void;
-    /** 重新发送 */
-    onResend?: () => void;
-    /** 返回 */
-    onBack?: () => void;
-    /** 倒计时秒数 */
-    countdown?: number;
-    /** 加载状态 */
-    loading?: boolean;
-    /** 错误信息 */
-    error?: string;
-    /** 当用户输入时清除错误的回调 */
-    onClearError?: () => void;
-}
-declare function CodeInput({ flowData, codeLength, onSubmit, onResend, onBack, countdown, loading, error, onClearError, }: CodeInputProps): JSX.Element;
-export default CodeInput;

package/es/pro/Login2.0/steps/WaitEmailLink.d.ts

@@ -1,18 +0,0 @@
-/// <reference types="react" />
-import type { RegisterFlowData, VerificationMethod } from '../shared/registerFlow';
-export interface WaitEmailLinkProps {
-    /** 流程数据 */
-    flowData: RegisterFlowData;
-    /** 重新发送 */
-    onResend?: () => void;
-    /** 返回 */
-    onBack?: () => void;
-    /** 编辑邮箱 */
-    onEditEmail?: () => void;
-    /** 倒计时秒数 */
-    countdown?: number;
-    /** 验证方式 */
-    verificationMethod?: VerificationMethod;
-}
-declare function WaitEmailLink({ flowData, onResend, onBack, onEditEmail, countdown, verificationMethod, }: WaitEmailLinkProps): JSX.Element;
-export default WaitEmailLink;

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

@@ -1,96 +0,0 @@
-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/es/pro/Selector/Selector.stories.d.ts

@@ -1,78 +0,0 @@
-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/es/pro/Selector/hooks/usePresetProps.d.ts

@@ -1,24 +0,0 @@
-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/es/pro/pisellNumberSelector/example.d.ts

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

package/es/test/setup.d.ts

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