@pisell/materials 3.3.87 → 3.3.89

package/es/components/pisellUrl/utils/urlHelper.d.ts

@@ -0,0 +1,63 @@
+/**
+ * URL 辅助函数
+ */
+/**
+ * 规范化 URL（补全协议）
+ * @param url URL 地址
+ * @param defaultProtocol 默认协议
+ * @returns 规范化后的 URL
+ *
+ * @example
+ * normalizeUrl('example.com', 'https://') // 'https://example.com'
+ * normalizeUrl('http://example.com', 'https://') // 'http://example.com'
+ */
+export declare function normalizeUrl(url: string, defaultProtocol?: string): string;
+/**
+ * 智能补全协议（识别 localhost）
+ * @param url URL 地址
+ * @returns 规范化后的 URL
+ *
+ * @example
+ * smartNormalizeUrl('localhost:3000') // 'http://localhost:3000'
+ * smartNormalizeUrl('example.com') // 'https://example.com'
+ */
+export declare function smartNormalizeUrl(url: string): string;
+/**
+ * 提取域名
+ * @param url URL 地址
+ * @returns 域名
+ *
+ * @example
+ * extractDomain('https://www.example.com/path') // 'www.example.com'
+ */
+export declare function extractDomain(url: string): string;
+/**
+ * 处理链接跳转（安全性保障）
+ * @param url URL 地址
+ * @param openInNewWindow 是否新窗口打开
+ * @param defaultProtocol 默认协议
+ *
+ * @example
+ * handleUrlClick('example.com', true, 'https://')
+ */
+export declare function handleUrlClick(url: string, openInNewWindow?: boolean, defaultProtocol?: string): void;
+/**
+ * 检测是否为安全链接（HTTPS）
+ * @param url URL 地址
+ * @returns 是否为 HTTPS
+ *
+ * @example
+ * isSecureUrl('https://example.com') // true
+ * isSecureUrl('http://example.com') // false
+ */
+export declare function isSecureUrl(url: string): boolean;
+/**
+ * 提取 URL 参数
+ * @param url URL 地址
+ * @returns 参数对象
+ *
+ * @example
+ * extractUrlParams('https://example.com?foo=bar&baz=qux')
+ * // { foo: 'bar', baz: 'qux' }
+ */
+export declare function extractUrlParams(url: string): Record<string, string>;

package/es/components/pisellUrl/utils/urlValidator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * URL 校验工具函数
+ */
+/**
+ * URL 格式校验（使用 URL 构造函数）
+ * @param url URL 地址
+ * @returns 是否通过校验
+ *
+ * @example
+ * validateUrl('https://example.com') // true
+ * validateUrl('invalid-url') // false
+ */
+export declare function validateUrl(url: string): boolean;
+/**
+ * URL 正则校验（备选方法）
+ * @param url URL 地址
+ * @returns 是否通过校验
+ */
+export declare function validateUrlByRegex(url: string): boolean;
+/**
+ * 解析 URL 各部分
+ * @param url URL 地址
+ * @returns URL 各部分或 null
+ *
+ * @example
+ * parseUrl('https://example.com:8080/path?key=value#hash')
+ * // { protocol: 'https', host: 'example.com', port: '8080', ... }
+ */
+export declare function parseUrl(url: string): {
+    protocol: string;
+    host: string;
+    port: string;
+    pathname: string;
+    search: string;
+    hash: string;
+} | null;
+/**
+ * 协议白名单校验
+ * @param url URL 地址
+ * @param allowedProtocols 允许的协议列表
+ * @returns 校验结果
+ */
+export declare function validateUrlProtocol(url: string, allowedProtocols: string[]): {
+    isValid: boolean;
+    errors: string[];
+};

package/es/components/productCard/components/Packages/utils.d.ts

@@ -17,4 +17,4 @@ export declare const minusSign: (item: any, type?: string) => "-" | "";
  * @Author: WangHan
  * @Date: 2024-11-22 10:58
  */
-export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => string | number;
+export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => any;

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

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const Radio: (props: any) => import("react").JSX.Element;
 export default Radio;

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

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const Skeleton: (props: any) => import("react").JSX.Element;
 export default Skeleton;

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

@@ -0,0 +1,39 @@
+import { MenuProps } from "antd";
+import React from "react";
+/** 单个排序子项（如 A→Z、0→9），由组件的 getSortItems 返回 */
+export declare type SortOptionItem = {
+    key: string;
+    label: string;
+};
+export declare type SortItemProps = {
+    /** 排序类型，与 sortChildrenMap 对应；当 getSortItems 存在时可省略 */
+    type?: "date" | "string" | "number" | "option";
+    label?: string;
+    name?: string | string[];
+    isCustom: boolean;
+    columnKey?: string;
+    localFilter?: boolean;
+    isHidden?: boolean;
+    /** 由组件内置导出：直接返回该列的排序子项，优先于 type */
+    getSortItems?: (fieldKey: string) => SortOptionItem[];
+};
+/**
+ * 组件侧导出的排序支持契约（如 PisellSingleLineText.SortOptions）。
+ * 支持两种形态：
+ * - getSortItems：组件内置完整排序项（key + label），优先使用；
+ * - type：仅类型，由 Sort 的 sortChildrenMap 生成子项（兼容旧用法）。
+ */
+export declare type SortOptionType = (Pick<SortItemProps, "type"> & Partial<Pick<SortItemProps, "label" | "localFilter" | "isHidden">>) | {
+    getSortItems: (fieldKey: string) => SortOptionItem[];
+    label?: string;
+    isHidden?: boolean;
+};
+export declare type SortListProps = {
+    list: SortItemProps[];
+    onChange?: (val: string, detail: Parameters<Required<MenuProps>["onClick"]>[0]) => void;
+    button?: React.ReactNode;
+    style?: React.CSSProperties;
+    value?: any;
+    placement?: "bottom" | "bottomLeft" | "bottomRight" | "top" | "topLeft" | "topRight";
+    localPagination?: boolean;
+};

package/es/components/table/Table/fields/select/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/es/components/table/Table/fields/treeSelect/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import filter from "./filterUtil";
 declare const _default: {
     field: {

package/es/components/table/Table/fields/types/index.d.ts

@@ -0,0 +1,33 @@
+/// <reference types="react" />
+export declare type FieldPropsType = {
+    title: React.ReactNode;
+    editable: boolean;
+    dataIndex: string;
+    field_type: FieldType;
+    record: Record<string, any>;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    handleSave: () => void;
+    onChange: (value: any, record: any) => void;
+    action?: string;
+    contentClassName?: string;
+};
+export declare type FieldType = "text" | "image";
+export declare type EditPropsType = {
+    value: any;
+    onChange: (v: any) => void;
+    onPressEnter: () => void;
+    onBlur: () => void;
+    style: React.CSSProperties;
+    bordered: boolean;
+    options?: {
+        value: string;
+        label: string;
+    }[] | ((value?: string) => Promise<{
+        value: string;
+        label: string;
+    }[]>);
+    [key: string]: any;
+};

package/es/components/table/Table/utils.d.ts

@@ -155,7 +155,7 @@ export declare const getSettingKeyArrByMode: ({ filter, columnSetting, dataSourc
     sort?: SortType | undefined;
     mode: "" | "localStorage" | "remote";
     currentViewMode: ModeType;
-}) => ("view_mode" | "filter_setting" | "group_by" | "order_by" | "column_setting" | "gallery_setting" | "filters")[];
+}) => ("filters" | "column_setting" | "gallery_setting" | "order_by" | "group_by" | "view_mode" | "filter_setting")[];
 export declare const omit: (obj: Record<string, any>, keys: string[]) => Record<string, any>;
 export declare const stringify: (obj: Record<string, any>) => string;
 export {};

package/es/components/time-picker/index.d.ts

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const TimePicker: (props: any) => import("react").JSX.Element;
 export default TimePicker;

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

@@ -1,2 +1,3 @@
+/// <reference types="react" />
 declare const Upload: (props: any) => import("react").JSX.Element;
 export default Upload;

package/es/components/virtual-keyboard/Time/utils.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 export declare const formatStringToTime: (value: string) => {
     valueArray: string[];
     valueString: string;

package/es/components/virtualInput/BaseVirtualInput/index.d.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+import './index.less';
+export interface BaseVirtualInputProps {
+    /** 输入值 */
+    value?: string | React.ReactNode;
+    /** 占位符 */
+    placeholder?: string;
+    /** 是否自动聚焦 */
+    autoFocus?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 组件高度，默认60px */
+    height?: number | string;
+    /** 字体大小，默认48px，如果不设置会根据高度自动计算 */
+    fontSize?: number | string;
+    /** 聚焦回调 */
+    onFocus?: () => void;
+    /** 失焦回调 */
+    onBlur?: () => void;
+    /** 文字位置 */
+    textAlign?: 'start' | 'center' | 'end';
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 自定义类名 */
+    className?: string;
+    /** showCursor  */
+    showCursor?: boolean;
+    /** 防止失焦的元素选择器或ref */
+    preventBlurElements?: Array<string | React.RefObject<HTMLElement>>;
+    /** 是否聚焦（受控模式） */
+    focused?: boolean;
+    /** 是否选中全部文本（类似浏览器选中效果） */
+    selected?: boolean;
+    /** 选中状态的背景色，默认为主题色 */
+    selectedColor?: string;
+}
+export interface BaseVirtualInputRef {
+    /** 手动聚焦 */
+    focus: () => void;
+    /** 手动失焦 */
+    blur: () => void;
+}
+declare const BaseVirtualInput: React.ForwardRefExoticComponent<BaseVirtualInputProps & React.RefAttributes<BaseVirtualInputRef>>;
+export default BaseVirtualInput;

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

@@ -0,0 +1,29 @@
+import React from 'react';
+import { BaseVirtualInputProps, BaseVirtualInputRef } from './BaseVirtualInput';
+import './index.less';
+export type { BaseVirtualInputProps, BaseVirtualInputRef } from './BaseVirtualInput';
+export interface VirtualInputProps extends BaseVirtualInputProps {
+    /** 在VirtualInput上方显示的额外内容 */
+    topContent?: React.ReactNode;
+    /** 在VirtualInput下方显示的额外内容 */
+    bottomContent?: React.ReactNode;
+    /** wrapper class */
+    wrapperClassName?: string;
+    /** 虚拟输入框包装器的样式 */
+    wrapperStyle?: React.CSSProperties;
+    /** 是否允许清除输入框中的内容 */
+    allowClear?: boolean;
+    /** 清除输入框内容的回调函数 */
+    onClear?: () => void;
+    /** 自定义清除按钮的样式 */
+    clearButtonStyle?: React.CSSProperties;
+    theme?: {
+        token?: {
+            colorPrimary?: string;
+        };
+    };
+}
+export interface VirtualInputRef extends BaseVirtualInputRef {
+}
+declare const VirtualInput: React.ForwardRefExoticComponent<VirtualInputProps & React.RefAttributes<VirtualInputRef>>;
+export default VirtualInput;

package/es/hooks/useMobile.d.ts

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

package/es/hooks/useThemeTokens.d.ts

@@ -0,0 +1,7 @@
+declare type ThemeInput = {
+    token?: {
+        colorPrimary?: string;
+    };
+};
+declare const useThemeTokens: (themeInput?: ThemeInput) => any;
+export default useThemeTokens;

package/es/index.d.ts

@@ -166,6 +166,10 @@ export { default as FormItemTranslation } from './components/dataSourceComponent
 export { default as FormItemUpload } from './components/dataSourceComponents/fields/Upload';
 export { default as FormItemIconSelect } from './components/dataSourceComponents/fields/IconSelect';
 export { default as BaseTranslation } from './components/dataSourceComponents/fields/Translation/BaseTranslation';
+export { default as DataSourceSubForm } from './components/dataSourceComponents/dataSourceSubForm';
+export type { DataSourceSubFormProps } from './components/dataSourceComponents/dataSourceSubForm/types';
+export { default as FormItemRecordListWrapper } from './components/dataSourceComponents/fields/RecordListWrapper';
+export { default as FormItemTabs } from './components/dataSourceComponents/fields/Tabs';
 export { default as PisellMenu } from './components/pisellMenu';
 export type { PisellMenuProps } from './components/pisellMenu/types';
 export { default as PisellNavigationMenu } from './components/pisellNavigationMenu';

package/es/index.js

@@ -182,6 +182,9 @@ export { default as FormItemTranslation } from "./components/dataSourceComponent
 export { default as FormItemUpload } from "./components/dataSourceComponents/fields/Upload";
 export { default as FormItemIconSelect } from "./components/dataSourceComponents/fields/IconSelect";
 export { default as BaseTranslation } from "./components/dataSourceComponents/fields/Translation/BaseTranslation";
+export { default as DataSourceSubForm } from "./components/dataSourceComponents/dataSourceSubForm";
+export { default as FormItemRecordListWrapper } from "./components/dataSourceComponents/fields/RecordListWrapper";
+export { default as FormItemTabs } from "./components/dataSourceComponents/fields/Tabs";
 
 // ==================== 导航组件 (Navigation) ====================
 // 导航、菜单、标签页等组件

package/es/theme/tokens.d.ts

@@ -0,0 +1,22 @@
+import { ThemeConfig } from 'antd';
+/**
+ * Pisell 项目统一的 Ant Design Token 配置
+ * 基于 Figma 设计规范
+ *
+ * 使用场景：
+ * - 低代码平台（page/index.tsx）
+ * - Storybook 预览
+ * - 其他需要主题配置的场景
+ */
+/**
+ * 获取组件级别的 token 配置
+ */
+export declare function getComponentsToken(): ThemeConfig['components'];
+/**
+ * 获取全局 token 配置
+ */
+export declare function getGlobalToken(themeColor?: string): ThemeConfig['token'];
+/**
+ * 获取完整的主题配置
+ */
+export declare function getThemeConfig(themeColor?: string): ThemeConfig;

package/es/utils/tagColor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 只读态 Tag 未传 color 时使用的预设色板（按索引稳定分配）
+ */
+/**
+ * 根据 value 或索引从预设色板取一个稳定颜色（未传 option.color 时使用）
+ */
+export declare function getDefaultTagColor(value: unknown, index: number): string;

package/lib/components/PisellBasicGrid/PisellBasicGrid.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { PisellBasicGridProps } from './types';
+import './PisellBasicGrid.less';
+/**
+ * 使用 memo 优化组件性能
+ * @description 当 props 没有变化时，避免不必要的重新渲染
+ */
+declare const MemoizedPisellBasicGrid: <T>(props: PisellBasicGridProps<T>) => React.JSX.Element;
+export { MemoizedPisellBasicGrid as PisellBasicGrid };
+export default MemoizedPisellBasicGrid;

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

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

package/lib/components/PisellBasicGrid/hooks/useGridStyle.d.ts

@@ -0,0 +1,37 @@
+import type { DirectionType, WrapType, JustifyType, AlignType, AlignContentType, UseGridStyleReturn } from '../types';
+/**
+ * useGridStyle Hook 参数
+ */
+interface UseGridStyleParams {
+    /** 排列方向 */
+    direction?: DirectionType;
+    /** 换行控制 */
+    wrap?: WrapType;
+    /** 一行显示的元素个数 */
+    columns?: number;
+    /** 是否等分容器宽度 */
+    equalWidth?: boolean;
+    /** 统一间距 */
+    gap?: number | string;
+    /** 行间距 */
+    rowGap?: number | string;
+    /** 列间距 */
+    columnGap?: number | string;
+    /** 主轴对齐方式 */
+    justify?: JustifyType;
+    /** 交叉轴对齐方式 */
+    align?: AlignType;
+    /** 多行对齐方式 */
+    alignContent?: AlignContentType;
+}
+/**
+ * 计算 Grid 布局样式的 Hook
+ * @param params - 布局参数
+ * @returns 容器样式和子元素样式
+ * @description
+ * - 根据传入的布局参数计算容器的 flex 样式
+ * - 根据 columns 和 gap 计算子元素的 flex-basis
+ * - 使用 useMemo 缓存计算结果，避免不必要的重复计算
+ */
+export declare const useGridStyle: (params: UseGridStyleParams) => UseGridStyleReturn;
+export default useGridStyle;

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

@@ -0,0 +1,6 @@
+/**
+ * PisellBasicGrid 组件导出
+ * @description 基于 Flexbox 的基础布局组件
+ */
+export { PisellBasicGrid, default } from './PisellBasicGrid';
+export type { PisellBasicGridProps, DirectionType, WrapType, JustifyType, AlignType, AlignContentType, BreakpointType, ResponsiveConfig, } from './types';

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

@@ -0,0 +1,221 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 排列方向类型
+ * @description 控制子元素的排列方向
+ */
+export declare type DirectionType = 'horizontal' | 'horizontal-reverse' | 'vertical' | 'vertical-reverse';
+/**
+ * 换行类型
+ * @description 控制子元素是否换行
+ */
+export declare type WrapType = 'nowrap' | 'wrap' | 'wrap-reverse';
+/**
+ * 主轴对齐类型
+ * @description 控制子元素在主轴上的对齐方式
+ */
+export declare type JustifyType = 'start' | 'end' | 'center' | 'between' | 'around' | 'evenly';
+/**
+ * 交叉轴对齐类型
+ * @description 控制子元素在交叉轴上的对齐方式
+ */
+export declare type AlignType = 'start' | 'end' | 'center' | 'stretch' | 'baseline';
+/**
+ * 多行对齐类型
+ * @description 控制多行时行与行之间的对齐方式
+ */
+export declare type AlignContentType = 'start' | 'end' | 'center' | 'between' | 'around' | 'stretch';
+/**
+ * 响应式断点类型
+ * @description 响应式配置的断点名称
+ */
+export declare type BreakpointType = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+/**
+ * 响应式配置类型（预留）
+ * @description 用于配置不同断点下的布局属性
+ */
+export interface ResponsiveConfig {
+    /** 一行显示的元素个数 */
+    columns?: number;
+    /** 间距 */
+    gap?: number | string;
+    /** 排列方向 */
+    direction?: DirectionType;
+}
+/**
+ * PisellBasicGrid 组件 Props
+ * @template T - 数据源项的类型
+ * @description 基于 Flexbox 的基础布局组件属性定义
+ */
+export interface PisellBasicGridProps<T = any> {
+    /**
+     * 子元素
+     * @description 当未传入 dataSource 时使用
+     */
+    children?: ReactNode;
+    /**
+     * 自定义类名
+     * @description 添加到容器元素的额外类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     * @description 支持所有 CSS 属性，会与组件计算的样式合并
+     */
+    style?: CSSProperties;
+    /**
+     * 排列方向
+     * @default 'horizontal'
+     * @description
+     * - horizontal: 横向排列
+     * - horizontal-reverse: 横向反向排列
+     * - vertical: 竖向排列
+     * - vertical-reverse: 竖向反向排列
+     */
+    direction?: DirectionType;
+    /**
+     * 换行控制
+     * @default 'nowrap'
+     * @description
+     * - nowrap: 不换行
+     * - wrap: 换行
+     * - wrap-reverse: 反向换行
+     */
+    wrap?: WrapType;
+    /**
+     * 一行显示的元素个数
+     * @description 设置后子元素宽度为 calc((100% - gap * (N-1)) / N)
+     * @note 优先级高于 equalWidth
+     */
+    columns?: number;
+    /**
+     * 是否等分容器宽度
+     * @default false
+     * @description 设置为 true 时，子元素会平均分配容器宽度 (flex: 1)
+     * @note 当设置了 columns 时，此属性无效
+     */
+    equalWidth?: boolean;
+    /**
+     * 间距（统一设置行列间距）
+     * @description 数字类型默认单位为 px，也可传入带单位的字符串
+     * @example gap={16} 或 gap="1rem"
+     */
+    gap?: number | string;
+    /**
+     * 行间距
+     * @description 优先级高于 gap
+     */
+    rowGap?: number | string;
+    /**
+     * 列间距
+     * @description 优先级高于 gap
+     */
+    columnGap?: number | string;
+    /**
+     * 主轴对齐方式
+     * @default 'start'
+     * @description
+     * - start: 起始对齐
+     * - end: 末尾对齐
+     * - center: 居中对齐
+     * - between: 两端对齐
+     * - around: 等间距对齐
+     * - evenly: 均匀分布
+     */
+    justify?: JustifyType;
+    /**
+     * 交叉轴对齐方式
+     * @default 'stretch'
+     * @description
+     * - start: 顶部对齐
+     * - end: 底部对齐
+     * - center: 居中对齐
+     * - stretch: 拉伸填充
+     * - baseline: 基线对齐
+     */
+    align?: AlignType;
+    /**
+     * 多行对齐方式
+     * @default 'stretch'
+     * @description 当存在多行时，控制行与行之间的对齐方式
+     * - start: 顶部对齐
+     * - end: 底部对齐
+     * - center: 居中对齐
+     * - between: 两端对齐
+     * - around: 等间距对齐
+     * - stretch: 拉伸填充
+     */
+    alignContent?: AlignContentType;
+    /**
+     * 响应式配置（预留）
+     * @description 当前版本暂不实现，后续版本迭代
+     */
+    responsive?: Partial<Record<BreakpointType, ResponsiveConfig>>;
+    /**
+     * 数据源数组
+     * @description
+     * - 当传入 dataSource 时，组件内部会自动循环渲染
+     * - dataSource 为 undefined 时，渲染 children
+     * - dataSource 为空数组时，不渲染任何内容
+     */
+    dataSource?: T[];
+    /**
+     * 渲染函数
+     * @param item - 当前数据项
+     * @param index - 当前索引
+     * @returns ReactNode
+     * @description 用于自定义每个数据项的渲染内容
+     */
+    renderItem?: (item: T, index: number) => ReactNode;
+    /**
+     * 指定每项的唯一 key
+     * @description
+     * - 传入 string 时，作为数据项的属性名获取 key
+     * - 传入函数时，通过函数返回 key
+     * - 不传时，默认使用 index 作为 key
+     * @example rowKey="id" 或 rowKey={(item, index) => `item-${item.id}`}
+     */
+    rowKey?: string | ((item: T, index: number) => string);
+    /**
+     * 前置插槽
+     * @description 在数据源渲染之前渲染
+     */
+    startSlot?: ReactNode;
+    /**
+     * 后置插槽
+     * @description 在数据源渲染之后渲染
+     */
+    endSlot?: ReactNode;
+}
+/**
+ * 容器样式配置
+ * @description useGridStyle Hook 返回的容器样式类型
+ */
+export interface ContainerStyle extends CSSProperties {
+    display: 'flex';
+    flexDirection: CSSProperties['flexDirection'];
+    flexWrap: CSSProperties['flexWrap'];
+    justifyContent: CSSProperties['justifyContent'];
+    alignItems: CSSProperties['alignItems'];
+    alignContent?: CSSProperties['alignContent'];
+    gap?: CSSProperties['gap'];
+    rowGap?: CSSProperties['rowGap'];
+    columnGap?: CSSProperties['columnGap'];
+}
+/**
+ * 子元素样式配置
+ * @description useGridStyle Hook 返回的子元素样式类型
+ */
+export interface ItemStyle extends CSSProperties {
+    flexBasis?: CSSProperties['flexBasis'];
+    flexGrow?: CSSProperties['flexGrow'];
+    flexShrink?: CSSProperties['flexShrink'];
+}
+/**
+ * useGridStyle Hook 返回值类型
+ */
+export interface UseGridStyleReturn {
+    /** 容器样式 */
+    containerStyle: ContainerStyle;
+    /** 子元素样式 */
+    itemStyle: ItemStyle;
+}