@nowline/layout 0.8.5 → 0.9.0

package/dist/nodes/footnote-node.js

@@ -1,41 +1,145 @@
-// FootnoteNode + buildFootnotes — footnote area at the bottom of the
-// chart. Each footnote gets a stable index (1-based, sorted by id) and
+// FootnoteNode + indexFootnotes / buildFootnotePanel — footnote area at the bottom of the
+// chart. Each footnote gets a stable index (1-based, in document order) and
 // records its `on:` host references so item / swimlane sequencing can
-// emit the matching superscript indicators. The panel grows to fit:
-// 28 px header + (entries × FOOTNOTE_ROW_HEIGHT) + 16 px padding.
+// emit the matching superscript indicators. An isolated region's
+// footnotes continue the numbering after the host's, in include order,
+// and share the one panel under a heading row with the region's title.
+// An entry whose text does not fit the panel's width wraps onto more
+// rows at the title's x. The panel grows to fit: 28 px header + (entry
+// rows and region headings × FOOTNOTE_ROW_HEIGHT) + 16 px padding.
 import { propValues } from '../dsl-utils.js';
 import { resolveStyle } from '../style-resolution.js';
+import { estimateTextWidth, wrapText } from '../text-measure.js';
 import { FOOTNOTE_HEADER_HEIGHT_PX, FOOTNOTE_PANEL_PADDING_PX, FOOTNOTE_ROW_HEIGHT, } from '../themes/shared.js';
-export function buildFootnotes(footnotes, ctx, chartBottomY) {
-    const entries = [];
+/**
+ * Pure: depends only on the footnote declarations. Numbers start after
+ * `precedingCount` (an isolated region continues after the host and the
+ * regions before it). The map's order is document order: the resolver
+ * inserts a file's own footnotes as declared, then each merged include's.
+ */
+export function indexFootnotes(footnotes, precedingCount = 0) {
     const index = new Map();
     const hosts = new Map();
-    const ordered = [...footnotes.entries()].sort(([a], [b]) => a.localeCompare(b));
-    ordered.forEach(([id, f], i) => {
-        const n = i + 1;
-        index.set(id, n);
+    [...footnotes.entries()].forEach(([id, f], i) => {
+        index.set(id, precedingCount + i + 1);
         hosts.set(id, propValues(f.properties, 'on'));
-        entries.push({
-            number: n,
-            title: f.title ?? id,
-            description: f.description?.text,
-            style: resolveStyle('footnote', f.properties, ctx.styleCtx),
-        });
     });
+    return { index, hosts };
+}
+/** Font sizes (px) of an entry's title and description. */
+const FOOTNOTE_TEXT_FONT_SIZE_PX = 11;
+/** The description column never starts closer than this to the title's x. */
+const FOOTNOTE_DESCRIPTION_MIN_OFFSET_PX = 120;
+/** Per-character advance the description column is placed by. */
+const FOOTNOTE_TITLE_CHAR_ADVANCE_PX = 6;
+const DESCRIPTION_LEAD = '— ';
+/**
+ * The panel below the chart, spanning the final canvas (`chartRightX`):
+ * the host's footnotes, then each region's under its title, each in
+ * document order. The canvas does not grow for the panel: an entry whose
+ * title or description runs past the panel's inner right edge wraps onto
+ * more rows, which start at the title's x and use the whole width.
+ */
+export function buildFootnotePanel(footnotes, ctx, chartBottomY, chartRightX, regions = []) {
+    const boxX = FOOTNOTE_PANEL_PADDING_PX;
+    const boxY = chartBottomY + FOOTNOTE_PANEL_PADDING_PX;
+    const boxWidth = chartRightX - 2 * FOOTNOTE_PANEL_PADDING_PX;
+    const titleX = boxX + 2 * FOOTNOTE_PANEL_PADDING_PX;
+    const textRightX = boxX + boxWidth - FOOTNOTE_PANEL_PADDING_PX;
+    const firstRowY = boxY + FOOTNOTE_HEADER_HEIGHT_PX + FOOTNOTE_PANEL_PADDING_PX;
+    const entries = [];
+    let row = 0;
+    const add = (decls, source, region) => {
+        for (const [id, f] of decls) {
+            const title = f.title ?? id;
+            const description = f.description?.text;
+            const lines = entryLines(title, description, titleX, textRightX);
+            const y = firstRowY + row * FOOTNOTE_ROW_HEIGHT;
+            const at = (l) => ({
+                x: l.x,
+                y: y + l.row * FOOTNOTE_ROW_HEIGHT,
+                text: l.text,
+            });
+            const entry = {
+                number: source.footnoteIndex.get(id) ?? entries.length + 1,
+                y,
+                title,
+                titleLines: lines.title.map(at),
+                description,
+                style: resolveStyle('footnote', f.properties, source.styleCtx),
+            };
+            if (lines.description.length > 0)
+                entry.descriptionLines = lines.description.map(at);
+            if (region !== undefined)
+                entry.region = region;
+            entries.push(entry);
+            row += lines.rows;
+        }
+    };
+    add(footnotes, ctx);
+    for (const r of regions) {
+        if (r.footnotes.size === 0)
+            continue;
+        // The region's heading takes a row of its own above its entries.
+        const headingY = firstRowY + row * FOOTNOTE_ROW_HEIGHT;
+        row += 1;
+        const first = entries.length;
+        add(r.footnotes, r.ctx, r.title);
+        entries[first].regionHeadingY = headingY;
+    }
     const box = {
-        x: FOOTNOTE_PANEL_PADDING_PX,
-        y: chartBottomY + FOOTNOTE_PANEL_PADDING_PX,
-        width: ctx.chartRightX - 2 * FOOTNOTE_PANEL_PADDING_PX,
+        x: boxX,
+        y: boxY,
+        width: boxWidth,
         height: entries.length === 0
             ? 0
-            : FOOTNOTE_HEADER_HEIGHT_PX +
-                entries.length * FOOTNOTE_ROW_HEIGHT +
-                FOOTNOTE_PANEL_PADDING_PX,
+            : FOOTNOTE_HEADER_HEIGHT_PX + row * FOOTNOTE_ROW_HEIGHT + FOOTNOTE_PANEL_PADDING_PX,
     };
+    return { box, entries };
+}
+/**
+ * Wrap one entry into rows. The title starts at `titleX`; the description
+ * follows on the title's row at the description column (`— ` first) and
+ * wraps at `titleX`. A wrapped title, or a description whose first word
+ * does not fit beside the title, starts the description on a row of its
+ * own. A single word wider than the panel stays whole on its row, as
+ * `wrapText` never splits a word.
+ */
+function entryLines(title, description, titleX, textRightX) {
+    const fullWidth = textRightX - titleX;
+    const titleRows = fitsOrWraps(title, fullWidth, fullWidth);
+    const titleLines = titleRows.map((text, row) => ({ x: titleX, row, text }));
+    if (!description)
+        return { title: titleLines, description: [], rows: titleRows.length };
+    const leadWidth = estimateTextWidth(DESCRIPTION_LEAD, FOOTNOTE_TEXT_FONT_SIZE_PX);
+    const firstWord = description.trim().split(/\s+/)[0] ?? '';
+    const columnX = titleX +
+        Math.max(FOOTNOTE_DESCRIPTION_MIN_OFFSET_PX, title.length * FOOTNOTE_TITLE_CHAR_ADVANCE_PX);
+    const besideTitle = titleRows.length === 1 &&
+        leadWidth + estimateTextWidth(firstWord, FOOTNOTE_TEXT_FONT_SIZE_PX) <=
+            textRightX - columnX;
+    const firstX = besideTitle ? columnX : titleX;
+    const firstRow = besideTitle ? titleRows.length - 1 : titleRows.length;
+    const rows = fitsOrWraps(description, fullWidth, textRightX - firstX - leadWidth);
+    const descriptionLines = rows.map((text, i) => ({
+        x: i === 0 ? firstX : titleX,
+        row: firstRow + i,
+        text: i === 0 ? `${DESCRIPTION_LEAD}${text}` : text,
+    }));
     return {
-        area: { box, entries },
-        index,
-        hosts,
+        title: titleLines,
+        description: descriptionLines,
+        rows: firstRow + rows.length,
     };
 }
+/**
+ * `text` as is when it fits `firstWidth`, else wrapped (`wrapText`, which
+ * collapses whitespace), so an entry that fits keeps its exact text.
+ */
+function fitsOrWraps(text, width, firstWidth) {
+    if (estimateTextWidth(text, FOOTNOTE_TEXT_FONT_SIZE_PX) <= firstWidth)
+        return [text];
+    const rows = wrapText(text, width, FOOTNOTE_TEXT_FONT_SIZE_PX, firstWidth);
+    return rows.length > 0 ? rows : [text];
+}
 //# sourceMappingURL=footnote-node.js.map

package/dist/nodes/footnote-node.js.map

@@ -1 +1 @@
-{"version":3,"file":"footnote-node.js","sourceRoot":"","sources":["../../src/nodes/footnote-node.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,uEAAuE;AACvE,sEAAsE;AACtE,oEAAoE;AACpE,kEAAkE;AAGlE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACH,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACtB,MAAM,qBAAqB,CAAC;AAS7B,MAAM,UAAU,cAAc,CAC1B,SAA2C,EAC3C,GAAkB,EAClB,YAAoB;IAEpB,MAAM,OAAO,GAA8B,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACjB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC;YACT,MAAM,EAAE,CAAC;YACT,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;YACpB,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI;YAChC,KAAK,EAAE,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC;SAC9D,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,GAAgB;QACrB,CAAC,EAAE,yBAAyB;QAC5B,CAAC,EAAE,YAAY,GAAG,yBAAyB;QAC3C,KAAK,EAAE,GAAG,CAAC,WAAW,GAAG,CAAC,GAAG,yBAAyB;QACtD,MAAM,EACF,OAAO,CAAC,MAAM,KAAK,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,yBAAyB;gBACzB,OAAO,CAAC,MAAM,GAAG,mBAAmB;gBACpC,yBAAyB;KACtC,CAAC;IACF,OAAO;QACH,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE;QACtB,KAAK;QACL,KAAK;KACR,CAAC;AACN,CAAC"}
+{"version":3,"file":"footnote-node.js","sourceRoot":"","sources":["../../src/nodes/footnote-node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/group-node.d.ts

@@ -1,28 +1,17 @@
-import type { EntityProperty, GroupBlock, ItemDeclaration, ParallelBlock } from '@nowline/core';
-import type { LayoutContext, TrackCursor } from '../layout-context.js';
-import type { PositionedGroup, PositionedItem, PositionedTrackChild } from '../types.js';
-export interface GroupNodeDeps {
-    sequenceItem: (child: ItemDeclaration, cursor: TrackCursor, ctx: LayoutContext, ownerOverride?: string) => PositionedItem;
-    sequenceOne: (child: ItemDeclaration | GroupBlock | ParallelBlock, cursor: TrackCursor, ctx: LayoutContext) => PositionedTrackChild;
-    resolveChildStart: (props: EntityProperty[], seqDefault: number, laneLeftX: number, ctx: LayoutContext) => number;
-    newCursor: (x: number, y: number) => TrackCursor;
-    estimateTextWidth: (text: string, fontSize: number) => number;
-    /** Predict the extra vertical height an item's wrapped label-chip
-     *  rows will add to its bar; used to size the row-packer's row
-     *  pitch ahead of the call to `sequenceItem`. */
-    predictItemChipExtraHeight: (item: ItemDeclaration, ctx: LayoutContext) => number;
-}
+import type { GroupBlock } from '@nowline/core';
+import type { LayoutContext, LayoutHelpers, TrackCursor } from '../layout-context.js';
+import type { PositionedGroup } from '../types.js';
 export declare class GroupNode {
     readonly node: GroupBlock;
-    private readonly deps;
-    constructor(node: GroupBlock, deps: GroupNodeDeps);
+    private readonly helpers;
+    constructor(node: GroupBlock, helpers: LayoutHelpers);
     get id(): string;
     /**
-     * Sequence children inside the group's content area, advance the
-     * parent `cursor` past the group's right edge plus
-     * `TRACK_BLOCK_TAIL_GUTTER_PX` of breathing room, and return a
-     * `PositionedGroup` whose `box.height` covers the chiclet pad,
-     * every row-packed child row, and the bottom pad.
+     * Sequence children inside the group's body, advance the parent
+     * `cursor` to the group's end in time (its children's duration ends,
+     * never a caption spill or a header title), and return a
+     * `PositionedGroup` whose box covers the header, the padded rows and
+     * the group's dates.
      */
     place(cursor: TrackCursor, ctx: LayoutContext): PositionedGroup;
 }

package/dist/nodes/group-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"group-node.d.ts","sourceRoot":"","sources":["../../src/nodes/group-node.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAKhG,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAYvE,OAAO,KAAK,EAER,eAAe,EACf,cAAc,EACd,oBAAoB,EACvB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,aAAa;IAC1B,YAAY,EAAE,CACV,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,aAAa,EAClB,aAAa,CAAC,EAAE,MAAM,KACrB,cAAc,CAAC;IACpB,WAAW,EAAE,CACT,KAAK,EAAE,eAAe,GAAG,UAAU,GAAG,aAAa,EACnD,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,aAAa,KACjB,oBAAoB,CAAC;IAC1B,iBAAiB,EAAE,CACf,KAAK,EAAE,cAAc,EAAE,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,aAAa,KACjB,MAAM,CAAC;IACZ,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC;IACjD,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9D;;qDAEiD;IACjD,0BAA0B,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;CACrF;AAED,qBAAa,SAAS;aAEE,IAAI,EAAE,UAAU;IAEhC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFL,IAAI,EAAE,UAAU,EAEf,IAAI,EAAE,aAAa;IAGxC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,GAAG,eAAe;CAmLlE"}
+{"version":3,"file":"group-node.d.ts","sourceRoot":"","sources":["../../src/nodes/group-node.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGtF,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,aAAa,CAAC;AAIhE,qBAAa,SAAS;aAEE,IAAI,EAAE,UAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF5B,YACoB,IAAI,EAAE,UAAU,EACf,OAAO,EAAE,aAAa,EACvC;IAEJ,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,GAAG,eAAe,CAgG9D;CACJ"}

package/dist/nodes/group-node.js

@@ -1,195 +1,120 @@
 // GroupNode — Renderable for a `group { ... }` block. Sequences
-// children inside the group's content area using the same row-pack
-// engine `SwimlaneNode` uses, so an item whose desired start collides
-// with a sibling's `rightEdge`, caption `spillX`, or a slack-arrow
-// corridor bumps to a new row inside the group. The group's reported
-// `box.height` grows with the row stack so parent containers stack
-// against the actual painted extent.
+// children inside the group's body through `sequenceRowTrack`
+// (row-track.ts), the loop `SwimlaneNode` uses, so an item whose desired
+// start collides with a sibling's `rightEdge`, caption `spillX`, or a
+// slack-arrow corridor bumps to a new row inside the group.
 //
-// Filled-style groups paint a title chiclet flush in the upper-left
-// corner of the box; the layout reserves vertical top padding equal
-// to the chiclet height plus a small gutter before the first inner
-// row begins.
-import { isItemDeclaration } from '@nowline/core';
-import { deriveItemDurationDays } from '../calendar.js';
-import { propValues } from '../dsl-utils.js';
+// The group is drawn above and around its content, never beside it
+// (specs/true-width-layout.md §3.3): a header band (title, inline-date
+// glyphs, a bracket spanning exactly its dates) over a body padded above
+// and below its rows. Its box spans exactly its children's earliest start
+// and latest end; see `container-header-geometry.ts`.
+import { containerChrome } from '../container-header-geometry.js';
+import { propValue, propValues } from '../dsl-utils.js';
 import { computeContainerInlineDatePins, pickInlineDate } from '../inline-date-pin-geometry.js';
-import { RowPacker } from '../row-packer.js';
+import { resolvePinnedOrSequentialStart } from '../start-rules.js';
 import { resolveStyle } from '../style-resolution.js';
-import { GROUP_BOTTOM_PAD_PX, GROUP_BRACKET_LABEL_OVERHANG_PX, GROUP_TITLE_TAB_GUTTER_PX, GROUP_TITLE_TAB_HEIGHT_PX, ITEM_INSET_PX, MIN_ITEM_WIDTH, TRACK_BLOCK_TAIL_GUTTER_PX, } from '../themes/shared.js';
+import { waveFloorX } from '../wave-layout.js';
+import { sequenceRowTrack } from './row-track.js';
 export class GroupNode {
     node;
-    deps;
-    constructor(node, 
-    // biome-ignore lint/correctness/noUnusedPrivateClassMembers: accessed via `const { deps } = this` destructuring inside methods, which the analyzer does not detect.
-    deps) {
+    helpers;
+    constructor(node, helpers) {
         this.node = node;
-        this.deps = deps;
+        this.helpers = helpers;
     }
     get id() {
         return this.node.name ?? '';
     }
     /**
-     * Sequence children inside the group's content area, advance the
-     * parent `cursor` past the group's right edge plus
-     * `TRACK_BLOCK_TAIL_GUTTER_PX` of breathing room, and return a
-     * `PositionedGroup` whose `box.height` covers the chiclet pad,
-     * every row-packed child row, and the bottom pad.
+     * Sequence children inside the group's body, advance the parent
+     * `cursor` to the group's end in time (its children's duration ends,
+     * never a caption spill or a header title), and return a
+     * `PositionedGroup` whose box covers the header, the padded rows and
+     * the group's dates.
      */
     place(cursor, ctx) {
         const { node } = this;
-        const { deps } = this;
+        const { helpers } = this;
         const style = resolveStyle('group', node.properties, ctx.styleCtx);
-        const startX = cursor.x;
-        const title = node.title ?? node.name;
+        // The group starts after every `after:` term, then its own wave and
+        // its lead wave floor it, so its box never opens in a column before
+        // its first piece of work (specs/waves.md §5.1). A lane child's
+        // cursor already sits there (`resolveChildStart`), so this is the
+        // identity for it; a parallel's group track starts at the parallel's
+        // start, so this is where its `after:` applies
+        // (specs/scheduler-unification.md §8 decision 5).
+        const startX = waveFloorX(node, resolvePinnedOrSequentialStart(node.properties, cursor.x, ctx), ctx);
+        // In a roadmap with waves, a group with no title, no `style:` and
+        // no `labels:` that carries `wave:` only assigns membership: it
+        // draws nothing, which would otherwise sit exactly on the wave
+        // boundary its box opens at, and reserves nothing
+        // (specs/waves.md §9.7). An id alone does not make it titled
+        // (Example 4's `api-track`).
+        const waveOnly = ctx.waves !== undefined &&
+            node.title === undefined &&
+            propValue(node.properties, 'wave') !== undefined &&
+            propValue(node.properties, 'style') === undefined &&
+            propValues(node.properties, 'labels').length === 0;
+        const title = waveOnly ? undefined : (node.title ?? node.name);
         // Group children chain in time inside the group, so they
         // form one sub-flow under the parent's flow path. See
         // `LayoutContext.currentFlowKey`.
         const previousFlowKey = ctx.currentFlowKey;
         ctx.nextGroupId += 1;
         ctx.currentFlowKey = `${previousFlowKey}/group:${node.name ?? `group-${ctx.nextGroupId}`}`;
-        // Mirrors `renderGroup`'s `hasFill` decision so the painted box
-        // and the layout's reservation agree on whether a chiclet exists.
-        const hasChiclet = style.bg !== 'none' && style.bg !== '#ffffff' && Boolean(title);
-        const topPad = hasChiclet ? GROUP_TITLE_TAB_HEIGHT_PX + GROUP_TITLE_TAB_GUTTER_PX : 0;
-        const bottomPad = hasChiclet ? GROUP_BOTTOM_PAD_PX : 0;
-        // Bracket-style groups paint their label at `box.y - 2`, so the
-        // label glyph overhangs ABOVE box.y. Without an explicit
-        // reservation, two bracket-titled groups stacked in a parallel
-        // collide: the previous sibling's bracket-foot ends at its
-        // box.bottom, and the next sibling's label visual top sits just
-        // above box.y — they touch in the gap. Shift `box.y` down by
-        // the overhang amount so the glyph lands in space we own.
-        const bracketLabelOverhang = !hasChiclet && title ? GROUP_BRACKET_LABEL_OVERHANG_PX : 0;
-        const startY = cursor.y + bracketLabelOverhang;
-        const step = ctx.bandScale.step();
-        const groupContentLeftX = startX;
-        const packer = new RowPacker({
-            laneLeftX: groupContentLeftX,
-            originY: startY + topPad,
-            minRowHeight: step,
-            slackCorridors: ctx.slackCorridors,
+        const afterDate = pickInlineDate(propValues(node.properties, 'after'));
+        const beforeDate = pickInlineDate(propValues(node.properties, 'before'));
+        const chrome = containerChrome({
+            drawn: !waveOnly,
+            hasTitle: Boolean(title),
+            hasPins: Boolean(afterDate || beforeDate),
+            hasBracket: style.bracket !== 'none',
         });
-        let timeCursorX = groupContentLeftX;
-        const children = [];
-        for (const child of node.content) {
-            if (child.$type === 'DescriptionDirective')
-                continue;
-            if (!isItemDeclaration(child)) {
-                const blockProps = child.properties ?? [];
-                const blockStart = deps.resolveChildStart(blockProps, timeCursorX, groupContentLeftX, ctx);
-                const { rowIndex, y: blockY } = packer.placeBlock();
-                const innerCursor = deps.newCursor(blockStart, blockY);
-                const positioned = deps.sequenceOne(child, innerCursor, ctx);
-                children.push(positioned);
-                const blockEnd = positioned.box.x + positioned.box.width;
-                const blockHeight = Math.max(step, innerCursor.height);
-                packer.commitBlock({
-                    rowIndex,
-                    placed: positioned,
-                    blockHeight,
-                    blockEnd,
-                });
-                timeCursorX = Math.max(timeCursorX, blockEnd);
-                continue;
-            }
-            const props = child.properties;
-            const desiredStart = deps.resolveChildStart(props, timeCursorX, groupContentLeftX, ctx);
-            // Predict logical extent so the row-packer can bump on
-            // collision before we hand off to `sequenceItem`. Mirrors
-            // SwimlaneNode's pre-flight width math.
-            const durationDays = deriveItemDurationDays(props, ctx.sizes, ctx.cal);
-            const naturalWidth = Math.max(MIN_ITEM_WIDTH, durationDays * ctx.timeline.pixelsPerDay);
-            const desiredEnd = desiredStart + naturalWidth;
-            const childId = child.name ?? '';
-            const chipExtra = deps.predictItemChipExtraHeight(child, ctx);
-            const predictedHeight = step + chipExtra;
-            const { rowIndex, y: rowY } = packer.placeItem({
-                childId,
-                desiredStart,
-                desiredEnd,
-                // Row pitch = `step()` + extra chip-row height. Keeps
-                // the inter-row visible gap (= step - bandwidth) intact
-                // when an item's labels wrap and grow the bar.
-                predictedHeight,
-            });
-            const innerCursor = deps.newCursor(desiredStart, rowY);
-            const positioned = deps.sequenceItem(child, innerCursor, ctx);
-            children.push(positioned);
-            const itemLogicalEnd = positioned.box.x + positioned.box.width + ITEM_INSET_PX;
-            timeCursorX = Math.max(timeCursorX, itemLogicalEnd);
-            let spillReservation = null;
-            const hasAnySpill = positioned.textSpills ||
-                positioned.chipsOutside ||
-                positioned.dotSpills ||
-                positioned.iconSpills ||
-                positioned.footnoteSpills;
-            if (hasAnySpill) {
-                const farRight = Math.max(positioned.decorationsRightX, positioned.chipsOutside ? positioned.chipsRightX : 0);
-                spillReservation = farRight + 6;
-            }
-            packer.commitItem({
-                rowIndex,
-                placed: positioned,
-                logicalEnd: itemLogicalEnd,
-                spillReservation,
-                rowHeight: predictedHeight,
-            });
-        }
-        const innerHeight = Math.max(step, packer.usedHeight());
-        // The group's painted box hugs everything its children put on
-        // screen, including caption text that spills past a bar's right
-        // edge. `usedRightX` is the rightmost extent any row reached —
-        // either a bar's logical right or a caption's reserved spill —
-        // so the orange tint visually "owns" the spilled title/meta.
-        //
-        // The cursor channel (`cursor.x` / `cursor.maxX`) stays on the
-        // COMPACT `timeCursorX` (bar logical ends only). Bubbling the
-        // wide `visualRightX` upward would propagate through
-        // `ParallelNode.maxRight → parallel.box.width → swimlane
-        // blockEnd → timeCursorX`, pushing every subsequent sibling
-        // right by the spill width — including siblings on entirely
-        // different rows of the parent swimlane. The painted box and
-        // the logical cursor advance are intentionally decoupled here.
-        const visualRightX = Math.max(timeCursorX, packer.usedRightX());
+        const track = sequenceRowTrack(node, { leftX: startX, firstRowY: cursor.y + chrome.header + chrome.pad }, ctx, helpers);
+        const { children, timeCursorX, timeStartX } = track;
+        // Every row's height carries the inter-row gap below it; the body
+        // ends `pad` below the last child's painted bottom, not below that
+        // gap, and the cursor adds the gap back after the body so a sibling
+        // stacked below keeps the same rhythm as two items.
+        const step = ctx.bandScale.step();
+        const interRowGap = step - ctx.bandScale.bandwidth();
+        const contentHeight = Math.max(step, track.packer.usedHeight()) - interRowGap;
+        // The bracket and body span exactly the children's dates
+        // (specs/true-width-layout.md §3.3): what the group paints past them
+        // (a spilled caption, its title) is footprint the row packer keeps,
+        // not width.
         const box = {
-            x: startX,
-            y: startY,
-            width: visualRightX - startX,
-            height: topPad + innerHeight + bottomPad,
+            x: timeStartX,
+            y: cursor.y,
+            width: timeCursorX - timeStartX,
+            height: chrome.header + chrome.pad + contentHeight + chrome.pad,
         };
-        cursor.x = timeCursorX + TRACK_BLOCK_TAIL_GUTTER_PX;
-        cursor.maxX = Math.max(cursor.maxX, cursor.x);
-        // The painted `box.height` is the group's tight visual
-        // footprint (chiclet + content + bottomPad). The cursor
-        // advance, however, must include one inter-row gap
-        // (`step - bandwidth`) so a sibling stacked below in a
-        // `parallel` (or any track-pack consumer) doesn't butt
-        // right up against the group's bottom edge. Items naturally
-        // include that gap because they report `cursor.height = step`
-        // (bandwidth + gap); groups need to add it explicitly since
-        // their painted height is gap-less.
-        const interRowGap = ctx.bandScale.step() - ctx.bandScale.bandwidth();
-        cursor.height = Math.max(cursor.height, bracketLabelOverhang + box.height + interRowGap);
+        // A parallel joins on its tracks' ends, as engine C does
+        // (specs/scheduler-unification.md §8 decision 8).
+        cursor.startX = box.x;
+        cursor.x = timeCursorX;
+        cursor.height = Math.max(cursor.height, box.height + interRowGap);
         const id = node.name;
+        // `after:` the group is a time path: its last child's duration end.
         if (id) {
             ctx.entityLeftEdges.set(id, box.x);
-            ctx.entityRightEdges.set(id, box.x + box.width);
+            ctx.entityRightEdges.set(id, timeCursorX);
         }
         ctx.currentFlowKey = previousFlowKey;
-        const inlineDatePins = computeContainerInlineDatePins({
-            box,
-            afterDate: pickInlineDate(propValues(node.properties, 'after')),
-            beforeDate: pickInlineDate(propValues(node.properties, 'before')),
-        });
+        const inlineDatePins = waveOnly
+            ? []
+            : computeContainerInlineDatePins({ box, afterDate, beforeDate, title });
         return {
             kind: 'group',
             id,
             title,
             box,
+            headerHeight: chrome.header,
             children,
             style,
             inlineDatePins: inlineDatePins.length > 0 ? inlineDatePins : undefined,
+            ...(waveOnly ? { waveOnly: true } : {}),
         };
     }
 }

package/dist/nodes/group-node.js.map

@@ -1 +1 @@
-{"version":3,"file":"group-node.js","sourceRoot":"","sources":["../../src/nodes/group-node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"group-node.js","sourceRoot":"","sources":["../../src/nodes/group-node.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,8DAA8D;AAC9D,yEAAyE;AACzE,sEAAsE;AACtE,4DAA4D;AAC5D,EAAE;AACF,mEAAmE;AACnE,uEAAuE;AACvE,yEAAyE;AACzE,0EAA0E;AAC1E,sDAAsD;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhG,OAAO,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,OAAO,SAAS;IAEE,IAAI;IACH,OAAO;IAF5B,YACoB,IAAgB,EACf,OAAsB;oBADvB,IAAI;uBACH,OAAO;IACzB,CAAC;IAEJ,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAmB,EAAE,GAAkB;QACzC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnE,oEAAoE;QACpE,oEAAoE;QACpE,gEAAgE;QAChE,kEAAkE;QAClE,qEAAqE;QACrE,+CAA+C;QAC/C,kDAAkD;QAClD,MAAM,MAAM,GAAG,UAAU,CACrB,IAAI,EACJ,8BAA8B,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,EAC9D,GAAG,CACN,CAAC;QACF,kEAAkE;QAClE,gEAAgE;QAChE,+DAA+D;QAC/D,kDAAkD;QAClD,6DAA6D;QAC7D,6BAA6B;QAC7B,MAAM,QAAQ,GACV,GAAG,CAAC,KAAK,KAAK,SAAS;YACvB,IAAI,CAAC,KAAK,KAAK,SAAS;YACxB,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,SAAS;YAChD,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,SAAS;YACjD,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;QAE/D,yDAAyD;QACzD,sDAAsD;QACtD,kCAAkC;QAClC,MAAM,eAAe,GAAG,GAAG,CAAC,cAAc,CAAC;QAC3C,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC;QACrB,GAAG,CAAC,cAAc,GAAG,GAAG,eAAe,UAAU,IAAI,CAAC,IAAI,IAAI,SAAS,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3F,MAAM,SAAS,GAAG,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,eAAe,CAAC;YAC3B,KAAK,EAAE,CAAC,QAAQ;YAChB,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC;YACxB,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC;YACzC,UAAU,EAAE,KAAK,CAAC,OAAO,KAAK,MAAM;SACvC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,gBAAgB,CAC1B,IAAI,EACJ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,EACnE,GAAG,EACH,OAAO,CACV,CAAC;QACF,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAEpD,kEAAkE;QAClE,mEAAmE;QACnE,oEAAoE;QACpE,oDAAoD;QACpD,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QACrD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,WAAW,CAAC;QAC9E,yDAAyD;QACzD,qEAAqE;QACrE,oEAAoE;QACpE,aAAa;QACb,MAAM,GAAG,GAAgB;YACrB,CAAC,EAAE,UAAU;YACb,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,KAAK,EAAE,WAAW,GAAG,UAAU;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,GAAG,aAAa,GAAG,MAAM,CAAC,GAAG;SAClE,CAAC;QACF,yDAAyD;QACzD,kDAAkD;QAClD,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC;QACvB,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAClE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,oEAAoE;QACpE,IAAI,EAAE,EAAE,CAAC;YACL,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YACnC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC9C,CAAC;QACD,GAAG,CAAC,cAAc,GAAG,eAAe,CAAC;QACrC,MAAM,cAAc,GAAG,QAAQ;YAC3B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,8BAA8B,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,OAAO;YACH,IAAI,EAAE,OAAO;YACb,EAAE;YACF,KAAK;YACL,GAAG;YACH,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,QAAQ;YACR,KAAK;YACL,cAAc,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;YACtE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAC;IACN,CAAC;CACJ"}

package/dist/nodes/header-node.d.ts

@@ -0,0 +1,56 @@
+import type { ScaledLogo } from '../header-logo.js';
+import type { HeaderPosition, PositionedHeader, ResolvedStyle } from '../types.js';
+export interface MeasuredHeader {
+    position: HeaderPosition;
+    titleLines: string[];
+    authorLines: string[];
+    cardWidth: number;
+    /** Card height, grown when the logo is taller than the text. */
+    cardHeight: number;
+    /** Card height the title / author text alone needs. */
+    textCardHeight: number;
+    /** Width the logo takes left of the text, gap included; 0 without a logo. */
+    logoSlot: number;
+    logo?: ScaledLogo;
+    /** Beside: the card's box width, which is also `chartLeftX`. Above: 0. */
+    chartLeftX: number;
+    /** Above: the band height, bumped for an `xl` logo. Beside never reads it. */
+    aboveHeight: number;
+    /** Where the chart may start: below the canvas top, or below the above band. */
+    chartTopY: number;
+    /** Beside: the lowest the header rows may end so the card fits (card + 4 px inset). Above: 0. */
+    minRowsBottomY: number;
+}
+/** The positioned header without its attribution box, which finalize adds last. */
+export type PositionedHeaderParts = Omit<PositionedHeader, 'attributionBox'>;
+/** Where the chart ended up, as far as the header needs to know. */
+export interface HeaderFrame {
+    /** Bottom of the header rows; the beside card's bottom hugs it. */
+    rowsBottomY: number;
+    /** Bottom of the chart; the beside header column runs down to it. */
+    chartBottomY: number;
+    /** The final canvas right edge; the above band spans to it. */
+    canvasRightX: number;
+}
+export interface HeaderNodeInput {
+    /** The roadmap's title (or name); an empty string when it has neither. */
+    title: string;
+    author?: string;
+    /** The resolved `default roadmap` style; `headerPosition` picks the mode. */
+    style: ResolvedStyle;
+    /** The drawn logo size, when the file declares a logo and the caller loaded one. */
+    logo?: ScaledLogo;
+}
+export declare class HeaderNode {
+    private readonly input;
+    constructor(input: HeaderNodeInput);
+    measure(): MeasuredHeader;
+    /**
+     * The header box, the card, the logo box and the text inset, once the
+     * chart's extent is known. Beside: a column `chartLeftX` wide down to
+     * the chart bottom, with the card's bottom on `rowsBottomY`. Above: a
+     * band `aboveHeight` tall across the canvas, the card filling it.
+     */
+    place(measured: MeasuredHeader, frame: HeaderFrame): PositionedHeaderParts;
+}
+//# sourceMappingURL=header-node.d.ts.map

package/dist/nodes/header-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-node.d.ts","sourceRoot":"","sources":["../../src/nodes/header-node.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOpE,OAAO,KAAK,EAAe,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAehG,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,mFAAmF;AACnF,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;AAE7E,oEAAoE;AACpE,MAAM,WAAW,WAAW;IACxB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,KAAK,EAAE,aAAa,CAAC;IACrB,oFAAoF;IACpF,IAAI,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,qBAAa,UAAU;IACP,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAlC,YAA6B,KAAK,EAAE,eAAe,EAAI;IAEvD,OAAO,IAAI,cAAc,CA+BxB;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,GAAG,qBAAqB,CAmDzE;CACJ"}