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,611 +0,0 @@
1
- import type {
2
- PositionedArchitectureDiagram,
3
- PositionedArchitectureEdge,
4
- PositionedArchitectureGroup,
5
- PositionedArchitectureJunction,
6
- PositionedArchitectureService,
7
- } from './types.ts'
8
- import type { ArchitectureVisualConfig } from './config.ts'
9
- import { DEFAULT_ARCHITECTURE_VISUAL } from './config.ts'
10
- import type { Point, RenderContext } from '../types.ts'
11
- import { svgOpenTag, buildStyleBlock } from '../theme.ts'
12
- import { escapeAttr, renderMultilineText, renderMultilineTextWithBackground, escapeXml } from '../multiline-utils.ts'
13
- import { measureMultilineText } from '../text-metrics.ts'
14
- import { applyTextTransform } from '../styles.ts'
15
- import { topRoundedRectPath } from '../svg-paths.ts'
16
- import type { MarkerRef, SceneDoc, SceneNode } from '../scene/ir.ts'
17
- import { hashId } from '../scene/seed.ts'
18
- import * as marks from '../scene/marks.ts'
19
- import { DefaultBackend } from '../scene/backend.ts'
20
-
21
- // ============================================================================
22
- // Architecture renderer — lowers a PositionedArchitectureDiagram to the
23
- // SceneGraph IR (SPEC §3.1) and serializes it via the DefaultBackend.
24
- //
25
- // Every crisp template below is the historical string renderer's template
26
- // moved verbatim into a mark constructor call, and doc.parts order matches
27
- // the historical parts[] order, so DefaultBackend output stays byte-identical
28
- // (corpus-gated by svg-equivalence.test.ts).
29
- // ============================================================================
30
-
31
- /**
32
- * Render a positioned architecture diagram as SVG.
33
- */
34
- export function renderArchitectureSvg(
35
- ctx: RenderContext<PositionedArchitectureDiagram>,
36
- ): string {
37
- return DefaultBackend.render(lowerArchitectureScene(ctx), { seed: 0 })
38
- }
39
-
40
- /**
41
- * Lower a positioned architecture diagram to the SceneGraph IR. Mark order
42
- * matches the historical parts[] order exactly; DefaultBackend joins crisps
43
- * with '\n'.
44
- */
45
- export function lowerArchitectureScene(
46
- ctx: RenderContext<PositionedArchitectureDiagram>,
47
- ): SceneDoc {
48
- const { positioned: diagram, colors, options } = ctx
49
- const font = colors.font ?? 'Inter'
50
- const transparent = options.transparent ?? false
51
- const visual = options.architecture?.visual ?? DEFAULT_ARCHITECTURE_VISUAL
52
- const parts: SceneNode[] = []
53
- const archVars = [
54
- visual.groupSurface ? `--arch-group-fill:${visual.groupSurface}` : '',
55
- visual.groupHeaderSurface ? `--arch-group-band:${visual.groupHeaderSurface}` : '',
56
- visual.groupBorder ? `--arch-group-stroke:${visual.groupBorder}` : '',
57
- visual.groupText ? `--arch-group-label:${visual.groupText}` : '',
58
- visual.serviceSurface ? `--arch-service-fill:${visual.serviceSurface}` : '',
59
- visual.serviceBorder ? `--arch-service-stroke:${visual.serviceBorder}` : '',
60
- visual.serviceText ? `--arch-service-label:${visual.serviceText}` : '',
61
- visual.edgeStroke ? `--arch-edge-stroke:${visual.edgeStroke}` : '',
62
- visual.edgeText ? `--arch-edge-label:${visual.edgeText}` : '',
63
- ].filter(Boolean).join(';')
64
-
65
- const hasTitle = Boolean(diagram.accessibilityTitle)
66
- const hasDesc = Boolean(diagram.accessibilityDescription)
67
- const uid = `arch-${hashId(diagram.width, diagram.height, diagram.services.map(s => s.id).join(','), diagram.groups.map(g => g.id).join(','))}`
68
- const titleId = `${uid}-title`
69
- const descId = `${uid}-desc`
70
- const a11yAttrs: Record<string, string | undefined> = {}
71
- if (hasTitle || hasDesc) {
72
- a11yAttrs['role'] = 'img'
73
- a11yAttrs['aria-roledescription'] = 'architecture'
74
- }
75
- if (hasTitle) a11yAttrs['aria-labelledby'] = titleId
76
- if (hasDesc) a11yAttrs['aria-describedby'] = descId
77
-
78
- // Document prelude: svg open tag + shared style block + architecture CSS,
79
- // joined the way the string renderer pushed them. The accessibility
80
- // <title>/<desc> lines sit between the open tag and the style block in the
81
- // historical byte stream, so when present they are folded into the prelude
82
- // crisp at that exact position (a separate part after the prelude would
83
- // reorder them below the style blocks and drift the output bytes).
84
- const archCss = architectureStyles(visual)
85
- const preludeParts: string[] = []
86
- preludeParts.push(svgOpenTag(diagram.width, diagram.height, colors, transparent, {
87
- style: archVars,
88
- attrs: a11yAttrs,
89
- }))
90
- if (hasTitle) preludeParts.push(`<title id="${titleId}">${escapeXml(diagram.accessibilityTitle!)}</title>`)
91
- if (hasDesc) preludeParts.push(`<desc id="${descId}">${escapeXml(diagram.accessibilityDescription!)}</desc>`)
92
- preludeParts.push(buildStyleBlock(font, false, undefined, colors.embedFontImport))
93
- preludeParts.push(archCss)
94
- parts.push(marks.prelude({
95
- id: 'prelude',
96
- width: diagram.width,
97
- height: diagram.height,
98
- colors,
99
- transparent,
100
- font,
101
- hasMonoFont: false,
102
- extraCss: archCss,
103
- }, preludeParts.join('\n')))
104
-
105
- parts.push(marks.raw(
106
- { id: 'defs', role: 'defs' },
107
- ['<defs>', arrowMarkerDefs(), '</defs>'].join('\n'),
108
- ))
109
-
110
- for (const group of diagram.groups) {
111
- parts.push(lowerGroup(group, visual))
112
- }
113
-
114
- const edgeOccurrence = new Map<string, number>()
115
- for (const edge of diagram.edges) {
116
- const pairKey = `${edge.source.id}->${edge.target.id}`
117
- const k = edgeOccurrence.get(pairKey) ?? 0
118
- edgeOccurrence.set(pairKey, k + 1)
119
- parts.push(lowerEdge(edge, visual, `edge:${pairKey}#${k}`))
120
- }
121
-
122
- const labelOccurrence = new Map<string, number>()
123
- for (const edge of diagram.edges) {
124
- if (!edge.label) continue
125
- const pairKey = `${edge.source.id}->${edge.target.id}`
126
- const k = labelOccurrence.get(pairKey) ?? 0
127
- labelOccurrence.set(pairKey, k + 1)
128
- // The string renderer emitted "<rect bg>\n<text>" as one part; two flat
129
- // marks joined with '\n' by the backend produce the same bytes.
130
- for (const mark of lowerEdgeLabel(edge, visual, `edge-label:${pairKey}#${k}`)) {
131
- parts.push(mark)
132
- }
133
- }
134
-
135
- for (const junction of diagram.junctions) {
136
- parts.push(lowerJunction(junction, visual))
137
- }
138
-
139
- for (const service of diagram.services) {
140
- parts.push(lowerService(service, visual))
141
- }
142
-
143
- parts.push(marks.raw({ id: 'svg-close', role: 'chrome' }, '</svg>'))
144
-
145
- return { family: 'architecture', width: diagram.width, height: diagram.height, colors, parts }
146
- }
147
-
148
- function architectureStyles(visual: ArchitectureVisualConfig): string {
149
- return `<style>
150
- .architecture-group-frame { fill: var(--arch-group-fill, color-mix(in srgb, var(--_node-fill) 82%, var(--bg))); stroke: none; }
151
- .architecture-group-band { fill: var(--arch-group-band, color-mix(in srgb, var(--arch-edge-stroke, var(--_arrow)) 5%, var(--arch-group-fill, var(--bg)))); stroke: none; }
152
- .architecture-group-outline { fill: none; stroke: var(--arch-group-stroke, var(--_node-stroke)); stroke-width: ${visual.groupLineWidth}; }
153
- .architecture-group-label { fill: var(--arch-group-label, var(--_text-sec)); }
154
- .architecture-service-card { fill: var(--arch-service-fill, color-mix(in srgb, var(--_node-fill) 92%, var(--bg))); stroke: none; }
155
- .architecture-service-outline { fill: none; stroke: var(--arch-service-stroke, var(--_node-stroke)); stroke-width: ${visual.serviceLineWidth}; }
156
- .architecture-service-label { fill: var(--arch-service-label, var(--_text)); }
157
- .architecture-edge { fill: none; stroke: var(--arch-edge-stroke, var(--_line)); stroke-width: ${visual.edgeLineWidth}; stroke-linejoin: round; }
158
- .architecture-edge-label-bg { fill: color-mix(in srgb, var(--bg) 90%, var(--_group-hdr)); stroke: color-mix(in srgb, var(--arch-edge-stroke, var(--_line)) 18%, var(--bg)); stroke-width: 0.75; }
159
- .architecture-edge-label-text { fill: var(--arch-edge-label, var(--_text-muted)); }
160
- .architecture-junction-ring { fill: var(--bg); stroke: var(--arch-edge-stroke, var(--_arrow)); stroke-width: 1.25; }
161
- .architecture-junction-core { fill: color-mix(in srgb, var(--arch-edge-stroke, var(--_arrow)) 24%, var(--bg)); stroke: var(--arch-edge-stroke, var(--_arrow)); stroke-width: 0.75; }
162
- .architecture-icon-mark { fill: none; stroke: var(--arch-edge-stroke, var(--_arrow)); stroke-width: 1.25; stroke-linecap: round; stroke-linejoin: round; }
163
- .architecture-icon-glyph { fill: var(--arch-edge-stroke, var(--_arrow)); }
164
- </style>`
165
- }
166
-
167
- function lowerGroup(group: PositionedArchitectureGroup, visual: ArchitectureVisualConfig): SceneNode {
168
- const children: Array<{ node: SceneNode; indent: number }> = []
169
- const open =
170
- `<g class="architecture-group" data-id="${escapeAttr(group.id)}" data-label="${escapeAttr(group.label)}">`
171
-
172
- children.push({
173
- indent: 2,
174
- node: marks.shape({
175
- id: `group-frame:${group.id}`,
176
- role: 'group',
177
- geometry: { kind: 'rect', x: group.x, y: group.y, width: group.width, height: group.height, rx: visual.groupCornerRadius, ry: visual.groupCornerRadius },
178
- paint: { fill: 'var(--arch-group-fill, color-mix(in srgb, var(--_node-fill) 82%, var(--bg)))', stroke: 'none' },
179
- },
180
- `<rect class="architecture-group-frame" x="${group.x}" y="${group.y}" width="${group.width}" height="${group.height}" rx="${visual.groupCornerRadius}" ry="${visual.groupCornerRadius}" />`),
181
- })
182
-
183
- const bandPath = topRoundedRectPath(group.x, group.y, group.width, visual.groupHeaderHeight, visual.groupCornerRadius)
184
- children.push({
185
- indent: 2,
186
- node: marks.shape({
187
- id: `group-band:${group.id}`,
188
- role: 'group-header',
189
- geometry: { kind: 'path', d: bandPath },
190
- paint: { fill: 'var(--arch-group-band, color-mix(in srgb, var(--arch-edge-stroke, var(--_arrow)) 5%, var(--arch-group-fill, var(--bg))))', stroke: 'none' },
191
- },
192
- `<path class="architecture-group-band" d="${bandPath}" />`),
193
- })
194
-
195
- children.push({
196
- indent: 2,
197
- node: marks.shape({
198
- id: `group-outline:${group.id}`,
199
- role: 'group',
200
- geometry: { kind: 'rect', x: group.x, y: group.y, width: group.width, height: group.height, rx: visual.groupCornerRadius, ry: visual.groupCornerRadius },
201
- paint: { fill: 'none', stroke: 'var(--arch-group-stroke, var(--_node-stroke))', strokeWidth: String(visual.groupLineWidth) },
202
- },
203
- `<rect class="architecture-group-outline" x="${group.x}" y="${group.y}" width="${group.width}" height="${group.height}" rx="${visual.groupCornerRadius}" ry="${visual.groupCornerRadius}" />`),
204
- })
205
-
206
- if (group.icon) {
207
- // The string renderer indented only the first line of the multi-line icon
208
- // chunk (`parts.push(` ${renderIcon(...)}`)`), so the two-space prefix is
209
- // baked into the raw crisp instead of using the group's indent machinery
210
- // (which indents every line).
211
- children.push({
212
- indent: 0,
213
- node: marks.raw(
214
- { id: `icon:${group.id}`, role: 'icon' },
215
- ` ${renderIcon(group.x + 10, group.y + 6, visual.iconSize, group.icon, true)}`,
216
- ),
217
- })
218
- }
219
-
220
- const labelText = applyTextTransform(group.label, visual.groupTextTransform)
221
- const labelX = group.x + (group.icon ? 36 : visual.groupLabelPaddingX)
222
- const labelY = group.y + visual.groupHeaderHeight / 2
223
- children.push({
224
- indent: 2,
225
- node: marks.text({
226
- id: `group-label:${group.id}`,
227
- role: 'label',
228
- text: labelText,
229
- x: labelX,
230
- y: labelY,
231
- fontSize: visual.groupFontSize,
232
- anchor: 'start',
233
- paint: { fill: 'var(--arch-group-label, var(--_text-sec))' },
234
- }, renderMultilineText(
235
- labelText,
236
- labelX,
237
- labelY,
238
- visual.groupFontSize,
239
- `class="architecture-group-label" text-anchor="start" font-size="${visual.groupFontSize}" font-weight="${visual.groupFontWeight}"${visual.groupFont ? ` font-family="${escapeAttr(visual.groupFont)}"` : ''}${letterAttr(visual.groupLetterSpacing)}`,
240
- )),
241
- })
242
-
243
- for (const child of group.children) {
244
- children.push({ indent: 0, node: lowerGroup(child, visual) })
245
- }
246
-
247
- return marks.group({
248
- id: `group:${group.id}`,
249
- role: 'group',
250
- open,
251
- close: '</g>',
252
- children,
253
- })
254
- }
255
-
256
- function lowerService(service: PositionedArchitectureService, visual: ArchitectureVisualConfig): SceneNode {
257
- const children: Array<{ node: SceneNode; indent: number }> = []
258
- const hasIcon = Boolean(service.icon)
259
- const iconX = service.x + visual.servicePaddingX
260
- const iconY = service.y + service.height / 2 - visual.serviceIconSize / 2
261
- const labelX = hasIcon
262
- ? iconX + visual.serviceIconSize + Math.max(10, visual.servicePaddingX * 0.7)
263
- : service.x + visual.servicePaddingX
264
-
265
- const open =
266
- `<g class="architecture-service" data-id="${escapeAttr(service.id)}" data-label="${escapeAttr(service.label)}">`
267
-
268
- children.push({
269
- indent: 2,
270
- node: marks.shape({
271
- id: `service-card:${service.id}`,
272
- role: 'service',
273
- geometry: { kind: 'rect', x: service.x, y: service.y, width: service.width, height: service.height, rx: visual.serviceCornerRadius, ry: visual.serviceCornerRadius },
274
- paint: { fill: 'var(--arch-service-fill, color-mix(in srgb, var(--_node-fill) 92%, var(--bg)))', stroke: 'none' },
275
- },
276
- `<rect class="architecture-service-card" x="${service.x}" y="${service.y}" width="${service.width}" height="${service.height}" rx="${visual.serviceCornerRadius}" ry="${visual.serviceCornerRadius}" />`),
277
- })
278
-
279
- children.push({
280
- indent: 2,
281
- node: marks.shape({
282
- id: `service-outline:${service.id}`,
283
- role: 'service',
284
- geometry: { kind: 'rect', x: service.x, y: service.y, width: service.width, height: service.height, rx: visual.serviceCornerRadius, ry: visual.serviceCornerRadius },
285
- paint: { fill: 'none', stroke: 'var(--arch-service-stroke, var(--_node-stroke))', strokeWidth: String(visual.serviceLineWidth) },
286
- },
287
- `<rect class="architecture-service-outline" x="${service.x}" y="${service.y}" width="${service.width}" height="${service.height}" rx="${visual.serviceCornerRadius}" ry="${visual.serviceCornerRadius}" />`),
288
- })
289
-
290
- if (service.icon) {
291
- // Same first-line-only indent as group icons (see lowerGroup).
292
- children.push({
293
- indent: 0,
294
- node: marks.raw(
295
- { id: `icon:${service.id}`, role: 'icon' },
296
- ` ${renderIcon(iconX, iconY, visual.serviceIconSize, service.icon, false)}`,
297
- ),
298
- })
299
- }
300
-
301
- const labelY = service.y + service.height / 2
302
- const labelText = applyTextTransform(service.label, visual.serviceTextTransform)
303
- children.push({
304
- indent: 2,
305
- node: marks.text({
306
- id: `service-label:${service.id}`,
307
- role: 'label',
308
- text: labelText,
309
- x: labelX,
310
- y: labelY,
311
- fontSize: visual.serviceFontSize,
312
- anchor: 'start',
313
- paint: { fill: 'var(--arch-service-label, var(--_text))' },
314
- }, renderMultilineText(
315
- labelText,
316
- labelX,
317
- labelY,
318
- visual.serviceFontSize,
319
- `class="architecture-service-label" text-anchor="start" font-size="${visual.serviceFontSize}" font-weight="${visual.serviceFontWeight}"${letterAttr(visual.serviceLetterSpacing)}`,
320
- )),
321
- })
322
-
323
- return marks.group({
324
- id: `service:${service.id}`,
325
- role: 'service',
326
- open,
327
- close: '</g>',
328
- children,
329
- })
330
- }
331
-
332
- function lowerJunction(junction: PositionedArchitectureJunction, visual: ArchitectureVisualConfig): SceneNode {
333
- const cx = junction.x + junction.width / 2
334
- const cy = junction.y + junction.height / 2
335
-
336
- const ring = marks.shape({
337
- id: `junction-ring:${junction.id}`,
338
- role: 'junction',
339
- geometry: { kind: 'circle', cx, cy, r: visual.junctionOuterRadius },
340
- paint: { fill: 'var(--bg)', stroke: 'var(--arch-edge-stroke, var(--_arrow))', strokeWidth: '1.25' },
341
- }, `<circle class="architecture-junction-ring" cx="${cx}" cy="${cy}" r="${visual.junctionOuterRadius}" />`)
342
- const core = marks.shape({
343
- id: `junction-core:${junction.id}`,
344
- role: 'junction',
345
- geometry: { kind: 'circle', cx, cy, r: visual.junctionInnerRadius },
346
- paint: { fill: 'color-mix(in srgb, var(--arch-edge-stroke, var(--_arrow)) 24%, var(--bg))', stroke: 'var(--arch-edge-stroke, var(--_arrow))', strokeWidth: '0.75' },
347
- }, `<circle class="architecture-junction-core" cx="${cx}" cy="${cy}" r="${visual.junctionInnerRadius}" />`)
348
- return marks.group({
349
- id: `junction:${junction.id}`,
350
- role: 'junction',
351
- open: `<g class="architecture-junction" data-id="${escapeAttr(junction.id)}">`,
352
- close: '</g>',
353
- children: [
354
- { indent: 2, node: ring },
355
- { indent: 2, node: core },
356
- ],
357
- })
358
- }
359
-
360
- function lowerEdge(edge: PositionedArchitectureEdge, visual: ArchitectureVisualConfig, sceneId: string): SceneNode {
361
- const points = edge.points.map((point) => `${point.x},${point.y}`).join(' ')
362
- let markers = ''
363
- let startMarker: MarkerRef | undefined
364
- let endMarker: MarkerRef | undefined
365
- if (edge.hasArrowStart) {
366
- startMarker = { id: 'architecture-arrow-start', shape: 'arrow' }
367
- markers += ' marker-start="url(#architecture-arrow-start)"'
368
- }
369
- if (edge.hasArrowEnd) {
370
- endMarker = { id: 'architecture-arrow-end', shape: 'arrow' }
371
- markers += ' marker-end="url(#architecture-arrow-end)"'
372
- }
373
-
374
- const attrs = [
375
- 'class="architecture-edge"',
376
- `data-from="${escapeAttr(edge.source.id)}"`,
377
- `data-to="${escapeAttr(edge.target.id)}"`,
378
- `data-from-side="${edge.source.side}"`,
379
- `data-to-side="${edge.target.side}"`,
380
- `data-from-boundary="${edge.source.boundary}"`,
381
- `data-to-boundary="${edge.target.boundary}"`,
382
- ]
383
- if (edge.label) attrs.push(`data-label="${escapeAttr(edge.label)}"`)
384
-
385
- const paint = { stroke: 'var(--arch-edge-stroke, var(--_line))', strokeWidth: String(visual.edgeLineWidth) }
386
-
387
- if (visual.edgeBendRadius > 0 && edge.points.length > 2) {
388
- const d = pointsToPathD(edge.points, visual.edgeBendRadius)
389
- return marks.connector({
390
- id: sceneId,
391
- role: 'edge',
392
- geometry: { kind: 'path', d, points: edge.points },
393
- lineStyle: 'solid',
394
- paint,
395
- startMarker,
396
- endMarker,
397
- }, `<path ${attrs.join(' ')} d="${d}"${markers} />`)
398
- }
399
- return marks.connector({
400
- id: sceneId,
401
- role: 'edge',
402
- geometry: { kind: 'polyline', points: edge.points },
403
- lineStyle: 'solid',
404
- paint,
405
- startMarker,
406
- endMarker,
407
- }, `<polyline ${attrs.join(' ')} points="${points}"${markers} />`)
408
- }
409
-
410
- function lowerEdgeLabel(edge: PositionedArchitectureEdge, visual: ArchitectureVisualConfig, sceneId: string): SceneNode[] {
411
- const label = applyTextTransform(edge.label!, visual.edgeTextTransform)
412
- const mid = edge.labelPosition ?? edgeMidpoint(edge.points)
413
- const metrics = measureMultilineText(label, visual.edgeFontSize, visual.edgeFontWeight)
414
- const padding = 7
415
-
416
- const crisp = renderMultilineTextWithBackground(
417
- label,
418
- mid.x,
419
- mid.y,
420
- metrics.width,
421
- metrics.height,
422
- visual.edgeFontSize,
423
- padding,
424
- `class="architecture-edge-label-text" text-anchor="middle" font-size="${visual.edgeFontSize}" font-weight="${visual.edgeFontWeight}"${letterAttr(visual.edgeLetterSpacing)}`,
425
- `class="architecture-edge-label-bg" rx="0" ry="0"`,
426
- )
427
- // renderMultilineTextWithBackground emits "<rect bg>\n<text>" — split at the
428
- // single '\n' so the background and text become distinct semantic marks with
429
- // their exact crisp bytes.
430
- const split = crisp.indexOf('\n')
431
- const bgCrisp = crisp.slice(0, split)
432
- const textCrisp = crisp.slice(split + 1)
433
-
434
- const bgWidth = metrics.width + padding * 2
435
- const bgHeight = metrics.height + padding * 2
436
- return [
437
- marks.shape({
438
- id: `${sceneId}:bg`,
439
- role: 'chrome',
440
- geometry: { kind: 'rect', x: mid.x - bgWidth / 2, y: mid.y - bgHeight / 2, width: bgWidth, height: bgHeight, rx: 0, ry: 0 },
441
- paint: {
442
- fill: 'color-mix(in srgb, var(--bg) 90%, var(--_group-hdr))',
443
- stroke: 'color-mix(in srgb, var(--arch-edge-stroke, var(--_line)) 18%, var(--bg))',
444
- strokeWidth: '0.75',
445
- },
446
- }, bgCrisp),
447
- marks.text({
448
- id: sceneId,
449
- role: 'label',
450
- text: label,
451
- x: mid.x,
452
- y: mid.y,
453
- fontSize: visual.edgeFontSize,
454
- anchor: 'middle',
455
- paint: { fill: 'var(--arch-edge-label, var(--_text-muted))' },
456
- }, textCrisp),
457
- ]
458
- }
459
-
460
- function renderIcon(x: number, y: number, size: number, icon: string, compact: boolean): string {
461
- const parts: string[] = []
462
- parts.push(`<g class="architecture-icon" data-icon="${escapeAttr(icon)}">`)
463
- parts.push(` ${renderIconGlyph(x, y, size, icon, compact)}`)
464
- parts.push('</g>')
465
- return parts.join('\n')
466
- }
467
-
468
- function renderIconGlyph(x: number, y: number, size: number, icon: string, compact: boolean): string {
469
- const name = normalizeIconName(icon)
470
- const cx = x + size / 2
471
- const cy = y + size / 2
472
- const s = compact ? size * 0.92 : size
473
-
474
- switch (name) {
475
- case 'cloud':
476
- return [
477
- `<circle class="architecture-icon-mark" cx="${cx - s * 0.18}" cy="${cy + s * 0.02}" r="${s * 0.16}" />`,
478
- `<circle class="architecture-icon-mark" cx="${cx + s * 0.02}" cy="${cy - s * 0.08}" r="${s * 0.2}" />`,
479
- `<circle class="architecture-icon-mark" cx="${cx + s * 0.2}" cy="${cy + s * 0.02}" r="${s * 0.15}" />`,
480
- `<path class="architecture-icon-mark" d="M ${cx - s * 0.34} ${cy + s * 0.16} H ${cx + s * 0.33}" />`,
481
- ].join('\n')
482
- case 'database':
483
- return [
484
- `<ellipse class="architecture-icon-mark" cx="${cx}" cy="${cy - s * 0.16}" rx="${s * 0.24}" ry="${s * 0.1}" />`,
485
- `<path class="architecture-icon-mark" d="M ${cx - s * 0.24} ${cy - s * 0.16} V ${cy + s * 0.2}" />`,
486
- `<path class="architecture-icon-mark" d="M ${cx + s * 0.24} ${cy - s * 0.16} V ${cy + s * 0.2}" />`,
487
- `<ellipse class="architecture-icon-mark" cx="${cx}" cy="${cy + s * 0.02}" rx="${s * 0.24}" ry="${s * 0.1}" />`,
488
- `<ellipse class="architecture-icon-mark" cx="${cx}" cy="${cy + s * 0.2}" rx="${s * 0.24}" ry="${s * 0.1}" />`,
489
- ].join('\n')
490
- case 'disk':
491
- return [
492
- `<circle class="architecture-icon-mark" cx="${cx}" cy="${cy}" r="${s * 0.26}" />`,
493
- `<circle class="architecture-icon-mark" cx="${cx}" cy="${cy}" r="${s * 0.09}" />`,
494
- ].join('\n')
495
- case 'internet':
496
- return [
497
- `<circle class="architecture-icon-mark" cx="${cx}" cy="${cy}" r="${s * 0.26}" />`,
498
- `<path class="architecture-icon-mark" d="M ${cx - s * 0.26} ${cy} H ${cx + s * 0.26}" />`,
499
- `<path class="architecture-icon-mark" d="M ${cx} ${cy - s * 0.26} V ${cy + s * 0.26}" />`,
500
- `<path class="architecture-icon-mark" d="M ${cx - s * 0.14} ${cy - s * 0.22} Q ${cx} ${cy} ${cx - s * 0.14} ${cy + s * 0.22}" />`,
501
- `<path class="architecture-icon-mark" d="M ${cx + s * 0.14} ${cy - s * 0.22} Q ${cx} ${cy} ${cx + s * 0.14} ${cy + s * 0.22}" />`,
502
- ].join('\n')
503
- case 'server':
504
- return [
505
- `<rect class="architecture-icon-mark" x="${cx - s * 0.22}" y="${cy - s * 0.24}" width="${s * 0.44}" height="${s * 0.48}" rx="0" ry="0" />`,
506
- `<path class="architecture-icon-mark" d="M ${cx - s * 0.16} ${cy - s * 0.08} H ${cx + s * 0.16}" />`,
507
- `<path class="architecture-icon-mark" d="M ${cx - s * 0.16} ${cy + s * 0.06} H ${cx + s * 0.16}" />`,
508
- ].join('\n')
509
- default: {
510
- const glyph = fallbackIconGlyph(icon)
511
- return renderMultilineText(
512
- glyph,
513
- cx,
514
- cy,
515
- Math.max(10, size * 0.56),
516
- `class="architecture-icon-glyph" text-anchor="middle" font-size="${Math.max(10, size * 0.56)}" font-weight="700"`,
517
- )
518
- }
519
- }
520
- }
521
-
522
- function normalizeIconName(icon: string): string {
523
- return icon.trim().toLowerCase().split(/[:/]/).pop() ?? icon.trim().toLowerCase()
524
- }
525
-
526
- function fallbackIconGlyph(icon: string): string {
527
- const token = normalizeIconName(icon).replace(/[^a-z0-9]/g, '')
528
- return (token[0] ?? '?').toUpperCase()
529
- }
530
-
531
- function arrowMarkerDefs(): string {
532
- return [
533
- ' <marker id="architecture-arrow-end" markerWidth="8" markerHeight="5" refX="7" refY="2.5" orient="auto">',
534
- ' <polygon points="0 0, 8 2.5, 0 5" fill="var(--arch-edge-stroke, var(--_arrow))" stroke="var(--arch-edge-stroke, var(--_arrow))" stroke-width="0.75" stroke-linejoin="round" />',
535
- ' </marker>',
536
- ' <marker id="architecture-arrow-start" markerWidth="8" markerHeight="5" refX="1" refY="2.5" orient="auto-start-reverse">',
537
- ' <polygon points="8 0, 0 2.5, 8 5" fill="var(--arch-edge-stroke, var(--_arrow))" stroke="var(--arch-edge-stroke, var(--_arrow))" stroke-width="0.75" stroke-linejoin="round" />',
538
- ' </marker>',
539
- ].join('\n')
540
- }
541
-
542
- function edgeMidpoint(points: Point[]): Point {
543
- if (points.length === 0) return { x: 0, y: 0 }
544
- if (points.length === 1) return points[0]!
545
-
546
- let total = 0
547
- for (let i = 1; i < points.length; i++) {
548
- total += segmentLength(points[i - 1]!, points[i]!)
549
- }
550
-
551
- let remaining = total / 2
552
- for (let i = 1; i < points.length; i++) {
553
- const start = points[i - 1]!
554
- const end = points[i]!
555
- const length = segmentLength(start, end)
556
- if (remaining <= length) {
557
- const ratio = length === 0 ? 0 : remaining / length
558
- return {
559
- x: start.x + (end.x - start.x) * ratio,
560
- y: start.y + (end.y - start.y) * ratio,
561
- }
562
- }
563
- remaining -= length
564
- }
565
-
566
- return points[points.length - 1]!
567
- }
568
-
569
- function segmentLength(a: Point, b: Point): number {
570
- return Math.abs(b.x - a.x) + Math.abs(b.y - a.y)
571
- }
572
-
573
- function pointsToPathD(points: Point[], radius: number): string {
574
- if (points.length === 0) return ''
575
- if (points.length === 1) return `M${points[0]!.x},${points[0]!.y}`
576
- const parts = [`M${points[0]!.x},${points[0]!.y}`]
577
- for (let i = 1; i < points.length - 1; i++) {
578
- const prev = points[i - 1]!
579
- const curr = points[i]!
580
- const next = points[i + 1]!
581
- const prevLen = segmentLength(prev, curr)
582
- const nextLen = segmentLength(curr, next)
583
- const r = Math.min(radius, prevLen / 2, nextLen / 2)
584
- if (r <= 0) {
585
- parts.push(`L${curr.x},${curr.y}`)
586
- continue
587
- }
588
- const before = pointToward(curr, prev, r)
589
- const after = pointToward(curr, next, r)
590
- parts.push(`L${before.x},${before.y}`)
591
- parts.push(`Q${curr.x},${curr.y} ${after.x},${after.y}`)
592
- }
593
- const last = points[points.length - 1]!
594
- parts.push(`L${last.x},${last.y}`)
595
- return parts.join(' ')
596
- }
597
-
598
- function pointToward(from: Point, to: Point, distance: number): Point {
599
- const total = segmentLength(from, to)
600
- if (total === 0) return { ...from }
601
- const t = distance / total
602
- return {
603
- x: Math.round((from.x + (to.x - from.x) * t) * 1000) / 1000,
604
- y: Math.round((from.y + (to.y - from.y) * t) * 1000) / 1000,
605
- }
606
- }
607
-
608
- function letterAttr(value: number): string {
609
- return value !== 0 ? ` letter-spacing="${value}"` : ''
610
- }
611
-