@nowline/layout 0.2.0

package/dist/header-card-geometry.d.ts

@@ -0,0 +1,29 @@
+/** Horizontal padding (px) inside the card from edge to text. */
+export declare const HEADER_CARD_PADDING_X = 16;
+/**
+ * Top padding (px) — measured to the BASELINE of the first title
+ * line. Larger than a typical "padding top" because it includes the
+ * cap-to-baseline distance for the 16 pt title font.
+ */
+export declare const HEADER_CARD_PADDING_TOP = 26;
+/**
+ * Bottom padding (px) below the descender of the last text line.
+ * Symmetric-feeling visual padding (smaller than `PADDING_TOP` since
+ * top includes the cap-to-baseline distance).
+ */
+export declare const HEADER_CARD_PADDING_BOTTOM = 14;
+/** Baseline-to-baseline spacing between consecutive title lines. */
+export declare const HEADER_TITLE_LINE_HEIGHT_PX = 20;
+/** Baseline-to-baseline spacing between consecutive author lines. */
+export declare const HEADER_AUTHOR_LINE_HEIGHT_PX = 14;
+/**
+ * Vertical gap (px) between the LAST title baseline and the FIRST
+ * author baseline. Larger than a normal line height because it spans
+ * the title's descender + the author's cap height.
+ */
+export declare const HEADER_TITLE_TO_AUTHOR_GAP_PX = 18;
+/** Font size (px) of the title text. */
+export declare const HEADER_TITLE_FONT_SIZE_PX = 16;
+/** Font size (px) of the author text (subtitle). */
+export declare const HEADER_AUTHOR_FONT_SIZE_PX = 11;
+//# sourceMappingURL=header-card-geometry.d.ts.map

package/dist/header-card-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-card-geometry.d.ts","sourceRoot":"","sources":["../src/header-card-geometry.ts"],"names":[],"mappings":"AAaA,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,oEAAoE;AACpE,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,oDAAoD;AACpD,eAAO,MAAM,0BAA0B,KAAK,CAAC"}

package/dist/header-card-geometry.js

@@ -0,0 +1,41 @@
+// Header card geometry — sizing and text-stack metrics for the
+// "header card" that sits beside the timeline (title + author block).
+//
+// Layout owns the card *size* (computed up-front in `sizeBesideHeader`
+// from wrapped title/author text). The renderer paints the rectangle +
+// text using the *same* paddings, line heights, and font sizes so the
+// card is laid out and drawn consistently.
+//
+// Bumping any of these constants changes the visible size of the
+// header card and the position of every text line inside it. Always
+// keep the layout's `sizeBesideHeader` and the renderer's
+// `renderHeader` aligned by going through this module.
+/** Horizontal padding (px) inside the card from edge to text. */
+export const HEADER_CARD_PADDING_X = 16;
+/**
+ * Top padding (px) — measured to the BASELINE of the first title
+ * line. Larger than a typical "padding top" because it includes the
+ * cap-to-baseline distance for the 16 pt title font.
+ */
+export const HEADER_CARD_PADDING_TOP = 26;
+/**
+ * Bottom padding (px) below the descender of the last text line.
+ * Symmetric-feeling visual padding (smaller than `PADDING_TOP` since
+ * top includes the cap-to-baseline distance).
+ */
+export const HEADER_CARD_PADDING_BOTTOM = 14;
+/** Baseline-to-baseline spacing between consecutive title lines. */
+export const HEADER_TITLE_LINE_HEIGHT_PX = 20;
+/** Baseline-to-baseline spacing between consecutive author lines. */
+export const HEADER_AUTHOR_LINE_HEIGHT_PX = 14;
+/**
+ * Vertical gap (px) between the LAST title baseline and the FIRST
+ * author baseline. Larger than a normal line height because it spans
+ * the title's descender + the author's cap height.
+ */
+export const HEADER_TITLE_TO_AUTHOR_GAP_PX = 18;
+/** Font size (px) of the title text. */
+export const HEADER_TITLE_FONT_SIZE_PX = 16;
+/** Font size (px) of the author text (subtitle). */
+export const HEADER_AUTHOR_FONT_SIZE_PX = 11;
+//# sourceMappingURL=header-card-geometry.js.map

package/dist/header-card-geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-card-geometry.js","sourceRoot":"","sources":["../src/header-card-geometry.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,sEAAsE;AACtE,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,sEAAsE;AACtE,2CAA2C;AAC3C,EAAE;AACF,iEAAiE;AACjE,oEAAoE;AACpE,0DAA0D;AAC1D,uDAAuD;AAEvD,iEAAiE;AACjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C,oEAAoE;AACpE,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAE9C,qEAAqE;AACrE,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD,wCAAwC;AACxC,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C,oDAAoD;AACpD,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC"}

package/dist/i18n.d.ts

@@ -0,0 +1,48 @@
+export declare const DEFAULT_LOCALE = "en-US";
+export interface LocaleStrings {
+    /** Short label painted inside the now-line pill. Sized for ~3-6 chars. */
+    nowLabel: string;
+    /** Prefix used when the timeline scale is quarters (e.g. `Q1 2026` / `T1 2026`). */
+    quarterPrefix: string;
+}
+/**
+ * Resolve the effective locale for the rendered artifact.
+ *
+ * Precedence (highest wins):
+ *   1. `directiveLocale` — `nowline v1 locale:fr-CA` from the file itself.
+ *      The file is the artifact; its declared locale is authoritative the
+ *      same way `<html lang="fr">` is on a web page or `:lang:` is in
+ *      AsciiDoc. This guarantees cross-machine determinism: a French
+ *      roadmap renders French even when invoked from a US-locale shell.
+ *   2. `override` — the CLI `--locale` flag plus env-var fallback,
+ *      already resolved by the CLI before calling layout. Used only when
+ *      the file declines to declare its own locale.
+ *   3. `DEFAULT_LOCALE` (`en-US`).
+ *
+ * Returns the input string verbatim — callers downstream walk the BCP-47
+ * fallback chain to find string entries.
+ *
+ * Note: the operator's locale (CLI flag / env vars) controls a separate,
+ * independent chain for terminal output (validator diagnostics, --help,
+ * verbose logs). See `specs/localization.md` for the two-chain model.
+ */
+export declare function resolveLocale(override: string | undefined, directiveLocale: string | undefined): string;
+/**
+ * Look up a locale's chrome strings, walking the BCP-47 tree until a
+ * value is found. The walk strips the trailing `-SUBTAG` and retries:
+ *   `fr-CA → fr → en-US`
+ *   `fr-BE → fr → en-US` (no fr-BE bundle yet — works for free)
+ *   `de-AT → de → en-US` (no de bundles yet — falls all the way through)
+ *
+ * Always returns a fully-populated `LocaleStrings` because the `en-US`
+ * root has every key.
+ */
+export declare function localeStrings(locale: string): LocaleStrings;
+/**
+ * BCP-47 fallback chain for a locale tag. Strips trailing `-SUBTAG`s
+ * one at a time until a primary subtag remains, then appends the root
+ * locale. Case-normalized to lowercase primary + uppercase region so
+ * lookups are stable regardless of input casing.
+ */
+export declare function fallbackChain(locale: string): string[];
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC1B,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,aAAa,EAAE,MAAM,CAAC;CACzB;AAyBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,eAAe,EAAE,MAAM,GAAG,SAAS,GACpC,MAAM,CAER;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAa3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAWtD"}

package/dist/i18n.js

@@ -0,0 +1,114 @@
+// Locale-aware strings used by the layout pipeline. Owns three things:
+//   - The BCP-47 fallback chain (`fr-CA → fr → en-US`).
+//   - A small message table for chrome strings the renderer paints
+//     directly (now-pill, quarter prefix).
+//   - The locale token passed to `Intl.DateTimeFormat` for axis labels.
+//
+// Today the table is inline; m-loc-d / m-loc-e (per `specs/localization.md`)
+// will move this to a proper `messages.<locale>.ts` bundle layout. The
+// shape here is deliberately minimal so that swap is mechanical.
+export const DEFAULT_LOCALE = 'en-US';
+// Bundle entries keyed by language tag. The fallback chain strips the
+// trailing `-SUBTAG` and retries; a missing key in a child bundle falls
+// through to the parent. `en-US` is the root.
+//
+// Region overlays (fr-CA, fr-FR) are intentionally omitted: at launch they
+// have nothing region-specific to override. Empty overlays are a feature,
+// not a bug — they exist as a contract for future divergence. See
+// `specs/localization.md` § "Locale resolution".
+const BUNDLES = {
+    'en-US': {
+        nowLabel: 'now',
+        quarterPrefix: 'Q',
+    },
+    fr: {
+        // Short form of "maintenant"; keeps the pill compact while staying
+        // correct French. The full word is too wide for the ~3-6 char pill
+        // budget without geometry work (tracked in m-loc-c).
+        nowLabel: 'maint.',
+        // `T` for trimestre — the standard French business convention.
+        quarterPrefix: 'T',
+    },
+};
+/**
+ * Resolve the effective locale for the rendered artifact.
+ *
+ * Precedence (highest wins):
+ *   1. `directiveLocale` — `nowline v1 locale:fr-CA` from the file itself.
+ *      The file is the artifact; its declared locale is authoritative the
+ *      same way `<html lang="fr">` is on a web page or `:lang:` is in
+ *      AsciiDoc. This guarantees cross-machine determinism: a French
+ *      roadmap renders French even when invoked from a US-locale shell.
+ *   2. `override` — the CLI `--locale` flag plus env-var fallback,
+ *      already resolved by the CLI before calling layout. Used only when
+ *      the file declines to declare its own locale.
+ *   3. `DEFAULT_LOCALE` (`en-US`).
+ *
+ * Returns the input string verbatim — callers downstream walk the BCP-47
+ * fallback chain to find string entries.
+ *
+ * Note: the operator's locale (CLI flag / env vars) controls a separate,
+ * independent chain for terminal output (validator diagnostics, --help,
+ * verbose logs). See `specs/localization.md` for the two-chain model.
+ */
+export function resolveLocale(override, directiveLocale) {
+    return directiveLocale ?? override ?? DEFAULT_LOCALE;
+}
+/**
+ * Look up a locale's chrome strings, walking the BCP-47 tree until a
+ * value is found. The walk strips the trailing `-SUBTAG` and retries:
+ *   `fr-CA → fr → en-US`
+ *   `fr-BE → fr → en-US` (no fr-BE bundle yet — works for free)
+ *   `de-AT → de → en-US` (no de bundles yet — falls all the way through)
+ *
+ * Always returns a fully-populated `LocaleStrings` because the `en-US`
+ * root has every key.
+ */
+export function localeStrings(locale) {
+    const result = {};
+    for (const tag of fallbackChain(locale)) {
+        const bundle = BUNDLES[tag];
+        if (!bundle)
+            continue;
+        for (const key of Object.keys(bundle)) {
+            if (result[key] === undefined && bundle[key] !== undefined) {
+                result[key] = bundle[key];
+            }
+        }
+    }
+    // The root bundle (`en-US`) is always populated, so this cast is safe.
+    return result;
+}
+/**
+ * BCP-47 fallback chain for a locale tag. Strips trailing `-SUBTAG`s
+ * one at a time until a primary subtag remains, then appends the root
+ * locale. Case-normalized to lowercase primary + uppercase region so
+ * lookups are stable regardless of input casing.
+ */
+export function fallbackChain(locale) {
+    const chain = [];
+    let current = normalizeTag(locale);
+    while (current.length > 0) {
+        if (!chain.includes(current))
+            chain.push(current);
+        const dash = current.lastIndexOf('-');
+        if (dash <= 0)
+            break;
+        current = current.slice(0, dash);
+    }
+    if (!chain.includes(DEFAULT_LOCALE))
+        chain.push(DEFAULT_LOCALE);
+    return chain;
+}
+function normalizeTag(locale) {
+    const parts = locale.split('-');
+    return parts
+        .map((part, index) => {
+        if (index === 0)
+            return part.toLowerCase();
+        // Region subtag: 2 letters → upper-case; 3 digits → keep as-is.
+        return /^[a-zA-Z]{2}$/.test(part) ? part.toUpperCase() : part;
+    })
+        .join('-');
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wDAAwD;AACxD,mEAAmE;AACnE,2CAA2C;AAC3C,wEAAwE;AACxE,EAAE;AACF,6EAA6E;AAC7E,uEAAuE;AACvE,iEAAiE;AAEjE,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAStC,sEAAsE;AACtE,wEAAwE;AACxE,8CAA8C;AAC9C,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,kEAAkE;AAClE,iDAAiD;AACjD,MAAM,OAAO,GAA2C;IACpD,OAAO,EAAE;QACL,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,GAAG;KACrB;IACD,EAAE,EAAE;QACA,mEAAmE;QACnE,mEAAmE;QACnE,qDAAqD;QACrD,QAAQ,EAAE,QAAQ;QAClB,+DAA+D;QAC/D,aAAa,EAAE,GAAG;KACrB;CACJ,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa,CACzB,QAA4B,EAC5B,eAAmC;IAEnC,OAAO,eAAe,IAAI,QAAQ,IAAI,cAAc,CAAC;AACzD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IACxC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAA4B,EAAE,CAAC;YAC/D,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBACzD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC;IACL,CAAC;IACD,uEAAuE;IACvE,OAAO,MAAuB,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,IAAI,IAAI,CAAC;YAAE,MAAM;QACrB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChE,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,KAAK;SACP,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACjB,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3C,gEAAgE;QAChE,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC"}

package/dist/include-chrome-geometry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Horizontal offset (px) from the include region's bounding-box left
+ * edge to the label tab's left edge. Equals the region's outer pad
+ * (8 px from `renderIncludeRegion`) plus a 16 px tab inset that keeps
+ * the chiclet visually anchored inside the dashed bracket rather than
+ * straddling its rounded corner.
+ */
+export declare const INCLUDE_CHROME_OFFSET_FROM_BOX_PX = 24;
+/** Horizontal inset (px) from the tab's left edge to the label text. */
+export declare const INCLUDE_CHROME_TAB_LEFT_INSET_PX = 10;
+/**
+ * Horizontal inset (px) from the label text's right edge to the tab's
+ * right edge. Same as the left inset so the label appears optically
+ * centered inside its chiclet.
+ */
+export declare const INCLUDE_CHROME_TAB_RIGHT_INSET_PX = 10;
+/**
+ * Px-per-char for the label rendered at 11 pt 600w in `FONT_STACK.sans`.
+ * Calibrated against system-ui at 11 pt bold (~5.8 px/char actual);
+ * 6.0 leaves a small safety margin without producing wide right
+ * whitespace inside the chiclet.
+ */
+export declare const INCLUDE_CHROME_TAB_LABEL_PER_CHAR_PX = 6;
+/**
+ * Minimum total chiclet width (px). A floor so tiny labels still
+ * produce a chip wide enough to read; the badge/source bookmark sit
+ * outside the chiclet so they never push it past this minimum.
+ */
+export declare const INCLUDE_CHROME_TAB_MIN_WIDTH_PX = 60;
+/** Gap (px) between the chiclet's right edge and the content badge. */
+export declare const INCLUDE_CHROME_BADGE_GAP_PX = 6;
+/** Square content-badge tile size (px). */
+export declare const INCLUDE_CHROME_BADGE_SIZE_PX = 18;
+/** Gap (px) between the badge's right edge and the source-path text. */
+export declare const INCLUDE_CHROME_SOURCE_GAP_PX = 6;
+/**
+ * Px-per-char for the source-path rendered at 9 pt in `FONT_STACK.mono`.
+ * Calibrated against ui-monospace at 9 pt regular (~5.4 px/char actual);
+ * 5.5 leaves a small safety margin so the halo never clips the path.
+ */
+export declare const INCLUDE_CHROME_SOURCE_PER_CHAR_PX = 5.5;
+/**
+ * Halo padding (px) on each side of the source-path text. The halo
+ * masks the dashed bracket border that runs through the text's
+ * baseline so the path stays legible.
+ */
+export declare const INCLUDE_CHROME_SOURCE_HALO_PAD_PX = 3;
+export interface IncludeChromeGeometry {
+    /** Estimated rendered width (px) of the label text, no min-clamp. */
+    labelTextWidth: number;
+    /** Estimated rendered width (px) of the source-path text; 0 when no source. */
+    sourceTextWidth: number;
+    /** Left X (canvas px) of the chiclet rectangle. */
+    tabX: number;
+    /** Total chiclet width (px), with min-width floor applied. */
+    tabWidth: number;
+    /** Canvas X (px) where the label text is painted (left-anchored). */
+    tabLabelX: number;
+    /** Left X (canvas px) of the content-badge tile; 0 when no badge. */
+    badgeX: number;
+    /** Square content-badge tile size (px); mirrors `INCLUDE_CHROME_BADGE_SIZE_PX`. */
+    badgeSize: number;
+    /** Left X (canvas px) of the source-path halo rect; 0 when no source. */
+    sourceHaloX: number;
+    /** Width (px) of the source-path halo rect; 0 when no source. */
+    sourceHaloWidth: number;
+    /** Canvas X (px) where the source-path text is painted (left-anchored); 0 when no source. */
+    sourceTextX: number;
+    /**
+     * Right edge (canvas px) of the entire chrome strip — used by the
+     * layout to size the include region's bounding box so the dashed
+     * bracket always encloses its own chrome. Equals the badge's right
+     * edge when no source is present, or the halo's right edge when
+     * one is.
+     */
+    chromeRightX: number;
+}
+/**
+ * Single source of truth for the include-region chrome's geometry.
+ *
+ * `boxX` is the left edge of the include region's bounding box in
+ * canvas px. `label` is the chiclet text; `sourcePath` is the
+ * breadcrumb beside the badge (pass `''` to omit the bookmark).
+ */
+export declare function includeChromeGeometry(boxX: number, label: string, sourcePath: string): IncludeChromeGeometry;
+//# sourceMappingURL=include-chrome-geometry.d.ts.map

package/dist/include-chrome-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"include-chrome-geometry.d.ts","sourceRoot":"","sources":["../src/include-chrome-geometry.ts"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD,wEAAwE;AACxE,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD,uEAAuE;AACvE,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,2CAA2C;AAC3C,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,MAAM,CAAC;AACrD;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,IAAI,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IAClC,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,eAAe,EAAE,MAAM,CAAC;IAExB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAElB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;IAElB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACnB,qBAAqB,CAuCvB"}

package/dist/include-chrome-geometry.js

@@ -0,0 +1,104 @@
+// Include-region chrome geometry — the label tab + content badge +
+// source-path bookmark that float across the top edge of an isolated
+// `include {}` region's dashed bracket. Both the layout (which needs
+// to know the chrome's right edge to shrink-wrap the bracket) and the
+// renderer (which paints each element) call `includeChromeGeometry`,
+// so the painted footprint and the layout's reserved footprint stay
+// in sync. Mirrors `frameTabGeometry`'s "compute placement X for each
+// element + derive total width from the cursor" model.
+//
+// Layout order, left → right:
+//
+//   [LEFT_INSET] tab(LABEL) (BADGE_GAP) badge (SOURCE_GAP) [HALO_PAD] source [HALO_PAD]
+//
+// The badge and source-path are optional in spirit but always present
+// for current `include` regions; the helper passes `0` widths through
+// cleanly should that ever change.
+/**
+ * Horizontal offset (px) from the include region's bounding-box left
+ * edge to the label tab's left edge. Equals the region's outer pad
+ * (8 px from `renderIncludeRegion`) plus a 16 px tab inset that keeps
+ * the chiclet visually anchored inside the dashed bracket rather than
+ * straddling its rounded corner.
+ */
+export const INCLUDE_CHROME_OFFSET_FROM_BOX_PX = 24;
+/** Horizontal inset (px) from the tab's left edge to the label text. */
+export const INCLUDE_CHROME_TAB_LEFT_INSET_PX = 10;
+/**
+ * Horizontal inset (px) from the label text's right edge to the tab's
+ * right edge. Same as the left inset so the label appears optically
+ * centered inside its chiclet.
+ */
+export const INCLUDE_CHROME_TAB_RIGHT_INSET_PX = 10;
+/**
+ * Px-per-char for the label rendered at 11 pt 600w in `FONT_STACK.sans`.
+ * Calibrated against system-ui at 11 pt bold (~5.8 px/char actual);
+ * 6.0 leaves a small safety margin without producing wide right
+ * whitespace inside the chiclet.
+ */
+export const INCLUDE_CHROME_TAB_LABEL_PER_CHAR_PX = 6;
+/**
+ * Minimum total chiclet width (px). A floor so tiny labels still
+ * produce a chip wide enough to read; the badge/source bookmark sit
+ * outside the chiclet so they never push it past this minimum.
+ */
+export const INCLUDE_CHROME_TAB_MIN_WIDTH_PX = 60;
+/** Gap (px) between the chiclet's right edge and the content badge. */
+export const INCLUDE_CHROME_BADGE_GAP_PX = 6;
+/** Square content-badge tile size (px). */
+export const INCLUDE_CHROME_BADGE_SIZE_PX = 18;
+/** Gap (px) between the badge's right edge and the source-path text. */
+export const INCLUDE_CHROME_SOURCE_GAP_PX = 6;
+/**
+ * Px-per-char for the source-path rendered at 9 pt in `FONT_STACK.mono`.
+ * Calibrated against ui-monospace at 9 pt regular (~5.4 px/char actual);
+ * 5.5 leaves a small safety margin so the halo never clips the path.
+ */
+export const INCLUDE_CHROME_SOURCE_PER_CHAR_PX = 5.5;
+/**
+ * Halo padding (px) on each side of the source-path text. The halo
+ * masks the dashed bracket border that runs through the text's
+ * baseline so the path stays legible.
+ */
+export const INCLUDE_CHROME_SOURCE_HALO_PAD_PX = 3;
+/**
+ * Single source of truth for the include-region chrome's geometry.
+ *
+ * `boxX` is the left edge of the include region's bounding box in
+ * canvas px. `label` is the chiclet text; `sourcePath` is the
+ * breadcrumb beside the badge (pass `''` to omit the bookmark).
+ */
+export function includeChromeGeometry(boxX, label, sourcePath) {
+    const tabX = boxX + INCLUDE_CHROME_OFFSET_FROM_BOX_PX;
+    const tabLabelX = tabX + INCLUDE_CHROME_TAB_LEFT_INSET_PX;
+    const labelTextWidth = label.length * INCLUDE_CHROME_TAB_LABEL_PER_CHAR_PX;
+    const tabWidth = Math.max(INCLUDE_CHROME_TAB_MIN_WIDTH_PX, labelTextWidth + INCLUDE_CHROME_TAB_LEFT_INSET_PX + INCLUDE_CHROME_TAB_RIGHT_INSET_PX);
+    const badgeX = tabX + tabWidth + INCLUDE_CHROME_BADGE_GAP_PX;
+    const badgeRightX = badgeX + INCLUDE_CHROME_BADGE_SIZE_PX;
+    let sourceTextWidth = 0;
+    let sourceTextX = 0;
+    let sourceHaloX = 0;
+    let sourceHaloWidth = 0;
+    let chromeRightX = badgeRightX;
+    if (sourcePath) {
+        sourceTextX = badgeRightX + INCLUDE_CHROME_SOURCE_GAP_PX;
+        sourceTextWidth = sourcePath.length * INCLUDE_CHROME_SOURCE_PER_CHAR_PX;
+        sourceHaloX = sourceTextX - INCLUDE_CHROME_SOURCE_HALO_PAD_PX;
+        sourceHaloWidth = sourceTextWidth + INCLUDE_CHROME_SOURCE_HALO_PAD_PX * 2;
+        chromeRightX = sourceHaloX + sourceHaloWidth;
+    }
+    return {
+        labelTextWidth,
+        sourceTextWidth,
+        tabX,
+        tabWidth,
+        tabLabelX,
+        badgeX,
+        badgeSize: INCLUDE_CHROME_BADGE_SIZE_PX,
+        sourceHaloX,
+        sourceHaloWidth,
+        sourceTextX,
+        chromeRightX,
+    };
+}
+//# sourceMappingURL=include-chrome-geometry.js.map

package/dist/include-chrome-geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"include-chrome-geometry.js","sourceRoot":"","sources":["../src/include-chrome-geometry.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,qEAAqE;AACrE,qEAAqE;AACrE,sEAAsE;AACtE,qEAAqE;AACrE,oEAAoE;AACpE,sEAAsE;AACtE,uDAAuD;AACvD,EAAE;AACF,8BAA8B;AAC9B,EAAE;AACF,wFAAwF;AACxF,EAAE;AACF,sEAAsE;AACtE,sEAAsE;AACtE,mCAAmC;AAEnC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAEpD,wEAAwE;AACxE,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,CAAC;AACnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAElD,uEAAuE;AACvE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,2CAA2C;AAC3C,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C,wEAAwE;AACxE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAC9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,GAAG,CAAC;AACrD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC;AAqCnD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACjC,IAAY,EACZ,KAAa,EACb,UAAkB;IAElB,MAAM,IAAI,GAAG,IAAI,GAAG,iCAAiC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,GAAG,gCAAgC,CAAC;IAE1D,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,oCAAoC,CAAC;IAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACrB,+BAA+B,EAC/B,cAAc,GAAG,gCAAgC,GAAG,iCAAiC,CACxF,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,2BAA2B,CAAC;IAC7D,MAAM,WAAW,GAAG,MAAM,GAAG,4BAA4B,CAAC;IAE1D,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,YAAY,GAAG,WAAW,CAAC;IAC/B,IAAI,UAAU,EAAE,CAAC;QACb,WAAW,GAAG,WAAW,GAAG,4BAA4B,CAAC;QACzD,eAAe,GAAG,UAAU,CAAC,MAAM,GAAG,iCAAiC,CAAC;QACxE,WAAW,GAAG,WAAW,GAAG,iCAAiC,CAAC;QAC9D,eAAe,GAAG,eAAe,GAAG,iCAAiC,GAAG,CAAC,CAAC;QAC1E,YAAY,GAAG,WAAW,GAAG,eAAe,CAAC;IACjD,CAAC;IAED,OAAO;QACH,cAAc;QACd,eAAe;QACf,IAAI;QACJ,QAAQ;QACR,SAAS;QACT,MAAM;QACN,SAAS,EAAE,4BAA4B;QACvC,WAAW;QACX,eAAe;QACf,WAAW;QACX,YAAY;KACf,CAAC;AACN,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { estimateCapacitySuffixWidth, formatCapacityNumber, parseCapacityValue, type ResolvedCapacityIcon, resolveCapacityIcon, } from './capacity.js';
+export { FRAME_TAB_INNER_GAP_PX, FRAME_TAB_LEFT_INSET_PX, FRAME_TAB_MIN_WIDTH_PX, FRAME_TAB_OFFSET_FROM_BOX_PX, FRAME_TAB_OWNER_PX_PER_CHAR, FRAME_TAB_RIGHT_INSET_PX, FRAME_TAB_TITLE_PX_PER_CHAR, type FrameTabGeometry, frameTabGeometry, } from './frame-tab-geometry.js';
+export { HEADER_AUTHOR_FONT_SIZE_PX, HEADER_AUTHOR_LINE_HEIGHT_PX, HEADER_CARD_PADDING_BOTTOM, HEADER_CARD_PADDING_TOP, HEADER_CARD_PADDING_X, HEADER_TITLE_FONT_SIZE_PX, HEADER_TITLE_LINE_HEIGHT_PX, HEADER_TITLE_TO_AUTHOR_GAP_PX, } from './header-card-geometry.js';
+export { INCLUDE_CHROME_BADGE_GAP_PX, INCLUDE_CHROME_BADGE_SIZE_PX, INCLUDE_CHROME_OFFSET_FROM_BOX_PX, INCLUDE_CHROME_SOURCE_GAP_PX, INCLUDE_CHROME_SOURCE_HALO_PAD_PX, INCLUDE_CHROME_SOURCE_PER_CHAR_PX, INCLUDE_CHROME_TAB_LABEL_PER_CHAR_PX, INCLUDE_CHROME_TAB_LEFT_INSET_PX, INCLUDE_CHROME_TAB_MIN_WIDTH_PX, INCLUDE_CHROME_TAB_RIGHT_INSET_PX, type IncludeChromeGeometry, includeChromeGeometry, } from './include-chrome-geometry.js';
+export { ITEM_CAPTION_INSET_X_PX, ITEM_CAPTION_META_BASELINE_OFFSET_PX, ITEM_CAPTION_META_FONT_SIZE_PX, ITEM_CAPTION_SPILL_GAP_PX, ITEM_CAPTION_TITLE_BASELINE_OFFSET_PX, ITEM_CAPTION_TITLE_FONT_SIZE_PX, ITEM_DECORATION_SPILL_GAP_PX, ITEM_FOOTNOTE_INDICATOR_BASELINE_OFFSET_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_INSET_TOP_PX, ITEM_STATUS_DOT_RADIUS_PX, LABEL_CHIP_GAP_ABOVE_PROGRESS_STRIP_PX, LABEL_CHIP_GAP_BETWEEN_PX, LABEL_CHIP_HEIGHT_PX, MIN_BAR_WIDTH_FOR_DOT_PX, MIN_BAR_WIDTH_FOR_FOOTNOTE_PX, MIN_BAR_WIDTH_FOR_LINK_AND_DOT_PX, } from './item-bar-geometry.js';
+export type { LayoutOptions, LayoutResult } from './layout.js';
+export { layoutRoadmap } from './layout.js';
+export { darkTheme, lightTheme, type Theme, type ThemeName, themes, } from './themes/index.js';
+export { ACCENT_DASH_PATTERN, ATTRIBUTION_BAR_LOGICAL_WIDTH, ATTRIBUTION_BAR_LOGICAL_X, ATTRIBUTION_INE_LOGICAL_X, ATTRIBUTION_LINK, ATTRIBUTION_NOW_LOGICAL_X, ATTRIBUTION_PREFIX_FONT_SIZE, ATTRIBUTION_SCALE, ATTRIBUTION_TEXT, ATTRIBUTION_WORDMARK_FONT_SIZE, CORNER_RADIUS_PX, EDGE_CORNER_RADIUS, FONT_STACK, FOOTNOTE_HEADER_BASELINE_OFFSET_PX, FOOTNOTE_HEADER_HEIGHT_PX, FOOTNOTE_PANEL_PADDING_PX, FOOTNOTE_ROW_HEIGHT, FRAME_TAB_HEIGHT_PX, FRAME_TAB_LABEL_BASELINE_OFFSET_PX, GROUP_BOTTOM_PAD_PX, GROUP_BRACKET_LABEL_OVERHANG_PX, GROUP_TITLE_TAB_CHAR_WIDTH_PX, GROUP_TITLE_TAB_GUTTER_PX, GROUP_TITLE_TAB_HEIGHT_PX, GROUP_TITLE_TAB_LABEL_BASELINE_OFFSET_PX, GROUP_TITLE_TAB_LABEL_FONT_SIZE_PX, GROUP_TITLE_TAB_PAD_X_PX, NOW_PILL_CORNER_RADIUS_PX, NOW_PILL_HEIGHT_PX, NOW_PILL_LABEL_BASELINE_OFFSET_PX, NOW_PILL_LABEL_FONT_SIZE_PX, NOW_PILL_LABEL_INSET_X_PX, NOW_PILL_WIDTH_PX, NOWLINE_STROKE_WIDTH_PX, PROGRESS_STRIP_HEIGHT_PX, TEXT_SIZE_PX, TIMELINE_TICK_LABEL_BASELINE_OFFSET_PX, TIMELINE_TICK_PANEL_HEIGHT_PX, TRACK_BLOCK_TAIL_GUTTER_PX, } from './themes/shared.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,mBAAmB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,gBAAgB,EACrB,gBAAgB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,GAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,2BAA2B,EAC3B,4BAA4B,EAC5B,iCAAiC,EACjC,4BAA4B,EAC5B,iCAAiC,EACjC,iCAAiC,EACjC,oCAAoC,EACpC,gCAAgC,EAChC,+BAA+B,EAC/B,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,qBAAqB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACH,uBAAuB,EACvB,oCAAoC,EACpC,8BAA8B,EAC9B,yBAAyB,EACzB,qCAAqC,EACrC,+BAA+B,EAC/B,4BAA4B,EAC5B,0CAA0C,EAC1C,sCAAsC,EACtC,+BAA+B,EAC/B,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,4BAA4B,EAC5B,yBAAyB,EACzB,sCAAsC,EACtC,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,6BAA6B,EAC7B,iCAAiC,GACpC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACH,SAAS,EACT,UAAU,EACV,KAAK,KAAK,EACV,KAAK,SAAS,EACd,MAAM,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACH,mBAAmB,EACnB,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,EACjB,gBAAgB,EAChB,8BAA8B,EAC9B,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,kCAAkC,EAClC,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,mBAAmB,EACnB,+BAA+B,EAC/B,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,wCAAwC,EACxC,kCAAkC,EAClC,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,iCAAiC,EACjC,2BAA2B,EAC3B,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,YAAY,EACZ,sCAAsC,EACtC,6BAA6B,EAC7B,0BAA0B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { estimateCapacitySuffixWidth, formatCapacityNumber, parseCapacityValue, resolveCapacityIcon, } from './capacity.js';
+export { FRAME_TAB_INNER_GAP_PX, FRAME_TAB_LEFT_INSET_PX, FRAME_TAB_MIN_WIDTH_PX, FRAME_TAB_OFFSET_FROM_BOX_PX, FRAME_TAB_OWNER_PX_PER_CHAR, FRAME_TAB_RIGHT_INSET_PX, FRAME_TAB_TITLE_PX_PER_CHAR, frameTabGeometry, } from './frame-tab-geometry.js';
+export { HEADER_AUTHOR_FONT_SIZE_PX, HEADER_AUTHOR_LINE_HEIGHT_PX, HEADER_CARD_PADDING_BOTTOM, HEADER_CARD_PADDING_TOP, HEADER_CARD_PADDING_X, HEADER_TITLE_FONT_SIZE_PX, HEADER_TITLE_LINE_HEIGHT_PX, HEADER_TITLE_TO_AUTHOR_GAP_PX, } from './header-card-geometry.js';
+export { INCLUDE_CHROME_BADGE_GAP_PX, INCLUDE_CHROME_BADGE_SIZE_PX, INCLUDE_CHROME_OFFSET_FROM_BOX_PX, INCLUDE_CHROME_SOURCE_GAP_PX, INCLUDE_CHROME_SOURCE_HALO_PAD_PX, INCLUDE_CHROME_SOURCE_PER_CHAR_PX, INCLUDE_CHROME_TAB_LABEL_PER_CHAR_PX, INCLUDE_CHROME_TAB_LEFT_INSET_PX, INCLUDE_CHROME_TAB_MIN_WIDTH_PX, INCLUDE_CHROME_TAB_RIGHT_INSET_PX, includeChromeGeometry, } from './include-chrome-geometry.js';
+export { ITEM_CAPTION_INSET_X_PX, ITEM_CAPTION_META_BASELINE_OFFSET_PX, ITEM_CAPTION_META_FONT_SIZE_PX, ITEM_CAPTION_SPILL_GAP_PX, ITEM_CAPTION_TITLE_BASELINE_OFFSET_PX, ITEM_CAPTION_TITLE_FONT_SIZE_PX, ITEM_DECORATION_SPILL_GAP_PX, ITEM_FOOTNOTE_INDICATOR_BASELINE_OFFSET_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_INSET_TOP_PX, ITEM_STATUS_DOT_RADIUS_PX, LABEL_CHIP_GAP_ABOVE_PROGRESS_STRIP_PX, LABEL_CHIP_GAP_BETWEEN_PX, LABEL_CHIP_HEIGHT_PX, MIN_BAR_WIDTH_FOR_DOT_PX, MIN_BAR_WIDTH_FOR_FOOTNOTE_PX, MIN_BAR_WIDTH_FOR_LINK_AND_DOT_PX, } from './item-bar-geometry.js';
+export { layoutRoadmap } from './layout.js';
+export { darkTheme, lightTheme, themes, } from './themes/index.js';
+export { ACCENT_DASH_PATTERN, ATTRIBUTION_BAR_LOGICAL_WIDTH, ATTRIBUTION_BAR_LOGICAL_X, ATTRIBUTION_INE_LOGICAL_X, ATTRIBUTION_LINK, ATTRIBUTION_NOW_LOGICAL_X, ATTRIBUTION_PREFIX_FONT_SIZE, ATTRIBUTION_SCALE, ATTRIBUTION_TEXT, ATTRIBUTION_WORDMARK_FONT_SIZE, CORNER_RADIUS_PX, EDGE_CORNER_RADIUS, FONT_STACK, FOOTNOTE_HEADER_BASELINE_OFFSET_PX, FOOTNOTE_HEADER_HEIGHT_PX, FOOTNOTE_PANEL_PADDING_PX, FOOTNOTE_ROW_HEIGHT, FRAME_TAB_HEIGHT_PX, FRAME_TAB_LABEL_BASELINE_OFFSET_PX, GROUP_BOTTOM_PAD_PX, GROUP_BRACKET_LABEL_OVERHANG_PX, GROUP_TITLE_TAB_CHAR_WIDTH_PX, GROUP_TITLE_TAB_GUTTER_PX, GROUP_TITLE_TAB_HEIGHT_PX, GROUP_TITLE_TAB_LABEL_BASELINE_OFFSET_PX, GROUP_TITLE_TAB_LABEL_FONT_SIZE_PX, GROUP_TITLE_TAB_PAD_X_PX, NOW_PILL_CORNER_RADIUS_PX, NOW_PILL_HEIGHT_PX, NOW_PILL_LABEL_BASELINE_OFFSET_PX, NOW_PILL_LABEL_FONT_SIZE_PX, NOW_PILL_LABEL_INSET_X_PX, NOW_PILL_WIDTH_PX, NOWLINE_STROKE_WIDTH_PX, PROGRESS_STRIP_HEIGHT_PX, TEXT_SIZE_PX, TIMELINE_TICK_LABEL_BASELINE_OFFSET_PX, TIMELINE_TICK_PANEL_HEIGHT_PX, TRACK_BLOCK_TAIL_GUTTER_PX, } from './themes/shared.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,EAElB,mBAAmB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,2BAA2B,EAE3B,gBAAgB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACH,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,GAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,2BAA2B,EAC3B,4BAA4B,EAC5B,iCAAiC,EACjC,4BAA4B,EAC5B,iCAAiC,EACjC,iCAAiC,EACjC,oCAAoC,EACpC,gCAAgC,EAChC,+BAA+B,EAC/B,iCAAiC,EAEjC,qBAAqB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACH,uBAAuB,EACvB,oCAAoC,EACpC,8BAA8B,EAC9B,yBAAyB,EACzB,qCAAqC,EACrC,+BAA+B,EAC/B,4BAA4B,EAC5B,0CAA0C,EAC1C,sCAAsC,EACtC,+BAA+B,EAC/B,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,4BAA4B,EAC5B,yBAAyB,EACzB,sCAAsC,EACtC,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,6BAA6B,EAC7B,iCAAiC,GACpC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACH,SAAS,EACT,UAAU,EAGV,MAAM,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACH,mBAAmB,EACnB,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,yBAAyB,EACzB,4BAA4B,EAC5B,iBAAiB,EACjB,gBAAgB,EAChB,8BAA8B,EAC9B,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,kCAAkC,EAClC,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,mBAAmB,EACnB,+BAA+B,EAC/B,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,wCAAwC,EACxC,kCAAkC,EAClC,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,iCAAiC,EACjC,2BAA2B,EAC3B,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,YAAY,EACZ,sCAAsC,EACtC,6BAA6B,EAC7B,0BAA0B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,127 @@
+/** 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;
+/** 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;AAIxF,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"}