@nokecy/qc-ui-components 0.0.0-stage → 2.0.0-beta.1

package/dist/esm/ag-grid-plus/density.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 表格密度：三档数值由 Provider 注入，页面不自设行高、表头高（DESIGN.md §2）。
+ * @author nokecy
+ */
+export type GridDensity = 'comfort' | 'compact' | 'dense';
+export interface GridDensityValues {
+    /** 表格行高 */
+    rowHeight: number;
+    /** 表头高 */
+    headerHeight: number;
+    /** 正文与表头字号 */
+    fontSize: number;
+    /** 单元格上下内边距 */
+    paddingBlock: number;
+    /** 单元格左右内边距 */
+    paddingInline: number;
+}
+/** 规范三档：行高 40/32/28，表头 40/36/32，字号 14/13/12，padding 9·12 / 5·10 / 4·8。 */
+export declare const GRID_DENSITY_PRESETS: Record<GridDensity, GridDensityValues>;
+/** 自定义三档数值：只需写要改的字段，其余沿用规范值。 */
+export type GridDensityOverrides = Partial<Record<GridDensity, Partial<GridDensityValues>>>;
+/**
+ * 解析密度数值。没有注入 density 时返回 undefined，调用方保持出厂外观不变。
+ */
+export declare function resolveGridDensity(density?: GridDensity, overrides?: GridDensityOverrides): GridDensityValues | undefined;

package/dist/esm/ag-grid-plus/density.js

@@ -0,0 +1,45 @@
+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; }
+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); }
+/**
+ * 表格密度：三档数值由 Provider 注入，页面不自设行高、表头高（DESIGN.md §2）。
+ * @author nokecy
+ */
+
+/** 规范三档：行高 40/32/28，表头 40/36/32，字号 14/13/12，padding 9·12 / 5·10 / 4·8。 */
+export var GRID_DENSITY_PRESETS = {
+  comfort: {
+    rowHeight: 40,
+    headerHeight: 40,
+    fontSize: 14,
+    paddingBlock: 9,
+    paddingInline: 12
+  },
+  compact: {
+    rowHeight: 32,
+    headerHeight: 36,
+    fontSize: 13,
+    paddingBlock: 5,
+    paddingInline: 10
+  },
+  dense: {
+    rowHeight: 28,
+    headerHeight: 32,
+    fontSize: 12,
+    paddingBlock: 4,
+    paddingInline: 8
+  }
+};
+
+/** 自定义三档数值：只需写要改的字段，其余沿用规范值。 */
+
+/**
+ * 解析密度数值。没有注入 density 时返回 undefined，调用方保持出厂外观不变。
+ */
+export function resolveGridDensity(density, overrides) {
+  if (!density || !GRID_DENSITY_PRESETS[density]) return undefined;
+  return _objectSpread(_objectSpread({}, GRID_DENSITY_PRESETS[density]), overrides === null || overrides === void 0 ? void 0 : overrides[density]);
+}

package/dist/esm/ag-grid-plus/errors/ErrorBoundary.d.ts

@@ -0,0 +1,36 @@
+/**
+ * AG-Grid Plus 错误边界组件
+ * 用于捕获 React 渲染错误并提供友好的错误提示
+ */
+import React, { Component, ReactNode } from 'react';
+import { GridPlusError } from './types';
+interface ErrorBoundaryProps {
+    /** 子组件 */
+    children: ReactNode;
+    /** 自定义错误渲染函数 */
+    fallback?: (error: GridPlusError, errorInfo: React.ErrorInfo, retry: () => void) => ReactNode;
+    /** 错误回调 */
+    onError?: (error: GridPlusError, errorInfo: React.ErrorInfo) => void;
+    /** 是否显示错误详情(开发环境默认显示) */
+    showErrorDetails?: boolean;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: GridPlusError | null;
+    errorInfo: React.ErrorInfo | null;
+}
+/**
+ * Grid Plus 错误边界组件
+ * 捕获子组件树中的 JavaScript 错误,记录错误并展示降级 UI
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): Partial<ErrorBoundaryState>;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    /**
+     * 重置错误状态,重新渲染组件
+     */
+    handleRetry: () => void;
+    render(): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
+}
+export {};

package/dist/esm/ag-grid-plus/errors/ErrorBoundary.js

@@ -0,0 +1,147 @@
+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 _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+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); }
+/**
+ * AG-Grid Plus 错误边界组件
+ * 用于捕获 React 渲染错误并提供友好的错误提示
+ */
+
+import React, { Component } from 'react';
+import { Result, Button } from 'antd';
+import { GridPlusError, ErrorType, ErrorSeverity } from "./types";
+import { logger } from "../utils/logger";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Grid Plus 错误边界组件
+ * 捕获子组件树中的 JavaScript 错误,记录错误并展示降级 UI
+ */
+export var ErrorBoundary = /*#__PURE__*/function (_Component) {
+  _inherits(ErrorBoundary, _Component);
+  var _super = _createSuper(ErrorBoundary);
+  function ErrorBoundary(props) {
+    var _this;
+    _classCallCheck(this, ErrorBoundary);
+    _this = _super.call(this, props);
+    /**
+     * 重置错误状态,重新渲染组件
+     */
+    _defineProperty(_assertThisInitialized(_this), "handleRetry", function () {
+      _this.setState({
+        hasError: false,
+        error: null,
+        errorInfo: null
+      });
+    });
+    _this.state = {
+      hasError: false,
+      error: null,
+      errorInfo: null
+    };
+    return _this;
+  }
+  _createClass(ErrorBoundary, [{
+    key: "componentDidCatch",
+    value: function componentDidCatch(error, errorInfo) {
+      // 将错误包装为 GridPlusError
+      var gridError = error instanceof GridPlusError ? error : new GridPlusError(error.message || '组件渲染错误', ErrorType.RENDER_ERROR, ErrorSeverity.HIGH, {
+        componentStack: errorInfo.componentStack
+      }, error);
+
+      // 记录错误
+      logger.error('组件渲染错误', gridError.getDetails());
+
+      // 更新状态
+      this.setState({
+        error: gridError,
+        errorInfo: errorInfo
+      });
+
+      // 调用用户提供的错误处理函数
+      if (this.props.onError) {
+        this.props.onError(gridError, errorInfo);
+      }
+    }
+  }, {
+    key: "render",
+    value: function render() {
+      var _this$state = this.state,
+        hasError = _this$state.hasError,
+        error = _this$state.error,
+        errorInfo = _this$state.errorInfo;
+      var _this$props = this.props,
+        children = _this$props.children,
+        fallback = _this$props.fallback,
+        _this$props$showError = _this$props.showErrorDetails,
+        showErrorDetails = _this$props$showError === void 0 ? process.env.NODE_ENV === 'development' : _this$props$showError;
+      if (hasError && error) {
+        // 如果提供了自定义降级 UI
+        if (fallback && errorInfo) {
+          return fallback(error, errorInfo, this.handleRetry);
+        }
+
+        // 默认错误 UI
+        return /*#__PURE__*/_jsx(Result, {
+          status: "error",
+          title: "\u7EC4\u4EF6\u52A0\u8F7D\u5931\u8D25",
+          subTitle: error.getUserMessage(),
+          extra: [/*#__PURE__*/_jsx(Button, {
+            type: "primary",
+            onClick: this.handleRetry,
+            children: "\u91CD\u8BD5"
+          }, "retry"), /*#__PURE__*/_jsx(Button, {
+            onClick: function onClick() {
+              return window.location.reload();
+            },
+            children: "\u5237\u65B0\u9875\u9762"
+          }, "refresh")],
+          children: showErrorDetails && /*#__PURE__*/_jsxs("div", {
+            style: {
+              textAlign: 'left',
+              padding: '16px',
+              backgroundColor: '#f5f5f5',
+              borderRadius: '4px',
+              maxWidth: '800px',
+              margin: '0 auto'
+            },
+            children: [/*#__PURE__*/_jsx("h4", {
+              children: "\u9519\u8BEF\u8BE6\u60C5:"
+            }), /*#__PURE__*/_jsxs("pre", {
+              style: {
+                whiteSpace: 'pre-wrap',
+                wordBreak: 'break-word',
+                fontSize: '12px',
+                color: '#666'
+              },
+              children: [error.message, '\n\n', error.stack, (errorInfo === null || errorInfo === void 0 ? void 0 : errorInfo.componentStack) && /*#__PURE__*/_jsxs(_Fragment, {
+                children: ['\n\n组件堆栈:', errorInfo.componentStack]
+              })]
+            })]
+          })
+        });
+      }
+      return children;
+    }
+  }], [{
+    key: "getDerivedStateFromError",
+    value: function getDerivedStateFromError(error) {
+      // 更新 state 使下一次渲染能够显示降级 UI
+      return {
+        hasError: true
+      };
+    }
+  }]);
+  return ErrorBoundary;
+}(Component);

package/dist/esm/ag-grid-plus/errors/index.d.ts

@@ -0,0 +1,3 @@
+export { ErrorType, ErrorSeverity, GridPlusError } from './types';
+export type { ErrorHandlingConfig } from './types';
+export { ErrorBoundary } from './ErrorBoundary';

package/dist/esm/ag-grid-plus/errors/index.js

@@ -0,0 +1,2 @@
+export { ErrorType, ErrorSeverity, GridPlusError } from "./types";
+export { ErrorBoundary } from "./ErrorBoundary";

package/dist/esm/ag-grid-plus/errors/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * AG-Grid Plus 错误处理类型定义
+ */
+/// <reference types="react" />
+/**
+ * 错误类型枚举
+ */
+export declare enum ErrorType {
+    /** 网络错误 - 请求超时、网络中断 */
+    NETWORK_ERROR = "NETWORK_ERROR",
+    /** 服务器错误 - 5xx 错误 */
+    SERVER_ERROR = "SERVER_ERROR",
+    /** 业务错误 - 4xx 错误、业务逻辑错误 */
+    BUSINESS_ERROR = "BUSINESS_ERROR",
+    /** 数据格式错误 - 响应数据不符合预期 */
+    DATA_FORMAT_ERROR = "DATA_FORMAT_ERROR",
+    /** 渲染错误 - React 组件错误 */
+    RENDER_ERROR = "RENDER_ERROR",
+    /** 验证错误 - 输入验证失败 */
+    VALIDATION_ERROR = "VALIDATION_ERROR"
+}
+/**
+ * 错误严重级别
+ */
+export declare enum ErrorSeverity {
+    /** 低 - 不影响功能使用 */
+    LOW = "low",
+    /** 中 - 部分功能受影响 */
+    MEDIUM = "medium",
+    /** 高 - 核心功能受影响 */
+    HIGH = "high",
+    /** 严重 - 组件无法使用 */
+    CRITICAL = "critical"
+}
+/**
+ * Grid Plus 错误类
+ */
+export declare class GridPlusError extends Error {
+    /** 错误类型 */
+    type: ErrorType;
+    /** 严重级别 */
+    severity: ErrorSeverity;
+    /** 错误上下文信息 */
+    context?: any;
+    /** 原始错误对象 */
+    originalError?: Error;
+    /** 错误发生时间 */
+    timestamp: Date;
+    constructor(message: string, type: ErrorType, severity?: ErrorSeverity, context?: any, originalError?: Error);
+    /**
+     * 获取用户友好的错误消息
+     */
+    getUserMessage(): string;
+    /**
+     * 获取 ABP 远程服务返回的业务错误，供提示和列表空态保留准确原因。
+     *
+     * @author nokecy
+     */
+    getRemoteServiceError(): {
+        code?: string;
+        message?: string;
+    } | undefined;
+    /**
+     * 获取错误详情(用于日志)
+     */
+    getDetails(): Record<string, any>;
+}
+/**
+ * 错误处理配置
+ */
+export interface ErrorHandlingConfig {
+    /** 是否显示错误提示 */
+    showErrorMessage?: boolean;
+    /** 是否记录错误日志 */
+    logErrors?: boolean;
+    /** 自定义错误处理函数 */
+    onError?: (error: GridPlusError) => void;
+    /** 自定义错误渲染 */
+    renderError?: (error: GridPlusError, retry?: () => void) => React.ReactNode;
+}

package/dist/esm/ag-grid-plus/errors/types.js

@@ -0,0 +1,155 @@
+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 _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _wrapNativeSuper(Class) { var _cache = typeof Map === "function" ? new Map() : undefined; _wrapNativeSuper = function _wrapNativeSuper(Class) { if (Class === null || !_isNativeFunction(Class)) return Class; if (typeof Class !== "function") { throw new TypeError("Super expression must either be null or a function"); } if (typeof _cache !== "undefined") { if (_cache.has(Class)) return _cache.get(Class); _cache.set(Class, Wrapper); } function Wrapper() { return _construct(Class, arguments, _getPrototypeOf(this).constructor); } Wrapper.prototype = Object.create(Class.prototype, { constructor: { value: Wrapper, enumerable: false, writable: true, configurable: true } }); return _setPrototypeOf(Wrapper, Class); }; return _wrapNativeSuper(Class); }
+function _construct(Parent, args, Class) { if (_isNativeReflectConstruct()) { _construct = Reflect.construct.bind(); } else { _construct = function _construct(Parent, args, Class) { var a = [null]; a.push.apply(a, args); var Constructor = Function.bind.apply(Parent, a); var instance = new Constructor(); if (Class) _setPrototypeOf(instance, Class.prototype); return instance; }; } return _construct.apply(null, arguments); }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _isNativeFunction(fn) { try { return Function.toString.call(fn).indexOf("[native code]") !== -1; } catch (e) { return typeof fn === "function"; } }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+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); }
+/**
+ * AG-Grid Plus 错误处理类型定义
+ */
+
+/**
+ * 错误类型枚举
+ */
+export var ErrorType = /*#__PURE__*/function (ErrorType) {
+  ErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
+  ErrorType["SERVER_ERROR"] = "SERVER_ERROR";
+  ErrorType["BUSINESS_ERROR"] = "BUSINESS_ERROR";
+  ErrorType["DATA_FORMAT_ERROR"] = "DATA_FORMAT_ERROR";
+  ErrorType["RENDER_ERROR"] = "RENDER_ERROR";
+  ErrorType["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+  return ErrorType;
+}({});
+
+/**
+ * 错误严重级别
+ */
+export var ErrorSeverity = /*#__PURE__*/function (ErrorSeverity) {
+  ErrorSeverity["LOW"] = "low";
+  ErrorSeverity["MEDIUM"] = "medium";
+  ErrorSeverity["HIGH"] = "high";
+  ErrorSeverity["CRITICAL"] = "critical";
+  return ErrorSeverity;
+}({});
+
+/**
+ * Grid Plus 错误类
+ */
+export var GridPlusError = /*#__PURE__*/function (_Error) {
+  _inherits(GridPlusError, _Error);
+  var _super = _createSuper(GridPlusError);
+  function GridPlusError(message, type) {
+    var _this;
+    var severity = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : ErrorSeverity.MEDIUM;
+    var context = arguments.length > 3 ? arguments[3] : undefined;
+    var originalError = arguments.length > 4 ? arguments[4] : undefined;
+    _classCallCheck(this, GridPlusError);
+    _this = _super.call(this, message);
+    /** 错误类型 */
+    _defineProperty(_assertThisInitialized(_this), "type", void 0);
+    /** 严重级别 */
+    _defineProperty(_assertThisInitialized(_this), "severity", void 0);
+    /** 错误上下文信息 */
+    _defineProperty(_assertThisInitialized(_this), "context", void 0);
+    /** 原始错误对象 */
+    _defineProperty(_assertThisInitialized(_this), "originalError", void 0);
+    /** 错误发生时间 */
+    _defineProperty(_assertThisInitialized(_this), "timestamp", void 0);
+    _this.name = 'GridPlusError';
+    _this.type = type;
+    _this.severity = severity;
+    _this.context = context;
+    _this.originalError = originalError;
+    _this.timestamp = new Date();
+
+    // 维护正确的原型链
+    Object.setPrototypeOf(_assertThisInitialized(_this), GridPlusError.prototype);
+    return _this;
+  }
+
+  /**
+   * 获取用户友好的错误消息
+   */
+  _createClass(GridPlusError, [{
+    key: "getUserMessage",
+    value: function getUserMessage() {
+      var _this$getRemoteServic;
+      var remoteMessage = (_this$getRemoteServic = this.getRemoteServiceError()) === null || _this$getRemoteServic === void 0 ? void 0 : _this$getRemoteServic.message;
+      if (remoteMessage) {
+        return remoteMessage;
+      }
+
+      // 在生产环境下,返回更友好的消息
+      if (process.env.NODE_ENV === 'production') {
+        switch (this.type) {
+          case ErrorType.NETWORK_ERROR:
+            return '网络连接失败,请检查网络设置后重试';
+          case ErrorType.SERVER_ERROR:
+            return '服务器暂时无法响应,请稍后重试';
+          case ErrorType.BUSINESS_ERROR:
+            return this.message || '操作失败,请重试';
+          case ErrorType.DATA_FORMAT_ERROR:
+            return '数据格式错误,请联系技术支持';
+          case ErrorType.RENDER_ERROR:
+            return '组件加载失败,请刷新页面重试';
+          case ErrorType.VALIDATION_ERROR:
+            return this.message || '输入数据不符合要求';
+          default:
+            return '操作失败,请重试';
+        }
+      }
+      return this.message;
+    }
+
+    /**
+     * 获取 ABP 远程服务返回的业务错误，供提示和列表空态保留准确原因。
+     *
+     * @author nokecy
+     */
+  }, {
+    key: "getRemoteServiceError",
+    value: function getRemoteServiceError() {
+      var _this$context$origina, _this$context, _response;
+      var originalError = (_this$context$origina = (_this$context = this.context) === null || _this$context === void 0 ? void 0 : _this$context.originalError) !== null && _this$context$origina !== void 0 ? _this$context$origina : this.originalError;
+      var remoteError = originalError === null || originalError === void 0 || (_response = originalError.response) === null || _response === void 0 || (_response = _response.data) === null || _response === void 0 ? void 0 : _response.error;
+      return remoteError && _typeof(remoteError) === 'object' ? remoteError : undefined;
+    }
+
+    /**
+     * 获取错误详情(用于日志)
+     */
+  }, {
+    key: "getDetails",
+    value: function getDetails() {
+      return {
+        type: this.type,
+        severity: this.severity,
+        message: this.message,
+        timestamp: this.timestamp.toISOString(),
+        context: this.context,
+        stack: this.stack,
+        originalError: this.originalError ? {
+          name: this.originalError.name,
+          message: this.originalError.message,
+          stack: this.originalError.stack
+        } : undefined
+      };
+    }
+  }]);
+  return GridPlusError;
+}( /*#__PURE__*/_wrapNativeSuper(Error));
+
+/**
+ * 错误处理配置
+ */

package/dist/esm/ag-grid-plus/hooks/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * AG-Grid Plus Hooks
+ */
+export { useGridPlusColumnState } from './useGridPlusColumnState';
+export { useRowId } from './useRowId';

package/dist/esm/ag-grid-plus/hooks/index.js

@@ -0,0 +1,6 @@
+/**
+ * AG-Grid Plus Hooks
+ */
+
+export { useGridPlusColumnState } from "./useGridPlusColumnState";
+export { useRowId } from "./useRowId";

package/dist/esm/ag-grid-plus/hooks/useGridPlusColumnState.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 使用 GridPlusContext 的 Hook
+ * 用于访问列状态管理相关的方法和数据
+ */
+export declare const useGridPlusColumnState: () => import("../context/gridContext").GridPlusContextValue;

package/dist/esm/ag-grid-plus/hooks/useGridPlusColumnState.js

@@ -0,0 +1,10 @@
+import { useContext } from 'react';
+import { GridPlusContext } from "../context/gridContext";
+
+/**
+ * 使用 GridPlusContext 的 Hook
+ * 用于访问列状态管理相关的方法和数据
+ */
+export var useGridPlusColumnState = function useGridPlusColumnState() {
+  return useContext(GridPlusContext);
+};

package/dist/esm/ag-grid-plus/hooks/useRowId.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 行唯一 ID 生成 Hook(从 ag-gridPlus.tsx 抽出,逻辑原样)。
+ *
+ * 策略(按优先级):
+ * 1. 常见 ID 字段 id/_id/key/uid/uuid(基本类型直取;对象取 value 或 id 属性)
+ * 2. WeakMap 缓存命中
+ * 3. 生成 `${gridKey|grid}-row-{counter}-{timestamp}` 并缓存
+ *
+ * @author nokecy
+ */
+export declare function useRowId(gridKey?: string): {
+    generateUniqueRowId: (data: any) => string;
+};

package/dist/esm/ag-grid-plus/hooks/useRowId.js

@@ -0,0 +1,56 @@
+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); }
+import { useCallback, useRef } from 'react';
+
+/**
+ * 行唯一 ID 生成 Hook(从 ag-gridPlus.tsx 抽出,逻辑原样)。
+ *
+ * 策略(按优先级):
+ * 1. 常见 ID 字段 id/_id/key/uid/uuid(基本类型直取;对象取 value 或 id 属性)
+ * 2. WeakMap 缓存命中
+ * 3. 生成 `${gridKey|grid}-row-{counter}-{timestamp}` 并缓存
+ *
+ * @author nokecy
+ */
+export function useRowId(gridKey) {
+  var rowIdCacheRef = useRef(new WeakMap());
+  var rowIdCounterRef = useRef(0);
+  var generateUniqueRowId = useCallback(function (data) {
+    if (!data || _typeof(data) !== 'object') {
+      return "row-empty-".concat(rowIdCounterRef.current++);
+    }
+    var commonIdFields = ['id', '_id', 'key', 'uid', 'uuid'];
+    for (var _i = 0, _commonIdFields = commonIdFields; _i < _commonIdFields.length; _i++) {
+      var field = _commonIdFields[_i];
+      var value = data[field];
+      if (value !== undefined && value !== null && value !== '') {
+        var fieldId = void 0;
+        if (_typeof(value) === 'object' && value !== null) {
+          // value.value / value.id 为 null 视为没有标识（如 randomuser 的 id: { name: '', value: null }），
+          // 否则所有行都会得到 "null" 而触发 AG-Grid error #2（重复节点 ID）
+          if (value.value !== undefined && value.value !== null) {
+            fieldId = String(value.value);
+          } else if (value.id !== undefined && value.id !== null) {
+            fieldId = String(value.id);
+          } else if (value.value === null || value.id === null) {
+            continue;
+          } else {
+            fieldId = "".concat(field, "-").concat(JSON.stringify(value));
+          }
+        } else {
+          fieldId = String(value);
+        }
+        return fieldId;
+      }
+    }
+    var cachedId = rowIdCacheRef.current.get(data);
+    if (cachedId) {
+      return cachedId;
+    }
+    var uniqueId = "".concat(gridKey || 'grid', "-row-").concat(rowIdCounterRef.current++, "-").concat(Date.now());
+    rowIdCacheRef.current.set(data, uniqueId);
+    return uniqueId;
+  }, [gridKey]);
+  return {
+    generateUniqueRowId: generateUniqueRowId
+  };
+}

package/dist/esm/ag-grid-plus/hooks/useTypeInferenceRow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 挑出用于列类型推断的那一行数据。
+ *
+ * 列的数据类型（数值列自动求和并右对齐）是靠首行数据的字段类型推断出来的，
+ * 而这个推断**只该做一次**：之后的数据更新不应该改变列定义，否则翻页、筛选都会重排列。
+ *
+ * 必须返回 state 而不是 ref。这里踩过一次：
+ * 原本用 `useRef` 缓存首行，而消费它的 `useMemo` 依赖数组里又没有 rowData，
+ * 于是异步加载的表格首次渲染时 rowData 为空 → 推断不出类型 → 数据到达后写进 ref
+ * 却不触发重渲染 → 列定义永久停留在「无类型」。表现是数值列该右对齐却一直左对齐，
+ * 不报错、不崩溃，只能靠盯着某一列发现。
+ *
+ * 用 state 就同时满足两件事：首批数据到达时触发一次重算，之后不再变。
+ *
+ * @author nokecy
+ */
+export declare function useTypeInferenceRow(rowData: any[] | undefined | null): any;
+export default useTypeInferenceRow;