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

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

@@ -11,8 +11,8 @@ import { AXPFilterClause, AXPExecuteCommandResult, AXPActionMenuItem, AXPExecute
 import { AXPCommand } from '@acorex/platform/runtime';
 import { AXStyleColorType } from '@acorex/cdk/common';
 import { AXPopupSizeType } from '@acorex/components/popup';
-import { AXPPageLayoutBaseComponent } from '@acorex/platform/layout/views';
 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';
 
@@ -77,12 +77,54 @@ declare const RootConfig: {
             tasksNearDeadline: string;
             bottleneckActivities: string;
             errorsByCategory: string;
+            /** Workflow instance funnel: counts per stage (created -> completed). */
+            instanceConversionFunnel: string;
+            /** Heatmap: errors by activity/stage and weekday (or day bucket). */
+            errorsByActivityDayHeatmap: string;
             workloadPerUserActive: string;
             workloadPerUserOverdue: string;
             workloadPerUserAvgAgeHours: string;
             workloadOverloadedUsers: string;
             slaRiskPrediction: string;
         };
+        dashboardKpi: {
+            slaComplianceSnapshot: string;
+            taskStatusBreakdown: string;
+            throughputOverview: string;
+            kpiStatCard: string;
+        };
+    };
+    /** Extended dashboard widget type ids; used by workflow dashboard widget configs. */
+    widgets: {
+        barChart: string;
+        tasksNearDeadlineBar: string;
+        pendingTasksByAgeBar: string;
+        overdueTasksBar: string;
+        bottleneckBar: string;
+        workloadPerUserOverdueBar: string;
+        stuckProcessesBar: string;
+        slaRiskPredictionBar: string;
+        failedProcessesByTypeDonut: string;
+        failedProcessesTrendLine: string;
+        throughputDailyLine: string;
+        throughputWeeklyLine: string;
+        failedProcessesSummaryBar: string;
+        workloadPerUserActiveBar: string;
+        workloadPerUserAvgAgeBar: string;
+        overloadedUsersBar: string;
+        donutChart: string;
+        slaViolationsBar: string;
+        gaugeChart: string;
+        lineChart: string;
+        slaTrendLine: string;
+        errorsBar: string;
+        instanceConversionFunnel: string;
+        errorsHeatmap: string;
+        systemHealthBar: string;
+        kpiDetails: string;
+        kpiProgress: string;
+        kpiSegmented: string;
+        kpiStatCard: string;
     };
 };
 
@@ -180,22 +222,14 @@ interface AXMWorkflowManagementWorkflowDefinitionEntityModel extends AXPEntityMo
      * Tool version (system field - set automatically).
      */
     toolVersion?: string | null;
-    /**
-     * Whether workflow is readonly (system field - set automatically).
-     */
-    isReadonly: boolean;
-    /**
-     * Whether workflow is system workflow (system field - set automatically).
-     */
-    isSystem: boolean;
     /**
      * Whether this is the latest version (system field - managed automatically).
      */
     isLatest: boolean;
     /**
-     * Whether workflow is published (system field - managed automatically).
+     * Publication lifecycle (draft, pending-review, published, archived) via status plugin.
      */
-    isPublished: boolean;
+    statusId: string;
 }
 
 /**
@@ -533,6 +567,49 @@ declare class HumanTaskActivity implements AXPCommand<HumanTaskInput, HumanTaskO
     static ɵprov: i0.ɵɵInjectableDeclaration<HumanTaskActivity>;
 }
 
+/**
+ * Input for Cartable (pooled) task activity.
+ * Does not use direct assignment: only candidates may claim the task on the task board.
+ */
+interface CartableTaskInput {
+    title?: string;
+    description?: string;
+    candidateUserIds?: string[];
+    candidateRoleIds?: string[];
+    priority?: 'Low' | 'Normal' | 'High' | 'Urgent';
+    dueDate?: string | Date;
+    context?: Record<string, any>;
+    actions?: {
+        prefix?: Array<{
+            name?: string;
+            command?: {
+                name?: string;
+            };
+        }>;
+        suffix?: Array<{
+            name?: string;
+            command?: {
+                name?: string;
+            };
+        }>;
+    } | string;
+}
+interface CartableTaskOutput {
+    result: Record<string, any>;
+    action: string;
+}
+/**
+ * Cartable task activity (frontend): suspends workflow with candidate users only.
+ * Assignee is set when a candidate claims the task on the task board (bookmark update).
+ *
+ * Activity Type: workflow-activity:cartable
+ */
+declare class CartableTaskActivity implements AXPCommand<CartableTaskInput, CartableTaskOutput> {
+    execute(input: CartableTaskInput): Promise<AXPExecuteCommandResult<CartableTaskOutput>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CartableTaskActivity, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CartableTaskActivity>;
+}
+
 /**
  * Input for ShowToast activity.
  */
@@ -854,6 +931,10 @@ interface WorkflowInput {
         readonly?: boolean;
         hidden?: boolean | string;
         defaultValue?: any | string | ((context: any | null) => any);
+        interface?: {
+            type: string;
+            options?: Record<string, unknown>;
+        };
     };
     validations?: Array<{
         rule: string;
@@ -867,7 +948,13 @@ interface WorkflowOutput {
     description?: string;
     schema: {
         dataType: string;
+        interface?: {
+            type: string;
+            options?: Record<string, unknown>;
+        };
     };
+    path?: string;
+    metadata?: Record<string, unknown>;
 }
 interface WorkflowVariable {
     name: string;
@@ -951,6 +1038,14 @@ declare class WorkflowStudioComponent extends AXPPageLayoutBaseComponent {
      * 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
      */
@@ -982,15 +1077,17 @@ declare class WorkflowStudioComponent extends AXPPageLayoutBaseComponent {
     /**
      * 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;
     /**
-     * Get property type from schema
+     * Map {@link AXPProperty.dataType} to visual editor property type.
      */
-    private getPropertyTypeFromSchema;
+    private getPropertyTypeFromDataType;
     /**
      * Get category color
      */
@@ -1339,6 +1436,15 @@ declare class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider<Rec
     get name(): string;
     get title(): string;
     get icon(): string;
+    /**
+     * Bookmark types shown on the workflow task board.
+     */
+    private isTaskBoardBookmarkPayload;
+    /**
+     * Pooled task: must be claimed before submit/cancel (cartable, or human-task with candidates only).
+     */
+    private isPooledClaimablePayload;
+    private normalizeUserIdList;
     /**
      * Get tasks from suspended workflow instances.
      *
@@ -1391,5 +1497,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, CollectSignatureActivity, CreateEntityFormActivity, HumanTaskActivity, RootConfig, ShowConfirmPopupActivity, ShowLayoutPopupActivity, ShowToastActivity, WorkflowStudioComponent };
-export type { AXMWorkflowManagementActivityCategoryEntityModel, AXMWorkflowManagementActivityDefinitionEntityModel, AXMWorkflowManagementAutomationEntityModel, AXMWorkflowManagementWorkflowDefinitionEntityModel, AXMWorkflowManagementWorkflowInstanceEntityModel, AXPGenericWorkflowTaskProviderConfig, ActivityTreeViewItem, CollectSignatureInput, CollectSignatureOutput, CreateEnityInput, CreateEnityOutput, CreateEntityFormInput, CreateEntityFormOutput, HumanTaskInput, HumanTaskOutput, ShowConfirmPopupInput, ShowConfirmPopupOutput, ShowLayoutPopupInput, ShowToastInput, ShowToastOutput };
+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 };