ng-virtual-list 17.0.13 → 17.0.14

package/lib/components/ng-virtual-list-item.component.d.ts

@@ -1,10 +1,10 @@
 import { TemplateRef } from '@angular/core';
 import { IRenderVirtualListItem } from '../models/render-item.model';
-import { IRect } from '../types';
+import { ISize } from '../types';
 import * as i0 from "@angular/core";
 /**
  * Virtual list item component
- * @link https://github.com/DjonnyX/ng-virtual-list/blob/17.x/projects/ng-virtual-list/src/lib/components/ng-virtual-list-item.component.ts
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/components/ng-virtual-list-item.component.ts
  * @author Evgenii Grebennikov
  * @email djonnyx@gmail.com
  */
@@ -23,7 +23,7 @@ export declare class NgVirtualListItemComponent {
     private _elementRef;
     get element(): HTMLElement;
     constructor();
-    getBounds(): IRect;
+    getBounds(): ISize;
     show(): void;
     hide(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgVirtualListItemComponent, never>;

package/lib/ng-virtual-list.component.d.ts

@@ -2,14 +2,14 @@ import { AfterViewInit, ComponentRef, ElementRef, OnDestroy, TemplateRef, ViewCo
 import { Observable } from 'rxjs';
 import { NgVirtualListItemComponent } from './components/ng-virtual-list-item.component';
 import { IScrollEvent, IVirtualListCollection, IVirtualListStickyMap } from './models';
-import { Id, IRect } from './types';
+import { Id, ISize } from './types';
 import { Direction } from './enums';
 import * as i0 from "@angular/core";
 /**
  * Virtual list component.
  * Maximum performance for extremely large lists.
  * It is based on algorithms for virtualization of screen objects.
- * @link https://github.com/DjonnyX/ng-virtual-list/blob/17.x/projects/ng-virtual-list/src/lib/ng-virtual-list.component.ts
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/ng-virtual-list.component.ts
  * @author Evgenii Grebennikov
  * @email djonnyx@gmail.com
  */
@@ -111,7 +111,7 @@ export declare class NgVirtualListComponent implements AfterViewInit, OnDestroy
     /**
      * Returns the bounds of an element with a given id
      */
-    getItemBounds(id: Id): IRect | undefined;
+    getItemBounds(id: Id): ISize | undefined;
     /**
      * The method scrolls the list to the element with the given id and returns the value of the scrolled area.
      * Behavior accepts the values ​​"auto", "instant" and "smooth".

package/lib/utils/cacheMap.d.ts

@@ -1,10 +1,18 @@
 import { ScrollDirection } from "../models";
-import { EventEmitter, TEventHandler } from "./eventEmitter";
+import { EventEmitter } from "./eventEmitter";
+export declare class CMap<K = string, V = any> {
+    private _dict;
+    constructor(dict?: CMap<K, V>);
+    get(key: K): V;
+    set(key: K, value: V): this;
+    has(key: K): boolean;
+    delete(key: K): void;
+    clear(): void;
+}
 export interface ICacheMap<I = any, B = any> {
-    set: (id: I, bounds: B) => Map<I, B>;
+    set: (id: I, bounds: B) => CMap<I, B>;
     has: (id: I) => boolean;
     get: (id: I) => B | undefined;
-    forEach: (callbackfn: (value: B, key: I, map: Map<I, B>) => void, thisArg?: any) => void;
 }
 type CacheMapEvents = 'change';
 type OnChangeEventListener = (version: number) => void;
@@ -12,13 +20,13 @@ type CacheMapListeners = OnChangeEventListener;
 /**
  * Cache map.
  * Emits a change event on each mutation.
- * @link https://github.com/DjonnyX/ng-virtual-list/blob/17.x/projects/ng-virtual-list/src/lib/utils/cacheMap.ts
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/utils/cacheMap.ts
  * @author Evgenii Grebennikov
  * @email djonnyx@gmail.com
  */
-export declare class CacheMap<I = string | number, B = any, E extends string = CacheMapEvents, L extends TEventHandler = CacheMapListeners> extends EventEmitter<E, L> implements ICacheMap {
-    protected _map: Map<I, B>;
-    protected _snapshot: Map<I, B>;
+export declare class CacheMap<I = string | number, B = any, E = CacheMapEvents, L = CacheMapListeners> extends EventEmitter<E, L> implements ICacheMap {
+    protected _map: CMap<I, B>;
+    protected _snapshot: CMap<I, B>;
     protected _version: number;
     protected _delta: number;
     get delta(): number;
@@ -35,10 +43,9 @@ export declare class CacheMap<I = string | number, B = any, E extends string = C
     private calcScrollDirection;
     protected bumpVersion(): void;
     protected fireChange(): void;
-    set(id: I, bounds: B): Map<I, B>;
+    set(id: I, bounds: B): CMap<I, B>;
     has(id: I): boolean;
     get(id: I): B | undefined;
-    forEach(callbackfn: (value: B, key: I, map: Map<I, B>) => void, thisArg?: any): void;
     snapshot(): void;
     dispose(): void;
 }

package/lib/utils/trackBox.d.ts

@@ -3,8 +3,7 @@ import { NgVirtualListItemComponent } from "../components/ng-virtual-list-item.c
 import { IRenderVirtualListCollection } from "../models/render-collection.model";
 import { IRenderVirtualListItem } from "../models/render-item.model";
 import { Id } from "../types/id";
-import { IRect } from "../types/rect";
-import { CacheMap } from "./cacheMap";
+import { CacheMap, CMap } from "./cacheMap";
 import { Tracker } from "./tracker";
 import { ISize } from "../types";
 import { HEIGHT_PROP_NAME, WIDTH_PROP_NAME } from "../const";
@@ -31,7 +30,6 @@ export interface IMetrics {
     rightItemsWeight: number;
     scrollSize: number;
     leftSizeOfAddedItems: number;
-    rightSizeOfAddedItems: number;
     sizeProperty: typeof HEIGHT_PROP_NAME | typeof WIDTH_PROP_NAME;
     snap: boolean;
     snippedPos: number;
@@ -55,6 +53,19 @@ export interface IRecalculateMetricsOptions<I extends {
     snap: boolean;
     enabledBufferOptimization: boolean;
     fromItemId?: Id;
+    previousTotalSize: number;
+    crudDetected: boolean;
+    deletedItemsMap: {
+        [index: number]: ISize;
+    };
+}
+export interface IGetItemPositionOptions<I extends {
+    id: Id;
+}, C extends Array<I>> extends Omit<IRecalculateMetricsOptions<I, C>, 'previousTotalSize' | 'crudDetected' | 'deletedItemsMap'> {
+}
+export interface IUpdateCollectionOptions<I extends {
+    id: Id;
+}, C extends Array<I>> extends Omit<IRecalculateMetricsOptions<I, C>, 'collection' | 'previousTotalSize' | 'crudDetected' | 'deletedItemsMap'> {
 }
 type CacheMapEvents = typeof TRACK_BOX_CHANGE_EVENT_NAME;
 type OnChangeEventListener = (version: number) => void;
@@ -65,13 +76,19 @@ declare enum ItemDisplayMethods {
     DELETE = 2,
     NOT_CHANGED = 3
 }
+interface IUpdateCollectionReturns {
+    displayItems: IRenderVirtualListCollection;
+    totalSize: number;
+    delta: number;
+    crudDetected: boolean;
+}
 /**
  * An object that performs tracking, calculations and caching.
- * @link https://github.com/DjonnyX/ng-virtual-list/blob/17.x/projects/ng-virtual-list/src/lib/utils/trackBox.ts
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/utils/trackBox.ts
  * @author Evgenii Grebennikov
  * @email djonnyx@gmail.com
  */
-export declare class TrackBox extends CacheMap<Id, IRect & {
+export declare class TrackBox extends CacheMap<Id, ISize & {
     method?: ItemDisplayMethods;
 }, CacheMapEvents, CacheMapListeners> {
     protected _tracker: Tracker<IRenderVirtualListItem, NgVirtualListItemComponent>;
@@ -84,11 +101,17 @@ export declare class TrackBox extends CacheMap<Id, IRect & {
      */
     set trackingPropertyName(v: string);
     constructor(trackingPropertyName: string);
-    set(id: Id, bounds: IRect): Map<Id, IRect>;
+    set(id: Id, bounds: ISize): CMap<Id, ISize>;
     private _fireChanges;
     private _previousCollection;
+    private _deletedItemsMap;
+    private _crudDetected;
+    get crudDetected(): boolean;
     private _debounceChanges;
     protected fireChange(): void;
+    private _previousTotalSize;
+    protected _scrollDelta: number;
+    get scrollDelta(): number;
     /**
      * Scans the collection for deleted items and flushes the deleted item cache.
      */
@@ -106,17 +129,13 @@ export declare class TrackBox extends CacheMap<Id, IRect & {
      */
     getItemPosition<I extends {
         id: Id;
-    }, C extends Array<I>>(id: Id, stickyMap: IVirtualListStickyMap, options: IRecalculateMetricsOptions<I, C>): number;
+    }, C extends Array<I>>(id: Id, stickyMap: IVirtualListStickyMap, options: IGetItemPositionOptions<I, C>): number;
     /**
      * Updates the collection of display objects
      */
     updateCollection<I extends {
         id: Id;
-    }, C extends Array<I>>(items: C, stickyMap: IVirtualListStickyMap, options: Omit<IRecalculateMetricsOptions<I, C>, 'collection'>): {
-        displayItems: IRenderVirtualListCollection;
-        totalSize: number;
-        delta: number;
-    };
+    }, C extends Array<I>>(items: C, stickyMap: IVirtualListStickyMap, options: IUpdateCollectionOptions<I, C>): IUpdateCollectionReturns;
     /**
      * Finds the closest element in the collection by scrollSize
      */
@@ -137,8 +156,6 @@ export declare class TrackBox extends CacheMap<Id, IRect & {
     protected recalculateMetrics<I extends {
         id: Id;
     }, C extends Array<I>>(options: IRecalculateMetricsOptions<I, C>): IMetrics;
-    protected _scrollDelta: number;
-    get scrollDelta(): number;
     clearDeltaDirection(): void;
     clearDelta(clearDirectionDetector?: boolean): void;
     changes(): void;
@@ -153,7 +170,7 @@ export declare class TrackBox extends CacheMap<Id, IRect & {
         [id: number]: number;
     }): void;
     untrackComponentByIdProperty(component?: NgVirtualListItemComponent | undefined): void;
-    getItemBounds(id: Id): IRect | undefined;
+    getItemBounds(id: Id): ISize | undefined;
     protected cacheElements(): void;
     dispose(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ng-virtual-list",
-  "version": "17.0.13",
+  "version": "17.0.14",
   "author": {
     "name": "Evgenii Grebennikov",
     "email": "djonnyx@gmail.com"