@pisell/materials 6.12.1 → 6.12.2

package/lib/components/PisellScrollView/types.d.ts

@@ -1,203 +0,0 @@
-import React, { ReactNode, CSSProperties } from 'react';
-/**
- * 滚动位置配置
- */
-export interface ScrollPosition {
-    /** 竖向滚动位置（像素） */
-    scrollTop?: number;
-    /** 横向滚动位置（像素） */
-    scrollLeft?: number;
-    /** 滚动行为 */
-    behavior?: 'auto' | 'smooth';
-}
-/**
- * 滚动到元素配置
- */
-export interface ScrollToElementConfig {
-    /** 目标元素 ID */
-    targetId: string;
-    /** 对齐方式 */
-    align?: 'start' | 'center' | 'end' | 'nearest';
-    /** 滚动行为 */
-    behavior?: 'auto' | 'smooth';
-    /** 偏移量 */
-    offset?: number;
-}
-/**
- * 滚动百分比配置
- */
-export interface ScrollPercentage {
-    /** 竖向滚动百分比 (0-100) */
-    percentY?: number;
-    /** 横向滚动百分比 (0-100) */
-    percentX?: number;
-    /** 滚动行为 */
-    behavior?: 'auto' | 'smooth';
-}
-/**
- * 滚动按钮配置
- */
-export interface ScrollActionsConfig {
-    show?: boolean;
-    /** 按钮类型 */
-    type: "backTop" | "rArrows" | "lrArrows" | "tbArrows" | "indicator" | "custom";
-    style?: CSSProperties;
-    scrollDistance?: number;
-    /** 按钮配置 根据type不同，配置不同 */
-    config?: any;
-}
-/**
- * 滚动事件数据
- */
-export interface ScrollEventData {
-    /** 当前滚动位置 */
-    scrollTop: number;
-    scrollLeft: number;
-    /** 滚动百分比 */
-    percentY: number;
-    percentX: number;
-    /** 可滚动高度/宽度 */
-    scrollHeight: number;
-    scrollWidth: number;
-    /** 容器尺寸 */
-    clientHeight: number;
-    clientWidth: number;
-    /** 滚动方向 */
-    direction: 'up' | 'down' | 'left' | 'right' | null;
-    /** 是否滚动到顶部 */
-    isScrollToTop: boolean;
-    /** 是否滚动到底部 */
-    isScrollToBottom: boolean;
-    /** 是否滚动到左边 */
-    isScrollToLeft: boolean;
-    /** 是否滚动到右边 */
-    isScrollToRight: boolean;
-    /** 是否已经产生滚动条 */
-    isOverflows: boolean;
-}
-/**
- * 视图监听配置
- */
-export interface IntersectionConfig {
-    /** 是否启用视图监听 */
-    enabled?: boolean;
-    /** 交叉阈值 (0-1) */
-    threshold?: number | number[];
-    /** 根边距 */
-    rootMargin?: string;
-    /** 元素进入视图回调 */
-    onEnterViewport?: (entry: IntersectionObserverEntry, element: Element) => void;
-    /** 元素离开视图回调 */
-    onLeaveViewport?: (entry: IntersectionObserverEntry, element: Element) => void;
-    /** 可见度变化回调 */
-    onVisibilityChange?: (entry: IntersectionObserverEntry, element: Element) => void;
-    /** 需要监听的元素选择器 */
-    targetSelector?: string;
-}
-/**
- * 吸附滚动配置
- */
-export interface SnapScrollConfig {
-    /** 是否启用吸附滚动 */
-    enabled?: boolean;
-    /** 吸附类型 */
-    type?: 'mandatory' | 'proximity';
-    /** 吸附对齐方式 */
-    align?: 'start' | 'center' | 'end';
-    /** 吸附开始回调 */
-    onSnapStart?: (targetIndex: number, targetPosition: number) => void;
-    /** 吸附结束回调 */
-    onSnapEnd?: (currentIndex: number, currentPosition: number) => void;
-}
-/**
- * PisellScrollView 组件 Props
- */
-export interface PisellScrollViewProps {
-    /** 子元素 */
-    children?: ReactNode;
-    /** 自定义类名 */
-    className?: string;
-    /** 自定义样式 */
-    style?: CSSProperties;
-    /** 滚动方向 */
-    overflow?: 'auto' | 'scroll' | 'hidden' | 'x' | 'y' | 'both';
-    /** 滚动条样式 */
-    scrollbarStyle?: 'default' | 'thin' | 'minimal' | 'rounded' | 'overlay' | 'custom' | 'none';
-    /** 自定义滚动条类名（当 scrollbarStyle 为 'custom' 时使用） */
-    scrollbarClassName?: string;
-    /** 是否显示滚动按钮 */
-    showScrollButtons?: boolean;
-    /** 箭头操作 */
-    scrollActionsConfig?: ScrollActionsConfig;
-    /** 滚动时触发 */
-    onScroll?: (data: ScrollEventData) => void;
-    /** 开始滚动时触发 */
-    onScrollStart?: (data: ScrollEventData) => void;
-    /** 滚动结束时触发（防抖延迟，默认 150ms） */
-    onScrollEnd?: (data: ScrollEventData) => void;
-    /** 滚动结束防抖延迟时间（ms） */
-    scrollEndDelay?: number;
-    /** 到达顶部时触发 */
-    onReachTop?: (data: ScrollEventData) => void;
-    /** 到达底部时触发 */
-    onReachBottom?: (data: ScrollEventData) => void;
-    /** 到达左边时触发 */
-    onReachLeft?: (data: ScrollEventData) => void;
-    /** 到达右边时触发 */
-    onReachRight?: (data: ScrollEventData) => void;
-    /** 边界阈值（到达边界的像素阈值） */
-    reachThreshold?: number;
-    /** IntersectionObserver 配置 */
-    intersection?: IntersectionConfig;
-    /** 吸附滚动配置 */
-    snapScroll?: SnapScrollConfig;
-    /** 容器宽度 */
-    width?: number | string;
-    /** 容器高度 */
-    height?: number | string;
-    /** 最大宽度 */
-    maxWidth?: number | string;
-    /** 最大高度 */
-    maxHeight?: number | string;
-    /** 最小宽度 */
-    minWidth?: number | string;
-    /** 最小高度 */
-    minHeight?: number | string;
-    /** Ref 引用 */
-    ref?: React.Ref<PisellScrollViewRef>;
-    /** 设计模式 */
-    __designMode?: boolean;
-}
-/**
- * 组件暴露的方法
- */
-export interface PisellScrollViewRef {
-    /** 滚动到指定位置 */
-    scrollTo: (position: ScrollPosition) => void;
-    /** 滚动到指定元素 */
-    scrollToElement: (config: ScrollToElementConfig) => void;
-    /** 滚动到百分比位置 */
-    scrollToPercentage: (percentage: ScrollPercentage) => void;
-    /** 滚动到顶部 */
-    scrollToTop: (behavior?: 'auto' | 'smooth') => void;
-    /** 滚动到底部 */
-    scrollToBottom: (behavior?: 'auto' | 'smooth') => void;
-    /** 滚动到最左侧 */
-    scrollToLeft: (behavior?: 'auto' | 'smooth') => void;
-    /** 滚动到最右侧 */
-    scrollToRight: (behavior?: 'auto' | 'smooth') => void;
-    /** 获取当前滚动信息 */
-    getScrollData: () => ScrollEventData;
-    /** 获取滚动容器 DOM 元素 */
-    getScrollContainer: () => HTMLElement | null;
-    /** 滚动到指定吸附点（索引） */
-    scrollToSnapPoint: (index: number, behavior?: 'auto' | 'smooth') => void;
-    /** 获取所有吸附点位置 */
-    getSnapPoints: () => number[];
-    /** 获取当前吸附点索引 */
-    getCurrentSnapIndex: () => number;
-    /** 滚动到下一个吸附点 */
-    scrollToNextSnap: (behavior?: 'auto' | 'smooth') => void;
-    /** 滚动到上一个吸附点 */
-    scrollToPrevSnap: (behavior?: 'auto' | 'smooth') => void;
-}

package/lib/components/PisellSteps/PisellSteps.d.ts

@@ -1,14 +0,0 @@
-import React from 'react';
-import './PisellSteps.less';
-import type { PisellStepsProps } from './types';
-/**
- * PisellSteps 步骤条组件
- *
- * 基于 Ant Design Steps 组件进行二次封装和增强
- * 支持多种展示样式、布局方式和丰富的交互功能
- *
- * @author Pisell Team
- * @version 1.0.0
- */
-declare const PisellSteps: React.FC<PisellStepsProps>;
-export default PisellSteps;

package/lib/components/PisellSuperTabs/PisellSuperTabs.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import './PisellSuperTabs.less';
-import type { PisellSuperTabsProps } from './types';
-interface PisellSuperTabsRef {
-    scrollItemByRowKey: (key: string) => void;
-}
-declare const _default: React.ForwardRefExoticComponent<PisellSuperTabsProps<unknown> & React.RefAttributes<PisellSuperTabsRef>>;
-export default _default;

package/lib/components/PisellSuperTabs/hooks/useTabsState.d.ts

@@ -1,7 +0,0 @@
-import { UseTabsStateParams, UseTabsStateReturn } from '../types';
-/**
- * Tabs 状态管理 Hook
- * @description 处理受控/非受控模式的状态管理
- * @template T - 数据项类型
- */
-export declare const useTabsState: <T = any>(params: UseTabsStateParams<T>) => UseTabsStateReturn<T>;

package/lib/components/PisellSuperTabs/types.d.ts

@@ -1,212 +0,0 @@
-import { CSSProperties, ReactNode } from 'react';
-import type { PisellBasicGridProps } from '../PisellBasicGrid/types';
-import type { PisellScrollViewProps } from '../PisellScrollView/types';
-import type { PisellBasicCardProps } from '../PisellCards/types';
-/**
- * useTabsState Hook 参数
- */
-export interface UseTabsStateParams<T = any> {
-    isControlled: boolean;
-    /**
-     * 当前激活的 Tab key（受控）
-     */
-    value?: string;
-    /**
-     * 默认激活的 Tab key（非受控）
-     */
-    defaultValue?: string;
-    /**
-     * Tab 切换时的回调
-     */
-    onChange?: (key: string, item: T) => void;
-}
-/**
- * useTabsState Hook 返回值
- */
-export interface UseTabsStateReturn<T = any> {
-    /**
-     * 当前激活的 Tab key
-     */
-    activeKey: string | undefined;
-    /**
-     * 切换 Tab 的方法
-     */
-    handleTabChange: (key: string, item: T) => void;
-}
-export interface RenderItemProps<T = any> extends PisellBasicCardProps {
-    index: number;
-    tabsState: UseTabsStateReturn<T>;
-    tabsProps: PisellSuperTabsProps<T>;
-}
-/**
- * PisellSuperTabs 组件 Props
- * @template T - 数据源项的类型
- * @description 通用导航框架封装的全能型 Tab 组件
- */
-export interface PisellSuperTabsProps<T = any> {
-    isControlled?: boolean;
-    /**
-     * 自定义类名
-     * @description 添加到最外层容器的类名
-     */
-    className?: string;
-    tabItemClassName?: string;
-    tabItemStyle?: CSSProperties;
-    /**
-     * 自定义样式
-     * @description 添加到最外层容器的样式
-     */
-    style?: CSSProperties;
-    /**
-     * 唯一标识
-     * @description 必填，用于区分不同的 TabItem
-     */
-    id?: string;
-    /**
-     * 数据源
-     * @description 支持多级嵌套，递归字段为 children
-     * @example
-     * [
-     *   { key: 'home', label: '首页' },
-     *   { key: 'products', label: '产品', children: [...] }
-     * ]
-     */
-    dataSource?: T[];
-    /**
-     * 数据项的唯一标识字段
-     * @default 'key'
-     * @description 可以是字符串（字段名）或函数（自定义获取逻辑）
-     * @example
-     * // 字符串形式
-     * rowKey="id"
-     *
-     * // 函数形式
-     * rowKey={(record, index) => `${record.type}-${index}`}
-     */
-    rowKey?: string | ((record: T, index: number) => string);
-    /**
-     * 当前激活的 Tab key
-     * @description 受控模式，需配合 onChange 使用
-     */
-    value?: string;
-    /**
-     * 默认激活的 Tab key
-     * @description 非受控模式，仅初始化时生效
-     */
-    defaultValue?: string;
-    /**
-     * Tab 切换时的回调
-     * @param key - 切换到的 Tab key
-     * @param item - 切换到的数据项
-     */
-    onChange?: (key: string, item: T) => void;
-    /**
-     * 自定义 TabItem 渲染
-     * @description 支持两种模式：
-     * 1. 函数模式：(item, index, active) => ReactNode
-     * 2. 插槽模式：直接传入 ReactNode
-     * @example
-     * // 函数模式
-     * renderItem={(item, index, active) => (
-     *   <PisellCards.TabCard
-     *     {...item}
-     *     active={{ value: active }}
-     *   />
-     * )}
-     *
-     * // 插槽模式
-     * renderItem={<PisellCards.TabCard />}
-     */
-    renderItem?: ((props: RenderItemProps<T>) => ReactNode) | ReactNode;
-    /**
-     * PisellBasicGrid 组件的配置
-     * @description 透传给 PisellBasicGrid 组件的所有 Props
-     * @see PisellBasicGridProps
-     * @example
-     * gridProps={{
-     *   direction: 'horizontal',
-     *   gap: 16,
-     *   wrap: 'wrap',
-     *   columns: 4,
-     * }}
-     */
-    gridProps?: Omit<PisellBasicGridProps<T>, 'dataSource' | 'renderItem' | 'rowKey' | 'children'>;
-    /**
-     * PisellScrollView 组件的配置
-     * @description 透传给 PisellScrollView 组件的所有 Props
-     * @see PisellScrollViewProps
-     * @example
-     * scrollViewProps={{
-     *   overflow: 'x',
-     *   scrollbarStyle: 'thin',
-     *   scrollActionsConfig: { show: true, type: 'lrArrows' },
-     * }}
-     */
-    scrollViewProps?: Omit<PisellScrollViewProps, 'children'>;
-    children?: ReactNode;
-    /**
-     * 左侧插槽
-     */
-    slotLeft?: ReactNode;
-    slotLeftClassName?: string;
-    slotLeftStyle?: CSSProperties;
-    /**
-     * 右侧插槽
-     */
-    slotRight?: ReactNode;
-    slotRightClassName?: string;
-    slotRightStyle?: CSSProperties;
-    /**
-     * 顶部插槽
-     */
-    slotTop?: ReactNode;
-    slotTopClassName?: string;
-    slotTopStyle?: CSSProperties;
-    /**
-     * 底部插槽
-     */
-    slotBottom?: ReactNode;
-    slotBottomClassName?: string;
-    slotBottomStyle?: CSSProperties;
-    __designMode?: boolean;
-}
-/**
- * 数据项基础类型
- * @description 建议数据源中的每一项都包含这些字段
- */
-export interface TabDataItem {
-    /**
-     * 唯一标识
-     * @description 必填，用于区分不同的 TabItem
-     */
-    key: string;
-    /**
-     * 标签文本
-     */
-    label?: string;
-    /**
-     * 图标
-     */
-    icon?: ReactNode;
-    /**
-     * 徽章配置
-     */
-    badge?: {
-        count?: number;
-        dot?: boolean;
-        text?: string;
-    };
-    /**
-     * 子级数据（多级嵌套）
-     * @description 用于多级导航场景，具体渲染逻辑由 Card 组件实现
-     */
-    children?: TabDataItem[];
-    /**
-     * 是否禁用
-     */
-    disabled?: boolean;
-    /**
-     * 其他自定义字段
-     */
-    [key: string]: any;
-}

package/lib/components/PisellTabbar/constants.d.ts

@@ -1,47 +0,0 @@
-import { TabbarLevelConfig, ExpandConfig, LevelType } from './types';
-/**
- * 默认层级配置
- */
-export declare const DEFAULT_LEVEL_CONFIG: Record<LevelType, TabbarLevelConfig>;
-/**
- * 获取展开配置
- */
-export declare const getExpandConfig: () => ExpandConfig;
-/**
- * 默认数据项配置
- */
-export declare const DEFAULT_ITEMS: {
-    all: {
-        id: string;
-        shop_id: number;
-        parent_id: number;
-        name: any;
-        slug: string;
-        icon: string;
-    };
-    search: {
-        id: string;
-        shop_id: number;
-        parent_id: number;
-        name: any;
-        text: any;
-        slug: string;
-        key: string;
-        icon: string;
-        customClick: boolean;
-    };
-    expand: {
-        id: string;
-        shop_id: number;
-        parent_id: number;
-        key: string;
-        icon: string;
-        name: string;
-        slug: string;
-        customClick: boolean;
-    };
-};
-/**
- * 获取层级对应的添加项配置
- */
-export declare const LEVEL_ADD_ITEMS: Record<LevelType, ('all' | 'search' | 'expand')[]>;

package/lib/components/PisellTabbar/hooks/useActiveKey.d.ts

@@ -1,55 +0,0 @@
-/**
- * useActiveKey Hook 参数
- */
-interface UseActiveKeyProps {
-    /** 初始激活的 key 数组（对应多层级） */
-    initialActiveKey?: (string | number)[];
-    /** key 变化回调 */
-    onChange?: (value: (string | number)[]) => void;
-}
-/**
- * useActiveKey Hook 返回值
- */
-interface UseActiveKeyReturn {
-    /** 当前激活的 key 数组 */
-    activeKey: (string | number)[];
-    /** 设置指定层级的激活 key */
-    setActiveKey: (level: number, key: string | number, cKey?: string | number) => void;
-    /** 获取指定层级的激活 key */
-    getActiveKey: (level: number) => string | number;
-    /** 内部设置方法（用于同步外部值） */
-    _setActiveKey: (value: (string | number)[]) => void;
-    /** 设置缓存key */
-    setCacheActiveKey: (val: (string | number)[]) => void;
-    /** 重置value为缓存key */
-    resetActiveKey: () => void;
-    /** 获取缓存key */
-    getCacheActiveKey: () => (string | number)[];
-}
-/**
- * Tabbar 激活状态管理 Hook
- *
- * 用于管理多层级 Tabbar 的激活状态，支持级联选择
- *
- * @param props - Hook 配置参数
- * @returns 激活状态和操作方法
- *
- * @example
- * ```tsx
- * const { activeKey, setActiveKey, getActiveKey } = useActiveKey({
- *   initialActiveKey: [1, 10],
- *   onChange: (value) => console.log('当前选中:', value)
- * });
- *
- * // 设置第 0 层级的 key，并清除后续层级
- * setActiveKey(0, '2');
- *
- * // 设置第 0 层级的 key，并同时设置第 1 层级
- * setActiveKey(0, '2', '20');
- *
- * // 获取第 0 层级的 key
- * const level0Key = getActiveKey(0);
- * ```
- */
-declare const useActiveKey: (props: UseActiveKeyProps) => UseActiveKeyReturn;
-export default useActiveKey;

package/lib/components/PisellTabbar/hooks/useExpand.d.ts

@@ -1,42 +0,0 @@
-import { ExpandState, LevelType } from '../types';
-/**
- * useExpand Hook 参数
- */
-interface UseExpandProps {
-    /** 初始展开状态 */
-    initialExpand?: Partial<ExpandState>;
-}
-/**
- * useExpand Hook 返回值
- */
-interface UseExpandReturn {
-    /** 展开状态 */
-    expand: ExpandState;
-    /** 设置展开状态 */
-    setExpand: (state: ExpandState) => void;
-    /** 切换指定层级的展开状态 */
-    toggleExpand: (level: LevelType) => void;
-    /** 获取指定层级的展开状态 */
-    getExpand: (level: LevelType) => boolean;
-    closeAll: () => void;
-}
-/**
- * Tabbar 展开状态管理 Hook
- * 用于管理多层级的展开/收起状态
- *
- * @param props - Hook 配置参数
- * @returns 展开状态和操作方法
- *
- * @example
- * ```tsx
- * const { expand, toggleExpand, getExpand } = useExpand({
- *   initialExpand: { level1: false }
- * });
- *
- * <button onClick={() => toggleExpand('level1')}>
- *   {getExpand('level1') ? '收起' : '展开'}
- * </button>
- * ```
- */
-declare const useExpand: (props?: UseExpandProps) => UseExpandReturn;
-export default useExpand;

package/lib/components/PisellTabbar/template/Template1/constants.d.ts

@@ -1,10 +0,0 @@
-import { TabbarLevelConfig, LevelType } from '../../types';
-export { getExpandConfig, DEFAULT_ITEMS } from '../../constants';
-/**
- * 默认层级配置
- */
-export declare const DEFAULT_LEVEL_CONFIG: Record<LevelType, TabbarLevelConfig>;
-/**
- * 获取层级对应的添加项配置
- */
-export declare const LEVEL_ADD_ITEMS: Record<LevelType, ('all' | 'search' | 'expand')[]>;

package/lib/components/PisellTabbar/types.d.ts

@@ -1,92 +0,0 @@
-import { CSSProperties } from 'react';
-/**
- * Tabbar 数据源项类型
- */
-export interface TabbarDataSource {
-    /** 唯一标识 */
-    id: string | number;
-    /** 店铺ID */
-    shop_id?: number;
-    /** 父级ID */
-    parent_id?: number;
-    /** 显示名称 */
-    name: string;
-    /** URL slug */
-    slug?: string;
-    /** 图标 URL 或图标名称 */
-    icon?: string;
-    /** 子级数据 */
-    children?: TabbarDataSource[];
-    /** 自定义点击事件标识 */
-    customClick?: boolean;
-    /** 唯一 key */
-    key?: string;
-}
-/**
- * 层级配置
- */
-export interface TabbarLevelConfig {
-    /** SuperTabs 背景色 */
-    superTabsBg: string;
-    /** 卡片宽度 */
-    cardWidth: number;
-    /** 卡片高度 */
-    cardHeight: number;
-    /** 左侧缩进 */
-    paddingLeft?: number;
-}
-/**
- * 展开配置
- */
-export interface ExpandConfig {
-    /** 激活状态配置 */
-    active: {
-        icon: string;
-        text: string;
-    };
-    /** 未激活状态配置 */
-    inactive: {
-        icon: string;
-        text: string;
-    };
-}
-/**
- * 展开状态
- */
-export interface ExpandState {
-    level1: boolean;
-    level2: boolean;
-    level3: boolean;
-}
-/**
- * 层级类型
- */
-export declare type LevelType = 'level1' | 'level2' | 'level3';
-/**
- * PisellTabbar 组件属性
- */
-export interface PisellTabbarProps {
-    /** 数据源 */
-    dataSource?: TabbarDataSource[];
-    /** 当前选中的值（多层级 key 数组） */
-    value?: (string | number)[];
-    /** 值变化回调 */
-    onChange?: (value: (string | number)[]) => void;
-    /** 自定义类名 */
-    className?: string;
-    /** 自定义样式 */
-    style?: CSSProperties;
-    /** 层级配置（可按层级自定义） */
-    levelConfig?: Partial<Record<LevelType, Partial<TabbarLevelConfig>>>;
-    /** 展开配置 */
-    expandConfig?: ExpandConfig;
-    /** 最大层级数 */
-    maxLevel?: 1 | 2 | 3;
-    onSearch?: (value: string) => void;
-    /** 透传给内部 PisellFind 的搜索配置（如 inputRender 插槽）。 */
-    searchProps?: Record<string, any>;
-    __designMode?: boolean;
-}
-export interface PisellTabbarRef {
-    closeSearchMode: () => void;
-}