@nokecy/qc-ui 1.1.74 → 1.1.76

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

@@ -43,6 +43,6 @@ interface IDialogSelectProps extends SelectProps<any> {
     /** 选择窗口里使用的表格组件，默认 `AgGridPlus`；宿主可注入自己封装过的表格基座。 */
     gridComponent?: React.ComponentType<any>;
 }
-declare const DialogSelect: (props: IDialogSelectProps) => React.JSX.Element;
 export { IDialogSelectProps };
-export default DialogSelect;
+declare const _default: (props: IDialogSelectProps) => React.ReactElement;
+export default _default;

package/dist/cjs/dialogSelect/index.js

@@ -5,15 +5,19 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _antd = require("antd");
+var _react = require("@formily/react");
 var _antdV = require("@formily/antd-v5");
 var _icons = require("@ant-design/icons");
-var _react = _interopRequireWildcard(require("react"));
+var _react2 = _interopRequireWildcard(require("react"));
 var _agGridPlus = require("../ag-grid-plus");
 var _ahooks = require("ahooks");
 var _draggableModal = _interopRequireDefault(require("../draggableModal"));
 var _adapters = require("../adapters");
+var _controls = require("../readPretty/controls");
+var _selectValue = require("../readPretty/selectValue");
 require("./index.less");
-var _excluded = ["request", "columnDefs", "value", "labelField", "valueField", "onChangeItem", "hideBtn", "useAutoComplete", "queryFun", "pagedApiAdapter", "modalWidth", "dialogZIndex", "dialogMode", "dialogPageSize", "dialogPageSizeOptions", "dialogGridKey", "dialogDataSource", "dialogIsRowSelectable", "dialogRenderer", "gridComponent"];
+var _excluded = ["request", "columnDefs", "value", "labelField", "valueField", "onChangeItem", "hideBtn", "useAutoComplete", "queryFun", "pagedApiAdapter", "modalWidth", "dialogZIndex", "dialogMode", "dialogPageSize", "dialogPageSizeOptions", "dialogGridKey", "dialogDataSource", "dialogIsRowSelectable", "dialogRenderer", "gridComponent"],
+  _excluded2 = ["request", "columnDefs", "labelField", "valueField", "onChangeItem", "hideBtn", "useAutoComplete", "queryFun", "pagedApiAdapter", "modalWidth", "dialogZIndex", "dialogMode", "dialogPageSize", "dialogPageSizeOptions", "dialogGridKey", "dialogDataSource", "dialogIsRowSelectable", "dialogRenderer", "gridComponent"];
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
@@ -37,7 +41,7 @@ function _objectWithoutProperties(source, excluded) { if (source == null) return
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 /** 选择窗口的行选择模式。 */
 
-var DialogSelect = function DialogSelect(props) {
+var DialogSelectInner = function DialogSelectInner(props) {
   var _selectRows$length;
   // 这些是本组件自己的属性，不能透传给 Select（否则会落到 DOM 上触发未知属性告警）。
   var request = props.request,
@@ -74,7 +78,7 @@ var DialogSelect = function DialogSelect(props) {
     _useBoolean2$ = _useBoolean2[1],
     setTrue = _useBoolean2$.setTrue,
     setFalse = _useBoolean2$.setFalse;
-  var _useState = (0, _react.useState)(undefined),
+  var _useState = (0, _react2.useState)(undefined),
     _useState2 = _slicedToArray(_useState, 2),
     selectRows = _useState2[0],
     setSelectRows = _useState2[1];
@@ -123,7 +127,7 @@ var DialogSelect = function DialogSelect(props) {
 
   // 入口做成输入框内的后缀图标：不占右侧宽度，禁用/只读时不出现。@author nokecy
   var canOpen = !props.disabled && !hideBtn;
-  var trigger = canOpen ? /*#__PURE__*/_react.default.createElement("span", {
+  var trigger = canOpen ? /*#__PURE__*/_react2.default.createElement("span", {
     className: "qc-dialog-select-trigger",
     role: "button",
     "aria-label": "\u6253\u5F00\u9009\u62E9\u7A97\u53E3",
@@ -139,7 +143,7 @@ var DialogSelect = function DialogSelect(props) {
       setSelectRows(undefined);
       setTrue();
     }
-  }, /*#__PURE__*/_react.default.createElement(_icons.SearchOutlined, null)) : undefined;
+  }, /*#__PURE__*/_react2.default.createElement(_icons.SearchOutlined, null)) : undefined;
   var mergedClassName = ['qc-dialog-select', rest.className].filter(Boolean).join(' ');
   var triggerStyle = {
     '--qc-dialog-select-trigger-color': token.colorTextTertiary,
@@ -152,7 +156,7 @@ var DialogSelect = function DialogSelect(props) {
   }, trigger ? {
     suffixIcon: trigger
   } : {});
-  return /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, useAutoComplete && !props.labelInValue ? /*#__PURE__*/_react.default.createElement(_antd.AutoComplete, commonProps) : /*#__PURE__*/_react.default.createElement(_antdV.Select, _extends({
+  return /*#__PURE__*/_react2.default.createElement(_react2.default.Fragment, null, useAutoComplete && !props.labelInValue ? /*#__PURE__*/_react2.default.createElement(_antd.AutoComplete, commonProps) : /*#__PURE__*/_react2.default.createElement(_antdV.Select, _extends({
     maxTagCount: 'responsive',
     filterOption: false
   }, commonProps)), dialogRenderer ? dialogRenderer({
@@ -160,7 +164,7 @@ var DialogSelect = function DialogSelect(props) {
     mode: selectionMode,
     onCancel: close,
     onConfirm: confirmRows
-  }) : /*#__PURE__*/_react.default.createElement(_draggableModal.default, {
+  }) : /*#__PURE__*/_react2.default.createElement(_draggableModal.default, {
     width: modalWidth,
     title: "\u9009\u62E9",
     zIndex: dialogZIndex,
@@ -173,12 +177,14 @@ var DialogSelect = function DialogSelect(props) {
     okButtonProps: {
       disabled: !(selectRows !== null && selectRows !== void 0 && selectRows.length)
     }
-  }, selectionMode === 'multiple' && /*#__PURE__*/_react.default.createElement("div", {
+  }, selectionMode === 'multiple' && /*#__PURE__*/_react2.default.createElement("div", {
     style: {
       marginBottom: 8,
       textAlign: 'right'
     }
-  }, "\u5DF2\u9009 ", (_selectRows$length = selectRows === null || selectRows === void 0 ? void 0 : selectRows.length) !== null && _selectRows$length !== void 0 ? _selectRows$length : 0, " \u9879"), /*#__PURE__*/_react.default.createElement(Grid, _extends({
+  }, "\u5DF2\u9009 ", (_selectRows$length = selectRows === null || selectRows === void 0 ? void 0 : selectRows.length) !== null && _selectRows$length !== void 0 ? _selectRows$length : 0, " \u9879"), /*#__PURE__*/_react2.default.createElement(Grid, _extends({}, gridComponent ? {} : {
+    valueEnumContrast: true
+  }, {
     gridKey: dialogGridKey,
     dataSource: dialogDataSource,
     hidePagination: localData
@@ -256,4 +262,53 @@ var DialogSelect = function DialogSelect(props) {
     columnDefs: columnDefs
   }))));
 };
+
+/**
+ * 选择字段。
+ *
+ * 不可编辑（自身 disabled、外层 ConfigProvider 禁用，或 Formily 字段 disabled / readOnly / readPretty）时
+ * 只显示名称，不保留输入框和弹窗入口；`value` / `defaultValue` 统一规范成 Select 能识别的形状
+ * （含 `{ value, label }` 嵌套对象），仅在调用方传了对应属性时才下发，以保持受控/非受控语义。
+ *
+ * @author nokecy
+ */
+var DialogSelect = (0, _react.observer)(function (props) {
+  var _props$disabled;
+  var field = (0, _react.useField)();
+  var _ConfigProvider$useCo = _antd.ConfigProvider.useConfig(),
+    componentDisabled = _ConfigProvider$useCo.componentDisabled;
+  var reading = (_props$disabled = props.disabled) !== null && _props$disabled !== void 0 ? _props$disabled : componentDisabled;
+  var safeProps = _objectSpread(_objectSpread(_objectSpread({}, props), 'value' in props ? {
+    value: (0, _selectValue.normalizeSelectValue)(props.value, props.labelInValue)
+  } : {}), 'defaultValue' in props ? {
+    defaultValue: (0, _selectValue.normalizeSelectValue)(props.defaultValue, props.labelInValue)
+  } : {});
+  if (reading || field !== null && field !== void 0 && field.disabled || field !== null && field !== void 0 && field.readOnly || field !== null && field !== void 0 && field.readPretty) {
+    // 阅读态只需要选项与值；弹窗、取数等属性不下发。
+    var request = safeProps.request,
+      columnDefs = safeProps.columnDefs,
+      labelField = safeProps.labelField,
+      valueField = safeProps.valueField,
+      onChangeItem = safeProps.onChangeItem,
+      hideBtn = safeProps.hideBtn,
+      useAutoComplete = safeProps.useAutoComplete,
+      queryFun = safeProps.queryFun,
+      pagedApiAdapter = safeProps.pagedApiAdapter,
+      modalWidth = safeProps.modalWidth,
+      dialogZIndex = safeProps.dialogZIndex,
+      dialogMode = safeProps.dialogMode,
+      dialogPageSize = safeProps.dialogPageSize,
+      dialogPageSizeOptions = safeProps.dialogPageSizeOptions,
+      dialogGridKey = safeProps.dialogGridKey,
+      dialogDataSource = safeProps.dialogDataSource,
+      dialogIsRowSelectable = safeProps.dialogIsRowSelectable,
+      dialogRenderer = safeProps.dialogRenderer,
+      gridComponent = safeProps.gridComponent,
+      selectProps = _objectWithoutProperties(safeProps, _excluded2);
+    return /*#__PURE__*/_react2.default.createElement(_controls.Select, _extends({}, selectProps, {
+      disabled: true
+    }));
+  }
+  return /*#__PURE__*/_react2.default.createElement(DialogSelectInner, safeProps);
+});
 var _default = exports.default = DialogSelect;

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

@@ -0,0 +1,57 @@
+import type { SelectProps } from 'antd/lib/select';
+import React from 'react';
+/**
+ * 实体选择器的骨架。
+ *
+ * 各业务模块的实体选择器（线体、车间、物料、供应商……）此前是逐个复制出来的：
+ * 取数、防抖、受控值、下拉即查、labelInValue、弹窗表格列，每份各写一遍，
+ * 真正不同的只有请求函数、提示语和表格列。骨架收在这里，各模块只填自己的那几项。
+ *
+ * 骨架不认识任何业务契约：请求函数由调用方传入，不引用任何生成服务客户端。
+ *
+ * @author nokecy
+ */
+/** 取数入参：与后端分页查询约定一致。 */
+export interface EntitySelectQuery {
+    Filter?: string;
+    SkipCount?: number;
+    MaxResultCount?: number;
+    Sorting?: string;
+}
+export interface EntitySelectConfig {
+    /** 取数函数，通常是生成服务客户端里的 XxxGetListAsync。 */
+    request: (query: EntitySelectQuery) => Promise<any>;
+    /** 未选择时的提示语。 */
+    placeholder: string;
+    /** 弹窗内表格的列定义。 */
+    columnDefs: any[];
+    /** 下拉项与回填值取哪个字段。传字符串则固定；不传则由 useCode 在 code 与 id 之间切换。 */
+    valueField?: string;
+    /** 回填标签取哪个字段。不传则不向 DialogSelect 声明，沿用其自身默认。 */
+    labelField?: string;
+    /** 弹窗宽度，不传则用 DialogSelect 的默认值。 */
+    modalWidth?: number;
+    /** 单页取数条数，默认 300。 */
+    pageSize?: number;
+    /** useCode 的默认值，默认 true（以编码而非主键作为值）。 */
+    useCodeByDefault?: boolean;
+    /** 搜索关键字如何拼成后端过滤表达式，默认按 name 或 code 模糊匹配。返回 undefined 表示不带过滤条件。 */
+    buildFilter?: (keyword: string) => string | undefined;
+    /** 下拉项显示文本，默认「编码 - 名称」。 */
+    renderOptionLabel?: (item: any) => React.ReactNode;
+    /** 下拉项需要额外属性时的逃生舱：整项自渲染，优先于 renderOptionLabel。 */
+    renderOption?: (item: any, valueField: string) => React.ReactNode;
+    /** 联动回调的 prop 名，如 onWorkLineSelect。声明后组件支持 enableLinkage。 */
+    linkagePropName?: string;
+    /** 选择窗口里使用的表格组件，不传则用 AgGridPlus；宿主可注入自己封装过的表格基座。 */
+    gridComponent?: React.ComponentType<any>;
+}
+export interface EntitySelectProps extends SelectProps<any> {
+    /** 以编码而非主键作为选中值。 */
+    useCode?: boolean;
+    /** 选中后把整条记录回调给使用方，需配置 linkagePropName。 */
+    enableLinkage?: boolean;
+}
+declare const createEntitySelect: (config: EntitySelectConfig) => React.ForwardRefExoticComponent<Omit<any, "ref"> & React.RefAttributes<any>>;
+export { createEntitySelect };
+export default createEntitySelect;

package/dist/cjs/entitySelect/index.js

@@ -0,0 +1,172 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.createEntitySelect = void 0;
+var _dialogSelect = _interopRequireDefault(require("../dialogSelect"));
+var _ahooks = require("ahooks");
+var _antd = require("antd");
+var _react = _interopRequireWildcard(require("react"));
+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 }; }
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+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 _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; }
+var Option = _antd.Select.Option;
+
+/**
+ * 实体选择器的骨架。
+ *
+ * 各业务模块的实体选择器（线体、车间、物料、供应商……）此前是逐个复制出来的：
+ * 取数、防抖、受控值、下拉即查、labelInValue、弹窗表格列，每份各写一遍，
+ * 真正不同的只有请求函数、提示语和表格列。骨架收在这里，各模块只填自己的那几项。
+ *
+ * 骨架不认识任何业务契约：请求函数由调用方传入，不引用任何生成服务客户端。
+ *
+ * @author nokecy
+ */
+
+/** 取数入参：与后端分页查询约定一致。 */
+
+var createEntitySelect = exports.createEntitySelect = function createEntitySelect(config) {
+  var request = config.request,
+    placeholder = config.placeholder,
+    columnDefs = config.columnDefs,
+    valueField = config.valueField,
+    labelField = config.labelField,
+    modalWidth = config.modalWidth,
+    _config$pageSize = config.pageSize,
+    pageSize = _config$pageSize === void 0 ? 300 : _config$pageSize,
+    _config$useCodeByDefa = config.useCodeByDefault,
+    useCodeByDefault = _config$useCodeByDefa === void 0 ? true : _config$useCodeByDefa,
+    _config$buildFilter = config.buildFilter,
+    buildFilter = _config$buildFilter === void 0 ? function (keyword) {
+      return "(name =* ".concat(keyword, ") | (code =* ").concat(keyword, ")");
+    } : _config$buildFilter,
+    _config$renderOptionL = config.renderOptionLabel,
+    renderOptionLabel = _config$renderOptionL === void 0 ? function (item) {
+      return "".concat(item.code, " - ").concat(item.name);
+    } : _config$renderOptionL,
+    renderOption = config.renderOption,
+    linkagePropName = config.linkagePropName,
+    gridComponent = config.gridComponent;
+  var getData = function getData(_ref) {
+    var Filter = _ref.Filter,
+      SkipCount = _ref.SkipCount,
+      MaxResultCount = _ref.MaxResultCount,
+      Sorting = _ref.Sorting;
+    return request({
+      Filter: Filter ? Filter : undefined,
+      SkipCount: SkipCount ? SkipCount : 0,
+      MaxResultCount: MaxResultCount ? MaxResultCount : pageSize,
+      Sorting: Sorting ? Sorting : undefined
+    });
+  };
+
+  // props 上不加索引签名、ref 不收窄：这些选择器会被当作 AgGridColumn 的 searchComponent 传递，
+  // 任一处收紧都会让 forwardRef 的推断结果与那处的 prop 类型不兼容。
+  var EntitySelect = function EntitySelect(props, ref) {
+    var _data$items2;
+    var _props$useCode = props.useCode,
+      useCode = _props$useCode === void 0 ? useCodeByDefault : _props$useCode,
+      _props$enableLinkage = props.enableLinkage,
+      enableLinkage = _props$enableLinkage === void 0 ? false : _props$enableLinkage;
+    var resolvedValueField = valueField !== null && valueField !== void 0 ? valueField : useCode ? 'code' : 'id';
+    var onLinkage = linkagePropName ? props[linkagePropName] : undefined;
+    var lastLinkedValueRef = (0, _react.useRef)();
+    var _useControllableValue = (0, _ahooks.useControllableValue)(props),
+      _useControllableValue2 = _slicedToArray(_useControllableValue, 2),
+      state = _useControllableValue2[0],
+      setState = _useControllableValue2[1];
+    var _useRequest = (0, _ahooks.useRequest)(getData, {
+        debounceMaxWait: 500,
+        manual: true
+      }),
+      data = _useRequest.data,
+      loading = _useRequest.loading,
+      run = _useRequest.run,
+      cancel = _useRequest.cancel;
+    var handleChange = function handleChange(value) {
+      var _data$items;
+      setState(value);
+      if (!value) {
+        lastLinkedValueRef.current = undefined;
+        return;
+      }
+      if (!enableLinkage || !onLinkage) return;
+      var picked = _typeof(value) === 'object' ? value.value : value;
+      var matched = data === null || data === void 0 || (_data$items = data.items) === null || _data$items === void 0 ? void 0 : _data$items.find(function (item) {
+        return item[resolvedValueField] === picked;
+      });
+      if (matched && lastLinkedValueRef.current !== picked) {
+        lastLinkedValueRef.current = picked;
+        onLinkage(matched);
+      }
+    };
+    return /*#__PURE__*/_react.default.createElement("span", {
+      ref: ref,
+      style: {
+        display: 'block',
+        width: '100%',
+        minWidth: 0,
+        maxWidth: '100%'
+      }
+    }, /*#__PURE__*/_react.default.createElement(_dialogSelect.default, _extends({
+      placeholder: placeholder,
+      style: {
+        width: '100%',
+        maxWidth: '100%'
+      },
+      showSearch: true,
+      labelInValue: true,
+      filterOption: false
+    }, modalWidth ? {
+      modalWidth: modalWidth
+    } : {}, gridComponent ? {
+      gridComponent: gridComponent
+    } : {}, props, {
+      onSearch: function onSearch(value) {
+        run({
+          Filter: buildFilter(value)
+        });
+      },
+      onDropdownVisibleChange: function onDropdownVisibleChange(visible) {
+        visible && run({});
+      },
+      loading: loading,
+      onBlur: cancel,
+      value: JSON.stringify(state) === '{}' ? undefined : state,
+      onChange: handleChange,
+      valueField: resolvedValueField
+    }, labelField ? {
+      labelField: labelField
+    } : {}, {
+      request: getData,
+      columnDefs: columnDefs,
+      onChangeItem: function onChangeItem(item) {
+        if (!enableLinkage || !onLinkage || !item) return;
+        var selected = Array.isArray(item) ? item[0] : item;
+        if (!selected) return;
+        var picked = selected[resolvedValueField];
+        if (lastLinkedValueRef.current === picked) return;
+        lastLinkedValueRef.current = picked;
+        onLinkage(selected);
+      }
+    }), data === null || data === void 0 || (_data$items2 = data.items) === null || _data$items2 === void 0 ? void 0 : _data$items2.map(function (item) {
+      var _item$id;
+      return renderOption ? renderOption(item, resolvedValueField) : /*#__PURE__*/_react.default.createElement(Option, {
+        key: (_item$id = item.id) !== null && _item$id !== void 0 ? _item$id : item[resolvedValueField],
+        value: item[resolvedValueField]
+      }, renderOptionLabel(item));
+    })));
+  };
+  return /*#__PURE__*/_react.default.forwardRef(EntitySelect);
+};
+var _default = exports.default = createEntitySelect;

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