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

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

@@ -3,12 +3,12 @@ import * as _angular_core from '@angular/core';
 import { EventEmitter, OnChanges, OnDestroy, WritableSignal, NgZone, ComponentRef, SimpleChanges } from '@angular/core';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXTabStripChangedEvent } from '@acorex/components/tabs';
-import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
-import { AXPWidgetConfig, AXPWidgetCategory, AXPWidgetGroupEnum, AXPWidgetNode, AXPBaseWidgetComponent, AXPWidgetRegistryService, AXPLayoutBaseWidgetComponent, AXPWidgetCoreContextChangeEvent } from '@acorex/platform/layout/widget-core';
+import { AXPMultiLanguageString, AXPDefinitionCategory, AXPBroadcastEventService, AXPContextChangeEvent } from '@acorex/platform/core';
 import { AXPWidgetItemData, AXPWidgetItemClickEvent } from '@acorex/platform/layout/components';
+import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
+import { AXPWidgetConfig, AXPWidgetGroupEnum, AXPWidgetNode, AXPBaseWidgetComponent, AXPWidgetRegistryService, AXPLayoutBaseWidgetComponent } from '@acorex/platform/layout/widget-core';
 import { AXMenuItem } from '@acorex/components/menu';
 import { Subject } from 'rxjs';
-import { AXPBroadcastEventService } from '@acorex/platform/core';
 import { AXUnsubscriber } from '@acorex/core/utils';
 import { AXPClipBoardService, AXPSettingsService } from '@acorex/platform/common';
 
@@ -72,47 +72,93 @@ declare class AXPDesignerGridDrawerComponent {
 interface AXPDisplayWidgetConfig extends AXPWidgetConfig {
     pinned: boolean;
 }
+interface AXPWidgetPickerSection {
+    trackKey: string;
+    title: AXPMultiLanguageString | null;
+    widgetItems: AXPWidgetItemData[];
+}
 declare class AXPDesignerWidgetPickerComponent extends AXBasePageComponent {
+    private readonly injector;
     private settingsService;
+    private readonly mlResolver;
     private readonly pinnedSettingKey;
+    /** Keeps the line indicator in sync when the selected index is set programmatically (e.g. restored tab). */
+    private readonly tabsHost;
+    constructor();
+    protected readonly i18n: {
+        readonly searchPlaceholder: "@form-template-management:designer.components.widget-picker.search-placeholder";
+        readonly selectedCount: "@form-template-management:designer.components.widget-picker.selected-count";
+        readonly tabAll: "@form-template-management:designer.components.widget-picker.tab-all";
+        readonly pinnedSectionTitle: "@form-template-management:designer.components.widget-picker.pinned-section-title";
+    };
     protected searchTerm: _angular_core.ModelSignal<string>;
+    /** Populated by popup `data.tabPersistenceContext` (optional for tests). */
+    tabPersistenceContext?: string;
     private widgets;
     private allWidgets;
     private pinnedWidgets;
-    private displayWidgets;
     protected selectedWidgets: _angular_core.WritableSignal<AXPDisplayWidgetConfig[]>;
+    protected currentTabIndex: _angular_core.WritableSignal<number>;
+    /** Avoid persisting spurious tab events before restore + first paint complete. */
+    private allowTabPersistence;
+    private displayWidgets;
     private orderedList;
     protected pinnedList: _angular_core.Signal<AXPDisplayWidgetConfig[]>;
     protected regularList: _angular_core.Signal<AXPDisplayWidgetConfig[]>;
     protected pinnedWidgetItems: _angular_core.Signal<AXPWidgetItemData[]>;
-    protected regularWidgetItems: _angular_core.Signal<AXPWidgetItemData[]>;
-    protected categories: _angular_core.Signal<AXPWidgetCategory[]>;
-    protected tabs: _angular_core.Signal<AXPWidgetCategory[]>;
+    protected regularGroupedSections: _angular_core.Signal<AXPWidgetPickerSection[]>;
+    protected categories: _angular_core.Signal<AXPDefinitionCategory[]>;
+    protected tabs: _angular_core.Signal<AXPDefinitionCategory[]>;
     protected maxVisibleWidgets: _angular_core.Signal<number>;
-    protected currentTabIndex: _angular_core.WritableSignal<number>;
-    protected selectedTab: _angular_core.Signal<AXPWidgetCategory>;
+    protected selectedTab: _angular_core.Signal<AXPDefinitionCategory>;
+    protected pickerShellClass: _angular_core.Signal<string>;
     protected ngOnInit(): Promise<void>;
-    protected handleTabChange(event: AXTabStripChangedEvent): void;
+    private lastTabSettingKey;
+    private restoreLastTabFromSettings;
+    /**
+     * `ax-tab-item` [active] updates labels, but `ax-tabs` keeps the underline from its own index until `select` runs.
+     */
+    private syncTabsStripToIndex;
+    private persistTabSelection;
+    /**
+     * Picks the primary parent category for the "All" tab (lowest `order` wins).
+     */
+    private primaryCategory;
+    private buildAllTabSections;
+    private buildCategoryTabSections;
+    protected handleTabChange(event: AXTabStripChangedEvent): Promise<void>;
     protected handleWidgetClick(clickEvent: AXPWidgetItemClickEvent): void;
     protected handleWidgetPinClick(clickEvent: AXPWidgetItemClickEvent): Promise<void>;
+    protected handleConfirmSelection(): void;
     protected isWidgetSelected(widget: AXPDisplayWidgetConfig): boolean;
     protected isWidgetItemSelected(widgetItem: AXPWidgetItemData): boolean;
-    protected handleConfirmSelection(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDesignerWidgetPickerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDesignerWidgetPickerComponent, "ng-component", never, { "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; }, { "searchTerm": "searchTermChange"; }, never, never, true, never>;
 }
 
+interface AXPWidgetPickerShowOptions {
+    groups: AXPWidgetGroupEnum[];
+    /** User-scoped last tab; unique per picker host (use `AXP_WIDGET_PICKER_TAB_CONTEXT`). */
+    tabPersistenceContext: string;
+}
 declare class AXPWidgetPickerService {
     private popupService;
     private widgetRegistryService;
     private translationService;
-    showPicker(options: {
-        groups: AXPWidgetGroupEnum[];
-    }): Promise<AXPWidgetNode[]>;
+    showPicker(options: AXPWidgetPickerShowOptions): Promise<AXPWidgetNode[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetPickerService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetPickerService>;
 }
 
+/**
+ * Suffixes for `forms:widgets:picker:last-tab:{id}` user settings keys.
+ * Use one id per distinct widget-picker host (different tab strips / widget sets).
+ */
+declare const AXP_WIDGET_PICKER_TAB_CONTEXT: {
+    readonly layoutDesignerFormElements: "layout-designer-form-elements";
+    readonly dashboardHome: "dashboard-home";
+};
+
 type AXPDesignerMode = {
     id: 'designer';
     title: 'Designer';
@@ -242,7 +288,7 @@ declare class AXPDesignerService {
     readonly onRefresh: Subject<AXPDesignerRefreshEvent>;
     readonly onUpdate: Subject<AXPDesignerUpdateEvent>;
     readonly onFocused: Subject<AXPDesignerFocusEvent>;
-    private templateId;
+    readonly templateId: _angular_core.WritableSignal<string | null>;
     private loadingStrategy;
     constructor();
     private can;
@@ -328,6 +374,38 @@ declare abstract class AXPDesignerConnector<T = string> {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPDesignerConnector<any>>;
 }
 
+/**
+ * Distributed hooks for extending the layout designer header menu without coupling the designer library to feature modules.
+ *
+ * - {@link AXPLayoutDesignerHeaderMenuHookKeys.root}: top-level bar items (siblings of File, Edit, …).
+ * - {@link AXPLayoutDesignerHeaderMenuHookKeys.submenu}: extra items inside a top-level menu (`file`, `edit`, `run`, `help`).
+ */
+declare const AXPLayoutDesignerHeaderMenuHookKeys: {
+    readonly root: "layout-designer.header-menu.root";
+    readonly submenu: "layout-designer.header-menu.submenu";
+};
+type AXPLayoutDesignerHeaderParentMenuId = 'file' | 'edit' | 'run' | 'help';
+interface AXPLayoutDesignerHeaderMenuEntry {
+    id: string;
+    priority?: number;
+    /** i18n key (resolved by the menu host when set). */
+    labelKey?: string;
+    /** Plain label when no translation key is used. */
+    label?: string;
+    iconClass?: string;
+    run: () => void | Promise<void>;
+}
+interface AXPLayoutDesignerHeaderMenuRootPayload {
+    /** Current designer instance (typed as unknown to avoid circular imports in consumers). */
+    designer: unknown;
+    items: AXPLayoutDesignerHeaderMenuEntry[];
+}
+interface AXPLayoutDesignerHeaderMenuSubmenuPayload {
+    designer: unknown;
+    parentMenuId: AXPLayoutDesignerHeaderParentMenuId;
+    items: AXPLayoutDesignerHeaderMenuEntry[];
+}
+
 declare const AXP_DESIGNER_COPY_MENU: AXMenuItem;
 declare const AXP_DESIGNER_CLONE_MENU: AXMenuItem;
 declare const AXP_DESIGNER_CUT_MENU: AXMenuItem;
@@ -392,7 +470,7 @@ declare class AXPLayoutDesignerPreviewViewerComponent {
     protected readonly currentPage: _angular_core.Signal<AXPWidgetNode>;
     constructor();
     ngAfterViewInit(): void;
-    protected handleContextChanged(e: AXPWidgetCoreContextChangeEvent): void;
+    protected handleContextChanged(e: AXPContextChangeEvent): void;
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLayoutDesignerPreviewViewerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLayoutDesignerPreviewViewerComponent, "axp-layout-builder-viewer", never, {}, {}, never, never, true, never>;
@@ -418,5 +496,5 @@ declare class AXPLayoutDesignerPreviewComponent extends AXBasePageComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLayoutDesignerPreviewComponent, "axp-layout-preview", never, {}, {}, never, never, true, never>;
 }
 
-export { AXPDesignerAddWidgetButtonComponent, AXPDesignerAddWidgetLineButtonComponent, AXPDesignerAddWidgetMiniButtonComponent, AXPDesignerConnector, AXPDesignerFlexDrawerComponent, AXPDesignerGridDrawerComponent, AXPDesignerMessageKeys, AXPDesignerModes, AXPDesignerService, AXPDesignerWidgetPickerComponent, AXPLayoutDesignerComponent, AXPLayoutDesignerPreviewComponent, AXPLayoutDesignerPreviewViewerComponent, AXPTemplateLoadingStrategy, AXPWidgetDesignerRendererDirective, AXPWidgetPickerService, AXP_DESIGNER_ADD_WIDGET_MENU, AXP_DESIGNER_CLONE_MENU, AXP_DESIGNER_COPY_MENU, AXP_DESIGNER_CUT_MENU, AXP_DESIGNER_DELETE_WIDGET_MENU, AXP_DESIGNER_PASTE_MENU, AXP_DESIGNER_SAVE_AS_WIDGET_MENU, AXP_DESIGNER_SELECT_WIDGET_MENU, cloneWidgetMenu };
-export type { AXPDesignerAddNodeCommand, AXPDesignerAddNodeEvent, AXPDesignerContent, AXPDesignerFocusCommand, AXPDesignerFocusEvent, AXPDesignerMode, AXPDesignerPreviewMessage, AXPDesignerPreviewSize, AXPDesignerRefreshCommand, AXPDesignerRefreshEvent, AXPDesignerRegisterCommand, AXPDesignerSaveFormMessage, AXPDesignerSelectCommand, AXPDesignerSelectEvent, AXPDesignerUpdateCommand, AXPDesignerUpdateEvent, AXPDesignerWidgetComponent, AXPDisplayWidgetConfig };
+export { AXPDesignerAddWidgetButtonComponent, AXPDesignerAddWidgetLineButtonComponent, AXPDesignerAddWidgetMiniButtonComponent, AXPDesignerConnector, AXPDesignerFlexDrawerComponent, AXPDesignerGridDrawerComponent, AXPDesignerMessageKeys, AXPDesignerModes, AXPDesignerService, AXPDesignerWidgetPickerComponent, AXPLayoutDesignerComponent, AXPLayoutDesignerHeaderMenuHookKeys, AXPLayoutDesignerPreviewComponent, AXPLayoutDesignerPreviewViewerComponent, AXPTemplateLoadingStrategy, AXPWidgetDesignerRendererDirective, AXPWidgetPickerService, AXP_DESIGNER_ADD_WIDGET_MENU, AXP_DESIGNER_CLONE_MENU, AXP_DESIGNER_COPY_MENU, AXP_DESIGNER_CUT_MENU, AXP_DESIGNER_DELETE_WIDGET_MENU, AXP_DESIGNER_PASTE_MENU, AXP_DESIGNER_SAVE_AS_WIDGET_MENU, AXP_DESIGNER_SELECT_WIDGET_MENU, AXP_WIDGET_PICKER_TAB_CONTEXT, cloneWidgetMenu };
+export type { AXPDesignerAddNodeCommand, AXPDesignerAddNodeEvent, AXPDesignerContent, AXPDesignerFocusCommand, AXPDesignerFocusEvent, AXPDesignerMode, AXPDesignerPreviewMessage, AXPDesignerPreviewSize, AXPDesignerRefreshCommand, AXPDesignerRefreshEvent, AXPDesignerRegisterCommand, AXPDesignerSaveFormMessage, AXPDesignerSelectCommand, AXPDesignerSelectEvent, AXPDesignerUpdateCommand, AXPDesignerUpdateEvent, AXPDesignerWidgetComponent, AXPDisplayWidgetConfig, AXPLayoutDesignerHeaderMenuEntry, AXPLayoutDesignerHeaderMenuRootPayload, AXPLayoutDesignerHeaderMenuSubmenuPayload, AXPLayoutDesignerHeaderParentMenuId, AXPWidgetPickerShowOptions };