@geenius/ai-workflow 0.4.0 → 0.5.0

package/packages/solidjs/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { WorkflowEngineOptions, WorkflowDefinition, WorkflowRun, WorkflowError, StepResult, WorkflowBuilderState, WorkflowStepDef, StepConnection, RunStatus, StepStatus, WorkflowTemplate, StepType } from '@geenius/ai-workflow-shared';
-export { RunStatus, StepConfig, StepResult, StepStatus, StepType, WORKFLOW_TEMPLATES, WorkflowBuilderState, WorkflowDefinition, WorkflowEngine, WorkflowRun, WorkflowStatus, WorkflowStepDef, validateWorkflow } from '@geenius/ai-workflow-shared';
+export { RunStatus, StepConfig, StepResult, StepStatus, StepType, WORKFLOW_TEMPLATES, WorkflowBuilderState, WorkflowDefinition, WorkflowEngine, WorkflowRun, WorkflowStatus, WorkflowStepDef, getTemplate, getTemplatesByCategory, validateRun, validateWorkflow } from '@geenius/ai-workflow-shared';
 import { JSX, JSXElement } from 'solid-js';
 
 /**
@@ -12,6 +12,12 @@ import { JSX, JSXElement } from 'solid-js';
 
 /**
  * Runtime integrations accepted by the SolidJS workflow primitive.
+ *
+ * @property callLLM Optional LLM execution callback inherited from `WorkflowEngineOptions`.
+ * @property callWebhook Optional webhook execution callback inherited from `WorkflowEngineOptions`.
+ * @property onApprovalRequired Optional approval callback inherited from `WorkflowEngineOptions`.
+ * @property onStepComplete Optional per-step completion callback inherited from `WorkflowEngineOptions`.
+ * @property customHandlers Optional custom step-handler registry inherited from `WorkflowEngineOptions`.
  */
 interface CreateWorkflowOptions extends WorkflowEngineOptions {
 }
@@ -134,6 +140,12 @@ declare function createWorkflowStep(stepDef: WorkflowStepDef): {
  */
 /**
  * Pending approval request exposed to the UI layer.
+ *
+ * @property id Stable approval-request identifier.
+ * @property stepId Workflow step awaiting the operator decision.
+ * @property message Approval prompt shown to the operator.
+ * @property requestedAt Unix timestamp for when the approval was created.
+ * @property approvers Optional list of users or roles allowed to approve.
  */
 interface ApprovalRequest {
     id: string;
@@ -194,11 +206,16 @@ declare function createWorkflowTemplates(userId: string): {
  * @property definition Shared workflow definition to render.
  * @property selectedStepId Currently selected step identifier.
  * @property onSelectStep Callback used to change the selected step.
+ * @property onMoveStep Reserved callback for future drag interactions.
  */
 interface WorkflowCanvasProps {
     definition: WorkflowDefinition;
     selectedStepId: string | null;
     onSelectStep: (id: string | null) => void;
+    onMoveStep?: (stepId: string, pos: {
+        x: number;
+        y: number;
+    }) => void;
 }
 /**
  * Render a workflow canvas with connectors, nodes, and an empty state.
@@ -241,6 +258,11 @@ declare function StepNode(props: StepNodeProps): JSX.Element;
 
 /**
  * Props for a workflow step connector path.
+ *
+ * @property from Starting node position for the connector.
+ * @property to Ending node position for the connector.
+ * @property label Optional inline label rendered above the curve.
+ * @property isActive Whether the connector should use the emphasized active style.
  */
 interface StepConnectorProps {
     from: {
@@ -320,6 +342,11 @@ declare function WorkflowRunPanel(props: WorkflowRunPanelProps): JSX.Element;
 
 /**
  * Props for the SolidJS approval dialog.
+ *
+ * @property request Pending approval request to render, or `null` when idle.
+ * @property onApprove Callback that approves the active request by id.
+ * @property onReject Callback that rejects the active request by id.
+ * @property onDismiss Optional callback used for Escape-key and dismiss flows.
  */
 interface ApprovalModalProps {
     request: ApprovalRequest | null;
@@ -345,6 +372,19 @@ declare function ApprovalModal(props: ApprovalModalProps): JSX.Element;
 
 /**
  * Props for the workflow toolbar action surface.
+ *
+ * @property workflowName Human-readable workflow name shown in the title slot.
+ * @property isDirty Whether unsaved edits are currently present.
+ * @property isRunning Whether a run is currently active.
+ * @property canUndo Whether the undo action should be enabled.
+ * @property canRedo Whether the redo action should be enabled.
+ * @property onSave Callback that persists the current workflow definition.
+ * @property onRun Callback that starts a workflow run.
+ * @property onCancel Optional callback that stops an in-flight run.
+ * @property onUndo Callback that restores the previous builder snapshot.
+ * @property onRedo Callback that reapplies the next builder snapshot.
+ * @property onExport Optional callback that exports the workflow definition.
+ * @property class Optional class-name override for the toolbar container.
  */
 interface WorkflowToolbarProps {
     workflowName: string;
@@ -449,4 +489,4 @@ interface WorkflowRunsPageProps {
  */
 declare function WorkflowRunsPage(props: WorkflowRunsPageProps): JSX.Element;
 
-export { ApprovalModal, type ApprovalModalProps, type ApprovalRequest, StepConfigPanel, type StepConfigPanelProps, StepConnector, StepNode, type StepNodeProps, StepPalette, type StepPaletteProps, WorkflowBuilderPage, type WorkflowBuilderPageProps, WorkflowCanvas, WorkflowRunPanel, type WorkflowRunPanelProps, WorkflowRunsPage, type WorkflowRunsPageProps, WorkflowToolbar, createApprovalGate, createWorkflow, createWorkflowBuilder, createWorkflowRun, createWorkflowStep, createWorkflowTemplates };
+export { ApprovalModal, type ApprovalModalProps, type ApprovalRequest, StepConfigPanel, type StepConfigPanelProps, StepConnector, type StepConnectorProps, StepNode, type StepNodeProps, StepPalette, type StepPaletteProps, WorkflowBuilderPage, type WorkflowBuilderPageProps, WorkflowCanvas, type WorkflowCanvasProps, WorkflowRunPanel, type WorkflowRunPanelProps, WorkflowRunsPage, type WorkflowRunsPageProps, WorkflowToolbar, type WorkflowToolbarProps, createApprovalGate, createWorkflow, createWorkflowBuilder, createWorkflowRun, createWorkflowStep, createWorkflowTemplates };