@cyoda/workflow-react 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -1,11 +1,10 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 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 { WorkflowEditorDocument, WorkflowUiMeta, SaveStatus, WorkflowApi, ConcurrencyToken, ImportMode } from '@cyoda/workflow-core';
 import { LayoutOptions } from '@cyoda/workflow-layout';
 export { LayoutOptions, LayoutPreset, PinnedNode } from '@cyoda/workflow-layout';
-import { LiftResult, MonacoLike, TextModelLike, EditorLike } from '@cyoda/workflow-monaco';
+import { LiftResult, WorkflowJsonMonacoRuntime } from '@cyoda/workflow-monaco';
+export { WorkflowJsonEditorInstance, WorkflowJsonModelLike, WorkflowJsonMonacoRuntime } from '@cyoda/workflow-monaco';
 
 declare const defaultMessages: {
     toolbar: {
@@ -22,6 +21,40 @@ declare const defaultMessages: {
         addState: string;
         addNote: string;
         addStateButton: string;
+        help: string;
+    };
+    help: {
+        title: string;
+        statesTitle: string;
+        stateInitial: string;
+        stateDefault: string;
+        stateProcessing: string;
+        stateManualReview: string;
+        stateTerminal: string;
+        stateError: string;
+        stateWarning: string;
+        transitionsTitle: string;
+        transitionAutomated: string;
+        transitionManual: string;
+        transitionConditional: string;
+        transitionProcessing: string;
+        transitionTerminal: string;
+        transitionLoop: string;
+        transitionDisabled: string;
+        controlsTitle: string;
+        shortcutAddState: string;
+        shortcutAutoLayout: string;
+        shortcutUndo: string;
+        shortcutRedo: string;
+        shortcutSave: string;
+        shortcutDelete: string;
+        shortcutEscape: string;
+        tipsTitle: string;
+        tipDoubleClick: string;
+        tipConnect: string;
+        tipSelect: string;
+        tipMove: string;
+        close: string;
     };
     issues: {
         title: string;
@@ -54,6 +87,12 @@ declare const defaultMessages: {
         processes: string;
         criterion: string;
         criteria: string;
+        annotations: string;
+        annotationsAdd: string;
+        annotationsApply: string;
+        annotationsRevert: string;
+        annotationsRemove: string;
+        annotationsDocChanged: string;
         executionMode: string;
         addProcessor: string;
         removeProcessor: string;
@@ -128,93 +167,8 @@ declare const defaultMessages: {
         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;
-        };
+        applyModal: string;
     };
 };
 type Messages = typeof defaultMessages;
@@ -234,6 +188,40 @@ declare const I18nContext: react.Context<{
         addState: string;
         addNote: string;
         addStateButton: string;
+        help: string;
+    };
+    help: {
+        title: string;
+        statesTitle: string;
+        stateInitial: string;
+        stateDefault: string;
+        stateProcessing: string;
+        stateManualReview: string;
+        stateTerminal: string;
+        stateError: string;
+        stateWarning: string;
+        transitionsTitle: string;
+        transitionAutomated: string;
+        transitionManual: string;
+        transitionConditional: string;
+        transitionProcessing: string;
+        transitionTerminal: string;
+        transitionLoop: string;
+        transitionDisabled: string;
+        controlsTitle: string;
+        shortcutAddState: string;
+        shortcutAutoLayout: string;
+        shortcutUndo: string;
+        shortcutRedo: string;
+        shortcutSave: string;
+        shortcutDelete: string;
+        shortcutEscape: string;
+        tipsTitle: string;
+        tipDoubleClick: string;
+        tipConnect: string;
+        tipSelect: string;
+        tipMove: string;
+        close: string;
     };
     issues: {
         title: string;
@@ -266,6 +254,12 @@ declare const I18nContext: react.Context<{
         processes: string;
         criterion: string;
         criteria: string;
+        annotations: string;
+        annotationsAdd: string;
+        annotationsApply: string;
+        annotationsRevert: string;
+        annotationsRemove: string;
+        annotationsDocChanged: string;
         executionMode: string;
         addProcessor: string;
         removeProcessor: string;
@@ -340,93 +334,8 @@ declare const I18nContext: react.Context<{
         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;
-        };
+        applyModal: string;
     };
 }>;
 declare function useMessages(): Messages;
@@ -461,26 +370,6 @@ type Selection = null | {
 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;
@@ -523,6 +412,8 @@ interface WorkflowEditorProps {
     layoutMetadata?: WorkflowUiMeta;
     /** Called whenever layout positions or other editor-only metadata change. */
     onLayoutMetadataChange?: (meta: WorkflowUiMeta) => void;
+    /** Called with the full per-workflow UI map whenever any layout changes — use this for file-based persistence. */
+    onWorkflowUiChange?: (workflowUi: Record<string, WorkflowUiMeta>) => void;
     /**
      * localStorage key prefix for layout persistence. Defaults to
      * "cyoda-editor-layout". Pass `null` to disable localStorage persistence.
@@ -536,11 +427,6 @@ interface WorkflowEditorProps {
     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.
@@ -552,7 +438,7 @@ interface WorkflowEditorProps {
 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, 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;
+declare function WorkflowEditor({ document: initialDocument, mode, surface, layout, messages, layoutOptions, chrome, onChange, onSave, showSaveButton, toolbarStart, toolbarCenter, toolbarEnd, layoutMetadata: externalLayoutMeta, onLayoutMetadataChange, onWorkflowUiChange, localStorageKey, enableJsonEditor, jsonEditorPlacement, jsonEditor, onJsonStatusChange, developerMode, }: WorkflowEditorProps): react.JSX.Element;
 
 interface UseSaveFlowArgs {
     api: WorkflowApi;
@@ -609,7 +495,7 @@ interface SaveConfirmModalProps {
  *    the warning count.
  *  - The diff summary (if provided) is shown above the tick-boxes.
  */
-declare function SaveConfirmModal({ mode, requiresExplicitConfirm, warningCount, diffSummary, onConfirm, onCancel, }: SaveConfirmModalProps): react_jsx_runtime.JSX.Element;
+declare function SaveConfirmModal({ mode, requiresExplicitConfirm, warningCount, diffSummary, onConfirm, onCancel, }: SaveConfirmModalProps): react.JSX.Element;
 
 interface ConflictBannerProps {
     onReload: () => void;
@@ -619,7 +505,7 @@ interface ConflictBannerProps {
  * 409-conflict banner per spec §17.4. Non-dismissable; the user must pick
  * Reload (discard local) or Force overwrite (resend without the token).
  */
-declare function ConflictBanner({ onReload, onForceOverwrite }: ConflictBannerProps): react_jsx_runtime.JSX.Element;
+declare function ConflictBanner({ onReload, onForceOverwrite }: ConflictBannerProps): react.JSX.Element;
 
 /**
  * Produce a short human-readable diff summary between the last-known server
@@ -632,4 +518,4 @@ declare function ConflictBanner({ onReload, onForceOverwrite }: ConflictBannerPr
  */
 declare function diffSummary(server: WorkflowEditorDocument | null, local: WorkflowEditorDocument): string | null;
 
-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 };
+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, defaultMessages, diffSummary, mergeMessages, useMessages, useSaveFlow };