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

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;

package/dist/esm/readPretty/selectValue.js

@@ -0,0 +1,76 @@
+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';
+import { findOptionByValue } from "../shared/optionValue";
+
+/**
+ * 仅为控件回显匹配候选中的原生值，不回写表单，不触发变更事件。
+ * @param value 原始单选或多选值。
+ * @param options 已展开的选项。
+ * @param labelInValue 是否使用名称编码对象。
+ * @returns 命中选项的控件值；未知值原样保留。
+ * @author nokecy
+ */
+export function matchSelectDisplayValue(value, options, labelInValue) {
+  if (Array.isArray(value)) return value.map(function (item) {
+    return matchSelectDisplayValue(item, options, labelInValue);
+  });
+  var raw = labelInValue && value && _typeof(value) === 'object' ? value.value : value;
+  var matched = findOptionByValue(options, raw, function (option) {
+    return option.value;
+  });
+  if (!matched) return value;
+  return labelInValue && value && _typeof(value) === 'object' ? _objectSpread(_objectSpread({}, value), {}, {
+    value: matched.value
+  }) : matched.value;
+}
+
+/** 提取选择项的标量编码，兼容嵌套 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,44 @@
+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";
+import { findOptionByValue } from "../shared/optionValue";
+
+/** 阅读态选择项展开，保留分组内选项及自定义字段名。@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, _findOptionByValue, _item$label;
+    var raw = labelInValue ? item.value : item;
+    return (_ref2 = (_selectLabel = selectLabel((_findOptionByValue = findOptionByValue(options, raw, function (option) {
+      return option.value;
+    })) === null || _findOptionByValue === void 0 ? void 0 : _findOptionByValue.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/scanCollect/ScanFeedbackInput.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import { type ScanInputProps } from './ScanInput';
+/** 一次扫码的结果。每次扫码传入新对象即重新触发一次边缘闪动；结果文字保留到下一次传入。 */
+export interface ScanResult {
+    type: 'success' | 'error';
+    /** 徽标文字，不传按类型给「成功」/「失败」 */
+    message?: React.ReactNode;
+}
+export interface ScanFeedbackInputProps extends ScanInputProps {
+    /** 最近一次扫码结果；换成新对象 = 新的一次扫码 */
+    result?: ScanResult;
+    /** 播放提示音（WebAudio 合成），默认 false 静音 */
+    sound?: boolean;
+    /** 边缘闪动时长（毫秒），默认 1200 */
+    flashDuration?: number;
+}
+/**
+ * 扫码输入框 + 反馈整体组件（规范 §11.1）：
+ * 输入框下方预留固定高度的图标+文字徽标（语义色，保留到下一次扫码），
+ * 屏幕边缘闪动约 1.2 秒后收起，可选提示音。
+ * 边缘闪动层相对最近的定位祖先铺满，宿主需要整屏效果时把它放进整页容器即可。
+ *
+ * @author nokecy
+ */
+declare const ScanFeedbackInput: React.FC<ScanFeedbackInputProps>;
+export default ScanFeedbackInput;