@pisell/private-materials 6.3.75 → 6.3.76

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/Login2.0/steps/EmailAlreadyRegistered.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+import type { RegisterFlowData } from '../shared/registerFlow';
+export interface EmailAlreadyRegisteredProps {
+    /** 流程数据 */
+    flowData: RegisterFlowData;
+    /** 跳转到登录 */
+    onGoToLogin?: () => void;
+    /** 返回重新输入 */
+    onBack?: () => void;
+}
+declare function EmailAlreadyRegistered({ flowData, onGoToLogin, onBack, }: EmailAlreadyRegisteredProps): JSX.Element;
+export default EmailAlreadyRegistered;

package/lib/pro/Login2.0/steps/VerificationSuccess.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="react" />
+import type { RegisterFlowData } from '../shared/registerFlow';
+export interface VerificationSuccessProps {
+    /** 流程数据 */
+    flowData: RegisterFlowData;
+}
+declare function VerificationSuccess({ flowData }: VerificationSuccessProps): JSX.Element;
+export default VerificationSuccess;

package/lib/pro/Login2.0/steps/VerifyingEmailLink.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="react" />
+export interface VerifyingEmailLinkProps {
+    /** 加载提示文本（可选，不传则使用国际化默认文本） */
+    loadingText?: string;
+}
+declare function VerifyingEmailLink({ loadingText }: VerifyingEmailLinkProps): JSX.Element;
+export default VerifyingEmailLink;

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

@@ -0,0 +1,18 @@
+/// <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/lib/pro/Login2.0/steps/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 注册流程步骤组件导出
+ */
+export { default as WaitEmailLink } from './WaitEmailLink';
+export { default as EmailAlreadyRegistered } from './EmailAlreadyRegistered';
+export { default as CodeInput } from './CodeInput';
+export { default as VerificationSuccess } from './VerificationSuccess';
+export { default as SetPassword } from './SetPassword';
+export { default as VerifyingEmailLink } from './VerifyingEmailLink';
+export { default as EmailLinkExpired } from './EmailLinkExpired';
+export { default as EmailLinkAlreadyUsed } from './EmailLinkAlreadyUsed';
+export type { WaitEmailLinkProps } from './WaitEmailLink';
+export type { EmailAlreadyRegisteredProps } from './EmailAlreadyRegistered';
+export type { CodeInputProps } from './CodeInput';
+export type { VerificationSuccessProps } from './VerificationSuccess';
+export type { SetPasswordProps } from './SetPassword';
+export type { VerifyingEmailLinkProps } from './VerifyingEmailLink';
+export type { EmailLinkExpiredProps } from './EmailLinkExpired';
+export type { EmailLinkAlreadyUsedProps } from './EmailLinkAlreadyUsed';

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

@@ -0,0 +1,167 @@
+/**
+ * 登录注册 2.0 组件类型定义
+ */
+/// <reference types="react" />
+/** 验证方式枚举 */
+export declare type VerificationMethod = 'verification_code' | 'password';
+/** 邮箱注册验证方式 */
+export declare type EmailRegistrationVerification = 'verification_link' | 'verification_code';
+/** 认证方式类型 */
+export declare type AuthMethodType = 'email' | 'phone' | 'google' | 'facebook' | 'apple';
+/** 当前状态：登录或注册 */
+export declare type AuthState = 'login' | 'register';
+/** 邮箱认证配置 */
+export interface EmailAuthConfig {
+    /** 是否启用邮箱认证 */
+    enable_email: boolean;
+    /** 注册验证方式 */
+    registration_verification: EmailRegistrationVerification;
+    /** 登录验证方式列表 */
+    login_verification_methods: VerificationMethod[];
+}
+/** 手机认证配置 */
+export interface PhoneAuthConfig {
+    /** 是否启用手机认证 */
+    enable_phone_number: boolean;
+    /** 注册验证方式（手机仅支持验证码） */
+    registration_verification: 'verification_code';
+    /** 登录验证方式列表 */
+    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';
+    };
+    /** 标签页配置 */
+    tabs?: {
+        show: boolean;
+        loginText?: string;
+        registerText?: string;
+    };
+    /** 主题色 */
+    themeColor?: string;
+}
+/** 组件总配置 */
+export interface Login2Config {
+    /** 邮箱认证配置 */
+    email?: EmailAuthConfig;
+    /** 手机认证配置 */
+    phone?: PhoneAuthConfig;
+    /** 三方 OAuth 配置 */
+    oauth?: OAuthConfig;
+    /** UI 配置 */
+    ui?: UIConfig;
+    /** 默认认证方式 */
+    defaultAuthMethod?: AuthMethodType;
+    /** 默认状态（登录或注册） */
+    defaultState?: AuthState;
+}
+/** 登录表单数据 */
+export interface LoginFormData {
+    /** 邮箱或手机号 */
+    account: string;
+    /** 密码 */
+    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;
+}
+/** 组件事件回调 */
+export interface Login2Events {
+    /** 登录回调 */
+    onLogin?: (data: LoginFormData, method: AuthMethodType) => Promise<void> | void;
+    /** 注册回调 */
+    onRegister?: (data: RegisterFormData, method: AuthMethodType) => Promise<void> | void;
+    /** 三方登录回调 */
+    onOAuthLogin?: (provider: 'google' | 'facebook' | 'apple') => Promise<void> | void;
+    /** 发送验证码回调 */
+    onSendVerificationCode?: (account: string, type: 'email' | 'phone') => Promise<void> | void;
+    /** 忘记密码回调 */
+    onForgotPassword?: (account: string) => Promise<void> | void;
+}
+/** 组件完整属性 */
+export interface Login2Props extends Login2Events {
+    /** 配置对象 */
+    config: Login2Config;
+    /** 是否显示 */
+    visible?: boolean;
+    /** 关闭回调 */
+    onClose?: () => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+/** 组件内部状态 */
+export interface Login2State {
+    /** 当前状态：登录或注册 */
+    authState: AuthState;
+    /** 当前认证方式 */
+    currentAuthMethod: AuthMethodType;
+    /** 当前使用的验证方式 */
+    currentVerificationMethod: VerificationMethod;
+    /** 加载状态 */
+    loading: boolean;
+    /** 验证码倒计时 */
+    countdown: number;
+    /** 表单数据 */
+    formData: Partial<LoginFormData | RegisterFormData>;
+}

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

@@ -0,0 +1,43 @@
+import * as React from 'react';
+import './index.less';
+declare global {
+    namespace JSX {
+        interface IntrinsicElements {
+            [elemName: string]: any;
+        }
+    }
+}
+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;
+    };
+    /** 尺寸 */
+    size?: 'small' | 'middle' | 'large';
+    /** 按钮形状 */
+    shape?: 'round' | 'square';
+    /** 是否显示输入框 */
+    showInput?: boolean;
+    /** 减号按钮的自定义内容 */
+    minusIcon?: React.ReactNode;
+    /** 加号按钮的自定义内容 */
+    plusIcon?: React.ReactNode;
+}
+declare const NumericStepper: React.FC<NumericStepperProps>;
+export default NumericStepper;

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

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

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

@@ -0,0 +1,14 @@
+import React from 'react';
+import { OptionItem } from './types';
+export interface IItemProps {
+    actions: any;
+    dataSource: OptionItem;
+    indicator: React.ReactNode;
+    numberSelector: React.ReactNode;
+    optionItemValue?: any;
+    quantityInfo: any;
+    values: any;
+    children?: React.ReactNode;
+}
+declare const Item: (props: IItemProps) => JSX.Element;
+export default Item;

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;

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

@@ -0,0 +1,11 @@
+import React from 'react';
+import { SelectionValue, SelectorGroupProps } from './types';
+import './selectorGroup.less';
+export declare type SelectorGroupRef = {
+    getValues: (includeHidden?: boolean) => Record<string, SelectionValue>;
+    setValues: (values: Record<string, SelectionValue>) => void;
+    validate: () => Promise<Record<string, never>>;
+    reset: () => void;
+};
+declare const SelectorGroup: React.ForwardRefExoticComponent<Omit<SelectorGroupProps, "ref"> & React.RefAttributes<SelectorGroupRef>>;
+export default SelectorGroup;