@pisell/private-materials 6.3.66 → 6.3.68

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

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

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

@@ -0,0 +1,43 @@
+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

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1,11 @@
+/// <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

@@ -0,0 +1,36 @@
+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

@@ -0,0 +1,173 @@
+/// <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

@@ -0,0 +1,49 @@
+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

@@ -0,0 +1,19 @@
+/**
+ * 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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pisell/private-materials",
-  "version": "6.3.66",
+  "version": "6.3.68",
   "main": "./lib/index.js",
   "module": "./es/index.js",
   "types": "./lib/index.d.ts",