@nowline/layout 0.2.0

package/dist/calendar.js

@@ -0,0 +1,210 @@
+// Calendar and duration resolution. An item's `duration:` is a raw literal
+// (`1d`, `2w`, `3m`, `1q`, `1y`); `size:NAME` references a `size NAME
+// effort:<literal>` declaration whose effort literal is calendar-resolved
+// once into a `ResolvedSize`. The calendar block controls how literal units
+// translate into absolute days.
+import { parseCapacityValue } from './capacity.js';
+import { propValue } from './dsl-utils.js';
+const BUSINESS = {
+    mode: 'business',
+    daysPerWeek: 5,
+    daysPerMonth: 22,
+    daysPerQuarter: 65,
+    daysPerYear: 260,
+};
+const FULL = {
+    mode: 'full',
+    daysPerWeek: 7,
+    daysPerMonth: 30,
+    daysPerQuarter: 91,
+    daysPerYear: 365,
+};
+export function resolveCalendar(file, customBlock) {
+    const calProp = file.roadmapDecl?.properties.find((p) => stripColon(p.key) === 'calendar');
+    const mode = calProp?.value ?? 'business';
+    if (mode === 'business')
+        return { ...BUSINESS };
+    if (mode === 'full')
+        return { ...FULL };
+    if (customBlock) {
+        const get = (key, fallback) => {
+            const p = customBlock.properties.find((x) => stripColon(x.key) === key);
+            const n = p ? parseInt(p.value, 10) : NaN;
+            return Number.isFinite(n) && n > 0 ? n : fallback;
+        };
+        return {
+            mode: 'custom',
+            daysPerWeek: get('days-per-week', BUSINESS.daysPerWeek),
+            daysPerMonth: get('days-per-month', BUSINESS.daysPerMonth),
+            daysPerQuarter: get('days-per-quarter', BUSINESS.daysPerQuarter),
+            daysPerYear: get('days-per-year', BUSINESS.daysPerYear),
+        };
+    }
+    return { ...BUSINESS };
+}
+// Decimal-aware so `size xs effort:0.5d` and `duration:1.5w` round-trip cleanly.
+const DURATION_RE = /^(\d+(?:\.\d+)?)([dwmqy])$/;
+export function literalToDays(literal, cal) {
+    const m = DURATION_RE.exec(literal);
+    if (!m)
+        return 0;
+    const n = parseFloat(m[1]);
+    switch (m[2]) {
+        case 'd':
+            return n;
+        case 'w':
+            return n * cal.daysPerWeek;
+        case 'm':
+            return n * cal.daysPerMonth;
+        case 'q':
+            return n * cal.daysPerQuarter;
+        case 'y':
+            return n * cal.daysPerYear;
+        default:
+            return 0;
+    }
+}
+/**
+ * Convert a `duration:` literal or a `size:NAME` reference into a calendar-
+ * resolved day count. Capacity-agnostic — used both for the duration
+ * literal lookup in `deriveItemDurationDays` and for the
+ * `remaining:` literal normalization in `sequenceItem`. Returns 0 for
+ * missing or unresolvable values; callers substitute their own minimum
+ * width when the result is zero.
+ */
+export function resolveDuration(value, sizes, cal) {
+    if (!value)
+        return 0;
+    if (DURATION_RE.test(value))
+        return literalToDays(value, cal);
+    return sizes.get(value)?.effortDays ?? 0;
+}
+/**
+ * Derive an item's calendar duration in days from its properties.
+ * Precedence (matches specs/dsl.md § "Sizing precedence"):
+ *
+ *   1. Explicit `duration:LITERAL` wins. The literal IS the calendar
+ *      duration the bar paints; `size:NAME` (if also present) collapses
+ *      to a pure annotation rendered as the size chip.
+ *   2. Otherwise, `size:NAME` resolves to its size declaration's
+ *      `effort:` (single-engineer days) and we divide by the item's
+ *      capacity (default 1) to get the team's calendar duration.
+ *   3. With neither, returns 0 — the validator already errors on items
+ *      missing both `size:` and `duration:`, so this only happens in
+ *      transient malformed inputs.
+ */
+export function deriveItemDurationDays(props, sizes, cal) {
+    const durationRaw = propValue(props, 'duration');
+    if (durationRaw && DURATION_RE.test(durationRaw)) {
+        return literalToDays(durationRaw, cal);
+    }
+    const sizeRef = propValue(props, 'size');
+    const size = sizeRef ? sizes.get(sizeRef) : undefined;
+    if (!size)
+        return 0;
+    const capacity = parseCapacityValue(propValue(props, 'capacity')) ?? 1;
+    return size.effortDays / capacity;
+}
+/**
+ * Total work for the item in single-engineer days. Used to normalize a
+ * literal `remaining:` value (also single-engineer days per spec) into a
+ * 0..1 progress fraction.
+ *
+ *   - sized: `size.effortDays` directly (already per-engineer).
+ *   - duration-literal'd: `duration_days × capacity`. The literal sets
+ *     calendar duration; multiplying by the engineer count recovers the
+ *     equivalent single-engineer effort the lane is consuming.
+ *
+ * Returns 0 when neither `size:` nor `duration:` is set so callers can
+ * skip normalization safely.
+ */
+export function deriveTotalEffortDays(props, sizes, cal) {
+    const sizeRef = propValue(props, 'size');
+    const size = sizeRef ? sizes.get(sizeRef) : undefined;
+    if (size)
+        return size.effortDays;
+    const durationRaw = propValue(props, 'duration');
+    if (durationRaw && DURATION_RE.test(durationRaw)) {
+        const capacity = parseCapacityValue(propValue(props, 'capacity')) ?? 1;
+        return literalToDays(durationRaw, cal) * capacity;
+    }
+    return 0;
+}
+/**
+ * Format a calendar day count back into the largest unit literal that
+ * divides cleanly under the active calendar. Used by the meta line for
+ * sized items so the displayed duration reflects the *derived* calendar
+ * duration rather than the raw effort literal — `size:m capacity:5`
+ * with `effort:1w` paints a 1d bar and the meta should read `M 1d`,
+ * not `M 1w`.
+ *
+ *   - Whole-unit folds happen in descending order (`y` → `q` → `m` →
+ *     `w`); the first one that yields an integer wins so `5d` →
+ *     `"1w"` and `22d` (business calendar) → `"1m"`.
+ *   - Anything left over collapses to a `Nd` literal with up to two
+ *     decimal places, trailing zeros trimmed (`"3d"`, `"1.5d"`,
+ *     `"1.67d"`). Matches the `DURATION_LITERAL` shape the parser
+ *     accepts so round-tripping through the renderer reads naturally.
+ *   - `0` (or anything sub-1d) returns `"0d"` rather than an empty
+ *     string so callers always get a renderable token.
+ */
+export function formatDurationDays(days, cal) {
+    const EPSILON = 1e-6;
+    const isWhole = (n) => n >= 1 && Math.abs(n - Math.round(n)) < EPSILON;
+    const folds = [
+        [cal.daysPerYear, 'y'],
+        [cal.daysPerQuarter, 'q'],
+        [cal.daysPerMonth, 'm'],
+        [cal.daysPerWeek, 'w'],
+    ];
+    for (const [unitDays, suffix] of folds) {
+        const n = days / unitDays;
+        if (isWhole(n))
+            return `${Math.round(n)}${suffix}`;
+    }
+    if (Math.abs(days - Math.round(days)) < EPSILON) {
+        return `${Math.round(days)}d`;
+    }
+    // parseFloat strips trailing zeros: `1.50` → `1.5`, `1.67` → `1.67`.
+    return `${parseFloat(days.toFixed(2))}d`;
+}
+/**
+ * Build the layout's `Map<string, ResolvedSize>` once the calendar is
+ * known. Skips sizes whose `effort:` literal is missing or unparseable —
+ * the validator already errors on those, so layout silently drops them
+ * rather than emitting NaN-laden positions.
+ */
+export function resolveSizes(decls, cal) {
+    const out = new Map();
+    for (const [name, decl] of decls) {
+        const effortProp = decl.properties.find((p) => stripColon(p.key) === 'effort');
+        const effortLiteral = effortProp?.value;
+        if (!effortLiteral)
+            continue;
+        const effortDays = literalToDays(effortLiteral, cal);
+        if (effortDays <= 0)
+            continue;
+        out.set(name, {
+            name,
+            title: decl.title || undefined,
+            effortDays,
+            effortLiteral,
+        });
+    }
+    return out;
+}
+function stripColon(key) {
+    return key.endsWith(':') ? key.slice(0, -1) : key;
+}
+// Date arithmetic in day units. All coordinates are relative to the roadmap
+// start date; today is computed in days since start.
+export function daysBetween(from, to) {
+    const ONE_DAY = 86400 * 1000;
+    return Math.round((to.getTime() - from.getTime()) / ONE_DAY);
+}
+export function addDays(base, days) {
+    const out = new Date(base.getTime());
+    out.setUTCDate(out.getUTCDate() + days);
+    return out;
+}
+//# sourceMappingURL=calendar.js.map

package/dist/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../src/calendar.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,sEAAsE;AACtE,0EAA0E;AAC1E,4EAA4E;AAC5E,gCAAgC;AAIhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAa3C,MAAM,QAAQ,GAAmB;IAC7B,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE,EAAE;IAClB,WAAW,EAAE,GAAG;CACnB,CAAC;AAEF,MAAM,IAAI,GAAmB;IACzB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE,EAAE;IAClB,WAAW,EAAE,GAAG;CACnB,CAAC;AAEF,MAAM,UAAU,eAAe,CAC3B,IAAiB,EACjB,WAAsC;IAEtC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,CAAC;IAC3F,MAAM,IAAI,GAAkB,OAAO,EAAE,KAAsB,IAAI,UAAU,CAAC;IAC1E,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;IAChD,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACxC,IAAI,WAAW,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,QAAgB,EAAU,EAAE;YAClD,MAAM,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;YACxE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACtD,CAAC,CAAC;QACF,OAAO;YACH,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,WAAW,CAAC;YACvD,YAAY,EAAE,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,YAAY,CAAC;YAC1D,cAAc,EAAE,GAAG,CAAC,kBAAkB,EAAE,QAAQ,CAAC,cAAc,CAAC;YAChE,WAAW,EAAE,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,WAAW,CAAC;SAC1D,CAAC;IACN,CAAC;IACD,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED,iFAAiF;AACjF,MAAM,WAAW,GAAG,4BAA4B,CAAC;AAEjD,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,GAAmB;IAC9D,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACX,KAAK,GAAG;YACJ,OAAO,CAAC,CAAC;QACb,KAAK,GAAG;YACJ,OAAO,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC;QAC/B,KAAK,GAAG;YACJ,OAAO,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC;QAChC,KAAK,GAAG;YACJ,OAAO,CAAC,GAAG,GAAG,CAAC,cAAc,CAAC;QAClC,KAAK,GAAG;YACJ,OAAO,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC;QAC/B;YACI,OAAO,CAAC,CAAC;IACjB,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC3B,KAAyB,EACzB,KAAgC,EAChC,GAAmB;IAEnB,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CAClC,KAAuB,EACvB,KAAgC,EAChC,GAAmB;IAEnB,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACjD,IAAI,WAAW,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/C,OAAO,aAAa,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACjC,KAAuB,EACvB,KAAgC,EAChC,GAAmB;IAEnB,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,UAAU,CAAC;IACjC,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACjD,IAAI,WAAW,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;QACvE,OAAO,aAAa,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,QAAQ,CAAC;IACtD,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,GAAmB;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC;IACrB,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAC/E,MAAM,KAAK,GAA4B;QACnC,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC;QACtB,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC;QACzB,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC;QACvB,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC;KACzB,CAAC;IACF,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC;QAC1B,IAAI,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC;QAC9C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IAClC,CAAC;IACD,qEAAqE;IACrE,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CACxB,KAAmC,EACnC,GAAmB;IAEnB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC;QAC/E,MAAM,aAAa,GAAG,UAAU,EAAE,KAAK,CAAC;QACxC,IAAI,CAAC,aAAa;YAAE,SAAS;QAC7B,MAAM,UAAU,GAAG,aAAa,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QACrD,IAAI,UAAU,IAAI,CAAC;YAAE,SAAS;QAC9B,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE;YACV,IAAI;YACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;YAC9B,UAAU;YACV,aAAa;SAChB,CAAC,CAAC;IACP,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC3B,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACtD,CAAC;AAED,4EAA4E;AAC5E,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,IAAU,EAAE,EAAQ;IAC5C,MAAM,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAU,EAAE,IAAY;IAC5C,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACrC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/capacity.d.ts

@@ -0,0 +1,72 @@
+import type { SymbolDeclaration } from '@nowline/core';
+import type { ResolvedCapacityIconRef } from './types.js';
+/**
+ * Parse a `capacity:` value. Accepts the three forms the validator allows on
+ * items (positive int, positive decimal, positive percent) — swimlanes only
+ * allow int/decimal but the validator already rejects percent on lanes, so a
+ * single parser is fine here.
+ *
+ * Returns `null` when the value is missing, malformed, or non-positive. The
+ * renderer must not draw a capacity suffix / badge in that case (per spec
+ * "the suffix appears only when the resolved capacity is `> 0`").
+ */
+export declare function parseCapacityValue(raw: string | undefined): number | null;
+/**
+ * Format a parsed capacity number for display per specs/rendering.md §
+ * "Number formatting": integers render as integers (`5`, not `5.0`); decimals
+ * render with trailing zeros trimmed (`0.5`, `1.25`).
+ *
+ * The `toFixed(6)` cap guards against `0.1 + 0.2`-style float noise creeping
+ * into the rendered string. Six is more than the DSL grammar admits anyway —
+ * `1.234567%` lexes but is far below the granularity any roadmap author cares
+ * about, so trimming there is safe.
+ */
+export declare function formatCapacityNumber(value: number): string;
+/**
+ * Resolved capacity-icon ready for the renderer. Re-exported from
+ * `./types.js` so callers can `import { ResolvedCapacityIcon } from
+ * './capacity.js'` without reaching into the positioned-model module.
+ *
+ * Two flavors:
+ *
+ *   - `kind: 'builtin'` — the renderer looks up its SVG (person/people/
+ *     points/time) or text representation (multiplier) via its icon library.
+ *     `'none'` is collapsed to `null` upstream (no glyph rendered).
+ *   - `kind: 'literal'` — the renderer paints `text` as a `<text>` node.
+ *     Covers inline Unicode literals (`capacity-icon:"💰"`) and dereferenced
+ *     custom `symbol` declarations.
+ */
+export type ResolvedCapacityIcon = ResolvedCapacityIconRef;
+/**
+ * Resolve a `capacity-icon:` style value into a `ResolvedCapacityIcon` (or
+ * `null` for `'none'`).
+ *
+ * Resolution order matches specs/dsl.md § Style Properties for `icon:` and
+ * `capacity-icon:`:
+ *
+ *   1. `'none'` → `null` (renderer emits no glyph).
+ *   2. Built-in name → `{ kind: 'builtin', name }`.
+ *   3. Custom symbol id present in `symbols` → `{ kind: 'literal', text:
+ *      <unicode:> }`. The author wrote an identifier; we hand the
+ *      renderer the underlying Unicode payload.
+ *   4. Anything else → `{ kind: 'literal', text: icon }`. This is the inline
+ *      Unicode literal form (`capacity-icon:"💰"`) — Langium's
+ *      ValueConverter has already stripped the surrounding quotes, so the
+ *      raw payload arrives here.
+ *
+ * Validator rule 17 already rejects malformed combinations (unknown built-in
+ * with no matching symbol, symbol id collision with built-ins, etc.), so this
+ * function trusts its input shape.
+ */
+export declare function resolveCapacityIcon(icon: string, symbols: Map<string, SymbolDeclaration>): ResolvedCapacityIcon | null;
+/**
+ * Estimate the on-screen width (px) the capacity suffix will occupy at the
+ * given font size, including the leading separator gap before the glyph.
+ *
+ * The renderer paints the suffix as `<num>{gap}<glyph>` (no leading space
+ * before the number — callers handle that as an outer separator). Width
+ * estimates are intentionally pessimistic so borderline-fitting captions
+ * trigger spill rather than clip.
+ */
+export declare function estimateCapacitySuffixWidth(text: string, icon: ResolvedCapacityIcon | null, fontSizePx: number): number;
+//# sourceMappingURL=capacity.d.ts.map

package/dist/capacity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacity.d.ts","sourceRoot":"","sources":["../src/capacity.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAuB1D;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAezE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAmB3D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACxC,oBAAoB,GAAG,IAAI,CAc7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,oBAAoB,GAAG,IAAI,EACjC,UAAU,EAAE,MAAM,GACnB,MAAM,CAcR"}

package/dist/capacity.js

@@ -0,0 +1,163 @@
+// Capacity parsing, number formatting, and capacity-icon resolution helpers.
+//
+// Layout owns the *contract* the renderer reads:
+//
+//   - `parseCapacityValue` turns the DSL's three numeric forms (`5`, `0.5`,
+//     `50%`) into a single positive number — percent literals are syntactic
+//     sugar for decimals (`50%` → `0.5`) per specs/dsl.md § Capacity.
+//   - `formatCapacityNumber` produces the spec's display string: integers
+//     stay integers (`5`, not `5.0`); decimals trim trailing zeros (`0.5`,
+//     `1.25`).
+//   - `resolveCapacityIcon` collapses the three syntactic forms of the
+//     `capacity-icon:` style property (built-in name, custom `symbol` id,
+//     inline Unicode literal) into either a built-in name the renderer
+//     recognizes OR a literal string the renderer paints as text. Custom
+//     symbol ids are dereferenced via `ResolvedConfig.symbols` here so the
+//     renderer never has to walk the config map.
+//
+// All three helpers are pure — no AST, no theme, no side effects — so they
+// can be tested in isolation and reused by future capacity consumers (e.g.
+// the lane badge in m7 and the overload sweep in m8).
+/**
+ * Built-in `capacity-icon:` names the renderer understands directly. Stays in
+ * sync with `BUILTIN_CAPACITY_ICONS` in `packages/core/.../nowline-validator.ts`
+ * — the validator uses this set to decide whether a value is a known built-in;
+ * the layout uses it to decide whether to forward the value as-is or
+ * dereference it through the glyph map. Layout-side and validator-side can
+ * diverge briefly during refactors but should converge before each release.
+ */
+const BUILTIN_CAPACITY_ICONS = new Set([
+    'none',
+    'multiplier',
+    'person',
+    'people',
+    'points',
+    'time',
+]);
+const POSITIVE_INT_RE = /^\d+$/;
+const POSITIVE_DECIMAL_RE = /^\d+\.\d+$/;
+const POSITIVE_PERCENT_RE = /^\d+(?:\.\d+)?%$/;
+/**
+ * Parse a `capacity:` value. Accepts the three forms the validator allows on
+ * items (positive int, positive decimal, positive percent) — swimlanes only
+ * allow int/decimal but the validator already rejects percent on lanes, so a
+ * single parser is fine here.
+ *
+ * Returns `null` when the value is missing, malformed, or non-positive. The
+ * renderer must not draw a capacity suffix / badge in that case (per spec
+ * "the suffix appears only when the resolved capacity is `> 0`").
+ */
+export function parseCapacityValue(raw) {
+    if (!raw)
+        return null;
+    if (POSITIVE_INT_RE.test(raw)) {
+        const n = parseInt(raw, 10);
+        return n > 0 ? n : null;
+    }
+    if (POSITIVE_DECIMAL_RE.test(raw)) {
+        const n = parseFloat(raw);
+        return Number.isFinite(n) && n > 0 ? n : null;
+    }
+    if (POSITIVE_PERCENT_RE.test(raw)) {
+        const n = parseFloat(raw.slice(0, -1)) / 100;
+        return Number.isFinite(n) && n > 0 ? n : null;
+    }
+    return null;
+}
+/**
+ * Format a parsed capacity number for display per specs/rendering.md §
+ * "Number formatting": integers render as integers (`5`, not `5.0`); decimals
+ * render with trailing zeros trimmed (`0.5`, `1.25`).
+ *
+ * The `toFixed(6)` cap guards against `0.1 + 0.2`-style float noise creeping
+ * into the rendered string. Six is more than the DSL grammar admits anyway —
+ * `1.234567%` lexes but is far below the granularity any roadmap author cares
+ * about, so trimming there is safe.
+ */
+export function formatCapacityNumber(value) {
+    if (Number.isInteger(value))
+        return String(value);
+    let s = value.toFixed(6);
+    s = s.replace(/0+$/, '');
+    s = s.replace(/\.$/, '');
+    return s;
+}
+/**
+ * Read a property value off a Langium-shaped EntityProperty, normalizing the
+ * trailing-colon form. Validator-side uses the same trick — the grammar
+ * stores `key` as the *raw* token, including the colon for `unicode:`-style
+ * property keys.
+ */
+function propKey(prop) {
+    return prop.key.endsWith(':') ? prop.key.slice(0, -1) : prop.key;
+}
+function symbolUnicode(decl) {
+    for (const p of decl.properties) {
+        if (propKey(p) === 'unicode' && p.value)
+            return p.value;
+    }
+    return undefined;
+}
+/**
+ * Resolve a `capacity-icon:` style value into a `ResolvedCapacityIcon` (or
+ * `null` for `'none'`).
+ *
+ * Resolution order matches specs/dsl.md § Style Properties for `icon:` and
+ * `capacity-icon:`:
+ *
+ *   1. `'none'` → `null` (renderer emits no glyph).
+ *   2. Built-in name → `{ kind: 'builtin', name }`.
+ *   3. Custom symbol id present in `symbols` → `{ kind: 'literal', text:
+ *      <unicode:> }`. The author wrote an identifier; we hand the
+ *      renderer the underlying Unicode payload.
+ *   4. Anything else → `{ kind: 'literal', text: icon }`. This is the inline
+ *      Unicode literal form (`capacity-icon:"💰"`) — Langium's
+ *      ValueConverter has already stripped the surrounding quotes, so the
+ *      raw payload arrives here.
+ *
+ * Validator rule 17 already rejects malformed combinations (unknown built-in
+ * with no matching symbol, symbol id collision with built-ins, etc.), so this
+ * function trusts its input shape.
+ */
+export function resolveCapacityIcon(icon, symbols) {
+    if (icon === 'none')
+        return null;
+    if (BUILTIN_CAPACITY_ICONS.has(icon)) {
+        return {
+            kind: 'builtin',
+            name: icon,
+        };
+    }
+    const custom = symbols.get(icon);
+    if (custom) {
+        const unicode = symbolUnicode(custom);
+        return { kind: 'literal', text: unicode ?? icon };
+    }
+    return { kind: 'literal', text: icon };
+}
+/**
+ * Estimate the on-screen width (px) the capacity suffix will occupy at the
+ * given font size, including the leading separator gap before the glyph.
+ *
+ * The renderer paints the suffix as `<num>{gap}<glyph>` (no leading space
+ * before the number — callers handle that as an outer separator). Width
+ * estimates are intentionally pessimistic so borderline-fitting captions
+ * trigger spill rather than clip.
+ */
+export function estimateCapacitySuffixWidth(text, icon, fontSizePx) {
+    if (!icon)
+        return text.length * fontSizePx * 0.58;
+    if (icon.kind === 'builtin' && icon.name === 'multiplier') {
+        // Multiplier is a typographic operator with built-in side bearing —
+        // no separator gap, glyph width approx. one character.
+        return (text.length + 1) * fontSizePx * 0.58;
+    }
+    // 0.1em separator + 1em glyph. Estimating the glyph as 1em (rather than
+    // 0.58em, the per-character width) is intentional: SVG icons render at
+    // their full font-size square, and most Unicode literals authors use for
+    // capacity (★, 💰, ⚙) similarly read at near-em widths.
+    const glyphWidthEm = 1.0;
+    const gapEm = 0.1;
+    return text.length * fontSizePx * 0.58 + (gapEm + glyphWidthEm) * fontSizePx;
+}
+//# sourceMappingURL=capacity.js.map

package/dist/capacity.js.map

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

package/dist/dsl-utils.d.ts

@@ -0,0 +1,5 @@
+import type { EntityProperty } from '@nowline/core';
+export declare function propValue(props: EntityProperty[], key: string): string | undefined;
+export declare function propValues(props: EntityProperty[], key: string): string[];
+export declare function parseDate(raw: string | undefined): Date | null;
+//# sourceMappingURL=dsl-utils.d.ts.map

package/dist/dsl-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl-utils.d.ts","sourceRoot":"","sources":["../src/dsl-utils.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAMpD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAIzE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAM9D"}

package/dist/dsl-utils.js

@@ -0,0 +1,28 @@
+// Tiny DSL utilities shared between `layout.ts` and the per-entity nodes
+// under `nodes/`. Kept intentionally trivial and pure: a `:`-trim,
+// property lookup helpers against the AST's `EntityProperty[]`, and an
+// ISO-date parser. Anything that needs configuration or non-trivial
+// resolution (durations, calendars, styles) stays in the modules that
+// own those concerns.
+function stripColon(key) {
+    return key.endsWith(':') ? key.slice(0, -1) : key;
+}
+export function propValue(props, key) {
+    return props.find((p) => stripColon(p.key) === key)?.value;
+}
+export function propValues(props, key) {
+    const p = props.find((x) => stripColon(x.key) === key);
+    if (!p)
+        return [];
+    return p.value !== undefined ? [p.value] : [...p.values];
+}
+export function parseDate(raw) {
+    if (!raw)
+        return null;
+    const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(raw);
+    if (!m)
+        return null;
+    const d = new Date(Date.UTC(parseInt(m[1], 10), parseInt(m[2], 10) - 1, parseInt(m[3], 10)));
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+//# sourceMappingURL=dsl-utils.js.map

package/dist/dsl-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl-utils.js","sourceRoot":"","sources":["../src/dsl-utils.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,mEAAmE;AACnE,uEAAuE;AACvE,oEAAoE;AACpE,sEAAsE;AACtE,sBAAsB;AAItB,SAAS,UAAU,CAAC,GAAW;IAC3B,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAuB,EAAE,GAAW;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAuB,EAAE,GAAW;IAC3D,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;IACvD,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,OAAO,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAuB;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,CAAC,GAAG,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7F,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/edge-routing.d.ts

@@ -0,0 +1,89 @@
+import type { BoundingBox, Point, PositionedIncludeRegion, PositionedSwimlane } from './types.js';
+/** A visible parallel or group bracket stroke. Used by the
+ *  bracket-clearance nudge: arrows whose chosen elbow X falls within
+ *  `BRACKET_NUDGE_PX` of one of these lines are shifted away. Brackets
+ *  are NOT obstacles — they're aesthetic preferences, not collisions. */
+export interface BracketLine {
+    x: number;
+    yTop: number;
+    yBottom: number;
+}
+/** Per-edge routing request. `from` and `to` are the (visualEdge, midY)
+ *  attach points the rest of the layout already computed; the router
+ *  produces the orthogonal polyline that connects them. */
+export interface EdgeRouteRequest {
+    fromId: string;
+    toId: string;
+    from: Point;
+    to: Point;
+    /** Marker → item edges (anchor / milestone source) skip the channel
+     *  router entirely — the cut line is the visible stem, the path is
+     *  always a short horizontal stub. Set true to bypass routing. */
+    isMarkerSource: boolean;
+}
+export interface EdgeRouteResult {
+    fromId: string;
+    toId: string;
+    waypoints: Point[];
+    /** True when the chosen channel intersected an item bar. The
+     *  renderer paints these edges BEFORE bar fills with a thinner
+     *  stroke so the bar still reads as the foreground. */
+    underBar: boolean;
+}
+/** Distance (px) the elbow X must keep from any visible bracket. Picked
+ *  to leave a small visible gap between the arrow's vertical leg and
+ *  the bracket stroke without forcing the arrow far from its natural
+ *  mid-gutter line. */
+export declare const BRACKET_NUDGE_PX = 4;
+/** Minimum horizontal source stub (px) — distance from the source's
+ *  exit point to the vertical-leg elbow. Below this, the source-side
+ *  arrow body collapses into the bar's right edge with no visible
+ *  horizontal segment. Treated as a hard constraint when picking
+ *  the channel X for left-to-right edges. */
+export declare const MIN_SOURCE_STUB_PX = 6;
+/** Minimum horizontal target stub (px) — distance from the vertical-leg
+ *  elbow to the target's left edge. Below this, the arrowhead has no
+ *  horizontal lead-in: the leg appears to plunge directly into the bar
+ *  without a visible target-side stub. Treated as a hard constraint
+ *  when picking the channel X for left-to-right edges; conflicts with
+ *  obstacle / bracket clearance trigger the under-bar fallback. */
+export declare const MIN_TARGET_STUB_PX = 6;
+export interface ChannelGridInput {
+    /** Every painted item box (visual edges, including chip-spill
+     *  growth). Treated as hard obstacles: a vertical leg crossing one
+     *  triggers under-bar fallback. */
+    itemBars: BoundingBox[];
+    /** Every visible bracket stroke (parallel `bracket:solid|dashed`,
+     *  filled-style group chiclets are NOT brackets). Used by the
+     *  clearance nudge only — not obstacles. */
+    brackets: BracketLine[];
+}
+export declare class ChannelGrid {
+    private readonly items;
+    private readonly brackets;
+    constructor(input: ChannelGridInput);
+    /** True when a vertical line at `x` intersects any item bar within
+     *  the Y span `[yMin, yMax]`. */
+    hasObstacle(x: number, yMin: number, yMax: number): boolean;
+    /** Visible brackets within `radius` px of `x` whose Y span overlaps
+     *  `[yMin, yMax]`. The clearance nudge uses these to shift the
+     *  elbow X away from the bracket. */
+    bracketsNear(x: number, yMin: number, yMax: number, radius: number): BracketLine[];
+}
+/**
+ * Walk a positioned swimlane tree and collect every painted item bar
+ * (visual edges) AND every visible bracket stroke. Output feeds
+ * `ChannelGrid` so the router knows what to avoid.
+ *
+ * Swimlanes contained in include regions count too — items inside an
+ * isolated region share the parent timeline so cross-region arrows
+ * still need the obstacle/bracket data to route cleanly.
+ */
+export declare function collectRoutingObstacles(swimlanes: PositionedSwimlane[], includes: PositionedIncludeRegion[]): ChannelGridInput;
+/**
+ * Route every dependency edge in one batch so slot assignment can
+ * coordinate across edges that share a channel. Marker → item edges
+ * route as direct stubs and bypass the channel router.
+ */
+export declare function routeChannelEdges(requests: EdgeRouteRequest[], grid: ChannelGrid): EdgeRouteResult[];
+//# sourceMappingURL=edge-routing.d.ts.map

package/dist/edge-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-routing.d.ts","sourceRoot":"","sources":["../src/edge-routing.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACR,WAAW,EACX,KAAK,EACL,uBAAuB,EACvB,kBAAkB,EAErB,MAAM,YAAY,CAAC;AAEpB;;;yEAGyE;AACzE,MAAM,WAAW,WAAW;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;2DAE2D;AAC3D,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,KAAK,CAAC;IACV;;sEAEkE;IAClE,cAAc,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,EAAE,CAAC;IACnB;;2DAEuD;IACvD,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED;;;uBAGuB;AACvB,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;6CAI6C;AAC7C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;mEAKmE;AACnE,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAmBpC,MAAM,WAAW,gBAAgB;IAC7B;;uCAEmC;IACnC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB;;gDAE4C;IAC5C,QAAQ,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,KAAK,EAAE,gBAAgB;IAKnC;qCACiC;IACjC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAW3D;;yCAEqC;IACrC,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE;CAWrF;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACnC,SAAS,EAAE,kBAAkB,EAAE,EAC/B,QAAQ,EAAE,uBAAuB,EAAE,GACpC,gBAAgB,CAqElB;AAyPD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,IAAI,EAAE,WAAW,GAClB,eAAe,EAAE,CAkDnB"}