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

package/dist/cjs/array-table/requiredHeader.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isRequiredColumn = isRequiredColumn;
+exports.withRequiredColumnHeader = withRequiredColumnHeader;
+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); }
+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); }
+/** 字段规则与提交专用标识共同决定列头提示；格式校验不等于必填。@author nokecy */
+function isRequiredColumn(schema, submitRequired) {
+  if (submitRequired === true || (schema === null || schema === void 0 ? void 0 : schema.required) === true) return true;
+  var validators = Array.isArray(schema === null || schema === void 0 ? void 0 : schema['x-validator']) ? schema['x-validator'] : [schema === null || schema === void 0 ? void 0 : schema['x-validator']];
+  return validators.some(function (rule) {
+    return rule && _typeof(rule) === 'object' && rule.required === true;
+  });
+}
+
+/** 只改变编辑表头的样式和提示，保留原始列名以供复制、导出、排序及列方案使用。@author nokecy */
+function withRequiredColumnHeader(column, required, readOnly) {
+  if (!required || readOnly) return column;
+  var original = column.headerClass;
+  return _objectSpread(_objectSpread({}, column), {}, {
+    headerTooltip: column.headerTooltip ? "".concat(column.headerTooltip, "\uFF08\u5FC5\u586B\uFF09") : '必填',
+    headerClass: function headerClass(params) {
+      var classes = typeof original === 'function' ? original(params) : original;
+      return Array.from(new Set([].concat(_toConsumableArray(Array.isArray(classes) ? classes : classes ? [classes] : []), ['qc-array-table-required'])));
+    }
+  });
+}

package/dist/cjs/array-table/rowFeedback.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="react" />
+import type { ArrayField } from '@nokecy/formily-core';
+/**
+ * 默认(loose)反馈布局下,单元格里的校验错误文字画在输入框下方;行高只放得下输入框,
+ * 错误文字会被单元格/下一行/表格底边盖住(formily #4134)。出错的行额外加这么多高度来放它。
+ */
+export declare const ROW_FEEDBACK_EXTRA_HEIGHT = 24;
+/**
+ * 找出当前有「行内错误文字」的行:返回这些行的数据对象(与 AG-Grid rowData 里的元素同一引用)。
+ *
+ * 只看数组元素下的字段错误;装饰器上写了 feedbackLayout: 'popover' | 'none' 的字段错误不占位,不计入。
+ * 这里读的是整张字段表(queryFeedbacks 会遍历数组下所有字段),不要在组件渲染期间调用——
+ * 渲染期读它会让组件订阅字段表,每创建一个字段就重渲一次。请用 useFeedbackRows。@author nokecy
+ */
+export declare const collectFeedbackRows: (arrayField: ArrayField, defaultLayout?: string) => Set<object>;
+/**
+ * 订阅数组下字段的校验反馈,返回「有行内错误文字的行」。
+ *
+ * 不在渲染期读错误(见 collectFeedbackRows 说明),而是挂 Formily 事件:字段校验结束、字段卸载(删行)、表单重置时,
+ * 合并成一次(下一个宏任务)重算;行集合变化才触发重渲。rows 供 AG-Grid 的 getRowHeight 同步读取,
+ * signature(有错误的行下标)变化时调用方让网格重算行高。@author nokecy
+ */
+export declare const useFeedbackRows: (arrayField: ArrayField, defaultLayout?: string) => {
+    rowsRef: import("react").RefObject<Set<object>>;
+    signature: string;
+};

package/dist/cjs/array-table/rowFeedback.js

@@ -0,0 +1,115 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useFeedbackRows = exports.collectFeedbackRows = exports.ROW_FEEDBACK_EXTRA_HEIGHT = void 0;
+var _react = require("react");
+var _formilyCore = require("@nokecy/formily-core");
+var _uniqueId = _interopRequireDefault(require("lodash/uniqueId"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+/**
+ * 默认(loose)反馈布局下,单元格里的校验错误文字画在输入框下方;行高只放得下输入框,
+ * 错误文字会被单元格/下一行/表格底边盖住(formily #4134)。出错的行额外加这么多高度来放它。
+ */
+var ROW_FEEDBACK_EXTRA_HEIGHT = exports.ROW_FEEDBACK_EXTRA_HEIGHT = 24;
+
+/** 这些反馈布局的错误不占行内位置(浮层 / 不显示 / terse 紧凑浮层),不需要撑高行 */
+var OUT_OF_FLOW_LAYOUTS = new Set(['popover', 'none', 'terse']);
+
+/**
+ * 找出当前有「行内错误文字」的行:返回这些行的数据对象(与 AG-Grid rowData 里的元素同一引用)。
+ *
+ * 只看数组元素下的字段错误;装饰器上写了 feedbackLayout: 'popover' | 'none' 的字段错误不占位,不计入。
+ * 这里读的是整张字段表(queryFeedbacks 会遍历数组下所有字段),不要在组件渲染期间调用——
+ * 渲染期读它会让组件订阅字段表,每创建一个字段就重渲一次。请用 useFeedbackRows。@author nokecy
+ */
+var collectFeedbackRows = exports.collectFeedbackRows = function collectFeedbackRows(arrayField, defaultLayout) {
+  var rows = new Set();
+  var form = arrayField === null || arrayField === void 0 ? void 0 : arrayField.form;
+  var value = arrayField === null || arrayField === void 0 ? void 0 : arrayField.value;
+  if (!form || !Array.isArray(value)) return rows;
+  var base = arrayField.address.toString();
+  var baseLength = arrayField.path.length;
+  var _iterator = _createForOfIteratorHelper(form.queryFeedbacks({
+      type: 'error',
+      address: "".concat(base, ".*")
+    })),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _feedback$path$segmen, _feedback$path, _feedback$path2, _feedback$path2$toStr, _feedback$path3, _form$query$take$deco, _form$query$take;
+      var feedback = _step.value;
+      var index = Number((_feedback$path$segmen = (_feedback$path = feedback.path) === null || _feedback$path === void 0 || (_feedback$path = _feedback$path.segments) === null || _feedback$path === void 0 ? void 0 : _feedback$path[baseLength]) !== null && _feedback$path$segmen !== void 0 ? _feedback$path$segmen : (_feedback$path2 = feedback.path) === null || _feedback$path2 === void 0 || (_feedback$path2$toStr = (_feedback$path3 = _feedback$path2).toString) === null || _feedback$path2$toStr === void 0 ? void 0 : _feedback$path2$toStr.call(_feedback$path3).split('.')[baseLength]);
+      var row = value[index];
+      if (!Number.isInteger(index) || row == null || _typeof(row) !== 'object') continue;
+      var layout = (_form$query$take$deco = (_form$query$take = form.query(feedback.address).take()) === null || _form$query$take === void 0 || (_form$query$take = _form$query$take.decoratorProps) === null || _form$query$take === void 0 ? void 0 : _form$query$take.feedbackLayout) !== null && _form$query$take$deco !== void 0 ? _form$query$take$deco : defaultLayout;
+      if (OUT_OF_FLOW_LAYOUTS.has(layout)) continue;
+      rows.add(row);
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return rows;
+};
+
+/**
+ * 订阅数组下字段的校验反馈,返回「有行内错误文字的行」。
+ *
+ * 不在渲染期读错误(见 collectFeedbackRows 说明),而是挂 Formily 事件:字段校验结束、字段卸载(删行)、表单重置时,
+ * 合并成一次(下一个宏任务)重算;行集合变化才触发重渲。rows 供 AG-Grid 的 getRowHeight 同步读取,
+ * signature(有错误的行下标)变化时调用方让网格重算行高。@author nokecy
+ */
+var useFeedbackRows = exports.useFeedbackRows = function useFeedbackRows(arrayField, defaultLayout) {
+  var rowsRef = (0, _react.useRef)(new Set());
+  var _useState = (0, _react.useState)(''),
+    _useState2 = _slicedToArray(_useState, 2),
+    signature = _useState2[0],
+    setSignature = _useState2[1];
+  (0, _react.useEffect)(function () {
+    var form = arrayField === null || arrayField === void 0 ? void 0 : arrayField.form;
+    if (!form) return;
+    var id = (0, _uniqueId.default)('array-table-feedback-');
+    var pattern = "".concat(arrayField.address.toString(), ".*");
+    var timer;
+    var refresh = function refresh() {
+      if (timer !== undefined) clearTimeout(timer);
+      timer = setTimeout(function () {
+        timer = undefined;
+        var rows = collectFeedbackRows(arrayField, defaultLayout);
+        rowsRef.current = rows;
+        var value = Array.isArray(arrayField.value) ? arrayField.value : [];
+        var next = value.flatMap(function (row, index) {
+          return rows.has(row) ? [index] : [];
+        }).join(',');
+        setSignature(function (prev) {
+          return prev === next ? prev : next;
+        });
+      }, 0);
+    };
+    form.addEffects(id, function () {
+      (0, _formilyCore.onFieldValidateEnd)(pattern, refresh);
+      (0, _formilyCore.onFieldUnmount)(pattern, refresh);
+      (0, _formilyCore.onFormReset)(refresh);
+    });
+    refresh();
+    return function () {
+      if (timer !== undefined) clearTimeout(timer);
+      form.removeEffects(id);
+    };
+  }, [arrayField, defaultLayout]);
+  return {
+    rowsRef: rowsRef,
+    signature: signature
+  };
+};

package/dist/cjs/array-table/rowIdentity.d.ts

@@ -0,0 +1,17 @@
+import type { ArrayField } from '@nokecy/formily-core';
+/**
+ * 读取业务行标识；尚未补入表单的行按对象缓存临时标识，不在渲染期间改写表单。
+ * @param row 明细行。
+ * @param generatedIds 当前表格已分配的临时行标识。
+ * @returns AG-Grid 使用的稳定字符串标识。
+ * @author nokecy
+ */
+export declare const getArrayTableRowId: (row: Record<string, any>, generatedIds: WeakMap<object, string>) => string;
+/**
+ * 在 effect 中为缺少业务标识的明细补入可枚举 _id，使业务克隆行时保留 AG-Grid 行身份。
+ * 复用首次渲染已分配的标识，补值本身不会使单元格重挂；已有 _id/id（含 0）保持原值。
+ * @param field 当前明细数组字段。
+ * @param generatedIds 当前表格已分配的临时行标识。
+ * @author nokecy
+ */
+export declare const ensureArrayTableRowIds: (field: ArrayField, generatedIds: WeakMap<object, string>) => void;

package/dist/cjs/array-table/rowIdentity.js

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getArrayTableRowId = exports.ensureArrayTableRowIds = void 0;
+var _uniqueId = _interopRequireDefault(require("lodash/uniqueId"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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); }
+/**
+ * 读取业务行标识；尚未补入表单的行按对象缓存临时标识，不在渲染期间改写表单。
+ * @param row 明细行。
+ * @param generatedIds 当前表格已分配的临时行标识。
+ * @returns AG-Grid 使用的稳定字符串标识。
+ * @author nokecy
+ */
+var getArrayTableRowId = exports.getArrayTableRowId = function getArrayTableRowId(row, generatedIds) {
+  var _row$_id;
+  var existingId = (_row$_id = row._id) !== null && _row$_id !== void 0 ? _row$_id : row.id;
+  if (existingId != null) return String(existingId);
+  var generatedId = generatedIds.get(row);
+  if (!generatedId) {
+    generatedId = (0, _uniqueId.default)('row_');
+    generatedIds.set(row, generatedId);
+  }
+  return generatedId;
+};
+
+/**
+ * 在 effect 中为缺少业务标识的明细补入可枚举 _id，使业务克隆行时保留 AG-Grid 行身份。
+ * 复用首次渲染已分配的标识，补值本身不会使单元格重挂；已有 _id/id（含 0）保持原值。
+ * @param field 当前明细数组字段。
+ * @param generatedIds 当前表格已分配的临时行标识。
+ * @author nokecy
+ */
+var ensureArrayTableRowIds = exports.ensureArrayTableRowIds = function ensureArrayTableRowIds(field, generatedIds) {
+  if (!Array.isArray(field.value)) return;
+  field.value.forEach(function (row, index) {
+    var _row$_id2;
+    if (row == null || _typeof(row) !== 'object' || ((_row$_id2 = row._id) !== null && _row$_id2 !== void 0 ? _row$_id2 : row.id) != null) return;
+    field.form.setValuesIn(field.path.concat(index).concat('_id'), getArrayTableRowId(row, generatedIds));
+  });
+};

package/dist/cjs/array-table/sorting.d.ts

@@ -0,0 +1,3 @@
+import { type ReadOnlyFormatter } from './readOnlyFormatters';
+/** 按列的展示字段和数据类型比较明细值，保留原始选择对象供表单绑定使用。@author nokecy */
+export declare const createArrayTableComparator: (fieldSchema: any, columnProps: any, formatter: ReadOnlyFormatter | null) => (a: any, b: any) => number;

package/dist/cjs/array-table/sorting.js

@@ -0,0 +1,46 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createArrayTableComparator = void 0;
+var _decimal = _interopRequireDefault(require("decimal.js"));
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _readOnlyFormatters = require("./readOnlyFormatters");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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); }
+/** 按列的展示字段和数据类型比较明细值，保留原始选择对象供表单绑定使用。@author nokecy */
+var createArrayTableComparator = exports.createArrayTableComparator = function createArrayTableComparator(fieldSchema, columnProps, formatter) {
+  var _fieldSchema$xCompon, _fieldSchema$xCompon2;
+  var component = String((_fieldSchema$xCompon = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']) !== null && _fieldSchema$xCompon !== void 0 ? _fieldSchema$xCompon : '');
+  var numeric = (fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.type) === 'number' || (fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.type) === 'integer' || /^(InputNumber|NumberPicker|DecimalPicker|MoneyPicker)$/.test(component) || [columnProps === null || columnProps === void 0 ? void 0 : columnProps.type].flat().some(function (type) {
+    return type === 'numericColumn' || type === 'numberColumn';
+  });
+  var temporal = /^(DatePicker|TimePicker)(\.|$)/.test(component);
+  var displayField = (fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon2 = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon2 === void 0 ? void 0 : _fieldSchema$xCompon2.displayField) === 'value' ? 'value' : 'label';
+  var scalar = function scalar(value) {
+    var _value$label;
+    if (value == null) return null;
+    if (Array.isArray(value)) return (0, _readOnlyFormatters.formatSelectDisplay)(value, displayField);
+    if (_typeof(value) === 'object' && ('value' in value || 'label' in value)) return scalar(displayField === 'value' ? value.value : (_value$label = value.label) !== null && _value$label !== void 0 ? _value$label : value.value);
+    if (temporal && (0, _dayjs.default)(value).isValid()) return (0, _dayjs.default)(value).valueOf();
+    if (numeric || typeof value === 'number' || typeof value === 'boolean') return value;
+    return formatter ? formatter(value, {
+      columnProps: columnProps,
+      fieldSchema: fieldSchema
+    }) : String(value);
+  };
+  return function (a, b) {
+    var left = scalar(a);
+    var right = scalar(b);
+    if (left == null || left === '') return right == null || right === '' ? 0 : -1;
+    if (right == null || right === '') return 1;
+    if (numeric || temporal || typeof left === 'number' && typeof right === 'number') {
+      try {
+        return new _decimal.default(left).cmp(new _decimal.default(right));
+      } catch (_unused) {/* 无效数值按展示文字排序。 */}
+    }
+    if (typeof left === 'boolean' && typeof right === 'boolean') return Number(left) - Number(right);
+    return String(left).localeCompare(String(right), 'zh-CN');
+  };
+};

package/dist/cjs/array-table/summary.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import type { ColDef } from 'ag-grid-community';
+/**
+ * 合计行（固定在表尾，不随滚动，不参与排序、勾选、序号）。
+ * 键是列的 field（ArrayTable.Column 的 dataIndex / 内层字段名），值是固定内容，或由当前全部明细行算出内容的函数；
+ * 函数在 Observer 里执行，明细任何字段变化都会重算。没有写到的列该格留空。
+ *
+ * @author nokecy
+ */
+export type ArrayTableSummary = Record<string, React.ReactNode | ((rows: any[]) => React.ReactNode)>;
+/** 合计行的承载数据；AG-Grid 要求固定行有数据对象才会渲染单元格 */
+export declare const ARRAY_TABLE_SUMMARY_ROW: {
+    __arrayTableSummary: boolean;
+}[];
+type SummaryCellParams = {
+    colDef?: ColDef;
+    getSummary: () => ArrayTableSummary | undefined;
+    getRows: () => any[];
+};
+/**
+ * 给列定义补上「固定行用合计渲染」的选择器，普通行仍走列原有的渲染器。
+ * 用 cellRendererSelector 而不是替换 cellRenderer：列上依赖 cellRenderer 身份的逻辑（懒挂载识别等）不受影响。
+ */
+export declare const withSummaryCells: (columns: ColDef[], getSummary: SummaryCellParams['getSummary'], getRows: SummaryCellParams['getRows']) => ColDef[];
+export {};

package/dist/cjs/array-table/summary.js

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.withSummaryCells = exports.ARRAY_TABLE_SUMMARY_ROW = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _formilyReact = require("@nokecy/formily-react");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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); } /**
+ * 合计行（固定在表尾，不随滚动，不参与排序、勾选、序号）。
+ * 键是列的 field（ArrayTable.Column 的 dataIndex / 内层字段名），值是固定内容，或由当前全部明细行算出内容的函数；
+ * 函数在 Observer 里执行，明细任何字段变化都会重算。没有写到的列该格留空。
+ *
+ * @author nokecy
+ */
+/** 合计行的承载数据；AG-Grid 要求固定行有数据对象才会渲染单元格 */
+var ARRAY_TABLE_SUMMARY_ROW = exports.ARRAY_TABLE_SUMMARY_ROW = [{
+  __arrayTableSummary: true
+}];
+var SummaryCell = function SummaryCell(_ref) {
+  var colDef = _ref.colDef,
+    getSummary = _ref.getSummary,
+    getRows = _ref.getRows;
+  var key = colDef === null || colDef === void 0 ? void 0 : colDef.field;
+  if (!key) return null;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_formilyReact.Observer, {
+    children: function children() {
+      var _getSummary;
+      var item = (_getSummary = getSummary()) === null || _getSummary === void 0 ? void 0 : _getSummary[key];
+      var content = typeof item === 'function' ? item(getRows()) : item;
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
+        children: content == null ? null : /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+          "data-array-table-summary": key,
+          children: content
+        })
+      });
+    }
+  });
+};
+
+/**
+ * 给列定义补上「固定行用合计渲染」的选择器，普通行仍走列原有的渲染器。
+ * 用 cellRendererSelector 而不是替换 cellRenderer：列上依赖 cellRenderer 身份的逻辑（懒挂载识别等）不受影响。
+ */
+var withSummaryCells = exports.withSummaryCells = function withSummaryCells(columns, getSummary, getRows) {
+  return columns.map(function (col) {
+    if (Array.isArray(col.children)) return _objectSpread(_objectSpread({}, col), {}, {
+      children: withSummaryCells(col.children, getSummary, getRows)
+    });
+    return _objectSpread(_objectSpread({}, col), {}, {
+      cellRendererSelector: function cellRendererSelector(params) {
+        var _params$node, _col$cellRendererSele;
+        return (_params$node = params.node) !== null && _params$node !== void 0 && _params$node.rowPinned ? {
+          component: SummaryCell,
+          params: {
+            getSummary: getSummary,
+            getRows: getRows
+          }
+        } : (_col$cellRendererSele = col.cellRendererSelector) === null || _col$cellRendererSele === void 0 ? void 0 : _col$cellRendererSele.call(col, params);
+      }
+    });
+  });
+};

package/dist/cjs/array-table/theme.d.ts

@@ -0,0 +1,40 @@
+import type { GridDensity, GridDensityOverrides, GridDensityValues } from '../ag-grid-plus/density';
+/**
+ * Provider 没注入密度时的档位：DESIGN.md §2 把紧凑档定为 ERP 标准页默认。
+ * 原先写死 38，没有对应任何一档；回退到规范默认档，数值全部来自 density.ts。
+ */
+export declare const ARRAY_TABLE_FALLBACK_DENSITY: GridDensity;
+/** 回退档的行高，兼容旧的具名导出；实际行高请用 useArrayTableMetrics。 */
+export declare const ARRAY_TABLE_ROW_HEIGHT: number;
+/**
+ * 解析 ArrayTable 当前密度数值（纯函数，便于测试）。
+ * 网格选项 rowHeight/headerHeight 与主题参数必须同值——AG-Grid 单元格文字的行高
+ * (--ag-internal-content-line-height)是从主题的 --ag-row-height 算的，只设网格选项会让文字的行盒
+ * 仍是主题默认行高，顶在格子上方偏上。所以两处都从这一份数值取。
+ */
+export declare function resolveArrayTableMetrics(density?: GridDensity, overrides?: GridDensityOverrides): GridDensityValues;
+/** 读取 Provider 注入的密度，随 Provider 变化重算（密度运行时切换后行高即时更新）。 */
+export declare function useArrayTableMetrics(): GridDensityValues;
+/**
+ * 格内错误文字的总高度（含 terse 样式的 1px 边框，上下内边距与外边距归零，box-sizing: border-box）。
+ * 文字紧贴输入框下沿（top:100%），输入框高 = 行高 - 3px，所以格底到输入框底的距离是 ROW_FEEDBACK_EXTRA_HEIGHT + 3，
+ * 本值必须不超过它，否则会被行底边线穿过。
+ */
+export declare const ARRAY_TABLE_HELP_LINE_HEIGHT = 20;
+/** 表格里有出错行时挂在网格外层的类名(由 index.tsx 设置) */
+export declare const ARRAY_TABLE_FEEDBACK_CLASS = "ag-array-table-has-feedback";
+/**
+ * 单元格里的表单项与内容区垂直居中(只对使用本主题的网格生效,共用主题不受影响):
+ *  - .ag-cell-wrapper 撑满格子,align-items:center 才起作用(默认只有内容高,贴在格子顶部);
+ *    表格里有出错行时(外层带 ARRAY_TABLE_FEEDBACK_CLASS)内容高度不超过标准行高对应的高度:出错行会被撑高(见 rowFeedback.ts),
+ *    内容仍居中在上面那一段,多出来的高度留给输入框下方的错误文字,出错时输入框不会被挤得上下跳;
+ *  - FormItem 默认 margin-bottom:24px(loose 反馈布局给错误文字预留的位置),会把 Editable 外壳撑到 56px、
+ *    输入框偏上、还超出 37px 的格子,归零;
+ *  - AG-Grid 的 .ag-cell-value 默认 overflow:hidden,会把输入框下方的错误文字剪掉,只在格里正显示错误文字时放开;
+ *  - 错误文字单行显示、超出列宽省略,出错行只多留一行的高度(ROW_FEEDBACK_EXTRA_HEIGHT);
+ *  - 错误提示文字移出文档流(位置仍在输入框下方),出错时输入框不会被挤得上下跳。
+ */
+export declare const ARRAY_TABLE_CELL_FIT_CSS = "\n    .ag-cell .ag-cell-wrapper { height: 100%; max-height: 100%; min-height: 0; }\n    .ag-cell .ag-cell-value { max-height: 100%; min-height: 0; }\n    /* \u672C part \u7684 CSS \u4F1A\u88AB AG-Grid \u5305\u8FDB :where(.ag-theme-xxx) { ... }\uFF08\u5D4C\u5957\uFF09\uFF0C\u88F8\u5199 .has-feedback .ag-cell \u4F1A\u7F16\u8BD1\u6210\n       \u300C\u4E3B\u9898\u5143\u7D20\u7684\u540E\u4EE3 has-feedback\u300D\uFF0C\u800C\u8BE5\u7C7B\u6302\u5728\u4E3B\u9898\u5143\u7D20\u7684\u7956\u5148\u4E0A\uFF0C\u89C4\u5219\u6C38\u8FDC\u4E0D\u547D\u4E2D\u3002\n       \u6240\u4EE5\u7528 & \u663E\u5F0F\u653E\u5728 has-feedback \u4E4B\u540E\uFF08\u7956\u5148\u5199\u6CD5\uFF09\uFF0C\u540C\u65F6\u517C\u5BB9\u7C7B\u540D\u6302\u5728\u4E3B\u9898\u5143\u7D20\u81EA\u8EAB\u7684\u5199\u6CD5\u3002 */\n    .ag-array-table-has-feedback & .ag-cell .ag-cell-wrapper,\n    &.ag-array-table-has-feedback .ag-cell .ag-cell-wrapper { height: min(100%, calc(var(--ag-row-height) - 3px)); }\n    /* \u5BBF\u4E3B\u53EF\u80FD\u5199 .xxx .ant-formily-item { margin-bottom: 12px }\uFF08\u7279\u5F02\u6027 0,3,0\uFF09\uFF1B\u8FD9\u91CC\u53E0\u7C7B\u540D\u5E76 !important\uFF0C\u4EFB\u4F55\u5BBF\u4E3B\u89C4\u5219\u90FD\u538B\u4E0D\u8FC7\uFF0C\n       \u5426\u5219\u683C\u5185\u63A7\u4EF6\u4F1A\u88AB margin \u9876\u5F97\u504F\u4E0A 3-5px\u3002@author nokecy */\n    .ag-cell .ag-cell-wrapper .ant-formily-item.ant-formily-item { margin-bottom: 0 !important; }\n    /* \u6807\u9898\u548C\u8BF4\u660E\u7531\u5217\u5934\u627F\u8F7D\uFF0ClabelWidth:0 \u672C\u8EAB\u4E0D\u4F1A\u9690\u85CF\u5B57\u6BB5\u6807\u9898\u3002@author nokecy */\n    .ag-cell .ant-formily-item-label { display: none; }\n    .ag-cell .ant-formily-item-control { flex: 1; min-width: 0; width: 100%; }\n    /* \u5E26\u5916\u58F3\u7684\u8F93\u5165\u6846\uFF08affix/wrapper\uFF09\u662F inline-flex\uFF0Cantd \u7ED9\u8868\u5355\u9879\u5185\u5BB9\u533A controlHeight \u7684\u6700\u5C0F\u9AD8\u5EA6\u548C\u5BF9\u5E94\u884C\u9AD8\uFF0C\n       \u5916\u58F3\u6309\u57FA\u7EBF\u5BF9\u9F50\u88AB\u9876\u504F\u3002\u5185\u5BB9\u533A\u6539\u6210\u5C45\u4E2D\u7684 flex\uFF08\u5B50\u9879\u88AB\u5757\u5316\uFF0C\u4E0D\u518D\u6709\u57FA\u7EBF\u5BF9\u9F50\uFF09\uFF0C\u6700\u5C0F\u9AD8\u5EA6\u5F52\u96F6\uFF0C\n       \u8868\u5355\u9879\u9AD8\u5EA6\u7531\u63A7\u4EF6\u81EA\u5DF1\u7684\u9AD8\u5EA6\uFF08\u884C\u9AD8-3px\uFF09\u51B3\u5B9A\uFF0C\u4E0D\u8D85\u51FA\u884C\u9AD8\u3002 */\n    .ag-cell .ant-formily-item,\n    .ag-cell .ant-formily-item-control,\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { min-height: 0 !important; }\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { display: flex; align-items: center; }\n    .ag-cell .ant-formily-item-control-content-component { flex: 1 1 auto; min-width: 0; }\n    .ag-cell .ant-formily-item-control-content-component > * { flex: 1 1 auto; min-width: 0; }\n    /* \u9519\u8BEF\u6587\u5B57\u9489\u5728\u8F93\u5165\u6846\u6B63\u4E0B\u65B9\uFF08top:100% \u76F8\u5BF9 .ant-formily-item\uFF09\uFF0C\u9AD8\u5EA6\u56FA\u5B9A\u4E3A ARRAY_TABLE_HELP_LINE_HEIGHT\uFF0C\n       \u4E0D\u518D\u4F9D\u8D56\u6587\u6863\u6D41\u91CC\u7684\u9759\u6001\u4F4D\u7F6E\uFF08\u4F1A\u968F margin/\u5C45\u4E2D\u504F\u79FB\uFF0C\u5BFC\u81F4\u88AB\u884C\u5E95\u8FB9\u7EBF\u7A7F\u8FC7\uFF09\u3002 */\n    .ag-cell .ant-formily-item-help { position: absolute; top: 100%; inset-inline-start: 0; margin: 0 !important; padding-block: 0 !important; box-sizing: border-box !important; min-height: 0 !important; height: 20px !important; line-height: 18px !important; max-width: 100%; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n    .ag-cell .ag-cell-value:has(.ant-formily-item-help) { overflow: visible; }\n    /* \u5217\u5BF9\u9F50\uFF08align \u5199\u6CD5\uFF09\uFF1B\u6B63\u5728\u7F16\u8F91\u7684\u8F93\u5165\u6846\u8DDF\u968F\u6240\u5728\u5217\u7684\u5BF9\u9F50\uFF0C\u6570\u5B57\u5217\u70B9\u5F00\u7F16\u8F91\u65F6\u4E0D\u4F1A\u8DF3\u5230\u5DE6\u8FB9\u3002@author nokecy */\n    .ag-cell.qc-array-table-align-left { text-align: left; }\n    .ag-cell.qc-array-table-align-center { text-align: center; }\n    .ag-cell.qc-array-table-align-right { text-align: right; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-input-affix-wrapper .ant-input,\n    .ag-cell .ant-input.ant-input { text-align: inherit; }\n    .ag-header-cell.qc-array-table-required .ag-header-cell-text::before {\n      content: '*';\n      color: var(--ag-invalid-color);\n      margin-inline-end: 4px;\n    }\n    /* \u5355\u5C42\u6846\uFF1A\u683C\u5185\u63A7\u4EF6\u4E0D\u753B\u81EA\u5DF1\u7684\u8FB9\u6846/\u9634\u5F71/\u5E95\u8272\uFF0C\u6491\u6EE1\u5355\u5143\u683C\uFF1B\n       \u805A\u7126/\u9519\u8BEF/\u9501\u5B9A\u53EA\u7531\u5355\u5143\u683C\u7684 inset \u6846\uFF08\u6216\u5E95\u8272\uFF09\u8868\u8FBE\uFF0C\u4E0D\u5360\u5C3A\u5BF8\uFF0C\u884C\u9AD8\u4E0E\u5355\u5143\u683C\u5C3A\u5BF8\u4E0D\u53D8\u3002\n       \u9009\u62E9\u5668\u5168\u90E8\u9650\u5B9A\u5728 .ag-cell \u5185\uFF0C\u800C\u672C part \u53EA\u6302\u5728 ArrayTable \u7684\u4E3B\u9898\u4E0A\uFF0C\u4E0D\u5F71\u54CD\u8868\u683C\u5916\u7684\u8868\u5355\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker,\n    .ag-cell .ant-input-outlined.ant-input-outlined {\n      border: 0 !important;\n      box-shadow: none !important;\n      background: transparent !important;\n      outline: none;\n    }\n    .ag-cell .ant-input-number, .ag-cell .ant-picker, .ag-cell .ant-select, .ag-cell .ant-input-affix-wrapper { width: 100%; }\n    /* \u63A7\u4EF6\u300C\u50CF\u6587\u672C\u300D\uFF1A\u5B57\u53F7\u3001\u6C34\u5E73\u5185\u8FB9\u8DDD\u8DDF\u968F\u5BC6\u5EA6\uFF08\u5355\u5143\u683C\u81EA\u5DF1\u5DF2\u6709 --ag-cell-horizontal-padding\uFF0C\u63A7\u4EF6\u4E0D\u518D\u53E0\u4E00\u5C42\uFF09\uFF0C\n       \u9AD8\u5EA6\u968F\u884C\u9AD8\u3001\u7559 3px \u7ED9\u4E0B\u8FB9\u6846\u4E0E\u5C45\u4E2D\u4F59\u91CF\uFF0C\u4E0D\u6491\u9AD8\u884C\uFF1B\u5BC6\u5EA6\u7531\u4E3B\u9898\u53C2\u6570 rowHeight \u51B3\u5B9A\uFF0C\u4E0D\u5199\u6B7B\u50CF\u7D20\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { font-size: inherit !important; padding-inline: 0 !important; }\n    /* antd 6 \u7684 Select \u6839\u8282\u70B9\u81EA\u5DF1\u5E26\u8FB9\u6846\u4E0E\u5185\u8FB9\u8DDD\uFF08\u6CA1\u6709 .ant-select-selector\uFF09\uFF0C\u4E0A\u4E0B\u5185\u8FB9\u8DDD\u4E5F\u5F52\u96F6\uFF0C\u9AD8\u5EA6\u7531\u4E0B\u9762\u7684 height \u51B3\u5B9A\uFF0C\u5782\u76F4\u5C45\u4E2D\u3002*/\n    .ag-cell .ant-select.ant-select { padding-block: 0 !important; align-items: center; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-picker .ant-picker-input > input,\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { font-size: inherit !important; padding-inline: 0 !important; }\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; }\n    /* \u5957\u5728\u5916\u58F3\u91CC\u7684\u5185\u5C42\u63A7\u4EF6\u6491\u6EE1\u5916\u58F3\u5373\u53EF\uFF0C\u518D\u8BBE\u540C\u4E00\u9AD8\u5EA6\u4F1A\u52A0\u4E0A\u5916\u58F3 padding \u6EA2\u51FA\uFF1B\u591A\u884C\u6587\u672C\u57DF\u4E0D\u53D7\u9650\u3002*/\n    .ag-cell .ant-input-affix-wrapper .ant-input.ant-input,\n    .ag-cell .ant-input-number-affix-wrapper .ant-input-number-input { height: 100% !important; }\n    /* \u591A\u884C\u6587\u672C\u5728\u56FA\u5B9A\u884C\u9AD8\u7684\u683C\u91CC\u4E0D\u6491\u9AD8\u884C\uFF1A\u9AD8\u5EA6\u53D6\u5355\u884C\u9AD8\uFF0C\u8D85\u51FA\u5185\u5BB9\u5728\u6846\u5185\u6EDA\u52A8 */\n    .ag-cell textarea.ant-input.ant-input { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; resize: none; overflow-y: auto; line-height: calc(var(--ag-row-height) - 5px) !important; padding-block: 0 !important; }\n    /* Editable \u88C5\u9970\u5668\u5916\u58F3\u9ED8\u8BA4 inline-block\uFF0C\u4F1A\u5728 .ag-cell-value \u7684\u884C\u76D2\u91CC\u6309\u57FA\u7EBF\u5BF9\u9F50\u3001\u88AB\u9876\u504F\uFF1B\u6539\u4E3A\u5757\u7EA7 flex \u4E0E\u5176\u4ED6\u63A7\u4EF6\u4E00\u81F4\u5C45\u4E2D */\n    .ag-cell .ant-formily-editable { display: flex; align-items: center; width: 100%; }\n    /* Select \u6587\u5B57\u884C\u9AD8\u4E0E\u641C\u7D22\u6846\u4F4D\u7F6E\uFF1Aselector \u5F52\u96F6\u5185\u8FB9\u8DDD\u540E\uFF0C\u6587\u5B57\u884C\u9AD8\u53D6\u683C\u5185\u53EF\u7528\u9AD8\u5EA6\uFF0C\u641C\u7D22\u8F93\u5165\u6846\u8D34\u5DE6\uFF0C\u5149\u6807\u4E0D\u9519\u4F4D\u3002*/\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-placeholder,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { line-height: calc(var(--ag-row-height) - 3px) !important; }\n    .ag-cell .ant-select .ant-select-selection-search { inset-inline: 0 !important; }\n    /* \u6B65\u8FDB\u5668\u4E0E\u65E5\u5386\u56FE\u6807\u5728\u4EFB\u4F55\u72B6\u6001\u90FD\u4E0D\u663E\u793A\uFF08\u4E0E\u6F14\u793A\u4E00\u81F4\uFF1A\u952E\u76D8\u7528\u65B9\u5411\u952E/\u952E\u5165\uFF0C\u9762\u677F\u7531\u70B9\u51FB\u5C55\u5F00\uFF09\uFF1B\n       Input \u53EA\u4FDD\u7559\u6E05\u9664\u56FE\u6807\u3002\u4E0B\u62C9\u7BAD\u5934\u53EA\u5728\u805A\u7126\u6216\u9762\u677F\u5C55\u5F00\u65F6\u51FA\u73B0\u3002@author nokecy */\n    .ag-cell .ant-input-number-handler-wrap { display: none !important; }\n    .ag-cell .ant-picker .ant-picker-suffix { display: none !important; }\n    .ag-cell .ant-input-suffix > :not(.ant-input-clear-icon):not(.ant-input-show-count-suffix) { display: none !important; }\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-arrow,\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-suffix { display: none !important; }\n    /* \u672A\u805A\u7126\u4E14\u4E3A\u7A7A\uFF1A\u5F31\u5360\u4F4D\u4E0E\u666E\u901A\u7A7A\u683C\u4E00\u81F4\uFF0C\u53EA\u7528 placeholder \u8272\uFF0C\u4E0D\u753B\u8F93\u5165\u6846\u5916\u89C2\u3002@author nokecy */\n    .ag-cell .ant-select-selection-placeholder,\n    .ag-cell .ant-select-placeholder,\n    .ag-cell .ant-input::placeholder,\n    .ag-cell .ant-input-number-input::placeholder,\n    .ag-cell .ant-picker input::placeholder { color: var(--ant-color-text-placeholder, rgb(0 0 0 / 25%)) !important; }\n    /* \u5408\u8BA1\u884C\uFF1A\u56FA\u5B9A\u5728\u8868\u5C3E\uFF0C\u5B57\u91CD\u5F3A\u8C03\u3001\u4E0E\u660E\u7EC6\u884C\u4EE5\u4E0A\u8FB9\u7EBF\u5206\u5F00\u3002@author nokecy */\n    .ag-floating-bottom .ag-row { font-weight: 600; background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%)); }\n    .ag-cell:focus-within { box-shadow: inset 0 0 0 1px var(--ant-color-primary, #1f5fbf); }\n    .ag-cell:has(.ant-formily-item-error), .ag-cell:has(.ant-formily-item-error):focus-within {\n      box-shadow: inset 0 0 0 1px var(--ant-color-error, #d93025);\n    }\n    .ag-cell:has(.ant-input[disabled], .ant-input-disabled, .ant-input-number-disabled, .ant-select-disabled, .ant-picker-disabled) {\n      background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%));\n    }\n  ";
+export declare const arrayTableCellFit: import("ag-grid-community").Part<{}>;
+/** 根据当前 antd 主题与 Provider 密度生成编辑态或阅读态明细表格主题。@author nokecy */
+export declare function useArrayTableTheme(editable?: boolean): import("ag-grid-community").Theme<import("ag-grid-community").CoreParams & import("ag-grid-community").ButtonStyleParams & import("ag-grid-community").CheckboxStyleParams & import("ag-grid-community").TabStyleParams & import("ag-grid-community").InputStyleParams & {}>;

package/dist/cjs/array-table/theme.js

@@ -0,0 +1,94 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.arrayTableCellFit = exports.ARRAY_TABLE_ROW_HEIGHT = exports.ARRAY_TABLE_HELP_LINE_HEIGHT = exports.ARRAY_TABLE_FEEDBACK_CLASS = exports.ARRAY_TABLE_FALLBACK_DENSITY = exports.ARRAY_TABLE_CELL_FIT_CSS = void 0;
+exports.resolveArrayTableMetrics = resolveArrayTableMetrics;
+exports.useArrayTableMetrics = useArrayTableMetrics;
+exports.useArrayTableTheme = useArrayTableTheme;
+var _agGridCommunity = require("ag-grid-community");
+var _react = require("react");
+var _gridContext = require("../ag-grid-plus/context/gridContext");
+var _density = require("../ag-grid-plus/density");
+var _theme = require("../ag-grid-plus/theme");
+/**
+ * ArrayTable(明细表格)的 AG-Grid 主题:编辑态(index.tsx)与阅读态(preview.tsx)共用。
+ *
+ * @author nokecy
+ */
+
+/**
+ * Provider 没注入密度时的档位：DESIGN.md §2 把紧凑档定为 ERP 标准页默认。
+ * 原先写死 38，没有对应任何一档；回退到规范默认档，数值全部来自 density.ts。
+ */
+var ARRAY_TABLE_FALLBACK_DENSITY = exports.ARRAY_TABLE_FALLBACK_DENSITY = 'compact';
+
+/** 回退档的行高，兼容旧的具名导出；实际行高请用 useArrayTableMetrics。 */
+var ARRAY_TABLE_ROW_HEIGHT = exports.ARRAY_TABLE_ROW_HEIGHT = _density.GRID_DENSITY_PRESETS[ARRAY_TABLE_FALLBACK_DENSITY].rowHeight;
+
+/**
+ * 解析 ArrayTable 当前密度数值（纯函数，便于测试）。
+ * 网格选项 rowHeight/headerHeight 与主题参数必须同值——AG-Grid 单元格文字的行高
+ * (--ag-internal-content-line-height)是从主题的 --ag-row-height 算的，只设网格选项会让文字的行盒
+ * 仍是主题默认行高，顶在格子上方偏上。所以两处都从这一份数值取。
+ */
+function resolveArrayTableMetrics(density, overrides) {
+  var _resolveGridDensity;
+  return (_resolveGridDensity = (0, _density.resolveGridDensity)(density, overrides)) !== null && _resolveGridDensity !== void 0 ? _resolveGridDensity : _density.GRID_DENSITY_PRESETS[ARRAY_TABLE_FALLBACK_DENSITY];
+}
+
+/** 读取 Provider 注入的密度，随 Provider 变化重算（密度运行时切换后行高即时更新）。 */
+function useArrayTableMetrics() {
+  var _useContext = (0, _react.useContext)(_gridContext.GridPlusContext),
+    density = _useContext.density,
+    densityValues = _useContext.densityValues;
+  return (0, _react.useMemo)(function () {
+    return resolveArrayTableMetrics(density, densityValues);
+  }, [density, densityValues]);
+}
+
+/**
+ * 格内错误文字的总高度（含 terse 样式的 1px 边框，上下内边距与外边距归零，box-sizing: border-box）。
+ * 文字紧贴输入框下沿（top:100%），输入框高 = 行高 - 3px，所以格底到输入框底的距离是 ROW_FEEDBACK_EXTRA_HEIGHT + 3，
+ * 本值必须不超过它，否则会被行底边线穿过。
+ */
+var ARRAY_TABLE_HELP_LINE_HEIGHT = exports.ARRAY_TABLE_HELP_LINE_HEIGHT = 20;
+
+/** 表格里有出错行时挂在网格外层的类名(由 index.tsx 设置) */
+var ARRAY_TABLE_FEEDBACK_CLASS = exports.ARRAY_TABLE_FEEDBACK_CLASS = 'ag-array-table-has-feedback';
+
+/**
+ * 单元格里的表单项与内容区垂直居中(只对使用本主题的网格生效,共用主题不受影响):
+ *  - .ag-cell-wrapper 撑满格子,align-items:center 才起作用(默认只有内容高,贴在格子顶部);
+ *    表格里有出错行时(外层带 ARRAY_TABLE_FEEDBACK_CLASS)内容高度不超过标准行高对应的高度:出错行会被撑高(见 rowFeedback.ts),
+ *    内容仍居中在上面那一段,多出来的高度留给输入框下方的错误文字,出错时输入框不会被挤得上下跳;
+ *  - FormItem 默认 margin-bottom:24px(loose 反馈布局给错误文字预留的位置),会把 Editable 外壳撑到 56px、
+ *    输入框偏上、还超出 37px 的格子,归零;
+ *  - AG-Grid 的 .ag-cell-value 默认 overflow:hidden,会把输入框下方的错误文字剪掉,只在格里正显示错误文字时放开;
+ *  - 错误文字单行显示、超出列宽省略,出错行只多留一行的高度(ROW_FEEDBACK_EXTRA_HEIGHT);
+ *  - 错误提示文字移出文档流(位置仍在输入框下方),出错时输入框不会被挤得上下跳。
+ */
+var ARRAY_TABLE_CELL_FIT_CSS = exports.ARRAY_TABLE_CELL_FIT_CSS = "\n    .ag-cell .ag-cell-wrapper { height: 100%; max-height: 100%; min-height: 0; }\n    .ag-cell .ag-cell-value { max-height: 100%; min-height: 0; }\n    /* \u672C part \u7684 CSS \u4F1A\u88AB AG-Grid \u5305\u8FDB :where(.ag-theme-xxx) { ... }\uFF08\u5D4C\u5957\uFF09\uFF0C\u88F8\u5199 .has-feedback .ag-cell \u4F1A\u7F16\u8BD1\u6210\n       \u300C\u4E3B\u9898\u5143\u7D20\u7684\u540E\u4EE3 has-feedback\u300D\uFF0C\u800C\u8BE5\u7C7B\u6302\u5728\u4E3B\u9898\u5143\u7D20\u7684\u7956\u5148\u4E0A\uFF0C\u89C4\u5219\u6C38\u8FDC\u4E0D\u547D\u4E2D\u3002\n       \u6240\u4EE5\u7528 & \u663E\u5F0F\u653E\u5728 has-feedback \u4E4B\u540E\uFF08\u7956\u5148\u5199\u6CD5\uFF09\uFF0C\u540C\u65F6\u517C\u5BB9\u7C7B\u540D\u6302\u5728\u4E3B\u9898\u5143\u7D20\u81EA\u8EAB\u7684\u5199\u6CD5\u3002 */\n    .".concat(ARRAY_TABLE_FEEDBACK_CLASS, " & .ag-cell .ag-cell-wrapper,\n    &.").concat(ARRAY_TABLE_FEEDBACK_CLASS, " .ag-cell .ag-cell-wrapper { height: min(100%, calc(var(--ag-row-height) - 3px)); }\n    /* \u5BBF\u4E3B\u53EF\u80FD\u5199 .xxx .ant-formily-item { margin-bottom: 12px }\uFF08\u7279\u5F02\u6027 0,3,0\uFF09\uFF1B\u8FD9\u91CC\u53E0\u7C7B\u540D\u5E76 !important\uFF0C\u4EFB\u4F55\u5BBF\u4E3B\u89C4\u5219\u90FD\u538B\u4E0D\u8FC7\uFF0C\n       \u5426\u5219\u683C\u5185\u63A7\u4EF6\u4F1A\u88AB margin \u9876\u5F97\u504F\u4E0A 3-5px\u3002@author nokecy */\n    .ag-cell .ag-cell-wrapper .ant-formily-item.ant-formily-item { margin-bottom: 0 !important; }\n    /* \u6807\u9898\u548C\u8BF4\u660E\u7531\u5217\u5934\u627F\u8F7D\uFF0ClabelWidth:0 \u672C\u8EAB\u4E0D\u4F1A\u9690\u85CF\u5B57\u6BB5\u6807\u9898\u3002@author nokecy */\n    .ag-cell .ant-formily-item-label { display: none; }\n    .ag-cell .ant-formily-item-control { flex: 1; min-width: 0; width: 100%; }\n    /* \u5E26\u5916\u58F3\u7684\u8F93\u5165\u6846\uFF08affix/wrapper\uFF09\u662F inline-flex\uFF0Cantd \u7ED9\u8868\u5355\u9879\u5185\u5BB9\u533A controlHeight \u7684\u6700\u5C0F\u9AD8\u5EA6\u548C\u5BF9\u5E94\u884C\u9AD8\uFF0C\n       \u5916\u58F3\u6309\u57FA\u7EBF\u5BF9\u9F50\u88AB\u9876\u504F\u3002\u5185\u5BB9\u533A\u6539\u6210\u5C45\u4E2D\u7684 flex\uFF08\u5B50\u9879\u88AB\u5757\u5316\uFF0C\u4E0D\u518D\u6709\u57FA\u7EBF\u5BF9\u9F50\uFF09\uFF0C\u6700\u5C0F\u9AD8\u5EA6\u5F52\u96F6\uFF0C\n       \u8868\u5355\u9879\u9AD8\u5EA6\u7531\u63A7\u4EF6\u81EA\u5DF1\u7684\u9AD8\u5EA6\uFF08\u884C\u9AD8-3px\uFF09\u51B3\u5B9A\uFF0C\u4E0D\u8D85\u51FA\u884C\u9AD8\u3002 */\n    .ag-cell .ant-formily-item,\n    .ag-cell .ant-formily-item-control,\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { min-height: 0 !important; }\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { display: flex; align-items: center; }\n    .ag-cell .ant-formily-item-control-content-component { flex: 1 1 auto; min-width: 0; }\n    .ag-cell .ant-formily-item-control-content-component > * { flex: 1 1 auto; min-width: 0; }\n    /* \u9519\u8BEF\u6587\u5B57\u9489\u5728\u8F93\u5165\u6846\u6B63\u4E0B\u65B9\uFF08top:100% \u76F8\u5BF9 .ant-formily-item\uFF09\uFF0C\u9AD8\u5EA6\u56FA\u5B9A\u4E3A ARRAY_TABLE_HELP_LINE_HEIGHT\uFF0C\n       \u4E0D\u518D\u4F9D\u8D56\u6587\u6863\u6D41\u91CC\u7684\u9759\u6001\u4F4D\u7F6E\uFF08\u4F1A\u968F margin/\u5C45\u4E2D\u504F\u79FB\uFF0C\u5BFC\u81F4\u88AB\u884C\u5E95\u8FB9\u7EBF\u7A7F\u8FC7\uFF09\u3002 */\n    .ag-cell .ant-formily-item-help { position: absolute; top: 100%; inset-inline-start: 0; margin: 0 !important; padding-block: 0 !important; box-sizing: border-box !important; min-height: 0 !important; height: ").concat(ARRAY_TABLE_HELP_LINE_HEIGHT, "px !important; line-height: ").concat(ARRAY_TABLE_HELP_LINE_HEIGHT - 2, "px !important; max-width: 100%; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n    .ag-cell .ag-cell-value:has(.ant-formily-item-help) { overflow: visible; }\n    /* \u5217\u5BF9\u9F50\uFF08align \u5199\u6CD5\uFF09\uFF1B\u6B63\u5728\u7F16\u8F91\u7684\u8F93\u5165\u6846\u8DDF\u968F\u6240\u5728\u5217\u7684\u5BF9\u9F50\uFF0C\u6570\u5B57\u5217\u70B9\u5F00\u7F16\u8F91\u65F6\u4E0D\u4F1A\u8DF3\u5230\u5DE6\u8FB9\u3002@author nokecy */\n    .ag-cell.qc-array-table-align-left { text-align: left; }\n    .ag-cell.qc-array-table-align-center { text-align: center; }\n    .ag-cell.qc-array-table-align-right { text-align: right; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-input-affix-wrapper .ant-input,\n    .ag-cell .ant-input.ant-input { text-align: inherit; }\n    .ag-header-cell.qc-array-table-required .ag-header-cell-text::before {\n      content: '*';\n      color: var(--ag-invalid-color);\n      margin-inline-end: 4px;\n    }\n    /* \u5355\u5C42\u6846\uFF1A\u683C\u5185\u63A7\u4EF6\u4E0D\u753B\u81EA\u5DF1\u7684\u8FB9\u6846/\u9634\u5F71/\u5E95\u8272\uFF0C\u6491\u6EE1\u5355\u5143\u683C\uFF1B\n       \u805A\u7126/\u9519\u8BEF/\u9501\u5B9A\u53EA\u7531\u5355\u5143\u683C\u7684 inset \u6846\uFF08\u6216\u5E95\u8272\uFF09\u8868\u8FBE\uFF0C\u4E0D\u5360\u5C3A\u5BF8\uFF0C\u884C\u9AD8\u4E0E\u5355\u5143\u683C\u5C3A\u5BF8\u4E0D\u53D8\u3002\n       \u9009\u62E9\u5668\u5168\u90E8\u9650\u5B9A\u5728 .ag-cell \u5185\uFF0C\u800C\u672C part \u53EA\u6302\u5728 ArrayTable \u7684\u4E3B\u9898\u4E0A\uFF0C\u4E0D\u5F71\u54CD\u8868\u683C\u5916\u7684\u8868\u5355\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker,\n    .ag-cell .ant-input-outlined.ant-input-outlined {\n      border: 0 !important;\n      box-shadow: none !important;\n      background: transparent !important;\n      outline: none;\n    }\n    .ag-cell .ant-input-number, .ag-cell .ant-picker, .ag-cell .ant-select, .ag-cell .ant-input-affix-wrapper { width: 100%; }\n    /* \u63A7\u4EF6\u300C\u50CF\u6587\u672C\u300D\uFF1A\u5B57\u53F7\u3001\u6C34\u5E73\u5185\u8FB9\u8DDD\u8DDF\u968F\u5BC6\u5EA6\uFF08\u5355\u5143\u683C\u81EA\u5DF1\u5DF2\u6709 --ag-cell-horizontal-padding\uFF0C\u63A7\u4EF6\u4E0D\u518D\u53E0\u4E00\u5C42\uFF09\uFF0C\n       \u9AD8\u5EA6\u968F\u884C\u9AD8\u3001\u7559 3px \u7ED9\u4E0B\u8FB9\u6846\u4E0E\u5C45\u4E2D\u4F59\u91CF\uFF0C\u4E0D\u6491\u9AD8\u884C\uFF1B\u5BC6\u5EA6\u7531\u4E3B\u9898\u53C2\u6570 rowHeight \u51B3\u5B9A\uFF0C\u4E0D\u5199\u6B7B\u50CF\u7D20\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { font-size: inherit !important; padding-inline: 0 !important; }\n    /* antd 6 \u7684 Select \u6839\u8282\u70B9\u81EA\u5DF1\u5E26\u8FB9\u6846\u4E0E\u5185\u8FB9\u8DDD\uFF08\u6CA1\u6709 .ant-select-selector\uFF09\uFF0C\u4E0A\u4E0B\u5185\u8FB9\u8DDD\u4E5F\u5F52\u96F6\uFF0C\u9AD8\u5EA6\u7531\u4E0B\u9762\u7684 height \u51B3\u5B9A\uFF0C\u5782\u76F4\u5C45\u4E2D\u3002*/\n    .ag-cell .ant-select.ant-select { padding-block: 0 !important; align-items: center; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-picker .ant-picker-input > input,\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { font-size: inherit !important; padding-inline: 0 !important; }\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; }\n    /* \u5957\u5728\u5916\u58F3\u91CC\u7684\u5185\u5C42\u63A7\u4EF6\u6491\u6EE1\u5916\u58F3\u5373\u53EF\uFF0C\u518D\u8BBE\u540C\u4E00\u9AD8\u5EA6\u4F1A\u52A0\u4E0A\u5916\u58F3 padding \u6EA2\u51FA\uFF1B\u591A\u884C\u6587\u672C\u57DF\u4E0D\u53D7\u9650\u3002*/\n    .ag-cell .ant-input-affix-wrapper .ant-input.ant-input,\n    .ag-cell .ant-input-number-affix-wrapper .ant-input-number-input { height: 100% !important; }\n    /* \u591A\u884C\u6587\u672C\u5728\u56FA\u5B9A\u884C\u9AD8\u7684\u683C\u91CC\u4E0D\u6491\u9AD8\u884C\uFF1A\u9AD8\u5EA6\u53D6\u5355\u884C\u9AD8\uFF0C\u8D85\u51FA\u5185\u5BB9\u5728\u6846\u5185\u6EDA\u52A8 */\n    .ag-cell textarea.ant-input.ant-input { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; resize: none; overflow-y: auto; line-height: calc(var(--ag-row-height) - 5px) !important; padding-block: 0 !important; }\n    /* Editable \u88C5\u9970\u5668\u5916\u58F3\u9ED8\u8BA4 inline-block\uFF0C\u4F1A\u5728 .ag-cell-value \u7684\u884C\u76D2\u91CC\u6309\u57FA\u7EBF\u5BF9\u9F50\u3001\u88AB\u9876\u504F\uFF1B\u6539\u4E3A\u5757\u7EA7 flex \u4E0E\u5176\u4ED6\u63A7\u4EF6\u4E00\u81F4\u5C45\u4E2D */\n    .ag-cell .ant-formily-editable { display: flex; align-items: center; width: 100%; }\n    /* Select \u6587\u5B57\u884C\u9AD8\u4E0E\u641C\u7D22\u6846\u4F4D\u7F6E\uFF1Aselector \u5F52\u96F6\u5185\u8FB9\u8DDD\u540E\uFF0C\u6587\u5B57\u884C\u9AD8\u53D6\u683C\u5185\u53EF\u7528\u9AD8\u5EA6\uFF0C\u641C\u7D22\u8F93\u5165\u6846\u8D34\u5DE6\uFF0C\u5149\u6807\u4E0D\u9519\u4F4D\u3002*/\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-placeholder,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { line-height: calc(var(--ag-row-height) - 3px) !important; }\n    .ag-cell .ant-select .ant-select-selection-search { inset-inline: 0 !important; }\n    /* \u6B65\u8FDB\u5668\u4E0E\u65E5\u5386\u56FE\u6807\u5728\u4EFB\u4F55\u72B6\u6001\u90FD\u4E0D\u663E\u793A\uFF08\u4E0E\u6F14\u793A\u4E00\u81F4\uFF1A\u952E\u76D8\u7528\u65B9\u5411\u952E/\u952E\u5165\uFF0C\u9762\u677F\u7531\u70B9\u51FB\u5C55\u5F00\uFF09\uFF1B\n       Input \u53EA\u4FDD\u7559\u6E05\u9664\u56FE\u6807\u3002\u4E0B\u62C9\u7BAD\u5934\u53EA\u5728\u805A\u7126\u6216\u9762\u677F\u5C55\u5F00\u65F6\u51FA\u73B0\u3002@author nokecy */\n    .ag-cell .ant-input-number-handler-wrap { display: none !important; }\n    .ag-cell .ant-picker .ant-picker-suffix { display: none !important; }\n    .ag-cell .ant-input-suffix > :not(.ant-input-clear-icon):not(.ant-input-show-count-suffix) { display: none !important; }\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-arrow,\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-suffix { display: none !important; }\n    /* \u672A\u805A\u7126\u4E14\u4E3A\u7A7A\uFF1A\u5F31\u5360\u4F4D\u4E0E\u666E\u901A\u7A7A\u683C\u4E00\u81F4\uFF0C\u53EA\u7528 placeholder \u8272\uFF0C\u4E0D\u753B\u8F93\u5165\u6846\u5916\u89C2\u3002@author nokecy */\n    .ag-cell .ant-select-selection-placeholder,\n    .ag-cell .ant-select-placeholder,\n    .ag-cell .ant-input::placeholder,\n    .ag-cell .ant-input-number-input::placeholder,\n    .ag-cell .ant-picker input::placeholder { color: var(--ant-color-text-placeholder, rgb(0 0 0 / 25%)) !important; }\n    /* \u5408\u8BA1\u884C\uFF1A\u56FA\u5B9A\u5728\u8868\u5C3E\uFF0C\u5B57\u91CD\u5F3A\u8C03\u3001\u4E0E\u660E\u7EC6\u884C\u4EE5\u4E0A\u8FB9\u7EBF\u5206\u5F00\u3002@author nokecy */\n    .ag-floating-bottom .ag-row { font-weight: 600; background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%)); }\n    .ag-cell:focus-within { box-shadow: inset 0 0 0 1px var(--ant-color-primary, #1f5fbf); }\n    .ag-cell:has(.ant-formily-item-error), .ag-cell:has(.ant-formily-item-error):focus-within {\n      box-shadow: inset 0 0 0 1px var(--ant-color-error, #d93025);\n    }\n    .ag-cell:has(.ant-input[disabled], .ant-input-disabled, .ant-input-number-disabled, .ant-select-disabled, .ant-picker-disabled) {\n      background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%));\n    }\n  ");
+var arrayTableCellFit = exports.arrayTableCellFit = (0, _agGridCommunity.createPart)({
+  feature: 'arrayTableCellFit',
+  css: ARRAY_TABLE_CELL_FIT_CSS
+});
+
+/** 根据当前 antd 主题与 Provider 密度生成编辑态或阅读态明细表格主题。@author nokecy */
+function useArrayTableTheme() {
+  var editable = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
+  var metrics = useArrayTableMetrics();
+  // 叠加而非替换：useAgGridTheme 把密度的字号/行高/表头高/水平内边距写进主题，随后只追加本表格的部件。
+  var agGridTheme = (0, _theme.useAgGridTheme)({
+    density: metrics
+  });
+  return (0, _react.useMemo)(function () {
+    var previewTheme = agGridTheme.withPart(arrayTableCellFit);
+    return editable ? previewTheme.withParams({
+      focusShadow: 'none',
+      rangeSelectionBorderColor: 'transparent',
+      rangeSelectionBackgroundColor: 'transparent'
+    }) : previewTheme;
+  }, [agGridTheme, editable]);
+}

package/dist/cjs/array-table/title.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+/** 明细表格的区域标题：左侧 3px 主色竖条 + 加粗文字（DESIGN.md §5.2 次级工具栏） */
+export declare const ArrayTableTitle: React.FC<React.PropsWithChildren>;

package/dist/cjs/array-table/title.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ArrayTableTitle = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/** 明细表格的区域标题：左侧 3px 主色竖条 + 加粗文字（DESIGN.md §5.2 次级工具栏） */
+var ArrayTableTitle = exports.ArrayTableTitle = function ArrayTableTitle(_ref) {
+  var children = _ref.children;
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("span", {
+    style: {
+      display: 'inline-flex',
+      alignItems: 'center',
+      gap: 8,
+      fontWeight: 600
+    },
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+      style: {
+        width: 3,
+        height: 14,
+        background: 'var(--ind-primary, var(--ant-color-primary))',
+        borderRadius: 1
+      }
+    }), children]
+  });
+};