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

package/dist/esm/readPretty/arrayTable.js

@@ -0,0 +1,172 @@
+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 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, RecursionField, useField, useFieldSchema } from '@nokecy/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';
+import { installDisplaySequenceOrder } from "../shared/gridSequence";
+
+/** 阅读态直接使用 ArrayTable 的列定义，避免 AgGridPlus 的原值渲染器覆盖格式化结果。@author nokecy */
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var ReadingArrayTable = observer(function (_ref) {
+  var _buildArrayTableColum;
+  var height = _ref.height,
+    _ref$rowSelection = _ref.rowSelection,
+    rowSelection = _ref$rowSelection === void 0 ? {
+      mode: 'singleRow',
+      enableClickSelection: true,
+      checkboxes: false
+    } : _ref$rowSelection,
+    selectionColumnDef = _ref.selectionColumnDef,
+    onSelectionChanged = _ref.onSelectionChanged,
+    _onGridReady = _ref.onGridReady,
+    _onRowDataUpdated = _ref.onRowDataUpdated;
+  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__*/_jsx("div", {
+    style: {
+      height: height !== null && height !== void 0 ? height : 400
+    },
+    children: /*#__PURE__*/_jsx(AgGridReact, {
+      theme: theme,
+      rowHeight: ARRAY_TABLE_ROW_HEIGHT,
+      enableCellTextSelection: true,
+      ensureDomOrder: true,
+      defaultColDef: {
+        resizable: true,
+        sortable: true,
+        filter: true
+      },
+      rowSelection: rowSelection,
+      selectionColumnDef: _objectSpread({
+        pinned: 'left',
+        lockPosition: true,
+        width: 50,
+        suppressHeaderMenuButton: true
+      }, selectionColumnDef),
+      onSelectionChanged: onSelectionChanged,
+      onGridReady: function onGridReady(event) {
+        installDisplaySequenceOrder(event.api);
+        _onGridReady === null || _onGridReady === void 0 || _onGridReady(event);
+      },
+      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(event) {
+        if (showIndex) event.api.refreshCells({
+          columns: [ARRAY_TABLE_INDEX_FIELD],
+          force: true
+        });
+        _onRowDataUpdated === null || _onRowDataUpdated === void 0 || _onRowDataUpdated(event);
+      }
+    })
+  });
+});
+
+/** 按 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 (_ref3) {
+    var columns = _ref3.columns,
+      tableProps = _ref3.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__*/_jsx(ReadingArrayTable, _objectSpread({}, 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__*/_jsx(Control, _objectSpread({}, props));
+    return /*#__PURE__*/_jsxs(_Fragment, {
+      children: [columns.map(function (column) {
+        return /*#__PURE__*/_jsx(RecursionField, {
+          name: column.name,
+          schema: column.schema,
+          onlyRenderSelf: true
+        }, column.name);
+      }), /*#__PURE__*/_jsx(ReactiveTable, {
+        columns: columns,
+        tableProps: props
+      })]
+    });
+  });
+  return hoistStatics(Table, Control);
+};

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

@@ -0,0 +1,16 @@
+import { NumberPicker as FormilyNumberPicker } from '@nokecy/formily-antd';
+import { AutoComplete as AntAutoComplete, 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;
+/** Formily 数值控件同样关闭方向键步进，保留数值类型及原有表单绑定。@author nokecy */
+export declare const NumberPicker: typeof FormilyNumberPicker;
+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;
+/** 可手输也可从候选里选的文本（Formily 适配包里没有）：值就是字符串，阅读态按文本显示。@author nokecy */
+export declare const AutoComplete: typeof AntAutoComplete;

package/dist/esm/readPretty/controls.js

@@ -0,0 +1,111 @@
+var _excluded = ["value", "formatter"];
+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 _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+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 { PreviewText } from '@nokecy/formily-antd';
+import { AutoComplete as AntAutoComplete, 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 { connect, mapReadPretty } from '@nokecy/formily-react';
+import { hoistStatics } from "./hoistStatics";
+import { selectNumberInputTextOnClick } from "./selectNumberInputTextOnClick";
+import { flattenOptions, selectedLabels } from "./values";
+import { matchSelectDisplayValue } from "./selectValue";
+
+/** 普通表单控件统一阅读展示；数值控件禁用方向键步进，让表格负责上下导航。@author nokecy */
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var readingControl = function readingControl(Control, Preview) {
+  var map = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : function (props) {
+    return props;
+  };
+  var numericInput = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+  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__*/_jsx(PreviewText.Placeholder, {
+      value: "\u2014",
+      children: /*#__PURE__*/_jsx(Preview, _objectSpread({}, map(props)))
+    }) : /*#__PURE__*/_jsx(Control, _objectSpread(_objectSpread(_objectSpread({}, map(props)), numericInput ? {
+      keyboard: false,
+      onClick: selectNumberInputTextOnClick(props.onClick)
+    } : {}), {}, {
+      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__*/_jsx("span", {
+    children: selectedLabels(props.value, flattenOptions(choiceOptions(props), props.fieldNames), props.labelInValue)
+  });
+};
+/** 候选值只在显示边界匹配；加载含空格的码值不会把单据标成已修改。@author nokecy */
+var choiceDisplayProps = function choiceDisplayProps(props) {
+  var options = flattenOptions(choiceOptions(props), props.fieldNames);
+  return _objectSpread(_objectSpread(_objectSpread({}, props), 'value' in props ? {
+    value: matchSelectDisplayValue(props.value, options, props.labelInValue)
+  } : {}), 'defaultValue' in props ? {
+    defaultValue: matchSelectDisplayValue(props.defaultValue, options, props.labelInValue)
+  } : {});
+};
+var BooleanPreview = function BooleanPreview(props) {
+  return /*#__PURE__*/_jsxs("span", {
+    children: [props.children, props.children ? '：' : '', props.checked == null ? '—' : props.checked ? '是' : '否']
+  });
+};
+var PasswordPreview = function PasswordPreview(props) {
+  return /*#__PURE__*/_jsx("span", {
+    children: props.value ? '••••••' : '—'
+  });
+};
+/** 可空数值先判断占位再格式化，保留精确字符串；不将空值转成 "null" / "undefined"。@author nokecy */
+var NumberPreview = function NumberPreview(_ref) {
+  var value = _ref.value,
+    formatter = _ref.formatter,
+    props = _objectWithoutProperties(_ref, _excluded);
+  return /*#__PURE__*/_jsx(PreviewText.Input, _objectSpread(_objectSpread({}, props), {}, {
+    value: value == null || value === '' ? undefined : formatter ? formatter(value, {
+      userTyping: false,
+      input: String(value)
+    }) : 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, NumberPreview, undefined, true);
+/** Formily 数值控件同样关闭方向键步进，保留数值类型及原有表单绑定。@author nokecy */
+export var NumberPicker = readingControl(connect(AntInputNumber, mapReadPretty(NumberPreview)), NumberPreview, undefined, true);
+export var Select = readingControl(AntSelect, ChoicePreview, choiceDisplayProps);
+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);
+/** 可手输也可从候选里选的文本（Formily 适配包里没有）：值就是字符串，阅读态按文本显示。@author nokecy */
+export var AutoComplete = readingControl(AntAutoComplete, PreviewText.Input);

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

@@ -0,0 +1,7 @@
+import React from 'react';
+/** 精确业务数值录入和阅读展示，零值与原始十进制字符串始终保留。@author nokecy */
+export declare const DecimalInput: React.ForwardRefExoticComponent<Omit<any, "ref"> & React.RefAttributes<any>>;
+/** 精确数值的静默态沿用自身阅读规则，允许表格按已知显示契约懒挂载。@author nokecy */
+export declare const DecimalPicker: React.ForwardRefExoticComponent<Omit<Partial<Omit<any, "ref"> & React.RefAttributes<any>>, "ref"> & React.RefAttributes<any>> & {
+    readOnlyFormatter: import("../array-table/readOnlyFormatters").ReadOnlyFormatter;
+};

package/dist/esm/readPretty/decimal.js

@@ -0,0 +1,40 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { connect, mapReadPretty } from '@nokecy/formily-react';
+import React from 'react';
+import { InputNumber } from "./controls";
+import { decimalText } from "../shared/businessDecimal";
+import { withReadOnlyFormatter } from "../array-table/readOnlyFormatters";
+
+/** 精确业务数值录入和阅读展示，零值与原始十进制字符串始终保留。@author nokecy */
+import { jsx as _jsx } from "react/jsx-runtime";
+export var DecimalInput = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  return /*#__PURE__*/_jsx(InputNumber, _objectSpread(_objectSpread({}, props), {}, {
+    stringMode: true,
+    ref: ref
+  }));
+});
+var DecimalPreview = function DecimalPreview(_ref) {
+  var value = _ref.value,
+    formatter = _ref.formatter;
+  return /*#__PURE__*/_jsx("span", {
+    children: value == null || value === '' ? '—' : typeof formatter === 'function' ? formatter(value, {
+      userTyping: false,
+      input: String(value)
+    }) : decimalText(value)
+  });
+};
+/** 精确数值的静默态沿用自身阅读规则，允许表格按已知显示契约懒挂载。@author nokecy */
+export var DecimalPicker = withReadOnlyFormatter(connect(DecimalInput, mapReadPretty(DecimalPreview)), function (value, ctx) {
+  var _ctx$fieldSchema;
+  if (value == null || value === '') return '';
+  var formatter = (_ctx$fieldSchema = ctx.fieldSchema) === null || _ctx$fieldSchema === void 0 || (_ctx$fieldSchema = _ctx$fieldSchema['x-component-props']) === null || _ctx$fieldSchema === void 0 ? void 0 : _ctx$fieldSchema.formatter;
+  return typeof formatter === 'function' ? String(formatter(value, {
+    userTyping: false,
+    input: String(value)
+  })) : decimalText(value);
+});

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

@@ -0,0 +1,3 @@
+export { withReactiveSchemaScope } from './schemaScope';
+/** 动态表单统一阅读展示；数值控件关闭方向键步进，保留表格导航与字段值。@author nokecy */
+export declare function withReadingFields(components: Record<string, any>): Record<string, any>;

package/dist/esm/readPretty/formily.js

@@ -0,0 +1,77 @@
+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 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 '@nokecy/formily-react';
+import React from 'react';
+import { hoistStatics } from "./hoistStatics";
+import * as Reading from "./controls";
+import { selectNumberInputTextOnClick } from "./selectNumberInputTextOnClick";
+import { withReadingArrayTable } from "./arrayTable";
+import { flattenOptions } from "./values";
+import { matchSelectDisplayValue } from "./selectValue";
+import { jsx as _jsx } from "react/jsx-runtime";
+export { withReactiveSchemaScope } from "./schemaScope";
+
+/** 动态表单统一阅读展示；数值控件关闭方向键步进，保留表格导航与字段值。@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 numericInput = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+    var choiceInput = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+    var Component = observer(function (props) {
+      var _field$dataSource;
+      var field = useField();
+      var options = field !== null && field !== void 0 && (_field$dataSource = field.dataSource) !== null && _field$dataSource !== void 0 && _field$dataSource.length ? field.dataSource : props.options;
+      var displayProps = choiceInput ? _objectSpread(_objectSpread({}, props), {}, {
+        value: matchSelectDisplayValue(props.value, flattenOptions(options, props.fieldNames), props.labelInValue)
+      }) : props;
+      if (props.disabled || props.readOnly || field !== null && field !== void 0 && field.disabled || field !== null && field !== void 0 && field.readOnly || choiceInput && (field === null || field === void 0 ? void 0 : field.pattern) === 'readPretty') {
+        var _field$value, _field$value2, _field$dataSource2;
+        return /*#__PURE__*/_jsx(Preview, _objectSpread(_objectSpread({}, 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$dataSource2 = field.dataSource) !== null && _field$dataSource2 !== void 0 && _field$dataSource2.length ? field.dataSource : props.options,
+          disabled: true
+        }));
+      }
+      return /*#__PURE__*/_jsx(Control, _objectSpread(_objectSpread({}, displayProps), numericInput ? {
+        keyboard: false,
+        onClick: selectNumberInputTextOnClick(props.onClick)
+      } : {}));
+    });
+    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], name === 'NumberPicker' || name === 'InputNumber', name === 'Select');
+    }
+    // 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,13 @@
+/**
+ * 阅读态控件：不可编辑时展示名称/文本而不是禁用的输入框，继承整张表单的禁用状态。
+ * 动态表单入口 `withReadingFields` 按字段的 disabled/readOnly 状态切换阅读展示，并保留 ArrayTable 动态列。
+ * @author nokecy
+ */
+export * as ReadPrettyControls from './controls';
+export { withReadingFields } from './formily';
+export { withReactiveSchemaScope } from './schemaScope';
+export { withReadingArrayTable } from './arrayTable';
+export { DecimalInput, DecimalPicker } from './decimal';
+export { ReadableSwitch, SwitchPreview } from './readableSwitch';
+export { flattenOptions, selectedLabels } from './values';
+export { normalizeSelectValue, selectCode, selectLabel } from './selectValue';

package/dist/esm/readPretty/index.js

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

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

@@ -0,0 +1,12 @@
+import { type SwitchProps } from 'antd';
+import React from 'react';
+/** 开关阅读态文字：有 checkedChildren / unCheckedChildren 时用它们，否则「是 / 否」；没有值时显示占位符。@author nokecy */
+export declare const SwitchPreview: React.FC<Pick<SwitchProps, 'checkedChildren' | 'unCheckedChildren'> & {
+    value?: boolean | null;
+}>;
+/**
+ * Formily 开关（可直接作 x-component）。2.0 起 `@nokecy/formily-antd` 的 `Switch` 自带阅读态，
+ * 这里保留 1.1.x 的名字，指向同一个组件。
+ * @author nokecy
+ */
+export declare const ReadableSwitch: React.ForwardRefExoticComponent<Omit<Partial<SwitchProps & React.RefAttributes<HTMLButtonElement>>, "ref"> & React.RefAttributes<any>>;

package/dist/esm/readPretty/readableSwitch.js

@@ -0,0 +1,20 @@
+import { PreviewText, Switch } from '@nokecy/formily-antd';
+import React from 'react';
+
+/** 开关阅读态文字：有 checkedChildren / unCheckedChildren 时用它们，否则「是 / 否」；没有值时显示占位符。@author nokecy */
+import { jsx as _jsx } from "react/jsx-runtime";
+export var SwitchPreview = function SwitchPreview(_ref) {
+  var value = _ref.value,
+    checkedChildren = _ref.checkedChildren,
+    unCheckedChildren = _ref.unCheckedChildren;
+  return /*#__PURE__*/_jsx(PreviewText, {
+    value: value === undefined || value === null ? undefined : value ? checkedChildren !== null && checkedChildren !== void 0 ? checkedChildren : '是' : unCheckedChildren !== null && unCheckedChildren !== void 0 ? unCheckedChildren : '否'
+  });
+};
+
+/**
+ * Formily 开关（可直接作 x-component）。2.0 起 `@nokecy/formily-antd` 的 `Switch` 自带阅读态，
+ * 这里保留 1.1.x 的名字，指向同一个组件。
+ * @author nokecy
+ */
+export var ReadableSwitch = Switch;

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

@@ -0,0 +1,2 @@
+/** 将 React 页面作用域接入 Formily 响应式表达式，保留字段、输入值和已有对象引用。@author nokecy */
+export declare const withReactiveSchemaScope: (Control: any) => any;

package/dist/esm/readPretty/schemaScope.js

@@ -0,0 +1,42 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { autorun, batch, observable, untracked } from '@nokecy/formily-reactive';
+import React, { useEffect, useMemo } from 'react';
+import { hoistStatics } from "./hoistStatics";
+
+/** 将 React 页面作用域接入 Formily 响应式表达式，保留字段、输入值和已有对象引用。@author nokecy */
+import { jsx as _jsx } from "react/jsx-runtime";
+export var withReactiveSchemaScope = function withReactiveSchemaScope(Control) {
+  var Component = function Component(props) {
+    var scope = useMemo(function () {
+      return observable.shallow(_objectSpread({}, props.scope));
+    }, []);
+    // 字段反应在初始化时绑定作用域，因此始终传同一对象，再于提交后同步当前页面数据。
+    // autorun 同时兼容调用方直接传入的 observable 作用域；untracked 避免订阅同步目标。@author nokecy
+    useEffect(function () {
+      return autorun(function () {
+        var _props$scope;
+        var current = (_props$scope = props.scope) !== null && _props$scope !== void 0 ? _props$scope : {};
+        var values = _objectSpread({}, current);
+        untracked(function () {
+          return batch(function () {
+            for (var _i = 0, _Object$keys = Object.keys(scope); _i < _Object$keys.length; _i++) {
+              var key = _Object$keys[_i];
+              if (!Object.prototype.hasOwnProperty.call(values, key)) delete scope[key];
+            }
+            Object.assign(scope, values);
+          });
+        });
+      });
+    });
+    return /*#__PURE__*/_jsx(Control, _objectSpread(_objectSpread({}, props), {}, {
+      scope: scope
+    }));
+  };
+  Component.displayName = 'ReactiveSchemaScope';
+  return hoistStatics(Component, Control);
+};

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

@@ -0,0 +1,3 @@
+import type { MouseEventHandler } from 'react';
+/** 数字框点击时全选当前输入文本，便于直接替换数值。@author nokecy */
+export declare const selectNumberInputTextOnClick: (onClick?: MouseEventHandler<HTMLElement>) => MouseEventHandler<HTMLElement>;

package/dist/esm/readPretty/selectNumberInputTextOnClick.js

@@ -0,0 +1,8 @@
+/** 数字框点击时全选当前输入文本，便于直接替换数值。@author nokecy */
+export var selectNumberInputTextOnClick = function selectNumberInputTextOnClick(onClick) {
+  return function (event) {
+    onClick === null || onClick === void 0 || onClick(event);
+    var target = event.target;
+    if (target instanceof HTMLInputElement && !target.disabled && !target.readOnly) target.select();
+  };
+};

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

@@ -0,0 +1,18 @@
+import { type ReactNode } from 'react';
+/**
+ * 仅为控件回显匹配候选中的原生值，不回写表单，不触发变更事件。
+ * @param value 原始单选或多选值。
+ * @param options 已展开的选项。
+ * @param labelInValue 是否使用名称编码对象。
+ * @returns 命中选项的控件值；未知值原样保留。
+ * @author nokecy
+ */
+export declare function matchSelectDisplayValue(value: any, options: readonly {
+    value?: unknown;
+}[], labelInValue?: boolean): any;
+/** 提取选择项的标量编码，兼容嵌套 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;