@acorex-platform/framework-client 0.0.30 → 0.0.32

package/types/acorex-platform-framework-client-realtime.d.ts

@@ -23,6 +23,22 @@ interface AXPRealtimeInboxRefreshPayload {
     /** Optional hint so clients can apply deletes/archives without a fetch. */
     op?: 'created' | 'updated' | 'deleted' | 'archived';
 }
+interface AXPRealtimeBackgroundJobTrayRefreshPayload {
+    jobId?: string;
+    /**
+     * Hint for client tray sync.
+     * Prefer applying locally; full list fetch only when the job is missing (e.g. `created`).
+     */
+    op?: 'created' | 'updated' | 'completed' | 'failed' | 'cancelled' | 'dismissed';
+    status?: string;
+    progress?: number;
+    statusText?: string;
+    currentStep?: string;
+    supportsProgress?: boolean;
+    keepInTrayAfterComplete?: boolean;
+    completedAt?: string;
+    trayDismissedAt?: string;
+}
 interface AXPRealtimeConversationMessagePayload {
     conversationId: string;
     messageId: string;
@@ -49,6 +65,16 @@ interface AXPRealtimeConversationCallPayload {
     /** Optional call correlation id shared across invite → accept. */
     callId?: string;
 }
+interface AXPRealtimeBulkProgressPayload {
+    executionId: string;
+    entity: string;
+    name: string;
+    current: number;
+    total: number;
+    succeeded: number;
+    failed: number;
+    status: 'running' | 'completed';
+}
 interface AXPRealtimeEntityMutationPayload {
     entityName: string;
     operation: 'created' | 'updated' | 'deleted';
@@ -101,10 +127,12 @@ interface AXPRealtimeTopicHandlerRegistration {
 }
 
 declare const AXP_REALTIME_TOPIC_INBOX_REFRESH = "inbox.refresh";
+declare const AXP_REALTIME_TOPIC_BACKGROUND_JOB_TRAY_REFRESH = "background-job.tray.refresh";
 declare const AXP_REALTIME_TOPIC_CONVERSATION_MESSAGE = "conversation.message";
 declare const AXP_REALTIME_TOPIC_CONVERSATION_TYPING = "conversation.typing";
 declare const AXP_REALTIME_TOPIC_CONVERSATION_CALL = "conversation.call";
 declare const AXP_REALTIME_TOPIC_ENTITY_MUTATION = "entity.mutation";
+declare const AXP_REALTIME_TOPIC_BULK_PROGRESS = "runtime.bulk.progress";
 declare const AXP_REALTIME_TOPIC_USER_PRESENCE = "user.presence";
 declare const AXP_REALTIME_SOCKET_EVENT = "realtime";
 declare const AXP_REALTIME_SUBSCRIBE_CONVERSATION = "subscribe.conversation";
@@ -155,8 +183,11 @@ declare class AXPRealtimeConnectionService extends AXPRealtimeConnectionPort imp
     private readonly config;
     private readonly session;
     private readonly dispatcher;
+    private readonly bulkProgress;
+    private readonly document;
     private socket;
     private statusSub;
+    private wakeListenersBound;
     private readonly joinedConversations;
     private readonly connectionStatusSubject;
     /** Latest Socket.IO connection state for feature modules (e.g. chat). */
@@ -178,6 +209,12 @@ declare class AXPRealtimeConnectionService extends AXPRealtimeConnectionPort imp
     unsubscribePresence(userIds: readonly string[]): void;
     leavePresence(): Promise<void>;
     setPresence(status: 'online' | 'away' | 'busy', source?: 'auto' | 'manual'): Promise<AXPRealtimeUserPresenceSnapshotItem | undefined>;
+    private registerBulkProgressHandler;
+    private bindWakeListeners;
+    private unbindWakeListeners;
+    private readonly onVisibilityResume;
+    private readonly onNetworkResume;
+    private resumeIfAuthorized;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPRealtimeConnectionService, [{ optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPRealtimeConnectionService>;
 }
@@ -273,5 +310,5 @@ declare class AXPUserPresenceIdleService {
 /** Idle without input before automatic Away. Keep in sync with server `AXP_USER_PRESENCE_IDLE_MS`. */
 declare const AXP_USER_PRESENCE_IDLE_MS: number;
 
-export { AXPRealtimeConnectionPort, AXPRealtimeConnectionService, AXPRealtimeDispatcherService, AXPUserPresenceIdleService, AXPUserPresenceService, AXP_REALTIME_CONFIG, AXP_REALTIME_EMIT_TYPING, AXP_REALTIME_PRESENCE_LEAVE, AXP_REALTIME_PRESENCE_SET, AXP_REALTIME_SOCKET_EVENT, AXP_REALTIME_SUBSCRIBE_CONVERSATION, AXP_REALTIME_SUBSCRIBE_PRESENCE, AXP_REALTIME_TOPIC_CONVERSATION_CALL, AXP_REALTIME_TOPIC_CONVERSATION_MESSAGE, AXP_REALTIME_TOPIC_CONVERSATION_TYPING, AXP_REALTIME_TOPIC_ENTITY_MUTATION, AXP_REALTIME_TOPIC_HANDLER, AXP_REALTIME_TOPIC_INBOX_REFRESH, AXP_REALTIME_TOPIC_USER_PRESENCE, AXP_REALTIME_UNSUBSCRIBE_CONVERSATION, AXP_REALTIME_UNSUBSCRIBE_PRESENCE, AXP_USER_PRESENCE_IDLE_MS, isWatchablePresenceUserId, parseUserPresencePayload, presenceDurationBucket, provideRealtime, resolveRealtimeSocketUrl };
-export type { AXPPresenceDurationBucket, AXPProvideRealtimeOptions, AXPRealtimeAudience, AXPRealtimeConfig, AXPRealtimeConnectionStatus, AXPRealtimeConversationCallAction, AXPRealtimeConversationCallMedia, AXPRealtimeConversationCallPayload, AXPRealtimeConversationMessagePayload, AXPRealtimeConversationTypingPayload, AXPRealtimeEntityMutationPayload, AXPRealtimeEnvelope, AXPRealtimeInboxRefreshPayload, AXPRealtimePresenceSetResult, AXPRealtimePresenceSubscribeResult, AXPRealtimeTopicHandler, AXPRealtimeTopicHandlerRegistration, AXPRealtimeUserPresencePayload, AXPRealtimeUserPresenceSnapshotItem, AXPRealtimeUserPresenceSource, AXPRealtimeUserPresenceStatus, AXPUserPresence, AXPUserPresenceSetInput, AXPUserPresenceSource, AXPUserPresenceStatus };
+export { AXPRealtimeConnectionPort, AXPRealtimeConnectionService, AXPRealtimeDispatcherService, AXPUserPresenceIdleService, AXPUserPresenceService, AXP_REALTIME_CONFIG, AXP_REALTIME_EMIT_TYPING, AXP_REALTIME_PRESENCE_LEAVE, AXP_REALTIME_PRESENCE_SET, AXP_REALTIME_SOCKET_EVENT, AXP_REALTIME_SUBSCRIBE_CONVERSATION, AXP_REALTIME_SUBSCRIBE_PRESENCE, AXP_REALTIME_TOPIC_BACKGROUND_JOB_TRAY_REFRESH, AXP_REALTIME_TOPIC_BULK_PROGRESS, AXP_REALTIME_TOPIC_CONVERSATION_CALL, AXP_REALTIME_TOPIC_CONVERSATION_MESSAGE, AXP_REALTIME_TOPIC_CONVERSATION_TYPING, AXP_REALTIME_TOPIC_ENTITY_MUTATION, AXP_REALTIME_TOPIC_HANDLER, AXP_REALTIME_TOPIC_INBOX_REFRESH, AXP_REALTIME_TOPIC_USER_PRESENCE, AXP_REALTIME_UNSUBSCRIBE_CONVERSATION, AXP_REALTIME_UNSUBSCRIBE_PRESENCE, AXP_USER_PRESENCE_IDLE_MS, isWatchablePresenceUserId, parseUserPresencePayload, presenceDurationBucket, provideRealtime, resolveRealtimeSocketUrl };
+export type { AXPPresenceDurationBucket, AXPProvideRealtimeOptions, AXPRealtimeAudience, AXPRealtimeBackgroundJobTrayRefreshPayload, AXPRealtimeBulkProgressPayload, AXPRealtimeConfig, AXPRealtimeConnectionStatus, AXPRealtimeConversationCallAction, AXPRealtimeConversationCallMedia, AXPRealtimeConversationCallPayload, AXPRealtimeConversationMessagePayload, AXPRealtimeConversationTypingPayload, AXPRealtimeEntityMutationPayload, AXPRealtimeEnvelope, AXPRealtimeInboxRefreshPayload, AXPRealtimePresenceSetResult, AXPRealtimePresenceSubscribeResult, AXPRealtimeTopicHandler, AXPRealtimeTopicHandlerRegistration, AXPRealtimeUserPresencePayload, AXPRealtimeUserPresenceSnapshotItem, AXPRealtimeUserPresenceSource, AXPRealtimeUserPresenceStatus, AXPUserPresence, AXPUserPresenceSetInput, AXPUserPresenceSource, AXPUserPresenceStatus };

package/types/acorex-platform-framework-client-runtime.d.ts

@@ -1,7 +1,8 @@
-import { AXPBulkCommandRequest, AXPCommandExecuteResultPromise, AXPBulkCommandResultData, AXPCommandExecuteOptions, AXPCommandMiddleware, AXPCommand, AXPQueryMiddleware, AXPQuery, AXPQueryExecuteOptions, AXPViewProvider } from '@acorex-platform/framework-shared/runtime';
+import { AXPBulkCommandRequest, AXPCommandExecuteResultPromise, AXPBulkCommandResultData, AXPBulkCommandProgress, AXPCommandExecuteOptions, AXPCommandMiddleware, AXPCommand, AXPQueryMiddleware, AXPQuery, AXPQueryExecuteOptions, AXPViewProvider } from '@acorex-platform/framework-shared/runtime';
 export { AXPCommandExecuteOptions, AXPCommandMiddleware, AXPCommandMiddlewareContext, AXPQueryExecuteOptions, AXPQueryMiddleware, AXPQueryMiddlewareContext, AXPQuerySnapshotOption, composeCommandMiddlewares, composeQueryMiddlewares } from '@acorex-platform/framework-shared/runtime';
 import * as i0 from '@angular/core';
 import { InjectionToken, EnvironmentProviders, Type, Provider } from '@angular/core';
+import { Observable } from 'rxjs';
 import { AXPRuntimeCommandResult, AXPRuntimeQueryResult, AXPViewDefinition, AXPMetaData } from '@acorex-platform/framework-shared/core';
 import { AXComponent } from '@acorex/cdk/common';
 
@@ -20,6 +21,35 @@ declare class AXPBulkCommandService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPBulkCommandService>;
 }
 
+interface AXPBulkProgressWatchOptions {
+    /**
+     * `true` — poll GET /progress (socket down).
+     * `false` / omitted — socket only; never call GET /progress.
+     */
+    poll?: boolean;
+    /** Poll interval when `poll` is enabled. Default 250ms. */
+    intervalMs?: number;
+}
+/**
+ * Actor-only progress bus for in-flight bulk commands.
+ *
+ * Prefer realtime (`runtime.bulk.progress` → {@link notify}).
+ * GET /progress only when the caller sets `poll: true` (socket down).
+ */
+declare class AXPBulkProgressChannel {
+    private readonly hooks;
+    private readonly zone;
+    private readonly subject;
+    /** Called by the realtime topic handler when a socket tick arrives. */
+    notify(progress: AXPBulkCommandProgress): void;
+    watch(executionId: string, options?: AXPBulkProgressWatchOptions): Observable<AXPBulkCommandProgress>;
+    private emit;
+    private clearPoll;
+    private pollOnce;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPBulkProgressChannel, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPBulkProgressChannel>;
+}
+
 type AXPCommandExecutionStage = 'before' | 'after';
 interface AXPCommandExecutionEvent<TInput = unknown, TResult = unknown> {
     executionId: string;
@@ -364,13 +394,15 @@ declare class AXPRuntimeModule {
  *
  * Host apps that only consume the client lib and call a different API stack should
  * register {@link provideExternalRuntimeQueryTransport},
- * {@link provideExternalRuntimeCommandTransport}, and
- * {@link provideExternalRuntimeBulkTransport}
+ * {@link provideExternalRuntimeCommandTransport},
+ * {@link provideExternalRuntimeBulkTransport} for {@link AXPRuntimeRemoteHookKeys.CommandExecuteBulk},
+ * and {@link provideBulkProgressPollTransport} for {@link AXPRuntimeRemoteHookKeys.CommandBulkProgress}
  * (see `RUNTIME_REMOTE_BULK_TRANSPORT.md`).
  */
 declare const AXPRuntimeRemoteHookKeys: {
     readonly CommandExecute: "runtime.command.execute";
     readonly CommandExecuteBulk: "runtime.command.execute-bulk";
+    readonly CommandBulkProgress: "runtime.command.bulk-progress";
     readonly QueryExecute: "runtime.query.execute";
 };
 interface AXPRuntimeCommandExecuteHookPayload {
@@ -388,6 +420,12 @@ interface AXPRuntimeCommandExecuteBulkHookPayload {
     handled?: boolean;
     result?: AXPRuntimeCommandResult<AXPBulkCommandResultData> | null;
 }
+interface AXPRuntimeCommandBulkProgressHookPayload {
+    executionId: string;
+    /** Set by a provider when it handled the remote call. */
+    handled?: boolean;
+    progress?: AXPBulkCommandProgress | null;
+}
 interface AXPRuntimeQueryExecuteHookPayload {
     name: string;
     input: unknown;
@@ -548,5 +586,18 @@ interface AXPExternalRuntimeQueryTransportOptions {
  */
 declare function provideExternalRuntimeQueryTransport(transport: AXPExternalRuntimeQueryTransport, options?: AXPExternalRuntimeQueryTransportOptions): Provider[];
 
-export { AXPBulkCommandService, AXPCommandEventsService, AXPCommandExecutor, AXPCommandRegistry, AXPCommandService, AXPPolicyEngineContext, AXPPolicyEngineDirective, AXPPolicyEngineRegistry, AXPPolicyEngineService, AXPQueryEventsService, AXPQueryExecutor, AXPQueryRegistry, AXPQueryService, AXPRuntimeModule, AXPRuntimeRemoteHookKeys, AXPRuntimeTransportHookKeys, AXPRuntimeTransportService, 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, composePolicyEngineMiddlewares, composeViewMiddlewares, provideCommand, provideCommandMiddleware, provideCommandSetups, provideExternalRuntimeBulkTransport, provideExternalRuntimeCommandTransport, provideExternalRuntimeQueryTransport, providePolicySetups, provideQueryMiddleware, provideQuerySetups, provideViewSetup, provideViewSetups };
-export type { AXPCommandExecutionEvent, AXPCommandExecutionStage, AXPCommandExtension, AXPExternalRuntimeBulkTransport, AXPExternalRuntimeBulkTransportOptions, AXPExternalRuntimeCommandTransport, AXPExternalRuntimeCommandTransportOptions, AXPExternalRuntimeQueryTransport, AXPExternalRuntimeQueryTransportOptions, AXPPolicy, AXPPolicyEngineMiddleware, AXPPolicyExtension, AXPQueryExecutionEvent, AXPQueryExecutionStage, AXPQueryExtension, AXPRuntimeCommandExecuteBulkHookPayload, AXPRuntimeCommandExecuteHookPayload, AXPRuntimeQueryExecuteHookPayload, AXPRuntimeTransportExecuteHookPayload, AXPViewExtension, AXPViewMiddleware };
+type AXPBulkProgressPollTransport = (executionId: string) => Promise<AXPBulkCommandProgress | null | undefined>;
+interface AXPBulkProgressPollTransportOptions {
+    /** Hook waterfall order (ascending). Default `-100` so this runs before connectivity. */
+    priority?: number;
+}
+/** Replace the default {@link AXPBulkProgressChannel} (e.g. SSE or a host-specific bus). */
+declare function provideBulkProgressChannel(factory: () => AXPBulkProgressChannel): Provider[];
+/**
+ * Registers a poll transport for hosts that have a progress HTTP API but no realtime.
+ * Same pattern as {@link provideExternalRuntimeBulkTransport}.
+ */
+declare function provideBulkProgressPollTransport(transport: AXPBulkProgressPollTransport, options?: AXPBulkProgressPollTransportOptions): Provider[];
+
+export { AXPBulkCommandService, AXPBulkProgressChannel, AXPCommandEventsService, AXPCommandExecutor, AXPCommandRegistry, AXPCommandService, AXPPolicyEngineContext, AXPPolicyEngineDirective, AXPPolicyEngineRegistry, AXPPolicyEngineService, AXPQueryEventsService, AXPQueryExecutor, AXPQueryRegistry, AXPQueryService, AXPRuntimeModule, AXPRuntimeRemoteHookKeys, AXPRuntimeTransportHookKeys, AXPRuntimeTransportService, 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, composePolicyEngineMiddlewares, composeViewMiddlewares, provideBulkProgressChannel, provideBulkProgressPollTransport, provideCommand, provideCommandMiddleware, provideCommandSetups, provideExternalRuntimeBulkTransport, provideExternalRuntimeCommandTransport, provideExternalRuntimeQueryTransport, providePolicySetups, provideQueryMiddleware, provideQuerySetups, provideViewSetup, provideViewSetups };
+export type { AXPBulkProgressPollTransport, AXPBulkProgressPollTransportOptions, AXPBulkProgressWatchOptions, AXPCommandExecutionEvent, AXPCommandExecutionStage, AXPCommandExtension, AXPExternalRuntimeBulkTransport, AXPExternalRuntimeBulkTransportOptions, AXPExternalRuntimeCommandTransport, AXPExternalRuntimeCommandTransportOptions, AXPExternalRuntimeQueryTransport, AXPExternalRuntimeQueryTransportOptions, AXPPolicy, AXPPolicyEngineMiddleware, AXPPolicyExtension, AXPQueryExecutionEvent, AXPQueryExecutionStage, AXPQueryExtension, AXPRuntimeCommandBulkProgressHookPayload, AXPRuntimeCommandExecuteBulkHookPayload, AXPRuntimeCommandExecuteHookPayload, AXPRuntimeQueryExecuteHookPayload, AXPRuntimeTransportExecuteHookPayload, AXPViewExtension, AXPViewMiddleware };

package/types/acorex-platform-framework-client-themes-default.d.ts

@@ -1,3 +1,5 @@
+import * as _acorex_platform_framework_shared_entity from '@acorex-platform/framework-shared/entity';
+import { AXPEntityMasterListDisplayMode } from '@acorex-platform/framework-shared/entity';
 import * as _ngrx_signals from '@ngrx/signals';
 import * as _angular_core from '@angular/core';
 import { AfterViewInit, OnDestroy, Signal } from '@angular/core';
@@ -6,13 +8,14 @@ import { AXPMenuVerticalMode } from '@acorex-platform/framework-client/themes/sh
 import { AXValueChangedEvent } from '@acorex/cdk/common';
 import { AXActionSheetService } from '@acorex/components/action-sheet';
 import { AXDataTableComponent, AXRowCommandItem, AXDataTableRowDbClick, AXRowCommandItemClickEvent, AXDataTableRowCssClassResolver, AXDataTableCellCssClassResolver, onColumnSizeChangedEvent, AXColumnsOrderChangedEvent } from '@acorex/components/data-table';
+import { AXPopoverComponent } from '@acorex/components/popover';
 import { AXUnsubscriber } from '@acorex/core/utils';
 import { AXPDeviceService } from '@acorex-platform/framework-client/core';
-import { AXPEntityCommandTriggerViewModel, AXPEntityDetailListViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewSortPropViewModel } from '@acorex-platform/framework-client/layout/entity';
+import { AXPEntityCommandTriggerViewModel, AXPEntityDetailListViewModel, AXPEntityCardListHost, AXPEntityCardSecondaryActionItem, AXPEntityMasterListViewModel, AXPEntityMasterListViewSortPropViewModel } from '@acorex-platform/framework-client/layout/entity';
 import { AXPBreadcrumbItem, AXPActionMenuItem, AXPExecuteCommand } from '@acorex-platform/framework-shared/core';
 import { AXPlatform } from '@acorex/core/platform';
 import { AXPPageLayoutBaseComponent } from '@acorex-platform/framework-client/layout/views';
-import { AXDataPagerChangedEvent, AXDataPagerMode } from '@acorex/components/data-pager';
+import { AXDataPagerChangedEvent } from '@acorex/components/data-pager';
 import * as _acorex_platform_framework_client_common from '@acorex-platform/framework-client/common';
 import { AXPTabNavigationService, AXPTabPreviewService, AXPTabDescriptor, AXPTabTitleParts, AXPMenuItem, AXPSettingsService, AXPMenuVisibilityService } from '@acorex-platform/framework-client/common';
 import { AXContextMenuItemsClickEvent } from '@acorex/components/menu';
@@ -43,6 +46,9 @@ declare class AXPEntityDetailListViewComponent {
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         menuOrientation: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
+        menuAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
+        headerAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
+        mainFooterFullWidth: _angular_core.Signal<boolean>;
         isPrinting: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
         isLightMode: _angular_core.Signal<boolean>;
@@ -54,6 +60,12 @@ declare class AXPEntityDetailListViewComponent {
         isMenuHorizontal: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
+        menuDarkEnabled: _angular_core.Signal<boolean>;
+        menuBrandEnabled: _angular_core.Signal<boolean>;
+        effectiveMainFooterFullWidth: _angular_core.Signal<boolean>;
+        headerBrandEnabled: _angular_core.Signal<boolean>;
+        headerButtonColor: _angular_core.Signal<"default" | "primary">;
+        headerButtonLook: _angular_core.Signal<"default" | "blank">;
         changeThemeMode: (theme: _acorex_platform_framework_client_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
         closeSideMenu: () => void;
@@ -83,6 +95,9 @@ declare class AXPEntityDetailListViewComponent {
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
+        menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
+        headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;
+        mainFooterFullWidth: boolean;
         isPrinting: boolean;
     }>;
     protected deviceService: AXPDeviceService;
@@ -91,6 +106,13 @@ declare class AXPEntityDetailListViewComponent {
     vm: AXPEntityDetailListViewModel;
     protected focusedRow: any;
     grid: AXDataTableComponent;
+    protected listDisplayModePopover: _angular_core.Signal<AXPopoverComponent | undefined>;
+    protected showListDisplayModeControl: _angular_core.Signal<boolean>;
+    protected listDisplayMode: _angular_core.Signal<_acorex_platform_framework_shared_entity.AXPEntityMasterListLayoutType>;
+    protected hasTableListDisplayOption: _angular_core.Signal<boolean>;
+    protected hasCardListDisplayOption: _angular_core.Signal<boolean>;
+    protected hasRowListDisplayOption: _angular_core.Signal<boolean>;
+    protected listDisplayModeButtonIcon: _angular_core.Signal<"fa-light fa-table" | "fa-light fa-grip-lines" | "fa-light fa-grid-2">;
     constructor(actionSheetService: AXActionSheetService, unsubscriber: AXUnsubscriber);
     private readonly destroyed;
     handleChangeSearchValue(e: AXValueChangedEvent): void;
@@ -103,6 +125,7 @@ declare class AXPEntityDetailListViewComponent {
     protected getDropdownRowItems: (rowData: unknown) => Promise<AXRowCommandItem[]>;
     protected handleSelectedRowsChange(rows: unknown[]): Promise<void>;
     protected handleRowCommandClick(e: AXRowCommandItemClickEvent): Promise<void>;
+    protected setListDisplayMode(mode: AXPEntityMasterListDisplayMode): void;
     private refreshToolbarActions;
     protected destroy(): void;
     ngOnDestroy(): void;
@@ -111,48 +134,68 @@ declare class AXPEntityDetailListViewComponent {
 }
 
 declare class AXPEntityMasterListCardListComponent {
-    protected readonly deviceService: AXPDeviceService;
-    vm: _angular_core.InputSignal<AXPEntityMasterListViewModel>;
-    pageChanged: _angular_core.OutputEmitterRef<AXDataPagerChangedEvent>;
-    protected pagerDisplayMode: _angular_core.Signal<AXDataPagerMode>;
+    vm: _angular_core.InputSignal<AXPEntityCardListHost>;
     protected items: _angular_core.WritableSignal<Record<string, unknown>[]>;
     protected loading: _angular_core.WritableSignal<boolean>;
-    protected highlightedRowId: _angular_core.WritableSignal<string | number | null>;
+    protected loadingMore: _angular_core.WritableSignal<boolean>;
+    protected hasMore: _angular_core.WritableSignal<boolean>;
     protected totalCount: _angular_core.WritableSignal<number>;
-    protected pageIndex: _angular_core.WritableSignal<number>;
+    protected highlightedRowId: _angular_core.WritableSignal<string | number | null>;
     protected pageSize: _angular_core.WritableSignal<number>;
     protected showSelection: _angular_core.Signal<boolean>;
     protected rowKey: _angular_core.Signal<string>;
+    protected isRowLayout: _angular_core.Signal<boolean>;
+    protected canLoadMore: _angular_core.Signal<boolean>;
+    protected loadedCount: _angular_core.Signal<number>;
+    protected showListStatus: _angular_core.Signal<boolean>;
     protected skeletonCount: _angular_core.Signal<number>;
+    protected readonly loadMoreSkeletonPlaceholders: number[];
+    protected showSkeletonAvatar: _angular_core.Signal<boolean>;
     protected skeletonFieldCount: _angular_core.Signal<number>;
     protected skeletonBadgeCount: _angular_core.Signal<number>;
     protected skeletonShowFooter: _angular_core.Signal<boolean>;
     protected skeletonPlaceholders: _angular_core.Signal<number[]>;
+    protected loadSecondaryActions: (row: Record<string, unknown>) => Promise<AXPEntityCardSecondaryActionItem[]>;
+    /** True while load-more is fetching the next chunk; ignore replace-on-changed. */
+    private appending;
+    private readonly cardGrid;
+    private readonly expandedRowIds;
+    private readonly columnCount;
     constructor();
-    reload(resetPagination?: boolean): Promise<void>;
+    reload(_resetPagination?: boolean): Promise<void>;
     /** Marks a card with the same post-create highlight used by the data table. */
     highlightCardById(rowId: string | number): void;
     clearCardHighlight(): void;
     protected isRowHighlighted(row: Record<string, unknown>): boolean;
-    /** Syncs visible items from the shared data source without triggering a load. */
+    /** Replaces the accumulated list with the current data-source page (no fetch). */
     syncFromDataSource(): void;
     /** Lightweight snapshot for entity list layout diagnostics. */
     getTraceSnapshot(): {
         itemCount: number;
         loading: boolean;
+        loadingMore: boolean;
+        hasMore: boolean;
         pageIndex: number;
         pageSize: number;
     };
+    protected isCardExpanded(row: Record<string, unknown>): boolean;
+    protected onCardExtraExpanded(index: number, expanded: boolean): void;
+    private rowId;
+    private visualRowIndexes;
+    private cardHosts;
+    private realignExpandedRows;
     protected trackRow(index: number, row: Record<string, unknown> | undefined): string | number;
     protected isRowSelected(row: Record<string, unknown>): boolean;
     protected onRowSelectionChange(row: Record<string, unknown>, selected: boolean): void;
     protected onCommandClick(name: string, row: Record<string, unknown>): Promise<void>;
-    protected onPageChanged(event: AXDataPagerChangedEvent): void;
-    private syncItemsFromDataSource;
-    private syncPagingFromDataSource;
+    protected onInfiniteScrollReached(): void;
+    private loadMore;
+    private loadPage;
+    private applyPageFromDataSource;
+    private resolvePageSize;
     private waitForDataSourceLoad;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityMasterListCardListComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityMasterListCardListComponent, "axp-entity-master-list-card-list", never, { "vm": { "alias": "vm"; "required": true; "isSignal": true; }; }, { "pageChanged": "pageChanged"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityMasterListCardListComponent, "axp-entity-master-list-card-list", never, { "vm": { "alias": "vm"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class AXPEntityMasterListDataTableComponent {
@@ -203,6 +246,9 @@ declare class AXPEntityMasterListViewComponent extends AXPPageLayoutBaseComponen
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         menuOrientation: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
+        menuAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
+        headerAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
+        mainFooterFullWidth: _angular_core.Signal<boolean>;
         isPrinting: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
         isLightMode: _angular_core.Signal<boolean>;
@@ -214,6 +260,12 @@ declare class AXPEntityMasterListViewComponent extends AXPPageLayoutBaseComponen
         isMenuHorizontal: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
+        menuDarkEnabled: _angular_core.Signal<boolean>;
+        menuBrandEnabled: _angular_core.Signal<boolean>;
+        effectiveMainFooterFullWidth: _angular_core.Signal<boolean>;
+        headerBrandEnabled: _angular_core.Signal<boolean>;
+        headerButtonColor: _angular_core.Signal<"default" | "primary">;
+        headerButtonLook: _angular_core.Signal<"default" | "blank">;
         changeThemeMode: (theme: _acorex_platform_framework_client_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
         closeSideMenu: () => void;
@@ -243,6 +295,9 @@ declare class AXPEntityMasterListViewComponent extends AXPPageLayoutBaseComponen
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
+        menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
+        headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;
+        mainFooterFullWidth: boolean;
         isPrinting: boolean;
     }>;
     protected searchBarShown: _angular_core.WritableSignal<boolean>;
@@ -338,6 +393,9 @@ declare class AXPRootLayoutHeaderComponent {
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         menuOrientation: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
+        menuAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
+        headerAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
+        mainFooterFullWidth: _angular_core.Signal<boolean>;
         isPrinting: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
         isLightMode: _angular_core.Signal<boolean>;
@@ -349,6 +407,12 @@ declare class AXPRootLayoutHeaderComponent {
         isMenuHorizontal: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
+        menuDarkEnabled: _angular_core.Signal<boolean>;
+        menuBrandEnabled: _angular_core.Signal<boolean>;
+        effectiveMainFooterFullWidth: _angular_core.Signal<boolean>;
+        headerBrandEnabled: _angular_core.Signal<boolean>;
+        headerButtonColor: _angular_core.Signal<"default" | "primary">;
+        headerButtonLook: _angular_core.Signal<"default" | "blank">;
         changeThemeMode: (theme: _acorex_platform_framework_client_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
         closeSideMenu: () => void;
@@ -378,9 +442,15 @@ declare class AXPRootLayoutHeaderComponent {
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
+        menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
+        headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;
+        mainFooterFullWidth: boolean;
         isPrinting: boolean;
     }>;
     protected readonly tabNavigation: AXPTabNavigationService;
+    protected readonly hostClass: _angular_core.Signal<"w-full flex min-w-0 items-center gap-2 h-14 px-2 shrink-0 border-b border-default bg-lightest dark:darker-surface axp-header-simple" | "w-full flex min-w-0 items-center gap-2 h-14 px-2 shrink-0 border-b border-default primary-surface ax-light axp-header-brand">;
+    protected readonly headerButtonColor: _angular_core.Signal<"primary" | "default">;
+    protected readonly headerButtonLook: _angular_core.Signal<"default" | "blank">;
     constructor();
     protected toggleSideMenu(): void;
     protected handleLogoClick(): void;
@@ -397,6 +467,7 @@ declare class AXPRouteTabBarComponent implements AfterViewInit, OnDestroy {
     #private;
     protected readonly tabNavigation: AXPTabNavigationService;
     protected readonly tabPreviewService: AXPTabPreviewService;
+    private readonly themeStore;
     private readonly translateService;
     private readonly host;
     private readonly tabStrip;
@@ -407,6 +478,7 @@ declare class AXPRouteTabBarComponent implements AfterViewInit, OnDestroy {
     private readonly stripWidthPx;
     protected readonly isTabDragging: _angular_core.WritableSignal<boolean>;
     protected readonly inHeader: _angular_core.WritableSignal<boolean>;
+    protected readonly simpleHeaderTabs: _angular_core.Signal<boolean>;
     protected readonly tabTitleTooltipOpenAfterMs = 500;
     private stripResizeObserver?;
     protected readonly layout: _angular_core.Signal<AXPRouteTabBarLayout>;
@@ -490,6 +562,9 @@ declare class AXPRootLayoutMenuComponent {
         sideMenuCompactWidth: Signal<number>;
         menuVerticalMode: Signal<AXPMenuVerticalMode>;
         menuOrientation: Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
+        menuAppearance: Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
+        headerAppearance: Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
+        mainFooterFullWidth: Signal<boolean>;
         isPrinting: Signal<boolean>;
         isDarkMode: Signal<boolean>;
         isLightMode: Signal<boolean>;
@@ -501,6 +576,12 @@ declare class AXPRootLayoutMenuComponent {
         isMenuHorizontal: Signal<boolean>;
         effectiveMenuVerticalMode: Signal<AXPMenuVerticalMode>;
         sideMenuDrawerWidth: Signal<number>;
+        menuDarkEnabled: Signal<boolean>;
+        menuBrandEnabled: Signal<boolean>;
+        effectiveMainFooterFullWidth: Signal<boolean>;
+        headerBrandEnabled: Signal<boolean>;
+        headerButtonColor: Signal<"default" | "primary">;
+        headerButtonLook: Signal<"default" | "blank">;
         changeThemeMode: (theme: _acorex_platform_framework_client_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
         closeSideMenu: () => void;
@@ -530,6 +611,9 @@ declare class AXPRootLayoutMenuComponent {
         sideMenuCompactWidth: number;
         menuVerticalMode: AXPMenuVerticalMode;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
+        menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
+        headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;
+        mainFooterFullWidth: boolean;
         isPrinting: boolean;
     }>;
     private readonly sessionService;
@@ -622,6 +706,9 @@ declare class AXPRootHorizontalLayoutComponent {
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         menuOrientation: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
+        menuAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
+        headerAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
+        mainFooterFullWidth: _angular_core.Signal<boolean>;
         isPrinting: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
         isLightMode: _angular_core.Signal<boolean>;
@@ -633,6 +720,12 @@ declare class AXPRootHorizontalLayoutComponent {
         isMenuHorizontal: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
+        menuDarkEnabled: _angular_core.Signal<boolean>;
+        menuBrandEnabled: _angular_core.Signal<boolean>;
+        effectiveMainFooterFullWidth: _angular_core.Signal<boolean>;
+        headerBrandEnabled: _angular_core.Signal<boolean>;
+        headerButtonColor: _angular_core.Signal<"default" | "primary">;
+        headerButtonLook: _angular_core.Signal<"default" | "blank">;
         changeThemeMode: (theme: _acorex_platform_framework_client_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
         closeSideMenu: () => void;
@@ -662,6 +755,9 @@ declare class AXPRootHorizontalLayoutComponent {
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
+        menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
+        headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;
+        mainFooterFullWidth: boolean;
         isPrinting: boolean;
     }>;
     protected handleCollapsedChange(value: boolean): void;
@@ -690,6 +786,9 @@ declare class AXPRootLayoutComponent {
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         menuOrientation: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
+        menuAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
+        headerAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
+        mainFooterFullWidth: _angular_core.Signal<boolean>;
         isPrinting: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
         isLightMode: _angular_core.Signal<boolean>;
@@ -701,6 +800,12 @@ declare class AXPRootLayoutComponent {
         isMenuHorizontal: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
+        menuDarkEnabled: _angular_core.Signal<boolean>;
+        menuBrandEnabled: _angular_core.Signal<boolean>;
+        effectiveMainFooterFullWidth: _angular_core.Signal<boolean>;
+        headerBrandEnabled: _angular_core.Signal<boolean>;
+        headerButtonColor: _angular_core.Signal<"default" | "primary">;
+        headerButtonLook: _angular_core.Signal<"default" | "blank">;
         changeThemeMode: (theme: _acorex_platform_framework_client_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
         closeSideMenu: () => void;
@@ -730,6 +835,9 @@ declare class AXPRootLayoutComponent {
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
+        menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
+        headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;
+        mainFooterFullWidth: boolean;
         isPrinting: boolean;
     }>;
     protected menuStore: {
@@ -791,6 +899,9 @@ declare class AXPRootVerticalLayoutComponent {
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         menuOrientation: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuOrientation>;
+        menuAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuAppearance>;
+        headerAppearance: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPHeaderAppearance>;
+        mainFooterFullWidth: _angular_core.Signal<boolean>;
         isPrinting: _angular_core.Signal<boolean>;
         isDarkMode: _angular_core.Signal<boolean>;
         isLightMode: _angular_core.Signal<boolean>;
@@ -802,6 +913,12 @@ declare class AXPRootVerticalLayoutComponent {
         isMenuHorizontal: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
+        menuDarkEnabled: _angular_core.Signal<boolean>;
+        menuBrandEnabled: _angular_core.Signal<boolean>;
+        effectiveMainFooterFullWidth: _angular_core.Signal<boolean>;
+        headerBrandEnabled: _angular_core.Signal<boolean>;
+        headerButtonColor: _angular_core.Signal<"default" | "primary">;
+        headerButtonLook: _angular_core.Signal<"default" | "blank">;
         changeThemeMode: (theme: _acorex_platform_framework_client_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
         closeSideMenu: () => void;
@@ -831,12 +948,25 @@ declare class AXPRootVerticalLayoutComponent {
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_framework_client_themes_shared.AXPMenuVerticalMode;
         menuOrientation: _acorex_platform_framework_client_themes_shared.AXPMenuOrientation;
+        menuAppearance: _acorex_platform_framework_client_themes_shared.AXPMenuAppearance;
+        headerAppearance: _acorex_platform_framework_client_themes_shared.AXPHeaderAppearance;
+        mainFooterFullWidth: boolean;
         isPrinting: boolean;
     }>;
     protected deviceService: AXPDeviceService;
     protected router: Router;
     /** Recreates the drawer when switching overlay ↔ push to reset internal layout sizing. */
     protected readonly sideMenuDrawerKey: _angular_core.Signal<"overlay" | "push">;
+    /** Logo / profile divider: white on dark menus, black on light menus. */
+    protected readonly sideMenuDividerBorderClass: _angular_core.Signal<"border-white/7" | "border-black/7">;
+    /** Brand-light menu surface: primary in light app mode, primary-darkest in dark app mode. */
+    protected readonly sideMenuBrandLightSurfaceClass: _angular_core.Signal<"primary-surface" | "ax-dark primary-darkest-surface">;
+    /** Header chrome for dark / light / brand-light / brand-dark menu appearances. */
+    protected readonly sideMenuHeaderClass: _angular_core.Signal<string>;
+    /** Body chrome for dark / light / brand-light / brand-dark menu appearances. */
+    protected readonly sideMenuSurfaceClass: _angular_core.Signal<string>;
+    /** White scrollbar thumb on dark menu surfaces. */
+    protected readonly sideMenuScrollUsesLightThumb: _angular_core.Signal<boolean>;
     constructor();
     protected handleResizingEnded(e: AXValueChangedEvent<number>): void;
     protected handleBackdropClick(): void;