@principal-ai/subsystems-react 0.17.0 → 0.19.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 (108) hide show
  1. package/README.md +11 -85
  2. package/dist/index.d.ts +7 -44
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +6 -32
  5. package/dist/index.js.map +1 -1
  6. package/dist/subsystem/SubsystemCarousel.d.ts +36 -0
  7. package/dist/subsystem/SubsystemCarousel.d.ts.map +1 -0
  8. package/dist/subsystem/SubsystemCarousel.js +163 -0
  9. package/dist/subsystem/SubsystemCarousel.js.map +1 -0
  10. package/dist/subsystem/SubsystemComponentGraph.d.ts +25 -0
  11. package/dist/subsystem/SubsystemComponentGraph.d.ts.map +1 -1
  12. package/dist/subsystem/SubsystemComponentGraph.js +329 -68
  13. package/dist/subsystem/SubsystemComponentGraph.js.map +1 -1
  14. package/package.json +4 -4
  15. package/src/index.ts +9 -199
  16. package/src/subsystem/SubsystemComponentGraph.tsx +396 -50
  17. package/src/components/ConfigurationSelector.tsx +0 -133
  18. package/src/components/GraphRenderer.tsx +0 -3195
  19. package/src/components/MultiCanvasRenderer.tsx +0 -295
  20. package/src/components/NodeTooltip.tsx +0 -279
  21. package/src/components/PendingChanges.test.tsx +0 -375
  22. package/src/components/SelectionSidebar.tsx +0 -352
  23. package/src/components/SequenceDiagramRenderer.tsx +0 -1156
  24. package/src/components/WorkflowSequenceDiagram.tsx +0 -270
  25. package/src/components/dashboard/DashboardRenderer.tsx +0 -317
  26. package/src/components/dashboard/MetricPanel.tsx +0 -254
  27. package/src/components/dashboard/MockDataProvider.ts +0 -330
  28. package/src/components/dashboard/components/BarChart.tsx +0 -299
  29. package/src/components/dashboard/components/LineChart.tsx +0 -279
  30. package/src/components/dashboard/components/MetricCard.tsx +0 -270
  31. package/src/components/dashboard/components/SourceLink.tsx +0 -63
  32. package/src/components/dashboard/components/TimeRangeSelector.tsx +0 -280
  33. package/src/components/dashboard/components/index.ts +0 -5
  34. package/src/components/dashboard/index.ts +0 -47
  35. package/src/components/dashboard/types.ts +0 -126
  36. package/src/components/state-view/PipelineView.tsx +0 -347
  37. package/src/components/state-view/index.ts +0 -14
  38. package/src/components/state-view/types.ts +0 -261
  39. package/src/components/state-view/useStateView.ts +0 -205
  40. package/src/contexts/GraphEditContext.tsx +0 -27
  41. package/src/contexts/TooltipPortalContext.ts +0 -8
  42. package/src/edges/CustomEdge.tsx +0 -402
  43. package/src/edges/GenericEdge.tsx +0 -36
  44. package/src/hooks/usePathBasedEvents.ts +0 -192
  45. package/src/hooks/useSequenceLayout.ts +0 -543
  46. package/src/hooks/useUndoRedo.ts +0 -144
  47. package/src/nodes/CustomNode.tsx +0 -1231
  48. package/src/nodes/GenericNode.tsx +0 -55
  49. package/src/nodes/otel/OtelBoundaryNode.tsx +0 -224
  50. package/src/nodes/otel/OtelEventNode.tsx +0 -225
  51. package/src/nodes/otel/OtelResourceNode.tsx +0 -251
  52. package/src/nodes/otel/OtelScopeNode.tsx +0 -221
  53. package/src/nodes/otel/OtelSpanConventionNode.tsx +0 -295
  54. package/src/nodes/otel/index.ts +0 -23
  55. package/src/nodes/otel/shared/NodeBadges.tsx +0 -295
  56. package/src/nodes/otel/shared/NodeContent.tsx +0 -204
  57. package/src/nodes/otel/shared/index.ts +0 -8
  58. package/src/nodes/otel/shared/types.ts +0 -138
  59. package/src/nodes/otel/shared/useNodeBehavior.ts +0 -114
  60. package/src/stories/Audit/BoundaryNodes.stories.tsx +0 -385
  61. package/src/stories/Audit/CanvasEdgeTypes.stories.tsx +0 -1448
  62. package/src/stories/Audit/CanvasNodeTypes.stories.tsx +0 -1049
  63. package/src/stories/Audit/ColorPriority.stories.tsx +0 -895
  64. package/src/stories/Audit/DiamondBadges.stories.tsx +0 -629
  65. package/src/stories/Audit/NodeDimensionsTesting.stories.tsx +0 -724
  66. package/src/stories/Audit/NodeFieldsAudit.stories.tsx +0 -996
  67. package/src/stories/Audit/NodeFontSizeTesting.stories.tsx +0 -715
  68. package/src/stories/Audit/NodeShapes.stories.tsx +0 -1208
  69. package/src/stories/Audit/WideNodesTesting.stories.tsx +0 -1045
  70. package/src/stories/Components/DashboardRenderer.stories.tsx +0 -263
  71. package/src/stories/Components/GraphRenderer.stories.tsx +0 -3236
  72. package/src/stories/Components/MultiCanvasRenderer.stories.tsx +0 -370
  73. package/src/stories/Components/SequenceDiagram.stories.tsx +0 -255
  74. package/src/stories/Components/StateView.stories.tsx +0 -417
  75. package/src/stories/Components/TraceViewer.stories.tsx +0 -442
  76. package/src/stories/Components/WorkflowSequenceDiagram.stories.tsx +0 -802
  77. package/src/stories/Features/AnimationWorkshop.stories.tsx +0 -727
  78. package/src/stories/Features/ChangeTypeVisual.stories.tsx +0 -67
  79. package/src/stories/Features/EventDrivenAnimations.stories.tsx +0 -513
  80. package/src/stories/Features/MultiConfig.stories.tsx +0 -539
  81. package/src/stories/Layout/ElkEdgeRouting.stories.tsx +0 -539
  82. package/src/stories/Layout/GraphOrientation.stories.tsx +0 -500
  83. package/src/stories/Layout/MultiDirectionalConnections.stories.tsx +0 -352
  84. package/src/stories/Nodes/NodeDefinitionComparison.stories.tsx +0 -560
  85. package/src/stories/Nodes/NodeNameFallbacks.stories.tsx +0 -491
  86. package/src/stories/Nodes/NumericColors.stories.tsx +0 -440
  87. package/src/stories/OTEL/EventNameDisplay.stories.tsx +0 -694
  88. package/src/stories/OTEL/EventNameFallback.stories.tsx +0 -578
  89. package/src/stories/OTEL/OtelComponents.stories.tsx +0 -422
  90. package/src/stories/OTEL/OtelNodeTypesPrototype.stories.tsx +0 -806
  91. package/src/stories/OTEL/RawEventCards.stories.tsx +0 -57
  92. package/src/stories/OTEL/SpanBadges.stories.tsx +0 -840
  93. package/src/stories/OTEL/ValidationEventsCanvas.stories.tsx +0 -209
  94. package/src/stories/RealWorld/BacklogMdCanvases.stories.tsx +0 -721
  95. package/src/stories/RealWorld/FileCitySequence.stories.tsx +0 -516
  96. package/src/stories/RealWorld/RealCanvasFiles.stories.tsx +0 -336
  97. package/src/stories/__traces__/test-run.canvas.json +0 -241
  98. package/src/stories/data/activity-feed-analytics.dashboard.json +0 -300
  99. package/src/stories/data/file-city-images-transformed.otel.canvas.json +0 -295
  100. package/src/stories/data/file-city-workflows.json +0 -269
  101. package/src/stories/data/graph-converter-test-execution.json +0 -443
  102. package/src/stories/data/graph-converter-test.workflow.json +0 -105
  103. package/src/stories/data/graph-converter-validated-execution.json +0 -58
  104. package/src/utils/animationMapping.ts +0 -166
  105. package/src/utils/canvasBounds.ts +0 -146
  106. package/src/utils/graphConverter.ts +0 -148
  107. package/src/utils/iconResolver.tsx +0 -53
  108. package/src/utils/orientationUtils.ts +0 -73
@@ -1,417 +0,0 @@
1
- import type { Meta, StoryObj } from '@storybook/react';
2
- import React, { useState, useCallback, useRef, useEffect } from 'react';
3
- import {
4
- PipelineView,
5
- type PipelineEvent,
6
- type EventSource,
7
- type PipelineEventType,
8
- } from '../../components/state-view';
9
-
10
- const meta = {
11
- title: 'Components/StateView',
12
- component: PipelineView,
13
- parameters: {
14
- layout: 'centered',
15
- },
16
- tags: ['autodocs'],
17
- } satisfies Meta<typeof PipelineView>;
18
-
19
- export default meta;
20
- type Story = StoryObj<typeof meta>;
21
-
22
- // =============================================================================
23
- // Event Simulation Helpers
24
- // =============================================================================
25
-
26
- function createPipelineEvent(
27
- type: PipelineEventType,
28
- payload: PipelineEvent['payload'] = {}
29
- ): PipelineEvent {
30
- return {
31
- type,
32
- timestamp: Date.now(),
33
- payload,
34
- };
35
- }
36
-
37
- function simulatePipelineFlow(
38
- emit: (event: PipelineEvent) => void,
39
- repo: string
40
- ) {
41
- // Simulate: FS change -> Watch -> Cache -> Event
42
- const delays = [0, 100, 200, 350];
43
-
44
- setTimeout(() => emit(createPipelineEvent('FS_CHANGE', { repo })), delays[0]);
45
- setTimeout(() => emit(createPipelineEvent('WATCH_DETECTED', { repo })), delays[1]);
46
- setTimeout(() => emit(createPipelineEvent('CACHE_REBUILD', { repo, slice: 'fileTree' })), delays[2]);
47
- setTimeout(() => emit(createPipelineEvent('EVENT_BROADCAST', { repo, eventType: 'commit' })), delays[3]);
48
- }
49
-
50
- // =============================================================================
51
- // Live Event Source (simulated)
52
- // =============================================================================
53
-
54
- function useLiveEventSource(): {
55
- eventSource: EventSource<PipelineEvent>;
56
- triggerEvent: (type: PipelineEventType, payload?: PipelineEvent['payload']) => void;
57
- triggerFlow: (repo: string) => void;
58
- } {
59
- const listenersRef = useRef<Set<(event: PipelineEvent) => void>>(new Set());
60
-
61
- const eventSource: EventSource<PipelineEvent> = {
62
- mode: 'live',
63
- subscribe: (handler) => {
64
- listenersRef.current.add(handler);
65
- return () => listenersRef.current.delete(handler);
66
- },
67
- };
68
-
69
- const emit = useCallback((event: PipelineEvent) => {
70
- listenersRef.current.forEach((handler) => handler(event));
71
- }, []);
72
-
73
- const triggerEvent = useCallback(
74
- (type: PipelineEventType, payload: PipelineEvent['payload'] = {}) => {
75
- emit(createPipelineEvent(type, payload));
76
- },
77
- [emit]
78
- );
79
-
80
- const triggerFlow = useCallback(
81
- (repo: string) => {
82
- simulatePipelineFlow(emit, repo);
83
- },
84
- [emit]
85
- );
86
-
87
- return { eventSource, triggerEvent, triggerFlow };
88
- }
89
-
90
- // =============================================================================
91
- // Replay Event Source
92
- // =============================================================================
93
-
94
- interface ReplayEventSourceOptions {
95
- events: PipelineEvent[];
96
- speed?: number;
97
- }
98
-
99
- function useReplayEventSource({ events, speed = 1 }: ReplayEventSourceOptions): {
100
- eventSource: EventSource<PipelineEvent>;
101
- controls: {
102
- play: () => void;
103
- pause: () => void;
104
- reset: () => void;
105
- isPlaying: boolean;
106
- };
107
- } {
108
- const listenersRef = useRef<Set<(event: PipelineEvent) => void>>(new Set());
109
- const [isPlaying, setIsPlaying] = useState(false);
110
- const indexRef = useRef(0);
111
- const timeoutRef = useRef<NodeJS.Timeout | null>(null);
112
-
113
- const eventSource: EventSource<PipelineEvent> = {
114
- mode: 'replay',
115
- subscribe: (handler) => {
116
- listenersRef.current.add(handler);
117
- return () => listenersRef.current.delete(handler);
118
- },
119
- };
120
-
121
- const emit = useCallback((event: PipelineEvent) => {
122
- // Update timestamp to "now" for display purposes
123
- const adjustedEvent = { ...event, timestamp: Date.now() };
124
- listenersRef.current.forEach((handler) => handler(adjustedEvent));
125
- }, []);
126
-
127
- const playNext = useCallback(() => {
128
- if (indexRef.current >= events.length) {
129
- setIsPlaying(false);
130
- return;
131
- }
132
-
133
- const currentEvent = events[indexRef.current];
134
- emit(currentEvent);
135
- indexRef.current++;
136
-
137
- if (indexRef.current < events.length) {
138
- const nextEvent = events[indexRef.current];
139
- const delay = (nextEvent.timestamp - currentEvent.timestamp) / speed;
140
- timeoutRef.current = setTimeout(playNext, Math.max(50, delay));
141
- } else {
142
- setIsPlaying(false);
143
- }
144
- }, [events, speed, emit]);
145
-
146
- const play = useCallback(() => {
147
- if (isPlaying) return;
148
- setIsPlaying(true);
149
- playNext();
150
- }, [isPlaying, playNext]);
151
-
152
- const pause = useCallback(() => {
153
- setIsPlaying(false);
154
- if (timeoutRef.current) {
155
- clearTimeout(timeoutRef.current);
156
- timeoutRef.current = null;
157
- }
158
- }, []);
159
-
160
- const reset = useCallback(() => {
161
- pause();
162
- indexRef.current = 0;
163
- }, [pause]);
164
-
165
- useEffect(() => {
166
- return () => {
167
- if (timeoutRef.current) clearTimeout(timeoutRef.current);
168
- };
169
- }, []);
170
-
171
- return {
172
- eventSource,
173
- controls: { play, pause, reset, isPlaying },
174
- };
175
- }
176
-
177
- // =============================================================================
178
- // Stories
179
- // =============================================================================
180
-
181
- /**
182
- * Interactive demo with manual event triggering.
183
- * Click buttons to simulate events flowing through the pipeline.
184
- */
185
- export const Interactive: Story = {
186
- render: () => {
187
- const { eventSource, triggerEvent, triggerFlow } = useLiveEventSource();
188
- const [selectedRepo, setSelectedRepo] = useState('myorg/backend');
189
-
190
- const repos = ['myorg/backend', 'myorg/frontend', 'myorg/shared-lib'];
191
-
192
- return (
193
- <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
194
- <PipelineView eventSource={eventSource} title="Repository Monitoring Pipeline" />
195
-
196
- {/* Control Panel */}
197
- <div
198
- style={{
199
- padding: 16,
200
- backgroundColor: '#111827',
201
- borderRadius: 8,
202
- fontFamily: 'system-ui, sans-serif',
203
- }}
204
- >
205
- <div style={{ color: '#9ca3af', fontSize: 12, marginBottom: 12 }}>
206
- Event Controls
207
- </div>
208
-
209
- <div style={{ display: 'flex', gap: 8, marginBottom: 12, flexWrap: 'wrap' }}>
210
- <select
211
- value={selectedRepo}
212
- onChange={(e) => setSelectedRepo(e.target.value)}
213
- style={{
214
- padding: '8px 12px',
215
- borderRadius: 4,
216
- border: 'none',
217
- backgroundColor: '#374151',
218
- color: 'white',
219
- }}
220
- >
221
- {repos.map((repo) => (
222
- <option key={repo} value={repo}>
223
- {repo}
224
- </option>
225
- ))}
226
- </select>
227
-
228
- <button
229
- onClick={() => triggerFlow(selectedRepo)}
230
- style={{
231
- padding: '8px 16px',
232
- borderRadius: 4,
233
- border: 'none',
234
- backgroundColor: '#3b82f6',
235
- color: 'white',
236
- cursor: 'pointer',
237
- fontWeight: 'bold',
238
- }}
239
- >
240
- Simulate Full Flow
241
- </button>
242
- </div>
243
-
244
- <div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
245
- <button
246
- onClick={() => triggerEvent('FS_CHANGE', { repo: selectedRepo })}
247
- style={buttonStyle('#10b981')}
248
- >
249
- FS Change
250
- </button>
251
- <button
252
- onClick={() => triggerEvent('WATCH_DETECTED', { repo: selectedRepo })}
253
- style={buttonStyle('#6366f1')}
254
- >
255
- Watch Detect
256
- </button>
257
- <button
258
- onClick={() => triggerEvent('CACHE_REBUILD', { repo: selectedRepo, slice: 'fileTree' })}
259
- style={buttonStyle('#f59e0b')}
260
- >
261
- Cache Rebuild
262
- </button>
263
- <button
264
- onClick={() => triggerEvent('EVENT_BROADCAST', { repo: selectedRepo, eventType: 'commit' })}
265
- style={buttonStyle('#ef4444')}
266
- >
267
- Event Broadcast
268
- </button>
269
- </div>
270
- </div>
271
- </div>
272
- );
273
- },
274
- };
275
-
276
- /**
277
- * Auto-playing demo that continuously simulates pipeline activity.
278
- */
279
- export const AutoSimulation: Story = {
280
- render: () => {
281
- const { eventSource, triggerFlow } = useLiveEventSource();
282
- const [isRunning, setIsRunning] = useState(true);
283
- const intervalRef = useRef<NodeJS.Timeout | null>(null);
284
-
285
- const repos = ['myorg/backend', 'myorg/frontend', 'myorg/shared-lib', 'myorg/docs'];
286
-
287
- useEffect(() => {
288
- if (isRunning) {
289
- intervalRef.current = setInterval(() => {
290
- const randomRepo = repos[Math.floor(Math.random() * repos.length)];
291
- triggerFlow(randomRepo);
292
- }, 1500);
293
- } else {
294
- if (intervalRef.current) clearInterval(intervalRef.current);
295
- }
296
-
297
- return () => {
298
- if (intervalRef.current) clearInterval(intervalRef.current);
299
- };
300
- }, [isRunning, triggerFlow]);
301
-
302
- return (
303
- <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
304
- <PipelineView eventSource={eventSource} title="Auto-Simulation" />
305
-
306
- <div style={{ textAlign: 'center' }}>
307
- <button
308
- onClick={() => setIsRunning(!isRunning)}
309
- style={{
310
- padding: '8px 24px',
311
- borderRadius: 4,
312
- border: 'none',
313
- backgroundColor: isRunning ? '#ef4444' : '#10b981',
314
- color: 'white',
315
- cursor: 'pointer',
316
- fontWeight: 'bold',
317
- }}
318
- >
319
- {isRunning ? 'Stop Simulation' : 'Start Simulation'}
320
- </button>
321
- </div>
322
- </div>
323
- );
324
- },
325
- };
326
-
327
- /**
328
- * Replay mode - plays back a recorded sequence of events.
329
- */
330
- export const Replay: Story = {
331
- render: () => {
332
- // Pre-recorded events
333
- const recordedEvents: PipelineEvent[] = [
334
- { type: 'FS_CHANGE', timestamp: 0, payload: { repo: 'myorg/backend' } },
335
- { type: 'WATCH_DETECTED', timestamp: 100, payload: { repo: 'myorg/backend' } },
336
- { type: 'CACHE_REBUILD', timestamp: 200, payload: { repo: 'myorg/backend', slice: 'fileTree' } },
337
- { type: 'EVENT_BROADCAST', timestamp: 350, payload: { repo: 'myorg/backend', eventType: 'commit' } },
338
-
339
- { type: 'FS_CHANGE', timestamp: 800, payload: { repo: 'myorg/frontend' } },
340
- { type: 'WATCH_DETECTED', timestamp: 900, payload: { repo: 'myorg/frontend' } },
341
- { type: 'CACHE_HIT', timestamp: 950, payload: { repo: 'myorg/frontend', slice: 'fileTree' } },
342
- { type: 'EVENT_BROADCAST', timestamp: 1000, payload: { repo: 'myorg/frontend', eventType: 'branch-switch' } },
343
-
344
- { type: 'FS_CHANGE', timestamp: 1500, payload: { repo: 'myorg/backend' } },
345
- { type: 'WATCH_DETECTED', timestamp: 1600, payload: { repo: 'myorg/backend' } },
346
- { type: 'CACHE_REBUILD', timestamp: 1700, payload: { repo: 'myorg/backend', slice: 'packages' } },
347
- { type: 'EVENT_BROADCAST', timestamp: 1850, payload: { repo: 'myorg/backend', eventType: 'dirty-change' } },
348
- ];
349
-
350
- const { eventSource, controls } = useReplayEventSource({
351
- events: recordedEvents,
352
- speed: 1,
353
- });
354
-
355
- return (
356
- <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
357
- <PipelineView eventSource={eventSource} title="Replay Mode" />
358
-
359
- <div
360
- style={{
361
- display: 'flex',
362
- justifyContent: 'center',
363
- gap: 8,
364
- padding: 16,
365
- backgroundColor: '#111827',
366
- borderRadius: 8,
367
- }}
368
- >
369
- <button
370
- onClick={controls.isPlaying ? controls.pause : controls.play}
371
- style={{
372
- padding: '8px 24px',
373
- borderRadius: 4,
374
- border: 'none',
375
- backgroundColor: controls.isPlaying ? '#f59e0b' : '#10b981',
376
- color: 'white',
377
- cursor: 'pointer',
378
- fontWeight: 'bold',
379
- }}
380
- >
381
- {controls.isPlaying ? 'Pause' : 'Play'}
382
- </button>
383
- <button
384
- onClick={controls.reset}
385
- style={{
386
- padding: '8px 24px',
387
- borderRadius: 4,
388
- border: 'none',
389
- backgroundColor: '#374151',
390
- color: 'white',
391
- cursor: 'pointer',
392
- }}
393
- >
394
- Reset
395
- </button>
396
- </div>
397
-
398
- <div style={{ color: '#9ca3af', fontSize: 12, textAlign: 'center' }}>
399
- Replaying {recordedEvents.length} recorded events
400
- </div>
401
- </div>
402
- );
403
- },
404
- };
405
-
406
- // Helper style function
407
- function buttonStyle(color: string): React.CSSProperties {
408
- return {
409
- padding: '6px 12px',
410
- borderRadius: 4,
411
- border: 'none',
412
- backgroundColor: color,
413
- color: 'white',
414
- cursor: 'pointer',
415
- fontSize: 12,
416
- };
417
- }