@nowline/layout 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,483 @@
+export type SizeBucket = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
+export type ShadowKind = 'none' | 'subtle' | 'soft' | 'hard';
+export type BorderKind = 'solid' | 'dashed' | 'dotted';
+export type FontFamily = 'sans' | 'serif' | 'mono';
+export type FontWeight = 'thin' | 'light' | 'normal' | 'bold';
+export type BracketKind = 'none' | 'solid' | 'dashed';
+export type HeaderPosition = 'beside' | 'above';
+export type TimelinePosition = 'top' | 'bottom' | 'both';
+export type StatusKind = 'planned' | 'in-progress' | 'done' | 'at-risk' | 'blocked' | 'neutral';
+export interface ResolvedStyle {
+    bg: string;
+    fg: string;
+    text: string;
+    border: BorderKind;
+    icon: string;
+    shadow: ShadowKind;
+    font: FontFamily;
+    weight: FontWeight;
+    italic: boolean;
+    textSize: SizeBucket;
+    padding: SizeBucket;
+    spacing: SizeBucket;
+    headerHeight: SizeBucket;
+    cornerRadius: SizeBucket;
+    bracket: BracketKind;
+    headerPosition: HeaderPosition;
+    /**
+     * Glyph used as the suffix on capacity numbers (`5×`, `5 [person]`, etc.).
+     * Stores the raw value as the author wrote it: a built-in icon name
+     * (`'multiplier'`, `'person'`, ...), a custom symbol id declared via
+     * `symbol` in config, or an inline Unicode literal (`'💰'`). The renderer
+     * resolves built-in vs custom vs literal at paint time using
+     * `ResolvedConfig.symbols` and the `BUILTIN_CAPACITY_ICONS` set.
+     * Default `'multiplier'`.
+     */
+    capacityIcon: string;
+    timelinePosition: TimelinePosition;
+    minorGrid: boolean;
+}
+export interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Calendar-resolved view of a `size NAME ["TITLE"] effort:LITERAL`
+ * declaration. Built once per layout from the AST `SizeDeclaration`s
+ * collected by the include-resolver and the active calendar (which
+ * decides how many days a literal like `2w` maps to). Items reference
+ * these via `LayoutContext.sizes` rather than walking the AST +
+ * calendar each time they need an effort.
+ *
+ * `effortLiteral` keeps the raw literal so callers can show the size's
+ * effort string (`"2w"`) on tooltips without re-formatting from
+ * `effortDays`.
+ *
+ * `title` is the optional author-provided display label. The on-bar
+ * size chip prefers `title` when present, falling back to `name` (the
+ * id) verbatim — both rendered with the case the author typed. See
+ * specs/rendering.md § Item size chip.
+ */
+export interface ResolvedSize {
+    name: string;
+    title?: string;
+    effortDays: number;
+    effortLiteral: string;
+}
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface PositionedLogo {
+    box: BoundingBox;
+    assetRef?: string;
+}
+export interface PositionedHeader {
+    box: BoundingBox;
+    position: HeaderPosition;
+    title: string;
+    author?: string;
+    titleLines: string[];
+    authorLines: string[];
+    cardBox: BoundingBox;
+    logo?: PositionedLogo;
+    style: ResolvedStyle;
+    attributionBox: BoundingBox;
+}
+export interface PositionedTick {
+    x: number;
+    labelX?: number;
+    label?: string;
+    major: boolean;
+}
+export interface PositionedTimelineScale {
+    box: BoundingBox;
+    ticks: PositionedTick[];
+    pixelsPerDay: number;
+    originX: number;
+    startDate: Date;
+    endDate: Date;
+    labelStyle: ResolvedStyle;
+    pillRowHeight: number;
+    tickPanelY: number;
+    tickPanelHeight: number;
+    markerRow: {
+        y: number;
+        height: number;
+        collisionY: number;
+    };
+    bottomTickPanelY?: number;
+    bottomTickPanelHeight?: number;
+    minorGrid: boolean;
+}
+/**
+ * How the now-pill is positioned relative to the now-line.
+ *
+ *   - `center` — pill centered on the line (default). Used when both
+ *     edges have at least `NOW_PILL_WIDTH_PX/2` of clearance from the
+ *     chart's left/right edges.
+ *   - `flag-right` — line at the pill's left edge, pill extends to the
+ *     right with the right side rounded and the label left-aligned.
+ *     Used when the line lands close enough to `chartLeftX` that a
+ *     centered pill would overlap the header card / canvas left edge.
+ *   - `flag-left` — line at the pill's right edge, pill extends to the
+ *     left with the left side rounded and the label right-aligned.
+ *     Used when the line lands close enough to `chartRightX` that a
+ *     centered pill would clip past the canvas right edge.
+ *
+ * In both flag modes the squared edge IS the now-line, so the pill
+ * visually anchors to the line without growing the canvas.
+ */
+export type NowPillMode = 'center' | 'flag-right' | 'flag-left';
+export interface PositionedNowline {
+    x: number;
+    topY: number;
+    bottomY: number;
+    pillTopY: number;
+    /** How the pill aligns to the line (see `NowPillMode`). */
+    pillMode: NowPillMode;
+    /**
+     * Locale-resolved string painted inside the pill (`'now'` for `en-US`,
+     * `'maint.'` for `fr`). Layout owns the locale lookup; the renderer
+     * just paints the string. See `packages/layout/src/i18n.ts`.
+     */
+    label: string;
+    /**
+     * Width (px) of the pill. Floored at `NOW_PILL_WIDTH_PX` so en-US
+     * (`'now'`) keeps its byte-stable 36 px footprint; longer locale
+     * strings (e.g. `'maint.'` for fr) grow the pill to fit instead of
+     * clipping. Computed in `buildNowline` from `estimateTextWidth(label)`.
+     */
+    pillWidth: number;
+    style: ResolvedStyle;
+}
+export interface PositionedItem {
+    kind: 'item';
+    id?: string;
+    title: string;
+    box: BoundingBox;
+    status: StatusKind;
+    progressFraction: number;
+    footnoteIndicators: number[];
+    labelChips: PositionedLabelChip[];
+    /** True when the chip row's natural total width exceeded the bar's
+     *  effective inner width and the whole row spilled past the bar's
+     *  right edge. The chips' `box.x` already reflects the spilled
+     *  position; this flag exists for the row-packer to reserve the
+     *  spilled extent and for the renderer / debug overlays to know
+     *  the row sits outside the bar's painted footprint. */
+    chipsOutside: boolean;
+    /** Logical right x reached by the chip row, INCLUDING the chips
+     *  whether painted inside or outside the bar. Equals the start x
+     *  when there are no chips. The row-packer's spill reservation
+     *  uses this to grow the chart canvas / bump siblings. */
+    chipsRightX: number;
+    linkIcon?: LinkIconKind;
+    linkHref?: string;
+    hasOverflow: boolean;
+    overflowBox?: BoundingBox;
+    overflowAnchorId?: string;
+    owner?: string;
+    description?: string;
+    metaText?: string;
+    textSpills: boolean;
+    /** True when the bar is too narrow to host the status dot inside
+     *  with its full inset (`MIN_BAR_WIDTH_FOR_DOT_PX`). The dot
+     *  renders in the spill column to the right of the bar instead
+     *  of overshooting the bar's left edge. */
+    dotSpills: boolean;
+    /** True when the bar is too narrow to host the link-icon tile
+     *  inside without colliding with the status dot column
+     *  (`MIN_BAR_WIDTH_FOR_LINK_AND_DOT_PX`). The icon spills out and
+     *  renders ahead of the (also-spilled) title so the icon stays
+     *  visually attached to the title text. Implies `textSpills`. */
+    iconSpills: boolean;
+    /** True when the bar is too narrow to host the footnote
+     *  superscript at its inset-right position. The indicator(s)
+     *  render in the spill column trailing the title text instead
+     *  of at the bar's upper-right corner. */
+    footnoteSpills: boolean;
+    /** Pre-computed x positions for the spilled decorations. `null`
+     *  when the matching `*Spills` flag is false (decoration stays
+     *  inside the bar at its inset-anchored position). */
+    dotSpillCx: number | null;
+    iconSpillX: number | null;
+    /** First footnote indicator's left edge in the spill column.
+     *  Subsequent indicators walk right by `ITEM_FOOTNOTE_INDICATOR_STEP_PX`. */
+    footnoteSpillStartX: number | null;
+    /** Right edge of the spilled-decoration cluster (inclusive of
+     *  spilled title and footnote glyphs). Used by the row-packer
+     *  to size the row's spill reservation so the next chained item
+     *  doesn't land underneath. */
+    decorationsRightX: number;
+    /**
+     * Capacity suffix data when the item declares `capacity:N`. Null when
+     * the item has no capacity, the value is non-positive, or the resolved
+     * `capacity-icon` is `none` and no number should render either way.
+     *
+     * Renders alongside the item's `metaText` (or stand-alone when no meta
+     * is present) per specs/rendering.md § Item capacity suffix. The `text`
+     * is the formatted number (`'5'`, `'0.5'`, `'1.25'`); `icon` tells the
+     * renderer which glyph to draw and whether to use the SVG library, the
+     * `×` text node, or an inline literal.
+     */
+    capacity: PositionedCapacity | null;
+    /**
+     * Resolved size when the item declared `size:NAME`. Null when the item
+     * sized itself with a literal `duration:` or didn't declare a size at
+     * all. Used by the renderer for the size chip on the meta line (m6) and
+     * by the layout for capacity-aware duration derivation (m5).
+     */
+    size: ResolvedSize | null;
+    style: ResolvedStyle;
+}
+/**
+ * Positioned capacity suffix shared by `PositionedItem` and (in m7) the lane
+ * frame-tab badge. The shape stays small and serializable: a formatted number
+ * string plus a discriminated union for the glyph. The renderer paints both.
+ *
+ * `icon === null` means the resolved `capacity-icon` was `'none'` — render
+ * the bare number with no glyph or separator.
+ */
+export interface PositionedCapacity {
+    /** Numeric capacity, post-percent-sugar conversion (e.g. `50%` → 0.5). */
+    value: number;
+    /** Display string per spec number-formatting rules (`'5'`, `'0.5'`). */
+    text: string;
+    /** Resolved glyph instruction, or `null` when the icon is `'none'`. */
+    icon: ResolvedCapacityIconRef | null;
+}
+/**
+ * Renderer-facing capacity-icon reference. Mirrors the layout-internal
+ * `ResolvedCapacityIcon` from `capacity.ts` but lives in the shared
+ * positioned-model types so the renderer can read it without importing
+ * layout internals.
+ */
+export type ResolvedCapacityIconRef = {
+    kind: 'builtin';
+    name: 'multiplier' | 'person' | 'people' | 'points' | 'time';
+} | {
+    kind: 'literal';
+    text: string;
+};
+export type LinkIconKind = 'linear' | 'github' | 'jira' | 'generic' | 'none';
+export interface PositionedLabelChip {
+    text: string;
+    style: ResolvedStyle;
+    box: BoundingBox;
+}
+export interface PositionedGroup {
+    kind: 'group';
+    id?: string;
+    title?: string;
+    box: BoundingBox;
+    children: PositionedTrackChild[];
+    style: ResolvedStyle;
+}
+export interface PositionedParallel {
+    kind: 'parallel';
+    id?: string;
+    title?: string;
+    box: BoundingBox;
+    children: PositionedTrackChild[];
+    style: ResolvedStyle;
+}
+export type PositionedTrackChild = PositionedItem | PositionedParallel | PositionedGroup;
+export interface PositionedSwimlane {
+    id?: string;
+    title: string;
+    box: BoundingBox;
+    bandIndex: number;
+    children: PositionedTrackChild[];
+    nested: PositionedSwimlane[];
+    style: ResolvedStyle;
+    owner?: string;
+    footnoteIndicators: number[];
+    /**
+     * Lane-level capacity badge data when the swimlane declares
+     * `capacity:N`. Null when no capacity is set or the value parses to
+     * zero. The renderer paints the badge inside the frame tab after the
+     * owner badge (or after the lane title when no owner is present),
+     * per specs/rendering.md § Lane capacity badge. m8 (overload sweep)
+     * also reads `value` to compute load against item capacities.
+     *
+     * `capacity-icon:none` resolves to `icon: null` here (just the bare
+     * number renders, no glyph) but the badge still appears. Authors who
+     * want the badge fully hidden simply omit `capacity:`.
+     */
+    capacity: PositionedCapacity | null;
+    /**
+     * Tri-state utilization underline data when the lane declares
+     * `capacity:` AND has at least one item contributing load AND has not
+     * opted out of every color band via `utilization-*-at:none`. Null
+     * otherwise — the renderer paints no underline.
+     *
+     * Computed in m12 by `computeLaneUtilization` (see
+     * `lane-utilization.ts`) per specs/rendering.md § Lane utilization
+     * underline. The renderer paints one rectangle per coalesced segment
+     * along the bottom edge of the band, colored from the resolved theme's
+     * `swimlane.utilizationOk` / `…Warn` / `…Over` tokens.
+     */
+    utilization: PositionedLaneUtilization | null;
+}
+/**
+ * One classification for a lane utilization segment. `green` includes the
+ * zero-load case so the underline reads as a continuous health bar; the spec
+ * intentionally avoids a separate "idle" color.
+ */
+export type UtilizationClassification = 'green' | 'yellow' | 'red';
+/**
+ * One half-open `[startX, endX)` segment of the lane's utilization underline,
+ * pre-classified for the renderer. Adjacent same-classification segments are
+ * coalesced upstream so the renderer paints one rectangle per visible color
+ * band rather than per event boundary.
+ *
+ * `load` is the absolute concurrent capacity at this segment (sum of active
+ * items' `capacity:` values). Useful for tooltips and debug overlays; the
+ * paint color is determined by `classification` alone.
+ */
+export interface PositionedUtilizationSegment {
+    startX: number;
+    endX: number;
+    load: number;
+    classification: UtilizationClassification;
+}
+/**
+ * Resolved utilization model for a swimlane. Carries the segment list plus
+ * the resolved thresholds and capacity so downstream consumers (renderer,
+ * tooltips, exporters) can describe the model without re-resolving config.
+ *
+ * `warnFraction` / `overFraction`: each is either a positive fraction of
+ * `capacityValue` (the lane paints that color band when load reaches the
+ * fraction) or `null` to mean "this color band is opted out via
+ * `utilization-*-at:none`".
+ */
+export interface PositionedLaneUtilization {
+    segments: PositionedUtilizationSegment[];
+    capacityValue: number;
+    warnFraction: number | null;
+    overFraction: number | null;
+}
+export interface PositionedAnchor {
+    id?: string;
+    title: string;
+    center: Point;
+    radius: number;
+    style: ResolvedStyle;
+    predecessorPoints: Point[];
+    cutTopY: number;
+    cutBottomY: number;
+    bumpedUp: boolean;
+    labelBox: BoundingBox;
+    labelSide: 'left' | 'right';
+}
+export interface PositionedMilestone {
+    id?: string;
+    title: string;
+    center: Point;
+    radius: number;
+    fixed: boolean;
+    slackArrows?: Array<{
+        x: number;
+        y: number;
+    }>;
+    isOverrun: boolean;
+    style: ResolvedStyle;
+    cutTopY: number;
+    cutBottomY: number;
+    labelBox: BoundingBox;
+    labelSide: 'left' | 'right';
+}
+/**
+ * Result of packing a marker-row entity (anchor or milestone) into the
+ * dynamic row stack. `rowIndex == 0` is the in-row baseline; positive
+ * indices push the diamond DOWN by `step` px each. The label box is
+ * absolute and already accounts for left/right side flipping when the
+ * preferred side would overflow the chart.
+ */
+export interface MarkerRowPlacement {
+    rowIndex: number;
+    centerY: number;
+    labelBox: BoundingBox;
+    labelSide: 'left' | 'right';
+}
+/**
+ * Horizontal corridor occupied by a milestone's slack arrow. Sits at
+ * the slack predecessor's row Y, running from the predecessor's right
+ * edge to the milestone's column. Items whose natural placement would
+ * intersect this band must drop to a row whose Y does not match `y`,
+ * so the arrow has clear horizontal space to travel.
+ */
+export interface SlackCorridor {
+    xStart: number;
+    xEnd: number;
+    y: number;
+    slackPredId: string;
+    milestoneId: string;
+}
+export interface PositionedDependencyEdge {
+    fromId: string;
+    toId: string;
+    waypoints: Point[];
+    /**
+     * - `normal`   — orthogonal arrow drawn AFTER swimlane / item /
+     *   marker fills so it sits on top of lane bands.
+     * - `overflow` — currently unused at construction; reserved for the
+     *   red `before:` overrun annotation arrow.
+     * - `underBar` — channel router could not find a clear vertical
+     *   gutter between the source and target columns; the arrow's
+     *   vertical leg crosses one or more item bars. The renderer paints
+     *   these edges BEFORE bar fills with a thinner stroke so the bar
+     *   stays the visual foreground.
+     */
+    kind: 'normal' | 'overflow' | 'underBar';
+    style: ResolvedStyle;
+}
+export interface PositionedFootnoteIndicator {
+    number: number;
+    hostItemId: string;
+    style: ResolvedStyle;
+}
+export interface PositionedFootnoteArea {
+    box: BoundingBox;
+    entries: PositionedFootnoteEntry[];
+}
+export interface PositionedFootnoteEntry {
+    number: number;
+    title: string;
+    description?: string;
+    style: ResolvedStyle;
+}
+export interface PositionedIncludeRegion {
+    sourcePath: string;
+    label: string;
+    box: BoundingBox;
+    nestedSwimlanes: PositionedSwimlane[];
+    style: ResolvedStyle;
+}
+export interface PositionedRoadmap {
+    width: number;
+    height: number;
+    theme: 'light' | 'dark';
+    /**
+     * Resolved palette — every color the renderer reads. m2.5d moved
+     * theme resolution into the layout side, so the renderer no longer
+     * branches on `theme === 'dark'`. The `theme` field above stays for
+     * `data-theme` SVG attribution; all color decisions read `palette`.
+     */
+    palette: import('./themes/index.js').Theme;
+    backgroundColor: string;
+    header: PositionedHeader;
+    timeline: PositionedTimelineScale;
+    nowline: PositionedNowline | null;
+    swimlanes: PositionedSwimlane[];
+    anchors: PositionedAnchor[];
+    milestones: PositionedMilestone[];
+    edges: PositionedDependencyEdge[];
+    footnotes: PositionedFootnoteArea;
+    includes: PositionedIncludeRegion[];
+    chartBox: BoundingBox;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+// Positioned-model types. One type per entity in specs/rendering.md §
+// The Positioned Model. Coordinates are in SVG user units with origin at
+// top-left. All colors in `ResolvedStyle` are concrete hex strings baked
+// in by style-resolution; the renderer is palette-dumb.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,yEAAyE;AACzE,yEAAyE;AACzE,wDAAwD"}

package/dist/view-preset.d.ts

@@ -0,0 +1,23 @@
+import type { NowlineFile, ScaleBlock } from '@nowline/core';
+import type { TimeScale } from './time-scale.js';
+import type { PositionedTick } from './types.js';
+import type { WorkingCalendar } from './working-calendar.js';
+export type ScaleUnit = 'days' | 'weeks' | 'months' | 'quarters' | 'years';
+export interface ViewPreset {
+    /** Tick stride unit (each tick is one `unit` apart). */
+    unit: ScaleUnit;
+    /** Show a label every N ticks (1 = every tick gets a label). */
+    labelEvery: number;
+    /** Pixels per `1 unit` worth of working days. */
+    pixelsPerUnit: number;
+}
+export type ScaleConfig = ViewPreset;
+export declare function resolveScale(file: NowlineFile, scaleBlock: ScaleBlock | undefined): ViewPreset;
+/**
+ * Build header ticks for the chart. The ith tick sits at
+ * `originX + i * stridePx`. The last tick is rendered (so the chart
+ * has a closing edge) but its label is suppressed because there's no
+ * following column.
+ */
+export declare function buildHeaderTicks(scale: TimeScale, preset: ViewPreset, calendar: WorkingCalendar, locale?: string): PositionedTick[];
+//# sourceMappingURL=view-preset.d.ts.map

package/dist/view-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-preset.d.ts","sourceRoot":"","sources":["../src/view-preset.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAE3E,MAAM,WAAW,UAAU;IACvB,wDAAwD;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;CACzB;AAKD,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC;AAMrC,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,CAoE9F;AAmBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,eAAe,EACzB,MAAM,GAAE,MAAuB,GAChC,cAAc,EAAE,CAsBlB"}

package/dist/view-preset.js

@@ -0,0 +1,146 @@
+// ViewPreset — declarative configuration for the timeline header
+// (tick stride, label thinning, label format). Replaces the
+// imperative `for` loop and `formatTickLabel` switch in the legacy
+// `timeline.ts`.
+//
+// `resolveScale` parses the DSL `scale:` property (and any nested
+// `scale` block) into a `ViewPreset`. `buildHeaderTicks` produces
+// the `PositionedTick[]` byte-stable with the legacy generator: same
+// x positions, same labelX positions, same major/minor flags, same
+// label text.
+import { addDays } from './calendar.js';
+import { DEFAULT_LOCALE, localeStrings } from './i18n.js';
+import { DEFAULT_PIXELS_PER_DAY, LABEL_THINNING } from './themes/shared.js';
+function stripColon(key) {
+    return key.endsWith(':') ? key.slice(0, -1) : key;
+}
+export function resolveScale(file, scaleBlock) {
+    const scaleProp = file.roadmapDecl?.properties.find((p) => stripColon(p.key) === 'scale');
+    // `scale:` accepts a unit name (`days`/`weeks`/`months`/`quarters`/`years`)
+    // OR a duration literal (`1w`, `2w`, `1m`, `1q`, `1y`). The literal form
+    // is the documented default in the DSL spec; it picks the unit and uses
+    // the literal's count to size the pixels-per-unit budget.
+    const rawScale = scaleProp?.value;
+    let unit = 'weeks';
+    let pixelsPerUnitOverride;
+    let labelEveryOverride;
+    if (rawScale) {
+        if (rawScale === 'days' ||
+            rawScale === 'weeks' ||
+            rawScale === 'months' ||
+            rawScale === 'quarters' ||
+            rawScale === 'years') {
+            unit = rawScale;
+        }
+        else {
+            const dur = /^(\d+)([dwmqy])$/.exec(rawScale);
+            if (dur) {
+                const n = Math.max(1, parseInt(dur[1], 10));
+                switch (dur[2]) {
+                    case 'd':
+                        unit = 'days';
+                        break;
+                    case 'w':
+                        unit = 'weeks';
+                        break;
+                    case 'm':
+                        unit = 'months';
+                        break;
+                    case 'q':
+                        unit = 'quarters';
+                        break;
+                    case 'y':
+                        unit = 'years';
+                        break;
+                }
+                pixelsPerUnitOverride = unitPx(unit) * n;
+                // A literal scale like `1w` says "I want exactly one label per
+                // unit." Override the default thinning so every tick is named.
+                labelEveryOverride = 1;
+            }
+        }
+    }
+    const defaultLabelEvery = labelEveryOverride ?? LABEL_THINNING[unit] ?? 4;
+    if (scaleBlock) {
+        const unitProp = scaleBlock.properties.find((p) => stripColon(p.key) === 'unit');
+        const resolvedUnit = unitProp?.value ?? unit;
+        const labelProp = scaleBlock.properties.find((p) => stripColon(p.key) === 'label-every');
+        const pxProp = scaleBlock.properties.find((p) => stripColon(p.key) === 'pixels-per-unit');
+        const labelEvery = labelProp
+            ? Math.max(1, parseInt(labelProp.value, 10) || defaultLabelEvery)
+            : defaultLabelEvery;
+        const pixelsPerUnit = pxProp
+            ? Math.max(1, parseInt(pxProp.value, 10) || unitPx(resolvedUnit))
+            : (pixelsPerUnitOverride ?? unitPx(resolvedUnit));
+        return { unit: resolvedUnit, labelEvery, pixelsPerUnit };
+    }
+    return {
+        unit,
+        labelEvery: defaultLabelEvery,
+        pixelsPerUnit: pixelsPerUnitOverride ?? unitPx(unit),
+    };
+}
+function unitPx(unit) {
+    // Baseline pixel widths per one unit, tuned so ~6 month roadmaps fit
+    // comfortably in a 1200 px wide chart area.
+    switch (unit) {
+        case 'days':
+            return DEFAULT_PIXELS_PER_DAY;
+        case 'weeks':
+            return 40;
+        case 'months':
+            return 80;
+        case 'quarters':
+            return 160;
+        case 'years':
+            return 320;
+    }
+}
+/**
+ * Build header ticks for the chart. The ith tick sits at
+ * `originX + i * stridePx`. The last tick is rendered (so the chart
+ * has a closing edge) but its label is suppressed because there's no
+ * following column.
+ */
+export function buildHeaderTicks(scale, preset, calendar, locale = DEFAULT_LOCALE) {
+    const dayPerTick = calendar.daysPerUnit(preset.unit);
+    const stridePx = dayPerTick * scale.pixelsPerDay;
+    const totalDays = Math.max(1, Math.round(scale.widthPx / scale.pixelsPerDay));
+    const tickCount = Math.floor(totalDays / dayPerTick) + 1;
+    const ticks = [];
+    for (let i = 0; i < tickCount; i++) {
+        const days = i * dayPerTick;
+        const x = scale.originX + days * scale.pixelsPerDay;
+        const isMajor = i % preset.labelEvery === 0;
+        const isLast = i === tickCount - 1;
+        ticks.push({
+            x,
+            labelX: isLast ? undefined : x + stridePx / 2,
+            major: isMajor,
+            label: isMajor && !isLast
+                ? formatTickLabel(preset.unit, addDays(scale.domain[0], days), i, locale)
+                : undefined,
+        });
+    }
+    return ticks;
+}
+function formatTickLabel(unit, date, _index, locale) {
+    switch (unit) {
+        case 'days':
+            return `${date.getUTCMonth() + 1}/${date.getUTCDate()}`;
+        case 'weeks': {
+            const month = date.toLocaleString(locale, { month: 'short', timeZone: 'UTC' });
+            const day = date.getUTCDate().toString().padStart(2, '0');
+            return `${month} ${day}`;
+        }
+        case 'months':
+            return date.toLocaleString(locale, { month: 'short', timeZone: 'UTC' });
+        case 'quarters': {
+            const q = Math.floor(date.getUTCMonth() / 3) + 1;
+            return `${localeStrings(locale).quarterPrefix}${q} ${date.getUTCFullYear()}`;
+        }
+        case 'years':
+            return `${date.getUTCFullYear()}`;
+    }
+}
+//# sourceMappingURL=view-preset.js.map