Skip to content

feat(columns): collapse columns, open a header menu, add a column from a tile - #232

Merged
ManukMinasyan merged 34 commits into
4.xfrom
feat/column-controls
Nov 15, 2026
Merged

ManukMinasyan merged 34 commits into
4.xfrom
feat/column-controls

Conversation

@ManukMinasyan

Copy link
Copy Markdown
Member

Boards can now collapse columns, open a menu from a column header, and add a column from a tile after the last one. Hosts wire the writes; Flowforge draws the controls. Before this, a host that wanted any of these had to override Flowforge's views and drift from every release.

What changed

  • Collapse. collapsedColumns(), collapseAllColumns() and collapsibleColumns() on Board (src/Concerns/HasColumnControls.php). A collapsed column draws as a rail with its dot, vertical title and count. A double-click on a column's empty space collapses it. Under collapse all, a single click on a rail opens every column, and a double-click opens only that one. Rails are keyboard buttons ("Expand :name", Enter and Space).
  • Header menu. columnHeaderMenu() lets a host render a block (for example a name field) above the column's actions. The menu opens over its column at the column's width, and its list scrolls inside the room left in the window.
  • Add column. addColumnUsing() plus label, placeholder, colors, default color and color-label setters. A dashed tile after the last column opens a ghost column with a name field and a color grid.
  • Swatch grid. One color-swatches component (radio group, arrow keys, Enter or Space, Escape back to the dot) for the add form and for hosts.
  • Icons. Every board icon resolves through Relaticle\Flowforge\View\FlowforgeIconAlias, so a host maps them with FilamentIcon::register(). The defaults stay Heroicons.
  • Tokens. New --ff-dot-size, --ff-overlay-radius and --ff-overlay-shadow, documented in the design system page (since 4.4.0).
  • Lanes. Lanes size per column so collapsed columns hold, and collapsed lane heads keep row height.
  • Cards. A title with no break points (a URL) wraps inside its box instead of running past the card's padding.
  • Dots. Hex colors draw exactly as stored; Color::hex() kept only the hue at shade 500.

Behavior to know about

  • Every Flowforge host gets the header menu placement, exact hex dots, empty-space collapse and the rail behaviour. Nothing else changes for a host that sets none of the new options.
  • Under collapse all, a single rail click waits 300ms to tell it from a double-click.
  • No config key, no migration. New lang keys in en, de, es and nl.

Tests

  • tests/Modern/Feature/{CollapsedColumnsTest,ColumnHeaderMenuTest,AddColumnTest,GroupingViewTest,ColumnLimitTest,DesignContractTest}.php: the board API, collapse state, menu block, add column validation and colors, lanes, tooltips and tokens.
  • tests/Browser/ModernBoardTest.php: collapse and expand with mouse and keyboard, double-click timing, menu placement and height, the ghost add column, swatch keyboard navigation (also in WebKit), and long card titles.

Checked

  • vendor/bin/pint --test clean.
  • vendor/bin/pest --no-coverage: 752 passed. tests/Browser/ModernBoardTest.php --browser safari: 68 passed.
  • PHPStan reports 10 errors, the same 10 as 4.x at 91dc5f118 (checked in a 4.x worktree with the same vendor). None come from this branch.
  • Used by feat(boards): manage stages from the board header, collapse, add and recolor relaticle#1201 (board stage controls), walked in Chromium and WebKit, light and dark, and at 390px.

Not checked

  • Hosts other than Relaticle. The fixtures in tests/Fixtures/Modern cover the opt-in paths.

Copilot AI balanced review requested due to automatic review settings November 15, 2026 11:48

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

@ManukMinasyan
ManukMinasyan merged commit 323e383 into 4.x Nov 15, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants