@nokecy/qc-ui 1.1.75 → 1.1.76

package/dist/cjs/importModal/index.js

@@ -40,7 +40,10 @@ var ImportModal = function ImportModal(props) {
     _props$downloadBlob = props.downloadBlob,
     downloadBlob = _props$downloadBlob === void 0 ? defaultDownloadBlob : _props$downloadBlob,
     serverUrl = props.serverUrl,
-    buttonProps = props.buttonProps;
+    buttonProps = props.buttonProps,
+    request = props.request,
+    method = props.method,
+    onRealSuccess = props.onRealSuccess;
   var _useBoolean = (0, _ahooks.useBoolean)(false),
     _useBoolean2 = _slicedToArray(_useBoolean, 2),
     visible = _useBoolean2[0],
@@ -70,12 +73,46 @@ var ImportModal = function ImportModal(props) {
       }
     }, "\u6A21\u7248")),
     type: "info"
-  }), /*#__PURE__*/_react.default.createElement(_antd.Upload.Dragger, {
+  }), /*#__PURE__*/_react.default.createElement(_antd.Upload.Dragger, _extends({
     style: {
       marginTop: 10
     },
     multiple: false,
-    action: getUploadUrl(),
+    action: getUploadUrl()
+  }, request ? {
+    customRequest: function customRequest(_ref) {
+      var action = _ref.action,
+        file = _ref.file,
+        headers = _ref.headers,
+        onError = _ref.onError,
+        onProgress = _ref.onProgress,
+        onSuccess = _ref.onSuccess;
+      var formData = new FormData();
+      formData.append('file', file);
+      request(action, {
+        method: method || 'POST',
+        data: formData,
+        headers: headers,
+        // 导入失败要展示行级原因，交给下面的弹窗统一报，不再走全局吐司。
+        skipErrorHandler: true,
+        onUploadProgress: function onUploadProgress(_ref2) {
+          var total = _ref2.total,
+            loaded = _ref2.loaded;
+          onProgress === null || onProgress === void 0 || onProgress({
+            percent: Number((loaded / total * 100).toFixed(2))
+          }, file);
+        }
+      }).then(function (response) {
+        onSuccess === null || onSuccess === void 0 || onSuccess(response, file);
+        onRealSuccess === null || onRealSuccess === void 0 || onRealSuccess(response);
+      })
+      // 第二个参数成为 info.file.response，onChange 靠它拿到后端的失败原因，而不是 axios 的英文文案。
+      .catch(function (err) {
+        var _err$response;
+        return onError === null || onError === void 0 ? void 0 : onError(err, err === null || err === void 0 || (_err$response = err.response) === null || _err$response === void 0 ? void 0 : _err$response.data);
+      });
+    }
+  } : {}, {
     onChange: function onChange(info) {
       if (info.file.status === 'done') {
         _antd.message.success('导入成功');
@@ -84,15 +121,16 @@ var ImportModal = function ImportModal(props) {
       }
       if (info.file.status === 'error') {
         var _info$file;
-        _antd.Modal.info({
-          title: '导入失败,原因如下:',
+        // 没有后端给的原因时也要有提示，不能让失败无声无息。
+        _antd.Modal.error({
+          title: '导入失败',
           closable: true,
-          width: 1000,
-          content: info === null || info === void 0 || (_info$file = info.file) === null || _info$file === void 0 || (_info$file = _info$file.response) === null || _info$file === void 0 || (_info$file = _info$file.error) === null || _info$file === void 0 ? void 0 : _info$file.message
+          width: 800,
+          content: (info === null || info === void 0 || (_info$file = info.file) === null || _info$file === void 0 || (_info$file = _info$file.response) === null || _info$file === void 0 || (_info$file = _info$file.error) === null || _info$file === void 0 ? void 0 : _info$file.message) || '文件未能导入。请核对模板格式与必填列后重试；若持续失败请联系技术支持。'
         });
       }
     }
-  }, /*#__PURE__*/_react.default.createElement("p", {
+  }), /*#__PURE__*/_react.default.createElement("p", {
     className: "ant-upload-drag-icon"
   }, /*#__PURE__*/_react.default.createElement(_icons.InboxOutlined, null)), /*#__PURE__*/_react.default.createElement("p", {
     className: "ant-upload-text"

package/dist/cjs/index.d.ts

@@ -33,6 +33,9 @@ export type { CentralizedColumnScheme, QueryScheme, SchemeStorageAdapter, Scheme
 export * from './adapters';
 export * from "./readPretty";
 export { createEntitySelect } from "./entitySelect";
+export { default as ExportButton, buildExportUrl, DEFAULT_EXPORT_TEMPLATE_API, resolveExportAction, resolveExportError, resolveFileName } from "./exportButton";
+export type { ExportButtonProps, ExportTemplateApi, ExportTemplateOption } from "./exportButton";
+export { saveAs } from "./utils/download";
 export type { EntitySelectConfig, EntitySelectProps, EntitySelectQuery } from "./entitySelect";
 export { semanticTextColors, toGridTextColor, gridValueEnum } from "./ag-grid-plus/utils/valueEnumColor";
 export type { SemanticPreset } from "./ag-grid-plus/utils/valueEnumColor";

package/dist/cjs/index.js

@@ -1,5 +1,6 @@
 "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
 });
@@ -48,6 +49,13 @@ var _exportNames = {
   MatchItem: true,
   RegexRailroadDiagram: true,
   createEntitySelect: true,
+  ExportButton: true,
+  buildExportUrl: true,
+  DEFAULT_EXPORT_TEMPLATE_API: true,
+  resolveExportAction: true,
+  resolveExportError: true,
+  resolveFileName: true,
+  saveAs: true,
   semanticTextColors: true,
   toGridTextColor: true,
   gridValueEnum: true,
@@ -120,6 +128,12 @@ Object.defineProperty(exports, "ConfirmPro", {
     return _ConfirmPro.default;
   }
 });
+Object.defineProperty(exports, "DEFAULT_EXPORT_TEMPLATE_API", {
+  enumerable: true,
+  get: function get() {
+    return _exportButton.DEFAULT_EXPORT_TEMPLATE_API;
+  }
+});
 Object.defineProperty(exports, "Dashboard", {
   enumerable: true,
   get: function get() {
@@ -150,6 +164,12 @@ Object.defineProperty(exports, "Editable", {
     return _editable.default;
   }
 });
+Object.defineProperty(exports, "ExportButton", {
+  enumerable: true,
+  get: function get() {
+    return _exportButton.default;
+  }
+});
 Object.defineProperty(exports, "ExtensibleGrid", {
   enumerable: true,
   get: function get() {
@@ -276,6 +296,12 @@ Object.defineProperty(exports, "ToolBar", {
     return _toolBar.default;
   }
 });
+Object.defineProperty(exports, "buildExportUrl", {
+  enumerable: true,
+  get: function get() {
+    return _exportButton.buildExportUrl;
+  }
+});
 Object.defineProperty(exports, "contrastRatio", {
   enumerable: true,
   get: function get() {
@@ -360,12 +386,36 @@ Object.defineProperty(exports, "relativeLuminance", {
     return _contrast.relativeLuminance;
   }
 });
+Object.defineProperty(exports, "resolveExportAction", {
+  enumerable: true,
+  get: function get() {
+    return _exportButton.resolveExportAction;
+  }
+});
+Object.defineProperty(exports, "resolveExportError", {
+  enumerable: true,
+  get: function get() {
+    return _exportButton.resolveExportError;
+  }
+});
+Object.defineProperty(exports, "resolveFileName", {
+  enumerable: true,
+  get: function get() {
+    return _exportButton.resolveFileName;
+  }
+});
 Object.defineProperty(exports, "roundDecimal", {
   enumerable: true,
   get: function get() {
     return _businessDecimal.roundDecimal;
   }
 });
+Object.defineProperty(exports, "saveAs", {
+  enumerable: true,
+  get: function get() {
+    return _download.saveAs;
+  }
+});
 Object.defineProperty(exports, "semanticTextColors", {
   enumerable: true,
   get: function get() {
@@ -480,7 +530,11 @@ Object.keys(_readPretty).forEach(function (key) {
   });
 });
 var _entitySelect = require("./entitySelect");
+var _exportButton = _interopRequireWildcard(require("./exportButton"));
+var _download = require("./utils/download");
 var _valueEnumColor = require("./ag-grid-plus/utils/valueEnumColor");
 var _contrast = require("./utils/contrast");
 var _businessDecimal = require("./utils/businessDecimal");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

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

@@ -0,0 +1,6 @@
+/**
+ * 把 Blob 存成本地文件。
+ *
+ * @author nokecy
+ */
+export declare const saveAs: (blob: Blob, filename: string) => void;

package/dist/cjs/utils/download.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.saveAs = void 0;
+/**
+ * 把 Blob 存成本地文件。
+ *
+ * @author nokecy
+ */
+var saveAs = exports.saveAs = function saveAs(blob, filename) {
+  var nav = window.navigator;
+  if (typeof nav.msSaveBlob === 'function') {
+    nav.msSaveBlob(blob, filename);
+    return;
+  }
+  var link = document.createElement('a');
+  link.href = window.URL.createObjectURL(blob);
+  link.download = filename;
+  link.click();
+  window.URL.revokeObjectURL(link.href);
+};

package/dist/esm/exportButton/exportAction.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 导出按钮的行为决策与地址构造。
+ *
+ * 抽成纯函数是为了能直接测：这里的分支决定了「现场点导出会发生什么」，
+ * 而它最容易出问题的两个场景——模板没配、模板接口挂了——在页面里很难复现。
+ *
+ * @author nokecy
+ */
+/** 导出模板服务的接口地址：可用模板列表与按模板渲染文件。默认指向 MES 后端的 export-template 服务，其他后端可在 ExportButton 上覆盖。 */
+export interface ExportTemplateApi {
+    /** 按页面标识取可用模板（GET，参数 gridKey） */
+    options: string;
+    /** 按模板渲染并下载（GET，参数 TemplateId、Filter） */
+    render: string;
+}
+/** 默认的导出模板服务地址。 */
+export declare const DEFAULT_EXPORT_TEMPLATE_API: ExportTemplateApi;
+/** 后端 `export-template/options` 返回的模板项 */
+export interface ExportTemplateOption {
+    id: string;
+    name: string;
+    isDefault: boolean;
+}
+/** 导出按钮该以什么形态出现 */
+export type ExportAction = 
+/** 没有可用模板：走页面自带的旧导出入口 */
+{
+    kind: 'legacy';
+}
+/** 只有一个模板：按钮直接导 */
+ | {
+    kind: 'single';
+    template: ExportTemplateOption;
+}
+/** 多个模板：下拉选择 */
+ | {
+    kind: 'menu';
+    templates: ExportTemplateOption[];
+    defaultTemplate: ExportTemplateOption;
+};
+/**
+ * 根据可用模板决定导出按钮的行为。
+ *
+ * 传 null / undefined 表示「没拿到模板列表」（接口失败或还没加载），
+ * 与「确实一个模板都没配」一样回落到旧导出——模板服务出问题不该让现场导不出数据。
+ */
+export declare const resolveExportAction: (templates: ExportTemplateOption[] | null | undefined) => ExportAction;
+/**
+ * 导出接口地址。这里已经把参数百分号编码好了（Gridify 的值里可能有 `&` `#` `+`，不编会截断 query string）。
+ *
+ * <b>因此下载不能走 `downloadBlob`</b>：它内部还会 `encodeURI(url)` 再编一次，
+ * `%` 被转义成 `%25`（`boxCode%3D*BOX001` → `boxCode%253D*BOX001`），
+ * 后端解析不出筛选串——现场表现是「在列表上筛完点导出，导出的是全量」。
+ * 见本目录 index.tsx 里的 `download`。
+ */
+export declare const buildExportUrl: (templateId: string, filter?: string | null, renderUrl?: string) => string;
+/**
+ * 从响应头取导出文件名。
+ *
+ * 文件名是运维在模板上配的（可带 {date} 之类的占位），只有服务端知道最终值；
+ * 客户端自己起名会让那项配置永远不生效。头里取不到就用兜底名。
+ *
+ * 后端用 `filename*=UTF-8''xxx`（RFC 5987）传中文名，老式 `filename="xxx"` 也认。
+ */
+export declare const resolveFileName: (contentDisposition: string | undefined | null, fallback: string) => string;
+/**
+ * 从导出失败的异常里取出给人看的错误信息。
+ *
+ * 导出请求是 `responseType: 'blob'`，后端返回的 JSON 错误体也会被 axios 当成 blob 收下，
+ * `e.response.data.error.message` 这条路永远取不到东西——现场看到的是 axios 自己的
+ * "Request failed with status code 500"，既不知道是数据太多超时还是模板配错。
+ * 所以先把 blob 读回来解析一次。
+ */
+export declare const resolveExportError: (error: any) => Promise<string>;

package/dist/esm/exportButton/exportAction.js

@@ -0,0 +1,193 @@
+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 _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); }); }; }
+/**
+ * 导出按钮的行为决策与地址构造。
+ *
+ * 抽成纯函数是为了能直接测：这里的分支决定了「现场点导出会发生什么」，
+ * 而它最容易出问题的两个场景——模板没配、模板接口挂了——在页面里很难复现。
+ *
+ * @author nokecy
+ */
+
+/** 导出模板服务的接口地址：可用模板列表与按模板渲染文件。默认指向 MES 后端的 export-template 服务，其他后端可在 ExportButton 上覆盖。 */
+
+/** 默认的导出模板服务地址。 */
+export var DEFAULT_EXPORT_TEMPLATE_API = {
+  options: '/api/mes/export-template/options',
+  render: '/api/mes/export-template/render'
+};
+
+/** 后端 `export-template/options` 返回的模板项 */
+
+/** 导出按钮该以什么形态出现 */
+
+/**
+ * 根据可用模板决定导出按钮的行为。
+ *
+ * 传 null / undefined 表示「没拿到模板列表」（接口失败或还没加载），
+ * 与「确实一个模板都没配」一样回落到旧导出——模板服务出问题不该让现场导不出数据。
+ */
+export var resolveExportAction = function resolveExportAction(templates) {
+  var _templates$find;
+  if (!templates || templates.length === 0) {
+    return {
+      kind: 'legacy'
+    };
+  }
+  if (templates.length === 1) {
+    return {
+      kind: 'single',
+      template: templates[0]
+    };
+  }
+
+  // 后端已按「默认优先、其次按名称」排序，所以取不到 isDefault 时用首个兜底，
+  // 不让默认项落空导致下拉没有选中态。
+  var defaultTemplate = (_templates$find = templates.find(function (item) {
+    return item.isDefault;
+  })) !== null && _templates$find !== void 0 ? _templates$find : templates[0];
+  return {
+    kind: 'menu',
+    templates: templates,
+    defaultTemplate: defaultTemplate
+  };
+};
+
+/**
+ * 导出接口地址。这里已经把参数百分号编码好了（Gridify 的值里可能有 `&` `#` `+`，不编会截断 query string）。
+ *
+ * <b>因此下载不能走 `downloadBlob`</b>：它内部还会 `encodeURI(url)` 再编一次，
+ * `%` 被转义成 `%25`（`boxCode%3D*BOX001` → `boxCode%253D*BOX001`），
+ * 后端解析不出筛选串——现场表现是「在列表上筛完点导出，导出的是全量」。
+ * 见本目录 index.tsx 里的 `download`。
+ */
+export var buildExportUrl = function buildExportUrl(templateId, filter) {
+  var renderUrl = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : DEFAULT_EXPORT_TEMPLATE_API.render;
+  var params = new URLSearchParams();
+  params.set('TemplateId', templateId);
+
+  // 空筛选串不拼参数：拼上 Filter= 会让后端把空串当成一个筛选串去解析
+  if (filter) {
+    params.set('Filter', filter);
+  }
+  return "".concat(renderUrl, "?").concat(params.toString());
+};
+
+/**
+ * 从响应头取导出文件名。
+ *
+ * 文件名是运维在模板上配的（可带 {date} 之类的占位），只有服务端知道最终值；
+ * 客户端自己起名会让那项配置永远不生效。头里取不到就用兜底名。
+ *
+ * 后端用 `filename*=UTF-8''xxx`（RFC 5987）传中文名，老式 `filename="xxx"` 也认。
+ */
+export var resolveFileName = function resolveFileName(contentDisposition, fallback) {
+  var withExtension = function withExtension(name) {
+    return /\.xlsx$/i.test(name) ? name : "".concat(name, ".xlsx");
+  };
+  if (!contentDisposition) return withExtension(fallback);
+  var star = /filename\*=(?:UTF-8'')?([^;]+)/i.exec(contentDisposition);
+  if (star !== null && star !== void 0 && star[1]) {
+    try {
+      return withExtension(decodeURIComponent(star[1].trim().replace(/^"|"$/g, '')));
+    } catch (_unused) {
+      // 头里的编码坏了不该让整个下载失败，退回兜底名
+    }
+  }
+  var plain = /filename="?([^";]+)"?/i.exec(contentDisposition);
+  if (plain !== null && plain !== void 0 && plain[1]) return withExtension(plain[1].trim());
+  return withExtension(fallback);
+};
+var readBlobText = function readBlobText(blob) {
+  if (typeof blob.text === 'function') return blob.text();
+  // 个别环境（旧浏览器、jsdom）的 Blob 没有 text()，用 FileReader 兜底
+  return new Promise(function (resolve, reject) {
+    var reader = new FileReader();
+    reader.onload = function () {
+      var _reader$result;
+      return resolve(String((_reader$result = reader.result) !== null && _reader$result !== void 0 ? _reader$result : ''));
+    };
+    reader.onerror = function () {
+      return reject(reader.error);
+    };
+    reader.readAsText(blob);
+  });
+};
+
+/**
+ * 从导出失败的异常里取出给人看的错误信息。
+ *
+ * 导出请求是 `responseType: 'blob'`，后端返回的 JSON 错误体也会被 axios 当成 blob 收下，
+ * `e.response.data.error.message` 这条路永远取不到东西——现场看到的是 axios 自己的
+ * "Request failed with status code 500"，既不知道是数据太多超时还是模板配错。
+ * 所以先把 blob 读回来解析一次。
+ */
+export var resolveExportError = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(error) {
+    var _error$response, _data$error;
+    var data, _JSON$parse, message;
+    return _regeneratorRuntime().wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          data = error === null || error === void 0 || (_error$response = error.response) === null || _error$response === void 0 ? void 0 : _error$response.data;
+          if (!(typeof Blob !== 'undefined' && data instanceof Blob)) {
+            _context.next = 26;
+            break;
+          }
+          _context.prev = 2;
+          _context.t2 = JSON;
+          _context.next = 6;
+          return readBlobText(data);
+        case 6:
+          _context.t3 = _context.sent;
+          _context.t4 = _JSON$parse = _context.t2.parse.call(_context.t2, _context.t3);
+          _context.t1 = _context.t4 === null;
+          if (_context.t1) {
+            _context.next = 11;
+            break;
+          }
+          _context.t1 = _JSON$parse === void 0;
+        case 11:
+          _context.t0 = _context.t1;
+          if (_context.t0) {
+            _context.next = 14;
+            break;
+          }
+          _context.t0 = (_JSON$parse = _JSON$parse.error) === null || _JSON$parse === void 0;
+        case 14:
+          if (!_context.t0) {
+            _context.next = 18;
+            break;
+          }
+          _context.t5 = void 0;
+          _context.next = 19;
+          break;
+        case 18:
+          _context.t5 = _JSON$parse.message;
+        case 19:
+          message = _context.t5;
+          if (!message) {
+            _context.next = 22;
+            break;
+          }
+          return _context.abrupt("return", message);
+        case 22:
+          _context.next = 26;
+          break;
+        case 24:
+          _context.prev = 24;
+          _context.t6 = _context["catch"](2);
+        case 26:
+          return _context.abrupt("return", (data === null || data === void 0 || (_data$error = data.error) === null || _data$error === void 0 ? void 0 : _data$error.message) || (error === null || error === void 0 ? void 0 : error.message) || '导出失败');
+        case 27:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee, null, [[2, 24]]);
+  }));
+  return function resolveExportError(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();

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

@@ -0,0 +1,39 @@
+import React from 'react';
+import { buildExportUrl, DEFAULT_EXPORT_TEMPLATE_API, resolveExportAction, resolveExportError, resolveFileName, type ExportTemplateApi, type ExportTemplateOption } from './exportAction';
+/**
+ * 列表页统一导出按钮。
+ *
+ * <p>导出格式由运维在「导出模板」里配，页面这边只提供 gridKey 和当前筛选条件。
+ * 一个页面配了几份模板（各客户各一份），这里就出下拉让人挑。</p>
+ *
+ * <p><b>没有模板时走 `legacy`</b>——即页面原来那个硬编码的导出接口。
+ * 老导出接口保留并存，模板配好之前现场照常能导；模板接口挂了也走这条路。
+ * 三种形态（老接口 / 单模板 / 多模板）长得一样，只有多模板时右边多一个下拉箭头，
+ * 所以运维配不配模板，操作员那边看到的都是同一个按钮。</p>
+ *
+ * @author nokecy
+ */
+export interface ExportButtonProps {
+    /**
+     * 发请求的函数，约定与 umi 的 `request` 一致：`request(url, { method, params, responseType, getResponse, skipErrorHandler })`，
+     * 传 `getResponse: true` 时返回 `{ data, headers }`。宿主在这里带上自己的鉴权、网关前缀与错误处理。
+     */
+    request: (url: string, options?: Record<string, any>) => Promise<any>;
+    /** 导出模板服务的接口地址，默认 MES 后端的 `/api/mes/export-template/{options,render}` */
+    templateApi?: ExportTemplateApi;
+    /** 页面标识，取自 `getGridKey(...)`，与导出模板上配的「适用页面」对应 */
+    gridKey: string;
+    /** 列表当前的 Gridify 筛选串，原样透传给后端 */
+    filter?: string;
+    /** 没有可用模板时导什么：页面原有导出接口的地址，以及响应头没给文件名时的兜底名 */
+    legacy?: {
+        url: string;
+        fileName: string;
+    };
+    /** 按钮文字，默认「导出」 */
+    children?: React.ReactNode;
+}
+declare const ExportButton: React.FC<ExportButtonProps>;
+export default ExportButton;
+export { buildExportUrl, DEFAULT_EXPORT_TEMPLATE_API, resolveExportAction, resolveExportError, resolveFileName };
+export type { ExportTemplateApi, ExportTemplateOption };