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

package/dist/esm/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[];
+    /** AG-Grid 过滤器模型数据（可选） */
+    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/esm/ag-grid-plus/shared/storage/schemeStorageAdapter.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/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/esm/ag-grid-plus/shared/utils/schemeDataMigration.js

@@ -0,0 +1,54 @@
+/**
+ * 从查询方案提取字段顺序数组
+ * @param scheme 查询方案对象
+ * @returns 字段顺序数组
+ */
+export function extractItemsOrder(scheme) {
+  return scheme.queryConfig.items.map(function (item) {
+    return item.field;
+  });
+}
+
+/**
+ * 从查询方案提取隐藏字段数组
+ * @param scheme 查询方案对象
+ * @returns 隐藏字段数组
+ */
+export function extractHiddenFields(scheme) {
+  return scheme.queryConfig.items.filter(function (item) {
+    return item.hidden;
+  }).map(function (item) {
+    return item.field;
+  });
+}
+
+/**
+ * 从查询方案提取表单默认值
+ * @param scheme 查询方案对象
+ * @returns 表单默认值对象
+ */
+export function extractFormValues(scheme) {
+  return scheme.queryConfig.defaultValues || {};
+}
+
+/**
+ * 构建 QueryConfig 对象
+ * @param itemsOrder 字段顺序数组
+ * @param hiddenFields 隐藏字段数组
+ * @param formValues 表单默认值
+ * @returns QueryConfig 对象
+ */
+export 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/esm/ag-grid-plus/theme.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AG-Grid v33 主题配置
+ * 使用 themeQuartz API 替代 CSS 变量方式
+ */
+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(): 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/esm/ag-grid-plus/theme.js

@@ -0,0 +1,130 @@
+/**
+ * AG-Grid v33 主题配置
+ * 使用 themeQuartz API 替代 CSS 变量方式
+ */
+
+import { createPart, themeQuartz } from 'ag-grid-community';
+import { theme as antdTheme } from 'antd';
+import { useMemo } from 'react';
+
+/** 右对齐只影响标题和数值，筛选入口在所有列中统一位于右侧。@author nokecy */
+var headerFilterPlacement = 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  "
+});
+export var agGridTheme = themeQuartz.withPart(headerFilterPlacement).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
+ */
+export function useAgGridTheme() {
+  var _antdTheme$useToken = antdTheme.useToken(),
+    token = _antdTheme$useToken.token;
+  return useMemo(function () {
+    return 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: token.colorPrimaryBg,
+      selectedRowBackgroundColor: 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
+    });
+  }, [token]);
+}

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

@@ -0,0 +1,20 @@
+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[];
+};
+declare const ListToolBar: ({ prefixCls: customizePrefixCls, title, subTitle, tooltip, className, style, actions, settings }: ListToolBarProps) => React.JSX.Element;
+export default ListToolBar;

package/dist/esm/ag-grid-plus/toolBar/index.js

@@ -0,0 +1,169 @@
+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 ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+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; }
+import { ConfigProvider, Tooltip } from 'antd';
+import classNames from 'classnames';
+import React, { useContext, useMemo, useState } from 'react';
+import { LabelIconTip } from "../../shared/labelIconTip";
+import { useStyle } from "./style";
+import { ListToolbarLeftContext } from "./leftContent";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * 获取配置区域 DOM Item
+ *
+ * @param setting 配置项
+ */
+function getSettingItem(setting) {
+  if ( /*#__PURE__*/React.isValidElement(setting)) {
+    return setting;
+  }
+  if (setting) {
+    var settingConfig = setting;
+    var icon = settingConfig.icon,
+      tooltip = settingConfig.tooltip,
+      _onClick = settingConfig.onClick,
+      key = settingConfig.key;
+    if (icon && tooltip) {
+      return /*#__PURE__*/_jsx(Tooltip, {
+        title: tooltip,
+        children: /*#__PURE__*/_jsx("span", {
+          onClick: function onClick() {
+            if (_onClick) {
+              _onClick(key);
+            }
+          },
+          children: icon
+        }, key)
+      });
+    }
+    return icon;
+  }
+  return null;
+}
+var ListToolBar = function ListToolBar(_ref) {
+  var customizePrefixCls = _ref.prefixCls,
+    title = _ref.title,
+    subTitle = _ref.subTitle,
+    tooltip = _ref.tooltip,
+    className = _ref.className,
+    style = _ref.style,
+    _ref$actions = _ref.actions,
+    actions = _ref$actions === void 0 ? [] : _ref$actions,
+    _ref$settings = _ref.settings,
+    settings = _ref$settings === void 0 ? [] : _ref$settings;
+  var _useContext = useContext(ConfigProvider.ConfigContext),
+    getPrefixCls = _useContext.getPrefixCls;
+  var prefixCls = getPrefixCls('pro-table-list-toolbar', customizePrefixCls);
+  var _useStyle = useStyle(prefixCls),
+    wrapSSR = _useStyle.wrapSSR,
+    hashId = _useStyle.hashId;
+  var _useState = useState(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    leftContainer = _useState2[0],
+    setLeftContainer = _useState2[1];
+
+  /** 有没有 title，需要结合多个场景判断 */
+  var hasTitle = useMemo(function () {
+    return title || subTitle || tooltip;
+  }, [subTitle, title, tooltip]);
+
+  /** 没有 key 的时候帮忙加一下 key 不加的话很烦人 */
+  var actionDom = useMemo(function () {
+    if (!Array.isArray(actions)) {
+      return actions;
+    }
+    if (actions.length < 1) {
+      return null;
+    }
+    return /*#__PURE__*/_jsx("div", {
+      className: "".concat(prefixCls, "-actions ").concat(hashId),
+      children: actions.map(function (action, index) {
+        if (! /*#__PURE__*/React.isValidElement(action)) {
+          // eslint-disable-next-line react/no-array-index-key
+          return /*#__PURE__*/_jsx(React.Fragment, {
+            children: action
+          }, index);
+        }
+        return /*#__PURE__*/React.cloneElement(action, _objectSpread({
+          // eslint-disable-next-line react/no-array-index-key
+          key: index
+        }, action === null || action === void 0 ? void 0 : action.props));
+      })
+    });
+  }, [actions, hashId, prefixCls]);
+  var hasRight = useMemo(function () {
+    return hasTitle || actionDom || (settings === null || settings === void 0 ? void 0 : settings.length);
+  }, [actionDom, hasTitle, settings === null || settings === void 0 ? void 0 : settings.length]);
+  var hasLeft = useMemo(function () {
+    return tooltip || title || subTitle;
+  }, [hasTitle, subTitle, title, tooltip]);
+  var leftTitleDom = useMemo(function () {
+    // 保留左侧占位，并为操作组件提供当前列表独立的辅助内容位。@author nokecy
+    return /*#__PURE__*/_jsxs("div", {
+      className: "".concat(prefixCls, "-left ").concat(hashId),
+      children: [hasTitle && /*#__PURE__*/_jsx("div", {
+        className: "".concat(prefixCls, "-title ").concat(hashId),
+        children: /*#__PURE__*/_jsx(LabelIconTip, {
+          tooltip: tooltip,
+          label: title,
+          subTitle: subTitle
+        })
+      }), /*#__PURE__*/_jsx("div", {
+        ref: setLeftContainer,
+        style: {
+          display: 'contents'
+        }
+      })]
+    });
+  }, [hasLeft, hasRight, hasTitle, hashId, prefixCls, subTitle, title, tooltip]);
+  var rightTitleDom = useMemo(function () {
+    if (!hasRight) return null;
+    return /*#__PURE__*/_jsxs("div", {
+      className: "".concat(prefixCls, "-right ").concat(hashId),
+      style: {
+        alignItems: 'center'
+      },
+      children: [actionDom, settings !== null && settings !== void 0 && settings.length ? /*#__PURE__*/_jsx("div", {
+        className: "".concat(prefixCls, "-setting-items ").concat(hashId),
+        children: settings.map(function (setting, index) {
+          var settingItem = getSettingItem(setting);
+          return (
+            /*#__PURE__*/
+            // eslint-disable-next-line react/no-array-index-key
+            _jsx("div", {
+              className: "".concat(prefixCls, "-setting-item ").concat(hashId),
+              children: settingItem
+            }, index)
+          );
+        })
+      }) : null]
+    });
+  }, [hasRight, prefixCls, hashId, hasTitle, actionDom, settings]);
+  var titleNode = useMemo(function () {
+    if (!hasRight && !hasLeft) return null;
+    var containerClassName = classNames("".concat(prefixCls, "-container"), hashId, {});
+    return /*#__PURE__*/_jsxs("div", {
+      className: containerClassName,
+      children: [leftTitleDom, rightTitleDom]
+    });
+  }, [hasLeft, hasRight, hashId, leftTitleDom, prefixCls, rightTitleDom]);
+  return /*#__PURE__*/_jsx(ListToolbarLeftContext.Provider, {
+    value: leftContainer,
+    children: /*#__PURE__*/_jsx("div", {
+      style: style,
+      className: classNames(prefixCls, hashId, className),
+      children: titleNode
+    })
+  });
+};
+export default ListToolBar;

package/dist/esm/ag-grid-plus/toolBar/leftContent.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+/** 当前列表工具栏的左侧内容容器；undefined 表示位于列表工具栏之外。@author nokecy */
+export declare const ListToolbarLeftContext: React.Context<HTMLElement | null | undefined>;
+/** 将选择摘要等辅助内容放到当前列表标题旁；独立使用时保留原位置。@author nokecy */
+export declare const ListToolbarLeft: React.FC<React.PropsWithChildren>;

package/dist/esm/ag-grid-plus/toolBar/leftContent.js

@@ -0,0 +1,17 @@
+import React, { createContext, useContext } from 'react';
+import { createPortal } from 'react-dom';
+
+/** 当前列表工具栏的左侧内容容器；undefined 表示位于列表工具栏之外。@author nokecy */
+import { Fragment as _Fragment } from "react/jsx-runtime";
+import { jsx as _jsx } from "react/jsx-runtime";
+export var ListToolbarLeftContext = /*#__PURE__*/createContext(undefined);
+
+/** 将选择摘要等辅助内容放到当前列表标题旁；独立使用时保留原位置。@author nokecy */
+export var ListToolbarLeft = function ListToolbarLeft(_ref) {
+  var children = _ref.children;
+  var container = useContext(ListToolbarLeftContext);
+  if (container === undefined) return /*#__PURE__*/_jsx(_Fragment, {
+    children: children
+  });
+  return container ? /*#__PURE__*/createPortal(children, container) : null;
+};

package/dist/esm/ag-grid-plus/toolBar/style.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+import type { ProAliasToken } from "../../shared/proStyle";
+export interface ProListToken extends ProAliasToken {
+    componentCls: string;
+}
+export declare function useStyle(prefixCls: string): {
+    wrapSSR: (node: import("react").ReactNode) => import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+    hashId: string;
+};