ng-virtual-list 18.2.0 → 18.3.1

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

@@ -1,6 +1,7 @@
-import { TemplateRef } from '@angular/core';
+import { ChangeDetectorRef, ElementRef, TemplateRef } from '@angular/core';
 import { IRenderVirtualListItem } from '../models/render-item.model';
 import { ISize } from '../types';
+import { BaseVirtualListItemComponent } from '../models';
 import * as i0 from "@angular/core";
 /**
  * Virtual list item component
@@ -8,22 +9,22 @@ import * as i0 from "@angular/core";
  * @author Evgenii Grebennikov
  * @email djonnyx@gmail.com
  */
-export declare class NgVirtualListItemComponent {
-    private static __nextId;
-    private _id;
+export declare class NgVirtualListItemComponent extends BaseVirtualListItemComponent {
+    protected static __nextId: number;
+    protected _id: number;
     get id(): number;
-    private _cdr;
+    protected _cdr: ChangeDetectorRef;
     regular: boolean;
     data: import("@angular/core").WritableSignal<IRenderVirtualListItem | undefined>;
-    private _data;
+    protected _data: IRenderVirtualListItem | undefined;
     set item(v: IRenderVirtualListItem | undefined);
-    private _regularLength;
+    protected _regularLength: string;
     set regularLength(v: string);
     get item(): IRenderVirtualListItem | undefined;
     get itemId(): import("../types").Id | undefined;
     itemRenderer: import("@angular/core").WritableSignal<TemplateRef<any> | undefined>;
     set renderer(v: TemplateRef<any> | undefined);
-    private _elementRef;
+    protected _elementRef: ElementRef<HTMLElement>;
     get element(): HTMLElement;
     constructor();
     protected update(): void;

package/lib/enums/direction.d.ts

@@ -5,4 +5,4 @@ import { Directions } from "./directions";
  * @author Evgenii Grebennikov
  * @email djonnyx@gmail.com
  */
-export type Direction = Directions | 'hotizontal' | 'vertical';
+export type Direction = Directions | 'horizontal' | 'vertical';

package/lib/models/base-virtual-list-item-component.d.ts

@@ -0,0 +1,25 @@
+import { TemplateRef, WritableSignal } from '@angular/core';
+import { Id, ISize } from '../types';
+import { IRenderVirtualListItem } from './render-item.model';
+/**
+ * Virtual List Item Interface
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/18.x/projects/ng-virtual-list/src/lib/models/base-virtual-list-item-component.ts
+ * @author Evgenii Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export declare abstract class BaseVirtualListItemComponent {
+    abstract get id(): number;
+    abstract data: WritableSignal<IRenderVirtualListItem | undefined>;
+    abstract regular: boolean;
+    abstract set regularLength(v: string);
+    abstract set item(v: IRenderVirtualListItem | null | undefined);
+    abstract get item(): IRenderVirtualListItem | null | undefined;
+    abstract get itemId(): Id | undefined;
+    abstract itemRenderer: WritableSignal<TemplateRef<any> | undefined>;
+    abstract set renderer(v: TemplateRef<any> | undefined);
+    abstract get element(): HTMLElement;
+    protected abstract update(): void;
+    abstract getBounds(): ISize;
+    abstract show(): void;
+    abstract hide(): void;
+}

package/lib/models/collection.model.d.ts

@@ -5,5 +5,5 @@ import { IVirtualListItem } from "./item.model";
  * @author Evgenii Grebennikov
  * @email djonnyx@gmail.com
  */
-export interface IVirtualListCollection extends Array<IVirtualListItem> {
+export interface IVirtualListCollection<E = Object> extends Array<IVirtualListItem<E>> {
 }

package/lib/models/component.model.d.ts

@@ -0,0 +1,3 @@
+export interface Component$1<T> extends Function {
+    new (...args: any[]): T;
+}

package/lib/models/index.d.ts

@@ -3,4 +3,7 @@ import { IScrollEvent } from './scroll-event.model';
 import { IVirtualListItem } from './item.model';
 import { IVirtualListStickyMap } from './sticky-map.model';
 import { IVirtualListCollection } from './collection.model';
-export type { ScrollDirection, IScrollEvent, IVirtualListItem, IVirtualListStickyMap, IVirtualListCollection, };
+import { BaseVirtualListItemComponent } from './base-virtual-list-item-component';
+import { Component$1 } from './component.model';
+export type { ScrollDirection, IScrollEvent, IVirtualListItem, IVirtualListStickyMap, IVirtualListCollection, Component$1, };
+export { BaseVirtualListItemComponent, };

package/lib/models/item.model.d.ts

@@ -5,10 +5,10 @@ import { Id } from "../types/id";
  * @author Evgenii Grebennikov
  * @email djonnyx@gmail.com
  */
-export interface IVirtualListItem {
+export type IVirtualListItem<E = Object> = E & {
     /**
      * Unique identifier of the element.
      */
     id: Id;
     [x: string]: any;
-}
+};

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

@@ -1,9 +1,10 @@
 import { AfterViewInit, ComponentRef, ElementRef, OnDestroy, OnInit, TemplateRef, ViewContainerRef, WritableSignal } from '@angular/core';
 import { Observable } from 'rxjs';
-import { NgVirtualListItemComponent } from './components/ng-virtual-list-item.component';
-import { IScrollEvent, IVirtualListCollection, IVirtualListStickyMap } from './models';
+import { BaseVirtualListItemComponent, Component$1, IScrollEvent, IVirtualListCollection, IVirtualListStickyMap } from './models';
 import { Id, ISize } from './types';
+import { IRenderVirtualListCollection } from './models/render-collection.model';
 import { Direction, SnappingMethod } from './enums';
+import { TrackBox } from './utils';
 import * as i0 from "@angular/core";
 /**
  * Virtual list component.
@@ -14,8 +15,8 @@ import * as i0 from "@angular/core";
  * @email djonnyx@gmail.com
  */
 export declare class NgVirtualListComponent implements AfterViewInit, OnInit, OnDestroy {
-    private static __nextId;
-    private _id;
+    protected static __nextId: number;
+    protected _id: number;
     /**
      * Readonly. Returns the unique identifier of the component.
      */
@@ -33,11 +34,11 @@ export declare class NgVirtualListComponent implements AfterViewInit, OnInit, On
      * Fires when the list has completed scrolling.
      */
     onScrollEnd: import("@angular/core").OutputEmitterRef<IScrollEvent>;
-    private _itemsOptions;
+    protected _itemsOptions: any;
     /**
      * Collection of list items.
      */
-    items: import("@angular/core").InputSignal<IVirtualListCollection>;
+    items: import("@angular/core").InputSignal<IVirtualListCollection<Object>>;
     /**
      * Determines whether elements will snap. Default value is "true".
      */
@@ -53,12 +54,13 @@ export declare class NgVirtualListComponent implements AfterViewInit, OnInit, On
      * Rendering element template.
      */
     itemRenderer: import("@angular/core").InputSignal<TemplateRef<any>>;
+    protected _itemRenderer: WritableSignal<TemplateRef<any> | undefined>;
     /**
      * Dictionary zIndex by id of the list element. If the value is not set or equal to 0,
      * then a simple element is displayed, if the value is greater than 0, then the sticky position mode is enabled for the element.
      */
     stickyMap: import("@angular/core").InputSignal<IVirtualListStickyMap>;
-    private _itemSizeOptions;
+    protected _itemSizeOptions: any;
     /**
      * If direction = 'vertical', then the height of a typical element. If direction = 'horizontal', then the width of a typical element.
      * Ignored if the dynamicSize property is true.
@@ -86,41 +88,51 @@ export declare class NgVirtualListComponent implements AfterViewInit, OnInit, On
     protected _isSnappingMethodAdvanced: boolean;
     get isSnappingMethodAdvanced(): boolean;
     protected _isVertical: boolean;
-    protected _displayComponents: Array<ComponentRef<NgVirtualListItemComponent>>;
-    protected _snapedDisplayComponent: ComponentRef<NgVirtualListItemComponent> | undefined;
+    protected _displayComponents: Array<ComponentRef<BaseVirtualListItemComponent>>;
+    protected _snapedDisplayComponent: ComponentRef<BaseVirtualListItemComponent> | undefined;
     protected _bounds: WritableSignal<ISize | null>;
     protected _scrollSize: WritableSignal<number>;
-    private _resizeObserver;
-    private _resizeSnappedComponentHandler;
-    private _resizeSnappedObserver;
-    private _componentsResizeObserver;
-    private _onResizeHandler;
-    private _onScrollHandler;
-    private _elementRef;
-    private _initialized;
+    protected _resizeObserver: ResizeObserver | null;
+    protected _resizeSnappedComponentHandler: () => void;
+    protected _resizeSnappedObserver: ResizeObserver | null;
+    protected _componentsResizeObserver: ResizeObserver;
+    protected _onResizeHandler: () => void;
+    protected _onScrollHandler: (e?: Event) => void;
+    protected _elementRef: ElementRef<any>;
+    protected _initialized: WritableSignal<boolean>;
     readonly $initialized: Observable<boolean>;
     /**
      * The name of the property by which tracking is performed
      */
     trackBy: import("@angular/core").InputSignal<string>;
+    /**
+     * Base class of the element component
+     */
+    protected _itemComponentClass: Component$1<BaseVirtualListItemComponent>;
+    /**
+     * Base class trackBox
+     */
+    protected _trackBoxClass: Component$1<TrackBox>;
     /**
      * Dictionary of element sizes by their id
      */
-    private _trackBox;
-    private _onTrackBoxChangeHandler;
+    protected _trackBox: TrackBox;
+    protected _onTrackBoxChangeHandler: (v: number) => void;
     protected _cacheVersion: WritableSignal<number>;
     constructor();
-    private listenCacheChangesIfNeed;
-    private getIsSnappingMethodAdvanced;
-    private getIsVertical;
-    private createDisplayComponentsIfNeed;
-    private updateRegularRenderer;
-    private resetRenderers;
+    protected setupRenderer(): void;
+    protected onInit(): void;
+    protected listenCacheChangesIfNeed(value: boolean): void;
+    protected getIsSnappingMethodAdvanced(m?: SnappingMethod): boolean;
+    protected getIsVertical(d?: Direction): boolean;
+    protected createDisplayComponentsIfNeed(displayItems: IRenderVirtualListCollection | null): void;
+    protected updateRegularRenderer(): void;
+    protected resetRenderers(itemRenderer?: TemplateRef<HTMLElement>): void;
     /**
      * Tracking by id
      */
     protected tracking(): void;
-    private resetBoundsSize;
+    protected resetBoundsSize(isVertical: boolean, totalSize: number): void;
     /**
      * Returns the bounds of an element with a given id
      */
@@ -130,15 +142,17 @@ export declare class NgVirtualListComponent implements AfterViewInit, OnInit, On
      * Behavior accepts the values ​​"auto", "instant" and "smooth".
      */
     scrollTo(id: Id, behavior?: ScrollBehavior): void;
-    private _scrollToRepeatExecutionTimeout;
-    private clearScrollToRepeatExecutionTimeout;
+    protected _scrollToRepeatExecutionTimeout: number | undefined;
+    protected clearScrollToRepeatExecutionTimeout(): void;
     protected scrollToExecutor(id: Id, behavior: ScrollBehavior, iteration?: number, isLastIteration?: boolean): void;
     /**
      * Scrolls the scroll area to the desired element with the specified ID.
      */
     scrollToEnd(behavior?: ScrollBehavior): void;
-    private _onContainerScrollHandler;
-    private _onContainerScrollEndHandler;
+    protected _onContainerScrollHandler: (e: Event) => void;
+    protected _onContainerScrollEndHandler: (e: Event) => void;
+    protected afterViewInit(): void;
+    protected dispose(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgVirtualListComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NgVirtualListComponent, "ng-virtual-list", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "snap": { "alias": "snap"; "required": false; "isSignal": true; }; "enabledBufferOptimization": { "alias": "enabledBufferOptimization"; "required": false; "isSignal": true; }; "itemRenderer": { "alias": "itemRenderer"; "required": true; "isSignal": true; }; "stickyMap": { "alias": "stickyMap"; "required": false; "isSignal": true; }; "itemSize": { "alias": "itemSize"; "required": false; "isSignal": true; }; "dynamicSize": { "alias": "dynamicSize"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "itemsOffset": { "alias": "itemsOffset"; "required": false; "isSignal": true; }; "snappingMethod": { "alias": "snappingMethod"; "required": false; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; }, { "onScroll": "onScroll"; "onScrollEnd": "onScrollEnd"; }, never, never, false, never>;
 }

package/lib/utils/index.d.ts

@@ -2,6 +2,8 @@ import { isDirection } from "./isDirection";
 import { debounce } from "./debounce";
 import { toggleClassName } from './toggleClassName';
 import { Tracker } from "./tracker";
-import { TrackBox } from "./trackBox";
+import { TrackBox, IUpdateCollectionReturns, TRACK_BOX_CHANGE_EVENT_NAME, IMetrics, IRecalculateMetricsOptions, IGetItemPositionOptions, IUpdateCollectionOptions, CacheMapEvents, OnChangeEventListener, CacheMapListeners, ItemDisplayMethods } from "./trackBox";
+import { CMap, ICacheMap, CACHE_BOX_CHANGE_EVENT_NAME } from './cacheMap';
 import { ScrollEvent } from "./scrollEvent";
-export { isDirection, debounce, toggleClassName, ScrollEvent, TrackBox, Tracker, };
+export { isDirection, debounce, toggleClassName, ScrollEvent, TrackBox, Tracker, TRACK_BOX_CHANGE_EVENT_NAME, CMap, CACHE_BOX_CHANGE_EVENT_NAME, };
+export type { ICacheMap, IUpdateCollectionReturns, IMetrics, IRecalculateMetricsOptions, IGetItemPositionOptions, IUpdateCollectionOptions, CacheMapEvents, OnChangeEventListener, CacheMapListeners, ItemDisplayMethods, };

package/lib/utils/trackBox.d.ts

@@ -1,13 +1,11 @@
 import { ComponentRef } from "@angular/core";
-import { NgVirtualListItemComponent } from "../components/ng-virtual-list-item.component";
 import { IRenderVirtualListCollection } from "../models/render-collection.model";
-import { IRenderVirtualListItem } from "../models/render-item.model";
 import { Id } from "../types/id";
 import { CacheMap, CMap } from "./cacheMap";
 import { Tracker } from "./tracker";
 import { ISize } from "../types";
 import { HEIGHT_PROP_NAME, WIDTH_PROP_NAME } from "../const";
-import { IVirtualListStickyMap } from "../models";
+import { BaseVirtualListItemComponent, IVirtualListStickyMap } from "../models";
 export declare const TRACK_BOX_CHANGE_EVENT_NAME = "change";
 export interface IMetrics {
     delta: number;
@@ -67,16 +65,16 @@ 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;
-type CacheMapListeners = OnChangeEventListener;
-declare enum ItemDisplayMethods {
+export type CacheMapEvents = typeof TRACK_BOX_CHANGE_EVENT_NAME;
+export type OnChangeEventListener = (version: number) => void;
+export type CacheMapListeners = OnChangeEventListener;
+export declare enum ItemDisplayMethods {
     CREATE = 0,
     UPDATE = 1,
     DELETE = 2,
     NOT_CHANGED = 3
 }
-interface IUpdateCollectionReturns {
+export interface IUpdateCollectionReturns {
     displayItems: IRenderVirtualListCollection;
     totalSize: number;
     delta: number;
@@ -88,16 +86,16 @@ interface IUpdateCollectionReturns {
  * @author Evgenii Grebennikov
  * @email djonnyx@gmail.com
  */
-export declare class TrackBox extends CacheMap<Id, ISize & {
+export declare class TrackBox<C extends BaseVirtualListItemComponent = any> extends CacheMap<Id, ISize & {
     method?: ItemDisplayMethods;
 }, CacheMapEvents, CacheMapListeners> {
-    protected _tracker: Tracker<IRenderVirtualListItem, NgVirtualListItemComponent>;
+    protected _tracker: Tracker<C>;
     protected _items: IRenderVirtualListCollection | null | undefined;
     set items(v: IRenderVirtualListCollection | null | undefined);
-    protected _displayComponents: Array<ComponentRef<NgVirtualListItemComponent>> | null | undefined;
-    set displayComponents(v: Array<ComponentRef<NgVirtualListItemComponent>> | null | undefined);
-    protected _snapedDisplayComponent: ComponentRef<NgVirtualListItemComponent> | null | undefined;
-    set snapedDisplayComponent(v: ComponentRef<NgVirtualListItemComponent> | null | undefined);
+    protected _displayComponents: Array<ComponentRef<C>> | null | undefined;
+    set displayComponents(v: Array<ComponentRef<C>> | null | undefined);
+    protected _snapedDisplayComponent: ComponentRef<C> | null | undefined;
+    set snapedDisplayComponent(v: ComponentRef<C> | null | undefined);
     protected _isSnappingMethodAdvanced: boolean;
     set isSnappingMethodAdvanced(v: boolean);
     /**
@@ -106,12 +104,16 @@ export declare class TrackBox extends CacheMap<Id, ISize & {
     set trackingPropertyName(v: string);
     constructor(trackingPropertyName: string);
     set(id: Id, bounds: ISize): CMap<Id, ISize>;
-    private _previousCollection;
-    private _deletedItemsMap;
-    private _crudDetected;
+    protected _previousCollection: Array<{
+        id: Id;
+    }> | null | undefined;
+    protected _deletedItemsMap: {
+        [index: number]: ISize;
+    };
+    protected _crudDetected: boolean;
     get crudDetected(): boolean;
     protected fireChangeIfNeed(): void;
-    private _previousTotalSize;
+    protected _previousTotalSize: number;
     protected _scrollDelta: number;
     get scrollDelta(): number;
     protected lifeCircle(): void;
@@ -148,11 +150,18 @@ export declare class TrackBox extends CacheMap<Id, ISize & {
     /**
      * Calculates the position of an element based on the given scrollSize
      */
-    private getElementFromStart;
+    protected getElementFromStart<I extends {
+        id: Id;
+    }, C extends Array<I>>(scrollSize: number, collection: C, map: CMap<Id, ISize>, typicalItemSize: number, isVertical: boolean): I | undefined;
     /**
      * Calculates the entry into the overscroll area and returns the number of overscroll elements
      */
-    private getElementNumToEnd;
+    protected getElementNumToEnd<I extends {
+        id: Id;
+    }, C extends Array<I>>(i: number, collection: C, map: CMap<Id, ISize>, typicalItemSize: number, size: number, isVertical: boolean, indexOffset?: number): {
+        num: number;
+        offset: number;
+    };
     /**
      * Calculates list metrics
      */
@@ -172,9 +181,8 @@ export declare class TrackBox extends CacheMap<Id, ISize & {
     setDisplayObjectIndexMapById(v: {
         [id: number]: number;
     }): void;
-    untrackComponentByIdProperty(component?: NgVirtualListItemComponent | undefined): void;
+    untrackComponentByIdProperty(component?: C | undefined): void;
     getItemBounds(id: Id): ISize | undefined;
     protected cacheElements(): void;
     dispose(): void;
 }
-export {};

package/lib/utils/tracker.d.ts

@@ -1,8 +1,11 @@
 import { ComponentRef } from "@angular/core";
-import { ScrollDirection } from "../models";
-interface IVirtualListItemComponent<I = any> {
+import { BaseVirtualListItemComponent, ScrollDirection } from "../models";
+import { Id, ISize } from "../types";
+export interface IVirtualListItemComponent<I = any> {
+    getBounds(): ISize;
+    itemId: Id;
     id: number;
-    item: I;
+    item: I | null;
     show: () => void;
     hide: () => void;
 }
@@ -12,7 +15,7 @@ interface IVirtualListItemComponent<I = any> {
  * @author Evgenii Grebennikov
  * @email djonnyx@gmail.com
  */
-export declare class Tracker<I = any, C extends IVirtualListItemComponent = any> {
+export declare class Tracker<C extends BaseVirtualListItemComponent = any> {
     /**
      * display objects dictionary of indexes by id
      */
@@ -41,4 +44,3 @@ export declare class Tracker<I = any, C extends IVirtualListItemComponent = any>
     untrackComponentByIdProperty(component?: C): void;
     dispose(): void;
 }
-export {};

package/package.json

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

package/public-api.d.ts

@@ -1,3 +1,4 @@
+export * from './lib/components/ng-virtual-list-item.component';
 export * from './lib/ng-virtual-list.module';
 export * from './lib/ng-virtual-list.component';
 export * from './lib/enums';