@pisell/materials 3.3.98 → 3.3.100

package/lib/components/PisellProcedure/hooks/useSidebarHeight.d.ts

@@ -1,16 +0,0 @@
-/**
- * 尺寸值接口
- */
-interface SizeValues {
-    containerSelector?: string;
-    containerHeight?: number;
-    headerHeight?: number;
-    footerHeight: number;
-}
-/**
- * 使用 Sidebar 高度的 Hook
- *
- * @description 计算并管理 Sidebar 的高度，确保在尺寸稳定后才应用
- */
-export declare const useSidebarHeight: (isSizeStable: boolean, sizeValues: SizeValues) => number | undefined;
-export {};

package/lib/components/PisellProcedure/utils/classNames.d.ts

@@ -1,33 +0,0 @@
-/**
- * 类名合并工具函数
- * @description 用于合并多个类名，过滤掉 undefined、null、空字符串
- */
-/**
- * 合并类名
- * @param classNames 类名数组
- * @returns 合并后的类名字符串
- * @example
- * mergeClassNames('base', 'active', undefined, 'extra')
- * // => 'base active extra'
- */
-export declare const mergeClassNames: (...classNames: (string | undefined | null | false)[]) => string;
-/**
- * 生成带前缀的类名
- * @param prefix 前缀
- * @param suffix 后缀（可选）
- * @returns 类名字符串
- * @example
- * prefixClassName('pisell-procedure', 'header')
- * // => 'pisell-procedure-header'
- */
-export declare const prefixClassName: (prefix: string, suffix?: string) => string;
-/**
- * 生成带修饰符的 BEM 类名
- * @param block 块名
- * @param modifier 修饰符
- * @returns 类名字符串
- * @example
- * modifierClassName('pisell-procedure-footer', 'float-sidebar')
- * // => 'pisell-procedure-footer--float-sidebar'
- */
-export declare const modifierClassName: (block: string, modifier?: string) => string;

package/lib/components/PisellProcedure/utils/extractText.d.ts

@@ -1,20 +0,0 @@
-import React from 'react';
-/**
- * 从 React 节点中提取文本内容
- * @param node React 节点
- * @returns 提取的文本字符串
- * @example
- * extractTextFromNode(<span>Hello</span>) // => 'Hello'
- * extractTextFromNode('Hello') // => 'Hello'
- * extractTextFromNode([<span>Hello</span>, ' ', <span>World</span>]) // => 'Hello World'
- */
-export declare const extractTextFromNode: (node: React.ReactNode) => string;
-/**
- * 从按钮 props 中提取显示文本
- * @param buttonProps 按钮的 props
- * @param fallback 默认文本
- * @returns 显示文本
- */
-export declare const extractButtonLabel: (buttonProps: {
-    children?: React.ReactNode;
-} | undefined, fallback: string) => string;

package/lib/components/PisellProcedure/utils/slotHelper.d.ts

@@ -1,27 +0,0 @@
-import React from 'react';
-/**
- * 插槽包装工具函数
- * @description 用于包装 React 插槽元素，添加额外的事件处理
- */
-/**
- * 包装插槽元素，添加点击事件
- * @param slotContent 插槽内容
- * @param onClick 点击回调
- * @returns 包装后的插槽内容
- * @example
- * wrapSlotWithClick(leftSlot, handleBackClick)
- */
-export declare const wrapSlotWithClick: (slotContent: React.ReactNode, onClick?: () => void | boolean) => React.ReactNode;
-/**
- * 检查插槽是否为有效的 React 元素
- * @param slotContent 插槽内容
- * @returns 是否为有效元素
- */
-export declare const isValidSlot: (slotContent: React.ReactNode) => boolean;
-/**
- * 渲染插槽内容，如果为空则返回默认内容
- * @param slotContent 插槽内容
- * @param defaultContent 默认内容
- * @returns 最终渲染内容
- */
-export declare const renderSlotOrDefault: (slotContent: React.ReactNode, defaultContent?: React.ReactNode) => React.ReactNode;

package/lib/components/PisellScrollView/components/Actions/index.d.ts

@@ -1,18 +0,0 @@
-import React from 'react';
-import type { ScrollEventData, PisellScrollViewProps, ScrollActionsConfig } from '../../types';
-import './index.less';
-interface ActionsContainerProps {
-    scrollState: ScrollEventData;
-    overflow: PisellScrollViewProps['overflow'];
-    scrollActionsConfig: ScrollActionsConfig;
-    containerRef: React.RefObject<HTMLDivElement>;
-    onClick: (direction: 'left' | 'right' | 'top' | 'bottom') => void;
-}
-/**
- * ActionsContainer 根据 scrollActionsConfig 渲染滚动辅助操作。
- *
- * @example
- * <ActionsContainer scrollActionsConfig={{ show: true, type: 'indicator' }} />
- */
-declare const ActionsContainer: ({ containerRef, scrollState, overflow, scrollActionsConfig, onClick, }: ActionsContainerProps) => JSX.Element | null;
-export default ActionsContainer;

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

@@ -1,9 +0,0 @@
-/**
- * 锚链接功能 Hook
- * 当开启锚链接时，自动滚动到当前步骤对应的锚点
- *
- * @param currentStep - 当前步骤索引
- * @param enableAnchor - 是否启用锚链接
- * @param anchorContainer - 锚链接容器选择器或元素
- */
-export declare function useAnchor(currentStep: number, enableAnchor: boolean, anchorContainer?: string | HTMLElement): void;

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

@@ -1,8 +0,0 @@
-/**
- * 响应式监听 Hook
- * 监听窗口大小变化，返回当前是否为移动端
- *
- * @param breakpoint - 断点宽度（默认 768px）
- * @returns 是否为移动端
- */
-export declare function useResponsive(breakpoint?: number): boolean;

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

@@ -1,9 +0,0 @@
-/**
- * 管理步骤条状态的 Hook（支持受控和非受控模式）
- *
- * @param current - 受控模式下的当前步骤
- * @param defaultCurrent - 非受控模式下的默认当前步骤
- * @param onChange - 步骤变更回调函数
- * @returns [currentStep, setCurrentStep] - 当前步骤和设置步骤的函数
- */
-export declare function useStepsState(current?: number, defaultCurrent?: number, onChange?: (current: number) => void): [number, (value: number) => void];

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

@@ -1,8 +0,0 @@
-/**
- * 获取数据项的唯一标识
- * @param record - 数据项
- * @param index - 索引
- * @param rowKey - key 字段配置
- * @returns 唯一标识字符串
- */
-export declare const getRowKey: <T = any>(record: T, index: number, rowKey?: string | ((record: T, index: number) => string) | undefined) => string;

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

@@ -1 +0,0 @@
-export { getRowKey } from './getRowKey';

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

@@ -1,23 +0,0 @@
-declare const _default: {
-    en: {
-        expand: string;
-        minimize: string;
-    };
-    "zh-CN": {
-        expand: string;
-        minimize: string;
-    };
-    "zh-HK": {
-        expand: string;
-        minimize: string;
-    };
-    ja: {
-        expand: string;
-        minimize: string;
-    };
-    pt: {
-        expand: string;
-        minimize: string;
-    };
-};
-export default _default;

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

@@ -1,47 +0,0 @@
-declare const _default: {
-    id: number;
-    shop_id: number;
-    parent_id: number;
-    name: string;
-    slug: string;
-    icon: string;
-    status: string;
-    last_applicable_time: number;
-    sort: number;
-    create_account_id: number;
-    update_account_id: number;
-    created_at: string;
-    updated_at: string;
-    children: {
-        id: number;
-        shop_id: number;
-        parent_id: number;
-        name: string;
-        slug: string;
-        icon: string;
-        status: string;
-        last_applicable_time: number;
-        sort: number;
-        create_account_id: number;
-        update_account_id: number;
-        created_at: string;
-        updated_at: string;
-        children: {
-            id: number;
-            shop_id: number;
-            parent_id: number;
-            name: string;
-            slug: string;
-            icon: string;
-            status: string;
-            last_applicable_time: number;
-            sort: number;
-            create_account_id: number;
-            update_account_id: number;
-            created_at: string;
-            updated_at: string;
-            children: never[];
-        }[];
-    }[];
-}[];
-export default _default;

package/lib/components/PisellTabbar2/hooks/index.d.ts

@@ -1,2 +0,0 @@
-export { default as useActiveKey } from './useActiveKey';
-export { default as useExpand } from './useExpand';

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

@@ -1,50 +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;
-    panelVisible: boolean;
-}
-/**
- * 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/PisellTabbar2/hooks/useExpand.d.ts

@@ -1,41 +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;
-}
-/**
- * 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/PisellTabbar2/locales.d.ts

@@ -1,23 +0,0 @@
-declare const _default: {
-    en: {
-        expand: string;
-        minimize: string;
-    };
-    "zh-CN": {
-        expand: string;
-        minimize: string;
-    };
-    "zh-HK": {
-        expand: string;
-        minimize: string;
-    };
-    ja: {
-        expand: string;
-        minimize: string;
-    };
-    pt: {
-        expand: string;
-        minimize: string;
-    };
-};
-export default _default;