@acorex/platform 20.3.0-next.8 → 20.3.0-next.9

package/layout/components/index.d.ts

@@ -1,22 +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, AXPValidationRules, AXPFilterDefinition, AXPFilterQuery, AXPSortDefinition, AXPSortQuery, AXPMetaData, AXPViewQuery } from '@acorex/platform/core';
+import { AXPActivityLog, AXPSystemActionType, AXPCategoryEntity, AXPColumnQuery, AXPContextData, AXPOptionsData, AXPActionMenuItem, AXPExecuteCommand, AXPValidationRules, AXPFilterDefinition, AXPFilterQuery, AXPSortDefinition, AXPSortQuery, AXPMetaData, AXPViewQuery } from '@acorex/platform/core';
 import { AXPMenuItem } from '@acorex/platform/common';
-import { AXValueChangedEvent, AXDataSource, AXDataSourceFilterOption, 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 * as _ngrx_signals from '@ngrx/signals';
 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;
@@ -204,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;
@@ -375,6 +457,14 @@ interface AXPDataSelectorConfig {
     searchFields?: string[];
     parentField?: string;
     allowCreate?: boolean;
+    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>;
@@ -383,9 +473,29 @@ declare class AXPDataSelectorComponent extends AXBasePageComponent {
     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;
@@ -396,8 +506,11 @@ declare class AXPDataSelectorComponent extends AXBasePageComponent {
     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>;
 }
@@ -411,9 +524,15 @@ declare class AXPDataSelectorService {
         items: any[];
     } | null>;
     /**
-     * Open data selector for meta data selection
+     * Open data selector with category filter
      */
-    openMetaDataSelector(dataSource: any): Promise<{
+    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>;
@@ -433,6 +552,18 @@ interface AXPDynamicFormFieldDefinition {
     title?: string;
     description?: string;
     widget: AXPWidgetNode;
+    /**
+     * Optional per-parameter layout override. Takes precedence over form layoutConfig.
+     * - number: colSpan for all breakpoints
+     * - object: colSpan per breakpoint
+     */
+    layout?: number | {
+        default?: number;
+        md?: number;
+        lg?: number;
+        xl?: number;
+        xxl?: number;
+    };
 }
 interface AXPDynamicFormGroupDefinition {
     name: string;
@@ -463,13 +594,219 @@ interface AXPDynamicFormLayoutConfig {
     };
 }
 
+/**
+ * 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<AXPDynamicFormLayoutConfig | 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<AXPDynamicFormLayoutConfig>;
+    /**
+     * 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;
+    /**
+     * Shared layout options applied to form/stepper unless overridden
+     */
     layoutConfig?: AXPDynamicFormLayoutConfig;
+    layoutLook?: AXPDynamicFormLook;
     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[];
@@ -503,6 +840,7 @@ interface AXPDialogRef {
 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;
@@ -537,14 +875,42 @@ declare class AXPDynamicDialogComponent extends AXBasePageComponent {
             };
         };
     };
+    /**
+     * 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 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<_acorex_platform_layout_components.AXPDynamicFormLayoutConfig>;
+    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;
@@ -560,6 +926,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>;
 }
@@ -578,6 +947,15 @@ declare class AXPDynamicDialogService {
 
 declare class AXPDynamicFormComponent implements OnInit {
     #private;
+    private evaluatorService;
+    /**
+     * Tracks the latest scheduled evaluation to ensure last-write-wins for async evaluate
+     */
+    private evaluationRunId;
+    /**
+     * Memoization cache for resolveParamLayout to keep stable object identities
+     */
+    private layoutCache;
     /**
      * Form definition containing groups and fields
      */
@@ -598,6 +976,12 @@ declare class AXPDynamicFormComponent implements OnInit {
      * Custom layout configuration for form fields
      */
     layoutConfig: _angular_core.InputSignal<AXPDynamicFormLayoutConfig>;
+    protected expressionEvaluator(expression: any, context: any): Promise<any>;
+    protected evaluatedFormDefinition: _angular_core.WritableSignal<any>;
+    /**
+     * Evaluate definition when inputs change with last-write-wins and deep-equality guard
+     */
+    eff: _angular_core.EffectRef;
     /**
      * Emitted when form context changes
      */
@@ -620,6 +1004,10 @@ declare class AXPDynamicFormComponent implements OnInit {
      * Computed layout configuration
      */
     protected computedLayout: _angular_core.Signal<AXPDynamicFormLayoutConfig>;
+    /**
+     * Resolve effective grid layout for a specific parameter, merging per-parameter override with form layout.
+     */
+    protected resolveParamLayout(param: AXPDynamicFormFieldDefinition): AXPDynamicFormLayoutConfig;
     /**
      * Host classes based on layout look and direction
      */
@@ -684,6 +1072,7 @@ interface SelectBoxOptions<TItem extends Record<string, unknown> = Record<string
     placeholder?: string;
     disabled?: boolean;
     readonly?: boolean;
+    allowSearch?: boolean;
     validations?: AXPValidationRules;
 }
 interface LookupBoxOptions {
@@ -752,10 +1141,17 @@ interface ColorBoxOptions {
     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;
-    defaultValue(value: any): IFieldBuilder;
+    options(values: IFieldOptions): IFieldBuilder;
+    layout(layout: AXPDynamicFormFieldDefinition['layout']): IFieldBuilder;
     textBox(options?: TextBoxOptions): IFieldBuilder;
     largeTextBox(options?: LargeTextBoxOptions): IFieldBuilder;
     richText(options?: RichTextOptions): IFieldBuilder;
@@ -770,9 +1166,18 @@ interface IFieldBuilder {
     widget(type: string, options?: unknown): IFieldBuilder;
 }
 interface IGroupBuilder {
+    title(title: string): IGroupBuilder;
+    description(description: string): 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;
+    direction(direction: AXPDynamicFormDirection): IStepBuilder;
+    group(name: string, delegate?: (group: IGroupBuilder) => void): IStepBuilder;
+}
 interface IFormBuilder {
     group(name: string, delegate?: (group: IGroupBuilder) => void): IFormBuilder;
     layout(config: Partial<AXPDynamicFormLayoutConfig>): IFormBuilder;
@@ -787,6 +1192,17 @@ interface IActionBuilder {
 }
 interface IDialogBuilder extends IFormBuilder {
     group(name: string, delegate?: (group: IGroupBuilder) => void): IDialogBuilder;
+    layout(config: Partial<AXPDynamicFormLayoutConfig>): IDialogBuilder;
+    look(look: AXPDynamicFormLook): IDialogBuilder;
+    direction(direction: AXPDynamicFormDirection): 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;
@@ -805,6 +1221,14 @@ interface DialogBuilderState extends FormBuilderState {
     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[];
@@ -817,7 +1241,11 @@ interface FieldBuilderState {
     title?: string;
     description?: string;
     defaultValue?: any;
+    hidden?: string | boolean;
+    readonly?: string | boolean;
+    disabled?: string | boolean;
     widget?: AXPWidgetNode;
+    layout?: AXPDynamicFormFieldDefinition['layout'];
 }
 interface GroupBuilderState {
     name: string;
@@ -825,6 +1253,14 @@ interface GroupBuilderState {
     description?: string;
     parameters: AXPDynamicFormFieldDefinition[];
 }
+interface StepBuilderState {
+    id: string;
+    title?: string;
+    description?: string;
+    icon?: string;
+    formDirection?: AXPDynamicFormDirection;
+    groups: AXPDynamicFormGroupDefinition[];
+}
 
 declare class AXPDynamicFormBuilderService {
     private readonly dialogService;
@@ -840,6 +1276,17 @@ declare class AXPDynamicFormBuilderService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPDynamicFormBuilderService>;
 }
 
+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>;
+}
+
 /**
  * Describes a schema-only definition for an extra property (no value).
  */
@@ -1006,6 +1453,48 @@ 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>;
 }
 
+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>;
+}
+
 declare class AXPQuerySortsComponent {
     sortDefinitions: _angular_core.ModelSignal<AXPSortDefinition[]>;
     sortQueries: _angular_core.WritableSignal<AXPSortQuery[]>;
@@ -1235,47 +1724,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, AXPDataSelectorComponent, AXPDataSelectorService, AXPDynamicDialogComponent, AXPDynamicDialogService, AXPDynamicFormBuilderService, 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, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDialogRef, AXPDynamicDialogConfig, AXPDynamicDialogResult, AXPDynamicFormDefinition, AXPDynamicFormDirection, AXPDynamicFormFieldDefinition, AXPDynamicFormGroupDefinition, AXPDynamicFormLayoutConfig, AXPDynamicFormLook, AXPExtraPropertyItem, AXPExtraPropertySchemaItem, AXPExtraPropertyType, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyTab, ColorBoxOptions, DateTimeBoxOptions, DialogBuilderState, FieldBuilderState, FormBuilderState, GroupBuilderState, IActionBuilder, IDialogBuilder, IFieldBuilder, IFormBuilder, IGroupBuilder, LargeTextBoxOptions, LookupBoxOptions, NumberBoxOptions, PasswordBoxOptions, RichTextOptions, SelectBoxOptions, SelectionListOptions, TextBoxOptions, ToggleSwitchOptions };
+export { AXPActivityLogComponent, AXPCategoryTreeComponent, AXPCompareViewComponent, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPDataSelectorComponent, AXPDataSelectorService, AXPDynamicDialogComponent, AXPDynamicDialogService, AXPDynamicFormBuilderService, AXPDynamicFormComponent, AXPDynamicFormStepperComponent, AXPExtraPropertiesComponent, AXPExtraPropertiesSchemaComponent, AXPExtraPropertiesValuesComponent, 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, AXP_EXTRA_PROPERTY_TYPES, AXP_TASK_BADGE_PROVIDERS, AXP_USER_AVATAR_PROVIDER };
+export type { AXPCategoryTreeActions, AXPCategoryTreeConfig, AXPCategoryTreeDataSource, AXPCategoryTreeEvents, AXPCategoryTreeNode, AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDialogRef, AXPDynamicDialogConfig, AXPDynamicDialogResult, AXPDynamicFormDefinition, AXPDynamicFormDirection, AXPDynamicFormFieldDefinition, AXPDynamicFormGroupDefinition, AXPDynamicFormLayoutConfig, AXPDynamicFormLook, AXPDynamicFormStepperDefinition, AXPDynamicFormStepperStepDefinition, AXPExtraPropertyItem, AXPExtraPropertySchemaItem, AXPExtraPropertyType, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyTab, ColorBoxOptions, DateTimeBoxOptions, DialogBuilderState, FieldBuilderState, FormBuilderState, GroupBuilderState, IActionBuilder, IDialogBuilder, IFieldBuilder, IFieldOptions, IFormBuilder, IGroupBuilder, IStepBuilder, LargeTextBoxOptions, LookupBoxOptions, NumberBoxOptions, PasswordBoxOptions, RichTextOptions, SelectBoxOptions, SelectionListOptions, StateMode, StepBuilderState, TextBoxOptions, ToggleSwitchOptions };