@nokecy/qc-ui 1.1.73 → 1.1.75

package/dist/cjs/readPretty/formily.js

@@ -0,0 +1,71 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.withReadingFields = withReadingFields;
+var _react = require("@formily/react");
+var _react2 = _interopRequireDefault(require("react"));
+var _hoistStatics = require("./hoistStatics");
+var Reading = _interopRequireWildcard(require("./controls"));
+var _arrayTable = require("./arrayTable");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _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); }
+/** 动态表单统一入口：禁用/只读的数据控件使用阅读展示，保持字段值和校验模型。@author nokecy */
+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 = (0, _react.observer)(function (props) {
+      var field = (0, _react.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__*/_react2.default.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__*/_react2.default.createElement(Control, props);
+    });
+    var Wrapped = (0, _hoistStatics.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 = (0, _arrayTable.withReadingArrayTable)(components.ArrayTable);
+  return result;
+}

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

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

package/dist/cjs/readPretty/hoistStatics.js

@@ -0,0 +1,37 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.hoistStatics = hoistStatics;
+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']);
+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/cjs/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/cjs/readPretty/index.js

@@ -0,0 +1,70 @@
+"use strict";
+
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "DecimalInput", {
+  enumerable: true,
+  get: function get() {
+    return _decimal.DecimalInput;
+  }
+});
+Object.defineProperty(exports, "DecimalPicker", {
+  enumerable: true,
+  get: function get() {
+    return _decimal.DecimalPicker;
+  }
+});
+exports.ReadPrettyControls = void 0;
+Object.defineProperty(exports, "flattenOptions", {
+  enumerable: true,
+  get: function get() {
+    return _values.flattenOptions;
+  }
+});
+Object.defineProperty(exports, "normalizeSelectValue", {
+  enumerable: true,
+  get: function get() {
+    return _selectValue.normalizeSelectValue;
+  }
+});
+Object.defineProperty(exports, "selectCode", {
+  enumerable: true,
+  get: function get() {
+    return _selectValue.selectCode;
+  }
+});
+Object.defineProperty(exports, "selectLabel", {
+  enumerable: true,
+  get: function get() {
+    return _selectValue.selectLabel;
+  }
+});
+Object.defineProperty(exports, "selectedLabels", {
+  enumerable: true,
+  get: function get() {
+    return _values.selectedLabels;
+  }
+});
+Object.defineProperty(exports, "withReadingArrayTable", {
+  enumerable: true,
+  get: function get() {
+    return _arrayTable.withReadingArrayTable;
+  }
+});
+Object.defineProperty(exports, "withReadingFields", {
+  enumerable: true,
+  get: function get() {
+    return _formily.withReadingFields;
+  }
+});
+var _ReadPrettyControls = _interopRequireWildcard(require("./controls"));
+exports.ReadPrettyControls = _ReadPrettyControls;
+var _formily = require("./formily");
+var _arrayTable = require("./arrayTable");
+var _decimal = require("./decimal");
+var _values = require("./values");
+var _selectValue = require("./selectValue");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }

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

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

package/dist/cjs/readPretty/selectValue.js

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.normalizeSelectValue = normalizeSelectValue;
+exports.selectCode = selectCode;
+exports.selectLabel = selectLabel;
+var _react = require("react");
+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); }
+/** 提取选择项的标量编码，兼容嵌套 labelInValue；保留编码 0 和显式空字符串选项。@author nokecy */
+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__*/(0, _react.isValidElement)(value)) return undefined;
+  return selectCode(value.value, depth + 1);
+}
+
+/** 标签只输出可渲染内容；选择项对象取名称后再回落编码，避免 React 对象子节点异常。@author nokecy */
+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__*/(0, _react.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 */
+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/cjs/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/cjs/readPretty/values.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.flattenOptions = flattenOptions;
+exports.selectedLabels = selectedLabels;
+var _selectValue = require("./selectValue");
+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); }
+/** 阅读态选择项展开，保留分组内选项及自定义字段名。@author nokecy */
+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 */
+function selectedLabels(value, options, labelInValue) {
+  if (value == null || value === '' || Array.isArray(value) && !value.length) return '—';
+  var normalized = labelInValue ? (0, _selectValue.normalizeSelectValue)(value, true) : value;
+  var values = Array.isArray(normalized) ? normalized : normalized == null ? [] : [normalized];
+  if (!values.length) return '—';
+  var labels = values.map(function (item) {
+    var _ref2, _selectLabel, _options$find, _item$label;
+    var raw = labelInValue ? item.value : item;
+    return (_ref2 = (_selectLabel = (0, _selectValue.selectLabel)((_options$find = options.find(function (option) {
+      return option.value === raw;
+    })) === null || _options$find === void 0 ? void 0 : _options$find.label)) !== null && _selectLabel !== void 0 ? _selectLabel : (0, _selectValue.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/cjs/toolBar/index.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
 import './index.less';
+/** 详情、表单共用工具栏：按实际操作元素统一留出间距，宽度不足时换行。@author nokecy */
 declare const ToolBar: (props: any) => React.JSX.Element;
 export default ToolBar;

package/dist/cjs/toolBar/index.js

@@ -1,35 +1,69 @@
 "use strict";
 
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _react = _interopRequireDefault(require("react"));
+var _react = _interopRequireWildcard(require("react"));
 var _antd = require("antd");
 require("./index.less");
-var _excluded = ["children", "className", "extra", "style", "renderContent", "getTargetContainer"];
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+var _excluded = ["children", "className", "extra", "identity", "banner", "style", "renderContent", "getTargetContainer"];
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 function _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; }
+/** 详情、表单共用工具栏：按实际操作元素统一留出间距，宽度不足时换行。@author nokecy */
 var ToolBar = function ToolBar(props) {
   var children = props.children,
     className = props.className,
     extra = props.extra,
+    identity = props.identity,
+    banner = props.banner,
     style = props.style,
     renderContent = props.renderContent,
     getTargetContainer = props.getTargetContainer,
     restProps = _objectWithoutProperties(props, _excluded);
+  var _theme$useToken = _antd.theme.useToken(),
+    token = _theme$useToken.token; // 单据操作栏跟随宿主主题。@author nokecy
+  var barRef = (0, _react.useRef)(null);
+  // @author nokecy：KeepAlive 内容区独立滚动，吸顶应相对其视口，避免定位到应用顶栏下面。
+  var defaultTarget = (0, _react.useCallback)(function () {
+    var _barRef$current$paren, _barRef$current;
+    var parent = (_barRef$current$paren = (_barRef$current = barRef.current) === null || _barRef$current === void 0 ? void 0 : _barRef$current.parentElement) !== null && _barRef$current$paren !== void 0 ? _barRef$current$paren : null;
+    while (parent) {
+      if (/auto|scroll/.test(getComputedStyle(parent).overflowY)) return parent;
+      parent = parent.parentElement;
+    }
+    return window;
+  }, []);
   return /*#__PURE__*/_react.default.createElement(_antd.Affix, {
     offsetTop: 2,
     style: style,
     offsetBottom: 2,
-    target: getTargetContainer
+    target: getTargetContainer || defaultTarget
   }, /*#__PURE__*/_react.default.createElement("div", {
-    className: "antd-tool-bar"
-  }, /*#__PURE__*/_react.default.createElement("div", {
-    className: "antd-tool-bar-left".trim()
-  }, /*#__PURE__*/_react.default.createElement(_antd.Space, null, extra)), /*#__PURE__*/_react.default.createElement("div", {
-    className: "antd-tool-bar-right".trim()
-  }, /*#__PURE__*/_react.default.createElement(_antd.Space, null, children))));
+    ref: barRef,
+    className: "antd-tool-bar",
+    style: {
+      backgroundColor: token.colorBgContainer,
+      color: token.colorText,
+      borderBlockStartColor: token.colorBorderSecondary,
+      gap: token.marginXS,
+      paddingBlock: token.paddingXXS
+    }
+  }, banner && /*#__PURE__*/_react.default.createElement("div", {
+    className: "antd-tool-bar-banner"
+  }, banner), /*#__PURE__*/_react.default.createElement("div", {
+    className: "antd-tool-bar-left",
+    style: {
+      gap: token.marginXS
+    }
+  }, extra, identity), /*#__PURE__*/_react.default.createElement("div", {
+    className: "antd-tool-bar-right",
+    style: {
+      gap: token.marginXS
+    }
+  }, children)));
 };
 var _default = exports.default = ToolBar;

package/dist/cjs/toolBar/index.less

@@ -1,25 +1,43 @@
 .antd-tool-bar {
 	display: flex;
+	flex-wrap: wrap;
 	align-items: center;
 	box-sizing: border-box;
 	width: 100%;
-	color: rgba(0, 0, 0, 0.88);
 	line-height: 40px;
-	background-color: rgba(255, 255, 255);
-	-webkit-backdrop-filter: blur(8px);
+	backdrop-filter: blur(8px);
 	backdrop-filter: blur(8px);
 	transition: all 0.2s ease 0s;
 	inset-inline-end: 0;
 	padding-inline: 16px;
 	padding-block: 0;
-	border-block-start: 1px solid rgba(5, 5, 5, 0.06);
+	// 颜色由组件读取主题 token；子区域继承正文色。
+	border-block-start: 1px solid;
+}
+
+.antd-tool-bar-banner {
+	flex: 1 0 100%;
+	min-width: 0;
+	line-height: normal;
 }
 
 .antd-tool-bar-left {
-	flex: 1;
-	color: rgba(0, 0, 0, 0.88);
+	flex: 1 0 auto;
+	color: inherit;
+}
+
+.antd-tool-bar-right {
+	margin-inline-start: auto;
+	justify-content: flex-end;
+    color: inherit;
 }
 
+/* 直接排列组件输出的按钮，React Fragment 内的按钮也获得相同间距。@author nokecy */
+.antd-tool-bar-left,
 .antd-tool-bar-right {
-    color: rgba(0, 0, 0, 0.88);
+	display: flex;
+	flex-wrap: wrap;
+	align-items: center;
+	min-width: 0;
+	max-width: 100%;
 }

package/dist/cjs/utils/businessDecimal.d.ts

@@ -0,0 +1,11 @@
+import Decimal from 'decimal.js';
+/** 业务值保留十进制文本，运算使用十进制库；整型标识和时间不经过此入口。@author nokecy */
+export declare const BusinessDecimal: typeof Decimal;
+export type DecimalValue = string | number | Decimal | null | undefined;
+export declare const decimal: (value: DecimalValue) => Decimal;
+export declare const decimalText: (value: DecimalValue) => string;
+export declare const nonNegativeDecimal: (value: DecimalValue) => string;
+export declare const roundDecimal: (value: DecimalValue, places: number) => string;
+export declare const sumDecimals: (values: DecimalValue[]) => string;
+/** 指定取位规则显示，千分位直接处理文本，不转换为 JavaScript number。@author nokecy */
+export declare const formatDecimal: (value: DecimalValue, places?: number, minimumPlaces?: number) => string;

package/dist/cjs/utils/businessDecimal.js

@@ -0,0 +1,53 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.sumDecimals = exports.roundDecimal = exports.nonNegativeDecimal = exports.formatDecimal = exports.decimalText = exports.decimal = exports.BusinessDecimal = void 0;
+var _decimal = _interopRequireDefault(require("decimal.js"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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; }
+/** 业务值保留十进制文本，运算使用十进制库；整型标识和时间不经过此入口。@author nokecy */
+var BusinessDecimal = exports.BusinessDecimal = _decimal.default.clone({
+  precision: 64,
+  rounding: _decimal.default.ROUND_HALF_UP,
+  toExpNeg: -64,
+  toExpPos: 64
+});
+var decimal = exports.decimal = function decimal(value) {
+  return new BusinessDecimal(value == null || value === '' ? '0' : value);
+};
+var decimalText = exports.decimalText = function decimalText(value) {
+  return decimal(value).toFixed();
+};
+var nonNegativeDecimal = exports.nonNegativeDecimal = function nonNegativeDecimal(value) {
+  return BusinessDecimal.max(0, decimal(value)).toFixed();
+};
+var roundDecimal = exports.roundDecimal = function roundDecimal(value, places) {
+  return decimal(value).toDecimalPlaces(places).toFixed();
+};
+var sumDecimals = exports.sumDecimals = function sumDecimals(values) {
+  return values.reduce(function (sum, value) {
+    return sum.plus(decimal(value));
+  }, decimal('0')).toFixed();
+};
+
+/** 指定取位规则显示，千分位直接处理文本，不转换为 JavaScript number。@author nokecy */
+var formatDecimal = exports.formatDecimal = function formatDecimal(value) {
+  var places = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 6;
+  var minimumPlaces = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
+  if (value == null || value === '') return '';
+  var _decimal$toFixed$spli = decimal(value).toFixed(places).split('.'),
+    _decimal$toFixed$spli2 = _slicedToArray(_decimal$toFixed$spli, 2),
+    integer = _decimal$toFixed$spli2[0],
+    _decimal$toFixed$spli3 = _decimal$toFixed$spli2[1],
+    fraction = _decimal$toFixed$spli3 === void 0 ? '' : _decimal$toFixed$spli3;
+  while (fraction.length > minimumPlaces && fraction.endsWith('0')) fraction = fraction.slice(0, -1);
+  integer = integer.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+  return fraction ? "".concat(integer, ".").concat(fraction) : integer;
+};

package/dist/cjs/utils/contrast.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 对比度计算与「够读的主色」派生。
+ *
+ * 背景：品牌绿 #00b96b 落在白底上只有 2.58:1，而正文文字要 4.5:1、非文本要 3:1（WCAG 2.1）。
+ * antd 从它派生的最深一档 colorPrimaryActive 也只有 3.90:1——够非文本，够不到文字。
+ * 所以菜单选中态、行内操作按钮这些「用主色写字」的地方，靠 antd 自带档位解决不了。
+ *
+ * 这里按色相不变、只压明度的方式派生出刚好达标的一档：绿还是那个绿，但读得清。
+ * 写成纯函数而不是写死一个色值，是因为四个客户各有各的主色，写死就只对信诚成立。
+ *
+ * 验收方法沿用登录页复核那套：实测计算，不看源码想当然。
+ *
+ * @author nokecy
+ */
+/** hex -> [r, g, b]，每项 0~255。 */
+export declare function toRgb(hex: string): [number, number, number];
+/** WCAG 相对亮度。 */
+export declare function relativeLuminance(hex: string): number;
+/** WCAG 对比度，1 ~ 21。 */
+export declare function contrastRatio(a: string, b: string): number;
+/** hex -> [h(0~360), s(0~1), l(0~1)]。 */
+export declare function toHsl(hex: string): [number, number, number];
+/** [h, s, l] -> hex。 */
+export declare function fromHsl(h: number, s: number, l: number): string;
+/**
+ * 压暗到刚好满足对比度要求的一档，色相与饱和度保持不变。
+ *
+ * @param hex     起始色（通常是品牌主色）
+ * @param against 要压在什么底色上，默认白底
+ * @param min     目标对比度，正文 4.5、非文本 3
+ */
+export declare function darkenUntilContrast(hex: string, { against, min }?: {
+    against?: string | undefined;
+    min?: number | undefined;
+}): string;
+/** 深色表面上的文字保持色相，提亮至正文对比度。@author nokecy */
+export declare function lightenUntilContrast(hex: string, { against, min }?: {
+    against?: string | undefined;
+    min?: number | undefined;
+}): string;