From 972e9dddfbdb918293898c1ff2c79d703fd278ca Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 20 Nov 2024 21:57:26 +0100
Subject: [PATCH 001/146] Add a "Select all" button + make it customizable +
 document jsDoc

---
 .../src/controller/list/ListContext.tsx       |  2 +
 .../list/useListContextWithProps.ts           |  6 +++
 .../src/controller/list/useListController.ts  | 50 +++++++++++++++++++
 packages/ra-language-english/src/index.ts     | 13 ++---
 .../src/list/BulkActionsToolbar.tsx           | 20 +++++++-
 packages/ra-ui-materialui/src/list/List.tsx   |  3 ++
 6 files changed, 87 insertions(+), 7 deletions(-)

diff --git a/packages/ra-core/src/controller/list/ListContext.tsx b/packages/ra-core/src/controller/list/ListContext.tsx
index f4af11d4495..10d0d19fc2c 100644
--- a/packages/ra-core/src/controller/list/ListContext.tsx
+++ b/packages/ra-core/src/controller/list/ListContext.tsx
@@ -24,7 +24,9 @@ import { ListControllerResult } from './useListController';
  * @prop {Function} showFilter a callback to show one of the filters, e.g. showFilter('title', defaultValue)
  * @prop {Function} hideFilter a callback to hide one of the filters, e.g. hideFilter('title')
  * @prop {Array}    selectedIds an array listing the ids of the selected rows, e.g. [123, 456]
+ * @prop {boolean}  areAllSelected boolean to indicate if the list is already fully selected
  * @prop {Function} onSelect callback to change the list of selected rows, e.g. onSelect([456, 789])
+ * @prop {Function} onSelectAll callback to select all the records, e.g. onSelectAll()
  * @prop {Function} onToggleItem callback to toggle the selection of a given record based on its id, e.g. onToggleItem(456)
  * @prop {Function} onUnselectItems callback to clear the selection, e.g. onUnselectItems();
  * @prop {string}   defaultTitle the translated title based on the resource, e.g. 'Posts'
diff --git a/packages/ra-core/src/controller/list/useListContextWithProps.ts b/packages/ra-core/src/controller/list/useListContextWithProps.ts
index 206be897b56..d4bcef919b2 100644
--- a/packages/ra-core/src/controller/list/useListContextWithProps.ts
+++ b/packages/ra-core/src/controller/list/useListContextWithProps.ts
@@ -33,7 +33,9 @@ import { RaRecord } from '../../types';
  * @prop {Function} showFilter a callback to show one of the filters, e.g. showFilter('title', defaultValue)
  * @prop {Function} hideFilter a callback to hide one of the filters, e.g. hideFilter('title')
  * @prop {Array}    selectedIds an array listing the ids of the selected rows, e.g. [123, 456]
+ * @prop {boolean}  areAllSelected boolean to indicate if the list is already fully selected
  * @prop {Function} onSelect callback to change the list of selected rows, e.g. onSelect([456, 789])
+ * @prop {Function} onSelectAll callback to select all the records, e.g. onSelectAll()
  * @prop {Function} onToggleItem callback to toggle the selection of a given record based on its id, e.g. onToggleItem(456)
  * @prop {Function} onUnselectItems callback to clear the selection, e.g. onUnselectItems();
  * @prop {string}   defaultTitle the translated title based on the resource, e.g. 'Posts'
@@ -81,6 +83,7 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     isLoading,
     isPending,
     onSelect,
+    onSelectAll,
     onToggleItem,
     onUnselectItems,
     page,
@@ -88,6 +91,7 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     refetch,
     resource,
     selectedIds,
+    areAllSelected,
     setFilters,
     setPage,
     setPerPage,
@@ -107,6 +111,7 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     isLoading,
     isPending,
     onSelect,
+    onSelectAll,
     onToggleItem,
     onUnselectItems,
     page,
@@ -114,6 +119,7 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     refetch,
     resource,
     selectedIds,
+    areAllSelected,
     setFilters,
     setPage,
     setPerPage,
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index 0e69f46e133..d6fe16e515f 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -46,6 +46,7 @@ export const useListController = <RecordType extends RaRecord = any>(
         queryOptions = {},
         sort = defaultSort,
         storeKey,
+        selectAllLimit = 250,
     } = props;
     const resource = useResourceContext(props);
     const { meta, ...otherQueryOptions } = queryOptions;
@@ -168,6 +169,38 @@ export const useListController = <RecordType extends RaRecord = any>(
         name: getResourceLabel(resource, 2),
     });
 
+    const { data: allData } = useGetList<RecordType>(
+        resource,
+        {
+            pagination: {
+                page: 1,
+                perPage: selectAllLimit,
+            },
+            sort: { field: query.sort, order: query.order },
+            filter: { ...query.filter, ...filter },
+            meta,
+        },
+        {
+            enabled:
+                (!isPendingAuthenticated && !isPendingCanAccess) ||
+                disableAuthentication,
+            retry: false,
+            ...otherQueryOptions,
+        }
+    );
+
+    const onSelectAll = () => {
+        console.log('onSelectAll', allData);
+        const allIds = allData?.map(({ id }) => id) || [];
+        selectionModifiers.select(allIds);
+        if (allIds.length === selectAllLimit) {
+            notify('ra.message.too_many_elements', {
+                messageArgs: { max: selectAllLimit },
+                type: 'warning',
+            });
+        }
+    };
+
     return {
         sort: currentSort,
         data,
@@ -183,6 +216,7 @@ export const useListController = <RecordType extends RaRecord = any>(
         isLoading,
         isPending,
         onSelect: selectionModifiers.select,
+        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page: query.page,
@@ -190,6 +224,7 @@ export const useListController = <RecordType extends RaRecord = any>(
         refetch,
         resource,
         selectedIds,
+        areAllSelected: allData?.length !== selectedIds.length,
         setFilters: queryModifiers.setFilters,
         setPage: queryModifiers.setPage,
         setPerPage: queryModifiers.setPerPage,
@@ -409,6 +444,19 @@ export interface ListControllerProps<RecordType extends RaRecord = any> {
      * );
      */
     storeKey?: string | false;
+
+    /**
+     * The number of items selected by the "SELECT ALL" button of the bulk actions toolbar.
+     *
+     * @see https://marmelab.com/react-admin/List.html#selectalllimit
+     * @example
+     * export const PostList = () => (
+     *     <List selectAllLimit={500}>
+     *         ...
+     *     </List>
+     * );
+     */
+    selectAllLimit?: number;
 }
 
 const defaultSort = {
@@ -475,6 +523,7 @@ export interface ListControllerBaseResult<RecordType extends RaRecord = any> {
     filterValues: any;
     hideFilter: (filterName: string) => void;
     onSelect: (ids: RecordType['id'][]) => void;
+    onSelectAll: () => void;
     onToggleItem: (id: RecordType['id']) => void;
     onUnselectItems: () => void;
     page: number;
@@ -482,6 +531,7 @@ export interface ListControllerBaseResult<RecordType extends RaRecord = any> {
     refetch: (() => void) | UseGetListHookValue<RecordType>['refetch'];
     resource: string;
     selectedIds: RecordType['id'][];
+    areAllSelected: boolean;
     setFilters: (
         filters: any,
         displayedFilters?: any,
diff --git a/packages/ra-language-english/src/index.ts b/packages/ra-language-english/src/index.ts
index 704b30e6919..81422c1a7da 100644
--- a/packages/ra-language-english/src/index.ts
+++ b/packages/ra-language-english/src/index.ts
@@ -87,7 +87,11 @@ const englishMessages: TranslationMessages = {
         },
         message: {
             about: 'About',
+            access_denied:
+                "You don't have the right permissions to access this page",
             are_you_sure: 'Are you sure?',
+            authentication_error:
+                'The authentication server returned an error and your credentials could not be checked.',
             auth_error:
                 'An error occurred while validating the authentication token.',
             bulk_delete_content:
@@ -103,19 +107,16 @@ const englishMessages: TranslationMessages = {
             delete_title: 'Delete %{name} #%{id}',
             details: 'Details',
             error: "A client error occurred and your request couldn't be completed.",
-
             invalid_form: 'The form is not valid. Please check for errors',
             loading: 'Please wait',
             no: 'No',
             not_found:
                 'Either you typed a wrong URL, or you followed a bad link.',
-            yes: 'Yes',
+            too_many_elements:
+                'Warning: There are too many elements to select them all. Only the first %{max} elements were selected.',
             unsaved_changes:
                 "Some of your changes weren't saved. Are you sure you want to ignore them?",
-            access_denied:
-                "You don't have the right permissions to access this page",
-            authentication_error:
-                'The authentication server returned an error and your credentials could not be checked.',
+            yes: 'Yes',
         },
         navigation: {
             clear_filters: 'Clear filters',
diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index 1d42530c1f6..b39eaf69ceb 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -10,6 +10,7 @@ import CloseIcon from '@mui/icons-material/Close';
 import { useTranslate, sanitizeListRestProps, useListContext } from 'ra-core';
 
 import TopToolbar from '../layout/TopToolbar';
+import { Button } from '../button';
 
 export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
     const {
@@ -18,7 +19,12 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
         className,
         ...rest
     } = props;
-    const { selectedIds = [], onUnselectItems } = useListContext();
+    const {
+        selectedIds = [],
+        onUnselectItems,
+        onSelectAll,
+        areAllSelected,
+    } = useListContext();
 
     const translate = useTranslate();
 
@@ -26,6 +32,10 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
         onUnselectItems();
     }, [onUnselectItems]);
 
+    const handleSelectAll = useCallback(() => {
+        onSelectAll();
+    }, [onSelectAll]);
+
     return (
         <Root className={className}>
             <Toolbar
@@ -52,6 +62,13 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
                             smart_count: selectedIds.length,
                         })}
                     </Typography>
+                    {areAllSelected && (
+                        <Button
+                            label={translate('ra.action.select_all')}
+                            onClick={handleSelectAll}
+                            sx={{ ml: 1 }}
+                        />
+                    )}
                 </div>
                 <TopToolbar className={BulkActionsToolbarClasses.topToolbar}>
                     {children}
@@ -65,6 +82,7 @@ export interface BulkActionsToolbarProps {
     children?: ReactNode;
     label?: string;
     className?: string;
+    selectAllLimit?: number;
 }
 
 const PREFIX = 'RaBulkActionsToolbar';
diff --git a/packages/ra-ui-materialui/src/list/List.tsx b/packages/ra-ui-materialui/src/list/List.tsx
index e562bf7ad50..2c0e9b20feb 100644
--- a/packages/ra-ui-materialui/src/list/List.tsx
+++ b/packages/ra-ui-materialui/src/list/List.tsx
@@ -32,6 +32,7 @@ import { Loading } from '../layout';
  * - perPage: Pagination Size
  * - queryOptions
  * - sort: Default Sort Field & Order
+ * - selectAllLimit: The number of items selected by the "SELECT ALL" button of the bulk actions toolbar
  * - title
  * - sx: CSS API
  *
@@ -68,6 +69,7 @@ export const List = <RecordType extends RaRecord = any>({
     resource,
     sort,
     storeKey,
+    selectAllLimit = 250,
     ...rest
 }: ListProps<RecordType>): ReactElement => (
     <ListBase<RecordType>
@@ -83,6 +85,7 @@ export const List = <RecordType extends RaRecord = any>({
         resource={resource}
         sort={sort}
         storeKey={storeKey}
+        selectAllLimit={selectAllLimit}
     >
         <ListView<RecordType> {...rest} />
     </ListBase>

From 96568031a0c02fd9347b765d4fff562ce0633fd4 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 20 Nov 2024 22:27:58 +0100
Subject: [PATCH 002/146] add logic in useList

---
 .../ra-core/src/controller/list/useList.ts    | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/packages/ra-core/src/controller/list/useList.ts b/packages/ra-core/src/controller/list/useList.ts
index f4188d5cd1b..df1faed510e 100644
--- a/packages/ra-core/src/controller/list/useList.ts
+++ b/packages/ra-core/src/controller/list/useList.ts
@@ -1,6 +1,8 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
 import get from 'lodash/get';
 import isEqual from 'lodash/isEqual';
+
+import { useNotify } from '../../notification';
 import { removeEmpty } from '../../util';
 import { FilterPayload, RaRecord, SortPayload } from '../../types';
 import { useResourceContext } from '../../core';
@@ -50,6 +52,7 @@ const refetch = () => {
  * @param {Number} props.perPage: Optional. The initial page size
  * @param {SortPayload} props.sort: Optional. The initial sort (field and order)
  * @param {filterCallback} prop.filterCallback Optional. A function that allows you to make a custom filter
+ * @param {Number} props.selectAllLimit: Optional. The number of items selected by the "SELECT ALL" button of the bulk actions toolbar
  */
 export const useList = <RecordType extends RaRecord = any>(
     props: UseListOptions<RecordType>
@@ -65,8 +68,10 @@ export const useList = <RecordType extends RaRecord = any>(
         perPage: initialPerPage = 1000,
         sort: initialSort,
         filterCallback = (record: RecordType) => Boolean(record),
+        selectAllLimit = 250,
     } = props;
     const resource = useResourceContext(props);
+    const notify = useNotify();
 
     const [fetchingState, setFetchingState] = useState<boolean>(isFetching) as [
         boolean,
@@ -162,6 +167,17 @@ export const useList = <RecordType extends RaRecord = any>(
         },
         [setDisplayedFilters, setFilterValues, setPage]
     );
+    const onSelectAll = useCallback(() => {
+        const allIds = data?.map(({ id }) => id) || [];
+        selectionModifiers.select(allIds);
+        if (allIds.length === selectAllLimit) {
+            notify('ra.message.too_many_elements', {
+                messageArgs: { max: selectAllLimit },
+                type: 'warning',
+            });
+        }
+    }, [data, notify, selectAllLimit, selectionModifiers]);
+
     // handle filter prop change
     useEffect(() => {
         if (!isEqual(filter, filterRef.current)) {
@@ -283,6 +299,7 @@ export const useList = <RecordType extends RaRecord = any>(
         isLoading: loadingState,
         isPending: pendingState,
         onSelect: selectionModifiers.select,
+        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page,
@@ -290,6 +307,7 @@ export const useList = <RecordType extends RaRecord = any>(
         resource: '',
         refetch,
         selectedIds,
+        areAllSelected: data?.length !== selectedIds.length,
         setFilters,
         setPage,
         setPerPage,
@@ -311,6 +329,7 @@ export interface UseListOptions<RecordType extends RaRecord = any> {
     sort?: SortPayload;
     resource?: string;
     filterCallback?: (record: RecordType) => boolean;
+    selectAllLimit?: number;
 }
 
 export type UseListValue<RecordType extends RaRecord = any> =

From 91b874f0153f820a541bd31b96c0b5db73583199 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 20 Nov 2024 22:28:24 +0100
Subject: [PATCH 003/146] wrap function with a useCallback

---
 packages/ra-core/src/controller/list/useListController.ts | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index d6fe16e515f..51f62adbd8c 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -1,4 +1,4 @@
-import { isValidElement, useEffect, useMemo } from 'react';
+import { isValidElement, useCallback, useEffect, useMemo } from 'react';
 
 import { useAuthenticated, useRequireAccess } from '../../auth';
 import { useTranslate } from '../../i18n';
@@ -189,8 +189,7 @@ export const useListController = <RecordType extends RaRecord = any>(
         }
     );
 
-    const onSelectAll = () => {
-        console.log('onSelectAll', allData);
+    const onSelectAll = useCallback(() => {
         const allIds = allData?.map(({ id }) => id) || [];
         selectionModifiers.select(allIds);
         if (allIds.length === selectAllLimit) {
@@ -199,7 +198,7 @@ export const useListController = <RecordType extends RaRecord = any>(
                 type: 'warning',
             });
         }
-    };
+    }, [allData, notify, selectAllLimit, selectionModifiers]);
 
     return {
         sort: currentSort,

From 4cd44ea2eff9da83c623cb6c2da9df6b3309519f Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 20 Nov 2024 22:40:41 +0100
Subject: [PATCH 004/146] add more data in the story to be able to test the
 "SELECT ALL" button

---
 .../src/list/datagrid/Datagrid.stories.tsx    | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
index 86720dc5bf6..ae019027f3e 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
@@ -58,6 +58,54 @@ const data = [
         author: 'Antoine de Saint-Exupéry',
         year: 1943,
     },
+    {
+        id: 5,
+        title: 'Les Misérables',
+        author: 'Victor Hugo',
+        year: 1862,
+    },
+    {
+        id: 6,
+        title: 'Brave New World',
+        author: 'Aldous Huxley',
+        year: 1932,
+    },
+    {
+        id: 7,
+        title: 'The Great Gatsby',
+        author: 'F. Scott Fitzgerald',
+        year: 1925,
+    },
+    {
+        id: 8,
+        title: 'One Hundred Years of Solitude',
+        author: 'Gabriel García Márquez',
+        year: 1967,
+    },
+    {
+        id: 9,
+        title: "Harry Potter and the Philosopher's Stone",
+        author: 'J.K. Rowling',
+        year: 1997,
+    },
+    {
+        id: 10,
+        title: 'The Catcher in the Rye',
+        author: 'J.D. Salinger',
+        year: 1951,
+    },
+    {
+        id: 11,
+        title: 'The Lord of the Rings',
+        author: 'J.R.R. Tolkien',
+        year: 1954,
+    },
+    {
+        id: 12,
+        title: 'The Hobbit',
+        author: 'J.R.R. Tolkien',
+        year: 1937,
+    },
 ];
 
 const theme = createTheme();

From 6178ee53128b77b60f7706fe713efeec12bd5e21 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 16:41:17 +0100
Subject: [PATCH 005/146] simplify the areAllSelected check

---
 packages/ra-core/src/controller/list/useListController.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index 51f62adbd8c..d53aec698e6 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -169,7 +169,7 @@ export const useListController = <RecordType extends RaRecord = any>(
         name: getResourceLabel(resource, 2),
     });
 
-    const { data: allData } = useGetList<RecordType>(
+    const { data: allData, total: allDataTotal } = useGetList<RecordType>(
         resource,
         {
             pagination: {
@@ -223,7 +223,7 @@ export const useListController = <RecordType extends RaRecord = any>(
         refetch,
         resource,
         selectedIds,
-        areAllSelected: allData?.length !== selectedIds.length,
+        areAllSelected: allDataTotal !== selectedIds.length,
         setFilters: queryModifiers.setFilters,
         setPage: queryModifiers.setPage,
         setPerPage: queryModifiers.setPerPage,

From 9e26228049906b6b1781dea509720cef732ad01e Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 16:42:06 +0100
Subject: [PATCH 006/146] add select all button on ReferenceManyField

---
 .../field/useReferenceManyFieldController.ts  | 35 +++++++++++++++++++
 .../src/field/ReferenceManyField.tsx          |  2 ++
 2 files changed, 37 insertions(+)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 06a8bb99e31..6a57a5fa72c 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -64,6 +64,7 @@ export const useReferenceManyFieldController = <
             { data: ReferenceRecordType[]; total: number },
             Error
         >,
+        selectAllLimit = 250,
     } = props;
     const notify = useNotify();
     const resource = useResourceContext(props);
@@ -200,6 +201,37 @@ export const useReferenceManyFieldController = <
         }
     );
 
+    const { data: allData, total: allDataTotal } =
+        useGetManyReference<ReferenceRecordType>(
+            reference,
+            {
+                target,
+                id: get(record, source) as Identifier,
+                pagination: {
+                    page: 1,
+                    perPage: selectAllLimit,
+                },
+                sort,
+                filter: filterValues,
+                meta,
+            },
+            {
+                enabled: get(record, source) != null,
+                ...otherQueryOptions,
+            }
+        );
+
+    const onSelectAll = useCallback(() => {
+        const allIds = allData?.map(({ id }) => id) || [];
+        selectionModifiers.select(allIds);
+        if (allIds.length === selectAllLimit) {
+            notify('ra.message.too_many_elements', {
+                messageArgs: { max: selectAllLimit },
+                type: 'warning',
+            });
+        }
+    }, [allData, notify, selectAllLimit, selectionModifiers]);
+
     return {
         sort,
         data,
@@ -213,6 +245,7 @@ export const useReferenceManyFieldController = <
         isLoading,
         isPending,
         onSelect: selectionModifiers.select,
+        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page,
@@ -220,6 +253,7 @@ export const useReferenceManyFieldController = <
         refetch,
         resource: reference,
         selectedIds,
+        areAllSelected: allDataTotal !== selectedIds.length,
         setFilters,
         setPage,
         setPerPage,
@@ -249,6 +283,7 @@ export interface UseReferenceManyFieldControllerParams<
     sort?: SortPayload;
     source?: string;
     storeKey?: string;
+    selectAllLimit?: number;
     target: string;
     queryOptions?: Omit<
         UseQueryOptions<{ data: ReferenceRecordType[]; total: number }, Error>,
diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.tsx
index 1413ca20515..24c6dec6020 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.tsx
@@ -74,6 +74,7 @@ export const ReferenceManyField = <
         sort = defaultSort,
         source = 'id',
         storeKey,
+        selectAllLimit = 250,
         target,
         queryOptions,
     } = props;
@@ -93,6 +94,7 @@ export const ReferenceManyField = <
         sort,
         source,
         storeKey,
+        selectAllLimit,
         target,
         queryOptions,
     });

From dc18571f41ea7ce415e645f72179075c74786141 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 16:42:47 +0100
Subject: [PATCH 007/146] add a full app story with ReferenceManyField

---
 .../src/field/ReferenceManyField.stories.tsx  | 66 ++++++++++++++++++-
 1 file changed, 65 insertions(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
index 7437ff1a865..10e1c809a86 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
@@ -4,29 +4,62 @@ import {
     CoreAdminContext,
     RecordContextProvider,
     ResourceContextProvider,
+    TestMemoryRouter,
 } from 'ra-core';
+import { Admin, ListGuesser, Resource } from 'react-admin';
 import { ThemeProvider, Box, Stack } from '@mui/material';
 import { createTheme } from '@mui/material/styles';
+import fakeDataProvider from 'ra-data-fakerest';
+import polyglotI18nProvider from 'ra-i18n-polyglot';
+import englishMessages from 'ra-language-english';
 
 import { TextField } from '../field';
 import { ReferenceManyField } from './ReferenceManyField';
 import { Datagrid } from '../list/datagrid/Datagrid';
-import { SingleFieldList } from '../list';
+import { Pagination, SingleFieldList } from '../list';
 import { Notification } from '../layout/Notification';
 import { FilterForm } from '../list';
 import { TextInput } from '../input';
+import { Edit } from '../detail';
+import { SimpleForm } from '../form';
 
 export default { title: 'ra-ui-materialui/fields/ReferenceManyField' };
 
 const author = { id: 1, name: 'Leo Tolstoi' };
+const authors = [
+    author,
+    { id: 2, name: 'Victor Hugo' },
+    { id: 3, name: 'Alexandre Dumas' },
+    { id: 4, name: 'J.K. Rowling' },
+];
 let books = [
     { id: 1, title: 'War and Peace', author_id: 1 },
     { id: 2, title: 'Les Misérables', author_id: 2 },
     { id: 3, title: 'Anna Karenina', author_id: 1 },
     { id: 4, title: 'The Count of Monte Cristo', author_id: 3 },
     { id: 5, title: 'Resurrection', author_id: 1 },
+    { id: 6, title: 'The Three Musketeers', author_id: 3 },
+    { id: 7, title: 'The Idiot', author_id: 1 },
+    { id: 8, title: 'The Last Day of a Condemned', author_id: 1 },
+    { id: 9, title: 'The Queen Margot', author_id: 3 },
+    { id: 10, title: "Harry Potter and the Philosopher's Stone", author_id: 4 },
+    { id: 11, title: 'Harry Potter and the Chamber of Secrets', author_id: 4 },
+    { id: 12, title: 'Harry Potter and the Prisoner of Azkaban', author_id: 4 },
+    { id: 13, title: 'Harry Potter and the Goblet of Fire', author_id: 4 },
+    {
+        id: 14,
+        title: 'Harry Potter and the Order of the Phoenix',
+        author_id: 4,
+    },
+    { id: 15, title: 'Harry Potter and the Half-Blood Prince', author_id: 4 },
+    { id: 16, title: 'Harry Potter and the Deathly Hallows', author_id: 4 },
 ];
 
+const fullDataProvider = fakeDataProvider(
+    { books, authors },
+    process.env.NODE_ENV === 'development'
+);
+
 const defaultDataProvider = {
     getManyReference: (resource, params) => {
         const result = books
@@ -147,3 +180,34 @@ export const StoreKey = () => (
         </Stack>
     </Wrapper>
 );
+
+const AuthorEdit = () => (
+    <Edit>
+        <SimpleForm>
+            <TextField source="id" />
+            <TextInput source="name" />
+            <ReferenceManyField
+                reference="books"
+                target="author_id"
+                pagination={<Pagination />}
+                perPage={5}
+            >
+                <Datagrid>
+                    <TextField source="title" />
+                </Datagrid>
+            </ReferenceManyField>
+        </SimpleForm>
+    </Edit>
+);
+
+export const FullApp = () => (
+    <TestMemoryRouter initialEntries={['/authors/4']}>
+        <Admin
+            dataProvider={fullDataProvider}
+            i18nProvider={polyglotI18nProvider(() => englishMessages)}
+        >
+            <Resource name="authors" list={ListGuesser} edit={AuthorEdit} />
+            <Resource name="books" list={ListGuesser} />
+        </Admin>
+    </TestMemoryRouter>
+);

From 426c9f57bb815b68df0298296275685d3dc0d778 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 17:07:42 +0100
Subject: [PATCH 008/146] remove the useless selectAllLimit prop from useList

---
 packages/ra-core/src/controller/list/useList.ts | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useList.ts b/packages/ra-core/src/controller/list/useList.ts
index df1faed510e..77af1829e9e 100644
--- a/packages/ra-core/src/controller/list/useList.ts
+++ b/packages/ra-core/src/controller/list/useList.ts
@@ -2,7 +2,6 @@ import { useCallback, useEffect, useRef, useState } from 'react';
 import get from 'lodash/get';
 import isEqual from 'lodash/isEqual';
 
-import { useNotify } from '../../notification';
 import { removeEmpty } from '../../util';
 import { FilterPayload, RaRecord, SortPayload } from '../../types';
 import { useResourceContext } from '../../core';
@@ -68,10 +67,8 @@ export const useList = <RecordType extends RaRecord = any>(
         perPage: initialPerPage = 1000,
         sort: initialSort,
         filterCallback = (record: RecordType) => Boolean(record),
-        selectAllLimit = 250,
     } = props;
     const resource = useResourceContext(props);
-    const notify = useNotify();
 
     const [fetchingState, setFetchingState] = useState<boolean>(isFetching) as [
         boolean,
@@ -170,13 +167,7 @@ export const useList = <RecordType extends RaRecord = any>(
     const onSelectAll = useCallback(() => {
         const allIds = data?.map(({ id }) => id) || [];
         selectionModifiers.select(allIds);
-        if (allIds.length === selectAllLimit) {
-            notify('ra.message.too_many_elements', {
-                messageArgs: { max: selectAllLimit },
-                type: 'warning',
-            });
-        }
-    }, [data, notify, selectAllLimit, selectionModifiers]);
+    }, [data, selectionModifiers]);
 
     // handle filter prop change
     useEffect(() => {
@@ -329,7 +320,6 @@ export interface UseListOptions<RecordType extends RaRecord = any> {
     sort?: SortPayload;
     resource?: string;
     filterCallback?: (record: RecordType) => boolean;
-    selectAllLimit?: number;
 }
 
 export type UseListValue<RecordType extends RaRecord = any> =

From 5721ae9acda467b481599a6815af44a3f0f4fd0c Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 17:08:32 +0100
Subject: [PATCH 009/146] add a SELECT ALL button for ReferenceArrayField

---
 .../src/field/ReferenceArrayField.stories.tsx | 36 +++++++++++++++++--
 .../src/field/ReferenceArrayField.tsx         |  3 ++
 2 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/packages/ra-ui-materialui/src/field/ReferenceArrayField.stories.tsx b/packages/ra-ui-materialui/src/field/ReferenceArrayField.stories.tsx
index 56a54cca2bc..532fc1c7e03 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceArrayField.stories.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceArrayField.stories.tsx
@@ -2,9 +2,11 @@ import * as React from 'react';
 import fakeRestProvider from 'ra-data-fakerest';
 import { CardContent } from '@mui/material';
 import { ResourceDefinitionContextProvider } from 'ra-core';
+import polyglotI18nProvider from 'ra-i18n-polyglot';
+import englishMessages from 'ra-language-english';
 
 import { AdminContext } from '../AdminContext';
-import { Datagrid } from '../list';
+import { Datagrid, Pagination } from '../list';
 import { ReferenceArrayField } from './ReferenceArrayField';
 import { TextField } from './TextField';
 import { Show, SimpleShowLayout } from '../detail';
@@ -12,13 +14,16 @@ import { Show, SimpleShowLayout } from '../detail';
 export default { title: 'ra-ui-materialui/fields/ReferenceArrayField' };
 
 const fakeData = {
-    bands: [{ id: 1, name: 'The Beatles', members: [1, 2, 3, 4] }],
+    bands: [{ id: 1, name: 'The Beatles', members: [1, 2, 3, 4, 5, 6, 7, 8] }],
     artists: [
         { id: 1, name: 'John Lennon' },
         { id: 2, name: 'Paul McCartney' },
         { id: 3, name: 'Ringo Star' },
         { id: 4, name: 'George Harrison' },
         { id: 5, name: 'Mick Jagger' },
+        { id: 6, name: 'Keith Richards' },
+        { id: 7, name: 'Ronnie Wood' },
+        { id: 8, name: 'Charlie Watts' },
     ],
 };
 const dataProvider = fakeRestProvider(fakeData, false);
@@ -132,3 +137,30 @@ export const WithMeta = () => {
         </AdminContext>
     );
 };
+
+export const WithPagination = () => (
+    <AdminContext
+        dataProvider={dataProvider}
+        i18nProvider={polyglotI18nProvider(() => englishMessages)}
+        defaultTheme="light"
+    >
+        <ResourceDefinitionContextProvider definitions={resouceDefs}>
+            <Show resource="bands" id={1} sx={{ width: 600 }}>
+                <SimpleShowLayout>
+                    <TextField source="name" />
+                    <ReferenceArrayField
+                        source="members"
+                        reference="artists"
+                        pagination={<Pagination />}
+                        perPage={5}
+                    >
+                        <Datagrid>
+                            <TextField source="id" />
+                            <TextField source="name" />
+                        </Datagrid>
+                    </ReferenceArrayField>
+                </SimpleShowLayout>
+            </Show>
+        </ResourceDefinitionContextProvider>
+    </AdminContext>
+);
diff --git a/packages/ra-ui-materialui/src/field/ReferenceArrayField.tsx b/packages/ra-ui-materialui/src/field/ReferenceArrayField.tsx
index 72531c2e966..d09762e41ca 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceArrayField.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceArrayField.tsx
@@ -89,6 +89,7 @@ export const ReferenceArrayField = <
         resource,
         sort,
         source,
+        selectAllLimit = 250,
         queryOptions,
     } = props;
     const record = useRecordContext(props);
@@ -104,6 +105,7 @@ export const ReferenceArrayField = <
         resource,
         sort,
         source,
+        selectAllLimit,
         queryOptions,
     });
     return (
@@ -125,6 +127,7 @@ export interface ReferenceArrayFieldProps<
     perPage?: number;
     reference: string;
     sort?: SortPayload;
+    selectAllLimit?: number;
     sx?: SxProps;
     queryOptions?: UseQueryOptions<ReferenceRecordType[], Error>;
 }

From 02eef0b82d9f0669dacc19ff36e54011390829fe Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 18:45:16 +0100
Subject: [PATCH 010/146] add SELECT ALL button on infiniteList + story +
 selectAllLimit

---
 .../list/useInfiniteListController.ts         | 36 +++++++++++++++++++
 .../src/list/InfiniteList.stories.tsx         | 17 +++++++++
 .../src/list/InfiniteList.tsx                 |  3 ++
 3 files changed, 56 insertions(+)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index b91bc07066c..d13d86495cb 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -2,6 +2,7 @@ import { isValidElement, useEffect, useMemo } from 'react';
 import {
     InfiniteQueryObserverBaseResult,
     InfiniteData,
+    useMutation,
 } from '@tanstack/react-query';
 
 import { useAuthenticated, useRequireAccess } from '../../auth';
@@ -9,6 +10,7 @@ import { useTranslate } from '../../i18n';
 import { useNotify } from '../../notification';
 import {
     UseInfiniteGetListOptions,
+    useDataProvider,
     useInfiniteGetList,
 } from '../../dataProvider';
 import { defaultExporter } from '../../export';
@@ -56,6 +58,7 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         queryOptions,
         sort,
         storeKey,
+        selectAllLimit = 250,
     } = props;
     const resource = useResourceContext(props);
     const { meta, ...otherQueryOptions } = queryOptions ?? {};
@@ -84,6 +87,7 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
 
     const translate = useTranslate();
     const notify = useNotify();
+    const dataProvider = useDataProvider();
 
     const [query, queryModifiers] = useListParams({
         debounce,
@@ -139,6 +143,32 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         }
     );
 
+    const { mutate: onSelectAll } = useMutation({
+        mutationFn: () =>
+            dataProvider.getList(resource, {
+                pagination: {
+                    page: 1,
+                    perPage: selectAllLimit,
+                },
+                sort: { field: query.sort, order: query.order },
+                filter: { ...query.filter, ...filter },
+                meta,
+            }),
+        onSuccess: ({ data }) => {
+            const allIds = data?.map(({ id }) => id) || [];
+            selectionModifiers.select(allIds);
+            if (allIds.length === selectAllLimit) {
+                notify('ra.message.too_many_elements', {
+                    messageArgs: { max: selectAllLimit },
+                    type: 'warning',
+                });
+            }
+        },
+        onError: () => {
+            notify('An error occurred. Please try again.');
+        },
+    });
+
     // change page if there is no data
     useEffect(() => {
         if (
@@ -194,6 +224,7 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         isLoading,
         isPending,
         onSelect: selectionModifiers.select,
+        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page: query.page,
@@ -201,6 +232,10 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         refetch,
         resource,
         selectedIds,
+        areAllSelected: !(
+            total === selectedIds.length ||
+            selectedIds.length === selectAllLimit
+        ),
         setFilters: queryModifiers.setFilters,
         setPage: queryModifiers.setPage,
         setPerPage: queryModifiers.setPerPage,
@@ -233,6 +268,7 @@ export interface InfiniteListControllerProps<
     resource?: string;
     sort?: SortPayload;
     storeKey?: string | false;
+    selectAllLimit?: number;
 }
 
 export type InfiniteListControllerResult<RecordType extends RaRecord = any> =
diff --git a/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx b/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
index c3fb1a68f57..39d4be0f1ed 100644
--- a/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
@@ -362,6 +362,23 @@ export const WithDatagrid = () => (
     </Admin>
 );
 
+export const WithDatagridAndSelectAllLimit = () => (
+    <Admin dataProvider={dataProvider}>
+        <Resource
+            name="books"
+            list={() => (
+                <InfiniteList selectAllLimit={22}>
+                    <Datagrid>
+                        <TextField source="id" />
+                        <TextField source="title" />
+                        <TextField source="author" />
+                    </Datagrid>
+                </InfiniteList>
+            )}
+        />
+    </Admin>
+);
+
 const BookActions = () => (
     <TopToolbar>
         <SortButton fields={['id', 'title']} />
diff --git a/packages/ra-ui-materialui/src/list/InfiniteList.tsx b/packages/ra-ui-materialui/src/list/InfiniteList.tsx
index 97395664ffc..50eee6c9f3d 100644
--- a/packages/ra-ui-materialui/src/list/InfiniteList.tsx
+++ b/packages/ra-ui-materialui/src/list/InfiniteList.tsx
@@ -36,6 +36,7 @@ import { Loading } from '../layout';
  * - perPage: Pagination Size
  * - queryOptions
  * - sort: Default Sort Field & Order
+ * - selectAllLimit: The number of items selected by the "SELECT ALL" button of the bulk actions toolbar of the Datagrid
  * - title
  * - sx: CSS API
  *
@@ -73,6 +74,7 @@ export const InfiniteList = <RecordType extends RaRecord = any>({
     resource,
     sort,
     storeKey,
+    selectAllLimit = 250,
     ...rest
 }: InfiniteListProps<RecordType>): ReactElement => (
     <InfiniteListBase<RecordType>
@@ -88,6 +90,7 @@ export const InfiniteList = <RecordType extends RaRecord = any>({
         resource={resource}
         sort={sort}
         storeKey={storeKey}
+        selectAllLimit={selectAllLimit}
     >
         <ListView<RecordType> {...rest} pagination={pagination} />
     </InfiniteListBase>

From 60b0b9a11864d2b5f96f044555b92e7aa46a1025 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 22:52:48 +0100
Subject: [PATCH 011/146] change call on mount to mutation on callback

---
 .../field/useReferenceManyFieldController.ts  | 47 +++++++-------
 .../src/controller/list/useListController.ts  | 65 ++++++++++---------
 2 files changed, 57 insertions(+), 55 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 6a57a5fa72c..8aee8e82b2e 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -1,11 +1,11 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { UseQueryOptions } from '@tanstack/react-query';
+import { UseQueryOptions, useMutation } from '@tanstack/react-query';
 import get from 'lodash/get';
 import isEqual from 'lodash/isEqual';
 import lodashDebounce from 'lodash/debounce';
 
 import { removeEmpty } from '../../util';
-import { useGetManyReference } from '../../dataProvider';
+import { useDataProvider, useGetManyReference } from '../../dataProvider';
 import { useNotify } from '../../notification';
 import { FilterPayload, Identifier, RaRecord, SortPayload } from '../../types';
 import { ListControllerResult } from '../list';
@@ -68,6 +68,7 @@ export const useReferenceManyFieldController = <
     } = props;
     const notify = useNotify();
     const resource = useResourceContext(props);
+    const dataProvider = useDataProvider();
     const storeKey = props.storeKey ?? `${resource}.${record?.id}.${reference}`;
     const { meta, ...otherQueryOptions } = queryOptions;
 
@@ -201,10 +202,9 @@ export const useReferenceManyFieldController = <
         }
     );
 
-    const { data: allData, total: allDataTotal } =
-        useGetManyReference<ReferenceRecordType>(
-            reference,
-            {
+    const { mutate: onSelectAll } = useMutation({
+        mutationFn: () =>
+            dataProvider.useGetManyReference(reference, {
                 target,
                 id: get(record, source) as Identifier,
                 pagination: {
@@ -214,23 +214,21 @@ export const useReferenceManyFieldController = <
                 sort,
                 filter: filterValues,
                 meta,
-            },
-            {
-                enabled: get(record, source) != null,
-                ...otherQueryOptions,
+            }),
+        onSuccess: ({ data }) => {
+            const allIds = data?.map(({ id }) => id) || [];
+            selectionModifiers.select(allIds);
+            if (allIds.length === selectAllLimit) {
+                notify('ra.message.too_many_elements', {
+                    messageArgs: { max: selectAllLimit },
+                    type: 'warning',
+                });
             }
-        );
-
-    const onSelectAll = useCallback(() => {
-        const allIds = allData?.map(({ id }) => id) || [];
-        selectionModifiers.select(allIds);
-        if (allIds.length === selectAllLimit) {
-            notify('ra.message.too_many_elements', {
-                messageArgs: { max: selectAllLimit },
-                type: 'warning',
-            });
-        }
-    }, [allData, notify, selectAllLimit, selectionModifiers]);
+        },
+        onError: () => {
+            notify('An error occurred. Please try again.');
+        },
+    });
 
     return {
         sort,
@@ -253,7 +251,10 @@ export const useReferenceManyFieldController = <
         refetch,
         resource: reference,
         selectedIds,
-        areAllSelected: allDataTotal !== selectedIds.length,
+        areAllSelected: !(
+            total === selectedIds.length ||
+            selectedIds.length === selectAllLimit
+        ),
         setFilters,
         setPage,
         setPerPage,
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index d53aec698e6..1f6e71c7b95 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -1,9 +1,11 @@
-import { isValidElement, useCallback, useEffect, useMemo } from 'react';
+import { isValidElement, useEffect, useMemo } from 'react';
+import { useMutation } from '@tanstack/react-query';
 
 import { useAuthenticated, useRequireAccess } from '../../auth';
 import { useTranslate } from '../../i18n';
 import { useNotify } from '../../notification';
 import {
+    useDataProvider,
     useGetList,
     UseGetListHookValue,
     UseGetListOptions,
@@ -79,6 +81,7 @@ export const useListController = <RecordType extends RaRecord = any>(
 
     const translate = useTranslate();
     const notify = useNotify();
+    const dataProvider = useDataProvider();
 
     const [query, queryModifiers] = useListParams({
         debounce,
@@ -169,36 +172,31 @@ export const useListController = <RecordType extends RaRecord = any>(
         name: getResourceLabel(resource, 2),
     });
 
-    const { data: allData, total: allDataTotal } = useGetList<RecordType>(
-        resource,
-        {
-            pagination: {
-                page: 1,
-                perPage: selectAllLimit,
-            },
-            sort: { field: query.sort, order: query.order },
-            filter: { ...query.filter, ...filter },
-            meta,
+    const { mutate: onSelectAll } = useMutation({
+        mutationFn: () =>
+            dataProvider.getList(resource, {
+                pagination: {
+                    page: 1,
+                    perPage: selectAllLimit,
+                },
+                sort: { field: query.sort, order: query.order },
+                filter: { ...query.filter, ...filter },
+                meta,
+            }),
+        onSuccess: ({ data }) => {
+            const allIds = data?.map(({ id }) => id) || [];
+            selectionModifiers.select(allIds);
+            if (allIds.length === selectAllLimit) {
+                notify('ra.message.too_many_elements', {
+                    messageArgs: { max: selectAllLimit },
+                    type: 'warning',
+                });
+            }
         },
-        {
-            enabled:
-                (!isPendingAuthenticated && !isPendingCanAccess) ||
-                disableAuthentication,
-            retry: false,
-            ...otherQueryOptions,
-        }
-    );
-
-    const onSelectAll = useCallback(() => {
-        const allIds = allData?.map(({ id }) => id) || [];
-        selectionModifiers.select(allIds);
-        if (allIds.length === selectAllLimit) {
-            notify('ra.message.too_many_elements', {
-                messageArgs: { max: selectAllLimit },
-                type: 'warning',
-            });
-        }
-    }, [allData, notify, selectAllLimit, selectionModifiers]);
+        onError: () => {
+            notify('An error occurred. Please try again.');
+        },
+    });
 
     return {
         sort: currentSort,
@@ -223,13 +221,16 @@ export const useListController = <RecordType extends RaRecord = any>(
         refetch,
         resource,
         selectedIds,
-        areAllSelected: allDataTotal !== selectedIds.length,
+        areAllSelected: !(
+            total === selectedIds.length ||
+            selectedIds.length === selectAllLimit
+        ),
         setFilters: queryModifiers.setFilters,
         setPage: queryModifiers.setPage,
         setPerPage: queryModifiers.setPerPage,
         setSort: queryModifiers.setSort,
         showFilter: queryModifiers.showFilter,
-        total: total,
+        total,
         hasNextPage: pageInfo
             ? pageInfo.hasNextPage
             : total != null

From 651ac4b87471b54b11c3f5c817a155a0e449e557 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 22:57:16 +0100
Subject: [PATCH 012/146] display error + fix getManyReference call

---
 .../src/controller/field/useReferenceManyFieldController.ts  | 5 +++--
 .../ra-core/src/controller/list/useInfiniteListController.ts | 3 ++-
 packages/ra-core/src/controller/list/useListController.ts    | 3 ++-
 3 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 8aee8e82b2e..d8955065f2f 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -204,7 +204,7 @@ export const useReferenceManyFieldController = <
 
     const { mutate: onSelectAll } = useMutation({
         mutationFn: () =>
-            dataProvider.useGetManyReference(reference, {
+            dataProvider.getManyReference(reference, {
                 target,
                 id: get(record, source) as Identifier,
                 pagination: {
@@ -225,7 +225,8 @@ export const useReferenceManyFieldController = <
                 });
             }
         },
-        onError: () => {
+        onError: e => {
+            console.error('Mutation Error: ', e);
             notify('An error occurred. Please try again.');
         },
     });
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index d13d86495cb..3dd634511aa 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -164,7 +164,8 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
                 });
             }
         },
-        onError: () => {
+        onError: e => {
+            console.error('Mutation Error: ', e);
             notify('An error occurred. Please try again.');
         },
     });
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index 1f6e71c7b95..aecd51b9b28 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -193,7 +193,8 @@ export const useListController = <RecordType extends RaRecord = any>(
                 });
             }
         },
-        onError: () => {
+        onError: e => {
+            console.error('Mutation Error: ', e);
             notify('An error occurred. Please try again.');
         },
     });

From 73f8e7eb27435793d84fed0801b878acf1826f04 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 23:08:48 +0100
Subject: [PATCH 013/146] add stories for ReferenceManyField for Pagination and
 selectAllLimit

---
 .../src/field/ReferenceManyField.stories.tsx  | 30 ++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
index 10e1c809a86..f303fc15ddc 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
@@ -85,11 +85,15 @@ const defaultDataProvider = {
 
 const Wrapper = ({
     children,
+    i18nProvider,
     dataProvider = defaultDataProvider,
     record = author,
 }: any) => (
     <ThemeProvider theme={createTheme()}>
-        <CoreAdminContext dataProvider={dataProvider}>
+        <CoreAdminContext
+            dataProvider={dataProvider}
+            i18nProvider={i18nProvider}
+        >
             <ResourceContextProvider value="authors">
                 <RecordContextProvider value={record}>
                     <Box mx={2} mt={7}>
@@ -181,6 +185,30 @@ export const StoreKey = () => (
     </Wrapper>
 );
 
+export const WithPagination = props => (
+    <Wrapper
+        i18nProvider={polyglotI18nProvider(() => englishMessages)}
+        dataProvider={fullDataProvider}
+        record={authors[3]}
+    >
+        <ReferenceManyField
+            reference="books"
+            target="author_id"
+            pagination={<Pagination />}
+            perPage={5}
+            {...props}
+        >
+            <Datagrid>
+                <TextField source="title" />
+            </Datagrid>
+        </ReferenceManyField>
+    </Wrapper>
+);
+
+export const WithPaginationAndSelectAllLimit = () => (
+    <WithPagination selectAllLimit={6} />
+);
+
 const AuthorEdit = () => (
     <Edit>
         <SimpleForm>

From d2144819acb8ab958f9888381dd6b99b2d3df3f2 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 23:13:00 +0100
Subject: [PATCH 014/146] add stories for List with selectAllLimit

---
 .../src/list/List.stories.tsx                 | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/packages/ra-ui-materialui/src/list/List.stories.tsx b/packages/ra-ui-materialui/src/list/List.stories.tsx
index 37b99a26627..d8971bc2662 100644
--- a/packages/ra-ui-materialui/src/list/List.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/List.stories.tsx
@@ -296,6 +296,26 @@ export const HasCreate = () => (
     </TestMemoryRouter>
 );
 
+export const SelectAllLimit = () => (
+    <TestMemoryRouter initialEntries={['/books']}>
+        <Admin dataProvider={dataProvider}>
+            <Resource
+                name="books"
+                list={() => (
+                    <List selectAllLimit={11}>
+                        <Datagrid>
+                            <TextField source="id" />
+                            <TextField source="title" />
+                            <TextField source="author" />
+                            <TextField source="year" />
+                        </Datagrid>
+                    </List>
+                )}
+            />
+        </Admin>
+    </TestMemoryRouter>
+);
+
 const AsideComponent = () => <Card sx={{ padding: 2 }}>Aside</Card>;
 
 export const Aside = () => (

From 76d921466c50c4d965aba13de4e99ae9aaaa70c5 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 23:21:40 +0100
Subject: [PATCH 015/146] remove useless modification

---
 .../src/list/datagrid/Datagrid.stories.tsx    | 42 -------------------
 1 file changed, 42 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
index ae019027f3e..4cdc6d42fe5 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
@@ -64,48 +64,6 @@ const data = [
         author: 'Victor Hugo',
         year: 1862,
     },
-    {
-        id: 6,
-        title: 'Brave New World',
-        author: 'Aldous Huxley',
-        year: 1932,
-    },
-    {
-        id: 7,
-        title: 'The Great Gatsby',
-        author: 'F. Scott Fitzgerald',
-        year: 1925,
-    },
-    {
-        id: 8,
-        title: 'One Hundred Years of Solitude',
-        author: 'Gabriel García Márquez',
-        year: 1967,
-    },
-    {
-        id: 9,
-        title: "Harry Potter and the Philosopher's Stone",
-        author: 'J.K. Rowling',
-        year: 1997,
-    },
-    {
-        id: 10,
-        title: 'The Catcher in the Rye',
-        author: 'J.D. Salinger',
-        year: 1951,
-    },
-    {
-        id: 11,
-        title: 'The Lord of the Rings',
-        author: 'J.R.R. Tolkien',
-        year: 1954,
-    },
-    {
-        id: 12,
-        title: 'The Hobbit',
-        author: 'J.R.R. Tolkien',
-        year: 1937,
-    },
 ];
 
 const theme = createTheme();

From 1885e48c879d23776d05d7d1a36971f418ee226d Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 23:31:28 +0100
Subject: [PATCH 016/146] Fix Datagrid and ExpandAllButton tests

---
 .../ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
index 4cdc6d42fe5..86720dc5bf6 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
@@ -58,12 +58,6 @@ const data = [
         author: 'Antoine de Saint-Exupéry',
         year: 1943,
     },
-    {
-        id: 5,
-        title: 'Les Misérables',
-        author: 'Victor Hugo',
-        year: 1862,
-    },
 ];
 
 const theme = createTheme();

From 4c73b9cb82385e5927633d72cf00da3088e85a22 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 23:33:07 +0100
Subject: [PATCH 017/146] Fix BulkUpdateButton test

---
 .../ra-ui-materialui/src/button/BulkUpdateButton.spec.tsx     | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/button/BulkUpdateButton.spec.tsx b/packages/ra-ui-materialui/src/button/BulkUpdateButton.spec.tsx
index 298c96ecc5d..b8aed5e8303 100644
--- a/packages/ra-ui-materialui/src/button/BulkUpdateButton.spec.tsx
+++ b/packages/ra-ui-materialui/src/button/BulkUpdateButton.spec.tsx
@@ -8,7 +8,9 @@ describe('BulkUpdateButton', () => {
         it('should ask confirmation before updating in pessimistic mode', async () => {
             render(<MutationMode />);
             await screen.findByText('War and Peace');
-            const checkbox = await screen.findByLabelText('Select all');
+            const checkbox = await screen.findByRole('checkbox', {
+                name: 'Select all',
+            });
             checkbox.click();
             await screen.getByText('10 items selected');
             const button = screen.getByLabelText('Update Pessimistic');

From 548968d3fed0a09f4a81de8add5fde189d1a05f7 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 21 Nov 2024 23:38:26 +0100
Subject: [PATCH 018/146] add selectAllLimit to
 UseReferenceArrayFieldControllerParams to fix build

---
 .../src/controller/field/useReferenceArrayFieldController.ts     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.ts b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.ts
index af7bde8cfaf..840a8e9b4d3 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.ts
@@ -17,6 +17,7 @@ export interface UseReferenceArrayFieldControllerParams<
     resource?: string;
     sort?: SortPayload;
     source: string;
+    selectAllLimit?: number;
     queryOptions?: Omit<
         UseQueryOptions<ReferenceRecordType[]>,
         'queryFn' | 'queryKey'

From dd7cf02dbfdc39d45614044b4edfadeda627340f Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 22 Nov 2024 10:33:32 +0100
Subject: [PATCH 019/146] rename `areAllSelected` to `displaySelectAllButton`

---
 .../src/controller/field/useReferenceManyFieldController.ts | 2 +-
 packages/ra-core/src/controller/list/ListContext.tsx        | 2 +-
 .../src/controller/list/useInfiniteListController.ts        | 2 +-
 packages/ra-core/src/controller/list/useList.ts             | 2 +-
 .../ra-core/src/controller/list/useListContextWithProps.ts  | 6 +++---
 packages/ra-core/src/controller/list/useListController.ts   | 4 ++--
 packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx   | 4 ++--
 7 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index d8955065f2f..58286f57392 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -252,7 +252,7 @@ export const useReferenceManyFieldController = <
         refetch,
         resource: reference,
         selectedIds,
-        areAllSelected: !(
+        displaySelectAllButton: !(
             total === selectedIds.length ||
             selectedIds.length === selectAllLimit
         ),
diff --git a/packages/ra-core/src/controller/list/ListContext.tsx b/packages/ra-core/src/controller/list/ListContext.tsx
index 10d0d19fc2c..0b2a935de46 100644
--- a/packages/ra-core/src/controller/list/ListContext.tsx
+++ b/packages/ra-core/src/controller/list/ListContext.tsx
@@ -24,7 +24,7 @@ import { ListControllerResult } from './useListController';
  * @prop {Function} showFilter a callback to show one of the filters, e.g. showFilter('title', defaultValue)
  * @prop {Function} hideFilter a callback to hide one of the filters, e.g. hideFilter('title')
  * @prop {Array}    selectedIds an array listing the ids of the selected rows, e.g. [123, 456]
- * @prop {boolean}  areAllSelected boolean to indicate if the list is already fully selected
+ * @prop {boolean}  displaySelectAllButton boolean to indicate if the list is already fully selected
  * @prop {Function} onSelect callback to change the list of selected rows, e.g. onSelect([456, 789])
  * @prop {Function} onSelectAll callback to select all the records, e.g. onSelectAll()
  * @prop {Function} onToggleItem callback to toggle the selection of a given record based on its id, e.g. onToggleItem(456)
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index 3dd634511aa..d0b4343203c 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -233,7 +233,7 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         refetch,
         resource,
         selectedIds,
-        areAllSelected: !(
+        displaySelectAllButton: !(
             total === selectedIds.length ||
             selectedIds.length === selectAllLimit
         ),
diff --git a/packages/ra-core/src/controller/list/useList.ts b/packages/ra-core/src/controller/list/useList.ts
index 77af1829e9e..68250d927fe 100644
--- a/packages/ra-core/src/controller/list/useList.ts
+++ b/packages/ra-core/src/controller/list/useList.ts
@@ -298,7 +298,7 @@ export const useList = <RecordType extends RaRecord = any>(
         resource: '',
         refetch,
         selectedIds,
-        areAllSelected: data?.length !== selectedIds.length,
+        displaySelectAllButton: data?.length !== selectedIds.length,
         setFilters,
         setPage,
         setPerPage,
diff --git a/packages/ra-core/src/controller/list/useListContextWithProps.ts b/packages/ra-core/src/controller/list/useListContextWithProps.ts
index d4bcef919b2..e52b7b1240c 100644
--- a/packages/ra-core/src/controller/list/useListContextWithProps.ts
+++ b/packages/ra-core/src/controller/list/useListContextWithProps.ts
@@ -33,7 +33,7 @@ import { RaRecord } from '../../types';
  * @prop {Function} showFilter a callback to show one of the filters, e.g. showFilter('title', defaultValue)
  * @prop {Function} hideFilter a callback to hide one of the filters, e.g. hideFilter('title')
  * @prop {Array}    selectedIds an array listing the ids of the selected rows, e.g. [123, 456]
- * @prop {boolean}  areAllSelected boolean to indicate if the list is already fully selected
+ * @prop {boolean}  displaySelectAllButton boolean to indicate if the list is already fully selected
  * @prop {Function} onSelect callback to change the list of selected rows, e.g. onSelect([456, 789])
  * @prop {Function} onSelectAll callback to select all the records, e.g. onSelectAll()
  * @prop {Function} onToggleItem callback to toggle the selection of a given record based on its id, e.g. onToggleItem(456)
@@ -91,7 +91,7 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     refetch,
     resource,
     selectedIds,
-    areAllSelected,
+    displaySelectAllButton,
     setFilters,
     setPage,
     setPerPage,
@@ -119,7 +119,7 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     refetch,
     resource,
     selectedIds,
-    areAllSelected,
+    displaySelectAllButton,
     setFilters,
     setPage,
     setPerPage,
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index aecd51b9b28..38ae94c4043 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -222,7 +222,7 @@ export const useListController = <RecordType extends RaRecord = any>(
         refetch,
         resource,
         selectedIds,
-        areAllSelected: !(
+        displaySelectAllButton: !(
             total === selectedIds.length ||
             selectedIds.length === selectAllLimit
         ),
@@ -532,7 +532,7 @@ export interface ListControllerBaseResult<RecordType extends RaRecord = any> {
     refetch: (() => void) | UseGetListHookValue<RecordType>['refetch'];
     resource: string;
     selectedIds: RecordType['id'][];
-    areAllSelected: boolean;
+    displaySelectAllButton: boolean;
     setFilters: (
         filters: any,
         displayedFilters?: any,
diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index b39eaf69ceb..674dd6a0e4d 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -23,7 +23,7 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
         selectedIds = [],
         onUnselectItems,
         onSelectAll,
-        areAllSelected,
+        displaySelectAllButton,
     } = useListContext();
 
     const translate = useTranslate();
@@ -62,7 +62,7 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
                             smart_count: selectedIds.length,
                         })}
                     </Typography>
-                    {areAllSelected && (
+                    {displaySelectAllButton && (
                         <Button
                             label={translate('ra.action.select_all')}
                             onClick={handleSelectAll}

From 9eb0f1c66b0ffdd6db1251b76515a74bc715b96d Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 22 Nov 2024 16:54:47 +0100
Subject: [PATCH 020/146] test useListController

---
 .../list/useListController.spec.tsx           | 551 +++++++++++++++++-
 1 file changed, 550 insertions(+), 1 deletion(-)

diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index 25c533febf8..8e847e7ce70 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -9,13 +9,14 @@ import {
 } from '@testing-library/react';
 import { testDataProvider } from '../../dataProvider';
 import { memoryStore } from '../../store';
-import { CoreAdminContext } from '../../core';
+import { CoreAdminContext, CoreAdminUI, Resource } from '../../core';
 import { TestMemoryRouter } from '../../routing';
 import { AuthProvider } from '../../types';
 import { ListController } from './ListController';
 import {
     getListControllerProps,
     sanitizeListRestProps,
+    useListController,
 } from './useListController';
 import {
     Authenticated,
@@ -585,4 +586,552 @@ describe('useListController', () => {
             expect(authProvider.checkAuth).not.toHaveBeenCalled();
         });
     });
+
+    describe('displaySelectAllButton', () => {
+        it('should return true if no items are selected', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+                );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                    })
+                );
+            });
+        });
+        it('should return true if some items are selected', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+                );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
+                    })
+                );
+            });
+        });
+        it('should return false if all items are manually selected', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+                );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0, 1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should return false if all items are selected with onSelectAll', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+                );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should return false if all we manually reached the selectAllLimit', async () => {
+            const getList = jest.fn().mockImplementation(() =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                })
+            );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                selectAllLimit: 1,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
+                    })
+                );
+            });
+        });
+        it('should return false if all we reached the selectAllLimit with onSelectAll', async () => {
+            const getList = jest.fn().mockImplementation((_resource, params) =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }].slice(
+                        0,
+                        params.pagination.perPage
+                    ),
+                    total: 2,
+                })
+            );
+
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                selectAllLimit: 1,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
+                    })
+                );
+            });
+        });
+    });
+
+    describe('onSelectAll', () => {
+        it('should select all items if no items are selected', async () => {
+            const getList = jest.fn().mockImplementation(() =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                })
+            );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const getList = jest.fn().mockImplementation(() =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                })
+            );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    5,
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
+            const getList = jest.fn().mockImplementation((_resource, params) =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }].slice(
+                        0,
+                        params.pagination.perPage
+                    ),
+                    total: 2,
+                })
+            );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                selectAllLimit: 1,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(getList).toHaveBeenNthCalledWith(
+                    1,
+                    'posts',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 10 },
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(getList).toHaveBeenNthCalledWith(
+                    2,
+                    'posts',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 1 },
+                    })
+                );
+            });
+        });
+    });
 });

From 4546b6e5c44d955139b56df28e0e45e61d669057 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 22 Nov 2024 18:41:22 +0100
Subject: [PATCH 021/146] test useInfiniteListController

---
 .../list/useInfiniteListController.spec.tsx   | 548 ++++++++++++++++++
 1 file changed, 548 insertions(+)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index 936d8ef40b3..b504610a816 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -642,4 +642,552 @@ describe('useInfiniteListController', () => {
             expect(authProvider.checkAuth).toHaveBeenCalledTimes(1);
         });
     });
+
+    describe('displaySelectAllButton', () => {
+        it('should return true if no items are selected', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+                );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                    })
+                );
+            });
+        });
+        it('should return true if some items are selected', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+                );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
+                    })
+                );
+            });
+        });
+        it('should return false if all items are manually selected', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+                );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0, 1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should return false if all items are selected with onSelectAll', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+                );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should return false if all we manually reached the selectAllLimit', async () => {
+            const getList = jest.fn().mockImplementation(() =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                })
+            );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                selectAllLimit: 1,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
+                    })
+                );
+            });
+        });
+        it('should return false if all we reached the selectAllLimit with onSelectAll', async () => {
+            const getList = jest.fn().mockImplementation((_resource, params) =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }].slice(
+                        0,
+                        params.pagination.perPage
+                    ),
+                    total: 2,
+                })
+            );
+
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                selectAllLimit: 1,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
+                    })
+                );
+            });
+        });
+    });
+
+    describe('onSelectAll', () => {
+        it('should select all items if no items are selected', async () => {
+            const getList = jest.fn().mockImplementation(() =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                })
+            );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const getList = jest.fn().mockImplementation(() =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                })
+            );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    5,
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
+            const getList = jest.fn().mockImplementation((_resource, params) =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }].slice(
+                        0,
+                        params.pagination.perPage
+                    ),
+                    total: 2,
+                })
+            );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                selectAllLimit: 1,
+                children,
+            };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController {...props} />
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(getList).toHaveBeenNthCalledWith(
+                    1,
+                    'posts',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 10 },
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(getList).toHaveBeenNthCalledWith(
+                    2,
+                    'posts',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 1 },
+                    })
+                );
+            });
+        });
+    });
 });

From a374f052152bcb7e11e5549e61bb0b03ca659c7a Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 22 Nov 2024 19:03:35 +0100
Subject: [PATCH 022/146] test useReferenceArrayFieldController

---
 .../useReferenceArrayFieldController.spec.tsx | 377 +++++++++++++++++-
 1 file changed, 376 insertions(+), 1 deletion(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 0a06a926efc..d5562131b7c 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -1,6 +1,6 @@
 import * as React from 'react';
 import expect from 'expect';
-import { render, waitFor } from '@testing-library/react';
+import { act, render, waitFor } from '@testing-library/react';
 
 import { useReferenceArrayFieldController } from './useReferenceArrayFieldController';
 import { testDataProvider } from '../../dataProvider';
@@ -166,4 +166,379 @@ describe('<useReferenceArrayFieldController />', () => {
             })
         );
     });
+
+    describe('displaySelectAllButton', () => {
+        it('should return true if no items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceArrayFieldController
+                        resource="foo"
+                        reference="bar"
+                        record={{ id: 1, barIds: [1, 2] }}
+                        source="barIds"
+                    >
+                        {children}
+                    </ReferenceArrayFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
+                        total: 2,
+                    })
+                );
+            });
+        });
+        it('should return true if some items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceArrayFieldController
+                        resource="foo"
+                        reference="bar"
+                        record={{ id: 1, barIds: [1, 2] }}
+                        source="barIds"
+                    >
+                        {children}
+                    </ReferenceArrayFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
+                        total: 2,
+                        selectedIds: [1],
+                    })
+                );
+            });
+        });
+        it('should return false if all items are manually selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceArrayFieldController
+                        resource="foo"
+                        reference="bar"
+                        record={{ id: 1, barIds: [1, 2] }}
+                        source="barIds"
+                    >
+                        {children}
+                    </ReferenceArrayFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([1, 2]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
+                        total: 2,
+                        selectedIds: [1, 2],
+                    })
+                );
+            });
+        });
+        it('should return false if all items are selected with onSelectAll', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceArrayFieldController
+                        resource="foo"
+                        reference="bar"
+                        record={{ id: 1, barIds: [1, 2] }}
+                        source="barIds"
+                    >
+                        {children}
+                    </ReferenceArrayFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
+                        total: 2,
+                        selectedIds: [1, 2],
+                    })
+                );
+            });
+        });
+    });
+
+    describe('onSelectAll', () => {
+        it('should select all items if no items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceArrayFieldController
+                        resource="foo"
+                        reference="bar"
+                        record={{ id: 1, barIds: [1, 2] }}
+                        source="barIds"
+                    >
+                        {children}
+                    </ReferenceArrayFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [1, 2],
+                    })
+                );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceArrayFieldController
+                        resource="foo"
+                        reference="bar"
+                        record={{ id: 1, barIds: [1, 2] }}
+                        source="barIds"
+                    >
+                        {children}
+                    </ReferenceArrayFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [1],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    5,
+                    expect.objectContaining({
+                        selectedIds: [1, 2],
+                    })
+                );
+            });
+        });
+    });
 });

From 38261a7a3e0104777f94627b7f8c3996dc8293e8 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 22 Nov 2024 19:14:25 +0100
Subject: [PATCH 023/146] test useReferenceManyFieldController

---
 .../useReferenceManyFieldController.spec.tsx  | 571 +++++++++++++++++-
 .../list/useListController.spec.tsx           |   3 +-
 2 files changed, 571 insertions(+), 3 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index 64afc5570a4..5f923f3b783 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -1,5 +1,11 @@
 import * as React from 'react';
-import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import {
+    act,
+    fireEvent,
+    render,
+    screen,
+    waitFor,
+} from '@testing-library/react';
 import expect from 'expect';
 
 import { testDataProvider } from '../../dataProvider/testDataProvider';
@@ -412,4 +418,567 @@ describe('useReferenceManyFieldController', () => {
             );
         });
     });
+
+    describe('displaySelectAllButton', () => {
+        it('should return true if no items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            const dataProvider = testDataProvider({
+                getManyReference: jest.fn().mockResolvedValue({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                }),
+            });
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceManyFieldController
+                        resource="authors"
+                        source="id"
+                        record={{ id: 123, name: 'James Joyce' }}
+                        reference="books"
+                        target="author_id"
+                    >
+                        {children}
+                    </ReferenceManyFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                    })
+                );
+            });
+        });
+        it('should return true if some items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            const dataProvider = testDataProvider({
+                getManyReference: jest.fn().mockResolvedValue({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                }),
+            });
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceManyFieldController
+                        resource="authors"
+                        source="id"
+                        record={{ id: 123, name: 'James Joyce' }}
+                        reference="books"
+                        target="author_id"
+                    >
+                        {children}
+                    </ReferenceManyFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [1],
+                    })
+                );
+            });
+        });
+        it('should return false if all items are manually selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            const dataProvider = testDataProvider({
+                getManyReference: jest.fn().mockResolvedValue({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                }),
+            });
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceManyFieldController
+                        resource="authors"
+                        source="id"
+                        record={{ id: 123, name: 'James Joyce' }}
+                        reference="books"
+                        target="author_id"
+                    >
+                        {children}
+                    </ReferenceManyFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0, 1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should return false if all items are selected with onSelectAll', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            const dataProvider = testDataProvider({
+                getManyReference: jest.fn().mockResolvedValue({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                }),
+            });
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceManyFieldController
+                        resource="authors"
+                        source="id"
+                        record={{ id: 123, name: 'James Joyce' }}
+                        reference="books"
+                        target="author_id"
+                    >
+                        {children}
+                    </ReferenceManyFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should return false if all we manually reached the selectAllLimit', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            const dataProvider = testDataProvider({
+                getManyReference: jest.fn().mockResolvedValue({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                }),
+            });
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceManyFieldController
+                        resource="authors"
+                        source="id"
+                        record={{ id: 123, name: 'James Joyce' }}
+                        reference="books"
+                        target="author_id"
+                        selectAllLimit={1}
+                    >
+                        {children}
+                    </ReferenceManyFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
+                    })
+                );
+            });
+        });
+        it('should return false if all we reached the selectAllLimit with onSelectAll', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            const dataProvider = testDataProvider({
+                getManyReference: jest
+                    .fn()
+                    .mockImplementation((_resource, params) =>
+                        Promise.resolve({
+                            data: [{ id: 0 }, { id: 1 }].slice(
+                                0,
+                                params.pagination.perPage
+                            ),
+                            total: 2,
+                        })
+                    ),
+            });
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceManyFieldController
+                        resource="authors"
+                        source="id"
+                        record={{ id: 123, name: 'James Joyce' }}
+                        reference="books"
+                        target="author_id"
+                        selectAllLimit={1}
+                    >
+                        {children}
+                    </ReferenceManyFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
+                    })
+                );
+            });
+        });
+    });
+
+    describe('onSelectAll', () => {
+        it('should select all items if no items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            const dataProvider = testDataProvider({
+                getManyReference: jest.fn().mockResolvedValue({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                }),
+            });
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceManyFieldController
+                        resource="authors"
+                        source="id"
+                        record={{ id: 123, name: 'James Joyce' }}
+                        reference="books"
+                        target="author_id"
+                        selectAllLimit={1}
+                    >
+                        {children}
+                    </ReferenceManyFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            const dataProvider = testDataProvider({
+                getManyReference: jest.fn().mockResolvedValue({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                }),
+            });
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceManyFieldController
+                        resource="authors"
+                        source="id"
+                        record={{ id: 123, name: 'James Joyce' }}
+                        reference="books"
+                        target="author_id"
+                        selectAllLimit={1}
+                    >
+                        {children}
+                    </ReferenceManyFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [1],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [1],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            const getManyReference = jest
+                .fn()
+                .mockImplementation((_resource, params) =>
+                    Promise.resolve({
+                        data: [{ id: 0 }, { id: 1 }].slice(
+                            0,
+                            params.pagination.perPage
+                        ),
+                        total: 2,
+                    })
+                );
+            const dataProvider = testDataProvider({ getManyReference });
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <ReferenceManyFieldController
+                        resource="authors"
+                        source="id"
+                        record={{ id: 123, name: 'James Joyce' }}
+                        reference="books"
+                        target="author_id"
+                        selectAllLimit={1}
+                    >
+                        {children}
+                    </ReferenceManyFieldController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(getManyReference).toHaveBeenNthCalledWith(
+                    1,
+                    'books',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 25 },
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(getManyReference).toHaveBeenNthCalledWith(
+                    2,
+                    'books',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 1 },
+                    })
+                );
+            });
+        });
+    });
 });
diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index 8e847e7ce70..79b6d794681 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -9,14 +9,13 @@ import {
 } from '@testing-library/react';
 import { testDataProvider } from '../../dataProvider';
 import { memoryStore } from '../../store';
-import { CoreAdminContext, CoreAdminUI, Resource } from '../../core';
+import { CoreAdminContext } from '../../core';
 import { TestMemoryRouter } from '../../routing';
 import { AuthProvider } from '../../types';
 import { ListController } from './ListController';
 import {
     getListControllerProps,
     sanitizeListRestProps,
-    useListController,
 } from './useListController';
 import {
     Authenticated,

From 7d73c0dc816b7fb41e2104860ff395d4614e0844 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 22 Nov 2024 19:16:18 +0100
Subject: [PATCH 024/146] test useList

---
 .../src/controller/list/useList.spec.tsx      | 227 +++++++++++++++++-
 1 file changed, 226 insertions(+), 1 deletion(-)

diff --git a/packages/ra-core/src/controller/list/useList.spec.tsx b/packages/ra-core/src/controller/list/useList.spec.tsx
index 5d96aada58e..40f8d5a36af 100644
--- a/packages/ra-core/src/controller/list/useList.spec.tsx
+++ b/packages/ra-core/src/controller/list/useList.spec.tsx
@@ -3,7 +3,7 @@ import { ReactNode } from 'react';
 import expect from 'expect';
 
 import { useList, UseListOptions, UseListValue } from './useList';
-import { fireEvent, render, waitFor } from '@testing-library/react';
+import { act, fireEvent, render, waitFor } from '@testing-library/react';
 import { ListContextProvider } from './ListContextProvider';
 import { useListContext } from './useListContext';
 
@@ -315,4 +315,229 @@ describe('<useList />', () => {
             );
         });
     });
+
+    describe('displaySelectAllButton', () => {
+        it('should return true if no items are selected', async () => {
+            const children = jest.fn();
+            const data = [{ id: 0 }, { id: 1 }];
+            render(<UseList data={data} callback={children} />);
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                    })
+                );
+            });
+        });
+        it('should return true if some items are selected', async () => {
+            const children = jest.fn();
+            const data = [{ id: 0 }, { id: 1 }];
+            render(<UseList data={data} callback={children} />);
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [1],
+                    })
+                );
+            });
+        });
+        it('should return false if all items are manually selected', async () => {
+            const children = jest.fn();
+            const data = [{ id: 0 }, { id: 1 }];
+            render(<UseList data={data} callback={children} />);
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0, 1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should return false if all items are selected with onSelectAll', async () => {
+            const children = jest.fn();
+            const data = [{ id: 0 }, { id: 1 }];
+            render(<UseList data={data} callback={children} />);
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+    });
+
+    describe('onSelectAll', () => {
+        it('should select all items if no items are selected', async () => {
+            const children = jest.fn();
+            const data = [{ id: 0 }, { id: 1 }];
+            render(<UseList data={data} callback={children} />);
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const children = jest.fn();
+            const data = [{ id: 0 }, { id: 1 }];
+            render(<UseList data={data} callback={children} />);
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [1],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+    });
 });

From 4182bb6b16df6beda2b17a04d5ae42859d4b2d61 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 22 Nov 2024 19:58:06 +0100
Subject: [PATCH 025/146] do not display "Select all" button if nb selected
 items > selectAllLimit

---
 .../src/controller/field/useReferenceManyFieldController.ts    | 3 +--
 .../ra-core/src/controller/list/useInfiniteListController.ts   | 3 +--
 packages/ra-core/src/controller/list/useListController.ts      | 3 +--
 3 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 58286f57392..98aebbe0770 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -253,8 +253,7 @@ export const useReferenceManyFieldController = <
         resource: reference,
         selectedIds,
         displaySelectAllButton: !(
-            total === selectedIds.length ||
-            selectedIds.length === selectAllLimit
+            total === selectedIds.length || selectedIds.length >= selectAllLimit
         ),
         setFilters,
         setPage,
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index d0b4343203c..c7967d60228 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -234,8 +234,7 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         resource,
         selectedIds,
         displaySelectAllButton: !(
-            total === selectedIds.length ||
-            selectedIds.length === selectAllLimit
+            total === selectedIds.length || selectedIds.length >= selectAllLimit
         ),
         setFilters: queryModifiers.setFilters,
         setPage: queryModifiers.setPage,
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index 38ae94c4043..86c5bcbe8a4 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -223,8 +223,7 @@ export const useListController = <RecordType extends RaRecord = any>(
         resource,
         selectedIds,
         displaySelectAllButton: !(
-            total === selectedIds.length ||
-            selectedIds.length === selectAllLimit
+            total === selectedIds.length || selectedIds.length >= selectAllLimit
         ),
         setFilters: queryModifiers.setFilters,
         setPage: queryModifiers.setPage,

From 4f28a99243a96516a34bf989704509adefb3540f Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 22 Nov 2024 20:22:27 +0100
Subject: [PATCH 026/146] test `<List>`

---
 .../ra-ui-materialui/src/list/List.spec.tsx   | 143 ++++++++++++++++++
 .../src/list/List.stories.tsx                 |  52 ++++---
 2 files changed, 172 insertions(+), 23 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/List.spec.tsx b/packages/ra-ui-materialui/src/list/List.spec.tsx
index 5e117560977..3ca2a4c3765 100644
--- a/packages/ra-ui-materialui/src/list/List.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/List.spec.tsx
@@ -20,6 +20,8 @@ import {
     TitleFalse,
     TitleElement,
     PartialPagination,
+    Default,
+    SelectAllLimit,
 } from './List.stories';
 
 const theme = createTheme(defaultTheme);
@@ -340,4 +342,145 @@ describe('<List />', () => {
             screen.getByText('Books');
         });
     });
+
+    describe('"Select all" button', () => {
+        it('should be displayed if an item is selected', async () => {
+            render(<Default />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[1]);
+            expect(
+                await screen.findByRole('button', { name: 'Select all' })
+            ).toBeDefined();
+        });
+        it('should not be displayed if all item are manyally selected', async () => {
+            render(
+                <Default
+                    dataProvider={testDataProvider({
+                        getList: () =>
+                            Promise.resolve<any>({
+                                data: [
+                                    {
+                                        id: 0,
+                                        title: 'War and Peace',
+                                        author: 'Leo Tolstoy',
+                                        year: 1869,
+                                    },
+                                    {
+                                        id: 1,
+                                        title: 'Pride and Prejudice',
+                                        author: 'Jane Austen',
+                                        year: 1813,
+                                    },
+                                ],
+                                total: 2,
+                            }),
+                    })}
+                />
+            );
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(3);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('2 items selected');
+            expect(
+                screen.queryByRole('button', { name: 'Select all' })
+            ).toBeNull();
+        });
+        it('should not be displayed if all item are selected with the "Select all" button', async () => {
+            render(<Default />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('10 items selected');
+            fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
+            await screen.findByText('13 items selected');
+            expect(
+                screen.queryByRole('button', { name: 'Select all' })
+            ).toBeNull();
+        });
+        it('should not be displayed if we reached de selectAllLimit by a manyally selection', async () => {
+            render(
+                <SelectAllLimit
+                    selectAllLimit={2}
+                    dataProvider={testDataProvider({
+                        getList: () =>
+                            Promise.resolve<any>({
+                                data: [
+                                    {
+                                        id: 0,
+                                        title: 'War and Peace',
+                                        author: 'Leo Tolstoy',
+                                        year: 1869,
+                                    },
+                                    {
+                                        id: 1,
+                                        title: 'Pride and Prejudice',
+                                        author: 'Jane Austen',
+                                        year: 1813,
+                                    },
+                                    {
+                                        id: 2,
+                                        title: 'The Picture of Dorian Gray',
+                                        author: 'Oscar Wilde',
+                                        year: 1890,
+                                    },
+                                ],
+                                total: 3,
+                            }),
+                    })}
+                />
+            );
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(4);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[1]);
+            fireEvent.click(screen.getAllByRole('checkbox')[2]);
+            await screen.findByText('2 items selected');
+            expect(
+                screen.queryByRole('button', { name: 'Select all' })
+            ).toBeNull();
+        });
+        it('should not be displayed if we reached de selectAllLimit by a  click on the "Select all" button', async () => {
+            render(<SelectAllLimit />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[1]);
+            await screen.findByText('1 item selected');
+            fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
+            await screen.findByText('11 items selected');
+            await screen.findByText(
+                'Warning: There are too many elements to select them all. Only the first 11 elements were selected.'
+            );
+            expect(
+                screen.queryByRole('button', { name: 'Select all' })
+            ).toBeNull();
+        });
+        it('should select all items', async () => {
+            render(<Default />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('10 items selected');
+            fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
+            await screen.findByText('13 items selected');
+        });
+        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
+            render(<SelectAllLimit />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('10 items selected');
+            fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
+            await screen.findByText('11 items selected');
+            await screen.findByText(
+                'Warning: There are too many elements to select them all. Only the first 11 elements were selected.'
+            );
+        });
+    });
 });
diff --git a/packages/ra-ui-materialui/src/list/List.stories.tsx b/packages/ra-ui-materialui/src/list/List.stories.tsx
index d8971bc2662..3c315ae0eb8 100644
--- a/packages/ra-ui-materialui/src/list/List.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/List.stories.tsx
@@ -134,7 +134,7 @@ const data = {
     authors: [],
 };
 
-const dataProvider = fakeRestDataProvider(data);
+const defaultDataProvider = fakeRestDataProvider(data);
 
 const BookList = () => {
     const { error, isPending } = useListContext();
@@ -155,7 +155,7 @@ const BookList = () => {
 
 export const Basic = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -170,7 +170,7 @@ export const Basic = () => (
 
 export const Actions = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -191,7 +191,7 @@ export const Actions = () => (
 
 export const Filters = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -223,7 +223,7 @@ export const Filters = () => (
 
 export const Filter = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -238,7 +238,7 @@ export const Filter = () => (
 
 export const Title = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -253,7 +253,7 @@ export const Title = () => (
 
 export const TitleElement = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -268,7 +268,7 @@ export const TitleElement = () => (
 
 export const TitleFalse = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -283,7 +283,7 @@ export const TitleFalse = () => (
 
 export const HasCreate = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -296,13 +296,16 @@ export const HasCreate = () => (
     </TestMemoryRouter>
 );
 
-export const SelectAllLimit = () => (
+export const SelectAllLimit = ({
+    dataProvider = defaultDataProvider,
+    selectAllLimit = 11,
+}) => (
     <TestMemoryRouter initialEntries={['/books']}>
         <Admin dataProvider={dataProvider}>
             <Resource
                 name="books"
                 list={() => (
-                    <List selectAllLimit={11}>
+                    <List selectAllLimit={selectAllLimit}>
                         <Datagrid>
                             <TextField source="id" />
                             <TextField source="title" />
@@ -320,7 +323,7 @@ const AsideComponent = () => <Card sx={{ padding: 2 }}>Aside</Card>;
 
 export const Aside = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -344,7 +347,7 @@ const CustomWrapper = ({ children }) => (
 
 export const Component = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -392,7 +395,7 @@ export const PartialPagination = () => (
 
 export const Empty = () => (
     <TestMemoryRouter initialEntries={['/authors']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="authors"
                 list={() => (
@@ -436,7 +439,7 @@ export const EmptyPartialPagination = () => (
 
 export const SX = () => (
     <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
+        <Admin dataProvider={defaultDataProvider}>
             <Resource
                 name="books"
                 list={() => (
@@ -461,10 +464,10 @@ export const Meta = () => (
         <Admin
             dataProvider={
                 {
-                    ...dataProvider,
+                    ...defaultDataProvider,
                     getList: (resource, params) => {
                         console.log('getList', resource, params);
-                        return dataProvider.getList(resource, params);
+                        return defaultDataProvider.getList(resource, params);
                     },
                 } as any
             }
@@ -486,7 +489,7 @@ export const Meta = () => (
     </TestMemoryRouter>
 );
 
-export const Default = () => (
+export const Default = ({ dataProvider = defaultDataProvider }) => (
     <TestMemoryRouter initialEntries={['/books']}>
         <Admin dataProvider={dataProvider}>
             <Resource
@@ -561,7 +564,7 @@ const StoreKeyDashboard = () => (
 
 export const StoreKey = () => (
     <TestMemoryRouter initialEntries={['/']}>
-        <Admin dataProvider={dataProvider} dashboard={StoreKeyDashboard}>
+        <Admin dataProvider={defaultDataProvider} dashboard={StoreKeyDashboard}>
             <CustomRoutes>
                 <Route path="/newerBooks" element={<NewerBooks />} />
                 <Route path="/olderBooks" element={<OlderBooks />} />
@@ -628,7 +631,7 @@ export const StoreDisabled = () => {
     return (
         <TestMemoryRouter initialEntries={['/']}>
             <Admin
-                dataProvider={dataProvider}
+                dataProvider={defaultDataProvider}
                 dashboard={DisabledStoreDashboard}
             >
                 <CustomRoutes>
@@ -669,7 +672,7 @@ export const LocationNotSyncWithStore = () => {
 
     return (
         <TestMemoryRouter initialEntries={['/']}>
-            <Admin dataProvider={dataProvider}>
+            <Admin dataProvider={defaultDataProvider}>
                 <Resource
                     name="books"
                     list={<BooksWithLocationDisabled />}
@@ -751,9 +754,12 @@ export const ResponseMetadata = () => (
     <TestMemoryRouter initialEntries={['/books']}>
         <Admin
             dataProvider={{
-                ...dataProvider,
+                ...defaultDataProvider,
                 getList: async (resource, params) => {
-                    const result = await dataProvider.getList(resource, params);
+                    const result = await defaultDataProvider.getList(
+                        resource,
+                        params
+                    );
                     return {
                         ...result,
                         meta: {

From c49c28cc98bda47ed7990635a4c0e8cbd860db36 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 22 Nov 2024 20:35:14 +0100
Subject: [PATCH 027/146] test `<ReferenceManyField>` + fix ts issues

---
 .../src/field/ReferenceManyField.spec.tsx     | 160 +++++++++++++++++-
 .../src/field/ReferenceManyField.stories.tsx  |  27 ++-
 2 files changed, 174 insertions(+), 13 deletions(-)

diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
index 6f7e3c6ac1d..a7d40bd6aab 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
@@ -9,7 +9,11 @@ import { ReferenceManyField } from './ReferenceManyField';
 import { TextField } from './TextField';
 import { SingleFieldList } from '../list/SingleFieldList';
 import { Pagination } from '../list/pagination/Pagination';
-import { Basic } from './ReferenceManyField.stories';
+import {
+    Basic,
+    WithPagination,
+    WithPaginationAndSelectAllLimit,
+} from './ReferenceManyField.stories';
 
 const theme = createTheme();
 
@@ -35,7 +39,7 @@ describe('<ReferenceManyField />', () => {
                 <AdminContext
                     dataProvider={testDataProvider({
                         getManyReference: () =>
-                            Promise.resolve({ data, total: 2 }),
+                            Promise.resolve<any>({ data, total: 2 }),
                     })}
                 >
                     <ThemeProvider theme={theme}>
@@ -79,7 +83,8 @@ describe('<ReferenceManyField />', () => {
         render(
             <AdminContext
                 dataProvider={testDataProvider({
-                    getManyReference: () => Promise.resolve({ data, total: 2 }),
+                    getManyReference: () =>
+                        Promise.resolve<any>({ data, total: 2 }),
                 })}
             >
                 <ThemeProvider theme={theme}>
@@ -129,7 +134,7 @@ describe('<ReferenceManyField />', () => {
                 <AdminContext
                     dataProvider={testDataProvider({
                         getManyReference: () =>
-                            Promise.resolve({ data, total: 2 }),
+                            Promise.resolve<any>({ data, total: 2 }),
                     })}
                 >
                     <ReferenceManyField {...defaultProps}>
@@ -162,7 +167,7 @@ describe('<ReferenceManyField />', () => {
                 <AdminContext
                     dataProvider={testDataProvider({
                         getManyReference: () =>
-                            Promise.resolve({ data, total: 2 }),
+                            Promise.resolve<any>({ data, total: 2 }),
                     })}
                 >
                     <ReferenceManyField {...defaultProps}>
@@ -211,7 +216,7 @@ describe('<ReferenceManyField />', () => {
                     <AdminContext
                         dataProvider={testDataProvider({
                             getManyReference: () =>
-                                Promise.resolve({ data, total: 12 }),
+                                Promise.resolve<any>({ data, total: 12 }),
                         })}
                     >
                         <ReferenceManyField
@@ -241,7 +246,7 @@ describe('<ReferenceManyField />', () => {
                     <AdminContext
                         dataProvider={testDataProvider({
                             getManyReference: () =>
-                                Promise.resolve({
+                                Promise.resolve<any>({
                                     data,
                                     pageInfo: {
                                         hasPreviousPage: false,
@@ -268,4 +273,145 @@ describe('<ReferenceManyField />', () => {
             await screen.findByLabelText('ra.navigation.next');
         });
     });
+
+    describe('"Select all" button', () => {
+        it('should be displayed if an item is selected', async () => {
+            render(<WithPagination />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[1]);
+            expect(
+                await screen.findByRole('button', { name: 'Select all' })
+            ).toBeDefined();
+        });
+        it('should not be displayed if all item are manyally selected', async () => {
+            render(
+                <WithPagination
+                    dataProvider={testDataProvider({
+                        getManyReference: () =>
+                            Promise.resolve<any>({
+                                data: [
+                                    {
+                                        id: 0,
+                                        title: 'War and Peace',
+                                        author: 'Leo Tolstoy',
+                                        year: 1869,
+                                    },
+                                    {
+                                        id: 1,
+                                        title: 'Pride and Prejudice',
+                                        author: 'Jane Austen',
+                                        year: 1813,
+                                    },
+                                ],
+                                total: 2,
+                            }),
+                    })}
+                />
+            );
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(3);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('2 items selected');
+            expect(
+                screen.queryByRole('button', { name: 'Select all' })
+            ).toBeNull();
+        });
+        it('should not be displayed if all item are selected with the "Select all" button', async () => {
+            render(<WithPagination />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('5 items selected');
+            fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
+            await screen.findByText('7 items selected');
+            expect(
+                screen.queryByRole('button', { name: 'Select all' })
+            ).toBeNull();
+        });
+        it('should not be displayed if we reached de selectAllLimit by a manyally selection', async () => {
+            render(
+                <WithPaginationAndSelectAllLimit
+                    selectAllLimit={2}
+                    dataProvider={testDataProvider({
+                        getManyReference: () =>
+                            Promise.resolve<any>({
+                                data: [
+                                    {
+                                        id: 0,
+                                        title: 'War and Peace',
+                                        author: 'Leo Tolstoy',
+                                        year: 1869,
+                                    },
+                                    {
+                                        id: 1,
+                                        title: 'Pride and Prejudice',
+                                        author: 'Jane Austen',
+                                        year: 1813,
+                                    },
+                                    {
+                                        id: 2,
+                                        title: 'The Picture of Dorian Gray',
+                                        author: 'Oscar Wilde',
+                                        year: 1890,
+                                    },
+                                ],
+                                total: 3,
+                            }),
+                    })}
+                />
+            );
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(4);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[1]);
+            fireEvent.click(screen.getAllByRole('checkbox')[2]);
+            await screen.findByText('2 items selected');
+            expect(
+                screen.queryByRole('button', { name: 'Select all' })
+            ).toBeNull();
+        });
+        it('should not be displayed if we reached de selectAllLimit by a  click on the "Select all" button', async () => {
+            render(<WithPaginationAndSelectAllLimit />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[1]);
+            await screen.findByText('1 item selected');
+            fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
+            await screen.findByText('6 items selected');
+            await screen.findByText(
+                'Warning: There are too many elements to select them all. Only the first 6 elements were selected.'
+            );
+            expect(
+                screen.queryByRole('button', { name: 'Select all' })
+            ).toBeNull();
+        });
+        it('should select all items', async () => {
+            render(<WithPagination />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('5 items selected');
+            fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
+            await screen.findByText('7 items selected');
+        });
+        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
+            render(<WithPaginationAndSelectAllLimit />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('5 items selected');
+            fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
+            await screen.findByText('6 items selected');
+            await screen.findByText(
+                'Warning: There are too many elements to select them all. Only the first 6 elements were selected.'
+            );
+        });
+    });
 });
diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
index f303fc15ddc..d54f482a511 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
@@ -6,7 +6,7 @@ import {
     ResourceContextProvider,
     TestMemoryRouter,
 } from 'ra-core';
-import { Admin, ListGuesser, Resource } from 'react-admin';
+import { Admin, AdminProps, ListGuesser, Resource } from 'react-admin';
 import { ThemeProvider, Box, Stack } from '@mui/material';
 import { createTheme } from '@mui/material/styles';
 import fakeDataProvider from 'ra-data-fakerest';
@@ -185,10 +185,16 @@ export const StoreKey = () => (
     </Wrapper>
 );
 
-export const WithPagination = props => (
+export const WithPagination = ({
+    dataProvider = fullDataProvider,
+    selectAllLimit,
+}: {
+    dataProvider?: AdminProps['dataProvider'];
+    selectAllLimit?: number;
+}) => (
     <Wrapper
         i18nProvider={polyglotI18nProvider(() => englishMessages)}
-        dataProvider={fullDataProvider}
+        dataProvider={dataProvider}
         record={authors[3]}
     >
         <ReferenceManyField
@@ -196,7 +202,7 @@ export const WithPagination = props => (
             target="author_id"
             pagination={<Pagination />}
             perPage={5}
-            {...props}
+            selectAllLimit={selectAllLimit}
         >
             <Datagrid>
                 <TextField source="title" />
@@ -205,8 +211,17 @@ export const WithPagination = props => (
     </Wrapper>
 );
 
-export const WithPaginationAndSelectAllLimit = () => (
-    <WithPagination selectAllLimit={6} />
+export const WithPaginationAndSelectAllLimit = ({
+    dataProvider,
+    selectAllLimit = 6,
+}: {
+    dataProvider?: AdminProps['dataProvider'];
+    selectAllLimit?: number;
+}) => (
+    <WithPagination
+        selectAllLimit={selectAllLimit}
+        dataProvider={dataProvider}
+    />
 );
 
 const AuthorEdit = () => (

From 56db3397d1cc5aed7811ea54ff5a0e3e894a06da Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 22 Nov 2024 20:46:23 +0100
Subject: [PATCH 028/146] test `<ReferenceArrayField>` + fix ts issues

---
 .../src/field/ReferenceArrayField.spec.tsx    | 149 +++++++++++++-----
 1 file changed, 113 insertions(+), 36 deletions(-)

diff --git a/packages/ra-ui-materialui/src/field/ReferenceArrayField.spec.tsx b/packages/ra-ui-materialui/src/field/ReferenceArrayField.spec.tsx
index dfb11201309..d5ed9e9180e 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceArrayField.spec.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceArrayField.spec.tsx
@@ -1,6 +1,12 @@
 import * as React from 'react';
 import expect from 'expect';
-import { render, screen, act, waitFor } from '@testing-library/react';
+import {
+    render,
+    screen,
+    act,
+    waitFor,
+    fireEvent,
+} from '@testing-library/react';
 import {
     ListContextProvider,
     CoreAdminContext,
@@ -8,6 +14,7 @@ import {
     useRecordContext,
     useListContext,
     TestMemoryRouter,
+    testDataProvider,
 } from 'ra-core';
 import { createTheme, ThemeProvider } from '@mui/material/styles';
 
@@ -18,7 +25,10 @@ import {
 import { TextField } from './TextField';
 import { SingleFieldList } from '../list';
 import { AdminContext } from '../AdminContext';
-import { DifferentIdTypes } from './ReferenceArrayField.stories';
+import {
+    DifferentIdTypes,
+    WithPagination,
+} from './ReferenceArrayField.stories';
 
 const theme = createTheme({});
 
@@ -27,11 +37,13 @@ describe('<ReferenceArrayField />', () => {
         render(
             <ThemeProvider theme={theme}>
                 <ListContextProvider
-                    value={{
-                        resource: 'foo',
-                        data: null,
-                        isPending: true,
-                    }}
+                    value={
+                        {
+                            resource: 'foo',
+                            data: null,
+                            isPending: true,
+                        } as any
+                    }
                 >
                     <ReferenceArrayFieldView
                         source="barIds"
@@ -59,11 +71,13 @@ describe('<ReferenceArrayField />', () => {
             <TestMemoryRouter>
                 <ThemeProvider theme={theme}>
                     <ListContextProvider
-                        value={{
-                            resource: 'foo',
-                            data,
-                            isLoading: false,
-                        }}
+                        value={
+                            {
+                                resource: 'foo',
+                                data,
+                                isLoading: false,
+                            } as any
+                        }
                     >
                         <ReferenceArrayFieldView
                             source="barIds"
@@ -88,11 +102,13 @@ describe('<ReferenceArrayField />', () => {
         const { queryAllByRole, container } = render(
             <ThemeProvider theme={theme}>
                 <ListContextProvider
-                    value={{
-                        resource: 'foo',
-                        data: [],
-                        isLoading: false,
-                    }}
+                    value={
+                        {
+                            resource: 'foo',
+                            data: [],
+                            isLoading: false,
+                        } as any
+                    }
                 >
                     <ReferenceArrayFieldView
                         source="barIds"
@@ -119,11 +135,13 @@ describe('<ReferenceArrayField />', () => {
             <TestMemoryRouter>
                 <ThemeProvider theme={theme}>
                     <ListContextProvider
-                        value={{
-                            resource: 'foo',
-                            data,
-                            isLoading: false,
-                        }}
+                        value={
+                            {
+                                resource: 'foo',
+                                data,
+                                isLoading: false,
+                            } as any
+                        }
                     >
                         <ReferenceArrayFieldView
                             record={{ id: 123, barIds: ['abc-1', 'abc-2'] }}
@@ -153,11 +171,13 @@ describe('<ReferenceArrayField />', () => {
             <TestMemoryRouter>
                 <ThemeProvider theme={theme}>
                     <ListContextProvider
-                        value={{
-                            resource: 'foo',
-                            data,
-                            isLoading: false,
-                        }}
+                        value={
+                            {
+                                resource: 'foo',
+                                data,
+                                isLoading: false,
+                            } as any
+                        }
                     >
                         <ReferenceArrayFieldView
                             record={{ id: 123, barIds: [1, 2] }}
@@ -174,7 +194,7 @@ describe('<ReferenceArrayField />', () => {
             </TestMemoryRouter>
         );
         expect(queryAllByRole('progressbar')).toHaveLength(0);
-        expect(container.firstChild.textContent).not.toBeUndefined();
+        expect(container.firstChild?.textContent).not.toBeUndefined();
         expect(getByText('hello')).not.toBeNull();
         expect(getByText('world')).not.toBeNull();
     });
@@ -188,11 +208,13 @@ describe('<ReferenceArrayField />', () => {
             <TestMemoryRouter>
                 <ThemeProvider theme={theme}>
                     <ListContextProvider
-                        value={{
-                            resource: 'foo',
-                            data,
-                            isLoading: false,
-                        }}
+                        value={
+                            {
+                                resource: 'foo',
+                                data,
+                                isLoading: false,
+                            } as any
+                        }
                     >
                         <ReferenceArrayFieldView
                             record={{ id: 123, barIds: [1, 2] }}
@@ -255,16 +277,16 @@ describe('<ReferenceArrayField />', () => {
     });
 
     it('should accept more than one child', async () => {
-        const dataProvider = {
+        const dataProvider = testDataProvider({
             getMany: () =>
-                Promise.resolve({
+                Promise.resolve<any>({
                     data: [
                         { id: 4, title: 'programming' },
                         { id: 8, title: 'management' },
                         { id: 12, title: 'design' },
                     ],
                 }),
-        };
+        });
         const ListContextWatcher = () => {
             const { data } = useListContext();
             if (!data) return null;
@@ -310,4 +332,59 @@ describe('<ReferenceArrayField />', () => {
         expect(await screen.findByText('artist_2')).not.toBeNull();
         expect(await screen.findByText('artist_3')).not.toBeNull();
     });
+
+    describe('"Select all" button', () => {
+        it('should be displayed if an item is selected', async () => {
+            render(<WithPagination />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[1]);
+            expect(
+                await screen.findByRole('button', { name: 'Select all' })
+            ).toBeDefined();
+        });
+        it('should not be displayed if all item are manyally selected', async () => {
+            render(<WithPagination />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('5 items selected');
+            fireEvent.click(
+                screen.getByRole('button', { name: 'Go to next page' })
+            );
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(4);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('8 items selected');
+            expect(
+                screen.queryByRole('button', { name: 'Select all' })
+            ).toBeNull();
+        });
+        it('should not be displayed if all item are selected with the "Select all" button', async () => {
+            render(<WithPagination />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('5 items selected');
+            fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
+            await screen.findByText('8 items selected');
+            expect(
+                screen.queryByRole('button', { name: 'Select all' })
+            ).toBeNull();
+        });
+        it('should select all items', async () => {
+            render(<WithPagination />);
+            await waitFor(() => {
+                expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
+            });
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('5 items selected');
+            fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
+            await screen.findByText('8 items selected');
+        });
+    });
 });

From f82dd52cfc227fc49cf194fde798e0ae0820bc14 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Mon, 25 Nov 2024 20:18:50 +0100
Subject: [PATCH 029/146] fix useInfiniteListController tests

---
 .../list/useInfiniteListController.spec.tsx   | 1579 ++++++++---------
 1 file changed, 789 insertions(+), 790 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index b504610a816..d878a11c29e 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -45,611 +45,360 @@ describe('useInfiniteListController', () => {
         debounce: 200,
     };
 
-    describe('queryOptions', () => {
-        it('should accept custom client query options', async () => {
-            jest.spyOn(console, 'error').mockImplementationOnce(() => {});
+    describe('displaySelectAllButton', () => {
+        it('should return true if no items are selected', async () => {
             const getList = jest
                 .fn()
-                .mockImplementationOnce(() => Promise.reject(new Error()));
-            const onError = jest.fn();
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+                );
             const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController
-                        resource="posts"
-                        queryOptions={{ onError }}
-                    >
-                        {() => <div />}
-                    </InfiniteListController>
+                    <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(getList).toHaveBeenCalled();
-                expect(onError).toHaveBeenCalled();
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                    })
+                );
             });
         });
-
-        it('should accept meta in queryOptions', async () => {
+        it('should return true if some items are selected', async () => {
             const getList = jest
                 .fn()
-                .mockImplementationOnce(() =>
-                    Promise.resolve({ data: [], total: 25 })
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
                 );
             const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const props = {
+                ...defaultProps,
+                children,
+            };
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController
-                        resource="posts"
-                        queryOptions={{ meta: { foo: 'bar' } }}
-                    >
-                        {() => <div />}
-                    </InfiniteListController>
+                    <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(getList).toHaveBeenCalledWith('posts', {
-                    filter: {},
-                    pagination: { page: 1, perPage: 10 },
-                    sort: { field: 'id', order: 'ASC' },
-                    meta: { foo: 'bar' },
-                    signal: undefined,
-                });
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
             });
-        });
-
-        it('should reset page when enabled is set to false', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const dataProvider = testDataProvider({
-                getList: () => Promise.resolve({ data: [], total: 0 }),
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
             });
-            const props = { ...defaultProps, children };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController
-                        disableSyncWithLocation
-                        queryOptions={{ enabled: false }}
-                        {...props}
-                    />
-                </CoreAdminContext>
-            );
-
             act(() => {
                 // @ts-ignore
-                children.mock.calls.at(-1)[0].setPage(3);
+                children.mock.calls.at(-1)[0].onSelect([0]);
             });
-
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
                     expect.objectContaining({
-                        page: 1,
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
                     })
                 );
             });
         });
-    });
-
-    describe('setFilters', () => {
-        let childFunction = ({ setFilters, filterValues }) => (
-            <input
-                aria-label="search"
-                type="text"
-                value={filterValues.q || ''}
-                onChange={event => {
-                    setFilters({ q: event.target.value });
-                }}
-            />
-        );
-
-        it('should take only last change in case of a burst of changes (case of inputs being currently edited)', async () => {
+        it('should return false if all items are manually selected', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+                );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
             const props = {
                 ...defaultProps,
-                children: childFunction,
+                children,
             };
-            const store = memoryStore();
-            const storeSpy = jest.spyOn(store, 'setItem');
-
             render(
-                <CoreAdminContext
-                    dataProvider={testDataProvider({
-                        getList: () => Promise.resolve({ data: [], total: 0 }),
-                    })}
-                    store={store}
-                >
+                <CoreAdminContext dataProvider={dataProvider}>
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
-            const searchInput = screen.getByLabelText('search');
-
-            fireEvent.change(searchInput, { target: { value: 'hel' } });
-            fireEvent.change(searchInput, { target: { value: 'hell' } });
-            fireEvent.change(searchInput, { target: { value: 'hello' } });
-            await new Promise(resolve => setTimeout(resolve, 210));
-
             await waitFor(() => {
-                expect(storeSpy).toHaveBeenCalledTimes(1);
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
             });
-            expect(storeSpy).toHaveBeenCalledWith('posts.listParams', {
-                filter: { q: 'hello' },
-                order: 'ASC',
-                page: 1,
-                perPage: 10,
-                sort: 'id',
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
             });
-        });
-
-        it('should remove empty filters', async () => {
-            const props = {
-                ...defaultProps,
-                children: childFunction,
-            };
-
-            const store = memoryStore();
-            const storeSpy = jest.spyOn(store, 'setItem');
-            render(
-                <TestMemoryRouter
-                    initialEntries={[
-                        `/posts?filter=${JSON.stringify({
-                            q: 'hello',
-                        })}&displayedFilters=${JSON.stringify({ q: true })}`,
-                    ]}
-                >
-                    <CoreAdminContext
-                        dataProvider={testDataProvider({
-                            getList: () =>
-                                Promise.resolve({ data: [], total: 0 }),
-                        })}
-                        store={store}
-                    >
-                        <InfiniteListController {...props} />
-                    </CoreAdminContext>
-                </TestMemoryRouter>
-            );
-            expect(storeSpy).toHaveBeenCalledTimes(1);
-
-            const searchInput = screen.getByLabelText('search');
-            // FIXME: For some reason, triggering the change event with an empty string
-            // does not call the event handler on childFunction
-            fireEvent.change(searchInput, { target: { value: '' } });
-            await new Promise(resolve => setTimeout(resolve, 410));
-
-            expect(storeSpy).toHaveBeenCalledTimes(2);
-
-            expect(storeSpy).toHaveBeenCalledWith('posts.listParams', {
-                filter: {},
-                displayedFilters: { q: true },
-                order: 'ASC',
-                page: 1,
-                perPage: 10,
-                sort: 'id',
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelect([0, 1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0, 1],
+                    })
+                );
             });
         });
-
-        it('should update data if permanent filters change', () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                debounce: 200,
-                children,
-            };
+        it('should return false if all items are selected with onSelectAll', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
-                    Promise.resolve({ data: [], total: 0 })
+                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
                 );
             const dataProvider = testDataProvider({ getList });
-
-            const { rerender } = render(
-                <TestMemoryRouter initialEntries={[`/posts`]}>
-                    <CoreAdminContext dataProvider={dataProvider}>
-                        <InfiniteListController
-                            {...props}
-                            filter={{ foo: 1 }}
-                        />
-                    </CoreAdminContext>
-                </TestMemoryRouter>
-            );
-
-            // Check that the permanent filter was used in the query
-            expect(getList).toHaveBeenCalledTimes(1);
-            expect(getList).toHaveBeenCalledWith(
-                'posts',
-                expect.objectContaining({ filter: { foo: 1 } })
-            );
-
-            // Check that the permanent filter is not included in the displayedFilters and filterValues (passed to Filter form and button)
-            expect(children).toHaveBeenCalledTimes(1);
-            expect(children).toHaveBeenCalledWith(
-                expect.objectContaining({
-                    displayedFilters: {},
-                    filterValues: {},
-                })
-            );
-
-            rerender(
-                <TestMemoryRouter initialEntries={[`/posts`]}>
-                    <CoreAdminContext dataProvider={dataProvider}>
-                        <InfiniteListController
-                            {...props}
-                            filter={{ foo: 2 }}
-                        />
-                    </CoreAdminContext>
-                </TestMemoryRouter>
-            );
-
-            // Check that the permanent filter was used in the query
-            expect(getList).toHaveBeenCalledTimes(2);
-            expect(getList).toHaveBeenCalledWith(
-                'posts',
-                expect.objectContaining({ filter: { foo: 2 } })
-            );
-            expect(children).toHaveBeenCalledTimes(2);
-        });
-    });
-
-    describe('showFilter', () => {
-        it('Does not remove previously shown filter when adding a new one', async () => {
-            let currentDisplayedFilters;
-
-            let childFunction = ({ showFilter, displayedFilters }) => {
-                currentDisplayedFilters = displayedFilters;
-                return (
-                    <>
-                        <button
-                            aria-label="Show filter 1"
-                            onClick={() => {
-                                showFilter('filter1.subdata', 'bob');
-                            }}
-                        />
-                        <button
-                            aria-label="Show filter 2"
-                            onClick={() => {
-                                showFilter('filter2', '');
-                            }}
-                        />
-                    </>
-                );
-            };
-
+            const children = jest.fn().mockReturnValue(<span>children</span>);
             const props = {
                 ...defaultProps,
-                children: childFunction,
+                children,
             };
-
             render(
-                <CoreAdminContext
-                    dataProvider={testDataProvider({
-                        getList: () => Promise.resolve({ data: [], total: 0 }),
-                    })}
-                >
+                <CoreAdminContext dataProvider={dataProvider}>
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
-
-            fireEvent.click(screen.getByLabelText('Show filter 1'));
             await waitFor(() => {
-                expect(currentDisplayedFilters).toEqual({
-                    'filter1.subdata': true,
-                });
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
+                    })
+                );
             });
-            fireEvent.click(screen.getByLabelText('Show filter 2'));
             await waitFor(() => {
-                expect(currentDisplayedFilters).toEqual({
-                    'filter1.subdata': true,
-                    filter2: true,
-                });
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
             });
-        });
-
-        it('should support to sync calls', async () => {
-            render(
-                <CoreAdminContext
-                    dataProvider={testDataProvider({
-                        getList: () => Promise.resolve({ data: [], total: 0 }),
-                    })}
-                >
-                    <InfiniteListController {...defaultProps}>
-                        {({ displayedFilters, showFilter }) => (
-                            <>
-                                <button
-                                    aria-label="Show filters"
-                                    onClick={() => {
-                                        showFilter('filter1.subdata', 'bob');
-                                        showFilter('filter2', '');
-                                    }}
-                                />
-                                {Object.keys(displayedFilters).map(
-                                    (displayedFilter, index) => (
-                                        <div key={index}>{displayedFilter}</div>
-                                    )
-                                )}
-                            </>
-                        )}
-                    </InfiniteListController>
-                </CoreAdminContext>
-            );
-
-            fireEvent.click(screen.getByLabelText('Show filters'));
-
             await waitFor(() => {
-                expect(screen.queryByText('filter1.subdata')).not.toBeNull();
-                expect(screen.queryByText('filter2')).not.toBeNull();
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
             });
-        });
-    });
-
-    describe('pagination', () => {
-        it('should compute hasNextPage and hasPreviousPage based on total', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [], total: 25 })
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0, 1],
+                    })
                 );
+            });
+        });
+        it('should return false if all we manually reached the selectAllLimit', async () => {
+            const getList = jest.fn().mockImplementation(() =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                })
+            );
             const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
             const props = {
                 ...defaultProps,
+                selectAllLimit: 1,
                 children,
             };
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController
-                        disableSyncWithLocation
-                        {...props}
-                    />
+                    <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
                     expect.objectContaining({
-                        page: 1,
-                        total: 25,
-                        hasNextPage: true,
-                        hasPreviousPage: false,
+                        displaySelectAllButton: true,
+                        data: undefined,
+                        total: undefined,
+                        selectedIds: [],
                     })
                 );
             });
-            act(() => {
-                // @ts-ignore
-                children.mock.calls.at(-1)[0].setPage(2);
-            });
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
                     expect.objectContaining({
-                        page: 2,
-                        total: 25,
-                        hasNextPage: true,
-                        hasPreviousPage: true,
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
                     })
                 );
             });
             act(() => {
                 // @ts-ignore
-                children.mock.calls.at(-1)[0].setPage(3);
+                children.mock.calls.at(-1)[0].onSelect([0]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
                     expect.objectContaining({
-                        page: 3,
-                        total: 25,
-                        hasNextPage: false,
-                        hasPreviousPage: true,
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
                     })
                 );
             });
         });
-        it('should compute hasNextPage and hasPreviousPage based on pageInfo', async () => {
-            const getList = jest.fn().mockImplementation(() =>
+        it('should return false if all we reached the selectAllLimit with onSelectAll', async () => {
+            const getList = jest.fn().mockImplementation((_resource, params) =>
                 Promise.resolve({
-                    data: [],
-                    pageInfo: { hasNextPage: true, hasPreviousPage: false },
+                    data: [{ id: 0 }, { id: 1 }].slice(
+                        0,
+                        params.pagination.perPage
+                    ),
+                    total: 2,
                 })
             );
+
             const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
             const props = {
                 ...defaultProps,
+                selectAllLimit: 1,
                 children,
             };
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController
-                        disableSyncWithLocation
-                        {...props}
-                    />
+                    <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
                     expect.objectContaining({
-                        page: 1,
+                        displaySelectAllButton: true,
+                        data: undefined,
                         total: undefined,
-                        hasNextPage: true,
-                        hasPreviousPage: false,
+                        selectedIds: [],
                     })
                 );
             });
-        });
-    });
-
-    describe('getInfiniteListControllerProps', () => {
-        it('should only pick the props injected by the InfiniteListController', () => {
-            expect(
-                getListControllerProps({
-                    foo: 1,
-                    data: [4, 5],
-                    page: 3,
-                    bar: 'hello',
-                })
-            ).toEqual({
-                sort: undefined,
-                data: [4, 5],
-                defaultTitle: undefined,
-                displayedFilters: undefined,
-                error: undefined,
-                exporter: undefined,
-                filterValues: undefined,
-                hasCreate: undefined,
-                hideFilter: undefined,
-                isFetching: undefined,
-                isLoading: undefined,
-                isPending: undefined,
-                onSelect: undefined,
-                onToggleItem: undefined,
-                onUnselectItems: undefined,
-                page: 3,
-                perPage: undefined,
-                refetch: undefined,
-                refresh: undefined,
-                resource: undefined,
-                selectedIds: undefined,
-                setFilters: undefined,
-                setPage: undefined,
-                setPerPage: undefined,
-                setSort: undefined,
-                showFilter: undefined,
-                total: undefined,
-                totalPages: undefined,
-            });
-        });
-    });
-
-    describe('sanitizeListRestProps', () => {
-        it('should omit the props injected by the InfiniteListController', () => {
-            expect(
-                sanitizeListRestProps({
-                    foo: 1,
-                    data: [4, 5],
-                    page: 3,
-                    bar: 'hello',
-                })
-            ).toEqual({
-                foo: 1,
-                bar: 'hello',
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    2,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
             });
-        });
-    });
-
-    it('should return correct total value for empty data', async () => {
-        const getList = jest.fn().mockImplementation(() =>
-            Promise.resolve({
-                data: [],
-                total: 0,
-            })
-        );
-        const dataProvider = testDataProvider({ getList });
-
-        render(
-            <CoreAdminContext dataProvider={dataProvider}>
-                <InfiniteListController resource="posts">
-                    {({ total }) => (
-                        <div aria-label="Total value">{String(total)}</div>
-                    )}
-                </InfiniteListController>
-            </CoreAdminContext>
-        );
-
-        await waitFor(() => {
-            const totalDivNode = screen.getByLabelText('Total value');
-            const totalInnerHTML = totalDivNode.innerHTML;
-            const totalValue = Number(totalInnerHTML);
-
-            expect(totalInnerHTML).not.toEqual('undefined');
-            expect(totalValue).not.toBeNaN();
-            expect(totalValue).toEqual(0);
-        });
-    });
-
-    describe('security', () => {
-        it('should not call the dataProvider until the authentication check passes', async () => {
-            let resolveAuthCheck: () => void;
-            const authProvider: AuthProvider = {
-                checkAuth: jest.fn(
-                    () =>
-                        new Promise(resolve => {
-                            resolveAuthCheck = resolve;
-                        })
-                ),
-                login: () => Promise.resolve(),
-                logout: () => Promise.resolve(),
-                checkError: () => Promise.resolve(),
-                getPermissions: () => Promise.resolve(),
-            };
-            const dataProvider = testDataProvider({
+            act(() => {
                 // @ts-ignore
-                getList: jest.fn(() =>
-                    Promise.resolve({
-                        data: [{ id: 1, title: 'A post', votes: 0 }],
-                        total: 0,
-                    })
-                ),
+                children.mock.calls.at(-1)[0].onSelectAll();
             });
-
-            render(
-                <Authenticated
-                    authProvider={authProvider}
-                    dataProvider={dataProvider}
-                />
-            );
             await waitFor(() => {
-                expect(authProvider.checkAuth).toHaveBeenCalled();
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        displaySelectAllButton: true,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [],
+                    })
+                );
             });
-            expect(dataProvider.getList).not.toHaveBeenCalled();
-            resolveAuthCheck!();
-            await screen.findByText('A post - 0 votes');
-        });
-
-        it('should redirect to the /access-denied page when users do not have access', async () => {
-            render(<CanAccess />);
-            await screen.findByText('Loading...');
-            await screen.findByText('Post #1 - 90 votes');
-            fireEvent.click(await screen.findByText('posts.list access'));
-            await screen.findByText('Access denied');
-        });
-
-        it('should display the show view when users have access', async () => {
-            render(<CanAccess />);
-            await screen.findByText('Loading...');
-            await screen.findByText('Post #1 - 90 votes');
-        });
-
-        it('should call the dataProvider if disableAuthentication is true', async () => {
-            const authProvider: AuthProvider = {
-                checkAuth: jest.fn(),
-                login: () => Promise.resolve(),
-                logout: () => Promise.resolve(),
-                checkError: () => Promise.resolve(),
-                getPermissions: () => Promise.resolve(),
-            };
-            const dataProvider = testDataProvider({
-                // @ts-ignore
-                getList: jest.fn(() =>
-                    Promise.resolve({
-                        data: [{ id: 1, title: 'A post', votes: 0 }],
-                        total: 0,
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        displaySelectAllButton: false,
+                        data: [{ id: 0 }, { id: 1 }],
+                        total: 2,
+                        selectedIds: [0],
                     })
-                ),
+                );
             });
-
-            render(
-                <DisableAuthentication
-                    authProvider={authProvider}
-                    dataProvider={dataProvider}
-                />
-            );
-            await screen.findByText('A post - 0 votes');
-            expect(dataProvider.getList).toHaveBeenCalled();
-            // Only called once by NavigationToFirstResource
-            expect(authProvider.checkAuth).toHaveBeenCalledTimes(1);
         });
     });
 
-    describe('displaySelectAllButton', () => {
-        it('should return true if no items are selected', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
+    describe('onSelectAll', () => {
+        it('should select all items if no items are selected', async () => {
+            const getList = jest.fn().mockImplementation(() =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                })
+            );
             const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
             const props = {
@@ -665,9 +414,7 @@ describe('useInfiniteListController', () => {
                 expect(children).toHaveBeenNthCalledWith(
                     1,
                     expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
+                        selectedIds: [],
                     })
                 );
             });
@@ -675,19 +422,38 @@ describe('useInfiniteListController', () => {
                 expect(children).toHaveBeenNthCalledWith(
                     2,
                     expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
+                        selectedIds: [],
                     })
                 );
             });
-        });
-        it('should return true if some items are selected', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    3,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    4,
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
                 );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const getList = jest.fn().mockImplementation(() =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }],
+                    total: 2,
+                })
+            );
             const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
             const props = {
@@ -703,9 +469,6 @@ describe('useInfiniteListController', () => {
                 expect(children).toHaveBeenNthCalledWith(
                     1,
                     expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
                         selectedIds: [],
                     })
                 );
@@ -714,9 +477,6 @@ describe('useInfiniteListController', () => {
                 expect(children).toHaveBeenNthCalledWith(
                     2,
                     expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [],
                     })
                 );
@@ -729,79 +489,46 @@ describe('useInfiniteListController', () => {
                 expect(children).toHaveBeenNthCalledWith(
                     3,
                     expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0],
                     })
                 );
             });
-        });
-        it('should return false if all items are manually selected', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
-                </CoreAdminContext>
-            );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
+            act(() => {
+                // @ts-ignore
+                children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
                 expect(children).toHaveBeenNthCalledWith(
-                    2,
+                    4,
                     expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
+                        selectedIds: [0],
                     })
                 );
             });
-            act(() => {
-                // @ts-ignore
-                children.mock.calls.at(-1)[0].onSelect([0, 1]);
-            });
             await waitFor(() => {
                 expect(children).toHaveBeenNthCalledWith(
-                    3,
+                    5,
                     expect.objectContaining({
-                        displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should return false if all items are selected with onSelectAll', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
+        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
+            const getList = jest.fn().mockImplementation((_resource, params) =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }].slice(
+                        0,
+                        params.pagination.perPage
+                    ),
+                    total: 2,
+                })
+            );
             const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
             const props = {
                 ...defaultProps,
+                selectAllLimit: 1,
                 children,
             };
             render(
@@ -813,9 +540,6 @@ describe('useInfiniteListController', () => {
                 expect(children).toHaveBeenNthCalledWith(
                     1,
                     expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
                         selectedIds: [],
                     })
                 );
@@ -824,13 +548,19 @@ describe('useInfiniteListController', () => {
                 expect(children).toHaveBeenNthCalledWith(
                     2,
                     expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [],
                     })
                 );
             });
+            await waitFor(() => {
+                expect(getList).toHaveBeenNthCalledWith(
+                    1,
+                    'posts',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 10 },
+                    })
+                );
+            });
             act(() => {
                 // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
@@ -839,9 +569,6 @@ describe('useInfiniteListController', () => {
                 expect(children).toHaveBeenNthCalledWith(
                     3,
                     expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [],
                     })
                 );
@@ -850,208 +577,360 @@ describe('useInfiniteListController', () => {
                 expect(children).toHaveBeenNthCalledWith(
                     4,
                     expect.objectContaining({
-                        displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [0, 1],
+                        selectedIds: [0],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(getList).toHaveBeenNthCalledWith(
+                    2,
+                    'posts',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 1 },
                     })
                 );
             });
         });
-        it('should return false if all we manually reached the selectAllLimit', async () => {
-            const getList = jest.fn().mockImplementation(() =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                })
-            );
+    });
+    describe('queryOptions', () => {
+        it('should accept custom client query options', async () => {
+            jest.spyOn(console, 'error').mockImplementationOnce(() => {});
+            const getList = jest
+                .fn()
+                .mockImplementationOnce(() => Promise.reject(new Error()));
+            const onError = jest.fn();
             const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                selectAllLimit: 1,
-                children,
-            };
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
+                    <InfiniteListController
+                        resource="posts"
+                        queryOptions={{ onError }}
+                    >
+                        {() => <div />}
+                    </InfiniteListController>
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
+                expect(getList).toHaveBeenCalled();
+                expect(onError).toHaveBeenCalled();
             });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
+        });
+
+        it('should accept meta in queryOptions', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementationOnce(() =>
+                    Promise.resolve({ data: [], total: 25 })
                 );
+            const dataProvider = testDataProvider({ getList });
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController
+                        resource="posts"
+                        queryOptions={{ meta: { foo: 'bar' } }}
+                    >
+                        {() => <div />}
+                    </InfiniteListController>
+                </CoreAdminContext>
+            );
+            await waitFor(() => {
+                expect(getList).toHaveBeenCalledWith('posts', {
+                    filter: {},
+                    pagination: { page: 1, perPage: 10 },
+                    sort: { field: 'id', order: 'ASC' },
+                    meta: { foo: 'bar' },
+                    signal: undefined,
+                });
+            });
+        });
+
+        it('should reset page when enabled is set to false', async () => {
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const dataProvider = testDataProvider({
+                getList: () => Promise.resolve({ data: [], total: 0 }),
             });
+            const props = { ...defaultProps, children };
+            render(
+                <CoreAdminContext dataProvider={dataProvider}>
+                    <InfiniteListController
+                        disableSyncWithLocation
+                        queryOptions={{ enabled: false }}
+                        {...props}
+                    />
+                </CoreAdminContext>
+            );
+
             act(() => {
                 // @ts-ignore
-                children.mock.calls.at(-1)[0].onSelect([0]);
+                children.mock.calls.at(-1)[0].setPage(3);
             });
+
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [0],
+                        page: 1,
                     })
                 );
             });
         });
-        it('should return false if all we reached the selectAllLimit with onSelectAll', async () => {
-            const getList = jest.fn().mockImplementation((_resource, params) =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }].slice(
-                        0,
-                        params.pagination.perPage
-                    ),
-                    total: 2,
-                })
-            );
+    });
 
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
+    describe('setFilters', () => {
+        let childFunction = ({ setFilters, filterValues }) => (
+            <input
+                aria-label="search"
+                type="text"
+                value={filterValues.q || ''}
+                onChange={event => {
+                    setFilters({ q: event.target.value });
+                }}
+            />
+        );
+
+        it('should take only last change in case of a burst of changes (case of inputs being currently edited)', async () => {
             const props = {
                 ...defaultProps,
-                selectAllLimit: 1,
-                children,
+                children: childFunction,
             };
+            const store = memoryStore();
+            const storeSpy = jest.spyOn(store, 'setItem');
+
             render(
-                <CoreAdminContext dataProvider={dataProvider}>
+                <CoreAdminContext
+                    dataProvider={testDataProvider({
+                        getList: () => Promise.resolve({ data: [], total: 0 }),
+                    })}
+                    store={store}
+                >
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
+            const searchInput = screen.getByLabelText('search');
+
+            fireEvent.change(searchInput, { target: { value: 'hel' } });
+            fireEvent.change(searchInput, { target: { value: 'hell' } });
+            fireEvent.change(searchInput, { target: { value: 'hello' } });
+            await new Promise(resolve => setTimeout(resolve, 210));
+
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            act(() => {
-                // @ts-ignore
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
+                expect(storeSpy).toHaveBeenCalledTimes(1);
             });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
-                    expect.objectContaining({
-                        displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [0],
-                    })
-                );
+            expect(storeSpy).toHaveBeenCalledWith('posts.listParams', {
+                filter: { q: 'hello' },
+                order: 'ASC',
+                page: 1,
+                perPage: 10,
+                sort: 'id',
             });
         });
-    });
 
-    describe('onSelectAll', () => {
-        it('should select all items if no items are selected', async () => {
-            const getList = jest.fn().mockImplementation(() =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                })
+        it('should remove empty filters', async () => {
+            const props = {
+                ...defaultProps,
+                children: childFunction,
+            };
+
+            const store = memoryStore();
+            const storeSpy = jest.spyOn(store, 'setItem');
+            render(
+                <TestMemoryRouter
+                    initialEntries={[
+                        `/posts?filter=${JSON.stringify({
+                            q: 'hello',
+                        })}&displayedFilters=${JSON.stringify({ q: true })}`,
+                    ]}
+                >
+                    <CoreAdminContext
+                        dataProvider={testDataProvider({
+                            getList: () =>
+                                Promise.resolve({ data: [], total: 0 }),
+                        })}
+                        store={store}
+                    >
+                        <InfiniteListController {...props} />
+                    </CoreAdminContext>
+                </TestMemoryRouter>
             );
-            const dataProvider = testDataProvider({ getList });
+            expect(storeSpy).toHaveBeenCalledTimes(1);
+
+            const searchInput = screen.getByLabelText('search');
+            // FIXME: For some reason, triggering the change event with an empty string
+            // does not call the event handler on childFunction
+            fireEvent.change(searchInput, { target: { value: '' } });
+            await new Promise(resolve => setTimeout(resolve, 410));
+
+            expect(storeSpy).toHaveBeenCalledTimes(2);
+
+            expect(storeSpy).toHaveBeenCalledWith('posts.listParams', {
+                filter: {},
+                displayedFilters: { q: true },
+                order: 'ASC',
+                page: 1,
+                perPage: 10,
+                sort: 'id',
+            });
+        });
+
+        it('should update data if permanent filters change', () => {
             const children = jest.fn().mockReturnValue(<span>children</span>);
             const props = {
                 ...defaultProps,
+                debounce: 200,
                 children,
             };
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [], total: 0 })
+                );
+            const dataProvider = testDataProvider({ getList });
+
+            const { rerender } = render(
+                <TestMemoryRouter initialEntries={[`/posts`]}>
+                    <CoreAdminContext dataProvider={dataProvider}>
+                        <InfiniteListController
+                            {...props}
+                            filter={{ foo: 1 }}
+                        />
+                    </CoreAdminContext>
+                </TestMemoryRouter>
+            );
+
+            // Check that the permanent filter was used in the query
+            expect(getList).toHaveBeenCalledTimes(1);
+            expect(getList).toHaveBeenCalledWith(
+                'posts',
+                expect.objectContaining({ filter: { foo: 1 } })
+            );
+
+            // Check that the permanent filter is not included in the displayedFilters and filterValues (passed to Filter form and button)
+            expect(children).toHaveBeenCalledTimes(1);
+            expect(children).toHaveBeenCalledWith(
+                expect.objectContaining({
+                    displayedFilters: {},
+                    filterValues: {},
+                })
+            );
+
+            rerender(
+                <TestMemoryRouter initialEntries={[`/posts`]}>
+                    <CoreAdminContext dataProvider={dataProvider}>
+                        <InfiniteListController
+                            {...props}
+                            filter={{ foo: 2 }}
+                        />
+                    </CoreAdminContext>
+                </TestMemoryRouter>
+            );
+
+            // Check that the permanent filter was used in the query
+            expect(getList).toHaveBeenCalledTimes(2);
+            expect(getList).toHaveBeenCalledWith(
+                'posts',
+                expect.objectContaining({ filter: { foo: 2 } })
+            );
+            expect(children).toHaveBeenCalledTimes(2);
+        });
+    });
+
+    describe('showFilter', () => {
+        it('Does not remove previously shown filter when adding a new one', async () => {
+            let currentDisplayedFilters;
+
+            let childFunction = ({ showFilter, displayedFilters }) => {
+                currentDisplayedFilters = displayedFilters;
+                return (
+                    <>
+                        <button
+                            aria-label="Show filter 1"
+                            onClick={() => {
+                                showFilter('filter1.subdata', 'bob');
+                            }}
+                        />
+                        <button
+                            aria-label="Show filter 2"
+                            onClick={() => {
+                                showFilter('filter2', '');
+                            }}
+                        />
+                    </>
+                );
+            };
+
+            const props = {
+                ...defaultProps,
+                children: childFunction,
+            };
+
             render(
-                <CoreAdminContext dataProvider={dataProvider}>
+                <CoreAdminContext
+                    dataProvider={testDataProvider({
+                        getList: () => Promise.resolve({ data: [], total: 0 }),
+                    })}
+                >
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
+
+            fireEvent.click(screen.getByLabelText('Show filter 1'));
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            act(() => {
-                // @ts-ignore
-                children.mock.calls.at(-1)[0].onSelectAll();
+                expect(currentDisplayedFilters).toEqual({
+                    'filter1.subdata': true,
+                });
             });
+            fireEvent.click(screen.getByLabelText('Show filter 2'));
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
+                expect(currentDisplayedFilters).toEqual({
+                    'filter1.subdata': true,
+                    filter2: true,
+                });
             });
+        });
+
+        it('should support to sync calls', async () => {
+            render(
+                <CoreAdminContext
+                    dataProvider={testDataProvider({
+                        getList: () => Promise.resolve({ data: [], total: 0 }),
+                    })}
+                >
+                    <InfiniteListController {...defaultProps}>
+                        {({ displayedFilters, showFilter }) => (
+                            <>
+                                <button
+                                    aria-label="Show filters"
+                                    onClick={() => {
+                                        showFilter('filter1.subdata', 'bob');
+                                        showFilter('filter2', '');
+                                    }}
+                                />
+                                {Object.keys(displayedFilters).map(
+                                    (displayedFilter, index) => (
+                                        <div key={index}>{displayedFilter}</div>
+                                    )
+                                )}
+                            </>
+                        )}
+                    </InfiniteListController>
+                </CoreAdminContext>
+            );
+
+            fireEvent.click(screen.getByLabelText('Show filters'));
+
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
-                );
+                expect(screen.queryByText('filter1.subdata')).not.toBeNull();
+                expect(screen.queryByText('filter2')).not.toBeNull();
             });
         });
-        it('should select all items if some items are selected', async () => {
-            const getList = jest.fn().mockImplementation(() =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                })
-            );
+    });
+
+    describe('pagination', () => {
+        it('should compute hasNextPage and hasPreviousPage based on total', async () => {
+            const getList = jest
+                .fn()
+                .mockImplementation(() =>
+                    Promise.resolve({ data: [], total: 25 })
+                );
             const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
             const props = {
@@ -1060,134 +939,254 @@ describe('useInfiniteListController', () => {
             };
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
+                    <InfiniteListController
+                        disableSyncWithLocation
+                        {...props}
+                    />
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        selectedIds: [],
+                        page: 1,
+                        total: 25,
+                        hasNextPage: true,
+                        hasPreviousPage: false,
                     })
                 );
             });
             act(() => {
                 // @ts-ignore
-                children.mock.calls.at(-1)[0].onSelect([0]);
+                children.mock.calls.at(-1)[0].setPage(2);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        selectedIds: [0],
+                        page: 2,
+                        total: 25,
+                        hasNextPage: true,
+                        hasPreviousPage: true,
                     })
                 );
             });
             act(() => {
                 // @ts-ignore
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
-                );
+                children.mock.calls.at(-1)[0].setPage(3);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    5,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        selectedIds: [0, 1],
+                        page: 3,
+                        total: 25,
+                        hasNextPage: false,
+                        hasPreviousPage: true,
                     })
                 );
             });
         });
-        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
-            const getList = jest.fn().mockImplementation((_resource, params) =>
+        it('should compute hasNextPage and hasPreviousPage based on pageInfo', async () => {
+            const getList = jest.fn().mockImplementation(() =>
                 Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }].slice(
-                        0,
-                        params.pagination.perPage
-                    ),
-                    total: 2,
+                    data: [],
+                    pageInfo: { hasNextPage: true, hasPreviousPage: false },
                 })
             );
             const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
             const props = {
                 ...defaultProps,
-                selectAllLimit: 1,
                 children,
             };
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
+                    <InfiniteListController
+                        disableSyncWithLocation
+                        {...props}
+                    />
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        selectedIds: [],
+                        page: 1,
+                        total: undefined,
+                        hasNextPage: true,
+                        hasPreviousPage: false,
                     })
                 );
             });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
+        });
+    });
+
+    describe('getInfiniteListControllerProps', () => {
+        it('should only pick the props injected by the InfiniteListController', () => {
+            expect(
+                getListControllerProps({
+                    foo: 1,
+                    data: [4, 5],
+                    page: 3,
+                    bar: 'hello',
+                })
+            ).toEqual({
+                sort: undefined,
+                data: [4, 5],
+                defaultTitle: undefined,
+                displayedFilters: undefined,
+                error: undefined,
+                exporter: undefined,
+                filterValues: undefined,
+                hasCreate: undefined,
+                hideFilter: undefined,
+                isFetching: undefined,
+                isLoading: undefined,
+                isPending: undefined,
+                onSelect: undefined,
+                onToggleItem: undefined,
+                onUnselectItems: undefined,
+                page: 3,
+                perPage: undefined,
+                refetch: undefined,
+                refresh: undefined,
+                resource: undefined,
+                selectedIds: undefined,
+                setFilters: undefined,
+                setPage: undefined,
+                setPerPage: undefined,
+                setSort: undefined,
+                showFilter: undefined,
+                total: undefined,
+                totalPages: undefined,
             });
-            await waitFor(() => {
-                expect(getList).toHaveBeenNthCalledWith(
-                    1,
-                    'posts',
-                    expect.objectContaining({
-                        pagination: { page: 1, perPage: 10 },
-                    })
-                );
+        });
+    });
+
+    describe('sanitizeListRestProps', () => {
+        it('should omit the props injected by the InfiniteListController', () => {
+            expect(
+                sanitizeListRestProps({
+                    foo: 1,
+                    data: [4, 5],
+                    page: 3,
+                    bar: 'hello',
+                })
+            ).toEqual({
+                foo: 1,
+                bar: 'hello',
             });
-            act(() => {
+        });
+    });
+
+    it('should return correct total value for empty data', async () => {
+        const getList = jest.fn().mockImplementation(() =>
+            Promise.resolve({
+                data: [],
+                total: 0,
+            })
+        );
+        const dataProvider = testDataProvider({ getList });
+
+        render(
+            <CoreAdminContext dataProvider={dataProvider}>
+                <InfiniteListController resource="posts">
+                    {({ total }) => (
+                        <div aria-label="Total value">{String(total)}</div>
+                    )}
+                </InfiniteListController>
+            </CoreAdminContext>
+        );
+
+        await waitFor(() => {
+            const totalDivNode = screen.getByLabelText('Total value');
+            const totalInnerHTML = totalDivNode.innerHTML;
+            const totalValue = Number(totalInnerHTML);
+
+            expect(totalInnerHTML).not.toEqual('undefined');
+            expect(totalValue).not.toBeNaN();
+            expect(totalValue).toEqual(0);
+        });
+    });
+
+    describe('security', () => {
+        it('should not call the dataProvider until the authentication check passes', async () => {
+            let resolveAuthCheck: () => void;
+            const authProvider: AuthProvider = {
+                checkAuth: jest.fn(
+                    () =>
+                        new Promise(resolve => {
+                            resolveAuthCheck = resolve;
+                        })
+                ),
+                login: () => Promise.resolve(),
+                logout: () => Promise.resolve(),
+                checkError: () => Promise.resolve(),
+                getPermissions: () => Promise.resolve(),
+            };
+            const dataProvider = testDataProvider({
                 // @ts-ignore
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        selectedIds: [],
+                getList: jest.fn(() =>
+                    Promise.resolve({
+                        data: [{ id: 1, title: 'A post', votes: 0 }],
+                        total: 0,
                     })
-                );
+                ),
             });
+
+            render(
+                <Authenticated
+                    authProvider={authProvider}
+                    dataProvider={dataProvider}
+                />
+            );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
-                );
+                expect(authProvider.checkAuth).toHaveBeenCalled();
             });
-            await waitFor(() => {
-                expect(getList).toHaveBeenNthCalledWith(
-                    2,
-                    'posts',
-                    expect.objectContaining({
-                        pagination: { page: 1, perPage: 1 },
+            expect(dataProvider.getList).not.toHaveBeenCalled();
+            resolveAuthCheck!();
+            await screen.findByText('A post - 0 votes');
+        });
+
+        it('should redirect to the /access-denied page when users do not have access', async () => {
+            render(<CanAccess />);
+            await screen.findByText('Loading...');
+            await screen.findByText('Post #1 - 90 votes');
+            fireEvent.click(await screen.findByText('posts.list access'));
+            await screen.findByText('Access denied');
+        });
+
+        it('should display the show view when users have access', async () => {
+            render(<CanAccess />);
+            await screen.findByText('Loading...');
+            await screen.findByText('Post #1 - 90 votes');
+        });
+
+        it('should call the dataProvider if disableAuthentication is true', async () => {
+            const authProvider: AuthProvider = {
+                checkAuth: jest.fn(),
+                login: () => Promise.resolve(),
+                logout: () => Promise.resolve(),
+                checkError: () => Promise.resolve(),
+                getPermissions: () => Promise.resolve(),
+            };
+            const dataProvider = testDataProvider({
+                // @ts-ignore
+                getList: jest.fn(() =>
+                    Promise.resolve({
+                        data: [{ id: 1, title: 'A post', votes: 0 }],
+                        total: 0,
                     })
-                );
+                ),
             });
+
+            render(
+                <DisableAuthentication
+                    authProvider={authProvider}
+                    dataProvider={dataProvider}
+                />
+            );
+            await screen.findByText('A post - 0 votes');
+            expect(dataProvider.getList).toHaveBeenCalled();
+            // Only called once by NavigationToFirstResource
+            expect(authProvider.checkAuth).toHaveBeenCalledTimes(1);
         });
     });
 });

From db66a996554b217bbe2ba3e0c9131e606229e998 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Mon, 25 Nov 2024 20:31:49 +0100
Subject: [PATCH 030/146] document `<List selectAllLimit>`

---
 docs/List.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/List.md b/docs/List.md
index 9849282192b..952d8a6e8d4 100644
--- a/docs/List.md
+++ b/docs/List.md
@@ -71,6 +71,7 @@ You can find more advanced examples of `<List>` usage in the [demos](./Demos.md)
 | `perPage`                 | Optional | `number`       | `10`           | The number of records to fetch per page.                                                     |
 | `queryOptions`            | Optional | `object`       | -              | The options to pass to the `useQuery` hook.                                                  |
 | `resource`                | Optional | `string`       | -              | The resource name, e.g. `posts`.                                                             |
+| `selectAllLimit`          | Optional | `number`       | -              | The number of items selected by the "SELECT ALL" button of the bulk actions toolbar.         |
 | `sort`                    | Optional | `object`       | -              | The initial sort parameters.                                                                 |
 | `storeKey`                | Optional | `string | false` | -           | The key to use to store the current filter & sort. Pass `false` to disable store synchronization |
 | `title`                   | Optional | `string | ReactElement | false` | -              | The title to display in the App Bar.                                                         |
@@ -874,6 +875,22 @@ export const UsersList = () => (
 );
 ```
 
+## `selectAllLimit`
+
+The number of items selected by the "SELECT ALL" button of the bulk actions toolbar
+
+By default, the "SELECT ALL" button of the `<Datagrid>`'s bulk actions toolbar select all records up to 250 items. You can customize the limit by passing a `selectAllLimit` prop to the `<List>` component
+
+```jsx
+export const UsersList = () => (
+    <List selectAllLimit={2000}>
+        <Datagrid>
+            ...
+        </Datagrid>
+    </List>
+);
+```
+
 ## `sort`
 
 Pass an object literal as the `sort` prop to determine the default `field` and `order` used for sorting:

From 473a9f9d6e9d441ebcfbe2cbe1c73e159c45812f Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Mon, 25 Nov 2024 20:35:03 +0100
Subject: [PATCH 031/146] document `<ReferenceManyField selectAllLimit>`

---
 docs/List.md               |  2 --
 docs/ReferenceManyField.md | 13 +++++++++++++
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/docs/List.md b/docs/List.md
index 952d8a6e8d4..a197a6c34f3 100644
--- a/docs/List.md
+++ b/docs/List.md
@@ -877,8 +877,6 @@ export const UsersList = () => (
 
 ## `selectAllLimit`
 
-The number of items selected by the "SELECT ALL" button of the bulk actions toolbar
-
 By default, the "SELECT ALL" button of the `<Datagrid>`'s bulk actions toolbar select all records up to 250 items. You can customize the limit by passing a `selectAllLimit` prop to the `<List>` component
 
 ```jsx
diff --git a/docs/ReferenceManyField.md b/docs/ReferenceManyField.md
index 1ee01a71182..ea94b646cb6 100644
--- a/docs/ReferenceManyField.md
+++ b/docs/ReferenceManyField.md
@@ -91,6 +91,7 @@ This example leverages [`<SingleFieldList>`](./SingleFieldList.md) to display an
 | `perPage`      | Optional | `number`                                                                          | 25                               | Maximum number of referenced records to fetch                                       |
 | `queryOptions` | Optional | [`UseQuery Options`](https://tanstack.com/query/v3/docs/react/reference/useQuery) | `{}`                             | `react-query` options for the `getMany` query                                       |
 | `reference`    | Required | `string`                                                                          | -                                | The name of the resource for the referenced records, e.g. 'books'                   |
+| `selectAllLimit` | Optional | `number`                                                                        | -                                | The number of items selected by the "SELECT ALL" button of the bulk actions toolbar.         |
 | `sort`         | Optional | `{ field, order }`                                                                | `{ field: 'id', order: 'DESC' }` | Sort order to use when fetching the related records, passed to `getManyReference()` |
 | `source`       | Optional | `string`                                                                          | `id`                             | Target field carrying the relationship on the source record (usually 'id')          |
 | `storeKey`     | Optional | `string`                                                                          | -                                | The key to use to store the records selection state                                 |
@@ -272,6 +273,18 @@ For instance, if you want to display the `books` of a given `author`, the `refer
 </ReferenceManyField>
 ```
 
+## `selectAllLimit`
+
+By default, the "SELECT ALL" button of the `<Datagrid>`'s bulk actions toolbar select all records up to 250 items. You can customize the limit by passing a `selectAllLimit` prop to the `<ReferenceManyField>` component
+
+```jsx
+<ReferenceManyField selectAllLimit={2000} reference="comments" target="post_id">
+  <Datagrid>
+    ...
+  </Datagrid>
+</ReferenceManyField>
+```
+
 ## `sort`
 
 By default, it orders the possible values by id desc. You can change this order by setting the `sort` prop (an object with `field` and `order` properties).

From 0a6ff630f37e8851d791a4f9520e601b057fc1e9 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Mon, 25 Nov 2024 20:49:16 +0100
Subject: [PATCH 032/146] fix List tests

---
 .../ra-ui-materialui/src/list/List.spec.tsx   | 52 ++++++++++++++++---
 .../src/list/List.stories.tsx                 |  5 +-
 2 files changed, 49 insertions(+), 8 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/List.spec.tsx b/packages/ra-ui-materialui/src/list/List.spec.tsx
index 3ca2a4c3765..8c6aad6e3b8 100644
--- a/packages/ra-ui-materialui/src/list/List.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/List.spec.tsx
@@ -6,6 +6,7 @@ import {
     testDataProvider,
     useListContext,
     TestMemoryRouter,
+    useRecordSelection,
 } from 'ra-core';
 import { createTheme, ThemeProvider } from '@mui/material/styles';
 
@@ -344,8 +345,25 @@ describe('<List />', () => {
     });
 
     describe('"Select all" button', () => {
+        const Child = () => {
+            const [_, selectionModifiers] = useRecordSelection({
+                resource: 'books',
+            });
+            return (
+                <button onClick={() => selectionModifiers.clearSelection()}>
+                    reset
+                </button>
+            );
+        };
+        afterEach(() => {
+            fireEvent.click(screen.getByRole('button', { name: 'reset' }));
+        });
         it('should be displayed if an item is selected', async () => {
-            render(<Default />);
+            render(
+                <Default>
+                    <Child />
+                </Default>
+            );
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
@@ -377,7 +395,9 @@ describe('<List />', () => {
                                 total: 2,
                             }),
                     })}
-                />
+                >
+                    <Child />
+                </Default>
             );
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(3);
@@ -389,7 +409,11 @@ describe('<List />', () => {
             ).toBeNull();
         });
         it('should not be displayed if all item are selected with the "Select all" button', async () => {
-            render(<Default />);
+            render(
+                <Default>
+                    <Child />
+                </Default>
+            );
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
@@ -431,7 +455,9 @@ describe('<List />', () => {
                                 total: 3,
                             }),
                     })}
-                />
+                >
+                    <Child />
+                </SelectAllLimit>
             );
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(4);
@@ -444,7 +470,11 @@ describe('<List />', () => {
             ).toBeNull();
         });
         it('should not be displayed if we reached de selectAllLimit by a  click on the "Select all" button', async () => {
-            render(<SelectAllLimit />);
+            render(
+                <SelectAllLimit>
+                    <Child />
+                </SelectAllLimit>
+            );
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
@@ -460,7 +490,11 @@ describe('<List />', () => {
             ).toBeNull();
         });
         it('should select all items', async () => {
-            render(<Default />);
+            render(
+                <Default>
+                    <Child />
+                </Default>
+            );
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
@@ -470,7 +504,11 @@ describe('<List />', () => {
             await screen.findByText('13 items selected');
         });
         it('should select the maximum items possible until we reached the selectAllLimit', async () => {
-            render(<SelectAllLimit />);
+            render(
+                <SelectAllLimit>
+                    <Child />
+                </SelectAllLimit>
+            );
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
diff --git a/packages/ra-ui-materialui/src/list/List.stories.tsx b/packages/ra-ui-materialui/src/list/List.stories.tsx
index 3c315ae0eb8..4583c30033e 100644
--- a/packages/ra-ui-materialui/src/list/List.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/List.stories.tsx
@@ -299,6 +299,7 @@ export const HasCreate = () => (
 export const SelectAllLimit = ({
     dataProvider = defaultDataProvider,
     selectAllLimit = 11,
+    children,
 }) => (
     <TestMemoryRouter initialEntries={['/books']}>
         <Admin dataProvider={dataProvider}>
@@ -312,6 +313,7 @@ export const SelectAllLimit = ({
                             <TextField source="author" />
                             <TextField source="year" />
                         </Datagrid>
+                        {children}
                     </List>
                 )}
             />
@@ -489,7 +491,7 @@ export const Meta = () => (
     </TestMemoryRouter>
 );
 
-export const Default = ({ dataProvider = defaultDataProvider }) => (
+export const Default = ({ dataProvider = defaultDataProvider, children }) => (
     <TestMemoryRouter initialEntries={['/books']}>
         <Admin dataProvider={dataProvider}>
             <Resource
@@ -502,6 +504,7 @@ export const Default = ({ dataProvider = defaultDataProvider }) => (
                             <TextField source="author" />
                             <TextField source="year" />
                         </Datagrid>
+                        {children}
                     </List>
                 )}
             />

From 91627613437d45409c45b7e1e842506aeda94190 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Tue, 26 Nov 2024 15:52:44 +0100
Subject: [PATCH 033/146] fix typos

---
 docs/List.md                                              | 2 +-
 docs/ReferenceManyField.md                                | 2 +-
 .../field/useReferenceArrayFieldController.spec.tsx       | 8 ++++----
 packages/ra-ui-materialui/src/list/List.spec.tsx          | 6 +++---
 4 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/List.md b/docs/List.md
index a197a6c34f3..a99256788ea 100644
--- a/docs/List.md
+++ b/docs/List.md
@@ -71,7 +71,7 @@ You can find more advanced examples of `<List>` usage in the [demos](./Demos.md)
 | `perPage`                 | Optional | `number`       | `10`           | The number of records to fetch per page.                                                     |
 | `queryOptions`            | Optional | `object`       | -              | The options to pass to the `useQuery` hook.                                                  |
 | `resource`                | Optional | `string`       | -              | The resource name, e.g. `posts`.                                                             |
-| `selectAllLimit`          | Optional | `number`       | -              | The number of items selected by the "SELECT ALL" button of the bulk actions toolbar.         |
+| `selectAllLimit`          | Optional | `number`       | -              | The maximum number of items selected by the "SELECT ALL" button of the bulk actions toolbar.         |
 | `sort`                    | Optional | `object`       | -              | The initial sort parameters.                                                                 |
 | `storeKey`                | Optional | `string | false` | -           | The key to use to store the current filter & sort. Pass `false` to disable store synchronization |
 | `title`                   | Optional | `string | ReactElement | false` | -              | The title to display in the App Bar.                                                         |
diff --git a/docs/ReferenceManyField.md b/docs/ReferenceManyField.md
index ea94b646cb6..d6c0aadae9e 100644
--- a/docs/ReferenceManyField.md
+++ b/docs/ReferenceManyField.md
@@ -91,7 +91,7 @@ This example leverages [`<SingleFieldList>`](./SingleFieldList.md) to display an
 | `perPage`      | Optional | `number`                                                                          | 25                               | Maximum number of referenced records to fetch                                       |
 | `queryOptions` | Optional | [`UseQuery Options`](https://tanstack.com/query/v3/docs/react/reference/useQuery) | `{}`                             | `react-query` options for the `getMany` query                                       |
 | `reference`    | Required | `string`                                                                          | -                                | The name of the resource for the referenced records, e.g. 'books'                   |
-| `selectAllLimit` | Optional | `number`                                                                        | -                                | The number of items selected by the "SELECT ALL" button of the bulk actions toolbar.         |
+| `selectAllLimit` | Optional | `number`                                                                        | -                                | The maximum number of items selected by the "SELECT ALL" button of the bulk actions toolbar.         |
 | `sort`         | Optional | `{ field, order }`                                                                | `{ field: 'id', order: 'DESC' }` | Sort order to use when fetching the related records, passed to `getManyReference()` |
 | `source`       | Optional | `string`                                                                          | `id`                             | Target field carrying the relationship on the source record (usually 'id')          |
 | `storeKey`     | Optional | `string`                                                                          | -                                | The key to use to store the records selection state                                 |
diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index d5562131b7c..0c57813eea7 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -168,7 +168,7 @@ describe('<useReferenceArrayFieldController />', () => {
     });
 
     describe('displaySelectAllButton', () => {
-        it('should return true if no items are selected', async () => {
+        it('should be true if no items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
@@ -216,7 +216,7 @@ describe('<useReferenceArrayFieldController />', () => {
                 );
             });
         });
-        it('should return true if some items are selected', async () => {
+        it('should be true if some items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
@@ -285,7 +285,7 @@ describe('<useReferenceArrayFieldController />', () => {
                 );
             });
         });
-        it('should return false if all items are manually selected', async () => {
+        it('should be false if all items are manually selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
@@ -354,7 +354,7 @@ describe('<useReferenceArrayFieldController />', () => {
                 );
             });
         });
-        it('should return false if all items are selected with onSelectAll', async () => {
+        it('should be false if all items are selected with onSelectAll', async () => {
             const children = jest.fn().mockReturnValue('child');
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
diff --git a/packages/ra-ui-materialui/src/list/List.spec.tsx b/packages/ra-ui-materialui/src/list/List.spec.tsx
index 8c6aad6e3b8..edaa03b1a29 100644
--- a/packages/ra-ui-materialui/src/list/List.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/List.spec.tsx
@@ -372,7 +372,7 @@ describe('<List />', () => {
                 await screen.findByRole('button', { name: 'Select all' })
             ).toBeDefined();
         });
-        it('should not be displayed if all item are manyally selected', async () => {
+        it('should not be displayed if all item are manually selected', async () => {
             render(
                 <Default
                     dataProvider={testDataProvider({
@@ -425,7 +425,7 @@ describe('<List />', () => {
                 screen.queryByRole('button', { name: 'Select all' })
             ).toBeNull();
         });
-        it('should not be displayed if we reached de selectAllLimit by a manyally selection', async () => {
+        it('should not be displayed if we reached the selectAllLimit by a manual selection', async () => {
             render(
                 <SelectAllLimit
                     selectAllLimit={2}
@@ -469,7 +469,7 @@ describe('<List />', () => {
                 screen.queryByRole('button', { name: 'Select all' })
             ).toBeNull();
         });
-        it('should not be displayed if we reached de selectAllLimit by a  click on the "Select all" button', async () => {
+        it('should not be displayed if we reached the selectAllLimit by a  click on the "Select all" button', async () => {
             render(
                 <SelectAllLimit>
                     <Child />

From cadc723d3a325ce5dcde7d753224a32e2cb7ab7d Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Tue, 26 Nov 2024 17:31:47 +0100
Subject: [PATCH 034/146] Simplify tests

---
 .../useReferenceArrayFieldController.spec.tsx | 200 ++----------
 .../useReferenceManyFieldController.spec.tsx  | 257 ++--------------
 .../list/useInfiniteListController.spec.tsx   | 289 ++----------------
 .../src/controller/list/useList.spec.tsx      | 140 +--------
 .../list/useListController.spec.tsx           | 284 ++---------------
 5 files changed, 80 insertions(+), 1090 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 0c57813eea7..7f902ee629c 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -183,28 +183,7 @@ describe('<useReferenceArrayFieldController />', () => {
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
                         data: [
@@ -230,49 +209,11 @@ describe('<useReferenceArrayFieldController />', () => {
                     </ReferenceArrayFieldController>
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([1]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
                         data: [
@@ -299,49 +240,11 @@ describe('<useReferenceArrayFieldController />', () => {
                     </ReferenceArrayFieldController>
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([1, 2]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
                         data: [
@@ -369,30 +272,7 @@ describe('<useReferenceArrayFieldController />', () => {
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
                         data: [
@@ -405,12 +285,10 @@ describe('<useReferenceArrayFieldController />', () => {
                 );
             });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
                         data: [
@@ -441,36 +319,20 @@ describe('<useReferenceArrayFieldController />', () => {
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        selectedIds: [],
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
                     })
                 );
             });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1, 2],
                     })
@@ -492,48 +354,20 @@ describe('<useReferenceArrayFieldController />', () => {
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            act(() => {
-                // @ts-ignore
-                children.mock.calls.at(-1)[0].onSelect([1]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
-                    expect.objectContaining({
-                        selectedIds: [1],
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
                     })
                 );
             });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    5,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1, 2],
                     })
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index 5f923f3b783..20c84a8de51 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -420,7 +420,7 @@ describe('useReferenceManyFieldController', () => {
     });
 
     describe('displaySelectAllButton', () => {
-        it('should return true if no items are selected', async () => {
+        it('should be true if no items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest.fn().mockResolvedValue({
@@ -442,27 +442,14 @@ describe('useReferenceManyFieldController', () => {
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                     })
                 );
             });
         });
-        it('should return true if some items are selected', async () => {
+        it('should be true if some items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest.fn().mockResolvedValue({
@@ -483,45 +470,19 @@ describe('useReferenceManyFieldController', () => {
                     </ReferenceManyFieldController>
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([1]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [1],
                     })
                 );
             });
         });
-        it('should return false if all items are manually selected', async () => {
+        it('should be false if all items are manually selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest.fn().mockResolvedValue({
@@ -542,45 +503,19 @@ describe('useReferenceManyFieldController', () => {
                     </ReferenceManyFieldController>
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0, 1]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should return false if all items are selected with onSelectAll', async () => {
+        it('should be false if all items are selected with onSelectAll', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest.fn().mockResolvedValue({
@@ -601,56 +536,19 @@ describe('useReferenceManyFieldController', () => {
                     </ReferenceManyFieldController>
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should return false if all we manually reached the selectAllLimit', async () => {
+        it('should be false if all we manually reached the selectAllLimit', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest.fn().mockResolvedValue({
@@ -672,45 +570,19 @@ describe('useReferenceManyFieldController', () => {
                     </ReferenceManyFieldController>
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0],
                     })
                 );
             });
         });
-        it('should return false if all we reached the selectAllLimit with onSelectAll', async () => {
+        it('should be false if all we reached the selectAllLimit with onSelectAll', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest
@@ -739,50 +611,13 @@ describe('useReferenceManyFieldController', () => {
                     </ReferenceManyFieldController>
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0],
                     })
                 );
@@ -813,29 +648,11 @@ describe('useReferenceManyFieldController', () => {
                     </ReferenceManyFieldController>
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -864,41 +681,21 @@ describe('useReferenceManyFieldController', () => {
                     </ReferenceManyFieldController>
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([1]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1],
                     })
                 );
             });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        selectedIds: [1],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -941,38 +738,18 @@ describe('useReferenceManyFieldController', () => {
                     })
                 );
             });
-            await waitFor(() => {
-                expect(getManyReference).toHaveBeenNthCalledWith(
-                    1,
-                    'books',
-                    expect.objectContaining({
-                        pagination: { page: 1, perPage: 25 },
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
                 );
             });
             await waitFor(() => {
-                expect(getManyReference).toHaveBeenNthCalledWith(
-                    2,
+                expect(getManyReference).toHaveBeenCalledWith(
                     'books',
                     expect.objectContaining({
                         pagination: { page: 1, perPage: 1 },
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index d878a11c29e..2e1d357ea3b 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -46,7 +46,7 @@ describe('useInfiniteListController', () => {
     };
 
     describe('displaySelectAllButton', () => {
-        it('should return true if no items are selected', async () => {
+        it('should be true if no items are selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -64,27 +64,15 @@ describe('useInfiniteListController', () => {
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
                         data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                     })
                 );
             });
         });
-        it('should return true if some items are selected', async () => {
+        it('should be true if some items are selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -101,45 +89,19 @@ describe('useInfiniteListController', () => {
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0],
                     })
                 );
             });
         });
-        it('should return false if all items are manually selected', async () => {
+        it('should be false if all items are manually selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -156,45 +118,19 @@ describe('useInfiniteListController', () => {
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0, 1]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should return false if all items are selected with onSelectAll', async () => {
+        it('should be false if all items are selected with onSelectAll', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -211,56 +147,19 @@ describe('useInfiniteListController', () => {
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should return false if all we manually reached the selectAllLimit', async () => {
+        it('should be false if all we manually reached the selectAllLimit', async () => {
             const getList = jest.fn().mockImplementation(() =>
                 Promise.resolve({
                     data: [{ id: 0 }, { id: 1 }],
@@ -279,45 +178,19 @@ describe('useInfiniteListController', () => {
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0],
                     })
                 );
             });
         });
-        it('should return false if all we reached the selectAllLimit with onSelectAll', async () => {
+        it('should be false if all we reached the selectAllLimit with onSelectAll', async () => {
             const getList = jest.fn().mockImplementation((_resource, params) =>
                 Promise.resolve({
                     data: [{ id: 0 }, { id: 1 }].slice(
@@ -340,50 +213,13 @@ describe('useInfiniteListController', () => {
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0],
                     })
                 );
@@ -410,37 +246,11 @@ describe('useInfiniteListController', () => {
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -465,49 +275,21 @@ describe('useInfiniteListController', () => {
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
                 );
             });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    5,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -536,54 +318,18 @@ describe('useInfiniteListController', () => {
                     <InfiniteListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(getList).toHaveBeenNthCalledWith(
-                    1,
-                    'posts',
-                    expect.objectContaining({
-                        pagination: { page: 1, perPage: 10 },
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
                 );
             });
             await waitFor(() => {
-                expect(getList).toHaveBeenNthCalledWith(
-                    2,
+                expect(getList).toHaveBeenCalledWith(
                     'posts',
                     expect.objectContaining({
                         pagination: { page: 1, perPage: 1 },
@@ -592,6 +338,7 @@ describe('useInfiniteListController', () => {
             });
         });
     });
+
     describe('queryOptions', () => {
         it('should accept custom client query options', async () => {
             jest.spyOn(console, 'error').mockImplementationOnce(() => {});
diff --git a/packages/ra-core/src/controller/list/useList.spec.tsx b/packages/ra-core/src/controller/list/useList.spec.tsx
index 40f8d5a36af..af78b755399 100644
--- a/packages/ra-core/src/controller/list/useList.spec.tsx
+++ b/packages/ra-core/src/controller/list/useList.spec.tsx
@@ -317,142 +317,62 @@ describe('<useList />', () => {
     });
 
     describe('displaySelectAllButton', () => {
-        it('should return true if no items are selected', async () => {
+        it('should be true if no items are selected', async () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
                         data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                     })
                 );
             });
         });
-        it('should return true if some items are selected', async () => {
+        it('should be true if some items are selected', async () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([1]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [1],
                     })
                 );
             });
         });
-        it('should return false if all items are manually selected', async () => {
+        it('should be false if all items are manually selected', async () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0, 1]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should return false if all items are selected with onSelectAll', async () => {
+        it('should be false if all items are selected with onSelectAll', async () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0, 1],
                     })
                 );
@@ -465,29 +385,11 @@ describe('<useList />', () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -498,41 +400,21 @@ describe('<useList />', () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([1]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1],
                     })
                 );
             });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index 79b6d794681..e6022edd0e5 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -587,7 +587,7 @@ describe('useListController', () => {
     });
 
     describe('displaySelectAllButton', () => {
-        it('should return true if no items are selected', async () => {
+        it('should be true if no items are selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -605,27 +605,15 @@ describe('useListController', () => {
                 </CoreAdminContext>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
                         data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                     })
                 );
             });
         });
-        it('should return true if some items are selected', async () => {
+        it('should be true if some items are selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -642,45 +630,19 @@ describe('useListController', () => {
                     <ListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0],
                     })
                 );
             });
         });
-        it('should return false if all items are manually selected', async () => {
+        it('should be false if all items are manually selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -697,45 +659,19 @@ describe('useListController', () => {
                     <ListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0, 1]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should return false if all items are selected with onSelectAll', async () => {
+        it('should be false if all items are selected with onSelectAll', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -752,46 +688,11 @@ describe('useListController', () => {
                     <ListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
                         data: [{ id: 0 }, { id: 1 }],
@@ -801,7 +702,7 @@ describe('useListController', () => {
                 );
             });
         });
-        it('should return false if all we manually reached the selectAllLimit', async () => {
+        it('should be false if all we manually reached the selectAllLimit', async () => {
             const getList = jest.fn().mockImplementation(() =>
                 Promise.resolve({
                     data: [{ id: 0 }, { id: 1 }],
@@ -820,45 +721,19 @@ describe('useListController', () => {
                     <ListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
                         selectedIds: [0],
                     })
                 );
             });
         });
-        it('should return false if all we reached the selectAllLimit with onSelectAll', async () => {
+        it('should be false if all we reached the selectAllLimit with onSelectAll', async () => {
             const getList = jest.fn().mockImplementation((_resource, params) =>
                 Promise.resolve({
                     data: [{ id: 0 }, { id: 1 }].slice(
@@ -881,46 +756,11 @@ describe('useListController', () => {
                     <ListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: undefined,
-                        total: undefined,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        displaySelectAllButton: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         displaySelectAllButton: false,
                         data: [{ id: 0 }, { id: 1 }],
@@ -951,37 +791,11 @@ describe('useListController', () => {
                     <ListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -1006,49 +820,21 @@ describe('useListController', () => {
                     <ListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
                 );
             });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    5,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -1077,54 +863,18 @@ describe('useListController', () => {
                     <ListController {...props} />
                 </CoreAdminContext>
             );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    2,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(getList).toHaveBeenNthCalledWith(
-                    1,
-                    'posts',
-                    expect.objectContaining({
-                        pagination: { page: 1, perPage: 10 },
-                    })
-                );
-            });
             act(() => {
-                // @ts-ignore
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    3,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    4,
+                expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
                 );
             });
             await waitFor(() => {
-                expect(getList).toHaveBeenNthCalledWith(
-                    2,
+                expect(getList).toHaveBeenCalledWith(
                     'posts',
                     expect.objectContaining({
                         pagination: { page: 1, perPage: 1 },

From 538076c243bc79d451c258458e156daf870d3312 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Tue, 26 Nov 2024 17:50:46 +0100
Subject: [PATCH 035/146] simplify spacings in bulkActionToolbar

---
 packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index 674dd6a0e4d..786e1477a02 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -66,7 +66,6 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
                         <Button
                             label={translate('ra.action.select_all')}
                             onClick={handleSelectAll}
-                            sx={{ ml: 1 }}
                         />
                     )}
                 </div>
@@ -147,10 +146,6 @@ const Root = styled('div', {
     [`& .${BulkActionsToolbarClasses.title}`]: {
         display: 'flex',
         flex: '0 0 auto',
-    },
-
-    [`& .${BulkActionsToolbarClasses.icon}`]: {
-        marginLeft: '-0.5em',
-        marginRight: '0.5em',
+        gap: theme.spacing(1),
     },
 }));

From 5b301506b5eeb560276eabbb8bb3da195bebc83f Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Tue, 26 Nov 2024 18:07:26 +0100
Subject: [PATCH 036/146] rename displaySelectAllButton to areAllItemsSelected

---
 .../useReferenceArrayFieldController.spec.tsx | 20 +++++++-------
 .../useReferenceManyFieldController.spec.tsx  | 26 +++++++++----------
 .../field/useReferenceManyFieldController.ts  |  6 ++---
 .../src/controller/list/ListContext.tsx       |  2 +-
 .../list/useInfiniteListController.spec.tsx   | 26 +++++++++----------
 .../list/useInfiniteListController.ts         |  6 ++---
 .../src/controller/list/useList.spec.tsx      | 18 ++++++-------
 .../ra-core/src/controller/list/useList.ts    |  2 +-
 .../list/useListContextWithProps.ts           |  6 ++---
 .../list/useListController.spec.tsx           | 26 +++++++++----------
 .../src/controller/list/useListController.ts  |  8 +++---
 .../src/list/BulkActionsToolbar.tsx           |  4 +--
 12 files changed, 75 insertions(+), 75 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 7f902ee629c..3428dab671e 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -167,8 +167,8 @@ describe('<useReferenceArrayFieldController />', () => {
         );
     });
 
-    describe('displaySelectAllButton', () => {
-        it('should be true if no items are selected', async () => {
+    describe('areAllItemsSelected', () => {
+        it('should be false if no items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
@@ -185,7 +185,7 @@ describe('<useReferenceArrayFieldController />', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                         data: [
                             { id: 1, title: 'bar1' },
                             { id: 2, title: 'bar2' },
@@ -195,7 +195,7 @@ describe('<useReferenceArrayFieldController />', () => {
                 );
             });
         });
-        it('should be true if some items are selected', async () => {
+        it('should be false if some items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
@@ -215,7 +215,7 @@ describe('<useReferenceArrayFieldController />', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                         data: [
                             { id: 1, title: 'bar1' },
                             { id: 2, title: 'bar2' },
@@ -226,7 +226,7 @@ describe('<useReferenceArrayFieldController />', () => {
                 );
             });
         });
-        it('should be false if all items are manually selected', async () => {
+        it('should be true if all items are manually selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
@@ -246,7 +246,7 @@ describe('<useReferenceArrayFieldController />', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         data: [
                             { id: 1, title: 'bar1' },
                             { id: 2, title: 'bar2' },
@@ -257,7 +257,7 @@ describe('<useReferenceArrayFieldController />', () => {
                 );
             });
         });
-        it('should be false if all items are selected with onSelectAll', async () => {
+        it('should be true if all items are selected with onSelectAll', async () => {
             const children = jest.fn().mockReturnValue('child');
             render(
                 <CoreAdminContext dataProvider={dataProvider}>
@@ -274,7 +274,7 @@ describe('<useReferenceArrayFieldController />', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                         data: [
                             { id: 1, title: 'bar1' },
                             { id: 2, title: 'bar2' },
@@ -290,7 +290,7 @@ describe('<useReferenceArrayFieldController />', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         data: [
                             { id: 1, title: 'bar1' },
                             { id: 2, title: 'bar2' },
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index 20c84a8de51..c9722926f03 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -419,8 +419,8 @@ describe('useReferenceManyFieldController', () => {
         });
     });
 
-    describe('displaySelectAllButton', () => {
-        it('should be true if no items are selected', async () => {
+    describe('areAllItemsSelected', () => {
+        it('should be false if no items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest.fn().mockResolvedValue({
@@ -444,12 +444,12 @@ describe('useReferenceManyFieldController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                     })
                 );
             });
         });
-        it('should be true if some items are selected', async () => {
+        it('should be false if some items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest.fn().mockResolvedValue({
@@ -476,13 +476,13 @@ describe('useReferenceManyFieldController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                         selectedIds: [1],
                     })
                 );
             });
         });
-        it('should be false if all items are manually selected', async () => {
+        it('should be true if all items are manually selected', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest.fn().mockResolvedValue({
@@ -509,13 +509,13 @@ describe('useReferenceManyFieldController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should be false if all items are selected with onSelectAll', async () => {
+        it('should be true if all items are selected with onSelectAll', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest.fn().mockResolvedValue({
@@ -542,13 +542,13 @@ describe('useReferenceManyFieldController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should be false if all we manually reached the selectAllLimit', async () => {
+        it('should be true if all we manually reached the selectAllLimit', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest.fn().mockResolvedValue({
@@ -576,13 +576,13 @@ describe('useReferenceManyFieldController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0],
                     })
                 );
             });
         });
-        it('should be false if all we reached the selectAllLimit with onSelectAll', async () => {
+        it('should be true if all we reached the selectAllLimit with onSelectAll', async () => {
             const children = jest.fn().mockReturnValue('child');
             const dataProvider = testDataProvider({
                 getManyReference: jest
@@ -617,7 +617,7 @@ describe('useReferenceManyFieldController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0],
                     })
                 );
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 98aebbe0770..423b5c11a45 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -252,9 +252,9 @@ export const useReferenceManyFieldController = <
         refetch,
         resource: reference,
         selectedIds,
-        displaySelectAllButton: !(
-            total === selectedIds.length || selectedIds.length >= selectAllLimit
-        ),
+        areAllItemsSelected:
+            total === selectedIds.length ||
+            selectedIds.length >= selectAllLimit,
         setFilters,
         setPage,
         setPerPage,
diff --git a/packages/ra-core/src/controller/list/ListContext.tsx b/packages/ra-core/src/controller/list/ListContext.tsx
index 0b2a935de46..5dc0692f790 100644
--- a/packages/ra-core/src/controller/list/ListContext.tsx
+++ b/packages/ra-core/src/controller/list/ListContext.tsx
@@ -24,7 +24,7 @@ import { ListControllerResult } from './useListController';
  * @prop {Function} showFilter a callback to show one of the filters, e.g. showFilter('title', defaultValue)
  * @prop {Function} hideFilter a callback to hide one of the filters, e.g. hideFilter('title')
  * @prop {Array}    selectedIds an array listing the ids of the selected rows, e.g. [123, 456]
- * @prop {boolean}  displaySelectAllButton boolean to indicate if the list is already fully selected
+ * @prop {boolean}  areAllItemsSelected boolean to indicate if the list is already fully selected
  * @prop {Function} onSelect callback to change the list of selected rows, e.g. onSelect([456, 789])
  * @prop {Function} onSelectAll callback to select all the records, e.g. onSelectAll()
  * @prop {Function} onToggleItem callback to toggle the selection of a given record based on its id, e.g. onToggleItem(456)
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index 2e1d357ea3b..f4f417d5c7c 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -45,8 +45,8 @@ describe('useInfiniteListController', () => {
         debounce: 200,
     };
 
-    describe('displaySelectAllButton', () => {
-        it('should be true if no items are selected', async () => {
+    describe('areAllItemsSelected', () => {
+        it('should be false if no items are selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -66,13 +66,13 @@ describe('useInfiniteListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                         data: [{ id: 0 }, { id: 1 }],
                     })
                 );
             });
         });
-        it('should be true if some items are selected', async () => {
+        it('should be false if some items are selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -95,13 +95,13 @@ describe('useInfiniteListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                         selectedIds: [0],
                     })
                 );
             });
         });
-        it('should be false if all items are manually selected', async () => {
+        it('should be true if all items are manually selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -124,13 +124,13 @@ describe('useInfiniteListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should be false if all items are selected with onSelectAll', async () => {
+        it('should be true if all items are selected with onSelectAll', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -153,13 +153,13 @@ describe('useInfiniteListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should be false if all we manually reached the selectAllLimit', async () => {
+        it('should be true if all we manually reached the selectAllLimit', async () => {
             const getList = jest.fn().mockImplementation(() =>
                 Promise.resolve({
                     data: [{ id: 0 }, { id: 1 }],
@@ -184,13 +184,13 @@ describe('useInfiniteListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0],
                     })
                 );
             });
         });
-        it('should be false if all we reached the selectAllLimit with onSelectAll', async () => {
+        it('should be true if all we reached the selectAllLimit with onSelectAll', async () => {
             const getList = jest.fn().mockImplementation((_resource, params) =>
                 Promise.resolve({
                     data: [{ id: 0 }, { id: 1 }].slice(
@@ -219,7 +219,7 @@ describe('useInfiniteListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0],
                     })
                 );
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index c7967d60228..84f0da9a7b3 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -233,9 +233,9 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         refetch,
         resource,
         selectedIds,
-        displaySelectAllButton: !(
-            total === selectedIds.length || selectedIds.length >= selectAllLimit
-        ),
+        areAllItemsSelected:
+            total === selectedIds.length ||
+            selectedIds.length >= selectAllLimit,
         setFilters: queryModifiers.setFilters,
         setPage: queryModifiers.setPage,
         setPerPage: queryModifiers.setPerPage,
diff --git a/packages/ra-core/src/controller/list/useList.spec.tsx b/packages/ra-core/src/controller/list/useList.spec.tsx
index af78b755399..18ed205a1e0 100644
--- a/packages/ra-core/src/controller/list/useList.spec.tsx
+++ b/packages/ra-core/src/controller/list/useList.spec.tsx
@@ -316,21 +316,21 @@ describe('<useList />', () => {
         });
     });
 
-    describe('displaySelectAllButton', () => {
-        it('should be true if no items are selected', async () => {
+    describe('areAllItemsSelected', () => {
+        it('should be false if no items are selected', async () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                         data: [{ id: 0 }, { id: 1 }],
                     })
                 );
             });
         });
-        it('should be true if some items are selected', async () => {
+        it('should be false if some items are selected', async () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
@@ -340,13 +340,13 @@ describe('<useList />', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                         selectedIds: [1],
                     })
                 );
             });
         });
-        it('should be false if all items are manually selected', async () => {
+        it('should be true if all items are manually selected', async () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
@@ -356,13 +356,13 @@ describe('<useList />', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should be false if all items are selected with onSelectAll', async () => {
+        it('should be true if all items are selected with onSelectAll', async () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
@@ -372,7 +372,7 @@ describe('<useList />', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0, 1],
                     })
                 );
diff --git a/packages/ra-core/src/controller/list/useList.ts b/packages/ra-core/src/controller/list/useList.ts
index 68250d927fe..dfef3073189 100644
--- a/packages/ra-core/src/controller/list/useList.ts
+++ b/packages/ra-core/src/controller/list/useList.ts
@@ -298,7 +298,7 @@ export const useList = <RecordType extends RaRecord = any>(
         resource: '',
         refetch,
         selectedIds,
-        displaySelectAllButton: data?.length !== selectedIds.length,
+        areAllItemsSelected: data?.length === selectedIds.length,
         setFilters,
         setPage,
         setPerPage,
diff --git a/packages/ra-core/src/controller/list/useListContextWithProps.ts b/packages/ra-core/src/controller/list/useListContextWithProps.ts
index e52b7b1240c..cb4abd796f3 100644
--- a/packages/ra-core/src/controller/list/useListContextWithProps.ts
+++ b/packages/ra-core/src/controller/list/useListContextWithProps.ts
@@ -33,7 +33,7 @@ import { RaRecord } from '../../types';
  * @prop {Function} showFilter a callback to show one of the filters, e.g. showFilter('title', defaultValue)
  * @prop {Function} hideFilter a callback to hide one of the filters, e.g. hideFilter('title')
  * @prop {Array}    selectedIds an array listing the ids of the selected rows, e.g. [123, 456]
- * @prop {boolean}  displaySelectAllButton boolean to indicate if the list is already fully selected
+ * @prop {boolean}  areAllItemsSelected boolean to indicate if the list is already fully selected
  * @prop {Function} onSelect callback to change the list of selected rows, e.g. onSelect([456, 789])
  * @prop {Function} onSelectAll callback to select all the records, e.g. onSelectAll()
  * @prop {Function} onToggleItem callback to toggle the selection of a given record based on its id, e.g. onToggleItem(456)
@@ -91,7 +91,7 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     refetch,
     resource,
     selectedIds,
-    displaySelectAllButton,
+    areAllItemsSelected,
     setFilters,
     setPage,
     setPerPage,
@@ -119,7 +119,7 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     refetch,
     resource,
     selectedIds,
-    displaySelectAllButton,
+    areAllItemsSelected,
     setFilters,
     setPage,
     setPerPage,
diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index e6022edd0e5..2770fb4494c 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -586,8 +586,8 @@ describe('useListController', () => {
         });
     });
 
-    describe('displaySelectAllButton', () => {
-        it('should be true if no items are selected', async () => {
+    describe('areAllItemsSelected', () => {
+        it('should be false if no items are selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -607,13 +607,13 @@ describe('useListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                         data: [{ id: 0 }, { id: 1 }],
                     })
                 );
             });
         });
-        it('should be true if some items are selected', async () => {
+        it('should be false if some items are selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -636,13 +636,13 @@ describe('useListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: true,
+                        areAllItemsSelected: false,
                         selectedIds: [0],
                     })
                 );
             });
         });
-        it('should be false if all items are manually selected', async () => {
+        it('should be true if all items are manually selected', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -665,13 +665,13 @@ describe('useListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
-        it('should be false if all items are selected with onSelectAll', async () => {
+        it('should be true if all items are selected with onSelectAll', async () => {
             const getList = jest
                 .fn()
                 .mockImplementation(() =>
@@ -694,7 +694,7 @@ describe('useListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         data: [{ id: 0 }, { id: 1 }],
                         total: 2,
                         selectedIds: [0, 1],
@@ -702,7 +702,7 @@ describe('useListController', () => {
                 );
             });
         });
-        it('should be false if all we manually reached the selectAllLimit', async () => {
+        it('should be true if all we manually reached the selectAllLimit', async () => {
             const getList = jest.fn().mockImplementation(() =>
                 Promise.resolve({
                     data: [{ id: 0 }, { id: 1 }],
@@ -727,13 +727,13 @@ describe('useListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         selectedIds: [0],
                     })
                 );
             });
         });
-        it('should be false if all we reached the selectAllLimit with onSelectAll', async () => {
+        it('should be true if all we reached the selectAllLimit with onSelectAll', async () => {
             const getList = jest.fn().mockImplementation((_resource, params) =>
                 Promise.resolve({
                     data: [{ id: 0 }, { id: 1 }].slice(
@@ -762,7 +762,7 @@ describe('useListController', () => {
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        displaySelectAllButton: false,
+                        areAllItemsSelected: true,
                         data: [{ id: 0 }, { id: 1 }],
                         total: 2,
                         selectedIds: [0],
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index 86c5bcbe8a4..675c57764bf 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -222,9 +222,9 @@ export const useListController = <RecordType extends RaRecord = any>(
         refetch,
         resource,
         selectedIds,
-        displaySelectAllButton: !(
-            total === selectedIds.length || selectedIds.length >= selectAllLimit
-        ),
+        areAllItemsSelected:
+            total === selectedIds.length ||
+            selectedIds.length >= selectAllLimit,
         setFilters: queryModifiers.setFilters,
         setPage: queryModifiers.setPage,
         setPerPage: queryModifiers.setPerPage,
@@ -531,7 +531,7 @@ export interface ListControllerBaseResult<RecordType extends RaRecord = any> {
     refetch: (() => void) | UseGetListHookValue<RecordType>['refetch'];
     resource: string;
     selectedIds: RecordType['id'][];
-    displaySelectAllButton: boolean;
+    areAllItemsSelected: boolean;
     setFilters: (
         filters: any,
         displayedFilters?: any,
diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index 786e1477a02..70183052c1e 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -23,7 +23,7 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
         selectedIds = [],
         onUnselectItems,
         onSelectAll,
-        displaySelectAllButton,
+        areAllItemsSelected,
     } = useListContext();
 
     const translate = useTranslate();
@@ -62,7 +62,7 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
                             smart_count: selectedIds.length,
                         })}
                     </Typography>
-                    {displaySelectAllButton && (
+                    {!areAllItemsSelected && (
                         <Button
                             label={translate('ra.action.select_all')}
                             onClick={handleSelectAll}

From a30dd1753dc9924e2ff929f771a1b9bdeabb02bf Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 27 Nov 2024 11:26:19 +0100
Subject: [PATCH 037/146] create the `useSelectAll` hook

---
 .../list/useInfiniteListController.ts         | 35 ++-------
 .../src/controller/list/useListController.ts  | 35 ++-------
 .../src/controller/list/useSelectAll.tsx      | 73 +++++++++++++++++++
 3 files changed, 87 insertions(+), 56 deletions(-)
 create mode 100644 packages/ra-core/src/controller/list/useSelectAll.tsx

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index 84f0da9a7b3..7730ba7e110 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -2,7 +2,6 @@ import { isValidElement, useEffect, useMemo } from 'react';
 import {
     InfiniteQueryObserverBaseResult,
     InfiniteData,
-    useMutation,
 } from '@tanstack/react-query';
 
 import { useAuthenticated, useRequireAccess } from '../../auth';
@@ -10,7 +9,6 @@ import { useTranslate } from '../../i18n';
 import { useNotify } from '../../notification';
 import {
     UseInfiniteGetListOptions,
-    useDataProvider,
     useInfiniteGetList,
 } from '../../dataProvider';
 import { defaultExporter } from '../../export';
@@ -26,6 +24,7 @@ import { useRecordSelection } from './useRecordSelection';
 import { useListParams } from './useListParams';
 
 import { ListControllerResult } from './useListController';
+import { useSelectAll } from './useSelectAll';
 
 /**
  * Prepare data for the InfiniteList view
@@ -87,7 +86,6 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
 
     const translate = useTranslate();
     const notify = useNotify();
-    const dataProvider = useDataProvider();
 
     const [query, queryModifiers] = useListParams({
         debounce,
@@ -143,31 +141,12 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         }
     );
 
-    const { mutate: onSelectAll } = useMutation({
-        mutationFn: () =>
-            dataProvider.getList(resource, {
-                pagination: {
-                    page: 1,
-                    perPage: selectAllLimit,
-                },
-                sort: { field: query.sort, order: query.order },
-                filter: { ...query.filter, ...filter },
-                meta,
-            }),
-        onSuccess: ({ data }) => {
-            const allIds = data?.map(({ id }) => id) || [];
-            selectionModifiers.select(allIds);
-            if (allIds.length === selectAllLimit) {
-                notify('ra.message.too_many_elements', {
-                    messageArgs: { max: selectAllLimit },
-                    type: 'warning',
-                });
-            }
-        },
-        onError: e => {
-            console.error('Mutation Error: ', e);
-            notify('An error occurred. Please try again.');
-        },
+    const onSelectAll = useSelectAll({
+        selectAllLimit,
+        query,
+        filter,
+        meta,
+        resource,
     });
 
     // change page if there is no data
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index 675c57764bf..e1670a9b2c5 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -1,11 +1,9 @@
 import { isValidElement, useEffect, useMemo } from 'react';
-import { useMutation } from '@tanstack/react-query';
 
 import { useAuthenticated, useRequireAccess } from '../../auth';
 import { useTranslate } from '../../i18n';
 import { useNotify } from '../../notification';
 import {
-    useDataProvider,
     useGetList,
     UseGetListHookValue,
     UseGetListOptions,
@@ -16,6 +14,7 @@ import { useResourceContext, useGetResourceLabel } from '../../core';
 import { useRecordSelection } from './useRecordSelection';
 import { useListParams } from './useListParams';
 import { SORT_ASC } from './queryReducer';
+import { useSelectAll } from './useSelectAll';
 
 /**
  * Prepare data for the List view
@@ -81,7 +80,6 @@ export const useListController = <RecordType extends RaRecord = any>(
 
     const translate = useTranslate();
     const notify = useNotify();
-    const dataProvider = useDataProvider();
 
     const [query, queryModifiers] = useListParams({
         debounce,
@@ -172,31 +170,12 @@ export const useListController = <RecordType extends RaRecord = any>(
         name: getResourceLabel(resource, 2),
     });
 
-    const { mutate: onSelectAll } = useMutation({
-        mutationFn: () =>
-            dataProvider.getList(resource, {
-                pagination: {
-                    page: 1,
-                    perPage: selectAllLimit,
-                },
-                sort: { field: query.sort, order: query.order },
-                filter: { ...query.filter, ...filter },
-                meta,
-            }),
-        onSuccess: ({ data }) => {
-            const allIds = data?.map(({ id }) => id) || [];
-            selectionModifiers.select(allIds);
-            if (allIds.length === selectAllLimit) {
-                notify('ra.message.too_many_elements', {
-                    messageArgs: { max: selectAllLimit },
-                    type: 'warning',
-                });
-            }
-        },
-        onError: e => {
-            console.error('Mutation Error: ', e);
-            notify('An error occurred. Please try again.');
-        },
+    const onSelectAll = useSelectAll({
+        selectAllLimit,
+        query,
+        filter,
+        meta,
+        resource,
     });
 
     return {
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
new file mode 100644
index 00000000000..5036e6ad8b7
--- /dev/null
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -0,0 +1,73 @@
+import { useMutation } from '@tanstack/react-query';
+import { useNotify } from '../../notification';
+import { useDataProvider } from '../../dataProvider';
+import { useRecordSelection } from './useRecordSelection';
+import type { ListParams } from './useListParams';
+import type { FilterPayload } from '../../types';
+
+/**
+ * Function hook to select all items of a list (until we reached the selectAllLimit)
+ *
+ * @param {string} resource Required. The resource name
+ * @param {ListParams} query Required. The query object used to fetch the list of items
+ * @param {number} selectAllLimit Optional. The number of items selected by the "SELECT ALL" button of the bulk actions toolbar
+ * @param {FilterPayload} filter Optional. Permanent filter applied to all getList queries, regardless of the user selected filters
+ * @param {any} meta Optional. Additional meta data to pass to the dataProvider
+ * @returns {Function} onSelectAll A function to select all items of a list
+ *
+ * @example
+ *
+ * const onSelectAll = useSelectAll({
+ *     resource: 'posts',
+ *     query: { sort: 'title', order: 'ASC' },
+ *     selectAllLimit: 250,
+ * });
+ * return <Button onClick={onSelectAll}>Select All</Button>;
+ */
+export const useSelectAll = ({
+    query,
+    resource,
+    selectAllLimit = 250,
+    filter = {},
+    meta = {},
+}: useSelectAllProps): (() => void) => {
+    const notify = useNotify();
+    const dataProvider = useDataProvider();
+    const [_, selectionModifiers] = useRecordSelection({ resource });
+    const { mutate: onSelectAll } = useMutation({
+        mutationFn: () =>
+            dataProvider.getList(resource, {
+                pagination: {
+                    page: 1,
+                    perPage: selectAllLimit,
+                },
+                sort: { field: query.sort, order: query.order },
+                filter: { ...query.filter, ...filter },
+                meta,
+            }),
+        onSuccess: ({ data }) => {
+            const allIds = data?.map(({ id }) => id) || [];
+            selectionModifiers.select(allIds);
+            if (allIds.length === selectAllLimit) {
+                notify('ra.message.too_many_elements', {
+                    messageArgs: { max: selectAllLimit },
+                    type: 'warning',
+                });
+            }
+        },
+        onError: e => {
+            console.error('Mutation Error: ', e);
+            notify('An error occurred. Please try again.');
+        },
+    });
+
+    return onSelectAll;
+};
+
+export interface useSelectAllProps {
+    resource: string;
+    query: ListParams;
+    selectAllLimit?: number;
+    filter?: FilterPayload;
+    meta?: any;
+}

From 59024b4ef566ef57075c723f2993b9c07275198c Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 27 Nov 2024 11:55:45 +0100
Subject: [PATCH 038/146] fix ReferenceArrayInput

---
 .../ra-ui-materialui/src/input/ReferenceArrayInput.spec.tsx     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/input/ReferenceArrayInput.spec.tsx b/packages/ra-ui-materialui/src/input/ReferenceArrayInput.spec.tsx
index 7815bdec371..34311c16a98 100644
--- a/packages/ra-ui-materialui/src/input/ReferenceArrayInput.spec.tsx
+++ b/packages/ra-ui-materialui/src/input/ReferenceArrayInput.spec.tsx
@@ -192,7 +192,7 @@ describe('<ReferenceArrayInput />', () => {
                 .getByLabelText('ra.action.select_row')
                 .querySelector('input');
         const getCheckboxAll = () =>
-            screen.getByLabelText('ra.action.select_all');
+            screen.getByRole('checkbox', { name: 'ra.action.select_all' });
         await waitFor(() => {
             expect(getCheckbox1()?.checked).toEqual(true);
             expect(getCheckbox2()?.checked).toEqual(false);

From 0846132b0a1a1a4ff1c3d45bd7aff787cd197567 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 27 Nov 2024 11:57:05 +0100
Subject: [PATCH 039/146] change `useMutation` to `queryClient.fetchQuery`

---
 .../src/controller/list/useSelectAll.tsx      | 54 ++++++++++++-------
 1 file changed, 35 insertions(+), 19 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 5036e6ad8b7..1eccd5f7105 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -1,4 +1,4 @@
-import { useMutation } from '@tanstack/react-query';
+import { useQueryClient } from '@tanstack/react-query';
 import { useNotify } from '../../notification';
 import { useDataProvider } from '../../dataProvider';
 import { useRecordSelection } from './useRecordSelection';
@@ -33,19 +33,35 @@ export const useSelectAll = ({
 }: useSelectAllProps): (() => void) => {
     const notify = useNotify();
     const dataProvider = useDataProvider();
+    const queryClient = useQueryClient();
     const [_, selectionModifiers] = useRecordSelection({ resource });
-    const { mutate: onSelectAll } = useMutation({
-        mutationFn: () =>
-            dataProvider.getList(resource, {
-                pagination: {
-                    page: 1,
-                    perPage: selectAllLimit,
-                },
-                sort: { field: query.sort, order: query.order },
-                filter: { ...query.filter, ...filter },
-                meta,
-            }),
-        onSuccess: ({ data }) => {
+
+    const onSelectAll = async () => {
+        try {
+            const { data } = await queryClient.fetchQuery({
+                queryKey: [
+                    resource,
+                    'getList',
+                    {
+                        resource,
+                        pagination: { page: 1, perPage: selectAllLimit },
+                        sort: { field: query.sort, order: query.order },
+                        filter: { ...query.filter, ...filter },
+                        meta,
+                    },
+                ],
+                queryFn: () =>
+                    dataProvider.getList(resource, {
+                        pagination: {
+                            page: 1,
+                            perPage: selectAllLimit,
+                        },
+                        sort: { field: query.sort, order: query.order },
+                        filter: { ...query.filter, ...filter },
+                        meta,
+                    }),
+            });
+
             const allIds = data?.map(({ id }) => id) || [];
             selectionModifiers.select(allIds);
             if (allIds.length === selectAllLimit) {
@@ -54,13 +70,13 @@ export const useSelectAll = ({
                     type: 'warning',
                 });
             }
-        },
-        onError: e => {
-            console.error('Mutation Error: ', e);
-            notify('An error occurred. Please try again.');
-        },
-    });
 
+            return data;
+        } catch (error) {
+            console.error('Mutation Error: ', error);
+            notify('An error occurred. Please try again.');
+        }
+    };
     return onSelectAll;
 };
 

From a3a9b8b05f2fcf360f0764e0736a7e80f5cc6b71 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Mon, 2 Dec 2024 11:50:06 +0100
Subject: [PATCH 040/146] Isolate test components in stories->
 `useReferenceArrayField`

---
 .../field/ReferenceArrayField.stories.tsx     | 95 +++++++++++++++++++
 .../useReferenceArrayFieldController.spec.tsx | 79 ++-------------
 2 files changed, 102 insertions(+), 72 deletions(-)
 create mode 100644 packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx

diff --git a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
new file mode 100644
index 00000000000..ff12a50da4b
--- /dev/null
+++ b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
@@ -0,0 +1,95 @@
+import * as React from 'react';
+import {
+    CoreAdminContext,
+    type GetManyResult,
+    type ListControllerResult,
+    testDataProvider,
+    useReferenceArrayFieldController,
+} from '../..';
+
+const dataProvider = testDataProvider({
+    getMany: (_resource, _params): Promise<GetManyResult> =>
+        Promise.resolve({
+            data: [
+                { id: 1, title: 'bar1' },
+                { id: 2, title: 'bar2' },
+            ],
+        }),
+});
+
+const ReferenceArrayFieldController = props => {
+    const { children, ...rest } = props;
+    const controllerProps = useReferenceArrayFieldController({
+        sort: {
+            field: 'id',
+            order: 'ASC',
+        },
+        ...rest,
+    });
+    return children(controllerProps);
+};
+
+const ReferenceArrayFieldComponent = (props: ListControllerResult) => (
+    <div>
+        <div
+            style={{
+                display: 'flex',
+                alignItems: 'center',
+                gap: '10px',
+            }}
+        >
+            <button
+                onClick={props.onSelectAll}
+                disabled={props.areAllItemsSelected}
+            >
+                Select All
+            </button>
+            <button
+                onClick={props.onUnselectItems}
+                disabled={props.selectedIds.length === 0}
+            >
+                Unselect All
+            </button>
+            <p>Selected ids: {JSON.stringify(props.selectedIds)}</p>
+        </div>
+        <ul
+            style={{
+                listStyleType: 'none',
+            }}
+        >
+            {props.data?.map(record => (
+                <li key={record.id}>
+                    <input
+                        type="checkbox"
+                        checked={props.selectedIds.includes(record.id)}
+                        onChange={() => props.onToggleItem(record.id)}
+                        style={{
+                            cursor: 'pointer',
+                            marginRight: '10px',
+                        }}
+                    />
+                    {record.id} - {record.title}
+                </li>
+            ))}
+        </ul>
+    </div>
+);
+
+export const ReferenceArrayField = ({
+    children = props => <ReferenceArrayFieldComponent {...props} />,
+}) => (
+    <CoreAdminContext dataProvider={dataProvider}>
+        <ReferenceArrayFieldController
+            resource="foo"
+            reference="bar"
+            record={{ id: 1, barIds: [1, 2] }}
+            source="barIds"
+        >
+            {children}
+        </ReferenceArrayFieldController>
+    </CoreAdminContext>
+);
+
+export default {
+    title: 'ra-core/fields/ReferenceArrayField',
+};
diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 3428dab671e..610ac73983c 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -5,6 +5,7 @@ import { act, render, waitFor } from '@testing-library/react';
 import { useReferenceArrayFieldController } from './useReferenceArrayFieldController';
 import { testDataProvider } from '../../dataProvider';
 import { CoreAdminContext } from '../../core';
+import { ReferenceArrayField } from './ReferenceArrayField.stories';
 
 const ReferenceArrayFieldController = props => {
     const { children, ...rest } = props;
@@ -170,18 +171,7 @@ describe('<useReferenceArrayFieldController />', () => {
     describe('areAllItemsSelected', () => {
         it('should be false if no items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceArrayFieldController
-                        resource="foo"
-                        reference="bar"
-                        record={{ id: 1, barIds: [1, 2] }}
-                        source="barIds"
-                    >
-                        {children}
-                    </ReferenceArrayFieldController>
-                </CoreAdminContext>
-            );
+            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
@@ -197,18 +187,7 @@ describe('<useReferenceArrayFieldController />', () => {
         });
         it('should be false if some items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceArrayFieldController
-                        resource="foo"
-                        reference="bar"
-                        record={{ id: 1, barIds: [1, 2] }}
-                        source="barIds"
-                    >
-                        {children}
-                    </ReferenceArrayFieldController>
-                </CoreAdminContext>
-            );
+            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([1]);
             });
@@ -228,18 +207,7 @@ describe('<useReferenceArrayFieldController />', () => {
         });
         it('should be true if all items are manually selected', async () => {
             const children = jest.fn().mockReturnValue('child');
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceArrayFieldController
-                        resource="foo"
-                        reference="bar"
-                        record={{ id: 1, barIds: [1, 2] }}
-                        source="barIds"
-                    >
-                        {children}
-                    </ReferenceArrayFieldController>
-                </CoreAdminContext>
-            );
+            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([1, 2]);
             });
@@ -259,18 +227,7 @@ describe('<useReferenceArrayFieldController />', () => {
         });
         it('should be true if all items are selected with onSelectAll', async () => {
             const children = jest.fn().mockReturnValue('child');
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceArrayFieldController
-                        resource="foo"
-                        reference="bar"
-                        record={{ id: 1, barIds: [1, 2] }}
-                        source="barIds"
-                    >
-                        {children}
-                    </ReferenceArrayFieldController>
-                </CoreAdminContext>
-            );
+            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
@@ -306,18 +263,7 @@ describe('<useReferenceArrayFieldController />', () => {
     describe('onSelectAll', () => {
         it('should select all items if no items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceArrayFieldController
-                        resource="foo"
-                        reference="bar"
-                        record={{ id: 1, barIds: [1, 2] }}
-                        source="barIds"
-                    >
-                        {children}
-                    </ReferenceArrayFieldController>
-                </CoreAdminContext>
-            );
+            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
@@ -341,18 +287,7 @@ describe('<useReferenceArrayFieldController />', () => {
         });
         it('should select all items if some items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceArrayFieldController
-                        resource="foo"
-                        reference="bar"
-                        record={{ id: 1, barIds: [1, 2] }}
-                        source="barIds"
-                    >
-                        {children}
-                    </ReferenceArrayFieldController>
-                </CoreAdminContext>
-            );
+            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({

From 30c1d2851a66fcb3ec9ea8c7009f17997ca9c298 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Mon, 2 Dec 2024 14:33:34 +0100
Subject: [PATCH 041/146] Isolate test components in stories->
 `useReferenceManyField`

---
 .../field/ReferenceArrayField.stories.tsx     |   2 +-
 .../field/ReferenceManyField.stories.tsx      | 118 +++++++++++
 .../useReferenceManyFieldController.spec.tsx  | 191 ++----------------
 3 files changed, 134 insertions(+), 177 deletions(-)
 create mode 100644 packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx

diff --git a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
index ff12a50da4b..393fba8146a 100644
--- a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
+++ b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
@@ -76,7 +76,7 @@ const ReferenceArrayFieldComponent = (props: ListControllerResult) => (
 );
 
 export const ReferenceArrayField = ({
-    children = props => <ReferenceArrayFieldComponent {...props} />,
+    children = ReferenceArrayFieldComponent,
 }) => (
     <CoreAdminContext dataProvider={dataProvider}>
         <ReferenceArrayFieldController
diff --git a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
new file mode 100644
index 00000000000..9ddf1b98248
--- /dev/null
+++ b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
@@ -0,0 +1,118 @@
+import * as React from 'react';
+import {
+    CoreAdminContext,
+    type GetManyResult,
+    type ListControllerResult,
+    testDataProvider,
+    useReferenceManyFieldController,
+} from '../..';
+
+const defaultDataProvider = testDataProvider({
+    getManyReference: (_resource, params): Promise<GetManyResult> =>
+        Promise.resolve({
+            data: [
+                { id: 0, title: 'bar0' },
+                { id: 1, title: 'bar1' },
+            ].slice(0, params.pagination.perPage),
+            total: params.pagination.perPage || 2,
+        }),
+});
+
+const ReferenceManyFieldController = props => {
+    const { children, ...rest } = props;
+    const controllerProps = useReferenceManyFieldController({
+        sort: {
+            field: 'id',
+            order: 'ASC',
+        },
+        ...rest,
+    });
+    return children(controllerProps);
+};
+
+const ReferenceManyField = (
+    props: ListControllerResult & { selectAllLimit?: number }
+) => (
+    <div>
+        <div
+            style={{
+                display: 'flex',
+                alignItems: 'center',
+                gap: '10px',
+            }}
+        >
+            <button
+                onClick={props.onSelectAll}
+                disabled={props.areAllItemsSelected}
+            >
+                Select All
+            </button>
+            <button
+                onClick={props.onUnselectItems}
+                disabled={props.selectedIds.length === 0}
+            >
+                Unselect All
+            </button>
+            <p>Selected ids: {JSON.stringify(props.selectedIds)}</p>
+            {props.selectAllLimit && (
+                <p>selectAllLimit : {props.selectAllLimit}</p>
+            )}
+        </div>
+        <ul
+            style={{
+                listStyleType: 'none',
+            }}
+        >
+            {props.data?.map(record => (
+                <li key={record.id}>
+                    <input
+                        type="checkbox"
+                        checked={props.selectedIds.includes(record.id)}
+                        onChange={() => props.onToggleItem(record.id)}
+                        style={{
+                            cursor: 'pointer',
+                            marginRight: '10px',
+                        }}
+                    />
+                    {record.id} - {record.title}
+                </li>
+            ))}
+        </ul>
+    </div>
+);
+
+export const Basic = ({ children = ReferenceManyField }) => (
+    <CoreAdminContext dataProvider={defaultDataProvider}>
+        <ReferenceManyFieldController
+            resource="authors"
+            source="id"
+            record={{ id: 123, name: 'James Joyce' }}
+            reference="books"
+            target="author_id"
+        >
+            {children}
+        </ReferenceManyFieldController>
+    </CoreAdminContext>
+);
+
+export const SelectAllLimit = ({
+    dataProvider = defaultDataProvider,
+    children = props => <ReferenceManyField selectAllLimit={1} {...props} />,
+}) => (
+    <CoreAdminContext dataProvider={dataProvider}>
+        <ReferenceManyFieldController
+            resource="authors"
+            source="id"
+            record={{ id: 123, name: 'James Joyce' }}
+            reference="books"
+            target="author_id"
+            selectAllLimit={1}
+        >
+            {children}
+        </ReferenceManyFieldController>
+    </CoreAdminContext>
+);
+
+export default {
+    title: 'ra-core/fields/ReferenceManyField',
+};
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index c9722926f03..9d77807b7ea 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -12,6 +12,7 @@ import { testDataProvider } from '../../dataProvider/testDataProvider';
 import { CoreAdminContext } from '../../core';
 import { useReferenceManyFieldController } from './useReferenceManyFieldController';
 import { memoryStore } from '../../store';
+import { Basic, SelectAllLimit } from './ReferenceManyField.stories';
 
 const ReferenceManyFieldController = props => {
     const { children, page = 1, perPage = 25, ...rest } = props;
@@ -422,25 +423,7 @@ describe('useReferenceManyFieldController', () => {
     describe('areAllItemsSelected', () => {
         it('should be false if no items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
-            const dataProvider = testDataProvider({
-                getManyReference: jest.fn().mockResolvedValue({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                }),
-            });
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceManyFieldController
-                        resource="authors"
-                        source="id"
-                        record={{ id: 123, name: 'James Joyce' }}
-                        reference="books"
-                        target="author_id"
-                    >
-                        {children}
-                    </ReferenceManyFieldController>
-                </CoreAdminContext>
-            );
+            render(<Basic>{children}</Basic>);
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
@@ -451,25 +434,7 @@ describe('useReferenceManyFieldController', () => {
         });
         it('should be false if some items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
-            const dataProvider = testDataProvider({
-                getManyReference: jest.fn().mockResolvedValue({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                }),
-            });
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceManyFieldController
-                        resource="authors"
-                        source="id"
-                        record={{ id: 123, name: 'James Joyce' }}
-                        reference="books"
-                        target="author_id"
-                    >
-                        {children}
-                    </ReferenceManyFieldController>
-                </CoreAdminContext>
-            );
+            render(<Basic>{children}</Basic>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([1]);
             });
@@ -484,25 +449,7 @@ describe('useReferenceManyFieldController', () => {
         });
         it('should be true if all items are manually selected', async () => {
             const children = jest.fn().mockReturnValue('child');
-            const dataProvider = testDataProvider({
-                getManyReference: jest.fn().mockResolvedValue({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                }),
-            });
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceManyFieldController
-                        resource="authors"
-                        source="id"
-                        record={{ id: 123, name: 'James Joyce' }}
-                        reference="books"
-                        target="author_id"
-                    >
-                        {children}
-                    </ReferenceManyFieldController>
-                </CoreAdminContext>
-            );
+            render(<Basic>{children}</Basic>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0, 1]);
             });
@@ -517,25 +464,7 @@ describe('useReferenceManyFieldController', () => {
         });
         it('should be true if all items are selected with onSelectAll', async () => {
             const children = jest.fn().mockReturnValue('child');
-            const dataProvider = testDataProvider({
-                getManyReference: jest.fn().mockResolvedValue({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                }),
-            });
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceManyFieldController
-                        resource="authors"
-                        source="id"
-                        record={{ id: 123, name: 'James Joyce' }}
-                        reference="books"
-                        target="author_id"
-                    >
-                        {children}
-                    </ReferenceManyFieldController>
-                </CoreAdminContext>
-            );
+            render(<Basic>{children}</Basic>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
@@ -550,26 +479,7 @@ describe('useReferenceManyFieldController', () => {
         });
         it('should be true if all we manually reached the selectAllLimit', async () => {
             const children = jest.fn().mockReturnValue('child');
-            const dataProvider = testDataProvider({
-                getManyReference: jest.fn().mockResolvedValue({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                }),
-            });
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceManyFieldController
-                        resource="authors"
-                        source="id"
-                        record={{ id: 123, name: 'James Joyce' }}
-                        reference="books"
-                        target="author_id"
-                        selectAllLimit={1}
-                    >
-                        {children}
-                    </ReferenceManyFieldController>
-                </CoreAdminContext>
-            );
+            render(<SelectAllLimit>{children}</SelectAllLimit>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
@@ -584,33 +494,7 @@ describe('useReferenceManyFieldController', () => {
         });
         it('should be true if all we reached the selectAllLimit with onSelectAll', async () => {
             const children = jest.fn().mockReturnValue('child');
-            const dataProvider = testDataProvider({
-                getManyReference: jest
-                    .fn()
-                    .mockImplementation((_resource, params) =>
-                        Promise.resolve({
-                            data: [{ id: 0 }, { id: 1 }].slice(
-                                0,
-                                params.pagination.perPage
-                            ),
-                            total: 2,
-                        })
-                    ),
-            });
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceManyFieldController
-                        resource="authors"
-                        source="id"
-                        record={{ id: 123, name: 'James Joyce' }}
-                        reference="books"
-                        target="author_id"
-                        selectAllLimit={1}
-                    >
-                        {children}
-                    </ReferenceManyFieldController>
-                </CoreAdminContext>
-            );
+            render(<SelectAllLimit>{children}</SelectAllLimit>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
@@ -628,26 +512,7 @@ describe('useReferenceManyFieldController', () => {
     describe('onSelectAll', () => {
         it('should select all items if no items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
-            const dataProvider = testDataProvider({
-                getManyReference: jest.fn().mockResolvedValue({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                }),
-            });
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceManyFieldController
-                        resource="authors"
-                        source="id"
-                        record={{ id: 123, name: 'James Joyce' }}
-                        reference="books"
-                        target="author_id"
-                        selectAllLimit={1}
-                    >
-                        {children}
-                    </ReferenceManyFieldController>
-                </CoreAdminContext>
-            );
+            render(<Basic>{children}</Basic>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
@@ -661,26 +526,7 @@ describe('useReferenceManyFieldController', () => {
         });
         it('should select all items if some items are selected', async () => {
             const children = jest.fn().mockReturnValue('child');
-            const dataProvider = testDataProvider({
-                getManyReference: jest.fn().mockResolvedValue({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                }),
-            });
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceManyFieldController
-                        resource="authors"
-                        source="id"
-                        record={{ id: 123, name: 'James Joyce' }}
-                        reference="books"
-                        target="author_id"
-                        selectAllLimit={1}
-                    >
-                        {children}
-                    </ReferenceManyFieldController>
-                </CoreAdminContext>
-            );
+            render(<Basic>{children}</Basic>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([1]);
             });
@@ -715,20 +561,13 @@ describe('useReferenceManyFieldController', () => {
                         total: 2,
                     })
                 );
-            const dataProvider = testDataProvider({ getManyReference });
+            const dataProvider = testDataProvider({
+                getManyReference,
+            });
             render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ReferenceManyFieldController
-                        resource="authors"
-                        source="id"
-                        record={{ id: 123, name: 'James Joyce' }}
-                        reference="books"
-                        target="author_id"
-                        selectAllLimit={1}
-                    >
-                        {children}
-                    </ReferenceManyFieldController>
-                </CoreAdminContext>
+                <SelectAllLimit dataProvider={dataProvider}>
+                    {children}
+                </SelectAllLimit>
             );
             await waitFor(() => {
                 expect(children).toHaveBeenNthCalledWith(

From 7e0f92d88637b3aadf0eac718fe25ceee6c3a3ac Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Mon, 2 Dec 2024 15:24:26 +0100
Subject: [PATCH 042/146] Isolate test components in stories->
 `useInfiniteListController`

---
 .../list/useInfiniteListController.spec.tsx   | 174 ++++--------------
 ... => useInfiniteListController.stories.tsx} | 107 ++++++++++-
 2 files changed, 135 insertions(+), 146 deletions(-)
 rename packages/ra-core/src/controller/list/{useInfiniteListController.security.stories.tsx => useInfiniteListController.stories.tsx} (67%)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index f4f417d5c7c..8470e2d2364 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -22,11 +22,12 @@ import {
 import { CoreAdminContext } from '../../core';
 import { TestMemoryRouter } from '../../routing';
 import {
+    Basic,
     Authenticated,
     CanAccess,
     DisableAuthentication,
-} from './useInfiniteListController.security.stories';
-import { AuthProvider } from '../../types';
+} from './useInfiniteListController.stories';
+import type { AuthProvider } from '../../types';
 
 const InfiniteListController = ({
     children,
@@ -45,24 +46,22 @@ describe('useInfiniteListController', () => {
         debounce: 200,
     };
 
+    const dataProvider = testDataProvider({
+        getList: jest.fn().mockImplementation((_resource, params) =>
+            Promise.resolve({
+                data: [{ id: 0 }, { id: 1 }].slice(
+                    0,
+                    params.pagination.perPage
+                ),
+                total: 2,
+            })
+        ),
+    });
+
     describe('areAllItemsSelected', () => {
         it('should be false if no items are selected', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
-            const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
-                </CoreAdminContext>
-            );
+            render(<Basic dataProvider={dataProvider} children={children} />);
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
@@ -73,22 +72,8 @@ describe('useInfiniteListController', () => {
             });
         });
         it('should be false if some items are selected', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
-            const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
-                </CoreAdminContext>
-            );
+            render(<Basic dataProvider={dataProvider} children={children} />);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
@@ -102,22 +87,8 @@ describe('useInfiniteListController', () => {
             });
         });
         it('should be true if all items are manually selected', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
-            const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
-                </CoreAdminContext>
-            );
+            render(<Basic dataProvider={dataProvider} children={children} />);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0, 1]);
             });
@@ -131,22 +102,8 @@ describe('useInfiniteListController', () => {
             });
         });
         it('should be true if all items are selected with onSelectAll', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
-            const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
-                </CoreAdminContext>
-            );
+            render(<Basic dataProvider={dataProvider} children={children} />);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
@@ -160,23 +117,13 @@ describe('useInfiniteListController', () => {
             });
         });
         it('should be true if all we manually reached the selectAllLimit', async () => {
-            const getList = jest.fn().mockImplementation(() =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                })
-            );
-            const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                selectAllLimit: 1,
-                children,
-            };
             render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
-                </CoreAdminContext>
+                <Basic
+                    dataProvider={dataProvider}
+                    children={children}
+                    selectAllLimit={1}
+                />
             );
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0]);
@@ -191,27 +138,13 @@ describe('useInfiniteListController', () => {
             });
         });
         it('should be true if all we reached the selectAllLimit with onSelectAll', async () => {
-            const getList = jest.fn().mockImplementation((_resource, params) =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }].slice(
-                        0,
-                        params.pagination.perPage
-                    ),
-                    total: 2,
-                })
-            );
-
-            const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                selectAllLimit: 1,
-                children,
-            };
             render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
-                </CoreAdminContext>
+                <Basic
+                    dataProvider={dataProvider}
+                    children={children}
+                    selectAllLimit={1}
+                />
             );
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
@@ -229,23 +162,8 @@ describe('useInfiniteListController', () => {
 
     describe('onSelectAll', () => {
         it('should select all items if no items are selected', async () => {
-            const getList = jest.fn().mockImplementation(() =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                })
-            );
-            const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
-                </CoreAdminContext>
-            );
+            render(<Basic dataProvider={dataProvider} children={children} />);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
@@ -258,23 +176,8 @@ describe('useInfiniteListController', () => {
             });
         });
         it('should select all items if some items are selected', async () => {
-            const getList = jest.fn().mockImplementation(() =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                })
-            );
-            const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
-                </CoreAdminContext>
-            );
+            render(<Basic dataProvider={dataProvider} children={children} />);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
@@ -306,17 +209,14 @@ describe('useInfiniteListController', () => {
                     total: 2,
                 })
             );
-            const dataProvider = testDataProvider({ getList });
+            const mockedDataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                selectAllLimit: 1,
-                children,
-            };
             render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <InfiniteListController {...props} />
-                </CoreAdminContext>
+                <Basic
+                    dataProvider={mockedDataProvider}
+                    selectAllLimit={1}
+                    children={children}
+                />
             );
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.security.stories.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
similarity index 67%
rename from packages/ra-core/src/controller/list/useInfiniteListController.security.stories.tsx
rename to packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
index cf358e6df7d..8c082783ccb 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.security.stories.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
@@ -4,10 +4,7 @@ import { QueryClient } from '@tanstack/react-query';
 import { Link } from 'react-router-dom';
 import { CoreAdmin, CoreAdminContext, CoreAdminUI, Resource } from '../../core';
 import { AuthProvider, DataProvider } from '../../types';
-import {
-    InfiniteListControllerProps,
-    useInfiniteListController,
-} from './useInfiniteListController';
+import { useInfiniteListController } from './useInfiniteListController';
 import { Browser } from '../../storybook/FakeBrowser';
 import { TestMemoryRouter } from '../../routing';
 
@@ -41,11 +38,7 @@ const defaultDataProvider = fakeDataProvider(
     process.env.NODE_ENV === 'development'
 );
 
-const Posts = (props: Partial<InfiniteListControllerProps>) => {
-    const params = useInfiniteListController({
-        resource: 'posts',
-        ...props,
-    });
+const List = params => {
     return (
         <div style={styles.mainContainer}>
             {params.isPending ? (
@@ -65,6 +58,102 @@ const Posts = (props: Partial<InfiniteListControllerProps>) => {
     );
 };
 
+const Posts = ({ children = List, ...props }) => {
+    const params = useInfiniteListController({
+        resource: 'posts',
+        ...props,
+    });
+    return children(params);
+};
+
+const ListWithCheckbox = params => (
+    <div style={styles.mainContainer}>
+        {params.isPending ? (
+            <p>Loading...</p>
+        ) : (
+            <div>
+                <div
+                    style={{
+                        display: 'flex',
+                        alignItems: 'center',
+                        gap: '10px',
+                    }}
+                >
+                    <button
+                        onClick={params.onSelectAll}
+                        disabled={params.areAllItemsSelected}
+                    >
+                        Select All
+                    </button>
+                    <button
+                        onClick={params.onUnselectItems}
+                        disabled={params.selectedIds.length === 0}
+                    >
+                        Unselect All
+                    </button>
+                    <p>Selected ids: {JSON.stringify(params.selectedIds)}</p>
+                    {params.selectAllLimit && (
+                        <p>selectAllLimit : {params.selectAllLimit}</p>
+                    )}
+                </div>
+                <ul
+                    style={{
+                        listStyleType: 'none',
+                        ...styles.ul,
+                    }}
+                >
+                    {params.data?.map(record => (
+                        <li key={record.id}>
+                            <input
+                                type="checkbox"
+                                checked={params.selectedIds.includes(record.id)}
+                                onChange={() => params.onToggleItem(record.id)}
+                                style={{
+                                    cursor: 'pointer',
+                                    marginRight: '10px',
+                                }}
+                            />
+                            {record.id} - {record.title}
+                        </li>
+                    ))}
+                </ul>
+            </div>
+        )}
+    </div>
+);
+
+export const Basic = ({
+    dataProvider = defaultDataProvider,
+    selectAllLimit,
+    children = props => (
+        <ListWithCheckbox {...props} selectAllLimit={selectAllLimit} />
+    ),
+}: {
+    dataProvider?: DataProvider;
+    selectAllLimit?: number;
+    children?: (props) => React.JSX.Element;
+}) => {
+    return (
+        <TestMemoryRouter>
+            <CoreAdminContext dataProvider={dataProvider}>
+                <CoreAdminUI>
+                    <Resource
+                        name="posts"
+                        list={
+                            <Posts
+                                selectAllLimit={selectAllLimit}
+                                children={children}
+                            />
+                        }
+                    />
+                </CoreAdminUI>
+            </CoreAdminContext>
+        </TestMemoryRouter>
+    );
+};
+
+export const SelectAllLimit = () => <Basic selectAllLimit={5} />;
+
 const defaultAuthProvider: AuthProvider = {
     checkAuth: () => new Promise(resolve => setTimeout(resolve, 500)),
     login: () => Promise.resolve(),

From d9f1a594fa294bf358b4bb677602762bece5cdba Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Mon, 2 Dec 2024 15:52:31 +0100
Subject: [PATCH 043/146] Isolate test components in stories->
 `useListController`

---
 .../list/useListController.spec.tsx           | 185 ++++--------------
 .../list/useListController.stories.tsx        | 100 ++++++++++
 2 files changed, 142 insertions(+), 143 deletions(-)
 create mode 100644 packages/ra-core/src/controller/list/useListController.stories.tsx

diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index 2770fb4494c..40445cb9efe 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -22,6 +22,7 @@ import {
     CanAccess,
     DisableAuthentication,
 } from './useListController.security.stories';
+import { Basic } from './useListController.stories';
 
 describe('useListController', () => {
     const defaultProps = {
@@ -586,24 +587,21 @@ describe('useListController', () => {
         });
     });
 
+    const dataProvider = testDataProvider({
+        getList: jest.fn().mockImplementation((_resource, params) =>
+            Promise.resolve({
+                data: [{ id: 0 }, { id: 1 }].slice(
+                    0,
+                    params.pagination.perPage
+                ),
+                total: 2,
+            })
+        ),
+    });
     describe('areAllItemsSelected', () => {
         it('should be false if no items are selected', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ListController {...props} />
-                </CoreAdminContext>
-            );
+            const children = jest.fn().mockReturnValue(<></>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
@@ -614,22 +612,8 @@ describe('useListController', () => {
             });
         });
         it('should be false if some items are selected', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ListController {...props} />
-                </CoreAdminContext>
-            );
+            const children = jest.fn().mockReturnValue(<></>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
@@ -643,22 +627,8 @@ describe('useListController', () => {
             });
         });
         it('should be true if all items are manually selected', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ListController {...props} />
-                </CoreAdminContext>
-            );
+            const children = jest.fn().mockReturnValue(<></>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0, 1]);
             });
@@ -672,22 +642,8 @@ describe('useListController', () => {
             });
         });
         it('should be true if all items are selected with onSelectAll', async () => {
-            const getList = jest
-                .fn()
-                .mockImplementation(() =>
-                    Promise.resolve({ data: [{ id: 0 }, { id: 1 }], total: 2 })
-                );
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ListController {...props} />
-                </CoreAdminContext>
-            );
+            const children = jest.fn().mockReturnValue(<></>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
@@ -703,23 +659,13 @@ describe('useListController', () => {
             });
         });
         it('should be true if all we manually reached the selectAllLimit', async () => {
-            const getList = jest.fn().mockImplementation(() =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                })
-            );
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                selectAllLimit: 1,
-                children,
-            };
+            const children = jest.fn().mockReturnValue(<></>);
             render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ListController {...props} />
-                </CoreAdminContext>
+                <Basic
+                    dataProvider={dataProvider}
+                    selectAllLimit={1}
+                    children={children}
+                />
             );
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0]);
@@ -734,27 +680,13 @@ describe('useListController', () => {
             });
         });
         it('should be true if all we reached the selectAllLimit with onSelectAll', async () => {
-            const getList = jest.fn().mockImplementation((_resource, params) =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }].slice(
-                        0,
-                        params.pagination.perPage
-                    ),
-                    total: 2,
-                })
-            );
-
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                selectAllLimit: 1,
-                children,
-            };
+            const children = jest.fn().mockReturnValue(<></>);
             render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ListController {...props} />
-                </CoreAdminContext>
+                <Basic
+                    dataProvider={dataProvider}
+                    selectAllLimit={1}
+                    children={children}
+                />
             );
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
@@ -774,23 +706,8 @@ describe('useListController', () => {
 
     describe('onSelectAll', () => {
         it('should select all items if no items are selected', async () => {
-            const getList = jest.fn().mockImplementation(() =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                })
-            );
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ListController {...props} />
-                </CoreAdminContext>
-            );
+            const children = jest.fn().mockReturnValue(<></>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
@@ -803,23 +720,8 @@ describe('useListController', () => {
             });
         });
         it('should select all items if some items are selected', async () => {
-            const getList = jest.fn().mockImplementation(() =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }],
-                    total: 2,
-                })
-            );
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                children,
-            };
-            render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ListController {...props} />
-                </CoreAdminContext>
-            );
+            const children = jest.fn().mockReturnValue(<></>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
@@ -852,16 +754,13 @@ describe('useListController', () => {
                 })
             );
             const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            const props = {
-                ...defaultProps,
-                selectAllLimit: 1,
-                children,
-            };
+            const children = jest.fn().mockReturnValue(<></>);
             render(
-                <CoreAdminContext dataProvider={dataProvider}>
-                    <ListController {...props} />
-                </CoreAdminContext>
+                <Basic
+                    dataProvider={dataProvider}
+                    selectAllLimit={1}
+                    children={children}
+                />
             );
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
diff --git a/packages/ra-core/src/controller/list/useListController.stories.tsx b/packages/ra-core/src/controller/list/useListController.stories.tsx
new file mode 100644
index 00000000000..3353a3eca67
--- /dev/null
+++ b/packages/ra-core/src/controller/list/useListController.stories.tsx
@@ -0,0 +1,100 @@
+import * as React from 'react';
+import fakeDataProvider from 'ra-data-fakerest';
+
+import { CoreAdminContext } from '../../core';
+import { ListController } from './ListController';
+import type { DataProvider } from '../../types';
+import type { ListControllerResult } from './useListController';
+
+export default {
+    title: 'ra-core/controller/list/useListController',
+};
+
+const defaultDataProvider = fakeDataProvider(
+    {
+        posts: [
+            { id: 1, title: 'Post #1', votes: 90 },
+            { id: 2, title: 'Post #2', votes: 20 },
+            { id: 3, title: 'Post #3', votes: 30 },
+            { id: 4, title: 'Post #4', votes: 40 },
+            { id: 5, title: 'Post #5', votes: 50 },
+            { id: 6, title: 'Post #6', votes: 60 },
+            { id: 7, title: 'Post #7', votes: 70 },
+        ],
+    },
+    process.env.NODE_ENV === 'development'
+);
+
+const List = params => (
+    <div>
+        <div
+            style={{
+                display: 'flex',
+                alignItems: 'center',
+                gap: '10px',
+            }}
+        >
+            <button
+                onClick={params.onSelectAll}
+                disabled={params.areAllItemsSelected}
+            >
+                Select All
+            </button>
+            <button
+                onClick={params.onUnselectItems}
+                disabled={params.selectedIds.length === 0}
+            >
+                Unselect All
+            </button>
+            <p>Selected ids: {JSON.stringify(params.selectedIds)}</p>
+            {params.selectAllLimit && (
+                <p>selectAllLimit : {params.selectAllLimit}</p>
+            )}
+        </div>
+        <ul
+            style={{
+                listStyleType: 'none',
+            }}
+        >
+            {params.data?.map(record => (
+                <li key={record.id}>
+                    <input
+                        type="checkbox"
+                        checked={params.selectedIds.includes(record.id)}
+                        onChange={() => params.onToggleItem(record.id)}
+                        style={{
+                            cursor: 'pointer',
+                            marginRight: '10px',
+                        }}
+                    />
+                    {record.id} - {record.title}
+                </li>
+            ))}
+        </ul>
+    </div>
+);
+
+export const Basic = ({
+    dataProvider = defaultDataProvider,
+    selectAllLimit,
+    children = List,
+}: {
+    dataProvider?: DataProvider;
+    selectAllLimit?: number;
+    children?: (params: ListControllerResult) => JSX.Element;
+}) => (
+    <CoreAdminContext dataProvider={dataProvider}>
+        <ListController
+            resource="posts"
+            selectAllLimit={selectAllLimit}
+            children={children}
+        />
+    </CoreAdminContext>
+);
+
+export const SelectAllLimit = () => (
+    <Basic
+        selectAllLimit={5}
+        children={props => <List {...props} selectAllLimit={5} />}
+    />
+);

From 04ddc21ea89d2f481cf1256a891b3d046af7cfed Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Mon, 2 Dec 2024 16:08:59 +0100
Subject: [PATCH 044/146] change `useMutation` to `queryClient.fetchQuery` in
 `useReferenceManyFieldController`

---
 .../field/useReferenceManyFieldController.ts  | 74 ++++++++++++++-----
 1 file changed, 54 insertions(+), 20 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 423b5c11a45..bf2956a7630 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { UseQueryOptions, useMutation } from '@tanstack/react-query';
+import { UseQueryOptions, useQueryClient } from '@tanstack/react-query';
 import get from 'lodash/get';
 import isEqual from 'lodash/isEqual';
 import lodashDebounce from 'lodash/debounce';
@@ -71,6 +71,7 @@ export const useReferenceManyFieldController = <
     const dataProvider = useDataProvider();
     const storeKey = props.storeKey ?? `${resource}.${record?.id}.${reference}`;
     const { meta, ...otherQueryOptions } = queryOptions;
+    const queryClient = useQueryClient();
 
     // pagination logic
     const { page, setPage, perPage, setPerPage } = usePaginationState({
@@ -202,20 +203,38 @@ export const useReferenceManyFieldController = <
         }
     );
 
-    const { mutate: onSelectAll } = useMutation({
-        mutationFn: () =>
-            dataProvider.getManyReference(reference, {
-                target,
-                id: get(record, source) as Identifier,
-                pagination: {
-                    page: 1,
-                    perPage: selectAllLimit,
-                },
-                sort,
-                filter: filterValues,
-                meta,
-            }),
-        onSuccess: ({ data }) => {
+    const onSelectAll = useCallback(async () => {
+        try {
+            const { data } = await queryClient.fetchQuery({
+                queryKey: [
+                    resource,
+                    'getManyReference',
+                    {
+                        target,
+                        id: get(record, source) as Identifier,
+                        pagination: {
+                            page: 1,
+                            perPage: selectAllLimit,
+                        },
+                        sort,
+                        filter: filterValues,
+                        meta,
+                    },
+                ],
+                queryFn: () =>
+                    dataProvider.getManyReference(reference, {
+                        target,
+                        id: get(record, source) as Identifier,
+                        pagination: {
+                            page: 1,
+                            perPage: selectAllLimit,
+                        },
+                        sort,
+                        filter: filterValues,
+                        meta,
+                    }),
+            });
+
             const allIds = data?.map(({ id }) => id) || [];
             selectionModifiers.select(allIds);
             if (allIds.length === selectAllLimit) {
@@ -224,12 +243,27 @@ export const useReferenceManyFieldController = <
                     type: 'warning',
                 });
             }
-        },
-        onError: e => {
-            console.error('Mutation Error: ', e);
+
+            return data;
+        } catch (error) {
+            console.error('Mutation Error: ', error);
             notify('An error occurred. Please try again.');
-        },
-    });
+        }
+    }, [
+        dataProvider,
+        filterValues,
+        meta,
+        notify,
+        queryClient,
+        record,
+        reference,
+        resource,
+        selectAllLimit,
+        selectionModifiers,
+        sort,
+        source,
+        target,
+    ]);
 
     return {
         sort,

From 31c996be5b10a9e5cae09d33554ce9fa626770d5 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 5 Dec 2024 19:28:50 +0100
Subject: [PATCH 045/146] change the structure

---
 .../field/useReferenceArrayFieldController.ts |  1 -
 .../field/useReferenceManyFieldController.ts  | 74 +------------------
 .../src/controller/list/ListContext.tsx       |  2 -
 packages/ra-core/src/controller/list/index.ts |  1 +
 .../list/useInfiniteListController.ts         | 15 ----
 .../ra-core/src/controller/list/useList.ts    |  7 --
 .../list/useListContextWithProps.ts           |  6 --
 .../src/controller/list/useListController.ts  | 28 -------
 .../src/controller/list/useSelectAll.tsx      | 47 ++++++------
 .../src/button/SelectAllButton.tsx            | 71 ++++++++++++++++++
 packages/ra-ui-materialui/src/button/index.ts |  1 +
 .../src/field/ReferenceArrayField.tsx         |  3 -
 .../src/field/ReferenceManyField.tsx          |  2 -
 .../src/list/BulkActionsToolbar.tsx           | 18 +----
 .../src/list/InfiniteList.tsx                 |  3 -
 packages/ra-ui-materialui/src/list/List.tsx   |  3 -
 .../src/list/datagrid/Datagrid.tsx            | 10 ++-
 17 files changed, 109 insertions(+), 183 deletions(-)
 create mode 100644 packages/ra-ui-materialui/src/button/SelectAllButton.tsx

diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.ts b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.ts
index 840a8e9b4d3..af7bde8cfaf 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.ts
@@ -17,7 +17,6 @@ export interface UseReferenceArrayFieldControllerParams<
     resource?: string;
     sort?: SortPayload;
     source: string;
-    selectAllLimit?: number;
     queryOptions?: Omit<
         UseQueryOptions<ReferenceRecordType[]>,
         'queryFn' | 'queryKey'
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index bf2956a7630..06a8bb99e31 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -1,11 +1,11 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { UseQueryOptions, useQueryClient } from '@tanstack/react-query';
+import { UseQueryOptions } from '@tanstack/react-query';
 import get from 'lodash/get';
 import isEqual from 'lodash/isEqual';
 import lodashDebounce from 'lodash/debounce';
 
 import { removeEmpty } from '../../util';
-import { useDataProvider, useGetManyReference } from '../../dataProvider';
+import { useGetManyReference } from '../../dataProvider';
 import { useNotify } from '../../notification';
 import { FilterPayload, Identifier, RaRecord, SortPayload } from '../../types';
 import { ListControllerResult } from '../list';
@@ -64,14 +64,11 @@ export const useReferenceManyFieldController = <
             { data: ReferenceRecordType[]; total: number },
             Error
         >,
-        selectAllLimit = 250,
     } = props;
     const notify = useNotify();
     const resource = useResourceContext(props);
-    const dataProvider = useDataProvider();
     const storeKey = props.storeKey ?? `${resource}.${record?.id}.${reference}`;
     const { meta, ...otherQueryOptions } = queryOptions;
-    const queryClient = useQueryClient();
 
     // pagination logic
     const { page, setPage, perPage, setPerPage } = usePaginationState({
@@ -203,68 +200,6 @@ export const useReferenceManyFieldController = <
         }
     );
 
-    const onSelectAll = useCallback(async () => {
-        try {
-            const { data } = await queryClient.fetchQuery({
-                queryKey: [
-                    resource,
-                    'getManyReference',
-                    {
-                        target,
-                        id: get(record, source) as Identifier,
-                        pagination: {
-                            page: 1,
-                            perPage: selectAllLimit,
-                        },
-                        sort,
-                        filter: filterValues,
-                        meta,
-                    },
-                ],
-                queryFn: () =>
-                    dataProvider.getManyReference(reference, {
-                        target,
-                        id: get(record, source) as Identifier,
-                        pagination: {
-                            page: 1,
-                            perPage: selectAllLimit,
-                        },
-                        sort,
-                        filter: filterValues,
-                        meta,
-                    }),
-            });
-
-            const allIds = data?.map(({ id }) => id) || [];
-            selectionModifiers.select(allIds);
-            if (allIds.length === selectAllLimit) {
-                notify('ra.message.too_many_elements', {
-                    messageArgs: { max: selectAllLimit },
-                    type: 'warning',
-                });
-            }
-
-            return data;
-        } catch (error) {
-            console.error('Mutation Error: ', error);
-            notify('An error occurred. Please try again.');
-        }
-    }, [
-        dataProvider,
-        filterValues,
-        meta,
-        notify,
-        queryClient,
-        record,
-        reference,
-        resource,
-        selectAllLimit,
-        selectionModifiers,
-        sort,
-        source,
-        target,
-    ]);
-
     return {
         sort,
         data,
@@ -278,7 +213,6 @@ export const useReferenceManyFieldController = <
         isLoading,
         isPending,
         onSelect: selectionModifiers.select,
-        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page,
@@ -286,9 +220,6 @@ export const useReferenceManyFieldController = <
         refetch,
         resource: reference,
         selectedIds,
-        areAllItemsSelected:
-            total === selectedIds.length ||
-            selectedIds.length >= selectAllLimit,
         setFilters,
         setPage,
         setPerPage,
@@ -318,7 +249,6 @@ export interface UseReferenceManyFieldControllerParams<
     sort?: SortPayload;
     source?: string;
     storeKey?: string;
-    selectAllLimit?: number;
     target: string;
     queryOptions?: Omit<
         UseQueryOptions<{ data: ReferenceRecordType[]; total: number }, Error>,
diff --git a/packages/ra-core/src/controller/list/ListContext.tsx b/packages/ra-core/src/controller/list/ListContext.tsx
index 5dc0692f790..f4af11d4495 100644
--- a/packages/ra-core/src/controller/list/ListContext.tsx
+++ b/packages/ra-core/src/controller/list/ListContext.tsx
@@ -24,9 +24,7 @@ import { ListControllerResult } from './useListController';
  * @prop {Function} showFilter a callback to show one of the filters, e.g. showFilter('title', defaultValue)
  * @prop {Function} hideFilter a callback to hide one of the filters, e.g. hideFilter('title')
  * @prop {Array}    selectedIds an array listing the ids of the selected rows, e.g. [123, 456]
- * @prop {boolean}  areAllItemsSelected boolean to indicate if the list is already fully selected
  * @prop {Function} onSelect callback to change the list of selected rows, e.g. onSelect([456, 789])
- * @prop {Function} onSelectAll callback to select all the records, e.g. onSelectAll()
  * @prop {Function} onToggleItem callback to toggle the selection of a given record based on its id, e.g. onToggleItem(456)
  * @prop {Function} onUnselectItems callback to clear the selection, e.g. onUnselectItems();
  * @prop {string}   defaultTitle the translated title based on the resource, e.g. 'Posts'
diff --git a/packages/ra-core/src/controller/list/index.ts b/packages/ra-core/src/controller/list/index.ts
index e1f1c39a4f2..1953cb4ad07 100644
--- a/packages/ra-core/src/controller/list/index.ts
+++ b/packages/ra-core/src/controller/list/index.ts
@@ -22,4 +22,5 @@ export * from './useListSortContext';
 export * from './useRecordSelection';
 export * from './useUnselect';
 export * from './useUnselectAll';
+export * from './useSelectAll';
 export * from './WithListContext';
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index 7730ba7e110..b91bc07066c 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -24,7 +24,6 @@ import { useRecordSelection } from './useRecordSelection';
 import { useListParams } from './useListParams';
 
 import { ListControllerResult } from './useListController';
-import { useSelectAll } from './useSelectAll';
 
 /**
  * Prepare data for the InfiniteList view
@@ -57,7 +56,6 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         queryOptions,
         sort,
         storeKey,
-        selectAllLimit = 250,
     } = props;
     const resource = useResourceContext(props);
     const { meta, ...otherQueryOptions } = queryOptions ?? {};
@@ -141,14 +139,6 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         }
     );
 
-    const onSelectAll = useSelectAll({
-        selectAllLimit,
-        query,
-        filter,
-        meta,
-        resource,
-    });
-
     // change page if there is no data
     useEffect(() => {
         if (
@@ -204,7 +194,6 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         isLoading,
         isPending,
         onSelect: selectionModifiers.select,
-        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page: query.page,
@@ -212,9 +201,6 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         refetch,
         resource,
         selectedIds,
-        areAllItemsSelected:
-            total === selectedIds.length ||
-            selectedIds.length >= selectAllLimit,
         setFilters: queryModifiers.setFilters,
         setPage: queryModifiers.setPage,
         setPerPage: queryModifiers.setPerPage,
@@ -247,7 +233,6 @@ export interface InfiniteListControllerProps<
     resource?: string;
     sort?: SortPayload;
     storeKey?: string | false;
-    selectAllLimit?: number;
 }
 
 export type InfiniteListControllerResult<RecordType extends RaRecord = any> =
diff --git a/packages/ra-core/src/controller/list/useList.ts b/packages/ra-core/src/controller/list/useList.ts
index dfef3073189..8ad6337c903 100644
--- a/packages/ra-core/src/controller/list/useList.ts
+++ b/packages/ra-core/src/controller/list/useList.ts
@@ -51,7 +51,6 @@ const refetch = () => {
  * @param {Number} props.perPage: Optional. The initial page size
  * @param {SortPayload} props.sort: Optional. The initial sort (field and order)
  * @param {filterCallback} prop.filterCallback Optional. A function that allows you to make a custom filter
- * @param {Number} props.selectAllLimit: Optional. The number of items selected by the "SELECT ALL" button of the bulk actions toolbar
  */
 export const useList = <RecordType extends RaRecord = any>(
     props: UseListOptions<RecordType>
@@ -164,10 +163,6 @@ export const useList = <RecordType extends RaRecord = any>(
         },
         [setDisplayedFilters, setFilterValues, setPage]
     );
-    const onSelectAll = useCallback(() => {
-        const allIds = data?.map(({ id }) => id) || [];
-        selectionModifiers.select(allIds);
-    }, [data, selectionModifiers]);
 
     // handle filter prop change
     useEffect(() => {
@@ -290,7 +285,6 @@ export const useList = <RecordType extends RaRecord = any>(
         isLoading: loadingState,
         isPending: pendingState,
         onSelect: selectionModifiers.select,
-        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page,
@@ -298,7 +292,6 @@ export const useList = <RecordType extends RaRecord = any>(
         resource: '',
         refetch,
         selectedIds,
-        areAllItemsSelected: data?.length === selectedIds.length,
         setFilters,
         setPage,
         setPerPage,
diff --git a/packages/ra-core/src/controller/list/useListContextWithProps.ts b/packages/ra-core/src/controller/list/useListContextWithProps.ts
index cb4abd796f3..206be897b56 100644
--- a/packages/ra-core/src/controller/list/useListContextWithProps.ts
+++ b/packages/ra-core/src/controller/list/useListContextWithProps.ts
@@ -33,9 +33,7 @@ import { RaRecord } from '../../types';
  * @prop {Function} showFilter a callback to show one of the filters, e.g. showFilter('title', defaultValue)
  * @prop {Function} hideFilter a callback to hide one of the filters, e.g. hideFilter('title')
  * @prop {Array}    selectedIds an array listing the ids of the selected rows, e.g. [123, 456]
- * @prop {boolean}  areAllItemsSelected boolean to indicate if the list is already fully selected
  * @prop {Function} onSelect callback to change the list of selected rows, e.g. onSelect([456, 789])
- * @prop {Function} onSelectAll callback to select all the records, e.g. onSelectAll()
  * @prop {Function} onToggleItem callback to toggle the selection of a given record based on its id, e.g. onToggleItem(456)
  * @prop {Function} onUnselectItems callback to clear the selection, e.g. onUnselectItems();
  * @prop {string}   defaultTitle the translated title based on the resource, e.g. 'Posts'
@@ -83,7 +81,6 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     isLoading,
     isPending,
     onSelect,
-    onSelectAll,
     onToggleItem,
     onUnselectItems,
     page,
@@ -91,7 +88,6 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     refetch,
     resource,
     selectedIds,
-    areAllItemsSelected,
     setFilters,
     setPage,
     setPerPage,
@@ -111,7 +107,6 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     isLoading,
     isPending,
     onSelect,
-    onSelectAll,
     onToggleItem,
     onUnselectItems,
     page,
@@ -119,7 +114,6 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     refetch,
     resource,
     selectedIds,
-    areAllItemsSelected,
     setFilters,
     setPage,
     setPerPage,
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index e1670a9b2c5..e93d9352303 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -47,7 +47,6 @@ export const useListController = <RecordType extends RaRecord = any>(
         queryOptions = {},
         sort = defaultSort,
         storeKey,
-        selectAllLimit = 250,
     } = props;
     const resource = useResourceContext(props);
     const { meta, ...otherQueryOptions } = queryOptions;
@@ -170,14 +169,6 @@ export const useListController = <RecordType extends RaRecord = any>(
         name: getResourceLabel(resource, 2),
     });
 
-    const onSelectAll = useSelectAll({
-        selectAllLimit,
-        query,
-        filter,
-        meta,
-        resource,
-    });
-
     return {
         sort: currentSort,
         data,
@@ -193,7 +184,6 @@ export const useListController = <RecordType extends RaRecord = any>(
         isLoading,
         isPending,
         onSelect: selectionModifiers.select,
-        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page: query.page,
@@ -201,9 +191,6 @@ export const useListController = <RecordType extends RaRecord = any>(
         refetch,
         resource,
         selectedIds,
-        areAllItemsSelected:
-            total === selectedIds.length ||
-            selectedIds.length >= selectAllLimit,
         setFilters: queryModifiers.setFilters,
         setPage: queryModifiers.setPage,
         setPerPage: queryModifiers.setPerPage,
@@ -423,19 +410,6 @@ export interface ListControllerProps<RecordType extends RaRecord = any> {
      * );
      */
     storeKey?: string | false;
-
-    /**
-     * The number of items selected by the "SELECT ALL" button of the bulk actions toolbar.
-     *
-     * @see https://marmelab.com/react-admin/List.html#selectalllimit
-     * @example
-     * export const PostList = () => (
-     *     <List selectAllLimit={500}>
-     *         ...
-     *     </List>
-     * );
-     */
-    selectAllLimit?: number;
 }
 
 const defaultSort = {
@@ -502,7 +476,6 @@ export interface ListControllerBaseResult<RecordType extends RaRecord = any> {
     filterValues: any;
     hideFilter: (filterName: string) => void;
     onSelect: (ids: RecordType['id'][]) => void;
-    onSelectAll: () => void;
     onToggleItem: (id: RecordType['id']) => void;
     onUnselectItems: () => void;
     page: number;
@@ -510,7 +483,6 @@ export interface ListControllerBaseResult<RecordType extends RaRecord = any> {
     refetch: (() => void) | UseGetListHookValue<RecordType>['refetch'];
     resource: string;
     selectedIds: RecordType['id'][];
-    areAllItemsSelected: boolean;
     setFilters: (
         filters: any,
         displayedFilters?: any,
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 1eccd5f7105..82dfcff9050 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -2,40 +2,44 @@ import { useQueryClient } from '@tanstack/react-query';
 import { useNotify } from '../../notification';
 import { useDataProvider } from '../../dataProvider';
 import { useRecordSelection } from './useRecordSelection';
-import type { ListParams } from './useListParams';
-import type { FilterPayload } from '../../types';
+import type { FilterPayload, SortPayload } from '../../types';
+import { useResourceContext } from '../../core';
 
 /**
  * Function hook to select all items of a list (until we reached the selectAllLimit)
  *
- * @param {string} resource Required. The resource name
- * @param {ListParams} query Required. The query object used to fetch the list of items
- * @param {number} selectAllLimit Optional. The number of items selected by the "SELECT ALL" button of the bulk actions toolbar
+ * @param {SortPayload} sort Optional. The sort parameter to apply to the getList query
  * @param {FilterPayload} filter Optional. Permanent filter applied to all getList queries, regardless of the user selected filters
  * @param {any} meta Optional. Additional meta data to pass to the dataProvider
+ * @param {number} limit Optional. The number of items selected by the "SELECT ALL" button of the bulk actions toolbar
  * @returns {Function} onSelectAll A function to select all items of a list
  *
  * @example
  *
  * const onSelectAll = useSelectAll({
- *     resource: 'posts',
- *     query: { sort: 'title', order: 'ASC' },
- *     selectAllLimit: 250,
+ *     sort: { sort: 'title', order: 'ASC' },
+ *     limit: 250,
  * });
  * return <Button onClick={onSelectAll}>Select All</Button>;
  */
 export const useSelectAll = ({
-    query,
-    resource,
-    selectAllLimit = 250,
+    sort = { field: 'id', order: 'ASC' },
     filter = {},
     meta = {},
+    limit = 250,
 }: useSelectAllProps): (() => void) => {
+    const resource = useResourceContext();
+    if (!resource) {
+        throw new Error(
+            'useSelectAll should be used inside a ResourceContextProvider'
+        );
+    }
     const notify = useNotify();
     const dataProvider = useDataProvider();
     const queryClient = useQueryClient();
     const [_, selectionModifiers] = useRecordSelection({ resource });
 
+    // TODO: useCallback
     const onSelectAll = async () => {
         try {
             const { data } = await queryClient.fetchQuery({
@@ -44,9 +48,9 @@ export const useSelectAll = ({
                     'getList',
                     {
                         resource,
-                        pagination: { page: 1, perPage: selectAllLimit },
-                        sort: { field: query.sort, order: query.order },
-                        filter: { ...query.filter, ...filter },
+                        pagination: { page: 1, perPage: limit },
+                        sort,
+                        filter,
                         meta,
                     },
                 ],
@@ -54,19 +58,19 @@ export const useSelectAll = ({
                     dataProvider.getList(resource, {
                         pagination: {
                             page: 1,
-                            perPage: selectAllLimit,
+                            perPage: limit,
                         },
-                        sort: { field: query.sort, order: query.order },
-                        filter: { ...query.filter, ...filter },
+                        sort,
+                        filter,
                         meta,
                     }),
             });
 
             const allIds = data?.map(({ id }) => id) || [];
             selectionModifiers.select(allIds);
-            if (allIds.length === selectAllLimit) {
+            if (allIds.length === limit) {
                 notify('ra.message.too_many_elements', {
-                    messageArgs: { max: selectAllLimit },
+                    messageArgs: { max: limit },
                     type: 'warning',
                 });
             }
@@ -81,9 +85,8 @@ export const useSelectAll = ({
 };
 
 export interface useSelectAllProps {
-    resource: string;
-    query: ListParams;
-    selectAllLimit?: number;
+    sort?: SortPayload;
     filter?: FilterPayload;
     meta?: any;
+    limit?: number;
 }
diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
new file mode 100644
index 00000000000..f9a97edb6e2
--- /dev/null
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -0,0 +1,71 @@
+import * as React from 'react';
+import {
+    type GetListParams,
+    type GetManyReferenceParams,
+    type RaRecord,
+    useListContext,
+    useSelectAll,
+} from 'ra-core';
+import type { UseMutationOptions } from '@tanstack/react-query';
+import { Button, ButtonProps } from './Button';
+import { useCallback } from 'react';
+
+/**
+ * Select All button for list forms
+ *
+ * @typedef {Object} Props the props you can use
+ * @prop {string} label Button label. Defaults to 'ra.action.select_all', translated.
+ * @prop {string} limit Maximum number of items to select. Defaults to 250.
+ * @prop {function} mutationOptions Object of options passed to react-query.
+ *
+ * @param {Props} props
+ *
+ * @example // with custom success side effect
+ *
+ * const MySelectAllButton = () => {
+ *     const notify = useNotify();
+ *     const onSuccess = (response) => {
+ *         notify('All items selected!', { type: 'info' });
+ *     };
+ *     return <SelectAllButton limit={100} mutationOptions={{ onSuccess }} />;
+ * }
+ */
+
+export const SelectAllButton = (props: SelectAllButtonProps) => {
+    const {
+        label = 'ra.action.select_all',
+        limit = 250,
+        mutationOptions,
+        ...rest
+    } = props;
+
+    const { filter, sort, meta, total, selectedIds } = useListContext();
+    const onSelectAll = useSelectAll({ limit, filter, sort, meta });
+    const handleSelectAll = useCallback(() => {
+        onSelectAll();
+    }, [onSelectAll]);
+
+    if (total === selectedIds.length || selectedIds.length >= limit)
+        return null;
+
+    return (
+        <Button
+            label={label}
+            onClick={handleSelectAll}
+            type="button"
+            {...rest}
+        />
+    );
+};
+
+export type SelectAllButtonProps<
+    RecordType extends RaRecord = any,
+    MutationOptionsError = unknown,
+> = ButtonProps & {
+    limit?: number;
+    mutationOptions?: UseMutationOptions<
+        RecordType,
+        MutationOptionsError,
+        GetManyReferenceParams | GetListParams
+    >;
+};
diff --git a/packages/ra-ui-materialui/src/button/index.ts b/packages/ra-ui-materialui/src/button/index.ts
index fdc1026811d..6b6faa09135 100644
--- a/packages/ra-ui-materialui/src/button/index.ts
+++ b/packages/ra-ui-materialui/src/button/index.ts
@@ -26,6 +26,7 @@ export * from './PrevNextButtons';
 export * from './RefreshButton';
 export * from './RefreshIconButton';
 export * from './SaveButton';
+export * from './SelectAllButton';
 export * from './SkipNavigationButton';
 export * from './ToggleThemeButton';
 export * from './UpdateButton';
diff --git a/packages/ra-ui-materialui/src/field/ReferenceArrayField.tsx b/packages/ra-ui-materialui/src/field/ReferenceArrayField.tsx
index d09762e41ca..72531c2e966 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceArrayField.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceArrayField.tsx
@@ -89,7 +89,6 @@ export const ReferenceArrayField = <
         resource,
         sort,
         source,
-        selectAllLimit = 250,
         queryOptions,
     } = props;
     const record = useRecordContext(props);
@@ -105,7 +104,6 @@ export const ReferenceArrayField = <
         resource,
         sort,
         source,
-        selectAllLimit,
         queryOptions,
     });
     return (
@@ -127,7 +125,6 @@ export interface ReferenceArrayFieldProps<
     perPage?: number;
     reference: string;
     sort?: SortPayload;
-    selectAllLimit?: number;
     sx?: SxProps;
     queryOptions?: UseQueryOptions<ReferenceRecordType[], Error>;
 }
diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.tsx
index 24c6dec6020..1413ca20515 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.tsx
@@ -74,7 +74,6 @@ export const ReferenceManyField = <
         sort = defaultSort,
         source = 'id',
         storeKey,
-        selectAllLimit = 250,
         target,
         queryOptions,
     } = props;
@@ -94,7 +93,6 @@ export const ReferenceManyField = <
         sort,
         source,
         storeKey,
-        selectAllLimit,
         target,
         queryOptions,
     });
diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index 70183052c1e..5be7846eaf0 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -10,7 +10,6 @@ import CloseIcon from '@mui/icons-material/Close';
 import { useTranslate, sanitizeListRestProps, useListContext } from 'ra-core';
 
 import TopToolbar from '../layout/TopToolbar';
-import { Button } from '../button';
 
 export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
     const {
@@ -19,12 +18,7 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
         className,
         ...rest
     } = props;
-    const {
-        selectedIds = [],
-        onUnselectItems,
-        onSelectAll,
-        areAllItemsSelected,
-    } = useListContext();
+    const { selectedIds = [], onUnselectItems } = useListContext();
 
     const translate = useTranslate();
 
@@ -32,10 +26,6 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
         onUnselectItems();
     }, [onUnselectItems]);
 
-    const handleSelectAll = useCallback(() => {
-        onSelectAll();
-    }, [onSelectAll]);
-
     return (
         <Root className={className}>
             <Toolbar
@@ -62,12 +52,6 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
                             smart_count: selectedIds.length,
                         })}
                     </Typography>
-                    {!areAllItemsSelected && (
-                        <Button
-                            label={translate('ra.action.select_all')}
-                            onClick={handleSelectAll}
-                        />
-                    )}
                 </div>
                 <TopToolbar className={BulkActionsToolbarClasses.topToolbar}>
                     {children}
diff --git a/packages/ra-ui-materialui/src/list/InfiniteList.tsx b/packages/ra-ui-materialui/src/list/InfiniteList.tsx
index 50eee6c9f3d..97395664ffc 100644
--- a/packages/ra-ui-materialui/src/list/InfiniteList.tsx
+++ b/packages/ra-ui-materialui/src/list/InfiniteList.tsx
@@ -36,7 +36,6 @@ import { Loading } from '../layout';
  * - perPage: Pagination Size
  * - queryOptions
  * - sort: Default Sort Field & Order
- * - selectAllLimit: The number of items selected by the "SELECT ALL" button of the bulk actions toolbar of the Datagrid
  * - title
  * - sx: CSS API
  *
@@ -74,7 +73,6 @@ export const InfiniteList = <RecordType extends RaRecord = any>({
     resource,
     sort,
     storeKey,
-    selectAllLimit = 250,
     ...rest
 }: InfiniteListProps<RecordType>): ReactElement => (
     <InfiniteListBase<RecordType>
@@ -90,7 +88,6 @@ export const InfiniteList = <RecordType extends RaRecord = any>({
         resource={resource}
         sort={sort}
         storeKey={storeKey}
-        selectAllLimit={selectAllLimit}
     >
         <ListView<RecordType> {...rest} pagination={pagination} />
     </InfiniteListBase>
diff --git a/packages/ra-ui-materialui/src/list/List.tsx b/packages/ra-ui-materialui/src/list/List.tsx
index 2c0e9b20feb..e562bf7ad50 100644
--- a/packages/ra-ui-materialui/src/list/List.tsx
+++ b/packages/ra-ui-materialui/src/list/List.tsx
@@ -32,7 +32,6 @@ import { Loading } from '../layout';
  * - perPage: Pagination Size
  * - queryOptions
  * - sort: Default Sort Field & Order
- * - selectAllLimit: The number of items selected by the "SELECT ALL" button of the bulk actions toolbar
  * - title
  * - sx: CSS API
  *
@@ -69,7 +68,6 @@ export const List = <RecordType extends RaRecord = any>({
     resource,
     sort,
     storeKey,
-    selectAllLimit = 250,
     ...rest
 }: ListProps<RecordType>): ReactElement => (
     <ListBase<RecordType>
@@ -85,7 +83,6 @@ export const List = <RecordType extends RaRecord = any>({
         resource={resource}
         sort={sort}
         storeKey={storeKey}
-        selectAllLimit={selectAllLimit}
     >
         <ListView<RecordType> {...rest} />
     </ListBase>
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
index 9a373ad9ba6..29e01ee5108 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
@@ -35,8 +35,14 @@ import { DatagridClasses, DatagridRoot } from './useDatagridStyles';
 import { BulkActionsToolbar } from '../BulkActionsToolbar';
 import { BulkDeleteButton } from '../../button';
 import { ListNoResults } from '../ListNoResults';
-
-const defaultBulkActionButtons = <BulkDeleteButton />;
+import { SelectAllButton } from '../../button/SelectAllButton';
+
+const defaultBulkActionButtons = (
+    <>
+        <SelectAllButton />
+        <BulkDeleteButton />
+    </>
+);
 
 /**
  * The Datagrid component renders a list of records as a table.

From 2b6e1d84833c8e5d90879b8b5555e3eabf683344 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 5 Dec 2024 22:16:11 +0100
Subject: [PATCH 046/146] remove useless tests

---
 .../useReferenceArrayFieldController.spec.tsx | 146 +------------
 .../useReferenceManyFieldController.spec.tsx  | 187 +----------------
 .../list/useInfiniteListController.spec.tsx   | 194 -----------------
 .../src/controller/list/useList.spec.tsx      | 109 +---------
 .../list/useListController.spec.tsx           | 197 ------------------
 5 files changed, 3 insertions(+), 830 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 610ac73983c..0a06a926efc 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -1,11 +1,10 @@
 import * as React from 'react';
 import expect from 'expect';
-import { act, render, waitFor } from '@testing-library/react';
+import { render, waitFor } from '@testing-library/react';
 
 import { useReferenceArrayFieldController } from './useReferenceArrayFieldController';
 import { testDataProvider } from '../../dataProvider';
 import { CoreAdminContext } from '../../core';
-import { ReferenceArrayField } from './ReferenceArrayField.stories';
 
 const ReferenceArrayFieldController = props => {
     const { children, ...rest } = props;
@@ -167,147 +166,4 @@ describe('<useReferenceArrayFieldController />', () => {
             })
         );
     });
-
-    describe('areAllItemsSelected', () => {
-        it('should be false if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                        total: 2,
-                    })
-                );
-            });
-        });
-        it('should be false if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([1]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                        total: 2,
-                        selectedIds: [1],
-                    })
-                );
-            });
-        });
-        it('should be true if all items are manually selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([1, 2]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                        total: 2,
-                        selectedIds: [1, 2],
-                    })
-                );
-            });
-        });
-        it('should be true if all items are selected with onSelectAll', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                        total: 2,
-                        selectedIds: [],
-                    })
-                );
-            });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                        total: 2,
-                        selectedIds: [1, 2],
-                    })
-                );
-            });
-        });
-    });
-
-    describe('onSelectAll', () => {
-        it('should select all items if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                    })
-                );
-            });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [1, 2],
-                    })
-                );
-            });
-        });
-        it('should select all items if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                    })
-                );
-            });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [1, 2],
-                    })
-                );
-            });
-        });
-    });
 });
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index 9d77807b7ea..64afc5570a4 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -1,18 +1,11 @@
 import * as React from 'react';
-import {
-    act,
-    fireEvent,
-    render,
-    screen,
-    waitFor,
-} from '@testing-library/react';
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
 import expect from 'expect';
 
 import { testDataProvider } from '../../dataProvider/testDataProvider';
 import { CoreAdminContext } from '../../core';
 import { useReferenceManyFieldController } from './useReferenceManyFieldController';
 import { memoryStore } from '../../store';
-import { Basic, SelectAllLimit } from './ReferenceManyField.stories';
 
 const ReferenceManyFieldController = props => {
     const { children, page = 1, perPage = 25, ...rest } = props;
@@ -419,182 +412,4 @@ describe('useReferenceManyFieldController', () => {
             );
         });
     });
-
-    describe('areAllItemsSelected', () => {
-        it('should be false if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<Basic>{children}</Basic>);
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                    })
-                );
-            });
-        });
-        it('should be false if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<Basic>{children}</Basic>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([1]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                        selectedIds: [1],
-                    })
-                );
-            });
-        });
-        it('should be true if all items are manually selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<Basic>{children}</Basic>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0, 1]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should be true if all items are selected with onSelectAll', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<Basic>{children}</Basic>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should be true if all we manually reached the selectAllLimit', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<SelectAllLimit>{children}</SelectAllLimit>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0],
-                    })
-                );
-            });
-        });
-        it('should be true if all we reached the selectAllLimit with onSelectAll', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<SelectAllLimit>{children}</SelectAllLimit>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0],
-                    })
-                );
-            });
-        });
-    });
-
-    describe('onSelectAll', () => {
-        it('should select all items if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<Basic>{children}</Basic>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should select all items if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<Basic>{children}</Basic>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([1]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [1],
-                    })
-                );
-            });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            const getManyReference = jest
-                .fn()
-                .mockImplementation((_resource, params) =>
-                    Promise.resolve({
-                        data: [{ id: 0 }, { id: 1 }].slice(
-                            0,
-                            params.pagination.perPage
-                        ),
-                        total: 2,
-                    })
-                );
-            const dataProvider = testDataProvider({
-                getManyReference,
-            });
-            render(
-                <SelectAllLimit dataProvider={dataProvider}>
-                    {children}
-                </SelectAllLimit>
-            );
-            await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
-                );
-            });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(getManyReference).toHaveBeenCalledWith(
-                    'books',
-                    expect.objectContaining({
-                        pagination: { page: 1, perPage: 1 },
-                    })
-                );
-            });
-        });
-    });
 });
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index 8470e2d2364..10aacf7eeb8 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -22,7 +22,6 @@ import {
 import { CoreAdminContext } from '../../core';
 import { TestMemoryRouter } from '../../routing';
 import {
-    Basic,
     Authenticated,
     CanAccess,
     DisableAuthentication,
@@ -46,199 +45,6 @@ describe('useInfiniteListController', () => {
         debounce: 200,
     };
 
-    const dataProvider = testDataProvider({
-        getList: jest.fn().mockImplementation((_resource, params) =>
-            Promise.resolve({
-                data: [{ id: 0 }, { id: 1 }].slice(
-                    0,
-                    params.pagination.perPage
-                ),
-                total: 2,
-            })
-        ),
-    });
-
-    describe('areAllItemsSelected', () => {
-        it('should be false if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                    })
-                );
-            });
-        });
-        it('should be false if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                        selectedIds: [0],
-                    })
-                );
-            });
-        });
-        it('should be true if all items are manually selected', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0, 1]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should be true if all items are selected with onSelectAll', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should be true if all we manually reached the selectAllLimit', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(
-                <Basic
-                    dataProvider={dataProvider}
-                    children={children}
-                    selectAllLimit={1}
-                />
-            );
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0],
-                    })
-                );
-            });
-        });
-        it('should be true if all we reached the selectAllLimit with onSelectAll', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(
-                <Basic
-                    dataProvider={dataProvider}
-                    children={children}
-                    selectAllLimit={1}
-                />
-            );
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0],
-                    })
-                );
-            });
-        });
-    });
-
-    describe('onSelectAll', () => {
-        it('should select all items if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should select all items if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
-                );
-            });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
-            const getList = jest.fn().mockImplementation((_resource, params) =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }].slice(
-                        0,
-                        params.pagination.perPage
-                    ),
-                    total: 2,
-                })
-            );
-            const mockedDataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(
-                <Basic
-                    dataProvider={mockedDataProvider}
-                    selectAllLimit={1}
-                    children={children}
-                />
-            );
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(getList).toHaveBeenCalledWith(
-                    'posts',
-                    expect.objectContaining({
-                        pagination: { page: 1, perPage: 1 },
-                    })
-                );
-            });
-        });
-    });
-
     describe('queryOptions', () => {
         it('should accept custom client query options', async () => {
             jest.spyOn(console, 'error').mockImplementationOnce(() => {});
diff --git a/packages/ra-core/src/controller/list/useList.spec.tsx b/packages/ra-core/src/controller/list/useList.spec.tsx
index 18ed205a1e0..5d96aada58e 100644
--- a/packages/ra-core/src/controller/list/useList.spec.tsx
+++ b/packages/ra-core/src/controller/list/useList.spec.tsx
@@ -3,7 +3,7 @@ import { ReactNode } from 'react';
 import expect from 'expect';
 
 import { useList, UseListOptions, UseListValue } from './useList';
-import { act, fireEvent, render, waitFor } from '@testing-library/react';
+import { fireEvent, render, waitFor } from '@testing-library/react';
 import { ListContextProvider } from './ListContextProvider';
 import { useListContext } from './useListContext';
 
@@ -315,111 +315,4 @@ describe('<useList />', () => {
             );
         });
     });
-
-    describe('areAllItemsSelected', () => {
-        it('should be false if no items are selected', async () => {
-            const children = jest.fn();
-            const data = [{ id: 0 }, { id: 1 }];
-            render(<UseList data={data} callback={children} />);
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                    })
-                );
-            });
-        });
-        it('should be false if some items are selected', async () => {
-            const children = jest.fn();
-            const data = [{ id: 0 }, { id: 1 }];
-            render(<UseList data={data} callback={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([1]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                        selectedIds: [1],
-                    })
-                );
-            });
-        });
-        it('should be true if all items are manually selected', async () => {
-            const children = jest.fn();
-            const data = [{ id: 0 }, { id: 1 }];
-            render(<UseList data={data} callback={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0, 1]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should be true if all items are selected with onSelectAll', async () => {
-            const children = jest.fn();
-            const data = [{ id: 0 }, { id: 1 }];
-            render(<UseList data={data} callback={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-    });
-
-    describe('onSelectAll', () => {
-        it('should select all items if no items are selected', async () => {
-            const children = jest.fn();
-            const data = [{ id: 0 }, { id: 1 }];
-            render(<UseList data={data} callback={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should select all items if some items are selected', async () => {
-            const children = jest.fn();
-            const data = [{ id: 0 }, { id: 1 }];
-            render(<UseList data={data} callback={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([1]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [1],
-                    })
-                );
-            });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-    });
 });
diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index 40445cb9efe..25c533febf8 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -22,7 +22,6 @@ import {
     CanAccess,
     DisableAuthentication,
 } from './useListController.security.stories';
-import { Basic } from './useListController.stories';
 
 describe('useListController', () => {
     const defaultProps = {
@@ -586,200 +585,4 @@ describe('useListController', () => {
             expect(authProvider.checkAuth).not.toHaveBeenCalled();
         });
     });
-
-    const dataProvider = testDataProvider({
-        getList: jest.fn().mockImplementation((_resource, params) =>
-            Promise.resolve({
-                data: [{ id: 0 }, { id: 1 }].slice(
-                    0,
-                    params.pagination.perPage
-                ),
-                total: 2,
-            })
-        ),
-    });
-    describe('areAllItemsSelected', () => {
-        it('should be false if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                        data: [{ id: 0 }, { id: 1 }],
-                    })
-                );
-            });
-        });
-        it('should be false if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: false,
-                        selectedIds: [0],
-                    })
-                );
-            });
-        });
-        it('should be true if all items are manually selected', async () => {
-            const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0, 1]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should be true if all items are selected with onSelectAll', async () => {
-            const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should be true if all we manually reached the selectAllLimit', async () => {
-            const children = jest.fn().mockReturnValue(<></>);
-            render(
-                <Basic
-                    dataProvider={dataProvider}
-                    selectAllLimit={1}
-                    children={children}
-                />
-            );
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        selectedIds: [0],
-                    })
-                );
-            });
-        });
-        it('should be true if all we reached the selectAllLimit with onSelectAll', async () => {
-            const children = jest.fn().mockReturnValue(<></>);
-            render(
-                <Basic
-                    dataProvider={dataProvider}
-                    selectAllLimit={1}
-                    children={children}
-                />
-            );
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        areAllItemsSelected: true,
-                        data: [{ id: 0 }, { id: 1 }],
-                        total: 2,
-                        selectedIds: [0],
-                    })
-                );
-            });
-        });
-    });
-
-    describe('onSelectAll', () => {
-        it('should select all items if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should select all items if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0]);
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
-                );
-            });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
-                );
-            });
-        });
-        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
-            const getList = jest.fn().mockImplementation((_resource, params) =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }].slice(
-                        0,
-                        params.pagination.perPage
-                    ),
-                    total: 2,
-                })
-            );
-            const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<></>);
-            render(
-                <Basic
-                    dataProvider={dataProvider}
-                    selectAllLimit={1}
-                    children={children}
-                />
-            );
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
-            await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
-                );
-            });
-            await waitFor(() => {
-                expect(getList).toHaveBeenCalledWith(
-                    'posts',
-                    expect.objectContaining({
-                        pagination: { page: 1, perPage: 1 },
-                    })
-                );
-            });
-        });
-    });
 });

From f27f69b7f9e712be064798c2973c1b4bb9d25b5e Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 5 Dec 2024 22:21:57 +0100
Subject: [PATCH 047/146] remove useless stories

---
 .../field/ReferenceArrayField.stories.tsx     |  6 ----
 .../field/ReferenceManyField.stories.tsx      | 33 +++----------------
 .../useInfiniteListController.stories.tsx     | 24 ++------------
 .../list/useListController.stories.tsx        | 24 +-------------
 4 files changed, 7 insertions(+), 80 deletions(-)

diff --git a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
index 393fba8146a..dd9cb01f1a4 100644
--- a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
+++ b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
@@ -38,12 +38,6 @@ const ReferenceArrayFieldComponent = (props: ListControllerResult) => (
                 gap: '10px',
             }}
         >
-            <button
-                onClick={props.onSelectAll}
-                disabled={props.areAllItemsSelected}
-            >
-                Select All
-            </button>
             <button
                 onClick={props.onUnselectItems}
                 disabled={props.selectedIds.length === 0}
diff --git a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
index 9ddf1b98248..3ff24b50a66 100644
--- a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
@@ -30,7 +30,7 @@ const ReferenceManyFieldController = props => {
     return children(controllerProps);
 };
 
-const ReferenceManyField = (
+const ReferenceManyFieldComponent = (
     props: ListControllerResult & { selectAllLimit?: number }
 ) => (
     <div>
@@ -41,12 +41,6 @@ const ReferenceManyField = (
                 gap: '10px',
             }}
         >
-            <button
-                onClick={props.onSelectAll}
-                disabled={props.areAllItemsSelected}
-            >
-                Select All
-            </button>
             <button
                 onClick={props.onUnselectItems}
                 disabled={props.selectedIds.length === 0}
@@ -54,9 +48,6 @@ const ReferenceManyField = (
                 Unselect All
             </button>
             <p>Selected ids: {JSON.stringify(props.selectedIds)}</p>
-            {props.selectAllLimit && (
-                <p>selectAllLimit : {props.selectAllLimit}</p>
-            )}
         </div>
         <ul
             style={{
@@ -81,32 +72,16 @@ const ReferenceManyField = (
     </div>
 );
 
-export const Basic = ({ children = ReferenceManyField }) => (
-    <CoreAdminContext dataProvider={defaultDataProvider}>
-        <ReferenceManyFieldController
-            resource="authors"
-            source="id"
-            record={{ id: 123, name: 'James Joyce' }}
-            reference="books"
-            target="author_id"
-        >
-            {children}
-        </ReferenceManyFieldController>
-    </CoreAdminContext>
-);
-
-export const SelectAllLimit = ({
-    dataProvider = defaultDataProvider,
-    children = props => <ReferenceManyField selectAllLimit={1} {...props} />,
+export const ReferenceManyField = ({
+    children = ReferenceManyFieldComponent,
 }) => (
-    <CoreAdminContext dataProvider={dataProvider}>
+    <CoreAdminContext dataProvider={defaultDataProvider}>
         <ReferenceManyFieldController
             resource="authors"
             source="id"
             record={{ id: 123, name: 'James Joyce' }}
             reference="books"
             target="author_id"
-            selectAllLimit={1}
         >
             {children}
         </ReferenceManyFieldController>
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
index 8c082783ccb..d5f0ab67cda 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
@@ -79,12 +79,6 @@ const ListWithCheckbox = params => (
                         gap: '10px',
                     }}
                 >
-                    <button
-                        onClick={params.onSelectAll}
-                        disabled={params.areAllItemsSelected}
-                    >
-                        Select All
-                    </button>
                     <button
                         onClick={params.onUnselectItems}
                         disabled={params.selectedIds.length === 0}
@@ -92,9 +86,6 @@ const ListWithCheckbox = params => (
                         Unselect All
                     </button>
                     <p>Selected ids: {JSON.stringify(params.selectedIds)}</p>
-                    {params.selectAllLimit && (
-                        <p>selectAllLimit : {params.selectAllLimit}</p>
-                    )}
                 </div>
                 <ul
                     style={{
@@ -124,13 +115,9 @@ const ListWithCheckbox = params => (
 
 export const Basic = ({
     dataProvider = defaultDataProvider,
-    selectAllLimit,
-    children = props => (
-        <ListWithCheckbox {...props} selectAllLimit={selectAllLimit} />
-    ),
+    children = ListWithCheckbox,
 }: {
     dataProvider?: DataProvider;
-    selectAllLimit?: number;
     children?: (props) => React.JSX.Element;
 }) => {
     return (
@@ -139,12 +126,7 @@ export const Basic = ({
                 <CoreAdminUI>
                     <Resource
                         name="posts"
-                        list={
-                            <Posts
-                                selectAllLimit={selectAllLimit}
-                                children={children}
-                            />
-                        }
+                        list={<Posts children={children} />}
                     />
                 </CoreAdminUI>
             </CoreAdminContext>
@@ -152,8 +134,6 @@ export const Basic = ({
     );
 };
 
-export const SelectAllLimit = () => <Basic selectAllLimit={5} />;
-
 const defaultAuthProvider: AuthProvider = {
     checkAuth: () => new Promise(resolve => setTimeout(resolve, 500)),
     login: () => Promise.resolve(),
diff --git a/packages/ra-core/src/controller/list/useListController.stories.tsx b/packages/ra-core/src/controller/list/useListController.stories.tsx
index 3353a3eca67..9e9ae4c547e 100644
--- a/packages/ra-core/src/controller/list/useListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useListController.stories.tsx
@@ -34,12 +34,6 @@ const List = params => (
                 gap: '10px',
             }}
         >
-            <button
-                onClick={params.onSelectAll}
-                disabled={params.areAllItemsSelected}
-            >
-                Select All
-            </button>
             <button
                 onClick={params.onUnselectItems}
                 disabled={params.selectedIds.length === 0}
@@ -47,9 +41,6 @@ const List = params => (
                 Unselect All
             </button>
             <p>Selected ids: {JSON.stringify(params.selectedIds)}</p>
-            {params.selectAllLimit && (
-                <p>selectAllLimit : {params.selectAllLimit}</p>
-            )}
         </div>
         <ul
             style={{
@@ -76,25 +67,12 @@ const List = params => (
 
 export const Basic = ({
     dataProvider = defaultDataProvider,
-    selectAllLimit,
     children = List,
 }: {
     dataProvider?: DataProvider;
-    selectAllLimit?: number;
     children?: (params: ListControllerResult) => JSX.Element;
 }) => (
     <CoreAdminContext dataProvider={dataProvider}>
-        <ListController
-            resource="posts"
-            selectAllLimit={selectAllLimit}
-            children={children}
-        />
+        <ListController resource="posts" children={children} />
     </CoreAdminContext>
 );
-
-export const SelectAllLimit = () => (
-    <Basic
-        selectAllLimit={5}
-        children={props => <List {...props} selectAllLimit={5} />}
-    />
-);

From 1b94c815bbfe77cf49482519dd7c3f7c4f757634 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 6 Dec 2024 09:11:16 +0100
Subject: [PATCH 048/146] remove useless props + improve comments

---
 .../src/button/SelectAllButton.tsx            | 43 ++++---------------
 1 file changed, 8 insertions(+), 35 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index f9a97edb6e2..37000bc32b7 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -1,43 +1,24 @@
-import * as React from 'react';
-import {
-    type GetListParams,
-    type GetManyReferenceParams,
-    type RaRecord,
-    useListContext,
-    useSelectAll,
-} from 'ra-core';
-import type { UseMutationOptions } from '@tanstack/react-query';
+import React, { useCallback } from 'react';
+import { useListContext, useSelectAll } from 'ra-core';
+
 import { Button, ButtonProps } from './Button';
-import { useCallback } from 'react';
 
 /**
- * Select All button for list forms
+ * Select all items from a Datagrid.
  *
  * @typedef {Object} Props the props you can use
  * @prop {string} label Button label. Defaults to 'ra.action.select_all', translated.
  * @prop {string} limit Maximum number of items to select. Defaults to 250.
- * @prop {function} mutationOptions Object of options passed to react-query.
  *
  * @param {Props} props
  *
- * @example // with custom success side effect
+ * @example
  *
- * const MySelectAllButton = () => {
- *     const notify = useNotify();
- *     const onSuccess = (response) => {
- *         notify('All items selected!', { type: 'info' });
- *     };
- *     return <SelectAllButton limit={100} mutationOptions={{ onSuccess }} />;
- * }
+ * const MySelectAllButton = () => <SelectAllButton limit={100} label="Select all books" />;
  */
 
 export const SelectAllButton = (props: SelectAllButtonProps) => {
-    const {
-        label = 'ra.action.select_all',
-        limit = 250,
-        mutationOptions,
-        ...rest
-    } = props;
+    const { label = 'ra.action.select_all', limit = 250, ...rest } = props;
 
     const { filter, sort, meta, total, selectedIds } = useListContext();
     const onSelectAll = useSelectAll({ limit, filter, sort, meta });
@@ -58,14 +39,6 @@ export const SelectAllButton = (props: SelectAllButtonProps) => {
     );
 };
 
-export type SelectAllButtonProps<
-    RecordType extends RaRecord = any,
-    MutationOptionsError = unknown,
-> = ButtonProps & {
+export type SelectAllButtonProps = ButtonProps & {
     limit?: number;
-    mutationOptions?: UseMutationOptions<
-        RecordType,
-        MutationOptionsError,
-        GetManyReferenceParams | GetListParams
-    >;
 };

From af1427b62f57fd8f2407e043aa560025b1c3add2 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 6 Dec 2024 09:12:50 +0100
Subject: [PATCH 049/146] Add stories for SelectAllButton

---
 .../src/button/SelectAllButton.stories.tsx    | 126 ++++++++++++++++++
 1 file changed, 126 insertions(+)
 create mode 100644 packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
new file mode 100644
index 00000000000..efccfc2cf12
--- /dev/null
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
@@ -0,0 +1,126 @@
+import * as React from 'react';
+import polyglotI18nProvider from 'ra-i18n-polyglot';
+import englishMessages from 'ra-language-english';
+import { Resource, TestMemoryRouter } from 'ra-core';
+import fakeRestDataProvider from 'ra-data-fakerest';
+
+import { SelectAllButton } from './SelectAllButton';
+import { AdminContext } from '../AdminContext';
+import { AdminUI } from '../AdminUI';
+import { List, Datagrid } from '../list';
+import { TextField, NumberField } from '../field';
+
+export default { title: 'ra-ui-materialui/button/SelectAllButton' };
+
+const i18nProvider = polyglotI18nProvider(
+    () => englishMessages,
+    'en' // Default locale
+);
+
+const dataProvider = fakeRestDataProvider({
+    books: [
+        {
+            id: 1,
+            title: 'War and Peace',
+            author: 'Leo Tolstoy',
+            reads: 23,
+        },
+        {
+            id: 2,
+            title: 'Pride and Predjudice',
+            author: 'Jane Austen',
+            reads: 854,
+        },
+        {
+            id: 3,
+            title: 'The Picture of Dorian Gray',
+            author: 'Oscar Wilde',
+            reads: 126,
+        },
+        {
+            id: 4,
+            title: 'Le Petit Prince',
+            author: 'Antoine de Saint-Exupéry',
+            reads: 86,
+        },
+        {
+            id: 5,
+            title: "Alice's Adventures in Wonderland",
+            author: 'Lewis Carroll',
+            reads: 125,
+        },
+        {
+            id: 6,
+            title: 'Madame Bovary',
+            author: 'Gustave Flaubert',
+            reads: 452,
+        },
+        {
+            id: 7,
+            title: 'The Lord of the Rings',
+            author: 'J. R. R. Tolkien',
+            reads: 267,
+        },
+        {
+            id: 8,
+            title: "Harry Potter and the Philosopher's Stone",
+            author: 'J. K. Rowling',
+            reads: 1294,
+        },
+        {
+            id: 9,
+            title: 'The Alchemist',
+            author: 'Paulo Coelho',
+            reads: 23,
+        },
+        {
+            id: 10,
+            title: 'A Catcher in the Rye',
+            author: 'J. D. Salinger',
+            reads: 209,
+        },
+        {
+            id: 11,
+            title: 'Ulysses',
+            author: 'James Joyce',
+            reads: 12,
+        },
+    ],
+    authors: [],
+});
+
+const Wrapper = ({ bulkActionButtons }) => (
+    <TestMemoryRouter initialEntries={['/books']}>
+        <AdminContext dataProvider={dataProvider} i18nProvider={i18nProvider}>
+            <AdminUI>
+                <Resource
+                    name="books"
+                    list={() => (
+                        <List>
+                            <Datagrid bulkActionButtons={bulkActionButtons}>
+                                <TextField source="id" />
+                                <TextField source="title" />
+                                <TextField source="author" />
+                                <NumberField source="reads" />
+                            </Datagrid>
+                        </List>
+                    )}
+                />
+            </AdminUI>
+        </AdminContext>
+    </TestMemoryRouter>
+);
+
+export const Basic = () => <Wrapper bulkActionButtons={<SelectAllButton />} />;
+
+export const Label = () => (
+    <Wrapper bulkActionButtons={<SelectAllButton label="Select all books" />} />
+);
+
+export const Limit = () => (
+    <Wrapper
+        bulkActionButtons={
+            <SelectAllButton label="Select 5 first books" limit={5} />
+        }
+    />
+);

From 52bcdd1b3e113be993bda6ea55c183777134ffb0 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 6 Dec 2024 09:15:38 +0100
Subject: [PATCH 050/146] test SelectAllButton

---
 .../src/button/SelectAllButton.spec.tsx       | 49 +++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
new file mode 100644
index 00000000000..de8c1bfa440
--- /dev/null
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
@@ -0,0 +1,49 @@
+import React from 'react';
+import { fireEvent, render, screen } from '@testing-library/react';
+import { Basic, Label, Limit } from './SelectAllButton.stories';
+
+describe('<SelectAllButton />', () => {
+    it('should render a "Select All" button', async () => {
+        render(<Basic />);
+        await screen.findByText('War and Peace');
+        fireEvent.click(screen.getAllByRole('checkbox')[1]);
+        await screen.findByRole('buton', { name: 'Select all' });
+    });
+    it('should select all items', async () => {
+        render(<Basic />);
+        await screen.findByText('War and Peace');
+        fireEvent.click(screen.getAllByRole('checkbox')[1]);
+        await screen.findByText('1 item selected');
+        fireEvent.click(screen.getByRole('buton', { name: 'Select all' }));
+        await screen.findByText('11 items selected');
+    });
+    it('should render a button with a custom label', async () => {
+        render(<Label />);
+        await screen.findByText('War and Peace');
+        fireEvent.click(screen.getAllByRole('checkbox')[1]);
+        await screen.findByText('1 item selected');
+        await screen.findByRole('buton', { name: 'Select all books' });
+    });
+    it('should select all items until the limit is reached', async () => {
+        render(<Limit />);
+        await screen.findByText('War and Peace');
+        fireEvent.click(screen.getAllByRole('checkbox')[1]);
+        await screen.findByText('1 item selected');
+        fireEvent.click(
+            screen.getByRole('buton', { name: 'Select 5 first books' })
+        );
+        await screen.findByText(
+            'Warning: There are too many elements to select them all. Only the first 5 elements were selected.'
+        );
+        await screen.findByText('5 items selected');
+    });
+    it('should not render if we select more items than the limit', async () => {
+        render(<Limit />);
+        await screen.findByText('War and Peace');
+        fireEvent.click(screen.getAllByRole('checkbox')[0]);
+        await screen.findByText('10 items selected');
+        expect(
+            screen.queryByRole('buton', { name: 'Select 5 first books' })
+        ).toBeNull();
+    });
+});

From 1b0e974ed84fd3ad1418b82e92e9dc8a9ac713fb Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 6 Dec 2024 16:42:02 +0100
Subject: [PATCH 051/146] add a  name + support onClick

---
 .../src/button/SelectAllButton.tsx            | 20 +++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index 37000bc32b7..d35400c21e8 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -17,14 +17,25 @@ import { Button, ButtonProps } from './Button';
  * const MySelectAllButton = () => <SelectAllButton limit={100} label="Select all books" />;
  */
 
+const PREFIX = 'RaSelectAllButton';
+
 export const SelectAllButton = (props: SelectAllButtonProps) => {
-    const { label = 'ra.action.select_all', limit = 250, ...rest } = props;
+    const {
+        label = 'ra.action.select_all',
+        limit = 250,
+        onClick,
+        ...rest
+    } = props;
 
     const { filter, sort, meta, total, selectedIds } = useListContext();
     const onSelectAll = useSelectAll({ limit, filter, sort, meta });
-    const handleSelectAll = useCallback(() => {
-        onSelectAll();
-    }, [onSelectAll]);
+    const handleSelectAll = useCallback(
+        event => {
+            onSelectAll();
+            if (onClick) onClick(event);
+        },
+        [onClick, onSelectAll]
+    );
 
     if (total === selectedIds.length || selectedIds.length >= limit)
         return null;
@@ -34,6 +45,7 @@ export const SelectAllButton = (props: SelectAllButtonProps) => {
             label={label}
             onClick={handleSelectAll}
             type="button"
+            name={PREFIX}
             {...rest}
         />
     );

From eb73fbd733f3df3a40feea06d7f8e79a5ea289f8 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 6 Dec 2024 16:51:52 +0100
Subject: [PATCH 052/146] document select all

---
 docs/Buttons.md              |  30 ++++++++++++++++++++++++++++++
 docs/Datagrid.md             |   3 ++-
 docs/Reference.md            |   1 +
 docs/img/SelectAllButton.png | Bin 0 -> 61084 bytes
 4 files changed, 33 insertions(+), 1 deletion(-)
 create mode 100644 docs/img/SelectAllButton.png

diff --git a/docs/Buttons.md b/docs/Buttons.md
index d8777e7ce33..d048b891fe1 100644
--- a/docs/Buttons.md
+++ b/docs/Buttons.md
@@ -20,6 +20,7 @@ React-Admin provides button components for all the common uses.
     - [`<BulkUpdateButton>`](#bulkupdatebutton)
     - [`<BulkUpdateFormButton>`](#bulkupdateformbutton)
     - [`<FilterButton>`](#filterbutton)
+    - [`<SelectAllButton>`](#selectallbutton)
 
 - **Record Buttons**: To be used in detail views
     - [`<UpdateButton>`](#updatebutton)
@@ -955,6 +956,35 @@ This button is an internal component used by react-admin in [the Filter button/f
 
 To override the style of all instances of `<FilterButton>` using the [application-wide style overrides](./AppTheme.md#theming-individual-components), use the `RaFilterButton` key.
 
+## `<SelectAllButton>`
+
+This button is an internal component used by react-admin in [the Datagrid default `bulkActionButtons`](./Datagrid.md#bulkactionbuttons).
+The `<SelectAllButton>` component is a button that is used to select all items from a resource, no matters the pagination.
+
+![SelectAllButton](./img/SelectAllButton.png)
+
+### `label`
+
+By default, `<SelectAllButton>` renders with the "Select all" (translated if the user locale isn't English), whether used on a creation or edition form. You can pass another label:
+
+```jsx
+const PostSelectAllButton = () => <SelectAllButton label="Select all posts" />;
+```
+
+**Tip**: The label will go through [the `useTranslate` hook](./useTranslate.md), so you can use translation keys.
+
+### `limit`
+
+By default, `<SelectAllButton>` select the 250 first items of your list. To customize this limit you can use the prop `limit` as follows:
+
+```jsx
+const PostSelectAllButton = () => <SelectAllButton limit={100} />;
+```
+
+### `sx`: CSS API
+
+To override the style of all instances of `<SelectAllButton>` components using the [application-wide style overrides](./AppTheme.md#theming-individual-components), use the `RaSelectAllButton` key.
+
 ## `<ListButton>`
 
 Opens the List view of a given resource.
diff --git a/docs/Datagrid.md b/docs/Datagrid.md
index 5b238993817..d71994e0012 100644
--- a/docs/Datagrid.md
+++ b/docs/Datagrid.md
@@ -166,12 +166,13 @@ By default, all Datagrids have a single bulk action button, the bulk delete butt
 
 {% raw %}
 ```tsx
-import { List, Datagrid, BulkUpdateButton, BulkDeleteButton, BulkExportButton } from 'react-admin';
+import { List, Datagrid, SelectAllButton, BulkUpdateButton, BulkDeleteButton, BulkExportButton } from 'react-admin';
 import { VisibilityOff } from '@mui/icons-material';
 
 const PostBulkActionButtons = () => (
     <>
         <BulkUpdateButton label="Reset Views" data={{ views: 0 }} icon={<VisibilityOff/>} />
+        <SelectAllButton />
         <BulkDeleteButton />
         <BulkExportButton />
     </>
diff --git a/docs/Reference.md b/docs/Reference.md
index 3983cda09a1..07d4ab067d4 100644
--- a/docs/Reference.md
+++ b/docs/Reference.md
@@ -157,6 +157,7 @@ title: "Index"
 * [`<Search>`](./Search.md)<img class="icon" src="./img/premium.svg" />
 * [`<SearchInput>`](./SearchInput.md)
 * [`<SearchWithResult>`](./SearchWithResult.md)<img class="icon" src="./img/premium.svg" />
+* [`<SelectAllButton>`](./Buttons.md#selectallbutton)
 * [`<SelectArrayInput>`](./SelectArrayInput.md)
 * [`<SelectColumnsButton>`](./SelectColumnsButton.md)
 * [`<SelectField>`](./SelectField.md)
diff --git a/docs/img/SelectAllButton.png b/docs/img/SelectAllButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..b7a20eb841ec4f7be2ed2934f60636df0bd732ea
GIT binary patch
literal 61084
zcmagF19W9g*DaiMI<~EjZQJbFwr$%sI_kJ%+qP|WY&-c+KmEM-zT+GBA74f?&fayZ
z_O4pBsxsG{tHR}E#9*PYpn!mYU?s$b6@Y+1sDXfhCn3N9B_3JPJb;g{j)D?O5P%;q
z2%|8-J*Jb0nv<ffiIc0ogE5e)jjgpYjiaH1v9XP#nXS_$NEa`l68WD>LJr3IPUf~Y
z1WM-C#y~E{HnarvtOQ2KhO`8X^o+~|46K|i^qkD}zNyLxKtKdQ62byXZkcBr-dak|
zFHfIK>)rC*^73&J*D*6e^61w#_B8Trx!BB_`5S6lsnd)bDZ84On(?$_1~kWL2V_Ki
zB$f^38$XTpG;7*yyjl_4uzmJpG&xnEHW{GYLRy~R83=xnJLJQ7@ZiJa!KXWJnpQG7
zOlF?GcWxe<;lzN!3qlYEAqYb31lDih`T;Kf++{`+Q~z6@LjoE3x3t$(qW9aMs)RvT
z>Iv0<n-O}cq!Lr(!8h;g82)V$#>(8h*3{WqXRCHOtLJLQzWDR_tmtn$gjDtlFppF2
zyZc9kpSGU!`HGNZ_QfGWWcBBh3IC}=)&y>mg{2kUBB?1MRV>+Sfz6yy{_opX&x53d
zqVvxwE8xheZDJq4|Jx{!=wym0=g6)%Z=v3|H|pPEFmvQ!yN*~#2mih2l|n-MXRL%l
zQwc#Le;>J1$N7%)w|Is#7Ce&{-X@k?zb(HW3)UkGEPDO)xR!+IuQAa5hCtwoH4~C$
z96Y(%Gi`nwwtM|+5_@2FZHM5E<lnddRWv*-xs)(<d-K0pFlBvF?VrwQu{z~w%He5;
z51v1C{+zMfg->r56?3uG+bw5?6B7zGrB^?1t&A!Jzp;DDz>?(U9`%HMSIe4>{W-VD
z-d^^@*%o&{|6S(jTx@>XpZdo}Y>%k~DsG$4_C?n`li`e=4Sd%&*EUnRW_iKo+4qM&
zRmAhiJ)fM*y_9I!b)QfA1K6_*J%B~;zFGvfwFx!<CilT@6QBNk75Z{ekh#?AJP^$8
z%h)1xNyIs5WS8aG5>@Rq{gK62eQ`PT^lLO&2>OHQHM?cDC-Aoo`|wVf|GKNU?HfGq
zUg0dh+j2=hK?(dvh1Js5bmS2t78p2d=XRyB_M}du7_3PjjekWwf~m6dcaKfN-h?WX
z6*c$OB*46FZ9iSmpKkGvf_q~B5|Mh^=3RF%B%iCC{z54t>npVbU(7Q55?}AeP7#t%
zt?TXwk{HdMh+#L_*hRTH@s7_q<>q~M-}l_d;^P+zl7m}tmE*!&;xha5iNQsQPr(Mp
zr1=9w*4TH7D`s&oo6+?v{C6uJ{a^1^_^xjaDFRF(H-|ZtG%0S6hgGY<+;v6-fikvF
z1CMWS`+L$7cs)D^(2v^ZtReZlR~ffDP2Mi~{o1iN#(P!XLUy0*h(qtLdtt0@x?Fc`
zU&gzHd|!Mg{4`6N-uy#mVPLvmz+tiZa(O$W&)H_gw#lEVF4iIMUOZ3Z-4n9+mYH@A
z%|2Pl^440~HhvC~Q4d+f+_(>jy&1hYcdvX*^Sr&jyJ8?SK?-g8XkS(0J$xK~75;i_
z=78|J^%UY<QEvQxMV|ZthS$LpBmu>b5V(L`(BYbN9`2ns)0Ql%|E})ggA4R$$sU=<
zEL_b)FC>BA?W8(_8x;7%f4GP7Rk-%@>`0%^HE#leJQ9DM=_<*RiL?irw!^#3y*Is>
z0%L3xnKGMB-jwPj;_BLS^)2i3Rr0+^JBjuEj%%Bue5)3n!dDDtKX<OmSP0DSli5q-
zf;AWv$GHmcw|!L?ZNvVoCx+Y5?dyuSUxpcov2VD5bkU=_!>SYfIaZbB$TLJ|)5G&r
z8q+aSt;un{%*@U5I&JF~qQmxqzq;GyU?AxD<*>yblguX8%qBl*k9(`^TEEF*w?^Gf
zrm|`q%f!!kO8(Qby9K)|)L{mkOz~4L(>1wl5P0FxY^z4QW7)&2_hyCcbLjK^)cZ^<
z*6w|scv4z}yZzk*F=dLfdvAw~X;NI1i@&d+KwtXHPydOE%DsLIOQ1deJWVI&Adx%L
z@;i*hcl!JWzJ$@sr{_q@I$y5LucuApTMDrtKfUPcc$L(W7&6^+{p$Q<H#erF@D~j#
zmXKHr;Gu0G4K04Te!_pgY94e|7|v+%@p?>67K3kmg@rNNq*0Cg$s_rJE!J*q;qAe&
z*Gi?v+@iV{790Amt5Q>0A0k_(HLXeL@y3s)ZA)-w<x6vaZ$-N~bufy2rs^Do36kz@
zh*1~XK#s}nlKEY;l;T;^n2$406kcy8Q%`zSy%7>;%P|dolXKif6C|cvNBRfS=q#rH
zgt6-h<fdm?#CP4rnkKZ~DDSi^jKMQPjmEAgR4Ob_BueP6-HuMcj^hq0zuL&hbye+q
z=yS8hJ6OzO6A<m4hECY`0`RET?p)-zCbYpx2;&R(OZ3wq|82M87?1@#GikLq&u50k
z^}}(*@LLJBX=KEeP{<A$&y|WB8Fd;lFwnY}R6>jfAaBeIZUK)K`BAug!;4{F7;yI8
zZRc(Vf;h+nM=x~{oYLI0E_xRwAaEDl;&H6eU-6x)D?b~&LoWhjCp#wRWs(B!qr2Vr
zsMq=XGRd1wct2J$?Aqg{=ahp?uh_A6hnx*w=h*imh+D5&Od(pW^z=|BpUj!3o`3PW
zzT$Nc-E2K%a57~x?2+m{mj}@Ju7wp32nDa(uxWlYB957&Mq#q~=ZvR0BN90}G@}K4
zaV}2r0X>229k^a?EQSM>ZI3X$fF;U>4~mA~OZTk$rvKA*4d41D1@+TH@2WvHAq%IM
z_#UGL^!2&Ea{z39uU+ndn3Fb2>=2e<)jQKUc+2ill<R{JN?+Xp;}(o#<!u$-s?x%$
zt||gGSd86kf&b#wnf>wmz2PPJ*7a3JLp`tH+3yZjtMau%Ls0|v6$+4aVVdX9S6mXY
zAG^QygFjb>pjmk!9jkU{gh4)ZakqC=V;r8WxIW(nRJdLJV&7h>$w@L_eaeS4EDQ(u
z76wtV$XBXU$@pBEC_X4_6~P#kb%$CHt&?!(>5mWeQQk`NNh?B1!i6Z*Py!@8eR8r4
zmwfPi_Q_wt@Ao@@Q>i2D=l<Smz_Gpcl?H4uW_`)tY4kw6bg$X>fF-~Mi~)Z2sSr&J
zYil2W2^QKH*mwMHeyLoPpPSs+aR25T`tx(Td(dcLjNOo&j*l~_1%$Ivsu9<vbN1oe
z#h@PPSI%d>AqESs#u6#9?O1ymrtYErBMmPMtYRpOIayD((meB(hw;%a==ILmyC+1n
zX#_q~JlfRA(J9wm2Wvf-Svp|1_kHx|13q1378jgr#{>I^gc|7X4W|J1a~|hyc=pM|
z{<*c-o(Mhxji0G}Mb(3NF_-Yyy)x)CZ1DS?YM1oZcglF>v8pxCw+MM;Y#&V)p7yU*
zy|OY$u_{Wul-!fs8KDkavhC-ju-8}Slfb<1g9GhyxUUt?XC!g22VhLfz@ngt<GebY
zN89xNL0L69_evM`3~mMxO|o~3%_7(h>^hB(&8r~qEI1zpKfZ&bqODsR>0t2V=iR{_
zbU6e)!aZ0TBeg}IU*Z(i%KGAc-V@~A@hc$+h*fZF`FuT{r<eAGs~v%2Qi!6)IL93c
z$ICr@8ud;(V;2zgq5~`Qcmw|Q>A+ZL_Lw~|1z-DA?)&iXDgRg?koEuqnHdFaVbrqA
zsDcnP5+A??w2X{Lm*DQF=icp|B4c)m{+gBW`l~+=sC%#b2rqojrbo73W8qEvrY0R}
z%i3a!Kbj+pfB3*d9!zz?>Nn2?gFxKzov#X)^>j6aHyrk<4{_yi=-ELagMFnpOUiEI
zE!zn+1gkuqbGemDZ>s{<a$#=ZH=GGSXnDrSw$u>nX}Lf?u`xINS~gN#2GMS@Frv#t
zfz94{GIWS9XS(K^FGZjaJPp{s*MNS#d65lNq3rhbv3)*cIo`P;9juRvd{?2Z?pySD
zn2lVK_pqIU<mb1|3*c!t<pNI3h$wRU+Qi=U{5XSLzQDjfUiCb{&(qVr<H7cm$V$x?
z%rWV^$O3%}d}7Gsx07Pg+9|ZCMs#^mToNw0>PlUDro1l<_m@MnZ9fj6T7IoNf9VCI
zFX;joGi1HAJ&O(xRO@=|?w<RwUBCBwiH_W^5lAz$F~nMg=H>Oj$N1{)81U}Xp-!JC
zvXVX<3fhG^Y5%@5)oShIf}A^hKxpM9XIQ(7x-J&``5fH`4S=qPi)4P-hj0gj!eotA
zmTvEtp-*#la5!Bo4%%}(UV<+-(^?=s(YlTw0>w+NS%E5q=04=n?_p1;?+{C0JZu-l
zD)LV`w{aG+c-iyx&yonf;36PmcK?h$Px4;vc3ygF=<t_Hd#J{B0^|1YhP<@Q*8Jdq
z|E9Qy1$BXVm|hMPC0_J#yh0|`!JR9A4*jd{ylsXgq1sP0f9It|f;~&dMcD_qd-xXv
z@pubrbP;v}YQ^B|ajPsBMRPaslWQKvrCkMfsOJ92S(V#Oy|I9PR=G3|lIR1jhmOZ3
z`Dr$vc%_Q$UF=KU_MpFT!>Z!$P?RoQi1mV%&!;DA#||Mob6ijk-0p)t)JHRi)@9H2
zyTB|Subb$pL<8;Q6O$7chYtMfnDx4nj|NCZ?~Vt%&gGX5K7rya=)e~$({+v3LRLO5
zHXPLs$Or(koLPYLdgAeY`D(J^L$Y+gWXKG^jmHO`({2|v)p>8X5!-(H{CXOWfn|4q
zlX9D9c(n~Anw7oxl@jI>KIgKc?*NWn9nIwRm8~GPht8KPs)g{}9iJ`djC~TA8^`Sw
z+vh>$Hh~D0Ww{bFtVZZs_lw1+zfT)3>ENzKdNmB=PUdtE2erSb7V@C87n~%(k%?L;
z+w|_fg7;i&kPYQNe|t$w+&hB2n7byX6rb6y`dYia1k%2*K=TCNm=AtH9Uum0bUf@&
z?aW!@;~bQ_`RiauwH}2UhP1f>Op?xo7%M#<A||k*{c#g`vBRKGKTJ<PD1`v@tuJt-
zljEpflfx1c%4T0yuB=ZNcy5_Wjr00$6BAb-q-RDGT!w9Equ!EKB_k)RG5hCcb(79$
z7a%Zj>JSKg->DEn`8Wsa2cs81-L3P*KMY%}YVpFf%QV}*t%_kGqt>8#2M5oV2Eq|L
zdHzkMdi!XRqZ8FpddxL9a8VUI(<O4);VX`i4|aD@WC`MSc;EMSTxB<A=F6@zmVwWH
zg^ksl<U&HlAD!je>4I#A#eWdxmso?dT$96hUVl5;1R{>>(fEE%W>6rgNH`piA9L#-
znFndx&Qs1=<ihqc>$_dD67BQO^n@GMTVu0H0U2O&Df9MWW9uV;AHzhOXFo3_@;bnG
zWqHlvCi;PKxINeC>(CNlxf^TWbYm3lIJh+PuyK?ip~j7OxzP=9>7J|je4u6JXHeU&
z57o*XPffO{+M{qN)$KkF%F|b-5_>h5%L~p2DyX7q7ps$c=$mT&4oFM(!H*D~@kq0e
zGM9Ny!fGb?Tc_)pBA#}+t(>!@kFTfqX`-Qaui03<FU{E<HW0i#98Vtv@V49`$0@ng
zVbj}u^l?EPJzn*D;N`4j!cT}S1?X0;cI@nNm^7m1F-xrw78N+EYZ>JEA?M060ik!6
z47P&<*B-b69(rnYy;w1~$F%5*`B;xD+EY?fXM1zxM6pw5Joc8ab*Ccp%2<*v_@;av
zGM$h13*IRiaDU>@bGre4JgEhRr$?-hmlJt7b`}^YNP^==xr9oynoUA3S!*+U{mASV
zbHoBxQdICx&f%M?AE__!@cKd;hD~{z`}bWwQ>Qc<u|F7+$b3qteRq}L{3#c0`Fb@X
zGeS0fq8LNt91ZQ-#2n$ge3GWJJZ#!sfDA)fbxosB)>5r=aDNBl4n6P7eJ(zVZH0#7
zbtF&#xjp^vxO^^1cJoa7e2dl@@wN1V8{?K~cV>$@QhXG+RiW+Bj1opn6Mw&GAIx(^
z)xHqa;JxqdIJ1uV>;g=z0tBq>N5;!-R><tipIH@GYabcaEdl(WD3X^imTs*ATmiAI
zJ7A-G;*D*GzlVK10^jJCn#{07!^gZ8OR6~?jeITouEEpeZ|C+XFWGsAfQs0^tq;=d
zos>nUyAt{743dUYwEyJFV&zd4(<9N>LRXqE5eYX(&j*LDocIbhj=dNAIkRWAIpf!5
z4-}}0JputsEa@4S%IYmPUG5`{$$hqApC)^4_&|S|qpEhskHotw_R)ID?xU?M-LZaF
z!96aOW1(($sb`WIzjB&>J@;Xy;~E#LduR9h8>n|3j+ch7zv#t>yUvL~zb_!&lvDJh
z=n|r}lW)dbOO20vSW4N4TGB#V<;(q7OCF^Q?tYg~{yedJ(q9u(GE?)GFE_Kdq3#Zm
z*&@iEeF9u`?b?xnld(FG0Eh4w3T&aOSoi_TPk79xn&`B+_&z+!`^vO0IuWinmg(5h
zhPKyFUrU;8kDaA>kKc`7JLSDrEwBW$zhF5z>muT~=6ErcM&)ii-Xe7EjrhyBZPI(L
z3b;w3>2tA;u8RTwwWqy~*2eJ_=!IM+>C&Q<*HYJu_X0^=?MGsA*@R)Uxz5eVOj1ji
zTDN9Zr||wE*UYg~{}jg%{%9~geVTEXOMKTexh$_Qf|xB|UVhbf=Sp#^XjY_Puk-tg
zj#JWG9vIp>ZvXbC&$u{dz~>sc+wsQbiWam02uPZ}H#;<EX1N<^Y*)fimU8*4DND;f
zElvc!ygZ>1*@JBdj`UW>+FWJ81UQAeH$L4j1RSjHv)=;iyafybFlT+UBs*Vid54R>
zVTWpS_Etg}ZB~IbB$T^7!(;dFMLLyxo|2#Ha1Yz_@f0DxyE$!k56Z&_2R(}}JNSLK
z^&TQsmP)IEmqHItm}d4sHPhQ1$8y-JI2fTMTOsm9F0_8FyT!*8eVE!AX?jfT#0}{C
zB9VsCzgdgt^vMU9nJ>1*l|y?yd%VsE0itCh`7=&a+*>xg$6F75eLNssZnmcO0_Hd|
zA#muYn&(+<>=#g<FRyD}%^guQd!%vGCl!%AN$uBcoo`OyHFG96iO1-->i>{j%~~a}
z8(bYN#<jZ+9QK?YxV9c0cv&)AM2TnvReP>9v-3-Hp4abYaQN2FEuL}^_s=aq@2VB*
zrTj*=IS+5}a;leO@p^93*)TagM^Z!KM>mb7$Aw=oJi5of0s1X?=hhil-K<TUISKZ~
ziB>cSbm!Ww8t+%(WT8;iqfptLHY;T0m3FGvU#4*<vXx8UzHOs<gZAXq0+X-5yP|15
zN~U-(xvOI|hR4MN{A=FA$+U&13=#q4SYb&;&^}UH-(QkaW6!>=q^gXBAG13KmkS6&
z?u}huSFB2>L!hj0@A~eSJevJ;{9hJu7is_6&5mVKd*=8Dm0>0vxJ?sw)==MZA!|ZA
zgf7uv0<<6W=YpA?XX~dxzfEe>x@eVc=b0lXwjD>-ro^KLjYjl?QQoe3X4s`=c;w>H
zE+TsDzZ@#MpH6Yl&e=y$;Rpp0HLMI44y8@gsS$vxbU&;!Yv5$oI3I~e*Okz^<J<}p
z((?M3TGax=f_*w|VAsx$<elBUcH6FhwBqPZU?)lV!HEh#O;?RBW~tn{>5CI98Y)vJ
zbb07{vpBTzy=>;^lKEA9yMz;ngxWvsC@n%X*xMb}<i}BP<>9p(5G)?s5wpe{_GS43
zbMMWvVeIw8nyuse{SwI4L53|7KK>MudTj2T1&6}vcH0lIdJP(nj!CkyzW#j?8%ydx
zkF*ar^H3wkgQsnZ1PcumS^!UD+3ZhaFq~X*S+3SsQdLcikMEgJU%K63V2hY78{#Pw
zx#PCpSZsbBdj6+N!o}`bQr+A(Y%-=GuyEj$U_%tHkX%bsn;o7dRaK_<CktP}DcI+c
zCm`bxHpC@+|BeIkyKE!;d>bYX642MH<8Z9)c@FABhuwb2xA!}CB~)2_2^HbT#Q#j`
zG&2@bfh+Ra;r3*()U_LTxkdvN`#r7xVc)*Ps1Ql8Y+M5UACC-^3Id0R3yl!X?>Tod
zY|v0|b)pD`!xgMr%6WwMTRXov=s@iKmpKO11%nNZ;d(lPrYcjZ=rv-jvEAamXuIrW
zJ*=*O1Kx7~h(P$y{C#1@g4M{1`N<2G>Emy;rLVtGsvL#E@FioyWiy`&7#Khq)3#*Q
zTw(s720xHs`1pLmv@v67&4AWi)!cT&$-=_I*e_?2<?}`D=Y4QGHsSd%kVspzxI_Qp
zuXm9Eo?+LfmB}tY^>Jy{Yzgl;5j10DVsdldw3XeUeYx4u@^Vtva$4E8?Ai>cor4hY
za+iEq9R^)laab+>ca_<Po2S>~Jo(^XtoE(58$xNEuS8lZg$BNZm)58~{)ENpM%@X#
zzEuTEpZZ2i{U5Iq!ixouU7H9;zQ-wFoqF`_8nEGu7&_<8AD7Bs$RqEdzdMy3{z-*_
zffbT>Cz!t=S^JH)89JrfjT;ZZq+oSVZQ)m_e5C!u&3j4A)v4pafjc`pGcz;Sd$buu
ziw4RR3(2FPi1bWN$&zkFLXVz5Oixey4ebf6i5jfu2JIWw<^hYybE202!|pfR{SZ}b
zU$Qxr;r~I4CotOGKag8Wi3fiut+D!E@LD9jaqKkP=6WduPVv{9GK(U+A9#;-!XkTQ
zFU7RId3<~}+h!Y5>Ya`n2LWSC9SfEra}`1Rt7<q!sT2?FJ7nEHtYk_4T~|Q}c}%q8
zy<h4%^`-v6CqTv3{EGIxzJKKcK!kxxI}Gu!dLpQ0_J1{#l>aNQEL<E`Ymsa6)zsZI
zP=2&+&E!55QK8_qSR*hEf;rn8{e6Ad#V!*Ob*$C;){YTq_e<a?5w`D9Z`eOC4MNzM
zFhxo!#WF2!s%dJ?h5m;4x6u<+j)WSg#cY`01zc`=SwQA-AEwV77PYB+rO67&3=Dop
znnJ^ShVShJn>*l-3*8Xjz>^_;c&86@^F)^Tc5!VxksE19)^Mfmq0Txupg=rCH&rZ{
z`&0=qQoVcvj)a}~5tNJ5x5ZL6Qe+MTERGx}A5B3myiy7coQW&My5ZNn{Zkj#&&5}d
zNiy8#u(KTxr(TD(c^@kc)+BIWwAGDVExWZwYs0Y=8mpDsVC%I;XIFM~5wme?qxBqt
z!FNn*31(ou><s&xhG*ngL4IAq-abf3x%Oz@5&hLL@dVv^XT#qBI}4pt6cz}AHUuPC
zpL55yN=n4y$^4$3(DF%D6m&{PI9QJlf}|3mOLC~?a&bk(Zd_r|N)#OZTF3=*hQ`Zu
z+}UyP(M%`%_9DrQWoD<d3SYb4>P$5-FmQCg`B|x|>y27GHv-GHK0Ohytu~srQV@Op
zp}BEG0;*{xJT7fG0!srw&%B6U>@4L4*c?l0l2i10!py^>BN7y>O3X3ZxX1}<nMQ+9
z6bvGVDL43Mc&-az<taX;2vKE-C`u$!_Ze1*#MEpu_4Mw0%cjk?R}zG{)wMP@2(yw~
z%fgH$=ECrBC+eTolf0HXeTo5AlGoCb78L9qarhM!^fe+fk}e}Y#gS4|^zKR=t;^;y
zC5{AD&#@$lE=SbJ0<i)uVugx)T-s#yN&MT8EYWlPH)>~eE<1pX$D$%BMT3wiXrch)
zB`<iKjTT9DD~^LW((e47h|VPfO_b3~5^Z1iAfDZVA>;g~&37_J&a7E9<7Va0Q6d(?
zAHy?==?(RM5s8OdsHclK3bsF_?~cStx9Zc{T{Fa7N_8bj9Qv8jOp6lPc@x}E%h8{h
z5PH!uBs7@8^EG7T^+7G18L(N`<VXwSSQ|>_8h_k09FMm(UN=il<T}aTvJ|~Xeycs0
zGPpSs|3)_Tjim`ibB|#KIhHC%T8%W@P-iq68K%623a0`r+vk>GMFgDI!05a{C9cT`
zQ=|>1|J{O6La02+*XaXttkHVS?S4U3LR?($V!ee-H;2oWmdSMT_kyZ!azSD6bUJ2v
zCto%KZkliQ*y@(_klmmLE7Y9g2xS9u8$n={Ced<}Ii~Apjg}-v5JGCxMq!dtfV&2_
zeO-}Zub{-SyUwr{OX&C;Nk5n$BVlwy89GwFrPe{MeCtYp{iL8m<#D97B_4<Gwat=F
z$^dQ`O*ayKR`4T@u?Ih>Wy+?2jC&+g?U<<fu}$w@qIlTJTEi=KP^>~xQ9Pqe&&!MB
zZyrVQbe<p%8c|hhSvu1D5r-sm=n=I9{$W+n0=kjM$y{EA(R}kU^3n){kG`>yv=X^%
zFU~O?bNPdnz8I<;Do9T=9rDO3{NV)C$C~|o#n+*#$cw%oZM`$*9Yj>IT`CLT<+F=p
zBPl*q2oE}y%XO^2%+lk9lXjG!7kwWY9ZzSHl~DOXOhN*@c|-4~UT5O0zs-|~geUYS
zOvFKsQ5i#GqXl870sAm12=!Tr<oQXN@;M7JPIwo3D!!#6{oGg6ukB-;D+mGX=d1~d
zHcp*o9+Z1cEc`oOS0lnX9#T;=8kW?+m-9#0iU0IW|3JFDp9PRMgk$YuEw>DC8{%5m
zEJfX!XdxX5c0>*6l!>(f?KPNQW&DqvBE|aLq{5oI4A#lBA=X;X>v3AZdeat7xXA2t
zbVZfF`bNITC?09a4K~jR^{L>0GpD7(#|#dFfUjq);zB`^W2zSuw%wR{Kh8FQ#3bzB
z;{EJ!Y9Ps1D*W9>(%oaxe%}!?vhP?R-@h0=c+ad_zV#LZ$UZ+%t*M?v{rWgQS#-g(
zd>N92wDnl2N)Lj)i^`yBZQ_r?NJ%RsBqe)~&)&{|(vdCbYSy$UmABM|ja%37m*kbg
z#R0I2J%@ujg{xzT_J48#Xlj0j6zeUnRiA^*u@jvXAxXN@^f1>lVP6Il{<{8+W%je`
z3%in1Dr%&%2!kwP(eaNGUuwm1sKQ0MnpP7}&qQY^@7KquNJ_%i1VY;AXZeBO%2;8#
zaRDXf^A0(nk+^4tV`*Bg<;Kuf%H8b9MShGocq4n8Ro3(KrOT)M_6-;<XZl0QQzX>x
zwn}qrx?@?8AWu0YJL}g;uua&DTZY0_3wLQoh3Q{9R<|e#33u8T+uk46*1E38vi+Nl
zE!DB+zH!Z9(m!PGsQ|Q~#idOLdad9B89Hubd5Mx_5~4L6!{elbx@$-~;8}FCuSe4T
zQ7qlGMEOIF&En>nkp`I=W2L(F?5xfRNWf<l1m5~^ixQaS<Y8o#KLavzX!6et1~&)1
zX!U`IX*vB)?(C+%gQz$4hpB-0c)-ebxW|!sb-<Jd#}SgkDCxboVhsiZQI>K;7ib2<
zFd&su8S0{@k@dTE5udA2yC4&`Hflf<_7{#QXas;FOLR@?y>t(vYb&>RP)1G^7OGva
z>MuTi>4@kkD$&vu;W56^<qG}fOgc^qdS3=bd6EzY4Rn@#_9Q71&Y(X_=m;Hb_Pseg
z42b-_5v#AcU@$(_f;w4`+3zJ5S7{zItcxc4i2-U}*~PU#>mU&lx*NGlIroTVJ)Iut
zD#ic4zzEbY+%XMVUbu$|KB2fP8ZmT>wCm0ao*hLy&sSIQjxwcbv3f90cyv8ZF;!NQ
z&{%<igRUr1i!CQ8mu&f3gK%Hf<Yw}PSWsiD6hTm{RSQj0l7^l+x*%tWO*REwkP>S7
z%>a@_m#&9<K57L>B*S4C>PO5@22#YR@(<ZeFu~VAjce7LMM`3th{JV7cOh}{Y`_)~
z;dVtE9LyBG+{iOz(iWejOQQGF9xe)DR|(jD{Iex}w&8ibraGdaMAV`YUBL`<=)_e8
z8Q-S=7geE^HkxH8lfwN4nB@7-W)B-OKiN%^atW6i;A|R>d62PgED8oA?uN{QxD6EU
z1ewh(Pejj&eYeN6Nb+yt!MEe&$pcnyOCAUQB~0-tUD^AN-<47i5+9`zU!x?-$A1uw
zL?G<mD5(n`+tABMv6H9+(@#b9g$2(xQ6nIT4Ms2<phAnt@`xSRs3BFFt7~8j%_gj*
z%|k)y`s8>Y+8Z0CwPYUVNcU+e3+mYLlCYS}e!QVG7E4A~BA6B<IBt0?ZsE&@HKe_f
z-B46u4$UTa-EOuUXn~dCWk=iVGCa$o>f@&OpFzlVHOVgsQF;H#(rC+WJpy2I&aC-`
z1qQoqKU(Piv{jZq<;Ht??OI&jq|{V!eo;|THnG29s_+uK+Z6&J8aTT5V8)uj9P@4@
zmd=zwLj4C(+P7S%CsbGaWKCuDf<HM65dTGX5V|`|kYhJ%eHg66U47?7eW)LC4kGBH
z#D4+dkqs}?-}nFkN1n|s;UcG^{*$lMe@v|ZAAI;9EFXmM|C1W?zg3-eExOL;@oc4p
z`-^}3jmhchk21%&lB;1b84H*u{>{8eZ3zU22jq(+1^uCw0Auj_F9iI*rpNpjST0$^
zaxJXjI^+JZKy7>E;+*&CM}>mlVhzJIobtvu{rhm?shvMy`OVljG!fPB^X=!&@Zh^P
zM*Kf<0zzKfvvjY5^4{4U>w}6b_s)Nef%g|I4+FsRj<gtcQsvmU=OXG+tqojh_(rBs
z_54H%D-OHHVn6qM)A+i&0ZXw6aa^AC@|#H9ZFf86I9F}rl8mzo>bmNKq8%9g%{OEY
zceIi8U^NYOZ3seI6lY7$_`Ou^tIP6}=n-K!zWa998`FNH6l+^11y;IfBaKG7?5p4-
zgTvPBdR4hJhFJ5Nc;T2F5epZJMy42DF4QWccurHSnLYHnmi>lc09LS}tRrP>oU*Ry
zxV%c|pvJXdV|jNo=t(YL@rX;VQUO3|eiq}EW1|iQf$u*9N(XaYT*Y}-7WTpwB5J$}
z1=GIxz3;(S&#!D7Vn;D~EWM5f1Y_9XEkxJ2qy@OoXsB!;!TD(@%jnzSm0&_;WJ~of
zPs~6P3adg%XiYTYFS&JLQ$aWH5mHIe{YKitpQgHlJzagI(&bH`@1uIUo4O{~ZZjvO
z{n=PacAjLsC6&z*gZh~vrSzSGBmH=tM-N&PEkmYKF*`&0<P=Kck=pb)b|MY-`?)f;
z?8f((HbkQX>u(_rH%xOaTz1HsK8BrXTppVqXAooS_>cSHpsIN@{DE_G8#~OL{+xPH
zn8BaF`;s9sR&59-NeCil^3T*dt64gKDqP10Plw5s<EPHe%j>=N2Jjd#%fGi#O;5@P
z5Yb07>tmVsa<c@lZxv5BwZ~1gwQ?~6Qeq535TX!Cr2)S?U??y_Fy?RGVetqfltDiy
zP9;)<A3x=V*0a*b@l1PBnu5krkQX1v%vuc$R0%nJ{gYU*)w6NLq=m&DXD>>B9yw!Q
zKUNYLmtx+|GplUkho0MtB)uMyOT|k6zaT#gBT|<eWZh8k&%2`<DqVeIQbrU@<3ctL
zd-W$hQ@ULr4($BG04P-c!dZg>dR8#ooPex|`>`}Oo*%=*W<?}4`PH>0y1k+T3dG@E
z69)Ez%<&_j6W}h;3&xge+yMWHj~CWWm0m<U9m$T4SXUROrPXtEVXPYzL*n3wzf+~A
z@!(aW#-5YNM3VUZWKL|Fs%L$9S6(KD;19d@7~Qp`PT^5-{B9EeBCH;%zvg&Ow_PjW
zXu%M!m=})2lipuwNp9=jd`3ZHx<gGGYqP$zRKZ9|9%L4r6@fmN?rI(BI1+zQXfftE
z(r_!Tt1A#nrFlv{aoB!cC+<@KA+@ohqEgeDEpp==eb}8-sCX5QtF>?R9aH8ea^aUI
z8Zu_OM=j1lc}?lQkv6u(P2|KD%t_l=8cs*rgqVi6BOz@Zz}=KDU7aJp>dK?om5_Dy
z(by*IWhC|XLRQ>;nP08OWi`NA&4j`n{NCfW9AK=wbS|QLGZJLH8&)?Z)ncCK&*B=K
zztBBri$~mc)GZPvtz~tPW>21itESc6w6C;0#9(~kWRMKS`|GO~nu}7vv)Cq~^cvN1
zL8qLM;3VnC^M@#7Rb!l^ZfBD>(by2H=vG%e4V5NE%W6Z&eBl5&McMMr2P^9)qTq_q
z82S2KdxVC{Ft+z$-O2v<^7lgj+B5DS4kpf?aDZSVA&lg7<?e>^fC_DN&GQPsvR8&Y
zq!VZ%iPr(#@<EpDcHi1cJu5)pl5-5JOKz&8Ym;zmKod0~d$qrDNrg#_#^5?IcvHBd
zGP9fue}IuO@ZQ$i@O?v+GG$BZ1N}To6~ca`&RW{^dW_z5pR}=~F(IfGwt%lT-2%uH
zlLH#BfZK|~a%*+42z9Q+hc$VCu5poMKE;BSFHUlD$%GNAspdQwW;~grfOq;yr?`xI
zdsA$bVY4pY`qGNnah>-jm0Qx>ntE*OGwGfWUZ6#vCC8^VWhI2wK-oY%4O4QU%{cn9
zP@$#+hvmUz*W(DHvsw5U@Xbo<4SI*8&ceGfO1sIx+uT!PR#S>3Rj#+y@8U^=n<s#q
z7b-r97%o-@8OW9X`p6YQFWg+K927g8e$nc^nQoWU(PmBRmoP<B(njA1edFr;H^@1F
zzE$ZDE=UtIv>1OX<J<IiK0`5pH5nY5m%FZkh10Bl(=&QgyWEm8(;~&z)sWCA509f~
zy6y_=tDg$kx4UJXph%}qHy=dVl$_C7wsO#28y<CM!03xgv+amx4@{=(vf%xd9By9z
z_MQ76-emWpIa<xdu;$CJqz)bFiE$Ve;voY(Orf`TOyb}s!_afIh-~tL-3WH1Jim<r
z?nj%iQVz3W*yjBx8G?gfm{3UymseMH8v^pWR>Im$K`D@>F~kNF9<Gpfm9X2+<vQ*;
zB9fn}yXf$45r`NZnbg@AM9sqs-#_I6q-JVaKrcFV|7Kl4k{a@0yghXbTX^T%R?#}#
zf+m}sFj6}F6sbuVqT)J|%9df#E?uxveN(%UD&kafa4kJo;uAU1Aj7rMhYw+{F*f<;
z#^{SOtCi$e#iDeEkc{vyy42*yNrH7yaxfIoX^PEF)71!NLKhY8+?=kd*9EsRo5m#s
zCMFrl_TX3s1lLc8qBRF`9KOt9iV_rXIucj;xwmA>v(TOw8_bh&=|%KP<B@4ehm_xP
zCg4dJm9c>drneo+=wj3;Cg^gNly^5XwbD6MS`O?yX3ST2d3HE5*oCM=Kw;R({jG%)
zBN0*MTBN;(VUQz-Qc^5~u{3E0sfPT7tc&A;h5Jge^?EG*)y%zZtw^)zudQMdw6sGC
z6#-HM7ZC#1*M%iVllIJ5f(%wuWbZo)lrE~dd3mdZo%^YkdCalBlu!{L!g~+aYF)|<
z8yL=`scS7`Aj*{4X(GQ%2e*_UFquO4eJ2S-ffrs#QdS*mi^LKZ@}jW}idI1f9nUWj
zsZ`qHDO8)nOvI7O*gQVfKNf7xlJ|)}$h+KIq(oYJR3)i{5qNj1QBON9M)A|6e}hcW
zmC-UOFX%O>b$ekm(8yE}?itX3%mm!i_XlNuYL)<^JS>B-aI@>(1&02wyhEufsNZBP
z5i)vb@e6Ov1i#r%N$b6gyCM1TzLrCZX4J??5_I}fUfMP#IyrOfhZ>5flO9K0u>f)^
zs3ULmG0VLfW3E=Apd4@2ACzFQFQWzQ-K)sPT@MlfScad0FQo^34*z%b&3^v?c9?Es
z0<IJuvGXX_JU{Za<B+~eDZ|rIPTT*872En+_9(Dz;LAUw5j#|fMn?BVO%3WXZ}{kn
zY(>axpxZ^XLc$g4d7gm>@GnJK0Ku-iY7=i)+Q0y*3imx+ofwwh5*Cu}^Y+`8ttp->
zw}Qa>-c%jqWSBp|z{Lu4F>$EcTq>eHUPB%#8(0B(ssscmhGXi*v;^$g`*g+#Yd2=f
zFG!^zr>!z)RnSS6jLS)=z9*?|g!MdJ1VPR7ElNsR;RWrc;@AtjZw03!TU6b7m!QQt
zk62?0YqI9|qrb~F6~+rHKFJ(iQsfmLcn5sb#5P|F%YA8K9WA{Ttp`dY2?=?V=3U2r
z{qn)rlt!9ci?@Tcmp`L5=xZY^Xm1F5A_Ou?p{rv&ZNesRV+wf!0xhH?_owOH0QrW2
zSaj1Pz=iOI(B25mTU^wcrIhe%p%>;-r)BT&eBVo6RV1)DZ709tE$%R#GW`uCqElbP
ze%Y#c4ysfVkiEel)yb%eGBApHSh{ergoAPt*L+qOLxapZc55Y1%YsMa#FqnH{MO&w
zIvFeQRrMmp35<&n1L5pSe;sxJ6BXq`shoByZq`*CNZPR%K_Cwj4k{+1@?%=`E45`<
zEF5X`_J`Svljpv}l3SnKhCwFw45sQfk&9Q*785kZMR3x?!iL&fE%#|yaZx8tfADhR
zQ3oC2MIR!a3KR~w4~v_LLxAC?RmS*@;;Lz6o|W=db)y*!qO5l|DM%Bw8+UItx?P__
zQ8$Q+rcH9Qt!&Z|Tsl*Q*k2c{XN(P|GBT*5D0ro`xE&%}N_*kt?qd&oj!8<tIeFc^
zeAk*hk<k+qFy}b#O#M=dd+E3wohBAy@LFE`e1Lw!YqbDH2qKFsC@&~TPri_3<B_AI
zSd2VZDYFzgM23v!H>6v(3t(2seXsy(SbCiUCQ}Rpa_gF)@_5n#h=i$$q%>?w73#R*
zkD^IzdN{~|Mr)AZH5#QP)Y`L}Z{?M@vYdjUL59Dmi?;6_sJWyl+z3K<E##&wL7?m%
z52r0H@t)Vp<dwNnRI~H%)*dczCFCUvq-(F&LB_~m`Xj7eK}F!liLS#P<{KYW(S>F!
zL`QQxlJaD&mR(X6o4qiflM#@B2<r}!FDbvB`U{S_u2i3|OUp=pgSWY#!E_Z2gC0{B
zT4-Xm^3-@!D*G8pLNOpckocHTHxOW*lYHYGDbel?tAZZ1PM^au`K{K0&2YuEPopse
zd`T@#Lc-#6U}~6Hp|a+BJ>Na)yjH)An&hzN@K>t|p+s?NAh7oW9mVM6H`_AMHC}Ag
zHC{coogh{d%n-lMt8=(NeaW#cH$(==MnAn=VIb#-wGnyEemm{<QjvS*g+=fzC|yz#
zU6vSFkdh#*rN#Dtd;{Hkz`@hfjd5-Yo?YjbOyXGg`tF#Lud-I{r64IFN*SxtU;X=n
zJ;z%oekwVrVcvmRL{x>=@ZegQLgZHs0}UK;aN05kOop<7&-|OkS%Nb4yA9?u^kHtu
zP+YwpVO=CIKMxFy`D+Etb(i7(A$&q&mSp^<`1+KhcqCn~MODCUnoEiF#P9T1Jfjtm
zB?US32zL|iy>CZP=R6Dv^&UJHE^w9?(!^t^fO4o7DFgY{bzRU~o~i2Dbdiq)b)$t4
zgBV%;^Bl!?SFuz4snLM_-$v-wPboO`X<_doq*S}!^?u3__WCPQ>Mq*H6m%49<p*<b
zD{1Ie#yq|Rhv7z0@PXH2j^eN0SfsdmVTSHKP!1`FiJ5wV2u$|Si?!bt=3ibj6(J<3
zmhulw;**v5lPAT;VbjaId|k?ja6_<Fsv9|nu$O#L`{L9NxU;1s_ntSsq_FJQ9Mm!m
z44*SBC7?KB)tniKrJ3aKw!Tt;BX>%K6B<rP4o{d~M~_vXMyD0i7@hagT=;M@MmM;#
zaHnO+>>^X<8X^sAB}%N1U|*Le8I#>?e+C<5bA~R^6(cTXXMEK*!V1mL)t1%1bK?f2
z^qriXV6fZqr-B+tSDYoBFE5HUbR_(Vq=m}>GLIWF3DcI*`xJ>G;;zB}gUI-!i|raH
zJgSp#J%K~<#_k-rNvH%}q4FkH2i;$KIcq%echQCk|EZRWpM0Y{Qc$@fwjO~xo)Rho
zwZr69L~L~m$3>-EvD@{Ei)(>zel}2>6U=C6C6_wzFWJ#ty-EproBmh!{lj;}bNqXD
zDGcxbec<PRV>M3Z=dd2nR_2uL|CRM<h5Y>wePRrXkx~eSLY#_P{xS)>jILMPxsJ4{
ze}!Z~<^Mib^uN93zfT}JYwlInJBMZs=~fs#`iO<D#x@J??5u$?7@oCU?){^=1A<Zx
zFO#7C_^z`{yV@^TIrvI=E6rWdL`Z)rAtyEfe^F|YnYB5%c@jg${V!3pwZ{Z0CH5T)
zb9#d?(?XWQ9U3{En=@e;5N_#oVwSCL2;6J!kC8EXJzX8-0Mwl1AAJYfhfi|a`@gl=
zqVFmm>Zq#-E?dPF*s_eD2b?O^w9ppUnctG$V>7uUe~$}NXF+V-IDJb*N0Z;^c`#0&
z5$2OScrSE-y)7zGXfEEn25>#ol`O<D*<w8xHc<jJWT&g*CdR5xhJb9sd?GZ-CF6K6
zMKt5exs*R5RoYO!+2y^-AI@WLNxrPa%^P+sA#vpO_nol{E1j&#B0$2*FJ`!G0!_ki
z@q3+>;NjG7Isf5f<zYt-|3O{fCUmVpHLRH+W6qCM7THv@KP7>&=^fXms!YHkHAGQ^
zX+^m**qC5#MWrR7z)t~RWGwH|2qI-_@DhMx!-`F7k%=Ax;66MqJ5#L;6?LEnr*6e3
z$a@!iXt0Wls_krGv~P}sh7#(xO$-EE4FD(JW~ASngK8~M*V;&ua(oCEF=?SKZ6b)>
z4aM55gPNyHDaK?>R#|S{uAU7j9~LrQaLtRUUv+NEO&C91p*3#~x)+@;bWC|#LeB4v
ziFG__Mq04RpUt++&y`0VFSlo)kfn5&2OIPD`|;dk?uJ<RK(t#bPHG_kCkNuDj8f;W
zizDTmBWM+bI5*GCh@Mts?Tc@znr%hL227YH`lFq1Z&%#Yi^DN<z>1t_E%iG@&4_tF
zY|Afs9ePQ-{*iY!+3$ppj}&(_bVj$8G1gP`wBhyG(&XBRnS>z)B6SR}%lyR%dButp
zTN+^D=KW=bNnXSoKD!PMU!1#90LscpC>8SLnVyrn+b2Ft|3>=AnLVkrz0|NYgT8my
znUQJH36%b1#CI>X8!iLc&tBJL#rB4pcMPIG!O8b5xV5ePUNQIvy!7gI_MYyOVAb52
z?mCiCx7uYf4~dWoLMB@Zdz#N$Cn)j`Ij0S@g+j9KsFkk^tk?i0nj)cp%cO=KAV~iH
zVpR!1iNXmwtMmK=wG3JP6n|JWQ3n^u#kpeX^M84X7~+>!qgtJ&Y-gqNRx8-ZLun$;
zTKf%}iBpx|liwWdfivo`L)FR15<Vgd2O1}dQW~{*0wAoGJHgK~Byf462Vx5n**Ox_
zWz|;K@lWT%g(vCmQi5<PzBxO6b5EYgXezg;!KqHI(!c(m7><KGQ6B8>HGQ**mh4U(
zBU5<voA8&xMuLz<fa|-t1b_rs$?Gb@&8b7^4PB-|;Yk=T9|3eaTY7gkWuIvC*6ybC
z+YK5U-WFt}`mIEyVb|n|H6L%n@JOAwci!3fO>)Y~C<R4e^NLi9`w8S|W41<#Ts%+o
zaA8J<uA-DWw+EK`esmW;h3UjB+WyK)Moo#^lzKkWNSP9auMuOs1ZXt6n+v6mwCQHU
zO!RA0k^ASLL1u|h4t|+ElqO|l{9%53OMV+K1#eIBf7q#d4?f+6*QTv+i1H|)S|=lh
zz07oh^=?cdiymao_SC+gLMnr7bV_$n&HVQ>a4vrY+Zc9F*Yoelu>VuBwT6f!^eJlL
zKz325@E!|zF1}7{WvY~lE{iCoq`$MS6sq;IGQ4}oUa4h-+%qpLTXSrFjZGG&R-Y<L
zRb|kvk?X7)fO6h9+IS{UiN`GWwZuNXWL2nn)4Ay~+wX9#AapiokQ}9KZ10MWb`6qy
zn66bku=`~k+&<&VTc)$wzp9HxJ~o+8QEbDMa%<lV#g&Wk!s?C3I{Jw{I?JNz=Hp-D
z{W_O&GQpkpf%7`}9ur+<ZQ$OXbrU<ut7o;9-G>{SWZ3S=vnI)!z%e8Gks#Kw@2QQM
zim>~wR<V^kIg^LM2<;=$7p;o8k}~IxY*a?#+vul4kcSX0wyvh^V727Ur&?GOf8mc=
zu?xM4k7J|G_Gp?iMS836rYn)AbXLk^Qf|8VV!gs3HP>?-*RckpQ*Ew&GRKC;R==dK
zQcMqv^_Cw9T&tP{mB2E1*ZLF4gO@`;dy0e2F@V<wozS{q993)#)-0(cey#Dp5M^kN
z-`B}085xh(-dnj-BrfAa4ST2@EQZ<SMH1?p=#J{%O`0n|rpjOaXwY8Dko22fPq%53
zdoqCRuxU<L!>>rYN<XY-cK>fdxgI+IH19Re*OZ;J!qsU1da1OPV)QoGz@0bpjmS|g
zgZfx9)m~Zg+6zzQb$mRQNziaBje{hSgbADPP|*WiX;g=<$mBrs4?zMn{%BgA&zxQ)
zIdxJoC0{;nI_G_z=F}Z0jn?T&^Gt%qIG85u{aL;8yE7%o+$gNcaBp!f%+rEF*Qc--
z!B#eyks&&{E1c{r!5gbV&P1O9sNiZ$;dd8+5`>~)FT#x}?+0}hMNBh6>?64MVP!G&
zQJ?#=!A1_9*7p)>ikuHb#56)qN7`|}P3~EUfwYvsu@v<M<8rM3VGF0cjqqTtGExe{
zo`Ir&y(62Z$0X_<csI>AKRsZHdO3{C-QVbA-+>XiW2lybBj&B`qt6Ca`ZdD+Vgn+j
zJyBE(f*%SKS~Bfkg`#o3o{2M^ztHORmEM_z0gAk4E?gPEut1B1_QESd-Lm>!kBpf$
zW*LG=xS-mgu=mwsk3&QL2z2uV9Mn!(?kOO6*>j7KWDzJ$&A}FFfWlVMCTGG5C~CaL
zmqVfkN{@6uL@>ft;}<DddM_C*FNpmko#_ir331F6Fgiw&Nv*j&R~1`Xq*`X2NV;}#
z7|P<|fb+!LB6Rm55?bh7peTqe9n{cHy}X7!j9)W@K)L2>X8F_nuq4%)F~|CAc~+7s
zQ~3SD=R2Mt&6t6MQOYBFF%;n^pXVb!uCh1T$7guBr}`1xY3zsrUkf-TkqhH5d%3wC
zIYtVWL=mBaqP@mrIqX1I(uN+dBqz##IZm(@h;Iza1}d0}=gc4C3g#gx@P?^-PLXgG
zoGX%K6=xHNL=)th<32lfG<80oY5ZW~!?JqQOM96(aE`tmTaT08TaTyjdoieo`Pe0C
zT+J~Ftm{J3L^qu=$0_BBHod=T7l-jZ!<@k>+HJ<RL+x>mM-blMLttRqn&j@|a^z(3
zIXOLGa7F|Y@?aijDWN1^X8dUv<L4NKFCeXlhuZD8eK|3zDDp0@PlSQ&+hyHO*l(G>
z(9DA9w!@C;g&=893&9#jTD~27XN?C-+#1eOC$ThqK{)%-?gU9VNdmf8$hiqi^5haa
z0|(*(V?rmMWDQbLKYCY?U|rg)<aEb=6z>X&52r8|oJaPbT!0MIqKAGc&ej=0X1J3Q
zp&~<IA56b?FwH#bbd$pz^xhxm0#0q-D7TkN5f=`#7qo=FRk*LcRdUt!5QpRXjocW7
zv)Ck0dT<Be;CzdFXfJtjVd5xB#}a*}MWi8HIJgWnf|;=LoOqQaPr(*H@ahuX*@K#V
zpjk31>MQGGd}2y#!Wzz5U-CDea<1f*&-1NMkBO8O1V%xrVXH)+U%T4EJfUd!$R14`
zmQ12QpTBB!7AN@3Btd^u%N>$hC<Su#x#C`6lOCNvm|`AKk+7@)5o!&{8z(R<(jP}2
zoMI0phZ{{TGcR+_T(8x`*gbdj#BR29hIq}Ns@|+LAP~3Kp?FVBPMKR8bWnxH?y`}N
zqRUG0x4<EMG#r^SD_|(P<vD9j%%Uai{~dNJoX>!gkJxv8bL^Hc%*l_k6<EkjwZQ$X
z0F9O}Sl<vNLKo%o*<A>C;-e8w)3TTg=tkHL{lg0#Bu)ep)l|{@Q|OS>os=$#U4M)r
zijYcF3@4|p10u}VWz=QK=R{3%wJpgk!?2II=9p}g-jyq2V_j*=p4lSCJ*e#~@>`1j
zmf1bSH5sDHB}%*TFV%9Y$b_G-YY^*(xC=Z9KlR3y7)(mjELdDNcJuRxBnC3;Qtz%M
zTl_%vvM#H<yv~q2T~GJ9wR0V2P@37jp=957`%v(~!1@E+I=A@in}Zv7m7?V7_#+VK
zaOT+CD3qn^P#Z-&X5?j+iV{NwGfYec`H5H+anB^Cot^gYN?na)A*^M9D+esT@wCS9
zp4cxC6&sU}7N(~iM18a|r@Y0nq6TBU#1~A(z!r(KO!#m3enSEuD?v@4dnj~RunLZ`
z`<mrX=x7F*`aG`n<-r7im0KLEvy^qMg*RR}og4ebJaR<w!C=4$@JLa<Xa+)$@q2$B
z?aXx13Z+*VaN-b@mi;256y$8Jgqi6^B-)1mNnK_-)UntTdyfDMIJY{+4>N=$WDro}
zgOcShn(#Z|NgQKKQGl^iKEyj6a*Yuk^z??}d4-k|cXBS&4)c2&3|2fm>b!cOaYbcp
zgTF+W<L_a419D<M-sBRfBL>lXt}_NcmaX-W7jY`orObA6<(%RFkG;2wj$_#tY%OMH
zwk&35vY45fnJi|>Vz9unm{}!eW|qaw%*@PPK6~$TZg<~)J>Gb~@3%55B5RF|%8VIv
zt)SvMBHWxxdT}o~A&LJ1_~!5&4`(nAi@b2Dsy^jwN#;VIpuq~X{>X5nP^70C>Ajz+
z7LzcTT)e=vUB##Fu(z-pxBdLSA?!@=ac=Wl5#6G$0&>pIx^}2d=8y$=Q<!Mbgxz??
zD#2kc?q*)IL+>dM^CGmw<VH-erG1n6Lp^F=E;~0#>KKG9yudOWx^dVB`Wp=ecJsDU
zkePHTaBWOZPI_fqI5r=Xz8v0e9>M3`i9z!!j-+BeE70Q@w*XWAqNl{xUEb>KuQoUE
zh*579Un<Wo_f~$lf=i5ujLk01ElU{KCmW=NrkV>KK2t)8m~uI+<yYTz<9geRO?nDF
z64Dla6TZBKOcMt2ZPq5PtbzvKK%4q%C~mvd;IAM?->rs(mUfJ-Kg;Cvgf-g1`S0*3
zqv!fVS}l0M+*??z3AU`CQy80x<>pY0eP;&q{6Hpc69~yP>piML_O#gxuc3K#<_g}h
ziO(WMF1EBIydOngN8lHF$rE{iuvlD``;djmOA9gh-Q#GPY>S5rbNT~yji~1(Ip+7A
z$D(=GSznC&FeL5ILrag6lRP+MZ0xV{Q0rgg5ABfp;T(St;k;_^BqcRwG7JlG$ggKf
zZgz{B9H1-VDK+yqx89&aour*q5nL<1*L%a#H01g$jUf>LHtrw?ku*PSNxEGM(ES?y
z8_ilNosvJZw-|W#)yae~?S`_#RfN){pxrAdsf-Sr=V@S(%YNseH+?JIqhv?|q9kDl
zWg_yE%XU6suM@Lc;WqTdANxjDerbYx%GM6pgUP_bz?HvkwHP#lY!X%av*%jui@N&E
zt|s>+o?-4O3P(fW3gw3x3|j{_gj;hJu5)glXI(KTN4-J@M$T2H(6zmOID?*uPw-jY
z{OaMjI*i;%-ew(9v_civwSw!%uP$On&Js;+Xo7@(bYDOshuJa|jg=)iH7-Xr>v>)Y
zW!9_xJgO4S(qq@v69cs<nJBhvMQ&flBZ{812O6De3OGmnPkjZMvlE>7w<6lB0AymN
zD5HWF2flj^mc7Q^s^6N@m%lJr5v~enbBddAQ#A}%Ma!K~e%MhBK2!(FMqyCBWMo}m
z4f^5DRMPui4^iOrxJHtQM}K?TOOn+Rnw>t6RmX)WC$m<%C+P#I?uHA&K5#ybu_v{y
ziT!~l2Wz23zI}C;GZOOh=ELz+06O_0AeITM6{KhpklD0F*!vY3@8gp5FOXCdkAup7
z^DBH%E+t8y7lsODTbY{B%vuvh`-_^|Dp#s{AnYHpBi)aRh1BLnn`yptb}$Rco44X@
z>{!LhZeo*W!Pjnj`fnb@*(!#Mn#c_Dw|Bi=Yo7m|%rxX5^Q5ns)ZlOBBcB%LACsF(
z8uahdFe1ahzW-esCbs53r<TFIY3;nfy-?5){6$v6CbExaCSG|W&|o#p#!}g0|8ZTi
z9Ef}$r*M)+e*P=H00_$d`xgJNos-{c?F`kum1D<r%!*I=#|+lLsj5@*Iu8n5C0I|q
z68>$w^aYccdTOW%_!+Er!**ryPin4t8lWow6O9cea)YB20roAQS9RxCkeI*F)t9?`
znJ#8Mj<F2aj<|0%>z@#4V24u72hx=#o(4WmJwD0J22(9-1w0MYG&>e`mO2(KA%I)`
z&eRt+U>?5$VIbSzHBKHHrzt!>`aHFB;>@AcmW_V#F3Gv>k=wabaD1;*Q|nZ;RGihu
zNLY9^-|b{DK2*>&EiCS46CfV7RXI)u#D4tO!#gv0*;g<9yW<?jnMuOFmUJEGwXUqh
z{65>b{)N;LH#KMvKWiiQ*QR0{d9ZFjv2iV_*vhv6c8Ga7(x`m3q_voYZqCeLIYNjD
z`<$HURaemVlJ0e2_H)I)^x}WHm*U#zMI!bv`=R1M8ToOfC1qF6*Pe+6w^dG0&ao2d
z;mcoe@@g@3(#Q6CSFn2kPg^Nq%B2_}AFtf>`D&Dw*8cO)9<T)Z!|!|13?C%6rDnCq
z_mMXl@j>p%0}<4(kQB0KJcp|);FT(hcWvy~4cn{(J+h~dbJ2YpJ94v@Y9&5kA0IAw
za~zq$frZ7KL>DIF3y7|5^I|hTYMxotfHuoblqAbuj{{qcsJumWUYVV8Gbt_QU4NwS
zA&u+8mr7V^ZRIMfMex<p0ek0auCG>583M(<Tr8t8oti?uX=uf-c)zu_d+Hba6vWf3
zgh8xy_8$4id)HPa0rqGWBf{<-%A(@1SY1N-(b)cT8@aE+*bOhK7Cx?grW^y8zKuc4
zT_Sk2<o-t8j`ea6D_h+Yp29(%E<IiW=@MJ9gzINa2F>f>mgLvx&JJn)-}sei`@ltD
z%4momM*7P<3o{h#Kd7R7m_Sd|rje@^-t04++0nc2sn30$-8n1J*1Z{2c@Ua#mo2<j
z!)w|jyt44y{BmurDgF4x`~h(U4EDKS9~A4C#i{2seie-7zf^187vR`5-Q38efco*=
z4?W4r3AtgN@u>}`>W0Ifr885*`Ji_alHS{5P%#hwHV|Qh7lC8~gN2N&l}Q#uqm4`p
zAf5@ZwA=P8Y{q0KgpK_uOWIs>S%g<hchjCQ10An$XGn#dhtgTB#Nl^VpdagF6^D>X
zu4v3rk~kt6LvL5{w@eRJ!%Eu1J!l{aZ(IE8)$(Ir7DEH$6I!A8@evKR*$JFsVntng
z0SVj{)l_>z2qKv2I(bQ@d_2NDo=x(tkQBS8!_uJNg*+n3ytNANMNqg=KXl)Ho1jTy
zc;vURpXYrQpDx-(ADG}wF(DX@XsCE9i!qJ7qjU8ezFS?8<G&%$mT-GsZ@VY!Rz4V4
zy42o!LNIQ*x+pf$d{?s*iVD4K&)q7r?605vq@nTArA@oMN#br#&`?L&+5q*N(k`#Z
z4pc_v)t*9k+_eRf(_xGkNt3V}VyV}01Obx0{81kmT6q_rKI1bgR3tOi>8Dom^dXF6
zXNc${b9?N_PtP!&8p2n(HlsI=RC;R;N{!~uZX|o6TqYAE<O`aC4;j_E2rd;6z1{q|
zq5kKPum=g-JnsoVtijn6frExAD7UI6*1*}IodI)tvK&n(BXDUc5;ACh&#2-Q`<4ID
zclcmW2@ibI!ZnrZ)t7D$Vkub~b>$mrfV~UM)6H12(>2u^GG~D{hi0UL^z_eYC8YN^
zFmayE0uw!$bv=TQhcTVzqQuRj5Pr(V4#l9ocHKuWF$et5Dp@g0n!;z-IyDCgGY%qv
zylI*9md$XN+e}1WiV%77YZs$OlkAXFQ8st&(9ViL)__(LlU+=Ba2l{_TFy@Oa3A*Y
z8-gNYFJCIQb0f!n1b8Y^v7!R<Sfrb-2V(<l&ANK<n_R7c=S_#y46|zv()vr-D=L&F
zoX?IfAfgKt8zQjtm0XN>r(eE#W1r@Hj!FP~ID7S$ns>=2!ziwHYnzSVjpLh;an*yV
zuN0AscQbE0FeZo}A1Uy5!3gFO-Y_S(#vJxC?BV_{M~N+_d)!kI<etY<Emy}A$-WY>
zr}UXH-_<{b`hzirAGu38Rl-_M5kp%Ta7!9he2QVjT+BI4qv6?(V*0xx*x%E1`mBT!
zwhxM5pe%<#MbR9IJpr#m|NEXn@;3(Lg|Jsq!)UT%9HVjG{rm^ir;(-K6MY3HU5-1d
zy+8%(P7Ew+V{A8<>avf4-vl^0Ibbv;kx*7BMDX<jhO@!-)=*!qOY;o<vFr!LC4{WX
zdwx`dIKky`jOF897fDTP?Da7{^SMp#O}*OcJT$_C2Q)rT?|Gh2Upx-B+{sS~=jKFv
z^>21|#)Bhil+!-(mDjnZsx$YY?9?^rHc0K`7wx7+dAxe=F#~N-T1Pq;B4iPMce<>E
zzkA<$5V<*;8Eq<a_nUJ<al|rd0CikqdbW5xde*t8*Plv<dBKglWU%NyrUI-B1M;>W
zUJojds|uo+6;m*oXGnmPbD!NEd;y+|phJBf`I8ar>MT#`6G7aL)(`_TGCJK(!$ES2
zI@RhzlH#kaK-acj-35~?N-ZLj5<r&WoTA_z^N2wTAsnilQ_awVR6Rx=Rw<=VLl&q!
zUgy$W#LF>b=1U`TbfAL+$b2A3ixAifA#_!#cK?;?Q8`K$Ki`ElWi1^bNjXJ5Haw&d
zr0-Hdr@w&&!p3St@BkAlgrKyk(bNE2sxDCVfi>GyeP+2naQ;Om==i)JZC2cEVvsGs
zZ#=uEI?nu@w_QNIdUVi{Q^s8Y8R=$VMY-CiISgXnSICR?E5&OlbV%7#vKZ|OYulXa
zqchKm{$c)}|C2>00vQ{9bonX9cDhupQk6So_d#2baW)b3<f|k2h&n-drUDsQ;I#N{
zV7|E-_t(gGjqME$cr(&DO-c3SlH0tP9A9Vp0-dhwz-@TFk`&o3SpZUY3)c(LqN6;y
zB^H^d8lg|~1#kX0bk})Ot)F%kMwNG=WxC{B!<uYsa`gasuSA%UUl{1RSb669+glj!
zu6R>qcB><0MYXh?YHG^)Zc}%yQ+G9oe7?AuFa{dlQYU=h340!#5MF$&9o7tlGOY7X
zb6`(f#N=tGmYFcVrbIA@gyUf*rA72(%A`OZTAH7XbE&uwS52rgE$OIiSQ5|f9n=k)
z@rGS2G0wltD;sj;jMr?xDiVkeE-$r^C{igD()`SnSkagkY3YFnB0`fqPQ>p<G&`Xi
z4TdS!ygr;JEf5Pkwso_dRVKKKw)A$bih!51{G+OwGZjP+UHO8%lSq1j83Gml-M&QA
z9!>=2Q#&ocmQ3a}m>n6oX!}K`yAT*6a5GE=XJvuzjPNkB1~05Fn$ulfo{$^zJ_tea
z1($fs;UlNfLK@1$+mlak7DRo&n+Bq7<#KtoT00PvxT+Hx-ps-2UA8(l{K=I2Yeu75
z`y@8_ZJi&yQzL4pqjn(CN*u!QmMywHg9lo-uy4U(2pXz4alzEmf`4azu5J>0Y{$kd
zHQjA?eBr))6Eqbq#~WlLr-jokYae89TGJTTBOd1hyN5ddJ;RGW-idk>ptQ_Tp8tOC
z|5d;GdcyV4(@NTCb})x=-DM2iCAgSm6<>U!?XgX=nTwW)=p~3sc{99~<>@gwMBsMg
z(_-ZlzPvgjBn{PEtz${B-Lf7H$$io%ZNIjV>q4%&1nJUK%{X?j-rJoINtM34Jno<F
z?v^i7L+>8b&)kdrvxY_DTD(Fx9AoZKYO^soj9ev_p1*xP3tkk0BxFpx=Om@gxRz!;
zz4doSqJJgMN@IB>U2c7@_b{`HW6s8-6WPfoZ~P)g5|l?hZyg6}(m(9|LvAw$S0+E}
zLL<^wSMaHo37^9DHw$mo=vPQxR+Wmrj|Q<1rpcH?>~}JcjID~3V)S^{$vb}|cHqma
zb-&FLN0qZ7LFe+ZOg^>kvE<rGgac$XU_oJ;kQ9H8xB~5m_SDWNvFqz{_slg>O1m%5
z7sSk%>P7^%mGQ_}$fAmqF{B}J>CPL++}yA%=${gDThr@WrGIZ&4|ZJApwrUzaIsX2
z+LHz_n|ml-gan-VtJ#2k;9X^k6Hg7ZM6$x&R0Kyi_F6n^i&V5Cl>Wj#Hu9tuq2x|*
zdnnbQ&7(YdzouaA4=|Oxejn7lhjkbiJ#ueK+{6NgZB%Z53wiySZq}w@x@9^d07QJu
zbG<}E^e8~=_J|yRq+&2vgo#w$ETjmKeuT-Jr9^LF>CQI1@v$bls{9Q{pqV4CmEHPv
zf@1QTFX8q_VZLt_Xg0QjIgUYMcs)^vpqw#JPAi?#6xRZzoyf@=oz1J(zT}TW+)xh)
zq11?*SaZq|C536j62*RZ{*813D0&x#hZ!rIA-7WIz(~Umd1d+b(w(o~0kuW<;)h&?
zN|(XiP|rcpXmAQIYmm<!)!_$3jX82NSAGI%Y&(+LsSzbYUinxA7-VBXr4CStx`2a}
z)}mtqe%V;_VJdr$YS)`e4eo_cFSt~%%Xk!tcvx5l<qtL17reP%%vBtET?{(NMjEgw
zwW_yY!4Y1D;!ZX`(AtYeJHK4%=jBC@r|E!$fw)36D827u!p=7;9bgknB*%N{5ua$m
z`S1umB860Y7t>GuWL=4v+uVsl47TeZCU6q3E_MFw6Gm9DGobh<{I`#b4KraU^|1K0
zpJ-?2M1Fs~vx7cpILLrSx~_J7WOL(+a$qY4u+c7iy!ML%0UE)Xgc4dmQ%2r1JhNGP
zrA&tAFaivi#=#2>kOB%%Go<#+U{KR-C^vKZNF9%9a;Z)V8^%&t{-UR-Ukr1ir2|t{
z4QnGZ9iYW<*<>&_8^8%bh7c}<nMv<!F^5-+B$t7Va@&wjZ9+kq*0~^K9mQ54o09#>
zdh|Yu;ceOwar6yI(TDNvxD1||o+<r3n=Q2pn{C~b$5N(=aJyWfC%u&7+BXYZ(4Hrj
z3xacBX4=7X{j>Yzuq_$;tmP-}w;e(b>%NXfDVu`{Xc1xu1XUR)8EpA1cW0#zA+H`2
zT37M_jPJdGHty+U@$M+x_o$Uc;KRTl9ttf>3A2^puHAK6-jga^?vPC&cFAMW3{1S|
zk)0iFQg$&hVavBIs?dmFW5N{$f?1aQHq$Mfw0>Dk&oX<eQg)fIQqNj2%6aPD6%x)4
zKiMJ9%&@!u4O|~?+N~a9#DcK(ShXmWM1)`B{Tt(jF|}7P=R!0-*}#x+>%Wkp+#7*w
zzeQiR$W`N+(Q!|k$c{%UOq^s6MfxqU9*WzMA!4EC0V$Mm;x7=mt~`c^E0qOtN-X)U
z?OUp1KJ&dMhH>L@5F!M;*C4Mviwoz;OBrMr2M|olSS}=ZPN{U0(^n={S&*I=ww`xL
zDY)UQd%2$TnKI7K3e?p$$c;2yEqP>nT?FkGNpNmU$atK|m(b5!Z%oc#>rHY_ud3OQ
z$)^eWv>SuFQj8L5DJs%f8~8N>FUFv?<e@hL`_b*Nx1q3SY&bg&ztnjkjJ1+jya+qb
zdRPF$_M`{c@ntS9L{}<Nmhie-TjH<fAk<|wjfw_M@DE_ooTdX`PpJfQ+yb0!%5s^0
zVv7q99xs$qu|R6vt!a6;_KJ9Z2?EvgZhc|IW(g@a01kN5?6buXH@9SkF6pse{x1%E
zRMD(Tn^jX-@XTzDUp*!J0Sjy+#d@fDPaV{_jiJz;Xgwby7&KWkR9Z(;yuIkb7TNyG
zE_wlcxLR&MD;i&hl2iOa6p~i`-?EV=j6uG%<8GZ1TFpNlv6#rL^ZDI**W5C0HDR30
z4GO4KEtiR`hiB^<6Rd46G)p^Z^|IPuqJ$qEwu3bAX0aam(wbHxA1tr(o~97D;duw$
zi-(`XO;$B$yr;odks*AZ%ER5_cw<#hsv$Qi*w%aLx|#gCj*9nI$vWA@6VM<aaU({Q
zTK>HaJ;OD_QMl(9*+XHz^Te=260NDNlR)M(q?FzKBm#9qPd)F`cU3KuakT#Z{S?UH
zWePRLHm(rE#Hd`T<8NlsZD*AC(R&>fnto-8bQn*wgyUV?-==PxtT$zO{xG__N<Gn`
zkMhFudic1!)cWoORu#+{Ufq5@n?W<|^Nh4`A0QyiuDqFamnW{jf~WnVJFC7J@+y~d
zZkJ2-Zp?cwgo}u)U@KZ?TQR_2NCYws!;$cF1w5iV>}cT2>bg|AWakR=*3PK2(nB62
z8=jitb$Y;1bwG{%$)gcdZlrO;7;rsgq9NOEJ>a1m)e6ZUI9IkE($czcfPcZ0Xo!eX
zdEdZoD5DgcsM~IHf{^yH&n5zg)JlQ>aZ@FCGNAIgx4RFJf-)GB2{<}}Y_Op;l}2Z-
zIprks%Z%s;b5lqSj~I}}f4jmgiQw&<W~rjBFxdeEOZdE_G%qk0b0A)i-gqlmh;h&>
zuVkzIU9#l>V9GR+i=5oNnGXrx8wFQIEf_gJbx&T}M7S2Tf3J|P3|DKzX<ujXc(!?6
z9p5gLt{jnYJaDJb8GNm66;@EH;ix`&`;+BJ){ooYCAjR_7BVqd)W$Oh-b-n1u*rrl
z4Y92I#(-Gc2y&KzXQ^&JrN+KK<NuLrN-o9B|6-$h0TRMb_nyByiH?2G2;Z!;|KzbT
zSpmTw%1ogw2_Ihum2zQv18;#B5Fl>1O&N={1lE06^9)a8!l(gJW!Md=>3-E{o5^;y
z^8Ox{ypR;IWY6K9;!TF?BZH>k8{f5-;~z85TQY^%aAhN+`n`bv-FtJ#!PZ_4pycEQ
zso#9>6qiW;2YW&j_bsta|E!AtH>}L!BY~g=vd}-ZHUAu!Bl`z-eleBo`nyE8geK}g
zDSt|d;QttL@&Dyi*~10ghl>pX&7;4VppZADY?kl-hGM!x7qj(z84!B^tNEbE$d}9B
znDHi^e?!#&LyP~n&e?JnaODfn><2VH9Etq+FRz*!ICOKWo}>M?X%;e{_{RT6t8n7O
zw^e0!e2nJ?5TCF8$B*Zc$eBd{K6pcC3YysQZj81*=qLKY4#dTO9mtOWMrh!qu(UAa
zf)t)+S|xHxM`EYrCgT^JdKEp?4J=W0_&Mbt8cEZ9J=`teB*#x?$FSva!5h-ao%GuB
z`FTl3m^bWTU#Fx&{*e|Kc4(u=&a9}Xd$BJEn-<GI3U<-iP@}WnjQjPd2Gb9SSu2eD
zq3dTA9G%$BYE#k!P_49u^L*K5UHR|MRFf-tpFAA*64V{{nr=AcUfSdLca>}TJQ0ze
zaUB0)k!0VFU7{c@X&Fc<R{li>Y-0^izIaXwzpDZ<U|dBUVNPB}(Cd@g=u$JfUuVi@
zPHjSLcxyITA`j*}i7i{Lri<6Wlicvpy;rd<Vvc;<j)V*@#K;=m>EUvBbOk{jTa&_u
zU3T4aD0}J{k~>vO68?AGzj$E~C>Y2P6-19oKJl2ydIr5+Ew)&OGI0=glE!y+x53HQ
z*2|dsYFic4%^~Kp#_DZ6_Srfn!V~--yt-0H%DD3hbk6U&afPrnv10}C{Cq7{b}~=+
zXCADaMHj%X^%36N&&&H9$Hxmo>@%>=y?(Wj4LG?>PJ~hVyO8brHYcl2)S(@p36Nn=
zU8*J2$}$+VH%1kDMS>G`U`?D83t{rfIJG~-Lqca5yy=#~q!f9(Lh*RJEF#(#9B)O3
zb0BAtQL!BPmL>XFLgIDYcofR`cM`npdQ%*rD{`~j5I20In$O@n;9>d_?s$YR<22Xj
zx1U<{p-A*Z&p_~!t};sS@;=*d+BEKo8@VVoJdnu={ONg%<NBy=J))XoJi71D7*4Y0
zckaWh1@TdNr+k2Il-J5&#m+g&yI=k{On}tqK;rAHE7Z19#1&}49?c>1Wq9WOWX6m}
z1Nr`^I08;(-o-XX0?|$zkhyhP&SyLg6_?xH{xyQfcY~bk1&l>=(1kJpeY*V958o0j
zda`B@mg!@|wCygY6#?wXzQ8*Bi$T2;sOMqje_Q~wBR1G<CC${(%I6Q{=_DidaY^#Q
z-GEcW<~>NTG__X-U<?2){M*&{v&RvUXExbe?Vu$WDe|y-H}XkuzPvQoK)_G_vX5$|
zkJBOTETOL7kI!27!EyOPg5q5Y)gtjP^!D{f;2(YtQ4byyWJ%fd>-8Bqdq&Zc+)Wp`
z1&{L8h!|mwyL*l+Ib$sEq@Ifnp&C&N2=qEyB6{#yp745*k(64yWD*3bJ&X8>oIF?v
zPND&|KTEKBC7<TQojob(es}XSr0JL=thY<rlK1W^LSJcO<yng(yHv+vNS9f>-^YbA
zLRkIQQweOW57`!7N(Q#x2Arn*!fQhgK-a4%rYA*t=pjB85Wc=ZNz<G)qmGJ#^-dT8
zQ5sF(%(9HCBBGfSd-Dh$G^xP$pwd1O^d{99g;!=udM<TCh@2%4p{-^zq!f1_{~_Oz
z#&M0O7Li-V;ZztTE)~Nt*$VH^hVkyYDDEsYkHqwBw6c-GbXIV>X(gfi0P0so19OZe
zI4hXU-`40Cjx53Q@O9l#R=+h>qRn+Jw^v6e0Qvl1S)W$%I}sN$JPBBVpb)lGU)n>E
zegBu4?}k=@haz1!8U;hO+<VAnveW%i&NgMG!O@*qd`=4{|Kub*xeNt&19};UX-?+@
zeeCXub5|&UE93@hL>|#*=5+S#8EKve(z;lx1=L|uxsLzmFOZQa^W>yIWEZzHZAcV2
z3)lDl&Ap*NVK^+dCGnFEFF>cW2DdeGldClvytv&QVXJwruB{<3(Mwgxg=Xn`9Q)p(
zDh3+|+w7CbRb|JI0Wgmy{YAk8ax7p`$yr`Nj&Eu3#>a4!ZEA2t(tF%ER2jtuMQLh-
zK%HW2fq~bdi|+-UFo8Pm_a?E+2^<x6*Xz*?;YPb-5QfTejqw4jWsB!T|E?Cu=)tq<
zHNtZ(0+Dt=FoAA)ll|<XQZ?j94$A@X4#2@W%cV*7e=Eg|Y=+SAdUJNksu_nma}Ok^
z_L~-4$wPGC8)SXeB5Ht-<W-lmbc$?SW(O{!h%D`as3mwnBl4V+MowTE3d+J|2)G!(
zWTz|xgu+FQsc+c+H~0mCZ%hRzi@tXBUA=^|!Y+SDmadv8FyhWrIhV~#pQIq+jItui
z`FvUML{|({ps2gmFY+n<ckM1X#EOqy1n}Qy>i}1T$HJXD^6uRVKM%jTzz_M0qb6Co
z{cGk1@1BT9K|~1_)c6=>h48=eC8^h6G!T-W1Pb)@Sk1wEj(I;l9E1galruLc!;y%p
zT4UOcH^fhvq+NPdMbFFgrkPn*kc+Udug5*>#OV0fN>#z(>}5QhhOa_;w=`QVRol_+
z^847*$JZS<7Rgr1soLwq5uXF%VDnrw-(lfaEx|j~aJBJ<!~60&nvvqx4S&<b2$z&J
z3^=w|-8`H6@Zc-kOVpMgIYG?Hneq7yr=rVv!>m%Hn&zU88KI()n8d<t8Tr*qWdOz6
zt|YpsA@z4=4AVMYYd|5$XW4$uqXCCNm^sed=y<#ljSoJk#AeJ>w>AGL!k+L#9#Dn`
z;T*gNW;m-th`~2IH61LnX%-<u@e~u{K7g{bIaW?ew1}q3XkOQH=tuqJ5RGi3@)1>U
zrfE-&354iE|KU;+C7&D(*p8t0L`d~|V<v1Xj7uWMLCi5F_x$)gL2p!~0+nYrB48}w
z$djUijQsgNIGlNa*-sy;L!hXv$YrN#AjmZ5NBzShq&Qz>H7zTq9dONw40CLd+T70Q
zm(z9rONw-{Uvt7;zuIgHbz<d){~GevngHU$2a7kq_!}+PZk~50POZnLy&ipiD^#Mc
z5x}z`>N1Yd>I4rumD+&;Px#RIxAD`OT4Y4PRS0v*hbY->CMQQ;GvdENWU}VhDcLu0
zH}VeY>a|vAeM5?i<tYmB^zBqo{DIHwV<4;qw>|{3?2ut(K88lEcovJsc`ZHcuNGNF
zG1tHc{teuf1;p&aqU7AN_3)VC)8it=pM{&%jG;llnahhe`%kAg{DU(If!$KWcV(Y$
z-LKj#4Ep6Wb}Ud(j4_^!k*d!>2QS#-yfRkg(c+v77NITwjPcm%`fz5{Qx;j<nbW|S
zB)LH4$IoY<kg=U+|D%|Vlj_c}0EnkpbAP&PW%%d9V}6YY_~pww6@|C(IP=1t0w)_d
zGV@1kBac2HB939k)C`*_qSRdpG+B(1UuOT6WZ!=ygOvkSrV*2bV9CNLBhV2Qko(=&
zIa$hsRfx01sGYr7Q@@&dBNy#44-$TERbY`5JX=QfbA=Q7A%S$tN0LAe6(+6IFMesf
z)r+vbH)PWs2Sc1YxRGxcNYi&cYPdvH#Ip-hD^fHO#9+PWbSiwi6tgp-(b0rpgH^rO
zArl9d>$gAs031v@vek+Ub3!QJy9F~UJujE@X-1P%;@3^>sCnRu*D93Wl$L__Taqg>
z!2}i#qrlAD5W|lvekJON5<b%Nwf<086}jCIHleM+mubZ2>6h9gNf0?_pm^{g*n`EZ
zV9-=(K?tYG4qepR=m*x#_uoM^Xu8PxUu8LKt9e7^{{^TO|K6<_!~M7sm~_mNdKOhy
z;?MvIn6M*rXA~>?Ez{d&{*00_xlnV|QkpQHF#X0=yq)dcoZ6r@I79~;vbBy2Fla6f
zj?(8KAFz@e;cSK?LDV_UJ_pP#{<?rSg~W+dtBU>^BFQt%I4(&TjEt4OPTwNL9m_|S
zoW=8=6YX0TTG4J-#u4eape$c*+2{Y5Y=)P)Xg6!>%l)%LMo!b6RO+$am$^m;8-sDQ
zW~;2)aD<ZlgNms8rEGD-ZnI*J_%w#U*RwUkAIMt^Ze#e80Ih|;%v*HASpl+SJMQTm
z)A=t=(eEEe-{n3~GFW(V#1g&R$K44+2%n5}biUWGk5shZgq;s{ty>T{@-caa;89yF
zsfwLuM>`h#1IN^(*+g$VWc8W$70|yT(hGXp@<(tc@LBs(^Jd50*bEtf3SnFr!KB=;
zQd)h2NkqUWN4*d4wRl6m2a5UKrK2+!NTXlu+S36vD)gzKSO9s$8{i_A@Gt@xo=JOW
z)Iyy8{_Tf%na<W=%N~xJhVtdy2o~qesSLD5pIM1UbW(3iv~LK%^WL<Kj8ljmkAhig
zG9pyiG4*kHnyUE1#N{MjC`*B1&$LQKYWXBebha_RL}SPY3`0xr*tAo;IB{RF=*p7l
zAuN`xfCH0;dN@iEP5+D5&ttrC#xfI5F*MA)0d0G6!}G6n+DKRPM22$biyQpxh0OZx
zuy>buBK)7U_pgwkXx5CWFN}5Fb;gn#&a=nan^=1-z~3mJnZizCa>l5->NN-~w&te>
zQQ{CJnX=6?c@@lATj%x4Oh<CQtdar6&uN+1$}dx1iR>7n7xJ&CLbzRuw=*rS(LLdN
z$cPVJSo?7)kjjHsr~QA39APSlU7lY{200EQJJ&QiycmQLNZZOw)ml=Md_uqV(dwR@
zR(0Bb4Rw#S_R^yZn$@WM7)N6c|Fl#;8^r~)>Io<nN9bM?!hZ#1A`?>7P&A*0$*7OZ
z@&(wyAcAqS)R}OV?r6S&Od4Cf)W^N&igz_Rb454BEJL+}KUi9L@mw~+YO<{pX^c8<
zw@4bF1hPG@M`qszUGizjY=!s}g`~5Cf%&wxQpk{U_w9W7kB!FO(3l{L3l{B16(EO{
zInJnMAJm0bU*?g6w1+A-o`<~6BGLPy1<ke*ZX69W6D~j_DqVhiar%Wd6?A)+nQ<)S
z29I1QZDF$Q4-FC#&j@vm(BO~WIKx&>5pbiDvrgVe;Qzuz(9Y2XOyDD5iz%Q@*X+9{
z+tgMT%@YvGrx4=YG*vbJ)Vu9BQ22GAOa^}KjI|S$v~5BDCXjGBFFS_93g@hrbX|Vq
zg+c(Ye%=2L$$4`LzuQ-z&Gey_in|G8!U@bCghi9_NU(tqi*y=|{IU+}VqN*30Ite3
zFzZ{T*y2U^%?-azFyd^rUMN~5I;YJoM4-$V-Onw9I3bF8JmR_;=`**I!)I@@IcX@+
z70ZFRlf0A^?CGz~Dxw*dpM)_JrF(5wCM68?;}74F*9W~tD#m;HU)s#9G^p^ZzUBh<
ziYsE2Jh78GUvAe3VQ(CV_^y)V=O);i`nsR@xotw*;{E8ddLqg#^j&X+2i*aY|GUoi
zb_HV%$urVffa;ka<dsEWWz;F9D2Wo1QA+6$b3I5o0cx6)W^Pq3!k+Zg&xxtNb1eJ1
zxE{<t6o)uQC~P8=P(XK$`kr`w*<_Ti3m0y(-kcTVVrJy)%$h8#k8sYKuEaato=y0&
z#)=L{N25h_@u<23Ukl8jABS>!oUGgu`|lb92_hZ-=bFjyJFy3r&&%-ZiyCrU<-zey
zK7E)KfIIPUL&g8z4a^LgSLByA^0l&)^98=Id!68dUSYo@Ab`u#6zLcRS+Y}K)S_74
zZk|9eXEga4kUYy!1&bE22FWf0ouQ2xI*n<+f#H=KDpx2*Zy&Ui4^e_a7YXhkf6$q-
z1N!f8Rgx%3Q=8O<Z5<gM4CMv3CmQ=y|E+m<aOLJRZZkYc^kFO0+449<k@f9#ktrIV
zt7k7spWPBhQCi-|ZTr!JPLrhaFUd;|tBAN2m;J4R@Wn(;@8KV8brs6qZ$9zgdU$`p
z(YEr}7?dN#>G#SrN@;CU4V0Z<%)&ip?>l|QfYA~9%%J#x;iWLisgt~Yp3+PGnt*4o
zUE5+KZzVH{#d{9pS)hie|Ni_3;+Rv<qJN<M|Iq6H8?;Kd@nh-V|3jzpJ3aOu?`|@x
z;L?HGM{LTgOU?|Y<wSx3y%i}aGSYT4S5nDYH4LFbUNb4tMB2_8f5^wnQnEdf!~!(v
zxlIibeB^@xRw0ZI&Dqg*A6pEPFQ!)kzLOk+f4-OOhNiHqD;I${IdMB6BGjU3Nyc)8
zv(x(Ob3NRs$`b{LCdH|Jp}QW_7@xW2$F{QQhF-9TFM|K$?-RM8dm}0?(Wsz7kMu=7
zhWdi1U6VAXgI(qAd(>152LZJ;1oUy5ek_Q|qaxP0R(khnG-7@<#NaCdUFo6ndca0n
zHS+qgkz?&x^1*>}%Xp0IvJVEytr1;;XtT)#1Ayd7FC2J5Pw~&ks$8?@{H>a}mGLRP
z%!F>Vuj1_92RE#CA3yIH?lLZRN%2of*vF#1fTaX1!LoF1`f}43RCF(I`E<c^xqWzA
zq2IeA=xmcQW@L8Pj)WSq$+wDNhutf+X}d~WjSt0JE-y;ESlv*6vB2D(shTWI0Bwu4
z%Y#dul&*TE%IcrhPr5BgfkU6N(O^R+k;XTp?5gy$G#IX3v3=}N762NpA;?*(IP)tS
zg5<}X!$fZxVp5&82nCO!HqRTH*e|VDwmQO=WOZ+8a5GQzGeOC$il8SYMLtX-AI=cE
zjZTiOZjoIr39KTgWp9n1HP3JEtE#JBniLs(g=i<>C(@KYqTL?)1PS^z->!Gq#aIh#
zW|b!hY9aYsG>BP5k7)oc24IP%`l;O^7v7n`#drHbey)un9OtSS{yd1ZF?Q^#Fqml=
zJEX6MIMHjqExzheW9&MlhJ9*E?2?13$xP!Bb~XnLFnU|Lw0RlyenAn<g|QsZqre|u
zGfF|z?%&u`H4E9-+g9yHT{y}QR7#rkAdG^5#*~h=XvU}s9Pxl`N^5+LgKAiAo&9=5
zVr!;8-|lC{3+AnNZ=xLS)T_7g;1%{_NsMh??g-x{(31AFZ?_y(MaPFjKXwdV+t*{-
z=f|c`FuH<P=0vwDK4~>mU5&0B^xyC{W!m=p^dh?yY7qH&lEYyxSD9u8(#lRkaFL!S
z;=$W!U3DfiLu4L5hYc?09q>p}^yM-&(Sikn)5IM}{H*x2n55>o(vt_?5Q^;@v}W0B
z<NPIqPzuhG@h^SN&0Z<%Fc!LFj%;^A9-e`64H^4TDZ{_sovVQc2r&$Vsh+rilP^a~
zp!)f3QwAn_s-7gQWpOBiOpVp=#j=;ks9S8<UN)b~PZZ1^e?y;FM%X{)*L?oPZHE|8
zh1)zMc>M4c$i#Ts9c790ar)zWL5_!t)y~Kai4h^}fsMcoTY9q$Tp7ac4<p{{F_5X7
zDx-aJRf}!UPTUN?6}_V8P=4&|`r7anVd+M?*a0h!g&{Q6zhe9FTx|G<<8OXnxec7Q
zFMoV8PNyOEG@yc;v)_L?xo{G1jZrc&sIx9J*s`;b_p@ZHfz5=;UXEz%V;1$pPe6jw
zm9N5H1Ni=kipQC>^?+Vefd`M7=l`eGp-gk~gLy|>u)qV4-JO#l?NUk|g8^QFq+c$&
zB62C79H$=PE(+WXN!N3#==;e-8_0xTl$nI+*w7D5joFcGHhf+W&087<<FIm!U0|A*
z%xbVOly`o>`(;5hnK21Xs4BKm@+cyzv7_>WBj;S*?=njd>SxG~2l}IJ2>c;<<7TXK
zI6WiS!#^~B>Iw$86}ZY-k!J20^y?xrV>e+LZHc7#wzXB*5K2%8Z-n+HIG9t?1aZEo
z;O}A3wy%dVn=AxmHp&0m2C5dHE3%sWdMaIV)^?5h6@Wr?HzgCii4J!$jDWQgvqAF}
z{Ed=bbN3%`(rf|Cd-VfJ^Wf!#OJ?c!Got7e8xf5?VNoRg!{!FVTuAt2pzf(uqw=>r
zkTjB*yvjy2{5`6uv-@ug$Dfb+fRNp)-zRS%F@o(83FN=UXCRPeBZ)>Skjp>VR9vW=
zaNVkQ_U_Q}?-lp%nND|TmPOSW!Cutqu$|zl?w^m2<@DCOOG?Ub^*)5P^zHJ-QAi$J
z{X>E54K!4Wv+AVpoy1?)VgbWo0{p*+d7I~f6EBlVvop_*aC7>HW+NneUnps9ANe}%
zzh#d)PhG!!WUuoN!y*62UputRZ)^Dx$&+^IU5?SnCe-Ug2rB-GPomccL8Q#3?#&8{
z4ud+!<zf1A|BybJ@bdaNa?i#)C#ujM2fEDK;P4(AZQhzC>@^3EAne@ZN0=!H#63iE
z53vw14}#o#vhURzZ4U1(15&DVSuy?2+0~`y$a=Gswt$#wk$dLq4#)(3^3%95=<3?5
zV)vwy4eXVEjXUdo+Q#h`FjrVw9Aa_HT;C~d2MQ~-Z|LsJk7E^TtLmXwtDSrK25yJe
zX~@2gWTmduz;)B9d5!QE2F`O2P@!}w>+;-J2uiJuL`tX_n>;HQC`Fk?I~ABvNZeny
z$gKfPxvg$w=fXy(YiMHaQ?8!!2O7gaz;N45vP%GJ9V+-VYw=6)U*Y|9sWRWxR@XN!
z)9&vUUm6tZ4H?~WulackBJpH3iTgYf%nA&y-~%Q+U<SVmAZI`AK_^ynO8{ZI81`%6
zK;pEw<Gy*^Nm<W}oDzw;zQB|*pG~XNXGR9f0^(q>oBx^TIh=8rfBX?INzZacCWiAE
z0KeN3NF$~K=8SqZS42+KIPUZKOU|tmBYK;Tz#A?Cf;}`a6l^>eZ*`rcsExu=+^Y#-
z*P4<v6<Fvv&)sUbTPR}*vjG|9JO>I}RK5J_{U%O|K7e3_BqBOX21U9EelHLRj-n!`
zGnH2hv~#jvB<6^7;FM@aP!QALZ#btgeXR~7L(}s%sZ{19yBM*i!UNfPff)+MR%e~9
zszCDS2`=41fDvZ5A=O%w-tt1AVOFe>)T~*p(7VC5Xk`DSMsO}fQ`pR|L*@#9@fJ=<
zpb#$tC&NuSGswtg-V!(*n!X4`4S*x?%r!CRa3D0KIi`h+PMAYK(sh25gW`+8%<wnO
zK~OG?s9zi#5T{NS7`CJyjxsI#$OIeFfxB-#?-E1WGF;a(Xl93N*&xGTfH{LPe*T5A
zgO4|VM7(|o$@fYhD@~`t4B`wr;d!L3Gq#M1XH^KJedM|N<K@yLkb;_}mq?%DQi|sd
zY(;xt%Yj!R>PCd)8TtU?Kcv(B`Dvo6)$;AgbJ&JF5*XhO!@*hL{mn=<(W|@Sj=VvG
zQigF-T&2yZYYfO82v+s<>^BJuz2wImaNW?-VOP$@*Eup7IM+vw^xu<Ki=WgEKUf96
zqv&pR8A8{b5PT-wFK;wAs6}9+b*0_wug?1(;5cwm7jU<Z$xT!_z`qdY5S_8ts1X+2
z8)*8h@UUfRy87ER82KOx<OR%S*OCzSKtJ3=km@W+P08=!>ZL4ZQ84TjKAXXHX4^K`
z$dw}#7Ri5yX#_rj)*6#tosVvvoVqe<T1Pe5?c-^9CZ%8%KQSi8rzak${H~>Vzj7da
ztbagu@n1Oc>T+S1<!b?D2rCD^^8UdO^Zry65|!P&(pJzBwgVPZtRju?`jDS1yAuze
z(*Ki_n!%#hx`XTIsZZgQWBIL}70y(){L|t4zY<*kmDDQsucX%TaLJtc%A_sIn{OxO
zt-nXcNGh{GnO8d`2Z|jn6O#7oaWRGt0SlF2Ot9z%5mp(=g8eJsmhMOtUMg4n;qfxJ
z6s}5Nv4_EJP{Y&sdqq`nz+Lz!s_Q{QqcuU;%9UU7@&u-m=#Y?7lrwRe_sSTBxq0%W
z26Absvt;Ecz6>D^mGP%p6y<q=XTk*Vu4>+1c&Z6cK~4m_K3p*c(&?OHJXjKnkd+C!
z+4)2S>}QZ8yt7E_pI-&TBrG5s>{C9=ns?v5*({+EuWleLAnJs=2f1y`F!}VRvZnWa
zO`H=s-DAYPM~SXP@z5W1mY$dFRTT5lL$&UmWieUf3|ySCrnE#tjXp+R2=6ba*z;So
z_7V~1DKZ+8de$q{Iijc6fFcp`%mXJH?S9?d9Q0fj(nm)>0WGVx1>aaueCG?RsfykU
zwZ44y!d^rElCLjc;1V|NNxLWdtb$!ltIViZva_ZTVDE-~#+W^5a37F=7Se<iH`1gS
zkHJi$nC|y~O8w346I|$al;^u6!~8^xq<$l|POXP9Z|Fw(b1&C2?WB*ed;xdzK5?>M
zxmPvSlSM%JJa+!lD!%ih^+yw6li644>Z8`}V@h$(ZTlk&dv!#}O{qT4h{GwH(TD=g
z7T>RLD?5diEv}zjk%MPGI)|Nn`DYoz7&Q}y5oNUGQ{-pV8mUonoZ4ke5j5(tNhPtQ
z9h*`_tqgB9*Tuy4rC>AU&QU@x9kRQZL7Cs+*KnvNxs`)lPKYMwF%Rud7cc7zFK?b3
zY2#~ns_)lW7M&Aaqi|-VE>+CAPhyc$0<lQrZi0n?!_v;455ph}Q%v1JKi-@i-B;#!
z;|7>D=os8t_)l0Xmaj>``j6%TzofK`Xx4?G@H`!1&X%J5<dM!>S8bl`XwDwAxyp&F
zDnm1~#U2qT3eBNDigGd*<tNrXX&3rF;+e&ol}6EbaVT$~6zbQ4Mw?j?8g`MsI||cf
zAlz@A%ol)U3C0+|=Gr#{GVU4?hzdBQiD+W)-sSY1z%S1{Gd4U=C~bza-&54^Z{&0r
zN$KhgrfkXTc3gzO)Q(v`q0=s;z`S^aL#jkBAVFXo_rapETb-P{znFqnroam5N}49c
zvf=s3PJPj}Ii0qx%+h@NRUw9z1qX(!6@e1!#j>{{QPiwt7VAm%)5x^igROM~TIg%<
z^LL052b!rU-+-i!U@Q7AW+UD5G<P4Sg|FOiMJ13wP_5-LK9u#IE6cka5<(vQnU~|W
z*gF@aH7k*izB%sPm^U;lD*_9P%AGybxFlsxtCv(wfHBShQ!GEkwXZg;yZN;RCHV?s
zt?z~C(@L+Nw<sBf@~k6JcDyei#6QCjsm3`|8Gf>E_cPmJKw`NGz~NOj&3@wt!x~TT
z9w5c9Wgh(+hH1|463(C-UR0!o`z$@KUtL&9>6=BgH&5>R?#QzOC7>(2cy&Yb!HKjX
z&-87{JNPZ9uX~WXgF?so0?f1nWJmlZ+yWB*22#K>UpHSGnmiYrd)0kimGOY9$jZXJ
zbtGi@>IP+Ss;JcyT2D*L+Q`FiNwWQpvP0eI2pn=p2>N5N$}KG2Q`ov;MPlW~NoP%P
z)Z;!*HPpeE`&E&Qn<Hn`X-1;;kT$C`of%G)C&Jb7ZEz|&hRugIl=l??U3?QV{F9vn
z;myXNGbWM3yXZ(QV%Tcw@^wZ<=X9{v_=|lW*Gx?sQyN>q8vk>pmUqpdl#$!s*gr0S
z+nG^h4xwj{WpZU$V{johlU@a~FNMQb`}lPO=zfdzuX8qCochH0=Xi;zj@KJIXGspC
zFdZmg=q6C$)IRZZ1Gjoa%RtHN$hyqpKfzK8V*qbQ$&(}V){rcsLC8P4yMh`$tk#MO
zYOptQ>ytXi$kuSIzCSY?iAEkcDJNMY%+U17sr}`ZF>p@c8$z(>!{1<YO75%!1x6eo
zSd|!W6b<kq_&9`*Ya-WG2d?jOx~3meRq832QDuvUw}-BM_fW(==4lr`_%R=ft2pUL
z<{AZ4Mweejwe=<lMtv+e35ZG*bo3=N?E<Z`(-x4w_x|p<1y7%jbE2u46lAOxBFSXj
zDwcB)4%ud3QUnF+KHq?%qk)e%@p*hS)YrFOoVc+Hdq-$zk|Hm8#R>hjLz!L&FlG2*
z$7JKSwM-~<2Djsv>pwT~kf#G~!b#aKXF3Ar;=Tc&caF5}lO5FK67De!`#KeRLaYva
z7H+N7W*zE)9RcdiN+0!LjDEWr$kSd3!S#z`MxP%O7y0vFVA>FQItUPumRO2_(%E?2
z#nUyneM(!8xj<lP_7F~z@R?#h1=GVNyhL6E<er}msA~NlhUxHDoEj5yBbE7PpDcmS
zn95`Y(!h`RxlJJGg9<CNedkme5Ll-hqcC$!;rx|s*GXAT0mmyMWqLw;qHLgkNxn#)
z4FB><ElcQmwGJlXV)U>|$MW-PsZj%YzJ0!S^|4S;w8^*nr`<&3)?UG7IV>7|=v+c2
z7+2tzN4_3q?Bru2j{8|N)w(t<)lmc#io&#4L2P7&3^VWhrgSx6?-%5puSS^5hh=XF
zul4HnfZ;BSoHr`bqGRDe^BxVjeHH!@a^yQrV|>t;g2O5Gk)<*V29p&ANu`EgU=|Ql
z&Z(IMnOTy5=_Sly&!%TjeD?s-li06;ZqN|CYTf$?R;*E;x4NID=#v9@B$Ad~sZSlg
z;}3Z02?ASdQnMpAp#t1;e<mXkZW%a_#(eb>2ItnD<s%TmtHs!_6Oyf|08;%bN-S+p
z<OyzuZZMQDFRx7;t`4^?pk-G-a_*v);JtLpY+`gbd}QrB<BjZ^iCxjP6E(u#d!nqx
zU*9ci;VuN>AUuX}5-D6j1&!>blpe}R85uTYYUjVVQfGz4IAd4PnDq`&dr*vMhMjt*
zbe-z3r{9lbK$P-f?fL6(eN=^&4rqkb<Yxl#bXaYie{DcnCW4k^l?_%vF>WqSMmNlh
zj<g4}!si=~(-agBr+!mZs#@<%+4qNJSKXUIR%O(Pu=Fl_zTI%{jLFmkYk(R{m&#K9
zZfXn1XK$gAgg(_KXliPVvvfjywrpgB3D!&KoMu$mWmkBn@3gbl?tryqX=mM6-w-vt
zqLa;H)Sj2g=1TC*`8C7SmTH7{WXU-R?e1#9V%SOHV^e$9mNxHO9-?t3*ovxefHAF5
z_54kpcFtCKLcC36Zkl<)<NLtlr(2~|qL}O7&yeY9FH`i)My*a@))9r<qL}~|9aFJN
zN*y0tp&tqnvHh5Qwoc4L5*p=>vV3W4uoZU+yBt=Bn3|gRk7gwmsf%=Bz_^SF=t-`D
zaZJ0?A~<DclwvwETM#;R%6!hOQ!58Ncb+V&C<Y|jbvvj-h^{Y8MSnt*0I)FVPo$E#
zG)2@FDMl{Z)f>ohLGfvC-_RWAos(}=2~bIMT;3Oc8BHj!yMeB7k>eHbx*Rha_S53O
ztr>{aq4i`Cw+*}lAf6y#I(s3|5|($<zl|Ql?UiUPYb$%0wEw69JWn}8(mu`AZ3sM0
zOOWiv%-;}|vMWBd)8*?betlXiu;7pSjpJM=(*V4~(v@jv8(4*B$f@lsNVsRda{&V8
zL-B>%zyBDvbRjY|RYnLtVV$m^%<d>4)NWhQub!)Y62t;t*EN#mA?A|C{UfdvfZN9_
zV)XHGM}GXU{707WGZlqg`sQM_vG*R0a?*hb<q3gbE{wuT0gdoq!2M|ZatkS$&x;+n
zJ(0;kBo4qQtB%U>FUb))mK9`Vl|i1Lhwkkc93cDe{UE|jfS*h6JnUcJRld(@PS{JS
zyXW6dQ_=pt=fSqObSl$74k!a5&fi-k1|>KAJHwrn?%#f?<bRUkr~i`-U-zF=%O%^(
zue$uflvV%P_W^4%ol770=0y^M_GW)9ZS?eSS(BluH&g)o#!C_g?XOS%-*od|uE<&`
zhAmTyXFYPdtvu_4_x4J2%)U*<aPCZhPg_0u4ga59_}f@kKH5@l#0-}zP-On1>XMyJ
z^hAljJXwbhGTE+azuUh2q$~Yc`NIDxcq2<K=QT?Qt<V4-%t9|+GP33+6Rs772{(_z
z>aWJ^aP%WNhB55h58d@#v>HD}$0}-dy8YRun58XN{O(QDnL~LwW#KfcKEE@W#@;-z
z)t!c?U;Kh0?tqRCKC%P;3l7lA6w*3I&^WxPh*kIiVwF$k<6LZT)}bd)3K?16FNPvq
zl@n89tS``MrNfYfA2Y4Go-!a`!2sS^2;0SU#1tbzN5|g7^Un%s037J;j-z<v_Zl1A
zdw6Z=ZY*3%nsMTjW2u(B1K+rDwdqJhF1$vDC*~91OExW6{KBXH_Z!`GY&sF`;5b=v
zTa|@+BNjZS^b2NLH!y0xHIU<^MFrH43W&qyV$hZwl`5yt{oi-408|s7>Y&>@ztujA
z(@b?vM;o6%(WfH=2cwW%d0c{Dol<8ZSSiS}t8H%1z1){!*Hjy2g$csz&DVyc{*?yh
zdW-8HJS5>RC)p{*`A7aH_Gq}!Q%X8LCvI(Gp~`+8(j@$7D6iJm7ViIpvUiNGWKrLJ
zW2cku*qu(tw$ZU|+s=$_C*84a+qT`YZJTHIUTf|BzxVEY&NyS_OJ-`+tQu7*{N4wI
zL(}YVDaM@nTVKPx&)`<|a4g<!P_RTin~p71y@s6{RIp{FQ9`lF?3wLe+8#4$6h(EI
z>LU1JV`~yoaUYoFJ=?JyzHCTKt@!NCpD3t3_*c>!KzZ12&jNQlc21f#^}WysaV4cn
z3(z5P<4Om=#s%K?%<x`>=-xA&cXpI>Ktv?$83R$O!2cuBx~~bjE2O$2WucXF32)Ap
zN@*Zf4Tf+c41Lk>MF&yQW`)n}HE5v87Ch3NC;m)JaY?+;bw@*gjY6=7Gs<aL-<%t#
zionsqVEk%J2Pt6j?O4td@eWlhA4K?A!kujOOr$)5HBRK^XkkXJtuKt(GeGI|X4CDH
zc;->od&+KSXHo*W9;;5Sfk6KTg8>xR(hX>|BeBFyNZ1BO*CAP=t`UV=7}?a5tE-B>
zjuGld)Y{lctpS!(h7fGSf?N!ajG67+){&HH;#3cy(mp2E=-bJ_m*cjrt#b5f<aH(K
z>sqNKhFbD6Yog1oP3N^ZBlMZexYQayOUY!lU6ndyHsqcgzBUb()}JX+Q&mR7_jR&r
zX;R9@ZCn=_dVc+qy1J$rA)SFE+qg9hQik4zG3ef}j~5ob$!emb9Ra}75qi%-DO24x
z&)k`PIys=uhXTHaj(x?YwKw!=01Av$1uvDvTkCLagf>9bZOa>e%G;IZUXPmqZl2Se
zys-dLT4;15)s`pq=V4o+@97w}$CYB-VJrSIF1ul}q~RV%u{)tMLCGWsJ+<{$TdIIo
zUC<|~?ni{&xn^*}RY;OFJlKT?Pij<S;4^Ojhj&+S>9@>NNfb3!b~6`pF6JW(11)Ht
zTloaFkXC2Y>#1jc$x$v?JZ9`SFIFQ+wdxZ=qtU5XkinknJsqo_xOAB%j*nr*3|$2t
z5)nMaQTw5hvOLbif=ishCU<7A(i(d9@8hrG-9GI#VL7F@WJFHXrqu@ATkj%rsF+hh
z6TU>Ba}GsYU3QrRw2ywYSHy*xA(!#RKv6A3(bMehTL9`_>C)kiyHGm0#?&t|d3$3b
z1y*DZJ@KBA+7!J=Q_D&n$jW%~bH11yvi%gZ^TPJU;}*aOKzeIC%?xZmG>;3QjC<xs
zG@8WC@A^G#(aKrW$rW%in7Yk+ioD$B7vGACi^FkbSv*ihYkSQZvTZ@t>)6HLe!#4K
zVm>h68Jgnwo(-q_Rd5o&$x{n@rExCivy+1B3Y-%T#p3B%-Wv_KuZWh*r@q1qtL&PF
z;JQ}zrFU`Yy9B!P7tP0LDcxD<9Eg?1saXAki;8GRYO{+L^3o%IJErP(6HXj!a2rRg
zb7yAJMup39x>o1F9r%!{6@s256(4q^S5I(cHv!_C_fHM1oI@j&UG{x4GOrze0$xrJ
z*j3&uT+;+HF!WM_pGs_tx9YS}iE~4i#b5f|RO&#^UseOCBLVMjq-RP{ein&4UJAXo
zCY&}OE%+yvj7qfcybT*RdSe`{{gS?Gd_$cthV2CR7s7AGpbdacRi7Yt6%=(vi5E&v
zGac)%i%ot~7t&5LlA9cK8K7t%8Dx!RXNE6~7FF+)B<9MFgN;OfHow>Ea7XgrpVBQi
zWW%gQ5FKHEWZhf;%ypFlSZer>%S#+^rYjnesS>!wH*)XIwiQZ9hN1$WE{h>D?vTU$
zoQ7mp8tC?IR<I;tazDs^p}Z`)skHglW+6Q2f|JVex9iQk3mYk@@hqvB{Msq%zOlak
zq%YRuv)3KNq+OOOv*lPwI<ppc$NJ}NiG$bYrsQ2oFf8U9d_Ia6zU(ZqzYA05$SCW#
zw}p?tThEjEC1spaphrbBa4C$zeU(r@RFMdK7*5vUlW^(N%%s7M_c0^c{5!;}0_z2j
zCBl=CU&O~3WIeG*wIrpuCYfGaFSn!uRbpgw6)s`#%+k9JedQbXb0AB?nk5M~9Adp`
zJ|<a5CHf1RaKyYkMFRHpOn9-5^<djjM7<?evv`OtCSUKznDRG?lj6?betH>LFJbCo
z_4saHyd(KGUnN%_B$FgbBsYd~cB|>;2^Qq@2sAT--`mvZ*~&3zB2`CIiYHG7Phhk3
zx)N*%+g1oDFM>gxpb-~O_pctL(wgfsO1KyY0C;26S&uEb5KjHy5)L!g0%+=gx$ot9
z%M%L9Pfsx+q6Ui9*PDNy6Q$TER*pD=q9VR4^R5dkbp&b}8Auy$)f`acP%$efm{-m)
z{aSY-y(oNDdXsLfFnxxir~%}ormxj_H(cNe8Yji7Iol^#`Os|D*38Lt$u&hDW_hW#
zu$s^VvHDq$nb_nl10h!_-;OVw=|(>oT6rPvovV!&_)9eR7SXZj)Fq1BM<uHUo$a5(
z>eDhkHo{zg;p0^&+^B(!P{kchW715p<2AhC3@d4&YPW;TZZovdR1_TH?@WC!hGL+?
zQk6(GeW;W7Gzw@)NpbNv=ba`(Uf&ZLEiGJ|761LJt*J!wDu!MAeGM}qTE=4}0_(Dm
z`^e)pG|cAW159`H^^1%W5+tSA?^*`Y*(rGhwt35})e;bNYyywyE-miUC^p+6)#h48
z5Gtx1mud7Cr;@mYas7v=uR*C6^pu{sGEEOEx5a{)>XEgSd}KM@KEi-5KNb){r8y#~
zF)Uc#zA8q(AKukLCg~^_8OX;XKInl@;RZK@g@nX<QEG5`$D(+zE0T~x(;?jX8pO9=
zsE#^VYMr90kx=u!*bxAWpZZ-_hnropkwcwU*?MPdP47;ecME~87oLbacnJZ62!}&e
zn4#A2+4|vk1!WiA8!FOQ1YQ!C@;JW}Wpp<XtYyUYlW%wTHEg+SQ#XBn4Ru0^jh0Ho
zTm~R#BEgMF5<4LhDKkQ1JCL~(u9LB?OayJ%bn&b=SJuj1y_L@?9-xd=$GQv92ua{A
zib$nk7EZLcfvn_9d)1SQPuF|7@f*XX7`(x6d2h(nvGQ%PvLaGj^9iVNh~I2hwJ<lF
z&q;`2>v8=$>2g7hQ-l3zT^-{GEAq^Gn{*H0ft&hik+Zdnik-49X=wXIPNa<&Ac~y*
zvIPaEQ<;B9k8?x-dBtRvW1Slqg_f{*6)PuxGCvdRpjt7PeeO6@E0KTul4Yjb(HKf%
zQU<I{v8Ap&sMy^D#{9Wo<N1nVR5j^DT`qV#f<B;Y_VB9YJ3I)-cfLX{Uog@EvDq+A
z8OWHlP_W;*1T60@7ts+!hzE>lm%WoTZZInNed@U7^1KwAjEKsV=#|VE-$s>KuZ)WP
zl9A!~fQ~|)D8{I3$Jw3UY(yFo9CG&yAC{Fkb*hf#V3|q?fUWuJsg}z5b=%-?a(Trf
z!MmKx7KDVrOrt4qmtm>giJJA!!Cfnye3A#ifiz}q)j^ECm-d-UgB!a_jR-wWRXDnV
z17^rBwzI|#;g~I|Q|-j_!O$b-PqO-4@WLSZutQRfW*Qu%V=v=ai_c2~$T`X$oUc=e
zd~6ngg~J*mdJ<4~K%Zg~>&)%WTr;^b+%-bn6L`_GHUGY53RLL~sH}BSer-3;EBmh&
zCSjK89}fy1cx=BxY^&1;yo>u&T&U&c#Uwzn2+2qcI}^)WZ{s@T13mG5k_TGoo_LqT
zKD0-NA|c3yBW}7k2z*hw#VN=fzD#5+!8co044ee#e&0c~n8^<SExUV9js)JlfrR-|
zG2Zw71woU|0SYJ9YHXw!fMrN?O8OWafSw^h;dwYc`t?<ek&1f2J`4WAK%0MG|Flrc
zB?n>y=2yZ&$l6bE4*-DdLKVY3NA*!A_tyDS01Q;Ox_p=#0X#>vH&ZBK8o3!J0^Am_
zkZ8I|7xG8mxRii5R3#DzPttXQexFM-|6_XJk2g6te?ruq&7E4r#p`hh&s3ME4f$$}
zBpGSe{SK^1o<u(jC6ANF8uzG3FfnM9ZHHmgTD{eaUL5a{pd40RRntB;R%X2tRf@y{
z#NW8fp#kcK|BX=+jfIfN9;BSH%-p}?syHJ%tWT+8@4NyYbHxGYvTNo^slv-bv6fi)
zm6GJOvLQLdQ370c=29iu#9VV??!0~P$?)`f{tO#FSGjM3bpiI15=3X;(r-&bLOGq%
z$VRGAe;6fzsmFCcR6)<9%P*p0rs(nsal<?_aqD)qks;otYfG<xHuEg{4Ed%KbF(xc
zhE)YpwlY5%%T17_$>tAlGT^2>PrQ;8KZ|J>rw(gV*4<7S&@vhAo}QT7pfM!Xq3ifO
zjbR&JPq1-Mm(b()84CZHZcIX8tr=}H1Nld1a7%D|05lU5qG+|Ors3DiJe&<sL~87U
z7qN?}teZFh!Vz{Wr~2gu;^#wv+yekviqmU3g+w@b?dYr30?}OEGc2Ag?9*x-n&Kz!
zy?rL^X@9*rAlvjs_BBzNZ4e2jo&+OXJh%PXFxx+Z;a3!_=!aKocg7&=b}+?hj^GNJ
zv~f7Vx+2{@d>d?cKVEc;x>$Y-4K_AH{u4k)$WvKSl+^&yh7`B8jt`7ulsuFouuA{I
z<f-1)&Wu>g9x2-hz0s=24@z4>`UM}@zkV~%SZZf=k8-R43+>VNyYMFu>-q^jCmP;c
z+k<e3tzfEZy1OeVOFO{^j<Nkskh$l7BbIovl3fIqk`CxG?41M~H`+j02jSdg=a}*3
zCt?wRnR(NbQSx!zTJxlZEyDpG5(5<LlX#`V(lsC6I%{vyi@ys2S+=c~?k!XvDxNsS
zZ9B?Wz*mkpon3Mg8#$VW+pifwe>n6v!TTpWo73$>M@ZG3t01G$z(d;ACZ_<|m!3z~
z)=T_4S!CYmGUqt`#T|Vkcc065<PH*6ZgKj?)t_nE4#59NV)0WcvEz(*i02q%_2{w!
zJtbHxIlO^3ICTOV@t%qLBhldUsUVsxyKv84Zu4?=nLF==>f#&->NUTe3b?Sg%3M6q
zeP7onw|U&+UZpglNc}#iQb>o9&He$=r`)^O!4fG&FB^C>6;xR-XYv#oBKrgtn11!i
zS?j<cQf2uX`Y`K^`0W=QyNFv!fDb5|jU$h?4=UsvKRhJj+1!8*U#_OYq;aF4g(vY-
zBzB9Casqcpa!KhIilkdGxC+P5%{iNf9E*bY<E8-DW>w<{eX4&Q@lL=Z{(08hi8V{T
z;x;>SV0c7QBI@ihc{HmsnQ9`dy!uL)creBcHR^#HeH(#}pd0ykw1}&rC-}tpn<)lX
z^;)wpv(ObMS$d?AvvvNy9O>vsVS4(5#z2LG35o=KZK~PJ!m7)$#Hx@}$_ln!xmE5p
z3&vrD>P3-Bq-RZe?~W$4aVoiIQ%WPg{T5YF9VHx@x;{w~8-S!=@@kyJ4WBA|E6Z;y
z2#$q|E2+h}t2!IcsysZw9o`I6v^PyfTp`{u0v{c`e?q@SxxDXbqaNTCXMpRdeifLd
zT4ZGwR3N3et|<a20CkXtEJtFOX4$7`aAV;;?5Up+dk4A>zu}DH>j)fey4Dq?DL=?5
zv;3BAk|sI}13T6@u1@~}HDqEoFi7BSFKnardOIt_Znq6F7=^b(sncvY0;m5EWMdr2
z6osL;bJyDaz{K`eh*om@R{|t`|0jZXpQTz8Mu&Y#<FO>W<p;4fAS7dpt|Qx82hsW{
zgwHS1^7~gOYZ`_aW028#A}Il9zK;DCYMdYpC|_n`3qe_*vmB(<!^r5jKW=e5ukTXg
zi&3n(Ozn%41Rt+|h?TfX5#<xbM$5H?g7QD!?q+6fan+fB8?<RNuD}xV{*B8*6#nC>
zR{yu5JLW%z?!5mPy3PK_qOoooJHFu11tqxufVeDnhXJqX?L4pq*PDGQW2e8Z<ru45
zy#x_Y?Ro#?WB#Al{a-hOxp)v;CLhm6*lc}%(i{Kzv234JyQJ#)zVf=9a?mTP_AigQ
z{<CNbeu5HS@C1h{C=9`z>Tf$+IEjB}RmK3bDtX=XXGR|@he#D<zx=h4f;FNkK6{p0
z&P%5^S^=?hh2nJ7s$G5xyor08ZZ{r@*3Y2;Hj(vAc=W2x8q4E*kav!nii%!dI!H>c
z-R|VSsG0>6^fK8nRkqc~63th?&f<tyOBA&UmL8NOqQ$uA;vR`xOO<546*<OJR(hj7
zS=FN+XTETm&;2T?0$v6nR%67lgfYt<=y0U!DtOnMOvH1OK%V#B5rpn-sDA<kTi5A*
z&ufDBQqsrE{wPI_Odh-pksj%)RX&i(@c;rGn>SEw^wgrO{&yVp#OPwnIF8!Jz?gm`
zmrs(GKz(T3Kgcg=_QK&Cs5%Aw@C3uJ_>;VBMy}TuPUJq%*`o((M0aVONOap@-pQ~g
zgAkKTH($*Ls?s7?5<QX~c^|Q<IX}(5>VG`Zd<x=RaV<A}v|7Gm#m_ceqe3@HE993l
zc<w<wZF@I8g*dg^Ifw3L%P{Nl`b?)l=tzUi)@k%wX6D68nHes7X$l>M03M`3iupfz
zoi$u`?d)!Oe+-!5!;ZT?GxHwynO3B#$;ptax_Gg^AUmrC2LJb5RPd<5%mOa(sc*N|
z4z(>U2yH9HDN}bc-5xTWCm%nMOa<S^{ZFPD%;V1LIAuzYg2qkUO-VT~!nNFqI#qup
zZ-`rj`vZKEi!lpov>4aIc4)x&9TeN)KBIJZHUtG>_~EAKW|=i8V1p`gF~?gfQJCH@
z%JOTNy11}cG_ROxGPvADe))f*LcmB#9kP`aeh(i5!Tc<XZu8x<;{4mD#aI$(X4>Pe
z2L`Ee!>6~ZF#50yR#5rG27QT)sH`J_!ojTYOddHrIF8$!2+Y{02#&#=kMb|+Hoetz
ze(ZZ(Xy1tA>jH%%$U%f7#zkBy7lc%@@GUa@2rJWOZWNga`<`;LBv|z|VRZYFrUP0U
ze^#7-Rl-ULrQX^GM8F$#huY~8MS3G_ukH&tCS<O&#j<6t+g`V1X_ooKh(Gfa4TxDy
zk^#_hA0#c^1K8XLr)ktA%T2)VbFHn**m+)0)~(wvl8WD@&>EV%(8ig9u8TdoMb2Wr
z0YIj`p6dbVwAK1j1fEh`pD;AgIPaf2$cOvbR0@p57snS47iF&+fx8c!tace_i7f{@
z7KLYC(96Ce$v3BKh`_eXiVR1pB{4XVsr`;jnR3Kln&mgLV^ISVLbl_}Huw8s@z37y
z@%`+EMkzz@(tA~L!T%v-*pdSOFZ5WgkRKIzSz#aJT@O3^`-x4(6}EpC3oLTUuo5oo
zu0fVfe!;3TwZ{f^`}{Xd*~q}IsQ})qw8D}4$@c?ul!8-!b8Q&nI3n@OrIg3_(SoX$
zz^-7EDg_!A{W*)G;2a-e=lamJ`l||BZ#*^D`K=?&w}((D^&+aFfw*KTufWs<=<DH<
zJ4E!fO9@0an~@$=8AdaA#^h2(Lcxg7Hy)68y1P`f0%#E%qQN2J8>o4}m{pG^itFKt
zh~NFpDB`T(P>OBwz<GcMj9K6D(ilS<Y3T<2@g(e=H-E&~ztNu~HLjwZV<=)1T*3*%
z)Vg={<>r;+cYahnGmPl!6aj5bD>+;wns8QrlFB>;)e1ZV%@N>{Fn!YFz!>u(^>R(B
zU+47>BIab=N^FDZJnE{x^hn%wpgA7Ip_6}`Ob5J=eWK;|dttqjFvO@FzxhWCU;`gt
z&z-mSd*oh)qo^^!ZsVYbS6li9rVhw<e*?1FQWn>1(-DCo*ewXo{2+PlIJ>6WD0nOL
zx~YiS<CLn+65Z9=u@edA2rpm(!a$|vp;s2d!i%vvH|NrmB=x>Fh7l3~1+)yQeV`Oc
zO^%`D(Bs8wxzk--MM0Q4{Q@8#pRMb8sI-2MP%mx{O53WCSpD=Qt$s1LrE_9TH=)95
zUgUuvmdd%*T%PP_pi!)brg0G9ftt-*lGQ27di?<1dKq#5BG{s)RvXx1;mtqT@G0d~
z&drGg!m-_|OckxmRtK8Xd+o=YlBZ>fdZdg#I$?|^1ar<Wr|R>vS%DWMVZKC`C#Lu!
zf(0!~*s=10yZCfK#W3-;Ay)ik$<BC)HxMfHG+Qpp2D%0yVl}?wmcFBGTjn2&au?)e
z*i$R!OlO~%e8_zxy|2Bia3QkzfpxC8Gm`T-Uq97YmvKxP%Nxph1eO3TG2>Eg%@eqg
z?sem!FuyT%-3ySX3ArnKwOn~3Xk?(E_HowWZHV#9n}B`QOftxwSBj$U4RJMt?B9r}
z@y>(;2I((}8=7(7HLBB%F&gN|NmS1ZOkPah`eko<4+wZ`Q(L4dBOD2r8I8{!-0j>U
zAkwLn?Y-{4D368T9zub+=)f5in-`2254Z$ImbA<)E=K=4y{YNX6z*SkJH>)RP+2Vg
zFoQIEF9)1K%cB~TgVf6IlaUco0a3IuC|RxSmt%r{b*UTPWqMi$gVq<PvQtu^GS1H>
z16Hry1~FfmC`gE<M43%=?S>Kz1r{zU@Tz<zz(yLhkqRrnC)FU=t#1SR8>e@aw-fyx
z5}KZxVV}Ibj8%u%AylD`kP><g+h7FYTEyF+6jS9R`q2zOx!^T+$QQS*&&z&Lr>vP;
zK|gkZE`-TIdW<E~wQHQEYBbs?Rc^*fpK0a(pqDX-%o}9fdYWk%ZY8ntD1f;Jc6B6x
zFjMr6UHFZ(Ppvfvq?O0VB$q%5+)4*XVZ3reG2Ruyu@Vr<@}=tB)r&hA_%)=)hoOZ9
zADZks_3|4=IH(8GNdEU+Y<RU64EgROji%fO(KWY@BfK~^Cd_(b(;F2PvTg@E>x&z2
zSW9I@na+2~O5eLGC=>gzPXT|yDfA#OIXo<MqG>BaMa!$2?^MhsIr#Lt6QWHsk#+-S
zTMsZNRH|RxcWD}RlWPMXda$X|1mkna1oq@n<B|ubp?rw+dOSaaAsHIDea)r<H-0AS
z5)Hlx)}~-=)t^nDlASr5<I#?`suS>>+kl?qz3*nVmN9LP@SM~|N~(`Lwn?aN$@;0Y
zhxRkoq;RuUhzK26N`sFWVD^#$i_`^+XcdJu*qd71Zk%(MAZ)9}Q*c-9Z9xi9?dbHq
zbC&V?F3yGuc5|lsB`l|N#BXaFd5cIFi`<B0PFRYMczh|;V47@&PWuhkVBVWQjk%xy
zF86nUx2D*H1NKP1vUnwH?(K0<MKo4^oi!e|oO!c+aLa<&Bu%`$NdUDJH&xq3Vl_0D
zl)rFS9=z%*t;pj^XN!+JJk3^S=}fbG?ugDi*x3VCl52N_+2=C8fQ-x+G3wJU4!oZE
z$<jwy)4!>b9gBqbeq&qhL=7g<er6QcUWmyqdwU(CsVTWI?)i9}H_?`^RI<=<e(qRq
z?JTCZxT@g_+=vram7yd}0OlQ&+*n*=r|^|FFZcTzfLq?LwLRsYdXK2U1USv>@e%(1
zMQHkD8u8v3p#$40=T0RIbTId-FrfWH&(#xVC*I_`jt}x?4fqKje9e(I#<YzpourWV
z+nAc|u|1S-*|HKR*#0-1Yz)mhG-p}Iei#h~?Kg5f@@?E1Ed`;MbNd_-rnqp&0D{p$
zPF{yw{9#n0fv3%jXymnKNEsW5vn?EYZrl&;*{S(;(S*v3GYyGBkE#BrpZ`1c8$qr8
zj2G?t29DjTG0z6^lfHyludXc22RZ*S7kJPksg?CIxr{^VP)!6TtqM#hqeqpS4PAgf
zQ<R7PNd)HITfhfXH7G{d6+?swf53a(<=}&V01tz0@)hn{`bi|FBgIzl$ncv%lF3)<
ztARa5e;HT}(>`^jXn~vU^Q0jhJ!um<nt)69>h3ZSQ&ZRn<l_pKRocL5Eu%t!5DMOh
zd^G!E_Q_hUdOEWHcaav=r?W4sodnOZ^OZBvpVk6azCmSvG45-sOF71kr#_j~rNRY%
z1EYRh&yTZqV?Ug=$3oq<l&kB&sTXB_Zt!2c5OR0M5xEGW%4K^@t*L4T(N#y;QV=3x
zRucv9sQMK7z_?V7xae0Gr(1(@9PtadzcgfPNPlU_j;8m@^<K_ZmYzl?9!<cbo`BN~
zJj)L?yBSEzpLxJUzZR>vKhxEbK*lCp<1!N?Erw_{b}^zy4-CChe|;=V?~J1=PQ1J`
zw}2F7-fVCR!c5?pRGiB*cRcqqH>NOm)+f*B9Mk_!aSE+=mHSYE8Zjs^nU*WOsi_>j
zmdx8IU;y?n{}~*`hBBv}jl!J!XIt*Jz;_%9lK0J^{{cn3E+oUyM2eF)4Jd7`kh1Rs
zVY!sVwjR`jGME?=mXu2_YQK2RNIj@=mC0l}!#5ORs3@>@d+Pb6)2wm^XHdkIv<Ev|
zfuG|M&hf-=PAn|RaF{XBNrn{XHpaY+=K`$kw^ndSa4%;ry<0YeG=|#ASVE62vW*4>
zaY$}a*HnDzH;rdA7MIHIoMx}%yn8?+wpxLgoEBSNJe%)fP*-ISX-g;w&=R!(tbWoq
zCML%}T<Jwab?Hlw{4u7d<d!5PB=>zVHhEOTbQQgen<vN8vjWga8Uoyr^XsWge{8o7
zWhtv^S$O|{_)cGx)Q2&~x<5LQ<I-vHQVp@>73NBS?&*UEH4i5P((6Fs``pwsPM>sB
z@_hS+-YnPb6rol~VgChQpxbI<V*G&Wh+w*njSz!6lNh8Tm(rWz;c={Iwp9pdzUG3A
zacj<HhxpwCbory-wp<;_%ca5>Z*+g;My32fxzSLI8D!^7<lQ?echtU9$pNIP?QX2j
zF$utx`)pju#Fh$+%n3brrT&XayE8u)?EZ-I^5`sVnL~_@EPrpQS=>jRM-RBxolrfM
z#6zvwjau89wvOOU5ZtZrZ?<rWq8oD6N<6ocpVmj%>KBY(G!MRi6nIc@%boIC<N(%_
zB+&TNK7;3<BgP$rmC*o|kTrpqd-ZiKP$wB=?X7K=cX!gS+=%cJ#nf__6&6HHAk*uK
zOV6*?Jt*bhQQ^@(R3&fOG1hrDWq(#+w6*b=8_Z$?Sg?W5cuSqICO>$HBU`7}ev4Zy
zK@1FP8s@$ieyTG$v4xhVeKkChA)Hv|Lv}WUjhE88)#(hHpze+4>{p)LhaL}@XCLk?
z{u$pnU443mID7xhzOxg}%bwdv<Mn)0n8s%3XD}Fb6<?{zU<64YcPBk;Kj-9{--bLp
z0s{NAC)b9yR5y0A`8#;`?N4@FA4WG2HPE@=TN+QK4M$)xO26<F|H;qGbRc*xBB$v+
zgHM;NwSdR0!Wep_{qyGE_kCQUXWz?}B>24(Wk-fB=vIOzEoTM>=qbfmD(ZNk23AIs
ztzrlz1J!HOjIO99e;5PLMGOhC<zT8@iuUP2wD<cT5Rp$g7w-{oqxF<eP8s_bh}d4m
zrX{8_`=|Az4<kB4@9!WvNsa$XIQ~0m`Ol*BdD^(Hn_a%e6v2Og1-$7*TJ=UQTd|MP
zdYfx(vesWZq$^10$4h7fFWP@ZT_OKJ5a&PZ{_ng;>bQD9!R*hjHs0N22J`TgK1C){
zl(oE-dYp_@Xa3V0o5T}S5NxD0m|gox8KeiAS=kXct>+8uUu<QfF%MStIXWZhmf;<k
z5cY>={p%0EsDLbnU1LFu<pp>-Y%)cbv4Uk+Bau`&P-vJB=CJL6XZD1|uBBIU3C(!!
z&w#379KG~%;SoopT=0X058_E)+D&XeTrW(|1oKpe@@ukTkehd1re&xxWi?8EYPy&1
zZxN{TFzK#(vmTikRJ$N#Qcb&>Us&NE-e%x}24QL`mD(*sl>D(pLc18pdtL3-@anjm
zHh!H$*jAdhYm!Q5WE^`@mTM(rSRzhb5dKH-kucTZ4K@qZA93Ba;lS*WkCKc|^P7VG
z-Y#}5A?M7j5vI*HFlhxfICNA<QVU`QL;j2H_)NN<Q5WR?17M(D3)dxt!Ri#zW73Vj
zQ7(uHn7BOBb7gH?P=x>91MdEOoGow5g3!BBZ)IV1bZF1~rAe)oiK#j?)gQ@Ky5o)7
z(}USTE18|#tA)zur_|!N&XuKenjk!8DsKvQZx4F*u=<3FjP%pfrD16q#;7G8<pkEv
zR8wTfA%Di&p9!7<-f&FD2G752mbKaH@tBjWEx+1M_yK_3)MwS6>$S1c&g4P7P2{C_
zInsvr0LrLV>+T$0l|2at;5?Zzh0w3D0YRnm*EJ$gtS~SB7L)7Zr5bcH{wT-ZV@KI%
zD+d-`(S_DfwO>s!hQb9CPh9^;NWtmd9xI&)ZX^S4RO+FC(HAW$GB6`AeiLEhQUPN}
zBXn8m7~>!SOPP88ZPEEQ?gb1@Mv7RY9xR1By>7jf^zzbP(;cdC2F6NLdYlF?|6H1b
zz&Y!*NbhN1_Vk3(;>hLA`IY8sb~fbf8+Zfpz@(D`sp&ElRik$1NDF~SBo^alEJ|j^
z#daUUUxKNJc?CfH=iKtJXL+KnwfE39$<QOC2K=3G2B!}3k=L2b@*X+i<veD<aaLS7
zM#k#JK5;(NTV33oPw;u@D&Gke+c|kpnjv28K|~H`ZEBS$l9sO;>W2c+r&6q)Z}1Hx
z#^zQO>j!VMEI-jRsp}nxnQ8fs48~FOGrJ?g@OOalB~W<Gb<gsVl=IO`dXoKIjCD6&
zp=CFGCXBEkc*iu6s$l*GyVHV(&-r+vea&TqUg4~y$0-o&#5vWhO)2*z(8Y%rx$h+=
z%(EX`JTZx$mb~!E3+I@&ts1Hy6|!AB+UtBOnAHu21|aLvZ_-hX!axn4kXkuioxN?7
zOb-sc(fJIv#Oy)Ig=<ZroFk(O`GQK(+#W2Gn^6V+wt|47wV$>gVQ?tYR1(l@2nFT?
ze15;@^xz%&R@&lT#C#z@YoxX`_eA=5GR|Va!Y_!2Ad?HRVnH@M9+p2J*L;Z=LM`Dr
zA8KX??rQ*4O~DU2a|`rtL$YN?W?5DC8B*lBSAG4PfiV4YjExOS3~KT8mwHOVb!4I%
zC8Vs4IsZIETKBfrL;*KE!PGxPHUAWfaPRYYGSpK2Nk#;ZnAKQsWGvfI$(bKJSGXuQ
zsHgwW#bZ-*MZl$R%eeZMLcx($JrnxCNNw&ZxFft{nqSI}g+u|JeRTB^MP`Y<!G@ov
zGa|64=!4Ps4p9OUtGoKq4&Yb@zt(K-A})Tbh2$88TO(Ob^VovH-#dbR)d-ZS2`CqY
zo?a-<#8hQ>7kJbpFmF~wyrHYHCZu(gr-(18ld`J-uN)Zi4#(FIf6Lm?*`qkPE(SXB
zjxaymK$QaFNfpmyjVZ`*^FL&_Kh5Y>o@Bjg!@m{cH%fKGp0dWX1j8P<(VmYyUTDgS
zji$n$?GN?{+zdv`iRGtf)UmEnd9#H)b&t>KI4oPuW64D%V}>AOap4ZKP54<j42d76
zN43cYkuM0@Ub49@NO{eRn)Mat1x0C)@-t2G8~t!9)2_6gz2@UltM3rADn;(as!~yw
z1H|JS<sCfX1NoA01nG_?<ftQ-=|!iA3&^9W5Vw98o%bQ`oK`*N%`fEaj?W3KK$`}l
zUUPZU?x~L0jL+UO{XqVzM`Tn2L4iXzg3ESdu-eJnjfrZFU7jl0kOc9iB~_s|=Wd~u
z2IfuUnV36>2an(tbHWyfZua^OcBLb;!O4c;cuN5K7HE8zcY)kmO?u%4L)2v>RhbhG
zgqOruF9I~gHfdWY8pwIr205hL*$t$YIaS0jUJWrd4P?!T>8Bp~@z<4)YHH`-kRf~1
z&)VKj+{$Xl726*_7CWwKu$?=lUYzg9{;0cG%2AJe3_!8ZwWLhtsLv`-^E{h<b$8%c
z+Bxgg&(^+*+@u^XHbAWu7e=9Xz4iWvm?<^8aE(mI!JSg;Jw6Y>neo?h0TV9yXpWu8
zT-wSPvHc)vIH=>MN#I=`?J05M$kdr+AQsfk8~GIY?O~<utRZ)dI{)o#W7-gB`2iR}
z6MnM1^iF%HiqtTDxw{#8{<y+gLG&glCXmSCdlyO0{{U{(w9cw<vNSwlVov|iLgt>8
zI<(o*HYv3@BYIHjJfm&&waJP7+@&P$z9O|Ig$7jwWyQUrc8ldwIdRL&nT#pqoiM=Z
z#aP?@#2G*(GuUYkY1J-3JO!rhR7hiRa|67j7Wa0}j}PA`t)o*|xQn)y#-CLJWNlz~
zIwk|X>FC(*Ff&bh^%x^G&h=<0beGD_9#z<jH4liZc%2x?j*O|oZwm<;fwR308#~{F
zHdBez!^L^&vjz91+oE7wkIon6HL1~T&Ew3C;d{jVL#H{}hq7A<8BR}a<@YAU@}gu!
z>E1ky!n;zzsqEQqm%-#EbD^i+lPeHnaa|eYa@wx*2ZPZt2>+sRbc1$NFiQMf>F+b+
zBPrCkS}!OZ4USWW(KEF-2smm1No9(7#e<4-3fIK(rcCR$89~xVr1o@MLus(cdxtRW
z3CkDlE=WsFo@UqgOe9)e*SccZwDaSImo2jz#?~XxIO<+W(j$=78S$A`C%j0+xZ$5x
z-XeEPXy7Wfea!5zv@ld=0nq`JvDr^JLoCU3#9kC!0__lFstJv?Z&&J;Kyrq$tm;&o
zY)Zxy7nZ2sC8rhrhD`+3&ak}!Xz1)^VeG10p8|=@;`OP?^MUQB1pn+O(|UEEJY0{Z
z`_<<m89CtvsENa(AFJJbG@~-I9G!s4BO`OrhtFUZ`5{J_(2<M$A|2|9u~Z#MV}upS
z+hCAk(q(VKjV7V!!JQpj3Ve0_8{ri?<4iIsJiCydIXaCUxgpF0a|o1kACO>oO7<6v
zoZ<~e>GZYLe_XNVo^BL^VZSG~u%)PsVi%&_e1pG#v9OCs*v{@7<&KSAakA%K=vRoS
zu$OI_6aDBw{sn8jkpz4&I^lw#t(W^r|NcBsH#v&#jg4k;Qf-1sr>R%?UWk_W)HqX5
zF!inIm*SX28Rjgas`#<mhbfxMNyu5L3D@o5Lp<SHNPSuIbDLLNMs|1GNd2c0D=1W<
z;HOsJ?A0#?C-Hq7H7Wbvbq3mo15OWTs!K9tTura#f(i2q-ldSeT#WZ<^{5uyx3Ahb
z%jXKwb_0|T#ehYxWwAkj<s42;AbBTQkrUDQ+VLRFVLiBFW4F(VQ%qZ@t7(`&XD0CQ
z?p>t={$I6oq{Vf!!#?5*%TO&ZOwUNgxao#S$xcI)1$SDw_2>$8iFVP9d&~W*IY0bf
ze1RRgFVKua8&O{tQJ|Rox{-xT<6#5ka_2*lm!2G6Yr~7Zi(p2-5hcX9ncv(oybF0W
zRFHL5AZ;!kiu~qVS&$M4&oq5q2kr0KSjsvWmV)@!6->xwu>xZXS1Zk_n)}Gvs(W;{
zNU}igCQUpZP6X}gv8`YXB>3lI2Rkx~9_}9)z!0}Yml8KJRk4zc_}Fg%-c`QMllnRy
zW1_d*uNehWb5?az)ji+Pmeu6Tegl{mgEt~B)&g#}x{bjg-}<pL9Hrab`HKiZ)lv6p
zg(YCjlN^_0f<LSpB0Dv}N}VC6639;9S%<8uqMlp(!HR<xy`@dF8aE%8+)B_vgL?wL
zK~brY)G3ppSFl(-erQ3G%!hq`e|Qsg2S@dCn4KbkW{S&)ZQLM_@UqN56wQTpzJv4d
zmSuMXt24lExge2_1rpF<{v5I_yakZ>%S@&SRuhDk2O=k#XfZ7GF0xvEvzS5Oj!?@D
zI_z%8r=<D8k3!$~Fnw%-%Kn@#UFm((6P$2#ujr}?KO?;!0@{D`&$|Dw<jw>foN(P;
zr`IKzSWoBZAE_UXUZh(D{H*ND^Az16d?~_P0#LJg<MN8B4BJj1w5B3FPaAahsVrC~
zNPq};$HzLtK3X)me@QgB7XMC)U~SS;Um+Q#zCL!~bA|EFMWf5n{`WCX2|aY|Wj@RI
zDG^X?dnu;xmPrMyC|Do@Bc^+(!$L$QwE6XFg9+xWj+1IfkMGIM^ThMTDFxX&@)D(^
zz8RsoCd%lkDz%)LKTf>U+i&1qo)a2vogid83HHi)^You8T=gNb>ZKv>qCGDoS5WZ3
zBfn%gTrn{c3g@a8dDW#{MpF*EN((g4i67k=$7yT5V(0a0FN|p@QIcz{`mqd#yv>)=
zQT}p?Hu4kTeqGHJ{$+Cel5Y4D02=<X2jl&wf?;dZP5kPh#NlkC_%y2X#}dm(oAj%%
z8?I_&bY9C%T&K8)2dPWaKr88$z^dQ7(kKE4g1+F9Z%prCv0IUiefhiJe{t)!eY2Es
z$hKqk&Enq_q`5NyRHh;10iS=wDa;&X2sXJ+<`^wOFxmWffprZ)McvJuj}&V+>5kAF
z)9aMf2Of^gxgBND5_SiHQMKDPaY%hmCZ$Q6C)|GPirNQ~TU;{Sm^99MDjoSq2=n$-
zWqz-lH)$n1*rQYXgiX66YJ;Kdha_dx?Jt8syL3$2h_G<z^#u22HSd*6nhG^Hyoe|4
zQu-0@i#RbNJ-^S84nd%hkiE=8idqK!vaTqU-sgq$_aBYUA9_;j4?Tk$Fz5Hv8Mc-<
zQENkiGGb?6m-V0h`|Fv<6na{~EC$8AWz&NB@p?FzR45IU!s?6XW6i1O)W}cr>a>Kt
zebR%QTvP7tM!o8)wQwemdkRQTONi!q_LH^O#gA{GzkYr~6fetMaJ19<`7-hFzP~^5
z_U6^md7f75eig)RL-c5ws9xkX97N85N1Ooxt2_~1B~FLQKW#pJn{l&lVV+kXpo%w7
zprlVv{+;)b(8d7Gu|PO%KY|O#Gg5(Y^>-lC7=vyIW-jloV?jT_KPrXS<?8$)tGyVc
zog9DXnDx>Hm?=D7__+M*z-X~eT2r1sB6R;*{&<7p8$ea4S<(NaSTe2lAm`%klf}3q
zhj%bFrr>W=IWDx-8czFl3D%Dj={BA5e2%*^0m1kpoG(yS^H0t!ovtBG<n&xBCAsfE
z@Dz6R7jdl|l%IhbJXsqH2_&NwF!K;t7n%Z0$;IFW_<}Yt1n&5S9g#tn995vxX?o9C
zBQlk!06|g!GP#{{`TNn-9g=dL8^SWk#T$K2A>ZBgdgj-s<6n&&$0npbI^Y4uM^nUi
zuVdn0_4Z-HNAEW_*)4Zho=5<*po&ouO~kUnUJZU58+O8b4&MgNqxWve6G?Jp=AAD%
z^}6B6o=c|)?zdJ5uC@oYJwzNe^Hs9egw7agz(Psv;jAp(o?OFd9cQa%k*eKpRVW{M
zL(<0ZbH+~urca=;g0=@2(D@US*gW<~SwPdJyE}PBJ>)l<#gpQFoSK4uW?!$#95#M}
zgU4-}#M~(pa&HDZz5@Mt=*?)<Bdc{hjBY?tB&zVugZN?`Wgo~$?-ZP>_EhQ0=C$z<
zvy7E>bNl-1mu$-@C!hBRhvmX!k!xOqJJ@AN?4cI%nCP?sq^T3fVngFg3C^%%0c&!|
zgLR>CwBHd4x2dF|=1#8bipFE58r|)iM*!g2@X{Og$`T7riKHrI_)BTlw7G0li`n8*
zsM+*V`}Z*AaADYObGL9aRwLaAOBnffHk})THX>)kUSd)?MJOr|9PJZBi<3e!1%o8)
zg|*rm!sGq2TSiiFhn&P9MCmqYKZu8BJ4@^RA>fEV$3=4!l9uJOR?dh<WPQ`a^Ci<#
zvCDdRNmSJx#|!{PZGXqbYa^6=mg^o)p$ztf+pR5CMWJy}X45Az!JKn^x2DNie&yDM
z32;44;PL3cMx0^n#&znAG}!@?O=s$WZUD<!?A8Pd{MEOedJ(=xt=S<!hNOvK#y%}L
z)5>w{ZAxHtz}|d~;y6TH74inJS#sql%UA|k331Ea2&dvrpiO`gaa@mgz1_=?XlT2M
zcSA76Ab)coWJQ_N_5vQ+)IrZ1fRoOOVITz+C%x{j$9!+H_Q(PD$W60;A}g8}4?>o7
zQ5{n?Ix(Ws2Js2%lBHsxLqnw7({th1v02ypF7edXU~T_ILp0*<ew1NS7?eaue85_?
zLPvk(1s_P}=np+*SVV9dKV-cjj|a|?oPO0x+v=9pAK`<+oom5`#c+etXbJ_z?q3Z)
zPMn%<Ske?JAz7go?`<I`oZldp+t~;vh}`|ThA!HsQ-+%EVaA!AG~M4Gxur|qbFr-7
zS+KZc=fEq}&7ooJp;1c<H|cQ(?y)H{&S19%w6R%OZp+u%(p>u&?fIErMJ5>&gzeME
zHGHm;peN-}uvEZJhks8bGybCmpgXy0@x+uY0Cj^Fk!d|#NfMAgJyE|rzuB>>*;z!3
zvrv)*i<b>1xHyL@d2dgfr%luwWxt_N@dx#|Xep{it68?l11u%qrTlc~92d!Tukoxb
zLR8IaEi?k2Pt)88R5AK}%B}bgMNu&}`3~XraFb*D4P}kOp1W>(vkJF@#09-8<jt&^
za3&#TFYt8cihj8?La37A3{%?X`>Cwam7XdeUFZ#~xl@|SQu~eKMX)KV3My-?#Zm^w
zSDqYgGP|{>f#;zML7d@q1P=1@x`lUibhACrE#{J$%(C_-Bun`#Fsquw(NsiKZYFBQ
zUQ`%PW#2zC>>C`ZvJP8G09x5wq}kvjQt@1^-#$O|HvUY=kcw9se9flFW<{-9T>LQ}
z<ALjq**#2fagZvjUUqUqE^#euH2%G|%lG0~{CMF2pfZO7uljMT&vZ_4Z8QG;WlK5k
zg{8Wn&_}kSa#t-F@~;0217i)jU5RR@7y8O;$P-gBRNY5mSX-H;xb~-CcY>2?g`Z_5
z<GC)XdT5nn663|Tgb9LzOQ3ZivKQ!{czOXS@xa)LQ%atOrR(7i?&xa{-XOF)%a+yy
z8mD<j&M{Y<gij|0ZkEMf=849!Pw9JXz0GBmk>^))I#e8RxT$1QE~;8TrJTg5-%G75
zs~_Hx1nSP5YSw<UTnDp}pvk@oF#49G&3P2{{Gc7L1h#V9g5H~9k0B-KzbYU`r4tGR
z(#eI<SF?UtjC4)ShLyFGgZBcs2P&mx$;-y|-U{^VGJfwK?8|M*)2)4N_tpOr(9Q;T
zO{TUWd9W})RaahQ!-fe$ab6E3yc{m!R4nan#X7E^^XiAk>sHP=+yke{P#w1WhUK^&
zujYys0FI7!!2D90&es~)(U6KNtH*TVud)Pt{+EJtH@t}=?}PnqJ5{2D-$^2zwMd@M
zgkG&v9r@MW0+D0CBcxSe2HBz)Dx}U0twdvz(kt+5E`Gv$jyswyM8Uuik(3-$Tghz+
z77DqcK<zrH=zrJ$S;jd)j|*(Z>BE>cp&4<2w`=k!4ECCL1*p~tH-RN1>r3Vs$5*L+
z;0|_waCRggg(ga+XRU^W%h{@+Jz1>KdpYAZq<+@~&H|<<B^iw*HhQlt371~@$;3$P
zGhNVE?&OXC0MYTERp}Q&st@L*-fu6V^zFRFa@pT5bRGwo6D3tM{_4#^KA5)^=*c1Z
zr*B--!|>BTt>k|H87G+kTelhVABktqe~^FC|5!Bgr27~2C)}hWkH0WIAq_vHF~S>e
zza1o%n3&j(YwO>$hi}e@Q-uQ7iG+U}$3y<-TK;do&_Zn|wC<)IS*BxI?4=vU!0qEt
z3Az13=VhctkoF+Z8T)5v?Y2Vx=sIcfaUH6_E)QfBm6`F=x^Vv<GLUG@K~SZOv<##V
zd_WB1U;e%AIWoYH4IFpUj$+dT86mmn5)5NA68P1Hd6cBQ=7uL`At@G<WJdmU=<osU
zEeh4pwkkiJv>?wf+1c(_`O~_+aC-1d(DP)^v44EaMu$5v*5BZ)cEwR#^naTVjJrTc
zF9e4p>>!&<-!oaaQJ7Ip((p5I*46(+m*Re)`^l}yoh@_h7FB+~AXdw=&}c(2zKVj{
zh@49E<mmkdIHBf`7%}0|oK*Vd?f!ddVY}*X{A&g^u_5i@Q%Bs~Hf)r!JD?fZ#nWp2
zZjz!rVZ7)3g@lum8;mI~u}W)P-%|iZBf<QNs|Dc&A69LEKeatnt8?}D+f5zX8i0t!
zWOAd^yvM1xnZw>kIT1tYZmNYdth4>C|9DtczN-;2W$OX)rKp`d@O1$G@CKG}f;uwr
znAN$u)DfdqyS#9wZ2PtQZE+*gkAZ48+gywgF_XGWxz!(ULJHNCyG*+#2E92lls4__
zdHoYr8+&y8B<s!@+YBuxR!0YxrMj4y7L0=u3TK)Hop(!QOuRH0(JH<b%_6Yqyt2Pm
zZ#XeD)HhbEkc5+SZCTycOE+swJIpl$baw5exI-ZS2@PXrpBoCBy2X(D8TccJ2!~xK
z#_dgdG(~Z6*n~%;{$ZMT$OFEfUarYzl#Q<7^?5&Ucp?~i+Yc2d`rMrRnceNSSeR;*
zRj;)f#l+uzMg;B=2al~+d7fJ<Y|oARSrKJ^u%y~t)6(Kv#{N7Y$#hVTR>P-!3(u>O
zC%iU=Fu2^N#AQ``+hL?i4dGCMdNDyG^uv=fV^X+=`&siR=xAfbLRIl2WnW*{{Je~7
z3A=bnTqXpJ>Fr^CJ1rTejik`qBhl+jxyL8G?gw#5*T%eG49<kErRp$(X&0Lr>f-jZ
zVyUSE{1%Xi1fR5Sp`7ZsTS>zGUTUU3s^fu)RrktQ7gY*L@zUZp&+Y;ymPl{e3D>It
zdHEUDrbS=QYkThf!Dfogu@iYwvB^AJ{};e|`w4>>rPI`<Ek69Lyl69VblAchgcD~=
zbYjdvPruV@yM@#(f&J%Co9nWRtR6Xi)9p5?{->43JEjU(W#Xj$>KOIZ6#OB>dEIm(
z!Ovno(jfdUCzL~@q9+|6s+6XtC+(Tf#c$GZPrQ*$si(!?JgwO)evEWxwI;-@1_G@@
zgm3p>%-8(m_dr+OJr2?L^uur=@h$q)6@AQ%1xv4O&G2pYXeYjVTEm$&?kn6q%l0+|
z(`d{M)mabcwyje}#_IbWR>j4|FzNtr=WZRn^Q=lRrN}tbHSVGO8#=vK(L8ckRjanY
zH-Q10oj(N59=;@h0iSGh4XK~#%p6QZB+?dmtp@S+a;73iO}U*1f}fu_g(5Ob(W$0x
zGhmgxQ9CN!CT-;jUo<FTB^s)BFd`MP-`Mc$c6eA+^}RGZFZEOng%d4FD3>HoD!NN=
zvbmkkb@qM$HF{d*k&5fcSp@**igolbTc7;|5O|8?r7L;j0-58Y<>Rv@%)a_#FLNYg
z*{5q7Crb*x+S;_R5HQ}l!N5t=9W@h_RBQivCD&c6PcceLlTnHDx;(30BjezWUQpV_
zSsuasKh9{J+8Z*;a-~No(;*bBm^`Nh%}V@^el@ywX2YzJ$uuKx>t}sIaB@nt;@gb3
zhtpx>PiPNyUN_IXHYd18V}2Z%`da99m{rw=)!!0@SI)TzAY~hcvqPB6LOuVA3{rl6
z${Ej788gy~NF;HS6kL*DdNp1x_W`T`q@CR=*Ond+_BXUIsv+JT=rAPCP&2Z8>ZeJW
zH$+}l7af+#e-cT91|AURB=ltV4hx(KCp1M~YT7#6zPLcMebEMy%pzcSOj2T3DO&At
z$JMFbV`IS^3bO=CX!^`r?e(rjdhE|$!m-hwoV%&2B`H2gM;&;jdTV}hrol2D5XP~^
zQ=ue<J4|azl80sFvllR*u$RCy2%FNp>rX^2-@z01SnPi*s{=!3VVWm}ZU&(k#yI$*
zpL7siG_?G0`2uV^XAqX+71#Cn5>2~ma$>eE{2y1`okD->l@|?|Gh}7j<ZrTYr@wft
z^^Ps4E;Vo_%e#NxXXm&r0JD^s;L6aa=y7U<?ZpK~9*5I|7UZ`d?a9U&e7&vq?s|m;
z|1q}&Kh&ZfY#o(6Gsq(6s^RQgNd`9y5@$BFM;^eIDn6wpFfNT2OAL<qQ@0}TD*p~O
z`PS3~c&-`<Z*28CyWE<!>X>FZ{EB1-zK4doNd}%2YtDt%b~D<7>!>_<T5y>`Ia}wd
zsY%|!!3TZE8{niM?;!Un{mp6{<DWo{yxNRMs!TyJ+?|vsU_)ax>krjN%d#2&8Esn=
z=ZB|4YGV)qR-58#N>984Bl$z#b?#tUAr4va3cgj&e)q3-X+Zin5~vK<ufI^VKsDDt
zpnY7|iMdqfG0Fs$CdFy{MVC;F9#!J1E``wc;7}lS7_;ikCh)z<NTe;fQn1>+$;jY}
z29>`0T<jqGdIsjbap`-bNd_xoX5GwQnD=L<gy);!hj__BJufS3o(Z86Kdi9hZce@^
zeX*H&$VauvGL<lRxX8|U9XsTVVvzE!8nNTM^A5Nu3NDF2E&0Y!XpRWs4&SyIqB$We
zD;u&PxT_(TWwE(A`e-Ah8g{zs^`c=&HTIQ=65b-ismn7E*>5r}Zp`ZZy<I{`36Rv;
z8hXe5fGC6`bJ+ZQm(~3evNbp^phtLaT6wD1i|1KY$UB-o$8zqc`5cPdxCjX2GvoS{
zrw+lXHtP(NzqdK*+&<yUa!SZUF<B#I_Qq#l!V&b#7Z2Sgc!Rz(RnCo&b6A4+Ufnp2
za<)Wa*^S$ey0pPJVTzMcIxY0R+TRm9NUT4fW5I5#du^gw<S?q()?uzYJD39V)e^6E
zj6zpC*}D!3v)*4gwhR7OZ(kV}Rrj|GNQf{XodW_AN)90n5{fiPcQ?|Fbmt)5-3*~f
zmxLnHNVkB1bob1h{XF_S@43$TpX)u>`EcgrzGm;WSM0Uc?_T%szWbyd>n5aJ{hpjV
zk`M^N3iT_yk?Kq%bFM`vdC0ICwMa_Za;x>6C@cHSQt+ct+*@mpYZdW}q>MEI_=ifg
zwmae!T$Ox?$}CUxoq=t^4I@?QSI0s^Wl1*NiA{c&0nKL(ma7Y=qz9ta0;vMC9+#v$
zwA`{N?7$HHBH8dg9HJ?qT1rqmMK~w67SI`*Xeny<44IfMNI9z|f05Hg@x7ol&T>ne
z9oq==5`p4m`FM3jN8WWdc)yXLm;&>sC6%H^D$ik1CIrSy$q%|o+wE}03KhT)hdG7=
z2*Hub+aqxF(2`bLH_ciHE*7YZGymp`Nn;k%aR`WhCmcv*bw}h_EsIDmCX?r~PN^dO
z{z8Ka9Y?+yo09PAg1)KpgM@`4?A$NTrAs+sv*>O@7)ZpUV_6|LQE}{g!ZAEv#mZ`u
z8GnY71wiL`xHInyp(sLgW)6qBZ>QO|QL>HGWx^6=hQ~wq0+c6e0c2c^dj#7WExXBL
zKOUM?_;gO#^L;!2hZIIHJ!^@^`CeTXHZKAfnp`Fs8PxYBDFG&v2a`(kvaCa+YY#Yj
zSNC-u3`3!g)3?=-h{Dj=_k96|$voDCB5W~`Se=oV5!R<SDrYyS;l<lrE5*!pZ6uE7
zi6*qeS$0l`v^tqLb5Tb#C<QtMmy0?;`P6W*R)9PA$Bqb2dhu>?A8c#THYeEKMKX3c
z|6GyeT)WF8IXbxK-NDOQlO|v~#nnd1eOsMWU7c5`5NBemui!SKLy;g?-V62gyr+RQ
zRN74&to!-O_hMtrc%Uh<?$-HRQ}Z$S{;I1W%h1yTlfaa&_G%8a3LR}lQF-ReyYz#h
z&tuDSr~UVe13WqQ>daPtFaWp&T!Ey@=s=ocpt#{bp$ff^%$j9h1a-C6iJSIcI|P10
zrL7U&2Qao*vG+{*SdPbzgRoXmb%+7)Qfg3ZF*;gX<M+D$h?%A5pNo|4Od869lLEUF
z0&7c9XCnOH(lB3GVd{|@cE5$Dgc^8gcCIlxaRoLx^Ia?nJviXOpEWKTZ89kd`q?P7
zNPBbK<n2^bnNMe4dbM)KAg7j9Pc9F*RrP|rE->!zz3Dbg82$zkvDfllFm-9mR<E|}
zo+0>jSYu&Pjc*o2QWRVMaO?BK^I`3K6gcb7jt$>WOahG~psAn*Css@D8gTao3$eRY
z5B-aaQvHXbtSBa&@xg?;>u2OVGh^zR487e<?@TK<ydxy1cvuG(s3nuk=`RaxVNq}o
zT+doe%jSL;k6ptL8L%p_fPt93)}=hMR4%vngIa@N-Voj^E=$$M2ErK9aHEyi5$<ZD
zJG#OR^7R!Dn2oj7KebLoZNF3F5<O$v?bVn}wtP+UdW^!g!oLz%%Kq}b>#3`aVMF3w
z*POL28>KaR(?iK@%co1P=2o7TKN*oy<TW*Ttq_08Umg+k7~}f~+Xwa<u#ZA?<F5|r
ziCXI^eOjN)Xq~{Mx;x*84%w0nQxgG_V5t+=A&YQc%gTTc82v(68W?y&ZM@rxEimuy
zmm@HOQo+9=kUhIymX_~$l%l1+Pj$@3xpoTlDS4*c?dr5<67on;s!>l9*<nwTg)0P<
zfsfvnOZ<i{MR~SDCsFnqf{_EkS(uh%<B<XO$9({G&qZC?K*W8A*ucPmTG%6Ykh9Ca
zhr5u~J}bcu?Yx30G5#N#oUq%rTB&lLlD<AQ1Ol;o1D*dTq`XhShdKz$Sf|ZN^}3$K
z{u=fB7J6N2#ZRyO4%uq5&r2X(;xG8)`VZSo(Omyz`K8;d@<hD&6E+^d6Z}V(4Cg;b
zy#HOS%2!jyM<d{5TzK-E&=%T!e>mNFAYq}Or0y{zW8BvMpA5*D#R923ycUChO>F-U
zA@+Y?phX<>#K@(j$h9r=K9+LqFSwRL!O>R(WDkE0g%9{2DY7sITOV!B4lk!6K!rX}
zTvcbv%jth^1fn`OnqQQjlt?0K-%kv`5rarERie7ssW{hCWe?Jkiwyi3SB(w8e?xfD
zQSYmK4m&i==1H-Bnk+(>EC_LXA0;^Mx>(<vQ48-3I2R)EMe)S2nbFAh%k5YAjBL&M
zv+rkTfS$0^1aIvG5Ze|wIWS#xY_Y)Wux_hyo~%%0rk^pLyrs2&B+j@NkO@R0hskQY
zcuLRLBqN>YfQ4sKWM^Kc&T+%@x{`RpVF1XzLOrzZ{6<GRqH%3rT9&}gpEGp#VCN#1
z7d0jI12JjMxf^m$Q+_!Z@T!hoyONYHD%eSqz;9rjD=sTZNPVZQkwnYq;yW9&K3%`7
zq~S|{p&H@^sA15H)AqM*A=YDMCWlNYV*ZM$pRrwYHwfduM@)?jjNm=&>uAib)M}^B
zD9Eqe<l&@|Y@T5+v+N2x=X~?{Iz1~h;+u~D9A2i}SyJ-WcFFK^UrjCemsrFb_eG?X
z_%zwHNd|V`lfF?j5hCBA=VsW~RKeyVALGB&+Ng?qsMa?o^sFoLvh(NTrahmPdE-FS
z)v^VqJZ&J#YIz?ymGr(CWh$TI`-14yFJc<Q-dkn8aO9pDK~?X~*(q@enr%Yk3^j~{
z6@3d&PHprvDj>}*-RG&ZZ(r1~EP?3oZxpD4i~=bO64{NCdlB{Ji|SFw+$r%(3*|S4
zbUB>7s@`yxL$N3(n7kW#;VLOx-z=_H9`2ZmVUI^i`Z>swc;#6ojX}8IG+w3S4!kq;
zez@Dl?2NP4>rr_%62h&s;v*l7!D+sAnGhE*%IVXKxi6c+Ank)IT@k9(w;Ac=0(0)R
zAL_ra3+!0n)bZK(xb$_i|Lh-Kd^^-jRkLm`Xs`X6BtH-khX0v5qkly^Rs_vSR*>P0
zBh4u->%+ED8Ov9kC=%BS8-tL=4;!B0?;9I**4#Fji|#`G`l^-fdpq2SfJ5mqs!Sl(
zA2+u$z5gIn8h{2+L~kbD(Jw5&FRqpFP6^Cq5J|>r_jwBHK)ch2KKh>4ISzkTH=%Cr
zW|)<$x1wxWsC=K<YBVvb10D9nsWS2~Yx7SAF;Oy1V{IVlILvz|nHT;>BlfgP(ydTW
zr`7fci#JHf8nax+P(p=%sT1iqC1I<r&B>_r>blJEnsmI+N#PeB>9wNF!*O{v`@ez$
zy5R}`hO{ayS5bL*8qgnAeocn^)S}o}2!-3LvLpSz_*LJM;C8)<R~c;y?HcS>xb-*(
z6(x`Pb3V4%uzl1VJ1P)z;_eE-8C7LyY5FzdrPJmFvGCLno8YOGd*j$`n5}rTNc?(&
z=gH#g0S))`=A+xHIe~d~k*W#V_tOO1{#XdG$AkI_*<ZuG%U|hqpB9KuzRt~3l9Qvv
zArlrbQ=dd7yI510*eXr%uoKg$y>!3znXyPTt<JYSmYmp39dm)LSUvD9*G-UYVKqf2
z3h7R7CV3k?c=Bs5xod45#zT0a(y%Ib5<n@vq$(*VN5@`PFCww!``ib&o&+rqUG;J*
zQIwxbMsH>MV06LPP|7PncR2~__F>TW`0cZ3DFAu`e-1ofQ9#$Pz6z(3q%6yK3LOb~
z$1es-jefb4c7ZMo50AA-n*t&H99<Jcn;u#{eDpkrFYGQ(iJDRLavVlzyAs!o<=I>Z
zzzc629{g(gIqASgC)yj|#J|#ix76QRbC?@&le<;(XunnR>C@9!c?&%1I+4y)HDVNx
z@}ulOX>cv4N8cRFT=~`x_ew}wziM_{W!OHoC)UBW9vL`_iXuxv9Rz8CmSg>HL6o*#
zX<w7cy*7uXfGsUtWYa!dvLCx3U)sN2o|nadF8-|6I{F<>i?h#JGQ2sel$rhLW?jI4
zN=??Gs-$mPt|yUw@9G6Z%1iNhto>#zftBu%oKTLbf?aVRIlIE`ce$FlQz7fVRmYE0
zRab8C+MekYRAf)FOT20rKa(ITsd!K-v%Copr+0g94b8dL@*ZQaw$id=Na05>e_{|<
z)l>(<vUb3(%P-6Yb84906vtOqFCV<=7g1+7h;xjOyD{1;^v}R^Ja@4b+Z)WiDM(|8
znI6BIryOF~Mt!{mYA5JQkK^Qj|5FTf(114*eQl<w-gPc^?rEp$u+VpV=tx&~*{(2l
zO{1OgT!rz+YmnTBFqpac!4e|(bfdSPIgoBJ81FuBs@e(nMvbHCjNR^lP-D)C2D`NU
zDPR~WTy3Z<IR*`Ae&WVcul-gA?Lgx?+1_c*=FmSR(fX5s3{I$%2AQe2aq)*A;AI;_
zXiI(g3Fx4nN)Pjg_jr`gf)J%qRsTiTLb-Qg(1CDFUTX@gb2vLJz#Hov-=IIwvz6h1
zK|;UkpzOjJGllcew7(RMS9q}E$|j%lI04HDmZCWF(thGS!$^b|=(ryZ{l>2;S*83?
zc-%YGSW9>z&24l*ar9}QGwLWo9H5XE;f>v{3(4A}8l`a!u$vcGt>=9=`(#O!Rk@QC
zbgKEX=$1S4*+9!xPlm}COU|C`%6=z3NXtyP^$Hn^`XZ-2vzH!YiYNIvBSjrs)4Qt1
ziJRN{n3na*2k*a)N#U>I5{oQJ`-Ndh6_Vyu1UjzdPh9jL6e_DGA0TVFK_zWE4=-7V
z6AWa3f-&8qFxglEXy937mnXL!4A1TbpJoy&{4Fa+)30BPTMYNn|09avDI_0V5lQPe
z6KWEl`ff;F)q%wne#uV0NzSzrK*ltGe2q1)`W;STN<z%I1_L@)OkN=LFr~lZbf@m^
z;QjYLY&t%74qBd{3wwL@Zb9bk6B4uXy*OeD_%#Keie>ow6@Iy}9{VDQM$xM|AB6&D
z8xJVeCyRRb%e(KiiQ>e03Fd8>k<)Gyz>$%+53AOLFBa!}Ui0DJ@uY7)WB?MB4^OV|
z<7PO}_WDh!TT+dWLR1qRU!ET4*=Pm%ab${*sp?zwaw|iBl%h?u@m!|d+aI=H$Wf^1
zxPM9w_EAG^WW;Q*uIV%zty8&(BvGrR*~j3w*Va$iv@jX>v7X&y$`5X>4Xf1UFZlXF
z$WW#dLZa3!v_sXX;-Q$(dUAr}0f{cp>UAmHC5AwbhVDgWZ$DT)L5QOaopStW`Os<n
zGk8Zwu=-X~NNkKLql??){js&>8KNMcC7(ts2&EG$g?>SjcySsD*Wd!bE-<p@R#bfi
z!&@>XtD+0iq_!AzhC@ER<4}QCSRc@sBb@@p54B|5Wmh~uYTtXIN7)vDf4<@U(#SB`
zX6af0&+V=vM<pv_&(4m10_dq2YsRR3q-=PBG`dA}Frg<vj;``o9J|JRv{!bpOiYQ=
zsy<1934@BoR9huhi}Bz{?dvt;ClhvUvEOM~naH9A``>{jMDWX!PMrD*dN74TxC*~2
z-gkBYtF_6H#BO7jbf+6Bn)x#Zc^Z6dSCLXQ5es5hRL|nG=G3s6O@O*Wp`TQrgSz)H
zmM&`ulJmaBMrQT!hS`)a9m03>uvsv12MBIoPR6PuWv=3V%D=rTs65nAuMRRMcSCvq
z9h0V!p|7Qo{E2TNE;5>sw6nZW-=uKW4m0_gqS0}h?x)m!jItHe_Low|j$+kq_lSvi
zFcqF<0{p9?<Ch7@^O7fQ!>zHjobnrpVN@}3jPsQl0)EC#G$6}l_~XHJso9xEIf6hk
z?)$@lpjf*0{4@2QIQ+@_;}IUKY{l=n21Qdta?f3x+hV4OTPlaGXebSjin?l1lGaLh
zeDQ=1=lWulv&Iy)oZ*k+rh3gShLFo#Ec^@Bl^?Qoux1{|@_lx-O5UQ{J}~epv`VRi
zQfX`ck_u3ic1p9STi>BvcJUqGJ1%Ha_tbjW^VAkbQ?;%WO}`mRARKqa%5-6deH=!n
ziH#}6qRXDS{4L<H{hRY7VKD9OcDp*%ApvscCwy~^NrGD;L`>{9v!&wGfo(8Q4ZF*r
z%9@kj?G2lJ@+{Y{fhI(gZZ>_Cof9hRSoRrmW`%q24+qFa9N+-iSQ96``VWW_meHpt
zno$2|&B7sPq4Q+P|B!KVy-y!HtC@P$sLQ}F-4)_uT8;qbMw<0=@m}bmvfrDlAU}Vh
zq#Al1wA3iFtU#r*)fL*uVzLo6Tg)b!J%LLX*;x+;QBXjoveFXj(U5!JaXG7Nc>2A<
z7Z;q{uW0BntdXGH-j|&@j*|S~=U^X%DlERrlJ(;){frF$s?Qgt!OkDz!TuifcYM#S
zHH{GN^@Oj|DZ<ExSVldYmQ%vcwjEiE>`emSP%&&3Y!AFAKWY$g@;NtW+tESjRms$1
zuZkC+<)l3ZW4|NepzHfe?O^${YxBpI--^7gRiF~D^_O|QiksPkv&4jqFz56`^M469
zBNcxWZk#9U@N3BwyfMf>iZYPI$6G?6bVHpF;Hu)CZ~`5z+X+p}-7(rX%;hf^Ly~}Z
zs}SUu@4$gjzJEYjjrp@YD?BF$fWVcE(sCOBZHXAK3n_u;t3+c=`surVGJu=F5dd}D
zzkw55*x~}<7RQ(%E1ZSNg{N%%CidRUUknu`YR)UJw}ZhVVL$c%BXUz<mcPWF%+9yE
zq#~)2gcZ<6dpM%|jlXq#sfoNE^M9wc*czddRY^oe#N&%x;f1P<8@C9PdCa~)JR;aW
zTK6xFp5pW@#J#mg8{1_2Lg?}O-05DfA1a!!ULBcvy-Ohtx*+cGnb$0m2DmEOi$_KE
z^I9w>H5)5t+?RTC?^hMqHk;1&g2<JnmGLidBY|CyuJNba$&>F}Q>XgabC=T>)d}>W
z<P_CWv3AfgeY5_C8R*J-@s4=rk4?v<ao4;D&9)Uwf@9`QhEEHW@6hqCj`y8SIXQ|C
zv^l2a+gMd>^>7+STd?$rrRuFA)2#Y14$rZ*;~$QI1yN<sd$rHWHj-3XksPW&tH0<j
z`ucfg?x~9$zR<v;HWn2c5Zs`I+t+%m-i$#VmG4zG`P@*Zzpf@;BsX5@B@tLTC$hd=
zdn*9l1LYDZUy-dXs$jcc9UnO4@2m{kz+EUBvpY#K*A-t%ihCNb%&A>^O~;=SnO%yE
z;iyc4uw#hlvRouCVcDg|KHEC>QyR0?Ah$0&T+8os<1Xc!U20eWz{itCU9>*2eVC3H
zIK8K>{37%za|7k3hn@E+-kzTP*8>$*OA5$}*67WxZ|ZcmMad0>mV`<(5vhjJQIcMG
zSScVy7aT|mZn<vZt<{x9tl0DNkrs4SByLshslORvuD?eZtCReux^JT6YIw|2SKCM{
z&hHJF(Q{s+sNYSQ(T;7)Dlz=W2>npoUNSLyxxedR9eyh1KCp(npf-vyUsLVWWy(SN
z&}1z?yatyeeJqU~S>_}~p=K)y%DpCI23hjsW-m@e80cOq$^@Aa<xJselJP!_mj6`u
z^-HRZ%eF%dXuNS@z(Yf(`^`;IS!CEffkAF(v}jGJvnu2~o?f8?I$`S@vd_88<v$bK
z7%<cKH~B=msU`ePBj#ORg>_=Ad3AZeho|Sy%IzpQM0;g;qHohXF3y<3TO1XGrxGOO
zGt!=53}pv;6&tIP20X^O*mJv=$)bJ>)mb~LGxHS&nTi?$sJ(?~(<zz75ib;K>d0gy
zu&bSYVl(WlpAHKa-Kh<wh}=pEUx2R7Y1GGuAoW+j_=q2aa?N>T0F|zd^4wOhoyjMy
zt*rtcd*o?G{&S%g(pt06?vxlFmZ$Zb;T(s#3@N@yy=Sn5C%2{GVHx_+NC3`sfR#JQ
z@I9qFUQ6EMEac(V0D$gr``x&$t*u2yMG4yZPT~QY^ZI-0!ME)nMSkRKSTV`~0$zQg
zIAbc=iUY0=z{-2)yHoBn4(+CwY6y#DQssGUKRqOX=l`s;zk}IO%stqJAvE31gmys=
z$0j%T#ZNU1veir`$;j<822XEPM4ZP7Kh}MlvvlMeB0cl+#)qnmw&9`sZ#nyJw1lq*
z|KdsnL_1KDtjMlX&FFKRcoY6cqO$dRf#I7O_<xUq#XSMOZoP}^tvqFGp!$D5h77vw
zWt!i@+VN$vm)qhSaXdA}0c7cS3HKp&3^I}m8QgBKxHoB1XJ@s=;Ad(*KaSG5nSbBj
z>=o8)^4CREGqZ?26N>L448HeLE7aDvx3|e%nf?+m1K>2WTHs1JNc$z6nsnQrbZ{##
zU}PYP`FgK@^lH!u(NiE5vArWSP@!7J^yjhUeSOdM7u5l_k4sJaiQHeAz5oX(19-uF
ziNSO<(rp~wzd9NaXJb~*O_sg-{l1ZOiW%Ht6>4QCC7gay&CShpAtdB7pU{>h<TsQL
z?fz71+{n?Gkci0j%c#m1-Uy3)fZOqRseRV5kK@U;K5<Wk{2`X~X@5;R_)`bf|1vX}
z{MXEYpy6LL1L^;A8TkMA*GLxUyDMjPjhsFEY>%}*Y^7`gNQHO8?;){PSU7RqmRIi_
zmV&i2-`^3?&pC7ad>U<YxGnz03UDZFXszF3=UB7Z)@0b<UYj=VW}T2DW@n~lz_&77
zy}9qy^(MeKD{f`*=kDni_u+0!vMBsn#LXd5iMocx;c`bi5^<X?;_dRGUP^$v6b4H!
zkx!eLn&Pv$j?DVVfb&<QMxO3=85Qpp#I?iuF%<11`>Og|kVd)v7rh470jsNVdTTbw
zxgvFrTBc(~tc*;^#$i3!{w)mSz%O`zMS;=V5(y4&hlj@TDRIh_vX)n7+<hJX@vKp#
zIoM!eu)=#PmTB8`9be11?PEqB>En1hsV!(_rB{bxJgxW$kQolpPEgR%kiE2sBMuoT
zBIMA|@rgL%SaWS{B;e|i=x@ZBEXFM1?V(!xv60e&G8l>2@3Jpo=gW&mBN~vcFh>{*
z3OYOJchRgTlp14!P3~n}T5^js5-8du!RnLpipj_gc7J$iSiNZ>(qsIDjNwxJE$wNo
z!ec?Wf9g_h;3XJ;efLtZi9RGno}&f5X#6WMj+uq^hH~Lu-oHxHnl}>Vy|!{ZSvWXy
zlXFS`cxP~s&Mftx_>$p`xk6Im8uJUn0MYT=uTGp7$}Wj=w?;ykvRr-3WcG{hyY53-
zU4f3IwPrIx2dgjP%2cNg0nv>`G?k7m(cY{c&K|Q#uQn$LKYahlVuiu;{2TZ3l{?5g
zO{SgnmT~)a#-a{+$Sy5xC{H}#wGRX{DKSyfY+b&uzyEaC=rAKW|HYrob_nLv9aWOy
zGaG{1C)TAQK5nas*o$!P=v}FFEy3$ie%lu0NmGS>Yy3+1^Xt+a&z!+mIVOdL=M2k!
z^h6dPb)q#?N-sO);e&X&0X$!O9QB&tMm8y?el>nkG%jsWH^Iut7?x(}<2@1lPaE{5
zmxm}=ibKYBP4E>L{KyCQk{1&dOefx+&=@ExHHY08VWMJ`Fkh*bva%G#Ytr9oSzH$1
z!bsZ1kr5)9RbUy@t&sqvCsjX`*6Ld_Ip8KjmeMU(TUFB<tz~#kp;o5!bEa##7vKLV
z<kZ9dPs5|PH^n=S<PElayJmR$K@_nf0tN$nKLm1u&V1@}8l|F&hhpy25Hp;rY0O`O
zo`u@Sb{ck%E?aNLwLX|YT(OksEigTUW1mdbmgciO$P4g~#uvYHdaboaIRZ>eUO&R}
zoK7}mOO<lIbzCm{F2{pAOtSx;BLxCBIm{NaE+xnwmgR#R0RsshDLS`3uRgn{z*eyj
zzf*elBcfY@Y|Q;_zCpjzctUz{P_cPsaM#aWaR(De)u*Re*mX>UA8o#KQN{sZfMmf#
z-^+uzZzd*XN;!pvri`^+2%*2~+_Kepd|n#>ZwDLw)~uwH_GCn|Mm=U?OuR~wU~0&_
z#w6T&Of*09<rjirO8FKwY=ad`TT(kqVdp1!56(4vnYm+eDE6vTR~(Y}!*loQ!gKm~
z;p^Ou^E!o|$H6%!dvxIuG~h0z!}s!~hVq~}7V9I_-*iRtq76M)t^+%BgI+@+#PrBQ
z1C>p;q|yzFgd{Agy)E&0T2l=mKMUdQS@h4le@u|_pGF^sWSBj=ULBpgn&g;AkQT2O
zf$b|V6Rtow6{^#1gcSi}Yv(>i^wxsFArz}7EPc`#!~9kH-)%}>RebAp7lk)1V(^VW
z54Rx0%w$fDgpJx<TH8gHo$rS`OfO~d%P8;T(k+z+_v`#y==_j<Wh0FVJc&vto8<Y_
zHrEn@g^zU;>i_xuDVvMeEYOEncc-Jw!t#47U3p7w0WW~#EMP{Nmc`aYF$HE{Z`;@L
zY`@nqf!^cw{-~%Z35pqR8=|eIuJgaT-l6k4Rdz7sU!Bf!M%TZULxI`y|8d#4LGo&*
Vbs*eNWKe*g><cC78cE~e{{dN}AwmEE

literal 0
HcmV?d00001


From e8f64e3130e82a068809d13c8fe4d40fec6cde30 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 6 Dec 2024 16:55:14 +0100
Subject: [PATCH 053/146] Fix SelectAllButton tests

---
 .../src/button/SelectAllButton.spec.tsx                | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
index de8c1bfa440..883a41f22f8 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
@@ -7,14 +7,14 @@ describe('<SelectAllButton />', () => {
         render(<Basic />);
         await screen.findByText('War and Peace');
         fireEvent.click(screen.getAllByRole('checkbox')[1]);
-        await screen.findByRole('buton', { name: 'Select all' });
+        await screen.findByRole('button', { name: 'Select all' });
     });
     it('should select all items', async () => {
         render(<Basic />);
         await screen.findByText('War and Peace');
         fireEvent.click(screen.getAllByRole('checkbox')[1]);
         await screen.findByText('1 item selected');
-        fireEvent.click(screen.getByRole('buton', { name: 'Select all' }));
+        fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
         await screen.findByText('11 items selected');
     });
     it('should render a button with a custom label', async () => {
@@ -22,7 +22,7 @@ describe('<SelectAllButton />', () => {
         await screen.findByText('War and Peace');
         fireEvent.click(screen.getAllByRole('checkbox')[1]);
         await screen.findByText('1 item selected');
-        await screen.findByRole('buton', { name: 'Select all books' });
+        await screen.findByRole('button', { name: 'Select all books' });
     });
     it('should select all items until the limit is reached', async () => {
         render(<Limit />);
@@ -30,7 +30,7 @@ describe('<SelectAllButton />', () => {
         fireEvent.click(screen.getAllByRole('checkbox')[1]);
         await screen.findByText('1 item selected');
         fireEvent.click(
-            screen.getByRole('buton', { name: 'Select 5 first books' })
+            screen.getByRole('button', { name: 'Select 5 first books' })
         );
         await screen.findByText(
             'Warning: There are too many elements to select them all. Only the first 5 elements were selected.'
@@ -43,7 +43,7 @@ describe('<SelectAllButton />', () => {
         fireEvent.click(screen.getAllByRole('checkbox')[0]);
         await screen.findByText('10 items selected');
         expect(
-            screen.queryByRole('buton', { name: 'Select 5 first books' })
+            screen.queryByRole('button', { name: 'Select 5 first books' })
         ).toBeNull();
     });
 });

From 97a338e3230378fc14ded99a246ed7e90e726d00 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 6 Dec 2024 17:21:46 +0100
Subject: [PATCH 054/146] remove old structure with `selectAllLimit`

---
 docs/List.md                                  | 15 -----------
 docs/ReferenceManyField.md                    | 13 ----------
 .../field/ReferenceManyField.stories.tsx      |  4 +--
 .../src/controller/list/useListController.ts  |  1 -
 .../src/field/ReferenceManyField.stories.tsx  | 16 ------------
 .../src/list/BulkActionsToolbar.tsx           |  1 -
 .../src/list/InfiniteList.stories.tsx         | 17 -------------
 .../src/list/List.stories.tsx                 | 25 -------------------
 8 files changed, 1 insertion(+), 91 deletions(-)

diff --git a/docs/List.md b/docs/List.md
index a99256788ea..9849282192b 100644
--- a/docs/List.md
+++ b/docs/List.md
@@ -71,7 +71,6 @@ You can find more advanced examples of `<List>` usage in the [demos](./Demos.md)
 | `perPage`                 | Optional | `number`       | `10`           | The number of records to fetch per page.                                                     |
 | `queryOptions`            | Optional | `object`       | -              | The options to pass to the `useQuery` hook.                                                  |
 | `resource`                | Optional | `string`       | -              | The resource name, e.g. `posts`.                                                             |
-| `selectAllLimit`          | Optional | `number`       | -              | The maximum number of items selected by the "SELECT ALL" button of the bulk actions toolbar.         |
 | `sort`                    | Optional | `object`       | -              | The initial sort parameters.                                                                 |
 | `storeKey`                | Optional | `string | false` | -           | The key to use to store the current filter & sort. Pass `false` to disable store synchronization |
 | `title`                   | Optional | `string | ReactElement | false` | -              | The title to display in the App Bar.                                                         |
@@ -875,20 +874,6 @@ export const UsersList = () => (
 );
 ```
 
-## `selectAllLimit`
-
-By default, the "SELECT ALL" button of the `<Datagrid>`'s bulk actions toolbar select all records up to 250 items. You can customize the limit by passing a `selectAllLimit` prop to the `<List>` component
-
-```jsx
-export const UsersList = () => (
-    <List selectAllLimit={2000}>
-        <Datagrid>
-            ...
-        </Datagrid>
-    </List>
-);
-```
-
 ## `sort`
 
 Pass an object literal as the `sort` prop to determine the default `field` and `order` used for sorting:
diff --git a/docs/ReferenceManyField.md b/docs/ReferenceManyField.md
index d6c0aadae9e..1ee01a71182 100644
--- a/docs/ReferenceManyField.md
+++ b/docs/ReferenceManyField.md
@@ -91,7 +91,6 @@ This example leverages [`<SingleFieldList>`](./SingleFieldList.md) to display an
 | `perPage`      | Optional | `number`                                                                          | 25                               | Maximum number of referenced records to fetch                                       |
 | `queryOptions` | Optional | [`UseQuery Options`](https://tanstack.com/query/v3/docs/react/reference/useQuery) | `{}`                             | `react-query` options for the `getMany` query                                       |
 | `reference`    | Required | `string`                                                                          | -                                | The name of the resource for the referenced records, e.g. 'books'                   |
-| `selectAllLimit` | Optional | `number`                                                                        | -                                | The maximum number of items selected by the "SELECT ALL" button of the bulk actions toolbar.         |
 | `sort`         | Optional | `{ field, order }`                                                                | `{ field: 'id', order: 'DESC' }` | Sort order to use when fetching the related records, passed to `getManyReference()` |
 | `source`       | Optional | `string`                                                                          | `id`                             | Target field carrying the relationship on the source record (usually 'id')          |
 | `storeKey`     | Optional | `string`                                                                          | -                                | The key to use to store the records selection state                                 |
@@ -273,18 +272,6 @@ For instance, if you want to display the `books` of a given `author`, the `refer
 </ReferenceManyField>
 ```
 
-## `selectAllLimit`
-
-By default, the "SELECT ALL" button of the `<Datagrid>`'s bulk actions toolbar select all records up to 250 items. You can customize the limit by passing a `selectAllLimit` prop to the `<ReferenceManyField>` component
-
-```jsx
-<ReferenceManyField selectAllLimit={2000} reference="comments" target="post_id">
-  <Datagrid>
-    ...
-  </Datagrid>
-</ReferenceManyField>
-```
-
 ## `sort`
 
 By default, it orders the possible values by id desc. You can change this order by setting the `sort` prop (an object with `field` and `order` properties).
diff --git a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
index 3ff24b50a66..724357ba498 100644
--- a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
@@ -30,9 +30,7 @@ const ReferenceManyFieldController = props => {
     return children(controllerProps);
 };
 
-const ReferenceManyFieldComponent = (
-    props: ListControllerResult & { selectAllLimit?: number }
-) => (
+const ReferenceManyFieldComponent = (props: ListControllerResult) => (
     <div>
         <div
             style={{
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index e93d9352303..2ab1d8e4cc7 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -14,7 +14,6 @@ import { useResourceContext, useGetResourceLabel } from '../../core';
 import { useRecordSelection } from './useRecordSelection';
 import { useListParams } from './useListParams';
 import { SORT_ASC } from './queryReducer';
-import { useSelectAll } from './useSelectAll';
 
 /**
  * Prepare data for the List view
diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
index d54f482a511..98987eec28f 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
@@ -187,10 +187,8 @@ export const StoreKey = () => (
 
 export const WithPagination = ({
     dataProvider = fullDataProvider,
-    selectAllLimit,
 }: {
     dataProvider?: AdminProps['dataProvider'];
-    selectAllLimit?: number;
 }) => (
     <Wrapper
         i18nProvider={polyglotI18nProvider(() => englishMessages)}
@@ -202,7 +200,6 @@ export const WithPagination = ({
             target="author_id"
             pagination={<Pagination />}
             perPage={5}
-            selectAllLimit={selectAllLimit}
         >
             <Datagrid>
                 <TextField source="title" />
@@ -211,19 +208,6 @@ export const WithPagination = ({
     </Wrapper>
 );
 
-export const WithPaginationAndSelectAllLimit = ({
-    dataProvider,
-    selectAllLimit = 6,
-}: {
-    dataProvider?: AdminProps['dataProvider'];
-    selectAllLimit?: number;
-}) => (
-    <WithPagination
-        selectAllLimit={selectAllLimit}
-        dataProvider={dataProvider}
-    />
-);
-
 const AuthorEdit = () => (
     <Edit>
         <SimpleForm>
diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index 5be7846eaf0..29073cef331 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -65,7 +65,6 @@ export interface BulkActionsToolbarProps {
     children?: ReactNode;
     label?: string;
     className?: string;
-    selectAllLimit?: number;
 }
 
 const PREFIX = 'RaBulkActionsToolbar';
diff --git a/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx b/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
index 39d4be0f1ed..c3fb1a68f57 100644
--- a/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
@@ -362,23 +362,6 @@ export const WithDatagrid = () => (
     </Admin>
 );
 
-export const WithDatagridAndSelectAllLimit = () => (
-    <Admin dataProvider={dataProvider}>
-        <Resource
-            name="books"
-            list={() => (
-                <InfiniteList selectAllLimit={22}>
-                    <Datagrid>
-                        <TextField source="id" />
-                        <TextField source="title" />
-                        <TextField source="author" />
-                    </Datagrid>
-                </InfiniteList>
-            )}
-        />
-    </Admin>
-);
-
 const BookActions = () => (
     <TopToolbar>
         <SortButton fields={['id', 'title']} />
diff --git a/packages/ra-ui-materialui/src/list/List.stories.tsx b/packages/ra-ui-materialui/src/list/List.stories.tsx
index 4583c30033e..68682d290a3 100644
--- a/packages/ra-ui-materialui/src/list/List.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/List.stories.tsx
@@ -296,31 +296,6 @@ export const HasCreate = () => (
     </TestMemoryRouter>
 );
 
-export const SelectAllLimit = ({
-    dataProvider = defaultDataProvider,
-    selectAllLimit = 11,
-    children,
-}) => (
-    <TestMemoryRouter initialEntries={['/books']}>
-        <Admin dataProvider={dataProvider}>
-            <Resource
-                name="books"
-                list={() => (
-                    <List selectAllLimit={selectAllLimit}>
-                        <Datagrid>
-                            <TextField source="id" />
-                            <TextField source="title" />
-                            <TextField source="author" />
-                            <TextField source="year" />
-                        </Datagrid>
-                        {children}
-                    </List>
-                )}
-            />
-        </Admin>
-    </TestMemoryRouter>
-);
-
 const AsideComponent = () => <Card sx={{ padding: 2 }}>Aside</Card>;
 
 export const Aside = () => (

From 472b81be975a088e4337d5067a61536dde0a3ca1 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 22:44:47 +0100
Subject: [PATCH 055/146] change (again) the structure to have a button and
 logic in hooks

---
 docs/Buttons.md                               |  10 ++
 .../field/useReferenceManyFieldController.ts  |  76 +++++++++-
 .../src/controller/list/ListContext.tsx       |   1 +
 .../list/useInfiniteListController.ts         |  16 +-
 .../ra-core/src/controller/list/useList.ts    |   6 +
 .../list/useListContextWithProps.ts           |   3 +
 .../src/controller/list/useListController.ts  |  12 ++
 .../src/controller/list/useSelectAll.tsx      | 141 +++++++++++-------
 .../src/button/SelectAllButton.tsx            |  29 +++-
 9 files changed, 220 insertions(+), 74 deletions(-)

diff --git a/docs/Buttons.md b/docs/Buttons.md
index d048b891fe1..ffd0c6d1919 100644
--- a/docs/Buttons.md
+++ b/docs/Buttons.md
@@ -981,6 +981,16 @@ By default, `<SelectAllButton>` select the 250 first items of your list. To cust
 const PostSelectAllButton = () => <SelectAllButton limit={100} />;
 ```
 
+### `queryOptions`
+
+`<SelectAllButton>` calls a `get` method of your `dataProvider` via a react-query's hook. You can customize the options you pass to this hook, e.g. to pass [a custom `meta`](./Actions.md#meta-parameter) to the call.
+
+{% raw %}
+```jsx
+const PostSelectAllButton = () => <SelectAllButton queryOptions={{ meta: { foo: 'bar' } }} />;
+```
+{% endraw %}
+
 ### `sx`: CSS API
 
 To override the style of all instances of `<SelectAllButton>` components using the [application-wide style overrides](./AppTheme.md#theming-individual-components), use the `RaSelectAllButton` key.
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 06a8bb99e31..f82bdefb8e9 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -1,14 +1,14 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { UseQueryOptions } from '@tanstack/react-query';
+import { useQueryClient, UseQueryOptions } from '@tanstack/react-query';
 import get from 'lodash/get';
 import isEqual from 'lodash/isEqual';
 import lodashDebounce from 'lodash/debounce';
 
 import { removeEmpty } from '../../util';
-import { useGetManyReference } from '../../dataProvider';
+import { useDataProvider, useGetManyReference } from '../../dataProvider';
 import { useNotify } from '../../notification';
 import { FilterPayload, Identifier, RaRecord, SortPayload } from '../../types';
-import { ListControllerResult } from '../list';
+import type { ListControllerResult, onSelectAllProps } from '../list';
 import usePaginationState from '../usePaginationState';
 import { useRecordSelection } from '../list/useRecordSelection';
 import useSortState from '../useSortState';
@@ -67,6 +67,8 @@ export const useReferenceManyFieldController = <
     } = props;
     const notify = useNotify();
     const resource = useResourceContext(props);
+    const dataProvider = useDataProvider();
+    const queryClient = useQueryClient();
     const storeKey = props.storeKey ?? `${resource}.${record?.id}.${reference}`;
     const { meta, ...otherQueryOptions } = queryOptions;
 
@@ -200,6 +202,73 @@ export const useReferenceManyFieldController = <
         }
     );
 
+    const onSelectAll = useCallback(
+        async ({ queryOptions = {}, limit = 250 }: onSelectAllProps) => {
+            const { meta, onSuccess, onError } = queryOptions;
+            try {
+                const results = await queryClient.fetchQuery({
+                    queryKey: [
+                        resource,
+                        'getManyReference',
+                        {
+                            resource,
+                            pagination: { page: 1, perPage: limit },
+                            sort,
+                            filter,
+                            meta,
+                        },
+                    ],
+                    queryFn: () =>
+                        dataProvider.getManyReference(reference, {
+                            target,
+                            id: get(record, source) as Identifier,
+                            pagination: {
+                                page: 1,
+                                perPage: limit,
+                            },
+                            sort,
+                            filter,
+                            meta,
+                        }),
+                });
+
+                const allIds = results.data?.map(({ id }) => id) || [];
+                selectionModifiers.select(allIds);
+                if (allIds.length === limit) {
+                    notify('ra.message.too_many_elements', {
+                        messageArgs: { max: limit },
+                        type: 'warning',
+                    });
+                }
+
+                if (onSuccess) {
+                    onSuccess(results);
+                }
+
+                return results.data;
+            } catch (error) {
+                if (onError) {
+                    onError(error);
+                }
+                console.error('Mutation Error: ', error);
+                notify('An error occurred. Please try again.');
+            }
+        },
+        [
+            queryClient,
+            resource,
+            sort,
+            filter,
+            selectionModifiers,
+            dataProvider,
+            reference,
+            target,
+            record,
+            source,
+            notify,
+        ]
+    );
+
     return {
         sort,
         data,
@@ -213,6 +282,7 @@ export const useReferenceManyFieldController = <
         isLoading,
         isPending,
         onSelect: selectionModifiers.select,
+        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page,
diff --git a/packages/ra-core/src/controller/list/ListContext.tsx b/packages/ra-core/src/controller/list/ListContext.tsx
index f4af11d4495..5a86604cffb 100644
--- a/packages/ra-core/src/controller/list/ListContext.tsx
+++ b/packages/ra-core/src/controller/list/ListContext.tsx
@@ -25,6 +25,7 @@ import { ListControllerResult } from './useListController';
  * @prop {Function} hideFilter a callback to hide one of the filters, e.g. hideFilter('title')
  * @prop {Array}    selectedIds an array listing the ids of the selected rows, e.g. [123, 456]
  * @prop {Function} onSelect callback to change the list of selected rows, e.g. onSelect([456, 789])
+ * @prop {Function} onSelectAll callback to select all the records, e.g. onSelectAll()
  * @prop {Function} onToggleItem callback to toggle the selection of a given record based on its id, e.g. onToggleItem(456)
  * @prop {Function} onUnselectItems callback to clear the selection, e.g. onUnselectItems();
  * @prop {string}   defaultTitle the translated title based on the resource, e.g. 'Posts'
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index b91bc07066c..0ead8e857e1 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -1,5 +1,5 @@
 import { isValidElement, useEffect, useMemo } from 'react';
-import {
+import type {
     InfiniteQueryObserverBaseResult,
     InfiniteData,
 } from '@tanstack/react-query';
@@ -8,11 +8,11 @@ import { useAuthenticated, useRequireAccess } from '../../auth';
 import { useTranslate } from '../../i18n';
 import { useNotify } from '../../notification';
 import {
-    UseInfiniteGetListOptions,
+    type UseInfiniteGetListOptions,
     useInfiniteGetList,
 } from '../../dataProvider';
 import { defaultExporter } from '../../export';
-import {
+import type {
     RaRecord,
     SortPayload,
     FilterPayload,
@@ -22,8 +22,8 @@ import {
 import { useResourceContext, useGetResourceLabel } from '../../core';
 import { useRecordSelection } from './useRecordSelection';
 import { useListParams } from './useListParams';
-
-import { ListControllerResult } from './useListController';
+import { useSelectAll } from './useSelectAll';
+import type { ListControllerResult } from './useListController';
 
 /**
  * Prepare data for the InfiniteList view
@@ -139,6 +139,11 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         }
     );
 
+    const onSelectAll = useSelectAll({
+        sort: { field: query.sort, order: query.order },
+        filter: { ...query.filter, ...filter },
+    });
+
     // change page if there is no data
     useEffect(() => {
         if (
@@ -194,6 +199,7 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
         isLoading,
         isPending,
         onSelect: selectionModifiers.select,
+        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page: query.page,
diff --git a/packages/ra-core/src/controller/list/useList.ts b/packages/ra-core/src/controller/list/useList.ts
index 8ad6337c903..8adbca41593 100644
--- a/packages/ra-core/src/controller/list/useList.ts
+++ b/packages/ra-core/src/controller/list/useList.ts
@@ -268,6 +268,11 @@ export const useList = <RecordType extends RaRecord = any>(
         }
     }, [isPending, pendingState, setPendingState]);
 
+    const onSelectAll = useCallback(() => {
+        const allIds = data?.map(({ id }) => id) || [];
+        selectionModifiers.select(allIds);
+    }, [data, selectionModifiers]);
+
     return {
         sort,
         data: pendingState ? undefined : finalItems?.data ?? [],
@@ -285,6 +290,7 @@ export const useList = <RecordType extends RaRecord = any>(
         isLoading: loadingState,
         isPending: pendingState,
         onSelect: selectionModifiers.select,
+        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page,
diff --git a/packages/ra-core/src/controller/list/useListContextWithProps.ts b/packages/ra-core/src/controller/list/useListContextWithProps.ts
index 206be897b56..12afb5b5e0f 100644
--- a/packages/ra-core/src/controller/list/useListContextWithProps.ts
+++ b/packages/ra-core/src/controller/list/useListContextWithProps.ts
@@ -34,6 +34,7 @@ import { RaRecord } from '../../types';
  * @prop {Function} hideFilter a callback to hide one of the filters, e.g. hideFilter('title')
  * @prop {Array}    selectedIds an array listing the ids of the selected rows, e.g. [123, 456]
  * @prop {Function} onSelect callback to change the list of selected rows, e.g. onSelect([456, 789])
+ * @prop {Function} onSelectAll callback to select all the records, e.g. onSelectAll({ limit: 50, queryOptions: { meta: { foo: 'bar' } } })
  * @prop {Function} onToggleItem callback to toggle the selection of a given record based on its id, e.g. onToggleItem(456)
  * @prop {Function} onUnselectItems callback to clear the selection, e.g. onUnselectItems();
  * @prop {string}   defaultTitle the translated title based on the resource, e.g. 'Posts'
@@ -81,6 +82,7 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     isLoading,
     isPending,
     onSelect,
+    onSelectAll,
     onToggleItem,
     onUnselectItems,
     page,
@@ -107,6 +109,7 @@ const extractListContextProps = <RecordType extends RaRecord = any>({
     isLoading,
     isPending,
     onSelect,
+    onSelectAll,
     onToggleItem,
     onUnselectItems,
     page,
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index 2ab1d8e4cc7..123be257355 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -13,6 +13,7 @@ import { FilterPayload, SortPayload, RaRecord, Exporter } from '../../types';
 import { useResourceContext, useGetResourceLabel } from '../../core';
 import { useRecordSelection } from './useRecordSelection';
 import { useListParams } from './useListParams';
+import { useSelectAll } from './useSelectAll';
 import { SORT_ASC } from './queryReducer';
 
 /**
@@ -168,6 +169,11 @@ export const useListController = <RecordType extends RaRecord = any>(
         name: getResourceLabel(resource, 2),
     });
 
+    const onSelectAll = useSelectAll({
+        sort: { field: query.sort, order: query.order },
+        filter: { ...query.filter, ...filter },
+    });
+
     return {
         sort: currentSort,
         data,
@@ -183,6 +189,7 @@ export const useListController = <RecordType extends RaRecord = any>(
         isLoading,
         isPending,
         onSelect: selectionModifiers.select,
+        onSelectAll,
         onToggleItem: selectionModifiers.toggle,
         onUnselectItems: selectionModifiers.clearSelection,
         page: query.page,
@@ -431,6 +438,7 @@ export const injectedProps = [
     'isLoading',
     'isPending',
     'onSelect',
+    'onSelectAll',
     'onToggleItem',
     'onUnselectItems',
     'page',
@@ -475,6 +483,10 @@ export interface ListControllerBaseResult<RecordType extends RaRecord = any> {
     filterValues: any;
     hideFilter: (filterName: string) => void;
     onSelect: (ids: RecordType['id'][]) => void;
+    onSelectAll: (options?: {
+        limit?: number;
+        queryOptions?: UseGetListOptions<RecordType>;
+    }) => void;
     onToggleItem: (id: RecordType['id']) => void;
     onUnselectItems: () => void;
     page: number;
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 82dfcff9050..eb3d50cb30c 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -1,92 +1,117 @@
+import { useCallback } from 'react';
 import { useQueryClient } from '@tanstack/react-query';
+
 import { useNotify } from '../../notification';
-import { useDataProvider } from '../../dataProvider';
+import { useDataProvider, UseGetListOptions } from '../../dataProvider';
 import { useRecordSelection } from './useRecordSelection';
-import type { FilterPayload, SortPayload } from '../../types';
 import { useResourceContext } from '../../core';
+import type { FilterPayload, RaRecord, SortPayload } from '../../types';
 
 /**
- * Function hook to select all items of a list (until we reached the selectAllLimit)
+ * Function hook to select all items of a list (until we reached the limit)
  *
- * @param {SortPayload} sort Optional. The sort parameter to apply to the getList query
- * @param {FilterPayload} filter Optional. Permanent filter applied to all getList queries, regardless of the user selected filters
- * @param {any} meta Optional. Additional meta data to pass to the dataProvider
- * @param {number} limit Optional. The number of items selected by the "SELECT ALL" button of the bulk actions toolbar
+ * @param {SortPayload} sort Optional. The sort object passed to the dataProvider
+ * @param {FilterPayload} filter Optional. The filter object passed to the dataProvider
  * @returns {Function} onSelectAll A function to select all items of a list
  *
  * @example
  *
- * const onSelectAll = useSelectAll({
- *     sort: { sort: 'title', order: 'ASC' },
- *     limit: 250,
- * });
- * return <Button onClick={onSelectAll}>Select All</Button>;
+ * const MyButton = () => {
+ *   const onSelectAll = useSelectAll({
+ *       sort: { field: 'title', order: 'ASC' },
+ *       filter: { title: 'foo' },
+ *   });
+ *   const handleClick = () => onSelectAll({
+ *       queryOptions: { meta: { foo: 'bar' } },
+ *       limit: 250,
+ *   });
+ *   return <Button onClick={handleClick}>Select All</Button>;
+ * };
  */
 export const useSelectAll = ({
-    sort = { field: 'id', order: 'ASC' },
-    filter = {},
-    meta = {},
-    limit = 250,
-}: useSelectAllProps): (() => void) => {
+    sort,
+    filter,
+}: useSelectAllProps): ((options?: onSelectAllProps) => void) => {
     const resource = useResourceContext();
     if (!resource) {
         throw new Error(
             'useSelectAll should be used inside a ResourceContextProvider'
         );
     }
-    const notify = useNotify();
+    const [_, selectionModifiers] = useRecordSelection({ resource });
     const dataProvider = useDataProvider();
     const queryClient = useQueryClient();
-    const [_, selectionModifiers] = useRecordSelection({ resource });
+    const notify = useNotify();
 
-    // TODO: useCallback
-    const onSelectAll = async () => {
-        try {
-            const { data } = await queryClient.fetchQuery({
-                queryKey: [
-                    resource,
-                    'getList',
-                    {
+    const onSelectAll = useCallback(
+        async ({ queryOptions = {}, limit = 250 }: onSelectAllProps) => {
+            const { meta, onSuccess, onError } = queryOptions;
+            try {
+                const results = await queryClient.fetchQuery({
+                    queryKey: [
                         resource,
-                        pagination: { page: 1, perPage: limit },
-                        sort,
-                        filter,
-                        meta,
-                    },
-                ],
-                queryFn: () =>
-                    dataProvider.getList(resource, {
-                        pagination: {
-                            page: 1,
-                            perPage: limit,
+                        'getList',
+                        {
+                            resource,
+                            pagination: { page: 1, perPage: limit },
+                            sort,
+                            filter,
+                            meta,
                         },
-                        sort,
-                        filter,
-                        meta,
-                    }),
-            });
-
-            const allIds = data?.map(({ id }) => id) || [];
-            selectionModifiers.select(allIds);
-            if (allIds.length === limit) {
-                notify('ra.message.too_many_elements', {
-                    messageArgs: { max: limit },
-                    type: 'warning',
+                    ],
+                    queryFn: () =>
+                        dataProvider.getList(resource, {
+                            pagination: {
+                                page: 1,
+                                perPage: limit,
+                            },
+                            sort,
+                            filter,
+                            meta,
+                        }),
                 });
-            }
 
-            return data;
-        } catch (error) {
-            console.error('Mutation Error: ', error);
-            notify('An error occurred. Please try again.');
-        }
-    };
+                const allIds = results.data?.map(({ id }) => id) || [];
+                selectionModifiers.select(allIds);
+                if (allIds.length === limit) {
+                    notify('ra.message.too_many_elements', {
+                        messageArgs: { max: limit },
+                        type: 'warning',
+                    });
+                }
+
+                if (onSuccess) {
+                    onSuccess(results);
+                }
+
+                return results.data;
+            } catch (error) {
+                if (onError) {
+                    onError(error);
+                }
+                console.error('Mutation Error: ', error);
+                notify('An error occurred. Please try again.');
+            }
+        },
+        [
+            dataProvider,
+            queryClient,
+            notify,
+            resource,
+            sort,
+            filter,
+            selectionModifiers,
+        ]
+    );
     return onSelectAll;
 };
 
 export interface useSelectAllProps {
     sort?: SortPayload;
     filter?: FilterPayload;
-    meta?: any;
+}
+
+export interface onSelectAllProps<RecordType extends RaRecord = any> {
     limit?: number;
+    queryOptions?: UseGetListOptions<RecordType>;
 }
diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index d35400c21e8..1adad102177 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -1,5 +1,11 @@
 import React, { useCallback } from 'react';
-import { useListContext, useSelectAll } from 'ra-core';
+import {
+    useListContext,
+    type RaRecord,
+    type UseGetListOptions,
+    type UseReferenceArrayFieldControllerParams,
+    type UseReferenceManyFieldControllerParams,
+} from 'ra-core';
 
 import { Button, ButtonProps } from './Button';
 
@@ -9,6 +15,7 @@ import { Button, ButtonProps } from './Button';
  * @typedef {Object} Props the props you can use
  * @prop {string} label Button label. Defaults to 'ra.action.select_all', translated.
  * @prop {string} limit Maximum number of items to select. Defaults to 250.
+ * @prop {function} queryOptions Object of options passed to react-query.
  *
  * @param {Props} props
  *
@@ -24,17 +31,18 @@ export const SelectAllButton = (props: SelectAllButtonProps) => {
         label = 'ra.action.select_all',
         limit = 250,
         onClick,
+        queryOptions,
         ...rest
     } = props;
 
-    const { filter, sort, meta, total, selectedIds } = useListContext();
-    const onSelectAll = useSelectAll({ limit, filter, sort, meta });
+    const { total, selectedIds, onSelectAll } = useListContext();
     const handleSelectAll = useCallback(
         event => {
-            onSelectAll();
+            // @ts-ignore
+            onSelectAll({ limit, queryOptions });
             if (onClick) onClick(event);
         },
-        [onClick, onSelectAll]
+        [onClick, onSelectAll, queryOptions, limit]
     );
 
     if (total === selectedIds.length || selectedIds.length >= limit)
@@ -51,6 +59,11 @@ export const SelectAllButton = (props: SelectAllButtonProps) => {
     );
 };
 
-export type SelectAllButtonProps = ButtonProps & {
-    limit?: number;
-};
+export type SelectAllButtonProps<RecordType extends RaRecord = any> =
+    ButtonProps & {
+        limit?: number;
+        queryOptions?:
+            | UseGetListOptions<RecordType>
+            | UseReferenceArrayFieldControllerParams<RecordType>['queryOptions']
+            | UseReferenceManyFieldControllerParams<RecordType>['queryOptions'];
+    };

From 447d7933feb9582fa9be4f1887a592b2d93a0c68 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 23:10:57 +0100
Subject: [PATCH 056/146] ReferenceArrayFieldController -> tests + stories

---
 .../field/ReferenceArrayField.stories.tsx     |  6 +++
 .../useReferenceArrayFieldController.spec.tsx | 54 ++++++++++++++++++-
 2 files changed, 59 insertions(+), 1 deletion(-)

diff --git a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
index dd9cb01f1a4..14a6894a4a3 100644
--- a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
+++ b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
@@ -38,6 +38,12 @@ const ReferenceArrayFieldComponent = (props: ListControllerResult) => (
                 gap: '10px',
             }}
         >
+            <button
+                onClick={() => props.onSelectAll()}
+                disabled={props.total === props.selectedIds.length}
+            >
+                Select All
+            </button>
             <button
                 onClick={props.onUnselectItems}
                 disabled={props.selectedIds.length === 0}
diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 0a06a926efc..341b419a85e 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -1,10 +1,11 @@
 import * as React from 'react';
 import expect from 'expect';
-import { render, waitFor } from '@testing-library/react';
+import { act, render, waitFor } from '@testing-library/react';
 
 import { useReferenceArrayFieldController } from './useReferenceArrayFieldController';
 import { testDataProvider } from '../../dataProvider';
 import { CoreAdminContext } from '../../core';
+import { ReferenceArrayField } from './ReferenceArrayField.stories';
 
 const ReferenceArrayFieldController = props => {
     const { children, ...rest } = props;
@@ -166,4 +167,55 @@ describe('<useReferenceArrayFieldController />', () => {
             })
         );
     });
+
+    describe('onSelectAll', () => {
+        it('should select all items if no items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
+                    })
+                );
+            });
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [1, 2],
+                    })
+                );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        data: [
+                            { id: 1, title: 'bar1' },
+                            { id: 2, title: 'bar2' },
+                        ],
+                    })
+                );
+            });
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [1, 2],
+                    })
+                );
+            });
+        });
+    });
 });

From 588767ce1749dd56d095d981a211661a4950d064 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 23:11:28 +0100
Subject: [PATCH 057/146] make the callback stronger

---
 .../src/controller/field/useReferenceManyFieldController.ts     | 2 +-
 packages/ra-core/src/controller/list/useSelectAll.tsx           | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index f82bdefb8e9..604650a3dc0 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -203,7 +203,7 @@ export const useReferenceManyFieldController = <
     );
 
     const onSelectAll = useCallback(
-        async ({ queryOptions = {}, limit = 250 }: onSelectAllProps) => {
+        async ({ limit = 250, queryOptions = {} }: onSelectAllProps = {}) => {
             const { meta, onSuccess, onError } = queryOptions;
             try {
                 const results = await queryClient.fetchQuery({
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index eb3d50cb30c..9745012c596 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -44,7 +44,7 @@ export const useSelectAll = ({
     const notify = useNotify();
 
     const onSelectAll = useCallback(
-        async ({ queryOptions = {}, limit = 250 }: onSelectAllProps) => {
+        async ({ queryOptions = {}, limit = 250 }: onSelectAllProps = {}) => {
             const { meta, onSuccess, onError } = queryOptions;
             try {
                 const results = await queryClient.fetchQuery({

From 4573ae9b7ffde1ee3998426253c3cdf1feef4e66 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 23:17:47 +0100
Subject: [PATCH 058/146] ReferenceManyFieldController -> tests + stories

---
 .../field/ReferenceManyField.stories.tsx      | 13 ++-
 .../useReferenceManyFieldController.spec.tsx  | 97 ++++++++++++++++++-
 2 files changed, 108 insertions(+), 2 deletions(-)

diff --git a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
index 724357ba498..f677edc1e4a 100644
--- a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
@@ -1,6 +1,7 @@
 import * as React from 'react';
 import {
     CoreAdminContext,
+    type CoreAdminContextProps,
     type GetManyResult,
     type ListControllerResult,
     testDataProvider,
@@ -39,6 +40,12 @@ const ReferenceManyFieldComponent = (props: ListControllerResult) => (
                 gap: '10px',
             }}
         >
+            <button
+                onClick={() => props.onSelectAll()}
+                disabled={props.total === props.selectedIds.length}
+            >
+                Select All
+            </button>
             <button
                 onClick={props.onUnselectItems}
                 disabled={props.selectedIds.length === 0}
@@ -72,8 +79,12 @@ const ReferenceManyFieldComponent = (props: ListControllerResult) => (
 
 export const ReferenceManyField = ({
     children = ReferenceManyFieldComponent,
+    dataProvider = defaultDataProvider,
+}: {
+    children?: (props: ListControllerResult) => React.ReactNode;
+    dataProvider?: CoreAdminContextProps['dataProvider'];
 }) => (
-    <CoreAdminContext dataProvider={defaultDataProvider}>
+    <CoreAdminContext dataProvider={dataProvider}>
         <ReferenceManyFieldController
             resource="authors"
             source="id"
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index 64afc5570a4..314c8a40125 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -1,11 +1,18 @@
 import * as React from 'react';
-import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import {
+    act,
+    fireEvent,
+    render,
+    screen,
+    waitFor,
+} from '@testing-library/react';
 import expect from 'expect';
 
 import { testDataProvider } from '../../dataProvider/testDataProvider';
 import { CoreAdminContext } from '../../core';
 import { useReferenceManyFieldController } from './useReferenceManyFieldController';
 import { memoryStore } from '../../store';
+import { ReferenceManyField } from './ReferenceManyField.stories';
 
 const ReferenceManyFieldController = props => {
     const { children, page = 1, perPage = 25, ...rest } = props;
@@ -412,4 +419,92 @@ describe('useReferenceManyFieldController', () => {
             );
         });
     });
+    describe('onSelectAll', () => {
+        it('should select all items if no items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            render(<ReferenceManyField>{children}</ReferenceManyField>);
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            render(<ReferenceManyField>{children}</ReferenceManyField>);
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelect([1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [1],
+                    })
+                );
+            });
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select the maximum items possible until we reached the limit', async () => {
+            const children = jest.fn().mockReturnValue('child');
+            const getManyReference = jest
+                .fn()
+                .mockImplementation((_resource, params) =>
+                    Promise.resolve({
+                        data: [{ id: 0 }, { id: 1 }].slice(
+                            0,
+                            params.pagination.perPage
+                        ),
+                        total: 2,
+                    })
+                );
+            const dataProvider = testDataProvider({
+                getManyReference,
+            });
+            render(
+                <ReferenceManyField dataProvider={dataProvider}>
+                    {children}
+                </ReferenceManyField>
+            );
+            await waitFor(() => {
+                expect(children).toHaveBeenNthCalledWith(
+                    1,
+                    expect.objectContaining({
+                        selectedIds: [],
+                    })
+                );
+            });
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll({ limit: 1 });
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(getManyReference).toHaveBeenCalledWith(
+                    'books',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 1 },
+                    })
+                );
+            });
+        });
+    });
 });

From 98c48c727a4f069ddbb1ce1c84fde8cabb020a9a Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 23:27:29 +0100
Subject: [PATCH 059/146] moove useRecordSelection and useResourceContext logic

---
 .../list/useInfiniteListController.ts          |  2 ++
 .../src/controller/list/useListController.ts   |  2 ++
 .../src/controller/list/useSelectAll.tsx       | 18 +++++++++---------
 3 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index 0ead8e857e1..78f1576c131 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -140,6 +140,8 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
     );
 
     const onSelectAll = useSelectAll({
+        resource,
+        selectionModifiers,
         sort: { field: query.sort, order: query.order },
         filter: { ...query.filter, ...filter },
     });
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index 123be257355..93f994574e9 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -170,6 +170,8 @@ export const useListController = <RecordType extends RaRecord = any>(
     });
 
     const onSelectAll = useSelectAll({
+        resource,
+        selectionModifiers,
         sort: { field: query.sort, order: query.order },
         filter: { ...query.filter, ...filter },
     });
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 9745012c596..d0189a6d900 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -3,13 +3,14 @@ import { useQueryClient } from '@tanstack/react-query';
 
 import { useNotify } from '../../notification';
 import { useDataProvider, UseGetListOptions } from '../../dataProvider';
-import { useRecordSelection } from './useRecordSelection';
-import { useResourceContext } from '../../core';
 import type { FilterPayload, RaRecord, SortPayload } from '../../types';
+import type { UseRecordSelectionResult } from './useRecordSelection';
 
 /**
  * Function hook to select all items of a list (until we reached the limit)
  *
+ * @param {string} resource Required. The resource name
+ * @param {RecordSelectionModifiers} selectionModifiers Required, The selection modifiers
  * @param {SortPayload} sort Optional. The sort object passed to the dataProvider
  * @param {FilterPayload} filter Optional. The filter object passed to the dataProvider
  * @returns {Function} onSelectAll A function to select all items of a list
@@ -17,7 +18,9 @@ import type { FilterPayload, RaRecord, SortPayload } from '../../types';
  * @example
  *
  * const MyButton = () => {
+ *   const [_, selectionModifiers] = useRecordSelection({ resource: 'posts' });
  *   const onSelectAll = useSelectAll({
+ *       selectionModifiers,
  *       sort: { field: 'title', order: 'ASC' },
  *       filter: { title: 'foo' },
  *   });
@@ -29,16 +32,11 @@ import type { FilterPayload, RaRecord, SortPayload } from '../../types';
  * };
  */
 export const useSelectAll = ({
+    resource,
+    selectionModifiers,
     sort,
     filter,
 }: useSelectAllProps): ((options?: onSelectAllProps) => void) => {
-    const resource = useResourceContext();
-    if (!resource) {
-        throw new Error(
-            'useSelectAll should be used inside a ResourceContextProvider'
-        );
-    }
-    const [_, selectionModifiers] = useRecordSelection({ resource });
     const dataProvider = useDataProvider();
     const queryClient = useQueryClient();
     const notify = useNotify();
@@ -107,6 +105,8 @@ export const useSelectAll = ({
 };
 
 export interface useSelectAllProps {
+    resource: string;
+    selectionModifiers: UseRecordSelectionResult[1];
     sort?: SortPayload;
     filter?: FilterPayload;
 }

From 2f1f7db9c32413f058b1d8d10a8ee516901b199b Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 23:27:58 +0100
Subject: [PATCH 060/146] InfiniteListController -> tests + stories

---
 .../list/useInfiniteListController.spec.tsx   | 88 +++++++++++++++++++
 .../useInfiniteListController.stories.tsx     |  6 ++
 2 files changed, 94 insertions(+)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index 10aacf7eeb8..4a6aec545bd 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -22,6 +22,7 @@ import {
 import { CoreAdminContext } from '../../core';
 import { TestMemoryRouter } from '../../routing';
 import {
+    Basic,
     Authenticated,
     CanAccess,
     DisableAuthentication,
@@ -45,6 +46,93 @@ describe('useInfiniteListController', () => {
         debounce: 200,
     };
 
+    const dataProvider = testDataProvider({
+        getList: jest.fn().mockImplementation((_resource, params) =>
+            Promise.resolve({
+                data: [{ id: 0 }, { id: 1 }].slice(
+                    0,
+                    params.pagination.perPage
+                ),
+                total: 2,
+            })
+        ),
+    });
+
+    describe('onSelectAll', () => {
+        it('should select all items if no items are selected', async () => {
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelect([0]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select the maximum items possible until we reached the limit', async () => {
+            const getList = jest.fn().mockImplementation((_resource, params) =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }].slice(
+                        0,
+                        params.pagination.perPage
+                    ),
+                    total: 2,
+                })
+            );
+            const mockedDataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<span>children</span>);
+            render(
+                <Basic dataProvider={mockedDataProvider} children={children} />
+            );
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll({ limit: 1 });
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(getList).toHaveBeenCalledWith(
+                    'posts',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 1 },
+                    })
+                );
+            });
+        });
+    });
+
     describe('queryOptions', () => {
         it('should accept custom client query options', async () => {
             jest.spyOn(console, 'error').mockImplementationOnce(() => {});
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
index d5f0ab67cda..e85141fe36d 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
@@ -79,6 +79,12 @@ const ListWithCheckbox = params => (
                         gap: '10px',
                     }}
                 >
+                    <button
+                        onClick={() => params.onSelectAll()}
+                        disabled={params.total === params.selectedIds.length}
+                    >
+                        Select All
+                    </button>
                     <button
                         onClick={params.onUnselectItems}
                         disabled={params.selectedIds.length === 0}

From ad0a8053599b8325582118c9caa1839b80dab416 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 23:32:21 +0100
Subject: [PATCH 061/146] eListController -> tests + stories

---
 .../list/useListController.spec.tsx           | 85 +++++++++++++++++++
 .../list/useListController.stories.tsx        |  6 ++
 2 files changed, 91 insertions(+)

diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index 25c533febf8..f6f83c4d81b 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -22,6 +22,7 @@ import {
     CanAccess,
     DisableAuthentication,
 } from './useListController.security.stories';
+import { Basic } from './useListController.stories';
 
 describe('useListController', () => {
     const defaultProps = {
@@ -585,4 +586,88 @@ describe('useListController', () => {
             expect(authProvider.checkAuth).not.toHaveBeenCalled();
         });
     });
+
+    describe('onSelectAll', () => {
+        const dataProvider = testDataProvider({
+            getList: jest.fn().mockImplementation((_resource, params) =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }].slice(
+                        0,
+                        params.pagination.perPage
+                    ),
+                    total: 2,
+                })
+            ),
+        });
+        it('should select all items if no items are selected', async () => {
+            const children = jest.fn().mockReturnValue(<></>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const children = jest.fn().mockReturnValue(<></>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelect([0]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select the maximum items possible until we reached the limit', async () => {
+            const getList = jest.fn().mockImplementation((_resource, params) =>
+                Promise.resolve({
+                    data: [{ id: 0 }, { id: 1 }].slice(
+                        0,
+                        params.pagination.perPage
+                    ),
+                    total: 2,
+                })
+            );
+            const dataProvider = testDataProvider({ getList });
+            const children = jest.fn().mockReturnValue(<></>);
+            render(<Basic dataProvider={dataProvider} children={children} />);
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll({ limit: 1 });
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0],
+                    })
+                );
+            });
+            await waitFor(() => {
+                expect(getList).toHaveBeenCalledWith(
+                    'posts',
+                    expect.objectContaining({
+                        pagination: { page: 1, perPage: 1 },
+                    })
+                );
+            });
+        });
+    });
 });
diff --git a/packages/ra-core/src/controller/list/useListController.stories.tsx b/packages/ra-core/src/controller/list/useListController.stories.tsx
index 9e9ae4c547e..0918ff9ac21 100644
--- a/packages/ra-core/src/controller/list/useListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useListController.stories.tsx
@@ -34,6 +34,12 @@ const List = params => (
                 gap: '10px',
             }}
         >
+            <button
+                onClick={() => params.onSelectAll()}
+                disabled={params.total === params.selectedIds.length}
+            >
+                Select All
+            </button>
             <button
                 onClick={params.onUnselectItems}
                 disabled={params.selectedIds.length === 0}

From c658335834b05dc337a2f56f6d67f4fc8739773e Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 23:32:32 +0100
Subject: [PATCH 062/146] test useList

---
 .../src/controller/list/useList.spec.tsx      | 45 ++++++++++++++++++-
 1 file changed, 44 insertions(+), 1 deletion(-)

diff --git a/packages/ra-core/src/controller/list/useList.spec.tsx b/packages/ra-core/src/controller/list/useList.spec.tsx
index 5d96aada58e..d4e6e122224 100644
--- a/packages/ra-core/src/controller/list/useList.spec.tsx
+++ b/packages/ra-core/src/controller/list/useList.spec.tsx
@@ -3,7 +3,7 @@ import { ReactNode } from 'react';
 import expect from 'expect';
 
 import { useList, UseListOptions, UseListValue } from './useList';
-import { fireEvent, render, waitFor } from '@testing-library/react';
+import { act, fireEvent, render, waitFor } from '@testing-library/react';
 import { ListContextProvider } from './ListContextProvider';
 import { useListContext } from './useListContext';
 
@@ -315,4 +315,47 @@ describe('<useList />', () => {
             );
         });
     });
+
+    describe('onSelectAll', () => {
+        it('should select all items if no items are selected', async () => {
+            const children = jest.fn();
+            const data = [{ id: 0 }, { id: 1 }];
+            render(<UseList data={data} callback={children} />);
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+        it('should select all items if some items are selected', async () => {
+            const children = jest.fn();
+            const data = [{ id: 0 }, { id: 1 }];
+            render(<UseList data={data} callback={children} />);
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelect([1]);
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [1],
+                    })
+                );
+            });
+            act(() => {
+                children.mock.calls.at(-1)[0].onSelectAll();
+            });
+            await waitFor(() => {
+                expect(children).toHaveBeenCalledWith(
+                    expect.objectContaining({
+                        selectedIds: [0, 1],
+                    })
+                );
+            });
+        });
+    });
 });

From 420cfade2bf4c3955116a10b7a61f7dd4c99e592 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 23:44:58 +0100
Subject: [PATCH 063/146] ReferenceManyField -> tests + stories

---
 .../src/field/ReferenceManyField.spec.tsx     |  4 +--
 .../src/field/ReferenceManyField.stories.tsx  | 31 +++++++++++++++++--
 2 files changed, 31 insertions(+), 4 deletions(-)

diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
index a7d40bd6aab..19edb0ced87 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
@@ -332,10 +332,10 @@ describe('<ReferenceManyField />', () => {
                 screen.queryByRole('button', { name: 'Select all' })
             ).toBeNull();
         });
-        it('should not be displayed if we reached de selectAllLimit by a manyally selection', async () => {
+        it('should not be displayed if we reached de limit by a manyally selection', async () => {
             render(
                 <WithPaginationAndSelectAllLimit
-                    selectAllLimit={2}
+                    limit={2}
                     dataProvider={testDataProvider({
                         getManyReference: () =>
                             Promise.resolve<any>({
diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
index 98987eec28f..9bd00f5facb 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
@@ -6,7 +6,13 @@ import {
     ResourceContextProvider,
     TestMemoryRouter,
 } from 'ra-core';
-import { Admin, AdminProps, ListGuesser, Resource } from 'react-admin';
+import {
+    Admin,
+    AdminProps,
+    type DatagridProps,
+    ListGuesser,
+    Resource,
+} from 'react-admin';
 import { ThemeProvider, Box, Stack } from '@mui/material';
 import { createTheme } from '@mui/material/styles';
 import fakeDataProvider from 'ra-data-fakerest';
@@ -22,6 +28,7 @@ import { FilterForm } from '../list';
 import { TextInput } from '../input';
 import { Edit } from '../detail';
 import { SimpleForm } from '../form';
+import { SelectAllButton, BulkDeleteButton } from '../button';
 
 export default { title: 'ra-ui-materialui/fields/ReferenceManyField' };
 
@@ -187,8 +194,10 @@ export const StoreKey = () => (
 
 export const WithPagination = ({
     dataProvider = fullDataProvider,
+    bulkActionButtons,
 }: {
     dataProvider?: AdminProps['dataProvider'];
+    bulkActionButtons?: DatagridProps['bulkActionButtons'];
 }) => (
     <Wrapper
         i18nProvider={polyglotI18nProvider(() => englishMessages)}
@@ -201,13 +210,31 @@ export const WithPagination = ({
             pagination={<Pagination />}
             perPage={5}
         >
-            <Datagrid>
+            <Datagrid bulkActionButtons={bulkActionButtons}>
                 <TextField source="title" />
             </Datagrid>
         </ReferenceManyField>
     </Wrapper>
 );
 
+export const WithPaginationAndSelectAllLimit = ({
+    dataProvider,
+    limit = 6,
+}: {
+    dataProvider?: AdminProps['dataProvider'];
+    limit?: number;
+}) => (
+    <WithPagination
+        bulkActionButtons={
+            <>
+                <SelectAllButton limit={limit} />
+                <BulkDeleteButton />
+            </>
+        }
+        dataProvider={dataProvider}
+    />
+);
+
 const AuthorEdit = () => (
     <Edit>
         <SimpleForm>

From 7401122e8a0a78df98869eacad13ff7156162d77 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 23:46:35 +0100
Subject: [PATCH 064/146] InfiniteList -> limit -> stories

---
 .../src/list/InfiniteList.stories.tsx         | 27 ++++++++++++++++---
 1 file changed, 23 insertions(+), 4 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx b/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
index c3fb1a68f57..3f530d4b68e 100644
--- a/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
@@ -12,7 +12,7 @@ import { Box, Button, Card, Typography } from '@mui/material';
 
 import { InfiniteList } from './InfiniteList';
 import { SimpleList } from './SimpleList';
-import { Datagrid } from './datagrid';
+import { Datagrid, type DatagridProps } from './datagrid';
 import {
     InfinitePagination,
     Pagination as DefaultPagination,
@@ -21,7 +21,7 @@ import { AdminUI } from '../AdminUI';
 import { AdminContext } from '../AdminContext';
 import { TextField } from '../field';
 import { SearchInput } from '../input';
-import { SortButton } from '../button';
+import { BulkDeleteButton, SelectAllButton, SortButton } from '../button';
 import { TopToolbar, Layout } from '../layout';
 
 export default {
@@ -345,13 +345,17 @@ export const WithFooter = () => (
     </Admin>
 );
 
-export const WithDatagrid = () => (
+export const WithDatagrid = ({
+    bulkActionButtons,
+}: {
+    bulkActionButtons?: DatagridProps['bulkActionButtons'];
+}) => (
     <Admin dataProvider={dataProvider}>
         <Resource
             name="books"
             list={() => (
                 <InfiniteList>
-                    <Datagrid>
+                    <Datagrid bulkActionButtons={bulkActionButtons}>
                         <TextField source="id" />
                         <TextField source="title" />
                         <TextField source="author" />
@@ -362,6 +366,21 @@ export const WithDatagrid = () => (
     </Admin>
 );
 
+export const WithDatagridAndSelectAllLimit = ({
+    limit = 6,
+}: {
+    limit?: number;
+}) => (
+    <WithDatagrid
+        bulkActionButtons={
+            <>
+                <SelectAllButton limit={limit} />
+                <BulkDeleteButton />
+            </>
+        }
+    />
+);
+
 const BookActions = () => (
     <TopToolbar>
         <SortButton fields={['id', 'title']} />

From 1e41bc3943eb3ebaa4ec90d6d1a22b36887a05b7 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Sun, 8 Dec 2024 23:53:07 +0100
Subject: [PATCH 065/146] List -> tests + stories

---
 .../ra-ui-materialui/src/list/List.spec.tsx   |  4 +-
 .../src/list/List.stories.tsx                 | 38 +++++++++++++++++--
 2 files changed, 36 insertions(+), 6 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/List.spec.tsx b/packages/ra-ui-materialui/src/list/List.spec.tsx
index edaa03b1a29..8433b1ce3ab 100644
--- a/packages/ra-ui-materialui/src/list/List.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/List.spec.tsx
@@ -425,10 +425,10 @@ describe('<List />', () => {
                 screen.queryByRole('button', { name: 'Select all' })
             ).toBeNull();
         });
-        it('should not be displayed if we reached the selectAllLimit by a manual selection', async () => {
+        it('should not be displayed if we reached the limit by a manual selection', async () => {
             render(
                 <SelectAllLimit
-                    selectAllLimit={2}
+                    limit={2}
                     dataProvider={testDataProvider({
                         getList: () =>
                             Promise.resolve<any>({
diff --git a/packages/ra-ui-materialui/src/list/List.stories.tsx b/packages/ra-ui-materialui/src/list/List.stories.tsx
index 68682d290a3..afd4c307599 100644
--- a/packages/ra-ui-materialui/src/list/List.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/List.stories.tsx
@@ -13,12 +13,12 @@ import { Box, Card, Typography, Button, Link as MuiLink } from '@mui/material';
 import { List } from './List';
 import { SimpleList } from './SimpleList';
 import { ListActions } from './ListActions';
-import { Datagrid } from './datagrid';
+import { Datagrid, DatagridProps } from './datagrid';
 import { TextField } from '../field';
 import { SearchInput, TextInput } from '../input';
 import { Route } from 'react-router';
 import { Link } from 'react-router-dom';
-import { ListButton } from '../button';
+import { BulkDeleteButton, ListButton, SelectAllButton } from '../button';
 import { ShowGuesser } from '../detail';
 import TopToolbar from '../layout/TopToolbar';
 
@@ -466,14 +466,22 @@ export const Meta = () => (
     </TestMemoryRouter>
 );
 
-export const Default = ({ dataProvider = defaultDataProvider, children }) => (
+export const Default = ({
+    dataProvider = defaultDataProvider,
+    children,
+    bulkActionButtons,
+}: {
+    dataProvider?: DataProvider;
+    children?: React.ReactNode;
+    bulkActionButtons?: DatagridProps['bulkActionButtons'];
+}) => (
     <TestMemoryRouter initialEntries={['/books']}>
         <Admin dataProvider={dataProvider}>
             <Resource
                 name="books"
                 list={() => (
                     <List filters={[<SearchInput source="q" alwaysOn />]}>
-                        <Datagrid>
+                        <Datagrid bulkActionButtons={bulkActionButtons}>
                             <TextField source="id" />
                             <TextField source="title" />
                             <TextField source="author" />
@@ -487,6 +495,28 @@ export const Default = ({ dataProvider = defaultDataProvider, children }) => (
     </TestMemoryRouter>
 );
 
+export const SelectAllLimit = ({
+    dataProvider,
+    children,
+    limit = 11,
+}: {
+    dataProvider?: DataProvider;
+    children?: React.ReactNode;
+    limit?: number;
+}) => (
+    <Default
+        bulkActionButtons={
+            <>
+                <SelectAllButton limit={limit} />
+                <BulkDeleteButton />
+            </>
+        }
+        dataProvider={dataProvider}
+    >
+        {children}
+    </Default>
+);
+
 const NewerBooks = () => (
     <List
         resource="books"

From c18a232d6b8c344da17f22c67ab09ad113571b33 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 14:05:54 +0100
Subject: [PATCH 066/146] Improve documentation sentences

---
 docs/Buttons.md                                          | 8 ++++----
 packages/ra-core/src/controller/list/useSelectAll.tsx    | 2 +-
 packages/ra-ui-materialui/src/button/SelectAllButton.tsx | 4 +++-
 3 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/docs/Buttons.md b/docs/Buttons.md
index ffd0c6d1919..c0c67bc981f 100644
--- a/docs/Buttons.md
+++ b/docs/Buttons.md
@@ -959,13 +959,13 @@ To override the style of all instances of `<FilterButton>` using the [applicatio
 ## `<SelectAllButton>`
 
 This button is an internal component used by react-admin in [the Datagrid default `bulkActionButtons`](./Datagrid.md#bulkactionbuttons).
-The `<SelectAllButton>` component is a button that is used to select all items from a resource, no matters the pagination.
+The `<SelectAllButton>` component is a button that is used to select all items from a resource, no matter the pagination.
 
 ![SelectAllButton](./img/SelectAllButton.png)
 
 ### `label`
 
-By default, `<SelectAllButton>` renders with the "Select all" (translated if the user locale isn't English), whether used on a creation or edition form. You can pass another label:
+By default, the `<SelectAllButton>` label is "Select all" (or the `ra.action.select_all` message translation). You can also pass a custom `label`:
 
 ```jsx
 const PostSelectAllButton = () => <SelectAllButton label="Select all posts" />;
@@ -975,7 +975,7 @@ const PostSelectAllButton = () => <SelectAllButton label="Select all posts" />;
 
 ### `limit`
 
-By default, `<SelectAllButton>` select the 250 first items of your list. To customize this limit you can use the prop `limit` as follows:
+By default, `<SelectAllButton>` selects the 250 first items of your list. To customize this limit, you can use the `limit` prop:
 
 ```jsx
 const PostSelectAllButton = () => <SelectAllButton limit={100} />;
@@ -983,7 +983,7 @@ const PostSelectAllButton = () => <SelectAllButton limit={100} />;
 
 ### `queryOptions`
 
-`<SelectAllButton>` calls a `get` method of your `dataProvider` via a react-query's hook. You can customize the options you pass to this hook, e.g. to pass [a custom `meta`](./Actions.md#meta-parameter) to the call.
+`<SelectAllButton>` calls a `get` method of your `dataProvider` via a react-query's `useQuery` hook. You can customize the options you pass to this hook, e.g. to pass [a custom `meta`](./Actions.md#meta-parameter) to the call.
 
 {% raw %}
 ```jsx
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index d0189a6d900..e90f45da911 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -7,7 +7,7 @@ import type { FilterPayload, RaRecord, SortPayload } from '../../types';
 import type { UseRecordSelectionResult } from './useRecordSelection';
 
 /**
- * Function hook to select all items of a list (until we reached the limit)
+ * Select all records of a resource (capped by the limit prop)
  *
  * @param {string} resource Required. The resource name
  * @param {RecordSelectionModifiers} selectionModifiers Required, The selection modifiers
diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index 1adad102177..1ab33c9ad05 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -10,7 +10,9 @@ import {
 import { Button, ButtonProps } from './Button';
 
 /**
- * Select all items from a Datagrid.
+ * Select all items in the current List context.
+ *
+ * Used un Datagrid's bulk action toolbar.
  *
  * @typedef {Object} Props the props you can use
  * @prop {string} label Button label. Defaults to 'ra.action.select_all', translated.

From a4c7a821406758153b1eb8b8489842410e88b3f0 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 14:09:28 +0100
Subject: [PATCH 067/146] Improve jsDoc of selectionModifiers

---
 packages/ra-core/src/controller/list/useSelectAll.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index e90f45da911..67f0129e85d 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -10,7 +10,7 @@ import type { UseRecordSelectionResult } from './useRecordSelection';
  * Select all records of a resource (capped by the limit prop)
  *
  * @param {string} resource Required. The resource name
- * @param {RecordSelectionModifiers} selectionModifiers Required, The selection modifiers
+ * @param {RecordSelectionModifiers} selectionModifiers Required. Set of functions to modify the selection (select, unselect, toggle, clearSelection)
  * @param {SortPayload} sort Optional. The sort object passed to the dataProvider
  * @param {FilterPayload} filter Optional. The filter object passed to the dataProvider
  * @returns {Function} onSelectAll A function to select all items of a list

From 03d9afcefc10ce4ae638ec5404bbd5dd7e278a70 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 14:17:22 +0100
Subject: [PATCH 068/146] remove the duplicated `resource` from the query

---
 packages/ra-core/src/controller/list/useSelectAll.tsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 67f0129e85d..85c40384341 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -50,7 +50,6 @@ export const useSelectAll = ({
                         resource,
                         'getList',
                         {
-                            resource,
                             pagination: { page: 1, perPage: limit },
                             sort,
                             filter,

From f1b40913a68f3baa6f045b0d755cc0e84a143969 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 14:28:12 +0100
Subject: [PATCH 069/146] add the missing frenc translation + reorder
 alphabetically the messages

---
 packages/ra-language-french/src/index.ts | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/packages/ra-language-french/src/index.ts b/packages/ra-language-french/src/index.ts
index 36773753e4f..95067ab274f 100644
--- a/packages/ra-language-french/src/index.ts
+++ b/packages/ra-language-french/src/index.ts
@@ -89,7 +89,10 @@ const frenchMessages: TranslationMessages = {
         },
         message: {
             about: 'Au sujet de',
+            access_denied: "Vous n'avez pas les droits d'accès à cette page",
             are_you_sure: 'Êtes-vous sûr ?',
+            authentication_error:
+                "Le serveur d'authentification a retourné une erreur et vos autorisations n'ont pas pu être vérifiées.",
             auth_error:
                 "Une erreur est survenue lors de la validation de votre jeton d'authentification.",
             bulk_delete_content:
@@ -107,19 +110,17 @@ const frenchMessages: TranslationMessages = {
             delete_title: 'Supprimer %{name} #%{id}',
             details: 'Détails',
             error: "En raison d'une erreur côté navigateur, votre requête n'a pas pu aboutir.",
-
             invalid_form: "Le formulaire n'est pas valide.",
             loading:
                 'La page est en cours de chargement, merci de bien vouloir patienter.',
             no: 'Non',
             not_found:
                 "L'URL saisie est incorrecte, ou vous avez suivi un mauvais lien.",
-            yes: 'Oui',
+            too_many_elements:
+                "Attention: Il y a trop d'éléments pour tous les sélectionner. Seuls les %{max} premiers éléments ont été sélectionnés.",
             unsaved_changes:
                 "Certains changements n'ont pas été enregistrés. Êtes-vous sûr(e) de vouloir quitter cette page ?",
-            access_denied: "Vous n'avez pas les droits d'accès à cette page",
-            authentication_error:
-                "Le serveur d'authentification a retourné une erreur et vos autorisations n'ont pas pu être vérifiées.",
+            yes: 'Oui',
         },
         navigation: {
             clear_filters: 'Effacer les filtres',

From 6f8e99b535bf147bfd29be2413747948d468f8aa Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 14:29:45 +0100
Subject: [PATCH 070/146] rename message `too_many_elements` into
 `select_all_limit_reached`

---
 .../src/controller/field/useReferenceManyFieldController.ts     | 2 +-
 packages/ra-core/src/controller/list/useSelectAll.tsx           | 2 +-
 packages/ra-language-english/src/index.ts                       | 2 +-
 packages/ra-language-french/src/index.ts                        | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 604650a3dc0..2e3f7483d6e 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -235,7 +235,7 @@ export const useReferenceManyFieldController = <
                 const allIds = results.data?.map(({ id }) => id) || [];
                 selectionModifiers.select(allIds);
                 if (allIds.length === limit) {
-                    notify('ra.message.too_many_elements', {
+                    notify('ra.message.select_all_limit_reached', {
                         messageArgs: { max: limit },
                         type: 'warning',
                     });
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 85c40384341..053e8896135 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -71,7 +71,7 @@ export const useSelectAll = ({
                 const allIds = results.data?.map(({ id }) => id) || [];
                 selectionModifiers.select(allIds);
                 if (allIds.length === limit) {
-                    notify('ra.message.too_many_elements', {
+                    notify('ra.message.select_all_limit_reached', {
                         messageArgs: { max: limit },
                         type: 'warning',
                     });
diff --git a/packages/ra-language-english/src/index.ts b/packages/ra-language-english/src/index.ts
index 81422c1a7da..50632db5719 100644
--- a/packages/ra-language-english/src/index.ts
+++ b/packages/ra-language-english/src/index.ts
@@ -112,7 +112,7 @@ const englishMessages: TranslationMessages = {
             no: 'No',
             not_found:
                 'Either you typed a wrong URL, or you followed a bad link.',
-            too_many_elements:
+            select_all_limit_reached:
                 'Warning: There are too many elements to select them all. Only the first %{max} elements were selected.',
             unsaved_changes:
                 "Some of your changes weren't saved. Are you sure you want to ignore them?",
diff --git a/packages/ra-language-french/src/index.ts b/packages/ra-language-french/src/index.ts
index 95067ab274f..1930c7d2395 100644
--- a/packages/ra-language-french/src/index.ts
+++ b/packages/ra-language-french/src/index.ts
@@ -116,7 +116,7 @@ const frenchMessages: TranslationMessages = {
             no: 'Non',
             not_found:
                 "L'URL saisie est incorrecte, ou vous avez suivi un mauvais lien.",
-            too_many_elements:
+            select_all_limit_reached:
                 "Attention: Il y a trop d'éléments pour tous les sélectionner. Seuls les %{max} premiers éléments ont été sélectionnés.",
             unsaved_changes:
                 "Certains changements n'ont pas été enregistrés. Êtes-vous sûr(e) de vouloir quitter cette page ?",

From 4e86cd889701a4fd369954687a7f6de7630902fa Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 14:30:56 +0100
Subject: [PATCH 071/146] Remove the `Warning` from the
 `select_all_limit_reached` message

---
 packages/ra-language-english/src/index.ts | 2 +-
 packages/ra-language-french/src/index.ts  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/ra-language-english/src/index.ts b/packages/ra-language-english/src/index.ts
index 50632db5719..3d255566fa8 100644
--- a/packages/ra-language-english/src/index.ts
+++ b/packages/ra-language-english/src/index.ts
@@ -113,7 +113,7 @@ const englishMessages: TranslationMessages = {
             not_found:
                 'Either you typed a wrong URL, or you followed a bad link.',
             select_all_limit_reached:
-                'Warning: There are too many elements to select them all. Only the first %{max} elements were selected.',
+                'There are too many elements to select them all. Only the first %{max} elements were selected.',
             unsaved_changes:
                 "Some of your changes weren't saved. Are you sure you want to ignore them?",
             yes: 'Yes',
diff --git a/packages/ra-language-french/src/index.ts b/packages/ra-language-french/src/index.ts
index 1930c7d2395..369643a6cc1 100644
--- a/packages/ra-language-french/src/index.ts
+++ b/packages/ra-language-french/src/index.ts
@@ -117,7 +117,7 @@ const frenchMessages: TranslationMessages = {
             not_found:
                 "L'URL saisie est incorrecte, ou vous avez suivi un mauvais lien.",
             select_all_limit_reached:
-                "Attention: Il y a trop d'éléments pour tous les sélectionner. Seuls les %{max} premiers éléments ont été sélectionnés.",
+                "Il y a trop d'éléments pour tous les sélectionner. Seuls les %{max} premiers éléments ont été sélectionnés.",
             unsaved_changes:
                 "Certains changements n'ont pas été enregistrés. Êtes-vous sûr(e) de vouloir quitter cette page ?",
             yes: 'Oui',

From 755571ee671d9af933fc75ff7e4f4a61ea3d67ed Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 14:32:03 +0100
Subject: [PATCH 072/146] Remove the `Warning` from the
 `select_all_limit_reached` message in tests

---
 packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx | 2 +-
 .../ra-ui-materialui/src/field/ReferenceManyField.spec.tsx    | 4 ++--
 packages/ra-ui-materialui/src/list/List.spec.tsx              | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
index 883a41f22f8..e9f1c6a868b 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
@@ -33,7 +33,7 @@ describe('<SelectAllButton />', () => {
             screen.getByRole('button', { name: 'Select 5 first books' })
         );
         await screen.findByText(
-            'Warning: There are too many elements to select them all. Only the first 5 elements were selected.'
+            'There are too many elements to select them all. Only the first 5 elements were selected.'
         );
         await screen.findByText('5 items selected');
     });
diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
index 19edb0ced87..66ad7875ae7 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
@@ -384,7 +384,7 @@ describe('<ReferenceManyField />', () => {
             fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
             await screen.findByText('6 items selected');
             await screen.findByText(
-                'Warning: There are too many elements to select them all. Only the first 6 elements were selected.'
+                'There are too many elements to select them all. Only the first 6 elements were selected.'
             );
             expect(
                 screen.queryByRole('button', { name: 'Select all' })
@@ -410,7 +410,7 @@ describe('<ReferenceManyField />', () => {
             fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
             await screen.findByText('6 items selected');
             await screen.findByText(
-                'Warning: There are too many elements to select them all. Only the first 6 elements were selected.'
+                'There are too many elements to select them all. Only the first 6 elements were selected.'
             );
         });
     });
diff --git a/packages/ra-ui-materialui/src/list/List.spec.tsx b/packages/ra-ui-materialui/src/list/List.spec.tsx
index 8433b1ce3ab..d7e947b8a4a 100644
--- a/packages/ra-ui-materialui/src/list/List.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/List.spec.tsx
@@ -483,7 +483,7 @@ describe('<List />', () => {
             fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
             await screen.findByText('11 items selected');
             await screen.findByText(
-                'Warning: There are too many elements to select them all. Only the first 11 elements were selected.'
+                'There are too many elements to select them all. Only the first 11 elements were selected.'
             );
             expect(
                 screen.queryByRole('button', { name: 'Select all' })
@@ -517,7 +517,7 @@ describe('<List />', () => {
             fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
             await screen.findByText('11 items selected');
             await screen.findByText(
-                'Warning: There are too many elements to select them all. Only the first 11 elements were selected.'
+                'There are too many elements to select them all. Only the first 11 elements were selected.'
             );
         });
     });

From b8f841391d51d1e78d3a2fac4c18e348b750e6cf Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 14:33:11 +0100
Subject: [PATCH 073/146] remove useless `console.error`

---
 packages/ra-core/src/controller/list/useSelectAll.tsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 053e8896135..5eb86b4c27d 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -86,7 +86,6 @@ export const useSelectAll = ({
                 if (onError) {
                     onError(error);
                 }
-                console.error('Mutation Error: ', error);
                 notify('An error occurred. Please try again.');
             }
         },

From f1d4000a8360342f3ce603e7479f95a434fbb964 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 14:52:46 +0100
Subject: [PATCH 074/146] create a translation for the error message + add a
 type to the notif + remove `resource` and  `console`

---
 .../src/controller/field/useReferenceManyFieldController.ts   | 4 +---
 packages/ra-core/src/controller/list/useSelectAll.tsx         | 2 +-
 packages/ra-language-english/src/index.ts                     | 1 +
 packages/ra-language-french/src/index.ts                      | 1 +
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 2e3f7483d6e..510d742e1bc 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -211,7 +211,6 @@ export const useReferenceManyFieldController = <
                         resource,
                         'getManyReference',
                         {
-                            resource,
                             pagination: { page: 1, perPage: limit },
                             sort,
                             filter,
@@ -250,8 +249,7 @@ export const useReferenceManyFieldController = <
                 if (onError) {
                     onError(error);
                 }
-                console.error('Mutation Error: ', error);
-                notify('An error occurred. Please try again.');
+                notify('ra.notification.simple_error', { type: 'warning' });
             }
         },
         [
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 5eb86b4c27d..44e89b94372 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -86,7 +86,7 @@ export const useSelectAll = ({
                 if (onError) {
                     onError(error);
                 }
-                notify('An error occurred. Please try again.');
+                notify('ra.notification.simple_error', { type: 'warning' });
             }
         },
         [
diff --git a/packages/ra-language-english/src/index.ts b/packages/ra-language-english/src/index.ts
index 3d255566fa8..776123d6e70 100644
--- a/packages/ra-language-english/src/index.ts
+++ b/packages/ra-language-english/src/index.ts
@@ -159,6 +159,7 @@ const englishMessages: TranslationMessages = {
             deleted: 'Element deleted |||| %{smart_count} elements deleted',
             bad_item: 'Incorrect element',
             item_doesnt_exist: 'Element does not exist',
+            simple_error: 'An error occurred. Please try again.',
             http_error: 'Server communication error',
             data_provider_error:
                 'dataProvider error. Check the console for details.',
diff --git a/packages/ra-language-french/src/index.ts b/packages/ra-language-french/src/index.ts
index 369643a6cc1..9021eb98796 100644
--- a/packages/ra-language-french/src/index.ts
+++ b/packages/ra-language-french/src/index.ts
@@ -165,6 +165,7 @@ const frenchMessages: TranslationMessages = {
             deleted: 'Élément supprimé |||| %{smart_count} éléments supprimés',
             bad_item: 'Élément inconnu',
             item_doesnt_exist: "L'élément n'existe pas",
+            simple_error: 'Une erreur est survenue. Veuillez réessayer.',
             http_error: 'Erreur de communication avec le serveur',
             data_provider_error:
                 'Erreur dans le dataProvider. Plus de détails dans la console.',

From 400d85fc69043750894627b8f00504e390fc1640 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 14:55:29 +0100
Subject: [PATCH 075/146] rename `onSelectAllProps` into `onSelectAllParams`

---
 .../src/controller/field/useReferenceManyFieldController.ts | 4 ++--
 packages/ra-core/src/controller/list/useSelectAll.tsx       | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 510d742e1bc..155e27596cd 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -8,7 +8,7 @@ import { removeEmpty } from '../../util';
 import { useDataProvider, useGetManyReference } from '../../dataProvider';
 import { useNotify } from '../../notification';
 import { FilterPayload, Identifier, RaRecord, SortPayload } from '../../types';
-import type { ListControllerResult, onSelectAllProps } from '../list';
+import type { ListControllerResult, onSelectAllParams } from '../list';
 import usePaginationState from '../usePaginationState';
 import { useRecordSelection } from '../list/useRecordSelection';
 import useSortState from '../useSortState';
@@ -203,7 +203,7 @@ export const useReferenceManyFieldController = <
     );
 
     const onSelectAll = useCallback(
-        async ({ limit = 250, queryOptions = {} }: onSelectAllProps = {}) => {
+        async ({ limit = 250, queryOptions = {} }: onSelectAllParams = {}) => {
             const { meta, onSuccess, onError } = queryOptions;
             try {
                 const results = await queryClient.fetchQuery({
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 44e89b94372..005171bf3da 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -36,13 +36,13 @@ export const useSelectAll = ({
     selectionModifiers,
     sort,
     filter,
-}: useSelectAllProps): ((options?: onSelectAllProps) => void) => {
+}: useSelectAllProps): ((options?: onSelectAllParams) => void) => {
     const dataProvider = useDataProvider();
     const queryClient = useQueryClient();
     const notify = useNotify();
 
     const onSelectAll = useCallback(
-        async ({ queryOptions = {}, limit = 250 }: onSelectAllProps = {}) => {
+        async ({ queryOptions = {}, limit = 250 }: onSelectAllParams = {}) => {
             const { meta, onSuccess, onError } = queryOptions;
             try {
                 const results = await queryClient.fetchQuery({
@@ -109,7 +109,7 @@ export interface useSelectAllProps {
     filter?: FilterPayload;
 }
 
-export interface onSelectAllProps<RecordType extends RaRecord = any> {
+export interface onSelectAllParams<RecordType extends RaRecord = any> {
     limit?: number;
     queryOptions?: UseGetListOptions<RecordType>;
 }

From bf47b5ec2f18a8c3646082b091ed62348fcac624 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 15:40:33 +0100
Subject: [PATCH 076/146] remove `selectionModifiers` from props to import it
 with a hook

---
 .../src/controller/list/useSelectAll.tsx      | 38 ++++++++-----------
 1 file changed, 16 insertions(+), 22 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 005171bf3da..115bdedb36e 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -3,42 +3,45 @@ import { useQueryClient } from '@tanstack/react-query';
 
 import { useNotify } from '../../notification';
 import { useDataProvider, UseGetListOptions } from '../../dataProvider';
+import { useRecordSelection } from './useRecordSelection';
 import type { FilterPayload, RaRecord, SortPayload } from '../../types';
-import type { UseRecordSelectionResult } from './useRecordSelection';
 
 /**
  * Select all records of a resource (capped by the limit prop)
  *
  * @param {string} resource Required. The resource name
- * @param {RecordSelectionModifiers} selectionModifiers Required. Set of functions to modify the selection (select, unselect, toggle, clearSelection)
  * @param {SortPayload} sort Optional. The sort object passed to the dataProvider
  * @param {FilterPayload} filter Optional. The filter object passed to the dataProvider
  * @returns {Function} onSelectAll A function to select all items of a list
  *
- * @example
+ * @example // TODO: Update this example after updating the button position in the toolbar
  *
- * const MyButton = () => {
- *   const [_, selectionModifiers] = useRecordSelection({ resource: 'posts' });
- *   const onSelectAll = useSelectAll({
- *       selectionModifiers,
- *       sort: { field: 'title', order: 'ASC' },
- *       filter: { title: 'foo' },
- *   });
+ * const MySelectAllButton = () => {
+ *   const { sort, filter } = useListContext();
+ *   const onSelectAll = useSelectAll({ resource: 'posts', sort, filter });
  *   const handleClick = () => onSelectAll({
  *       queryOptions: { meta: { foo: 'bar' } },
  *       limit: 250,
  *   });
  *   return <Button onClick={handleClick}>Select All</Button>;
  * };
+ *
+ * const PostList = () => (
+ *   <List>
+ *     <Datagrid bulkActionButtons={<MySelectAllButton />}>
+ *       // ...
+ *     </Datagrid>
+ *   </List>
+ * );
  */
 export const useSelectAll = ({
     resource,
-    selectionModifiers,
     sort,
     filter,
 }: useSelectAllProps): ((options?: onSelectAllParams) => void) => {
     const dataProvider = useDataProvider();
     const queryClient = useQueryClient();
+    const [, { select }] = useRecordSelection({ resource });
     const notify = useNotify();
 
     const onSelectAll = useCallback(
@@ -69,7 +72,7 @@ export const useSelectAll = ({
                 });
 
                 const allIds = results.data?.map(({ id }) => id) || [];
-                selectionModifiers.select(allIds);
+                select(allIds);
                 if (allIds.length === limit) {
                     notify('ra.message.select_all_limit_reached', {
                         messageArgs: { max: limit },
@@ -89,22 +92,13 @@ export const useSelectAll = ({
                 notify('ra.notification.simple_error', { type: 'warning' });
             }
         },
-        [
-            dataProvider,
-            queryClient,
-            notify,
-            resource,
-            sort,
-            filter,
-            selectionModifiers,
-        ]
+        [queryClient, resource, sort, filter, select, dataProvider, notify]
     );
     return onSelectAll;
 };
 
 export interface useSelectAllProps {
     resource: string;
-    selectionModifiers: UseRecordSelectionResult[1];
     sort?: SortPayload;
     filter?: FilterPayload;
 }

From 8916730975ce219c027e5c2f73c2eab7f65f706d Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 15:43:47 +0100
Subject: [PATCH 077/146] apply the deletion of the `selectionMofifiers` prop

---
 .../ra-core/src/controller/list/useInfiniteListController.ts     | 1 -
 packages/ra-core/src/controller/list/useListController.ts        | 1 -
 2 files changed, 2 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index 78f1576c131..d460a8be797 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -141,7 +141,6 @@ export const useInfiniteListController = <RecordType extends RaRecord = any>(
 
     const onSelectAll = useSelectAll({
         resource,
-        selectionModifiers,
         sort: { field: query.sort, order: query.order },
         filter: { ...query.filter, ...filter },
     });
diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index 93f994574e9..21297ab4f97 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -171,7 +171,6 @@ export const useListController = <RecordType extends RaRecord = any>(
 
     const onSelectAll = useSelectAll({
         resource,
-        selectionModifiers,
         sort: { field: query.sort, order: query.order },
         filter: { ...query.filter, ...filter },
     });

From b56f600105ff48b296dfa886e15998d1700cde2d Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 15:56:52 +0100
Subject: [PATCH 078/146] apply the PREFIX to the CSS in JS instead of HTML
 attribute

---
 .../src/button/BulkDeleteWithUndoButton.tsx   |  3 +--
 .../src/button/BulkUpdateWithUndoButton.tsx   |  3 +--
 .../src/button/SelectAllButton.tsx            | 21 +++++++++++++++----
 .../ra-ui-materialui/src/layout/Confirm.tsx   |  3 +--
 4 files changed, 20 insertions(+), 10 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/BulkDeleteWithUndoButton.tsx b/packages/ra-ui-materialui/src/button/BulkDeleteWithUndoButton.tsx
index 45310435893..4b650bb0828 100644
--- a/packages/ra-ui-materialui/src/button/BulkDeleteWithUndoButton.tsx
+++ b/packages/ra-ui-materialui/src/button/BulkDeleteWithUndoButton.tsx
@@ -1,8 +1,7 @@
 import * as React from 'react';
-import { styled } from '@mui/material/styles';
 import { ReactElement } from 'react';
 import ActionDelete from '@mui/icons-material/Delete';
-import { alpha } from '@mui/material/styles';
+import { alpha, styled } from '@mui/material/styles';
 import {
     useDeleteMany,
     useRefresh,
diff --git a/packages/ra-ui-materialui/src/button/BulkUpdateWithUndoButton.tsx b/packages/ra-ui-materialui/src/button/BulkUpdateWithUndoButton.tsx
index 7e32088920d..400954badc7 100644
--- a/packages/ra-ui-materialui/src/button/BulkUpdateWithUndoButton.tsx
+++ b/packages/ra-ui-materialui/src/button/BulkUpdateWithUndoButton.tsx
@@ -1,8 +1,7 @@
 import * as React from 'react';
-import { styled } from '@mui/material/styles';
 import { ReactElement } from 'react';
 import ActionUpdate from '@mui/icons-material/Update';
-import { alpha } from '@mui/material/styles';
+import { alpha, styled } from '@mui/material/styles';
 import {
     useUpdateMany,
     useRefresh,
diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index 1ab33c9ad05..1ad7449440b 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -6,6 +6,7 @@ import {
     type UseReferenceArrayFieldControllerParams,
     type UseReferenceManyFieldControllerParams,
 } from 'ra-core';
+import { alpha, styled } from '@mui/material/styles';
 
 import { Button, ButtonProps } from './Button';
 
@@ -26,8 +27,6 @@ import { Button, ButtonProps } from './Button';
  * const MySelectAllButton = () => <SelectAllButton limit={100} label="Select all books" />;
  */
 
-const PREFIX = 'RaSelectAllButton';
-
 export const SelectAllButton = (props: SelectAllButtonProps) => {
     const {
         label = 'ra.action.select_all',
@@ -51,11 +50,10 @@ export const SelectAllButton = (props: SelectAllButtonProps) => {
         return null;
 
     return (
-        <Button
+        <StyledButton
             label={label}
             onClick={handleSelectAll}
             type="button"
-            name={PREFIX}
             {...rest}
         />
     );
@@ -69,3 +67,18 @@ export type SelectAllButtonProps<RecordType extends RaRecord = any> =
             | UseReferenceArrayFieldControllerParams<RecordType>['queryOptions']
             | UseReferenceManyFieldControllerParams<RecordType>['queryOptions'];
     };
+
+const PREFIX = 'RaSelectAllButton';
+
+const StyledButton = styled(Button, {
+    name: PREFIX,
+    overridesResolver: (props, styles) => styles.root,
+})(({ theme }) => ({
+    '&:hover': {
+        backgroundColor: alpha(theme.palette.primary.main, 0.12),
+        // Reset on mouse devices
+        '@media (hover: none)': {
+            backgroundColor: 'transparent',
+        },
+    },
+}));
diff --git a/packages/ra-ui-materialui/src/layout/Confirm.tsx b/packages/ra-ui-materialui/src/layout/Confirm.tsx
index 430482cc373..b2521e56bfc 100644
--- a/packages/ra-ui-materialui/src/layout/Confirm.tsx
+++ b/packages/ra-ui-materialui/src/layout/Confirm.tsx
@@ -1,5 +1,4 @@
 import * as React from 'react';
-import { styled } from '@mui/material/styles';
 import { useCallback, MouseEventHandler, ComponentType } from 'react';
 import Dialog, { DialogProps } from '@mui/material/Dialog';
 import DialogActions from '@mui/material/DialogActions';
@@ -7,7 +6,7 @@ import DialogContent from '@mui/material/DialogContent';
 import DialogContentText from '@mui/material/DialogContentText';
 import DialogTitle from '@mui/material/DialogTitle';
 import Button from '@mui/material/Button';
-import { alpha } from '@mui/material/styles';
+import { alpha, styled } from '@mui/material/styles';
 import ActionCheck from '@mui/icons-material/CheckCircle';
 import AlertError from '@mui/icons-material/ErrorOutline';
 import clsx from 'clsx';

From 7e7a05c21a4f988e85604c11d61607c4c084f424 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 16:07:36 +0100
Subject: [PATCH 079/146] add a transated message dedicated for the select all
 button + fix TranslationMessages interface

---
 packages/ra-core/src/i18n/TranslationMessages.ts         | 9 ++++++---
 packages/ra-language-english/src/index.ts                | 1 +
 packages/ra-language-french/src/index.ts                 | 1 +
 packages/ra-ui-materialui/src/button/SelectAllButton.tsx | 4 ++--
 .../src/input/ReferenceArrayInput.spec.tsx               | 2 +-
 5 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/packages/ra-core/src/i18n/TranslationMessages.ts b/packages/ra-core/src/i18n/TranslationMessages.ts
index dc63d11e88b..99a1a061f07 100644
--- a/packages/ra-core/src/i18n/TranslationMessages.ts
+++ b/packages/ra-core/src/i18n/TranslationMessages.ts
@@ -29,6 +29,7 @@ export interface TranslationMessages extends StringMap {
             save: string;
             search: string;
             select_all: string;
+            select_all_button: string;
             select_row: string;
             show: string;
             sort: string;
@@ -94,7 +95,9 @@ export interface TranslationMessages extends StringMap {
         message: {
             [key: string]: StringMap | string;
             about: string;
+            access_denied: string;
             are_you_sure: string;
+            authentication_error: string;
             auth_error: string;
             bulk_delete_content: string;
             bulk_delete_title: string;
@@ -109,10 +112,9 @@ export interface TranslationMessages extends StringMap {
             loading: string;
             no: string;
             not_found: string;
-            yes: string;
+            select_all_limit_reached: string;
             unsaved_changes: string;
-            access_denied: string;
-            authentication_error: string;
+            yes: string;
         };
         navigation: {
             [key: string]: StringMap | string;
@@ -156,6 +158,7 @@ export interface TranslationMessages extends StringMap {
             deleted: string;
             bad_item: string;
             item_doesnt_exist: string;
+            simple_error: string;
             http_error: string;
             data_provider_error: string;
             i18n_error: string;
diff --git a/packages/ra-language-english/src/index.ts b/packages/ra-language-english/src/index.ts
index 776123d6e70..d1f4666a566 100644
--- a/packages/ra-language-english/src/index.ts
+++ b/packages/ra-language-english/src/index.ts
@@ -25,6 +25,7 @@ const englishMessages: TranslationMessages = {
             save: 'Save',
             search: 'Search',
             select_all: 'Select all',
+            select_all_button: 'Select all',
             select_row: 'Select this row',
             show: 'Show',
             sort: 'Sort',
diff --git a/packages/ra-language-french/src/index.ts b/packages/ra-language-french/src/index.ts
index 9021eb98796..6e6f8feef10 100644
--- a/packages/ra-language-french/src/index.ts
+++ b/packages/ra-language-french/src/index.ts
@@ -25,6 +25,7 @@ const frenchMessages: TranslationMessages = {
             remove: 'Supprimer',
             save: 'Enregistrer',
             select_all: 'Tout sélectionner',
+            select_all_button: 'Tout sélectionner',
             select_row: 'Sélectionner cette ligne',
             search: 'Rechercher',
             show: 'Afficher',
diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index 1ad7449440b..a940aa0cdd5 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -16,7 +16,7 @@ import { Button, ButtonProps } from './Button';
  * Used un Datagrid's bulk action toolbar.
  *
  * @typedef {Object} Props the props you can use
- * @prop {string} label Button label. Defaults to 'ra.action.select_all', translated.
+ * @prop {string} label Button label. Defaults to 'ra.action.select_all_button', translated.
  * @prop {string} limit Maximum number of items to select. Defaults to 250.
  * @prop {function} queryOptions Object of options passed to react-query.
  *
@@ -29,7 +29,7 @@ import { Button, ButtonProps } from './Button';
 
 export const SelectAllButton = (props: SelectAllButtonProps) => {
     const {
-        label = 'ra.action.select_all',
+        label = 'ra.action.select_all_button',
         limit = 250,
         onClick,
         queryOptions,
diff --git a/packages/ra-ui-materialui/src/input/ReferenceArrayInput.spec.tsx b/packages/ra-ui-materialui/src/input/ReferenceArrayInput.spec.tsx
index 34311c16a98..7815bdec371 100644
--- a/packages/ra-ui-materialui/src/input/ReferenceArrayInput.spec.tsx
+++ b/packages/ra-ui-materialui/src/input/ReferenceArrayInput.spec.tsx
@@ -192,7 +192,7 @@ describe('<ReferenceArrayInput />', () => {
                 .getByLabelText('ra.action.select_row')
                 .querySelector('input');
         const getCheckboxAll = () =>
-            screen.getByRole('checkbox', { name: 'ra.action.select_all' });
+            screen.getByLabelText('ra.action.select_all');
         await waitFor(() => {
             expect(getCheckbox1()?.checked).toEqual(true);
             expect(getCheckbox2()?.checked).toEqual(false);

From 05dcd17180dff41f4ff8e355ef6fe6ebbbfab6ee Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 16:19:10 +0100
Subject: [PATCH 080/146] rename `onSelectAll` into `handleSelectAll` in
 `useSelectAll` (not in `useListController`)

---
 .../field/useReferenceManyFieldController.ts  |  7 +++++--
 .../src/controller/list/useSelectAll.tsx      | 19 +++++++++++--------
 2 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 155e27596cd..6c849e106e2 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -8,7 +8,7 @@ import { removeEmpty } from '../../util';
 import { useDataProvider, useGetManyReference } from '../../dataProvider';
 import { useNotify } from '../../notification';
 import { FilterPayload, Identifier, RaRecord, SortPayload } from '../../types';
-import type { ListControllerResult, onSelectAllParams } from '../list';
+import type { ListControllerResult, handleSelectAllParams } from '../list';
 import usePaginationState from '../usePaginationState';
 import { useRecordSelection } from '../list/useRecordSelection';
 import useSortState from '../useSortState';
@@ -203,7 +203,10 @@ export const useReferenceManyFieldController = <
     );
 
     const onSelectAll = useCallback(
-        async ({ limit = 250, queryOptions = {} }: onSelectAllParams = {}) => {
+        async ({
+            limit = 250,
+            queryOptions = {},
+        }: handleSelectAllParams = {}) => {
             const { meta, onSuccess, onError } = queryOptions;
             try {
                 const results = await queryClient.fetchQuery({
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 115bdedb36e..688595f0e2e 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -12,14 +12,14 @@ import type { FilterPayload, RaRecord, SortPayload } from '../../types';
  * @param {string} resource Required. The resource name
  * @param {SortPayload} sort Optional. The sort object passed to the dataProvider
  * @param {FilterPayload} filter Optional. The filter object passed to the dataProvider
- * @returns {Function} onSelectAll A function to select all items of a list
+ * @returns {Function} handleSelectAll A function to select all items of a list
  *
  * @example // TODO: Update this example after updating the button position in the toolbar
  *
  * const MySelectAllButton = () => {
  *   const { sort, filter } = useListContext();
- *   const onSelectAll = useSelectAll({ resource: 'posts', sort, filter });
- *   const handleClick = () => onSelectAll({
+ *   const handleSelectAll = useSelectAll({ resource: 'posts', sort, filter });
+ *   const handleClick = () => handleSelectAll({
  *       queryOptions: { meta: { foo: 'bar' } },
  *       limit: 250,
  *   });
@@ -38,14 +38,17 @@ export const useSelectAll = ({
     resource,
     sort,
     filter,
-}: useSelectAllProps): ((options?: onSelectAllParams) => void) => {
+}: useSelectAllProps): ((options?: handleSelectAllParams) => void) => {
     const dataProvider = useDataProvider();
     const queryClient = useQueryClient();
     const [, { select }] = useRecordSelection({ resource });
     const notify = useNotify();
 
-    const onSelectAll = useCallback(
-        async ({ queryOptions = {}, limit = 250 }: onSelectAllParams = {}) => {
+    const handleSelectAll = useCallback(
+        async ({
+            queryOptions = {},
+            limit = 250,
+        }: handleSelectAllParams = {}) => {
             const { meta, onSuccess, onError } = queryOptions;
             try {
                 const results = await queryClient.fetchQuery({
@@ -94,7 +97,7 @@ export const useSelectAll = ({
         },
         [queryClient, resource, sort, filter, select, dataProvider, notify]
     );
-    return onSelectAll;
+    return handleSelectAll;
 };
 
 export interface useSelectAllProps {
@@ -103,7 +106,7 @@ export interface useSelectAllProps {
     filter?: FilterPayload;
 }
 
-export interface onSelectAllParams<RecordType extends RaRecord = any> {
+export interface handleSelectAllParams<RecordType extends RaRecord = any> {
     limit?: number;
     queryOptions?: UseGetListOptions<RecordType>;
 }

From 570170b09f0f1b4ec6f24fb9c6ec974468c6a7fd Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 17:10:09 +0100
Subject: [PATCH 081/146] fix ts error

---
 .../src/controller/list/useListController.ts   | 18 +++++++++++++++---
 .../src/button/SelectAllButton.tsx             |  1 -
 2 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useListController.ts b/packages/ra-core/src/controller/list/useListController.ts
index 21297ab4f97..37c500caa98 100644
--- a/packages/ra-core/src/controller/list/useListController.ts
+++ b/packages/ra-core/src/controller/list/useListController.ts
@@ -8,13 +8,22 @@ import {
     UseGetListHookValue,
     UseGetListOptions,
 } from '../../dataProvider';
-import { defaultExporter } from '../../export';
-import { FilterPayload, SortPayload, RaRecord, Exporter } from '../../types';
 import { useResourceContext, useGetResourceLabel } from '../../core';
 import { useRecordSelection } from './useRecordSelection';
 import { useListParams } from './useListParams';
 import { useSelectAll } from './useSelectAll';
+import { defaultExporter } from '../../export';
 import { SORT_ASC } from './queryReducer';
+import type {
+    FilterPayload,
+    SortPayload,
+    RaRecord,
+    Exporter,
+} from '../../types';
+import type {
+    UseReferenceArrayFieldControllerParams,
+    UseReferenceManyFieldControllerParams,
+} from '../field';
 
 /**
  * Prepare data for the List view
@@ -486,7 +495,10 @@ export interface ListControllerBaseResult<RecordType extends RaRecord = any> {
     onSelect: (ids: RecordType['id'][]) => void;
     onSelectAll: (options?: {
         limit?: number;
-        queryOptions?: UseGetListOptions<RecordType>;
+        queryOptions?:
+            | UseGetListOptions<RecordType>
+            | UseReferenceArrayFieldControllerParams<RecordType>['queryOptions']
+            | UseReferenceManyFieldControllerParams<RecordType>['queryOptions'];
     }) => void;
     onToggleItem: (id: RecordType['id']) => void;
     onUnselectItems: () => void;
diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index a940aa0cdd5..f447306481d 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -39,7 +39,6 @@ export const SelectAllButton = (props: SelectAllButtonProps) => {
     const { total, selectedIds, onSelectAll } = useListContext();
     const handleSelectAll = useCallback(
         event => {
-            // @ts-ignore
             onSelectAll({ limit, queryOptions });
             if (onClick) onClick(event);
         },

From 11b042237353a1e0fc082bd1ff63aeaceebe6632 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 17:13:29 +0100
Subject: [PATCH 082/146] use `useEvent` instead of `useCallback`

---
 .../field/useReferenceManyFieldController.ts  | 19 +++----------------
 .../src/controller/list/useSelectAll.tsx      |  7 +++----
 2 files changed, 6 insertions(+), 20 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 6c849e106e2..9267b103994 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -4,7 +4,7 @@ import get from 'lodash/get';
 import isEqual from 'lodash/isEqual';
 import lodashDebounce from 'lodash/debounce';
 
-import { removeEmpty } from '../../util';
+import { removeEmpty, useEvent } from '../../util';
 import { useDataProvider, useGetManyReference } from '../../dataProvider';
 import { useNotify } from '../../notification';
 import { FilterPayload, Identifier, RaRecord, SortPayload } from '../../types';
@@ -202,7 +202,7 @@ export const useReferenceManyFieldController = <
         }
     );
 
-    const onSelectAll = useCallback(
+    const onSelectAll = useEvent(
         async ({
             limit = 250,
             queryOptions = {},
@@ -254,20 +254,7 @@ export const useReferenceManyFieldController = <
                 }
                 notify('ra.notification.simple_error', { type: 'warning' });
             }
-        },
-        [
-            queryClient,
-            resource,
-            sort,
-            filter,
-            selectionModifiers,
-            dataProvider,
-            reference,
-            target,
-            record,
-            source,
-            notify,
-        ]
+        }
     );
 
     return {
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 688595f0e2e..f2dc9ff168a 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -1,9 +1,9 @@
-import { useCallback } from 'react';
 import { useQueryClient } from '@tanstack/react-query';
 
 import { useNotify } from '../../notification';
 import { useDataProvider, UseGetListOptions } from '../../dataProvider';
 import { useRecordSelection } from './useRecordSelection';
+import { useEvent } from '../../util';
 import type { FilterPayload, RaRecord, SortPayload } from '../../types';
 
 /**
@@ -44,7 +44,7 @@ export const useSelectAll = ({
     const [, { select }] = useRecordSelection({ resource });
     const notify = useNotify();
 
-    const handleSelectAll = useCallback(
+    const handleSelectAll = useEvent(
         async ({
             queryOptions = {},
             limit = 250,
@@ -94,8 +94,7 @@ export const useSelectAll = ({
                 }
                 notify('ra.notification.simple_error', { type: 'warning' });
             }
-        },
-        [queryClient, resource, sort, filter, select, dataProvider, notify]
+        }
     );
     return handleSelectAll;
 };

From 3da72ef565f4036a798dea0f47178d147ab60c93 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 17:15:36 +0100
Subject: [PATCH 083/146] revert useless style changes

---
 packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index 29073cef331..1d42530c1f6 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -129,6 +129,10 @@ const Root = styled('div', {
     [`& .${BulkActionsToolbarClasses.title}`]: {
         display: 'flex',
         flex: '0 0 auto',
-        gap: theme.spacing(1),
+    },
+
+    [`& .${BulkActionsToolbarClasses.icon}`]: {
+        marginLeft: '-0.5em',
+        marginRight: '0.5em',
     },
 }));

From f02863bb31fb6476435f2c43f66825e8a21f6fb4 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 17:17:10 +0100
Subject: [PATCH 084/146] group type imports

---
 .../controller/list/useInfiniteListController.ts | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.ts b/packages/ra-core/src/controller/list/useInfiniteListController.ts
index d460a8be797..c83e7ee97af 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.ts
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.ts
@@ -7,11 +7,14 @@ import type {
 import { useAuthenticated, useRequireAccess } from '../../auth';
 import { useTranslate } from '../../i18n';
 import { useNotify } from '../../notification';
-import {
-    type UseInfiniteGetListOptions,
-    useInfiniteGetList,
-} from '../../dataProvider';
+import { useInfiniteGetList } from '../../dataProvider';
 import { defaultExporter } from '../../export';
+import { useResourceContext, useGetResourceLabel } from '../../core';
+import { useRecordSelection } from './useRecordSelection';
+import { useListParams } from './useListParams';
+import { useSelectAll } from './useSelectAll';
+import type { UseInfiniteGetListOptions } from '../../dataProvider';
+import type { ListControllerResult } from './useListController';
 import type {
     RaRecord,
     SortPayload,
@@ -19,11 +22,6 @@ import type {
     Exporter,
     GetInfiniteListResult,
 } from '../../types';
-import { useResourceContext, useGetResourceLabel } from '../../core';
-import { useRecordSelection } from './useRecordSelection';
-import { useListParams } from './useListParams';
-import { useSelectAll } from './useSelectAll';
-import type { ListControllerResult } from './useListController';
 
 /**
  * Prepare data for the InfiniteList view

From 2f315ddeba214d148ca6eb817b8b37e6639a2580 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 17:24:02 +0100
Subject: [PATCH 085/146] make data mare plausible

---
 .../controller/list/useListController.stories.tsx  | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useListController.stories.tsx b/packages/ra-core/src/controller/list/useListController.stories.tsx
index 0918ff9ac21..d94f4fa0f5b 100644
--- a/packages/ra-core/src/controller/list/useListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useListController.stories.tsx
@@ -13,13 +13,13 @@ export default {
 const defaultDataProvider = fakeDataProvider(
     {
         posts: [
-            { id: 1, title: 'Post #1', votes: 90 },
-            { id: 2, title: 'Post #2', votes: 20 },
-            { id: 3, title: 'Post #3', votes: 30 },
-            { id: 4, title: 'Post #4', votes: 40 },
-            { id: 5, title: 'Post #5', votes: 50 },
-            { id: 6, title: 'Post #6', votes: 60 },
-            { id: 7, title: 'Post #7', votes: 70 },
+            { id: 1, title: 'Morbi suscipit malesuada' },
+            { id: 2, title: 'Quisque sodales ipsum' },
+            { id: 3, title: 'Maecenas at tortor' },
+            { id: 4, title: 'Integer commodo est' },
+            { id: 5, title: 'In eget accumsan' },
+            { id: 6, title: 'Curabitur fringilla tellus' },
+            { id: 7, title: 'Nunc ut purus' },
         ],
     },
     process.env.NODE_ENV === 'development'

From 592824f47fc3ed116b7dcd6dae257269dfb8e9cd Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 17:26:20 +0100
Subject: [PATCH 086/146] fix typo in `ListWithCheckboxes` title

---
 .../controller/list/useInfiniteListController.stories.tsx    | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
index e85141fe36d..39b5862ee15 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
@@ -66,7 +66,7 @@ const Posts = ({ children = List, ...props }) => {
     return children(params);
 };
 
-const ListWithCheckbox = params => (
+const ListWithCheckboxes = params => (
     <div style={styles.mainContainer}>
         {params.isPending ? (
             <p>Loading...</p>
@@ -121,7 +121,7 @@ const ListWithCheckbox = params => (
 
 export const Basic = ({
     dataProvider = defaultDataProvider,
-    children = ListWithCheckbox,
+    children = ListWithCheckboxes,
 }: {
     dataProvider?: DataProvider;
     children?: (props) => React.JSX.Element;
@@ -298,6 +298,7 @@ const AccessDenied = () => {
         </div>
     );
 };
+
 const AuthenticationError = () => {
     return (
         <div>

From 14c3aa38e8bc029030153180da5ca6b40f8a2019 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 11 Dec 2024 17:31:46 +0100
Subject: [PATCH 087/146] pass `{children}` as child instead of as prop

---
 .../src/controller/list/useInfiniteListController.spec.tsx  | 2 +-
 .../controller/list/useInfiniteListController.stories.tsx   | 5 +----
 .../ra-core/src/controller/list/useListController.spec.tsx  | 6 +++---
 .../src/controller/list/useListController.stories.tsx       | 2 +-
 4 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index 4a6aec545bd..da94d02c544 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -61,7 +61,7 @@ describe('useInfiniteListController', () => {
     describe('onSelectAll', () => {
         it('should select all items if no items are selected', async () => {
             const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
+            render(<Basic dataProvider={dataProvider}>{children}</Basic>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
index 39b5862ee15..0ab182710b8 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
@@ -130,10 +130,7 @@ export const Basic = ({
         <TestMemoryRouter>
             <CoreAdminContext dataProvider={dataProvider}>
                 <CoreAdminUI>
-                    <Resource
-                        name="posts"
-                        list={<Posts children={children} />}
-                    />
+                    <Resource name="posts" list={<Posts>{children}</Posts>} />
                 </CoreAdminUI>
             </CoreAdminContext>
         </TestMemoryRouter>
diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index f6f83c4d81b..a68a8835b95 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -601,7 +601,7 @@ describe('useListController', () => {
         });
         it('should select all items if no items are selected', async () => {
             const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
+            render(<Basic dataProvider={dataProvider}>{children}</Basic>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll();
             });
@@ -615,7 +615,7 @@ describe('useListController', () => {
         });
         it('should select all items if some items are selected', async () => {
             const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
+            render(<Basic dataProvider={dataProvider}>{children}</Basic>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelect([0]);
             });
@@ -649,7 +649,7 @@ describe('useListController', () => {
             );
             const dataProvider = testDataProvider({ getList });
             const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
+            render(<Basic dataProvider={dataProvider}>{children}</Basic>);
             act(() => {
                 children.mock.calls.at(-1)[0].onSelectAll({ limit: 1 });
             });
diff --git a/packages/ra-core/src/controller/list/useListController.stories.tsx b/packages/ra-core/src/controller/list/useListController.stories.tsx
index d94f4fa0f5b..46caff6244c 100644
--- a/packages/ra-core/src/controller/list/useListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useListController.stories.tsx
@@ -79,6 +79,6 @@ export const Basic = ({
     children?: (params: ListControllerResult) => JSX.Element;
 }) => (
     <CoreAdminContext dataProvider={dataProvider}>
-        <ListController resource="posts" children={children} />
+        <ListController resource="posts">{children}</ListController>
     </CoreAdminContext>
 );

From 9dc0e6478dab2b373c73e50bb4ff040dec590f35 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 12:05:56 +0100
Subject: [PATCH 088/146] stop using `act` in tests

---
 .../useReferenceArrayFieldController.spec.tsx | 34 ++++++-----
 .../useReferenceManyFieldController.spec.tsx  | 60 +++++++++----------
 .../list/useInfiniteListController.spec.tsx   | 51 +++++++++-------
 .../src/controller/list/useList.spec.tsx      | 30 ++++++----
 .../list/useListController.spec.tsx           | 46 +++++++-------
 5 files changed, 121 insertions(+), 100 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 341b419a85e..967b4b31739 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -1,6 +1,6 @@
 import * as React from 'react';
 import expect from 'expect';
-import { act, render, waitFor } from '@testing-library/react';
+import { render, waitFor, screen, fireEvent } from '@testing-library/react';
 
 import { useReferenceArrayFieldController } from './useReferenceArrayFieldController';
 import { testDataProvider } from '../../dataProvider';
@@ -169,11 +169,18 @@ describe('<useReferenceArrayFieldController />', () => {
     });
 
     describe('onSelectAll', () => {
+        const Children = params => (
+            <div>
+                <button onClick={() => params.onSelectAll()}>Select All</button>
+                <span>children</span>
+            </div>
+        );
+
         it('should select all items if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
+            const spiedChildren = jest.fn(Children);
+            render(<ReferenceArrayField>{spiedChildren}</ReferenceArrayField>);
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         data: [
                             { id: 1, title: 'bar1' },
@@ -182,22 +189,21 @@ describe('<useReferenceArrayFieldController />', () => {
                     })
                 );
             });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
+            fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1, 2],
                     })
                 );
             });
         });
+
         it('should select all items if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<ReferenceArrayField>{children}</ReferenceArrayField>);
+            const spiedChildren = jest.fn(Children);
+            render(<ReferenceArrayField>{spiedChildren}</ReferenceArrayField>);
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         data: [
                             { id: 1, title: 'bar1' },
@@ -206,11 +212,9 @@ describe('<useReferenceArrayFieldController />', () => {
                     })
                 );
             });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
+            fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1, 2],
                     })
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index 314c8a40125..44b00b8d97c 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -1,11 +1,5 @@
 import * as React from 'react';
-import {
-    act,
-    fireEvent,
-    render,
-    screen,
-    waitFor,
-} from '@testing-library/react';
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
 import expect from 'expect';
 
 import { testDataProvider } from '../../dataProvider/testDataProvider';
@@ -419,47 +413,54 @@ describe('useReferenceManyFieldController', () => {
             );
         });
     });
+
     describe('onSelectAll', () => {
+        const Children = params => (
+            <div>
+                <button onClick={() => params.onSelectAll()}>Select All</button>
+                <button onClick={() => params.onSelectAll({ limit: 1 })}>
+                    Limited Select All
+                </button>
+                <button onClick={() => params.onSelect([1])}>Select 1</button>
+                <span>children</span>
+            </div>
+        );
+
         it('should select all items if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<ReferenceManyField>{children}</ReferenceManyField>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
+            const spiedChildren = jest.fn(Children);
+            render(<ReferenceManyField>{spiedChildren}</ReferenceManyField>);
+            fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
+
         it('should select all items if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue('child');
-            render(<ReferenceManyField>{children}</ReferenceManyField>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([1]);
-            });
+            const spiedChildren = jest.fn(Children);
+            render(<ReferenceManyField>{spiedChildren}</ReferenceManyField>);
+            fireEvent.click(await screen.findByText('Select 1'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1],
                     })
                 );
             });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
+            fireEvent.click(screen.getByText('Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
                 );
             });
         });
+
         it('should select the maximum items possible until we reached the limit', async () => {
-            const children = jest.fn().mockReturnValue('child');
             const getManyReference = jest
                 .fn()
                 .mockImplementation((_resource, params) =>
@@ -474,24 +475,23 @@ describe('useReferenceManyFieldController', () => {
             const dataProvider = testDataProvider({
                 getManyReference,
             });
+            const spiedChildren = jest.fn(Children);
             render(
                 <ReferenceManyField dataProvider={dataProvider}>
-                    {children}
+                    {spiedChildren}
                 </ReferenceManyField>
             );
             await waitFor(() => {
-                expect(children).toHaveBeenNthCalledWith(
+                expect(spiedChildren).toHaveBeenNthCalledWith(
                     1,
                     expect.objectContaining({
                         selectedIds: [],
                     })
                 );
             });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll({ limit: 1 });
-            });
+            fireEvent.click(await screen.findByText('Limited Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index da94d02c544..bb23153d55c 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -59,14 +59,22 @@ describe('useInfiniteListController', () => {
     });
 
     describe('onSelectAll', () => {
+        const Children = params => (
+            <div>
+                <button onClick={() => params.onSelectAll()}>Select All</button>
+                <button onClick={() => params.onSelectAll({ limit: 1 })}>
+                    Limited Select All
+                </button>
+                <button onClick={() => params.onSelect([0])}>Select 0</button>
+                <span>children</span>
+            </div>
+        );
         it('should select all items if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(<Basic dataProvider={dataProvider}>{children}</Basic>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
+            const spiedChildren = jest.fn(Children);
+            render(<Basic dataProvider={dataProvider}>{spiedChildren}</Basic>);
+            fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -74,23 +82,21 @@ describe('useInfiniteListController', () => {
             });
         });
         it('should select all items if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<span>children</span>);
-            render(<Basic dataProvider={dataProvider} children={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0]);
-            });
+            const spiedChildren = jest.fn(Children);
+            render(
+                <Basic dataProvider={dataProvider} children={spiedChildren} />
+            );
+            fireEvent.click(await screen.findByText('Select 0'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
                 );
             });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
+            fireEvent.click(screen.getByText('Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -108,15 +114,16 @@ describe('useInfiniteListController', () => {
                 })
             );
             const mockedDataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<span>children</span>);
+            const spiedChildren = jest.fn(Children);
             render(
-                <Basic dataProvider={mockedDataProvider} children={children} />
+                <Basic
+                    dataProvider={mockedDataProvider}
+                    children={spiedChildren}
+                />
             );
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll({ limit: 1 });
-            });
+            fireEvent.click(await screen.findByText('Limited Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
diff --git a/packages/ra-core/src/controller/list/useList.spec.tsx b/packages/ra-core/src/controller/list/useList.spec.tsx
index d4e6e122224..7324420eada 100644
--- a/packages/ra-core/src/controller/list/useList.spec.tsx
+++ b/packages/ra-core/src/controller/list/useList.spec.tsx
@@ -1,9 +1,9 @@
 import * as React from 'react';
 import { ReactNode } from 'react';
 import expect from 'expect';
+import { fireEvent, render, waitFor, screen } from '@testing-library/react';
 
 import { useList, UseListOptions, UseListValue } from './useList';
-import { act, fireEvent, render, waitFor } from '@testing-library/react';
 import { ListContextProvider } from './ListContextProvider';
 import { useListContext } from './useListContext';
 
@@ -17,7 +17,17 @@ const UseList = ({
 }) => {
     const value = useList(props);
     callback(value);
-    return <ListContextProvider value={value}>{children}</ListContextProvider>;
+    return (
+        <ListContextProvider value={value}>
+            <button onClick={() => value.onSelectAll()} name="Select All">
+                Select All
+            </button>
+            <button onClick={() => value.onSelect([1])} name="Select item 1">
+                Select item 1
+            </button>
+            {children}
+        </ListContextProvider>
+    );
 };
 
 describe('<useList />', () => {
@@ -321,9 +331,9 @@ describe('<useList />', () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
+            fireEvent.click(
+                await screen.findByRole('button', { name: 'Select All' })
+            );
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
@@ -336,9 +346,9 @@ describe('<useList />', () => {
             const children = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={children} />);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([1]);
-            });
+            fireEvent.click(
+                await screen.findByRole('button', { name: 'Select item 1' })
+            );
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
@@ -346,9 +356,7 @@ describe('<useList />', () => {
                     })
                 );
             });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
+            fireEvent.click(screen.getByRole('button', { name: 'Select All' }));
             await waitFor(() => {
                 expect(children).toHaveBeenCalledWith(
                     expect.objectContaining({
diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index a68a8835b95..1220fc2b072 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -599,14 +599,22 @@ describe('useListController', () => {
                 })
             ),
         });
+        const Children = params => (
+            <div>
+                <button onClick={() => params.onSelectAll()}>Select All</button>
+                <button onClick={() => params.onSelectAll({ limit: 1 })}>
+                    Limited Select All
+                </button>
+                <button onClick={() => params.onSelect([0])}>Select 0</button>
+                <span>children</span>
+            </div>
+        );
         it('should select all items if no items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider}>{children}</Basic>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
+            const spiedChildren = jest.fn(Children);
+            render(<Basic dataProvider={dataProvider}>{spiedChildren}</Basic>);
+            fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -614,23 +622,19 @@ describe('useListController', () => {
             });
         });
         it('should select all items if some items are selected', async () => {
-            const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider}>{children}</Basic>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelect([0]);
-            });
+            const spiedChildren = jest.fn(Children);
+            render(<Basic dataProvider={dataProvider}>{spiedChildren}</Basic>);
+            fireEvent.click(await screen.findByText('Select 0'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
                 );
             });
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll();
-            });
+            fireEvent.click(screen.getByText('Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -648,13 +652,11 @@ describe('useListController', () => {
                 })
             );
             const dataProvider = testDataProvider({ getList });
-            const children = jest.fn().mockReturnValue(<></>);
-            render(<Basic dataProvider={dataProvider}>{children}</Basic>);
-            act(() => {
-                children.mock.calls.at(-1)[0].onSelectAll({ limit: 1 });
-            });
+            const spiedChildren = jest.fn(Children);
+            render(<Basic dataProvider={dataProvider}>{spiedChildren}</Basic>);
+            fireEvent.click(await screen.findByText('Limited Select All'));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(spiedChildren).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })

From 4b5346031d4b2ee2b3d5fb55ef29c4f450b55cc2 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 12:09:04 +0100
Subject: [PATCH 089/146] rename `spiedChildren` into `callback`

---
 .../useReferenceArrayFieldController.spec.tsx | 16 ++++++------
 .../useReferenceManyFieldController.spec.tsx  | 22 ++++++++--------
 .../list/useInfiniteListController.spec.tsx   | 25 ++++++++-----------
 .../src/controller/list/useList.spec.tsx      | 14 +++++------
 .../list/useListController.spec.tsx           | 20 +++++++--------
 5 files changed, 46 insertions(+), 51 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 967b4b31739..611b0a2f04e 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -177,10 +177,10 @@ describe('<useReferenceArrayFieldController />', () => {
         );
 
         it('should select all items if no items are selected', async () => {
-            const spiedChildren = jest.fn(Children);
-            render(<ReferenceArrayField>{spiedChildren}</ReferenceArrayField>);
+            const callback = jest.fn(Children);
+            render(<ReferenceArrayField>{callback}</ReferenceArrayField>);
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         data: [
                             { id: 1, title: 'bar1' },
@@ -191,7 +191,7 @@ describe('<useReferenceArrayFieldController />', () => {
             });
             fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1, 2],
                     })
@@ -200,10 +200,10 @@ describe('<useReferenceArrayFieldController />', () => {
         });
 
         it('should select all items if some items are selected', async () => {
-            const spiedChildren = jest.fn(Children);
-            render(<ReferenceArrayField>{spiedChildren}</ReferenceArrayField>);
+            const callback = jest.fn(Children);
+            render(<ReferenceArrayField>{callback}</ReferenceArrayField>);
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         data: [
                             { id: 1, title: 'bar1' },
@@ -214,7 +214,7 @@ describe('<useReferenceArrayFieldController />', () => {
             });
             fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1, 2],
                     })
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index 44b00b8d97c..71ed11f0b1f 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -427,11 +427,11 @@ describe('useReferenceManyFieldController', () => {
         );
 
         it('should select all items if no items are selected', async () => {
-            const spiedChildren = jest.fn(Children);
-            render(<ReferenceManyField>{spiedChildren}</ReferenceManyField>);
+            const callback = jest.fn(Children);
+            render(<ReferenceManyField>{callback}</ReferenceManyField>);
             fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -440,11 +440,11 @@ describe('useReferenceManyFieldController', () => {
         });
 
         it('should select all items if some items are selected', async () => {
-            const spiedChildren = jest.fn(Children);
-            render(<ReferenceManyField>{spiedChildren}</ReferenceManyField>);
+            const callback = jest.fn(Children);
+            render(<ReferenceManyField>{callback}</ReferenceManyField>);
             fireEvent.click(await screen.findByText('Select 1'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1],
                     })
@@ -452,7 +452,7 @@ describe('useReferenceManyFieldController', () => {
             });
             fireEvent.click(screen.getByText('Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -475,14 +475,14 @@ describe('useReferenceManyFieldController', () => {
             const dataProvider = testDataProvider({
                 getManyReference,
             });
-            const spiedChildren = jest.fn(Children);
+            const callback = jest.fn(Children);
             render(
                 <ReferenceManyField dataProvider={dataProvider}>
-                    {spiedChildren}
+                    {callback}
                 </ReferenceManyField>
             );
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenNthCalledWith(
+                expect(callback).toHaveBeenNthCalledWith(
                     1,
                     expect.objectContaining({
                         selectedIds: [],
@@ -491,7 +491,7 @@ describe('useReferenceManyFieldController', () => {
             });
             fireEvent.click(await screen.findByText('Limited Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index bb23153d55c..159bbbb8b31 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -70,11 +70,11 @@ describe('useInfiniteListController', () => {
             </div>
         );
         it('should select all items if no items are selected', async () => {
-            const spiedChildren = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{spiedChildren}</Basic>);
+            const callback = jest.fn(Children);
+            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -82,13 +82,11 @@ describe('useInfiniteListController', () => {
             });
         });
         it('should select all items if some items are selected', async () => {
-            const spiedChildren = jest.fn(Children);
-            render(
-                <Basic dataProvider={dataProvider} children={spiedChildren} />
-            );
+            const callback = jest.fn(Children);
+            render(<Basic dataProvider={dataProvider} children={callback} />);
             fireEvent.click(await screen.findByText('Select 0'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
@@ -96,7 +94,7 @@ describe('useInfiniteListController', () => {
             });
             fireEvent.click(screen.getByText('Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -114,16 +112,13 @@ describe('useInfiniteListController', () => {
                 })
             );
             const mockedDataProvider = testDataProvider({ getList });
-            const spiedChildren = jest.fn(Children);
+            const callback = jest.fn(Children);
             render(
-                <Basic
-                    dataProvider={mockedDataProvider}
-                    children={spiedChildren}
-                />
+                <Basic dataProvider={mockedDataProvider} children={callback} />
             );
             fireEvent.click(await screen.findByText('Limited Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
diff --git a/packages/ra-core/src/controller/list/useList.spec.tsx b/packages/ra-core/src/controller/list/useList.spec.tsx
index 7324420eada..cd32f54bfd9 100644
--- a/packages/ra-core/src/controller/list/useList.spec.tsx
+++ b/packages/ra-core/src/controller/list/useList.spec.tsx
@@ -328,14 +328,14 @@ describe('<useList />', () => {
 
     describe('onSelectAll', () => {
         it('should select all items if no items are selected', async () => {
-            const children = jest.fn();
+            const callback = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
-            render(<UseList data={data} callback={children} />);
+            render(<UseList data={data} callback={callback} />);
             fireEvent.click(
                 await screen.findByRole('button', { name: 'Select All' })
             );
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -343,14 +343,14 @@ describe('<useList />', () => {
             });
         });
         it('should select all items if some items are selected', async () => {
-            const children = jest.fn();
+            const callback = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
-            render(<UseList data={data} callback={children} />);
+            render(<UseList data={data} callback={callback} />);
             fireEvent.click(
                 await screen.findByRole('button', { name: 'Select item 1' })
             );
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [1],
                     })
@@ -358,7 +358,7 @@ describe('<useList />', () => {
             });
             fireEvent.click(screen.getByRole('button', { name: 'Select All' }));
             await waitFor(() => {
-                expect(children).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index 1220fc2b072..cfd2bb4e726 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -610,11 +610,11 @@ describe('useListController', () => {
             </div>
         );
         it('should select all items if no items are selected', async () => {
-            const spiedChildren = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{spiedChildren}</Basic>);
+            const callback = jest.fn(Children);
+            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -622,11 +622,11 @@ describe('useListController', () => {
             });
         });
         it('should select all items if some items are selected', async () => {
-            const spiedChildren = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{spiedChildren}</Basic>);
+            const callback = jest.fn(Children);
+            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Select 0'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })
@@ -634,7 +634,7 @@ describe('useListController', () => {
             });
             fireEvent.click(screen.getByText('Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0, 1],
                     })
@@ -652,11 +652,11 @@ describe('useListController', () => {
                 })
             );
             const dataProvider = testDataProvider({ getList });
-            const spiedChildren = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{spiedChildren}</Basic>);
+            const callback = jest.fn(Children);
+            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Limited Select All'));
             await waitFor(() => {
-                expect(spiedChildren).toHaveBeenCalledWith(
+                expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
                         selectedIds: [0],
                     })

From 3e8272a479fee1af88ae3fbe89d0147696f4179d Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 12:22:50 +0100
Subject: [PATCH 090/146] do write twice the spied func -> just spy it

---
 .../list/useInfiniteListController.spec.tsx       | 15 ++-------------
 .../controller/list/useListController.spec.tsx    | 11 +----------
 2 files changed, 3 insertions(+), 23 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index 159bbbb8b31..fc874505366 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -102,20 +102,9 @@ describe('useInfiniteListController', () => {
             });
         });
         it('should select the maximum items possible until we reached the limit', async () => {
-            const getList = jest.fn().mockImplementation((_resource, params) =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }].slice(
-                        0,
-                        params.pagination.perPage
-                    ),
-                    total: 2,
-                })
-            );
-            const mockedDataProvider = testDataProvider({ getList });
+            const getList = jest.spyOn(dataProvider, 'getList');
             const callback = jest.fn(Children);
-            render(
-                <Basic dataProvider={mockedDataProvider} children={callback} />
-            );
+            render(<Basic dataProvider={dataProvider} children={callback} />);
             fireEvent.click(await screen.findByText('Limited Select All'));
             await waitFor(() => {
                 expect(callback).toHaveBeenCalledWith(
diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index cfd2bb4e726..9a75219daea 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -642,16 +642,7 @@ describe('useListController', () => {
             });
         });
         it('should select the maximum items possible until we reached the limit', async () => {
-            const getList = jest.fn().mockImplementation((_resource, params) =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }].slice(
-                        0,
-                        params.pagination.perPage
-                    ),
-                    total: 2,
-                })
-            );
-            const dataProvider = testDataProvider({ getList });
+            const getList = jest.spyOn(dataProvider, 'getList');
             const callback = jest.fn(Children);
             render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Limited Select All'));

From b9142aeab75842adc205afa380003eb2af621388 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 12:26:50 +0100
Subject: [PATCH 091/146] pass children as child instead of prop

---
 .../src/controller/list/useInfiniteListController.spec.tsx    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index fc874505366..c0e69ea1e2c 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -83,7 +83,7 @@ describe('useInfiniteListController', () => {
         });
         it('should select all items if some items are selected', async () => {
             const callback = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider} children={callback} />);
+            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Select 0'));
             await waitFor(() => {
                 expect(callback).toHaveBeenCalledWith(
@@ -104,7 +104,7 @@ describe('useInfiniteListController', () => {
         it('should select the maximum items possible until we reached the limit', async () => {
             const getList = jest.spyOn(dataProvider, 'getList');
             const callback = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider} children={callback} />);
+            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Limited Select All'));
             await waitFor(() => {
                 expect(callback).toHaveBeenCalledWith(

From 17b4b30b9e8943c0fc83a7bf2715ab4d972f63c7 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 12:38:16 +0100
Subject: [PATCH 092/146] improve test names

---
 .../field/useReferenceArrayFieldController.spec.tsx         | 4 ++--
 .../field/useReferenceManyFieldController.spec.tsx          | 6 +++---
 .../src/controller/list/useInfiniteListController.spec.tsx  | 6 +++---
 packages/ra-core/src/controller/list/useList.spec.tsx       | 4 ++--
 .../ra-core/src/controller/list/useListController.spec.tsx  | 6 +++---
 .../ra-ui-materialui/src/button/SelectAllButton.spec.tsx    | 2 +-
 6 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 611b0a2f04e..e5ae3e082a7 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -176,7 +176,7 @@ describe('<useReferenceArrayFieldController />', () => {
             </div>
         );
 
-        it('should select all items if no items are selected', async () => {
+        it('should select all records', async () => {
             const callback = jest.fn(Children);
             render(<ReferenceArrayField>{callback}</ReferenceArrayField>);
             await waitFor(() => {
@@ -199,7 +199,7 @@ describe('<useReferenceArrayFieldController />', () => {
             });
         });
 
-        it('should select all items if some items are selected', async () => {
+        it('should select all records even though some records are already selected', async () => {
             const callback = jest.fn(Children);
             render(<ReferenceArrayField>{callback}</ReferenceArrayField>);
             await waitFor(() => {
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index 71ed11f0b1f..9802487484e 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -426,7 +426,7 @@ describe('useReferenceManyFieldController', () => {
             </div>
         );
 
-        it('should select all items if no items are selected', async () => {
+        it('should select all records', async () => {
             const callback = jest.fn(Children);
             render(<ReferenceManyField>{callback}</ReferenceManyField>);
             fireEvent.click(await screen.findByText('Select All'));
@@ -439,7 +439,7 @@ describe('useReferenceManyFieldController', () => {
             });
         });
 
-        it('should select all items if some items are selected', async () => {
+        it('should select all records even though some records are already selected', async () => {
             const callback = jest.fn(Children);
             render(<ReferenceManyField>{callback}</ReferenceManyField>);
             fireEvent.click(await screen.findByText('Select 1'));
@@ -460,7 +460,7 @@ describe('useReferenceManyFieldController', () => {
             });
         });
 
-        it('should select the maximum items possible until we reached the limit', async () => {
+        it('should not select more records than the provided limit', async () => {
             const getManyReference = jest
                 .fn()
                 .mockImplementation((_resource, params) =>
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index c0e69ea1e2c..44053b24624 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -69,7 +69,7 @@ describe('useInfiniteListController', () => {
                 <span>children</span>
             </div>
         );
-        it('should select all items if no items are selected', async () => {
+        it('should select all records', async () => {
             const callback = jest.fn(Children);
             render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Select All'));
@@ -81,7 +81,7 @@ describe('useInfiniteListController', () => {
                 );
             });
         });
-        it('should select all items if some items are selected', async () => {
+        it('should select all records even though some records are already selected', async () => {
             const callback = jest.fn(Children);
             render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Select 0'));
@@ -101,7 +101,7 @@ describe('useInfiniteListController', () => {
                 );
             });
         });
-        it('should select the maximum items possible until we reached the limit', async () => {
+        it('should not select more records than the provided limit', async () => {
             const getList = jest.spyOn(dataProvider, 'getList');
             const callback = jest.fn(Children);
             render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
diff --git a/packages/ra-core/src/controller/list/useList.spec.tsx b/packages/ra-core/src/controller/list/useList.spec.tsx
index cd32f54bfd9..e4c792343fb 100644
--- a/packages/ra-core/src/controller/list/useList.spec.tsx
+++ b/packages/ra-core/src/controller/list/useList.spec.tsx
@@ -327,7 +327,7 @@ describe('<useList />', () => {
     });
 
     describe('onSelectAll', () => {
-        it('should select all items if no items are selected', async () => {
+        it('should select all records', async () => {
             const callback = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={callback} />);
@@ -342,7 +342,7 @@ describe('<useList />', () => {
                 );
             });
         });
-        it('should select all items if some items are selected', async () => {
+        it('should select all records even though some records are already selected', async () => {
             const callback = jest.fn();
             const data = [{ id: 0 }, { id: 1 }];
             render(<UseList data={data} callback={callback} />);
diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index 9a75219daea..b145bf2e7a2 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -609,7 +609,7 @@ describe('useListController', () => {
                 <span>children</span>
             </div>
         );
-        it('should select all items if no items are selected', async () => {
+        it('should select all records', async () => {
             const callback = jest.fn(Children);
             render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Select All'));
@@ -621,7 +621,7 @@ describe('useListController', () => {
                 );
             });
         });
-        it('should select all items if some items are selected', async () => {
+        it('should select all records even though some records are already selected', async () => {
             const callback = jest.fn(Children);
             render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Select 0'));
@@ -641,7 +641,7 @@ describe('useListController', () => {
                 );
             });
         });
-        it('should select the maximum items possible until we reached the limit', async () => {
+        it('should not select more records than the provided limit', async () => {
             const getList = jest.spyOn(dataProvider, 'getList');
             const callback = jest.fn(Children);
             render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
index e9f1c6a868b..1369a75fbbe 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
@@ -24,7 +24,7 @@ describe('<SelectAllButton />', () => {
         await screen.findByText('1 item selected');
         await screen.findByRole('button', { name: 'Select all books' });
     });
-    it('should select all items until the limit is reached', async () => {
+    it('should not select more records than the limit', async () => {
         render(<Limit />);
         await screen.findByText('War and Peace');
         fireEvent.click(screen.getAllByRole('checkbox')[1]);

From 0c254268dfb52d86d84966e74781aed928912cc0 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 12:39:18 +0100
Subject: [PATCH 093/146] improve story label

---
 .../ra-ui-materialui/src/button/SelectAllButton.stories.tsx     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
index efccfc2cf12..7dd56e38682 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
@@ -120,7 +120,7 @@ export const Label = () => (
 export const Limit = () => (
     <Wrapper
         bulkActionButtons={
-            <SelectAllButton label="Select 5 first books" limit={5} />
+            <SelectAllButton label="Select all books (max 5)" limit={5} />
         }
     />
 );

From 8a647e5b416df1ecd6436e2c451fad4e6b73e152 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 13:33:26 +0100
Subject: [PATCH 094/146] isolate type imports

---
 packages/ra-ui-materialui/src/button/SelectAllButton.tsx | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index f447306481d..31499d47bbf 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -1,6 +1,6 @@
 import React, { useCallback } from 'react';
+import { useListContext } from 'ra-core';
 import {
-    useListContext,
     type RaRecord,
     type UseGetListOptions,
     type UseReferenceArrayFieldControllerParams,
@@ -23,7 +23,6 @@ import { Button, ButtonProps } from './Button';
  * @param {Props} props
  *
  * @example
- *
  * const MySelectAllButton = () => <SelectAllButton limit={100} label="Select all books" />;
  */
 

From 7f119de4322c484bbcb6842318927f7bd1b66966 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 13:37:40 +0100
Subject: [PATCH 095/146] adapt test with the new button label

---
 packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
index 1369a75fbbe..fa64f8e7dcf 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
@@ -30,7 +30,7 @@ describe('<SelectAllButton />', () => {
         fireEvent.click(screen.getAllByRole('checkbox')[1]);
         await screen.findByText('1 item selected');
         fireEvent.click(
-            screen.getByRole('button', { name: 'Select 5 first books' })
+            screen.getByRole('button', { name: 'Select all books (max 5)' })
         );
         await screen.findByText(
             'There are too many elements to select them all. Only the first 5 elements were selected.'

From 605f303b4e0930fcace9832f5876987f78a524da Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 13:57:08 +0100
Subject: [PATCH 096/146] moove the `SelectAllButton`

---
 .../src/button/SelectAllButton.stories.tsx    | 21 +++++----
 .../src/field/ReferenceManyField.stories.tsx  | 25 +++++------
 .../src/list/BulkActionsToolbar.tsx           | 14 +++++-
 .../src/list/InfiniteList.stories.tsx         | 16 +++----
 .../src/list/List.stories.tsx                 | 14 +++---
 .../src/list/datagrid/Datagrid.stories.tsx    | 43 ++++++++++++++++++-
 .../src/list/datagrid/Datagrid.tsx            | 35 +++++++++------
 7 files changed, 113 insertions(+), 55 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
index 7dd56e38682..c4de886c4ff 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
@@ -7,8 +7,9 @@ import fakeRestDataProvider from 'ra-data-fakerest';
 import { SelectAllButton } from './SelectAllButton';
 import { AdminContext } from '../AdminContext';
 import { AdminUI } from '../AdminUI';
-import { List, Datagrid } from '../list';
+import { List, Datagrid, BulkActionsToolbar } from '../list';
 import { TextField, NumberField } from '../field';
+import { BulkDeleteButton } from './BulkDeleteButton';
 
 export default { title: 'ra-ui-materialui/button/SelectAllButton' };
 
@@ -89,7 +90,7 @@ const dataProvider = fakeRestDataProvider({
     authors: [],
 });
 
-const Wrapper = ({ bulkActionButtons }) => (
+const Wrapper = ({ actions }) => (
     <TestMemoryRouter initialEntries={['/books']}>
         <AdminContext dataProvider={dataProvider} i18nProvider={i18nProvider}>
             <AdminUI>
@@ -97,7 +98,13 @@ const Wrapper = ({ bulkActionButtons }) => (
                     name="books"
                     list={() => (
                         <List>
-                            <Datagrid bulkActionButtons={bulkActionButtons}>
+                            <Datagrid
+                                bulkActionsToolbar={
+                                    <BulkActionsToolbar actions={actions}>
+                                        <BulkDeleteButton />
+                                    </BulkActionsToolbar>
+                                }
+                            >
                                 <TextField source="id" />
                                 <TextField source="title" />
                                 <TextField source="author" />
@@ -111,16 +118,14 @@ const Wrapper = ({ bulkActionButtons }) => (
     </TestMemoryRouter>
 );
 
-export const Basic = () => <Wrapper bulkActionButtons={<SelectAllButton />} />;
+export const Basic = () => <Wrapper actions={<SelectAllButton />} />;
 
 export const Label = () => (
-    <Wrapper bulkActionButtons={<SelectAllButton label="Select all books" />} />
+    <Wrapper actions={<SelectAllButton label="Select all books" />} />
 );
 
 export const Limit = () => (
     <Wrapper
-        bulkActionButtons={
-            <SelectAllButton label="Select all books (max 5)" limit={5} />
-        }
+        actions={<SelectAllButton label="Select all books (max 5)" limit={5} />}
     />
 );
diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
index 9bd00f5facb..a84b76dcbc7 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
@@ -6,13 +6,8 @@ import {
     ResourceContextProvider,
     TestMemoryRouter,
 } from 'ra-core';
-import {
-    Admin,
-    AdminProps,
-    type DatagridProps,
-    ListGuesser,
-    Resource,
-} from 'react-admin';
+import { Admin, ListGuesser, Resource } from 'react-admin';
+import type { AdminProps } from 'react-admin';
 import { ThemeProvider, Box, Stack } from '@mui/material';
 import { createTheme } from '@mui/material/styles';
 import fakeDataProvider from 'ra-data-fakerest';
@@ -22,13 +17,14 @@ import englishMessages from 'ra-language-english';
 import { TextField } from '../field';
 import { ReferenceManyField } from './ReferenceManyField';
 import { Datagrid } from '../list/datagrid/Datagrid';
-import { Pagination, SingleFieldList } from '../list';
+import { BulkActionsToolbar, Pagination, SingleFieldList } from '../list';
 import { Notification } from '../layout/Notification';
 import { FilterForm } from '../list';
 import { TextInput } from '../input';
 import { Edit } from '../detail';
 import { SimpleForm } from '../form';
 import { SelectAllButton, BulkDeleteButton } from '../button';
+import type { DatagridProps } from '../list/datagrid/Datagrid';
 
 export default { title: 'ra-ui-materialui/fields/ReferenceManyField' };
 
@@ -194,10 +190,10 @@ export const StoreKey = () => (
 
 export const WithPagination = ({
     dataProvider = fullDataProvider,
-    bulkActionButtons,
+    bulkActionsToolbar,
 }: {
     dataProvider?: AdminProps['dataProvider'];
-    bulkActionButtons?: DatagridProps['bulkActionButtons'];
+    bulkActionsToolbar?: DatagridProps['bulkActionsToolbar'];
 }) => (
     <Wrapper
         i18nProvider={polyglotI18nProvider(() => englishMessages)}
@@ -210,7 +206,7 @@ export const WithPagination = ({
             pagination={<Pagination />}
             perPage={5}
         >
-            <Datagrid bulkActionButtons={bulkActionButtons}>
+            <Datagrid bulkActionsToolbar={bulkActionsToolbar}>
                 <TextField source="title" />
             </Datagrid>
         </ReferenceManyField>
@@ -225,11 +221,10 @@ export const WithPaginationAndSelectAllLimit = ({
     limit?: number;
 }) => (
     <WithPagination
-        bulkActionButtons={
-            <>
-                <SelectAllButton limit={limit} />
+        bulkActionsToolbar={
+            <BulkActionsToolbar actions={<SelectAllButton limit={limit} />}>
                 <BulkDeleteButton />
-            </>
+            </BulkActionsToolbar>
         }
         dataProvider={dataProvider}
     />
diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index 1d42530c1f6..ce0628de40b 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { ReactNode, useCallback } from 'react';
+import { isValidElement, ReactElement, ReactNode, useCallback } from 'react';
 import { styled } from '@mui/material/styles';
 import clsx from 'clsx';
 import Toolbar from '@mui/material/Toolbar';
@@ -10,12 +10,16 @@ import CloseIcon from '@mui/icons-material/Close';
 import { useTranslate, sanitizeListRestProps, useListContext } from 'ra-core';
 
 import TopToolbar from '../layout/TopToolbar';
+import { SelectAllButton } from '../button';
+
+const defaultActions = <SelectAllButton />;
 
 export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
     const {
         label = 'ra.action.bulk_actions',
         children,
         className,
+        actions = defaultActions,
         ...rest
     } = props;
     const { selectedIds = [], onUnselectItems } = useListContext();
@@ -52,6 +56,11 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
                             smart_count: selectedIds.length,
                         })}
                     </Typography>
+                    {actions !== false
+                        ? isValidElement(actions)
+                            ? actions
+                            : defaultActions
+                        : null}
                 </div>
                 <TopToolbar className={BulkActionsToolbarClasses.topToolbar}>
                     {children}
@@ -65,6 +74,7 @@ export interface BulkActionsToolbarProps {
     children?: ReactNode;
     label?: string;
     className?: string;
+    actions?: ReactElement | false;
 }
 
 const PREFIX = 'RaBulkActionsToolbar';
@@ -129,10 +139,10 @@ const Root = styled('div', {
     [`& .${BulkActionsToolbarClasses.title}`]: {
         display: 'flex',
         flex: '0 0 auto',
+        gap: theme.spacing(1),
     },
 
     [`& .${BulkActionsToolbarClasses.icon}`]: {
         marginLeft: '-0.5em',
-        marginRight: '0.5em',
     },
 }));
diff --git a/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx b/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
index 3f530d4b68e..2f865d878cc 100644
--- a/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/InfiniteList.stories.tsx
@@ -23,6 +23,7 @@ import { TextField } from '../field';
 import { SearchInput } from '../input';
 import { BulkDeleteButton, SelectAllButton, SortButton } from '../button';
 import { TopToolbar, Layout } from '../layout';
+import { BulkActionsToolbar } from './BulkActionsToolbar';
 
 export default {
     title: 'ra-ui-materialui/list/InfiniteList',
@@ -346,16 +347,16 @@ export const WithFooter = () => (
 );
 
 export const WithDatagrid = ({
-    bulkActionButtons,
+    bulkActionsToolbar,
 }: {
-    bulkActionButtons?: DatagridProps['bulkActionButtons'];
+    bulkActionsToolbar?: DatagridProps['bulkActionsToolbar'];
 }) => (
     <Admin dataProvider={dataProvider}>
         <Resource
             name="books"
             list={() => (
                 <InfiniteList>
-                    <Datagrid bulkActionButtons={bulkActionButtons}>
+                    <Datagrid bulkActionsToolbar={bulkActionsToolbar}>
                         <TextField source="id" />
                         <TextField source="title" />
                         <TextField source="author" />
@@ -367,16 +368,15 @@ export const WithDatagrid = ({
 );
 
 export const WithDatagridAndSelectAllLimit = ({
-    limit = 6,
+    limit = 23,
 }: {
     limit?: number;
 }) => (
     <WithDatagrid
-        bulkActionButtons={
-            <>
-                <SelectAllButton limit={limit} />
+        bulkActionsToolbar={
+            <BulkActionsToolbar actions={<SelectAllButton limit={limit} />}>
                 <BulkDeleteButton />
-            </>
+            </BulkActionsToolbar>
         }
     />
 );
diff --git a/packages/ra-ui-materialui/src/list/List.stories.tsx b/packages/ra-ui-materialui/src/list/List.stories.tsx
index afd4c307599..64630405708 100644
--- a/packages/ra-ui-materialui/src/list/List.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/List.stories.tsx
@@ -21,6 +21,7 @@ import { Link } from 'react-router-dom';
 import { BulkDeleteButton, ListButton, SelectAllButton } from '../button';
 import { ShowGuesser } from '../detail';
 import TopToolbar from '../layout/TopToolbar';
+import { BulkActionsToolbar } from './BulkActionsToolbar';
 
 export default { title: 'ra-ui-materialui/list/List' };
 
@@ -469,11 +470,11 @@ export const Meta = () => (
 export const Default = ({
     dataProvider = defaultDataProvider,
     children,
-    bulkActionButtons,
+    bulkActionsToolbar,
 }: {
     dataProvider?: DataProvider;
     children?: React.ReactNode;
-    bulkActionButtons?: DatagridProps['bulkActionButtons'];
+    bulkActionsToolbar?: DatagridProps['bulkActionsToolbar'];
 }) => (
     <TestMemoryRouter initialEntries={['/books']}>
         <Admin dataProvider={dataProvider}>
@@ -481,7 +482,7 @@ export const Default = ({
                 name="books"
                 list={() => (
                     <List filters={[<SearchInput source="q" alwaysOn />]}>
-                        <Datagrid bulkActionButtons={bulkActionButtons}>
+                        <Datagrid bulkActionsToolbar={bulkActionsToolbar}>
                             <TextField source="id" />
                             <TextField source="title" />
                             <TextField source="author" />
@@ -505,11 +506,10 @@ export const SelectAllLimit = ({
     limit?: number;
 }) => (
     <Default
-        bulkActionButtons={
-            <>
-                <SelectAllButton limit={limit} />
+        bulkActionsToolbar={
+            <BulkActionsToolbar actions={<SelectAllButton limit={limit} />}>
                 <BulkDeleteButton />
-            </>
+            </BulkActionsToolbar>
         }
         dataProvider={dataProvider}
     >
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
index 86720dc5bf6..498dfd79f20 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
@@ -21,7 +21,11 @@ import { Box, Checkbox, TableCell, TableRow, styled } from '@mui/material';
 import { createTheme, ThemeProvider } from '@mui/material/styles';
 
 import { FieldProps, TextField } from '../../field';
-import { BulkDeleteButton, BulkExportButton } from '../../button';
+import {
+    BulkDeleteButton,
+    BulkExportButton,
+    SelectAllButton,
+} from '../../button';
 import { Datagrid, DatagridProps } from './Datagrid';
 import { ShowGuesser, SimpleShowLayout } from '../../detail';
 import { AdminUI } from '../../AdminUI';
@@ -30,6 +34,7 @@ import { List } from '../List';
 import { EditGuesser } from '../../detail';
 import { DatagridRowProps } from './DatagridRow';
 import DatagridBody, { DatagridBodyProps } from './DatagridBody';
+import { BulkActionsToolbar } from '../BulkActionsToolbar';
 
 export default { title: 'ra-ui-materialui/list/Datagrid' };
 
@@ -182,6 +187,42 @@ export const RowSx = () => (
     </Wrapper>
 );
 
+const CutomBulkActionToolbar = () => (
+    <BulkActionsToolbar
+        actions={<SelectAllButton label="Select all records" />}
+    >
+        <BulkDeleteButton />
+    </BulkActionsToolbar>
+);
+
+export const BulkActionToolbar = () => (
+    <Wrapper>
+        <Box sx={{ mt: -7 }}>
+            <h1>Default</h1>
+            <Datagrid>
+                <TextField source="id" />
+                <TextField source="title" />
+                <TextField source="author" />
+                <TextField source="year" />
+            </Datagrid>
+            <h1>Disabled</h1>
+            <Datagrid bulkActionsToolbar={false}>
+                <TextField source="id" />
+                <TextField source="title" />
+                <TextField source="author" />
+                <TextField source="year" />
+            </Datagrid>
+            <h1>Custom</h1>
+            <Datagrid bulkActionsToolbar={<CutomBulkActionToolbar />}>
+                <TextField source="id" />
+                <TextField source="title" />
+                <TextField source="author" />
+                <TextField source="year" />
+            </Datagrid>
+        </Box>
+    </Wrapper>
+);
+
 const CutomBulkActionButtons = () => (
     <>
         <BulkExportButton />
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
index 29e01ee5108..0cbf5c9f07e 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
@@ -35,14 +35,8 @@ import { DatagridClasses, DatagridRoot } from './useDatagridStyles';
 import { BulkActionsToolbar } from '../BulkActionsToolbar';
 import { BulkDeleteButton } from '../../button';
 import { ListNoResults } from '../ListNoResults';
-import { SelectAllButton } from '../../button/SelectAllButton';
 
-const defaultBulkActionButtons = (
-    <>
-        <SelectAllButton />
-        <BulkDeleteButton />
-    </>
-);
+const defaultBulkActionButtons = <BulkDeleteButton />;
 
 /**
  * The Datagrid component renders a list of records as a table.
@@ -50,6 +44,7 @@ const defaultBulkActionButtons = (
  *
  * Props:
  *  - body
+ *  - bulkActionToolbar
  *  - bulkActionButtons
  *  - children
  *  - empty
@@ -138,6 +133,7 @@ export const Datagrid: React.ForwardRefExoticComponent<
         className,
         empty = DefaultEmpty,
         expand,
+        bulkActionsToolbar,
         bulkActionButtons = canDelete ? defaultBulkActionButtons : false,
         hover,
         isRowSelectable,
@@ -250,13 +246,15 @@ export const Datagrid: React.ForwardRefExoticComponent<
                     sx={sx}
                     className={clsx(DatagridClasses.root, className)}
                 >
-                    {bulkActionButtons !== false ? (
-                        <BulkActionsToolbar>
-                            {isValidElement(bulkActionButtons)
-                                ? bulkActionButtons
-                                : defaultBulkActionButtons}
-                        </BulkActionsToolbar>
-                    ) : null}
+                    {bulkActionButtons !== false && bulkActionsToolbar !== false
+                        ? bulkActionsToolbar || (
+                              <BulkActionsToolbar>
+                                  {isValidElement(bulkActionButtons)
+                                      ? bulkActionButtons
+                                      : defaultBulkActionButtons}
+                              </BulkActionsToolbar>
+                          )
+                        : null}
                     <div className={DatagridClasses.tableWrapper}>
                         <Table
                             ref={ref}
@@ -323,6 +321,15 @@ export interface DatagridProps<RecordType extends RaRecord = any>
      */
     className?: string;
 
+    /**
+     * The component used to render the bulk actions toolbar. Defaults to <BulkActionsToolbar>.
+     *
+     * @see https://marmelab.com/react-admin/Datagrid.html#bulkactionstoolbar (TODO: write doc)
+     * @example
+     * TODO: write example
+     */
+    bulkActionsToolbar?: ReactElement | false;
+
     /**
      * The component used to render the bulk action buttons. Defaults to <BulkDeleteButton>.
      *

From 356351705c3f5b7b0fcb10c2fc07c095918f0a4a Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 14:03:32 +0100
Subject: [PATCH 097/146] test the new `bulkActionsToolbar` Datagrid's prop

---
 .../src/list/datagrid/Datagrid.spec.tsx       | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
index b6561360807..02f3ef80be9 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
@@ -8,8 +8,11 @@ import {
     ResourceContextProvider,
 } from 'ra-core';
 import { ThemeProvider, createTheme } from '@mui/material';
+
 import { Datagrid } from './Datagrid';
+import { SelectAllButton } from '../../button';
 import { AccessControl } from './Datagrid.stories';
+import { BulkActionsToolbar } from '../BulkActionsToolbar';
 
 const TitleField = (): JSX.Element => {
     const record = useRecordContext();
@@ -113,6 +116,38 @@ describe('<Datagrid />', () => {
         );
     });
 
+    it('should accept a custom bulkActionsToolbar', () => {
+        render(
+            <Wrapper listContext={contextValue}>
+                <Datagrid
+                    bulkActionsToolbar={
+                        <BulkActionsToolbar
+                            actions={
+                                <SelectAllButton label="Select All Records" />
+                            }
+                        />
+                    }
+                >
+                    <TitleField />
+                </Datagrid>
+            </Wrapper>
+        );
+        expect(screen.queryByText('Delete')).toBeNull();
+        expect(screen.queryByText('Select All Records')).not.toBeNull();
+    });
+
+    it('should not display the bulk actions toolbar when when `bulkActionsToolbar` prop is true', () => {
+        render(
+            <Wrapper listContext={contextValue}>
+                <Datagrid bulkActionsToolbar={false}>
+                    <TitleField />
+                </Datagrid>
+            </Wrapper>
+        );
+        expect(screen.queryByText('Delete')).toBeNull();
+        expect(screen.queryByText('Select All')).toBeNull();
+    });
+
     describe('selecting items with the shift key', () => {
         it('should call onSelect with the correct ids when the last selection is after the first', () => {
             const Test = ({ selectedIds = [] }) => (

From 0f0b22efe29dc83543ae034888236b36090e7ac6 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 14:11:53 +0100
Subject: [PATCH 098/146] Adapt SelectAllButton doc to the new place

---
 docs/Buttons.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/Buttons.md b/docs/Buttons.md
index c0c67bc981f..aad494543e7 100644
--- a/docs/Buttons.md
+++ b/docs/Buttons.md
@@ -958,14 +958,14 @@ To override the style of all instances of `<FilterButton>` using the [applicatio
 
 ## `<SelectAllButton>`
 
-This button is an internal component used by react-admin in [the Datagrid default `bulkActionButtons`](./Datagrid.md#bulkactionbuttons).
+This button is an internal component used by react-admin in [the Datagrid default `bulkActionsToolbar`](./Datagrid.md#bulkactionstoolbar).
 The `<SelectAllButton>` component is a button that is used to select all items from a resource, no matter the pagination.
 
 ![SelectAllButton](./img/SelectAllButton.png)
 
 ### `label`
 
-By default, the `<SelectAllButton>` label is "Select all" (or the `ra.action.select_all` message translation). You can also pass a custom `label`:
+By default, the `<SelectAllButton>` label is "Select all" (or the `ra.action.select_all_button` message translation). You can also pass a custom `label`:
 
 ```jsx
 const PostSelectAllButton = () => <SelectAllButton label="Select all posts" />;

From 4cfc3a28a65df310fcdba38bd57e4a4f5c34a4e6 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 14:54:07 +0100
Subject: [PATCH 099/146] Update Datagrid doc

---
 docs/Datagrid.md                              | 95 +++++++++++++++----
 .../src/list/datagrid/Datagrid.tsx            |  2 +-
 2 files changed, 76 insertions(+), 21 deletions(-)

diff --git a/docs/Datagrid.md b/docs/Datagrid.md
index d71994e0012..ab215d1faa5 100644
--- a/docs/Datagrid.md
+++ b/docs/Datagrid.md
@@ -45,24 +45,25 @@ Both are [Enterprise Edition](https://react-admin-ee.marmelab.com) components.
 
 ## Props
 
-| Prop                | Required | Type                    | Default               | Description                                                   |
-| ------------------- | -------- | ----------------------- | --------------------- | ------------------------------------------------------------- |
-| `children`          | Required | Element                 | n/a                   | The list of `<Field>` components to render as columns.        |
-| `body`              | Optional | Element                 | `<Datagrid Body>`     | The component used to render the body of the table.           |
-| `bulkActionButtons` | Optional | Element                 | `<BulkDelete Button>` | The component used to render the bulk action buttons.         |
-| `empty`             | Optional | Element                 | `<Empty>`             | The component used to render the empty table.                 |
-| `expand`            | Optional | Element                 |                       | The component used to render the expand panel for each row.   |
-| `expandSingle`      | Optional | Boolean                 | `false`               | Whether to allow only one expanded row at a time.             |
-| `header`            | Optional | Element                 | `<Datagrid Header>`   | The component used to render the table header.                |
-| `hover`             | Optional | Boolean                 | `true`                | Whether to highlight the row under the mouse.                 |
-| `isRowExpandable`   | Optional | Function                | `() => true`          | A function that returns whether a row is expandable.          |
-| `isRowSelectable`   | Optional | Function                | `() => true`          | A function that returns whether a row is selectable.          |
-| `optimized`         | Optional | Boolean                 | `false`               | Whether to optimize the rendering of the table.               |
-| `rowClick`          | Optional | mixed                   |                       | The action to trigger when the user clicks on a row.          |
-| `rowStyle`          | Optional | Function                |                       | A function that returns the style to apply to a row.          |
-| `rowSx`             | Optional | Function                |                       | A function that returns the sx prop to apply to a row.        |
-| `size`              | Optional | `'small'` or `'medium'` | `'small'`             | The size of the table.                                        |
-| `sx`                | Optional | Object                  |                       | The sx prop passed down to the Material UI `<Table>` element. |
+| Prop                 | Required | Type                    | Default               | Description                                                   |
+| -------------------- | -------- | ----------------------- | --------------------- | ------------------------------------------------------------- |
+| `children`           | Required | Element                 | n/a                   | The list of `<Field>` components to render as columns.        |
+| `body`               | Optional | Element                 | `<Datagrid Body>`     | The component used to render the body of the table.           |
+| `bulkActionButtons`  | Optional | Element                 | `<BulkDelete Button>` | The component used to render the bulk action buttons.         |
+| `bulkActionsToolbar` | Optional | Element                 |                       | The component used to render the bulk actions toolbar.        |
+| `empty`              | Optional | Element                 | `<Empty>`             | The component used to render the empty table.                 |
+| `expand`             | Optional | Element                 |                       | The component used to render the expand panel for each row.   |
+| `expandSingle`       | Optional | Boolean                 | `false`               | Whether to allow only one expanded row at a time.             |
+| `header`             | Optional | Element                 | `<Datagrid Header>`   | The component used to render the table header.                |
+| `hover`              | Optional | Boolean                 | `true`                | Whether to highlight the row under the mouse.                 |
+| `isRowExpandable`    | Optional | Function                | `() => true`          | A function that returns whether a row is expandable.          |
+| `isRowSelectable`    | Optional | Function                | `() => true`          | A function that returns whether a row is selectable.          |
+| `optimized`          | Optional | Boolean                 | `false`               | Whether to optimize the rendering of the table.               |
+| `rowClick`           | Optional | mixed                   |                       | The action to trigger when the user clicks on a row.          |
+| `rowStyle`           | Optional | Function                |                       | A function that returns the style to apply to a row.          |
+| `rowSx`              | Optional | Function                |                       | A function that returns the sx prop to apply to a row.        |
+| `size`               | Optional | `'small'` or `'medium'` | `'small'`             | The size of the table.                                        |
+| `sx`                 | Optional | Object                  |                       | The sx prop passed down to the Material UI `<Table>` element. |
 
 Additional props are passed down to [the Material UI `<Table>` element](https://mui.com/material-ui/api/table/).
 
@@ -166,13 +167,12 @@ By default, all Datagrids have a single bulk action button, the bulk delete butt
 
 {% raw %}
 ```tsx
-import { List, Datagrid, SelectAllButton, BulkUpdateButton, BulkDeleteButton, BulkExportButton } from 'react-admin';
+import { List, Datagrid, BulkUpdateButton, BulkDeleteButton, BulkExportButton } from 'react-admin';
 import { VisibilityOff } from '@mui/icons-material';
 
 const PostBulkActionButtons = () => (
     <>
         <BulkUpdateButton label="Reset Views" data={{ views: 0 }} icon={<VisibilityOff/>} />
-        <SelectAllButton />
         <BulkDeleteButton />
         <BulkExportButton />
     </>
@@ -374,6 +374,61 @@ const CustomResetViewsButton = () => {
 };
 ```
 
+## `bulkActionsToolbar`
+
+You can use the `bulkActionsToolbar` prop to customize the bulk action toolbar, displayed when at least one row is selected.
+
+You disable this feature by setting the `bulkActionsToolbar` prop to `false`:
+
+```tsx
+import { Datagrid, List } from 'react-admin';
+
+export const PostList = () => (
+    <List>
+        <Datagrid bulkActionsToolbar={false}>
+            ...
+        </Datagrid>
+    </List>
+);
+```
+
+By default, all Datagrids have a single `action`, [the select all button](./Buttons.md#selectallbutton).
+You can customize this button or add others by passing a custom element as the `bulkActionsToolbar` prop of the `<Datagrid>` component:
+
+{% raw %}
+
+```tsx
+import { List, Datagrid, BulkActionsToolbar, SelectAllButton, BulkDeleteButtonn useUnselectAll, Button } from 'react-admin';
+
+const UnselectButton = () => {
+    const unselect = useUnselectAll('posts');
+    return <Button onClick={unselect} label="Unselect all records" />;
+};
+
+const PostBulkActionsToolbar = () => (
+    <BulkActionsToolbar actions={
+        <>
+            <SelectAllButton label="Select all records" />
+            <UnselectButton />
+        </>
+    }>
+        <BulkDeleteButton />
+    </BulkActionsToolbar>
+);
+
+export const PostList = () => (
+    <List>
+        <Datagrid bulkActionsToolbar={<PostBulkActionsToolbar />}>
+            ...
+        </Datagrid>
+    </List>
+);
+```
+
+{% endraw %}
+
+**Tip**: This customization will bring up your new `UnselectAll` button on the left-hand side of the toolbar. To work on the right-hand side, you can use the [`bulkActionButtons`](#bulkactionbuttons) prop.
+
 ## `children`
 
 `<Datagrid>` accepts a list of Field components as children. It inspects each child's `source` and/or `label` props to determine the name of the column.
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
index 0cbf5c9f07e..49555eb026e 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
@@ -322,7 +322,7 @@ export interface DatagridProps<RecordType extends RaRecord = any>
     className?: string;
 
     /**
-     * The component used to render the bulk actions toolbar. Defaults to <BulkActionsToolbar>.
+     * The component used to render the bulk actions toolbar.
      *
      * @see https://marmelab.com/react-admin/Datagrid.html#bulkactionstoolbar (TODO: write doc)
      * @example

From 92893c4c9bfc836f7442f4915868e19c6be24295 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 15:05:23 +0100
Subject: [PATCH 100/146] update screenshot

---
 docs/img/SelectAllButton.png | Bin 61084 -> 62572 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/docs/img/SelectAllButton.png b/docs/img/SelectAllButton.png
index b7a20eb841ec4f7be2ed2934f60636df0bd732ea..769ddd8dd222468c9c6d10a59cc31ca1768f985b 100644
GIT binary patch
literal 62572
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
XGm&dp?0)?U`jeJW5U&<B{QAEDl9{kc

literal 61084
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
Vbs*eNWKe*g><cC78cE~e{{dN}AwmEE


From b2ed59276830fc283e5f656aaa6e1585243a6cf0 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 15:49:17 +0100
Subject: [PATCH 101/146] fix typo

---
 docs/Datagrid.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/Datagrid.md b/docs/Datagrid.md
index ab215d1faa5..7170728845a 100644
--- a/docs/Datagrid.md
+++ b/docs/Datagrid.md
@@ -398,7 +398,7 @@ You can customize this button or add others by passing a custom element as the `
 {% raw %}
 
 ```tsx
-import { List, Datagrid, BulkActionsToolbar, SelectAllButton, BulkDeleteButtonn useUnselectAll, Button } from 'react-admin';
+import { List, Datagrid, BulkActionsToolbar, SelectAllButton, BulkDeleteButton, useUnselectAll, Button } from 'react-admin';
 
 const UnselectButton = () => {
     const unselect = useUnselectAll('posts');

From aae3600c2ac281408ebab3746e8c2fab361fd691 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 15:49:45 +0100
Subject: [PATCH 102/146] useSelectAll -> test + stories

---
 .../src/controller/list/useSelectAll.spec.tsx | 43 +++++++++
 .../controller/list/useSelectAll.stories.tsx  | 89 +++++++++++++++++++
 .../src/controller/list/useSelectAll.tsx      | 23 +++--
 3 files changed, 147 insertions(+), 8 deletions(-)
 create mode 100644 packages/ra-core/src/controller/list/useSelectAll.spec.tsx
 create mode 100644 packages/ra-core/src/controller/list/useSelectAll.stories.tsx

diff --git a/packages/ra-core/src/controller/list/useSelectAll.spec.tsx b/packages/ra-core/src/controller/list/useSelectAll.spec.tsx
new file mode 100644
index 00000000000..f533ef9456d
--- /dev/null
+++ b/packages/ra-core/src/controller/list/useSelectAll.spec.tsx
@@ -0,0 +1,43 @@
+import React from 'react';
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+
+import {
+    Basic,
+    defaultDataProvider,
+    Limit,
+    QueryOptions,
+} from './useSelectAll.stories';
+
+describe('useSelectAll', () => {
+    it('should select all', async () => {
+        render(<Basic options={{}} dataProvider={defaultDataProvider} />);
+        await screen.findByText('Selected ids: []');
+        fireEvent.click(screen.getByText('Select All'));
+        await waitFor(() => {
+            expect(screen.queryByText('Selected ids: []')).not.toBeNull();
+        });
+    });
+
+    it('should select all with limit', async () => {
+        render(<Limit dataProvider={defaultDataProvider} />);
+        await screen.findByText('Selected ids: []');
+        fireEvent.click(screen.getByText('Select All'));
+        await waitFor(() => {
+            expect(screen.queryByText('Selected ids: [1,2,3]')).not.toBeNull();
+        });
+    });
+
+    it('should pass query options', async () => {
+        const getList = jest.spyOn(defaultDataProvider, 'getList');
+        render(<QueryOptions dataProvider={defaultDataProvider} />);
+        await screen.findByText('Selected ids: []');
+        fireEvent.click(screen.getByText('Select All'));
+        await waitFor(() => {
+            expect(getList).toHaveBeenCalledWith('posts', {
+                meta: { foo: 'bar' },
+                pagination: { page: 1, perPage: 250 },
+                sort: { field: 'id', order: 'ASC' },
+            });
+        });
+    });
+});
diff --git a/packages/ra-core/src/controller/list/useSelectAll.stories.tsx b/packages/ra-core/src/controller/list/useSelectAll.stories.tsx
new file mode 100644
index 00000000000..ce22729379a
--- /dev/null
+++ b/packages/ra-core/src/controller/list/useSelectAll.stories.tsx
@@ -0,0 +1,89 @@
+import * as React from 'react';
+import fakeDataProvider from 'ra-data-fakerest';
+
+import { CoreAdminContext } from '../../core';
+import { ListController } from './ListController';
+import { useSelectAll } from './useSelectAll';
+
+export default {
+    title: 'ra-core/controller/useSelectAll',
+    excludeStories: ['defaultDataProvider'],
+};
+
+export const defaultDataProvider = fakeDataProvider(
+    {
+        posts: [
+            { id: 1, title: 'Morbi suscipit malesuada' },
+            { id: 2, title: 'Quisque sodales ipsum' },
+            { id: 3, title: 'Maecenas at tortor' },
+            { id: 4, title: 'Integer commodo est' },
+            { id: 5, title: 'In eget accumsan' },
+            { id: 6, title: 'Curabitur fringilla tellus' },
+            { id: 7, title: 'Nunc ut purus' },
+        ],
+    },
+    process.env.NODE_ENV === 'development'
+);
+
+const List = ({ options, ...params }) => (
+    <div>
+        <SelectAllButton options={options} />
+        <p>Selected ids: {JSON.stringify(params.selectedIds)}</p>
+        <ul
+            style={{
+                listStyleType: 'none',
+            }}
+        >
+            {params.data?.map(record => (
+                <li key={record.id}>
+                    <input
+                        type="checkbox"
+                        checked={params.selectedIds.includes(record.id)}
+                        onChange={() => params.onToggleItem(record.id)}
+                        style={{
+                            cursor: 'pointer',
+                            marginRight: '10px',
+                        }}
+                    />
+                    {record.id} - {record.title}
+                </li>
+            ))}
+        </ul>
+    </div>
+);
+
+const SelectAllButton = ({ options }) => {
+    const selectAll = useSelectAll({
+        resource: 'posts',
+        sort: { field: 'id', order: 'ASC' },
+    });
+    return (
+        <button
+            onClick={() => selectAll(options)}
+            style={{ cursor: 'pointer' }}
+        >
+            Select All
+        </button>
+    );
+};
+
+export const Basic = ({ dataProvider = defaultDataProvider, options }) => (
+    <CoreAdminContext dataProvider={dataProvider}>
+        <ListController resource="posts">
+            {controllerProps => <List {...controllerProps} options={options} />}
+        </ListController>
+    </CoreAdminContext>
+);
+
+export const Limit = ({ dataProvider = defaultDataProvider }) => (
+    <Basic dataProvider={dataProvider} options={{ limit: 3 }} />
+);
+
+export const QueryOptions = ({ dataProvider = defaultDataProvider }) => (
+    <Basic
+        dataProvider={dataProvider}
+        options={{
+            queryOptions: { meta: { foo: 'bar' } },
+        }}
+    />
+);
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index f2dc9ff168a..6c268b90c85 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -14,7 +14,8 @@ import type { FilterPayload, RaRecord, SortPayload } from '../../types';
  * @param {FilterPayload} filter Optional. The filter object passed to the dataProvider
  * @returns {Function} handleSelectAll A function to select all items of a list
  *
- * @example // TODO: Update this example after updating the button position in the toolbar
+ * @example
+ * import { List, Datagrid, BulkActionsToolbar, BulkDeleteButton, useListContext, useSelectAll } from 'react-admin';
  *
  * const MySelectAllButton = () => {
  *   const { sort, filter } = useListContext();
@@ -23,15 +24,21 @@ import type { FilterPayload, RaRecord, SortPayload } from '../../types';
  *       queryOptions: { meta: { foo: 'bar' } },
  *       limit: 250,
  *   });
- *   return <Button onClick={handleClick}>Select All</Button>;
+ *   return <button onClick={handleClick}>Select All</button>;
  * };
  *
- * const PostList = () => (
- *   <List>
- *     <Datagrid bulkActionButtons={<MySelectAllButton />}>
- *       // ...
- *     </Datagrid>
- *   </List>
+ * const PostBulkActionsToolbar = () => (
+ *     <BulkActionsToolbar actions={<MySelectAllButton/>}>
+ *         <BulkDeleteButton />
+ *     </BulkActionsToolbar>
+ * );
+ *
+ * export const PostList = () => (
+ *     <List>
+ *         <Datagrid bulkActionsToolbar={<PostBulkActionsToolbar />}>
+ *             ...
+ *         </Datagrid>
+ *     </List>
  * );
  */
 export const useSelectAll = ({

From 7cf12a89d9ca427f94e7b02297358e0925f44496 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 13 Dec 2024 15:50:59 +0100
Subject: [PATCH 103/146] improve jsDoc

---
 .../src/list/datagrid/Datagrid.tsx            | 28 +++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
index 49555eb026e..16a77d4dee9 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
@@ -324,9 +324,33 @@ export interface DatagridProps<RecordType extends RaRecord = any>
     /**
      * The component used to render the bulk actions toolbar.
      *
-     * @see https://marmelab.com/react-admin/Datagrid.html#bulkactionstoolbar (TODO: write doc)
+     * @see https://marmelab.com/react-admin/Datagrid.html#bulkactionstoolbar
      * @example
-     * TODO: write example
+     * import { List, Datagrid, BulkActionsToolbar, SelectAllButton, BulkDeleteButton, useUnselectAll, Button } from 'react-admin';
+     *
+     * const UnselectButton = () => {
+     *     const unselect = useUnselectAll('posts');
+     *     return <Button onClick={unselect} label="Unselect all records" />;
+     * };
+     *
+     * const PostBulkActionsToolbar = () => (
+     *     <BulkActionsToolbar actions={
+     *         <>
+     *             <SelectAllButton label="Select all records" />
+     *             <UnselectButton />
+     *         </>
+     *     }>
+     *         <BulkDeleteButton />
+     *     </BulkActionsToolbar>
+     * );
+     *
+     * export const PostList = () => (
+     *     <List>
+     *         <Datagrid bulkActionsToolbar={<PostBulkActionsToolbar />}>
+     *             ...
+     *         </Datagrid>
+     *     </List>
+     * );
      */
     bulkActionsToolbar?: ReactElement | false;
 

From 3f3cbfed06f3230f0819a62dd23f81a512a02c74 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Tue, 17 Dec 2024 14:54:21 +0100
Subject: [PATCH 104/146] improve `SelectAllButton` introduction's doc

---
 docs/Buttons.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/Buttons.md b/docs/Buttons.md
index aad494543e7..2830445f308 100644
--- a/docs/Buttons.md
+++ b/docs/Buttons.md
@@ -958,8 +958,7 @@ To override the style of all instances of `<FilterButton>` using the [applicatio
 
 ## `<SelectAllButton>`
 
-This button is an internal component used by react-admin in [the Datagrid default `bulkActionsToolbar`](./Datagrid.md#bulkactionstoolbar).
-The `<SelectAllButton>` component is a button that is used to select all items from a resource, no matter the pagination.
+The `<SelectAllButton>` component allows users to select all items from a resource, no matter the pagination.
 
 ![SelectAllButton](./img/SelectAllButton.png)
 

From 361153e7da188b3410f636b026d79309bb97b82f Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Tue, 17 Dec 2024 14:58:44 +0100
Subject: [PATCH 105/146] update the selection button name

---
 .../src/controller/list/useInfiniteListController.spec.tsx  | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index 44053b24624..2608f8f2f32 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -65,7 +65,9 @@ describe('useInfiniteListController', () => {
                 <button onClick={() => params.onSelectAll({ limit: 1 })}>
                     Limited Select All
                 </button>
-                <button onClick={() => params.onSelect([0])}>Select 0</button>
+                <button onClick={() => params.onSelect([0])}>
+                    Select item 0
+                </button>
                 <span>children</span>
             </div>
         );
@@ -84,7 +86,7 @@ describe('useInfiniteListController', () => {
         it('should select all records even though some records are already selected', async () => {
             const callback = jest.fn(Children);
             render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
-            fireEvent.click(await screen.findByText('Select 0'));
+            fireEvent.click(await screen.findByText('Select item 0'));
             await waitFor(() => {
                 expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({

From 68adcf9dc0fed0d000a3ec5f434e48f935f3beb1 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Tue, 17 Dec 2024 15:07:16 +0100
Subject: [PATCH 106/146] rename stories

---
 .../controller/field/ReferenceArrayField.stories.tsx |  4 +---
 .../controller/field/ReferenceManyField.stories.tsx  |  2 +-
 .../field/useReferenceArrayFieldController.spec.tsx  |  6 +++---
 .../field/useReferenceManyFieldController.spec.tsx   | 12 ++++--------
 4 files changed, 9 insertions(+), 15 deletions(-)

diff --git a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
index 14a6894a4a3..948dc1b1d6f 100644
--- a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
+++ b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
@@ -75,9 +75,7 @@ const ReferenceArrayFieldComponent = (props: ListControllerResult) => (
     </div>
 );
 
-export const ReferenceArrayField = ({
-    children = ReferenceArrayFieldComponent,
-}) => (
+export const Basic = ({ children = ReferenceArrayFieldComponent }) => (
     <CoreAdminContext dataProvider={dataProvider}>
         <ReferenceArrayFieldController
             resource="foo"
diff --git a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
index f677edc1e4a..c3b11ad06b1 100644
--- a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
@@ -77,7 +77,7 @@ const ReferenceManyFieldComponent = (props: ListControllerResult) => (
     </div>
 );
 
-export const ReferenceManyField = ({
+export const Basic = ({
     children = ReferenceManyFieldComponent,
     dataProvider = defaultDataProvider,
 }: {
diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index e5ae3e082a7..797cbdcad3c 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -5,7 +5,7 @@ import { render, waitFor, screen, fireEvent } from '@testing-library/react';
 import { useReferenceArrayFieldController } from './useReferenceArrayFieldController';
 import { testDataProvider } from '../../dataProvider';
 import { CoreAdminContext } from '../../core';
-import { ReferenceArrayField } from './ReferenceArrayField.stories';
+import { Basic } from './ReferenceArrayField.stories';
 
 const ReferenceArrayFieldController = props => {
     const { children, ...rest } = props;
@@ -178,7 +178,7 @@ describe('<useReferenceArrayFieldController />', () => {
 
         it('should select all records', async () => {
             const callback = jest.fn(Children);
-            render(<ReferenceArrayField>{callback}</ReferenceArrayField>);
+            render(<Basic>{callback}</Basic>);
             await waitFor(() => {
                 expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
@@ -201,7 +201,7 @@ describe('<useReferenceArrayFieldController />', () => {
 
         it('should select all records even though some records are already selected', async () => {
             const callback = jest.fn(Children);
-            render(<ReferenceArrayField>{callback}</ReferenceArrayField>);
+            render(<Basic>{callback}</Basic>);
             await waitFor(() => {
                 expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index 9802487484e..ceafefae682 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -6,7 +6,7 @@ import { testDataProvider } from '../../dataProvider/testDataProvider';
 import { CoreAdminContext } from '../../core';
 import { useReferenceManyFieldController } from './useReferenceManyFieldController';
 import { memoryStore } from '../../store';
-import { ReferenceManyField } from './ReferenceManyField.stories';
+import { Basic } from './ReferenceManyField.stories';
 
 const ReferenceManyFieldController = props => {
     const { children, page = 1, perPage = 25, ...rest } = props;
@@ -428,7 +428,7 @@ describe('useReferenceManyFieldController', () => {
 
         it('should select all records', async () => {
             const callback = jest.fn(Children);
-            render(<ReferenceManyField>{callback}</ReferenceManyField>);
+            render(<Basic>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
                 expect(callback).toHaveBeenCalledWith(
@@ -441,7 +441,7 @@ describe('useReferenceManyFieldController', () => {
 
         it('should select all records even though some records are already selected', async () => {
             const callback = jest.fn(Children);
-            render(<ReferenceManyField>{callback}</ReferenceManyField>);
+            render(<Basic>{callback}</Basic>);
             fireEvent.click(await screen.findByText('Select 1'));
             await waitFor(() => {
                 expect(callback).toHaveBeenCalledWith(
@@ -476,11 +476,7 @@ describe('useReferenceManyFieldController', () => {
                 getManyReference,
             });
             const callback = jest.fn(Children);
-            render(
-                <ReferenceManyField dataProvider={dataProvider}>
-                    {callback}
-                </ReferenceManyField>
-            );
+            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
             await waitFor(() => {
                 expect(callback).toHaveBeenNthCalledWith(
                     1,

From 0231d03c6193bd4adfd1be8aebb196b772391788 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Tue, 17 Dec 2024 15:49:46 +0100
Subject: [PATCH 107/146] fix ts errors + use story in tests

---
 .../src/list/datagrid/Datagrid.spec.tsx       | 50 +++++-----------
 .../src/list/datagrid/Datagrid.stories.tsx    | 60 ++++++++++++-------
 2 files changed, 53 insertions(+), 57 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
index 02f3ef80be9..555f17ed3bf 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
@@ -10,9 +10,7 @@ import {
 import { ThemeProvider, createTheme } from '@mui/material';
 
 import { Datagrid } from './Datagrid';
-import { SelectAllButton } from '../../button';
-import { AccessControl } from './Datagrid.stories';
-import { BulkActionsToolbar } from '../BulkActionsToolbar';
+import { AccessControl, BulkActionToolbar } from './Datagrid.stories';
 
 const TitleField = (): JSX.Element => {
     const record = useRecordContext();
@@ -117,33 +115,13 @@ describe('<Datagrid />', () => {
     });
 
     it('should accept a custom bulkActionsToolbar', () => {
-        render(
-            <Wrapper listContext={contextValue}>
-                <Datagrid
-                    bulkActionsToolbar={
-                        <BulkActionsToolbar
-                            actions={
-                                <SelectAllButton label="Select All Records" />
-                            }
-                        />
-                    }
-                >
-                    <TitleField />
-                </Datagrid>
-            </Wrapper>
-        );
+        render(<BulkActionToolbar onlyDisplay="custom" />);
         expect(screen.queryByText('Delete')).toBeNull();
-        expect(screen.queryByText('Select All Records')).not.toBeNull();
+        expect(screen.queryByText('Select all records')).not.toBeNull();
     });
 
-    it('should not display the bulk actions toolbar when when `bulkActionsToolbar` prop is true', () => {
-        render(
-            <Wrapper listContext={contextValue}>
-                <Datagrid bulkActionsToolbar={false}>
-                    <TitleField />
-                </Datagrid>
-            </Wrapper>
-        );
+    it('should not display the bulk actions toolbar when when `bulkActionsToolbar` prop is false', () => {
+        render(<BulkActionToolbar onlyDisplay="disabled" />);
         expect(screen.queryByText('Delete')).toBeNull();
         expect(screen.queryByText('Select All')).toBeNull();
     });
@@ -160,7 +138,7 @@ describe('<Datagrid />', () => {
             const { rerender } = render(<Test />);
             const checkboxes = screen.queryAllByRole('checkbox');
             fireEvent.click(checkboxes[1]);
-            rerender(<Test selectedIds={[1]} />);
+            rerender(<Test selectedIds={[1] as never[]} />);
             fireEvent.click(checkboxes[3], {
                 shiftKey: true,
                 checked: true,
@@ -180,7 +158,7 @@ describe('<Datagrid />', () => {
             const { rerender } = render(<Test />);
             const checkboxes = screen.queryAllByRole('checkbox');
             fireEvent.click(checkboxes[3], { checked: true });
-            rerender(<Test selectedIds={[3]} />);
+            rerender(<Test selectedIds={[3] as never[]} />);
             fireEvent.click(checkboxes[1], {
                 shiftKey: true,
                 checked: true,
@@ -197,10 +175,12 @@ describe('<Datagrid />', () => {
                     </Datagrid>
                 </Wrapper>
             );
-            const { rerender } = render(<Test selectedIds={[1, 2, 4]} />);
+            const { rerender } = render(
+                <Test selectedIds={[1, 2, 4] as never[]} />
+            );
             const checkboxes = screen.queryAllByRole('checkbox');
             fireEvent.click(checkboxes[3], { checked: true });
-            rerender(<Test selectedIds={[1, 2, 4, 3]} />);
+            rerender(<Test selectedIds={[1, 2, 4, 3] as never[]} />);
             fireEvent.click(checkboxes[4], { shiftKey: true });
             expect(contextValue.onToggleItem).toHaveBeenCalledTimes(1);
             expect(contextValue.onSelect).toHaveBeenCalledWith([1, 2]);
@@ -243,7 +223,7 @@ describe('<Datagrid />', () => {
             const { rerender } = render(<Test />);
             const checkboxes = screen.queryAllByRole('checkbox');
             fireEvent.click(checkboxes[1], { checked: true });
-            rerender(<Test selectedIds={[1]} />);
+            rerender(<Test selectedIds={[1] as never[]} />);
 
             // Simulate unselecting all items
             rerender(<Test />);
@@ -291,15 +271,15 @@ describe('<Datagrid />', () => {
             fireEvent.click(checkboxes[1], { checked: true });
             expect(contextValue.onToggleItem).toHaveBeenCalledWith(1);
 
-            rerender(<Test selectedIds={[1]} />);
+            rerender(<Test selectedIds={[1] as never[]} />);
             fireEvent.click(checkboxes[2], { shiftKey: true, checked: true });
             expect(contextValue.onSelect).toHaveBeenCalledWith([1, 2]);
 
-            rerender(<Test selectedIds={[1, 2]} />);
+            rerender(<Test selectedIds={[1, 2] as never[]} />);
             fireEvent.click(checkboxes[2]);
             expect(contextValue.onToggleItem).toHaveBeenCalledWith(2);
 
-            rerender(<Test selectedIds={[1]} />);
+            rerender(<Test selectedIds={[1] as never[]} />);
             fireEvent.click(checkboxes[4], { shiftKey: true, checked: true });
             expect(contextValue.onToggleItem).toHaveBeenCalledWith(4);
 
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
index 498dfd79f20..3c0f423e7bb 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
@@ -195,30 +195,46 @@ const CutomBulkActionToolbar = () => (
     </BulkActionsToolbar>
 );
 
-export const BulkActionToolbar = () => (
+export const BulkActionToolbar = ({
+    onlyDisplay,
+}: {
+    onlyDisplay?: 'default' | 'disabled' | 'custom';
+}) => (
     <Wrapper>
         <Box sx={{ mt: -7 }}>
-            <h1>Default</h1>
-            <Datagrid>
-                <TextField source="id" />
-                <TextField source="title" />
-                <TextField source="author" />
-                <TextField source="year" />
-            </Datagrid>
-            <h1>Disabled</h1>
-            <Datagrid bulkActionsToolbar={false}>
-                <TextField source="id" />
-                <TextField source="title" />
-                <TextField source="author" />
-                <TextField source="year" />
-            </Datagrid>
-            <h1>Custom</h1>
-            <Datagrid bulkActionsToolbar={<CutomBulkActionToolbar />}>
-                <TextField source="id" />
-                <TextField source="title" />
-                <TextField source="author" />
-                <TextField source="year" />
-            </Datagrid>
+            {onlyDisplay && onlyDisplay === 'default' && (
+                <>
+                    <h1>Default</h1>
+                    <Datagrid>
+                        <TextField source="id" />
+                        <TextField source="title" />
+                        <TextField source="author" />
+                        <TextField source="year" />
+                    </Datagrid>
+                </>
+            )}
+            {onlyDisplay && onlyDisplay === 'disabled' && (
+                <>
+                    <h1>Disabled</h1>
+                    <Datagrid bulkActionsToolbar={false}>
+                        <TextField source="id" />
+                        <TextField source="title" />
+                        <TextField source="author" />
+                        <TextField source="year" />
+                    </Datagrid>
+                </>
+            )}
+            {onlyDisplay && onlyDisplay === 'custom' && (
+                <>
+                    <h1>Custom</h1>
+                    <Datagrid bulkActionsToolbar={<CutomBulkActionToolbar />}>
+                        <TextField source="id" />
+                        <TextField source="title" />
+                        <TextField source="author" />
+                        <TextField source="year" />
+                    </Datagrid>
+                </>
+            )}
         </Box>
     </Wrapper>
 );

From c8d447b8380733b2e5d7757bc23e4b5a4852a00e Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Tue, 17 Dec 2024 17:14:07 +0100
Subject: [PATCH 108/146] isolate tests into stories

---
 .../src/controller/list/useList.spec.tsx      | 146 +++++-------------
 .../src/controller/list/useList.stories.tsx   | 139 +++++++++++++++++
 2 files changed, 176 insertions(+), 109 deletions(-)
 create mode 100644 packages/ra-core/src/controller/list/useList.stories.tsx

diff --git a/packages/ra-core/src/controller/list/useList.spec.tsx b/packages/ra-core/src/controller/list/useList.spec.tsx
index e4c792343fb..7516d98be75 100644
--- a/packages/ra-core/src/controller/list/useList.spec.tsx
+++ b/packages/ra-core/src/controller/list/useList.spec.tsx
@@ -1,34 +1,8 @@
 import * as React from 'react';
-import { ReactNode } from 'react';
 import expect from 'expect';
 import { fireEvent, render, waitFor, screen } from '@testing-library/react';
 
-import { useList, UseListOptions, UseListValue } from './useList';
-import { ListContextProvider } from './ListContextProvider';
-import { useListContext } from './useListContext';
-
-const UseList = ({
-    children,
-    callback,
-    ...props
-}: UseListOptions & {
-    children?: ReactNode;
-    callback: (value: UseListValue) => void;
-}) => {
-    const value = useList(props);
-    callback(value);
-    return (
-        <ListContextProvider value={value}>
-            <button onClick={() => value.onSelectAll()} name="Select All">
-                Select All
-            </button>
-            <button onClick={() => value.onSelect([1])} name="Select item 1">
-                Select item 1
-            </button>
-            {children}
-        </ListContextProvider>
-    );
-};
+import { Basic, SelectAll, Sort } from './useList.stories';
 
 describe('<useList />', () => {
     it('should apply sorting correctly', async () => {
@@ -38,28 +12,12 @@ describe('<useList />', () => {
             { id: 2, title: 'world' },
         ];
 
-        const SortButton = () => {
-            const listContext = useListContext();
-
-            return (
-                <button
-                    onClick={() =>
-                        listContext.setSort({ field: 'title', order: 'ASC' })
-                    }
-                >
-                    Sort by title ASC
-                </button>
-            );
-        };
-
         const { getByText } = render(
-            <UseList
+            <Sort
                 data={data}
                 sort={{ field: 'title', order: 'DESC' }}
                 callback={callback}
-            >
-                <SortButton />
-            </UseList>
+            />
         );
 
         await waitFor(() => {
@@ -98,25 +56,7 @@ describe('<useList />', () => {
 
     it('should apply pagination correctly', async () => {
         const callback = jest.fn();
-        const data = [
-            { id: 1, title: 'hello' },
-            { id: 2, title: 'world' },
-            { id: 3, title: 'baz' },
-            { id: 4, title: 'bar' },
-            { id: 5, title: 'foo' },
-            { id: 6, title: 'plop' },
-            { id: 7, title: 'bazinga' },
-        ];
-
-        render(
-            <UseList
-                data={data}
-                sort={{ field: 'id', order: 'ASC' }}
-                page={2}
-                perPage={5}
-                callback={callback}
-            />
-        );
+        render(<Basic page={2} perPage={5} callback={callback} />);
 
         await waitFor(() => {
             expect(callback).toHaveBeenCalledWith(
@@ -125,13 +65,19 @@ describe('<useList />', () => {
                     isFetching: false,
                     isLoading: false,
                     data: [
-                        { id: 6, title: 'plop' },
-                        { id: 7, title: 'bazinga' },
+                        { id: 6, title: 'And Then There Were None' },
+                        { id: 7, title: 'Dream of the Red Chamber' },
+                        { id: 8, title: 'The Hobbit' },
+                        { id: 9, title: 'She: A History of Adventure' },
+                        {
+                            id: 10,
+                            title: 'The Lion, the Witch and the Wardrobe',
+                        },
                     ],
                     page: 2,
                     perPage: 5,
                     error: null,
-                    total: 7,
+                    total: 10,
                 })
             );
         });
@@ -145,20 +91,15 @@ describe('<useList />', () => {
         ];
 
         const { rerender } = render(
-            <UseList
-                filter={{ title: 'world' }}
-                sort={{ field: 'id', order: 'ASC' }}
-                callback={callback}
-            />
+            <Basic filter={{ title: 'world' }} callback={callback} />
         );
 
         rerender(
-            <UseList
+            <Basic
                 data={data}
                 isFetching={true}
                 isLoading={false}
                 filter={{ title: 'world' }}
-                sort={{ field: 'id', order: 'ASC' }}
                 callback={callback}
             />
         );
@@ -178,18 +119,8 @@ describe('<useList />', () => {
     describe('filter', () => {
         it('should filter string data based on the filter props', () => {
             const callback = jest.fn();
-            const data = [
-                { id: 1, title: 'hello' },
-                { id: 2, title: 'world' },
-            ];
-
             render(
-                <UseList
-                    data={data}
-                    filter={{ title: 'world' }}
-                    sort={{ field: 'id', order: 'ASC' }}
-                    callback={callback}
-                />
+                <Basic filter={{ title: 'The Hobbit' }} callback={callback} />
             );
 
             expect(callback).toHaveBeenCalledWith(
@@ -197,7 +128,7 @@ describe('<useList />', () => {
                     sort: { field: 'id', order: 'ASC' },
                     isFetching: false,
                     isLoading: false,
-                    data: [{ id: 2, title: 'world' }],
+                    data: [{ id: 8, title: 'The Hobbit' }],
                     error: null,
                     total: 1,
                 })
@@ -214,10 +145,9 @@ describe('<useList />', () => {
             ];
 
             render(
-                <UseList
+                <Basic
                     data={data}
                     filter={{ items: ['two', 'four', 'five'] }}
-                    sort={{ field: 'id', order: 'ASC' }}
                     callback={callback}
                 />
             );
@@ -250,7 +180,7 @@ describe('<useList />', () => {
             ];
 
             render(
-                <UseList
+                <Basic
                     data={data}
                     sort={{ field: 'id', order: 'ASC' }}
                     filterCallback={record => record.id > 2}
@@ -283,12 +213,13 @@ describe('<useList />', () => {
             ];
 
             render(
-                <UseList
+                <Basic
                     data={data}
                     filter={{ title: { name: 'world' } }}
-                    sort={{ field: 'id', order: 'ASC' }}
                     callback={callback}
-                />
+                >
+                    children
+                </Basic>
             );
 
             expect(callback).toHaveBeenCalledWith(
@@ -305,21 +236,20 @@ describe('<useList />', () => {
 
         it('should apply the q filter as a full-text filter', () => {
             const callback = jest.fn();
-            const data = [
-                { id: 1, title: 'Abc', author: 'Def' }, // matches 'ab'
-                { id: 2, title: 'Ghi', author: 'Jkl' }, // does not match 'ab'
-                { id: 3, title: 'Mno', author: 'Abc' }, // matches 'ab'
-            ];
-
-            render(
-                <UseList data={data} filter={{ q: 'ab' }} callback={callback} />
-            );
+            render(<Basic filter={{ q: 'The' }} callback={callback} />);
 
             expect(callback).toHaveBeenCalledWith(
                 expect.objectContaining({
                     data: [
-                        { id: 1, title: 'Abc', author: 'Def' },
-                        { id: 3, title: 'Mno', author: 'Abc' },
+                        { id: 2, title: 'The Little Prince' },
+                        { id: 5, title: 'The Lord of the Rings' },
+                        { id: 6, title: 'And Then There Were None' },
+                        { id: 7, title: 'Dream of the Red Chamber' },
+                        { id: 8, title: 'The Hobbit' },
+                        {
+                            id: 10,
+                            title: 'The Lion, the Witch and the Wardrobe',
+                        },
                     ],
                 })
             );
@@ -329,23 +259,21 @@ describe('<useList />', () => {
     describe('onSelectAll', () => {
         it('should select all records', async () => {
             const callback = jest.fn();
-            const data = [{ id: 0 }, { id: 1 }];
-            render(<UseList data={data} callback={callback} />);
+            render(<SelectAll callback={callback} />);
             fireEvent.click(
                 await screen.findByRole('button', { name: 'Select All' })
             );
             await waitFor(() => {
                 expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        selectedIds: [0, 1],
+                        selectedIds: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
                     })
                 );
             });
         });
         it('should select all records even though some records are already selected', async () => {
             const callback = jest.fn();
-            const data = [{ id: 0 }, { id: 1 }];
-            render(<UseList data={data} callback={callback} />);
+            render(<SelectAll callback={callback} />);
             fireEvent.click(
                 await screen.findByRole('button', { name: 'Select item 1' })
             );
@@ -360,7 +288,7 @@ describe('<useList />', () => {
             await waitFor(() => {
                 expect(callback).toHaveBeenCalledWith(
                     expect.objectContaining({
-                        selectedIds: [0, 1],
+                        selectedIds: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
                     })
                 );
             });
diff --git a/packages/ra-core/src/controller/list/useList.stories.tsx b/packages/ra-core/src/controller/list/useList.stories.tsx
new file mode 100644
index 00000000000..f22c8308068
--- /dev/null
+++ b/packages/ra-core/src/controller/list/useList.stories.tsx
@@ -0,0 +1,139 @@
+import React from 'react';
+
+import { ListContextProvider, useList, useListContext } from '.';
+import type { UseListValue } from '.';
+
+export default {
+    title: 'ra-core/controller/list/useList',
+};
+
+const List = () => {
+    const listContext = useListContext();
+    return (
+        <div>
+            {listContext.isPending ? (
+                <p>Loading...</p>
+            ) : (
+                <div>
+                    <ul
+                        style={{
+                            listStyleType: 'none',
+                        }}
+                    >
+                        {listContext.data?.map(record => (
+                            <li key={record.id}>
+                                <input
+                                    type="checkbox"
+                                    checked={listContext.selectedIds.includes(
+                                        record.id
+                                    )}
+                                    onChange={() =>
+                                        listContext.onToggleItem(record.id)
+                                    }
+                                    style={{
+                                        cursor: 'pointer',
+                                        marginRight: '10px',
+                                    }}
+                                />
+                                {record.id} - {record.title}
+                            </li>
+                        ))}
+                    </ul>
+                </div>
+            )}
+        </div>
+    );
+};
+
+const data = [
+    { id: 1, title: 'War and Peace' },
+    { id: 2, title: 'The Little Prince' },
+    { id: 3, title: "Swann's Way" },
+    { id: 4, title: 'A Tale of Two Cities' },
+    { id: 5, title: 'The Lord of the Rings' },
+    { id: 6, title: 'And Then There Were None' },
+    { id: 7, title: 'Dream of the Red Chamber' },
+    { id: 8, title: 'The Hobbit' },
+    { id: 9, title: 'She: A History of Adventure' },
+    { id: 10, title: 'The Lion, the Witch and the Wardrobe' },
+];
+
+const Wrapper = ({
+    children = <List />,
+    callback,
+    ...props
+}: {
+    children: React.ReactNode;
+    callback?: (value: UseListValue) => void;
+}) => {
+    const value = useList({
+        data,
+        sort: { field: 'id', order: 'ASC' },
+        ...props,
+    });
+    callback && callback(value);
+    return <ListContextProvider value={value}>{children}</ListContextProvider>;
+};
+
+export const Basic = props => <Wrapper {...props} />;
+
+const SortButton = () => {
+    const listContext = useListContext();
+    return (
+        <div style={{ display: 'flex', gap: '10px', margin: '10px' }}>
+            <button
+                onClick={() =>
+                    listContext.sort.order === 'DESC'
+                        ? listContext.setSort({ field: 'title', order: 'ASC' })
+                        : listContext.setSort({ field: 'title', order: 'DESC' })
+                }
+            >
+                Sort by id {listContext.sort.order === 'DESC' ? 'ASC' : 'DESC'}
+            </button>
+            <button
+                onClick={() =>
+                    listContext.sort.order === 'DESC'
+                        ? listContext.setSort({ field: 'title', order: 'ASC' })
+                        : listContext.setSort({ field: 'title', order: 'DESC' })
+                }
+            >
+                Sort by title{' '}
+                {listContext.sort.order === 'DESC' ? 'ASC' : 'DESC'}
+            </button>
+        </div>
+    );
+};
+
+export const Sort = props => (
+    <Wrapper {...props}>
+        <SortButton />
+        <List />
+    </Wrapper>
+);
+
+const SelectAllButton = () => {
+    const value = useListContext();
+    return (
+        <div
+            style={{
+                display: 'flex',
+                gap: '10px',
+                margin: '10px',
+            }}
+        >
+            <button onClick={() => value.onSelectAll()} name="Select All">
+                Select All
+            </button>
+            <button onClick={() => value.onSelect([1])} name="Select item 1">
+                Select item 1
+            </button>
+        </div>
+    );
+};
+
+export const SelectAll = props => (
+    <Wrapper {...props}>
+        <SelectAllButton />
+        <List />
+    </Wrapper>
+);

From ea989da2a35e147f18d808fd398633e6c869d2b8 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Tue, 17 Dec 2024 17:25:58 +0100
Subject: [PATCH 109/146] simplify tests (afterEach of Select All tests)

---
 .../ra-ui-materialui/src/list/List.spec.tsx   | 52 ++++---------------
 1 file changed, 9 insertions(+), 43 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/List.spec.tsx b/packages/ra-ui-materialui/src/list/List.spec.tsx
index d7e947b8a4a..f8661d63551 100644
--- a/packages/ra-ui-materialui/src/list/List.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/List.spec.tsx
@@ -345,25 +345,11 @@ describe('<List />', () => {
     });
 
     describe('"Select all" button', () => {
-        const Child = () => {
-            const [_, selectionModifiers] = useRecordSelection({
-                resource: 'books',
-            });
-            return (
-                <button onClick={() => selectionModifiers.clearSelection()}>
-                    reset
-                </button>
-            );
-        };
         afterEach(() => {
-            fireEvent.click(screen.getByRole('button', { name: 'reset' }));
+            fireEvent.click(screen.getByRole('button', { name: 'Unselect' }));
         });
         it('should be displayed if an item is selected', async () => {
-            render(
-                <Default>
-                    <Child />
-                </Default>
-            );
+            render(<Default />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
@@ -395,9 +381,7 @@ describe('<List />', () => {
                                 total: 2,
                             }),
                     })}
-                >
-                    <Child />
-                </Default>
+                />
             );
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(3);
@@ -409,11 +393,7 @@ describe('<List />', () => {
             ).toBeNull();
         });
         it('should not be displayed if all item are selected with the "Select all" button', async () => {
-            render(
-                <Default>
-                    <Child />
-                </Default>
-            );
+            render(<Default />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
@@ -455,9 +435,7 @@ describe('<List />', () => {
                                 total: 3,
                             }),
                     })}
-                >
-                    <Child />
-                </SelectAllLimit>
+                />
             );
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(4);
@@ -470,11 +448,7 @@ describe('<List />', () => {
             ).toBeNull();
         });
         it('should not be displayed if we reached the selectAllLimit by a  click on the "Select all" button', async () => {
-            render(
-                <SelectAllLimit>
-                    <Child />
-                </SelectAllLimit>
-            );
+            render(<SelectAllLimit />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
@@ -490,11 +464,7 @@ describe('<List />', () => {
             ).toBeNull();
         });
         it('should select all items', async () => {
-            render(
-                <Default>
-                    <Child />
-                </Default>
-            );
+            render(<Default />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
@@ -503,12 +473,8 @@ describe('<List />', () => {
             fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
             await screen.findByText('13 items selected');
         });
-        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
-            render(
-                <SelectAllLimit>
-                    <Child />
-                </SelectAllLimit>
-            );
+        it.only('should select the maximum items possible until we reached the selectAllLimit', async () => {
+            render(<SelectAllLimit />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });

From 56f48a5f4a7cf07cae8bac244476bc6401f439b6 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 16:11:38 +0100
Subject: [PATCH 110/146] don't pass children to the tests ->
 `useReferenceArrayFieldController`

---
 .../field/ReferenceArrayField.stories.tsx     |  5 +-
 .../useReferenceArrayFieldController.spec.tsx | 49 ++++++-------------
 2 files changed, 20 insertions(+), 34 deletions(-)

diff --git a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
index 948dc1b1d6f..cf47a40823e 100644
--- a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
+++ b/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
@@ -50,7 +50,9 @@ const ReferenceArrayFieldComponent = (props: ListControllerResult) => (
             >
                 Unselect All
             </button>
-            <p>Selected ids: {JSON.stringify(props.selectedIds)}</p>
+            <p data-testid="selected_ids">
+                Selected ids: {JSON.stringify(props.selectedIds)}
+            </p>
         </div>
         <ul
             style={{
@@ -67,6 +69,7 @@ const ReferenceArrayFieldComponent = (props: ListControllerResult) => (
                             cursor: 'pointer',
                             marginRight: '10px',
                         }}
+                        data-testid={`checkbox-${record.id}`}
                     />
                     {record.id} - {record.title}
                 </li>
diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 797cbdcad3c..3e762c2a4c3 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -169,55 +169,38 @@ describe('<useReferenceArrayFieldController />', () => {
     });
 
     describe('onSelectAll', () => {
-        const Children = params => (
-            <div>
-                <button onClick={() => params.onSelectAll()}>Select All</button>
-                <span>children</span>
-            </div>
-        );
-
         it('should select all records', async () => {
-            const callback = jest.fn(Children);
-            render(<Basic>{callback}</Basic>);
+            render(<Basic />);
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
                 );
             });
             fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [1, 2],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1,2]'
                 );
             });
         });
 
         it('should select all records even though some records are already selected', async () => {
-            const callback = jest.fn(Children);
-            render(<Basic>{callback}</Basic>);
+            render(<Basic />);
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
+                );
+            });
+            fireEvent.click(await screen.findByTestId('checkbox-1'));
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        data: [
-                            { id: 1, title: 'bar1' },
-                            { id: 2, title: 'bar2' },
-                        ],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1]'
                 );
             });
             fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [1, 2],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1,2]'
                 );
             });
         });

From cb702473caf691f08fa7384730782a1fa10f1e11 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 16:22:01 +0100
Subject: [PATCH 111/146] don't pass children to the tests ->
 `useReferenceManyFieldController`

---
 .../field/ReferenceManyField.stories.tsx      | 14 ++-
 .../useReferenceManyFieldController.spec.tsx  | 86 +++++++------------
 2 files changed, 43 insertions(+), 57 deletions(-)

diff --git a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
index c3b11ad06b1..ae31dd29fed 100644
--- a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
@@ -8,7 +8,7 @@ import {
     useReferenceManyFieldController,
 } from '../..';
 
-const defaultDataProvider = testDataProvider({
+export const defaultDataProvider = testDataProvider({
     getManyReference: (_resource, params): Promise<GetManyResult> =>
         Promise.resolve({
             data: [
@@ -46,13 +46,21 @@ const ReferenceManyFieldComponent = (props: ListControllerResult) => (
             >
                 Select All
             </button>
+            <button
+                onClick={() => props.onSelectAll({ limit: 1 })}
+                disabled={props.selectedIds.length >= 1}
+            >
+                Limited Select All
+            </button>
             <button
                 onClick={props.onUnselectItems}
                 disabled={props.selectedIds.length === 0}
             >
                 Unselect All
             </button>
-            <p>Selected ids: {JSON.stringify(props.selectedIds)}</p>
+            <p data-testid="selected_ids">
+                Selected ids: {JSON.stringify(props.selectedIds)}
+            </p>
         </div>
         <ul
             style={{
@@ -69,6 +77,7 @@ const ReferenceManyFieldComponent = (props: ListControllerResult) => (
                             cursor: 'pointer',
                             marginRight: '10px',
                         }}
+                        data-testid={`checkbox-${record.id}`}
                     />
                     {record.id} - {record.title}
                 </li>
@@ -99,4 +108,5 @@ export const Basic = ({
 
 export default {
     title: 'ra-core/fields/ReferenceManyField',
+    excludeStories: ['defaultDataProvider'],
 };
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index ceafefae682..abaeeb9ddce 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -6,7 +6,7 @@ import { testDataProvider } from '../../dataProvider/testDataProvider';
 import { CoreAdminContext } from '../../core';
 import { useReferenceManyFieldController } from './useReferenceManyFieldController';
 import { memoryStore } from '../../store';
-import { Basic } from './ReferenceManyField.stories';
+import { Basic, defaultDataProvider } from './ReferenceManyField.stories';
 
 const ReferenceManyFieldController = props => {
     const { children, page = 1, perPage = 25, ...rest } = props;
@@ -415,82 +415,58 @@ describe('useReferenceManyFieldController', () => {
     });
 
     describe('onSelectAll', () => {
-        const Children = params => (
-            <div>
-                <button onClick={() => params.onSelectAll()}>Select All</button>
-                <button onClick={() => params.onSelectAll({ limit: 1 })}>
-                    Limited Select All
-                </button>
-                <button onClick={() => params.onSelect([1])}>Select 1</button>
-                <span>children</span>
-            </div>
-        );
-
         it('should select all records', async () => {
-            const callback = jest.fn(Children);
-            render(<Basic>{callback}</Basic>);
+            render(<Basic />);
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
+                );
+            });
             fireEvent.click(await screen.findByText('Select All'));
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [0,1]'
                 );
             });
         });
 
         it('should select all records even though some records are already selected', async () => {
-            const callback = jest.fn(Children);
-            render(<Basic>{callback}</Basic>);
-            fireEvent.click(await screen.findByText('Select 1'));
+            render(<Basic />);
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [1],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
                 );
             });
-            fireEvent.click(screen.getByText('Select All'));
+            fireEvent.click(await screen.findByTestId('checkbox-1'));
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1]'
+                );
+            });
+            fireEvent.click(await screen.findByText('Select All'));
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [0,1]'
                 );
             });
         });
 
         it('should not select more records than the provided limit', async () => {
-            const getManyReference = jest
-                .fn()
-                .mockImplementation((_resource, params) =>
-                    Promise.resolve({
-                        data: [{ id: 0 }, { id: 1 }].slice(
-                            0,
-                            params.pagination.perPage
-                        ),
-                        total: 2,
-                    })
-                );
-            const dataProvider = testDataProvider({
-                getManyReference,
-            });
-            const callback = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
+            const dataProvider = defaultDataProvider;
+            const getManyReference = jest.spyOn(
+                dataProvider,
+                'getManyReference'
+            );
+            render(<Basic dataProvider={dataProvider} />);
             await waitFor(() => {
-                expect(callback).toHaveBeenNthCalledWith(
-                    1,
-                    expect.objectContaining({
-                        selectedIds: [],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
                 );
             });
             fireEvent.click(await screen.findByText('Limited Select All'));
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [0]'
                 );
             });
             await waitFor(() => {

From db74e832929beba8f9acf6b0ae49a40addf88c46 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 16:33:10 +0100
Subject: [PATCH 112/146] don't pass children to the tests ->
 `useInfiniteListController`

---
 .../list/useInfiniteListController.spec.tsx   | 82 ++++++++-----------
 .../useInfiniteListController.stories.tsx     | 20 ++++-
 2 files changed, 50 insertions(+), 52 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
index 2608f8f2f32..ecf82df3e54 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.spec.tsx
@@ -26,6 +26,7 @@ import {
     Authenticated,
     CanAccess,
     DisableAuthentication,
+    defaultDataProvider,
 } from './useInfiniteListController.stories';
 import type { AuthProvider } from '../../types';
 
@@ -46,80 +47,61 @@ describe('useInfiniteListController', () => {
         debounce: 200,
     };
 
-    const dataProvider = testDataProvider({
-        getList: jest.fn().mockImplementation((_resource, params) =>
-            Promise.resolve({
-                data: [{ id: 0 }, { id: 1 }].slice(
-                    0,
-                    params.pagination.perPage
-                ),
-                total: 2,
-            })
-        ),
-    });
-
     describe('onSelectAll', () => {
-        const Children = params => (
-            <div>
-                <button onClick={() => params.onSelectAll()}>Select All</button>
-                <button onClick={() => params.onSelectAll({ limit: 1 })}>
-                    Limited Select All
-                </button>
-                <button onClick={() => params.onSelect([0])}>
-                    Select item 0
-                </button>
-                <span>children</span>
-            </div>
-        );
         it('should select all records', async () => {
-            const callback = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
-            fireEvent.click(await screen.findByText('Select All'));
+            render(<Basic />);
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
+                );
+            });
+            fireEvent.click(screen.getByText('Select All'));
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1,2,3,4,5,6,7]'
                 );
             });
         });
         it('should select all records even though some records are already selected', async () => {
-            const callback = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
-            fireEvent.click(await screen.findByText('Select item 0'));
+            render(<Basic />);
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
+                );
+            });
+            fireEvent.click(screen.getByText('Select item 1'));
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1]'
                 );
             });
             fireEvent.click(screen.getByText('Select All'));
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1,2,3,4,5,6,7]'
                 );
             });
         });
         it('should not select more records than the provided limit', async () => {
+            const dataProvider = defaultDataProvider;
             const getList = jest.spyOn(dataProvider, 'getList');
-            const callback = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
-            fireEvent.click(await screen.findByText('Limited Select All'));
+            render(<Basic dataProvider={dataProvider} />);
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
+                );
+            });
+            fireEvent.click(screen.getByText('Limited Select All'));
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1,2,3]'
                 );
             });
             await waitFor(() => {
                 expect(getList).toHaveBeenCalledWith(
                     'posts',
                     expect.objectContaining({
-                        pagination: { page: 1, perPage: 1 },
+                        pagination: { page: 1, perPage: 3 },
                     })
                 );
             });
diff --git a/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
index 0ab182710b8..f31d1b841cd 100644
--- a/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useInfiniteListController.stories.tsx
@@ -10,6 +10,7 @@ import { TestMemoryRouter } from '../../routing';
 
 export default {
     title: 'ra-core/controller/list/useInfiniteListController',
+    excludeStories: ['defaultDataProvider'],
 };
 
 const styles = {
@@ -23,7 +24,7 @@ const styles = {
     },
 };
 
-const defaultDataProvider = fakeDataProvider(
+export const defaultDataProvider = fakeDataProvider(
     {
         posts: [
             { id: 1, title: 'Post #1', votes: 90 },
@@ -85,13 +86,27 @@ const ListWithCheckboxes = params => (
                     >
                         Select All
                     </button>
+                    <button
+                        onClick={() => params.onSelect([1])}
+                        disabled={params.selectedIds.includes(1)}
+                    >
+                        Select item 1
+                    </button>
+                    <button
+                        onClick={() => params.onSelectAll({ limit: 3 })}
+                        disabled={params.selectedIds.length >= 3}
+                    >
+                        Limited Select All
+                    </button>
                     <button
                         onClick={params.onUnselectItems}
                         disabled={params.selectedIds.length === 0}
                     >
                         Unselect All
                     </button>
-                    <p>Selected ids: {JSON.stringify(params.selectedIds)}</p>
+                    <p data-testid="selected_ids">
+                        Selected ids: {JSON.stringify(params.selectedIds)}
+                    </p>
                 </div>
                 <ul
                     style={{
@@ -109,6 +124,7 @@ const ListWithCheckboxes = params => (
                                     cursor: 'pointer',
                                     marginRight: '10px',
                                 }}
+                                data-testid={`checkbox-${record.id}`}
                             />
                             {record.id} - {record.title}
                         </li>

From 8787f5bdcc0be282b716ab12425c190d6217dab3 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 16:41:20 +0100
Subject: [PATCH 113/146] don't pass children to the tests -> `useList`

---
 .../src/controller/list/useList.spec.tsx      | 40 +++++++++----------
 .../src/controller/list/useList.stories.tsx   |  6 +++
 2 files changed, 26 insertions(+), 20 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useList.spec.tsx b/packages/ra-core/src/controller/list/useList.spec.tsx
index 7516d98be75..aa66585de51 100644
--- a/packages/ra-core/src/controller/list/useList.spec.tsx
+++ b/packages/ra-core/src/controller/list/useList.spec.tsx
@@ -258,38 +258,38 @@ describe('<useList />', () => {
 
     describe('onSelectAll', () => {
         it('should select all records', async () => {
-            const callback = jest.fn();
-            render(<SelectAll callback={callback} />);
-            fireEvent.click(
-                await screen.findByRole('button', { name: 'Select All' })
-            );
+            render(<SelectAll />);
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
+                );
+            });
+            fireEvent.click(screen.getByRole('button', { name: 'Select All' }));
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1,2,3,4,5,6,7,8,9,10]'
                 );
             });
         });
         it('should select all records even though some records are already selected', async () => {
-            const callback = jest.fn();
-            render(<SelectAll callback={callback} />);
+            render(<SelectAll />);
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
+                );
+            });
             fireEvent.click(
-                await screen.findByRole('button', { name: 'Select item 1' })
+                screen.getByRole('button', { name: 'Select item 1' })
             );
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [1],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1]'
                 );
             });
             fireEvent.click(screen.getByRole('button', { name: 'Select All' }));
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1,2,3,4,5,6,7,8,9,10]'
                 );
             });
         });
diff --git a/packages/ra-core/src/controller/list/useList.stories.tsx b/packages/ra-core/src/controller/list/useList.stories.tsx
index f22c8308068..f01bb406ebc 100644
--- a/packages/ra-core/src/controller/list/useList.stories.tsx
+++ b/packages/ra-core/src/controller/list/useList.stories.tsx
@@ -15,6 +15,12 @@ const List = () => {
                 <p>Loading...</p>
             ) : (
                 <div>
+                    <div>
+                        <p data-testid="selected_ids">
+                            Selected ids:{' '}
+                            {JSON.stringify(listContext.selectedIds)}
+                        </p>
+                    </div>
                     <ul
                         style={{
                             listStyleType: 'none',

From 122dae6fe10e0787ff450c2d2278064f04714490 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 16:42:29 +0100
Subject: [PATCH 114/146] simplify tests

---
 packages/ra-core/src/controller/list/useSelectAll.spec.tsx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useSelectAll.spec.tsx b/packages/ra-core/src/controller/list/useSelectAll.spec.tsx
index f533ef9456d..2ffbfe88af6 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.spec.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.spec.tsx
@@ -10,7 +10,7 @@ import {
 
 describe('useSelectAll', () => {
     it('should select all', async () => {
-        render(<Basic options={{}} dataProvider={defaultDataProvider} />);
+        render(<Basic options={{}} />);
         await screen.findByText('Selected ids: []');
         fireEvent.click(screen.getByText('Select All'));
         await waitFor(() => {
@@ -19,7 +19,7 @@ describe('useSelectAll', () => {
     });
 
     it('should select all with limit', async () => {
-        render(<Limit dataProvider={defaultDataProvider} />);
+        render(<Limit />);
         await screen.findByText('Selected ids: []');
         fireEvent.click(screen.getByText('Select All'));
         await waitFor(() => {

From 2abf95553651695127a7b8a5b1eb8ad562acc9a7 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 16:50:02 +0100
Subject: [PATCH 115/146] don't pass children to the tests ->
 `useListController`

---
 .../list/useListController.spec.tsx           | 79 ++++++++-----------
 .../list/useListController.stories.tsx        | 19 ++++-
 2 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useListController.spec.tsx b/packages/ra-core/src/controller/list/useListController.spec.tsx
index b145bf2e7a2..95eaad19e0e 100644
--- a/packages/ra-core/src/controller/list/useListController.spec.tsx
+++ b/packages/ra-core/src/controller/list/useListController.spec.tsx
@@ -22,7 +22,7 @@ import {
     CanAccess,
     DisableAuthentication,
 } from './useListController.security.stories';
-import { Basic } from './useListController.stories';
+import { Basic, defaultDataProvider } from './useListController.stories';
 
 describe('useListController', () => {
     const defaultProps = {
@@ -588,76 +588,61 @@ describe('useListController', () => {
     });
 
     describe('onSelectAll', () => {
-        const dataProvider = testDataProvider({
-            getList: jest.fn().mockImplementation((_resource, params) =>
-                Promise.resolve({
-                    data: [{ id: 0 }, { id: 1 }].slice(
-                        0,
-                        params.pagination.perPage
-                    ),
-                    total: 2,
-                })
-            ),
-        });
-        const Children = params => (
-            <div>
-                <button onClick={() => params.onSelectAll()}>Select All</button>
-                <button onClick={() => params.onSelectAll({ limit: 1 })}>
-                    Limited Select All
-                </button>
-                <button onClick={() => params.onSelect([0])}>Select 0</button>
-                <span>children</span>
-            </div>
-        );
         it('should select all records', async () => {
-            const callback = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
-            fireEvent.click(await screen.findByText('Select All'));
+            render(<Basic />);
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
+                );
+            });
+            fireEvent.click(screen.getByText('Select All'));
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1,2,3,4,5,6,7]'
                 );
             });
         });
         it('should select all records even though some records are already selected', async () => {
-            const callback = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
-            fireEvent.click(await screen.findByText('Select 0'));
+            render(<Basic />);
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
+                );
+            });
+            fireEvent.click(screen.getByText('Select item 1'));
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1]'
                 );
             });
             fireEvent.click(screen.getByText('Select All'));
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0, 1],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1,2,3,4,5,6,7]'
                 );
             });
         });
         it('should not select more records than the provided limit', async () => {
+            const dataProvider = defaultDataProvider;
             const getList = jest.spyOn(dataProvider, 'getList');
-            const callback = jest.fn(Children);
-            render(<Basic dataProvider={dataProvider}>{callback}</Basic>);
+            render(<Basic dataProvider={dataProvider} />);
             fireEvent.click(await screen.findByText('Limited Select All'));
             await waitFor(() => {
-                expect(callback).toHaveBeenCalledWith(
-                    expect.objectContaining({
-                        selectedIds: [0],
-                    })
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: []'
+                );
+            });
+            fireEvent.click(screen.getByText('Limited Select All'));
+            await waitFor(() => {
+                expect(screen.getByTestId('selected_ids').textContent).toBe(
+                    'Selected ids: [1,2,3]'
                 );
             });
             await waitFor(() => {
                 expect(getList).toHaveBeenCalledWith(
                     'posts',
                     expect.objectContaining({
-                        pagination: { page: 1, perPage: 1 },
+                        pagination: { page: 1, perPage: 3 },
                     })
                 );
             });
diff --git a/packages/ra-core/src/controller/list/useListController.stories.tsx b/packages/ra-core/src/controller/list/useListController.stories.tsx
index 46caff6244c..ea6cbb76e19 100644
--- a/packages/ra-core/src/controller/list/useListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useListController.stories.tsx
@@ -8,9 +8,10 @@ import type { ListControllerResult } from './useListController';
 
 export default {
     title: 'ra-core/controller/list/useListController',
+    excludeStories: ['defaultDataProvider'],
 };
 
-const defaultDataProvider = fakeDataProvider(
+export const defaultDataProvider = fakeDataProvider(
     {
         posts: [
             { id: 1, title: 'Morbi suscipit malesuada' },
@@ -40,13 +41,27 @@ const List = params => (
             >
                 Select All
             </button>
+            <button
+                onClick={() => params.onSelect([1])}
+                disabled={params.selectedIds.includes(1)}
+            >
+                Select item 1
+            </button>
+            <button
+                onClick={() => params.onSelectAll({ limit: 3 })}
+                disabled={params.selectedIds.length >= 3}
+            >
+                Limited Select All
+            </button>
             <button
                 onClick={params.onUnselectItems}
                 disabled={params.selectedIds.length === 0}
             >
                 Unselect All
             </button>
-            <p>Selected ids: {JSON.stringify(params.selectedIds)}</p>
+            <p data-testid="selected_ids">
+                Selected ids: {JSON.stringify(params.selectedIds)}
+            </p>
         </div>
         <ul
             style={{

From 54c8e6ed9be6cfa81bdfad8cf9e847c1b2c3b022 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 16:58:56 +0100
Subject: [PATCH 116/146] clean file

---
 packages/ra-ui-materialui/src/list/List.spec.tsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/list/List.spec.tsx b/packages/ra-ui-materialui/src/list/List.spec.tsx
index f8661d63551..71f85d4eb49 100644
--- a/packages/ra-ui-materialui/src/list/List.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/List.spec.tsx
@@ -6,7 +6,6 @@ import {
     testDataProvider,
     useListContext,
     TestMemoryRouter,
-    useRecordSelection,
 } from 'ra-core';
 import { createTheme, ThemeProvider } from '@mui/material/styles';
 

From ec85bf968144633be0da65bfc8be494a4ea6025b Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 16:59:19 +0100
Subject: [PATCH 117/146] clean file

---
 packages/ra-ui-materialui/src/list/List.spec.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/list/List.spec.tsx b/packages/ra-ui-materialui/src/list/List.spec.tsx
index 71f85d4eb49..32e25072101 100644
--- a/packages/ra-ui-materialui/src/list/List.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/List.spec.tsx
@@ -472,7 +472,7 @@ describe('<List />', () => {
             fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
             await screen.findByText('13 items selected');
         });
-        it.only('should select the maximum items possible until we reached the selectAllLimit', async () => {
+        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
             render(<SelectAllLimit />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);

From fbb290c215646090d8ed79ce0f68820bf8f1cadc Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 17:22:06 +0100
Subject: [PATCH 118/146] display SelectAllButton if all data are selected

---
 .../ra-ui-materialui/src/button/SelectAllButton.tsx   | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index 31499d47bbf..feb4762ae41 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -35,7 +35,7 @@ export const SelectAllButton = (props: SelectAllButtonProps) => {
         ...rest
     } = props;
 
-    const { total, selectedIds, onSelectAll } = useListContext();
+    const { total, selectedIds, onSelectAll, data } = useListContext();
     const handleSelectAll = useCallback(
         event => {
             onSelectAll({ limit, queryOptions });
@@ -44,7 +44,14 @@ export const SelectAllButton = (props: SelectAllButtonProps) => {
         [onClick, onSelectAll, queryOptions, limit]
     );
 
-    if (total === selectedIds.length || selectedIds.length >= limit)
+    const areAllDataSelected =
+        data && data.every(item => selectedIds.includes(item.id));
+
+    if (
+        total === selectedIds.length ||
+        selectedIds.length >= limit ||
+        !areAllDataSelected
+    )
         return null;
 
     return (

From 4f4feffbcc4ec782a231ee3aaa48ebbff346f99c Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 17:22:59 +0100
Subject: [PATCH 119/146] adapt tests `SelectAllButton` + add a test on the new
 display condition

---
 .../src/button/SelectAllButton.spec.tsx       | 47 ++++++++++++++-----
 .../src/button/SelectAllButton.stories.tsx    | 40 +++++++++++++++-
 2 files changed, 74 insertions(+), 13 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
index fa64f8e7dcf..6e77202b105 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
@@ -6,44 +6,67 @@ describe('<SelectAllButton />', () => {
     it('should render a "Select All" button', async () => {
         render(<Basic />);
         await screen.findByText('War and Peace');
-        fireEvent.click(screen.getAllByRole('checkbox')[1]);
+        fireEvent.click(screen.getAllByRole('checkbox')[0]);
         await screen.findByRole('button', { name: 'Select all' });
     });
-    it('should select all items', async () => {
+
+    it('should not render a "Select All" button if not all checkboxes are checked', async () => {
         render(<Basic />);
         await screen.findByText('War and Peace');
+        fireEvent.click(screen.getAllByRole('checkbox')[0]);
+        await screen.findByText('10 items selected');
+        expect(
+            screen.queryByRole('button', { name: 'Select all' })
+        ).not.toBeNull();
         fireEvent.click(screen.getAllByRole('checkbox')[1]);
-        await screen.findByText('1 item selected');
+        await screen.findByText('9 items selected');
+        expect(screen.queryByRole('button', { name: 'Select all' })).toBeNull();
+    });
+
+    it('should select all items', async () => {
+        render(<Basic />);
+        await screen.findByText('War and Peace');
+        fireEvent.click(screen.getAllByRole('checkbox')[0]);
+        await screen.findByText('10 items selected');
         fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
-        await screen.findByText('11 items selected');
+        await screen.findByText('17 items selected');
     });
+
     it('should render a button with a custom label', async () => {
         render(<Label />);
         await screen.findByText('War and Peace');
-        fireEvent.click(screen.getAllByRole('checkbox')[1]);
-        await screen.findByText('1 item selected');
+        fireEvent.click(screen.getAllByRole('checkbox')[0]);
+        await screen.findByText('10 items selected');
         await screen.findByRole('button', { name: 'Select all books' });
     });
+
     it('should not select more records than the limit', async () => {
         render(<Limit />);
         await screen.findByText('War and Peace');
-        fireEvent.click(screen.getAllByRole('checkbox')[1]);
-        await screen.findByText('1 item selected');
+        fireEvent.click(screen.getAllByRole('checkbox')[0]);
+        await screen.findByText('10 items selected');
         fireEvent.click(
-            screen.getByRole('button', { name: 'Select all books (max 5)' })
+            screen.getByRole('button', { name: 'Select all books (max 15)' })
         );
         await screen.findByText(
-            'There are too many elements to select them all. Only the first 5 elements were selected.'
+            'There are too many elements to select them all. Only the first 15 elements were selected.'
         );
-        await screen.findByText('5 items selected');
+        await screen.findByText('15 items selected');
     });
+
     it('should not render if we select more items than the limit', async () => {
         render(<Limit />);
         await screen.findByText('War and Peace');
         fireEvent.click(screen.getAllByRole('checkbox')[0]);
         await screen.findByText('10 items selected');
+        fireEvent.click(
+            screen.getByRole('button', { name: 'Go to next page' })
+        );
+        await screen.findByText('Ulysses');
+        fireEvent.click(screen.getAllByRole('checkbox')[0]);
+        await screen.findByText('17 items selected');
         expect(
-            screen.queryByRole('button', { name: 'Select 5 first books' })
+            screen.queryByRole('button', { name: 'Select all books (max 15)' })
         ).toBeNull();
     });
 });
diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
index c4de886c4ff..af46c41d16c 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
@@ -86,6 +86,42 @@ const dataProvider = fakeRestDataProvider({
             author: 'James Joyce',
             reads: 12,
         },
+        {
+            id: 12,
+            title: 'The Great Gatsby',
+            author: 'F. Scott Fitzgerald',
+            reads: 123,
+        },
+        {
+            id: 13,
+            title: 'A Journey To The Centre Of The Earth',
+            author: 'Jules Verne',
+            reads: 98,
+        },
+        {
+            id: 14,
+            title: 'The Adventures of Sherlock Holmes',
+            author: 'Arthur Conan Doyle',
+            reads: 123,
+        },
+        {
+            id: 15,
+            title: 'The Odyssey',
+            author: 'Homer',
+            reads: 23,
+        },
+        {
+            id: 16,
+            title: 'The Brothers Karamazov',
+            author: 'Fyodor Dostoevsky',
+            reads: 12,
+        },
+        {
+            id: 17,
+            title: 'The Divine Comedy',
+            author: 'Dante Alighieri',
+            reads: 123,
+        },
     ],
     authors: [],
 });
@@ -126,6 +162,8 @@ export const Label = () => (
 
 export const Limit = () => (
     <Wrapper
-        actions={<SelectAllButton label="Select all books (max 5)" limit={5} />}
+        actions={
+            <SelectAllButton label="Select all books (max 15)" limit={15} />
+        }
     />
 );

From e5fdcb7632fc156283bf71e10eec8316132555a0 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 17:54:52 +0100
Subject: [PATCH 120/146] adapt tests `Datagrid`

---
 .../src/list/datagrid/Datagrid.spec.tsx       |  10 +-
 .../src/list/datagrid/Datagrid.stories.tsx    | 120 ++++++++----------
 2 files changed, 61 insertions(+), 69 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
index 555f17ed3bf..2755936f8e3 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
@@ -114,15 +114,15 @@ describe('<Datagrid />', () => {
         );
     });
 
-    it('should accept a custom bulkActionsToolbar', () => {
+    it('should accept a custom bulkActionsToolbar', async () => {
         render(<BulkActionToolbar onlyDisplay="custom" />);
-        expect(screen.queryByText('Delete')).toBeNull();
+        fireEvent.click(await screen.findByLabelText('ra.action.select_all'));
         expect(screen.queryByText('Select all records')).not.toBeNull();
     });
 
-    it('should not display the bulk actions toolbar when when `bulkActionsToolbar` prop is false', () => {
+    it('should not display the bulk actions toolbar when when `bulkActionsToolbar` prop is false', async () => {
         render(<BulkActionToolbar onlyDisplay="disabled" />);
-        expect(screen.queryByText('Delete')).toBeNull();
+        fireEvent.click(await screen.findByLabelText('ra.action.select_all'));
         expect(screen.queryByText('Select All')).toBeNull();
     });
 
@@ -313,7 +313,7 @@ describe('<Datagrid />', () => {
             await waitFor(() =>
                 expect(
                     screen.queryAllByLabelText('Select this row')
-                ).toHaveLength(4)
+                ).toHaveLength(7)
             );
         });
     });
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
index 3c0f423e7bb..224ce2be970 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
@@ -38,66 +38,64 @@ import { BulkActionsToolbar } from '../BulkActionsToolbar';
 
 export default { title: 'ra-ui-materialui/list/Datagrid' };
 
-const data = [
-    {
-        id: 1,
-        title: 'War and Peace',
-        author: 'Leo Tolstoy',
-        year: 1869,
-    },
-    {
-        id: 2,
-        title: 'Pride and Predjudice',
-        author: 'Jane Austen',
-        year: 1813,
-    },
-    {
-        id: 3,
-        title: 'The Picture of Dorian Gray',
-        author: 'Oscar Wilde',
-        year: 1890,
-    },
-    {
-        id: 4,
-        title: 'Le Petit Prince',
-        author: 'Antoine de Saint-Exupéry',
-        year: 1943,
-    },
-];
+const data = {
+    books: [
+        {
+            id: 1,
+            title: 'War and Peace',
+            author: 'Leo Tolstoy',
+            year: 1869,
+        },
+        {
+            id: 2,
+            title: 'Pride and Predjudice',
+            author: 'Jane Austen',
+            year: 1813,
+        },
+        {
+            id: 3,
+            title: 'The Picture of Dorian Gray',
+            author: 'Oscar Wilde',
+            year: 1890,
+        },
+        {
+            id: 4,
+            title: 'Le Petit Prince',
+            author: 'Antoine de Saint-Exupéry',
+            year: 1943,
+        },
+        {
+            id: 5,
+            title: 'The Alchemist',
+            author: 'Paulo Coelho',
+            year: 1988,
+        },
+        {
+            id: 6,
+            title: 'Madame Bovary',
+            author: 'Gustave Flaubert',
+            year: 1857,
+        },
+        {
+            id: 7,
+            title: 'The Lord of the Rings',
+            author: 'J. R. R. Tolkien',
+            year: 1954,
+        },
+    ],
+};
 
 const theme = createTheme();
 
-const SubWrapper = ({ children }) => {
-    const [selectedIds, selectionModifiers] = useRecordSelection({
-        resource: 'books',
-    });
-    return (
+const Wrapper = ({ children }) => (
+    <CoreAdminContext dataProvider={fakeRestDataProvider(data)}>
         <ThemeProvider theme={theme}>
             <ResourceContextProvider value="books">
-                <ListContextProvider
-                    value={
-                        {
-                            data,
-                            total: 4,
-                            isLoading: false,
-                            sort: { field: 'id', order: 'ASC' },
-                            selectedIds,
-                            onSelect: selectionModifiers.select,
-                            onToggleItem: selectionModifiers.toggle,
-                            onUnselectItems: selectionModifiers.clearSelection,
-                        } as any
-                    }
-                >
-                    <Box sx={{ pt: 7, px: 4 }}>{children}</Box>
-                </ListContextProvider>
+                <List perPage={5} sx={{ px: 4 }}>
+                    {children}
+                </List>
             </ResourceContextProvider>
         </ThemeProvider>
-    );
-};
-
-const Wrapper = ({ children }) => (
-    <CoreAdminContext>
-        <SubWrapper>{children}</SubWrapper>
     </CoreAdminContext>
 );
 
@@ -202,7 +200,7 @@ export const BulkActionToolbar = ({
 }) => (
     <Wrapper>
         <Box sx={{ mt: -7 }}>
-            {onlyDisplay && onlyDisplay === 'default' && (
+            {(!onlyDisplay || onlyDisplay === 'default') && (
                 <>
                     <h1>Default</h1>
                     <Datagrid>
@@ -213,7 +211,7 @@ export const BulkActionToolbar = ({
                     </Datagrid>
                 </>
             )}
-            {onlyDisplay && onlyDisplay === 'disabled' && (
+            {(!onlyDisplay || onlyDisplay === 'disabled') && (
                 <>
                     <h1>Disabled</h1>
                     <Datagrid bulkActionsToolbar={false}>
@@ -224,7 +222,7 @@ export const BulkActionToolbar = ({
                     </Datagrid>
                 </>
             )}
-            {onlyDisplay && onlyDisplay === 'custom' && (
+            {(!onlyDisplay || onlyDisplay === 'custom') && (
                 <>
                     <h1>Custom</h1>
                     <Datagrid bulkActionsToolbar={<CutomBulkActionToolbar />}>
@@ -430,11 +428,7 @@ const MyCustomListInteractive = () => {
 
 export const Standalone = () => (
     <ThemeProvider theme={theme}>
-        <CoreAdminContext
-            dataProvider={testDataProvider({
-                getList: () => Promise.resolve({ data, total: 4 }) as any,
-            })}
-        >
+        <CoreAdminContext dataProvider={fakeRestDataProvider(data)}>
             <ResourceContextProvider value="books">
                 <h1>Static</h1>
                 <MyCustomList />
@@ -526,11 +520,9 @@ export const RowClickFalse = () => (
     </Wrapper>
 );
 
-const dataProvider = fakeRestDataProvider({ books: data });
-
 export const FullApp = () => (
     <AdminContext
-        dataProvider={dataProvider}
+        dataProvider={fakeRestDataProvider(data)}
         i18nProvider={polyglotI18nProvider(() => defaultMessages, 'en')}
     >
         <AdminUI>

From 2d9822dfc995454e871d81870146466e3abde90d Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 17:55:51 +0100
Subject: [PATCH 121/146] simplify stories

---
 .../src/list/datagrid/Datagrid.stories.tsx                | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
index 224ce2be970..76486538ca5 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
@@ -85,10 +85,12 @@ const data = {
     ],
 };
 
+const dataProvider = fakeRestDataProvider(data);
+
 const theme = createTheme();
 
 const Wrapper = ({ children }) => (
-    <CoreAdminContext dataProvider={fakeRestDataProvider(data)}>
+    <CoreAdminContext dataProvider={dataProvider}>
         <ThemeProvider theme={theme}>
             <ResourceContextProvider value="books">
                 <List perPage={5} sx={{ px: 4 }}>
@@ -428,7 +430,7 @@ const MyCustomListInteractive = () => {
 
 export const Standalone = () => (
     <ThemeProvider theme={theme}>
-        <CoreAdminContext dataProvider={fakeRestDataProvider(data)}>
+        <CoreAdminContext dataProvider={dataProvider}>
             <ResourceContextProvider value="books">
                 <h1>Static</h1>
                 <MyCustomList />
@@ -522,7 +524,7 @@ export const RowClickFalse = () => (
 
 export const FullApp = () => (
     <AdminContext
-        dataProvider={fakeRestDataProvider(data)}
+        dataProvider={dataProvider}
         i18nProvider={polyglotI18nProvider(() => defaultMessages, 'en')}
     >
         <AdminUI>

From 1bd2dcb686a515814527b78245ad174049639d4a Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 17:59:08 +0100
Subject: [PATCH 122/146] adapt tests `List`

---
 packages/ra-ui-materialui/src/list/List.spec.tsx | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/List.spec.tsx b/packages/ra-ui-materialui/src/list/List.spec.tsx
index 32e25072101..bc64652d216 100644
--- a/packages/ra-ui-materialui/src/list/List.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/List.spec.tsx
@@ -352,7 +352,7 @@ describe('<List />', () => {
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
-            fireEvent.click(screen.getAllByRole('checkbox')[1]);
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
             expect(
                 await screen.findByRole('button', { name: 'Select all' })
             ).toBeDefined();
@@ -451,8 +451,8 @@ describe('<List />', () => {
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
             });
-            fireEvent.click(screen.getAllByRole('checkbox')[1]);
-            await screen.findByText('1 item selected');
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('10 items selected');
             fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
             await screen.findByText('11 items selected');
             await screen.findByText(

From f5144e805b5a408658c29f259cb4ab8cc172a1cb Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 18:00:55 +0100
Subject: [PATCH 123/146] adapt tests `ReferenceManyField`

---
 .../ra-ui-materialui/src/field/ReferenceManyField.spec.tsx  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
index 66ad7875ae7..dd834ec63cd 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
@@ -280,7 +280,7 @@ describe('<ReferenceManyField />', () => {
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
             });
-            fireEvent.click(screen.getAllByRole('checkbox')[1]);
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
             expect(
                 await screen.findByRole('button', { name: 'Select all' })
             ).toBeDefined();
@@ -379,8 +379,8 @@ describe('<ReferenceManyField />', () => {
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
             });
-            fireEvent.click(screen.getAllByRole('checkbox')[1]);
-            await screen.findByText('1 item selected');
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('5 items selected');
             fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
             await screen.findByText('6 items selected');
             await screen.findByText(

From b300053cc3754c762eaf909b3b170b8ca2151adc Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 18:01:36 +0100
Subject: [PATCH 124/146] adapt tests `ReferenceArrayField`

---
 .../ra-ui-materialui/src/field/ReferenceArrayField.spec.tsx     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/field/ReferenceArrayField.spec.tsx b/packages/ra-ui-materialui/src/field/ReferenceArrayField.spec.tsx
index d5ed9e9180e..88ef5e67fd9 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceArrayField.spec.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceArrayField.spec.tsx
@@ -339,7 +339,7 @@ describe('<ReferenceArrayField />', () => {
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
             });
-            fireEvent.click(screen.getAllByRole('checkbox')[1]);
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
             expect(
                 await screen.findByRole('button', { name: 'Select all' })
             ).toBeDefined();

From 614f4d18f2909bad062534626ccc5ca3bb83203f Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Wed, 18 Dec 2024 19:36:58 +0100
Subject: [PATCH 125/146] improve buttons color

---
 packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index ce0628de40b..34f3e99b81b 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -1,6 +1,6 @@
 import * as React from 'react';
 import { isValidElement, ReactElement, ReactNode, useCallback } from 'react';
-import { styled } from '@mui/material/styles';
+import { alpha, styled } from '@mui/material/styles';
 import clsx from 'clsx';
 import Toolbar from '@mui/material/Toolbar';
 import Typography from '@mui/material/Typography';
@@ -46,11 +46,12 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
                         aria-label={translate('ra.action.unselect')}
                         title={translate('ra.action.unselect')}
                         onClick={handleUnselectAllClick}
+                        color="primary"
                         size="small"
                     >
                         <CloseIcon fontSize="small" />
                     </IconButton>
-                    <Typography color="inherit" variant="subtitle1">
+                    <Typography color="text.primary" variant="subtitle1">
                         {translate(label, {
                             _: label,
                             smart_count: selectedIds.length,
@@ -144,5 +145,8 @@ const Root = styled('div', {
 
     [`& .${BulkActionsToolbarClasses.icon}`]: {
         marginLeft: '-0.5em',
+        '&:hover': {
+            backgroundColor: alpha(theme.palette.primary.main, 0.12),
+        },
     },
 }));

From 9df60b1a7234ee85e74979cbe8764e1003f06097 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 19 Dec 2024 10:06:03 +0100
Subject: [PATCH 126/146] Adapt ExpandAllButton's test with the new story

---
 .../src/list/datagrid/ExpandAllButton.spec.tsx                | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/list/datagrid/ExpandAllButton.spec.tsx b/packages/ra-ui-materialui/src/list/datagrid/ExpandAllButton.spec.tsx
index a37ed597d36..5ab48ee866b 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/ExpandAllButton.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/ExpandAllButton.spec.tsx
@@ -19,10 +19,12 @@ describe('ExpandAllButton', () => {
             expect(screen.queryAllByTestId('ExpandPanel')).toHaveLength(count);
         };
 
+        await screen.findByText('War and Peace');
+
         expectExpandedRows(0);
 
         expand();
-        expectExpandedRows(4);
+        expectExpandedRows(5);
 
         collapse();
         expectExpandedRows(0);

From 969fd83a4e9d0d1b0252416ed5197a34640b0c5b Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 15:02:25 +0100
Subject: [PATCH 127/146] fix linter warning

---
 .../ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx     | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
index 5b47993aef3..c60c0592e9c 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
@@ -4,9 +4,7 @@ import {
     ResourceContextProvider,
     ListContextProvider,
     CoreAdminContext,
-    testDataProvider,
     useRecordContext,
-    useRecordSelection,
     useGetList,
     useList,
     TestMemoryRouter,

From 832e4ba8c619e182b134cdf18565697fc7e0e775 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 15:41:49 +0100
Subject: [PATCH 128/146] add a usage section

---
 docs/Buttons.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/docs/Buttons.md b/docs/Buttons.md
index 2830445f308..3f2b9ab65b0 100644
--- a/docs/Buttons.md
+++ b/docs/Buttons.md
@@ -962,6 +962,33 @@ The `<SelectAllButton>` component allows users to select all items from a resour
 
 ![SelectAllButton](./img/SelectAllButton.png)
 
+## Usage
+
+By default, react-admin's `<Datagrid>` displays a `<SelectAllButton>` in their List view action toolbar. You can custom it by specifying your own `selectAllButton`:
+
+{% raw %}
+
+```jsx
+import { List, Datagrid, SelectAllButton } from 'react-admin';
+
+const PostSelectAllButton = () => (
+    <SelectAllButton 
+        label="Select all records"
+        queryOptions={{ meta: { foo: 'bar' } }}
+    />
+);
+
+export const PostList = () => (
+    <List>
+        <Datagrid selectAllButton={<PostSelectAllButton />}>
+            ...
+        </Datagrid>
+    </List>
+);
+```
+
+{% endraw %}
+
 ### `label`
 
 By default, the `<SelectAllButton>` label is "Select all" (or the `ra.action.select_all_button` message translation). You can also pass a custom `label`:

From 33095353860635ac5c04fd3efc481911af2b7b08 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 15:43:17 +0100
Subject: [PATCH 129/146] remove the `bulkActionsToolbar` prop and create
 `selectAllButton`'s prop

---
 docs/Buttons.md                               |  2 +-
 docs/Datagrid.md                              | 43 ++++-------------
 .../src/list/BulkActionsToolbar.tsx           | 14 +++---
 .../src/list/datagrid/Datagrid.spec.tsx       |  6 +--
 .../src/list/datagrid/Datagrid.stories.tsx    | 21 ++++-----
 .../src/list/datagrid/Datagrid.tsx            | 47 ++++++-------------
 6 files changed, 44 insertions(+), 89 deletions(-)

diff --git a/docs/Buttons.md b/docs/Buttons.md
index 3f2b9ab65b0..d239168fc7c 100644
--- a/docs/Buttons.md
+++ b/docs/Buttons.md
@@ -964,7 +964,7 @@ The `<SelectAllButton>` component allows users to select all items from a resour
 
 ## Usage
 
-By default, react-admin's `<Datagrid>` displays a `<SelectAllButton>` in their List view action toolbar. You can custom it by specifying your own `selectAllButton`:
+By default, react-admin's `<Datagrid>` displays a `<SelectAllButton>` in their List view action toolbar. You can custom it by specifying your own [`selectAllButton`](./Datagrid.md#selectallbutton):
 
 {% raw %}
 
diff --git a/docs/Datagrid.md b/docs/Datagrid.md
index 7170728845a..fd495e24456 100644
--- a/docs/Datagrid.md
+++ b/docs/Datagrid.md
@@ -50,7 +50,6 @@ Both are [Enterprise Edition](https://react-admin-ee.marmelab.com) components.
 | `children`           | Required | Element                 | n/a                   | The list of `<Field>` components to render as columns.        |
 | `body`               | Optional | Element                 | `<Datagrid Body>`     | The component used to render the body of the table.           |
 | `bulkActionButtons`  | Optional | Element                 | `<BulkDelete Button>` | The component used to render the bulk action buttons.         |
-| `bulkActionsToolbar` | Optional | Element                 |                       | The component used to render the bulk actions toolbar.        |
 | `empty`              | Optional | Element                 | `<Empty>`             | The component used to render the empty table.                 |
 | `expand`             | Optional | Element                 |                       | The component used to render the expand panel for each row.   |
 | `expandSingle`       | Optional | Boolean                 | `false`               | Whether to allow only one expanded row at a time.             |
@@ -62,6 +61,7 @@ Both are [Enterprise Edition](https://react-admin-ee.marmelab.com) components.
 | `rowClick`           | Optional | mixed                   |                       | The action to trigger when the user clicks on a row.          |
 | `rowStyle`           | Optional | Function                |                       | A function that returns the style to apply to a row.          |
 | `rowSx`              | Optional | Function                |                       | A function that returns the sx prop to apply to a row.        |
+| `selectAllButton`    | Optional | Element or  `false`     |                       | The button used to select all records.                        |
 | `size`               | Optional | `'small'` or `'medium'` | `'small'`             | The size of the table.                                        |
 | `sx`                 | Optional | Object                  |                       | The sx prop passed down to the Material UI `<Table>` element. |
 
@@ -374,61 +374,38 @@ const CustomResetViewsButton = () => {
 };
 ```
 
-## `bulkActionsToolbar`
+## `selectAllButton`
 
-You can use the `bulkActionsToolbar` prop to customize the bulk action toolbar, displayed when at least one row is selected.
-
-You disable this feature by setting the `bulkActionsToolbar` prop to `false`:
+You can use the `selectAllButton` prop to customize the default [`<SelectAllButton>`](./Buttons.md#selectallbutton) displayed in the bulk action toolbar when at least one row is selected.
 
 ```tsx
-import { Datagrid, List } from 'react-admin';
+import { List, Datagrid, SelectAllButton } from 'react-admin';
+
+const PostSelectAllButton = () => <SelectAllButton label="Select all records" />
 
 export const PostList = () => (
     <List>
-        <Datagrid bulkActionsToolbar={false}>
+        <Datagrid selectAllButton={<PostSelectAllButton />}>
             ...
         </Datagrid>
     </List>
 );
 ```
 
-By default, all Datagrids have a single `action`, [the select all button](./Buttons.md#selectallbutton).
-You can customize this button or add others by passing a custom element as the `bulkActionsToolbar` prop of the `<Datagrid>` component:
-
-{% raw %}
+You disable this feature by setting the `selectAllButton` prop to `false`:
 
 ```tsx
-import { List, Datagrid, BulkActionsToolbar, SelectAllButton, BulkDeleteButton, useUnselectAll, Button } from 'react-admin';
-
-const UnselectButton = () => {
-    const unselect = useUnselectAll('posts');
-    return <Button onClick={unselect} label="Unselect all records" />;
-};
-
-const PostBulkActionsToolbar = () => (
-    <BulkActionsToolbar actions={
-        <>
-            <SelectAllButton label="Select all records" />
-            <UnselectButton />
-        </>
-    }>
-        <BulkDeleteButton />
-    </BulkActionsToolbar>
-);
+import { Datagrid, List } from 'react-admin';
 
 export const PostList = () => (
     <List>
-        <Datagrid bulkActionsToolbar={<PostBulkActionsToolbar />}>
+        <Datagrid selectAllButton={false}>
             ...
         </Datagrid>
     </List>
 );
 ```
 
-{% endraw %}
-
-**Tip**: This customization will bring up your new `UnselectAll` button on the left-hand side of the toolbar. To work on the right-hand side, you can use the [`bulkActionButtons`](#bulkactionbuttons) prop.
-
 ## `children`
 
 `<Datagrid>` accepts a list of Field components as children. It inspects each child's `source` and/or `label` props to determine the name of the column.
diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index 34f3e99b81b..c673a48968d 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -12,14 +12,14 @@ import { useTranslate, sanitizeListRestProps, useListContext } from 'ra-core';
 import TopToolbar from '../layout/TopToolbar';
 import { SelectAllButton } from '../button';
 
-const defaultActions = <SelectAllButton />;
+const defaultSelectAllButton = <SelectAllButton />;
 
 export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
     const {
         label = 'ra.action.bulk_actions',
         children,
         className,
-        actions = defaultActions,
+        selectAllButton = defaultSelectAllButton,
         ...rest
     } = props;
     const { selectedIds = [], onUnselectItems } = useListContext();
@@ -57,10 +57,10 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
                             smart_count: selectedIds.length,
                         })}
                     </Typography>
-                    {actions !== false
-                        ? isValidElement(actions)
-                            ? actions
-                            : defaultActions
+                    {selectAllButton !== false
+                        ? isValidElement(selectAllButton)
+                            ? selectAllButton
+                            : defaultSelectAllButton
                         : null}
                 </div>
                 <TopToolbar className={BulkActionsToolbarClasses.topToolbar}>
@@ -75,7 +75,7 @@ export interface BulkActionsToolbarProps {
     children?: ReactNode;
     label?: string;
     className?: string;
-    actions?: ReactElement | false;
+    selectAllButton?: ReactElement | false;
 }
 
 const PREFIX = 'RaBulkActionsToolbar';
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
index 2755936f8e3..d6aa3c88148 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.spec.tsx
@@ -10,7 +10,7 @@ import {
 import { ThemeProvider, createTheme } from '@mui/material';
 
 import { Datagrid } from './Datagrid';
-import { AccessControl, BulkActionToolbar } from './Datagrid.stories';
+import { AccessControl, SelectAllButton } from './Datagrid.stories';
 
 const TitleField = (): JSX.Element => {
     const record = useRecordContext();
@@ -115,13 +115,13 @@ describe('<Datagrid />', () => {
     });
 
     it('should accept a custom bulkActionsToolbar', async () => {
-        render(<BulkActionToolbar onlyDisplay="custom" />);
+        render(<SelectAllButton onlyDisplay="custom" />);
         fireEvent.click(await screen.findByLabelText('ra.action.select_all'));
         expect(screen.queryByText('Select all records')).not.toBeNull();
     });
 
     it('should not display the bulk actions toolbar when when `bulkActionsToolbar` prop is false', async () => {
-        render(<BulkActionToolbar onlyDisplay="disabled" />);
+        render(<SelectAllButton onlyDisplay="disabled" />);
         fireEvent.click(await screen.findByLabelText('ra.action.select_all'));
         expect(screen.queryByText('Select All')).toBeNull();
     });
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
index c60c0592e9c..a737a036917 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
@@ -22,7 +22,7 @@ import { FieldProps, TextField } from '../../field';
 import {
     BulkDeleteButton,
     BulkExportButton,
-    SelectAllButton,
+    SelectAllButton as RaSelectAllButton,
 } from '../../button';
 import { Datagrid, DatagridProps } from './Datagrid';
 import { ShowGuesser, SimpleShowLayout } from '../../detail';
@@ -32,7 +32,6 @@ import { List } from '../List';
 import { EditGuesser } from '../../detail';
 import { DatagridRowProps } from './DatagridRow';
 import DatagridBody, { DatagridBodyProps } from './DatagridBody';
-import { BulkActionsToolbar } from '../BulkActionsToolbar';
 
 export default { title: 'ra-ui-materialui/list/Datagrid' };
 
@@ -185,15 +184,7 @@ export const RowSx = () => (
     </Wrapper>
 );
 
-const CutomBulkActionToolbar = () => (
-    <BulkActionsToolbar
-        actions={<SelectAllButton label="Select all records" />}
-    >
-        <BulkDeleteButton />
-    </BulkActionsToolbar>
-);
-
-export const BulkActionToolbar = ({
+export const SelectAllButton = ({
     onlyDisplay,
 }: {
     onlyDisplay?: 'default' | 'disabled' | 'custom';
@@ -214,7 +205,7 @@ export const BulkActionToolbar = ({
             {(!onlyDisplay || onlyDisplay === 'disabled') && (
                 <>
                     <h1>Disabled</h1>
-                    <Datagrid bulkActionsToolbar={false}>
+                    <Datagrid selectAllButton={false}>
                         <TextField source="id" />
                         <TextField source="title" />
                         <TextField source="author" />
@@ -225,7 +216,11 @@ export const BulkActionToolbar = ({
             {(!onlyDisplay || onlyDisplay === 'custom') && (
                 <>
                     <h1>Custom</h1>
-                    <Datagrid bulkActionsToolbar={<CutomBulkActionToolbar />}>
+                    <Datagrid
+                        selectAllButton={
+                            <RaSelectAllButton label="Select all records" />
+                        }
+                    >
                         <TextField source="id" />
                         <TextField source="title" />
                         <TextField source="author" />
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
index c1a10d791ec..82f4479934d 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
@@ -33,6 +33,7 @@ import { RowClickFunction } from '../types';
 import DatagridContextProvider from './DatagridContextProvider';
 import { DatagridClasses, DatagridRoot } from './useDatagridStyles';
 import { BulkActionsToolbar } from '../BulkActionsToolbar';
+import type { BulkActionsToolbarProps } from '../BulkActionsToolbar';
 import { BulkDeleteButton } from '../../button';
 import { ListNoResults } from '../ListNoResults';
 
@@ -44,7 +45,7 @@ const defaultBulkActionButtons = <BulkDeleteButton />;
  *
  * Props:
  *  - body
- *  - bulkActionToolbar
+ *  - selectAllButton
  *  - bulkActionButtons
  *  - children
  *  - empty
@@ -133,7 +134,7 @@ export const Datagrid: React.ForwardRefExoticComponent<
         className,
         empty = DefaultEmpty,
         expand,
-        bulkActionsToolbar,
+        selectAllButton,
         bulkActionButtons = canDelete ? defaultBulkActionButtons : false,
         hover,
         isRowSelectable,
@@ -246,15 +247,13 @@ export const Datagrid: React.ForwardRefExoticComponent<
                     sx={sx}
                     className={clsx(DatagridClasses.root, className)}
                 >
-                    {bulkActionButtons !== false && bulkActionsToolbar !== false
-                        ? bulkActionsToolbar || (
-                              <BulkActionsToolbar>
-                                  {isValidElement(bulkActionButtons)
-                                      ? bulkActionButtons
-                                      : defaultBulkActionButtons}
-                              </BulkActionsToolbar>
-                          )
-                        : null}
+                    {bulkActionButtons !== false ? (
+                        <BulkActionsToolbar selectAllButton={selectAllButton}>
+                            {isValidElement(bulkActionButtons)
+                                ? bulkActionButtons
+                                : defaultBulkActionButtons}
+                        </BulkActionsToolbar>
+                    ) : null}
                     <div className={DatagridClasses.tableWrapper}>
                         <Table
                             ref={ref}
@@ -322,37 +321,21 @@ export interface DatagridProps<RecordType extends RaRecord = any>
     className?: string;
 
     /**
-     * The component used to render the bulk actions toolbar.
+     * The button used to select all records.
      *
-     * @see https://marmelab.com/react-admin/Datagrid.html#bulkactionstoolbar
+     * @see https://marmelab.com/react-admin/Datagrid.html#selectallbutton
      * @example
-     * import { List, Datagrid, BulkActionsToolbar, SelectAllButton, BulkDeleteButton, useUnselectAll, Button } from 'react-admin';
-     *
-     * const UnselectButton = () => {
-     *     const unselect = useUnselectAll('posts');
-     *     return <Button onClick={unselect} label="Unselect all records" />;
-     * };
-     *
-     * const PostBulkActionsToolbar = () => (
-     *     <BulkActionsToolbar actions={
-     *         <>
-     *             <SelectAllButton label="Select all records" />
-     *             <UnselectButton />
-     *         </>
-     *     }>
-     *         <BulkDeleteButton />
-     *     </BulkActionsToolbar>
-     * );
+     * import { List, Datagrid, SelectAllButton } from 'react-admin';
      *
      * export const PostList = () => (
      *     <List>
-     *         <Datagrid bulkActionsToolbar={<PostBulkActionsToolbar />}>
+     *         <Datagrid selectAllButton={<SelectAllButton label="Select all records" />}>
      *             ...
      *         </Datagrid>
      *     </List>
      * );
      */
-    bulkActionsToolbar?: ReactElement | false;
+    selectAllButton?: BulkActionsToolbarProps['selectAllButton'];
 
     /**
      * The component used to render the bulk action buttons. Defaults to <BulkDeleteButton>.

From 75f21ef3a5ca6c680111356ceaf871146249ce54 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 15:50:17 +0100
Subject: [PATCH 130/146] improve jsDoc example

---
 .../ra-ui-materialui/src/button/SelectAllButton.tsx   | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index feb4762ae41..3a4a4e2bb50 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -23,7 +23,18 @@ import { Button, ButtonProps } from './Button';
  * @param {Props} props
  *
  * @example
+ *
+ * import { SelectAllButton, List, Datagrid } from 'react-admin';
+ *
  * const MySelectAllButton = () => <SelectAllButton limit={100} label="Select all books" />;
+ *
+ * const PostList = () => (
+ *    <List>
+ *       <Datagrid selectAllButton={<MySelectAllButton />}>
+ *          // ...
+ *      </Datagrid>
+ *   </List>
+ * );
  */
 
 export const SelectAllButton = (props: SelectAllButtonProps) => {

From 0a2399a5fdfc5395d27c8ff968cc3a4b27c0648a Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 15:56:45 +0100
Subject: [PATCH 131/146] wrap tests in some `describe`

---
 .../src/button/SelectAllButton.spec.tsx       | 74 ++++++++++---------
 1 file changed, 41 insertions(+), 33 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
index 6e77202b105..06b614f0302 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
@@ -32,41 +32,49 @@ describe('<SelectAllButton />', () => {
         await screen.findByText('17 items selected');
     });
 
-    it('should render a button with a custom label', async () => {
-        render(<Label />);
-        await screen.findByText('War and Peace');
-        fireEvent.click(screen.getAllByRole('checkbox')[0]);
-        await screen.findByText('10 items selected');
-        await screen.findByRole('button', { name: 'Select all books' });
+    describe('label', () => {
+        it('should allow to customize the label', async () => {
+            render(<Label />);
+            await screen.findByText('War and Peace');
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('10 items selected');
+            await screen.findByRole('button', { name: 'Select all books' });
+        });
     });
 
-    it('should not select more records than the limit', async () => {
-        render(<Limit />);
-        await screen.findByText('War and Peace');
-        fireEvent.click(screen.getAllByRole('checkbox')[0]);
-        await screen.findByText('10 items selected');
-        fireEvent.click(
-            screen.getByRole('button', { name: 'Select all books (max 15)' })
-        );
-        await screen.findByText(
-            'There are too many elements to select them all. Only the first 15 elements were selected.'
-        );
-        await screen.findByText('15 items selected');
-    });
+    describe('limit', () => {
+        it('should not select more records than the limit', async () => {
+            render(<Limit />);
+            await screen.findByText('War and Peace');
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('10 items selected');
+            fireEvent.click(
+                screen.getByRole('button', {
+                    name: 'Select all books (max 15)',
+                })
+            );
+            await screen.findByText(
+                'There are too many elements to select them all. Only the first 15 elements were selected.'
+            );
+            await screen.findByText('15 items selected');
+        });
 
-    it('should not render if we select more items than the limit', async () => {
-        render(<Limit />);
-        await screen.findByText('War and Peace');
-        fireEvent.click(screen.getAllByRole('checkbox')[0]);
-        await screen.findByText('10 items selected');
-        fireEvent.click(
-            screen.getByRole('button', { name: 'Go to next page' })
-        );
-        await screen.findByText('Ulysses');
-        fireEvent.click(screen.getAllByRole('checkbox')[0]);
-        await screen.findByText('17 items selected');
-        expect(
-            screen.queryByRole('button', { name: 'Select all books (max 15)' })
-        ).toBeNull();
+        it('should not render if we select more items than the limit', async () => {
+            render(<Limit />);
+            await screen.findByText('War and Peace');
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('10 items selected');
+            fireEvent.click(
+                screen.getByRole('button', { name: 'Go to next page' })
+            );
+            await screen.findByText('Ulysses');
+            fireEvent.click(screen.getAllByRole('checkbox')[0]);
+            await screen.findByText('17 items selected');
+            expect(
+                screen.queryByRole('button', {
+                    name: 'Select all books (max 15)',
+                })
+            ).toBeNull();
+        });
     });
 });

From c5d27229d515c7dbf171cea322079b815d6558a6 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 15:58:13 +0100
Subject: [PATCH 132/146] rename `handleSelectAll` into `handleClick`

---
 packages/ra-ui-materialui/src/button/SelectAllButton.tsx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index 3a4a4e2bb50..01c02e6a966 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -47,7 +47,7 @@ export const SelectAllButton = (props: SelectAllButtonProps) => {
     } = props;
 
     const { total, selectedIds, onSelectAll, data } = useListContext();
-    const handleSelectAll = useCallback(
+    const handleClick = useCallback(
         event => {
             onSelectAll({ limit, queryOptions });
             if (onClick) onClick(event);
@@ -68,7 +68,7 @@ export const SelectAllButton = (props: SelectAllButtonProps) => {
     return (
         <StyledButton
             label={label}
-            onClick={handleSelectAll}
+            onClick={handleClick}
             type="button"
             {...rest}
         />

From 781ab5ad7214d0ac485baa7bf46de1ca72bd665f Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 15:58:44 +0100
Subject: [PATCH 133/146] fix typo

---
 packages/ra-ui-materialui/src/button/SelectAllButton.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index 01c02e6a966..7045ed5ae53 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -13,7 +13,7 @@ import { Button, ButtonProps } from './Button';
 /**
  * Select all items in the current List context.
  *
- * Used un Datagrid's bulk action toolbar.
+ * Used in Datagrid's bulk action toolbar.
  *
  * @typedef {Object} Props the props you can use
  * @prop {string} label Button label. Defaults to 'ra.action.select_all_button', translated.

From 0bbb005fe12f6caad014acd056be1ee7f4155687 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 16:02:35 +0100
Subject: [PATCH 134/146] Rename `List` into  `ListView`

---
 packages/ra-core/src/controller/list/useList.stories.tsx  | 8 ++++----
 .../src/controller/list/useListController.stories.tsx     | 4 ++--
 .../ra-core/src/controller/list/useSelectAll.stories.tsx  | 6 ++++--
 3 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useList.stories.tsx b/packages/ra-core/src/controller/list/useList.stories.tsx
index f01bb406ebc..37b0981ce1d 100644
--- a/packages/ra-core/src/controller/list/useList.stories.tsx
+++ b/packages/ra-core/src/controller/list/useList.stories.tsx
@@ -7,7 +7,7 @@ export default {
     title: 'ra-core/controller/list/useList',
 };
 
-const List = () => {
+const ListView = () => {
     const listContext = useListContext();
     return (
         <div>
@@ -65,7 +65,7 @@ const data = [
 ];
 
 const Wrapper = ({
-    children = <List />,
+    children = <ListView />,
     callback,
     ...props
 }: {
@@ -113,7 +113,7 @@ const SortButton = () => {
 export const Sort = props => (
     <Wrapper {...props}>
         <SortButton />
-        <List />
+        <ListView />
     </Wrapper>
 );
 
@@ -140,6 +140,6 @@ const SelectAllButton = () => {
 export const SelectAll = props => (
     <Wrapper {...props}>
         <SelectAllButton />
-        <List />
+        <ListView />
     </Wrapper>
 );
diff --git a/packages/ra-core/src/controller/list/useListController.stories.tsx b/packages/ra-core/src/controller/list/useListController.stories.tsx
index ea6cbb76e19..2684fe1e9f1 100644
--- a/packages/ra-core/src/controller/list/useListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useListController.stories.tsx
@@ -26,7 +26,7 @@ export const defaultDataProvider = fakeDataProvider(
     process.env.NODE_ENV === 'development'
 );
 
-const List = params => (
+const ListView = params => (
     <div>
         <div
             style={{
@@ -88,7 +88,7 @@ const List = params => (
 
 export const Basic = ({
     dataProvider = defaultDataProvider,
-    children = List,
+    children = ListView,
 }: {
     dataProvider?: DataProvider;
     children?: (params: ListControllerResult) => JSX.Element;
diff --git a/packages/ra-core/src/controller/list/useSelectAll.stories.tsx b/packages/ra-core/src/controller/list/useSelectAll.stories.tsx
index ce22729379a..985d1672038 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.stories.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.stories.tsx
@@ -25,7 +25,7 @@ export const defaultDataProvider = fakeDataProvider(
     process.env.NODE_ENV === 'development'
 );
 
-const List = ({ options, ...params }) => (
+const ListView = ({ options, ...params }) => (
     <div>
         <SelectAllButton options={options} />
         <p>Selected ids: {JSON.stringify(params.selectedIds)}</p>
@@ -70,7 +70,9 @@ const SelectAllButton = ({ options }) => {
 export const Basic = ({ dataProvider = defaultDataProvider, options }) => (
     <CoreAdminContext dataProvider={dataProvider}>
         <ListController resource="posts">
-            {controllerProps => <List {...controllerProps} options={options} />}
+            {controllerProps => (
+                <ListView {...controllerProps} options={options} />
+            )}
         </ListController>
     </CoreAdminContext>
 );

From ed4713a8d366700181505e86846a45cd7b2cb8d1 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 16:07:18 +0100
Subject: [PATCH 135/146] rename story files

---
 ...stories.tsx => useReferenceArrayFieldController.stories.tsx} | 2 +-
 ...anyField.stories.tsx => useReferenceManyFieldController.tsx} | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename packages/ra-core/src/controller/field/{ReferenceArrayField.stories.tsx => useReferenceArrayFieldController.stories.tsx} (97%)
 rename packages/ra-core/src/controller/field/{ReferenceManyField.stories.tsx => useReferenceManyFieldController.tsx} (98%)

diff --git a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.stories.tsx
similarity index 97%
rename from packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
rename to packages/ra-core/src/controller/field/useReferenceArrayFieldController.stories.tsx
index cf47a40823e..7ba1135f5df 100644
--- a/packages/ra-core/src/controller/field/ReferenceArrayField.stories.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.stories.tsx
@@ -92,5 +92,5 @@ export const Basic = ({ children = ReferenceArrayFieldComponent }) => (
 );
 
 export default {
-    title: 'ra-core/fields/ReferenceArrayField',
+    title: 'ra-core/controller/useReferenceArrayFieldController',
 };
diff --git a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.tsx
similarity index 98%
rename from packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
rename to packages/ra-core/src/controller/field/useReferenceManyFieldController.tsx
index ae31dd29fed..64231d03df5 100644
--- a/packages/ra-core/src/controller/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.tsx
@@ -107,6 +107,6 @@ export const Basic = ({
 );
 
 export default {
-    title: 'ra-core/fields/ReferenceManyField',
+    title: 'ra-core/controller/useReferenceManyFieldController',
     excludeStories: ['defaultDataProvider'],
 };

From 315b9a936223f04dd057e93b61a56fe290ac2877 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 16:09:13 +0100
Subject: [PATCH 136/146] add `target` and `id` to the queryKey

---
 .../controller/field/useReferenceManyFieldController.ts    | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 79f2ea7731e..992c622eeae 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -214,6 +214,8 @@ export const useReferenceManyFieldController = <
                         resource,
                         'getManyReference',
                         {
+                            target,
+                            id: get(record, source) as Identifier,
                             pagination: { page: 1, perPage: limit },
                             sort,
                             filter,
@@ -224,10 +226,7 @@ export const useReferenceManyFieldController = <
                         dataProvider.getManyReference(reference, {
                             target,
                             id: get(record, source) as Identifier,
-                            pagination: {
-                                page: 1,
-                                perPage: limit,
-                            },
+                            pagination: { page: 1, perPage: limit },
                             sort,
                             filter,
                             meta,

From 6aac66158b8d4fac9ab5f1c60200a63baf74f83d Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 16:18:13 +0100
Subject: [PATCH 137/146] test the right spot for useSelectAll

---
 packages/ra-core/src/controller/list/useSelectAll.spec.tsx | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/ra-core/src/controller/list/useSelectAll.spec.tsx b/packages/ra-core/src/controller/list/useSelectAll.spec.tsx
index 2ffbfe88af6..08c6a5d4209 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.spec.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.spec.tsx
@@ -14,7 +14,9 @@ describe('useSelectAll', () => {
         await screen.findByText('Selected ids: []');
         fireEvent.click(screen.getByText('Select All'));
         await waitFor(() => {
-            expect(screen.queryByText('Selected ids: []')).not.toBeNull();
+            expect(
+                screen.queryByText('Selected ids: [1,2,3,4,5,6,7]')
+            ).not.toBeNull();
         });
     });
 

From d8c099295b77e3e1fc61ba5f26c2bf22d83bd3e1 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 16:19:08 +0100
Subject: [PATCH 138/146] use http_error instead of simple_error

---
 .../src/controller/field/useReferenceManyFieldController.ts     | 2 +-
 packages/ra-core/src/controller/list/useSelectAll.tsx           | 2 +-
 packages/ra-core/src/i18n/TranslationMessages.ts                | 1 -
 packages/ra-language-english/src/index.ts                       | 1 -
 packages/ra-language-french/src/index.ts                        | 1 -
 5 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 992c622eeae..68265ec3361 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -251,7 +251,7 @@ export const useReferenceManyFieldController = <
                 if (onError) {
                     onError(error);
                 }
-                notify('ra.notification.simple_error', { type: 'warning' });
+                notify('ra.notification.http_error', { type: 'warning' });
             }
         }
     );
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index 6c268b90c85..b2b9aa58617 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -99,7 +99,7 @@ export const useSelectAll = ({
                 if (onError) {
                     onError(error);
                 }
-                notify('ra.notification.simple_error', { type: 'warning' });
+                notify('ra.notification.http_error', { type: 'warning' });
             }
         }
     );
diff --git a/packages/ra-core/src/i18n/TranslationMessages.ts b/packages/ra-core/src/i18n/TranslationMessages.ts
index 99a1a061f07..1ac87b1b4ed 100644
--- a/packages/ra-core/src/i18n/TranslationMessages.ts
+++ b/packages/ra-core/src/i18n/TranslationMessages.ts
@@ -158,7 +158,6 @@ export interface TranslationMessages extends StringMap {
             deleted: string;
             bad_item: string;
             item_doesnt_exist: string;
-            simple_error: string;
             http_error: string;
             data_provider_error: string;
             i18n_error: string;
diff --git a/packages/ra-language-english/src/index.ts b/packages/ra-language-english/src/index.ts
index d1f4666a566..e9449ea6d38 100644
--- a/packages/ra-language-english/src/index.ts
+++ b/packages/ra-language-english/src/index.ts
@@ -160,7 +160,6 @@ const englishMessages: TranslationMessages = {
             deleted: 'Element deleted |||| %{smart_count} elements deleted',
             bad_item: 'Incorrect element',
             item_doesnt_exist: 'Element does not exist',
-            simple_error: 'An error occurred. Please try again.',
             http_error: 'Server communication error',
             data_provider_error:
                 'dataProvider error. Check the console for details.',
diff --git a/packages/ra-language-french/src/index.ts b/packages/ra-language-french/src/index.ts
index 6e6f8feef10..235f51d9715 100644
--- a/packages/ra-language-french/src/index.ts
+++ b/packages/ra-language-french/src/index.ts
@@ -166,7 +166,6 @@ const frenchMessages: TranslationMessages = {
             deleted: 'Élément supprimé |||| %{smart_count} éléments supprimés',
             bad_item: 'Élément inconnu',
             item_doesnt_exist: "L'élément n'existe pas",
-            simple_error: 'Une erreur est survenue. Veuillez réessayer.',
             http_error: 'Erreur de communication avec le serveur',
             data_provider_error:
                 'Erreur dans le dataProvider. Plus de détails dans la console.',

From b27fe7c450e869b910d12626f9675129879a802d Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 16:20:35 +0100
Subject: [PATCH 139/146] make test more logic

---
 packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
index 06b614f0302..e3cff98ad95 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.spec.tsx
@@ -15,9 +15,7 @@ describe('<SelectAllButton />', () => {
         await screen.findByText('War and Peace');
         fireEvent.click(screen.getAllByRole('checkbox')[0]);
         await screen.findByText('10 items selected');
-        expect(
-            screen.queryByRole('button', { name: 'Select all' })
-        ).not.toBeNull();
+        await screen.findByRole('button', { name: 'Select all' });
         fireEvent.click(screen.getAllByRole('checkbox')[1]);
         await screen.findByText('9 items selected');
         expect(screen.queryByRole('button', { name: 'Select all' })).toBeNull();

From 2f3ed8a324fecce92569f39e20980b92a6e40e59 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 16:25:37 +0100
Subject: [PATCH 140/146] rename tests

---
 .../src/field/ReferenceManyField.spec.tsx            | 12 ++++++------
 packages/ra-ui-materialui/src/list/List.spec.tsx     | 10 +++++-----
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
index dd834ec63cd..2580bccc86c 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.spec.tsx
@@ -275,7 +275,7 @@ describe('<ReferenceManyField />', () => {
     });
 
     describe('"Select all" button', () => {
-        it('should be displayed if an item is selected', async () => {
+        it('should be displayed if all the items of the page are selected', async () => {
             render(<WithPagination />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
@@ -285,7 +285,7 @@ describe('<ReferenceManyField />', () => {
                 await screen.findByRole('button', { name: 'Select all' })
             ).toBeDefined();
         });
-        it('should not be displayed if all item are manyally selected', async () => {
+        it('should not be displayed if all item are manually selected', async () => {
             render(
                 <WithPagination
                     dataProvider={testDataProvider({
@@ -319,7 +319,7 @@ describe('<ReferenceManyField />', () => {
                 screen.queryByRole('button', { name: 'Select all' })
             ).toBeNull();
         });
-        it('should not be displayed if all item are selected with the "Select all" button', async () => {
+        it('should not be displayed if all items are selected with the "Select all" button', async () => {
             render(<WithPagination />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
@@ -332,7 +332,7 @@ describe('<ReferenceManyField />', () => {
                 screen.queryByRole('button', { name: 'Select all' })
             ).toBeNull();
         });
-        it('should not be displayed if we reached de limit by a manyally selection', async () => {
+        it('should not be displayed if we reached the limit by a manual selection', async () => {
             render(
                 <WithPaginationAndSelectAllLimit
                     limit={2}
@@ -374,7 +374,7 @@ describe('<ReferenceManyField />', () => {
                 screen.queryByRole('button', { name: 'Select all' })
             ).toBeNull();
         });
-        it('should not be displayed if we reached de selectAllLimit by a  click on the "Select all" button', async () => {
+        it('should not be displayed if we reached the selectAllLimit by a click on the "Select all" button', async () => {
             render(<WithPaginationAndSelectAllLimit />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
@@ -400,7 +400,7 @@ describe('<ReferenceManyField />', () => {
             fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
             await screen.findByText('7 items selected');
         });
-        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
+        it('should select the maximum items possible until we reach the selectAllLimit', async () => {
             render(<WithPaginationAndSelectAllLimit />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(6);
diff --git a/packages/ra-ui-materialui/src/list/List.spec.tsx b/packages/ra-ui-materialui/src/list/List.spec.tsx
index bc64652d216..a26abdb22a2 100644
--- a/packages/ra-ui-materialui/src/list/List.spec.tsx
+++ b/packages/ra-ui-materialui/src/list/List.spec.tsx
@@ -357,7 +357,7 @@ describe('<List />', () => {
                 await screen.findByRole('button', { name: 'Select all' })
             ).toBeDefined();
         });
-        it('should not be displayed if all item are manually selected', async () => {
+        it('should not be displayed if all items are manually selected', async () => {
             render(
                 <Default
                     dataProvider={testDataProvider({
@@ -391,7 +391,7 @@ describe('<List />', () => {
                 screen.queryByRole('button', { name: 'Select all' })
             ).toBeNull();
         });
-        it('should not be displayed if all item are selected with the "Select all" button', async () => {
+        it('should not be displayed if all items are selected with the "Select all" button', async () => {
             render(<Default />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
@@ -404,7 +404,7 @@ describe('<List />', () => {
                 screen.queryByRole('button', { name: 'Select all' })
             ).toBeNull();
         });
-        it('should not be displayed if we reached the limit by a manual selection', async () => {
+        it('should not be displayed if the user reaches the limit by a manual selection', async () => {
             render(
                 <SelectAllLimit
                     limit={2}
@@ -446,7 +446,7 @@ describe('<List />', () => {
                 screen.queryByRole('button', { name: 'Select all' })
             ).toBeNull();
         });
-        it('should not be displayed if we reached the selectAllLimit by a  click on the "Select all" button', async () => {
+        it('should not be displayed if the user reaches the selectAllLimit by a click on the "Select all" button', async () => {
             render(<SelectAllLimit />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);
@@ -472,7 +472,7 @@ describe('<List />', () => {
             fireEvent.click(screen.getByRole('button', { name: 'Select all' }));
             await screen.findByText('13 items selected');
         });
-        it('should select the maximum items possible until we reached the selectAllLimit', async () => {
+        it('should select the maximum items possible up to the selectAllLimit', async () => {
             render(<SelectAllLimit />);
             await waitFor(() => {
                 expect(screen.queryAllByRole('checkbox')).toHaveLength(11);

From 002f485e78c55bebb09c7297afdda0c76b63addb Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Thu, 2 Jan 2025 17:35:52 +0100
Subject: [PATCH 141/146] fix tests

---
 .../useReferenceArrayFieldController.spec.tsx |  2 +-
 .../useReferenceManyFieldController.spec.tsx  |  5 ++-
 ...eReferenceManyFieldController.stories.tsx} |  0
 .../src/button/SelectAllButton.stories.tsx    | 31 +++++++++----------
 .../src/field/ReferenceManyField.stories.tsx  | 12 +++----
 .../src/list/List.stories.tsx                 | 12 +++----
 6 files changed, 27 insertions(+), 35 deletions(-)
 rename packages/ra-core/src/controller/field/{useReferenceManyFieldController.tsx => useReferenceManyFieldController.stories.tsx} (100%)

diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
index 3e762c2a4c3..4c5ad456722 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.spec.tsx
@@ -5,7 +5,7 @@ import { render, waitFor, screen, fireEvent } from '@testing-library/react';
 import { useReferenceArrayFieldController } from './useReferenceArrayFieldController';
 import { testDataProvider } from '../../dataProvider';
 import { CoreAdminContext } from '../../core';
-import { Basic } from './ReferenceArrayField.stories';
+import { Basic } from './useReferenceArrayFieldController.stories';
 
 const ReferenceArrayFieldController = props => {
     const { children, ...rest } = props;
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
index abaeeb9ddce..b2bf76b60f3 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.spec.tsx
@@ -6,7 +6,10 @@ import { testDataProvider } from '../../dataProvider/testDataProvider';
 import { CoreAdminContext } from '../../core';
 import { useReferenceManyFieldController } from './useReferenceManyFieldController';
 import { memoryStore } from '../../store';
-import { Basic, defaultDataProvider } from './ReferenceManyField.stories';
+import {
+    Basic,
+    defaultDataProvider,
+} from './useReferenceManyFieldController.stories';
 
 const ReferenceManyFieldController = props => {
     const { children, page = 1, perPage = 25, ...rest } = props;
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.stories.tsx
similarity index 100%
rename from packages/ra-core/src/controller/field/useReferenceManyFieldController.tsx
rename to packages/ra-core/src/controller/field/useReferenceManyFieldController.stories.tsx
diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
index af46c41d16c..3ebd20c6d55 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
@@ -7,9 +7,8 @@ import fakeRestDataProvider from 'ra-data-fakerest';
 import { SelectAllButton } from './SelectAllButton';
 import { AdminContext } from '../AdminContext';
 import { AdminUI } from '../AdminUI';
-import { List, Datagrid, BulkActionsToolbar } from '../list';
+import { List, Datagrid } from '../list';
 import { TextField, NumberField } from '../field';
-import { BulkDeleteButton } from './BulkDeleteButton';
 
 export default { title: 'ra-ui-materialui/button/SelectAllButton' };
 
@@ -126,7 +125,7 @@ const dataProvider = fakeRestDataProvider({
     authors: [],
 });
 
-const Wrapper = ({ actions }) => (
+const Wrapper = ({ children }) => (
     <TestMemoryRouter initialEntries={['/books']}>
         <AdminContext dataProvider={dataProvider} i18nProvider={i18nProvider}>
             <AdminUI>
@@ -134,13 +133,7 @@ const Wrapper = ({ actions }) => (
                     name="books"
                     list={() => (
                         <List>
-                            <Datagrid
-                                bulkActionsToolbar={
-                                    <BulkActionsToolbar actions={actions}>
-                                        <BulkDeleteButton />
-                                    </BulkActionsToolbar>
-                                }
-                            >
+                            <Datagrid selectAllButton={children}>
                                 <TextField source="id" />
                                 <TextField source="title" />
                                 <TextField source="author" />
@@ -154,16 +147,20 @@ const Wrapper = ({ actions }) => (
     </TestMemoryRouter>
 );
 
-export const Basic = () => <Wrapper actions={<SelectAllButton />} />;
+export const Basic = () => (
+    <Wrapper>
+        <SelectAllButton />
+    </Wrapper>
+);
 
 export const Label = () => (
-    <Wrapper actions={<SelectAllButton label="Select all books" />} />
+    <Wrapper>
+        <SelectAllButton label="Select all books" />
+    </Wrapper>
 );
 
 export const Limit = () => (
-    <Wrapper
-        actions={
-            <SelectAllButton label="Select all books (max 15)" limit={15} />
-        }
-    />
+    <Wrapper>
+        <SelectAllButton label="Select all books (max 15)" limit={15} />
+    </Wrapper>
 );
diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
index a84b76dcbc7..5c7e6c172ba 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
@@ -190,10 +190,10 @@ export const StoreKey = () => (
 
 export const WithPagination = ({
     dataProvider = fullDataProvider,
-    bulkActionsToolbar,
+    selectAllButton,
 }: {
     dataProvider?: AdminProps['dataProvider'];
-    bulkActionsToolbar?: DatagridProps['bulkActionsToolbar'];
+    selectAllButton?: DatagridProps['selectAllButton'];
 }) => (
     <Wrapper
         i18nProvider={polyglotI18nProvider(() => englishMessages)}
@@ -206,7 +206,7 @@ export const WithPagination = ({
             pagination={<Pagination />}
             perPage={5}
         >
-            <Datagrid bulkActionsToolbar={bulkActionsToolbar}>
+            <Datagrid selectAllButton={selectAllButton}>
                 <TextField source="title" />
             </Datagrid>
         </ReferenceManyField>
@@ -221,11 +221,7 @@ export const WithPaginationAndSelectAllLimit = ({
     limit?: number;
 }) => (
     <WithPagination
-        bulkActionsToolbar={
-            <BulkActionsToolbar actions={<SelectAllButton limit={limit} />}>
-                <BulkDeleteButton />
-            </BulkActionsToolbar>
-        }
+        selectAllButton={<SelectAllButton limit={limit} />}
         dataProvider={dataProvider}
     />
 );
diff --git a/packages/ra-ui-materialui/src/list/List.stories.tsx b/packages/ra-ui-materialui/src/list/List.stories.tsx
index 64630405708..41068725578 100644
--- a/packages/ra-ui-materialui/src/list/List.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/List.stories.tsx
@@ -470,11 +470,11 @@ export const Meta = () => (
 export const Default = ({
     dataProvider = defaultDataProvider,
     children,
-    bulkActionsToolbar,
+    selectAllButton,
 }: {
     dataProvider?: DataProvider;
     children?: React.ReactNode;
-    bulkActionsToolbar?: DatagridProps['bulkActionsToolbar'];
+    selectAllButton?: DatagridProps['selectAllButton'];
 }) => (
     <TestMemoryRouter initialEntries={['/books']}>
         <Admin dataProvider={dataProvider}>
@@ -482,7 +482,7 @@ export const Default = ({
                 name="books"
                 list={() => (
                     <List filters={[<SearchInput source="q" alwaysOn />]}>
-                        <Datagrid bulkActionsToolbar={bulkActionsToolbar}>
+                        <Datagrid selectAllButton={selectAllButton}>
                             <TextField source="id" />
                             <TextField source="title" />
                             <TextField source="author" />
@@ -506,11 +506,7 @@ export const SelectAllLimit = ({
     limit?: number;
 }) => (
     <Default
-        bulkActionsToolbar={
-            <BulkActionsToolbar actions={<SelectAllButton limit={limit} />}>
-                <BulkDeleteButton />
-            </BulkActionsToolbar>
-        }
+        selectAllButton={<SelectAllButton limit={limit} />}
         dataProvider={dataProvider}
     >
         {children}

From 420ab1d374636ec2c4b7f74cf0fc8d89d11cd886 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 3 Jan 2025 10:23:46 +0100
Subject: [PATCH 142/146] update the bulkActionsToolbar implementation

---
 docs/Buttons.md                               | 12 +++++--
 docs/Datagrid.md                              | 33 -----------------
 .../src/list/datagrid/Datagrid.stories.tsx    | 19 ++++++++--
 .../src/list/datagrid/Datagrid.tsx            | 35 +++++++++++--------
 4 files changed, 46 insertions(+), 53 deletions(-)

diff --git a/docs/Buttons.md b/docs/Buttons.md
index d239168fc7c..7f214ca5367 100644
--- a/docs/Buttons.md
+++ b/docs/Buttons.md
@@ -964,7 +964,7 @@ The `<SelectAllButton>` component allows users to select all items from a resour
 
 ## Usage
 
-By default, react-admin's `<Datagrid>` displays a `<SelectAllButton>` in their List view action toolbar. You can custom it by specifying your own [`selectAllButton`](./Datagrid.md#selectallbutton):
+By default, react-admin's `<Datagrid>` displays a `<SelectAllButton>` in their `bulkActionsToolbar`. You can custom it by specifying your own `selectAllButton`:
 
 {% raw %}
 
@@ -980,7 +980,13 @@ const PostSelectAllButton = () => (
 
 export const PostList = () => (
     <List>
-        <Datagrid selectAllButton={<PostSelectAllButton />}>
+        <Datagrid
+            bulkActionsToolbar={
+                <BulkActionsToolbar selectAllButton={PostSelectAllButton}>
+                    <BulkDeleteButton />
+                </BulkActionsToolbar>
+            }
+        >
             ...
         </Datagrid>
     </List>
@@ -1012,9 +1018,11 @@ const PostSelectAllButton = () => <SelectAllButton limit={100} />;
 `<SelectAllButton>` calls a `get` method of your `dataProvider` via a react-query's `useQuery` hook. You can customize the options you pass to this hook, e.g. to pass [a custom `meta`](./Actions.md#meta-parameter) to the call.
 
 {% raw %}
+
 ```jsx
 const PostSelectAllButton = () => <SelectAllButton queryOptions={{ meta: { foo: 'bar' } }} />;
 ```
+
 {% endraw %}
 
 ### `sx`: CSS API
diff --git a/docs/Datagrid.md b/docs/Datagrid.md
index fd495e24456..7e84d85b722 100644
--- a/docs/Datagrid.md
+++ b/docs/Datagrid.md
@@ -61,7 +61,6 @@ Both are [Enterprise Edition](https://react-admin-ee.marmelab.com) components.
 | `rowClick`           | Optional | mixed                   |                       | The action to trigger when the user clicks on a row.          |
 | `rowStyle`           | Optional | Function                |                       | A function that returns the style to apply to a row.          |
 | `rowSx`              | Optional | Function                |                       | A function that returns the sx prop to apply to a row.        |
-| `selectAllButton`    | Optional | Element or  `false`     |                       | The button used to select all records.                        |
 | `size`               | Optional | `'small'` or `'medium'` | `'small'`             | The size of the table.                                        |
 | `sx`                 | Optional | Object                  |                       | The sx prop passed down to the Material UI `<Table>` element. |
 
@@ -374,38 +373,6 @@ const CustomResetViewsButton = () => {
 };
 ```
 
-## `selectAllButton`
-
-You can use the `selectAllButton` prop to customize the default [`<SelectAllButton>`](./Buttons.md#selectallbutton) displayed in the bulk action toolbar when at least one row is selected.
-
-```tsx
-import { List, Datagrid, SelectAllButton } from 'react-admin';
-
-const PostSelectAllButton = () => <SelectAllButton label="Select all records" />
-
-export const PostList = () => (
-    <List>
-        <Datagrid selectAllButton={<PostSelectAllButton />}>
-            ...
-        </Datagrid>
-    </List>
-);
-```
-
-You disable this feature by setting the `selectAllButton` prop to `false`:
-
-```tsx
-import { Datagrid, List } from 'react-admin';
-
-export const PostList = () => (
-    <List>
-        <Datagrid selectAllButton={false}>
-            ...
-        </Datagrid>
-    </List>
-);
-```
-
 ## `children`
 
 `<Datagrid>` accepts a list of Field components as children. It inspects each child's `source` and/or `label` props to determine the name of the column.
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
index a737a036917..3c02061e1c9 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.stories.tsx
@@ -32,6 +32,7 @@ import { List } from '../List';
 import { EditGuesser } from '../../detail';
 import { DatagridRowProps } from './DatagridRow';
 import DatagridBody, { DatagridBodyProps } from './DatagridBody';
+import { BulkActionsToolbar } from '../BulkActionsToolbar';
 
 export default { title: 'ra-ui-materialui/list/Datagrid' };
 
@@ -205,7 +206,13 @@ export const SelectAllButton = ({
             {(!onlyDisplay || onlyDisplay === 'disabled') && (
                 <>
                     <h1>Disabled</h1>
-                    <Datagrid selectAllButton={false}>
+                    <Datagrid
+                        bulkActionsToolbar={
+                            <BulkActionsToolbar selectAllButton={false}>
+                                <BulkDeleteButton />
+                            </BulkActionsToolbar>
+                        }
+                    >
                         <TextField source="id" />
                         <TextField source="title" />
                         <TextField source="author" />
@@ -217,8 +224,14 @@ export const SelectAllButton = ({
                 <>
                     <h1>Custom</h1>
                     <Datagrid
-                        selectAllButton={
-                            <RaSelectAllButton label="Select all records" />
+                        bulkActionsToolbar={
+                            <BulkActionsToolbar
+                                selectAllButton={
+                                    <RaSelectAllButton label="Select all records" />
+                                }
+                            >
+                                <BulkDeleteButton />
+                            </BulkActionsToolbar>
                         }
                     >
                         <TextField source="id" />
diff --git a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
index 82f4479934d..ea532f1ad43 100644
--- a/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
+++ b/packages/ra-ui-materialui/src/list/datagrid/Datagrid.tsx
@@ -33,7 +33,6 @@ import { RowClickFunction } from '../types';
 import DatagridContextProvider from './DatagridContextProvider';
 import { DatagridClasses, DatagridRoot } from './useDatagridStyles';
 import { BulkActionsToolbar } from '../BulkActionsToolbar';
-import type { BulkActionsToolbarProps } from '../BulkActionsToolbar';
 import { BulkDeleteButton } from '../../button';
 import { ListNoResults } from '../ListNoResults';
 
@@ -45,7 +44,7 @@ const defaultBulkActionButtons = <BulkDeleteButton />;
  *
  * Props:
  *  - body
- *  - selectAllButton
+ *  - bulkActionToolbar
  *  - bulkActionButtons
  *  - children
  *  - empty
@@ -134,7 +133,7 @@ export const Datagrid: React.ForwardRefExoticComponent<
         className,
         empty = DefaultEmpty,
         expand,
-        selectAllButton,
+        bulkActionsToolbar,
         bulkActionButtons = canDelete ? defaultBulkActionButtons : false,
         hover,
         isRowSelectable,
@@ -247,13 +246,14 @@ export const Datagrid: React.ForwardRefExoticComponent<
                     sx={sx}
                     className={clsx(DatagridClasses.root, className)}
                 >
-                    {bulkActionButtons !== false ? (
-                        <BulkActionsToolbar selectAllButton={selectAllButton}>
-                            {isValidElement(bulkActionButtons)
-                                ? bulkActionButtons
-                                : defaultBulkActionButtons}
-                        </BulkActionsToolbar>
-                    ) : null}
+                    {bulkActionsToolbar ??
+                        (bulkActionButtons !== false ? (
+                            <BulkActionsToolbar>
+                                {isValidElement(bulkActionButtons)
+                                    ? bulkActionButtons
+                                    : defaultBulkActionButtons}
+                            </BulkActionsToolbar>
+                        ) : null)}
                     <div className={DatagridClasses.tableWrapper}>
                         <Table
                             ref={ref}
@@ -321,21 +321,26 @@ export interface DatagridProps<RecordType extends RaRecord = any>
     className?: string;
 
     /**
-     * The button used to select all records.
+     * The component used to render the bulk actions toolbar.
      *
-     * @see https://marmelab.com/react-admin/Datagrid.html#selectallbutton
      * @example
-     * import { List, Datagrid, SelectAllButton } from 'react-admin';
+     * import { List, Datagrid, BulkActionsToolbar, SelectAllButton, BulkDeleteButton } from 'react-admin';
+     *
+     * const PostBulkActionsToolbar = () => (
+     *     <BulkActionsToolbar selectAllButton={<SelectAllButton label="Select all records" />}>
+     *         <BulkDeleteButton />
+     *     </BulkActionsToolbar>
+     * );
      *
      * export const PostList = () => (
      *     <List>
-     *         <Datagrid selectAllButton={<SelectAllButton label="Select all records" />}>
+     *         <Datagrid bulkActionsToolbar={<PostBulkActionsToolbar />}>
      *             ...
      *         </Datagrid>
      *     </List>
      * );
      */
-    selectAllButton?: BulkActionsToolbarProps['selectAllButton'];
+    bulkActionsToolbar?: ReactElement;
 
     /**
      * The component used to render the bulk action buttons. Defaults to <BulkDeleteButton>.

From 68fe92cc9ea42795b637bb19bede674235fb9408 Mon Sep 17 00:00:00 2001
From: erwanMarmelab <erwan@marmelab.com>
Date: Fri, 3 Jan 2025 10:46:45 +0100
Subject: [PATCH 143/146] adapt stories with the last implem to fix stories

---
 .../src/button/SelectAllButton.stories.tsx         | 13 +++++++++++--
 .../src/field/ReferenceManyField.stories.tsx       | 10 ++++++++--
 .../ra-ui-materialui/src/list/List.stories.tsx     | 14 +++++++++++---
 3 files changed, 30 insertions(+), 7 deletions(-)

diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
index 3ebd20c6d55..0adbda669fa 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.stories.tsx
@@ -7,8 +7,9 @@ import fakeRestDataProvider from 'ra-data-fakerest';
 import { SelectAllButton } from './SelectAllButton';
 import { AdminContext } from '../AdminContext';
 import { AdminUI } from '../AdminUI';
-import { List, Datagrid } from '../list';
+import { List, Datagrid, BulkActionsToolbar } from '../list';
 import { TextField, NumberField } from '../field';
+import { BulkDeleteButton } from './BulkDeleteButton';
 
 export default { title: 'ra-ui-materialui/button/SelectAllButton' };
 
@@ -133,7 +134,15 @@ const Wrapper = ({ children }) => (
                     name="books"
                     list={() => (
                         <List>
-                            <Datagrid selectAllButton={children}>
+                            <Datagrid
+                                bulkActionsToolbar={
+                                    <BulkActionsToolbar
+                                        selectAllButton={children}
+                                    >
+                                        <BulkDeleteButton />
+                                    </BulkActionsToolbar>
+                                }
+                            >
                                 <TextField source="id" />
                                 <TextField source="title" />
                                 <TextField source="author" />
diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
index 5c7e6c172ba..8189c82ce90 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
@@ -193,7 +193,7 @@ export const WithPagination = ({
     selectAllButton,
 }: {
     dataProvider?: AdminProps['dataProvider'];
-    selectAllButton?: DatagridProps['selectAllButton'];
+    selectAllButton?: React.ReactElement;
 }) => (
     <Wrapper
         i18nProvider={polyglotI18nProvider(() => englishMessages)}
@@ -206,7 +206,13 @@ export const WithPagination = ({
             pagination={<Pagination />}
             perPage={5}
         >
-            <Datagrid selectAllButton={selectAllButton}>
+            <Datagrid
+                bulkActionsToolbar={
+                    <BulkActionsToolbar selectAllButton={selectAllButton}>
+                        <BulkDeleteButton />
+                    </BulkActionsToolbar>
+                }
+            >
                 <TextField source="title" />
             </Datagrid>
         </ReferenceManyField>
diff --git a/packages/ra-ui-materialui/src/list/List.stories.tsx b/packages/ra-ui-materialui/src/list/List.stories.tsx
index 41068725578..31f3bed3cde 100644
--- a/packages/ra-ui-materialui/src/list/List.stories.tsx
+++ b/packages/ra-ui-materialui/src/list/List.stories.tsx
@@ -13,7 +13,7 @@ import { Box, Card, Typography, Button, Link as MuiLink } from '@mui/material';
 import { List } from './List';
 import { SimpleList } from './SimpleList';
 import { ListActions } from './ListActions';
-import { Datagrid, DatagridProps } from './datagrid';
+import { Datagrid } from './datagrid';
 import { TextField } from '../field';
 import { SearchInput, TextInput } from '../input';
 import { Route } from 'react-router';
@@ -474,7 +474,7 @@ export const Default = ({
 }: {
     dataProvider?: DataProvider;
     children?: React.ReactNode;
-    selectAllButton?: DatagridProps['selectAllButton'];
+    selectAllButton?: React.ReactElement;
 }) => (
     <TestMemoryRouter initialEntries={['/books']}>
         <Admin dataProvider={dataProvider}>
@@ -482,7 +482,15 @@ export const Default = ({
                 name="books"
                 list={() => (
                     <List filters={[<SearchInput source="q" alwaysOn />]}>
-                        <Datagrid selectAllButton={selectAllButton}>
+                        <Datagrid
+                            bulkActionsToolbar={
+                                <BulkActionsToolbar
+                                    selectAllButton={selectAllButton}
+                                >
+                                    <BulkDeleteButton />
+                                </BulkActionsToolbar>
+                            }
+                        >
                             <TextField source="id" />
                             <TextField source="title" />
                             <TextField source="author" />

From 2ebbcadcaf6bb5ee3d528dd69916db215a8e80c5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fran=C3=A7ois=20Zaninotto?= <fzaninotto@gmail.com>
Date: Fri, 3 Jan 2025 13:07:52 +0100
Subject: [PATCH 144/146] Misc adjustments

---
 docs/Buttons.md                               | 116 +++++++++---------
 ...eReferenceArrayFieldController.stories.tsx |   7 +-
 ...seReferenceManyFieldController.stories.tsx |   7 +-
 .../src/controller/list/useList.stories.tsx   |  25 ++--
 .../list/useListController.stories.tsx        |   4 +-
 .../src/controller/list/useSelectAll.tsx      |  35 ++++--
 .../src/button/SelectAllButton.tsx            |  28 +++--
 .../src/field/ReferenceManyField.stories.tsx  |   1 -
 .../src/list/BulkActionsToolbar.tsx           |   2 +-
 9 files changed, 129 insertions(+), 96 deletions(-)

diff --git a/docs/Buttons.md b/docs/Buttons.md
index 7f214ca5367..cd07abcfa27 100644
--- a/docs/Buttons.md
+++ b/docs/Buttons.md
@@ -956,20 +956,75 @@ This button is an internal component used by react-admin in [the Filter button/f
 
 To override the style of all instances of `<FilterButton>` using the [application-wide style overrides](./AppTheme.md#theming-individual-components), use the `RaFilterButton` key.
 
+## `<ListButton>`
+
+Opens the List view of a given resource.
+
+![List button](./img/list-button.png)
+
+`<ListButton>` is based on react-admin's base `<Button>`, so it's responsive, accessible, and the label is translatable.
+
+### Usage
+
+By default, react-admin doesn't display a `<ListButton>` in Edit and Show views action toolbar. This saves visual clutter, and users can always use the back button.
+
+You can add it by specifying your own `actions`:
+
+```jsx
+// linking back to the list from the Show view
+import { TopToolbar, ListButton, Show } from 'react-admin';
+
+const PostShowActions = () => (
+    <TopToolbar>
+        <ListButton />
+    </TopToolbar>
+);
+
+export const PostShow = () => (
+    <Show actions={<PostShowActions />}>
+        ...
+    </Show>
+);
+```
+
+**Tip**: If you want to link to the List view manually, use the `/{resource}` location.
+
+### Props
+
+| Prop       | Required | Type            | Default          | Description                                  |
+| ---------- | -------- | --------------- | ---------------- | -------------------------------------------- |
+| `resource` | Optional | `string`        | -                | target resource, e.g. 'posts'                |
+| `label`    | Optional | `string`        | 'ra.action.list' | label or translation message to use          |
+| `icon`     | Optional | `ReactElement`  | -                | iconElement, e.g. `<CommentIcon />`          |
+
+It also supports [all the other `<Button>` props](#button).
+
+### Access Control
+
+If your `authProvider` implements [Access Control](./Permissions.md#access-control), `<ListButton>` will only render if the user has the "list" access to the related resource.
+
+`<ListButton>` will call `authProvider.canAccess()` using the following parameters:
+
+```txt
+{ action: "list", resource: [current resource] }
+```
+
+## `<RefreshButton>`
+
 ## `<SelectAllButton>`
 
 The `<SelectAllButton>` component allows users to select all items from a resource, no matter the pagination.
 
 ![SelectAllButton](./img/SelectAllButton.png)
 
-## Usage
+### Usage
 
-By default, react-admin's `<Datagrid>` displays a `<SelectAllButton>` in their `bulkActionsToolbar`. You can custom it by specifying your own `selectAllButton`:
+By default, react-admin's `<Datagrid>` displays a `<SelectAllButton>` in its `bulkActionsToolbar`. You can customize it by specifying your own `<BulkActionsToolbar selectAllButton>`:
 
 {% raw %}
 
 ```jsx
-import { List, Datagrid, SelectAllButton } from 'react-admin';
+import { List, Datagrid, BulkActionsToolbar, SelectAllButton, BulkDeleteButton } from 'react-admin';
 
 const PostSelectAllButton = () => (
     <SelectAllButton 
@@ -1029,61 +1084,6 @@ const PostSelectAllButton = () => <SelectAllButton queryOptions={{ meta: { foo:
 
 To override the style of all instances of `<SelectAllButton>` components using the [application-wide style overrides](./AppTheme.md#theming-individual-components), use the `RaSelectAllButton` key.
 
-## `<ListButton>`
-
-Opens the List view of a given resource.
-
-![List button](./img/list-button.png)
-
-`<ListButton>` is based on react-admin's base `<Button>`, so it's responsive, accessible, and the label is translatable.
-
-### Usage
-
-By default, react-admin doesn't display a `<ListButton>` in Edit and Show views action toolbar. This saves visual clutter, and users can always use the back button.
-
-You can add it by specifying your own `actions`:
-
-```jsx
-// linking back to the list from the Show view
-import { TopToolbar, ListButton, Show } from 'react-admin';
-
-const PostShowActions = () => (
-    <TopToolbar>
-        <ListButton />
-    </TopToolbar>
-);
-
-export const PostShow = () => (
-    <Show actions={<PostShowActions />}>
-        ...
-    </Show>
-);
-```
-
-**Tip**: If you want to link to the List view manually, use the `/{resource}` location.
-
-### Props
-
-| Prop       | Required | Type            | Default          | Description                                  |
-| ---------- | -------- | --------------- | ---------------- | -------------------------------------------- |
-| `resource` | Optional | `string`        | -                | target resource, e.g. 'posts'                |
-| `label`    | Optional | `string`        | 'ra.action.list' | label or translation message to use          |
-| `icon`     | Optional | `ReactElement`  | -                | iconElement, e.g. `<CommentIcon />`          |
-
-It also supports [all the other `<Button>` props](#button).
-
-### Access Control
-
-If your `authProvider` implements [Access Control](./Permissions.md#access-control), `<ListButton>` will only render if the user has the "list" access to the related resource.
-
-`<ListButton>` will call `authProvider.canAccess()` using the following parameters:
-
-```txt
-{ action: "list", resource: [current resource] }
-```
-
-## `<RefreshButton>`
-
 ## `<SkipNavigationButton>`
 
 ### `sx`: CSS API
diff --git a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.stories.tsx b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.stories.tsx
index 7ba1135f5df..7b0f1e138c2 100644
--- a/packages/ra-core/src/controller/field/useReferenceArrayFieldController.stories.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceArrayFieldController.stories.tsx
@@ -17,6 +17,9 @@ const dataProvider = testDataProvider({
         }),
 });
 
+/**
+ * Render prop version of the controller hook
+ */
 const ReferenceArrayFieldController = props => {
     const { children, ...rest } = props;
     const controllerProps = useReferenceArrayFieldController({
@@ -29,7 +32,7 @@ const ReferenceArrayFieldController = props => {
     return children(controllerProps);
 };
 
-const ReferenceArrayFieldComponent = (props: ListControllerResult) => (
+const defaultRenderProp = (props: ListControllerResult) => (
     <div>
         <div
             style={{
@@ -78,7 +81,7 @@ const ReferenceArrayFieldComponent = (props: ListControllerResult) => (
     </div>
 );
 
-export const Basic = ({ children = ReferenceArrayFieldComponent }) => (
+export const Basic = ({ children = defaultRenderProp }) => (
     <CoreAdminContext dataProvider={dataProvider}>
         <ReferenceArrayFieldController
             resource="foo"
diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.stories.tsx b/packages/ra-core/src/controller/field/useReferenceManyFieldController.stories.tsx
index 64231d03df5..8ede132ed73 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.stories.tsx
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.stories.tsx
@@ -19,6 +19,9 @@ export const defaultDataProvider = testDataProvider({
         }),
 });
 
+/**
+ * Render prop version of the controller hook
+ */
 const ReferenceManyFieldController = props => {
     const { children, ...rest } = props;
     const controllerProps = useReferenceManyFieldController({
@@ -31,7 +34,7 @@ const ReferenceManyFieldController = props => {
     return children(controllerProps);
 };
 
-const ReferenceManyFieldComponent = (props: ListControllerResult) => (
+const defaultRenderProp = (props: ListControllerResult) => (
     <div>
         <div
             style={{
@@ -87,7 +90,7 @@ const ReferenceManyFieldComponent = (props: ListControllerResult) => (
 );
 
 export const Basic = ({
-    children = ReferenceManyFieldComponent,
+    children = defaultRenderProp,
     dataProvider = defaultDataProvider,
 }: {
     children?: (props: ListControllerResult) => React.ReactNode;
diff --git a/packages/ra-core/src/controller/list/useList.stories.tsx b/packages/ra-core/src/controller/list/useList.stories.tsx
index 37b0981ce1d..aa02c721473 100644
--- a/packages/ra-core/src/controller/list/useList.stories.tsx
+++ b/packages/ra-core/src/controller/list/useList.stories.tsx
@@ -89,22 +89,31 @@ const SortButton = () => {
         <div style={{ display: 'flex', gap: '10px', margin: '10px' }}>
             <button
                 onClick={() =>
-                    listContext.sort.order === 'DESC'
-                        ? listContext.setSort({ field: 'title', order: 'ASC' })
-                        : listContext.setSort({ field: 'title', order: 'DESC' })
+                    listContext.sort.field === 'id' &&
+                    listContext.sort.order === 'ASC'
+                        ? listContext.setSort({ field: 'id', order: 'DESC' })
+                        : listContext.setSort({ field: 'id', order: 'ASC' })
                 }
             >
-                Sort by id {listContext.sort.order === 'DESC' ? 'ASC' : 'DESC'}
+                Sort by id{' '}
+                {listContext.sort.field === 'id' &&
+                listContext.sort.order === 'ASC'
+                    ? 'DESC'
+                    : 'ASC'}
             </button>
             <button
                 onClick={() =>
-                    listContext.sort.order === 'DESC'
-                        ? listContext.setSort({ field: 'title', order: 'ASC' })
-                        : listContext.setSort({ field: 'title', order: 'DESC' })
+                    listContext.sort.field === 'title' &&
+                    listContext.sort.order === 'ASC'
+                        ? listContext.setSort({ field: 'title', order: 'DESC' })
+                        : listContext.setSort({ field: 'title', order: 'ASC' })
                 }
             >
                 Sort by title{' '}
-                {listContext.sort.order === 'DESC' ? 'ASC' : 'DESC'}
+                {listContext.sort.field === 'title' &&
+                listContext.sort.order === 'ASC'
+                    ? 'DESC'
+                    : 'ASC'}
             </button>
         </div>
     );
diff --git a/packages/ra-core/src/controller/list/useListController.stories.tsx b/packages/ra-core/src/controller/list/useListController.stories.tsx
index 2684fe1e9f1..65a450f0691 100644
--- a/packages/ra-core/src/controller/list/useListController.stories.tsx
+++ b/packages/ra-core/src/controller/list/useListController.stories.tsx
@@ -26,7 +26,7 @@ export const defaultDataProvider = fakeDataProvider(
     process.env.NODE_ENV === 'development'
 );
 
-const ListView = params => (
+const defaultRender = params => (
     <div>
         <div
             style={{
@@ -88,7 +88,7 @@ const ListView = params => (
 
 export const Basic = ({
     dataProvider = defaultDataProvider,
-    children = ListView,
+    children = defaultRender,
 }: {
     dataProvider?: DataProvider;
     children?: (params: ListControllerResult) => JSX.Element;
diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index b2b9aa58617..ae147cd38dd 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -3,15 +3,14 @@ import { useQueryClient } from '@tanstack/react-query';
 import { useNotify } from '../../notification';
 import { useDataProvider, UseGetListOptions } from '../../dataProvider';
 import { useRecordSelection } from './useRecordSelection';
+import { useResourceContext } from '../../core';
 import { useEvent } from '../../util';
 import type { FilterPayload, RaRecord, SortPayload } from '../../types';
 
 /**
- * Select all records of a resource (capped by the limit prop)
+ * Get a callback to select all records of a resource (capped by the limit parameter)
  *
- * @param {string} resource Required. The resource name
- * @param {SortPayload} sort Optional. The sort object passed to the dataProvider
- * @param {FilterPayload} filter Optional. The filter object passed to the dataProvider
+ * @param {Object} params The hook parameters { resource, sort, filter }
  * @returns {Function} handleSelectAll A function to select all items of a list
  *
  * @example
@@ -41,11 +40,16 @@ import type { FilterPayload, RaRecord, SortPayload } from '../../types';
  *     </List>
  * );
  */
-export const useSelectAll = ({
-    resource,
-    sort,
-    filter,
-}: useSelectAllProps): ((options?: handleSelectAllParams) => void) => {
+export const useSelectAll = (
+    params: UseSelectAllParams
+): UseSelectAllResult => {
+    const { sort, filter } = params;
+    const resource = useResourceContext(params);
+    if (!resource) {
+        throw new Error(
+            'useSelectAll should be used inside a ResourceContextProvider or passed a resource prop'
+        );
+    }
     const dataProvider = useDataProvider();
     const queryClient = useQueryClient();
     const [, { select }] = useRecordSelection({ resource });
@@ -56,7 +60,8 @@ export const useSelectAll = ({
             queryOptions = {},
             limit = 250,
         }: handleSelectAllParams = {}) => {
-            const { meta, onSuccess, onError } = queryOptions;
+            const { meta, onSuccess, onError, ...otherQueryOptions } =
+                queryOptions;
             try {
                 const results = await queryClient.fetchQuery({
                     queryKey: [
@@ -79,6 +84,7 @@ export const useSelectAll = ({
                             filter,
                             meta,
                         }),
+                    ...otherQueryOptions,
                 });
 
                 const allIds = results.data?.map(({ id }) => id) || [];
@@ -98,16 +104,17 @@ export const useSelectAll = ({
             } catch (error) {
                 if (onError) {
                     onError(error);
+                } else {
+                    notify('ra.notification.http_error', { type: 'warning' });
                 }
-                notify('ra.notification.http_error', { type: 'warning' });
             }
         }
     );
     return handleSelectAll;
 };
 
-export interface useSelectAllProps {
-    resource: string;
+export interface UseSelectAllParams {
+    resource?: string;
     sort?: SortPayload;
     filter?: FilterPayload;
 }
@@ -116,3 +123,5 @@ export interface handleSelectAllParams<RecordType extends RaRecord = any> {
     limit?: number;
     queryOptions?: UseGetListOptions<RecordType>;
 }
+
+export type UseSelectAllResult = (options?: handleSelectAllParams) => void;
diff --git a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
index 7045ed5ae53..e461b07e84d 100644
--- a/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
+++ b/packages/ra-ui-materialui/src/button/SelectAllButton.tsx
@@ -24,19 +24,29 @@ import { Button, ButtonProps } from './Button';
  *
  * @example
  *
- * import { SelectAllButton, List, Datagrid } from 'react-admin';
+ * import { List, Datagrid, BulkActionsToolbar, SelectAllButton, BulkDeleteButton } from 'react-admin';
  *
- * const MySelectAllButton = () => <SelectAllButton limit={100} label="Select all books" />;
+ * const PostSelectAllButton = () => (
+ *     <SelectAllButton
+ *         label="Select all records"
+ *         queryOptions={{ meta: { foo: 'bar' } }}
+ *     />
+ * );
  *
- * const PostList = () => (
- *    <List>
- *       <Datagrid selectAllButton={<MySelectAllButton />}>
- *          // ...
- *      </Datagrid>
- *   </List>
+ * export const PostList = () => (
+ *     <List>
+ *         <Datagrid
+ *             bulkActionsToolbar={
+ *                 <BulkActionsToolbar selectAllButton={PostSelectAllButton}>
+ *                     <BulkDeleteButton />
+ *                 </BulkActionsToolbar>
+ *             }
+ *         >
+ *             ...
+ *         </Datagrid>
+ *     </List>
  * );
  */
-
 export const SelectAllButton = (props: SelectAllButtonProps) => {
     const {
         label = 'ra.action.select_all_button',
diff --git a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
index 8189c82ce90..bb681d601a9 100644
--- a/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
+++ b/packages/ra-ui-materialui/src/field/ReferenceManyField.stories.tsx
@@ -24,7 +24,6 @@ import { TextInput } from '../input';
 import { Edit } from '../detail';
 import { SimpleForm } from '../form';
 import { SelectAllButton, BulkDeleteButton } from '../button';
-import type { DatagridProps } from '../list/datagrid/Datagrid';
 
 export default { title: 'ra-ui-materialui/fields/ReferenceManyField' };
 
diff --git a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
index c673a48968d..26e39f01da1 100644
--- a/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
+++ b/packages/ra-ui-materialui/src/list/BulkActionsToolbar.tsx
@@ -19,7 +19,7 @@ export const BulkActionsToolbar = (props: BulkActionsToolbarProps) => {
         label = 'ra.action.bulk_actions',
         children,
         className,
-        selectAllButton = defaultSelectAllButton,
+        selectAllButton,
         ...rest
     } = props;
     const { selectedIds = [], onUnselectItems } = useListContext();

From b4c0f8dc2a64b7e06fbca3b945c6cdf7dbd3e444 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fran=C3=A7ois=20Zaninotto?= <fzaninotto@gmail.com>
Date: Fri, 3 Jan 2025 13:12:37 +0100
Subject: [PATCH 145/146] Capitalize type name

---
 packages/ra-core/src/controller/list/useSelectAll.tsx | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/ra-core/src/controller/list/useSelectAll.tsx b/packages/ra-core/src/controller/list/useSelectAll.tsx
index ae147cd38dd..4e5e57646e5 100644
--- a/packages/ra-core/src/controller/list/useSelectAll.tsx
+++ b/packages/ra-core/src/controller/list/useSelectAll.tsx
@@ -59,7 +59,7 @@ export const useSelectAll = (
         async ({
             queryOptions = {},
             limit = 250,
-        }: handleSelectAllParams = {}) => {
+        }: HandleSelectAllParams = {}) => {
             const { meta, onSuccess, onError, ...otherQueryOptions } =
                 queryOptions;
             try {
@@ -119,9 +119,9 @@ export interface UseSelectAllParams {
     filter?: FilterPayload;
 }
 
-export interface handleSelectAllParams<RecordType extends RaRecord = any> {
+export interface HandleSelectAllParams<RecordType extends RaRecord = any> {
     limit?: number;
     queryOptions?: UseGetListOptions<RecordType>;
 }
 
-export type UseSelectAllResult = (options?: handleSelectAllParams) => void;
+export type UseSelectAllResult = (options?: HandleSelectAllParams) => void;

From 31b3bd5366a31d1b58e537009397304254851a7f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fran=C3=A7ois=20Zaninotto?= <fzaninotto@gmail.com>
Date: Fri, 3 Jan 2025 13:16:30 +0100
Subject: [PATCH 146/146] Fix TS compilation error

---
 .../src/controller/field/useReferenceManyFieldController.ts   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
index 68265ec3361..422f387ae04 100644
--- a/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
+++ b/packages/ra-core/src/controller/field/useReferenceManyFieldController.ts
@@ -8,7 +8,7 @@ import { removeEmpty, useEvent } from '../../util';
 import { useDataProvider, useGetManyReference } from '../../dataProvider';
 import { useNotify } from '../../notification';
 import { FilterPayload, Identifier, RaRecord, SortPayload } from '../../types';
-import type { ListControllerResult, handleSelectAllParams } from '../list';
+import type { ListControllerResult, HandleSelectAllParams } from '../list';
 import usePaginationState from '../usePaginationState';
 import { useRecordSelection } from '../list/useRecordSelection';
 import useSortState from '../useSortState';
@@ -206,7 +206,7 @@ export const useReferenceManyFieldController = <
         async ({
             limit = 250,
             queryOptions = {},
-        }: handleSelectAllParams = {}) => {
+        }: HandleSelectAllParams = {}) => {
             const { meta, onSuccess, onError } = queryOptions;
             try {
                 const results = await queryClient.fetchQuery({