@pisell/private-materials 6.8.15 → 6.8.17

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/SelectorGroup.d.ts

@@ -1,11 +0,0 @@
-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/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,19 +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;
-    };
-    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,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/hooks/useSelectionController.d.ts

@@ -1,49 +0,0 @@
-import { RuleConfig, OptionItem, SelectionValuePrimitive, SelectionValue, OptionKey } from '../types';
-declare type ErrorItem = {
-    type: 'required' | 'max' | 'min' | 'optionMin' | 'optionMax' | 'requireOneOf' | 'mutex';
-    message: string;
-    _key?: OptionKey;
-};
-declare type InnerOptionItem = OptionItem & {
-    _key: OptionKey;
-    _label: string;
-    selected: boolean;
-    quantity: number;
-    disabled: boolean;
-};
-export default function useSelectionController(props: {
-    dataSource?: OptionItem[];
-    ruleConfig?: RuleConfig;
-    fieldNames?: {
-        label?: string;
-        value?: string;
-        cover?: string;
-    };
-    mode?: 'single' | 'multiple';
-    valueType?: 'primitive' | 'object';
-    value?: SelectionValuePrimitive | SelectionValue;
-    defaultValue?: SelectionValuePrimitive | SelectionValue;
-    onChange?: (value: SelectionValuePrimitive | SelectionValue) => void;
-}): {
-    state: {
-        options: InnerOptionItem[];
-        values: SelectionValue;
-        errors: Array<ErrorItem>;
-        validated: boolean;
-        quantityInfo: {
-            showQuantity: boolean;
-            maxReached: boolean;
-            remainingCount: number;
-            selectedCount: number;
-        };
-    };
-    actions: {
-        toggle: (optionKey: OptionKey) => void;
-        update: (optionKey: OptionKey, payload?: any) => void;
-        setValue: (value: SelectionValuePrimitive | SelectionValue) => void;
-        clear: () => void;
-        validate: () => Promise<void>;
-        reset: () => void;
-    };
-};
-export {};

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;