## Summary

Begin of the insertionMigratesEnd of the insertion Begin of the deletion MigrateEnd of the deletion list-shaped `Primer::Beta::BorderBox` / `border_box_container` usages to Begin of the deletion `OpenProject::Common::BorderBoxListComponent`, and extendEnd of the deletion the shared Begin of the insertion`OpenProject::Common::BorderBoxListComponent`. ShippedEnd of the insertion Begin of the deletion component API where the remaining migrations needed legitimate header flexibility.

Implementation was drafted in the monolithic PR https://github.com/opf/openproject/pull/23812 (closed, superseded) and now shipsEnd of the deletion as a stacked PR train, Begin of the insertionone childEnd of the insertion Begin of the deletion each slice paired with its own implementation child: #DREAM-801 shared header API (https://github.com/opf/openproject/pull/24643), #DREAM-802 phase definitions + export templates — gates #DREAM-789 (https://github.com/opf/openproject/pull/24644), #DREAM-803 wiki, OAuth and project settings lists (https://github.com/opf/openproject/pull/24645), and #DREAM-804 meetings, costs andEnd of the deletion work package Begin of the insertionper slice: #DREAM-801 (shared API), <mention class="mention" data-id="78249" data-type="work_package" data-text="#DREAM-802" data-display-id="DREAM-802">#DREAM-802</mention> , <mention class="mention" data-id="78250" data-type="work_package" data-text="#DREAM-803" data-display-id="DREAM-803">#DREAM-803</mention> , <mention class="mention" data-id="78251" data-type="work_package" data-text="#DREAM-804" data-display-id="DREAM-804">#DREAM-804</mention> .End of the insertion Begin of the deletion tab lists (https://github.com/opf/openproject/pull/24646).End of the deletion

Begin of the deletion The label-action deprecation drafted in the monolith was dropped: #DREAM-780 superseded it with the standalone status-label slot, which the stack builds on.

End of the deletion ## Begin of the deletion Implemented so far

### Shared componentEnd of the deletion API Begin of the insertionchangesEnd of the insertion

Begin of the insertionAll exist solely to let the remaining consumers migrate — nothing more:

* End of the insertion Begin of the deletion - AddedEnd of the deletion `header.with_title` Begin of the insertion—End of the insertion Begin of the deletion forEnd of the deletion linked or composed title content Begin of the deletion while still renderingEnd of the deletion inside the configured heading element. Begin of the insertion

* End of the insertion Begin of the deletion
- AddedEnd of the deletion `header.with_action_icon_button` Begin of the insertion—End of the insertion Begin of the deletion forEnd of the deletion icon-only header actions. Begin of the insertion

* Header/rowEnd of the insertion Begin of the deletion
- Reworked header/rowEnd of the deletion menus Begin of the insertionvia `BorderBoxListComponent::Menu` —End of the insertion Begin of the deletion through `BorderBoxListComponent::Menu`, keeping the default kebab triggerEnd of the deletion automatic Begin of the insertionkebab trigger, customisable viaEnd of the insertion Begin of the deletion while allowingEnd of the deletion `button_arguments:` or Begin of the deletion a caller-providedEnd of the deletion `menu.with_show_button`. Begin of the insertion

* `empty_state_behavior:` policy — `:static` (default) renders the declared or generic blankslate only while a list is empty; `:none` suppresses it (grouped surfaces); `:dynamic` shows it client-sideEnd of the insertion Begin of the deletion
- Added default empty-state rendering for itemless listsEnd of the deletion when Begin of the insertionfiltering or drag-and-drop emptiesEnd of the insertion Begin of the deletion callers do not provideEnd of the deletion a Begin of the insertionlist.

* Headers keep a stable height when filtering hides their action buttons.


## Screens updated (in merge order)End of the insertion Begin of the deletion custom `with_empty_state` slot.
- Updated Lookbook docs, previews, preview specs, and component specs for the new public API.End of the deletion

Begin of the insertion* #DREAM-802: projectEnd of the insertion Begin of the deletion ### Migrated consumers

Distributed across the stack: #DREAM-802 carries theEnd of the deletion phase definitions Begin of the insertion(admin), PDFEnd of the insertion Begin of the deletion andEnd of the deletion export Begin of the insertiontemplates (type settings).

* #DREAM-803: wiki page links (work package tab), portfolios, OAuth applications (admin),End of the insertion Begin of the deletion template lists; #DREAM-803 the wiki, portfolio, OAuth, life-cycle,End of the deletion project Begin of the insertionlife cycle settings, projectEnd of the insertion attributes Begin of the insertionsettings (+ creation wizard), My account notifications.

* #DREAM-804: work package meetings tab, departments (admin), work packageEnd of the insertion Begin of the deletion and notifications surfaces; #DREAM-804 the meetings, costs, departments,End of the deletion relations Begin of the insertiontab, meeting participants, cost types settings,End of the insertion Begin of the deletion tab andEnd of the deletion resource Begin of the insertionallocations.

* LandedEnd of the insertion Begin of the deletion allocation surfaces.

- `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` (landed on dev independently)
- `WorkPackageTypes::ExportTemplateListComponent`
- `My::Notifications::ShowPageComponent`
- `WorkPackageMeetingsTab::MeetingComponent`
- `Admin::Departments::DetailComponent`
- `WorkPackageRelationsTab::IndexComponent`
- `Admin::Enumerations::IndexComponent` (landed on devEnd of the deletion independently Begin of the insertionearlier: enumerations (admin), workflows type list.


End of the insertion Begin of the deletion via the #DREAM-688 line)
- `Meetings::Participants::ListComponent`
- `Projects::Settings::CostTypes::IndexComponent`
- `ResourceAllocations::ListComponent`

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

End of the deletion ## Begin of the insertionHintsEnd of the insertion Begin of the deletion Review and commit structure

The stack is orderedEnd of the deletion for Begin of the insertionQA

* Migrated screens should look unchanged apartEnd of the insertion Begin of the deletion linear review: the shared API slice first, then one consumer batch per PR. Each consumer migration is a focused vertical-slice commit with its component spec, and the API slice separates the header/menu reworkEnd of the deletion from Begin of the insertionconsistent header/menu stylingEnd of the insertion Begin of the deletion the default empty state so both can be evaluated independently. Every `[DREAM-697]` commit has a one-line detailEnd of the deletion and Begin of the deletion links back to this work package.

## Verification

- Component and preview specs pass per slice: #DREAM-801 96 examples, #DREAM-802 26, #DREAM-803 56, #DREAM-804 59 — 0 failures each.
- `bin/dirty-rubocop` and `erb_lint` clean on each slice's changed files.
- The export-template drag/toggle feature spec runs in CI onEnd of the deletion the Begin of the insertionempty-state behavior below.

* FilteringEnd of the insertion Begin of the deletion #DREAM-802 slice.

## Remaining migration candidates

Triaged by row shape. Gating rule: rows with multiple data columns belong onEnd of the deletion a Begin of the insertionlist toEnd of the insertion Begin of the deletion future BorderBoxTable / DataTable, not BorderBoxListComponent; rich headers (multiple menus plus a dialog) are out of scope until handled separately, withEnd of the deletion no Begin of the insertionmatches (Project attributes, Project life cycle settings, admin phase definitions) showsEnd of the insertion Begin of the deletion header-API extension.

### StillEnd of the deletion a Begin of the insertionblankslate inside the box —End of the insertion Begin of the deletion BorderBoxList candidate

| Component | Features | Notes |
|---|---|---|
| `MeetingAgendaItems::ListComponent` | new-item form, no header | Lowest fit; not yet done. |

### Reclassified to BorderBoxTable (multiple data columns)

| Component | Notes |
|---|---|
| `Documents::Admin::DocumentTypes::IndexComponent` | name / type / updated columns. PR https://github.com/opf/openproject/pull/23485 (#DREAM-688, closed unmerged)End of the deletion previously Begin of the deletion covered it. |
| `Storages::Admin::StorageListComponent` | name / creator / provider / time columns. |
| `Wikis::Admin::WikiProviderListComponent` | name / provider / time columns. |
| `Documents::ListComponent` | name / type / updated columns. |

### Deferred -- rich header / invasive (no header-API extension)

| Component | Notes |
|---|---|
| `Settings::ProjectCustomFieldSections::ShowComponent` | Admin section header hasEnd of the deletion a Begin of the insertionbare box orEnd of the insertion Begin of the deletion drag handle,End of the deletion a Begin of the insertionfloating &quot;No items found&quot; line.

* Administration → Work packages → Types: type groups without variants no longer showEnd of the insertion Begin of the deletion single-select position menu,End of the deletion a Begin of the insertionblankslate row per group.

* Headers with &quot;Enable all / Disable all&quot;-styleEnd of the insertion Begin of the deletion kebabEnd of the deletion actions Begin of the insertionkeep their height while filtering hidesEnd of the insertion Begin of the deletion menu, and an edit dialog -- beyondEnd of the deletion the Begin of the insertionactions.

* Backlogs sprint/backlog lists still show their drop-target blankslate immediately whenEnd of the insertion Begin of the deletion list header slot. Not a clone ofEnd of the deletion the Begin of the insertionlast card is dragged out.


End of the insertion Begin of the deletion migrated `Projects::Settings::ProjectCustomFieldSections::ShowComponent` twin (which has only a title and two action buttons). |
| `WorkPackageTypes::FormConfiguration::GroupComponent` | Nested group + attribute drag, group-level kebab menu and drag handle. |
| `MeetingSections::ShowComponent` | Nested drag targets; pending API / behaviour review. |

End of the deletion ## Begin of the insertionRemaining and outEnd of the insertion Begin of the deletion OutEnd of the deletion of scope Begin of the deletion (not list-shaped)End of the deletion

Begin of the insertion* `MeetingAgendaItems::ListComponent`End of the insertion Begin of the deletion 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.

### Coordination with DREAM-671

#DREAM-786End of the deletion is Begin of the deletion merged, soEnd of the deletion the only remaining Begin of the insertionBorderBoxList candidate.

* Multi-column lists (document types, storages, wiki providers, documents) wait for a future BorderBoxTable/DataTable.

* Rich-header surfaces (admin project attributes sections,End of the insertion Begin of the deletion #DREAM-671 dependency on this effort is #DREAM-789, which follows #DREAM-802 (the phase definitions and export template markup it builds on). The former parent-level Blocks relation was replaced by that precise Follows relation.

The rich-header admin Project attributes,End of the deletion form-configuration Begin of the insertiongroups,End of the insertion Begin of the deletion group, andEnd of the deletion meeting Begin of the insertionsections) belong toEnd of the insertion Begin of the deletion section components remain outside #DREAM-697's scope. Their markup and DnD contract are handled insideEnd of the deletion the Begin of the deletion correspondingEnd of the deletion #DREAM-671 migration Begin of the insertionline — no further header-API growthEnd of the insertion Begin of the deletion cluster; they must not drive another broad BorderBoxList header API expansionEnd of the deletion here. Begin of the insertion

* #DREAM-789 follows #DREAM-802 (the only remaining #DREAM-671 dependency on this effort).End of the insertion