@acorex/platform 20.6.0-next.1 → 20.6.0-next.11

package/runtime/index.d.ts

@@ -1,14 +1,21 @@
+import { AXPExecuteCommandResult, AXPViewDefinition, AXPMetaData } from '@acorex/platform/core';
 import * as i0 from '@angular/core';
 import { InjectionToken, Type, EnvironmentProviders, Provider } from '@angular/core';
-import { AXPViewDefinition, AXPMetaData } from '@acorex/platform/core';
 import { AXComponent } from '@acorex/cdk/common';
 
+type AXPExecuteCommandResultPromise<TResult = any> = Promise<AXPExecuteCommandResult<TResult>>;
 interface AXPCommand<TInput = any, TResult = any> {
-    execute(input: TInput): Promise<TResult>;
+    execute(input: TInput): AXPExecuteCommandResultPromise<TResult>;
 }
 
-type AXPCommandMiddleware<TInput = any, TResult = any> = (input: TInput, next: (input: TInput) => Promise<TResult>) => Promise<TResult>;
-declare function composeCommandMiddlewares<TInput, TResult>(middlewares: AXPCommandMiddleware<TInput, TResult>[]): (handler: (input: TInput) => Promise<TResult>) => (input: TInput) => Promise<TResult>;
+/**
+ * Represents a middleware function in the command execution pipeline.
+ */
+type AXPCommandMiddleware<TInput = any, TResult = any> = (input: TInput, next: (input: TInput) => Promise<AXPExecuteCommandResult<TResult>>) => Promise<AXPExecuteCommandResult<TResult>>;
+/**
+ * Creates a composed handler by chaining the provided command middlewares.
+ */
+declare function composeCommandMiddlewares<TInput, TResult>(middlewares: AXPCommandMiddleware<TInput, TResult>[]): (handler: (input: TInput) => Promise<AXPExecuteCommandResult<TResult>>) => (input: TInput) => Promise<AXPExecuteCommandResult<TResult>>;
 
 declare class AXPCommandRegistry {
     private registry;
@@ -29,7 +36,8 @@ declare class AXPCommandExecutor {
     private readonly injector;
     private readonly registry;
     private readonly extensions;
-    execute<TInput = any, TResult = any>(key: string, input: TInput): Promise<TResult | null>;
+    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>;
@@ -44,7 +52,7 @@ declare class AXPCommandService {
     exists(key: string): boolean;
     getRegisteredKeys(): string[];
     clear(): void;
-    execute<TInput = any, TResult = any>(key: string, input: TInput): Promise<TResult | null>;
+    execute<TInput = any, TResult = any>(key: string, input: TInput): Promise<AXPExecuteCommandResult<TResult> | null>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPCommandService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPCommandService>;
 }
@@ -61,6 +69,7 @@ type AXPCommandLoader = {
     command: () => Type<AXPCommand> | Promise<Type<AXPCommand>>;
 };
 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 | {
@@ -69,6 +78,25 @@ type AXPCommandMiddlewareEntry = (AXPCommandMiddleware | {
 })[];
 declare function provideCommandMiddleware(entries: AXPCommandMiddlewareEntry): EnvironmentProviders;
 
+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>;
+}
+
 interface AXPQuery<TInput = any, TResult = any> {
     fetch(input: TInput): Promise<TResult>;
 }
@@ -275,5 +303,5 @@ declare class AXPRuntimeModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<AXPRuntimeModule>;
 }
 
-export { 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, provideCommandMiddleware, provideCommandSetups, providePolicySetups, provideQueryMiddleware, provideQuerySetups, provideViewSetup, provideViewSetups };
-export type { AXPCommand, AXPCommandExtension, AXPCommandMiddleware, 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, 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 };

package/themes/default/index.d.ts

@@ -1,18 +1,17 @@
-import * as _acorex_components_button from '@acorex/components/button';
 import * as _ngrx_signals from '@ngrx/signals';
 import * as _angular_core from '@angular/core';
 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, AXDataTableRowDbClick, AXRowCommandItem, AXRowCommandItemClickEvent } from '@acorex/components/data-table';
+import { AXDataTableComponent, AXRowCommandItem, AXDataTableRowDbClick, AXRowCommandItemClickEvent } from '@acorex/components/data-table';
 import { AXUnsubscriber } from '@acorex/core/utils';
 import { AXPEntityCommandTriggerViewModel, AXPEntityDetailListViewModel } from '@acorex/platform/layout/entity';
 import * as _acorex_platform_core from '@acorex/platform/core';
 import * as _acorex_platform_common from '@acorex/platform/common';
 import { AXPMenuItem, AXPSettingService } from '@acorex/platform/common';
 import { AXPTaskBadgeService } from '@acorex/platform/layout/components';
-import { Router } from '@angular/router';
+import { Router, UrlTree } from '@angular/router';
 import { AXDrawerComponent } from '@acorex/components/drawer';
 
 declare class AXPEntityDetailListViewComponent {
@@ -91,8 +90,8 @@ declare class AXPEntityDetailListViewComponent {
     handleChangeSearchValue(e: AXValueChangedEvent): void;
     protected subscribeActionEvents(): void;
     ngAfterViewInit(): void;
-    protected dropdownRowItems: _angular_core.Signal<_acorex_components_button.AXButtonItemListItem[]>;
-    protected commandRowItems: _angular_core.Signal<_acorex_components_button.AXButtonItemListItem[]>;
+    protected dropdownRowItems: _angular_core.Signal<AXRowCommandItem[]>;
+    protected commandRowItems: _angular_core.Signal<AXRowCommandItem[]>;
     protected handleRowDbClick(e: AXDataTableRowDbClick): Promise<void>;
     protected getCommandRowItems: () => AXRowCommandItem[];
     protected getDropdownRowItems: (rowData: unknown) => Promise<AXRowCommandItem[]>;
@@ -219,9 +218,32 @@ declare class AXPRootLayoutMenuComponent {
     protected badgeVisible: _angular_core.WritableSignal<boolean>;
     constructor();
     ngOnInit(): Promise<void>;
-    onMenuItemClick(item: AXPMenuItem): void;
+    onMenuItemClick(item: AXPMenuItem, hasRouterLink?: boolean): void;
     protected sort(items: AXPMenuItem[]): AXPMenuItem[];
     protected getMenuBadge(item: AXPMenuItem): Signal<number>;
+    /**
+     * Builds a UrlTree that can be consumed by the routerLink directive when the menu item targets
+     * an internal route. When the item does not represent an internal route, null is returned so the
+     * command execution pipeline remains responsible for navigation.
+     */
+    protected getRouterLink(item: AXPMenuItem): UrlTree | null;
+    /**
+     * Extracts internal navigation data regardless of whether it is provided via the legacy `path`
+     * property, a direct navigate command, or the execution command wrapper.
+     */
+    private extractRouterNavigation;
+    /**
+     * Determines whether routerLink can safely be used based on the target path and navigation
+     * extras. If the navigation requires additional runtime behaviour (e.g., opening in a new tab),
+     * we fallback to the imperative command pipeline.
+     */
+    private isRouterLinkCompatible;
+    /**
+     * Ensures router links include a leading slash while preserving any query parameters or
+     * fragments present in the original path.
+     */
+    private normalizeRouterPath;
+    private isExternalNavigation;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPRootLayoutMenuComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPRootLayoutMenuComponent, "axp-side-menu", never, {}, {}, never, never, true, never>;
 }