@pisell/materials 6.3.26 → 6.3.27

package/es/components/pisellDropSort/components/SortableItem/index.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { Props as TreeItem } from '../../../pisellDraggable/components/TreeItem/TreeItem';
+import './index.less';
+interface SortableItemProps {
+    itemProps: TreeItem;
+    render?: (itemProps: TreeItem) => React.ReactNode;
+    domRef: React.RefObject<HTMLDivElement>;
+    allowAddChild?: boolean;
+    allowDelete?: boolean;
+    allowIsShow?: boolean;
+    allowDrag?: boolean;
+    disabled?: boolean;
+    onAdd?: (itemProps: TreeItem) => void;
+    onDelete?: (itemProps: TreeItem) => void;
+    showBorder?: boolean;
+    spacing?: number;
+    maxLevel?: number;
+    /** 设计模式 */
+    __designMode?: string;
+    /** 是否自定义操作 */
+    isCustomAction?: boolean;
+    /** 获取item样式 */
+    getItemStyle?: (itemProps: TreeItem) => React.CSSProperties;
+}
+declare const SortableItem: (props: SortableItemProps) => React.JSX.Element;
+export default SortableItem;

package/es/components/pisellDropSort/index.d.ts

@@ -0,0 +1,3 @@
+import PisellDropSort from './PisellDropSort';
+export default PisellDropSort;
+export type { PisellDropSortProps, DropSortItem } from './types';

package/es/components/pisellDropSort/types.d.ts

@@ -0,0 +1,58 @@
+import { CSSProperties } from 'react';
+import type { Props as TreeItem } from '../pisellDraggable/components/TreeItem/TreeItem';
+import type { TreeItem as TreeItemType } from '../pisellDraggable/types';
+export interface DropSortItem extends TreeItemType {
+    [key: string]: any;
+}
+export interface PisellDropSortProps {
+    /** value */
+    value: DropSortItem[];
+    /** 允许拖拽 */
+    allowDrag?: boolean;
+    /** 允许删除 */
+    allowDelete?: boolean;
+    /** 允许添加子节点 */
+    allowAddChild?: boolean;
+    /** 允许添加根节点 */
+    allowAddRoot?: boolean;
+    /** 是否允许显示隐藏 */
+    allowIsShow?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 节点间距 */
+    spacing?: number;
+    /** 最大层级数 */
+    maxLevel?: number;
+    /** 是否显示边框 */
+    showBorder?: boolean;
+    /** 样式 */
+    style?: CSSProperties;
+    /** 类名 */
+    className?: string;
+    /** 数据源变化回调 */
+    onChange?: (items: DropSortItem[]) => void;
+    /** 删除节点回调 */
+    onDelete?: (itemProps: TreeItem) => void;
+    /** 添加节点回调 */
+    onAdd?: (itemProps: TreeItem) => void;
+    /** 自定义渲染节点 */
+    renderItem?: (itemProps: TreeItem) => React.ReactNode;
+    /** 添加根节点回调 */
+    onAddRoot?: () => void;
+    /** 左侧自定义内容 */
+    leftContent?: React.ReactNode;
+    /** 右侧自定义内容 */
+    rightContent?: React.ReactNode;
+    /** 空状态自定义内容 */
+    emptyContent?: React.ReactNode;
+    /** 设计模式 */
+    __designMode?: string;
+    /** 是否自定义操作 */
+    isCustomAction?: boolean;
+    /** 获取item样式 */
+    getItemStyle?: (itemProps: TreeItem) => React.CSSProperties;
+    /** 自定义拖拽判断函数，返回false时阻止拖拽 */
+    canDrop?: (dragItem: DropSortItem, dropTarget: DropSortItem, parentId: string | number | null) => boolean;
+    /** 节点缩进宽度 */
+    indentationWidth?: number;
+}

package/es/components/pisellDropdown/index.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import './index.less';
+export interface MenuItemType {
+    key: string;
+    label: string;
+    icon?: React.ReactNode;
+    shortcut?: string;
+    divider?: boolean;
+}
+export interface PisellDropdownProps {
+    trigger?: React.ReactNode;
+    items?: MenuItemType[];
+    showShortcut?: boolean;
+    triggerType?: ('click' | 'hover')[];
+    className?: string;
+    style?: React.CSSProperties;
+    onSelect?: (key: string) => void;
+}
+declare const PisellDropdown: React.FC<PisellDropdownProps>;
+export default PisellDropdown;

package/es/components/pisellFilter/type.d.ts

@@ -0,0 +1,5 @@
+import { FilterListProps } from '../filter/components/FilterButton/types';
+import { FormInstance } from 'antd';
+export declare type PisellFilterProps = FilterListProps & FormInstance & {
+    hasForm?: boolean;
+};

package/es/components/pisellFind/PisellFind.stories.d.ts

@@ -0,0 +1,45 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellFind } from './index';
+/**
+ * PisellFind 组件 Storybook
+ * 基于 PisellLookup 的组件内查找优化版本
+ */
+declare const meta: Meta<typeof PisellFind>;
+export default meta;
+declare type Story = StoryObj<typeof PisellFind>;
+/**
+ * 基础示例 - 列表查找
+ */
+export declare const Basic: Story;
+/**
+ * 表格查找
+ */
+export declare const TableFind: Story;
+/**
+ * Input 模式查找
+ */
+export declare const InputMode: Story;
+/**
+ * 使用 Ref 控制
+ */
+export declare const WithRef: Story;
+/**
+ * 显示确认按钮
+ */
+export declare const WithConfirmButton: Story;
+/**
+ * 关闭历史记录
+ */
+export declare const NoHistory: Story;
+/**
+ * 多字段搜索
+ */
+export declare const MultiFieldSearch: Story;
+/**
+ * Drawer 模式
+ */
+export declare const DrawerMode: Story;
+/**
+ * Playground - 自由配置
+ */
+export declare const Playground: Story;

package/es/components/pisellFind/index.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { PisellLookupProps, PisellLookupRef } from '../pisellLookup';
+/**
+ * PisellFind Props
+ * 继承 PisellLookup 的所有 Props
+ */
+export declare type PisellFindProps = PisellLookupProps;
+/**
+ * PisellFind Ref
+ * 继承 PisellLookup 的所有 Ref 方法
+ */
+export declare type PisellFindRef = PisellLookupRef;
+/**
+ * PisellFind 组件
+ * 基于 PisellLookup 的组件内查找优化版本
+ *
+ * 核心特点：
+ * - 默认使用 button 触发器
+ * - 默认不显示确认按钮（输入即搜索）
+ * - 默认开启搜索历史
+ * - 默认不展示结果区（结果在页面其他位置展示）
+ *
+ * @example
+ * ```tsx
+ * // 基础用法
+ * <PisellFind
+ *   onSearch={(keyword) => {
+ *     const filtered = data.filter(item => item.name.includes(keyword));
+ *     setFilteredData(filtered);
+ *   }}
+ * />
+ *
+ * // 切换为 Input 模式
+ * <PisellFind
+ *   triggerType="input"
+ *   onSearch={(keyword) => filterData(keyword)}
+ * />
+ * ```
+ */
+export declare const PisellFind: React.ForwardRefExoticComponent<PisellLookupProps & React.RefAttributes<PisellLookupRef>>;

package/es/components/pisellFloatingPanel/index.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import './index.less';
+export interface PisellFloatingPanelProps {
+    fullHeight?: string | number;
+    retractHeight?: string | number;
+    width?: string | number;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    defaultOpen?: boolean;
+    isFloat?: boolean;
+    children?: React.ReactNode;
+    retractSlot?: React.ReactNode;
+    style?: React.CSSProperties;
+    retractIconStyle?: React.CSSProperties;
+}
+declare const PisellFloatingPanel: (props: PisellFloatingPanelProps) => React.JSX.Element;
+export default PisellFloatingPanel;

package/es/components/pisellHeaderProgressBar/index.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import './index.less';
+export interface PisellHeaderProgressBarProps {
+    title?: React.ReactNode;
+    stepText?: React.ReactNode;
+    showClose?: boolean;
+    /** 是否启用投影 */
+    enableShadow?: boolean;
+    /** 是否启用描边 */
+    enableBorder?: boolean;
+    /** 描边粗细 */
+    borderWidth?: number;
+    /** 描边颜色 */
+    borderColor?: string;
+    /** 头部背景颜色 */
+    backgroundColor?: string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 是否显示返回键 */
+    showBack?: boolean;
+    /** 返回按钮点击事件 */
+    onBack?: () => void;
+    /** 关闭按钮点击事件 */
+    onClose?: () => void;
+}
+declare const PisellHeaderProgressBar: React.FC<PisellHeaderProgressBarProps>;
+export default PisellHeaderProgressBar;

package/es/components/pisellImageCarousels/index.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import 'swiper/swiper-bundle.css';
+import './index.less';
+export interface PisellImageCarouselsProps {
+    dataSource?: string[];
+    width?: number | string;
+    height?: number;
+    showArrows?: boolean;
+    showDots?: boolean;
+    autoplay?: boolean;
+    interval?: number;
+    borderRadius?: number;
+    loop?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const PisellImageCarousels: React.FC<PisellImageCarouselsProps>;
+export default PisellImageCarousels;

package/es/components/pisellInformationEntry/Scan/index.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import './index.less';
+export interface ScanProps {
+    onChange: (val: string) => void;
+    onCancel: () => void;
+}
+declare const Scan: (props: ScanProps) => React.JSX.Element;
+export default Scan;

package/es/components/pisellInformationEntry/hooks/useNativeScanner.d.ts

@@ -0,0 +1,4 @@
+export declare const useNativeScanner: (onChange?: ((val: string) => void) | undefined) => {
+    activeNativeScanner: () => void;
+    isTerminal: any;
+};

package/es/components/pisellInformationEntry/hooks/useTerminalPeripherals.d.ts

@@ -0,0 +1,8 @@
+declare type Peripherals = {
+    scanner: 'none' | 'connected' | 'disconnect';
+    nfc: 'none' | 'connected' | 'disconnect';
+};
+declare const useTerminalPeripherals: (onChange?: ((val: string) => void) | undefined) => {
+    peripheralsStatus: Peripherals;
+};
+export default useTerminalPeripherals;

package/es/components/pisellInformationEntry/utils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 判断设备是否包含摄像头
+ */
+export declare const hasCamera: () => Promise<boolean>;

package/es/components/pisellInput/components/BankCard/utils.d.ts

@@ -0,0 +1,11 @@
+export declare const getCardType: (str: string) => "jcb" | "amex" | "visa" | "masterCard" | "unionPay" | "discover" | undefined;
+export declare const bankTypeMap: {
+    jcb: any;
+    amex: any;
+    masterCard: any;
+    visa: any;
+    unionPay: any;
+    discover: any;
+};
+export declare const getCardImgByType: (type: keyof typeof bankTypeMap) => any;
+export declare const getBankCardTypeImg: (val: number | string) => any;

package/es/components/pisellLayout/content.d.ts

@@ -0,0 +1,10 @@
+import type { LayoutProps } from 'antd';
+import React from 'react';
+export interface PisellContentProps extends Omit<LayoutProps, 'prefixCls'> {
+    children?: React.ReactNode;
+    __designMode?: string;
+    height?: number;
+    scroll?: boolean;
+}
+declare const PisellContent: React.FC<PisellContentProps>;
+export default PisellContent;

package/es/components/pisellLayout/footer.d.ts

@@ -0,0 +1,8 @@
+import type { LayoutProps } from 'antd';
+import React from 'react';
+export interface PisellFooterProps extends Omit<LayoutProps, 'prefixCls'> {
+    children?: React.ReactNode;
+    height?: number;
+}
+declare const PisellFooter: React.FC<PisellFooterProps>;
+export default PisellFooter;

package/es/components/pisellLayout/header.d.ts

@@ -0,0 +1,10 @@
+import type { LayoutProps } from 'antd';
+import React from 'react';
+import './index.less';
+export interface PisellHeaderProps extends Omit<LayoutProps, 'prefixCls'> {
+    children?: React.ReactNode;
+    height?: number;
+    fixed?: boolean;
+}
+declare const PisellHeader: React.FC<PisellHeaderProps>;
+export default PisellHeader;

package/es/components/pisellLayout/sider.d.ts

@@ -0,0 +1,8 @@
+import type { SiderProps } from 'antd/es/layout/Sider';
+import React from 'react';
+import './index.less';
+export interface PisellSiderProps extends SiderProps {
+    children?: React.ReactNode;
+}
+declare const PisellSider: React.FC<PisellSiderProps>;
+export default PisellSider;

package/es/components/pisellLookup/PisellLookup.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { PisellLookupProps, PisellLookupRef } from './types';
+import './PisellLookup.less';
+export declare const PisellLookup: React.ForwardRefExoticComponent<PisellLookupProps & React.RefAttributes<PisellLookupRef>>;

package/es/components/pisellLookup/PisellLookup.stories.d.ts

@@ -0,0 +1,129 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellLookup } from './PisellLookup';
+/**
+ * PisellLookup 组件 Storybook
+ * 搜索交互协议组件，提供统一的搜索入口、状态管理和结果承载能力
+ */
+declare const meta: Meta<typeof PisellLookup>;
+export default meta;
+declare type Story = StoryObj<typeof PisellLookup>;
+/**
+ * 基础示例 - Input 触发器 + Inline 展示
+ */
+export declare const Basic: Story;
+/**
+ * Input 触发器 - 默认尺寸（Middle）
+ */
+export declare const InputTriggerMiddle: Story;
+/**
+ * Input 触发器 - 大号尺寸
+ */
+export declare const InputTriggerLarge: Story;
+/**
+ * Button 触发器 + Modal 展示
+ */
+export declare const ButtonTrigger: Story;
+/**
+ * Icon 触发器 + Modal 展示
+ */
+export declare const IconTrigger: Story;
+/**
+ * Text 触发器 + Modal 展示
+ */
+export declare const TextTrigger: Story;
+/**
+ * 自定义触发器 + Modal 展示
+ */
+export declare const CustomTrigger: Story;
+/**
+ * Drawer 展示模式
+ */
+export declare const DrawerDisplay: Story;
+/**
+ * 搜索历史功能
+ */
+export declare const WithSearchHistory: Story;
+/**
+ * 联想词功能
+ */
+export declare const WithSuggestions: Story;
+/**
+ * 热门搜索功能
+ */
+export declare const WithHotWords: Story;
+/**
+ * 完整功能 - 历史 + 联想词 + 热门搜索
+ */
+export declare const FullFeatures: Story;
+/**
+ * 实时搜索模式
+ */
+export declare const RealtimeSearch: Story;
+/**
+ * 确认触发模式
+ */
+export declare const ConfirmSearch: Story;
+/**
+ * 受控模式示例
+ */
+export declare const Controlled: Story;
+/**
+ * 加载状态
+ */
+export declare const Loading: Story;
+/**
+ * 禁用状态
+ */
+export declare const Disabled: Story;
+/**
+ * Modal 自定义宽度
+ */
+export declare const ModalCustomWidth: Story;
+/**
+ * Modal 显示遮罩层
+ */
+export declare const ModalWithMask: Story;
+/**
+ * Modal 挂载到容器并使用 100% 宽度
+ */
+export declare const ModalFullWidth: Story;
+/**
+ * Drawer 不同方向
+ */
+export declare const DrawerPlacements: Story;
+/**
+ * 自定义空状态
+ */
+export declare const CustomEmpty: Story;
+/**
+ * 移动端场景
+ */
+export declare const MobileScenario: Story;
+/**
+ * 保留搜索内容（默认行为）
+ */
+export declare const PreserveKeyword: Story;
+/**
+ * 关闭时清空内容
+ */
+export declare const ClearOnClose: Story;
+/**
+ * 隐藏 Lookup 按钮（输入即搜索）
+ */
+export declare const NoConfirmButton: Story;
+/**
+ * 监听打开和关闭事件
+ */
+export declare const WithOpenCloseEvents: Story;
+/**
+ * 使用 Ref 控制
+ */
+export declare const WithRef: Story;
+/**
+ * 仅触发搜索（不展示结果）
+ */
+export declare const OnlyTriggerSearch: Story;
+/**
+ * Playground - 自由配置
+ */
+export declare const Playground: Story;

package/es/components/pisellLookup/components/HotWords.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { HotWordsProps } from '../types';
+/**
+ * HotWords 组件
+ * 展示热门搜索
+ */
+export declare const HotWords: React.FC<HotWordsProps>;

package/es/components/pisellLookup/components/LookupAuxiliary.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { LookupAuxiliaryProps } from '../types';
+/**
+ * LookupAuxiliary 组件
+ * 辅助信息层：搜索历史、联想词、热门搜索
+ */
+export declare const LookupAuxiliary: React.FC<LookupAuxiliaryProps>;

package/es/components/pisellLookup/components/LookupResultHost.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { LookupResultHostProps } from '../types';
+/**
+ * LookupResultHost 组件
+ * 结果承载层：根据展示类型渲染不同的容器
+ */
+export declare const LookupResultHost: React.FC<LookupResultHostProps>;

package/es/components/pisellLookup/components/LookupTrigger.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { LookupTriggerProps, LookupTriggerRef } from '../types';
+export declare const LookupTrigger: React.ForwardRefExoticComponent<LookupTriggerProps & React.RefAttributes<LookupTriggerRef>>;

package/es/components/pisellLookup/components/SearchHistory.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { SearchHistoryProps } from '../types';
+/**
+ * SearchHistory 组件
+ * 展示搜索历史记录
+ */
+export declare const SearchHistory: React.FC<SearchHistoryProps>;

package/es/components/pisellLookup/components/SuggestWords.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { SuggestWordsProps } from '../types';
+/**
+ * SuggestWords 组件
+ * 展示搜索联想词
+ */
+export declare const SuggestWords: React.FC<SuggestWordsProps>;

package/es/components/pisellLookup/components/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 子组件统一导出
+ */
+export { SearchHistory } from './SearchHistory';
+export { SuggestWords } from './SuggestWords';
+export { HotWords } from './HotWords';
+export { LookupAuxiliary } from './LookupAuxiliary';
+export { LookupTrigger } from './LookupTrigger';
+export { LookupResultHost } from './LookupResultHost';

package/es/components/pisellLookup/hooks/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 自定义 Hooks 统一导出
+ */
+export * from './useSearchState';
+export * from './useSearchHistory';
+export * from './useDebounceSearch';

package/es/components/pisellLookup/hooks/useSearchHistory.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 搜索历史管理 Hook
+ */
+export interface UseSearchHistoryOptions {
+    /**
+     * 存储 key
+     */
+    historyKey: string;
+    /**
+     * 最大历史记录数量
+     */
+    maxHistoryCount: number;
+    /**
+     * 自定义加载历史记录函数
+     */
+    onLoadHistory?: () => string[];
+    /**
+     * 自定义保存历史记录函数
+     */
+    onSaveHistory?: (history: string[]) => void;
+}
+export interface UseSearchHistoryResult {
+    /**
+     * 历史记录数组
+     */
+    history: string[];
+    /**
+     * 添加历史记录
+     */
+    addHistory: (keyword: string) => void;
+    /**
+     * 删除历史记录
+     */
+    removeHistory: (keyword: string) => void;
+    /**
+     * 清除全部历史记录
+     */
+    clearAllHistory: () => void;
+    /**
+     * 重新加载历史记录
+     */
+    reloadHistory: () => void;
+}
+/**
+ * 搜索历史管理 Hook
+ * 支持自定义存储逻辑
+ */
+export declare const useSearchHistory: (options: UseSearchHistoryOptions) => UseSearchHistoryResult;

package/es/components/pisellLookup/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PisellLookup 组件导出
+ */
+export { PisellLookup } from './PisellLookup';
+export type { PisellLookupRef } from './types';
+export type * from './types';