@pisell/materials 3.2.6 → 3.2.8

package/lib/components/login-and-register/index.d.ts

@@ -0,0 +1,82 @@
+import React from 'react';
+import './index.less';
+/**
+ * loginAndRegister组件的属性接口
+ */
+export interface loginAndRegisterProps {
+    /** Logo相关配置 */
+    showLogo?: boolean;
+    logo?: string;
+    logoPosition?: 'left' | 'center' | 'right';
+    logoSize?: {
+        width?: number;
+        height?: number;
+    };
+    /** 标题相关配置 */
+    title?: string;
+    showTitle?: boolean;
+    titleAlign?: 'left' | 'center' | 'right';
+    /** 副标题相关配置 */
+    subtitle?: string;
+    showSubtitle?: boolean;
+    subtitleAlign?: 'left' | 'center' | 'right';
+    /** 登录方式配置 */
+    loginMethods?: ('email' | 'google' | 'facebook' | 'apple')[];
+    defaultLoginMethod?: 'email' | 'google' | 'facebook' | 'apple';
+    /** 表单配置 */
+    emailLabel?: string;
+    passwordLabel?: string;
+    emailPlaceholder?: string;
+    passwordPlaceholder?: string;
+    emailRules?: any[];
+    buttonText?: string;
+    rememberMeText?: string;
+    forgotPasswordText?: string;
+    showRememberMe?: boolean;
+    showForgotPassword?: boolean;
+    /** 社交登录配置 */
+    socialLoginTexts?: {
+        google?: string;
+        facebook?: string;
+        apple?: string;
+    };
+    /** 底部配置 */
+    showFooter?: boolean;
+    showSignUp?: boolean;
+    signUpText?: string;
+    signUpLink?: string;
+    signUpPosition?: 'left' | 'center' | 'right';
+    otherLinks?: Array<{
+        text: string;
+        url: string;
+    }>;
+    otherLinksPosition?: 'left' | 'center' | 'right';
+    /** 登录/注册切换配置 */
+    showTabs?: boolean;
+    loginTabText?: string;
+    registerTabText?: string;
+    /** 注册表单配置 */
+    registerEmailPlaceholder?: string;
+    registerPasswordPlaceholder?: string;
+    registerButtonText?: string;
+    /** 事件回调 */
+    onLogin?: (values: {
+        email: string;
+        loginMethod: string;
+    }) => void;
+    onSocialLogin?: (type: 'google' | 'facebook' | 'apple') => void;
+    onSignUp?: () => void;
+    onRegister?: (values: {
+        email: string;
+        password: string;
+    }) => void;
+    /** 新增背景图片属性 */
+    backgroundImage?: string;
+}
+/**
+ * Saas登录组件
+ * @param props - 组件属性
+ * @returns React组件
+ */
+declare const loginAndRegister: React.FC<loginAndRegisterProps>;
+export default loginAndRegister;

package/lib/components/organizationTenantSwitcher/index.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import './index.less';
+interface OrganizationTenantSwitcherProps {
+    onChange?: (value: string, option: any) => void;
+    value: string;
+    options: {
+        label: string;
+        value: string;
+        logo?: string;
+    }[];
+    showLogo?: boolean;
+    showName?: boolean;
+    readOnly?: boolean;
+    onClick?: React.MouseEventHandler<HTMLDivElement>;
+}
+declare const OrganizationTenantSwitcher: React.FC<OrganizationTenantSwitcherProps>;
+export default OrganizationTenantSwitcher;

package/lib/components/page-header/index.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import './index.less';
+interface PageHeaderProps {
+    title?: React.ReactNode;
+    showTitle?: boolean;
+    subTitle?: React.ReactNode;
+    showSubTitle?: boolean;
+    showDivider?: boolean;
+    extra?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const PageHeader: (props: PageHeaderProps) => JSX.Element | null;
+export default PageHeader;

package/lib/components/pisellAnchor/index.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import './index.less';
+export interface Option {
+    id: string | number;
+    name: React.ReactNode;
+}
+export interface PisellAnchorProps {
+    options?: Option[];
+    tab?: string | number;
+    className?: string;
+    style?: React.CSSProperties;
+    onChange?: (key: string | number) => void;
+    onTabClick?: () => void;
+    containerRef?: React.RefObject<HTMLElement>;
+    /**
+     * 平台类型，仅用于样式调整，不再影响锚点滚动功能
+     * 无论pc还是h5模式，点击锚点都会自动滚动到对应内容
+     * @default 'pc'
+     */
+    platform?: 'pc' | 'h5';
+}
+declare const PisellAnchor: React.ForwardRefExoticComponent<PisellAnchorProps & React.RefAttributes<any>>;
+export default PisellAnchor;

package/lib/components/pisellAppCard/index.d.ts

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

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

@@ -0,0 +1,34 @@
+import { CSSProperties } from 'react';
+export interface PisellAppCardProps {
+    /** 类名 */
+    className?: string;
+    /** 样式 */
+    style?: CSSProperties;
+    /** 头像地址 */
+    avatar?: string;
+    /** icon */
+    icon?: string;
+    /** 标签列表 */
+    tags?: Array<{
+        label: string;
+        color?: 'success' | 'warning' | 'error' | 'gray';
+        type: 'pill_color' | 'pill_outline';
+    }>;
+    /** 标题 */
+    title: string;
+    /** 描述 */
+    description?: string;
+    /** 底部按钮列表 */
+    bottomButtons?: Array<{
+        label: string;
+        onClick?: () => void;
+        type?: 'primary' | 'default' | 'dashed' | 'link' | 'text';
+        hidden: boolean;
+    }>;
+    /** 右侧更多操作列表 */
+    moreActions?: Array<{
+        label: string;
+        onClick?: () => void;
+        icon?: React.ReactNode;
+    }>;
+}

package/lib/components/pisellDraggable/components/Action/Action.d.ts

@@ -0,0 +1,10 @@
+import React, { CSSProperties } from 'react';
+import './Action.less';
+export interface Props extends React.HTMLAttributes<HTMLButtonElement> {
+    active?: {
+        fill: string;
+        background: string;
+    };
+    cursor?: CSSProperties['cursor'];
+}
+export declare const Action: React.ForwardRefExoticComponent<Props & React.RefAttributes<HTMLButtonElement>>;

package/lib/components/pisellDraggable/components/Action/index.d.ts

@@ -0,0 +1,2 @@
+export { Action } from './Action';
+export type { Props as ActionProps } from './Action';

package/lib/components/pisellDraggable/components/Handle/Handle.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { ActionProps } from '../Action';
+export declare const Handle: React.ForwardRefExoticComponent<ActionProps & React.RefAttributes<HTMLButtonElement>>;

package/lib/components/pisellDraggable/components/Handle/index.d.ts

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

package/lib/components/pisellDraggable/components/Remove/Remove.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { ActionProps } from '../Action';
+export declare function Remove(props: ActionProps): JSX.Element;

package/lib/components/pisellDraggable/components/Remove/index.d.ts

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

package/lib/components/pisellDraggable/components/TreeItem/SortableTreeItem.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+import type { UniqueIdentifier } from '@dnd-kit/core';
+import { Props as TreeItemProps } from './TreeItem';
+interface Props extends TreeItemProps {
+    id: UniqueIdentifier;
+    __designMode?: string;
+}
+export declare function SortableTreeItem({ id, depth, ...props }: Props): JSX.Element;
+export {};

package/lib/components/pisellDraggable/components/TreeItem/TreeItem.d.ts

@@ -0,0 +1,23 @@
+import React, { HTMLAttributes } from 'react';
+import type { TreeItem as TreeItemType } from '../../types';
+import './TreeItem.less';
+export interface Props extends Omit<HTMLAttributes<HTMLLIElement>, 'id'> {
+    childCount?: number;
+    clone?: boolean;
+    collapsed?: boolean;
+    depth: number;
+    disableInteraction?: boolean;
+    disableSelection?: boolean;
+    ghost?: boolean;
+    handleProps?: any;
+    indicator?: boolean;
+    indentationWidth: number;
+    onCollapse?(): void;
+    onRemove?(): void;
+    wrapperRef?(node: HTMLLIElement): void;
+    item: TreeItemType;
+    renderItem?(item: Props, ref: React.ForwardedRef<HTMLDivElement>): React.ReactNode;
+    __designMode?: string;
+    isBlocked?: boolean;
+}
+export declare const TreeItem: React.ForwardRefExoticComponent<Props & React.RefAttributes<HTMLDivElement>>;

package/lib/components/pisellDraggable/components/TreeItem/index.d.ts

@@ -0,0 +1,2 @@
+export { TreeItem } from './TreeItem';
+export { SortableTreeItem } from './SortableTreeItem';

package/lib/components/pisellDraggable/components/index.d.ts

@@ -0,0 +1,4 @@
+export { Action } from './Action';
+export { Handle } from './Handle';
+export { Remove } from './Remove';
+export { TreeItem, SortableTreeItem } from './TreeItem';

package/lib/components/pisellDraggable/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 可拖拽树形组件
+ * 基于@dnd-kit库实现，支持拖拽排序、展开折叠、删除等功能
+ */
+import React from 'react';
+import type { TreeItem, TreeItems } from './types';
+import type { Props as TreeItemProps } from './components/TreeItem/TreeItem';
+interface Props {
+    /** 是否支持折叠功能 */
+    collapsible?: boolean;
+    /** 初始树形数据，默认使用 initialItems */
+    value?: TreeItems;
+    /** 缩进宽度，控制子节点的缩进距离 */
+    indentationWidth?: number;
+    /** 是否显示拖拽指示器 */
+    indicator?: boolean;
+    /** 是否支持删除节点功能 */
+    removable?: boolean;
+    /** 自定义渲染树节点 */
+    renderItem?: (item: TreeItemProps, ref: React.RefObject<HTMLDivElement>) => React.ReactNode;
+    /** 树形数据变化回调 */
+    onChange?: (items: TreeItems) => void;
+    /** 删除节点前 */
+    onRemoveBefore?: (item: TreeItem) => Promise<boolean>;
+    /** 设计模式 */
+    __designMode?: string;
+    /** 最大层级 */
+    maxLevel?: number;
+}
+export declare function SortableTree({ collapsible, value, indicator, indentationWidth, removable, renderItem, onChange, onRemoveBefore, __designMode, maxLevel, }: Props): JSX.Element;
+declare const Demo: (props: Props) => JSX.Element;
+export default Demo;

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

@@ -0,0 +1,19 @@
+import type { MutableRefObject } from 'react';
+import type { UniqueIdentifier } from '@dnd-kit/core';
+export interface TreeItem {
+    id: UniqueIdentifier;
+    children: TreeItem[];
+    collapsed?: boolean;
+    disabledDrop?: boolean;
+    [key: string]: any;
+}
+export declare type TreeItems = TreeItem[];
+export interface FlattenedItem extends TreeItem {
+    parentId: UniqueIdentifier | null;
+    depth: number;
+    index: number;
+}
+export declare type SensorContext = MutableRefObject<{
+    items: FlattenedItem[];
+    offset: number;
+}>;

package/lib/components/pisellDraggable/utilities.d.ts

@@ -0,0 +1,17 @@
+import type { UniqueIdentifier } from '@dnd-kit/core';
+import type { FlattenedItem, TreeItem, TreeItems } from './types';
+export declare const iOS: boolean;
+export declare function getProjection(items: FlattenedItem[], activeId: UniqueIdentifier, overId: UniqueIdentifier, dragOffset: number, indentationWidth: number): {
+    depth: number;
+    maxDepth: number;
+    minDepth: number;
+    parentId: UniqueIdentifier | null;
+};
+export declare function flattenTree(items: TreeItems): FlattenedItem[];
+export declare function buildTree(flattenedItems: FlattenedItem[]): TreeItems;
+export declare function findItem(items: TreeItem[], itemId: UniqueIdentifier): TreeItem | undefined;
+export declare function findItemDeep(items: TreeItems, itemId: UniqueIdentifier): TreeItem | undefined;
+export declare function removeItem(items: TreeItems, id: UniqueIdentifier): TreeItem[];
+export declare function setProperty<T extends keyof TreeItem>(items: TreeItems, id: UniqueIdentifier, property: T, setter: (value: TreeItem[T]) => TreeItem[T]): TreeItem[];
+export declare function getChildCount(items: TreeItems, id: UniqueIdentifier): number;
+export declare function removeChildrenOf(items: FlattenedItem[], ids: UniqueIdentifier[]): FlattenedItem[];

package/lib/components/pisellDropSort/PisellDropSort.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { PisellDropSortProps } from './types';
+import './PisellDropSort.less';
+declare const PisellDropSort: React.FC<PisellDropSortProps>;
+export default PisellDropSort;

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

@@ -0,0 +1,25 @@
+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;
+    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) => JSX.Element;
+export default SortableItem;

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

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

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

@@ -0,0 +1,52 @@
+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;
+    /** 是否禁用 */
+    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;
+}

package/lib/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/lib/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/lib/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/lib/components/pisellLayout/index.d.ts

@@ -0,0 +1,14 @@
+import type { LayoutProps } from 'antd';
+import { Layout } from 'antd';
+import React from 'react';
+export interface PisellLayoutProps extends LayoutProps {
+    children?: React.ReactNode;
+}
+interface CompoundedComponent extends React.FC<PisellLayoutProps> {
+    Header: typeof Layout.Header;
+    Content: typeof Layout.Content;
+    Footer: typeof Layout.Footer;
+    Sider: typeof Layout.Sider;
+}
+declare const PisellLayout: CompoundedComponent;
+export default PisellLayout;

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

@@ -0,0 +1,9 @@
+import React from 'react';
+import './PisellMenu.less';
+import type { PisellMenuProps } from './types';
+declare const PisellMenu: {
+    ({ className, style, mode, theme, defaultOpenKeys, defaultSelectedKeys, inlineCollapsed, openKeys, selectedKeys, onOpenChange, onSelect, dataSource, __designMode, children, other, ...restProps }: PisellMenuProps): JSX.Element;
+    Item: Omit<React.FunctionComponent<import("antd").MenuItemProps>, ""> & (<T extends import("antd").MenuItemProps>(props: T extends infer U extends import("antd").MenuItemProps ? unknown extends U ? import("antd").MenuItemProps : U : import("antd").MenuItemProps, context?: any) => React.ReactElement<any, any> | null);
+    SubMenu: React.FC<import("antd").SubMenuProps>;
+};
+export default PisellMenu;

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

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

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

@@ -0,0 +1,26 @@
+/// <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';
+}

package/lib/components/pisellModal/components/Information/index.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { PisellModalProps } from '../../index';
+import './index.less';
+export interface InformationProps extends PisellModalProps {
+    /** 标题 */
+    title: string;
+    /** 描述 */
+    describe: string;
+    /** 取消按钮是否展示 */
+    cancelVisible?: boolean;
+    /** 确认按钮是否展示 */
+    okVisible?: boolean;
+    /** 确认按钮文字 */
+    okText: React.ReactNode;
+    /** 取消按钮文字 */
+    cancelText: React.ReactNode;
+    /** 右上角关闭按钮是否展示 */
+    closable?: boolean;
+}
+declare const Information: (props: InformationProps) => JSX.Element;
+export default Information;

package/lib/components/pisellNavigationMenu/index.d.ts

@@ -0,0 +1,3 @@
+import PisellNavigationMenu from './PisellNavigationMenu';
+export default PisellNavigationMenu;
+export type { PisellNavigationMenuProps, NavigationMenuItem } from './types';

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

@@ -0,0 +1,64 @@
+import { CSSProperties } from 'react';
+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;
+    /** 是否禁用 */
+    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;
+}

package/lib/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[];