@acorex/platform 20.7.8 → 20.7.9

package/layout/builder/index.d.ts

@@ -417,7 +417,7 @@ interface ILayoutBuilder {
     page(delegate: (container: IPageContainerBuilder) => void): ILayoutBuilder;
     tabset(delegate: (container: ITabsetContainerBuilder) => void): ILayoutBuilder;
     fieldset(delegate: (container: IFieldsetContainerBuilder) => void): ILayoutBuilder;
-    dialog(delegate: (container: IDialogBuilder) => void): IDialogBuilder;
+    dialog<T = AXPDialogRef>(delegate: (container: IDialogBuilder<T>) => void): IDialogBuilder<T>;
     stepWizard(delegate: (wizard: IStepWizardBuilder) => void): ILayoutBuilder;
     build(): AXPWidgetNode;
     toJson(options?: {
@@ -564,20 +564,26 @@ interface IFieldsetContainerBuilder extends IBaseContainerBuilder<IFieldsetConta
     setCols(cols: number): IFieldsetContainerBuilder;
     formField(label: string, delegate?: (field: IFormFieldBuilder) => void): IFieldsetContainerBuilder;
 }
-interface IDialogBuilder {
-}
-interface IDialogBuilder {
-    setOptions(options: AXPDialogContainerOptions): IDialogBuilder;
-    setTitle(title: string): IDialogBuilder;
-    setMessage(message?: string): IDialogBuilder;
-    setSize(size: AXPopupSizeType): IDialogBuilder;
-    setCloseButton(closeButton: boolean): IDialogBuilder;
-    setContext(context: any): IDialogBuilder;
-    content(delegate: (layoutBuilder: IFlexContainerBuilder) => void): IDialogBuilder;
-    setActions(delegate?: (actions: IActionBuilder) => void): IDialogBuilder;
-    addCustomAction(action: AXPActionMenuItem): IDialogBuilder;
+interface IDialogBuilder<T = AXPDialogRef> {
+}
+interface IDialogBuilder<T = AXPDialogRef> {
+    setOptions(options: AXPDialogContainerOptions): IDialogBuilder<T>;
+    setTitle(title: string): IDialogBuilder<T>;
+    setMessage(message?: string): IDialogBuilder<T>;
+    setSize(size: AXPopupSizeType): IDialogBuilder<T>;
+    setCloseButton(closeButton: boolean): IDialogBuilder<T>;
+    setContext(context: any): IDialogBuilder<T>;
+    content(delegate: (layoutBuilder: IFlexContainerBuilder) => void): IDialogBuilder<T>;
+    setActions(delegate?: (actions: IActionBuilder) => void): IDialogBuilder<T>;
+    /**
+     * Handler invoked when user clicks an action. Receives AXPDialogRef (context, action, setLoading, close).
+     * If handler throws, dialog stays open for retry.
+     * If handler returns, dialog closes and show() resolves with the return value.
+     */
+    onAction(handler: (dialogRef: AXPDialogRef) => T | Promise<T>): IDialogBuilder<T>;
+    addCustomAction(action: AXPActionMenuItem): IDialogBuilder<T>;
     build(): AXPWidgetNode;
-    show(): Promise<AXPDialogRef>;
+    show(): Promise<T>;
 }
 interface IListWidgetBuilder extends IBaseContainerBuilder<IListWidgetBuilder>, ILayoutContainerBuilder<IListWidgetBuilder>, IChildContainerBuilder<IListWidgetBuilder>, IWidgetContainerBuilder<IListWidgetBuilder> {
     setOptions(options: AXPListWidgetOptions): IListWidgetBuilder;
@@ -821,6 +827,11 @@ interface DialogRendererConfig {
             suffix?: any[];
         };
     };
+    /**
+     * When present, handler is called on action click with AXPDialogRef.
+     * Throw = stay open for retry. Return = close and resolve show() with return value.
+     */
+    onAction?: (dialogRef: AXPDialogRef) => any | Promise<any>;
 }
 interface DialogRendererResult {
     context: any;

package/layout/components/index.d.ts

@@ -8,6 +8,7 @@ import { AXTreeViewLegacyComponent, AXTreeItemClickBaseEventLegacy } from '@acor
 import { AXTranslationService } from '@acorex/core/translation';
 import { AXPopoverComponent } from '@acorex/components/popover';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
+import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
 import { AXPWidgetNode, AXPWidgetRendererDirective, AXPWidgetCoreContextChangeEvent, AXPWidgetProperty, AXPWidgetConfig } from '@acorex/platform/layout/widget-core';
 import * as _ngrx_signals from '@ngrx/signals';
 import { AXDataTableComponent, AXDataTableRowDbClick, AXDataTableRowClick } from '@acorex/components/data-table';
@@ -15,10 +16,14 @@ import { AXBasePageComponent } from '@acorex/components/page';
 import { AXDropListDroppedEvent } from '@acorex/cdk/drag-drop';
 import { AXTagBoxComponent } from '@acorex/components/tag-box';
 import { AXCalendarService } from '@acorex/core/date-time';
+import { AXTreeViewNode, AXTreeViewDragBehavior, AXTreeViewDragArea, AXTreeViewComponent, AXTreeViewBeforeDropEvent, AXTreeViewDropEvent } from '@acorex/components/tree-view';
+import { AXDialogService } from '@acorex/components/dialog';
+import { AXToastService } from '@acorex/components/toast';
 import { AXTabStripChangedEvent, AXTabsComponent } from '@acorex/components/tabs';
 import { AXFormComponent } from '@acorex/components/form';
 import { AXPopupSizeType, AXPopupService } from '@acorex/components/popup';
 import { Observable } from 'rxjs';
+import { AXSelectBoxComponent } from '@acorex/components/select-box';
 
 declare class AXPActivityLogComponent {
     private readonly translateService;
@@ -765,6 +770,191 @@ declare class AXPImageEditorService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPImageEditorService>;
 }
 
+/**
+ * Menu item interface for customizer
+ */
+interface AXPMenuCustomizerItem {
+    name?: string;
+    text?: string;
+    icon?: string;
+    path?: string;
+    type?: 'menu' | 'group' | 'break';
+    priority?: number;
+    description?: string;
+    children?: AXPMenuCustomizerItem[];
+}
+/**
+ * Metadata for menu tree nodes
+ */
+interface AXPMenuCustomizerNodeMetadata {
+    isBuiltIn: boolean;
+    isCustom: boolean;
+    isHidden: boolean;
+    originalPriority?: number;
+    originalParentName?: string;
+}
+/**
+ * Data structure for tree node combining menu item with metadata
+ */
+interface AXPMenuCustomizerNodeData {
+    menuItem: AXPMenuCustomizerItem;
+    metadata: AXPMenuCustomizerNodeMetadata;
+}
+/**
+ * Available actions that can be performed on menu items
+ */
+type AXPMenuCustomizerAction = 'show' | 'hide' | 'edit' | 'delete' | 'add-child' | 'move';
+/**
+ * Abstract service interface for menu customization operations.
+ * Implement this interface and provide it via AXP_MENU_CUSTOMIZER_SERVICE token.
+ */
+declare abstract class AXPMenuCustomizerService {
+    /**
+     * Get menu tree nodes for the given scope key
+     */
+    abstract getMenuTree(scopeKey: string): Promise<AXTreeViewNode[]>;
+    /**
+     * Sync tree changes (reorder, move) to storage
+     */
+    abstract syncTreeChanges(scopeKey: string, treeNodes: AXTreeViewNode[]): Promise<void>;
+    /**
+     * Show a hidden menu item
+     */
+    abstract showMenuItem(scopeKey: string, menuName: string): Promise<void>;
+    /**
+     * Hide a menu item
+     */
+    abstract hideMenuItem(scopeKey: string, menuName: string): Promise<void>;
+    /**
+     * Add a custom menu item
+     */
+    abstract addCustomMenuItem(scopeKey: string, menuItem: AXPMenuCustomizerItem, parentName: string | null): Promise<void>;
+    /**
+     * Update a custom menu item
+     */
+    abstract updateCustomMenuItem(scopeKey: string, menuName: string, menuItem: AXPMenuCustomizerItem): Promise<void>;
+    /**
+     * Update menu item properties (for built-in items)
+     */
+    abstract updateMenuProperties(scopeKey: string, menuName: string, properties: Partial<AXPMenuCustomizerItem>): Promise<void>;
+    /**
+     * Delete a custom menu item
+     */
+    abstract deleteCustomMenuItem(scopeKey: string, menuName: string): Promise<void>;
+    /**
+     * Reset all customizations for the scope
+     */
+    abstract resetCustomizations(scopeKey: string): Promise<void>;
+}
+/**
+ * Injection token for menu customizer service
+ */
+declare const AXP_MENU_CUSTOMIZER_SERVICE: InjectionToken<AXPMenuCustomizerService>;
+
+/**
+ * Reusable menu customizer component that allows users to reorder, show/hide,
+ * and manage menu items using a tree-like interface.
+ * Can be used standalone or within popups/dialogs.
+ *
+ * Requires providing AXP_MENU_CUSTOMIZER_SERVICE with an implementation of AXPMenuCustomizerService.
+ */
+declare class AXPMenuCustomizerComponent implements OnInit, OnDestroy {
+    private menuCustomizerService;
+    private layoutBuilder;
+    protected dialogService: AXDialogService;
+    protected toastService: AXToastService;
+    private translationService;
+    /** The scope key for loading/saving menu customizations (e.g., 'edition:{id}', 'tenant:{id}') */
+    scopeKey: _angular_core.InputSignal<string>;
+    /** Whether to show the toolbar with collapse/expand/reset actions */
+    showToolbar: _angular_core.InputSignal<boolean>;
+    /** Whether to allow adding custom menu items */
+    allowAddItems: _angular_core.InputSignal<boolean>;
+    /** Drag behavior for the tree view: 'none' | 'move' | 'copy' */
+    dragBehavior: _angular_core.InputSignal<AXTreeViewDragBehavior>;
+    /** Drag area for the tree view: 'node' | 'handler' */
+    dragArea: _angular_core.InputSignal<AXTreeViewDragArea>;
+    /** Emitted when changes are saved */
+    saved: _angular_core.OutputEmitterRef<void>;
+    /** Emitted when the customizer is closed/cancelled */
+    cancelled: _angular_core.OutputEmitterRef<void>;
+    protected tree: _angular_core.Signal<AXTreeViewComponent | undefined>;
+    protected treeNodes: _angular_core.WritableSignal<AXTreeViewNode[]>;
+    protected isLoading: _angular_core.WritableSignal<boolean>;
+    protected error: _angular_core.WritableSignal<string>;
+    private isSyncing;
+    private destroy$;
+    ngOnInit(): Promise<void>;
+    ngOnDestroy(): void;
+    /**
+     * Handle before drop validation
+     */
+    handleBeforeDrop(e: AXTreeViewBeforeDropEvent): Promise<void>;
+    /**
+     * Handle after drop event to sync changes
+     * The event contains information about the moved node and its new position
+     */
+    handleAfterDrop(event: AXTreeViewDropEvent): Promise<void>;
+    /**
+     * Load menu tree for current scope
+     */
+    loadMenuItems(): Promise<void>;
+    /**
+     * Sync tree changes to backend
+     */
+    private syncTreeChanges;
+    /**
+     * Collapse all tree nodes
+     */
+    collapseAll(): void;
+    /**
+     * Expand all tree nodes
+     */
+    expandAll(): void;
+    /**
+     * Reset all customizations
+     */
+    resetCustomizations(): Promise<void>;
+    /**
+     * Add new root menu item
+     */
+    addRootMenuItem(): Promise<void>;
+    /**
+     * Handle menu item action
+     */
+    protected onAction(action: AXPMenuCustomizerAction, nodeData: AXPMenuCustomizerNodeData): Promise<void>;
+    /**
+     * Add new child menu item
+     */
+    protected addChildMenuItem(parentNodeData: AXPMenuCustomizerNodeData): Promise<void>;
+    /**
+     * Show menu item
+     */
+    private showMenuItem;
+    /**
+     * Hide menu item
+     */
+    private hideMenuItem;
+    /**
+     * Edit menu item
+     */
+    private editMenuItem;
+    /**
+     * Delete custom menu item
+     */
+    private deleteMenuItem;
+    /**
+     * Show menu item dialog (add/edit)
+     */
+    private showMenuItemDialog;
+    /**
+     * Execute a menu action with common error handling
+     */
+    private executeMenuAction;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMenuCustomizerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPMenuCustomizerComponent, "axp-menu-customizer", never, { "scopeKey": { "alias": "scopeKey"; "required": true; "isSignal": true; }; "showToolbar": { "alias": "showToolbar"; "required": false; "isSignal": true; }; "allowAddItems": { "alias": "allowAddItems"; "required": false; "isSignal": true; }; "dragBehavior": { "alias": "dragBehavior"; "required": false; "isSignal": true; }; "dragArea": { "alias": "dragArea"; "required": false; "isSignal": true; }; }, { "saved": "saved"; "cancelled": "cancelled"; }, never, never, true, never>;
+}
+
 /**
  * Represents a spreadsheet item (row or column header) with id, text, and optional description
  */
@@ -1293,6 +1483,101 @@ declare class AXPStopwatchComponent implements OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPStopwatchComponent, "axp-stopwatch", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "timeLimit": { "alias": "timeLimit"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "autoStart": { "alias": "autoStart"; "required": false; "isSignal": true; }; "showControls": { "alias": "showControls"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "timeUp": "timeUp"; }, never, never, true, never>;
 }
 
+/**
+ * Builds the AXPWidgetNode tree for the table-columns-editor when using AXPLayoutRendererComponent.
+ * Root: repeater-layout (path: 'columns') with add/remove controls.
+ * Each row: form-field for name (text-editor), form-field for title (text-editor), form-field for widget (widget-field-configurator).
+ */
+declare function buildTableColumnsEditorLayout(): AXPWidgetNode;
+
+/**
+ * Definition for a single table column (name, title, widget).
+ * Used by table-columns-editor and table-data-editor.
+ */
+interface AXPTableColumnDefinition {
+    name: string;
+    title: string;
+    widget: AXPWidgetNode;
+}
+
+declare class AXPTableColumnsEditorPopupComponent extends AXBasePageComponent {
+    protected readonly I18N: {
+        readonly title: "@general:widgets.table-columns-editor.popup-title";
+        readonly cancel: "@general:actions.cancel.title";
+        readonly save: "@general:actions.save.title";
+    };
+    columns: _angular_core.InputSignal<AXPTableColumnDefinition[]>;
+    localColumns: _angular_core.ModelSignal<AXPTableColumnDefinition[]>;
+    constructor();
+    protected handleCancel(): void;
+    protected handleSave(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPTableColumnsEditorPopupComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPTableColumnsEditorPopupComponent, "axp-table-columns-editor-popup", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "localColumns": { "alias": "localColumns"; "required": false; "isSignal": true; }; }, { "localColumns": "localColumnsChange"; }, never, never, true, never>;
+}
+
+declare class AXPTableColumnsEditorComponent {
+    /** Layout tree: repeater (path: columns) with form-fields for name, title, widget. */
+    protected readonly columnsEditorLayout: _angular_core.WritableSignal<_acorex_platform_layout_widget_core.AXPWidgetNode>;
+    /** Two-way: list of column definitions (synced with editorContext.columns). */
+    columns: _angular_core.ModelSignal<AXPTableColumnDefinition[]>;
+    /** Context for the layout renderer; must hold { columns: AXPTableColumnDefinition[] }. */
+    protected readonly editorContext: _angular_core.ModelSignal<{
+        columns: AXPTableColumnDefinition[];
+    }>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPTableColumnsEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPTableColumnsEditorComponent, "axp-table-columns-editor", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "editorContext": { "alias": "editorContext"; "required": false; "isSignal": true; }; }, { "columns": "columnsChange"; "editorContext": "editorContextChange"; }, never, never, true, never>;
+}
+
+interface AXPTableColumnsEditorOpenOptions {
+    title?: string;
+    columns?: AXPTableColumnDefinition[];
+}
+declare class AXPTableColumnsEditorService {
+    private readonly popupService;
+    private readonly translationService;
+    open(options?: AXPTableColumnsEditorOpenOptions): Promise<AXPTableColumnDefinition[] | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPTableColumnsEditorService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPTableColumnsEditorService>;
+}
+
+declare class AXPTableDataEditorPopupComponent extends AXBasePageComponent {
+    protected readonly I18N: {
+        readonly title: "@general:widgets.table-data-editor.popup-title";
+        readonly cancel: "@general:actions.cancel.title";
+        readonly save: "@general:actions.save.title";
+    };
+    columns: _angular_core.InputSignal<AXPTableColumnDefinition[]>;
+    rows: _angular_core.InputSignal<Record<string, unknown>[]>;
+    localRows: _angular_core.ModelSignal<Record<string, unknown>[]>;
+    constructor();
+    protected handleCancel(): void;
+    protected handleSave(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPTableDataEditorPopupComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPTableDataEditorPopupComponent, "axp-table-data-editor-popup", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "localRows": { "alias": "localRows"; "required": false; "isSignal": true; }; }, { "localRows": "localRowsChange"; }, never, never, true, never>;
+}
+
+declare class AXPTableDataEditorComponent {
+    columns: _angular_core.InputSignal<AXPTableColumnDefinition[]>;
+    rowsModel: _angular_core.ModelSignal<Record<string, unknown>[]>;
+    protected readonly spreadsheetColumns: _angular_core.Signal<AXPSpreadsheetColumn[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPTableDataEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPTableDataEditorComponent, "axp-table-data-editor", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "rowsModel": { "alias": "rowsModel"; "required": false; "isSignal": true; }; }, { "rowsModel": "rowsModelChange"; }, never, never, true, never>;
+}
+
+interface AXPTableDataEditorOpenOptions {
+    title?: string;
+    columns: AXPTableColumnDefinition[];
+    rows?: Record<string, unknown>[];
+}
+declare class AXPTableDataEditorService {
+    private readonly popupService;
+    private readonly translationService;
+    open(options: AXPTableDataEditorOpenOptions): Promise<Record<string, unknown>[] | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPTableDataEditorService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPTableDataEditorService>;
+}
+
 interface AXPTemplateViewerConfig {
     template: AXPWidgetNode | string;
     title?: string;
@@ -1518,10 +1803,18 @@ declare class AXPWidgetFieldConfiguratorComponent {
      * Whether preview button should be enabled
      */
     protected canPreview: _angular_core.Signal<boolean>;
+    /**
+     * Reference to the widget type select box (used to open dropdown when entering edit mode)
+     */
+    protected widgetSelectBox: _angular_core.Signal<AXSelectBoxComponent | undefined>;
     /**
      * Enter edit mode (show select box)
      */
     protected enterEditMode(): void;
+    /**
+     * Exit edit mode when dropdown is closed (return to view mode)
+     */
+    protected exitEditMode(): void;
     constructor();
     /**
      * Handle widget type change
@@ -1703,5 +1996,5 @@ declare class AXPWidgetPropertyViewerService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetPropertyViewerService>;
 }
 
-export { AXPActivityLogComponent, AXPCategoryTreeComponent, AXPColorPalettePickerComponent, AXPColumnItemListComponent, AXPCompareViewComponent, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPDataSelectorComponent, AXPDataSelectorService, AXPDragDropListComponent, AXPImageEditorPopupComponent, AXPImageEditorService, AXPLogoComponent, AXPMenuBadgeHelper, AXPPropertyViewerComponent, AXPPropertyViewerPopupComponent, AXPPropertyViewerService, AXPQueryColumnsComponent, AXPQueryFiltersComponent, AXPQuerySortsComponent, AXPQueryViewsComponent, AXPSpreadsheetComponent, AXPStateMessageComponent, AXPStopwatchComponent, AXPTaskBadgeDirective, AXPTaskBadgeProvider, AXPTaskBadgeService, AXPTemplateViewerComponent, AXPTemplateViewerService, AXPThemeLayoutActionsComponent, AXPThemeLayoutBlockComponent, AXPThemeLayoutContainerComponent, AXPThemeLayoutEndSideComponent, AXPThemeLayoutFooterComponent, AXPThemeLayoutHeaderComponent, AXPThemeLayoutListComponent, AXPThemeLayoutListItemComponent, AXPThemeLayoutListItemsGroupComponent, AXPThemeLayoutPageHeaderComponent, AXPThemeLayoutPagePrimaryActionsComponent, AXPThemeLayoutPageSecondaryActionsComponent, AXPThemeLayoutSectionComponent, AXPThemeLayoutStartSideComponent, AXPThemeLayoutToolbarComponent, AXPUserAvatarComponent, AXPUserAvatarService, AXPWidgetFieldConfiguratorComponent, AXPWidgetItemComponent, AXPWidgetPropertyViewerComponent, AXPWidgetPropertyViewerPopupComponent, AXPWidgetPropertyViewerService, AXP_TASK_BADGE_PROVIDERS, AXP_USER_AVATAR_PROVIDER };
-export type { AXPCategoryTreeActions, AXPCategoryTreeConfig, AXPCategoryTreeDataSource, AXPCategoryTreeEvents, AXPCategoryTreeNode, AXPColumnItemListItem, AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDragDropListConfig, AXPDragDropListDropEvent, AXPDragDropListItem, AXPImageEditorOpenOptions, AXPPropertyViewerChangedEvent, AXPPropertyViewerConfig, AXPPropertyViewerGroup, AXPPropertyViewerResult, AXPPropertyViewerTab, AXPSpreadsheetCellChangeEvent, AXPSpreadsheetCellValue, AXPSpreadsheetColumn, AXPSpreadsheetConfig, AXPSpreadsheetData, AXPSpreadsheetItem, AXPSpreadsheetRowChangeEvent, AXPSpreadsheetRowMode, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyInjection, AXPWidgetPropertyViewerConfig, AXPWidgetPropertyViewerResult, StateMode };
+export { AXPActivityLogComponent, AXPCategoryTreeComponent, AXPColorPalettePickerComponent, AXPColumnItemListComponent, AXPCompareViewComponent, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPDataSelectorComponent, AXPDataSelectorService, AXPDragDropListComponent, AXPImageEditorPopupComponent, AXPImageEditorService, AXPLogoComponent, AXPMenuBadgeHelper, AXPMenuCustomizerComponent, AXPMenuCustomizerService, AXPPropertyViewerComponent, AXPPropertyViewerPopupComponent, AXPPropertyViewerService, AXPQueryColumnsComponent, AXPQueryFiltersComponent, AXPQuerySortsComponent, AXPQueryViewsComponent, AXPSpreadsheetComponent, AXPStateMessageComponent, AXPStopwatchComponent, AXPTableColumnsEditorComponent, AXPTableColumnsEditorPopupComponent, AXPTableColumnsEditorService, AXPTableDataEditorComponent, AXPTableDataEditorPopupComponent, AXPTableDataEditorService, AXPTaskBadgeDirective, AXPTaskBadgeProvider, AXPTaskBadgeService, AXPTemplateViewerComponent, AXPTemplateViewerService, AXPThemeLayoutActionsComponent, AXPThemeLayoutBlockComponent, AXPThemeLayoutContainerComponent, AXPThemeLayoutEndSideComponent, AXPThemeLayoutFooterComponent, AXPThemeLayoutHeaderComponent, AXPThemeLayoutListComponent, AXPThemeLayoutListItemComponent, AXPThemeLayoutListItemsGroupComponent, AXPThemeLayoutPageHeaderComponent, AXPThemeLayoutPagePrimaryActionsComponent, AXPThemeLayoutPageSecondaryActionsComponent, AXPThemeLayoutSectionComponent, AXPThemeLayoutStartSideComponent, AXPThemeLayoutToolbarComponent, AXPUserAvatarComponent, AXPUserAvatarService, AXPWidgetFieldConfiguratorComponent, AXPWidgetItemComponent, AXPWidgetPropertyViewerComponent, AXPWidgetPropertyViewerPopupComponent, AXPWidgetPropertyViewerService, AXP_MENU_CUSTOMIZER_SERVICE, AXP_TASK_BADGE_PROVIDERS, AXP_USER_AVATAR_PROVIDER, buildTableColumnsEditorLayout };
+export type { AXPCategoryTreeActions, AXPCategoryTreeConfig, AXPCategoryTreeDataSource, AXPCategoryTreeEvents, AXPCategoryTreeNode, AXPColumnItemListItem, AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDragDropListConfig, AXPDragDropListDropEvent, AXPDragDropListItem, AXPImageEditorOpenOptions, AXPMenuCustomizerAction, AXPMenuCustomizerItem, AXPMenuCustomizerNodeData, AXPMenuCustomizerNodeMetadata, AXPPropertyViewerChangedEvent, AXPPropertyViewerConfig, AXPPropertyViewerGroup, AXPPropertyViewerResult, AXPPropertyViewerTab, AXPSpreadsheetCellChangeEvent, AXPSpreadsheetCellValue, AXPSpreadsheetColumn, AXPSpreadsheetConfig, AXPSpreadsheetData, AXPSpreadsheetItem, AXPSpreadsheetRowChangeEvent, AXPSpreadsheetRowMode, AXPTableColumnDefinition, AXPTableColumnsEditorOpenOptions, AXPTableDataEditorOpenOptions, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyInjection, AXPWidgetPropertyViewerConfig, AXPWidgetPropertyViewerResult, StateMode };

package/layout/entity/index.d.ts

@@ -15,10 +15,10 @@ import { Subject } from 'rxjs';
 import * as i2 from '@acorex/platform/workflow';
 import { AXPWorkflowService, AXPWorkflowAction, AXPWorkflowContext, AXPWorkflow } from '@acorex/platform/workflow';
 import { AXPSessionService } from '@acorex/platform/auth';
-import { AXTreeViewNode, AXTreeViewComponent, AXTreeViewNodeToggleEvent, AXTreeViewNodeSelectEvent, AXTreeViewSelectionChangeEvent } from '@acorex/components/tree-view';
+import { AXTreeViewNode, AXTreeViewComponent, AXTreeViewNodeSelectEvent } from '@acorex/components/tree-view';
 import { AXTranslationService } from '@acorex/core/translation';
 import { AXPopupSizeType, AXPopupService } from '@acorex/components/popup';
-import { IActionBuilder, IFormFieldBuilder, AXPDialogRef } from '@acorex/platform/layout/builder';
+import { IActionBuilder, AXPDialogRef, IFormFieldBuilder } from '@acorex/platform/layout/builder';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXFormatService } from '@acorex/core/format';
 import { AXPColumnItemListItem, AXPCategoryTreeDataSource } from '@acorex/platform/layout/components';
@@ -27,12 +27,9 @@ import { AXPDataListWidgetComponentOptions } from '@acorex/platform/layout/widge
 
 declare class AXPCreateEntityCommand implements AXPCommand<any, any> {
     private entityForm;
-    private settingsService;
     private entityService;
     private toastService;
     private translationService;
-    private eventService;
-    private platform;
     protected context: {};
     execute(input: any): Promise<AXPExecuteCommandResult<any>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPCreateEntityCommand, never>;
@@ -1274,6 +1271,14 @@ interface IPropertyFilterStage {
     size(size: AXPopupSizeType): IPropertyFilterStage;
     /** Configure footer actions (cancel/submit/custom). If not called, defaults to cancel+submit. */
     actions(delegate: (a: IActionBuilder) => void): IPropertyFilterStage;
+    /**
+     * Handler invoked when user clicks an action. Receives AXPDialogRef.
+     * If handler throws, dialog stays open for retry.
+     * If handler returns, dialog closes and show() resolves with the return value.
+     */
+    onAction<T = any>(handler: (dialogRef: AXPDialogRef) => T | Promise<T>): IPropertyFilterStage & {
+        show(): Promise<T>;
+    };
     /** Add an extra field into a specific group, using the original field builder API */
     field(groupId: string, path: string, delegate?: (field: CompatFormFieldBuilder) => void): IPropertyFilterStage;
     /** Build and return the widget node without showing dialog */
@@ -1408,7 +1413,6 @@ declare class AXPEntityCategoryTreeSelectorComponent extends AXBasePageComponent
     private relevantNodeIds;
     private expandedNodesBeforeSearch;
     private nodesExpandedDuringSearch;
-    private isInitializing;
     ngOnInit(): void;
     private initializeTree;
     /**
@@ -1447,9 +1451,12 @@ declare class AXPEntityCategoryTreeSelectorComponent extends AXBasePageComponent
      * Resets search state and restores tree to original expanded state
      */
     private resetSearch;
-    protected onNodeToggle(event: AXTreeViewNodeToggleEvent): Promise<void>;
+    /**
+     * Restores selection state after tree reload.
+     * Expands ancestor nodes and selects the previously selected leaf nodes.
+     */
+    private restoreSelectionAfterReload;
     protected onNodeSelect(event: AXTreeViewNodeSelectEvent): Promise<void>;
-    protected onSelectionChange(event: AXTreeViewSelectionChangeEvent): Promise<void>;
     /** Datasource callback for tree-view component. */
     protected datasource: (id?: string) => Promise<AXTreeViewNode[]>;
     protected onConfirm(): Promise<void>;
@@ -1467,55 +1474,33 @@ declare class AXPEntityCategoryTreeSelectorComponent extends AXBasePageComponent
      */
     protected isNodeSelected(nodeId: string | number | undefined): boolean;
     /**
-     * Handles checkbox change event to toggle node selection
-     * In multiple mode: recursively selects/deselects LEAF children only
-     * Parent states are calculated based on leaf descendants
-     */
-    protected handleCheckboxChange(nodeId: string | number | undefined, checked: boolean): Promise<void>;
-    /**
-     * Selects all leaf descendants of a node (and the node itself if it's a leaf)
-     */
-    private selectLeafDescendants;
-    /**
-     * Deselects all leaf descendants of a node (and the node itself if it's a leaf)
+     * Expands parent nodes, collects all LEAF descendants, and selects them visually.
+     * If the parent itself is a leaf (no children), it will be added.
      */
-    private deselectLeafDescendants;
+    private selectAllLeafDescendants;
     /**
-     * Collects all LEAF descendant node IDs recursively
-     * A leaf node is one that has no children
+     * Removes all LEAF descendants from selectedNodeIds.
+     * For 'all' node: clears everything and uses tree's deselectAll().
+     * For other nodes: tree handles visual state via user click.
      */
-    private collectLeafDescendants;
+    private deselectAllLeafDescendants;
     /**
-     * Refreshes parent states in the tree based on leaf selection
+     * Recursively expands parent nodes and collects LEAF node IDs.
+     * When treeComponent is provided, expands each parent node before loading children.
      */
-    private refreshParentStatesInTree;
+    private collectLeafNodes;
     /**
-     * Selects a node and recursively selects all its children
+     * Checks if a node has children
      */
-    private selectNodeAndChildren;
+    private nodeHasChildren;
     /**
-     * Collects all descendant node IDs recursively
+     * Checks if a node is a leaf (has no children)
      */
-    private collectAllDescendants;
+    private isLeafNodeCheck;
     /**
-     * Deselects a node and recursively deselects all its children
+     * Caches node data from a tree node
      */
-    private deselectNodeAndChildren;
-    /**
-     * Recursively deselects all children of a parent node
-     */
-    private loadAndDeselectChildrenRecursively;
-    /**
-     * Updates parent states based on children selection (select/intermediate)
-     * Called after a node is selected/deselected to update parent checkbox states
-     */
-    private updateParentStates;
-    /**
-     * Recursively loads and selects all children of a parent node using the datasource
-     * This method directly calls datasource without expanding/collapsing nodes to avoid UI glitches
-     */
-    private loadAndSelectChildrenRecursively;
-    private updateSelectedNodes;
+    private cacheNodeFromTreeNode;
     /**
      * Builds complete ancestor chains for all selected node IDs.
      * Returns a Map where key is the selected node ID and value is array of ancestor IDs from root to parent.
@@ -1560,7 +1545,8 @@ declare class AXPEntityCategoryTreeSelectorComponent extends AXBasePageComponent
      */
     private processRootNode;
     /**
-     * Processes child nodes: marks excluded as disabled, marks selected, and syncs selection
+     * Processes child nodes: marks excluded as disabled
+     * Selection marking is handled in datasource callback ONLY during initial load
      */
     private processChildNodes;
     /**
@@ -1585,14 +1571,6 @@ declare class AXPEntityCategoryTreeSelectorComponent extends AXBasePageComponent
      * Get the display title for a node.
      */
     private getNodeTitle;
-    /**
-     * Checks if a node is a leaf node (has no children)
-     */
-    private isLeafNode;
-    /**
-     * Checks if a node has children by querying the data source
-     */
-    private checkIfNodeHasChildren;
     private getSelectedItems;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityCategoryTreeSelectorComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityCategoryTreeSelectorComponent, "axp-entity-category-tree-selector", never, {}, {}, never, never, true, never>;