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

package/dist/esm/ag-grid-plus/utils/entityExtensionColumns.js

@@ -0,0 +1,148 @@
+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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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 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); }
+/**
+ * 实体扩展字段列转换工具
+ * 将后端 ABP 配置的扩展字段转换为 AG-Grid 列定义
+ *
+ * @author nokecy
+ */
+
+/**
+ * 数据类型到列配置的映射
+ * 根据字段的数据类型自动配置列宽度、是否可搜索、列类型等
+ */
+var dataTypeColumnConfig = {
+  // 字符串类型
+  String: {
+    width: 150,
+    hideInSearch: false
+  },
+  Text: {
+    width: 200,
+    hideInSearch: true
+  },
+  // 数值类型
+  Int: {
+    width: 100,
+    hideInSearch: true,
+    type: 'numberColumn'
+  },
+  Long: {
+    width: 100,
+    hideInSearch: true,
+    type: 'numberColumn'
+  },
+  Decimal: {
+    width: 120,
+    hideInSearch: true,
+    type: 'numberColumn'
+  },
+  Double: {
+    width: 120,
+    hideInSearch: true,
+    type: 'numberColumn'
+  },
+  Float: {
+    width: 120,
+    hideInSearch: true,
+    type: 'numberColumn'
+  },
+  // 布尔类型
+  Boolean: {
+    width: 80,
+    hideInSearch: false
+  },
+  // 日期时间类型
+  DateTime: {
+    width: 160,
+    hideInSearch: true,
+    type: 'dateTimeColumn'
+  },
+  Date: {
+    width: 120,
+    hideInSearch: true,
+    type: 'dateColumn'
+  },
+  // 其他类型
+  Guid: {
+    width: 280,
+    hideInSearch: false
+  },
+  Enum: {
+    width: 100,
+    hideInSearch: false
+  }
+};
+
+/**
+ * 将单个扩展字段转换为列定义
+ * 使用 {extraPropertiesPath}.xxx 嵌套路径访问数据
+ *
+ * @param field 扩展字段定义
+ * @param extraPropertiesPath 扩展属性的路径前缀，默认 'extraProperties'（保持向后兼容）
+ * @returns AG-Grid 列定义
+ * @author nokecy
+ *
+ * @warning 请勿将此函数直接传给 Array.prototype.map()。
+ * Array.map 会将 (element, index, array) 全部传入，index（数字）会绑定到
+ * extraPropertiesPath，导致 field 路径变为 '0.foo'、'1.bar' 等非法值。
+ * 请始终用箭头函数包装：someArray.map((f) => fieldToColumnDef(f, path))
+ */
+export function fieldToColumnDef(field) {
+  var extraPropertiesPath = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'extraProperties';
+  // 防御 Array.map 将 index（number）传入第二参数的情况，回退到默认路径
+  var resolvedPath = typeof extraPropertiesPath === 'string' ? extraPropertiesPath : 'extraProperties';
+  var config = dataTypeColumnConfig[field.dataType] || {
+    width: 150,
+    hideInSearch: false
+  };
+  var colDef = _objectSpread(_objectSpread({
+    // 使用可配置前缀的嵌套路径访问扩展属性数据
+    field: "".concat(resolvedPath, ".").concat(field.name),
+    headerName: field.displayName,
+    width: config.width,
+    hideInSearch: config.hideInSearch
+  }, config.type && {
+    type: config.type
+  }), field.description && {
+    headerTooltip: field.description
+  });
+  return colDef;
+}
+
+/**
+ * 获取指定实体的扩展列定义
+ *
+ * @param entityType 实体类型全名 (如 "Burn.Product.Domain.Product")
+ * @param extensions 实体扩展配置映射
+ * @param extraPropertiesPath 扩展属性的路径前缀，默认 'extraProperties'（保持向后兼容）
+ * @returns 扩展列定义数组，按 sortOrder 排序
+ * @author nokecy
+ */
+export function getEntityExtensionColumns(entityType, extensions) {
+  var extraPropertiesPath = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'extraProperties';
+  // 边界情况处理：无效输入直接返回空数组
+  var entityConfig = entityType ? extensions === null || extensions === void 0 ? void 0 : extensions[entityType] : undefined;
+  var fields = entityConfig === null || entityConfig === void 0 ? void 0 : entityConfig.fields;
+  if (!fields || !Array.isArray(fields)) {
+    return [];
+  }
+
+  // 按 sortOrder 排序后转换为列定义，透传路径前缀
+  return _toConsumableArray(fields).sort(function (a, b) {
+    var _a$sortOrder, _b$sortOrder;
+    return ((_a$sortOrder = a.sortOrder) !== null && _a$sortOrder !== void 0 ? _a$sortOrder : 0) - ((_b$sortOrder = b.sortOrder) !== null && _b$sortOrder !== void 0 ? _b$sortOrder : 0);
+  }).map(function (f) {
+    return fieldToColumnDef(f, extraPropertiesPath);
+  });
+}

package/dist/esm/ag-grid-plus/utils/logger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * AG-Grid Plus 日志工具
+ */
+declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error",
+    FATAL = "fatal"
+}
+interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    context?: any;
+}
+declare class Logger {
+    private isDevelopment;
+    private enableConsole;
+    private logHistory;
+    private maxHistorySize;
+    private log;
+    debug(message: string, context?: any): void;
+    info(message: string, context?: any): void;
+    warn(message: string, context?: any): void;
+    error(message: string, context?: any): void;
+    fatal(message: string, context?: any): void;
+    getHistory(): LogEntry[];
+    clearHistory(): void;
+    setConsoleEnabled(enabled: boolean): void;
+}
+export declare const logger: Logger;
+export { LogLevel };
+export type { LogEntry };

package/dist/esm/ag-grid-plus/utils/logger.js

@@ -0,0 +1,113 @@
+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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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 _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); }
+/**
+ * AG-Grid Plus 日志工具
+ */
+var LogLevel = /*#__PURE__*/function (LogLevel) {
+  LogLevel["DEBUG"] = "debug";
+  LogLevel["INFO"] = "info";
+  LogLevel["WARN"] = "warn";
+  LogLevel["ERROR"] = "error";
+  LogLevel["FATAL"] = "fatal";
+  return LogLevel;
+}(LogLevel || {});
+var Logger = /*#__PURE__*/function () {
+  function Logger() {
+    _classCallCheck(this, Logger);
+    _defineProperty(this, "isDevelopment", process.env.NODE_ENV === 'development');
+    _defineProperty(this, "enableConsole", true);
+    _defineProperty(this, "logHistory", []);
+    _defineProperty(this, "maxHistorySize", 100);
+  }
+  _createClass(Logger, [{
+    key: "log",
+    value: function log(level, message, context) {
+      var entry = {
+        timestamp: new Date().toISOString(),
+        level: level,
+        message: message,
+        context: context
+      };
+
+      // 记录到历史
+      this.logHistory.push(entry);
+      if (this.logHistory.length > this.maxHistorySize) {
+        this.logHistory.shift();
+      }
+
+      // 控制台输出
+      if (this.enableConsole) {
+        var prefix = "[AG-Grid Plus] [".concat(level.toUpperCase(), "]");
+        var timestamp = new Date().toLocaleTimeString();
+        switch (level) {
+          case LogLevel.DEBUG:
+            this.isDevelopment && void 0;
+            break;
+          case LogLevel.INFO:
+            break;
+          case LogLevel.WARN:
+            console.warn("".concat(prefix, " ").concat(timestamp), message, context || '');
+            break;
+          case LogLevel.ERROR:
+          case LogLevel.FATAL:
+            console.error("".concat(prefix, " ").concat(timestamp), message, context || '');
+            break;
+        }
+      }
+    }
+  }, {
+    key: "debug",
+    value: function debug(message, context) {
+      this.log(LogLevel.DEBUG, message, context);
+    }
+  }, {
+    key: "info",
+    value: function info(message, context) {
+      this.log(LogLevel.INFO, message, context);
+    }
+  }, {
+    key: "warn",
+    value: function warn(message, context) {
+      this.log(LogLevel.WARN, message, context);
+    }
+  }, {
+    key: "error",
+    value: function error(message, context) {
+      this.log(LogLevel.ERROR, message, context);
+    }
+  }, {
+    key: "fatal",
+    value: function fatal(message, context) {
+      this.log(LogLevel.FATAL, message, context);
+    }
+  }, {
+    key: "getHistory",
+    value: function getHistory() {
+      return _toConsumableArray(this.logHistory);
+    }
+  }, {
+    key: "clearHistory",
+    value: function clearHistory() {
+      this.logHistory = [];
+    }
+  }, {
+    key: "setConsoleEnabled",
+    value: function setConsoleEnabled(enabled) {
+      this.enableConsole = enabled;
+    }
+  }]);
+  return Logger;
+}();
+export var logger = new Logger();
+export { LogLevel };

package/dist/esm/ag-grid-plus/utils/queryFormDerivation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 查询表单项派生纯函数(从 ag-gridPlus.tsx 抽出,行为原样)。
+ * @author nokecy
+ */
+/**
+ * 按 itemsOrder 数组对查询表单项排序。
+ * - itemsOrder 为空/未传:使用页面声明的 order，已排好时保留引用。
+ * - 未在 itemsOrder 中的项排到末尾,两者都不在则保持相对顺序。
+ */
+export declare function sortFormItemsByOrder<T extends {
+    field: string;
+    order?: number;
+}>(items: T[], itemsOrder?: string[]): T[];
+/**
+ * 过滤掉 hiddenFields 中的查询表单项。
+ * - hiddenFields 为空:原样返回(同一引用,memo 友好)。
+ */
+export declare function filterHiddenFormItems<T extends {
+    field: string;
+}>(items: T[], hiddenFields: string[]): T[];

package/dist/esm/ag-grid-plus/utils/queryFormDerivation.js

@@ -0,0 +1,48 @@
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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; }
+/**
+ * 查询表单项派生纯函数(从 ag-gridPlus.tsx 抽出,行为原样)。
+ * @author nokecy
+ */
+
+/**
+ * 按 itemsOrder 数组对查询表单项排序。
+ * - itemsOrder 为空/未传:使用页面声明的 order，已排好时保留引用。
+ * - 未在 itemsOrder 中的项排到末尾,两者都不在则保持相对顺序。
+ */
+export function sortFormItemsByOrder(items, itemsOrder) {
+  if (!itemsOrder || itemsOrder.length === 0) {
+    var sorted = _toConsumableArray(items).sort(function (a, b) {
+      var _a$order, _b$order;
+      return ((_a$order = a.order) !== null && _a$order !== void 0 ? _a$order : 999) - ((_b$order = b.order) !== null && _b$order !== void 0 ? _b$order : 999);
+    });
+    return sorted.every(function (item, index) {
+      return item === items[index];
+    }) ? items : sorted;
+  }
+  return _toConsumableArray(items).sort(function (a, b) {
+    var indexA = itemsOrder.indexOf(a.field);
+    var indexB = itemsOrder.indexOf(b.field);
+    if (indexA === -1 && indexB === -1) return 0;
+    if (indexA === -1) return 1;
+    if (indexB === -1) return -1;
+    return indexA - indexB;
+  });
+}
+
+/**
+ * 过滤掉 hiddenFields 中的查询表单项。
+ * - hiddenFields 为空:原样返回(同一引用,memo 友好)。
+ */
+export function filterHiddenFormItems(items, hiddenFields) {
+  if (hiddenFields.length === 0) {
+    return items;
+  }
+  return items.filter(function (item) {
+    return !hiddenFields.includes(item.field);
+  });
+}

package/dist/esm/ag-grid-plus/utils/requestParams.d.ts

@@ -0,0 +1,15 @@
+import type { QueryFilterState, ExtendedColDef } from '../types';
+/**
+ * 请求参数构建纯函数(从 ag-gridPlus.tsx onRequest 抽出,行为原样)。
+ * @author nokecy
+ */
+/**
+ * 根据查询模式构建过滤字符串:
+ * - 高级模式(__advancedMode__ 且有 __rules__):走规则转换 convertRulesToFilterString。
+ * - 简单模式:走 convertFilterModel。
+ */
+export declare function buildFilterString(queryFilter: QueryFilterState, columnDefs: ExtendedColDef[]): string;
+/**
+ * 页码 → ABP skipCount。第 1 页为 0,其余为 (current-1)*pageSize。
+ */
+export declare function pageToSkipCount(current: number, pageSize: number): number;

package/dist/esm/ag-grid-plus/utils/requestParams.js

@@ -0,0 +1,24 @@
+import { convertFilterModel, convertRulesToFilterString } from "../utils";
+/**
+ * 请求参数构建纯函数(从 ag-gridPlus.tsx onRequest 抽出,行为原样)。
+ * @author nokecy
+ */
+
+/**
+ * 根据查询模式构建过滤字符串:
+ * - 高级模式(__advancedMode__ 且有 __rules__):走规则转换 convertRulesToFilterString。
+ * - 简单模式:走 convertFilterModel。
+ */
+export function buildFilterString(queryFilter, columnDefs) {
+  if (queryFilter.__advancedMode__ && queryFilter.__rules__) {
+    return convertRulesToFilterString(queryFilter.__rules__, columnDefs);
+  }
+  return convertFilterModel(queryFilter, columnDefs);
+}
+
+/**
+ * 页码 → ABP skipCount。第 1 页为 0,其余为 (current-1)*pageSize。
+ */
+export function pageToSkipCount(current, pageSize) {
+  return current === 1 ? 0 : (current - 1) * pageSize;
+}

package/dist/esm/ag-grid-plus/utils/rowSelection.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 行选择纯逻辑(从 ag-gridPlus.tsx 抽出,行为原样)。
+ * @author nokecy
+ */
+/**
+ * 只保留「既被选中、又在当前显示行中」的行(按 getId 计算的行 ID 比对)。
+ * id 为空(falsy)的行不计入匹配。
+ */
+export declare function filterVisibleSelectedRows<T>(selectedRows: T[], displayedRows: T[], getId: (row: T) => string): T[];

package/dist/esm/ag-grid-plus/utils/rowSelection.js

@@ -0,0 +1,18 @@
+/**
+ * 行选择纯逻辑(从 ag-gridPlus.tsx 抽出,行为原样)。
+ * @author nokecy
+ */
+
+/**
+ * 只保留「既被选中、又在当前显示行中」的行(按 getId 计算的行 ID 比对)。
+ * id 为空(falsy)的行不计入匹配。
+ */
+export function filterVisibleSelectedRows(selectedRows, displayedRows, getId) {
+  return selectedRows.filter(function (selectedRow) {
+    return displayedRows.some(function (displayedRow) {
+      var selectedRowId = getId(selectedRow);
+      var displayedRowId = getId(displayedRow);
+      return selectedRowId && displayedRowId && selectedRowId === displayedRowId;
+    });
+  });
+}

package/dist/esm/ag-grid-plus/utils/sanitize.d.ts

@@ -0,0 +1,15 @@
+/**
+ * HTML 内容安全转义工具
+ * 防止 XSS 攻击
+ */
+/**
+ * 转义 HTML 特殊字符
+ * @param unsafeText 未转义的文本
+ * @returns 转义后的安全文本
+ */
+export declare function escapeHtml(unsafeText: string): string;
+/**
+ * 生成安全的 HTML 模板
+ * 用于 AG-Grid 的 overlayNoRowsTemplate 等场景
+ */
+export declare function createSafeHtmlTemplate(text: string, styles?: string): string;

package/dist/esm/ag-grid-plus/utils/sanitize.js

@@ -0,0 +1,32 @@
+/**
+ * HTML 内容安全转义工具
+ * 防止 XSS 攻击
+ */
+
+/**
+ * 转义 HTML 特殊字符
+ * @param unsafeText 未转义的文本
+ * @returns 转义后的安全文本
+ */
+export function escapeHtml(unsafeText) {
+  var map = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#039;'
+  };
+  return unsafeText.replace(/[&<>"']/g, function (char) {
+    return map[char];
+  });
+}
+
+/**
+ * 生成安全的 HTML 模板
+ * 用于 AG-Grid 的 overlayNoRowsTemplate 等场景
+ */
+export function createSafeHtmlTemplate(text, styles) {
+  var safeText = escapeHtml(text);
+  var defaultStyles = "\n    display: flex;\n    justify-content: center;\n    align-items: center;\n    height: 100%;\n    font-size: 14px;\n    color: #aaa;\n    line-height: 1.5;\n    text-align: center;\n  ";
+  return "<span style=\"".concat(styles || defaultStyles, "\">").concat(safeText, "</span>");
+}

package/dist/esm/ag-grid-plus/utils/valueEnumColor.d.ts

@@ -0,0 +1,17 @@
+/** antd Tag 语义档名。 */
+export type SemanticPreset = 'default' | 'processing' | 'success' | 'warning' | 'error';
+/** 语义档名 → 表格文字色（白底实测 ≥4.5:1）。 */
+export declare const semanticTextColors: Record<SemanticPreset, string>;
+/**
+ * 把任意 valueEnum.color 收成表格可用的 CSS 色。
+ *
+ * @param color 枚举项上的 color（语义档、预设名、hex 或缺省）
+ * @param background 单元格底色（hex）；不传按白底。深色底提亮、浅色底压暗
+ */
+export declare const toGridTextColor: (color?: string, background?: string) => string;
+/** 把枚举转成 `valueEnum` 可用的副本（color 一定是当前底色可读的 CSS 色值），不修改源数组。 */
+export declare const gridValueEnum: <T extends {
+    color?: string | undefined;
+}>(items: readonly T[], background?: string) => (T & {
+    color: string;
+})[];

package/dist/esm/ag-grid-plus/utils/valueEnumColor.js

@@ -0,0 +1,95 @@
+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); }
+/**
+ * `valueEnum.color` 的表格文字色适配。
+ *
+ * 同一份状态/类别枚举有两个消费方，对 `color` 的要求不同：
+ * - antd `<Tag color>` 接受语义档名（`'success'` / `'warning'` …）和预设色名（`'cyan'`）；
+ * - AgGridPlus 的 `valueEnum` 把 `color` 直接当 **CSS color** 渲染表格文字。
+ *
+ * 直接透传会让这几类取值在表格里「字看不见」：语义档名与预设名不是合法 CSS
+ * （`'cyan'` 是 `#00ffff`，`'default'` 根本不合法）；hex 太浅（`#d9d9d9` 白底 1.3:1、`#52c41a` 2.3:1）。
+ * 这里把任意 color 收成当前底色上够读（WCAG 正文 4.5:1）的 CSS 色，缺省/无法解析写成 `inherit`，
+ * 跟随单元格正文色。已经够读的 hex 原样返回，所以重复调用是幂等的。
+ *
+ * 语义档色值经 `contrastRatio` 实测：白底均 ≥4.5:1（green-7/orange-7 只有 3.4~3.6:1，不能想当然）。
+ *
+ * @author nokecy
+ */
+import { contrastRatio, darkenUntilContrast, lightenUntilContrast, relativeLuminance } from "../../shared/contrast";
+
+/** antd Tag 语义档名。 */
+
+var WHITE = '#ffffff';
+
+/** 语义档名 → 表格文字色（白底实测 ≥4.5:1）。 */
+export var semanticTextColors = {
+  default: '#595959',
+  processing: '#0958d9',
+  success: '#237804',
+  warning: '#ad4e00',
+  error: '#cf1322'
+};
+
+/** antd Tag 预设名 / 常见 CSS 色名 → 起始 hex，再交给对比度压色。 */
+var namedColorHex = {
+  cyan: '#00ffff',
+  aqua: '#00ffff',
+  geekblue: '#2f54eb',
+  blue: '#0000ff',
+  orange: '#ffa500',
+  gold: '#ffd700',
+  lime: '#00ff00',
+  volcano: '#fa541c',
+  magenta: '#ff00ff',
+  fuchsia: '#ff00ff',
+  purple: '#800080',
+  red: '#ff0000',
+  green: '#008000',
+  pink: '#ffc0cb',
+  yellow: '#ffff00',
+  white: '#ffffff',
+  silver: '#c0c0c0'
+};
+var parseHex = function parseHex(color) {
+  var raw = color.trim();
+  if (!/^#([0-9a-f]{3}|[0-9a-f]{6})$/i.test(raw)) return undefined;
+  return raw.length === 4 ? "#".concat(raw[1]).concat(raw[1]).concat(raw[2]).concat(raw[2]).concat(raw[3]).concat(raw[3]).toLowerCase() : raw.toLowerCase();
+};
+
+/** 底色是否为深色表面。 */
+var isDarkSurface = function isDarkSurface(background) {
+  return relativeLuminance(background) < 0.18;
+};
+
+/**
+ * 把任意 valueEnum.color 收成表格可用的 CSS 色。
+ *
+ * @param color 枚举项上的 color（语义档、预设名、hex 或缺省）
+ * @param background 单元格底色（hex）；不传按白底。深色底提亮、浅色底压暗
+ */
+export var toGridTextColor = function toGridTextColor(color, background) {
+  if (!color) return 'inherit';
+  var hex = semanticTextColors[color] || namedColorHex[color.toLowerCase()] || parseHex(color);
+  if (!hex) return 'inherit';
+  var surface = background && parseHex(background) ? background : WHITE;
+  if (isDarkSurface(surface)) return lightenUntilContrast(hex, {
+    against: surface
+  });
+  return contrastRatio(hex, surface) >= 4.5 ? hex : darkenUntilContrast(hex, {
+    against: surface
+  });
+};
+
+/** 把枚举转成 `valueEnum` 可用的副本（color 一定是当前底色可读的 CSS 色值），不修改源数组。 */
+export var gridValueEnum = function gridValueEnum(items, background) {
+  return items.map(function (item) {
+    return _objectSpread(_objectSpread({}, item), {}, {
+      color: toGridTextColor(item.color, background)
+    });
+  });
+};

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

@@ -0,0 +1,15 @@
+import { ValueFormatterParams } from 'ag-grid-community';
+import { AgGridColumnPropsClone } from './interface';
+/**
+ * 将高级查询规则转换为后端 Gridify Filter 字符串
+ * 使用 gridify-client 库确保安全性和兼容性
+ */
+export declare const convertRulesToFilterString: (ruleGroup: any, colDefs: any[]) => string;
+declare const convertFilterModel: (filterModel: any, colDefs: AgGridColumnPropsClone[]) => string;
+declare const convertSortModel: (sortModel: any[]) => string;
+declare const dateValueFormatter: (params: ValueFormatterParams) => string;
+declare const dateTimeValueFormatter: (params: ValueFormatterParams) => string;
+declare const flatten: (arr: any[], keyName: any, parentref?: any[]) => any;
+declare const toTree: (data: any[], keyName: any, parentKeyName: any) => any[];
+declare const flattenTreeDeep: (treeData: any[], childrenName?: string) => any[];
+export { dateValueFormatter, dateTimeValueFormatter, convertFilterModel, convertSortModel, flattenTreeDeep, toTree, flatten };