@acorex/platform 21.0.0-next.24 → 21.0.0-next.33

package/{layout/views/index.d.ts → types/acorex-platform-layout-views.d.ts}

@@ -6,7 +6,7 @@ import { AXClickEvent } from '@acorex/cdk/common';
 import * as i1 from '@acorex/cdk/drawer';
 import { AXDrawerItemDirective } from '@acorex/cdk/drawer';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPActionMenuItem, AXPBreadcrumbItem, AXPBadge, AXPPageStatus, AXPBackButton, AXPExecuteCommand, AXPDeviceService, AXPExecuteCommandResult, AXPExpressionEvaluatorScope, AXPBroadcastEventService } from '@acorex/platform/core';
+import { AXPActionMenuItem, AXPBreadcrumbItem, AXPBadge, AXPPageStatus, AXPBackButton, AXPExecuteCommand, AXPDeviceService, AXPExecuteCommandResult, AXPExpressionEvaluatorScope, AXPBroadcastEventService, AXPContextChangeEvent } from '@acorex/platform/core';
 import { AXPCommandService, AXPPolicyEngineService } from '@acorex/platform/runtime';
 import { AXPWorkflowService } from '@acorex/platform/workflow';
 import { AXToastService } from '@acorex/components/toast';
@@ -16,7 +16,7 @@ import { AXPSessionService } from '@acorex/platform/auth';
 import { AXPHomePageService } from '@acorex/platform/common';
 import { AXBasePageComponent } from '@acorex/components/page';
 import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
-import { AXPWidgetNode, AXPPageStatus as AXPPageStatus$1, AXPWidgetContainerComponent, AXPWidgetCoreContextChangeEvent } from '@acorex/platform/layout/widget-core';
+import { AXPWidgetNode, AXPPageStatus as AXPPageStatus$1, AXPWidgetContainerComponent } from '@acorex/platform/layout/widget-core';
 import * as _acorex_platform_layout_views from '@acorex/platform/layout/views';
 import { AXFormComponent } from '@acorex/components/form';
 import { Router, ActivatedRoute } from '@angular/router';
@@ -398,19 +398,28 @@ interface AXPLayoutDetailsViewPage {
      */
     content?: AXPPageContentItem[];
     tabs?: AXPLayoutDetailsViewTabItem[];
+    /**
+     * Static actions array (legacy, use getActions for reactive actions)
+     */
     actions?: AXPLayoutDetailsViewAction[];
+    /**
+     * Function to get actions dynamically (supports reactive updates from component instances)
+     */
+    getActions?: () => Promise<AXPLayoutDetailsViewAction[]>;
     isPrimary?: boolean;
     isReadonly?: boolean;
     settings?: {
         commands?: {
             accept?: {
                 title: string;
+                icon?: string;
                 color: string;
                 visible?: string | boolean;
                 command: AXPExecuteCommand;
             };
             reject?: {
                 title: string;
+                icon?: string;
                 color: string;
                 visible?: string | boolean;
                 command: AXPExecuteCommand;
@@ -430,8 +439,10 @@ interface AXPLayoutDetailsViewAdapter {
     breadcrumbs?: AXPBreadcrumbItem[];
     pages: AXPLayoutDetailsViewPage[];
     execute?: (command: AXPExecuteCommand, context: {}) => Promise<AXPExecuteCommandResult>;
-    load?: (params?: Record<string, any>) => Promise<AXPExecuteCommandResult>;
+    load?: (params?: Record<string, unknown>) => Promise<AXPExecuteCommandResult>;
     exitUrl?: string;
+    getPageBadge?: (context: Record<string, unknown>, isDirty: boolean) => Promise<AXPBadge | null>;
+    getPageStatus?: (context: Record<string, unknown>, currentPage: AXPLayoutDetailsViewPage | null) => Promise<AXPPageStatus | null>;
 }
 
 declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
@@ -448,6 +459,8 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
         tabId: string;
         tab: AXPLayoutDetailsViewTabItem;
     }[]>>;
+    evaluatedPageContent: _angular_core.Signal<AXPWidgetNode[]>;
+    evaluatedTabContentsById: _angular_core.Signal<Record<string, AXPWidgetNode[]>>;
     icon: _angular_core.Signal<string | null>;
     content: _angular_core.Signal<_acorex_platform_layout_views.AXPPageContentItem[]>;
     showPages: _angular_core.Signal<boolean>;
@@ -471,12 +484,12 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     currentPageDescription: () => string | null;
     currentPagePrimaryActions: () => Promise<any>;
     currentPageSecondaryActions: () => Promise<any>;
-    currentPageContent: () => _acorex_platform_layout_views.AXPPageContentItem[] | undefined;
+    currentPageContent: () => AXPWidgetNode[];
     currentPageTabs: () => AXPLayoutDetailsViewTabItem[] | undefined;
     setCurrentPage: (page: AXPLayoutDetailsViewPage | null) => void;
     setCurrentTab: (tab: AXPLayoutDetailsViewTabItem) => void;
-    getCurrentTabContent: () => _acorex_platform_layout_widget_core.AXPWidgetNode[];
-    getRenderedTabContent: (tabId: string) => _acorex_platform_layout_widget_core.AXPWidgetNode[];
+    getCurrentTabContent: () => AXPWidgetNode[];
+    getRenderedTabContent: (tabId: string) => AXPWidgetNode[];
     clearPageTabCache: (pageId: string) => void;
     title: () => string | null;
     backButtonTitle: () => string | null;
@@ -506,6 +519,8 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
         tabId: string;
         tab: AXPLayoutDetailsViewTabItem;
     }>>;
+    evaluatedPageContent: AXPWidgetNode[];
+    evaluatedTabContentsById: Record<string, AXPWidgetNode[]>;
 }>>;
 
 declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent implements OnInit, OnDestroy {
@@ -525,6 +540,8 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
             tabId: string;
             tab: _acorex_platform_layout_views.AXPLayoutDetailsViewTabItem;
         }[]>>;
+        evaluatedPageContent: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPWidgetNode[]>;
+        evaluatedTabContentsById: _angular_core.Signal<Record<string, _acorex_platform_layout_widget_core.AXPWidgetNode[]>>;
         icon: _angular_core.Signal<string | null>;
         content: _angular_core.Signal<_acorex_platform_layout_views.AXPPageContentItem[]>;
         showPages: _angular_core.Signal<boolean>;
@@ -548,7 +565,7 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         currentPageDescription: () => string | null;
         currentPagePrimaryActions: () => Promise<any>;
         currentPageSecondaryActions: () => Promise<any>;
-        currentPageContent: () => _acorex_platform_layout_views.AXPPageContentItem[] | undefined;
+        currentPageContent: () => _acorex_platform_layout_widget_core.AXPWidgetNode[];
         currentPageTabs: () => _acorex_platform_layout_views.AXPLayoutDetailsViewTabItem[] | undefined;
         setCurrentPage: (page: AXPLayoutDetailsViewPage | null) => void;
         setCurrentTab: (tab: _acorex_platform_layout_views.AXPLayoutDetailsViewTabItem) => void;
@@ -583,11 +600,14 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
             tabId: string;
             tab: _acorex_platform_layout_views.AXPLayoutDetailsViewTabItem;
         }>>;
+        evaluatedPageContent: _acorex_platform_layout_widget_core.AXPWidgetNode[];
+        evaluatedTabContentsById: Record<string, _acorex_platform_layout_widget_core.AXPWidgetNode[]>;
     }>;
     protected router: Router;
     protected route: ActivatedRoute;
     protected eventService: AXPBroadcastEventService;
     protected deviceService: AXPDeviceService;
+    private settingsService;
     private onSelectionChangeSubscription?;
     private readonly destroyed$;
     protected form: _angular_core.Signal<AXFormComponent | undefined>;
@@ -605,7 +625,7 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     ngOnInit(): Promise<void>;
     ngAfterViewInit(): Promise<void>;
     ngOnDestroy(): void;
-    protected handleOnContextChanged(e: AXPWidgetCoreContextChangeEvent): void;
+    protected handleOnContextChanged(e: AXPContextChangeEvent): void;
     protected handleSelectPage(page: AXPLayoutDetailsViewPage): void;
     protected getAllPrimaryActions(): Promise<AXPLayoutDetailsViewAction[]>;
     getPrimaryMenuItems(): Promise<AXPActionMenuItem[]>;
@@ -617,6 +637,8 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     protected getPageTitle(): Promise<string>;
     getPageDescription(): Promise<string | null>;
     getBackButton(): Promise<AXPBackButton | null>;
+    getPageBadge(): Promise<AXPBadge | null>;
+    getPageStatus(): Promise<AXPPageStatus | null>;
     /**
      * Get entity data for status chip component
      */
@@ -628,5 +650,18 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLayoutDetailsViewComponent, "axp-layout-details-view", never, { "adapter": { "alias": "adapter"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { AXPLayoutDetailsViewComponent, AXPLayoutDetailsViewViewModel, AXPPageLayoutBase, AXPPageLayoutBaseComponent, AXPPageLayoutComponent, AXPPopupLayoutBase, AXPPopupLayoutBaseComponent, AXPPopupLayoutComponent };
+/**
+ * Registry of rendered page component instances by component key.
+ * Used so page execute can delegate to the actual component instance in the view.
+ */
+declare class AXPPageComponentInstanceRegistryService {
+    private readonly instances;
+    register(key: string, instance: AXPPageLayoutBaseComponent): void;
+    unregister(key: string): void;
+    get(key: string): AXPPageLayoutBaseComponent | null;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPPageComponentInstanceRegistryService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPPageComponentInstanceRegistryService>;
+}
+
+export { AXPLayoutDetailsViewComponent, AXPLayoutDetailsViewViewModel, AXPPageComponentInstanceRegistryService, AXPPageLayoutBase, AXPPageLayoutBaseComponent, AXPPageLayoutComponent, AXPPopupLayoutBase, AXPPopupLayoutBaseComponent, AXPPopupLayoutComponent };
 export type { AXPLayoutDetailsViewAction, AXPLayoutDetailsViewAdapter, AXPLayoutDetailsViewPage, AXPLayoutDetailsViewTabItem, AXPPageContentItem };

package/{layout/widget-core/index.d.ts → types/acorex-platform-layout-widget-core.d.ts}

@@ -1,9 +1,10 @@
 import * as _angular_core from '@angular/core';
-import { Signal, InjectionToken, ComponentRef, OnInit, EventEmitter, TemplateRef, Injector, WritableSignal, SimpleChanges, ModuleWithProviders } from '@angular/core';
-import * as _ngrx_signals from '@ngrx/signals';
+import { Signal, InjectionToken, ComponentRef, OnInit, EventEmitter, TemplateRef, Injector, WritableSignal, SimpleChanges } from '@angular/core';
 import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
+import * as _ngrx_signals from '@ngrx/signals';
+import * as _acorex_platform_core from '@acorex/platform/core';
+import { AXPMultiLanguageString, AXPOptionsData, AXPDataType, AXPExpression, AXPWidgetTriggers, AXPMetaData, AXPValueTransformerFunctions, AXPValidationRules, AXPPartialNested, AXPContextChangeEvent, AXPExpressionEvaluatorService } from '@acorex/platform/core';
 import { AXValueChangedEvent, AXDataSource } from '@acorex/cdk/common';
-import { AXPOptionsData, AXPDataType, AXPExpression, AXPWidgetTriggers, AXPMetaData, AXPValueTransformerFunctions, AXPValidationRules, AXPPartialNested, AXPExpressionEvaluatorService } from '@acorex/platform/core';
 import { Subject, BehaviorSubject } from 'rxjs';
 import { AXDataTableColumnComponent } from '@acorex/components/data-table';
 import * as i7 from '@acorex/core/translation';
@@ -92,13 +93,17 @@ declare class AXPWidgetCoreService {
 
 interface AXPWidgetCategory {
     name: string;
-    title: string;
+    title: AXPMultiLanguageString;
     order: number;
 }
+/** Normalizes widget categories to an array for iteration and serialization. */
+declare function normalizeWidgetCategories(categories?: AXPWidgetCategory | AXPWidgetCategory[]): AXPWidgetCategory[];
 declare const AXP_WIDGETS_LAYOUT_CATEGORY: AXPWidgetCategory;
 declare const AXP_WIDGETS_EDITOR_CATEGORY: AXPWidgetCategory;
 declare const AXP_WIDGETS_ACTION_CATEGORY: AXPWidgetCategory;
 declare const AXP_WIDGETS_ADVANCE_CATEGORY: AXPWidgetCategory;
+/** Widgets exposed to AI assistants for structured rendering (see Widgets:GetForAI). */
+declare const AXP_WIDGETS_AI_CATEGORY: AXPWidgetCategory;
 declare const AXP_WIDGETS_CATEGORIES: AXPWidgetCategory[];
 
 type AXPWidgetGroup = 'form-element' | 'dashboard-widget' | 'form-template' | 'property-editor' | 'meta-data' | 'setting-widget' | 'entity-widget' | 'utility-widget';
@@ -134,6 +139,7 @@ interface AXPWidgetTypesMap {
     pageLayout: 'page-layout';
     repeaterLayout: 'repeater-layout';
     textBlockLayout: 'text-block-layout';
+    alertBoxLayout: 'alert-box-layout';
     fileUploader: 'file-uploader';
     fileTypeExtension: 'file-type-extension';
     map: 'map';
@@ -195,6 +201,7 @@ interface AXPWidgetTypesMap {
     advancedWeather: 'advanced-weather';
     metaData: 'meta-data-editor';
     templateEditor: 'template-box-editor';
+    templateContentEditor: 'template-content-editor';
     themePaletteChooser: 'theme-palette-chooser';
     themeModeChooser: 'theme-mode-chooser';
     menuOrientationChooser: 'menu-orientation-chooser';
@@ -213,11 +220,15 @@ interface AXPWidgetTypesMap {
     entityList: 'entity-list';
     stepWizard: 'step-wizard';
     documentUploader: 'document-uploader';
+    documentFileTypeFilter: 'document-file-type-filter';
     editorJs: 'editor-js-editor';
     progressBar: 'progress-bar-editor';
     rate: 'rate-picker-editor';
+    entityDefinitionProvider: 'entity-definition-provider-editor';
 }
 
+/** Inclusion mode for AI widget catalog queries (Widgets:GetForAI). */
+type AXPWidgetAiCatalogMode = 'include' | 'exclude' | 'inherit';
 interface AXPWidgetPropertyGroup {
     name: string;
     title: string;
@@ -241,7 +252,7 @@ interface AXPWidgetProperty {
         interface: Required<Pick<AXPWidgetNode, 'path'>> & Omit<AXPWidgetNode, 'path'>;
     };
     validations?: AXPValidationRules;
-    visible: boolean;
+    visible: boolean | AXPExpression;
     binding?: {
         enabled: boolean;
         /** When set, the expression is edited at path + '.' + optionKey (e.g. options.visibility). */
@@ -255,7 +266,7 @@ declare function createStringProperty(ctor: {
     title: string;
     path?: string;
     group: AXPWidgetPropertyGroup;
-    visible?: boolean;
+    visible?: boolean | AXPExpression;
 }): AXPWidgetProperty;
 declare function createNumberProperty(ctor: {
     defaultValue?: number;
@@ -263,7 +274,7 @@ declare function createNumberProperty(ctor: {
     title: string;
     path?: string;
     group: AXPWidgetPropertyGroup;
-    visible?: boolean;
+    visible?: boolean | AXPExpression;
     options?: {
         minValue?: number;
         maxValue?: number;
@@ -276,7 +287,7 @@ declare function createBooleanProperty(ctor: {
     title: string;
     path?: string;
     group: AXPWidgetPropertyGroup;
-    visible?: boolean;
+    visible?: boolean | AXPExpression;
 }): AXPWidgetProperty;
 declare function createSelectProperty<T = string | {
     id: string;
@@ -288,7 +299,7 @@ declare function createSelectProperty<T = string | {
     title: string;
     path?: string;
     group: AXPWidgetPropertyGroup;
-    visible?: boolean;
+    visible?: boolean | AXPExpression;
 }): AXPWidgetProperty;
 interface AXPWidgetNode {
     type: AXPWidgetTypesMap[keyof AXPWidgetTypesMap] | keyof AXPWidgetTypesMap | string;
@@ -351,9 +362,14 @@ type AXPExtractWidgetConfig<T> = {
 interface AXPWidgetConfig<T = any> {
     name: AXPWidgetTypesMap[keyof AXPWidgetTypesMap] | keyof AXPWidgetTypesMap | string;
     alias?: string | string[];
-    title: string;
+    title: AXPMultiLanguageString;
     icon?: string;
-    description?: string;
+    description?: AXPMultiLanguageString;
+    /**
+     * Optional guidance for AI assistants (Widgets:GetForAI). Explains when and how to use this widget
+     * for structured output; unrelated to end-user UI copy.
+     */
+    aiDescription?: string | null;
     categories?: AXPWidgetCategory | AXPWidgetCategory[];
     groups?: AXPWidgetGroup[];
     properties?: AXPWidgetProperty[];
@@ -363,8 +379,21 @@ interface AXPWidgetConfig<T = any> {
     designer?: AXPExtractWidgetConfig<T>['designer'];
     options?: Record<string, any>;
     defaultFilterWidgetName?: 'string-filter' | 'number-filter' | 'datetime-filter' | 'boolean-filter' | 'select-filter' | 'lookup-filter' | 'time-duration-filter' | string;
+    /**
+     * Optional layout for Change History. When set, this AXPWidgetNode is rendered for
+     * changes of this widget type instead of the default fieldKey/actionKey text.
+     * Context passed to renderer: the AXPActivityLogChange object.
+     * If omitted, the default display is used.
+     */
+    historyLayout?: AXPWidgetNode;
+    /**
+     * Controls inclusion in AI-facing widget catalog queries (e.g. Widgets:GetForAI).
+     * `inherit` (default): include only when `categories` contains the AI category (`AXP_WIDGETS_AI_CATEGORY`).
+     * `include` / `exclude`: force include or exclude regardless of categories.
+     */
+    aiCatalog?: AXPWidgetAiCatalogMode;
 }
-interface extendedWidget {
+interface AXPExtendedWidget {
     widget: AXPWidgetConfig;
     parentName: string;
 }
@@ -381,32 +410,32 @@ declare abstract class AXPBaseWidgetComponent<TOptions extends Record<string, un
     readonly host: HTMLDivElement;
     protected readonly layoutService: AXPWidgetCoreService;
     protected readonly contextService: {
-        data: _angular_core.Signal<{}>;
-        state: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPWidgetCoreContextState>;
+        data: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        state: _angular_core.Signal<_acorex_platform_core.AXPContextState>;
         initialSnapshot: _angular_core.Signal<{}>;
         previousSnapshot: _angular_core.Signal<{}>;
-        lastChange: _ngrx_signals.DeepSignal<_acorex_platform_layout_widget_core.AXPWidgetCoreContextChangeEvent>;
+        lastChange: _ngrx_signals.DeepSignal<_acorex_platform_core.AXPContextChangeEvent>;
         isChanged: _angular_core.Signal<boolean>;
         isReset: _angular_core.Signal<boolean>;
         isInitiated: _angular_core.Signal<boolean>;
         isEmpty: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
-        snapshot: _angular_core.Signal<{}>;
+        snapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         initial: _angular_core.Signal<{}>;
         previous: _angular_core.Signal<{}>;
-        changeEvent: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPWidgetCoreContextChangeEvent>;
+        changeEvent: _angular_core.Signal<_acorex_platform_core.AXPContextChangeEvent>;
         update: (path: string, value: any) => void;
-        patch: (context: {}, skipDirtyTracking?: boolean) => void;
+        patch: (context: Record<string, any>, skipDirtyTracking?: boolean) => void;
         reset: () => void;
         set: (initialData: any) => void;
         getValue: (path: string) => any;
         hasValue: (path: string) => boolean;
     } & _ngrx_signals.StateSource<{
-        data: {};
-        state: _acorex_platform_layout_widget_core.AXPWidgetCoreContextState;
+        data: _acorex_platform_core.AXPContextData;
+        state: _acorex_platform_core.AXPContextState;
         initialSnapshot: {};
         previousSnapshot: {};
-        lastChange: _acorex_platform_layout_widget_core.AXPWidgetCoreContextChangeEvent;
+        lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
     readonly config: _acorex_platform_layout_widget_core.AXPWidgetConfig<any>;
     readonly node: AXPWidgetNode;
@@ -731,74 +760,37 @@ declare abstract class AXPTableItemBaseLayoutWidgetComponent extends AXPTableIte
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPTableItemBaseLayoutWidgetComponent>;
 }
 
-type AXPWidgetCoreContextState = 'initiated' | 'restored' | 'changed' | 'patch';
-declare class AXPWidgetCoreContextChangeEvent {
-    oldValue?: any;
-    newValue?: any;
-    path?: string;
-    state: AXPWidgetCoreContextState;
-    data: any;
-}
-declare const AXPWidgetCoreContextStore: _angular_core.Type<{
-    data: _angular_core.Signal<{}>;
-    state: _angular_core.Signal<AXPWidgetCoreContextState>;
-    initialSnapshot: _angular_core.Signal<{}>;
-    previousSnapshot: _angular_core.Signal<{}>;
-    lastChange: _ngrx_signals.DeepSignal<AXPWidgetCoreContextChangeEvent>;
-    isChanged: _angular_core.Signal<boolean>;
-    isReset: _angular_core.Signal<boolean>;
-    isInitiated: _angular_core.Signal<boolean>;
-    isEmpty: _angular_core.Signal<boolean>;
-    isDirty: _angular_core.Signal<boolean>;
-    snapshot: _angular_core.Signal<{}>;
-    initial: _angular_core.Signal<{}>;
-    previous: _angular_core.Signal<{}>;
-    changeEvent: _angular_core.Signal<AXPWidgetCoreContextChangeEvent>;
-    update: (path: string, value: any) => void;
-    patch: (context: {}, skipDirtyTracking?: boolean) => void;
-    reset: () => void;
-    set: (initialData: any) => void;
-    getValue: (path: string) => any;
-    hasValue: (path: string) => boolean;
-} & _ngrx_signals.StateSource<{
-    data: {};
-    state: AXPWidgetCoreContextState;
-    initialSnapshot: {};
-    previousSnapshot: {};
-    lastChange: AXPWidgetCoreContextChangeEvent;
-}>>;
-
 declare class AXPWidgetContainerComponent {
     readonly contextService: {
-        data: _angular_core.Signal<{}>;
-        state: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPWidgetCoreContextState>;
+        data: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        state: _angular_core.Signal<_acorex_platform_core.AXPContextState>;
         initialSnapshot: _angular_core.Signal<{}>;
         previousSnapshot: _angular_core.Signal<{}>;
-        lastChange: _ngrx_signals.DeepSignal<AXPWidgetCoreContextChangeEvent>;
+        lastChange: _ngrx_signals.DeepSignal<AXPContextChangeEvent>;
         isChanged: _angular_core.Signal<boolean>;
         isReset: _angular_core.Signal<boolean>;
         isInitiated: _angular_core.Signal<boolean>;
         isEmpty: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
-        snapshot: _angular_core.Signal<{}>;
+        snapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         initial: _angular_core.Signal<{}>;
         previous: _angular_core.Signal<{}>;
-        changeEvent: _angular_core.Signal<AXPWidgetCoreContextChangeEvent>;
+        changeEvent: _angular_core.Signal<AXPContextChangeEvent>;
         update: (path: string, value: any) => void;
-        patch: (context: {}, skipDirtyTracking?: boolean) => void;
+        patch: (context: Record<string, any>, skipDirtyTracking?: boolean) => void;
         reset: () => void;
         set: (initialData: any) => void;
         getValue: (path: string) => any;
         hasValue: (path: string) => boolean;
     } & _ngrx_signals.StateSource<{
-        data: {};
-        state: _acorex_platform_layout_widget_core.AXPWidgetCoreContextState;
+        data: _acorex_platform_core.AXPContextData;
+        state: _acorex_platform_core.AXPContextState;
         initialSnapshot: {};
         previousSnapshot: {};
-        lastChange: AXPWidgetCoreContextChangeEvent;
+        lastChange: AXPContextChangeEvent;
     }>;
     readonly builderService: AXPWidgetCoreService;
-    readonly onContextChanged: EventEmitter<AXPWidgetCoreContextChangeEvent>;
+    readonly onContextChanged: EventEmitter<AXPContextChangeEvent>;
     set context(value: any);
     set functions(v: any);
     constructor();
@@ -810,16 +802,43 @@ declare class AXPWidgetContainerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetContainerComponent, "axp-widgets-container", never, { "context": { "alias": "context"; "required": false; }; "functions": { "alias": "functions"; "required": false; }; }, { "onContextChanged": "onContextChanged"; }, never, ["*"], false, never>;
 }
 
+/**
+ * Provider interface for widget definitions.
+ * Implement this interface and register via AXP_WIDGET_DEFINITION_PROVIDER to contribute widgets.
+ */
+interface AXPWidgetDefinitionProvider {
+    getWidgets(): AXPWidgetConfig[];
+    getExtendedWidgets?(): AXPExtendedWidget[];
+}
+/**
+ * Injection token for widget definition providers.
+ * Modules register their widget providers using this token (multi: true).
+ */
+declare const AXP_WIDGET_DEFINITION_PROVIDER: InjectionToken<AXPWidgetDefinitionProvider[]>;
+
+/**
+ * Merges core + extended widgets the same way as AXPWidgetRegistryService.ensureBuilt().
+ * Use with concrete providers (e.g. AXPCoreWidgetsProvider, AXPEntityWidgetsProvider) in Node scripts without DI.
+ */
+declare function buildWidgetRegistryMapFromProviders(providers: AXPWidgetDefinitionProvider[]): Map<string, AXPWidgetConfig>;
+/**
+ * Aggregates widgets from all AXP_WIDGET_DEFINITION_PROVIDER instances.
+ * Token-based like AXP_MENU_PROVIDER / AXP_PERMISSION_DEFINITION_PROVIDER / AXP_SETTING_DEFINITION_PROVIDER.
+ * No separate registry - widgets come solely from providers.
+ */
 declare class AXPWidgetRegistryService {
-    private types;
-    static instance: AXPWidgetRegistryService;
+    private readonly _providers;
+    private _types;
     /**
-     *
+     * Lazy-build widget map from all providers.
      */
-    constructor();
-    register(widget: AXPWidgetConfig): void;
-    extend(parentName: string, widget: AXPWidgetConfig): void;
-    resolve(name: string): AXPWidgetConfig | undefined;
+    private ensureBuilt;
+    resolve(name: string): AXPWidgetConfig;
+    /**
+     * Registered widget config when present; otherwise `undefined`. Does not throw — use when
+     * {@link resolve}'s value may be a non-widget id (e.g. data-source row id in dynamic field configurator).
+     */
+    getOptional(name: string): AXPWidgetConfig | undefined;
     all(): AXPWidgetConfig[];
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetRegistryService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetRegistryService>;
@@ -918,32 +937,32 @@ declare class AXPWidgetRendererDirective {
     private injector;
     protected builderService: AXPWidgetCoreService;
     protected contextService: {
-        data: _angular_core.Signal<{}>;
-        state: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPWidgetCoreContextState>;
+        data: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        state: _angular_core.Signal<_acorex_platform_core.AXPContextState>;
         initialSnapshot: _angular_core.Signal<{}>;
         previousSnapshot: _angular_core.Signal<{}>;
-        lastChange: _ngrx_signals.DeepSignal<_acorex_platform_layout_widget_core.AXPWidgetCoreContextChangeEvent>;
+        lastChange: _ngrx_signals.DeepSignal<_acorex_platform_core.AXPContextChangeEvent>;
         isChanged: _angular_core.Signal<boolean>;
         isReset: _angular_core.Signal<boolean>;
         isInitiated: _angular_core.Signal<boolean>;
         isEmpty: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
-        snapshot: _angular_core.Signal<{}>;
+        snapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         initial: _angular_core.Signal<{}>;
         previous: _angular_core.Signal<{}>;
-        changeEvent: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPWidgetCoreContextChangeEvent>;
+        changeEvent: _angular_core.Signal<_acorex_platform_core.AXPContextChangeEvent>;
         update: (path: string, value: any) => void;
-        patch: (context: {}, skipDirtyTracking?: boolean) => void;
+        patch: (context: Record<string, any>, skipDirtyTracking?: boolean) => void;
         reset: () => void;
         set: (initialData: any) => void;
         getValue: (path: string) => any;
         hasValue: (path: string) => boolean;
     } & _ngrx_signals.StateSource<{
-        data: {};
-        state: _acorex_platform_layout_widget_core.AXPWidgetCoreContextState;
+        data: _acorex_platform_core.AXPContextData;
+        state: _acorex_platform_core.AXPContextState;
         initialSnapshot: {};
         previousSnapshot: {};
-        lastChange: _acorex_platform_layout_widget_core.AXPWidgetCoreContextChangeEvent;
+        lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
     protected widgetRegistery: AXPWidgetRegistryService;
     protected unsubscriber: AXUnsubscriber;
@@ -976,6 +995,15 @@ declare class AXPWidgetRendererDirective {
     private queueContextUpdate;
     private processBatchedUpdates;
     private isRelevantContextChange;
+    /**
+     * True when a context store path used in an expression (`context.eval`, `context.options`) is
+     * affected by `changedPath`.
+     */
+    private contextStorePathDependsOnChangedPath;
+    /**
+     * Whether an expression template string reads context store paths affected by `changedPath`.
+     */
+    private expressionTextDependsOnContextPath;
     private hasExpressionDependency;
     private isPathAlias;
     private getExpressionValueFromNode;
@@ -1008,28 +1036,51 @@ declare class AXPWidgetRendererDirective {
 
 interface AXPWidgetCoreModuleConfigs {
     widgets?: AXPWidgetConfig[];
-    extendedWidgets?: extendedWidget[];
+    AXPExtendedWidgets?: AXPExtendedWidget[];
 }
 declare class AXPWidgetCoreModule {
-    static forRoot(config?: AXPWidgetCoreModuleConfigs): ModuleWithProviders<AXPWidgetCoreModule>;
-    static forChild(config?: AXPWidgetCoreModuleConfigs): ModuleWithProviders<AXPWidgetCoreModule>;
-    /**
-     * @ignore
-     */
-    constructor(instances: any[]);
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetCoreModule, [{ optional: true; }]>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXPWidgetCoreModule, [typeof AXPWidgetContainerComponent, typeof AXPWidgetColumnRendererComponent, typeof AXPWidgetRendererDirective], [typeof i4.CommonModule, typeof i5.PortalModule, typeof i6.AXSkeletonModule, typeof i4.CommonModule, typeof i7.AXTranslationModule], [typeof AXPWidgetContainerComponent, typeof AXPWidgetColumnRendererComponent, typeof AXPWidgetRendererDirective]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetCoreModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXPWidgetCoreModule, [typeof AXPWidgetContainerComponent, typeof AXPWidgetColumnRendererComponent, typeof AXPWidgetRendererDirective], [typeof i4.CommonModule, typeof i5.PortalModule, typeof i6.AXSkeletonModule, typeof i7.AXTranslationModule], [typeof AXPWidgetContainerComponent, typeof AXPWidgetColumnRendererComponent, typeof AXPWidgetRendererDirective]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXPWidgetCoreModule>;
 }
 
+interface AXPMetaDataFeatures {
+    searchable?: {
+        enabled: boolean;
+        fullText: boolean;
+    };
+    filterable?: {
+        enabled: boolean;
+        inline: boolean;
+    };
+    sortable?: {
+        enabled: boolean;
+    };
+    auditable?: {
+        enabled: boolean;
+    };
+}
 interface AXPMetaDataDefinition {
     name: string;
     title: string;
     defaultValue?: any;
     interface: string | AXPWidgetNode | (() => Promise<AXPWidgetNode>);
+    features?: AXPMetaDataFeatures;
 }
 
 declare const AXPWidgetsCatalog: AXPWidgetTypesMap;
 
-export { AXPBaseWidgetComponent, AXPBlockBaseLayoutWidgetComponent, AXPBoxModelLayoutWidgetComponent, AXPColumnWidgetComponent, AXPDataListWidgetComponent, AXPFlexBaseLayoutWidgetComponent, AXPFlexItemBaseLayoutWidgetComponent, AXPGridBaseLayoutWidgetComponent, AXPGridItemBaseLayoutWidgetComponent, AXPInlineBaseLayoutWidgetComponent, AXPLayoutBaseWidgetComponent, AXPPageStatus, AXPPropertyEditorHelper, AXPTableBaseLayoutWidgetComponent, AXPTableItemBaseLayoutWidgetComponent, AXPTableItemOpsBaseLayoutWidgetComponent, AXPValueWidgetComponent, AXPWidgetColumnRendererComponent, AXPWidgetContainerComponent, AXPWidgetCoreContextChangeEvent, AXPWidgetCoreContextStore, AXPWidgetCoreElement, AXPWidgetCoreModule, AXPWidgetCoreService, AXPWidgetGroupEnum, AXPWidgetRegistryService, AXPWidgetRendererDirective, AXPWidgetSerializationHelper, AXPWidgetStatus, AXPWidgetsCatalog, AXP_WIDGETS_ACTION_CATEGORY, AXP_WIDGETS_ADVANCE_CATEGORY, AXP_WIDGETS_CATEGORIES, AXP_WIDGETS_EDITOR_CATEGORY, AXP_WIDGETS_LAYOUT_CATEGORY, AXP_WIDGET_COLUMN_TOKEN, AXP_WIDGET_TOKEN, cloneProperty, createBooleanProperty, createNumberProperty, createSelectProperty, createStringProperty, findNonEmptyBreakpoints };
-export type { AXPBorderBox, AXPBorderBoxString, AXPBreakpointValues, AXPBreakpoints, AXPClassMap, AXPExtractWidgetConfig, AXPFlexBoxString, AXPFlexItemBoxString, AXPGridBoxString, AXPGridBreakpointValues, AXPGridItemBoxString, AXPLayoutBuilderStatusChangedEvent, AXPMetaDataDefinition, AXPPropertyCorners, AXPPropertyEditorCornerValues, AXPPropertyEditorSideGeneric, AXPPropertyEditorSideValues, AXPPropertySides, AXPSpacingBox, AXPSpacingBoxString, AXPStyleMap, AXPWidgetCategory, AXPWidgetColumnNode, AXPWidgetColumnNodeToken, AXPWidgetComponentConfig, AXPWidgetConfig, AXPWidgetConfigComponents, AXPWidgetCoreContextState, AXPWidgetCoreElementAPI, AXPWidgetCoreElementAction, AXPWidgetCoreModuleConfigs, AXPWidgetDesignerOptionsMap, AXPWidgetGroup, AXPWidgetNode, AXPWidgetNodeToken, AXPWidgetProperty, AXPWidgetPropertyGroup, AXPWidgetRenderMode, AXPWidgetRendererDirectiveOptions, AXPWidgetTypesMap, AXPWidgetViewType, extendedWidget };
+/**
+ * True when the widget declares the AI category (see {@link AXP_WIDGETS_AI_CATEGORY}).
+ */
+declare function hasAiWidgetCategory(config: AXPWidgetConfig): boolean;
+/**
+ * Resolves AI catalog visibility using {@link AXPWidgetConfig.aiCatalog} and the AI widget category.
+ * - `exclude`: never listed.
+ * - `include`: always listed (override when the widget cannot declare the AI category yet).
+ * - `inherit` / omitted: listed only if {@link hasAiWidgetCategory} is true.
+ */
+declare function isWidgetAiCatalogIncluded(config: AXPWidgetConfig): boolean;
+
+export { AXPBaseWidgetComponent, AXPBlockBaseLayoutWidgetComponent, AXPBoxModelLayoutWidgetComponent, AXPColumnWidgetComponent, AXPDataListWidgetComponent, AXPFlexBaseLayoutWidgetComponent, AXPFlexItemBaseLayoutWidgetComponent, AXPGridBaseLayoutWidgetComponent, AXPGridItemBaseLayoutWidgetComponent, AXPInlineBaseLayoutWidgetComponent, AXPLayoutBaseWidgetComponent, AXPPageStatus, AXPPropertyEditorHelper, AXPTableBaseLayoutWidgetComponent, AXPTableItemBaseLayoutWidgetComponent, AXPTableItemOpsBaseLayoutWidgetComponent, AXPValueWidgetComponent, AXPWidgetColumnRendererComponent, AXPWidgetContainerComponent, AXPWidgetCoreElement, AXPWidgetCoreModule, AXPWidgetCoreService, AXPWidgetGroupEnum, AXPWidgetRegistryService, AXPWidgetRendererDirective, AXPWidgetSerializationHelper, AXPWidgetStatus, AXPWidgetsCatalog, AXP_WIDGETS_ACTION_CATEGORY, AXP_WIDGETS_ADVANCE_CATEGORY, AXP_WIDGETS_AI_CATEGORY, AXP_WIDGETS_CATEGORIES, AXP_WIDGETS_EDITOR_CATEGORY, AXP_WIDGETS_LAYOUT_CATEGORY, AXP_WIDGET_COLUMN_TOKEN, AXP_WIDGET_DEFINITION_PROVIDER, AXP_WIDGET_TOKEN, buildWidgetRegistryMapFromProviders, cloneProperty, createBooleanProperty, createNumberProperty, createSelectProperty, createStringProperty, findNonEmptyBreakpoints, hasAiWidgetCategory, isWidgetAiCatalogIncluded, normalizeWidgetCategories };
+export type { AXPBorderBox, AXPBorderBoxString, AXPBreakpointValues, AXPBreakpoints, AXPClassMap, AXPExtendedWidget, AXPExtractWidgetConfig, AXPFlexBoxString, AXPFlexItemBoxString, AXPGridBoxString, AXPGridBreakpointValues, AXPGridItemBoxString, AXPLayoutBuilderStatusChangedEvent, AXPMetaDataDefinition, AXPMetaDataFeatures, AXPPropertyCorners, AXPPropertyEditorCornerValues, AXPPropertyEditorSideGeneric, AXPPropertyEditorSideValues, AXPPropertySides, AXPSpacingBox, AXPSpacingBoxString, AXPStyleMap, AXPWidgetAiCatalogMode, AXPWidgetCategory, AXPWidgetColumnNode, AXPWidgetColumnNodeToken, AXPWidgetComponentConfig, AXPWidgetConfig, AXPWidgetConfigComponents, AXPWidgetCoreElementAPI, AXPWidgetCoreElementAction, AXPWidgetCoreModuleConfigs, AXPWidgetDefinitionProvider, AXPWidgetDesignerOptionsMap, AXPWidgetGroup, AXPWidgetNode, AXPWidgetNodeToken, AXPWidgetProperty, AXPWidgetPropertyGroup, AXPWidgetRenderMode, AXPWidgetRendererDirectiveOptions, AXPWidgetTypesMap, AXPWidgetViewType };