@railtownai/railtracks-visualizer 0.0.3 → 0.0.4

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 (69) hide show
  1. package/README.md +40 -11
  2. package/dist/cjs/AgenticFlowVisualizer.js +750 -0
  3. package/dist/cjs/App.js +94 -0
  4. package/dist/cjs/Visualizer.js +16 -0
  5. package/dist/cjs/components/Edge.js +75 -0
  6. package/dist/cjs/components/FileSelector.js +28 -0
  7. package/dist/cjs/components/Node.js +104 -0
  8. package/dist/cjs/components/Timeline.js +122 -0
  9. package/dist/cjs/components/VerticalTimeline.js +160 -0
  10. package/dist/cjs/hooks/index.js +7 -0
  11. package/dist/cjs/hooks/useApi.js +108 -0
  12. package/dist/cjs/hooks/useFlowData.js +53 -0
  13. package/dist/cjs/index.js +40 -0
  14. package/dist/cjs/test/Visualizer.test.js +257 -0
  15. package/dist/cjs/test/setup.js +24 -0
  16. package/dist/esm/Visualizer.js +11 -0
  17. package/dist/{index.js → esm/index.js} +1 -2
  18. package/dist/esm/test/Visualizer.test.js +243 -0
  19. package/dist/esm/test/setup.js +22 -0
  20. package/dist/{AgenticFlowVisualizer.d.ts → types/AgenticFlowVisualizer.d.ts} +2 -2
  21. package/dist/types/AgenticFlowVisualizer.d.ts.map +1 -0
  22. package/dist/types/App.d.ts.map +1 -0
  23. package/dist/types/Visualizer.d.ts +9 -0
  24. package/dist/types/Visualizer.d.ts.map +1 -0
  25. package/dist/types/components/Edge.d.ts.map +1 -0
  26. package/dist/types/components/FileSelector.d.ts.map +1 -0
  27. package/dist/types/components/Node.d.ts.map +1 -0
  28. package/dist/types/components/Timeline.d.ts.map +1 -0
  29. package/dist/types/components/VerticalTimeline.d.ts.map +1 -0
  30. package/dist/types/hooks/index.d.ts.map +1 -0
  31. package/dist/types/hooks/useApi.d.ts.map +1 -0
  32. package/dist/types/hooks/useFlowData.d.ts.map +1 -0
  33. package/dist/{index.d.ts → types/index.d.ts} +2 -1
  34. package/dist/types/index.d.ts.map +1 -0
  35. package/dist/types/test/Visualizer.test.d.ts +2 -0
  36. package/dist/types/test/Visualizer.test.d.ts.map +1 -0
  37. package/dist/types/test/setup.d.ts +2 -0
  38. package/dist/types/test/setup.d.ts.map +1 -0
  39. package/package.json +20 -13
  40. package/dist/AgenticFlowVisualizer.d.ts.map +0 -1
  41. package/dist/App.d.ts.map +0 -1
  42. package/dist/components/Edge.d.ts.map +0 -1
  43. package/dist/components/FileSelector.d.ts.map +0 -1
  44. package/dist/components/Node.d.ts.map +0 -1
  45. package/dist/components/Timeline.d.ts.map +0 -1
  46. package/dist/components/VerticalTimeline.d.ts.map +0 -1
  47. package/dist/hooks/index.d.ts.map +0 -1
  48. package/dist/hooks/useApi.d.ts.map +0 -1
  49. package/dist/hooks/useFlowData.d.ts.map +0 -1
  50. package/dist/index.d.ts.map +0 -1
  51. /package/dist/{AgenticFlowVisualizer.js → esm/AgenticFlowVisualizer.js} +0 -0
  52. /package/dist/{App.js → esm/App.js} +0 -0
  53. /package/dist/{components → esm/components}/Edge.js +0 -0
  54. /package/dist/{components → esm/components}/FileSelector.js +0 -0
  55. /package/dist/{components → esm/components}/Node.js +0 -0
  56. /package/dist/{components → esm/components}/Timeline.js +0 -0
  57. /package/dist/{components → esm/components}/VerticalTimeline.js +0 -0
  58. /package/dist/{hooks → esm/hooks}/index.js +0 -0
  59. /package/dist/{hooks → esm/hooks}/useApi.js +0 -0
  60. /package/dist/{hooks → esm/hooks}/useFlowData.js +0 -0
  61. /package/dist/{App.d.ts → types/App.d.ts} +0 -0
  62. /package/dist/{components → types/components}/Edge.d.ts +0 -0
  63. /package/dist/{components → types/components}/FileSelector.d.ts +0 -0
  64. /package/dist/{components → types/components}/Node.d.ts +0 -0
  65. /package/dist/{components → types/components}/Timeline.d.ts +0 -0
  66. /package/dist/{components → types/components}/VerticalTimeline.d.ts +0 -0
  67. /package/dist/{hooks → types/hooks}/index.d.ts +0 -0
  68. /package/dist/{hooks → types/hooks}/useApi.d.ts +0 -0
  69. /package/dist/{hooks → types/hooks}/useFlowData.d.ts +0 -0
package/README.md CHANGED
@@ -1,23 +1,52 @@
1
1
  # RailTracks Visualizer
2
2
 
3
- A React-based visualization tool for agentic flow data from the RailTracks framework.
3
+ A React-based visualizer for RailTracks agentic flows
4
4
 
5
- ## Features
5
+ ## 🚀 Quick Start
6
+
7
+ ### As an NPM Package
8
+
9
+ 1. **Install the package:**
10
+
11
+ ```bash
12
+ npm install @railtownai/railtracks-visualizer
13
+ ```
14
+
15
+ 2. **Import and use in your React app:**
16
+
17
+ ```tsx
18
+ import { Visualizer } from '@railtownai/railtracks-visualizer';
19
+
20
+ function App() {
21
+ const flowData = {
22
+ nodes: [...],
23
+ edges: [...],
24
+ stamps: [...]
25
+ };
26
+
27
+ return (
28
+ <Visualizer
29
+ flowData={flowData}
30
+ width="100%"
31
+ height="800px"
32
+ />
33
+ );
34
+ }
35
+ ```
36
+
37
+ ## 🎨 Features
6
38
 
7
39
  - **Interactive Flow Visualization**: Visualize agentic flows with nodes and edges
8
40
  - **Timeline Navigation**: Step through the flow execution timeline
9
- - **API Integration**: Load JSON files directly from the railtracks API server
10
- - **File Selector**: Dropdown with search functionality to select JSON files
11
- - **Node/Edge Inspection**: Click on elements to view detailed information
12
41
  - **Auto-layout**: Automatic positioning of nodes in a tree structure
13
42
  - **Responsive Design**: Works on different screen sizes
43
+ - **Inspection Panel**: Detailed view of nodes and edges
44
+ - **Playback Controls**: Play/pause timeline progression
14
45
 
15
- ## Get Started
46
+ ## 📄 License
16
47
 
17
- 1. Install it! `npm install --save @railtownai/railtracks-visualizer`
18
- 2. Import the agent visualizer `<AgentVisualizer data={MY_RAILTRACKS_RUN_DATA} />`
19
- 3. Render!
48
+ Apache-2.0
20
49
 
21
- ## License
50
+ ## 📞 Support
22
51
 
23
- This project is licensed under the Apache License 2.0. See the [LICENSE](LICENSE) file for details.
52
+ For issues and questions, please open an issue on GitHub.