@acorex-platform/module-report-management-client 0.0.18 → 0.0.24

package/types/acorex-platform-module-report-management-client.d.ts

@@ -1,15 +1,15 @@
 import * as _angular_core from '@angular/core';
-import { Injector } from '@angular/core';
 import * as i1 from '@acorex-platform/framework-client/domain';
 import * as i2 from '@acorex-platform/framework-client/runtime';
 import { AXPCommandService } from '@acorex-platform/framework-client/runtime';
 import * as _acorex_platform_framework_shared_core from '@acorex-platform/framework-shared/core';
-import { AXPExecuteCommandResult, AXPContextData, AXPFilterClause, AXPGridLayoutOptions, AXPBreadcrumbItem, AXPActionMenuItem, AXPBackButton, AXPExecuteCommand } from '@acorex-platform/framework-shared/core';
-import { AXPCommand } from '@acorex-platform/framework-shared/runtime';
+import { AXPMultiLanguageString, AXPContextData, AXPFilterClause, AXPRuntimeQueryResult, AXPGridLayoutOptions, AXPBreadcrumbItem, AXPActionMenuItem, AXPBackButton, AXPExecuteCommand } from '@acorex-platform/framework-shared/core';
+import { AXPCommand, AXPCommandExecuteResultPromise } from '@acorex-platform/framework-shared/runtime';
 import { AXPPermissionDefinitionProvider, AXPPermissionDefinitionProviderContext } from '@acorex-platform/framework-client/auth';
 import * as _acorex_cdk_common from '@acorex/cdk/common';
 import { AXDataSourceQuery, AXDataSource } from '@acorex/cdk/common';
-import * as node_modules__acorex_platform_framework_shared_entity_src_lib from 'node_modules/@acorex-platform/framework-shared/entity/src/lib';
+import * as _acorex_platform_framework_shared_entity from '@acorex-platform/framework-shared/entity';
+import { AXPQuerySort } from '@acorex-platform/framework-shared/entity';
 import * as _acorex_platform_framework_shared_widget_core from '@acorex-platform/framework-shared/widget-core';
 import { AXPWidgetColumnNode, AXPPageStatus } from '@acorex-platform/framework-shared/widget-core';
 import * as _acorex_platform_framework_client_layout_builder from '@acorex-platform/framework-client/layout/builder';
@@ -19,11 +19,9 @@ import * as _ngrx_signals from '@ngrx/signals';
 import * as _acorex_platform_framework_client_themes_shared from '@acorex-platform/framework-client/themes/shared';
 import { AXPDeviceService } from '@acorex-platform/framework-client/core';
 import { AXPPageLayoutBaseComponent } from '@acorex-platform/framework-client/layout/views';
-import { AXPQuerySort } from '@acorex-platform/framework-shared/entity';
-import { AXPReportCategory, AXPReportDefinition, AXPReportLayoutType, AXPReportLayoutAction, AXPReportLayoutDefinition, AXPLayoutExecutionContext, AXPExecutionReportCommandResult, AXPLayoutSwitcherOption, AXPReportTableLayout, AXPReportChartLayout, AXPReportPdfLayout, AXPReportTableSummaryResult, AXPReportTableLayoutRowAction } from '@acorex-platform/module-report-management-client/contracts';
+import { AXPReportDefinition, AXPReportEntityBinding, AXPReportLayoutType, AXPReportLayoutAction, AXPReportLayoutDefinition, AXPChartDataMapping, AXPLayoutSwitcherOption, AXPReportViewerFreeze, AXPReportTableLayout, AXPReportChartLayout, AXPReportPdfLayout, AXPReportTableSummaryResult, AXPReportTableLayoutRowAction } from '@acorex-platform/module-report-management-client/contracts';
 export * from '@acorex-platform/module-report-management-client/contracts';
 import * as dist_libs_framework_client_types_acorex_platform_framework_client_layout_builder from 'dist/libs/framework/client/types/acorex-platform-framework-client-layout-builder';
-import * as node_modules__acorex_platform_framework_shared_core_src_lib from 'node_modules/@acorex-platform/framework-shared/core/src/lib';
 import { AXBarChartValue, AXBarChartOption } from '@acorex/charts/bar-chart';
 import { AXChartLegendOptions } from '@acorex/charts/chart-legend';
 import { AXRowCommandItemClickEvent, AXDataTableRowDbClick, onColumnSizeChangedEvent, AXColumnsOrderChangedEvent, AXRowCommandItem } from '@acorex/components/data-table';
@@ -37,34 +35,54 @@ declare class AXMReportManagementModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXMReportManagementModule>;
 }
 
-interface AXPDrillToReportCommandInput {
+interface AXPOpenReportInPopupCommandInput {
     reportId?: string;
     layoutId?: string;
-    title?: string;
+    runId?: string;
+    title?: AXPMultiLanguageString;
     parameters?: Record<string, unknown>;
     hideColumnFields?: string[];
-    __context__?: {
-        options?: Partial<AXPDrillToReportCommandInput>;
-        data?: Record<string, unknown>;
-    };
-    options?: Partial<AXPDrillToReportCommandInput>;
+    data?: Record<string, unknown>;
+    options?: Partial<AXPOpenReportInPopupCommandInput>;
 }
-declare class AXPDrillToReportCommand implements AXPCommand<AXPDrillToReportCommandInput | Record<string, unknown>, void> {
+/** Opens a report in a results-only popup. Pass `runId` to show a frozen generation run. */
+declare class AXPOpenReportInPopupCommand implements AXPCommand<AXPOpenReportInPopupCommandInput | Record<string, unknown>, void> {
     private readonly popupService;
     private readonly expressionEvaluator;
     private readonly translate;
-    execute(input: AXPDrillToReportCommandInput | Record<string, unknown>): Promise<AXPExecuteCommandResult<void>>;
+    private readonly reportViewerService;
+    execute(input: AXPOpenReportInPopupCommandInput | Record<string, unknown>): AXPCommandExecuteResultPromise<void>;
     private resolveRowData;
     private resolveOptions;
     private resolvePopupTitle;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDrillToReportCommand, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPDrillToReportCommand>;
+    private resolveExplicitPopupTitle;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPOpenReportInPopupCommand, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPOpenReportInPopupCommand>;
+}
+
+interface AXPOpenReportViewerCommandInput {
+    reportId?: string;
+    runId?: string;
+    data?: Record<string, unknown>;
+    options?: Partial<AXPOpenReportViewerCommandInput>;
+}
+/** Opens a report in the full-page report viewer. */
+declare class AXPOpenReportViewerCommand implements AXPCommand<AXPOpenReportViewerCommandInput | Record<string, unknown>, void> {
+    private readonly sessionService;
+    private readonly tabNavigation;
+    private readonly expressionEvaluator;
+    private readonly translate;
+    execute(input: AXPOpenReportViewerCommandInput | Record<string, unknown>): AXPCommandExecuteResultPromise<void>;
+    private resolveRowData;
+    private resolveOptions;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPOpenReportViewerCommand, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPOpenReportViewerCommand>;
 }
 
+/**
+ * Registers report capabilities into the shared Insights & Reporting group.
+ */
 declare class AXMPermissionDefinitionProvider implements AXPPermissionDefinitionProvider {
-    private injector;
-    private readonly translateService;
-    constructor(injector: Injector);
     define(context: AXPPermissionDefinitionProviderContext): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMPermissionDefinitionProvider, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMPermissionDefinitionProvider>;
@@ -86,185 +104,53 @@ interface AXPReportViewerUserSettings {
     }>;
 }
 
+interface AXPEntityBoundReport {
+    report: AXPReportDefinition;
+    binding: AXPReportEntityBinding;
+}
+
 /**
  * Report Viewer Service
  *
  * Handles report definition retrieval, caching, and layout actions.
- *
- * Performance optimizations:
- * 1. Uses childrenCount to determine if category has children (no query needed)
- * 2. Uses itemsCount to determine if category has reports (no query needed)
- * 3. Aggressive caching prevents duplicate API calls
- * 4. Single pending request per resource prevents race conditions
- * 5. Lazy loading - only loads data when needed
  */
 declare class AXPReportViewerService {
     private readonly entityService;
-    private readonly reportCategoryService;
     private readonly reportDefinitionService;
-    /** Cache for categories by id - O(1) lookup */
-    private categoriesById;
-    /** Cache for categories by parentId - O(1) lookup */
-    private categoriesByParentId;
-    /** Cache for report definitions by categoryId - O(1) lookup */
-    private definitionsByCategory;
-    /** Cache for individual report definitions by id - O(1) lookup */
+    /** Cache for individual report definitions by id */
     private definitionsById;
     /** Pending API requests to prevent duplicate calls */
-    private pendingCategoriesRequests;
-    private pendingDefinitionsRequests;
     private pendingReportRequests;
     /**
-     * Get categories by parentId with aggressive caching
-     *
-     * Optimization: Returns cached result immediately if available,
-     * preventing unnecessary API calls during navigation
-     *
-     * @param parentId - Parent category ID (undefined = root categories)
-     * @returns Array of categories with count metadata (childrenCount, itemsCount)
+     * Reports bound to a host entity type via `entities[].entity`.
+     * Falls back to an in-memory filter when the nested-array query returns nothing
+     * (or is unsupported by the current query backend).
      */
-    getCategories(parentId?: string): Promise<AXPReportCategory[]>;
-    /**
-     * Get single category by ID with O(1) lookup
-     *
-     * Optimization: Uses Map for instant retrieval, falls back to
-     * searching cache, then providers if not found
-     */
-    getCategoryById(categoryId: string): Promise<AXPReportCategory | undefined>;
-    /**
-     * Get category path from root to specified category
-     *
-     * Optimization: Builds path using cached categories only
-     */
-    getCategoriesPathById(categoryId: string): Promise<AXPReportCategory[]>;
-    /**
-     * Get report definitions for a category with smart caching
-     *
-     * Optimization: Checks itemsCount before querying
-     * - If itemsCount = 0, returns empty array (no API call)
-     * - If itemsCount > 0, loads and caches reports
-     * - Returns cached result on subsequent calls
-     *
-     * @param categoryId - Category ID to get reports from
-     * @returns Array of report definitions
-     */
-    getReportsByCategoryId(categoryId: string): Promise<AXPReportDefinition[]>;
+    getReportsByEntityType(entityType: string): Promise<AXPEntityBoundReport[]>;
     /**
      * Get single report definition by ID with O(1) lookup
-     *
-     * Optimization: Uses Map for instant retrieval
      */
     getReportById(id: string): Promise<AXPReportDefinition | undefined>;
     /**
-     * Get category ID containing a specific report
-     *
-     * Optimization: Searches cache first, loads on-demand if needed
-     */
-    getCategoryIdByReportId(reportId: string): Promise<string | undefined>;
-    /**
-     * Get category path for a report
-     */
-    getCategoriesPathByReportId(reportId: string): Promise<AXPReportCategory[]>;
-    /**
-     * Get general actions list for a layout type
-     * Override in connectivity layer (mock/API) to provide general actions
-     * Base implementation returns empty array
-     *
-     * @param layoutType - The layout type
-     * @returns Array of general actions for the layout type
+     * Get general actions list for a layout type.
+     * Override in connectivity layer (mock/API) to provide general actions.
      */
     getGeneralActionsList(layoutType: AXPReportLayoutType): AXPReportLayoutAction[];
     /**
-     * Get merged actions for a layout definition
-     * Combines general actions (from getGeneralActionsList) with layout-specific actions
-     * Layout-specific actions take precedence (by name) over general actions
-     *
-     * @param layoutDefinition - The layout definition
-     * @returns Merged array of actions (general + custom)
+     * Get merged actions for a layout definition.
+     * Combines general actions with layout-specific actions.
      */
     getMergedActions(layoutDefinition: AXPReportLayoutDefinition): AXPReportLayoutAction[];
-    /**
-     * Get primary actions for a layout definition
-     */
     getPrimaryActions(layoutDefinition: AXPReportLayoutDefinition): AXPReportLayoutAction[];
-    /**
-     * Get secondary actions for a layout definition
-     */
     getSecondaryActions(layoutDefinition: AXPReportLayoutDefinition): AXPReportLayoutAction[];
     /**
-     * Load categories from entity service and cache results
-     * Can be overridden in extended services (e.g., API layer)
-     */
-    protected loadCategories(parentId?: string): Promise<AXPReportCategory[]>;
-    /**
-     * Load report definitions from entity service and cache results
-     * Can be overridden in extended services (e.g., API layer)
-     */
-    protected loadReports(categoryId: string): Promise<AXPReportDefinition[]>;
-    /**
-     * Load single report from entity service and cache result
-     * Can be overridden in extended services (e.g., API layer)
+     * Load single report from entity service and cache result.
+     * Can be overridden in extended services (e.g., API layer).
      */
     protected loadReport(id: string): Promise<AXPReportDefinition | undefined>;
-    /**
-     * Breadth-first search through category hierarchy
-     */
-    private searchCategoryInHierarchy;
-    /**
-     * Check if category has children (uses cached count)
-     */
-    categoryHasChildren(categoryId: string): boolean;
-    /**
-     * Check if category has reports (uses cached count)
-     */
-    categoryHasReports(categoryId: string): boolean;
-    /**
-     * Protected: Check if categories are cached for a parentId
-     * Used by extended services (e.g., mock) to determine if logging is needed
-     */
-    protected isCategoriesCached(parentId?: string): boolean;
-    /**
-     * Protected: Check if a category is cached by ID
-     * Used by extended services (e.g., mock) to determine if logging is needed
-     */
-    protected isCategoryCached(categoryId: string): boolean;
-    /**
-     * Protected: Check if reports are cached for a categoryId
-     * Used by extended services (e.g., mock) to determine if logging is needed
-     */
-    protected isReportsCached(categoryId: string): boolean;
-    /**
-     * Protected: Check if a report is cached by ID
-     * Used by extended services (e.g., mock) to determine if logging is needed
-     */
     protected isReportCached(reportId: string): boolean;
-    /**
-     * Clear all caches
-     */
     clearAllCache(): void;
-    /**
-     * Clear categories cache only
-     */
-    clearCategoriesCache(): void;
-    /**
-     * Clear reports cache only
-     */
     clearReportsCache(): void;
-    /**
-     * Execute report with given context
-     * Override in connectivity layer (mock/API) to implement report execution
-     *
-     * @param context - Layout execution context with reportId, layoutId, dataSource, and filters
-     * @returns Report execution result with layout and data
-     */
-    executeReport(context: AXPLayoutExecutionContext): Promise<AXPExecutionReportCommandResult>;
-    /**
-     * Execute action by command name
-     * Override in connectivity layer (mock/API) to implement action execution
-     *
-     * @param commandName - Command name (e.g., 'download-report', 'print-report', 'export-report')
-     * @param options - Command options (e.g., { format: 'excel', pdfData: {...}, reportData: {...} })
-     */
     executeAction(commandName: string, options?: Record<string, unknown>): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPReportViewerService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPReportViewerService>;
@@ -297,6 +183,76 @@ declare function AXLineChartReportMapper(data: Record<string, number>): AXLineCh
  * }
  */
 declare function convertContextDataToFilterClause(context: AXPContextData): AXPFilterClause;
+type AXPReportPdfSource = {
+    url?: string;
+    base64?: string;
+    blob?: Blob;
+    filename?: string;
+};
+declare function queryResultToPdfSource(queryResult: AXPRuntimeQueryResult<unknown> | null | undefined): AXPReportPdfSource | null;
+declare function queryResultToChartSeries(queryResult: AXPRuntimeQueryResult<unknown> | null | undefined, mapping?: AXPChartDataMapping | null): Record<string, number>;
+
+type AXPReportDateRangeValue = 'today' | {
+    from: string;
+    to: string;
+};
+type AXPReportParameterValue = string | number | boolean | AXPReportDateRangeValue | Record<string, unknown>;
+/** Local calendar date as `yyyy-MM-dd` (session "today" for report ranges). */
+declare function formatReportDateOnly(date?: Date): string;
+declare function resolveTodayDateRange(date?: Date): {
+    from: string;
+    to: string;
+};
+declare function isReportDateRangeObject(value: unknown): value is {
+    from?: unknown;
+    to?: unknown;
+    start?: unknown;
+    end?: unknown;
+};
+declare function toReportDateRangeFilterValue(range: {
+    from: string;
+    to: string;
+}): {
+    operation: {
+        type: 'between';
+    };
+    value: {
+        from: string;
+        to: string;
+    };
+};
+/**
+ * Converts report default / binding values into filter-form context shape.
+ * - `'today'` and `{ from, to }` → `{ operation: between, value }`
+ * - existing filter objects are left unchanged
+ */
+declare function resolveReportFilterDefaultValue(value: unknown, now?: Date): unknown;
+type ReportParameterDefaultSource = {
+    path: string;
+    widget?: {
+        defaultValue?: unknown;
+        options?: Record<string, unknown>;
+    };
+};
+type ReportParameterGroupDefaultSource = {
+    parameters?: ReportParameterDefaultSource[];
+};
+declare function collectReportParameterDefaults(parameterGroups: ReportParameterGroupDefaultSource[] | undefined, now?: Date): Record<string, unknown>;
+/**
+ * Resolves special parameter tokens after expression evaluation.
+ * - `dateRange: 'today'` → `{ from, to }` for the local calendar day
+ */
+declare function resolveReportParameterValues(parameters: Record<string, unknown> | undefined, now?: Date): Record<string, unknown>;
+/**
+ * Maps entity-binding parameter declarations into OpenInPopup command parameters.
+ * Field paths become `context.eval` expressions; `today` and `{from,to}` stay literal.
+ */
+declare function mapEntityBindingParameters(parameters: Record<string, AXPReportParameterValue> | undefined): Record<string, unknown> | undefined;
+/**
+ * Flattens popup/filter parameters into report-viewer URL query params
+ * (`field.operation.type` + `field.value` / nested `from`/`to`).
+ */
+declare function flattenReportParametersToQueryParams(parameters: Record<string, unknown>): Record<string, string>;
 
 interface AXPReportTableColumnViewModel {
     field: string;
@@ -311,6 +267,8 @@ interface AXPReportTableColumnViewModel {
     drillDisplayField?: string;
 }
 
+declare function reportLayoutPageIcon(icon: string | undefined, option: Pick<AXPLayoutSwitcherOption, 'type'>): string;
+
 declare class AXPReportViewerPageComponent extends AXPPageLayoutBaseComponent {
     protected layoutService: {
         currentMode: _angular_core.Signal<_acorex_platform_framework_client_themes_shared.AXPThemeMode>;
@@ -378,6 +336,7 @@ declare class AXPReportViewerPageComponent extends AXPPageLayoutBaseComponent {
     private readonly loadingDialog;
     private readonly destroyRef;
     private readonly reportViewerService;
+    private readonly entityService;
     reportId: _angular_core.InputSignal<string | undefined>;
     reportParameters: _angular_core.InputSignal<Record<string, any>>;
     private filtersForm;
@@ -385,7 +344,6 @@ declare class AXPReportViewerPageComponent extends AXPPageLayoutBaseComponent {
         reportDefinition: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportDefinition | null>;
         currentLayout: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportLayoutDefinition | null>;
         filterContext: _angular_core.Signal<AXPContextData>;
-        categoriesPath: _angular_core.Signal<any[]>;
         allowFetchData: _angular_core.Signal<boolean>;
         shouldExecuteReport: _angular_core.Signal<boolean>;
         executionRequestId: _angular_core.Signal<number>;
@@ -395,7 +353,13 @@ declare class AXPReportViewerPageComponent extends AXPPageLayoutBaseComponent {
         error: _angular_core.Signal<string | null>;
         showRowIndexColumn: _angular_core.Signal<boolean>;
         reportUserSettings: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportViewerUserSettings | null>;
-        availableLayouts: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPLayoutSwitcherOption[]>;
+        runId: _angular_core.Signal<string | null>;
+        frozen: _angular_core.Signal<boolean>;
+        freeze: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportViewerFreeze | null>;
+        backgroundQueued: _angular_core.Signal<boolean>;
+        parametersReadonly: _angular_core.Signal<boolean>;
+        selectedLayoutIds: _angular_core.Signal<string[]>;
+        availableLayouts: _angular_core.Signal<AXPLayoutSwitcherOption[]>;
         defaultLayout: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportLayoutDefinition | null>;
         activeLayoutId: _angular_core.Signal<string | null>;
         layoutType: _angular_core.Signal<"table" | "chart" | "pdf" | null>;
@@ -407,25 +371,36 @@ declare class AXPReportViewerPageComponent extends AXPPageLayoutBaseComponent {
         hasError: _angular_core.Signal<boolean>;
         canExecute: _angular_core.Signal<boolean>;
         hasMultipleLayouts: _angular_core.Signal<boolean>;
-        title: _angular_core.Signal<string>;
-        description: _angular_core.Signal<string | null>;
+        title: _angular_core.Signal<AXPMultiLanguageString>;
+        description: _angular_core.Signal<AXPMultiLanguageString | null>;
         formDefinition: _angular_core.Signal<_acorex_platform_framework_client_layout_builder.AXPDynamicFormDefinition>;
         isTableLayout: _angular_core.Signal<boolean>;
         isChartLayout: _angular_core.Signal<boolean>;
         isPdfLayout: _angular_core.Signal<boolean>;
         hasUnappliedFilters: _angular_core.Signal<boolean>;
-        canSwitchLayout: _angular_core.Signal<boolean>;
         canSelectRows: _angular_core.Signal<boolean | undefined>;
         tableLayoutUserSettings: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportTableLayoutUserState | null>;
         reportId: _angular_core.Signal<string | null>;
+        isFrozen: _angular_core.Signal<boolean>;
+        isBackgroundQueued: _angular_core.Signal<boolean>;
+        isBackgroundReportMode: _angular_core.Signal<boolean>;
+        hasSelectedBackgroundLayouts: _angular_core.Signal<boolean>;
+        areParametersReadonly: _angular_core.Signal<boolean>;
+        canSwitchLayout: _angular_core.Signal<boolean>;
+        generationMode: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportGenerationMode>;
         loadReport: (reportId: string) => Promise<void>;
         switchLayout: (layoutId: string) => void;
+        isBackgroundLayoutSelected: (layoutId: string) => boolean;
+        setBackgroundLayoutSelected: (layoutId: string, selected: boolean) => void;
         saveTableColumnOrder: (columns: AXPReportTableColumnViewModel[]) => Promise<void>;
         saveTableColumnWidth: (field: string, width: number, columns: AXPReportTableColumnViewModel[]) => Promise<void>;
-        saveTableSorts: (sorts: node_modules__acorex_platform_framework_shared_entity_src_lib.AXPQuerySort[]) => Promise<void>;
+        saveTableSorts: (sorts: _acorex_platform_framework_shared_entity.AXPQuerySort[]) => Promise<void>;
         saveTablePageSize: (pageSize: number) => Promise<void>;
         executeReport: () => Promise<void>;
-        fetchData: (query?: _acorex_cdk_common.AXDataSourceQuery) => Promise<_acorex_platform_module_report_management_client.AXPExecutionReportCommandResult | null>;
+        fetchData: (query?: _acorex_cdk_common.AXDataSourceQuery) => Promise<_acorex_platform_framework_shared_core.AXPRuntimeQueryResult<unknown> | null>;
+        generateInBackground: () => Promise<void>;
+        nudgeFetch: () => void;
+        loadFrozenRun: (runId: string) => Promise<void>;
         applyDrillView: (options: {
             hideColumnFields: string[];
         }) => void;
@@ -442,7 +417,6 @@ declare class AXPReportViewerPageComponent extends AXPPageLayoutBaseComponent {
         reportDefinition: _acorex_platform_module_report_management_client.AXPReportDefinition | null;
         currentLayout: _acorex_platform_module_report_management_client.AXPReportLayoutDefinition | null;
         filterContext: AXPContextData;
-        categoriesPath: any[];
         allowFetchData: boolean;
         shouldExecuteReport: boolean;
         executionRequestId: number;
@@ -452,14 +426,21 @@ declare class AXPReportViewerPageComponent extends AXPPageLayoutBaseComponent {
         error: string | null;
         showRowIndexColumn: boolean;
         reportUserSettings: _acorex_platform_module_report_management_client.AXPReportViewerUserSettings | null;
+        runId: string | null;
+        frozen: boolean;
+        freeze: _acorex_platform_module_report_management_client.AXPReportViewerFreeze | null;
+        backgroundQueued: boolean;
+        parametersReadonly: boolean;
+        selectedLayoutIds: string[];
     }>;
     private readonly watchNavigationLoading;
     private loadingDialogRef;
     private isDialogOpening;
+    private lastReportRouteKey;
     constructor();
     protected showFiltersPanel: () => boolean;
     protected showReportDisplay: () => boolean;
-    private baseRoutes;
+    private reportsListPath;
     protected defaultLayout: () => AXPGridLayoutOptions;
     protected compactLayout: () => AXPGridLayoutOptions;
     ngOnInit(): Promise<void>;
@@ -513,6 +494,8 @@ declare class AXPReportViewerPageComponent extends AXPPageLayoutBaseComponent {
     protected handleFiltersChange(event: AXPContextData): void;
     protected handleFiltersInitiated(event: AXPContextData): void;
     protected handleExecuteReport(): Promise<void>;
+    protected handleGenerateInBackground(): Promise<void>;
+    protected canGenerateInBackground(): boolean;
     protected handleRefresh(): void;
     protected handleClearFilters(): void;
     /**
@@ -531,11 +514,15 @@ declare class AXPReportViewerPageComponent extends AXPPageLayoutBaseComponent {
      * @param format - Export format (excel, csv, pdf, image)
      */
     protected handleExportReport(format?: string): Promise<void>;
+    protected readonly layoutPageIcon: typeof reportLayoutPageIcon;
+    protected getLayoutSelectionLabel(layout: AXPLayoutSwitcherOption): AXPMultiLanguageString;
+    protected handleBackgroundLayoutToggle(layoutId: string, selected: boolean): void;
     protected getPageBreadcrumbs(): Promise<AXPBreadcrumbItem[]>;
-    getPageTitle(): Promise<string>;
-    getPageDescription(): Promise<string | null>;
+    getPageTitle(): Promise<AXPMultiLanguageString>;
+    getPageDescription(): Promise<AXPMultiLanguageString | null>;
     protected getPageIcon(): string | null;
-    protected getTitleActions(): AXPActionMenuItem[] | Promise<AXPActionMenuItem[]>;
+    protected getTitleActions(): Promise<AXPActionMenuItem[]>;
+    private resolveLayoutSwitcherTitle;
     getBackButton(): Promise<AXPBackButton | null>;
     onBackButtonClick(): Promise<void>;
     getPrimaryMenuItems(): Promise<AXPActionMenuItem[]>;
@@ -549,7 +536,6 @@ declare const AXPReportViewerViewModel: _angular_core.Type<{
     reportDefinition: _angular_core.Signal<AXPReportDefinition | null>;
     currentLayout: _angular_core.Signal<AXPReportLayoutDefinition | null>;
     filterContext: _angular_core.Signal<AXPContextData>;
-    categoriesPath: _angular_core.Signal<any[]>;
     allowFetchData: _angular_core.Signal<boolean>;
     shouldExecuteReport: _angular_core.Signal<boolean>;
     executionRequestId: _angular_core.Signal<number>;
@@ -559,6 +545,12 @@ declare const AXPReportViewerViewModel: _angular_core.Type<{
     error: _angular_core.Signal<string | null>;
     showRowIndexColumn: _angular_core.Signal<boolean>;
     reportUserSettings: _angular_core.Signal<AXPReportViewerUserSettings | null>;
+    runId: _angular_core.Signal<string | null>;
+    frozen: _angular_core.Signal<boolean>;
+    freeze: _angular_core.Signal<AXPReportViewerFreeze | null>;
+    backgroundQueued: _angular_core.Signal<boolean>;
+    parametersReadonly: _angular_core.Signal<boolean>;
+    selectedLayoutIds: _angular_core.Signal<string[]>;
     availableLayouts: _angular_core.Signal<AXPLayoutSwitcherOption[]>;
     defaultLayout: _angular_core.Signal<AXPReportLayoutDefinition | null>;
     activeLayoutId: _angular_core.Signal<string | null>;
@@ -571,25 +563,36 @@ declare const AXPReportViewerViewModel: _angular_core.Type<{
     hasError: _angular_core.Signal<boolean>;
     canExecute: _angular_core.Signal<boolean>;
     hasMultipleLayouts: _angular_core.Signal<boolean>;
-    title: _angular_core.Signal<string>;
-    description: _angular_core.Signal<string | null>;
+    title: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPMultiLanguageString>;
+    description: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPMultiLanguageString | null>;
     formDefinition: _angular_core.Signal<AXPDynamicFormDefinition>;
     isTableLayout: _angular_core.Signal<boolean>;
     isChartLayout: _angular_core.Signal<boolean>;
     isPdfLayout: _angular_core.Signal<boolean>;
     hasUnappliedFilters: _angular_core.Signal<boolean>;
-    canSwitchLayout: _angular_core.Signal<boolean>;
     canSelectRows: _angular_core.Signal<boolean | undefined>;
     tableLayoutUserSettings: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportTableLayoutUserState | null>;
     reportId: _angular_core.Signal<string | null>;
+    isFrozen: _angular_core.Signal<boolean>;
+    isBackgroundQueued: _angular_core.Signal<boolean>;
+    isBackgroundReportMode: _angular_core.Signal<boolean>;
+    hasSelectedBackgroundLayouts: _angular_core.Signal<boolean>;
+    areParametersReadonly: _angular_core.Signal<boolean>;
+    canSwitchLayout: _angular_core.Signal<boolean>;
+    generationMode: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportGenerationMode>;
     loadReport: (reportId: string) => Promise<void>;
     switchLayout: (layoutId: string) => void;
+    isBackgroundLayoutSelected: (layoutId: string) => boolean;
+    setBackgroundLayoutSelected: (layoutId: string, selected: boolean) => void;
     saveTableColumnOrder: (columns: AXPReportTableColumnViewModel[]) => Promise<void>;
     saveTableColumnWidth: (field: string, width: number, columns: AXPReportTableColumnViewModel[]) => Promise<void>;
     saveTableSorts: (sorts: AXPQuerySort[]) => Promise<void>;
     saveTablePageSize: (pageSize: number) => Promise<void>;
     executeReport: () => Promise<void>;
-    fetchData: (query?: AXDataSourceQuery) => Promise<AXPExecutionReportCommandResult | null>;
+    fetchData: (query?: AXDataSourceQuery) => Promise<AXPRuntimeQueryResult<unknown> | null>;
+    generateInBackground: () => Promise<void>;
+    nudgeFetch: () => void;
+    loadFrozenRun: (runId: string) => Promise<void>;
     applyDrillView: (options: {
         hideColumnFields: string[];
     }) => void;
@@ -606,7 +609,6 @@ declare const AXPReportViewerViewModel: _angular_core.Type<{
     reportDefinition: AXPReportDefinition | null;
     currentLayout: AXPReportLayoutDefinition | null;
     filterContext: AXPContextData;
-    categoriesPath: any[];
     allowFetchData: boolean;
     shouldExecuteReport: boolean;
     executionRequestId: number;
@@ -616,6 +618,12 @@ declare const AXPReportViewerViewModel: _angular_core.Type<{
     error: string | null;
     showRowIndexColumn: boolean;
     reportUserSettings: AXPReportViewerUserSettings | null;
+    runId: string | null;
+    frozen: boolean;
+    freeze: AXPReportViewerFreeze | null;
+    backgroundQueued: boolean;
+    parametersReadonly: boolean;
+    selectedLayoutIds: string[];
 }>>;
 
 declare class AXPReportBarChartViewComponent {
@@ -623,17 +631,22 @@ declare class AXPReportBarChartViewComponent {
     protected readonly vm: {
         reportDefinition: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportDefinition | null>;
         currentLayout: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportLayoutDefinition | null>;
-        filterContext: _angular_core.Signal<node_modules__acorex_platform_framework_shared_core_src_lib.AXPContextData>;
-        categoriesPath: _angular_core.Signal<any[]>;
+        filterContext: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPContextData>;
         allowFetchData: _angular_core.Signal<boolean>;
         shouldExecuteReport: _angular_core.Signal<boolean>;
         executionRequestId: _angular_core.Signal<number>;
-        lastAppliedFilterContext: _angular_core.Signal<node_modules__acorex_platform_framework_shared_core_src_lib.AXPContextData | null>;
+        lastAppliedFilterContext: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPContextData | null>;
         hasBeenExecuted: _angular_core.Signal<boolean>;
         status: _angular_core.Signal<AXPPageStatus>;
         error: _angular_core.Signal<string | null>;
         showRowIndexColumn: _angular_core.Signal<boolean>;
         reportUserSettings: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportViewerUserSettings | null>;
+        runId: _angular_core.Signal<string | null>;
+        frozen: _angular_core.Signal<boolean>;
+        freeze: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportViewerFreeze | null>;
+        backgroundQueued: _angular_core.Signal<boolean>;
+        parametersReadonly: _angular_core.Signal<boolean>;
+        selectedLayoutIds: _angular_core.Signal<string[]>;
         availableLayouts: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPLayoutSwitcherOption[]>;
         defaultLayout: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportLayoutDefinition | null>;
         activeLayoutId: _angular_core.Signal<string | null>;
@@ -646,25 +659,36 @@ declare class AXPReportBarChartViewComponent {
         hasError: _angular_core.Signal<boolean>;
         canExecute: _angular_core.Signal<boolean>;
         hasMultipleLayouts: _angular_core.Signal<boolean>;
-        title: _angular_core.Signal<string>;
-        description: _angular_core.Signal<string | null>;
+        title: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPMultiLanguageString>;
+        description: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPMultiLanguageString | null>;
         formDefinition: _angular_core.Signal<dist_libs_framework_client_types_acorex_platform_framework_client_layout_builder.AXPDynamicFormDefinition>;
         isTableLayout: _angular_core.Signal<boolean>;
         isChartLayout: _angular_core.Signal<boolean>;
         isPdfLayout: _angular_core.Signal<boolean>;
         hasUnappliedFilters: _angular_core.Signal<boolean>;
-        canSwitchLayout: _angular_core.Signal<boolean>;
         canSelectRows: _angular_core.Signal<boolean | undefined>;
         tableLayoutUserSettings: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportTableLayoutUserState | null>;
         reportId: _angular_core.Signal<string | null>;
+        isFrozen: _angular_core.Signal<boolean>;
+        isBackgroundQueued: _angular_core.Signal<boolean>;
+        isBackgroundReportMode: _angular_core.Signal<boolean>;
+        hasSelectedBackgroundLayouts: _angular_core.Signal<boolean>;
+        areParametersReadonly: _angular_core.Signal<boolean>;
+        canSwitchLayout: _angular_core.Signal<boolean>;
+        generationMode: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportGenerationMode>;
         loadReport: (reportId: string) => Promise<void>;
         switchLayout: (layoutId: string) => void;
+        isBackgroundLayoutSelected: (layoutId: string) => boolean;
+        setBackgroundLayoutSelected: (layoutId: string, selected: boolean) => void;
         saveTableColumnOrder: (columns: AXPReportTableColumnViewModel[]) => Promise<void>;
         saveTableColumnWidth: (field: string, width: number, columns: AXPReportTableColumnViewModel[]) => Promise<void>;
-        saveTableSorts: (sorts: node_modules__acorex_platform_framework_shared_entity_src_lib.AXPQuerySort[]) => Promise<void>;
+        saveTableSorts: (sorts: _acorex_platform_framework_shared_entity.AXPQuerySort[]) => Promise<void>;
         saveTablePageSize: (pageSize: number) => Promise<void>;
         executeReport: () => Promise<void>;
-        fetchData: (query?: _acorex_cdk_common.AXDataSourceQuery) => Promise<_acorex_platform_module_report_management_client.AXPExecutionReportCommandResult | null>;
+        fetchData: (query?: _acorex_cdk_common.AXDataSourceQuery) => Promise<_acorex_platform_framework_shared_core.AXPRuntimeQueryResult<unknown> | null>;
+        generateInBackground: () => Promise<void>;
+        nudgeFetch: () => void;
+        loadFrozenRun: (runId: string) => Promise<void>;
         applyDrillView: (options: {
             hideColumnFields: string[];
         }) => void;
@@ -680,17 +704,22 @@ declare class AXPReportBarChartViewComponent {
     } & _ngrx_signals.StateSource<{
         reportDefinition: _acorex_platform_module_report_management_client.AXPReportDefinition | null;
         currentLayout: _acorex_platform_module_report_management_client.AXPReportLayoutDefinition | null;
-        filterContext: node_modules__acorex_platform_framework_shared_core_src_lib.AXPContextData;
-        categoriesPath: any[];
+        filterContext: _acorex_platform_framework_shared_core.AXPContextData;
         allowFetchData: boolean;
         shouldExecuteReport: boolean;
         executionRequestId: number;
-        lastAppliedFilterContext: node_modules__acorex_platform_framework_shared_core_src_lib.AXPContextData | null;
+        lastAppliedFilterContext: _acorex_platform_framework_shared_core.AXPContextData | null;
         hasBeenExecuted: boolean;
         status: AXPPageStatus;
         error: string | null;
         showRowIndexColumn: boolean;
         reportUserSettings: _acorex_platform_module_report_management_client.AXPReportViewerUserSettings | null;
+        runId: string | null;
+        frozen: boolean;
+        freeze: _acorex_platform_module_report_management_client.AXPReportViewerFreeze | null;
+        backgroundQueued: boolean;
+        parametersReadonly: boolean;
+        selectedLayoutIds: string[];
     }>;
     protected readonly AXPPageStatus: typeof AXPPageStatus;
     /**
@@ -738,7 +767,6 @@ declare class AXPReportTableViewComponent {
         reportDefinition: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportDefinition | null>;
         currentLayout: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportLayoutDefinition | null>;
         filterContext: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPContextData>;
-        categoriesPath: _angular_core.Signal<any[]>;
         allowFetchData: _angular_core.Signal<boolean>;
         shouldExecuteReport: _angular_core.Signal<boolean>;
         executionRequestId: _angular_core.Signal<number>;
@@ -748,6 +776,12 @@ declare class AXPReportTableViewComponent {
         error: _angular_core.Signal<string | null>;
         showRowIndexColumn: _angular_core.Signal<boolean>;
         reportUserSettings: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportViewerUserSettings | null>;
+        runId: _angular_core.Signal<string | null>;
+        frozen: _angular_core.Signal<boolean>;
+        freeze: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportViewerFreeze | null>;
+        backgroundQueued: _angular_core.Signal<boolean>;
+        parametersReadonly: _angular_core.Signal<boolean>;
+        selectedLayoutIds: _angular_core.Signal<string[]>;
         availableLayouts: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPLayoutSwitcherOption[]>;
         defaultLayout: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportLayoutDefinition | null>;
         activeLayoutId: _angular_core.Signal<string | null>;
@@ -760,25 +794,36 @@ declare class AXPReportTableViewComponent {
         hasError: _angular_core.Signal<boolean>;
         canExecute: _angular_core.Signal<boolean>;
         hasMultipleLayouts: _angular_core.Signal<boolean>;
-        title: _angular_core.Signal<string>;
-        description: _angular_core.Signal<string | null>;
+        title: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPMultiLanguageString>;
+        description: _angular_core.Signal<_acorex_platform_framework_shared_core.AXPMultiLanguageString | null>;
         formDefinition: _angular_core.Signal<dist_libs_framework_client_types_acorex_platform_framework_client_layout_builder.AXPDynamicFormDefinition>;
         isTableLayout: _angular_core.Signal<boolean>;
         isChartLayout: _angular_core.Signal<boolean>;
         isPdfLayout: _angular_core.Signal<boolean>;
         hasUnappliedFilters: _angular_core.Signal<boolean>;
-        canSwitchLayout: _angular_core.Signal<boolean>;
         canSelectRows: _angular_core.Signal<boolean | undefined>;
         tableLayoutUserSettings: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportTableLayoutUserState | null>;
         reportId: _angular_core.Signal<string | null>;
+        isFrozen: _angular_core.Signal<boolean>;
+        isBackgroundQueued: _angular_core.Signal<boolean>;
+        isBackgroundReportMode: _angular_core.Signal<boolean>;
+        hasSelectedBackgroundLayouts: _angular_core.Signal<boolean>;
+        areParametersReadonly: _angular_core.Signal<boolean>;
+        canSwitchLayout: _angular_core.Signal<boolean>;
+        generationMode: _angular_core.Signal<_acorex_platform_module_report_management_client.AXPReportGenerationMode>;
         loadReport: (reportId: string) => Promise<void>;
         switchLayout: (layoutId: string) => void;
+        isBackgroundLayoutSelected: (layoutId: string) => boolean;
+        setBackgroundLayoutSelected: (layoutId: string, selected: boolean) => void;
         saveTableColumnOrder: (columns: AXPReportTableColumnViewModel[]) => Promise<void>;
         saveTableColumnWidth: (field: string, width: number, columns: AXPReportTableColumnViewModel[]) => Promise<void>;
         saveTableSorts: (sorts: AXPQuerySort[]) => Promise<void>;
         saveTablePageSize: (pageSize: number) => Promise<void>;
         executeReport: () => Promise<void>;
-        fetchData: (query?: AXDataSourceQuery) => Promise<_acorex_platform_module_report_management_client.AXPExecutionReportCommandResult | null>;
+        fetchData: (query?: AXDataSourceQuery) => Promise<_acorex_platform_framework_shared_core.AXPRuntimeQueryResult<unknown> | null>;
+        generateInBackground: () => Promise<void>;
+        nudgeFetch: () => void;
+        loadFrozenRun: (runId: string) => Promise<void>;
         applyDrillView: (options: {
             hideColumnFields: string[];
         }) => void;
@@ -795,7 +840,6 @@ declare class AXPReportTableViewComponent {
         reportDefinition: _acorex_platform_module_report_management_client.AXPReportDefinition | null;
         currentLayout: _acorex_platform_module_report_management_client.AXPReportLayoutDefinition | null;
         filterContext: _acorex_platform_framework_shared_core.AXPContextData;
-        categoriesPath: any[];
         allowFetchData: boolean;
         shouldExecuteReport: boolean;
         executionRequestId: number;
@@ -805,6 +849,12 @@ declare class AXPReportTableViewComponent {
         error: string | null;
         showRowIndexColumn: boolean;
         reportUserSettings: _acorex_platform_module_report_management_client.AXPReportViewerUserSettings | null;
+        runId: string | null;
+        frozen: boolean;
+        freeze: _acorex_platform_module_report_management_client.AXPReportViewerFreeze | null;
+        backgroundQueued: boolean;
+        parametersReadonly: boolean;
+        selectedLayoutIds: string[];
     }>;
     protected readonly commandService: AXPCommandService;
     private readonly expressionEvaluator;
@@ -845,5 +895,5 @@ declare class AXPReportTableViewComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPReportTableViewComponent, "axp-report-table-view", never, {}, {}, never, never, true, never>;
 }
 
-export { AXBarChartReportMapper, AXLineChartReportMapper, AXMPermissionDefinitionProvider, AXMReportManagementModule, AXPDrillToReportCommand, AXPReportBarChartViewComponent, AXPReportTableViewComponent, AXPReportViewerPageComponent, AXPReportViewerService, AXPReportViewerViewModel, AXPieChartReportMapper, convertContextDataToFilterClause };
-export type { AXPDrillToReportCommandInput, AXPReportTableColumnUserState, AXPReportTableLayoutUserState, AXPReportViewerUserSettings };
+export { AXBarChartReportMapper, AXLineChartReportMapper, AXMPermissionDefinitionProvider, AXMReportManagementModule, AXPOpenReportInPopupCommand, AXPOpenReportViewerCommand, AXPReportBarChartViewComponent, AXPReportTableViewComponent, AXPReportViewerPageComponent, AXPReportViewerService, AXPReportViewerViewModel, AXPieChartReportMapper, collectReportParameterDefaults, convertContextDataToFilterClause, flattenReportParametersToQueryParams, formatReportDateOnly, isReportDateRangeObject, mapEntityBindingParameters, queryResultToChartSeries, queryResultToPdfSource, resolveReportFilterDefaultValue, resolveReportParameterValues, resolveTodayDateRange, toReportDateRangeFilterValue };
+export type { AXPOpenReportInPopupCommandInput, AXPOpenReportViewerCommandInput, AXPReportDateRangeValue, AXPReportParameterValue, AXPReportPdfSource, AXPReportTableColumnUserState, AXPReportTableLayoutUserState, AXPReportViewerUserSettings };