@toclocoinc/lattice-grid 1.98.1 → 1.98.2

package/CHANGELOG.md

@@ -9,6 +9,17 @@ and what it means for a grid already in production.
 
 ## [Unreleased]
 
+## [1.98.2] - 2026-10-10
+
+### Fixed
+
+- **The scheduler's resource pane keeps person names readable when resources are grouped** (BACKLOG-0002163). Grouping by team used a fixed 240px group column inside a fixed 300px pane, squeezing the person column down to a mid-word clip; the pane's width is now the documented `resourceWidth` option (default 300px) behind a draggable, keyboard-operable divider, and the group column honours its own column-width setting — or the 120px synthesised default — so every name stays fully visible, or ellipsises with the full name as its native title when the column is too narrow.
+  - `resourceWidth` sets the pane at mount, `setResourceWidth(px)` resizes it programmatically, and the divider is a `role="separator"` you can drag or arrow through (8px, or 32px with Shift), clamped to the pane's range and announcing its value to screen readers.
+  - The width is carried by `getState()`/`setState(state)` alongside the zoom and scroll.
+
+- **The scheduler's time-axis labels never overlap or clip, at any pixels-per-day** (BACKLOG-0002164). The day preset's 26px columns were narrower than the "Sun 4" labels painted on them, so neighbouring labels ran together; a bare px-per-day crossing the 18px mark into per-day labels collided the same way, and a whole-plan "Fit" topped out at 17px/day and could not fill a 1920px screen. The axis now picks a label granularity and format that fit the tightest column — shorter day names, every nth day, or week/month labels — and drops the one label that would run past the axis's right edge, so every zoom preset is legible in the stock theme at 1440 and 1920.
+  - `zoom: 'fit'` is a new preset that sizes the pixels-per-day to the timeline's width, so a plan's span fills it edge-to-edge; `getZoom()`, `getState()` and `zoom:change` report `'fit'` as the level.
+
 ## [1.98.1] - 2026-10-10
 
 ### Fixed

package/README.md

@@ -5,7 +5,7 @@ dependencies, no build step required. Optional adapters for React, Vue, Svelte
 and Web Components ship alongside it, and Angular has compiled components of its
 own at `@toclocoinc/lattice-grid/angular` — inside this package, not beside it.
 
-Version 1.98.1 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
+Version 1.98.2 · [latticegrid.dev](https://www.latticegrid.dev) · TOCLOCO Inc
 
 ---
 

package/angular/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.98.1",
+  "version": "1.98.2",
   "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.98.1</p>
+    <p class="rail__sub">API reference · v1.98.2</p>
     <nav>
       <div class="rail__group">
         <span class="rail__label">Start</span>
@@ -578,7 +578,7 @@
     </header>
 
     <p class="chips">
-      <span class="chip">Version 1.98.1</span>
+      <span class="chip">Version 1.98.2</span>
       <span class="chip">Zero dependencies</span>
       <span class="chip"><a href="api-detail.html">Developer guide &rarr;</a></span>
     </p>
@@ -3458,7 +3458,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.98.1'</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.98.2'</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>
@@ -14389,11 +14389,13 @@ const scheduler = createScheduler(document.querySelector('#scheduler'), {
   resources: [{ id: 'alice', name: 'Alice', role: 'Design', capacity: 4 }],
   events: [{ id: 1, resourceId: 'alice', name: 'Review', startDate: '2026-03-02 09:00', endDate: '2026-03-02 11:00' }],
   createGrid,                   // the page's own grid factory (injected, never bundled)
-  zoom: 'day',                  // 'hour' | 'day' | 'week' | 'month' | 'quarter' | px-per-day
+  zoom: 'day',                  // 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'fit' | px-per-day
+  resourceWidth: 320,           // the left resource pane's width in px (drag its divider, or setResourceWidth)
   fields: { resourceId: 'resourceId', startDate: 'startDate', endDate: 'endDate', name: 'name' },
 });</code></pre>
-    <p>The time axis reuses the Gantt's own zoom scale — <code>hour</code>, <code>day</code>, <code>week</code>, <code>month</code> and <code>quarter</code> presets, or a bare pixels-per-day number — with pointer-wheel (Ctrl+wheel) and keyboard (+/&minus;) zoom and arrow-key scrolling. A <code>todayLine</code> marks today, and with <code>nonWorking</code> (default on) each resource's own calendar shades its non-working days exactly as the Gantt shades them: a <code>'weekends'</code> string, a <code>{ workdays, holidays }</code> spec, or a name looked up in <code>calendars</code>. Overlapping events in one resource stack into sub-lanes, so a two-hour review never hides the sketch behind it. Rows and time are both virtualised — only the rows and days under the viewport (plus <code>overscan</code>) create DOM, so 500 resources &times; 20 000 events stays bounded and scrollable. An event whose start cannot be read is counted in <code>unscheduled</code> and reported once, never thrown. With <code>workload: true</code>, each row also draws a histogram band across the bottom of the time axis — one cell per zoom bucket whose fill height is the booked share of the resource's own capacity, computed by the Gantt's <code>computeWorkload</code> against the resource's own calendar and capacity. An over-allocated bucket is highlighted with the theme's danger tokens <em>and</em> a warning glyph (never colour alone), and named resource-by-resource with its periods in an accessible live-region summary, which re-derives live when <code>setEvents(events)</code> replaces the feed. Pass <code>null</code> for the element and the same model answers headlessly.</p>
+    <p>The time axis reuses the Gantt's own zoom scale — <code>hour</code>, <code>day</code>, <code>week</code>, <code>month</code> and <code>quarter</code> presets, a bare pixels-per-day number, or <code>'fit'</code> to size the pixels-per-day to the timeline's width so the plan fills it — with pointer-wheel (Ctrl+wheel) and keyboard (+/&minus;) zoom and arrow-key scrolling. Whatever the pixels-per-day, the axis picks a label granularity and format that fit (BACKLOG-0002164): shorter day names, every nth day, or week/month labels, so no two labels overlap and none is clipped at any scale. A <code>todayLine</code> marks today, and with <code>nonWorking</code> (default on) each resource's own calendar shades its non-working days exactly as the Gantt shades them: a <code>'weekends'</code> string, a <code>{ workdays, holidays }</code> spec, or a name looked up in <code>calendars</code>. Overlapping events in one resource stack into sub-lanes, so a two-hour review never hides the sketch behind it. Rows and time are both virtualised — only the rows and days under the viewport (plus <code>overscan</code>) create DOM, so 500 resources &times; 20 000 events stays bounded and scrollable. An event whose start cannot be read is counted in <code>unscheduled</code> and reported once, never thrown. With <code>workload: true</code>, each row also draws a histogram band across the bottom of the time axis — one cell per zoom bucket whose fill height is the booked share of the resource's own capacity, computed by the Gantt's <code>computeWorkload</code> against the resource's own calendar and capacity. An over-allocated bucket is highlighted with the theme's danger tokens <em>and</em> a warning glyph (never colour alone), and named resource-by-resource with its periods in an accessible live-region summary, which re-derives live when <code>setEvents(events)</code> replaces the feed. Pass <code>null</code> for the element and the same model answers headlessly.</p>
     <p><strong>Find and read the plan.</strong> A <code>groupBy</code> — a field name or a per-resource function — groups the resources into collapsible group rows, driven by the left grid's own grouping so the two panes can never disagree; the timeline mirrors the grid's expand/collapse state, and a toggle in either pane collapses the other. A <code>search</code> query narrows both sides at once, matching any string or number field of a resource or event (a row stays when its own text <em>or</em> one of its events' text matches, so a match never orphans its bar). A <code>resourceFilter</code> hides rows, an <code>eventFilter</code> hides bars, and each takes a predicate a row must pass. The Gantt's tooltip card — the same card its bars show — opens on an event's hover and keyboard focus with its start, end, duration and resource. Every bar, row, group header and the time axis is named for screen readers, and the keyboard alone reaches every event: the arrow keys walk between events and rows (roving focus), Enter activates, Home/End jump a row's ends, and +/&minus; zoom — so the scheduler passes the same accessibility audit the grid does.</p>
+    <p><strong>Resize the resource pane</strong> (BACKLOG-0002163). The left resource table's width is the documented <code>resourceWidth</code> option (default 300px). A draggable, keyboard-operable divider between the pane and the time axis resizes it live — drag the handle, or focus it and press the arrow keys (8px, or 32px with Shift) — clamped between a floor and the time axis's minimum share, and the handle is a <code>role="separator"</code> that announces its value to screen readers. The width is carried by <code>getState()</code>/<code>setState(state)</code> alongside the zoom and scroll, and <code>setResourceWidth(px)</code> sets it programmatically. When the resources are grouped, the group column adopts its own column width (or the 120px synthesised default) instead of a fixed width, so every person's name stays fully visible — or, where a column is too narrow, ellipsises with the full name as its native title, never a mid-word clip.</p>
     <p><strong>Events are editable</strong> (BACKLOG-0002124): drag a bar to move it in time, drop it onto another resource row to reassign it, drag either edge to resize it, drag over empty time in a row to create an event, and press Delete (or use the right-click menu) to delete one. Every change snaps to the zoom step, writes back through <code>events.apply</code> &mdash; so a bound dataset sees it exactly as it sees a grid edit &mdash; and is one undo step: <code>undo()</code>/<code>redo()</code> or Ctrl/Cmd+Z / Ctrl/Cmd+Shift+Z. Each change raises the one cancellable <code>beforeEventChange</code> (call <code>preventDefault()</code> to refuse it, data untouched) and then one <code>event:change</code> carrying the event id and the old and new values. <code>editable: false</code> switches editing off; an event or a resource marked <code>readOnly: true</code> &mdash; or named by <code>readOnlyWhen</code>/<code>resourceReadOnlyWhen</code> &mdash; refuses the gesture with a catalogued reason.</p>
     <div class="table-wrap">
       <table>
@@ -14402,7 +14404,7 @@ const scheduler = createScheduler(document.querySelector('#scheduler'), {
           <tr><td class="sig">createScheduler(el, config)</td><td class="desc">Create a scheduler. Pass a DOM element to render into, or <code>null</code> for a headless scheduler that computes the same placement and axis model.</td></tr>
           <tr><td class="sig">rows.apply({ add, update, remove }) / rows.forEach / rows.count / rows.get(key)</td><td class="desc">The keyed-diff consumer contract over the resources (the left grid's rows), keyed by <code>resourceKey</code>.</td></tr>
           <tr><td class="sig">events.apply({ add, update, remove }) / events.forEach / events.count / events.get(key)</td><td class="desc">The same keyed-diff contract over the events, keyed by <code>eventKey</code>.</td></tr>
-          <tr><td class="sig">setZoom('hour'|'day'|'week'|'month'|'quarter'|number) / getZoom()</td><td class="desc">Change the axis scale, re-render and fire <code>zoom:change</code>; a bare number is pixels-per-day and picks the tick level that reads best at that density.</td></tr>
+          <tr><td class="sig">setZoom('hour'|'day'|'week'|'month'|'quarter'|'fit'|number) / getZoom()</td><td class="desc">Change the axis scale, re-render and fire <code>zoom:change</code>; a bare number is pixels-per-day and picks the tick level that reads best at that density, and <code>'fit'</code> sizes the pixels-per-day so the plan fills the timeline width.</td></tr>
           <tr><td class="sig">groupBy / setGroupBy(field | (resource) =&gt; value)</td><td class="desc">Group the resources into collapsible group rows by a field name or function; <code>null</code> is flat. The left grid does the grouping and the timeline mirrors its collapse state.</td></tr>
           <tr><td class="sig">search / setSearch(query)</td><td class="desc">A case-insensitive query that narrows both the resource rows and the event bars, matching any string or number field (a row stays when one of its events matches).</td></tr>
           <tr><td class="sig">resourceFilter / setResourceFilter(fn)</td><td class="desc">A predicate a resource must pass to stay visible; <code>null</code> clears it.</td></tr>
@@ -14416,7 +14418,8 @@ const scheduler = createScheduler(document.querySelector('#scheduler'), {
           <tr><td class="sig">edit.move(key, deltaDays) / edit.reassign(key, resourceKey) / edit.resize(key, edge, day) / edit.create(resourceKey, startDay, endDay) / edit.remove(key)</td><td class="desc">The editing controller: move in time, reassign to a row, resize one edge, create and delete &mdash; each one undo step and one <code>event:change</code>, refused on a read-only event or resource.</td></tr>
           <tr><td class="sig">undo() / redo() / canUndo() / canRedo()</td><td class="desc">Step the edit history back and forth (Ctrl/Cmd+Z and Ctrl/Cmd+Shift+Z from the keyboard do the same).</td></tr>
           <tr><td class="sig">reassign(key, resourceId)</td><td class="desc">Move an event to another resource row and fire <code>change</code>; returns false for an unknown key or an unchanged resource.</td></tr>
-          <tr><td class="sig">getState() / setState(state)</td><td class="desc">Serialise and reapply the restorable view state (<code>zoom</code> and the timeline <code>scroll</code>) across browser history.</td></tr>
+          <tr><td class="sig">resourceWidth / setResourceWidth(px)</td><td class="desc">The left resource pane's width in px (default 300): the option sets it at mount, <code>setResourceWidth</code> resizes programmatically, and the draggable/keyboard divider resizes it by hand — all clamped into the pane's range and carried by <code>getState</code>.</td></tr>
+          <tr><td class="sig">getState() / setState(state)</td><td class="desc">Serialise and reapply the restorable view state (<code>zoom</code>, the timeline <code>scroll</code> and the <code>resourceWidth</code>) across browser history.</td></tr>
           <tr><td class="sig">schedulerFromGantt(el, gantt, opts) / schedulerFromRows(el, rows, opts) / schedulerFromCalendar(el, calendar, opts)</td><td class="desc">Build a scheduler over a Gantt plan's assignments (wired so a reassign writes back), a plain dataset, or a calendar's events.</td></tr>
           <tr><td class="sig">on(name, fn) / off(name, fn)</td><td class="desc">Events: <code>zoom:change</code> <code>{ level, px }</code>; <code>change</code> <code>{ id, kind, resource: { from, to }, row }</code> on a reassign; the cancellable <code>beforeEventChange</code> (veto with <code>preventDefault()</code>), <code>eventChange:cancelled</code>, and <code>event:change</code> <code>{ id, action, changes, oldValues, newValues }</code>.</td></tr>
           <tr><td class="sig">destroy()</td><td class="desc">Destroy the left grid, empty the element, remove only what the module added, and drop handlers and caches. The host still owns the element.</td></tr>
@@ -14426,7 +14429,7 @@ const scheduler = createScheduler(document.querySelector('#scheduler'), {
     <h3 id="scheduler-example">Placement, lanes, workload, zoom, grouping, search, editing and export, executed</h3>
     <p class="section-note">Two resources, three events (two overlapping into two sub-lanes on Alice's row), the day axis, the
     keyed-diff contract, the per-resource workload band, grouping, search and the two filters, an edit and its undo, and a print-safe SVG export of the visible range, run headless on every build.</p>
-    <pre data-run="js" data-expect="2|3|2|0|26|true|2|1|1|1|1|2|0|true|2026-03-03 09:00|2026-03-02 09:00|week|3|true|true|true|false" data-covers="export:createScheduler config:SchedulerConfig.resources config:SchedulerConfig.events config:SchedulerConfig.fields config:SchedulerConfig.resourceKey config:SchedulerConfig.eventKey config:SchedulerConfig.zoom config:SchedulerConfig.date config:SchedulerConfig.defaultDuration config:SchedulerConfig.rowHeight config:SchedulerConfig.weekStartDay config:SchedulerConfig.todayLine config:SchedulerConfig.nonWorking config:SchedulerConfig.calendars config:SchedulerConfig.workload config:SchedulerConfig.colorProperty config:SchedulerConfig.colorMap config:SchedulerConfig.ariaLabel config:SchedulerConfig.labels config:SchedulerConfig.overscan config:SchedulerConfig.groupBy config:SchedulerConfig.search config:SchedulerConfig.resourceFilter config:SchedulerConfig.eventFilter config:SchedulerConfig.editable config:SchedulerConfig.readOnlyWhen config:SchedulerConfig.resourceReadOnlyWhen"><code>const { createScheduler } = await import('../packages/modules/scheduler/index.js');
+    <pre data-run="js" data-expect="2|3|2|0|26|true|2|1|1|1|1|2|0|320|400|true|2026-03-03 09:00|2026-03-02 09:00|week|3|true|true|true|false|fit" data-covers="export:createScheduler config:SchedulerConfig.resources config:SchedulerConfig.events config:SchedulerConfig.fields config:SchedulerConfig.resourceKey config:SchedulerConfig.eventKey config:SchedulerConfig.zoom config:SchedulerConfig.date config:SchedulerConfig.defaultDuration config:SchedulerConfig.rowHeight config:SchedulerConfig.resourceWidth config:SchedulerConfig.weekStartDay config:SchedulerConfig.todayLine config:SchedulerConfig.nonWorking config:SchedulerConfig.calendars config:SchedulerConfig.workload config:SchedulerConfig.colorProperty config:SchedulerConfig.colorMap config:SchedulerConfig.ariaLabel config:SchedulerConfig.labels config:SchedulerConfig.overscan config:SchedulerConfig.groupBy config:SchedulerConfig.search config:SchedulerConfig.resourceFilter config:SchedulerConfig.eventFilter config:SchedulerConfig.editable config:SchedulerConfig.readOnlyWhen config:SchedulerConfig.resourceReadOnlyWhen"><code>const { createScheduler } = await import('../packages/modules/scheduler/index.js');
 const sched = createScheduler(null, {
   resources: [
     { id: 'alice', name: 'Alice', role: 'Design', capacity: 4, calendar: 'weekends' },
@@ -14440,7 +14443,7 @@ const sched = createScheduler(null, {
   fields: { resourceId: 'resourceId', startDate: 'startDate', endDate: 'endDate', name: 'name' },
   resourceKey: 'id', eventKey: 'id',
   zoom: 'day', date: '2026-03-02',
-  defaultDuration: 60, rowHeight: 34, weekStartDay: 1,
+  defaultDuration: 60, rowHeight: 34, resourceWidth: 320, weekStartDay: 1,
   todayLine: true, nonWorking: true,
   calendars: { weekends: 'weekends' },
   workload: true,
@@ -14473,6 +14476,9 @@ const filteredResources = sched.ctx.visibleResources.length; // 1
 sched.setResourceFilter(null);
 const wlRows = sched.workload.rows.size;                  // 2 (one band row per resource)
 const wlOver = sched.workload.overAllocated.length;       // 0 (nothing over-allocated)
+const rwBefore = sched.getState().resourceWidth;          // 320 (the configured pane width)
+sched.setResourceWidth(400);
+const rwAfter = sched.getState().resourceWidth;           // 400 (resized via the API)
 const changed = sched.edit.move(1, 1).ok;                 // true (moved one day)
 const movedStart = sched.events.get(1).startDate;         // 2026-03-03 09:00
 sched.undo();
@@ -14486,8 +14492,10 @@ const isSvg = /^&lt;svg /.test(svg);                      // true
 const hasBars = (svg.match(/&lt;rect /g) || []).length &gt;= 3;  // true (one bar per placed event)
 const noVar = svg.includes('var(') === false;             // true (print-safe palette, no tokens)
 const printed = sched.print();                            // false (no window to open, headless)
+sched.setZoom('fit');
+const fit = sched.getZoom().level;                        // fit (fills the timeline width)
 sched.destroy();
-return [resources, events, overlap, unscheduled, px, hasTicks, groups, matchedEvents, matchedResources, filteredEvents, filteredResources, wlRows, wlOver, changed, movedStart, undone, zoom, after, isSvg, hasBars, noVar, printed].join('|');</code></pre>
+return [resources, events, overlap, unscheduled, px, hasTicks, groups, matchedEvents, matchedResources, filteredEvents, filteredResources, wlRows, wlOver, rwBefore, rwAfter, changed, movedStart, undone, zoom, after, isSvg, hasBars, noVar, printed, fit].join('|');</code></pre>
 
     <h2 id="kpi">The KPI (stat-tile) view</h2>
     <p><code>modules/kpi</code> is an opt-in view of a dataset as a panel of <strong>stat tiles</strong> &mdash; each tile an aggregate over the routed rows: a sum, an average, a min/max, a count, a distinct count, or a host reducer. It is the fourth first-class viewer beside the grid, the kanban and the gantt, in the same shape: a separate bundle that adds no weight to a page that does not load it, changes nothing in grid core, and pulls in no dependency. A KPI panel is <em>just another dataset viewer</em>: it consumes data through the same keyed-diff contract a grid exposes, <code>kpi.rows.apply({ add, update, remove })</code>, so a Data Router can <code>attach(value, kpi)</code> and drive a KPI panel beside a grid, a kanban and a chart off one feed.</p>
@@ -29295,10 +29303,11 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
           <tr><td class="name">resourceKey</td><td class="type">string</td><td class="desc">The resource identity field. Default `'id'`. <small>(optional)</small></td></tr>
           <tr><td class="name">eventKey</td><td class="type">string</td><td class="desc">The event identity field. Default `'id'`. <small>(optional)</small></td></tr>
           <tr><td class="name">columns</td><td class="type">unknown[]</td><td class="desc">The left table's columns; defaults to name/role/capacity. <small>(optional)</small></td></tr>
-          <tr><td class="name">zoom</td><td class="type"><a href="#type-SchedulerZoom">SchedulerZoom</a> <small class="literals">'hour' | 'day' | 'week' | 'month' | 'quarter' | number</small></td><td class="desc">The zoom: a preset name or px-per-day. Default `'day'`. <small>(optional)</small></td></tr>
+          <tr><td class="name">zoom</td><td class="type"><a href="#type-SchedulerZoom">SchedulerZoom</a> <small class="literals">'hour' | 'day' | 'week' | 'month' | 'quarter' | 'fit' | number</small></td><td class="desc">The zoom: a preset name (`'fit'` fills the timeline width), or px-per-day. Default `'day'`. <small>(optional)</small></td></tr>
           <tr><td class="name">date</td><td class="type">Date | string | number</td><td class="desc">The anchor date the axis centres on. Default the earliest event start, else today. <small>(optional)</small></td></tr>
           <tr><td class="name">defaultDuration</td><td class="type">number</td><td class="desc">The minutes an event without an end runs. Default 60. <small>(optional)</small></td></tr>
           <tr><td class="name">rowHeight</td><td class="type">number</td><td class="desc">The row height in px. Default 34. <small>(optional)</small></td></tr>
+          <tr><td class="name">resourceWidth</td><td class="type">number</td><td class="desc">The resource pane's width in px (the left table). Default 300; drag the divider or use `setResourceWidth` to change it. <small>(optional)</small></td></tr>
           <tr><td class="name">locale</td><td class="type">string</td><td class="desc">BCP-47 locale for tick labels. <small>(optional)</small></td></tr>
           <tr><td class="name">timeZone</td><td class="type">string</td><td class="desc">IANA time-zone name for tick labels. Default UTC. <small>(optional)</small></td></tr>
           <tr><td class="name">weekStartDay</td><td class="type">number</td><td class="desc">Week-start weekday, 0=Sun…6=Sat. <small>(optional)</small></td></tr>
@@ -29430,12 +29439,13 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
         <tbody>
           <tr><td class="name">refresh</td><td class="type">(): <a href="#type-Scheduler">Scheduler</a></td><td class="desc">&mdash;</td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Re-seed from the config arrays (unless a diff landed) and re-render.</td></tr>
           <tr><td class="name">setEvents</td><td class="type">(events: <a href="#type-SchedulerRow">SchedulerRow</a>[]): <a href="#type-Scheduler">Scheduler</a></td><td class="desc"><code>events: <a href="#type-SchedulerRow">SchedulerRow</a>[]</code></td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Replace every event and re-render, keyed by `eventKey`.</td></tr>
-          <tr><td class="name">setZoom</td><td class="type">(zoom: <a href="#type-SchedulerZoom">SchedulerZoom</a>): <a href="#type-Scheduler">Scheduler</a></td><td class="desc"><code>zoom: <a href="#type-SchedulerZoom">SchedulerZoom</a></code></td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Change the zoom and re-render, firing `zoom:change`.</td></tr>
-          <tr><td class="name">getZoom</td><td class="type">(): { level: string; px: number }</td><td class="desc">&mdash;</td><td class="type"><code>{ level: string; px: number }</code></td><td class="desc">The current zoom `{ level, px }`.</td></tr>
+          <tr><td class="name">setZoom</td><td class="type">(zoom: <a href="#type-SchedulerZoom">SchedulerZoom</a>): <a href="#type-Scheduler">Scheduler</a></td><td class="desc"><code>zoom: <a href="#type-SchedulerZoom">SchedulerZoom</a></code></td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Change the zoom and re-render, firing `zoom:change`. `'fit'` fills the timeline width.</td></tr>
+          <tr><td class="name">getZoom</td><td class="type">(): { level: string; px: number }</td><td class="desc">&mdash;</td><td class="type"><code>{ level: string; px: number }</code></td><td class="desc">The current zoom `{ level, px }` — `level` is `'fit'` when zoomed to fit.</td></tr>
           <tr><td class="name">setGroupBy</td><td class="type">(groupBy: string | ((resource: <a href="#type-SchedulerRow">SchedulerRow</a>) =&gt; unknown) | null): <a href="#type-Scheduler">Scheduler</a></td><td class="desc"><code>groupBy: string | ((resource: <a href="#type-SchedulerRow">SchedulerRow</a>) =&gt; unknown) | null</code></td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Group the resources by a field or function, re-mounting the left grid.</td></tr>
           <tr><td class="name">setSearch</td><td class="type">(query: string): <a href="#type-Scheduler">Scheduler</a></td><td class="desc"><code>query: string</code></td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Set the search query that narrows rows and bars; `''` clears it.</td></tr>
           <tr><td class="name">setResourceFilter</td><td class="type">(fn: ((resource: <a href="#type-SchedulerRow">SchedulerRow</a>) =&gt; unknown) | null): <a href="#type-Scheduler">Scheduler</a></td><td class="desc"><code>fn: ((resource: <a href="#type-SchedulerRow">SchedulerRow</a>) =&gt; unknown) | null</code></td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Set the resource filter; `null` clears it.</td></tr>
           <tr><td class="name">setEventFilter</td><td class="type">(fn: ((event: <a href="#type-SchedulerRow">SchedulerRow</a>) =&gt; unknown) | null): <a href="#type-Scheduler">Scheduler</a></td><td class="desc"><code>fn: ((event: <a href="#type-SchedulerRow">SchedulerRow</a>) =&gt; unknown) | null</code></td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Set the event filter; `null` clears it.</td></tr>
+          <tr><td class="name">setResourceWidth</td><td class="type">(width: number): <a href="#type-Scheduler">Scheduler</a></td><td class="desc"><code>width: number</code></td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Resize the resource pane to a pixel width, clamped into the divider's range.</td></tr>
           <tr><td class="name">toggleGroup</td><td class="type">(value: unknown): <a href="#type-Scheduler">Scheduler</a></td><td class="desc"><code>value: unknown</code></td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Expand or collapse one group by its value.</td></tr>
           <tr><td class="name">undo</td><td class="type">(opts?: { origin?: string }): boolean</td><td class="desc"><code>opts?: { origin?: string }</code></td><td class="type"><code>boolean</code></td><td class="desc">Undo the most recent edit.</td></tr>
           <tr><td class="name">redo</td><td class="type">(opts?: { origin?: string }): boolean</td><td class="desc"><code>opts?: { origin?: string }</code></td><td class="type"><code>boolean</code></td><td class="desc">Redo the most recently undone edit.</td></tr>
@@ -29447,7 +29457,7 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
           <tr><td class="name">toPNG</td><td class="type">(pngOpts?: { range?: { from?: number | string | Date; to?: number | string | Date }; scale?: number; background?: string; }): Promise&lt;Blob | null&gt;</td><td class="desc"><code>pngOpts?: { range?: { from?: number | string | Date; to?: number | string | Date }; scale?: number; background?: string; }</code></td><td class="type"><code>Promise&lt;Blob | null&gt;</code></td><td class="desc">This scheduler as a PNG (BACKLOG-0002128): `toSVG` rasterised through a canvas. Makes no network request. `null` when nothing is laid out or there is no canvas to rasterise with.</td></tr>
           <tr><td class="name">print</td><td class="type">(printOpts?: { paper?: 'A4' | 'Letter' | 'A3'; orientation?: 'landscape' | 'portrait'; fitToWidth?: boolean; scale?: number; title?: string | false; header?: string | ((page: number, pages: number) =&gt; string) | false; footer?: string | ((page: number, pages: number) =&gt; string) | false; }): boolean</td><td class="desc"><code>printOpts?: { paper?: 'A4' | 'Letter' | 'A3'; orientation?: 'landscape' | 'portrait'; fitToWidth?: boolean; scale?: number; title?: string | false; header?: string | ((page: number, pages: number) =&gt; string) | false; footer?: string | ((page: number, pages: number) =&gt; string) | false; }</code></td><td class="type"><code>boolean</code></td><td class="desc">Print this scheduler — the resource table, the time axis and the bars — paged and scaled (BACKLOG-0002128): the table header and time header repeat on every page and no row is split across a page boundary. Opens the browser's own print path over a standalone document; "PDF" is whatever the browser's print dialog offers ("Save as PDF") — no server, no dependency. Always prints in a fixed, print-safe light palette, independent of the mounted theme.</td></tr>
           <tr><td class="name">reassign</td><td class="type">(key: unknown, resourceId: unknown): boolean</td><td class="desc"><code>key: unknown</code><br><code>resourceId: unknown</code></td><td class="type"><code>boolean</code></td><td class="desc">Move an event to another resource row and fire `change` (`{ id, kind: 'reassign', resource: { from, to }, row }`). Returns false when the event key is unknown or the resource is unchanged.</td></tr>
-          <tr><td class="name">getState</td><td class="type">(): { version: number; zoom: string; scroll: { left: number; top: number } }</td><td class="desc">&mdash;</td><td class="type"><code>{ version: number; zoom: string; scroll: { left: number; top: number } }</code></td><td class="desc">Serialise the restorable view state: `{ version, zoom, scroll }`.</td></tr>
+          <tr><td class="name">getState</td><td class="type">(): { version: number; zoom: string; scroll: { left: number; top: number }; resourceWidth: number }</td><td class="desc">&mdash;</td><td class="type"><code>{ version: number; zoom: string; scroll: { left: number; top: number }; resourceWidth: number }</code></td><td class="desc">Serialise the restorable view state: `{ version, zoom, scroll, resourceWidth }`.</td></tr>
           <tr><td class="name">setState</td><td class="type">(state: object): <a href="#type-Scheduler">Scheduler</a></td><td class="desc"><code>state: object</code></td><td class="type"><code><a href="#type-Scheduler">Scheduler</a></code></td><td class="desc">Reapply a state snapshot from {@link Scheduler.getState}.</td></tr>
           <tr><td class="name">destroy</td><td class="type">(): void</td><td class="desc">&mdash;</td><td class="type"><code>void</code></td><td class="desc">Tear the scheduler down.</td></tr>
         </tbody>
@@ -35785,8 +35795,8 @@ return `next ${p.mean.toFixed(1)}; r2 ${f.r2.toFixed(1)}; band ${p.upper - p.low
     <p class="type-def"><code>type SchedulerRow = Record&lt;string, unknown&gt;</code></p>
     <p class="section-note"><small>Declared in <code>lattice-grid/modules/scheduler</code>.</small></p>
     <h4 id="type-SchedulerZoom">SchedulerZoom</h4>
-    <p class="section-note">A scheduler zoom level name, or a bare pixels-per-day number.</p>
-    <p class="type-def"><code>type SchedulerZoom = 'hour' | 'day' | 'week' | 'month' | 'quarter' | number</code></p>
+    <p class="section-note">A scheduler zoom level name (`'fit'` sizes px-per-day to the timeline width), or a bare pixels-per-day number.</p>
+    <p class="type-def"><code>type SchedulerZoom = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'fit' | number</code></p>
     <p class="section-note"><small>Declared in <code>lattice-grid/modules/scheduler</code>.</small></p>
     <h4 id="type-ScrollbarMode">ScrollbarMode</h4>
     <p class="section-note">How the grid's scroll viewport draws its scrollbars (BACKLOG-0000990, BACKLOG-0001288). `auto` is the platform's native behaviour — overlay scrollbars fade away when idle. `always` keeps that native bar shown whether or not the pointer is over the grid, so the affordance never disappears on a touchpad or an overlay OS. `custom` replaces it with a bar the grid draws itself: the same size, colour and hit area in every browser, sized by the `--lattice-scrollbar-*` tokens, for a target bigger than the platform's own thin overlay ribbon.</p>
@@ -35976,7 +35986,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.98.1 · Copyright © 2026 TOCLOCO Inc. All rights reserved.
+      Lattice Grid 1.98.2 · 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.98.1</title>
+<title>Adapters API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>AI API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Alarms API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Calendar API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Charts API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Dashboard API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Data router API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>deck.gl API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Designer API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Gantt API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Geometry API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Grid API Reference — Lattice Grid 1.98.2</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an
@@ -1870,7 +1870,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.98.1'</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.98.2'</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.98.1</title>
+<title>API Reference — Lattice Grid 1.98.2</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an
@@ -450,7 +450,7 @@
           <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="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">90</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">102</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">104</td></tr>
           <tr><td class="name"><a href="tabs.html">The tabbed grid</a></td><td class="desc"><code>createTabs</code>: a tab strip where each tab holds a grid, a board, a KPI strip or a Gantt, and the tablist keyboard model.</td><td class="type">1</td><td class="type">7</td><td class="type">57</td></tr>
           <tr><td class="name"><a href="layout.html">The dashboard layout</a></td><td class="desc"><code>createLayout</code>: windows a reader moves, resizes and closes, the arrangement saved as plain JSON, locking, and the cancellable gestures.</td><td class="type">1</td><td class="type">15</td><td class="type">133</td></tr>
           <tr><td class="name"><a href="shell.html">The shell module</a></td><td class="desc"><code>createShell</code>: cells nested as rows and columns to any depth, sized by flexbox so the DOM is complete and measured the moment the factory returns.</td><td class="type">1</td><td class="type">25</td><td class="type">153</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.98.1</title>
+<title>Kanban API Reference — Lattice Grid 1.98.2</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an

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.98.1</title>
+<title>KPI API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Layout API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Leaflet API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>List API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Map view API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Mock socket API Reference — Lattice Grid 1.98.2</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.98.1</title>
+<title>Presets API Reference — Lattice Grid 1.98.2</title>
 <style>
   /* ---------------------------------------------------------------
      Palette lifted from the grid's own theme, so the reference reads as an