@acorex/platform 21.0.0-next.3 → 21.0.0-next.34

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,12 +220,15 @@ interface AXPWidgetTypesMap {
     entityList: 'entity-list';
     stepWizard: 'step-wizard';
     documentUploader: 'document-uploader';
+    documentFileTypeFilter: 'document-file-type-filter';
     editorJs: 'editor-js-editor';
-    signatureList: 'signature-list';
     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;
@@ -230,15 +240,24 @@ interface AXPWidgetProperty {
     description?: string;
     group: AXPWidgetPropertyGroup;
     order?: number;
+    /**
+     * Controls whether the property title label is shown in the property viewer panel.
+     * Defaults to true when omitted.
+     */
+    showLabel?: boolean;
     schema: {
         dataType: AXPDataType;
         nullable?: boolean;
         defaultValue?: any | string | ((context: any | null) => any);
         interface: Required<Pick<AXPWidgetNode, 'path'>> & Omit<AXPWidgetNode, 'path'>;
     };
-    options?: AXPOptionsData;
     validations?: AXPValidationRules;
-    visible: boolean;
+    visible: boolean | AXPExpression;
+    binding?: {
+        enabled: boolean;
+        /** When set, the expression is edited at path + '.' + optionKey (e.g. options.visibility). */
+        optionKey?: string;
+    };
 }
 declare function cloneProperty(property: AXPWidgetProperty, values: AXPPartialNested<AXPWidgetProperty>): AXPWidgetProperty;
 declare function createStringProperty(ctor: {
@@ -247,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;
@@ -255,7 +274,7 @@ declare function createNumberProperty(ctor: {
     title: string;
     path?: string;
     group: AXPWidgetPropertyGroup;
-    visible?: boolean;
+    visible?: boolean | AXPExpression;
     options?: {
         minValue?: number;
         maxValue?: number;
@@ -268,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;
@@ -280,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;
@@ -289,7 +308,6 @@ interface AXPWidgetNode {
     name?: string;
     visible?: boolean | AXPExpression;
     defaultValue?: any;
-    formula?: string;
     children?: AXPWidgetNode[];
     options?: AXPOptionsData;
     triggers?: AXPWidgetTriggers;
@@ -344,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[];
@@ -356,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;
 }
@@ -374,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: {}) => 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;
@@ -459,7 +495,7 @@ declare abstract class AXPValueWidgetComponent<T = any | null, TOptions extends
     protected validationRules: _angular_core.Signal<AXPValidationRules>;
     protected extractValue(path: string): any;
     setValue(value: T | null | undefined): void;
-    private detectFullPath;
+    protected detectFullPath(): void;
     protected handleValueChanged(e: AXValueChangedEvent<T>): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPValueWidgetComponent<any, any>, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPValueWidgetComponent<any, any>>;
@@ -490,7 +526,7 @@ declare abstract class AXPColumnWidgetComponent<T = any | null | void> {
     protected readonly rowData: any;
     protected readonly nullText: any;
     protected readonly nullValue: T;
-    protected value: _angular_core.Signal<T>;
+    protected value: () => T;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPColumnWidgetComponent<any>, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPColumnWidgetComponent<any>>;
 }
@@ -599,6 +635,47 @@ declare class AXPPropertyEditorHelper {
 }
 declare function findNonEmptyBreakpoints<T>(values: AXPBreakpointValues<T>): AXPBreakpoints[];
 
+/**
+ * Helper class for serializing and deserializing AXPWidgetNode to/from JSON
+ */
+declare class AXPWidgetSerializationHelper {
+    /**
+     * Removes non-serializable properties from widget node
+     * @param node - The widget node to clean
+     * @param options - Serialization options
+     * @returns Cleaned widget node ready for JSON serialization
+     */
+    private static cleanNode;
+    /**
+     * Recursively removes functions from object properties
+     */
+    private static removeFunctions;
+    /**
+     * Converts AXPWidgetNode to JSON string
+     * @param node - The widget node to serialize
+     * @param options - Serialization options
+     * @returns JSON string representation of the widget node
+     */
+    static toJson(node: AXPWidgetNode, options?: {
+        removeMeta?: boolean;
+        removeFunctions?: boolean;
+        pretty?: boolean;
+    }): string;
+    /**
+     * Converts JSON string to AXPWidgetNode
+     * @param json - JSON string to deserialize
+     * @returns Parsed AXPWidgetNode object
+     * @throws Error if JSON is invalid or doesn't match AXPWidgetNode structure
+     */
+    static fromJson(json: string): AXPWidgetNode;
+    /**
+     * Removes meta property from widget node (similar to designer service)
+     * @param node - The widget node to process
+     * @returns Widget node without meta property
+     */
+    static removeMeta(node: AXPWidgetNode): AXPWidgetNode;
+}
+
 declare abstract class AXPFlexBaseLayoutWidgetComponent extends AXPBlockBaseLayoutWidgetComponent {
     protected flex: _angular_core.Signal<AXPFlexBoxString | undefined>;
     hostFlexStyle: _angular_core.Signal<Record<string, string | number>>;
@@ -683,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: {}) => 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: {}) => 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();
@@ -762,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>;
@@ -803,6 +870,13 @@ declare class AXPWidgetColumnRendererComponent extends AXDataTableColumnComponen
     get renderCellTemplate(): TemplateRef<unknown>;
     headerTemplate: TemplateRef<unknown>;
     private _contentHeaderTemplate;
+    /**
+     * True when the row should show the expand icon: either hasChild is true (from server/initial load)
+     * or the row has loaded children (e.g. after refreshItemChildren when children go from 0 to 1).
+     */
+    protected hasExpandableRow(row: {
+        data?: Record<string, unknown>;
+    }): boolean;
     protected handleExpandRow(row: any): Promise<void>;
     get renderHeaderTemplate(): TemplateRef<unknown>;
     get loadingEnabled(): boolean;
@@ -863,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: {}) => 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;
@@ -921,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;
@@ -932,10 +1015,8 @@ declare class AXPWidgetRendererDirective {
     private loadComponent;
     private applyOptions;
     private hasOptionsChanged;
-    private checkFormulaForUpdate;
     preprocessAndInitialOptions(obj: any, pathPrefix?: string): void;
     updateOptionsBasedOnContext(): Promise<number>;
-    updateValueBasedOnFormula(): Promise<void>;
     updateVisibility(): Promise<void>;
     private show;
     private hide;
@@ -955,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, 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 };