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

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

@@ -15,6 +15,8 @@ export { formatDocumentTime, latestDocumentAuditStep, normalizeDocumentAuditStep
 export type { DocumentAuditStep } from './documentAudit';
 export { confirmDocumentAction, formatValidationFeedback, pickPrimaryAction, reloadAfterAction, submitButtonLabel, useDocumentActions, useDocumentEditState, validateBeforeConfirm, warnSavedButActionFailed, } from './documentPage';
 export type { DocumentDirtyTracker } from './documentPage';
+export { LEAVE_GUARD_TEXT, confirmDiscardChanges, useLeaveGuard } from './leaveGuard';
+export type { LeaveGuardOptions, RouteBlocker } from './leaveGuard';
 export { useHeaderItemToggleGrid } from './useHeaderItemToggleGrid';
 export type { HeaderItemModeLabels, HeaderItemReadScope, HeaderItemViewMode, UseHeaderItemToggleGridOptions } from './useHeaderItemToggleGrid';
 export { createHeaderItemGetRowId, getHeaderItemRowId } from './headerItemRowId';

package/dist/cjs/documentPage/index.js

@@ -33,6 +33,18 @@ Object.defineProperty(exports, "DocumentStatusBar", {
     return _DocumentHeader.DocumentStatusBar;
   }
 });
+Object.defineProperty(exports, "LEAVE_GUARD_TEXT", {
+  enumerable: true,
+  get: function get() {
+    return _leaveGuard.LEAVE_GUARD_TEXT;
+  }
+});
+Object.defineProperty(exports, "confirmDiscardChanges", {
+  enumerable: true,
+  get: function get() {
+    return _leaveGuard.confirmDiscardChanges;
+  }
+});
 Object.defineProperty(exports, "confirmDocumentAction", {
   enumerable: true,
   get: function get() {
@@ -123,6 +135,12 @@ Object.defineProperty(exports, "useHeaderItemToggleGrid", {
     return _useHeaderItemToggleGrid.useHeaderItemToggleGrid;
   }
 });
+Object.defineProperty(exports, "useLeaveGuard", {
+  enumerable: true,
+  get: function get() {
+    return _leaveGuard.useLeaveGuard;
+  }
+});
 Object.defineProperty(exports, "useSelectNumberInputOnFocus", {
   enumerable: true,
   get: function get() {
@@ -147,6 +165,7 @@ var _DisabledActionHint = require("./DisabledActionHint");
 var _DocumentHeader = require("./DocumentHeader");
 var _documentAudit = require("./documentAudit");
 var _documentPage = require("./documentPage");
+var _leaveGuard = require("./leaveGuard");
 var _useHeaderItemToggleGrid = require("./useHeaderItemToggleGrid");
 var _headerItemRowId = require("./headerItemRowId");
 var _useSelectNumberInputOnFocus = require("./useSelectNumberInputOnFocus");

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

@@ -0,0 +1,31 @@
+/** 离开守卫的统一文案（DESIGN.md §6.8）。 */
+export declare const LEAVE_GUARD_TEXT: {
+    readonly title: "有未保存的修改，离开后将丢失";
+    readonly keepEditing: "继续编辑";
+    readonly discard: "放弃修改";
+};
+/**
+ * 弹出「继续编辑 / 放弃修改」确认。放弃修改返回 true；继续编辑、Esc 返回 false。
+ * 默认焦点在「继续编辑」（§6.8），确认框宽 560（§9.0）。
+ */
+export declare const confirmDiscardChanges: () => Promise<boolean>;
+/**
+ * 路由拦截适配器：qc-ui 不绑定路由库，由宿主把自己的路由拦截接进来。
+ * 宿主在导航发生时若 `shouldBlock()` 为真，就阻止并调用 `confirmLeave()`，得到 true 再放行。
+ * 返回取消拦截的函数。例（umi / react-router 的 history.block 一类）：
+ * `(shouldBlock, confirmLeave) => history.block(tx => { if (!shouldBlock()) return; confirmLeave().then(ok => ok && (unblock(), tx.retry())); return false; })`
+ */
+export type RouteBlocker = (shouldBlock: () => boolean, confirmLeave: () => Promise<boolean>) => (() => void) | void;
+export interface LeaveGuardOptions {
+    /** 浏览器刷新 / 关闭标签页时拦截，默认 true。 */
+    beforeUnload?: boolean;
+    /** 宿主的路由拦截适配器；不传则只守卫刷新 / 关闭与 `guardDiscard`。 */
+    blockRoute?: RouteBlocker;
+}
+/**
+ * 离开守卫统一入口：未保存时拦截 刷新 / 关闭标签页（beforeunload）与路由切换（经宿主适配器），
+ * 文案与按钮统一。切换页签（页面仍被缓存）不算离开，不在这里拦截（§6.8）。
+ */
+export declare const useLeaveGuard: (dirty: boolean, options?: LeaveGuardOptions) => {
+    guardDiscard: (proceed: () => void) => void;
+};

package/dist/cjs/documentPage/leaveGuard.js

@@ -0,0 +1,91 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useLeaveGuard = exports.confirmDiscardChanges = exports.LEAVE_GUARD_TEXT = void 0;
+var _antd = require("antd");
+var _react = require("react");
+/** 离开守卫的统一文案（DESIGN.md §6.8）。 */
+var LEAVE_GUARD_TEXT = exports.LEAVE_GUARD_TEXT = {
+  title: '有未保存的修改，离开后将丢失',
+  keepEditing: '继续编辑',
+  discard: '放弃修改'
+};
+
+/**
+ * 弹出「继续编辑 / 放弃修改」确认。放弃修改返回 true；继续编辑、Esc 返回 false。
+ * 默认焦点在「继续编辑」（§6.8），确认框宽 560（§9.0）。
+ */
+var confirmDiscardChanges = exports.confirmDiscardChanges = function confirmDiscardChanges() {
+  return new Promise(function (resolve) {
+    _antd.Modal.confirm({
+      title: LEAVE_GUARD_TEXT.title,
+      okText: LEAVE_GUARD_TEXT.discard,
+      cancelText: LEAVE_GUARD_TEXT.keepEditing,
+      okButtonProps: {
+        danger: true
+      },
+      focusable: {
+        autoFocusButton: 'cancel'
+      },
+      width: 560,
+      onOk: function onOk() {
+        return resolve(true);
+      },
+      onCancel: function onCancel() {
+        return resolve(false);
+      }
+    });
+  });
+};
+
+/**
+ * 路由拦截适配器：qc-ui 不绑定路由库，由宿主把自己的路由拦截接进来。
+ * 宿主在导航发生时若 `shouldBlock()` 为真，就阻止并调用 `confirmLeave()`，得到 true 再放行。
+ * 返回取消拦截的函数。例（umi / react-router 的 history.block 一类）：
+ * `(shouldBlock, confirmLeave) => history.block(tx => { if (!shouldBlock()) return; confirmLeave().then(ok => ok && (unblock(), tx.retry())); return false; })`
+ */
+
+/**
+ * 离开守卫统一入口：未保存时拦截 刷新 / 关闭标签页（beforeunload）与路由切换（经宿主适配器），
+ * 文案与按钮统一。切换页签（页面仍被缓存）不算离开，不在这里拦截（§6.8）。
+ */
+var useLeaveGuard = exports.useLeaveGuard = function useLeaveGuard(dirty) {
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var _options$beforeUnload = options.beforeUnload,
+    beforeUnload = _options$beforeUnload === void 0 ? true : _options$beforeUnload,
+    blockRoute = options.blockRoute;
+  var dirtyRef = (0, _react.useRef)(dirty);
+  dirtyRef.current = dirty;
+  (0, _react.useEffect)(function () {
+    if (!beforeUnload || !dirty) return;
+    var handler = function handler(event) {
+      event.preventDefault();
+      // 部分浏览器要求设置 returnValue 才弹出原生提示。
+      event.returnValue = '';
+    };
+    window.addEventListener('beforeunload', handler);
+    return function () {
+      return window.removeEventListener('beforeunload', handler);
+    };
+  }, [beforeUnload, dirty]);
+  (0, _react.useEffect)(function () {
+    if (!blockRoute) return;
+    var release = blockRoute(function () {
+      return dirtyRef.current;
+    }, confirmDiscardChanges);
+    return typeof release === 'function' ? release : undefined;
+  }, [blockRoute]);
+
+  /** 返回、刷新等会丢弃录入的动作：有未保存修改先确认，放弃后才执行 `proceed`。 */
+  var guardDiscard = function guardDiscard(proceed) {
+    if (!dirtyRef.current) return proceed();
+    void confirmDiscardChanges().then(function (ok) {
+      return ok && proceed();
+    });
+  };
+  return {
+    guardDiscard: guardDiscard
+  };
+};

package/dist/cjs/draggableModal/index.d.ts

@@ -1,7 +1,30 @@
 import type { ModalProps } from 'antd';
 import React from 'react';
 import './style.less';
-declare const _default: ((props: ModalProps) => React.JSX.Element) & {
+/** 默认宽度取弹层三档（560 / 720 / 960）中的最小档，原先是 antd 默认的 520。@author nokecy */
+export declare const DRAGGABLE_MODAL_DEFAULT_WIDTH = 560;
+export interface DraggableModalProps extends ModalProps {
+    /**
+     * 弹窗内有未保存修改。传 boolean，或传函数在每次关闭时取最新值（如 `() => form.modified`）。
+     * 不传视为没有可丢失的录入，关闭不拦截，所以既有调用方行为不变。
+     */
+    dirty?: boolean | (() => boolean);
+    /**
+     * 有未保存修改（`dirty` 为真）时，右上角叉、遮罩、Esc、取消按钮先弹「继续编辑 / 放弃修改」确认，
+     * 默认 true（DESIGN.md §6.6）。选「放弃修改」才调用 onCancel，选「继续编辑」保持打开。
+     */
+    confirmOnDirtyClose?: boolean;
+    /**
+     * 是否显示八方向缩放手柄，默认 true（既有调用方一直可缩放，保持不变）。
+     * 关闭后只保留标题拖动，尺寸完全由 width / style 决定。缩放结果不持久化，重新打开恢复默认。
+     */
+    resizable?: boolean;
+    /** 缩放的最小宽度，默认 400；表单类弹层应传 560（规范最小一档）。超出视口 95% 时以视口为准。 */
+    minWidth?: number;
+    /** 缩放的最小高度，默认 300：容纳标题、底栏与至少一行内容。 */
+    minHeight?: number;
+}
+declare const _default: ((props: DraggableModalProps) => React.JSX.Element) & {
     Fill: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
 };
 export default _default;

package/dist/cjs/draggableModal/index.js

@@ -3,13 +3,14 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = void 0;
+exports.default = exports.DRAGGABLE_MODAL_DEFAULT_WIDTH = void 0;
 var _antd = require("antd");
 var _react = _interopRequireWildcard(require("react"));
 var _reactDraggable = _interopRequireDefault(require("react-draggable"));
+var _leaveGuard = require("../documentPage/leaveGuard");
 require("./style.less");
 var _jsxRuntime = require("react/jsx-runtime");
-var _excluded = ["wrapClassName", "width", "open", "style", "destroyOnClose", "destroyOnHidden", "mask", "maskClosable"];
+var _excluded = ["wrapClassName", "width", "open", "style", "destroyOnClose", "destroyOnHidden", "mask", "maskClosable", "dirty", "confirmOnDirtyClose", "onCancel", "resizable", "minWidth", "minHeight"];
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 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; }
@@ -34,6 +35,8 @@ var Fill = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
   }));
 });
 
+/** 默认宽度取弹层三档（560 / 720 / 960）中的最小档，原先是 antd 默认的 520。@author nokecy */
+var DRAGGABLE_MODAL_DEFAULT_WIDTH = exports.DRAGGABLE_MODAL_DEFAULT_WIDTH = 560;
 /** 支持标题拖动、八方向缩放及自适应内容区的公共弹窗。@author nokecy */
 var DraggableModal = function DraggableModal(props) {
   var _geometry$width;
@@ -70,7 +73,8 @@ var DraggableModal = function DraggableModal(props) {
   var resizeFrame = (0, _react.useRef)(undefined);
   // antd 6 以 destroyOnHidden、mask.closable 取代 destroyOnClose、maskClosable；旧属性仍按原默认值生效。@author nokecy
   var wrapClassName = props.wrapClassName,
-    width = props.width,
+    _props$width = props.width,
+    width = _props$width === void 0 ? DRAGGABLE_MODAL_DEFAULT_WIDTH : _props$width,
     open = props.open,
     style = props.style,
     destroyOnClose = props.destroyOnClose,
@@ -78,7 +82,30 @@ var DraggableModal = function DraggableModal(props) {
     destroyOnHidden = _props$destroyOnHidde === void 0 ? destroyOnClose !== null && destroyOnClose !== void 0 ? destroyOnClose : true : _props$destroyOnHidde,
     mask = props.mask,
     maskClosable = props.maskClosable,
+    dirty = props.dirty,
+    _props$confirmOnDirty = props.confirmOnDirtyClose,
+    confirmOnDirtyClose = _props$confirmOnDirty === void 0 ? true : _props$confirmOnDirty,
+    onCancel = props.onCancel,
+    _props$resizable = props.resizable,
+    resizable = _props$resizable === void 0 ? true : _props$resizable,
+    _props$minWidth = props.minWidth,
+    minWidth = _props$minWidth === void 0 ? 400 : _props$minWidth,
+    _props$minHeight = props.minHeight,
+    minHeight = _props$minHeight === void 0 ? 300 : _props$minHeight,
     restProps = _objectWithoutProperties(props, _excluded);
+  // 确认期间挡住重复触发（连按 Esc 不叠出多个确认框）。
+  var confirmingRef = (0, _react.useRef)(false);
+  var handleCancel = function handleCancel(event) {
+    var isDirty = typeof dirty === 'function' ? dirty() : !!dirty;
+    if (!confirmOnDirtyClose || !isDirty) return onCancel === null || onCancel === void 0 ? void 0 : onCancel(event);
+    if (confirmingRef.current) return;
+    confirmingRef.current = true;
+    void (0, _leaveGuard.confirmDiscardChanges)().then(function (ok) {
+      if (ok) onCancel === null || onCancel === void 0 || onCancel(event);
+    }).finally(function () {
+      confirmingRef.current = false;
+    });
+  };
   var mergedMask = typeof mask === 'boolean' ? {
     enabled: mask,
     closable: maskClosable !== null && maskClosable !== void 0 ? maskClosable : false
@@ -137,6 +164,7 @@ var DraggableModal = function DraggableModal(props) {
     var _resizeCleanup$curren2;
     event.preventDefault();
     event.stopPropagation();
+    if (!resizable) return;
     var panel = draggleRef.current;
     var modal = panel === null || panel === void 0 ? void 0 : panel.closest('.ant-modal');
     if (!panel || !modal) return;
@@ -163,8 +191,9 @@ var DraggableModal = function DraggableModal(props) {
       var nextWidth = start.width + (direction.includes('e') ? dx : direction.includes('w') ? -dx : 0);
       var nextHeight = start.height + (direction.includes('s') ? dy : direction.includes('n') ? -dy : 0);
       var next = {
-        width: Math.min(Math.max(400, nextWidth), window.innerWidth * 0.95),
-        height: Math.min(Math.max(300, nextHeight), window.innerHeight * 0.95),
+        // 上限（视口 95%）优先于下限，小屏上不会出现比视口还大的最小尺寸。
+        width: Math.min(Math.max(minWidth, nextWidth), window.innerWidth * 0.95),
+        height: Math.min(Math.max(minHeight, nextHeight), window.innerHeight * 0.95),
         left: start.left,
         top: start.top
       };
@@ -199,6 +228,7 @@ var DraggableModal = function DraggableModal(props) {
     destroyOnHidden: destroyOnHidden
   }, restProps), {}, {
     open: open,
+    onCancel: handleCancel,
     width: (_geometry$width = geometry === null || geometry === void 0 ? void 0 : geometry.width) !== null && _geometry$width !== void 0 ? _geometry$width : width,
     style: geometry ? _objectSpread(_objectSpread(_objectSpread({}, style), geometry), {}, {
       position: 'fixed',
@@ -242,7 +272,7 @@ var DraggableModal = function DraggableModal(props) {
             height: geometry ? '100%' : undefined,
             width: '100%'
           },
-          children: [modal, ['e', 's', 'w', 'n', 'se', 'sw', 'ne', 'nw'].map(function (direction) {
+          children: [modal, resizable && ['e', 's', 'w', 'n', 'se', 'sw', 'ne', 'nw'].map(function (direction) {
             return /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
               className: "resize-handle resize-handle-".concat(direction),
               onMouseDown: function onMouseDown(event) {

package/dist/cjs/fullScreenAlert/index.less

@@ -21,28 +21,28 @@
 .successOverlay::before {
 	top: 0;
 	left: 0;
-	background: linear-gradient(to right, green, transparent);
+	background: linear-gradient(to right, var(--ant-color-success, green), transparent);
 	transform: rotate(0deg);
 }
 
 .successOverlay::after {
 	top: 0%;
 	left: 100%;
-	background: linear-gradient(to left, green, transparent);
+	background: linear-gradient(to left, var(--ant-color-success, green), transparent);
 	transform: rotate(0deg) translate(calc(-1 * var(--alert-size)), 0px);
 }
 
 .successOverlay > div::before {
 	top: 0;
 	left: 0;
-	background: linear-gradient(to top, green, transparent);
+	background: linear-gradient(to top, var(--ant-color-success, green), transparent);
 	transform: rotate(180deg);
 }
 
 .successOverlay > div::after {
 	top: 100%;
 	left: 0;
-	background: linear-gradient(to top, green, transparent);
+	background: linear-gradient(to top, var(--ant-color-success, green), transparent);
 	transform: rotate(0deg) translate(0px, calc(-1 * var(--alert-size)));
 }
 
@@ -78,28 +78,28 @@
 .errorOverlay::before {
 	top: 0;
 	left: 0;
-	background: linear-gradient(to right, red, transparent);
+	background: linear-gradient(to right, var(--ant-color-error, red), transparent);
 	transform: rotate(0deg);
 }
 
 .errorOverlay::after {
 	top: 0%;
 	left: 100%;
-	background: linear-gradient(to left, red, transparent);
+	background: linear-gradient(to left, var(--ant-color-error, red), transparent);
 	transform: rotate(0deg) translate(calc(-1 * var(--alert-size)), 0px);
 }
 
 .errorOverlay > div::before {
 	top: 0;
 	left: 0;
-	background: linear-gradient(to top, red, transparent);
+	background: linear-gradient(to top, var(--ant-color-error, red), transparent);
 	transform: rotate(180deg);
 }
 
 .errorOverlay > div::after {
 	top: 100%;
 	left: 0;
-	background: linear-gradient(to top, red, transparent);
+	background: linear-gradient(to top, var(--ant-color-error, red), transparent);
 	transform: rotate(0deg) translate(0px, calc(-1 * var(--alert-size)));
 }
 
@@ -156,9 +156,9 @@
 }
 
 .alertBadge-success {
-	color: green;
+	color: var(--ant-color-success, green);
 }
 
 .alertBadge-error {
-	color: red;
+	color: var(--ant-color-error, red);
 }

package/dist/cjs/index.d.ts

@@ -37,7 +37,10 @@ export * from "./scanCollect/index";
 export * from "./documentPage/index";
 export { semanticTextColors, toGridTextColor, gridValueEnum } from "./ag-grid-plus/utils/valueEnumColor";
 export type { SemanticPreset } from "./ag-grid-plus/utils/valueEnumColor";
+export { StatusPill, STATUS_PILL } from "./ag-grid-plus/utils/statusPill";
+export type { StatusKey } from "./ag-grid-plus/utils/statusPill";
 export { getQcColDefProp } from "./ag-grid-plus/utils/agGridCompat";
+export { setAgGridLicenseKey } from "./ag-grid-plus/index";
 export { contrastRatio, relativeLuminance, darkenUntilContrast, lightenUntilContrast, toRgb, toHsl, fromHsl } from "./shared/contrast";
 export { BusinessDecimal, decimal, decimalText, nonNegativeDecimal, roundDecimal, sumDecimals, formatDecimal } from "./shared/businessDecimal";
 export type { DecimalValue } from "./shared/businessDecimal";

package/dist/cjs/index.js

@@ -14,6 +14,7 @@ var _exportNames = {
   useGridSchemes: true,
   LocalStorageSchemeAdapter: true,
   BackendApiSchemeAdapter: true,
+  setAgGridLicenseKey: true,
   ArrayTable: true,
   ArrayTableIndex: true,
   ColumnPresets: true,
@@ -56,6 +57,8 @@ var _exportNames = {
   semanticTextColors: true,
   toGridTextColor: true,
   gridValueEnum: true,
+  StatusPill: true,
+  STATUS_PILL: true,
   getQcColDefProp: true,
   contrastRatio: true,
   relativeLuminance: true,
@@ -271,6 +274,18 @@ Object.defineProperty(exports, "RuleBuilder", {
     return _index15.RuleBuilder;
   }
 });
+Object.defineProperty(exports, "STATUS_PILL", {
+  enumerable: true,
+  get: function get() {
+    return _statusPill.STATUS_PILL;
+  }
+});
+Object.defineProperty(exports, "StatusPill", {
+  enumerable: true,
+  get: function get() {
+    return _statusPill.StatusPill;
+  }
+});
 Object.defineProperty(exports, "TemplateCategory", {
   enumerable: true,
   get: function get() {
@@ -415,6 +430,12 @@ Object.defineProperty(exports, "semanticTextColors", {
     return _valueEnumColor.semanticTextColors;
   }
 });
+Object.defineProperty(exports, "setAgGridLicenseKey", {
+  enumerable: true,
+  get: function get() {
+    return _index.setAgGridLicenseKey;
+  }
+});
 Object.defineProperty(exports, "sumDecimals", {
   enumerable: true,
   get: function get() {
@@ -535,6 +556,7 @@ Object.keys(_index20).forEach(function (key) {
   });
 });
 var _valueEnumColor = require("./ag-grid-plus/utils/valueEnumColor");
+var _statusPill = require("./ag-grid-plus/utils/statusPill");
 var _agGridCompat = require("./ag-grid-plus/utils/agGridCompat");
 var _contrast = require("./shared/contrast");
 var _businessDecimal = require("./shared/businessDecimal");

package/dist/cjs/readPretty/arrayTable.js

@@ -47,13 +47,17 @@ var ReadingArrayTable = (0, _formilyReact.observer)(function (_ref) {
   var showIndex = columns.length > 0 && !(0, _indexColumn.hasOwnIndexColumn)(sources);
   if (showIndex) columns.unshift((0, _indexColumn.makeIndexColumn)());
   var theme = (0, _theme.useArrayTableTheme)();
+  var _useArrayTableMetrics = (0, _theme.useArrayTableMetrics)(),
+    rowHeight = _useArrayTableMetrics.rowHeight,
+    headerHeight = _useArrayTableMetrics.headerHeight;
   return /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
     style: {
       height: height !== null && height !== void 0 ? height : 400
     },
     children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_agGridReact.AgGridReact, {
       theme: theme,
-      rowHeight: _theme.ARRAY_TABLE_ROW_HEIGHT,
+      rowHeight: rowHeight,
+      headerHeight: headerHeight,
       enableCellTextSelection: true,
       ensureDomOrder: true,
       defaultColDef: {

package/dist/cjs/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;

package/dist/cjs/scanCollect/ScanFeedbackInput.js

@@ -0,0 +1,113 @@
+"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 _icons = require("@ant-design/icons");
+var _react = _interopRequireWildcard(require("react"));
+var _index = _interopRequireDefault(require("../fullScreenAlert/index"));
+var _ScanInput = _interopRequireDefault(require("./ScanInput"));
+var _scanSound = require("./scanSound");
+var _jsxRuntime = require("react/jsx-runtime");
+var _excluded = ["result", "sound", "flashDuration"];
+/** 一次扫码的结果。每次扫码传入新对象即重新触发一次边缘闪动；结果文字保留到下一次传入。 */
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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 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 _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 _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; }
+/** 反馈区预留高度：徽标出现、消失都不推动页面其余内容。 */
+var BADGE_HEIGHT = 48;
+
+/**
+ * 扫码输入框 + 反馈整体组件（规范 §11.1）：
+ * 输入框下方预留固定高度的图标+文字徽标（语义色，保留到下一次扫码），
+ * 屏幕边缘闪动约 1.2 秒后收起，可选提示音。
+ * 边缘闪动层相对最近的定位祖先铺满，宿主需要整屏效果时把它放进整页容器即可。
+ *
+ * @author nokecy
+ */
+var ScanFeedbackInput = function ScanFeedbackInput(_ref) {
+  var _result$message;
+  var result = _ref.result,
+    _ref$sound = _ref.sound,
+    sound = _ref$sound === void 0 ? false : _ref$sound,
+    _ref$flashDuration = _ref.flashDuration,
+    flashDuration = _ref$flashDuration === void 0 ? 1200 : _ref$flashDuration,
+    inputProps = _objectWithoutProperties(_ref, _excluded);
+  // 每次拿到新的 result 递增，作为闪动层的 key 使其重新挂载、从头计时。
+  var _useState = (0, _react.useState)({
+      id: 0,
+      active: false
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    flash = _useState2[0],
+    setFlash = _useState2[1];
+  var first = (0, _react.useRef)(true);
+  (0, _react.useEffect)(function () {
+    // 首次渲染时的 result 视为历史结果（徽标显示），不闪、不响。
+    if (first.current) {
+      first.current = false;
+      return;
+    }
+    if (!result) return;
+    setFlash(function (prev) {
+      return {
+        id: prev.id + 1,
+        active: true
+      };
+    });
+    if (sound) (0, _scanSound.playScanSound)(result.type);
+  }, [result]); // eslint-disable-line react-hooks/exhaustive-deps
+  var onFlashChange = (0, _react.useCallback)(function (active) {
+    return setFlash(function (prev) {
+      return _objectSpread(_objectSpread({}, prev), {}, {
+        active: active
+      });
+    });
+  }, []);
+  var isError = (result === null || result === void 0 ? void 0 : result.type) === 'error';
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+    className: "scanFeedbackInput",
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_ScanInput.default, _objectSpread({}, inputProps)), /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      className: "scanFeedbackBadge",
+      role: "status",
+      "aria-live": "polite",
+      style: {
+        minHeight: BADGE_HEIGHT,
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        gap: 8,
+        fontSize: 20,
+        fontWeight: 700,
+        color: result ? isError ? 'var(--ant-color-error, red)' : 'var(--ant-color-success, green)' : undefined
+      },
+      children: result ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+        children: [isError ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.CloseCircleFilled, {}) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.CheckCircleFilled, {}), /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+          children: (_result$message = result.message) !== null && _result$message !== void 0 ? _result$message : isError ? '失败' : '成功'
+        })]
+      }) : null
+    }), result ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.default, {
+      active: flash.active,
+      type: result.type,
+      duration: flashDuration,
+      showIcon: false,
+      onChange: onFlashChange
+    }, flash.id) : null]
+  });
+};
+var _default = exports.default = ScanFeedbackInput;

package/dist/cjs/scanCollect/index.d.ts

@@ -6,6 +6,10 @@
  */
 export { default as ScanInput } from './ScanInput';
 export type { ScanInputProps } from './ScanInput';
+export { default as ScanFeedbackInput } from './ScanFeedbackInput';
+export type { ScanFeedbackInputProps, ScanResult } from './ScanFeedbackInput';
+export { playScanSound } from './scanSound';
+export type { ScanSoundType } from './scanSound';
 export { default as usePromiseQueue } from './usePromiseQueue';
 export type { PromiseQueue, PromiseQueueOptions, QueueTask } from './usePromiseQueue';
 export { createRequestGate } from './requestGate';