ng-virtual-list 19.11.4 → 19.12.0

package/lib/components/ng-scroller/ng-scroller.component.d.ts

@@ -1,9 +1,8 @@
-import { OnDestroy, Signal, TemplateRef } from '@angular/core';
+import { ElementRef, Signal, TemplateRef } from '@angular/core';
 import { Subject } from 'rxjs';
-import { Id } from '../../types';
+import { Id, TextDirection } from '../../types';
 import { NgScrollBarComponent } from "../ng-scroll-bar/ng-scroll-bar.component";
 import { GradientColorPositions } from '../../types/gradient-color-positions';
-import { TextDirection } from '../../enums';
 import { IScrollToParams, NgScrollView } from '../ng-scroll-view';
 import { IScrollBarDragEvent } from '../ng-scroll-bar/interfaces';
 import { ISize } from '../../interfaces';
@@ -17,12 +16,14 @@ export declare const SCROLL_EVENT: Event;
  * @author Evgenii Alexandrovich Grebennikov
  * @email djonnyx@gmail.com
  */
-export declare class NgScrollerComponent extends NgScrollView implements OnDestroy {
+export declare class NgScrollerComponent extends NgScrollView {
     readonly scrollBar: NgScrollBarComponent | undefined;
+    readonly filter: Signal<ElementRef<SVGFEGaussianBlurElement> | undefined>;
     readonly onScrollbarVisible: import("@angular/core").OutputEmitterRef<boolean>;
     readonly scrollbarEnabled: import("@angular/core").InputSignal<boolean>;
     readonly scrollbarInteractive: import("@angular/core").InputSignal<boolean>;
     readonly focusedElement: import("@angular/core").InputSignal<Id | null>;
+    readonly overlappingScrollbar: import("@angular/core").InputSignal<boolean>;
     readonly content: import("@angular/core").InputSignal<HTMLElement | undefined>;
     readonly loading: import("@angular/core").InputSignal<boolean>;
     readonly classes: import("@angular/core").InputSignal<{
@@ -34,6 +35,9 @@ export declare class NgScrollerComponent extends NgScrollView implements OnDestr
     readonly scrollbarThumbParams: import("@angular/core").InputSignal<{
         [propName: string]: any;
     } | null>;
+    readonly motionBlur: import("@angular/core").InputSignal<number | "disabled">;
+    readonly maxMotionBlur: import("@angular/core").InputSignal<number>;
+    readonly motionBlurEnabled: import("@angular/core").InputSignal<boolean>;
     readonly actualClasses: Signal<{
         [cName: string]: boolean;
     }>;
@@ -44,42 +48,33 @@ export declare class NgScrollerComponent extends NgScrollView implements OnDestr
     readonly thumbSize: import("@angular/core").WritableSignal<number>;
     readonly scrollbarShow: import("@angular/core").WritableSignal<boolean>;
     readonly preparedSignal: import("@angular/core").WritableSignal<boolean>;
-    private _service;
     readonly langTextDir: import("@angular/core").WritableSignal<TextDirection>;
+    readonly listStyles: import("@angular/core").WritableSignal<{
+        perspectiveOrigin: string;
+    }>;
     private _scrollBox;
     get host(): HTMLDivElement | undefined;
     private _$scrollbarScroll;
     readonly $scrollbarScroll: import("rxjs").Observable<boolean>;
     private _prepared;
     set prepared(v: boolean);
-    set x(v: number);
-    get x(): number;
-    set y(v: number);
-    get y(): number;
+    protected setX(x: number, snap?: boolean, normalize?: boolean): void;
+    protected setY(y: number, snap?: boolean, normalize?: boolean): void;
+    set startLayoutOffset(v: number);
+    get startLayoutOffset(): number;
     readonly viewInitialized: import("@angular/core").WritableSignal<boolean>;
     private _isScrollbarUserAction;
     get isScrollbarUserAction(): boolean;
-    private _measureVelocityTimestamp;
-    private _measureVelocityLastPosition;
-    private _measureVelocityAnimationFrameId;
-    private _measureVelocityAnimationTimer;
-    private _velocities;
-    protected _velocity: number;
-    get velocity(): number;
-    protected _averageVelocity: number;
-    get averageVelocity(): number;
-    private _measureVelocityHandler;
     protected _$resizeViewport: Subject<ISize>;
     readonly $resizeViewport: import("rxjs").Observable<ISize>;
     protected _$resizeContent: Subject<ISize>;
     readonly $resizeContent: import("rxjs").Observable<ISize>;
+    protected _filterId: string;
+    protected _filter: string;
     constructor();
+    private recalculatePerspective;
     protected onResizeViewport(): void;
-    protected onResizeContent(): void;
-    private measureVelocity;
-    private measureVelocityExecutor;
-    stopMeasureVelocity(): void;
-    private runMeasureVelocity;
+    protected onResizeContent(value?: number | null): void;
     private updateScrollBarHandler;
     ngAfterViewInit(): void;
     tick(): void;
@@ -88,13 +83,17 @@ export declare class NgScrollerComponent extends NgScrollView implements OnDestr
     protected onDragStart(): void;
     reset(): void;
     refresh(fireUpdate?: boolean, updateScrollbar?: boolean): void;
+    snapIfNeed(animated?: boolean): void;
+    startScrollTo(): void;
+    finishedScrollTo(): void;
     scrollTo(params: IScrollToParams): void;
     stopScrollbar(): void;
+    private dropVelocity;
+    protected stopMoving(): void;
     protected onAnimationComplete(position: number): void;
     onScrollBarDragHandler(event: IScrollBarDragEvent): void;
     onScrollBarDragEndHandler(event: IScrollBarDragEvent): void;
     private fireUpdateIfEdgesDetected;
-    ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgScrollerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NgScrollerComponent, "ng-scroller", never, { "scrollbarEnabled": { "alias": "scrollbarEnabled"; "required": false; "isSignal": true; }; "scrollbarInteractive": { "alias": "scrollbarInteractive"; "required": false; "isSignal": true; }; "focusedElement": { "alias": "focusedElement"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "classes": { "alias": "classes"; "required": false; "isSignal": true; }; "scrollbarMinSize": { "alias": "scrollbarMinSize"; "required": false; "isSignal": true; }; "scrollbarThickness": { "alias": "scrollbarThickness"; "required": false; "isSignal": true; }; "scrollbarThumbRenderer": { "alias": "scrollbarThumbRenderer"; "required": false; "isSignal": true; }; "scrollbarThumbParams": { "alias": "scrollbarThumbParams"; "required": false; "isSignal": true; }; }, { "onScrollbarVisible": "onScrollbarVisible"; }, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NgScrollerComponent, "ng-scroller", never, { "scrollbarEnabled": { "alias": "scrollbarEnabled"; "required": false; "isSignal": true; }; "scrollbarInteractive": { "alias": "scrollbarInteractive"; "required": false; "isSignal": true; }; "focusedElement": { "alias": "focusedElement"; "required": false; "isSignal": true; }; "overlappingScrollbar": { "alias": "overlappingScrollbar"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "classes": { "alias": "classes"; "required": false; "isSignal": true; }; "scrollbarMinSize": { "alias": "scrollbarMinSize"; "required": false; "isSignal": true; }; "scrollbarThickness": { "alias": "scrollbarThickness"; "required": false; "isSignal": true; }; "scrollbarThumbRenderer": { "alias": "scrollbarThumbRenderer"; "required": false; "isSignal": true; }; "scrollbarThumbParams": { "alias": "scrollbarThumbParams"; "required": false; "isSignal": true; }; "motionBlur": { "alias": "motionBlur"; "required": false; "isSignal": true; }; "maxMotionBlur": { "alias": "maxMotionBlur"; "required": false; "isSignal": true; }; "motionBlurEnabled": { "alias": "motionBlurEnabled"; "required": false; "isSignal": true; }; }, { "onScrollbarVisible": "onScrollbarVisible"; }, never, ["*"], false, never>;
 }

package/lib/const/index.d.ts

@@ -1,8 +1,16 @@
-import { CollectionModes, MethodsForSelecting, SnappingMethods, TextDirections } from "../enums";
+import { CollapsingModes, CollectionModes, SelectingModes, SnappingMethods, TextDirections } from "../enums";
 import { Directions } from "../enums/directions";
 import { IAnimationParams, IScrollingSettings } from '../interfaces';
+import { SpreadingMode } from "../types";
+import { Alignment, SnappingDistance, SnapToItemAlign } from "../types";
+export declare const SERVICE_PROP_DUMMY_ID = "__service-dummy-id__";
+export declare const SERVICE_PROP_DUMMY = "__service-dummy__";
+export declare const SERVICE_TYPE_DUMMY = "__service-type-dummy__";
+export declare const SERVICE_PROP_DUMMY_ENABLED: unique symbol;
 export declare const MAX_REGULAR_SNAPED_COMPONENTS = 2;
 export declare const DEFAULT_ITEM_SIZE = 24;
+export declare const DEFAULT_MIN_ITEM_SIZE = 1;
+export declare const DEFAULT_MAX_ITEM_SIZE: number;
 export declare const DEFAULT_BUFFER_SIZE = 2;
 export declare const DEFAULT_MAX_BUFFER_SIZE = 10;
 export declare const DEFAULT_LIST_SIZE = 400;
@@ -10,13 +18,25 @@ export declare const DEFAULT_CLICK_DISTANCE = 40;
 export declare const DEFAULT_WAIT_FOR_PREPARATION = true;
 export declare const DEFAULT_SCROLLBAR_ENABLED = true;
 export declare const DEFAULT_SCROLLBAR_INTERACTIVE = true;
+export declare const DEFAULT_OVERLAPPING_SCROLLBAR = false;
 export declare const DEFAULT_SCROLL_BEHAVIOR: ScrollBehavior;
 export declare const NAVIGATION_BY_KEYBOARD_TIMER = 50;
+export declare const DEFAULT_SNAP_TO_ITEM = false;
+export declare const DEFAULT_SNAP_TO_ITEM_ALIGN: SnapToItemAlign;
+export declare const DEFAULT_SNAPPING_DISTANCE: SnappingDistance;
+export declare const DEFAULT_SCROLLING_ONE_BY_ONE = false;
+export declare const DEFAULT_ALIGNMENT: Alignment;
+export declare const DEFAULT_SPREADING_MODE: SpreadingMode;
+export declare const DEFAULT_DIVIDES = 1;
+export declare const DEFAULT_MOTION_BLUR = 0.15;
+export declare const DEFAULT_MOTION_BLUR_ENABLED = false;
+export declare const DEFAULT_MAX_MOTION_BLUR = 0.5;
 export declare const DEFAULT_ANIMATION_PARAMS: IAnimationParams;
 export declare const DEFAULT_SCROLLING_SETTINGS: IScrollingSettings;
 export declare const DEFAULT_OVERSCROLL_ENABLED = true;
-export declare const DEFAULT_SNAP = false;
+export declare const DEFAULT_STICKY_ENABLED = false;
 export declare const DEFAULT_SELECT_BY_CLICK = true;
+export declare const DEFAULT_ZINDEX_WHEN_SELECTING: null;
 export declare const DEFAULT_COLLAPSE_BY_CLICK = true;
 export declare const DEFAULT_ENABLED_BUFFER_OPTIMIZATION = false;
 export declare const DEFAULT_DYNAMIC_SIZE = true;
@@ -29,7 +49,8 @@ export declare const DEFAULT_COLLECTION_MODE = CollectionModes.NORMAL;
 export declare const DISPLAY_OBJECTS_LENGTH_MESUREMENT_ERROR = 1;
 export declare const MAX_SCROLL_TO_ITERATIONS = 5;
 export declare const DEFAULT_SNAPPING_METHOD = SnappingMethods.STANDART;
-export declare const DEFAULT_SELECT_METHOD = MethodsForSelecting.NONE;
+export declare const DEFAULT_COLLAPSING_MODES = CollapsingModes.MULTI_COLLAPSE;
+export declare const DEFAULT_SELECTING_MODES = SelectingModes.NONE;
 export declare const DEFAULT_SCREEN_READER_MESSAGE = "Showing items $1 to $2";
 export declare const DEFAULT_LANG_TEXT_DIR = TextDirections.LTR;
 export declare const DEFAULT_SCROLLBAR_THICKNESS: number;
@@ -37,6 +58,8 @@ export declare const DEFAULT_SCROLLBAR_MIN_SIZE: number;
 export declare const BEHAVIOR_AUTO: ScrollBehavior;
 export declare const BEHAVIOR_INSTANT: ScrollBehavior;
 export declare const BEHAVIOR_SMOOTH: ScrollBehavior;
+export declare const DISABLED = "disabled";
+export declare const VIEWPORT = "viewport";
 export declare const DISPLAY_BLOCK = "block";
 export declare const DISPLAY_NONE = "none";
 export declare const OPACITY_0 = "0";
@@ -45,6 +68,11 @@ export declare const VISIBILITY_VISIBLE = "visible";
 export declare const VISIBILITY_HIDDEN = "hidden";
 export declare const SIZE_100_PERSENT = "100%";
 export declare const SIZE_AUTO = "auto";
+export declare const UNSET = "unset";
+export declare const LEFT = "left";
+export declare const RIGHT = "right";
+export declare const POSITION = "position";
+export declare const POSITION_RELATIVE = "relative";
 export declare const POSITION_ABSOLUTE = "absolute";
 export declare const TRANSLATE_3D = "translate3d";
 export declare const ZEROS_TRANSLATE_3D = "translate3d(0,0,0)";
@@ -90,13 +118,24 @@ export declare const PART_DEFAULT_ITEM = "item";
 export declare const PART_ITEM_NEW = " item-new";
 export declare const PART_ITEM_ODD = " item-odd";
 export declare const PART_ITEM_EVEN = " item-even";
+export declare const PART_ITEM_ROW_ODD = " item-row-odd";
+export declare const PART_ITEM_ROW_EVEN = " item-row-even";
 export declare const PART_ITEM_SNAPPED = " item-snapped";
 export declare const PART_ITEM_SELECTED = " item-selected";
 export declare const PART_ITEM_COLLAPSED = " item-collapsed";
 export declare const PART_ITEM_FOCUSED = " item-focused";
+export declare const PART_DEFAULT_ITEM_FX = "item-fx";
+export declare const PART_ITEM_FX_NEW = " item-fx-new";
+export declare const PART_ITEM_FX_ODD = " item-fx-odd";
+export declare const PART_ITEM_FX_EVEN = " item-fx-even";
+export declare const PART_ITEM_ROW_FX_ODD = " item-row-fx-odd";
+export declare const PART_ITEM_ROW_FX_EVEN = " item-row-fx-even";
+export declare const PART_ITEM_FX_SNAPPED = " item-fx-snapped";
+export declare const PART_ITEM_FX_SELECTED = " item-fx-selected";
+export declare const PART_ITEM_FX_COLLAPSED = " item-fx-collapsed";
+export declare const PART_ITEM_FX_FOCUSED = " item-fx-focused";
 export declare const MIN_PIXELS_FOR_PREVENT_SNAPPING = 10;
 export declare const MAX_VELOCITY_FOR_SCROLL_QUALITY_OPTIMIZATION_LVL1 = 74;
-export declare const MAX_VELOCITY_FOR_SCROLL_QUALITY_OPTIMIZATION_LVL2 = 500;
 export declare const MAX_NUMBERS_OF_SKIPS_FOR_QUALITY_OPTIMIZATION_LVL1 = 4;
 export declare const RANGE_DISPLAY_ITEMS_END_OFFSET = 20;
 export declare const PREPARE_ITERATIONS = 1;
@@ -109,4 +148,6 @@ export declare const EMPTY_SCROLL_STATE_VERSION = "-1";
 export declare const ROLE_LIST = "list";
 export declare const ROLE_LIST_BOX = "listbox";
 export declare const ITEM_ID = "item-id";
-export declare const ITEM_CONTAINER = "ngvl-item__container";
+export declare const ITEM_CONTAINER = "ngvl-item";
+export declare const PERCENTAGE_VALUE_PATTERN: RegExp;
+export declare const Z_INDEX_NONE = "-1", Z_INDEX_0 = "0", Z_INDEX_1 = "1", Z_INDEX_2 = "2", Z_INDEX_3 = "3";

package/lib/core/cache-map.d.ts

@@ -1,4 +1,3 @@
-import { ScrollDirection } from "../types";
 import { EventEmitter } from "../utils/event-emitter";
 import { CMap } from "../utils/cmap";
 export interface ICacheMap<I = any, B = any> {
@@ -27,22 +26,13 @@ export declare class CacheMap<I = string | number, B = any, E = CacheMapEvents,
     protected _lifeCircleId: any;
     protected _delta: number;
     get delta(): number;
-    protected _deltaDirection: ScrollDirection;
-    set deltaDirection(v: ScrollDirection);
-    get deltaDirection(): ScrollDirection;
-    private _scrollDirectionCache;
-    private _scrollDirection;
-    get scrollDirection(): ScrollDirection;
     get version(): number;
-    private _clearScrollDirectionDebounce;
     constructor();
     protected changesDetected(): boolean;
     protected stopLifeCircle(): void;
     protected nextTick(cb: () => void): any;
     protected lifeCircle(): void;
     protected lifeCircleDo(): void;
-    clearScrollDirectionCache(async?: boolean): void;
-    private calcScrollDirection;
     protected bumpVersion(): void;
     protected fireChangeIfNeed(): void;
     set(id: I, bounds: B): CMap<I, B>;

package/lib/core/const/index.d.ts

@@ -0,0 +1 @@
+export declare const START_COLLECTION_PREFIX_ID = "n", END_COLLECTION_PREFIX_ID = "p", DEFAULT_BUFFER_EXTREMUM_THRESHOLD = 15, DEFAULT_MAX_BUFFER_SEQUENCE_LENGTH = 30, DEFAULT_RESET_BUFFER_SIZE_TIMEOUT = 10000, IS_NEW = "n";

package/lib/core/enums/index.d.ts

@@ -0,0 +1,2 @@
+import { ItemDisplayMethods } from './item-display-methods';
+export { ItemDisplayMethods, };

package/lib/core/enums/item-display-methods.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ItemDisplayMethods
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/enums/item-display-methods.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export declare enum ItemDisplayMethods {
+    CREATE = 0,
+    UPDATE = 1,
+    DELETE = 2,
+    NOT_CHANGED = 3
+}

package/lib/core/events/index.d.ts

@@ -0,0 +1,2 @@
+import { TrackBoxEvents } from './track-box-events';
+export { TrackBoxEvents, };

package/lib/core/events/track-box-events.d.ts

@@ -0,0 +1,10 @@
+/**
+ * TrackBoxEvents
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/events/track-box-events.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export declare enum TrackBoxEvents {
+    CHANGE = "change",
+    TICK = "tick"
+}

package/lib/core/interfaces/get-item-position-options.d.ts

@@ -0,0 +1,10 @@
+import { IItem } from "./item";
+import { IRecalculateMetricsOptions } from "./recalculate-metrics-options";
+/**
+ * IGetItemPositionOptions
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/interfaces/get-item-position-options.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export interface IGetItemPositionOptions<I extends IItem, C extends Array<I>> extends Omit<IRecalculateMetricsOptions<I, C>, 'previousTotalSize' | 'crudDetected' | 'deletedItemsMap'> {
+}

package/lib/core/interfaces/get-metrics-returns.d.ts

@@ -0,0 +1,11 @@
+/**
+ * IGetMetricsReturns
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/interfaces/get-metrics-returns.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export interface IGetMetricsReturns {
+    totalSize: number;
+    delta: number;
+    crudDetected: boolean;
+}

package/lib/core/interfaces/index.d.ts

@@ -0,0 +1,8 @@
+import { IMetrics } from "./metrics";
+import { IItem } from './item';
+import { IGetItemPositionOptions } from './get-item-position-options';
+import { IRecalculateMetricsOptions } from './recalculate-metrics-options';
+import { IUpdateCollectionOptions } from './update-collection-options';
+import { IGetMetricsReturns } from './get-metrics-returns';
+import { IUpdateCollectionReturns } from "./update-collection-returns";
+export type { IMetrics, IItem, IGetItemPositionOptions, IGetMetricsReturns, IRecalculateMetricsOptions, IUpdateCollectionOptions, IUpdateCollectionReturns, };

package/lib/core/interfaces/item.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IItem
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/interfaces/item.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export interface IItem<I = any> {
+    [prop: string]: I;
+}

package/lib/core/interfaces/metrics.d.ts

@@ -0,0 +1,51 @@
+import { HEIGHT_PROP_NAME, WIDTH_PROP_NAME } from "../../const";
+import { ItemTransform, SnapToItemAlign } from "../../types";
+import { IItem } from "./item";
+/**
+ * IMetrics
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/interfaces/metrics.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export interface IMetrics<I extends IItem> {
+    delta: number;
+    normalizedItemWidth: number;
+    normalizedItemHeight: number;
+    width: number;
+    height: number;
+    dynamicSize: boolean;
+    divides: number;
+    itemSize: number;
+    minItemSize: number;
+    maxItemSize: number;
+    items: Array<I>;
+    itemsFromStartToScrollEnd: number;
+    itemsFromStartToDisplayEnd: number;
+    itemsOnDisplayWeight: number;
+    itemsOnDisplayLength: number;
+    isVertical: boolean;
+    leftHiddenItemsWeight: number;
+    leftItemLength: number;
+    leftItemsWeight: number;
+    leftLayoutOffset: number;
+    leftLayoutIndexOffset: number;
+    renderItems: number;
+    rightItemLength: number;
+    rightItemsWeight: number;
+    scrollSize: number;
+    leftSizeOfAddedItems: number;
+    sizeProperty: typeof HEIGHT_PROP_NAME | typeof WIDTH_PROP_NAME;
+    stickyEnabled: boolean;
+    stickyPos: number;
+    startIndex: number;
+    startPosition: number;
+    totalItemsToDisplayEndWeight: number;
+    totalLength: number;
+    totalSize: number;
+    typicalItemSize: number;
+    isFromItemIdFound: boolean;
+    isUpdating: boolean;
+    snapToItem: boolean;
+    snapToItemAlign: SnapToItemAlign;
+    itemTransform: ItemTransform | null;
+}

package/lib/core/interfaces/recalculate-metrics-options.d.ts

@@ -0,0 +1,32 @@
+import { ISize } from "../../interfaces";
+import { Id, ItemTransform, SnapToItemAlign } from "../../types";
+import { IItem } from "./item";
+/**
+ * IRecalculateMetricsOptions
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/interfaces/recalculate-metrics-options.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export interface IRecalculateMetricsOptions<I extends IItem, C extends Array<I>> {
+    bounds: ISize;
+    collection: C;
+    isVertical: boolean;
+    itemSize: number;
+    minItemSize: number;
+    maxItemSize: number;
+    bufferSize: number;
+    maxBufferSize: number;
+    dynamicSize: boolean;
+    scrollSize: number;
+    stickyEnabled: boolean;
+    enabledBufferOptimization: boolean;
+    fromItemId?: Id;
+    previousTotalSize: number;
+    crudDetected: boolean;
+    deletedItemsMap: {
+        [index: number]: ISize;
+    };
+    snapToItem: boolean;
+    snapToItemAlign: SnapToItemAlign;
+    itemTransform: ItemTransform | null;
+}

package/lib/core/interfaces/update-collection-options.d.ts

@@ -0,0 +1,10 @@
+import { IItem } from "./item";
+import { IRecalculateMetricsOptions } from "./recalculate-metrics-options";
+/**
+ * IUpdateCollectionOptions
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/interfaces/update-collection-options.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export interface IUpdateCollectionOptions<I extends IItem, C extends Array<I>> extends Omit<IRecalculateMetricsOptions<I, C>, 'collection' | 'previousTotalSize' | 'crudDetected' | 'deletedItemsMap'> {
+}

package/lib/core/interfaces/update-collection-returns.d.ts

@@ -0,0 +1,14 @@
+import { IRenderVirtualListCollection } from "../../models/render-collection.model";
+/**
+ * IUpdateCollectionReturns
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/interfaces/update-collection-returns.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export interface IUpdateCollectionReturns {
+    displayItems: IRenderVirtualListCollection;
+    totalSize: number;
+    leftLayoutOffset: number;
+    delta: number;
+    crudDetected: boolean;
+}

package/lib/core/track-box.d.ts

@@ -3,98 +3,14 @@ import { IRenderVirtualListCollection } from "../models/render-collection.model"
 import { Id } from "../types/id";
 import { CacheMap } from "./cache-map";
 import { Tracker } from "./tracker";
-import { ISize } from "../interfaces";
-import { HEIGHT_PROP_NAME, WIDTH_PROP_NAME } from "../const";
+import { IRect, ISize } from "../interfaces";
 import { IVirtualListItemConfigMap } from "../models";
 import { CMap } from '../utils/cmap';
 import { BaseVirtualListItemComponent } from "../components/ng-list-item/base";
 import { PrerenderCache } from "../components/ng-prerender-container/types/cache";
-export declare enum TrackBoxEvents {
-    CHANGE = "change",
-    TICK = "tick"
-}
-export interface IMetrics {
-    delta: number;
-    normalizedItemWidth: number;
-    normalizedItemHeight: number;
-    width: number;
-    height: number;
-    dynamicSize: boolean;
-    itemSize: number;
-    itemsFromStartToScrollEnd: number;
-    itemsFromStartToDisplayEnd: number;
-    itemsOnDisplayWeight: number;
-    itemsOnDisplayLength: number;
-    isVertical: boolean;
-    leftHiddenItemsWeight: number;
-    leftItemLength: number;
-    leftItemsWeight: number;
-    renderItems: number;
-    rightItemLength: number;
-    rightItemsWeight: number;
-    scrollSize: number;
-    leftSizeOfAddedItems: number;
-    sizeProperty: typeof HEIGHT_PROP_NAME | typeof WIDTH_PROP_NAME;
-    snap: boolean;
-    snipedPos: number;
-    startIndex: number;
-    startPosition: number;
-    totalItemsToDisplayEndWeight: number;
-    totalLength: number;
-    totalSize: number;
-    typicalItemSize: number;
-    isFromItemIdFound: boolean;
-    isUpdating: boolean;
-}
-export interface IRecalculateMetricsOptions<I extends IItem, C extends Array<I>> {
-    bounds: ISize;
-    collection: C;
-    isVertical: boolean;
-    itemSize: number;
-    bufferSize: number;
-    maxBufferSize: number;
-    dynamicSize: boolean;
-    scrollSize: number;
-    snap: boolean;
-    enabledBufferOptimization: boolean;
-    fromItemId?: Id;
-    previousTotalSize: number;
-    crudDetected: boolean;
-    deletedItemsMap: {
-        [index: number]: ISize;
-    };
-}
-export interface IGetItemPositionOptions<I extends IItem, C extends Array<I>> extends Omit<IRecalculateMetricsOptions<I, C>, 'previousTotalSize' | 'crudDetected' | 'deletedItemsMap'> {
-}
-export interface IUpdateCollectionOptions<I extends IItem, C extends Array<I>> extends Omit<IRecalculateMetricsOptions<I, C>, 'collection' | 'previousTotalSize' | 'crudDetected' | 'deletedItemsMap'> {
-}
-export type CacheMapEvents = TrackBoxEvents;
-export type OnChangeEventListener = (version: number) => void;
-export type OnTickEventListener = () => void;
-export type CacheMapListeners = OnChangeEventListener | OnTickEventListener;
-export declare enum ItemDisplayMethods {
-    CREATE = 0,
-    UPDATE = 1,
-    DELETE = 2,
-    NOT_CHANGED = 3
-}
-export interface IUpdateCollectionReturns {
-    displayItems: IRenderVirtualListCollection;
-    totalSize: number;
-    delta: number;
-    crudDetected: boolean;
-}
-export interface IGetMetricsReturns {
-    totalSize: number;
-    delta: number;
-    crudDetected: boolean;
-}
-interface IItem<I = any> {
-    [prop: string]: I;
-}
-type Cache = ISize & {
-    method?: ItemDisplayMethods;
-} & IItem;
+import { ScrollDirection } from "../types";
+import { IGetItemPositionOptions, IGetMetricsReturns, IItem, IMetrics, IRecalculateMetricsOptions, IUpdateCollectionOptions, IUpdateCollectionReturns } from "./interfaces";
+import { Cache, CacheMapEvents, CacheMapListeners } from "./types";
 /**
  * An object that performs tracking, calculations and caching.
  * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/track-box.ts
@@ -109,6 +25,16 @@ export declare class TrackBox<C extends BaseVirtualListItemComponent = any> exte
     set displayComponents(v: Array<ComponentRef<C>> | null | undefined);
     protected _snappedDisplayComponents: Array<ComponentRef<C>> | null | undefined;
     set snappedDisplayComponents(v: Array<ComponentRef<C>> | null | undefined);
+    protected _scrollDirection: ScrollDirection;
+    set scrollDirection(v: ScrollDirection);
+    get scrollDirection(): ScrollDirection;
+    protected _trackBy: string;
+    set trackBy(v: string);
+    get trackBy(): string;
+    protected _divides: number;
+    set divides(v: number);
+    protected _isInfinity: boolean;
+    set isInfinity(v: boolean);
     protected _isSnappingMethodAdvanced: boolean;
     set isSnappingMethodAdvanced(v: boolean);
     protected _isLazy: boolean;
@@ -118,10 +44,10 @@ export declare class TrackBox<C extends BaseVirtualListItemComponent = any> exte
      */
     set trackingPropertyName(v: string);
     protected _trackingPropertyName: string;
-    set isScrollStart(v: boolean);
     protected _isScrollStart: boolean;
-    set isScrollEnd(v: boolean);
+    set isScrollStart(v: boolean);
     protected _isScrollEnd: boolean;
+    set isScrollEnd(v: boolean);
     protected _isScrollSnapToStart: boolean;
     get isSnappedToStart(): boolean;
     protected _isScrollSnapToEnd: boolean;
@@ -182,7 +108,7 @@ export declare class TrackBox<C extends BaseVirtualListItemComponent = any> exte
      */
     updateCollection<I extends IItem, C extends Array<I>>(items: C, itemConfigMap: IVirtualListItemConfigMap, options: IUpdateCollectionOptions<I, C>): IUpdateCollectionReturns;
     protected _previousScrollSize: number;
-    protected updateAdaptiveBufferParams(metrics: IMetrics, totalItemsLength: number): void;
+    protected updateAdaptiveBufferParams<I extends IItem>(metrics: IMetrics<I>, totalItemsLength: number): void;
     protected startResetBufferSizeTimer(): void;
     protected disposeClearBufferSizeTimer(): void;
     /**
@@ -195,15 +121,15 @@ export declare class TrackBox<C extends BaseVirtualListItemComponent = any> exte
     /**
      * Calculates list metrics
      */
-    protected recalculateMetrics<I extends IItem, C extends Array<I>>(options: IRecalculateMetricsOptions<I, C>): IMetrics;
+    protected recalculateMetrics<I extends IItem, C extends Array<I>>(options: IRecalculateMetricsOptions<I, C>): IMetrics<I>;
     refreshCache(cache: PrerenderCache): void;
-    clearDelta(clearDirectionDetector?: boolean): void;
+    clearDelta(): void;
     changes(immediately?: boolean, force?: boolean): void;
     /**
      * Returns true if the bounds of at least one screen object have changed.
      */
     checkBoundsOfElements(): boolean;
-    protected generateDisplayCollection<I extends IItem, C extends Array<I>>(items: C, itemConfigMap: IVirtualListItemConfigMap, metrics: IMetrics): IRenderVirtualListCollection;
+    protected generateDisplayCollection<I extends IItem, C extends Array<I>>(items: C, actualItems: C, itemConfigMap: IVirtualListItemConfigMap, metrics: IMetrics<I>): IRenderVirtualListCollection;
     resetPositions(): void;
     /**
      * tracking by propName
@@ -214,10 +140,14 @@ export declare class TrackBox<C extends BaseVirtualListItemComponent = any> exte
     }): void;
     untrackComponentByIdProperty(component?: C | undefined): void;
     getItemBounds(id: Id): ISize | null;
+    getComponentBoundsByIntersectionPosition(position: number, maxPosition?: number | null): (IRect & {
+        id: Id | null;
+        isFirst: boolean;
+        isLast: boolean;
+    }) | null;
     private _debouncedIsScrollStartOff;
     protected cacheElements(isVertical: boolean, itemSize: number): void;
     resetCacheChunkInfo(): void;
     cacheClean(): void;
     dispose(): void;
 }
-export {};

package/lib/core/tracker.d.ts

@@ -47,7 +47,7 @@ export declare class Tracker<C extends BaseVirtualListItemComponent = any> {
     /**
      * tracking by propName
      */
-    track(items: IRenderVirtualListCollection, components: Array<ComponentRef<C>>, snappedComponents: Array<ComponentRef<C>> | null | undefined, direction: ScrollDirection): void;
+    track(items: IRenderVirtualListCollection, components: Array<ComponentRef<C>>, snappedComponents: Array<ComponentRef<C>> | null | undefined, direction: ScrollDirection, trackBy: string): void;
     untrackComponentByIdProperty(component?: C): void;
     clearTrackMap(): void;
     dispose(): void;

package/lib/core/types/cache-map-events.d.ts

@@ -0,0 +1,8 @@
+import { TrackBoxEvents } from "../events";
+/**
+ * CacheMapEvents
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/types/cache-map-events.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export type CacheMapEvents = TrackBoxEvents;

package/lib/core/types/cache-map-listeners.d.ts

@@ -0,0 +1,9 @@
+import { OnChangeEventListener } from "./on-change-event-listener";
+import { OnTickEventListener } from "./on-tick-event-listener";
+/**
+ * CacheMapListeners
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/core/types/cache-map-listeners.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export type CacheMapListeners = OnChangeEventListener | OnTickEventListener;