@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,217 +1,217 @@
1
- // Pure column-layout geometry for the static FGCA / FGA previews.
2
- //
3
- // This is the layout the Studio extension's `fgca-preview.ts` renders to SVG
4
- // (NOT the ReactFlow `buildFGCALayout` in `./layout.ts`, which targets the
5
- // interactive web UI). It lives here — rather than inline in the extension —
6
- // so the gap geometry is unit-testable: the extension has no test harness.
7
- //
8
- // No React, no DOM, no vscode. Safe to call in Node.js or a test environment.
9
-
10
- import type { Scope } from '../scope.js';
11
-
12
- export type FGCAPreviewColumn = 'factor' | 'goal' | 'change' | 'activity';
13
-
14
- export interface FGCAPreviewFactor {
15
- id: number | string;
16
- name: string;
17
- }
18
- export interface FGCAPreviewGoal {
19
- id: number | string;
20
- name: string;
21
- level?: number;
22
- factor?: Array<{ id: number | string }>;
23
- }
24
- export interface FGCAPreviewChange {
25
- id: number | string;
26
- name: string;
27
- goal_id: number | string;
28
- activity_ids: Array<number | string>;
29
- }
30
- export interface FGCAPreviewActivity {
31
- id: number | string;
32
- name: string;
33
- goal_id?: number | string | null;
34
- }
35
-
36
- /** Structural input the preview layout needs — a subset of the parsed FGCA/FGA doc. */
37
- export interface FGCAPreviewDoc {
38
- factors: FGCAPreviewFactor[];
39
- goals: FGCAPreviewGoal[];
40
- changes?: FGCAPreviewChange[];
41
- activities: FGCAPreviewActivity[];
42
- }
43
-
44
- export interface FGCAPreviewLayoutOptions {
45
- /** FGA hides the Changes column and links Goal → Activity directly. */
46
- hideChanges?: boolean;
47
- /** Horizontal gap (px) between columns. Default matches the historical hardcoded value. */
48
- colGap?: number;
49
- /** Vertical gap (px) between stacked nodes within a column. Default matches the historical hardcoded value. */
50
- rowGap?: number;
51
- /** Trim to a level cap or a single root goal (vkgeorgia/strategy#77). Defaults to 'all'. */
52
- scope?: Scope;
53
- }
54
-
55
- /**
56
- * Trims an FGCA/FGA doc to a scope (vkgeorgia/strategy#77).
57
- *
58
- * FGCA/FGA goals are flat (no parent_id), so:
59
- * - 'level' → goals with `(level ?? 0) <= maxLevel`.
60
- * - 'root' → the single goal whose id matches `rootGoalId` (empty when absent).
61
- *
62
- * Factors, changes and activities are then kept only when they touch a visible
63
- * goal: a factor referenced by a visible goal, a change whose `goal_id` is
64
- * visible, an activity bound to a visible goal directly or via a visible
65
- * change. Pure and exported so an access-control layer can reuse it.
66
- */
67
- export function selectScopedFGCA(doc: FGCAPreviewDoc, scope: Scope): FGCAPreviewDoc {
68
- if (scope.mode === 'all') return doc;
69
-
70
- const visibleGoals =
71
- scope.mode === 'level'
72
- ? doc.goals.filter(g => (g.level ?? 0) <= scope.maxLevel)
73
- : doc.goals.filter(g => String(g.id) === scope.rootGoalId);
74
-
75
- const visibleGoalIds = new Set(visibleGoals.map(g => g.id));
76
-
77
- const changes = doc.changes ?? [];
78
- const visibleChanges = changes.filter(c => visibleGoalIds.has(c.goal_id));
79
- const activityIdsViaChange = new Set(visibleChanges.flatMap(c => c.activity_ids));
80
-
81
- const visibleActivities = doc.activities.filter(
82
- a => (a.goal_id != null && visibleGoalIds.has(a.goal_id)) || activityIdsViaChange.has(a.id),
83
- );
84
-
85
- const factorIds = new Set(visibleGoals.flatMap(g => (g.factor ?? []).map(f => f.id)));
86
- const visibleFactors = doc.factors.filter(f => factorIds.has(f.id));
87
-
88
- return {
89
- factors: visibleFactors,
90
- goals: visibleGoals,
91
- changes: doc.changes === undefined ? undefined : visibleChanges,
92
- activities: visibleActivities,
93
- };
94
- }
95
-
96
- export interface FGCAPreviewNode {
97
- id: string;
98
- x: number;
99
- y: number;
100
- label: string;
101
- col: FGCAPreviewColumn;
102
- }
103
- export interface FGCAPreviewEdge {
104
- sx: number;
105
- sy: number;
106
- tx: number;
107
- ty: number;
108
- }
109
- /** Per-column header anchor — lets the renderer draw column headers without recomputing the stride. */
110
- export interface FGCAPreviewColumnPos {
111
- col: FGCAPreviewColumn;
112
- x: number;
113
- }
114
- export interface FGCAPreviewLayout {
115
- nodes: FGCAPreviewNode[];
116
- edges: FGCAPreviewEdge[];
117
- columns: FGCAPreviewColumnPos[];
118
- width: number;
119
- height: number;
120
- }
121
-
122
- // Fixed node + frame geometry. Only the inter-node gaps are user-configurable
123
- // (vkgeorgia/strategy#75); node size and padding stay constant.
124
- export const FGCA_NODE_W = 220;
125
- export const FGCA_NODE_H = 72;
126
- export const FGCA_HEADER_H = 32;
127
- export const FGCA_PAD = 20;
128
- export const FGCA_DEFAULT_COL_GAP = 160;
129
- export const FGCA_DEFAULT_ROW_GAP = 20;
130
-
131
- export function layoutFGCAPreview(
132
- inputDoc: FGCAPreviewDoc,
133
- options: FGCAPreviewLayoutOptions = {},
134
- ): FGCAPreviewLayout {
135
- const {
136
- hideChanges = false,
137
- colGap = FGCA_DEFAULT_COL_GAP,
138
- rowGap = FGCA_DEFAULT_ROW_GAP,
139
- scope = { mode: 'all' },
140
- } = options;
141
-
142
- // Trim to scope first; everything below lays out the visible subset only.
143
- const doc = selectScopedFGCA(inputDoc, scope);
144
-
145
- const colStride = FGCA_NODE_W + colGap;
146
- const cols: FGCAPreviewColumn[] = hideChanges
147
- ? ['factor', 'goal', 'activity']
148
- : ['factor', 'goal', 'change', 'activity'];
149
- const changes = doc.changes ?? [];
150
- const colItems: Record<FGCAPreviewColumn, Array<{ id: string; label: string }>> = {
151
- factor: doc.factors.map(f => ({ id: `factor_${f.id}`, label: f.name })),
152
- goal: doc.goals.map(g => ({ id: `goal_${g.id}`, label: g.name })),
153
- change: changes.map(c => ({ id: `change_${c.id}`, label: c.name })),
154
- activity: doc.activities.map(a => ({ id: `activity_${a.id}`, label: a.name })),
155
- };
156
-
157
- const nodeMap = new Map<string, FGCAPreviewNode>();
158
- const nodes: FGCAPreviewNode[] = [];
159
- const columns: FGCAPreviewColumnPos[] = [];
160
-
161
- for (let ci = 0; ci < cols.length; ci++) {
162
- const col = cols[ci];
163
- const x = FGCA_PAD + ci * colStride;
164
- columns.push({ col, x });
165
- let y = FGCA_PAD + FGCA_HEADER_H + rowGap;
166
- for (const item of colItems[col]) {
167
- const node: FGCAPreviewNode = { id: item.id, x, y, label: item.label, col };
168
- nodes.push(node);
169
- nodeMap.set(item.id, node);
170
- y += FGCA_NODE_H + rowGap;
171
- }
172
- }
173
-
174
- const edges: FGCAPreviewEdge[] = [];
175
- function addEdge(sourceId: string, targetId: string): void {
176
- const s = nodeMap.get(sourceId);
177
- const t = nodeMap.get(targetId);
178
- if (!s || !t) return;
179
- edges.push({ sx: s.x + FGCA_NODE_W, sy: s.y + FGCA_NODE_H / 2, tx: t.x, ty: t.y + FGCA_NODE_H / 2 });
180
- }
181
-
182
- for (const g of doc.goals) {
183
- for (const f of (g.factor ?? [])) addEdge(`factor_${f.id}`, `goal_${g.id}`);
184
- }
185
- if (hideChanges) {
186
- const connectedViaChange = new Set<number | string>();
187
- for (const c of changes) {
188
- for (const aid of c.activity_ids) {
189
- addEdge(`goal_${c.goal_id}`, `activity_${aid}`);
190
- connectedViaChange.add(aid);
191
- }
192
- }
193
- for (const a of doc.activities) {
194
- if (a.goal_id != null && !connectedViaChange.has(a.id)) {
195
- addEdge(`goal_${a.goal_id}`, `activity_${a.id}`);
196
- }
197
- }
198
- } else {
199
- for (const c of changes) addEdge(`goal_${c.goal_id}`, `change_${c.id}`);
200
- for (const c of changes) for (const aid of c.activity_ids) addEdge(`change_${c.id}`, `activity_${aid}`);
201
- const coveredActivities = new Set(changes.flatMap(c => c.activity_ids));
202
- for (const a of doc.activities) {
203
- if (a.goal_id != null && !coveredActivities.has(a.id)) {
204
- addEdge(`goal_${a.goal_id}`, `activity_${a.id}`);
205
- }
206
- }
207
- }
208
-
209
- const maxNodeBottom = nodes.reduce(
210
- (m, n) => Math.max(m, n.y + FGCA_NODE_H),
211
- FGCA_PAD + FGCA_HEADER_H + rowGap + FGCA_NODE_H,
212
- );
213
- const width = FGCA_PAD * 2 + cols.length * colStride - colGap;
214
- const height = maxNodeBottom + FGCA_PAD;
215
-
216
- return { nodes, edges, columns, width, height };
217
- }
1
+ // Pure column-layout geometry for the static FGCA / FGA previews.
2
+ //
3
+ // This is the layout the Studio extension's `fgca-preview.ts` renders to SVG
4
+ // (NOT the ReactFlow `buildFGCALayout` in `./layout.ts`, which targets the
5
+ // interactive web UI). It lives here — rather than inline in the extension —
6
+ // so the gap geometry is unit-testable: the extension has no test harness.
7
+ //
8
+ // No React, no DOM, no vscode. Safe to call in Node.js or a test environment.
9
+
10
+ import type { Scope } from '../scope.js';
11
+
12
+ export type FGCAPreviewColumn = 'factor' | 'goal' | 'change' | 'activity';
13
+
14
+ export interface FGCAPreviewFactor {
15
+ id: number | string;
16
+ name: string;
17
+ }
18
+ export interface FGCAPreviewGoal {
19
+ id: number | string;
20
+ name: string;
21
+ level?: number;
22
+ factor?: Array<{ id: number | string }>;
23
+ }
24
+ export interface FGCAPreviewChange {
25
+ id: number | string;
26
+ name: string;
27
+ goal_id: number | string;
28
+ activity_ids: Array<number | string>;
29
+ }
30
+ export interface FGCAPreviewActivity {
31
+ id: number | string;
32
+ name: string;
33
+ goal_id?: number | string | null;
34
+ }
35
+
36
+ /** Structural input the preview layout needs — a subset of the parsed FGCA/FGA doc. */
37
+ export interface FGCAPreviewDoc {
38
+ factors: FGCAPreviewFactor[];
39
+ goals: FGCAPreviewGoal[];
40
+ changes?: FGCAPreviewChange[];
41
+ activities: FGCAPreviewActivity[];
42
+ }
43
+
44
+ export interface FGCAPreviewLayoutOptions {
45
+ /** FGA hides the Changes column and links Goal → Activity directly. */
46
+ hideChanges?: boolean;
47
+ /** Horizontal gap (px) between columns. Default matches the historical hardcoded value. */
48
+ colGap?: number;
49
+ /** Vertical gap (px) between stacked nodes within a column. Default matches the historical hardcoded value. */
50
+ rowGap?: number;
51
+ /** Trim to a level cap or a single root goal (vkgeorgia/strategy#77). Defaults to 'all'. */
52
+ scope?: Scope;
53
+ }
54
+
55
+ /**
56
+ * Trims an FGCA/FGA doc to a scope (vkgeorgia/strategy#77).
57
+ *
58
+ * FGCA/FGA goals are flat (no parent_id), so:
59
+ * - 'level' → goals with `(level ?? 0) <= maxLevel`.
60
+ * - 'root' → the single goal whose id matches `rootGoalId` (empty when absent).
61
+ *
62
+ * Factors, changes and activities are then kept only when they touch a visible
63
+ * goal: a factor referenced by a visible goal, a change whose `goal_id` is
64
+ * visible, an activity bound to a visible goal directly or via a visible
65
+ * change. Pure and exported so an access-control layer can reuse it.
66
+ */
67
+ export function selectScopedFGCA(doc: FGCAPreviewDoc, scope: Scope): FGCAPreviewDoc {
68
+ if (scope.mode === 'all') return doc;
69
+
70
+ const visibleGoals =
71
+ scope.mode === 'level'
72
+ ? doc.goals.filter(g => (g.level ?? 0) <= scope.maxLevel)
73
+ : doc.goals.filter(g => String(g.id) === scope.rootGoalId);
74
+
75
+ const visibleGoalIds = new Set(visibleGoals.map(g => g.id));
76
+
77
+ const changes = doc.changes ?? [];
78
+ const visibleChanges = changes.filter(c => visibleGoalIds.has(c.goal_id));
79
+ const activityIdsViaChange = new Set(visibleChanges.flatMap(c => c.activity_ids));
80
+
81
+ const visibleActivities = doc.activities.filter(
82
+ a => (a.goal_id != null && visibleGoalIds.has(a.goal_id)) || activityIdsViaChange.has(a.id),
83
+ );
84
+
85
+ const factorIds = new Set(visibleGoals.flatMap(g => (g.factor ?? []).map(f => f.id)));
86
+ const visibleFactors = doc.factors.filter(f => factorIds.has(f.id));
87
+
88
+ return {
89
+ factors: visibleFactors,
90
+ goals: visibleGoals,
91
+ changes: doc.changes === undefined ? undefined : visibleChanges,
92
+ activities: visibleActivities,
93
+ };
94
+ }
95
+
96
+ export interface FGCAPreviewNode {
97
+ id: string;
98
+ x: number;
99
+ y: number;
100
+ label: string;
101
+ col: FGCAPreviewColumn;
102
+ }
103
+ export interface FGCAPreviewEdge {
104
+ sx: number;
105
+ sy: number;
106
+ tx: number;
107
+ ty: number;
108
+ }
109
+ /** Per-column header anchor — lets the renderer draw column headers without recomputing the stride. */
110
+ export interface FGCAPreviewColumnPos {
111
+ col: FGCAPreviewColumn;
112
+ x: number;
113
+ }
114
+ export interface FGCAPreviewLayout {
115
+ nodes: FGCAPreviewNode[];
116
+ edges: FGCAPreviewEdge[];
117
+ columns: FGCAPreviewColumnPos[];
118
+ width: number;
119
+ height: number;
120
+ }
121
+
122
+ // Fixed node + frame geometry. Only the inter-node gaps are user-configurable
123
+ // (vkgeorgia/strategy#75); node size and padding stay constant.
124
+ export const FGCA_NODE_W = 220;
125
+ export const FGCA_NODE_H = 72;
126
+ export const FGCA_HEADER_H = 32;
127
+ export const FGCA_PAD = 20;
128
+ export const FGCA_DEFAULT_COL_GAP = 160;
129
+ export const FGCA_DEFAULT_ROW_GAP = 20;
130
+
131
+ export function layoutFGCAPreview(
132
+ inputDoc: FGCAPreviewDoc,
133
+ options: FGCAPreviewLayoutOptions = {},
134
+ ): FGCAPreviewLayout {
135
+ const {
136
+ hideChanges = false,
137
+ colGap = FGCA_DEFAULT_COL_GAP,
138
+ rowGap = FGCA_DEFAULT_ROW_GAP,
139
+ scope = { mode: 'all' },
140
+ } = options;
141
+
142
+ // Trim to scope first; everything below lays out the visible subset only.
143
+ const doc = selectScopedFGCA(inputDoc, scope);
144
+
145
+ const colStride = FGCA_NODE_W + colGap;
146
+ const cols: FGCAPreviewColumn[] = hideChanges
147
+ ? ['factor', 'goal', 'activity']
148
+ : ['factor', 'goal', 'change', 'activity'];
149
+ const changes = doc.changes ?? [];
150
+ const colItems: Record<FGCAPreviewColumn, Array<{ id: string; label: string }>> = {
151
+ factor: doc.factors.map(f => ({ id: `factor_${f.id}`, label: f.name })),
152
+ goal: doc.goals.map(g => ({ id: `goal_${g.id}`, label: g.name })),
153
+ change: changes.map(c => ({ id: `change_${c.id}`, label: c.name })),
154
+ activity: doc.activities.map(a => ({ id: `activity_${a.id}`, label: a.name })),
155
+ };
156
+
157
+ const nodeMap = new Map<string, FGCAPreviewNode>();
158
+ const nodes: FGCAPreviewNode[] = [];
159
+ const columns: FGCAPreviewColumnPos[] = [];
160
+
161
+ for (let ci = 0; ci < cols.length; ci++) {
162
+ const col = cols[ci];
163
+ const x = FGCA_PAD + ci * colStride;
164
+ columns.push({ col, x });
165
+ let y = FGCA_PAD + FGCA_HEADER_H + rowGap;
166
+ for (const item of colItems[col]) {
167
+ const node: FGCAPreviewNode = { id: item.id, x, y, label: item.label, col };
168
+ nodes.push(node);
169
+ nodeMap.set(item.id, node);
170
+ y += FGCA_NODE_H + rowGap;
171
+ }
172
+ }
173
+
174
+ const edges: FGCAPreviewEdge[] = [];
175
+ function addEdge(sourceId: string, targetId: string): void {
176
+ const s = nodeMap.get(sourceId);
177
+ const t = nodeMap.get(targetId);
178
+ if (!s || !t) return;
179
+ edges.push({ sx: s.x + FGCA_NODE_W, sy: s.y + FGCA_NODE_H / 2, tx: t.x, ty: t.y + FGCA_NODE_H / 2 });
180
+ }
181
+
182
+ for (const g of doc.goals) {
183
+ for (const f of (g.factor ?? [])) addEdge(`factor_${f.id}`, `goal_${g.id}`);
184
+ }
185
+ if (hideChanges) {
186
+ const connectedViaChange = new Set<number | string>();
187
+ for (const c of changes) {
188
+ for (const aid of c.activity_ids) {
189
+ addEdge(`goal_${c.goal_id}`, `activity_${aid}`);
190
+ connectedViaChange.add(aid);
191
+ }
192
+ }
193
+ for (const a of doc.activities) {
194
+ if (a.goal_id != null && !connectedViaChange.has(a.id)) {
195
+ addEdge(`goal_${a.goal_id}`, `activity_${a.id}`);
196
+ }
197
+ }
198
+ } else {
199
+ for (const c of changes) addEdge(`goal_${c.goal_id}`, `change_${c.id}`);
200
+ for (const c of changes) for (const aid of c.activity_ids) addEdge(`change_${c.id}`, `activity_${aid}`);
201
+ const coveredActivities = new Set(changes.flatMap(c => c.activity_ids));
202
+ for (const a of doc.activities) {
203
+ if (a.goal_id != null && !coveredActivities.has(a.id)) {
204
+ addEdge(`goal_${a.goal_id}`, `activity_${a.id}`);
205
+ }
206
+ }
207
+ }
208
+
209
+ const maxNodeBottom = nodes.reduce(
210
+ (m, n) => Math.max(m, n.y + FGCA_NODE_H),
211
+ FGCA_PAD + FGCA_HEADER_H + rowGap + FGCA_NODE_H,
212
+ );
213
+ const width = FGCA_PAD * 2 + cols.length * colStride - colGap;
214
+ const height = maxNodeBottom + FGCA_PAD;
215
+
216
+ return { nodes, edges, columns, width, height };
217
+ }
@@ -0,0 +1,157 @@
1
+ /**
2
+ * FGCA canon resolver — assembles a flat canonical FGCA document from a
3
+ * view_config projection and a canon element/relation store (VP-3).
4
+ *
5
+ * Output shape matches the flat form that `parseCanonicalFGCA` expects:
6
+ * top-level `factors[]`, `goals[]`, `changes[]`, `activities[]` with typed
7
+ * string IDs. Filesystem-free — callable from unit tests without vscode.
8
+ */
9
+
10
+ export interface FGCAViewConfig {
11
+ goals?: {
12
+ filter?: 'all' | 'ids' | 'tags';
13
+ ids?: string[];
14
+ tags?: string[];
15
+ };
16
+ factors?: { surface?: 'derived' | 'all' };
17
+ changes?: { surface?: 'derived' | 'all' };
18
+ activities?: { surface?: 'derived' | 'all' };
19
+ display?: { depth?: number | null; collapsed?: string[] };
20
+ }
21
+
22
+ export interface FGCACanonSources {
23
+ elements: unknown[];
24
+ relations: unknown[];
25
+ }
26
+
27
+ function isObject(v: unknown): v is Record<string, unknown> {
28
+ return !!v && typeof v === 'object' && !Array.isArray(v);
29
+ }
30
+
31
+ function str(v: unknown): string | undefined {
32
+ return typeof v === 'string' && v.trim().length > 0 ? v : undefined;
33
+ }
34
+
35
+ function strArray(v: unknown): string[] {
36
+ if (!Array.isArray(v)) return [];
37
+ return v.filter((x): x is string => typeof x === 'string' && x.trim().length > 0);
38
+ }
39
+
40
+ function collectByNotation(
41
+ docs: unknown[],
42
+ notation: string,
43
+ ): Map<string, Record<string, unknown>> {
44
+ const out = new Map<string, Record<string, unknown>>();
45
+ for (const doc of docs) {
46
+ if (!isObject(doc)) continue;
47
+ if (str(doc['notation']) !== notation) continue;
48
+ const id = str(doc['id']);
49
+ if (!id) continue;
50
+ if (!out.has(id)) out.set(id, doc);
51
+ }
52
+ return out;
53
+ }
54
+
55
+ /**
56
+ * Returns true when the parsed view document uses the canon-projection form
57
+ * (`view_config` key present, no inline `factors[]` / `goals[]` arrays).
58
+ * Used by the preview to decide whether to run the resolver or fall back to
59
+ * direct `parseCanonicalFGCA` on the inline document.
60
+ */
61
+ export function isFGCAViewDoc(parsed: unknown): boolean {
62
+ if (!isObject(parsed)) return false;
63
+ return 'view_config' in parsed && !('factors' in parsed) && !('goals' in parsed);
64
+ }
65
+
66
+ /**
67
+ * Assemble a flat canonical FGCA document from the canon element store,
68
+ * filtered by the view document's `view_config`. The return value is ready
69
+ * to pass to `parseCanonicalFGCA`.
70
+ *
71
+ * Cross-reference fields (`goal.factors[]`, `change.goals[]`,
72
+ * `activity.changes[]`) are carried from the canon elements unchanged; the
73
+ * resolver decides which elements to include, not how they are shaped.
74
+ */
75
+ export function resolveFGCA(
76
+ viewDoc: unknown,
77
+ sources: FGCACanonSources,
78
+ ): Record<string, unknown> {
79
+ if (!isObject(viewDoc)) {
80
+ return { notation: 'fgca', factors: [], goals: [], changes: [], activities: [] };
81
+ }
82
+
83
+ const vc = isObject(viewDoc['view_config']) ? viewDoc['view_config'] : {};
84
+ const goalsConf = isObject(vc['goals']) ? vc['goals'] : {};
85
+ const factorsConf = isObject(vc['factors']) ? vc['factors'] : {};
86
+ const changesConf = isObject(vc['changes']) ? vc['changes'] : {};
87
+ const activitiesConf = isObject(vc['activities']) ? vc['activities'] : {};
88
+
89
+ const factorElems = collectByNotation(sources.elements, 'factor');
90
+ const goalElems = collectByNotation(sources.elements, 'goal');
91
+ const changeElems = collectByNotation(sources.elements, 'change');
92
+ const activityElems = collectByNotation(sources.elements, 'activity');
93
+
94
+ // 1. Select goal set
95
+ const goalsFilter = str(goalsConf['filter']) ?? 'all';
96
+ let selectedGoals: Array<Record<string, unknown>>;
97
+ if (goalsFilter === 'ids') {
98
+ const ids = strArray(goalsConf['ids']);
99
+ selectedGoals = ids.flatMap((id) => { const g = goalElems.get(id); return g ? [g] : []; });
100
+ } else if (goalsFilter === 'tags') {
101
+ const tags = strArray(goalsConf['tags']);
102
+ selectedGoals = [...goalElems.values()].filter((g) =>
103
+ strArray(g['tags']).some((t) => tags.includes(t)),
104
+ );
105
+ } else {
106
+ // 'all' — include every goal element in the canon store
107
+ selectedGoals = [...goalElems.values()];
108
+ }
109
+ const selectedGoalIds = new Set(
110
+ selectedGoals.map((g) => str(g['id'])).filter((x): x is string => x !== undefined),
111
+ );
112
+
113
+ // 2. Select factors: derived follows goal.factors[]; all = every factor
114
+ let selectedFactors: Array<Record<string, unknown>>;
115
+ if (str(factorsConf['surface']) === 'all') {
116
+ selectedFactors = [...factorElems.values()];
117
+ } else {
118
+ const refIds = new Set<string>();
119
+ for (const g of selectedGoals) for (const fid of strArray(g['factors'])) refIds.add(fid);
120
+ selectedFactors = [...refIds].flatMap((id) => { const f = factorElems.get(id); return f ? [f] : []; });
121
+ }
122
+
123
+ // 3. Select changes: derived = changes referencing ≥1 selected goal
124
+ let selectedChanges: Array<Record<string, unknown>>;
125
+ if (str(changesConf['surface']) === 'all') {
126
+ selectedChanges = [...changeElems.values()];
127
+ } else {
128
+ selectedChanges = [...changeElems.values()].filter((c) =>
129
+ strArray(c['goals']).some((gid) => selectedGoalIds.has(gid)),
130
+ );
131
+ }
132
+ const selectedChangeIds = new Set(
133
+ selectedChanges.map((c) => str(c['id'])).filter((x): x is string => x !== undefined),
134
+ );
135
+
136
+ // 4. Select activities: derived = reference ≥1 selected change or goal (degenerate FGA link)
137
+ let selectedActivities: Array<Record<string, unknown>>;
138
+ if (str(activitiesConf['surface']) === 'all') {
139
+ selectedActivities = [...activityElems.values()];
140
+ } else {
141
+ selectedActivities = [...activityElems.values()].filter((a) =>
142
+ strArray(a['changes']).some((cid) => selectedChangeIds.has(cid)) ||
143
+ strArray(a['goals']).some((gid) => selectedGoalIds.has(gid)),
144
+ );
145
+ }
146
+
147
+ return {
148
+ notation: 'fgca',
149
+ id: viewDoc['id'],
150
+ name: viewDoc['name'],
151
+ spec_version: viewDoc['spec_version'],
152
+ factors: selectedFactors,
153
+ goals: selectedGoals,
154
+ changes: selectedChanges,
155
+ activities: selectedActivities,
156
+ };
157
+ }