@nokecy/qc-ui 1.1.74 → 1.1.76

package/dist/esm/importModal/index.js

@@ -33,7 +33,10 @@ var ImportModal = function ImportModal(props) {
     _props$downloadBlob = props.downloadBlob,
     downloadBlob = _props$downloadBlob === void 0 ? defaultDownloadBlob : _props$downloadBlob,
     serverUrl = props.serverUrl,
-    buttonProps = props.buttonProps;
+    buttonProps = props.buttonProps,
+    request = props.request,
+    method = props.method,
+    onRealSuccess = props.onRealSuccess;
   var _useBoolean = useBoolean(false),
     _useBoolean2 = _slicedToArray(_useBoolean, 2),
     visible = _useBoolean2[0],
@@ -63,12 +66,46 @@ var ImportModal = function ImportModal(props) {
       }
     }, "\u6A21\u7248")),
     type: "info"
-  }), /*#__PURE__*/React.createElement(Upload.Dragger, {
+  }), /*#__PURE__*/React.createElement(Upload.Dragger, _extends({
     style: {
       marginTop: 10
     },
     multiple: false,
-    action: getUploadUrl(),
+    action: getUploadUrl()
+  }, request ? {
+    customRequest: function customRequest(_ref) {
+      var action = _ref.action,
+        file = _ref.file,
+        headers = _ref.headers,
+        onError = _ref.onError,
+        onProgress = _ref.onProgress,
+        onSuccess = _ref.onSuccess;
+      var formData = new FormData();
+      formData.append('file', file);
+      request(action, {
+        method: method || 'POST',
+        data: formData,
+        headers: headers,
+        // 导入失败要展示行级原因，交给下面的弹窗统一报，不再走全局吐司。
+        skipErrorHandler: true,
+        onUploadProgress: function onUploadProgress(_ref2) {
+          var total = _ref2.total,
+            loaded = _ref2.loaded;
+          onProgress === null || onProgress === void 0 || onProgress({
+            percent: Number((loaded / total * 100).toFixed(2))
+          }, file);
+        }
+      }).then(function (response) {
+        onSuccess === null || onSuccess === void 0 || onSuccess(response, file);
+        onRealSuccess === null || onRealSuccess === void 0 || onRealSuccess(response);
+      })
+      // 第二个参数成为 info.file.response，onChange 靠它拿到后端的失败原因，而不是 axios 的英文文案。
+      .catch(function (err) {
+        var _err$response;
+        return onError === null || onError === void 0 ? void 0 : onError(err, err === null || err === void 0 || (_err$response = err.response) === null || _err$response === void 0 ? void 0 : _err$response.data);
+      });
+    }
+  } : {}, {
     onChange: function onChange(info) {
       if (info.file.status === 'done') {
         message.success('导入成功');
@@ -77,15 +114,16 @@ var ImportModal = function ImportModal(props) {
       }
       if (info.file.status === 'error') {
         var _info$file;
-        Modal.info({
-          title: '导入失败,原因如下:',
+        // 没有后端给的原因时也要有提示，不能让失败无声无息。
+        Modal.error({
+          title: '导入失败',
           closable: true,
-          width: 1000,
-          content: info === null || info === void 0 || (_info$file = info.file) === null || _info$file === void 0 || (_info$file = _info$file.response) === null || _info$file === void 0 || (_info$file = _info$file.error) === null || _info$file === void 0 ? void 0 : _info$file.message
+          width: 800,
+          content: (info === null || info === void 0 || (_info$file = info.file) === null || _info$file === void 0 || (_info$file = _info$file.response) === null || _info$file === void 0 || (_info$file = _info$file.error) === null || _info$file === void 0 ? void 0 : _info$file.message) || '文件未能导入。请核对模板格式与必填列后重试；若持续失败请联系技术支持。'
         });
       }
     }
-  }, /*#__PURE__*/React.createElement("p", {
+  }), /*#__PURE__*/React.createElement("p", {
     className: "ant-upload-drag-icon"
   }, /*#__PURE__*/React.createElement(InboxOutlined, null)), /*#__PURE__*/React.createElement("p", {
     className: "ant-upload-text"

package/dist/esm/index.d.ts

@@ -31,6 +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 { default as ExportButton, buildExportUrl, DEFAULT_EXPORT_TEMPLATE_API, resolveExportAction, resolveExportError, resolveFileName } from "./exportButton";
+export type { ExportButtonProps, ExportTemplateApi, ExportTemplateOption } from "./exportButton";
+export { saveAs } from "./utils/download";
+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";

package/dist/esm/index.js

@@ -42,6 +42,10 @@ useSchemeManager, useGridSchemes, LocalStorageSchemeAdapter, BackendApiSchemeAda
 
 // 分页适配器:值 + 类型一并导出,支持非 ABP 后端注入
 export * from "./adapters";
+export * from "./readPretty";
+export { createEntitySelect } from "./entitySelect";
+export { default as ExportButton, buildExportUrl, DEFAULT_EXPORT_TEMPLATE_API, resolveExportAction, resolveExportError, resolveFileName } from "./exportButton";
+export { saveAs } from "./utils/download";
 export { semanticTextColors, toGridTextColor, gridValueEnum } 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";

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

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

package/dist/esm/readPretty/arrayTable.js

@@ -0,0 +1,147 @@
+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; }
+import { observer, RecursionField, useField, useFieldSchema } from '@formily/react';
+import { AgGridReact } from 'ag-grid-react';
+import { buildArrayTableColumns, useArrayTableSources } from "../array-table/utils";
+import { groupColumnDefs } from "../array-table/columnGroup";
+import { ARRAY_TABLE_INDEX_FIELD, hasOwnIndexColumn, makeIndexColumn } from "../array-table/indexColumn";
+import { ARRAY_TABLE_ROW_HEIGHT, useArrayTableTheme } from "../array-table/theme";
+import { hoistStatics } from "./hoistStatics";
+import React, { useMemo, useRef } from 'react';
+/** 阅读态直接使用 ArrayTable 的列定义，避免 AgGridPlus 的原值渲染器覆盖格式化结果。@author nokecy */
+var ReadingArrayTable = observer(function (_ref) {
+  var _buildArrayTableColum;
+  var height = _ref.height;
+  var field = useField();
+  var sources = useArrayTableSources();
+  var rows = Array.isArray(field.value) ? field.value.slice() : [];
+  var generatedRowIds = useRef(new WeakMap());
+  var generatedRowIdSequence = useRef(0);
+  var columns = (_buildArrayTableColum = buildArrayTableColumns(rows, field, sources)) !== null && _buildArrayTableColum !== void 0 ? _buildArrayTableColum : [];
+  var showIndex = columns.length > 0 && !hasOwnIndexColumn(sources);
+  if (showIndex) columns.unshift(makeIndexColumn());
+  var theme = useArrayTableTheme();
+  return /*#__PURE__*/React.createElement("div", {
+    style: {
+      height: height !== null && height !== void 0 ? height : 400
+    }
+  }, /*#__PURE__*/React.createElement(AgGridReact, {
+    theme: theme,
+    rowHeight: 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: 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: [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
+ */
+export var withReadingArrayTable = function withReadingArrayTable(Control) {
+  var ReactiveTable = observer(function (_ref4) {
+    var columns = _ref4.columns,
+      tableProps = _ref4.tableProps;
+    var field = 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__*/React.createElement(ReadingArrayTable, tableProps);
+  });
+  var Table = observer(function (props) {
+    var field = useField();
+    var schema = useFieldSchema();
+    var columns = useMemo(function () {
+      return columnsOf(schema);
+    }, [schema]);
+    if (field.pattern !== 'readPretty') return /*#__PURE__*/React.createElement(Control, props);
+    return /*#__PURE__*/React.createElement(React.Fragment, null, columns.map(function (column) {
+      return /*#__PURE__*/React.createElement(RecursionField, {
+        key: column.name,
+        name: column.name,
+        schema: column.schema,
+        onlyRenderSelf: true
+      });
+    }), /*#__PURE__*/React.createElement(ReactiveTable, {
+      columns: columns,
+      tableProps: props
+    }));
+  });
+  return hoistStatics(Table, Control);
+};

package/dist/esm/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/esm/readPretty/controls.js

@@ -0,0 +1,62 @@
+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); }
+import { PreviewText } from '@formily/antd-v5';
+import { ConfigProvider, 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';
+import React from 'react';
+import { hoistStatics } from "./hoistStatics";
+import { flattenOptions, selectedLabels } from "./values";
+
+/** 普通表单控件在不可编辑时使用阅读展示，继承整张表单的禁用状态。@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.forwardRef(function (props, ref) {
+    var _props$disabled;
+    var _ConfigProvider$useCo = 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.createElement(PreviewText.Placeholder, {
+      value: "\u2014"
+    }, /*#__PURE__*/React.createElement(Preview, map(props))) : /*#__PURE__*/React.createElement(Control, _extends({}, props, {
+      ref: ref
+    }));
+  });
+  return hoistStatics(Component, Control);
+};
+
+/** 选择项来自 options 或原生 Option/Radio 子节点，阅读态显示名称。@author nokecy */
+var choiceOptions = function choiceOptions(props) {
+  return props.options || React.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.createElement("span", null, selectedLabels(props.value, flattenOptions(choiceOptions(props), props.fieldNames), props.labelInValue));
+};
+var BooleanPreview = function BooleanPreview(props) {
+  return /*#__PURE__*/React.createElement("span", null, props.children, props.children ? '：' : '', props.checked == null ? '—' : props.checked ? '是' : '否');
+};
+var PasswordPreview = function PasswordPreview(props) {
+  return /*#__PURE__*/React.createElement("span", null, props.value ? '••••••' : '—');
+};
+export var Input = readingControl(AntInput, PreviewText.Input);
+Input.TextArea = readingControl(AntInput.TextArea, PreviewText.Input);
+Input.Password = readingControl(AntInput.Password, PasswordPreview);
+Input.Search = readingControl(AntInput.Search, PreviewText.Input);
+export var InputNumber = readingControl(AntInputNumber, PreviewText.NumberPicker);
+export var Select = readingControl(AntSelect, ChoicePreview);
+export var Switch = readingControl(AntSwitch, BooleanPreview);
+export var Checkbox = readingControl(AntCheckbox, BooleanPreview);
+Checkbox.Group = readingControl(AntCheckbox.Group, ChoicePreview);
+export var Radio = readingControl(AntRadio, BooleanPreview);
+Radio.Group = readingControl(AntRadio.Group, ChoicePreview);
+export var DatePicker = readingControl(AntDatePicker, PreviewText.DatePicker);
+DatePicker.RangePicker = readingControl(AntDatePicker.RangePicker, PreviewText.DateRangePicker);
+export var TimePicker = readingControl(AntTimePicker, PreviewText.TimePicker);
+TimePicker.RangePicker = readingControl(AntTimePicker.RangePicker, PreviewText.TimeRangePicker);
+export var TreeSelect = readingControl(AntTreeSelect, PreviewText.TreeSelect);
+export var Cascader = readingControl(AntCascader, PreviewText.Cascader);

package/dist/esm/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/esm/readPretty/decimal.js

@@ -0,0 +1,22 @@
+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); }
+import { connect, mapReadPretty } from '@formily/react';
+import React from 'react';
+import { InputNumber } from "./controls";
+import { decimalText } from "../utils/businessDecimal";
+
+/** 精确业务数值录入和阅读展示，零值与原始十进制字符串始终保留。@author nokecy */
+export var DecimalInput = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  return /*#__PURE__*/React.createElement(InputNumber, _extends({}, props, {
+    stringMode: true,
+    ref: ref
+  }));
+});
+var DecimalPreview = function DecimalPreview(_ref) {
+  var value = _ref.value,
+    formatter = _ref.formatter;
+  return /*#__PURE__*/React.createElement("span", null, value == null || value === '' ? '—' : formatter ? formatter(value, {
+    userTyping: false,
+    input: String(value)
+  }) : decimalText(value));
+};
+export var DecimalPicker = connect(DecimalInput, mapReadPretty(DecimalPreview));

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

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

package/dist/esm/readPretty/formily.js

@@ -0,0 +1,63 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+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 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); }
+import { observer, useField } from '@formily/react';
+import React from 'react';
+import { hoistStatics } from "./hoistStatics";
+import * as Reading from "./controls";
+import { withReadingArrayTable } from "./arrayTable";
+
+/** 动态表单统一入口：禁用/只读的数据控件使用阅读展示，保持字段值和校验模型。@author nokecy */
+export function withReadingFields(components) {
+  var result = _objectSpread({}, components);
+  var previews = _objectSpread(_objectSpread({}, Reading), {}, {
+    NumberPicker: Reading.InputNumber,
+    Password: Reading.Input.Password
+  });
+  var wrap = function wrap(Control, Preview) {
+    var Component = observer(function (props) {
+      var field = useField();
+      if (props.disabled || props.readOnly || field !== null && field !== void 0 && field.disabled || field !== null && field !== void 0 && field.readOnly) {
+        var _field$value, _field$value2, _field$dataSource;
+        return /*#__PURE__*/React.createElement(Preview, _extends({}, props, {
+          value: (_field$value = field === null || field === void 0 ? void 0 : field.value) !== null && _field$value !== void 0 ? _field$value : props.value,
+          checked: (_field$value2 = field === null || field === void 0 ? void 0 : field.value) !== null && _field$value2 !== void 0 ? _field$value2 : props.checked,
+          options: field !== null && field !== void 0 && (_field$dataSource = field.dataSource) !== null && _field$dataSource !== void 0 && _field$dataSource.length ? field.dataSource : props.options,
+          disabled: true
+        }));
+      }
+      return /*#__PURE__*/React.createElement(Control, props);
+    });
+    var Wrapped = hoistStatics(Component, Control);
+    // 嵌套控件同样按字段状态展示，例如Input.TextArea、DatePicker.RangePicker。
+    for (var _i = 0, _arr = ['TextArea', 'Password', 'Search', 'Group', 'RangePicker']; _i < _arr.length; _i++) {
+      var key = _arr[_i];
+      if (Control[key] && Preview[key]) Wrapped[key] = wrap(Control[key], Preview[key]);
+    }
+    return Wrapped;
+  };
+  var _iterator = _createForOfIteratorHelper(Object.keys(previews).filter(function (name) {
+      return components[name];
+    })),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var name = _step.value;
+      result[name] = wrap(components[name], previews[name]);
+    }
+    // ArrayTable 阅读态保留动态列的标题和显隐状态。@author nokecy
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  if (components.ArrayTable) result.ArrayTable = withReadingArrayTable(components.ArrayTable);
+  return result;
+}

package/dist/esm/readPretty/hoistStatics.d.ts

@@ -0,0 +1 @@
+export declare function hoistStatics<T, S>(target: T, source: S): T & S;

package/dist/esm/readPretty/hoistStatics.js

@@ -0,0 +1,31 @@
+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; }
+/**
+ * 把被包装组件的静态成员（如 Input.TextArea、Select.Option）带到包装后的组件上，
+ * 等价于 hoist-non-react-statics，但不新增依赖。React 自有的静态属性不拷贝。
+ * @author nokecy
+ */
+var REACT_STATICS = new Set(['$$typeof', 'render', 'defaultProps', 'displayName', 'propTypes', 'contextType', 'contextTypes', 'childContextTypes', 'getDefaultProps', 'getDerivedStateFromProps', 'getDerivedStateFromError', 'mixins', 'type', 'compare', 'length', 'name', 'prototype', 'caller', 'callee', 'arguments', 'arity']);
+export function hoistStatics(target, source) {
+  var _iterator = _createForOfIteratorHelper(Reflect.ownKeys(source)),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var key = _step.value;
+      if (REACT_STATICS.has(key)) continue;
+      var descriptor = Object.getOwnPropertyDescriptor(source, key);
+      if (!descriptor) continue;
+      try {
+        Object.defineProperty(target, key, descriptor);
+      } catch (_unused) {
+        // 个别只读属性无法重定义，跳过即可。
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return target;
+}

package/dist/esm/readPretty/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 阅读态控件：不可编辑时展示名称/文本而不是禁用的输入框，继承整张表单的禁用状态。
+ * 动态表单入口 `withReadingFields` 按字段的 disabled/readOnly 状态切换阅读展示，并保留 ArrayTable 动态列。
+ * @author nokecy
+ */
+export * as ReadPrettyControls from './controls';
+export { withReadingFields } from './formily';
+export { withReadingArrayTable } from './arrayTable';
+export { DecimalInput, DecimalPicker } from './decimal';
+export { flattenOptions, selectedLabels } from './values';
+export { normalizeSelectValue, selectCode, selectLabel } from './selectValue';

package/dist/esm/readPretty/index.js

@@ -0,0 +1,12 @@
+/**
+ * 阅读态控件：不可编辑时展示名称/文本而不是禁用的输入框，继承整张表单的禁用状态。
+ * 动态表单入口 `withReadingFields` 按字段的 disabled/readOnly 状态切换阅读展示，并保留 ArrayTable 动态列。
+ * @author nokecy
+ */
+import * as _ReadPrettyControls from "./controls";
+export { _ReadPrettyControls as ReadPrettyControls };
+export { withReadingFields } from "./formily";
+export { withReadingArrayTable } from "./arrayTable";
+export { DecimalInput, DecimalPicker } from "./decimal";
+export { flattenOptions, selectedLabels } from "./values";
+export { normalizeSelectValue, selectCode, selectLabel } from "./selectValue";

package/dist/esm/readPretty/selectValue.d.ts

@@ -0,0 +1,7 @@
+import { type ReactNode } from 'react';
+/** 提取选择项的标量编码，兼容嵌套 labelInValue；保留编码 0 和显式空字符串选项。@author nokecy */
+export declare function selectCode(value: unknown, depth?: number): string | number | undefined;
+/** 标签只输出可渲染内容；选择项对象取名称后再回落编码，避免 React 对象子节点异常。@author nokecy */
+export declare function selectLabel(value: unknown, depth?: number): ReactNode;
+/** 单选、多选与阅读态共用同一值形状；名称缺省时保留组件按选项查名称的行为。@author nokecy */
+export declare function normalizeSelectValue(value: unknown, labelInValue?: boolean): any;

package/dist/esm/readPretty/selectValue.js

@@ -0,0 +1,53 @@
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+import { isValidElement } from 'react';
+
+/** 提取选择项的标量编码，兼容嵌套 labelInValue；保留编码 0 和显式空字符串选项。@author nokecy */
+export function selectCode(value) {
+  var depth = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  if (typeof value === 'string') return value;
+  if (typeof value === 'number') return Number.isFinite(value) ? value : undefined;
+  if (!value || _typeof(value) !== 'object' || depth >= 8 || /*#__PURE__*/isValidElement(value)) return undefined;
+  return selectCode(value.value, depth + 1);
+}
+
+/** 标签只输出可渲染内容；选择项对象取名称后再回落编码，避免 React 对象子节点异常。@author nokecy */
+export function selectLabel(value) {
+  var _selectLabel;
+  var depth = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  if (value == null || typeof value === 'boolean' || depth >= 8) return undefined;
+  if (typeof value === 'string' || typeof value === 'number' || /*#__PURE__*/isValidElement(value)) return value;
+  if (Array.isArray(value)) return value.map(function (item) {
+    return selectLabel(item, depth + 1);
+  });
+  if (_typeof(value) !== 'object') return undefined;
+  var item = value;
+  return (_selectLabel = selectLabel(item.label, depth + 1)) !== null && _selectLabel !== void 0 ? _selectLabel : selectLabel(item.value, depth + 1);
+}
+
+/** 单选、多选与阅读态共用同一值形状；名称缺省时保留组件按选项查名称的行为。@author nokecy */
+export function normalizeSelectValue(value, labelInValue) {
+  var _selectLabel2;
+  if (Array.isArray(value)) return value.map(function (item) {
+    return normalizeSelectValue(item, labelInValue);
+  }).filter(function (item) {
+    return item !== undefined;
+  });
+  var code = selectCode(value);
+  if (code === undefined) return undefined;
+  if (!labelInValue) return code;
+  if (!value || _typeof(value) !== 'object') return {
+    value: code
+  };
+  var item = value;
+  var label = (_selectLabel2 = selectLabel(item.label)) !== null && _selectLabel2 !== void 0 ? _selectLabel2 : _typeof(item.value) === 'object' ? selectLabel(item.value) : undefined;
+  return _objectSpread({
+    value: code
+  }, label !== undefined ? {
+    label: label
+  } : {});
+}

package/dist/esm/readPretty/values.d.ts

@@ -0,0 +1,4 @@
+/** 阅读态选择项展开，保留分组内选项及自定义字段名。@author nokecy */
+export declare function flattenOptions(options?: any[], fieldNames?: any): any[];
+/** 保留0和空选项标签；有 labelInValue 时优先使用已加载的名称。@author nokecy */
+export declare function selectedLabels(value: any, options: any[], labelInValue?: boolean): any;

package/dist/esm/readPretty/values.js

@@ -0,0 +1,43 @@
+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); }
+import { normalizeSelectValue, selectLabel } from "./selectValue";
+
+/** 阅读态选择项展开，保留分组内选项及自定义字段名。@author nokecy */
+export function flattenOptions() {
+  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var fieldNames = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var _ref = fieldNames || {},
+    _ref$label = _ref.label,
+    label = _ref$label === void 0 ? 'label' : _ref$label,
+    _ref$value = _ref.value,
+    value = _ref$value === void 0 ? 'value' : _ref$value,
+    _ref$options = _ref.options,
+    children = _ref$options === void 0 ? 'options' : _ref$options;
+  return options.flatMap(function (option) {
+    return _typeof(option) === 'object' && option !== null ? option[children] ? flattenOptions(option[children], fieldNames) : [{
+      value: option[value],
+      label: option[label]
+    }] : [{
+      value: option,
+      label: option
+    }];
+  });
+}
+
+/** 保留0和空选项标签；有 labelInValue 时优先使用已加载的名称。@author nokecy */
+export function selectedLabels(value, options, labelInValue) {
+  if (value == null || value === '' || Array.isArray(value) && !value.length) return '—';
+  var normalized = labelInValue ? normalizeSelectValue(value, true) : value;
+  var values = Array.isArray(normalized) ? normalized : normalized == null ? [] : [normalized];
+  if (!values.length) return '—';
+  var labels = values.map(function (item) {
+    var _ref2, _selectLabel, _options$find, _item$label;
+    var raw = labelInValue ? item.value : item;
+    return (_ref2 = (_selectLabel = selectLabel((_options$find = options.find(function (option) {
+      return option.value === raw;
+    })) === null || _options$find === void 0 ? void 0 : _options$find.label)) !== null && _selectLabel !== void 0 ? _selectLabel : selectLabel(labelInValue ? (_item$label = item.label) !== null && _item$label !== void 0 ? _item$label : raw : raw)) !== null && _ref2 !== void 0 ? _ref2 : '—';
+  });
+  // 选项标签可以是React节点，交由调用组件按顺序渲染。
+  return labels.flatMap(function (label, index) {
+    return index ? ['、', label] : [label];
+  });
+}

package/dist/esm/utils/download.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 把 Blob 存成本地文件。
+ *
+ * @author nokecy
+ */
+export declare const saveAs: (blob: Blob, filename: string) => void;