@nowline/layout 0.2.0

package/dist/nodes/roadmap-node.d.ts

@@ -0,0 +1,76 @@
+import type { ItemDeclaration, NowlineFile, ResolveResult, SwimlaneDeclaration } from '@nowline/core';
+import type { CalendarConfig } from '../calendar.js';
+import type { LayoutOptions, LayoutResult } from '../layout.js';
+import type { LayoutContext, LayoutHelpers } from '../layout-context.js';
+import type { BoundingBox, PositionedDependencyEdge, PositionedIncludeRegion, PositionedNowline, PositionedSwimlane } from '../types.js';
+import type { ViewPreset } from '../view-preset.js';
+/** Sized output from the beside-mode header word-wrap pass. */
+export interface SizedHeader {
+    titleLines: string[];
+    authorLines: string[];
+    cardWidth: number;
+    cardHeight: number;
+    boxWidth: number;
+}
+/**
+ * Bundle of orchestration + sequencer helpers RoadmapNode delegates to.
+ * `layout.ts` builds this struct from its private helpers and passes it
+ * once when calling `RoadmapNode.place(...)`.
+ */
+export interface RoadmapNodeDeps extends LayoutHelpers {
+    computeDateWindow: (file: NowlineFile, ctx: {
+        cal: CalendarConfig;
+        sizes: Map<string, import('../types.js').ResolvedSize>;
+    }, resolved: ResolveResult, today: Date | undefined, scale: ViewPreset) => {
+        startDate: Date;
+        endDate: Date;
+    };
+    sizeBesideHeader: (title: string, author: string | undefined) => SizedHeader;
+    collectItems: (swimlanes: SwimlaneDeclaration[]) => Map<string, ItemDeclaration>;
+    buildDependencies: (items: Map<string, ItemDeclaration>, swimlanes: PositionedSwimlane[], includes: PositionedIncludeRegion[], ctx: LayoutContext) => PositionedDependencyEdge[];
+    buildNowline: (today: Date | undefined, ctx: LayoutContext, locale: string) => PositionedNowline | null;
+}
+export declare class RoadmapNode {
+    place(file: NowlineFile, resolved: ResolveResult, options: LayoutOptions, deps: RoadmapNodeDeps): LayoutResult;
+}
+interface MarkerEntity {
+    id: string;
+    centerX: number;
+    radius: number;
+    title: string;
+    fontSize: number;
+    bold: boolean;
+}
+interface PackedPlacement {
+    rowIndex: number;
+    labelBox: BoundingBox;
+    labelSide: 'left' | 'right';
+}
+/**
+ * Pack anchors + milestones into marker rows using a bottom-first
+ * tick-order strategy. Markers default to the row CLOSEST to the
+ * chart; conflicts push them UP toward the date ticks (the inverse of
+ * swimlane items which default to the top and push down).
+ *
+ * Walk order is left-to-right by `centerX` (tick order, not file
+ * declaration). For each marker:
+ *   1. Try the bottommost existing row (highest `rowIndex`), right
+ *      side first then left, working UP through the rows.
+ *   2. If neither side fits at any existing row, GROW: prepend a new
+ *      row at `rowIndex = 0`. Every previously-placed marker has its
+ *      `rowIndex` incremented by 1 so the bottom corridor stays
+ *      stable as the band expands upward toward the ticks.
+ *
+ * Returns row-relative placements (no centerY yet — caller fills that
+ * in once `markerRowY` is known). Row indices follow the existing
+ * convention: 0 = top of band (closest to ticks), `rowCount - 1` =
+ * bottom of band (closest to chart). The "bottom-first" preference
+ * lives entirely in the search order and grow direction; geometry
+ * stays anchored to `markerRowY` at the top.
+ */
+export declare function packMarkerRow(entries: MarkerEntity[], chartLeftX: number, chartRightX: number, estimateTextWidth: (text: string, fontSize: number) => number): {
+    placements: Map<string, PackedPlacement>;
+    rowCount: number;
+};
+export {};
+//# sourceMappingURL=roadmap-node.d.ts.map

package/dist/nodes/roadmap-node.d.ts.map

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