@pisell/private-materials 6.11.48 → 6.11.49

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

@@ -1,31 +0,0 @@
-/// <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/lib/pro/Selector/BatchSelectorDemo.d.ts

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

package/lib/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/lib/pro/Selector/components/Card/index.d.ts

@@ -1,57 +0,0 @@
-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/lib/pro/Selector/components/Card/types.d.ts

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

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

@@ -1,20 +0,0 @@
-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;
-        content?: React.CSSProperties;
-    };
-    children?: React.ReactNode;
-    size?: 'small' | 'middle' | 'large' | number;
-}
-declare const Indicator: React.FC<IndicatorProps>;
-export default Indicator;

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

@@ -1,105 +0,0 @@
-/**
- * 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/lib/pro/Selector/components/LayoutContainer/index.d.ts

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

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

@@ -1,6 +0,0 @@
-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/lib/pro/Selector/components/Media/types.d.ts

@@ -1,47 +0,0 @@
-/// <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/lib/pro/Selector/components/index.d.ts

@@ -1,4 +0,0 @@
-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/lib/pro/Selector/demo.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-declare const SelectorDemo: () => React.JSX.Element;
-export default SelectorDemo;

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

@@ -1,43 +0,0 @@
-import React from 'react';
-import { ItemProps, ItemLayout, SelectorVariant, PresetConfig } from '../types';
-interface UsePresetItemPropsParams {
-    variant?: SelectorVariant;
-    itemLayout?: ItemLayout;
-    preset?: PresetConfig;
-    itemProps?: ItemProps;
-    indicator: React.ReactNode;
-    numberSelector: React.ReactNode;
-    mode?: 'single' | 'multiple';
-    disabled?: boolean;
-    selected?: boolean;
-}
-interface PresetItemPropsResult {
-    mediaProps: Record<string, any>;
-    cardProps: Record<string, any>;
-}
-/**
- * 根据预设项生成 option Item 的 props
- *
- * 规则说明：
- * 1. variant='default': 使用 Card，borderless，horizontal，selectedType='none'，actionsPosition='left'
- *    1.1 preset.variant='1': renderContent={() => <span>{dataSource._label}</span>}
- *    1.2 preset.variant='2': renderContent={() => <span>{dataSource._label}</span>}
- * 2. variant='media': 使用 MediaItem
- *    2.1 preset.variant='1': size='small', showIndicator=false, 单选shape='circle'，多选shape='square'
- *    2.2 preset.variant='2': size='large', showIndicator=true, shape='circle'
- * 3. variant='card': 根据 itemLayout 区分横向和纵向
- *    3.1 横向（horizontal）:
- *        - preset.variant='2': selectedType='filled'
- *        - preset.variant='5': variant='borderless'
- *        - 默认样式: styles.container = { padding: 8 }
- *        - 使用 lodash merge 深度合并样式，itemProps.styles 优先级更高
- *    3.2 纵向（vertical）:
- *        - 统一使用 borderless，selectedType='none'
- *        - preset.variant='2': indicator 通过 corner 传入
- *    3.3 actions 处理:
- *        - 优先使用 numberSelector（如果存在）
- *        - 其次使用 indicator
- *        - 纵向且 preset.variant='2': indicator 放到 corner，actions 仅展示 numberSelector
- */
-declare const usePresetItemProps: (params: UsePresetItemPropsParams) => PresetItemPropsResult;
-export default usePresetItemProps;