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

package/dist/cjs/dialogSelect/selectedLabels.js

@@ -0,0 +1,254 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.withSelectedLabels = exports.useSelectedLabels = exports.selectedDisplayValue = exports.escapeSelectedValue = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _antd = require("antd");
+var _selectValue = require("../readPretty/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; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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 _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 _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; }
+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); }
+var hasValue = function hasValue(value) {
+  return value !== undefined && value !== null && value !== '';
+};
+var keyOf = function keyOf(value) {
+  return "".concat(_typeof(value), ":").concat(String(value));
+};
+var usefulLabel = function usefulLabel(value, label) {
+  return label !== undefined && label !== null && label !== '' && String(label).trim() !== String(value).trim();
+};
+
+/** Gridify 的值转义仅用于查询，不改变表单中的编码。@author nokecy */
+var escapeSelectedValue = exports.escapeSelectedValue = function escapeSelectedValue(value) {
+  return String(value).replace(/([\\,|()/])/g, '\\$1');
+};
+
+/** 从下拉选项和分组选项读取已有标签，避免重复查询。@author nokecy */
+var collectOptions = function collectOptions(props) {
+  var options = [];
+  var walkOptions = function walkOptions(items) {
+    return items === null || items === void 0 ? void 0 : items.forEach(function (item) {
+      if (item !== null && item !== void 0 && item.options) walkOptions(item.options);else if (hasValue(item === null || item === void 0 ? void 0 : item.value)) options.push(item);
+    });
+  };
+  var walkChildren = function walkChildren(children) {
+    return _react.default.Children.forEach(children, function (child) {
+      var _childProps$label;
+      if (! /*#__PURE__*/_react.default.isValidElement(child)) return;
+      var childProps = child.props;
+      if (hasValue(childProps.value)) options.push({
+        value: childProps.value,
+        label: (_childProps$label = childProps.label) !== null && _childProps$label !== void 0 ? _childProps$label : childProps.children
+      });else walkChildren(childProps.children);
+    });
+  };
+  walkOptions(props.options);
+  walkChildren(props.children);
+  return options;
+};
+
+/**
+ * 对程序带入但没有候选标签的编码精确查名；只补显示选项，不触发表单输入或联动。
+ * 请求仅承接当前选择，切换、清空及卸载后的返回不回填；不存在或无权读取时保留原值。
+ * @author nokecy
+ */
+var useSelectedLabels = exports.useSelectedLabels = function useSelectedLabels(props, value) {
+  var _props$valueField, _props$labelField, _props$selectedScopeK;
+  var enabled = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  var requestRef = (0, _react.useRef)(props);
+  requestRef.current = props;
+  var _useState = (0, _react.useState)({}),
+    _useState2 = _slicedToArray(_useState, 2),
+    resolved = _useState2[0],
+    setResolved = _useState2[1];
+  var valueField = (_props$valueField = props.valueField) !== null && _props$valueField !== void 0 ? _props$valueField : 'id';
+  var labelField = (_props$labelField = props.labelField) !== null && _props$labelField !== void 0 ? _props$labelField : 'name';
+  var scope = JSON.stringify((_props$selectedScopeK = props.selectedScopeKey) !== null && _props$selectedScopeK !== void 0 ? _props$selectedScopeK : null);
+  var cachePrefix = "".concat(scope, ":").concat(valueField, ":").concat(labelField, ":");
+  var existing = collectOptions(props);
+  var normalized = (0, _selectValue.normalizeSelectValue)(value, true);
+  var selected = (Array.isArray(normalized) ? normalized : [normalized]).map(function (item) {
+    return item && _typeof(item) === 'object' ? {
+      value: item.value,
+      label: item.label
+    } : {
+      value: item,
+      label: undefined
+    };
+  }).filter(function (item) {
+    return hasValue(item.value);
+  });
+  var options = selected.map(function (item) {
+    var _props$dialogDataSour, _resolved;
+    var known = existing.find(function (option) {
+      return option.value === item.value && usefulLabel(item.value, option.label);
+    });
+    var local = (_props$dialogDataSour = props.dialogDataSource) === null || _props$dialogDataSour === void 0 ? void 0 : _props$dialogDataSour.find(function (row) {
+      return row[valueField] === item.value;
+    });
+    return usefulLabel(item.value, item.label) ? item : known !== null && known !== void 0 ? known : usefulLabel(item.value, local === null || local === void 0 ? void 0 : local[labelField]) ? {
+      value: item.value,
+      label: local[labelField]
+    } : (_resolved = resolved["".concat(cachePrefix).concat(keyOf(item.value))]) !== null && _resolved !== void 0 ? _resolved : item;
+  });
+  var missing = options.filter(function (item) {
+    return !usefulLabel(item.value, item.label);
+  });
+  // JSON只作依赖签名，不进入过滤语法。每次查询使用编码等值条件，不受第一页或模糊候选影响。
+  var signature = JSON.stringify(enabled && (props.request || props.resolveSelected) && !Array.isArray(props.dialogDataSource) && props.displayField !== 'value' && labelField !== valueField ? Array.from(new Set(missing.map(function (item) {
+    return item.value;
+  }))) : []);
+  (0, _react.useEffect)(function () {
+    var values = JSON.parse(signature);
+    if (!values.length) return;
+    var active = true;
+    var source = requestRef.current;
+    var filter = values.map(function (item) {
+      return "(".concat(valueField, " = ").concat(escapeSelectedValue(item), ")");
+    }).join(' | ');
+    var filtered = source.queryFun ? source.queryFun(filter) : filter;
+    var count = Math.max(20, values.length);
+    var query = source.pagedApiAdapter ? source.pagedApiAdapter.toRequest({
+      filter: filtered,
+      skipCount: 0,
+      maxResultCount: count
+    }) : {
+      Filter: filtered,
+      SkipCount: 0,
+      MaxResultCount: count
+    };
+    void Promise.resolve().then(function () {
+      return source.resolveSelected ? source.resolveSelected(values) : source.request(query);
+    }).then(function (result) {
+      var _source$pagedApiAdapt, _result$items;
+      if (!active) return;
+      // 已是行数组（如 resolveSelected 直接返回候选）时不再经分页适配器解析。@author nokecy
+      var rows = Array.isArray(result) ? result : (_source$pagedApiAdapt = source.pagedApiAdapter) !== null && _source$pagedApiAdapt !== void 0 && _source$pagedApiAdapt.getItems ? source.pagedApiAdapter.getItems(result) : (_result$items = result === null || result === void 0 ? void 0 : result.items) !== null && _result$items !== void 0 ? _result$items : [];
+      var found = {};
+      var _iterator = _createForOfIteratorHelper(values),
+        _step;
+      try {
+        var _loop = function _loop() {
+          var original = _step.value;
+          var row = rows.find(function (item) {
+            var _item$valueField;
+            return String((_item$valueField = item === null || item === void 0 ? void 0 : item[valueField]) !== null && _item$valueField !== void 0 ? _item$valueField : '').trim().toLowerCase() === String(original).trim().toLowerCase();
+          });
+          var name = row === null || row === void 0 ? void 0 : row[labelField];
+          if (!usefulLabel(original, name)) return 1; // continue
+          var code = row === null || row === void 0 ? void 0 : row.code;
+          var label = labelField === 'name' && hasValue(code) && String(name).trim() !== String(code).trim() ? "".concat(String(code).trim(), " - ").concat(String(name).trim()) : name;
+          found["".concat(cachePrefix).concat(keyOf(original))] = {
+            value: original,
+            label: label
+          };
+        };
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          if (_loop()) continue;
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      if (Object.keys(found).length) setResolved(function (previous) {
+        return _objectSpread(_objectSpread({}, previous), found);
+      });
+    }).catch(function () {/* 名称读取失败保留业务值，后续用户仍可展开选择。@author nokecy */});
+    return function () {
+      active = false;
+    };
+  }, [signature, valueField, labelField, scope]);
+  return options.filter(function (item) {
+    return usefulLabel(item.value, item.label);
+  });
+};
+
+/** 追加选中项的显示标签，保留原有候选与分组结构。@author nokecy */
+var withSelectedLabels = exports.withSelectedLabels = function withSelectedLabels(props, labels) {
+  if (!labels.length) return props;
+  var known = collectOptions(props);
+  var extra = labels.filter(function (item) {
+    return !known.some(function (option) {
+      return option.value === item.value && usefulLabel(item.value, option.label);
+    });
+  });
+  if (!extra.length) return props;
+  var added = extra.filter(function (item) {
+    return !known.some(function (option) {
+      return option.value === item.value;
+    });
+  });
+  if (props.options) {
+    var _update = function _update(items) {
+      return items.map(function (item) {
+        return item.options ? _objectSpread(_objectSpread({}, item), {}, {
+          options: _update(item.options)
+        }) : extra.find(function (option) {
+          return option.value === item.value;
+        }) ? _objectSpread(_objectSpread({}, item), {}, {
+          label: extra.find(function (option) {
+            return option.value === item.value;
+          }).label
+        }) : item;
+      });
+    };
+    return _objectSpread(_objectSpread({}, props), {}, {
+      options: [].concat(_toConsumableArray(_update(props.options)), _toConsumableArray(added))
+    });
+  }
+  // 保留自定义Option、分组与选项附加属性，补入的选项只参与显示。
+  var update = function update(children) {
+    return _react.default.Children.map(children, function (child) {
+      if (! /*#__PURE__*/_react.default.isValidElement(child)) return child;
+      var childProps = child.props;
+      var option = extra.find(function (item) {
+        return item.value === childProps.value;
+      });
+      if (option) return /*#__PURE__*/_react.default.cloneElement(child, {}, option.label);
+      return childProps.children && !hasValue(childProps.value) ? /*#__PURE__*/_react.default.cloneElement(child, {}, update(childProps.children)) : child;
+    });
+  };
+  return _objectSpread(_objectSpread({}, props), {}, {
+    children: [update(props.children)].concat(_toConsumableArray(added.map(function (item) {
+      return /*#__PURE__*/_react.default.createElement(_antd.Select.Option, {
+        key: "selected:".concat(keyOf(item.value)),
+        value: item.value,
+        children: item.label
+      });
+    })))
+  });
+};
+
+/** labelInValue中以编码占位的标签只在显示层补名，不改变值或发出onChange。@author nokecy */
+var selectedDisplayValue = exports.selectedDisplayValue = function selectedDisplayValue(value, labels, labelInValue) {
+  if (!labelInValue) return value;
+  if (Array.isArray(value)) return value.map(function (item) {
+    return selectedDisplayValue(item, labels, true);
+  });
+  if (!value || _typeof(value) !== 'object' || usefulLabel(value.value, value.label)) return value;
+  var option = labels.find(function (item) {
+    return item.value === value.value;
+  });
+  return option ? _objectSpread(_objectSpread({}, value), {}, {
+    label: option.label
+  }) : value;
+};

package/dist/cjs/documentPage/DisabledActionHint.d.ts

@@ -0,0 +1,13 @@
+import React, { type CSSProperties, type ReactElement } from 'react';
+/**
+ * 禁用动作保留鼠标和键盘提示入口；内部按钮仍禁用，不能通过包装层触发操作。
+ * 原因文字原样显示，需要把后端技术信息转成用户可读文字时由宿主先处理。@author nokecy
+ */
+export declare function DisabledActionHint({ disabled, reason, label, children }: {
+    disabled?: boolean;
+    reason?: string;
+    label: string;
+    children: ReactElement<{
+        style?: CSSProperties;
+    }>;
+}): React.JSX.Element;

package/dist/cjs/documentPage/DisabledActionHint.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DisabledActionHint = DisabledActionHint;
+var _antd = require("antd");
+var _react = _interopRequireDefault(require("react"));
+var _jsxRuntime = require("react/jsx-runtime");
+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 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 DisabledActionHint(_ref) {
+  var disabled = _ref.disabled,
+    reason = _ref.reason,
+    label = _ref.label,
+    children = _ref.children;
+  var explanation = reason === null || reason === void 0 ? void 0 : reason.trim();
+  if (!disabled || !explanation) return children;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Tooltip, {
+    title: explanation,
+    trigger: ['hover', 'focus'],
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+      tabIndex: 0,
+      role: "group",
+      "aria-disabled": "true",
+      "aria-label": "".concat(label, "\uFF1A").concat(explanation),
+      style: {
+        display: 'inline-flex',
+        cursor: 'not-allowed',
+        pointerEvents: 'auto'
+      },
+      children: /*#__PURE__*/_react.default.cloneElement(children, {
+        style: _objectSpread(_objectSpread({}, children.props.style), {}, {
+          pointerEvents: 'none'
+        })
+      })
+    })
+  });
+}

package/dist/cjs/documentPage/DocumentHeader.d.ts

@@ -0,0 +1,45 @@
+import React from 'react';
+import './index.less';
+/** 状态 Tag：颜色只用 antd 语义档（default / processing / warning / success / error），不写 hex。 */
+export interface DocumentTag {
+    label: string;
+    color?: string;
+}
+/** 状态栏里已发生的一步：动作名、操作人、时间。 */
+export interface DocumentStep {
+    label: string;
+    who?: string;
+    when?: string;
+}
+/**
+ * 单据页标题区（U9 ②，《进销存单据界面UX规范》§8「顶部单据身份」）：
+ * 白底身份条紧贴工具栏下沿，左右内边距与下方卡片内容对齐；顺序为 类型 → 状态 → 单号，
+ * 右侧固定留出 查看/编辑中/新建中 与未保存提示的位置，提示出现与否不挤动单号。
+ * 未保存时单号处写「保存后自动生成」，状态 Tag 写「未保存」，不让标题区少一块。
+ * @author nokecy
+ */
+export declare const DocumentHeader: React.FC<{
+    title: string;
+    orderNumber?: string;
+    tags?: DocumentTag[];
+    saved: boolean;
+    /** 当前页面场景；传入后在标题区显示新建、编辑或查看状态。@author nokecy */
+    mode?: 'form' | 'detail';
+    /** 表单有尚未保存的修改时显示提示。@author nokecy */
+    dirty?: boolean;
+    /** 合并到工具栏时使用紧凑布局。@author nokecy */
+    compact?: boolean;
+    /** 单号由用户录入而非系统生成的单据（如销售合同号）改写未保存时的单号位提示 */
+    emptyNumberText?: string;
+}>;
+/**
+ * 单据页制单与流转信息（U9 ⑥，《进销存单据界面UX规范》§8「底部制单与流转信息」）：
+ * 与表尾卡片同宽、同内边距、同「标签：值」写法，分「制单 / 最近操作 / 审核」三组，每组一行「人员 动作 时间」；
+ * 制单固定保留，不被最近操作挤掉；没有数据的组写「暂无记录」，新建写「保存后生成」，不推造人员和时间。
+ * @author nokecy
+ */
+export declare const DocumentStatusBar: React.FC<{
+    steps?: DocumentStep[];
+    saved: boolean;
+    unsavedText?: string;
+}>;

package/dist/cjs/documentPage/DocumentHeader.js

@@ -0,0 +1,233 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DocumentStatusBar = exports.DocumentHeader = void 0;
+var _icons = require("@ant-design/icons");
+var _antd = require("antd");
+var _react = _interopRequireDefault(require("react"));
+var _documentAudit = require("./documentAudit");
+require("./index.less");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/** 状态 Tag：颜色只用 antd 语义档（default / processing / warning / success / error），不写 hex。 */
+
+/** 状态栏里已发生的一步：动作名、操作人、时间。 */
+
+var clean = function clean(value) {
+  return typeof value === 'string' ? value.trim() : '';
+};
+
+/**
+ * 单据页标题区（U9 ②，《进销存单据界面UX规范》§8「顶部单据身份」）：
+ * 白底身份条紧贴工具栏下沿，左右内边距与下方卡片内容对齐；顺序为 类型 → 状态 → 单号，
+ * 右侧固定留出 查看/编辑中/新建中 与未保存提示的位置，提示出现与否不挤动单号。
+ * 未保存时单号处写「保存后自动生成」，状态 Tag 写「未保存」，不让标题区少一块。
+ * @author nokecy
+ */
+var DocumentHeader = exports.DocumentHeader = function DocumentHeader(_ref) {
+  var title = _ref.title,
+    orderNumber = _ref.orderNumber,
+    _ref$tags = _ref.tags,
+    tags = _ref$tags === void 0 ? [] : _ref$tags,
+    saved = _ref.saved,
+    mode = _ref.mode,
+    _ref$dirty = _ref.dirty,
+    dirty = _ref$dirty === void 0 ? false : _ref$dirty,
+    _ref$compact = _ref.compact,
+    compact = _ref$compact === void 0 ? false : _ref$compact,
+    _ref$emptyNumberText = _ref.emptyNumberText,
+    emptyNumberText = _ref$emptyNumberText === void 0 ? '保存后自动生成' : _ref$emptyNumberText;
+  var _theme$useToken = _antd.theme.useToken(),
+    token = _theme$useToken.token;
+  var number = clean(orderNumber);
+  var modeLabel = mode === 'detail' ? '查看' : saved ? '编辑中' : '新建中';
+  var ModeIcon = mode === 'detail' ? _icons.EyeOutlined : saved ? _icons.EditOutlined : _icons.FileAddOutlined;
+  var tagStyle = {
+    margin: '0',
+    fontSize: token.fontSize,
+    lineHeight: '22px'
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("header", {
+    className: compact ? 'doc-identity doc-identity-compact' : 'doc-identity',
+    "aria-label": "\u5355\u636E\u4FE1\u606F",
+    style: {
+      background: token.colorBgContainer,
+      borderTop: compact ? undefined : "1px solid ".concat(token.colorSplit),
+      borderRadius: "0 0 ".concat(token.borderRadiusLG, "px ").concat(token.borderRadiusLG, "px"),
+      padding: compact ? 0 : "6px ".concat(token.padding, "px"),
+      marginBottom: compact ? 0 : token.marginXS,
+      gap: compact ? token.marginXS : token.margin
+    },
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+      className: "doc-identity-main",
+      style: {
+        columnGap: token.padding
+      },
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+        className: "doc-identity-heading",
+        style: {
+          gap: token.marginXS
+        },
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Typography.Title, {
+          level: 4,
+          style: {
+            margin: '0',
+            fontSize: token.fontSizeXL,
+            lineHeight: '24px',
+            fontWeight: 600
+          },
+          children: title
+        }), saved ? tags.map(function (tag) {
+          var _tag$color;
+          return /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Tag, {
+            style: tagStyle,
+            color: (_tag$color = tag.color) !== null && _tag$color !== void 0 ? _tag$color : 'default',
+            children: tag.label
+          }, tag.label);
+        }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Tag, {
+          style: tagStyle,
+          children: "\u672A\u4FDD\u5B58"
+        })]
+      }), /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+        className: "doc-identity-number",
+        style: {
+          gap: token.marginXS,
+          fontSize: token.fontSizeLG
+        },
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Typography.Text, {
+          type: "secondary",
+          style: {
+            fontSize: token.fontSizeLG
+          },
+          children: "\u5355\u53F7"
+        }), number ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Typography.Text, {
+          copyable: {
+            tooltips: false
+          },
+          strong: true,
+          style: {
+            fontSize: token.fontSizeLG,
+            fontVariantNumeric: 'tabular-nums'
+          },
+          children: number
+        }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Typography.Text, {
+          type: "secondary",
+          style: {
+            fontSize: token.fontSizeLG
+          },
+          children: emptyNumberText
+        })]
+      })]
+    }), mode && /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+      className: "doc-identity-context",
+      style: {
+        gap: token.marginXS
+      },
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_antd.Typography.Text, {
+        type: "secondary",
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(ModeIcon, {
+          style: {
+            marginInlineEnd: 4
+          }
+        }), modeLabel]
+      }), (!compact || mode === 'form' && dirty) && /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Typography.Text, {
+        type: "warning",
+        "aria-hidden": !(mode === 'form' && dirty),
+        style: {
+          visibility: mode === 'form' && dirty ? 'visible' : 'hidden'
+        },
+        children: "\u6709\u672A\u4FDD\u5B58\u7684\u4FEE\u6539"
+      })]
+    })]
+  });
+};
+
+/**
+ * 单据页制单与流转信息（U9 ⑥，《进销存单据界面UX规范》§8「底部制单与流转信息」）：
+ * 与表尾卡片同宽、同内边距、同「标签：值」写法，分「制单 / 最近操作 / 审核」三组，每组一行「人员 动作 时间」；
+ * 制单固定保留，不被最近操作挤掉；没有数据的组写「暂无记录」，新建写「保存后生成」，不推造人员和时间。
+ * @author nokecy
+ */
+var DocumentStatusBar = exports.DocumentStatusBar = function DocumentStatusBar(_ref2) {
+  var _approved$label;
+  var _ref2$steps = _ref2.steps,
+    steps = _ref2$steps === void 0 ? [] : _ref2$steps,
+    saved = _ref2.saved,
+    _ref2$unsavedText = _ref2.unsavedText,
+    unsavedText = _ref2$unsavedText === void 0 ? '保存后生成' : _ref2$unsavedText;
+  var _theme$useToken2 = _antd.theme.useToken(),
+    token = _theme$useToken2.token;
+  var happened = (0, _documentAudit.normalizeDocumentAuditSteps)(steps);
+  var created = happened.find(function (step) {
+    return step.label === '制单';
+  });
+  var approved = happened.find(function (step) {
+    return step.label === '审核' || step.label === '审批';
+  });
+  var latest = (0, _documentAudit.latestDocumentAuditStep)(happened);
+  var groups = [{
+    title: '制单',
+    step: created,
+    empty: saved ? '暂无记录' : unsavedText
+  }, {
+    title: '最近操作',
+    step: latest,
+    showAction: true,
+    empty: '暂无记录'
+  }, {
+    title: (_approved$label = approved === null || approved === void 0 ? void 0 : approved.label) !== null && _approved$label !== void 0 ? _approved$label : '审核',
+    step: approved,
+    empty: '暂无记录'
+  }];
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)("section", {
+    className: "doc-audit",
+    "aria-label": "\u5236\u5355\u4E0E\u6D41\u8F6C\u4FE1\u606F",
+    style: {
+      background: token.colorBgContainer,
+      border: "1px solid ".concat(token.colorBorderSecondary),
+      borderRadius: token.borderRadiusLG,
+      padding: "".concat(token.paddingSM, "px ").concat(token.padding, "px"),
+      marginTop: token.marginXS,
+      marginBottom: token.marginXS
+    },
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)("dl", {
+      className: "doc-audit-groups",
+      style: {
+        gap: token.paddingSM
+      },
+      children: groups.map(function (group) {
+        return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+          className: "doc-audit-group",
+          style: {
+            gap: 4,
+            borderColor: token.colorSplit
+          },
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)("dt", {
+            className: "doc-audit-label",
+            style: {
+              color: token.colorTextSecondary
+            },
+            children: [group.title, "\uFF1A"]
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)("dd", {
+            style: {
+              margin: '0',
+              minWidth: 0
+            },
+            children: group.step ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Typography.Text, {
+              ellipsis: true,
+              style: {
+                fontVariantNumeric: 'tabular-nums'
+              },
+              children: [clean(group.step.who) || '—', group.showAction ? group.step.label : '', (0, _documentAudit.formatDocumentTime)(group.step.when)].filter(Boolean).join(' ')
+            }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Typography.Text, {
+              type: "secondary",
+              children: group.empty
+            })
+          })]
+        }, group.title);
+      })
+    })
+  });
+};

package/dist/cjs/documentPage/DocumentListToolbar.d.ts

@@ -0,0 +1,37 @@
+import { type DocumentActionKey } from './DocumentRowActions';
+import type { ReactNode } from 'react';
+import React from 'react';
+/** 列表工具栏动作；页面决定权限、业务能力和主次。@author nokecy */
+export interface DocumentToolbarAction {
+    key: string;
+    label: string;
+    iconKey: DocumentActionKey;
+    onClick: () => void | Promise<unknown>;
+    disabled?: boolean;
+    /** 当前动作置灰时显示用户可读的原因。@author nokecy */
+    disabledReason?: string;
+    danger?: boolean;
+    confirm?: {
+        title: string;
+        content: string;
+    };
+}
+/**
+ * 单据列表操作区：选择摘要放在标题旁，视图、新建和单据操作放在右侧。
+ * 无权限及不适用动作由页面过滤；组件不读取单据状态或权限。
+ * @author nokecy
+ */
+export declare const DocumentListToolbar: React.FC<{
+    viewToggle?: ReactNode;
+    selectedLabel?: string;
+    /** 页面自定义的选择摘要，例如只用于导出的多选明细。@author nokecy */
+    selectionSummary?: ReactNode;
+    onClearSelection?: () => void;
+    create?: DocumentToolbarAction;
+    actions?: DocumentToolbarAction[];
+    /** 隐藏次要单据操作菜单；页面可将唯一主操作独立展示。@author nokecy */
+    showActionsMenu?: boolean;
+    busy?: boolean;
+    /** 动作执行失败时的提示；不传时用 message.error 显示错误信息或 fallback。宿主可接入自己的业务错误展示。@author nokecy */
+    onError?: (error: unknown, fallback: string) => void;
+}>;