@transitrix/diagrams 1.5.0 → 1.6.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 (79) hide show
  1. package/dist/capability-map/CapabilityCardNode.d.ts +19 -0
  2. package/dist/capability-map/CapabilityCardNode.js +66 -0
  3. package/dist/capability-map/CapabilityMapView.d.ts +59 -0
  4. package/dist/capability-map/CapabilityMapView.js +204 -0
  5. package/dist/capability-map/CapabilityRootNode.d.ts +12 -0
  6. package/dist/capability-map/CapabilityRootNode.js +23 -0
  7. package/dist/capability-map/__tests__/CapabilityMapView.test.d.ts +1 -0
  8. package/dist/capability-map/__tests__/CapabilityMapView.test.js +217 -0
  9. package/dist/capability-map/__tests__/address.test.d.ts +1 -0
  10. package/dist/capability-map/__tests__/address.test.js +49 -0
  11. package/dist/capability-map/__tests__/dsm-layout.test.d.ts +1 -0
  12. package/dist/capability-map/__tests__/dsm-layout.test.js +46 -0
  13. package/dist/capability-map/__tests__/dsm-mutations.test.d.ts +1 -0
  14. package/dist/capability-map/__tests__/dsm-mutations.test.js +125 -0
  15. package/dist/capability-map/__tests__/dsm-validate.test.d.ts +1 -0
  16. package/dist/capability-map/__tests__/dsm-validate.test.js +56 -0
  17. package/dist/capability-map/address.d.ts +12 -0
  18. package/dist/capability-map/address.js +48 -0
  19. package/dist/capability-map/dsm-layout.d.ts +9 -0
  20. package/dist/capability-map/dsm-layout.js +125 -0
  21. package/dist/capability-map/dsm-mutations.d.ts +28 -0
  22. package/dist/capability-map/dsm-mutations.js +196 -0
  23. package/dist/capability-map/dsm-schema.d.ts +71 -0
  24. package/dist/capability-map/dsm-schema.js +14 -0
  25. package/dist/capability-map/dsm-theme.d.ts +20 -0
  26. package/dist/capability-map/dsm-theme.js +36 -0
  27. package/dist/capability-map/dsm-validate.d.ts +2 -0
  28. package/dist/capability-map/dsm-validate.js +93 -0
  29. package/dist/capability-map/index.d.ts +9 -0
  30. package/dist/capability-map/index.js +6 -0
  31. package/dist/compliance/__tests__/trace.test.d.ts +1 -0
  32. package/dist/compliance/__tests__/trace.test.js +144 -0
  33. package/dist/compliance/classify.js +7 -1
  34. package/dist/compliance/index.d.ts +2 -1
  35. package/dist/compliance/index.js +1 -0
  36. package/dist/compliance/reverse-index.js +4 -1
  37. package/dist/compliance/trace.d.ts +26 -0
  38. package/dist/compliance/trace.js +89 -0
  39. package/dist/compliance/types.d.ts +94 -1
  40. package/dist/goals/GoalNode.d.ts +18 -0
  41. package/dist/goals/GoalNode.js +91 -0
  42. package/dist/goals/GoalTreeView.d.ts +57 -0
  43. package/dist/goals/GoalTreeView.js +228 -0
  44. package/dist/goals/__tests__/GoalTreeView.test.d.ts +1 -0
  45. package/dist/goals/__tests__/GoalTreeView.test.js +296 -0
  46. package/dist/goals/index.d.ts +3 -0
  47. package/dist/goals/index.js +1 -0
  48. package/dist/goals/theme.d.ts +22 -0
  49. package/dist/goals/theme.js +32 -0
  50. package/dist/index.d.ts +2 -1
  51. package/dist/index.js +1 -1
  52. package/package.json +4 -1
  53. package/src/capability-map/CapabilityCardNode.tsx +146 -0
  54. package/src/capability-map/CapabilityMapView.tsx +331 -0
  55. package/src/capability-map/CapabilityRootNode.tsx +38 -0
  56. package/src/capability-map/__tests__/CapabilityMapView.test.tsx +232 -0
  57. package/src/capability-map/__tests__/address.test.ts +59 -0
  58. package/src/capability-map/__tests__/dsm-layout.test.ts +52 -0
  59. package/src/capability-map/__tests__/dsm-mutations.test.ts +141 -0
  60. package/src/capability-map/__tests__/dsm-validate.test.ts +65 -0
  61. package/src/capability-map/address.ts +48 -0
  62. package/src/capability-map/dsm-layout.ts +142 -0
  63. package/src/capability-map/dsm-mutations.ts +208 -0
  64. package/src/capability-map/dsm-schema.ts +80 -0
  65. package/src/capability-map/dsm-theme.ts +53 -0
  66. package/src/capability-map/dsm-validate.ts +103 -0
  67. package/src/capability-map/index.ts +35 -0
  68. package/src/compliance/__tests__/trace.test.ts +157 -0
  69. package/src/compliance/classify.ts +7 -1
  70. package/src/compliance/index.ts +6 -0
  71. package/src/compliance/reverse-index.ts +3 -1
  72. package/src/compliance/trace.ts +118 -0
  73. package/src/compliance/types.ts +101 -1
  74. package/src/goals/GoalNode.tsx +212 -0
  75. package/src/goals/GoalTreeView.tsx +350 -0
  76. package/src/goals/__tests__/GoalTreeView.test.tsx +313 -0
  77. package/src/goals/index.ts +4 -0
  78. package/src/goals/theme.ts +54 -0
  79. package/src/index.ts +29 -1
@@ -0,0 +1,296 @@
1
+ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
2
+ if (kind === "m") throw new TypeError("Private method is not writable");
3
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
4
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
5
+ return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
6
+ };
7
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
8
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
9
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
10
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
11
+ };
12
+ var _MockResizeObserver_callback;
13
+ import { jsx as _jsx } from "react/jsx-runtime";
14
+ // @vitest-environment jsdom
15
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
16
+ import { render, screen, cleanup, waitFor } from '@testing-library/react';
17
+ import { GoalTreeView, computeDragOutcome } from '../GoalTreeView.js';
18
+ // jsdom has no ResizeObserver / layout engine. reactflow keeps a node's DOM
19
+ // wrapper `visibility: hidden` and excludes it from drag/intersection logic
20
+ // until it has been "measured" via ResizeObserver — so the mock must
21
+ // actually invoke its callback (with the mocked getBoundingClientRect below)
22
+ // for nodes to become interactive, not just satisfy the constructor call.
23
+ class MockResizeObserver {
24
+ constructor(callback) {
25
+ _MockResizeObserver_callback.set(this, void 0);
26
+ __classPrivateFieldSet(this, _MockResizeObserver_callback, callback, "f");
27
+ }
28
+ observe(target) {
29
+ queueMicrotask(() => {
30
+ const rect = target.getBoundingClientRect();
31
+ __classPrivateFieldGet(this, _MockResizeObserver_callback, "f").call(this, [{ target, contentRect: rect }], this);
32
+ });
33
+ }
34
+ unobserve() { }
35
+ disconnect() { }
36
+ }
37
+ _MockResizeObserver_callback = new WeakMap();
38
+ // jsdom also has no DOMMatrixReadOnly, which reactflow's dimension-tracking
39
+ // uses to read the translateX/Y out of a node's computed transform. Only
40
+ // translate() (no scale/rotate) ever appears in this component's own CSS, so
41
+ // a minimal shim covering that one case is enough.
42
+ class MockDOMMatrixReadOnly {
43
+ constructor(transform) {
44
+ this.m41 = 0;
45
+ this.m42 = 0;
46
+ if (!transform || transform === 'none')
47
+ return;
48
+ const t = /translate\((-?[\d.]+)px,\s*(-?[\d.]+)px\)/.exec(transform);
49
+ if (t) {
50
+ this.m41 = Number(t[1]);
51
+ this.m42 = Number(t[2]);
52
+ return;
53
+ }
54
+ const m = /matrix\(([^)]+)\)/.exec(transform);
55
+ if (m) {
56
+ const parts = m[1].split(',').map((p) => Number(p.trim()));
57
+ this.m41 = parts[4] ?? 0;
58
+ this.m42 = parts[5] ?? 0;
59
+ }
60
+ }
61
+ }
62
+ function makeTree() {
63
+ return {
64
+ goal_types: [
65
+ { name: 'Strategy', level: 0 },
66
+ { name: 'Business Goal', level: 1 },
67
+ ],
68
+ goals: [
69
+ { id: 1, name: 'Triple revenue', type: 'Strategy', level: 0, parent_id: 0 },
70
+ { id: 2, name: 'Launch in EU', type: 'Business Goal', level: 1, parent_id: 1 },
71
+ {
72
+ id: 3,
73
+ name: 'Cut churn',
74
+ type: 'Business Goal',
75
+ level: 1,
76
+ parent_id: 1,
77
+ factors: [
78
+ { id: 10, name: 'Support backlog', impact_type: 'risk' },
79
+ { id: 11, name: 'New pricing', impact_type: 'opportunity' },
80
+ ],
81
+ },
82
+ ],
83
+ };
84
+ }
85
+ beforeEach(() => {
86
+ global.ResizeObserver = MockResizeObserver;
87
+ window.DOMMatrixReadOnly = MockDOMMatrixReadOnly;
88
+ vi.spyOn(Element.prototype, 'getBoundingClientRect').mockImplementation(function () {
89
+ // Individual goal cards report their real 250x80 footprint (matters for
90
+ // reactflow's own drag/measurement bookkeeping); the flow container and
91
+ // everything else gets a generously large rect so viewport fitting has
92
+ // room to work with.
93
+ const isNode = this.classList?.contains('react-flow__node');
94
+ const width = isNode ? 250 : 1000;
95
+ const height = isNode ? 80 : 800;
96
+ return {
97
+ width, height, top: 0, left: 0, right: width, bottom: height, x: 0, y: 0,
98
+ toJSON() { return this; },
99
+ };
100
+ });
101
+ });
102
+ afterEach(() => {
103
+ cleanup();
104
+ vi.restoreAllMocks();
105
+ });
106
+ describe('GoalTreeView', () => {
107
+ it('renders without crashing and shows every canvas goal', async () => {
108
+ render(_jsx(GoalTreeView, { tree: makeTree() }));
109
+ await waitFor(() => {
110
+ expect(screen.getByText('Triple revenue')).toBeTruthy();
111
+ expect(screen.getByText('Launch in EU')).toBeTruthy();
112
+ expect(screen.getByText('Cut churn')).toBeTruthy();
113
+ });
114
+ });
115
+ it('renders factor indicators from goal.factors', async () => {
116
+ render(_jsx(GoalTreeView, { tree: makeTree() }));
117
+ await waitFor(() => {
118
+ expect(screen.getByText('Triple revenue')).toBeTruthy();
119
+ });
120
+ // One up-caret (opportunity) and one down-caret (risk) on "Cut churn".
121
+ expect(screen.getByLabelText('1 positive factor')).toBeTruthy();
122
+ expect(screen.getByLabelText('1 negative factor')).toBeTruthy();
123
+ });
124
+ it('puts a goal with a broken parent_id in the backlog, not on canvas', async () => {
125
+ const tree = {
126
+ goal_types: [
127
+ { name: 'Strategy', level: 0 },
128
+ { name: 'Business Goal', level: 1 },
129
+ ],
130
+ goals: [
131
+ { id: 1, name: 'Root goal', type: 'Strategy', level: 0, parent_id: 0 },
132
+ // level 1 + a parent_id that resolves to nothing — not a root by
133
+ // either "Roots: level === 0 || parent_id === 0" clause, and
134
+ // unreachable from goal 1 — must land in the backlog.
135
+ { id: 2, name: 'Orphaned goal', type: 'Business Goal', level: 1, parent_id: 999 },
136
+ ],
137
+ };
138
+ render(_jsx(GoalTreeView, { tree: tree, showBacklog: true }));
139
+ await waitFor(() => {
140
+ expect(screen.getByText('Root goal')).toBeTruthy();
141
+ });
142
+ expect(screen.getByText('Orphaned goal')).toBeTruthy();
143
+ expect(screen.queryByText('Backlog')).toBeTruthy();
144
+ });
145
+ it('does not render add/delete affordances when readOnly', async () => {
146
+ render(_jsx(GoalTreeView, { tree: makeTree(), readOnly: true }));
147
+ await waitFor(() => {
148
+ expect(screen.getByText('Triple revenue')).toBeTruthy();
149
+ });
150
+ expect(screen.queryByLabelText('Add child goal')).toBeNull();
151
+ expect(screen.queryByLabelText('Delete goal')).toBeNull();
152
+ });
153
+ it('fires onChange with kind "addChild" when the add-child button is clicked', async () => {
154
+ const onChange = vi.fn();
155
+ render(_jsx(GoalTreeView, { tree: makeTree(), onChange: onChange }));
156
+ await waitFor(() => {
157
+ expect(screen.getByText('Triple revenue')).toBeTruthy();
158
+ });
159
+ // Target the root (id 1, level 0) specifically — makeTree()'s goal_types
160
+ // only go up to level 1, so clicking "add child" on an existing level-1
161
+ // goal would be correctly refused (would exceed max level) and never
162
+ // fire onChange at all.
163
+ const rootNode = document.querySelector('.react-flow__node[data-id="1"]');
164
+ const addButton = rootNode.querySelector('[aria-label="Add child goal"]');
165
+ addButton.dispatchEvent(new MouseEvent('click', { bubbles: true }));
166
+ await waitFor(() => expect(onChange).toHaveBeenCalledTimes(1));
167
+ const event = onChange.mock.calls[0][0];
168
+ expect(event.kind).toBe('addChild');
169
+ if (event.kind === 'addChild') {
170
+ expect(event.result.goals.length).toBe(4);
171
+ }
172
+ });
173
+ it('fires onChange with kind "delete" when the delete button is clicked', async () => {
174
+ const onChange = vi.fn();
175
+ render(_jsx(GoalTreeView, { tree: makeTree(), onChange: onChange }));
176
+ await waitFor(() => {
177
+ expect(screen.getByText('Cut churn')).toBeTruthy();
178
+ });
179
+ const deleteButtons = screen.getAllByLabelText('Delete goal');
180
+ deleteButtons[deleteButtons.length - 1].dispatchEvent(new MouseEvent('click', { bubbles: true }));
181
+ await waitFor(() => expect(onChange).toHaveBeenCalledTimes(1));
182
+ const event = onChange.mock.calls[0][0];
183
+ expect(event.kind).toBe('delete');
184
+ });
185
+ it('fires onChange with kind "restoreFromBacklog" when a backlog card is dropped onto a canvas card', async () => {
186
+ const tree = {
187
+ goal_types: [
188
+ { name: 'Strategy', level: 0 },
189
+ { name: 'Business Goal', level: 1 },
190
+ ],
191
+ goals: [
192
+ { id: 1, name: 'Root goal', type: 'Strategy', level: 0, parent_id: 0 },
193
+ { id: 2, name: 'Orphaned goal', type: 'Business Goal', level: 1, parent_id: 999 },
194
+ ],
195
+ };
196
+ const onChange = vi.fn();
197
+ render(_jsx(GoalTreeView, { tree: tree, onChange: onChange, showBacklog: true }));
198
+ await waitFor(() => {
199
+ expect(screen.getByText('Orphaned goal')).toBeTruthy();
200
+ });
201
+ // jsdom has no native DataTransfer; stub the minimal setData/getData
202
+ // surface this component's native (non-reactflow) HTML5 drag path uses
203
+ // and attach it directly to the dispatched events.
204
+ const store = new Map();
205
+ const dataTransfer = {
206
+ setData: (k, v) => store.set(k, v),
207
+ getData: (k) => store.get(k) ?? '',
208
+ effectAllowed: 'move',
209
+ };
210
+ function fireDnd(el, type, coords) {
211
+ const event = new Event(type, { bubbles: true, cancelable: true });
212
+ Object.defineProperty(event, 'dataTransfer', { value: dataTransfer });
213
+ Object.assign(event, coords);
214
+ el.dispatchEvent(event);
215
+ }
216
+ const backlogItem = screen.getByText('Orphaned goal').closest('div[draggable]');
217
+ const rootNode = document.querySelector('.react-flow__node[data-id="1"]');
218
+ // jsdom doesn't implement elementFromPoint at all (not just "returns null").
219
+ document.elementFromPoint = vi.fn().mockReturnValue(rootNode);
220
+ fireDnd(backlogItem, 'dragstart', { clientX: 0, clientY: 0 });
221
+ fireDnd(rootNode, 'drop', { clientX: 10, clientY: 10 });
222
+ await waitFor(() => expect(onChange).toHaveBeenCalledTimes(1));
223
+ const event = onChange.mock.calls[0][0];
224
+ expect(event.kind).toBe('restoreFromBacklog');
225
+ if (event.kind === 'restoreFromBacklog') {
226
+ expect(event.id).toBe(2);
227
+ expect(event.newParentId).toBe(1);
228
+ expect(event.result.goals.find((g) => g.id === 2)?.parent_id).toBe(1);
229
+ }
230
+ });
231
+ // Dragging a card is choreographed by reactflow's own pointer/DOM-measurement
232
+ // machinery (ResizeObserver-gated node "readiness", d3-drag pointer capture,
233
+ // viewport transform math) — faithfully simulating that in jsdom means
234
+ // re-implementing reactflow's internals rather than testing this component.
235
+ // computeDragOutcome() is the pure decision GoalTreeView's onNodeDragStop
236
+ // calls once reactflow reports a drag: given where a card was dropped, which
237
+ // mutation fires and what onChange payload it produces. Testing it directly
238
+ // covers the actual reparent/moveToBacklog logic without that DOM coupling.
239
+ describe('computeDragOutcome (reparent / moveToBacklog decision logic)', () => {
240
+ const tree = {
241
+ goal_types: [
242
+ { name: 'Strategy', level: 0 },
243
+ { name: 'Business Goal', level: 1 },
244
+ ],
245
+ goals: [
246
+ { id: 1, name: 'Goal A', type: 'Strategy', level: 0, parent_id: 0 },
247
+ { id: 2, name: 'Goal C', type: 'Strategy', level: 0, parent_id: 0 },
248
+ { id: 3, name: 'Goal B', type: 'Business Goal', level: 1, parent_id: 1 },
249
+ ],
250
+ };
251
+ it('fires a "reparent" change when dropped onto another card', () => {
252
+ const change = computeDragOutcome(tree, 3, { kind: 'node', id: 2 });
253
+ expect(change?.kind).toBe('reparent');
254
+ if (change?.kind === 'reparent') {
255
+ expect(change.sourceId).toBe(3);
256
+ expect(change.targetId).toBe(2);
257
+ expect(change.result.goals.find((g) => g.id === 3)?.parent_id).toBe(2);
258
+ }
259
+ });
260
+ it('fires a "moveToBacklog" change when dropped on the backlog zone', () => {
261
+ const change = computeDragOutcome(tree, 3, { kind: 'backlog' });
262
+ expect(change?.kind).toBe('moveToBacklog');
263
+ if (change?.kind === 'moveToBacklog') {
264
+ expect(change.id).toBe(3);
265
+ expect(change.result.goals.find((g) => g.id === 3)?.parent_id).toBe(0);
266
+ }
267
+ });
268
+ it('is a no-op when dropped nowhere in particular', () => {
269
+ expect(computeDragOutcome(tree, 3, null)).toBeNull();
270
+ });
271
+ it('is a no-op when dropped on itself', () => {
272
+ expect(computeDragOutcome(tree, 3, { kind: 'node', id: 3 })).toBeNull();
273
+ });
274
+ it('is a no-op when the reparent would exceed the schema max level', () => {
275
+ // Goal 3 is already level 1 (max); reparenting it under itself-sibling
276
+ // level-1 goal would push it to level 2.
277
+ const deeper = {
278
+ ...tree,
279
+ goals: [...tree.goals, { id: 4, name: 'Goal D', type: 'Business Goal', level: 1, parent_id: 1 }],
280
+ };
281
+ expect(computeDragOutcome(deeper, 3, { kind: 'node', id: 4 })).toBeNull();
282
+ });
283
+ });
284
+ it('fires onEditRequest on double-click', async () => {
285
+ const onEditRequest = vi.fn();
286
+ render(_jsx(GoalTreeView, { tree: makeTree(), onEditRequest: onEditRequest }));
287
+ await waitFor(() => {
288
+ expect(screen.getByText('Triple revenue')).toBeTruthy();
289
+ });
290
+ const nodeEl = document.querySelector('.react-flow__node[data-id="1"]');
291
+ expect(nodeEl).toBeTruthy();
292
+ nodeEl.dispatchEvent(new MouseEvent('dblclick', { bubbles: true }));
293
+ await waitFor(() => expect(onEditRequest).toHaveBeenCalledTimes(1));
294
+ expect(onEditRequest.mock.calls[0][0]).toMatchObject({ id: 1, name: 'Triple revenue' });
295
+ });
296
+ });
@@ -4,3 +4,6 @@ export { parseCanonicalGoals } from './parse-canonical.js';
4
4
  export type { CanonicalGoalsResult } from './parse-canonical.js';
5
5
  export { layoutGoalTree, selectScopedGoals } from './layout.js';
6
6
  export { reparent, addChild, deleteWithDescendants, moveToBacklog, restoreFromBacklog } from './mutations.js';
7
+ export { GoalTreeView } from './GoalTreeView.js';
8
+ export type { GoalTreeViewProps, GoalTreeChange } from './GoalTreeView.js';
9
+ export type { ThemeTokens } from './theme.js';
@@ -2,3 +2,4 @@ export { validateGoalTree } from './validate.js';
2
2
  export { parseCanonicalGoals } from './parse-canonical.js';
3
3
  export { layoutGoalTree, selectScopedGoals } from './layout.js';
4
4
  export { reparent, addChild, deleteWithDescendants, moveToBacklog, restoreFromBacklog } from './mutations.js';
5
+ export { GoalTreeView } from './GoalTreeView.js';
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Theme tokens for GoalTreeView — replaces DSM's Redux selectors
3
+ * (selectDiagramParams, selectGoalLevelColors) with a plain prop. Hosts
4
+ * that already carry Transitrix's --ts-* CSS custom properties (Studio)
5
+ * can pass those through; hosts with their own theme store (DSM) map
6
+ * their own values onto this shape.
7
+ */
8
+ export interface ThemeTokens {
9
+ /** Card fill colour per goal level (0..7). Falls back to DEFAULT_GOAL_LEVEL_COLORS for missing levels. */
10
+ goalLevelColors?: Record<number, string>;
11
+ cardBorderColor?: string;
12
+ cardBorderWidth?: number;
13
+ cardTextColor?: string;
14
+ cardMetaColor?: string;
15
+ edgeColor?: string;
16
+ edgeWidth?: number;
17
+ /** Border colour a card takes on while it's a highlighted drop target during drag. */
18
+ dropTargetBorderColor?: string;
19
+ }
20
+ export declare const DEFAULT_GOAL_LEVEL_COLORS: Record<number, string>;
21
+ export declare const DEFAULT_THEME: Required<ThemeTokens>;
22
+ export declare function resolveTheme(theme?: ThemeTokens): Required<ThemeTokens>;
@@ -0,0 +1,32 @@
1
+ export const DEFAULT_GOAL_LEVEL_COLORS = {
2
+ 0: '#e0e7ff',
3
+ 1: '#c7d2fe',
4
+ 2: '#a5b4fc',
5
+ 3: '#93c5fd',
6
+ 4: '#bae6fd',
7
+ 5: '#bbf7d0',
8
+ 6: '#fef08a',
9
+ 7: '#fed7aa',
10
+ };
11
+ export const DEFAULT_THEME = {
12
+ goalLevelColors: DEFAULT_GOAL_LEVEL_COLORS,
13
+ cardBorderColor: '#94a3b8',
14
+ cardBorderWidth: 1,
15
+ cardTextColor: '#0f172a',
16
+ cardMetaColor: '#64748b',
17
+ edgeColor: '#94a3b8',
18
+ edgeWidth: 1.5,
19
+ dropTargetBorderColor: '#2563eb',
20
+ };
21
+ export function resolveTheme(theme) {
22
+ return {
23
+ goalLevelColors: theme?.goalLevelColors ?? DEFAULT_THEME.goalLevelColors,
24
+ cardBorderColor: theme?.cardBorderColor ?? DEFAULT_THEME.cardBorderColor,
25
+ cardBorderWidth: theme?.cardBorderWidth ?? DEFAULT_THEME.cardBorderWidth,
26
+ cardTextColor: theme?.cardTextColor ?? DEFAULT_THEME.cardTextColor,
27
+ cardMetaColor: theme?.cardMetaColor ?? DEFAULT_THEME.cardMetaColor,
28
+ edgeColor: theme?.edgeColor ?? DEFAULT_THEME.edgeColor,
29
+ edgeWidth: theme?.edgeWidth ?? DEFAULT_THEME.edgeWidth,
30
+ dropTargetBorderColor: theme?.dropTargetBorderColor ?? DEFAULT_THEME.dropTargetBorderColor,
31
+ };
32
+ }
package/dist/index.d.ts CHANGED
@@ -6,7 +6,8 @@ export * from "./geometry";
6
6
  export * from "./applications/index";
7
7
  export * from "./assertion/index";
8
8
  export * from "./blocks/index";
9
- export * from "./capability-map/index";
9
+ export type { CapabilityType, CapabilityNode, CapabilityMapHeader, CapabilityMapFile, CapabilityTreeNode, CapabilityTreeEdge, CapabilityTreeLevelCounts, CapabilityTreeLayout, RenderCapabilityTreeOptions, } from "./capability-map/index";
10
+ export { validateCapabilityMap, layoutCapabilityTree, TREE_NODE_WIDTH, TREE_NODE_HEIGHT, TREE_RANK_SEP, TREE_NODE_SEP, renderCapabilityTreeSvg, } from "./capability-map/index";
10
11
  export * from "./change/index";
11
12
  export * from "./compliance/index";
12
13
  export * from "./compliance-matrix/index";
package/dist/index.js CHANGED
@@ -6,7 +6,7 @@ export * from "./geometry";
6
6
  export * from "./applications/index";
7
7
  export * from "./assertion/index";
8
8
  export * from "./blocks/index";
9
- export * from "./capability-map/index";
9
+ export { validateCapabilityMap, layoutCapabilityTree, TREE_NODE_WIDTH, TREE_NODE_HEIGHT, TREE_RANK_SEP, TREE_NODE_SEP, renderCapabilityTreeSvg, } from "./capability-map/index";
10
10
  export * from "./change/index";
11
11
  export * from "./compliance/index";
12
12
  export * from "./compliance-matrix/index";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@transitrix/diagrams",
3
- "version": "1.5.0",
3
+ "version": "1.6.0",
4
4
  "type": "module",
5
5
  "description": "Shared rendering, validation, and pure mutations for Transitrix custom diagram formats.",
6
6
  "license": "MIT",
@@ -43,8 +43,11 @@
43
43
  "reactflow": "^11.0.0"
44
44
  },
45
45
  "devDependencies": {
46
+ "@testing-library/dom": "^10.4.1",
47
+ "@testing-library/react": "^16.3.2",
46
48
  "@types/react": "^18.3.28",
47
49
  "@types/react-dom": "^19.2.3",
50
+ "jsdom": "^29.1.1",
48
51
  "react": "^19.2.6",
49
52
  "react-dom": "^19.2.6",
50
53
  "reactflow": "^11.11.4",
@@ -0,0 +1,146 @@
1
+ import React, { memo } from 'react';
2
+ import { Handle, Position } from 'reactflow';
3
+ import type { Capability } from './dsm-schema.js';
4
+ import type { ThemeTokens } from './dsm-theme.js';
5
+
6
+ const CARD_WIDTH = 250;
7
+ const CARD_HEIGHT = 64;
8
+
9
+ function latestMaturityLevel(cap: Capability): number | undefined {
10
+ if (!cap.maturity || cap.maturity.length === 0) return undefined;
11
+ return [...cap.maturity].sort((a, b) => b.date.localeCompare(a.date))[0].level;
12
+ }
13
+
14
+ export interface CapabilityCardNodeData {
15
+ capability: Capability;
16
+ theme: Required<ThemeTokens>;
17
+ maturityColours: Record<number, string>;
18
+ readOnly: boolean;
19
+ isDropTarget: boolean;
20
+ hasHiddenChildren: boolean;
21
+ isCollapsed: boolean;
22
+ onAddChild: (parentId: number) => void;
23
+ onDelete: (id: number) => void;
24
+ onToggleCollapse: (id: number) => void;
25
+ }
26
+
27
+ const CapabilityCardNode = memo(({ data }: { data: CapabilityCardNodeData }) => {
28
+ const { capability, theme, maturityColours, readOnly, isDropTarget, hasHiddenChildren, isCollapsed } = data;
29
+ const maturity = latestMaturityLevel(capability);
30
+ const dotColour = maturity !== undefined ? maturityColours[maturity] : undefined;
31
+
32
+ return (
33
+ <div
34
+ style={{
35
+ position: 'relative',
36
+ width: CARD_WIDTH,
37
+ height: CARD_HEIGHT,
38
+ background: theme.cardFill,
39
+ borderRadius: 8,
40
+ borderStyle: 'solid',
41
+ borderWidth: isDropTarget ? 2 : theme.cardBorderWidth,
42
+ borderColor: isDropTarget ? theme.dropTargetBorderColor : theme.cardBorderColor,
43
+ boxShadow: '0 1px 4px rgba(0,0,0,0.12)',
44
+ padding: '6px 10px',
45
+ display: 'flex',
46
+ flexDirection: 'column',
47
+ justifyContent: 'center',
48
+ }}
49
+ >
50
+ <Handle type="target" position={Position.Left} style={{ opacity: 0 }} />
51
+ <Handle type="source" position={Position.Right} style={{ opacity: 0 }} />
52
+
53
+ {dotColour && (
54
+ <span
55
+ title={`Maturity ${maturity}`}
56
+ aria-label={`Maturity ${maturity}`}
57
+ style={{
58
+ position: 'absolute', top: 6, left: 6, width: 8, height: 8, borderRadius: '50%', background: dotColour,
59
+ }}
60
+ />
61
+ )}
62
+
63
+ <div
64
+ title={capability.name}
65
+ style={{
66
+ fontWeight: 600,
67
+ fontSize: 12,
68
+ color: theme.cardTextColor,
69
+ marginLeft: dotColour ? 12 : 0,
70
+ overflow: 'hidden',
71
+ display: '-webkit-box',
72
+ WebkitLineClamp: 2,
73
+ WebkitBoxOrient: 'vertical',
74
+ wordBreak: 'break-word',
75
+ lineHeight: 1.2,
76
+ }}
77
+ >
78
+ {capability.name}
79
+ </div>
80
+ <div style={{ fontSize: 10, color: theme.cardMetaColor, marginTop: 2, marginLeft: dotColour ? 12 : 0 }}>
81
+ {capability.address}
82
+ </div>
83
+
84
+ {!readOnly && (
85
+ <button
86
+ type="button"
87
+ aria-label="Add child capability"
88
+ title="Add child capability"
89
+ onClick={(e) => {
90
+ e.stopPropagation();
91
+ data.onAddChild(capability.id);
92
+ }}
93
+ style={{
94
+ position: 'absolute', top: -8, right: -8, width: 16, height: 16,
95
+ borderRadius: '50%', border: '1px solid #86efac', background: '#ffffff',
96
+ color: '#16a34a', fontSize: 11, lineHeight: '14px', padding: 0, cursor: 'pointer',
97
+ }}
98
+ >
99
+ +
100
+ </button>
101
+ )}
102
+
103
+ {!readOnly && (
104
+ <button
105
+ type="button"
106
+ aria-label="Delete capability"
107
+ title="Delete capability and descendants"
108
+ onClick={(e) => {
109
+ e.stopPropagation();
110
+ data.onDelete(capability.id);
111
+ }}
112
+ style={{
113
+ position: 'absolute', bottom: -8, right: -8, width: 16, height: 16,
114
+ borderRadius: '50%', border: '1px solid #fca5a5', background: '#ffffff',
115
+ color: '#dc2626', fontSize: 11, lineHeight: '14px', padding: 0, cursor: 'pointer',
116
+ }}
117
+ >
118
+ &times;
119
+ </button>
120
+ )}
121
+
122
+ {hasHiddenChildren && (
123
+ <button
124
+ type="button"
125
+ aria-label={isCollapsed ? 'Expand branch' : 'Collapse branch'}
126
+ title={isCollapsed ? 'Expand branch' : 'Collapse branch'}
127
+ onClick={(e) => {
128
+ e.stopPropagation();
129
+ data.onToggleCollapse(capability.id);
130
+ }}
131
+ style={{
132
+ position: 'absolute', top: '50%', right: -8, transform: 'translateY(-50%)',
133
+ width: 16, height: 16, borderRadius: '50%', border: `1px solid ${theme.cardBorderColor}`,
134
+ background: '#ffffff', color: theme.cardBorderColor, fontSize: 11, lineHeight: '14px', padding: 0, cursor: 'pointer',
135
+ }}
136
+ >
137
+ {isCollapsed ? '+' : '−'}
138
+ </button>
139
+ )}
140
+ </div>
141
+ );
142
+ });
143
+
144
+ CapabilityCardNode.displayName = 'CapabilityCardNode';
145
+
146
+ export default CapabilityCardNode;