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

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

@@ -0,0 +1,196 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isStatusKey = exports.StatusPill = exports.STATUS_PILL_DARK = exports.STATUS_PILL = void 0;
+var _react = _interopRequireDefault(require("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); } /**
+ * `valueEnum` 的状态胶囊：形状 + 文字 + 底色三重编码，去掉颜色后仍可凭形状与文字区分。
+ *
+ * 状态语义色属于语义层，不随主题变化，所以色值写在这里；
+ * 文字色对底色 ≥ 4.5:1，图标色对底色 ≥ 3:1。
+ */
+var STATUS_PILL = exports.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 */
+var STATUS_PILL_DARK = exports.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'
+  }
+};
+var isStatusKey = exports.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__*/(0, _jsxRuntime.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__*/(0, _jsxRuntime.jsx)("circle", _objectSpread({
+      cx: "6",
+      cy: "6",
+      r: "4.25"
+    }, common)), icon === 'half' && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("circle", _objectSpread({
+        cx: "6",
+        cy: "6",
+        r: "4.25"
+      }, common)), /*#__PURE__*/(0, _jsxRuntime.jsx)("path", {
+        d: "M6 1.75 A4.25 4.25 0 0 1 6 10.25 Z",
+        fill: color,
+        stroke: "none"
+      })]
+    }), icon === 'check' && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("circle", _objectSpread({
+        cx: "6",
+        cy: "6",
+        r: "4.25"
+      }, common)), /*#__PURE__*/(0, _jsxRuntime.jsx)("path", _objectSpread({
+        d: "M3.9 6.2 5.3 7.6 8.2 4.5"
+      }, common))]
+    }), icon === 'warn' && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("path", _objectSpread({
+        d: "M6 1.6 10.8 10 1.2 10Z"
+      }, common)), /*#__PURE__*/(0, _jsxRuntime.jsx)("path", _objectSpread({
+        d: "M6 4.6V7M6 8.5V8.6"
+      }, common))]
+    }), icon === 'cross' && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("circle", _objectSpread({
+        cx: "6",
+        cy: "6",
+        r: "4.25"
+      }, common)), /*#__PURE__*/(0, _jsxRuntime.jsx)("path", _objectSpread({
+        d: "M4.3 4.3 7.7 7.7M7.7 4.3 4.3 7.7"
+      }, common))]
+    }), icon === 'dash' && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("circle", _objectSpread({
+        cx: "6",
+        cy: "6",
+        r: "4.25"
+      }, common)), /*#__PURE__*/(0, _jsxRuntime.jsx)("path", _objectSpread({
+        d: "M4 6H8"
+      }, common))]
+    })]
+  });
+};
+
+/** 表格单元格内的状态胶囊，高 18px，适配紧凑行高 */
+var StatusPill = exports.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__*/(0, _jsxRuntime.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__*/(0, _jsxRuntime.jsx)(Glyph, {
+      icon: s.icon,
+      color: s.mark
+    }), children]
+  });
+};

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

@@ -1,7 +1,12 @@
 /** antd Tag 语义档名。 */
 export type SemanticPreset = 'default' | 'processing' | 'success' | 'warning' | 'error';
-/** 语义档名 → 表格文字色（白底实测 ≥4.5:1）。 */
+/**
+ * 语义档名 → 表格文字色，取状态胶囊六态的文字色（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 色。
  *

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

@@ -3,7 +3,8 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.toGridTextColor = exports.semanticTextColors = exports.gridValueEnum = void 0;
+exports.toGridTextColor = exports.semanticTextColors = exports.isDarkSurface = exports.gridValueEnum = void 0;
+var _statusPill = require("./statusPill");
 var _contrast = require("../../shared/contrast");
 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; }
@@ -30,13 +31,16 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 
 var WHITE = '#ffffff';
 
-/** 语义档名 → 表格文字色（白底实测 ≥4.5:1）。 */
+/**
+ * 语义档名 → 表格文字色，取状态胶囊六态的文字色（statusPill.ts，对各自底色 ≥4.5:1，白底同样达标），
+ * 没配 `status` 的枚举与配了 `status` 的列在同一页上色值一致（DESIGN.md §3.2）。
+ */
 var semanticTextColors = exports.semanticTextColors = {
-  default: '#595959',
-  processing: '#0958d9',
-  success: '#237804',
-  warning: '#ad4e00',
-  error: '#cf1322'
+  default: _statusPill.STATUS_PILL.wait.fg,
+  processing: _statusPill.STATUS_PILL.running.fg,
+  success: _statusPill.STATUS_PILL.done.fg,
+  warning: _statusPill.STATUS_PILL.warning.fg,
+  error: _statusPill.STATUS_PILL.alarm.fg
 };
 
 /** antd Tag 预设名 / 常见 CSS 色名 → 起始 hex，再交给对比度压色。 */
@@ -66,8 +70,8 @@ var parseHex = function parseHex(color) {
 };
 
 /** 底色是否为深色表面。 */
-var isDarkSurface = function isDarkSurface(background) {
-  return (0, _contrast.relativeLuminance)(background) < 0.18;
+var isDarkSurface = exports.isDarkSurface = function isDarkSurface(background) {
+  return !!background && !!parseHex(background) && (0, _contrast.relativeLuminance)(background) < 0.18;
 };
 
 /**

package/dist/cjs/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/cjs/ag-grid-plus/utils/valueFormat.js

@@ -0,0 +1,73 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EMPTY_PLACEHOLDER = void 0;
+exports.formatEmpty = formatEmpty;
+exports.formatThousands = formatThousands;
+exports.isEmptyValue = void 0;
+exports.withDefaultValueFormat = withDefaultValueFormat;
+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
+ */
+
+var EMPTY_PLACEHOLDER = exports.EMPTY_PLACEHOLDER = '—';
+var PLAIN_NUMBER = /^(-?)(\d+)(\.\d+)?$/;
+
+/** 空值统一为 `—`；0 是有效值，原样保留。 */
+var isEmptyValue = exports.isEmptyValue = function isEmptyValue(value) {
+  return value === null || value === undefined || value === '';
+};
+
+/**
+ * 千分位，只动整数部分，小数位原样保留（字符串数值不经过浮点，不丢精度）。
+ * 不是纯数字的值（科学计数法、带单位的文本）原样返回。
+ */
+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$ : '');
+}
+
+/** 只补空值占位。 */
+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 该列由首行数据推断为数值
+ */
+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/cjs/ag-grid-plus/utils.js

@@ -204,10 +204,11 @@ var convertSortModel = exports.convertSortModel = function convertSortModel(sort
   return sorter;
 };
 var dateValueFormatter = exports.dateValueFormatter = function dateValueFormatter(params) {
-  return params.value ? (0, _dayjs.default)(params.value).format("YYYY-MM-DD") : "";
+  return params.value ? (0, _dayjs.default)(params.value).format("YYYY-MM-DD") : "—";
 };
 var dateTimeValueFormatter = exports.dateTimeValueFormatter = function dateTimeValueFormatter(params) {
-  return params.value ? (0, _dayjs.default)(params.value).format("YYYY-MM-DD HH:mm:ss") : "";
+  // 列表到分钟，日志与审计到秒由页面自己传 valueFormatter（DESIGN.md §7.7）
+  return params.value ? (0, _dayjs.default)(params.value).format("YYYY-MM-DD HH:mm") : "—";
 };
 
 //@ts-ignore

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

@@ -1,3 +1,4 @@
 import React from "react";
+export declare const getDefaultValue: (defaultValue: any, schema: any) => any;
 declare const ArrayAddBtn: (props: any) => React.JSX.Element | null;
 export default ArrayAddBtn;

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

@@ -4,7 +4,7 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = void 0;
+exports.getDefaultValue = exports.default = void 0;
 var _react = _interopRequireDefault(require("react"));
 var _formilyReact = require("@nokecy/formily-react");
 var _antd = require("antd");
@@ -32,7 +32,7 @@ var getSchemaDefaultValue = function getSchemaDefaultValue(schema) {
     }
   }
 };
-var getDefaultValue = function getDefaultValue(defaultValue, schema) {
+var getDefaultValue = exports.getDefaultValue = function getDefaultValue(defaultValue, schema) {
   if ((0, _formilyShared.isValid)(defaultValue)) return (0, _formilyShared.clone)(defaultValue);
   if (Array.isArray(schema === null || schema === void 0 ? void 0 : schema.items)) return getSchemaDefaultValue(schema === null || schema === void 0 ? void 0 : schema.items[0]);
   return getSchemaDefaultValue(schema === null || schema === void 0 ? void 0 : schema.items);

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

@@ -0,0 +1,18 @@
+/** height="auto" 时明细区最多显示的行数，超出后表格内部滚动 */
+export declare const ARRAY_TABLE_AUTO_MAX_ROWS = 10;
+export interface AutoHeightInput {
+    rowCount: number;
+    rowHeight: number;
+    headerHeight: number;
+    /** 合计行（固定在底部，占一行高度） */
+    hasSummary?: boolean;
+    /** 带行内错误文字、被撑高的行数 */
+    feedbackRows?: number;
+    minRows?: number;
+    maxRows?: number;
+}
+/**
+ * height="auto"：按行数算出网格高度，免得空表留大片空白、行少时不必手算像素。
+ * AG Grid 的 domLayout=autoHeight 会让合计行与滚动行为失效，这里改为按密度三档的行高直接计算。
+ */
+export declare const calcAutoGridHeight: ({ rowCount, rowHeight, headerHeight, hasSummary, feedbackRows, minRows, maxRows, }: AutoHeightInput) => number;

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

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.calcAutoGridHeight = exports.ARRAY_TABLE_AUTO_MAX_ROWS = void 0;
+var _rowFeedback = require("./rowFeedback");
+/** height="auto" 时明细区最多显示的行数，超出后表格内部滚动 */
+var ARRAY_TABLE_AUTO_MAX_ROWS = exports.ARRAY_TABLE_AUTO_MAX_ROWS = 10;
+
+/** 表格外框上下各 1px 边线 */
+var BORDER = 2;
+/**
+ * height="auto"：按行数算出网格高度，免得空表留大片空白、行少时不必手算像素。
+ * AG Grid 的 domLayout=autoHeight 会让合计行与滚动行为失效，这里改为按密度三档的行高直接计算。
+ */
+var calcAutoGridHeight = exports.calcAutoGridHeight = function calcAutoGridHeight(_ref) {
+  var rowCount = _ref.rowCount,
+    rowHeight = _ref.rowHeight,
+    headerHeight = _ref.headerHeight,
+    hasSummary = _ref.hasSummary,
+    _ref$feedbackRows = _ref.feedbackRows,
+    feedbackRows = _ref$feedbackRows === void 0 ? 0 : _ref$feedbackRows,
+    _ref$minRows = _ref.minRows,
+    minRows = _ref$minRows === void 0 ? 1 : _ref$minRows,
+    _ref$maxRows = _ref.maxRows,
+    maxRows = _ref$maxRows === void 0 ? ARRAY_TABLE_AUTO_MAX_ROWS : _ref$maxRows;
+  var rows = Math.min(Math.max(rowCount, minRows), Math.max(maxRows, minRows));
+  return headerHeight + rows * rowHeight + (hasSummary ? rowHeight : 0) + Math.min(feedbackRows, rows) * _rowFeedback.ROW_FEEDBACK_EXTRA_HEIGHT + BORDER;
+};

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

@@ -22,11 +22,11 @@ export declare function findRemovalAction(field: ArrayField, index: number, acti
 export declare function removeSelectedRows(field: ArrayField, ids: string[], actions: RemovalAction[], getId: (row: any) => string, onRemove?: (index: number) => void, event?: React.MouseEvent): boolean;
 /** 公共明细表格的勾选及批量删除，沿用业务行权限、行标识与删除通知。@author nokecy */
 export declare function useArrayTableBatchRemove(field: ArrayField, sources: ObservableColumnSource[], props: ArrayTableProps, apiRef: React.MutableRefObject<GridApi | undefined>, getId: (row: any) => string): {
-    rowSelection: "multiple" | "single" | import("ag-grid-community/dist/types/src/entities/gridOptions").SingleRowSelectionOptions<any, any> | import("ag-grid-community/dist/types/src/entities/gridOptions").MultiRowSelectionOptions<any, any> | {
+    rowSelection: "single" | "multiple" | import("ag-grid-community/dist/types/src/entities/gridOptions").SingleRowSelectionOptions<any, any> | import("ag-grid-community/dist/types/src/entities/gridOptions").MultiRowSelectionOptions<any, any> | {
         isRowSelectable: (node: IRowNode) => boolean;
         headerCheckbox?: boolean | undefined;
         selectAll?: "filtered" | undefined;
-        mode: "singleRow" | "multiRow";
+        mode: "multiRow" | "singleRow";
         checkboxes: boolean;
         enableClickSelection: boolean;
     } | undefined;

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

@@ -0,0 +1,18 @@
+import React from 'react';
+/** 格内控件的稳定标记值，键盘与浏览器测试按它定位，不依赖 antd 的内部类名。 */
+export type CellEditorKind = 'select' | 'date' | 'number' | 'text';
+/** 按 x-component 判定控件类别；开关、业务自定义组件等不在表内，不打标记（避免误导）。 */
+export declare const resolveCellEditorKind: (component: unknown) => CellEditorKind | undefined;
+/**
+ * 面板是否展开：下拉看 antd 的 open 类；日期面板挂在 body 下，只能「控件聚焦且存在可见面板」近似判断。
+ * 直接读 DOM 而不进 React 状态，避免每次开合让整格重渲。
+ */
+export declare const isCellEditorOpen: (root: Element, kind: CellEditorKind) => boolean;
+/**
+ * 给格内控件加 data-array-cell-editor / data-open 标记。display:contents 不产生盒子，不改变格内布局。
+ * 没有类别（不认识的组件）时原样返回子节点。@author nokecy
+ */
+export declare const CellEditorMarker: ({ kind, children }: {
+    kind?: CellEditorKind | undefined;
+    children: React.ReactNode;
+}) => React.JSX.Element;

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

@@ -0,0 +1,92 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.resolveCellEditorKind = exports.isCellEditorOpen = exports.CellEditorMarker = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+/** 格内控件的稳定标记值，键盘与浏览器测试按它定位，不依赖 antd 的内部类名。 */
+
+var KIND_BY_COMPONENT = {
+  Select: 'select',
+  TreeSelect: 'select',
+  Cascader: 'select',
+  DatePicker: 'date',
+  'DatePicker.RangePicker': 'date',
+  TimePicker: 'date',
+  'TimePicker.RangePicker': 'date',
+  InputNumber: 'number',
+  NumberPicker: 'number',
+  Input: 'text',
+  'Input.TextArea': 'text',
+  Password: 'text'
+};
+
+/** 按 x-component 判定控件类别；开关、业务自定义组件等不在表内，不打标记（避免误导）。 */
+var resolveCellEditorKind = exports.resolveCellEditorKind = function resolveCellEditorKind(component) {
+  return typeof component === 'string' ? KIND_BY_COMPONENT[component] : undefined;
+};
+
+/**
+ * 面板是否展开：下拉看 antd 的 open 类；日期面板挂在 body 下，只能「控件聚焦且存在可见面板」近似判断。
+ * 直接读 DOM 而不进 React 状态，避免每次开合让整格重渲。
+ */
+var isCellEditorOpen = exports.isCellEditorOpen = function isCellEditorOpen(root, kind) {
+  if (kind === 'select') return !!root.querySelector('.ant-select-open');
+  if (kind === 'date') {
+    return !!root.querySelector('.ant-picker-focused') && !!document.querySelector('.ant-picker-dropdown:not(.ant-picker-dropdown-hidden)');
+  }
+  return false;
+};
+
+/**
+ * 给格内控件加 data-array-cell-editor / data-open 标记。display:contents 不产生盒子，不改变格内布局。
+ * 没有类别（不认识的组件）时原样返回子节点。@author nokecy
+ */
+var CellEditorMarker = exports.CellEditorMarker = function CellEditorMarker(_ref) {
+  var kind = _ref.kind,
+    children = _ref.children;
+  var ref = (0, _react.useRef)(null);
+  (0, _react.useEffect)(function () {
+    var root = ref.current;
+    if (!root || !kind || kind !== 'select' && kind !== 'date') return;
+    var sync = function sync() {
+      if (isCellEditorOpen(root, kind)) root.setAttribute('data-open', '1');else root.removeAttribute('data-open');
+    };
+    // 弹层开合发生在 antd 内部，类名变化与聚焦/点击/按键之后下一拍再读一次。
+    var later = function later() {
+      window.setTimeout(sync, 0);
+    };
+    var observer = new MutationObserver(sync);
+    observer.observe(root, {
+      subtree: true,
+      attributes: true,
+      attributeFilter: ['class']
+    });
+    var events = ['focusin', 'focusout', 'click', 'keyup'];
+    events.forEach(function (name) {
+      return root.addEventListener(name, later);
+    });
+    return function () {
+      observer.disconnect();
+      events.forEach(function (name) {
+        return root.removeEventListener(name, later);
+      });
+    };
+  }, [kind]);
+  if (!kind) return /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
+    children: children
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+    ref: ref,
+    "data-array-cell-editor": kind,
+    style: {
+      display: 'contents'
+    },
+    children: children
+  });
+};

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

@@ -0,0 +1,29 @@
+import type { GridApi } from 'ag-grid-community';
+import type { ErrorLocator } from '@nokecy/formily-antd';
+/** ArrayTable 的一列：AG-Grid 列 id 与它承载的内层数据字段名（Column key 与字段名可能不同，如设计器形态）。 */
+export type ErrorLocatorColumn = {
+    colId: string;
+    dataName?: string;
+    title?: string;
+};
+type Deps = {
+    field: any;
+    getContainer: () => HTMLElement | null | undefined;
+    getApi: () => GridApi | undefined;
+    getColumns: () => ErrorLocatorColumn[];
+    /** 行数据 -> AG-Grid 行 id（与 getRowId 同一套） */
+    getRowId: (row: any) => string;
+    focus: (params: {
+        rowIndex: number;
+        colId: string;
+    }) => Promise<HTMLElement | undefined>;
+};
+/**
+ * 提交校验失败时 ArrayTable 的错误定位器（注册到 adapters 的 form-error-focus，见 registerErrorLocator）。
+ *
+ * 错误格可能不在 DOM 里（行被虚拟化、懒挂载格卸回了文本），按 DOM 找不到，所以按 Formily 的错误列表定位：
+ * 取表内最靠前的（先行后列，行按当前显示顺序、列按当前列序），ensureIndexVisible / ensureColumnVisible 滚到位，
+ * 再激活该格并聚焦输入。@author nokecy
+ */
+export declare const createArrayTableErrorLocator: (deps: Deps) => ErrorLocator;
+export {};