primeng 16.0.0-rc.1 → 16.0.0-rc.2

package/dialog/dialog.d.ts

@@ -1,6 +1,7 @@
-import { ElementRef, OnDestroy, EventEmitter, Renderer2, QueryList, NgZone, ChangeDetectorRef, AfterContentInit, TemplateRef, OnInit } from '@angular/core';
 import { AnimationEvent } from '@angular/animations';
-import { Header, Footer, PrimeNGConfig } from 'primeng/api';
+import { AfterContentInit, ChangeDetectorRef, ElementRef, EventEmitter, NgZone, OnDestroy, OnInit, QueryList, Renderer2, TemplateRef } from '@angular/core';
+import { Footer, Header, PrimeNGConfig, PrimeTemplate } from 'primeng/api';
+import { Nullable, VoidListener } from 'primeng/ts-helpers';
 import * as i0 from "@angular/core";
 import * as i1 from "@angular/common";
 import * as i2 from "primeng/focustrap";
@@ -17,87 +18,277 @@ export declare class Dialog implements AfterContentInit, OnInit, OnDestroy {
     zone: NgZone;
     private cd;
     config: PrimeNGConfig;
-    header: string;
+    /**
+     * Title text of the dialog.
+     * @group Props
+     */
+    header: string | undefined;
+    /**
+     * Enables dragging to change the position using header.
+     * @group Props
+     */
     draggable: boolean;
+    /**
+     * Enables resizing of the content.
+     * @group Props
+     */
     resizable: boolean;
+    /**
+     * @deprecated
+     * Defines the left offset of dialog.
+     * @group Props
+     */
     get positionLeft(): number;
     set positionLeft(_positionLeft: number);
+    /**
+     * @deprecated
+     * Defines the top offset of dialog.
+     * @group Props
+     */
     get positionTop(): number;
     set positionTop(_positionTop: number);
+    /**
+     * Style of the content section.
+     * @group Props
+     */
     contentStyle: any;
-    contentStyleClass: string;
+    /**
+     * Style class of the content.
+     * @group Props
+     */
+    contentStyleClass: string | undefined;
+    /**
+     * Defines if background should be blocked when dialog is displayed.
+     * @group Props
+     */
     modal: boolean;
+    /**
+     * Specifies if pressing escape key should hide the dialog.
+     * @group Props
+     */
     closeOnEscape: boolean;
+    /**
+     * Specifies if clicking the modal background should hide the dialog.
+     * @group Props
+     */
     dismissableMask: boolean;
+    /**
+     * When enabled dialog is displayed in RTL direction.
+     * @group Props
+     */
     rtl: boolean;
+    /**
+     * Adds a close icon to the header to hide the dialog.
+     * @group Props
+     */
     closable: boolean;
+    /**
+     * @deprecated
+     * Defines if the component is responsive.
+     * @group Props
+     */
     get responsive(): boolean;
     set responsive(_responsive: boolean);
-    appendTo: any;
+    /**
+     *  Target element to attach the dialog, valid values are "body" or a local ng-template variable of another element (note: use binding with brackets for template variables, e.g. [appendTo]="mydiv" for a div element having #mydiv as variable name).
+     * @group Props
+     */
+    appendTo: HTMLElement | ElementRef | TemplateRef<any> | string | null | undefined | any;
+    /**
+     * Object literal to define widths per screen size.
+     * @group Props
+     */
     breakpoints: any;
-    styleClass: string;
-    maskStyleClass: string;
+    /**
+     * Style class of the component.
+     * @group Props
+     */
+    styleClass: string | undefined;
+    /**
+     * Style class of the mask.
+     * @group Props
+     */
+    maskStyleClass: string | undefined;
+    /**
+     * Whether to show the header or not.
+     * @group Props
+     */
     showHeader: boolean;
+    /**
+     * @deprecated
+     * Defines the breakpoint of the component responsive.
+     * @group Props
+     */
     get breakpoint(): number;
     set breakpoint(_breakpoint: number);
+    /**
+     * Whether background scroll should be blocked when dialog is visible.
+     * @group Props
+     */
     blockScroll: boolean;
+    /**
+     * Whether to automatically manage layering.
+     * @group Props
+     */
     autoZIndex: boolean;
+    /**
+     * Base zIndex value to use in layering.
+     * @group Props
+     */
     baseZIndex: number;
+    /**
+     * Minimum value for the left coordinate of dialog in dragging.
+     * @group Props
+     */
     minX: number;
+    /**
+     * Minimum value for the top coordinate of dialog in dragging.
+     * @group Props
+     */
     minY: number;
+    /**
+     * When enabled, first button receives focus on show.
+     * @group Props
+     */
     focusOnShow: boolean;
+    /**
+     * Whether the dialog can be displayed full screen.
+     * @group Props
+     */
     maximizable: boolean;
+    /**
+     * Keeps dialog in the viewport.
+     * @group Props
+     */
     keepInViewport: boolean;
+    /**
+     * When enabled, can only focus on elements inside the dialog.
+     * @group Props
+     */
     focusTrap: boolean;
+    /**
+     * Transition options of the animation.
+     * @group Props
+     */
     transitionOptions: string;
-    closeIcon: string;
-    closeAriaLabel: string;
+    /**
+     * Name of the close icon.
+     * @group Props
+     */
+    closeIcon: string | undefined;
+    /**
+     * Defines a string that labels the close button for accessibility.
+     * @group Props
+     */
+    closeAriaLabel: string | undefined;
+    /**
+     * Index of the close button in tabbing order.
+     * @group Props
+     */
     closeTabindex: string;
-    minimizeIcon: string;
-    maximizeIcon: string;
-    headerFacet: QueryList<Header>;
-    footerFacet: QueryList<Footer>;
-    templates: QueryList<any>;
-    headerViewChild: ElementRef;
-    contentViewChild: ElementRef;
-    footerViewChild: ElementRef;
+    /**
+     * Name of the minimize icon.
+     * @group Props
+     */
+    minimizeIcon: string | undefined;
+    /**
+     * Name of the maximize icon.
+     * @group Props
+     */
+    maximizeIcon: string | undefined;
+    /**
+     * Specifies the visibility of the dialog.
+     * @group Props
+     */
+    get visible(): any;
+    set visible(value: any);
+    /**
+     * Inline style of the component.
+     * @group Props
+     */
+    get style(): any;
+    set style(value: any);
+    /**
+     * Position of the dialog.
+     * @group Props
+     */
+    get position(): 'center' | 'top' | 'bottom' | 'left' | 'right' | 'topleft' | 'topright' | 'bottomleft' | 'bottomright';
+    set position(value: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'topleft' | 'topright' | 'bottomleft' | 'bottomright');
+    /**
+     * Callback to invoke when dialog is shown.
+     * @group Emits
+     */
     onShow: EventEmitter<any>;
+    /**
+     * Callback to invoke when dialog is hidden.
+     * @group Emits
+     */
     onHide: EventEmitter<any>;
-    visibleChange: EventEmitter<any>;
-    onResizeInit: EventEmitter<any>;
-    onResizeEnd: EventEmitter<any>;
-    onDragEnd: EventEmitter<any>;
+    /**
+     * This EventEmitter is used to notify changes in the visibility state of a component.
+     * @param {boolean} value - New value.
+     * @group Emits
+     */
+    visibleChange: EventEmitter<boolean>;
+    /**
+     * Callback to invoke when dialog resizing is initiated.
+     * @param {MouseEvent} event - Mouse event.
+     * @group Emits
+     */
+    onResizeInit: EventEmitter<MouseEvent>;
+    /**
+     * Callback to invoke when dialog resizing is completed.
+     * @param {MouseEvent} event - Mouse event.
+     * @group Emits
+     */
+    onResizeEnd: EventEmitter<MouseEvent>;
+    /**
+     * Callback to invoke when dialog dragging is completed.
+     * @param {DragEvent} event - Drag event.
+     * @group Emits
+     */
+    onDragEnd: EventEmitter<DragEvent>;
+    /**
+     * Callback to invoke when dialog maximized or unmaximized.
+     * @group Emits
+     */
     onMaximize: EventEmitter<any>;
-    headerTemplate: TemplateRef<any>;
-    contentTemplate: TemplateRef<any>;
-    footerTemplate: TemplateRef<any>;
-    maximizeIconTemplate: TemplateRef<any>;
-    closeIconTemplate: TemplateRef<any>;
-    minimizeIconTemplate: TemplateRef<any>;
-    _visible: boolean;
-    maskVisible: boolean;
-    container: HTMLDivElement;
-    wrapper: HTMLElement;
-    dragging: boolean;
-    documentDragListener: VoidFunction | null;
-    documentDragEndListener: VoidFunction | null;
-    resizing: boolean;
-    documentResizeListener: VoidFunction | null;
-    documentResizeEndListener: VoidFunction | null;
-    documentEscapeListener: VoidFunction | null;
-    maskClickListener: VoidFunction | null;
-    lastPageX: number;
-    lastPageY: number;
-    preventVisibleChangePropagation: boolean;
-    maximized: boolean;
-    preMaximizeContentHeight: number;
-    preMaximizeContainerWidth: number;
-    preMaximizeContainerHeight: number;
-    preMaximizePageX: number;
-    preMaximizePageY: number;
+    headerFacet: QueryList<Header> | undefined;
+    footerFacet: QueryList<Footer> | undefined;
+    templates: QueryList<PrimeTemplate> | undefined;
+    headerViewChild: Nullable<ElementRef>;
+    contentViewChild: Nullable<ElementRef>;
+    footerViewChild: Nullable<ElementRef>;
+    headerTemplate: Nullable<TemplateRef<any>>;
+    contentTemplate: Nullable<TemplateRef<any>>;
+    footerTemplate: Nullable<TemplateRef<any>>;
+    maximizeIconTemplate: Nullable<TemplateRef<any>>;
+    closeIconTemplate: Nullable<TemplateRef<any>>;
+    minimizeIconTemplate: Nullable<TemplateRef<any>>;
+    _visible: boolean | undefined;
+    maskVisible: boolean | undefined;
+    container: Nullable<HTMLDivElement>;
+    wrapper: Nullable<HTMLElement>;
+    dragging: boolean | undefined;
+    documentDragListener: VoidListener;
+    documentDragEndListener: VoidListener;
+    resizing: boolean | undefined;
+    documentResizeListener: VoidListener;
+    documentResizeEndListener: VoidListener;
+    documentEscapeListener: VoidListener;
+    maskClickListener: VoidListener;
+    lastPageX: number | undefined;
+    lastPageY: number | undefined;
+    preventVisibleChangePropagation: boolean | undefined;
+    maximized: boolean | undefined;
+    preMaximizeContentHeight: number | undefined;
+    preMaximizeContainerWidth: number | undefined;
+    preMaximizeContainerHeight: number | undefined;
+    preMaximizePageX: number | undefined;
+    preMaximizePageY: number | undefined;
     id: string;
     _style: any;
-    _position: string;
+    _position: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'topleft' | 'topright' | 'bottomleft' | 'bottomright';
     originalStyle: any;
     transformOptions: any;
     styleElement: any;
@@ -105,12 +296,6 @@ export declare class Dialog implements AfterContentInit, OnInit, OnDestroy {
     constructor(document: Document, platformId: any, el: ElementRef, renderer: Renderer2, zone: NgZone, cd: ChangeDetectorRef, config: PrimeNGConfig);
     ngAfterContentInit(): void;
     ngOnInit(): void;
-    get visible(): any;
-    set visible(value: any);
-    get style(): any;
-    set style(value: any);
-    get position(): string;
-    set position(value: string);
     focus(): void;
     close(event: Event): void;
     enableModality(): void;
@@ -122,12 +307,12 @@ export declare class Dialog implements AfterContentInit, OnInit, OnDestroy {
     initDrag(event: MouseEvent): void;
     onKeydown(event: KeyboardEvent): void;
     onDrag(event: MouseEvent): void;
-    endDrag(event: MouseEvent): void;
+    endDrag(event: DragEvent): void;
     resetPosition(): void;
     center(): void;
     initResize(event: MouseEvent): void;
     onResize(event: MouseEvent): void;
-    resizeEnd(event: any): void;
+    resizeEnd(event: MouseEvent): void;
     bindGlobalListeners(): void;
     unbindGlobalListeners(): void;
     bindDocumentDragListener(): void;

package/dialog/dialog.interface.d.ts

@@ -0,0 +1,31 @@
+import { TemplateRef } from '@angular/core';
+/**
+ * Defines valid templates in Dialog.
+ * @group Templates
+ */
+export interface DialogTemplates {
+    /**
+     * Custom template of header.
+     */
+    header: TemplateRef<any> | null;
+    /**
+     * Custom template of content.
+     */
+    content: TemplateRef<any> | null;
+    /**
+     * Custom template of footer.
+     */
+    footer: TemplateRef<any> | null;
+    /**
+     * Custom template of closeicon.
+     */
+    closeicon: TemplateRef<any> | null;
+    /**
+     * Custom template of maximizeicon.
+     */
+    maximizeicon: TemplateRef<any> | null;
+    /**
+     * Custom template of minimizeicon.
+     */
+    minimizeicon: TemplateRef<any> | null;
+}

package/dialog/public_api.d.ts

@@ -1 +1,2 @@
 export * from './dialog';
+export * from './dialog.interface';

package/divider/divider.d.ts

@@ -1,11 +1,33 @@
 import * as i0 from "@angular/core";
 import * as i1 from "@angular/common";
 export declare class Divider {
-    styleClass: string;
-    style: any;
-    layout: string;
-    type: string;
-    align: string;
+    /**
+     * Inline style of the component.
+     * @group Props
+     */
+    style: {
+        [klass: string]: any;
+    } | null | undefined;
+    /**
+     * Style class of the component.
+     * @group Props
+     */
+    styleClass: string | undefined;
+    /**
+     * Specifies the orientation.
+     * @group Props
+     */
+    layout: 'horizontal' | 'vertical' | undefined;
+    /**
+     * Border style type.
+     * @group Props
+     */
+    type: 'solid' | 'dashed' | 'dotted' | undefined;
+    /**
+     * Alignment of the content.
+     * @group Props
+     */
+    align: 'left' | 'center' | 'right' | 'top' | 'center' | 'bottom' | undefined;
     containerClass(): {
         'p-divider p-component': boolean;
         'p-divider-horizontal': boolean;
@@ -20,7 +42,7 @@ export declare class Divider {
         'p-divider-bottom': boolean;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<Divider, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<Divider, "p-divider", never, { "styleClass": { "alias": "styleClass"; "required": false; }; "style": { "alias": "style"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "type": { "alias": "type"; "required": false; }; "align": { "alias": "align"; "required": false; }; }, {}, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<Divider, "p-divider", never, { "style": { "alias": "style"; "required": false; }; "styleClass": { "alias": "styleClass"; "required": false; }; "layout": { "alias": "layout"; "required": false; }; "type": { "alias": "type"; "required": false; }; "align": { "alias": "align"; "required": false; }; }, {}, never, ["*"], false, never>;
 }
 export declare class DividerModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DividerModule, never>;

package/dock/dock.d.ts

@@ -1,4 +1,5 @@
-import { ElementRef, TemplateRef, AfterContentInit, QueryList, ChangeDetectorRef } from '@angular/core';
+import { AfterContentInit, ChangeDetectorRef, ElementRef, QueryList, TemplateRef } from '@angular/core';
+import { MenuItem, PrimeTemplate } from 'primeng/api';
 import * as i0 from "@angular/core";
 import * as i1 from "@angular/common";
 import * as i2 from "@angular/router";
@@ -8,24 +9,46 @@ import * as i5 from "primeng/api";
 export declare class Dock implements AfterContentInit {
     private el;
     cd: ChangeDetectorRef;
-    id: string;
-    style: any;
-    styleClass: string;
-    model: any[];
-    position: string;
-    templates: QueryList<any>;
-    itemTemplate: TemplateRef<any>;
+    /**
+     * Current id state as a string.
+     * @group Props
+     */
+    id: string | undefined;
+    /**
+     * Inline style of the element.
+     * @group Props
+     */
+    style: {
+        [klass: string]: any;
+    } | null | undefined;
+    /**
+     * Class of the element.
+     * @group Props
+     */
+    styleClass: string | undefined;
+    /**
+     * MenuModel instance to define the action items.
+     * @group Props
+     */
+    model: MenuItem[] | undefined | null;
+    /**
+     * Position of element. Valid values are 'bottom', 'top', 'left' and 'right'.
+     * @group Props
+     */
+    position: 'bottom' | 'top' | 'left' | 'right';
+    templates: QueryList<PrimeTemplate> | undefined;
+    itemTemplate: TemplateRef<any> | undefined;
     currentIndex: number;
     constructor(el: ElementRef, cd: ChangeDetectorRef);
     ngAfterContentInit(): void;
     onListMouseLeave(): void;
-    onItemMouseEnter(index: any): void;
-    onItemClick(e: any, item: any): void;
+    onItemMouseEnter(index: number): void;
+    onItemClick(e: Event, item: MenuItem): void;
     get containerClass(): {
         [x: string]: boolean;
     };
     isClickableRouterLink(item: any): boolean;
-    itemClass(index: any): {
+    itemClass(index: number): {
         'p-dock-item': boolean;
         'p-dock-item-second-prev': boolean;
         'p-dock-item-prev': boolean;

package/dock/dock.interface.d.ts

@@ -0,0 +1,19 @@
+import { TemplateRef } from '@angular/core';
+/**
+ * Defines valid templates in Dock.
+ * @group Templates
+ */
+export interface DockTemplates {
+    /**
+     * Custom template of item.
+     * @param {Object} context - item data.
+     */
+    item(context: {
+        /**
+         * Item instance.
+         */
+        $implicit: any;
+    }): TemplateRef<{
+        $implicit: any;
+    }>;
+}

package/dock/public_api.d.ts

@@ -1 +1,2 @@
 export * from './dock';
+export * from './dock.interface';

package/dragdrop/dragdrop.d.ts

@@ -1,20 +1,44 @@
-import { OnDestroy, AfterViewInit, ElementRef, EventEmitter, NgZone, Renderer2 } from '@angular/core';
+import { AfterViewInit, ElementRef, EventEmitter, NgZone, OnDestroy, Renderer2 } from '@angular/core';
+import { VoidListener } from 'primeng/ts-helpers';
 import * as i0 from "@angular/core";
 import * as i1 from "@angular/common";
 export declare class Draggable implements AfterViewInit, OnDestroy {
     el: ElementRef;
     zone: NgZone;
     private renderer;
-    scope: string;
-    dragEffect: string;
-    dragHandle: string;
-    onDragStart: EventEmitter<any>;
-    onDragEnd: EventEmitter<any>;
-    onDrag: EventEmitter<any>;
+    scope: string | undefined;
+    /**
+     * Defines the cursor style.
+     * @group Props
+     */
+    dragEffect: 'none' | 'copy' | 'copyLink' | 'copyMove' | 'link' | 'linkMove' | 'move' | 'all' | 'uninitialized' | undefined;
+    /**
+     * Selector to define the drag handle, by default anywhere on the target element is a drag handle to start dragging.
+     * @group Props
+     */
+    dragHandle: string | undefined;
+    /**
+     * Callback to invoke when drag begins.
+     * @param {DragEvent} event - Drag event.
+     * @group Emits
+     */
+    onDragStart: EventEmitter<DragEvent>;
+    /**
+     * Callback to invoke when drag ends.
+     * @param {DragEvent} event - Drag event.
+     * @group Emits
+     */
+    onDragEnd: EventEmitter<DragEvent>;
+    /**
+     * Callback to invoke on dragging.
+     * @param {DragEvent} event - Drag event.
+     * @group Emits
+     */
+    onDrag: EventEmitter<DragEvent>;
     handle: any;
-    dragListener: VoidFunction | null;
-    mouseDownListener: VoidFunction | null;
-    mouseUpListener: VoidFunction | null;
+    dragListener: VoidListener;
+    mouseDownListener: VoidListener;
+    mouseUpListener: VoidListener;
     _pDraggableDisabled: boolean;
     constructor(el: ElementRef, zone: NgZone, renderer: Renderer2);
     get pDraggableDisabled(): boolean;
@@ -24,11 +48,11 @@ export declare class Draggable implements AfterViewInit, OnDestroy {
     unbindDragListener(): void;
     bindMouseListeners(): void;
     unbindMouseListeners(): void;
-    drag(event: any): void;
-    dragStart(event: any): void;
-    dragEnd(event: any): void;
-    mousedown(event: any): void;
-    mouseup(event: any): void;
+    drag(event: DragEvent): void;
+    dragStart(event: DragEvent): void;
+    dragEnd(event: DragEvent): void;
+    mousedown(event: MouseEvent): void;
+    mouseup(event: MouseEvent): void;
     allowDrag(): boolean;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<Draggable, never>;
@@ -38,22 +62,41 @@ export declare class Droppable implements AfterViewInit, OnDestroy {
     el: ElementRef;
     zone: NgZone;
     private renderer;
-    scope: string | string[];
+    scope: string | string[] | undefined;
+    /**
+     * Whether the element is droppable, useful for conditional cases.
+     */
     pDroppableDisabled: boolean;
-    dropEffect: string;
-    onDragEnter: EventEmitter<any>;
-    onDragLeave: EventEmitter<any>;
-    onDrop: EventEmitter<any>;
+    /**
+     * Defines the cursor style, valid values are none, copy, move, link, copyMove, copyLink, linkMove and all.
+     * @group Props
+     */
+    dropEffect: 'none' | 'copy' | 'link' | 'move' | undefined;
+    /**
+     * Callback to invoke when a draggable enters drop area.
+     * @group Emits
+     */
+    onDragEnter: EventEmitter<DragEvent>;
+    /**
+     * Callback to invoke when a draggable leave drop area.
+     * @group Emits
+     */
+    onDragLeave: EventEmitter<DragEvent>;
+    /**
+     * Callback to invoke when a draggable is dropped onto drop area.
+     * @group Emits
+     */
+    onDrop: EventEmitter<DragEvent>;
     constructor(el: ElementRef, zone: NgZone, renderer: Renderer2);
-    dragOverListener: VoidFunction | null;
+    dragOverListener: VoidListener;
     ngAfterViewInit(): void;
     bindDragOverListener(): void;
     unbindDragOverListener(): void;
-    dragOver(event: any): void;
-    drop(event: any): void;
-    dragEnter(event: any): void;
-    dragLeave(event: any): void;
-    allowDrop(event: any): boolean;
+    dragOver(event: DragEvent): void;
+    drop(event: DragEvent): void;
+    dragEnter(event: DragEvent): void;
+    dragLeave(event: DragEvent): void;
+    allowDrop(event: DragEvent): boolean;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<Droppable, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<Droppable, "[pDroppable]", never, { "scope": { "alias": "pDroppable"; "required": false; }; "pDroppableDisabled": { "alias": "pDroppableDisabled"; "required": false; }; "dropEffect": { "alias": "dropEffect"; "required": false; }; }, { "onDragEnter": "onDragEnter"; "onDragLeave": "onDragLeave"; "onDrop": "onDrop"; }, never, never, false, never>;