@procore/data-table 14.38.0 → 14.39.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change Log
 
+## 14.39.0
+
+### Minor Changes
+
+- 3052b62: Adds onExpandOrCollapseAll prop for tracking expand/collapse state
+
 ## 14.38.0
 
 ### Minor Changes

package/dist/legacy/index.cjs

@@ -56596,9 +56596,10 @@ var GenericHeaderRenderer = (props) => {
   const {
     columnApi,
     tableRef,
+    onExpandOrCollapseAll,
     onServerSideDataRequest,
-    showExpandCollapseAllToggle,
-    onTableConfigChange
+    onTableConfigChange,
+    showExpandCollapseAllToggle
   } = useInternalTableContext();
   const onSSDR = Boolean(onServerSideDataRequest);
   const [sortOrder, setSortOrder] = React80__default.default.useState(props.column.getSort());
@@ -56789,9 +56790,11 @@ var GenericHeaderRenderer = (props) => {
           }
         });
         setExpansionVariant("tierOne");
+        onExpandOrCollapseAll == null ? void 0 : onExpandOrCollapseAll(true);
       } else {
         props.api.collapseAll();
         setExpansionVariant("closed");
+        onExpandOrCollapseAll == null ? void 0 : onExpandOrCollapseAll(false);
       }
       return;
     }
@@ -56806,10 +56809,13 @@ var GenericHeaderRenderer = (props) => {
         props.api
       );
       setExpansionVariant(hasMoreExpandableNodes ? "tierOne" : "all");
+      onExpandOrCollapseAll == null ? void 0 : onExpandOrCollapseAll(true);
     } else if (expansionVariant === "tierOne") {
       props.api.expandAll();
+      onExpandOrCollapseAll == null ? void 0 : onExpandOrCollapseAll(true);
     } else {
       props.api.collapseAll();
+      onExpandOrCollapseAll == null ? void 0 : onExpandOrCollapseAll(false);
     }
   }
   const tooltipText = {
@@ -56986,7 +56992,8 @@ var GenericHeaderRenderer = (props) => {
             "aria-label": tooltipText[expansionVariant],
             className: "expand-button",
             onClick: onExpandToggle,
-            role: "button"
+            role: "button",
+            "data-qa": "expand-or-collapse-all-button"
           },
           /* @__PURE__ */ React80__default.default.createElement(ExpansionVariantIcon, { size: "sm" })
         )
@@ -57846,6 +57853,8 @@ var InternalTableContext = React80__default.default.createContext({
   gridApi: void 0,
   localStoragePersistenceKey: void 0,
   onBulkEditUpdate: () => Promise.resolve(),
+  onExpandOrCollapseAll: () => {
+  },
   onServerSideDataRequest: void 0,
   onTableConfigChange: () => {
   },
@@ -108988,6 +108997,7 @@ var DataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onServerSideDataRequest,
   onTableConfigChange,
   showExpandCollapseAllToggle,
@@ -109238,6 +109248,7 @@ var DataTable = ({
         gridApi,
         initialTableConfig,
         onBulkEditUpdate,
+        onExpandOrCollapseAll,
         onServerSideDataRequest,
         onTableConfigChange: internalOnTableConfigChange,
         rowSelectionRef,
@@ -112316,6 +112327,7 @@ var ClientSideDataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onTableConfigChange,
   translations: translations2 = {},
   enableCellTextSelection,
@@ -112332,8 +112344,9 @@ var ClientSideDataTable = ({
       filterGroups,
       getRowId,
       initialTableConfig: _initialTableConfig,
-      onTableConfigChange,
       onBulkEditUpdate,
+      onExpandOrCollapseAll,
+      onTableConfigChange,
       showExpandCollapseAllToggle: true,
       translations: translations2,
       localStoragePersistenceKey,
@@ -116725,6 +116738,7 @@ var ServerSideDataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onServerSideDataRequest,
   onTableConfigChange,
   enableCellTextSelection,
@@ -116743,9 +116757,10 @@ var ServerSideDataTable = ({
       filterGroups,
       getRowId,
       initialTableConfig: _initialTableConfig,
-      onTableConfigChange,
-      onServerSideDataRequest,
       onBulkEditUpdate,
+      onExpandOrCollapseAll,
+      onServerSideDataRequest,
+      onTableConfigChange,
       showExpandCollapseAllToggle,
       translations: translations2,
       customBulkEditorFields,

package/dist/legacy/index.d.cts

@@ -1145,8 +1145,16 @@ interface DataTableProps {
     filterGroups?: FilterGroup[];
     getRowId?: (params: GetRowIdParams) => string;
     initialTableConfig?: DataTableConfig;
-    onTableConfigChange?: (config: DataTableConfig) => void;
+    /**
+     * Callback invoked when the row group expand/collapse state changes via
+     * the Expand/Collapse toggle button. Use this to track the table's
+     * expand/collapse state.
+     * @param expanded - `true` when groups are expanded at any level, `false`
+     * when all groups are collapsed.
+     */
+    onExpandOrCollapseAll?: (expanded: boolean) => void;
     onServerSideDataRequest?: (params: ServerSideGetRowsParams) => Promise<SuccessParams | void> | void;
+    onTableConfigChange?: (config: DataTableConfig) => void;
     grandTotalsLabelRenderer?: React.FunctionComponent<GrandTotalsLabelRendererProps>;
     /**
      * Callback after bulk edit action is performed.
@@ -1374,6 +1382,7 @@ interface InternalTableContext {
     onServerSideDataRequest?: DataTableProps['onServerSideDataRequest'];
     updateServerSideDataSource: (params: UpdateServerSideDataSourceParams) => void;
     localStoragePersistenceKey?: string;
+    onExpandOrCollapseAll?: (expanded: boolean) => void;
     onTableConfigChange: () => void;
     rowHeight: RowSize;
     rowSelectionRef?: React__default.MutableRefObject<RowSelectionRef>;
@@ -1454,7 +1463,7 @@ interface BulkActionProps {
     style?: React__default.CSSProperties;
 }
 
-declare const _default$1: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onTableConfigChange, translations, enableCellTextSelection, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<ClientSideDataTableProps>) => React__default.JSX.Element) & {
+declare const _default$1: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onExpandOrCollapseAll, onTableConfigChange, translations, enableCellTextSelection, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<ClientSideDataTableProps>) => React__default.JSX.Element) & {
     BulkActions: React__default.FunctionComponent<React__default.PropsWithChildren<BulkActionProps>>;
     BulkEditActionButton: React__default.FunctionComponent<ActionButtonProps>;
     ConfigPanelButton: React__default.FC<{}>;
@@ -1491,7 +1500,7 @@ declare const MultiSelectQuickFilterRenderer: (props: FilterProps<any[]>) => Rea
 
 declare const SingleSelectQuickFilterRenderer: (props: FilterProps<any[]>) => React__default.JSX.Element;
 
-declare const _default: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onServerSideDataRequest, onTableConfigChange, enableCellTextSelection, showExpandCollapseAllToggle, translations, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<DataTableProps>) => React__default.JSX.Element) & {
+declare const _default: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onExpandOrCollapseAll, onServerSideDataRequest, onTableConfigChange, enableCellTextSelection, showExpandCollapseAllToggle, translations, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<DataTableProps>) => React__default.JSX.Element) & {
     BulkActions: React__default.FunctionComponent<React__default.PropsWithChildren<BulkActionProps>>;
     BulkEditActionButton: React__default.FunctionComponent<ActionButtonProps>;
     ConfigPanelButton: React__default.FC<{}>;

package/dist/legacy/index.d.ts

@@ -1145,8 +1145,16 @@ interface DataTableProps {
     filterGroups?: FilterGroup[];
     getRowId?: (params: GetRowIdParams) => string;
     initialTableConfig?: DataTableConfig;
-    onTableConfigChange?: (config: DataTableConfig) => void;
+    /**
+     * Callback invoked when the row group expand/collapse state changes via
+     * the Expand/Collapse toggle button. Use this to track the table's
+     * expand/collapse state.
+     * @param expanded - `true` when groups are expanded at any level, `false`
+     * when all groups are collapsed.
+     */
+    onExpandOrCollapseAll?: (expanded: boolean) => void;
     onServerSideDataRequest?: (params: ServerSideGetRowsParams) => Promise<SuccessParams | void> | void;
+    onTableConfigChange?: (config: DataTableConfig) => void;
     grandTotalsLabelRenderer?: React.FunctionComponent<GrandTotalsLabelRendererProps>;
     /**
      * Callback after bulk edit action is performed.
@@ -1374,6 +1382,7 @@ interface InternalTableContext {
     onServerSideDataRequest?: DataTableProps['onServerSideDataRequest'];
     updateServerSideDataSource: (params: UpdateServerSideDataSourceParams) => void;
     localStoragePersistenceKey?: string;
+    onExpandOrCollapseAll?: (expanded: boolean) => void;
     onTableConfigChange: () => void;
     rowHeight: RowSize;
     rowSelectionRef?: React__default.MutableRefObject<RowSelectionRef>;
@@ -1454,7 +1463,7 @@ interface BulkActionProps {
     style?: React__default.CSSProperties;
 }
 
-declare const _default$1: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onTableConfigChange, translations, enableCellTextSelection, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<ClientSideDataTableProps>) => React__default.JSX.Element) & {
+declare const _default$1: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onExpandOrCollapseAll, onTableConfigChange, translations, enableCellTextSelection, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<ClientSideDataTableProps>) => React__default.JSX.Element) & {
     BulkActions: React__default.FunctionComponent<React__default.PropsWithChildren<BulkActionProps>>;
     BulkEditActionButton: React__default.FunctionComponent<ActionButtonProps>;
     ConfigPanelButton: React__default.FC<{}>;
@@ -1491,7 +1500,7 @@ declare const MultiSelectQuickFilterRenderer: (props: FilterProps<any[]>) => Rea
 
 declare const SingleSelectQuickFilterRenderer: (props: FilterProps<any[]>) => React__default.JSX.Element;
 
-declare const _default: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onServerSideDataRequest, onTableConfigChange, enableCellTextSelection, showExpandCollapseAllToggle, translations, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<DataTableProps>) => React__default.JSX.Element) & {
+declare const _default: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onExpandOrCollapseAll, onServerSideDataRequest, onTableConfigChange, enableCellTextSelection, showExpandCollapseAllToggle, translations, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<DataTableProps>) => React__default.JSX.Element) & {
     BulkActions: React__default.FunctionComponent<React__default.PropsWithChildren<BulkActionProps>>;
     BulkEditActionButton: React__default.FunctionComponent<ActionButtonProps>;
     ConfigPanelButton: React__default.FC<{}>;

package/dist/legacy/index.js

@@ -56583,9 +56583,10 @@ var GenericHeaderRenderer = (props) => {
   const {
     columnApi,
     tableRef,
+    onExpandOrCollapseAll,
     onServerSideDataRequest,
-    showExpandCollapseAllToggle,
-    onTableConfigChange
+    onTableConfigChange,
+    showExpandCollapseAllToggle
   } = useInternalTableContext();
   const onSSDR = Boolean(onServerSideDataRequest);
   const [sortOrder, setSortOrder] = React80.useState(props.column.getSort());
@@ -56776,9 +56777,11 @@ var GenericHeaderRenderer = (props) => {
           }
         });
         setExpansionVariant("tierOne");
+        onExpandOrCollapseAll == null ? void 0 : onExpandOrCollapseAll(true);
       } else {
         props.api.collapseAll();
         setExpansionVariant("closed");
+        onExpandOrCollapseAll == null ? void 0 : onExpandOrCollapseAll(false);
       }
       return;
     }
@@ -56793,10 +56796,13 @@ var GenericHeaderRenderer = (props) => {
         props.api
       );
       setExpansionVariant(hasMoreExpandableNodes ? "tierOne" : "all");
+      onExpandOrCollapseAll == null ? void 0 : onExpandOrCollapseAll(true);
     } else if (expansionVariant === "tierOne") {
       props.api.expandAll();
+      onExpandOrCollapseAll == null ? void 0 : onExpandOrCollapseAll(true);
     } else {
       props.api.collapseAll();
+      onExpandOrCollapseAll == null ? void 0 : onExpandOrCollapseAll(false);
     }
   }
   const tooltipText = {
@@ -56973,7 +56979,8 @@ var GenericHeaderRenderer = (props) => {
             "aria-label": tooltipText[expansionVariant],
             className: "expand-button",
             onClick: onExpandToggle,
-            role: "button"
+            role: "button",
+            "data-qa": "expand-or-collapse-all-button"
           },
           /* @__PURE__ */ React80.createElement(ExpansionVariantIcon, { size: "sm" })
         )
@@ -57833,6 +57840,8 @@ var InternalTableContext = React80.createContext({
   gridApi: void 0,
   localStoragePersistenceKey: void 0,
   onBulkEditUpdate: () => Promise.resolve(),
+  onExpandOrCollapseAll: () => {
+  },
   onServerSideDataRequest: void 0,
   onTableConfigChange: () => {
   },
@@ -108975,6 +108984,7 @@ var DataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onServerSideDataRequest,
   onTableConfigChange,
   showExpandCollapseAllToggle,
@@ -109225,6 +109235,7 @@ var DataTable = ({
         gridApi,
         initialTableConfig,
         onBulkEditUpdate,
+        onExpandOrCollapseAll,
         onServerSideDataRequest,
         onTableConfigChange: internalOnTableConfigChange,
         rowSelectionRef,
@@ -112303,6 +112314,7 @@ var ClientSideDataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onTableConfigChange,
   translations: translations2 = {},
   enableCellTextSelection,
@@ -112319,8 +112331,9 @@ var ClientSideDataTable = ({
       filterGroups,
       getRowId,
       initialTableConfig: _initialTableConfig,
-      onTableConfigChange,
       onBulkEditUpdate,
+      onExpandOrCollapseAll,
+      onTableConfigChange,
       showExpandCollapseAllToggle: true,
       translations: translations2,
       localStoragePersistenceKey,
@@ -116712,6 +116725,7 @@ var ServerSideDataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onServerSideDataRequest,
   onTableConfigChange,
   enableCellTextSelection,
@@ -116730,9 +116744,10 @@ var ServerSideDataTable = ({
       filterGroups,
       getRowId,
       initialTableConfig: _initialTableConfig,
-      onTableConfigChange,
-      onServerSideDataRequest,
       onBulkEditUpdate,
+      onExpandOrCollapseAll,
+      onServerSideDataRequest,
+      onTableConfigChange,
       showExpandCollapseAllToggle,
       translations: translations2,
       customBulkEditorFields,

package/dist/modern/index.cjs

@@ -56517,9 +56517,10 @@ var GenericHeaderRenderer = (props) => {
   const {
     columnApi,
     tableRef,
+    onExpandOrCollapseAll,
     onServerSideDataRequest,
-    showExpandCollapseAllToggle,
-    onTableConfigChange
+    onTableConfigChange,
+    showExpandCollapseAllToggle
   } = useInternalTableContext();
   const onSSDR = Boolean(onServerSideDataRequest);
   const [sortOrder, setSortOrder] = React80__default.default.useState(props.column.getSort());
@@ -56708,9 +56709,11 @@ var GenericHeaderRenderer = (props) => {
           }
         });
         setExpansionVariant("tierOne");
+        onExpandOrCollapseAll?.(true);
       } else {
         props.api.collapseAll();
         setExpansionVariant("closed");
+        onExpandOrCollapseAll?.(false);
       }
       return;
     }
@@ -56725,10 +56728,13 @@ var GenericHeaderRenderer = (props) => {
         props.api
       );
       setExpansionVariant(hasMoreExpandableNodes ? "tierOne" : "all");
+      onExpandOrCollapseAll?.(true);
     } else if (expansionVariant === "tierOne") {
       props.api.expandAll();
+      onExpandOrCollapseAll?.(true);
     } else {
       props.api.collapseAll();
+      onExpandOrCollapseAll?.(false);
     }
   }
   const tooltipText = {
@@ -56900,7 +56906,8 @@ var GenericHeaderRenderer = (props) => {
             "aria-label": tooltipText[expansionVariant],
             className: "expand-button",
             onClick: onExpandToggle,
-            role: "button"
+            role: "button",
+            "data-qa": "expand-or-collapse-all-button"
           },
           /* @__PURE__ */ React80__default.default.createElement(ExpansionVariantIcon, { size: "sm" })
         )
@@ -57744,6 +57751,8 @@ var InternalTableContext = React80__default.default.createContext({
   gridApi: void 0,
   localStoragePersistenceKey: void 0,
   onBulkEditUpdate: () => Promise.resolve(),
+  onExpandOrCollapseAll: () => {
+  },
   onServerSideDataRequest: void 0,
   onTableConfigChange: () => {
   },
@@ -108837,6 +108846,7 @@ var DataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onServerSideDataRequest,
   onTableConfigChange,
   showExpandCollapseAllToggle,
@@ -109083,6 +109093,7 @@ var DataTable = ({
         gridApi,
         initialTableConfig,
         onBulkEditUpdate,
+        onExpandOrCollapseAll,
         onServerSideDataRequest,
         onTableConfigChange: internalOnTableConfigChange,
         rowSelectionRef,
@@ -112086,6 +112097,7 @@ var ClientSideDataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onTableConfigChange,
   translations: translations2 = {},
   enableCellTextSelection,
@@ -112102,8 +112114,9 @@ var ClientSideDataTable = ({
       filterGroups,
       getRowId,
       initialTableConfig: _initialTableConfig,
-      onTableConfigChange,
       onBulkEditUpdate,
+      onExpandOrCollapseAll,
+      onTableConfigChange,
       showExpandCollapseAllToggle: true,
       translations: translations2,
       localStoragePersistenceKey,
@@ -116494,6 +116507,7 @@ var ServerSideDataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onServerSideDataRequest,
   onTableConfigChange,
   enableCellTextSelection,
@@ -116512,9 +116526,10 @@ var ServerSideDataTable = ({
       filterGroups,
       getRowId,
       initialTableConfig: _initialTableConfig,
-      onTableConfigChange,
-      onServerSideDataRequest,
       onBulkEditUpdate,
+      onExpandOrCollapseAll,
+      onServerSideDataRequest,
+      onTableConfigChange,
       showExpandCollapseAllToggle,
       translations: translations2,
       customBulkEditorFields,

package/dist/modern/index.d.cts

@@ -1145,8 +1145,16 @@ interface DataTableProps {
     filterGroups?: FilterGroup[];
     getRowId?: (params: GetRowIdParams) => string;
     initialTableConfig?: DataTableConfig;
-    onTableConfigChange?: (config: DataTableConfig) => void;
+    /**
+     * Callback invoked when the row group expand/collapse state changes via
+     * the Expand/Collapse toggle button. Use this to track the table's
+     * expand/collapse state.
+     * @param expanded - `true` when groups are expanded at any level, `false`
+     * when all groups are collapsed.
+     */
+    onExpandOrCollapseAll?: (expanded: boolean) => void;
     onServerSideDataRequest?: (params: ServerSideGetRowsParams) => Promise<SuccessParams | void> | void;
+    onTableConfigChange?: (config: DataTableConfig) => void;
     grandTotalsLabelRenderer?: React.FunctionComponent<GrandTotalsLabelRendererProps>;
     /**
      * Callback after bulk edit action is performed.
@@ -1374,6 +1382,7 @@ interface InternalTableContext {
     onServerSideDataRequest?: DataTableProps['onServerSideDataRequest'];
     updateServerSideDataSource: (params: UpdateServerSideDataSourceParams) => void;
     localStoragePersistenceKey?: string;
+    onExpandOrCollapseAll?: (expanded: boolean) => void;
     onTableConfigChange: () => void;
     rowHeight: RowSize;
     rowSelectionRef?: React__default.MutableRefObject<RowSelectionRef>;
@@ -1454,7 +1463,7 @@ interface BulkActionProps {
     style?: React__default.CSSProperties;
 }
 
-declare const _default$1: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onTableConfigChange, translations, enableCellTextSelection, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<ClientSideDataTableProps>) => React__default.JSX.Element) & {
+declare const _default$1: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onExpandOrCollapseAll, onTableConfigChange, translations, enableCellTextSelection, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<ClientSideDataTableProps>) => React__default.JSX.Element) & {
     BulkActions: React__default.FunctionComponent<React__default.PropsWithChildren<BulkActionProps>>;
     BulkEditActionButton: React__default.FunctionComponent<ActionButtonProps>;
     ConfigPanelButton: React__default.FC<{}>;
@@ -1491,7 +1500,7 @@ declare const MultiSelectQuickFilterRenderer: (props: FilterProps<any[]>) => Rea
 
 declare const SingleSelectQuickFilterRenderer: (props: FilterProps<any[]>) => React__default.JSX.Element;
 
-declare const _default: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onServerSideDataRequest, onTableConfigChange, enableCellTextSelection, showExpandCollapseAllToggle, translations, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<DataTableProps>) => React__default.JSX.Element) & {
+declare const _default: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onExpandOrCollapseAll, onServerSideDataRequest, onTableConfigChange, enableCellTextSelection, showExpandCollapseAllToggle, translations, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<DataTableProps>) => React__default.JSX.Element) & {
     BulkActions: React__default.FunctionComponent<React__default.PropsWithChildren<BulkActionProps>>;
     BulkEditActionButton: React__default.FunctionComponent<ActionButtonProps>;
     ConfigPanelButton: React__default.FC<{}>;

package/dist/modern/index.d.ts

@@ -1145,8 +1145,16 @@ interface DataTableProps {
     filterGroups?: FilterGroup[];
     getRowId?: (params: GetRowIdParams) => string;
     initialTableConfig?: DataTableConfig;
-    onTableConfigChange?: (config: DataTableConfig) => void;
+    /**
+     * Callback invoked when the row group expand/collapse state changes via
+     * the Expand/Collapse toggle button. Use this to track the table's
+     * expand/collapse state.
+     * @param expanded - `true` when groups are expanded at any level, `false`
+     * when all groups are collapsed.
+     */
+    onExpandOrCollapseAll?: (expanded: boolean) => void;
     onServerSideDataRequest?: (params: ServerSideGetRowsParams) => Promise<SuccessParams | void> | void;
+    onTableConfigChange?: (config: DataTableConfig) => void;
     grandTotalsLabelRenderer?: React.FunctionComponent<GrandTotalsLabelRendererProps>;
     /**
      * Callback after bulk edit action is performed.
@@ -1374,6 +1382,7 @@ interface InternalTableContext {
     onServerSideDataRequest?: DataTableProps['onServerSideDataRequest'];
     updateServerSideDataSource: (params: UpdateServerSideDataSourceParams) => void;
     localStoragePersistenceKey?: string;
+    onExpandOrCollapseAll?: (expanded: boolean) => void;
     onTableConfigChange: () => void;
     rowHeight: RowSize;
     rowSelectionRef?: React__default.MutableRefObject<RowSelectionRef>;
@@ -1454,7 +1463,7 @@ interface BulkActionProps {
     style?: React__default.CSSProperties;
 }
 
-declare const _default$1: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onTableConfigChange, translations, enableCellTextSelection, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<ClientSideDataTableProps>) => React__default.JSX.Element) & {
+declare const _default$1: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onExpandOrCollapseAll, onTableConfigChange, translations, enableCellTextSelection, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<ClientSideDataTableProps>) => React__default.JSX.Element) & {
     BulkActions: React__default.FunctionComponent<React__default.PropsWithChildren<BulkActionProps>>;
     BulkEditActionButton: React__default.FunctionComponent<ActionButtonProps>;
     ConfigPanelButton: React__default.FC<{}>;
@@ -1491,7 +1500,7 @@ declare const MultiSelectQuickFilterRenderer: (props: FilterProps<any[]>) => Rea
 
 declare const SingleSelectQuickFilterRenderer: (props: FilterProps<any[]>) => React__default.JSX.Element;
 
-declare const _default: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onServerSideDataRequest, onTableConfigChange, enableCellTextSelection, showExpandCollapseAllToggle, translations, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<DataTableProps>) => React__default.JSX.Element) & {
+declare const _default: (({ analytics, children, columnDefinitions: _columnDefinitions, customBulkEditorFields, enableDynamicRowHeight, enableGroupEditAndValidation, filterGroups, getRowId, initialTableConfig: _initialTableConfig, onBulkEditUpdate, onExpandOrCollapseAll, onServerSideDataRequest, onTableConfigChange, enableCellTextSelection, showExpandCollapseAllToggle, translations, localStoragePersistenceKey, enableCDN, }: React__default.PropsWithChildren<DataTableProps>) => React__default.JSX.Element) & {
     BulkActions: React__default.FunctionComponent<React__default.PropsWithChildren<BulkActionProps>>;
     BulkEditActionButton: React__default.FunctionComponent<ActionButtonProps>;
     ConfigPanelButton: React__default.FC<{}>;

package/dist/modern/index.js

@@ -56504,9 +56504,10 @@ var GenericHeaderRenderer = (props) => {
   const {
     columnApi,
     tableRef,
+    onExpandOrCollapseAll,
     onServerSideDataRequest,
-    showExpandCollapseAllToggle,
-    onTableConfigChange
+    onTableConfigChange,
+    showExpandCollapseAllToggle
   } = useInternalTableContext();
   const onSSDR = Boolean(onServerSideDataRequest);
   const [sortOrder, setSortOrder] = React80.useState(props.column.getSort());
@@ -56695,9 +56696,11 @@ var GenericHeaderRenderer = (props) => {
           }
         });
         setExpansionVariant("tierOne");
+        onExpandOrCollapseAll?.(true);
       } else {
         props.api.collapseAll();
         setExpansionVariant("closed");
+        onExpandOrCollapseAll?.(false);
       }
       return;
     }
@@ -56712,10 +56715,13 @@ var GenericHeaderRenderer = (props) => {
         props.api
       );
       setExpansionVariant(hasMoreExpandableNodes ? "tierOne" : "all");
+      onExpandOrCollapseAll?.(true);
     } else if (expansionVariant === "tierOne") {
       props.api.expandAll();
+      onExpandOrCollapseAll?.(true);
     } else {
       props.api.collapseAll();
+      onExpandOrCollapseAll?.(false);
     }
   }
   const tooltipText = {
@@ -56887,7 +56893,8 @@ var GenericHeaderRenderer = (props) => {
             "aria-label": tooltipText[expansionVariant],
             className: "expand-button",
             onClick: onExpandToggle,
-            role: "button"
+            role: "button",
+            "data-qa": "expand-or-collapse-all-button"
           },
           /* @__PURE__ */ React80.createElement(ExpansionVariantIcon, { size: "sm" })
         )
@@ -57731,6 +57738,8 @@ var InternalTableContext = React80.createContext({
   gridApi: void 0,
   localStoragePersistenceKey: void 0,
   onBulkEditUpdate: () => Promise.resolve(),
+  onExpandOrCollapseAll: () => {
+  },
   onServerSideDataRequest: void 0,
   onTableConfigChange: () => {
   },
@@ -108824,6 +108833,7 @@ var DataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onServerSideDataRequest,
   onTableConfigChange,
   showExpandCollapseAllToggle,
@@ -109070,6 +109080,7 @@ var DataTable = ({
         gridApi,
         initialTableConfig,
         onBulkEditUpdate,
+        onExpandOrCollapseAll,
         onServerSideDataRequest,
         onTableConfigChange: internalOnTableConfigChange,
         rowSelectionRef,
@@ -112073,6 +112084,7 @@ var ClientSideDataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onTableConfigChange,
   translations: translations2 = {},
   enableCellTextSelection,
@@ -112089,8 +112101,9 @@ var ClientSideDataTable = ({
       filterGroups,
       getRowId,
       initialTableConfig: _initialTableConfig,
-      onTableConfigChange,
       onBulkEditUpdate,
+      onExpandOrCollapseAll,
+      onTableConfigChange,
       showExpandCollapseAllToggle: true,
       translations: translations2,
       localStoragePersistenceKey,
@@ -116481,6 +116494,7 @@ var ServerSideDataTable = ({
   getRowId,
   initialTableConfig: _initialTableConfig,
   onBulkEditUpdate,
+  onExpandOrCollapseAll,
   onServerSideDataRequest,
   onTableConfigChange,
   enableCellTextSelection,
@@ -116499,9 +116513,10 @@ var ServerSideDataTable = ({
       filterGroups,
       getRowId,
       initialTableConfig: _initialTableConfig,
-      onTableConfigChange,
-      onServerSideDataRequest,
       onBulkEditUpdate,
+      onExpandOrCollapseAll,
+      onServerSideDataRequest,
+      onTableConfigChange,
       showExpandCollapseAllToggle,
       translations: translations2,
       customBulkEditorFields,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@procore/data-table",
-  "version": "14.38.0",
+  "version": "14.39.0",
   "description": "Complex data grid built on top of ag-grid, with DST components and styles.",
   "author": "Procore Technologies",
   "homepage": "https://github.com/procore/core/tree/main/packages/data-table",
@@ -108,7 +108,7 @@
     "@procore/core-css": "10.17.0",
     "@procore/core-icons": "^12.11.0",
     "@procore/core-prettier": "10.2.0",
-    "@procore/core-react": "^12.32.0",
+    "@procore/core-react": "^12.33.0",
     "@procore/eslint-config": "10.0.0",
     "@procore/globalization-toolkit": "3.1.0",
     "@procore/labs-financials-utils": "4.3.1",