@toclocoinc/lattice-grid 1.111.4 → 1.111.5

package/CHANGELOG.md

@@ -9,6 +9,14 @@ and what it means for a grid already in production.
 
 ## [Unreleased]
 
+## [1.111.5] - 2026-10-22
+
+### Added
+
+- Kanban: `maxColumnWidth` caps a column's width in `columnWidth: 'fill'` mode. Expanded columns share the width equally, never below `minColumnWidth` and never above `maxColumnWidth`; when the capped columns do not fill the host the board keeps its natural width, left aligned, and when they do not fit it scrolls as before. Collapsed columns stay narrow strips and take no share. Default: no cap, so existing boards are unchanged.
+
+- Kanban: `board.setColumnWidth({ columnWidth, minColumnWidth, maxColumnWidth })` changes the fill-mode column-width range at runtime, re-flowing without a remount. A `minColumnWidth` above `maxColumnWidth` (at construction or at runtime) resolves to the minimum for both, with one warning (`kanban:min-max-column-width`).
+
 ## [1.111.4] - 2026-10-22
 
 ### Fixed

package/README.md

@@ -9,7 +9,7 @@ forms, lists, trees and an app shell.
 Zero runtime dependencies, with adapters for React, Vue, Svelte, Angular, Web
 Components and htmx. Free on localhost, licensed per domain to ship.
 
-Version 1.111.4 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
+Version 1.111.5 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
 
 ## Start
 

package/angular/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.111.4",
+  "version": "1.111.5",
   "type": "module",
   "sideEffects": false,
   "module": "./fesm2022/toclocoinc-lattice-grid-angular.mjs",

package/docs/API.html

@@ -382,7 +382,7 @@
 <div class="shell">
   <aside class="rail">
     <p class="rail__brand">Lattice Grid</p>
-    <p class="rail__sub">API reference · v1.111.4</p>
+    <p class="rail__sub">API reference · v1.111.5</p>
     <nav>
       <div class="rail__group">
         <span class="rail__label">Start</span>
@@ -592,7 +592,7 @@
     </header>
 
     <p class="chips">
-      <span class="chip">Version 1.111.4</span>
+      <span class="chip">Version 1.111.5</span>
       <span class="chip">Zero dependencies</span>
       <span class="chip"><a href="api-detail.html">Developer guide &rarr;</a></span>
     </p>
@@ -3515,7 +3515,7 @@ grid.destroy();
       <table>
         <thead><tr><th>Member</th><th>Returns</th><th>Description</th></tr></thead>
         <tbody>
-          <tr><td class="sig">getVersion()</td><td class="type">string</td><td class="desc">The version this grid came from, e.g. <code>'1.111.4'</code>. Also on the module as <code>getVersion()</code>, for when you have no grid to hand.</td></tr>
+          <tr><td class="sig">getVersion()</td><td class="type">string</td><td class="desc">The version this grid came from, e.g. <code>'1.111.5'</code>. Also on the module as <code>getVersion()</code>, for when you have no grid to hand.</td></tr>
           <tr><td class="sig">get(key)</td><td class="type">unknown</td><td class="desc">Read any configuration key.</td></tr>
           <tr><td class="sig">set(key, value)</td><td class="type">void</td><td class="desc">Write one key. Every key is live; nothing needs a rebuild.</td></tr>
           <tr><td class="sig">setAll(values)</td><td class="type">void</td><td class="desc">Write several in one pass. Emits one <code>config:changed</code> for the batch, not one per key.</td></tr>
@@ -14405,6 +14405,25 @@ plain.destroy();
 
 <span class="kw">return</span> [base.columnWidth, base.minColumnWidth, fixed.columnWidth, auto.columnWidth, wide.minColumnWidth].join(' | ');</code></pre>
 
+    <h3 id="kanban-max-column-width-example">Capping fill columns with maxColumnWidth, executed</h3>
+    <p class="section-note">With <code>columnWidth: 'fill'</code>, <code>maxColumnWidth</code> stops a few columns from
+    stretching across a wide host: each expanded column takes an equal share, never below <code>minColumnWidth</code>
+    and never above <code>maxColumnWidth</code>; a board that does not fill its host stays left aligned. Headless, run on every build.</p>
+    <pre data-run="js" data-expect="360 | 0" data-covers="export:createKanban config:KanbanConfig.maxColumnWidth"><code><span class="kw">const</span> { createKanban } = <span class="kw">await</span> import('../packages/modules/kanban/index.js');
+
+<span class="kw">const</span> capped = createKanban(null, {
+  rows: [], rowKey: 'id', columnProperty: 'status',
+  columns: [{ id: 'todo' }, { id: 'doing' }, { id: 'done' }],
+  columnWidth: 'fill', minColumnWidth: 260, maxColumnWidth: 360,
+});
+
+<span class="kw">const</span> plain = createKanban(null, {
+  rows: [], rowKey: 'id', columnProperty: 'status',
+  columns: [{ id: 'todo' }],
+});
+
+<span class="kw">return</span> [capped.maxColumnWidth, plain.maxColumnWidth].join(' | ');</code></pre>
+
     <h3 id="kanban-sprint-example">Sprint, backlog and epic rollup, executed</h3>
     <p class="section-note">A sprint view, the backlog, and an epic rollup with progress toward the done column —
     headless, run on every build.</p>
@@ -31274,7 +31293,8 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
           <tr><td class="name">selectable</td><td class="type">boolean</td><td class="desc">Whether card selection is enabled (default true). <small>(optional)</small></td></tr>
           <tr><td class="name">density</td><td class="type"><a href="#type-KanbanDensity">KanbanDensity</a> <small class="literals">'compact' | 'comfortable'</small></td><td class="desc">The card density (BACKLOG-0002107): `'compact'` tightens each card's padding and drops the subtitle; `'comfortable'` (the default) keeps the roomier card. <small>(optional)</small></td></tr>
           <tr><td class="name">columnWidth</td><td class="type"><a href="#type-KanbanColumnWidth">KanbanColumnWidth</a> <small class="literals">number | 'fill' | 'auto'</small></td><td class="desc">How wide each column is (BACKLOG-0002153). A number fixes the width in pixels; `'fill'` (the default) shares the board width equally between the columns, never below `minColumnWidth` — so a board whose columns fit fills its host, and one whose columns do not fit keeps them at the minimum and scrolls; `'auto'` keeps the natural fixed width from the `--lattice-board-column-width` token (default 280px). The CSS token, when set, still overrides the option. Collapsed columns stay narrow strips and the rest take the space; the fill follows host resizes. <small>(optional)</small></td></tr>
-          <tr><td class="name">minColumnWidth</td><td class="type">number</td><td class="desc">The pixel floor `'fill'` never drops a column below (default 240). <small>(optional)</small></td></tr>
+          <tr><td class="name">minColumnWidth</td><td class="type">number</td><td class="desc">The pixel floor `'fill'` never drops a column below (default 240), paired with `maxColumnWidth` as the range `'fill'` honours. Both are also changeable at runtime through `Kanban#setColumnWidth`. A `minColumnWidth` above `maxColumnWidth` resolves to the minimum for both (one warning). <small>(optional)</small></td></tr>
+          <tr><td class="name">maxColumnWidth</td><td class="type">number</td><td class="desc">The pixel ceiling for `'fill'` (BACKLOG-0005252; default none). Each expanded column takes an equal share of the width, never below `minColumnWidth` and never above `maxColumnWidth`. When the capped columns do not fill the host the board keeps its natural width, left aligned; when they do not fit it scrolls. Collapsed columns are excluded from the share. <small>(optional)</small></td></tr>
           <tr><td class="name">labels</td><td class="type">Record&lt;string, string&gt;</td><td class="desc">Host-localised words for the move announcements (grabbed/moved/dropped/reverted/cancelled). <small>(optional)</small></td></tr>
           <tr><td class="name">contextMenu</td><td class="type"><a href="#type-KanbanMenuItem">KanbanMenuItem</a>[] | ((card: <a href="#type-KanbanCard">KanbanCard</a>, selected: <a href="#type-KanbanCard">KanbanCard</a>[]) =&gt; <a href="#type-KanbanMenuItem">KanbanMenuItem</a>[])</td><td class="desc">A per-card context menu: items, or `fn(card, selectedCards)` returning items. Suppresses `card:contextmenu`. <small>(optional)</small></td></tr>
         </tbody>
@@ -31832,6 +31852,7 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
           <tr><td class="name">sourceBound</td><td class="type">boolean</td><td class="desc">Whether the board is bound to a pushdown source and owns its own paged data path (BACKLOG-0002104): counts/sums from an engine GROUP BY, cards fetched per column page, moves written through the source. <small>(read-only)</small></td></tr>
           <tr><td class="name">columnWidth</td><td class="type"><a href="#type-KanbanColumnWidth">KanbanColumnWidth</a> <small class="literals">number | 'fill' | 'auto'</small></td><td class="desc">The resolved column-width mode (BACKLOG-0002153); see {@link KanbanConfig.columnWidth}. <small>(read-only)</small></td></tr>
           <tr><td class="name">minColumnWidth</td><td class="type">number</td><td class="desc">The resolved minimum column width in px (BACKLOG-0002153); see {@link KanbanConfig.minColumnWidth}. <small>(read-only)</small></td></tr>
+          <tr><td class="name">maxColumnWidth</td><td class="type">number</td><td class="desc">The resolved maximum column width in px, `0` for none (BACKLOG-0005252); see {@link KanbanConfig.maxColumnWidth}. <small>(read-only)</small></td></tr>
           <tr><td class="name">filters</td><td class="type"><a href="#type-KanbanFilters">KanbanFilters</a></td><td class="desc">Named card predicates, composed with AND (BACKLOG-0001229). See {@link KanbanFilters}.</td></tr>
           <tr><td class="name">BACKLOG</td><td class="type">unknown</td><td class="desc">The sentinel `setSprint` value that selects the backlog (cards with no sprint). <small>(read-only)</small></td></tr>
         </tbody>
@@ -31893,6 +31914,7 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
           <tr><td class="name">setError</td><td class="type">(message: string | null): <a href="#type-Kanban">Kanban</a></td><td class="desc"><code>message: string | null</code></td><td class="type"><code><a href="#type-Kanban">Kanban</a></code></td><td class="desc">Set (or clear with null) an error state, rendered as a host-supplied message.</td></tr>
           <tr><td class="name">setRows</td><td class="type">(rows: <a href="#type-KanbanRow">KanbanRow</a>[]): <a href="#type-Kanban">Kanban</a></td><td class="desc"><code>rows: <a href="#type-KanbanRow">KanbanRow</a>[]</code></td><td class="type"><code><a href="#type-Kanban">Kanban</a></code></td><td class="desc">Replace the source rows and re-render, and make that array the board's source again so a later `refresh()` re-reads it. Ignored with a warning on a grid-bound board.</td></tr>
           <tr><td class="name">setColumns</td><td class="type">(defs: <a href="#type-KanbanColumnDef">KanbanColumnDef</a>[]): <a href="#type-Kanban">Kanban</a></td><td class="desc"><code>defs: <a href="#type-KanbanColumnDef">KanbanColumnDef</a>[]</code></td><td class="type"><code><a href="#type-Kanban">Kanban</a></code></td><td class="desc">Replace the board's configured column set (BACKLOG-0001228). Keeps card placement and interaction state (collapsed columns, column order, quick filter, selection) for every column id that survives; a dropped id is not specially handled — a card whose value has nowhere configured to go re-derives an ad hoc column rather than becoming `unplaced` (the same "never silently drop a card" rule an unconfigured value already gets).</td></tr>
+          <tr><td class="name">setColumnWidth</td><td class="type">(opts?: { columnWidth?: <a href="#type-KanbanColumnWidth">KanbanColumnWidth</a>; minColumnWidth?: number; maxColumnWidth?: number; }): <a href="#type-Kanban">Kanban</a></td><td class="desc"><code>opts?: { columnWidth?: <a href="#type-KanbanColumnWidth">KanbanColumnWidth</a>; minColumnWidth?: number; maxColumnWidth?: number; }</code></td><td class="type"><code><a href="#type-Kanban">Kanban</a></code></td><td class="desc">Change `columnWidth`/`minColumnWidth`/`maxColumnWidth` at runtime (BACKLOG-0005252): a partial options object, each key left at its current value when omitted. Re-flows the fill-mode CSS variables in place — no remount, so scroll, focus, selection and an open pop-out survive. A `minColumnWidth` above `maxColumnWidth` resolves to the minimum for both, with one warning.</td></tr>
           <tr><td class="name">refresh</td><td class="type">(): <a href="#type-Kanban">Kanban</a></td><td class="desc">&mdash;</td><td class="type"><code><a href="#type-Kanban">Kanban</a></code></td><td class="desc">Re-read the source and re-render: a bound grid's rows, or the configured array. Once rows have arrived through `rows.apply` nothing is re-read — the board regroups what it holds, so a routed feed is never thrown away.</td></tr>
           <tr><td class="name">reload</td><td class="type">(): Promise&lt;<a href="#type-Kanban">Kanban</a>&gt;</td><td class="desc">&mdash;</td><td class="type"><code>Promise&lt;<a href="#type-Kanban">Kanban</a>&gt;</code></td><td class="desc">Reload a source-bound board from its pushdown source (BACKLOG-0002104): drop the loaded pages and re-query the engine's column counts/sums, then fetch the first page of every column. On a client-side board this is `refresh()`. Called automatically at construction and after a search or filter change.</td></tr>
           <tr><td class="name">loadMore</td><td class="type">(columnId: string, laneId?: string): Promise&lt;boolean&gt;</td><td class="desc"><code>columnId: string</code><br><code>laneId?: string</code></td><td class="type"><code>Promise&lt;boolean&gt;</code></td><td class="desc">Fetch the next page of cards for a column (and, in swimlane mode, a lane) on a source-bound board (BACKLOG-0002104). The column scroll hook calls this as the user nears the bottom; a no-op resolving `false` when the board is not source-bound, the column is exhausted, or a page is in flight.</td></tr>
@@ -43337,7 +43359,7 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
 <!-- END GENERATED TYPE REFERENCE -->
 
     <footer>
-      Lattice Grid 1.111.4 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
+      Lattice Grid 1.111.5 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
       This document describes the behaviour of the shipped library. Where this guide and the code
       disagree, the code wins: please <a href="https://www.latticegrid.dev">tell us</a>.
     </footer>

package/docs/api/adapters.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Adapters API Reference — Lattice Grid 1.111.4</title>
+<title>Adapters API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/ai.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>AI API Reference — Lattice Grid 1.111.4</title>
+<title>AI API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/alarms.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Alarms API Reference — Lattice Grid 1.111.4</title>
+<title>Alarms API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/calendar.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Calendar API Reference — Lattice Grid 1.111.4</title>
+<title>Calendar API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/charts.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Charts API Reference — Lattice Grid 1.111.4</title>
+<title>Charts API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/dashboard.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Dashboard API Reference — Lattice Grid 1.111.4</title>
+<title>Dashboard API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/data-router.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Data router API Reference — Lattice Grid 1.111.4</title>
+<title>Data router API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/dataview.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Data view API Reference — Lattice Grid 1.111.4</title>
+<title>Data view API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/deckgl.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>deck.gl API Reference — Lattice Grid 1.111.4</title>
+<title>deck.gl API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/designer.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Designer API Reference — Lattice Grid 1.111.4</title>
+<title>Designer API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/form.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Form API Reference — Lattice Grid 1.111.4</title>
+<title>Form API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/gantt.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Gantt API Reference — Lattice Grid 1.111.4</title>
+<title>Gantt API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/geometry.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Geometry API Reference — Lattice Grid 1.111.4</title>
+<title>Geometry API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/grid.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Grid API Reference — Lattice Grid 1.111.4</title>
+<title>Grid API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an
@@ -1925,7 +1925,7 @@ grid.destroy();
       <table>
         <thead><tr><th>Member</th><th>Returns</th><th>Description</th></tr></thead>
         <tbody>
-          <tr><td class="sig">getVersion()</td><td class="type">string</td><td class="desc">The version this grid came from, e.g. <code>'1.111.4'</code>. Also on the module as <code>getVersion()</code>, for when you have no grid to hand.</td></tr>
+          <tr><td class="sig">getVersion()</td><td class="type">string</td><td class="desc">The version this grid came from, e.g. <code>'1.111.5'</code>. Also on the module as <code>getVersion()</code>, for when you have no grid to hand.</td></tr>
           <tr><td class="sig">get(key)</td><td class="type">unknown</td><td class="desc">Read any configuration key.</td></tr>
           <tr><td class="sig">set(key, value)</td><td class="type">void</td><td class="desc">Write one key. Every key is live; nothing needs a rebuild.</td></tr>
           <tr><td class="sig">setAll(values)</td><td class="type">void</td><td class="desc">Write several in one pass. Emits one <code>config:changed</code> for the batch, not one per key.</td></tr>

package/docs/api/index.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>API Reference — Lattice Grid 1.111.4</title>
+<title>API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an
@@ -454,7 +454,7 @@
           <tr><td class="name"><a href="listview.html">The list view module</a></td><td class="desc"><code>createList</code>: a standalone, template-driven list over a real Lattice grid &mdash; selection, drag-and-drop reorder/move/copy between lists, and a data API.</td><td class="type">1</td><td class="type">15</td><td class="type">91</td></tr>
           <tr><td class="name"><a href="dataview.html">The data view module</a></td><td class="desc"><code>createDataView</code>: items laid out as template-drawn cards that wrap into rows &mdash; selection, two-dimensional keyboard navigation, drag to reorder, and drag between data views and list views.</td><td class="type">1</td><td class="type">17</td><td class="type">94</td></tr>
           <tr><td class="name"><a href="tree.html">The tree module</a></td><td class="desc"><code>createTree</code>: a standalone tree over a real Lattice grid &mdash; expand, select, tri-state checkboxes and drag to reparent.</td><td class="type">1</td><td class="type">10</td><td class="type">68</td></tr>
-          <tr><td class="name"><a href="kanban.html">The board (kanban) view</a></td><td class="desc"><code>createKanban</code>: columns from any status property, drag or keyboard moves that write back, swimlanes, sprints, epics and the child grid.</td><td class="type">1</td><td class="type">50</td><td class="type">384</td></tr>
+          <tr><td class="name"><a href="kanban.html">The board (kanban) view</a></td><td class="desc"><code>createKanban</code>: columns from any status property, drag or keyboard moves that write back, swimlanes, sprints, epics and the child grid.</td><td class="type">1</td><td class="type">50</td><td class="type">387</td></tr>
           <tr><td class="name"><a href="gantt.html">The Gantt module</a></td><td class="desc"><code>createGantt</code>: the scheduling engine and the critical path, the four dependency links, milestones and summaries, and editable bars.</td><td class="type">1</td><td class="type">131</td><td class="type">891</td></tr>
           <tr><td class="name"><a href="calendar.html">The calendar viewer</a></td><td class="desc"><code>createCalendar</code>: a month grid and a week day-grid of rows as cards, keyed by a date field, with navigation, overflow and the viewer contract.</td><td class="type">1</td><td class="type">11</td><td class="type">91</td></tr>
           <tr><td class="name"><a href="scheduler.html">The resource scheduler</a></td><td class="desc"><code>createScheduler</code>: resources as rows in a left grid and events as bars on a shared time axis, with the Gantt's zoom scale, per-resource calendars and virtualised rows and time.</td><td class="type">1</td><td class="type">14</td><td class="type">105</td></tr>

package/docs/api/kanban.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Kanban API Reference — Lattice Grid 1.111.4</title>
+<title>Kanban API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an
@@ -396,6 +396,7 @@
         <a class="rail__sub-link" href="#kanban-card-parts-example">Richer card parts, executed</a>
         <a class="rail__sub-link" href="#kanban-tone-example">Label and badge tones, and a due format, executed</a>
         <a class="rail__sub-link" href="#kanban-column-width-example">Column width, executed</a>
+        <a class="rail__sub-link" href="#kanban-max-column-width-example">Capping fill columns with maxColumnWidth, executed</a>
         <a class="rail__sub-link" href="#kanban-sprint-example">Sprint, backlog and epic rollup, executed</a>
         <a class="rail__sub-link" href="#kanban-live-example">Live, driven by a Data Router, executed</a>
         <a class="rail__sub-link" href="#kanban-rebind-example">Re-bound to a replacement grid, executed</a>
@@ -795,6 +796,25 @@ plain.destroy();
 
 <span class="kw">return</span> [base.columnWidth, base.minColumnWidth, fixed.columnWidth, auto.columnWidth, wide.minColumnWidth].join(' | ');</code></pre>
 
+    <h3 id="kanban-max-column-width-example">Capping fill columns with maxColumnWidth, executed</h3>
+    <p class="section-note">With <code>columnWidth: 'fill'</code>, <code>maxColumnWidth</code> stops a few columns from
+    stretching across a wide host: each expanded column takes an equal share, never below <code>minColumnWidth</code>
+    and never above <code>maxColumnWidth</code>; a board that does not fill its host stays left aligned. Headless, run on every build.</p>
+    <pre data-run="js" data-expect="360 | 0" data-covers="export:createKanban config:KanbanConfig.maxColumnWidth"><code><span class="kw">const</span> { createKanban } = <span class="kw">await</span> import('../packages/modules/kanban/index.js');
+
+<span class="kw">const</span> capped = createKanban(null, {
+  rows: [], rowKey: 'id', columnProperty: 'status',
+  columns: [{ id: 'todo' }, { id: 'doing' }, { id: 'done' }],
+  columnWidth: 'fill', minColumnWidth: 260, maxColumnWidth: 360,
+});
+
+<span class="kw">const</span> plain = createKanban(null, {
+  rows: [], rowKey: 'id', columnProperty: 'status',
+  columns: [{ id: 'todo' }],
+});
+
+<span class="kw">return</span> [capped.maxColumnWidth, plain.maxColumnWidth].join(' | ');</code></pre>
+
     <h3 id="kanban-sprint-example">Sprint, backlog and epic rollup, executed</h3>
     <p class="section-note">A sprint view, the backlog, and an epic rollup with progress toward the done column —
     headless, run on every build.</p>
@@ -1273,7 +1293,8 @@ board.destroy();
           <tr><td class="name">selectable</td><td class="type">boolean</td><td class="desc">Whether card selection is enabled (default true). <small>(optional)</small></td></tr>
           <tr><td class="name">density</td><td class="type"><a href="types.html#type-KanbanDensity">KanbanDensity</a> <small class="literals">'compact' | 'comfortable'</small></td><td class="desc">The card density (BACKLOG-0002107): `'compact'` tightens each card's padding and drops the subtitle; `'comfortable'` (the default) keeps the roomier card. <small>(optional)</small></td></tr>
           <tr><td class="name">columnWidth</td><td class="type"><a href="types.html#type-KanbanColumnWidth">KanbanColumnWidth</a> <small class="literals">number | 'fill' | 'auto'</small></td><td class="desc">How wide each column is (BACKLOG-0002153). A number fixes the width in pixels; `'fill'` (the default) shares the board width equally between the columns, never below `minColumnWidth` — so a board whose columns fit fills its host, and one whose columns do not fit keeps them at the minimum and scrolls; `'auto'` keeps the natural fixed width from the `--lattice-board-column-width` token (default 280px). The CSS token, when set, still overrides the option. Collapsed columns stay narrow strips and the rest take the space; the fill follows host resizes. <small>(optional)</small></td></tr>
-          <tr><td class="name">minColumnWidth</td><td class="type">number</td><td class="desc">The pixel floor `'fill'` never drops a column below (default 240). <small>(optional)</small></td></tr>
+          <tr><td class="name">minColumnWidth</td><td class="type">number</td><td class="desc">The pixel floor `'fill'` never drops a column below (default 240), paired with `maxColumnWidth` as the range `'fill'` honours. Both are also changeable at runtime through `Kanban#setColumnWidth`. A `minColumnWidth` above `maxColumnWidth` resolves to the minimum for both (one warning). <small>(optional)</small></td></tr>
+          <tr><td class="name">maxColumnWidth</td><td class="type">number</td><td class="desc">The pixel ceiling for `'fill'` (BACKLOG-0005252; default none). Each expanded column takes an equal share of the width, never below `minColumnWidth` and never above `maxColumnWidth`. When the capped columns do not fill the host the board keeps its natural width, left aligned; when they do not fit it scrolls. Collapsed columns are excluded from the share. <small>(optional)</small></td></tr>
           <tr><td class="name">labels</td><td class="type">Record&lt;string, string&gt;</td><td class="desc">Host-localised words for the move announcements (grabbed/moved/dropped/reverted/cancelled). <small>(optional)</small></td></tr>
           <tr><td class="name">contextMenu</td><td class="type"><a href="#type-KanbanMenuItem">KanbanMenuItem</a>[] | ((card: <a href="#type-KanbanCard">KanbanCard</a>, selected: <a href="#type-KanbanCard">KanbanCard</a>[]) =&gt; <a href="#type-KanbanMenuItem">KanbanMenuItem</a>[])</td><td class="desc">A per-card context menu: items, or `fn(card, selectedCards)` returning items. Suppresses `card:contextmenu`. <small>(optional)</small></td></tr>
         </tbody>
@@ -1831,6 +1852,7 @@ board.destroy();
           <tr><td class="name">sourceBound</td><td class="type">boolean</td><td class="desc">Whether the board is bound to a pushdown source and owns its own paged data path (BACKLOG-0002104): counts/sums from an engine GROUP BY, cards fetched per column page, moves written through the source. <small>(read-only)</small></td></tr>
           <tr><td class="name">columnWidth</td><td class="type"><a href="types.html#type-KanbanColumnWidth">KanbanColumnWidth</a> <small class="literals">number | 'fill' | 'auto'</small></td><td class="desc">The resolved column-width mode (BACKLOG-0002153); see {@link KanbanConfig.columnWidth}. <small>(read-only)</small></td></tr>
           <tr><td class="name">minColumnWidth</td><td class="type">number</td><td class="desc">The resolved minimum column width in px (BACKLOG-0002153); see {@link KanbanConfig.minColumnWidth}. <small>(read-only)</small></td></tr>
+          <tr><td class="name">maxColumnWidth</td><td class="type">number</td><td class="desc">The resolved maximum column width in px, `0` for none (BACKLOG-0005252); see {@link KanbanConfig.maxColumnWidth}. <small>(read-only)</small></td></tr>
           <tr><td class="name">filters</td><td class="type"><a href="#type-KanbanFilters">KanbanFilters</a></td><td class="desc">Named card predicates, composed with AND (BACKLOG-0001229). See {@link KanbanFilters}.</td></tr>
           <tr><td class="name">BACKLOG</td><td class="type">unknown</td><td class="desc">The sentinel `setSprint` value that selects the backlog (cards with no sprint). <small>(read-only)</small></td></tr>
         </tbody>
@@ -1892,6 +1914,7 @@ board.destroy();
           <tr><td class="name">setError</td><td class="type">(message: string | null): <a href="#type-Kanban">Kanban</a></td><td class="desc"><code>message: string | null</code></td><td class="type"><code><a href="#type-Kanban">Kanban</a></code></td><td class="desc">Set (or clear with null) an error state, rendered as a host-supplied message.</td></tr>
           <tr><td class="name">setRows</td><td class="type">(rows: <a href="types.html#type-KanbanRow">KanbanRow</a>[]): <a href="#type-Kanban">Kanban</a></td><td class="desc"><code>rows: <a href="types.html#type-KanbanRow">KanbanRow</a>[]</code></td><td class="type"><code><a href="#type-Kanban">Kanban</a></code></td><td class="desc">Replace the source rows and re-render, and make that array the board's source again so a later `refresh()` re-reads it. Ignored with a warning on a grid-bound board.</td></tr>
           <tr><td class="name">setColumns</td><td class="type">(defs: <a href="types.html#type-KanbanColumnDef">KanbanColumnDef</a>[]): <a href="#type-Kanban">Kanban</a></td><td class="desc"><code>defs: <a href="types.html#type-KanbanColumnDef">KanbanColumnDef</a>[]</code></td><td class="type"><code><a href="#type-Kanban">Kanban</a></code></td><td class="desc">Replace the board's configured column set (BACKLOG-0001228). Keeps card placement and interaction state (collapsed columns, column order, quick filter, selection) for every column id that survives; a dropped id is not specially handled — a card whose value has nowhere configured to go re-derives an ad hoc column rather than becoming `unplaced` (the same "never silently drop a card" rule an unconfigured value already gets).</td></tr>
+          <tr><td class="name">setColumnWidth</td><td class="type">(opts?: { columnWidth?: <a href="types.html#type-KanbanColumnWidth">KanbanColumnWidth</a>; minColumnWidth?: number; maxColumnWidth?: number; }): <a href="#type-Kanban">Kanban</a></td><td class="desc"><code>opts?: { columnWidth?: <a href="types.html#type-KanbanColumnWidth">KanbanColumnWidth</a>; minColumnWidth?: number; maxColumnWidth?: number; }</code></td><td class="type"><code><a href="#type-Kanban">Kanban</a></code></td><td class="desc">Change `columnWidth`/`minColumnWidth`/`maxColumnWidth` at runtime (BACKLOG-0005252): a partial options object, each key left at its current value when omitted. Re-flows the fill-mode CSS variables in place — no remount, so scroll, focus, selection and an open pop-out survive. A `minColumnWidth` above `maxColumnWidth` resolves to the minimum for both, with one warning.</td></tr>
           <tr><td class="name">refresh</td><td class="type">(): <a href="#type-Kanban">Kanban</a></td><td class="desc">&mdash;</td><td class="type"><code><a href="#type-Kanban">Kanban</a></code></td><td class="desc">Re-read the source and re-render: a bound grid's rows, or the configured array. Once rows have arrived through `rows.apply` nothing is re-read — the board regroups what it holds, so a routed feed is never thrown away.</td></tr>
           <tr><td class="name">reload</td><td class="type">(): Promise&lt;<a href="#type-Kanban">Kanban</a>&gt;</td><td class="desc">&mdash;</td><td class="type"><code>Promise&lt;<a href="#type-Kanban">Kanban</a>&gt;</code></td><td class="desc">Reload a source-bound board from its pushdown source (BACKLOG-0002104): drop the loaded pages and re-query the engine's column counts/sums, then fetch the first page of every column. On a client-side board this is `refresh()`. Called automatically at construction and after a search or filter change.</td></tr>
           <tr><td class="name">loadMore</td><td class="type">(columnId: string, laneId?: string): Promise&lt;boolean&gt;</td><td class="desc"><code>columnId: string</code><br><code>laneId?: string</code></td><td class="type"><code>Promise&lt;boolean&gt;</code></td><td class="desc">Fetch the next page of cards for a column (and, in swimlane mode, a lane) on a source-bound board (BACKLOG-0002104). The column scroll hook calls this as the user nears the bottom; a no-op resolving `false` when the board is not source-bound, the column is exhausted, or a page is in flight.</td></tr>

package/docs/api/kpi.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>KPI API Reference — Lattice Grid 1.111.4</title>
+<title>KPI API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/layout.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Layout API Reference — Lattice Grid 1.111.4</title>
+<title>Layout API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/leaflet.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Leaflet API Reference — Lattice Grid 1.111.4</title>
+<title>Leaflet API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/list.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>List API Reference — Lattice Grid 1.111.4</title>
+<title>List API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/listview.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>List view API Reference — Lattice Grid 1.111.4</title>
+<title>List view API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/mapview.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Map view API Reference — Lattice Grid 1.111.4</title>
+<title>Map view API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/mock-socket.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Mock socket API Reference — Lattice Grid 1.111.4</title>
+<title>Mock socket API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/presets.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Presets API Reference — Lattice Grid 1.111.4</title>
+<title>Presets API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/scheduler.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Scheduler API Reference — Lattice Grid 1.111.4</title>
+<title>Scheduler API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/shell.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Shell API Reference — Lattice Grid 1.111.4</title>
+<title>Shell API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/tabs.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Tabs API Reference — Lattice Grid 1.111.4</title>
+<title>Tabs API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/tree.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Tree API Reference — Lattice Grid 1.111.4</title>
+<title>Tree API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

package/docs/api/types.html

@@ -13,7 +13,7 @@
   Self-contained: no stylesheet, script or font is fetched, so this opens from disk, from
   a file share or from behind a firewall with nothing else present.
 -->
-<title>Types API Reference — Lattice Grid 1.111.4</title>
+<title>Types API Reference — Lattice Grid 1.111.5</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an