@transitrix/diagrams 1.0.0 → 1.0.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 (267) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +47 -47
  3. package/dist/__tests__/edge-path.test.js +8 -0
  4. package/dist/activity-card/__tests__/example.test.js +20 -1
  5. package/dist/activity-card/__tests__/layout.test.js +102 -11
  6. package/dist/activity-card/__tests__/resolver.test.js +139 -6
  7. package/dist/activity-card/index.d.ts +1 -1
  8. package/dist/activity-card/layout.d.ts +1 -1
  9. package/dist/activity-card/layout.js +220 -103
  10. package/dist/activity-card/resolver.js +107 -26
  11. package/dist/activity-card/types.d.ts +150 -27
  12. package/dist/activity-card/validate.js +3 -0
  13. package/dist/actor/__tests__/validate.test.js +63 -31
  14. package/dist/actor/index.d.ts +1 -1
  15. package/dist/actor/index.js +1 -1
  16. package/dist/actor/types.d.ts +7 -3
  17. package/dist/actor/types.js +17 -3
  18. package/dist/actor/validate.js +55 -26
  19. package/dist/assertion/types.d.ts +3 -1
  20. package/dist/assertion/types.js +1 -1
  21. package/dist/change/__tests__/validate.test.js +40 -34
  22. package/dist/change/index.d.ts +1 -0
  23. package/dist/change/types.d.ts +1 -1
  24. package/dist/change/types.js +2 -2
  25. package/dist/change/validate.d.ts +6 -1
  26. package/dist/change/validate.js +68 -41
  27. package/dist/compliance/__tests__/classify.test.js +34 -0
  28. package/dist/compliance/__tests__/coverage-metric.test.js +146 -46
  29. package/dist/compliance/__tests__/html.test.js +2 -2
  30. package/dist/compliance/__tests__/impact.test.js +311 -6
  31. package/dist/compliance/classify.d.ts +6 -0
  32. package/dist/compliance/classify.js +9 -1
  33. package/dist/compliance/coverage-metric.d.ts +31 -11
  34. package/dist/compliance/coverage-metric.js +149 -39
  35. package/dist/compliance/html.js +77 -74
  36. package/dist/compliance/impact.d.ts +77 -16
  37. package/dist/compliance/impact.js +193 -25
  38. package/dist/compliance/index.d.ts +2 -2
  39. package/dist/compliance/index.js +1 -1
  40. package/dist/compliance/markdown.js +1 -0
  41. package/dist/compliance/types.d.ts +25 -6
  42. package/dist/edge-path.d.ts +8 -4
  43. package/dist/edge-path.js +11 -6
  44. package/dist/factor/__tests__/validate.test.js +74 -45
  45. package/dist/factor/index.d.ts +3 -2
  46. package/dist/factor/index.js +1 -1
  47. package/dist/factor/types.d.ts +4 -7
  48. package/dist/factor/types.js +10 -5
  49. package/dist/factor/validate.d.ts +6 -1
  50. package/dist/factor/validate.js +68 -50
  51. package/dist/fgca/__tests__/resolver.test.js +185 -0
  52. package/dist/fgca/index.d.ts +2 -0
  53. package/dist/fgca/index.js +1 -0
  54. package/dist/fgca/resolver.d.ts +49 -0
  55. package/dist/fgca/resolver.js +124 -0
  56. package/dist/goals/index.d.ts +1 -1
  57. package/dist/index.d.ts +5 -0
  58. package/dist/index.js +5 -0
  59. package/dist/process-blueprint/__tests__/layout.test.js +37 -0
  60. package/dist/process-blueprint/layout.js +5 -1
  61. package/dist/process-blueprint/types.d.ts +22 -1
  62. package/dist/stakeholder/__tests__/validate.test.js +49 -47
  63. package/dist/stakeholder/index.d.ts +1 -0
  64. package/dist/stakeholder/types.d.ts +3 -4
  65. package/dist/stakeholder/types.js +2 -3
  66. package/dist/stakeholder/validate.d.ts +6 -1
  67. package/dist/stakeholder/validate.js +71 -50
  68. package/dist/target-state/__tests__/validate.test.js +43 -27
  69. package/dist/target-state/index.d.ts +2 -0
  70. package/dist/target-state/index.js +1 -0
  71. package/dist/target-state/types.d.ts +6 -1
  72. package/dist/target-state/types.js +8 -7
  73. package/dist/target-state/validate.d.ts +6 -1
  74. package/dist/target-state/validate.js +69 -45
  75. package/dist/theme/themes.js +69 -69
  76. package/dist/webview/__tests__/entry.test.js +11 -11
  77. package/dist/webview/render-activities.d.ts +3 -1
  78. package/dist/webview/render-activities.js +2 -2
  79. package/dist/webview/render-activity-card.js +104 -77
  80. package/dist/webview/render-fgca.d.ts +4 -0
  81. package/dist/webview/render-fgca.js +2 -5
  82. package/dist/webview/render-goals.d.ts +1 -0
  83. package/dist/webview/render-goals.js +15 -15
  84. package/dist/webview/render-process-blueprint.js +10 -10
  85. package/package.json +40 -40
  86. package/src/__tests__/edge-path.test.ts +58 -46
  87. package/src/__tests__/scope.test.ts +27 -27
  88. package/src/__tests__/yaml-normalize.test.ts +158 -158
  89. package/src/activities/__tests__/cpm.test.ts +164 -164
  90. package/src/activities/__tests__/gantt.test.ts +245 -245
  91. package/src/activities/__tests__/layout.test.ts +112 -112
  92. package/src/activities/__tests__/validate.test.ts +409 -409
  93. package/src/activities/cpm.ts +95 -95
  94. package/src/activities/gantt.ts +276 -276
  95. package/src/activities/index.ts +28 -28
  96. package/src/activities/layout.ts +112 -112
  97. package/src/activities/types.ts +148 -148
  98. package/src/activities/validate.ts +357 -357
  99. package/src/activity-card/__tests__/example.test.ts +85 -66
  100. package/src/activity-card/__tests__/layout.test.ts +169 -63
  101. package/src/activity-card/__tests__/resolver.test.ts +307 -161
  102. package/src/activity-card/__tests__/validate.test.ts +131 -131
  103. package/src/activity-card/index.ts +38 -32
  104. package/src/activity-card/layout.ts +324 -194
  105. package/src/activity-card/resolver.ts +415 -337
  106. package/src/activity-card/types.ts +376 -237
  107. package/src/activity-card/validate.ts +162 -158
  108. package/src/actor/__tests__/validate.test.ts +70 -31
  109. package/src/actor/index.ts +1 -1
  110. package/src/actor/types.ts +21 -7
  111. package/src/actor/validate.ts +59 -27
  112. package/src/applications/__tests__/validate.test.ts +256 -256
  113. package/src/applications/index.ts +11 -11
  114. package/src/applications/types.ts +43 -43
  115. package/src/applications/validate.ts +131 -131
  116. package/src/assertion/__tests__/example.test.ts +37 -37
  117. package/src/assertion/__tests__/validate.test.ts +142 -142
  118. package/src/assertion/index.ts +12 -12
  119. package/src/assertion/types.ts +60 -58
  120. package/src/assertion/validate.ts +145 -145
  121. package/src/blocks/__tests__/layout.test.ts +169 -169
  122. package/src/blocks/__tests__/validate.test.ts +260 -260
  123. package/src/blocks/index.ts +17 -17
  124. package/src/blocks/layout.ts +186 -186
  125. package/src/blocks/types.ts +62 -62
  126. package/src/blocks/validate.ts +206 -206
  127. package/src/capability-map/__tests__/validate.test.ts +238 -238
  128. package/src/capability-map/index.ts +8 -8
  129. package/src/capability-map/types.ts +29 -29
  130. package/src/capability-map/validate.ts +127 -127
  131. package/src/change/__tests__/validate.test.ts +43 -34
  132. package/src/change/index.ts +1 -0
  133. package/src/change/types.ts +5 -3
  134. package/src/change/validate.ts +75 -43
  135. package/src/compliance/__tests__/classify.test.ts +64 -27
  136. package/src/compliance/__tests__/confidence.test.ts +98 -98
  137. package/src/compliance/__tests__/coverage-metric.test.ts +300 -188
  138. package/src/compliance/__tests__/demo-scenario.test.ts +273 -273
  139. package/src/compliance/__tests__/example.test.ts +57 -57
  140. package/src/compliance/__tests__/gap-report.test.ts +128 -128
  141. package/src/compliance/__tests__/html.test.ts +141 -141
  142. package/src/compliance/__tests__/impact.test.ts +840 -481
  143. package/src/compliance/__tests__/markdown.test.ts +94 -94
  144. package/src/compliance/__tests__/views.test.ts +64 -64
  145. package/src/compliance/classify.ts +100 -84
  146. package/src/compliance/confidence.ts +69 -69
  147. package/src/compliance/coverage-metric.ts +404 -263
  148. package/src/compliance/gap-report.ts +94 -94
  149. package/src/compliance/html.ts +298 -295
  150. package/src/compliance/impact.ts +861 -677
  151. package/src/compliance/index.ts +57 -56
  152. package/src/compliance/markdown.ts +136 -135
  153. package/src/compliance/reverse-index.ts +33 -33
  154. package/src/compliance/types.ts +136 -120
  155. package/src/compliance/views.ts +46 -46
  156. package/src/compliance-matrix/__tests__/build.test.ts +200 -200
  157. package/src/compliance-matrix/__tests__/example.test.ts +57 -57
  158. package/src/compliance-matrix/index.ts +11 -11
  159. package/src/compliance-matrix/types.ts +102 -102
  160. package/src/edge-path.ts +50 -44
  161. package/src/factor/__tests__/validate.test.ts +80 -45
  162. package/src/factor/index.ts +3 -7
  163. package/src/factor/types.ts +14 -18
  164. package/src/factor/validate.ts +77 -51
  165. package/src/fgca/__tests__/chain-table.test.ts +172 -172
  166. package/src/fgca/__tests__/layout.test.ts +179 -179
  167. package/src/fgca/__tests__/parse-canonical.test.ts +248 -248
  168. package/src/fgca/__tests__/preview-layout.test.ts +124 -124
  169. package/src/fgca/__tests__/resolver.test.ts +209 -0
  170. package/src/fgca/__tests__/validate.test.ts +142 -142
  171. package/src/fgca/chain-table.ts +225 -225
  172. package/src/fgca/index.ts +47 -45
  173. package/src/fgca/layout.ts +204 -204
  174. package/src/fgca/nodeTypes.ts +11 -11
  175. package/src/fgca/nodes/FGCAActivityNode.tsx +65 -65
  176. package/src/fgca/nodes/FGCAChangeNode.tsx +64 -64
  177. package/src/fgca/nodes/FGCAFactorNode.tsx +64 -64
  178. package/src/fgca/nodes/FGCAGoalNode.tsx +72 -72
  179. package/src/fgca/parse-canonical.ts +400 -400
  180. package/src/fgca/preview-layout.ts +217 -217
  181. package/src/fgca/resolver.ts +157 -0
  182. package/src/fgca/types.ts +50 -50
  183. package/src/fgca/validate.ts +126 -126
  184. package/src/geometry.ts +9 -9
  185. package/src/goals/__tests__/layout.test.ts +175 -175
  186. package/src/goals/__tests__/mutations.test.ts +111 -111
  187. package/src/goals/__tests__/parse-canonical.test.ts +145 -145
  188. package/src/goals/__tests__/validate.test.ts +202 -202
  189. package/src/goals/index.ts +20 -21
  190. package/src/goals/layout.ts +172 -172
  191. package/src/goals/mutations.ts +123 -123
  192. package/src/goals/parse-canonical.ts +286 -286
  193. package/src/goals/types.ts +85 -85
  194. package/src/goals/validate.ts +136 -136
  195. package/src/index.ts +28 -23
  196. package/src/process-blueprint/__tests__/compliance-lane.test.ts +320 -320
  197. package/src/process-blueprint/__tests__/layout.test.ts +240 -195
  198. package/src/process-blueprint/__tests__/validate.test.ts +310 -310
  199. package/src/process-blueprint/index.ts +31 -31
  200. package/src/process-blueprint/layout.ts +535 -531
  201. package/src/process-blueprint/types.ts +263 -242
  202. package/src/process-blueprint/validate.ts +181 -181
  203. package/src/process-map/__tests__/validate.test.ts +223 -223
  204. package/src/process-map/index.ts +10 -10
  205. package/src/process-map/types.ts +36 -36
  206. package/src/process-map/validate.ts +135 -135
  207. package/src/products/__tests__/validate.test.ts +239 -239
  208. package/src/products/index.ts +9 -9
  209. package/src/products/types.ts +31 -31
  210. package/src/products/validate.ts +112 -112
  211. package/src/repo-validate/__tests__/validate-repo.test.ts +149 -149
  212. package/src/repo-validate/index.ts +2 -2
  213. package/src/repo-validate/types.ts +50 -50
  214. package/src/repo-validate/validate-repo.ts +196 -196
  215. package/src/requirement/__tests__/example.test.ts +24 -24
  216. package/src/requirement/__tests__/validate.test.ts +96 -96
  217. package/src/requirement/index.ts +4 -4
  218. package/src/requirement/types.ts +35 -35
  219. package/src/requirement/validate.ts +92 -92
  220. package/src/scenarios/__tests__/validate.test.ts +209 -209
  221. package/src/scenarios/index.ts +15 -15
  222. package/src/scenarios/types.ts +37 -37
  223. package/src/scenarios/validate.ts +122 -122
  224. package/src/schema-version.ts +16 -16
  225. package/src/scope.ts +46 -46
  226. package/src/stakeholder/__tests__/validate.test.ts +51 -47
  227. package/src/stakeholder/index.ts +1 -0
  228. package/src/stakeholder/types.ts +7 -7
  229. package/src/stakeholder/validate.ts +79 -52
  230. package/src/target-state/__tests__/validate.test.ts +48 -27
  231. package/src/target-state/index.ts +2 -0
  232. package/src/target-state/types.ts +11 -7
  233. package/src/target-state/validate.ts +76 -46
  234. package/src/theme/index.ts +4 -4
  235. package/src/theme/themes.ts +237 -237
  236. package/src/theme/tokens.ts +133 -133
  237. package/src/typed-id.ts +56 -56
  238. package/src/validation-types.ts +36 -36
  239. package/src/webview/__tests__/entry-notations.test.ts +77 -77
  240. package/src/webview/__tests__/entry.test.ts +64 -64
  241. package/src/webview/__tests__/render-goals.test.ts +72 -72
  242. package/src/webview/entry.ts +292 -292
  243. package/src/webview/render-activities.ts +5 -3
  244. package/src/webview/render-activity-card.ts +266 -234
  245. package/src/webview/render-fgca.ts +6 -5
  246. package/src/webview/render-goals.ts +111 -110
  247. package/src/webview/render-process-blueprint.ts +207 -207
  248. package/src/webview/styles.css +322 -323
  249. package/src/yaml-normalize.ts +56 -56
  250. package/dist/element-envelope.d.ts +0 -15
  251. package/dist/element-envelope.js +0 -55
  252. package/dist/issues/__tests__/layout.test.js +0 -62
  253. package/dist/issues/__tests__/validate.test.d.ts +0 -1
  254. package/dist/issues/__tests__/validate.test.js +0 -82
  255. package/dist/issues/index.d.ts +0 -4
  256. package/dist/issues/index.js +0 -2
  257. package/dist/issues/layout.d.ts +0 -10
  258. package/dist/issues/layout.js +0 -82
  259. package/dist/issues/types.d.ts +0 -61
  260. package/dist/issues/types.js +0 -6
  261. package/dist/issues/validate.d.ts +0 -3
  262. package/dist/issues/validate.js +0 -143
  263. package/dist/webview/transitrix-render.css +0 -323
  264. package/dist/webview/transitrix-render.js +0 -6452
  265. package/dist/webview/transitrix-render.js.map +0 -7
  266. package/src/element-envelope.ts +0 -76
  267. /package/dist/{issues/__tests__/layout.test.d.ts → fgca/__tests__/resolver.test.d.ts} +0 -0
@@ -1,292 +1,292 @@
1
- /**
2
- * Browser-bundle entry point for the IntelliJ JCEF preview surface (and any
3
- * other host that wants the same in-browser API).
4
- *
5
- * Why: ADR 0001 picks JCEF + a bundled `@transitrix/diagrams` over a JVM-side
6
- * re-implementation. This module is the API contract between the JVM host
7
- * (which posts raw document text + the notation kind) and the rendering JS
8
- * (which parses, validates, and — Step 3+ — renders SVG). Centralising the
9
- * surface in one file means the JVM side only has to know about
10
- * `window.transitrix.render(kind, source)` regardless of which notation the
11
- * user opened.
12
- *
13
- * Step 2 scope: wire YAML parsing, dispatch to the right validator, surface
14
- * validation/parse errors in a structured JSON shape.
15
- * Step 3 scope: wire the `goals` SVG renderer so the bundle returns non-empty
16
- * `svg` for a valid goals document.
17
- * Step 4 scope (this PR): wire the remaining eleven notations — each one
18
- * validates the parsed YAML and, when valid, renders host-neutral markup
19
- * (SVG for the diagram notations, an HTML fragment for the catalogue
20
- * notations). The JVM host drops whatever `svg` carries into the DOM, so the
21
- * field name is historical — it transports any self-contained markup.
22
- */
23
- import yaml from 'js-yaml';
24
-
25
- import { validateActivities } from '../activities/index.js';
26
- import type { ActivityDoc } from '../activities/index.js';
27
- import { validateActivityCard } from '../activity-card/index.js';
28
- import type { ActivityCardDoc } from '../activity-card/index.js';
29
- import { validateApplicationsCatalogue } from '../applications/index.js';
30
- import type { ApplicationsCatalogueFile } from '../applications/index.js';
31
- import { validateNestedBlocks } from '../blocks/index.js';
32
- import type { BlocksFile } from '../blocks/index.js';
33
- import { validateCapabilityMap } from '../capability-map/index.js';
34
- import type { CapabilityMapFile } from '../capability-map/index.js';
35
- import { parseCanonicalFGCA, parseCanonicalFGA } from '../fgca/parse-canonical.js';
36
- import { parseCanonicalGoals } from '../goals/parse-canonical.js';
37
- import { validateProcessBlueprint } from '../process-blueprint/index.js';
38
- import type { ProcessBlueprintFile } from '../process-blueprint/index.js';
39
- import { validateProcessMap } from '../process-map/index.js';
40
- import type { ProcessMapFile } from '../process-map/index.js';
41
- import { validateProductsCatalogue } from '../products/index.js';
42
- import type { ProductsCatalogueFile } from '../products/index.js';
43
- import { validateScenario } from '../scenarios/index.js';
44
- import type { ScenarioFile } from '../scenarios/index.js';
45
- import { coerceDatesToIsoStrings } from '../yaml-normalize.js';
46
-
47
- import { renderActivitiesSvg } from './render-activities.js';
48
- import { renderActivityCardSvg } from './render-activity-card.js';
49
- import { renderApplicationsHtml } from './render-applications.js';
50
- import { renderBlocksSvg } from './render-blocks.js';
51
- import { renderCapabilityMapHtml } from './render-capability-map.js';
52
- import { renderFgcaSvg } from './render-fgca.js';
53
- import { renderGoalsSvg } from './render-goals.js';
54
- import { renderProcessBlueprintSvg } from './render-process-blueprint.js';
55
- import { renderProcessMapHtml } from './render-process-map.js';
56
- import { renderProductsHtml } from './render-products.js';
57
- import { renderScenarioHtml } from './render-scenarios.js';
58
-
59
- export interface RenderError {
60
- code: string;
61
- message: string;
62
- path?: string;
63
- }
64
-
65
- export interface RenderWarning {
66
- code: string;
67
- message: string;
68
- path?: string;
69
- }
70
-
71
- export type RenderStatus = 'ok' | 'error';
72
-
73
- export interface RenderResult {
74
- status: RenderStatus;
75
- notation: string;
76
- /**
77
- * Self-contained markup for the rendered notation — an `<svg>` for the
78
- * diagram notations, an HTML `<section>` for the catalogue notations. Empty
79
- * on validation failure (the host shows the error panel instead). The field
80
- * name is historical; the JVM host injects whatever it carries into the DOM.
81
- */
82
- svg: string;
83
- errors: RenderError[];
84
- warnings: RenderWarning[];
85
- }
86
-
87
- /**
88
- * Notation kinds the host can request. Mirrors the `*.<kind>.<…>` suffix
89
- * convention used by the VS Code extension's `activationEvents`. All twelve
90
- * are wired to their validator + renderer as of Step 4.
91
- */
92
- export type NotationKind =
93
- | 'goals'
94
- | 'fgca'
95
- | 'fga'
96
- | 'activities'
97
- | 'activity-card'
98
- | 'applications'
99
- | 'products'
100
- | 'process-map'
101
- | 'process-blueprint'
102
- | 'scenarios'
103
- | 'capability-map'
104
- | 'blocks';
105
-
106
- const SUPPORTED_KINDS: readonly NotationKind[] = [
107
- 'goals',
108
- 'fgca',
109
- 'fga',
110
- 'activities',
111
- 'activity-card',
112
- 'applications',
113
- 'products',
114
- 'process-map',
115
- 'process-blueprint',
116
- 'scenarios',
117
- 'capability-map',
118
- 'blocks',
119
- ];
120
-
121
- const VERSION = '0.1.0';
122
-
123
- function emptyResult(notation: string, status: RenderStatus): RenderResult {
124
- return { status, notation, svg: '', errors: [], warnings: [] };
125
- }
126
-
127
- function errorResult(notation: string, code: string, message: string, path?: string): RenderResult {
128
- const r = emptyResult(notation, 'error');
129
- r.errors.push(path !== undefined ? { code, message, path } : { code, message });
130
- return r;
131
- }
132
-
133
- function parseYaml(source: string): { doc?: unknown; error?: string } {
134
- try {
135
- // Coerce native `Date`s (bare `2026-06-01` per YAML 1.1) back to ISO
136
- // strings before validation — every notation validator expects string
137
- // dates, and the VS Code previews apply the same normalisation. Without
138
- // it the canonical-minus-quotes form would falsely fail shape checks.
139
- return { doc: coerceDatesToIsoStrings(yaml.load(source)) };
140
- } catch (e: unknown) {
141
- return { error: e instanceof Error ? e.message : String(e) };
142
- }
143
- }
144
-
145
- interface ValidationLike {
146
- valid: boolean;
147
- errors: RenderError[];
148
- warnings: RenderWarning[];
149
- }
150
-
151
- /**
152
- * Shared shape for the validate-then-render notations: copy the validator's
153
- * errors/warnings into the result, and render markup only once the document is
154
- * valid. `renderMarkup` is a thunk so the (type-asserted) render call never
155
- * runs against a document the validator rejected.
156
- */
157
- function renderFromValidation(
158
- kind: NotationKind,
159
- result: ValidationLike,
160
- renderMarkup: () => string,
161
- ): RenderResult {
162
- const r = emptyResult(kind, result.valid ? 'ok' : 'error');
163
- r.errors.push(...result.errors);
164
- r.warnings.push(...result.warnings);
165
- if (result.valid) {
166
- r.svg = renderMarkup();
167
- }
168
- return r;
169
- }
170
-
171
- function dispatchValidate(kind: NotationKind, doc: unknown): RenderResult {
172
- switch (kind) {
173
- case 'goals': {
174
- const v = parseCanonicalGoals(doc);
175
- const r = emptyResult('goals', v.valid ? 'ok' : 'error');
176
- r.errors.push(...v.errors);
177
- r.warnings.push(...v.warnings);
178
- if (v.valid && v.parsed) {
179
- const meta = (doc ?? {}) as { name?: unknown };
180
- const treeName = typeof meta.name === 'string' ? meta.name : '';
181
- r.svg = renderGoalsSvg(v.parsed, { treeName });
182
- }
183
- return r;
184
- }
185
- // FGCA and FGA share the canonical parse + renderer; only the layer
186
- // visibility differs (FGA collapses the Change column). Both carry the
187
- // parsed `FGCADoc` on the result's `parsed` field when valid.
188
- case 'fgca': {
189
- const v = parseCanonicalFGCA(doc);
190
- const r = emptyResult('fgca', v.valid ? 'ok' : 'error');
191
- r.errors.push(...v.errors);
192
- r.warnings.push(...v.warnings);
193
- if (v.valid && v.parsed) {
194
- r.svg = renderFgcaSvg(v.parsed, { variant: 'fgca' });
195
- }
196
- return r;
197
- }
198
- case 'fga': {
199
- const v = parseCanonicalFGA(doc);
200
- const r = emptyResult('fga', v.valid ? 'ok' : 'error');
201
- r.errors.push(...v.errors);
202
- r.warnings.push(...v.warnings);
203
- if (v.valid && v.parsed) {
204
- r.svg = renderFgcaSvg(v.parsed, { variant: 'fga' });
205
- }
206
- return r;
207
- }
208
- case 'activities':
209
- return renderFromValidation('activities', validateActivities(doc), () =>
210
- renderActivitiesSvg(doc as ActivityDoc),
211
- );
212
- case 'activity-card':
213
- return renderFromValidation('activity-card', validateActivityCard(doc), () =>
214
- renderActivityCardSvg(doc as ActivityCardDoc),
215
- );
216
- case 'process-blueprint':
217
- return renderFromValidation('process-blueprint', validateProcessBlueprint(doc), () =>
218
- renderProcessBlueprintSvg(doc as ProcessBlueprintFile),
219
- );
220
- case 'blocks':
221
- return renderFromValidation('blocks', validateNestedBlocks(doc), () =>
222
- renderBlocksSvg(doc as BlocksFile),
223
- );
224
- // Catalogue notations render an HTML fragment from the header nested under
225
- // their top-level wrapper key (`<thing>_catalogue` / `scenario` / …).
226
- case 'applications':
227
- return renderFromValidation('applications', validateApplicationsCatalogue(doc), () =>
228
- renderApplicationsHtml((doc as ApplicationsCatalogueFile).applications_catalogue),
229
- );
230
- case 'products':
231
- return renderFromValidation('products', validateProductsCatalogue(doc), () =>
232
- renderProductsHtml((doc as ProductsCatalogueFile).products_catalogue),
233
- );
234
- case 'process-map':
235
- return renderFromValidation('process-map', validateProcessMap(doc), () =>
236
- renderProcessMapHtml((doc as ProcessMapFile).process_map),
237
- );
238
- case 'scenarios':
239
- return renderFromValidation('scenarios', validateScenario(doc), () =>
240
- renderScenarioHtml((doc as ScenarioFile).scenario),
241
- );
242
- case 'capability-map':
243
- return renderFromValidation('capability-map', validateCapabilityMap(doc), () =>
244
- renderCapabilityMapHtml((doc as CapabilityMapFile).capability_map),
245
- );
246
- default:
247
- return errorResult(
248
- kind,
249
- 'NOTATION-NOT-WIRED',
250
- `Notation '${kind}' is not wired into the IntelliJ bundle yet.`,
251
- );
252
- }
253
- }
254
-
255
- export function render(notationKind: string, source: string): RenderResult {
256
- if (typeof notationKind !== 'string' || notationKind.length === 0) {
257
- return errorResult('', 'KIND-MISSING', 'notationKind is required');
258
- }
259
- if (typeof source !== 'string') {
260
- return errorResult(notationKind, 'SOURCE-INVALID', 'source must be a string');
261
- }
262
- if (!SUPPORTED_KINDS.includes(notationKind as NotationKind)) {
263
- return errorResult(
264
- notationKind,
265
- 'KIND-UNKNOWN',
266
- `Unknown notation kind: '${notationKind}'. Expected one of: ${SUPPORTED_KINDS.join(', ')}.`,
267
- );
268
- }
269
- const parsed = parseYaml(source);
270
- if (parsed.error !== undefined) {
271
- return errorResult(notationKind, 'YAML-PARSE', parsed.error);
272
- }
273
- return dispatchValidate(notationKind as NotationKind, parsed.doc);
274
- }
275
-
276
- export const api = {
277
- version: VERSION,
278
- supportedKinds: SUPPORTED_KINDS,
279
- render,
280
- };
281
-
282
- export type TransitrixWebviewApi = typeof api;
283
-
284
- // Install the API on `window.transitrix` when running in a browser-ish host
285
- // (JCEF qualifies). In a Node/Vitest context `window` is undefined and the
286
- // install is a no-op — the named exports remain available for unit tests.
287
- declare const window: { transitrix?: TransitrixWebviewApi } | undefined;
288
- if (typeof window !== 'undefined') {
289
- (window as { transitrix?: TransitrixWebviewApi }).transitrix = api;
290
- }
291
-
292
- export default api;
1
+ /**
2
+ * Browser-bundle entry point for the IntelliJ JCEF preview surface (and any
3
+ * other host that wants the same in-browser API).
4
+ *
5
+ * Why: ADR 0001 picks JCEF + a bundled `@transitrix/diagrams` over a JVM-side
6
+ * re-implementation. This module is the API contract between the JVM host
7
+ * (which posts raw document text + the notation kind) and the rendering JS
8
+ * (which parses, validates, and — Step 3+ — renders SVG). Centralising the
9
+ * surface in one file means the JVM side only has to know about
10
+ * `window.transitrix.render(kind, source)` regardless of which notation the
11
+ * user opened.
12
+ *
13
+ * Step 2 scope: wire YAML parsing, dispatch to the right validator, surface
14
+ * validation/parse errors in a structured JSON shape.
15
+ * Step 3 scope: wire the `goals` SVG renderer so the bundle returns non-empty
16
+ * `svg` for a valid goals document.
17
+ * Step 4 scope (this PR): wire the remaining eleven notations — each one
18
+ * validates the parsed YAML and, when valid, renders host-neutral markup
19
+ * (SVG for the diagram notations, an HTML fragment for the catalogue
20
+ * notations). The JVM host drops whatever `svg` carries into the DOM, so the
21
+ * field name is historical — it transports any self-contained markup.
22
+ */
23
+ import yaml from 'js-yaml';
24
+
25
+ import { validateActivities } from '../activities/index.js';
26
+ import type { ActivityDoc } from '../activities/index.js';
27
+ import { validateActivityCard } from '../activity-card/index.js';
28
+ import type { ActivityCardDoc } from '../activity-card/index.js';
29
+ import { validateApplicationsCatalogue } from '../applications/index.js';
30
+ import type { ApplicationsCatalogueFile } from '../applications/index.js';
31
+ import { validateNestedBlocks } from '../blocks/index.js';
32
+ import type { BlocksFile } from '../blocks/index.js';
33
+ import { validateCapabilityMap } from '../capability-map/index.js';
34
+ import type { CapabilityMapFile } from '../capability-map/index.js';
35
+ import { parseCanonicalFGCA, parseCanonicalFGA } from '../fgca/parse-canonical.js';
36
+ import { parseCanonicalGoals } from '../goals/parse-canonical.js';
37
+ import { validateProcessBlueprint } from '../process-blueprint/index.js';
38
+ import type { ProcessBlueprintFile } from '../process-blueprint/index.js';
39
+ import { validateProcessMap } from '../process-map/index.js';
40
+ import type { ProcessMapFile } from '../process-map/index.js';
41
+ import { validateProductsCatalogue } from '../products/index.js';
42
+ import type { ProductsCatalogueFile } from '../products/index.js';
43
+ import { validateScenario } from '../scenarios/index.js';
44
+ import type { ScenarioFile } from '../scenarios/index.js';
45
+ import { coerceDatesToIsoStrings } from '../yaml-normalize.js';
46
+
47
+ import { renderActivitiesSvg } from './render-activities.js';
48
+ import { renderActivityCardSvg } from './render-activity-card.js';
49
+ import { renderApplicationsHtml } from './render-applications.js';
50
+ import { renderBlocksSvg } from './render-blocks.js';
51
+ import { renderCapabilityMapHtml } from './render-capability-map.js';
52
+ import { renderFgcaSvg } from './render-fgca.js';
53
+ import { renderGoalsSvg } from './render-goals.js';
54
+ import { renderProcessBlueprintSvg } from './render-process-blueprint.js';
55
+ import { renderProcessMapHtml } from './render-process-map.js';
56
+ import { renderProductsHtml } from './render-products.js';
57
+ import { renderScenarioHtml } from './render-scenarios.js';
58
+
59
+ export interface RenderError {
60
+ code: string;
61
+ message: string;
62
+ path?: string;
63
+ }
64
+
65
+ export interface RenderWarning {
66
+ code: string;
67
+ message: string;
68
+ path?: string;
69
+ }
70
+
71
+ export type RenderStatus = 'ok' | 'error';
72
+
73
+ export interface RenderResult {
74
+ status: RenderStatus;
75
+ notation: string;
76
+ /**
77
+ * Self-contained markup for the rendered notation — an `<svg>` for the
78
+ * diagram notations, an HTML `<section>` for the catalogue notations. Empty
79
+ * on validation failure (the host shows the error panel instead). The field
80
+ * name is historical; the JVM host injects whatever it carries into the DOM.
81
+ */
82
+ svg: string;
83
+ errors: RenderError[];
84
+ warnings: RenderWarning[];
85
+ }
86
+
87
+ /**
88
+ * Notation kinds the host can request. Mirrors the `*.<kind>.<…>` suffix
89
+ * convention used by the VS Code extension's `activationEvents`. All twelve
90
+ * are wired to their validator + renderer as of Step 4.
91
+ */
92
+ export type NotationKind =
93
+ | 'goals'
94
+ | 'fgca'
95
+ | 'fga'
96
+ | 'activities'
97
+ | 'activity-card'
98
+ | 'applications'
99
+ | 'products'
100
+ | 'process-map'
101
+ | 'process-blueprint'
102
+ | 'scenarios'
103
+ | 'capability-map'
104
+ | 'blocks';
105
+
106
+ const SUPPORTED_KINDS: readonly NotationKind[] = [
107
+ 'goals',
108
+ 'fgca',
109
+ 'fga',
110
+ 'activities',
111
+ 'activity-card',
112
+ 'applications',
113
+ 'products',
114
+ 'process-map',
115
+ 'process-blueprint',
116
+ 'scenarios',
117
+ 'capability-map',
118
+ 'blocks',
119
+ ];
120
+
121
+ const VERSION = '0.1.0';
122
+
123
+ function emptyResult(notation: string, status: RenderStatus): RenderResult {
124
+ return { status, notation, svg: '', errors: [], warnings: [] };
125
+ }
126
+
127
+ function errorResult(notation: string, code: string, message: string, path?: string): RenderResult {
128
+ const r = emptyResult(notation, 'error');
129
+ r.errors.push(path !== undefined ? { code, message, path } : { code, message });
130
+ return r;
131
+ }
132
+
133
+ function parseYaml(source: string): { doc?: unknown; error?: string } {
134
+ try {
135
+ // Coerce native `Date`s (bare `2026-06-01` per YAML 1.1) back to ISO
136
+ // strings before validation — every notation validator expects string
137
+ // dates, and the VS Code previews apply the same normalisation. Without
138
+ // it the canonical-minus-quotes form would falsely fail shape checks.
139
+ return { doc: coerceDatesToIsoStrings(yaml.load(source)) };
140
+ } catch (e: unknown) {
141
+ return { error: e instanceof Error ? e.message : String(e) };
142
+ }
143
+ }
144
+
145
+ interface ValidationLike {
146
+ valid: boolean;
147
+ errors: RenderError[];
148
+ warnings: RenderWarning[];
149
+ }
150
+
151
+ /**
152
+ * Shared shape for the validate-then-render notations: copy the validator's
153
+ * errors/warnings into the result, and render markup only once the document is
154
+ * valid. `renderMarkup` is a thunk so the (type-asserted) render call never
155
+ * runs against a document the validator rejected.
156
+ */
157
+ function renderFromValidation(
158
+ kind: NotationKind,
159
+ result: ValidationLike,
160
+ renderMarkup: () => string,
161
+ ): RenderResult {
162
+ const r = emptyResult(kind, result.valid ? 'ok' : 'error');
163
+ r.errors.push(...result.errors);
164
+ r.warnings.push(...result.warnings);
165
+ if (result.valid) {
166
+ r.svg = renderMarkup();
167
+ }
168
+ return r;
169
+ }
170
+
171
+ function dispatchValidate(kind: NotationKind, doc: unknown): RenderResult {
172
+ switch (kind) {
173
+ case 'goals': {
174
+ const v = parseCanonicalGoals(doc);
175
+ const r = emptyResult('goals', v.valid ? 'ok' : 'error');
176
+ r.errors.push(...v.errors);
177
+ r.warnings.push(...v.warnings);
178
+ if (v.valid && v.parsed) {
179
+ const meta = (doc ?? {}) as { name?: unknown };
180
+ const treeName = typeof meta.name === 'string' ? meta.name : '';
181
+ r.svg = renderGoalsSvg(v.parsed, { treeName });
182
+ }
183
+ return r;
184
+ }
185
+ // FGCA and FGA share the canonical parse + renderer; only the layer
186
+ // visibility differs (FGA collapses the Change column). Both carry the
187
+ // parsed `FGCADoc` on the result's `parsed` field when valid.
188
+ case 'fgca': {
189
+ const v = parseCanonicalFGCA(doc);
190
+ const r = emptyResult('fgca', v.valid ? 'ok' : 'error');
191
+ r.errors.push(...v.errors);
192
+ r.warnings.push(...v.warnings);
193
+ if (v.valid && v.parsed) {
194
+ r.svg = renderFgcaSvg(v.parsed, { variant: 'fgca' });
195
+ }
196
+ return r;
197
+ }
198
+ case 'fga': {
199
+ const v = parseCanonicalFGA(doc);
200
+ const r = emptyResult('fga', v.valid ? 'ok' : 'error');
201
+ r.errors.push(...v.errors);
202
+ r.warnings.push(...v.warnings);
203
+ if (v.valid && v.parsed) {
204
+ r.svg = renderFgcaSvg(v.parsed, { variant: 'fga' });
205
+ }
206
+ return r;
207
+ }
208
+ case 'activities':
209
+ return renderFromValidation('activities', validateActivities(doc), () =>
210
+ renderActivitiesSvg(doc as ActivityDoc),
211
+ );
212
+ case 'activity-card':
213
+ return renderFromValidation('activity-card', validateActivityCard(doc), () =>
214
+ renderActivityCardSvg(doc as ActivityCardDoc),
215
+ );
216
+ case 'process-blueprint':
217
+ return renderFromValidation('process-blueprint', validateProcessBlueprint(doc), () =>
218
+ renderProcessBlueprintSvg(doc as ProcessBlueprintFile),
219
+ );
220
+ case 'blocks':
221
+ return renderFromValidation('blocks', validateNestedBlocks(doc), () =>
222
+ renderBlocksSvg(doc as BlocksFile),
223
+ );
224
+ // Catalogue notations render an HTML fragment from the header nested under
225
+ // their top-level wrapper key (`<thing>_catalogue` / `scenario` / …).
226
+ case 'applications':
227
+ return renderFromValidation('applications', validateApplicationsCatalogue(doc), () =>
228
+ renderApplicationsHtml((doc as ApplicationsCatalogueFile).applications_catalogue),
229
+ );
230
+ case 'products':
231
+ return renderFromValidation('products', validateProductsCatalogue(doc), () =>
232
+ renderProductsHtml((doc as ProductsCatalogueFile).products_catalogue),
233
+ );
234
+ case 'process-map':
235
+ return renderFromValidation('process-map', validateProcessMap(doc), () =>
236
+ renderProcessMapHtml((doc as ProcessMapFile).process_map),
237
+ );
238
+ case 'scenarios':
239
+ return renderFromValidation('scenarios', validateScenario(doc), () =>
240
+ renderScenarioHtml((doc as ScenarioFile).scenario),
241
+ );
242
+ case 'capability-map':
243
+ return renderFromValidation('capability-map', validateCapabilityMap(doc), () =>
244
+ renderCapabilityMapHtml((doc as CapabilityMapFile).capability_map),
245
+ );
246
+ default:
247
+ return errorResult(
248
+ kind,
249
+ 'NOTATION-NOT-WIRED',
250
+ `Notation '${kind}' is not wired into the IntelliJ bundle yet.`,
251
+ );
252
+ }
253
+ }
254
+
255
+ export function render(notationKind: string, source: string): RenderResult {
256
+ if (typeof notationKind !== 'string' || notationKind.length === 0) {
257
+ return errorResult('', 'KIND-MISSING', 'notationKind is required');
258
+ }
259
+ if (typeof source !== 'string') {
260
+ return errorResult(notationKind, 'SOURCE-INVALID', 'source must be a string');
261
+ }
262
+ if (!SUPPORTED_KINDS.includes(notationKind as NotationKind)) {
263
+ return errorResult(
264
+ notationKind,
265
+ 'KIND-UNKNOWN',
266
+ `Unknown notation kind: '${notationKind}'. Expected one of: ${SUPPORTED_KINDS.join(', ')}.`,
267
+ );
268
+ }
269
+ const parsed = parseYaml(source);
270
+ if (parsed.error !== undefined) {
271
+ return errorResult(notationKind, 'YAML-PARSE', parsed.error);
272
+ }
273
+ return dispatchValidate(notationKind as NotationKind, parsed.doc);
274
+ }
275
+
276
+ export const api = {
277
+ version: VERSION,
278
+ supportedKinds: SUPPORTED_KINDS,
279
+ render,
280
+ };
281
+
282
+ export type TransitrixWebviewApi = typeof api;
283
+
284
+ // Install the API on `window.transitrix` when running in a browser-ish host
285
+ // (JCEF qualifies). In a Node/Vitest context `window` is undefined and the
286
+ // install is a no-op — the named exports remain available for unit tests.
287
+ declare const window: { transitrix?: TransitrixWebviewApi } | undefined;
288
+ if (typeof window !== 'undefined') {
289
+ (window as { transitrix?: TransitrixWebviewApi }).transitrix = api;
290
+ }
291
+
292
+ export default api;
@@ -48,8 +48,10 @@ export interface RenderActivitiesOptions {
48
48
  title?: string;
49
49
  /** Network column / row gaps. Defaults match `layoutActivities`. */
50
50
  gaps?: ActivitiesLayoutOptions;
51
- /** Edge curvature; 1 = default, 0 = straight, higher = stronger arc. */
51
+ /** Exit edge curvature; 1 = default, 0 = straight, higher = stronger arc. */
52
52
  curvature?: number;
53
+ /** Entry curvature at the target node; defaults to `curvature` when omitted. */
54
+ entryCurvature?: number;
53
55
  }
54
56
 
55
57
  /**
@@ -67,7 +69,7 @@ export interface RenderActivitiesOptions {
67
69
  * than short-circuiting.
68
70
  */
69
71
  export function renderActivitiesSvg(doc: ActivityDoc, options: RenderActivitiesOptions = {}): string {
70
- const { title = '', gaps = {}, curvature = DEFAULT_EDGE_CURVATURE } = options;
72
+ const { title = '', gaps = {}, curvature = DEFAULT_EDGE_CURVATURE, entryCurvature } = options;
71
73
 
72
74
  const layout: ActivitiesLayout = layoutActivities(doc, gaps);
73
75
 
@@ -105,7 +107,7 @@ export function renderActivitiesSvg(doc: ActivityDoc, options: RenderActivitiesO
105
107
  const ty = t.y + oy + t.height / 2;
106
108
  const cls = e.isCritical ? 'diagram-edge critical-edge' : 'diagram-edge';
107
109
  const marker = `url(#${e.isCritical ? 'arrow-crit' : 'arrow'})`;
108
- return `<path d="${horizontalCubicEdgePath(sx, sy, tx, ty, curvature)}" class="${cls}" marker-end="${marker}"/>`;
110
+ return `<path d="${horizontalCubicEdgePath(sx, sy, tx, ty, curvature, entryCurvature)}" class="${cls}" marker-end="${marker}"/>`;
109
111
  })
110
112
  .join('\n');
111
113