@acorex/platform 20.3.0-next.2 → 20.3.0-next.20

package/layout/components/index.d.ts

@@ -1,21 +1,25 @@
 import * as _angular_core from '@angular/core';
 import { Signal, InjectionToken, InputSignal, TemplateRef, ElementRef, OnInit, OnDestroy, Type, ViewContainerRef, ModuleWithProviders, WritableSignal, QueryList, EventEmitter } from '@angular/core';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPActivityLog, AXPSystemActionType, AXPColumnQuery, AXPContextData, AXPOptionsData, AXPActionMenuItem, AXPExecuteCommand, AXPFilterDefinition, AXPFilterQuery, AXPSortDefinition, AXPSortQuery, AXPMetaData, AXPViewQuery } from '@acorex/platform/core';
+import { AXPActivityLog, AXPSystemActionType, AXPCategoryEntity, AXPColumnQuery, AXPContextData, AXPOptionsData, AXPGridLayoutOptions, AXPActionMenuItem, AXPExecuteCommand, AXPValidationRules, AXPFilterDefinition, AXPFilterQuery, AXPSortDefinition, AXPSortQuery, AXPMetaData, AXPViewQuery } from '@acorex/platform/core';
 import { AXPMenuItem } from '@acorex/platform/common';
-import { AXValueChangedEvent, AXHtmlEvent, AXEvent } from '@acorex/cdk/common';
+import * as _acorex_cdk_common from '@acorex/cdk/common';
+import { AXValueChangedEvent, AXClickEvent, AXDataSource, AXDataSourceFilterOption, AXOrientation, AXHtmlEvent, AXEvent } from '@acorex/cdk/common';
+import { AXTreeViewComponent, AXTreeItemClickBaseEvent } from '@acorex/components/tree-view';
+import { AXTranslationService } from '@acorex/core/translation';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
-import { AXPWidgetNode, AXPLayoutContextChangeEvent, AXPWidgetProperty, AXPWidgetConfig } from '@acorex/platform/layout/builder';
+import { AXPWidgetNode, AXPWidgetCoreContextChangeEvent, AXPWidgetContainerComponent, AXPWidgetProperty, AXPWidgetConfig } from '@acorex/platform/layout/widget-core';
 import * as _ngrx_signals from '@ngrx/signals';
-import { AXPopupSizeType, AXPopupService } from '@acorex/components/popup';
+import { AXDataTableComponent, AXDataTableRowDbClick, AXDataTableRowClick } from '@acorex/components/data-table';
 import { AXBasePageComponent } from '@acorex/components/page';
+import { AXPopupSizeType, AXPopupService } from '@acorex/components/popup';
+import * as _acorex_platform_layout_components from '@acorex/platform/layout/components';
 import { AXFormComponent } from '@acorex/components/form';
 import { AXPopoverComponent } from '@acorex/components/popover';
 import { AXTagBoxComponent } from '@acorex/components/tag-box';
 import { AXCalendarService } from '@acorex/core/date-time';
-import { AXTranslationService } from '@acorex/core/translation';
+import { AXTabStripChangedEvent, AXTabsComponent } from '@acorex/components/tabs';
 import { Observable } from 'rxjs';
-import { AXTabsComponent, AXTabStripChangedEvent } from '@acorex/components/tabs';
 
 declare class AXPActivityLogComponent {
     private readonly translateService;
@@ -203,6 +207,85 @@ declare class AXPThemeLayoutContainerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPThemeLayoutContainerComponent, "axp-layout-container", never, {}, {}, never, ["*"], true, never>;
 }
 
+interface AXPCategoryTreeNode extends AXPCategoryEntity {
+    children?: AXPCategoryTreeNode[];
+    expand?: boolean;
+    hasChild?: boolean;
+    [key: string]: any;
+}
+interface AXPCategoryTreeConfig {
+    textField?: string;
+    valueField?: string;
+    expandedField?: string;
+    showCheckbox?: boolean;
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    emptyStateTitle?: string;
+    emptyStateDescription?: string;
+    emptyStateIcon?: string;
+}
+interface AXPCategoryTreeEvents {
+    onNodeClick?: (node: AXPCategoryEntity) => void;
+    onNodeSelect?: (node: AXPCategoryEntity) => void;
+    onNodeCreate?: (parentNode?: AXPCategoryEntity) => void;
+    onNodeUpdate?: (node: AXPCategoryEntity) => void;
+    onNodeDelete?: (node: AXPCategoryEntity) => void;
+    onSearchChange?: (searchValue: string) => void;
+    onCollapseChange?: (node: AXPCategoryEntity) => void;
+}
+interface AXPCategoryTreeActions {
+    canCreate?: boolean;
+    canUpdate?: boolean;
+    canDelete?: boolean;
+    canCreateChild?: boolean;
+    createLabel?: string;
+    updateLabel?: string;
+    deleteLabel?: string;
+    createChildLabel?: string;
+}
+interface AXPCategoryTreeDataSource {
+    loadRootNodes: () => Promise<AXPCategoryEntity[]>;
+    loadChildNodes?: (parentId: string) => Promise<AXPCategoryEntity[]>;
+    searchNodes?: (searchValue: string) => Promise<AXPCategoryEntity[]>;
+}
+
+declare class AXPCategoryTreeComponent {
+    protected readonly translationService: AXTranslationService;
+    dataSource: _angular_core.InputSignal<AXPCategoryTreeDataSource>;
+    config: _angular_core.InputSignal<AXPCategoryTreeConfig>;
+    actions: _angular_core.InputSignal<AXPCategoryTreeActions>;
+    events: _angular_core.InputSignal<AXPCategoryTreeEvents>;
+    nodeClick: _angular_core.OutputEmitterRef<AXPCategoryEntity<string>>;
+    nodeSelect: _angular_core.OutputEmitterRef<AXPCategoryEntity<string>>;
+    nodeCreate: _angular_core.OutputEmitterRef<AXPCategoryEntity<string> | undefined>;
+    nodeUpdate: _angular_core.OutputEmitterRef<AXPCategoryEntity<string>>;
+    nodeDelete: _angular_core.OutputEmitterRef<AXPCategoryEntity<string>>;
+    searchChange: _angular_core.OutputEmitterRef<string>;
+    collapseChange: _angular_core.OutputEmitterRef<AXPCategoryEntity<string>>;
+    tree: _angular_core.Signal<AXTreeViewComponent | undefined>;
+    isLoading: _angular_core.WritableSignal<boolean>;
+    searchValue: _angular_core.WritableSignal<string>;
+    protected treeItems: _angular_core.WritableSignal<AXPCategoryTreeNode[]>;
+    protected emptyStateTitle: _angular_core.Signal<string>;
+    protected emptyStateDescription: _angular_core.Signal<string>;
+    ngOnInit(): Promise<void>;
+    loadRootNodes(): Promise<void>;
+    loadChildNodes(parentId: string): Promise<void>;
+    searchNodes(searchValue: string): Promise<void>;
+    handleNodeClick(event: AXTreeItemClickBaseEvent): Promise<void>;
+    handleCollapseChanged(event: AXTreeItemClickBaseEvent): Promise<void>;
+    handleSearchChange(event: AXValueChangedEvent): Promise<void>;
+    handleCreateRootClick(event: AXClickEvent): Promise<void>;
+    handleCreateChildClick(node: AXPCategoryTreeNode, event: AXClickEvent): Promise<void>;
+    handleUpdateNodeClick(node: AXPCategoryTreeNode, event: AXClickEvent): Promise<void>;
+    handleDeleteNodeClick(node: AXPCategoryTreeNode, event: AXClickEvent): Promise<void>;
+    private convertEntitiesToTreeNodes;
+    private updateNodeChildren;
+    refreshTree(parentId?: string): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPCategoryTreeComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPCategoryTreeComponent, "axp-category-tree", never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "events": { "alias": "events"; "required": false; "isSignal": true; }; }, { "nodeClick": "nodeClick"; "nodeSelect": "nodeSelect"; "nodeCreate": "nodeCreate"; "nodeUpdate": "nodeUpdate"; "nodeDelete": "nodeDelete"; "searchChange": "searchChange"; "collapseChange": "collapseChange"; }, never, never, true, never>;
+}
+
 declare class AXPQueryColumnsComponent {
     columns: _angular_core.ModelSignal<AXPColumnQuery[]>;
     handleVisibilityChange(e: AXValueChangedEvent<boolean>, name: string): void;
@@ -357,10 +440,115 @@ declare class AXPComponentSlotModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXPComponentSlotModule>;
 }
 
+interface AXPDataSelectorColumn {
+    name: string;
+    title: string;
+    visible: boolean;
+    widget: {
+        type: string;
+        options: any;
+    };
+}
+interface AXPDataSelectorConfig {
+    title: string;
+    dataSource: AXDataSource<any>;
+    columns: AXPDataSelectorColumn[];
+    selectionMode: 'single' | 'multiple';
+    searchFields?: string[];
+    parentField?: string;
+    allowCreate?: boolean;
+    filters?: AXDataSourceFilterOption;
+    categoryFilter?: {
+        enabled: boolean;
+        title: string;
+        dataSource: AXPCategoryTreeDataSource;
+        filterField: string;
+        filterOperator?: 'equal' | 'contains' | 'in';
+        width?: string;
+    };
+}
+declare class AXPDataSelectorComponent extends AXBasePageComponent {
+    protected config: _angular_core.WritableSignal<AXPDataSelectorConfig>;
+    protected searchTerm: string;
+    protected filter: AXDataSourceFilterOption;
+    protected grid: _angular_core.Signal<AXDataTableComponent | undefined>;
+    protected initialSelectedItems: any[];
+    protected selectedItems: _angular_core.WritableSignal<any[]>;
+    protected activeCategoryFilter: _angular_core.WritableSignal<{
+        node: AXPCategoryEntity;
+        filterValue: any;
+    } | null>;
+    protected allowSelect: _angular_core.Signal<boolean>;
+    protected hasSearch: _angular_core.Signal<boolean | undefined>;
+    protected searchPlaceholder: _angular_core.Signal<string>;
+    protected categoryTreeConfig: _angular_core.Signal<{
+        textField: string;
+        valueField: string;
+        showCheckbox: boolean;
+        searchable: boolean;
+        searchPlaceholder: string;
+        emptyStateTitle: string;
+        emptyStateDescription: string;
+        emptyStateIcon: string;
+    }>;
+    protected categoryTreeActions: _angular_core.Signal<{
+        canCreate: boolean;
+        canUpdate: boolean;
+        canDelete: boolean;
+        canCreateChild: boolean;
+    }>;
+    protected ngOnInit(): void;
+    protected ngAfterViewInit(): void;
+    protected handleRowDbClick(e: AXDataTableRowDbClick): void;
+    protected handleRowClick(e: AXDataTableRowClick): void;
+    protected handleSelectedRowsChange(rows: unknown[]): Promise<void>;
+    protected handleChangeSearchValue(e: AXValueChangedEvent): void;
+    protected handleCreateNewClick(): Promise<void>;
+    protected handleCloseClick(): void;
+    protected handleSelectClick(): void;
+    protected handleExpandRow(row: any): Promise<void>;
+    protected handleCategoryFilterClick(node: AXPCategoryEntity): void;
+    protected clearCategoryFilter(): void;
+    private applySearchFilter;
+    private applyFilterAndSort;
+    private applyCategoryFilter;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDataSelectorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDataSelectorComponent, "axp-data-selector", never, {}, {}, never, never, true, never>;
+}
+
+declare class AXPDataSelectorService {
+    private readonly popupService;
+    private readonly expressionService;
+    /**
+     * Open data selector popup
+     */
+    open(config: AXPDataSelectorConfig): Promise<{
+        items: any[];
+    } | null>;
+    /**
+     * Open data selector with category filter
+     */
+    openWithCategoryFilter(config: Omit<AXPDataSelectorConfig, 'categoryFilter'>, categoryFilterConfig: {
+        title: string;
+        dataSource: AXPCategoryTreeDataSource;
+        filterField: string;
+        filterOperator?: 'equal' | 'contains' | 'in';
+        width?: string;
+    }): Promise<{
+        items: any[];
+    } | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDataSelectorService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPDataSelectorService>;
+}
+
+/**
+ * Form appearance and density styling (using fieldset widget look)
+ */
+type AXPDynamicFormLook = 'fieldset' | 'card' | 'group' | 'container';
 /**
- * Form appearance and density styling
+ * Form rendering mode
  */
-type AXPDynamicFormLook = 'normal' | 'compact' | 'borderless';
+type AXPDynamicFormMode = 'view' | 'edit';
 /**
  * Form layout direction and flow
  */
@@ -370,43 +558,244 @@ interface AXPDynamicFormFieldDefinition {
     title?: string;
     description?: string;
     widget: AXPWidgetNode;
+    /**
+     * Optional per-field rendering mode. Takes precedence over section and form modes.
+     */
+    mode?: AXPDynamicFormMode;
+    layout?: AXPGridLayoutOptions;
 }
 interface AXPDynamicFormGroupDefinition {
     name: string;
     title?: string;
     description?: string;
     parameters: AXPDynamicFormFieldDefinition[];
+    /**
+     * Optional per-section rendering mode. Takes precedence over form mode and is overridden by field mode.
+     */
+    mode?: AXPDynamicFormMode;
 }
 interface AXPDynamicFormDefinition {
     groups: AXPDynamicFormGroupDefinition[];
+    /**
+     * Optional form-level rendering mode
+     */
+    mode?: AXPDynamicFormMode;
 }
-interface AXPDynamicFormLayoutConfig {
-    positions: {
-        default: {
-            colSpan: number;
-        };
-        md?: {
-            colSpan: number;
-        };
-        lg?: {
-            colSpan: number;
-        };
-        xl?: {
-            colSpan: number;
-        };
-        xxl?: {
-            colSpan: number;
-        };
+
+/**
+ * Describes a single step of the dynamic form stepper.
+ * Each step contains one or more groups rendered by AXPDynamicFormComponent.
+ */
+interface AXPDynamicFormStepperStepDefinition {
+    /** Unique identifier for the step */
+    id: string;
+    /** Display title for the step */
+    title?: string;
+    /** Optional descriptive text for the step */
+    description?: string;
+    /** Optional icon name for the step header */
+    icon?: string;
+    /** Field groups to render in this step */
+    groups: AXPDynamicFormGroupDefinition[];
+    /** Optional layout direction override for this step's form */
+    formDirection?: AXPDynamicFormDirection;
+    /** Whether the user may skip this step (defaults to false) */
+    canSkip?: boolean;
+    /** Whether the user may navigate back from this step (defaults to true) */
+    canGoBack?: boolean;
+    /** Optional data path inside the shared context for this step's data */
+    dataPath?: string;
+}
+/**
+ * Root definition for the dynamic form stepper.
+ */
+interface AXPDynamicFormStepperDefinition {
+    /** Ordered collection of steps */
+    steps: AXPDynamicFormStepperStepDefinition[];
+    /** Enforce sequential navigation (no jumping to future steps) */
+    linear?: boolean;
+    /** Show progress indicator above the content */
+    showProgress?: boolean;
+    /** Show step numbers in the header */
+    showStepNumbers?: boolean;
+}
+
+declare class AXPDynamicFormStepperComponent {
+    #private;
+    /**
+     * Stepper definition providing steps metadata and behavior configuration
+     */
+    definition: _angular_core.InputSignal<AXPDynamicFormStepperDefinition>;
+    /**
+     * Shared root context for all steps
+     */
+    context: _angular_core.InputSignal<any>;
+    /**
+     * Optional pass-through layout props for inner forms
+     */
+    layoutLook: _angular_core.InputSignal<AXPDynamicFormLook>;
+    stepperDirection: _angular_core.InputSignal<AXOrientation>;
+    layoutConfig: _angular_core.InputSignal<AXPGridLayoutOptions | undefined>;
+    /**
+     * Optional guard that controls advancing to the next step (async only)
+     */
+    guardNext: _angular_core.InputSignal<((e: {
+        index: number;
+        id: string;
+        fullContext: any;
+    }) => Promise<boolean>) | undefined>;
+    /**
+     * Emits when the shared root context changes
+     */
+    contextChange: _angular_core.OutputEmitterRef<any>;
+    /**
+     * Emits when the active step changes
+     */
+    stepChange: _angular_core.OutputEmitterRef<{
+        index: number;
+        id: string;
+    }>;
+    /**
+     * Emits after successful finish
+     */
+    finished: _angular_core.OutputEmitterRef<any>;
+    /**
+     * Emits when cancelled by API
+     */
+    cancel: _angular_core.OutputEmitterRef<void>;
+    /**
+     * Emits when navigation is blocked by validation or policy
+     */
+    navigationBlocked: _angular_core.OutputEmitterRef<{
+        reason: "invalid" | "linear" | "cannot-skip" | "cannot-go-back";
+        stepId: string;
+        targetIndex?: number;
+    }>;
+    /**
+     * Internal reactive copy of the shared context
+     */
+    private internalContext;
+    /**
+     * Active step index
+     */
+    protected currentStepIndex: _angular_core.WritableSignal<number>;
+    /**
+     * Navigation lock while async guards are pending
+     */
+    private navigationLocked;
+    /**
+     * Reference to underlying step wizard to sync visual navigation
+     */
+    private readonly wizard;
+    /**
+     * References to rendered dynamic forms (usually one active)
+     */
+    private readonly forms;
+    protected steps: _angular_core.Signal<_acorex_platform_layout_components.AXPDynamicFormStepperStepDefinition[]>;
+    protected stepCount: _angular_core.Signal<number>;
+    protected currentStep: _angular_core.Signal<_acorex_platform_layout_components.AXPDynamicFormStepperStepDefinition>;
+    protected isFirstComputed: _angular_core.Signal<boolean>;
+    protected isLastComputed: _angular_core.Signal<boolean>;
+    /**
+     * Non-undefined layout config for inner dynamic forms
+     */
+    protected effectiveLayoutConfig: _angular_core.Signal<AXPGridLayoutOptions>;
+    /**
+     * Returns the current step pointer
+     */
+    getCurrentStep(): {
+        index: number;
+        id: string;
+    };
+    /**
+     * Public helpers for templates/consumers
+     */
+    isFirst(): boolean;
+    isLast(): boolean;
+    /**
+     * Returns the root context
+     */
+    getContext(): any;
+    /**
+     * Replaces the root context programmatically
+     */
+    setContext(ctx: any): void;
+    /**
+     * Validates the current step.
+     */
+    validateCurrentStep(): Promise<boolean>;
+    /**
+     * Attempts to advance to the next step applying validation and guard
+     */
+    next(): Promise<void>;
+    /**
+     * Goes back to the previous step if possible
+     */
+    previous(): Promise<void>;
+    /**
+     * Navigates to a specific step by id or index
+     */
+    goTo(stepIdOrIndex: string | number): Promise<void>;
+    /**
+     * Validates all steps and emits finished when successful
+     */
+    finish(): Promise<void>;
+    /**
+     * Emits cancel event without state changes
+     */
+    cancelFlow(): void;
+    /**
+     * Handle per-step context changes and keep internal root context in sync.
+     */
+    protected onStepContextChange(stepId: string, stepContext: any): void;
+    /**
+     * Exposes reading a step slice to the template
+     */
+    readStepSlice(path?: string): {
+        slice: any;
+        exists: boolean;
     };
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDynamicFormStepperComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDynamicFormStepperComponent, "axp-dynamic-form-stepper", never, { "definition": { "alias": "definition"; "required": true; "isSignal": true; }; "context": { "alias": "context"; "required": true; "isSignal": true; }; "layoutLook": { "alias": "layoutLook"; "required": false; "isSignal": true; }; "stepperDirection": { "alias": "stepperDirection"; "required": false; "isSignal": true; }; "layoutConfig": { "alias": "layoutConfig"; "required": false; "isSignal": true; }; "guardNext": { "alias": "guardNext"; "required": false; "isSignal": true; }; }, { "contextChange": "contextChange"; "stepChange": "stepChange"; "finished": "finished"; "cancel": "cancel"; "navigationBlocked": "navigationBlocked"; }, never, never, true, never>;
 }
 
 interface AXPDynamicDialogConfig {
     title: string;
     message?: string;
-    formDefinition: AXPDynamicFormDefinition;
+    /**
+     * Legacy: If provided, dialog renders only dynamic-form.
+     */
+    formDefinition?: AXPDynamicFormDefinition;
+    /**
+     * Preferred definition: dynamic form (no steps or single step) or a multi-step stepper definition.
+     */
+    definition?: AXPDynamicFormDefinition | AXPDynamicFormStepperDefinition;
+    /**
+     * Shared context passed to the rendered control
+     */
     context: any;
-    layoutConfig?: AXPDynamicFormLayoutConfig;
+    /**
+     * Shared layout options applied to form/stepper unless overridden
+     */
+    layoutConfig?: AXPGridLayoutOptions;
+    layoutLook?: AXPDynamicFormLook;
+    mode?: AXPDynamicFormMode;
     size?: AXPopupSizeType;
+    closeButton?: boolean;
+    /**
+     * Optional stepper-only options. Ignored when rendering dynamic-form.
+     */
+    stepper?: {
+        guardNext?: (e: {
+            index: number;
+            id: string;
+            fullContext: unknown;
+        }) => Promise<boolean>;
+        stepperDirection?: AXOrientation;
+    };
+    /**
+     * Footer actions. In stepper mode, footer is replaced by Prev/Next/Confirm.
+     */
     actions?: {
         footer?: {
             prefix?: AXPActionMenuItem[];
@@ -418,44 +807,82 @@ interface AXPDynamicDialogResult {
     context: any;
     action?: string;
 }
+interface AXPDialogRef {
+    /**
+     * Manually close the dialog (optional - dialog closes automatically after user interaction)
+     */
+    close(): void;
+    /**
+     * Get the form data from the dialog
+     */
+    context(): any;
+    /**
+     * Get the action that was clicked by the user
+     */
+    action(): string | undefined;
+    /**
+     * Set the loading state of the dialog
+     */
+    setLoading(loading: boolean): void;
+}
 
 declare class AXPDynamicDialogComponent extends AXBasePageComponent {
     config: AXPDynamicDialogConfig;
     private readonly dynamicForm;
+    protected readonly stepper: _angular_core.Signal<AXPDynamicFormStepperComponent | undefined>;
     isSubmitting: _angular_core.WritableSignal<boolean>;
     private previousContext;
     private formData;
+    dialogResult: AXPDynamicDialogResult | null;
+    isSubmittingFromDialog: boolean;
+    data: any;
+    callBack: (dialogRef: AXPDialogRef) => void;
     /**
      * Form context for widget container
      */
     protected formContext: _angular_core.Signal<Record<string, any>>;
-    protected defaultLayout: () => {
-        positions: {
-            default: {
-                colSpan: number;
-            };
-            md: {
-                colSpan: number;
-            };
-            lg: {
-                colSpan: number;
-            };
-            xl: {
-                colSpan: number;
-            };
-            xxl: {
-                colSpan: number;
-            };
-        };
-    };
+    /**
+     * Combined loading state from both signal and dialog
+     */
+    protected isFormLoading: _angular_core.Signal<boolean>;
+    protected defaultLayout: () => AXPGridLayoutOptions;
+    /**
+     * Determine rendering mode and effective definitions
+     */
+    protected readonly hasLegacyForm: _angular_core.Signal<boolean>;
+    protected readonly providedDefinition: _angular_core.Signal<_acorex_platform_layout_components.AXPDynamicFormDefinition | _acorex_platform_layout_components.AXPDynamicFormStepperDefinition | undefined>;
+    protected readonly providedMode: _angular_core.Signal<_acorex_platform_layout_components.AXPDynamicFormMode>;
+    protected readonly isStepperDefinition: _angular_core.Signal<boolean>;
+    protected readonly shouldRenderForm: _angular_core.Signal<boolean>;
+    protected readonly effectiveFormDefinition: _angular_core.Signal<any>;
+    protected readonly resolvedFormDefinition: _angular_core.Signal<any>;
+    protected readonly effectiveLayoutLook: _angular_core.Signal<_acorex_platform_layout_components.AXPDynamicFormLook>;
+    protected readonly effectiveLayoutConfig: _angular_core.Signal<AXPGridLayoutOptions>;
+    protected readonly stepperGuardNext: _angular_core.Signal<((e: {
+        index: number;
+        id: string;
+        fullContext: unknown;
+    }) => Promise<boolean>) | undefined>;
+    protected readonly stepperDirection: _angular_core.Signal<_acorex_cdk_common.AXOrientation>;
+    protected readonly stepperDefinition: _angular_core.Signal<any>;
+    stepperIsFirst: _angular_core.Signal<boolean>;
+    stepperIsLast: _angular_core.Signal<boolean>;
+    /**
+     * Effective form direction when rendering dynamic-form (single-step or legacy form).
+     * If a single-step definition is provided and that step specifies formDirection, use it.
+     */
+    protected readonly effectiveFormDirection: _angular_core.Signal<AXPDynamicFormDirection>;
     /**
      * Footer actions for dynamic button system
      */
     protected footerPrefixActions: _angular_core.Signal<AXPActionMenuItem[]>;
     protected footerSuffixActions: _angular_core.Signal<AXPActionMenuItem[]>;
+    protected visibleFooterPrefixActions: _angular_core.Signal<AXPActionMenuItem[]>;
+    protected visibleFooterSuffixActions: _angular_core.Signal<AXPActionMenuItem[]>;
     protected hasFooterActions: _angular_core.Signal<boolean>;
-    protected hasVisibleFooterPrefixActions: _angular_core.Signal<boolean>;
-    protected hasVisibleFooterSuffixActions: _angular_core.Signal<boolean>;
+    /** Stepper footer: choose a single confirm action from provided suffix actions (first visible). */
+    protected confirmAction: _angular_core.Signal<AXPActionMenuItem | undefined>;
+    protected confirmActionTitle: _angular_core.Signal<string>;
     ngOnInit(): void;
     protected handleContextInitiated(context: any): void;
     protected handleContextChanged(context: any): void;
@@ -471,6 +898,9 @@ declare class AXPDynamicDialogComponent extends AXBasePageComponent {
      * Check if form is valid
      */
     protected isFormValid(): Promise<boolean>;
+    /** Stepper navigation handlers */
+    protected goPrev(): void;
+    protected goNext(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDynamicDialogComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDynamicDialogComponent, "axp-dynamic-dialog", never, { "config": { "alias": "config"; "required": true; }; }, {}, never, never, true, never>;
 }
@@ -480,19 +910,25 @@ declare class AXPDynamicDialogService {
     /**
      * Show a dynamic dialog with the given configuration
      * @param config Dialog configuration including fields, validation, and UI options
-     * @returns Promise resolving to dialog result with form values and cancellation status
+     * @returns Promise resolving to dialog reference for controlling the dialog
      */
-    showDialog(config: AXPDynamicDialogConfig): Promise<AXPDynamicDialogResult>;
+    showDialog(config: AXPDynamicDialogConfig): Promise<AXPDialogRef>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDynamicDialogService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPDynamicDialogService>;
 }
 
 declare class AXPDynamicFormComponent implements OnInit {
     #private;
+    private evaluatorService;
+    private formBuilderService;
+    /**
+     * Tracks the latest scheduled evaluation to ensure last-write-wins for async evaluate
+     */
+    private evaluationRunId;
     /**
-     * Form definition containing groups and fields
+     * Form definition containing groups and fields OR widget tree
      */
-    formDefinition: _angular_core.InputSignal<AXPDynamicFormDefinition>;
+    data: _angular_core.InputSignal<AXPWidgetNode | AXPDynamicFormDefinition>;
     /**
      * Form context/model data
      */
@@ -502,13 +938,23 @@ declare class AXPDynamicFormComponent implements OnInit {
      */
     layoutLook: _angular_core.InputSignal<AXPDynamicFormLook>;
     /**
-     * Form layout direction and flow (vertical, horizontal, grid)
+     * Default form mode. Can be overridden by section/group and field.
+     */
+    mode: _angular_core.InputSignal<AXPDynamicFormMode>;
+    /**
+     * Convert input data to widget tree
+     */
+    private convertToWidgetTree;
+    protected widgetTree: _angular_core.WritableSignal<AXPWidgetNode | null>;
+    /**
+     * Convert and evaluate data when inputs change
      */
-    layoutDirection: _angular_core.InputSignal<AXPDynamicFormDirection>;
+    conversionEffect: _angular_core.EffectRef;
+    protected expressionEvaluator(expression: any, context: any): Promise<any>;
     /**
-     * Custom layout configuration for form fields
+     * Apply layout look to all fieldset widgets in the widget tree
      */
-    layoutConfig: _angular_core.InputSignal<AXPDynamicFormLayoutConfig>;
+    private applyLayoutLookToWidgetTree;
     /**
      * Emitted when form context changes
      */
@@ -528,23 +974,22 @@ declare class AXPDynamicFormComponent implements OnInit {
      */
     protected internalContext: _angular_core.WritableSignal<any>;
     /**
-     * Computed layout configuration
-     */
-    protected computedLayout: _angular_core.Signal<AXPDynamicFormLayoutConfig>;
-    /**
-     * Host classes based on layout look and direction
+     * Host classes based on layout look and mode
      */
     protected hostClasses: _angular_core.Signal<string>;
     ngOnInit(): void;
     /**
      * Handle context change events from widget container
      */
-    protected handleContextChanged(event: AXPLayoutContextChangeEvent): void;
-    protected isRequired(param: AXPDynamicFormFieldDefinition): boolean;
+    protected handleContextChanged(event: AXPWidgetCoreContextChangeEvent): void;
     /**
      * Get the form component instance
      */
     getForm(): AXFormComponent | undefined;
+    /**
+     * Get the widget container component instance
+     */
+    getContainer(): AXPWidgetContainerComponent | undefined;
     /**
      * Get current form context
      */
@@ -553,12 +998,514 @@ declare class AXPDynamicFormComponent implements OnInit {
      * Update form context programmatically
      */
     updateContext(context: any): void;
+    /**
+     * Get the current widget tree
+     */
+    getWidgetTree(): AXPWidgetNode | null;
     /**
      * Validate the form
      */
     validate(): Promise<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDynamicFormComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDynamicFormComponent, "axp-dynamic-form", never, { "formDefinition": { "alias": "formDefinition"; "required": true; "isSignal": true; }; "context": { "alias": "context"; "required": true; "isSignal": true; }; "layoutLook": { "alias": "layoutLook"; "required": false; "isSignal": true; }; "layoutDirection": { "alias": "layoutDirection"; "required": false; "isSignal": true; }; "layoutConfig": { "alias": "layoutConfig"; "required": false; "isSignal": true; }; }, { "contextChange": "contextChange"; "contextInitiated": "contextInitiated"; "validityChange": "validityChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDynamicFormComponent, "axp-dynamic-form", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "context": { "alias": "context"; "required": true; "isSignal": true; }; "layoutLook": { "alias": "layoutLook"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, { "contextChange": "contextChange"; "contextInitiated": "contextInitiated"; "validityChange": "validityChange"; }, never, never, true, never>;
+}
+
+interface TextBoxOptions {
+    placeholder?: string;
+    maxLength?: number;
+    minLength?: number;
+    mask?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    validations?: AXPValidationRules;
+}
+interface LargeTextBoxOptions {
+    placeholder?: string;
+    maxLength?: number;
+    minLength?: number;
+    rows?: number;
+    disabled?: boolean;
+    readonly?: boolean;
+    validations?: AXPValidationRules;
+}
+interface RichTextOptions {
+    placeholder?: string;
+    toolbar?: string[];
+    height?: number;
+    disabled?: boolean;
+    readonly?: boolean;
+    validations?: AXPValidationRules;
+}
+interface SelectBoxOptions<TItem extends Record<string, unknown> = Record<string, unknown>> {
+    valueField: keyof TItem & string;
+    textField: keyof TItem & string;
+    dataSource: TItem[];
+    multiple?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    allowSearch?: boolean;
+    validations?: AXPValidationRules;
+}
+interface LookupBoxOptions {
+    entity: string;
+    multiple?: boolean;
+    expose?: Array<{
+        source: string;
+        target: string;
+    }>;
+    placeholder?: string;
+    textField?: string;
+    valueField?: string;
+    look?: string;
+    columns?: string[];
+    allowClear?: boolean;
+    disabled?: boolean;
+    readonly?: boolean;
+    validations?: AXPValidationRules;
+}
+interface NumberBoxOptions {
+    minValue?: number;
+    maxValue?: number;
+    step?: number;
+    format?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    validations?: AXPValidationRules;
+}
+interface DateTimeBoxOptions {
+    format?: string;
+    min?: Date;
+    max?: Date;
+    showTime?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    validations?: AXPValidationRules;
+}
+interface ToggleSwitchOptions {
+    onText?: string;
+    offText?: string;
+    validations?: AXPValidationRules;
+}
+interface PasswordBoxOptions {
+    placeholder?: string;
+    maxLength?: number;
+    minLength?: number;
+    showToggle?: boolean;
+    validations?: AXPValidationRules;
+}
+interface SelectionListOptions<TItem extends Record<string, unknown> = Record<string, unknown>> {
+    valueField: keyof TItem & string;
+    textField: keyof TItem & string;
+    dataSource: TItem[];
+    multiple?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    validations?: AXPValidationRules;
+}
+interface ColorBoxOptions {
+    defaultColor?: string;
+    showAlpha?: boolean;
+    disabled?: boolean;
+    readonly?: boolean;
+    validations?: AXPValidationRules;
+}
+interface IFieldOptions {
+    hidden?: string | boolean;
+    readonly?: string | boolean;
+    disabled?: string | boolean;
+    defaultValue?: any;
+}
+interface IFieldBuilder {
+    title(title: string): IFieldBuilder;
+    description(description: string): IFieldBuilder;
+    mode(mode: AXPDynamicFormMode): IFieldBuilder;
+    options(values: IFieldOptions): IFieldBuilder;
+    layout(layout: AXPGridLayoutOptions | number): IFieldBuilder;
+    textBox(options?: TextBoxOptions): IFieldBuilder;
+    largeTextBox(options?: LargeTextBoxOptions): IFieldBuilder;
+    richText(options?: RichTextOptions): IFieldBuilder;
+    passwordBox(options?: PasswordBoxOptions): IFieldBuilder;
+    selectBox(options: SelectBoxOptions): IFieldBuilder;
+    lookupBox(options: LookupBoxOptions): IFieldBuilder;
+    selectionList(options: SelectionListOptions): IFieldBuilder;
+    numberBox(options?: NumberBoxOptions): IFieldBuilder;
+    dateTimeBox(options?: DateTimeBoxOptions): IFieldBuilder;
+    toggleSwitch(options?: ToggleSwitchOptions): IFieldBuilder;
+    colorBox(options?: ColorBoxOptions): IFieldBuilder;
+    widget(type: string, options?: unknown): IFieldBuilder;
+}
+interface IGroupBuilder {
+    title(title: string): IGroupBuilder;
+    description(description: string): IGroupBuilder;
+    mode(mode: AXPDynamicFormMode): IGroupBuilder;
+    field(path: string, delegate?: (field: IFieldBuilder) => void): IGroupBuilder;
+    group(name: string, delegate?: (group: IGroupBuilder) => void): IGroupBuilder;
+}
+interface IStepBuilder {
+    title(title: string): IStepBuilder;
+    description(description: string): IStepBuilder;
+    icon(icon: string): IStepBuilder;
+    group(name: string, delegate?: (group: IGroupBuilder) => void): IStepBuilder;
+}
+interface IFormBuilder {
+    group(name: string, delegate?: (group: IGroupBuilder) => void): IFormBuilder;
+    layout(config: Partial<AXPGridLayoutOptions>): IFormBuilder;
+    look(look: AXPDynamicFormLook): IFormBuilder;
+    mode(mode: AXPDynamicFormMode): IFormBuilder;
+    build(): AXPDynamicFormDefinition;
+    export(): AXPWidgetNode;
+    import(widgetTree: AXPWidgetNode): IFormBuilder;
+}
+interface IActionBuilder {
+    cancel(text?: string): IActionBuilder;
+    submit(text?: string): IActionBuilder;
+    custom(action: AXPActionMenuItem): IActionBuilder;
+}
+interface IDialogBuilder extends IFormBuilder {
+    group(name: string, delegate?: (group: IGroupBuilder) => void): IDialogBuilder;
+    layout(config: Partial<AXPGridLayoutOptions>): IDialogBuilder;
+    look(look: AXPDynamicFormLook): IDialogBuilder;
+    closeButton(closeButton: boolean): IDialogBuilder;
+    step(id: string, delegate?: (step: IStepBuilder) => void): IDialogBuilder;
+    stepperDirection(direction: AXOrientation): IDialogBuilder;
+    guardNext(guard: (e: {
+        index: number;
+        id: string;
+        fullContext: unknown;
+    }) => Promise<boolean>): IDialogBuilder;
+    title(title: string): IDialogBuilder;
+    message(message?: string): IDialogBuilder;
+    size(size: AXPopupSizeType): IDialogBuilder;
+    context(context: AXPContextData): IDialogBuilder;
+    actions(delegate?: (actions: IActionBuilder) => void): IDialogBuilder;
+    show(): Promise<AXPDialogRef>;
+}
+interface FormBuilderState {
+    groups: AXPDynamicFormGroupDefinition[];
+    layoutConfig: AXPGridLayoutOptions;
+    look: AXPDynamicFormLook;
+    mode?: AXPDynamicFormMode;
+}
+interface DialogBuilderState extends FormBuilderState {
+    title?: string;
+    message?: string;
+    size?: AXPopupSizeType;
+    context?: AXPContextData;
+    steps: StepBuilderState[];
+    stepperDirection?: AXOrientation;
+    closeButton?: boolean;
+    guardNext?: (e: {
+        index: number;
+        id: string;
+        fullContext: unknown;
+    }) => Promise<boolean>;
+    actions?: {
+        footer?: {
+            prefix?: AXPActionMenuItem[];
+            suffix?: AXPActionMenuItem[];
+        };
+    };
+}
+interface FieldBuilderState {
+    path: string;
+    title?: string;
+    description?: string;
+    defaultValue?: any;
+    hidden?: string | boolean;
+    readonly?: string | boolean;
+    disabled?: string | boolean;
+    widget?: AXPWidgetNode;
+    layout?: AXPGridLayoutOptions;
+    mode?: AXPDynamicFormMode;
+}
+interface GroupBuilderState {
+    name: string;
+    title?: string;
+    description?: string;
+    parameters: AXPDynamicFormFieldDefinition[];
+    mode?: AXPDynamicFormMode;
+}
+interface StepBuilderState {
+    id: string;
+    title?: string;
+    description?: string;
+    icon?: string;
+    groups: AXPDynamicFormGroupDefinition[];
+}
+
+declare class AXPDynamicFormBuilderService {
+    private readonly dialogService;
+    private widgetTreeCache;
+    private formDefinitionCache;
+    /**
+     * Create a new form builder
+     */
+    form(): IFormBuilder;
+    /**
+     * Export form definition to AXPWidgetNode
+     */
+    exportFormDefinition(formDefinition: AXPDynamicFormDefinition): AXPWidgetNode;
+    /**
+     * Import form definition from AXPWidgetNode
+     */
+    importFormDefinition(widgetTree: AXPWidgetNode): AXPDynamicFormDefinition;
+    /**
+     * Export widget tree to AXPWidgetNode (deep clone)
+     */
+    exportWidgetTree(widgetTree: AXPWidgetNode): AXPWidgetNode;
+    /**
+     * Import widget tree from AXPWidgetNode (with validation)
+     */
+    importWidgetTree(widgetTree: AXPWidgetNode): AXPWidgetNode;
+    /**
+     * Create a new dialog builder
+     */
+    dialog(): IDialogBuilder;
+    /**
+     * Convert AXPDynamicFormDefinition to AXPWidgetNode tree structure
+     * Groups become Grid Layouts with Grid Items
+     * Fields become Form Field widgets with Editor widgets as children
+     */
+    serializeToWidgetTree(formDefinition: AXPDynamicFormDefinition): AXPWidgetNode;
+    /**
+     * Convert AXPWidgetNode tree back to AXPDynamicFormDefinition
+     * Parses Grid Layouts back to Groups
+     * Parses Form Field widgets back to Fields
+     */
+    deserializeFromWidgetTree(widgetTree: AXPWidgetNode): AXPDynamicFormDefinition;
+    /**
+     * Validate that a widget tree represents a valid dynamic form structure
+     */
+    validateFormWidgetTree(widgetTree: AXPWidgetNode): boolean;
+    /**
+     * Convert a single group to Fieldset widget structure
+     */
+    private createGroupAsFieldsetWidget;
+    /**
+     * Convert fields to Form Field widgets
+     */
+    private createFieldWidgets;
+    /**
+     * Convert a single field to Form Field widget with editor as child
+     */
+    private createFormFieldWidget;
+    /**
+     * Extract group information from Grid Layout widget
+     */
+    private extractGroupFromFieldset;
+    /**
+     * Extract field information from Form Field widget
+     */
+    private extractFieldFromFormWidget;
+    /**
+     * Create cache key for form definition
+     */
+    private createFormDefinitionCacheKey;
+    /**
+     * Create cache key for widget tree
+     */
+    private createWidgetTreeCacheKey;
+    /**
+     * Clear all caches
+     */
+    clearCaches(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        widgetTreeCacheSize: number;
+        formDefinitionCacheSize: number;
+    };
+    /**
+     * Create a simple hash from a string
+     */
+    private createSimpleHash;
+    /**
+     * Validate widget tree structure recursively
+     */
+    private validateWidgetTreeStructure;
+    /**
+     * Deep clone AXPWidgetNode
+     */
+    private deepCloneWidgetNode;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDynamicFormBuilderService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPDynamicFormBuilderService>;
+}
+
+interface AXPDynamicFormDesignerField {
+    id: string;
+    name: string;
+    title: string;
+    description?: string;
+    widget: AXPWidgetNode;
+    mode?: 'view' | 'edit';
+    layout?: AXPGridLayoutOptions;
+    validations?: Array<{
+        rule: string;
+        options?: Record<string, any>;
+    }>;
+}
+interface AXPDynamicFormDesignerGroup {
+    id: string;
+    name: string;
+    title?: string;
+    description?: string;
+    fields: AXPDynamicFormDesignerField[];
+    mode?: 'view' | 'edit';
+    layout?: AXPGridLayoutOptions;
+}
+interface AXPDynamicFormDesignerState {
+    groups: AXPDynamicFormDesignerGroup[];
+    selectedFieldId?: string;
+    selectedGroupId?: string;
+    mode: 'designer' | 'preview';
+}
+/**
+ * Convert designer field to form field definition
+ */
+declare function convertDesignerFieldToFormField(field: AXPDynamicFormDesignerField): AXPDynamicFormFieldDefinition;
+/**
+ * Convert designer group to form group definition
+ */
+declare function convertDesignerGroupToFormGroup(group: AXPDynamicFormDesignerGroup): AXPDynamicFormGroupDefinition;
+/**
+ * Convert designer state to form definition
+ */
+declare function convertDesignerStateToFormDefinition(state: AXPDynamicFormDesignerState): AXPDynamicFormDefinition;
+interface AXPFormElementWidget {
+    name: string;
+    title: string;
+    icon?: string;
+    description?: string;
+    type: string;
+    properties?: any[];
+}
+
+declare class AXPDynamicFormDesignerComponent {
+    formDefinition: _angular_core.ModelSignal<AXPDynamicFormDefinition>;
+    readonly: _angular_core.InputSignal<boolean>;
+    private isInternalUpdate;
+    private readonly widgetRegistry;
+    private readonly formBuilderService;
+    private readonly widgetPropertyViewerService;
+    private readonly dialogService;
+    protected selectedFieldId: _angular_core.WritableSignal<string | null>;
+    private designerState;
+    protected availableWidgets: _angular_core.Signal<AXPFormElementWidget[]>;
+    protected widgetOptions: _angular_core.Signal<{
+        value: string;
+        text: string;
+    }[]>;
+    protected getAllFields: _angular_core.Signal<AXPDynamicFormDesignerField[]>;
+    protected designerGroups: _angular_core.Signal<AXPDynamicFormDesignerGroup[]>;
+    /**
+     * Effect to log form definition changes
+     */
+    private logFormDefinitionChanges;
+    /**
+     * Effect to sync form definition model to designer state
+     */
+    private syncModelToDesigner;
+    /**
+     * Effect to sync designer state changes back to model
+     */
+    private syncDesignerToModel;
+    /**
+     * Get the current form definition (converted from designer state)
+     */
+    getFormDefinition(): AXPDynamicFormDefinition;
+    /**
+     * Set the form definition (converted to designer state)
+     */
+    setFormDefinition(definition: AXPDynamicFormDefinition): void;
+    /**
+     * Add a new field to the form
+     * @param field The field to add
+     */
+    addField(field: AXPDynamicFormDesignerField): void;
+    /**
+     * Update an existing field
+     * @param fieldId The ID of the field to update
+     * @param updates The updates to apply
+     */
+    updateField(fieldId: string, updates: Partial<AXPDynamicFormDesignerField>): void;
+    /**
+     * Remove a field from the form
+     * @param fieldId The ID of the field to remove
+     */
+    removeField(fieldId: string): void;
+    /**
+     * Get all available widget types
+     */
+    getAvailableWidgets(): AXPFormElementWidget[];
+    /**
+     * Add a new group to the form
+     * @param group The group to add
+     */
+    addGroup(group: AXPDynamicFormDesignerGroup): void;
+    /**
+     * Remove a group from the form
+     * @param groupName The name of the group to remove
+     */
+    removeGroup(groupName: string): void;
+    /**
+     * Reorder groups in the form
+     * @param fromIndex Source index
+     * @param toIndex Target index
+     */
+    reorderGroups(fromIndex: number, toIndex: number): void;
+    /**
+     * Update an existing group
+     * @param groupName The name of the group to update
+     * @param updates The updates to apply
+     */
+    updateGroup(groupName: string, updates: Partial<AXPDynamicFormDesignerGroup>): void;
+    /**
+     * Move a field to a different group
+     * @param fieldName The name/path of the field to move
+     * @param targetGroupName The name of the target group
+     */
+    moveFieldToGroup(fieldName: string, targetGroupName: string): void;
+    protected handleAddGroupClick(): Promise<void>;
+    protected handleAddFieldToGroup(group: AXPDynamicFormDesignerGroup): Promise<void>;
+    protected handleFieldEdit(field: AXPDynamicFormDesignerField): Promise<void>;
+    protected handleFieldRemove(field: AXPDynamicFormDesignerField): void;
+    protected handleGroupEdit(group: AXPDynamicFormDesignerGroup): Promise<void>;
+    protected handleGroupLayoutEdit(group: AXPDynamicFormDesignerGroup): Promise<void>;
+    protected handleGroupRemove(group: AXPDynamicFormDesignerGroup): void;
+    /**
+     * Handle field layout editing
+     */
+    protected handleFieldLayoutEdit(field: AXPDynamicFormDesignerField, group: AXPDynamicFormDesignerGroup): Promise<void>;
+    protected handleGroupDrop(event: CdkDragDrop<AXPDynamicFormDesignerGroup[]>): void;
+    protected handleFieldDrop(event: CdkDragDrop<AXPDynamicFormDesignerField[]>, targetGroupName?: string): void;
+    protected handlePreviewClick(): Promise<void>;
+    protected deriveKey(input: string): string;
+    protected generateId(): string;
+    protected getWidgetIcon(widgetName: string): string;
+    protected getWidgetTitle(widgetName: string): string;
+    protected getWidgetNode(field: AXPDynamicFormDesignerField): AXPWidgetNode;
+    protected deriveGroupKey(input: string): string;
+    protected getGroupOptions(): Array<{
+        value: string;
+        text: string;
+    }>;
+    protected addFieldToGroup(field: AXPDynamicFormDesignerField, groupName: string): void;
+    protected getAllGroupDropLists(): string[];
+    /**
+     * Get the grid column count for a group (always 12 columns)
+     */
+    protected getGroupColumnCount(): number;
+    /**
+     * Get default field grid layout based on group configuration
+     */
+    protected getFieldGridLayout(group: AXPDynamicFormDesignerGroup, fieldIndex?: number): AXPGridLayoutOptions;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDynamicFormDesignerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDynamicFormDesignerComponent, "axp-dynamic-form-designer", never, { "formDefinition": { "alias": "formDefinition"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, { "formDefinition": "formDefinitionChange"; }, never, never, true, never>;
 }
 
 /**
@@ -599,8 +1546,8 @@ declare const AXP_EXTRA_PROPERTY_TYPES: InjectionToken<AXPExtraPropertyType[]>;
 
 declare class AXPExtraPropertiesComponent {
     items: _angular_core.InputSignal<AXPExtraPropertyItem[]>;
-    mode: _angular_core.InputSignal<"edit" | "view">;
-    protected onContextChanged(event: AXPLayoutContextChangeEvent): void;
+    mode: _angular_core.InputSignal<"view" | "edit">;
+    protected onContextChanged(event: AXPWidgetCoreContextChangeEvent): void;
     itemsChange: _angular_core.OutputEmitterRef<AXPExtraPropertyItem[]>;
     private readonly providedTypes;
     private readonly translationService;
@@ -640,7 +1587,7 @@ declare class AXPExtraPropertiesComponent {
 
 declare class AXPExtraPropertiesSchemaComponent {
     schema: _angular_core.InputSignal<AXPExtraPropertySchemaItem[]>;
-    mode: _angular_core.InputSignal<"edit" | "view">;
+    mode: _angular_core.InputSignal<"view" | "edit">;
     schemaChange: _angular_core.OutputEmitterRef<AXPExtraPropertySchemaItem[]>;
     private readonly providedTypes;
     private readonly translationService;
@@ -671,13 +1618,13 @@ declare class AXPExtraPropertiesSchemaComponent {
 declare class AXPExtraPropertiesValuesComponent {
     schema: _angular_core.InputSignal<AXPExtraPropertySchemaItem[]>;
     values: _angular_core.InputSignal<Record<string, any>>;
-    mode: _angular_core.InputSignal<"edit" | "view">;
+    mode: _angular_core.InputSignal<"view" | "edit">;
     valuesChange: _angular_core.OutputEmitterRef<Record<string, any>>;
     isRequired: (item: AXPExtraPropertySchemaItem) => any;
     protected internalContext: _angular_core.WritableSignal<Record<string, any>>;
     private nodeCache;
     private lastTypeByKey;
-    protected onContextChanged(event: AXPLayoutContextChangeEvent): void;
+    protected onContextChanged(event: AXPWidgetCoreContextChangeEvent): void;
     private readonly syncContextFromInputs;
     private readonly clearOnSchemaTypeChange;
     protected getNode(item: AXPExtraPropertySchemaItem): AXPWidgetNode;
@@ -712,7 +1659,7 @@ declare class AXPQueryFiltersComponent {
     ngOnInit(): void;
     handleSelectField(field: AXPFilterDefinition): void;
     handleFieldKeyDown(e: KeyboardEvent, field: AXPFilterDefinition): void;
-    onContextChanged(e: AXPLayoutContextChangeEvent): void;
+    onContextChanged(e: AXPWidgetCoreContextChangeEvent): void;
     handleApplyFilter(): void;
     handleButtonKeyDown(e: Event): void;
     handleKeyDown(e: AXHtmlEvent<KeyboardEvent>): void;
@@ -727,6 +1674,116 @@ declare class AXPQueryFiltersComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPQueryFiltersComponent, "axp-query-filters", never, { "filtersDefinitions": { "alias": "filtersDefinitions"; "required": false; "isSignal": true; }; "initialFilters": { "alias": "initialFilters"; "required": false; "isSignal": true; }; }, { "onFiltersChanged": "onFiltersChanged"; }, never, never, true, never>;
 }
 
+declare class AXPImageEditorPopupComponent extends AXBasePageComponent {
+    private readonly fileStorage;
+    image: _angular_core.InputSignal<Blob>;
+    showHistory: _angular_core.InputSignal<boolean>;
+    look: _angular_core.InputSignal<"solid" | "outline" | "blank">;
+    private container;
+    private blobUrl;
+    protected url: _angular_core.WritableSignal<string | null>;
+    protected context: _angular_core.WritableSignal<{
+        image: Blob | null;
+    }>;
+    ngOnInit(): Promise<void>;
+    handleValueChanged(e: any): void;
+    handleSave(): void;
+    handleCancel(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPImageEditorPopupComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPImageEditorPopupComponent, "axp-image-editor-popup", never, { "image": { "alias": "image"; "required": true; "isSignal": true; }; "showHistory": { "alias": "showHistory"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+interface AXPImageEditorOpenOptions {
+    title?: string;
+    image: Blob;
+    showHistory?: boolean;
+    look?: 'solid' | 'outline' | 'blank';
+}
+declare class AXPImageEditorService {
+    private readonly popupService;
+    private readonly translate;
+    open(options?: AXPImageEditorOpenOptions): Promise<Blob | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPImageEditorService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPImageEditorService>;
+}
+
+interface AXPWidgetPropertyTab {
+    name: string;
+    title: string;
+    groups: {
+        name: string;
+        title: string;
+        isCollapsed: boolean;
+        props: AXPWidgetProperty[];
+    }[];
+}
+interface AXPWidgetPropertiesChangedEvent {
+    values: any;
+    mode: 'init' | 'update';
+}
+declare class AXPWidgetPropertyViewerComponent {
+    widget: _angular_core.InputSignal<AXPWidgetNode>;
+    mode: _angular_core.InputSignal<"simple" | "advanced">;
+    private widgetRegistryService;
+    protected currentTabIndex: WritableSignal<number>;
+    protected config: WritableSignal<AXPWidgetConfig<any> | null>;
+    protected allPoperties: AXPWidgetProperty[];
+    protected tabs: WritableSignal<AXPWidgetPropertyTab[]>;
+    protected groups: _angular_core.Signal<{
+        name: string;
+        title: string;
+        isCollapsed: boolean;
+        props: AXPWidgetProperty[];
+    }[]>;
+    protected groupCollapsedStates: Map<string, boolean>;
+    onChanged: EventEmitter<AXPWidgetPropertiesChangedEvent>;
+    protected context: WritableSignal<any>;
+    protected initialContext: any;
+    constructor();
+    update(values: any): void;
+    private fillTabs;
+    protected handleContextChange(e: AXPWidgetCoreContextChangeEvent): void;
+    protected handleTabChange(event: AXTabStripChangedEvent): void;
+    protected handleCollapsedChange(group: string, collapsed: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetPropertyViewerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetPropertyViewerComponent, "axp-widget-property-viewer", never, { "widget": { "alias": "widget"; "required": true; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, { "onChanged": "onChanged"; }, never, never, true, never>;
+}
+
+declare class AXPWidgetPropertyViewerPopupComponent extends AXBasePageComponent {
+    widget: _angular_core.InputSignal<AXPWidgetNode>;
+    mode: _angular_core.InputSignal<"simple" | "advanced">;
+    protected currentValues: _angular_core.WritableSignal<any>;
+    protected handlePropertyChanged(event: {
+        values: any;
+        mode: 'init' | 'update';
+    }): void;
+    protected handleCloseClick(): void;
+    protected handleApplyClick(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetPropertyViewerPopupComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetPropertyViewerPopupComponent, "axp-widget-property-viewer-popup", never, { "widget": { "alias": "widget"; "required": true; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+interface AXPWidgetPropertyViewerConfig {
+    title: string;
+    widget: AXPWidgetNode;
+    mode?: 'simple' | 'advanced';
+    size?: 'sm' | 'md' | 'lg' | 'full';
+}
+interface AXPWidgetPropertyViewerResult {
+    values: any;
+    mode: 'init' | 'update';
+}
+declare class AXPWidgetPropertyViewerService {
+    private readonly popupService;
+    /**
+     * Open widget property viewer popup
+     */
+    open(config: AXPWidgetPropertyViewerConfig): Promise<AXPWidgetPropertyViewerResult | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetPropertyViewerService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetPropertyViewerService>;
+}
+
 declare class AXPQuerySortsComponent {
     sortDefinitions: _angular_core.ModelSignal<AXPSortDefinition[]>;
     sortQueries: _angular_core.WritableSignal<AXPSortQuery[]>;
@@ -740,6 +1797,17 @@ declare class AXPQuerySortsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPQuerySortsComponent, "axp-query-sorts", never, { "sortDefinitions": { "alias": "sortDefinitions"; "required": false; "isSignal": true; }; "initialSortQueries": { "alias": "initialSortQueries"; "required": false; "isSignal": true; }; }, { "sortDefinitions": "sortDefinitionsChange"; "sortQueriesChange": "sortQueriesChange"; }, never, never, true, never>;
 }
 
+type StateMode = 'empty' | 'error' | 'loading' | 'warning' | 'info' | 'success';
+declare class AXPStateMessageComponent {
+    mode: _angular_core.InputSignal<StateMode>;
+    icon: _angular_core.InputSignal<string>;
+    title: _angular_core.InputSignal<string>;
+    description: _angular_core.InputSignal<string>;
+    variant: _angular_core.InputSignal<"default" | "compact" | "minimal">;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPStateMessageComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPStateMessageComponent, "axp-state-message", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[slot=actions]"], true, never>;
+}
+
 interface AXPTemplateViewerConfig {
     template: AXPWidgetNode | string;
     title?: string;
@@ -765,7 +1833,7 @@ declare class AXPTemplateViewerComponent extends AXBasePageComponent {
     protected readonly currentPage: _angular_core.Signal<AXPWidgetNode>;
     protected ngOnInit(): Promise<void>;
     private loadTemplate;
-    protected handleContextChanged(e: AXPLayoutContextChangeEvent): void;
+    protected handleContextChanged(e: AXPWidgetCoreContextChangeEvent): void;
     protected handleSubmit(form: AXFormComponent): Promise<void>;
     protected handleCancel(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPTemplateViewerComponent, never>;
@@ -956,47 +2024,5 @@ declare class AXPWidgetItemComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetItemComponent, "axp-widget-item", never, { "widget": { "alias": "widget"; "required": true; "isSignal": true; }; "isSelected": { "alias": "isSelected"; "required": false; "isSignal": true; }; "showPinButton": { "alias": "showPinButton"; "required": false; "isSignal": true; }; "customClasses": { "alias": "customClasses"; "required": false; "isSignal": true; }; }, { "onWidgetClick": "onWidgetClick"; "onPinClick": "onPinClick"; }, never, never, true, never>;
 }
 
-interface AXPWidgetPropertyTab {
-    name: string;
-    title: string;
-    groups: {
-        name: string;
-        title: string;
-        isCollapsed: boolean;
-        props: AXPWidgetProperty[];
-    }[];
-}
-interface AXPWidgetPropertiesChangedEvent {
-    values: any;
-    mode: 'init' | 'update';
-}
-declare class AXPWidgetPropertyViewerComponent {
-    widget: _angular_core.InputSignal<AXPWidgetNode>;
-    mode: _angular_core.InputSignal<"simple" | "advanced">;
-    private widgetRegistryService;
-    protected currentTabIndex: WritableSignal<number>;
-    protected config: WritableSignal<AXPWidgetConfig<any> | null>;
-    protected allPoperties: AXPWidgetProperty[];
-    protected tabs: WritableSignal<AXPWidgetPropertyTab[]>;
-    protected groups: _angular_core.Signal<{
-        name: string;
-        title: string;
-        isCollapsed: boolean;
-        props: AXPWidgetProperty[];
-    }[]>;
-    protected groupCollapsedStates: Map<string, boolean>;
-    onChanged: EventEmitter<AXPWidgetPropertiesChangedEvent>;
-    protected context: WritableSignal<any>;
-    protected initialContext: any;
-    constructor();
-    update(values: any): void;
-    private fillTabs;
-    protected handleContextChange(e: AXPLayoutContextChangeEvent): void;
-    protected handleTabChange(event: AXTabStripChangedEvent): void;
-    protected handleCollapsedChange(group: string, collapsed: boolean): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetPropertyViewerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetPropertyViewerComponent, "axp-widget-property-viewer", never, { "widget": { "alias": "widget"; "required": true; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, { "onChanged": "onChanged"; }, never, never, true, never>;
-}
-
-export { AXPActivityLogComponent, AXPCompareViewComponent, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPDynamicDialogComponent, AXPDynamicDialogService, AXPDynamicFormComponent, AXPExtraPropertiesComponent, AXPExtraPropertiesSchemaComponent, AXPExtraPropertiesValuesComponent, AXPMenuBadgeHelper, AXPQueryColumnsComponent, AXPQueryFiltersComponent, AXPQuerySortsComponent, AXPQueryViewsComponent, AXPTaskBadgeDirective, AXPTaskBadgeProvider, AXPTaskBadgeService, AXPTemplateViewerComponent, AXPTemplateViewerService, AXPThemeLayoutActionsComponent, AXPThemeLayoutBlockComponent, AXPThemeLayoutContainerComponent, AXPThemeLayoutEndSideComponent, AXPThemeLayoutFooterComponent, AXPThemeLayoutHeaderComponent, AXPThemeLayoutListComponent, AXPThemeLayoutListItemComponent, AXPThemeLayoutListItemsGroupComponent, AXPThemeLayoutPageHeaderComponent, AXPThemeLayoutPagePrimaryActionsComponent, AXPThemeLayoutPageSecondaryActionsComponent, AXPThemeLayoutSectionComponent, AXPThemeLayoutStartSideComponent, AXPThemeLayoutToolbarComponent, AXPUserAvatarComponent, AXPUserAvatarService, AXPWidgetItemComponent, AXPWidgetPropertyViewerComponent, AXP_EXTRA_PROPERTY_TYPES, AXP_TASK_BADGE_PROVIDERS, AXP_USER_AVATAR_PROVIDER };
-export type { AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPDynamicDialogConfig, AXPDynamicDialogResult, AXPDynamicFormDefinition, AXPDynamicFormDirection, AXPDynamicFormFieldDefinition, AXPDynamicFormGroupDefinition, AXPDynamicFormLayoutConfig, AXPDynamicFormLook, AXPExtraPropertyItem, AXPExtraPropertySchemaItem, AXPExtraPropertyType, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyTab };
+export { AXPActivityLogComponent, AXPCategoryTreeComponent, AXPCompareViewComponent, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPDataSelectorComponent, AXPDataSelectorService, AXPDynamicDialogComponent, AXPDynamicDialogService, AXPDynamicFormBuilderService, AXPDynamicFormComponent, AXPDynamicFormDesignerComponent, AXPDynamicFormStepperComponent, AXPExtraPropertiesComponent, AXPExtraPropertiesSchemaComponent, AXPExtraPropertiesValuesComponent, AXPImageEditorPopupComponent, AXPImageEditorService, AXPMenuBadgeHelper, AXPQueryColumnsComponent, AXPQueryFiltersComponent, AXPQuerySortsComponent, AXPQueryViewsComponent, AXPStateMessageComponent, AXPTaskBadgeDirective, AXPTaskBadgeProvider, AXPTaskBadgeService, AXPTemplateViewerComponent, AXPTemplateViewerService, AXPThemeLayoutActionsComponent, AXPThemeLayoutBlockComponent, AXPThemeLayoutContainerComponent, AXPThemeLayoutEndSideComponent, AXPThemeLayoutFooterComponent, AXPThemeLayoutHeaderComponent, AXPThemeLayoutListComponent, AXPThemeLayoutListItemComponent, AXPThemeLayoutListItemsGroupComponent, AXPThemeLayoutPageHeaderComponent, AXPThemeLayoutPagePrimaryActionsComponent, AXPThemeLayoutPageSecondaryActionsComponent, AXPThemeLayoutSectionComponent, AXPThemeLayoutStartSideComponent, AXPThemeLayoutToolbarComponent, AXPUserAvatarComponent, AXPUserAvatarService, AXPWidgetItemComponent, AXPWidgetPropertyViewerComponent, AXPWidgetPropertyViewerPopupComponent, AXPWidgetPropertyViewerService, AXP_EXTRA_PROPERTY_TYPES, AXP_TASK_BADGE_PROVIDERS, AXP_USER_AVATAR_PROVIDER, convertDesignerFieldToFormField, convertDesignerGroupToFormGroup, convertDesignerStateToFormDefinition };
+export type { AXPCategoryTreeActions, AXPCategoryTreeConfig, AXPCategoryTreeDataSource, AXPCategoryTreeEvents, AXPCategoryTreeNode, AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDialogRef, AXPDynamicDialogConfig, AXPDynamicDialogResult, AXPDynamicFormDefinition, AXPDynamicFormDesignerField, AXPDynamicFormDesignerGroup, AXPDynamicFormDesignerState, AXPDynamicFormDirection, AXPDynamicFormFieldDefinition, AXPDynamicFormGroupDefinition, AXPDynamicFormLook, AXPDynamicFormMode, AXPDynamicFormStepperDefinition, AXPDynamicFormStepperStepDefinition, AXPExtraPropertyItem, AXPExtraPropertySchemaItem, AXPExtraPropertyType, AXPFormElementWidget, AXPImageEditorOpenOptions, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyTab, AXPWidgetPropertyViewerConfig, AXPWidgetPropertyViewerResult, ColorBoxOptions, DateTimeBoxOptions, DialogBuilderState, FieldBuilderState, FormBuilderState, GroupBuilderState, IActionBuilder, IDialogBuilder, IFieldBuilder, IFieldOptions, IFormBuilder, IGroupBuilder, IStepBuilder, LargeTextBoxOptions, LookupBoxOptions, NumberBoxOptions, PasswordBoxOptions, RichTextOptions, SelectBoxOptions, SelectionListOptions, StateMode, StepBuilderState, TextBoxOptions, ToggleSwitchOptions };