@nokecy/qc-ui 1.1.73 → 1.1.75

package/dist/esm/entitySelect/index.js

@@ -0,0 +1,164 @@
+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; }
+import DialogSelect from "../dialogSelect";
+import { useControllableValue, useRequest } from 'ahooks';
+import { Select as AntSelect } from 'antd';
+import React, { useRef } from 'react';
+var Option = AntSelect.Option;
+
+/**
+ * 实体选择器的骨架。
+ *
+ * 各业务模块的实体选择器（线体、车间、物料、供应商……）此前是逐个复制出来的：
+ * 取数、防抖、受控值、下拉即查、labelInValue、弹窗表格列，每份各写一遍，
+ * 真正不同的只有请求函数、提示语和表格列。骨架收在这里，各模块只填自己的那几项。
+ *
+ * 骨架不认识任何业务契约：请求函数由调用方传入，不引用任何生成服务客户端。
+ *
+ * @author nokecy
+ */
+
+/** 取数入参：与后端分页查询约定一致。 */
+
+var 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 = useRef();
+    var _useControllableValue = useControllableValue(props),
+      _useControllableValue2 = _slicedToArray(_useControllableValue, 2),
+      state = _useControllableValue2[0],
+      setState = _useControllableValue2[1];
+    var _useRequest = 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.createElement("span", {
+      ref: ref,
+      style: {
+        display: 'block',
+        width: '100%',
+        minWidth: 0,
+        maxWidth: '100%'
+      }
+    }, /*#__PURE__*/React.createElement(DialogSelect, _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.createElement(Option, {
+        key: (_item$id = item.id) !== null && _item$id !== void 0 ? _item$id : item[resolvedValueField],
+        value: item[resolvedValueField]
+      }, renderOptionLabel(item));
+    })));
+  };
+  return /*#__PURE__*/React.forwardRef(EntitySelect);
+};
+export { createEntitySelect };
+export default createEntitySelect;

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

@@ -42,5 +42,10 @@ useSchemeManager, useGridSchemes, LocalStorageSchemeAdapter, BackendApiSchemeAda
 
 // 分页适配器:值 + 类型一并导出,支持非 ABP 后端注入
 export * from "./adapters";
+export * from "./readPretty";
+export { createEntitySelect } from "./entitySelect";
+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";
 
 // RegexEditor 类型定义 - 使用命名导出避免冲突

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;