@nowline/layout 0.2.0

package/dist/themes/shared.d.ts

@@ -0,0 +1,145 @@
+export declare const SPACING_PX: Record<'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl', number>;
+export declare const PADDING_PX: Record<'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl', number>;
+export declare const HEADER_HEIGHT_PX: Record<'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl', number>;
+export declare const TEXT_SIZE_PX: Record<'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl', number>;
+export declare const CORNER_RADIUS_PX: Record<'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'full', number>;
+export declare const LOGO_SIZE_PX: Record<'xs' | 'sm' | 'md' | 'lg' | 'xl', number>;
+export declare const MIN_ITEM_WIDTH = 8;
+export declare const PROGRESS_STRIP_HEIGHT_PX = 4;
+export declare const TIMELINE_TICK_PANEL_HEIGHT_PX = 24;
+/**
+ * Baseline Y of the tick-label text relative to the tick panel's top.
+ * Approximately vertically centers a 10 pt label in the panel.
+ */
+export declare const TIMELINE_TICK_LABEL_BASELINE_OFFSET_PX = 15;
+/**
+ * Horizontal breathing room (px) added to a track-block's right edge
+ * after sequencing. Applied to `group { ... }` and `parallel { ... }`
+ * blocks so successive blocks don't crowd each other. Items butt up
+ * against their neighbors (no gutter) — only block boundaries get this
+ * gutter.
+ */
+export declare const TRACK_BLOCK_TAIL_GUTTER_PX = 8;
+/** Height (px) of the frame-tab chiclet (swimlane + include region). */
+export declare const FRAME_TAB_HEIGHT_PX = 22;
+/** Baseline Y of the chiclet label relative to the tab's top edge. */
+export declare const FRAME_TAB_LABEL_BASELINE_OFFSET_PX = 15;
+/** Height (px) of the group-title chiclet anchored at the box's upper-left. */
+export declare const GROUP_TITLE_TAB_HEIGHT_PX = 16;
+/** Horizontal padding (px) on each side of the title text inside the chiclet. */
+export declare const GROUP_TITLE_TAB_PAD_X_PX = 6;
+/** Vertical gap (px) between the chiclet's bottom edge and the first inner row. */
+export declare const GROUP_TITLE_TAB_GUTTER_PX = 4;
+/** Baseline Y of the chiclet label relative to the chiclet's top edge.
+ *  Tuned for a 9 pt bold glyph roughly vertically centered in a 16 px tab. */
+export declare const GROUP_TITLE_TAB_LABEL_BASELINE_OFFSET_PX = 11;
+/** Font size (px) of the group-title chiclet label. */
+export declare const GROUP_TITLE_TAB_LABEL_FONT_SIZE_PX = 9;
+/** Approximate per-character width factor used to size the chiclet to its
+ *  title text. Mirrors the constant used in the renderer's pre-port code
+ *  so the chiclet hugs short titles without clipping long ones. */
+export declare const GROUP_TITLE_TAB_CHAR_WIDTH_PX = 5.5;
+/** Padding (px) reserved on the inside-bottom of a styled group box before
+ *  its lower stroke. Symmetric with the chiclet gutter so children breathe
+ *  on both ends. */
+export declare const GROUP_BOTTOM_PAD_PX = 4;
+/**
+ * Vertical space (px) reserved ABOVE a bracket-style (no-fill) group's
+ * box to host its overhanging title label. Bracket groups paint their
+ * label at `box.y - 2` (baseline) in the renderer — the glyph extent
+ * lives entirely ABOVE box.y. Without an explicit reservation, that
+ * overhang collides with the previous sibling's bracket-foot when two
+ * bracket-titled groups stack in a parallel (the foot ends right where
+ * the next label's top would render). The group shifts its own box.y
+ * down by this amount so the label has clear space above it; the
+ * caller advances by `bracketLabelOverhang + box.height + interRowGap`.
+ *
+ * Filled-style ("chiclet") groups use `GROUP_TITLE_TAB_HEIGHT_PX +
+ * GROUP_TITLE_TAB_GUTTER_PX` instead — the chiclet sits INSIDE the box,
+ * so they need no above-box reservation.
+ */
+export declare const GROUP_BRACKET_LABEL_OVERHANG_PX = 12;
+/**
+ * Dashed-accent pattern (px on / px off) used for two nowline accents
+ * that read as "structural emphasis": the milestone vertical cut line
+ * and the include-region's dashed border. Coupling them in one constant
+ * keeps both surfaces visually in sync.
+ *
+ * Mirrors the spec samples (`stroke-dasharray="6 4"`).
+ */
+export declare const ACCENT_DASH_PATTERN = "6 4";
+/** Width (px) of the rounded "now" pill above the now-line. */
+export declare const NOW_PILL_WIDTH_PX = 36;
+/** Height (px) of the rounded "now" pill. Matches the pill row band
+ *  reserved at the top of the timeline. */
+export declare const NOW_PILL_HEIGHT_PX = 16;
+/** Corner radius (px) of the pill — half of `NOW_PILL_HEIGHT_PX` so
+ *  the rect renders as a fully-rounded chiclet. */
+export declare const NOW_PILL_CORNER_RADIUS_PX: number;
+/** Font size (px) of the "now" label inside the pill. */
+export declare const NOW_PILL_LABEL_FONT_SIZE_PX = 10;
+/** Baseline offset (px) of the label text from the pill's top edge.
+ *  Tuned to vertically center a 10 pt bold glyph in a 16 px pill. */
+export declare const NOW_PILL_LABEL_BASELINE_OFFSET_PX: number;
+/**
+ * Horizontal inset (px) of the "now" label from the pill's squared
+ * edge in flag mode. In `flag-right` mode the label sits at
+ * `squaredEdgeX + INSET` (left-aligned past the line); in `flag-left`
+ * mode at `squaredEdgeX - INSET` (right-aligned before the line).
+ * Center mode ignores this — the label sits at `nowX` with
+ * `text-anchor=middle`.
+ */
+export declare const NOW_PILL_LABEL_INSET_X_PX = 6;
+/**
+ * Stroke width (px) of the now-line. Shared between the line itself
+ * and the flag-mode pill geometry so the squared edge of the pill
+ * lines up with the OUTER edge of the line stroke (SVG strokes are
+ * centered on their geometry, so without this offset the line
+ * stroke peeks past the pill's squared edge by half-stroke).
+ */
+export declare const NOWLINE_STROKE_WIDTH_PX = 2.25;
+export declare const ITEM_INSET_PX = 6;
+export declare const GUTTER_PX: number;
+export declare const DEFAULT_PIXELS_PER_DAY = 5;
+export declare const HEADER_BESIDE_MIN_WIDTH_PX = 120;
+export declare const HEADER_BESIDE_MAX_WIDTH_PX = 240;
+export declare const HEADER_ABOVE_HEIGHT_PX = 72;
+/** Height (px) of the header band above the entry rows. */
+export declare const FOOTNOTE_HEADER_HEIGHT_PX = 28;
+/**
+ * Single padding value (px) reused as: left/right text inset, bottom
+ * padding under the last row, gap between the header band and the
+ * first entry, and gap between the number column and the title column.
+ * Bumping it changes every footnote panel inset consistently.
+ */
+export declare const FOOTNOTE_PANEL_PADDING_PX = 16;
+/** Baseline Y of the "Footnotes" header text relative to the panel top. */
+export declare const FOOTNOTE_HEADER_BASELINE_OFFSET_PX = 22;
+/** Baseline-to-baseline spacing between footnote entry rows. */
+export declare const FOOTNOTE_ROW_HEIGHT = 18;
+export declare const ATTRIBUTION_TEXT = "Powered by";
+export declare const ATTRIBUTION_LINK = "https://nowline.io";
+export declare const ATTRIBUTION_SCALE = 0.22;
+export declare const ATTRIBUTION_WORDMARK_FONT_SIZE = 40;
+export declare const ATTRIBUTION_PREFIX_FONT_SIZE = 32;
+export declare const ATTRIBUTION_PREFIX_LOGICAL_WIDTH: number;
+export declare const ATTRIBUTION_PREFIX_TO_WORDMARK_GAP = 10;
+export declare const ATTRIBUTION_NOW_LOGICAL_X: number;
+export declare const ATTRIBUTION_BAR_LOGICAL_X: number;
+export declare const ATTRIBUTION_BAR_LOGICAL_WIDTH = 5;
+export declare const ATTRIBUTION_INE_LOGICAL_X: number;
+export declare const ATTRIBUTION_INE_LOGICAL_WIDTH: number;
+export declare const ATTRIBUTION_GLYPH_LOGICAL_WIDTH: number;
+export declare const ATTRIBUTION_GLYPH_LOGICAL_HEIGHT: number;
+export declare const ATTRIBUTION_GLYPH_WIDTH: number;
+export declare const ATTRIBUTION_GLYPH_HEIGHT: number;
+export declare const EDGE_CORNER_RADIUS = 4;
+export declare const SHADOW_PARAMS: Record<'none' | 'subtle' | 'soft' | 'hard', {
+    dx: number;
+    dy: number;
+    stdDeviation: number;
+    opacity: number;
+}>;
+export declare const FONT_STACK: Record<'sans' | 'serif' | 'mono', string>;
+export declare const LABEL_THINNING: Record<'days' | 'weeks' | 'months' | 'quarters' | 'years', number>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/themes/shared.d.ts.map

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

package/dist/themes/shared.js

@@ -0,0 +1,310 @@
+// Values that are currently identical across every theme. The split is
+// allowed to move: if a theme needs its own padding or shadow tuning, the
+// value migrates into the Theme interface + both per-theme files. Nothing
+// in the layout engine assumes a particular split.
+export const SPACING_PX = {
+    none: 0,
+    xs: 2,
+    sm: 4,
+    md: 8,
+    lg: 16,
+    xl: 24,
+};
+export const PADDING_PX = {
+    none: 0,
+    xs: 4,
+    sm: 8,
+    md: 12,
+    lg: 20,
+    xl: 32,
+};
+export const HEADER_HEIGHT_PX = {
+    none: 0,
+    xs: 24,
+    sm: 36,
+    md: 56,
+    lg: 80,
+    xl: 112,
+};
+export const TEXT_SIZE_PX = {
+    none: 0,
+    xs: 10,
+    sm: 12,
+    md: 14,
+    lg: 18,
+    xl: 24,
+};
+export const CORNER_RADIUS_PX = {
+    none: 0,
+    xs: 2,
+    sm: 4,
+    md: 8,
+    lg: 12,
+    xl: 20,
+    full: 9999,
+};
+export const LOGO_SIZE_PX = {
+    xs: 18,
+    sm: 24,
+    md: 36,
+    lg: 48,
+    xl: 72,
+};
+// Row pitch (formerly `ITEM_ROW_HEIGHT = 64`) and bar height (formerly
+// `ITEM_ROW_HEIGHT - 8 = 56`) are owned by `BandScale` as of m2.5b.
+// `defaultRowBand()` keeps the legacy 64/56 split byte-stable; new
+// callers should consume `bandScale.step()` and `bandScale.bandwidth()`.
+// Minimum item bar width so zero-duration items remain visible.
+export const MIN_ITEM_WIDTH = 8;
+// Height (px) of the bottom progress strip drawn along the item bar's
+// bottom edge. Single source of truth used by:
+//   - the renderer (strip rect height + bottom-edge offset)
+//   - layout (label-chip Y reservation above the strip)
+//   - milestone slack-arrow attach Y (when a predecessor's caption
+//     spills past the bar's right edge, the arrow drops to the strip's
+//     vertical center so it visually aligns with the progress bar
+//     instead of running through the spilled text)
+//
+// Bumping this updates all three call sites consistently — the strip
+// grows, chips lift, and the slack arrow stays centered on the strip.
+export const PROGRESS_STRIP_HEIGHT_PX = 4;
+// Timeline tick header band — a single row that holds the date labels
+// (e.g. "Jan 05", "Feb 14"). Layout sizes the panel; the renderer
+// paints the labels at a fixed baseline offset from the panel's top.
+//
+// Bumping the panel height without re-centering the baseline mis-centers
+// the dates — keep both knobs together so a change to either one is
+// visible at a glance.
+export const TIMELINE_TICK_PANEL_HEIGHT_PX = 24;
+/**
+ * Baseline Y of the tick-label text relative to the tick panel's top.
+ * Approximately vertically centers a 10 pt label in the panel.
+ */
+export const TIMELINE_TICK_LABEL_BASELINE_OFFSET_PX = 15;
+/**
+ * Horizontal breathing room (px) added to a track-block's right edge
+ * after sequencing. Applied to `group { ... }` and `parallel { ... }`
+ * blocks so successive blocks don't crowd each other. Items butt up
+ * against their neighbors (no gutter) — only block boundaries get this
+ * gutter.
+ */
+export const TRACK_BLOCK_TAIL_GUTTER_PX = 8;
+// Frame-tab chiclet — the rounded label tab that overhangs a swimlane
+// frame and the dashed include-region border. Both surfaces share the
+// same height + label baseline so the chiclets read as siblings.
+//
+// The `FRAME_TAB_LABEL_BASELINE_OFFSET_PX` is tuned for a 12 pt label
+// roughly vertically centered in the tab; bumping the height without
+// adjusting the baseline pushes labels off-center.
+/** Height (px) of the frame-tab chiclet (swimlane + include region). */
+export const FRAME_TAB_HEIGHT_PX = 22;
+/** Baseline Y of the chiclet label relative to the tab's top edge. */
+export const FRAME_TAB_LABEL_BASELINE_OFFSET_PX = 15;
+// Group title chiclet — the small label tab anchored flush in the upper-left
+// corner of a styled group's bounding box. Smaller than the frame-tab so it
+// reads as a "container label" rather than a sibling of the swimlane tab.
+//
+// The chiclet's top edge aligns with the group box's top edge and its left
+// edge aligns with the box's left edge (no overhang). The group reserves
+// `GROUP_TITLE_TAB_HEIGHT_PX + GROUP_TITLE_TAB_GUTTER_PX` of vertical top
+// padding inside the box before the first child row begins, so the chiclet
+// never overlaps content. Bumping the height without re-tuning
+// `GROUP_TITLE_TAB_LABEL_BASELINE_OFFSET_PX` mis-centers the label.
+/** Height (px) of the group-title chiclet anchored at the box's upper-left. */
+export const GROUP_TITLE_TAB_HEIGHT_PX = 16;
+/** Horizontal padding (px) on each side of the title text inside the chiclet. */
+export const GROUP_TITLE_TAB_PAD_X_PX = 6;
+/** Vertical gap (px) between the chiclet's bottom edge and the first inner row. */
+export const GROUP_TITLE_TAB_GUTTER_PX = 4;
+/** Baseline Y of the chiclet label relative to the chiclet's top edge.
+ *  Tuned for a 9 pt bold glyph roughly vertically centered in a 16 px tab. */
+export const GROUP_TITLE_TAB_LABEL_BASELINE_OFFSET_PX = 11;
+/** Font size (px) of the group-title chiclet label. */
+export const GROUP_TITLE_TAB_LABEL_FONT_SIZE_PX = 9;
+/** Approximate per-character width factor used to size the chiclet to its
+ *  title text. Mirrors the constant used in the renderer's pre-port code
+ *  so the chiclet hugs short titles without clipping long ones. */
+export const GROUP_TITLE_TAB_CHAR_WIDTH_PX = 5.5;
+/** Padding (px) reserved on the inside-bottom of a styled group box before
+ *  its lower stroke. Symmetric with the chiclet gutter so children breathe
+ *  on both ends. */
+export const GROUP_BOTTOM_PAD_PX = 4;
+/**
+ * Vertical space (px) reserved ABOVE a bracket-style (no-fill) group's
+ * box to host its overhanging title label. Bracket groups paint their
+ * label at `box.y - 2` (baseline) in the renderer — the glyph extent
+ * lives entirely ABOVE box.y. Without an explicit reservation, that
+ * overhang collides with the previous sibling's bracket-foot when two
+ * bracket-titled groups stack in a parallel (the foot ends right where
+ * the next label's top would render). The group shifts its own box.y
+ * down by this amount so the label has clear space above it; the
+ * caller advances by `bracketLabelOverhang + box.height + interRowGap`.
+ *
+ * Filled-style ("chiclet") groups use `GROUP_TITLE_TAB_HEIGHT_PX +
+ * GROUP_TITLE_TAB_GUTTER_PX` instead — the chiclet sits INSIDE the box,
+ * so they need no above-box reservation.
+ */
+export const GROUP_BRACKET_LABEL_OVERHANG_PX = 12;
+/**
+ * Dashed-accent pattern (px on / px off) used for two nowline accents
+ * that read as "structural emphasis": the milestone vertical cut line
+ * and the include-region's dashed border. Coupling them in one constant
+ * keeps both surfaces visually in sync.
+ *
+ * Mirrors the spec samples (`stroke-dasharray="6 4"`).
+ */
+export const ACCENT_DASH_PATTERN = '6 4';
+// Now-line pill — the rounded "now" chiclet that sits above the
+// timeline at the now-line's x. Layout reserves the pill row's height
+// in the timeline header AND uses NOW_PILL_WIDTH_PX/2 to keep the
+// canvas wide enough that the pill never clips at the right edge
+// (centered on the line, the pill extends ±half-width past it). The
+// renderer paints with the same constants so the layout's reservation
+// matches the painted glyph 1:1.
+/** Width (px) of the rounded "now" pill above the now-line. */
+export const NOW_PILL_WIDTH_PX = 36;
+/** Height (px) of the rounded "now" pill. Matches the pill row band
+ *  reserved at the top of the timeline. */
+export const NOW_PILL_HEIGHT_PX = 16;
+/** Corner radius (px) of the pill — half of `NOW_PILL_HEIGHT_PX` so
+ *  the rect renders as a fully-rounded chiclet. */
+export const NOW_PILL_CORNER_RADIUS_PX = NOW_PILL_HEIGHT_PX / 2;
+/** Font size (px) of the "now" label inside the pill. */
+export const NOW_PILL_LABEL_FONT_SIZE_PX = 10;
+/** Baseline offset (px) of the label text from the pill's top edge.
+ *  Tuned to vertically center a 10 pt bold glyph in a 16 px pill. */
+export const NOW_PILL_LABEL_BASELINE_OFFSET_PX = NOW_PILL_HEIGHT_PX - 4;
+/**
+ * Horizontal inset (px) of the "now" label from the pill's squared
+ * edge in flag mode. In `flag-right` mode the label sits at
+ * `squaredEdgeX + INSET` (left-aligned past the line); in `flag-left`
+ * mode at `squaredEdgeX - INSET` (right-aligned before the line).
+ * Center mode ignores this — the label sits at `nowX` with
+ * `text-anchor=middle`.
+ */
+export const NOW_PILL_LABEL_INSET_X_PX = 6;
+/**
+ * Stroke width (px) of the now-line. Shared between the line itself
+ * and the flag-mode pill geometry so the squared edge of the pill
+ * lines up with the OUTER edge of the line stroke (SVG strokes are
+ * centered on their geometry, so without this offset the line
+ * stroke peeks past the pill's squared edge by half-stroke).
+ */
+export const NOWLINE_STROKE_WIDTH_PX = 2.25;
+// Visual inset applied on each side of an item bar. Two adjacent (logically
+// chained) items therefore have a 2× ITEM_INSET_PX visible gutter between
+// them, leaving room for vertical drop-lines (dependency arrows, anchor /
+// milestone cuts, the now-line) to pass between bars without crossing them.
+export const ITEM_INSET_PX = 6;
+// Canonical content gutter — the rest-state spacing between adjacent
+// pieces of chart content. Used for:
+//   - the gap between two adjacent items in a track (= 2 × ITEM_INSET_PX),
+//   - the gap between the header card and the chart's left edge (originX
+//     offset from chartLeftX),
+//   - the bottom margin around the attribution wordmark.
+//
+// Future interactive layers (e.g. drag-and-drop authoring) may locally
+// inflate this gutter at the active drop site to reveal a target slot.
+// That's a runtime concern — the layout engine emits a static positioned
+// model and the interactive shell animates spacing on top. Keep this
+// constant as the rest-state baseline.
+export const GUTTER_PX = 2 * ITEM_INSET_PX;
+// Default pixel-per-day when no explicit scale is set. Calibrated so a
+// 26-week (180 day) roadmap fits a 1200 px content area.
+export const DEFAULT_PIXELS_PER_DAY = 5;
+// Header box defaults per position. The beside-mode card width is dynamic
+// (sized to the title + author text, clamped to MIN..MAX with text wrap),
+// so the layout uses these bounds instead of a single fixed width.
+export const HEADER_BESIDE_MIN_WIDTH_PX = 120;
+export const HEADER_BESIDE_MAX_WIDTH_PX = 240;
+export const HEADER_ABOVE_HEIGHT_PX = 72;
+// Footnote panel — fixed-position panel below the chart with a
+// "Footnotes" header and one row per entry. Layout sizes the panel
+// using these values; the renderer paints labels at offsets derived
+// from the same constants so a padding bump cascades to both surfaces.
+//
+//   ┌───────────────────────────────┐
+//   │  Footnotes              ↑     │   header band (HEADER_HEIGHT)
+//   │                         │     │
+//   ├─────────────────────────┘     │   gap = PANEL_PADDING
+//   │  N  Title — description       │   row N (ROW_HEIGHT each)
+//   │  N  …                         │
+//   │                               │
+//   └───────────────────────────────┘   bottom pad = PANEL_PADDING
+//
+// Total panel height (when entries.length > 0):
+//   HEADER_HEIGHT + entries × ROW_HEIGHT + PANEL_PADDING
+/** Height (px) of the header band above the entry rows. */
+export const FOOTNOTE_HEADER_HEIGHT_PX = 28;
+/**
+ * Single padding value (px) reused as: left/right text inset, bottom
+ * padding under the last row, gap between the header band and the
+ * first entry, and gap between the number column and the title column.
+ * Bumping it changes every footnote panel inset consistently.
+ */
+export const FOOTNOTE_PANEL_PADDING_PX = 16;
+/** Baseline Y of the "Footnotes" header text relative to the panel top. */
+export const FOOTNOTE_HEADER_BASELINE_OFFSET_PX = 22;
+/** Baseline-to-baseline spacing between footnote entry rows. */
+export const FOOTNOTE_ROW_HEIGHT = 18;
+// Attribution mark — a clickable "Powered by nowline" link that sits in
+// the canvas's bottom margin. Single source of truth for layout (which
+// reserves a glyph-sized slot at canvas-bottom-right) and the renderer
+// (which paints the glyph inside that slot at the same scale, so the
+// reserved box hugs the painted glyph 1:1).
+//
+// "Powered by" is rendered at 80% of the wordmark's font size so it
+// reads as a subdued tag rather than competing with the brand. Both
+// share the same baseline (y = wordmarkFontSize) so the tag's x-height
+// sits cleanly above the wordmark's baseline.
+//
+// Logical units (before `ATTRIBUTION_SCALE`):
+//   "Powered by"  text  ≈ 10 × 32 × 0.58 = 185.6  weight 400, x=0
+//   gap                                       10
+//   "now"         text  ≈ 3  × 40 × 0.58 = 69.6   weight 700, x=195.6
+//   bar (the "l")                                 x=195.6+74=269.6, w=5
+//   "ine"         text  ≈ 3  × 40 × 0.58 = 69.6   weight 400, x=195.6+81=276.6
+// Bar bottom is y = 12 + 40 = 52. The 74/81 internal offsets keep the
+// red bar reading as a single "l" between "now" and "ine".
+export const ATTRIBUTION_TEXT = 'Powered by';
+export const ATTRIBUTION_LINK = 'https://nowline.io';
+export const ATTRIBUTION_SCALE = 0.22;
+export const ATTRIBUTION_WORDMARK_FONT_SIZE = 40;
+export const ATTRIBUTION_PREFIX_FONT_SIZE = 32;
+const ATTR_CHAR_FACTOR = 0.58;
+export const ATTRIBUTION_PREFIX_LOGICAL_WIDTH = ATTRIBUTION_TEXT.length * ATTRIBUTION_PREFIX_FONT_SIZE * ATTR_CHAR_FACTOR; // 185.6
+export const ATTRIBUTION_PREFIX_TO_WORDMARK_GAP = 10;
+export const ATTRIBUTION_NOW_LOGICAL_X = ATTRIBUTION_PREFIX_LOGICAL_WIDTH + ATTRIBUTION_PREFIX_TO_WORDMARK_GAP; // 195.6
+export const ATTRIBUTION_BAR_LOGICAL_X = ATTRIBUTION_NOW_LOGICAL_X + 74; // 269.6
+export const ATTRIBUTION_BAR_LOGICAL_WIDTH = 5;
+export const ATTRIBUTION_INE_LOGICAL_X = ATTRIBUTION_NOW_LOGICAL_X + 81; // 276.6
+export const ATTRIBUTION_INE_LOGICAL_WIDTH = 3 * ATTRIBUTION_WORDMARK_FONT_SIZE * ATTR_CHAR_FACTOR; // 69.6
+export const ATTRIBUTION_GLYPH_LOGICAL_WIDTH = ATTRIBUTION_INE_LOGICAL_X + ATTRIBUTION_INE_LOGICAL_WIDTH; // 346.2
+export const ATTRIBUTION_GLYPH_LOGICAL_HEIGHT = 12 + ATTRIBUTION_WORDMARK_FONT_SIZE; // 52
+export const ATTRIBUTION_GLYPH_WIDTH = ATTRIBUTION_GLYPH_LOGICAL_WIDTH * ATTRIBUTION_SCALE;
+export const ATTRIBUTION_GLYPH_HEIGHT = ATTRIBUTION_GLYPH_LOGICAL_HEIGHT * ATTRIBUTION_SCALE;
+// Dependency-edge rounded-corner radius (for Manhattan routing).
+export const EDGE_CORNER_RADIUS = 4;
+// Shadow filter parameters per shadow kind.
+export const SHADOW_PARAMS = {
+    none: { dx: 0, dy: 0, stdDeviation: 0, opacity: 0 },
+    subtle: { dx: 0, dy: 1, stdDeviation: 1.5, opacity: 0.2 },
+    soft: { dx: 0, dy: 3, stdDeviation: 5, opacity: 0.3 },
+    hard: { dx: 2, dy: 2, stdDeviation: 0, opacity: 0.45 },
+};
+// Font stacks keyed by DSL `font:` value.
+export const FONT_STACK = {
+    sans: 'system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
+    serif: 'Georgia, "Times New Roman", serif',
+    mono: 'ui-monospace, SFMono-Regular, Menlo, Consolas, monospace',
+};
+// Label thinning defaults per scale unit (from specs/rendering.md § Timeline).
+// Values are label-every counts (i.e. label every Nth tick).
+export const LABEL_THINNING = {
+    days: 7,
+    weeks: 4,
+    months: 3,
+    quarters: 4,
+    years: 5,
+};
+//# sourceMappingURL=shared.js.map

package/dist/themes/shared.js.map

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

package/dist/time-scale.d.ts

@@ -0,0 +1,39 @@
+import type { WorkingCalendar } from './working-calendar.js';
+export interface TimeScaleOptions {
+    /** [start, end] in calendar dates (UTC midnight assumed). */
+    domain: [Date, Date];
+    /** [originX, originX + chartWidth]. */
+    range: [number, number];
+    /** Optional non-continuous calendar for future weekend-skip support. */
+    calendar?: WorkingCalendar;
+}
+export declare class TimeScale {
+    readonly domain: [Date, Date];
+    readonly range: [number, number];
+    readonly pixelsPerDay: number;
+    readonly calendar?: WorkingCalendar;
+    private readonly d3;
+    constructor(opts: TimeScaleOptions);
+    /**
+     * Project a date onto the x-axis. Always returns a number, even
+     * for dates outside the domain (callers that need clamping use
+     * `forwardWithinDomain`).
+     */
+    forward(date: Date): number;
+    /**
+     * Project a date onto the x-axis, returning `null` when the date
+     * is outside [domain[0], domain[1]]. Replaces the legacy
+     * `xForDate(date, timeline)` helper.
+     */
+    forwardWithinDomain(date: Date): number | null;
+    /**
+     * Inverse projection. Returns a Date for any x in the chart;
+     * callers that want day-resolution can floor the result.
+     */
+    invert(x: number): Date;
+    /** First pixel of the chart (start of range). */
+    get originX(): number;
+    /** Width of the chart band in pixels. */
+    get widthPx(): number;
+}
+//# sourceMappingURL=time-scale.d.ts.map

package/dist/time-scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-scale.d.ts","sourceRoot":"","sources":["../src/time-scale.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC7B,6DAA6D;IAC7D,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrB,uCAAuC;IACvC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED,qBAAa,SAAS;IAClB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA4B;gBAEnC,IAAI,EAAE,gBAAgB;IASlC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAK3B;;;;OAIG;IACH,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI;IAK9C;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvB,iDAAiD;IACjD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,yCAAyC;IACzC,IAAI,OAAO,IAAI,MAAM,CAEpB;CACJ"}

package/dist/time-scale.js

@@ -0,0 +1,62 @@
+// Date <-> pixel mapping. Replaces the hand-coded `xForDate` /
+// `pixelsPerDay` arithmetic from `timeline.ts` with a wrapper that
+// also exposes `invert(x) -> Date` for the m4 editor work and that
+// composes with a `WorkingCalendar` for non-continuous time models.
+//
+// Forward direction matches the legacy arithmetic byte-for-byte
+// (`originX + daysBetween(domain[0], date) * pixelsPerDay`) so the
+// m2.5a refactor leaves the rendered output unchanged. Invert uses
+// `d3-scale.scaleTime` so callers get a precise Date back from a
+// pixel coordinate.
+import { scaleTime } from 'd3-scale';
+import { daysBetween } from './calendar.js';
+export class TimeScale {
+    domain;
+    range;
+    pixelsPerDay;
+    calendar;
+    d3;
+    constructor(opts) {
+        this.domain = opts.domain;
+        this.range = opts.range;
+        this.calendar = opts.calendar;
+        const spanDays = Math.max(1, daysBetween(opts.domain[0], opts.domain[1]));
+        this.pixelsPerDay = (opts.range[1] - opts.range[0]) / spanDays;
+        this.d3 = scaleTime().domain(opts.domain).range(opts.range);
+    }
+    /**
+     * Project a date onto the x-axis. Always returns a number, even
+     * for dates outside the domain (callers that need clamping use
+     * `forwardWithinDomain`).
+     */
+    forward(date) {
+        const days = daysBetween(this.domain[0], date);
+        return this.range[0] + days * this.pixelsPerDay;
+    }
+    /**
+     * Project a date onto the x-axis, returning `null` when the date
+     * is outside [domain[0], domain[1]]. Replaces the legacy
+     * `xForDate(date, timeline)` helper.
+     */
+    forwardWithinDomain(date) {
+        if (date < this.domain[0] || date > this.domain[1])
+            return null;
+        return this.forward(date);
+    }
+    /**
+     * Inverse projection. Returns a Date for any x in the chart;
+     * callers that want day-resolution can floor the result.
+     */
+    invert(x) {
+        return this.d3.invert(x);
+    }
+    /** First pixel of the chart (start of range). */
+    get originX() {
+        return this.range[0];
+    }
+    /** Width of the chart band in pixels. */
+    get widthPx() {
+        return this.range[1] - this.range[0];
+    }
+}
+//# sourceMappingURL=time-scale.js.map

package/dist/time-scale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-scale.js","sourceRoot":"","sources":["../src/time-scale.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,mEAAmE;AACnE,mEAAmE;AACnE,oEAAoE;AACpE,EAAE;AACF,gEAAgE;AAChE,mEAAmE;AACnE,mEAAmE;AACnE,iEAAiE;AACjE,oBAAoB;AAEpB,OAAO,EAAkB,SAAS,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAY5C,MAAM,OAAO,SAAS;IACT,MAAM,CAAe;IACrB,KAAK,CAAmB;IACxB,YAAY,CAAS;IACrB,QAAQ,CAAmB;IACnB,EAAE,CAA4B;IAE/C,YAAY,IAAsB;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;QAC/D,IAAI,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAU;QACd,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,IAAU;QAC1B,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAChE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,CAAS;QACZ,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,iDAAiD;IACjD,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,yCAAyC;IACzC,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;CACJ"}