@burdenoff/fluidgrids-fe-sdk 2026.1105.2 → 2026.1105.3

package/README.md

@@ -229,6 +229,36 @@ const register = (spec: FgPageControlsSpec) => registerWithMyAssistant(spec);
   / `TabsSpec` (fe-libs >= 2026.1004.6 `appControls`), so a host can pass them
   straight to `enumFilter` / `tabsOf`.
 
+## Read-only workflow preview (optional)
+
+`WorkflowPreviewCanvas` draws a stored workflow definition with the builder's own
+node cards, read-only, and animates it as a workflow is built live (the AI
+assistant's live preview). It needs no `FluidGridsProvider`, config, Apollo client
+or node registry, and makes no request of its own.
+
+```tsx
+import { WorkflowPreviewCanvas, previewCanvasFromDefinition, previewRevealOrder } from "@burdenoff/fluidgrids-fe-sdk/workflow-preview";
+
+<div style={{ height: 520 }}>
+  <WorkflowPreviewCanvas
+    definition={workflow.definitionJson} // object or JSON string
+    visibleNodeIds={shown}               // omit to show every node
+    freshNodeIds={justAdded}             // highlighted with a ring
+    running={assistantIsWriting}         // flow along edges, newest node pulses
+  />
+</div>
+```
+
+- The host drives the reveal: `previewRevealOrder(previewCanvasFromDefinition(def).nodes)`
+  gives the along-the-flow order. A node that becomes visible pops in, an edge
+  draws in once both ends are visible, and the camera eases to keep every
+  visible node in view (max zoom 1.5).
+- `resolveNodeMeta(nodeType)` (optional, keep it stable) supplies registry names
+  and icons; without it a card uses the node's saved manifest, then a name and
+  icon derived from its type.
+- Nodes cannot be dragged, connected, selected or deleted; pan and zoom work.
+- `prefers-reduced-motion: reduce` turns every animation off.
+
 ## Styling
 
 The SDK uses Tailwind CSS for styling. Make sure you have Tailwind configured in your project, or import the pre-built styles:

package/dist/{ExecutionDetailPage-HQB2SWBP.js → ExecutionDetailPage-JXGPSLS3.js}

@@ -1,7 +1,7 @@
-export { ExecutionDetailPage } from './chunk-3XUWPDKJ.js';
-import './chunk-QFC6E3WD.js';
-import './chunk-CNKTQ5MG.js';
-import './chunk-J3YQCEP3.js';
+export { ExecutionDetailPage } from './chunk-3ZYRLGDF.js';
+import './chunk-2WUVF4EQ.js';
+import './chunk-MA6I4KY5.js';
+import './chunk-VESQH55Q.js';
 import './chunk-TCIBTMJI.js';
 import './chunk-NZAYYUQ4.js';
 import './chunk-AMXJLVZN.js';
@@ -12,13 +12,15 @@ import './chunk-JDLQ6QIB.js';
 import './chunk-IL343FKX.js';
 import './chunk-Y53CVZVV.js';
 import './chunk-FNZZ5JJL.js';
-import './chunk-QFGZXWTM.js';
+import './chunk-YGOGJDN4.js';
 import './chunk-PJAWNFJV.js';
 import './chunk-H4ERTSMX.js';
-import './chunk-3QCRKKTI.js';
+import './chunk-ZBPRNWKY.js';
 import './chunk-5375NUIO.js';
 import './chunk-JL7CASN5.js';
-import './chunk-OCJTTHTS.js';
+import './chunk-SDZEAIIE.js';
+import './chunk-5DVP2UYH.js';
+import './chunk-Y7FKJJMF.js';
 import './chunk-AU7LACOY.js';
 import './chunk-G77IGC3Y.js';
 import './chunk-Z3ABLERJ.js';

package/dist/{ExecutionsListPage-RSLL634L.js → ExecutionsListPage-U3TC5JUI.js}

@@ -1,18 +1,20 @@
-export { ExecutionsListPage } from './chunk-HK76ZUAK.js';
-import './chunk-CNKTQ5MG.js';
-import './chunk-J3YQCEP3.js';
+export { ExecutionsListPage } from './chunk-NZFPCTIS.js';
+import './chunk-MA6I4KY5.js';
+import './chunk-VESQH55Q.js';
 import './chunk-WZ3EJVS6.js';
 import './chunk-5ERAJC2I.js';
 import './chunk-IL343FKX.js';
 import './chunk-FNZZ5JJL.js';
-import './chunk-QFGZXWTM.js';
+import './chunk-YGOGJDN4.js';
 import './chunk-PJAWNFJV.js';
 import './chunk-H4ERTSMX.js';
 import './chunk-4VJ3MDOV.js';
-import './chunk-3QCRKKTI.js';
+import './chunk-ZBPRNWKY.js';
 import './chunk-5375NUIO.js';
 import './chunk-JL7CASN5.js';
-import './chunk-OCJTTHTS.js';
+import './chunk-SDZEAIIE.js';
+import './chunk-5DVP2UYH.js';
+import './chunk-Y7FKJJMF.js';
 import './chunk-AU7LACOY.js';
 import './chunk-G77IGC3Y.js';
 import './chunk-Z3ABLERJ.js';

package/dist/{WorkflowBuilder-E3PNZX74.js → WorkflowBuilder-6DOD6WWH.js}

@@ -1,28 +1,31 @@
-export { WorkflowBuilder } from './chunk-TNFBRXU7.js';
-import './chunk-Y6M7K4UG.js';
+export { WorkflowBuilder } from './chunk-TLHX4DK4.js';
+import './chunk-FVWRGL7S.js';
 import './chunk-PIKYQE7P.js';
-import './chunk-62CCBMDC.js';
+import './chunk-NMQENSPW.js';
+import './chunk-3MZOYJ5I.js';
 import './chunk-GEMNVFPK.js';
 import './chunk-B6CCE2RW.js';
 import './chunk-IEVSFCFS.js';
 import './chunk-YXMFRQYV.js';
 import './chunk-BQXVT32O.js';
-import './chunk-6ZK4MRVA.js';
-import './chunk-W5WML3OO.js';
-import './chunk-GKFMK7FF.js';
+import './chunk-MY7SEUXM.js';
+import './chunk-KAWRHIJZ.js';
 import './chunk-EYQ7GJRW.js';
 import './chunk-JDLQ6QIB.js';
 import './chunk-IL343FKX.js';
 import './chunk-Y53CVZVV.js';
-import './chunk-64JN2TVX.js';
-import './chunk-QFGZXWTM.js';
+import './chunk-TJAG2DQT.js';
+import './chunk-JYYN3CLL.js';
+import './chunk-YGOGJDN4.js';
 import './chunk-GLYINMOR.js';
 import './chunk-H4ERTSMX.js';
 import './chunk-4VJ3MDOV.js';
-import './chunk-3QCRKKTI.js';
+import './chunk-ZBPRNWKY.js';
 import './chunk-5375NUIO.js';
 import './chunk-JL7CASN5.js';
-import './chunk-OCJTTHTS.js';
+import './chunk-SDZEAIIE.js';
+import './chunk-5DVP2UYH.js';
+import './chunk-Y7FKJJMF.js';
 import './chunk-AU7LACOY.js';
 import './chunk-G77IGC3Y.js';
 import './chunk-Z3ABLERJ.js';

package/dist/{WorkflowsList-473FRRP2.js → WorkflowsList-XOWRQNST.js}

@@ -1,17 +1,19 @@
-export { WorkflowsList } from './chunk-5CFCFA6O.js';
-import './chunk-Y6M7K4UG.js';
-import './chunk-J3YQCEP3.js';
+export { WorkflowsList } from './chunk-IJ7UIDCW.js';
+import './chunk-FVWRGL7S.js';
+import './chunk-VESQH55Q.js';
 import './chunk-5ERAJC2I.js';
-import './chunk-GKFMK7FF.js';
+import './chunk-KAWRHIJZ.js';
 import './chunk-FNZZ5JJL.js';
-import './chunk-QFGZXWTM.js';
+import './chunk-YGOGJDN4.js';
 import './chunk-PJAWNFJV.js';
 import './chunk-H4ERTSMX.js';
 import './chunk-4VJ3MDOV.js';
-import './chunk-3QCRKKTI.js';
+import './chunk-ZBPRNWKY.js';
 import './chunk-5375NUIO.js';
 import './chunk-JL7CASN5.js';
-import './chunk-OCJTTHTS.js';
+import './chunk-SDZEAIIE.js';
+import './chunk-5DVP2UYH.js';
+import './chunk-Y7FKJJMF.js';
 import './chunk-AU7LACOY.js';
 import './chunk-G77IGC3Y.js';
 import './chunk-Z3ABLERJ.js';

package/dist/{agentTools-5N3ZEZDW.js → agentTools-YQBN33WG.js}

@@ -1,9 +1,11 @@
-import { nodeTitle, selectedOperationOf, paramsFromOperation, fixedParameterState } from './chunk-AJVU5YW6.js';
-import { computeAttachPosition } from './chunk-W5WML3OO.js';
-import { NODE_CONFIGS, createConfiguredNode, resolveOutputHandles, resolveInputHandles, isNodeConfigsInitialized, useFlowStore, useSaveStatusStore, autosaveAllowedFor, isFlowComplete, isNodeTypeHiddenFromPalette } from './chunk-3QCRKKTI.js';
+import { nodeTitle, selectedOperationOf, paramsFromOperation, fixedParameterState } from './chunk-ZLBTUCC2.js';
+import { computeAttachPosition } from './chunk-3MZOYJ5I.js';
+import { NODE_CONFIGS, createConfiguredNode, isNodeConfigsInitialized, useSaveStatusStore, autosaveAllowedFor, isFlowComplete, isNodeTypeHiddenFromPalette } from './chunk-ZBPRNWKY.js';
 import './chunk-5375NUIO.js';
 import './chunk-JL7CASN5.js';
-import './chunk-OCJTTHTS.js';
+import './chunk-SDZEAIIE.js';
+import { resolveOutputHandles, resolveInputHandles, useFlowStore } from './chunk-5DVP2UYH.js';
+import './chunk-Y7FKJJMF.js';
 import './chunk-AU7LACOY.js';
 import './chunk-G77IGC3Y.js';
 import './chunk-Z3ABLERJ.js';

package/dist/{chunk-XFH6SLDK.js → chunk-22U3TUKZ.js}

@@ -1,5 +1,5 @@
 import { emptyAgentForm, agentToForm, describeRule, formToInput, AgentFormError, DEFAULT_GRANT_DAYS, MAX_GRANT_DAYS, grantDays } from './chunk-WZ3EJVS6.js';
-import { useAgentDefinitions, useAgentDefinitionList, useConnections } from './chunk-3QCRKKTI.js';
+import { useAgentDefinitions, useAgentDefinitionList, useConnections } from './chunk-ZBPRNWKY.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { describeOperationError } from './chunk-US5QSLPV.js';
 import { useState, useCallback, useEffect } from 'react';

package/dist/{chunk-QFC6E3WD.js → chunk-2WUVF4EQ.js}

@@ -1,4 +1,4 @@
-import { signalPayloadCard, components_default, payloadFromCardValues, parseRawSignalPayload } from './chunk-3QCRKKTI.js';
+import { signalPayloadCard, components_default, payloadFromCardValues, parseRawSignalPayload } from './chunk-ZBPRNWKY.js';
 import { TerminateWorkflowRunDocument, WorkflowRunHistoryDocument, RunEventAppendedDocument, DurableRunFieldsDocument, WorkflowRunDeterminismStatusDocument, WorkflowRunStackTraceDocument, SignalWorkflowRunDocument } from './chunk-Z3ABLERJ.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { getFluidGridsClient, getFluidGridsClientSafe } from './chunk-3IXU7WUC.js';

package/dist/{chunk-W5WML3OO.js → chunk-3MZOYJ5I.js}

@@ -1,4 +1,4 @@
-import { resolveInputHandles } from './chunk-3QCRKKTI.js';
+import { resolveInputHandles } from './chunk-5DVP2UYH.js';
 
 // src/builder/hooks/attach-node-helpers.ts
 var ATTACH_GAP_X = 120;

package/dist/{chunk-3XUWPDKJ.js → chunk-3ZYRLGDF.js}

@@ -1,14 +1,14 @@
-import { useDurableRunFields, useRunHistory, useDeterminismStatus, useRunStackTrace, RunHistoryView, SignalRunDialog, terminateDurableRun } from './chunk-QFC6E3WD.js';
-import { useDurableParityRunFields, hasAgentNodeState, agentNodeTraces, orderNodesByExecution, useRunMetadata, useRunPending, ExecutionStatusBadge, NodeTimeline, RunLogViewer, NodeStatusBadge, setRunVersioningOverride } from './chunk-CNKTQ5MG.js';
-import { useExecution, useExecutionActions, useAutoRefresh, runChainLinks, shortRunId, callbackTone, parseMetadataDefinition, overrideRequestOf } from './chunk-J3YQCEP3.js';
+import { useDurableRunFields, useRunHistory, useDeterminismStatus, useRunStackTrace, RunHistoryView, SignalRunDialog, terminateDurableRun } from './chunk-2WUVF4EQ.js';
+import { useDurableParityRunFields, hasAgentNodeState, agentNodeTraces, orderNodesByExecution, useRunMetadata, useRunPending, ExecutionStatusBadge, NodeTimeline, RunLogViewer, NodeStatusBadge, setRunVersioningOverride } from './chunk-MA6I4KY5.js';
+import { useExecution, useExecutionActions, useAutoRefresh, runChainLinks, shortRunId, callbackTone, parseMetadataDefinition, overrideRequestOf } from './chunk-VESQH55Q.js';
 import { fetchRunFailureClusters, OPEN_STATUSES, dismissRunFailureCluster, BUCKET_LABELS, formatDuration } from './chunk-TCIBTMJI.js';
 import { aiCost, formatTokens, modelLabel } from './chunk-NZAYYUQ4.js';
 import { useRunPolicyDecisions, RunPolicyDecisions } from './chunk-AMXJLVZN.js';
 import { EntityTagPicker, canSaveRunAsTestCase, useWorkflowProposal, WorkflowProposalCard, MAX_CASE_NAME, saveRunAsTestCase } from './chunk-EYQ7GJRW.js';
 import { buildNodeDisplayMap, formatRunVersion, nodeDisplayTitle } from './chunk-IL343FKX.js';
 import { AiCreditBalanceSlot } from './chunk-Y53CVZVV.js';
-import { useWorkflowVersions } from './chunk-QFGZXWTM.js';
-import { useDurableFunctionNodesEnabled, useDurableParityEnabled, runSignalTargets, canSignalRun, useWorkflowTestsEnabled } from './chunk-3QCRKKTI.js';
+import { useWorkflowVersions } from './chunk-YGOGJDN4.js';
+import { useDurableFunctionNodesEnabled, useDurableParityEnabled, runSignalTargets, canSignalRun, useWorkflowTestsEnabled } from './chunk-ZBPRNWKY.js';
 import { useFluidGridsPermission, FLUIDGRIDS_PERMISSIONS, SdkPermissionButton } from './chunk-5375NUIO.js';
 import { RunLogsDocument, RunLogAppendedDocument, ExplainRunDocument, RunAiUsageDocument } from './chunk-Z3ABLERJ.js';
 import { useTr } from './chunk-UULVIT25.js';

package/dist/{chunk-SALZ3LQB.js → chunk-4NNF7DIB.js}

@@ -1,5 +1,5 @@
 import { LOG_STREAM_DESTINATIONS, CREATE_LOG_STREAM_DESTINATION, UPDATE_LOG_STREAM_DESTINATION, DELETE_LOG_STREAM_DESTINATION, TEST_LOG_STREAM_DESTINATION, REPLAY_WORKFLOW_RUN, RETRY_WORKFLOW_RUNS, OBSERVABILITY_DASHBOARD_SUMMARY, OBSERVABILITY_FAILED_RUNS, OBSERVABILITY_DATA_SINKS, OBSERVABILITY_DATA_SINK_DATA } from './chunk-5ERAJC2I.js';
-import { useFluidGridsAnalytics, emitRunStarted, openRunQuotaUpgradePrompt, useFluidGridsFlag, FLUIDGRIDS_FLAGS } from './chunk-3QCRKKTI.js';
+import { useFluidGridsAnalytics, emitRunStarted, openRunQuotaUpgradePrompt, useFluidGridsFlag, FLUIDGRIDS_FLAGS } from './chunk-ZBPRNWKY.js';
 import { useTr } from './chunk-UULVIT25.js';
 import { getFluidGridsClient } from './chunk-3IXU7WUC.js';
 import { throwIfResultError, describeOperationError, emitFluidGridsEvent } from './chunk-US5QSLPV.js';