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

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

@@ -0,0 +1,25 @@
+/**
+ * `valueEnum` 的状态胶囊：形状 + 文字 + 底色三重编码，去掉颜色后仍可凭形状与文字区分。
+ *
+ * 状态语义色属于语义层，不随主题变化，所以色值写在这里；
+ * 文字色对底色 ≥ 4.5:1，图标色对底色 ≥ 3:1。
+ */
+import React from 'react';
+export type StatusKey = 'wait' | 'running' | 'done' | 'warning' | 'alarm' | 'closed';
+type StatusIcon = 'ring' | 'half' | 'check' | 'warn' | 'cross' | 'dash';
+export declare const STATUS_PILL: Record<StatusKey, {
+    icon: StatusIcon;
+    fg: string;
+    bg: string;
+    mark: string;
+}>;
+/** 深色表面上的六态：底色压暗、文字与图标提亮，文字对底色 ≥ 4.5:1，图标 ≥ 3:1 */
+export declare const STATUS_PILL_DARK: typeof STATUS_PILL;
+export declare const isStatusKey: (v: unknown) => v is StatusKey;
+/** 表格单元格内的状态胶囊，高 18px，适配紧凑行高 */
+export declare const StatusPill: React.FC<{
+    status: StatusKey;
+    dark?: boolean;
+    children?: React.ReactNode;
+}>;
+export {};

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

@@ -0,0 +1,192 @@
+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` 的状态胶囊：形状 + 文字 + 底色三重编码，去掉颜色后仍可凭形状与文字区分。
+ *
+ * 状态语义色属于语义层，不随主题变化，所以色值写在这里；
+ * 文字色对底色 ≥ 4.5:1，图标色对底色 ≥ 3:1。
+ */
+import React from 'react';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+export var STATUS_PILL = {
+  wait: {
+    icon: 'ring',
+    fg: '#55606e',
+    bg: '#eef1f5',
+    mark: '#55606e'
+  },
+  running: {
+    icon: 'half',
+    fg: '#1f5fbf',
+    bg: '#eaf1fb',
+    mark: '#1f5fbf'
+  },
+  done: {
+    icon: 'check',
+    fg: '#276a4e',
+    bg: '#eaf4ef',
+    mark: '#276a4e'
+  },
+  warning: {
+    icon: 'warn',
+    fg: '#8a5a12',
+    bg: '#fdf5e6',
+    mark: '#9a6200'
+  },
+  alarm: {
+    icon: 'cross',
+    fg: '#8c3b34',
+    bg: '#fbf0ef',
+    mark: '#b4453c'
+  },
+  closed: {
+    icon: 'dash',
+    fg: '#5f6b7a',
+    bg: '#f1f3f6',
+    mark: '#5f6b7a'
+  }
+};
+
+/** 深色表面上的六态：底色压暗、文字与图标提亮，文字对底色 ≥ 4.5:1，图标 ≥ 3:1 */
+export var STATUS_PILL_DARK = {
+  wait: {
+    icon: 'ring',
+    fg: '#aab4c2',
+    bg: '#262b33',
+    mark: '#aab4c2'
+  },
+  running: {
+    icon: 'half',
+    fg: '#7fb0f5',
+    bg: '#14233d',
+    mark: '#7fb0f5'
+  },
+  done: {
+    icon: 'check',
+    fg: '#6fcf9f',
+    bg: '#12281f',
+    mark: '#6fcf9f'
+  },
+  warning: {
+    icon: 'warn',
+    fg: '#e8b75a',
+    bg: '#32250f',
+    mark: '#e8b75a'
+  },
+  alarm: {
+    icon: 'cross',
+    fg: '#f09a92',
+    bg: '#331a18',
+    mark: '#f09a92'
+  },
+  closed: {
+    icon: 'dash',
+    fg: '#9aa5b3',
+    bg: '#23272d',
+    mark: '#9aa5b3'
+  }
+};
+export var isStatusKey = function isStatusKey(v) {
+  return typeof v === 'string' && v in STATUS_PILL;
+};
+var Glyph = function Glyph(_ref) {
+  var icon = _ref.icon,
+    color = _ref.color;
+  var common = {
+    fill: 'none',
+    stroke: color,
+    strokeWidth: 1.5,
+    strokeLinecap: 'round',
+    strokeLinejoin: 'round'
+  };
+  return /*#__PURE__*/_jsxs("svg", {
+    width: 12,
+    height: 12,
+    viewBox: "0 0 12 12",
+    "aria-hidden": "true",
+    focusable: "false",
+    style: {
+      flex: 'none',
+      display: 'block'
+    },
+    children: [icon === 'ring' && /*#__PURE__*/_jsx("circle", _objectSpread({
+      cx: "6",
+      cy: "6",
+      r: "4.25"
+    }, common)), icon === 'half' && /*#__PURE__*/_jsxs(_Fragment, {
+      children: [/*#__PURE__*/_jsx("circle", _objectSpread({
+        cx: "6",
+        cy: "6",
+        r: "4.25"
+      }, common)), /*#__PURE__*/_jsx("path", {
+        d: "M6 1.75 A4.25 4.25 0 0 1 6 10.25 Z",
+        fill: color,
+        stroke: "none"
+      })]
+    }), icon === 'check' && /*#__PURE__*/_jsxs(_Fragment, {
+      children: [/*#__PURE__*/_jsx("circle", _objectSpread({
+        cx: "6",
+        cy: "6",
+        r: "4.25"
+      }, common)), /*#__PURE__*/_jsx("path", _objectSpread({
+        d: "M3.9 6.2 5.3 7.6 8.2 4.5"
+      }, common))]
+    }), icon === 'warn' && /*#__PURE__*/_jsxs(_Fragment, {
+      children: [/*#__PURE__*/_jsx("path", _objectSpread({
+        d: "M6 1.6 10.8 10 1.2 10Z"
+      }, common)), /*#__PURE__*/_jsx("path", _objectSpread({
+        d: "M6 4.6V7M6 8.5V8.6"
+      }, common))]
+    }), icon === 'cross' && /*#__PURE__*/_jsxs(_Fragment, {
+      children: [/*#__PURE__*/_jsx("circle", _objectSpread({
+        cx: "6",
+        cy: "6",
+        r: "4.25"
+      }, common)), /*#__PURE__*/_jsx("path", _objectSpread({
+        d: "M4.3 4.3 7.7 7.7M7.7 4.3 4.3 7.7"
+      }, common))]
+    }), icon === 'dash' && /*#__PURE__*/_jsxs(_Fragment, {
+      children: [/*#__PURE__*/_jsx("circle", _objectSpread({
+        cx: "6",
+        cy: "6",
+        r: "4.25"
+      }, common)), /*#__PURE__*/_jsx("path", _objectSpread({
+        d: "M4 6H8"
+      }, common))]
+    })]
+  });
+};
+
+/** 表格单元格内的状态胶囊，高 18px，适配紧凑行高 */
+export var StatusPill = function StatusPill(_ref2) {
+  var status = _ref2.status,
+    dark = _ref2.dark,
+    children = _ref2.children;
+  var s = (dark ? STATUS_PILL_DARK : STATUS_PILL)[status];
+  return /*#__PURE__*/_jsxs("span", {
+    style: {
+      display: 'inline-flex',
+      alignItems: 'center',
+      gap: 5,
+      height: 18,
+      paddingInline: 7,
+      borderRadius: 3,
+      fontSize: 12,
+      lineHeight: '18px',
+      color: s.fg,
+      background: s.bg,
+      whiteSpace: 'nowrap',
+      verticalAlign: 'middle'
+    },
+    children: [/*#__PURE__*/_jsx(Glyph, {
+      icon: s.icon,
+      color: s.mark
+    }), children]
+  });
+};

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

@@ -0,0 +1,22 @@
+/** antd Tag 语义档名。 */
+export type SemanticPreset = 'default' | 'processing' | 'success' | 'warning' | 'error';
+/**
+ * 语义档名 → 表格文字色，取状态胶囊六态的文字色（statusPill.ts，对各自底色 ≥4.5:1，白底同样达标），
+ * 没配 `status` 的枚举与配了 `status` 的列在同一页上色值一致（DESIGN.md §3.2）。
+ */
+export declare const semanticTextColors: Record<SemanticPreset, string>;
+/** 底色是否为深色表面。 */
+export declare const isDarkSurface: (background?: string) => boolean;
+/**
+ * 把任意 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,99 @@
+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 { STATUS_PILL } from "./statusPill";
+import { contrastRatio, darkenUntilContrast, lightenUntilContrast, relativeLuminance } from "../../shared/contrast";
+
+/** antd Tag 语义档名。 */
+
+var WHITE = '#ffffff';
+
+/**
+ * 语义档名 → 表格文字色，取状态胶囊六态的文字色（statusPill.ts，对各自底色 ≥4.5:1，白底同样达标），
+ * 没配 `status` 的枚举与配了 `status` 的列在同一页上色值一致（DESIGN.md §3.2）。
+ */
+export var semanticTextColors = {
+  default: STATUS_PILL.wait.fg,
+  processing: STATUS_PILL.running.fg,
+  success: STATUS_PILL.done.fg,
+  warning: STATUS_PILL.warning.fg,
+  error: STATUS_PILL.alarm.fg
+};
+
+/** 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();
+};
+
+/** 底色是否为深色表面。 */
+export var isDarkSurface = function isDarkSurface(background) {
+  return !!background && !!parseHex(background) && 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/valueFormat.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 表格数据格式出厂默认（DESIGN.md §7.7）：数字千分位、空值 `—`；页面自己写 valueFormatter 即覆盖。
+ * @author nokecy
+ */
+export declare const EMPTY_PLACEHOLDER = "\u2014";
+/** 空值统一为 `—`；0 是有效值，原样保留。 */
+export declare const isEmptyValue: (value: unknown) => boolean;
+/**
+ * 千分位，只动整数部分，小数位原样保留（字符串数值不经过浮点，不丢精度）。
+ * 不是纯数字的值（科学计数法、带单位的文本）原样返回。
+ */
+export declare function formatThousands(value: unknown): string;
+/** 只补空值占位。 */
+export declare function formatEmpty(value: unknown): string;
+/**
+ * 给没有自己 valueFormatter 的叶子列补默认格式。已有 valueFormatter、枚举列、日期/布尔列类型一律不动。
+ * @param inferredNumber 该列由首行数据推断为数值
+ */
+export declare function withDefaultValueFormat<T extends Record<string, any>>(col: T, inferredNumber: boolean): T;

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

@@ -0,0 +1,63 @@
+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); }
+/**
+ * 表格数据格式出厂默认（DESIGN.md §7.7）：数字千分位、空值 `—`；页面自己写 valueFormatter 即覆盖。
+ * @author nokecy
+ */
+
+export var EMPTY_PLACEHOLDER = '—';
+var PLAIN_NUMBER = /^(-?)(\d+)(\.\d+)?$/;
+
+/** 空值统一为 `—`；0 是有效值，原样保留。 */
+export var isEmptyValue = function isEmptyValue(value) {
+  return value === null || value === undefined || value === '';
+};
+
+/**
+ * 千分位，只动整数部分，小数位原样保留（字符串数值不经过浮点，不丢精度）。
+ * 不是纯数字的值（科学计数法、带单位的文本）原样返回。
+ */
+export function formatThousands(value) {
+  var _m$;
+  if (isEmptyValue(value)) return EMPTY_PLACEHOLDER;
+  var text = String(value).trim();
+  var m = PLAIN_NUMBER.exec(text);
+  if (!m) return String(value);
+  return "".concat(m[1]).concat(m[2].replace(/\B(?=(\d{3})+(?!\d))/g, ',')).concat((_m$ = m[3]) !== null && _m$ !== void 0 ? _m$ : '');
+}
+
+/** 只补空值占位。 */
+export function formatEmpty(value) {
+  return isEmptyValue(value) ? EMPTY_PLACEHOLDER : String(value);
+}
+
+/** 字段名像编码、年份、序号的数值列不加千分位（订单号、年份加逗号是错的）。 */
+var IDENTIFIER_LIKE = /(?:^|[a-z])(?:id|code|no|number|year|seq|sequence|sort|order|index)$/i;
+var EXPLICIT_NUMERIC = new Set(['numericColumn', 'numberColumn']);
+var SKIP_TYPES = new Set(['dateColumn', 'dateTimeColumn', 'bool']);
+
+/**
+ * 给没有自己 valueFormatter 的叶子列补默认格式。已有 valueFormatter、枚举列、日期/布尔列类型一律不动。
+ * @param inferredNumber 该列由首行数据推断为数值
+ */
+export function withDefaultValueFormat(col, inferredNumber) {
+  var _col$field;
+  if (col.valueFormatter || col.valueEnum) return col;
+  var types = (Array.isArray(col.type) ? col.type : [col.type]).filter(Boolean).map(String);
+  if (types.some(function (t) {
+    return SKIP_TYPES.has(t);
+  })) return col;
+  var field = String((_col$field = col.field) !== null && _col$field !== void 0 ? _col$field : '');
+  var numeric = types.some(function (t) {
+    return EXPLICIT_NUMERIC.has(t);
+  }) || inferredNumber && !IDENTIFIER_LIKE.test(field);
+  return _objectSpread(_objectSpread({}, col), {}, {
+    valueFormatter: function valueFormatter(p) {
+      return numeric ? formatThousands(p.value) : formatEmpty(p.value);
+    }
+  });
+}

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 };