@acorex/platform 20.8.9 → 20.8.11

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

@@ -1,10 +1,12 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Signal, ComponentRef, OnInit, EventEmitter, TemplateRef, Injector, WritableSignal, SimpleChanges, ModuleWithProviders } from '@angular/core';
-import { AXPOptionsData, AXPDataType, AXPExpression, AXPWidgetTriggers, AXPMetaData, AXPValueTransformerFunctions, AXPValidationRules, AXPPartialNested, AXPExpressionEvaluatorService } from '@acorex/platform/core';
+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 { AXPOptionsData, AXPMultiLanguageString, AXPDefinitionCategory, AXPDataType, AXPExpression, AXPWidgetTriggers, AXPMetaData, AXPValueTransformerFunctions, AXPValidationRules, AXPPartialNested, AXPProperty, AXPContextChangeEvent, AXPExpressionEvaluatorService } from '@acorex/platform/core';
+export { AXPDefinitionCategory, normalizeDefinitionCategories } from '@acorex/platform/core';
 import { AXValueChangedEvent, AXDataSource } from '@acorex/cdk/common';
 import { Subject, BehaviorSubject } from 'rxjs';
-import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
 import { AXDataTableColumnComponent } from '@acorex/components/data-table';
 import * as i7 from '@acorex/core/translation';
 import { AXTranslationService } from '@acorex/core/translation';
@@ -13,18 +15,86 @@ import * as i4 from '@angular/common';
 import * as i5 from '@angular/cdk/portal';
 import * as i6 from '@acorex/components/skeleton';
 
-interface AXPWidgetCategory {
-    name: string;
+declare enum AXPPageStatus {
+    Idle = "idle",// The page is idle.
+    Rendering = "rendering",// The page is being rendered.
+    Rendered = "rendered",// The rendering process is complete. should be renamed to idle
+    Processing = "processing",// The page is performing a task or interaction.
+    Submitting = "submitting",// The form is being submitted.
+    Submitted = "submitted",// Submission is completed.
+    Validating = "validating",// The form is being validated.
+    Validated = "validated",// Validation is completed.  
+    Error = "error"
+}
+declare enum AXPWidgetStatus {
+    Rendering = "rendering",// The widget is being rendered.
+    Rendered = "rendered",// The rendering process is complete.
+    Processing = "processing",// The widget is performing a task or interaction.
+    Error = "error"
+}
+
+type AXPWidgetCoreElementAPI = {
+    [name: string]: Subject<any> | Function;
+};
+type AXPWidgetCoreElementAction = {
     title: string;
-    order: number;
+    command: string;
+    icon?: string;
+    color?: string;
+    disabled?: boolean | string;
+    hidden?: boolean | string;
+    zone?: 'header' | 'footer';
+    placement?: 'prefix' | 'suffix';
+    scope?: 'primary' | 'secondary';
+    /** When `command` is not `widget:<name>.<action>`, widget name used to resolve `api` for `hidden` / `disabled` expressions. */
+    predicateApiWidgetName?: string;
+};
+declare abstract class AXPWidgetCoreElement {
+    abstract get id(): string | null;
+    abstract get status(): Signal<AXPWidgetStatus>;
+    api(): AXPWidgetCoreElementAPI;
+    actions(): AXPWidgetCoreElementAction[];
+}
+declare class AXPWidgetCoreService {
+    private readonly variables$;
+    private readonly functions$;
+    readonly onRefresh: Subject<void>;
+    private widgets;
+    private readonly onWidgetRegistered;
+    private readonly status$;
+    readonly status: Signal<AXPPageStatus>;
+    readonly isBusy: Signal<boolean>;
+    registeredWidgetsCount: _angular_core.WritableSignal<number>;
+    get variables(): any;
+    get functions(): {
+        [key: string]: Function;
+    };
+    updateStatus(): void;
+    private detectStatus;
+    refresh(): void;
+    setStatus(status: AXPPageStatus): void;
+    setVariables(keysValues: any): void;
+    setVariables(key: string, value: any): void;
+    setFunctions(keysValues: any): void;
+    setFunctions(key: string, value: any): void;
+    registerWidget(id: string, widget: AXPWidgetCoreElement): void;
+    getWidget(id: string): AXPWidgetCoreElement | undefined;
+    /**
+     * Waits until a widget with the given id is registered, then resolves with it.
+     * If the widget is already registered, resolves immediately.
+     * Optionally accepts a timeout (in ms) after which it resolves with undefined.
+     */
+    waitForWidget(id: string, timeoutMs?: number): Promise<AXPWidgetCoreElement | undefined>;
+    /**
+     * Returns a list of registered widget ids (names).
+     */
+    listRegisteredWidgetNames(): string[];
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetCoreService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetCoreService>;
 }
-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;
-declare const AXP_WIDGETS_CATEGORIES: AXPWidgetCategory[];
 
-type AXPWidgetGroup = 'form-element' | 'dashboard-widget' | 'form-template' | 'property-editor' | 'meta-data' | 'setting-widget' | 'entity-widget' | 'utility-widget';
+type AXPWidgetGroup = 'form-element' | 'dashboard-widget' | 'form-template' | 'property-editor' | 'meta-data' | 'setting-widget' | 'entity-widget' | 'utility-widget' | 'base-widget';
 declare enum AXPWidgetGroupEnum {
     FormElement = "form-element",
     DashboardWidget = "dashboard-widget",
@@ -33,7 +103,8 @@ declare enum AXPWidgetGroupEnum {
     MetaData = "meta-data",
     SettingWidget = "setting-widget",
     EntityWidget = "entity-widget",
-    UtilityWidget = "utility-widget"
+    UtilityWidget = "utility-widget",
+    BaseWidget = "base-widget"
 }
 
 interface AXPWidgetTypesMap {
@@ -57,6 +128,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';
@@ -106,19 +178,9 @@ interface AXPWidgetTypesMap {
     betweenValidation: 'between-validation';
     equalValidation: 'equal-validation';
     callbackValidation: 'callback-validation';
-    donutChart: 'donut-chart';
-    barChart: 'bar-chart';
-    lineChart: 'line-chart';
-    gaugeChart: 'gauge-chart';
-    stickyNote: 'sticky-note';
-    clockCalendar: 'clock-calendar';
-    analogClock: 'analog-clock';
-    weather: 'weather';
-    minimalWeather: 'minimal-weather';
-    advancedWeather: 'advanced-weather';
     metaData: 'meta-data-editor';
     templateEditor: 'template-box-editor';
-    themePaletteChooser: 'theme-palette-chooser';
+    templateContentEditor: 'template-content-editor';
     themeModeChooser: 'theme-mode-chooser';
     menuOrientationChooser: 'menu-orientation-chooser';
     fontStyleChooser: 'font-style-chooser';
@@ -128,7 +190,6 @@ interface AXPWidgetTypesMap {
     themeColorChooser: 'theme-color-chooser';
     panel: 'panel';
     notification: 'notification';
-    taskBoard: 'task-board';
     comment: 'comment';
     list: 'list-editor';
     dataList: 'data-list';
@@ -136,27 +197,11 @@ 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';
-}
-
-declare enum AXPPageStatus {
-    Idle = "idle",// The page is idle.
-    Rendering = "rendering",// The page is being rendered.
-    Rendered = "rendered",// The rendering process is complete. should be renamed to idle
-    Processing = "processing",// The page is performing a task or interaction.
-    Submitting = "submitting",// The form is being submitted.
-    Submitted = "submitted",// Submission is completed.
-    Validating = "validating",// The form is being validated.
-    Validated = "validated",// Validation is completed.  
-    Error = "error"
-}
-declare enum AXPWidgetStatus {
-    Rendering = "rendering",// The widget is being rendered.
-    Rendered = "rendered",// The rendering process is complete.
-    Processing = "processing",// The widget is performing a task or interaction.
-    Error = "error"
+    entityDefinitionProvider: 'entity-definition-provider-editor';
 }
 
 interface AXPWidgetPropertyGroup {
@@ -182,7 +227,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). */
@@ -196,7 +241,7 @@ declare function createStringProperty(ctor: {
     title: string;
     path?: string;
     group: AXPWidgetPropertyGroup;
-    visible?: boolean;
+    visible?: boolean | AXPExpression;
 }): AXPWidgetProperty;
 declare function createNumberProperty(ctor: {
     defaultValue?: number;
@@ -204,7 +249,7 @@ declare function createNumberProperty(ctor: {
     title: string;
     path?: string;
     group: AXPWidgetPropertyGroup;
-    visible?: boolean;
+    visible?: boolean | AXPExpression;
     options?: {
         minValue?: number;
         maxValue?: number;
@@ -217,7 +262,7 @@ declare function createBooleanProperty(ctor: {
     title: string;
     path?: string;
     group: AXPWidgetPropertyGroup;
-    visible?: boolean;
+    visible?: boolean | AXPExpression;
 }): AXPWidgetProperty;
 declare function createSelectProperty<T = string | {
     id: string;
@@ -229,7 +274,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;
@@ -254,6 +299,8 @@ interface AXPWidgetColumnNode {
     type: string;
     path: string;
     options?: AXPOptionsData;
+    /** Column header caption from data-table (`title || name`); often an i18n key. */
+    caption?: string;
 }
 interface AXPWidgetColumnNodeToken extends AXPWidgetColumnNode {
     config: AXPWidgetConfig;
@@ -292,10 +339,24 @@ 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;
-    categories?: AXPWidgetCategory | AXPWidgetCategory[];
+    description?: AXPMultiLanguageString;
+    /**
+     * Picker tabs and section headings in the widget gallery (when the widget is included in the picker list).
+     */
+    categories?: AXPDefinitionCategory | AXPDefinitionCategory[];
+    /**
+     * Optional sub-group within a parent category tab in the widget picker.
+     * Ignored on the "All" tab (widgets are grouped by parent category only).
+     */
+    subCategory?: AXPDefinitionCategory;
+    /**
+     * Which surfaces may offer this widget. The designer widget picker includes a widget only when this list
+     * intersects the requested groups (e.g. the layout designer requests `AXPWidgetGroupEnum.FormElement`).
+     * Use `AXPWidgetGroupEnum.BaseWidget` alone for types that must stay registered (filters, renderers, AI tools)
+     * but must not appear in form or dashboard pickers.
+     */
     groups?: AXPWidgetGroup[];
     properties?: AXPWidgetProperty[];
     components: AXPWidgetConfigComponents;
@@ -304,8 +365,15 @@ 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;
 }
-interface extendedWidget {
+interface AXPExtendedWidget {
     widget: AXPWidgetConfig;
     parentName: string;
 }
@@ -314,102 +382,6 @@ interface AXPLayoutBuilderStatusChangedEvent {
     status: AXPPageStatus;
 }
 
-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;
-}>>;
-
-type AXPWidgetCoreElementAPI = {
-    [name: string]: Subject<any> | Function;
-};
-type AXPWidgetCoreElementAction = {
-    title: string;
-    command: string;
-    icon?: string;
-    color?: string;
-    disabled?: boolean | string;
-    hidden?: boolean | string;
-    zone?: 'header' | 'footer';
-    placement?: 'prefix' | 'suffix';
-    scope?: 'primary' | 'secondary';
-};
-declare abstract class AXPWidgetCoreElement {
-    abstract get id(): string | null;
-    abstract get status(): Signal<AXPWidgetStatus>;
-    api(): AXPWidgetCoreElementAPI;
-    actions(): AXPWidgetCoreElementAction[];
-}
-declare class AXPWidgetCoreService {
-    private readonly variables$;
-    private readonly functions$;
-    readonly onRefresh: Subject<void>;
-    private widgets;
-    private readonly onWidgetRegistered;
-    private readonly status$;
-    readonly status: Signal<AXPPageStatus>;
-    readonly isBusy: Signal<boolean>;
-    registeredWidgetsCount: _angular_core.WritableSignal<number>;
-    get variables(): any;
-    get functions(): {
-        [key: string]: Function;
-    };
-    updateStatus(): void;
-    private detectStatus;
-    refresh(): void;
-    setStatus(status: AXPPageStatus): void;
-    setVariables(keysValues: any): void;
-    setVariables(key: string, value: any): void;
-    setFunctions(keysValues: any): void;
-    setFunctions(key: string, value: any): void;
-    registerWidget(id: string, widget: AXPWidgetCoreElement): void;
-    getWidget(id: string): AXPWidgetCoreElement | undefined;
-    /**
-     * Waits until a widget with the given id is registered, then resolves with it.
-     * If the widget is already registered, resolves immediately.
-     * Optionally accepts a timeout (in ms) after which it resolves with undefined.
-     */
-    waitForWidget(id: string, timeoutMs?: number): Promise<AXPWidgetCoreElement | undefined>;
-    /**
-     * Returns a list of registered widget ids (names).
-     */
-    listRegisteredWidgetNames(): string[];
-    ngOnDestroy(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetCoreService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetCoreService>;
-}
-
 type AXPClassMap = Readonly<Record<string, boolean>>;
 type AXPStyleMap = Readonly<Record<string, string | number>>;
 declare abstract class AXPBaseWidgetComponent<TOptions extends Record<string, unknown> = AXPOptionsData> extends AXPWidgetCoreElement {
@@ -418,34 +390,34 @@ 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<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<_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<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: AXPWidgetCoreContextState;
+        data: _acorex_platform_core.AXPContextData;
+        state: _acorex_platform_core.AXPContextState;
         initialSnapshot: {};
         previousSnapshot: {};
-        lastChange: AXPWidgetCoreContextChangeEvent;
+        lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
-    readonly config: AXPWidgetConfig<any>;
+    readonly config: _acorex_platform_layout_widget_core.AXPWidgetConfig<any>;
     readonly node: AXPWidgetNode;
     protected readonly name: string | undefined;
     protected component: this;
@@ -530,6 +502,8 @@ declare abstract class AXPColumnWidgetComponent<T = any | null | void> {
     private readonly token;
     protected readonly path: string;
     protected readonly options: Record<string, any>;
+    /** Column header caption when rendered inside `axp-widget-column-renderer`. */
+    protected readonly columnCaption: string | undefined;
     protected readonly rawValue: T;
     protected readonly rowData: any;
     protected readonly nullText: any;
@@ -556,6 +530,33 @@ declare abstract class AXPBlockBaseLayoutWidgetComponent extends AXPBoxModelLayo
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPBlockBaseLayoutWidgetComponent>;
 }
 
+/**
+ * Maps a platform {@link AXPProperty} to a property viewer row model ({@link AXPWidgetProperty}).
+ * Kept in widget-core (not platform/core) to avoid a dependency cycle: widget-core already depends on platform/core.
+ */
+interface MapAXPPropertyToWidgetPropertyOptions {
+    group: AXPWidgetPropertyGroup;
+    order: number;
+    /**
+     * Dot path prefix for {@link AXPWidgetProperty.schema.interface.path}.
+     * Example: `input` → `input.requestId`; `properties` → `properties.message`.
+     */
+    valuePathPrefix: string;
+    /**
+     * Resolves a display title (supports multi-language strings on the source property).
+     */
+    resolveTitle: (property: AXPProperty) => string;
+    /**
+     * Optional description line for the viewer row.
+     */
+    resolveDescription?: (property: AXPProperty) => string | undefined;
+}
+/**
+ * Converts a domain {@link AXPProperty} into a {@link AXPWidgetProperty} row for
+ * the layout property viewer (`AXPPropertyViewerService` and `buildPropertyViewerTabsFromProperties`).
+ */
+declare function mapAXPPropertyToWidgetProperty(property: AXPProperty, options: MapAXPPropertyToWidgetPropertyOptions): AXPWidgetProperty;
+
 type AXPPropertyEditorSideValues = 'top' | 'left' | 'bottom' | 'right';
 type AXPPropertyEditorCornerValues = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 type AXPPropertyEditorSideGeneric<T extends string, U extends string | number = string> = Record<T, U>;
@@ -770,56 +771,83 @@ declare abstract class AXPTableItemBaseLayoutWidgetComponent extends AXPTableIte
 
 declare class AXPWidgetContainerComponent {
     readonly contextService: {
-        data: _angular_core.Signal<{}>;
-        state: _angular_core.Signal<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: 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();
     status: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPPageStatus>;
     isBusy: _angular_core.Signal<boolean>;
     refresh(): void;
-    find(name: string): Promise<AXPWidgetCoreElement | undefined>;
+    find(name: string): Promise<_acorex_platform_layout_widget_core.AXPWidgetCoreElement | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetContainerComponent, never>;
     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>;
@@ -908,7 +936,7 @@ type AXPWidgetRendererDirectiveOptions = AXPMetaData;
 declare class AXPWidgetRendererDirective {
     parentNode: _angular_core.InputSignal<AXPLayoutBaseWidgetComponent<Record<string, any>> | null | undefined>;
     index: _angular_core.InputSignal<number | null | undefined>;
-    mode: _angular_core.InputSignal<keyof AXPWidgetConfigComponents>;
+    mode: _angular_core.InputSignal<keyof _acorex_platform_layout_widget_core.AXPWidgetConfigComponents>;
     node: _angular_core.InputSignal<AXPWidgetNode>;
     private _options;
     options: _angular_core.Signal<AXPMetaData>;
@@ -933,32 +961,32 @@ declare class AXPWidgetRendererDirective {
     private injector;
     protected builderService: AXPWidgetCoreService;
     protected contextService: {
-        data: _angular_core.Signal<{}>;
-        state: _angular_core.Signal<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<_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<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: AXPWidgetCoreContextState;
+        data: _acorex_platform_core.AXPContextData;
+        state: _acorex_platform_core.AXPContextState;
         initialSnapshot: {};
         previousSnapshot: {};
-        lastChange: AXPWidgetCoreContextChangeEvent;
+        lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
     protected widgetRegistery: AXPWidgetRegistryService;
     protected unsubscriber: AXUnsubscriber;
@@ -991,6 +1019,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;
@@ -1023,28 +1060,68 @@ 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 };
+declare const AXP_WIDGETS_EDITOR_SUB_TEXT_INPUTS: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_NUMERIC: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_DATETIME: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_CHOICE: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_RICH: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_VISUAL: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_COMPOSITE: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_CONFIG: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_SHELL: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_GRID: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_SURFACES: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_TABS: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_LISTS: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_UTILITY: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ACTION_SUB_CONTROLS: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ADVANCE_SUB_MEDIA: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ADVANCE_SUB_INPUT: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ADVANCE_SUB_DATA: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ADVANCE_SUB_TOOLS: AXPDefinitionCategory;
+/** Normalizes widget categories to an array for iteration and serialization. */
+declare function normalizeWidgetCategories(categories?: AXPDefinitionCategory | AXPDefinitionCategory[]): AXPDefinitionCategory[];
+declare const AXP_WIDGETS_LAYOUT_CATEGORY: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_CATEGORY: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ACTION_CATEGORY: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ADVANCE_CATEGORY: AXPDefinitionCategory;
+/** AI category tab in the widget picker (metadata); unrelated to Widgets:GetForAI listing scope. */
+declare const AXP_WIDGETS_AI_CATEGORY: AXPDefinitionCategory;
+declare const AXP_WIDGETS_CATEGORIES: AXPDefinitionCategory[];
+
+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_ACTION_SUB_CONTROLS, AXP_WIDGETS_ADVANCE_CATEGORY, AXP_WIDGETS_ADVANCE_SUB_DATA, AXP_WIDGETS_ADVANCE_SUB_INPUT, AXP_WIDGETS_ADVANCE_SUB_MEDIA, AXP_WIDGETS_ADVANCE_SUB_TOOLS, AXP_WIDGETS_AI_CATEGORY, AXP_WIDGETS_CATEGORIES, AXP_WIDGETS_EDITOR_CATEGORY, AXP_WIDGETS_EDITOR_SUB_CHOICE, AXP_WIDGETS_EDITOR_SUB_COMPOSITE, AXP_WIDGETS_EDITOR_SUB_CONFIG, AXP_WIDGETS_EDITOR_SUB_DATETIME, AXP_WIDGETS_EDITOR_SUB_NUMERIC, AXP_WIDGETS_EDITOR_SUB_RICH, AXP_WIDGETS_EDITOR_SUB_TEXT_INPUTS, AXP_WIDGETS_EDITOR_SUB_VISUAL, AXP_WIDGETS_LAYOUT_CATEGORY, AXP_WIDGETS_LAYOUT_SUB_GRID, AXP_WIDGETS_LAYOUT_SUB_LISTS, AXP_WIDGETS_LAYOUT_SUB_SHELL, AXP_WIDGETS_LAYOUT_SUB_SURFACES, AXP_WIDGETS_LAYOUT_SUB_TABS, AXP_WIDGETS_LAYOUT_SUB_UTILITY, AXP_WIDGET_COLUMN_TOKEN, AXP_WIDGET_DEFINITION_PROVIDER, AXP_WIDGET_TOKEN, buildWidgetRegistryMapFromProviders, cloneProperty, createBooleanProperty, createNumberProperty, createSelectProperty, createStringProperty, findNonEmptyBreakpoints, mapAXPPropertyToWidgetProperty, 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, AXPWidgetColumnNode, AXPWidgetColumnNodeToken, AXPWidgetComponentConfig, AXPWidgetConfig, AXPWidgetConfigComponents, AXPWidgetCoreElementAPI, AXPWidgetCoreElementAction, AXPWidgetCoreModuleConfigs, AXPWidgetDefinitionProvider, AXPWidgetDesignerOptionsMap, AXPWidgetGroup, AXPWidgetNode, AXPWidgetNodeToken, AXPWidgetProperty, AXPWidgetPropertyGroup, AXPWidgetRenderMode, AXPWidgetRendererDirectiveOptions, AXPWidgetTypesMap, AXPWidgetViewType, MapAXPPropertyToWidgetPropertyOptions };