@nokecy/qc-ui 1.0.58 → 1.0.60

package/dist/esm/generatedListPage/types.d.ts

@@ -0,0 +1,221 @@
+/// <reference types="react" />
+import { GridRef } from "../ag-grid-plus/interface";
+import { ColDef } from "ag-grid-community";
+import { ButtonProps } from "antd";
+/**
+ * 权限配置接口
+ */
+export interface PermissionConfig {
+    /** 查看权限 */
+    view?: string;
+    /** 创建权限 */
+    create?: string;
+    /** 更新权限 */
+    update?: string;
+    /** 删除权限 */
+    delete?: string;
+    /** 导入权限 */
+    import?: string;
+    /** 导出权限 */
+    export?: string;
+}
+/**
+ * 列表查询参数接口
+ */
+export interface ListParams {
+    /** 筛选条件 */
+    filter?: string;
+    /** 跳过数量 */
+    skipCount?: number;
+    /** 最大结果数 */
+    maxResultCount?: number;
+    /** 排序字段 */
+    sorting?: string;
+    /** 分页大小 */
+    PageSize?: number;
+    /** 跳过数量(兼容) */
+    SkipCount?: number;
+    /** 最大结果数(兼容) */
+    MaxResultCount?: number;
+    /** 排序(兼容) */
+    Sorting?: string;
+    /** 筛选(兼容) */
+    Filter?: string;
+}
+/**
+ * 分页结果接口
+ */
+export interface PagedResult<T> {
+    /** 数据项列表 */
+    items?: T[];
+    /** 总数量 */
+    totalCount?: number;
+}
+/**
+ * 删除参数接口
+ */
+export interface DeleteParams {
+    /** 记录ID */
+    id: string | number;
+}
+/**
+ * 导出参数接口
+ */
+export interface ExportParams {
+    /** 筛选条件 */
+    filter?: string;
+    /** 其他参数 */
+    [key: string]: any;
+}
+/**
+ * API配置接口
+ * @template T 数据项类型
+ */
+export interface ApiConfig<T = any> {
+    /** 列表查询API */
+    list: (params: ListParams) => Promise<PagedResult<T>>;
+    /** 删除API */
+    delete?: (params: DeleteParams) => Promise<void>;
+    /** 导出API */
+    export?: (params: ExportParams) => Promise<Blob>;
+    /** 获取导入模板API */
+    getImportTemplate?: () => Promise<Blob>;
+    /** 导入API */
+    import?: (file: FormData) => Promise<void>;
+}
+/**
+ * 工具栏按钮配置
+ */
+export interface ToolbarActionConfig {
+    /** 按钮类型 */
+    type: 'create' | 'import' | 'export' | 'downloadTemplate' | 'custom';
+    /** 权限键 */
+    permission?: string;
+    /** 按钮文本 */
+    label?: string;
+    /** 按钮属性 */
+    buttonProps?: ButtonProps;
+    /** 自定义组件（当type为custom时） */
+    component?: React.ComponentType<any>;
+    /** 组件属性 */
+    componentProps?: Record<string, any>;
+    /** 点击处理函数（当type为custom时） */
+    onClick?: () => void;
+}
+/**
+ * 表单对话框组件配置
+ */
+export interface FormDialogConfig {
+    /** 表单组件 */
+    component: React.ComponentType<any>;
+    /** 标题 */
+    title?: string;
+    /** 新建标题 */
+    createTitle?: string;
+    /** 编辑标题 */
+    editTitle?: string;
+}
+/**
+ * 树形数据配置
+ */
+export interface TreeDataConfig {
+    /** 是否为树形数据 */
+    enabled: boolean;
+    /** 获取数据路径的函数 */
+    getDataPath?: (data: any) => string[];
+    /** 父节点字段名 */
+    parentFieldName?: string;
+    /** 主键字段名 */
+    keyFieldName?: string;
+    /** 自动分组列配置 */
+    autoGroupColumnDef?: ColDef;
+    /** 默认展开层级 */
+    groupDefaultExpanded?: number;
+    /** 树形数据API - 已包含树形结构(items字段) */
+    treeApi?: () => Promise<any[]>;
+    /** 子节点字段名 */
+    childrenFieldName?: string;
+    /**
+     * 自动模式:从扁平数据构建树形结构
+     * 当设置为 true 时,将自动从 list API 的扁平数据构建树形结构
+     * 需要配合 parentFieldName 和 keyFieldName 使用
+     */
+    autoMode?: boolean;
+    /**
+     * 树形路径显示字段
+     * 用于构建树形路径时显示的字段名,默认使用 'name'
+     * 可以是单个字段名或字段名数组(按优先级尝试)
+     */
+    pathDisplayField?: string | string[];
+}
+/**
+ * 通用列表页面配置接口
+ * @template T 数据项类型
+ */
+export interface GeneratedListPageConfig<T = any> {
+    /** 页面标题 */
+    title: string;
+    /** Grid Key */
+    gridKey: string;
+    /** API配置 */
+    apiConfig: ApiConfig<T>;
+    /** 权限配置 */
+    permissions: PermissionConfig;
+    /** 列定义 */
+    columnDefs: ColDef[];
+    /** 表单对话框配置 */
+    formDialog?: FormDialogConfig;
+    /** 工具栏配置 */
+    toolbarActions?: ToolbarActionConfig[];
+    /** 是否启用导入导出模板下载 */
+    enableImportExport?: boolean;
+    /** 导入配置 */
+    importConfig?: {
+        /** 标题 */
+        title?: string;
+        /** 下载模板URL */
+        downUrl?: string;
+        /** 上传URL */
+        uploadUrl?: string;
+    };
+    /** 导出文件名 */
+    exportFileName?: string;
+    /** 树形数据配置 */
+    treeConfig?: TreeDataConfig;
+    /** 自定义操作列组件 */
+    customOptionsComponent?: React.ComponentType<OptionsComponentProps<T>>;
+    /** 错误处理配置 */
+    errorConfig?: {
+        /** 是否使用统一错误处理 */
+        useErrorHandler?: boolean;
+    };
+    /** 分页配置 */
+    paginationConfig?: {
+        /** 默认页大小 */
+        defaultPageSize?: number;
+        /** 是否启用分页 */
+        enabled?: boolean;
+    };
+    /** Grid引用 */
+    gridRef?: React.RefObject<GridRef>;
+    /** 刷新回调 */
+    onRefresh?: () => void;
+}
+/**
+ * 操作列组件属性接口
+ * @template T 行数据类型
+ */
+export interface OptionsComponentProps<T = any> {
+    /** 行数据 */
+    data: T;
+    /** 刷新函数 */
+    onRefresh: () => void;
+    /** 权限配置 */
+    permissions: PermissionConfig;
+    /** 表单对话框配置 */
+    formDialog?: FormDialogConfig;
+    /** 删除API */
+    deleteApi?: (params: DeleteParams) => Promise<void>;
+    /** 是否使用统一错误处理 */
+    useErrorHandler?: boolean;
+}

package/dist/esm/generatedListPage/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/generatedListPage/usePermissionCheck.d.ts

@@ -0,0 +1,66 @@
+/**
+ * usePermissionCheck Hook
+ *
+ * 提供统一的权限检查功能,避免重复的权限检查逻辑
+ * 适配版：支持外部传入 access 对象或使用默认的全部允许策略
+ */
+import { PermissionConfig } from './types';
+interface PermissionCheckResult {
+    /** 是否有查看权限 */
+    canView: boolean;
+    /** 是否有创建权限 */
+    canCreate: boolean;
+    /** 是否有更新权限 */
+    canUpdate: boolean;
+    /** 是否有删除权限 */
+    canDelete: boolean;
+    /** 是否有导入权限 */
+    canImport: boolean;
+    /** 是否有导出权限 */
+    canExport: boolean;
+    /** 检查特定权限 */
+    hasPermission: (permission?: string) => boolean;
+    /** 检查多个权限(需要全部满足) */
+    hasAllPermissions: (...permissions: (string | undefined)[]) => boolean;
+    /** 检查多个权限(满足任一即可) */
+    hasAnyPermission: (...permissions: (string | undefined)[]) => boolean;
+}
+/**
+ * 权限检查 Hook
+ * @param permissions 权限配置对象
+ * @param access 可选的 access 对象（如果不传入，默认全部允许）
+ * @returns 权限检查结果
+ */
+export declare function usePermissionCheck(permissions: PermissionConfig, access?: Record<string, boolean>): PermissionCheckResult;
+/**
+ * 权限检查工具类
+ * 用于非 Hook 场景下的权限检查
+ */
+export declare class PermissionChecker {
+    private access;
+    constructor(access: Record<string, boolean>);
+    /**
+     * 检查单个权限
+     */
+    hasPermission(permission?: string): boolean;
+    /**
+     * 检查多个权限(需要全部满足)
+     */
+    hasAllPermissions(...permissions: (string | undefined)[]): boolean;
+    /**
+     * 检查多个权限(满足任一即可)
+     */
+    hasAnyPermission(...permissions: (string | undefined)[]): boolean;
+    /**
+     * 检查权限配置对象
+     */
+    checkConfig(config: PermissionConfig): {
+        canView: boolean;
+        canCreate: boolean;
+        canUpdate: boolean;
+        canDelete: boolean;
+        canImport: boolean;
+        canExport: boolean;
+    };
+}
+export default usePermissionCheck;

package/dist/esm/generatedListPage/usePermissionCheck.js

@@ -0,0 +1,145 @@
+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 _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * usePermissionCheck Hook
+ *
+ * 提供统一的权限检查功能,避免重复的权限检查逻辑
+ * 适配版：支持外部传入 access 对象或使用默认的全部允许策略
+ */
+
+import { useMemo } from 'react';
+/**
+ * 权限检查 Hook
+ * @param permissions 权限配置对象
+ * @param access 可选的 access 对象（如果不传入，默认全部允许）
+ * @returns 权限检查结果
+ */
+export function usePermissionCheck(permissions, access) {
+  // 缓存权限检查结果
+  var permissionResult = useMemo(function () {
+    /**
+     * 检查单个权限
+     */
+    var hasPermission = function hasPermission(permission) {
+      if (!permission) return true; // 未配置权限则默认有权限
+      if (!access) return true; // 未传入 access 对象,默认全部允许
+      return !!access[permission];
+    };
+
+    /**
+     * 检查多个权限(需要全部满足)
+     */
+    var hasAllPermissions = function hasAllPermissions() {
+      for (var _len = arguments.length, perms = new Array(_len), _key = 0; _key < _len; _key++) {
+        perms[_key] = arguments[_key];
+      }
+      if (perms.length === 0) return true;
+      return perms.every(function (perm) {
+        return hasPermission(perm);
+      });
+    };
+
+    /**
+     * 检查多个权限(满足任一即可)
+     */
+    var hasAnyPermission = function hasAnyPermission() {
+      for (var _len2 = arguments.length, perms = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+        perms[_key2] = arguments[_key2];
+      }
+      if (perms.length === 0) return true;
+      return perms.some(function (perm) {
+        return hasPermission(perm);
+      });
+    };
+    return {
+      canView: hasPermission(permissions.view),
+      canCreate: hasPermission(permissions.create),
+      canUpdate: hasPermission(permissions.update),
+      canDelete: hasPermission(permissions.delete),
+      canImport: hasPermission(permissions.import),
+      canExport: hasPermission(permissions.export),
+      hasPermission: hasPermission,
+      hasAllPermissions: hasAllPermissions,
+      hasAnyPermission: hasAnyPermission
+    };
+  }, [access, permissions]);
+  return permissionResult;
+}
+
+/**
+ * 权限检查工具类
+ * 用于非 Hook 场景下的权限检查
+ */
+export var PermissionChecker = /*#__PURE__*/function () {
+  function PermissionChecker(access) {
+    _classCallCheck(this, PermissionChecker);
+    _defineProperty(this, "access", void 0);
+    this.access = access;
+  }
+
+  /**
+   * 检查单个权限
+   */
+  _createClass(PermissionChecker, [{
+    key: "hasPermission",
+    value: function hasPermission(permission) {
+      if (!permission) return true;
+      return !!this.access[permission];
+    }
+
+    /**
+     * 检查多个权限(需要全部满足)
+     */
+  }, {
+    key: "hasAllPermissions",
+    value: function hasAllPermissions() {
+      var _this = this;
+      for (var _len3 = arguments.length, permissions = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
+        permissions[_key3] = arguments[_key3];
+      }
+      if (permissions.length === 0) return true;
+      return permissions.every(function (perm) {
+        return _this.hasPermission(perm);
+      });
+    }
+
+    /**
+     * 检查多个权限(满足任一即可)
+     */
+  }, {
+    key: "hasAnyPermission",
+    value: function hasAnyPermission() {
+      var _this2 = this;
+      for (var _len4 = arguments.length, permissions = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
+        permissions[_key4] = arguments[_key4];
+      }
+      if (permissions.length === 0) return true;
+      return permissions.some(function (perm) {
+        return _this2.hasPermission(perm);
+      });
+    }
+
+    /**
+     * 检查权限配置对象
+     */
+  }, {
+    key: "checkConfig",
+    value: function checkConfig(config) {
+      return {
+        canView: this.hasPermission(config.view),
+        canCreate: this.hasPermission(config.create),
+        canUpdate: this.hasPermission(config.update),
+        canDelete: this.hasPermission(config.delete),
+        canImport: this.hasPermission(config.import),
+        canExport: this.hasPermission(config.export)
+      };
+    }
+  }]);
+  return PermissionChecker;
+}();
+export default usePermissionCheck;

package/dist/esm/generatedListPage/useRequestManager.d.ts

@@ -0,0 +1,35 @@
+/**
+ * useRequestManager Hook
+ *
+ * 为组件提供请求管理功能的 React Hook
+ */
+interface UseRequestManagerOptions {
+    /** 防抖延迟时间(ms) */
+    debounceDelay?: number;
+    /** 是否启用缓存 */
+    enableCache?: boolean;
+    /** 缓存有效期(ms) */
+    cacheTTL?: number;
+    /** 是否启用请求去重 */
+    enableDedup?: boolean;
+    /** 最大并发数 */
+    maxConcurrent?: number;
+}
+/**
+ * 使用请求管理器的 Hook
+ */
+export declare function useRequestManager<T = any>(options?: UseRequestManagerOptions): {
+    request: (params: any, requestFn: (params: any, signal: AbortSignal) => Promise<T>) => Promise<T>;
+    debouncedRequest: (key: string, params: any, requestFn: (params: any, signal: AbortSignal) => Promise<T>) => Promise<T>;
+    cancelRequest: (params: any) => void;
+    cancelAllRequests: () => void;
+    clearCache: () => void;
+    cleanupCache: () => void;
+    getStats: () => {
+        cacheSize: number;
+        pendingRequests: number;
+        activeRequests: number;
+        queueSize: number;
+    };
+};
+export default useRequestManager;

package/dist/esm/generatedListPage/useRequestManager.js

@@ -0,0 +1,116 @@
+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 _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+/**
+ * useRequestManager Hook
+ *
+ * 为组件提供请求管理功能的 React Hook
+ */
+
+import { useRef, useEffect, useCallback } from 'react';
+import { RequestManager } from "./RequestManager";
+/**
+ * 使用请求管理器的 Hook
+ */
+export function useRequestManager(options) {
+  var managerRef = useRef();
+
+  // 初始化请求管理器
+  if (!managerRef.current) {
+    managerRef.current = new RequestManager(options);
+  }
+  var manager = managerRef.current;
+
+  // 组件卸载时清理
+  useEffect(function () {
+    return function () {
+      manager.cleanup();
+    };
+  }, [manager]);
+
+  /**
+   * 执行请求
+   */
+  var request = useCallback( /*#__PURE__*/function () {
+    var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(params, requestFn) {
+      return _regeneratorRuntime().wrap(function _callee$(_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            return _context.abrupt("return", manager.request(params, requestFn));
+          case 1:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    }));
+    return function (_x, _x2) {
+      return _ref.apply(this, arguments);
+    };
+  }(), [manager]);
+
+  /**
+   * 防抖请求
+   */
+  var debouncedRequest = useCallback( /*#__PURE__*/function () {
+    var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(key, params, requestFn) {
+      return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+        while (1) switch (_context2.prev = _context2.next) {
+          case 0:
+            return _context2.abrupt("return", manager.debouncedRequest(key, params, requestFn));
+          case 1:
+          case "end":
+            return _context2.stop();
+        }
+      }, _callee2);
+    }));
+    return function (_x3, _x4, _x5) {
+      return _ref2.apply(this, arguments);
+    };
+  }(), [manager]);
+
+  /**
+   * 取消请求
+   */
+  var cancelRequest = useCallback(function (params) {
+    manager.cancelRequest(params);
+  }, [manager]);
+
+  /**
+   * 取消所有请求
+   */
+  var cancelAllRequests = useCallback(function () {
+    manager.cancelAllPendingRequests();
+  }, [manager]);
+
+  /**
+   * 清理缓存
+   */
+  var clearCache = useCallback(function () {
+    manager.clearCache();
+  }, [manager]);
+
+  /**
+   * 清理过期缓存
+   */
+  var cleanupCache = useCallback(function () {
+    manager.cleanupExpiredCache();
+  }, [manager]);
+
+  /**
+   * 获取统计信息
+   */
+  var getStats = useCallback(function () {
+    return manager.getStats();
+  }, [manager]);
+  return {
+    request: request,
+    debouncedRequest: debouncedRequest,
+    cancelRequest: cancelRequest,
+    cancelAllRequests: cancelAllRequests,
+    clearCache: clearCache,
+    cleanupCache: cleanupCache,
+    getStats: getStats
+  };
+}
+export default useRequestManager;

package/dist/esm/importModal/index.d.ts

@@ -1,8 +1,26 @@
 import React from 'react';
+export interface ImportModalProps {
+    /** 导入成功后的回调 */
+    onAfterSubmit?: (response?: any) => void;
+    /** 模块标题（可选，默认为"数据"） */
+    title?: string;
+    /** 模板下载地址（可选，不提供则不显示模板下载链接） */
+    downUrl?: string;
+    /** 上传地址（完整URL或相对路径） */
+    uploadUrl: string;
+    /** 按钮文字 */
+    children?: React.ReactNode;
+    /** 实体ID（可选，用于特定记录的导入） */
+    id?: string;
+    /** 下载Blob函数（可选，不提供则使用默认实现） */
+    downloadBlob?: (url: string, filename: string) => void;
+    /** 服务器地址函数（可选，不提供则直接使用uploadUrl） */
+    serverUrl?: () => string;
+    /** 按钮属性 */
+    buttonProps?: any;
+}
 /**
  * 通用导入弹出框
- * @param props
- * @returns
  */
-declare const ImportModal: (props: any) => React.JSX.Element;
+declare const ImportModal: React.FC<ImportModalProps>;
 export default ImportModal;