@transitrix/diagrams 1.0.0 → 1.1.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 (315) 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/activities/cpm.js +11 -2
  5. package/dist/activities/gantt.js +6 -3
  6. package/dist/activities/types.d.ts +1 -0
  7. package/dist/activities/validate.js +3 -3
  8. package/dist/activity-card/__tests__/example.test.js +20 -1
  9. package/dist/activity-card/__tests__/layout.test.js +102 -11
  10. package/dist/activity-card/__tests__/resolver.test.js +161 -7
  11. package/dist/activity-card/index.d.ts +1 -1
  12. package/dist/activity-card/layout.d.ts +1 -1
  13. package/dist/activity-card/layout.js +220 -103
  14. package/dist/activity-card/resolver.js +115 -28
  15. package/dist/activity-card/types.d.ts +150 -27
  16. package/dist/activity-card/validate.js +3 -0
  17. package/dist/actor/__tests__/validate.test.js +63 -31
  18. package/dist/actor/index.d.ts +1 -1
  19. package/dist/actor/index.js +1 -1
  20. package/dist/actor/types.d.ts +7 -3
  21. package/dist/actor/types.js +17 -3
  22. package/dist/actor/validate.js +55 -26
  23. package/dist/assertion/types.d.ts +3 -1
  24. package/dist/assertion/types.js +1 -1
  25. package/dist/change/__tests__/validate.test.js +40 -34
  26. package/dist/change/index.d.ts +1 -0
  27. package/dist/change/types.d.ts +1 -1
  28. package/dist/change/types.js +2 -2
  29. package/dist/change/validate.d.ts +6 -1
  30. package/dist/change/validate.js +68 -41
  31. package/dist/compliance/__tests__/classify.test.js +34 -0
  32. package/dist/compliance/__tests__/coverage-metric.test.js +146 -46
  33. package/dist/compliance/__tests__/html.test.js +2 -2
  34. package/dist/compliance/__tests__/impact.test.js +509 -6
  35. package/dist/compliance/classify.d.ts +6 -0
  36. package/dist/compliance/classify.js +9 -1
  37. package/dist/compliance/coverage-metric.d.ts +31 -11
  38. package/dist/compliance/coverage-metric.js +149 -39
  39. package/dist/compliance/html.js +78 -81
  40. package/dist/compliance/impact.d.ts +100 -16
  41. package/dist/compliance/impact.js +272 -28
  42. package/dist/compliance/index.d.ts +2 -2
  43. package/dist/compliance/index.js +1 -1
  44. package/dist/compliance/markdown.js +1 -0
  45. package/dist/compliance/types.d.ts +25 -6
  46. package/dist/edge-path.d.ts +8 -4
  47. package/dist/edge-path.js +11 -6
  48. package/dist/factor/__tests__/validate.test.js +75 -46
  49. package/dist/factor/index.d.ts +3 -2
  50. package/dist/factor/index.js +1 -1
  51. package/dist/factor/types.d.ts +5 -8
  52. package/dist/factor/types.js +10 -5
  53. package/dist/factor/validate.d.ts +6 -1
  54. package/dist/factor/validate.js +68 -50
  55. package/dist/fgca/__tests__/chain-table.test.js +2 -2
  56. package/dist/fgca/__tests__/layout.test.js +11 -11
  57. package/dist/fgca/__tests__/preview-layout.test.js +7 -7
  58. package/dist/fgca/__tests__/resolver.test.js +185 -0
  59. package/dist/fgca/chain-table.d.ts +1 -1
  60. package/dist/fgca/chain-table.js +4 -4
  61. package/dist/fgca/index.d.ts +4 -2
  62. package/dist/fgca/index.js +2 -1
  63. package/dist/fgca/layout.d.ts +2 -2
  64. package/dist/fgca/layout.js +9 -9
  65. package/dist/fgca/nodeTypes.d.ts +1 -1
  66. package/dist/fgca/nodeTypes.js +2 -2
  67. package/dist/fgca/nodes/FGCAFactorNode.d.ts +3 -3
  68. package/dist/fgca/nodes/FGCAFactorNode.js +5 -5
  69. package/dist/fgca/parse-canonical.js +15 -10
  70. package/dist/fgca/preview-layout.d.ts +1 -1
  71. package/dist/fgca/preview-layout.js +4 -4
  72. package/dist/fgca/resolver.d.ts +49 -0
  73. package/dist/fgca/resolver.js +126 -0
  74. package/dist/fgca/types.d.ts +11 -11
  75. package/dist/fgca/types.js +2 -2
  76. package/dist/fgca/validate.d.ts +2 -2
  77. package/dist/fgca/validate.js +17 -14
  78. package/dist/goals/index.d.ts +1 -1
  79. package/dist/index.d.ts +5 -0
  80. package/dist/index.js +5 -0
  81. package/dist/process-blueprint/__tests__/layout.test.js +37 -0
  82. package/dist/process-blueprint/index.d.ts +1 -1
  83. package/dist/process-blueprint/layout.js +66 -35
  84. package/dist/process-blueprint/types.d.ts +36 -1
  85. package/dist/scenarios/index.d.ts +1 -1
  86. package/dist/scenarios/types.d.ts +4 -4
  87. package/dist/stakeholder/__tests__/validate.test.js +49 -47
  88. package/dist/stakeholder/index.d.ts +1 -0
  89. package/dist/stakeholder/types.d.ts +3 -4
  90. package/dist/stakeholder/types.js +2 -3
  91. package/dist/stakeholder/validate.d.ts +6 -1
  92. package/dist/stakeholder/validate.js +71 -50
  93. package/dist/target-state/__tests__/validate.test.js +43 -27
  94. package/dist/target-state/index.d.ts +2 -0
  95. package/dist/target-state/index.js +1 -0
  96. package/dist/target-state/types.d.ts +6 -1
  97. package/dist/target-state/types.js +8 -7
  98. package/dist/target-state/validate.d.ts +6 -1
  99. package/dist/target-state/validate.js +69 -45
  100. package/dist/theme/themes.js +71 -69
  101. package/dist/theme/tokens.d.ts +7 -1
  102. package/dist/theme/tokens.js +3 -1
  103. package/dist/webview/__tests__/entry-notations.test.js +2 -0
  104. package/dist/webview/__tests__/entry.test.js +11 -11
  105. package/dist/webview/__tests__/render-process.test.js +463 -0
  106. package/dist/webview/__tests__/render-util.test.d.ts +1 -0
  107. package/dist/webview/__tests__/render-util.test.js +54 -0
  108. package/dist/webview/entry.d.ts +1 -1
  109. package/dist/webview/entry.js +9 -5
  110. package/dist/webview/render-activities.d.ts +24 -2
  111. package/dist/webview/render-activities.js +92 -57
  112. package/dist/webview/render-activity-card.d.ts +11 -1
  113. package/dist/webview/render-activity-card.js +115 -79
  114. package/dist/webview/render-blocks.d.ts +24 -1
  115. package/dist/webview/render-blocks.js +58 -24
  116. package/dist/webview/render-fgca.d.ts +31 -0
  117. package/dist/webview/render-fgca.js +30 -19
  118. package/dist/webview/render-goals.d.ts +27 -1
  119. package/dist/webview/render-goals.js +42 -32
  120. package/dist/webview/render-process-blueprint.d.ts +11 -1
  121. package/dist/webview/render-process-blueprint.js +118 -53
  122. package/dist/webview/render-process.d.ts +95 -0
  123. package/dist/webview/render-process.js +392 -0
  124. package/dist/webview/render-scenarios.js +2 -2
  125. package/dist/webview/render-util.d.ts +19 -6
  126. package/dist/webview/render-util.js +23 -15
  127. package/package.json +54 -40
  128. package/src/__tests__/edge-path.test.ts +58 -46
  129. package/src/__tests__/scope.test.ts +27 -27
  130. package/src/__tests__/yaml-normalize.test.ts +158 -158
  131. package/src/activities/__tests__/cpm.test.ts +164 -164
  132. package/src/activities/__tests__/gantt.test.ts +245 -245
  133. package/src/activities/__tests__/layout.test.ts +112 -112
  134. package/src/activities/__tests__/validate.test.ts +409 -409
  135. package/src/activities/cpm.ts +107 -95
  136. package/src/activities/gantt.ts +277 -276
  137. package/src/activities/index.ts +28 -28
  138. package/src/activities/layout.ts +112 -112
  139. package/src/activities/types.ts +149 -148
  140. package/src/activities/validate.ts +357 -357
  141. package/src/activity-card/__tests__/example.test.ts +85 -66
  142. package/src/activity-card/__tests__/layout.test.ts +169 -63
  143. package/src/activity-card/__tests__/resolver.test.ts +330 -161
  144. package/src/activity-card/__tests__/validate.test.ts +131 -131
  145. package/src/activity-card/index.ts +38 -32
  146. package/src/activity-card/layout.ts +324 -194
  147. package/src/activity-card/resolver.ts +422 -337
  148. package/src/activity-card/types.ts +376 -237
  149. package/src/activity-card/validate.ts +162 -158
  150. package/src/actor/__tests__/validate.test.ts +70 -31
  151. package/src/actor/index.ts +1 -1
  152. package/src/actor/types.ts +21 -7
  153. package/src/actor/validate.ts +59 -27
  154. package/src/applications/__tests__/validate.test.ts +256 -256
  155. package/src/applications/index.ts +11 -11
  156. package/src/applications/types.ts +43 -43
  157. package/src/applications/validate.ts +131 -131
  158. package/src/assertion/__tests__/example.test.ts +37 -37
  159. package/src/assertion/__tests__/validate.test.ts +142 -142
  160. package/src/assertion/index.ts +12 -12
  161. package/src/assertion/types.ts +60 -58
  162. package/src/assertion/validate.ts +145 -145
  163. package/src/blocks/__tests__/layout.test.ts +169 -169
  164. package/src/blocks/__tests__/validate.test.ts +260 -260
  165. package/src/blocks/index.ts +17 -17
  166. package/src/blocks/layout.ts +186 -186
  167. package/src/blocks/types.ts +62 -62
  168. package/src/blocks/validate.ts +206 -206
  169. package/src/capability-map/__tests__/validate.test.ts +238 -238
  170. package/src/capability-map/index.ts +8 -8
  171. package/src/capability-map/types.ts +29 -29
  172. package/src/capability-map/validate.ts +127 -127
  173. package/src/change/__tests__/validate.test.ts +43 -34
  174. package/src/change/index.ts +1 -0
  175. package/src/change/types.ts +5 -3
  176. package/src/change/validate.ts +75 -43
  177. package/src/compliance/__tests__/classify.test.ts +64 -27
  178. package/src/compliance/__tests__/confidence.test.ts +98 -98
  179. package/src/compliance/__tests__/coverage-metric.test.ts +300 -188
  180. package/src/compliance/__tests__/demo-scenario.test.ts +273 -273
  181. package/src/compliance/__tests__/example.test.ts +57 -57
  182. package/src/compliance/__tests__/gap-report.test.ts +128 -128
  183. package/src/compliance/__tests__/html.test.ts +141 -141
  184. package/src/compliance/__tests__/impact.test.ts +1059 -481
  185. package/src/compliance/__tests__/markdown.test.ts +94 -94
  186. package/src/compliance/__tests__/views.test.ts +64 -64
  187. package/src/compliance/classify.ts +100 -84
  188. package/src/compliance/confidence.ts +69 -69
  189. package/src/compliance/coverage-metric.ts +404 -263
  190. package/src/compliance/gap-report.ts +94 -94
  191. package/src/compliance/html.ts +291 -295
  192. package/src/compliance/impact.ts +979 -677
  193. package/src/compliance/index.ts +57 -56
  194. package/src/compliance/markdown.ts +136 -135
  195. package/src/compliance/reverse-index.ts +33 -33
  196. package/src/compliance/types.ts +136 -120
  197. package/src/compliance/views.ts +46 -46
  198. package/src/compliance-matrix/__tests__/build.test.ts +200 -200
  199. package/src/compliance-matrix/__tests__/example.test.ts +57 -57
  200. package/src/compliance-matrix/index.ts +11 -11
  201. package/src/compliance-matrix/types.ts +102 -102
  202. package/src/edge-path.ts +50 -44
  203. package/src/factor/__tests__/validate.test.ts +81 -46
  204. package/src/factor/index.ts +3 -7
  205. package/src/factor/types.ts +15 -19
  206. package/src/factor/validate.ts +77 -51
  207. package/src/fgca/__tests__/chain-table.test.ts +172 -172
  208. package/src/fgca/__tests__/layout.test.ts +179 -179
  209. package/src/fgca/__tests__/parse-canonical.test.ts +248 -248
  210. package/src/fgca/__tests__/preview-layout.test.ts +124 -124
  211. package/src/fgca/__tests__/resolver.test.ts +209 -0
  212. package/src/fgca/__tests__/validate.test.ts +142 -142
  213. package/src/fgca/chain-table.ts +225 -225
  214. package/src/fgca/index.ts +47 -45
  215. package/src/fgca/layout.ts +204 -204
  216. package/src/fgca/nodeTypes.ts +11 -11
  217. package/src/fgca/nodes/FGCAActivityNode.tsx +65 -65
  218. package/src/fgca/nodes/FGCAChangeNode.tsx +64 -64
  219. package/src/fgca/nodes/FGCAFactorNode.tsx +64 -64
  220. package/src/fgca/nodes/FGCAGoalNode.tsx +72 -72
  221. package/src/fgca/parse-canonical.ts +405 -400
  222. package/src/fgca/preview-layout.ts +217 -217
  223. package/src/fgca/resolver.ts +159 -0
  224. package/src/fgca/types.ts +50 -50
  225. package/src/fgca/validate.ts +129 -126
  226. package/src/geometry.ts +9 -9
  227. package/src/goals/__tests__/layout.test.ts +175 -175
  228. package/src/goals/__tests__/mutations.test.ts +111 -111
  229. package/src/goals/__tests__/parse-canonical.test.ts +145 -145
  230. package/src/goals/__tests__/validate.test.ts +202 -202
  231. package/src/goals/index.ts +20 -21
  232. package/src/goals/layout.ts +172 -172
  233. package/src/goals/mutations.ts +123 -123
  234. package/src/goals/parse-canonical.ts +286 -286
  235. package/src/goals/types.ts +85 -85
  236. package/src/goals/validate.ts +136 -136
  237. package/src/index.ts +28 -23
  238. package/src/process-blueprint/__tests__/compliance-lane.test.ts +320 -320
  239. package/src/process-blueprint/__tests__/layout.test.ts +240 -195
  240. package/src/process-blueprint/__tests__/validate.test.ts +310 -310
  241. package/src/process-blueprint/index.ts +32 -31
  242. package/src/process-blueprint/layout.ts +564 -531
  243. package/src/process-blueprint/types.ts +278 -242
  244. package/src/process-blueprint/validate.ts +181 -181
  245. package/src/process-map/__tests__/validate.test.ts +223 -223
  246. package/src/process-map/index.ts +10 -10
  247. package/src/process-map/types.ts +36 -36
  248. package/src/process-map/validate.ts +135 -135
  249. package/src/products/__tests__/validate.test.ts +239 -239
  250. package/src/products/index.ts +9 -9
  251. package/src/products/types.ts +31 -31
  252. package/src/products/validate.ts +112 -112
  253. package/src/repo-validate/__tests__/validate-repo.test.ts +149 -149
  254. package/src/repo-validate/index.ts +2 -2
  255. package/src/repo-validate/types.ts +50 -50
  256. package/src/repo-validate/validate-repo.ts +196 -196
  257. package/src/requirement/__tests__/example.test.ts +24 -24
  258. package/src/requirement/__tests__/validate.test.ts +96 -96
  259. package/src/requirement/index.ts +4 -4
  260. package/src/requirement/types.ts +35 -35
  261. package/src/requirement/validate.ts +92 -92
  262. package/src/scenarios/__tests__/validate.test.ts +209 -209
  263. package/src/scenarios/index.ts +15 -15
  264. package/src/scenarios/types.ts +37 -37
  265. package/src/scenarios/validate.ts +122 -122
  266. package/src/schema-version.ts +16 -16
  267. package/src/scope.ts +46 -46
  268. package/src/stakeholder/__tests__/validate.test.ts +51 -47
  269. package/src/stakeholder/index.ts +1 -0
  270. package/src/stakeholder/types.ts +7 -7
  271. package/src/stakeholder/validate.ts +79 -52
  272. package/src/target-state/__tests__/validate.test.ts +48 -27
  273. package/src/target-state/index.ts +2 -0
  274. package/src/target-state/types.ts +11 -7
  275. package/src/target-state/validate.ts +76 -46
  276. package/src/theme/index.ts +4 -4
  277. package/src/theme/themes.ts +239 -237
  278. package/src/theme/tokens.ts +135 -133
  279. package/src/typed-id.ts +56 -56
  280. package/src/validation-types.ts +36 -36
  281. package/src/webview/__tests__/entry-notations.test.ts +79 -77
  282. package/src/webview/__tests__/entry.test.ts +64 -64
  283. package/src/webview/__tests__/render-goals.test.ts +72 -72
  284. package/src/webview/__tests__/render-process.test.ts +538 -0
  285. package/src/webview/__tests__/render-util.test.ts +66 -0
  286. package/src/webview/entry.ts +298 -292
  287. package/src/webview/render-activities.ts +111 -69
  288. package/src/webview/render-activity-card.ts +275 -234
  289. package/src/webview/render-blocks.ts +78 -28
  290. package/src/webview/render-fgca.ts +53 -28
  291. package/src/webview/render-goals.ts +133 -110
  292. package/src/webview/render-process-blueprint.ts +281 -207
  293. package/src/webview/render-process.ts +507 -0
  294. package/src/webview/render-scenarios.ts +3 -3
  295. package/src/webview/render-util.ts +27 -14
  296. package/src/webview/styles.css +322 -323
  297. package/src/yaml-normalize.ts +56 -56
  298. package/dist/element-envelope.d.ts +0 -15
  299. package/dist/element-envelope.js +0 -55
  300. package/dist/issues/__tests__/layout.test.js +0 -62
  301. package/dist/issues/__tests__/validate.test.js +0 -82
  302. package/dist/issues/index.d.ts +0 -4
  303. package/dist/issues/index.js +0 -2
  304. package/dist/issues/layout.d.ts +0 -10
  305. package/dist/issues/layout.js +0 -82
  306. package/dist/issues/types.d.ts +0 -61
  307. package/dist/issues/types.js +0 -6
  308. package/dist/issues/validate.d.ts +0 -3
  309. package/dist/issues/validate.js +0 -143
  310. package/dist/webview/transitrix-render.css +0 -323
  311. package/dist/webview/transitrix-render.js +0 -6452
  312. package/dist/webview/transitrix-render.js.map +0 -7
  313. package/src/element-envelope.ts +0 -76
  314. /package/dist/{issues/__tests__/layout.test.d.ts → fgca/__tests__/resolver.test.d.ts} +0 -0
  315. /package/dist/{issues/__tests__/validate.test.d.ts → webview/__tests__/render-process.test.d.ts} +0 -0
@@ -1,234 +1,275 @@
1
- /**
2
- * Host-neutral SVG renderer for the Activity Card notation.
3
- *
4
- * Step 4 of the IntelliJ epic (ADR 0001): the webview bundle must turn a
5
- * validated Activity Card document into renderable SVG so JCEF can drop it into
6
- * the preview panel. The VS Code path lives in
7
- * `extension/src/activity-card-preview.ts` and pulls in VS Code-specific
8
- * concerns (themes, title block, save dialogs, sibling-document discovery on
9
- * the filesystem); this module is the host-neutral subset — pure layout → SVG
10
- * with no VS Code APIs, no `node:fs`, no `node:path`.
11
- *
12
- * CROSS-DOCUMENT RESOLUTION CAVEAT
13
- * The Activity Card is the only MULTI-DOCUMENT Studio notation: the card YAML
14
- * names a project Activity, and the project's name, dates, motivation chain
15
- * (Factors → Goals → Changes) and child activities are pulled BY REFERENCE from
16
- * the canonical element + relation store (`canon/elements/**`,
17
- * `canon/relations/**`; see `../activity-card/resolver.ts`). That resolution
18
- * requires reading those files from disk, which is NOT available inside the
19
- * JCEF host. We therefore resolve from the single in-memory card document
20
- * ONLY: we synthesise
21
- * a minimal `ResolvedActivityCard` whose project carries just the referenced
22
- * project id (no resolved name/dates), whose milestones come straight from the
23
- * card's own `milestones[]`, and whose motivation chain + child activities are
24
- * empty (those cannot resolve without the siblings). The SVG layout is shared
25
- * with the VS Code path via `layoutActivityCard`, so a single-document card
26
- * still renders its title, dates band and milestone timeline.
27
- */
28
- import { layoutActivityCard, ARCHIMATE_CLASS } from '../activity-card/layout.js';
29
- import type {
30
- ActivityCardDoc,
31
- ActivityCardLayout,
32
- ResolvedActivityCard,
33
- ResolvedMilestone,
34
- } from '../activity-card/types.js';
35
- import { generateSvgEmbedCss } from '../theme/index.js';
36
- import { escXml } from './render-util.js';
37
-
38
- const PAD = 24;
39
-
40
- const EMPTY_SVG = `<svg xmlns="http://www.w3.org/2000/svg" width="0" height="0" viewBox="0 0 0 0"></svg>`;
41
-
42
- export interface RenderActivityCardOptions {
43
- title?: string;
44
- }
45
-
46
- function truncate(text: string, maxChars: number): string {
47
- if (text.length <= maxChars) return text;
48
- return text.slice(0, Math.max(0, maxChars - 1)) + '…';
49
- }
50
-
51
- /**
52
- * Build a single-document resolution of the card: everything that can be read
53
- * straight off the card YAML, with the cross-document fields left empty. This
54
- * mirrors what `resolveActivityCard` produces, minus the parts that need the
55
- * canon element + relation store (project name/dates, motivation chain, child
56
- * activities).
57
- */
58
- function resolveSingleDoc(doc: ActivityCardDoc): ResolvedActivityCard {
59
- const card = doc.activity_card;
60
- const rawMilestones = Array.isArray(card?.milestones) ? card.milestones : [];
61
-
62
- const milestones: ResolvedMilestone[] = rawMilestones
63
- .filter((m): m is NonNullable<typeof m> => !!m && typeof m === 'object')
64
- .map((m) => ({
65
- id: m.id,
66
- name: m.name,
67
- date: m.date,
68
- description: m.description,
69
- deliversChanges: Array.isArray(m.delivers_changes) ? m.delivers_changes : [],
70
- }))
71
- .sort((a, b) => (a.date < b.date ? -1 : a.date > b.date ? 1 : 0));
72
-
73
- return {
74
- cardId: card?.id ?? '',
75
- cardDescription: card?.description,
76
- // No sibling docs in the host-neutral path: the project resolves to its id
77
- // only. The layout falls back to '—' for the unknown date fields.
78
- project: { id: card?.project ?? '', name: card?.project ?? '' },
79
- milestones,
80
- motivation: { factors: [], goals: [], changes: [] },
81
- childActivities: [],
82
- };
83
- }
84
-
85
- function buildBody(layout: ActivityCardLayout, ox: number, oy: number): string {
86
- const parts: string[] = [];
87
-
88
- // Outer card.
89
- parts.push(
90
- `<rect class="diagram-node level-0" x="${ox}" y="${oy}" width="${layout.bounds.width}" height="${layout.bounds.height}" rx="8"/>`,
91
- );
92
-
93
- // Title (project name / id).
94
- parts.push(
95
- `<text class="text-header" x="${layout.title.x + ox}" y="${layout.title.y + oy}" dominant-baseline="central" font-size="18">${escXml(truncate(layout.title.name, 70))}</text>`,
96
- );
97
-
98
- // Dates band.
99
- for (const d of layout.dateFields) {
100
- parts.push(
101
- `<rect class="diagram-node level-2" x="${d.x + ox}" y="${d.y + oy}" width="${d.width}" height="${d.height}" rx="6"/>`,
102
- );
103
- parts.push(
104
- `<text class="text-secondary" x="${d.x + ox + 12}" y="${d.y + oy + 18}" dominant-baseline="central">${escXml(d.label)}</text>`,
105
- );
106
- parts.push(
107
- `<text class="text-primary" x="${d.x + ox + 12}" y="${d.y + oy + 40}" dominant-baseline="central">${escXml(d.value)}</text>`,
108
- );
109
- }
110
-
111
- // Section headers.
112
- for (const s of layout.sectionHeaders) {
113
- parts.push(
114
- `<text class="text-header" x="${s.x + ox}" y="${s.y + oy + s.height / 2}" dominant-baseline="central">${escXml(s.label)}</text>`,
115
- );
116
- }
117
-
118
- // Milestones.
119
- for (const m of layout.milestones) {
120
- parts.push(
121
- `<rect class="diagram-node level-3" x="${m.x + ox}" y="${m.y + oy}" width="${m.width}" height="${m.height}" rx="6"/>`,
122
- );
123
- parts.push(
124
- `<text class="text-secondary" x="${m.x + ox + 10}" y="${m.y + oy + 16}" dominant-baseline="central">${escXml(m.date)}</text>`,
125
- );
126
- parts.push(
127
- `<text class="text-primary" x="${m.x + ox + 10}" y="${m.y + oy + 36}" dominant-baseline="central">${escXml(truncate(m.name, 22))}</text>`,
128
- );
129
- parts.push(
130
- `<text class="text-secondary" x="${m.x + ox + 10}" y="${m.y + oy + 52}" dominant-baseline="central" font-style="italic">(${escXml(m.archimateClass)})</text>`,
131
- );
132
- }
133
-
134
- // Motivation chain — edges first (under nodes).
135
- const nodeById = new Map<string, { x: number; y: number; width: number; height: number }>();
136
- for (const col of [
137
- layout.chainColumns.factors,
138
- layout.chainColumns.goals,
139
- layout.chainColumns.changes,
140
- ]) {
141
- for (const n of col) nodeById.set(n.id, n);
142
- }
143
- for (const e of layout.chainEdges) {
144
- const s = nodeById.get(e.sourceId);
145
- const t = nodeById.get(e.targetId);
146
- if (!s || !t) continue;
147
- const x1 = s.x + s.width + ox;
148
- const y1 = s.y + s.height / 2 + oy;
149
- const x2 = t.x + ox;
150
- const y2 = t.y + t.height / 2 + oy;
151
- const mx = (x1 + x2) / 2;
152
- parts.push(
153
- `<path class="diagram-edge" d="M${x1},${y1} C${mx},${y1} ${mx},${y2} ${x2},${y2}" fill="none" marker-end="url(#ac-arrow)"/>`,
154
- );
155
- }
156
- const chainLevels: Array<[typeof layout.chainColumns.factors, number]> = [
157
- [layout.chainColumns.factors, 4],
158
- [layout.chainColumns.goals, 5],
159
- [layout.chainColumns.changes, 6],
160
- ];
161
- for (const [col, level] of chainLevels) {
162
- for (const n of col) {
163
- parts.push(
164
- `<rect class="diagram-node level-${level}" x="${n.x + ox}" y="${n.y + oy}" width="${n.width}" height="${n.height}" rx="6"/>`,
165
- );
166
- parts.push(
167
- `<text class="text-pill" x="${n.x + ox + n.width / 2}" y="${n.y + oy + n.height / 2}" text-anchor="middle" dominant-baseline="central">${escXml(truncate(n.name, Math.floor(n.width / 7)))}</text>`,
168
- );
169
- }
170
- }
171
-
172
- // Child activities.
173
- for (const a of layout.childActivities) {
174
- parts.push(
175
- `<rect class="diagram-node level-1" x="${a.x + ox}" y="${a.y + oy}" width="${a.width}" height="${a.height}" rx="6"/>`,
176
- );
177
- parts.push(
178
- `<text class="text-primary" x="${a.x + ox + 12}" y="${a.y + oy + a.height / 2}" dominant-baseline="central">${escXml(truncate(a.name, 48))} <tspan class="text-secondary" font-style="italic">(${escXml(a.archimateClass)})</tspan></text>`,
179
- );
180
- if (a.meta) {
181
- parts.push(
182
- `<text class="text-secondary" x="${a.x + a.width + ox - 12}" y="${a.y + oy + a.height / 2}" text-anchor="end" dominant-baseline="central">${escXml(truncate(a.meta, 40))}</text>`,
183
- );
184
- }
185
- }
186
-
187
- return parts.join('\n');
188
- }
189
-
190
- export function renderActivityCardSvg(
191
- doc: ActivityCardDoc,
192
- options: RenderActivityCardOptions = {},
193
- ): string {
194
- // `ARCHIMATE_CLASS` is referenced so the host-neutral module pins the same
195
- // §5.1 class convention the layout applies; keeps the import meaningful.
196
- void ARCHIMATE_CLASS;
197
-
198
- const { title = '' } = options;
199
-
200
- const resolved = resolveSingleDoc(doc);
201
- const layout = layoutActivityCard(resolved);
202
-
203
- if (layout.bounds.width <= 0 || layout.bounds.height <= 0) {
204
- return EMPTY_SVG;
205
- }
206
-
207
- const titleH = title ? 28 : 0;
208
- const w = layout.bounds.width + PAD * 2;
209
- const h = layout.bounds.height + PAD * 2 + titleH;
210
- const ox = PAD;
211
- const oy = PAD + titleH;
212
-
213
- const body = buildBody(layout, ox, oy);
214
-
215
- const titleSvg = title
216
- ? `<text class="text-header" x="${PAD}" y="${PAD + 14}">${escXml(`Activity Card — ${title}`)}</text>`
217
- : '';
218
-
219
- // Embed the shared theme CSS inside the SVG so the rendered output is
220
- // self-contained — the JCEF host page only needs to drop the SVG into the
221
- // DOM and styling resolves without any cooperation from the host stylesheet.
222
- const embedCss = generateSvgEmbedCss('transitrix');
223
-
224
- return `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">
225
- <style>${embedCss}</style>
226
- <defs>
227
- <marker id="ac-arrow" markerWidth="8" markerHeight="8" refX="8" refY="3" orient="auto">
228
- <path d="M0,0 L0,6 L8,3 z" class="arrow-fill"/>
229
- </marker>
230
- </defs>
231
- ${titleSvg}
232
- ${body}
233
- </svg>`;
234
- }
1
+ /**
2
+ * Host-neutral SVG renderer for the Activity Card notation.
3
+ *
4
+ * Step 4 of the IntelliJ epic (ADR 0001): the webview bundle must turn a
5
+ * validated Activity Card document into renderable SVG so JCEF can drop it into
6
+ * the preview panel. The VS Code path lives in
7
+ * `extension/src/activity-card-preview.ts` and pulls in VS Code-specific
8
+ * concerns (themes, title block, save dialogs, sibling-document discovery on
9
+ * the filesystem); this module is the host-neutral subset — pure layout → SVG
10
+ * with no VS Code APIs, no `node:fs`, no `node:path`.
11
+ *
12
+ * CROSS-DOCUMENT RESOLUTION CAVEAT
13
+ * The Activity Card is the only MULTI-DOCUMENT Studio notation: the card YAML
14
+ * names a project Activity, and the project's name, dates, motivation chain
15
+ * (Drivers → Assessments → Goals → Changes) and child activities are pulled BY
16
+ * REFERENCE from the canonical element + relation store (`canon/elements/**`,
17
+ * `canon/relations/**`; see `../activity-card/resolver.ts`). That resolution
18
+ * requires reading those files from disk, which is NOT available inside the
19
+ * JCEF host. We therefore resolve from the single in-memory card document
20
+ * ONLY: we synthesise a minimal `ResolvedActivityCard` whose project carries
21
+ * just the referenced project id (no resolved name/dates), whose milestones
22
+ * come straight from the card's own `milestones[]`, and whose chain sections
23
+ * and child activities are empty. The SVG layout is shared with the VS Code
24
+ * path via `layoutActivityCard`, so a single-document card still renders its
25
+ * title, dates band and milestone section.
26
+ */
27
+ import { layoutActivityCard, ARCHIMATE_CLASS } from '../activity-card/layout.js';
28
+ import type {
29
+ ActivityCardDoc,
30
+ ActivityCardLayout,
31
+ ResolvedActivityCard,
32
+ ResolvedMilestone,
33
+ } from '../activity-card/types.js';
34
+ import { generateSvgEmbedCss } from '../theme/index.js';
35
+ import { escXml } from './render-util.js';
36
+
37
+ const PAD = 24;
38
+ const EMPTY_SVG = `<svg xmlns="http://www.w3.org/2000/svg" width="0" height="0" viewBox="0 0 0 0"></svg>`;
39
+
40
+ export interface RenderActivityCardOptions {
41
+ title?: string;
42
+ }
43
+
44
+ function truncate(text: string, maxChars: number): string {
45
+ if (text.length <= maxChars) return text;
46
+ return text.slice(0, Math.max(0, maxChars - 1)) + '…';
47
+ }
48
+
49
+ function resolveSingleDoc(doc: ActivityCardDoc): ResolvedActivityCard {
50
+ const card = doc.activity_card;
51
+ const rawMilestones = Array.isArray(card?.milestones) ? card.milestones : [];
52
+
53
+ const milestones: ResolvedMilestone[] = rawMilestones
54
+ .filter((m): m is NonNullable<typeof m> => !!m && typeof m === 'object')
55
+ .map((m) => ({
56
+ id: m.id,
57
+ name: m.name,
58
+ date: m.date,
59
+ description: m.description,
60
+ deliversChanges: Array.isArray(m.delivers_changes) ? m.delivers_changes : [],
61
+ }))
62
+ .sort((a, b) => (a.date < b.date ? -1 : a.date > b.date ? 1 : 0));
63
+
64
+ return {
65
+ cardId: card?.id ?? '',
66
+ cardDescription: card?.description,
67
+ // No sibling docs in the host-neutral path: the project resolves to its id
68
+ // only. The layout falls back to '—' for the unknown date fields.
69
+ project: { id: card?.project ?? '', name: card?.project ?? '' },
70
+ milestones,
71
+ motivation: { drivers: [], goals: [], changes: [] },
72
+ assessments: [],
73
+ childActivities: [],
74
+ notes: card?.notes,
75
+ };
76
+ }
77
+
78
+ /**
79
+ * The single Activity Card SVG body emitter shared by every host. Takes an
80
+ * already-laid-out {@link ActivityCardLayout} plus the canvas offset and emits
81
+ * the body elements (card, header, badges, dates, chain sections, milestones,
82
+ * child activities, footer) — everything except the host chrome (`<defs>`
83
+ * marker, title, embedded CSS, `<svg>` wrapper). The VS Code preview and the
84
+ * host-neutral {@link renderActivityCardSvg} both build their own chrome around
85
+ * this single source of truth.
86
+ */
87
+ export function renderActivityCardBody(layout: ActivityCardLayout, ox: number, oy: number): string {
88
+ const parts: string[] = [];
89
+
90
+ // Outer card.
91
+ parts.push(
92
+ `<rect class="diagram-node level-0" x="${ox}" y="${oy}" width="${layout.bounds.width}" height="${layout.bounds.height}" rx="8"/>`,
93
+ );
94
+
95
+ // Title row.
96
+ parts.push(
97
+ `<text class="text-header" x="${layout.titleRow.x + ox}" y="${layout.titleRow.y + oy}" style="dominant-baseline:central" font-size="18">${escXml(truncate(layout.titleRow.name, 60))}</text>`,
98
+ );
99
+
100
+ // Activity type badge.
101
+ if (layout.activityTypeBadge) {
102
+ const b = layout.activityTypeBadge;
103
+ parts.push(`<rect class="diagram-node level-2" x="${b.x + ox}" y="${b.y + oy}" width="${b.width}" height="${b.height}" rx="4"/>`);
104
+ parts.push(`<text class="text-secondary" style="dominant-baseline:central;text-anchor:middle" x="${b.x + ox + b.width / 2}" y="${b.y + oy + b.height / 2}">${escXml(b.label)}</text>`);
105
+ }
106
+
107
+ // Status badge.
108
+ if (layout.statusBadge) {
109
+ const b = layout.statusBadge;
110
+ parts.push(`<rect class="diagram-node level-3" x="${b.x + ox}" y="${b.y + oy}" width="${b.width}" height="${b.height}" rx="4"/>`);
111
+ parts.push(`<text class="text-secondary" style="dominant-baseline:central;text-anchor:middle" x="${b.x + ox + b.width / 2}" y="${b.y + oy + b.height / 2}">${escXml(b.label)}</text>`);
112
+ }
113
+
114
+ // Date fields.
115
+ for (const d of layout.dateFields) {
116
+ parts.push(`<rect class="diagram-node level-2" x="${d.x + ox}" y="${d.y + oy}" width="${d.width}" height="${d.height}" rx="6"/>`);
117
+ parts.push(`<text class="text-secondary" x="${d.x + ox + 12}" y="${d.y + oy + 18}" style="dominant-baseline:central">${escXml(d.label)}</text>`);
118
+ parts.push(`<text class="text-primary" x="${d.x + ox + 12}" y="${d.y + oy + 40}" style="dominant-baseline:central">${escXml(d.value)}</text>`);
119
+ }
120
+
121
+ // Stakeholder role slots (2-column grid).
122
+ for (const s of layout.stakeholderRoleSlots) {
123
+ parts.push(`<rect class="diagram-node level-2" x="${s.x + ox}" y="${s.y + oy}" width="${s.width}" height="${s.height}" rx="6"/>`);
124
+ parts.push(`<text class="text-secondary" x="${s.x + ox + 10}" y="${s.y + oy + 16}" style="dominant-baseline:central">${escXml(s.role)}</text>`);
125
+ parts.push(`<text class="text-primary" x="${s.x + ox + 10}" y="${s.y + oy + 36}" style="dominant-baseline:central">${escXml(truncate(s.name, 40))}</text>`);
126
+ }
127
+
128
+ // Description row.
129
+ if (layout.descriptionRow) {
130
+ const r = layout.descriptionRow;
131
+ parts.push(`<rect class="diagram-node level-2" x="${r.x + ox}" y="${r.y + oy}" width="${r.width}" height="${r.height}" rx="6"/>`);
132
+ parts.push(`<text class="text-secondary" x="${r.x + ox + 12}" y="${r.y + oy + 22}" style="dominant-baseline:central">${escXml(r.label)}</text>`);
133
+ r.valueLines.forEach((line, i) => {
134
+ parts.push(`<text class="text-primary" x="${r.x + ox + 12}" y="${r.y + oy + 44 + i * 18}" style="dominant-baseline:central">${escXml(line)}</text>`);
135
+ });
136
+ }
137
+
138
+ // Chain sections (Drivers → Assessments → Goals → Changes).
139
+ const SECTION_LEVEL: Record<string, number> = {
140
+ drivers: 4,
141
+ assessments: 5,
142
+ goals: 5,
143
+ changes: 6,
144
+ };
145
+ for (let si = 0; si < layout.chainSections.length; si++) {
146
+ const section = layout.chainSections[si];
147
+ const level = SECTION_LEVEL[section.type] ?? 5;
148
+
149
+ // Section outer box.
150
+ parts.push(
151
+ `<rect class="diagram-node level-1" x="${section.x + ox}" y="${section.y + oy}" width="${section.width}" height="${section.height}" rx="6"/>`,
152
+ );
153
+ // Section header label + subtitle.
154
+ parts.push(
155
+ `<text class="text-header" x="${section.x + ox + 12}" y="${section.y + oy + 14}" style="dominant-baseline:central">${escXml(section.label)}<tspan class="text-secondary" font-size="11"> (${escXml(section.subtitle)})</tspan></text>`,
156
+ );
157
+
158
+ if (section.isEmpty) {
159
+ // Gap indicator.
160
+ parts.push(
161
+ `<text class="text-secondary" x="${section.x + ox + 12}" y="${section.y + oy + 24 + 8 + 16}" style="dominant-baseline:central">— not on file</text>`,
162
+ );
163
+ } else {
164
+ for (const n of section.nodes) {
165
+ parts.push(
166
+ `<rect class="diagram-node level-${level}" x="${n.x + ox}" y="${n.y + oy}" width="${n.width}" height="${n.height}" rx="4"/>`,
167
+ );
168
+ parts.push(
169
+ `<text class="text-primary" x="${n.x + ox + 10}" y="${n.y + oy + (n.meta ? 16 : n.height / 2)}" style="dominant-baseline:central">${escXml(truncate(n.name, 80))}</text>`,
170
+ );
171
+ if (n.meta) {
172
+ parts.push(
173
+ `<text class="text-secondary" x="${n.x + ox + 10}" y="${n.y + oy + 30}" style="dominant-baseline:central">${escXml(n.meta)}</text>`,
174
+ );
175
+ }
176
+ }
177
+ }
178
+
179
+ // Connector arrow to next section.
180
+ if (si < layout.chainSections.length - 1) {
181
+ const nextSection = layout.chainSections[si + 1];
182
+ const arrowX = section.x + ox + section.width / 2;
183
+ const arrowTopY = section.y + oy + section.height;
184
+ const arrowBotY = nextSection.y + oy;
185
+ const midY = (arrowTopY + arrowBotY) / 2;
186
+ parts.push(
187
+ `<path class="diagram-edge" d="M${arrowX},${arrowTopY} L${arrowX},${arrowBotY}" fill="none" marker-end="url(#ac-arrow)"/>`,
188
+ );
189
+ void midY; // midpoint available for future label placement
190
+ }
191
+ }
192
+
193
+ // Milestones.
194
+ for (const m of layout.milestones) {
195
+ parts.push(
196
+ `<rect class="diagram-node level-3" x="${m.x + ox}" y="${m.y + oy}" width="${m.width}" height="${m.height}" rx="6"/>`,
197
+ );
198
+ parts.push(
199
+ `<text class="text-secondary" x="${m.x + ox + 10}" y="${m.y + oy + 16}" style="dominant-baseline:central">${escXml(m.date)}</text>`,
200
+ );
201
+ parts.push(
202
+ `<text class="text-primary" x="${m.x + ox + 10}" y="${m.y + oy + 36}" style="dominant-baseline:central">${escXml(truncate(m.name, 22))}</text>`,
203
+ );
204
+ parts.push(
205
+ `<text class="text-secondary" x="${m.x + ox + 10}" y="${m.y + oy + 52}" style="dominant-baseline:central">(${escXml(m.archimateClass)})</text>`,
206
+ );
207
+ }
208
+
209
+ // Child activities.
210
+ for (const a of layout.childActivities) {
211
+ parts.push(
212
+ `<rect class="diagram-node level-1" x="${a.x + ox}" y="${a.y + oy}" width="${a.width}" height="${a.height}" rx="6"/>`,
213
+ );
214
+ parts.push(
215
+ `<text class="text-primary" x="${a.x + ox + 12}" y="${a.y + oy + a.height / 2}" style="dominant-baseline:central">${escXml(truncate(a.name, 48))} <tspan class="text-secondary">(${escXml(a.archimateClass)})</tspan></text>`,
216
+ );
217
+ if (a.meta) {
218
+ parts.push(
219
+ `<text class="text-secondary" x="${a.x + a.width + ox - 12}" y="${a.y + oy + a.height / 2}" style="dominant-baseline:central;text-anchor:end">${escXml(truncate(a.meta, 40))}</text>`,
220
+ );
221
+ }
222
+ }
223
+
224
+ // Footer — notes.
225
+ if (layout.footerRow) {
226
+ const r = layout.footerRow;
227
+ parts.push(`<rect class="diagram-node level-2" x="${r.x + ox}" y="${r.y + oy}" width="${r.width}" height="${r.height}" rx="6"/>`);
228
+ parts.push(`<text class="text-secondary" x="${r.x + ox + 12}" y="${r.y + oy + 22}" style="dominant-baseline:central">${escXml(r.label)}</text>`);
229
+ r.valueLines.forEach((line, i) => {
230
+ parts.push(`<text class="text-primary" x="${r.x + ox + 12}" y="${r.y + oy + 44 + i * 18}" style="dominant-baseline:central">${escXml(line)}</text>`);
231
+ });
232
+ }
233
+
234
+ return parts.join('\n');
235
+ }
236
+
237
+ export function renderActivityCardSvg(
238
+ doc: ActivityCardDoc,
239
+ options: RenderActivityCardOptions = {},
240
+ ): string {
241
+ // `ARCHIMATE_CLASS` is referenced so the host-neutral module pins the same
242
+ // §5.1 class convention the layout applies; keeps the import meaningful.
243
+ void ARCHIMATE_CLASS;
244
+
245
+ const { title = '' } = options;
246
+ const resolved = resolveSingleDoc(doc);
247
+ const layout = layoutActivityCard(resolved);
248
+
249
+ if (layout.bounds.width <= 0 || layout.bounds.height <= 0) return EMPTY_SVG;
250
+
251
+ const titleH = title ? 28 : 0;
252
+ const w = layout.bounds.width + PAD * 2;
253
+ const h = layout.bounds.height + PAD * 2 + titleH;
254
+ const ox = PAD;
255
+ const oy = PAD + titleH;
256
+
257
+ const body = renderActivityCardBody(layout, ox, oy);
258
+
259
+ const titleSvg = title
260
+ ? `<text class="text-header" x="${PAD}" y="${PAD + 14}">${escXml(`Activity Card — ${title}`)}</text>`
261
+ : '';
262
+
263
+ const embedCss = generateSvgEmbedCss('transitrix');
264
+
265
+ return `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">
266
+ <style>${embedCss}</style>
267
+ <defs>
268
+ <marker id="ac-arrow" markerWidth="8" markerHeight="8" refX="8" refY="3" orient="auto">
269
+ <path d="M0,0 L0,6 L8,3 z" class="arrow-fill"/>
270
+ </marker>
271
+ </defs>
272
+ ${titleSvg}
273
+ ${body}
274
+ </svg>`;
275
+ }