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

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

@@ -0,0 +1,41 @@
+"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.withColumnAlign = withColumnAlign;
+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 _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; }
+/** 明细列对齐：沿用 antd Table 的 `align` 写法。@author nokecy */
+
+var appendClass = function appendClass(original, extra) {
+  var merge = function merge(classes) {
+    return Array.from(new Set([].concat(_toConsumableArray(Array.isArray(classes) ? classes : classes ? [classes] : []), [extra])));
+  };
+  return typeof original === 'function' ? function (params) {
+    return merge(original(params));
+  } : merge(original);
+};
+
+/**
+ * 按列上的 `align` 补单元格与列头的对齐类名；没写或写错时原样返回。
+ * 对齐样式见 theme.ts（单元格里正在编辑的输入框同样跟随列对齐）。
+ */
+function withColumnAlign(column, align) {
+  if (align !== 'left' && align !== 'center' && align !== 'right') return column;
+  return _objectSpread(_objectSpread({}, column), {}, {
+    cellClass: appendClass(column.cellClass, "qc-array-table-align-".concat(align))
+  }, align === 'right' ? {
+    headerClass: appendClass(column.headerClass, 'ag-right-aligned-header')
+  } : {});
+}

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

@@ -0,0 +1,39 @@
+/**
+ * ArrayTable 分组表头(多级表头)。
+ *
+ * 背景:schema 里的每个 ArrayTable.Column 被抽成「扁平」列定义(buildArrayTableColumns),
+ * 内部一批逻辑(懒挂载列识别、列方案还原、首列拖拽等)都按扁平列取值,不能改。
+ * 所以分组只在「交给 AG-Grid 的那一份 columnDefs」上做:
+ *  1. buildArrayTableColumns 生成列定义时,用 markHeaderGroup 把列声明的 headerGroup 记下来;
+ *  2. index.tsx 把扁平列定义交给 groupColumnDefs,得到含列组的 columnDefs 传给 AgGridReact。
+ *
+ * 分组名记在模块内的 WeakMap 里,不往 colDef 上塞自定义字段——AG-Grid 会把未知属性当作错误告警。
+ *
+ * 只支持一级分组;分组名相同但不相邻的列各自成组。
+ *
+ * @author nokecy
+ */
+import type { ColDef, ColGroupDef } from 'ag-grid-community';
+/**
+ * 记下列定义所属的表头分组。
+ * headerGroup 不是非空字符串(没声明、空串、纯空白)时不做任何事,该列按无分组处理。
+ * 返回传入的 colDef 本身,方便链式使用。
+ */
+export declare const markHeaderGroup: <T extends object>(colDef: T, headerGroup: unknown) => T;
+/**
+ * 把扁平列定义按「相邻且 headerGroup 相同」合并成 AG-Grid 列组。
+ *
+ *  - 相邻同名的列 -> 一个 { headerName, groupId, children } 列组;
+ *  - 同名但被别的列隔开 -> 各自成组,groupId 各不相同;
+ *  - 没声明分组的列原样保留(同一个对象);
+ *  - 一个分组也没有时直接返回传入的数组本身,没用到分组的表格行为零变化。
+ *
+ * groupId 由分组名派生(同名第 N 次出现追加 _N),同样的输入永远得到同样的 id:
+ * columnDefs 因别的原因重建时,AG-Grid 靠 groupId 认出还是那个列组,列组状态不丢。
+ *
+ * 有意不设 marryChildren:设了以后,任何打破组内相邻的列顺序(用户旧的扁平列方案、
+ * 列设置面板里跨组拖动的实时预览)都会被 AG-Grid 整体丢弃并报 error #39;不设则顺序照常生效,
+ * 组被隔开时表头显示成多段。
+ * openByDefault:列组默认展开(只对配了 columnGroupShow 的可折叠列组有意义)。
+ */
+export declare const groupColumnDefs: (colDefs: ColDef[]) => (ColDef | ColGroupDef)[];

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

@@ -0,0 +1,106 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.markHeaderGroup = exports.groupColumnDefs = void 0;
+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; }
+/**
+ * ArrayTable 分组表头(多级表头)。
+ *
+ * 背景:schema 里的每个 ArrayTable.Column 被抽成「扁平」列定义(buildArrayTableColumns),
+ * 内部一批逻辑(懒挂载列识别、列方案还原、首列拖拽等)都按扁平列取值,不能改。
+ * 所以分组只在「交给 AG-Grid 的那一份 columnDefs」上做:
+ *  1. buildArrayTableColumns 生成列定义时,用 markHeaderGroup 把列声明的 headerGroup 记下来;
+ *  2. index.tsx 把扁平列定义交给 groupColumnDefs,得到含列组的 columnDefs 传给 AgGridReact。
+ *
+ * 分组名记在模块内的 WeakMap 里,不往 colDef 上塞自定义字段——AG-Grid 会把未知属性当作错误告警。
+ *
+ * 只支持一级分组;分组名相同但不相邻的列各自成组。
+ *
+ * @author nokecy
+ */
+
+/** 列定义 -> 它在 schema 里声明的 headerGroup */
+var headerGroupOf = new WeakMap();
+
+/** 列组 id 前缀,与列方案里生成的 col_N 区分开 */
+var GROUP_ID_PREFIX = 'arrayTableGroup_';
+
+/**
+ * 记下列定义所属的表头分组。
+ * headerGroup 不是非空字符串(没声明、空串、纯空白)时不做任何事,该列按无分组处理。
+ * 返回传入的 colDef 本身,方便链式使用。
+ */
+var markHeaderGroup = exports.markHeaderGroup = function markHeaderGroup(colDef, headerGroup) {
+  if (typeof headerGroup === 'string' && headerGroup.trim() !== '') {
+    headerGroupOf.set(colDef, headerGroup);
+  }
+  return colDef;
+};
+
+/**
+ * 把扁平列定义按「相邻且 headerGroup 相同」合并成 AG-Grid 列组。
+ *
+ *  - 相邻同名的列 -> 一个 { headerName, groupId, children } 列组;
+ *  - 同名但被别的列隔开 -> 各自成组,groupId 各不相同;
+ *  - 没声明分组的列原样保留(同一个对象);
+ *  - 一个分组也没有时直接返回传入的数组本身,没用到分组的表格行为零变化。
+ *
+ * groupId 由分组名派生(同名第 N 次出现追加 _N),同样的输入永远得到同样的 id:
+ * columnDefs 因别的原因重建时,AG-Grid 靠 groupId 认出还是那个列组,列组状态不丢。
+ *
+ * 有意不设 marryChildren:设了以后,任何打破组内相邻的列顺序(用户旧的扁平列方案、
+ * 列设置面板里跨组拖动的实时预览)都会被 AG-Grid 整体丢弃并报 error #39;不设则顺序照常生效,
+ * 组被隔开时表头显示成多段。
+ * openByDefault:列组默认展开(只对配了 columnGroupShow 的可折叠列组有意义)。
+ */
+var groupColumnDefs = exports.groupColumnDefs = function groupColumnDefs(colDefs) {
+  if (!colDefs.some(function (colDef) {
+    return headerGroupOf.has(colDef);
+  })) return colDefs;
+  var usedGroupIds = new Set();
+  var makeGroupId = function makeGroupId(name) {
+    var id = "".concat(GROUP_ID_PREFIX).concat(name);
+    for (var n = 2; usedGroupIds.has(id); n++) {
+      id = "".concat(GROUP_ID_PREFIX).concat(name, "_").concat(n);
+    }
+    usedGroupIds.add(id);
+    return id;
+  };
+  var result = [];
+  var current = null;
+  var _iterator = _createForOfIteratorHelper(colDefs),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var colDef = _step.value;
+      var name = headerGroupOf.get(colDef);
+      if (name === undefined) {
+        current = null;
+        result.push(colDef);
+      } else if (current && current.name === name) {
+        current.group.children.push(colDef);
+      } else {
+        var group = {
+          headerName: name,
+          groupId: makeGroupId(name),
+          openByDefault: true,
+          children: [colDef]
+        };
+        current = {
+          name: name,
+          group: group
+        };
+        result.push(group);
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return result;
+};

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

@@ -0,0 +1,126 @@
+import { ColDef } from 'ag-grid-community';
+/**
+ * 列配置类型定义
+ */
+export interface ColumnConfig {
+    /** 列标题 */
+    headerName: string;
+    /** 数据字段 */
+    dataIndex: string;
+    /** 列宽度 */
+    width?: number;
+    /** 最小宽度 */
+    minWidth?: number;
+    /** 最大宽度 */
+    maxWidth?: number;
+    /** 是否可调整大小 */
+    resizable?: boolean;
+    /** 是否可排序 */
+    sortable?: boolean;
+    /** 是否可筛选 */
+    filter?: boolean | string;
+    /** 对齐方式 */
+    align?: 'left' | 'center' | 'right';
+    /** 是否固定列 */
+    pinned?: 'left' | 'right' | null;
+    /** 是否隐藏 */
+    hide?: boolean;
+    /** 是否省略显示 */
+    ellipsis?: boolean;
+    /** 是否可编辑 */
+    editable?: boolean;
+    /** 自定义 AG-Grid 配置 */
+    agGridProps?: Partial<ColDef>;
+}
+/**
+ * 文本列配置
+ * 用于显示和编辑文本内容
+ */
+export declare const createTextColumn: (config: ColumnConfig) => ColumnConfig;
+/**
+ * 数字列配置
+ * 用于显示和编辑数字内容
+ */
+export declare const createNumberColumn: (config: ColumnConfig) => ColumnConfig;
+/**
+ * 日期列配置
+ * 用于显示和编辑日期内容
+ */
+export declare const createDateColumn: (config: ColumnConfig) => ColumnConfig;
+/**
+ * 选择列配置
+ * 用于下拉选择类型的列
+ */
+export declare const createSelectColumn: (config: ColumnConfig) => ColumnConfig;
+/**
+ * 操作列配置
+ * 用于行操作按钮列
+ */
+export declare const createOperationColumn: (config: Omit<ColumnConfig, 'dataIndex'>) => ColumnConfig;
+/**
+ * 序号列配置
+ * 用于显示行序号
+ */
+export declare const createIndexColumn: (config?: Partial<ColumnConfig>) => ColumnConfig;
+/**
+ * 只读列配置
+ * 用于显示不可编辑的内容
+ */
+export declare const createReadOnlyColumn: (config: ColumnConfig) => ColumnConfig;
+/**
+ * 固定左侧列配置
+ */
+export declare const createPinnedLeftColumn: (config: ColumnConfig) => ColumnConfig;
+/**
+ * 固定右侧列配置
+ */
+export declare const createPinnedRightColumn: (config: ColumnConfig) => ColumnConfig;
+/**
+ * 百分比列配置
+ * 用于显示百分比数值
+ */
+export declare const createPercentColumn: (config: ColumnConfig) => ColumnConfig;
+/**
+ * 货币列配置
+ * 用于显示货币金额
+ */
+export declare const createCurrencyColumn: (config: ColumnConfig) => ColumnConfig;
+/**
+ * 批量创建列配置
+ * @param columns 列配置数组
+ * @returns 标准化的列配置数组
+ */
+export declare const createColumns: (columns: ColumnConfig[]) => ColumnConfig[];
+/**
+ * 列配置预设
+ */
+export declare const ColumnPresets: {
+    /** 文本列 */
+    text: (config: ColumnConfig) => ColumnConfig;
+    /** 数字列 */
+    number: (config: ColumnConfig) => ColumnConfig;
+    /** 日期列 */
+    date: (config: ColumnConfig) => ColumnConfig;
+    /** 选择列 */
+    select: (config: ColumnConfig) => ColumnConfig;
+    /** 操作列 */
+    operation: (config: Omit<ColumnConfig, 'dataIndex'>) => ColumnConfig;
+    /** 序号列 */
+    index: (config?: Partial<ColumnConfig>) => ColumnConfig;
+    /** 只读列 */
+    readOnly: (config: ColumnConfig) => ColumnConfig;
+    /** 固定左侧列 */
+    pinnedLeft: (config: ColumnConfig) => ColumnConfig;
+    /** 固定右侧列 */
+    pinnedRightColumn: (config: ColumnConfig) => ColumnConfig;
+    /** 百分比列 */
+    percent: (config: ColumnConfig) => ColumnConfig;
+    /** 货币列 */
+    currency: (config: ColumnConfig) => ColumnConfig;
+};
+/**
+ * 转换为 AG-Grid 列定义
+ * @param config 列配置
+ * @returns AG-Grid ColDef
+ */
+export declare const toAgGridColDef: (config: ColumnConfig) => Partial<ColDef>;

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

@@ -0,0 +1,241 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.toAgGridColDef = exports.createTextColumn = exports.createSelectColumn = exports.createReadOnlyColumn = exports.createPinnedRightColumn = exports.createPinnedLeftColumn = exports.createPercentColumn = exports.createOperationColumn = exports.createNumberColumn = exports.createIndexColumn = exports.createDateColumn = exports.createCurrencyColumn = exports.createColumns = exports.ColumnPresets = void 0;
+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); }
+/**
+ * 列配置类型定义
+ */
+
+/**
+ * 文本列配置
+ * 用于显示和编辑文本内容
+ */
+var createTextColumn = exports.createTextColumn = function createTextColumn(config) {
+  return _objectSpread({
+    resizable: true,
+    sortable: true,
+    filter: 'agTextColumnFilter',
+    align: 'left',
+    editable: true,
+    ellipsis: true
+  }, config);
+};
+
+/**
+ * 数字列配置
+ * 用于显示和编辑数字内容
+ */
+var createNumberColumn = exports.createNumberColumn = function createNumberColumn(config) {
+  return _objectSpread({
+    resizable: true,
+    sortable: true,
+    filter: 'agNumberColumnFilter',
+    align: 'right',
+    editable: true
+  }, config);
+};
+
+/**
+ * 日期列配置
+ * 用于显示和编辑日期内容
+ */
+var createDateColumn = exports.createDateColumn = function createDateColumn(config) {
+  return _objectSpread({
+    resizable: true,
+    sortable: true,
+    filter: 'agDateColumnFilter',
+    align: 'center',
+    editable: true
+  }, config);
+};
+
+/**
+ * 选择列配置
+ * 用于下拉选择类型的列
+ */
+var createSelectColumn = exports.createSelectColumn = function createSelectColumn(config) {
+  return _objectSpread({
+    resizable: true,
+    sortable: true,
+    filter: 'agSetColumnFilter',
+    align: 'left',
+    editable: true
+  }, config);
+};
+
+/**
+ * 操作列配置
+ * 用于行操作按钮列
+ */
+var createOperationColumn = exports.createOperationColumn = function createOperationColumn(config) {
+  return _objectSpread({
+    dataIndex: 'operations',
+    resizable: false,
+    sortable: false,
+    filter: false,
+    pinned: 'right',
+    width: 120,
+    align: 'center'
+  }, config);
+};
+
+/**
+ * 序号列配置
+ * 用于显示行序号
+ */
+var createIndexColumn = exports.createIndexColumn = function createIndexColumn(config) {
+  return _objectSpread({
+    headerName: '序号',
+    dataIndex: 'index',
+    width: 80,
+    resizable: false,
+    sortable: false,
+    filter: false,
+    align: 'center',
+    pinned: 'left'
+  }, config);
+};
+
+/**
+ * 只读列配置
+ * 用于显示不可编辑的内容
+ */
+var createReadOnlyColumn = exports.createReadOnlyColumn = function createReadOnlyColumn(config) {
+  return _objectSpread({
+    resizable: true,
+    sortable: true,
+    editable: false
+  }, config);
+};
+
+/**
+ * 固定左侧列配置
+ */
+var createPinnedLeftColumn = exports.createPinnedLeftColumn = function createPinnedLeftColumn(config) {
+  return _objectSpread(_objectSpread({}, config), {}, {
+    pinned: 'left'
+  });
+};
+
+/**
+ * 固定右侧列配置
+ */
+var createPinnedRightColumn = exports.createPinnedRightColumn = function createPinnedRightColumn(config) {
+  return _objectSpread(_objectSpread({}, config), {}, {
+    pinned: 'right'
+  });
+};
+
+/**
+ * 百分比列配置
+ * 用于显示百分比数值
+ */
+var createPercentColumn = exports.createPercentColumn = function createPercentColumn(config) {
+  return _objectSpread({
+    resizable: true,
+    sortable: true,
+    filter: 'agNumberColumnFilter',
+    align: 'right',
+    editable: true
+  }, config);
+};
+
+/**
+ * 货币列配置
+ * 用于显示货币金额
+ */
+var createCurrencyColumn = exports.createCurrencyColumn = function createCurrencyColumn(config) {
+  return _objectSpread({
+    resizable: true,
+    sortable: true,
+    filter: 'agNumberColumnFilter',
+    align: 'right',
+    editable: true
+  }, config);
+};
+
+/**
+ * 批量创建列配置
+ * @param columns 列配置数组
+ * @returns 标准化的列配置数组
+ */
+var createColumns = exports.createColumns = function createColumns(columns) {
+  return columns.map(function (col) {
+    return _objectSpread({
+      resizable: true,
+      sortable: false,
+      align: 'left'
+    }, col);
+  });
+};
+
+/**
+ * 列配置预设
+ */
+var ColumnPresets = exports.ColumnPresets = {
+  /** 文本列 */
+  text: createTextColumn,
+  /** 数字列 */
+  number: createNumberColumn,
+  /** 日期列 */
+  date: createDateColumn,
+  /** 选择列 */
+  select: createSelectColumn,
+  /** 操作列 */
+  operation: createOperationColumn,
+  /** 序号列 */
+  index: createIndexColumn,
+  /** 只读列 */
+  readOnly: createReadOnlyColumn,
+  /** 固定左侧列 */
+  pinnedLeft: createPinnedLeftColumn,
+  /** 固定右侧列 */
+  pinnedRightColumn: createPinnedRightColumn,
+  /** 百分比列 */
+  percent: createPercentColumn,
+  /** 货币列 */
+  currency: createCurrencyColumn
+};
+
+/**
+ * 转换为 AG-Grid 列定义
+ * @param config 列配置
+ * @returns AG-Grid ColDef
+ */
+var toAgGridColDef = exports.toAgGridColDef = function toAgGridColDef(config) {
+  var headerName = config.headerName,
+    dataIndex = config.dataIndex,
+    width = config.width,
+    minWidth = config.minWidth,
+    maxWidth = config.maxWidth,
+    resizable = config.resizable,
+    sortable = config.sortable,
+    filter = config.filter,
+    align = config.align,
+    pinned = config.pinned,
+    hide = config.hide,
+    editable = config.editable,
+    agGridProps = config.agGridProps;
+  return _objectSpread({
+    headerName: headerName,
+    field: dataIndex,
+    width: width,
+    minWidth: minWidth,
+    maxWidth: maxWidth,
+    resizable: resizable,
+    sortable: sortable,
+    filter: filter,
+    cellClass: align ? "qc-array-table-align-".concat(align) : undefined,
+    pinned: pinned || undefined,
+    hide: hide,
+    editable: editable
+  }, agGridProps);
+};

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