@pisell/private-materials 6.8.14 → 6.8.16

package/es/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/es/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/es/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/es/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/es/pro/NumberKeyboardPopover/types.d.ts

@@ -0,0 +1,31 @@
+/// <reference types="react" />
+export interface NumberKeyboardPopoverProps {
+    /** 触发元素 */
+    children: React.ReactNode;
+    /** 当前值 */
+    value?: string;
+    /** 值变化回调 */
+    onChange?: (value: string) => void;
+    /** 确认回调 */
+    onConfirm?: (value: string) => void;
+    /** 取消回调 */
+    onCancel?: () => void;
+    /** 是否允许小数 */
+    allowDecimal?: boolean;
+    /** 小数位数 */
+    decimalPlaces?: number;
+    /** 键盘主题 */
+    selectType?: 'light' | 'dark';
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** Popover 额外的类名 */
+    overlayClassName?: string;
+}
+export interface NumberKeyboardPopoverRef {
+    /** 打开键盘 */
+    open: () => void;
+    /** 关闭键盘 */
+    close: () => void;
+    /** 获取当前是否打开 */
+    isOpen: () => boolean;
+}

package/es/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/es/pro/Selector/BatchSelectorDemo.d.ts

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

package/es/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/es/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/es/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/es/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;

package/es/pro/Selector/components/Card/index.d.ts

@@ -0,0 +1,57 @@
+import React from 'react';
+import './index.less';
+export declare type CardVariant = 'outlined' | 'borderless';
+export declare type CardLayout = 'vertical' | 'horizontal';
+export declare type SelectedType = 'none' | 'outlined' | 'outlined-bold' | 'filled';
+export declare type ActionsPosition = 'left' | 'right';
+export interface CardStyles {
+    container?: React.CSSProperties | ((props: CardStyleProps) => React.CSSProperties);
+    content?: React.CSSProperties | ((props: CardStyleProps) => React.CSSProperties);
+    actions?: React.CSSProperties | ((props: CardStyleProps) => React.CSSProperties);
+    corner?: React.CSSProperties | ((props: CardStyleProps) => React.CSSProperties);
+}
+export interface CardStyleProps {
+    selected?: boolean;
+    disabled?: boolean;
+    hoverable?: boolean;
+    variant?: CardVariant;
+    layout?: CardLayout;
+}
+export interface CardProps {
+    /** 卡片变体样式 */
+    variant?: CardVariant;
+    /** 布局方向 */
+    layout?: CardLayout;
+    /** 操作按钮区域，水平模式在右侧，垂直模式在底部 */
+    actions?: React.ReactNode[];
+    /** 水平模式下，操作按钮的位置 */
+    actionsPosition?: ActionsPosition;
+    /** 垂直模式下，右上角绝对定位展示的组件 */
+    corner?: React.ReactNode;
+    /** 子内容 */
+    children?: React.ReactNode;
+    /** 选中状态 */
+    selected?: boolean;
+    /** 禁用状态 */
+    disabled?: boolean;
+    /** 是否可悬停 */
+    hoverable?: boolean;
+    /** 点击事件 */
+    onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
+    /** 自定义样式 */
+    styles?: CardStyles;
+    /**
+     * 选中时的样式类型
+     * - none: 无样式
+     * - outlined: 边框高亮
+     * - outlined-bold: 边框高亮 + 加粗（使用 outline 实现，不影响布局）
+     * - filled: 填充背景色
+     */
+    selectedType?: SelectedType;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+declare const Card: React.FC<CardProps>;
+export default Card;

package/es/pro/Selector/components/Card/types.d.ts

@@ -0,0 +1 @@
+export type { CardVariant, CardLayout, SelectedType, ActionsPosition, CardStyles, CardStyleProps, CardProps, } from './index';

package/es/pro/Selector/components/Indicator/index.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import './index.less';
+export interface IndicatorProps {
+    mode?: 'single' | 'multiple';
+    variant?: 'outlined' | 'filled';
+    defaultChecked?: boolean;
+    checked?: boolean;
+    disabled?: boolean;
+    onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    className?: string;
+    styles?: {
+        container?: React.CSSProperties;
+        indicator?: React.CSSProperties;
+    };
+    children?: React.ReactNode;
+    size?: 'small' | 'middle' | 'large' | number;
+}
+declare const Indicator: React.FC<IndicatorProps>;
+export default Indicator;

package/es/pro/Selector/components/IntersectionObserver.d.ts

@@ -0,0 +1,105 @@
+/**
+ * IntersectionObserver 组件
+ * 用于监听一组 DOM 元素的可见性状态，并获取第一个可见元素的索引。
+ * @example
+ * function App() {
+ *   return (
+ *     <IntersectionObserverProvider
+ *       onFirstVisibleIndexChange={(index) => {
+ *         console.log('第一个可见元素的索引:', index);
+ *       }}
+ *       rootMargin="0px 0px -10% 0px" // 自定义根边距
+ *     >
+ *       <ScrollContainer>
+ *         {items.map((item, index) => (
+ *           <IntersectionItem key={item.id} index={index}>
+ *             <ItemComponent data={item} />
+ *           </IntersectionItem>
+ *         ))}
+ *       </ScrollContainer>
+ *     </IntersectionObserverProvider>
+ *   );
+ * }
+ */
+import React from 'react';
+import type { ReactNode, CSSProperties } from 'react';
+declare global {
+    interface Window {
+        IntersectionObserver: typeof IntersectionObserver;
+    }
+}
+/**
+ * 元素信息接口
+ */
+interface ElementInfo {
+    element: HTMLElement;
+    index: number;
+    isVisible: boolean;
+}
+/**
+ * IntersectionObserver 上下文值接口
+ */
+interface IntersectionObserverContextValue {
+    /** 是否已初始化 */
+    initialized: boolean;
+    /** 注册元素 */
+    registerElement: (element: HTMLElement, index: number) => void;
+    /** 注销元素 */
+    unregisterElement: (element: HTMLElement) => void;
+    /** 批量注册元素 */
+    registerElements: (elements: Array<{
+        element: HTMLElement;
+        index: number;
+    }>) => void;
+    /** 清除所有注册的元素 */
+    clearAll: () => void;
+    /** 第一个可见元素的索引，-1 表示没有可见元素 */
+    firstVisibleIndex: number;
+}
+/**
+ * IntersectionObserver Provider 属性接口
+ */
+interface IntersectionObserverProps {
+    children: ReactNode;
+    /** 根容器，默认为视口 */
+    root?: Element | null;
+    /** 根边距 */
+    rootMargin?: string;
+    /** 阈值 */
+    threshold?: number | number[];
+    /** 第一个可见元素索引变化时的回调 */
+    onFirstVisibleIndexChange?: (index: number) => void;
+    /** 是否禁用组件，禁用后不会创建 IntersectionObserver */
+    disabled?: boolean;
+}
+/**
+ * IntersectionItem 组件属性接口
+ */
+interface IntersectionItemProps {
+    /** 元素索引 */
+    index: number;
+    /** 子元素 */
+    children?: ReactNode;
+    /** 类名 */
+    className?: string;
+    /** 样式 */
+    style?: CSSProperties;
+}
+/**
+ * IntersectionObserver 上下文
+ */
+declare const IntersectionObserverContext: React.Context<IntersectionObserverContextValue>;
+export declare const IntersectionObserverProvider: React.FC<IntersectionObserverProps>;
+/**
+ * 使用 IntersectionObserver 的 Hook
+ * @returns {Object} 包含注册元素函数和第一个可见元素索引的对象
+ */
+export declare const useIntersectionObserver: () => IntersectionObserverContextValue;
+/**
+ * IntersectionItem 组件
+ * 自动注册元素到 IntersectionObserver 中
+ */
+export declare const IntersectionItem: React.FC<IntersectionItemProps>;
+export type { IntersectionObserverProps, IntersectionItemProps, IntersectionObserverContextValue, ElementInfo, };
+export { IntersectionObserverContext, };
+export default IntersectionObserverProvider;

package/es/pro/Selector/components/LayoutContainer/index.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { LayoutConfig } from '../../types';
+interface LayoutContainerProps {
+    className: string;
+    config: LayoutConfig | null;
+    children: React.ReactNode[];
+}
+/**
+ * 统一的布局容器组件
+ *
+ * 支持两种布局模式：
+ * 1. Custom 布局（推荐）：通过 className 使用预设样式，containerStyle
+ * 2. Ant Design Grid 布局：基础的栅格布局，用于简单场景
+ */
+declare function LayoutContainer({ className: containerClassName, config, children, }: LayoutContainerProps): React.ReactElement | null;
+export default LayoutContainer;

package/es/pro/Selector/components/Media/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import type { MediaProps, MediaStyleProps, MediaShape, MediaSize, MediaCoverType } from './types';
+export type { MediaProps, MediaStyleProps, MediaShape, MediaSize, MediaCoverType };
+declare const Media: React.FC<MediaProps>;
+export default Media;

package/es/pro/Selector/components/Media/types.d.ts

@@ -0,0 +1,47 @@
+/// <reference types="react" />
+export declare type MediaShape = 'circle' | 'square';
+export declare type MediaSize = 'small' | 'middle' | 'large' | number;
+export declare type MediaCoverType = 'image' | 'text' | 'auto';
+export interface MediaStyles {
+    container?: React.CSSProperties | ((props: MediaStyleProps) => React.CSSProperties);
+    cover?: React.CSSProperties | ((props: MediaStyleProps) => React.CSSProperties);
+    label?: React.CSSProperties | ((props: MediaStyleProps) => React.CSSProperties);
+    extra?: React.CSSProperties | ((props: MediaStyleProps) => React.CSSProperties);
+    indicator?: React.CSSProperties | ((props: MediaStyleProps) => React.CSSProperties);
+}
+export interface MediaStyleProps {
+    selected?: boolean;
+    disabled?: boolean;
+    shape?: MediaShape;
+    size?: MediaSize;
+}
+export interface MediaProps {
+    /** 封面内容，可以是图片URL或React节点 */
+    cover?: string | React.ReactNode;
+    /** 标签文本 */
+    label?: React.ReactNode;
+    /** 额外内容，通常用于数字选择器等 */
+    extra?: React.ReactNode;
+    /** 指示器，通常用于勾选图标 */
+    indicator?: React.ReactNode;
+    /** 选中时是否展示角标，默认为 true */
+    showIndicator?: boolean;
+    /** 封面类型：image-图片、text-文字、auto-自动（默认） */
+    coverType?: MediaCoverType;
+    /** 形状 */
+    shape?: MediaShape;
+    /** 尺寸 */
+    size?: MediaSize;
+    /** 选中状态 */
+    selected?: boolean;
+    /** 禁用状态 */
+    disabled?: boolean;
+    /** 点击事件 */
+    onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
+    /** 自定义样式 */
+    styles?: MediaStyles;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}

package/es/pro/Selector/components/index.d.ts

@@ -0,0 +1,4 @@
+export { default as CardItem } from './Card';
+export { default as MediaItem } from './Media';
+export type { CardVariant, CardLayout, SelectedType, ActionsPosition, CardStyles, CardStyleProps, CardProps, } from './Card/types';
+export type { MediaShape, MediaSize, MediaCoverType, MediaStyles, MediaStyleProps, MediaProps, } from './Media/types';

package/es/pro/Selector/demo.d.ts

@@ -0,0 +1,2 @@
+declare const SelectorDemo: () => JSX.Element;
+export default SelectorDemo;