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

package/tree/tree.d.ts

@@ -1,7 +1,10 @@
 import { AfterContentInit, ChangeDetectorRef, ElementRef, EventEmitter, OnChanges, OnDestroy, OnInit, QueryList, SimpleChanges, TemplateRef } from '@angular/core';
 import { BlockableUI, PrimeNGConfig, TreeDragDropService, TreeNode } from 'primeng/api';
-import { Scroller, ScrollerOptions } from 'primeng/scroller';
+import { Scroller } from 'primeng/scroller';
+import { ScrollerOptions } from 'primeng/scroller';
 import { Subscription } from 'rxjs';
+import { Nullable } from 'primeng/ts-helpers';
+import { TreeFilterEvent, TreeLazyLoadEvent, TreeNodeCollapseEvent, TreeNodeContextMenuSelectEvent, TreeNodeDropEvent, TreeNodeExpandEvent, TreeNodeSelectEvent, TreeNodeUnSelectEvent, TreeScrollEvent, TreeScrollIndexChangeEvent } from './tree.interface';
 import * as i0 from "@angular/core";
 import * as i1 from "@angular/common";
 import * as i2 from "primeng/api";
@@ -16,21 +19,21 @@ import * as i10 from "primeng/icons/spinner";
 export declare class UITreeNode implements OnInit {
     static ICON_CLASS: string;
     rowNode: any;
-    node: TreeNode;
-    parentNode: TreeNode;
-    root: boolean;
-    index: number;
-    firstChild: boolean;
-    lastChild: boolean;
-    level: number;
-    indentation: number;
-    itemSize: number;
+    node: TreeNode | undefined;
+    parentNode: TreeNode | undefined;
+    root: boolean | undefined;
+    index: number | undefined;
+    firstChild: boolean | undefined;
+    lastChild: boolean | undefined;
+    level: number | undefined;
+    indentation: number | undefined;
+    itemSize: number | undefined;
     tree: Tree;
     timeout: any;
-    constructor(tree: any);
-    draghoverPrev: boolean;
-    draghoverNext: boolean;
-    draghoverNode: boolean;
+    draghoverPrev: boolean | undefined;
+    draghoverNext: boolean | undefined;
+    draghoverNode: boolean | undefined;
+    constructor(tree: Tree);
     ngOnInit(): void;
     getIcon(): string;
     isLeaf(): boolean;
@@ -42,15 +45,15 @@ export declare class UITreeNode implements OnInit {
     onNodeTouchEnd(): void;
     onNodeRightClick(event: MouseEvent): void;
     isSelected(): boolean;
-    onDropPoint(event: Event, position: number): void;
+    onDropPoint(event: DragEvent, position: number): void;
     processPointDrop(event: any): void;
-    createDropPointEventMetadata(position: any): {
+    createDropPointEventMetadata(position: number): {
         dragNode: TreeNode<any>;
         dragNodeIndex: number;
         dragNodeSubNodes: TreeNode<any>[];
         dropNode: TreeNode<any>;
         index: number;
-        position: any;
+        position: number;
     };
     onDropPointDragOver(event: any): void;
     onDropPointDragEnter(event: Event, position: number): void;
@@ -71,7 +74,7 @@ export declare class UITreeNode implements OnInit {
     onKeyDown(event: KeyboardEvent): void;
     findNextSiblingOfAncestor(nodeElement: any): any;
     findLastVisibleDescendant(nodeElement: any): any;
-    getParentNodeElement(nodeElement: any): any;
+    getParentNodeElement(nodeElement: HTMLElement): HTMLElement;
     focusNode(element: any): void;
     focusVirtualNode(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<UITreeNode, never>;
@@ -82,77 +85,279 @@ export declare class Tree implements OnInit, AfterContentInit, OnChanges, OnDest
     dragDropService: TreeDragDropService;
     config: PrimeNGConfig;
     private cd;
-    value: TreeNode[];
-    selectionMode: string;
+    /**
+     * An array of treenodes.
+     * @group Props
+     */
+    value: TreeNode<any> | TreeNode<any>[] | any[] | any;
+    /**
+     * Defines the selection mode.
+     * @group Props
+     */
+    selectionMode: 'single' | 'multiple' | 'checkbox' | null | undefined;
+    /**
+     * A single treenode instance or an array to refer to the selections.
+     * @group Props
+     */
     selection: any;
-    style: any;
-    styleClass: string;
+    /**
+     * Inline style of the component.
+     * @group Props
+     */
+    style: {
+        [klass: string]: any;
+    } | null | undefined;
+    /**
+     * Style class of the component.
+     * @group Props
+     */
+    styleClass: string | undefined;
+    /**
+     * Context menu instance.
+     * @group Props
+     */
     contextMenu: any;
+    /**
+     * Defines the orientation of the tree, valid values are 'vertical' and 'horizontal'.
+     * @group Props
+     */
     layout: string;
+    /**
+     * Scope of the draggable nodes to match a droppableScope.
+     * @group Props
+     */
     draggableScope: any;
+    /**
+     * Scope of the droppable nodes to match a draggableScope.
+     * @group Props
+     */
     droppableScope: any;
-    draggableNodes: boolean;
-    droppableNodes: boolean;
+    /**
+     * Whether the nodes are draggable.
+     * @group Props
+     */
+    draggableNodes: boolean | undefined;
+    /**
+     * Whether the nodes are droppable.
+     * @group Props
+     */
+    droppableNodes: boolean | undefined;
+    /**
+     * Defines how multiple items can be selected, when true metaKey needs to be pressed to select or unselect an item and when set to false selection of each item can be toggled individually. On touch enabled devices, metaKeySelection is turned off automatically.
+     * @group Props
+     */
     metaKeySelection: boolean;
+    /**
+     * Whether checkbox selections propagate to ancestor nodes.
+     * @group Props
+     */
     propagateSelectionUp: boolean;
+    /**
+     * Whether checkbox selections propagate to descendant nodes.
+     * @group Props
+     */
     propagateSelectionDown: boolean;
-    loading: boolean;
-    loadingIcon: string;
+    /**
+     * Displays a loader to indicate data load is in progress.
+     * @group Props
+     */
+    loading: boolean | undefined;
+    /**
+     * The icon to show while indicating data load is in progress.
+     * @group Props
+     */
+    loadingIcon: string | undefined;
+    /**
+     * Text to display when there is no data.
+     * @group Props
+     */
     emptyMessage: string;
-    ariaLabel: string;
-    togglerAriaLabel: string;
-    ariaLabelledBy: string;
-    validateDrop: boolean;
-    filter: boolean;
+    /**
+     * Used to define a string that labels the tree.
+     * @group Props
+     */
+    ariaLabel: string | undefined;
+    /**
+     * Defines a string that labels the toggler icon for accessibility.
+     * @group Props
+     */
+    togglerAriaLabel: string | undefined;
+    /**
+     * Establishes relationships between the component and label(s) where its value should be one or more element IDs.
+     * @group Props
+     */
+    ariaLabelledBy: string | undefined;
+    /**
+     * When enabled, drop can be accepted or rejected based on condition defined at onNodeDrop.
+     * @group Props
+     */
+    validateDrop: boolean | undefined;
+    /**
+     * When specified, displays an input field to filter the items.
+     * @group Props
+     */
+    filter: boolean | undefined;
+    /**
+     * When filtering is enabled, filterBy decides which field or fields (comma separated) to search against.
+     * @group Props
+     */
     filterBy: string;
+    /**
+     * Mode for filtering valid values are "lenient" and "strict". Default is lenient.
+     * @group Props
+     */
     filterMode: string;
-    filterPlaceholder: string;
-    filteredNodes: TreeNode[];
-    filterLocale: string;
-    scrollHeight: string;
+    /**
+     * Placeholder text to show when filter input is empty.
+     * @group Props
+     */
+    filterPlaceholder: string | undefined;
+    /**
+     * No description available.
+     * @group Props
+     */
+    filteredNodes: TreeNode[] | undefined | null;
+    /**
+     * Locale to use in filtering. The default locale is the host environment's current locale.
+     * @group Props
+     */
+    filterLocale: string | undefined;
+    /**
+     * Height of the scrollable viewport.
+     * @group Props
+     */
+    scrollHeight: string | undefined;
+    /**
+     * Defines if data is loaded and interacted with in lazy manner.
+     * @group Props
+     */
     lazy: boolean;
-    virtualScroll: boolean;
-    virtualScrollItemSize: number;
-    virtualScrollOptions: ScrollerOptions;
+    /**
+     * Whether the data should be loaded on demand during scroll.
+     * @group Props
+     */
+    virtualScroll: boolean | undefined;
+    /**
+     * Height of an item in the list for VirtualScrolling.
+     * @group Props
+     */
+    virtualScrollItemSize: number | undefined;
+    /**
+     * Whether to use the scroller feature. The properties of scroller component can be used like an object in it.
+     * @group Props
+     */
+    virtualScrollOptions: ScrollerOptions | undefined;
+    /**
+     * Indentation factor for spacing of the nested node when virtual scrolling is enabled.
+     * @group Props
+     */
     indentation: number;
+    /**
+     * Custom templates of the component.
+     * @group Props
+     */
     _templateMap: any;
+    /**
+     * Function to optimize the node list rendering, default algorithm checks for object identity.
+     * @group Props
+     */
     trackBy: Function;
-    selectionChange: EventEmitter<any>;
-    onNodeSelect: EventEmitter<any>;
-    onNodeUnselect: EventEmitter<any>;
-    onNodeExpand: EventEmitter<any>;
-    onNodeCollapse: EventEmitter<any>;
-    onNodeContextMenuSelect: EventEmitter<any>;
-    onNodeDrop: EventEmitter<any>;
-    onLazyLoad: EventEmitter<any>;
-    onScroll: EventEmitter<any>;
-    onScrollIndexChange: EventEmitter<any>;
-    onFilter: EventEmitter<any>;
-    templates: QueryList<any>;
-    filterViewChild: ElementRef;
-    scroller: Scroller;
-    wrapperViewChild: ElementRef;
-    _virtualNodeHeight: number;
-    get virtualNodeHeight(): number;
-    set virtualNodeHeight(val: number);
-    serializedValue: any[];
-    headerTemplate: TemplateRef<any>;
-    footerTemplate: TemplateRef<any>;
-    loaderTemplate: TemplateRef<any>;
-    emptyMessageTemplate: TemplateRef<any>;
-    togglerIconTemplate: TemplateRef<any>;
-    checkboxIconTemplate: TemplateRef<any>;
-    loadingIconTemplate: TemplateRef<any>;
-    filterIconTemplate: TemplateRef<any>;
-    nodeTouched: boolean;
-    dragNodeTree: Tree;
-    dragNode: TreeNode;
-    dragNodeSubNodes: TreeNode[];
-    dragNodeIndex: number;
+    /**
+     * @deprecated use virtualScrollItemSize property instead.
+     * Height of the node.
+     * @group Props
+     */
+    _virtualNodeHeight: number | undefined;
+    get virtualNodeHeight(): number | undefined;
+    set virtualNodeHeight(val: number | undefined);
+    /**
+     * Callback to invoke on selection change.
+     * @param {(TreeNode | TreeNode[] | null)} event - custom selection change event.
+     * @group Emits
+     */
+    selectionChange: EventEmitter<TreeNode[] | TreeNode | null>;
+    /**
+     * Callback to invoke when a node is selected.
+     * @param {TreeNodeSelectEvent} event - node select event.
+     * @group Emits
+     */
+    onNodeSelect: EventEmitter<TreeNodeSelectEvent>;
+    /**
+     * Callback to invoke when a node is unselected.
+     * @param {TreeNodeUnSelectEvent} event - node unselect event.
+     * @group Emits
+     */
+    onNodeUnselect: EventEmitter<TreeNodeUnSelectEvent>;
+    /**
+     * Callback to invoke when a node is expanded.
+     * @param {TreeNodeExpandEvent} event - node expand event.
+     * @group Emits
+     */
+    onNodeExpand: EventEmitter<TreeNodeExpandEvent>;
+    /**
+     * Callback to invoke when a node is collapsed.
+     * @param {TreeNodeCollapseEvent} event - node collapse event.
+     * @group Emits
+     */
+    onNodeCollapse: EventEmitter<TreeNodeCollapseEvent>;
+    /**
+     * Callback to invoke when a node is selected with right click.
+     * @param {onNodeContextMenuSelect} event - node context menu select event.
+     * @group Emits
+     */
+    onNodeContextMenuSelect: EventEmitter<TreeNodeContextMenuSelectEvent>;
+    /**
+     * Callback to invoke when a node is dropped.
+     * @param {TreeNodeDropEvent} event - node drop event.
+     * @group Emits
+     */
+    onNodeDrop: EventEmitter<TreeNodeDropEvent>;
+    /**
+     * Callback to invoke in lazy mode to load new data.
+     * @param {TreeLazyLoadEvent} event - custom lazy load event.
+     * @group Emits
+     */
+    onLazyLoad: EventEmitter<TreeLazyLoadEvent>;
+    /**
+     * Callback to invoke in virtual scroll mode when scroll position changes.
+     * @param {TreeScrollEvent} event - custom scroll event.
+     * @group Emits
+     */
+    onScroll: EventEmitter<TreeScrollEvent>;
+    /**
+     * Callback to invoke in virtual scroll mode when scroll position and item's range in view changes.
+     * @param {TreeScrollIndexChangeEvent} event - scroll index change event.
+     * @group Emits
+     */
+    onScrollIndexChange: EventEmitter<TreeScrollIndexChangeEvent>;
+    /**
+     * Callback to invoke when data is filtered.
+     * @param {TreeFilterEvent} event - custom filter event.
+     * @group Emits
+     */
+    onFilter: EventEmitter<TreeFilterEvent>;
+    templates: Nullable<QueryList<any>>;
+    filterViewChild: Nullable<ElementRef>;
+    scroller: Nullable<Scroller>;
+    wrapperViewChild: Nullable<ElementRef>;
+    serializedValue: Nullable<TreeNode[]>;
+    headerTemplate: Nullable<TemplateRef<any>>;
+    footerTemplate: Nullable<TemplateRef<any>>;
+    loaderTemplate: Nullable<TemplateRef<any>>;
+    emptyMessageTemplate: Nullable<TemplateRef<any>>;
+    togglerIconTemplate: Nullable<TemplateRef<any>>;
+    checkboxIconTemplate: Nullable<TemplateRef<any>>;
+    loadingIconTemplate: Nullable<TemplateRef<any>>;
+    filterIconTemplate: Nullable<TemplateRef<any>>;
+    nodeTouched: boolean | undefined | null;
+    dragNodeTree: Tree | undefined | null;
+    dragNode: TreeNode | undefined | null;
+    dragNodeSubNodes: TreeNode[] | undefined | null;
+    dragNodeIndex: number | undefined | null;
     dragNodeScope: any;
-    dragHover: boolean;
-    dragStartSubscription: Subscription;
-    dragStopSubscription: Subscription;
+    dragHover: boolean | undefined | null;
+    dragStartSubscription: Subscription | undefined | null;
+    dragStopSubscription: Subscription | undefined | null;
     constructor(el: ElementRef, dragDropService: TreeDragDropService, config: PrimeNGConfig, cd: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnChanges(simpleChange: SimpleChanges): void;
@@ -160,41 +365,37 @@ export declare class Tree implements OnInit, AfterContentInit, OnChanges, OnDest
     get emptyMessageLabel(): string;
     ngAfterContentInit(): void;
     updateSerializedValue(): void;
-    serializeNodes(parent: any, nodes: any, level: any, visible: any): void;
-    onNodeClick(event: any, node: TreeNode): void;
+    serializeNodes(parent: TreeNode | null, nodes: TreeNode[] | any, level: number, visible: boolean): void;
+    onNodeClick(event: Event, node: TreeNode): void;
     onNodeTouchEnd(): void;
     onNodeRightClick(event: MouseEvent, node: TreeNode): void;
     findIndexInSelection(node: TreeNode): number;
-    syncNodeOption(node: any, parentNodes: any, option: any, value?: any): void;
+    syncNodeOption(node: TreeNode, parentNodes: TreeNode[], option: any, value?: any): void;
     hasFilteredNodes(): number;
-    getNodeWithKey(key: string, nodes: TreeNode[]): any;
+    getNodeWithKey(key: string, nodes: TreeNode[]): TreeNode | undefined;
     propagateUp(node: TreeNode, select: boolean): void;
     propagateDown(node: TreeNode, select: boolean): void;
     isSelected(node: TreeNode): boolean;
     isSingleSelectionMode(): boolean;
     isMultipleSelectionMode(): boolean;
     isCheckboxSelectionMode(): boolean;
-    isNodeLeaf(node: any): boolean;
-    getRootNode(): TreeNode<any>[];
-    getTemplateForNode(node: TreeNode): TemplateRef<any>;
-    onDragOver(event: any): void;
-    onDrop(event: any): void;
-    processTreeDrop(dragNode: any, dragNodeIndex: any): void;
+    isNodeLeaf(node: TreeNode): boolean;
+    getRootNode(): any;
+    getTemplateForNode(node: TreeNode): TemplateRef<any> | null;
+    onDragOver(event: DragEvent): void;
+    onDrop(event: DragEvent): void;
+    processTreeDrop(dragNode: TreeNode, dragNodeIndex: number): void;
     onDragEnter(): void;
-    onDragLeave(event: any): void;
-    allowDrop(dragNode: TreeNode, dropNode: TreeNode, dragNodeScope: any): boolean;
+    onDragLeave(event: DragEvent): void;
+    allowDrop(dragNode: TreeNode, dropNode: TreeNode | null, dragNodeScope: any): boolean;
     isValidDragScope(dragScope: any): boolean;
-    _filter(value: any): void;
+    _filter(value: string): void;
     resetFilter(): void;
     scrollToVirtualIndex(index: number): void;
     scrollTo(options: any): void;
-    findFilteredNodes(node: any, paramsWithoutNode: any): boolean;
-    isFilterMatched(node: any, { searchFields, filterText, isStrictMode }: {
-        searchFields: any;
-        filterText: any;
-        isStrictMode: any;
-    }): boolean;
-    getIndex(options: any, index: any): any;
+    findFilteredNodes(node: TreeNode, paramsWithoutNode: any): boolean;
+    isFilterMatched(node: TreeNode, params: any): boolean;
+    getIndex(options: any, index: number): any;
     getBlockableElement(): HTMLElement;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<Tree, [null, { optional: true; }, null, null]>;

package/tree/tree.interface.d.ts

@@ -0,0 +1,183 @@
+import { TemplateRef } from '@angular/core';
+import { TreeNode } from 'primeng/api';
+import { ScrollerOptions } from 'primeng/scroller';
+/**
+ * Custom node select event.
+ * @see {@link Tree.onNodeSelect}
+ */
+export interface TreeNodeSelectEvent {
+    /**
+     * Browser event
+     */
+    originalEvent: Event;
+    /**
+     * Node instance.
+     */
+    node: TreeNode;
+}
+/**
+ * Custom node unselect event.
+ * @see {@link Tree.onNodeUnSelect}
+ * @extends {TreeNodeSelectEvent}
+ */
+export interface TreeNodeUnSelectEvent extends TreeNodeSelectEvent {
+}
+/**
+ * Custom node expand event.
+ * @see {@link Tree.onNodeExpand}
+ * @extends {TreeNodeSelectEvent}
+ */
+export interface TreeNodeExpandEvent extends TreeNodeSelectEvent {
+}
+/**
+ * Custom node collapse event.
+ * @see {@link Tree.onNodeCollapse}
+ * @extends {TreeNodeSelectEvent}
+ */
+export interface TreeNodeCollapseEvent extends TreeNodeSelectEvent {
+}
+/**
+ * Custom context menu select event.
+ * @see {@link Tree.onNodeContextMenuSelect}
+ * @extends {TreeNodeSelectEvent}
+ */
+export interface TreeNodeContextMenuSelectEvent extends TreeNodeSelectEvent {
+}
+/**
+ * Custom node drop event.
+ * @see {@link Tree.onNodeDrop}
+ */
+export interface TreeNodeDropEvent {
+    /**
+     * Browser drag event.
+     */
+    originalEvent?: DragEvent;
+    /**
+     * Dragged node instance.
+     */
+    dragNode?: TreeNode | null;
+    /**
+     * Dropped node instance.
+     */
+    dropNode?: TreeNode | null;
+    /**
+     * Index of the dragged node.
+     */
+    index?: number;
+    /**
+     * Callback to invoke on drop.
+     */
+    accept?: Function;
+}
+/**
+ * Custom lazy load event.
+ * @see {@link Tree.onLazyLoad}
+ */
+export interface TreeLazyLoadEvent {
+    /**
+     * First element in viewport.
+     */
+    first: any;
+    /**
+     * Last element in viewport.
+     */
+    last: any;
+}
+/**
+ * Custom scroll index change event.
+ * @see {@link Tree.onScrollIndexChange}
+ */
+export interface TreeScrollIndexChangeEvent extends TreeLazyLoadEvent {
+}
+/**
+ * Custom scroll event.
+ * @see {@link Tree.onScroll}
+ */
+export interface TreeScrollEvent {
+    /**
+     * Browser event.
+     */
+    originalEvent?: Event;
+}
+/**
+ * Custom filter event.
+ * @see {@link Tree.onFilter}
+ */
+export interface TreeFilterEvent {
+    /**
+     * Filter value.
+     */
+    filter: string;
+    /**
+     * Filtered nodes.
+     */
+    filteredValue: TreeNode[] | null | undefined;
+}
+/**
+ * Defines valid templates in Tree.
+ * @group Templates
+ */
+export interface TreeTemplates {
+    /**
+     * Custom header template.
+     */
+    header: TemplateRef<any>;
+    /**
+     * Custom empty message template.
+     */
+    empty: TemplateRef<any>;
+    /**
+     * Custom footer template.
+     */
+    footer: TemplateRef<any>;
+    /**
+     * Custom loader template.
+     * @param {Object} context - loader options.
+     */
+    loader(context: {
+        /**
+         * Scroller options.
+         * @see {@link ScrollerOptions}
+         */
+        options: ScrollerOptions;
+    }): TemplateRef<{
+        options: ScrollerOptions;
+    }>;
+    /**
+     * Custom toggler icon template.
+     * @param {Object} context - expand data.
+     */
+    togglericon(context: {
+        /**
+         * Expanded state of the node.
+         */
+        $implicit: boolean;
+    }): TemplateRef<{
+        $implicit: boolean;
+    }>;
+    /**
+     * Custom checkbox icon template.
+     * @param {Object} context - node data.
+     */
+    checkboxicon(context: {
+        /**
+         * Checked state of the node.
+         */
+        $implicit: boolean;
+        /**
+         * Partial selection state of the node.
+         */
+        partialSelected: boolean;
+    }): TemplateRef<{
+        $implicit: boolean;
+        partialSelected: boolean;
+    }>;
+    /**
+     * Custom loading icon template.
+     */
+    loadingicon: TemplateRef<any>;
+    /**
+     * Custom filter icon template.
+     */
+    filtericon: TemplateRef<any>;
+}

package/treeselect/public_api.d.ts

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