tiny/spring-state-machine-renderer
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v2.3 extended analysis render update

Browse Source
This commit is contained in:
Kamil Patryk Kozakowski
2026-06-15 22:00:38 +02:00
parent bd44049e5e
commit ac05513b6c
30 changed files with 2341 additions and 146 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1261
state_machine_exporter_html/out_complex/click.kamil.examples.statemachine.complex.ComplexStateMachineConfig/click.kamil.examples.statemachine.complex.ComplexStateMachineConfig.html Normal file
View File

File diff suppressed because one or more lines are too long

599
state_machine_exporter_html/out_complex/click.kamil.examples.statemachine.complex.ComplexStateMachineConfig/click.kamil.examples.statemachine.complex.ComplexStateMachineConfig.json Normal file
View File

@@ -0,0 +1,599 @@
{
"metadata" : {
"triggers" : [ ],
"entryPoints" : [ ],
"callChains" : [ ],
"properties" : {
"spring.application.name" : "statemachinedemo"
}
},
"name" : "click.kamil.examples.statemachine.complex.ComplexStateMachineConfig",
"renderChoicesAsDiamonds" : true,
"startStates" : [ "States.STATE1" ],
"transitions" : [ {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE1",
"fullIdentifier" : "States.STATE1"
} ],
"targetStates" : [ {
"rawName" : "States.STATE2",
"fullIdentifier" : "States.STATE2"
} ],
"event" : "Events.EVENT1",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE2",
"fullIdentifier" : "States.STATE2"
} ],
"targetStates" : [ {
"rawName" : "States.STATE3",
"fullIdentifier" : "States.STATE3"
} ],
"event" : "Events.EVENT2",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE3",
"fullIdentifier" : "States.STATE3"
} ],
"targetStates" : [ {
"rawName" : "States.STATE4",
"fullIdentifier" : "States.STATE4"
} ],
"event" : "Events.EVENT3",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE4",
"fullIdentifier" : "States.STATE4"
} ],
"targetStates" : [ {
"rawName" : "States.STATE5",
"fullIdentifier" : "States.STATE5"
} ],
"event" : "Events.EVENT4",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE5",
"fullIdentifier" : "States.STATE5"
} ],
"targetStates" : [ {
"rawName" : "States.STATE6",
"fullIdentifier" : "States.STATE6"
} ],
"event" : "Events.EVENT5",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE6",
"fullIdentifier" : "States.STATE6"
} ],
"targetStates" : [ {
"rawName" : "States.STATE7",
"fullIdentifier" : "States.STATE7"
} ],
"event" : "Events.EVENT6",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE7",
"fullIdentifier" : "States.STATE7"
} ],
"targetStates" : [ {
"rawName" : "States.STATE8",
"fullIdentifier" : "States.STATE8"
} ],
"event" : "Events.EVENT7",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE8",
"fullIdentifier" : "States.STATE8"
} ],
"targetStates" : [ {
"rawName" : "States.STATE9",
"fullIdentifier" : "States.STATE9"
} ],
"event" : "Events.EVENT8",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE9",
"fullIdentifier" : "States.STATE9"
} ],
"targetStates" : [ {
"rawName" : "States.STATE10",
"fullIdentifier" : "States.STATE10"
} ],
"event" : "Events.EVENT9",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE10",
"fullIdentifier" : "States.STATE10"
} ],
"targetStates" : [ {
"rawName" : "States.STATE11",
"fullIdentifier" : "States.STATE11"
} ],
"event" : "Events.EVENT10",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE11",
"fullIdentifier" : "States.STATE11"
} ],
"targetStates" : [ {
"rawName" : "States.STATE12",
"fullIdentifier" : "States.STATE12"
} ],
"event" : "Events.EVENT11",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE12",
"fullIdentifier" : "States.STATE12"
} ],
"targetStates" : [ {
"rawName" : "States.STATE13",
"fullIdentifier" : "States.STATE13"
} ],
"event" : "Events.EVENT12",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE13",
"fullIdentifier" : "States.STATE13"
} ],
"targetStates" : [ {
"rawName" : "States.STATE14",
"fullIdentifier" : "States.STATE14"
} ],
"event" : "Events.EVENT13",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE14",
"fullIdentifier" : "States.STATE14"
} ],
"targetStates" : [ {
"rawName" : "States.STATE15",
"fullIdentifier" : "States.STATE15"
} ],
"event" : "Events.EVENT14",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "EXTERNAL",
"sourceStates" : [ {
"rawName" : "States.STATE15",
"fullIdentifier" : "States.STATE15"
} ],
"targetStates" : [ {
"rawName" : "States.STATE16",
"fullIdentifier" : "States.STATE16"
} ],
"event" : "Events.EVENT15",
"guard" : null,
"actions" : [ ],
"order" : null
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE16",
"fullIdentifier" : "States.STATE16"
} ],
"targetStates" : [ {
"rawName" : "States.STATE17",
"fullIdentifier" : "States.STATE17"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"value1\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE16",
"fullIdentifier" : "States.STATE16"
} ],
"targetStates" : [ {
"rawName" : "States.STATE18",
"fullIdentifier" : "States.STATE18"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"value2\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 1
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE16",
"fullIdentifier" : "States.STATE16"
} ],
"targetStates" : [ {
"rawName" : "States.STATE19",
"fullIdentifier" : "States.STATE19"
} ],
"event" : null,
"guard" : null,
"actions" : [ ],
"order" : 2
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE17",
"fullIdentifier" : "States.STATE17"
} ],
"targetStates" : [ {
"rawName" : "States.STATE20",
"fullIdentifier" : "States.STATE20"
} ],
"event" : null,
"guard" : {
"expression" : "guardEventHeaderEquals(\"header1\",\"foo\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE17",
"fullIdentifier" : "States.STATE17"
} ],
"targetStates" : [ {
"rawName" : "States.STATE16",
"fullIdentifier" : "States.STATE16"
} ],
"event" : null,
"guard" : null,
"actions" : [ ],
"order" : 1
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE18",
"fullIdentifier" : "States.STATE18"
} ],
"targetStates" : [ {
"rawName" : "States.STATE19",
"fullIdentifier" : "States.STATE19"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"value3\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE18",
"fullIdentifier" : "States.STATE18"
} ],
"targetStates" : [ {
"rawName" : "States.STATE20",
"fullIdentifier" : "States.STATE20"
} ],
"event" : null,
"guard" : null,
"actions" : [ ],
"order" : 1
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE19",
"fullIdentifier" : "States.STATE19"
} ],
"targetStates" : [ {
"rawName" : "States.STATE1",
"fullIdentifier" : "States.STATE1"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"reset\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE19",
"fullIdentifier" : "States.STATE19"
} ],
"targetStates" : [ {
"rawName" : "States.STATE20",
"fullIdentifier" : "States.STATE20"
} ],
"event" : null,
"guard" : null,
"actions" : [ ],
"order" : 1
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE20",
"fullIdentifier" : "States.STATE20"
} ],
"targetStates" : [ {
"rawName" : "States.STATE5",
"fullIdentifier" : "States.STATE5"
} ],
"event" : null,
"guard" : {
"expression" : "guardEventHeaderEquals(\"header2\",\"bar\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE20",
"fullIdentifier" : "States.STATE20"
} ],
"targetStates" : [ {
"rawName" : "States.STATE1",
"fullIdentifier" : "States.STATE1"
} ],
"event" : null,
"guard" : null,
"actions" : [ ],
"order" : 1
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE11",
"fullIdentifier" : "States.STATE11"
} ],
"targetStates" : [ {
"rawName" : "States.STATE13",
"fullIdentifier" : "States.STATE13"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"goTo13\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE11",
"fullIdentifier" : "States.STATE11"
} ],
"targetStates" : [ {
"rawName" : "States.STATE14",
"fullIdentifier" : "States.STATE14"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"goTo14\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 1
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE11",
"fullIdentifier" : "States.STATE11"
} ],
"targetStates" : [ {
"rawName" : "States.STATE15",
"fullIdentifier" : "States.STATE15"
} ],
"event" : null,
"guard" : null,
"actions" : [ ],
"order" : 2
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE12",
"fullIdentifier" : "States.STATE12"
} ],
"targetStates" : [ {
"rawName" : "States.STATE10",
"fullIdentifier" : "States.STATE10"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"goBack10\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE12",
"fullIdentifier" : "States.STATE12"
} ],
"targetStates" : [ {
"rawName" : "States.STATE11",
"fullIdentifier" : "States.STATE11"
} ],
"event" : null,
"guard" : null,
"actions" : [ ],
"order" : 1
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE14",
"fullIdentifier" : "States.STATE14"
} ],
"targetStates" : [ {
"rawName" : "States.STATE12",
"fullIdentifier" : "States.STATE12"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"loop12\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE14",
"fullIdentifier" : "States.STATE14"
} ],
"targetStates" : [ {
"rawName" : "States.STATE16",
"fullIdentifier" : "States.STATE16"
} ],
"event" : null,
"guard" : null,
"actions" : [ ],
"order" : 1
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE9",
"fullIdentifier" : "States.STATE9"
} ],
"targetStates" : [ {
"rawName" : "States.STATE8",
"fullIdentifier" : "States.STATE8"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"stepBack\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE9",
"fullIdentifier" : "States.STATE9"
} ],
"targetStates" : [ {
"rawName" : "States.STATE7",
"fullIdentifier" : "States.STATE7"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"stepBackMore\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 1
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE9",
"fullIdentifier" : "States.STATE9"
} ],
"targetStates" : [ {
"rawName" : "States.STATE6",
"fullIdentifier" : "States.STATE6"
} ],
"event" : null,
"guard" : null,
"actions" : [ ],
"order" : 2
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE8",
"fullIdentifier" : "States.STATE8"
} ],
"targetStates" : [ {
"rawName" : "States.STATE9",
"fullIdentifier" : "States.STATE9"
} ],
"event" : null,
"guard" : {
"expression" : "guardVarEquals(\"forward9\")",
"isLambda" : false,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0
}, {
"type" : "CHOICE",
"sourceStates" : [ {
"rawName" : "States.STATE8",
"fullIdentifier" : "States.STATE8"
} ],
"targetStates" : [ {
"rawName" : "States.STATE10",
"fullIdentifier" : "States.STATE10"
} ],
"event" : null,
"guard" : null,
"actions" : [ ],
"order" : 1
} ],
"endStates" : [ ]
}

117
state_machine_exporter_html/out_enterprise_v7/click.kamil.examples.enterprise.config.EnterpriseStateMachineConfig/click.kamil.examples.enterprise.config.EnterpriseStateMachineConfig.html
View File

File diff suppressed because one or more lines are too long

3
state_machine_exporter_html/out_enterprise_v7/click.kamil.examples.enterprise.config.EnterpriseStateMachineConfig/click.kamil.examples.enterprise.config.EnterpriseStateMachineConfig.json
View File

@@ -293,7 +293,8 @@
"event" : null,
"guard" : {
"expression" : "(c) -> true",
"isLambda" : true
"isLambda" : true,
"internalLogic" : null
},
"actions" : [ ],
"order" : 0

7
state_machine_exporter_html/src/main/java/click/kamil/springstatemachineexporter/html/command/HtmlExporterCommand.java
View File

@@ -50,6 +50,9 @@ public class HtmlExporterCommand implements Callable<Integer> {
@Option(names = {"--open"}, description = "Automatically open the generated HTML portal in your default browser.")
private boolean openPortal;
@Option(names = {"--no-diamonds"}, description = "Disable rendering choice pseudostates as PlantUML diamonds (render them as normal state nodes instead).")
private boolean noDiamonds;
@Override
public Integer call() throws Exception {
var out = spec.commandLine().getOut();
@@ -73,7 +76,9 @@ public class HtmlExporterCommand implements Callable<Integer> {
// Force HTML and JSON formats for the interactive portal
List<String> formats = List.of("html", "json");
exportService.runExporter(inputDir, outputDir, formats, true,
boolean renderChoicesAsDiamonds = !noDiamonds;
exportService.runExporter(inputDir, outputDir, formats, renderChoicesAsDiamonds,
activeProfiles != null ? activeProfiles : java.util.Collections.emptyList(),
flowsFile, machineFilter);

1
state_machine_exporter_html/src/main/java/click/kamil/springstatemachineexporter/html/exporter/HtmlExporter.java
View File

@@ -83,6 +83,7 @@ public class HtmlExporter implements StateMachineExporter {
public String export(String name, List<Transition> transitions, Set<String> startStates, Set<String> endStates, ExportOptions options) {
AnalysisResult mockResult = AnalysisResult.builder()
.name(name)
.states(click.kamil.springstatemachineexporter.ast.app.TransitionStateUtils.findAllStates(transitions, startStates, endStates))
.transitions(transitions)
.startStates(startStates)
.endStates(endStates)

77
state_machine_exporter_html/src/main/resources/html/template.html
View File

@@ -48,6 +48,46 @@
overflow-x: hidden;
resize: horizontal;
position: relative;
transition: width 0.3s ease, min-width 0.3s ease, padding 0.3s ease;
}
#sidebar.collapsed {
width: 0 !important;
min-width: 0 !important;
border-right: none;
padding: 0;
overflow: hidden;
resize: none;
}
#toggle-sidebar {
position: absolute;
top: 20px;
left: 20px;
z-index: 50;
background: #fff;
border: 1px solid var(--border);
border-radius: 8px;
padding: 8px;
cursor: pointer;
box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
display: flex;
align-items: center;
justify-content: center;
transition: all 0.2s ease;
}
#toggle-sidebar:hover {
background: #f8fafc;
border-color: var(--primary);
}
#toggle-sidebar svg {
width: 20px;
height: 20px;
fill: none;
stroke: var(--text-muted);
stroke-width: 2;
stroke-linecap: round;
stroke-linejoin: round;
}
#sidebar::after {
@@ -244,6 +284,9 @@
</div>
<div id="main">
<button id="toggle-sidebar" aria-label="Toggle Sidebar" title="Toggle Sidebar">
<svg viewBox="0 0 24 24"><path d="M4 6h16M4 12h16M4 18h16"></path></svg>
</button>
<div id="svg-container">
{{SVG_CONTENT}}
</div>
@@ -258,9 +301,22 @@
let panZoomInstance;
document.addEventListener('DOMContentLoaded', () => {
const svg = document.querySelector('svg');
const svg = document.querySelector('#svg-container svg');
panZoomInstance = svgPanZoom(svg, { zoomEnabled: true, controlIconsEnabled: true, fit: true, center: true });
document.getElementById('toggle-sidebar').addEventListener('click', () => {
const sidebar = document.getElementById('sidebar');
sidebar.classList.toggle('collapsed');
// Re-center SVG pan-zoom after transition
setTimeout(() => {
if (panZoomInstance) {
panZoomInstance.resize();
panZoomInstance.center();
}
}, 300);
});
setupTabs();
populateSidebar();
populateFlows();
@@ -353,7 +409,7 @@
}
function highlightEvents(steps) {
const svg = document.querySelector('svg');
const svg = document.querySelector('#svg-container svg');
// Dim everything first
svg.querySelectorAll('path, rect, circle, ellipse, text, polygon').forEach(el => {
@@ -427,7 +483,7 @@
}
function attachInteractivity() {
const svg = document.querySelector('svg');
const svg = document.querySelector('#svg-container svg');
const transitions = metadata.transitions || [];
svg.querySelectorAll('a').forEach(link => {
@@ -491,6 +547,21 @@
if (trans && trans.guard) {
html += `<div style="font-size:0.7rem; font-weight:800; color:#94a3b8; text-transform:uppercase; margin-bottom:4px">Guard</div>
<div style="background:#f1f5f9; padding:6px; border-radius:4px; font-family:monospace; font-size:0.8rem; margin-bottom:12px; border:1px solid #e2e8f0;">${trans.guard.expression}</div>`;
if (trans.guard.internalLogic) {
html += `<div style="font-size:0.65rem; font-weight:800; color:#cbd5e1; text-transform:uppercase; margin-bottom:4px">Internal Logic</div>
<pre style="background:#1e293b; color:#f8fafc; padding:8px; border-radius:4px; font-family:'JetBrains Mono', monospace; font-size:0.7rem; overflow-x:auto; margin-bottom:12px;"><code>${trans.guard.internalLogic.replace(/</g, '&lt;').replace(/>/g, '&gt;')}</code></pre>`;
}
}
if (trans && trans.actions && trans.actions.length > 0) {
html += `<div style="font-size:0.7rem; font-weight:800; color:#94a3b8; text-transform:uppercase; margin-bottom:4px">Actions</div>`;
trans.actions.forEach(action => {
html += `<div style="background:#f1f5f9; padding:6px; border-radius:4px; font-family:monospace; font-size:0.8rem; margin-bottom:12px; border:1px solid #e2e8f0;">${action.expression}</div>`;
if (action.internalLogic) {
html += `<div style="font-size:0.65rem; font-weight:800; color:#cbd5e1; text-transform:uppercase; margin-bottom:4px">Internal Logic</div>
<pre style="background:#1e293b; color:#f8fafc; padding:8px; border-radius:4px; font-family:'JetBrains Mono', monospace; font-size:0.7rem; overflow-x:auto; margin-bottom:12px;"><code>${action.internalLogic.replace(/</g, '&lt;').replace(/>/g, '&gt;')}</code></pre>`;
}
});
}
if (chains && chains.length > 0) {