refactor(ui): rename the recents widget to activity widget

[GermanJablo]

Drafted with AI

Stacked on #18799. Renames the dashboard widget to "activity" everywhere, matching its slug and the names from #18735. Behavior doesn't change.

What changes

Before	After
@payloadcms/ui/rsc#RecentlyViewedWidget	@payloadcms/ui/rsc#ActivityWidget
@payloadcms/ui#RecentsAndPinnedClient	@payloadcms/ui#ActivityWidgetClient
@payloadcms/ui#RecentlyViewedCollectionsField	@payloadcms/ui#CollectionFilter
Server function get-dashboard-documents	get-activity-widget-docs
widgets/RecentlyViewed/	widgets/Activity/, with the collection filter in widgets/shared/CollectionFilter/
.recents-widget*, --recents-*	.activity-widget*, --activity-*
.recents-widget__empty*, .recents-widget__status-pill*	.activity-empty-state*, .activity-status-pill*
.recently-viewed-collections-field*	.collection-filter*

sanitize.ts and the blank template import maps point at the new export names. Tests only change selectors and import paths.

Not a breaking change

The renamed exports are marked @internal in #18799. They're exported only so Payload's default dashboard config can reference them through the import map, and users configure built-in widgets by slug, so nobody was expected to import them. We think it's reasonable not to mark this as breaking, since there's little reason to have used them. There are no compatibility aliases.

Agreed with @JarrodMFlesch. In practice:

• The widget slug (activity), saved dashboard layouts and saved pins don't change.
• The import map is regenerated on dev startup and by payload build, so projects pick up the new paths automatically. Only a project that builds with plain next build and a stale importMap.js needs to run payload generate:importmap.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: Repository: payloadcms/payload/.coderabbit.yaml
• Review profile: CHILL
• Plan: Advanced
• Run ID: 6537d863-09c9-4f4d-babd-ceba667a5233

📥 Commits

Reviewing files that changed from the base of the PR and between 17cb320 and 7465026.

📒 Files selected for processing: 42

• packages/payload/src/config/sanitize.ts
• packages/ui/src/exports/client/index.ts
• packages/ui/src/exports/rsc/index.ts
• packages/ui/src/utilities/serverFunctionRegistry.ts
• packages/ui/src/widgets/Activity/Tabs/PinnedDocuments/PinDocumentPicker/index.css
• packages/ui/src/widgets/Activity/Tabs/PinnedDocuments/PinDocumentPicker/index.tsx
• packages/ui/src/widgets/Activity/Tabs/PinnedDocuments/index.css
• packages/ui/src/widgets/Activity/Tabs/PinnedDocuments/index.tsx
• packages/ui/src/widgets/Activity/Tabs/PinnedDocuments/preferences.ts
• packages/ui/src/widgets/Activity/Tabs/PinnedDocuments/usePinnedDocuments.ts
• packages/ui/src/widgets/Activity/Tabs/RecentDocuments/index.tsx
• packages/ui/src/widgets/Activity/components/DocumentList/index.css
• packages/ui/src/widgets/Activity/components/DocumentList/index.tsx
• packages/ui/src/widgets/Activity/components/EmptyState/index.css
• packages/ui/src/widgets/Activity/components/EmptyState/index.tsx
• packages/ui/src/widgets/Activity/components/Pagination/index.css
• packages/ui/src/widgets/Activity/components/Pagination/index.tsx
• packages/ui/src/widgets/Activity/components/StatusPill/index.css
• packages/ui/src/widgets/Activity/components/StatusPill/index.tsx
• packages/ui/src/widgets/Activity/index.client.tsx
• packages/ui/src/widgets/Activity/index.css
• packages/ui/src/widgets/Activity/index.tsx
• packages/ui/src/widgets/Activity/types.ts
• packages/ui/src/widgets/Activity/utils/cache.ts
• packages/ui/src/widgets/Activity/utils/constants.ts
• packages/ui/src/widgets/Activity/utils/documents.ts
• packages/ui/src/widgets/Activity/utils/getActivityWidgetDocs.ts
• packages/ui/src/widgets/Activity/utils/state.ts
• packages/ui/src/widgets/Activity/utils/useActivityDocuments.ts
• packages/ui/src/widgets/Activity/utils/usePageSize.ts
• packages/ui/src/widgets/RecentlyViewed/Tabs/PinnedDocuments/PinDocumentPicker/index.css
• packages/ui/src/widgets/UploadDropzone/CollectionsField/index.tsx
• packages/ui/src/widgets/shared/CollectionFilter/index.css
• packages/ui/src/widgets/shared/CollectionFilter/index.tsx
• templates/blank-tanstack/src/app/_payload/importMap.js
• templates/blank/src/app/(payload)/admin/importMap.js
• test/a11y/WCAG.e2e.spec.ts
• test/dashboard/documents.int.spec.ts
• test/dashboard/e2e.spec.ts
• test/dashboard/pins.int.spec.ts
• test/dashboard/thumbnails.int.spec.ts
• test/dashboard/utils.ts

💤 Files with no reviewable changes: 2

• packages/ui/src/widgets/RecentlyViewed/Tabs/PinnedDocuments/PinDocumentPicker/index.css
• packages/ui/src/widgets/Activity/utils/documents.ts

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 7 remain after this review.

📝 Walkthrough

The dashboard’s recently viewed widget is renamed Activity Widget across its server and client components, document-loading API, styles, exports, and templates. The collection selector is renamed and reused by the widget and upload settings. Tests use the updated names and selectors.

Changes: Activity Widget

Layer / File(s)	Summary
Document loading and server contract packages/ui/src/widgets/Activity/utils/*, packages/ui/src/widgets/Activity/index.tsx, packages/ui/src/utilities/serverFunctionRegistry.ts, test/dashboard/*	The server widget, document handler, registry entry, and client hook use activity-specific names. Page-size constants move to a dedicated module. Dashboard integration tests call the renamed handler.
Activity widget client and presentation packages/ui/src/widgets/Activity/*, test/a11y/WCAG.e2e.spec.ts, test/dashboard/e2e.spec.ts, test/dashboard/utils.ts	The client component, CSS selectors, and responsive styles use activity-specific names. Accessibility and end-to-end tests target the renamed widget.
Collection filter and app wiring packages/payload/src/config/sanitize.ts, packages/ui/src/widgets/shared/CollectionFilter/*, packages/ui/src/widgets/UploadDropzone/CollectionsField/index.tsx, packages/ui/src/exports/*, templates/blank*/**/importMap.js, test/dashboard/e2e.spec.ts	The shared field is renamed to CollectionFilter and wired into widget configuration, upload settings, package exports, and starter templates.

Priority: ⬇️ Low

Estimated code review effort: 3 (Moderate) | ~20 minutes

Change: Refactor

Merge Risk: ⚪ Minimal · up to 74650

No actionable regression is established. The rename is ready for normal build and test checks.

Security architecture risk: ⚪ Minimal · up to 74650

The renamed client and server operation remain aligned. The reviewed document-loading path preserves authentication, user-owned preference selection, and document access checks. No material security risk was found to be introduced or worsened by this change.

Retained concerns
No architecture-level concerns identified.

Security review details

Security Blast Radius

• inferred — The renamed operation retains the base exposure: authenticated users request pages derived from their own stored references, subject to collection access checks. The response page limit remains at most 100 documents; availability checks can examine the full stored reference set, so this is not a cap on total query work. No increased authority or document scope was identified in the comparison.

Trust Boundaries and Controls

• observed — Browser-controlled arguments cross the shared dispatcher, which inserts server-derived request and user context after spreading those arguments. Payload's admin context establishes identity through authentication. The handler rejects missing users, matches preference ownership by user collection and ID, and performs preference, reference, and document reads with overrideAccess:false and the authenticated request.

Pre-merge checks: 4 · 1

Failed checks: 1 warning

Check name	Status	Explanation	Resolution
Docstring Coverage		Docstring coverage is 46.67% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 15 functions across 32 files. (8 skipped:…	Write docstrings for the functions missing them to satisfy the coverage threshold.

Passed checks: 4 passed

Check name	Status	Explanation
Description check		The description clearly explains the rename from the recents widget to the activity widget, including related exports, server functions, CSS selectors, templates, tests, and compatibility consideratio…
Title check		The title concisely and accurately summarizes the primary change: renaming the recents widget to the activity widget.
Linked Issues check		Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check		Check skipped because no linked issues were found for this pull request.

Full details: Description check

Explanation

The description clearly explains the rename from the recents widget to the activity widget, including related exports, server functions, CSS selectors, templates, tests, and compatibility considerations.

Full details: Docstring Coverage

Explanation

Docstring coverage is 46.67% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 15 functions across 32 files. (8 skipped: 8 unsupported.)

Resolution

Write docstrings for the functions missing them to satisfy the coverage threshold.

• Fix all pre-merge checks with AI

✨ Finishing Touches: 💡 1

📝 Generate docstrings: 💡

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Warning

Git: CodeRabbit could not clone the repository, so clone-backed analysis was skipped and this review may be incomplete. Verify repository clone access, such as SSH credentials, before requesting another full review. If clone access is intentionally unavailable, use path_filters to narrow the review scope.

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

📦 esbuild Bundle Analysis for payload

This analysis was generated by esbuild-bundle-analyzer. 🤖

Meta File	Out File	Size (raw)	Note
packages/next/meta_index.json	esbuild/index.js	279.11 KB	🆕 Added
packages/payload/meta_index.json	esbuild/index.js	1.93 MB	🆕 Added
packages/payload/meta_shared.json	esbuild/exports/shared.js	543.06 KB	🆕 Added
packages/richtext-lexical/meta_client.json	esbuild/exports/client_optimized/index.js	297.27 KB	🆕 Added
packages/ui/meta_client.json	esbuild/exports/client_optimized/index.js	1.32 MB	🆕 Added
packages/ui/meta_shared.json	esbuild/exports/shared_optimized/index.js	19.14 KB	🆕 Added

Largest paths

These visualization shows top 20 largest paths in the bundle.

Meta file: packages/next/meta_index.json, Out file: esbuild/index.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ ████████████████████████▋ }}}$ 98.8%, 272.71 KB
dist/adapters/router.js	${{\color{Goldenrod}{ }}}$ 0.3%, 718 B
dist/adapters/server.js	${{\color{Goldenrod}{ }}}$ 0.2%, 533 B
dist/adapters/layout.js	${{\color{Goldenrod}{ }}}$ 0.2%, 529 B
dist/adapters/views.js	${{\color{Goldenrod}{ }}}$ 0.2%, 469 B
dist/adapters/UnmountWhenHidden	${{\color{Goldenrod}{ }}}$ 0.2%, 449 B
dist/utilities/initAdminContext.js	${{\color{Goldenrod}{ }}}$ 0.1%, 366 B
dist/utilities/selectiveCache.js	${{\color{Goldenrod}{ }}}$ 0.1%, 263 B
dist/esbuildEntry.js	${{\color{Goldenrod}{ }}}$ 0.0%, 0 B

Meta file: packages/payload/meta_index.json, Out file: esbuild/index.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ █████████████████▏ }}}$ 68.5%, 1.32 MB
dist/collections/operations	${{\color{Goldenrod}{ ▉ }}}$ 3.6%, 68.23 KB
dist/fields/hooks	${{\color{Goldenrod}{ ▋ }}}$ 2.5%, 48.00 KB
dist/uploads/fileVersioning	${{\color{Goldenrod}{ ▎ }}}$ 1.2%, 22.30 KB
dist/globals/operations	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 19.50 KB
dist/auth/operations	${{\color{Goldenrod}{ ▏ }}}$ 0.9%, 17.10 KB
dist/utilities/configToJSONSchema.js	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 16.04 KB
dist/queues/operations	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 14.32 KB
dist/fields/config	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 13.77 KB
dist/collections/config	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 11.96 KB
dist/utilities/telemetry	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 11.93 KB
dist/fields/validations.js	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 10.29 KB
dist/cli/commands	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 9.93 KB
dist/config/orderable	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 8.78 KB
dist/uploads/fetchAPI-multipart	${{\color{Goldenrod}{ }}}$ 0.4%, 8.39 KB
dist/database/migrations	${{\color{Goldenrod}{ }}}$ 0.4%, 8.16 KB
dist/config/sanitize.js	${{\color{Goldenrod}{ }}}$ 0.4%, 8.14 KB
dist/utilities/entityInputSchema	${{\color{Goldenrod}{ }}}$ 0.4%, 8.02 KB
dist/uploads/generateFileData.js	${{\color{Goldenrod}{ }}}$ 0.4%, 7.97 KB
dist/collections/endpoints	${{\color{Goldenrod}{ }}}$ 0.4%, 7.85 KB
(other)	${{\color{Goldenrod}{ ███████▉ }}}$ 31.5%, 604.54 KB

Meta file: packages/payload/meta_shared.json, Out file: esbuild/exports/shared.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ ██████████████████████ }}}$ 88.2%, 474.44 KB
dist/fields/validations.js	${{\color{Goldenrod}{ ▍ }}}$ 1.9%, 10.26 KB
dist/fields/config	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 5.83 KB
dist/utilities/traverseFields.js	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 4.34 KB
dist/utilities/deepCopyObject.js	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 3.52 KB
dist/collections/config	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 3.44 KB
dist/config/orderable	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 3.13 KB
dist/fields/baseFields	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 2.79 KB
dist/config/client.js	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 2.62 KB
dist/auth/cookies.js	${{\color{Goldenrod}{ }}}$ 0.3%, 1.55 KB
dist/utilities/flattenTopLevelFields.js	${{\color{Goldenrod}{ }}}$ 0.3%, 1.42 KB
dist/utilities/getVersionsConfig.js	${{\color{Goldenrod}{ }}}$ 0.2%, 1.04 KB
dist/globals/config	${{\color{Goldenrod}{ }}}$ 0.2%, 957 B
dist/uploads/generatePayloadFileURL.js	${{\color{Goldenrod}{ }}}$ 0.2%, 864 B
dist/utilities/unflatten.js	${{\color{Goldenrod}{ }}}$ 0.2%, 850 B
dist/utilities/flattenAllFields.js	${{\color{Goldenrod}{ }}}$ 0.1%, 798 B
dist/errors/ValidationError.js	${{\color{Goldenrod}{ }}}$ 0.1%, 772 B
dist/utilities/sanitizeUserDataForEmail.js	${{\color{Goldenrod}{ }}}$ 0.1%, 713 B
dist/auth/extractJWT.js	${{\color{Goldenrod}{ }}}$ 0.1%, 696 B
dist/utilities/getFieldPermissions.js	${{\color{Goldenrod}{ }}}$ 0.1%, 681 B
(other)	${{\color{Goldenrod}{ ██▉ }}}$ 11.8%, 63.68 KB

Meta file: packages/richtext-lexical/meta_client.json, Out file: esbuild/exports/client_optimized/index.js

Path	Size
dist/features/blocks	${{\color{Goldenrod}{ ███▋ }}}$ 14.6%, 42.82 KB
dist/lexical/plugins	${{\color{Goldenrod}{ ██▉ }}}$ 11.7%, 34.51 KB
dist/lexical/ui	${{\color{Goldenrod}{ ██▊ }}}$ 11.4%, 33.66 KB
dist/features/table	${{\color{Goldenrod}{ ██▎ }}}$ 9.3%, 27.46 KB
dist/features/toolbars	${{\color{Goldenrod}{ █▋ }}}$ 6.8%, 19.93 KB
dist/features/link	${{\color{Goldenrod}{ █▌ }}}$ 6.3%, 18.56 KB
dist/features/upload	${{\color{Goldenrod}{ █▏ }}}$ 4.8%, 14.03 KB
dist/features/textState	${{\color{Goldenrod}{ ▉ }}}$ 3.8%, 11.08 KB
dist/lexical/utils	${{\color{Goldenrod}{ ▊ }}}$ 3.4%, 10.02 KB
dist/features/relationship	${{\color{Goldenrod}{ ▊ }}}$ 3.2%, 9.32 KB
dist/features/converters	${{\color{Goldenrod}{ ▋ }}}$ 2.9%, 8.41 KB
dist/utilities/fieldsDrawer	${{\color{Goldenrod}{ ▋ }}}$ 2.8%, 8.12 KB
dist/features/debug	${{\color{Goldenrod}{ ▋ }}}$ 2.5%, 7.40 KB
dist/lexical/config	${{\color{Goldenrod}{ ▍ }}}$ 1.7%, 5.14 KB
dist/features/indent	${{\color{Goldenrod}{ ▎ }}}$ 1.4%, 4.19 KB
dist/features/lists	${{\color{Goldenrod}{ ▎ }}}$ 1.2%, 3.67 KB
dist/lexical/LexicalEditor.js	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 3.33 KB
dist/features/horizontalRule	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 3.29 KB
dist/features/format	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 3.28 KB
dist/field/Field.js	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 3.06 KB
(other)	${{\color{Goldenrod}{ █████████████████████▎ }}}$ 85.4%, 251.24 KB

Meta file: packages/ui/meta_client.json, Out file: esbuild/exports/client_optimized/index.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ ███████▎ }}}$ 29.2%, 382.60 KB
dist/elements/Hierarchy	${{\color{Goldenrod}{ ▉ }}}$ 3.8%, 49.35 KB
dist/elements/BulkUpload	${{\color{Goldenrod}{ ▌ }}}$ 2.3%, 30.54 KB
dist/elements/Table	${{\color{Goldenrod}{ ▌ }}}$ 2.2%, 28.90 KB
dist/views/Version	${{\color{Goldenrod}{ ▌ }}}$ 2.1%, 27.71 KB
dist/views/Edit	${{\color{Goldenrod}{ ▍ }}}$ 1.7%, 22.21 KB
dist/views/HierarchyList	${{\color{Goldenrod}{ ▍ }}}$ 1.6%, 21.55 KB
dist/views/Dashboard	${{\color{Goldenrod}{ ▍ }}}$ 1.5%, 19.82 KB
dist/elements/WhereBuilder	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 17.65 KB
dist/providers/Auth	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 17.41 KB
dist/fields/Relationship	${{\color{Goldenrod}{ ▎ }}}$ 1.2%, 16.23 KB
dist/forms/Form	${{\color{Goldenrod}{ ▎ }}}$ 1.2%, 15.99 KB
dist/fields/Upload	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 14.96 KB
dist/fields/Blocks	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 14.91 KB
dist/widgets/Activity	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 14.03 KB
dist/elements/Popup	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 13.32 KB
dist/views/List	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 13.21 KB
dist/elements/ReactSelect	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 12.98 KB
dist/elements/PublishButton	${{\color{Goldenrod}{ ▏ }}}$ 0.9%, 12.00 KB
dist/elements/QueryPresets	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 10.82 KB
(other)	${{\color{Goldenrod}{ █████████████████▋ }}}$ 70.8%, 929.03 KB

Meta file: packages/ui/meta_shared.json, Out file: esbuild/exports/shared_optimized/index.js

Path	Size
dist/graphics/Logo	${{\color{Goldenrod}{ ███████▌ }}}$ 30.4%, 5.61 KB
../../node_modules	${{\color{Goldenrod}{ ███▌ }}}$ 14.4%, 2.65 KB
dist/graphics/Icon	${{\color{Goldenrod}{ ██ }}}$ 8.2%, 1.51 KB
dist/utilities/formatDocTitle	${{\color{Goldenrod}{ █▊ }}}$ 7.1%, 1.32 KB
dist/providers/TableColumns	${{\color{Goldenrod}{ █▏ }}}$ 4.7%, 866 B
dist/utilities/getGlobalData.js	${{\color{Goldenrod}{ █ }}}$ 4.1%, 762 B
dist/utilities/api.js	${{\color{Goldenrod}{ █ }}}$ 4.1%, 756 B
dist/utilities/groupNavItems.js	${{\color{Goldenrod}{ █ }}}$ 4.0%, 745 B
dist/utilities/traverseForLocalizedFields.js	${{\color{Goldenrod}{ ▊ }}}$ 3.1%, 570 B
dist/elements/Translation	${{\color{Goldenrod}{ ▋ }}}$ 2.7%, 493 B
dist/utilities/handleTakeOver.js	${{\color{Goldenrod}{ ▌ }}}$ 2.4%, 440 B
dist/elements/withMergedProps	${{\color{Goldenrod}{ ▍ }}}$ 1.8%, 339 B
dist/utilities/getNavGroups.js	${{\color{Goldenrod}{ ▍ }}}$ 1.8%, 338 B
dist/utilities/getVisibleEntities.js	${{\color{Goldenrod}{ ▍ }}}$ 1.8%, 329 B
dist/elements/WithServerSideProps	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 232 B
dist/layouts/Root	${{\color{Goldenrod}{ ▎ }}}$ 1.2%, 230 B
dist/utilities/handleGoBack.js	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 180 B
dist/fields/mergeFieldStyles.js	${{\color{Goldenrod}{ ▏ }}}$ 0.9%, 158 B
dist/forms/Form	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 152 B
dist/utilities/handleBackToDashboard.js	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 152 B
(other)	${{\color{Goldenrod}{ █████████████████▍ }}}$ 69.6%, 12.84 KB

Details

Next to the size is how much the size has increased or decreased compared with the base branch of this PR.

• ‼️: Size increased by 20% or more. Special attention should be given to this.
• ⚠️: Size increased in acceptable range (lower than 20%).
• ✅: No change or even downsized.
• 🗑️: The out file is deleted: not found in base branch.
• 🆕: The out file is newly found: will be added to base branch.