@pisell/materials 1.8.1 → 1.8.3

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

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface GridProProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const PisellGridPro: (props: GridProProps) => React.JSX.Element;
+export default PisellGridPro;

package/es/components/pisellGridPro/GridView/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import { GridViewProps } from './type';
+export type { GridViewProps };
+declare const GridView: (props: GridViewProps) => React.JSX.Element;
+export default GridView;

package/es/components/pisellGridPro/GridView/type.d.ts

@@ -0,0 +1,3 @@
+import { PisellScrollViewProps } from '../../PisellScrollView/types';
+export interface GridViewProps extends PisellScrollViewProps {
+}

package/es/components/pisellGridPro/ToolBar/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import { ToolBarProps } from './type';
+export type { ToolBarProps };
+declare const Toolbar: React.FC<ToolBarProps>;
+export default Toolbar;

package/es/components/pisellGridPro/ToolBar/type.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+export interface ToolBarProps {
+    className?: string;
+    style?: React.CSSProperties;
+    tabs?: React.ReactNode;
+    topLeft?: React.ReactNode;
+    topRight?: React.ReactNode;
+    bottomLeft?: React.ReactNode;
+    bottomRight?: React.ReactNode;
+}

package/es/components/pisellGridPro/components/DataCard/components/StatCard/index.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { StatCardItem } from '../../types';
+import './index.less';
+/**
+ * StatCard 统计卡片组件
+ * @description 用于展示单个统计数据，包含标题、数值和对比信息
+ * @author Pisell Team
+ */
+declare const StatCard: React.FC<StatCardItem>;
+export default StatCard;

package/es/components/pisellGridPro/components/DataCard/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { DataCardProps } from './types';
+export type { DataCardProps };
+import './index.less';
+declare const DataCard: (props: DataCardProps) => React.JSX.Element | null;
+export default DataCard;

package/es/components/pisellGridPro/components/DataCard/types.d.ts

@@ -0,0 +1,70 @@
+import React from 'react';
+/**
+ * PisellGridProDataCard 组件属性接口
+ */
+export interface DataCardProps {
+    /**
+     * 统计卡片数据列表
+     */
+    dataItems?: StatCardItem[];
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: React.CSSProperties;
+}
+/**
+ * 统计卡片数据项接口
+ */
+export interface StatCardItem {
+    /**
+     * 唯一标识
+     */
+    key: string;
+    /**
+     * 卡片标题
+     * @example "Total Orders"
+     */
+    title: React.ReactNode;
+    /**
+     * 主要数值
+     * @example 50 或 "$1580"
+     */
+    value: React.ReactNode;
+    /**
+     * 对比数值
+     * @example "+12" 或 "-230"
+     */
+    compareValue?: React.ReactNode;
+    /**
+     * 对比趋势
+     * @description up-增长(绿色), down-下降(红色)
+     * @default undefined
+     */
+    trend?: 'up' | 'down';
+    /**
+     * 对比前缀文本
+     * @default "v.s. pre"
+     */
+    comparePrefix?: string;
+    /**
+     * 是否显示对比信息
+     * @default true
+     */
+    showCompare?: boolean;
+    /**
+     * 自定义卡片样式
+     */
+    style?: React.CSSProperties;
+    /**
+     * 自定义卡片类名
+     */
+    className?: string;
+    /**
+     * 点击回调
+     */
+    onClick?: () => void;
+}

package/es/components/pisellGridPro/components/Footer/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface FooterProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const Footer: (props: FooterProps) => React.JSX.Element;
+export default Footer;

package/es/components/pisellGridPro/components/Header/index.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import './index.less';
+export interface HeaderProps {
+    title?: React.ReactNode;
+    badge?: React.ReactNode;
+    subTitle?: React.ReactNode;
+    actionsList?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const Header: React.FC<HeaderProps>;
+export default Header;

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

@@ -0,0 +1,4 @@
+import { GridProProps } from './GridPro';
+export type { GridProProps };
+declare const PisellGridPro: any;
+export default PisellGridPro;

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

@@ -0,0 +1,11 @@
+import { Menu as AntdMenu } from 'antd';
+import React from 'react';
+import './PisellMenu.less';
+import type { PisellMenuProps } from './types';
+declare type PisellMenuComponent = React.FC<PisellMenuProps> & {
+    Item: typeof AntdMenu.Item;
+    SubMenu: typeof AntdMenu.SubMenu;
+    ItemGroup: typeof AntdMenu.ItemGroup;
+};
+declare const PisellMenu: PisellMenuComponent;
+export default PisellMenu;

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

@@ -0,0 +1,3 @@
+import PisellMenu from './PisellMenu';
+export type { PisellMenuProps } from './types';
+export default PisellMenu;

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

@@ -0,0 +1,27 @@
+/// <reference types="react" />
+import type { MenuProps } from 'antd';
+export interface PisellMenuProps extends Omit<MenuProps, 'items'> {
+    className?: string;
+    style?: React.CSSProperties;
+    mode?: 'vertical' | 'horizontal' | 'inline';
+    theme?: 'light' | 'dark';
+    defaultOpenKeys?: string[];
+    defaultSelectedKeys?: string[];
+    inlineCollapsed?: boolean;
+    openKeys?: string[];
+    selectedKeys?: string[];
+    onOpenChange?: (openKeys: string[]) => void;
+    dataSource?: any;
+    __designMode?: string;
+    other?: PisellMenuProps;
+}
+export interface MenuItemType {
+    key: string;
+    label: string;
+    path: string;
+    children?: MenuItemType[];
+    icon?: string | React.ReactNode;
+    hide?: boolean;
+    type?: 'group' | 'divider';
+    isGroup?: boolean;
+}

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import IpadModal from './IpadModal';
 import MobileModal from './MobileModal';
 import PcModal from './PcModal';

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

@@ -0,0 +1,85 @@
+import { CSSProperties } from 'react';
+import { Props as TreeItem } from "../pisellDraggable/components/TreeItem/TreeItem";
+export interface NavigationMenuItem {
+    id: string;
+    /** 标题 */
+    title: string;
+    /** 图标 */
+    icon?: string;
+    /** 描述 */
+    description?: string;
+    /** 子菜单 */
+    children?: NavigationMenuItem[];
+    /** 版本 */
+    version?: string;
+    /** 是否是分组 */
+    isGroup?: boolean;
+    /** 是否允许添加子菜单 */
+    allowAddChild?: boolean;
+    /** 是否允许删除 */
+    allowDelete?: boolean;
+    /** 是否允许编辑 */
+    allowEdit?: boolean;
+    /** 是否允许添加子菜单 */
+    allowAddSubmenu?: boolean;
+    /** 是否允许添加页面 */
+    allowAddPage?: boolean;
+    /** 其他属性 */
+    [key: string]: any;
+}
+export interface PisellNavigationMenuProps {
+    /** 导航菜单数据 */
+    value: NavigationMenuItem[];
+    /** 是否允许拖拽排序 */
+    allowDrag?: boolean;
+    /** 是否允许删除菜单项 */
+    allowDelete?: boolean;
+    /** 是否允许添加子菜单 */
+    allowAddChild?: boolean;
+    /** 是否允许添加根菜单 */
+    allowAddRoot?: boolean;
+    /** 是否允许显示隐藏 */
+    allowIsShow?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 菜单项间距 */
+    spacing?: number;
+    /** 最大层级数 */
+    maxLevel?: number;
+    /** 样式 */
+    style?: CSSProperties;
+    /** 类名 */
+    className?: string;
+    /** 数据变化回调 */
+    onChange?: (items: NavigationMenuItem[]) => void;
+    /** 设计模式 */
+    __designMode?: string;
+    /** 标题 */
+    title?: string;
+    /** 添加子菜单回调 */
+    onAddSubMenu?: (item?: NavigationMenuItem) => void;
+    /** 添加页面回调 */
+    onAddPage?: (item?: NavigationMenuItem) => void;
+    /** 编辑回调 */
+    onEdit?: (item: NavigationMenuItem) => void;
+    /** 删除回调 */
+    onDelete?: (item: NavigationMenuItem) => void;
+    /** 左侧自定义内容 */
+    leftContent?: React.ReactNode;
+    /** 右侧自定义内容 */
+    rightContent?: React.ReactNode;
+    /** 获取item样式 */
+    getItemStyle?: (itemProps: TreeItem) => React.CSSProperties;
+    /** 自定义拖拽判断函数，返回false时阻止拖拽 */
+    canDrop?: (dragItem: NavigationMenuItem, dropTarget: NavigationMenuItem, parentId: string | number | null) => boolean;
+    /** 显示隐藏回调 */
+    onIsShow?: (item: NavigationMenuItem) => void;
+    /** 节点缩进宽度 */
+    indentationWidth?: number;
+    /** 隐藏描述 */
+    hideDescription?: boolean;
+    /** 悬浮时展示action */
+    showActionOnHover?: boolean;
+    /** 是否展示标题标签 */
+    showTitleTags?: boolean;
+}

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

@@ -0,0 +1,15 @@
+/**
+ * 树节点的基本接口
+ */
+export interface TreeNode {
+    [key: string]: any;
+    children?: TreeNode[];
+}
+/**
+ * 格式化树结构数据
+ * @param tree 要格式化的树结构数据
+ * @param formatter 格式化函数，用于处理每个节点
+ * @param childrenField 子节点字段名，默认为 'children'
+ * @returns 格式化后的树结构
+ */
+export declare function formatTree<T extends TreeNode, R = T>(tree: T[], formatter: (node: T, level: number, parent: T | null) => R, childrenField?: string): R[];

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

@@ -0,0 +1,24 @@
+import React from 'react';
+import './index.less';
+export interface PisellQRScannerProps {
+    /** 是否可见 */
+    visible: boolean;
+    /** 是否显示上传图片按钮 */
+    showUpload?: boolean;
+    /** 关闭回调 */
+    onClose: () => void;
+    /** 扫码成功回调 */
+    onScan: (value: string) => void;
+    /**
+     * 样式属性，可选
+     * 注意: 不应传入renderMode等不必要属性
+     */
+    style?: React.CSSProperties;
+    /** 类名，可选 */
+    className?: string;
+}
+/**
+ * 二维码扫描组件
+ */
+declare const PisellQRScanner: React.FC<PisellQRScannerProps>;
+export default PisellQRScanner;

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

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+import { FilterItemProps } from '../filter/types';
+import { FormInstance } from 'antd';
+export declare type PisellQuickFilterProps = FormInstance & {
+    hasForm?: boolean;
+    children?: React.ReactNode;
+    formFiltersPrefix: string;
+    filterList?: FilterItemProps[];
+    quickFilterMaxLength: number;
+    hiddenQuickFilter: boolean;
+    hiddenOtherFilter: boolean;
+};

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

@@ -0,0 +1,21 @@
+import React from 'react';
+import './index.less';
+export interface PisellSectionHeadersProps {
+    /** 是否占据空间（true: 占据空间, false: 不占据空间） */
+    /** 左侧返回区域 */
+    backNode?: React.ReactNode;
+    /** 中间内容区域 */
+    centerNode?: React.ReactNode;
+    /** 右侧操作区域 */
+    actionNode?: React.ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 返回按钮点击事件 */
+    onBack?: () => void;
+    /** 操作区域点击事件 */
+    onAction?: () => void;
+}
+declare const PisellSectionHeaders: React.FC<PisellSectionHeadersProps>;
+export default PisellSectionHeaders;

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

@@ -0,0 +1,7 @@
+import { SortListProps } from '../sort/types';
+import { FormInstance } from 'antd';
+export declare type PisellSortProps = SortListProps & {
+    name?: string;
+} & FormInstance & {
+    hasForm?: boolean;
+};

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

@@ -0,0 +1,21 @@
+import React from 'react';
+import './index.less';
+export interface PisellStatisticListProps extends React.HTMLAttributes<HTMLDivElement> {
+    isHasBorder?: boolean;
+    backgroundColors?: string[];
+    labelColor?: string;
+    valueColor?: string;
+    data: {
+        label: string;
+        value: string;
+        isLink?: boolean;
+        link?: string;
+        tip?: string;
+        children?: {
+            label: string;
+            value: string;
+        }[];
+    }[];
+}
+declare const PisellStatisticList: (props: PisellStatisticListProps) => React.JSX.Element;
+export default PisellStatisticList;

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

@@ -0,0 +1,13 @@
+import React from 'react';
+import './index.less';
+export declare type PisellTagsType = 'pill_color' | 'pill_outline';
+export declare type PisellTagsColor = 'success' | 'warning' | 'error' | 'gray' | string;
+export interface PisellTagsProps extends React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement> {
+    children?: React.ReactNode;
+    others?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>;
+    type: PisellTagsType;
+    icon?: React.ReactNode;
+    color?: PisellTagsColor;
+}
+declare const PisellTags: (props: PisellTagsProps) => React.JSX.Element;
+export default PisellTags;

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

@@ -0,0 +1 @@
+export declare const generateColorShades: (color: string) => Record<string, string>;

package/es/components/pisellToast/squareToast/index.d.ts

@@ -0,0 +1,15 @@
+import { clear, show, success, info, loading, fail, hide } from './methods';
+import './index.less';
+interface ToastInstance {
+    show: typeof show;
+    clear: typeof clear;
+    success: typeof success;
+    info: typeof info;
+    loading: typeof loading;
+    fail: typeof fail;
+    error: typeof fail;
+    hide: typeof hide;
+}
+declare const Toast: ToastInstance;
+export declare const useToast: () => ToastInstance;
+export default Toast;

package/es/components/pisellToast/squareToast/methods.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { ToastProps } from './toast';
+interface ToastInstance {
+    close: () => void;
+}
+declare const show: (configOrContent: Partial<ToastProps> | React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const clear: () => void;
+declare const success: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const info: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const loading: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const fail: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
+declare const hide: () => void;
+export { show, clear, success, info, loading, fail, hide };

package/es/components/pisellToast/squareToast/renderImperatively.d.ts

@@ -0,0 +1,28 @@
+import type { ReactElement } from 'react';
+import type { Root } from 'react-dom/client';
+import React from 'react';
+declare type ImperativeProps = {
+    open?: boolean;
+    onCancel?: () => void;
+    afterClose?: () => void;
+};
+declare type TargetElement = ReactElement<ImperativeProps>;
+export declare type ImperativeHandler = {
+    close: () => void;
+    replace: (element: TargetElement) => void;
+    isRendered?: () => boolean;
+};
+export declare type UnmountType = () => Promise<void>;
+export declare type RenderType = (node: React.ReactElement, container: Element | DocumentFragment) => UnmountType;
+declare const MARK = "__pisell_react_root__";
+declare type ContainerType = (Element | DocumentFragment) & {
+    [MARK]?: Root;
+};
+export declare function render(node: React.ReactElement, container: ContainerType): void;
+export declare function unmount(container: ContainerType): Promise<void>;
+/**
+ * @deprecated 设置 React 渲染函数以兼容使用。
+ */
+export declare function unstableSetRender(render?: RenderType): RenderType;
+export declare function renderImperatively(element: TargetElement): ImperativeHandler;
+export {};