@acorex/platform 20.8.4 → 21.0.0-beta.0

package/fesm2022/acorex-platform-runtime.mjs

@@ -1,8 +1,157 @@
 import * as i0 from '@angular/core';
-import { Injectable, InjectionToken, inject, EnvironmentInjector, runInInjectionContext, makeEnvironmentProviders, input, ElementRef, effect, Directive, isDevMode, NgModule } from '@angular/core';
+import { inject, Injectable, InjectionToken, EnvironmentInjector, runInInjectionContext, makeEnvironmentProviders, input, ElementRef, effect, Directive, isDevMode, NgModule } from '@angular/core';
 import { AXPBroadcastEventService, AXPDistributedEventListenerService } from '@acorex/platform/core';
 import { castArray } from 'lodash-es';
 
+//#region ---- defineCommand ----
+/**
+ * Typed identity helper for command metadata sidecars.
+ */
+function defineCommand(definition) {
+    return definition;
+}
+//#endregion
+
+//#region ---- Shared catalog categories (queries & commands) ----
+const AXP_CATALOG_DEFINITION_CATEGORY_PLATFORM = {
+    name: 'platform',
+    order: 1,
+    title: 'Platform',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_ENTITY = {
+    name: 'entity',
+    order: 2,
+    title: 'Entity',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_STORAGE = {
+    name: 'storage',
+    order: 3,
+    title: 'Storage',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_WIDGETS = {
+    name: 'widgets',
+    order: 4,
+    title: 'Widgets',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_WORKFLOW = {
+    name: 'workflow',
+    order: 5,
+    title: 'Workflow',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_UTILITY = {
+    name: 'utility',
+    order: 6,
+    title: 'Utility',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_SETTINGS = {
+    name: 'settings',
+    order: 7,
+    title: 'Settings',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_AI_TOOLS = {
+    name: 'ai-tools',
+    order: 8,
+    title: 'AI tools',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_SECURITY = {
+    name: 'security',
+    order: 9,
+    title: 'Security',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_DATA_MANAGEMENT = {
+    name: 'data-management',
+    order: 10,
+    title: 'Data management',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_ASSESSMENT = {
+    name: 'assessment',
+    order: 11,
+    title: 'Assessment',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_REPORT = {
+    name: 'report',
+    order: 12,
+    title: 'Report',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_ORGANIZATION = {
+    name: 'organization',
+    order: 13,
+    title: 'Organization',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_TENANT = {
+    name: 'tenant',
+    order: 14,
+    title: 'Tenant',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_HUMAN_CAPITAL = {
+    name: 'human-capital',
+    order: 15,
+    title: 'Human capital',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_PRODUCT = {
+    name: 'product',
+    order: 16,
+    title: 'Product',
+};
+const AXP_CATALOG_DEFINITION_CATEGORY_FILE_WIDGET = {
+    name: 'file-widget',
+    order: 17,
+    title: 'File widget',
+};
+//#endregion
+
+/**
+ * Shared build-time catalog metadata for command, query, and widget definition sidecars
+ * (`defineCommand`, `defineQuery`, `defineWidget`).
+ * Lives under `shared/` so consumers import one module without a "command" prefix on generic shapes.
+ */
+//#endregion
+
+/**
+ * Build-time command metadata for AXPCommand implementations.
+ * `inputs` / `outputs` are schema rows (same family as entity optionDefinitions).
+ * Validation entries: only `rule` name and optional `options` (no title/message on rules).
+ * Do not import from Angular templates; sidecars may import `defineCommand` from `@acorex/platform/runtime`.
+ *
+ * Query metadata (fetch-only, no outcomes) is defined in `../queries/query-definition.types.ts` with `defineQuery`.
+ * Widget metadata sidecars use `../widgets/widget-definition.types.ts` with `defineWidget`.
+ */
+//#endregion
+
+/**
+ * Build-time command metadata only. Safe under Node (e.g. generate-runtime-catalog) without loading the command executor stack.
+ * Sidecars should import `defineCommand` from `@acorex/platform/runtime` (or this module for deep imports).
+ */
+
+//#region ----   Imports   ----
+//#endregion
+const COMMAND_EXECUTION_EVENT_KEY = '@commands:execution';
+class AXPCommandEventsService {
+    constructor() {
+        //#region ----   Services & Dependencies   ----
+        this.broadcast = inject(AXPBroadcastEventService);
+        this.distributedEvents = inject(AXPDistributedEventListenerService, { optional: true });
+    }
+    //#endregion
+    //#region ----   Public API   ----
+    listen(handler) {
+        const subscription = this.broadcast
+            .listen(COMMAND_EXECUTION_EVENT_KEY)
+            .subscribe(({ data }) => handler(data));
+        return () => subscription.unsubscribe();
+    }
+    async emit(event) {
+        this.broadcast.publish(COMMAND_EXECUTION_EVENT_KEY, event);
+        await this.distributedEvents?.dispatch(COMMAND_EXECUTION_EVENT_KEY, event);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandEventsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandEventsService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandEventsService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
 //#endregion
 //#region ----   Middleware Composition   ----
 /**
@@ -51,10 +200,10 @@ class AXPCommandRegistry {
         this.registry.clear();
         this.middlewares.length = 0;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandRegistry, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandRegistry, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandRegistry, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandRegistry, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -62,35 +211,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImpo
 // plugins/command.extension.token.ts
 const AXP_COMMAND_EXTENSION = new InjectionToken('AXP_COMMAND_EXTENSION');
 
-//#region ----   Imports   ----
-//#endregion
-const COMMAND_EXECUTION_EVENT_KEY = '@commands:execution';
-class AXPCommandEventsService {
-    constructor() {
-        //#region ----   Services & Dependencies   ----
-        this.broadcast = inject(AXPBroadcastEventService);
-        this.distributedEvents = inject(AXPDistributedEventListenerService, { optional: true });
-    }
-    //#endregion
-    //#region ----   Public API   ----
-    listen(handler) {
-        const subscription = this.broadcast
-            .listen(COMMAND_EXECUTION_EVENT_KEY)
-            .subscribe(({ data }) => handler(data));
-        return () => subscription.unsubscribe();
-    }
-    async emit(event) {
-        this.broadcast.publish(COMMAND_EXECUTION_EVENT_KEY, event);
-        await this.distributedEvents?.dispatch(COMMAND_EXECUTION_EVENT_KEY, event);
-    }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandEventsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandEventsService, providedIn: 'root' }); }
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandEventsService, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }] });
-
 class AXPCommandExecutor {
     constructor() {
         this.injector = inject(EnvironmentInjector);
@@ -149,10 +269,10 @@ class AXPCommandExecutor {
             ?.filter(ext => ext.target instanceof RegExp ? ext.target.test(key) : ext.target === key)
             .map(ext => ext.middleware) ?? [];
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandExecutor, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandExecutor, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandExecutor, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandExecutor, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -185,14 +305,47 @@ class AXPCommandService {
     async execute(key, input) {
         return this.executor.execute(key, input);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPCommandService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
 
+const AXP_COMMAND_MIDDLEWARE_SETUP = new InjectionToken('AXP_COMMAND_MIDDLEWARE_SETUP');
+function provideCommandMiddleware(entries) {
+    const global = [];
+    const extensions = [];
+    for (const entry of entries) {
+        if (typeof entry === 'function') {
+            global.push(entry);
+        }
+        else {
+            extensions.push(entry);
+        }
+    }
+    return makeEnvironmentProviders([
+        // Plugin middleware entries
+        ...extensions.map(ext => ({
+            provide: AXP_COMMAND_EXTENSION,
+            useValue: ext,
+            multi: true
+        })),
+        // Global middleware setup (triggered via this token)
+        {
+            provide: AXP_COMMAND_MIDDLEWARE_SETUP,
+            useFactory: () => {
+                const registry = inject(AXPCommandRegistry);
+                for (const mw of global) {
+                    registry.use(mw);
+                }
+                return true;
+            }
+        }
+    ]);
+}
+
 const AXP_COMMAND_SETUP = new InjectionToken('AXP_COMMAND_SETUP');
 function provideCommandSetups(entries) {
     return makeEnvironmentProviders([
@@ -229,50 +382,19 @@ function provideCommand(key, loader) {
     ]);
 }
 
-const AXP_COMMAND_MIDDLEWARE_SETUP = new InjectionToken('AXP_COMMAND_MIDDLEWARE_SETUP');
-function provideCommandMiddleware(entries) {
-    const global = [];
-    const extensions = [];
-    for (const entry of entries) {
-        if (typeof entry === 'function') {
-            global.push(entry);
-        }
-        else {
-            extensions.push(entry);
-        }
-    }
-    return makeEnvironmentProviders([
-        // Plugin middleware entries
-        ...extensions.map(ext => ({
-            provide: AXP_COMMAND_EXTENSION,
-            useValue: ext,
-            multi: true
-        })),
-        // Global middleware setup (triggered via this token)
-        {
-            provide: AXP_COMMAND_MIDDLEWARE_SETUP,
-            useFactory: () => {
-                const registry = inject(AXPCommandRegistry);
-                for (const mw of global) {
-                    registry.use(mw);
-                }
-                return true;
-            }
-        }
-    ]);
+//#region ---- defineQuery ----
+/**
+ * Typed identity helper for query metadata sidecars.
+ */
+function defineQuery(definition) {
+    return definition;
 }
+//#endregion
 
-function composeQueryMiddlewares(middlewares) {
-    return (handler) => {
-        let composed = handler;
-        for (let i = middlewares.length - 1; i >= 0; i--) {
-            const mw = middlewares[i];
-            const next = composed;
-            composed = (input) => mw(input, next);
-        }
-        return composed;
-    };
-}
+/**
+ * Build-time query metadata only. Safe under Node (e.g. generate-runtime-catalog) without loading the query executor stack.
+ * Sidecars should import `defineQuery` from `@acorex/platform/runtime` (or this module for deep imports).
+ */
 
 // queries/query.registry.ts
 class AXPQueryRegistry {
@@ -305,10 +427,10 @@ class AXPQueryRegistry {
         this.registry.clear();
         this.middlewares.length = 0;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPQueryRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPQueryRegistry, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryRegistry, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPQueryRegistry, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryRegistry, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -316,6 +438,79 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImpo
 // plugins/query.extension.token.ts
 const AXP_QUERY_EXTENSION = new InjectionToken('AXP_QUERY_EXTENSION');
 
+const AXP_QUERY_MIDDLEWARE_SETUP = new InjectionToken('AXP_QUERY_MIDDLEWARE_SETUP');
+function provideQueryMiddleware(entries) {
+    const global = [];
+    const extensions = [];
+    for (const entry of entries) {
+        if (typeof entry === 'function') {
+            global.push(entry);
+        }
+        else {
+            extensions.push(entry);
+        }
+    }
+    return makeEnvironmentProviders([
+        // Plugin middleware entries
+        ...extensions.map(ext => ({
+            provide: AXP_QUERY_EXTENSION,
+            useValue: ext,
+            multi: true
+        })),
+        // Global middleware setup (triggered via this token)
+        {
+            provide: AXP_QUERY_MIDDLEWARE_SETUP,
+            useFactory: () => {
+                const registry = inject(AXPQueryRegistry);
+                for (const mw of global) {
+                    registry.use(mw);
+                }
+                return true;
+            }
+        }
+    ]);
+}
+
+const AXP_QUERY_SETUP = new InjectionToken('AXP_QUERY_SETUP');
+function provideQuerySetups(entries) {
+    return makeEnvironmentProviders([
+        {
+            provide: AXP_QUERY_SETUP,
+            useFactory: () => {
+                const registry = inject(AXPQueryRegistry);
+                const injector = inject(EnvironmentInjector);
+                for (const entry of entries) {
+                    registry.register(entry.key, async () => {
+                        const CommandType = await entry.loader();
+                        return injector.get(CommandType);
+                    });
+                }
+                return true;
+            },
+            multi: true
+        }
+    ]);
+}
+
+/**
+ * Build-time query metadata for AXPQuery implementations.
+ * Mirrors command metadata shape except there are no `outcomes` (queries only `fetch`).
+ * Shares {@link AXPCatalogMetadataDefinitionBase} with commands and widgets; `inputs` / `outputs` live on the base.
+ */
+//#endregion
+
+function composeQueryMiddlewares(middlewares) {
+    return (handler) => {
+        let composed = handler;
+        for (let i = middlewares.length - 1; i >= 0; i--) {
+            const mw = middlewares[i];
+            const next = composed;
+            composed = (input) => mw(input, next);
+        }
+        return composed;
+    };
+}
+
 class AXPQueryExecutor {
     constructor() {
         this.injector = inject(EnvironmentInjector);
@@ -342,10 +537,10 @@ class AXPQueryExecutor {
             ?.filter(ext => ext.target instanceof RegExp ? ext.target.test(key) : ext.target === key)
             .map(ext => ext.middleware) ?? [];
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPQueryExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPQueryExecutor, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryExecutor, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPQueryExecutor, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryExecutor, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -378,67 +573,34 @@ class AXPQueryService {
     async fetch(key, input) {
         return this.executor.fetch(key, input);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPQueryService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPQueryService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPQueryService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
 
-const AXP_QUERY_SETUP = new InjectionToken('AXP_QUERY_SETUP');
-function provideQuerySetups(entries) {
-    return makeEnvironmentProviders([
-        {
-            provide: AXP_QUERY_SETUP,
-            useFactory: () => {
-                const registry = inject(AXPQueryRegistry);
-                const injector = inject(EnvironmentInjector);
-                for (const entry of entries) {
-                    registry.register(entry.key, async () => {
-                        const CommandType = await entry.loader();
-                        return injector.get(CommandType);
-                    });
-                }
-                return true;
-            },
-            multi: true
-        }
-    ]);
+//#region ---- defineWidget ----
+/**
+ * Typed identity helper for widget metadata sidecars.
+ */
+function defineWidget(definition) {
+    return definition;
 }
+//#endregion
 
-const AXP_QUERY_MIDDLEWARE_SETUP = new InjectionToken('AXP_QUERY_MIDDLEWARE_SETUP');
-function provideQueryMiddleware(entries) {
-    const global = [];
-    const extensions = [];
-    for (const entry of entries) {
-        if (typeof entry === 'function') {
-            global.push(entry);
-        }
-        else {
-            extensions.push(entry);
-        }
-    }
-    return makeEnvironmentProviders([
-        // Plugin middleware entries
-        ...extensions.map(ext => ({
-            provide: AXP_QUERY_EXTENSION,
-            useValue: ext,
-            multi: true
-        })),
-        // Global middleware setup (triggered via this token)
-        {
-            provide: AXP_QUERY_MIDDLEWARE_SETUP,
-            useFactory: () => {
-                const registry = inject(AXPQueryRegistry);
-                for (const mw of global) {
-                    registry.use(mw);
-                }
-                return true;
-            }
-        }
-    ]);
-}
+/**
+ * Build-time widget metadata only. Safe for tooling without loading layout widget components.
+ * Sidecars should import `defineWidget` from `@acorex/platform/runtime` (or this module for deep imports).
+ */
+
+/**
+ * Build-time widget metadata sidecars (parallel to {@link AXPWidgetConfig} in layout/widget-core).
+ * Extends {@link AXPCatalogMetadataDefinitionBase}; `inputs` / `outputs` use the same schema rows as commands/queries.
+ * Sidecars may import `defineWidget` from `@acorex/platform/runtime`.
+ */
+//#endregion
 
 function composeViewMiddlewares(middlewares) {
     return (handler) => {
@@ -482,10 +644,10 @@ class AXPViewRegistry {
         this.registry.clear();
         this.middlewares.length = 0;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPViewRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPViewRegistry, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewRegistry, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPViewRegistry, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewRegistry, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -518,10 +680,10 @@ class AXPViewExecutor {
             ?.filter(ext => ext.target instanceof RegExp ? ext.target.test(key) : ext.target === key)
             .map(ext => ext.middleware) ?? [];
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPViewExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPViewExecutor, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewExecutor, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPViewExecutor, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewExecutor, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -555,10 +717,10 @@ class AXPViewService {
     async provide(key, input) {
         return this.executor.provide(key, input);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPViewService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPViewService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPViewService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -674,10 +836,10 @@ class AXPPolicyEngineRegistry {
         await composed(context);
         return context;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPPolicyEngineRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPPolicyEngineRegistry, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineRegistry, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPPolicyEngineRegistry, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineRegistry, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -726,10 +888,10 @@ class AXPPolicyEngineService {
         //     }
         // }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPPolicyEngineService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPPolicyEngineService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPPolicyEngineService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root'
@@ -738,7 +900,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImpo
 
 class AXPPolicyEngineDirective {
     constructor() {
-        this.policy = input.required(...(ngDevMode ? [{ debugName: "policy", alias: 'axp-apply-policy' }] : [{ alias: 'axp-apply-policy' }]));
+        this.policy = input.required({ ...(ngDevMode ? { debugName: "policy" } : /* istanbul ignore next */ {}), alias: 'axp-apply-policy' });
         this.service = inject(AXPPolicyEngineService);
         this.elementRef = inject((ElementRef));
         this.#eff = effect(async () => {
@@ -751,13 +913,13 @@ class AXPPolicyEngineDirective {
                 policies: castArray(policy),
                 sender: this.elementRef.nativeElement
             });
-        }, ...(ngDevMode ? [{ debugName: "#eff" }] : []));
+        }, ...(ngDevMode ? [{ debugName: "#eff" }] : /* istanbul ignore next */ []));
     }
     #eff;
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPPolicyEngineDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
-    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "20.3.19", type: AXPPolicyEngineDirective, isStandalone: true, selector: "[axp-apply-policy]", inputs: { policy: { classPropertyName: "policy", publicName: "axp-apply-policy", isSignal: true, isRequired: true, transformFunction: null } }, ngImport: i0 }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.9", type: AXPPolicyEngineDirective, isStandalone: true, selector: "[axp-apply-policy]", inputs: { policy: { classPropertyName: "policy", publicName: "axp-apply-policy", isSignal: true, isRequired: true, transformFunction: null } }, ngImport: i0 }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPPolicyEngineDirective, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineDirective, decorators: [{
             type: Directive,
             args: [{
                     selector: '[axp-apply-policy]',
@@ -830,11 +992,11 @@ class AXPRuntimeModule {
             console.log('[AXPRuntimeModule] Policy Engine Setup:', this._policyEngineSetup);
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPRuntimeModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
-    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.3.19", ngImport: i0, type: AXPRuntimeModule }); }
-    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPRuntimeModule }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRuntimeModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.9", ngImport: i0, type: AXPRuntimeModule }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRuntimeModule }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImport: i0, type: AXPRuntimeModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRuntimeModule, decorators: [{
             type: NgModule
         }], ctorParameters: () => [] });
 
@@ -844,5 +1006,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.19", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { AXPCommandEventsService, AXPCommandExecutor, AXPCommandRegistry, AXPCommandService, AXPPolicyEngineContext, AXPPolicyEngineDirective, AXPPolicyEngineRegistry, AXPPolicyEngineService, AXPQueryExecutor, AXPQueryRegistry, AXPQueryService, AXPRuntimeModule, AXPViewExecutor, AXPViewRegistry, AXPViewService, AXP_COMMAND_EXTENSION, AXP_COMMAND_MIDDLEWARE_SETUP, AXP_COMMAND_SETUP, AXP_POLICY_ENGINE_MIDDLEWARE_SETUP, AXP_POLICY_EXTENSION, AXP_QUERY_EXTENSION, AXP_QUERY_MIDDLEWARE_SETUP, AXP_QUERY_SETUP, AXP_VIEW_EXTENSION, AXP_VIEW_SETUP, composeCommandMiddlewares, composePolicyEngineMiddlewares, composeQueryMiddlewares, composeViewMiddlewares, provideCommand, provideCommandMiddleware, provideCommandSetups, providePolicySetups, provideQueryMiddleware, provideQuerySetups, provideViewSetup, provideViewSetups };
+export { AXPCommandEventsService, AXPCommandExecutor, AXPCommandRegistry, AXPCommandService, AXPPolicyEngineContext, AXPPolicyEngineDirective, AXPPolicyEngineRegistry, AXPPolicyEngineService, AXPQueryExecutor, AXPQueryRegistry, AXPQueryService, AXPRuntimeModule, AXPViewExecutor, AXPViewRegistry, AXPViewService, AXP_CATALOG_DEFINITION_CATEGORY_AI_TOOLS as AXP_COMMAND_DEFINITION_CATEGORY_AI_TOOLS, AXP_CATALOG_DEFINITION_CATEGORY_ASSESSMENT as AXP_COMMAND_DEFINITION_CATEGORY_ASSESSMENT, AXP_CATALOG_DEFINITION_CATEGORY_DATA_MANAGEMENT as AXP_COMMAND_DEFINITION_CATEGORY_DATA_MANAGEMENT, AXP_CATALOG_DEFINITION_CATEGORY_ENTITY as AXP_COMMAND_DEFINITION_CATEGORY_ENTITY, AXP_CATALOG_DEFINITION_CATEGORY_FILE_WIDGET as AXP_COMMAND_DEFINITION_CATEGORY_FILE_WIDGET, AXP_CATALOG_DEFINITION_CATEGORY_HUMAN_CAPITAL as AXP_COMMAND_DEFINITION_CATEGORY_HUMAN_CAPITAL, AXP_CATALOG_DEFINITION_CATEGORY_ORGANIZATION as AXP_COMMAND_DEFINITION_CATEGORY_ORGANIZATION, AXP_CATALOG_DEFINITION_CATEGORY_PLATFORM as AXP_COMMAND_DEFINITION_CATEGORY_PLATFORM, AXP_CATALOG_DEFINITION_CATEGORY_PRODUCT as AXP_COMMAND_DEFINITION_CATEGORY_PRODUCT, AXP_CATALOG_DEFINITION_CATEGORY_REPORT as AXP_COMMAND_DEFINITION_CATEGORY_REPORT, AXP_CATALOG_DEFINITION_CATEGORY_SECURITY as AXP_COMMAND_DEFINITION_CATEGORY_SECURITY, AXP_CATALOG_DEFINITION_CATEGORY_SETTINGS as AXP_COMMAND_DEFINITION_CATEGORY_SETTINGS, AXP_CATALOG_DEFINITION_CATEGORY_STORAGE as AXP_COMMAND_DEFINITION_CATEGORY_STORAGE, AXP_CATALOG_DEFINITION_CATEGORY_TENANT as AXP_COMMAND_DEFINITION_CATEGORY_TENANT, AXP_CATALOG_DEFINITION_CATEGORY_UTILITY as AXP_COMMAND_DEFINITION_CATEGORY_UTILITY, AXP_CATALOG_DEFINITION_CATEGORY_WORKFLOW as AXP_COMMAND_DEFINITION_CATEGORY_WORKFLOW, AXP_COMMAND_EXTENSION, AXP_COMMAND_MIDDLEWARE_SETUP, AXP_COMMAND_SETUP, AXP_POLICY_ENGINE_MIDDLEWARE_SETUP, AXP_POLICY_EXTENSION, AXP_CATALOG_DEFINITION_CATEGORY_ENTITY as AXP_QUERY_DEFINITION_CATEGORY_ENTITY, AXP_CATALOG_DEFINITION_CATEGORY_PLATFORM as AXP_QUERY_DEFINITION_CATEGORY_PLATFORM, AXP_CATALOG_DEFINITION_CATEGORY_STORAGE as AXP_QUERY_DEFINITION_CATEGORY_STORAGE, AXP_CATALOG_DEFINITION_CATEGORY_WIDGETS as AXP_QUERY_DEFINITION_CATEGORY_WIDGETS, AXP_QUERY_EXTENSION, AXP_QUERY_MIDDLEWARE_SETUP, AXP_QUERY_SETUP, AXP_VIEW_EXTENSION, AXP_VIEW_SETUP, composeCommandMiddlewares, composePolicyEngineMiddlewares, composeQueryMiddlewares, composeViewMiddlewares, defineCommand, defineQuery, defineWidget, provideCommand, provideCommandMiddleware, provideCommandSetups, providePolicySetups, provideQueryMiddleware, provideQuerySetups, provideViewSetup, provideViewSetups };
 //# sourceMappingURL=acorex-platform-runtime.mjs.map