@pisell/materials 6.3.41 → 6.3.43

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/AmountFooter/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 declare const Footer: ({ item, hideDivider, type, isOnlyTotal }: any) => JSX.Element;
 export default Footer;

package/es/components/productCard/components/Header/DeleteButton/index.d.ts

@@ -0,0 +1,3 @@
+import './index.less';
+declare const DeleteButton: ({ onDelete }: any) => JSX.Element;
+export default DeleteButton;

package/es/components/productCard/components/MultiDay/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 declare const MultiDay: ({ dataSource, hideDivider }: any) => JSX.Element;
 export default MultiDay;

package/es/components/productCard/components/Note/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 declare const Note: (props: any) => JSX.Element | null;
 export default Note;

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

@@ -1,2 +1 @@
-/// <reference types="react" />
 export declare const renderBundles: (item: any, hidePrice?: boolean, isShowPackageNote?: boolean) => JSX.Element;

package/es/components/productCard/components/Packages/components/options/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 declare const Options: ({ options, amountSymbol }: any) => JSX.Element | null;
 export default Options;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 declare const Packages: ({ item, isShowPackageNote }: any) => JSX.Element | null;
 export default Packages;

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) => any;
+export declare const _formatAmount: (price?: number, amountSymbol?: string, digit?: number) => string | number;

package/es/components/productCard/components/Time/components/SelectResource/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 interface ResourceItem {
     id: string | number;

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

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

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/Actions/component/ExportImport/components/ExportFile/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { ExportImportType } from '../../../../../types';
 import './index.less';
 declare const ExportFile: (props: {

package/es/components/table/Actions/component/ExportImport/components/ImportLog/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { ExportImportType } from '../../../../../types';
 import './index.less';
 declare const ImportLog: (props: {

package/es/components/table/Actions/component/ExportImport/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { ExportImportType } from '../../../types';
 import './index.less';
 declare type ExportImportProps = {

package/es/components/table/Actions/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { FilterType } from "../../filter/types";
 import { ColumnSettingType, DataSourceGroupType, ExportImportType, GallerySettingType, GridViewType, SortType } from "../types";
 import "./index.less";

package/es/components/table/BasicTable/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { TableProps } from 'antd';
 declare const BasicTable: (props: TableProps<any>) => JSX.Element;
 export default BasicTable;

package/es/components/table/Gallery/components/GalleryItem/components/RenderFields/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import "./index.less";
 declare type RenderFieldsProps = {
     fields: string[];

package/es/components/table/Table/SelectField/index.d.ts

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

package/es/components/table/Table/fields/date/Show/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { FieldPropsType } from "../../types";
 declare const Show: (props: FieldPropsType) => JSX.Element;
 export default Show;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 export declare const fieldMaps: {
     text: {
         field: {

package/es/components/table/Table/fields/link/Show/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { FieldPropsType } from "../../types";
 declare const Show: (props: FieldPropsType) => JSX.Element;
 export default Show;

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/tableConfig/SortRow/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import "./index.less";
 declare const SortRow: ({ children, rowKey, onSortChange }: any) => JSX.Element;
 export default SortRow;

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" | "group_by" | "column_setting" | "order_by" | "filters" | "filter_setting" | "gallery_setting")[];
+}) => ("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/table/View/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { GridViewProps } from '../types';
 declare const View: (props: GridViewProps & {
     setTableSetting: (values: Record<string, any>) => void;

package/es/components/table/hooks/useTableSetting.js

@@ -1,3 +1,9 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
@@ -246,14 +252,44 @@ var useTableSetting = function useTableSetting(params) {
             return Array.isArray(rawName) ? rawName.join(",") : String(rawName);
           }).filter(Boolean));
         }
+
+        // 先把 persistedFilters 扁平化，变成 "item,name": "Solar Panel" 的格式
+        var flatPersistedFilters = {};
+        Object.entries(persistedFilters || {}).forEach(function (_ref2) {
+          var _ref3 = _slicedToArray(_ref2, 2),
+            key = _ref3[0],
+            value = _ref3[1];
+          if (_typeof(value) === 'object' && value !== null && !Array.isArray(value)) {
+            // 处理嵌套对象，比如 { item: { name: "xxx" } } → "item,name": "xxx"
+            Object.entries(value).forEach(function (_ref4) {
+              var _ref5 = _slicedToArray(_ref4, 2),
+                subKey = _ref5[0],
+                subValue = _ref5[1];
+              flatPersistedFilters["".concat(key, ",").concat(subKey)] = subValue;
+            });
+          } else {
+            flatPersistedFilters[key] = value;
+          }
+        });
         var excluded = new Set((localSettings === null || localSettings === void 0 ? void 0 : localSettings.excludedFilterFields) || []);
         var allowed = new Set(Array.from(names).filter(function (k) {
           return !excluded.has(k);
         }));
         var filtered = {};
-        Object.keys(persistedFilters || {}).forEach(function (k) {
+        Object.keys(flatPersistedFilters || {}).forEach(function (k) {
           if (allowed.has(k)) {
-            filtered[k] = persistedFilters[k];
+            var _k$split, _k$split2;
+            // filtered[k] = persistedFilters[k];
+            // 再把扁平化的 key 还原回嵌套结构
+            var parts = (_k$split = k === null || k === void 0 || (_k$split2 = k.split) === null || _k$split2 === void 0 ? void 0 : _k$split2.call(k, ',')) !== null && _k$split !== void 0 ? _k$split : [];
+            var topKey = parts[0];
+            var subKey = parts[1];
+            if (subKey) {
+              if (!filtered[topKey]) filtered[topKey] = {};
+              filtered[topKey][subKey] = flatPersistedFilters[k];
+            } else {
+              filtered[topKey] = flatPersistedFilters[k];
+            }
           } else {
             shouldUpdate = true;
           }

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

@@ -0,0 +1,9 @@
+export declare const locales: {
+    en: string;
+    "zh-CN": string;
+    "zh-HK": string;
+    ja: string;
+    pt: string;
+};
+export declare const checkIfAllValuesAreEqual: (obj: any) => boolean;
+export declare const createTranslationText: (text: string, isAll?: boolean) => any;

package/es/components/virtual-keyboard/Amount/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { AmountProps, RightItemsStyleProps } from './types';
 import './index.less';
 export type { AmountProps, RightItemsStyleProps };

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/components/walletCard/index.js

@@ -379,7 +379,8 @@ var WalletCard = function WalletCard(props) {
   var showViewPin = toBooleanValue(mergedProps === null || mergedProps === void 0 ? void 0 : mergedProps.showViewPin);
   var context = useEngineContext();
   var _ref7 = context.appHelper || {},
-    utils = _ref7.utils;
+    utils = _ref7.utils,
+    constants = _ref7.constants;
   // 使用自定义钩子处理模态框逻辑
   var _useCodeModal = useCodeModal(cardNo, onCodeClick, codeType),
     isModalOpen = _useCodeModal.isModalOpen,
@@ -401,8 +402,13 @@ var WalletCard = function WalletCard(props) {
           backgroundImage: 'none'
         };
       }
+      var staticUrl = constants === null || constants === void 0 ? void 0 : constants.staticURL;
+      if (!staticUrl) {
+        var _constants$config;
+        staticUrl = (constants === null || constants === void 0 || (_constants$config = constants.config) === null || _constants$config === void 0 ? void 0 : _constants$config.awsStatic) || 'https://static.pisellcdn.com';
+      }
       return {
-        backgroundImage: "url(https://file.mypisell-dev.com/pisel/image/9/".concat(mode === 'dark' ? '3d039c83ff5b84fadafb8a23c33d6cc42025_02_26_00_42_53_288_08413160975__720_456__' : '61dcbe950c9451164a6bb1d17d5bc5f02025_02_26_00_43_42_741_04853453608__720_456__', ".png)")
+        backgroundImage: "url(".concat(staticUrl, "/").concat(mode === 'dark' ? 'dark_wallet.png' : 'light_wallet.png', ")")
       };
     }
   }, [props.customBackgroundImage, mode, props === null || props === void 0 || (_props$walletGuideCon2 = props.walletGuideConfig) === null || _props$walletGuideCon2 === void 0 ? void 0 : _props$walletGuideCon2.backgroundColor, props === null || props === void 0 ? void 0 : props.backgroundColor, isLogin, isGuide]);

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/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,9 @@
+import type { PisellBasicGridProps } from './types';
+import './PisellBasicGrid.less';
+/**
+ * 使用 memo 优化组件性能
+ * @description 当 props 没有变化时，避免不必要的重新渲染
+ */
+declare const MemoizedPisellBasicGrid: <T>(props: PisellBasicGridProps<T>) => 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';