footprint-explainable-ui 0.22.0 → 0.24.0

package/README.md

@@ -362,6 +362,22 @@ Strip all built-in styles for full CSS control. Components render semantic `data
 
 ---
 
+## Golden-Trace Fixtures (contributors)
+
+The pipeline (structure/runtime translators, dagre layout, snapshot adapter,
+narrative sync) is pinned against **real footprintjs engine output**, not
+hand-built mocks. `test/fixtures/golden/` holds recorded traces from 4
+representative charts (linear+decider, subflow+loop, parallel fork,
+pause/resume); `test/golden/goldenTraces.test.ts` replays them through the full
+pipeline and snapshot-asserts the outputs in `test/golden/__snapshots__/`.
+
+- **Engine shape changed** (new footprintjs): `npm i -D --save-exact footprintjs@<version> && npm run fixtures:regen`. The generator runs every chart twice and fails on any nondeterminism.
+- **Pipeline output changed intentionally** (eui edit): `npx vitest run test/golden -u`, then review the snapshot diff.
+- `test/fixtures/golden/manifest.json` records the footprintjs version the fixtures were recorded with.
+
+`footprintjs` is a devDependency used ONLY by the generator — the published
+library still has zero footprintjs dependency (it consumes plain JSON shapes).
+
 ## License
 
 MIT

package/dist/flowchart.cjs

@@ -3261,7 +3261,7 @@ function walkNode(node, subflowPath, sink, visited) {
     walkNode(node.subflowStructure, nestedPath, sink, visited);
   }
   const type = node.type ?? "stage";
-  const isDecider = type === "decider" || type === "selector";
+  const isDecider = type === "decider" || type === "selector" || node.hasDecider === true || node.hasSelector === true;
   const isFork = type === "fork";
   const isStreaming = type === "streaming";
   const isSubflow = !!node.isSubflowRoot;
@@ -3395,7 +3395,7 @@ function createTraceStructureRecorder(options = {}) {
     onStageAdded(event) {
       const spec = event.spec;
       const type = event.type;
-      const isDecider = type === "decider" || type === "selector";
+      const isDecider = type === "decider" || type === "selector" || spec.hasDecider === true || spec.hasSelector === true;
       const isFork = type === "fork";
       const isStreaming = type === "streaming";
       const isSubflow = !!spec.isSubflowRoot;
@@ -3464,7 +3464,10 @@ function createTraceStructureRecorder(options = {}) {
       const node = nodes[existing];
       const data = {
         ...node.data,
-        branchIds: event.branchIds
+        branchIds: event.branchIds,
+        // A sealed branch list IS decider-ness — engines that stamp neither
+        // `type: 'decider'` nor `spec.hasDecider` still get a decision node.
+        isDecider: true
       };
       if (event.defaultBranch !== void 0) data.defaultBranch = event.defaultBranch;
       nodes[existing] = { ...node, data };