agentic-mermaid 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (333) hide show
  1. package/CHANGELOG.md +149 -4
  2. package/LICENSES/Apache-2.0.txt +202 -0
  3. package/README.md +25 -32
  4. package/THIRD_PARTY_NOTICES.md +29 -0
  5. package/assets/fonts/FONT-LICENSES.md +9 -5
  6. package/assets/fonts/Inter-Bold.ttf +0 -0
  7. package/assets/fonts/Inter-Medium.ttf +0 -0
  8. package/assets/fonts/Inter-Regular.ttf +0 -0
  9. package/assets/fonts/Inter-SemiBold.ttf +0 -0
  10. package/dist/agent-core.d.ts +463 -0
  11. package/dist/agent-core.js +397 -0
  12. package/dist/agent.d.ts +81 -1822
  13. package/dist/agent.js +336 -36839
  14. package/dist/agentic-mermaid-mcp.js +7 -37908
  15. package/dist/am.js +33638 -36261
  16. package/dist/chunk-4QECACIA.js +4702 -0
  17. package/dist/chunk-CDPKJ2BQ.js +37 -0
  18. package/dist/chunk-QKDLMOJJ.js +3487 -0
  19. package/dist/chunk-WI35L7IR.js +615 -0
  20. package/dist/chunk-WN3YDOBG.js +149 -0
  21. package/dist/chunk-ZYMMKQ3I.js +62637 -0
  22. package/dist/index-D54dqSdC.d.ts +6777 -0
  23. package/dist/index.d.ts +1 -1
  24. package/dist/index.js +310 -32836
  25. package/dist/mcp-cli-SBQSTJFC.js +17 -0
  26. package/docs/README.md +14 -6
  27. package/docs/schemas/style-spec.schema.json +1221 -30
  28. package/examples/styles/catalog.json +54 -0
  29. package/examples/styles/cloudflare-workers-inspired-prototype.mmd +9 -0
  30. package/examples/styles/cloudflare-workers-inspired-prototype.style.json +110 -0
  31. package/examples/styles/cupertino-prototype.mmd +10 -0
  32. package/examples/styles/cupertino-prototype.style.json +63 -0
  33. package/examples/styles/mid-century-report.style.json +2 -2
  34. package/examples/styles/star-chart-atlas.style.json +2 -1
  35. package/examples/styles/transit-route-map.style.json +2 -2
  36. package/examples/styles/vercel-inspired-prototype.mmd +6 -0
  37. package/examples/styles/vercel-inspired-prototype.style.json +87 -0
  38. package/package.json +70 -43
  39. package/server.json +41 -0
  40. package/skills/agentic-mermaid-diagram-workflow/SKILL.md +17 -36
  41. package/skills/agentic-mermaid-diagram-workflow/references/cli.md +4 -5
  42. package/skills/agentic-mermaid-diagram-workflow/references/code-mode.md +15 -31
  43. package/skills/agentic-mermaid-diagram-workflow/references/sequence.md +10 -14
  44. package/skills/agentic-mermaid-live-editor/SKILL.md +100 -206
  45. package/AGENT_NATIVE.md +0 -602
  46. package/Instructions_for_agents.md +0 -83
  47. package/TODO.md +0 -662
  48. package/assets/hero.png +0 -0
  49. package/dist/index-x2Cj1dVv.d.ts +0 -1089
  50. package/docs/agent-api-cookbook.md +0 -308
  51. package/docs/agent-mutation-policy.md +0 -104
  52. package/docs/agent-workflow-examples.md +0 -46
  53. package/docs/api.md +0 -203
  54. package/docs/ascii.md +0 -103
  55. package/docs/assets/improvements/box-start-connector.png +0 -0
  56. package/docs/assets/improvements/comment-dropped-lint.png +0 -0
  57. package/docs/assets/improvements/er-content-loss.png +0 -0
  58. package/docs/assets/improvements/fan-in-trunks.png +0 -0
  59. package/docs/assets/improvements/gantt-family.png +0 -0
  60. package/docs/assets/improvements/gantt-milestone-clamp.png +0 -0
  61. package/docs/assets/improvements/gantt-verify-seam.png +0 -0
  62. package/docs/assets/improvements/subgraph-container-edges.png +0 -0
  63. package/docs/assets/improvements/wrapper-frontmatter.png +0 -0
  64. package/docs/assets/improvements/wrapper-init-directive.png +0 -0
  65. package/docs/assets/improvements/wrapper-leading-comment.png +0 -0
  66. package/docs/assets/style-cookbook/mid-century-report.png +0 -0
  67. package/docs/assets/style-cookbook/star-chart-atlas.png +0 -0
  68. package/docs/assets/style-cookbook/transit-route-map.png +0 -0
  69. package/docs/comparison.md +0 -94
  70. package/docs/config.md +0 -105
  71. package/docs/contributing/adding-diagram-types.md +0 -144
  72. package/docs/contributing/diagram-family-citizenship.matrix.json +0 -2127
  73. package/docs/contributing/diagram-family-citizenship.md +0 -82
  74. package/docs/contributing/harvesting-upstream-tests.md +0 -126
  75. package/docs/contributing/lessons-learned.md +0 -276
  76. package/docs/contributing/releasing.md +0 -71
  77. package/docs/contributing/visual-review-evidence.md +0 -53
  78. package/docs/custom-style-cookbook.md +0 -154
  79. package/docs/design/families/README.md +0 -26
  80. package/docs/design/families/architecture-beta.md +0 -48
  81. package/docs/design/families/flowchart-parser-conformance.md +0 -22
  82. package/docs/design/families/gantt-research.md +0 -137
  83. package/docs/design/families/gantt.md +0 -329
  84. package/docs/design/families/journey-agentic-cards-before.png +0 -0
  85. package/docs/design/families/journey-mermaid-classic-implementation.png +0 -0
  86. package/docs/design/families/journey-mermaid-classic-prototype.png +0 -0
  87. package/docs/design/families/journey-mermaid-classic-prototype.svg +0 -163
  88. package/docs/design/families/journey-mermaid-classic-prototype.svg.png +0 -0
  89. package/docs/design/families/journey-migration-parity.md +0 -433
  90. package/docs/design/families/journey-usage-research.md +0 -423
  91. package/docs/design/families/journey.md +0 -125
  92. package/docs/design/families/xychart.md +0 -85
  93. package/docs/design/system/README.md +0 -45
  94. package/docs/design/system/abstraction-audit.md +0 -224
  95. package/docs/design/system/abstraction-recommendations.md +0 -655
  96. package/docs/design/system/architecture.mmd +0 -29
  97. package/docs/design/system/architecture.svg +0 -137
  98. package/docs/design/system/layout-guarantees-and-robustness.md +0 -351
  99. package/docs/design/system/layout-rubric.md +0 -138
  100. package/docs/design/system/route-contracts.md +0 -848
  101. package/docs/design/system/source-preservation-ladder.md +0 -52
  102. package/docs/design/system/styles-rollout.md +0 -216
  103. package/docs/design/system/ugly-layouts.md +0 -119
  104. package/docs/diagram-families.md +0 -193
  105. package/docs/features.md +0 -147
  106. package/docs/fork-differences.md +0 -130
  107. package/docs/getting-started.md +0 -175
  108. package/docs/issue-derived-test-cases.md +0 -156
  109. package/docs/layout-characterization/README.md +0 -245
  110. package/docs/layout-characterization/contact-sheet-families.md +0 -496
  111. package/docs/layout-characterization/contact-sheet.md +0 -638
  112. package/docs/layout-characterization/properties.md +0 -281
  113. package/docs/layout-characterization/visual-quality.md +0 -160
  114. package/docs/layout-characterization/visual-snapshots/architecture.svg +0 -79
  115. package/docs/layout-characterization/visual-snapshots/class.svg +0 -60
  116. package/docs/layout-characterization/visual-snapshots/er.svg +0 -61
  117. package/docs/layout-characterization/visual-snapshots/flowchart.svg +0 -58
  118. package/docs/layout-characterization/visual-snapshots/gantt.svg +0 -52
  119. package/docs/layout-characterization/visual-snapshots/journey.svg +0 -118
  120. package/docs/layout-characterization/visual-snapshots/pie.svg +0 -36
  121. package/docs/layout-characterization/visual-snapshots/quadrant.svg +0 -47
  122. package/docs/layout-characterization/visual-snapshots/sequence.svg +0 -59
  123. package/docs/layout-characterization/visual-snapshots/state.svg +0 -52
  124. package/docs/layout-characterization/visual-snapshots/timeline.svg +0 -64
  125. package/docs/layout-characterization/visual-snapshots/xychart.svg +0 -97
  126. package/docs/mcp-code-mode-rationale.md +0 -101
  127. package/docs/mcp-http-transport.md +0 -223
  128. package/docs/mermaid-layout-complaints.md +0 -837
  129. package/docs/mutation-testing.md +0 -206
  130. package/docs/project/divergences.md +0 -98
  131. package/docs/project/dogfooding-docs-strategy.md +0 -66
  132. package/docs/project/hosted-mcp-cloudflare-plan.md +0 -338
  133. package/docs/project/lessons-learned.md +0 -1019
  134. package/docs/project/remove-role-styling-plan.md +0 -176
  135. package/docs/quality.md +0 -212
  136. package/docs/react.md +0 -97
  137. package/docs/style-authoring.md +0 -133
  138. package/docs/testing-strategy.md +0 -335
  139. package/docs/theming.md +0 -162
  140. package/examples/agent-improve-auth-flow.ts +0 -206
  141. package/examples/agent-loop.ts +0 -53
  142. package/examples/mcp-vs-cli-complex-diagrams.ts +0 -133
  143. package/llms.txt +0 -104
  144. package/skill-evals/README.md +0 -77
  145. package/skill-evals/fixtures/architecture-cache/input.mmd +0 -5
  146. package/skill-evals/fixtures/class-payment/input.mmd +0 -4
  147. package/skill-evals/fixtures/er-orders/input.mmd +0 -10
  148. package/skill-evals/fixtures/flowchart-cache/input.mmd +0 -3
  149. package/skill-evals/fixtures/gantt-release/input.mmd +0 -7
  150. package/skill-evals/fixtures/journey-checkout/input.mmd +0 -6
  151. package/skill-evals/fixtures/pie-exports/input.mmd +0 -5
  152. package/skill-evals/fixtures/quadrant-priorities/input.mmd +0 -11
  153. package/skill-evals/fixtures/sequence-retry/input.mmd +0 -8
  154. package/skill-evals/fixtures/state-lifecycle/input.mmd +0 -5
  155. package/skill-evals/fixtures/timeline-release/input.mmd +0 -6
  156. package/skill-evals/fixtures/xychart-growth/input.mmd +0 -5
  157. package/skill-evals/shared-benchmark.json +0 -510
  158. package/src/agent/analyze.ts +0 -157
  159. package/src/agent/apply.ts +0 -146
  160. package/src/agent/architecture-body.ts +0 -458
  161. package/src/agent/certificates.ts +0 -110
  162. package/src/agent/class-body.ts +0 -319
  163. package/src/agent/core.ts +0 -207
  164. package/src/agent/create.ts +0 -106
  165. package/src/agent/describe.ts +0 -364
  166. package/src/agent/er-body.ts +0 -224
  167. package/src/agent/facts.ts +0 -337
  168. package/src/agent/families-builtin.ts +0 -934
  169. package/src/agent/families.ts +0 -232
  170. package/src/agent/family-layouts.ts +0 -826
  171. package/src/agent/flowchart-body.ts +0 -372
  172. package/src/agent/flowchart-unsupported.ts +0 -243
  173. package/src/agent/gantt-body.ts +0 -495
  174. package/src/agent/index.ts +0 -10
  175. package/src/agent/journey-body.ts +0 -414
  176. package/src/agent/label-metrics.ts +0 -28
  177. package/src/agent/layout-to-rendered.ts +0 -63
  178. package/src/agent/mutate.ts +0 -97
  179. package/src/agent/mutation-ops.ts +0 -51
  180. package/src/agent/op-schema.ts +0 -439
  181. package/src/agent/parse.ts +0 -223
  182. package/src/agent/pie-body.ts +0 -270
  183. package/src/agent/png.ts +0 -117
  184. package/src/agent/quadrant-body.ts +0 -336
  185. package/src/agent/quality.ts +0 -363
  186. package/src/agent/readability-audit.ts +0 -92
  187. package/src/agent/rendered-route-audit.ts +0 -61
  188. package/src/agent/sequence-body.ts +0 -345
  189. package/src/agent/serialize.ts +0 -214
  190. package/src/agent/state-body.ts +0 -589
  191. package/src/agent/structural-count.ts +0 -150
  192. package/src/agent/timeline-body.ts +0 -280
  193. package/src/agent/trace-log.ts +0 -43
  194. package/src/agent/types.ts +0 -979
  195. package/src/agent/verify.ts +0 -571
  196. package/src/agent/xychart-body.ts +0 -472
  197. package/src/architecture/config.ts +0 -282
  198. package/src/architecture/layout.ts +0 -496
  199. package/src/architecture/parser.ts +0 -375
  200. package/src/architecture/renderer.ts +0 -611
  201. package/src/architecture/types.ts +0 -113
  202. package/src/ascii/ansi.ts +0 -423
  203. package/src/ascii/architecture.ts +0 -210
  204. package/src/ascii/canvas.ts +0 -443
  205. package/src/ascii/class-diagram.ts +0 -697
  206. package/src/ascii/converter.ts +0 -475
  207. package/src/ascii/draw.ts +0 -1693
  208. package/src/ascii/edge-bundling.ts +0 -328
  209. package/src/ascii/edge-routing.ts +0 -330
  210. package/src/ascii/er-diagram.ts +0 -439
  211. package/src/ascii/gantt.ts +0 -276
  212. package/src/ascii/grid.ts +0 -747
  213. package/src/ascii/index.ts +0 -196
  214. package/src/ascii/journey.ts +0 -189
  215. package/src/ascii/meta.ts +0 -244
  216. package/src/ascii/multiline-utils.ts +0 -80
  217. package/src/ascii/pathfinder.ts +0 -301
  218. package/src/ascii/pie.ts +0 -67
  219. package/src/ascii/quadrant.ts +0 -158
  220. package/src/ascii/reverse.ts +0 -216
  221. package/src/ascii/sequence.ts +0 -499
  222. package/src/ascii/shapes/circle.ts +0 -27
  223. package/src/ascii/shapes/corners.ts +0 -143
  224. package/src/ascii/shapes/diamond.ts +0 -27
  225. package/src/ascii/shapes/hexagon.ts +0 -27
  226. package/src/ascii/shapes/index.ts +0 -106
  227. package/src/ascii/shapes/rectangle.ts +0 -168
  228. package/src/ascii/shapes/rounded.ts +0 -27
  229. package/src/ascii/shapes/special.ts +0 -332
  230. package/src/ascii/shapes/stadium.ts +0 -110
  231. package/src/ascii/shapes/state.ts +0 -192
  232. package/src/ascii/shapes/types.ts +0 -73
  233. package/src/ascii/timeline.ts +0 -128
  234. package/src/ascii/types.ts +0 -312
  235. package/src/ascii/validate.ts +0 -120
  236. package/src/ascii/width.ts +0 -81
  237. package/src/ascii/xychart.ts +0 -919
  238. package/src/browser.ts +0 -29
  239. package/src/class/layout.ts +0 -240
  240. package/src/class/parser.ts +0 -332
  241. package/src/class/renderer.ts +0 -638
  242. package/src/class/types.ts +0 -129
  243. package/src/cli/agent-instructions.ts +0 -1
  244. package/src/cli/am-bin.ts +0 -6
  245. package/src/cli/exit-codes.ts +0 -18
  246. package/src/cli/index.ts +0 -1117
  247. package/src/cli/init-agent.ts +0 -147
  248. package/src/color-resolver.ts +0 -152
  249. package/src/elk-instance.ts +0 -114
  250. package/src/er/layout.ts +0 -187
  251. package/src/er/parser.ts +0 -226
  252. package/src/er/renderer.ts +0 -792
  253. package/src/er/types.ts +0 -99
  254. package/src/font-manifest.ts +0 -27
  255. package/src/gantt/layout.ts +0 -365
  256. package/src/gantt/parser.ts +0 -282
  257. package/src/gantt/pipeline.ts +0 -27
  258. package/src/gantt/renderer.ts +0 -414
  259. package/src/gantt/schedule.ts +0 -513
  260. package/src/gantt/types.ts +0 -255
  261. package/src/index.ts +0 -368
  262. package/src/journey/layout.ts +0 -520
  263. package/src/journey/parser.ts +0 -218
  264. package/src/journey/renderer.ts +0 -811
  265. package/src/journey/types.ts +0 -144
  266. package/src/layout/geometry.ts +0 -182
  267. package/src/layout/pass.ts +0 -142
  268. package/src/layout/passes/index.ts +0 -3916
  269. package/src/layout-engine.ts +0 -1565
  270. package/src/layout-rubric.ts +0 -659
  271. package/src/mcp/artifacts.ts +0 -137
  272. package/src/mcp/dynamic-harness.ts +0 -31
  273. package/src/mcp/dynamic-modules.d.ts +0 -7
  274. package/src/mcp/facade.ts +0 -608
  275. package/src/mcp/harness-runtime.ts +0 -203
  276. package/src/mcp/hosted-server.ts +0 -468
  277. package/src/mcp/mcp-bin.ts +0 -3
  278. package/src/mcp/mcp-cli.ts +0 -82
  279. package/src/mcp/protocol.ts +0 -13
  280. package/src/mcp/sandbox.ts +0 -195
  281. package/src/mcp/sdk-decl.ts +0 -387
  282. package/src/mcp/server.ts +0 -362
  283. package/src/mcp/tool-surface.ts +0 -146
  284. package/src/mermaid-source.ts +0 -655
  285. package/src/multiline-utils.ts +0 -228
  286. package/src/parser.ts +0 -1031
  287. package/src/pie/layout.ts +0 -168
  288. package/src/pie/parser.ts +0 -136
  289. package/src/pie/renderer.ts +0 -234
  290. package/src/pie/types.ts +0 -82
  291. package/src/quadrant/layout.ts +0 -191
  292. package/src/quadrant/parser.ts +0 -183
  293. package/src/quadrant/renderer.ts +0 -322
  294. package/src/quadrant/types.ts +0 -113
  295. package/src/render-family-hooks.ts +0 -244
  296. package/src/renderer.ts +0 -1099
  297. package/src/route-contracts.ts +0 -2723
  298. package/src/scene/backend.ts +0 -76
  299. package/src/scene/fidelity.ts +0 -183
  300. package/src/scene/hybrid-backend.ts +0 -174
  301. package/src/scene/ir.ts +0 -181
  302. package/src/scene/marks.ts +0 -127
  303. package/src/scene/rough-backend.ts +0 -378
  304. package/src/scene/seed.ts +0 -46
  305. package/src/scene/style-registry.ts +0 -556
  306. package/src/sequence/layout.ts +0 -456
  307. package/src/sequence/parser.ts +0 -255
  308. package/src/sequence/renderer.ts +0 -604
  309. package/src/sequence/types.ts +0 -154
  310. package/src/shape-clipping.ts +0 -351
  311. package/src/shared/accessibility-directives.ts +0 -22
  312. package/src/shared/batched.ts +0 -61
  313. package/src/shared/color-math.ts +0 -72
  314. package/src/shared/svg-a11y.ts +0 -29
  315. package/src/shared/syntax-error.ts +0 -17
  316. package/src/shared/unicode-ranges.ts +0 -135
  317. package/src/styles.ts +0 -318
  318. package/src/svg-paths.ts +0 -28
  319. package/src/text-metrics.ts +0 -248
  320. package/src/theme.ts +0 -639
  321. package/src/timeline/layout.ts +0 -381
  322. package/src/timeline/parser.ts +0 -215
  323. package/src/timeline/renderer.ts +0 -538
  324. package/src/timeline/types.ts +0 -105
  325. package/src/types.ts +0 -454
  326. package/src/website-worker-modules.d.ts +0 -18
  327. package/src/xychart/axis-utils.ts +0 -109
  328. package/src/xychart/colors.ts +0 -124
  329. package/src/xychart/config.ts +0 -88
  330. package/src/xychart/layout.ts +0 -656
  331. package/src/xychart/parser.ts +0 -504
  332. package/src/xychart/renderer.ts +0 -640
  333. package/src/xychart/types.ts +0 -282
@@ -1,110 +0,0 @@
1
- // ============================================================================
2
- // Stadium (pill) shape renderer — special parentheses-based rendering
3
- // ============================================================================
4
- //
5
- // Stadium has unique rendering: single-line is inline `(Label)`, multi-line
6
- // uses parentheses or rounded corners. This differs from other shapes that
7
- // use corner decorators with box lines.
8
-
9
- import type { Canvas, DrawingCoord, Direction } from '../types.ts'
10
- import { drawText, mkCanvas } from '../canvas.ts'
11
- import { splitLines } from '../multiline-utils.ts'
12
- import { visualWidth } from '../width.ts'
13
- import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions } from './types.ts'
14
- import { getBoxAttachmentPoint } from './rectangle.ts'
15
-
16
- /**
17
- * Stadium (pill) shape renderer.
18
- *
19
- * Single-line: ( Label )
20
- *
21
- * Multi-line unicode:
22
- * ╭──────────╮
23
- * │ Label │
24
- * ╰──────────╯
25
- *
26
- * Multi-line ASCII:
27
- * (----------)
28
- * ( Label )
29
- * (----------)
30
- */
31
- export const stadiumRenderer: ShapeRenderer = {
32
- getDimensions(label: string, options: ShapeRenderOptions): ShapeDimensions {
33
- const lines = splitLines(label)
34
- const maxLineWidth = Math.max(...lines.map(l => visualWidth(l)), 0)
35
- const lineCount = lines.length
36
-
37
- const innerWidth = 2 * options.padding + maxLineWidth
38
- const width = innerWidth + 4 // Extra for rounded ends
39
- const innerHeight = lineCount + 2 * options.padding
40
- const height = Math.max(innerHeight + 2, 3)
41
-
42
- return {
43
- width,
44
- height,
45
- labelArea: {
46
- x: 2 + options.padding,
47
- y: 1 + options.padding,
48
- width: maxLineWidth,
49
- height: lineCount,
50
- },
51
- gridColumns: [2, innerWidth, 2],
52
- gridRows: [1, innerHeight, 1],
53
- }
54
- },
55
-
56
- render(label: string, dimensions: ShapeDimensions, options: ShapeRenderOptions): Canvas {
57
- const { width, height } = dimensions
58
- const canvas = mkCanvas(width - 1, height - 1)
59
-
60
- const centerY = Math.floor(height / 2)
61
- const hChar = options.useAscii ? '-' : '─'
62
-
63
- if (height === 3) {
64
- // Single row pill: ( Label )
65
- canvas[0]![centerY] = '('
66
- canvas[width - 1]![centerY] = ')'
67
- } else if (!options.useAscii) {
68
- // Multi-row stadium with rounded corners (unicode)
69
- canvas[0]![0] = '╭'
70
- for (let x = 1; x < width - 1; x++) canvas[x]![0] = hChar
71
- canvas[width - 1]![0] = '╮'
72
-
73
- for (let y = 1; y < height - 1; y++) {
74
- canvas[0]![y] = '│'
75
- canvas[width - 1]![y] = '│'
76
- }
77
-
78
- canvas[0]![height - 1] = '╰'
79
- for (let x = 1; x < width - 1; x++) canvas[x]![height - 1] = hChar
80
- canvas[width - 1]![height - 1] = '╯'
81
- } else {
82
- // Multi-row stadium ASCII — parentheses on all sides
83
- for (let y = 0; y < height; y++) {
84
- canvas[0]![y] = '('
85
- canvas[width - 1]![y] = ')'
86
- }
87
- for (let x = 1; x < width - 1; x++) {
88
- canvas[x]![0] = hChar
89
- canvas[x]![height - 1] = hChar
90
- }
91
- }
92
-
93
- // Center the label
94
- const lines = splitLines(label)
95
- const startY = centerY - Math.floor((lines.length - 1) / 2)
96
-
97
- for (let i = 0; i < lines.length; i++) {
98
- const line = lines[i]!
99
- const textX = Math.floor(width / 2) - Math.floor(visualWidth(line) / 2)
100
- const y = startY + i
101
- if (textX > 0 && y >= 0 && y < height) {
102
- drawText(canvas, { x: textX, y }, line, true)
103
- }
104
- }
105
-
106
- return canvas
107
- },
108
-
109
- getAttachmentPoint: getBoxAttachmentPoint,
110
- }
@@ -1,192 +0,0 @@
1
- // ============================================================================
2
- // State pseudo-state renderers — UML start and end states
3
- // ============================================================================
4
-
5
- import type { Canvas, DrawingCoord, Direction } from '../types.ts'
6
- import { Up, Down, Left, Right, UpperLeft, UpperRight, LowerLeft, LowerRight } from '../types.ts'
7
- import { mkCanvas } from '../canvas.ts'
8
- import type { ShapeRenderer, ShapeDimensions, ShapeRenderOptions } from './types.ts'
9
- import { dirEquals } from '../edge-routing.ts'
10
-
11
- /**
12
- * State start pseudo-state renderer — filled circle in rounded box.
13
- * Renders as:
14
- * ╭───╮
15
- * │ ● │ (Unicode)
16
- * ╰───╯
17
- *
18
- * .---.
19
- * | * | (ASCII)
20
- * '---'
21
- *
22
- * This represents the UML initial pseudo-state.
23
- */
24
- export const stateStartRenderer: ShapeRenderer = {
25
- getDimensions(_label: string, _options: ShapeRenderOptions): ShapeDimensions {
26
- // Start state is a 5x3 rounded box with centered symbol
27
- const width = 5
28
- const height = 3
29
-
30
- return {
31
- width,
32
- height,
33
- labelArea: { x: 2, y: 1, width: 1, height: 1 },
34
- gridColumns: [1, 3, 1],
35
- gridRows: [1, 1, 1],
36
- }
37
- },
38
-
39
- render(_label: string, dimensions: ShapeDimensions, options: ShapeRenderOptions): Canvas {
40
- const { width, height } = dimensions
41
- const canvas = mkCanvas(width - 1, height - 1)
42
-
43
- const centerX = Math.floor(width / 2) // = 2
44
-
45
- if (!options.useAscii) {
46
- // Unicode rounded box with filled circle: ╭───╮ │ ● │ ╰───╯
47
- canvas[0]![0] = '╭'
48
- canvas[1]![0] = '─'
49
- canvas[2]![0] = '─'
50
- canvas[3]![0] = '─'
51
- canvas[4]![0] = '╮'
52
-
53
- canvas[0]![1] = '│'
54
- canvas[centerX]![1] = '●'
55
- canvas[4]![1] = '│'
56
-
57
- canvas[0]![2] = '╰'
58
- canvas[1]![2] = '─'
59
- canvas[2]![2] = '─'
60
- canvas[3]![2] = '─'
61
- canvas[4]![2] = '╯'
62
- } else {
63
- // ASCII rounded box: .---. | * | '---'
64
- canvas[0]![0] = '.'
65
- canvas[1]![0] = '-'
66
- canvas[2]![0] = '-'
67
- canvas[3]![0] = '-'
68
- canvas[4]![0] = '.'
69
-
70
- canvas[0]![1] = '|'
71
- canvas[centerX]![1] = '*'
72
- canvas[4]![1] = '|'
73
-
74
- canvas[0]![2] = '\''
75
- canvas[1]![2] = '-'
76
- canvas[2]![2] = '-'
77
- canvas[3]![2] = '-'
78
- canvas[4]![2] = '\''
79
- }
80
-
81
- return canvas
82
- },
83
-
84
- getAttachmentPoint(
85
- dir: Direction,
86
- dimensions: ShapeDimensions,
87
- baseCoord: DrawingCoord
88
- ): DrawingCoord {
89
- const { width, height } = dimensions
90
- const centerX = baseCoord.x + Math.floor(width / 2)
91
- const centerY = baseCoord.y + Math.floor(height / 2)
92
-
93
- if (dirEquals(dir, Up)) return { x: centerX, y: baseCoord.y }
94
- if (dirEquals(dir, Down)) return { x: centerX, y: baseCoord.y + height - 1 }
95
- if (dirEquals(dir, Left)) return { x: baseCoord.x, y: centerY }
96
- if (dirEquals(dir, Right)) return { x: baseCoord.x + width - 1, y: centerY }
97
- // All diagonals and middle point to center
98
- return { x: centerX, y: centerY }
99
- },
100
- }
101
-
102
- /**
103
- * State end pseudo-state renderer — bullseye in double-bordered box.
104
- * Renders as:
105
- * ╔═══╗
106
- * ║ ◎ ║ (Unicode)
107
- * ╚═══╝
108
- *
109
- * #===#
110
- * # * # (ASCII)
111
- * #===#
112
- *
113
- * This represents the UML final state. The double border distinguishes it
114
- * from the start state's single rounded border.
115
- */
116
- export const stateEndRenderer: ShapeRenderer = {
117
- getDimensions(_label: string, _options: ShapeRenderOptions): ShapeDimensions {
118
- // End state is a 5x3 double-bordered box with centered symbol
119
- const width = 5
120
- const height = 3
121
-
122
- return {
123
- width,
124
- height,
125
- labelArea: { x: 2, y: 1, width: 1, height: 1 },
126
- gridColumns: [1, 3, 1],
127
- gridRows: [1, 1, 1],
128
- }
129
- },
130
-
131
- render(_label: string, dimensions: ShapeDimensions, options: ShapeRenderOptions): Canvas {
132
- const { width, height } = dimensions
133
- const canvas = mkCanvas(width - 1, height - 1)
134
-
135
- const centerX = Math.floor(width / 2) // = 2
136
-
137
- if (!options.useAscii) {
138
- // Unicode double-bordered box with bullseye: ╔═══╗ ║ ◎ ║ ╚═══╝
139
- canvas[0]![0] = '╔'
140
- canvas[1]![0] = '═'
141
- canvas[2]![0] = '═'
142
- canvas[3]![0] = '═'
143
- canvas[4]![0] = '╗'
144
-
145
- canvas[0]![1] = '║'
146
- canvas[centerX]![1] = '◎'
147
- canvas[4]![1] = '║'
148
-
149
- canvas[0]![2] = '╚'
150
- canvas[1]![2] = '═'
151
- canvas[2]![2] = '═'
152
- canvas[3]![2] = '═'
153
- canvas[4]![2] = '╝'
154
- } else {
155
- // ASCII double-bordered box: #===# # * # #===#
156
- canvas[0]![0] = '#'
157
- canvas[1]![0] = '='
158
- canvas[2]![0] = '='
159
- canvas[3]![0] = '='
160
- canvas[4]![0] = '#'
161
-
162
- canvas[0]![1] = '#'
163
- canvas[centerX]![1] = '*'
164
- canvas[4]![1] = '#'
165
-
166
- canvas[0]![2] = '#'
167
- canvas[1]![2] = '='
168
- canvas[2]![2] = '='
169
- canvas[3]![2] = '='
170
- canvas[4]![2] = '#'
171
- }
172
-
173
- return canvas
174
- },
175
-
176
- getAttachmentPoint(
177
- dir: Direction,
178
- dimensions: ShapeDimensions,
179
- baseCoord: DrawingCoord
180
- ): DrawingCoord {
181
- const { width, height } = dimensions
182
- const centerX = baseCoord.x + Math.floor(width / 2)
183
- const centerY = baseCoord.y + Math.floor(height / 2)
184
-
185
- if (dirEquals(dir, Up)) return { x: centerX, y: baseCoord.y }
186
- if (dirEquals(dir, Down)) return { x: centerX, y: baseCoord.y + height - 1 }
187
- if (dirEquals(dir, Left)) return { x: baseCoord.x, y: centerY }
188
- if (dirEquals(dir, Right)) return { x: baseCoord.x + width - 1, y: centerY }
189
- // All diagonals and middle point to center
190
- return { x: centerX, y: centerY }
191
- },
192
- }
@@ -1,73 +0,0 @@
1
- // ============================================================================
2
- // Shape renderer types — interface for pluggable ASCII shape renderers
3
- // ============================================================================
4
-
5
- import type { Canvas, DrawingCoord, Direction, AsciiNodeShape } from '../types.ts'
6
-
7
- /**
8
- * Dimensions calculated for a shape, used by layout and rendering.
9
- */
10
- export interface ShapeDimensions {
11
- /** Total width in characters including borders */
12
- width: number
13
- /** Total height in characters including borders */
14
- height: number
15
- /** Label area bounds (where text can be placed) */
16
- labelArea: {
17
- x: number
18
- y: number
19
- width: number
20
- height: number
21
- }
22
- /** Grid column widths for the 3-column layout [left, center, right] */
23
- gridColumns: [number, number, number]
24
- /** Grid row heights for the 3-row layout [top, middle, bottom] */
25
- gridRows: [number, number, number]
26
- }
27
-
28
- /**
29
- * Options passed to shape renderers.
30
- */
31
- export interface ShapeRenderOptions {
32
- /** Use ASCII chars (+,-,|) vs Unicode box-drawing (┌,─,│) */
33
- useAscii: boolean
34
- /** Padding inside the shape */
35
- padding: number
36
- }
37
-
38
- /**
39
- * Interface for pluggable shape renderers.
40
- * Each shape type implements this interface.
41
- */
42
- export interface ShapeRenderer {
43
- /**
44
- * Calculate dimensions for this shape given a label.
45
- * Used during layout to determine node size.
46
- */
47
- getDimensions(label: string, options: ShapeRenderOptions): ShapeDimensions
48
-
49
- /**
50
- * Render the shape to a canvas.
51
- * Returns a standalone canvas containing just the shape.
52
- */
53
- render(
54
- label: string,
55
- dimensions: ShapeDimensions,
56
- options: ShapeRenderOptions
57
- ): Canvas
58
-
59
- /**
60
- * Get the edge attachment point for a given direction.
61
- * Used by edge routing to determine where edges connect.
62
- */
63
- getAttachmentPoint(
64
- dir: Direction,
65
- dimensions: ShapeDimensions,
66
- baseCoord: DrawingCoord
67
- ): DrawingCoord
68
- }
69
-
70
- /**
71
- * Registry of shape renderers keyed by shape type.
72
- */
73
- export type ShapeRegistry = Map<AsciiNodeShape, ShapeRenderer>
@@ -1,128 +0,0 @@
1
- // ============================================================================
2
- // ASCII renderer — timeline diagrams
3
- //
4
- // Renders Mermaid timeline syntax as a chronological outline with per-period
5
- // markers and indented milestone lists. This keeps the ASCII variant compact
6
- // and readable in terminals while preserving chronology and section grouping.
7
- // ============================================================================
8
-
9
- import { parseTimelineDiagram } from '../timeline/parser.ts'
10
- import { colorizeLine, DEFAULT_ASCII_THEME } from './ansi.ts'
11
- import type { AsciiConfig, AsciiTheme, CharRole, ColorMode } from './types.ts'
12
-
13
- interface StyledSegment {
14
- text: string
15
- role: CharRole | null
16
- }
17
-
18
- function renderStyledLine(
19
- segments: StyledSegment[],
20
- colorMode: ColorMode,
21
- theme: AsciiTheme,
22
- ): string {
23
- const chars: string[] = []
24
- const roles: (CharRole | null)[] = []
25
-
26
- for (const segment of segments) {
27
- for (const char of segment.text) {
28
- chars.push(char)
29
- roles.push(segment.role)
30
- }
31
- }
32
-
33
- return colorizeLine(chars, roles, theme, colorMode)
34
- }
35
-
36
- /**
37
- * Render a Mermaid timeline diagram to ASCII/Unicode text.
38
- */
39
- export function renderTimelineAscii(
40
- lines: string[],
41
- config: AsciiConfig,
42
- colorMode: ColorMode = 'none',
43
- theme: AsciiTheme = DEFAULT_ASCII_THEME,
44
- ): string {
45
- const diagram = parseTimelineDiagram(lines)
46
- const useAscii = config.useAscii
47
-
48
- const marker = useAscii ? 'o' : '○'
49
- const vertical = useAscii ? '|' : '│'
50
- const branch = useAscii ? '|' : '├'
51
- const lastBranch = useAscii ? '`' : '└'
52
- const horizontal = useAscii ? '-' : '─'
53
- const periodContinuation = ' '
54
-
55
- const out: string[] = []
56
- const pushLine = (segments: StyledSegment[] = []): void => {
57
- out.push(segments.length === 0 ? '' : renderStyledLine(segments, colorMode, theme))
58
- }
59
-
60
- if (diagram.title) {
61
- for (const line of diagram.title.split('\n')) {
62
- pushLine([{ text: line, role: 'text' }])
63
- }
64
- pushLine()
65
- }
66
-
67
- for (let sectionIndex = 0; sectionIndex < diagram.sections.length; sectionIndex++) {
68
- const section = diagram.sections[sectionIndex]!
69
-
70
- if (section.label) {
71
- pushLine([
72
- { text: '[', role: 'border' },
73
- { text: section.label.replace(/\n/g, ' / '), role: 'text' },
74
- { text: ']', role: 'border' },
75
- ])
76
- }
77
-
78
- for (let periodIndex = 0; periodIndex < section.periods.length; periodIndex++) {
79
- const period = section.periods[periodIndex]!
80
- const periodLines = period.label.split('\n')
81
-
82
- pushLine([
83
- { text: marker, role: 'junction' },
84
- { text: ' ', role: null },
85
- { text: periodLines[0] ?? '', role: 'text' },
86
- ])
87
- for (const line of periodLines.slice(1)) {
88
- pushLine([
89
- { text: `${periodContinuation} `, role: null },
90
- { text: line, role: 'text' },
91
- ])
92
- }
93
-
94
- for (let eventIndex = 0; eventIndex < period.events.length; eventIndex++) {
95
- const event = period.events[eventIndex]!
96
- const eventLines = event.text.split('\n')
97
- const junction = eventIndex === period.events.length - 1 ? lastBranch : branch
98
- pushLine([
99
- { text: vertical, role: 'line' },
100
- { text: ' ', role: null },
101
- { text: junction, role: eventIndex === period.events.length - 1 ? 'corner' : 'junction' },
102
- { text: horizontal, role: 'line' },
103
- { text: ' ', role: null },
104
- { text: eventLines[0] ?? '', role: 'text' },
105
- ])
106
-
107
- for (const line of eventLines.slice(1)) {
108
- pushLine(eventIndex === period.events.length - 1
109
- ? [
110
- { text: ' ', role: null },
111
- { text: line, role: 'text' },
112
- ]
113
- : [
114
- { text: vertical, role: 'line' },
115
- { text: ' ', role: null },
116
- { text: line, role: 'text' },
117
- ])
118
- }
119
- }
120
-
121
- const morePeriods = periodIndex < section.periods.length - 1
122
- const moreSections = sectionIndex < diagram.sections.length - 1
123
- if (morePeriods || moreSections) pushLine()
124
- }
125
- }
126
-
127
- return out.join('\n').trimEnd()
128
- }