@diagrammo/dgmo 0.47.0 → 0.48.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 (319) hide show
  1. package/dist/auto.js +1 -1
  2. package/dist/auto.mjs +1 -1
  3. package/dist/element.js +1 -1
  4. package/dist/element.mjs +1 -1
  5. package/package.json +19 -70
  6. package/dist/advanced.cjs +0 -71648
  7. package/dist/advanced.d.cts +0 -5719
  8. package/dist/auto.cjs +0 -70648
  9. package/dist/auto.d.cts +0 -54
  10. package/dist/block.cjs +0 -70208
  11. package/dist/block.d.cts +0 -115
  12. package/dist/editor.cjs +0 -526
  13. package/dist/editor.d.cts +0 -26
  14. package/dist/element.cjs +0 -70530
  15. package/dist/element.d.cts +0 -62
  16. package/dist/highlight.cjs +0 -852
  17. package/dist/highlight.d.cts +0 -49
  18. package/dist/index.cjs +0 -70491
  19. package/dist/index.d.cts +0 -160
  20. package/dist/pert.cjs +0 -325
  21. package/dist/pert.d.cts +0 -559
  22. package/dist/themes-1-CuKpeH.d.cts +0 -908
  23. package/src/advanced.ts +0 -873
  24. package/src/arc/parser.ts +0 -15
  25. package/src/arc/renderer.ts +0 -633
  26. package/src/auto/index.ts +0 -621
  27. package/src/auto/shared.ts +0 -370
  28. package/src/auto/styles.ts +0 -73
  29. package/src/block/layout.ts +0 -198
  30. package/src/block/parser.ts +0 -427
  31. package/src/block/renderer.ts +0 -484
  32. package/src/block/types.ts +0 -67
  33. package/src/boxes-and-lines/collapse.ts +0 -96
  34. package/src/boxes-and-lines/focus.ts +0 -257
  35. package/src/boxes-and-lines/label-placement.ts +0 -339
  36. package/src/boxes-and-lines/layout-grouped.ts +0 -912
  37. package/src/boxes-and-lines/layout-layered.ts +0 -722
  38. package/src/boxes-and-lines/layout-search.ts +0 -1678
  39. package/src/boxes-and-lines/layout.ts +0 -398
  40. package/src/boxes-and-lines/parser.ts +0 -1181
  41. package/src/boxes-and-lines/renderer.ts +0 -1465
  42. package/src/boxes-and-lines/types.ts +0 -66
  43. package/src/c4/layout.ts +0 -2441
  44. package/src/c4/parser.ts +0 -1158
  45. package/src/c4/renderer.ts +0 -2008
  46. package/src/c4/types.ts +0 -89
  47. package/src/chart-type-registry.ts +0 -529
  48. package/src/chart-types.ts +0 -225
  49. package/src/chart.ts +0 -685
  50. package/src/charts-d3/bar.ts +0 -338
  51. package/src/charts-d3/chord.ts +0 -140
  52. package/src/charts-d3/function.ts +0 -147
  53. package/src/charts-d3/funnel.ts +0 -104
  54. package/src/charts-d3/heatmap.ts +0 -145
  55. package/src/charts-d3/index.ts +0 -337
  56. package/src/charts-d3/interactions.ts +0 -477
  57. package/src/charts-d3/line.ts +0 -344
  58. package/src/charts-d3/mount.ts +0 -151
  59. package/src/charts-d3/pie.ts +0 -117
  60. package/src/charts-d3/polar.ts +0 -89
  61. package/src/charts-d3/radar.ts +0 -0
  62. package/src/charts-d3/sankey.ts +0 -0
  63. package/src/charts-d3/scatter.ts +0 -185
  64. package/src/charts-d3/shared.ts +0 -208
  65. package/src/class/layout.ts +0 -326
  66. package/src/class/parser.ts +0 -635
  67. package/src/class/renderer.ts +0 -793
  68. package/src/class/types.ts +0 -58
  69. package/src/cli-banner.ts +0 -106
  70. package/src/cli.ts +0 -1080
  71. package/src/colors-diagnostics.ts +0 -35
  72. package/src/colors.ts +0 -379
  73. package/src/completion-types.ts +0 -27
  74. package/src/completion.ts +0 -2668
  75. package/src/cycle/layout.ts +0 -1026
  76. package/src/cycle/parser.ts +0 -387
  77. package/src/cycle/renderer.ts +0 -653
  78. package/src/cycle/types.ts +0 -101
  79. package/src/d3.ts +0 -1434
  80. package/src/data-chart-parser.ts +0 -1007
  81. package/src/dgmo-router.ts +0 -296
  82. package/src/diagnostics-registry.ts +0 -108
  83. package/src/diagnostics.ts +0 -0
  84. package/src/dimensions.ts +0 -20
  85. package/src/directives-registry.ts +0 -396
  86. package/src/editor/dgmo.grammar +0 -76
  87. package/src/editor/dgmo.grammar.d.ts +0 -2
  88. package/src/editor/dgmo.grammar.js +0 -18
  89. package/src/editor/dgmo.grammar.terms.d.ts +0 -5
  90. package/src/editor/dgmo.grammar.terms.js +0 -35
  91. package/src/editor/highlight-api.ts +0 -596
  92. package/src/editor/highlight.ts +0 -36
  93. package/src/editor/index.ts +0 -27
  94. package/src/editor/keywords.ts +0 -128
  95. package/src/editor/tokens.ts +0 -30
  96. package/src/element/index.ts +0 -432
  97. package/src/embed/css.ts +0 -312
  98. package/src/embed/escape.ts +0 -15
  99. package/src/embed/index.ts +0 -280
  100. package/src/er/classify.ts +0 -228
  101. package/src/er/layout.ts +0 -530
  102. package/src/er/parser.ts +0 -750
  103. package/src/er/renderer.ts +0 -725
  104. package/src/er/types.ts +0 -52
  105. package/src/error-card.ts +0 -269
  106. package/src/event-line/diagnostics.ts +0 -117
  107. package/src/event-line/parser.ts +0 -643
  108. package/src/event-line/renderer.ts +0 -1742
  109. package/src/event-line/types.ts +0 -74
  110. package/src/fonts.ts +0 -3
  111. package/src/gantt/calculator.ts +0 -979
  112. package/src/gantt/parser.ts +0 -1641
  113. package/src/gantt/renderer.ts +0 -3787
  114. package/src/gantt/resolver.ts +0 -172
  115. package/src/gantt/types.ts +0 -206
  116. package/src/graph/diagnostics.ts +0 -64
  117. package/src/graph/edge-spline.ts +0 -29
  118. package/src/graph/flowchart-parser.ts +0 -759
  119. package/src/graph/flowchart-renderer.ts +0 -817
  120. package/src/graph/layout.ts +0 -472
  121. package/src/graph/notes.ts +0 -21
  122. package/src/graph/state-collapse.ts +0 -78
  123. package/src/graph/state-parser.ts +0 -574
  124. package/src/graph/state-renderer.ts +0 -653
  125. package/src/graph/types.ts +0 -65
  126. package/src/index.ts +0 -261
  127. package/src/infra/compute.ts +0 -1385
  128. package/src/infra/layout.ts +0 -888
  129. package/src/infra/parser.ts +0 -1234
  130. package/src/infra/renderer.ts +0 -2534
  131. package/src/infra/roles.ts +0 -75
  132. package/src/infra/types.ts +0 -216
  133. package/src/infra/validation.ts +0 -201
  134. package/src/journey-map/layout.ts +0 -490
  135. package/src/journey-map/parser.ts +0 -557
  136. package/src/journey-map/renderer.ts +0 -1580
  137. package/src/journey-map/types.ts +0 -47
  138. package/src/kanban/mutations.ts +0 -175
  139. package/src/kanban/parser.ts +0 -509
  140. package/src/kanban/renderer.ts +0 -1449
  141. package/src/kanban/types.ts +0 -39
  142. package/src/label-layout.ts +0 -368
  143. package/src/map/colorize.ts +0 -54
  144. package/src/map/completion.ts +0 -316
  145. package/src/map/context-labels.ts +0 -609
  146. package/src/map/data/PROVENANCE.json +0 -1
  147. package/src/map/data/README.md +0 -40
  148. package/src/map/data/airport-collisions.json +0 -1
  149. package/src/map/data/airports.json +0 -1
  150. package/src/map/data/gazetteer.json +0 -1
  151. package/src/map/data/lakes.json +0 -1
  152. package/src/map/data/mountain-ranges.json +0 -1
  153. package/src/map/data/na-lakes.json +0 -1
  154. package/src/map/data/na-land.json +0 -1
  155. package/src/map/data/region-names.json +0 -1
  156. package/src/map/data/rivers.json +0 -1
  157. package/src/map/data/types.ts +0 -121
  158. package/src/map/data/us-states.json +0 -1
  159. package/src/map/data/water-bodies.json +0 -1
  160. package/src/map/data/world-coarse.json +0 -1
  161. package/src/map/data/world-detail.json +0 -1
  162. package/src/map/diagnostics.ts +0 -134
  163. package/src/map/dimensions.ts +0 -150
  164. package/src/map/geo-query.ts +0 -295
  165. package/src/map/geo.ts +0 -438
  166. package/src/map/invert.ts +0 -111
  167. package/src/map/layout.ts +0 -5069
  168. package/src/map/legend-band.ts +0 -127
  169. package/src/map/load-data.ts +0 -186
  170. package/src/map/parser.ts +0 -783
  171. package/src/map/renderer.ts +0 -1445
  172. package/src/map/resolved-types.ts +0 -160
  173. package/src/map/resolver.ts +0 -1146
  174. package/src/map/types.ts +0 -194
  175. package/src/mindmap/collapse.ts +0 -67
  176. package/src/mindmap/layout.ts +0 -649
  177. package/src/mindmap/parser.ts +0 -430
  178. package/src/mindmap/renderer.ts +0 -637
  179. package/src/mindmap/text-wrap.ts +0 -218
  180. package/src/mindmap/types.ts +0 -56
  181. package/src/org/collapse.ts +0 -151
  182. package/src/org/layout.ts +0 -1262
  183. package/src/org/parser.ts +0 -519
  184. package/src/org/renderer.ts +0 -866
  185. package/src/org/resolver.ts +0 -636
  186. package/src/palettes/atlas.ts +0 -77
  187. package/src/palettes/blueprint.ts +0 -73
  188. package/src/palettes/catppuccin.ts +0 -84
  189. package/src/palettes/color-utils.ts +0 -443
  190. package/src/palettes/index.ts +0 -67
  191. package/src/palettes/nord.ts +0 -67
  192. package/src/palettes/registry.ts +0 -114
  193. package/src/palettes/slate.ts +0 -73
  194. package/src/palettes/tidewater.ts +0 -73
  195. package/src/palettes/tokyo-night.ts +0 -86
  196. package/src/palettes/types.ts +0 -88
  197. package/src/pert/analyzer.ts +0 -1183
  198. package/src/pert/diagnostics.ts +0 -110
  199. package/src/pert/index.ts +0 -43
  200. package/src/pert/internal.ts +0 -252
  201. package/src/pert/layout.ts +0 -971
  202. package/src/pert/monte-carlo.ts +0 -446
  203. package/src/pert/parser.ts +0 -1606
  204. package/src/pert/renderer.ts +0 -4009
  205. package/src/pert/share-normalize.ts +0 -62
  206. package/src/pert/types.ts +0 -604
  207. package/src/pyramid/parser.ts +0 -185
  208. package/src/pyramid/renderer.ts +0 -768
  209. package/src/pyramid/types.ts +0 -28
  210. package/src/quadrant/parser.ts +0 -18
  211. package/src/quadrant/renderer.ts +0 -638
  212. package/src/raci/diagnostics.ts +0 -213
  213. package/src/raci/index.ts +0 -23
  214. package/src/raci/mutations.ts +0 -321
  215. package/src/raci/parser.ts +0 -699
  216. package/src/raci/renderer.ts +0 -1627
  217. package/src/raci/types.ts +0 -82
  218. package/src/raci/variants.ts +0 -320
  219. package/src/render.ts +0 -268
  220. package/src/ring/parser.ts +0 -212
  221. package/src/ring/renderer.ts +0 -490
  222. package/src/ring/types.ts +0 -27
  223. package/src/sequence/collapse.ts +0 -174
  224. package/src/sequence/parser.ts +0 -1596
  225. package/src/sequence/participant-inference.ts +0 -152
  226. package/src/sequence/renderer.ts +0 -3168
  227. package/src/sequence/tag-resolution.ts +0 -164
  228. package/src/sharing.ts +0 -211
  229. package/src/sitemap/collapse.ts +0 -100
  230. package/src/sitemap/layout.ts +0 -925
  231. package/src/sitemap/parser.ts +0 -755
  232. package/src/sitemap/renderer.ts +0 -828
  233. package/src/sitemap/types.ts +0 -42
  234. package/src/slope/parser.ts +0 -18
  235. package/src/slope/renderer.ts +0 -378
  236. package/src/swimlane/diagnostics.ts +0 -94
  237. package/src/swimlane/layout.ts +0 -597
  238. package/src/swimlane/parser.ts +0 -613
  239. package/src/swimlane/renderer.ts +0 -681
  240. package/src/swimlane/types.ts +0 -151
  241. package/src/tech-radar/interactive.ts +0 -1129
  242. package/src/tech-radar/layout.ts +0 -197
  243. package/src/tech-radar/parser.ts +0 -436
  244. package/src/tech-radar/renderer.ts +0 -1239
  245. package/src/tech-radar/shared.ts +0 -151
  246. package/src/tech-radar/types.ts +0 -86
  247. package/src/themes.ts +0 -22
  248. package/src/timeline/parser.ts +0 -472
  249. package/src/timeline/renderer.ts +0 -3024
  250. package/src/timeline/types.ts +0 -33
  251. package/src/timeline/viz-parser.ts +0 -21
  252. package/src/treemap/diagnostics.ts +0 -62
  253. package/src/treemap/layout-radial.ts +0 -233
  254. package/src/treemap/layout.ts +0 -189
  255. package/src/treemap/parser.ts +0 -463
  256. package/src/treemap/renderer-radial.ts +0 -438
  257. package/src/treemap/renderer.ts +0 -572
  258. package/src/treemap/treemap-shared.ts +0 -309
  259. package/src/treemap/types.ts +0 -60
  260. package/src/utils/arrow-markers.ts +0 -51
  261. package/src/utils/arrows-diagnostics.ts +0 -62
  262. package/src/utils/arrows.ts +0 -227
  263. package/src/utils/brand.ts +0 -61
  264. package/src/utils/card.ts +0 -183
  265. package/src/utils/collapse-engine/tree-edges.ts +0 -115
  266. package/src/utils/collapse-engine/tree.ts +0 -117
  267. package/src/utils/d3-helpers.ts +0 -219
  268. package/src/utils/d3-types.ts +0 -9
  269. package/src/utils/description-helpers.ts +0 -38
  270. package/src/utils/duration.ts +0 -312
  271. package/src/utils/export-container.ts +0 -41
  272. package/src/utils/expr-eval.ts +0 -27
  273. package/src/utils/fit-canvas.ts +0 -64
  274. package/src/utils/hover-styles.ts +0 -673
  275. package/src/utils/inline-markdown.ts +0 -96
  276. package/src/utils/legend-constants.ts +0 -48
  277. package/src/utils/legend-d3.ts +0 -618
  278. package/src/utils/legend-integration.ts +0 -107
  279. package/src/utils/legend-layout.ts +0 -776
  280. package/src/utils/legend-svg.ts +0 -214
  281. package/src/utils/legend-types.ts +0 -272
  282. package/src/utils/name-normalize.ts +0 -163
  283. package/src/utils/note-box/constants.ts +0 -25
  284. package/src/utils/note-box/index.ts +0 -11
  285. package/src/utils/note-box/metrics.ts +0 -90
  286. package/src/utils/note-box/svg.ts +0 -331
  287. package/src/utils/notes/bounds.ts +0 -30
  288. package/src/utils/notes/build.ts +0 -131
  289. package/src/utils/notes/index.ts +0 -18
  290. package/src/utils/notes/model.ts +0 -19
  291. package/src/utils/notes/parse.ts +0 -131
  292. package/src/utils/notes/place.ts +0 -177
  293. package/src/utils/notes/resolve.ts +0 -88
  294. package/src/utils/number-format.ts +0 -36
  295. package/src/utils/parsing.ts +0 -953
  296. package/src/utils/reserved-key-registry.ts +0 -239
  297. package/src/utils/safe-href.ts +0 -38
  298. package/src/utils/scaling.ts +0 -97
  299. package/src/utils/svg-embed.ts +0 -251
  300. package/src/utils/tag-groups.ts +0 -607
  301. package/src/utils/text-measure.ts +0 -122
  302. package/src/utils/time-ticks.ts +0 -253
  303. package/src/utils/title-constants.ts +0 -24
  304. package/src/utils/visual-conventions.ts +0 -61
  305. package/src/utils/wrapped-desc.ts +0 -87
  306. package/src/venn/parser.ts +0 -18
  307. package/src/venn/renderer.ts +0 -1047
  308. package/src/version-control/diagnostics.ts +0 -67
  309. package/src/version-control/parser.ts +0 -544
  310. package/src/version-control/renderer.ts +0 -724
  311. package/src/version-control/types.ts +0 -100
  312. package/src/visualizations/parse.ts +0 -1560
  313. package/src/visualizations/types.ts +0 -262
  314. package/src/wireframe/layout.ts +0 -479
  315. package/src/wireframe/parser.ts +0 -1114
  316. package/src/wireframe/renderer.ts +0 -1318
  317. package/src/wireframe/types.ts +0 -110
  318. package/src/wordcloud/parser.ts +0 -18
  319. package/src/wordcloud/renderer.ts +0 -357
@@ -1,793 +0,0 @@
1
- // ============================================================
2
- // Class Diagram SVG Renderer
3
- // ============================================================
4
-
5
- import * as d3Selection from 'd3-selection';
6
- import * as d3Shape from 'd3-shape';
7
- import { FONT_FAMILY } from '../fonts';
8
- import {
9
- runInExportContainer,
10
- extractExportSvg,
11
- } from '../utils/export-container';
12
- import { LEGEND_HEIGHT } from '../utils/legend-constants';
13
- import { renderIntegratedLegend } from '../utils/legend-integration';
14
- import {
15
- TITLE_FONT_SIZE,
16
- TITLE_FONT_WEIGHT,
17
- TITLE_Y,
18
- } from '../utils/title-constants';
19
- import type { PaletteColors } from '../palettes';
20
- import { contrastText, shapeFill } from '../palettes/color-utils';
21
- import type {
22
- ParsedClassDiagram,
23
- ClassModifier,
24
- RelationshipType,
25
- } from './types';
26
- import type { ClassLayoutResult } from './layout';
27
- import { parseClassDiagram } from './parser';
28
- import { layoutClassDiagram } from './layout';
29
- import { ScaleContext } from '../utils/scaling';
30
- import { measureText } from '../utils/text-measure';
31
- import {
32
- renderNoteBox,
33
- renderNoteConnector,
34
- renderNoteBadge,
35
- noteConnectorPoints,
36
- NOTE_BADGE_RADIUS,
37
- } from '../utils/note-box';
38
-
39
- type GSelection = d3Selection.Selection<SVGGElement, unknown, null, undefined>;
40
-
41
- // ============================================================
42
- // Constants
43
- // ============================================================
44
-
45
- const DIAGRAM_PADDING = 20;
46
- const MAX_SCALE = 3;
47
- const CLASS_FONT_SIZE = 13;
48
- const MEMBER_FONT_SIZE = 11;
49
- const EDGE_LABEL_FONT_SIZE = 11;
50
- import {
51
- EDGE_STROKE_WIDTH,
52
- NODE_STROKE_WIDTH,
53
- } from '../utils/visual-conventions'; // shared (Story 111.1)
54
- const MEMBER_LINE_HEIGHT = 18;
55
- const COMPARTMENT_PADDING_Y = 8;
56
- const MEMBER_PADDING_X = 10;
57
-
58
- // ============================================================
59
- // Color helpers
60
- // ============================================================
61
-
62
- function modifierColor(
63
- modifier: ClassModifier | undefined,
64
- palette: PaletteColors,
65
- colorOff?: boolean
66
- ): string {
67
- if (colorOff) return palette.textMuted;
68
- switch (modifier) {
69
- case 'interface':
70
- return palette.colors.blue;
71
- case 'abstract':
72
- return palette.colors.purple;
73
- case 'enum':
74
- return palette.colors.yellow;
75
- default:
76
- return palette.colors.teal;
77
- }
78
- }
79
-
80
- function nodeFill(
81
- palette: PaletteColors,
82
- isDark: boolean,
83
- modifier: ClassModifier | undefined,
84
- nodeColor?: string,
85
- colorOff?: boolean,
86
- solid?: boolean
87
- ): string {
88
- const color = nodeColor ?? modifierColor(modifier, palette, colorOff);
89
- return shapeFill(palette, color, isDark, {
90
- ...(solid !== undefined && { solid }),
91
- });
92
- }
93
-
94
- function nodeStroke(
95
- palette: PaletteColors,
96
- modifier: ClassModifier | undefined,
97
- nodeColor?: string,
98
- colorOff?: boolean
99
- ): string {
100
- return nodeColor ?? modifierColor(modifier, palette, colorOff);
101
- }
102
-
103
- // ============================================================
104
- // Legend helpers
105
- // ============================================================
106
-
107
- interface ClassLegendEntry {
108
- label: string;
109
- colorKey: keyof PaletteColors['colors'];
110
- }
111
-
112
- const CLASS_TYPE_MAP: Record<string, ClassLegendEntry> = {
113
- class: { label: 'Class', colorKey: 'teal' },
114
- abstract: { label: 'Abstract', colorKey: 'purple' },
115
- interface: { label: 'Interface', colorKey: 'blue' },
116
- enum: { label: 'Enum', colorKey: 'yellow' },
117
- };
118
-
119
- const CLASS_TYPE_ORDER = ['class', 'abstract', 'interface', 'enum'];
120
-
121
- function collectClassTypes(parsed: ParsedClassDiagram): ClassLegendEntry[] {
122
- if (parsed.options?.['no-auto-color']) return [];
123
-
124
- const present = new Set<string>();
125
- for (const c of parsed.classes) {
126
- if (c.color) continue; // explicit color override — skip
127
- present.add(c.modifier ?? 'class');
128
- }
129
- // CLASS_TYPE_ORDER keys are all present in CLASS_TYPE_MAP by construction.
130
- return CLASS_TYPE_ORDER.filter((k) => present.has(k)).map(
131
- (k) => CLASS_TYPE_MAP[k]!
132
- );
133
- }
134
-
135
- const LEGEND_GROUP_NAME = 'Type';
136
-
137
- // legendEntriesWidth removed — centralized legend handles sizing
138
-
139
- function classTypeKey(modifier: ClassModifier | undefined): string {
140
- return modifier ?? 'class';
141
- }
142
-
143
- // ============================================================
144
- // Visibility symbols
145
- // ============================================================
146
-
147
- function visibilitySymbol(vis: 'public' | 'private' | 'protected'): string {
148
- switch (vis) {
149
- case 'public':
150
- return '+';
151
- case 'private':
152
- return '-';
153
- case 'protected':
154
- return '#';
155
- }
156
- }
157
-
158
- // ============================================================
159
- // Edge path generator
160
- // ============================================================
161
-
162
- const lineGenerator = d3Shape
163
- .line<{ x: number; y: number }>()
164
- .x((d) => d.x)
165
- .y((d) => d.y)
166
- .curve(d3Shape.curveBasis);
167
-
168
- // ============================================================
169
- // Edge line style
170
- // ============================================================
171
-
172
- function isDashedEdge(type: RelationshipType): boolean {
173
- return type === 'implements' || type === 'depends';
174
- }
175
-
176
- function markerIdForType(type: RelationshipType): string {
177
- switch (type) {
178
- case 'extends':
179
- return 'cd-arrow-inherit';
180
- case 'implements':
181
- return 'cd-arrow-implement';
182
- case 'composes':
183
- return 'cd-arrow-compose';
184
- case 'aggregates':
185
- return 'cd-arrow-aggregate';
186
- case 'depends':
187
- return 'cd-arrow-depend';
188
- case 'associates':
189
- return 'cd-arrow-assoc';
190
- }
191
- }
192
-
193
- // Where to place marker — source-end for compose/aggregate, target-end for others
194
- function isSourceMarker(type: RelationshipType): boolean {
195
- return type === 'composes' || type === 'aggregates';
196
- }
197
-
198
- // ============================================================
199
- // Main renderer
200
- // ============================================================
201
-
202
- export function renderClassDiagram(
203
- container: HTMLDivElement,
204
- parsed: ParsedClassDiagram,
205
- layout: ClassLayoutResult,
206
- palette: PaletteColors,
207
- isDark: boolean,
208
- onClickItem?: (lineNumber: number) => void,
209
- exportDims?: { width?: number; height?: number },
210
- legendActive?: boolean | null,
211
- exportMode?: boolean
212
- ): void {
213
- d3Selection.select(container).selectAll(':not([data-d3-tooltip])').remove();
214
-
215
- const width = exportDims?.width ?? container.clientWidth;
216
- const height = exportDims?.height ?? container.clientHeight;
217
- if (width <= 0 || height <= 0) return;
218
-
219
- const ctx = ScaleContext.identity();
220
-
221
- const sDiagramPadding = ctx.aesthetic(DIAGRAM_PADDING);
222
- const sClassFontSize = ctx.text(CLASS_FONT_SIZE);
223
- const sMemberFontSize = ctx.text(MEMBER_FONT_SIZE);
224
- const sEdgeLabelFontSize = ctx.text(EDGE_LABEL_FONT_SIZE);
225
- const sEdgeStrokeWidth = ctx.structural(EDGE_STROKE_WIDTH);
226
- const sNodeStrokeWidth = ctx.structural(NODE_STROKE_WIDTH);
227
- const sMemberLineHeight = ctx.structural(MEMBER_LINE_HEIGHT);
228
- const sCompartmentPaddingY = ctx.structural(COMPARTMENT_PADDING_Y);
229
- const sMemberPaddingX = ctx.structural(MEMBER_PADDING_X);
230
- const sTitleFontSize = ctx.text(TITLE_FONT_SIZE);
231
- const sTitleY = ctx.structural(TITLE_Y);
232
- const sLegendHeight = ctx.structural(LEGEND_HEIGHT);
233
-
234
- const legendEntries = collectClassTypes(parsed);
235
- const hasLegend = legendEntries.length > 1;
236
-
237
- const showTitle = !!parsed.title && parsed.options['no-title'] !== 'on';
238
- const titleHeight = showTitle ? 40 : 0;
239
- const LEGEND_FIXED_GAP = 8;
240
- const sLegendFixedGap = ctx.aesthetic(LEGEND_FIXED_GAP);
241
- const legendReserve = hasLegend ? sLegendHeight + sLegendFixedGap : 0;
242
- const diagramW = layout.width;
243
- const diagramH = layout.height;
244
- const availH = height - titleHeight - legendReserve;
245
- const scaleX = (width - sDiagramPadding * 2) / diagramW;
246
- const scaleY = (availH - sDiagramPadding * 2) / diagramH;
247
- const scale = Math.min(MAX_SCALE, scaleX, scaleY);
248
-
249
- const scaledW = diagramW * scale;
250
- const offsetX = (width - scaledW) / 2;
251
- const offsetY = titleHeight + legendReserve + sDiagramPadding;
252
-
253
- const svg = d3Selection
254
- .select(container)
255
- .append('svg')
256
- .attr('width', width)
257
- .attr('height', height)
258
- .attr('viewBox', `0 0 ${width} ${height}`)
259
- .attr('preserveAspectRatio', 'xMidYMin meet')
260
- .style('font-family', FONT_FAMILY);
261
-
262
- if (ctx.isBelowFloor) {
263
- svg.attr('width', '100%');
264
- }
265
-
266
- // ── Marker defs ──
267
- const defs = svg.append('defs');
268
- const AW = 12; // arrowhead width
269
- const AH = 8; // arrowhead height
270
-
271
- // Filled triangle (inheritance) — filled with stroke color
272
- defs
273
- .append('marker')
274
- .attr('id', 'cd-arrow-inherit')
275
- .attr('viewBox', `0 0 ${AW} ${AH}`)
276
- .attr('refX', AW)
277
- .attr('refY', AH / 2)
278
- .attr('markerWidth', AW)
279
- .attr('markerHeight', AH)
280
- .attr('orient', 'auto')
281
- .append('polygon')
282
- .attr('points', `0,0 ${AW},${AH / 2} 0,${AH}`)
283
- .attr('fill', palette.textMuted)
284
- .attr('stroke', palette.textMuted)
285
- .attr('stroke-width', 1);
286
-
287
- // Hollow triangle (implementation) — white/bg fill
288
- defs
289
- .append('marker')
290
- .attr('id', 'cd-arrow-implement')
291
- .attr('viewBox', `0 0 ${AW} ${AH}`)
292
- .attr('refX', AW)
293
- .attr('refY', AH / 2)
294
- .attr('markerWidth', AW)
295
- .attr('markerHeight', AH)
296
- .attr('orient', 'auto')
297
- .append('polygon')
298
- .attr('points', `0,0 ${AW},${AH / 2} 0,${AH}`)
299
- .attr('fill', palette.bg)
300
- .attr('stroke', palette.textMuted)
301
- .attr('stroke-width', 1);
302
-
303
- // Filled diamond (composition) — at source end
304
- const DW = 12;
305
- const DH = 8;
306
- defs
307
- .append('marker')
308
- .attr('id', 'cd-arrow-compose')
309
- .attr('viewBox', `0 0 ${DW} ${DH}`)
310
- .attr('refX', 0)
311
- .attr('refY', DH / 2)
312
- .attr('markerWidth', DW)
313
- .attr('markerHeight', DH)
314
- .attr('orient', 'auto')
315
- .append('polygon')
316
- .attr('points', `${DW / 2},0 ${DW},${DH / 2} ${DW / 2},${DH} 0,${DH / 2}`)
317
- .attr('fill', palette.textMuted)
318
- .attr('stroke', palette.textMuted)
319
- .attr('stroke-width', 1);
320
-
321
- // Hollow diamond (aggregation) — at source end
322
- defs
323
- .append('marker')
324
- .attr('id', 'cd-arrow-aggregate')
325
- .attr('viewBox', `0 0 ${DW} ${DH}`)
326
- .attr('refX', 0)
327
- .attr('refY', DH / 2)
328
- .attr('markerWidth', DW)
329
- .attr('markerHeight', DH)
330
- .attr('orient', 'auto')
331
- .append('polygon')
332
- .attr('points', `${DW / 2},0 ${DW},${DH / 2} ${DW / 2},${DH} 0,${DH / 2}`)
333
- .attr('fill', palette.bg)
334
- .attr('stroke', palette.textMuted)
335
- .attr('stroke-width', 1);
336
-
337
- // Open arrowhead (dependency)
338
- defs
339
- .append('marker')
340
- .attr('id', 'cd-arrow-depend')
341
- .attr('viewBox', `0 0 ${AW} ${AH}`)
342
- .attr('refX', AW)
343
- .attr('refY', AH / 2)
344
- .attr('markerWidth', AW)
345
- .attr('markerHeight', AH)
346
- .attr('orient', 'auto')
347
- .append('polyline')
348
- .attr('points', `0,0 ${AW},${AH / 2} 0,${AH}`)
349
- .attr('fill', 'none')
350
- .attr('stroke', palette.textMuted)
351
- .attr('stroke-width', 1.5);
352
-
353
- // Open arrowhead (association)
354
- defs
355
- .append('marker')
356
- .attr('id', 'cd-arrow-assoc')
357
- .attr('viewBox', `0 0 ${AW} ${AH}`)
358
- .attr('refX', AW)
359
- .attr('refY', AH / 2)
360
- .attr('markerWidth', AW)
361
- .attr('markerHeight', AH)
362
- .attr('orient', 'auto')
363
- .append('polyline')
364
- .attr('points', `0,0 ${AW},${AH / 2} 0,${AH}`)
365
- .attr('fill', 'none')
366
- .attr('stroke', palette.textMuted)
367
- .attr('stroke-width', 1.5);
368
-
369
- // ── Title ──
370
- if (showTitle) {
371
- const titleEl = svg
372
- .append('text')
373
- .attr('class', 'chart-title')
374
- .attr('x', width / 2)
375
- .attr('y', sTitleY)
376
- .attr('text-anchor', 'middle')
377
- .attr('fill', palette.text)
378
- .attr('font-size', sTitleFontSize)
379
- .attr('font-weight', TITLE_FONT_WEIGHT)
380
- .style(
381
- 'cursor',
382
- onClickItem && parsed.titleLineNumber ? 'pointer' : 'default'
383
- )
384
- .text(parsed.title!);
385
-
386
- if (parsed.titleLineNumber) {
387
- titleEl.attr('data-line-number', parsed.titleLineNumber);
388
- if (onClickItem) {
389
- titleEl
390
- .on('click', () => onClickItem(parsed.titleLineNumber!))
391
- .on('mouseenter', function () {
392
- d3Selection.select(this).attr('opacity', 0.7);
393
- })
394
- .on('mouseleave', function () {
395
- d3Selection.select(this).attr('opacity', 1);
396
- });
397
- }
398
- }
399
- }
400
-
401
- // ── Legend ──
402
- // legendActive: true = expanded (default), false = collapsed pill only
403
- const isLegendExpanded = legendActive !== false;
404
- if (hasLegend) {
405
- const legendGroups = [
406
- {
407
- name: LEGEND_GROUP_NAME,
408
- entries: legendEntries.map((entry) => ({
409
- value: entry.label,
410
- color: palette.colors[entry.colorKey],
411
- })),
412
- },
413
- ];
414
- const legendG = svg
415
- .append('g')
416
- .attr('class', 'cd-legend')
417
- .attr('transform', `translate(0,${titleHeight})`);
418
- renderIntegratedLegend(legendG, {
419
- groups: legendGroups,
420
- activeGroup: isLegendExpanded ? LEGEND_GROUP_NAME : null,
421
- mode: exportMode ? 'export' : 'preview',
422
- palette,
423
- isDark,
424
- width,
425
- });
426
- }
427
-
428
- // ── Content group ──
429
- const contentG = svg
430
- .append('g')
431
- .attr('transform', `translate(${offsetX}, ${offsetY}) scale(${scale})`);
432
-
433
- // ── Edges (behind nodes) ──
434
- for (const edge of layout.edges) {
435
- if (edge.points.length < 2) continue;
436
-
437
- const edgeG = contentG
438
- .append('g')
439
- .attr('class', 'cd-edge-group')
440
- .attr('data-line-number', String(edge.lineNumber))
441
- // Endpoint node ids for baked-CSS connection-highlight (hover-styles.ts).
442
- .attr('data-source', edge.source)
443
- .attr('data-target', edge.target);
444
-
445
- const edgeColor = palette.textMuted;
446
- const markerId = markerIdForType(edge.type);
447
- const dashed = isDashedEdge(edge.type);
448
- const sourceMarker = isSourceMarker(edge.type);
449
-
450
- const pathD = lineGenerator(edge.points);
451
- if (pathD) {
452
- const pathEl = edgeG
453
- .append('path')
454
- .attr('d', pathD)
455
- .attr('fill', 'none')
456
- .attr('stroke', edgeColor)
457
- .attr('stroke-width', sEdgeStrokeWidth)
458
- .attr('class', 'cd-edge');
459
-
460
- if (dashed) {
461
- pathEl.attr('stroke-dasharray', '6 3');
462
- }
463
-
464
- if (sourceMarker) {
465
- pathEl.attr('marker-start', `url(#${markerId})`);
466
- } else {
467
- pathEl.attr('marker-end', `url(#${markerId})`);
468
- }
469
- }
470
-
471
- // Edge label at midpoint
472
- if (edge.label) {
473
- const midIdx = Math.floor(edge.points.length / 2);
474
- // Edges are always non-empty (drawn from a valid graph layout).
475
- const midPt = edge.points[midIdx]!;
476
- const bgW = measureText(edge.label, sEdgeLabelFontSize) + 8;
477
- const bgH = 16;
478
-
479
- edgeG
480
- .append('rect')
481
- .attr('x', midPt.x - bgW / 2)
482
- .attr('y', midPt.y - bgH / 2 - 1)
483
- .attr('width', bgW)
484
- .attr('height', bgH)
485
- .attr('rx', 3)
486
- .attr('fill', palette.bg)
487
- .attr('opacity', 0.85)
488
- .attr('class', 'cd-edge-label-bg');
489
-
490
- edgeG
491
- .append('text')
492
- .attr('x', midPt.x)
493
- .attr('y', midPt.y + 4)
494
- .attr('text-anchor', 'middle')
495
- .attr('fill', edgeColor)
496
- .attr('font-size', sEdgeLabelFontSize)
497
- .attr('class', 'cd-edge-label')
498
- .text(edge.label);
499
- }
500
- }
501
-
502
- // ── Nodes (top layer) ──
503
- for (const node of layout.nodes) {
504
- const nodeG = contentG
505
- .append('g')
506
- .attr('transform', `translate(${node.x}, ${node.y})`)
507
- .attr('class', 'cd-class')
508
- .attr('data-line-number', String(node.lineNumber))
509
- .attr('data-node-id', node.id)
510
- .attr('data-cd-type', classTypeKey(node.modifier));
511
-
512
- if (onClickItem) {
513
- nodeG.style('cursor', 'pointer').on('click', () => {
514
- onClickItem(node.lineNumber);
515
- });
516
- }
517
-
518
- const w = node.width;
519
- const h = node.height;
520
- const colorOff = !!parsed.options?.['no-auto-color'];
521
- // When legend is collapsed, use neutral color for nodes without explicit color
522
- const neutralize = hasLegend && !isLegendExpanded && !node.color;
523
- const effectiveColor = neutralize ? palette.primary : node.color;
524
- const solid = parsed.options?.['solid-fill'] === 'on';
525
- const fill = nodeFill(
526
- palette,
527
- isDark,
528
- node.modifier,
529
- effectiveColor,
530
- colorOff,
531
- solid
532
- );
533
- const stroke = nodeStroke(palette, node.modifier, effectiveColor, colorOff);
534
- const onFillText = contrastText(
535
- fill,
536
- palette.textOnFillLight,
537
- palette.textOnFillDark
538
- );
539
-
540
- // Outer rectangle
541
- nodeG
542
- .append('rect')
543
- .attr('x', -w / 2)
544
- .attr('y', -h / 2)
545
- .attr('width', w)
546
- .attr('height', h)
547
- .attr('rx', 3)
548
- .attr('ry', 3)
549
- .attr('fill', fill)
550
- .attr('stroke', stroke)
551
- .attr('stroke-width', sNodeStrokeWidth);
552
-
553
- // Header section
554
- let yPos = -h / 2;
555
- const headerCenterY = yPos + node.headerHeight / 2;
556
-
557
- // Modifier badge <<interface>> etc.
558
- if (node.modifier) {
559
- const badgeText = `\u00AB${node.modifier}\u00BB`; // « »
560
- nodeG
561
- .append('text')
562
- .attr('x', 0)
563
- .attr('y', headerCenterY - 6)
564
- .attr('text-anchor', 'middle')
565
- .attr('dominant-baseline', 'central')
566
- .attr('fill', onFillText)
567
- .attr('font-size', sMemberFontSize)
568
- .attr('font-style', 'italic')
569
- .text(badgeText);
570
-
571
- nodeG
572
- .append('text')
573
- .attr('x', 0)
574
- .attr('y', headerCenterY + 10)
575
- .attr('text-anchor', 'middle')
576
- .attr('dominant-baseline', 'central')
577
- .attr('fill', onFillText)
578
- .attr('font-size', sClassFontSize)
579
- .attr('font-weight', 'bold')
580
- .attr('font-style', node.modifier === 'abstract' ? 'italic' : 'normal')
581
- .text(node.name);
582
- } else {
583
- nodeG
584
- .append('text')
585
- .attr('x', 0)
586
- .attr('y', headerCenterY)
587
- .attr('text-anchor', 'middle')
588
- .attr('dominant-baseline', 'central')
589
- .attr('fill', onFillText)
590
- .attr('font-size', sClassFontSize)
591
- .attr('font-weight', 'bold')
592
- .text(node.name);
593
- }
594
-
595
- yPos += node.headerHeight;
596
-
597
- const isEnum = node.modifier === 'enum';
598
- const fields = node.members.filter((m) => !m.isMethod);
599
- const methods = node.members.filter((m) => m.isMethod);
600
-
601
- if (isEnum) {
602
- // Enum: single values compartment
603
- // Separator
604
- nodeG
605
- .append('line')
606
- .attr('x1', -w / 2)
607
- .attr('y1', yPos)
608
- .attr('x2', w / 2)
609
- .attr('y2', yPos)
610
- .attr('stroke', solid ? onFillText : stroke)
611
- .attr('stroke-width', 0.5)
612
- .attr('stroke-opacity', 0.5);
613
-
614
- let memberY = yPos + sCompartmentPaddingY;
615
- for (const member of node.members) {
616
- nodeG
617
- .append('text')
618
- .attr('x', -w / 2 + sMemberPaddingX)
619
- .attr('y', memberY + sMemberLineHeight / 2)
620
- .attr('dominant-baseline', 'central')
621
- .attr('fill', onFillText)
622
- .attr('font-size', sMemberFontSize)
623
- .text(member.name);
624
- memberY += sMemberLineHeight;
625
- }
626
- } else {
627
- // UML 3-compartment layout: always show both separators
628
-
629
- // Fields separator
630
- nodeG
631
- .append('line')
632
- .attr('x1', -w / 2)
633
- .attr('y1', yPos)
634
- .attr('x2', w / 2)
635
- .attr('y2', yPos)
636
- .attr('stroke', solid ? onFillText : stroke)
637
- .attr('stroke-width', 0.5)
638
- .attr('stroke-opacity', 0.5);
639
-
640
- if (fields.length > 0) {
641
- let memberY = yPos + sCompartmentPaddingY;
642
- for (const field of fields) {
643
- const vis = visibilitySymbol(field.visibility);
644
- let text = `${vis} ${field.name}`;
645
- if (field.type) text += `: ${field.type}`;
646
-
647
- const textEl = nodeG
648
- .append('text')
649
- .attr('x', -w / 2 + sMemberPaddingX)
650
- .attr('y', memberY + sMemberLineHeight / 2)
651
- .attr('dominant-baseline', 'central')
652
- .attr('fill', onFillText)
653
- .attr('font-size', sMemberFontSize);
654
-
655
- if (field.isStatic) {
656
- textEl.attr('text-decoration', 'underline');
657
- }
658
- textEl.text(text);
659
-
660
- memberY += sMemberLineHeight;
661
- }
662
- }
663
- yPos += node.fieldsHeight;
664
-
665
- // Methods separator
666
- nodeG
667
- .append('line')
668
- .attr('x1', -w / 2)
669
- .attr('y1', yPos)
670
- .attr('x2', w / 2)
671
- .attr('y2', yPos)
672
- .attr('stroke', solid ? onFillText : stroke)
673
- .attr('stroke-width', 0.5)
674
- .attr('stroke-opacity', 0.5);
675
-
676
- if (methods.length > 0) {
677
- let memberY = yPos + sCompartmentPaddingY;
678
- for (const method of methods) {
679
- const vis = visibilitySymbol(method.visibility);
680
- let text = `${vis} ${method.name}(${method.params ?? ''})`;
681
- if (method.type) text += `: ${method.type}`;
682
-
683
- const textEl = nodeG
684
- .append('text')
685
- .attr('x', -w / 2 + sMemberPaddingX)
686
- .attr('y', memberY + sMemberLineHeight / 2)
687
- .attr('dominant-baseline', 'central')
688
- .attr('fill', onFillText)
689
- .attr('font-size', sMemberFontSize);
690
-
691
- if (method.isStatic) {
692
- textEl.attr('text-decoration', 'underline');
693
- }
694
- textEl.text(text);
695
-
696
- memberY += sMemberLineHeight;
697
- }
698
- }
699
- }
700
-
701
- // ── Note (floated beside the class, or a collapsed corner badge) ──
702
- // The class keeps its layout position; the note floats in adjacent
703
- // space chosen by the collision-aware placer. Coords are node-center
704
- // -local (the node `<g>` is translated to the center).
705
- if (node.note) {
706
- if (node.note.collapsed) {
707
- renderNoteBadge(
708
- nodeG as GSelection,
709
- {
710
- x: w / 2 - NOTE_BADGE_RADIUS - 3,
711
- y: -h / 2 + NOTE_BADGE_RADIUS + 3,
712
- },
713
- palette,
714
- {
715
- isDark,
716
- ...(node.note.color && { color: node.note.color }),
717
- lineNumber: node.note.lineNumber,
718
- endLineNumber: node.note.endLineNumber,
719
- }
720
- );
721
- } else {
722
- const [cx1, cy1, cx2, cy2] = noteConnectorPoints(
723
- { width: w, height: h },
724
- node.note
725
- );
726
- renderNoteConnector(nodeG as GSelection, cx1, cy1, cx2, cy2, palette);
727
- renderNoteBox(
728
- nodeG as GSelection,
729
- {
730
- x: node.note.x,
731
- y: node.note.y,
732
- width: node.note.width,
733
- height: node.note.height,
734
- },
735
- node.note.lines,
736
- palette,
737
- {
738
- isDark,
739
- ...(node.note.color && { color: node.note.color }),
740
- lineNumber: node.note.lineNumber,
741
- endLineNumber: node.note.endLineNumber,
742
- interactive: true,
743
- }
744
- );
745
- }
746
- }
747
- }
748
- }
749
-
750
- // ============================================================
751
- // Export convenience function
752
- // ============================================================
753
-
754
- export function renderClassDiagramForExport(
755
- content: string,
756
- theme: 'light' | 'dark' | 'transparent',
757
- palette: PaletteColors
758
- ): string {
759
- const parsed = parseClassDiagram(content, palette);
760
- if (parsed.error || parsed.classes.length === 0) return '';
761
-
762
- const layout = layoutClassDiagram(parsed);
763
- const isDark = theme === 'dark';
764
-
765
- const legendEntries = collectClassTypes(parsed);
766
- const EXPORT_LEGEND_GAP = 8;
767
- const legendReserve =
768
- legendEntries.length > 1 ? LEGEND_HEIGHT + EXPORT_LEGEND_GAP : 0;
769
- const exportWidth = layout.width + DIAGRAM_PADDING * 2;
770
- const exportHeight =
771
- layout.height +
772
- DIAGRAM_PADDING * 2 +
773
- (parsed.title ? 40 : 0) +
774
- legendReserve;
775
-
776
- return runInExportContainer(exportWidth, exportHeight, (container) => {
777
- renderClassDiagram(
778
- container,
779
- parsed,
780
- layout,
781
- palette,
782
- isDark,
783
- undefined,
784
- {
785
- width: exportWidth,
786
- height: exportHeight,
787
- },
788
- true, // legendActive for export
789
- true // exportMode
790
- );
791
- return extractExportSvg(container, theme);
792
- });
793
- }