@acorex/platform 21.0.0-next.24 → 21.0.0-next.33

package/{native/index.d.ts → types/acorex-platform-native.d.ts}

@@ -6,13 +6,6 @@ declare class AXPNativeModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<AXPNativeModule>;
 }
 
-declare global {
-    interface Window {
-        FlutterChannel?: {
-            postMessage: (message: string) => void;
-        };
-    }
-}
 declare class AXPNativeService {
     private isDark;
     constructor();

package/{runtime/index.d.ts → types/acorex-platform-runtime.d.ts}

@@ -1,11 +1,171 @@
 import { AXPExecuteCommandResult, AXPViewDefinition, AXPMetaData } from '@acorex/platform/core';
 import * as i0 from '@angular/core';
-import { InjectionToken, Type, EnvironmentProviders, Provider } from '@angular/core';
+import { InjectionToken, EnvironmentProviders, Type, Provider } from '@angular/core';
 import { AXComponent } from '@acorex/cdk/common';
 
-type AXPExecuteCommandResultPromise<TResult = any> = Promise<AXPExecuteCommandResult<TResult>>;
-interface AXPCommand<TInput = any, TResult = any> {
-    execute(input: TInput): AXPExecuteCommandResultPromise<TResult>;
+/**
+ * Shared build-time metadata shapes for command and query catalog definitions.
+ * Lives under `shared/` so secondary ng-packagr entries under `commands/` or `queries/` share a common `src/lib` compilation root.
+ */
+/** Command metadata validation: rule key + optional rule options only. */
+interface AXPCommandValidationRuleValue {
+    rule: string;
+    options?: Record<string, unknown>;
+}
+/**
+ * Widget/interface reference for a schema property (name + optional widget options).
+ */
+interface AXPCommandInterfaceDefinitionValue {
+    name: string;
+    options?: Record<string, unknown>;
+}
+/**
+ * One input/output property description (same structural role as AXPPropertyDefinition).
+ */
+interface AXPCommandSchemaPropertyDefinition {
+    name: string;
+    title: string;
+    description?: string;
+    icon?: string;
+    defaultValue?: unknown;
+    disabled?: boolean;
+    interface: AXPCommandInterfaceDefinitionValue;
+    validations?: AXPCommandValidationRuleValue[];
+}
+/** Structured usage hints for planners and assistants (prefer over duplicating rules only in `description`). */
+interface AXPCommandAiUsageMetadata {
+    whenToUse?: string[];
+    avoidWhen?: string[];
+    /** Registry keys or tool names that commonly follow this command/query. */
+    followUpTools?: string[];
+}
+/** Declarative contracts: what the tool provides, who depends on it, and guarantees (not workflow `outcomes`). */
+interface AXPCommandAiContractsMetadata {
+    provides?: string[];
+    requiredBy?: string[];
+    guarantees?: string[];
+}
+type AXPCommandAiSafetyKind = 'read-only' | 'mutating';
+interface AXPCommandAiSafetyMetadata {
+    kind?: AXPCommandAiSafetyKind;
+    sideEffects?: boolean;
+    requiresConfirmation?: boolean;
+}
+type AXPCommandAiPerformanceCost = 'low' | 'medium' | 'high';
+interface AXPCommandAiPerformanceMetadata {
+    cost?: AXPCommandAiPerformanceCost;
+    cacheable?: boolean;
+}
+interface AXPCommandAiNextStepMetadata {
+    when: string;
+    action: string;
+}
+/**
+ * How to interpret a successful payload for agents (documentation only; not command workflow outcomes).
+ */
+interface AXPCommandAiResultSemanticsMetadata {
+    noMatch?: string;
+    exactMatch?: string;
+    multipleMatches?: string;
+    failed?: string;
+    /** Full catalog listing (e.g. no entity filter). */
+    catalog?: string;
+}
+interface AXPCommandAiMetadata {
+    shortDescription?: string;
+    tags?: string[];
+    usage?: AXPCommandAiUsageMetadata;
+    contracts?: AXPCommandAiContractsMetadata;
+    safety?: AXPCommandAiSafetyMetadata;
+    performance?: AXPCommandAiPerformanceMetadata;
+    nextSteps?: AXPCommandAiNextStepMetadata[];
+    resultSemantics?: AXPCommandAiResultSemanticsMetadata;
+    /**
+     * Default input fragment merged for AI/tool invocations (catalog & tooling).
+     * Runtime merge for a given command is applied in the AI module (not the generic command executor).
+     */
+    toolInputDefaults?: Record<string, unknown>;
+    /**
+     * Optional JSON Schema fragment for LLM tool `parameters` (OpenAI-style function calling).
+     * Merged over the auto-generated schema from catalog `inputs` (`properties` / `required` deep-merged).
+     * Use when widget-to-type inference is insufficient (e.g. `object`, `array`, `enum`, `format`).
+     */
+    toolParametersSchema?: Record<string, unknown>;
+}
+type AXPCommandExecutionMode = 'frontend' | 'backend' | 'both';
+/**
+ * Where this command is intended to appear in product tooling (AI agents, workflow automation pickers, etc.).
+ * Omitted = not declared here; runtimes may fall back to other metadata (e.g. `ai.tags`).
+ */
+type AXPCommandCapability = 'ai' | 'workflow';
+
+/**
+ * Build-time command metadata for AXPCommand implementations.
+ * `inputs` / `outputs` are schema rows (same family as entity optionDefinitions).
+ * Validation entries: only `rule` name and optional `options` (no title/message on rules).
+ * Do not import from Angular templates; sidecars may import `defineCommand` from `@acorex/platform/runtime`.
+ *
+ * Query metadata (fetch-only, no outcomes) is defined in `../queries/query-definition.types.ts` with `defineQuery`.
+ */
+
+type AXPCommandOutcomeDefinition = {
+    mode: 'static';
+    values: string[];
+} | {
+    mode: 'dynamic';
+    summary: string;
+    derivesFrom: string;
+    examples?: string[];
+};
+interface AXPCommandMetadataDefinition {
+    /** Runtime registration key (provideCommand / provideCommandSetups). */
+    key: string;
+    title: string;
+    description: string;
+    executionMode: AXPCommandExecutionMode;
+    /** Input parameters as schema rows. */
+    inputs?: AXPCommandSchemaPropertyDefinition[];
+    /** Output shape as schema rows. */
+    outputs?: AXPCommandSchemaPropertyDefinition[];
+    outcomes: AXPCommandOutcomeDefinition;
+    ai?: AXPCommandAiMetadata;
+    /** Optional list of surfaces that may list or invoke this command as a tool/activity. */
+    capabilities?: AXPCommandCapability[];
+}
+
+/**
+ * Typed identity helper for command metadata sidecars.
+ */
+declare function defineCommand<T extends AXPCommandMetadataDefinition>(definition: T): T;
+
+type AXPCommandExecutionStage = 'before' | 'after';
+interface AXPCommandExecutionEvent<TInput = unknown, TResult = unknown> {
+    stage: AXPCommandExecutionStage;
+    key: string;
+    input: TInput;
+    success?: boolean;
+    result?: AXPExecuteCommandResult<TResult> | null;
+    error?: unknown;
+}
+type CommandExecutionHandler<TInput, TResult> = (event: AXPCommandExecutionEvent<TInput, TResult>) => void;
+declare class AXPCommandEventsService {
+    private readonly broadcast;
+    private readonly distributedEvents;
+    listen<TInput = unknown, TResult = unknown>(handler: CommandExecutionHandler<TInput, TResult>): () => void;
+    emit<TInput = unknown, TResult = unknown>(event: AXPCommandExecutionEvent<TInput, TResult>): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPCommandEventsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPCommandEventsService>;
+}
+
+declare class AXPCommandExecutor {
+    private readonly injector;
+    private readonly registry;
+    private readonly extensions;
+    private readonly commandEvents;
+    execute<TInput = any, TResult = any>(key: string, input: TInput): Promise<AXPExecuteCommandResult<TResult> | null>;
+    private getPluginMiddlewares;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPCommandExecutor, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPCommandExecutor>;
 }
 
 /**
@@ -17,6 +177,17 @@ type AXPCommandMiddleware<TInput = any, TResult = any> = (input: TInput, next: (
  */
 declare function composeCommandMiddlewares<TInput, TResult>(middlewares: AXPCommandMiddleware<TInput, TResult>[]): (handler: (input: TInput) => Promise<AXPExecuteCommandResult<TResult>>) => (input: TInput) => Promise<AXPExecuteCommandResult<TResult>>;
 
+interface AXPCommandExtension {
+    target: string | RegExp;
+    middleware: AXPCommandMiddleware;
+}
+declare const AXP_COMMAND_EXTENSION: InjectionToken<AXPCommandExtension[]>;
+
+type AXPExecuteCommandResultPromise<TResult = any> = Promise<AXPExecuteCommandResult<TResult>>;
+interface AXPCommand<TInput = any, TResult = any> {
+    execute(input: TInput): AXPExecuteCommandResultPromise<TResult>;
+}
+
 declare class AXPCommandRegistry {
     private registry;
     private middlewares;
@@ -32,17 +203,6 @@ declare class AXPCommandRegistry {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPCommandRegistry>;
 }
 
-declare class AXPCommandExecutor {
-    private readonly injector;
-    private readonly registry;
-    private readonly extensions;
-    private readonly commandEvents;
-    execute<TInput = any, TResult = any>(key: string, input: TInput): Promise<AXPExecuteCommandResult<TResult> | null>;
-    private getPluginMiddlewares;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPCommandExecutor, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXPCommandExecutor>;
-}
-
 declare class AXPCommandService {
     private readonly registry;
     private readonly executor;
@@ -57,11 +217,12 @@ declare class AXPCommandService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPCommandService>;
 }
 
-interface AXPCommandExtension {
+declare const AXP_COMMAND_MIDDLEWARE_SETUP: InjectionToken<void>;
+type AXPCommandMiddlewareEntry = (AXPCommandMiddleware | {
     target: string | RegExp;
     middleware: AXPCommandMiddleware;
-}
-declare const AXP_COMMAND_EXTENSION: InjectionToken<AXPCommandExtension[]>;
+})[];
+declare function provideCommandMiddleware(entries: AXPCommandMiddlewareEntry): EnvironmentProviders;
 
 declare const AXP_COMMAND_SETUP: InjectionToken<void>;
 type AXPCommandLoader = {
@@ -71,38 +232,70 @@ type AXPCommandLoader = {
 declare function provideCommandSetups(entries: AXPCommandLoader[]): EnvironmentProviders;
 declare function provideCommand(key: string, loader: () => Type<AXPCommand> | Promise<Type<AXPCommand>>): EnvironmentProviders;
 
-declare const AXP_COMMAND_MIDDLEWARE_SETUP: InjectionToken<void>;
-type AXPCommandMiddlewareEntry = (AXPCommandMiddleware | {
-    target: string | RegExp;
-    middleware: AXPCommandMiddleware;
-})[];
-declare function provideCommandMiddleware(entries: AXPCommandMiddlewareEntry): EnvironmentProviders;
+/**
+ * Build-time query metadata for AXPQuery implementations.
+ * Mirrors command metadata shape except there are no `outcomes` (queries only `fetch`).
+ * `inputs` / `outputs` are schema rows (same family as entity optionDefinitions).
+ */
 
-type AXPCommandExecutionStage = 'before' | 'after';
-interface AXPCommandExecutionEvent<TInput = unknown, TResult = unknown> {
-    stage: AXPCommandExecutionStage;
+/** One input/output property description for query definitions (same as command schema rows). */
+type AXPQuerySchemaPropertyDefinition = AXPCommandSchemaPropertyDefinition;
+interface AXPQueryMetadataDefinition {
+    /** Runtime registration key (provideQuerySetups). */
     key: string;
-    input: TInput;
-    success?: boolean;
-    result?: AXPExecuteCommandResult<TResult> | null;
-    error?: unknown;
-}
-type CommandExecutionHandler<TInput, TResult> = (event: AXPCommandExecutionEvent<TInput, TResult>) => void;
-declare class AXPCommandEventsService {
-    private readonly broadcast;
-    private readonly distributedEvents;
-    listen<TInput = unknown, TResult = unknown>(handler: CommandExecutionHandler<TInput, TResult>): () => void;
-    emit<TInput = unknown, TResult = unknown>(event: AXPCommandExecutionEvent<TInput, TResult>): Promise<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPCommandEventsService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXPCommandEventsService>;
+    title: string;
+    description: string;
+    executionMode: AXPCommandExecutionMode;
+    /** Query input / filter parameters as schema rows. */
+    inputs?: AXPQuerySchemaPropertyDefinition[];
+    /** Documented result shape as schema rows. */
+    outputs?: AXPQuerySchemaPropertyDefinition[];
+    ai?: AXPCommandAiMetadata;
+    /** Optional list of surfaces that may list or invoke this query as a tool (e.g. AI assistants). */
+    capabilities?: AXPCommandCapability[];
 }
 
+/**
+ * Typed identity helper for query metadata sidecars.
+ */
+declare function defineQuery<T extends AXPQueryMetadataDefinition>(definition: T): T;
+
+type AXPQueryMiddleware<TInput = any, TResult = any> = (input: TInput, next: (input: TInput) => Promise<TResult>) => Promise<TResult>;
+declare function composeQueryMiddlewares<TInput, TResult>(middlewares: AXPQueryMiddleware<TInput, TResult>[]): (handler: (input: TInput) => Promise<TResult>) => (input: TInput) => Promise<TResult>;
+
+declare const AXP_QUERY_MIDDLEWARE_SETUP: InjectionToken<void>;
+type AXPQueryMiddlewareEntry = (AXPQueryMiddleware | {
+    key: string;
+    middleware: AXPQueryMiddleware;
+})[];
+declare function provideQueryMiddleware(entries: AXPQueryMiddlewareEntry): EnvironmentProviders;
+
 interface AXPQuery<TInput = any, TResult = any> {
     fetch(input: TInput): Promise<TResult>;
 }
 
-type AXPQueryMiddleware<TInput = any, TResult = any> = (input: TInput, next: (input: TInput) => Promise<TResult>) => Promise<TResult>;
-declare function composeQueryMiddlewares<TInput, TResult>(middlewares: AXPQueryMiddleware<TInput, TResult>[]): (handler: (input: TInput) => Promise<TResult>) => (input: TInput) => Promise<TResult>;
+declare const AXP_QUERY_SETUP: InjectionToken<void>;
+type AXPQueryLoaderEntry = {
+    key: string;
+    loader: () => Type<AXPQuery> | Promise<Type<AXPQuery>>;
+};
+declare function provideQuerySetups(entries: AXPQueryLoaderEntry[]): EnvironmentProviders;
+
+declare class AXPQueryExecutor {
+    private readonly injector;
+    private readonly registry;
+    private readonly extensions;
+    fetch<TInput = any, TResult = any>(key: string, input: TInput): Promise<TResult | null>;
+    private getPluginMiddlewares;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPQueryExecutor, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPQueryExecutor>;
+}
+
+interface AXPQueryExtension {
+    target: string | RegExp;
+    middleware: AXPQueryMiddleware;
+}
+declare const AXP_QUERY_EXTENSION: InjectionToken<AXPQueryExtension[]>;
 
 declare class AXPQueryRegistry {
     private registry;
@@ -119,16 +312,6 @@ declare class AXPQueryRegistry {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPQueryRegistry>;
 }
 
-declare class AXPQueryExecutor {
-    private readonly injector;
-    private readonly registry;
-    private readonly extensions;
-    fetch<TInput = any, TResult = any>(key: string, input: TInput): Promise<TResult | null>;
-    private getPluginMiddlewares;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPQueryExecutor, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXPQueryExecutor>;
-}
-
 declare class AXPQueryService {
     private readonly registry;
     private readonly executor;
@@ -143,26 +326,6 @@ declare class AXPQueryService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPQueryService>;
 }
 
-interface AXPQueryExtension {
-    target: string | RegExp;
-    middleware: AXPQueryMiddleware;
-}
-declare const AXP_QUERY_EXTENSION: InjectionToken<AXPQueryExtension[]>;
-
-declare const AXP_QUERY_SETUP: InjectionToken<void>;
-type AXPQueryLoaderEntry = {
-    key: string;
-    loader: () => Type<AXPQuery> | Promise<Type<AXPQuery>>;
-};
-declare function provideQuerySetups(entries: AXPQueryLoaderEntry[]): EnvironmentProviders;
-
-declare const AXP_QUERY_MIDDLEWARE_SETUP: InjectionToken<void>;
-type AXPQueryMiddlewareEntry = (AXPQueryMiddleware | {
-    key: string;
-    middleware: AXPQueryMiddleware;
-})[];
-declare function provideQueryMiddleware(entries: AXPQueryMiddlewareEntry): EnvironmentProviders;
-
 interface AXPViewProvider<TInput = any> {
     provide(input: TInput): Promise<AXPViewDefinition>;
 }
@@ -303,5 +466,5 @@ declare class AXPRuntimeModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<AXPRuntimeModule>;
 }
 
-export { AXPCommandEventsService, AXPCommandExecutor, AXPCommandRegistry, AXPCommandService, AXPPolicyEngineContext, AXPPolicyEngineDirective, AXPPolicyEngineRegistry, AXPPolicyEngineService, AXPQueryExecutor, AXPQueryRegistry, AXPQueryService, AXPRuntimeModule, AXPViewExecutor, AXPViewRegistry, AXPViewService, AXP_COMMAND_EXTENSION, AXP_COMMAND_MIDDLEWARE_SETUP, AXP_COMMAND_SETUP, AXP_POLICY_ENGINE_MIDDLEWARE_SETUP, AXP_POLICY_EXTENSION, AXP_QUERY_EXTENSION, AXP_QUERY_MIDDLEWARE_SETUP, AXP_QUERY_SETUP, AXP_VIEW_EXTENSION, AXP_VIEW_SETUP, composeCommandMiddlewares, composePolicyEngineMiddlewares, composeQueryMiddlewares, composeViewMiddlewares, provideCommand, provideCommandMiddleware, provideCommandSetups, providePolicySetups, provideQueryMiddleware, provideQuerySetups, provideViewSetup, provideViewSetups };
-export type { AXPCommand, AXPCommandExecutionEvent, AXPCommandExecutionStage, AXPCommandExtension, AXPCommandMiddleware, AXPExecuteCommandResultPromise, AXPPolicy, AXPPolicyEngineMiddleware, AXPPolicyExtension, AXPQuery, AXPQueryExtension, AXPQueryMiddleware, AXPViewExtension, AXPViewMiddleware, AXPViewProvider };
+export { AXPCommandEventsService, AXPCommandExecutor, AXPCommandRegistry, AXPCommandService, AXPPolicyEngineContext, AXPPolicyEngineDirective, AXPPolicyEngineRegistry, AXPPolicyEngineService, AXPQueryExecutor, AXPQueryRegistry, AXPQueryService, AXPRuntimeModule, AXPViewExecutor, AXPViewRegistry, AXPViewService, AXP_COMMAND_EXTENSION, AXP_COMMAND_MIDDLEWARE_SETUP, AXP_COMMAND_SETUP, AXP_POLICY_ENGINE_MIDDLEWARE_SETUP, AXP_POLICY_EXTENSION, AXP_QUERY_EXTENSION, AXP_QUERY_MIDDLEWARE_SETUP, AXP_QUERY_SETUP, AXP_VIEW_EXTENSION, AXP_VIEW_SETUP, composeCommandMiddlewares, composePolicyEngineMiddlewares, composeQueryMiddlewares, composeViewMiddlewares, defineCommand, defineQuery, provideCommand, provideCommandMiddleware, provideCommandSetups, providePolicySetups, provideQueryMiddleware, provideQuerySetups, provideViewSetup, provideViewSetups };
+export type { AXPCommand, AXPCommandAiContractsMetadata, AXPCommandAiMetadata, AXPCommandAiNextStepMetadata, AXPCommandAiPerformanceCost, AXPCommandAiPerformanceMetadata, AXPCommandAiResultSemanticsMetadata, AXPCommandAiSafetyKind, AXPCommandAiSafetyMetadata, AXPCommandAiUsageMetadata, AXPCommandCapability, AXPCommandExecutionEvent, AXPCommandExecutionMode, AXPCommandExecutionStage, AXPCommandExtension, AXPCommandInterfaceDefinitionValue, AXPCommandMetadataDefinition, AXPCommandMiddleware, AXPCommandOutcomeDefinition, AXPCommandSchemaPropertyDefinition, AXPCommandValidationRuleValue, AXPExecuteCommandResultPromise, AXPPolicy, AXPPolicyEngineMiddleware, AXPPolicyExtension, AXPQuery, AXPQueryExtension, AXPQueryMetadataDefinition, AXPQueryMiddleware, AXPQuerySchemaPropertyDefinition, AXPViewExtension, AXPViewMiddleware, AXPViewProvider };

package/{themes/default/index.d.ts → types/acorex-platform-themes-default.d.ts}

@@ -4,11 +4,14 @@ import { Signal } from '@angular/core';
 import * as _acorex_platform_themes_shared from '@acorex/platform/themes/shared';
 import { AXValueChangedEvent } from '@acorex/cdk/common';
 import { AXActionSheetService } from '@acorex/components/action-sheet';
-import { AXDataTableComponent, AXRowCommandItem, AXDataTableRowDbClick, AXRowCommandItemClickEvent } from '@acorex/components/data-table';
+import { AXDataTableComponent, AXRowCommandItem, AXDataTableRowDbClick, AXRowCommandItemClickEvent, onColumnSizeChangedEvent, AXColumnsOrderChangedEvent } from '@acorex/components/data-table';
 import { AXUnsubscriber } from '@acorex/core/utils';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPDeviceService } from '@acorex/platform/core';
-import { AXPEntityCommandTriggerViewModel, AXPEntityDetailListViewModel } from '@acorex/platform/layout/entity';
+import { AXPDeviceService, AXPBreadcrumbItem, AXPActionMenuItem, AXPExecuteCommand } from '@acorex/platform/core';
+import { AXPEntityCommandTriggerViewModel, AXPEntityDetailListViewModel, AXPEntityMasterListViewModel } from '@acorex/platform/layout/entity';
+import { AXPlatform } from '@acorex/core/platform';
+import { AXDataPagerChangedEvent } from '@acorex/components/data-pager';
+import { AXPPageLayoutBaseComponent } from '@acorex/platform/layout/views';
 import * as _acorex_platform_common from '@acorex/platform/common';
 import { AXPMenuItem, AXPSettingsService, AXPMenuVisibilityService } from '@acorex/platform/common';
 import { AXPTaskBadgeService } from '@acorex/platform/layout/components';
@@ -92,6 +95,103 @@ declare class AXPEntityDetailListViewComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityDetailListViewComponent, "axp-entity-detail-list-view", never, { "vm": { "alias": "viewModel"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+declare class AXPEntityMasterListViewComponent extends AXPPageLayoutBaseComponent {
+    protected platform: AXPlatform;
+    private activeRoute;
+    private router;
+    protected readonly vm: AXPEntityMasterListViewModel;
+    protected store: {
+        currentMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPThemeMode>;
+        currentPalette: _angular_core.Signal<string>;
+        systemThemeMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPThemeMode>;
+        font: _ngrx_signals.DeepSignal<{
+            family: string;
+            size: string;
+        }>;
+        overlayLoading: _angular_core.Signal<boolean>;
+        navigationLoading: _angular_core.Signal<boolean>;
+        overlayLoadingTaskCount: _angular_core.Signal<number>;
+        navigationLoadingTaskCount: _angular_core.Signal<number>;
+        sideMenuState: _angular_core.Signal<_acorex_platform_themes_shared.AXPSideMenuState>;
+        sideMenuWidth: _angular_core.Signal<number>;
+        menuOrientation: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuOrientation>;
+        isPrinting: _angular_core.Signal<boolean>;
+        isDarkMode: _angular_core.Signal<boolean>;
+        isLightMode: _angular_core.Signal<boolean>;
+        isSystemMode: _angular_core.Signal<boolean>;
+        isSideMenuOpen: _angular_core.Signal<boolean>;
+        isOverlayLoading: _angular_core.Signal<boolean>;
+        isNavigationLoading: _angular_core.Signal<boolean>;
+        isMenuHorizontal: _angular_core.Signal<boolean>;
+        changeThemeMode: (theme: _acorex_platform_themes_shared.AXPThemeMode) => void;
+        openSideMenu: () => void;
+        closeSideMenu: () => void;
+        setSideMenuWidth: (width: number) => void;
+        toggleSideMenu: () => void;
+        setNavigationLoading: (value: boolean, delay?: number) => void;
+        setOverlayLoading: (value: boolean, delay?: number) => void;
+        loadSettings: () => Promise<void>;
+    } & _ngrx_signals.StateSource<{
+        currentMode: _acorex_platform_themes_shared.AXPThemeMode;
+        currentPalette: string;
+        systemThemeMode: _acorex_platform_themes_shared.AXPThemeMode;
+        font: {
+            family: string;
+            size: string;
+        };
+        overlayLoading: boolean;
+        navigationLoading: boolean;
+        overlayLoadingTaskCount: number;
+        navigationLoadingTaskCount: number;
+        sideMenuState: _acorex_platform_themes_shared.AXPSideMenuState;
+        sideMenuWidth: number;
+        menuOrientation: _acorex_platform_themes_shared.AXPMenuOrientation;
+        isPrinting: boolean;
+    }>;
+    protected searchBarShown: _angular_core.WritableSignal<boolean>;
+    protected activeEndSideView: _angular_core.WritableSignal<"sort" | "filter" | "column">;
+    protected categorySearchValue: _angular_core.WritableSignal<string>;
+    protected grid: _angular_core.Signal<AXDataTableComponent | undefined>;
+    private queryParamSub?;
+    private initializedFromRoute;
+    constructor(platform: AXPlatform);
+    ngOnInit(): Promise<void>;
+    ngAfterViewInit(): Promise<void>;
+    protected onColumnSizeChanged(e: onColumnSizeChangedEvent): void;
+    protected onPageChanged(e: AXDataPagerChangedEvent): void;
+    protected onColumnsOrderChanged(e: AXColumnsOrderChangedEvent): void;
+    protected dropdownRowItems(rowData: any): Promise<AXRowCommandItem[]>;
+    private commandRowItems;
+    protected handleRowDbClick(e: AXDataTableRowDbClick): Promise<void>;
+    protected getDropdownRowItems: (rowData: unknown) => Promise<AXRowCommandItem[]>;
+    protected getCommandRowItems: () => AXRowCommandItem[];
+    protected handleRowCommandClick(e: AXRowCommandItemClickEvent): Promise<void>;
+    protected handleSelectedRowsChange(rows: unknown[]): Promise<void>;
+    /**
+     * After refreshing a row's children (e.g. when a new child was created), update the parent row's
+     * hasChild so the expand icon is shown. The list query sets hasChild from childrenCount only on
+     * initial load; refreshItemChildren does not re-fetch the parent, so we patch it here.
+     */
+    private updateParentHasChildAfterRefresh;
+    private findItemById;
+    protected makeResponsive<t>(value: t): t | string;
+    protected toggleSideBar(sideBar?: 'column' | 'filter' | 'sort'): void;
+    protected toggleSearchBar(): void;
+    protected handleResetClick(sideBar: 'filter' | 'sort' | 'column'): void;
+    protected handleApplyClick(sideBar: 'filter' | 'sort' | 'column'): void;
+    ngOnDestroy(): void;
+    toggleCategoryDrawer(): void;
+    getPageTitle(): string;
+    getPageDescription(): Promise<string>;
+    getPageBreadcrumbs(): AXPBreadcrumbItem[];
+    getPrimaryMenuItems(): Promise<AXPActionMenuItem[]>;
+    getSecondaryMenuItems(): Promise<AXPActionMenuItem[]>;
+    execute(command: AXPExecuteCommand): Promise<void>;
+    protected handleUnselectAll(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityMasterListViewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityMasterListViewComponent, "axp-entity-master-list", never, {}, {}, never, never, true, never>;
+}
+
 declare class AXPRootLayoutFooterComponent {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPRootLayoutFooterComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPRootLayoutFooterComponent, "axp-dashboard-admin-footer", never, {}, {}, never, never, true, never>;
@@ -470,4 +570,4 @@ declare class AXPDefaultThemeModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXPDefaultThemeModule>;
 }
 
-export { AXPDefaultThemeModule, AXPEntityDetailListViewComponent, AXPRootHorizontalLayoutComponent, AXPRootLayoutComponent, AXPRootLayoutFooterComponent, AXPRootLayoutHeaderComponent, AXPRootLayoutMenuComponent, AXPRootVerticalLayoutComponent };
+export { AXPDefaultThemeModule, AXPEntityDetailListViewComponent, AXPEntityMasterListViewComponent, AXPRootHorizontalLayoutComponent, AXPRootLayoutComponent, AXPRootLayoutFooterComponent, AXPRootLayoutHeaderComponent, AXPRootLayoutMenuComponent, AXPRootVerticalLayoutComponent };

package/{workflow/index.d.ts → types/acorex-platform-workflow.d.ts}

@@ -4,7 +4,6 @@ import * as i0 from '@angular/core';
 import { Type, ModuleWithProviders, Injector, InjectionToken } from '@angular/core';
 import { AXPValidationRules, AXPEntityOp, AXPCategoryEntity, AXPExpressionEvaluatorScope } from '@acorex/platform/core';
 import { AXPWidgetTypesMap } from '@acorex/platform/layout/widget-core';
-import { AXPCommand, AXPExecuteCommandResultPromise } from '@acorex/platform/runtime';
 
 declare class AXPWorkflowError extends Error {
     inner: Error | null;
@@ -626,6 +625,10 @@ interface AXPWorkflowState {
      * Finished at timestamp (ISO date-time, nullable).
      */
     finishedAt?: string | null;
+    /**
+     * Total number of activities/steps in the workflow (for progress display).
+     */
+    totalSteps?: number;
 }
 /**
  * Workflow instance (stored in database).
@@ -797,25 +800,6 @@ interface AXPActivityDefinition {
      */
     isContainer?: boolean;
 }
-/**
- * Activity - Command with specific TResult structure.
- * Extends AXPCommand with a fixed TResult that includes output and outcomes.
- * No additional properties beyond AXPCommand - pure command interface.
- */
-interface AXPActivity<TInput = any, TOutput = any> extends AXPCommand<TInput, {
-    output: TOutput;
-    outcomes: Record<string, any>;
-}> {
-    /**
-     * Execute the activity as a command.
-     * @param input - Activity input data
-     * @returns Promise with output and outcomes
-     */
-    execute(input: TInput): AXPExecuteCommandResultPromise<{
-        output: TOutput;
-        outcomes: Record<string, any>;
-    }>;
-}
 
 type AXPActivityProviderToken = AXPActivityProvider | Promise<AXPActivityProvider>;
 declare const AXP_ACTIVITY_PROVIDER: InjectionToken<AXPActivityProviderToken[]>;
@@ -915,6 +899,11 @@ declare class AXPActivityDefinitionService {
      * @returns Activity definition or undefined if not found
      */
     getActivityByName(name: string): Promise<AXPActivityDefinition | undefined>;
+    /**
+     * Get all activity definitions (flat list) by loading root categories and their activities.
+     * Used by activity selector UIs (e.g. automation command configurator).
+     */
+    getAllActivities(): Promise<AXPActivityDefinition[]>;
     /**
      * Get category ID containing a specific activity definition
      *
@@ -1080,7 +1069,7 @@ interface AXPResumeWorkflowRequest {
     /**
      * User action outcome (e.g., 'Confirmed', 'Cancelled').
      */
-    outcome: string;
+    outcome?: string;
     /**
      * Optional user input data.
      */
@@ -1170,7 +1159,7 @@ interface AXPFrontActivityCompleteRequest {
     instanceId: string;
     activityNode: string;
     output: Record<string, any>;
-    outcome: string;
+    outcome?: string;
 }
 interface AXPFrontActivityCompleteResponse {
     /**
@@ -1353,19 +1342,17 @@ declare class AXPWorkflowManager {
      */
     private readonly CACHE_TTL;
     /**
-     * Execute frontend activities interactively until reaching human-task or completion.
+     * Execute frontend activities interactively until reaching workflow-activity:human-task or completion.
      *
-     * This method handles the interactive flow between frontend and backend:
-     * 1. Executes frontend activity (ui-activity)
-     * 2. Sends result to backend via frontActivtyComplete
-     * 3. If backend returns nextTask (frontend activity), repeats the process
-     * 4. Continues until workflow completes or reaches human-task
+     * Interactive = show form/popup immediately (user sees and acts). Only workflow-activity:human-task
+     * is not interactive (goes to task board). Other frontend activities (show-layout-popup, show-toast, etc.)
+     * even with taskType human-task in definition are executed here.
      *
      * @param instanceId - Workflow instance ID
      * @param task - Current task to execute
      * @param state - Current workflow state
      * @param lastActivityOutput - Last activity output (for expression evaluation)
-     * @returns Final result with nextTask (if human-task) or completion status
+     * @returns Final result with nextTask (if workflow-activity:human-task) or completion status
      */
     private executeInteractiveFlow;
     /**
@@ -1581,6 +1568,22 @@ interface WorkflowExpressionContext {
  * ```
  */
 declare class WorkflowExpressionScopeService {
+    /**
+     * Collect dot-notation key-value pairs from nested objects so that e.g.
+     * { metadata: { "metadata.questionnaire.id": "x" } } becomes { "metadata.questionnaire.id": "x" } at root.
+     * Top-level non-dot keys are kept as-is.
+     */
+    private flattenDotKeysFromTree;
+    /**
+     * Expand flat keys with dots into nested objects.
+     * e.g. { "metadata.questionnaire.id": "x" } -> { metadata: { questionnaire: { id: "x" } } }.
+     */
+    private expandDotKeys;
+    /**
+     * Normalize workflow input so that flat dot-notation keys (e.g. from form schema
+     * "metadata.questionnaire.id") become nested for expression access (inputs.metadata.questionnaire.id).
+     */
+    private normalizeInputs;
     /**
      * Build expression evaluation scope for workflow activities.
      *
@@ -1800,4 +1803,4 @@ declare class AXPWorkflowDefinitionService {
 }
 
 export { AXPActivityDefinitionService, AXPWorkflowAction, AXPWorkflowContext, AXPWorkflowDefinitionService, AXPWorkflowError, AXPWorkflowEventService, AXPWorkflowFunction, AXPWorkflowLocalEngine, AXPWorkflowManager, AXPWorkflowModule, AXPWorkflowRegistryService, AXPWorkflowService, AXP_ACTIVITY_CATEGORY_PROVIDER, AXP_ACTIVITY_PROVIDER, AXP_WORKFLOW_CATEGORY_PROVIDER, AXP_WORKFLOW_ENGINE, AXP_WORKFLOW_PROVIDER, ActivityExecutor, WorkflowExpressionScopeService, createWorkFlowEvent, ofType };
-export type { AXPActivity, AXPActivityCategory, AXPActivityCategoryProvider, AXPActivityCategoryProviderToken, AXPActivityDefinition, AXPActivityExecutionContextState, AXPActivityIncident, AXPActivityProvider, AXPActivityProviderToken, AXPActivityStatus, AXPActivityVariable, AXPBookmark, AXPCompletionCallbackState, AXPConnection, AXPElsaWorkflowExtensions, AXPExceptionState, AXPFrontActivityCompleteRequest, AXPFrontActivityCompleteResponse, AXPGetWorkflowStateRequest, AXPResumeWorkflowRequest, AXPResumeWorkflowResponse, AXPStartWorkflowRequest, AXPStartWorkflowResponse, AXPTaskType, AXPVariableDefinition, AXPWorkflow, AXPWorkflowActionInput, AXPWorkflowActivityInstance, AXPWorkflowBinding, AXPWorkflowCategory, AXPWorkflowCategoryProvider, AXPWorkflowCategoryProviderToken, AXPWorkflowCondition, AXPWorkflowConditionType, AXPWorkflowDefinition, AXPWorkflowDescriptorBase, AXPWorkflowDescriptorSchemaBase, AXPWorkflowEngine, AXPWorkflowEvent, AXPWorkflowExtensions, AXPWorkflowFaultState, AXPWorkflowGraph, AXPWorkflowInputDescriptor, AXPWorkflowInstance, AXPWorkflowInstanceState, AXPWorkflowModuleConfigs, AXPWorkflowNextStep, AXPWorkflowOutputDescriptor, AXPWorkflowProvider, AXPWorkflowProviderToken, AXPWorkflowState, AXPWorkflowStatus, AXPWorkflowStep, AXPWorkflowSubStatus, AXPWorkflowTask, ActivityExecutionResult, WorkflowCompleteResult, WorkflowExpressionContext, WorkflowResumeResult, WorkflowStartResult };
+export type { AXPActivityCategory, AXPActivityCategoryProvider, AXPActivityCategoryProviderToken, AXPActivityDefinition, AXPActivityExecutionContextState, AXPActivityIncident, AXPActivityProvider, AXPActivityProviderToken, AXPActivityStatus, AXPActivityVariable, AXPBookmark, AXPCompletionCallbackState, AXPConnection, AXPElsaWorkflowExtensions, AXPExceptionState, AXPFrontActivityCompleteRequest, AXPFrontActivityCompleteResponse, AXPGetWorkflowStateRequest, AXPResumeWorkflowRequest, AXPResumeWorkflowResponse, AXPStartWorkflowRequest, AXPStartWorkflowResponse, AXPTaskType, AXPVariableDefinition, AXPWorkflow, AXPWorkflowActionInput, AXPWorkflowActivityInstance, AXPWorkflowBinding, AXPWorkflowCategory, AXPWorkflowCategoryProvider, AXPWorkflowCategoryProviderToken, AXPWorkflowCondition, AXPWorkflowConditionType, AXPWorkflowDefinition, AXPWorkflowDescriptorBase, AXPWorkflowDescriptorSchemaBase, AXPWorkflowEngine, AXPWorkflowEvent, AXPWorkflowExtensions, AXPWorkflowFaultState, AXPWorkflowGraph, AXPWorkflowInputDescriptor, AXPWorkflowInstance, AXPWorkflowInstanceState, AXPWorkflowModuleConfigs, AXPWorkflowNextStep, AXPWorkflowOutputDescriptor, AXPWorkflowProvider, AXPWorkflowProviderToken, AXPWorkflowState, AXPWorkflowStatus, AXPWorkflowStep, AXPWorkflowSubStatus, AXPWorkflowTask, ActivityExecutionResult, WorkflowCompleteResult, WorkflowExpressionContext, WorkflowResumeResult, WorkflowStartResult };