@acorex/platform 21.0.0-next.5 → 21.0.0-next.50

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

@@ -1,9 +1,11 @@
 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 { 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 { 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';
@@ -44,6 +46,8 @@ type AXPWidgetCoreElementAction = {
     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;
@@ -90,18 +94,7 @@ declare class AXPWidgetCoreService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetCoreService>;
 }
 
-interface AXPWidgetCategory {
-    name: string;
-    title: string;
-    order: number;
-}
-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",
@@ -110,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 {
@@ -134,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';
@@ -183,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';
@@ -205,7 +190,6 @@ interface AXPWidgetTypesMap {
     themeColorChooser: 'theme-color-chooser';
     panel: 'panel';
     notification: 'notification';
-    taskBoard: 'task-board';
     comment: 'comment';
     list: 'list-editor';
     dataList: 'data-list';
@@ -213,10 +197,11 @@ 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';
 }
 
 interface AXPWidgetPropertyGroup {
@@ -230,15 +215,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 +241,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 +249,7 @@ declare function createNumberProperty(ctor: {
     title: string;
     path?: string;
     group: AXPWidgetPropertyGroup;
-    visible?: boolean;
+    visible?: boolean | AXPExpression;
     options?: {
         minValue?: number;
         maxValue?: number;
@@ -268,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;
@@ -280,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;
@@ -305,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;
@@ -343,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;
@@ -355,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;
 }
@@ -373,32 +390,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;
@@ -458,7 +475,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>>;
@@ -485,11 +502,13 @@ 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;
     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>>;
 }
@@ -511,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>;
@@ -598,6 +644,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>>;
@@ -682,74 +769,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();
@@ -761,16 +811,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>;
@@ -802,8 +879,30 @@ 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>;
+    /**
+     * Resolves `options.align`: string applies to header and cell; object uses optional `header` / `cell` (default start).
+     * Supports designer select values `{ id: 'center' }`.
+     */
+    protected getHeaderTextAlign(): 'start' | 'center' | 'end';
+    /**
+     * When true, the cell body uses flex so `justify-content` can place content on the main axis.
+     */
+    protected getCellUseFlexLayout(): boolean;
+    /**
+     * Flex `justify-content` for the cell wrapper; omit when not using flex layout.
+     */
+    protected getCellJustifyContent(): 'start' | 'center' | 'end' | null;
+    private resolveAlignForSide;
+    private normalizeColumnAlignment;
     get loadingEnabled(): boolean;
     get name(): string;
     private injector;
@@ -862,32 +961,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;
@@ -920,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;
@@ -952,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, 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 };