agentic-mermaid 0.1.1 → 0.2.0

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 (340) hide show
  1. package/AGENT_NATIVE.md +155 -91
  2. package/CHANGELOG.md +163 -4
  3. package/Instructions_for_agents.md +10 -10
  4. package/LICENSES/Apache-2.0.txt +202 -0
  5. package/README.md +31 -38
  6. package/THIRD_PARTY_NOTICES.md +29 -0
  7. package/assets/hero.png +0 -0
  8. package/dist/agent-core.d.ts +463 -0
  9. package/dist/agent-core.js +397 -0
  10. package/dist/agent.d.ts +73 -1868
  11. package/dist/agent.js +336 -37325
  12. package/dist/agentic-mermaid-mcp.js +7 -38399
  13. package/dist/am.js +33626 -40446
  14. package/dist/chunk-2P5FKUQC.js +3485 -0
  15. package/dist/chunk-2S3VSS6I.js +149 -0
  16. package/dist/chunk-2SILJDW2.js +37 -0
  17. package/dist/chunk-BJYMBT4I.js +61963 -0
  18. package/dist/chunk-FDM43XU7.js +615 -0
  19. package/dist/chunk-MYPDVZCO.js +4702 -0
  20. package/dist/index-DWPa2MJs.d.ts +6780 -0
  21. package/dist/index.d.ts +1 -1
  22. package/dist/index.js +310 -33014
  23. package/dist/mcp-cli-5J47WEY3.js +17 -0
  24. package/docs/README.md +39 -31
  25. package/docs/agent-api-cookbook.md +44 -35
  26. package/docs/agent-mutation-policy.md +1 -1
  27. package/docs/agent-workflow-examples.md +2 -2
  28. package/docs/api.md +284 -77
  29. package/docs/ascii.md +26 -16
  30. package/docs/code-mode-impact.md +214 -0
  31. package/docs/comparison.md +23 -11
  32. package/docs/computational-aesthetics-prototype-plan.md +252 -0
  33. package/docs/config.md +26 -10
  34. package/docs/custom-fonts.md +265 -0
  35. package/docs/custom-style-cookbook.md +130 -9
  36. package/docs/diagram-families.md +48 -23
  37. package/docs/features.md +59 -52
  38. package/docs/fork-differences.md +6 -3
  39. package/docs/getting-started.md +23 -16
  40. package/docs/issue-derived-test-cases.md +29 -22
  41. package/docs/mcp-code-mode-rationale.md +13 -6
  42. package/docs/mcp-http-transport.md +20 -13
  43. package/docs/mermaid-layout-complaints.md +66 -52
  44. package/docs/mutation-testing.md +145 -66
  45. package/docs/quality.md +23 -14
  46. package/docs/react.md +2 -2
  47. package/docs/schemas/style-spec.schema.json +1221 -30
  48. package/docs/style-authoring.md +241 -38
  49. package/docs/svg-semantic-contract.md +49 -0
  50. package/docs/testing-strategy.md +166 -58
  51. package/docs/theming.md +19 -32
  52. package/examples/styles/catalog.json +54 -0
  53. package/examples/styles/cloudflare-workers-inspired-prototype.mmd +9 -0
  54. package/examples/styles/cloudflare-workers-inspired-prototype.style.json +110 -0
  55. package/examples/styles/cupertino-prototype.mmd +10 -0
  56. package/examples/styles/cupertino-prototype.style.json +63 -0
  57. package/examples/styles/mid-century-report.style.json +2 -2
  58. package/examples/styles/star-chart-atlas.style.json +2 -1
  59. package/examples/styles/transit-route-map.style.json +2 -2
  60. package/examples/styles/vercel-inspired-prototype.mmd +6 -0
  61. package/examples/styles/vercel-inspired-prototype.style.json +87 -0
  62. package/package.json +85 -45
  63. package/server.json +2 -2
  64. package/skills/agentic-mermaid-diagram-workflow/SKILL.md +17 -36
  65. package/skills/agentic-mermaid-diagram-workflow/references/cli.md +4 -5
  66. package/skills/agentic-mermaid-diagram-workflow/references/code-mode.md +15 -31
  67. package/skills/agentic-mermaid-diagram-workflow/references/sequence.md +10 -14
  68. package/skills/agentic-mermaid-live-editor/SKILL.md +100 -206
  69. package/TODO.md +0 -684
  70. package/dist/index-wjRjbsP-.d.ts +0 -1102
  71. package/docs/assets/improvements/box-start-connector.png +0 -0
  72. package/docs/assets/improvements/comment-dropped-lint.png +0 -0
  73. package/docs/assets/improvements/er-content-loss.png +0 -0
  74. package/docs/assets/improvements/fan-in-trunks.png +0 -0
  75. package/docs/assets/improvements/gantt-family.png +0 -0
  76. package/docs/assets/improvements/gantt-milestone-clamp.png +0 -0
  77. package/docs/assets/improvements/gantt-verify-seam.png +0 -0
  78. package/docs/assets/improvements/subgraph-container-edges.png +0 -0
  79. package/docs/assets/improvements/wrapper-frontmatter.png +0 -0
  80. package/docs/assets/improvements/wrapper-init-directive.png +0 -0
  81. package/docs/assets/improvements/wrapper-leading-comment.png +0 -0
  82. package/docs/assets/style-cookbook/mid-century-report.png +0 -0
  83. package/docs/assets/style-cookbook/star-chart-atlas.png +0 -0
  84. package/docs/assets/style-cookbook/transit-route-map.png +0 -0
  85. package/docs/contributing/adding-diagram-types.md +0 -144
  86. package/docs/contributing/diagram-family-citizenship.matrix.json +0 -2127
  87. package/docs/contributing/diagram-family-citizenship.md +0 -82
  88. package/docs/contributing/harvesting-upstream-tests.md +0 -126
  89. package/docs/contributing/lessons-learned.md +0 -276
  90. package/docs/contributing/releasing.md +0 -82
  91. package/docs/contributing/visual-review-evidence.md +0 -53
  92. package/docs/design/families/README.md +0 -26
  93. package/docs/design/families/architecture-beta.md +0 -48
  94. package/docs/design/families/flowchart-parser-conformance.md +0 -22
  95. package/docs/design/families/gantt-research.md +0 -137
  96. package/docs/design/families/gantt.md +0 -329
  97. package/docs/design/families/journey-agentic-cards-before.png +0 -0
  98. package/docs/design/families/journey-experience-curve-implementation.png +0 -0
  99. package/docs/design/families/journey-mermaid-classic-implementation.png +0 -0
  100. package/docs/design/families/journey-mermaid-classic-prototype.png +0 -0
  101. package/docs/design/families/journey-mermaid-classic-prototype.svg +0 -163
  102. package/docs/design/families/journey-mermaid-classic-prototype.svg.png +0 -0
  103. package/docs/design/families/journey-migration-parity.md +0 -439
  104. package/docs/design/families/journey-section-overlap-after.png +0 -0
  105. package/docs/design/families/journey-section-overlap-before.png +0 -0
  106. package/docs/design/families/journey-usage-research.md +0 -423
  107. package/docs/design/families/journey.md +0 -153
  108. package/docs/design/families/xychart.md +0 -85
  109. package/docs/design/system/README.md +0 -45
  110. package/docs/design/system/abstraction-audit.md +0 -224
  111. package/docs/design/system/abstraction-recommendations.md +0 -655
  112. package/docs/design/system/architecture.mmd +0 -29
  113. package/docs/design/system/architecture.svg +0 -137
  114. package/docs/design/system/layout-guarantees-and-robustness.md +0 -351
  115. package/docs/design/system/layout-rubric.md +0 -138
  116. package/docs/design/system/route-contracts.md +0 -848
  117. package/docs/design/system/source-preservation-ladder.md +0 -52
  118. package/docs/design/system/styles-rollout.md +0 -216
  119. package/docs/design/system/ugly-layouts.md +0 -119
  120. package/docs/layout-characterization/README.md +0 -245
  121. package/docs/layout-characterization/contact-sheet-families.md +0 -498
  122. package/docs/layout-characterization/contact-sheet.md +0 -638
  123. package/docs/layout-characterization/properties.md +0 -281
  124. package/docs/layout-characterization/visual-quality.md +0 -160
  125. package/docs/layout-characterization/visual-snapshots/architecture.svg +0 -79
  126. package/docs/layout-characterization/visual-snapshots/class.svg +0 -60
  127. package/docs/layout-characterization/visual-snapshots/er.svg +0 -61
  128. package/docs/layout-characterization/visual-snapshots/flowchart.svg +0 -58
  129. package/docs/layout-characterization/visual-snapshots/gantt.svg +0 -52
  130. package/docs/layout-characterization/visual-snapshots/journey.svg +0 -98
  131. package/docs/layout-characterization/visual-snapshots/pie.svg +0 -36
  132. package/docs/layout-characterization/visual-snapshots/quadrant.svg +0 -47
  133. package/docs/layout-characterization/visual-snapshots/sequence.svg +0 -59
  134. package/docs/layout-characterization/visual-snapshots/state.svg +0 -52
  135. package/docs/layout-characterization/visual-snapshots/timeline.svg +0 -64
  136. package/docs/layout-characterization/visual-snapshots/xychart.svg +0 -97
  137. package/docs/project/divergences.md +0 -98
  138. package/docs/project/dogfooding-docs-strategy.md +0 -66
  139. package/docs/project/hosted-mcp-cloudflare-plan.md +0 -338
  140. package/docs/project/lessons-learned.md +0 -1019
  141. package/docs/project/remove-role-styling-plan.md +0 -176
  142. package/examples/agent-improve-auth-flow.ts +0 -206
  143. package/examples/agent-loop.ts +0 -53
  144. package/examples/mcp-vs-cli-complex-diagrams.ts +0 -133
  145. package/llms.txt +0 -104
  146. package/skill-evals/README.md +0 -77
  147. package/skill-evals/fixtures/architecture-cache/input.mmd +0 -5
  148. package/skill-evals/fixtures/class-payment/input.mmd +0 -4
  149. package/skill-evals/fixtures/er-orders/input.mmd +0 -10
  150. package/skill-evals/fixtures/flowchart-cache/input.mmd +0 -3
  151. package/skill-evals/fixtures/gantt-release/input.mmd +0 -7
  152. package/skill-evals/fixtures/journey-checkout/input.mmd +0 -6
  153. package/skill-evals/fixtures/pie-exports/input.mmd +0 -5
  154. package/skill-evals/fixtures/quadrant-priorities/input.mmd +0 -11
  155. package/skill-evals/fixtures/sequence-retry/input.mmd +0 -8
  156. package/skill-evals/fixtures/state-lifecycle/input.mmd +0 -5
  157. package/skill-evals/fixtures/timeline-release/input.mmd +0 -6
  158. package/skill-evals/fixtures/xychart-growth/input.mmd +0 -5
  159. package/skill-evals/shared-benchmark.json +0 -510
  160. package/src/agent/analyze.ts +0 -157
  161. package/src/agent/apply.ts +0 -146
  162. package/src/agent/architecture-body.ts +0 -458
  163. package/src/agent/certificates.ts +0 -110
  164. package/src/agent/class-body.ts +0 -319
  165. package/src/agent/core.ts +0 -207
  166. package/src/agent/create.ts +0 -106
  167. package/src/agent/describe.ts +0 -368
  168. package/src/agent/er-body.ts +0 -224
  169. package/src/agent/facts.ts +0 -360
  170. package/src/agent/families-builtin.ts +0 -920
  171. package/src/agent/families.ts +0 -232
  172. package/src/agent/family-layouts.ts +0 -832
  173. package/src/agent/flowchart-body.ts +0 -372
  174. package/src/agent/flowchart-unsupported.ts +0 -243
  175. package/src/agent/font-coverage.ts +0 -288
  176. package/src/agent/gantt-body.ts +0 -495
  177. package/src/agent/index.ts +0 -10
  178. package/src/agent/journey-body.ts +0 -374
  179. package/src/agent/label-metrics.ts +0 -28
  180. package/src/agent/layout-to-rendered.ts +0 -63
  181. package/src/agent/mutate.ts +0 -97
  182. package/src/agent/mutation-ops.ts +0 -51
  183. package/src/agent/op-schema.ts +0 -443
  184. package/src/agent/parse.ts +0 -223
  185. package/src/agent/pie-body.ts +0 -270
  186. package/src/agent/png.ts +0 -171
  187. package/src/agent/quadrant-body.ts +0 -336
  188. package/src/agent/quality.ts +0 -363
  189. package/src/agent/readability-audit.ts +0 -92
  190. package/src/agent/rendered-route-audit.ts +0 -61
  191. package/src/agent/sequence-body.ts +0 -345
  192. package/src/agent/serialize.ts +0 -214
  193. package/src/agent/state-body.ts +0 -589
  194. package/src/agent/structural-count.ts +0 -150
  195. package/src/agent/timeline-body.ts +0 -280
  196. package/src/agent/trace-log.ts +0 -43
  197. package/src/agent/types.ts +0 -995
  198. package/src/agent/verify.ts +0 -603
  199. package/src/agent/xychart-body.ts +0 -472
  200. package/src/architecture/config.ts +0 -282
  201. package/src/architecture/layout.ts +0 -496
  202. package/src/architecture/parser.ts +0 -375
  203. package/src/architecture/renderer.ts +0 -611
  204. package/src/architecture/types.ts +0 -113
  205. package/src/ascii/ansi.ts +0 -423
  206. package/src/ascii/architecture.ts +0 -210
  207. package/src/ascii/canvas.ts +0 -443
  208. package/src/ascii/class-diagram.ts +0 -697
  209. package/src/ascii/converter.ts +0 -475
  210. package/src/ascii/draw.ts +0 -1693
  211. package/src/ascii/edge-bundling.ts +0 -328
  212. package/src/ascii/edge-routing.ts +0 -330
  213. package/src/ascii/er-diagram.ts +0 -439
  214. package/src/ascii/gantt.ts +0 -276
  215. package/src/ascii/grid.ts +0 -747
  216. package/src/ascii/index.ts +0 -196
  217. package/src/ascii/journey.ts +0 -169
  218. package/src/ascii/meta.ts +0 -244
  219. package/src/ascii/multiline-utils.ts +0 -80
  220. package/src/ascii/pathfinder.ts +0 -301
  221. package/src/ascii/pie.ts +0 -67
  222. package/src/ascii/quadrant.ts +0 -158
  223. package/src/ascii/reverse.ts +0 -216
  224. package/src/ascii/sequence.ts +0 -499
  225. package/src/ascii/shapes/circle.ts +0 -27
  226. package/src/ascii/shapes/corners.ts +0 -143
  227. package/src/ascii/shapes/diamond.ts +0 -27
  228. package/src/ascii/shapes/hexagon.ts +0 -27
  229. package/src/ascii/shapes/index.ts +0 -106
  230. package/src/ascii/shapes/rectangle.ts +0 -168
  231. package/src/ascii/shapes/rounded.ts +0 -27
  232. package/src/ascii/shapes/special.ts +0 -332
  233. package/src/ascii/shapes/stadium.ts +0 -110
  234. package/src/ascii/shapes/state.ts +0 -192
  235. package/src/ascii/shapes/types.ts +0 -73
  236. package/src/ascii/timeline.ts +0 -141
  237. package/src/ascii/types.ts +0 -312
  238. package/src/ascii/validate.ts +0 -120
  239. package/src/ascii/width.ts +0 -81
  240. package/src/ascii/wrap.ts +0 -131
  241. package/src/ascii/xychart.ts +0 -919
  242. package/src/browser.ts +0 -29
  243. package/src/class/layout.ts +0 -240
  244. package/src/class/parser.ts +0 -332
  245. package/src/class/renderer.ts +0 -638
  246. package/src/class/types.ts +0 -129
  247. package/src/cli/agent-instructions.ts +0 -1
  248. package/src/cli/am-bin.ts +0 -6
  249. package/src/cli/exit-codes.ts +0 -18
  250. package/src/cli/index.ts +0 -1132
  251. package/src/cli/init-agent.ts +0 -147
  252. package/src/cli/run-entrypoint.ts +0 -10
  253. package/src/color-resolver.ts +0 -152
  254. package/src/elk-instance.ts +0 -114
  255. package/src/er/layout.ts +0 -187
  256. package/src/er/parser.ts +0 -226
  257. package/src/er/renderer.ts +0 -792
  258. package/src/er/types.ts +0 -99
  259. package/src/family-rubric.ts +0 -425
  260. package/src/font-manifest.ts +0 -31
  261. package/src/gantt/layout.ts +0 -365
  262. package/src/gantt/parser.ts +0 -282
  263. package/src/gantt/pipeline.ts +0 -27
  264. package/src/gantt/renderer.ts +0 -414
  265. package/src/gantt/schedule.ts +0 -513
  266. package/src/gantt/types.ts +0 -255
  267. package/src/index.ts +0 -368
  268. package/src/journey/layout.ts +0 -554
  269. package/src/journey/parse-core.ts +0 -251
  270. package/src/journey/parser.ts +0 -101
  271. package/src/journey/renderer.ts +0 -917
  272. package/src/journey/types.ts +0 -144
  273. package/src/layout/geometry.ts +0 -182
  274. package/src/layout/pass.ts +0 -142
  275. package/src/layout/passes/index.ts +0 -3916
  276. package/src/layout-engine.ts +0 -1565
  277. package/src/layout-rubric.ts +0 -659
  278. package/src/mcp/artifacts.ts +0 -137
  279. package/src/mcp/dynamic-harness.ts +0 -31
  280. package/src/mcp/dynamic-modules.d.ts +0 -7
  281. package/src/mcp/facade.ts +0 -608
  282. package/src/mcp/harness-runtime.ts +0 -203
  283. package/src/mcp/hosted-server.ts +0 -468
  284. package/src/mcp/mcp-bin.ts +0 -3
  285. package/src/mcp/mcp-cli.ts +0 -82
  286. package/src/mcp/protocol.ts +0 -13
  287. package/src/mcp/sandbox.ts +0 -195
  288. package/src/mcp/sdk-decl.ts +0 -391
  289. package/src/mcp/server.ts +0 -362
  290. package/src/mcp/tool-surface.ts +0 -146
  291. package/src/mermaid-source.ts +0 -655
  292. package/src/multiline-utils.ts +0 -228
  293. package/src/parser.ts +0 -1031
  294. package/src/pie/layout.ts +0 -168
  295. package/src/pie/parser.ts +0 -136
  296. package/src/pie/renderer.ts +0 -234
  297. package/src/pie/types.ts +0 -82
  298. package/src/quadrant/layout.ts +0 -191
  299. package/src/quadrant/parser.ts +0 -183
  300. package/src/quadrant/renderer.ts +0 -322
  301. package/src/quadrant/types.ts +0 -113
  302. package/src/render-family-hooks.ts +0 -244
  303. package/src/renderer.ts +0 -1099
  304. package/src/route-contracts.ts +0 -2723
  305. package/src/scene/backend.ts +0 -76
  306. package/src/scene/fidelity.ts +0 -183
  307. package/src/scene/hybrid-backend.ts +0 -174
  308. package/src/scene/ir.ts +0 -181
  309. package/src/scene/marks.ts +0 -127
  310. package/src/scene/rough-backend.ts +0 -378
  311. package/src/scene/seed.ts +0 -46
  312. package/src/scene/style-registry.ts +0 -556
  313. package/src/sequence/layout.ts +0 -456
  314. package/src/sequence/parser.ts +0 -255
  315. package/src/sequence/renderer.ts +0 -604
  316. package/src/sequence/types.ts +0 -154
  317. package/src/shape-clipping.ts +0 -351
  318. package/src/shared/accessibility-directives.ts +0 -22
  319. package/src/shared/batched.ts +0 -61
  320. package/src/shared/color-math.ts +0 -93
  321. package/src/shared/svg-a11y.ts +0 -29
  322. package/src/shared/syntax-error.ts +0 -17
  323. package/src/shared/unicode-ranges.ts +0 -135
  324. package/src/styles.ts +0 -318
  325. package/src/svg-paths.ts +0 -28
  326. package/src/text-metrics.ts +0 -248
  327. package/src/theme.ts +0 -710
  328. package/src/timeline/layout.ts +0 -381
  329. package/src/timeline/parser.ts +0 -215
  330. package/src/timeline/renderer.ts +0 -538
  331. package/src/timeline/types.ts +0 -105
  332. package/src/types.ts +0 -462
  333. package/src/website-worker-modules.d.ts +0 -18
  334. package/src/xychart/axis-utils.ts +0 -109
  335. package/src/xychart/colors.ts +0 -124
  336. package/src/xychart/config.ts +0 -88
  337. package/src/xychart/layout.ts +0 -656
  338. package/src/xychart/parser.ts +0 -504
  339. package/src/xychart/renderer.ts +0 -640
  340. package/src/xychart/types.ts +0 -282
@@ -1,638 +0,0 @@
1
- import type { PositionedClassDiagram, PositionedClassNode, PositionedClassRelationship, ClassMember, RelationshipType } from './types.ts'
2
- import type { RenderContext } from '../types.ts'
3
- import { svgOpenTag, buildStyleBlock, buildShadowDefs } from '../theme.ts'
4
- import { FONT_SIZES, FONT_WEIGHTS, STROKE_WIDTHS, TEXT_BASELINE_SHIFT, applyTextTransform, resolveRenderStyle } from '../styles.ts'
5
- import type { RenderStyleDefaults, ResolvedRenderStyle } from '../styles.ts'
6
- import { CLS, CLASS_STYLE_DEFAULTS } from './layout.ts'
7
- import { buildAccessibilityAttrs } from '../shared/svg-a11y.ts'
8
- import { renderMultilineText, escapeAttr, escapeXml as escapeXmlUtil } from '../multiline-utils.ts'
9
- import { topRoundedRectPath } from '../svg-paths.ts'
10
- import type { MarkerRef, SceneDoc, SceneNode } from '../scene/ir.ts'
11
- import { hashId } from '../scene/seed.ts'
12
- import * as marks from '../scene/marks.ts'
13
- import { DefaultBackend } from '../scene/backend.ts'
14
-
15
- // ============================================================================
16
- // Class diagram SVG renderer
17
- //
18
- // The positioned diagram is first lowered to a SceneGraph (SPEC §3.1): every
19
- // visual mark becomes a scene node carrying semantic fields (role, geometry,
20
- // paint, stable id) plus its exact crisp serialization, built here from the
21
- // same inputs. renderClassSvg() is DefaultBackend serialization of that scene,
22
- // so the default path stays byte-identical to the historical string renderer
23
- // (corpus-gated by svg-equivalence.test.ts).
24
- //
25
- // All colors use CSS custom properties (var(--_xxx)) from the theme system.
26
- //
27
- // Render order:
28
- // 1. Relationship lines (behind boxes)
29
- // 2. Class boxes (header + attributes + methods compartments)
30
- // 3. Relationship endpoint markers (diamonds, triangles)
31
- // 4. Labels and cardinality
32
- // ============================================================================
33
-
34
-
35
- /** Font sizes specific to class diagrams */
36
- const CLS_FONT = {
37
- memberSize: 11,
38
- memberWeight: 400,
39
- annotationSize: 10,
40
- annotationWeight: 500,
41
- } as const
42
-
43
- /**
44
- * Render a positioned class diagram as an SVG string.
45
- *
46
- * @param colors - DiagramColors with bg/fg and optional enrichment variables.
47
- * @param transparent - If true, renders with transparent background.
48
- */
49
- export function renderClassSvg(
50
- ctx: RenderContext<PositionedClassDiagram>,
51
- ): string {
52
- return DefaultBackend.render(lowerClassScene(ctx), { seed: 0 })
53
- }
54
-
55
- /**
56
- * Lower a positioned class diagram to the SceneGraph IR. Mark order matches
57
- * the historical parts[] order exactly; DefaultBackend joins crisps with '\n'.
58
- */
59
- export function lowerClassScene(
60
- ctx: RenderContext<PositionedClassDiagram>,
61
- ): SceneDoc {
62
- const { positioned: diagram, colors, options } = ctx
63
- const font = colors.font ?? 'Inter'
64
- const transparent = options.transparent ?? false
65
- const parts: SceneNode[] = []
66
- const style = resolveRenderStyle(options, CLASS_STYLE_DEFAULTS)
67
- const uid = `class-${hashId(diagram.width, diagram.height, diagram.classes.length, diagram.relationships.length)}`
68
- const titleId = `${uid}-title`
69
- const descId = `${uid}-desc`
70
- const rootAttrs = buildAccessibilityAttrs(diagram.accessibilityTitle, diagram.accessibilityDescription, titleId, descId)
71
-
72
- // SVG root with CSS variables + style block (with mono font) + defs
73
- parts.push(marks.prelude(
74
- {
75
- id: 'prelude',
76
- width: diagram.width,
77
- height: diagram.height,
78
- colors,
79
- transparent,
80
- font,
81
- hasMonoFont: true,
82
- },
83
- svgOpenTag(diagram.width, diagram.height, colors, transparent, rootAttrs) + '\n' +
84
- buildStyleBlock(font, true, colors.shadow, colors.embedFontImport),
85
- ))
86
- const defsParts: string[] = []
87
- defsParts.push('<defs>')
88
- defsParts.push(relationshipMarkerDefs(style))
89
- const shadowDefs = buildShadowDefs(colors)
90
- if (shadowDefs) defsParts.push(shadowDefs)
91
- defsParts.push('</defs>')
92
- parts.push(marks.raw({ id: 'defs', role: 'defs' }, defsParts.join('\n')))
93
-
94
- if (diagram.accessibilityTitle) {
95
- parts.push(marks.raw({ id: 'title', role: 'chrome' }, `<title id="${titleId}">${escapeXml(diagram.accessibilityTitle)}</title>`))
96
- }
97
- if (diagram.accessibilityDescription) {
98
- parts.push(marks.raw({ id: 'desc', role: 'chrome' }, `<desc id="${descId}">${escapeXml(diagram.accessibilityDescription)}</desc>`))
99
- }
100
-
101
- // 1. Relationship lines (rendered behind boxes)
102
- const relOccurrence = new Map<string, number>()
103
- for (const rel of diagram.relationships) {
104
- const pairKey = `${rel.from}->${rel.to}`
105
- const k = relOccurrence.get(pairKey) ?? 0
106
- relOccurrence.set(pairKey, k + 1)
107
- parts.push(renderRelationship(rel, style, `rel:${pairKey}#${k}`))
108
- }
109
-
110
- // 2. Class boxes
111
- for (const cls of diagram.classes) {
112
- parts.push(renderClassBox(cls, style))
113
- }
114
-
115
- // 3. Relationship labels and cardinality
116
- const labelOccurrence = new Map<string, number>()
117
- for (const rel of diagram.relationships) {
118
- const pairKey = `${rel.from}->${rel.to}`
119
- const k = labelOccurrence.get(pairKey) ?? 0
120
- labelOccurrence.set(pairKey, k + 1)
121
- parts.push(...renderRelationshipLabels(rel, style, `${pairKey}#${k}`))
122
- }
123
-
124
- parts.push(marks.raw({ id: 'svg-close', role: 'chrome' }, '</svg>'))
125
-
126
- return { family: 'class', width: diagram.width, height: diagram.height, colors, parts }
127
- }
128
-
129
- // ============================================================================
130
- // Marker definitions
131
- // ============================================================================
132
-
133
- /**
134
- * Marker definitions for class relationship endpoints.
135
- * Each relationship type has a distinct marker:
136
- * - inheritance: hollow triangle
137
- * - composition: filled diamond
138
- * - aggregation: hollow diamond
139
- * - association: open arrow (simple >)
140
- * - dependency: open arrow (simple >)
141
- * - realization: hollow triangle (same as inheritance)
142
- *
143
- * Uses var(--_arrow) for fill/stroke and var(--bg) for hollow marker fills.
144
- */
145
- function relationshipMarkerDefs(style: ResolvedRenderStyle): string {
146
- const edgeColor = escapeAttr(style.edgeStrokeColor ?? 'var(--_arrow)')
147
- return (
148
- // Hollow triangle (inheritance, realization) — points at target
149
- ` <marker id="cls-inherit" markerWidth="12" markerHeight="10" refX="12" refY="5" orient="auto-start-reverse">` +
150
- `\n <polygon points="0 0, 12 5, 0 10" fill="var(--bg)" stroke="${edgeColor}" stroke-width="1.5" />` +
151
- `\n </marker>` +
152
- // Filled diamond (composition) — points at source
153
- `\n <marker id="cls-composition" markerWidth="12" markerHeight="10" refX="0" refY="5" orient="auto-start-reverse">` +
154
- `\n <polygon points="6 0, 12 5, 6 10, 0 5" fill="${edgeColor}" stroke="${edgeColor}" stroke-width="1" />` +
155
- `\n </marker>` +
156
- // Hollow diamond (aggregation) — points at source
157
- `\n <marker id="cls-aggregation" markerWidth="12" markerHeight="10" refX="0" refY="5" orient="auto-start-reverse">` +
158
- `\n <polygon points="6 0, 12 5, 6 10, 0 5" fill="var(--bg)" stroke="${edgeColor}" stroke-width="1.5" />` +
159
- `\n </marker>` +
160
- // Open arrow (association, dependency)
161
- `\n <marker id="cls-arrow" markerWidth="8" markerHeight="6" refX="8" refY="3" orient="auto-start-reverse">` +
162
- `\n <polyline points="0 0, 8 3, 0 6" fill="none" stroke="${edgeColor}" stroke-width="1.5" />` +
163
- `\n </marker>`
164
- )
165
- }
166
-
167
- // ============================================================================
168
- // Class box rendering
169
- // ============================================================================
170
-
171
- /**
172
- * Render a class box with 3 compartments: header, attributes, methods.
173
- * Wrapped in <g class="class-node"> with semantic data attributes.
174
- */
175
- function renderClassBox(cls: PositionedClassNode, style: ResolvedRenderStyle): SceneNode {
176
- const { x, y, width, height, headerHeight, attrHeight } = cls
177
- const children: Array<{ node: SceneNode; indent: number }> = []
178
-
179
- // Semantic wrapper with class metadata
180
- // data-id: class identifier
181
- // data-label: class name
182
- // data-annotation: stereotype (interface, abstract, etc.)
183
- const annotationAttr = cls.annotation ? ` data-annotation="${escapeAttr(cls.annotation)}"` : ''
184
- const open =
185
- `<g class="class-node" data-id="${escapeAttr(cls.id)}" data-label="${escapeAttr(cls.label)}"${annotationAttr}>`
186
-
187
- // Outer rectangle (full box)
188
- const boxFill = style.nodeFillColor ?? 'var(--_node-fill)'
189
- const boxStroke = style.nodeBorderColor ?? 'var(--_node-stroke)'
190
- children.push({
191
- indent: 2,
192
- node: marks.shape({
193
- id: `class:${cls.id}:box`,
194
- role: 'class-box',
195
- geometry: { kind: 'rect', x, y, width, height, rx: style.cornerRadius ?? 0, ry: style.cornerRadius ?? 0 },
196
- paint: { fill: boxFill, stroke: boxStroke, strokeWidth: String(style.nodeLineWidth) },
197
- },
198
- `<rect x="${x}" y="${y}" width="${width}" height="${height}" ` +
199
- `rx="${style.cornerRadius ?? 0}" ry="${style.cornerRadius ?? 0}" fill="${escapeAttr(boxFill)}" stroke="${escapeAttr(boxStroke)}" stroke-width="${style.nodeLineWidth}" />`),
200
- })
201
-
202
- // Header background
203
- const headerFill = style.groupHeaderFillColor ?? 'var(--_group-hdr)'
204
- const headerPath = topRoundedRectPath(x, y, width, headerHeight, style.cornerRadius ?? 0)
205
- children.push({
206
- indent: 2,
207
- node: marks.shape({
208
- id: `class:${cls.id}:header`,
209
- role: 'group-header',
210
- geometry: { kind: 'path', d: headerPath },
211
- paint: { fill: headerFill, stroke: boxStroke, strokeWidth: String(style.nodeLineWidth) },
212
- },
213
- `<path d="${headerPath}" ` +
214
- `fill="${escapeAttr(headerFill)}" stroke="${escapeAttr(boxStroke)}" stroke-width="${style.nodeLineWidth}" />`),
215
- })
216
-
217
- // Annotation (<<interface>>, <<abstract>>, etc.)
218
- let nameY = y + headerHeight / 2
219
- if (cls.annotation) {
220
- const annotY = y + 12
221
- const annotColor = style.nodeTextColor ?? 'var(--_text-muted)'
222
- children.push({
223
- indent: 2,
224
- node: marks.text({
225
- id: `class:${cls.id}:annotation`,
226
- role: 'label',
227
- text: `<<${cls.annotation}>>`,
228
- x: x + width / 2,
229
- y: annotY,
230
- fontSize: CLS_FONT.annotationSize,
231
- anchor: 'middle',
232
- paint: { fill: annotColor },
233
- },
234
- `<text x="${x + width / 2}" y="${annotY}" text-anchor="middle" dy="${TEXT_BASELINE_SHIFT}" ` +
235
- `font-size="${CLS_FONT.annotationSize}" font-weight="${CLS_FONT.annotationWeight}" ` +
236
- `font-style="italic" fill="${escapeAttr(annotColor)}">&lt;&lt;${escapeXml(cls.annotation)}&gt;&gt;</text>`),
237
- })
238
- nameY = y + headerHeight / 2 + 6
239
- }
240
-
241
- // Class name (supports multi-line via <br> tags)
242
- const nameColor = style.nodeTextColor ?? 'var(--_text)'
243
- const label = applyTextTransform(cls.label, style.nodeTextTransform)
244
- children.push({
245
- indent: 2,
246
- node: marks.text({
247
- id: `class:${cls.id}:name`,
248
- role: 'label',
249
- text: label,
250
- x: x + width / 2,
251
- y: nameY,
252
- fontSize: style.nodeLabelFontSize,
253
- anchor: 'middle',
254
- paint: { fill: nameColor },
255
- }, renderMultilineText(
256
- label,
257
- x + width / 2,
258
- nameY,
259
- style.nodeLabelFontSize,
260
- `text-anchor="middle" font-size="${style.nodeLabelFontSize}" font-weight="${style.nodeLabelFontWeight}"${letterAttr(style.nodeLetterSpacing)} fill="${escapeAttr(nameColor)}"`
261
- )),
262
- })
263
-
264
- // Divider line between header and attributes
265
- const attrTop = y + headerHeight
266
- children.push({ indent: 2, node: renderDivider(cls.id, 'attrs', x, attrTop, width, style) })
267
-
268
- // Attributes
269
- const memberRowH = 20
270
- for (let i = 0; i < cls.attributes.length; i++) {
271
- const member = cls.attributes[i]!
272
- const memberY = attrTop + 4 + i * memberRowH + memberRowH / 2
273
- children.push({ indent: 2, node: renderMember(member, x + style.nodePaddingX, memberY, style, `member:${cls.id}:${member.name}`) })
274
- }
275
-
276
- // Divider line between attributes and methods
277
- const methodTop = attrTop + attrHeight
278
- children.push({ indent: 2, node: renderDivider(cls.id, 'methods', x, methodTop, width, style) })
279
-
280
- // Methods
281
- for (let i = 0; i < cls.methods.length; i++) {
282
- const member = cls.methods[i]!
283
- const memberY = methodTop + 4 + i * memberRowH + memberRowH / 2
284
- children.push({ indent: 2, node: renderMember(member, x + style.nodePaddingX, memberY, style, `member:${cls.id}:${member.name}`) })
285
- }
286
-
287
- return marks.group({
288
- id: `class:${cls.id}`,
289
- role: 'class-box',
290
- open,
291
- close: '</g>',
292
- children,
293
- })
294
- }
295
-
296
- /** Compartment divider line (header/attributes and attributes/methods). */
297
- function renderDivider(clsId: string, which: 'attrs' | 'methods', x: number, lineY: number, width: number, style: ResolvedRenderStyle): SceneNode {
298
- const stroke = style.nodeBorderColor ?? 'var(--_node-stroke)'
299
- const strokeWidth = Math.min(style.nodeLineWidth, STROKE_WIDTHS.innerBox)
300
- return marks.shape({
301
- id: `class:${clsId}:divider:${which}`,
302
- role: 'chrome',
303
- geometry: { kind: 'line', x1: x, y1: lineY, x2: x + width, y2: lineY },
304
- paint: { stroke, strokeWidth: String(strokeWidth) },
305
- },
306
- `<line x1="${x}" y1="${lineY}" x2="${x + width}" y2="${lineY}" ` +
307
- `stroke="${escapeAttr(stroke)}" stroke-width="${strokeWidth}" />`)
308
- }
309
-
310
- /**
311
- * Render a single class member with syntax highlighting.
312
- * Uses <tspan> elements to color each part of the member differently:
313
- * - visibility symbol (+/-/#/~) → textFaint
314
- * - member name (incl. parens for methods) → textSecondary
315
- * - colon separator → textFaint
316
- * - type annotation → textMuted
317
- */
318
- function renderMember(member: ClassMember, x: number, y: number, style: ResolvedRenderStyle, sceneId: string): SceneNode {
319
- const fontStyle = member.isAbstract ? ' font-style="italic"' : ''
320
- const decoration = member.isStatic ? ' text-decoration="underline"' : ''
321
-
322
- // Build tspan parts for syntax-highlighted member text
323
- const spans: string[] = []
324
-
325
- if (member.visibility) {
326
- spans.push(`<tspan fill="var(--_text-faint)">${escapeXml(member.visibility)} </tspan>`)
327
- }
328
-
329
- // Add parentheses for methods to distinguish from attributes, including parameters if present
330
- const displayName = member.isMethod
331
- ? `${member.name}(${member.params || ''})`
332
- : member.name
333
- spans.push(`<tspan fill="${escapeAttr(style.nodeTextColor ?? 'var(--_text-sec)')}">${escapeXml(displayName)}</tspan>`)
334
-
335
- if (member.type) {
336
- spans.push(`<tspan fill="var(--_text-faint)">: </tspan>`)
337
- spans.push(`<tspan fill="var(--_text-muted)">${escapeXml(member.type)}</tspan>`)
338
- }
339
-
340
- // Plain signature string (the tspan structure lives in the crisp)
341
- const plain =
342
- `${member.visibility ? `${member.visibility} ` : ''}${displayName}${member.type ? `: ${member.type}` : ''}`
343
-
344
- return marks.text({
345
- id: sceneId,
346
- role: 'member',
347
- text: plain,
348
- x,
349
- y,
350
- fontSize: CLS_FONT.memberSize,
351
- anchor: 'start',
352
- paint: { fill: style.nodeTextColor ?? 'var(--_text-sec)' },
353
- },
354
- `<text x="${x}" y="${y}" class="mono" dy="${TEXT_BASELINE_SHIFT}" ` +
355
- `font-size="${CLS_FONT.memberSize}" font-weight="${CLS_FONT.memberWeight}"${fontStyle}${decoration}>` +
356
- `${spans.join('')}</text>`)
357
- }
358
-
359
- // ============================================================================
360
- // Relationship rendering
361
- // ============================================================================
362
-
363
- /**
364
- * Render a relationship line with appropriate markers and semantic attributes.
365
- * Includes data-* attributes for programmatic inspection.
366
- */
367
- function renderRelationship(rel: PositionedClassRelationship, style: ResolvedRenderStyle, sceneId: string): SceneNode {
368
- if (rel.points.length < 2) {
369
- // Degenerate relationship — draws nothing (crisp '', like the old '' part).
370
- return marks.connector({
371
- id: sceneId,
372
- role: 'relationship',
373
- geometry: { kind: 'polyline', points: rel.points },
374
- lineStyle: 'invisible',
375
- paint: {},
376
- }, '')
377
- }
378
-
379
- const pathData = rel.points.map(p => `${p.x},${p.y}`).join(' ')
380
- const isDashed = rel.type === 'dependency' || rel.type === 'realization'
381
- const dashArray = isDashed ? ' stroke-dasharray="6 4"' : ''
382
- const lineStyle = isDashed ? 'dashed' : 'solid'
383
-
384
- // Determine markers based on relationship type and which end has the marker
385
- const markers = getRelationshipMarkers(rel.type, rel.markerAt)
386
- const markerId = getMarkerDefId(rel.type)
387
- const markerRef: MarkerRef | undefined = markerId ? { id: markerId, shape: markerShapeFor(markerId) } : undefined
388
- const startMarker = rel.markerAt === 'from' ? markerRef : undefined
389
- const endMarker = rel.markerAt === 'to' ? markerRef : undefined
390
-
391
- // Build semantic data attributes for relationship inspection:
392
- // - class="class-relationship": CSS targeting
393
- // - data-from/data-to: source and target class IDs
394
- // - data-type: relationship type (inheritance, composition, etc.)
395
- // - data-marker-at: which end has the marker (from/to)
396
- // - data-from-cardinality/data-to-cardinality: multiplicity if present
397
- // - data-label: relationship label if present
398
- const dataAttrs = [
399
- 'class="class-relationship"',
400
- `data-from="${escapeAttr(rel.from)}"`,
401
- `data-to="${escapeAttr(rel.to)}"`,
402
- `data-type="${rel.type}"`,
403
- `data-marker-at="${rel.markerAt}"`,
404
- ]
405
- if (rel.label) {
406
- dataAttrs.push(`data-label="${escapeAttr(rel.label)}"`)
407
- }
408
- if (rel.fromCardinality) {
409
- dataAttrs.push(`data-from-cardinality="${escapeAttr(rel.fromCardinality)}"`)
410
- }
411
- if (rel.toCardinality) {
412
- dataAttrs.push(`data-to-cardinality="${escapeAttr(rel.toCardinality)}"`)
413
- }
414
-
415
- const strokeColor = style.edgeStrokeColor ?? 'var(--_line)'
416
- const paint = {
417
- stroke: strokeColor,
418
- strokeWidth: String(style.lineWidth),
419
- ...(isDashed ? { strokeDasharray: '6 4' } : {}),
420
- }
421
-
422
- if (style.edgeBendRadius > 0 && rel.points.length > 2) {
423
- const d = pointsToPathD(rel.points, style.edgeBendRadius)
424
- return marks.connector({
425
- id: sceneId,
426
- role: 'relationship',
427
- geometry: { kind: 'path', d, points: rel.points },
428
- lineStyle,
429
- paint,
430
- startMarker,
431
- endMarker,
432
- },
433
- `<path ${dataAttrs.join(' ')} d="${d}" fill="none" stroke="${escapeAttr(strokeColor)}" ` +
434
- `stroke-width="${style.lineWidth}"${dashArray}${markers} />`)
435
- }
436
-
437
- return marks.connector({
438
- id: sceneId,
439
- role: 'relationship',
440
- geometry: { kind: 'polyline', points: rel.points },
441
- lineStyle,
442
- paint,
443
- startMarker,
444
- endMarker,
445
- },
446
- `<polyline ${dataAttrs.join(' ')} points="${pathData}" fill="none" stroke="${escapeAttr(strokeColor)}" ` +
447
- `stroke-width="${style.lineWidth}"${dashArray}${markers} />`)
448
- }
449
-
450
- /**
451
- * Get marker-start/marker-end attributes for a relationship type.
452
- * Uses `markerAt` from the parser to place the marker on the correct end:
453
- * - 'from' → marker-start (prefix arrows like `<|--`, `*--`, `o--`)
454
- * - 'to' → marker-end (suffix arrows like `..|>`, `-->`, `--*`)
455
- */
456
- function getRelationshipMarkers(type: RelationshipType, markerAt: 'from' | 'to'): string {
457
- const markerId = getMarkerDefId(type)
458
- if (!markerId) return ''
459
-
460
- if (markerAt === 'from') {
461
- return ` marker-start="url(#${markerId})"`
462
- } else {
463
- return ` marker-end="url(#${markerId})"`
464
- }
465
- }
466
-
467
- /** Map relationship type to its SVG marker definition ID */
468
- function getMarkerDefId(type: RelationshipType): string | null {
469
- switch (type) {
470
- case 'inheritance':
471
- case 'realization':
472
- return 'cls-inherit'
473
- case 'composition':
474
- return 'cls-composition'
475
- case 'aggregation':
476
- return 'cls-aggregation'
477
- case 'association':
478
- case 'dependency':
479
- return 'cls-arrow'
480
- default:
481
- return null
482
- }
483
- }
484
-
485
- /** Map a marker def ID to its MarkerRef archetype for styled backends. */
486
- function markerShapeFor(markerId: string): MarkerRef['shape'] {
487
- switch (markerId) {
488
- case 'cls-inherit':
489
- return 'triangle'
490
- case 'cls-composition':
491
- return 'diamond'
492
- case 'cls-aggregation':
493
- return 'diamond-open'
494
- default:
495
- return 'open-arrow'
496
- }
497
- }
498
-
499
- /** Render relationship labels and cardinality text (supports multi-line).
500
- * Returns one text mark per label/cardinality; when the relationship has
501
- * none, a single empty mark keeps the historical '' part (blank line). */
502
- function renderRelationshipLabels(rel: PositionedClassRelationship, style: ResolvedRenderStyle, key: string): SceneNode[] {
503
- if ((!rel.label && !rel.fromCardinality && !rel.toCardinality) || rel.points.length < 2) {
504
- return [marks.raw({ id: `rel-labels:${key}`, role: 'chrome' }, '')]
505
- }
506
-
507
- const out: SceneNode[] = []
508
- const textColor = style.edgeTextColor ?? 'var(--_text-muted)'
509
- const textAttrs =
510
- `font-size="${style.edgeLabelFontSize}" text-anchor="middle" font-weight="${style.edgeLabelFontWeight}"${letterAttr(style.edgeLetterSpacing)} fill="${escapeAttr(textColor)}"`
511
-
512
- // Label — prefer layout-computed position (collision-aware), fall back to midpoint
513
- if (rel.label) {
514
- const pos = rel.labelPosition ?? midpoint(rel.points)
515
- const label = applyTextTransform(rel.label, style.edgeTextTransform)
516
- out.push(marks.text({
517
- id: `rel-label:${key}`,
518
- role: 'label',
519
- text: label,
520
- x: pos.x,
521
- y: pos.y - 8,
522
- fontSize: style.edgeLabelFontSize,
523
- anchor: 'middle',
524
- paint: { fill: textColor },
525
- }, renderMultilineText(label, pos.x, pos.y - 8, style.edgeLabelFontSize, textAttrs)))
526
- }
527
-
528
- // From cardinality (near start)
529
- if (rel.fromCardinality) {
530
- const p = rel.points[0]!
531
- const next = rel.points[1]!
532
- const offset = cardinalityOffset(p, next)
533
- out.push(marks.text({
534
- id: `rel-card:${key}:from`,
535
- role: 'cardinality',
536
- text: rel.fromCardinality,
537
- x: p.x + offset.x,
538
- y: p.y + offset.y,
539
- fontSize: style.edgeLabelFontSize,
540
- anchor: 'middle',
541
- paint: { fill: textColor },
542
- }, renderMultilineText(rel.fromCardinality, p.x + offset.x, p.y + offset.y, style.edgeLabelFontSize, textAttrs)))
543
- }
544
-
545
- // To cardinality (near end)
546
- if (rel.toCardinality) {
547
- const p = rel.points[rel.points.length - 1]!
548
- const prev = rel.points[rel.points.length - 2]!
549
- const offset = cardinalityOffset(p, prev)
550
- out.push(marks.text({
551
- id: `rel-card:${key}:to`,
552
- role: 'cardinality',
553
- text: rel.toCardinality,
554
- x: p.x + offset.x,
555
- y: p.y + offset.y,
556
- fontSize: style.edgeLabelFontSize,
557
- anchor: 'middle',
558
- paint: { fill: textColor },
559
- }, renderMultilineText(rel.toCardinality, p.x + offset.x, p.y + offset.y, style.edgeLabelFontSize, textAttrs)))
560
- }
561
-
562
- return out
563
- }
564
-
565
- function pointsToPathD(points: Array<{ x: number; y: number }>, radius: number): string {
566
- if (points.length === 0) return ''
567
- if (points.length === 1) return `M${points[0]!.x},${points[0]!.y}`
568
- const parts = [`M${points[0]!.x},${points[0]!.y}`]
569
- for (let i = 1; i < points.length - 1; i++) {
570
- const prev = points[i - 1]!
571
- const curr = points[i]!
572
- const next = points[i + 1]!
573
- const prevLen = Math.abs(curr.x - prev.x) + Math.abs(curr.y - prev.y)
574
- const nextLen = Math.abs(next.x - curr.x) + Math.abs(next.y - curr.y)
575
- const r = Math.min(radius, prevLen / 2, nextLen / 2)
576
- if (r <= 0) {
577
- parts.push(`L${curr.x},${curr.y}`)
578
- continue
579
- }
580
- const before = pointToward(curr, prev, r)
581
- const after = pointToward(curr, next, r)
582
- parts.push(`L${before.x},${before.y}`)
583
- parts.push(`Q${curr.x},${curr.y} ${after.x},${after.y}`)
584
- }
585
- const last = points[points.length - 1]!
586
- parts.push(`L${last.x},${last.y}`)
587
- return parts.join(' ')
588
- }
589
-
590
- function pointToward(from: { x: number; y: number }, to: { x: number; y: number }, distance: number): { x: number; y: number } {
591
- const total = Math.abs(to.x - from.x) + Math.abs(to.y - from.y)
592
- if (total === 0) return { ...from }
593
- const t = distance / total
594
- return {
595
- x: Math.round((from.x + (to.x - from.x) * t) * 1000) / 1000,
596
- y: Math.round((from.y + (to.y - from.y) * t) * 1000) / 1000,
597
- }
598
- }
599
-
600
- /** Get the midpoint of a point array */
601
- function midpoint(points: Array<{ x: number; y: number }>): { x: number; y: number } {
602
- if (points.length === 0) return { x: 0, y: 0 }
603
- const mid = Math.floor(points.length / 2)
604
- return points[mid]!
605
- }
606
-
607
- /** Calculate offset for cardinality label perpendicular to edge direction */
608
- function cardinalityOffset(
609
- from: { x: number; y: number },
610
- to: { x: number; y: number }
611
- ): { x: number; y: number } {
612
- const dx = to.x - from.x
613
- const dy = to.y - from.y
614
- // Place label perpendicular to the edge, 14px away
615
- if (Math.abs(dx) > Math.abs(dy)) {
616
- // Mostly horizontal — offset vertically
617
- return { x: dx > 0 ? 14 : -14, y: -10 }
618
- }
619
- // Mostly vertical — offset horizontally
620
- return { x: -14, y: dy > 0 ? 14 : -14 }
621
- }
622
-
623
- // ============================================================================
624
- // Utilities
625
- // ============================================================================
626
-
627
- function letterAttr(value: number): string {
628
- return value !== 0 ? ` letter-spacing="${value}"` : ''
629
- }
630
-
631
- // Use shared escapeXml from multiline-utils
632
- const escapeXml = escapeXmlUtil
633
-
634
-
635
- /**
636
- * Escape a string for use as an XML/HTML attribute value.
637
- * Escapes quotes and ampersands to prevent attribute injection.
638
- */