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

package/dist/esm/documentPage/index.js

@@ -10,6 +10,7 @@ export { DisabledActionHint } from "./DisabledActionHint";
 export { DocumentHeader, DocumentStatusBar } from "./DocumentHeader";
 export { formatDocumentTime, latestDocumentAuditStep, normalizeDocumentAuditSteps } from "./documentAudit";
 export { confirmDocumentAction, formatValidationFeedback, pickPrimaryAction, reloadAfterAction, submitButtonLabel, useDocumentActions, useDocumentEditState, validateBeforeConfirm, warnSavedButActionFailed } from "./documentPage";
+export { LEAVE_GUARD_TEXT, confirmDiscardChanges, useLeaveGuard } from "./leaveGuard";
 export { useHeaderItemToggleGrid } from "./useHeaderItemToggleGrid";
 export { createHeaderItemGetRowId, getHeaderItemRowId } from "./headerItemRowId";
 export { useSelectNumberInputOnFocus } from "./useSelectNumberInputOnFocus";

package/dist/esm/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/esm/documentPage/leaveGuard.js

@@ -0,0 +1,86 @@
+import { Modal } from 'antd';
+import { useEffect, useRef } from 'react';
+
+/** 离开守卫的统一文案（DESIGN.md §6.8）。 */
+export var LEAVE_GUARD_TEXT = {
+  title: '有未保存的修改，离开后将丢失',
+  keepEditing: '继续编辑',
+  discard: '放弃修改'
+};
+
+/**
+ * 弹出「继续编辑 / 放弃修改」确认。放弃修改返回 true；继续编辑、Esc 返回 false。
+ * 默认焦点在「继续编辑」（§6.8），确认框宽 560（§9.0）。
+ */
+export var confirmDiscardChanges = function confirmDiscardChanges() {
+  return new Promise(function (resolve) {
+    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）。
+ */
+export var 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 = useRef(dirty);
+  dirtyRef.current = dirty;
+  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]);
+  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/esm/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/esm/draggableModal/index.js

@@ -1,4 +1,4 @@
-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 _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
@@ -16,6 +16,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import { Modal } from 'antd';
 import React, { useRef, useState, useEffect } from 'react';
 import Draggable from 'react-draggable';
+import { confirmDiscardChanges } from "../documentPage/leaveGuard";
 import "./style.less";
 
 /** 弹窗中随边框缩放的内容区；初始高度由调用方提供，缩放后占用剩余空间。@author nokecy */
@@ -28,6 +29,8 @@ var Fill = /*#__PURE__*/React.forwardRef(function (props, ref) {
   }));
 });
 
+/** 默认宽度取弹层三档（560 / 720 / 960）中的最小档，原先是 antd 默认的 520。@author nokecy */
+export var DRAGGABLE_MODAL_DEFAULT_WIDTH = 560;
 /** 支持标题拖动、八方向缩放及自适应内容区的公共弹窗。@author nokecy */
 var DraggableModal = function DraggableModal(props) {
   var _geometry$width;
@@ -64,7 +67,8 @@ var DraggableModal = function DraggableModal(props) {
   var resizeFrame = 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,
@@ -72,7 +76,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 = 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 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
@@ -131,6 +158,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;
@@ -157,8 +185,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
       };
@@ -193,6 +222,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',
@@ -236,7 +266,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__*/_jsx("div", {
               className: "resize-handle resize-handle-".concat(direction),
               onMouseDown: function onMouseDown(event) {

package/dist/esm/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/esm/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/esm/index.js

@@ -34,7 +34,9 @@ export { GridPlusError, ErrorType, ErrorSeverity } from "./ag-grid-plus/errors/i
 export * from "./scanCollect/index";
 export * from "./documentPage/index";
 export { semanticTextColors, toGridTextColor, gridValueEnum } from "./ag-grid-plus/utils/valueEnumColor";
+export { StatusPill, STATUS_PILL } 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 * from "./formily/index";

package/dist/esm/readPretty/arrayTable.js

@@ -12,7 +12,7 @@ import { AgGridReact } from 'ag-grid-react';
 import { buildArrayTableColumns, useArrayTableSources } from "../array-table/utils";
 import { groupColumnDefs } from "../array-table/columnGroup";
 import { ARRAY_TABLE_INDEX_FIELD, hasOwnIndexColumn, makeIndexColumn } from "../array-table/indexColumn";
-import { ARRAY_TABLE_ROW_HEIGHT, useArrayTableTheme } from "../array-table/theme";
+import { useArrayTableMetrics, useArrayTableTheme } from "../array-table/theme";
 import { hoistStatics } from "./hoistStatics";
 import React, { useMemo, useRef } from 'react';
 import { installDisplaySequenceOrder } from "../shared/gridSequence";
@@ -43,13 +43,17 @@ var ReadingArrayTable = observer(function (_ref) {
   var showIndex = columns.length > 0 && !hasOwnIndexColumn(sources);
   if (showIndex) columns.unshift(makeIndexColumn());
   var theme = useArrayTableTheme();
+  var _useArrayTableMetrics = useArrayTableMetrics(),
+    rowHeight = _useArrayTableMetrics.rowHeight,
+    headerHeight = _useArrayTableMetrics.headerHeight;
   return /*#__PURE__*/_jsx("div", {
     style: {
       height: height !== null && height !== void 0 ? height : 400
     },
     children: /*#__PURE__*/_jsx(AgGridReact, {
       theme: theme,
-      rowHeight: ARRAY_TABLE_ROW_HEIGHT,
+      rowHeight: rowHeight,
+      headerHeight: headerHeight,
       enableCellTextSelection: true,
       ensureDomOrder: true,
       defaultColDef: {

package/dist/esm/scanCollect/ScanFeedbackInput.d.ts

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

package/dist/esm/scanCollect/ScanFeedbackInput.js

@@ -0,0 +1,107 @@
+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 _excluded = ["result", "sound", "flashDuration"];
+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; }
+import { CheckCircleFilled, CloseCircleFilled } from '@ant-design/icons';
+import React, { useCallback, useEffect, useRef, useState } from 'react';
+import FullScreenAlert from "../fullScreenAlert/index";
+import ScanInput from "./ScanInput";
+import { playScanSound } from "./scanSound";
+
+/** 一次扫码的结果。每次扫码传入新对象即重新触发一次边缘闪动；结果文字保留到下一次传入。 */
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+/** 反馈区预留高度：徽标出现、消失都不推动页面其余内容。 */
+var 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 = useState({
+      id: 0,
+      active: false
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    flash = _useState2[0],
+    setFlash = _useState2[1];
+  var first = useRef(true);
+  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) playScanSound(result.type);
+  }, [result]); // eslint-disable-line react-hooks/exhaustive-deps
+  var onFlashChange = 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__*/_jsxs("div", {
+    className: "scanFeedbackInput",
+    children: [/*#__PURE__*/_jsx(ScanInput, _objectSpread({}, inputProps)), /*#__PURE__*/_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__*/_jsxs(_Fragment, {
+        children: [isError ? /*#__PURE__*/_jsx(CloseCircleFilled, {}) : /*#__PURE__*/_jsx(CheckCircleFilled, {}), /*#__PURE__*/_jsx("span", {
+          children: (_result$message = result.message) !== null && _result$message !== void 0 ? _result$message : isError ? '失败' : '成功'
+        })]
+      }) : null
+    }), result ? /*#__PURE__*/_jsx(FullScreenAlert, {
+      active: flash.active,
+      type: result.type,
+      duration: flashDuration,
+      showIcon: false,
+      onChange: onFlashChange
+    }, flash.id) : null]
+  });
+};
+export default ScanFeedbackInput;

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

package/dist/esm/scanCollect/index.js

@@ -5,6 +5,8 @@
  * @author nokecy
  */
 export { default as ScanInput } from "./ScanInput";
+export { default as ScanFeedbackInput } from "./ScanFeedbackInput";
+export { playScanSound } from "./scanSound";
 export { default as usePromiseQueue } from "./usePromiseQueue";
 export { createRequestGate } from "./requestGate";
 export { blurOn, canTakeFocus, focusOn } from "./focus";

package/dist/esm/scanCollect/scanSound.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 扫码提示音：用 WebAudio 合成，不依赖音频资源文件。
+ * AudioContext 是模块级单例——浏览器限制同一页面可创建的上下文数量，且需要在用户手势后才能出声，
+ * 每次扫码都 new 一个既浪费也会被拒绝。
+ *
+ * @author nokecy
+ */
+export type ScanSoundType = 'success' | 'error';
+/**
+ * 播放一次扫码提示音。静默失败：没有 WebAudio、上下文被浏览器挂起且无法恢复时直接忽略，不影响采集流程。
+ * @returns 是否已提交播放
+ */
+export declare function playScanSound(type: ScanSoundType): boolean;
+/** 仅测试用：丢弃共享上下文。 */
+export declare function resetScanSoundForTest(): void;

package/dist/esm/scanCollect/scanSound.js

@@ -0,0 +1,84 @@
+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 _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 _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; }
+/**
+ * 扫码提示音：用 WebAudio 合成，不依赖音频资源文件。
+ * AudioContext 是模块级单例——浏览器限制同一页面可创建的上下文数量，且需要在用户手势后才能出声，
+ * 每次扫码都 new 一个既浪费也会被拒绝。
+ *
+ * @author nokecy
+ */
+
+var sharedContext;
+
+/** 取（或创建）共享的 AudioContext；环境不支持 WebAudio 时返回 undefined。 */
+function getAudioContext() {
+  var _window$AudioContext;
+  if (sharedContext) return sharedContext;
+  var Ctor = typeof window === 'undefined' ? undefined : (_window$AudioContext = window.AudioContext) !== null && _window$AudioContext !== void 0 ? _window$AudioContext : window.webkitAudioContext;
+  if (!Ctor) return undefined;
+  try {
+    sharedContext = new Ctor();
+  } catch (_unused) {
+    return undefined;
+  }
+  return sharedContext;
+}
+
+/** 每种结果的音符序列：[频率 Hz, 起点 s, 时长 s]。成功一声高短音；失败两声低音，听感上与成功明显不同。 */
+var TONES = {
+  success: [[880, 0, 0.12]],
+  error: [[220, 0, 0.18], [220, 0.26, 0.18]]
+};
+
+/**
+ * 播放一次扫码提示音。静默失败：没有 WebAudio、上下文被浏览器挂起且无法恢复时直接忽略，不影响采集流程。
+ * @returns 是否已提交播放
+ */
+export function playScanSound(type) {
+  var ctx = getAudioContext();
+  if (!ctx) return false;
+  try {
+    var _ctx$resume;
+    if (ctx.state === 'suspended') void ((_ctx$resume = ctx.resume) === null || _ctx$resume === void 0 ? void 0 : _ctx$resume.call(ctx));
+    var now = ctx.currentTime;
+    var _iterator = _createForOfIteratorHelper(TONES[type]),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var _step$value = _slicedToArray(_step.value, 3),
+          frequency = _step$value[0],
+          offset = _step$value[1],
+          length = _step$value[2];
+        var osc = ctx.createOscillator();
+        var gain = ctx.createGain();
+        osc.type = type === 'error' ? 'square' : 'sine';
+        osc.frequency.value = frequency;
+        // 起止做短包络，避免爆音。
+        gain.gain.setValueAtTime(0.0001, now + offset);
+        gain.gain.exponentialRampToValueAtTime(0.2, now + offset + 0.01);
+        gain.gain.exponentialRampToValueAtTime(0.0001, now + offset + length);
+        osc.connect(gain);
+        gain.connect(ctx.destination);
+        osc.start(now + offset);
+        osc.stop(now + offset + length + 0.02);
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+    return true;
+  } catch (_unused2) {
+    return false;
+  }
+}
+
+/** 仅测试用：丢弃共享上下文。 */
+export function resetScanSoundForTest() {
+  sharedContext = undefined;
+}