## Summary

Migrate list-shaped `Primer::Beta::BorderBox` / `border_box_container` usages to `OpenProject::Common::BorderBoxListComponent`, and extend the shared component API where the remaining migrations needed legitimate header flexibility.

Implementation is tracked in PR opf/openproject#23812.

## Implemented so far

### Shared component API

- Added `header.with_title` for linked or composed title content while still rendering inside the configured heading element.
- Added `header.with_action_icon_button` for icon-only header actions.
- Reworked header/row menus through `BorderBoxListComponent::Menu`, keeping the default kebab trigger automatic while allowing `button_arguments:` or a caller-provided `menu.with_show_button`.
- Added default empty-state rendering for itemless lists when callers do not provide a custom `with_empty_state` slot.
- Updated Lookbook docs, previews, preview specs, and component specs for the new public API.

### Migrated consumers

- `Wikis::CollapsiblePageLinksComponent`
- `Wikis::RelationPageLinksComponent`
- `Portfolios::IndexComponent`
- `OAuth::Applications::IndexComponent`
- `Settings::ProjectPhaseDefinitions::IndexComponent`
- `Projects::Settings::LifeCycle::IndexComponent`
- `Projects::Settings::ProjectCustomFieldSections::ShowComponent`
- `Projects::Settings::CreationWizard::ProjectCustomFieldSections::ShowComponent`
- `Workflows::TypeListComponent`, renamed from `Workflows::TableComponent`
- `WorkPackageTypes::ExportTemplateListComponent`
- `My::Notifications::ShowPageComponent`
- `WorkPackageMeetingsTab::MeetingComponent`
- `Admin::Departments::DetailComponent`
- `WorkPackageRelationsTab::IndexComponent` Begin of the insertion
- `Admin::Enumerations::IndexComponent` (implemented here, guided by PR opf/openproject#23485)
- `Meetings::Participants::ListComponent`
- `Projects::Settings::CostTypes::IndexComponent`
- `ResourceAllocations::ListComponent`End of the insertion

Existing Backlogs bucket/sprint menu callers were also updated to the new `button_arguments:` API.

## Review and commit structure

The branch was regrouped for reviewability:

- the shared API change is Begin of the deletion nowEnd of the deletion the first commit;
- each consumer migration is committed as a focused vertical slice;
- follow-up review fixes were folded into their owning commits rather than left as a trailing cleanup commit;
- every `[DREAM-697]` commit has a one-line detail and links back to this work package.

## Verification

- Component specs for the shared component and migrated Begin of the insertionconsumers pass; the four most recent migrations add 38End of the insertion Begin of the deletion consumers: 195End of the deletion examples, 0 failures.
- Feature specs for workflow accessibility and export-template drag/toggle behavior: 4 examples, 0 failures.
- `bin/dirty-rubocop --against origin/dev`: Begin of the deletion 27 files,End of the deletion no offenses.
- `erb_lint` on changed ERB files: no errors.
- `git diff --check origin/dev..HEAD`: clean.

## Remaining migration candidates

Begin of the insertionTriagedEnd of the insertion Begin of the deletion RankedEnd of the deletion by Begin of the insertionrow shape. Gating rule: rows with multiple data columns belong on a future BorderBoxTable / DataTable, not BorderBoxListComponent; rich headers (multiple menus plus a dialog) are out of scope until handled separately, with no header-API extension.End of the insertion Begin of the deletion fit (list-shaped BorderBox usages targeting BorderBoxListComponent).End of the deletion

Begin of the insertion### Still a BorderBoxList candidate

End of the insertion | Begin of the deletion # |End of the deletion Component | Features | Notes |
Begin of the insertion|---|---|---|End of the insertion Begin of the deletion |---|-----------|----------|-------|End of the deletion
| Begin of the insertion`MeetingAgendaItems::ListComponent`End of the insertion Begin of the deletion 1End of the deletion | Begin of the insertionnew-item form, noEnd of the insertion Begin of the deletion `Admin::Enumerations::IndexComponent` |End of the deletion header Begin of the deletion / drag / emptyEnd of the deletion | Begin of the insertionLowest fit; not yet done.End of the insertion Begin of the deletion Cherry-pick from PR opf/openproject#23485 (DREAM-688, WP#74940). Shares a class hierarchy with #2.End of the deletion | Begin of the insertion

### Reclassified to BorderBoxTable (multiple data columns)

End of the insertion Begin of the deletion
End of the deletion | Begin of the insertionComponentEnd of the insertion Begin of the deletion 2End of the deletion | Begin of the insertionNotes |
|---|---|
|End of the insertion `Documents::Admin::DocumentTypes::IndexComponent` | Begin of the insertionnameEnd of the insertion Begin of the deletion headerEnd of the deletion / Begin of the insertiontypeEnd of the insertion Begin of the deletion dragEnd of the deletion / Begin of the insertionupdated columns. AlsoEnd of the insertion Begin of the deletion empty | Coupled to #1; alsoEnd of the deletion covered by PR Begin of the insertionopf/openproject#23485 (DREAM-688).End of the insertion Begin of the deletion opf/openproject#23485.End of the deletion |
| Begin of the insertion`Storages::Admin::StorageListComponent`End of the insertion Begin of the deletion 3End of the deletion | Begin of the insertionnameEnd of the insertion Begin of the deletion `Settings::ProjectCustomFieldSections::ShowComponent` | headerEnd of the deletion / Begin of the insertioncreatorEnd of the insertion Begin of the deletion menuEnd of the deletion / Begin of the insertionproviderEnd of the insertion Begin of the deletion dragEnd of the deletion / Begin of the insertiontime columns.End of the insertion Begin of the deletion emptyEnd of the deletion | Begin of the deletion Near-clone of the migrated `Projects::Settings::ProjectCustomFieldSections::ShowComponent`; high spec reuse. |End of the deletion
| Begin of the insertion`Wikis::Admin::WikiProviderListComponent`End of the insertion Begin of the deletion 4End of the deletion | Begin of the insertionnameEnd of the insertion Begin of the deletion `Storages::Admin::StorageListComponent` | headerEnd of the deletion / Begin of the insertionprovider / time columns.End of the insertion Begin of the deletion emptyEnd of the deletion | Begin of the deletion |End of the deletion
| Begin of the insertion`Documents::ListComponent`End of the insertion Begin of the deletion 5End of the deletion | Begin of the insertionnameEnd of the insertion Begin of the deletion `Wikis::Admin::WikiProviderListComponent` | headerEnd of the deletion / Begin of the insertiontype / updated columns.End of the insertion Begin of the deletion emptyEnd of the deletion | Begin of the insertion

### Deferred -- richEnd of the insertion Begin of the deletion |
| 6 | `Meetings::Participants::ListComponent` |End of the deletion header / Begin of the insertioninvasive (no header-API extension)

End of the insertion Begin of the deletion emptyEnd of the deletion | Begin of the insertionComponentEnd of the insertion | Begin of the insertionNotes |End of the insertion
Begin of the insertion|---|---|
End of the insertion | Begin of the insertion`Settings::ProjectCustomFieldSections::ShowComponent`End of the insertion Begin of the deletion 7End of the deletion | Begin of the insertionAdmin sectionEnd of the insertion Begin of the deletion `Documents::ListComponent` |End of the deletion header Begin of the insertionhasEnd of the insertion Begin of the deletion / empty | Pagination row maps toEnd of the deletion a Begin of the insertiondrag handle, a single-select position menu, a kebab actions menu, and an edit dialog -- beyond the list headerEnd of the insertion Begin of the deletion footerEnd of the deletion slot. Begin of the insertionNot a clone of the migrated `Projects::Settings::ProjectCustomFieldSections::ShowComponent` twin (which has only a title and two action buttons).End of the insertion |
| Begin of the insertion`WorkPackageTypes::FormConfiguration::GroupComponent`End of the insertion Begin of the deletion 8End of the deletion | Begin of the deletion `MeetingSections::ShowComponent` | header / drag / empty |End of the deletion Nested Begin of the insertiongroup + attribute drag, group-level kebab menu andEnd of the insertion drag Begin of the insertionhandle.End of the insertion Begin of the deletion targets (harder).End of the deletion |
| Begin of the insertion`MeetingSections::ShowComponent`End of the insertion Begin of the deletion 9End of the deletion | Begin of the insertionNestedEnd of the insertion Begin of the deletion `WorkPackageTypes::FormConfiguration::GroupComponent` | header /End of the deletion drag Begin of the insertiontargets; pending APIEnd of the insertion / Begin of the insertionbehaviour review.End of the insertion Begin of the deletion emptyEnd of the deletion | Begin of the deletion |
| 10 | `Projects::Settings::CostTypes::IndexComponent` | toggle list / empty | Same shape as migrated life-cycle / export-template lists. |
| 11 | `ResourceAllocations::ListComponent` | headerless list | Same shape as migrated Portfolios. |
| 12 | `MeetingAgendaItems::ListComponent` | new-item form | No header; lowest fit. |End of the deletion

Note: PR opf/openproject#23485 also adds `spec/support/shared/components/border_box_list_component.rb`, which this branch already introduces -- Begin of the insertioncoordinate to avoidEnd of the insertion Begin of the deletion expectEnd of the deletion a conflict on that Begin of the insertionfile.End of the insertion Begin of the deletion file when integrating either way.End of the deletion

## Out of scope (not list-shaped)

Detail / single boxes: activities journal `ItemComponent` and `RevisionComponent`. Wizards / accordions: SAML and OpenID Connect provider views, Storages `StorageViewComponent`, Wikis `WikiProviderViewComponent`, Jira import wizard. Other: date-picker dialog, creation-wizard blank slate, manage-shares (dynamic JS rows), custom-field hierarchy items (tree), filter form, health-reports dashboard.