@acorex/modules 21.0.0-beta.3 → 21.0.0-beta.4

package/fesm2022/acorex-modules-platform-management-entity-master-actions-for-ai.util-OCk5eqQz.mjs

@@ -0,0 +1,56 @@
+//#region ---- Imports ----
+//#endregion
+//#region ---- Helpers ----
+function resolveCommandName(action) {
+    const cmd = action.command;
+    if (typeof cmd === 'object' && cmd != null && typeof cmd.name === 'string') {
+        return cmd.name.trim() || undefined;
+    }
+    return undefined;
+}
+function collectActionsRecursive(actions, translate, out, depth = 0) {
+    if (!actions?.length || depth > 10) {
+        return;
+    }
+    for (const a of actions) {
+        const cmdName = resolveCommandName(a);
+        try {
+            out.push({
+                resolvedTitle: translate(a.title),
+                titleKey: a.title,
+                ...(cmdName ? { commandName: cmdName } : {}),
+                ...(typeof a.type === 'string' && a.type.trim().length ? { actionKind: a.type } : {}),
+                ...(typeof a.scope === 'string' ? { actionScope: a.scope } : {}),
+            });
+        }
+        catch {
+            out.push({
+                resolvedTitle: a.title,
+                titleKey: a.title,
+                ...(cmdName ? { commandName: cmdName } : {}),
+                ...(typeof a.type === 'string' && a.type.trim().length ? { actionKind: a.type } : {}),
+                ...(typeof a.scope === 'string' ? { actionScope: a.scope } : {}),
+            });
+        }
+        if (a.items?.length) {
+            collectActionsRecursive(a.items, translate, out, depth + 1);
+        }
+    }
+}
+/**
+ * Builds stable action labels derived from {@link AXPEntity.interfaces.master} list/single layouts.
+ */
+function axmSummarizeMasterUiActionsForAi(entity, translateWithFallback) {
+    const listToolbar = [];
+    const recordToolbar = [];
+    collectActionsRecursive(entity.interfaces?.master?.list?.actions, translateWithFallback, listToolbar);
+    collectActionsRecursive(entity.interfaces?.master?.single?.actions, translateWithFallback, recordToolbar);
+    return {
+        listToolbar,
+        recordToolbar,
+    };
+}
+//#endregion
+
+export { axmSummarizeMasterUiActionsForAi as a };
+//# sourceMappingURL=acorex-modules-platform-management-entity-master-actions-for-ai.util-OCk5eqQz.mjs.map

package/fesm2022/acorex-modules-platform-management-entity-master-actions-for-ai.util-OCk5eqQz.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorex-modules-platform-management-entity-master-actions-for-ai.util-OCk5eqQz.mjs","sources":["../../../../libs/modules/platform-management/src/lib/features/queries/entity-master-actions-for-ai.util.ts"],"sourcesContent":["//#region ---- Imports ----\n\nimport type { AXPEntity, AXPEntityAction } from '@acorex/platform/common';\n\n//#endregion\n\n//#region ---- Types ----\n\n/**\n * Resolved master UI action for AI grounding — list toolbar vs detail (single) toolbar.\n */\nexport interface AXMEntityMasterActionAiSummary {\n  /** User-visible caption (resolved from {@link AXPEntityAction.title} when possible). */\n  resolvedTitle: string;\n  /** Original entity action title (often `@scope:key`). */\n  titleKey: string;\n  /** Typical command key when known (see {@link AXPEntityAction.command}). */\n  commandName?: string;\n  /** {@link AXPEntityAction.type} (e.g. create, delete, view). */\n  actionKind?: string;\n  /** {@link AXPEntityAction.scope}. */\n  actionScope?: string;\n}\n\n//#endregion\n\n//#region ---- Helpers ----\n\nfunction resolveCommandName(action: AXPEntityAction): string | undefined {\n  const cmd = action.command;\n  if (typeof cmd === 'object' && cmd != null && typeof cmd.name === 'string') {\n    return cmd.name.trim() || undefined;\n  }\n  return undefined;\n}\n\nfunction collectActionsRecursive(\n  actions: AXPEntityAction[] | undefined,\n  translate: (key: string) => string,\n  out: AXMEntityMasterActionAiSummary[],\n  depth = 0,\n): void {\n  if (!actions?.length || depth > 10) {\n    return;\n  }\n  for (const a of actions) {\n    const cmdName = resolveCommandName(a);\n    try {\n      out.push({\n        resolvedTitle: translate(a.title),\n        titleKey: a.title,\n        ...(cmdName ? { commandName: cmdName } : {}),\n        ...(typeof a.type === 'string' && a.type.trim().length ? { actionKind: a.type } : {}),\n        ...(typeof a.scope === 'string' ? { actionScope: a.scope } : {}),\n      });\n    } catch {\n      out.push({\n        resolvedTitle: a.title,\n        titleKey: a.title,\n        ...(cmdName ? { commandName: cmdName } : {}),\n        ...(typeof a.type === 'string' && a.type.trim().length ? { actionKind: a.type } : {}),\n        ...(typeof a.scope === 'string' ? { actionScope: a.scope } : {}),\n      });\n    }\n    if (a.items?.length) {\n      collectActionsRecursive(a.items, translate, out, depth + 1);\n    }\n  }\n}\n\n//#endregion\n\n//#region ---- Public API ----\n\n/** Master interface list + detail (single) actions from an entity definition, for read-only grounding. */\nexport interface AXMEntityMasterUiActionsForAi {\n  listToolbar: AXMEntityMasterActionAiSummary[];\n  recordToolbar: AXMEntityMasterActionAiSummary[];\n}\n\n/**\n * Builds stable action labels derived from {@link AXPEntity.interfaces.master} list/single layouts.\n */\nexport function axmSummarizeMasterUiActionsForAi(\n  entity: AXPEntity,\n  translateWithFallback: (key: string) => string,\n): AXMEntityMasterUiActionsForAi {\n  const listToolbar: AXMEntityMasterActionAiSummary[] = [];\n  const recordToolbar: AXMEntityMasterActionAiSummary[] = [];\n\n  collectActionsRecursive(\n    entity.interfaces?.master?.list?.actions,\n    translateWithFallback,\n    listToolbar,\n  );\n  collectActionsRecursive(\n    entity.interfaces?.master?.single?.actions,\n    translateWithFallback,\n    recordToolbar,\n  );\n\n  return {\n    listToolbar,\n    recordToolbar,\n  };\n}\n\n//#endregion\n"],"names":[],"mappings":"AAAA;AAwBA;AAEA;AAEA,SAAS,kBAAkB,CAAC,MAAuB,EAAA;AACjD,IAAA,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO;AAC1B,IAAA,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE;QAC1E,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,SAAS;IACrC;AACA,IAAA,OAAO,SAAS;AAClB;AAEA,SAAS,uBAAuB,CAC9B,OAAsC,EACtC,SAAkC,EAClC,GAAqC,EACrC,KAAK,GAAG,CAAC,EAAA;IAET,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,GAAG,EAAE,EAAE;QAClC;IACF;AACA,IAAA,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE;AACvB,QAAA,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC;AACrC,QAAA,IAAI;YACF,GAAG,CAAC,IAAI,CAAC;AACP,gBAAA,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;gBACjC,QAAQ,EAAE,CAAC,CAAC,KAAK;AACjB,gBAAA,IAAI,OAAO,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAC5C,gBAAA,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;gBACrF,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;AACjE,aAAA,CAAC;QACJ;AAAE,QAAA,MAAM;YACN,GAAG,CAAC,IAAI,CAAC;gBACP,aAAa,EAAE,CAAC,CAAC,KAAK;gBACtB,QAAQ,EAAE,CAAC,CAAC,KAAK;AACjB,gBAAA,IAAI,OAAO,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAC5C,gBAAA,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;gBACrF,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;AACjE,aAAA,CAAC;QACJ;AACA,QAAA,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE;AACnB,YAAA,uBAAuB,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;QAC7D;IACF;AACF;AAYA;;AAEG;AACG,SAAU,gCAAgC,CAC9C,MAAiB,EACjB,qBAA8C,EAAA;IAE9C,MAAM,WAAW,GAAqC,EAAE;IACxD,MAAM,aAAa,GAAqC,EAAE;AAE1D,IAAA,uBAAuB,CACrB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EACxC,qBAAqB,EACrB,WAAW,CACZ;AACD,IAAA,uBAAuB,CACrB,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAC1C,qBAAqB,EACrB,aAAa,CACd;IAED,OAAO;QACL,WAAW;QACX,aAAa;KACd;AACH;AAEA;;;;"}

package/fesm2022/acorex-modules-platform-management-list-platform-navigation-for-ai.query-C3-eBMwF.mjs

@@ -0,0 +1,198 @@
+import { AXTranslationService } from '@acorex/core/translation';
+import { AXPMenuProviderService } from '@acorex/platform/common';
+import { AXPEntityResolver } from '@acorex/platform/layout/entity';
+import * as i0 from '@angular/core';
+import { inject, Injectable } from '@angular/core';
+import { a as axmSummarizeMasterUiActionsForAi } from './acorex-modules-platform-management-entity-master-actions-for-ai.util-OCk5eqQz.mjs';
+
+//#endregion
+//#region ---- Helpers ----
+const DEFAULT_ROW_LIMIT = 300;
+const MIN_ROW_LIMIT = 40;
+const MAX_ROW_LIMIT = 500;
+function normalizeLimit(raw) {
+    if (typeof raw === 'number' && Number.isFinite(raw)) {
+        const n = Math.floor(raw);
+        return Math.min(MAX_ROW_LIMIT, Math.max(MIN_ROW_LIMIT, n));
+    }
+    if (typeof raw === 'string') {
+        const parsed = Number.parseInt(raw.trim(), 10);
+        if (Number.isFinite(parsed)) {
+            return Math.min(MAX_ROW_LIMIT, Math.max(MIN_ROW_LIMIT, parsed));
+        }
+    }
+    return DEFAULT_ROW_LIMIT;
+}
+function matchesFold(haystack, needle) {
+    return haystack.toLocaleUpperCase().includes(needle.toLocaleUpperCase());
+}
+/** Expects **`Module.Entity`** (`SecurityManagement.User`). */
+function parseRegisteredEntityFullName(fullName) {
+    const trimmed = fullName.trim();
+    const dot = trimmed.indexOf('.');
+    if (dot <= 0 || dot >= trimmed.length - 1) {
+        return null;
+    }
+    return { module: trimmed.slice(0, dot), name: trimmed.slice(dot + 1) };
+}
+/**
+ * Collects `Module.Entity` keys implied by entity master router paths on menu rows
+ * (`/{app}/m/{module}/e/{entity}/...`).
+ */
+function collectEntityFullNamesFromMenuPaths(paths) {
+    const seen = new Set();
+    const re = /\/m\/([^/?#]+)\/e\/([^/?#]+)\//g;
+    for (const raw of paths) {
+        if (!raw) {
+            continue;
+        }
+        re.lastIndex = 0;
+        let m;
+        while ((m = re.exec(raw)) !== null) {
+            seen.add(`${m[1]}.${m[2]}`);
+        }
+    }
+    return seen;
+}
+//#endregion
+//#region ---- List platform navigation for AI ----
+/**
+ * Builds a flattened, searchable view of visible platform menu entries (middleware-filtered snapshot)
+ * for product “how‑to” and navigation assistants. Intended for **read-only grounding** —
+ * callers should complement with entity schema tools when field-level detail matters.
+ * **Sidebar menus are not the full entity catalog** — use optional **`includeRegisteredEntitiesNotInSidebarMenu`**
+ * or **`ListRegisteredEntities`** when assistants must not equate “in the menu” with “all registered entities”.
+ * Optional **`entityFullName`** (`Module.Entity`) adds toolbar action labels from that entity’s master interfaces.
+ */
+class AXMListPlatformNavigationForAiQuery {
+    constructor() {
+        //#region ---- Services & Dependencies ----
+        this.menuProviders = inject(AXPMenuProviderService);
+        this.translation = inject(AXTranslationService);
+        this.entityResolver = inject(AXPEntityResolver);
+    }
+    //#endregion
+    //#region ---- Query Execution ----
+    async fetch(input) {
+        try {
+            const opts = input ?? {};
+            const limit = normalizeLimit(opts.limit);
+            const search = opts.quickSearch?.trim();
+            const entityFullName = opts.entityFullName?.trim();
+            const tree = await this.menuProviders.items();
+            const flattened = this.flattenMenus(tree);
+            const linkedFromMenuPaths = collectEntityFullNamesFromMenuPaths(flattened.map((r) => r.path));
+            let rows = flattened;
+            if (search) {
+                rows = flattened.filter((r) => matchesFold(`${r.menuName ?? ''}|${r.title}|${r.titleKey}|${r.path ?? ''}|${r.hierarchyPath}`, search));
+            }
+            rows.sort((a, b) => a.hierarchyPath.localeCompare(b.hierarchyPath));
+            let matchStatus;
+            if (search && rows.length === 0) {
+                matchStatus = 'empty';
+            }
+            else if (search) {
+                matchStatus = 'filtered';
+            }
+            else {
+                matchStatus = 'catalog';
+            }
+            const truncated = rows.length > limit;
+            let entityMasterUiActions;
+            let entityMasterUiActionsMatch;
+            if (entityFullName) {
+                const parsed = parseRegisteredEntityFullName(entityFullName);
+                if (!parsed) {
+                    entityMasterUiActions = null;
+                    entityMasterUiActionsMatch = 'none';
+                }
+                else {
+                    const def = await this.entityResolver.get(parsed.module, parsed.name);
+                    if (def) {
+                        entityMasterUiActions = axmSummarizeMasterUiActionsForAi(def, (key) => this.resolveMenuTitle(key));
+                        entityMasterUiActionsMatch = 'single';
+                    }
+                    else {
+                        entityMasterUiActions = null;
+                        entityMasterUiActionsMatch = 'none';
+                    }
+                }
+            }
+            let registeredEntitiesNotInSidebarMenu;
+            if (opts.includeRegisteredEntitiesNotInSidebarMenu) {
+                const catalog = await this.entityResolver.listAll();
+                const sortedCatalog = [...catalog].sort((a, b) => {
+                    const byModule = a.module.localeCompare(b.module);
+                    return byModule !== 0 ? byModule : a.name.localeCompare(b.name);
+                });
+                registeredEntitiesNotInSidebarMenu = sortedCatalog
+                    .filter((e) => !linkedFromMenuPaths.has(e.fullName))
+                    .map((e) => e.fullName);
+            }
+            return {
+                success: true,
+                matchStatus,
+                truncated,
+                navigation: rows.slice(0, limit),
+                ...(entityFullName
+                    ? {
+                        entityMasterUiActions: entityMasterUiActions ?? null,
+                        entityMasterUiActionsMatch,
+                    }
+                    : {}),
+                ...(registeredEntitiesNotInSidebarMenu !== undefined
+                    ? { registeredEntitiesNotInSidebarMenu }
+                    : {}),
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error occurred';
+            return {
+                success: false,
+                error: message,
+            };
+        }
+    }
+    //#endregion
+    //#region ---- Private ----
+    resolveMenuTitle(text) {
+        try {
+            return this.translation.translateSync(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    flattenMenus(items) {
+        const rows = [];
+        const walk = (nodes, ancestorsResolved) => {
+            for (const item of nodes) {
+                const title = this.resolveMenuTitle(item.text);
+                const ancestors = [...ancestorsResolved, title];
+                rows.push({
+                    menuName: item.name,
+                    title,
+                    titleKey: item.text,
+                    hierarchyPath: ancestors.join(' › '),
+                    depth: ancestorsResolved.length,
+                    ...(item.path ? { path: item.path } : {}),
+                    ...(item.type ? { menuType: item.type } : {}),
+                });
+                if (item.children?.length) {
+                    walk(item.children, ancestors);
+                }
+            }
+        };
+        walk(items, []);
+        return rows;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMListPlatformNavigationForAiQuery, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMListPlatformNavigationForAiQuery, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMListPlatformNavigationForAiQuery, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+export { AXMListPlatformNavigationForAiQuery };
+//# sourceMappingURL=acorex-modules-platform-management-list-platform-navigation-for-ai.query-C3-eBMwF.mjs.map

package/fesm2022/acorex-modules-platform-management-list-platform-navigation-for-ai.query-C3-eBMwF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorex-modules-platform-management-list-platform-navigation-for-ai.query-C3-eBMwF.mjs","sources":["../../../../libs/modules/platform-management/src/lib/features/queries/list-platform-navigation-for-ai.query.ts"],"sourcesContent":["import { AXTranslationService } from '@acorex/core/translation';\nimport type { AXPMenuItem } from '@acorex/platform/common';\nimport { AXPMenuProviderService } from '@acorex/platform/common';\nimport type { AXPQuery } from '@acorex/platform/runtime';\nimport { AXPEntityResolver } from '@acorex/platform/layout/entity';\nimport { Injectable, inject } from '@angular/core';\n\nimport type { AXMEntityMasterUiActionsForAi } from './entity-master-actions-for-ai.util';\nimport { axmSummarizeMasterUiActionsForAi } from './entity-master-actions-for-ai.util';\n\n//#region ---- Types ----\n\nexport interface AXMListPlatformNavigationForAiQueryInput {\n  /**\n   * Single-line filter against resolved titles, `titleKey`, `menuName`, routing `path`,\n   * and hierarchical path text (case-insensitive substring match).\n   * When omitted, all visible menu rows after middleware are returned (truncated via `limit`).\n   */\n  quickSearch?: string;\n  /**\n   * Soft cap after filtering; enforced between 40 and 500. Omit for default **300**.\n   */\n  limit?: number;\n  /**\n   * When set to exact `ModuleName.EntityName`, the result includes **`entityMasterUiActions`**\n   * (toolbar labels from registered entity layouts) alongside navigation rows — same derivation as **`ListRegisteredEntities`**.\n   */\n  entityFullName?: string;\n  /**\n   * When true, the result includes **`registeredEntitiesNotInSidebarMenu`** — resolver catalog entries whose\n   * standard master path segment **`/m/{module}/e/{entity}/`** does not appear in any flattened menu **`path`**.\n   * Heuristic (see result field); pair with **`ListRegisteredEntities`** for the full catalog.\n   */\n  includeRegisteredEntitiesNotInSidebarMenu?: boolean;\n}\n\n/** One flattened row from the middleware-applied sidebar / shell menu tree. */\nexport interface AXMPlatformNavigationAiRow {\n  /** Stable menu item key when present (often useful for correlate with manifests). */\n  menuName?: string;\n  /** User-visible title resolved with {@link AXTranslationService.translateSync} when possible. */\n  title: string;\n  /** Original `text` from the menu definition (typically a `@scope:key` token). */\n  titleKey: string;\n  /** Breadcrumb of resolved ancestor titles separated by › (current item included last). */\n  hierarchyPath: string;\n  depth: number;\n  /** Entity / page route fragment when navigable via router. */\n  path?: string;\n  /** `menu` | `group` | `break` when present — folder vs leaf-ish chrome. */\n  menuType?: string;\n}\n\n/** `catalog`: no filter. `filtered`: `quickSearch` applied. `empty`: matched nothing. */\nexport type AXMPlatformNavigationAiMatchStatus = 'catalog' | 'filtered' | 'empty';\n\nexport interface AXMListPlatformNavigationForAiQueryResult {\n  success: boolean;\n  matchStatus?: AXMPlatformNavigationAiMatchStatus;\n  /** Flattened menu rows sorted by hierarchy path — how-to answers should cite these verbatim. */\n  navigation?: AXMPlatformNavigationAiRow[];\n  truncated?: boolean;\n  /**\n   * Present when **`entityFullName`** was supplied: master list + detail toolbar action labels from the resolver.\n   * `null` when the entity did not resolve.\n   */\n  entityMasterUiActions?: AXMEntityMasterUiActionsForAi | null;\n  entityMasterUiActionsMatch?: AXMNavigationEntityUiActionsMatch;\n  /**\n   * Present when **`includeRegisteredEntitiesNotInSidebarMenu`** was true: `Module.Entity` keys from\n   * {@link AXPEntityResolver.listAll} with no matching **`/m/{module}/e/{entity}/`** segment in any menu **`path`**.\n   * Entities reachable only via lookups, merge-detail, related lists, or **`command`** navigation (no `path`) can appear here.\n   */\n  registeredEntitiesNotInSidebarMenu?: string[];\n  error?: string;\n}\n\n/** Resolver outcome for optional {@link AXMListPlatformNavigationForAiQueryInput.entityFullName}. */\nexport type AXMNavigationEntityUiActionsMatch = 'none' | 'single';\n\n//#endregion\n\n//#region ---- Helpers ----\n\nconst DEFAULT_ROW_LIMIT = 300;\nconst MIN_ROW_LIMIT = 40;\nconst MAX_ROW_LIMIT = 500;\n\nfunction normalizeLimit(raw: unknown): number {\n  if (typeof raw === 'number' && Number.isFinite(raw)) {\n    const n = Math.floor(raw);\n    return Math.min(MAX_ROW_LIMIT, Math.max(MIN_ROW_LIMIT, n));\n  }\n  if (typeof raw === 'string') {\n    const parsed = Number.parseInt(raw.trim(), 10);\n    if (Number.isFinite(parsed)) {\n      return Math.min(MAX_ROW_LIMIT, Math.max(MIN_ROW_LIMIT, parsed));\n    }\n  }\n  return DEFAULT_ROW_LIMIT;\n}\n\nfunction matchesFold(haystack: string, needle: string): boolean {\n  return haystack.toLocaleUpperCase().includes(needle.toLocaleUpperCase());\n}\n\n/** Expects **`Module.Entity`** (`SecurityManagement.User`). */\nfunction parseRegisteredEntityFullName(fullName: string): { module: string; name: string } | null {\n  const trimmed = fullName.trim();\n  const dot = trimmed.indexOf('.');\n  if (dot <= 0 || dot >= trimmed.length - 1) {\n    return null;\n  }\n  return { module: trimmed.slice(0, dot), name: trimmed.slice(dot + 1) };\n}\n\n/**\n * Collects `Module.Entity` keys implied by entity master router paths on menu rows\n * (`/{app}/m/{module}/e/{entity}/...`).\n */\nfunction collectEntityFullNamesFromMenuPaths(paths: Iterable<string | undefined>): Set<string> {\n  const seen = new Set<string>();\n  const re = /\\/m\\/([^/?#]+)\\/e\\/([^/?#]+)\\//g;\n  for (const raw of paths) {\n    if (!raw) {\n      continue;\n    }\n    re.lastIndex = 0;\n    let m: RegExpExecArray | null;\n    while ((m = re.exec(raw)) !== null) {\n      seen.add(`${m[1]}.${m[2]}`);\n    }\n  }\n  return seen;\n}\n\n//#endregion\n\n//#region ---- List platform navigation for AI ----\n\n/**\n * Builds a flattened, searchable view of visible platform menu entries (middleware-filtered snapshot)\n * for product “how‑to” and navigation assistants. Intended for **read-only grounding** —\n * callers should complement with entity schema tools when field-level detail matters.\n * **Sidebar menus are not the full entity catalog** — use optional **`includeRegisteredEntitiesNotInSidebarMenu`**\n * or **`ListRegisteredEntities`** when assistants must not equate “in the menu” with “all registered entities”.\n * Optional **`entityFullName`** (`Module.Entity`) adds toolbar action labels from that entity’s master interfaces.\n */\n@Injectable({ providedIn: 'root' })\nexport class AXMListPlatformNavigationForAiQuery\n  implements AXPQuery<AXMListPlatformNavigationForAiQueryInput, AXMListPlatformNavigationForAiQueryResult>\n{\n  //#region ---- Services & Dependencies ----\n\n  private readonly menuProviders = inject(AXPMenuProviderService);\n  private readonly translation = inject(AXTranslationService);\n  private readonly entityResolver = inject(AXPEntityResolver);\n\n  //#endregion\n\n  //#region ---- Query Execution ----\n\n  async fetch(\n    input?: AXMListPlatformNavigationForAiQueryInput | null,\n  ): Promise<AXMListPlatformNavigationForAiQueryResult> {\n    try {\n      const opts = input ?? {};\n      const limit = normalizeLimit(opts.limit);\n      const search = opts.quickSearch?.trim();\n\n      const entityFullName = opts.entityFullName?.trim();\n\n      const tree = await this.menuProviders.items();\n      const flattened = this.flattenMenus(tree);\n      const linkedFromMenuPaths = collectEntityFullNamesFromMenuPaths(flattened.map((r) => r.path));\n\n      let rows = flattened;\n      if (search) {\n        rows = flattened.filter((r) =>\n          matchesFold(`${r.menuName ?? ''}|${r.title}|${r.titleKey}|${r.path ?? ''}|${r.hierarchyPath}`, search),\n        );\n      }\n\n      rows.sort((a, b) => a.hierarchyPath.localeCompare(b.hierarchyPath));\n\n      let matchStatus: AXMPlatformNavigationAiMatchStatus;\n      if (search && rows.length === 0) {\n        matchStatus = 'empty';\n      } else if (search) {\n        matchStatus = 'filtered';\n      } else {\n        matchStatus = 'catalog';\n      }\n\n      const truncated = rows.length > limit;\n\n      let entityMasterUiActions: AXMEntityMasterUiActionsForAi | null | undefined;\n      let entityMasterUiActionsMatch: AXMNavigationEntityUiActionsMatch | undefined;\n\n      if (entityFullName) {\n        const parsed = parseRegisteredEntityFullName(entityFullName);\n        if (!parsed) {\n          entityMasterUiActions = null;\n          entityMasterUiActionsMatch = 'none';\n        } else {\n          const def = await this.entityResolver.get(parsed.module, parsed.name);\n          if (def) {\n            entityMasterUiActions = axmSummarizeMasterUiActionsForAi(def, (key) =>\n              this.resolveMenuTitle(key),\n            );\n            entityMasterUiActionsMatch = 'single';\n          } else {\n            entityMasterUiActions = null;\n            entityMasterUiActionsMatch = 'none';\n          }\n        }\n      }\n\n      let registeredEntitiesNotInSidebarMenu: string[] | undefined;\n      if (opts.includeRegisteredEntitiesNotInSidebarMenu) {\n        const catalog = await this.entityResolver.listAll();\n        const sortedCatalog = [...catalog].sort((a, b) => {\n          const byModule = a.module.localeCompare(b.module);\n          return byModule !== 0 ? byModule : a.name.localeCompare(b.name);\n        });\n        registeredEntitiesNotInSidebarMenu = sortedCatalog\n          .filter((e) => !linkedFromMenuPaths.has(e.fullName))\n          .map((e) => e.fullName);\n      }\n\n      return {\n        success: true,\n        matchStatus,\n        truncated,\n        navigation: rows.slice(0, limit),\n        ...(entityFullName\n          ? {\n              entityMasterUiActions: entityMasterUiActions ?? null,\n              entityMasterUiActionsMatch,\n            }\n          : {}),\n        ...(registeredEntitiesNotInSidebarMenu !== undefined\n          ? { registeredEntitiesNotInSidebarMenu }\n          : {}),\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error occurred';\n\n      return {\n        success: false,\n        error: message,\n      };\n    }\n  }\n\n  //#endregion\n\n  //#region ---- Private ----\n\n  private resolveMenuTitle(text: string): string {\n    try {\n      return this.translation.translateSync(text);\n    } catch {\n      return text;\n    }\n  }\n\n  private flattenMenus(items: AXPMenuItem[]): AXMPlatformNavigationAiRow[] {\n    const rows: AXMPlatformNavigationAiRow[] = [];\n\n    const walk = (nodes: AXPMenuItem[], ancestorsResolved: string[]): void => {\n      for (const item of nodes) {\n        const title = this.resolveMenuTitle(item.text);\n        const ancestors = [...ancestorsResolved, title];\n\n        rows.push({\n          menuName: item.name,\n          title,\n          titleKey: item.text,\n          hierarchyPath: ancestors.join(' › '),\n          depth: ancestorsResolved.length,\n          ...(item.path ? { path: item.path } : {}),\n          ...(item.type ? { menuType: item.type } : {}),\n        });\n\n        if (item.children?.length) {\n          walk(item.children, ancestors);\n        }\n      }\n    };\n\n    walk(items, []);\n    return rows;\n  }\n\n  //#endregion\n}\n\n//#endregion\n"],"names":[],"mappings":"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"}

package/fesm2022/{acorex-modules-platform-management-list-registered-entities.query-B6-zV_Ml.mjs → acorex-modules-platform-management-list-registered-entities.query-BZVD9YPU.mjs}

@@ -1,6 +1,8 @@
-import { AXPEntityResolver } from '@acorex/platform/layout/entity';
+import { AXTranslationService } from '@acorex/core/translation';
+import { AXPEntityResolver, collectEntityQuickSearchFieldPaths } from '@acorex/platform/layout/entity';
 import * as i0 from '@angular/core';
 import { inject, Injectable } from '@angular/core';
+import { a as axmSummarizeMasterUiActionsForAi } from './acorex-modules-platform-management-entity-master-actions-for-ai.util-OCk5eqQz.mjs';
 
 //#endregion
 //#region ---- Property summary ----
@@ -38,12 +40,13 @@ function toRegisteredEntityPropertySummary(prop) {
 /**
  * Returns every entity known to {@link AXPEntityResolver} (all loaders), sorted by module then entity name,
  * unless {@link AXMListRegisteredEntitiesQueryInput.entityFullName} is set — then only that entity is returned,
- * with property metadata attached.
+ * with property metadata and **master UI action** summaries (list + detail toolbars).
  */
 class AXMListRegisteredEntitiesQuery {
     constructor() {
         //#region ---- Services & Dependencies ----
         this.entityResolver = inject(AXPEntityResolver);
+        this.translation = inject(AXTranslationService);
     }
     //#endregion
     //#region ---- Query Execution ----
@@ -72,7 +75,16 @@ class AXMListRegisteredEntitiesQuery {
                 if (targetFullName) {
                     const def = await this.entityResolver.get(e.module, e.name);
                     const props = def?.properties?.map(toRegisteredEntityPropertySummary) ?? [];
-                    entities.push({ ...base, properties: props });
+                    const masterUiActions = def ? axmSummarizeMasterUiActionsForAi(def, (k) => this.resolveEntityCopy(k)) : undefined;
+                    const quickSearchPaths = def
+                        ? await collectEntityQuickSearchFieldPaths(def, (m, n) => this.entityResolver.get(m, n))
+                        : undefined;
+                    entities.push({
+                        ...base,
+                        properties: props,
+                        ...(quickSearchPaths?.length ? { quickSearchPaths } : {}),
+                        ...(masterUiActions ? { masterUiActions } : {}),
+                    });
                 }
                 else {
                     entities.push(base);
@@ -104,6 +116,16 @@ class AXMListRegisteredEntitiesQuery {
             };
         }
     }
+    //#endregion
+    //#region ---- Private helpers ----
+    resolveEntityCopy(text) {
+        try {
+            return this.translation.translateSync(text);
+        }
+        catch {
+            return text;
+        }
+    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMListRegisteredEntitiesQuery, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMListRegisteredEntitiesQuery, providedIn: 'root' }); }
 }
@@ -113,4 +135,4 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
         }] });
 
 export { AXMListRegisteredEntitiesQuery };
-//# sourceMappingURL=acorex-modules-platform-management-list-registered-entities.query-B6-zV_Ml.mjs.map
+//# sourceMappingURL=acorex-modules-platform-management-list-registered-entities.query-BZVD9YPU.mjs.map

package/fesm2022/acorex-modules-platform-management-list-registered-entities.query-BZVD9YPU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorex-modules-platform-management-list-registered-entities.query-BZVD9YPU.mjs","sources":["../../../../libs/modules/platform-management/src/lib/features/queries/list-registered-entities.query.ts"],"sourcesContent":["import type { AXPEntityProperty } from '@acorex/platform/common';\nimport { AXTranslationService } from '@acorex/core/translation';\nimport { AXPEntityResolver, collectEntityQuickSearchFieldPaths } from '@acorex/platform/layout/entity';\nimport { AXPQuery } from '@acorex/platform/runtime';\nimport { Injectable, inject } from '@angular/core';\n\nimport type { AXMEntityMasterUiActionsForAi } from './entity-master-actions-for-ai.util';\nimport { axmSummarizeMasterUiActionsForAi } from './entity-master-actions-for-ai.util';\n\n//#region ---- Types ----\n\nexport interface AXMListRegisteredEntitiesQueryInput {\n  /**\n   * Optional `ModuleName.EntityName`. When set, the result list is filtered to that entity only and its row\n   * includes a full `properties` array. When omitted, the entire catalog is returned without `properties` on\n   * any row (lightweight list).\n   */\n  entityFullName?: string;\n}\n\nexport interface AXMRegisteredEntityPropertySummary {\n  name: string;\n  title: string;\n  dataType: string;\n  nullable?: boolean;\n  /** Editor/widget type when present (e.g. lookup). */\n  interfaceType?: string;\n  /** For lookup-like fields: related catalog entity as `Module.Entity`. */\n  lookupEntity?: string;\n  /**\n   * Denormalized value paths on stored rows (lodash `get` paths for filters), e.g. `brand.title` alongside `brandId`.\n   */\n  filterValuePaths?: string[];\n}\n\nexport interface AXMListRegisteredEntitiesQueryItem {\n  /** Module key as registered on entity loaders (first segment of fullName). */\n  module: string;\n  /** Entity name (second segment of fullName). */\n  name: string;\n  /** Canonical `ModuleName.EntityName` string; use this value for Entity:GetDetails `entity`. */\n  fullName: string;\n  /**\n   * Present on each row when {@link AXMListRegisteredEntitiesQueryInput.entityFullName} was provided (the single\n   * matching catalog entry). Omitted on every row when that input was not provided.\n   */\n  properties?: AXMRegisteredEntityPropertySummary[];\n  /**\n   * When {@link AXMListRegisteredEntitiesQueryInput.entityFullName} was supplied and the resolver returned a definition:\n   * master **list** and **detail (single)** toolbar actions (resolved titles — Create, Delete, View, …).\n   */\n  masterUiActions?: AXMEntityMasterUiActionsForAi;\n  /**\n   * When {@link AXMListRegisteredEntitiesQueryInput.entityFullName} was supplied and a definition was resolved:\n   * lodash-get paths included in mock storage **`quickSearch`** (text `contains`), including merge-detail related\n   * snapshots (e.g. `person.fullName`) and dotted column paths.\n   */\n  quickSearchPaths?: string[];\n}\n\n/** How the result relates to the optional entityFullName filter; omitted when success is false. */\nexport type AXMListRegisteredEntitiesMatchStatus = 'none' | 'single' | 'multiple' | 'catalog';\n\nexport interface AXMListRegisteredEntitiesQueryResult {\n  success: boolean;\n  /** Present when success is true; documents catalog vs filter match cardinality for agents. */\n  matchStatus?: AXMListRegisteredEntitiesMatchStatus;\n  entities?: AXMListRegisteredEntitiesQueryItem[];\n  error?: string;\n}\n\n//#endregion\n\n//#region ---- Property summary ----\n\nfunction toRegisteredEntityPropertySummary(prop: AXPEntityProperty): AXMRegisteredEntityPropertySummary {\n  const iface = prop.schema?.interface;\n  const rawType = iface?.type;\n  const interfaceType = typeof rawType === 'string' ? rawType : undefined;\n  const opts = iface?.options as Record<string, unknown> | undefined;\n\n  let lookupEntity: string | undefined;\n  let filterValuePaths: string[] | undefined;\n\n  if (opts && typeof opts['entity'] === 'string' && opts['entity'].trim()) {\n    lookupEntity = opts['entity'].trim();\n  }\n\n  const expose = opts?.['expose'];\n  if (Array.isArray(expose)) {\n    const paths = expose\n      .map((row) => (row && typeof row === 'object' ? (row as { target?: unknown }).target : undefined))\n      .filter((t): t is string => typeof t === 'string' && t.length > 0);\n    if (paths.length) {\n      filterValuePaths = paths;\n    }\n  }\n\n  return {\n    name: prop.name,\n    title: prop.title,\n    dataType: prop.schema?.dataType ?? 'unknown',\n    nullable: prop.schema?.nullable,\n    ...(interfaceType ? { interfaceType } : {}),\n    ...(lookupEntity ? { lookupEntity } : {}),\n    ...(filterValuePaths ? { filterValuePaths } : {}),\n  };\n}\n\n//#endregion\n\n//#region ---- List Registered Entities Query ----\n\n/**\n * Returns every entity known to {@link AXPEntityResolver} (all loaders), sorted by module then entity name,\n * unless {@link AXMListRegisteredEntitiesQueryInput.entityFullName} is set — then only that entity is returned,\n * with property metadata and **master UI action** summaries (list + detail toolbars).\n */\n@Injectable({ providedIn: 'root' })\nexport class AXMListRegisteredEntitiesQuery\n  implements AXPQuery<AXMListRegisteredEntitiesQueryInput, AXMListRegisteredEntitiesQueryResult>\n{\n  //#region ---- Services & Dependencies ----\n\n  private readonly entityResolver = inject(AXPEntityResolver);\n  private readonly translation = inject(AXTranslationService);\n\n  //#endregion\n\n  //#region ---- Query Execution ----\n\n  async fetch(input?: AXMListRegisteredEntitiesQueryInput | null): Promise<AXMListRegisteredEntitiesQueryResult> {\n    try {\n      const opts = input ?? {};\n      const entries = await this.entityResolver.listAll();\n      const targetFullName = opts.entityFullName?.trim();\n\n      const sorted = [...entries].sort((a, b) => {\n        const byModule = a.module.localeCompare(b.module);\n        if (byModule !== 0) {\n          return byModule;\n        }\n        return a.name.localeCompare(b.name);\n      });\n\n      const entities: AXMListRegisteredEntitiesQueryItem[] = [];\n\n      for (const e of sorted) {\n        if (targetFullName && e.fullName !== targetFullName) {\n          continue;\n        }\n\n        const base: AXMListRegisteredEntitiesQueryItem = {\n          module: e.module,\n          name: e.name,\n          fullName: e.fullName,\n        };\n\n        if (targetFullName) {\n          const def = await this.entityResolver.get(e.module, e.name);\n          const props = def?.properties?.map(toRegisteredEntityPropertySummary) ?? [];\n          const masterUiActions = def ? axmSummarizeMasterUiActionsForAi(def, (k) => this.resolveEntityCopy(k)) : undefined;\n          const quickSearchPaths = def\n            ? await collectEntityQuickSearchFieldPaths(def, (m, n) => this.entityResolver.get(m, n))\n            : undefined;\n          entities.push({\n            ...base,\n            properties: props,\n            ...(quickSearchPaths?.length ? { quickSearchPaths } : {}),\n            ...(masterUiActions ? { masterUiActions } : {}),\n          });\n        } else {\n          entities.push(base);\n        }\n      }\n\n      let matchStatus: AXMListRegisteredEntitiesMatchStatus;\n      if (!targetFullName) {\n        matchStatus = 'catalog';\n      } else if (entities.length === 0) {\n        matchStatus = 'none';\n      } else if (entities.length === 1) {\n        matchStatus = 'single';\n      } else {\n        matchStatus = 'multiple';\n      }\n\n      return {\n        success: true,\n        matchStatus,\n        entities,\n      };\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error occurred',\n      };\n    }\n  }\n\n  //#endregion\n\n  //#region ---- Private helpers ----\n\n  private resolveEntityCopy(text: string): string {\n    try {\n      return this.translation.translateSync(text);\n    } catch {\n      return text;\n    }\n  }\n\n  //#endregion\n}\n\n//#endregion\n"],"names":[],"mappings":";;;;;;AAuEA;AAEA;AAEA,SAAS,iCAAiC,CAAC,IAAuB,EAAA;AAChE,IAAA,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS;AACpC,IAAA,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI;AAC3B,IAAA,MAAM,aAAa,GAAG,OAAO,OAAO,KAAK,QAAQ,GAAG,OAAO,GAAG,SAAS;AACvE,IAAA,MAAM,IAAI,GAAG,KAAK,EAAE,OAA8C;AAElE,IAAA,IAAI,YAAgC;AACpC,IAAA,IAAI,gBAAsC;AAE1C,IAAA,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;QACvE,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;IACtC;AAEA,IAAA,MAAM,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC;AAC/B,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;QACzB,MAAM,KAAK,GAAG;aACX,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,GAAI,GAA4B,CAAC,MAAM,GAAG,SAAS,CAAC;AAChG,aAAA,MAAM,CAAC,CAAC,CAAC,KAAkB,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACpE,QAAA,IAAI,KAAK,CAAC,MAAM,EAAE;YAChB,gBAAgB,GAAG,KAAK;QAC1B;IACF;IAEA,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;AACjB,QAAA,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,SAAS;AAC5C,QAAA,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ;AAC/B,QAAA,IAAI,aAAa,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;AAC3C,QAAA,IAAI,YAAY,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;AACzC,QAAA,IAAI,gBAAgB,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC;KAClD;AACH;AAEA;AAEA;AAEA;;;;AAIG;MAEU,8BAA8B,CAAA;AAD3C,IAAA,WAAA,GAAA;;AAMmB,QAAA,IAAA,CAAA,cAAc,GAAG,MAAM,CAAC,iBAAiB,CAAC;AAC1C,QAAA,IAAA,CAAA,WAAW,GAAG,MAAM,CAAC,oBAAoB,CAAC;AAwF5D,IAAA;;;IAlFC,MAAM,KAAK,CAAC,KAAkD,EAAA;AAC5D,QAAA,IAAI;AACF,YAAA,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACxB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YACnD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE;AAElD,YAAA,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAI;AACxC,gBAAA,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC;AACjD,gBAAA,IAAI,QAAQ,KAAK,CAAC,EAAE;AAClB,oBAAA,OAAO,QAAQ;gBACjB;gBACA,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;AACrC,YAAA,CAAC,CAAC;YAEF,MAAM,QAAQ,GAAyC,EAAE;AAEzD,YAAA,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE;gBACtB,IAAI,cAAc,IAAI,CAAC,CAAC,QAAQ,KAAK,cAAc,EAAE;oBACnD;gBACF;AAEA,gBAAA,MAAM,IAAI,GAAuC;oBAC/C,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;iBACrB;gBAED,IAAI,cAAc,EAAE;AAClB,oBAAA,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;AAC3D,oBAAA,MAAM,KAAK,GAAG,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,iCAAiC,CAAC,IAAI,EAAE;oBAC3E,MAAM,eAAe,GAAG,GAAG,GAAG,gCAAgC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;oBACjH,MAAM,gBAAgB,GAAG;0BACrB,MAAM,kCAAkC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;0BACrF,SAAS;oBACb,QAAQ,CAAC,IAAI,CAAC;AACZ,wBAAA,GAAG,IAAI;AACP,wBAAA,UAAU,EAAE,KAAK;AACjB,wBAAA,IAAI,gBAAgB,EAAE,MAAM,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC;AACzD,wBAAA,IAAI,eAAe,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC;AAChD,qBAAA,CAAC;gBACJ;qBAAO;AACL,oBAAA,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrB;YACF;AAEA,YAAA,IAAI,WAAiD;YACrD,IAAI,CAAC,cAAc,EAAE;gBACnB,WAAW,GAAG,SAAS;YACzB;AAAO,iBAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;gBAChC,WAAW,GAAG,MAAM;YACtB;AAAO,iBAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;gBAChC,WAAW,GAAG,QAAQ;YACxB;iBAAO;gBACL,WAAW,GAAG,UAAU;YAC1B;YAEA,OAAO;AACL,gBAAA,OAAO,EAAE,IAAI;gBACb,WAAW;gBACX,QAAQ;aACT;QACH;QAAE,OAAO,KAAK,EAAE;YACd,OAAO;AACL,gBAAA,OAAO,EAAE,KAAK;AACd,gBAAA,KAAK,EAAE,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,wBAAwB;aACzE;QACH;IACF;;;AAMQ,IAAA,iBAAiB,CAAC,IAAY,EAAA;AACpC,QAAA,IAAI;YACF,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC;QAC7C;AAAE,QAAA,MAAM;AACN,YAAA,OAAO,IAAI;QACb;IACF;8GA3FW,8BAA8B,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAA9B,IAAA,SAAA,IAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,8BAA8B,cADjB,MAAM,EAAA,CAAA,CAAA;;2FACnB,8BAA8B,EAAA,UAAA,EAAA,CAAA;kBAD1C,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE;;;;;"}

package/fesm2022/{acorex-modules-platform-management-menu-list.component-ClShYP8I.mjs → acorex-modules-platform-management-menu-list.component-BE9_j1Xy.mjs}

@@ -22,7 +22,7 @@ import * as i0 from '@angular/core';
 import { inject, viewChild, signal, ViewEncapsulation, ChangeDetectionStrategy, Component } from '@angular/core';
 import { ActivatedRoute } from '@angular/router';
 import { Subject, takeUntil } from 'rxjs';
-import { A as AXPMenuManagementService } from './acorex-modules-platform-management-acorex-modules-platform-management-DCR1ziGj.mjs';
+import { A as AXPMenuManagementService } from './acorex-modules-platform-management-acorex-modules-platform-management-D0D56pWx.mjs';
 
 //#region ----   Menu List Component   ----
 class AXMMenuListComponent extends AXPPageLayoutBaseComponent {
@@ -516,4 +516,4 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
         }], propDecorators: { tree: [{ type: i0.ViewChild, args: [i0.forwardRef(() => AXTreeViewComponent), { isSignal: true }] }] } });
 
 export { AXMMenuListComponent };
-//# sourceMappingURL=acorex-modules-platform-management-menu-list.component-ClShYP8I.mjs.map
+//# sourceMappingURL=acorex-modules-platform-management-menu-list.component-BE9_j1Xy.mjs.map