footprint-explainable-ui 0.14.2 → 0.14.4

package/dist/index.d.cts

@@ -367,10 +367,12 @@ interface RuntimeSnapshotInput {
     executionTree: unknown;
     commitLog: unknown[];
     subflowResults?: Record<string, unknown>;
-    /** Recorder snapshots from FlowRecorder.toSnapshot() — auto-generates detail tabs. */
+    /** Recorder snapshots from toSnapshot() — auto-generates detail tabs. */
     recorders?: Array<{
         id: string;
         name: string;
+        description?: string;
+        preferredOperation?: 'translate' | 'accumulate' | 'aggregate';
         data: unknown;
     }>;
 }

package/dist/index.d.ts

@@ -367,10 +367,12 @@ interface RuntimeSnapshotInput {
     executionTree: unknown;
     commitLog: unknown[];
     subflowResults?: Record<string, unknown>;
-    /** Recorder snapshots from FlowRecorder.toSnapshot() — auto-generates detail tabs. */
+    /** Recorder snapshots from toSnapshot() — auto-generates detail tabs. */
     recorders?: Array<{
         id: string;
         name: string;
+        description?: string;
+        preferredOperation?: 'translate' | 'accumulate' | 'aggregate';
         data: unknown;
     }>;
 }

package/dist/index.js

@@ -4065,6 +4065,7 @@ function findNumericField(entry) {
 function KeyedRecorderView({
   data,
   description,
+  preferredOperation = "accumulate",
   snapshots,
   selectedIndex
 }) {
@@ -4107,6 +4108,55 @@ function KeyedRecorderView({
   return /* @__PURE__ */ jsxs17("div", { style: { overflow: "auto", height: "100%", display: "flex", flexDirection: "column" }, children: [
     description && /* @__PURE__ */ jsx18("div", { style: { padding: "6px 12px", fontSize: 11, color: theme.textMuted, fontStyle: "italic", borderBottom: `1px solid ${theme.border}`, flexShrink: 0 }, children: description }),
     /* @__PURE__ */ jsxs17("div", { style: { padding: 12, flex: 1, overflow: "auto" }, children: [
+      preferredOperation === "aggregate" ? (
+        /* AGGREGATE primary: show grand total prominently, per-step expandable */
+        /* @__PURE__ */ jsxs17(Fragment6, { children: [
+          isAtEnd ? /* @__PURE__ */ jsxs17("div", { style: { padding: "12px 14px", background: `color-mix(in srgb, ${theme.success} 12%, transparent)`, borderRadius: 6, border: `1px solid ${theme.success}44`, marginBottom: 16 }, children: [
+            /* @__PURE__ */ jsx18("div", { style: { fontSize: 10, color: theme.textMuted, textTransform: "uppercase", letterSpacing: "0.08em", marginBottom: 4, fontWeight: 600 }, children: "Aggregate \u2014 grand total" }),
+            numFieldKey && /* @__PURE__ */ jsxs17("div", { style: { fontSize: 22, fontWeight: 700, color: theme.success }, children: [
+              grandTotal < 1 ? grandTotal.toFixed(3) : grandTotal.toFixed(1),
+              /* @__PURE__ */ jsxs17("span", { style: { fontSize: 11, color: theme.textMuted, fontWeight: 400, marginLeft: 8 }, children: [
+                numFieldKey,
+                " \xB7 ",
+                allKeys.length,
+                " steps"
+              ] })
+            ] })
+          ] }) : /* @__PURE__ */ jsxs17("div", { style: { padding: "8px 12px", background: `color-mix(in srgb, ${theme.primary} 8%, transparent)`, borderRadius: 6, marginBottom: 16 }, children: [
+            /* @__PURE__ */ jsx18("div", { style: { fontSize: 10, color: theme.textMuted, textTransform: "uppercase", letterSpacing: "0.08em", marginBottom: 4, fontWeight: 600 }, children: "Accumulate \u2014 running total" }),
+            numFieldKey && /* @__PURE__ */ jsxs17("span", { style: { fontWeight: 700, fontSize: 16, color: theme.primary }, children: [
+              runningTotal < 1 ? runningTotal.toFixed(3) : runningTotal.toFixed(1),
+              /* @__PURE__ */ jsxs17("span", { style: { fontSize: 10, color: theme.textMuted, fontWeight: 400, marginLeft: 8 }, children: [
+                visibleEntries.length,
+                " of ",
+                allKeys.length,
+                " steps"
+              ] })
+            ] })
+          ] }),
+          /* @__PURE__ */ jsx18("div", { style: { fontSize: 10, color: theme.textMuted, textTransform: "uppercase", letterSpacing: "0.08em", marginBottom: 6, fontWeight: 600 }, children: "Per-step detail" })
+        ] })
+      ) : preferredOperation === "accumulate" ? (
+        /* ACCUMULATE primary: running total prominent, per-step listed */
+        /* @__PURE__ */ jsxs17(Fragment6, { children: [
+          numFieldKey && visibleEntries.length > 0 && /* @__PURE__ */ jsxs17("div", { style: { padding: "10px 14px", background: `color-mix(in srgb, ${theme.primary} 8%, transparent)`, borderRadius: 6, marginBottom: 16 }, children: [
+            /* @__PURE__ */ jsx18("div", { style: { fontSize: 10, color: theme.textMuted, textTransform: "uppercase", letterSpacing: "0.08em", marginBottom: 4, fontWeight: 600 }, children: "Accumulate \u2014 running total up to this step" }),
+            /* @__PURE__ */ jsx18("span", { style: { fontWeight: 700, fontSize: 18, color: theme.primary }, children: runningTotal < 1 ? runningTotal.toFixed(3) : runningTotal.toFixed(1) }),
+            /* @__PURE__ */ jsxs17("span", { style: { color: theme.textMuted, marginLeft: 8, fontSize: 10 }, children: [
+              numFieldKey,
+              " \xB7 ",
+              visibleEntries.length,
+              " of ",
+              allKeys.length,
+              " steps"
+            ] })
+          ] }),
+          /* @__PURE__ */ jsx18("div", { style: { fontSize: 10, color: theme.textMuted, textTransform: "uppercase", letterSpacing: "0.08em", marginBottom: 6, fontWeight: 600 }, children: "Per-step detail" })
+        ] })
+      ) : (
+        /* TRANSLATE primary: per-step entries prominent */
+        /* @__PURE__ */ jsx18("div", { style: { fontSize: 10, color: theme.textMuted, textTransform: "uppercase", letterSpacing: "0.08em", marginBottom: 6, fontWeight: 600 }, children: "Translate \u2014 per-step detail" })
+      ),
       visibleEntries.map((key) => {
         const entry = steps[key];
         const label = entry.stageName ?? key;
@@ -4118,22 +4168,7 @@ function KeyedRecorderView({
         ] }, key);
       }),
       visibleEntries.length === 0 && /* @__PURE__ */ jsx18("div", { style: { color: theme.textMuted, fontSize: 11, fontStyle: "italic", padding: "8px 0" }, children: "Scrub the slider to reveal entries..." }),
-      numFieldKey && visibleEntries.length > 0 && /* @__PURE__ */ jsxs17("div", { style: { marginTop: 12, padding: "8px 12px", background: `color-mix(in srgb, ${theme.primary} 8%, transparent)`, borderRadius: 6, fontSize: 12 }, children: [
-        /* @__PURE__ */ jsxs17("span", { style: { color: theme.textMuted }, children: [
-          "Running total (",
-          numFieldKey,
-          "):"
-        ] }),
-        /* @__PURE__ */ jsx18("span", { style: { fontWeight: 700, marginLeft: 8, color: theme.primary }, children: runningTotal < 1 ? runningTotal.toFixed(3) : runningTotal.toFixed(1) }),
-        /* @__PURE__ */ jsxs17("span", { style: { color: theme.textMuted, marginLeft: 8, fontSize: 10 }, children: [
-          "(",
-          visibleEntries.length,
-          " of ",
-          allKeys.length,
-          " steps)"
-        ] })
-      ] }),
-      isAtEnd && numFieldKey && /* @__PURE__ */ jsx18("div", { style: { marginTop: 12 }, children: !showAggregate ? /* @__PURE__ */ jsxs17(
+      preferredOperation === "accumulate" && isAtEnd && numFieldKey && /* @__PURE__ */ jsx18("div", { style: { marginTop: 16 }, children: !showAggregate ? /* @__PURE__ */ jsx18(
         "button",
         {
           onClick: () => setShowAggregate(true),
@@ -4142,21 +4177,18 @@ function KeyedRecorderView({
             color: "#fff",
             border: "none",
             borderRadius: 6,
-            padding: "8px 16px",
+            padding: "10px 20px",
             fontSize: 12,
             fontWeight: 600,
             cursor: "pointer",
-            fontFamily: "inherit"
+            fontFamily: "inherit",
+            width: "100%"
           },
-          children: [
-            "Aggregate (",
-            numFieldKey,
-            ")"
-          ]
+          children: "Show Aggregate \u2014 Grand Total"
         }
       ) : /* @__PURE__ */ jsxs17("div", { style: { padding: "10px 14px", background: `color-mix(in srgb, ${theme.success} 12%, transparent)`, borderRadius: 6, border: `1px solid ${theme.success}44` }, children: [
-        /* @__PURE__ */ jsx18("div", { style: { fontSize: 10, color: theme.textMuted, textTransform: "uppercase", letterSpacing: "0.08em", marginBottom: 4 }, children: "Aggregate \u2014 Grand Total" }),
-        /* @__PURE__ */ jsx18("div", { style: { fontSize: 20, fontWeight: 700, color: theme.success }, children: grandTotal < 1 ? grandTotal.toFixed(3) : grandTotal.toFixed(1) }),
+        /* @__PURE__ */ jsx18("div", { style: { fontSize: 10, color: theme.textMuted, textTransform: "uppercase", letterSpacing: "0.08em", marginBottom: 4, fontWeight: 600 }, children: "Aggregate \u2014 grand total" }),
+        /* @__PURE__ */ jsx18("div", { style: { fontSize: 22, fontWeight: 700, color: theme.success }, children: grandTotal < 1 ? grandTotal.toFixed(3) : grandTotal.toFixed(1) }),
         /* @__PURE__ */ jsxs17("div", { style: { fontSize: 10, color: theme.textMuted, marginTop: 2 }, children: [
           allKeys.length,
           " steps \xB7 ",
@@ -4333,7 +4365,7 @@ function ExplainableShell({
     const recorders = runtimeSnapshot?.recorders;
     if (!recorders?.length) return [];
     const explicitIds = new Set((recorderViews ?? []).map((v2) => v2.id));
-    return recorders.filter((r) => !explicitIds.has(r.id)).map((r) => ({ id: r.id, name: r.name, description: r.description, data: r.data }));
+    return recorders.filter((r) => !explicitIds.has(r.id)).map((r) => ({ id: r.id, name: r.name, description: r.description, preferredOperation: r.preferredOperation, data: r.data }));
   }, [runtimeSnapshot, recorderViews]);
   const hasNarrative = !!(narrative?.length || narrativeEntries?.length);
   const allTabs = useMemo11(() => {
@@ -4515,6 +4547,7 @@ function ExplainableShell({
         {
           data: autoView.data,
           description: autoView.description,
+          preferredOperation: autoView.preferredOperation,
           snapshots: activeSnapshots,
           selectedIndex: safeIdx
         }