@acorex/platform 20.0.4 → 20.0.6

package/common/index.d.ts

@@ -1282,6 +1282,106 @@ declare abstract class AXPLockService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPLockService>;
 }
 
+interface AXPReportCategory {
+    id: string;
+    title: string;
+    description?: string;
+    parentId?: string;
+    hasChild?: boolean;
+    hasReport?: boolean;
+}
+interface AXPReportDefinition {
+    id: string;
+    title: string;
+    description?: string;
+    categoryIds: string[];
+    parameterGroups: AXPReportParameterGroup[];
+}
+interface AXPReportParameterGroup {
+    name: string;
+    title: string;
+    description?: string;
+    parameters: AXPReportParameter[];
+}
+interface AXPReportParameter {
+    path: string;
+    title: string;
+    description?: string;
+    widget: AXPWidgetNode;
+}
+
+type AXPReportDefinitionProviderToken = AXPReportDefinitionProvider | Promise<AXPReportDefinitionProvider>;
+declare const AXP_REPORT_DEFINITION_PROVIDER: InjectionToken<AXPReportDefinitionProviderToken[]>;
+interface AXPReportDefinitionProvider {
+    getList(categoryId: string): Promise<AXPReportDefinition[]>;
+    getById(id: string): Promise<AXPReportDefinition | undefined>;
+}
+type AXPReportCategoryProviderToken = AXPReportCategoryProvider | Promise<AXPReportCategoryProvider>;
+declare const AXP_REPORT_CATEGORY_PROVIDER: InjectionToken<AXPReportCategoryProviderToken[]>;
+interface AXPReportCategoryProvider {
+    getList(parentId?: string): Promise<AXPReportCategory[]>;
+    getById(id: string): Promise<AXPReportCategory | undefined>;
+}
+
+declare class AXPReportDefinitionService {
+    private readonly categoryProviders;
+    private readonly definitionProviders;
+    /** Cache for definitions by categoryId. */
+    private definitionsByCategory;
+    /** Cache for categories by id. */
+    private categoriesById;
+    /** Cache for categories by parentId. */
+    private categoriesByParentId;
+    /**
+     * Returns all categories for a given parentId, loading from providers if not cached.
+     * @param parentId The parent ID to filter by (or undefined for root categories).
+     */
+    getCategories(parentId?: string): Promise<AXPReportCategory[]>;
+    /**
+     * Returns all report definitions for a given categoryId, loading from providers if not cached.
+     * @param categoryId The category ID to filter by.
+     */
+    getReportsByCategoryId(categoryId: string): Promise<AXPReportDefinition[]>;
+    /**
+     * Returns a report definition by its id.
+     * First checks the cache, then queries all providers if not found.
+     * @param id The report id.
+     * @returns The report definition if found, undefined otherwise.
+     */
+    getReportById(id: string): Promise<AXPReportDefinition | undefined>;
+    /**
+     * Returns a category by its id, using cache and providers if needed.
+     * @param categoryId The category id.
+     */
+    getCategoryById(categoryId: string): Promise<AXPReportCategory | undefined>;
+    /**
+     * Returns the full categories path from root to the specified category.
+     * @param categoryId The category ID to get the path for.
+     * @returns Array of categories from root to the specified category.
+     * @throws Error if category not found.
+     */
+    getCategoriesPathById(categoryId: string): Promise<AXPReportCategory[]>;
+    /**
+     * Returns the full categories path for the category that contains the specified report.
+     * @param reportId The report ID to find the category path for.
+     * @returns Array of categories from root to the category containing the report.
+     * @throws Error if report not found.
+     */
+    getCategoriesPathByReportId(reportId: string): Promise<AXPReportCategory[]>;
+    /**
+     * Returns the category ID that contains a specific report.
+     * @param reportId The report ID to search for.
+     * @returns The category ID containing the report, or undefined if not found.
+     */
+    getCategoryIdByReportId(reportId: string): Promise<string | undefined>;
+    /** Clears the definitions by category cache. */
+    clearDefinitionsCache(): void;
+    /** Clears the categories by parentId cache. */
+    clearCategoriesCache(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPReportDefinitionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPReportDefinitionService>;
+}
+
 declare class AXPClipBoardService {
     private toast;
     copy(title: string, value: string): void;
@@ -1444,5 +1544,5 @@ declare class AXMWorkflowErrorHandler implements AXPErrorHandler {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXMWorkflowErrorHandler>;
 }
 
-export { ALL_DEFAULT_OPERATORS, AXMWorkflowErrorHandler, AXPCleanNestedFilters, AXPClipBoardService, AXPCommonModule, AXPCustomOperatorService, AXPCustomOperatorServiceImpl, AXPDataProvider, AXPDialogConfirmAction, AXPEntityCommandScope, AXPEntityQueryType, AXPErrorHandlerRegistryService, AXPExportService, AXPFileStorageService, AXPFileStorageStatus, AXPFileTypeProviderService, AXPFilterOperatorMiddlewareService, AXPFilterOperatorMiddlewareServiceImpl, AXPFooterTextSlotComponent, AXPGlobalErrorHandler, AXPGridLayoutDirective, AXPHomePageModule, AXPHomePageService, AXPLockService, AXPLogoComponent, AXPMenuProviderService, AXPMenuSearchDefinitionProvider, AXPMenuSearchProvider, AXPMenuService, AXPNavBarSlotComponent, AXPNavigateWorkflow, AXPPlatformDefaultConfigs, AXPRedirectEvent, AXPRefreshEvent, AXPRegionalService, AXPRelationshipCardinality, AXPRelationshipKind, AXPSearchCommandProvider, AXPSearchDefinitionActionBuilder, AXPSearchDefinitionBuilder, AXPSearchDefinitionProviderContext, AXPSearchDefinitionProviderService, AXPSearchService, AXPSettingDefaultValueProvider, AXPSettingDefinitionGroupBuilder, AXPSettingDefinitionProviderContext, AXPSettingDefinitionProviderService, AXPSettingDefinitionSectionBuilder, AXPSettingService, AXPStickyDirective, AXPToastAction, AXPWorkflowNavigateAction, AXPWorkflowRouterNavigateAction, AXP_APP_VERSION_PROVIDER, AXP_FILE_TYPE_INFO_PROVIDER, AXP_HOME_PAGES, AXP_HOME_PAGE_DEFAULT_KEY, AXP_MENU_PROVIDER, AXP_PLATFORM_CONFIG_TOKEN, AXP_ROOT_CONFIG_TOKEN, AXP_SEARCH_DEFINITION_PROVIDER, AXP_SEARCH_PROVIDER, AXP_SETTING_DEFINITION_PROVIDER, AXP_SETTING_VALUE_PROVIDER, BETWEEN_OPER, BOOLEAN_OPERATORS, CONTAINS_OPER, DATE_OPERATORS, ENDS_WITH_OPER, ENVIRONMENT, EQ_OPER, GTE_OPER, GT_OPER, IS_EMPTY_OPER, IS_NOT_EMPTY_OPER, LTE_OPER, LT_OPER, NOT_CONTAINS_OPER, NOT_EQ_OPER, NUMBER_OPERATORS, STARTS_WITH_OPER, STRING_OPERATORS, configPlatform, createAllQueryView, createQueryView, getEntityInfo, provideDynamicHomePage, resolveActionLook };
-export type { AXEntityPropertyWidget, AXPAggregate, AXPAppVersion, AXPAppVersionProvider, AXPApplication, AXPCategoryEntity, AXPCity, AXPCommandActionCallback, AXPCommandActionDisplay, AXPCommandActionLook, AXPCommandActionPriority, AXPCommandActionType, AXPCommonModuleConfigs, AXPCountry, AXPCurrency, AXPDomToImageOptions, AXPEntity, AXPEntityAction, AXPEntityCommand, AXPEntityDetailListView, AXPEntityMasterCreateLayoutView, AXPEntityMasterLayoutView, AXPEntityMasterListView, AXPEntityMasterSingleLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityProperty, AXPEntityPropertyCreateView, AXPEntityPropertyGroup, AXPEntityPropertyLayoutConfig, AXPEntityPropertyUpdateView, AXPEntityPropertyView, AXPEntityQuery, AXPEntitySectionView, AXPEntityTableColumn, AXPEntityVersionHistory, AXPErrorHandler, AXPFileExtension, AXPFileStorageCreateRequest, AXPFileStorageFindRequest, AXPFileStorageInfo, AXPFileStorageUpdateRequest, AXPFileType, AXPFileTypeInfoProvider, AXPFilterOperator, AXPGeoLocation, AXPGridLayoutOptions, AXPGridLayoutPositions, AXPGroupSearchResult, AXPHomePageDefinition, AXPLanguage, AXPLocaleProfile, AXPLockGetInfoRequest, AXPLockInfo, AXPLockRequest, AXPLockType, AXPMenuFinderResult, AXPMenuInsertion, AXPMenuItem, AXPMenuItemCommand, AXPMenuItemWithParent, AXPMenuProvider, AXPMenuProviderContext, AXPMenuType, AXPModule, AXPPlatformConfigs, AXPProvince, AXPQueryFilter, AXPQuerySort, AXPQueryView, AXPRelatedEntity, AXPRelationship, AXPRootConfigs, AXPSearchAction, AXPSearchDefinition, AXPSearchDefinitionDisplayFormat, AXPSearchDefinitionProvider, AXPSearchDisplayGroupResult, AXPSearchDisplayResult, AXPSearchDisplayResultForSave, AXPSearchParentResult, AXPSearchProvider, AXPSearchResult, AXPSettingChangedEvent, AXPSettingDefinition, AXPSettingDefinitionGroup, AXPSettingDefinitionProvider, AXPSettingDefinitionSection, AXPSettingServiceInterface, AXPSettingValue, AXPSettingValueProvider, AXPTimeZone, AXPUnLockRequest };
+export { ALL_DEFAULT_OPERATORS, AXMWorkflowErrorHandler, AXPCleanNestedFilters, AXPClipBoardService, AXPCommonModule, AXPCustomOperatorService, AXPCustomOperatorServiceImpl, AXPDataProvider, AXPDialogConfirmAction, AXPEntityCommandScope, AXPEntityQueryType, AXPErrorHandlerRegistryService, AXPExportService, AXPFileStorageService, AXPFileStorageStatus, AXPFileTypeProviderService, AXPFilterOperatorMiddlewareService, AXPFilterOperatorMiddlewareServiceImpl, AXPFooterTextSlotComponent, AXPGlobalErrorHandler, AXPGridLayoutDirective, AXPHomePageModule, AXPHomePageService, AXPLockService, AXPLogoComponent, AXPMenuProviderService, AXPMenuSearchDefinitionProvider, AXPMenuSearchProvider, AXPMenuService, AXPNavBarSlotComponent, AXPNavigateWorkflow, AXPPlatformDefaultConfigs, AXPRedirectEvent, AXPRefreshEvent, AXPRegionalService, AXPRelationshipCardinality, AXPRelationshipKind, AXPReportDefinitionService, AXPSearchCommandProvider, AXPSearchDefinitionActionBuilder, AXPSearchDefinitionBuilder, AXPSearchDefinitionProviderContext, AXPSearchDefinitionProviderService, AXPSearchService, AXPSettingDefaultValueProvider, AXPSettingDefinitionGroupBuilder, AXPSettingDefinitionProviderContext, AXPSettingDefinitionProviderService, AXPSettingDefinitionSectionBuilder, AXPSettingService, AXPStickyDirective, AXPToastAction, AXPWorkflowNavigateAction, AXPWorkflowRouterNavigateAction, AXP_APP_VERSION_PROVIDER, AXP_FILE_TYPE_INFO_PROVIDER, AXP_HOME_PAGES, AXP_HOME_PAGE_DEFAULT_KEY, AXP_MENU_PROVIDER, AXP_PLATFORM_CONFIG_TOKEN, AXP_REPORT_CATEGORY_PROVIDER, AXP_REPORT_DEFINITION_PROVIDER, AXP_ROOT_CONFIG_TOKEN, AXP_SEARCH_DEFINITION_PROVIDER, AXP_SEARCH_PROVIDER, AXP_SETTING_DEFINITION_PROVIDER, AXP_SETTING_VALUE_PROVIDER, BETWEEN_OPER, BOOLEAN_OPERATORS, CONTAINS_OPER, DATE_OPERATORS, ENDS_WITH_OPER, ENVIRONMENT, EQ_OPER, GTE_OPER, GT_OPER, IS_EMPTY_OPER, IS_NOT_EMPTY_OPER, LTE_OPER, LT_OPER, NOT_CONTAINS_OPER, NOT_EQ_OPER, NUMBER_OPERATORS, STARTS_WITH_OPER, STRING_OPERATORS, configPlatform, createAllQueryView, createQueryView, getEntityInfo, provideDynamicHomePage, resolveActionLook };
+export type { AXEntityPropertyWidget, AXPAggregate, AXPAppVersion, AXPAppVersionProvider, AXPApplication, AXPCategoryEntity, AXPCity, AXPCommandActionCallback, AXPCommandActionDisplay, AXPCommandActionLook, AXPCommandActionPriority, AXPCommandActionType, AXPCommonModuleConfigs, AXPCountry, AXPCurrency, AXPDomToImageOptions, AXPEntity, AXPEntityAction, AXPEntityCommand, AXPEntityDetailListView, AXPEntityMasterCreateLayoutView, AXPEntityMasterLayoutView, AXPEntityMasterListView, AXPEntityMasterSingleLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityProperty, AXPEntityPropertyCreateView, AXPEntityPropertyGroup, AXPEntityPropertyLayoutConfig, AXPEntityPropertyUpdateView, AXPEntityPropertyView, AXPEntityQuery, AXPEntitySectionView, AXPEntityTableColumn, AXPEntityVersionHistory, AXPErrorHandler, AXPFileExtension, AXPFileStorageCreateRequest, AXPFileStorageFindRequest, AXPFileStorageInfo, AXPFileStorageUpdateRequest, AXPFileType, AXPFileTypeInfoProvider, AXPFilterOperator, AXPGeoLocation, AXPGridLayoutOptions, AXPGridLayoutPositions, AXPGroupSearchResult, AXPHomePageDefinition, AXPLanguage, AXPLocaleProfile, AXPLockGetInfoRequest, AXPLockInfo, AXPLockRequest, AXPLockType, AXPMenuFinderResult, AXPMenuInsertion, AXPMenuItem, AXPMenuItemCommand, AXPMenuItemWithParent, AXPMenuProvider, AXPMenuProviderContext, AXPMenuType, AXPModule, AXPPlatformConfigs, AXPProvince, AXPQueryFilter, AXPQuerySort, AXPQueryView, AXPRelatedEntity, AXPRelationship, AXPReportCategory, AXPReportCategoryProvider, AXPReportCategoryProviderToken, AXPReportDefinition, AXPReportDefinitionProvider, AXPReportDefinitionProviderToken, AXPReportParameter, AXPReportParameterGroup, AXPRootConfigs, AXPSearchAction, AXPSearchDefinition, AXPSearchDefinitionDisplayFormat, AXPSearchDefinitionProvider, AXPSearchDisplayGroupResult, AXPSearchDisplayResult, AXPSearchDisplayResultForSave, AXPSearchParentResult, AXPSearchProvider, AXPSearchResult, AXPSettingChangedEvent, AXPSettingDefinition, AXPSettingDefinitionGroup, AXPSettingDefinitionProvider, AXPSettingDefinitionSection, AXPSettingServiceInterface, AXPSettingValue, AXPSettingValueProvider, AXPTimeZone, AXPUnLockRequest };

package/core/index.d.ts

@@ -1177,7 +1177,7 @@ declare class AXPExpressionEvaluatorService {
     private getMergedScope;
     evaluate(source: any | any[], scope: AXPExpressionEvaluatorScope): Promise<any>;
     private evaluateStringExpression;
-    isExpression(expression: unknown): boolean;
+    isExpression(expression: string): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPExpressionEvaluatorService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPExpressionEvaluatorService>;
 }

package/domain/index.d.ts

@@ -1,7 +1,6 @@
 import * as i0 from '@angular/core';
 import { InjectionToken, EnvironmentProviders } from '@angular/core';
 import * as i1 from '@acorex/platform/runtime';
-import { AXPOptionsData } from '@acorex/platform/core';
 
 declare const AXP_ENTITY_CRUD_SETUP: InjectionToken<void>;
 declare function provideEntity(entityKeys: string[]): EnvironmentProviders;
@@ -13,67 +12,4 @@ declare class AXPDomainModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<AXPDomainModule>;
 }
 
-declare enum AXPRelationshipKind {
-    Association = 0,
-    Composition = 1,
-    Aggregation = 2
-}
-declare enum AXPRelationshipCardinality {
-    OneToOne = 0,
-    OneToMany = 1,
-    ManyToMany = 2
-}
-declare enum AXPEntityType {
-    Entity = 0,
-    AggregateRoot = 1,
-    ValueObject = 2
-}
-interface AXPRelationshipDefinition {
-    key: string;
-    source: {
-        path: string;
-        field: string;
-    };
-    target: {
-        path: string;
-        field: string;
-    };
-    kind: AXPRelationshipKind;
-    cardinality: AXPRelationshipCardinality;
-}
-interface AXPModuleDefinition {
-    key: string;
-    title: string;
-    description: string;
-    icon: string;
-    aggregates: AXPAggregateDefinition[];
-}
-interface AXPAggregateDefinition {
-    key: string;
-    title: string;
-    entities: AXPEntityDefinition[];
-}
-interface AXPEntityDefinition {
-    key: string;
-    title: string;
-    fields: AXPEntityFieldDefinition[];
-    type: AXPEntityType;
-}
-interface AXPEntityFieldDefinition {
-    key: string;
-    title: string;
-    dataType: string;
-    widget: {
-        type: string;
-        options?: AXPOptionsData;
-    };
-}
-declare enum AXPEntityCommandScope {
-    TypeLevel = "typeLevel",
-    Selected = "selected",
-    Individual = "individual",
-    Section = "section"
-}
-
-export { AXPDomainModule, AXPEntityCommandScope, AXPEntityType, AXPRelationshipCardinality, AXPRelationshipKind, AXP_ENTITY_CRUD_SETUP, provideEntity };
-export type { AXPAggregateDefinition, AXPEntityDefinition, AXPEntityFieldDefinition, AXPModuleDefinition, AXPRelationshipDefinition };
+export { AXPDomainModule, AXP_ENTITY_CRUD_SETUP, provideEntity };

package/fesm2022/acorex-platform-common.mjs

@@ -2231,6 +2231,248 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.0.4", ngImpor
             type: Injectable
         }] });
 
+const AXP_REPORT_DEFINITION_PROVIDER = new InjectionToken('AXP_REPORT_DEFINITION_PROVIDER', {
+    factory: () => [],
+});
+const AXP_REPORT_CATEGORY_PROVIDER = new InjectionToken('AXP_REPORT_CATEGORY_PROVIDER', {
+    factory: () => [],
+});
+
+//#region ----   Imports   ----
+//#endregion
+class AXPReportDefinitionService {
+    constructor() {
+        //#region ----   Providers & Caches   ----
+        this.categoryProviders = inject(AXP_REPORT_CATEGORY_PROVIDER, { optional: true }) || [];
+        this.definitionProviders = inject(AXP_REPORT_DEFINITION_PROVIDER, { optional: true }) || [];
+        /** Cache for definitions by categoryId. */
+        this.definitionsByCategory = new Map();
+        /** Cache for categories by id. */
+        this.categoriesById = new Map();
+        /** Cache for categories by parentId. */
+        this.categoriesByParentId = new Map();
+    }
+    //#endregion
+    //#region ----   Public API   ----
+    /**
+     * Returns all categories for a given parentId, loading from providers if not cached.
+     * @param parentId The parent ID to filter by (or undefined for root categories).
+     */
+    async getCategories(parentId) {
+        if (this.categoriesByParentId.has(parentId)) {
+            return this.categoriesByParentId.get(parentId);
+        }
+        const resolvedProviders = await Promise.all(this.categoryProviders);
+        const categories = [];
+        for (const provider of resolvedProviders) {
+            if (provider && typeof provider.getList === 'function') {
+                const cats = await provider.getList(parentId);
+                if (Array.isArray(cats)) {
+                    categories.push(...cats);
+                }
+            }
+        }
+        this.categoriesByParentId.set(parentId, categories);
+        // Optionally update categoriesById cache for fast lookup by id
+        for (const cat of categories) {
+            this.categoriesById.set(cat.id, cat);
+        }
+        return categories;
+    }
+    /**
+     * Returns all report definitions for a given categoryId, loading from providers if not cached.
+     * @param categoryId The category ID to filter by.
+     */
+    async getReportsByCategoryId(categoryId) {
+        if (this.definitionsByCategory.has(categoryId)) {
+            return this.definitionsByCategory.get(categoryId);
+        }
+        const resolvedProviders = await Promise.all(this.definitionProviders);
+        const definitions = [];
+        for (const provider of resolvedProviders) {
+            if (provider && typeof provider.getList === 'function') {
+                const defs = await provider.getList(categoryId);
+                if (Array.isArray(defs)) {
+                    definitions.push(...defs);
+                }
+            }
+        }
+        this.definitionsByCategory.set(categoryId, definitions);
+        return definitions;
+    }
+    /**
+     * Returns a report definition by its id.
+     * First checks the cache, then queries all providers if not found.
+     * @param id The report id.
+     * @returns The report definition if found, undefined otherwise.
+     */
+    async getReportById(id) {
+        // Check cache first
+        for (const reports of this.definitionsByCategory.values()) {
+            const found = reports.find(report => report.id === id);
+            if (found) {
+                return found;
+            }
+        }
+        // Not in cache, query providers
+        const resolvedProviders = await Promise.all(this.definitionProviders);
+        const results = await Promise.all(resolvedProviders
+            .filter(p => p && typeof p.getById === 'function')
+            .map(p => p.getById(id)));
+        return results.find(r => r !== undefined);
+    }
+    /**
+     * Returns a category by its id, using cache and providers if needed.
+     * @param categoryId The category id.
+     */
+    async getCategoryById(categoryId) {
+        // Check if it's already in cache
+        if (this.categoriesById.has(categoryId)) {
+            return this.categoriesById.get(categoryId);
+        }
+        // Search in already loaded categories first
+        for (const [parentId, categories] of this.categoriesByParentId.entries()) {
+            const found = categories.find(cat => cat.id === categoryId);
+            if (found) {
+                this.categoriesById.set(categoryId, found);
+                return found;
+            }
+        }
+        // If not found in loaded categories, we need to search level by level
+        // Start with root categories if not already loaded
+        if (!this.categoriesByParentId.has(undefined)) {
+            await this.getCategories();
+            const found = this.categoriesById.get(categoryId);
+            if (found)
+                return found;
+        }
+        // Search through loaded categories and their children
+        const searchQueue = [undefined];
+        const searched = new Set();
+        while (searchQueue.length > 0) {
+            const parentId = searchQueue.shift();
+            if (searched.has(parentId))
+                continue;
+            searched.add(parentId);
+            const categories = await this.getCategories(parentId);
+            const found = categories.find(cat => cat.id === categoryId);
+            if (found) {
+                return found;
+            }
+            // Add children to search queue
+            for (const category of categories) {
+                if (!searched.has(category.id)) {
+                    searchQueue.push(category.id);
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Returns the full categories path from root to the specified category.
+     * @param categoryId The category ID to get the path for.
+     * @returns Array of categories from root to the specified category.
+     * @throws Error if category not found.
+     */
+    async getCategoriesPathById(categoryId) {
+        const path = [];
+        let currentCategoryId = categoryId;
+        while (currentCategoryId) {
+            // Try to get from cache first
+            let category = this.categoriesById.get(currentCategoryId);
+            // If not in cache, we need to find it by searching parent levels
+            if (!category) {
+                category = await this.getCategoryById(currentCategoryId);
+                if (!category) {
+                    throw new Error(`Category with id '${currentCategoryId}' not found`);
+                }
+            }
+            path.unshift(category); // Add to beginning to maintain root->target order
+            currentCategoryId = category.parentId;
+        }
+        return path;
+    }
+    /**
+     * Returns the full categories path for the category that contains the specified report.
+     * @param reportId The report ID to find the category path for.
+     * @returns Array of categories from root to the category containing the report.
+     * @throws Error if report not found.
+     */
+    async getCategoriesPathByReportId(reportId) {
+        // Find which category contains this report
+        const categoryId = await this.getCategoryIdByReportId(reportId);
+        if (!categoryId) {
+            throw new Error(`Report with id '${reportId}' not found in any category`);
+        }
+        return this.getCategoriesPathById(categoryId);
+    }
+    /**
+     * Returns the category ID that contains a specific report.
+     * @param reportId The report ID to search for.
+     * @returns The category ID containing the report, or undefined if not found.
+     */
+    async getCategoryIdByReportId(reportId) {
+        // First check already cached report definitions
+        for (const [categoryId, reports] of this.definitionsByCategory.entries()) {
+            if (reports.some(report => report.id === reportId)) {
+                return categoryId;
+            }
+        }
+        // If not found in cache, search through categories level by level
+        // Start with root categories
+        if (!this.categoriesByParentId.has(undefined)) {
+            await this.getCategories();
+        }
+        const searchQueue = [];
+        const searched = new Set();
+        // Add all known category IDs to search queue
+        for (const category of this.categoriesById.values()) {
+            searchQueue.push(category.id);
+        }
+        // Search level by level
+        const searchQueueParents = [undefined];
+        const searchedParents = new Set();
+        while (searchQueueParents.length > 0) {
+            const parentId = searchQueueParents.shift();
+            if (searchedParents.has(parentId))
+                continue;
+            searchedParents.add(parentId);
+            const categories = await this.getCategories(parentId);
+            // Check reports in each category
+            for (const category of categories) {
+                if (!searched.has(category.id)) {
+                    searched.add(category.id);
+                    const reports = await this.getReportsByCategoryId(category.id);
+                    if (reports.some(report => report.id === reportId)) {
+                        return category.id;
+                    }
+                    // Add category to search queue for children
+                    searchQueueParents.push(category.id);
+                }
+            }
+        }
+        return undefined;
+    }
+    //#endregion
+    //#region ----   Cache Management   ----
+    /** Clears the definitions by category cache. */
+    clearDefinitionsCache() {
+        this.definitionsByCategory.clear();
+    }
+    /** Clears the categories by parentId cache. */
+    clearCategoriesCache() {
+        this.categoriesByParentId.clear();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.0.4", ngImport: i0, type: AXPReportDefinitionService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.0.4", ngImport: i0, type: AXPReportDefinitionService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.0.4", ngImport: i0, type: AXPReportDefinitionService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
+
 class AXPClipBoardService {
     constructor() {
         this.toast = inject(AXToastService);
@@ -2508,5 +2750,5 @@ class AXPRegionalService {
  * Generated bundle index. Do not edit.
  */
 
-export { ALL_DEFAULT_OPERATORS, AXMWorkflowErrorHandler, AXPCleanNestedFilters, AXPClipBoardService, AXPCommonModule, AXPCustomOperatorService, AXPCustomOperatorServiceImpl, AXPDataProvider, AXPDialogConfirmAction, AXPEntityCommandScope, AXPEntityQueryType, AXPErrorHandlerRegistryService, AXPExportService, AXPFileStorageService, AXPFileStorageStatus, AXPFileTypeProviderService, AXPFilterOperatorMiddlewareService, AXPFilterOperatorMiddlewareServiceImpl, AXPFooterTextSlotComponent, AXPGlobalErrorHandler, AXPGridLayoutDirective, AXPHomePageModule, AXPHomePageService, AXPLockService, AXPLogoComponent, AXPMenuProviderService, AXPMenuSearchDefinitionProvider, AXPMenuSearchProvider, AXPMenuService, AXPNavBarSlotComponent, AXPNavigateWorkflow, AXPPlatformDefaultConfigs, AXPRedirectEvent, AXPRefreshEvent, AXPRegionalService, AXPRelationshipCardinality, AXPRelationshipKind, AXPSearchCommandProvider, AXPSearchDefinitionActionBuilder, AXPSearchDefinitionBuilder, AXPSearchDefinitionProviderContext, AXPSearchDefinitionProviderService, AXPSearchService, AXPSettingDefaultValueProvider, AXPSettingDefinitionGroupBuilder, AXPSettingDefinitionProviderContext, AXPSettingDefinitionProviderService, AXPSettingDefinitionSectionBuilder, AXPSettingService, AXPStickyDirective, AXPToastAction, AXPWorkflowNavigateAction, AXPWorkflowRouterNavigateAction, AXP_APP_VERSION_PROVIDER, AXP_FILE_TYPE_INFO_PROVIDER, AXP_HOME_PAGES, AXP_HOME_PAGE_DEFAULT_KEY, AXP_MENU_PROVIDER, AXP_PLATFORM_CONFIG_TOKEN, AXP_ROOT_CONFIG_TOKEN, AXP_SEARCH_DEFINITION_PROVIDER, AXP_SEARCH_PROVIDER, AXP_SETTING_DEFINITION_PROVIDER, AXP_SETTING_VALUE_PROVIDER, BETWEEN_OPER, BOOLEAN_OPERATORS, CONTAINS_OPER, DATE_OPERATORS, ENDS_WITH_OPER, ENVIRONMENT, EQ_OPER, GTE_OPER, GT_OPER, IS_EMPTY_OPER, IS_NOT_EMPTY_OPER, LTE_OPER, LT_OPER, NOT_CONTAINS_OPER, NOT_EQ_OPER, NUMBER_OPERATORS, STARTS_WITH_OPER, STRING_OPERATORS, configPlatform, createAllQueryView, createQueryView, getEntityInfo, provideDynamicHomePage, resolveActionLook };
+export { ALL_DEFAULT_OPERATORS, AXMWorkflowErrorHandler, AXPCleanNestedFilters, AXPClipBoardService, AXPCommonModule, AXPCustomOperatorService, AXPCustomOperatorServiceImpl, AXPDataProvider, AXPDialogConfirmAction, AXPEntityCommandScope, AXPEntityQueryType, AXPErrorHandlerRegistryService, AXPExportService, AXPFileStorageService, AXPFileStorageStatus, AXPFileTypeProviderService, AXPFilterOperatorMiddlewareService, AXPFilterOperatorMiddlewareServiceImpl, AXPFooterTextSlotComponent, AXPGlobalErrorHandler, AXPGridLayoutDirective, AXPHomePageModule, AXPHomePageService, AXPLockService, AXPLogoComponent, AXPMenuProviderService, AXPMenuSearchDefinitionProvider, AXPMenuSearchProvider, AXPMenuService, AXPNavBarSlotComponent, AXPNavigateWorkflow, AXPPlatformDefaultConfigs, AXPRedirectEvent, AXPRefreshEvent, AXPRegionalService, AXPRelationshipCardinality, AXPRelationshipKind, AXPReportDefinitionService, AXPSearchCommandProvider, AXPSearchDefinitionActionBuilder, AXPSearchDefinitionBuilder, AXPSearchDefinitionProviderContext, AXPSearchDefinitionProviderService, AXPSearchService, AXPSettingDefaultValueProvider, AXPSettingDefinitionGroupBuilder, AXPSettingDefinitionProviderContext, AXPSettingDefinitionProviderService, AXPSettingDefinitionSectionBuilder, AXPSettingService, AXPStickyDirective, AXPToastAction, AXPWorkflowNavigateAction, AXPWorkflowRouterNavigateAction, AXP_APP_VERSION_PROVIDER, AXP_FILE_TYPE_INFO_PROVIDER, AXP_HOME_PAGES, AXP_HOME_PAGE_DEFAULT_KEY, AXP_MENU_PROVIDER, AXP_PLATFORM_CONFIG_TOKEN, AXP_REPORT_CATEGORY_PROVIDER, AXP_REPORT_DEFINITION_PROVIDER, AXP_ROOT_CONFIG_TOKEN, AXP_SEARCH_DEFINITION_PROVIDER, AXP_SEARCH_PROVIDER, AXP_SETTING_DEFINITION_PROVIDER, AXP_SETTING_VALUE_PROVIDER, BETWEEN_OPER, BOOLEAN_OPERATORS, CONTAINS_OPER, DATE_OPERATORS, ENDS_WITH_OPER, ENVIRONMENT, EQ_OPER, GTE_OPER, GT_OPER, IS_EMPTY_OPER, IS_NOT_EMPTY_OPER, LTE_OPER, LT_OPER, NOT_CONTAINS_OPER, NOT_EQ_OPER, NUMBER_OPERATORS, STARTS_WITH_OPER, STRING_OPERATORS, configPlatform, createAllQueryView, createQueryView, getEntityInfo, provideDynamicHomePage, resolveActionLook };
 //# sourceMappingURL=acorex-platform-common.mjs.map