@nowline/layout 0.8.5 → 0.9.0

package/dist/nodes/header-node.js

@@ -0,0 +1,163 @@
+// HeaderNode — the roadmap header (title, author, company logo) in both
+// positions, `beside` (a card left of the chart) and `above` (a band over
+// it). `measure` sizes it before anything else is laid out, because the
+// header decides where the chart starts: its left edge in beside mode,
+// its top in above mode, and how low the header rows must end so the
+// beside card fits (specs/layout-phases.md §3.7).
+//
+// HeaderNode does not implement `Renderable`: that signature is built
+// around a time scale and a row band, which a header has no use for.
+import { HEADER_AUTHOR_FONT_SIZE_PX, HEADER_AUTHOR_LINE_HEIGHT_PX, HEADER_CARD_PADDING_BOTTOM, HEADER_CARD_PADDING_TOP, HEADER_CARD_PADDING_X, HEADER_LOGO_GAP_PX, HEADER_LOGO_PAD_Y_PX, HEADER_TITLE_FONT_SIZE_PX, HEADER_TITLE_LINE_HEIGHT_PX, HEADER_TITLE_TO_AUTHOR_GAP_PX, } from '../header-card-geometry.js';
+import { estimateTextWidth, wrapText } from '../text-measure.js';
+import { HEADER_ABOVE_HEIGHT_PX, HEADER_BESIDE_MAX_WIDTH_PX, HEADER_BESIDE_MIN_WIDTH_PX, } from '../themes/shared.js';
+// Left margin between the canvas's left edge and the visible card. The
+// matching right-side breathing room is owned by `GUTTER_PX` (the canonical
+// content gutter, applied between `chartLeftX` and `originX`), so the gap
+// from the card's right edge to the timeline strip is the same as the gap
+// between two adjacent items.
+const HEADER_CARD_OUTER_PAD = 6;
+/** Clearance (px) the beside card keeps from the canvas top. */
+const HEADER_CARD_TOP_INSET = 4;
+/** Gap (px) between the header (or the canvas top) and the chart. */
+const CHART_TOP_GAP_PX = 8;
+export class HeaderNode {
+    input;
+    constructor(input) {
+        this.input = input;
+    }
+    measure() {
+        const { title, author, style, logo } = this.input;
+        const isBeside = style.headerPosition === 'beside';
+        // Pre-size the beside-mode header card. Width = max line width +
+        // padding, clamped to MIN..MAX with word-wrap once the title
+        // exceeds MAX. Above mode keeps the fixed-strip geometry (full
+        // canvas width, fixed height) but still reads the wrapped lines.
+        const sized = sizeBesideHeader(title, author, logo);
+        // Above-mode strip: fixed height, bumped only when the logo plus
+        // its clearance is taller (`logo-size:xl`).
+        const aboveHeight = logo
+            ? Math.max(HEADER_ABOVE_HEIGHT_PX, logo.height + 2 * HEADER_LOGO_PAD_Y_PX)
+            : HEADER_ABOVE_HEIGHT_PX;
+        return {
+            position: style.headerPosition,
+            titleLines: sized.titleLines,
+            authorLines: sized.authorLines,
+            cardWidth: sized.cardWidth,
+            cardHeight: sized.cardHeight,
+            textCardHeight: sized.textCardHeight,
+            logoSlot: sized.logoSlot,
+            ...(logo ? { logo } : {}),
+            chartLeftX: isBeside ? sized.boxWidth : 0,
+            aboveHeight,
+            chartTopY: isBeside ? CHART_TOP_GAP_PX : aboveHeight + CHART_TOP_GAP_PX,
+            // In beside mode the card's BOTTOM aligns with the bottom of the
+            // header rows so it visually anchors to the chart's top. The
+            // rows must end low enough for the card plus a 4 px top inset;
+            // the measure phase pushes the timeline down when they would not.
+            minRowsBottomY: isBeside ? sized.cardHeight + HEADER_CARD_TOP_INSET : 0,
+        };
+    }
+    /**
+     * 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, frame) {
+        const { title, author, style } = this.input;
+        const isBeside = measured.position === 'beside';
+        const box = isBeside
+            ? { x: 0, y: 0, width: measured.chartLeftX, height: frame.chartBottomY }
+            : { x: 0, y: 0, width: frame.canvasRightX, height: measured.aboveHeight };
+        // The visible card inside the box. Beside, its BOTTOM hugs the
+        // bottom of the header rows so the title block anchors to the
+        // chart's top edge whichever header rows are present; the measure
+        // phase already pushed the rows down far enough for the card to
+        // keep HEADER_CARD_TOP_INSET from the canvas top.
+        const cardBox = isBeside
+            ? {
+                x: HEADER_CARD_OUTER_PAD,
+                y: frame.rowsBottomY - measured.cardHeight,
+                width: measured.cardWidth,
+                height: measured.cardHeight,
+            }
+            : { x: 0, y: 0, width: frame.canvasRightX, height: measured.aboveHeight };
+        // Logo at the card's left padding, vertically centered; the text
+        // shifts right past it and centers in the (possibly taller) card.
+        let logo;
+        let textInset;
+        if (measured.logo) {
+            logo = {
+                box: {
+                    x: box.x + cardBox.x + HEADER_CARD_PADDING_X,
+                    y: box.y + cardBox.y + (cardBox.height - measured.logo.height) / 2,
+                    width: measured.logo.width,
+                    height: measured.logo.height,
+                },
+                assetRef: measured.logo.assetRef,
+                intrinsic: measured.logo.intrinsic,
+            };
+            textInset = {
+                x: measured.logoSlot,
+                y: Math.max(0, (cardBox.height - measured.textCardHeight) / 2),
+            };
+        }
+        return {
+            box,
+            position: style.headerPosition,
+            title,
+            author,
+            titleLines: measured.titleLines,
+            authorLines: measured.authorLines,
+            cardBox,
+            logo,
+            ...(textInset ? { textInset } : {}),
+            style,
+        };
+    }
+}
+function sizeBesideHeader(title, author, logo) {
+    const maxContentWidth = HEADER_BESIDE_MAX_WIDTH_PX - 2 * HEADER_CARD_PADDING_X;
+    const titleLines = wrapText(title, maxContentWidth, HEADER_TITLE_FONT_SIZE_PX);
+    const authorLines = wrapText(author ?? '', maxContentWidth, HEADER_AUTHOR_FONT_SIZE_PX);
+    let widest = 0;
+    for (const line of titleLines)
+        widest = Math.max(widest, estimateTextWidth(line, HEADER_TITLE_FONT_SIZE_PX));
+    for (const line of authorLines)
+        widest = Math.max(widest, estimateTextWidth(line, HEADER_AUTHOR_FONT_SIZE_PX));
+    // A logo sits left of the text and widens the card past the text-only
+    // MAX clamp (which bounds the text column, not the logo slot).
+    const hasText = titleLines.length > 0 || authorLines.length > 0;
+    const logoSlot = logo ? logo.width + (hasText ? HEADER_LOGO_GAP_PX : 0) : 0;
+    const naturalCardWidth = widest + 2 * HEADER_CARD_PADDING_X;
+    // `HEADER_BESIDE_{MIN,MAX}_WIDTH_PX` bound the **boxWidth** (= cardWidth
+    // + left outer pad). Subtract one outer pad to derive the cardWidth
+    // bounds.
+    const cardWidth = Math.max(HEADER_BESIDE_MIN_WIDTH_PX - HEADER_CARD_OUTER_PAD, Math.min(HEADER_BESIDE_MAX_WIDTH_PX - HEADER_CARD_OUTER_PAD, naturalCardWidth) + logoSlot);
+    const titleBlockHeight = titleLines.length > 0 ? (titleLines.length - 1) * HEADER_TITLE_LINE_HEIGHT_PX : 0;
+    const authorBlockHeight = authorLines.length > 0
+        ? HEADER_TITLE_TO_AUTHOR_GAP_PX +
+            (authorLines.length - 1) * HEADER_AUTHOR_LINE_HEIGHT_PX
+        : 0;
+    const textCardHeight = HEADER_CARD_PADDING_TOP + titleBlockHeight + authorBlockHeight + HEADER_CARD_PADDING_BOTTOM;
+    // A logo taller than the text block grows the card; logo and text are
+    // then both centered vertically.
+    const cardHeight = logo
+        ? Math.max(textCardHeight, logo.height + 2 * HEADER_LOGO_PAD_Y_PX)
+        : textCardHeight;
+    // `boxWidth` only includes the LEFT outer pad — the right-side breathing
+    // room between the card and the chart is owned by `GUTTER_PX` in the
+    // measure phase. So `boxWidth` doubles as `chartLeftX` (the card's right
+    // edge in canvas coordinates).
+    const boxWidth = cardWidth + HEADER_CARD_OUTER_PAD;
+    return {
+        titleLines,
+        authorLines,
+        cardWidth,
+        cardHeight,
+        textCardHeight,
+        logoSlot,
+        boxWidth,
+    };
+}
+//# sourceMappingURL=header-node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"header-node.js","sourceRoot":"","sources":["../../src/nodes/header-node.ts"],"names":[],"mappings":"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"}

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

@@ -1,16 +1,26 @@
-import type { EntityProperty, GroupBlock, IsolatedRegion, ItemDeclaration, ParallelBlock } from '@nowline/core';
-import type { LayoutContext, TrackCursor } from '../layout-context.js';
-import type { PositionedIncludeRegion, PositionedItem, PositionedTrackChild } from '../types.js';
-export interface IncludeNodeDeps {
-    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;
-    predictItemChipExtraHeight: (item: ItemDeclaration, ctx: LayoutContext) => number;
-}
-export declare function buildIncludeRegions(regions: IsolatedRegion[], ctx: LayoutContext, startY: number, deps: IncludeNodeDeps): {
+import type { IsolatedRegion } from '@nowline/core';
+import { type LayoutContext, type LayoutHelpers } from '../layout-context.js';
+import type { PositionedIncludeRegion } from '../types.js';
+export declare function buildIncludeRegions(regions: IsolatedRegion[], ctx: LayoutContext, startY: number, helpers: LayoutHelpers, chartRightX: number): {
     regions: PositionedIncludeRegion[];
+    contexts: LayoutContext[];
     endY: number;
 };
+/**
+ * Size an include's bounding box to the diagram's content: it reaches past
+ * `contentRightX`, the furthest bar, spilled caption, marker or now-line
+ * anywhere in the chart (and past its own chrome), by a small right pad,
+ * so every region in a chart ends at the same edge (specs/rendering.md,
+ * Included Roadmaps). It is clamped to `chartRightX`;
+ * finalize grows the canvas to hold the pad first (f3). Finalize runs it
+ * once per kept region (f4), after the canvas width is final: the spill
+ * growth, the timeline extension and the marker labels can all still grow
+ * the canvas after the region is placed.
+ */
+export declare function fitIncludeRegionWidth(region: PositionedIncludeRegion, chartRightX: number, contentRightX: number): void;
+/**
+ * The width `fitIncludeRegionWidth` gives `region` on a canvas ending at
+ * `chartRightX`, with the diagram's content ending at `contentRightX`.
+ */
+export declare function includeRegionWidth(region: PositionedIncludeRegion, chartRightX: number, contentRightX: number): number;
 //# sourceMappingURL=include-node.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"include-node.d.ts","sourceRoot":"","sources":["../../src/nodes/include-node.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACR,cAAc,EACd,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EAChB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,KAAK,EAER,uBAAuB,EACvB,cAAc,EAEd,oBAAoB,EACvB,MAAM,aAAa,CAAC;AAcrB,MAAM,WAAW,eAAe;IAC5B,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,0BAA0B,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;CACrF;AAED,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,cAAc,EAAE,EACzB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,eAAe,GACtB;IAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAyGtD"}
+{"version":3,"file":"include-node.d.ts","sourceRoot":"","sources":["../../src/nodes/include-node.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,EAAuB,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEnG,OAAO,KAAK,EAAe,uBAAuB,EAAsB,MAAM,aAAa,CAAC;AAuB5F,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,cAAc,EAAE,EACzB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM,GACpB;IAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgGjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,uBAAuB,EAC/B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACtB,IAAI,CASN;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,uBAAuB,EAC/B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACtB,MAAM,CAYR"}

package/dist/nodes/include-node.js

@@ -4,118 +4,151 @@
 // vertically with the tick row above the region. The label tab is
 // reserved 18 px above the first region; subsequent regions are
 // separated by GAP_BETWEEN_REGIONS px.
-import { resolveSizes } from '../calendar.js';
+import { translateSwimlaneY } from '../chart-translation.js';
 import { includeChromeGeometry } from '../include-chrome-geometry.js';
+import { createLayoutContext } from '../layout-context.js';
 import { resolveStyle } from '../style-resolution.js';
+import { seedWaveEdges } from '../wave-layout.js';
+import { maxLeafItemRightX } from './content-extent.js';
+import { indexFootnotes } from './footnote-node.js';
+import { placeRegionMarkers, regionMarkerLabelsRightX, seedRegionAnchorEdges, } from './region-markers.js';
 import { SwimlaneNode } from './swimlane-node.js';
 const TAB_RESERVE = 18;
 const REGION_INSET_TOP = 14;
 const REGION_INSET_BOTTOM = 14;
 const GAP_BETWEEN_REGIONS = 16;
 // Visual breathing room added past the rightmost element when sizing
-// the include's bounding box. Keeps the dashed bracket from butting up
-// against an item's right edge while still trimming the wide
-// chart-width whitespace left over from full-width sizing.
-const INCLUDE_CONTENT_RIGHT_PAD_PX = 32;
-export function buildIncludeRegions(regions, ctx, startY, deps) {
+// the include's bounding box. The rightmost element is the diagram's, not
+// the region's own: every region reaches the same edge, past the furthest
+// bar, spilled caption, marker or now-line anywhere in the chart. The
+// renderer insets the dashed rect by 8 px, so its edge sits 16 px past it.
+const INCLUDE_CONTENT_RIGHT_PAD_PX = 24;
+export function buildIncludeRegions(regions, ctx, startY, helpers, chartRightX) {
     let y = startY + TAB_RESERVE;
     const out = [];
+    const contexts = [];
     let isFirst = true;
+    // Region footnotes number on after the host's, in include order.
+    let footnotesBefore = ctx.footnoteIndex.size;
     for (const region of regions) {
         if (!isFirst)
             y += GAP_BETWEEN_REGIONS;
         isFirst = false;
         const label = region.content.roadmap?.title ?? region.sourcePath;
         const innerStartY = y + REGION_INSET_TOP;
-        const childCtx = {
+        const childCtx = createLayoutContext(region, {
+            theme: ctx.styleCtx.theme,
             cal: ctx.cal,
-            styleCtx: {
-                theme: ctx.styleCtx.theme,
-                styles: region.config.styles,
-                defaults: region.config.defaults,
-                labels: region.content.labels,
-            },
-            // Each include region declares its own sizes; resolve them under
-            // the parent's calendar so child sized items render at the same
-            // pixels-per-day scale as the host roadmap.
-            sizes: resolveSizes(region.content.sizes, ctx.cal),
-            labels: region.content.labels,
-            teams: region.content.teams,
-            persons: region.content.persons,
-            symbols: region.config.symbols,
-            footnoteIndex: new Map(),
-            footnoteHosts: new Map(),
+            schedule: ctx.schedule,
             timeline: ctx.timeline,
             scale: ctx.scale,
             calendar: ctx.calendar,
+            axisColumns: ctx.axisColumns,
             bandScale: ctx.bandScale,
-            entityLeftEdges: new Map(),
-            entityRightEdges: new Map(),
-            entityMidpoints: new Map(),
-            entityVisualLeftX: new Map(),
-            entityVisualRightX: new Map(),
-            itemArrowSource: new Map(),
-            itemFlowKey: new Map(),
-            currentFlowKey: '',
-            itemSlackAttachY: new Map(),
-            slackCorridors: [],
-            markerRowPlacements: new Map(),
+            waves: ctx.waves,
+        }, {
             chartTopY: innerStartY,
             chartBottomY: innerStartY,
             swimlaneBottomY: innerStartY,
-            chartRightX: ctx.chartRightX,
-            nextParallelId: 0,
-            nextGroupId: 0,
-        };
+        }, { footnotes: indexFootnotes(region.content.footnotes, footnotesBefore) });
+        footnotesBefore += region.content.footnotes.size;
+        // Region ids stay invisible to the host, but the wave edges are
+        // shared: seed them into the region's otherwise empty edge maps.
+        // Without waves, the region's own dated anchors resolve inside it
+        // instead, as engine C's `scheduleRegion` resolves them, so a lane
+        // `after:kickoff` naming the region's anchor starts on its date
+        // (specs/scheduler-unification.md §5 F5).
+        if (ctx.waves) {
+            seedWaveEdges(ctx.waves, childCtx.entityLeftEdges, childCtx.entityRightEdges);
+        }
+        else {
+            seedRegionAnchorEdges(region.content.anchors, childCtx);
+        }
         const nestedSwimlanes = [];
         let cursorY = innerStartY;
         let bandIndex = 0;
-        let nestedContentRightX = childCtx.timeline.originX;
         for (const lane of region.content.swimlanes.values()) {
             childCtx.nextParallelId = 0;
             childCtx.nextGroupId = 0;
-            const { positioned, usedHeight, usedRightX } = new SwimlaneNode({ lane, bandIndex }, deps).place({ x: childCtx.timeline.originX, y: cursorY }, childCtx);
+            const { positioned, usedHeight } = new SwimlaneNode({ lane, bandIndex }, helpers).place({ x: childCtx.timeline.originX, y: cursorY }, childCtx);
             nestedSwimlanes.push(positioned);
             cursorY += usedHeight;
             bandIndex++;
-            if (usedRightX > nestedContentRightX)
-                nestedContentRightX = usedRightX;
+        }
+        // The region's own anchors and milestones take a marker row under
+        // its label tab, and the lanes move down below it.
+        const markers = placeRegionMarkers(region, childCtx, y, innerStartY, cursorY, chartRightX);
+        if (markers.laneShift !== 0) {
+            for (const lane of nestedSwimlanes)
+                translateSwimlaneY(lane, markers.laneShift);
+            cursorY += markers.laneShift;
         }
         const innerEndY = cursorY;
         // Floor the region height to one row's bandwidth so an empty or
         // tiny include still presents as a visible band — `bandwidth()`
         // tracks whatever the host theme uses for swimlane row height.
         const regionHeight = Math.max(ctx.bandScale.bandwidth(), innerEndY - y + REGION_INSET_BOTTOM);
-        // Shrink-wrap the include's bounding box to fit chrome + content
-        // (with a small right pad) instead of stretching to the full
-        // chart width. An include that reaches past the timeline still
-        // gets clamped to the chart's natural right edge so it never
-        // extends into the attribution / right-margin area.
-        const boxX = 0;
-        const { chromeRightX } = includeChromeGeometry(boxX, label, region.sourcePath);
-        const naturalRightX = Math.max(chromeRightX, nestedContentRightX) + INCLUDE_CONTENT_RIGHT_PAD_PX;
-        const boxWidth = Math.min(ctx.chartRightX - boxX, naturalRightX - boxX);
+        // The width waits for the final canvas: finalize (f4) fits every
+        // kept region with `fitIncludeRegionWidth` once the canvas stops
+        // growing, so placement never reads the canvas.
         const box = {
-            x: boxX,
+            x: 0,
             y,
-            width: boxWidth,
+            width: 0,
             height: regionHeight,
         };
-        // Mirror the shrunk width onto each nested swimlane band so the
-        // tinted background fits inside the dashed bracket instead of
-        // bleeding past it on the right.
-        for (const lane of nestedSwimlanes) {
-            lane.box.width = boxWidth;
-        }
-        out.push({
+        const positioned = {
             sourcePath: region.sourcePath,
             label,
             box,
             nestedSwimlanes,
             style: resolveStyle('swimlane', [], ctx.styleCtx),
-        });
+        };
+        if (markers.anchors.length > 0)
+            positioned.anchors = markers.anchors;
+        if (markers.milestones.length > 0)
+            positioned.milestones = markers.milestones;
+        out.push(positioned);
+        contexts.push(childCtx);
         y += regionHeight;
     }
-    return { regions: out, endY: y };
+    return { regions: out, contexts, endY: y };
+}
+/**
+ * Size an include's bounding box to the diagram's content: it reaches past
+ * `contentRightX`, the furthest bar, spilled caption, marker or now-line
+ * anywhere in the chart (and past its own chrome), by a small right pad,
+ * so every region in a chart ends at the same edge (specs/rendering.md,
+ * Included Roadmaps). It is clamped to `chartRightX`;
+ * finalize grows the canvas to hold the pad first (f3). Finalize runs it
+ * once per kept region (f4), after the canvas width is final: the spill
+ * growth, the timeline extension and the marker labels can all still grow
+ * the canvas after the region is placed.
+ */
+export function fitIncludeRegionWidth(region, chartRightX, contentRightX) {
+    const boxWidth = includeRegionWidth(region, chartRightX, contentRightX);
+    region.box.width = boxWidth;
+    // Mirror the shrunk width onto each nested swimlane band so the
+    // tinted background fits inside the dashed bracket instead of
+    // bleeding past it on the right.
+    for (const lane of region.nestedSwimlanes) {
+        lane.box.width = boxWidth;
+    }
+}
+/**
+ * The width `fitIncludeRegionWidth` gives `region` on a canvas ending at
+ * `chartRightX`, with the diagram's content ending at `contentRightX`.
+ */
+export function includeRegionWidth(region, chartRightX, contentRightX) {
+    const boxX = region.box.x;
+    const { chromeRightX } = includeChromeGeometry(boxX, region.label, region.sourcePath);
+    // Bars-only extent (never a spilled caption — see
+    // `maxLeafItemRightX`), so a long trailing item caption inside
+    // the include can overhang the dashed bracket instead of
+    // dragging it wider.
+    const barsRightX = maxLeafItemRightX(region.nestedSwimlanes);
+    const naturalRightX = Math.max(chromeRightX, barsRightX, regionMarkerLabelsRightX(region), contentRightX) +
+        INCLUDE_CONTENT_RIGHT_PAD_PX;
+    return Math.min(chartRightX - boxX, naturalRightX - boxX);
 }
 //# sourceMappingURL=include-node.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"include-node.js","sourceRoot":"","sources":["../../src/nodes/include-node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"include-node.js","sourceRoot":"","sources":["../../src/nodes/include-node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/item-measure.d.ts

@@ -0,0 +1,135 @@
+import type { EntityProperty, ItemDeclaration, LabelDeclaration } from '@nowline/core';
+import { type ChipRowSample, type SpillChipPack } from '../item-bar-geometry.js';
+import { type LayoutContext } from '../layout-context.js';
+import { type StyleContext } from '../style-resolution.js';
+import type { LinkIconKind, PositionedCapacity, PositionedLabelChip, ResolvedSize, ResolvedStyle, StatusKind } from '../types.js';
+import { type ItemCaptionMeasure, type ItemNodeGeometry } from './item-node.js';
+/** A label chip measured at its natural width, before it is placed. */
+export type ChipSample = ChipRowSample<LabelDeclaration>;
+export interface ResolvedItemMeta {
+    /** Secondary line text under the title, or undefined when none. */
+    metaText: string | undefined;
+    ownerDisplay: string | undefined;
+    capacity: PositionedCapacity | null;
+    /** Estimated px width of the capacity suffix (incl. its separator). */
+    capacityTrailingWidth: number;
+}
+export interface ItemMeasure extends ItemNodeGeometry {
+    node: ItemDeclaration;
+    /** The snapped start the bar is measured at (`ctx.scale.startX`). */
+    startX: number;
+    durationDays: number;
+    /** Logical width: the item's span in time. */
+    naturalWidth: number;
+    /**
+     * The bar box width: the logical extent `(startX + naturalWidth) -
+     * startX` less the insets, as `ItemNode` has always computed it. The
+     * caption fit, the narrow-bar spills and the chip pack read it.
+     */
+    visualWidth: number;
+    /**
+     * `naturalWidth` less the insets. Equal to `visualWidth` up to the
+     * rounding of the logical extent; the inside-chip fit and the title's
+     * first-line reserve read this one, as they always have.
+     */
+    naturalVisualWidth: number;
+    /** Resolved style with the status tint applied (a copy, never the shared object). */
+    style: ResolvedStyle;
+    /** The `size:` declaration the item names, or null. */
+    size: ResolvedSize | null;
+    status: StatusKind;
+    progress: number;
+    meta: ResolvedItemMeta;
+    link: {
+        icon: LinkIconKind;
+        href?: string;
+    };
+    chips: {
+        samples: ChipSample[];
+        outside: boolean;
+        pack: SpillChipPack<LabelDeclaration> | null;
+        rowCount: number;
+    };
+    footnoteIndicators: number[];
+    caption: ItemCaptionMeasure & {
+        /** The title as declared (`title ?? name ?? ''`). */
+        title: string;
+        /** A narrow bar pushes the link icon, and with it the caption, out of the bar. */
+        iconSpills: boolean;
+        /**
+         * The lines the title paints on (see `resolveCaptionTitleLines`),
+         * each truncated with `…` when the spilled caption is capped at the
+         * chart's end (`capCaptionAtAxisEnd`).
+         */
+        lines: string[];
+        /** True when the cap truncated a line; the full title stays the bar's tooltip. */
+        truncated: boolean;
+        /** Baseline of the caption's last line, px from the bar's top. */
+        lastBaseline: number;
+    };
+    /** Growth over the band height: max(title extra, chip extra). */
+    barExtra: number;
+}
+export declare function statusFromProp(raw: string | undefined): StatusKind;
+export declare function parseLinkIcon(link: string | undefined): {
+    icon: LinkIconKind;
+    href?: string;
+};
+export declare function buildLabelChip(label: LabelDeclaration, ctx: StyleContext, x: number, y: number, maxWidth?: number): PositionedLabelChip;
+/**
+ * Status kind and 0..1 progress fraction for an item: a pure function of
+ * the item's properties and the layout scope.
+ */
+export declare function resolveItemProgress(props: EntityProperty[], ctx: LayoutContext): {
+    status: StatusKind;
+    progress: number;
+};
+/**
+ * Assemble an item's meta line and capacity suffix. The caption fit needs
+ * the real meta width to know whether a title wraps or spills, and
+ * `sequenceItem` paints from the same result.
+ */
+export declare function resolveItemMeta(props: EntityProperty[], ctx: LayoutContext, sizeResolved: ResolvedSize | null, status: StatusKind, progress: number, capacityIconName: string): ResolvedItemMeta;
+/**
+ * Footnote numbers attached to an item, ascending. Per `specs/dsl.md`,
+ * footnotes attach via the `on:` property on the footnote declaration
+ * only — there is no forward `footnote:` property on the host entity.
+ * Walk `footnoteHosts` (built from each footnote's `on:` list) and
+ * collect every footnote that names this item. The caption fit needs
+ * them, since the indicators narrow the title's first line.
+ */
+export declare function collectItemFootnoteIndicators(name: string | undefined, ctx: LayoutContext): number[];
+/**
+ * How far the title's first line must stay from the bar's right edge so
+ * it clears the top-right decoration cluster.
+ */
+export declare function resolveTitleFirstLineReserve(barWidth: number, footnoteIndicators: readonly number[], beforeRaw: readonly string[]): number;
+/**
+ * Compute the extra vertical px the bar grows to fit its label chips
+ * (a spilled chip column, or inside-bar chips stacked below a caption
+ * that reaches past the default chip row). The bar's painted footprint
+ * becomes `bandwidth + chipBarExtra`, the progress strip rides the new
+ * bottom, and chip rows pack inside the taller bar (anchored from the
+ * bar TOP so row 0 doesn't shift when the bar grows).
+ *
+ * Returns 0 when chips fit inside the bar, when there are no chips,
+ * or when the spilled column happens to fit inside `bandwidth` (a
+ * single row with the caption inside, for instance).
+ *
+ * `captionLastBaseline` is the in-bar caption's last text baseline
+ * (px from the bar's top): the meta baseline when the item has a meta
+ * line, otherwise the last title line's baseline. A wrapped title
+ * pushes it down; see `itemCaptionLastBaselineOffset`.
+ *
+ * The bar's final growth is `max(titleBarExtra, chipBarExtra)`; the
+ * same number is the row-pitch increase the swimlane / group
+ * row-packer reserves so the next row clears the taller bar.
+ */
+export declare function computeChipBarExtra(chipsOutside: boolean, captionSpills: boolean, chipRowCount: number, bandwidth: number, captionLastBaseline: number): number;
+/**
+ * Measure `node` as a bar starting at `startX`, the snapped start
+ * (`ctx.scale.startX`) it will be placed at. Pure: it writes nothing to
+ * `ctx`.
+ */
+export declare function measureItem(node: ItemDeclaration, startX: number, ctx: LayoutContext): ItemMeasure;
+//# sourceMappingURL=item-measure.d.ts.map

package/dist/nodes/item-measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-measure.d.ts","sourceRoot":"","sources":["../../src/nodes/item-measure.ts"],"names":[],"mappings":"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"}