@diagrammo/dgmo 0.47.0 → 0.48.0

package/src/gantt/resolver.ts

@@ -1,172 +0,0 @@
-// ============================================================
-// Gantt Dot-Notation Task Resolver
-// ============================================================
-//
-// Resolves `-> TargetName` dependency references to actual tasks.
-// Implements greedy right-to-left dot splitting for disambiguation.
-
-import type { GanttTask, GanttNode } from './types';
-import { normalizeName } from '../utils/name-normalize';
-
-interface ResolverMatch {
-  task: GanttTask;
-}
-
-interface ResolverError {
-  kind: 'not_found' | 'ambiguous';
-  message: string;
-}
-
-type ResolverResult = ResolverMatch | ResolverError;
-
-export function isResolverError(r: ResolverResult): r is ResolverError {
-  return 'kind' in r;
-}
-
-/**
- * Collect all tasks from a tree of GanttNodes, annotating each with its
- * fully qualified group path (e.g., ["Backend", "API"]).
- */
-export function collectTasks(nodes: readonly GanttNode[]): GanttTask[] {
-  const tasks: GanttTask[] = [];
-  function walk(children: readonly GanttNode[]) {
-    for (const node of children) {
-      if (node.kind === 'task') {
-        tasks.push(node);
-      } else if (node.kind === 'group' || node.kind === 'parallel') {
-        walk(node.children);
-      }
-    }
-  }
-  walk(nodes);
-  return tasks;
-}
-
-/**
- * Resolve a dependency target name to a task.
- *
- * Resolution strategy (greedy right-to-left):
- * 1. Try the full string as an exact task label match
- * 2. If no match, split at the last dot → group prefix + task label
- * 3. Recurse for deeper paths
- *
- * Returns a match or an error with helpful suggestions.
- */
-/** Strip bracket syntax: `[Backend].API Design` → `Backend.API Design` */
-const BRACKET_GROUP_RE = /^\[(.+?)\]\.(.+)$/;
-
-/** Disambiguation message when a name matches more than one task. */
-function ambiguousTaskMessage(trimmed: string, suggestions: string[]): string {
-  return `Multiple tasks match "${trimmed}". Did you mean ${suggestions
-    .map((s) => `\`${s}\``)
-    .join(' or ')}?`;
-}
-
-export function resolveTaskName(
-  name: string,
-  allTasks: GanttTask[]
-): ResolverResult {
-  let trimmed = name.trim();
-
-  // Strip bracket syntax — `[Group].Task` is sugar for `Group.Task`
-  const bracketMatch = trimmed.match(BRACKET_GROUP_RE);
-  if (bracketMatch) {
-    trimmed = `${bracketMatch[1]}.${bracketMatch[2]}`;
-  }
-
-  const normTrimmed = normalizeName(trimmed);
-
-  // 1. Try exact label match (no dots involved). Forgiving normalization
-  // (case-insensitive, whitespace-collapsed) per the universal name handling
-  // spec — `myTask` and `MyTask` resolve to the same task.
-  const exactMatches = allTasks.filter(
-    (t) => normalizeName(t.label) === normTrimmed
-  );
-  if (exactMatches.length === 1) {
-    // In-bounds by length === 1 check.
-    return { task: exactMatches[0]! };
-  }
-  if (exactMatches.length > 1) {
-    // Multiple tasks with same name — need disambiguation
-    const suggestions = exactMatches.map((t) =>
-      t.groupPath.length > 0 ? `${t.groupPath.join('.')}.${t.label}` : t.label
-    );
-    return {
-      kind: 'ambiguous',
-      message: ambiguousTaskMessage(trimmed, suggestions),
-    };
-  }
-
-  // 2. Try dot-notation: split at last dot (greedy right-to-left)
-  const lastDotIdx = trimmed.lastIndexOf('.');
-  if (lastDotIdx > 0) {
-    const groupPrefix = trimmed.substring(0, lastDotIdx);
-    const taskLabel = trimmed.substring(lastDotIdx + 1);
-
-    // Find tasks whose label matches and whose group path ends with the prefix
-    const normTaskLabel = normalizeName(taskLabel);
-    const matches = allTasks.filter((t) => {
-      if (normalizeName(t.label) !== normTaskLabel) return false;
-      return matchesGroupPath(t.groupPath, groupPrefix);
-    });
-
-    if (matches.length === 1) {
-      // In-bounds by length === 1 check.
-      return { task: matches[0]! };
-    }
-    if (matches.length > 1) {
-      const suggestions = matches.map((t) =>
-        t.groupPath.length > 0 ? `${t.groupPath.join('.')}.${t.label}` : t.label
-      );
-      return {
-        kind: 'ambiguous',
-        message: ambiguousTaskMessage(trimmed, suggestions),
-      };
-    }
-
-    // Try further left splits (for dots in group names)
-    // e.g., "U.S. Operations.Task A" — last dot split tried "U.S. Operations" + "Task A"
-    // Now try "U.S." + "Operations.Task A" — but that doesn't help.
-    // The greedy approach handles this: "U.S. Operations" is the group name.
-    // If the group name itself contains dots, the last dot split already tried the correct split.
-  }
-
-  // 3. No match found.
-  // (Case-insensitive fallback removed — the primary match is now itself
-  // case- and whitespace-insensitive via normalizeName.)
-
-  return {
-    kind: 'not_found',
-    message: `No task found with name "${trimmed}".`,
-  };
-}
-
-/**
- * Check if a task's group path matches a dot-separated prefix.
- * The prefix can be a single group name or a dot-separated path.
- * Matching is done from the end of the group path.
- *
- * Example: groupPath = ["Backend", "API"], prefix = "Backend" → true
- * Example: groupPath = ["Backend", "API"], prefix = "API" → true
- * Example: groupPath = ["Backend", "API"], prefix = "Backend.API" → true
- */
-function matchesGroupPath(
-  groupPath: readonly string[],
-  prefix: string
-): boolean {
-  const normPrefix = normalizeName(prefix);
-  // Simple case: prefix is a single segment
-  if (!prefix.includes('.')) {
-    return groupPath.some((g) => normalizeName(g) === normPrefix);
-  }
-
-  // Multi-segment prefix: try matching from the start of the group path
-  const pathStr = groupPath.map((g) => normalizeName(g)).join('.');
-  // Check if the full prefix matches any contiguous section of the path
-  return (
-    pathStr === normPrefix ||
-    pathStr.endsWith('.' + normPrefix) ||
-    pathStr.startsWith(normPrefix + '.') ||
-    pathStr.includes('.' + normPrefix + '.')
-  );
-}

package/src/gantt/types.ts

@@ -1,206 +0,0 @@
-// ============================================================
-// Gantt Chart Types
-// ============================================================
-
-import type { DgmoError } from '../diagnostics';
-import type { TagGroup } from '../utils/tag-groups';
-
-// ── Duration ────────────────────────────────────────────────
-
-/** Calendar units: d (days), w (weeks), m (months), q (quarters), y (years), h (hours), min (minutes). bd = business days. s = sprints. */
-export type DurationUnit =
-  | 'd'
-  | 'bd'
-  | 'w'
-  | 'm'
-  | 'q'
-  | 'y'
-  | 'h'
-  | 'min'
-  | 's';
-
-export interface Duration {
-  amount: number;
-  unit: DurationUnit;
-}
-
-export interface Offset {
-  duration: Duration;
-  direction: 1 | -1;
-}
-
-// ── Parsed Elements ─────────────────────────────────────────
-
-export interface GanttDependency {
-  readonly targetName: string; // raw string from `-> X` or `-> Group.X`
-  readonly label?: string; // optional label from `-label-> X` syntax
-  readonly offset?: Offset;
-  readonly lineNumber: number;
-}
-
-export interface GanttTask {
-  readonly id: string; // unique, generated during parse (e.g. "group:taskIdx")
-  readonly label: string;
-  readonly duration: Duration | null; // null for explicit-date-only tasks
-  readonly explicitStart?: string; // YYYY-MM-DD from `2024-01-15 -> 30d:` or `2024-01-15:`
-  readonly uncertain: boolean;
-  readonly progress: number | null; // 0-100 or null
-  readonly offset?: Offset; // task-level offset: shifts start date forward (+) or backward (-)
-  readonly isDefinition: boolean; // true = inline definition (has duration), false = reference-only
-  readonly dependencies: readonly GanttDependency[];
-  readonly metadata: Readonly<Record<string, string>>; // tag values from pipe metadata
-  readonly lineNumber: number;
-  readonly groupPath: readonly string[]; // e.g. ["Backend", "API"] for nested groups
-  readonly comment?: string; // accumulated // comment lines
-}
-
-export interface GanttGroup {
-  readonly name: string;
-  readonly color: string | null;
-  readonly metadata: Readonly<Record<string, string>>;
-  readonly offset?: Offset; // group-level offset: floor for all bare tasks inside
-  readonly collapsed?: boolean; // `[Group] collapsed: true` view-state marker
-  readonly lineNumber: number;
-  readonly children: readonly GanttNode[];
-}
-
-export interface GanttParallelBlock {
-  readonly kind: 'parallel';
-  readonly lineNumber: number;
-  readonly children: readonly GanttNode[];
-}
-
-/** A node in the gantt tree: either a task, group, or parallel block. */
-export type GanttNode =
-  | ({ kind: 'task' } & GanttTask)
-  | ({ kind: 'group' } & GanttGroup)
-  | GanttParallelBlock;
-
-// ── Holidays ────────────────────────────────────────────────
-
-export type Weekday = 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' | 'sun';
-
-export interface HolidayDate {
-  readonly date: string; // YYYY-MM-DD
-  readonly label: string;
-  readonly lineNumber: number;
-}
-
-export interface HolidayRange {
-  readonly startDate: string; // YYYY-MM-DD
-  readonly endDate: string; // YYYY-MM-DD
-  readonly label: string;
-  readonly lineNumber: number;
-}
-
-export interface GanttHolidays {
-  readonly dates: readonly HolidayDate[];
-  readonly ranges: readonly HolidayRange[];
-  readonly workweek: readonly Weekday[]; // default: ['mon', 'tue', 'wed', 'thu', 'fri']
-}
-
-// ── Eras & Markers (reuse timeline types) ───────────────────
-
-export interface GanttEra {
-  readonly startDate: string; // YYYY-MM-DD or '' when using offset form
-  readonly endDate: string; // YYYY-MM-DD or '' when using offset form
-  readonly label: string;
-  readonly color: string | null;
-  readonly lineNumber: number;
-  readonly offsetStart?: Offset; // +Nunit form (resolved to date via chart start)
-  readonly offsetEnd?: Offset; // +Nunit form (resolved to date via chart start)
-}
-
-export interface GanttMarker {
-  readonly date: string; // YYYY-MM-DD or '' when using offset form
-  readonly label: string;
-  readonly color: string | null;
-  readonly lineNumber: number;
-  readonly offsetDate?: Offset; // +Nunit form (resolved to date via chart start)
-}
-
-// ── Chart Options ───────────────────────────────────────────
-
-export interface GanttOptions {
-  start: string | null; // YYYY[-MM[-DD]] or null for relative timeline
-  title: string | null;
-  titleLineNumber: number | null;
-  todayMarker: 'off' | 'on' | string; // 'on' = current date, string = YYYY-MM-DD
-  criticalPath: boolean;
-  dependencies: boolean;
-  sort: 'default' | 'tag';
-  defaultSwimlaneGroup: string | null; // tag group name from `sort: tag:Team`
-  activeTag: string | null; // from `active-tag GroupName` or `active-tag none`
-  /** Line numbers for option/block keywords — maps key to source line */
-  optionLineNumbers: Record<string, number>;
-  holidaysLineNumber: number | null;
-  // ── Sprint options ─────────────────────────────────────────
-  sprintLength: Duration | null; // default { amount: 2, unit: 'w' } when sprint mode active
-  sprintNumber: number | null; // which sprint the chart starts at (default 1)
-  sprintStart: string | null; // YYYY-MM-DD — date that sprintNumber begins
-  sprintMode: 'auto' | 'explicit' | null; // auto = activated by `s` unit, explicit = sprint-* option present
-  /** When true, render bars at full intent saturation instead of the canonical 25% tint. */
-  solidFill: boolean;
-  /** When true, the renderer suppresses the chart banner title. */
-  noTitle: boolean;
-}
-
-// ── Parsed Result ───────────────────────────────────────────
-
-export interface ParsedGantt {
-  readonly nodes: readonly GanttNode[]; // top-level tree (groups, tasks, parallel blocks)
-  readonly holidays: GanttHolidays;
-  readonly tagGroups: readonly TagGroup[];
-  readonly eras: readonly GanttEra[];
-  readonly markers: readonly GanttMarker[];
-  readonly options: GanttOptions;
-  readonly diagnostics: readonly DgmoError[];
-  readonly error: string | null;
-  readonly syntaxMode: 'new' | 'legacy';
-}
-
-// ── Resolved Schedule ───────────────────────────────────────
-
-export interface ResolvedTask {
-  task: GanttTask;
-  startDate: Date;
-  endDate: Date;
-  isCriticalPath: boolean;
-  isUncertain: boolean; // true if task.uncertain OR any predecessor is uncertain
-  isMilestone: boolean;
-  groupPath: string[];
-  effectiveMetadata: Record<string, string>; // merged with inherited tags
-}
-
-export interface ResolvedGroup {
-  name: string;
-  color: string | null;
-  metadata: Record<string, string>;
-  startDate: Date;
-  endDate: Date;
-  progress: number | null; // aggregate progress (weighted average)
-  lineNumber: number;
-  depth: number;
-  collapsed?: boolean; // seeded from the `[Group] collapsed: true` source marker
-}
-
-export interface ResolvedSprint {
-  number: number;
-  startDate: Date;
-  endDate: Date;
-}
-
-export interface ResolvedSchedule {
-  tasks: ResolvedTask[];
-  groups: ResolvedGroup[];
-  startDate: Date;
-  endDate: Date;
-  holidays: GanttHolidays;
-  tagGroups: TagGroup[];
-  eras: GanttEra[];
-  markers: GanttMarker[];
-  sprints: ResolvedSprint[];
-  options: GanttOptions;
-  diagnostics: DgmoError[];
-  error: string | null;
-}

package/src/graph/diagnostics.ts

@@ -1,64 +0,0 @@
-import type { DiagnosticSpec } from '../diagnostics';
-
-/**
- * Declarative metadata for graph-family (infra + flowchart) diagnostics that
- * are currently emitted as inline literals inside the parsers. Additive only —
- * the parsers remain the source of truth for emission; this array mirrors the
- * exact wording + the ACTUAL runtime severity for tooling/docs.
- */
-export const GRAPH_DX = {
-  INFRA_NO_ENTRY: {
-    // src/infra/parser.ts:1094 — makeDgmoError(..., 'warning', 'W_INFRA_NO_ENTRY')
-    code: 'W_INFRA_NO_ENTRY',
-    severity: 'warning',
-    chartType: 'infra',
-    title: 'Infra diagram has no entry point',
-    message:
-      "Infra diagram has no 'internet' or 'edge' entry point — an infra diagram traces request traffic from an entry inward, so without one nothing carries traffic. Add an 'internet' or 'edge' node and route from it.",
-    hint: "Add an 'internet' or 'edge' node and draw an edge from it into the graph.",
-    example: `infra
-gw
-  -> svc
-svc
-`,
-  },
-  INFRA_UNREACHABLE: {
-    // src/infra/parser.ts:1145 — makeDgmoError(..., 'warning', 'W_INFRA_UNREACHABLE')
-    code: 'W_INFRA_UNREACHABLE',
-    severity: 'warning',
-    chartType: 'infra',
-    title: 'Infra node is unreachable from an entry',
-    message: (p) =>
-      `'${String(p.label ?? '')}' is unreachable from an 'internet'/'edge' entry — no request traffic flows to it, so it's dead on an infra diagram. Connect it downstream of an entry, or remove it.`,
-    hint: 'Connect the node downstream of an entry, or remove it.',
-    example: `infra
-
-edge
-  rps: 1000
-  -> A
-
-A
-  latency-ms: 10
-
-Orphan
-  latency-ms: 20
-`,
-  },
-  FLOWCHART_NODE_SUFFIX: {
-    // src/graph/flowchart-parser.ts:329 — makeDgmoError(..., 'warning', 'W_FLOWCHART_NODE_SUFFIX')
-    code: 'W_FLOWCHART_NODE_SUFFIX',
-    severity: 'warning',
-    chartType: 'flowchart',
-    title: 'Unsupported text after a flowchart node shape',
-    message: (p) =>
-      `Ignored unsupported text after a node shape: "${String(
-        p.trailing ?? ''
-      )}". Flowcharts have no tag groups or node metadata; node colors are assigned automatically by shape (e.g. terminals green/red, decisions yellow). Remove the suffix.`,
-    hint: 'Remove the trailing tag/metadata suffix — flowchart node colors come from shape.',
-    example: `flowchart
-(Start) -> (Denied) s: Denied
-`,
-  },
-} satisfies Record<string, DiagnosticSpec>;
-
-export const GRAPH_DIAGNOSTICS: DiagnosticSpec[] = Object.values(GRAPH_DX);

package/src/graph/edge-spline.ts

@@ -1,29 +0,0 @@
-// ============================================================
-// Edge spline — basis curve clamped to its endpoints
-// ============================================================
-
-import * as d3Shape from 'd3-shape';
-
-const lineGenerator = d3Shape
-  .line<{ x: number; y: number }>()
-  .x((d) => d.x)
-  .y((d) => d.y)
-  .curve(d3Shape.curveBasis);
-
-/**
- * Build a smooth edge path through dagre waypoints.
- *
- * `d3.curveBasis` already begins with `moveTo(P0)` and ends with
- * `lineTo(Pn)`, so the path reaches both node borders and its final
- * segment carries a real direction (correct `marker-end` orientation).
- *
- * NOTE: do NOT clamp by triplicating the endpoints — that appends
- * zero-length trailing segments, and WebKit then computes a degenerate
- * tangent for the arrowhead, rendering it at the wrong angle (resvg and
- * Chromium tolerate it; WKWebView does not).
- */
-export function edgeSplinePath(
-  points: ReadonlyArray<{ readonly x: number; readonly y: number }>
-): string | null {
-  return lineGenerator(points as { x: number; y: number }[]);
-}