@acorex/modules 21.0.0-next.40 → 21.0.0-next.42

package/types/acorex-modules-workflow-management.d.ts

@@ -1,7 +1,7 @@
 import { AXPEntity, AXPMenuProvider, AXPMenuProviderContext } from '@acorex/platform/common';
 import { AXPEntityDefinitionLoader, AXPEntityPreloadEntity, AXPEntityModel } from '@acorex/platform/layout/entity';
 import * as i0 from '@angular/core';
-import { ElementRef, Type, InjectionToken } from '@angular/core';
+import { Type, InjectionToken } from '@angular/core';
 import * as i1 from '@acorex/modules/calendar-management';
 import * as i2 from '@acorex/platform/domain';
 import * as i4 from '@acorex/platform/layout/widget-core';
@@ -11,9 +11,6 @@ import { AXPFilterClause, AXPExecuteCommandResult, AXPActionMenuItem, AXPExecute
 import { AXPCommand } from '@acorex/platform/runtime';
 import { AXStyleColorType } from '@acorex/cdk/common';
 import { AXPopupSizeType } from '@acorex/components/popup';
-import { AXPPropertyViewerTab, AXPPropertyViewerComponent } from '@acorex/platform/layout/components';
-import { AXPPageLayoutBaseComponent } from '@acorex/platform/layout/views';
-import { AXTreeItemClickBaseEventLegacy } from '@acorex/components/tree-view-legacy';
 import { AXPWorkflowTaskProvider, AXPTaskFilter, AXPTask, AXPTaskActionMenuItem, AXPExtraField, AXPTaskStatus, AXPTaskPopoverComponent } from '@acorex/modules/task-management';
 
 declare const RootConfig: {
@@ -326,6 +323,19 @@ interface AXMWorkflowManagementWorkflowInstanceEntityModel extends AXPEntityMode
         title: string;
         value: string;
     }[];
+    /**
+     * Primary user for assignee / last-action column (lookup id).
+     */
+    assignUser?: {
+        id: string;
+    };
+    /**
+     * Hydrated lookup snapshot for list columns (`expose` targets).
+     */
+    assignUserRef?: {
+        id: string;
+        displayName: string;
+    };
 }
 
 /**
@@ -845,549 +855,6 @@ declare class AXPCreateEntityActivity implements AXPCommand<CreateEnityInput, Cr
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPCreateEntityActivity>;
 }
 
-interface PropertySchema {
-    name: string;
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'select' | 'any';
-    required: boolean;
-    description?: string;
-    defaultValue?: any;
-    options?: Array<{
-        value: any;
-        label: string;
-    }>;
-}
-interface ActivityInfo {
-    type: string;
-    name: string;
-    description: string;
-    icon: string;
-    properties: PropertySchema[];
-    defaultProperties?: Record<string, any>;
-}
-interface ExecutionLog {
-    timestamp: Date;
-    level: 'info' | 'success' | 'warning' | 'error';
-    message: string;
-    data?: any;
-    expanded?: boolean;
-}
-/**
- * Represents a connection from one outcome to a target node.
- */
-interface OutcomeConnection {
-    outcome: string;
-    targetNodeId: string;
-}
-interface VisualNode {
-    id: string;
-    type: string;
-    name: string;
-    icon: string;
-    properties: Record<string, any>;
-    position: {
-        x: number;
-        y: number;
-    };
-    /**
-     * @deprecated Use outcomeConnections instead
-     * Simple list of connections (for backward compatibility)
-     */
-    connections: string[];
-    /**
-     * Outcome-based connections.
-     * Each outcome can connect to a different target.
-     */
-    outcomeConnections?: OutcomeConnection[];
-    /**
-     * Available outcomes for this node.
-     * Computed from activity descriptor.
-     */
-    outcomes?: string[];
-}
-type EditorTab = 'json' | 'visual';
-interface WorkflowSettings {
-    definitionId: string;
-    name: string;
-    description: string;
-    inputs: WorkflowInput[];
-    outputs: WorkflowOutput[];
-    variables: WorkflowVariable[];
-    outcomes: string[];
-    usableAsActivity: boolean;
-    autoUpdateConsumingWorkflows: boolean;
-    version: number;
-    isLatest: boolean;
-    isPublished: boolean;
-    toolVersion: string;
-    providerName: string;
-}
-interface WorkflowInput {
-    name: string;
-    title: string;
-    description?: string;
-    schema: {
-        dataType: string;
-        nullable?: boolean;
-        readonly?: boolean;
-        hidden?: boolean | string;
-        defaultValue?: any | string | ((context: any | null) => any);
-        interface?: {
-            type: string;
-            options?: Record<string, unknown>;
-        };
-    };
-    validations?: Array<{
-        rule: string;
-        message?: string;
-        options?: any;
-    }>;
-}
-interface WorkflowOutput {
-    name: string;
-    title: string;
-    description?: string;
-    schema: {
-        dataType: string;
-        interface?: {
-            type: string;
-            options?: Record<string, unknown>;
-        };
-    };
-    path?: string;
-    metadata?: Record<string, unknown>;
-}
-interface WorkflowVariable {
-    name: string;
-    typeName: string;
-    value?: any;
-    description?: string;
-}
-declare class WorkflowStudioComponent extends AXPPageLayoutBaseComponent {
-    private readonly workflowManager;
-    private readonly activityDefinitionService;
-    private readonly entityService;
-    private readonly translationService;
-    private readonly activatedRoute;
-    private readonly router;
-    private readonly workflowDefinitionService;
-    private readonly layoutBuilder;
-    private readonly destroyRef;
-    activeTab: i0.WritableSignal<EditorTab>;
-    selectedCategory: i0.WritableSignal<AXPActivityCategory | null>;
-    selectedActivity: i0.WritableSignal<AXPActivityDefinition | null>;
-    workflowJson: i0.WritableSignal<string>;
-    visualNodes: i0.WritableSignal<VisualNode[]>;
-    selectedNode: i0.WritableSignal<VisualNode | null>;
-    isExecuting: i0.WritableSignal<boolean>;
-    executionLogs: i0.WritableSignal<ExecutionLog[]>;
-    showExecutionDialog: i0.WritableSignal<boolean>;
-    workflowInstanceState: i0.WritableSignal<any>;
-    showPropertiesPanel: i0.WritableSignal<boolean>;
-    /** When true, workflow changes can trigger auto-save (e.g. apply to JSON); actual persist is up to the host. */
-    autoSaveEnabled: i0.WritableSignal<boolean>;
-    /** Activity definition for the selected node (loaded when selection changes). */
-    activityDefinitionForSelected: i0.WritableSignal<AXPActivityDefinition | null>;
-    /** Cache key for property viewer tabs so we keep stable refs and avoid re-render/focus loss on value change. */
-    private lastPropertyViewerStructKey;
-    /** Cached tabs; updated only when selected node identity or def structure changes. */
-    private readonly cachedPropertyViewerTabs;
-    /** Tabs for the property viewer (platform widget-based rendering). Stable refs to prevent focus loss. */
-    readonly propertyViewerTabs: i0.Signal<AXPPropertyViewerTab[]>;
-    private readonly updatePropertyViewerTabsEffect;
-    protected readonly propertyViewerRef: i0.Signal<AXPPropertyViewerComponent | undefined>;
-    private readonly loadActivityDefinitionForSelectedEffect;
-    private readonly initPropertyViewerContextEffect;
-    workflowSettings: i0.WritableSignal<WorkflowSettings>;
-    /** Data source for variable type select (settings modal). */
-    readonly variableTypeOptions: Array<{
-        value: string;
-        label: string;
-    }>;
-    canvasOffset: {
-        x: number;
-        y: number;
-    };
-    isDraggingCanvas: boolean;
-    dragStartPos: {
-        x: number;
-        y: number;
-    };
-    draggedActivity: ActivityInfo | null;
-    draggedNode: VisualNode | null;
-    nodeDragOffset: {
-        x: number;
-        y: number;
-    };
-    connectionSource: {
-        node: VisualNode;
-        type: 'in' | 'out';
-        outcome?: string;
-    } | null;
-    /** Canvas area element for zoom/center/auto-layout. */
-    protected readonly canvasAreaRef: i0.Signal<ElementRef<HTMLElement> | undefined>;
-    ngOnInit(): Promise<void>;
-    /**
-     * Load workflow from route query parameter
-     */
-    private loadWorkflowFromRoute;
-    /**
-     * Update a single workflow setting field (for signal-based form binding).
-     */
-    updateWorkflowSetting<K extends keyof WorkflowSettings>(key: K, value: WorkflowSettings[K]): void;
-    /**
-     * Handle JSON editor input (textarea value -> workflowJson signal).
-     */
-    onWorkflowJsonInput(ev: Event): void;
-    /**
-     * Resolves workflow definition title for studio UI strings (settings, graph root label).
-     */
-    private resolveWorkflowDefinitionTitle;
-    /**
-     * Resolves workflow definition description for studio settings (current locale string).
-     */
-    private resolveWorkflowDefinitionDescription;
-    /**
-     * Load workflow by name
-     */
-    private loadWorkflowByName;
-    /**
-     * Convert workflow definition to studio JSON format
-     */
-    private convertWorkflowDefinitionToStudioJson;
-    getPageTitle(): Promise<string>;
-    getPageDescription(): Promise<string | null>;
-    getPrimaryMenuItems(): Promise<AXPActionMenuItem[]>;
-    getSecondaryMenuItems(): Promise<AXPActionMenuItem[]>;
-    execute(command: AXPExecuteCommand): Promise<void>;
-    /**
-     * Handle category selection from tree
-     */
-    onCategoryClick(category: AXPActivityCategory): void;
-    /**
-     * Handle activity selection from tree
-     */
-    onActivityClick(activity: AXPActivityDefinition): void;
-    /**
-     * Handle drag start from activity tree – set draggedActivity so canvas drop can add the node.
-     */
-    onActivityDragStartFromTree(payload: {
-        event: DragEvent;
-        activity: AXPActivityDefinition;
-    }): void;
-    /**
-     * Convert AXPActivityDefinition to ActivityInfo
-     */
-    private mapDefinitionInputToWorkflowInput;
-    private mapDefinitionOutputToWorkflowOutput;
-    private convertActivityDefinitionToInfo;
-    /**
-     * Normalize FontAwesome icon: if missing style prefix (e.g. fa-light, fas), prepend 'fa-light ' so short values like 'fa-shield-alt' render.
-     */
-    private normalizeActivityIcon;
-    /**
-     * Map {@link AXPProperty.dataType} to visual editor property type.
-     */
-    private getPropertyTypeFromDataType;
-    /**
-     * Get category color
-     */
-    private getCategoryColor;
-    /**
-     * Get empty workflow JSON
-     */
-    private getEmptyWorkflow;
-    /**
-     * Sync visualizer with JSON changes
-     */
-    syncVisualizerWithJson(): void;
-    /**
-     * Open execution dialog
-     */
-    openExecutionDialog(): void;
-    /**
-     * Close execution dialog
-     */
-    closeExecutionDialog(): void;
-    /**
-     * Start workflow execution
-     */
-    startWorkflowExecution(): Promise<void>;
-    /**
-     * اجرای workflow
-     */
-    runWorkflow(): Promise<void>;
-    /**
-     * اضافه کردن لاگ
-     */
-    addLog(level: 'info' | 'success' | 'warning' | 'error', message: string, data?: any): void;
-    /**
-     * کپی کردن نمونه activity
-     */
-    copyActivityTemplate(activity: ActivityInfo): void;
-    /**
-     * فرمت کردن JSON
-     */
-    formatJson(): void;
-    /**
-     * Open workflow settings dialog built with Layout Builder (platform widgets / Acorex).
-     */
-    openWorkflowSettings(): void;
-    /**
-     * Sync workflowSettings from current workflow JSON (used before opening settings dialog).
-     */
-    private syncWorkflowSettingsFromJson;
-    /**
-     * Apply current workflowSettings to workflow JSON (used after saving from dialog).
-     */
-    private applyWorkflowSettingsToJson;
-    /**
-     * Export workflow به فرمت Elsa Workflow Definition v3.0.0
-     * https://elsaworkflows.io/schemas/workflow-definition/v3.0.0/schema.json
-     */
-    exportWorkflowDefinition(): any;
-    /**
-     * دانلود WorkflowDefinition به صورت JSON file
-     */
-    downloadWorkflowDefinition(): void;
-    private generateId;
-    addWorkflowInput(): void;
-    removeWorkflowInput(index: number): void;
-    updateWorkflowInput(index: number, field: string, value: any): void;
-    updateWorkflowInputSchema(index: number, schemaField: string, value: any): void;
-    updateWorkflowInputValidation(index: number, isRequired: boolean): void;
-    getInputIsRequired(input: WorkflowInput): boolean;
-    addWorkflowOutput(): void;
-    removeWorkflowOutput(index: number): void;
-    updateWorkflowOutput(index: number, field: string, value: any): void;
-    updateWorkflowOutputSchema(index: number, schemaField: string, value: any): void;
-    addWorkflowVariable(): void;
-    removeWorkflowVariable(index: number): void;
-    updateWorkflowVariable(index: number, field: keyof WorkflowVariable, value: any): void;
-    /**
-     * به‌روزرسانی outcomes از string
-     */
-    updateOutcomes(outcomesString: string): void;
-    /**
-     * پاک کردن لاگ‌ها
-     */
-    clearLogs(): void;
-    /**
-     * تغییر تب
-     */
-    switchTab(tab: EditorTab): void;
-    /**
-     * انتخاب Node
-     */
-    selectNodeById(node: VisualNode): void;
-    /**
-     * Delete node from canvas (used from template to avoid event propagation).
-     */
-    deleteNodeFromCanvas(nodeId: string): void;
-    /**
-     * حذف Node
-     */
-    deleteNode(nodeId: string): void;
-    /**
-     * اتصال دو Node با outcome مشخص
-     */
-    connectNodes(fromId: string, toId: string, outcome?: string): void;
-    /**
-     * قطع اتصال (با یا بدون outcome)
-     */
-    disconnectNodes(fromId: string, toId: string, outcome?: string): void;
-    /**
-     * تبدیل JSON به Visual
-     */
-    jsonToVisual(): void;
-    /**
-     * پردازش Activity به Node (recursive)
-     */
-    private processActivityToNode;
-    /**
-     * تبدیل Visual به JSON
-     */
-    visualToJson(): void;
-    /**
-     * پیدا کردن Root Node
-     */
-    private findRootNode;
-    /**
-     * تبدیل Node به Activity (recursive)
-     */
-    private nodeToActivity;
-    /**
-     * دریافت آیکون برای نوع Activity
-     */
-    private getIconForActivityType;
-    /**
-     * به‌روزرسانی property نود
-     */
-    updateNodeProperty(nodeId: string, propertyName: string, value: any): void;
-    /**
-     * پیدا کردن activity info بر اساس type
-     */
-    private findActivityInfo;
-    /**
-     * پاک کردن همه نودها
-     */
-    clearCanvas(): void;
-    /**
-     * Copy workflow Definition ID to clipboard (Elsa-style workflow info).
-     */
-    copyDefinitionIdToClipboard(): Promise<void>;
-    /**
-     * Scroll canvas area so content is centered (Elsa-style "Center").
-     */
-    canvasCenter(): void;
-    /**
-     * Scroll canvas so all nodes are in view (Elsa-style "Zoom to fit" – fit by scroll).
-     */
-    canvasZoomToFit(): void;
-    /**
-     * Auto-arrange nodes in a vertical flow (Elsa-style "Auto layout").
-     */
-    canvasAutoLayout(): void;
-    /**
-     * شروع drag از activity list
-     */
-    onActivityDragStart(event: DragEvent, activity: ActivityInfo): void;
-    /**
-     * پایان drag از activity list
-     */
-    onActivityDragEnd(event: DragEvent): void;
-    /**
-     * drag over روی Canvas
-     */
-    onCanvasDragOver(event: DragEvent): void;
-    /**
-     * drag leave از Canvas
-     */
-    onCanvasDragLeave(event: DragEvent): void;
-    /**
-     * محاسبه outcomes برای یک activity
-     */
-    computeOutcomes(activityInfo: ActivityInfo, properties: Record<string, any>): string[];
-    /**
-     * drop روی Canvas - اضافه کردن activity جدید
-     */
-    onCanvasDrop(event: DragEvent): void;
-    /**
-     * شروع drag نود
-     */
-    onNodeDragStart(event: DragEvent, node: VisualNode): void;
-    /**
-     * در حال drag نود
-     */
-    onNodeDrag(event: DragEvent, node: VisualNode): void;
-    /**
-     * پایان drag نود
-     */
-    onNodeDragEnd(event: DragEvent, node: VisualNode): void;
-    /**
-     * کلیک روی کانکتور - برای ایجاد اتصال (برای activities با یک outcome)
-     */
-    onConnectorClick(event: Event, node: VisualNode, type: 'in' | 'out'): void;
-    /**
-     * کلیک روی outcome connector - برای activities با چند outcome
-     */
-    onOutcomeConnectorClick(event: Event, node: VisualNode, outcome: string): void;
-    /**
-     * تغییر وضعیت نمایش Properties Panel
-     */
-    togglePropertiesPanel(): void;
-    /**
-     * Build property viewer tabs from activity definition (platform widget-based).
-     * Used so the properties panel renders via the same widget system as the form builder.
-     */
-    protected buildPropertyViewerTabs(def: AXPActivityDefinition | null | undefined, node: VisualNode): AXPPropertyViewerTab[];
-    private createStringProp;
-    private createReadOnlyStringProp;
-    private activityInputToWidgetProperty;
-    /**
-     * Apply property viewer context changes back to the selected node.
-     */
-    protected onPropertyViewerChanged(ev: {
-        values: any;
-        mode: 'init' | 'update';
-    }): void;
-    /**
-     * پیدا کردن Node با ID
-     */
-    findNodeById(nodeId: string): VisualNode | undefined;
-    /**
-     * بررسی اینکه آیا properties خالی است یا نه
-     */
-    hasProperties(properties: Record<string, any>): boolean;
-    /**
-     * دسترسی به Object برای استفاده در template
-     */
-    protected readonly Object: ObjectConstructor;
-    /**
-     * دسترسی به typeof برای استفاده در template
-     */
-    protected readonly typeof: (value: any) => "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function";
-    /**
-     * دسترسی به JSON برای استفاده در template
-     */
-    protected readonly JSON: JSON;
-    /**
-     * Builds SVG path for a curved connection (quadratic Bezier) so the line is smooth like Elsa/n8n.
-     * Control point is offset so the curve bows naturally between source and target.
-     */
-    protected getConnectionPath(x1: number, y1: number, x2: number, y2: number): string;
-    /**
-     * Approximate midpoint on the curve for label placement (quadratic Bezier t=0.5).
-     */
-    protected getConnectionLabelPosition(x1: number, y1: number, x2: number, y2: number): {
-        x: number;
-        y: number;
-    };
-    /**
-     * دریافت رنگ بر اساس outcome
-     */
-    protected getOutcomeColor(outcome: string): string;
-    /**
-     * Returns marker name for arrowhead def (success, error, warning, info, primary, default).
-     */
-    protected getOutcomeColorName(outcome: string): string;
-    /**
-     * به‌روزرسانی property با parse کردن JSON
-     */
-    updateNodePropertyJSON(nodeId: string, propertyName: string, jsonString: string): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<WorkflowStudioComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<WorkflowStudioComponent, "app-workflow-studio", never, {}, {}, never, never, true, never>;
-}
-
-interface ActivityTreeViewItem {
-    id: string;
-    title: string;
-    hasChild: boolean;
-    children?: ActivityTreeViewItem[];
-    item?: AXPActivityCategory | AXPActivityDefinition;
-    type: 'category' | 'definition';
-    expanded: boolean;
-}
-declare class AXMActivityCategoriesTreeComponent {
-    private readonly activityDefinitionService;
-    private readonly multiLanguageResolver;
-    categoryClick: i0.OutputEmitterRef<AXPActivityCategory>;
-    activityClick: i0.OutputEmitterRef<AXPActivityDefinition>;
-    /** Emitted when user starts dragging an activity (so parent can set draggedActivity for canvas drop). */
-    activityDragStart: i0.OutputEmitterRef<{
-        event: DragEvent;
-        activity: AXPActivityDefinition;
-    }>;
-    protected readonly provideLazyTreeView: (selectedItemId?: string | number) => Promise<ActivityTreeViewItem[]>;
-    protected handleNodeClick(event: AXTreeItemClickBaseEventLegacy): void;
-    protected onActivityDragStart(event: DragEvent, item: ActivityTreeViewItem): void;
-    /**
-     * Normalize FontAwesome icon for display: prepend 'fa-light ' when missing style prefix.
-     */
-    protected getActivityIconClass(icon: string | undefined): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMActivityCategoriesTreeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXMActivityCategoriesTreeComponent, "axp-activity-categories-tree", never, {}, { "categoryClick": "categoryClick"; "activityClick": "activityClick"; "activityDragStart": "activityDragStart"; }, never, never, true, never>;
-}
-
 /**
  * Configuration for a workflow-specific task provider.
  * One provider per workflow definition – pass definitionId to scope tasks to that definition only.
@@ -1497,5 +964,5 @@ declare class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider<Rec
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPGenericWorkflowTaskProvider>;
 }
 
-export { AXCCategoryProvider, AXMActivityCategoriesTreeComponent, AXMMenuProvider, AXMWorkflowActivitiesDefinitionProvider, AXMWorkflowManagementModule, AXMWorkflowManagementModuleEntityProvider, AXPCreateEntityActivity, AXPGenericWorkflowTaskProvider, AXP_GENERIC_WORKFLOW_TASK_PROVIDER_CONFIG, CartableTaskActivity, CollectSignatureActivity, CreateEntityFormActivity, HumanTaskActivity, RootConfig, ShowConfirmPopupActivity, ShowLayoutPopupActivity, ShowToastActivity, WorkflowStudioComponent };
-export type { AXMWorkflowManagementActivityCategoryEntityModel, AXMWorkflowManagementActivityDefinitionEntityModel, AXMWorkflowManagementAutomationEntityModel, AXMWorkflowManagementWorkflowDefinitionEntityModel, AXMWorkflowManagementWorkflowInstanceEntityModel, AXPGenericWorkflowTaskProviderConfig, ActivityTreeViewItem, CartableTaskInput, CartableTaskOutput, CollectSignatureInput, CollectSignatureOutput, CreateEnityInput, CreateEnityOutput, CreateEntityFormInput, CreateEntityFormOutput, HumanTaskInput, HumanTaskOutput, ShowConfirmPopupInput, ShowConfirmPopupOutput, ShowLayoutPopupInput, ShowToastInput, ShowToastOutput };
+export { AXCCategoryProvider, AXMMenuProvider, AXMWorkflowActivitiesDefinitionProvider, AXMWorkflowManagementModule, AXMWorkflowManagementModuleEntityProvider, AXPCreateEntityActivity, AXPGenericWorkflowTaskProvider, AXP_GENERIC_WORKFLOW_TASK_PROVIDER_CONFIG, CartableTaskActivity, CollectSignatureActivity, CreateEntityFormActivity, HumanTaskActivity, RootConfig, ShowConfirmPopupActivity, ShowLayoutPopupActivity, ShowToastActivity };
+export type { AXMWorkflowManagementActivityCategoryEntityModel, AXMWorkflowManagementActivityDefinitionEntityModel, AXMWorkflowManagementAutomationEntityModel, AXMWorkflowManagementWorkflowDefinitionEntityModel, AXMWorkflowManagementWorkflowInstanceEntityModel, AXPGenericWorkflowTaskProviderConfig, CartableTaskInput, CartableTaskOutput, CollectSignatureInput, CollectSignatureOutput, CreateEnityInput, CreateEnityOutput, CreateEntityFormInput, CreateEntityFormOutput, HumanTaskInput, HumanTaskOutput, ShowConfirmPopupInput, ShowConfirmPopupOutput, ShowLayoutPopupInput, ShowToastInput, ShowToastOutput };