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

package/dist/cjs/ag-grid-plus/shared/storage/schemeStorageAdapter.d.ts

@@ -0,0 +1,209 @@
+import type { FlatColumnItem } from '../../setting/columnGroupTypes';
+/**
+ * 查询项配置
+ */
+export interface QueryItem {
+    /** 字段名 */
+    field: string;
+    /** 是否隐藏 */
+    hidden?: boolean;
+}
+/**
+ * 逻辑操作符 // P0
+ */
+export type LogicOperator = 'AND' | 'OR';
+/**
+ * 查询规则操作符 // P0
+ */
+export type RuleOperator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'isEmpty' | 'isNotEmpty' | 'between';
+/**
+ * 单条查询规则 // P0
+ */
+export interface QueryRule {
+    /** 规则ID */
+    id: string;
+    /** 字段名 */
+    field: string;
+    /** 操作符 */
+    operator: string;
+    /** 值 */
+    value: any;
+}
+/**
+ * 查询规则组 // P0
+ */
+export interface QueryRuleGroup {
+    /** 组ID */
+    id: string;
+    /** 逻辑连接符 */
+    logic: LogicOperator;
+    /** 子规则或子组 */
+    children: (QueryRule | QueryRuleGroup)[];
+}
+/**
+ * 查询配置结构
+ */
+export interface QueryConfig {
+    /** 查询项配置列表 (按顺序排列) */
+    items: QueryItem[];
+    /** 查询表单默认值 */
+    defaultValues?: Record<string, any>;
+    /** 查询模式: simple(简单表单) | advanced(高级组合器) // P0 */
+    mode?: 'simple' | 'advanced';
+    /** 高级模式下的规则树 // P0 */
+    rules?: QueryRuleGroup;
+}
+/**
+ * 查询方案
+ */
+export interface QueryScheme {
+    /** 方案唯一标识 */
+    id: string;
+    /** 方案名称 */
+    name: string;
+    /** 方案描述 */
+    description?: string;
+    /** 查询配置 */
+    queryConfig: QueryConfig;
+    /** 是否为默认方案 */
+    isDefault: boolean;
+    /** 是否为系统方案（不可删除） */
+    isSystem: boolean;
+    /** 创建时间戳（由存储适配器自动生成） */
+    createdAt?: number;
+    /** 最后更新时间戳（由存储适配器自动生成） */
+    updatedAt?: number;
+    /** 创建用户ID（可选） */
+    createdBy?: string;
+    /** 是否为全局方案 @author nokecy */
+    isGlobal?: boolean;
+}
+/**
+ * 列方案（集中式 API 使用）
+ * 使用扩展的列配置格式，包含分组层级结构
+ */
+export interface ColumnScheme {
+    /** 方案唯一标识 */
+    id: string;
+    /** 方案名称 */
+    name: string;
+    /** 方案描述 */
+    description?: string;
+    /** 完整的列配置数据(包含分组层级结构) */
+    columnConfig: FlatColumnItem[];
+    /** @deprecated 列头筛选不再随方案保存与还原，字段仅为兼容旧数据保留 */
+    filterModel?: any;
+    /** 是否为默认方案 */
+    isDefault: boolean;
+    /** 是否为系统方案（不可删除） */
+    isSystem: boolean;
+    /** 创建时间戳（由存储适配器自动生成） */
+    createdAt?: number;
+    /** 最后更新时间戳（由存储适配器自动生成） */
+    updatedAt?: number;
+    /** 创建用户ID（可选） */
+    createdBy?: string;
+    /** 方案来源标识（便于前端区分展示，由前端计算） */
+    isGlobal?: boolean;
+}
+/**
+ * 方案同步数据结构
+ */
+export interface SchemeSyncDataDto {
+    /** 列方案，按 GridId 分组 */
+    columnSchemes: Record<string, ColumnScheme[]>;
+    /** 查询方案，按 GridId 分组 */
+    querySchemes: Record<string, QueryScheme[]>;
+    /** 当前激活方案，Key 为 GridId */
+    currentSchemes: Record<string, CurrentSchemeDto>;
+    /** 服务器当前时间戳（毫秒） */
+    syncTime: number;
+    /** 数据版本号 */
+    version: number;
+}
+/**
+ * 当前方案 DTO
+ */
+export interface CurrentSchemeDto {
+    /** 列方案ID */
+    columnSchemeId?: string | null;
+    /** 查询方案ID */
+    querySchemeId?: string | null;
+}
+/**
+ * 方案存储适配器接口
+ *
+ * 支持两种实现:
+ * - LocalStorageAdapter: 本地存储
+ * - BackendApiAdapter: 远程 API
+ */
+export interface SchemeStorageAdapter {
+    /**
+     * 获取用户所有方案数据 (初始化时调用一次)
+     * @returns 所有表格的方案数据
+     */
+    loadAllSchemes(): Promise<SchemeSyncDataDto>;
+    /**
+     * 保存/更新列方案
+     * @param gridId 表格ID
+     * @param scheme 方案对象 (id 存在表示更新,不存在表示新增)
+     * @returns 保存后的方案对象
+     */
+    saveColumnScheme(gridId: string, scheme: ColumnScheme): Promise<ColumnScheme>;
+    /**
+     * 删除列方案
+     * @param gridId 表格ID
+     * @param schemeId 方案ID
+     */
+    deleteColumnScheme(gridId: string, schemeId: string): Promise<void>;
+    /**
+     * 保存/更新查询方案
+     * @param gridId 表格ID
+     * @param scheme 方案对象
+     * @returns 保存后的方案对象
+     */
+    saveQueryScheme(gridId: string, scheme: QueryScheme): Promise<QueryScheme>;
+    /**
+     * 删除查询方案
+     * @param gridId 表格ID
+     * @param schemeId 方案ID
+     */
+    deleteQueryScheme(gridId: string, schemeId: string): Promise<void>;
+    /**
+     * 设置当前方案
+     * @param gridId 表格ID
+     * @param columnSchemeId 列方案ID (null 表示清除)
+     * @param querySchemeId 查询方案ID (null 表示清除)
+     */
+    setCurrentScheme(gridId: string, columnSchemeId: string | null, querySchemeId: string | null): Promise<void>;
+    /**
+     * 将方案应用到全局（管理员操作）
+     * 将指定的用户方案复制为 UserId=null 的全局方案
+     * @param gridId 表格标识
+     * @param schemeId 源方案ID（用户的方案）
+     * @returns 全局方案ID
+     * @throws 403 - 无权限
+     * @throws 404 - 源方案不存在
+     */
+    applyToGlobal?(gridId: string, schemeId: string): Promise<string>;
+    /**
+     * 重置当前用户配置，回退到全局配置
+     * 删除当前用户在指定表格的所有个人方案
+     * @param gridId 表格标识
+     */
+    resetToGlobal?(gridId: string): Promise<void>;
+    /**
+     * 重置所有用户配置（管理员操作）
+     * 删除指定表格下所有用户的个人方案，保留全局方案
+     * @param gridId 表格标识
+     * @throws 403 - 无权限
+     */
+    resetAllUsers?(gridId: string): Promise<void>;
+}
+/**
+ * 适配器配置基类
+ */
+export interface SchemeStorageConfig {
+    /** 是否启用调试日志 */
+    enableDebugLog?: boolean;
+}

package/dist/cjs/ag-grid-plus/shared/storage/schemeStorageAdapter.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/ag-grid-plus/shared/utils/schemeDataMigration.d.ts

@@ -0,0 +1,27 @@
+import type { QueryScheme, QueryConfig } from '../storage/schemeStorageAdapter';
+/**
+ * 从查询方案提取字段顺序数组
+ * @param scheme 查询方案对象
+ * @returns 字段顺序数组
+ */
+export declare function extractItemsOrder(scheme: QueryScheme): string[];
+/**
+ * 从查询方案提取隐藏字段数组
+ * @param scheme 查询方案对象
+ * @returns 隐藏字段数组
+ */
+export declare function extractHiddenFields(scheme: QueryScheme): string[];
+/**
+ * 从查询方案提取表单默认值
+ * @param scheme 查询方案对象
+ * @returns 表单默认值对象
+ */
+export declare function extractFormValues(scheme: QueryScheme): Record<string, any>;
+/**
+ * 构建 QueryConfig 对象
+ * @param itemsOrder 字段顺序数组
+ * @param hiddenFields 隐藏字段数组
+ * @param formValues 表单默认值
+ * @returns QueryConfig 对象
+ */
+export declare function buildQueryConfig(itemsOrder: string[], hiddenFields?: string[], formValues?: Record<string, any>): QueryConfig;

package/dist/cjs/ag-grid-plus/shared/utils/schemeDataMigration.js

@@ -0,0 +1,63 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildQueryConfig = buildQueryConfig;
+exports.extractFormValues = extractFormValues;
+exports.extractHiddenFields = extractHiddenFields;
+exports.extractItemsOrder = extractItemsOrder;
+/**
+ * 从查询方案提取字段顺序数组
+ * @param scheme 查询方案对象
+ * @returns 字段顺序数组
+ */
+function extractItemsOrder(scheme) {
+  return scheme.queryConfig.items.map(function (item) {
+    return item.field;
+  });
+}
+
+/**
+ * 从查询方案提取隐藏字段数组
+ * @param scheme 查询方案对象
+ * @returns 隐藏字段数组
+ */
+function extractHiddenFields(scheme) {
+  return scheme.queryConfig.items.filter(function (item) {
+    return item.hidden;
+  }).map(function (item) {
+    return item.field;
+  });
+}
+
+/**
+ * 从查询方案提取表单默认值
+ * @param scheme 查询方案对象
+ * @returns 表单默认值对象
+ */
+function extractFormValues(scheme) {
+  return scheme.queryConfig.defaultValues || {};
+}
+
+/**
+ * 构建 QueryConfig 对象
+ * @param itemsOrder 字段顺序数组
+ * @param hiddenFields 隐藏字段数组
+ * @param formValues 表单默认值
+ * @returns QueryConfig 对象
+ */
+function buildQueryConfig(itemsOrder) {
+  var hiddenFields = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  var formValues = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  var items = itemsOrder.map(function (field) {
+    return {
+      field: field,
+      hidden: hiddenFields.includes(field)
+    };
+  });
+  return {
+    items: items,
+    defaultValues: Object.keys(formValues).length > 0 ? formValues : undefined
+  };
+}

package/dist/cjs/ag-grid-plus/theme.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AG-Grid v33 主题配置
+ * 使用 themeQuartz API 替代 CSS 变量方式
+ */
+import type { GridDensityValues } from './density';
+export declare const agGridTheme: import("ag-grid-community").Theme<import("ag-grid-community").CoreParams & import("ag-grid-community").ButtonStyleParams & import("ag-grid-community").CheckboxStyleParams & import("ag-grid-community").TabStyleParams & import("ag-grid-community").InputStyleParams & {}>;
+/**
+ * 根据当前 Ant Design ConfigProvider 主题生成 AgGrid 主题色。
+ * 网格、筛选弹层、输入框和强调状态均直接跟随 antd 主题。@author nokecy
+ */
+export declare function useAgGridTheme(options?: {
+    /** Provider 注入的密度数值；不传保持出厂外观 */
+    density?: GridDensityValues;
+    /** 页面叠加参数：在 token 与密度之后应用，只覆盖写到的项 */
+    themeParams?: Record<string, any>;
+}): import("ag-grid-community").Theme<import("ag-grid-community").CoreParams & import("ag-grid-community").ButtonStyleParams & import("ag-grid-community").CheckboxStyleParams & import("ag-grid-community").TabStyleParams & import("ag-grid-community").InputStyleParams & {}>;

package/dist/cjs/ag-grid-plus/theme.js

@@ -0,0 +1,161 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.agGridTheme = void 0;
+exports.useAgGridTheme = useAgGridTheme;
+var _agGridCommunity = require("ag-grid-community");
+var _antd = require("antd");
+var _react = require("react");
+var _rowColors = require("./rowColors");
+/**
+ * AG-Grid v33 主题配置
+ * 使用 themeQuartz API 替代 CSS 变量方式
+ */
+
+/** 右对齐只影响标题和数值，筛选入口在所有列中统一位于右侧。@author nokecy */
+var headerFilterPlacement = (0, _agGridCommunity.createPart)({
+  feature: 'qcHeaderFilterPlacement',
+  css: "\n    .ag-ltr .ag-right-aligned-header .ag-cell-label-container {\n      flex-direction: row-reverse;\n    }\n    .ag-ltr .ag-right-aligned-header .ag-header-cell-filter-button {\n      margin-left: var(--ag-spacing);\n      margin-right: 0;\n    }\n  "
+});
+
+/**
+ * 选中且悬浮行底色取 CSS 变量 `--qc-row-selected-hover-bg`（由 AgGridPlus 容器按主题写入）：
+ * 否则选中行被悬浮时只显示悬浮色，「选中」反而变淡。
+ * 表头键盘焦点环用主色 2px 实线（对白底 ≥ 3:1），原先的 3px 浅色外环对比度不足。
+ * 内置编辑器只留单元格那一层框，去掉输入框自带的第二层；单元格错误态用 `ag-cell-error` 类名（列上 cellClassRules 返回即可）。@author nokecy
+ */
+var interactionStates = (0, _agGridCommunity.createPart)({
+  feature: 'qcInteractionStates',
+  css: "\n    .ag-row-selected.ag-row-hover::before {\n      background-color: var(--qc-row-selected-hover-bg, var(--ag-selected-row-background-color));\n    }\n    .ag-header-cell:focus-visible,\n    .ag-header-group-cell:focus-visible {\n      outline: 2px solid var(--ag-accent-color);\n      outline-offset: -2px;\n      box-shadow: none;\n    }\n    .ag-header-cell:focus-visible::after,\n    .ag-header-group-cell:focus-visible::after {\n      display: none;\n    }\n    .ag-cell-inline-editing .ag-input-field-input,\n    .ag-cell-inline-editing .ag-text-field-input,\n    .ag-cell-inline-editing .ag-select .ag-picker-field-wrapper,\n    .ag-cell-inline-editing .ant-input,\n    .ag-cell-inline-editing .ant-input-number,\n    .ag-cell-inline-editing .ant-picker,\n    .ag-cell-inline-editing .ant-select .ant-select-selector {\n      border: 0 !important;\n      box-shadow: none !important;\n      outline: none !important;\n      background-color: transparent;\n    }\n    /* \u805A\u7126\u3001\u9519\u8BEF\u53EA\u7528\u5355\u5143\u683C\u8FD9\u4E00\u5C42\u6846\u8868\u8FBE\uFF1Ainset \u4E0D\u5360\u5E03\u5C40\uFF0C\u4E5F\u4E0D\u4F1A\u53E0\u5728\u5355\u5143\u683C\u7EBF\u5916 */\n    .ag-cell-inline-editing {\n      border: 0 !important;\n      box-shadow: inset 0 0 0 1px var(--ag-accent-color);\n    }\n    .ag-cell.ag-cell-error,\n    .ag-cell-inline-editing.ag-cell-error {\n      box-shadow: inset 0 0 0 1px var(--ag-invalid-color);\n    }\n  "
+});
+var agGridTheme = exports.agGridTheme = _agGridCommunity.themeQuartz.withPart(headerFilterPlacement).withPart(interactionStates).withParams({
+  // 基础颜色
+  backgroundColor: '#FFFFFF',
+  foregroundColor: '#555B62',
+  accentColor: '#087AD1',
+  invalidColor: '#e02525',
+  borderColor: '#F0F0F0',
+  // 浏览器配置
+  browserColorScheme: 'light',
+  // 边框配置
+  wrapperBorder: true,
+  rowBorder: true,
+  columnBorder: true,
+  // 表头配置
+  headerBackgroundColor: '#FAFAFA',
+  headerFontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif',
+  headerFontWeight: 600,
+  headerFontSize: 12,
+  headerHeight: 25,
+  headerTextColor: '#000000E1',
+  headerColumnBorder: true,
+  headerColumnBorderHeight: '100%',
+  headerVerticalPaddingScale: 0.8,
+  // 字体配置
+  fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif',
+  fontSize: 12,
+  // 单元格配置
+  cellTextColor: '#000000E1',
+  cellHorizontalPaddingScale: 0.7,
+  // 行配置
+  rowVerticalPaddingScale: 0.8,
+  rowHoverColor: 'color-mix(in srgb, transparent, #087AD1 12%)',
+  selectedRowBackgroundColor: 'color-mix(in srgb, transparent, #087AD1 8%)',
+  oddRowBackgroundColor: '#FFFFFF',
+  // 列 hover 配置
+  columnHoverColor: 'color-mix(in srgb, transparent, #087AD1 8%)',
+  // 图标尺寸
+  iconSize: 14,
+  // 边角配置
+  borderRadius: 2,
+  wrapperBorderRadius: 2,
+  // 范围选择
+  rangeSelectionBorderStyle: 'solid',
+  rangeSelectionBorderColor: '#087AD1',
+  rangeSelectionBackgroundColor: 'color-mix(in srgb, transparent, #087AD1 20%)',
+  // 弹窗阴影
+  popupShadow: '0 0 16px 0 #00000026',
+  dropdownShadow: '0 1px 4px 1px #babfc766',
+  // 拖拽配置
+  dragAndDropImageBackgroundColor: '#FFFFFF',
+  dragAndDropImageBorder: true,
+  // 焦点阴影
+  focusShadow: '0 0 0 3px color-mix(in srgb, transparent, #087AD1 50%)',
+  // 复选框配置
+  checkboxBorderWidth: 1,
+  checkboxUncheckedBackgroundColor: '#FFFFFF',
+  checkboxCheckedBackgroundColor: '#087AD1',
+  checkboxCheckedBorderColor: '#087AD1',
+  // 切换按钮配置
+  toggleButtonWidth: 28,
+  toggleButtonHeight: 18,
+  toggleButtonOnBackgroundColor: '#087AD1',
+  // 侧边栏配置
+  sideBarPanelWidth: 250,
+  spacing: 6
+});
+
+/**
+ * 根据当前 Ant Design ConfigProvider 主题生成 AgGrid 主题色。
+ * 网格、筛选弹层、输入框和强调状态均直接跟随 antd 主题。@author nokecy
+ */
+function useAgGridTheme(options) {
+  var _antdTheme$useToken = _antd.theme.useToken(),
+    token = _antdTheme$useToken.token;
+  var density = options === null || options === void 0 ? void 0 : options.density;
+  var themeParams = options === null || options === void 0 ? void 0 : options.themeParams;
+  return (0, _react.useMemo)(function () {
+    var _rowColors$hover, _rowColors$selected;
+    // 规范底色：主色朝白混合，链接压其上 ≥ 4.5:1；主色不是 6 位 hex 时退回 antd 派生
+    var rowColors = (0, _rowColors.deriveRowColors)(token.colorPrimary, token.colorLink);
+    var themed = agGridTheme.withParams({
+      // 弹层可能挂到网格容器之外，必须由组件主题完整声明颜色。@author nokecy
+      backgroundColor: token.colorBgContainer,
+      foregroundColor: token.colorText,
+      cellTextColor: token.colorText,
+      headerTextColor: token.colorText,
+      subtleTextColor: token.colorTextSecondary,
+      headerBackgroundColor: token.colorFillAlter,
+      oddRowBackgroundColor: token.colorBgContainer,
+      borderColor: token.colorBorderSecondary,
+      menuBackgroundColor: token.colorBgElevated,
+      menuTextColor: token.colorText,
+      panelBackgroundColor: token.colorBgElevated,
+      inputBackgroundColor: token.colorBgContainer,
+      inputTextColor: token.colorText,
+      inputBorder: {
+        color: token.colorBorder
+      },
+      inputPlaceholderTextColor: token.colorTextPlaceholder,
+      dragAndDropImageBackgroundColor: token.colorBgElevated,
+      invalidColor: token.colorError,
+      browserColorScheme: 'inherit',
+      accentColor: token.colorPrimary,
+      rowHoverColor: (_rowColors$hover = rowColors === null || rowColors === void 0 ? void 0 : rowColors.hover) !== null && _rowColors$hover !== void 0 ? _rowColors$hover : token.colorPrimaryBg,
+      selectedRowBackgroundColor: (_rowColors$selected = rowColors === null || rowColors === void 0 ? void 0 : rowColors.selected) !== null && _rowColors$selected !== void 0 ? _rowColors$selected : token.colorPrimaryBgHover,
+      columnHoverColor: token.colorPrimaryBg,
+      rangeSelectionBorderColor: token.colorPrimary,
+      rangeSelectionBackgroundColor: token.colorPrimaryBgHover,
+      focusShadow: "0 0 0 3px ".concat(token.colorPrimaryBg),
+      checkboxUncheckedBackgroundColor: token.colorBgContainer,
+      checkboxUncheckedBorderColor: token.colorBorder,
+      checkboxCheckedBackgroundColor: token.colorPrimary,
+      checkboxCheckedBorderColor: token.colorPrimary,
+      checkboxCheckedShapeColor: token.colorWhite,
+      checkboxIndeterminateBackgroundColor: token.colorPrimary,
+      checkboxIndeterminateBorderColor: token.colorPrimary,
+      checkboxIndeterminateShapeColor: token.colorWhite,
+      toggleButtonOnBackgroundColor: token.colorPrimary
+    });
+    var withDensity = density ? themed.withParams({
+      fontSize: density.fontSize,
+      headerFontSize: density.fontSize,
+      rowHeight: density.rowHeight,
+      headerHeight: density.headerHeight,
+      cellHorizontalPadding: density.paddingInline
+    }) : themed;
+    return themeParams ? withDensity.withParams(themeParams) : withDensity;
+  }, [token, density, themeParams]);
+}

package/dist/cjs/ag-grid-plus/toolBar/OverflowActions.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+export interface OverflowActionsProps {
+    items: React.ReactNode[];
+    prefixCls: string;
+    hashId?: string;
+    /** 外显个数上限，超出进「更多」；不传则只按宽度收纳。 */
+    maxVisible?: number;
+    /** 「更多」按钮文案 */
+    moreText?: string;
+}
+/**
+ * 工具栏操作区：放不下的按钮收进「更多」。
+ * 收起的按钮仍留在原位量宽（不可见、不可聚焦），展开面板里渲染同一批按钮。@author nokecy
+ */
+declare const OverflowActions: React.FC<OverflowActionsProps>;
+export default OverflowActions;

package/dist/cjs/ag-grid-plus/toolBar/OverflowActions.js

@@ -0,0 +1,128 @@
+"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.default = void 0;
+var _icons = require("@ant-design/icons");
+var _antd = require("antd");
+var _react = _interopRequireWildcard(require("react"));
+var _overflow = require("./overflow");
+var _jsxRuntime = require("react/jsx-runtime");
+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 _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; }
+/**
+ * 工具栏操作区：放不下的按钮收进「更多」。
+ * 收起的按钮仍留在原位量宽（不可见、不可聚焦），展开面板里渲染同一批按钮。@author nokecy
+ */
+var OverflowActions = function OverflowActions(_ref) {
+  var items = _ref.items,
+    prefixCls = _ref.prefixCls,
+    hashId = _ref.hashId,
+    maxVisible = _ref.maxVisible,
+    _ref$moreText = _ref.moreText,
+    moreText = _ref$moreText === void 0 ? '更多' : _ref$moreText;
+  var containerRef = (0, _react.useRef)(null);
+  var moreRef = (0, _react.useRef)(null);
+  var itemRefs = (0, _react.useRef)([]);
+  var moreWidthRef = (0, _react.useRef)(_overflow.OVERFLOW_MORE_FALLBACK_WIDTH);
+  var _useState = (0, _react.useState)(items.length),
+    _useState2 = _slicedToArray(_useState, 2),
+    visibleCount = _useState2[0],
+    setVisibleCount = _useState2[1];
+  var measure = (0, _react.useCallback)(function () {
+    var _moreRef$current;
+    var container = containerRef.current;
+    if (!container) return;
+    if ((_moreRef$current = moreRef.current) !== null && _moreRef$current !== void 0 && _moreRef$current.offsetWidth) moreWidthRef.current = moreRef.current.offsetWidth;
+    var widths = items.map(function (_, index) {
+      var _itemRefs$current$ind, _itemRefs$current$ind2;
+      return (_itemRefs$current$ind = (_itemRefs$current$ind2 = itemRefs.current[index]) === null || _itemRefs$current$ind2 === void 0 ? void 0 : _itemRefs$current$ind2.offsetWidth) !== null && _itemRefs$current$ind !== void 0 ? _itemRefs$current$ind : 0;
+    });
+    var next = (0, _overflow.computeVisibleCount)(widths, container.clientWidth, {
+      gap: _overflow.OVERFLOW_GAP,
+      moreWidth: moreWidthRef.current,
+      maxVisible: maxVisible
+    });
+    setVisibleCount(function (prev) {
+      return prev === next ? prev : next;
+    });
+  }, [items, maxVisible]);
+
+  // 每次渲染都量：操作区内容由页面每轮重新给出，宽度可能随之变化；只在个数变了才更新状态
+  (0, _react.useLayoutEffect)(function () {
+    measure();
+  });
+  (0, _react.useLayoutEffect)(function () {
+    var container = containerRef.current;
+    if (!container || typeof ResizeObserver === 'undefined') return;
+    var observer = new ResizeObserver(function () {
+      return measure();
+    });
+    observer.observe(container);
+    return function () {
+      return observer.disconnect();
+    };
+  }, [measure]);
+  var count = Math.min(visibleCount, items.length);
+  var hidden = items.slice(count);
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+    ref: containerRef,
+    className: "".concat(prefixCls, "-actions ").concat(hashId !== null && hashId !== void 0 ? hashId : ''),
+    style: {
+      gap: _overflow.OVERFLOW_GAP
+    },
+    children: [items.map(function (item, index) {
+      var collapsed = index >= count;
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+        ref: function ref(node) {
+          itemRefs.current[index] = node;
+        },
+        className: "".concat(prefixCls, "-action-item"),
+        "data-overflow-hidden": collapsed || undefined,
+        "aria-hidden": collapsed || undefined,
+        style: collapsed ? {
+          position: 'absolute',
+          insetInlineStart: 0,
+          visibility: 'hidden',
+          pointerEvents: 'none'
+        } : undefined,
+        children: item
+      }, index);
+    }), hidden.length > 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      ref: moreRef,
+      className: "".concat(prefixCls, "-action-more"),
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Dropdown, {
+        trigger: ['click'],
+        placement: "bottomLeft",
+        popupRender: function popupRender() {
+          return /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+            className: "".concat(prefixCls, "-more-panel ").concat(hashId !== null && hashId !== void 0 ? hashId : ''),
+            children: hidden.map(function (item, index) {
+              return (
+                /*#__PURE__*/
+                // eslint-disable-next-line react/no-array-index-key
+                (0, _jsxRuntime.jsx)("div", {
+                  className: "".concat(prefixCls, "-more-item"),
+                  children: item
+                }, index)
+              );
+            })
+          });
+        },
+        children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_antd.Button, {
+          "aria-haspopup": "menu",
+          children: [moreText, /*#__PURE__*/(0, _jsxRuntime.jsx)(_icons.DownOutlined, {})]
+        })
+      })
+    }) : null]
+  });
+};
+var _default = exports.default = OverflowActions;

package/dist/cjs/ag-grid-plus/toolBar/index.d.ts

@@ -0,0 +1,22 @@
+import type { FormItemProps } from 'antd';
+import React from 'react';
+type SettingPropType = React.ReactNode;
+export type ListToolBarProps = {
+    prefixCls?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    /** 标题 */
+    title?: React.ReactNode;
+    /** 副标题 */
+    subTitle?: React.ReactNode;
+    /** 标题提示 */
+    tooltip?: FormItemProps['tooltip'];
+    /** 工具栏右侧操作区 */
+    actions?: React.ReactNode[];
+    /** 工作栏右侧设置区 */
+    settings?: SettingPropType[];
+    /** 操作区外显个数上限，超出进「更多」；不传则只按宽度收纳。 */
+    maxVisibleActions?: number;
+};
+declare const ListToolBar: ({ prefixCls: customizePrefixCls, title, subTitle, tooltip, className, style, actions, settings, maxVisibleActions, }: ListToolBarProps) => React.JSX.Element;
+export default ListToolBar;