@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.5

package/dist/esm/components/resources/ResourceLayout_List.js

@@ -11,8 +11,8 @@ import { useResourceOperationSurface } from '../../core/resources/useResourceOpe
 import { Button } from '../../components/actions/button.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
 import { CoreResourceOperation, ResourcesConfig_OperationPathUtils, ResourceOperationDisplayMode, ErrorCustomMessageReference, DataMode, } from '@wildo-ai/saas-models';
-import { CollectionDisplayMode, CardLayoutStyle, ActionVisibility, isOperationHeadless, isCollectionScopedOperation, } from '../../core/resources/resources.frontend.schemas.js';
-import { isGeneratedCollectionExportOperation } from '../../core/resources/operation-semantics.frontend.utils.js';
+import { CollectionDisplayMode, CardLayoutStyle, ActionVisibility, isOperationHeadless, } from '../../core/resources/resources.frontend.schemas.js';
+import { isCollectionScopedResourceOperation } from '../../core/resources/operation-semantics.frontend.utils.js';
 import { StandardIconReference, IconSize } from '../../core/icons/icon-registry.frontend.schemas.js';
 import { ResourceLayout_Header } from '../../components/resources/ResourceLayout_Header.js';
 import { ResourceListItemRenderer } from '../../components/resources/ResourceListItemRenderer.js';
@@ -22,6 +22,7 @@ import { ResourceLayoutUtils } from '../../components/resources/resourceLayout.u
 import { ResourceLayout_Pagination } from '../../components/resources/ResourceLayout_Pagination.js';
 import { useSearchParams } from 'react-router-dom';
 import { extractErrorInfo } from '../../core/errors/errors.frontend.schemas.js';
+import { useUserFacingErrorMessage } from '../../core/errors/useUserFacingErrorMessage.js';
 import { useUI } from '../../core/ui/useUI.js';
 import { UIBehavior, InteractiveVariant } from '@wildo-ai/presets-components-models';
 import { ResourceEmptyState } from '../../components/feedback/resource-empty-state.js';
@@ -32,7 +33,8 @@ import { ResourceLayout_OperationBulk } from '../../components/resources/Resourc
 import { ResourceLayout_CollectionActions } from '../../components/resources/ResourceLayout_CollectionActions.js';
 import { useResourceSelection } from '../../core/resources/useResourceSelection.js';
 import { useViewMode } from '../../components/resources/collection-view-mode.frontend.js';
-import { resolveCardsContainerClass, resolveCardsGridStyle, CARDS_GRID_CELL_CLASS } from '../../components/resources/collection-card-layout.utils.js';
+import { resolveCardsContainerClass, resolveCardsGridStyle, CARDS_SELECTION_RAIL_CLASS, CARDS_GRID_CELL_CLASS } from '../../components/resources/collection-card-layout.utils.js';
+import { CollectionSelectionHeaderRail } from '../../components/resources/CollectionSelectionHeaderRail.js';
 import { cn } from '../../core/ui/cn.js';
 import { ResourceLayout_InsertedViews, } from '../../components/resources/ResourceLayout_InsertedViews.js';
 import { createComponentResolver } from '../../core/components-registry/component-resolver.frontend.helper.js';
@@ -52,6 +54,8 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
         navigationInitiator,
     });
     const { tResourceHeader, tResourceFieldDisplay, tResourceFieldEnumValue, tResourceOperation, tComponent, formatDate, isReady } = useI18n({ component: FrontendComponentType.RESOURCES_LAYOUTS_LIST, resource: resourceType });
+    // Stable identity, so the fetch effect may call it without listing it.
+    const toUserFacingErrorMessage = useUserFacingErrorMessage();
     const { renderIcon } = useIconRegistry();
     const { registry, doOperation } = useResourceRegistry();
     const [searchParams] = useSearchParams();
@@ -77,6 +81,7 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
     // same `collectionDisplayConfig` (pure frontend presentation; the tabs write
     // into the standard filter state, the grouping is applied to the fetched page).
     const quickFilterFieldName = collectionDisplayConfig?.quickFilterField;
+    const presetFilters = collectionDisplayConfig?.presetFilters;
     const temporalGroupField = collectionDisplayConfig?.temporalGroupField;
     const enumGroupField = collectionDisplayConfig?.enumGroupField;
     // CARDS arrangement (list vs N-column grid) + per-card action placement +
@@ -179,7 +184,29 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
         // (Row-click READ follows the same posture in
         // `resolveReadOperationForIdentifiers`: addressable preferred, EMBEDDED
         // fallback, headless never.)
-        const createOp = resolvePreferredOperation(CoreResourceOperation.CREATE);
+        /*
+         * The LITERAL create, never one that borrows CREATE through `resourceOperationLike`.
+         *
+         * Semantic matching is right almost everywhere and wrong here, because THIS caller supplies the
+         * words: `createLabel` above is `tResourceOperation(resourceType, CoreResourceOperation.CREATE,
+         * 'title')`, hard-wired to the literal verb. So a borrowed create is not a risk of being
+         * mislabelled — it is mislabelled by construction, and the mismatch grows with how unlike a
+         * create the borrower is.
+         *
+         * Measured on `AUDIT_LOGS` (2026-09-20). Its literal CREATE is `REPOSITORY_ONLY` — audit rows
+         * are written by the service and by nothing else — so the frontend registry strips it, and the
+         * only CREATE-semantic operation left was `exportAuditLogs`, which borrows CREATE purely to get
+         * a collection POST route with no `auditLogId` in it. The audit trail therefore offered a
+         * primary "+ Create Audit Log" call to action, wired to an export. A reader had every reason to
+         * believe the product let them forge an audit entry; what it actually had was a mislabelled
+         * download.
+         *
+         * A borrowed create keeps its own action button, with its own label, through the ordinary
+         * action bar. What it no longer does is impersonate the resource's create affordance.
+         */
+        const createOp = resolvePreferredOperation(CoreResourceOperation.CREATE, {
+            requireLiteralIdentifier: true,
+        });
         const createConfig = createOp?.operationFrontendConfig;
         // Surface the Create button only when CREATE has an actual view (ADDRESSABLE or
         // EMBEDDED) — never for a headless (API_ONLY) create — and isn't app-hidden.
@@ -291,17 +318,11 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
         // resolve via `tResourceOperation(res, op, 'title')`. The list create button was the
         // only surface still hard-wired to the generic framework "create" component label
         // ("Create new item"), so a resource could never brand its create affordance.
-        // Falls back to that generic label when the resource has no generated operation
-        // title yet, so no button is ever unlabelled.
-        const operationTitle = tResourceOperation(resourceType, CoreResourceOperation.CREATE, 'title');
-        if (operationTitle)
-            return operationTitle;
-        return resolveComponentLabel({
-            tComponent,
-            componentType: FrontendComponentType.RESOURCES_LAYOUTS_LIST,
-            key: 'create',
-        });
-    }, [tComponent, tResourceOperation, resourceType]);
+        // A resource with no generated operation title yet shows that title's KEY (#1450), so the
+        // button is never unlabelled AND the gap is visible. It used to fall back to the generic
+        // "create" label, which made an unlabelled resource's create button read as finished.
+        return tResourceOperation(resourceType, CoreResourceOperation.CREATE, 'title');
+    }, [tResourceOperation, resourceType]);
     const noSearchResultsLabel = useMemo(() => resolveComponentLabel({
         tComponent,
         componentType: FrontendComponentType.RESOURCES_LAYOUTS_LIST,
@@ -378,7 +399,21 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
     // 2026-08-19 NOTHING consumed these events for collections, so a row deleted
     // from its READ page stayed on the revealed listing until a hard reload
     // (wildo-ai/wildo-ai#33).
-    const { lastRefreshAt: collectionRefreshAt } = resourceCollectionRefreshEvent({ ctx: resourceContext });
+    // Subscribed on the listing's SCOPE — the identifiers its selected route consumes — not on its
+    // whole context, which also carries ambient identifiers (the signed-in user) that no row
+    // broadcast names. See `FrontendResourceUtils.resolveCollectionRefreshScope`.
+    const collectionRefreshContext = useMemo(() => ({
+        ...resourceContext,
+        contextResourceIdentifiers: FrontendResourceUtils.resolveCollectionRefreshScope({
+            operation: operation,
+            contextResourceIdentifiers: resourceContext.contextResourceIdentifiers,
+            contextualParameters,
+            targetResourceType: resourceType,
+            targetDefaultFieldIdentifier: String(resourceConfig?.resourceFieldIdentifier ?? ''),
+            parentResourcesRequirements: resourceContext.parentResourcesRequirements,
+        }),
+    }), [contextualParameters, operation, resourceConfig?.resourceFieldIdentifier, resourceContext, resourceType]);
+    const { lastRefreshAt: collectionRefreshAt } = resourceCollectionRefreshEvent({ ctx: collectionRefreshContext });
     useEffect(() => {
         emitFrontendEvent(FrontendEvents.RESOURCE_COLLECTION_FILTERS_CHANGED, {
             resourceType,
@@ -500,8 +535,9 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
                     return;
                 }
                 const errorInfo = extractErrorInfo(err);
-                setError(errorInfo);
-                logger.error('Fetch error', { ...errorInfo, fetchKey });
+                // Rendered to the person: localized text, never the reference or the raw message (#1160).
+                setError({ ...errorInfo, message: toUserFacingErrorMessage(err) });
+                logger.error('Fetch error', { ...errorInfo, error: err, fetchKey });
             }
             finally {
                 logDebug('fetchData finally block', { cancelled, fetchKey });
@@ -587,7 +623,7 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
             // An empty bucket is a heading with nothing under it — say nothing instead.
             if (bucketItems.length === 0)
                 continue;
-            groups.push({ key: value, label: tResourceFieldEnumValue(resourceType, enumGroupField, value), items: bucketItems });
+            groups.push({ key: value, label: tResourceFieldEnumValue(resourceType, enumGroupField, value, definition?.schema), items: bucketItems });
         }
         // Values outside the vocabulary keep their rows visible, unlabelled, last.
         if (trailing.length > 0)
@@ -635,6 +671,30 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
             initiatorOverride: listNavigationInitiator,
         });
     }, [resourceConfig, availableOperations.create, navigateToResourceOperation, resourceContext.contextResourceIdentifiers, resourceContext.parentResourcesRequirements, listNavigationInitiator]);
+    /*
+     * CAN a row be opened at all?
+     *
+     * `handleItemClick` below ends in `if (!readOperation) return;` — a silent no-op — while the card
+     * and the table row painted themselves interactive regardless, because their affordance was keyed
+     * on the mere PRESENCE of a handler. So a resource whose READ resolves to no view (headless, or
+     * gated away) still offered a pointer, a button role, focus and Enter/Space, and answered none of
+     * them. The audit trail is the measured case.
+     *
+     * Asked through the SAME resolver the click uses, so the promise and the behaviour cannot
+     * disagree. Per-item, because that is the resolver's own contract (it reads the row's identifiers)
+     * — and cheap, since it is a registry lookup rather than a request.
+     */
+    const canOpenItem = useCallback((item) => {
+        if (!resourceConfig)
+            return false;
+        const itemId = FrontendResourceUtils.getResourceObjectId(item, resourceConfig.resourceFieldIdentifier);
+        if (!itemId)
+            return false;
+        return resolveReadOperationForIdentifiers({
+            ...resourceContext.contextResourceIdentifiers,
+            [resourceType]: itemId,
+        }) !== null;
+    }, [resourceConfig, resourceContext.contextResourceIdentifiers, resourceType, resolveReadOperationForIdentifiers]);
     // Handle navigation to READ (item click)
     const handleItemClick = useCallback((item) => {
         if (!resourceConfig)
@@ -712,7 +772,7 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
         return (
         // In GRID mode `divide-y` is gone, so each cell carries its own border to
         // read as a separated card; in LIST mode the shared `<ul>` owns the border.
-        _jsx("li", { className: cn('list-none', isCardGrid && CARDS_GRID_CELL_CLASS), children: _jsx(ResourceListItemRenderer, { item: item, resourceType: resourceType, resourceConfig: resourceConfig, registry: registry, summaryFields: summaryFields, fieldLabelsMap: fieldLabelsMap, tResourceFieldEnumValue: tResourceFieldEnumValue, onItemClick: handleItemClick, cardActionPlacement: cardActionPlacement, selectable: selectionEnabled, isSelected: selection.isSelected(item), selectionActive: selection.selectionCount > 0, onToggleSelect: selection.toggleSelection, selectAriaLabel: tComponent(FrontendComponentType.RESOURCES_LAYOUTS_LIST, 'selectRow', { row: index + 1 }), operationsSlot: renderItemOperations(item, cardActionPlacement?.orientation), interactiveClasses: {
+        _jsx("li", { className: cn('list-none', isCardGrid && CARDS_GRID_CELL_CLASS), children: _jsx(ResourceListItemRenderer, { item: item, resourceType: resourceType, resourceConfig: resourceConfig, registry: registry, summaryFields: summaryFields, fieldLabelsMap: fieldLabelsMap, tResourceFieldEnumValue: tResourceFieldEnumValue, onItemClick: canOpenItem(item) ? handleItemClick : undefined, cardActionPlacement: cardActionPlacement, selectable: selectionEnabled, isSelected: selection.isSelected(item), selectionActive: selection.selectionCount > 0, onToggleSelect: selection.toggleSelection, selectAriaLabel: tComponent(FrontendComponentType.RESOURCES_LAYOUTS_LIST, 'selectRow', { row: index + 1 }), operationsSlot: renderItemOperations(item, cardActionPlacement?.orientation), interactiveClasses: {
                     /*
                      * NOT the ghost recipe's hover, though the transition below is still its. The ghost
                      * INTERACTIVE recipe hovers with `bg-accent` — correct for a button under shadcn's
@@ -732,6 +792,15 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
                     transition: ghostRecipe.motion.transition,
                 } }) }, itemId || index));
     };
+    /**
+     * The CARDS-mode select-all, standing in the rows' own column.
+     *
+     * Above the cards region rather than inside it: selection is PAGE-wide, and a temporally- or
+     * enum-grouped cards view renders one `<ul>` per bucket — a rail inside them would be one
+     * select-all per bucket each claiming to command the page. TABLE needs none; its `__select`
+     * header cell already sits above its own column.
+     */
+    const cardsSelectionRail = selectionEnabled ? (_jsx("div", { className: CARDS_SELECTION_RAIL_CLASS, "data-slot": "collection-selection-rail-host", children: _jsx(CollectionSelectionHeaderRail, { allSelected: currentPageAllSelected, onToggleAll: handleToggleAllCurrentPage }) })) : null;
     // Render icons
     const addIcon = renderIcon(StandardIconReference.PLUS, { size: IconSize.SM });
     // The Create action: the toolbar's default trailing action AND the bulk bar's
@@ -747,16 +816,14 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
     // collections that have none; the component itself also renders null when the
     // role-gated collection-op set is empty.
     //
-    // ⚠️ SECOND SITE of the collection-scope question. `useResourceOperationActions` answers it too,
-    // and its comment there says the split "holds at a single site rather than N call sites" — which
-    // is true of the ACTION FILTER and not of the decision to MOUNT the surface at all. Both must
-    // agree, or the actions are computed and rendered into a container that was never created: that is
-    // exactly what happened to the collection-export action on 2026-08-25, where fixing three gates in
-    // the hook changed nothing visible because this one still said "no collection-scoped operations
-    // here". Any future exemption has to be applied in both places.
+    // The SECOND asker of the collection-scope question — the hook decides which actions exist, this
+    // decides whether the surface that shows them is mounted at all. Both now call the SAME predicate
+    // (`isCollectionScopedResourceOperation`), which is what retired the warning that used to stand
+    // here asking the next author to remember both places. On 2026-08-25 three gate fixes in the hook
+    // changed nothing visible because this check still said "no collection-scoped operations here";
+    // with one predicate that divergence is no longer expressible.
     const hasCollectionScopedOps = useMemo(() => (resourceConfig?.operations ?? [])
-        .some((op) => isCollectionScopedOperation(op.operationFrontendConfig)
-        || isGeneratedCollectionExportOperation(op)), [resourceConfig]);
+        .some((op) => isCollectionScopedResourceOperation(op)), [resourceConfig]);
     /**
      * The query THIS listing is currently showing, in the exact shape its own LIST call builds — so a
      * collection export carries the same narrowing as the screen it was clicked on.
@@ -804,7 +871,7 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
                     field: quickFilterDef,
                     value: filterValues[quickFilterDef.fieldName],
                     onChange: handleQuickFilterChange,
-                } : undefined, search: inlineSearch.isVisible ? {
+                } : undefined, presetFilters: presetFilters, search: inlineSearch.isVisible ? {
                     query: inlineSearch.query,
                     onChange: inlineSearch.handleChange,
                     onClear: inlineSearch.handleClear,
@@ -814,23 +881,40 @@ export const ResourceLayoutPreset_List_Default = ({ resourceContext, navigationZ
                     onSortChange: handleSortChange,
                 } : undefined, viewMode: userSwitchableViewMode ? { viewMode, onViewModeChange: setViewMode } : undefined, primaryAction: createButton, collectionActions: collectionActionsNode, selection: selectionEnabled ? {
                     count: selection.selectionCount,
-                    allSelected: currentPageAllSelected,
-                    onToggleAll: handleToggleAllCurrentPage,
                     onClear: selection.clearSelection,
-                } : undefined, bulkActions: selectionEnabled ? (_jsx(ResourceLayout_OperationBulk, { resourceContext: resourceContext, navigationZone: navigationZone, navigationInitiator: listNavigationInitiator, selectedItems: selection.selectedItems, idField: selectionIdField, onSelectionClear: selection.clearSelection, fallback: createButton })) : undefined }), _jsx(LoadingGate, { i18nKeys: i18nKeys, loadingScopes: loadingScopes, readiness: readiness, renderLoading: () => (_jsx(Skeleton, { template: viewMode === CollectionDisplayMode.TABLE ? 'table' : isCardGrid ? 'card' : 'list', density: "auto", count: pagination.limit, "aria-hidden": "true" })), children: _jsxs("div", { className: "space-y-section", children: [_jsx(ResourceLayout_InsertedViews, { resourceContext: resourceContext, navigationZone: navigationZone, showCharts: showCharts }), inPlaceHost.isCreateActive && (_jsx(ResourceInPlaceOperationRow, { navigationZone: navigationZone, className: "border border-border rounded-lg" })), items.length === 0 ? (isUsingInlineSearch ? (_jsx("div", { className: "text-center py-section text-muted-foreground text-sm", role: "status", children: noSearchResultsLabel })) : (_jsx(ResourceEmptyState, { resourceType: resourceType, config: emptyStateConfig, hasCreateOperation: !!availableOperations.create, onCreateAction: handleCreate }))) : viewMode === CollectionDisplayMode.TABLE ? (_jsx(ResourceCollectionBody_Table, { items: items, resourceType: resourceType, resourceConfig: resourceConfig, navigationZone: navigationZone, summaryFields: summaryFields, fieldLabelsMap: fieldLabelsMap, sortFields: sortFields, sortStates: sortStates, onSortChange: handleSortChange, selectable: selectionEnabled, isRowSelected: selectionIsSelected, onToggleRow: selectionToggle, allSelected: currentPageAllSelected, onToggleAll: handleToggleAllCurrentPage, renderRowActions: renderItemOperations, onRowClick: handleItemClick })) : renderedGroups ? (
-                        /* Grouped cards — one heading per bucket, from either grouping axis:
-                           temporal day buckets (activity-feed idiom, adjacent-merged in server
-                           order) or enum buckets (emitted in the enum's declaration order).
-                           Group keys are suffixed with the bucket index: non-adjacent temporal
-                           buckets can legitimately share a formatted date when the page isn't
-                           sorted by the grouping field. Grid layout applies within each
-                           bucket. */
-                        _jsx("div", { className: "space-y-card", "data-slot": "collection-groups", children: renderedGroups.map((group, groupIndex) => {
-                                // Page-GLOBAL row index (offset by all prior buckets' item counts) so
-                                // "Select row N" aria labels don't restart at 1 in every day group.
-                                const rowOffset = renderedGroups.slice(0, groupIndex).reduce((n, g) => n + g.items.length, 0);
-                                return (_jsxs("section", { className: "space-y-item-xs", children: [group.label && (_jsx("h3", { className: "text-xs font-medium text-muted-foreground", children: group.label })), _jsx("ul", { role: "list", "aria-label": group.label ?? listLabel, className: resolveCardsContainerClass(cardGridColumns), style: resolveCardsGridStyle(cardGridColumns), children: group.items.map((item, i) => renderCardsItem(item, rowOffset + i)) })] }, `${group.key}:${groupIndex}`));
-                            }) })) : (_jsx("ul", { role: "list", "aria-label": listLabel, className: resolveCardsContainerClass(cardGridColumns), style: resolveCardsGridStyle(cardGridColumns), children: items.map(renderCardsItem) })), _jsx(ResourceLayout_Pagination, { pagination: pagination, onPaginationChange: setPagination })] }) })] }));
+                    // Offered only once the page selection has stopped meaning what the person wants: every
+                    // row on screen ticked, and the listing matching more than this page holds. The query it
+                    // carries is the one that produced THIS listing, so the server re-evaluates exactly what
+                    // was on screen (#1461).
+                    ...(currentPageAllSelected && !selection.matchAllSelection && pagination.total > items.length
+                        ? {
+                            matchAllOffer: {
+                                matchedCount: pagination.total,
+                                onSelectAllMatching: () => selection.selectAllMatching({
+                                    filters: filterValues,
+                                    ...(debouncedInlineSearch ? { search: debouncedInlineSearch } : {}),
+                                    matchedCount: pagination.total,
+                                }),
+                            },
+                        }
+                        : {}),
+                    ...(selection.matchAllSelection ? { isMatchAllSelected: true } : {}),
+                } : undefined, bulkActions: selectionEnabled ? (_jsx(ResourceLayout_OperationBulk, { resourceContext: resourceContext, navigationZone: navigationZone, navigationInitiator: listNavigationInitiator, selectedItems: selection.selectedItems, matchAllSelection: selection.matchAllSelection, explicitIdSelection: selection.explicitIdSelection, onSelectIds: selection.selectIds, idField: selectionIdField, onSelectionClear: selection.clearSelection, onSelectionReplace: selection.selectAll, fallback: createButton })) : undefined }), _jsx(LoadingGate, { i18nKeys: i18nKeys, loadingScopes: loadingScopes, readiness: readiness, renderLoading: () => (_jsx(Skeleton, { template: viewMode === CollectionDisplayMode.TABLE ? 'table' : isCardGrid ? 'card' : 'list', density: "auto", count: pagination.limit, "aria-hidden": "true" })), children: _jsxs("div", { className: "space-y-section", children: [_jsx(ResourceLayout_InsertedViews, { resourceContext: resourceContext, navigationZone: navigationZone, showCharts: showCharts }), inPlaceHost.isCreateActive && (_jsx(ResourceInPlaceOperationRow, { navigationZone: navigationZone, className: "border border-border rounded-lg" })), items.length === 0 ? (isUsingInlineSearch ? (_jsx("div", { className: "text-center py-section text-muted-foreground text-sm", role: "status", children: noSearchResultsLabel })) : (_jsx(ResourceEmptyState, { resourceType: resourceType, config: emptyStateConfig, hasCreateOperation: !!availableOperations.create, onCreateAction: handleCreate }))) : viewMode === CollectionDisplayMode.TABLE ? (_jsx(ResourceCollectionBody_Table, { items: items, resourceType: resourceType, resourceConfig: resourceConfig, navigationZone: navigationZone, summaryFields: summaryFields, fieldLabelsMap: fieldLabelsMap, sortFields: sortFields, sortStates: sortStates, onSortChange: handleSortChange, selectable: selectionEnabled, isRowSelected: selectionIsSelected, onToggleRow: selectionToggle, allSelected: currentPageAllSelected, onToggleAll: handleToggleAllCurrentPage, renderRowActions: renderItemOperations, onRowClick: handleItemClick, canOpenRow: canOpenItem })) : renderedGroups ? (
+                        /* Grouped cards — one heading per bucket, from either grouping axis: temporal day buckets
+                           (activity-feed idiom, adjacent-merged in server order) or enum buckets (emitted in the
+                           enum's declaration order). Group keys are suffixed with the bucket index: non-adjacent
+                           temporal buckets can legitimately share a formatted date when the page isn't sorted by
+                           the grouping field. Grid layout applies within each bucket.
+                
+                           The `space-y-item-sm` wrapper is what keeps the select-all rail READING as the head of
+                           the list: as a bare sibling it would inherit the page's `space-y-section` rhythm and
+                           float a lone checkbox in the middle of the gap above the collection. */
+                        _jsxs("div", { className: "space-y-item-sm", children: [cardsSelectionRail, _jsx("div", { className: "space-y-card", "data-slot": "collection-groups", children: renderedGroups.map((group, groupIndex) => {
+                                        // Page-GLOBAL row index (offset by all prior buckets' item counts) so
+                                        // "Select row N" aria labels don't restart at 1 in every day group.
+                                        const rowOffset = renderedGroups.slice(0, groupIndex).reduce((n, g) => n + g.items.length, 0);
+                                        return (_jsxs("section", { className: "space-y-item-xs", children: [group.label && (_jsx("h3", { className: "text-xs font-medium text-muted-foreground", children: group.label })), _jsx("ul", { role: "list", "aria-label": group.label ?? listLabel, className: resolveCardsContainerClass(cardGridColumns), style: resolveCardsGridStyle(cardGridColumns), children: group.items.map((item, i) => renderCardsItem(item, rowOffset + i)) })] }, `${group.key}:${groupIndex}`));
+                                    }) })] })) : (_jsxs("div", { className: "space-y-item-sm", children: [cardsSelectionRail, _jsx("ul", { role: "list", "aria-label": listLabel, className: resolveCardsContainerClass(cardGridColumns), style: resolveCardsGridStyle(cardGridColumns), children: items.map(renderCardsItem) })] })), _jsx(ResourceLayout_Pagination, { pagination: pagination, onPaginationChange: setPagination })] }) })] }));
 };
 export function ResourceLayout_List({ preset, ...props }) {
     const ComponentOverride = resolveResourceOperationCustomView(props.resourceContext.operation);