@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
@@ -1,214 +0,0 @@
1
- // ============================================================
2
- // Shared legend SVG string generator
3
- // Produces SVG <g> elements matching the standard legend style
4
- // used across all diagram types (capsule pills with colored dots).
5
- //
6
- // Both renderLegendSvg() (string, used by ECharts + static export) and
7
- // renderLegendD3() (DOM, used by every structured diagram) now drive off
8
- // the SAME layout engine — `computeLegendLayout` — so the ECharts legend
9
- // wraps long entry lists onto multiple rows exactly like the D3 diagrams.
10
- // This file is the SSR/string view of that layout; legend-d3.ts is the
11
- // interactive DOM view. Text is positioned with explicit baseline math
12
- // (not dominant-baseline) so resvg renders it correctly in PNG export.
13
- // ============================================================
14
-
15
- import { tagAttrKey } from './tag-groups';
16
- import type {
17
- LegendConfig,
18
- LegendState,
19
- LegendPalette,
20
- LegendCapsuleLayout,
21
- LegendPillLayout,
22
- LegendGroupData,
23
- } from './legend-types';
24
- import {
25
- LEGEND_HEIGHT,
26
- LEGEND_PILL_FONT_SIZE,
27
- LEGEND_DOT_R,
28
- LEGEND_ENTRY_FONT_SIZE,
29
- } from './legend-constants';
30
- import { computeLegendLayout } from './legend-layout';
31
- import { mix } from '../palettes/color-utils';
32
- import { FONT_FAMILY } from '../fonts';
33
-
34
- // ── Types ────────────────────────────────────────────────────
35
-
36
- interface LegendRenderOptions {
37
- palette: { bg: string; surface: string; text: string; textMuted: string };
38
- isDark: boolean;
39
- /**
40
- * Width to wrap entries against (entries flow onto new rows past this).
41
- * Pass 0 when the caller CSS-centers a natural-width legend; a generous
42
- * fallback budget is used so a single row still fits on one line.
43
- */
44
- containerWidth: number;
45
- activeGroup?: string | null;
46
- className?: string;
47
- }
48
-
49
- interface LegendRenderResult {
50
- svg: string;
51
- height: number;
52
- /** Natural content width (px). Callers can use this for CSS-based centering. */
53
- width: number;
54
- }
55
-
56
- // ── Helpers ──────────────────────────────────────────────────
57
-
58
- function esc(s: string): string {
59
- return s
60
- .replace(/&/g, '&amp;')
61
- .replace(/</g, '&lt;')
62
- .replace(/>/g, '&gt;')
63
- .replace(/"/g, '&quot;');
64
- }
65
-
66
- /** Active capsule (group pill + wrapped colored-dot entries) → SVG string. */
67
- function emitCapsule(
68
- capsule: LegendCapsuleLayout,
69
- palette: LegendRenderOptions['palette'],
70
- groupBg: string,
71
- pillBorder: string
72
- ): string {
73
- const inner: string[] = [];
74
- const pill = capsule.pill;
75
-
76
- // Outer capsule background (grows to the wrapped entry rows' height)
77
- inner.push(
78
- `<rect width="${capsule.width}" height="${capsule.height}" rx="${LEGEND_HEIGHT / 2}" fill="${esc(groupBg)}"/>`
79
- );
80
-
81
- // Inner pill background + border
82
- inner.push(
83
- `<rect x="${pill.x}" y="${pill.y}" width="${pill.width}" height="${pill.height}" rx="${pill.height / 2}" fill="${esc(palette.bg)}"/>`,
84
- `<rect x="${pill.x}" y="${pill.y}" width="${pill.width}" height="${pill.height}" rx="${pill.height / 2}" fill="none" stroke="${esc(pillBorder)}" stroke-width="0.75"/>`
85
- );
86
-
87
- // Pill text — vertically centered in the first row.
88
- inner.push(
89
- `<text x="${pill.x + pill.width / 2}" y="${LEGEND_HEIGHT / 2 + LEGEND_PILL_FONT_SIZE / 2 - 2}" font-size="${LEGEND_PILL_FONT_SIZE}" font-weight="500" fill="${esc(palette.text)}" text-anchor="middle" font-family="${esc(FONT_FAMILY)}">${esc(capsule.groupName)}</text>`
90
- );
91
-
92
- // Wrapped entries — dots + labels positioned by the layout engine.
93
- for (const entry of capsule.entries) {
94
- const label = entry.displayValue ?? entry.value;
95
- // Transparent hit-rect spanning the whole entry so hover/click land on the
96
- // full pill area, not only the dot/text glyphs (legend-hover emphasis in
97
- // charts-d3/interactions.ts needs a filled mouseenter target).
98
- const hit =
99
- entry.width != null
100
- ? `<rect x="${entry.x}" y="${entry.y}" width="${entry.width}" height="${LEGEND_HEIGHT}" fill="transparent"/>`
101
- : '';
102
- inner.push(
103
- `<g data-legend-entry="${esc(entry.value.toLowerCase())}" data-series-name="${esc(entry.value)}" style="cursor:pointer">` +
104
- hit +
105
- `<circle cx="${entry.dotCx}" cy="${entry.dotCy}" r="${LEGEND_DOT_R}" fill="${esc(entry.color)}"/>` +
106
- `<text x="${entry.textX}" y="${entry.dotCy + LEGEND_ENTRY_FONT_SIZE / 2 - 1}" font-size="${LEGEND_ENTRY_FONT_SIZE}" fill="${esc(palette.textMuted)}" font-family="${esc(FONT_FAMILY)}">${esc(label)}</text>` +
107
- `</g>`
108
- );
109
- }
110
-
111
- return `<g transform="translate(${capsule.x},${capsule.y})" data-legend-group="${esc(tagAttrKey(capsule.groupName))}" style="cursor:pointer">${inner.join('')}</g>`;
112
- }
113
-
114
- /** Collapsed group pill (no active group) → SVG string. */
115
- function emitPill(
116
- pill: LegendPillLayout,
117
- palette: LegendRenderOptions['palette'],
118
- groupBg: string
119
- ): string {
120
- return (
121
- `<g transform="translate(${pill.x},${pill.y})" data-legend-group="${esc(tagAttrKey(pill.groupName))}" style="cursor:pointer">` +
122
- `<rect width="${pill.width}" height="${pill.height}" rx="${pill.height / 2}" fill="${esc(groupBg)}"/>` +
123
- `<text x="${pill.width / 2}" y="${pill.height / 2 + LEGEND_PILL_FONT_SIZE / 2 - 2}" font-size="${LEGEND_PILL_FONT_SIZE}" font-weight="500" fill="${esc(palette.textMuted)}" text-anchor="middle" font-family="${esc(FONT_FAMILY)}">${esc(pill.groupName)}</text>` +
124
- `</g>`
125
- );
126
- }
127
-
128
- // ── Main renderer ────────────────────────────────────────────
129
-
130
- export function renderLegendSvg(
131
- groups: readonly LegendGroupData[],
132
- options: LegendRenderOptions
133
- ): LegendRenderResult {
134
- if (groups.length === 0) return { svg: '', height: 0, width: 0 };
135
-
136
- const { palette, isDark, containerWidth, activeGroup, className } = options;
137
-
138
- // The layout engine wraps entries against the available width. Callers that
139
- // CSS-center the legend pass containerWidth: 0 — fall back to a generous
140
- // budget so a single row still fits rather than wrapping one-per-line.
141
- const wrapWidth = containerWidth > 0 ? containerWidth : 1200;
142
-
143
- const config: LegendConfig = {
144
- groups,
145
- position: { placement: 'top-center', titleRelation: 'below-title' },
146
- mode: 'preview',
147
- };
148
- const state: LegendState = { activeGroup: activeGroup ?? null };
149
- const layout = computeLegendLayout(config, state, wrapWidth);
150
-
151
- if (!layout.activeCapsule && layout.pills.length === 0) {
152
- return { svg: '', height: 0, width: 0 };
153
- }
154
-
155
- const groupBg = isDark
156
- ? mix(palette.surface, palette.bg, 50)
157
- : mix(palette.surface, palette.bg, 30);
158
- const pillBorder = mix(palette.textMuted, palette.bg, 50);
159
-
160
- const parts: string[] = [];
161
- let bottom = 0;
162
- let left = Infinity;
163
- let right = 0;
164
-
165
- const track = (x: number, y: number, w: number, h: number): void => {
166
- left = Math.min(left, x);
167
- right = Math.max(right, x + w);
168
- bottom = Math.max(bottom, y + h);
169
- };
170
-
171
- if (layout.activeCapsule) {
172
- const c = layout.activeCapsule;
173
- parts.push(emitCapsule(c, palette, groupBg, pillBorder));
174
- track(c.x, c.y, c.width, c.height);
175
- }
176
- for (const pill of layout.pills) {
177
- parts.push(emitPill(pill, palette, groupBg));
178
- track(pill.x, pill.y, pill.width, pill.height);
179
- }
180
-
181
- const classAttr = className ? ` class="${esc(className)}"` : '';
182
- const activeAttr = activeGroup
183
- ? ` data-legend-active="${esc(tagAttrKey(activeGroup))}"`
184
- : '';
185
- const svg = `<g${classAttr}${activeAttr}>${parts.join('')}</g>`;
186
-
187
- return {
188
- svg,
189
- height: bottom,
190
- width: right - (left === Infinity ? 0 : left),
191
- };
192
- }
193
-
194
- // ── Config-based API ────────────────────────────────────────
195
-
196
- export function renderLegendSvgFromConfig(
197
- config: LegendConfig,
198
- state: LegendState,
199
- palette: LegendPalette & { isDark: boolean },
200
- containerWidth: number
201
- ): LegendRenderResult {
202
- // Delegate to existing renderer with adapted parameters
203
- return renderLegendSvg(config.groups, {
204
- palette: {
205
- bg: palette.bg,
206
- surface: palette.surface,
207
- text: palette.text,
208
- textMuted: palette.textMuted,
209
- },
210
- isDark: palette.isDark,
211
- containerWidth,
212
- activeGroup: state.activeGroup,
213
- });
214
- }
@@ -1,272 +0,0 @@
1
- // ============================================================
2
- // Centralized legend system — shared type definitions
3
- // ============================================================
4
-
5
- import type { Selection } from 'd3-selection';
6
-
7
- // ── State ───────────────────────────────────────────────────
8
-
9
- export interface LegendState {
10
- activeGroup: string | null;
11
- hiddenAttributes?: Set<string>;
12
- controlsExpanded?: boolean;
13
- }
14
-
15
- export interface LegendCallbacks {
16
- onGroupToggle?: (groupName: string) => void;
17
- onVisibilityToggle?: (attribute: string) => void;
18
- onStateChange?: (newState: LegendState) => void;
19
- /** Called when an entry is hovered. Chart renderers can use this for cross-element highlighting. */
20
- onEntryHover?: (groupName: string, entryValue: string | null) => void;
21
- /** Called after each group <g> is rendered — lets chart renderers inject custom elements (swimlane icons, etc.) */
22
- onGroupRendered?: (
23
- groupName: string,
24
- groupEl: D3Sel,
25
- isActive: boolean
26
- ) => void;
27
- /** Called when the controls group gear pill is clicked (expand/collapse) */
28
- onControlsExpand?: () => void;
29
- /** Called when a controls group toggle entry is clicked */
30
- onControlsToggle?: (toggleId: string, active: boolean) => void;
31
- }
32
-
33
- // ── Position & Layout ───────────────────────────────────────
34
-
35
- export interface LegendPosition {
36
- placement: 'top-center';
37
- titleRelation: 'below-title' | 'inline-with-title';
38
- }
39
-
40
- export type LegendMode = 'preview' | 'export';
41
-
42
- export type LegendControlExportBehavior = 'include' | 'strip' | 'static';
43
-
44
- export interface LegendControl {
45
- id: string;
46
- /** SVG markup for the control icon, or a string label */
47
- icon: string;
48
- label?: string;
49
- exportBehavior: LegendControlExportBehavior;
50
- onClick?: () => void;
51
- children?: LegendControlEntry[];
52
- }
53
-
54
- export interface LegendControlEntry {
55
- id: string;
56
- label: string;
57
- isActive?: boolean;
58
- onClick?: () => void;
59
- }
60
-
61
- // ── Controls Group ─────────────────────────────────────────
62
-
63
- export interface ControlsGroupToggle {
64
- id: string;
65
- /** Only 'toggle' is implemented in v1. 'select' and 'action' future-proof for Infra playback etc. */
66
- type: 'toggle' | 'select' | 'action';
67
- label: string;
68
- active: boolean;
69
- onToggle: (active: boolean) => void;
70
- }
71
-
72
- export interface ControlsGroupConfig {
73
- toggles: ControlsGroupToggle[];
74
- }
75
-
76
- // ── Group Data ──────────────────────────────────────────────
77
-
78
- export interface LegendGroupData {
79
- readonly name: string;
80
- readonly entries: ReadonlyArray<{
81
- readonly value: string;
82
- readonly color: string;
83
- }>;
84
- /** Continuous (choropleth) groups carry a gradient ramp instead of discrete
85
- * entries — its active capsule renders `min ▭gradient▭ max` rather than dots.
86
- * Additive: only the map sets it; every other caller omits it and renders
87
- * unchanged. When set, `entries` is empty. */
88
- readonly gradient?: {
89
- readonly min: number;
90
- readonly max: number;
91
- /** Resolved hex of the LOW (t=0) endpoint. For a single-colour ramp this is
92
- * the floored neutral (`mix(hue, base, RAMP_FLOOR)`); for an explicit
93
- * two-colour ramp it is the user's low colour. */
94
- readonly low: string;
95
- /** Resolved hex of the HIGH (t=1) endpoint (the named hue). */
96
- readonly high: string;
97
- };
98
- }
99
-
100
- // ── Config ──────────────────────────────────────────────────
101
-
102
- export interface LegendConfig {
103
- groups: readonly LegendGroupData[];
104
- position: LegendPosition;
105
- controls?: LegendControl[];
106
- controlsGroup?: ControlsGroupConfig;
107
- mode: LegendMode;
108
- /** Title width in pixels — used for inline-with-title computation */
109
- titleWidth?: number;
110
- /** Extra width (px) reserved after the pill inside an active capsule (e.g. for eye icon addon). Entries start after this offset. */
111
- capsulePillAddonWidth?: number;
112
- /** When true, groups with no entries are still rendered as collapsed pills. Default: false (empty groups hidden). */
113
- showEmptyGroups?: boolean;
114
- /** When true, INACTIVE sibling groups still render as collapsed pills next to
115
- * the active capsule (preview only — export still shows just the active
116
- * group). Lets the user click a sibling to switch the active group. Default
117
- * false (legacy: when one group is active the others are hidden). */
118
- showInactivePills?: boolean;
119
- /** Where the controlsGroup is hosted. Default (undefined / 'inline') renders
120
- * the in-SVG gear exactly as before — every non-app consumer (Obsidian,
121
- * site, remark-family, CLI) is unaffected. When 'app', the controlsGroup is
122
- * dropped entirely (no gear, no reserved row): the app overlay strip owns the
123
- * controls, pinned to the top edge of the preview. App preview only; never
124
- * set on the export path. */
125
- controlsHost?: 'app' | 'inline';
126
- }
127
-
128
- export interface LegendPalette {
129
- bg: string;
130
- surface: string;
131
- text: string;
132
- textMuted: string;
133
- primary?: string;
134
- }
135
-
136
- // ── Layout output ───────────────────────────────────────────
137
-
138
- export interface LegendPillLayout {
139
- groupName: string;
140
- x: number;
141
- y: number;
142
- width: number;
143
- height: number;
144
- isActive: boolean;
145
- }
146
-
147
- export interface LegendEntryLayout {
148
- value: string;
149
- color: string;
150
- x: number;
151
- y: number;
152
- dotCx: number;
153
- dotCy: number;
154
- textX: number;
155
- textY: number;
156
- displayValue?: string;
157
- /** Full entry advance width (dot + gap + text + trail). Consumers draw a
158
- * transparent hit-rect of this width so the whole pill is hoverable, not
159
- * just the dot/text glyphs (legend-hover emphasis needs a filled target). */
160
- width?: number;
161
- }
162
-
163
- export interface LegendCapsuleLayout {
164
- groupName: string;
165
- x: number;
166
- y: number;
167
- width: number;
168
- height: number;
169
- pill: LegendPillLayout;
170
- entries: LegendEntryLayout[];
171
- /** Overflow indicator when entries exceed max rows */
172
- moreCount?: number;
173
- /** X offset where addon content (e.g. eye icon) can be placed — after pill, before entries */
174
- addonX?: number;
175
- /** Continuous-ramp swatch (choropleth groups) drawn in place of entry dots:
176
- * `minText` | gradient rect | `maxText`, all vertically centred. */
177
- gradient?: {
178
- rampX: number;
179
- rampY: number;
180
- rampW: number;
181
- rampH: number;
182
- /** Raw numeric ends (for the app's gradient-scrub: x → value). */
183
- min: number;
184
- max: number;
185
- minText: string;
186
- minX: number;
187
- maxText: string;
188
- maxX: number;
189
- textY: number;
190
- /** Resolved hex endpoints (low = t0, high = t1); the renderer samples the
191
- * ramp between them via `valueRampStops`. */
192
- low: string;
193
- high: string;
194
- };
195
- }
196
-
197
- export interface LegendControlLayout {
198
- id: string;
199
- x: number;
200
- y: number;
201
- width: number;
202
- height: number;
203
- icon: string;
204
- label?: string;
205
- exportBehavior: LegendControlExportBehavior;
206
- children?: Array<{
207
- id: string;
208
- label: string;
209
- x: number;
210
- y: number;
211
- width: number;
212
- isActive?: boolean;
213
- }>;
214
- }
215
-
216
- export interface ControlsGroupToggleLayout {
217
- id: string;
218
- label: string;
219
- active: boolean;
220
- dotCx: number;
221
- dotCy: number;
222
- textX: number;
223
- textY: number;
224
- }
225
-
226
- export interface ControlsGroupLayout {
227
- x: number;
228
- y: number;
229
- width: number;
230
- height: number;
231
- expanded: boolean;
232
- /** The gear pill layout (collapsed or inside capsule) */
233
- pill: { x: number; y: number; width: number; height: number };
234
- /** Toggle entries (only present when expanded) */
235
- toggles: ControlsGroupToggleLayout[];
236
- }
237
-
238
- export interface LegendRowLayout {
239
- y: number;
240
- items: Array<LegendPillLayout | LegendCapsuleLayout | LegendControlLayout>;
241
- }
242
-
243
- export interface LegendLayout {
244
- /** Total computed height including all rows */
245
- height: number;
246
- /** Total computed width */
247
- width: number;
248
- /** Rows of legend elements (pills wrap to new rows on overflow) */
249
- rows: LegendRowLayout[];
250
- /** Active capsule layout (if any group is active) */
251
- activeCapsule?: LegendCapsuleLayout;
252
- /** Control layouts (right-aligned) */
253
- controls: LegendControlLayout[];
254
- /** All pill layouts (collapsed groups) */
255
- pills: LegendPillLayout[];
256
- /** Controls group layout (gear pill / capsule) */
257
- controlsGroup?: ControlsGroupLayout;
258
- }
259
-
260
- // ── Handle ──────────────────────────────────────────────────
261
-
262
- export interface LegendHandle {
263
- setState: (state: LegendState) => void;
264
- destroy: () => void;
265
- getHeight: () => number;
266
- getLayout: () => LegendLayout;
267
- }
268
-
269
- // ── D3 selection shorthand ──────────────────────────────────
270
-
271
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
272
- export type D3Sel = Selection<any, unknown, any, unknown>;
@@ -1,163 +0,0 @@
1
- // ============================================================
2
- // Universal Name Normalization (Universal Name Handling spec)
3
- // ============================================================
4
- //
5
- // One pinned algorithm shared by every chart-type parser that
6
- // auto-creates entities on first use. Two source-distinct names
7
- // that normalize to the same key are treated as the same entity;
8
- // the FIRST-SEEN casing/spacing wins for display.
9
- //
10
- // Pinned algorithm (do not vary across parsers):
11
- // 1. NFC normalize the input
12
- // 2. Replace runs of Unicode whitespace with a single ASCII space
13
- // 3. Trim leading/trailing whitespace
14
- // 4. Case-fold via `toLocaleLowerCase('en-US')`
15
- //
16
- // The `en-US` locale is intentional — language-neutral case folding
17
- // would silently diverge across parsers (Turkish dotted/dotless I,
18
- // German ß) the moment a build environment changed locale defaults.
19
- //
20
- // See `docs/dgmo-language-spec.md` § "Universal Name Handling".
21
-
22
- /** Module-scoped — Unicode-aware whitespace run. */
23
- const WHITESPACE_RUN_RE = /\s+/gu;
24
-
25
- /**
26
- * Reduce a name to its canonical key for equality comparison.
27
- *
28
- * Idempotent: `normalizeName(normalizeName(x)) === normalizeName(x)`.
29
- *
30
- * The returned key is for equality only — never display it. Callers
31
- * that need to render a name should use the `displayLabel` field of
32
- * the `NameEntry` returned by `getOrCreateName`.
33
- */
34
- export function normalizeName(input: string): string {
35
- return input
36
- .normalize('NFC')
37
- .replace(WHITESPACE_RUN_RE, ' ')
38
- .trim()
39
- .toLocaleLowerCase('en-US');
40
- }
41
-
42
- /**
43
- * Reduce a name to its display form: NFC normalize and trim only.
44
- *
45
- * Casing AND internal whitespace are preserved verbatim — the spec
46
- * says "first-seen casing/spacing wins for display" (ADR-002), so a
47
- * double space typed by the user survives into the rendered label.
48
- * Renderers may collapse it for layout, but the source-of-truth is
49
- * what the user typed.
50
- *
51
- * Two inputs that share the same `normalizeName(...)` key but have
52
- * different `displayName(...)` values are a "merge" — surfaced via
53
- * the `NAME_MERGED` diagnostic.
54
- */
55
- export function displayName(input: string): string {
56
- return input.normalize('NFC').trim();
57
- }
58
-
59
- /**
60
- * One entity, identified by its normalized key.
61
- *
62
- * Parsers either use this shape directly in their entity Map or
63
- * compose it into a richer per-chart node type. Equality MUST use
64
- * only `normalizedKey`; rendering MUST use only `displayLabel`.
65
- */
66
- export interface NameEntry {
67
- /** Output of `normalizeName(input)` — the lookup key. */
68
- normalizedKey: string;
69
- /** First-seen casing/spacing — what gets rendered. */
70
- displayLabel: string;
71
- /** 1-based source line where the name was first declared. */
72
- declaredLine: number;
73
- }
74
-
75
- /**
76
- * Result of an entity insertion attempt.
77
- *
78
- * `created` is true on first sighting. `merged` is present iff the
79
- * input collided with an existing entry AND the displayed forms
80
- * differ — that is the case worth reporting via `NAME_MERGED`.
81
- * Identical re-declarations produce neither `created` nor `merged`.
82
- */
83
- export interface GetOrCreateNameResult {
84
- entry: NameEntry;
85
- created: boolean;
86
- merged?: {
87
- existingLine: number;
88
- existingDisplay: string;
89
- incomingDisplay: string;
90
- };
91
- }
92
-
93
- /**
94
- * Insert-or-fetch helper for `Map<normalizedKey, NameEntry>` stores.
95
- *
96
- * Parsers that need a richer node type (e.g. flowchart's `Node`
97
- * carries shape + edges) should wrap this helper: call it for the
98
- * normalization + merge-detection bookkeeping, then store the result
99
- * in their own `Map<normalizedKey, RichNode>`.
100
- *
101
- * When an `aliasStore` is provided, alias resolution runs FIRST: an
102
- * exact-match (case-sensitive) hit returns the bound canonical entry
103
- * untouched (the alias literal does NOT contribute to display or
104
- * merge bookkeeping). Misses fall through to UNH normalization.
105
- */
106
- export function getOrCreateName(
107
- input: string,
108
- store: Map<string, NameEntry>,
109
- lineNumber: number,
110
- aliasStore?: AliasMap
111
- ): GetOrCreateNameResult {
112
- // Alias resolution is exact-match, case-sensitive, never normalized.
113
- // A miss falls through to UNH; a hit short-circuits with the bound
114
- // canonical entry — see B5 in the tech-spec.
115
- if (aliasStore !== undefined) {
116
- const aliased = aliasStore.get(input.trim());
117
- if (aliased !== undefined) {
118
- return { entry: aliased, created: false };
119
- }
120
- }
121
-
122
- const key = normalizeName(input);
123
- const incomingDisplay = displayName(input);
124
-
125
- const existing = store.get(key);
126
- if (existing) {
127
- if (existing.displayLabel !== incomingDisplay) {
128
- return {
129
- entry: existing,
130
- created: false,
131
- merged: {
132
- existingLine: existing.declaredLine,
133
- existingDisplay: existing.displayLabel,
134
- incomingDisplay,
135
- },
136
- };
137
- }
138
- return { entry: existing, created: false };
139
- }
140
-
141
- const entry: NameEntry = {
142
- normalizedKey: key,
143
- displayLabel: incomingDisplay,
144
- declaredLine: lineNumber,
145
- };
146
- store.set(key, entry);
147
- return { entry, created: true };
148
- }
149
-
150
- // ============================================================
151
- // Universal Alias Map (sibling structure — TD-18)
152
- // ============================================================
153
- //
154
- // Aliases are short-token bindings to existing `NameEntry` records.
155
- // Distinct from UNH normalization: aliases are exact-match,
156
- // case-sensitive ASCII tokens. `pm` and `PM` are different aliases.
157
- //
158
- // The map is per-parse — never persisted. LSP incremental-parse
159
- // implementations MUST clear and rebuild from scratch (C8). See the
160
- // `ParseContext` shape below for the threading model.
161
-
162
- /** alias literal → bound canonical entry. Exact-match, case-sensitive. */
163
- export type AliasMap = Map<string, NameEntry>;
@@ -1,25 +0,0 @@
1
- // ============================================================
2
- // Shared note-box primitive — constants
3
- // ============================================================
4
- //
5
- // Lifted verbatim from the sequence renderer's note constants
6
- // (sequence/renderer.ts) so any chart type can draw the same
7
- // folded-corner annotation box. Pure values — no chart coupling.
8
-
9
- /** Hard ceiling on a note box's width (px) before text wraps. */
10
- export const NOTE_MAX_W = 200;
11
- /** Size of the folded top-right corner (px). */
12
- export const NOTE_FOLD = 10;
13
- /** Horizontal padding inside the box (px). */
14
- export const NOTE_PAD_H = 8;
15
- /** Vertical padding inside the box (px). */
16
- export const NOTE_PAD_V = 6;
17
- /** Note body font size (px). */
18
- export const NOTE_FONT_SIZE = 10;
19
- /** Line height for wrapped body lines (px). */
20
- export const NOTE_LINE_H = 14;
21
- /** Gap between an anchor shape's edge and its floated note box (px). The
22
- * note is tethered to its node with a solid connector across this gap. */
23
- export const NOTE_GAP = 22;
24
- /** Hanging-indent width for bullet body text past the "•" glyph (px). */
25
- export const NOTE_BULLET_INDENT = 10;
@@ -1,11 +0,0 @@
1
- // ============================================================
2
- // Shared note-box primitive — barrel
3
- // ============================================================
4
- //
5
- // Generic folded-corner annotation box, extracted from the sequence
6
- // renderer so any node/edge chart type can adopt notes by writing only
7
- // an anchor resolver + placement policy — never re-implementing the box.
8
-
9
- export * from './constants';
10
- export * from './metrics';
11
- export * from './svg';