@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,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';