agentic-mermaid 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (333) hide show
  1. package/CHANGELOG.md +149 -4
  2. package/LICENSES/Apache-2.0.txt +202 -0
  3. package/README.md +25 -32
  4. package/THIRD_PARTY_NOTICES.md +29 -0
  5. package/assets/fonts/FONT-LICENSES.md +9 -5
  6. package/assets/fonts/Inter-Bold.ttf +0 -0
  7. package/assets/fonts/Inter-Medium.ttf +0 -0
  8. package/assets/fonts/Inter-Regular.ttf +0 -0
  9. package/assets/fonts/Inter-SemiBold.ttf +0 -0
  10. package/dist/agent-core.d.ts +463 -0
  11. package/dist/agent-core.js +397 -0
  12. package/dist/agent.d.ts +81 -1822
  13. package/dist/agent.js +336 -36839
  14. package/dist/agentic-mermaid-mcp.js +7 -37908
  15. package/dist/am.js +33638 -36261
  16. package/dist/chunk-4QECACIA.js +4702 -0
  17. package/dist/chunk-CDPKJ2BQ.js +37 -0
  18. package/dist/chunk-QKDLMOJJ.js +3487 -0
  19. package/dist/chunk-WI35L7IR.js +615 -0
  20. package/dist/chunk-WN3YDOBG.js +149 -0
  21. package/dist/chunk-ZYMMKQ3I.js +62637 -0
  22. package/dist/index-D54dqSdC.d.ts +6777 -0
  23. package/dist/index.d.ts +1 -1
  24. package/dist/index.js +310 -32836
  25. package/dist/mcp-cli-SBQSTJFC.js +17 -0
  26. package/docs/README.md +14 -6
  27. package/docs/schemas/style-spec.schema.json +1221 -30
  28. package/examples/styles/catalog.json +54 -0
  29. package/examples/styles/cloudflare-workers-inspired-prototype.mmd +9 -0
  30. package/examples/styles/cloudflare-workers-inspired-prototype.style.json +110 -0
  31. package/examples/styles/cupertino-prototype.mmd +10 -0
  32. package/examples/styles/cupertino-prototype.style.json +63 -0
  33. package/examples/styles/mid-century-report.style.json +2 -2
  34. package/examples/styles/star-chart-atlas.style.json +2 -1
  35. package/examples/styles/transit-route-map.style.json +2 -2
  36. package/examples/styles/vercel-inspired-prototype.mmd +6 -0
  37. package/examples/styles/vercel-inspired-prototype.style.json +87 -0
  38. package/package.json +70 -43
  39. package/server.json +41 -0
  40. package/skills/agentic-mermaid-diagram-workflow/SKILL.md +17 -36
  41. package/skills/agentic-mermaid-diagram-workflow/references/cli.md +4 -5
  42. package/skills/agentic-mermaid-diagram-workflow/references/code-mode.md +15 -31
  43. package/skills/agentic-mermaid-diagram-workflow/references/sequence.md +10 -14
  44. package/skills/agentic-mermaid-live-editor/SKILL.md +100 -206
  45. package/AGENT_NATIVE.md +0 -602
  46. package/Instructions_for_agents.md +0 -83
  47. package/TODO.md +0 -662
  48. package/assets/hero.png +0 -0
  49. package/dist/index-x2Cj1dVv.d.ts +0 -1089
  50. package/docs/agent-api-cookbook.md +0 -308
  51. package/docs/agent-mutation-policy.md +0 -104
  52. package/docs/agent-workflow-examples.md +0 -46
  53. package/docs/api.md +0 -203
  54. package/docs/ascii.md +0 -103
  55. package/docs/assets/improvements/box-start-connector.png +0 -0
  56. package/docs/assets/improvements/comment-dropped-lint.png +0 -0
  57. package/docs/assets/improvements/er-content-loss.png +0 -0
  58. package/docs/assets/improvements/fan-in-trunks.png +0 -0
  59. package/docs/assets/improvements/gantt-family.png +0 -0
  60. package/docs/assets/improvements/gantt-milestone-clamp.png +0 -0
  61. package/docs/assets/improvements/gantt-verify-seam.png +0 -0
  62. package/docs/assets/improvements/subgraph-container-edges.png +0 -0
  63. package/docs/assets/improvements/wrapper-frontmatter.png +0 -0
  64. package/docs/assets/improvements/wrapper-init-directive.png +0 -0
  65. package/docs/assets/improvements/wrapper-leading-comment.png +0 -0
  66. package/docs/assets/style-cookbook/mid-century-report.png +0 -0
  67. package/docs/assets/style-cookbook/star-chart-atlas.png +0 -0
  68. package/docs/assets/style-cookbook/transit-route-map.png +0 -0
  69. package/docs/comparison.md +0 -94
  70. package/docs/config.md +0 -105
  71. package/docs/contributing/adding-diagram-types.md +0 -144
  72. package/docs/contributing/diagram-family-citizenship.matrix.json +0 -2127
  73. package/docs/contributing/diagram-family-citizenship.md +0 -82
  74. package/docs/contributing/harvesting-upstream-tests.md +0 -126
  75. package/docs/contributing/lessons-learned.md +0 -276
  76. package/docs/contributing/releasing.md +0 -71
  77. package/docs/contributing/visual-review-evidence.md +0 -53
  78. package/docs/custom-style-cookbook.md +0 -154
  79. package/docs/design/families/README.md +0 -26
  80. package/docs/design/families/architecture-beta.md +0 -48
  81. package/docs/design/families/flowchart-parser-conformance.md +0 -22
  82. package/docs/design/families/gantt-research.md +0 -137
  83. package/docs/design/families/gantt.md +0 -329
  84. package/docs/design/families/journey-agentic-cards-before.png +0 -0
  85. package/docs/design/families/journey-mermaid-classic-implementation.png +0 -0
  86. package/docs/design/families/journey-mermaid-classic-prototype.png +0 -0
  87. package/docs/design/families/journey-mermaid-classic-prototype.svg +0 -163
  88. package/docs/design/families/journey-mermaid-classic-prototype.svg.png +0 -0
  89. package/docs/design/families/journey-migration-parity.md +0 -433
  90. package/docs/design/families/journey-usage-research.md +0 -423
  91. package/docs/design/families/journey.md +0 -125
  92. package/docs/design/families/xychart.md +0 -85
  93. package/docs/design/system/README.md +0 -45
  94. package/docs/design/system/abstraction-audit.md +0 -224
  95. package/docs/design/system/abstraction-recommendations.md +0 -655
  96. package/docs/design/system/architecture.mmd +0 -29
  97. package/docs/design/system/architecture.svg +0 -137
  98. package/docs/design/system/layout-guarantees-and-robustness.md +0 -351
  99. package/docs/design/system/layout-rubric.md +0 -138
  100. package/docs/design/system/route-contracts.md +0 -848
  101. package/docs/design/system/source-preservation-ladder.md +0 -52
  102. package/docs/design/system/styles-rollout.md +0 -216
  103. package/docs/design/system/ugly-layouts.md +0 -119
  104. package/docs/diagram-families.md +0 -193
  105. package/docs/features.md +0 -147
  106. package/docs/fork-differences.md +0 -130
  107. package/docs/getting-started.md +0 -175
  108. package/docs/issue-derived-test-cases.md +0 -156
  109. package/docs/layout-characterization/README.md +0 -245
  110. package/docs/layout-characterization/contact-sheet-families.md +0 -496
  111. package/docs/layout-characterization/contact-sheet.md +0 -638
  112. package/docs/layout-characterization/properties.md +0 -281
  113. package/docs/layout-characterization/visual-quality.md +0 -160
  114. package/docs/layout-characterization/visual-snapshots/architecture.svg +0 -79
  115. package/docs/layout-characterization/visual-snapshots/class.svg +0 -60
  116. package/docs/layout-characterization/visual-snapshots/er.svg +0 -61
  117. package/docs/layout-characterization/visual-snapshots/flowchart.svg +0 -58
  118. package/docs/layout-characterization/visual-snapshots/gantt.svg +0 -52
  119. package/docs/layout-characterization/visual-snapshots/journey.svg +0 -118
  120. package/docs/layout-characterization/visual-snapshots/pie.svg +0 -36
  121. package/docs/layout-characterization/visual-snapshots/quadrant.svg +0 -47
  122. package/docs/layout-characterization/visual-snapshots/sequence.svg +0 -59
  123. package/docs/layout-characterization/visual-snapshots/state.svg +0 -52
  124. package/docs/layout-characterization/visual-snapshots/timeline.svg +0 -64
  125. package/docs/layout-characterization/visual-snapshots/xychart.svg +0 -97
  126. package/docs/mcp-code-mode-rationale.md +0 -101
  127. package/docs/mcp-http-transport.md +0 -223
  128. package/docs/mermaid-layout-complaints.md +0 -837
  129. package/docs/mutation-testing.md +0 -206
  130. package/docs/project/divergences.md +0 -98
  131. package/docs/project/dogfooding-docs-strategy.md +0 -66
  132. package/docs/project/hosted-mcp-cloudflare-plan.md +0 -338
  133. package/docs/project/lessons-learned.md +0 -1019
  134. package/docs/project/remove-role-styling-plan.md +0 -176
  135. package/docs/quality.md +0 -212
  136. package/docs/react.md +0 -97
  137. package/docs/style-authoring.md +0 -133
  138. package/docs/testing-strategy.md +0 -335
  139. package/docs/theming.md +0 -162
  140. package/examples/agent-improve-auth-flow.ts +0 -206
  141. package/examples/agent-loop.ts +0 -53
  142. package/examples/mcp-vs-cli-complex-diagrams.ts +0 -133
  143. package/llms.txt +0 -104
  144. package/skill-evals/README.md +0 -77
  145. package/skill-evals/fixtures/architecture-cache/input.mmd +0 -5
  146. package/skill-evals/fixtures/class-payment/input.mmd +0 -4
  147. package/skill-evals/fixtures/er-orders/input.mmd +0 -10
  148. package/skill-evals/fixtures/flowchart-cache/input.mmd +0 -3
  149. package/skill-evals/fixtures/gantt-release/input.mmd +0 -7
  150. package/skill-evals/fixtures/journey-checkout/input.mmd +0 -6
  151. package/skill-evals/fixtures/pie-exports/input.mmd +0 -5
  152. package/skill-evals/fixtures/quadrant-priorities/input.mmd +0 -11
  153. package/skill-evals/fixtures/sequence-retry/input.mmd +0 -8
  154. package/skill-evals/fixtures/state-lifecycle/input.mmd +0 -5
  155. package/skill-evals/fixtures/timeline-release/input.mmd +0 -6
  156. package/skill-evals/fixtures/xychart-growth/input.mmd +0 -5
  157. package/skill-evals/shared-benchmark.json +0 -510
  158. package/src/agent/analyze.ts +0 -157
  159. package/src/agent/apply.ts +0 -146
  160. package/src/agent/architecture-body.ts +0 -458
  161. package/src/agent/certificates.ts +0 -110
  162. package/src/agent/class-body.ts +0 -319
  163. package/src/agent/core.ts +0 -207
  164. package/src/agent/create.ts +0 -106
  165. package/src/agent/describe.ts +0 -364
  166. package/src/agent/er-body.ts +0 -224
  167. package/src/agent/facts.ts +0 -337
  168. package/src/agent/families-builtin.ts +0 -934
  169. package/src/agent/families.ts +0 -232
  170. package/src/agent/family-layouts.ts +0 -826
  171. package/src/agent/flowchart-body.ts +0 -372
  172. package/src/agent/flowchart-unsupported.ts +0 -243
  173. package/src/agent/gantt-body.ts +0 -495
  174. package/src/agent/index.ts +0 -10
  175. package/src/agent/journey-body.ts +0 -414
  176. package/src/agent/label-metrics.ts +0 -28
  177. package/src/agent/layout-to-rendered.ts +0 -63
  178. package/src/agent/mutate.ts +0 -97
  179. package/src/agent/mutation-ops.ts +0 -51
  180. package/src/agent/op-schema.ts +0 -439
  181. package/src/agent/parse.ts +0 -223
  182. package/src/agent/pie-body.ts +0 -270
  183. package/src/agent/png.ts +0 -117
  184. package/src/agent/quadrant-body.ts +0 -336
  185. package/src/agent/quality.ts +0 -363
  186. package/src/agent/readability-audit.ts +0 -92
  187. package/src/agent/rendered-route-audit.ts +0 -61
  188. package/src/agent/sequence-body.ts +0 -345
  189. package/src/agent/serialize.ts +0 -214
  190. package/src/agent/state-body.ts +0 -589
  191. package/src/agent/structural-count.ts +0 -150
  192. package/src/agent/timeline-body.ts +0 -280
  193. package/src/agent/trace-log.ts +0 -43
  194. package/src/agent/types.ts +0 -979
  195. package/src/agent/verify.ts +0 -571
  196. package/src/agent/xychart-body.ts +0 -472
  197. package/src/architecture/config.ts +0 -282
  198. package/src/architecture/layout.ts +0 -496
  199. package/src/architecture/parser.ts +0 -375
  200. package/src/architecture/renderer.ts +0 -611
  201. package/src/architecture/types.ts +0 -113
  202. package/src/ascii/ansi.ts +0 -423
  203. package/src/ascii/architecture.ts +0 -210
  204. package/src/ascii/canvas.ts +0 -443
  205. package/src/ascii/class-diagram.ts +0 -697
  206. package/src/ascii/converter.ts +0 -475
  207. package/src/ascii/draw.ts +0 -1693
  208. package/src/ascii/edge-bundling.ts +0 -328
  209. package/src/ascii/edge-routing.ts +0 -330
  210. package/src/ascii/er-diagram.ts +0 -439
  211. package/src/ascii/gantt.ts +0 -276
  212. package/src/ascii/grid.ts +0 -747
  213. package/src/ascii/index.ts +0 -196
  214. package/src/ascii/journey.ts +0 -189
  215. package/src/ascii/meta.ts +0 -244
  216. package/src/ascii/multiline-utils.ts +0 -80
  217. package/src/ascii/pathfinder.ts +0 -301
  218. package/src/ascii/pie.ts +0 -67
  219. package/src/ascii/quadrant.ts +0 -158
  220. package/src/ascii/reverse.ts +0 -216
  221. package/src/ascii/sequence.ts +0 -499
  222. package/src/ascii/shapes/circle.ts +0 -27
  223. package/src/ascii/shapes/corners.ts +0 -143
  224. package/src/ascii/shapes/diamond.ts +0 -27
  225. package/src/ascii/shapes/hexagon.ts +0 -27
  226. package/src/ascii/shapes/index.ts +0 -106
  227. package/src/ascii/shapes/rectangle.ts +0 -168
  228. package/src/ascii/shapes/rounded.ts +0 -27
  229. package/src/ascii/shapes/special.ts +0 -332
  230. package/src/ascii/shapes/stadium.ts +0 -110
  231. package/src/ascii/shapes/state.ts +0 -192
  232. package/src/ascii/shapes/types.ts +0 -73
  233. package/src/ascii/timeline.ts +0 -128
  234. package/src/ascii/types.ts +0 -312
  235. package/src/ascii/validate.ts +0 -120
  236. package/src/ascii/width.ts +0 -81
  237. package/src/ascii/xychart.ts +0 -919
  238. package/src/browser.ts +0 -29
  239. package/src/class/layout.ts +0 -240
  240. package/src/class/parser.ts +0 -332
  241. package/src/class/renderer.ts +0 -638
  242. package/src/class/types.ts +0 -129
  243. package/src/cli/agent-instructions.ts +0 -1
  244. package/src/cli/am-bin.ts +0 -6
  245. package/src/cli/exit-codes.ts +0 -18
  246. package/src/cli/index.ts +0 -1117
  247. package/src/cli/init-agent.ts +0 -147
  248. package/src/color-resolver.ts +0 -152
  249. package/src/elk-instance.ts +0 -114
  250. package/src/er/layout.ts +0 -187
  251. package/src/er/parser.ts +0 -226
  252. package/src/er/renderer.ts +0 -792
  253. package/src/er/types.ts +0 -99
  254. package/src/font-manifest.ts +0 -27
  255. package/src/gantt/layout.ts +0 -365
  256. package/src/gantt/parser.ts +0 -282
  257. package/src/gantt/pipeline.ts +0 -27
  258. package/src/gantt/renderer.ts +0 -414
  259. package/src/gantt/schedule.ts +0 -513
  260. package/src/gantt/types.ts +0 -255
  261. package/src/index.ts +0 -368
  262. package/src/journey/layout.ts +0 -520
  263. package/src/journey/parser.ts +0 -218
  264. package/src/journey/renderer.ts +0 -811
  265. package/src/journey/types.ts +0 -144
  266. package/src/layout/geometry.ts +0 -182
  267. package/src/layout/pass.ts +0 -142
  268. package/src/layout/passes/index.ts +0 -3916
  269. package/src/layout-engine.ts +0 -1565
  270. package/src/layout-rubric.ts +0 -659
  271. package/src/mcp/artifacts.ts +0 -137
  272. package/src/mcp/dynamic-harness.ts +0 -31
  273. package/src/mcp/dynamic-modules.d.ts +0 -7
  274. package/src/mcp/facade.ts +0 -608
  275. package/src/mcp/harness-runtime.ts +0 -203
  276. package/src/mcp/hosted-server.ts +0 -468
  277. package/src/mcp/mcp-bin.ts +0 -3
  278. package/src/mcp/mcp-cli.ts +0 -82
  279. package/src/mcp/protocol.ts +0 -13
  280. package/src/mcp/sandbox.ts +0 -195
  281. package/src/mcp/sdk-decl.ts +0 -387
  282. package/src/mcp/server.ts +0 -362
  283. package/src/mcp/tool-surface.ts +0 -146
  284. package/src/mermaid-source.ts +0 -655
  285. package/src/multiline-utils.ts +0 -228
  286. package/src/parser.ts +0 -1031
  287. package/src/pie/layout.ts +0 -168
  288. package/src/pie/parser.ts +0 -136
  289. package/src/pie/renderer.ts +0 -234
  290. package/src/pie/types.ts +0 -82
  291. package/src/quadrant/layout.ts +0 -191
  292. package/src/quadrant/parser.ts +0 -183
  293. package/src/quadrant/renderer.ts +0 -322
  294. package/src/quadrant/types.ts +0 -113
  295. package/src/render-family-hooks.ts +0 -244
  296. package/src/renderer.ts +0 -1099
  297. package/src/route-contracts.ts +0 -2723
  298. package/src/scene/backend.ts +0 -76
  299. package/src/scene/fidelity.ts +0 -183
  300. package/src/scene/hybrid-backend.ts +0 -174
  301. package/src/scene/ir.ts +0 -181
  302. package/src/scene/marks.ts +0 -127
  303. package/src/scene/rough-backend.ts +0 -378
  304. package/src/scene/seed.ts +0 -46
  305. package/src/scene/style-registry.ts +0 -556
  306. package/src/sequence/layout.ts +0 -456
  307. package/src/sequence/parser.ts +0 -255
  308. package/src/sequence/renderer.ts +0 -604
  309. package/src/sequence/types.ts +0 -154
  310. package/src/shape-clipping.ts +0 -351
  311. package/src/shared/accessibility-directives.ts +0 -22
  312. package/src/shared/batched.ts +0 -61
  313. package/src/shared/color-math.ts +0 -72
  314. package/src/shared/svg-a11y.ts +0 -29
  315. package/src/shared/syntax-error.ts +0 -17
  316. package/src/shared/unicode-ranges.ts +0 -135
  317. package/src/styles.ts +0 -318
  318. package/src/svg-paths.ts +0 -28
  319. package/src/text-metrics.ts +0 -248
  320. package/src/theme.ts +0 -639
  321. package/src/timeline/layout.ts +0 -381
  322. package/src/timeline/parser.ts +0 -215
  323. package/src/timeline/renderer.ts +0 -538
  324. package/src/timeline/types.ts +0 -105
  325. package/src/types.ts +0 -454
  326. package/src/website-worker-modules.d.ts +0 -18
  327. package/src/xychart/axis-utils.ts +0 -109
  328. package/src/xychart/colors.ts +0 -124
  329. package/src/xychart/config.ts +0 -88
  330. package/src/xychart/layout.ts +0 -656
  331. package/src/xychart/parser.ts +0 -504
  332. package/src/xychart/renderer.ts +0 -640
  333. package/src/xychart/types.ts +0 -282
@@ -1,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
- */