agentic-mermaid 0.1.1 → 0.2.0

package/src/ascii/shapes/stadium.ts

@@ -1,110 +0,0 @@
-// ============================================================================
-// Stadium (pill) shape renderer — special parentheses-based rendering
-// ============================================================================
-//
-// Stadium has unique rendering: single-line is inline `(Label)`, multi-line
-// uses parentheses or rounded corners. This differs from other shapes that
-// use corner decorators with box lines.
-
-import type { Canvas, DrawingCoord, Direction } from '../types.ts'
-import { drawText, mkCanvas } from '../canvas.ts'
-import { splitLines } from '../multiline-utils.ts'
-import { visualWidth } from '../width.ts'
-import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions } from './types.ts'
-import { getBoxAttachmentPoint } from './rectangle.ts'
-
-/**
- * Stadium (pill) shape renderer.
- *
- * Single-line:  ( Label )
- *
- * Multi-line unicode:
- *   ╭──────────╮
- *   │  Label   │
- *   ╰──────────╯
- *
- * Multi-line ASCII:
- *   (----------)
- *   (  Label   )
- *   (----------)
- */
-export const stadiumRenderer: ShapeRenderer = {
-  getDimensions(label: string, options: ShapeRenderOptions): ShapeDimensions {
-    const lines = splitLines(label)
-    const maxLineWidth = Math.max(...lines.map(l => visualWidth(l)), 0)
-    const lineCount = lines.length
-
-    const innerWidth = 2 * options.padding + maxLineWidth
-    const width = innerWidth + 4  // Extra for rounded ends
-    const innerHeight = lineCount + 2 * options.padding
-    const height = Math.max(innerHeight + 2, 3)
-
-    return {
-      width,
-      height,
-      labelArea: {
-        x: 2 + options.padding,
-        y: 1 + options.padding,
-        width: maxLineWidth,
-        height: lineCount,
-      },
-      gridColumns: [2, innerWidth, 2],
-      gridRows: [1, innerHeight, 1],
-    }
-  },
-
-  render(label: string, dimensions: ShapeDimensions, options: ShapeRenderOptions): Canvas {
-    const { width, height } = dimensions
-    const canvas = mkCanvas(width - 1, height - 1)
-
-    const centerY = Math.floor(height / 2)
-    const hChar = options.useAscii ? '-' : '─'
-
-    if (height === 3) {
-      // Single row pill: (  Label  )
-      canvas[0]![centerY] = '('
-      canvas[width - 1]![centerY] = ')'
-    } else if (!options.useAscii) {
-      // Multi-row stadium with rounded corners (unicode)
-      canvas[0]![0] = '╭'
-      for (let x = 1; x < width - 1; x++) canvas[x]![0] = hChar
-      canvas[width - 1]![0] = '╮'
-
-      for (let y = 1; y < height - 1; y++) {
-        canvas[0]![y] = '│'
-        canvas[width - 1]![y] = '│'
-      }
-
-      canvas[0]![height - 1] = '╰'
-      for (let x = 1; x < width - 1; x++) canvas[x]![height - 1] = hChar
-      canvas[width - 1]![height - 1] = '╯'
-    } else {
-      // Multi-row stadium ASCII — parentheses on all sides
-      for (let y = 0; y < height; y++) {
-        canvas[0]![y] = '('
-        canvas[width - 1]![y] = ')'
-      }
-      for (let x = 1; x < width - 1; x++) {
-        canvas[x]![0] = hChar
-        canvas[x]![height - 1] = hChar
-      }
-    }
-
-    // Center the label
-    const lines = splitLines(label)
-    const startY = centerY - Math.floor((lines.length - 1) / 2)
-
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i]!
-      const textX = Math.floor(width / 2) - Math.floor(visualWidth(line) / 2)
-      const y = startY + i
-      if (textX > 0 && y >= 0 && y < height) {
-        drawText(canvas, { x: textX, y }, line, true)
-      }
-    }
-
-    return canvas
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}

package/src/ascii/shapes/state.ts

@@ -1,192 +0,0 @@
-// ============================================================================
-// State pseudo-state renderers — UML start and end states
-// ============================================================================
-
-import type { Canvas, DrawingCoord, Direction } from '../types.ts'
-import { Up, Down, Left, Right, UpperLeft, UpperRight, LowerLeft, LowerRight } from '../types.ts'
-import { mkCanvas } from '../canvas.ts'
-import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions } from './types.ts'
-import { dirEquals } from '../edge-routing.ts'
-
-/**
- * State start pseudo-state renderer — filled circle in rounded box.
- * Renders as:
- *   ╭───╮
- *   │ ● │   (Unicode)
- *   ╰───╯
- *
- *   .---.
- *   | * |   (ASCII)
- *   '---'
- *
- * This represents the UML initial pseudo-state.
- */
-export const stateStartRenderer: ShapeRenderer = {
-  getDimensions(_label: string, _options: ShapeRenderOptions): ShapeDimensions {
-    // Start state is a 5x3 rounded box with centered symbol
-    const width = 5
-    const height = 3
-
-    return {
-      width,
-      height,
-      labelArea: { x: 2, y: 1, width: 1, height: 1 },
-      gridColumns: [1, 3, 1],
-      gridRows: [1, 1, 1],
-    }
-  },
-
-  render(_label: string, dimensions: ShapeDimensions, options: ShapeRenderOptions): Canvas {
-    const { width, height } = dimensions
-    const canvas = mkCanvas(width - 1, height - 1)
-
-    const centerX = Math.floor(width / 2)  // = 2
-
-    if (!options.useAscii) {
-      // Unicode rounded box with filled circle: ╭───╮ │ ● │ ╰───╯
-      canvas[0]![0] = '╭'
-      canvas[1]![0] = '─'
-      canvas[2]![0] = '─'
-      canvas[3]![0] = '─'
-      canvas[4]![0] = '╮'
-
-      canvas[0]![1] = '│'
-      canvas[centerX]![1] = '●'
-      canvas[4]![1] = '│'
-
-      canvas[0]![2] = '╰'
-      canvas[1]![2] = '─'
-      canvas[2]![2] = '─'
-      canvas[3]![2] = '─'
-      canvas[4]![2] = '╯'
-    } else {
-      // ASCII rounded box: .---. | * | '---'
-      canvas[0]![0] = '.'
-      canvas[1]![0] = '-'
-      canvas[2]![0] = '-'
-      canvas[3]![0] = '-'
-      canvas[4]![0] = '.'
-
-      canvas[0]![1] = '|'
-      canvas[centerX]![1] = '*'
-      canvas[4]![1] = '|'
-
-      canvas[0]![2] = '\''
-      canvas[1]![2] = '-'
-      canvas[2]![2] = '-'
-      canvas[3]![2] = '-'
-      canvas[4]![2] = '\''
-    }
-
-    return canvas
-  },
-
-  getAttachmentPoint(
-    dir: Direction,
-    dimensions: ShapeDimensions,
-    baseCoord: DrawingCoord
-  ): DrawingCoord {
-    const { width, height } = dimensions
-    const centerX = baseCoord.x + Math.floor(width / 2)
-    const centerY = baseCoord.y + Math.floor(height / 2)
-
-    if (dirEquals(dir, Up)) return { x: centerX, y: baseCoord.y }
-    if (dirEquals(dir, Down)) return { x: centerX, y: baseCoord.y + height - 1 }
-    if (dirEquals(dir, Left)) return { x: baseCoord.x, y: centerY }
-    if (dirEquals(dir, Right)) return { x: baseCoord.x + width - 1, y: centerY }
-    // All diagonals and middle point to center
-    return { x: centerX, y: centerY }
-  },
-}
-
-/**
- * State end pseudo-state renderer — bullseye in double-bordered box.
- * Renders as:
- *   ╔═══╗
- *   ║ ◎ ║   (Unicode)
- *   ╚═══╝
- *
- *   #===#
- *   # * #   (ASCII)
- *   #===#
- *
- * This represents the UML final state. The double border distinguishes it
- * from the start state's single rounded border.
- */
-export const stateEndRenderer: ShapeRenderer = {
-  getDimensions(_label: string, _options: ShapeRenderOptions): ShapeDimensions {
-    // End state is a 5x3 double-bordered box with centered symbol
-    const width = 5
-    const height = 3
-
-    return {
-      width,
-      height,
-      labelArea: { x: 2, y: 1, width: 1, height: 1 },
-      gridColumns: [1, 3, 1],
-      gridRows: [1, 1, 1],
-    }
-  },
-
-  render(_label: string, dimensions: ShapeDimensions, options: ShapeRenderOptions): Canvas {
-    const { width, height } = dimensions
-    const canvas = mkCanvas(width - 1, height - 1)
-
-    const centerX = Math.floor(width / 2)  // = 2
-
-    if (!options.useAscii) {
-      // Unicode double-bordered box with bullseye: ╔═══╗ ║ ◎ ║ ╚═══╝
-      canvas[0]![0] = '╔'
-      canvas[1]![0] = '═'
-      canvas[2]![0] = '═'
-      canvas[3]![0] = '═'
-      canvas[4]![0] = '╗'
-
-      canvas[0]![1] = '║'
-      canvas[centerX]![1] = '◎'
-      canvas[4]![1] = '║'
-
-      canvas[0]![2] = '╚'
-      canvas[1]![2] = '═'
-      canvas[2]![2] = '═'
-      canvas[3]![2] = '═'
-      canvas[4]![2] = '╝'
-    } else {
-      // ASCII double-bordered box: #===# # * # #===#
-      canvas[0]![0] = '#'
-      canvas[1]![0] = '='
-      canvas[2]![0] = '='
-      canvas[3]![0] = '='
-      canvas[4]![0] = '#'
-
-      canvas[0]![1] = '#'
-      canvas[centerX]![1] = '*'
-      canvas[4]![1] = '#'
-
-      canvas[0]![2] = '#'
-      canvas[1]![2] = '='
-      canvas[2]![2] = '='
-      canvas[3]![2] = '='
-      canvas[4]![2] = '#'
-    }
-
-    return canvas
-  },
-
-  getAttachmentPoint(
-    dir: Direction,
-    dimensions: ShapeDimensions,
-    baseCoord: DrawingCoord
-  ): DrawingCoord {
-    const { width, height } = dimensions
-    const centerX = baseCoord.x + Math.floor(width / 2)
-    const centerY = baseCoord.y + Math.floor(height / 2)
-
-    if (dirEquals(dir, Up)) return { x: centerX, y: baseCoord.y }
-    if (dirEquals(dir, Down)) return { x: centerX, y: baseCoord.y + height - 1 }
-    if (dirEquals(dir, Left)) return { x: baseCoord.x, y: centerY }
-    if (dirEquals(dir, Right)) return { x: baseCoord.x + width - 1, y: centerY }
-    // All diagonals and middle point to center
-    return { x: centerX, y: centerY }
-  },
-}

package/src/ascii/shapes/types.ts

@@ -1,73 +0,0 @@
-// ============================================================================
-// Shape renderer types — interface for pluggable ASCII shape renderers
-// ============================================================================
-
-import type { Canvas, DrawingCoord, Direction, AsciiNodeShape } from '../types.ts'
-
-/**
- * Dimensions calculated for a shape, used by layout and rendering.
- */
-export interface ShapeDimensions {
-  /** Total width in characters including borders */
-  width: number
-  /** Total height in characters including borders */
-  height: number
-  /** Label area bounds (where text can be placed) */
-  labelArea: {
-    x: number
-    y: number
-    width: number
-    height: number
-  }
-  /** Grid column widths for the 3-column layout [left, center, right] */
-  gridColumns: [number, number, number]
-  /** Grid row heights for the 3-row layout [top, middle, bottom] */
-  gridRows: [number, number, number]
-}
-
-/**
- * Options passed to shape renderers.
- */
-export interface ShapeRenderOptions {
-  /** Use ASCII chars (+,-,|) vs Unicode box-drawing (┌,─,│) */
-  useAscii: boolean
-  /** Padding inside the shape */
-  padding: number
-}
-
-/**
- * Interface for pluggable shape renderers.
- * Each shape type implements this interface.
- */
-export interface ShapeRenderer {
-  /**
-   * Calculate dimensions for this shape given a label.
-   * Used during layout to determine node size.
-   */
-  getDimensions(label: string, options: ShapeRenderOptions): ShapeDimensions
-
-  /**
-   * Render the shape to a canvas.
-   * Returns a standalone canvas containing just the shape.
-   */
-  render(
-    label: string,
-    dimensions: ShapeDimensions,
-    options: ShapeRenderOptions
-  ): Canvas
-
-  /**
-   * Get the edge attachment point for a given direction.
-   * Used by edge routing to determine where edges connect.
-   */
-  getAttachmentPoint(
-    dir: Direction,
-    dimensions: ShapeDimensions,
-    baseCoord: DrawingCoord
-  ): DrawingCoord
-}
-
-/**
- * Registry of shape renderers keyed by shape type.
- */
-export type ShapeRegistry = Map<AsciiNodeShape, ShapeRenderer>

package/src/ascii/timeline.ts

@@ -1,141 +0,0 @@
-// ============================================================================
-// ASCII renderer — timeline diagrams
-//
-// Renders Mermaid timeline syntax as a chronological outline with per-period
-// markers and indented milestone lists. This keeps the ASCII variant compact
-// and readable in terminals while preserving chronology and section grouping.
-// ============================================================================
-
-import { parseTimelineDiagram } from '../timeline/parser.ts'
-import { colorizeLine, DEFAULT_ASCII_THEME } from './ansi.ts'
-import type { AsciiConfig, AsciiTheme, CharRole, ColorMode } from './types.ts'
-import { wrapText } from './wrap.ts'
-
-interface StyledSegment {
-  text: string
-  role: CharRole | null
-}
-
-function renderStyledLine(
-  segments: StyledSegment[],
-  colorMode: ColorMode,
-  theme: AsciiTheme,
-): string {
-  const chars: string[] = []
-  const roles: (CharRole | null)[] = []
-
-  for (const segment of segments) {
-    for (const char of segment.text) {
-      chars.push(char)
-      roles.push(segment.role)
-    }
-  }
-
-  return colorizeLine(chars, roles, theme, colorMode)
-}
-
-/**
- * Render a Mermaid timeline diagram to ASCII/Unicode text.
- */
-export function renderTimelineAscii(
-  lines: string[],
-  config: AsciiConfig,
-  colorMode: ColorMode = 'none',
-  theme: AsciiTheme = DEFAULT_ASCII_THEME,
-  maxWidth?: number,
-): string {
-  const diagram = parseTimelineDiagram(lines)
-  const useAscii = config.useAscii
-
-  const marker = useAscii ? 'o' : '○'
-  const vertical = useAscii ? '|' : '│'
-  const branch = useAscii ? '|' : '├'
-  const lastBranch = useAscii ? '`' : '└'
-  const horizontal = useAscii ? '-' : '─'
-  const periodContinuation = '  '
-
-  const out: string[] = []
-  const pushLine = (segments: StyledSegment[] = []): void => {
-    out.push(segments.length === 0 ? '' : renderStyledLine(segments, colorMode, theme))
-  }
-
-  if (diagram.title) {
-    for (const line of wrapText(diagram.title, maxWidth)) {
-      pushLine([{ text: line, role: 'text' }])
-    }
-    pushLine()
-  }
-
-  for (let sectionIndex = 0; sectionIndex < diagram.sections.length; sectionIndex++) {
-    const section = diagram.sections[sectionIndex]!
-
-    if (section.label) {
-      // Bracket only the first line of a wrapped label — bracketing every
-      // line would read as one section per line. Continuations indent by
-      // one cell to align inside the opening bracket.
-      const labelLines = wrapText(section.label.replace(/\n/g, ' / '), maxWidth ? Math.max(1, maxWidth - 2) : undefined)
-      labelLines.forEach((line, index) => {
-        const segments: StyledSegment[] = [
-          index === 0
-            ? { text: '[', role: 'border' }
-            : { text: ' ', role: null },
-          { text: line, role: 'text' },
-        ]
-        if (index === labelLines.length - 1) segments.push({ text: ']', role: 'border' })
-        pushLine(segments)
-      })
-    }
-
-    for (let periodIndex = 0; periodIndex < section.periods.length; periodIndex++) {
-      const period = section.periods[periodIndex]!
-      // Continuation lines carry the wider 3-cell prefix, so wrap to that.
-      const periodLines = wrapText(period.label, maxWidth ? Math.max(1, maxWidth - 3) : undefined)
-
-      pushLine([
-        { text: marker, role: 'junction' },
-        { text: ' ', role: null },
-        { text: periodLines[0] ?? '', role: 'text' },
-      ])
-      for (const line of periodLines.slice(1)) {
-        pushLine([
-          { text: `${periodContinuation} `, role: null },
-          { text: line, role: 'text' },
-        ])
-      }
-
-      for (let eventIndex = 0; eventIndex < period.events.length; eventIndex++) {
-        const event = period.events[eventIndex]!
-        // First-line prefix ('│  ├─ ') is 6 cells wide.
-        const eventLines = wrapText(event.text, maxWidth ? Math.max(1, maxWidth - 6) : undefined)
-        const junction = eventIndex === period.events.length - 1 ? lastBranch : branch
-        pushLine([
-          { text: vertical, role: 'line' },
-          { text: '  ', role: null },
-          { text: junction, role: eventIndex === period.events.length - 1 ? 'corner' : 'junction' },
-          { text: horizontal, role: 'line' },
-          { text: ' ', role: null },
-          { text: eventLines[0] ?? '', role: 'text' },
-        ])
-
-        for (const line of eventLines.slice(1)) {
-          pushLine(eventIndex === period.events.length - 1
-            ? [
-                { text: '    ', role: null },
-                { text: line, role: 'text' },
-              ]
-            : [
-                { text: vertical, role: 'line' },
-                { text: '   ', role: null },
-                { text: line, role: 'text' },
-              ])
-        }
-      }
-
-      const morePeriods = periodIndex < section.periods.length - 1
-      const moreSections = sectionIndex < diagram.sections.length - 1
-      if (morePeriods || moreSections) pushLine()
-    }
-  }
-
-  return out.join('\n').trimEnd()
-}