agentic-mermaid 0.1.1 → 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 (336) hide show
  1. package/CHANGELOG.md +144 -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/dist/agent-core.d.ts +463 -0
  6. package/dist/agent-core.js +397 -0
  7. package/dist/agent.d.ts +73 -1868
  8. package/dist/agent.js +336 -37325
  9. package/dist/agentic-mermaid-mcp.js +7 -38399
  10. package/dist/am.js +33632 -40445
  11. package/dist/chunk-4QECACIA.js +4702 -0
  12. package/dist/chunk-CDPKJ2BQ.js +37 -0
  13. package/dist/chunk-QKDLMOJJ.js +3487 -0
  14. package/dist/chunk-WI35L7IR.js +615 -0
  15. package/dist/chunk-WN3YDOBG.js +149 -0
  16. package/dist/chunk-ZYMMKQ3I.js +62637 -0
  17. package/dist/index-D54dqSdC.d.ts +6777 -0
  18. package/dist/index.d.ts +1 -1
  19. package/dist/index.js +310 -33014
  20. package/dist/mcp-cli-SBQSTJFC.js +17 -0
  21. package/docs/README.md +14 -6
  22. package/docs/schemas/style-spec.schema.json +1221 -30
  23. package/examples/styles/catalog.json +54 -0
  24. package/examples/styles/cloudflare-workers-inspired-prototype.mmd +9 -0
  25. package/examples/styles/cloudflare-workers-inspired-prototype.style.json +110 -0
  26. package/examples/styles/cupertino-prototype.mmd +10 -0
  27. package/examples/styles/cupertino-prototype.style.json +63 -0
  28. package/examples/styles/mid-century-report.style.json +2 -2
  29. package/examples/styles/star-chart-atlas.style.json +2 -1
  30. package/examples/styles/transit-route-map.style.json +2 -2
  31. package/examples/styles/vercel-inspired-prototype.mmd +6 -0
  32. package/examples/styles/vercel-inspired-prototype.style.json +87 -0
  33. package/package.json +68 -43
  34. package/server.json +2 -2
  35. package/skills/agentic-mermaid-diagram-workflow/SKILL.md +17 -36
  36. package/skills/agentic-mermaid-diagram-workflow/references/cli.md +4 -5
  37. package/skills/agentic-mermaid-diagram-workflow/references/code-mode.md +15 -31
  38. package/skills/agentic-mermaid-diagram-workflow/references/sequence.md +10 -14
  39. package/skills/agentic-mermaid-live-editor/SKILL.md +100 -206
  40. package/AGENT_NATIVE.md +0 -607
  41. package/Instructions_for_agents.md +0 -89
  42. package/TODO.md +0 -684
  43. package/assets/hero.png +0 -0
  44. package/dist/index-wjRjbsP-.d.ts +0 -1102
  45. package/docs/agent-api-cookbook.md +0 -308
  46. package/docs/agent-mutation-policy.md +0 -104
  47. package/docs/agent-workflow-examples.md +0 -46
  48. package/docs/api.md +0 -211
  49. package/docs/ascii.md +0 -103
  50. package/docs/assets/improvements/box-start-connector.png +0 -0
  51. package/docs/assets/improvements/comment-dropped-lint.png +0 -0
  52. package/docs/assets/improvements/er-content-loss.png +0 -0
  53. package/docs/assets/improvements/fan-in-trunks.png +0 -0
  54. package/docs/assets/improvements/gantt-family.png +0 -0
  55. package/docs/assets/improvements/gantt-milestone-clamp.png +0 -0
  56. package/docs/assets/improvements/gantt-verify-seam.png +0 -0
  57. package/docs/assets/improvements/subgraph-container-edges.png +0 -0
  58. package/docs/assets/improvements/wrapper-frontmatter.png +0 -0
  59. package/docs/assets/improvements/wrapper-init-directive.png +0 -0
  60. package/docs/assets/improvements/wrapper-leading-comment.png +0 -0
  61. package/docs/assets/style-cookbook/mid-century-report.png +0 -0
  62. package/docs/assets/style-cookbook/star-chart-atlas.png +0 -0
  63. package/docs/assets/style-cookbook/transit-route-map.png +0 -0
  64. package/docs/comparison.md +0 -94
  65. package/docs/config.md +0 -105
  66. package/docs/contributing/adding-diagram-types.md +0 -144
  67. package/docs/contributing/diagram-family-citizenship.matrix.json +0 -2127
  68. package/docs/contributing/diagram-family-citizenship.md +0 -82
  69. package/docs/contributing/harvesting-upstream-tests.md +0 -126
  70. package/docs/contributing/lessons-learned.md +0 -276
  71. package/docs/contributing/releasing.md +0 -82
  72. package/docs/contributing/visual-review-evidence.md +0 -53
  73. package/docs/custom-style-cookbook.md +0 -154
  74. package/docs/design/families/README.md +0 -26
  75. package/docs/design/families/architecture-beta.md +0 -48
  76. package/docs/design/families/flowchart-parser-conformance.md +0 -22
  77. package/docs/design/families/gantt-research.md +0 -137
  78. package/docs/design/families/gantt.md +0 -329
  79. package/docs/design/families/journey-agentic-cards-before.png +0 -0
  80. package/docs/design/families/journey-experience-curve-implementation.png +0 -0
  81. package/docs/design/families/journey-mermaid-classic-implementation.png +0 -0
  82. package/docs/design/families/journey-mermaid-classic-prototype.png +0 -0
  83. package/docs/design/families/journey-mermaid-classic-prototype.svg +0 -163
  84. package/docs/design/families/journey-mermaid-classic-prototype.svg.png +0 -0
  85. package/docs/design/families/journey-migration-parity.md +0 -439
  86. package/docs/design/families/journey-section-overlap-after.png +0 -0
  87. package/docs/design/families/journey-section-overlap-before.png +0 -0
  88. package/docs/design/families/journey-usage-research.md +0 -423
  89. package/docs/design/families/journey.md +0 -153
  90. package/docs/design/families/xychart.md +0 -85
  91. package/docs/design/system/README.md +0 -45
  92. package/docs/design/system/abstraction-audit.md +0 -224
  93. package/docs/design/system/abstraction-recommendations.md +0 -655
  94. package/docs/design/system/architecture.mmd +0 -29
  95. package/docs/design/system/architecture.svg +0 -137
  96. package/docs/design/system/layout-guarantees-and-robustness.md +0 -351
  97. package/docs/design/system/layout-rubric.md +0 -138
  98. package/docs/design/system/route-contracts.md +0 -848
  99. package/docs/design/system/source-preservation-ladder.md +0 -52
  100. package/docs/design/system/styles-rollout.md +0 -216
  101. package/docs/design/system/ugly-layouts.md +0 -119
  102. package/docs/diagram-families.md +0 -193
  103. package/docs/features.md +0 -147
  104. package/docs/fork-differences.md +0 -130
  105. package/docs/getting-started.md +0 -175
  106. package/docs/issue-derived-test-cases.md +0 -156
  107. package/docs/layout-characterization/README.md +0 -245
  108. package/docs/layout-characterization/contact-sheet-families.md +0 -498
  109. package/docs/layout-characterization/contact-sheet.md +0 -638
  110. package/docs/layout-characterization/properties.md +0 -281
  111. package/docs/layout-characterization/visual-quality.md +0 -160
  112. package/docs/layout-characterization/visual-snapshots/architecture.svg +0 -79
  113. package/docs/layout-characterization/visual-snapshots/class.svg +0 -60
  114. package/docs/layout-characterization/visual-snapshots/er.svg +0 -61
  115. package/docs/layout-characterization/visual-snapshots/flowchart.svg +0 -58
  116. package/docs/layout-characterization/visual-snapshots/gantt.svg +0 -52
  117. package/docs/layout-characterization/visual-snapshots/journey.svg +0 -98
  118. package/docs/layout-characterization/visual-snapshots/pie.svg +0 -36
  119. package/docs/layout-characterization/visual-snapshots/quadrant.svg +0 -47
  120. package/docs/layout-characterization/visual-snapshots/sequence.svg +0 -59
  121. package/docs/layout-characterization/visual-snapshots/state.svg +0 -52
  122. package/docs/layout-characterization/visual-snapshots/timeline.svg +0 -64
  123. package/docs/layout-characterization/visual-snapshots/xychart.svg +0 -97
  124. package/docs/mcp-code-mode-rationale.md +0 -101
  125. package/docs/mcp-http-transport.md +0 -223
  126. package/docs/mermaid-layout-complaints.md +0 -837
  127. package/docs/mutation-testing.md +0 -206
  128. package/docs/project/divergences.md +0 -98
  129. package/docs/project/dogfooding-docs-strategy.md +0 -66
  130. package/docs/project/hosted-mcp-cloudflare-plan.md +0 -338
  131. package/docs/project/lessons-learned.md +0 -1019
  132. package/docs/project/remove-role-styling-plan.md +0 -176
  133. package/docs/quality.md +0 -215
  134. package/docs/react.md +0 -97
  135. package/docs/style-authoring.md +0 -133
  136. package/docs/testing-strategy.md +0 -335
  137. package/docs/theming.md +0 -162
  138. package/examples/agent-improve-auth-flow.ts +0 -206
  139. package/examples/agent-loop.ts +0 -53
  140. package/examples/mcp-vs-cli-complex-diagrams.ts +0 -133
  141. package/llms.txt +0 -104
  142. package/skill-evals/README.md +0 -77
  143. package/skill-evals/fixtures/architecture-cache/input.mmd +0 -5
  144. package/skill-evals/fixtures/class-payment/input.mmd +0 -4
  145. package/skill-evals/fixtures/er-orders/input.mmd +0 -10
  146. package/skill-evals/fixtures/flowchart-cache/input.mmd +0 -3
  147. package/skill-evals/fixtures/gantt-release/input.mmd +0 -7
  148. package/skill-evals/fixtures/journey-checkout/input.mmd +0 -6
  149. package/skill-evals/fixtures/pie-exports/input.mmd +0 -5
  150. package/skill-evals/fixtures/quadrant-priorities/input.mmd +0 -11
  151. package/skill-evals/fixtures/sequence-retry/input.mmd +0 -8
  152. package/skill-evals/fixtures/state-lifecycle/input.mmd +0 -5
  153. package/skill-evals/fixtures/timeline-release/input.mmd +0 -6
  154. package/skill-evals/fixtures/xychart-growth/input.mmd +0 -5
  155. package/skill-evals/shared-benchmark.json +0 -510
  156. package/src/agent/analyze.ts +0 -157
  157. package/src/agent/apply.ts +0 -146
  158. package/src/agent/architecture-body.ts +0 -458
  159. package/src/agent/certificates.ts +0 -110
  160. package/src/agent/class-body.ts +0 -319
  161. package/src/agent/core.ts +0 -207
  162. package/src/agent/create.ts +0 -106
  163. package/src/agent/describe.ts +0 -368
  164. package/src/agent/er-body.ts +0 -224
  165. package/src/agent/facts.ts +0 -360
  166. package/src/agent/families-builtin.ts +0 -920
  167. package/src/agent/families.ts +0 -232
  168. package/src/agent/family-layouts.ts +0 -832
  169. package/src/agent/flowchart-body.ts +0 -372
  170. package/src/agent/flowchart-unsupported.ts +0 -243
  171. package/src/agent/font-coverage.ts +0 -288
  172. package/src/agent/gantt-body.ts +0 -495
  173. package/src/agent/index.ts +0 -10
  174. package/src/agent/journey-body.ts +0 -374
  175. package/src/agent/label-metrics.ts +0 -28
  176. package/src/agent/layout-to-rendered.ts +0 -63
  177. package/src/agent/mutate.ts +0 -97
  178. package/src/agent/mutation-ops.ts +0 -51
  179. package/src/agent/op-schema.ts +0 -443
  180. package/src/agent/parse.ts +0 -223
  181. package/src/agent/pie-body.ts +0 -270
  182. package/src/agent/png.ts +0 -171
  183. package/src/agent/quadrant-body.ts +0 -336
  184. package/src/agent/quality.ts +0 -363
  185. package/src/agent/readability-audit.ts +0 -92
  186. package/src/agent/rendered-route-audit.ts +0 -61
  187. package/src/agent/sequence-body.ts +0 -345
  188. package/src/agent/serialize.ts +0 -214
  189. package/src/agent/state-body.ts +0 -589
  190. package/src/agent/structural-count.ts +0 -150
  191. package/src/agent/timeline-body.ts +0 -280
  192. package/src/agent/trace-log.ts +0 -43
  193. package/src/agent/types.ts +0 -995
  194. package/src/agent/verify.ts +0 -603
  195. package/src/agent/xychart-body.ts +0 -472
  196. package/src/architecture/config.ts +0 -282
  197. package/src/architecture/layout.ts +0 -496
  198. package/src/architecture/parser.ts +0 -375
  199. package/src/architecture/renderer.ts +0 -611
  200. package/src/architecture/types.ts +0 -113
  201. package/src/ascii/ansi.ts +0 -423
  202. package/src/ascii/architecture.ts +0 -210
  203. package/src/ascii/canvas.ts +0 -443
  204. package/src/ascii/class-diagram.ts +0 -697
  205. package/src/ascii/converter.ts +0 -475
  206. package/src/ascii/draw.ts +0 -1693
  207. package/src/ascii/edge-bundling.ts +0 -328
  208. package/src/ascii/edge-routing.ts +0 -330
  209. package/src/ascii/er-diagram.ts +0 -439
  210. package/src/ascii/gantt.ts +0 -276
  211. package/src/ascii/grid.ts +0 -747
  212. package/src/ascii/index.ts +0 -196
  213. package/src/ascii/journey.ts +0 -169
  214. package/src/ascii/meta.ts +0 -244
  215. package/src/ascii/multiline-utils.ts +0 -80
  216. package/src/ascii/pathfinder.ts +0 -301
  217. package/src/ascii/pie.ts +0 -67
  218. package/src/ascii/quadrant.ts +0 -158
  219. package/src/ascii/reverse.ts +0 -216
  220. package/src/ascii/sequence.ts +0 -499
  221. package/src/ascii/shapes/circle.ts +0 -27
  222. package/src/ascii/shapes/corners.ts +0 -143
  223. package/src/ascii/shapes/diamond.ts +0 -27
  224. package/src/ascii/shapes/hexagon.ts +0 -27
  225. package/src/ascii/shapes/index.ts +0 -106
  226. package/src/ascii/shapes/rectangle.ts +0 -168
  227. package/src/ascii/shapes/rounded.ts +0 -27
  228. package/src/ascii/shapes/special.ts +0 -332
  229. package/src/ascii/shapes/stadium.ts +0 -110
  230. package/src/ascii/shapes/state.ts +0 -192
  231. package/src/ascii/shapes/types.ts +0 -73
  232. package/src/ascii/timeline.ts +0 -141
  233. package/src/ascii/types.ts +0 -312
  234. package/src/ascii/validate.ts +0 -120
  235. package/src/ascii/width.ts +0 -81
  236. package/src/ascii/wrap.ts +0 -131
  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 -1132
  247. package/src/cli/init-agent.ts +0 -147
  248. package/src/cli/run-entrypoint.ts +0 -10
  249. package/src/color-resolver.ts +0 -152
  250. package/src/elk-instance.ts +0 -114
  251. package/src/er/layout.ts +0 -187
  252. package/src/er/parser.ts +0 -226
  253. package/src/er/renderer.ts +0 -792
  254. package/src/er/types.ts +0 -99
  255. package/src/family-rubric.ts +0 -425
  256. package/src/font-manifest.ts +0 -31
  257. package/src/gantt/layout.ts +0 -365
  258. package/src/gantt/parser.ts +0 -282
  259. package/src/gantt/pipeline.ts +0 -27
  260. package/src/gantt/renderer.ts +0 -414
  261. package/src/gantt/schedule.ts +0 -513
  262. package/src/gantt/types.ts +0 -255
  263. package/src/index.ts +0 -368
  264. package/src/journey/layout.ts +0 -554
  265. package/src/journey/parse-core.ts +0 -251
  266. package/src/journey/parser.ts +0 -101
  267. package/src/journey/renderer.ts +0 -917
  268. package/src/journey/types.ts +0 -144
  269. package/src/layout/geometry.ts +0 -182
  270. package/src/layout/pass.ts +0 -142
  271. package/src/layout/passes/index.ts +0 -3916
  272. package/src/layout-engine.ts +0 -1565
  273. package/src/layout-rubric.ts +0 -659
  274. package/src/mcp/artifacts.ts +0 -137
  275. package/src/mcp/dynamic-harness.ts +0 -31
  276. package/src/mcp/dynamic-modules.d.ts +0 -7
  277. package/src/mcp/facade.ts +0 -608
  278. package/src/mcp/harness-runtime.ts +0 -203
  279. package/src/mcp/hosted-server.ts +0 -468
  280. package/src/mcp/mcp-bin.ts +0 -3
  281. package/src/mcp/mcp-cli.ts +0 -82
  282. package/src/mcp/protocol.ts +0 -13
  283. package/src/mcp/sandbox.ts +0 -195
  284. package/src/mcp/sdk-decl.ts +0 -391
  285. package/src/mcp/server.ts +0 -362
  286. package/src/mcp/tool-surface.ts +0 -146
  287. package/src/mermaid-source.ts +0 -655
  288. package/src/multiline-utils.ts +0 -228
  289. package/src/parser.ts +0 -1031
  290. package/src/pie/layout.ts +0 -168
  291. package/src/pie/parser.ts +0 -136
  292. package/src/pie/renderer.ts +0 -234
  293. package/src/pie/types.ts +0 -82
  294. package/src/quadrant/layout.ts +0 -191
  295. package/src/quadrant/parser.ts +0 -183
  296. package/src/quadrant/renderer.ts +0 -322
  297. package/src/quadrant/types.ts +0 -113
  298. package/src/render-family-hooks.ts +0 -244
  299. package/src/renderer.ts +0 -1099
  300. package/src/route-contracts.ts +0 -2723
  301. package/src/scene/backend.ts +0 -76
  302. package/src/scene/fidelity.ts +0 -183
  303. package/src/scene/hybrid-backend.ts +0 -174
  304. package/src/scene/ir.ts +0 -181
  305. package/src/scene/marks.ts +0 -127
  306. package/src/scene/rough-backend.ts +0 -378
  307. package/src/scene/seed.ts +0 -46
  308. package/src/scene/style-registry.ts +0 -556
  309. package/src/sequence/layout.ts +0 -456
  310. package/src/sequence/parser.ts +0 -255
  311. package/src/sequence/renderer.ts +0 -604
  312. package/src/sequence/types.ts +0 -154
  313. package/src/shape-clipping.ts +0 -351
  314. package/src/shared/accessibility-directives.ts +0 -22
  315. package/src/shared/batched.ts +0 -61
  316. package/src/shared/color-math.ts +0 -93
  317. package/src/shared/svg-a11y.ts +0 -29
  318. package/src/shared/syntax-error.ts +0 -17
  319. package/src/shared/unicode-ranges.ts +0 -135
  320. package/src/styles.ts +0 -318
  321. package/src/svg-paths.ts +0 -28
  322. package/src/text-metrics.ts +0 -248
  323. package/src/theme.ts +0 -710
  324. package/src/timeline/layout.ts +0 -381
  325. package/src/timeline/parser.ts +0 -215
  326. package/src/timeline/renderer.ts +0 -538
  327. package/src/timeline/types.ts +0 -105
  328. package/src/types.ts +0 -462
  329. package/src/website-worker-modules.d.ts +0 -18
  330. package/src/xychart/axis-utils.ts +0 -109
  331. package/src/xychart/colors.ts +0 -124
  332. package/src/xychart/config.ts +0 -88
  333. package/src/xychart/layout.ts +0 -656
  334. package/src/xychart/parser.ts +0 -504
  335. package/src/xychart/renderer.ts +0 -640
  336. package/src/xychart/types.ts +0 -282
@@ -1,282 +0,0 @@
1
- import type { DiagramColors } from '../theme.ts'
2
- import type { MermaidFrontmatterMap, MermaidConfigValue } from '../mermaid-source.ts'
3
- import type { RenderOptions, TextTransform } from '../types.ts'
4
- import { resolveRenderStyle } from '../styles.ts'
5
- import type { RenderStyleDefaults } from '../styles.ts'
6
-
7
- export interface ArchitectureVisualConfig {
8
- groupHeaderHeight: number
9
- groupFontSize: number
10
- groupFontWeight: number
11
- groupLetterSpacing: number
12
- groupFont?: string
13
- groupTextTransform?: TextTransform
14
- groupPaddingX: number
15
- groupPaddingY: number
16
- groupLabelPaddingX: number
17
- groupCornerRadius: number
18
- groupLineWidth: number
19
- groupText?: string
20
- serviceFontSize: number
21
- serviceFontWeight: number
22
- serviceLetterSpacing: number
23
- serviceTextTransform?: TextTransform
24
- servicePaddingX: number
25
- servicePaddingY: number
26
- serviceCornerRadius: number
27
- serviceLineWidth: number
28
- serviceText?: string
29
- edgeFontSize: number
30
- edgeFontWeight: number
31
- edgeLetterSpacing: number
32
- edgeTextTransform?: TextTransform
33
- edgeLineWidth: number
34
- edgeBendRadius: number
35
- edgeStroke?: string
36
- edgeText?: string
37
- iconSize: number
38
- serviceIconSize: number
39
- junctionOuterRadius: number
40
- junctionInnerRadius: number
41
- groupSurface?: string
42
- groupHeaderSurface?: string
43
- groupBorder?: string
44
- serviceSurface?: string
45
- serviceBorder?: string
46
- }
47
-
48
- export interface ArchitectureLayoutMetrics {
49
- groupFontSize: number
50
- groupFontWeight: number
51
- groupLetterSpacing: number
52
- groupFont?: string
53
- groupTextTransform?: TextTransform
54
- groupPaddingX: number
55
- groupPaddingY: number
56
- groupCornerRadius: number
57
- groupLineWidth: number
58
- serviceFontSize: number
59
- serviceFontWeight: number
60
- serviceLetterSpacing: number
61
- serviceTextTransform?: TextTransform
62
- servicePaddingX: number
63
- servicePaddingY: number
64
- serviceCornerRadius: number
65
- serviceLineWidth: number
66
- edgeFontSize: number
67
- edgeFontWeight: number
68
- edgeLetterSpacing: number
69
- edgeTextTransform?: TextTransform
70
- edgeLineWidth: number
71
- edgeBendRadius: number
72
- }
73
-
74
- export interface ResolvedArchitectureVisualConfig {
75
- visual: ArchitectureVisualConfig
76
- layout: ArchitectureLayoutMetrics
77
- padding?: number
78
- }
79
-
80
- export const DEFAULT_ARCHITECTURE_VISUAL: ArchitectureVisualConfig = {
81
- groupHeaderHeight: 28,
82
- groupFontSize: 12,
83
- groupFontWeight: 600,
84
- groupLetterSpacing: 0,
85
- groupPaddingX: 16,
86
- groupPaddingY: 16,
87
- groupLabelPaddingX: 12,
88
- groupCornerRadius: 0,
89
- groupLineWidth: 1,
90
- serviceFontSize: 13,
91
- serviceFontWeight: 500,
92
- serviceLetterSpacing: 0,
93
- servicePaddingX: 20,
94
- servicePaddingY: 10,
95
- serviceCornerRadius: 0,
96
- serviceLineWidth: 1,
97
- edgeFontSize: 11,
98
- edgeFontWeight: 400,
99
- edgeLetterSpacing: 0,
100
- edgeLineWidth: 1,
101
- edgeBendRadius: 0,
102
- iconSize: 16,
103
- serviceIconSize: 18,
104
- junctionOuterRadius: 8,
105
- junctionInnerRadius: 4.5,
106
- }
107
-
108
- /**
109
- * Resolve architecture-specific visual metrics from Mermaid frontmatter.
110
- *
111
- * Color resolution is handled by the shared `buildColors()` in src/index.ts.
112
- * This function only computes layout metrics (font sizes, icon sizes, junction
113
- * radii) and architecture-specific surface/border overrides (clusterBkg, etc.).
114
- */
115
- export function resolveArchitectureVisualConfig(
116
- mermaidConfig: MermaidFrontmatterMap,
117
- colors: DiagramColors,
118
- options: RenderOptions = {},
119
- ): ResolvedArchitectureVisualConfig {
120
- const themeVariables = getMap(mermaidConfig, 'themeVariables')
121
- const architecture = getMap(mermaidConfig, 'architecture')
122
-
123
- const baseFontSize = clamp(
124
- getNumber(architecture, 'fontSize')
125
- ?? getNumber(mermaidConfig, 'fontSize')
126
- ?? getNumber(themeVariables, 'fontSize')
127
- ?? DEFAULT_ARCHITECTURE_VISUAL.serviceFontSize,
128
- 10,
129
- 24,
130
- )
131
-
132
- const serviceIconSize = clamp(
133
- getNumber(architecture, 'iconSize') ?? DEFAULT_ARCHITECTURE_VISUAL.serviceIconSize,
134
- 12,
135
- 40,
136
- )
137
-
138
- const iconSize = clamp(Math.round(serviceIconSize * (DEFAULT_ARCHITECTURE_VISUAL.iconSize / DEFAULT_ARCHITECTURE_VISUAL.serviceIconSize)), 10, 36)
139
- const groupFontSize = clamp(Math.round(baseFontSize * 0.92), 10, 22)
140
- const edgeFontSize = clamp(Math.round(baseFontSize * 0.85), 10, 20)
141
- const groupHeaderHeight = Math.max(
142
- DEFAULT_ARCHITECTURE_VISUAL.groupHeaderHeight,
143
- Math.round(Math.max(groupFontSize, iconSize) + 12),
144
- )
145
- const junctionOuterRadius = clamp(Math.round(serviceIconSize * 0.44), 8, 18)
146
- const junctionInnerRadius = Number((junctionOuterRadius * 0.56).toFixed(1))
147
-
148
- const styleDefaults: RenderStyleDefaults = {
149
- nodeLabelFontSize: baseFontSize,
150
- edgeLabelFontSize: edgeFontSize,
151
- groupHeaderFontSize: groupFontSize,
152
- nodeLabelFontWeight: DEFAULT_ARCHITECTURE_VISUAL.serviceFontWeight,
153
- edgeLabelFontWeight: DEFAULT_ARCHITECTURE_VISUAL.edgeFontWeight,
154
- groupHeaderFontWeight: DEFAULT_ARCHITECTURE_VISUAL.groupFontWeight,
155
- nodePaddingX: DEFAULT_ARCHITECTURE_VISUAL.servicePaddingX,
156
- nodePaddingY: DEFAULT_ARCHITECTURE_VISUAL.servicePaddingY,
157
- nodeCornerRadius: DEFAULT_ARCHITECTURE_VISUAL.serviceCornerRadius,
158
- nodeLineWidth: DEFAULT_ARCHITECTURE_VISUAL.serviceLineWidth,
159
- edgeLineWidth: DEFAULT_ARCHITECTURE_VISUAL.edgeLineWidth,
160
- edgeBendRadius: DEFAULT_ARCHITECTURE_VISUAL.edgeBendRadius,
161
- groupCornerRadius: DEFAULT_ARCHITECTURE_VISUAL.groupCornerRadius,
162
- groupPaddingX: DEFAULT_ARCHITECTURE_VISUAL.groupPaddingX,
163
- groupPaddingY: DEFAULT_ARCHITECTURE_VISUAL.groupPaddingY,
164
- groupLabelPaddingX: DEFAULT_ARCHITECTURE_VISUAL.groupLabelPaddingX,
165
- groupLineWidth: DEFAULT_ARCHITECTURE_VISUAL.groupLineWidth,
166
- }
167
- const style = resolveRenderStyle(options, styleDefaults)
168
-
169
- const visual: ArchitectureVisualConfig = {
170
- groupHeaderHeight: Math.max(groupHeaderHeight, style.groupHeaderFontSize + 12),
171
- groupFontSize: style.groupHeaderFontSize,
172
- groupFontWeight: style.groupHeaderFontWeight,
173
- groupLetterSpacing: style.groupLetterSpacing,
174
- groupFont: style.groupFont,
175
- groupTextTransform: style.groupTextTransform,
176
- groupPaddingX: style.groupPaddingX,
177
- groupPaddingY: style.groupPaddingY,
178
- groupLabelPaddingX: style.groupLabelPaddingX,
179
- groupCornerRadius: style.groupCornerRadius,
180
- groupLineWidth: style.groupLineWidth,
181
- serviceFontSize: style.nodeLabelFontSize,
182
- serviceFontWeight: style.nodeLabelFontWeight,
183
- serviceLetterSpacing: style.nodeLetterSpacing,
184
- serviceTextTransform: style.nodeTextTransform,
185
- servicePaddingX: style.nodePaddingX,
186
- servicePaddingY: style.nodePaddingY,
187
- serviceCornerRadius: style.cornerRadius ?? 0,
188
- serviceLineWidth: style.nodeLineWidth,
189
- edgeFontSize: style.edgeLabelFontSize,
190
- edgeFontWeight: style.edgeLabelFontWeight,
191
- edgeLetterSpacing: style.edgeLetterSpacing,
192
- edgeTextTransform: style.edgeTextTransform,
193
- edgeLineWidth: style.lineWidth,
194
- edgeBendRadius: style.edgeBendRadius,
195
- iconSize,
196
- serviceIconSize,
197
- junctionOuterRadius,
198
- junctionInnerRadius,
199
- groupSurface: style.groupFillColor ?? pickString(themeVariables, 'clusterBkg') ?? colors.surface,
200
- groupHeaderSurface: style.groupHeaderFillColor,
201
- groupBorder: style.groupBorderColor ?? pickString(themeVariables, 'clusterBorder') ?? colors.border,
202
- groupText: style.groupTextColor,
203
- serviceSurface: style.nodeFillColor ?? pickString(themeVariables, 'mainBkg', 'secondaryColor') ?? colors.surface,
204
- serviceBorder: style.nodeBorderColor ?? pickString(themeVariables, 'primaryBorderColor') ?? colors.border,
205
- serviceText: style.nodeTextColor,
206
- edgeStroke: style.edgeStrokeColor,
207
- edgeText: style.edgeTextColor,
208
- }
209
-
210
- return {
211
- visual,
212
- layout: architectureLayoutMetrics(visual),
213
- padding: getNumber(architecture, 'padding'),
214
- }
215
- }
216
-
217
- export function architectureLayoutMetrics(visual: ArchitectureVisualConfig): ArchitectureLayoutMetrics {
218
- return {
219
- groupFontSize: visual.groupFontSize,
220
- groupFontWeight: visual.groupFontWeight,
221
- groupLetterSpacing: visual.groupLetterSpacing,
222
- groupFont: visual.groupFont,
223
- groupTextTransform: visual.groupTextTransform,
224
- groupPaddingX: visual.groupPaddingX,
225
- groupPaddingY: visual.groupPaddingY,
226
- groupCornerRadius: visual.groupCornerRadius,
227
- groupLineWidth: visual.groupLineWidth,
228
- serviceFontSize: visual.serviceFontSize,
229
- serviceFontWeight: visual.serviceFontWeight,
230
- serviceLetterSpacing: visual.serviceLetterSpacing,
231
- serviceTextTransform: visual.serviceTextTransform,
232
- servicePaddingX: visual.servicePaddingX,
233
- servicePaddingY: visual.servicePaddingY,
234
- serviceCornerRadius: visual.serviceCornerRadius,
235
- serviceLineWidth: visual.serviceLineWidth,
236
- edgeFontSize: visual.edgeFontSize,
237
- edgeFontWeight: visual.edgeFontWeight,
238
- edgeLetterSpacing: visual.edgeLetterSpacing,
239
- edgeTextTransform: visual.edgeTextTransform,
240
- edgeLineWidth: visual.edgeLineWidth,
241
- edgeBendRadius: visual.edgeBendRadius,
242
- }
243
- }
244
-
245
- function pickString(map: MermaidFrontmatterMap | undefined, ...keys: string[]): string | undefined {
246
- for (const key of keys) {
247
- const value = getString(map, key)
248
- if (value) return value
249
- }
250
- return undefined
251
- }
252
-
253
- function getString(map: MermaidFrontmatterMap | undefined, key: string): string | undefined {
254
- const value = map?.[key]
255
- return typeof value === 'string' ? value : undefined
256
- }
257
-
258
- function getNumber(map: MermaidFrontmatterMap | undefined, key: string): number | undefined {
259
- return toNumber(map?.[key])
260
- }
261
-
262
- function getMap(map: MermaidFrontmatterMap | undefined, key: string): MermaidFrontmatterMap | undefined {
263
- const value = map?.[key]
264
- return isMap(value) ? value : undefined
265
- }
266
-
267
- function toNumber(value: MermaidConfigValue | undefined): number | undefined {
268
- if (typeof value === 'number') return value
269
- if (typeof value !== 'string') return undefined
270
-
271
- const normalized = value.trim()
272
- const match = normalized.match(/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)(?:px)?$/i)
273
- return match ? Number.parseFloat(normalized) : undefined
274
- }
275
-
276
- function clamp(value: number, min: number, max: number): number {
277
- return Math.min(max, Math.max(min, value))
278
- }
279
-
280
- function isMap(value: MermaidConfigValue | undefined): value is MermaidFrontmatterMap {
281
- return Boolean(value) && typeof value === 'object' && !Array.isArray(value)
282
- }