@nokecy/qc-ui 1.1.87 → 1.1.89

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

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.registerReadOnlyRenderer = exports.registerReadOnlyLabels = exports.registerReadOnlyFormatter = exports.getReadOnlyRenderer = exports.getReadOnlyFormatter = exports.fallbackFormatter = void 0;
+exports.withReadOnlyFormatter = exports.registerReadOnlyRenderer = exports.registerReadOnlyLabels = exports.registerReadOnlyFormatter = exports.getReadOnlyRenderer = exports.getReadOnlyFormatter = exports.formatSelectDisplay = exports.fallbackFormatter = void 0;
 var _dayjs = _interopRequireDefault(require("dayjs"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
@@ -27,6 +27,26 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
  *
  * @author nokecy
  */
+/** 选择器的展示字段；只影响回显，不改变 labelInValue 的提交值。@author nokecy */
+
+/** 从选择值提取展示文字；编码展示不能因描述为空或过期而改变。@author nokecy */
+var formatSelectDisplay = exports.formatSelectDisplay = function formatSelectDisplay(value) {
+  var _value$label;
+  var displayField = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'label';
+  if (value == null) return '';
+  if (Array.isArray(value)) return value.map(function (item) {
+    return formatSelectDisplay(item, displayField);
+  }).filter(Boolean).join(', ');
+  if (_typeof(value) === 'object') return formatSelectDisplay(displayField === 'value' ? value.value : (_value$label = value.label) !== null && _value$label !== void 0 ? _value$label : value.value, displayField);
+  return String(value);
+};
+
+/** 给选择组件声明与其回显一致的表格格式化器，组件别名和不同页面各自生效。@author nokecy */
+var withReadOnlyFormatter = exports.withReadOnlyFormatter = function withReadOnlyFormatter(component, formatter) {
+  return Object.assign(component, {
+    readOnlyFormatter: formatter
+  });
+};
 /** 从字段 schema / 列 props 里尽量取到 Select 的可选项(value->label 映射用) */
 var resolveOptions = function resolveOptions(ctx) {
   var _ref, _ref2, _ref3, _fieldSchema$enum, _fieldSchema$xCompon, _fieldSchema$xCompon2;
@@ -39,10 +59,10 @@ var resolveOptions = function resolveOptions(ctx) {
 
 /** 单个值映射成 label:兼容 labelInValue 对象、{label,value} 选项、原始值 */
 var mapOptionLabel = function mapOptionLabel(value, options) {
-  var _ref4, _value$label, _ref5, _hit$label;
+  var _ref4, _value$label2, _ref5, _hit$label;
   if (value == null) return '';
   // labelInValue: 值本身就是 { label, value }
-  if (_typeof(value) === 'object') return String((_ref4 = (_value$label = value.label) !== null && _value$label !== void 0 ? _value$label : value.value) !== null && _ref4 !== void 0 ? _ref4 : '');
+  if (_typeof(value) === 'object') return String((_ref4 = (_value$label2 = value.label) !== null && _value$label2 !== void 0 ? _value$label2 : value.value) !== null && _ref4 !== void 0 ? _ref4 : '');
   // 严格相等优先;退一步按 String 宽松比对,容忍后端类型漂移(如返回 "0" 而 enum 存数字 0)
   var hit = options.find(function (o) {
     var ov = o && _typeof(o) === 'object' ? o.value : o;
@@ -55,7 +75,9 @@ var textFormatter = function textFormatter(value) {
   return value == null ? '' : String(value);
 };
 var selectFormatter = function selectFormatter(value, ctx) {
+  var _ctx$fieldSchema;
   if (value == null) return '';
+  if (((_ctx$fieldSchema = ctx.fieldSchema) === null || _ctx$fieldSchema === void 0 || (_ctx$fieldSchema = _ctx$fieldSchema['x-component-props']) === null || _ctx$fieldSchema === void 0 ? void 0 : _ctx$fieldSchema.displayField) === 'value') return formatSelectDisplay(value, 'value');
   var options = resolveOptions(ctx);
   // 多选:数组 -> 逗号拼接
   if (Array.isArray(value)) {
@@ -79,14 +101,14 @@ var defaultDateFormat = function defaultDateFormat(component, props) {
   return 'YYYY-MM-DD';
 };
 var dateFormatter = function dateFormatter(value, ctx) {
-  var _ctx$fieldSchema, _ctx$columnProps, _ctx$fieldSchema2;
+  var _ctx$fieldSchema2, _ctx$columnProps, _ctx$fieldSchema3;
   if (value == null || value === '') return '';
-  var props = (_ctx$fieldSchema = ctx.fieldSchema) === null || _ctx$fieldSchema === void 0 ? void 0 : _ctx$fieldSchema['x-component-props'];
+  var props = (_ctx$fieldSchema2 = ctx.fieldSchema) === null || _ctx$fieldSchema2 === void 0 ? void 0 : _ctx$fieldSchema2['x-component-props'];
   // antd 的 format 还可以是数组/函数，文本态只认字符串，其余回到默认
   var configured = [(_ctx$columnProps = ctx.columnProps) === null || _ctx$columnProps === void 0 ? void 0 : _ctx$columnProps.format, props === null || props === void 0 ? void 0 : props.format].find(function (f) {
     return typeof f === 'string' && f;
   });
-  var fmt = configured !== null && configured !== void 0 ? configured : defaultDateFormat((_ctx$fieldSchema2 = ctx.fieldSchema) === null || _ctx$fieldSchema2 === void 0 ? void 0 : _ctx$fieldSchema2['x-component'], props);
+  var fmt = configured !== null && configured !== void 0 ? configured : defaultDateFormat((_ctx$fieldSchema3 = ctx.fieldSchema) === null || _ctx$fieldSchema3 === void 0 ? void 0 : _ctx$fieldSchema3['x-component'], props);
   if (typeof value.format === 'function') return value.format(fmt);
   // 后端回来的多是 ISO 串(2024-10-19T00:00:00)或时间戳:与 Formily readPretty 一致,按 dayjs(value).format(fmt) 显示;
   // 解析不了的文本(如「待定」、纯时间 08:30:00)原样显示,不吞掉。dayjs 随 antd 传递依赖引入,本库其他模块已直接使用。
@@ -99,9 +121,9 @@ var dateFormatter = function dateFormatter(value, ctx) {
  * 与点开后的 InputNumber 一致；没配这两项时与原样输出相同。
  */
 var numberFormatter = function numberFormatter(value, ctx) {
-  var _ctx$fieldSchema$xCo, _ctx$fieldSchema3, _ctx$columnProps$prec, _ctx$columnProps2, _ctx$columnProps$form, _ctx$columnProps3;
+  var _ctx$fieldSchema$xCo, _ctx$fieldSchema4, _ctx$columnProps$prec, _ctx$columnProps2, _ctx$columnProps$form, _ctx$columnProps3;
   if (value == null || value === '') return '';
-  var props = (_ctx$fieldSchema$xCo = (_ctx$fieldSchema3 = ctx.fieldSchema) === null || _ctx$fieldSchema3 === void 0 ? void 0 : _ctx$fieldSchema3['x-component-props']) !== null && _ctx$fieldSchema$xCo !== void 0 ? _ctx$fieldSchema$xCo : {};
+  var props = (_ctx$fieldSchema$xCo = (_ctx$fieldSchema4 = ctx.fieldSchema) === null || _ctx$fieldSchema4 === void 0 ? void 0 : _ctx$fieldSchema4['x-component-props']) !== null && _ctx$fieldSchema$xCo !== void 0 ? _ctx$fieldSchema$xCo : {};
   var precision = (_ctx$columnProps$prec = (_ctx$columnProps2 = ctx.columnProps) === null || _ctx$columnProps2 === void 0 ? void 0 : _ctx$columnProps2.precision) !== null && _ctx$columnProps$prec !== void 0 ? _ctx$columnProps$prec : props.precision;
   var num = Number(value);
   var base = typeof precision === 'number' && precision >= 0 && Number.isFinite(num) ? num.toFixed(precision) : String(value);
@@ -119,9 +141,9 @@ var numberFormatter = function numberFormatter(value, ctx) {
   return base;
 };
 var booleanFormatter = function booleanFormatter(value, ctx) {
-  var _ctx$fieldSchema$xCo2, _ctx$fieldSchema4, _props$checkedChildre, _props$unCheckedChild;
+  var _ctx$fieldSchema$xCo2, _ctx$fieldSchema5, _props$checkedChildre, _props$unCheckedChild;
   if (value == null || value === '') return '';
-  var props = (_ctx$fieldSchema$xCo2 = (_ctx$fieldSchema4 = ctx.fieldSchema) === null || _ctx$fieldSchema4 === void 0 ? void 0 : _ctx$fieldSchema4['x-component-props']) !== null && _ctx$fieldSchema$xCo2 !== void 0 ? _ctx$fieldSchema$xCo2 : {};
+  var props = (_ctx$fieldSchema$xCo2 = (_ctx$fieldSchema5 = ctx.fieldSchema) === null || _ctx$fieldSchema5 === void 0 ? void 0 : _ctx$fieldSchema5['x-component-props']) !== null && _ctx$fieldSchema$xCo2 !== void 0 ? _ctx$fieldSchema$xCo2 : {};
   var truthy = (_props$checkedChildre = props.checkedChildren) !== null && _props$checkedChildre !== void 0 ? _props$checkedChildre : '是';
   var falsy = (_props$unCheckedChild = props.unCheckedChildren) !== null && _props$unCheckedChild !== void 0 ? _props$unCheckedChild : '否';
   return value ? String(truthy) : String(falsy);
@@ -158,15 +180,17 @@ var registry = {
  * 消费方用 registerReadOnlyFormatter 注册专用格式化器覆盖。@author nokecy
  */
 var fallbackFormatter = exports.fallbackFormatter = function fallbackFormatter(value, ctx) {
+  var _ctx$fieldSchema6;
   if (value == null || value === '') return '';
+  if (((_ctx$fieldSchema6 = ctx.fieldSchema) === null || _ctx$fieldSchema6 === void 0 || (_ctx$fieldSchema6 = _ctx$fieldSchema6['x-component-props']) === null || _ctx$fieldSchema6 === void 0 ? void 0 : _ctx$fieldSchema6.displayField) === 'value') return formatSelectDisplay(value, 'value');
   if (Array.isArray(value)) return value.map(function (v) {
     return fallbackFormatter(v, ctx);
   }).filter(Boolean).join(', ');
   if (typeof value === 'boolean') return booleanFormatter(value, ctx);
   if (_typeof(value) === 'object') {
-    var _value$label2;
+    var _value$label3;
     if (typeof value.format === 'function') return dateFormatter(value, ctx);
-    var shown = (_value$label2 = value.label) !== null && _value$label2 !== void 0 ? _value$label2 : value.value;
+    var shown = (_value$label3 = value.label) !== null && _value$label3 !== void 0 ? _value$label3 : value.value;
     return shown == null ? '' : String(shown);
   }
   return String(value);
@@ -242,8 +266,12 @@ var getReadOnlyRenderer = exports.getReadOnlyRenderer = function getReadOnlyRend
 /**
  * 取某组件类型的只读格式化器。命中返回函数,未命中返回 null(调用方回退 AgField)。
  */
-var getReadOnlyFormatter = exports.getReadOnlyFormatter = function getReadOnlyFormatter(component) {
+var getReadOnlyFormatter = exports.getReadOnlyFormatter = function getReadOnlyFormatter(component, components) {
   var _registry$component;
   if (!component) return null;
+  var control = component.split('.').reduce(function (current, key) {
+    return current === null || current === void 0 ? void 0 : current[key];
+  }, components);
+  if (typeof (control === null || control === void 0 ? void 0 : control.readOnlyFormatter) === 'function') return control.readOnlyFormatter;
   return (_registry$component = registry[component]) !== null && _registry$component !== void 0 ? _registry$component : null;
 };

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

@@ -0,0 +1,17 @@
+import type { ArrayField } from '@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');
+  };
+};