agentic-mermaid 0.1.1 → 0.2.0

package/src/ascii/shapes/diamond.ts

@@ -1,27 +0,0 @@
-// ============================================================================
-// Diamond shape renderer — uses corner decorators instead of diagonals
-// ============================================================================
-
-import type { ShapeRenderer } from './types.ts'
-import { getBoxDimensions, renderBox, getBoxAttachmentPoint } from './rectangle.ts'
-import { getCorners } from './corners.ts'
-
-/**
- * Diamond shape renderer.
- * Uses diamond markers (◇) at corners to indicate decision node semantics.
- *
- * Renders as:
- *   ◇─────────◇
- *   │  Label  │
- *   ◇─────────◇
- */
-export const diamondRenderer: ShapeRenderer = {
-  getDimensions: getBoxDimensions,
-
-  render(label, dimensions, options) {
-    const corners = getCorners('diamond', options.useAscii)
-    return renderBox(label, dimensions, corners, options.useAscii)
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}

package/src/ascii/shapes/hexagon.ts

@@ -1,27 +0,0 @@
-// ============================================================================
-// Hexagon shape renderer — uses corner decorators instead of diagonals
-// ============================================================================
-
-import type { ShapeRenderer } from './types.ts'
-import { getBoxDimensions, renderBox, getBoxAttachmentPoint } from './rectangle.ts'
-import { getCorners } from './corners.ts'
-
-/**
- * Hexagon shape renderer.
- * Uses hexagon markers (⬡) at corners to indicate process node semantics.
- *
- * Renders as:
- *   ⬡─────────⬡
- *   │  Label  │
- *   ⬡─────────⬡
- */
-export const hexagonRenderer: ShapeRenderer = {
-  getDimensions: getBoxDimensions,
-
-  render(label, dimensions, options) {
-    const corners = getCorners('hexagon', options.useAscii)
-    return renderBox(label, dimensions, corners, options.useAscii)
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}

package/src/ascii/shapes/index.ts

@@ -1,106 +0,0 @@
-// ============================================================================
-// Shape registry — pluggable ASCII shape renderers
-// ============================================================================
-
-import type { AsciiNodeShape, Canvas, DrawingCoord, Direction } from '../types.ts'
-import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions, ShapeRegistry } from './types.ts'
-
-// Import all shape renderers
-import { rectangleRenderer } from './rectangle.ts'
-import { diamondRenderer } from './diamond.ts'
-import { circleRenderer } from './circle.ts'
-import { stateStartRenderer, stateEndRenderer } from './state.ts'
-import { roundedRenderer } from './rounded.ts'
-import { stadiumRenderer } from './stadium.ts'
-import { hexagonRenderer } from './hexagon.ts'
-import {
-  subroutineRenderer,
-  doublecircleRenderer,
-  cylinderRenderer,
-  asymmetricRenderer,
-  trapezoidRenderer,
-  trapezoidAltRenderer,
-  leanRRenderer,
-  leanLRenderer,
-} from './special.ts'
-
-// Re-export types
-export type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions, ShapeRegistry }
-
-/**
- * Global shape registry — maps shape types to their renderers.
- * Rectangle is the default fallback for unregistered shapes.
- */
-export const shapeRegistry: ShapeRegistry = new Map<AsciiNodeShape, ShapeRenderer>([
-  // Core shapes
-  ['rectangle', rectangleRenderer],
-  ['service', rectangleRenderer],
-  ['rounded', roundedRenderer],
-  ['diamond', diamondRenderer],
-  ['stadium', stadiumRenderer],
-  ['circle', circleRenderer],
-
-  // Batch 1 additions
-  ['subroutine', subroutineRenderer],
-  ['doublecircle', doublecircleRenderer],
-  ['hexagon', hexagonRenderer],
-
-  // Batch 2 additions
-  ['cylinder', cylinderRenderer],
-  ['asymmetric', asymmetricRenderer],
-  ['trapezoid', trapezoidRenderer],
-  ['trapezoid-alt', trapezoidAltRenderer],
-  ['lean-r', leanRRenderer],
-  ['lean-l', leanLRenderer],
-
-  // State diagram pseudo-states
-  ['state-start', stateStartRenderer],
-  ['state-end', stateEndRenderer],
-])
-
-/**
- * Get the renderer for a shape type, falling back to rectangle.
- */
-export function getShapeRenderer(shape: AsciiNodeShape): ShapeRenderer {
-  return shapeRegistry.get(shape) ?? rectangleRenderer
-}
-
-/**
- * Render a node shape to a canvas.
- * This is the main entry point for shape rendering.
- */
-export function renderShape(
-  shape: AsciiNodeShape,
-  label: string,
-  options: ShapeRenderOptions
-): Canvas {
-  const renderer = getShapeRenderer(shape)
-  const dimensions = renderer.getDimensions(label, options)
-  return renderer.render(label, dimensions, options)
-}
-
-/**
- * Get dimensions for a shape given a label.
- * Used during layout to determine node size.
- */
-export function getShapeDimensions(
-  shape: AsciiNodeShape,
-  label: string,
-  options: ShapeRenderOptions
-): ShapeDimensions {
-  const renderer = getShapeRenderer(shape)
-  return renderer.getDimensions(label, options)
-}
-
-/**
- * Get edge attachment point for a shape.
- */
-export function getShapeAttachmentPoint(
-  shape: AsciiNodeShape,
-  dir: Direction,
-  dimensions: ShapeDimensions,
-  baseCoord: DrawingCoord
-): DrawingCoord {
-  const renderer = getShapeRenderer(shape)
-  return renderer.getAttachmentPoint(dir, dimensions, baseCoord)
-}

package/src/ascii/shapes/rectangle.ts

@@ -1,168 +0,0 @@
-// ============================================================================
-// Rectangle shape renderer — standard box with corners
-// ============================================================================
-//
-// This module provides the base box rendering used by all rectangular shapes.
-// The renderBox() function accepts custom corner characters, allowing different
-// shapes to reuse the same rendering logic with different visual markers.
-
-import type { Canvas, DrawingCoord, Direction } from '../types.ts'
-import { Up, Down, Left, Right, UpperLeft, UpperRight, LowerLeft, LowerRight, Middle } 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 { dirEquals } from '../edge-routing.ts'
-import { type CornerChars, getCorners } from './corners.ts'
-
-// ============================================================================
-// Shared dimension calculation
-// ============================================================================
-
-/**
- * Calculate standard box dimensions for any rectangular shape.
- * Used by rectangle, circle, diamond, hexagon, etc.
- */
-export function getBoxDimensions(label: string, options: ShapeRenderOptions): ShapeDimensions {
-  const lines = splitLines(label)
-  const maxLineWidth = Math.max(...lines.map(l => visualWidth(l)), 0)
-  const lineCount = lines.length
-
-  // Width: 2*padding + maxLineWidth + 2 border chars
-  const innerWidth = 2 * options.padding + maxLineWidth
-  const width = innerWidth + 2
-
-  // Height: lineCount + 2*padding + 2 border chars
-  // Ensure innerHeight is odd for symmetric vertical centering
-  const rawInnerHeight = lineCount + 2 * options.padding
-  const innerHeight = rawInnerHeight % 2 === 0 ? rawInnerHeight + 1 : rawInnerHeight
-  const height = innerHeight + 2
-
-  return {
-    width,
-    height,
-    labelArea: {
-      x: 1 + options.padding,
-      y: 1 + options.padding,
-      width: maxLineWidth,
-      height: lineCount,
-    },
-    // Grid layout: [border=1, content, border=1]
-    gridColumns: [1, innerWidth, 1],
-    gridRows: [1, innerHeight, 1],
-  }
-}
-
-// ============================================================================
-// Shared box rendering
-// ============================================================================
-
-/**
- * Render a box with custom corner characters.
- * This is the core rendering function used by all rectangular shapes.
- *
- * @param label - Text to display in the box
- * @param dimensions - Pre-calculated dimensions
- * @param corners - Corner characters (tl, tr, bl, br)
- * @param useAscii - Whether to use ASCII or Unicode for lines
- */
-export function renderBox(
-  label: string,
-  dimensions: ShapeDimensions,
-  corners: CornerChars,
-  useAscii: boolean
-): Canvas {
-  const { width, height } = dimensions
-  const canvas = mkCanvas(width - 1, height - 1)
-
-  const from = { x: 0, y: 0 }
-  const to = { x: width - 1, y: height - 1 }
-
-  // Line characters
-  const hLine = useAscii ? '-' : '─'
-  const vLine = useAscii ? '|' : '│'
-
-  // Draw horizontal lines (top and bottom)
-  for (let x = from.x + 1; x < to.x; x++) {
-    canvas[x]![from.y] = hLine
-    canvas[x]![to.y] = hLine
-  }
-
-  // Draw vertical lines (left and right)
-  for (let y = from.y + 1; y < to.y; y++) {
-    canvas[from.x]![y] = vLine
-    canvas[to.x]![y] = vLine
-  }
-
-  // Draw corners
-  canvas[from.x]![from.y] = corners.tl
-  canvas[to.x]![from.y] = corners.tr
-  canvas[from.x]![to.y] = corners.bl
-  canvas[to.x]![to.y] = corners.br
-
-  // Center the multi-line label
-  const lines = splitLines(label)
-  const w = width - 1  // Match original grid-based width calculation
-  const h = height - 1
-  const centerY = Math.floor(h / 2)
-  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(w / 2) - Math.ceil(visualWidth(line) / 2) + 1
-    drawText(canvas, { x: textX, y: startY + i }, line, true)
-  }
-
-  return canvas
-}
-
-// ============================================================================
-// Shared attachment point calculation
-// ============================================================================
-
-/**
- * Calculate edge attachment point for rectangular shapes.
- * All box-based shapes use the same attachment logic.
- */
-export function getBoxAttachmentPoint(
-  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 }
-  if (dirEquals(dir, UpperLeft)) return { x: baseCoord.x, y: baseCoord.y }
-  if (dirEquals(dir, UpperRight)) return { x: baseCoord.x + width - 1, y: baseCoord.y }
-  if (dirEquals(dir, LowerLeft)) return { x: baseCoord.x, y: baseCoord.y + height - 1 }
-  if (dirEquals(dir, LowerRight)) return { x: baseCoord.x + width - 1, y: baseCoord.y + height - 1 }
-  // Middle
-  return { x: centerX, y: centerY }
-}
-
-// ============================================================================
-// Rectangle renderer
-// ============================================================================
-
-/**
- * Rectangle shape renderer — the default box shape.
- * Renders as:
- *   ┌─────────┐
- *   │  Label  │
- *   └─────────┘
- */
-export const rectangleRenderer: ShapeRenderer = {
-  getDimensions: getBoxDimensions,
-
-  render(label: string, dimensions: ShapeDimensions, options: ShapeRenderOptions): Canvas {
-    const corners = getCorners('rectangle', options.useAscii)
-    return renderBox(label, dimensions, corners, options.useAscii)
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}

package/src/ascii/shapes/rounded.ts

@@ -1,27 +0,0 @@
-// ============================================================================
-// Rounded rectangle shape renderer — uses rounded corner decorators
-// ============================================================================
-
-import type { ShapeRenderer } from './types.ts'
-import { getBoxDimensions, renderBox, getBoxAttachmentPoint } from './rectangle.ts'
-import { getCorners } from './corners.ts'
-
-/**
- * Rounded rectangle shape renderer.
- * Uses rounded corner markers (╭╮╰╯) to indicate soft edges.
- *
- * Renders as:
- *   ╭─────────╮
- *   │  Label  │
- *   ╰─────────╯
- */
-export const roundedRenderer: ShapeRenderer = {
-  getDimensions: getBoxDimensions,
-
-  render(label, dimensions, options) {
-    const corners = getCorners('rounded', options.useAscii)
-    return renderBox(label, dimensions, corners, options.useAscii)
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}

package/src/ascii/shapes/special.ts

@@ -1,332 +0,0 @@
-// ============================================================================
-// Special shape renderers — subroutine, doublecircle, cylinder, etc.
-// ============================================================================
-//
-// Some shapes have unique internal structure (subroutine, cylinder) and keep
-// custom rendering. Others use the corner decorator pattern for simplicity.
-
-import type { Canvas, DrawingCoord, Direction } from '../types.ts'
-import { Up, Down, Left, Right } 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 { dirEquals } from '../edge-routing.ts'
-import { getBoxDimensions, renderBox, getBoxAttachmentPoint } from './rectangle.ts'
-import { getCorners } from './corners.ts'
-
-// ============================================================================
-// Subroutine — keeps custom double-border rendering
-// ============================================================================
-
-/**
- * Subroutine shape renderer — double-bordered rectangle.
- * Renders as:
- *   ┌┬─────────┬┐
- *   ││  Label  ││
- *   └┴─────────┴┘
- */
-export const subroutineRenderer: 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  // Double borders on each side
-    const innerHeight = lineCount + 2 * options.padding
-    const height = innerHeight + 2
-
-    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 hChar = options.useAscii ? '-' : '─'
-    const vChar = options.useAscii ? '|' : '│'
-
-    // Top border
-    canvas[0]![0] = options.useAscii ? '+' : '┌'
-    canvas[1]![0] = options.useAscii ? '+' : '┬'
-    for (let x = 2; x < width - 2; x++) canvas[x]![0] = hChar
-    canvas[width - 2]![0] = options.useAscii ? '+' : '┬'
-    canvas[width - 1]![0] = options.useAscii ? '+' : '┐'
-
-    // Sides with double border
-    for (let y = 1; y < height - 1; y++) {
-      canvas[0]![y] = vChar
-      canvas[1]![y] = vChar
-      canvas[width - 2]![y] = vChar
-      canvas[width - 1]![y] = vChar
-    }
-
-    // Bottom border
-    canvas[0]![height - 1] = options.useAscii ? '+' : '└'
-    canvas[1]![height - 1] = options.useAscii ? '+' : '┴'
-    for (let x = 2; x < width - 2; x++) canvas[x]![height - 1] = hChar
-    canvas[width - 2]![height - 1] = options.useAscii ? '+' : '┴'
-    canvas[width - 1]![height - 1] = options.useAscii ? '+' : '┘'
-
-    // Center the label
-    const lines = splitLines(label)
-    const centerY = Math.floor(height / 2)
-    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 > 1 && y > 0 && y < height - 1) {
-        drawText(canvas, { x: textX, y }, line, true)
-      }
-    }
-
-    return canvas
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}
-
-// ============================================================================
-// Double circle — uses corner decorators
-// ============================================================================
-
-/**
- * Double circle shape renderer.
- * Uses double circle markers (◎) at corners.
- *
- * Renders as:
- *   ◎─────────◎
- *   │  Label  │
- *   ◎─────────◎
- */
-export const doublecircleRenderer: ShapeRenderer = {
-  getDimensions: getBoxDimensions,
-
-  render(label, dimensions, options) {
-    const corners = getCorners('doublecircle', options.useAscii)
-    return renderBox(label, dimensions, corners, options.useAscii)
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}
-
-// ============================================================================
-// Cylinder — keeps custom rendering for database appearance
-// ============================================================================
-
-/**
- * Cylinder shape renderer — database symbol.
- * Renders as:
- *   ╭─────╮
- *   │─────│
- *   │ DB  │
- *   │─────│
- *   ╰─────╯
- */
-export const cylinderRenderer: 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 + 2
-    const innerHeight = lineCount + 2 * options.padding + 2  // Extra for curved top/bottom
-    const height = innerHeight + 2
-
-    return {
-      width,
-      height,
-      labelArea: {
-        x: 1 + options.padding,
-        y: 2 + options.padding,
-        width: maxLineWidth,
-        height: lineCount,
-      },
-      gridColumns: [1, innerWidth, 1],
-      gridRows: [2, innerHeight - 2, 2],
-    }
-  },
-
-  render(label: string, dimensions: ShapeDimensions, options: ShapeRenderOptions): Canvas {
-    const { width, height } = dimensions
-    const canvas = mkCanvas(width - 1, height - 1)
-
-    const hChar = options.useAscii ? '-' : '─'
-    const vChar = options.useAscii ? '|' : '│'
-
-    // Top ellipse
-    canvas[0]![0] = options.useAscii ? '.' : '╭'
-    for (let x = 1; x < width - 1; x++) canvas[x]![0] = hChar
-    canvas[width - 1]![0] = options.useAscii ? '.' : '╮'
-
-    // Second row - bottom of top ellipse
-    canvas[0]![1] = vChar
-    for (let x = 1; x < width - 1; x++) canvas[x]![1] = hChar
-    canvas[width - 1]![1] = vChar
-
-    // Middle section
-    for (let y = 2; y < height - 2; y++) {
-      canvas[0]![y] = vChar
-      canvas[width - 1]![y] = vChar
-    }
-
-    // Second to last row - top of bottom ellipse
-    canvas[0]![height - 2] = vChar
-    for (let x = 1; x < width - 1; x++) canvas[x]![height - 2] = hChar
-    canvas[width - 1]![height - 2] = vChar
-
-    // Bottom ellipse
-    canvas[0]![height - 1] = options.useAscii ? '\'' : '╰'
-    for (let x = 1; x < width - 1; x++) canvas[x]![height - 1] = hChar
-    canvas[width - 1]![height - 1] = options.useAscii ? '\'' : '╯'
-
-    // Center the label
-    const lines = splitLines(label)
-    const centerY = Math.floor(height / 2)
-    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 > 1 && y < height - 2) {
-        drawText(canvas, { x: textX, y }, line, true)
-      }
-    }
-
-    return canvas
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}
-
-// ============================================================================
-// Asymmetric (flag) — uses corner decorators
-// ============================================================================
-
-/**
- * Asymmetric (flag/banner) shape renderer.
- * Uses arrow markers (▷) on left corners.
- *
- * Renders as:
- *   ▷─────────┐
- *   │  Label  │
- *   ▷─────────┘
- */
-export const asymmetricRenderer: ShapeRenderer = {
-  getDimensions: getBoxDimensions,
-
-  render(label, dimensions, options) {
-    const corners = getCorners('asymmetric', options.useAscii)
-    return renderBox(label, dimensions, corners, options.useAscii)
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}
-
-// ============================================================================
-// Trapezoid — uses corner decorators instead of diagonal sides
-// ============================================================================
-
-/**
- * Trapezoid shape renderer — wider at bottom.
- * Uses slope markers (◸◹) on top corners.
- *
- * Renders as:
- *   ◸─────────◹
- *   │  Label  │
- *   └─────────┘
- */
-export const trapezoidRenderer: ShapeRenderer = {
-  getDimensions: getBoxDimensions,
-
-  render(label, dimensions, options) {
-    const corners = getCorners('trapezoid', options.useAscii)
-    return renderBox(label, dimensions, corners, options.useAscii)
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}
-
-// ============================================================================
-// Trapezoid-alt — uses corner decorators instead of diagonal sides
-// ============================================================================
-
-/**
- * Trapezoid-alt shape renderer — wider at top.
- * Uses slope markers (◺◿) on bottom corners.
- *
- * Renders as:
- *   ┌─────────┐
- *   │  Label  │
- *   ◺─────────◿
- */
-export const trapezoidAltRenderer: ShapeRenderer = {
-  getDimensions: getBoxDimensions,
-
-  render(label, dimensions, options) {
-    const corners = getCorners('trapezoid-alt', options.useAscii)
-    return renderBox(label, dimensions, corners, options.useAscii)
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}
-
-// ============================================================================
-// Parallelograms — use corner decorators instead of diagonal sides
-// ============================================================================
-
-/**
- * Lean-right parallelogram shape renderer — the flowchart I/O symbol.
- * Uses '/' markers on the slanted corners.
- *
- * Renders as:
- *   /─────────/
- *   │  Label  │
- *   /─────────/
- */
-export const leanRRenderer: ShapeRenderer = {
-  getDimensions: getBoxDimensions,
-
-  render(label, dimensions, options) {
-    const corners = getCorners('lean-r', options.useAscii)
-    return renderBox(label, dimensions, corners, options.useAscii)
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}
-
-/**
- * Lean-left parallelogram shape renderer.
- * Uses '\' markers on the slanted corners.
- *
- * Renders as:
- *   \─────────\
- *   │  Label  │
- *   \─────────\
- */
-export const leanLRenderer: ShapeRenderer = {
-  getDimensions: getBoxDimensions,
-
-  render(label, dimensions, options) {
-    const corners = getCorners('lean-l', options.useAscii)
-    return renderBox(label, dimensions, corners, options.useAscii)
-  },
-
-  getAttachmentPoint: getBoxAttachmentPoint,
-}