@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.
- package/dist/advanced.js +11 -11
- package/dist/auto.js +16 -16
- package/dist/auto.mjs +41 -12
- package/dist/block.js +4 -4
- package/dist/{chunk-FNB3PNGF.js → chunk-7DTWEFUE.js} +3 -3
- package/dist/{chunk-2DXMZRWJ.js → chunk-B65G5DNL.js} +8 -1
- package/dist/{chunk-RZCF2VVM.js → chunk-B7JUCQUA.js} +3 -1
- package/dist/{chunk-DU7W62N5.js → chunk-FANX6UJR.js} +3 -3
- package/dist/{chunk-6FZYCKXB.js → chunk-HSH73DP6.js} +2 -2
- package/dist/{chunk-P4RH4OSP.js → chunk-ILKORZ3H.js} +2 -2
- package/dist/{chunk-Y5QGVTVC.js → chunk-JTSMEYIZ.js} +7 -3
- package/dist/{chunk-RCERWOJR.js → chunk-ODZVHU3R.js} +1 -2
- package/dist/{chunk-DZAQBW35.js → chunk-SGZYXELT.js} +3 -7
- package/dist/{chunk-CUVHQHZ7.js → chunk-THXCFRTU.js} +3 -3
- package/dist/{chunk-IH6ZMVQ5.js → chunk-UC7TFHUM.js} +29 -11
- package/dist/{chunk-EMS2SK26.js → chunk-ZBWMSD5N.js} +3 -1
- package/dist/cli.cjs +15 -15
- package/dist/{dgmo-router-DZCIDUO5.js → dgmo-router-X35VLZLM.js} +3 -3
- package/dist/element.js +16 -16
- package/dist/element.mjs +41 -12
- package/dist/{flowchart-renderer-ZAEOL4DX.js → flowchart-renderer-SNDSII4D.js} +2 -2
- package/dist/index.d.ts +4 -2
- package/dist/index.js +4 -4
- package/dist/{parser-FUSKFGZN.js → parser-2EWECDSA.js} +2 -2
- package/dist/{renderer-UWA5XS74.js → renderer-4JHRUBE6.js} +3 -3
- package/dist/{renderer-WZRREQ2P.js → renderer-5MYBMBYO.js} +2 -2
- package/dist/{renderer-TOCOVLHS.js → renderer-B2OMQIQG.js} +3 -3
- package/dist/{renderer-2XQQQ6QR.js → renderer-N43WR5GV.js} +3 -3
- package/dist/{renderer-T7YKC5VP.js → renderer-ZRNG54CW.js} +3 -3
- package/dist/{state-renderer-RFYHSP4K.js → state-renderer-B4DQBM6M.js} +2 -2
- package/package.json +23 -71
- package/dist/advanced.cjs +0 -71648
- package/dist/advanced.d.cts +0 -5719
- package/dist/auto.cjs +0 -70648
- package/dist/auto.d.cts +0 -54
- package/dist/block.cjs +0 -70208
- package/dist/block.d.cts +0 -115
- package/dist/editor.cjs +0 -526
- package/dist/editor.d.cts +0 -26
- package/dist/element.cjs +0 -70530
- package/dist/element.d.cts +0 -62
- package/dist/highlight.cjs +0 -852
- package/dist/highlight.d.cts +0 -49
- package/dist/index.cjs +0 -70491
- package/dist/index.d.cts +0 -160
- package/dist/pert.cjs +0 -325
- package/dist/pert.d.cts +0 -559
- package/dist/themes-1-CuKpeH.d.cts +0 -908
- package/src/advanced.ts +0 -873
- package/src/arc/parser.ts +0 -15
- package/src/arc/renderer.ts +0 -633
- package/src/auto/index.ts +0 -621
- package/src/auto/shared.ts +0 -370
- package/src/auto/styles.ts +0 -73
- package/src/block/layout.ts +0 -198
- package/src/block/parser.ts +0 -427
- package/src/block/renderer.ts +0 -484
- package/src/block/types.ts +0 -67
- package/src/boxes-and-lines/collapse.ts +0 -96
- package/src/boxes-and-lines/focus.ts +0 -257
- package/src/boxes-and-lines/label-placement.ts +0 -339
- package/src/boxes-and-lines/layout-grouped.ts +0 -912
- package/src/boxes-and-lines/layout-layered.ts +0 -722
- package/src/boxes-and-lines/layout-search.ts +0 -1678
- package/src/boxes-and-lines/layout.ts +0 -398
- package/src/boxes-and-lines/parser.ts +0 -1181
- package/src/boxes-and-lines/renderer.ts +0 -1465
- package/src/boxes-and-lines/types.ts +0 -66
- package/src/c4/layout.ts +0 -2441
- package/src/c4/parser.ts +0 -1158
- package/src/c4/renderer.ts +0 -2008
- package/src/c4/types.ts +0 -89
- package/src/chart-type-registry.ts +0 -529
- package/src/chart-types.ts +0 -225
- package/src/chart.ts +0 -685
- package/src/charts-d3/bar.ts +0 -338
- package/src/charts-d3/chord.ts +0 -140
- package/src/charts-d3/function.ts +0 -147
- package/src/charts-d3/funnel.ts +0 -104
- package/src/charts-d3/heatmap.ts +0 -145
- package/src/charts-d3/index.ts +0 -337
- package/src/charts-d3/interactions.ts +0 -477
- package/src/charts-d3/line.ts +0 -344
- package/src/charts-d3/mount.ts +0 -151
- package/src/charts-d3/pie.ts +0 -117
- package/src/charts-d3/polar.ts +0 -89
- package/src/charts-d3/radar.ts +0 -0
- package/src/charts-d3/sankey.ts +0 -0
- package/src/charts-d3/scatter.ts +0 -185
- package/src/charts-d3/shared.ts +0 -208
- package/src/class/layout.ts +0 -326
- package/src/class/parser.ts +0 -635
- package/src/class/renderer.ts +0 -793
- package/src/class/types.ts +0 -58
- package/src/cli-banner.ts +0 -106
- package/src/cli.ts +0 -1080
- package/src/colors-diagnostics.ts +0 -35
- package/src/colors.ts +0 -379
- package/src/completion-types.ts +0 -27
- package/src/completion.ts +0 -2668
- package/src/cycle/layout.ts +0 -1026
- package/src/cycle/parser.ts +0 -387
- package/src/cycle/renderer.ts +0 -653
- package/src/cycle/types.ts +0 -101
- package/src/d3.ts +0 -1434
- package/src/data-chart-parser.ts +0 -1007
- package/src/dgmo-router.ts +0 -296
- package/src/diagnostics-registry.ts +0 -108
- package/src/diagnostics.ts +0 -0
- package/src/dimensions.ts +0 -20
- package/src/directives-registry.ts +0 -396
- package/src/editor/dgmo.grammar +0 -76
- package/src/editor/dgmo.grammar.d.ts +0 -2
- package/src/editor/dgmo.grammar.js +0 -18
- package/src/editor/dgmo.grammar.terms.d.ts +0 -5
- package/src/editor/dgmo.grammar.terms.js +0 -35
- package/src/editor/highlight-api.ts +0 -596
- package/src/editor/highlight.ts +0 -36
- package/src/editor/index.ts +0 -27
- package/src/editor/keywords.ts +0 -128
- package/src/editor/tokens.ts +0 -30
- package/src/element/index.ts +0 -432
- package/src/embed/css.ts +0 -312
- package/src/embed/escape.ts +0 -15
- package/src/embed/index.ts +0 -280
- package/src/er/classify.ts +0 -228
- package/src/er/layout.ts +0 -530
- package/src/er/parser.ts +0 -750
- package/src/er/renderer.ts +0 -725
- package/src/er/types.ts +0 -52
- package/src/error-card.ts +0 -269
- package/src/event-line/diagnostics.ts +0 -117
- package/src/event-line/parser.ts +0 -643
- package/src/event-line/renderer.ts +0 -1742
- package/src/event-line/types.ts +0 -74
- package/src/fonts.ts +0 -3
- package/src/gantt/calculator.ts +0 -979
- package/src/gantt/parser.ts +0 -1641
- package/src/gantt/renderer.ts +0 -3787
- package/src/gantt/resolver.ts +0 -172
- package/src/gantt/types.ts +0 -206
- package/src/graph/diagnostics.ts +0 -64
- package/src/graph/edge-spline.ts +0 -29
- package/src/graph/flowchart-parser.ts +0 -759
- package/src/graph/flowchart-renderer.ts +0 -817
- package/src/graph/layout.ts +0 -472
- package/src/graph/notes.ts +0 -21
- package/src/graph/state-collapse.ts +0 -78
- package/src/graph/state-parser.ts +0 -574
- package/src/graph/state-renderer.ts +0 -653
- package/src/graph/types.ts +0 -65
- package/src/index.ts +0 -261
- package/src/infra/compute.ts +0 -1385
- package/src/infra/layout.ts +0 -888
- package/src/infra/parser.ts +0 -1234
- package/src/infra/renderer.ts +0 -2534
- package/src/infra/roles.ts +0 -75
- package/src/infra/types.ts +0 -216
- package/src/infra/validation.ts +0 -201
- package/src/journey-map/layout.ts +0 -490
- package/src/journey-map/parser.ts +0 -557
- package/src/journey-map/renderer.ts +0 -1580
- package/src/journey-map/types.ts +0 -47
- package/src/kanban/mutations.ts +0 -175
- package/src/kanban/parser.ts +0 -509
- package/src/kanban/renderer.ts +0 -1449
- package/src/kanban/types.ts +0 -39
- package/src/label-layout.ts +0 -368
- package/src/map/colorize.ts +0 -54
- package/src/map/completion.ts +0 -316
- package/src/map/context-labels.ts +0 -609
- package/src/map/data/PROVENANCE.json +0 -1
- package/src/map/data/README.md +0 -40
- package/src/map/data/airport-collisions.json +0 -1
- package/src/map/data/airports.json +0 -1
- package/src/map/data/gazetteer.json +0 -1
- package/src/map/data/lakes.json +0 -1
- package/src/map/data/mountain-ranges.json +0 -1
- package/src/map/data/na-lakes.json +0 -1
- package/src/map/data/na-land.json +0 -1
- package/src/map/data/region-names.json +0 -1
- package/src/map/data/rivers.json +0 -1
- package/src/map/data/types.ts +0 -121
- package/src/map/data/us-states.json +0 -1
- package/src/map/data/water-bodies.json +0 -1
- package/src/map/data/world-coarse.json +0 -1
- package/src/map/data/world-detail.json +0 -1
- package/src/map/diagnostics.ts +0 -134
- package/src/map/dimensions.ts +0 -150
- package/src/map/geo-query.ts +0 -295
- package/src/map/geo.ts +0 -438
- package/src/map/invert.ts +0 -111
- package/src/map/layout.ts +0 -5069
- package/src/map/legend-band.ts +0 -127
- package/src/map/load-data.ts +0 -186
- package/src/map/parser.ts +0 -783
- package/src/map/renderer.ts +0 -1445
- package/src/map/resolved-types.ts +0 -160
- package/src/map/resolver.ts +0 -1146
- package/src/map/types.ts +0 -194
- package/src/mindmap/collapse.ts +0 -67
- package/src/mindmap/layout.ts +0 -649
- package/src/mindmap/parser.ts +0 -430
- package/src/mindmap/renderer.ts +0 -637
- package/src/mindmap/text-wrap.ts +0 -218
- package/src/mindmap/types.ts +0 -56
- package/src/org/collapse.ts +0 -151
- package/src/org/layout.ts +0 -1262
- package/src/org/parser.ts +0 -519
- package/src/org/renderer.ts +0 -866
- package/src/org/resolver.ts +0 -636
- package/src/palettes/atlas.ts +0 -77
- package/src/palettes/blueprint.ts +0 -73
- package/src/palettes/catppuccin.ts +0 -84
- package/src/palettes/color-utils.ts +0 -443
- package/src/palettes/index.ts +0 -67
- package/src/palettes/nord.ts +0 -67
- package/src/palettes/registry.ts +0 -114
- package/src/palettes/slate.ts +0 -73
- package/src/palettes/tidewater.ts +0 -73
- package/src/palettes/tokyo-night.ts +0 -86
- package/src/palettes/types.ts +0 -88
- package/src/pert/analyzer.ts +0 -1183
- package/src/pert/diagnostics.ts +0 -110
- package/src/pert/index.ts +0 -43
- package/src/pert/internal.ts +0 -252
- package/src/pert/layout.ts +0 -971
- package/src/pert/monte-carlo.ts +0 -446
- package/src/pert/parser.ts +0 -1606
- package/src/pert/renderer.ts +0 -4009
- package/src/pert/share-normalize.ts +0 -62
- package/src/pert/types.ts +0 -604
- package/src/pyramid/parser.ts +0 -185
- package/src/pyramid/renderer.ts +0 -768
- package/src/pyramid/types.ts +0 -28
- package/src/quadrant/parser.ts +0 -18
- package/src/quadrant/renderer.ts +0 -638
- package/src/raci/diagnostics.ts +0 -213
- package/src/raci/index.ts +0 -23
- package/src/raci/mutations.ts +0 -321
- package/src/raci/parser.ts +0 -699
- package/src/raci/renderer.ts +0 -1627
- package/src/raci/types.ts +0 -82
- package/src/raci/variants.ts +0 -320
- package/src/render.ts +0 -268
- package/src/ring/parser.ts +0 -212
- package/src/ring/renderer.ts +0 -490
- package/src/ring/types.ts +0 -27
- package/src/sequence/collapse.ts +0 -174
- package/src/sequence/parser.ts +0 -1596
- package/src/sequence/participant-inference.ts +0 -152
- package/src/sequence/renderer.ts +0 -3168
- package/src/sequence/tag-resolution.ts +0 -164
- package/src/sharing.ts +0 -211
- package/src/sitemap/collapse.ts +0 -100
- package/src/sitemap/layout.ts +0 -925
- package/src/sitemap/parser.ts +0 -755
- package/src/sitemap/renderer.ts +0 -828
- package/src/sitemap/types.ts +0 -42
- package/src/slope/parser.ts +0 -18
- package/src/slope/renderer.ts +0 -378
- package/src/swimlane/diagnostics.ts +0 -94
- package/src/swimlane/layout.ts +0 -597
- package/src/swimlane/parser.ts +0 -613
- package/src/swimlane/renderer.ts +0 -681
- package/src/swimlane/types.ts +0 -151
- package/src/tech-radar/interactive.ts +0 -1129
- package/src/tech-radar/layout.ts +0 -197
- package/src/tech-radar/parser.ts +0 -436
- package/src/tech-radar/renderer.ts +0 -1239
- package/src/tech-radar/shared.ts +0 -151
- package/src/tech-radar/types.ts +0 -86
- package/src/themes.ts +0 -22
- package/src/timeline/parser.ts +0 -472
- package/src/timeline/renderer.ts +0 -3024
- package/src/timeline/types.ts +0 -33
- package/src/timeline/viz-parser.ts +0 -21
- package/src/treemap/diagnostics.ts +0 -62
- package/src/treemap/layout-radial.ts +0 -233
- package/src/treemap/layout.ts +0 -189
- package/src/treemap/parser.ts +0 -463
- package/src/treemap/renderer-radial.ts +0 -438
- package/src/treemap/renderer.ts +0 -572
- package/src/treemap/treemap-shared.ts +0 -309
- package/src/treemap/types.ts +0 -60
- package/src/utils/arrow-markers.ts +0 -51
- package/src/utils/arrows-diagnostics.ts +0 -62
- package/src/utils/arrows.ts +0 -227
- package/src/utils/brand.ts +0 -61
- package/src/utils/card.ts +0 -183
- package/src/utils/collapse-engine/tree-edges.ts +0 -115
- package/src/utils/collapse-engine/tree.ts +0 -117
- package/src/utils/d3-helpers.ts +0 -219
- package/src/utils/d3-types.ts +0 -9
- package/src/utils/description-helpers.ts +0 -38
- package/src/utils/duration.ts +0 -312
- package/src/utils/export-container.ts +0 -41
- package/src/utils/expr-eval.ts +0 -27
- package/src/utils/fit-canvas.ts +0 -64
- package/src/utils/hover-styles.ts +0 -673
- package/src/utils/inline-markdown.ts +0 -96
- package/src/utils/legend-constants.ts +0 -48
- package/src/utils/legend-d3.ts +0 -618
- package/src/utils/legend-integration.ts +0 -107
- package/src/utils/legend-layout.ts +0 -776
- package/src/utils/legend-svg.ts +0 -214
- package/src/utils/legend-types.ts +0 -272
- package/src/utils/name-normalize.ts +0 -163
- package/src/utils/note-box/constants.ts +0 -25
- package/src/utils/note-box/index.ts +0 -11
- package/src/utils/note-box/metrics.ts +0 -90
- package/src/utils/note-box/svg.ts +0 -331
- package/src/utils/notes/bounds.ts +0 -30
- package/src/utils/notes/build.ts +0 -131
- package/src/utils/notes/index.ts +0 -18
- package/src/utils/notes/model.ts +0 -19
- package/src/utils/notes/parse.ts +0 -131
- package/src/utils/notes/place.ts +0 -177
- package/src/utils/notes/resolve.ts +0 -88
- package/src/utils/number-format.ts +0 -36
- package/src/utils/parsing.ts +0 -953
- package/src/utils/reserved-key-registry.ts +0 -239
- package/src/utils/safe-href.ts +0 -38
- package/src/utils/scaling.ts +0 -97
- package/src/utils/svg-embed.ts +0 -251
- package/src/utils/tag-groups.ts +0 -607
- package/src/utils/text-measure.ts +0 -122
- package/src/utils/time-ticks.ts +0 -253
- package/src/utils/title-constants.ts +0 -24
- package/src/utils/visual-conventions.ts +0 -61
- package/src/utils/wrapped-desc.ts +0 -87
- package/src/venn/parser.ts +0 -18
- package/src/venn/renderer.ts +0 -1047
- package/src/version-control/diagnostics.ts +0 -67
- package/src/version-control/parser.ts +0 -544
- package/src/version-control/renderer.ts +0 -724
- package/src/version-control/types.ts +0 -100
- package/src/visualizations/parse.ts +0 -1560
- package/src/visualizations/types.ts +0 -262
- package/src/wireframe/layout.ts +0 -479
- package/src/wireframe/parser.ts +0 -1114
- package/src/wireframe/renderer.ts +0 -1318
- package/src/wireframe/types.ts +0 -110
- package/src/wordcloud/parser.ts +0 -18
- package/src/wordcloud/renderer.ts +0 -357
package/src/utils/legend-svg.ts
DELETED
|
@@ -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, '&')
|
|
61
|
-
.replace(/</g, '<')
|
|
62
|
-
.replace(/>/g, '>')
|
|
63
|
-
.replace(/"/g, '"');
|
|
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';
|