@pisell/private-materials 6.3.65 → 6.3.66

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,16 +0,0 @@
-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/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,2 +0,0 @@
-declare const SelectorDemo: () => 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;

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

@@ -1,11 +0,0 @@
-/// <reference types="react" />
-import { SelectorProps, OptionKey } from './types';
-import Item from './Item';
-import SelectorGroup from './SelectorGroup';
-declare type SelectorComponentType = React.ForwardRefExoticComponent<SelectorProps<OptionKey> & React.RefAttributes<any>> & {
-    Group: typeof SelectorGroup;
-    Item: typeof Item;
-};
-declare const Selector: SelectorComponentType;
-export * from './types';
-export default Selector;

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

@@ -1,36 +0,0 @@
-declare const _default: {
-    en: {
-        'pisell2.pro.selector.mode.single': string;
-        'pisell2.pro.selector.mode.multiple': string;
-        'pisell2.pro.selector.validate.required-msg': string;
-        'pisell2.pro.selector.validate.requireOneOf-msg': string;
-        'pisell2.pro.selector.required-tag': string;
-        'pisell2.pro.selector.validate.min-selection': (min: number, label?: string) => string;
-        'pisell2.pro.selector.validate.max-selection': (max: number, label?: string) => string;
-        'pisell2.pro.selector.tip.require-one-option': string;
-        'pisell2.pro.selector.tip.min-max-selection': (min: number, max: number) => string;
-    };
-    'zh-CN': {
-        'pisell2.pro.selector.mode.single': string;
-        'pisell2.pro.selector.mode.multiple': string;
-        'pisell2.pro.selector.validate.required-msg': string;
-        'pisell2.pro.selector.validate.requireOneOf-msg': string;
-        'pisell2.pro.selector.required-tag': string;
-        'pisell2.pro.selector.validate.min-selection': (min: number, label?: string) => string;
-        'pisell2.pro.selector.validate.max-selection': (max: number, label?: string) => string;
-        'pisell2.pro.selector.tip.require-one-option': string;
-        'pisell2.pro.selector.tip.min-max-selection': (min: number, max: number) => string;
-    };
-    'zh-HK': {
-        'pisell2.pro.selector.mode.single': string;
-        'pisell2.pro.selector.mode.multiple': string;
-        'pisell2.pro.selector.validate.required-msg': string;
-        'pisell2.pro.selector.validate.requireOneOf-msg': string;
-        'pisell2.pro.selector.required-tag': string;
-        'pisell2.pro.selector.validate.min-selection': (min: number, label?: string) => string;
-        'pisell2.pro.selector.validate.max-selection': (max: number, label?: string) => string;
-        'pisell2.pro.selector.tip.require-one-option': string;
-        'pisell2.pro.selector.tip.min-max-selection': (min: number, max: number) => string;
-    };
-};
-export default _default;

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

@@ -1,173 +0,0 @@
-/// <reference types="react" />
-export interface ExprRule {
-    [key: string]: any;
-}
-export interface RuleConfig {
-    autoValidate?: boolean;
-    required?: 0 | 1;
-    min?: number;
-    max?: number;
-    mutex?: Array<Array<OptionKey>>;
-    customValidator?: (value: SelectionValue) => Promise<void>;
-}
-export interface GroupItem {
-    id?: number;
-    title?: string;
-    mode?: 'single' | 'multiple';
-    valueType?: 'primitive' | 'object';
-    preserve?: boolean;
-    fieldNames?: {
-        label?: string;
-        value?: string;
-        cover?: string;
-    };
-    ruleConfig?: RuleConfig;
-    dataSource?: OptionItem[];
-}
-export interface OptionItem {
-    id?: number;
-    title?: string;
-    label?: string;
-    value?: OptionKey;
-    cover?: string;
-    groups?: GroupItem[];
-    disabled?: boolean;
-    ruleConfig?: {
-        min?: number;
-        max?: number;
-    };
-    [key: string]: any;
-}
-export declare type OptionKey = number | string;
-/** 原始值类型：单选时为id，多选时为id[] */
-export declare type SelectionValuePrimitive<T = OptionKey> = T | T[];
-/** 复杂对象值类型：包含id、数量等额外信息 */
-export interface SelectionValueObject<T = OptionKey> {
-    value?: T;
-    quantity?: number;
-    [key: string]: any;
-}
-/** 单选值类型 */
-export declare type SelectionValueSingle<T = OptionKey> = T | SelectionValueObject<T>;
-/** 多选值类型 */
-export declare type SelectionValueMultiple<T = OptionKey> = T[] | SelectionValueObject<T>[];
-/** 选择器值类型 */
-export declare type SelectionValue<T = OptionKey> = SelectionValueSingle<T> | SelectionValueMultiple<T>;
-export declare type RenderItemProps = {
-    dataSource: OptionItem;
-    actions: any;
-    optionItemValue?: any;
-    indicator: React.ReactNode;
-    numberSelector: React.ReactNode;
-    values: any;
-    quantityInfo: {
-        maxReached: boolean;
-        remainingCount: number;
-        selectedCount: number;
-    };
-};
-export declare type ItemProps = {
-    layout?: 'vertical' | 'horizontal';
-    renderContent?: (props: {
-        dataSource: OptionItem;
-    }) => React.ReactNode;
-    styles?: {
-        [key: string]: React.CSSProperties;
-    };
-    [key: string]: any;
-};
-export declare type LayoutType = 'antdGrid' | 'custom';
-export declare type LayoutConfig = {
-    type?: LayoutType;
-    className?: string;
-    containerStyle?: React.CSSProperties;
-    columns?: number;
-    gutter?: number | object | Array<number>;
-    align?: 'top' | 'middle' | 'bottom' | 'stretch';
-    justify?: 'start' | 'end' | 'center' | 'space-between' | 'space-around';
-    wrap?: boolean;
-    colConfig?: {
-        [key: string]: any;
-    };
-};
-export interface PresetConfig {
-    variant?: '1' | '2' | '3' | '4' | '5';
-}
-export declare type ItemLayout = 'vertical' | 'horizontal';
-export declare type SelectorVariant = 'default' | 'select' | 'card' | 'media';
-export declare type HeaderProps = {
-    visible?: boolean;
-    style?: React.CSSProperties;
-    title?: {
-        visible?: boolean;
-        text?: React.ReactNode;
-        style?: React.CSSProperties;
-    };
-    icon?: {
-        visible?: boolean;
-        icon?: React.ReactNode;
-        style?: React.CSSProperties;
-    };
-    tip?: {
-        visible?: boolean;
-        text?: React.ReactNode;
-        style?: React.CSSProperties;
-    };
-    renderExtra?: (props: {
-        dataSource: OptionItem;
-        values: SelectionValue;
-    }) => React.ReactNode;
-};
-export interface SelectorProps<T = OptionKey> extends GroupItem {
-    className?: string;
-    value?: SelectionValue<T>;
-    defaultValue?: SelectionValue<T>;
-    onChange?: (value: SelectionValue<T>) => void;
-    onClear?: () => void;
-    disabled?: boolean;
-    variant?: SelectorVariant;
-    itemLayout?: ItemLayout;
-    preset?: PresetConfig;
-    layout?: LayoutConfig;
-    renderItem?: (props: RenderItemProps) => React.ReactNode;
-    itemProps?: ItemProps;
-    indicatorProps?: {
-        show?: boolean;
-        variant?: 'outlined' | 'filled';
-        render?: (props: {
-            option: OptionItem;
-            selected: boolean;
-            disabled: boolean;
-            actions: any;
-        }) => React.ReactNode;
-        [key: string]: any;
-    };
-    showStepper?: true | false | 'auto';
-    stepperProps?: {
-        size?: 'small' | 'middle' | 'large';
-        shape?: 'round' | 'square';
-    };
-    style?: React.CSSProperties;
-    /**
-     * @deprecated
-     */
-    titleProps?: HeaderProps;
-    headerProps?: HeaderProps;
-}
-export interface SelectorGroupProps {
-    allowedValuesPolicy?: 'relaxed' | 'strict';
-    className?: string;
-    customScrollParent?: HTMLElement | string;
-    dataSource: GroupItem[];
-    defaultValue?: Record<string, SelectionValue>;
-    linkageRules?: ExprRule[] | Record<string, any>;
-    onChange?: (values: Record<string, SelectionValue>) => void;
-    preserve?: boolean;
-    tabProps?: {
-        visible?: boolean;
-    };
-    style?: React.CSSProperties;
-    value?: Record<string, SelectionValue>;
-    scrollToFirstError?: boolean;
-    [key: string]: any;
-}

package/lib/pro/Selector/utils/index.d.ts

@@ -1,49 +0,0 @@
-import { SelectionValue, GroupItem } from '../types';
-export declare type OptionEffects = Record<string, {
-    allowOnly?: Set<any>;
-    requireOneOf?: {
-        values: Set<any>;
-        message?: string;
-    };
-}>;
-export interface Cond {
-    groupId: string;
-    in?: any[];
-    op?: 'in' | 'notIn' | 'eq' | 'neq' | 'contains' | 'range' | 'exists';
-    value?: any;
-    values?: any[];
-    min?: number;
-    max?: number;
-}
-export interface Expr {
-    allOf?: Array<Cond | Expr>;
-    anyOf?: Array<Cond | Expr>;
-    noneOf?: Array<Cond | Expr>;
-    and?: Array<Cond | Expr>;
-    or?: Array<Cond | Expr>;
-    not?: Array<Cond | Expr>;
-}
-export interface Action {
-    type: 'show' | 'allowOnly' | 'requireOneOf';
-    groupId: string;
-    values?: any[];
-    message?: string;
-}
-export interface Rule {
-    type?: 'expr';
-    when?: Expr;
-    then?: Action[];
-    elseThen?: Action[];
-    priority?: number;
-    stopAfterApply?: boolean;
-}
-export declare const normalizeRules: (linkageRules: any) => Rule[];
-export declare const getSelectedSet: (val: SelectionValue) => Set<any>;
-export declare const evaluateExpr: (expr: Expr | undefined, valuesMap: Record<string, SelectionValue>) => boolean;
-export declare const computeAutoHiddenGroups: (rules: Rule[]) => Set<string>;
-export declare const computeEffects: (dataSource?: GroupItem[], rawRules?: Rule[], valuesMap?: Record<string, SelectionValue>) => {
-    visibleGroups: Record<string, boolean>;
-    optionEffects: OptionEffects;
-};
-export declare const pruneValuesByAllowOnly: (valuesMap: Record<string, SelectionValue>, effects: OptionEffects) => Record<string, SelectionValue>;
-export declare const generateSimpleUUID: () => string;

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

@@ -1,19 +0,0 @@
-/**
- * PisellPaymentList 使用示例
- *
- * 这个文件演示了如何使用 PisellPaymentList 和 PisellPaymentListItem 组件
- * 包括如何通过 Context 访问父组件配置
- */
-export declare const BasicExample: () => JSX.Element;
-export declare const ChildrenExample: () => JSX.Element;
-export declare const CustomItemExample: () => JSX.Element;
-export declare const MethodConfigExample: () => JSX.Element;
-export declare const FullFeatureExample: () => JSX.Element;
-declare const _default: {
-    BasicExample: () => JSX.Element;
-    ChildrenExample: () => JSX.Element;
-    CustomItemExample: () => JSX.Element;
-    MethodConfigExample: () => JSX.Element;
-    FullFeatureExample: () => JSX.Element;
-};
-export default _default;

package/lib/test/setup.d.ts

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