@geenius/ai-workflow 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -54,6 +54,12 @@ declare function useApprovalGate(): UseApprovalGateResult;
54
54
 
55
55
  /**
56
56
  * Runtime integrations accepted by the plain-CSS workflow hook.
57
+ *
58
+ * @property callLLM Optional LLM execution callback inherited from `WorkflowEngineOptions`.
59
+ * @property callWebhook Optional webhook execution callback inherited from `WorkflowEngineOptions`.
60
+ * @property onApprovalRequired Optional approval callback inherited from `WorkflowEngineOptions`.
61
+ * @property onStepComplete Optional per-step completion callback inherited from `WorkflowEngineOptions`.
62
+ * @property customHandlers Optional custom step-handler registry inherited from `WorkflowEngineOptions`.
57
63
  */
58
64
  interface UseWorkflowOptions extends WorkflowEngineOptions {
59
65
  }
@@ -214,11 +220,20 @@ declare function useWorkflowTemplates(userId: string): UseWorkflowTemplatesResul
214
220
 
215
221
  /**
216
222
  * Props for the workflow canvas component.
223
+ *
224
+ * @property definition Shared workflow definition to render.
225
+ * @property selectedStepId Currently selected step identifier.
226
+ * @property onSelectStep Callback used to change the selected step.
227
+ * @property onMoveStep Reserved callback for future drag interactions.
217
228
  */
218
229
  interface WorkflowCanvasProps {
219
230
  definition: WorkflowDefinition;
220
231
  selectedStepId: string | null;
221
232
  onSelectStep: (id: string | null) => void;
233
+ onMoveStep?: (stepId: string, pos: {
234
+ x: number;
235
+ y: number;
236
+ }) => void;
222
237
  }
223
238
  /**
224
239
  * Render the builder canvas with positioned steps and connection lines.
@@ -269,6 +284,11 @@ declare function StepNode(props: StepNodeProps): ReactElement;
269
284
 
270
285
  /**
271
286
  * Props for a workflow step connector path.
287
+ *
288
+ * @property from Starting node position for the connector.
289
+ * @property to Ending node position for the connector.
290
+ * @property label Optional inline label rendered above the curve.
291
+ * @property isActive Whether the connector should use the emphasized active style.
272
292
  */
273
293
  interface StepConnectorProps {
274
294
  from: {
@@ -356,6 +376,11 @@ declare function WorkflowRunPanel(props: WorkflowRunPanelProps): ReactElement;
356
376
 
357
377
  /**
358
378
  * Props for the plain-CSS approval dialog.
379
+ *
380
+ * @property request Pending approval request to render, or `null` when idle.
381
+ * @property onApprove Callback that approves the active request by id.
382
+ * @property onReject Callback that rejects the active request by id.
383
+ * @property onDismiss Optional callback used for Escape-key and dismiss flows.
359
384
  */
360
385
  interface ApprovalModalProps {
361
386
  request: ApprovalRequest | null;
@@ -381,6 +406,19 @@ declare function ApprovalModal(props: ApprovalModalProps): ReactElement | null;
381
406
 
382
407
  /**
383
408
  * Props for the workflow toolbar action surface.
409
+ *
410
+ * @property workflowName Human-readable workflow name shown in the title slot.
411
+ * @property isDirty Whether unsaved edits are currently present.
412
+ * @property isRunning Whether a run is currently active.
413
+ * @property canUndo Whether the undo action should be enabled.
414
+ * @property canRedo Whether the redo action should be enabled.
415
+ * @property onSave Callback that persists the current workflow definition.
416
+ * @property onRun Callback that starts a workflow run.
417
+ * @property onCancel Optional callback that stops an in-flight run.
418
+ * @property onUndo Callback that restores the previous builder snapshot.
419
+ * @property onRedo Callback that reapplies the next builder snapshot.
420
+ * @property onExport Optional callback that exports the workflow definition.
421
+ * @property className Optional class-name override for the toolbar container.
384
422
  */
385
423
  interface WorkflowToolbarProps {
386
424
  workflowName: string;
@@ -492,4 +530,4 @@ interface WorkflowRunsPageProps {
492
530
  */
493
531
  declare function WorkflowRunsPage(props: WorkflowRunsPageProps): ReactElement;
494
532
 
495
- export { ApprovalModal, type ApprovalModalProps, type ApprovalRequest, StepConfigPanel, type StepConfigPanelProps, StepConnector, StepNode, type StepNodeProps, StepPalette, type StepPaletteProps, type UseWorkflowOptions, type UseWorkflowRunOptions, WorkflowBuilderPage, type WorkflowBuilderPageProps, WorkflowCanvas, WorkflowRunPanel, type WorkflowRunPanelProps, WorkflowRunsPage, type WorkflowRunsPageProps, WorkflowToolbar, useApprovalGate, useWorkflow, useWorkflowBuilder, useWorkflowRun, useWorkflowStep, useWorkflowTemplates };
533
+ export { ApprovalModal, type ApprovalModalProps, type ApprovalRequest, StepConfigPanel, type StepConfigPanelProps, StepConnector, type StepConnectorProps, StepNode, type StepNodeProps, StepPalette, type StepPaletteProps, type UseWorkflowOptions, type UseWorkflowRunOptions, WorkflowBuilderPage, type WorkflowBuilderPageProps, WorkflowCanvas, type WorkflowCanvasProps, WorkflowRunPanel, type WorkflowRunPanelProps, WorkflowRunsPage, type WorkflowRunsPageProps, WorkflowToolbar, type WorkflowToolbarProps, useApprovalGate, useWorkflow, useWorkflowBuilder, useWorkflowRun, useWorkflowStep, useWorkflowTemplates };