@nokecy/qc-ui 1.1.73 → 1.1.75

package/dist/cjs/entitySelect/index.js

@@ -0,0 +1,172 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.createEntitySelect = void 0;
+var _dialogSelect = _interopRequireDefault(require("../dialogSelect"));
+var _ahooks = require("ahooks");
+var _antd = require("antd");
+var _react = _interopRequireWildcard(require("react"));
+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; }
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+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 _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 _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; }
+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; }
+var Option = _antd.Select.Option;
+
+/**
+ * 实体选择器的骨架。
+ *
+ * 各业务模块的实体选择器（线体、车间、物料、供应商……）此前是逐个复制出来的：
+ * 取数、防抖、受控值、下拉即查、labelInValue、弹窗表格列，每份各写一遍，
+ * 真正不同的只有请求函数、提示语和表格列。骨架收在这里，各模块只填自己的那几项。
+ *
+ * 骨架不认识任何业务契约：请求函数由调用方传入，不引用任何生成服务客户端。
+ *
+ * @author nokecy
+ */
+
+/** 取数入参：与后端分页查询约定一致。 */
+
+var createEntitySelect = exports.createEntitySelect = function createEntitySelect(config) {
+  var request = config.request,
+    placeholder = config.placeholder,
+    columnDefs = config.columnDefs,
+    valueField = config.valueField,
+    labelField = config.labelField,
+    modalWidth = config.modalWidth,
+    _config$pageSize = config.pageSize,
+    pageSize = _config$pageSize === void 0 ? 300 : _config$pageSize,
+    _config$useCodeByDefa = config.useCodeByDefault,
+    useCodeByDefault = _config$useCodeByDefa === void 0 ? true : _config$useCodeByDefa,
+    _config$buildFilter = config.buildFilter,
+    buildFilter = _config$buildFilter === void 0 ? function (keyword) {
+      return "(name =* ".concat(keyword, ") | (code =* ").concat(keyword, ")");
+    } : _config$buildFilter,
+    _config$renderOptionL = config.renderOptionLabel,
+    renderOptionLabel = _config$renderOptionL === void 0 ? function (item) {
+      return "".concat(item.code, " - ").concat(item.name);
+    } : _config$renderOptionL,
+    renderOption = config.renderOption,
+    linkagePropName = config.linkagePropName,
+    gridComponent = config.gridComponent;
+  var getData = function getData(_ref) {
+    var Filter = _ref.Filter,
+      SkipCount = _ref.SkipCount,
+      MaxResultCount = _ref.MaxResultCount,
+      Sorting = _ref.Sorting;
+    return request({
+      Filter: Filter ? Filter : undefined,
+      SkipCount: SkipCount ? SkipCount : 0,
+      MaxResultCount: MaxResultCount ? MaxResultCount : pageSize,
+      Sorting: Sorting ? Sorting : undefined
+    });
+  };
+
+  // props 上不加索引签名、ref 不收窄：这些选择器会被当作 AgGridColumn 的 searchComponent 传递，
+  // 任一处收紧都会让 forwardRef 的推断结果与那处的 prop 类型不兼容。
+  var EntitySelect = function EntitySelect(props, ref) {
+    var _data$items2;
+    var _props$useCode = props.useCode,
+      useCode = _props$useCode === void 0 ? useCodeByDefault : _props$useCode,
+      _props$enableLinkage = props.enableLinkage,
+      enableLinkage = _props$enableLinkage === void 0 ? false : _props$enableLinkage;
+    var resolvedValueField = valueField !== null && valueField !== void 0 ? valueField : useCode ? 'code' : 'id';
+    var onLinkage = linkagePropName ? props[linkagePropName] : undefined;
+    var lastLinkedValueRef = (0, _react.useRef)();
+    var _useControllableValue = (0, _ahooks.useControllableValue)(props),
+      _useControllableValue2 = _slicedToArray(_useControllableValue, 2),
+      state = _useControllableValue2[0],
+      setState = _useControllableValue2[1];
+    var _useRequest = (0, _ahooks.useRequest)(getData, {
+        debounceMaxWait: 500,
+        manual: true
+      }),
+      data = _useRequest.data,
+      loading = _useRequest.loading,
+      run = _useRequest.run,
+      cancel = _useRequest.cancel;
+    var handleChange = function handleChange(value) {
+      var _data$items;
+      setState(value);
+      if (!value) {
+        lastLinkedValueRef.current = undefined;
+        return;
+      }
+      if (!enableLinkage || !onLinkage) return;
+      var picked = _typeof(value) === 'object' ? value.value : value;
+      var matched = data === null || data === void 0 || (_data$items = data.items) === null || _data$items === void 0 ? void 0 : _data$items.find(function (item) {
+        return item[resolvedValueField] === picked;
+      });
+      if (matched && lastLinkedValueRef.current !== picked) {
+        lastLinkedValueRef.current = picked;
+        onLinkage(matched);
+      }
+    };
+    return /*#__PURE__*/_react.default.createElement("span", {
+      ref: ref,
+      style: {
+        display: 'block',
+        width: '100%',
+        minWidth: 0,
+        maxWidth: '100%'
+      }
+    }, /*#__PURE__*/_react.default.createElement(_dialogSelect.default, _extends({
+      placeholder: placeholder,
+      style: {
+        width: '100%',
+        maxWidth: '100%'
+      },
+      showSearch: true,
+      labelInValue: true,
+      filterOption: false
+    }, modalWidth ? {
+      modalWidth: modalWidth
+    } : {}, gridComponent ? {
+      gridComponent: gridComponent
+    } : {}, props, {
+      onSearch: function onSearch(value) {
+        run({
+          Filter: buildFilter(value)
+        });
+      },
+      onDropdownVisibleChange: function onDropdownVisibleChange(visible) {
+        visible && run({});
+      },
+      loading: loading,
+      onBlur: cancel,
+      value: JSON.stringify(state) === '{}' ? undefined : state,
+      onChange: handleChange,
+      valueField: resolvedValueField
+    }, labelField ? {
+      labelField: labelField
+    } : {}, {
+      request: getData,
+      columnDefs: columnDefs,
+      onChangeItem: function onChangeItem(item) {
+        if (!enableLinkage || !onLinkage || !item) return;
+        var selected = Array.isArray(item) ? item[0] : item;
+        if (!selected) return;
+        var picked = selected[resolvedValueField];
+        if (lastLinkedValueRef.current === picked) return;
+        lastLinkedValueRef.current = picked;
+        onLinkage(selected);
+      }
+    }), data === null || data === void 0 || (_data$items2 = data.items) === null || _data$items2 === void 0 ? void 0 : _data$items2.map(function (item) {
+      var _item$id;
+      return renderOption ? renderOption(item, resolvedValueField) : /*#__PURE__*/_react.default.createElement(Option, {
+        key: (_item$id = item.id) !== null && _item$id !== void 0 ? _item$id : item[resolvedValueField],
+        value: item[resolvedValueField]
+      }, renderOptionLabel(item));
+    })));
+  };
+  return /*#__PURE__*/_react.default.forwardRef(EntitySelect);
+};
+var _default = exports.default = createEntitySelect;

package/dist/cjs/index.d.ts

@@ -31,4 +31,12 @@ export type * from "./RuleBuilder";
 export type { ColumnConfig } from "./array-table/columnHelper";
 export type { CentralizedColumnScheme, QueryScheme, SchemeStorageAdapter, SchemeSyncDataDto, CurrentSchemeDto, SchemeStorageConfig, LocalStorageAdapterConfig, BackendApiAdapterConfig, UseSchemeManagerConfig, GridPlusContextValue, GlobalConfigPermissions, } from "./ag-grid-plus";
 export * from './adapters';
+export * from "./readPretty";
+export { createEntitySelect } from "./entitySelect";
+export type { EntitySelectConfig, EntitySelectProps, EntitySelectQuery } from "./entitySelect";
+export { semanticTextColors, toGridTextColor, gridValueEnum } from "./ag-grid-plus/utils/valueEnumColor";
+export type { SemanticPreset } from "./ag-grid-plus/utils/valueEnumColor";
+export { contrastRatio, relativeLuminance, darkenUntilContrast, lightenUntilContrast, toRgb, toHsl, fromHsl } from "./utils/contrast";
+export { BusinessDecimal, decimal, decimalText, nonNegativeDecimal, roundDecimal, sumDecimals, formatDecimal } from "./utils/businessDecimal";
+export type { DecimalValue } from "./utils/businessDecimal";
 export type { ParseResult as RegexParseResult, ValidationResult as RegexValidationResult, RegexError, ComplexityMetrics, ASTNode, AstRegExp, RegexTemplate, TestResult as RegexTestResult, CodeMirrorWrapperProps, RegexEditorProps, RegexFlags, MatchResult, RegexTesterProps, FlagsSelectorProps, MatchItemProps, RegexRailroadDiagramProps, } from "./components/RegexEditor";

package/dist/cjs/index.js

@@ -46,7 +46,25 @@ var _exportNames = {
   RegexTester: true,
   FlagsSelector: true,
   MatchItem: true,
-  RegexRailroadDiagram: true
+  RegexRailroadDiagram: true,
+  createEntitySelect: true,
+  semanticTextColors: true,
+  toGridTextColor: true,
+  gridValueEnum: true,
+  contrastRatio: true,
+  relativeLuminance: true,
+  darkenUntilContrast: true,
+  lightenUntilContrast: true,
+  toRgb: true,
+  toHsl: true,
+  fromHsl: true,
+  BusinessDecimal: true,
+  decimal: true,
+  decimalText: true,
+  nonNegativeDecimal: true,
+  roundDecimal: true,
+  sumDecimals: true,
+  formatDecimal: true
 };
 Object.defineProperty(exports, "AgGridColumn", {
   enumerable: true,
@@ -78,6 +96,12 @@ Object.defineProperty(exports, "BackendApiSchemeAdapter", {
     return _agGridPlus.BackendApiSchemeAdapter;
   }
 });
+Object.defineProperty(exports, "BusinessDecimal", {
+  enumerable: true,
+  get: function get() {
+    return _businessDecimal.BusinessDecimal;
+  }
+});
 Object.defineProperty(exports, "Card", {
   enumerable: true,
   get: function get() {
@@ -252,24 +276,126 @@ Object.defineProperty(exports, "ToolBar", {
     return _toolBar.default;
   }
 });
+Object.defineProperty(exports, "contrastRatio", {
+  enumerable: true,
+  get: function get() {
+    return _contrast.contrastRatio;
+  }
+});
 Object.defineProperty(exports, "createCascaderField", {
   enumerable: true,
   get: function get() {
     return _standardFormDialog.createCascaderField;
   }
 });
+Object.defineProperty(exports, "createEntitySelect", {
+  enumerable: true,
+  get: function get() {
+    return _entitySelect.createEntitySelect;
+  }
+});
 Object.defineProperty(exports, "createSelectField", {
   enumerable: true,
   get: function get() {
     return _standardFormDialog.createSelectField;
   }
 });
+Object.defineProperty(exports, "darkenUntilContrast", {
+  enumerable: true,
+  get: function get() {
+    return _contrast.darkenUntilContrast;
+  }
+});
+Object.defineProperty(exports, "decimal", {
+  enumerable: true,
+  get: function get() {
+    return _businessDecimal.decimal;
+  }
+});
+Object.defineProperty(exports, "decimalText", {
+  enumerable: true,
+  get: function get() {
+    return _businessDecimal.decimalText;
+  }
+});
 Object.defineProperty(exports, "flattenTreeDeep", {
   enumerable: true,
   get: function get() {
     return _agGridPlus.flattenTreeDeep;
   }
 });
+Object.defineProperty(exports, "formatDecimal", {
+  enumerable: true,
+  get: function get() {
+    return _businessDecimal.formatDecimal;
+  }
+});
+Object.defineProperty(exports, "fromHsl", {
+  enumerable: true,
+  get: function get() {
+    return _contrast.fromHsl;
+  }
+});
+Object.defineProperty(exports, "gridValueEnum", {
+  enumerable: true,
+  get: function get() {
+    return _valueEnumColor.gridValueEnum;
+  }
+});
+Object.defineProperty(exports, "lightenUntilContrast", {
+  enumerable: true,
+  get: function get() {
+    return _contrast.lightenUntilContrast;
+  }
+});
+Object.defineProperty(exports, "nonNegativeDecimal", {
+  enumerable: true,
+  get: function get() {
+    return _businessDecimal.nonNegativeDecimal;
+  }
+});
+Object.defineProperty(exports, "relativeLuminance", {
+  enumerable: true,
+  get: function get() {
+    return _contrast.relativeLuminance;
+  }
+});
+Object.defineProperty(exports, "roundDecimal", {
+  enumerable: true,
+  get: function get() {
+    return _businessDecimal.roundDecimal;
+  }
+});
+Object.defineProperty(exports, "semanticTextColors", {
+  enumerable: true,
+  get: function get() {
+    return _valueEnumColor.semanticTextColors;
+  }
+});
+Object.defineProperty(exports, "sumDecimals", {
+  enumerable: true,
+  get: function get() {
+    return _businessDecimal.sumDecimals;
+  }
+});
+Object.defineProperty(exports, "toGridTextColor", {
+  enumerable: true,
+  get: function get() {
+    return _valueEnumColor.toGridTextColor;
+  }
+});
+Object.defineProperty(exports, "toHsl", {
+  enumerable: true,
+  get: function get() {
+    return _contrast.toHsl;
+  }
+});
+Object.defineProperty(exports, "toRgb", {
+  enumerable: true,
+  get: function get() {
+    return _contrast.toRgb;
+  }
+});
 Object.defineProperty(exports, "useGridPlusColumnState", {
   enumerable: true,
   get: function get() {
@@ -341,4 +467,20 @@ Object.keys(_adapters).forEach(function (key) {
     }
   });
 });
+var _readPretty = require("./readPretty");
+Object.keys(_readPretty).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _readPretty[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _readPretty[key];
+    }
+  });
+});
+var _entitySelect = require("./entitySelect");
+var _valueEnumColor = require("./ag-grid-plus/utils/valueEnumColor");
+var _contrast = require("./utils/contrast");
+var _businessDecimal = require("./utils/businessDecimal");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

package/dist/cjs/readPretty/arrayTable.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 阅读态也创建列的 void 字段，让 Formily 求值标题、显隐与 reactions；
+ * qc-ui 的阅读视图只读取列状态，未像编辑视图一样挂载这些字段。
+ * @author nokecy
+ */
+export declare const withReadingArrayTable: (Control: any) => any;

package/dist/cjs/readPretty/arrayTable.js

@@ -0,0 +1,156 @@
+"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.withReadingArrayTable = void 0;
+var _react = require("@formily/react");
+var _agGridReact = require("ag-grid-react");
+var _utils = require("../array-table/utils");
+var _columnGroup = require("../array-table/columnGroup");
+var _indexColumn = require("../array-table/indexColumn");
+var _theme = require("../array-table/theme");
+var _hoistStatics = require("./hoistStatics");
+var _react2 = _interopRequireWildcard(require("react"));
+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; }
+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 的列定义，避免 AgGridPlus 的原值渲染器覆盖格式化结果。@author nokecy */
+var ReadingArrayTable = (0, _react.observer)(function (_ref) {
+  var _buildArrayTableColum;
+  var height = _ref.height;
+  var field = (0, _react.useField)();
+  var sources = (0, _utils.useArrayTableSources)();
+  var rows = Array.isArray(field.value) ? field.value.slice() : [];
+  var generatedRowIds = (0, _react2.useRef)(new WeakMap());
+  var generatedRowIdSequence = (0, _react2.useRef)(0);
+  var columns = (_buildArrayTableColum = (0, _utils.buildArrayTableColumns)(rows, field, sources)) !== null && _buildArrayTableColum !== void 0 ? _buildArrayTableColum : [];
+  var showIndex = columns.length > 0 && !(0, _indexColumn.hasOwnIndexColumn)(sources);
+  if (showIndex) columns.unshift((0, _indexColumn.makeIndexColumn)());
+  var theme = (0, _theme.useArrayTableTheme)();
+  return /*#__PURE__*/_react2.default.createElement("div", {
+    style: {
+      height: height !== null && height !== void 0 ? height : 400
+    }
+  }, /*#__PURE__*/_react2.default.createElement(_agGridReact.AgGridReact, {
+    theme: theme,
+    rowHeight: _theme.ARRAY_TABLE_ROW_HEIGHT,
+    enableCellTextSelection: true,
+    ensureDomOrder: true,
+    defaultColDef: {
+      resizable: true,
+      sortable: true,
+      filter: true
+    },
+    rowSelection: {
+      mode: 'singleRow',
+      enableClickSelection: true
+    },
+    selectionColumnDef: {
+      pinned: 'left',
+      lockPosition: true,
+      width: 50,
+      suppressHeaderMenuButton: true
+    },
+    columnDefs: (0, _columnGroup.groupColumnDefs)(columns),
+    rowData: rows,
+    getRowId: function getRowId(_ref2) {
+      var _data$_id;
+      var data = _ref2.data;
+      var id = (_data$_id = data === null || data === void 0 ? void 0 : data._id) !== null && _data$_id !== void 0 ? _data$_id : data === null || data === void 0 ? void 0 : data.id;
+      if (id != null) return "data:".concat(String(id));
+
+      // 阅读态明细常用旧表行号等字段，不一定有 id/_id。给无 ID 的对象分配稳定行键，
+      // 否则多行都会返回 "undefined"，AG Grid 在数据更新后会合并掉重复行。@author nokecy
+      var row = data;
+      var rowId = generatedRowIds.current.get(row);
+      if (!rowId) {
+        rowId = "generated:".concat(++generatedRowIdSequence.current);
+        generatedRowIds.current.set(row, rowId);
+      }
+      return rowId;
+    },
+    onRowDataUpdated: function onRowDataUpdated(_ref3) {
+      var api = _ref3.api;
+      if (showIndex) api.refreshCells({
+        columns: [_indexColumn.ARRAY_TABLE_INDEX_FIELD],
+        force: true
+      });
+    }
+  }));
+});
+
+/** 按 ArrayTable 的列提取规则收集列节点，不挂载明细数据字段。@author nokecy */
+var columnsOf = function columnsOf(schema) {
+  var columns = [];
+  var visit = function visit(node) {
+    if (typeof node['x-component'] === 'string' && node['x-component'].includes('Column')) {
+      var _node$xComponentPro, _node$xComponentPro2;
+      var name = (_node$xComponentPro = (_node$xComponentPro2 = node['x-component-props']) === null || _node$xComponentPro2 === void 0 ? void 0 : _node$xComponentPro2.dataIndex) !== null && _node$xComponentPro !== void 0 ? _node$xComponentPro : node.name;
+      if (name !== undefined) columns.push({
+        name: name,
+        schema: node
+      });
+    } else {
+      Object.values(node.properties || {}).forEach(visit);
+    }
+  };
+  var items = Array.isArray(schema.items) ? schema.items : schema.items ? [schema.items] : [];
+  items.forEach(visit);
+  return columns;
+};
+
+/**
+ * 阅读态也创建列的 void 字段，让 Formily 求值标题、显隐与 reactions；
+ * qc-ui 的阅读视图只读取列状态，未像编辑视图一样挂载这些字段。
+ * @author nokecy
+ */
+var withReadingArrayTable = exports.withReadingArrayTable = function withReadingArrayTable(Control) {
+  var ReactiveTable = (0, _react.observer)(function (_ref4) {
+    var columns = _ref4.columns,
+      tableProps = _ref4.tableProps;
+    var field = (0, _react.useField)();
+    // 阅读视图本身未订阅列状态，在此建立依赖，条件变化后重新提取表头。@author nokecy
+    var _iterator = _createForOfIteratorHelper(columns),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var _column$componentProp, _column$componentProp2, _column$componentProp3;
+        var name = _step.value.name;
+        var column = field.query(field.address.concat(name)).take();
+        void (column === null || column === void 0 ? void 0 : column.display);
+        void (column === null || column === void 0 || (_column$componentProp = column.componentProps) === null || _column$componentProp === void 0 ? void 0 : _column$componentProp.title);
+        void (column === null || column === void 0 || (_column$componentProp2 = column.componentProps) === null || _column$componentProp2 === void 0 ? void 0 : _column$componentProp2.headerName);
+        void (column === null || column === void 0 || (_column$componentProp3 = column.componentProps) === null || _column$componentProp3 === void 0 ? void 0 : _column$componentProp3.headerGroup);
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+    return /*#__PURE__*/_react2.default.createElement(ReadingArrayTable, tableProps);
+  });
+  var Table = (0, _react.observer)(function (props) {
+    var field = (0, _react.useField)();
+    var schema = (0, _react.useFieldSchema)();
+    var columns = (0, _react2.useMemo)(function () {
+      return columnsOf(schema);
+    }, [schema]);
+    if (field.pattern !== 'readPretty') return /*#__PURE__*/_react2.default.createElement(Control, props);
+    return /*#__PURE__*/_react2.default.createElement(_react2.default.Fragment, null, columns.map(function (column) {
+      return /*#__PURE__*/_react2.default.createElement(_react.RecursionField, {
+        key: column.name,
+        name: column.name,
+        schema: column.schema,
+        onlyRenderSelf: true
+      });
+    }), /*#__PURE__*/_react2.default.createElement(ReactiveTable, {
+      columns: columns,
+      tableProps: props
+    }));
+  });
+  return (0, _hoistStatics.hoistStatics)(Table, Control);
+};

package/dist/cjs/readPretty/controls.d.ts

@@ -0,0 +1,11 @@
+import { Input as AntInput, InputNumber as AntInputNumber, Select as AntSelect, Switch as AntSwitch, Checkbox as AntCheckbox, Radio as AntRadio, DatePicker as AntDatePicker, TimePicker as AntTimePicker, TreeSelect as AntTreeSelect, Cascader as AntCascader } from 'antd';
+export declare const Input: typeof AntInput;
+export declare const InputNumber: typeof AntInputNumber;
+export declare const Select: typeof AntSelect;
+export declare const Switch: typeof AntSwitch;
+export declare const Checkbox: typeof AntCheckbox;
+export declare const Radio: typeof AntRadio;
+export declare const DatePicker: typeof AntDatePicker;
+export declare const TimePicker: typeof AntTimePicker;
+export declare const TreeSelect: typeof AntTreeSelect;
+export declare const Cascader: typeof AntCascader;

package/dist/cjs/readPretty/controls.js

@@ -0,0 +1,68 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TreeSelect = exports.TimePicker = exports.Switch = exports.Select = exports.Radio = exports.InputNumber = exports.Input = exports.DatePicker = exports.Checkbox = exports.Cascader = void 0;
+var _antdV = require("@formily/antd-v5");
+var _antd = require("antd");
+var _react = _interopRequireDefault(require("react"));
+var _hoistStatics = require("./hoistStatics");
+var _values = require("./values");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+/** 普通表单控件在不可编辑时使用阅读展示，继承整张表单的禁用状态。@author nokecy */
+var readingControl = function readingControl(Control, Preview) {
+  var map = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : function (props) {
+    return props;
+  };
+  var Component = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
+    var _props$disabled;
+    var _ConfigProvider$useCo = _antd.ConfigProvider.useConfig(),
+      componentDisabled = _ConfigProvider$useCo.componentDisabled;
+    var reading = props.readOnly || ((_props$disabled = props.disabled) !== null && _props$disabled !== void 0 ? _props$disabled : componentDisabled);
+    return reading ? /*#__PURE__*/_react.default.createElement(_antdV.PreviewText.Placeholder, {
+      value: "\u2014"
+    }, /*#__PURE__*/_react.default.createElement(Preview, map(props))) : /*#__PURE__*/_react.default.createElement(Control, _extends({}, props, {
+      ref: ref
+    }));
+  });
+  return (0, _hoistStatics.hoistStatics)(Component, Control);
+};
+
+/** 选择项来自 options 或原生 Option/Radio 子节点，阅读态显示名称。@author nokecy */
+var choiceOptions = function choiceOptions(props) {
+  return props.options || _react.default.Children.toArray(props.children).flatMap(function (child) {
+    var _child$props;
+    return ((_child$props = child.props) === null || _child$props === void 0 ? void 0 : _child$props.value) !== undefined ? [{
+      value: child.props.value,
+      label: child.props.children
+    }] : choiceOptions(child.props || {});
+  });
+};
+var ChoicePreview = function ChoicePreview(props) {
+  return /*#__PURE__*/_react.default.createElement("span", null, (0, _values.selectedLabels)(props.value, (0, _values.flattenOptions)(choiceOptions(props), props.fieldNames), props.labelInValue));
+};
+var BooleanPreview = function BooleanPreview(props) {
+  return /*#__PURE__*/_react.default.createElement("span", null, props.children, props.children ? '：' : '', props.checked == null ? '—' : props.checked ? '是' : '否');
+};
+var PasswordPreview = function PasswordPreview(props) {
+  return /*#__PURE__*/_react.default.createElement("span", null, props.value ? '••••••' : '—');
+};
+var Input = exports.Input = readingControl(_antd.Input, _antdV.PreviewText.Input);
+Input.TextArea = readingControl(_antd.Input.TextArea, _antdV.PreviewText.Input);
+Input.Password = readingControl(_antd.Input.Password, PasswordPreview);
+Input.Search = readingControl(_antd.Input.Search, _antdV.PreviewText.Input);
+var InputNumber = exports.InputNumber = readingControl(_antd.InputNumber, _antdV.PreviewText.NumberPicker);
+var Select = exports.Select = readingControl(_antd.Select, ChoicePreview);
+var Switch = exports.Switch = readingControl(_antd.Switch, BooleanPreview);
+var Checkbox = exports.Checkbox = readingControl(_antd.Checkbox, BooleanPreview);
+Checkbox.Group = readingControl(_antd.Checkbox.Group, ChoicePreview);
+var Radio = exports.Radio = readingControl(_antd.Radio, BooleanPreview);
+Radio.Group = readingControl(_antd.Radio.Group, ChoicePreview);
+var DatePicker = exports.DatePicker = readingControl(_antd.DatePicker, _antdV.PreviewText.DatePicker);
+DatePicker.RangePicker = readingControl(_antd.DatePicker.RangePicker, _antdV.PreviewText.DateRangePicker);
+var TimePicker = exports.TimePicker = readingControl(_antd.TimePicker, _antdV.PreviewText.TimePicker);
+TimePicker.RangePicker = readingControl(_antd.TimePicker.RangePicker, _antdV.PreviewText.TimeRangePicker);
+var TreeSelect = exports.TreeSelect = readingControl(_antd.TreeSelect, _antdV.PreviewText.TreeSelect);
+var Cascader = exports.Cascader = readingControl(_antd.Cascader, _antdV.PreviewText.Cascader);

package/dist/cjs/readPretty/decimal.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+/** 精确业务数值录入和阅读展示，零值与原始十进制字符串始终保留。@author nokecy */
+export declare const DecimalInput: React.ForwardRefExoticComponent<Omit<any, "ref"> & React.RefAttributes<any>>;
+export declare const DecimalPicker: React.ForwardRefExoticComponent<Omit<Partial<Omit<any, "ref"> & React.RefAttributes<any>>, "ref"> & React.RefAttributes<unknown>>;

package/dist/cjs/readPretty/decimal.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DecimalPicker = exports.DecimalInput = void 0;
+var _react = require("@formily/react");
+var _react2 = _interopRequireDefault(require("react"));
+var _controls = require("./controls");
+var _businessDecimal = require("../utils/businessDecimal");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+/** 精确业务数值录入和阅读展示，零值与原始十进制字符串始终保留。@author nokecy */
+var DecimalInput = exports.DecimalInput = /*#__PURE__*/_react2.default.forwardRef(function (props, ref) {
+  return /*#__PURE__*/_react2.default.createElement(_controls.InputNumber, _extends({}, props, {
+    stringMode: true,
+    ref: ref
+  }));
+});
+var DecimalPreview = function DecimalPreview(_ref) {
+  var value = _ref.value,
+    formatter = _ref.formatter;
+  return /*#__PURE__*/_react2.default.createElement("span", null, value == null || value === '' ? '—' : formatter ? formatter(value, {
+    userTyping: false,
+    input: String(value)
+  }) : (0, _businessDecimal.decimalText)(value));
+};
+var DecimalPicker = exports.DecimalPicker = (0, _react.connect)(DecimalInput, (0, _react.mapReadPretty)(DecimalPreview));

package/dist/cjs/readPretty/formily.d.ts

@@ -0,0 +1,2 @@
+/** 动态表单统一入口：禁用/只读的数据控件使用阅读展示，保持字段值和校验模型。@author nokecy */
+export declare function withReadingFields(components: Record<string, any>): Record<string, any>;