@cyoda/workflow-react 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -1,8 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { WorkflowEditorDocument, SaveStatus, WorkflowApi, ConcurrencyToken, ImportMode } from '@cyoda/workflow-core';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { WorkflowEditorDocument, WorkflowUiMeta, EntityFieldHintProvider, SaveStatus, WorkflowApi, ConcurrencyToken, ImportMode } from '@cyoda/workflow-core';
+export { EntityFieldHintProvider, FieldHint } from '@cyoda/workflow-core';
 import { LayoutOptions } from '@cyoda/workflow-layout';
 export { LayoutOptions, LayoutPreset, PinnedNode } from '@cyoda/workflow-layout';
-import * as react from 'react';
+import { LiftResult, MonacoLike, TextModelLike, EditorLike } from '@cyoda/workflow-monaco';
 
 declare const defaultMessages: {
     toolbar: {
@@ -14,6 +17,25 @@ declare const defaultMessages: {
         infos: string;
         save: string;
         addWorkflow: string;
+        autoLayout: string;
+        resetLayout: string;
+        addState: string;
+        addNote: string;
+        addStateButton: string;
+    };
+    issues: {
+        title: string;
+        none: string;
+        errors: string;
+        warnings: string;
+        infos: string;
+        jumpTo: string;
+        relatedState: string;
+        relatedTransition: string;
+        close: string;
+        openErrors: string;
+        openWarnings: string;
+        openInfos: string;
     };
     inspector: {
         empty: string;
@@ -24,23 +46,36 @@ declare const defaultMessages: {
         version: string;
         active: string;
         initialState: string;
+        transitionType: string;
+        automated: string;
         manual: string;
         disabled: string;
         processors: string;
+        processes: string;
         criterion: string;
+        criteria: string;
         executionMode: string;
         addProcessor: string;
         removeProcessor: string;
         moveUp: string;
         moveDown: string;
+        transitionOrderHelp: string;
         issues: string;
         sourceAnchor: string;
         targetAnchor: string;
         anchorDefault: string;
+        anchorTopLeft: string;
         anchorTop: string;
+        anchorTopRight: string;
+        anchorRightTop: string;
         anchorRight: string;
+        anchorRightBottom: string;
+        anchorBottomLeft: string;
         anchorBottom: string;
+        anchorBottomRight: string;
+        anchorLeftTop: string;
         anchorLeft: string;
+        anchorLeftBottom: string;
     };
     confirmDelete: {
         title: string;
@@ -61,6 +96,14 @@ declare const defaultMessages: {
         closeTab: string;
         untitled: string;
     };
+    editorView: {
+        graph: string;
+        json: string;
+        unavailable: string;
+        invalidJson: string;
+        invalidSchema: string;
+        semanticErrors: string;
+    };
     saveConfirm: {
         title: string;
         modeLabel: string;
@@ -75,6 +118,104 @@ declare const defaultMessages: {
         reload: string;
         forceOverwrite: string;
     };
+    criterion: {
+        heading: string;
+        addTitle: string;
+        editTitle: string;
+        add: string;
+        edit: string;
+        remove: string;
+        noneManual: string;
+        noneAutomated: string;
+        noneAutomatedWarning: string;
+        type: string;
+        jsonPath: string;
+        operation: string;
+        value: string;
+        low: string;
+        high: string;
+        apply: string;
+        applyModal: string;
+        cancel: string;
+        advanced: string;
+        editJson: string;
+        backToForm: string;
+        preview: string;
+        changeType: string;
+        chooseConditionType: string;
+        types: {
+            simple: string;
+            lifecycle: string;
+            function: string;
+            array: string;
+            group: string;
+        };
+        invalidJson: string;
+        valueIgnored: string;
+        legacySuffix: string;
+        legacyOperatorBanner: string;
+        legacyNotBanner: string;
+        likeHelp: string;
+        matchesPatternHelpAlways: string;
+        jsonPathError: {
+            empty: string;
+            "missing-root": string;
+            "recursive-descent": string;
+            "filter-expression": string;
+            malformed: string;
+        };
+        betweenShape: string;
+        likeWildcardHelp: string;
+        matchesPatternHelp: string;
+        wrapInGroup: string;
+        group: {
+            heading: string;
+            operator: string;
+            allConditions: string;
+            anyCondition: string;
+            addCondition: string;
+            addGroup: string;
+            edit: string;
+            editing: string;
+            complete: string;
+            duplicate: string;
+            moveUp: string;
+            moveDown: string;
+            remove: string;
+            valid: string;
+            invalid: string;
+            empty: string;
+            condition: string;
+            depthWarning: string;
+            legacyNotSuffix: string;
+        };
+        function: {
+            name: string;
+            nameEmpty: string;
+            nameInvalid: string;
+            config: string;
+            configInvalid: string;
+            precheck: string;
+            precheckAdd: string;
+            precheckRemove: string;
+        };
+        lifecycle: {
+            field: string;
+        };
+        array: {
+            values: string;
+            addValue: string;
+            addValuePlaceholder: string;
+        };
+        hints: {
+            loading: string;
+            error: string;
+            noEntity: string;
+            noMatches: string;
+            typeLabel: string;
+            retry: string;
+        };
+    };
 };
 type Messages = typeof defaultMessages;
 
@@ -88,6 +229,25 @@ declare const I18nContext: react.Context<{
         infos: string;
         save: string;
         addWorkflow: string;
+        autoLayout: string;
+        resetLayout: string;
+        addState: string;
+        addNote: string;
+        addStateButton: string;
+    };
+    issues: {
+        title: string;
+        none: string;
+        errors: string;
+        warnings: string;
+        infos: string;
+        jumpTo: string;
+        relatedState: string;
+        relatedTransition: string;
+        close: string;
+        openErrors: string;
+        openWarnings: string;
+        openInfos: string;
     };
     inspector: {
         empty: string;
@@ -98,23 +258,36 @@ declare const I18nContext: react.Context<{
         version: string;
         active: string;
         initialState: string;
+        transitionType: string;
+        automated: string;
         manual: string;
         disabled: string;
         processors: string;
+        processes: string;
         criterion: string;
+        criteria: string;
         executionMode: string;
         addProcessor: string;
         removeProcessor: string;
         moveUp: string;
         moveDown: string;
+        transitionOrderHelp: string;
         issues: string;
         sourceAnchor: string;
         targetAnchor: string;
         anchorDefault: string;
+        anchorTopLeft: string;
         anchorTop: string;
+        anchorTopRight: string;
+        anchorRightTop: string;
         anchorRight: string;
+        anchorRightBottom: string;
+        anchorBottomLeft: string;
         anchorBottom: string;
+        anchorBottomRight: string;
+        anchorLeftTop: string;
         anchorLeft: string;
+        anchorLeftBottom: string;
     };
     confirmDelete: {
         title: string;
@@ -135,6 +308,14 @@ declare const I18nContext: react.Context<{
         closeTab: string;
         untitled: string;
     };
+    editorView: {
+        graph: string;
+        json: string;
+        unavailable: string;
+        invalidJson: string;
+        invalidSchema: string;
+        semanticErrors: string;
+    };
     saveConfirm: {
         title: string;
         modeLabel: string;
@@ -149,6 +330,104 @@ declare const I18nContext: react.Context<{
         reload: string;
         forceOverwrite: string;
     };
+    criterion: {
+        heading: string;
+        addTitle: string;
+        editTitle: string;
+        add: string;
+        edit: string;
+        remove: string;
+        noneManual: string;
+        noneAutomated: string;
+        noneAutomatedWarning: string;
+        type: string;
+        jsonPath: string;
+        operation: string;
+        value: string;
+        low: string;
+        high: string;
+        apply: string;
+        applyModal: string;
+        cancel: string;
+        advanced: string;
+        editJson: string;
+        backToForm: string;
+        preview: string;
+        changeType: string;
+        chooseConditionType: string;
+        types: {
+            simple: string;
+            lifecycle: string;
+            function: string;
+            array: string;
+            group: string;
+        };
+        invalidJson: string;
+        valueIgnored: string;
+        legacySuffix: string;
+        legacyOperatorBanner: string;
+        legacyNotBanner: string;
+        likeHelp: string;
+        matchesPatternHelpAlways: string;
+        jsonPathError: {
+            empty: string;
+            "missing-root": string;
+            "recursive-descent": string;
+            "filter-expression": string;
+            malformed: string;
+        };
+        betweenShape: string;
+        likeWildcardHelp: string;
+        matchesPatternHelp: string;
+        wrapInGroup: string;
+        group: {
+            heading: string;
+            operator: string;
+            allConditions: string;
+            anyCondition: string;
+            addCondition: string;
+            addGroup: string;
+            edit: string;
+            editing: string;
+            complete: string;
+            duplicate: string;
+            moveUp: string;
+            moveDown: string;
+            remove: string;
+            valid: string;
+            invalid: string;
+            empty: string;
+            condition: string;
+            depthWarning: string;
+            legacyNotSuffix: string;
+        };
+        function: {
+            name: string;
+            nameEmpty: string;
+            nameInvalid: string;
+            config: string;
+            configInvalid: string;
+            precheck: string;
+            precheckAdd: string;
+            precheckRemove: string;
+        };
+        lifecycle: {
+            field: string;
+        };
+        array: {
+            values: string;
+            addValue: string;
+            addValuePlaceholder: string;
+        };
+        hints: {
+            loading: string;
+            error: string;
+            noEntity: string;
+            noMatches: string;
+            typeLabel: string;
+            retry: string;
+        };
+    };
 }>;
 declare function useMessages(): Messages;
 type PartialMessages = {
@@ -179,16 +458,101 @@ type Selection = null | {
     path: string[];
 };
 
+type JsonEditStatus = LiftResult | {
+    status: "idle";
+};
+interface MonacoUriLike {
+    toString(): string;
+}
+interface WorkflowJsonModelLike extends TextModelLike {
+    dispose(): void;
+}
+interface WorkflowJsonEditorInstance extends EditorLike {
+    dispose(): void;
+    layout?: () => void;
+    updateOptions?: (options: Record<string, unknown>) => void;
+}
+interface WorkflowJsonMonacoRuntime extends MonacoLike {
+    Uri: {
+        parse(value: string): MonacoUriLike;
+    };
+    editor: MonacoLike["editor"] & {
+        createModel(value: string, language?: string, uri?: MonacoUriLike): WorkflowJsonModelLike;
+        create(element: HTMLElement, options: Record<string, unknown>): WorkflowJsonEditorInstance;
+    };
+}
+interface WorkflowJsonEditorConfig {
+    monaco: WorkflowJsonMonacoRuntime;
+    modelUri?: string;
+    editorOptions?: Record<string, unknown>;
+    debounceMs?: number;
+}
+
+/** Controls which chrome elements the editor shell renders. All fields default to `true`. */
+interface ChromeOptions {
+    /** Top toolbar (undo/redo/validation pills/save). Default: true. */
+    toolbar?: boolean;
+    /** Workflow tabs bar. Default: true (also gated by existing single-workflow-viewer rule). */
+    tabs?: boolean;
+    /** Right-side inspector panel. Default: true. */
+    inspector?: boolean;
+    /** Canvas minimap. Default: true. */
+    minimap?: boolean;
+    /** Canvas zoom/pan controls. Default: true. */
+    controls?: boolean;
+}
 interface WorkflowEditorProps {
     document: WorkflowEditorDocument;
     mode?: EditorMode;
+    surface?: WorkflowEditorSurface;
+    layout?: WorkflowEditorLayout;
     messages?: PartialMessages;
     layoutOptions?: LayoutOptions;
+    /** Selectively suppress editor chrome for compact embed scenarios. */
+    chrome?: ChromeOptions;
     onChange?: (doc: WorkflowEditorDocument) => void;
     onSave?: (doc: WorkflowEditorDocument) => void;
+    showSaveButton?: boolean;
+    toolbarStart?: ReactNode;
+    toolbarCenter?: ReactNode;
+    toolbarEnd?: ReactNode;
+    /**
+     * Host-controlled layout/UI metadata. When provided it takes precedence over
+     * the editor's internal localStorage persistence.
+     */
+    layoutMetadata?: WorkflowUiMeta;
+    /** Called whenever layout positions or other editor-only metadata change. */
+    onLayoutMetadataChange?: (meta: WorkflowUiMeta) => void;
+    /**
+     * localStorage key prefix for layout persistence. Defaults to
+     * "cyoda-editor-layout". Pass `null` to disable localStorage persistence.
+     */
+    localStorageKey?: string | null;
+    /** Enables the canonical JSON editing surface inside the editor shell. */
+    enableJsonEditor?: boolean;
+    /** Controls whether JSON appears as a tab or alongside the graph. */
+    jsonEditorPlacement?: "tab" | "split";
+    /** Optional host-supplied Monaco runtime/configuration. */
+    jsonEditor?: WorkflowJsonEditorConfig | null;
+    /** Reports JSON parse/schema/apply status for host UX. */
+    onJsonStatusChange?: (status: JsonEditStatus) => void;
+    /**
+     * Optional model-schema autocomplete source for criterion jsonPath inputs.
+     * When omitted, jsonPath inputs render as plain free-text fields.
+     */
+    hintProvider?: EntityFieldHintProvider;
+    /**
+     * Show developer-oriented affordances (raw JSON tab in the inspector and
+     * other diagnostics). Defaults to `false` so SMEs/BAs see a clean view.
+     * Existing demo and admin surfaces that previously relied on the JSON tab
+     * should opt in explicitly with `developerMode={true}`.
+     */
+    developerMode?: boolean;
 }
+type WorkflowEditorSurface = "dev-console";
+type WorkflowEditorLayout = "embedded" | "fullWidth";
 /** Top-level editor shell — spec §14. Provides viewer/playground/editor modes. */
-declare function WorkflowEditor({ document: initialDocument, mode, messages, layoutOptions, onChange, onSave, }: WorkflowEditorProps): react_jsx_runtime.JSX.Element;
+declare function WorkflowEditor({ document: initialDocument, mode, surface, layout, messages, layoutOptions, chrome, onChange, onSave, showSaveButton, toolbarStart, toolbarCenter, toolbarEnd, layoutMetadata: externalLayoutMeta, onLayoutMetadataChange, localStorageKey, enableJsonEditor, jsonEditorPlacement, jsonEditor, onJsonStatusChange, hintProvider, developerMode, }: WorkflowEditorProps): react_jsx_runtime.JSX.Element;
 
 interface UseSaveFlowArgs {
     api: WorkflowApi;
@@ -268,4 +632,4 @@ declare function ConflictBanner({ onReload, onForceOverwrite }: ConflictBannerPr
  */
 declare function diffSummary(server: WorkflowEditorDocument | null, local: WorkflowEditorDocument): string | null;
 
-export { ConflictBanner, type ConflictBannerProps, type EditorMode, I18nContext, type Messages, type PartialMessages, SaveConfirmModal, type SaveConfirmModalProps, type SaveFlow, type Selection, type UseSaveFlowArgs, WorkflowEditor, type WorkflowEditorProps, defaultMessages, diffSummary, mergeMessages, useMessages, useSaveFlow };
+export { type ChromeOptions, ConflictBanner, type ConflictBannerProps, type EditorMode, I18nContext, type JsonEditStatus, type Messages, type PartialMessages, SaveConfirmModal, type SaveConfirmModalProps, type SaveFlow, type Selection, type UseSaveFlowArgs, WorkflowEditor, type WorkflowEditorLayout, type WorkflowEditorProps, type WorkflowEditorSurface, type WorkflowJsonEditorConfig, type WorkflowJsonEditorInstance, type WorkflowJsonModelLike, type WorkflowJsonMonacoRuntime, defaultMessages, diffSummary, mergeMessages, useMessages, useSaveFlow };