@nokecy/qc-ui 1.1.73 → 1.1.74

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

@@ -2,7 +2,11 @@ import { SelectProps } from 'antd/lib/select';
 import React from 'react';
 import { ColDef, ColGroupDef } from 'ag-grid-community';
 import type { PagedApiAdapter } from '../adapters';
+import './index.less';
+/** 选择窗口的行选择模式。 */
+type DialogSelectionMode = 'single' | 'multiple';
 interface IDialogSelectProps extends SelectProps<any> {
+    /** 隐藏选择窗口入口（输入框内的后缀图标），只保留输入与下拉。 */
     hideBtn?: boolean;
     request?: any;
     columnDefs?: (ColDef | ColGroupDef)[] | null;
@@ -13,6 +17,31 @@ interface IDialogSelectProps extends SelectProps<any> {
     useAutoComplete?: boolean;
     /** 分页 API 适配器(默认 ABP)。@author nokecy */
     pagedApiAdapter?: PagedApiAdapter;
+    /** 选择窗口宽度，默认 960。 */
+    modalWidth?: number | string;
+    /** 选择窗口层级，默认 9999（高于抽屉、其他弹窗）。 */
+    dialogZIndex?: number;
+    /** 选择窗口中的行选择模式；缺省按 `mode` 推断，外层 Select 仍可保持单值。 */
+    dialogMode?: DialogSelectionMode;
+    /** 选择窗口表格的初始分页大小；不影响外层 Select。 */
+    dialogPageSize?: number;
+    /** 选择窗口表格可选分页大小。 */
+    dialogPageSizeOptions?: number[];
+    /** 选择窗口表格的列方案标识。 */
+    dialogGridKey?: string;
+    /** 已由业务限定范围的本地候选；传入后不再请求接口，表格直接筛选完整候选集且不分页。 */
+    dialogDataSource?: any[];
+    /** 业务限制下不可带入的行；单击、确认和双击共用该条件。 */
+    dialogIsRowSelectable?: (row: any) => boolean;
+    /** 自定义选择窗口内容；确认时回传所选行。传入后不再渲染内置的表格窗口。 */
+    dialogRenderer?: (context: {
+        open: boolean;
+        mode: DialogSelectionMode;
+        onCancel: () => void;
+        onConfirm: (rows: any[]) => void;
+    }) => React.ReactNode;
+    /** 选择窗口里使用的表格组件，默认 `AgGridPlus`；宿主可注入自己封装过的表格基座。 */
+    gridComponent?: React.ComponentType<any>;
 }
 declare const DialogSelect: (props: IDialogSelectProps) => React.JSX.Element;
 export { IDialogSelectProps };

package/dist/esm/dialogSelect/index.js

@@ -1,4 +1,4 @@
-var _excluded = ["request", "columnDefs", "value", "labelField", "valueField", "onChangeItem"];
+var _excluded = ["request", "columnDefs", "value", "labelField", "valueField", "onChangeItem", "hideBtn", "useAutoComplete", "queryFun", "pagedApiAdapter", "modalWidth", "dialogZIndex", "dialogMode", "dialogPageSize", "dialogPageSizeOptions", "dialogGridKey", "dialogDataSource", "dialogIsRowSelectable", "dialogRenderer", "gridComponent"];
 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); }); }; }
@@ -17,185 +17,235 @@ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" !=
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
-import { Button, AutoComplete } from 'antd';
+import { AutoComplete, theme } from 'antd';
 import { Select } from '@formily/antd-v5';
-import { DashOutlined } from '@ant-design/icons';
+import { SearchOutlined } from '@ant-design/icons';
 import React, { useState } from 'react';
 import { AgGridPlus } from "../ag-grid-plus";
 import { useBoolean, useControllableValue } from 'ahooks';
 import DraggableModal from "../draggableModal";
 import { abpPagedApiAdapter } from "../adapters";
+import "./index.less";
+
+/** 选择窗口的行选择模式。 */
+
 var DialogSelect = function DialogSelect(props) {
+  var _selectRows$length;
+  // 这些是本组件自己的属性，不能透传给 Select（否则会落到 DOM 上触发未知属性告警）。
   var request = props.request,
     columnDefs = props.columnDefs,
     value = props.value,
     labelField = props.labelField,
     valueField = props.valueField,
     onChangeItem = props.onChangeItem,
+    hideBtn = props.hideBtn,
+    useAutoComplete = props.useAutoComplete,
+    queryFun = props.queryFun,
+    pagedApiAdapter = props.pagedApiAdapter,
+    _props$modalWidth = props.modalWidth,
+    modalWidth = _props$modalWidth === void 0 ? 960 : _props$modalWidth,
+    _props$dialogZIndex = props.dialogZIndex,
+    dialogZIndex = _props$dialogZIndex === void 0 ? 9999 : _props$dialogZIndex,
+    dialogMode = props.dialogMode,
+    dialogPageSize = props.dialogPageSize,
+    dialogPageSizeOptions = props.dialogPageSizeOptions,
+    dialogGridKey = props.dialogGridKey,
+    dialogDataSource = props.dialogDataSource,
+    dialogIsRowSelectable = props.dialogIsRowSelectable,
+    dialogRenderer = props.dialogRenderer,
+    gridComponent = props.gridComponent,
     rest = _objectWithoutProperties(props, _excluded);
+  var Grid = gridComponent !== null && gridComponent !== void 0 ? gridComponent : AgGridPlus;
   var _useControllableValue = useControllableValue(props),
     _useControllableValue2 = _slicedToArray(_useControllableValue, 2),
     state = _useControllableValue2[0],
     setState = _useControllableValue2[1];
-  var _useState = useState(),
-    _useState2 = _slicedToArray(_useState, 2),
-    gridApi = _useState2[0],
-    setGridApi = _useState2[1];
   var _useBoolean = useBoolean(false),
     _useBoolean2 = _slicedToArray(_useBoolean, 2),
     visible = _useBoolean2[0],
     _useBoolean2$ = _useBoolean2[1],
     setTrue = _useBoolean2$.setTrue,
     setFalse = _useBoolean2$.setFalse;
-  var _useState3 = useState(undefined),
-    _useState4 = _slicedToArray(_useState3, 2),
-    selectRows = _useState4[0],
-    setSelectRows = _useState4[1];
-  var _useState5 = useState([]),
-    _useState6 = _slicedToArray(_useState5, 2),
-    items = _useState6[0],
-    setItems = _useState6[1];
-  var getValue = function getValue(selectRows) {
-    var mode = props.mode,
-      labelInValue = props.labelInValue,
-      valueField = props.valueField,
-      labelField = props.labelField;
-    var selectRow = selectRows[0];
-    var value = selectRow[valueField !== null && valueField !== void 0 ? valueField : 'id'];
-    var label = selectRow[labelField !== null && labelField !== void 0 ? labelField : 'name'];
-    if (props.mode === 'multiple' || props.mode === 'tags') {
-      return labelInValue ? selectRows.map(function (it) {
+  var _useState = useState(undefined),
+    _useState2 = _slicedToArray(_useState, 2),
+    selectRows = _useState2[0],
+    setSelectRows = _useState2[1];
+  var _theme$useToken = theme.useToken(),
+    token = _theme$useToken.token;
+  var isMultipleValue = props.mode === 'multiple' || props.mode === 'tags';
+  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);
+  var getValue = function getValue(rows) {
+    var row = rows[0];
+    var labelKey = labelField !== null && labelField !== void 0 ? labelField : 'name';
+    if (isMultipleValue) {
+      return props.labelInValue ? rows.map(function (it) {
         return {
-          value: it[valueField !== null && valueField !== void 0 ? valueField : 'id'],
-          label: it[labelField !== null && labelField !== void 0 ? labelField : 'name'],
+          value: it[key],
+          label: it[labelKey],
           key: it === null || it === void 0 ? void 0 : it.id
         };
-      }) : selectRows.map(function (it) {
-        return it[valueField !== null && valueField !== void 0 ? valueField : 'id'];
+      }) : rows.map(function (it) {
+        return it[key];
       });
-    } else {
-      return labelInValue ? {
-        value: value,
-        label: label
-      } : value;
     }
+    return props.labelInValue ? {
+      value: row[key],
+      label: row[labelKey]
+    } : row[key];
   };
-  var handleOk = function handleOk() {
-    var selectRow = selectRows[0];
-    setState(getValue(selectRows));
+  var close = function close() {
     setFalse();
-    if (onChangeItem) onChangeItem(props.mode ? selectRows : selectRow);
+    setSelectRows(undefined);
+  };
+  var confirmRows = function confirmRows(rows) {
+    if (!(rows !== null && rows !== void 0 && rows.length)) return;
+    if (dialogIsRowSelectable && rows.some(function (row) {
+      return !dialogIsRowSelectable(row);
+    })) return;
+    setState(getValue(rows));
+    close();
+    // 回传完整数据行，供调用方回填关联字段。
+    onChangeItem === null || onChangeItem === void 0 || onChangeItem(selectionMode === 'multiple' ? rows : rows[0]);
   };
   var onSelectionChanged = function onSelectionChanged(e) {
-    var selectedRows = e.api.getSelectedRows();
-    setSelectRows(selectedRows);
+    setSelectRows(e.api.getSelectedRows());
   };
-  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", {
-    style: {
-      display: 'flex',
-      flexDirection: 'row'
+
+  // 入口做成输入框内的后缀图标：不占右侧宽度，禁用/只读时不出现。@author nokecy
+  var canOpen = !props.disabled && !hideBtn;
+  var trigger = canOpen ? /*#__PURE__*/React.createElement("span", {
+    className: "qc-dialog-select-trigger",
+    role: "button",
+    "aria-label": "\u6253\u5F00\u9009\u62E9\u7A97\u53E3",
+    title: "\u9009\u62E9"
+    // 阻止冒泡：点图标只开选择窗口，不展开下拉也不抢走输入框焦点。
+    ,
+    onMouseDown: function onMouseDown(e) {
+      e.preventDefault();
+      e.stopPropagation();
+    },
+    onClick: function onClick(e) {
+      e.stopPropagation();
+      setSelectRows(undefined);
+      setTrue();
     }
-  }, props.useAutoComplete && !props.labelInValue ? /*#__PURE__*/React.createElement(AutoComplete, _extends({}, rest, {
+  }, /*#__PURE__*/React.createElement(SearchOutlined, null)) : undefined;
+  var mergedClassName = ['qc-dialog-select', rest.className].filter(Boolean).join(' ');
+  var triggerStyle = {
+    '--qc-dialog-select-trigger-color': token.colorTextTertiary,
+    '--qc-dialog-select-trigger-hover': token.colorPrimary
+  };
+  var commonProps = _objectSpread(_objectSpread({}, rest), {}, {
+    className: mergedClassName,
     value: state,
-    style: _objectSpread(_objectSpread({}, rest === null || rest === void 0 ? void 0 : rest.style), {}, {
-      width: "calc(100% - 0px)",
-      marginRight: !props.hideBtn ? 5 : 0
-    })
-  })) : /*#__PURE__*/React.createElement(Select, _extends({
+    style: _objectSpread(_objectSpread({}, triggerStyle), rest.style || {})
+  }, trigger ? {
+    suffixIcon: trigger
+  } : {});
+  return /*#__PURE__*/React.createElement(React.Fragment, null, useAutoComplete && !props.labelInValue ? /*#__PURE__*/React.createElement(AutoComplete, commonProps) : /*#__PURE__*/React.createElement(Select, _extends({
     maxTagCount: 'responsive',
     filterOption: false
-  }, rest, {
-    value: state,
-    style: _objectSpread({
-      width: "calc(100% - 0px)",
-      marginRight: !props.hideBtn ? 5 : 0
-    }, rest.style || {})
-  })), !props.disabled && !props.hideBtn ? /*#__PURE__*/React.createElement(Button, {
-    icon: /*#__PURE__*/React.createElement(DashOutlined, null),
-    onClick: function onClick() {
-      setTrue();
-    },
-    disabled: rest.disabled
-  }) : null), /*#__PURE__*/React.createElement(DraggableModal, {
-    width: 960,
+  }, commonProps)), dialogRenderer ? dialogRenderer({
+    open: visible,
+    mode: selectionMode,
+    onCancel: close,
+    onConfirm: confirmRows
+  }) : /*#__PURE__*/React.createElement(DraggableModal, {
+    width: modalWidth,
     title: "\u9009\u62E9",
-    style: {
-      zIndex: 9999
-    },
+    zIndex: dialogZIndex,
     destroyOnClose: true,
     open: visible,
-    onOk: handleOk,
-    onCancel: setFalse
-  }, /*#__PURE__*/React.createElement(AgGridPlus, {
+    onOk: function onOk() {
+      return confirmRows(selectRows || []);
+    },
+    onCancel: close,
+    okButtonProps: {
+      disabled: !(selectRows !== null && selectRows !== void 0 && selectRows.length)
+    }
+  }, selectionMode === 'multiple' && /*#__PURE__*/React.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.createElement(Grid, _extends({
+    gridKey: dialogGridKey,
+    dataSource: dialogDataSource,
+    hidePagination: localData
+  }, localData ? {
+    getRowId: function getRowId(_ref) {
+      var data = _ref.data;
+      return String(data[key]);
+    }
+  } : {}, {
     style: {
       height: 450
     },
-    onGridReady: function onGridReady(gridReadEvent) {
-      setGridApi(gridReadEvent.api);
-    },
-    onFirstDataRendered: function onFirstDataRendered(_ref) {
-      var api = _ref.api;
-      // 多选时重开弹窗要把已经选中的行勾回来，否则用户会以为之前的选择丢了。
+    pageSize: dialogPageSize,
+    pageSizeOptions: dialogPageSizeOptions,
+    onFirstDataRendered: function onFirstDataRendered(_ref2) {
+      var api = _ref2.api;
+      // 重开弹窗要把已经选中的行勾回来，否则用户会以为之前的选择丢了。
       // 放在首屏数据渲染完成时做：弹窗是 destroyOnClose，打开的那一刻表格还没有数据。@author nokecy
-      if (!Array.isArray(state) || state.length === 0) return;
-      var key = valueField !== null && valueField !== void 0 ? valueField : 'id';
-      var selected = state.map(function (it) {
+      var current = Array.isArray(state) ? state : state == null ? [] : [state];
+      var selected = current.map(function (it) {
         return it && _typeof(it) === 'object' ? it.value : it;
       });
+      if (!selected.length) return;
       api.forEachNode(function (node) {
-        if (node.data && selected.includes(node.data[key])) {
-          node.setSelected(true);
-        }
+        if (node.data && selected.includes(node.data[key])) node.setSelected(true);
       });
     },
-    search: (columnDefs === null || columnDefs === void 0 ? void 0 : columnDefs.filter(function (i) {
+    search: !localData && (columnDefs === null || columnDefs === void 0 ? void 0 : columnDefs.filter(function (i) {
       return !i.hideInSearch;
     }).length) !== 0,
     onSelectionChanged: onSelectionChanged,
-    rowSelection: props.mode === 'multiple' ? props.mode : 'single',
-    onRowDoubleClicked: function onRowDoubleClicked(_ref2) {
-      var data = _ref2.data;
-      setFalse();
-      setState(getValue([data]));
-      // 回传完整数据行：原来这里硬编码成 { label: data.name, value: data.code }，
-      // 与「确定」按钮走的 handleOk 口径不一致，且对没有 name/code 字段的实体直接取到 undefined。@author nokecy
-      if (onChangeItem) onChangeItem(props.mode === 'multiple' ? [data] : data);
+    rowSelection: dialogIsRowSelectable ? {
+      mode: selectionMode === 'multiple' ? 'multiRow' : 'singleRow',
+      isRowSelectable: function isRowSelectable(node) {
+        return !!node.data && dialogIsRowSelectable(node.data);
+      }
+    } : selectionMode === 'multiple' ? 'multiple' : 'single',
+    onRowDoubleClicked: function onRowDoubleClicked(_ref3) {
+      var data = _ref3.data;
+      if (dialogIsRowSelectable && !dialogIsRowSelectable(data)) return;
+      confirmRows([data]);
     },
-    request: ( /*#__PURE__*/function () {
-      var _ref3 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(params, _, record) {
-        var _props$pagedApiAdapte;
-        var adapter, data, requestData;
+    request: localData ? undefined : ( /*#__PURE__*/function () {
+      var _ref4 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(params, _, record) {
+        var adapter, data;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
-              adapter = (_props$pagedApiAdapte = props.pagedApiAdapter) !== null && _props$pagedApiAdapte !== void 0 ? _props$pagedApiAdapte : abpPagedApiAdapter;
+              adapter = pagedApiAdapter !== null && pagedApiAdapter !== void 0 ? pagedApiAdapter : abpPagedApiAdapter;
               _context.next = 3;
               return request(adapter.toRequest({
-                filter: props !== null && props !== void 0 && props.queryFun ? props === null || props === void 0 ? void 0 : props.queryFun(params === null || params === void 0 ? void 0 : params.filter) : params === null || params === void 0 ? void 0 : params.filter,
+                filter: queryFun ? queryFun(params === null || params === void 0 ? void 0 : params.filter) : params === null || params === void 0 ? void 0 : params.filter,
                 sorter: params === null || params === void 0 ? void 0 : params.sorter,
                 skipCount: params === null || params === void 0 ? void 0 : params.skipCount,
-                maxResultCount: params === null || params === void 0 ? void 0 : params.maxResultCount
+                maxResultCount: params === null || params === void 0 ? void 0 : params.maxResultCount,
+                record: record
               }), record);
             case 3:
               data = _context.sent;
-              requestData = {
+              return _context.abrupt("return", {
                 success: true,
                 data: adapter.getItems(data),
                 total: adapter.getTotal(data)
-              };
-              setItems(adapter.getItems(data));
-              return _context.abrupt("return", requestData);
-            case 7:
+              });
+            case 5:
             case "end":
               return _context.stop();
           }
         }, _callee);
       }));
       return function (_x, _x2, _x3) {
-        return _ref3.apply(this, arguments);
+        return _ref4.apply(this, arguments);
       };
     }()),
     columnDefs: columnDefs
-  })));
+  }))));
 };
 export default DialogSelect;

package/dist/esm/dialogSelect/index.less

@@ -0,0 +1,39 @@
+// 选择窗口入口放在输入框内部（后缀图标），不再在右侧另占一个按钮的宽度。@author nokecy
+.qc-dialog-select {
+	width: 100%;
+
+	// 后缀图标可点；antd 默认给后缀 pointer-events: none。
+	.qc-dialog-select-trigger {
+		display: inline-flex;
+		align-items: center;
+		justify-content: center;
+		width: 100%;
+		height: 100%;
+		cursor: pointer;
+		pointer-events: auto;
+		color: var(--qc-dialog-select-trigger-color, rgba(0, 0, 0, 0.45));
+		transition: color 0.2s;
+
+		&:hover {
+			color: var(--qc-dialog-select-trigger-hover, #1677ff);
+		}
+	}
+
+	// 悬停时 antd 会把后缀淡出、换成清除图标；这里让入口始终可见，清除图标左移一格并排。
+	&.ant-select.ant-select:hover .ant-select-arrow:not(:last-child) {
+		opacity: 1;
+	}
+
+	&.ant-select-allow-clear .ant-select-clear {
+		inset-inline-end: 31px;
+	}
+
+	&.ant-select-allow-clear .ant-select-selection-item,
+	&.ant-select-allow-clear .ant-select-selection-placeholder {
+		padding-inline-end: 36px;
+	}
+
+	&.ant-select-multiple .ant-select-selector {
+		padding-inline-end: 38px;
+	}
+}

package/dist/esm/draggableModal/index.js

@@ -67,14 +67,18 @@ var DraggableModal = function DraggableModal(props) {
   // 修复 AgGrid 等组件在 Modal 中高度不展开的问题
   // 当 Modal 打开时触发 window resize 事件
   useEffect(function () {
-    if (open) {
-      // 使用 requestAnimationFrame 和 setTimeout 确保 DOM 完全渲染
-      requestAnimationFrame(function () {
-        setTimeout(function () {
-          window.dispatchEvent(new Event('resize'));
-        }, 100);
-      });
-    }
+    if (!open) return;
+    // 使用 requestAnimationFrame 和 setTimeout 确保 DOM 完全渲染；卸载或关闭时取消，避免对已销毁的环境派发事件
+    var timer;
+    var frame = requestAnimationFrame(function () {
+      timer = setTimeout(function () {
+        window.dispatchEvent(new Event('resize'));
+      }, 100);
+    });
+    return function () {
+      cancelAnimationFrame(frame);
+      if (timer !== undefined) clearTimeout(timer);
+    };
   }, [open]);
   var _onStart = function onStart(_event, uiData) {
     var _draggleRef$current;

package/dist/esm/index.d.ts

@@ -31,4 +31,9 @@ export type * from "./RuleBuilder";
 export type { ColumnConfig } from "./array-table/columnHelper";
 export type { CentralizedColumnScheme, QueryScheme, SchemeStorageAdapter, SchemeSyncDataDto, CurrentSchemeDto, SchemeStorageConfig, LocalStorageAdapterConfig, BackendApiAdapterConfig, UseSchemeManagerConfig, GridPlusContextValue, GlobalConfigPermissions, } from "./ag-grid-plus";
 export * from './adapters';
+export { semanticTextColors, toGridTextColor, gridValueEnum } from "./ag-grid-plus/utils/valueEnumColor";
+export type { SemanticPreset } from "./ag-grid-plus/utils/valueEnumColor";
+export { contrastRatio, relativeLuminance, darkenUntilContrast, lightenUntilContrast, toRgb, toHsl, fromHsl } from "./utils/contrast";
+export { BusinessDecimal, decimal, decimalText, nonNegativeDecimal, roundDecimal, sumDecimals, formatDecimal } from "./utils/businessDecimal";
+export type { DecimalValue } from "./utils/businessDecimal";
 export type { ParseResult as RegexParseResult, ValidationResult as RegexValidationResult, RegexError, ComplexityMetrics, ASTNode, AstRegExp, RegexTemplate, TestResult as RegexTestResult, CodeMirrorWrapperProps, RegexEditorProps, RegexFlags, MatchResult, RegexTesterProps, FlagsSelectorProps, MatchItemProps, RegexRailroadDiagramProps, } from "./components/RegexEditor";

package/dist/esm/index.js

@@ -42,5 +42,8 @@ useSchemeManager, useGridSchemes, LocalStorageSchemeAdapter, BackendApiSchemeAda
 
 // 分页适配器:值 + 类型一并导出,支持非 ABP 后端注入
 export * from "./adapters";
+export { semanticTextColors, toGridTextColor, gridValueEnum } from "./ag-grid-plus/utils/valueEnumColor";
+export { contrastRatio, relativeLuminance, darkenUntilContrast, lightenUntilContrast, toRgb, toHsl, fromHsl } from "./utils/contrast";
+export { BusinessDecimal, decimal, decimalText, nonNegativeDecimal, roundDecimal, sumDecimals, formatDecimal } from "./utils/businessDecimal";
 
 // RegexEditor 类型定义 - 使用命名导出避免冲突

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

@@ -1,4 +1,5 @@
 import React from 'react';
 import './index.less';
+/** 详情、表单共用工具栏：按实际操作元素统一留出间距，宽度不足时换行。@author nokecy */
 declare const ToolBar: (props: any) => React.JSX.Element;
 export default ToolBar;

package/dist/esm/toolBar/index.js

@@ -1,28 +1,61 @@
-var _excluded = ["children", "className", "extra", "style", "renderContent", "getTargetContainer"];
+var _excluded = ["children", "className", "extra", "identity", "banner", "style", "renderContent", "getTargetContainer"];
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
-import React from 'react';
-import { Affix, Space } from 'antd';
+import React, { useCallback, useRef } from 'react';
+import { Affix, theme } from 'antd';
 import "./index.less";
+
+/** 详情、表单共用工具栏：按实际操作元素统一留出间距，宽度不足时换行。@author nokecy */
 var ToolBar = function ToolBar(props) {
   var children = props.children,
     className = props.className,
     extra = props.extra,
+    identity = props.identity,
+    banner = props.banner,
     style = props.style,
     renderContent = props.renderContent,
     getTargetContainer = props.getTargetContainer,
     restProps = _objectWithoutProperties(props, _excluded);
+  var _theme$useToken = theme.useToken(),
+    token = _theme$useToken.token; // 单据操作栏跟随宿主主题。@author nokecy
+  var barRef = useRef(null);
+  // @author nokecy：KeepAlive 内容区独立滚动，吸顶应相对其视口，避免定位到应用顶栏下面。
+  var defaultTarget = useCallback(function () {
+    var _barRef$current$paren, _barRef$current;
+    var parent = (_barRef$current$paren = (_barRef$current = barRef.current) === null || _barRef$current === void 0 ? void 0 : _barRef$current.parentElement) !== null && _barRef$current$paren !== void 0 ? _barRef$current$paren : null;
+    while (parent) {
+      if (/auto|scroll/.test(getComputedStyle(parent).overflowY)) return parent;
+      parent = parent.parentElement;
+    }
+    return window;
+  }, []);
   return /*#__PURE__*/React.createElement(Affix, {
     offsetTop: 2,
     style: style,
     offsetBottom: 2,
-    target: getTargetContainer
+    target: getTargetContainer || defaultTarget
   }, /*#__PURE__*/React.createElement("div", {
-    className: "antd-tool-bar"
-  }, /*#__PURE__*/React.createElement("div", {
-    className: "antd-tool-bar-left".trim()
-  }, /*#__PURE__*/React.createElement(Space, null, extra)), /*#__PURE__*/React.createElement("div", {
-    className: "antd-tool-bar-right".trim()
-  }, /*#__PURE__*/React.createElement(Space, null, children))));
+    ref: barRef,
+    className: "antd-tool-bar",
+    style: {
+      backgroundColor: token.colorBgContainer,
+      color: token.colorText,
+      borderBlockStartColor: token.colorBorderSecondary,
+      gap: token.marginXS,
+      paddingBlock: token.paddingXXS
+    }
+  }, banner && /*#__PURE__*/React.createElement("div", {
+    className: "antd-tool-bar-banner"
+  }, banner), /*#__PURE__*/React.createElement("div", {
+    className: "antd-tool-bar-left",
+    style: {
+      gap: token.marginXS
+    }
+  }, extra, identity), /*#__PURE__*/React.createElement("div", {
+    className: "antd-tool-bar-right",
+    style: {
+      gap: token.marginXS
+    }
+  }, children)));
 };
 export default ToolBar;

package/dist/esm/toolBar/index.less

@@ -1,25 +1,43 @@
 .antd-tool-bar {
 	display: flex;
+	flex-wrap: wrap;
 	align-items: center;
 	box-sizing: border-box;
 	width: 100%;
-	color: rgba(0, 0, 0, 0.88);
 	line-height: 40px;
-	background-color: rgba(255, 255, 255);
-	-webkit-backdrop-filter: blur(8px);
+	backdrop-filter: blur(8px);
 	backdrop-filter: blur(8px);
 	transition: all 0.2s ease 0s;
 	inset-inline-end: 0;
 	padding-inline: 16px;
 	padding-block: 0;
-	border-block-start: 1px solid rgba(5, 5, 5, 0.06);
+	// 颜色由组件读取主题 token；子区域继承正文色。
+	border-block-start: 1px solid;
+}
+
+.antd-tool-bar-banner {
+	flex: 1 0 100%;
+	min-width: 0;
+	line-height: normal;
 }
 
 .antd-tool-bar-left {
-	flex: 1;
-	color: rgba(0, 0, 0, 0.88);
+	flex: 1 0 auto;
+	color: inherit;
+}
+
+.antd-tool-bar-right {
+	margin-inline-start: auto;
+	justify-content: flex-end;
+    color: inherit;
 }
 
+/* 直接排列组件输出的按钮，React Fragment 内的按钮也获得相同间距。@author nokecy */
+.antd-tool-bar-left,
 .antd-tool-bar-right {
-    color: rgba(0, 0, 0, 0.88);
+	display: flex;
+	flex-wrap: wrap;
+	align-items: center;
+	min-width: 0;
+	max-width: 100%;
 }

package/dist/esm/utils/businessDecimal.d.ts

@@ -0,0 +1,11 @@
+import Decimal from 'decimal.js';
+/** 业务值保留十进制文本，运算使用十进制库；整型标识和时间不经过此入口。@author nokecy */
+export declare const BusinessDecimal: typeof Decimal;
+export type DecimalValue = string | number | Decimal | null | undefined;
+export declare const decimal: (value: DecimalValue) => Decimal;
+export declare const decimalText: (value: DecimalValue) => string;
+export declare const nonNegativeDecimal: (value: DecimalValue) => string;
+export declare const roundDecimal: (value: DecimalValue, places: number) => string;
+export declare const sumDecimals: (values: DecimalValue[]) => string;
+/** 指定取位规则显示，千分位直接处理文本，不转换为 JavaScript number。@author nokecy */
+export declare const formatDecimal: (value: DecimalValue, places?: number, minimumPlaces?: number) => string;