@nowline/layout 0.0.0-dev.20260601071750.g04bdff9

package/dist/inline-date-pin-geometry.js

@@ -0,0 +1,149 @@
+// Inline-date pin glyph placement.
+//
+// `after:DATE` paints a calendar glyph in the entity's top-LEFT decoration
+// slot; `before:DATE` paints it in the top-RIGHT slot. The two helpers
+// below produce `Point` coordinates for the glyph's top-left corner, plus
+// a `spilled` flag indicating whether the bar was too narrow to host the
+// glyph inside (item case only — containers always have room).
+//
+// Slot interleaving rules (per specs/rendering.md "Inline-date glyph"):
+//
+//   Item top-LEFT: glyph sits at the bar's leftmost slot when no link icon
+//   is present, otherwise one decoration step right of the link icon's
+//   right edge.
+//
+//   Item top-RIGHT: glyph sits at the bar's rightmost slot when no status
+//   dot or footnotes are present, one step LEFT of the status dot when no
+//   footnotes, and one step LEFT of the LEFTMOST footnote indicator when
+//   footnotes are present (so the inline-date glyph inserts at the LEFT
+//   end of the existing badge cluster rather than reordering it).
+//
+//   Container (group, parallel): glyph sits at the bounding box's top
+//   corners with the standard inset. Containers don't carry status dots
+//   or footnote indicators in their own decoration row, so no
+//   interleaving math is needed.
+import { INLINE_DATE_GLYPH_GAP_PX, INLINE_DATE_GLYPH_INSET_LEFT_PX, INLINE_DATE_GLYPH_INSET_RIGHT_PX, INLINE_DATE_GLYPH_INSET_TOP_PX, INLINE_DATE_GLYPH_TILE_SIZE_PX, ITEM_CAPTION_SPILL_GAP_PX, ITEM_FOOTNOTE_INDICATOR_INSET_RIGHT_PX, ITEM_FOOTNOTE_INDICATOR_STEP_PX, ITEM_LINK_ICON_INSET_PX, ITEM_LINK_ICON_TILE_SIZE_PX, ITEM_STATUS_DOT_INSET_RIGHT_PX, ITEM_STATUS_DOT_RADIUS_PX, MIN_BAR_WIDTH_FOR_INLINE_DATE_PX, } from './item-bar-geometry.js';
+/**
+ * Compute inline-date pin glyph placements for an item bar. Returns an
+ * empty array when neither `afterDate` nor `beforeDate` is set.
+ *
+ * Item bars participate in the narrow-bar spill family — when the bar is
+ * narrower than `MIN_BAR_WIDTH_FOR_INLINE_DATE_PX`, the `before:` glyph
+ * spills RIGHT of the bar (joining the status-dot / footnote spill
+ * column) and the `after:` glyph spills LEFT of the bar's leading edge
+ * so the side semantics stay readable.
+ */
+export function computeItemInlineDatePins(opts) {
+    const { box, afterDate, beforeDate, hasLinkIcon, footnoteCount } = opts;
+    if (!afterDate && !beforeDate)
+        return [];
+    const pins = [];
+    const tileSize = INLINE_DATE_GLYPH_TILE_SIZE_PX;
+    const topY = box.y + INLINE_DATE_GLYPH_INSET_TOP_PX;
+    const spilled = box.width < MIN_BAR_WIDTH_FOR_INLINE_DATE_PX;
+    if (afterDate) {
+        const insideLeftX = hasLinkIcon
+            ? box.x +
+                ITEM_LINK_ICON_INSET_PX +
+                ITEM_LINK_ICON_TILE_SIZE_PX +
+                INLINE_DATE_GLYPH_GAP_PX
+            : box.x + INLINE_DATE_GLYPH_INSET_LEFT_PX;
+        const glyphLeft = spilled
+            ? {
+                x: box.x - ITEM_CAPTION_SPILL_GAP_PX - tileSize,
+                y: topY,
+            }
+            : { x: insideLeftX, y: topY };
+        pins.push({
+            side: 'after',
+            isoDate: afterDate,
+            glyphTopLeft: glyphLeft,
+            glyphSize: tileSize,
+            spilled,
+        });
+    }
+    if (beforeDate) {
+        // Walk LEFT from the rightmost top-decoration slot:
+        //   - rightmost footnote anchors at (box.right - INSET_RIGHT_PX)
+        //   - leftmost footnote sits one step further left per extra digit
+        //   - status dot left edge sits at (box.right - INSET_RIGHT - DOT_RADIUS)
+        //   - inline-date glyph sits one INLINE_DATE_GLYPH_GAP_PX further left
+        const rightEdge = box.x + box.width;
+        let anchorRightX;
+        if (footnoteCount > 0) {
+            const leftmostFootnoteCenter = rightEdge -
+                ITEM_FOOTNOTE_INDICATOR_INSET_RIGHT_PX -
+                (footnoteCount - 1) * ITEM_FOOTNOTE_INDICATOR_STEP_PX;
+            anchorRightX = leftmostFootnoteCenter - INLINE_DATE_GLYPH_GAP_PX;
+        }
+        else {
+            const dotLeftEdge = rightEdge - ITEM_STATUS_DOT_INSET_RIGHT_PX - ITEM_STATUS_DOT_RADIUS_PX;
+            anchorRightX = dotLeftEdge - INLINE_DATE_GLYPH_GAP_PX;
+        }
+        const insideRightX = anchorRightX - tileSize;
+        const glyphLeft = spilled
+            ? {
+                x: rightEdge + ITEM_CAPTION_SPILL_GAP_PX,
+                y: topY,
+            }
+            : { x: insideRightX, y: topY };
+        pins.push({
+            side: 'before',
+            isoDate: beforeDate,
+            glyphTopLeft: glyphLeft,
+            glyphSize: tileSize,
+            spilled,
+        });
+    }
+    return pins;
+}
+/**
+ * Compute inline-date pin glyph placements for a container (group or
+ * parallel). The glyphs sit flush to the box's top-LEFT (`after`) and
+ * top-RIGHT (`before`) corners with the standard inset; containers
+ * never spill (they always have room for a 12 px tile in their own
+ * top-decoration row).
+ */
+export function computeContainerInlineDatePins(opts) {
+    const { box, afterDate, beforeDate } = opts;
+    if (!afterDate && !beforeDate)
+        return [];
+    const pins = [];
+    const tileSize = INLINE_DATE_GLYPH_TILE_SIZE_PX;
+    const topY = box.y + INLINE_DATE_GLYPH_INSET_TOP_PX;
+    if (afterDate) {
+        pins.push({
+            side: 'after',
+            isoDate: afterDate,
+            glyphTopLeft: { x: box.x + INLINE_DATE_GLYPH_INSET_LEFT_PX, y: topY },
+            glyphSize: tileSize,
+            spilled: false,
+        });
+    }
+    if (beforeDate) {
+        pins.push({
+            side: 'before',
+            isoDate: beforeDate,
+            glyphTopLeft: {
+                x: box.x + box.width - INLINE_DATE_GLYPH_INSET_RIGHT_PX - tileSize,
+                y: topY,
+            },
+            glyphSize: tileSize,
+            spilled: false,
+        });
+    }
+    return pins;
+}
+/**
+ * Returns the first ISO date literal in `values`, or undefined when none
+ * is present. The validator enforces "at most one inline date per
+ * direction" so this lookup is unambiguous.
+ */
+export function pickInlineDate(values) {
+    for (const v of values) {
+        if (/^\d{4}-\d{2}-\d{2}$/.test(v))
+            return v;
+    }
+    return undefined;
+}
+//# sourceMappingURL=inline-date-pin-geometry.js.map

package/dist/inline-date-pin-geometry.js.map

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

package/dist/item-bar-geometry.d.ts

@@ -0,0 +1,157 @@
+/** Horizontal inset (px) for the caption's left edge inside the bar. */
+export declare const ITEM_CAPTION_INSET_X_PX = 12;
+/**
+ * When the bar's title would overflow to the right, layout sets
+ * `textSpills` and the caption renders to the RIGHT of the bar; this
+ * is the gap (px) between the bar's right edge and the spilled
+ * caption.
+ */
+export declare const ITEM_CAPTION_SPILL_GAP_PX = 6;
+/** Baseline Y of the title text relative to the bar's top. */
+export declare const ITEM_CAPTION_TITLE_BASELINE_OFFSET_PX = 20;
+/** Baseline Y of the meta text (second line) relative to the bar's top. */
+export declare const ITEM_CAPTION_META_BASELINE_OFFSET_PX = 38;
+/** Font size (px) of the title text. */
+export declare const ITEM_CAPTION_TITLE_FONT_SIZE_PX = 13;
+/** Font size (px) of the meta text. */
+export declare const ITEM_CAPTION_META_FONT_SIZE_PX = 11;
+/** Distance (px) from the bar's right edge to the dot's center. */
+export declare const ITEM_STATUS_DOT_INSET_RIGHT_PX = 12;
+/** Distance (px) from the bar's top edge to the dot's center. */
+export declare const ITEM_STATUS_DOT_INSET_TOP_PX = 12;
+/** Radius (px) of the status dot. */
+export declare const ITEM_STATUS_DOT_RADIUS_PX = 5;
+/**
+ * X offset (px from bar's right edge) where the rightmost footnote
+ * digit's anchor sits. Tuned to leave room for the status dot.
+ */
+export declare const ITEM_FOOTNOTE_INDICATOR_INSET_RIGHT_PX = 22;
+/** Baseline Y (px from bar's top) for footnote indicator digits. */
+export declare const ITEM_FOOTNOTE_INDICATOR_BASELINE_OFFSET_PX = 14;
+/**
+ * Horizontal step (px) between consecutive footnote indicators when
+ * an item carries more than one footnote — they walk LEFT from the
+ * status dot.
+ */
+export declare const ITEM_FOOTNOTE_INDICATOR_STEP_PX = 8;
+/** Side length (px) of the square link-icon tile. */
+export declare const ITEM_LINK_ICON_TILE_SIZE_PX = 14;
+/** Distance (px) from the bar's right/bottom edges to the tile's edge. */
+export declare const ITEM_LINK_ICON_INSET_PX = 6;
+/**
+ * Horizontal gap (px) between consecutive decorations (status dot,
+ * link icon, footnote, title) when they spill into the column to
+ * the right of a bar that's too narrow to host them inside.
+ */
+export declare const ITEM_DECORATION_SPILL_GAP_PX = 4;
+/**
+ * Minimum bar width (px) needed to host the status dot inside the
+ * bar with its full inset. Below this, the dot would have to
+ * extend past the bar's left edge, so the dot spills into the
+ * caption column to the right of the bar instead.
+ */
+export declare const MIN_BAR_WIDTH_FOR_DOT_PX: number;
+/**
+ * Minimum bar width (px) needed to host the link-icon tile AND the
+ * status dot inside the bar with at least
+ * `ITEM_DECORATION_SPILL_GAP_PX` of breathing room between them.
+ * Below this, the link icon would visually collide with (or push
+ * into) the dot's column, so the icon spills out and renders ahead
+ * of the (also-spilled) title.
+ */
+export declare const MIN_BAR_WIDTH_FOR_LINK_AND_DOT_PX: number;
+/**
+ * Minimum bar width (px) needed to host the footnote indicator at
+ * its inset-right position without overshooting the bar's left
+ * edge or colliding with a leading link icon. Approximate width
+ * for one digit is 8px (font-size 10, bold).
+ */
+export declare const MIN_BAR_WIDTH_FOR_FOOTNOTE_PX: number;
+/** Side length (px) of the inline-date calendar glyph tile. */
+export declare const INLINE_DATE_GLYPH_TILE_SIZE_PX = 12;
+/** Distance (px) from the bar's left edge to the glyph's left edge
+ *  when the glyph sits at the leftmost top-decoration slot (no link
+ *  icon present). */
+export declare const INLINE_DATE_GLYPH_INSET_LEFT_PX = 6;
+/** Distance (px) from the bar's right edge to the glyph's right edge
+ *  when the glyph sits at the rightmost top-decoration slot (no
+ *  status dot or footnote present). */
+export declare const INLINE_DATE_GLYPH_INSET_RIGHT_PX = 6;
+/** Distance (px) from the bar's top edge to the glyph's top edge. */
+export declare const INLINE_DATE_GLYPH_INSET_TOP_PX = 5;
+/** Horizontal gap (px) between the inline-date glyph and an adjacent
+ *  decoration (link icon on the left, status dot / footnote indicator
+ *  on the right). Matches the existing decoration spill gap so the
+ *  top-decoration row reads as one rhythm. */
+export declare const INLINE_DATE_GLYPH_GAP_PX = 4;
+/**
+ * Minimum bar width (px) needed to host the inline-date glyph inside
+ * the bar. Below this, the glyph spills:
+ *   - `before:` glyph spills RIGHT into the column the status dot
+ *     uses (same family of decorations, same step pitch).
+ *   - `after:` glyph spills LEFT of the bar's leading edge so the
+ *     side semantics (after vs before) stay readable in the spill.
+ *
+ * The threshold reserves room for the glyph itself plus a small
+ * clearance from the link-icon column (when present) so the two
+ * glyphs don't overlap inside narrow bars.
+ */
+export declare const MIN_BAR_WIDTH_FOR_INLINE_DATE_PX: number;
+/** Height (px) of a label chip rectangle. */
+export declare const LABEL_CHIP_HEIGHT_PX = 13;
+/**
+ * Vertical gap (px) between the top of the bottom progress strip and
+ * the BOTTOM of a label chip. Keeps chips from touching the strip and
+ * gives a clear visual rail.
+ */
+export declare const LABEL_CHIP_GAP_ABOVE_PROGRESS_STRIP_PX = 3;
+/** Horizontal gap (px) between consecutive chips in a row. */
+export declare const LABEL_CHIP_GAP_BETWEEN_PX = 4;
+/**
+ * Vertical gap (px) between two stacked chip rows when chips spill
+ * outside the bar and form a multi-row column to the right.
+ */
+export declare const LABEL_CHIP_ROW_GAP_PX = 4;
+/**
+ * Vertical row pitch (px) for a stacked chip column — chip height +
+ * inter-row gap.
+ */
+export declare const LABEL_CHIP_ROW_STEP_PX: number;
+/**
+ * Slack budget (fraction) applied ONCE per item when chips spill
+ * outside the bar. If a chip would overflow its row by less than
+ * `SPILL_ROW_SLACK_FRACTION × chip.width`, the row is allowed to
+ * stretch by the overflow amount and keep the chip on it instead of
+ * wrapping. This rescues "lonely chip" cases where one chip just
+ * barely overshoots; once the slack is consumed, no further row
+ * expansions happen for that item.
+ */
+export declare const SPILL_ROW_SLACK_FRACTION = 0.25;
+export interface ChipRowSample<T> {
+    id: T;
+    width: number;
+}
+export interface SpillChipPack<T> {
+    /** Rows ordered top-to-bottom — `rows[0]` sits at the chip
+     *  column's top y, `rows[1]` one `LABEL_CHIP_ROW_STEP_PX` below,
+     *  and so on. */
+    rows: ChipRowSample<T>[][];
+    /** True when the slack rule was used to keep an extra chip on
+     *  row 0 (or whichever row was being filled when the overflow
+     *  happened). At most one expansion per item. */
+    expanded: boolean;
+}
+/**
+ * Pack `chips` into rows for the SPILL column to the right of an
+ * item bar. Each row is capped at `barVisualWidth` (with gaps
+ * between chips). When a chip would overflow:
+ *
+ * - If the row is empty, place the chip anyway (a chip wider than
+ *   the cap occupies its own row).
+ * - Else if the slack rule applies (`overflow ≤ 0.25 × chip.width`)
+ *   AND the slack hasn't already been used for this item, expand
+ *   the current row by `overflow` and keep the chip on it.
+ * - Else wrap the chip to a fresh row.
+ */
+export declare function packSpillChips<T>(chips: ChipRowSample<T>[], barVisualWidth: number): SpillChipPack<T>;
+//# sourceMappingURL=item-bar-geometry.d.ts.map

package/dist/item-bar-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-bar-geometry.d.ts","sourceRoot":"","sources":["../src/item-bar-geometry.ts"],"names":[],"mappings":"AAkBA,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,8DAA8D;AAC9D,eAAO,MAAM,qCAAqC,KAAK,CAAC;AAExD,2EAA2E;AAC3E,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAEvD,wCAAwC;AACxC,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD,uCAAuC;AACvC,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAIjD,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,iEAAiE;AACjE,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,qCAAqC;AACrC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAI3C;;;GAGG;AACH,eAAO,MAAM,sCAAsC,KAAK,CAAC;AAEzD,oEAAoE;AACpE,eAAO,MAAM,0CAA0C,KAAK,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAIjD,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAIzC;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,QAA6D,CAAC;AAEnG;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,QAKjB,CAAC;AAE9B;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,QAA6C,CAAC;AAUxF,+DAA+D;AAC/D,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD;;qBAEqB;AACrB,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD;;uCAEuC;AACvC,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,qEAAqE;AACrE,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD;;;8CAG8C;AAC9C,eAAO,MAAM,wBAAwB,IAA+B,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gCAAgC,QAKT,CAAC;AAIrC,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,IAAI,CAAC;AAExD,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAA+C,CAAC;AAEnF;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,WAAW,aAAa,CAAC,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC;IACN,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC5B;;qBAEiB;IACjB,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC3B;;qDAEiD;IACjD,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC5B,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,EACzB,cAAc,EAAE,MAAM,GACvB,aAAa,CAAC,CAAC,CAAC,CAkClB"}

package/dist/item-bar-geometry.js

@@ -0,0 +1,214 @@
+// Item-bar internal geometry — the "rails" inside an item rectangle:
+// caption text (title + meta), label chips along the bottom, status
+// dot at the upper-right, footnote indicators just left of the dot,
+// and the link icon tile at the bottom-right.
+//
+// These metrics are shared between layout (label-chip placement,
+// future content-aware width estimation) and renderer (text baselines
+// + glyph positions). Keeping them in one module means a single edit
+// re-skins every item bar consistently — the alternative is hunting
+// matching `+ 12`s across two packages.
+//
+// Coordinate convention: every offset is **relative to the item's
+// `box`** (`box.x` for X, `box.y` for Y), with `box.height` /
+// `box.width` used as the "right edge" / "bottom edge" anchor where
+// noted.
+// ---- Caption (title + meta text) ---------------------------------
+/** Horizontal inset (px) for the caption's left edge inside the bar. */
+export const ITEM_CAPTION_INSET_X_PX = 12;
+/**
+ * When the bar's title would overflow to the right, layout sets
+ * `textSpills` and the caption renders to the RIGHT of the bar; this
+ * is the gap (px) between the bar's right edge and the spilled
+ * caption.
+ */
+export const ITEM_CAPTION_SPILL_GAP_PX = 6;
+/** Baseline Y of the title text relative to the bar's top. */
+export const ITEM_CAPTION_TITLE_BASELINE_OFFSET_PX = 20;
+/** Baseline Y of the meta text (second line) relative to the bar's top. */
+export const ITEM_CAPTION_META_BASELINE_OFFSET_PX = 38;
+/** Font size (px) of the title text. */
+export const ITEM_CAPTION_TITLE_FONT_SIZE_PX = 13;
+/** Font size (px) of the meta text. */
+export const ITEM_CAPTION_META_FONT_SIZE_PX = 11;
+// ---- Status dot (upper-right glyph) ------------------------------
+/** Distance (px) from the bar's right edge to the dot's center. */
+export const ITEM_STATUS_DOT_INSET_RIGHT_PX = 12;
+/** Distance (px) from the bar's top edge to the dot's center. */
+export const ITEM_STATUS_DOT_INSET_TOP_PX = 12;
+/** Radius (px) of the status dot. */
+export const ITEM_STATUS_DOT_RADIUS_PX = 5;
+// ---- Footnote indicators (numbers next to status dot) ------------
+/**
+ * X offset (px from bar's right edge) where the rightmost footnote
+ * digit's anchor sits. Tuned to leave room for the status dot.
+ */
+export const ITEM_FOOTNOTE_INDICATOR_INSET_RIGHT_PX = 22;
+/** Baseline Y (px from bar's top) for footnote indicator digits. */
+export const ITEM_FOOTNOTE_INDICATOR_BASELINE_OFFSET_PX = 14;
+/**
+ * Horizontal step (px) between consecutive footnote indicators when
+ * an item carries more than one footnote — they walk LEFT from the
+ * status dot.
+ */
+export const ITEM_FOOTNOTE_INDICATOR_STEP_PX = 8;
+// ---- Link icon tile (bottom-right) -------------------------------
+/** Side length (px) of the square link-icon tile. */
+export const ITEM_LINK_ICON_TILE_SIZE_PX = 14;
+/** Distance (px) from the bar's right/bottom edges to the tile's edge. */
+export const ITEM_LINK_ICON_INSET_PX = 6;
+// ---- Narrow-bar decoration spill --------------------------------
+/**
+ * Horizontal gap (px) between consecutive decorations (status dot,
+ * link icon, footnote, title) when they spill into the column to
+ * the right of a bar that's too narrow to host them inside.
+ */
+export const ITEM_DECORATION_SPILL_GAP_PX = 4;
+/**
+ * Minimum bar width (px) needed to host the status dot inside the
+ * bar with its full inset. Below this, the dot would have to
+ * extend past the bar's left edge, so the dot spills into the
+ * caption column to the right of the bar instead.
+ */
+export const MIN_BAR_WIDTH_FOR_DOT_PX = ITEM_STATUS_DOT_INSET_RIGHT_PX + ITEM_STATUS_DOT_RADIUS_PX;
+/**
+ * Minimum bar width (px) needed to host the link-icon tile AND the
+ * status dot inside the bar with at least
+ * `ITEM_DECORATION_SPILL_GAP_PX` of breathing room between them.
+ * Below this, the link icon would visually collide with (or push
+ * into) the dot's column, so the icon spills out and renders ahead
+ * of the (also-spilled) title.
+ */
+export const MIN_BAR_WIDTH_FOR_LINK_AND_DOT_PX = ITEM_LINK_ICON_INSET_PX +
+    ITEM_LINK_ICON_TILE_SIZE_PX +
+    ITEM_DECORATION_SPILL_GAP_PX +
+    ITEM_STATUS_DOT_INSET_RIGHT_PX +
+    ITEM_STATUS_DOT_RADIUS_PX;
+/**
+ * Minimum bar width (px) needed to host the footnote indicator at
+ * its inset-right position without overshooting the bar's left
+ * edge or colliding with a leading link icon. Approximate width
+ * for one digit is 8px (font-size 10, bold).
+ */
+export const MIN_BAR_WIDTH_FOR_FOOTNOTE_PX = ITEM_FOOTNOTE_INDICATOR_INSET_RIGHT_PX + 1;
+// ---- Inline-date glyph (after:DATE / before:DATE corner badge) ---
+//
+// Renders the renderer's built-in `calendar` SVG at top-LEFT (`after`)
+// or top-RIGHT (`before`) of the entity bar. Sized as a sibling of
+// the status dot and footnote indicators (smaller than the link tile)
+// so the top-decoration row stays visually unified. See
+// specs/rendering.md "Inline-date glyph".
+/** Side length (px) of the inline-date calendar glyph tile. */
+export const INLINE_DATE_GLYPH_TILE_SIZE_PX = 12;
+/** Distance (px) from the bar's left edge to the glyph's left edge
+ *  when the glyph sits at the leftmost top-decoration slot (no link
+ *  icon present). */
+export const INLINE_DATE_GLYPH_INSET_LEFT_PX = 6;
+/** Distance (px) from the bar's right edge to the glyph's right edge
+ *  when the glyph sits at the rightmost top-decoration slot (no
+ *  status dot or footnote present). */
+export const INLINE_DATE_GLYPH_INSET_RIGHT_PX = 6;
+/** Distance (px) from the bar's top edge to the glyph's top edge. */
+export const INLINE_DATE_GLYPH_INSET_TOP_PX = 5;
+/** Horizontal gap (px) between the inline-date glyph and an adjacent
+ *  decoration (link icon on the left, status dot / footnote indicator
+ *  on the right). Matches the existing decoration spill gap so the
+ *  top-decoration row reads as one rhythm. */
+export const INLINE_DATE_GLYPH_GAP_PX = ITEM_DECORATION_SPILL_GAP_PX;
+/**
+ * Minimum bar width (px) needed to host the inline-date glyph inside
+ * the bar. Below this, the glyph spills:
+ *   - `before:` glyph spills RIGHT into the column the status dot
+ *     uses (same family of decorations, same step pitch).
+ *   - `after:` glyph spills LEFT of the bar's leading edge so the
+ *     side semantics (after vs before) stay readable in the spill.
+ *
+ * The threshold reserves room for the glyph itself plus a small
+ * clearance from the link-icon column (when present) so the two
+ * glyphs don't overlap inside narrow bars.
+ */
+export const MIN_BAR_WIDTH_FOR_INLINE_DATE_PX = INLINE_DATE_GLYPH_INSET_LEFT_PX +
+    INLINE_DATE_GLYPH_TILE_SIZE_PX +
+    INLINE_DATE_GLYPH_GAP_PX +
+    INLINE_DATE_GLYPH_TILE_SIZE_PX +
+    INLINE_DATE_GLYPH_INSET_RIGHT_PX;
+// ---- Label chips (along the bar's bottom) ------------------------
+/** Height (px) of a label chip rectangle. */
+export const LABEL_CHIP_HEIGHT_PX = 13;
+/**
+ * Vertical gap (px) between the top of the bottom progress strip and
+ * the BOTTOM of a label chip. Keeps chips from touching the strip and
+ * gives a clear visual rail.
+ */
+export const LABEL_CHIP_GAP_ABOVE_PROGRESS_STRIP_PX = 3;
+/** Horizontal gap (px) between consecutive chips in a row. */
+export const LABEL_CHIP_GAP_BETWEEN_PX = 4;
+/**
+ * Vertical gap (px) between two stacked chip rows when chips spill
+ * outside the bar and form a multi-row column to the right.
+ */
+export const LABEL_CHIP_ROW_GAP_PX = 4;
+/**
+ * Vertical row pitch (px) for a stacked chip column — chip height +
+ * inter-row gap.
+ */
+export const LABEL_CHIP_ROW_STEP_PX = LABEL_CHIP_HEIGHT_PX + LABEL_CHIP_ROW_GAP_PX;
+/**
+ * Slack budget (fraction) applied ONCE per item when chips spill
+ * outside the bar. If a chip would overflow its row by less than
+ * `SPILL_ROW_SLACK_FRACTION × chip.width`, the row is allowed to
+ * stretch by the overflow amount and keep the chip on it instead of
+ * wrapping. This rescues "lonely chip" cases where one chip just
+ * barely overshoots; once the slack is consumed, no further row
+ * expansions happen for that item.
+ */
+export const SPILL_ROW_SLACK_FRACTION = 0.25;
+/**
+ * Pack `chips` into rows for the SPILL column to the right of an
+ * item bar. Each row is capped at `barVisualWidth` (with gaps
+ * between chips). When a chip would overflow:
+ *
+ * - If the row is empty, place the chip anyway (a chip wider than
+ *   the cap occupies its own row).
+ * - Else if the slack rule applies (`overflow ≤ 0.25 × chip.width`)
+ *   AND the slack hasn't already been used for this item, expand
+ *   the current row by `overflow` and keep the chip on it.
+ * - Else wrap the chip to a fresh row.
+ */
+export function packSpillChips(chips, barVisualWidth) {
+    if (chips.length === 0)
+        return { rows: [[]], expanded: false };
+    const rows = [[]];
+    let used = 0;
+    let rowCap = barVisualWidth;
+    let expanded = false;
+    for (const chip of chips) {
+        const row = rows[rows.length - 1];
+        const needed = (row.length === 0 ? 0 : LABEL_CHIP_GAP_BETWEEN_PX) + chip.width;
+        const wouldBe = used + needed;
+        if (wouldBe <= rowCap) {
+            row.push(chip);
+            used = wouldBe;
+            continue;
+        }
+        if (row.length === 0) {
+            row.push(chip);
+            used = chip.width;
+            continue;
+        }
+        const overflow = wouldBe - rowCap;
+        const slack = chip.width * SPILL_ROW_SLACK_FRACTION;
+        if (!expanded && overflow <= slack) {
+            row.push(chip);
+            used = wouldBe;
+            rowCap = wouldBe;
+            expanded = true;
+            continue;
+        }
+        rows.push([chip]);
+        used = chip.width;
+        rowCap = barVisualWidth;
+    }
+    return { rows, expanded };
+}
+//# sourceMappingURL=item-bar-geometry.js.map

package/dist/item-bar-geometry.js.map

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

package/dist/lane-utilization.d.ts

@@ -0,0 +1,90 @@
+import type { DefaultDeclaration, SwimlaneDeclaration } from '@nowline/core';
+import type { PositionedLaneUtilization, PositionedTrackChild, UtilizationClassification } from './types.js';
+/**
+ * Built-in defaults used when neither the lane nor its `default swimlane`
+ * declares a threshold. Mirrors specs/dsl.md rule 17d.
+ */
+export declare const DEFAULT_UTILIZATION_WARN_FRACTION = 0.8;
+export declare const DEFAULT_UTILIZATION_OVER_FRACTION = 1;
+/**
+ * One contributor to a lane's load function: a single positioned item with
+ * its visual horizontal span and the load it contributes during that span.
+ * Children inside `parallel` / `group` blocks contribute individually so
+ * concurrent load reads correctly (the parallel block itself spans the union
+ * of its children's bars but does not itself add load — only the items do).
+ */
+interface LoadContributor {
+    startX: number;
+    endX: number;
+    load: number;
+}
+/**
+ * Walk the lane's positioned children and return one `LoadContributor` per
+ * item that contributes load. Items inside `parallel` and `group` blocks are
+ * descended into recursively; the block envelopes themselves contribute
+ * nothing (they are pure containers).
+ *
+ * `inferItemLoad` mirrors the spec's "Default capacity" table:
+ *   - Explicit `capacity:N` → that value.
+ *   - Sized item without explicit `capacity:` → 1 (the default for sized
+ *     items, matching the duration-derivation default).
+ *   - Duration-literal item without `capacity:` → 0 (the bar paints normally
+ *     but does not contribute load — this is the legacy "uncounted" item
+ *     family from before the size system existed).
+ */
+export declare function collectLoadContributors(children: PositionedTrackChild[]): LoadContributor[];
+/**
+ * Compute a lane's utilization model. Returns `null` when there is no
+ * meaningful underline to paint:
+ *   - Lane has no `capacity:` (no denominator → undefined utilization).
+ *   - Lane has no items contributing load (collectLoadContributors returns
+ *     an empty list).
+ *   - Both thresholds resolve to `none` (caller has opted out of every
+ *     color band; nothing to paint).
+ *
+ * The returned `PositionedLaneUtilization` carries the resolved thresholds
+ * (in fraction form, or `null` for opt-out) alongside the segments so the
+ * renderer can render legends / tooltips without re-resolving anything.
+ */
+export declare function computeLaneUtilization(opts: {
+    children: PositionedTrackChild[];
+    capacityValue: number;
+    warnFraction: number | null;
+    overFraction: number | null;
+}): PositionedLaneUtilization | null;
+/**
+ * Classify a single load value against the lane's resolved capacity and
+ * thresholds. Spec § "Load function and segmentation":
+ *   - `u < warn-at` → green (healthy; includes `u = 0` so the underline
+ *     stays continuous).
+ *   - `warn-at ≤ u < over-at` → yellow.
+ *   - `u ≥ over-at` → red.
+ *
+ * `null` thresholds disable that color band: a `null` warnFraction collapses
+ * to a binary green / red indicator; a `null` overFraction collapses to
+ * green / yellow; both `null` is unreachable here (caller short-circuits
+ * upstream).
+ */
+export declare function classifyLoad(load: number, capacity: number, warnFraction: number | null, overFraction: number | null): UtilizationClassification;
+/**
+ * Resolve the lane's effective utilization thresholds, applying the spec's
+ * resolution order:
+ *
+ *   1. Lane's own `utilization-warn-at:` / `utilization-over-at:` properties.
+ *   2. The applicable `default swimlane` declaration's properties.
+ *   3. Built-in defaults (`warn-at:80%`, `over-at:100%`).
+ *
+ * Each side resolves independently — a lane can pin only one threshold and
+ * inherit the other from defaults / built-ins. The returned `null` means
+ * "opted out via `none`" and disables that color band downstream.
+ *
+ * Malformed values (already reported by the validator) are treated as
+ * "unset" — the resolver falls through to the next layer rather than
+ * double-reporting.
+ */
+export declare function resolveLaneUtilizationThresholds(lane: SwimlaneDeclaration, defaults: Map<string, DefaultDeclaration>): {
+    warn: number | null;
+    over: number | null;
+};
+export {};
+//# sourceMappingURL=lane-utilization.d.ts.map

package/dist/lane-utilization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-utilization.d.ts","sourceRoot":"","sources":["../src/lane-utilization.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,KAAK,EAER,yBAAyB,EACzB,oBAAoB,EAEpB,yBAAyB,EAC5B,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,eAAO,MAAM,iCAAiC,MAAM,CAAC;AACrD,eAAO,MAAM,iCAAiC,IAAM,CAAC;AAErD;;;;;;GAMG;AACH,UAAU,eAAe;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,eAAe,EAAE,CAI3F;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IACzC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GAAG,yBAAyB,GAAG,IAAI,CA+DnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,GAC5B,yBAAyB,CAK3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gCAAgC,CAC5C,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC1C;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAa9C"}