@oh-my-pi/pi-utils 16.0.7 → 16.0.9

package/src/vendor/mermaid-ascii/ascii/shapes/index.ts

@@ -0,0 +1,101 @@
+// ============================================================================
+// Shape registry — pluggable ASCII shape renderers
+// ============================================================================
+
+import type { AsciiNodeShape, Canvas, DrawingCoord, Direction } from '../types'
+import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions, ShapeRegistry } from './types'
+
+// Import all shape renderers
+import { rectangleRenderer } from './rectangle'
+import { diamondRenderer } from './diamond'
+import { circleRenderer } from './circle'
+import { stateStartRenderer, stateEndRenderer } from './state'
+import { roundedRenderer } from './rounded'
+import { stadiumRenderer } from './stadium'
+import { hexagonRenderer } from './hexagon'
+import {
+  subroutineRenderer,
+  doublecircleRenderer,
+  cylinderRenderer,
+  asymmetricRenderer,
+  trapezoidRenderer,
+  trapezoidAltRenderer,
+} from './special'
+
+// 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],
+  ['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],
+
+  // 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/vendor/mermaid-ascii/ascii/shapes/rectangle.ts

@@ -0,0 +1,175 @@
+// ============================================================================
+// 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'
+import { Up, Down, Left, Right, UpperLeft, UpperRight, LowerLeft, LowerRight, Middle } from '../types'
+import { mkCanvas } from '../canvas'
+import { splitLines } from '../multiline-utils'
+import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions } from './types'
+import { dirEquals } from '../edge-routing'
+import { type CornerChars, getCorners } from './corners'
+import { displayWidth, toCells } from '../../text-metrics'
+
+// ============================================================================
+// 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 => displayWidth(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 cells = toCells(line)
+    const textX = Math.floor(w / 2) - Math.ceil(cells.length / 2) + 1
+    for (let j = 0; j < cells.length; j++) {
+      const x = textX + j
+      const y = startY + i
+      if (x >= 0 && x < canvas.length && y >= 0 && y < canvas[0]!.length) {
+        canvas[x]![y] = cells[j]!
+      }
+    }
+  }
+
+  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/vendor/mermaid-ascii/ascii/shapes/rounded.ts

@@ -0,0 +1,27 @@
+// ============================================================================
+// Rounded rectangle shape renderer — uses rounded corner decorators
+// ============================================================================
+
+import type { ShapeRenderer } from './types'
+import { getBoxDimensions, renderBox, getBoxAttachmentPoint } from './rectangle'
+import { getCorners } from './corners'
+
+/**
+ * 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/vendor/mermaid-ascii/ascii/shapes/special.ts

@@ -0,0 +1,296 @@
+// ============================================================================
+// 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'
+import { Up, Down, Left, Right } from '../types'
+import { mkCanvas } from '../canvas'
+import { splitLines } from '../multiline-utils'
+import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions } from './types'
+import { dirEquals } from '../edge-routing'
+import { getBoxDimensions, renderBox, getBoxAttachmentPoint } from './rectangle'
+import { getCorners } from './corners'
+import { displayWidth, toCells } from '../../text-metrics'
+
+// ============================================================================
+// 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 => displayWidth(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 cells = toCells(line)
+      const textX = Math.floor(width / 2) - Math.floor(cells.length / 2)
+      for (let j = 0; j < cells.length; j++) {
+        const x = textX + j
+        const y = startY + i
+        if (x > 1 && x < width - 2 && y > 0 && y < height - 1) {
+          canvas[x]![y] = cells[j]!
+        }
+      }
+    }
+
+    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 => displayWidth(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 cells = toCells(line)
+      const textX = Math.floor(width / 2) - Math.floor(cells.length / 2)
+      for (let j = 0; j < cells.length; j++) {
+        const x = textX + j
+        const y = startY + i
+        if (x > 0 && x < width - 1 && y > 1 && y < height - 2) {
+          canvas[x]![y] = cells[j]!
+        }
+      }
+    }
+
+    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,
+}