How lbfrandsen/data-extended-petrinet-io works
This is a browser-based Colored Petri Net editor extended with SQL-backed simulation. The principal workflow is to create and type a net, add arc bindings and transition guards, then simulate token movement with optional database queries and actions; users can persist or export the model. The graph includes rendering, editing, simulation, SQL, and import/export capabilities documented in the README. Some subsystems were not sampled, so documented behavior is shown where implementation-level calls were unavailable.
Main entry points: editor.js Editor runtime · BaseSimulationService.js Simulation engine · GuardProvider.js Guard editing · SqlDialogService.js SQL assignments
Components 28
Editor and modeling
- Editor runtime
lib/core/editor.js - PetriNetIO API
lib/PetriNetIO.js - Diagram editing
lib/features/editing/EditingProvider.js - Palette tools
lib/providers/PaletteProvider.js - Context actions
lib/providers/ContextPadProvider.js - Keyboard bindings
lib/features/keyboard/PetriNetKeyboardBindings.js
Typed net semantics
- Arc inscriptions
lib/providers/ArcInscriptionProvider.js - Place typing
lib/providers/PlaceTypingProvider.js - Guard editing
lib/providers/GuardProvider.js - Guard parser
lib/helpers/GuardParser.js - Guard evaluation
lib/helpers/GuardEngine.js
Simulation and SQL
- Simulation engine
lib/features/simulation/BaseSimulationService.js - Simulation controls
lib/features/simulation/SimulationUiBehavior.js - SQL assignments
lib/services/SqlDialogService.js - Database service
lib/services/DatabaseService.js - Database explorer
lib/services/DatabaseExplorerDialogService.js - User dialogs
lib/services/DialogService.js
Persistence and export
- PNML import
lib/features/export-import-pnml/PnmlImporter.js - PNML export
lib/features/export-import-pnml/PnmlExporter.js - Combined DB-PNML
lib/features/export-import-pnml/DbPnmlService.js - SVG export
lib/features/export-svg/SvgExporter.js - PDF export
lib/features/export-pdf/PdfExporter.js - TPN export
lib/features/export-tpn/TpnExporter.js
Rendering and guidance
- Net renderer
lib/draw/BaseRender.js - Canvas labels
lib/draw/renderers/LabelRenderer.js - Simulation roadmap
lib/providers/SimulationRoadmapProvider.js - In-app guidance
lib/providers/DocumentationProvider.js
Other components
- Editor user
Connections 36
- Editor user → PetriNetIO API: uses editor
- PetriNetIO API → Editor runtime: creates runtime
lib/PetriNetIO.js - Editor runtime → Diagram editing: registers module
lib/core/editor.js - Editor runtime → Simulation engine: registers module
lib/core/editor.js - Editor runtime → PNML import: registers module
lib/core/editor.js - Editor runtime → PNML export: registers module
lib/core/editor.js - Editor runtime → SVG export: registers exporter
lib/core/editor.js - Editor runtime → PDF export: registers exporter
lib/core/editor.js - Editor runtime → TPN export: registers exporter
lib/core/editor.js - Editor runtime → Net renderer: registers renderer
lib/core/editor.js - Editor runtime → Palette tools: registers provider
- Editor runtime → Context actions: registers provider
- Context actions → Arc inscriptions: initializes and syncs
lib/providers/ContextPadProvider.js - Context actions → Guard editing: opens guard editor
lib/providers/ContextPadProvider.js - Guard editing → Guard parser: parses guard
lib/providers/GuardProvider.js - Guard editing → Guard evaluation: validates guard
lib/providers/GuardProvider.js - Guard editing → SQL assignments: reads query
lib/providers/GuardProvider.js - Guard editing → User dialogs: prompts and alerts
lib/providers/GuardProvider.js - Simulation engine → Guard parser: parses guards
lib/features/simulation/BaseSimulationService.js - Simulation engine → Guard evaluation: evaluates guards
lib/features/simulation/BaseSimulationService.js - Simulation engine → User dialogs: requests interaction
lib/features/simulation/BaseSimulationService.js - Simulation engine → SQL assignments: evaluates bound SQL
- Simulation engine → Database service: queries and applies actions
- SQL assignments → Database explorer: opens explorer
lib/services/SqlDialogService.js - SQL assignments → User dialogs: shows query lists
lib/services/SqlDialogService.js - Combined DB-PNML → PNML export: exports PNML
lib/features/export-import-pnml/DbPnmlService.js - Combined DB-PNML → PNML import: imports PNML
lib/features/export-import-pnml/DbPnmlService.js - Combined DB-PNML → Database service: bundles database
lib/features/export-import-pnml/DbPnmlService.js - Net renderer → Canvas labels: renders labels
lib/draw/BaseRender.js - Editor runtime → Simulation roadmap: registers provider
- Editor runtime → In-app guidance: registers guidance
- Editor user → Simulation engine: fires transitions
- Editor user → PNML import: imports model
- Editor user → SVG export: exports diagram
- Editor user → PDF export: exports diagram
- Editor user → TPN export: exports net