@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,817 +0,0 @@
1
- // ============================================================
2
- // Flowchart SVG Renderer
3
- // ============================================================
4
-
5
- import * as d3Selection from 'd3-selection';
6
- import { appendArrowheadMarkers } from '../utils/arrow-markers';
7
- import { fitDiagramToCanvas } from '../utils/fit-canvas';
8
- import { FONT_FAMILY } from '../fonts';
9
- import type { PaletteColors } from '../palettes';
10
- import { contrastText, shapeFill } from '../palettes/color-utils';
11
- import type { ParsedGraph, GraphShape } from './types';
12
- import type { LayoutResult, LayoutNode } from './layout';
13
- import { parseFlowchart } from './flowchart-parser';
14
- import { layoutGraph } from './layout';
15
- import { edgeSplinePath } from './edge-spline';
16
- import {
17
- TITLE_FONT_SIZE,
18
- TITLE_FONT_WEIGHT,
19
- TITLE_Y,
20
- } from '../utils/title-constants';
21
- import { ScaleContext } from '../utils/scaling';
22
- import { measureText } from '../utils/text-measure';
23
- import {
24
- renderNoteBox,
25
- renderNoteConnector,
26
- renderNoteBadge,
27
- noteConnectorPoints,
28
- NOTE_BADGE_RADIUS,
29
- } from '../utils/note-box';
30
-
31
- // ============================================================
32
- // Constants
33
- // ============================================================
34
-
35
- const DIAGRAM_PADDING = 20;
36
- const MAX_SCALE = 3;
37
- const NODE_FONT_SIZE = 13;
38
- const EDGE_LABEL_FONT_SIZE = 11;
39
- import {
40
- EDGE_STROKE_WIDTH,
41
- NODE_STROKE_WIDTH,
42
- } from '../utils/visual-conventions'; // shared (Story 111.1)
43
- const ARROWHEAD_W = 10;
44
- const ARROWHEAD_H = 7;
45
- const IO_SKEW = 15;
46
- const SUBROUTINE_INSET = 8;
47
- const DOC_WAVE_HEIGHT = 10;
48
-
49
- // ============================================================
50
- // Color helpers
51
- // ============================================================
52
-
53
- function shapeDefaultColor(
54
- shape: GraphShape,
55
- palette: PaletteColors,
56
- isEndTerminal?: boolean,
57
- colorOff?: boolean
58
- ): string {
59
- if (colorOff) return palette.textMuted;
60
- switch (shape) {
61
- case 'terminal':
62
- return isEndTerminal ? palette.colors.red : palette.colors.green;
63
- case 'process':
64
- return palette.colors.blue;
65
- case 'decision':
66
- return palette.colors.yellow;
67
- case 'io':
68
- return palette.colors.purple;
69
- case 'subroutine':
70
- return palette.colors.teal;
71
- case 'document':
72
- return palette.colors.orange;
73
- default:
74
- return palette.colors.blue;
75
- }
76
- }
77
-
78
- function nodeFill(
79
- palette: PaletteColors,
80
- isDark: boolean,
81
- shape: GraphShape,
82
- nodeColor?: string,
83
- isEndTerminal?: boolean,
84
- colorOff?: boolean,
85
- solid?: boolean
86
- ): string {
87
- const color =
88
- nodeColor ?? shapeDefaultColor(shape, palette, isEndTerminal, colorOff);
89
- return shapeFill(palette, color, isDark, {
90
- ...(solid !== undefined && { solid }),
91
- });
92
- }
93
-
94
- function nodeStroke(
95
- palette: PaletteColors,
96
- shape: GraphShape,
97
- nodeColor?: string,
98
- isEndTerminal?: boolean,
99
- colorOff?: boolean
100
- ): string {
101
- return (
102
- nodeColor ?? shapeDefaultColor(shape, palette, isEndTerminal, colorOff)
103
- );
104
- }
105
-
106
- // ============================================================
107
- // Shape renderers
108
- // ============================================================
109
-
110
- type GSelection = d3Selection.Selection<SVGGElement, unknown, null, undefined>;
111
-
112
- function renderTerminal(
113
- g: GSelection,
114
- node: LayoutNode,
115
- palette: PaletteColors,
116
- isDark: boolean,
117
- isEnd: boolean,
118
- colorOff?: boolean,
119
- solid?: boolean,
120
- sNodeStrokeWidth = NODE_STROKE_WIDTH
121
- ): void {
122
- const w = node.width;
123
- const h = node.height;
124
- const rx = h / 2;
125
- g.append('rect')
126
- .attr('x', -w / 2)
127
- .attr('y', -h / 2)
128
- .attr('width', w)
129
- .attr('height', h)
130
- .attr('rx', rx)
131
- .attr('ry', rx)
132
- .attr(
133
- 'fill',
134
- nodeFill(palette, isDark, node.shape, node.color, isEnd, colorOff, solid)
135
- )
136
- .attr(
137
- 'stroke',
138
- nodeStroke(palette, node.shape, node.color, isEnd, colorOff)
139
- )
140
- .attr('stroke-width', sNodeStrokeWidth);
141
- }
142
-
143
- function renderProcess(
144
- g: GSelection,
145
- node: LayoutNode,
146
- palette: PaletteColors,
147
- isDark: boolean,
148
- colorOff?: boolean,
149
- solid?: boolean,
150
- sNodeStrokeWidth = NODE_STROKE_WIDTH
151
- ): void {
152
- const w = node.width;
153
- const h = node.height;
154
- g.append('rect')
155
- .attr('x', -w / 2)
156
- .attr('y', -h / 2)
157
- .attr('width', w)
158
- .attr('height', h)
159
- .attr('rx', 3)
160
- .attr('ry', 3)
161
- .attr(
162
- 'fill',
163
- nodeFill(
164
- palette,
165
- isDark,
166
- node.shape,
167
- node.color,
168
- undefined,
169
- colorOff,
170
- solid
171
- )
172
- )
173
- .attr(
174
- 'stroke',
175
- nodeStroke(palette, node.shape, node.color, undefined, colorOff)
176
- )
177
- .attr('stroke-width', sNodeStrokeWidth);
178
- }
179
-
180
- function renderDecision(
181
- g: GSelection,
182
- node: LayoutNode,
183
- palette: PaletteColors,
184
- isDark: boolean,
185
- colorOff?: boolean,
186
- solid?: boolean,
187
- sNodeStrokeWidth = NODE_STROKE_WIDTH
188
- ): void {
189
- const w = node.width / 2;
190
- const h = node.height / 2;
191
- const points = [`${0},${-h}`, `${w},${0}`, `${0},${h}`, `${-w},${0}`].join(
192
- ' '
193
- );
194
- g.append('polygon')
195
- .attr('points', points)
196
- .attr(
197
- 'fill',
198
- nodeFill(
199
- palette,
200
- isDark,
201
- node.shape,
202
- node.color,
203
- undefined,
204
- colorOff,
205
- solid
206
- )
207
- )
208
- .attr(
209
- 'stroke',
210
- nodeStroke(palette, node.shape, node.color, undefined, colorOff)
211
- )
212
- .attr('stroke-width', sNodeStrokeWidth);
213
- }
214
-
215
- function renderIO(
216
- g: GSelection,
217
- node: LayoutNode,
218
- palette: PaletteColors,
219
- isDark: boolean,
220
- colorOff?: boolean,
221
- solid?: boolean,
222
- sNodeStrokeWidth = NODE_STROKE_WIDTH,
223
- sIoSkew = IO_SKEW
224
- ): void {
225
- const w = node.width / 2;
226
- const h = node.height / 2;
227
- const sk = sIoSkew;
228
- const points = [
229
- `${-w + sk},${-h}`,
230
- `${w + sk},${-h}`,
231
- `${w - sk},${h}`,
232
- `${-w - sk},${h}`,
233
- ].join(' ');
234
- g.append('polygon')
235
- .attr('points', points)
236
- .attr(
237
- 'fill',
238
- nodeFill(
239
- palette,
240
- isDark,
241
- node.shape,
242
- node.color,
243
- undefined,
244
- colorOff,
245
- solid
246
- )
247
- )
248
- .attr(
249
- 'stroke',
250
- nodeStroke(palette, node.shape, node.color, undefined, colorOff)
251
- )
252
- .attr('stroke-width', sNodeStrokeWidth);
253
- }
254
-
255
- function renderSubroutine(
256
- g: GSelection,
257
- node: LayoutNode,
258
- palette: PaletteColors,
259
- isDark: boolean,
260
- colorOff?: boolean,
261
- solid?: boolean,
262
- sNodeStrokeWidth = NODE_STROKE_WIDTH,
263
- sSubroutineInset = SUBROUTINE_INSET
264
- ): void {
265
- const w = node.width;
266
- const h = node.height;
267
- const s = nodeStroke(palette, node.shape, node.color, undefined, colorOff);
268
- const fill = nodeFill(
269
- palette,
270
- isDark,
271
- node.shape,
272
- node.color,
273
- undefined,
274
- colorOff,
275
- solid
276
- );
277
- const innerStroke = solid
278
- ? contrastText(fill, palette.textOnFillLight, palette.textOnFillDark)
279
- : s;
280
- g.append('rect')
281
- .attr('x', -w / 2)
282
- .attr('y', -h / 2)
283
- .attr('width', w)
284
- .attr('height', h)
285
- .attr('rx', 3)
286
- .attr('ry', 3)
287
- .attr('fill', fill)
288
- .attr('stroke', s)
289
- .attr('stroke-width', sNodeStrokeWidth);
290
- g.append('line')
291
- .attr('x1', -w / 2 + sSubroutineInset)
292
- .attr('y1', -h / 2)
293
- .attr('x2', -w / 2 + sSubroutineInset)
294
- .attr('y2', h / 2)
295
- .attr('stroke', innerStroke)
296
- .attr('stroke-width', sNodeStrokeWidth);
297
- g.append('line')
298
- .attr('x1', w / 2 - sSubroutineInset)
299
- .attr('y1', -h / 2)
300
- .attr('x2', w / 2 - sSubroutineInset)
301
- .attr('y2', h / 2)
302
- .attr('stroke', innerStroke)
303
- .attr('stroke-width', sNodeStrokeWidth);
304
- }
305
-
306
- function renderDocument(
307
- g: GSelection,
308
- node: LayoutNode,
309
- palette: PaletteColors,
310
- isDark: boolean,
311
- colorOff?: boolean,
312
- solid?: boolean,
313
- sNodeStrokeWidth = NODE_STROKE_WIDTH,
314
- sDocWaveHeight = DOC_WAVE_HEIGHT
315
- ): void {
316
- const w = node.width;
317
- const h = node.height;
318
- const waveH = sDocWaveHeight;
319
- const left = -w / 2;
320
- const right = w / 2;
321
- const top = -h / 2;
322
- const bottom = h / 2 - waveH;
323
-
324
- const d = [
325
- `M ${left} ${top}`,
326
- `L ${right} ${top}`,
327
- `L ${right} ${bottom}`,
328
- `C ${right - w * 0.25} ${bottom + waveH * 2}, ${left + w * 0.25} ${bottom - waveH}, ${left} ${bottom}`,
329
- 'Z',
330
- ].join(' ');
331
-
332
- g.append('path')
333
- .attr('d', d)
334
- .attr(
335
- 'fill',
336
- nodeFill(
337
- palette,
338
- isDark,
339
- node.shape,
340
- node.color,
341
- undefined,
342
- colorOff,
343
- solid
344
- )
345
- )
346
- .attr(
347
- 'stroke',
348
- nodeStroke(palette, node.shape, node.color, undefined, colorOff)
349
- )
350
- .attr('stroke-width', sNodeStrokeWidth);
351
- }
352
-
353
- function renderNodeShape(
354
- g: GSelection,
355
- node: LayoutNode,
356
- palette: PaletteColors,
357
- isDark: boolean,
358
- endTerminalIds: Set<string>,
359
- colorOff?: boolean,
360
- solid?: boolean,
361
- sNodeStrokeWidth = NODE_STROKE_WIDTH,
362
- sIoSkew = IO_SKEW,
363
- sSubroutineInset = SUBROUTINE_INSET,
364
- sDocWaveHeight = DOC_WAVE_HEIGHT
365
- ): void {
366
- switch (node.shape) {
367
- case 'terminal':
368
- renderTerminal(
369
- g,
370
- node,
371
- palette,
372
- isDark,
373
- endTerminalIds.has(node.id),
374
- colorOff,
375
- solid,
376
- sNodeStrokeWidth
377
- );
378
- break;
379
- case 'process':
380
- renderProcess(
381
- g,
382
- node,
383
- palette,
384
- isDark,
385
- colorOff,
386
- solid,
387
- sNodeStrokeWidth
388
- );
389
- break;
390
- case 'decision':
391
- renderDecision(
392
- g,
393
- node,
394
- palette,
395
- isDark,
396
- colorOff,
397
- solid,
398
- sNodeStrokeWidth
399
- );
400
- break;
401
- case 'io':
402
- renderIO(
403
- g,
404
- node,
405
- palette,
406
- isDark,
407
- colorOff,
408
- solid,
409
- sNodeStrokeWidth,
410
- sIoSkew
411
- );
412
- break;
413
- case 'subroutine':
414
- renderSubroutine(
415
- g,
416
- node,
417
- palette,
418
- isDark,
419
- colorOff,
420
- solid,
421
- sNodeStrokeWidth,
422
- sSubroutineInset
423
- );
424
- break;
425
- case 'document':
426
- renderDocument(
427
- g,
428
- node,
429
- palette,
430
- isDark,
431
- colorOff,
432
- solid,
433
- sNodeStrokeWidth,
434
- sDocWaveHeight
435
- );
436
- break;
437
- default:
438
- break;
439
- }
440
- }
441
-
442
- // ============================================================
443
- // Main renderer
444
- // ============================================================
445
-
446
- export function renderFlowchart(
447
- container: HTMLDivElement,
448
- graph: ParsedGraph,
449
- layout: LayoutResult,
450
- palette: PaletteColors,
451
- isDark: boolean,
452
- onClickItem?: (lineNumber: number) => void,
453
- exportDims?: { width?: number; height?: number }
454
- ): void {
455
- d3Selection.select(container).selectAll(':not([data-d3-tooltip])').remove();
456
-
457
- const width = exportDims?.width ?? container.clientWidth;
458
- const height = exportDims?.height ?? container.clientHeight;
459
- if (width <= 0 || height <= 0) return;
460
-
461
- const ctx = ScaleContext.identity();
462
-
463
- const sDiagramPadding = ctx.aesthetic(DIAGRAM_PADDING);
464
- const sTitleFontSize = ctx.text(TITLE_FONT_SIZE);
465
- const sTitleY = ctx.structural(TITLE_Y);
466
- const sNodeFontSize = ctx.text(NODE_FONT_SIZE);
467
- const sEdgeLabelFontSize = ctx.text(EDGE_LABEL_FONT_SIZE);
468
- const sEdgeStrokeWidth = ctx.structural(EDGE_STROKE_WIDTH);
469
- const sNodeStrokeWidth = ctx.structural(NODE_STROKE_WIDTH);
470
- const sArrowheadW = ctx.structural(ARROWHEAD_W);
471
- const sArrowheadH = ctx.structural(ARROWHEAD_H);
472
- const sIoSkew = ctx.structural(IO_SKEW);
473
- const sSubroutineInset = ctx.structural(SUBROUTINE_INSET);
474
- const sDocWaveHeight = ctx.structural(DOC_WAVE_HEIGHT);
475
-
476
- const showTitle = !!graph.title && graph.options['no-title'] !== 'on';
477
- const titleHeight = showTitle ? 40 : 0;
478
-
479
- const diagramW = layout.width;
480
- const diagramH = layout.height;
481
- const { scale, offsetX, offsetY, canvasHeight } = fitDiagramToCanvas({
482
- width,
483
- height,
484
- diagramW,
485
- diagramH,
486
- padding: sDiagramPadding,
487
- titleHeight,
488
- maxScale: MAX_SCALE,
489
- exportMode: !!exportDims,
490
- });
491
-
492
- const svg = d3Selection
493
- .select(container)
494
- .append('svg')
495
- .attr('width', width)
496
- .attr('height', canvasHeight)
497
- .attr('viewBox', `0 0 ${width} ${canvasHeight}`)
498
- .attr('preserveAspectRatio', 'xMidYMin meet')
499
- .style('font-family', FONT_FAMILY);
500
-
501
- if (ctx.isBelowFloor) {
502
- svg.attr('width', '100%');
503
- }
504
-
505
- const defs = svg.append('defs');
506
-
507
- const edgeColors = new Set<string>();
508
- appendArrowheadMarkers(defs, {
509
- idPrefix: 'fc',
510
- width: sArrowheadW,
511
- height: sArrowheadH,
512
- baseFill: palette.textMuted,
513
- colors: edgeColors,
514
- });
515
-
516
- if (showTitle) {
517
- const titleEl = svg
518
- .append('text')
519
- .attr('class', 'chart-title')
520
- .attr('x', width / 2)
521
- .attr('y', sTitleY)
522
- .attr('text-anchor', 'middle')
523
- .attr('fill', palette.text)
524
- .attr('font-size', sTitleFontSize)
525
- .attr('font-weight', TITLE_FONT_WEIGHT)
526
- .style(
527
- 'cursor',
528
- onClickItem && graph.titleLineNumber ? 'pointer' : 'default'
529
- )
530
- .text(graph.title!);
531
-
532
- if (graph.titleLineNumber) {
533
- titleEl.attr('data-line-number', graph.titleLineNumber);
534
- if (onClickItem) {
535
- titleEl
536
- .on('click', () => onClickItem(graph.titleLineNumber!))
537
- .on('mouseenter', function () {
538
- d3Selection.select(this).attr('opacity', 0.7);
539
- })
540
- .on('mouseleave', function () {
541
- d3Selection.select(this).attr('opacity', 1);
542
- });
543
- }
544
- }
545
- }
546
-
547
- const contentG = svg
548
- .append('g')
549
- .attr('transform', `translate(${offsetX}, ${offsetY}) scale(${scale})`);
550
-
551
- const LABEL_PAD = 8;
552
- const LABEL_H = 16;
553
- const PERP_OFFSET = 10;
554
-
555
- interface LabelPos {
556
- x: number;
557
- y: number;
558
- w: number;
559
- h: number;
560
- edgeIdx: number;
561
- }
562
- const labelPositions: LabelPos[] = [];
563
-
564
- for (let ei = 0; ei < layout.edges.length; ei++) {
565
- const edge = layout.edges[ei]!;
566
- if (!edge.label || edge.points.length < 2) continue;
567
- const midIdx = Math.floor(edge.points.length / 2);
568
- const midPt = edge.points[midIdx]!;
569
- const bgW = measureText(edge.label, sEdgeLabelFontSize) + LABEL_PAD;
570
-
571
- const prev = edge.points[Math.max(0, midIdx - 1)]!;
572
- const next = edge.points[Math.min(edge.points.length - 1, midIdx + 1)]!;
573
- const dx = next.x - prev.x;
574
- const dy = next.y - prev.y;
575
- const len = Math.sqrt(dx * dx + dy * dy);
576
- let lx = midPt.x;
577
- let ly = midPt.y;
578
- if (len > 0) {
579
- lx += (-dy / len) * PERP_OFFSET;
580
- ly += (dx / len) * PERP_OFFSET;
581
- }
582
-
583
- labelPositions.push({ x: lx, y: ly, w: bgW, h: LABEL_H, edgeIdx: ei });
584
- }
585
-
586
- labelPositions.sort((a, b) => a.y - b.y);
587
- for (let i = 0; i < labelPositions.length; i++) {
588
- for (let j = i + 1; j < labelPositions.length; j++) {
589
- const a = labelPositions[i]!;
590
- const b = labelPositions[j]!;
591
- const overlapX = Math.abs(a.x - b.x) < (a.w + b.w) / 2;
592
- const overlapY = Math.abs(a.y - b.y) < (a.h + b.h) / 2;
593
- if (overlapX && overlapY) {
594
- b.y = a.y + (a.h + b.h) / 2 + 2;
595
- }
596
- }
597
- }
598
-
599
- const labelPosMap = new Map<number, LabelPos>();
600
- for (const lp of labelPositions) labelPosMap.set(lp.edgeIdx, lp);
601
-
602
- for (let ei = 0; ei < layout.edges.length; ei++) {
603
- const edge = layout.edges[ei]!;
604
- if (edge.points.length < 2) continue;
605
- const edgeG = contentG
606
- .append('g')
607
- .attr('class', 'fc-edge-group')
608
- .attr('data-line-number', String(edge.lineNumber))
609
- // Endpoint node ids for baked-CSS connection-highlight (hover-styles.ts).
610
- .attr('data-source', edge.source)
611
- .attr('data-target', edge.target);
612
-
613
- const edgeColor = palette.textMuted;
614
- const markerId = 'fc-arrow';
615
-
616
- const pathD = edgeSplinePath(edge.points);
617
- if (pathD) {
618
- edgeG
619
- .append('path')
620
- .attr('d', pathD)
621
- .attr('fill', 'none')
622
- .attr('stroke', edgeColor)
623
- .attr('stroke-width', sEdgeStrokeWidth)
624
- .attr('marker-end', `url(#${markerId})`)
625
- .attr('class', 'fc-edge');
626
- }
627
-
628
- const lp = labelPosMap.get(ei);
629
- if (edge.label && lp) {
630
- edgeG
631
- .append('rect')
632
- .attr('x', lp.x - lp.w / 2)
633
- .attr('y', lp.y - lp.h / 2 - 1)
634
- .attr('width', lp.w)
635
- .attr('height', lp.h)
636
- .attr('rx', 3)
637
- .attr('fill', palette.bg)
638
- .attr('opacity', 0.85)
639
- .attr('class', 'fc-edge-label-bg');
640
-
641
- edgeG
642
- .append('text')
643
- .attr('x', lp.x)
644
- .attr('y', lp.y + 4)
645
- .attr('text-anchor', 'middle')
646
- .attr('fill', edgeColor)
647
- .attr('font-size', sEdgeLabelFontSize)
648
- .attr('class', 'fc-edge-label')
649
- .text(edge.label);
650
- }
651
- }
652
-
653
- const nodesWithOutgoing = new Set<string>();
654
- for (const edge of layout.edges) nodesWithOutgoing.add(edge.source);
655
- const endTerminalIds = new Set<string>();
656
- for (const node of layout.nodes) {
657
- if (node.shape === 'terminal' && !nodesWithOutgoing.has(node.id)) {
658
- endTerminalIds.add(node.id);
659
- }
660
- }
661
-
662
- const colorOff = graph.options?.['color'] === 'off';
663
- const solid = graph.options?.['solid-fill'] === 'on';
664
- const noNotes = graph.options?.['no-notes'] === 'on';
665
- for (const node of layout.nodes) {
666
- const nodeG = contentG
667
- .append('g')
668
- .attr('transform', `translate(${node.x}, ${node.y})`)
669
- .attr('class', 'fc-node')
670
- .attr('data-line-number', String(node.lineNumber))
671
- .attr('data-node-id', node.id);
672
-
673
- if (onClickItem) {
674
- nodeG.style('cursor', 'pointer').on('click', () => {
675
- onClickItem(node.lineNumber);
676
- });
677
- }
678
-
679
- // The shape is drawn at its dagre position — a note never moves it,
680
- // so its edges stay connected. The note floats beside it.
681
- const hasNote = !!node.note && !noNotes;
682
-
683
- renderNodeShape(
684
- nodeG as GSelection,
685
- node,
686
- palette,
687
- isDark,
688
- endTerminalIds,
689
- colorOff,
690
- solid,
691
- sNodeStrokeWidth,
692
- sIoSkew,
693
- sSubroutineInset,
694
- sDocWaveHeight
695
- );
696
-
697
- const isEnd = endTerminalIds.has(node.id);
698
- const resolvedFill = nodeFill(
699
- palette,
700
- isDark,
701
- node.shape,
702
- node.color,
703
- isEnd,
704
- colorOff,
705
- solid
706
- );
707
- nodeG
708
- .append('text')
709
- .attr('x', 0)
710
- .attr('y', 0)
711
- .attr('text-anchor', 'middle')
712
- .attr('dominant-baseline', 'central')
713
- .attr(
714
- 'fill',
715
- contrastText(
716
- resolvedFill,
717
- palette.textOnFillLight,
718
- palette.textOnFillDark
719
- )
720
- )
721
- .attr('font-size', sNodeFontSize)
722
- .text(node.label);
723
-
724
- if (hasNote && node.note) {
725
- if (node.note.collapsed) {
726
- // Collapsed → comment-bubble badge in the node's top-right corner.
727
- renderNoteBadge(
728
- nodeG as GSelection,
729
- {
730
- x: node.width / 2 - NOTE_BADGE_RADIUS - 3,
731
- y: -node.height / 2 + NOTE_BADGE_RADIUS + 3,
732
- },
733
- palette,
734
- {
735
- isDark,
736
- ...(node.note.color && { color: node.note.color }),
737
- lineNumber: node.note.lineNumber,
738
- endLineNumber: node.note.endLineNumber,
739
- }
740
- );
741
- } else {
742
- // Solid tether from the shape edge to the floated note, on whichever
743
- // side the collision-aware placement chose.
744
- const [cx1, cy1, cx2, cy2] = noteConnectorPoints(node, node.note);
745
- renderNoteConnector(nodeG as GSelection, cx1, cy1, cx2, cy2, palette);
746
- renderNoteBox(
747
- nodeG as GSelection,
748
- {
749
- x: node.note.x,
750
- y: node.note.y,
751
- width: node.note.width,
752
- height: node.note.height,
753
- },
754
- node.note.lines,
755
- palette,
756
- {
757
- isDark,
758
- ...(node.note.color && { color: node.note.color }),
759
- lineNumber: node.note.lineNumber,
760
- endLineNumber: node.note.endLineNumber,
761
- interactive: true,
762
- }
763
- );
764
- }
765
- }
766
- }
767
- }
768
-
769
- // ============================================================
770
- // Export convenience function
771
- // ============================================================
772
-
773
- export function renderFlowchartForExport(
774
- content: string,
775
- theme: 'light' | 'dark' | 'transparent',
776
- palette: PaletteColors
777
- ): string {
778
- const parsed = parseFlowchart(content, palette);
779
- if (parsed.error || parsed.nodes.length === 0) return '';
780
-
781
- const layout = layoutGraph(parsed);
782
- const isDark = theme === 'dark';
783
-
784
- const container = document.createElement('div');
785
- container.style.width = `${layout.width + DIAGRAM_PADDING * 2}px`;
786
- container.style.height = `${layout.height + DIAGRAM_PADDING * 2 + (parsed.title && parsed.options['no-title'] !== 'on' ? 40 : 0)}px`;
787
- container.style.position = 'absolute';
788
- container.style.left = '-9999px';
789
- document.body.appendChild(container);
790
-
791
- const exportWidth = layout.width + DIAGRAM_PADDING * 2;
792
- const exportHeight =
793
- layout.height +
794
- DIAGRAM_PADDING * 2 +
795
- (parsed.title && parsed.options['no-title'] !== 'on' ? 40 : 0);
796
-
797
- try {
798
- renderFlowchart(container, parsed, layout, palette, isDark, undefined, {
799
- width: exportWidth,
800
- height: exportHeight,
801
- });
802
-
803
- const svgEl = container.querySelector('svg');
804
- if (!svgEl) return '';
805
-
806
- if (theme === 'transparent') {
807
- svgEl.style.background = 'none';
808
- }
809
-
810
- svgEl.setAttribute('xmlns', 'http://www.w3.org/2000/svg');
811
- svgEl.style.fontFamily = FONT_FAMILY;
812
-
813
- return svgEl.outerHTML;
814
- } finally {
815
- document.body.removeChild(container);
816
- }
817
- }