@acorex/components 22.3.7 → 22.3.8

package/types/acorex-components-popup.d.ts

@@ -1,10 +1,11 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef, ViewContainerRef, StaticProvider, ElementRef, OnInit, OnDestroy } from '@angular/core';
+import { TemplateRef, ViewContainerRef, StaticProvider, Signal, ElementRef, OnInit, OnDestroy } from '@angular/core';
 import * as i2 from '@acorex/cdk/common';
 import { NXComponent, MXBaseComponent, AXComponentClosedPromise } from '@acorex/cdk/common';
-import { AXComponentType, AXComponentInputs } from '@acorex/core/components';
+import { AXDropListDroppedEvent } from '@acorex/cdk/drag-drop';
 import { AXResizeHandle } from '@acorex/cdk/resizable';
 import { AXOverlayAnimation } from '@acorex/cdk/overlay';
+import { AXComponentType, AXComponentInputs } from '@acorex/core/components';
 import { Subject } from 'rxjs';
 import * as _acorex_components_popup from '@acorex/components/popup';
 import * as i1 from '@angular/common';
@@ -12,18 +13,30 @@ import * as i3 from '@acorex/components/button';
 import * as i4 from '@acorex/components/decorators';
 import * as i5 from '@acorex/core/translation';
 
-declare class AXPopupFooterComponent {
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPopupFooterComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPopupFooterComponent, "ax-popup-footer", never, {}, {}, never, ["ax-prefix", "ax-suffix", "*"], true, never>;
+type AXPopupCaptionIconName = 'minimize' | 'maximize' | 'restore' | 'close';
+/**
+ * Windows-style window caption glyphs: minimize, maximize, restore, close.
+ */
+declare class AXPopupCaptionIconComponent {
+    name: _angular_core.InputSignal<AXPopupCaptionIconName>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPopupCaptionIconComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPopupCaptionIconComponent, "ax-popup-caption-icon", never, { "name": { "alias": "name"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 type AXPopupContentType = TemplateRef<unknown> | AXComponentType<unknown> | HTMLElement;
 type AXPopupSizeType = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full' | 'fit';
 type AXPopupMinimizePosition = 'bottom-right' | 'bottom-left';
+type AXPopupWindowState = 'normal' | 'minimized' | 'maximized';
 interface AXPopupButtonsConfig {
     minimize?: {
         enable: boolean;
         position: AXPopupMinimizePosition;
+        /**
+         * Name of an `<ax-popup-dock>` that should host this popup when minimized.
+         * Falls back to the built-in bottom bar when no matching dock is registered.
+         * @defaultValue 'default'
+         */
+        dock?: string;
     };
     maximize?: boolean;
     close?: boolean;
@@ -116,6 +129,15 @@ interface AXPopupData {
     draggable: boolean;
     content: AXPopupContentType;
 }
+interface AXPopupDockItem {
+    id: number;
+    title: Signal<string>;
+    data: unknown;
+    ref: AXPopupRef;
+    restore: () => void;
+    maximize: () => void;
+    close: () => void;
+}
 interface AXPopupRef<TResult = any> {
     close: (data?: TResult) => void;
     setInputs: (values: AXComponentInputs) => void;
@@ -126,13 +148,24 @@ interface AXPopupRef<TResult = any> {
     /** Brings this popup to the front of all other overlays */
     bringToFront: () => void;
     onClose: Subject<TResult>;
+    onStateChange: Subject<AXPopupWindowState>;
+    readonly state: Signal<AXPopupWindowState>;
+    readonly title: Signal<string>;
+    readonly isMinimized: Signal<boolean>;
+    readonly isMaximized: Signal<boolean>;
     /** The component instance rendered inside the popup (available after content is rendered) */
     componentInstance?: unknown;
     /** @internal Stack index among open popups (minimized bar positioning). */
     _getStackIndex?: () => number;
+    /** @internal */
+    _setState?: (state: AXPopupWindowState) => void;
 }
 declare abstract class AXPopupComponentBase {
     __popup__: _angular_core.InputSignal<AXPopupRef<any>>;
+    readonly popupState: Signal<AXPopupWindowState>;
+    readonly isMinimized: Signal<boolean>;
+    readonly isMaximized: Signal<boolean>;
+    readonly popupTitle: Signal<string>;
     close(data?: any): void;
     setTitle(title: string): void;
     minimize(): void;
@@ -150,10 +183,50 @@ declare function resolvePopupMaximizable(config?: AXPopupConfig | null): boolean
 declare function resolvePopupMinimize(config?: AXPopupConfig | null): {
     enable: boolean;
     position: AXPopupMinimizePosition;
+    dock: string;
 };
 /** Resolves resize config. Disabled for `size: 'full'` and when `resizable` is false/omitted. */
 declare function resolvePopupResizable(config?: AXPopupConfig | null): AXPopupResolvedResizableConfig;
 
+/**
+ * Page-hosted dock for minimized popups. Place it anywhere in the app; matching
+ * `buttons.minimize.dock` names send hidden windows here as reorderable tabs.
+ *
+ * @example
+ * ```html
+ * <ax-popup-dock name="taskbar">
+ *   <ng-template let-item>
+ *     <button axDragHandle (click)="item.restore()">{{ item.title() }}</button>
+ *     <button (click)="item.close()">Close</button>
+ *   </ng-template>
+ * </ax-popup-dock>
+ * ```
+ */
+declare class AXPopupDockComponent extends NXComponent {
+    private popupService;
+    /**
+     * Dock name matched against `buttons.minimize.dock`.
+     * @defaultValue 'default'
+     */
+    name: _angular_core.InputSignal<string>;
+    /**
+     * Layout of the tab strip.
+     * @defaultValue 'horizontal'
+     */
+    orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
+    protected itemTemplate: _angular_core.Signal<TemplateRef<any>>;
+    protected items: _angular_core.Signal<AXPopupDockItem[]>;
+    constructor();
+    protected onDropped(event: AXDropListDroppedEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPopupDockComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPopupDockComponent, "ax-popup-dock", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, {}, ["itemTemplate"], never, true, never>;
+}
+
+declare class AXPopupFooterComponent {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPopupFooterComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPopupFooterComponent, "ax-popup-footer", never, {}, {}, never, ["ax-prefix", "ax-suffix", "*"], true, never>;
+}
+
 /**
  * Declarative popup host. Project content and call `open()` / `close()` on the component instance.
  *
@@ -246,6 +319,7 @@ declare class AXPopupComponent extends MXBaseComponent implements OnInit, OnDest
     protected fullScreenState: _angular_core.WritableSignal<boolean>;
     protected minimizeLeft: _angular_core.WritableSignal<string>;
     protected minimizeRight: _angular_core.WritableSignal<string>;
+    protected readonly minimizeSide: _angular_core.Signal<_acorex_components_popup.AXPopupMinimizePosition>;
     private fullscreenChangeHandler;
     protected closeEnabled: () => boolean;
     protected maximizeEnabled: () => boolean;
@@ -273,7 +347,7 @@ declare class AXPopupComponent extends MXBaseComponent implements OnInit, OnDest
      */
     close(data?: unknown): void;
     /**
-     * Minimizes the popup to the bottom bar.
+     * Minimizes the popup. Routes through the popup ref so a registered dock can host the tab.
      */
     minimize(): void;
     /**
@@ -284,6 +358,27 @@ declare class AXPopupComponent extends MXBaseComponent implements OnInit, OnDest
      * Restores the popup from minimized or fullscreen state.
      */
     restore(): void;
+    /**
+     * Applies the minimized visual. When `docked` is true the overlay is hidden by the service
+     * and the window stays at normal size for the next restore.
+     * @internal
+     */
+    enterMinimized(docked: boolean): void;
+    /**
+     * Restores the window from the legacy bottom bar.
+     * @internal
+     */
+    exitMinimized(): void;
+    /**
+     * Enters or toggles the Fullscreen API on the popup element.
+     * @internal
+     */
+    enterMaximized(): void;
+    /**
+     * Leaves fullscreen.
+     * @internal
+     */
+    exitMaximized(): void;
     /**
      * Sets inputs on the content component.
      */
@@ -298,7 +393,7 @@ declare class AXPopupComponent extends MXBaseComponent implements OnInit, OnDest
 
 declare class AXPopupModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPopupModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXPopupModule, never, [typeof i1.CommonModule, typeof i2.AXCommonModule, typeof i3.AXButtonModule, typeof i4.AXDecoratorModule, typeof i5.AXTranslationModule, typeof AXPopupComponent, typeof AXPopupHostComponent, typeof AXPopupFooterComponent], [typeof AXPopupComponent, typeof AXPopupHostComponent, typeof AXPopupFooterComponent]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXPopupModule, never, [typeof i1.CommonModule, typeof i2.AXCommonModule, typeof i3.AXButtonModule, typeof i4.AXDecoratorModule, typeof i5.AXTranslationModule, typeof AXPopupComponent, typeof AXPopupHostComponent, typeof AXPopupFooterComponent, typeof AXPopupDockComponent, typeof AXPopupCaptionIconComponent], [typeof AXPopupComponent, typeof AXPopupHostComponent, typeof AXPopupFooterComponent, typeof AXPopupDockComponent, typeof AXPopupCaptionIconComponent]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXPopupModule>;
 }
 
@@ -310,6 +405,9 @@ declare class AXPopupModule {
 declare class AXPopupService {
     private popupList;
     private overlayService;
+    private injector;
+    private dockCounts;
+    private minimizedByDock;
     /**
      *  Open popup 1
      */
@@ -322,38 +420,33 @@ declare class AXPopupService {
      * Opens a popup and returns a mutable reference (for host components and advanced control).
      */
     openRef<TResult = any>(content: AXPopupContentType, config?: AXPopupConfig): Promise<AXPopupRef<TResult>>;
+    hasDock(name: string): boolean;
+    registerDock(name: string): void;
+    unregisterDock(name: string): void;
+    minimizedInDock(dock: string): AXPopupDockItem[];
+    reorderMinimized(dock: string, fromIndex: number, toIndex: number): void;
     private mergeConfig;
     /**
      * Opens a popup with the specified content and configuration.
      */
     private openInternal;
-    /**
-     * Closes a popup by its ID.
-     */
     close<TResult = any>(id: number, data?: TResult): void;
-    /**
-     * Sets input values for a popup by its ID.
-     */
     setInputs(id: number, values: AXComponentInputs): void;
-    /**
-     * Sets the title for a popup by its ID.
-     */
     setTitle(id: number, title: string): void;
     minimize(id: number): void;
     maximize(id: number): void;
     restore(id: number): void;
-    /**
-     * Gets the index of a popup in the open stack (used for minimized bar positioning).
-     */
     getMapIndexOf(targetKey: number): number;
-    /**
-     * Brings a popup to the front of all other overlays.
-     */
     bringToFront(id: number): void;
+    markMaximized(id: number, maximized: boolean): void;
+    private addToDock;
+    private removeFromDock;
+    private setOverlayVisible;
+    private toDockItem;
     private getPopupInstance;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPopupService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
-export { AXPopupComponent, AXPopupComponentBase, AXPopupFooterComponent, AXPopupHostComponent, AXPopupModule, AXPopupService, AX_POPUP_DEFAULT_RESIZE_HANDLES, resolvePopupCloseButton, resolvePopupMaximizable, resolvePopupMinimize, resolvePopupResizable };
-export type { AXPopupButtonsConfig, AXPopupConfig, AXPopupContentType, AXPopupData, AXPopupMinimizePosition, AXPopupRef, AXPopupResizableConfig, AXPopupResolvedResizableConfig, AXPopupSizeType };
+export { AXPopupCaptionIconComponent, AXPopupComponent, AXPopupComponentBase, AXPopupDockComponent, AXPopupFooterComponent, AXPopupHostComponent, AXPopupModule, AXPopupService, AX_POPUP_DEFAULT_RESIZE_HANDLES, resolvePopupCloseButton, resolvePopupMaximizable, resolvePopupMinimize, resolvePopupResizable };
+export type { AXPopupButtonsConfig, AXPopupCaptionIconName, AXPopupConfig, AXPopupContentType, AXPopupData, AXPopupDockItem, AXPopupMinimizePosition, AXPopupRef, AXPopupResizableConfig, AXPopupResolvedResizableConfig, AXPopupSizeType, AXPopupWindowState };