@diagrammo/dgmo 0.47.0 → 0.48.1

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 (345) hide show
  1. package/dist/advanced.js +11 -11
  2. package/dist/auto.js +16 -16
  3. package/dist/auto.mjs +41 -12
  4. package/dist/block.js +4 -4
  5. package/dist/{chunk-FNB3PNGF.js → chunk-7DTWEFUE.js} +3 -3
  6. package/dist/{chunk-2DXMZRWJ.js → chunk-B65G5DNL.js} +8 -1
  7. package/dist/{chunk-RZCF2VVM.js → chunk-B7JUCQUA.js} +3 -1
  8. package/dist/{chunk-DU7W62N5.js → chunk-FANX6UJR.js} +3 -3
  9. package/dist/{chunk-6FZYCKXB.js → chunk-HSH73DP6.js} +2 -2
  10. package/dist/{chunk-P4RH4OSP.js → chunk-ILKORZ3H.js} +2 -2
  11. package/dist/{chunk-Y5QGVTVC.js → chunk-JTSMEYIZ.js} +7 -3
  12. package/dist/{chunk-RCERWOJR.js → chunk-ODZVHU3R.js} +1 -2
  13. package/dist/{chunk-DZAQBW35.js → chunk-SGZYXELT.js} +3 -7
  14. package/dist/{chunk-CUVHQHZ7.js → chunk-THXCFRTU.js} +3 -3
  15. package/dist/{chunk-IH6ZMVQ5.js → chunk-UC7TFHUM.js} +29 -11
  16. package/dist/{chunk-EMS2SK26.js → chunk-ZBWMSD5N.js} +3 -1
  17. package/dist/cli.cjs +15 -15
  18. package/dist/{dgmo-router-DZCIDUO5.js → dgmo-router-X35VLZLM.js} +3 -3
  19. package/dist/element.js +16 -16
  20. package/dist/element.mjs +41 -12
  21. package/dist/{flowchart-renderer-ZAEOL4DX.js → flowchart-renderer-SNDSII4D.js} +2 -2
  22. package/dist/index.d.ts +4 -2
  23. package/dist/index.js +4 -4
  24. package/dist/{parser-FUSKFGZN.js → parser-2EWECDSA.js} +2 -2
  25. package/dist/{renderer-UWA5XS74.js → renderer-4JHRUBE6.js} +3 -3
  26. package/dist/{renderer-WZRREQ2P.js → renderer-5MYBMBYO.js} +2 -2
  27. package/dist/{renderer-TOCOVLHS.js → renderer-B2OMQIQG.js} +3 -3
  28. package/dist/{renderer-2XQQQ6QR.js → renderer-N43WR5GV.js} +3 -3
  29. package/dist/{renderer-T7YKC5VP.js → renderer-ZRNG54CW.js} +3 -3
  30. package/dist/{state-renderer-RFYHSP4K.js → state-renderer-B4DQBM6M.js} +2 -2
  31. package/package.json +23 -71
  32. package/dist/advanced.cjs +0 -71648
  33. package/dist/advanced.d.cts +0 -5719
  34. package/dist/auto.cjs +0 -70648
  35. package/dist/auto.d.cts +0 -54
  36. package/dist/block.cjs +0 -70208
  37. package/dist/block.d.cts +0 -115
  38. package/dist/editor.cjs +0 -526
  39. package/dist/editor.d.cts +0 -26
  40. package/dist/element.cjs +0 -70530
  41. package/dist/element.d.cts +0 -62
  42. package/dist/highlight.cjs +0 -852
  43. package/dist/highlight.d.cts +0 -49
  44. package/dist/index.cjs +0 -70491
  45. package/dist/index.d.cts +0 -160
  46. package/dist/pert.cjs +0 -325
  47. package/dist/pert.d.cts +0 -559
  48. package/dist/themes-1-CuKpeH.d.cts +0 -908
  49. package/src/advanced.ts +0 -873
  50. package/src/arc/parser.ts +0 -15
  51. package/src/arc/renderer.ts +0 -633
  52. package/src/auto/index.ts +0 -621
  53. package/src/auto/shared.ts +0 -370
  54. package/src/auto/styles.ts +0 -73
  55. package/src/block/layout.ts +0 -198
  56. package/src/block/parser.ts +0 -427
  57. package/src/block/renderer.ts +0 -484
  58. package/src/block/types.ts +0 -67
  59. package/src/boxes-and-lines/collapse.ts +0 -96
  60. package/src/boxes-and-lines/focus.ts +0 -257
  61. package/src/boxes-and-lines/label-placement.ts +0 -339
  62. package/src/boxes-and-lines/layout-grouped.ts +0 -912
  63. package/src/boxes-and-lines/layout-layered.ts +0 -722
  64. package/src/boxes-and-lines/layout-search.ts +0 -1678
  65. package/src/boxes-and-lines/layout.ts +0 -398
  66. package/src/boxes-and-lines/parser.ts +0 -1181
  67. package/src/boxes-and-lines/renderer.ts +0 -1465
  68. package/src/boxes-and-lines/types.ts +0 -66
  69. package/src/c4/layout.ts +0 -2441
  70. package/src/c4/parser.ts +0 -1158
  71. package/src/c4/renderer.ts +0 -2008
  72. package/src/c4/types.ts +0 -89
  73. package/src/chart-type-registry.ts +0 -529
  74. package/src/chart-types.ts +0 -225
  75. package/src/chart.ts +0 -685
  76. package/src/charts-d3/bar.ts +0 -338
  77. package/src/charts-d3/chord.ts +0 -140
  78. package/src/charts-d3/function.ts +0 -147
  79. package/src/charts-d3/funnel.ts +0 -104
  80. package/src/charts-d3/heatmap.ts +0 -145
  81. package/src/charts-d3/index.ts +0 -337
  82. package/src/charts-d3/interactions.ts +0 -477
  83. package/src/charts-d3/line.ts +0 -344
  84. package/src/charts-d3/mount.ts +0 -151
  85. package/src/charts-d3/pie.ts +0 -117
  86. package/src/charts-d3/polar.ts +0 -89
  87. package/src/charts-d3/radar.ts +0 -0
  88. package/src/charts-d3/sankey.ts +0 -0
  89. package/src/charts-d3/scatter.ts +0 -185
  90. package/src/charts-d3/shared.ts +0 -208
  91. package/src/class/layout.ts +0 -326
  92. package/src/class/parser.ts +0 -635
  93. package/src/class/renderer.ts +0 -793
  94. package/src/class/types.ts +0 -58
  95. package/src/cli-banner.ts +0 -106
  96. package/src/cli.ts +0 -1080
  97. package/src/colors-diagnostics.ts +0 -35
  98. package/src/colors.ts +0 -379
  99. package/src/completion-types.ts +0 -27
  100. package/src/completion.ts +0 -2668
  101. package/src/cycle/layout.ts +0 -1026
  102. package/src/cycle/parser.ts +0 -387
  103. package/src/cycle/renderer.ts +0 -653
  104. package/src/cycle/types.ts +0 -101
  105. package/src/d3.ts +0 -1434
  106. package/src/data-chart-parser.ts +0 -1007
  107. package/src/dgmo-router.ts +0 -296
  108. package/src/diagnostics-registry.ts +0 -108
  109. package/src/diagnostics.ts +0 -0
  110. package/src/dimensions.ts +0 -20
  111. package/src/directives-registry.ts +0 -396
  112. package/src/editor/dgmo.grammar +0 -76
  113. package/src/editor/dgmo.grammar.d.ts +0 -2
  114. package/src/editor/dgmo.grammar.js +0 -18
  115. package/src/editor/dgmo.grammar.terms.d.ts +0 -5
  116. package/src/editor/dgmo.grammar.terms.js +0 -35
  117. package/src/editor/highlight-api.ts +0 -596
  118. package/src/editor/highlight.ts +0 -36
  119. package/src/editor/index.ts +0 -27
  120. package/src/editor/keywords.ts +0 -128
  121. package/src/editor/tokens.ts +0 -30
  122. package/src/element/index.ts +0 -432
  123. package/src/embed/css.ts +0 -312
  124. package/src/embed/escape.ts +0 -15
  125. package/src/embed/index.ts +0 -280
  126. package/src/er/classify.ts +0 -228
  127. package/src/er/layout.ts +0 -530
  128. package/src/er/parser.ts +0 -750
  129. package/src/er/renderer.ts +0 -725
  130. package/src/er/types.ts +0 -52
  131. package/src/error-card.ts +0 -269
  132. package/src/event-line/diagnostics.ts +0 -117
  133. package/src/event-line/parser.ts +0 -643
  134. package/src/event-line/renderer.ts +0 -1742
  135. package/src/event-line/types.ts +0 -74
  136. package/src/fonts.ts +0 -3
  137. package/src/gantt/calculator.ts +0 -979
  138. package/src/gantt/parser.ts +0 -1641
  139. package/src/gantt/renderer.ts +0 -3787
  140. package/src/gantt/resolver.ts +0 -172
  141. package/src/gantt/types.ts +0 -206
  142. package/src/graph/diagnostics.ts +0 -64
  143. package/src/graph/edge-spline.ts +0 -29
  144. package/src/graph/flowchart-parser.ts +0 -759
  145. package/src/graph/flowchart-renderer.ts +0 -817
  146. package/src/graph/layout.ts +0 -472
  147. package/src/graph/notes.ts +0 -21
  148. package/src/graph/state-collapse.ts +0 -78
  149. package/src/graph/state-parser.ts +0 -574
  150. package/src/graph/state-renderer.ts +0 -653
  151. package/src/graph/types.ts +0 -65
  152. package/src/index.ts +0 -261
  153. package/src/infra/compute.ts +0 -1385
  154. package/src/infra/layout.ts +0 -888
  155. package/src/infra/parser.ts +0 -1234
  156. package/src/infra/renderer.ts +0 -2534
  157. package/src/infra/roles.ts +0 -75
  158. package/src/infra/types.ts +0 -216
  159. package/src/infra/validation.ts +0 -201
  160. package/src/journey-map/layout.ts +0 -490
  161. package/src/journey-map/parser.ts +0 -557
  162. package/src/journey-map/renderer.ts +0 -1580
  163. package/src/journey-map/types.ts +0 -47
  164. package/src/kanban/mutations.ts +0 -175
  165. package/src/kanban/parser.ts +0 -509
  166. package/src/kanban/renderer.ts +0 -1449
  167. package/src/kanban/types.ts +0 -39
  168. package/src/label-layout.ts +0 -368
  169. package/src/map/colorize.ts +0 -54
  170. package/src/map/completion.ts +0 -316
  171. package/src/map/context-labels.ts +0 -609
  172. package/src/map/data/PROVENANCE.json +0 -1
  173. package/src/map/data/README.md +0 -40
  174. package/src/map/data/airport-collisions.json +0 -1
  175. package/src/map/data/airports.json +0 -1
  176. package/src/map/data/gazetteer.json +0 -1
  177. package/src/map/data/lakes.json +0 -1
  178. package/src/map/data/mountain-ranges.json +0 -1
  179. package/src/map/data/na-lakes.json +0 -1
  180. package/src/map/data/na-land.json +0 -1
  181. package/src/map/data/region-names.json +0 -1
  182. package/src/map/data/rivers.json +0 -1
  183. package/src/map/data/types.ts +0 -121
  184. package/src/map/data/us-states.json +0 -1
  185. package/src/map/data/water-bodies.json +0 -1
  186. package/src/map/data/world-coarse.json +0 -1
  187. package/src/map/data/world-detail.json +0 -1
  188. package/src/map/diagnostics.ts +0 -134
  189. package/src/map/dimensions.ts +0 -150
  190. package/src/map/geo-query.ts +0 -295
  191. package/src/map/geo.ts +0 -438
  192. package/src/map/invert.ts +0 -111
  193. package/src/map/layout.ts +0 -5069
  194. package/src/map/legend-band.ts +0 -127
  195. package/src/map/load-data.ts +0 -186
  196. package/src/map/parser.ts +0 -783
  197. package/src/map/renderer.ts +0 -1445
  198. package/src/map/resolved-types.ts +0 -160
  199. package/src/map/resolver.ts +0 -1146
  200. package/src/map/types.ts +0 -194
  201. package/src/mindmap/collapse.ts +0 -67
  202. package/src/mindmap/layout.ts +0 -649
  203. package/src/mindmap/parser.ts +0 -430
  204. package/src/mindmap/renderer.ts +0 -637
  205. package/src/mindmap/text-wrap.ts +0 -218
  206. package/src/mindmap/types.ts +0 -56
  207. package/src/org/collapse.ts +0 -151
  208. package/src/org/layout.ts +0 -1262
  209. package/src/org/parser.ts +0 -519
  210. package/src/org/renderer.ts +0 -866
  211. package/src/org/resolver.ts +0 -636
  212. package/src/palettes/atlas.ts +0 -77
  213. package/src/palettes/blueprint.ts +0 -73
  214. package/src/palettes/catppuccin.ts +0 -84
  215. package/src/palettes/color-utils.ts +0 -443
  216. package/src/palettes/index.ts +0 -67
  217. package/src/palettes/nord.ts +0 -67
  218. package/src/palettes/registry.ts +0 -114
  219. package/src/palettes/slate.ts +0 -73
  220. package/src/palettes/tidewater.ts +0 -73
  221. package/src/palettes/tokyo-night.ts +0 -86
  222. package/src/palettes/types.ts +0 -88
  223. package/src/pert/analyzer.ts +0 -1183
  224. package/src/pert/diagnostics.ts +0 -110
  225. package/src/pert/index.ts +0 -43
  226. package/src/pert/internal.ts +0 -252
  227. package/src/pert/layout.ts +0 -971
  228. package/src/pert/monte-carlo.ts +0 -446
  229. package/src/pert/parser.ts +0 -1606
  230. package/src/pert/renderer.ts +0 -4009
  231. package/src/pert/share-normalize.ts +0 -62
  232. package/src/pert/types.ts +0 -604
  233. package/src/pyramid/parser.ts +0 -185
  234. package/src/pyramid/renderer.ts +0 -768
  235. package/src/pyramid/types.ts +0 -28
  236. package/src/quadrant/parser.ts +0 -18
  237. package/src/quadrant/renderer.ts +0 -638
  238. package/src/raci/diagnostics.ts +0 -213
  239. package/src/raci/index.ts +0 -23
  240. package/src/raci/mutations.ts +0 -321
  241. package/src/raci/parser.ts +0 -699
  242. package/src/raci/renderer.ts +0 -1627
  243. package/src/raci/types.ts +0 -82
  244. package/src/raci/variants.ts +0 -320
  245. package/src/render.ts +0 -268
  246. package/src/ring/parser.ts +0 -212
  247. package/src/ring/renderer.ts +0 -490
  248. package/src/ring/types.ts +0 -27
  249. package/src/sequence/collapse.ts +0 -174
  250. package/src/sequence/parser.ts +0 -1596
  251. package/src/sequence/participant-inference.ts +0 -152
  252. package/src/sequence/renderer.ts +0 -3168
  253. package/src/sequence/tag-resolution.ts +0 -164
  254. package/src/sharing.ts +0 -211
  255. package/src/sitemap/collapse.ts +0 -100
  256. package/src/sitemap/layout.ts +0 -925
  257. package/src/sitemap/parser.ts +0 -755
  258. package/src/sitemap/renderer.ts +0 -828
  259. package/src/sitemap/types.ts +0 -42
  260. package/src/slope/parser.ts +0 -18
  261. package/src/slope/renderer.ts +0 -378
  262. package/src/swimlane/diagnostics.ts +0 -94
  263. package/src/swimlane/layout.ts +0 -597
  264. package/src/swimlane/parser.ts +0 -613
  265. package/src/swimlane/renderer.ts +0 -681
  266. package/src/swimlane/types.ts +0 -151
  267. package/src/tech-radar/interactive.ts +0 -1129
  268. package/src/tech-radar/layout.ts +0 -197
  269. package/src/tech-radar/parser.ts +0 -436
  270. package/src/tech-radar/renderer.ts +0 -1239
  271. package/src/tech-radar/shared.ts +0 -151
  272. package/src/tech-radar/types.ts +0 -86
  273. package/src/themes.ts +0 -22
  274. package/src/timeline/parser.ts +0 -472
  275. package/src/timeline/renderer.ts +0 -3024
  276. package/src/timeline/types.ts +0 -33
  277. package/src/timeline/viz-parser.ts +0 -21
  278. package/src/treemap/diagnostics.ts +0 -62
  279. package/src/treemap/layout-radial.ts +0 -233
  280. package/src/treemap/layout.ts +0 -189
  281. package/src/treemap/parser.ts +0 -463
  282. package/src/treemap/renderer-radial.ts +0 -438
  283. package/src/treemap/renderer.ts +0 -572
  284. package/src/treemap/treemap-shared.ts +0 -309
  285. package/src/treemap/types.ts +0 -60
  286. package/src/utils/arrow-markers.ts +0 -51
  287. package/src/utils/arrows-diagnostics.ts +0 -62
  288. package/src/utils/arrows.ts +0 -227
  289. package/src/utils/brand.ts +0 -61
  290. package/src/utils/card.ts +0 -183
  291. package/src/utils/collapse-engine/tree-edges.ts +0 -115
  292. package/src/utils/collapse-engine/tree.ts +0 -117
  293. package/src/utils/d3-helpers.ts +0 -219
  294. package/src/utils/d3-types.ts +0 -9
  295. package/src/utils/description-helpers.ts +0 -38
  296. package/src/utils/duration.ts +0 -312
  297. package/src/utils/export-container.ts +0 -41
  298. package/src/utils/expr-eval.ts +0 -27
  299. package/src/utils/fit-canvas.ts +0 -64
  300. package/src/utils/hover-styles.ts +0 -673
  301. package/src/utils/inline-markdown.ts +0 -96
  302. package/src/utils/legend-constants.ts +0 -48
  303. package/src/utils/legend-d3.ts +0 -618
  304. package/src/utils/legend-integration.ts +0 -107
  305. package/src/utils/legend-layout.ts +0 -776
  306. package/src/utils/legend-svg.ts +0 -214
  307. package/src/utils/legend-types.ts +0 -272
  308. package/src/utils/name-normalize.ts +0 -163
  309. package/src/utils/note-box/constants.ts +0 -25
  310. package/src/utils/note-box/index.ts +0 -11
  311. package/src/utils/note-box/metrics.ts +0 -90
  312. package/src/utils/note-box/svg.ts +0 -331
  313. package/src/utils/notes/bounds.ts +0 -30
  314. package/src/utils/notes/build.ts +0 -131
  315. package/src/utils/notes/index.ts +0 -18
  316. package/src/utils/notes/model.ts +0 -19
  317. package/src/utils/notes/parse.ts +0 -131
  318. package/src/utils/notes/place.ts +0 -177
  319. package/src/utils/notes/resolve.ts +0 -88
  320. package/src/utils/number-format.ts +0 -36
  321. package/src/utils/parsing.ts +0 -953
  322. package/src/utils/reserved-key-registry.ts +0 -239
  323. package/src/utils/safe-href.ts +0 -38
  324. package/src/utils/scaling.ts +0 -97
  325. package/src/utils/svg-embed.ts +0 -251
  326. package/src/utils/tag-groups.ts +0 -607
  327. package/src/utils/text-measure.ts +0 -122
  328. package/src/utils/time-ticks.ts +0 -253
  329. package/src/utils/title-constants.ts +0 -24
  330. package/src/utils/visual-conventions.ts +0 -61
  331. package/src/utils/wrapped-desc.ts +0 -87
  332. package/src/venn/parser.ts +0 -18
  333. package/src/venn/renderer.ts +0 -1047
  334. package/src/version-control/diagnostics.ts +0 -67
  335. package/src/version-control/parser.ts +0 -544
  336. package/src/version-control/renderer.ts +0 -724
  337. package/src/version-control/types.ts +0 -100
  338. package/src/visualizations/parse.ts +0 -1560
  339. package/src/visualizations/types.ts +0 -262
  340. package/src/wireframe/layout.ts +0 -479
  341. package/src/wireframe/parser.ts +0 -1114
  342. package/src/wireframe/renderer.ts +0 -1318
  343. package/src/wireframe/types.ts +0 -110
  344. package/src/wordcloud/parser.ts +0 -18
  345. package/src/wordcloud/renderer.ts +0 -357
package/src/arc/parser.ts DELETED
@@ -1,15 +0,0 @@
1
- // ============================================================
2
- // arc parser door — Story 109.2 (arch-review).
3
- //
4
- // The six visualizations share one parse state machine (visualizations/parse.ts);
5
- // this is arc's typed entry point into it, returning the narrowed
6
- // ParsedArc shape. The registry binds the 'arc' chart type to this door.
7
- // ============================================================
8
-
9
- import type { PaletteColors } from '../palettes';
10
- import { parseVisualization } from '../visualizations/parse';
11
- import type { ParsedArc } from '../visualizations/types';
12
-
13
- export function parseArc(content: string, palette?: PaletteColors): ParsedArc {
14
- return parseVisualization(content, palette) as ParsedArc;
15
- }
@@ -1,633 +0,0 @@
1
- // ============================================================
2
- // Arc renderer — Story 109.2 (arch-review). Extracted from d3.ts.
3
- // ============================================================
4
-
5
- import * as d3Scale from 'd3-scale';
6
- import * as d3Selection from 'd3-selection';
7
- import * as d3Array from 'd3-array';
8
- import type { D3ExportDimensions } from '../utils/d3-types';
9
- import { ScaleContext } from '../utils/scaling';
10
- import { initD3Chart, renderChartTitle } from '../utils/d3-helpers';
11
- import type {
12
- ParsedArc,
13
- ArcLink,
14
- ArcOrder,
15
- ArcNodeGroup,
16
- } from '../visualizations/types';
17
- import type { PaletteColors } from '../palettes';
18
-
19
- export function orderArcNodes(
20
- links: ArcLink[],
21
- order: ArcOrder,
22
- groups: ArcNodeGroup[]
23
- ): string[] {
24
- // Collect all unique nodes in first-appearance order
25
- const nodeSet = new Set<string>();
26
- for (const link of links) {
27
- nodeSet.add(link.source);
28
- nodeSet.add(link.target);
29
- }
30
- const allNodes = Array.from(nodeSet);
31
-
32
- if (order === 'name') {
33
- return allNodes.slice().sort((a, b) => a.localeCompare(b));
34
- }
35
-
36
- if (order === 'degree') {
37
- const degree = new Map<string, number>();
38
- for (const node of allNodes) degree.set(node, 0);
39
- for (const link of links) {
40
- degree.set(link.source, degree.get(link.source)! + link.value);
41
- degree.set(link.target, degree.get(link.target)! + link.value);
42
- }
43
- return allNodes.slice().sort((a, b) => {
44
- const diff = degree.get(b)! - degree.get(a)!;
45
- return diff !== 0 ? diff : a.localeCompare(b);
46
- });
47
- }
48
-
49
- if (order === 'group') {
50
- if (groups.length > 0) {
51
- // Explicit groups: order by ## header order, appearance within each group
52
- const ordered: string[] = [];
53
- const placed = new Set<string>();
54
- for (const group of groups) {
55
- for (const node of group.nodes) {
56
- if (!placed.has(node)) {
57
- ordered.push(node);
58
- placed.add(node);
59
- }
60
- }
61
- }
62
- // Orphans at end in first-appearance order
63
- for (const node of allNodes) {
64
- if (!placed.has(node)) {
65
- ordered.push(node);
66
- placed.add(node);
67
- }
68
- }
69
- return ordered;
70
- }
71
- // No explicit groups: connectivity clustering via BFS
72
- const adj = new Map<string, Set<string>>();
73
- for (const node of allNodes) adj.set(node, new Set());
74
- for (const link of links) {
75
- adj.get(link.source)!.add(link.target);
76
- adj.get(link.target)!.add(link.source);
77
- }
78
-
79
- const degree = new Map<string, number>();
80
- for (const node of allNodes) degree.set(node, 0);
81
- for (const link of links) {
82
- degree.set(link.source, degree.get(link.source)! + link.value);
83
- degree.set(link.target, degree.get(link.target)! + link.value);
84
- }
85
-
86
- const visited = new Set<string>();
87
- const components: string[][] = [];
88
-
89
- const remaining = new Set(allNodes);
90
- while (remaining.size > 0) {
91
- // Pick highest-degree unvisited node as BFS root
92
- let root = '';
93
- let maxDeg = -1;
94
- for (const node of remaining) {
95
- if (degree.get(node)! > maxDeg) {
96
- maxDeg = degree.get(node)!;
97
- root = node;
98
- }
99
- }
100
- // BFS
101
- const component: string[] = [];
102
- const queue = [root];
103
- visited.add(root);
104
- remaining.delete(root);
105
- while (queue.length > 0) {
106
- const curr = queue.shift()!;
107
- component.push(curr);
108
- for (const neighbor of adj.get(curr)!) {
109
- if (!visited.has(neighbor)) {
110
- visited.add(neighbor);
111
- remaining.delete(neighbor);
112
- queue.push(neighbor);
113
- }
114
- }
115
- }
116
- components.push(component);
117
- }
118
- // Sort components by size descending
119
- components.sort((a, b) => b.length - a.length);
120
- return components.flat();
121
- }
122
-
123
- // 'appearance' — first-appearance order (default)
124
- return allNodes;
125
- }
126
-
127
- // ============================================================
128
- // Arc Diagram Renderer
129
- // ============================================================
130
-
131
- const ARC_MARGIN_TOP = 60;
132
- const ARC_MARGIN_RIGHT = 40;
133
- const ARC_MARGIN_BOTTOM = 60;
134
- const ARC_MARGIN_LEFT = 40;
135
- const ARC_MARGIN_LEFT_VERTICAL = 120;
136
- const ARC_NODE_RADIUS = 5;
137
- const ARC_NODE_STROKE_WIDTH = 1.5;
138
- const ARC_NODE_LABEL_FONT = 11;
139
- const ARC_GROUP_LABEL_FONT = 12;
140
- const ARC_BAND_HALF_W = 60;
141
- const ARC_BAND_HALF_H = 40;
142
- const ARC_BAND_RADIUS = 4;
143
- const ARC_BAND_LABEL_X_OFFSET = 6;
144
- const ARC_BAND_LABEL_Y_OFFSET = 14;
145
- const ARC_BAND_LABEL_BOTTOM_OFFSET = 4;
146
- const ARC_NODE_LABEL_X_OFFSET = 14;
147
- const ARC_NODE_LABEL_Y_OFFSET = 20;
148
- const ARC_STROKE_MIN = 1.5;
149
- const ARC_STROKE_MAX = 6;
150
- const ARC_BASELINE_STROKE_WIDTH = 1;
151
-
152
- /**
153
- * Renders an arc diagram into the given container using D3.
154
- */
155
- export function renderArcDiagram(
156
- container: HTMLDivElement,
157
- parsed: ParsedArc,
158
- palette: PaletteColors,
159
- _isDark: boolean,
160
- onClickItem?: (lineNumber: number) => void,
161
- exportDims?: D3ExportDimensions
162
- ): void {
163
- const { links, orientation, arcOrder, arcNodeGroups } = parsed;
164
- const title = parsed.noTitle ? null : parsed.title;
165
- if (links.length === 0) return;
166
-
167
- const init = initD3Chart(container, palette, exportDims);
168
- if (!init) return;
169
- const { svg, width, height, textColor, mutedColor, bgColor, colors } = init;
170
-
171
- const isVertical = orientation === 'vertical';
172
-
173
- const nodes = orderArcNodes(links, arcOrder, arcNodeGroups);
174
-
175
- const idealWidth = isVertical
176
- ? ARC_MARGIN_LEFT_VERTICAL + ARC_MARGIN_RIGHT + ARC_BAND_HALF_W * 2 + 100
177
- : nodes.length * 20 + ARC_MARGIN_LEFT + ARC_MARGIN_RIGHT;
178
- const ctx = exportDims
179
- ? ScaleContext.identity()
180
- : ScaleContext.from(width, idealWidth);
181
-
182
- const sMarginTop = ctx.aesthetic(ARC_MARGIN_TOP);
183
- const sMarginRight = ctx.aesthetic(ARC_MARGIN_RIGHT);
184
- const sMarginBottom = ctx.aesthetic(ARC_MARGIN_BOTTOM);
185
- const sMarginLeft = isVertical
186
- ? ctx.aesthetic(ARC_MARGIN_LEFT_VERTICAL)
187
- : ctx.aesthetic(ARC_MARGIN_LEFT);
188
- const sNodeRadius = ctx.structural(ARC_NODE_RADIUS);
189
- const sNodeStrokeWidth = ctx.structural(ARC_NODE_STROKE_WIDTH);
190
- const sNodeLabelFont = ctx.text(ARC_NODE_LABEL_FONT);
191
- const sGroupLabelFont = ctx.text(ARC_GROUP_LABEL_FONT);
192
- const sBandHalfW = ctx.aesthetic(ARC_BAND_HALF_W);
193
- const sBandHalfH = ctx.aesthetic(ARC_BAND_HALF_H);
194
- const sBandRadius = ctx.structural(ARC_BAND_RADIUS);
195
- const sBandLabelXOffset = ctx.structural(ARC_BAND_LABEL_X_OFFSET);
196
- const sBandLabelYOffset = ctx.structural(ARC_BAND_LABEL_Y_OFFSET);
197
- const sBandLabelBottomOffset = ctx.structural(ARC_BAND_LABEL_BOTTOM_OFFSET);
198
- const sNodeLabelXOffset = ctx.structural(ARC_NODE_LABEL_X_OFFSET);
199
- const sNodeLabelYOffset = ctx.structural(ARC_NODE_LABEL_Y_OFFSET);
200
- const sStrokeMin = ctx.structural(ARC_STROKE_MIN);
201
- const sStrokeMax = ctx.structural(ARC_STROKE_MAX);
202
- const sBaselineDash = `${ctx.structural(4)},${ctx.structural(4)}`;
203
- const sBaselineStrokeWidth = ctx.structural(ARC_BASELINE_STROKE_WIDTH);
204
-
205
- svg.attr('preserveAspectRatio', 'xMidYMin meet');
206
- if (ctx.isBelowFloor) {
207
- svg.attr('width', '100%');
208
- }
209
-
210
- const margin = {
211
- top: sMarginTop,
212
- right: sMarginRight,
213
- bottom: sMarginBottom,
214
- left: sMarginLeft,
215
- };
216
-
217
- const innerWidth = width - margin.left - margin.right;
218
- const innerHeight = height - margin.top - margin.bottom;
219
-
220
- const nodeColorMap = new Map<string, string>();
221
- for (const group of arcNodeGroups) {
222
- if (group.color) {
223
- for (const node of group.nodes) {
224
- if (!nodeColorMap.has(node)) {
225
- nodeColorMap.set(node, group.color);
226
- }
227
- }
228
- }
229
- }
230
-
231
- const groupNodeSets = new Map<string, Set<string>>();
232
- for (const group of arcNodeGroups) {
233
- groupNodeSets.set(group.name, new Set(group.nodes));
234
- }
235
-
236
- const values = links.map((l) => l.value);
237
- const [minVal, maxVal] = d3Array.extent(values) as [number, number];
238
- const strokeScale = d3Scale
239
- .scaleLinear()
240
- .domain([minVal, maxVal])
241
- .range([sStrokeMin, sStrokeMax]);
242
-
243
- const g = svg
244
- .append('g')
245
- .attr('transform', `translate(${margin.left},${margin.top})`);
246
-
247
- // Title
248
- renderChartTitle(
249
- svg,
250
- title,
251
- parsed.titleLineNumber,
252
- width,
253
- textColor,
254
- onClickItem
255
- );
256
-
257
- // Build adjacency map for hover interactions
258
- const neighbors = new Map<string, Set<string>>();
259
- for (const node of nodes) neighbors.set(node, new Set());
260
- for (const link of links) {
261
- neighbors.get(link.source)!.add(link.target);
262
- neighbors.get(link.target)!.add(link.source);
263
- }
264
-
265
- const FADE_OPACITY = 0.1;
266
-
267
- function handleMouseEnter(hovered: string) {
268
- const connected = neighbors.get(hovered)!;
269
-
270
- g.selectAll<SVGPathElement, unknown>('.arc-link').each(function () {
271
- const el = d3Selection.select(this);
272
- const src = el.attr('data-source');
273
- const tgt = el.attr('data-target');
274
- const isRelated = src === hovered || tgt === hovered;
275
- el.attr('stroke-opacity', isRelated ? 0.85 : FADE_OPACITY);
276
- });
277
-
278
- g.selectAll<SVGGElement, unknown>('.arc-node').each(function () {
279
- const el = d3Selection.select(this);
280
- const name = el.attr('data-node');
281
- const isRelated = name === hovered || connected.has(name!);
282
- el.attr('opacity', isRelated ? 1 : FADE_OPACITY);
283
- });
284
- }
285
-
286
- function handleMouseLeave() {
287
- g.selectAll<SVGPathElement, unknown>('.arc-link').attr(
288
- 'stroke-opacity',
289
- 0.7
290
- );
291
- g.selectAll<SVGGElement, unknown>('.arc-node').attr('opacity', 1);
292
- g.selectAll<SVGRectElement, unknown>('.arc-group-band').attr(
293
- 'fill-opacity',
294
- 0.06
295
- );
296
- g.selectAll<SVGTextElement, unknown>('.arc-group-label').attr(
297
- 'fill-opacity',
298
- 0.5
299
- );
300
- }
301
-
302
- function handleGroupEnter(groupName: string) {
303
- const members = groupNodeSets.get(groupName);
304
- if (!members) return;
305
-
306
- g.selectAll<SVGPathElement, unknown>('.arc-link').each(function () {
307
- const el = d3Selection.select(this);
308
- const isRelated =
309
- members.has(el.attr('data-source')!) ||
310
- members.has(el.attr('data-target')!);
311
- el.attr('stroke-opacity', isRelated ? 0.85 : FADE_OPACITY);
312
- });
313
-
314
- g.selectAll<SVGGElement, unknown>('.arc-node').each(function () {
315
- const el = d3Selection.select(this);
316
- el.attr('opacity', members.has(el.attr('data-node')!) ? 1 : FADE_OPACITY);
317
- });
318
-
319
- g.selectAll<SVGRectElement, unknown>('.arc-group-band').each(function () {
320
- const el = d3Selection.select(this);
321
- el.attr(
322
- 'fill-opacity',
323
- el.attr('data-group') === groupName ? 0.18 : 0.03
324
- );
325
- });
326
-
327
- g.selectAll<SVGTextElement, unknown>('.arc-group-label').each(function () {
328
- const el = d3Selection.select(this);
329
- el.attr('fill-opacity', el.attr('data-group') === groupName ? 1 : 0.2);
330
- });
331
- }
332
-
333
- if (isVertical) {
334
- // Vertical layout: nodes along Y axis, arcs curve to the right
335
- const yScale = d3Scale
336
- .scalePoint<string>()
337
- .domain(nodes)
338
- .range([0, innerHeight])
339
- .padding(0.5);
340
-
341
- const baseX = innerWidth / 2;
342
-
343
- // Group bands (shaded regions bounding grouped nodes)
344
- if (arcNodeGroups.length > 0) {
345
- const bandPad = (yScale.step?.() ?? 20) * 0.4;
346
- for (const group of arcNodeGroups) {
347
- const groupNodes = group.nodes.filter((n) => nodes.includes(n));
348
- if (groupNodes.length === 0) continue;
349
- const positions = groupNodes.map((n) => yScale(n)!);
350
- const minY = Math.min(...positions) - bandPad;
351
- const maxY = Math.max(...positions) + bandPad;
352
-
353
- g.append('rect')
354
- .attr('class', 'arc-group-band')
355
- .attr('data-group', group.name)
356
- .attr('data-line-number', String(group.lineNumber))
357
- .attr('x', baseX - sBandHalfW)
358
- .attr('y', minY)
359
- .attr('width', sBandHalfW * 2)
360
- .attr('height', maxY - minY)
361
- .attr('rx', sBandRadius)
362
- .attr('fill', textColor)
363
- .attr('fill-opacity', 0.06)
364
- .style('cursor', 'pointer')
365
- .on('mouseenter', () => handleGroupEnter(group.name))
366
- .on('mouseleave', handleMouseLeave)
367
- .on('click', () => {
368
- if (onClickItem) onClickItem(group.lineNumber);
369
- });
370
-
371
- g.append('text')
372
- .attr('class', 'arc-group-label')
373
- .attr('data-group', group.name)
374
- .attr('data-line-number', String(group.lineNumber))
375
- .attr('x', baseX - sBandHalfW + sBandLabelXOffset)
376
- .attr('y', minY + sBandLabelYOffset)
377
- .attr('fill', textColor)
378
- .attr('font-size', `${sGroupLabelFont}px`)
379
- .attr('font-weight', '600')
380
- .attr('fill-opacity', 0.5)
381
- .style('cursor', onClickItem ? 'pointer' : 'default')
382
- .text(group.name)
383
- .on('mouseenter', () => handleGroupEnter(group.name))
384
- .on('mouseleave', handleMouseLeave)
385
- .on('click', () => {
386
- if (onClickItem) onClickItem(group.lineNumber);
387
- });
388
- }
389
- }
390
-
391
- // Dashed vertical baseline
392
- g.append('line')
393
- .attr('x1', baseX)
394
- .attr('y1', 0)
395
- .attr('x2', baseX)
396
- .attr('y2', innerHeight)
397
- .attr('stroke', mutedColor)
398
- .attr('stroke-width', sBaselineStrokeWidth)
399
- .attr('stroke-dasharray', sBaselineDash);
400
-
401
- // Arcs
402
- links.forEach((link, idx) => {
403
- const y1 = yScale(link.source)!;
404
- const y2 = yScale(link.target)!;
405
- const midY = (y1 + y2) / 2;
406
- const distance = Math.abs(y2 - y1);
407
- const controlX = baseX + distance * 0.4;
408
- // colors is non-empty; modulo guarantees in-bounds.
409
- const color = link.color ?? colors[idx % colors.length]!;
410
-
411
- g.append('path')
412
- .attr('class', 'arc-link')
413
- .attr('data-source', link.source)
414
- .attr('data-target', link.target)
415
- .attr('data-line-number', String(link.lineNumber))
416
- .attr('d', `M ${baseX},${y1} Q ${controlX},${midY} ${baseX},${y2}`)
417
- .attr('fill', 'none')
418
- .attr('stroke', color)
419
- .attr('stroke-width', strokeScale(link.value))
420
- .attr('stroke-opacity', 0.7)
421
- .style('cursor', onClickItem ? 'pointer' : 'default')
422
- .on('click', () => {
423
- if (onClickItem && link.lineNumber) onClickItem(link.lineNumber);
424
- });
425
- });
426
-
427
- // Node circles and labels
428
- for (const node of nodes) {
429
- const y = yScale(node)!;
430
- const nodeColor = nodeColorMap.get(node) ?? textColor;
431
- // Find the first link involving this node (for line number and click target)
432
- const nodeLink = links.find(
433
- (l) => l.source === node || l.target === node
434
- );
435
-
436
- const nodeG = g
437
- .append('g')
438
- .attr('class', 'arc-node')
439
- .attr('data-node', node)
440
- .attr(
441
- 'data-line-number',
442
- nodeLink?.lineNumber ? String(nodeLink.lineNumber) : null
443
- )
444
- .style('cursor', 'pointer')
445
- .on('mouseenter', () => handleMouseEnter(node))
446
- .on('mouseleave', handleMouseLeave)
447
- .on('click', () => {
448
- if (onClickItem && nodeLink?.lineNumber)
449
- onClickItem(nodeLink.lineNumber);
450
- });
451
-
452
- nodeG
453
- .append('circle')
454
- .attr('cx', baseX)
455
- .attr('cy', y)
456
- .attr('r', sNodeRadius)
457
- .attr('fill', nodeColor)
458
- .attr('stroke', bgColor)
459
- .attr('stroke-width', sNodeStrokeWidth);
460
-
461
- nodeG
462
- .append('text')
463
- .attr('x', baseX - sNodeLabelXOffset)
464
- .attr('y', y)
465
- .attr('dy', '0.35em')
466
- .attr('text-anchor', 'end')
467
- .attr('fill', textColor)
468
- .attr('font-size', `${sNodeLabelFont}px`)
469
- .text(node);
470
- }
471
- } else {
472
- // Horizontal layout (default): nodes along X axis, arcs curve upward
473
- const xScale = d3Scale
474
- .scalePoint<string>()
475
- .domain(nodes)
476
- .range([0, innerWidth])
477
- .padding(0.5);
478
-
479
- // Live preview centers the baseline in the host container; export sizes the
480
- // canvas to the arc band so the SVG carries no dead whitespace (arcs bow up
481
- // by ~distance*0.2 above the baseline, labels/bands sit just below it).
482
- let baseY = innerHeight / 2;
483
- if (exportDims) {
484
- let maxDist = 0;
485
- for (const l of links) {
486
- const a = xScale(l.source);
487
- const b = xScale(l.target);
488
- if (a != null && b != null)
489
- maxDist = Math.max(maxDist, Math.abs(b - a));
490
- }
491
- const above = maxDist * 0.2 + sNodeRadius;
492
- const below = Math.max(sBandHalfH, sNodeLabelYOffset + sNodeLabelFont);
493
- baseY = above;
494
- const tightHeight = margin.top + above + below + margin.bottom;
495
- svg
496
- .attr('height', tightHeight)
497
- .attr('viewBox', `0 0 ${width} ${tightHeight}`);
498
- }
499
-
500
- // Group bands (shaded regions bounding grouped nodes)
501
- if (arcNodeGroups.length > 0) {
502
- const bandPad = (xScale.step?.() ?? 20) * 0.4;
503
- for (const group of arcNodeGroups) {
504
- const groupNodes = group.nodes.filter((n) => nodes.includes(n));
505
- if (groupNodes.length === 0) continue;
506
- const positions = groupNodes.map((n) => xScale(n)!);
507
- const minX = Math.min(...positions) - bandPad;
508
- const maxX = Math.max(...positions) + bandPad;
509
-
510
- g.append('rect')
511
- .attr('class', 'arc-group-band')
512
- .attr('data-group', group.name)
513
- .attr('data-line-number', String(group.lineNumber))
514
- .attr('x', minX)
515
- .attr('y', baseY - sBandHalfH)
516
- .attr('width', maxX - minX)
517
- .attr('height', sBandHalfH * 2)
518
- .attr('rx', sBandRadius)
519
- .attr('fill', textColor)
520
- .attr('fill-opacity', 0.06)
521
- .style('cursor', 'pointer')
522
- .on('mouseenter', () => handleGroupEnter(group.name))
523
- .on('mouseleave', handleMouseLeave)
524
- .on('click', () => {
525
- if (onClickItem) onClickItem(group.lineNumber);
526
- });
527
-
528
- g.append('text')
529
- .attr('class', 'arc-group-label')
530
- .attr('data-group', group.name)
531
- .attr('data-line-number', String(group.lineNumber))
532
- .attr('x', (minX + maxX) / 2)
533
- .attr('y', baseY + sBandHalfH - sBandLabelBottomOffset)
534
- .attr('text-anchor', 'middle')
535
- .attr('fill', textColor)
536
- .attr('font-size', `${sGroupLabelFont}px`)
537
- .attr('font-weight', '600')
538
- .attr('fill-opacity', 0.5)
539
- .style('cursor', onClickItem ? 'pointer' : 'default')
540
- .text(group.name)
541
- .on('mouseenter', () => handleGroupEnter(group.name))
542
- .on('mouseleave', handleMouseLeave)
543
- .on('click', () => {
544
- if (onClickItem) onClickItem(group.lineNumber);
545
- });
546
- }
547
- }
548
-
549
- // Dashed horizontal baseline
550
- g.append('line')
551
- .attr('x1', 0)
552
- .attr('y1', baseY)
553
- .attr('x2', innerWidth)
554
- .attr('y2', baseY)
555
- .attr('stroke', mutedColor)
556
- .attr('stroke-width', sBaselineStrokeWidth)
557
- .attr('stroke-dasharray', sBaselineDash);
558
-
559
- // Arcs
560
- links.forEach((link, idx) => {
561
- const x1 = xScale(link.source)!;
562
- const x2 = xScale(link.target)!;
563
- const midX = (x1 + x2) / 2;
564
- const distance = Math.abs(x2 - x1);
565
- const controlY = baseY - distance * 0.4;
566
- // colors is non-empty; modulo guarantees in-bounds.
567
- const color = link.color ?? colors[idx % colors.length]!;
568
-
569
- g.append('path')
570
- .attr('class', 'arc-link')
571
- .attr('data-source', link.source)
572
- .attr('data-target', link.target)
573
- .attr('data-line-number', String(link.lineNumber))
574
- .attr('d', `M ${x1},${baseY} Q ${midX},${controlY} ${x2},${baseY}`)
575
- .attr('fill', 'none')
576
- .attr('stroke', color)
577
- .attr('stroke-width', strokeScale(link.value))
578
- .attr('stroke-opacity', 0.7)
579
- .style('cursor', onClickItem ? 'pointer' : 'default')
580
- .on('click', () => {
581
- if (onClickItem && link.lineNumber) onClickItem(link.lineNumber);
582
- });
583
- });
584
-
585
- // Node circles and labels
586
- for (const node of nodes) {
587
- const x = xScale(node)!;
588
- const nodeColor = nodeColorMap.get(node) ?? textColor;
589
- // Find the first link involving this node (for line number and click target)
590
- const nodeLink = links.find(
591
- (l) => l.source === node || l.target === node
592
- );
593
-
594
- const nodeG = g
595
- .append('g')
596
- .attr('class', 'arc-node')
597
- .attr('data-node', node)
598
- .attr(
599
- 'data-line-number',
600
- nodeLink?.lineNumber ? String(nodeLink.lineNumber) : null
601
- )
602
- .style('cursor', 'pointer')
603
- .on('mouseenter', () => handleMouseEnter(node))
604
- .on('mouseleave', handleMouseLeave)
605
- .on('click', () => {
606
- if (onClickItem && nodeLink?.lineNumber)
607
- onClickItem(nodeLink.lineNumber);
608
- });
609
-
610
- nodeG
611
- .append('circle')
612
- .attr('cx', x)
613
- .attr('cy', baseY)
614
- .attr('r', sNodeRadius)
615
- .attr('fill', nodeColor)
616
- .attr('stroke', bgColor)
617
- .attr('stroke-width', sNodeStrokeWidth);
618
-
619
- nodeG
620
- .append('text')
621
- .attr('x', x)
622
- .attr('y', baseY + sNodeLabelYOffset)
623
- .attr('text-anchor', 'middle')
624
- .attr('fill', textColor)
625
- .attr('font-size', `${sNodeLabelFont}px`)
626
- .text(node);
627
- }
628
- }
629
- }
630
-
631
- // ============================================================
632
- // Timeline Era Bands
633
- // ============================================================