@nokecy/qc-ui 1.1.74 → 1.1.75

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/index.d.ts

@@ -31,6 +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 * from "./readPretty";
+export { createEntitySelect } from "./entitySelect";
+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";
 export { contrastRatio, relativeLuminance, darkenUntilContrast, lightenUntilContrast, toRgb, toHsl, fromHsl } from "./utils/contrast";

package/dist/cjs/index.js

@@ -47,6 +47,7 @@ var _exportNames = {
   FlagsSelector: true,
   MatchItem: true,
   RegexRailroadDiagram: true,
+  createEntitySelect: true,
   semanticTextColors: true,
   toGridTextColor: true,
   gridValueEnum: true,
@@ -287,6 +288,12 @@ Object.defineProperty(exports, "createCascaderField", {
     return _standardFormDialog.createCascaderField;
   }
 });
+Object.defineProperty(exports, "createEntitySelect", {
+  enumerable: true,
+  get: function get() {
+    return _entitySelect.createEntitySelect;
+  }
+});
 Object.defineProperty(exports, "createSelectField", {
   enumerable: true,
   get: function get() {
@@ -460,6 +467,19 @@ Object.keys(_adapters).forEach(function (key) {
     }
   });
 });
+var _readPretty = require("./readPretty");
+Object.keys(_readPretty).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _readPretty[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _readPretty[key];
+    }
+  });
+});
+var _entitySelect = require("./entitySelect");
 var _valueEnumColor = require("./ag-grid-plus/utils/valueEnumColor");
 var _contrast = require("./utils/contrast");
 var _businessDecimal = require("./utils/businessDecimal");

package/dist/cjs/readPretty/arrayTable.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 阅读态也创建列的 void 字段，让 Formily 求值标题、显隐与 reactions；
+ * qc-ui 的阅读视图只读取列状态，未像编辑视图一样挂载这些字段。
+ * @author nokecy
+ */
+export declare const withReadingArrayTable: (Control: any) => any;

package/dist/cjs/readPretty/arrayTable.js

@@ -0,0 +1,156 @@
+"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
+});
+exports.withReadingArrayTable = void 0;
+var _react = require("@formily/react");
+var _agGridReact = require("ag-grid-react");
+var _utils = require("../array-table/utils");
+var _columnGroup = require("../array-table/columnGroup");
+var _indexColumn = require("../array-table/indexColumn");
+var _theme = require("../array-table/theme");
+var _hoistStatics = require("./hoistStatics");
+var _react2 = _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 _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+/** 阅读态直接使用 ArrayTable 的列定义，避免 AgGridPlus 的原值渲染器覆盖格式化结果。@author nokecy */
+var ReadingArrayTable = (0, _react.observer)(function (_ref) {
+  var _buildArrayTableColum;
+  var height = _ref.height;
+  var field = (0, _react.useField)();
+  var sources = (0, _utils.useArrayTableSources)();
+  var rows = Array.isArray(field.value) ? field.value.slice() : [];
+  var generatedRowIds = (0, _react2.useRef)(new WeakMap());
+  var generatedRowIdSequence = (0, _react2.useRef)(0);
+  var columns = (_buildArrayTableColum = (0, _utils.buildArrayTableColumns)(rows, field, sources)) !== null && _buildArrayTableColum !== void 0 ? _buildArrayTableColum : [];
+  var showIndex = columns.length > 0 && !(0, _indexColumn.hasOwnIndexColumn)(sources);
+  if (showIndex) columns.unshift((0, _indexColumn.makeIndexColumn)());
+  var theme = (0, _theme.useArrayTableTheme)();
+  return /*#__PURE__*/_react2.default.createElement("div", {
+    style: {
+      height: height !== null && height !== void 0 ? height : 400
+    }
+  }, /*#__PURE__*/_react2.default.createElement(_agGridReact.AgGridReact, {
+    theme: theme,
+    rowHeight: _theme.ARRAY_TABLE_ROW_HEIGHT,
+    enableCellTextSelection: true,
+    ensureDomOrder: true,
+    defaultColDef: {
+      resizable: true,
+      sortable: true,
+      filter: true
+    },
+    rowSelection: {
+      mode: 'singleRow',
+      enableClickSelection: true
+    },
+    selectionColumnDef: {
+      pinned: 'left',
+      lockPosition: true,
+      width: 50,
+      suppressHeaderMenuButton: true
+    },
+    columnDefs: (0, _columnGroup.groupColumnDefs)(columns),
+    rowData: rows,
+    getRowId: function getRowId(_ref2) {
+      var _data$_id;
+      var data = _ref2.data;
+      var id = (_data$_id = data === null || data === void 0 ? void 0 : data._id) !== null && _data$_id !== void 0 ? _data$_id : data === null || data === void 0 ? void 0 : data.id;
+      if (id != null) return "data:".concat(String(id));
+
+      // 阅读态明细常用旧表行号等字段，不一定有 id/_id。给无 ID 的对象分配稳定行键，
+      // 否则多行都会返回 "undefined"，AG Grid 在数据更新后会合并掉重复行。@author nokecy
+      var row = data;
+      var rowId = generatedRowIds.current.get(row);
+      if (!rowId) {
+        rowId = "generated:".concat(++generatedRowIdSequence.current);
+        generatedRowIds.current.set(row, rowId);
+      }
+      return rowId;
+    },
+    onRowDataUpdated: function onRowDataUpdated(_ref3) {
+      var api = _ref3.api;
+      if (showIndex) api.refreshCells({
+        columns: [_indexColumn.ARRAY_TABLE_INDEX_FIELD],
+        force: true
+      });
+    }
+  }));
+});
+
+/** 按 ArrayTable 的列提取规则收集列节点，不挂载明细数据字段。@author nokecy */
+var columnsOf = function columnsOf(schema) {
+  var columns = [];
+  var visit = function visit(node) {
+    if (typeof node['x-component'] === 'string' && node['x-component'].includes('Column')) {
+      var _node$xComponentPro, _node$xComponentPro2;
+      var name = (_node$xComponentPro = (_node$xComponentPro2 = node['x-component-props']) === null || _node$xComponentPro2 === void 0 ? void 0 : _node$xComponentPro2.dataIndex) !== null && _node$xComponentPro !== void 0 ? _node$xComponentPro : node.name;
+      if (name !== undefined) columns.push({
+        name: name,
+        schema: node
+      });
+    } else {
+      Object.values(node.properties || {}).forEach(visit);
+    }
+  };
+  var items = Array.isArray(schema.items) ? schema.items : schema.items ? [schema.items] : [];
+  items.forEach(visit);
+  return columns;
+};
+
+/**
+ * 阅读态也创建列的 void 字段，让 Formily 求值标题、显隐与 reactions；
+ * qc-ui 的阅读视图只读取列状态，未像编辑视图一样挂载这些字段。
+ * @author nokecy
+ */
+var withReadingArrayTable = exports.withReadingArrayTable = function withReadingArrayTable(Control) {
+  var ReactiveTable = (0, _react.observer)(function (_ref4) {
+    var columns = _ref4.columns,
+      tableProps = _ref4.tableProps;
+    var field = (0, _react.useField)();
+    // 阅读视图本身未订阅列状态，在此建立依赖，条件变化后重新提取表头。@author nokecy
+    var _iterator = _createForOfIteratorHelper(columns),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var _column$componentProp, _column$componentProp2, _column$componentProp3;
+        var name = _step.value.name;
+        var column = field.query(field.address.concat(name)).take();
+        void (column === null || column === void 0 ? void 0 : column.display);
+        void (column === null || column === void 0 || (_column$componentProp = column.componentProps) === null || _column$componentProp === void 0 ? void 0 : _column$componentProp.title);
+        void (column === null || column === void 0 || (_column$componentProp2 = column.componentProps) === null || _column$componentProp2 === void 0 ? void 0 : _column$componentProp2.headerName);
+        void (column === null || column === void 0 || (_column$componentProp3 = column.componentProps) === null || _column$componentProp3 === void 0 ? void 0 : _column$componentProp3.headerGroup);
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+    return /*#__PURE__*/_react2.default.createElement(ReadingArrayTable, tableProps);
+  });
+  var Table = (0, _react.observer)(function (props) {
+    var field = (0, _react.useField)();
+    var schema = (0, _react.useFieldSchema)();
+    var columns = (0, _react2.useMemo)(function () {
+      return columnsOf(schema);
+    }, [schema]);
+    if (field.pattern !== 'readPretty') return /*#__PURE__*/_react2.default.createElement(Control, props);
+    return /*#__PURE__*/_react2.default.createElement(_react2.default.Fragment, null, columns.map(function (column) {
+      return /*#__PURE__*/_react2.default.createElement(_react.RecursionField, {
+        key: column.name,
+        name: column.name,
+        schema: column.schema,
+        onlyRenderSelf: true
+      });
+    }), /*#__PURE__*/_react2.default.createElement(ReactiveTable, {
+      columns: columns,
+      tableProps: props
+    }));
+  });
+  return (0, _hoistStatics.hoistStatics)(Table, Control);
+};

package/dist/cjs/readPretty/controls.d.ts

@@ -0,0 +1,11 @@
+import { Input as AntInput, InputNumber as AntInputNumber, Select as AntSelect, Switch as AntSwitch, Checkbox as AntCheckbox, Radio as AntRadio, DatePicker as AntDatePicker, TimePicker as AntTimePicker, TreeSelect as AntTreeSelect, Cascader as AntCascader } from 'antd';
+export declare const Input: typeof AntInput;
+export declare const InputNumber: typeof AntInputNumber;
+export declare const Select: typeof AntSelect;
+export declare const Switch: typeof AntSwitch;
+export declare const Checkbox: typeof AntCheckbox;
+export declare const Radio: typeof AntRadio;
+export declare const DatePicker: typeof AntDatePicker;
+export declare const TimePicker: typeof AntTimePicker;
+export declare const TreeSelect: typeof AntTreeSelect;
+export declare const Cascader: typeof AntCascader;