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

package/dist/esm/deleteConfirm/index.js

@@ -13,12 +13,48 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 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; }
-import React from "react";
-import { Modal } from "antd";
+import React, { useState } from "react";
+import { Input, Modal } from "antd";
 import { ExclamationCircleFilled } from "@ant-design/icons";
 import { jsx as _jsx } from "react/jsx-runtime";
-import { Fragment as _Fragment } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+/** 确认框默认宽度，对应规范「确认、单字段编辑 Modal 560」。 */
+export var CONFIRM_DIALOG_WIDTH = 560;
+
+/** 输入确认区：正文 + 一行输入框，键入值与 expected 完全一致时通知外层点亮确认按钮。 */
+var TypeToConfirm = function TypeToConfirm(_ref) {
+  var body = _ref.body,
+    expected = _ref.expected,
+    onMatchChange = _ref.onMatchChange;
+  var _useState = useState(''),
+    _useState2 = _slicedToArray(_useState, 2),
+    value = _useState2[0],
+    setValue = _useState2[1];
+  return /*#__PURE__*/_jsxs("div", {
+    children: [/*#__PURE__*/_jsx("div", {
+      style: {
+        marginBottom: 12
+      },
+      children: body
+    }), /*#__PURE__*/_jsxs("div", {
+      style: {
+        marginBottom: 8
+      },
+      children: ["\u8BF7\u8F93\u5165 ", /*#__PURE__*/_jsx("strong", {
+        children: expected
+      }), " \u4EE5\u786E\u8BA4"]
+    }), /*#__PURE__*/_jsx(Input, {
+      value: value,
+      "aria-label": "\u8F93\u5165 ".concat(expected, " \u4EE5\u786E\u8BA4"),
+      onChange: function onChange(event) {
+        setValue(event.target.value);
+        onMatchChange(event.target.value === expected);
+      }
+    })]
+  });
+};
+
 /**
  * DeleteConfirm 删除确认组件
  *
@@ -44,6 +80,11 @@ var DeleteConfirm = function DeleteConfirm(props) {
     okText = props.okText,
     _props$danger = props.danger,
     danger = _props$danger === void 0 ? true : _props$danger,
+    confirmText = props.confirmText,
+    _props$autoFocusButto = props.autoFocusButton,
+    autoFocusButton = _props$autoFocusButto === void 0 ? 'cancel' : _props$autoFocusButto,
+    _props$width = props.width,
+    width = _props$width === void 0 ? CONFIRM_DIALOG_WIDTH : _props$width,
     children = props.children;
 
   // 保留宿主主题，并让 antd 接管异步提交的加载与失败恢复。@author nokecy
@@ -52,8 +93,8 @@ var DeleteConfirm = function DeleteConfirm(props) {
     modal = _Modal$useModal2[0],
     contextHolder = _Modal$useModal2[1];
   var showPromiseConfirm = /*#__PURE__*/function () {
-    var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(event) {
-      var titleText, contentText;
+    var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(event) {
+      var titleText, contentText, typed, instance;
       return _regeneratorRuntime().wrap(function _callee$(_context) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
@@ -62,14 +103,33 @@ var DeleteConfirm = function DeleteConfirm(props) {
             // 不传时的兜底只承诺「不可撤销」：原来的默认正文是把 title 拼进去，
             // 拼出来是一句病句，而且始终没告诉用户动的是哪条数据。@author nokecy
             contentText = content || '该操作不可撤销，请确认后继续。';
-            _context.next = 4;
-            return modal.confirm(_objectSpread(_objectSpread({
+            typed = typeof confirmText === 'string' && confirmText.length > 0;
+            _context.next = 5;
+            return instance = modal.confirm(_objectSpread(_objectSpread({
               title: titleText,
               icon: /*#__PURE__*/_jsx(ExclamationCircleFilled, {}),
-              content: contentText,
-              okButtonProps: {
+              width: width,
+              focusable: {
+                autoFocusButton: autoFocusButton
+              },
+              content: typed ? /*#__PURE__*/_jsx(TypeToConfirm, {
+                body: contentText,
+                expected: confirmText,
+                onMatchChange: function onMatchChange(matched) {
+                  var _instance;
+                  return (_instance = instance) === null || _instance === void 0 ? void 0 : _instance.update({
+                    okButtonProps: {
+                      danger: danger,
+                      disabled: !matched
+                    }
+                  });
+                }
+              }) : contentText,
+              okButtonProps: _objectSpread({
                 danger: danger
-              }
+              }, typed ? {
+                disabled: true
+              } : {})
             }, okText ? {
               okText: okText
             } : {}), {}, {
@@ -81,14 +141,14 @@ var DeleteConfirm = function DeleteConfirm(props) {
                 });
               }
             }));
-          case 4:
+          case 5:
           case "end":
             return _context.stop();
         }
       }, _callee);
     }));
     return function showPromiseConfirm(_x) {
-      return _ref.apply(this, arguments);
+      return _ref2.apply(this, arguments);
     };
   }();
   return /*#__PURE__*/_jsxs(_Fragment, {

package/dist/esm/dialogSelect/index.d.ts

@@ -49,7 +49,26 @@ interface IDialogSelectProps extends SelectProps<any> {
     }) => React.ReactNode;
     /** 选择窗口里使用的表格组件，默认 `AgGridPlus`；宿主可注入自己封装过的表格基座。 */
     gridComponent?: React.ComponentType<any>;
+    /**
+     * 候选面板第一列（编码）取的字段名。传入后候选渲染成「编码 | 名称」两列，编码在前（DESIGN.md §6.12）。
+     * 不传则保持 Select 默认的单列文字。
+     */
+    codeField?: string;
+    /** `onSearch` 的防抖毫秒数，默认 200（§6.12）；0 关闭防抖。仅在传了 `onSearch` 时有意义。 */
+    searchDebounce?: number;
+    /**
+     * 远程检索时候选面板最多展示的条数，默认 20，超出写「仅显示前 20 条，继续输入可缩小范围」，不静默截断。
+     * 只在传了 `onSearch`（服务端检索）时生效；本地全量下拉不截断。传 0 关闭。
+     */
+    maxOptions?: number;
+    /**
+     * 「最近使用」的存储键。传入后输入框为空时候选面板先列最近选过的至多 5 条，其后是档案候选。
+     * 存在 localStorage，需要「按用户记」时由调用方把用户标识拼进键里；不传则不启用。
+     */
+    recentKey?: string;
 }
+/** 候选面板最小宽，栅格里的输入区放不下两列时仍可读（§6.12）。 */
+export declare const DIALOG_SELECT_MIN_POPUP_WIDTH = 360;
 export { IDialogSelectProps };
 declare const _default: (props: IDialogSelectProps) => React.ReactElement;
 export default _default;

package/dist/esm/dialogSelect/index.js

@@ -1,5 +1,5 @@
-var _excluded = ["request", "columnDefs", "value", "labelField", "valueField", "displayField", "onChangeItem", "hideBtn", "useAutoComplete", "queryFun", "pagedApiAdapter", "resolveSelected", "selectedScopeKey", "modalWidth", "dialogZIndex", "dialogMode", "dialogPageSize", "dialogPageSizeOptions", "dialogGridKey", "dialogDataSource", "dialogIsRowSelectable", "dialogRenderer", "gridComponent"],
-  _excluded2 = ["request", "columnDefs", "labelField", "valueField", "displayField", "onChangeItem", "hideBtn", "useAutoComplete", "queryFun", "pagedApiAdapter", "resolveSelected", "selectedScopeKey", "modalWidth", "dialogZIndex", "dialogMode", "dialogPageSize", "dialogPageSizeOptions", "dialogGridKey", "dialogDataSource", "dialogIsRowSelectable", "dialogRenderer", "gridComponent"];
+var _excluded = ["request", "columnDefs", "value", "labelField", "valueField", "displayField", "onChangeItem", "hideBtn", "useAutoComplete", "queryFun", "pagedApiAdapter", "resolveSelected", "selectedScopeKey", "modalWidth", "dialogZIndex", "dialogMode", "dialogPageSize", "dialogPageSizeOptions", "dialogGridKey", "dialogDataSource", "dialogIsRowSelectable", "dialogRenderer", "gridComponent", "codeField", "searchDebounce", "maxOptions", "recentKey"],
+  _excluded2 = ["request", "columnDefs", "labelField", "valueField", "displayField", "onChangeItem", "hideBtn", "useAutoComplete", "queryFun", "pagedApiAdapter", "resolveSelected", "selectedScopeKey", "modalWidth", "dialogZIndex", "dialogMode", "dialogPageSize", "dialogPageSizeOptions", "dialogGridKey", "dialogDataSource", "dialogIsRowSelectable", "dialogRenderer", "gridComponent", "codeField", "searchDebounce", "maxOptions", "recentKey"];
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
@@ -9,6 +9,10 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 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 _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 _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); }
@@ -21,9 +25,9 @@ import { AutoComplete, ConfigProvider, theme } from 'antd';
 import { observer, useField } from '@nokecy/formily-react';
 import { Select } from '@nokecy/formily-antd';
 import { SearchOutlined } from '@ant-design/icons';
-import React, { useState } from 'react';
+import React, { useEffect, useMemo, useState } from 'react';
 import { AgGridPlus } from "../ag-grid-plus/index";
-import { useBoolean, useControllableValue } from 'ahooks';
+import { useBoolean, useControllableValue, useDebounceFn } from 'ahooks';
 import DraggableModal from "../draggableModal/index";
 import { Select as ReadingSelect } from "../readPretty/controls";
 import { normalizeSelectValue } from "../readPretty/selectValue";
@@ -36,6 +40,30 @@ import "./index.less";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
 import { Fragment as _Fragment } from "react/jsx-runtime";
+/** 候选面板最小宽，栅格里的输入区放不下两列时仍可读（§6.12）。 */
+export var DIALOG_SELECT_MIN_POPUP_WIDTH = 360;
+/** 最近使用的上限（§6.12）。 */
+var RECENT_LIMIT = 5;
+var recentStorageKey = function recentStorageKey(key) {
+  return "qc-dialog-select:recent:".concat(key);
+};
+var readRecent = function readRecent(key) {
+  if (!key) return [];
+  try {
+    var _window$localStorage$;
+    var parsed = JSON.parse((_window$localStorage$ = window.localStorage.getItem(recentStorageKey(key))) !== null && _window$localStorage$ !== void 0 ? _window$localStorage$ : '[]');
+    return Array.isArray(parsed) ? parsed.slice(0, RECENT_LIMIT) : [];
+  } catch (_unused) {
+    return [];
+  }
+};
+var writeRecent = function writeRecent(key, items) {
+  try {
+    window.localStorage.setItem(recentStorageKey(key), JSON.stringify(items.slice(0, RECENT_LIMIT)));
+  } catch (_unused2) {
+    // 存储不可用时静默放弃，不影响选择本身。
+  }
+};
 var DialogSelectInner = function DialogSelectInner(props) {
   var _rest$labelRender, _selectRows$length;
   // 这些是本组件自己的属性，不能透传给 Select（否则会落到 DOM 上触发未知属性告警）。
@@ -64,6 +92,12 @@ var DialogSelectInner = function DialogSelectInner(props) {
     dialogIsRowSelectable = props.dialogIsRowSelectable,
     dialogRenderer = props.dialogRenderer,
     gridComponent = props.gridComponent,
+    codeField = props.codeField,
+    _props$searchDebounce = props.searchDebounce,
+    searchDebounce = _props$searchDebounce === void 0 ? 200 : _props$searchDebounce,
+    _props$maxOptions = props.maxOptions,
+    maxOptions = _props$maxOptions === void 0 ? 20 : _props$maxOptions,
+    recentKey = props.recentKey,
     rest = _objectWithoutProperties(props, _excluded);
   var Grid = gridComponent !== null && gridComponent !== void 0 ? gridComponent : AgGridPlus;
   var _useControllableValue = useControllableValue(props),
@@ -88,6 +122,99 @@ var DialogSelectInner = function DialogSelectInner(props) {
   var selectionMode = dialogMode !== null && dialogMode !== void 0 ? dialogMode : isMultipleValue ? 'multiple' : 'single';
   var key = valueField !== null && valueField !== void 0 ? valueField : 'id';
   var localData = Array.isArray(dialogDataSource);
+
+  // 候选面板：防抖检索、最近使用、前 N 条上限。
+  var _useState3 = useState(''),
+    _useState4 = _slicedToArray(_useState3, 2),
+    searchText = _useState4[0],
+    setSearchText = _useState4[1];
+  var _useState5 = useState(function () {
+      return readRecent(recentKey);
+    }),
+    _useState6 = _slicedToArray(_useState5, 2),
+    recent = _useState6[0],
+    setRecent = _useState6[1];
+  useEffect(function () {
+    return setRecent(readRecent(recentKey));
+  }, [recentKey]);
+  var remember = function remember(items) {
+    if (!recentKey) return;
+    var merged = [].concat(_toConsumableArray(items), _toConsumableArray(recent.filter(function (old) {
+      return !items.some(function (it) {
+        return it.value === old.value;
+      });
+    }))).slice(0, RECENT_LIMIT);
+    setRecent(merged);
+    writeRecent(recentKey, merged);
+  };
+  var hostOnSearch = rest.onSearch;
+  var _useDebounceFn = useDebounceFn(function (text) {
+      return hostOnSearch === null || hostOnSearch === void 0 ? void 0 : hostOnSearch(text);
+    }, {
+      wait: searchDebounce
+    }),
+    debouncedSearch = _useDebounceFn.run;
+  var handleSearch = hostOnSearch ? function (text) {
+    setSearchText(text);
+    if (searchDebounce > 0) debouncedSearch(text);else hostOnSearch(text);
+  } : undefined;
+  var remoteSearch = !!hostOnSearch;
+  var _useMemo = useMemo(function () {
+      var source = rest.options;
+      if (!Array.isArray(source)) return {
+        options: source,
+        truncated: false
+      };
+      var showRecent = recent.length > 0 && !searchText;
+      var recentValues = showRecent ? new Set(recent.map(function (it) {
+        return it.value;
+      })) : undefined;
+      var plain = recentValues ? source.filter(function (it) {
+        return !recentValues.has(it.value);
+      }) : source;
+      var limit = remoteSearch && maxOptions > 0 ? maxOptions : Infinity;
+      var cut = plain.length > limit;
+      var list = cut ? plain.slice(0, limit) : plain;
+      return {
+        options: showRecent ? [{
+          label: '最近使用',
+          options: recent
+        }].concat(_toConsumableArray(list)) : list,
+        truncated: cut
+      };
+    }, [rest.options, recent, searchText, remoteSearch, maxOptions]),
+    panelOptions = _useMemo.options,
+    truncated = _useMemo.truncated;
+  var optionRender = codeField ? function (option) {
+    var _option$data;
+    return /*#__PURE__*/_jsxs("span", {
+      className: "qc-dialog-select-option",
+      children: [/*#__PURE__*/_jsx("span", {
+        className: "qc-dialog-select-option-code",
+        children: (_option$data = option.data) === null || _option$data === void 0 ? void 0 : _option$data[codeField]
+      }), /*#__PURE__*/_jsx("span", {
+        className: "qc-dialog-select-option-name",
+        children: option.label
+      })]
+    });
+  } : undefined;
+  var hostPopupRender = rest.popupRender;
+  var popupRender = truncated ? function (menu) {
+    for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+      args[_key - 1] = arguments[_key];
+    }
+    return /*#__PURE__*/_jsxs(_Fragment, {
+      children: [hostPopupRender ? hostPopupRender.apply(void 0, [menu].concat(args)) : menu, /*#__PURE__*/_jsx("div", {
+        className: "qc-dialog-select-hint",
+        style: {
+          padding: '4px 12px',
+          fontSize: 12,
+          color: token.colorTextTertiary
+        },
+        children: "\u4EC5\u663E\u793A\u524D ".concat(maxOptions, " \u6761\uFF0C\u7EE7\u7EED\u8F93\u5165\u53EF\u7F29\u5C0F\u8303\u56F4")
+      })]
+    });
+  } : hostPopupRender;
   var getValue = function getValue(rows) {
     var row = rows[0];
     var labelKey = labelField !== null && labelField !== void 0 ? labelField : 'name';
@@ -116,6 +243,12 @@ var DialogSelectInner = function DialogSelectInner(props) {
     if (dialogIsRowSelectable && rows.some(function (row) {
       return !dialogIsRowSelectable(row);
     })) return;
+    remember(rows.map(function (row) {
+      return _objectSpread({
+        value: row[key],
+        label: row[labelField !== null && labelField !== void 0 ? labelField : 'name']
+      }, codeField ? _defineProperty({}, codeField, row[codeField]) : {});
+    }));
     setState(getValue(rows));
     close();
     // 回传完整数据行，供调用方回填关联字段。
@@ -150,14 +283,51 @@ var DialogSelectInner = function DialogSelectInner(props) {
     '--qc-dialog-select-trigger-color': token.colorTextTertiary,
     '--qc-dialog-select-trigger-hover': token.colorPrimary
   };
-  var commonProps = _objectSpread(_objectSpread({}, rest), {}, {
+  var commonProps = _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
+    popupMatchSelectWidth: DIALOG_SELECT_MIN_POPUP_WIDTH
+  }, rest), panelOptions !== rest.options ? {
+    options: panelOptions
+  } : {}), optionRender && !rest.optionRender ? {
+    optionRender: optionRender
+  } : {}), handleSearch ? {
+    onSearch: handleSearch
+  } : {}), popupRender ? {
+    popupRender: popupRender
+  } : {}), {}, {
+    onSelect: function onSelect(value, option) {
+      var _option$value, _rest$onSelect;
+      if (recentKey && option) remember([_objectSpread({
+        value: (_option$value = option.value) !== null && _option$value !== void 0 ? _option$value : value,
+        label: option.label
+      }, codeField ? _defineProperty({}, codeField, option[codeField]) : {})]);
+      (_rest$onSelect = rest.onSelect) === null || _rest$onSelect === void 0 || _rest$onSelect.call(rest, value, option);
+    },
+    onOpenChange: function onOpenChange(open) {
+      var _rest$onOpenChange, _onDropdownVisibleCha, _ref3;
+      // 收起后清空检索词，下次展开才会重新展示「最近使用」。
+      if (!open) setSearchText('');
+      (_rest$onOpenChange = rest.onOpenChange) === null || _rest$onOpenChange === void 0 || _rest$onOpenChange.call(rest, open);
+      // antd 6 同时认 onOpenChange 与旧的 onDropdownVisibleChange，这里接管前者，旧回调要手动转发。
+      (_onDropdownVisibleCha = (_ref3 = rest).onDropdownVisibleChange) === null || _onDropdownVisibleCha === void 0 || _onDropdownVisibleCha.call(_ref3, open);
+    },
+    onKeyDown: function onKeyDown(event) {
+      var _rest$onKeyDown;
+      (_rest$onKeyDown = rest.onKeyDown) === null || _rest$onKeyDown === void 0 || _rest$onKeyDown.call(rest, event);
+      // F7 打开选择窗（§6.12）；与点放大镜等价。
+      if (event.key === 'F7' && canOpen && !event.defaultPrevented) {
+        event.preventDefault();
+        event.stopPropagation();
+        setSelectRows(undefined);
+        setTrue();
+      }
+    },
     labelRender: displayField === 'value' ? function (item) {
       return formatSelectDisplay(item, 'value');
     } : (_rest$labelRender = rest.labelRender) !== null && _rest$labelRender !== void 0 ? _rest$labelRender : function (item) {
-      var _ref, _selectedLabels$find$, _selectedLabels$find;
-      return (_ref = (_selectedLabels$find$ = (_selectedLabels$find = selectedLabels.find(function (option) {
+      var _ref4, _selectedLabels$find$, _selectedLabels$find;
+      return (_ref4 = (_selectedLabels$find$ = (_selectedLabels$find = selectedLabels.find(function (option) {
         return option.value === item.value;
-      })) === null || _selectedLabels$find === void 0 ? void 0 : _selectedLabels$find.label) !== null && _selectedLabels$find$ !== void 0 ? _selectedLabels$find$ : item.label) !== null && _ref !== void 0 ? _ref : item.value;
+      })) === null || _selectedLabels$find === void 0 ? void 0 : _selectedLabels$find.label) !== null && _selectedLabels$find$ !== void 0 ? _selectedLabels$find$ : item.label) !== null && _ref4 !== void 0 ? _ref4 : item.value;
     },
     className: mergedClassName,
     value: selectedDisplayValue(state, selectedLabels, props.labelInValue),
@@ -200,8 +370,8 @@ var DialogSelectInner = function DialogSelectInner(props) {
         dataSource: dialogDataSource,
         hidePagination: localData
       }, localData ? {
-        getRowId: function getRowId(_ref2) {
-          var data = _ref2.data;
+        getRowId: function getRowId(_ref5) {
+          var data = _ref5.data;
           return String(data[key]);
         }
       } : {}), {}, {
@@ -210,8 +380,8 @@ var DialogSelectInner = function DialogSelectInner(props) {
         },
         pageSize: dialogPageSize,
         pageSizeOptions: dialogPageSizeOptions,
-        onFirstDataRendered: function onFirstDataRendered(_ref3) {
-          var api = _ref3.api;
+        onFirstDataRendered: function onFirstDataRendered(_ref6) {
+          var api = _ref6.api;
           // 重开弹窗要把已经选中的行勾回来，否则用户会以为之前的选择丢了。
           // 放在首屏数据渲染完成时做：弹窗是 destroyOnClose，打开的那一刻表格还没有数据。@author nokecy
           var current = Array.isArray(state) ? state : state == null ? [] : [state];
@@ -233,13 +403,13 @@ var DialogSelectInner = function DialogSelectInner(props) {
             return !!node.data && dialogIsRowSelectable(node.data);
           }
         } : selectionMode === 'multiple' ? 'multiple' : 'single',
-        onRowDoubleClicked: function onRowDoubleClicked(_ref4) {
-          var data = _ref4.data;
+        onRowDoubleClicked: function onRowDoubleClicked(_ref7) {
+          var data = _ref7.data;
           if (dialogIsRowSelectable && !dialogIsRowSelectable(data)) return;
           confirmRows([data]);
         },
         request: localData ? undefined : ( /*#__PURE__*/function () {
-          var _ref5 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(params, _, record) {
+          var _ref8 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(params, _, record) {
             var adapter, data;
             return _regeneratorRuntime().wrap(function _callee$(_context) {
               while (1) switch (_context.prev = _context.next) {
@@ -273,7 +443,7 @@ var DialogSelectInner = function DialogSelectInner(props) {
             }, _callee);
           }));
           return function (_x, _x2, _x3) {
-            return _ref5.apply(this, arguments);
+            return _ref8.apply(this, arguments);
           };
         }()),
         columnDefs: columnDefs
@@ -327,6 +497,10 @@ var DialogSelect = observer(function (props) {
       dialogIsRowSelectable = safeProps.dialogIsRowSelectable,
       dialogRenderer = safeProps.dialogRenderer,
       gridComponent = safeProps.gridComponent,
+      codeField = safeProps.codeField,
+      searchDebounce = safeProps.searchDebounce,
+      maxOptions = safeProps.maxOptions,
+      recentKey = safeProps.recentKey,
       selectProps = _objectWithoutProperties(safeProps, _excluded2);
     if (displayField === 'value') return /*#__PURE__*/_jsx("span", {
       children: formatSelectDisplay('value' in safeProps ? safeProps.value : safeProps.defaultValue, 'value') || '—'

package/dist/esm/dialogSelect/index.less

@@ -47,3 +47,21 @@
 		padding-inline-end: 38px;
 	}
 }
+
+// 候选面板挂在 body 下，不在 .qc-dialog-select 里，所以写在顶层：「编码 | 名称」两列，编码等宽数字（§6.12）。
+.qc-dialog-select-option {
+	display: grid;
+	grid-template-columns: minmax(72px, max-content) 1fr;
+	column-gap: 12px;
+	align-items: center;
+
+	.qc-dialog-select-option-code {
+		font-variant-numeric: tabular-nums;
+	}
+
+	.qc-dialog-select-option-name {
+		overflow: hidden;
+		text-overflow: ellipsis;
+		white-space: nowrap;
+	}
+}

package/dist/esm/documentPage/documentPage.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { LeaveGuardOptions } from './leaveGuard';
 import type { Form } from '@nokecy/formily-core';
 /**
  * 宿主自己的未保存登记（例如接入页签关闭、离开页面的统一拦截）。
@@ -19,13 +20,13 @@ export declare const formatValidationFeedback: (address?: string, title?: unknow
  * - 传入宿主的 `tracker` 时由它记录未保存状态（例如统一拦截关页签）；不传时只在本页记录。
  * @author nokecy
  */
-export declare const useDocumentEditState: (tracker?: DocumentDirtyTracker) => {
+export declare const useDocumentEditState: (tracker?: DocumentDirtyTracker, leaveOptions?: LeaveGuardOptions) => {
     dirty: boolean;
     markDirty: (form?: Form) => void;
     markClean: () => void;
     changed: import("react").RefObject<boolean>;
     markChanged: () => void;
-    guardDiscard: (action: '返回' | '刷新' | '离开', proceed: () => void) => void;
+    guardDiscard: (_action: '返回' | '刷新' | '离开', proceed: () => void) => void;
 };
 /**
  * 单据动作忙态：同一时刻只执行一个动作，只有被点的按钮转圈，其余互斥动作禁用（§5.3）。
@@ -68,9 +69,11 @@ export declare const pickPrimaryAction: <K extends string>(candidates: [K, boole
  */
 export declare const validateBeforeConfirm: (validate?: () => Promise<unknown>, context?: {
     /** 携带实际表单以显示出错字段标题和明细行号。@author nokecy */
-    form?: Pick<Form<any>, "queryFeedbacks" | "query"> | undefined;
+    form?: Pick<Form<any>, "query" | "queryFeedbacks"> | undefined;
     /** 校验失败后展开编辑入口或定位字段，不执行保存和提交。@author nokecy */
     onInvalid?: ((address?: string) => void) | undefined;
+    /** 校验失败后切到错误页签、展开折叠并聚焦首个错误字段（§6.4），默认 false，提示仍用本函数的文案。 */
+    locate?: boolean | undefined;
     /** 自定义提示文字；默认「第 N 行 · 字段原因」或「「字段」原因」。 */
     formatFeedback?: ((address: string | undefined, title: unknown, reason: string) => string) | undefined;
 } | undefined) => Promise<boolean>;

package/dist/esm/documentPage/documentPage.js

@@ -2,6 +2,11 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+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); }
@@ -10,6 +15,8 @@ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" !=
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import { Modal, message } from 'antd';
 import { useCallback, useRef, useState } from 'react';
+import { confirmDiscardChanges, useLeaveGuard } from "./leaveGuard";
+import { focusFirstError } from '@nokecy/formily-antd';
 
 /**
  * 宿主自己的未保存登记（例如接入页签关闭、离开页面的统一拦截）。
@@ -35,7 +42,7 @@ export var formatValidationFeedback = function formatValidationFeedback(address,
  * - 传入宿主的 `tracker` 时由它记录未保存状态（例如统一拦截关页签）；不传时只在本页记录。
  * @author nokecy
  */
-export var useDocumentEditState = function useDocumentEditState(tracker) {
+export var useDocumentEditState = function useDocumentEditState(tracker, leaveOptions) {
   var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
     localDirty = _useState2[0],
@@ -53,13 +60,18 @@ export var useDocumentEditState = function useDocumentEditState(tracker) {
   var markChanged = useCallback(function () {
     changed.current = true;
   }, []);
-  /** 返回、刷新等会丢弃录入的动作：有未保存修改先确认。 */
-  var guardDiscard = function guardDiscard(action, proceed) {
+  // 传了宿主登记时，离开拦截由宿主统一负责，本页不再重复注册 beforeunload，除非显式开启。
+  useLeaveGuard(dirty, _objectSpread({
+    beforeUnload: !tracker
+  }, leaveOptions));
+  /**
+   * 返回、刷新等会丢弃录入的动作：有未保存修改先确认（文案「有未保存的修改，离开后将丢失」，
+   * 按钮「继续编辑 / 放弃修改」，§6.8）。`action` 仅为保持调用签名，不再进入文案。
+   */
+  var guardDiscard = function guardDiscard(_action, proceed) {
     if (!dirty) return proceed();
-    Modal.confirm({
-      title: "\u786E\u8BA4".concat(action),
-      content: '未保存的修改将丢失。',
-      onOk: proceed
+    void confirmDiscardChanges().then(function (ok) {
+      return ok && proceed();
     });
   };
   return {
@@ -242,8 +254,11 @@ export var validateBeforeConfirm = /*#__PURE__*/function () {
           validation = _context3.t0; // 阅读态字段可能不进入 Formily 的错误数组，仍保留业务校验给出的具体原因。@author nokecy
           message.error(typeof _reason === 'string' && _reason.trim() ? ((_context$formatFeedba = context === null || context === void 0 ? void 0 : context.formatFeedback) !== null && _context$formatFeedba !== void 0 ? _context$formatFeedba : formatValidationFeedback)(_address, field === null || field === void 0 ? void 0 : field.title, _reason) : (validation === null || validation === void 0 ? void 0 : validation.name) === 'ValidateError' && (_validation$message = validation.message) !== null && _validation$message !== void 0 && _validation$message.trim() ? validation.message : '表单校验未通过，请检查填写内容');
           context === null || context === void 0 || (_context$onInvalid = context.onInvalid) === null || _context$onInvalid === void 0 || _context$onInvalid.call(context, _address);
+          if (context !== null && context !== void 0 && context.locate && context.form) void focusFirstError(context.form, {
+            notify: false
+          });
           return _context3.abrupt("return", false);
-        case 18:
+        case 19:
         case "end":
           return _context3.stop();
       }

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