ng-virtual-list 16.7.11 → 16.7.13

package/fesm2022/ng-virtual-list.mjs

@@ -1,12 +1,30 @@
 import * as i0 from '@angular/core';
 import { Injectable, Component, ChangeDetectionStrategy, EventEmitter as EventEmitter$1, ViewContainerRef, ElementRef, ViewEncapsulation, ViewChild, Output, Input, NgModule, NO_ERRORS_SCHEMA } from '@angular/core';
-import { takeUntil, tap as tap$1, map } from 'rxjs/operators';
-import { Subject, tap, BehaviorSubject as BehaviorSubject$1, fromEvent, combineLatest, filter, distinctUntilChanged, skip, map as map$1, debounceTime, switchMap, of } from 'rxjs';
-import { BehaviorSubject } from 'rxjs/internal/BehaviorSubject';
+import { tap as tap$1, map } from 'rxjs/operators';
+import { Subject, tap, BehaviorSubject as BehaviorSubject$1, fromEvent, combineLatest, filter, distinctUntilChanged, map as map$1, debounceTime, switchMap, of } from 'rxjs';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+import { BehaviorSubject } from 'rxjs/internal/BehaviorSubject';
 import * as i2 from '@angular/common';
 import { CommonModule } from '@angular/common';
 
+/**
+ * Action modes for collection elements.
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/16.x/projects/ng-virtual-list/src/lib/enums/collection-modes.ts
+ * @author Evgenii Grebennikov
+ * @email djonnyx@gmail.com
+ */
+var CollectionModes;
+(function (CollectionModes) {
+    /**
+     * When adding elements to the beginning of the collection, the scroll remains at the current position.
+     */
+    CollectionModes["NORMAL"] = "normal";
+    /**
+     * When adding elements to the beginning of the collection, the scroll is shifted by the sum of the sizes of the new elements.
+     */
+    CollectionModes["LAZY"] = "lazy";
+})(CollectionModes || (CollectionModes = {}));
+
 /**
  * Axis of the arrangement of virtual list elements.
  * @link https://github.com/DjonnyX/ng-virtual-list/blob/16.x/projects/ng-virtual-list/src/lib/enums/directions.ts
@@ -65,6 +83,20 @@ var SnappingMethods;
     SnappingMethods["ADVANCED"] = "advanced";
 })(SnappingMethods || (SnappingMethods = {}));
 
+/**
+ * Focus Alignments.
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/16.x/projects/ng-virtual-list/src/lib/enums/focus-alignments.ts
+ * @author Evgenii Grebennikov
+ * @email djonnyx@gmail.com
+ */
+var FocusAlignments;
+(function (FocusAlignments) {
+    FocusAlignments["NONE"] = "none";
+    FocusAlignments["START"] = "start";
+    FocusAlignments["CENTER"] = "center";
+    FocusAlignments["END"] = "end";
+})(FocusAlignments || (FocusAlignments = {}));
+
 const DEFAULT_ITEM_SIZE = 24;
 const DEFAULT_BUFFER_SIZE = 2;
 const DEFAULT_MAX_BUFFER_SIZE = 10;
@@ -76,6 +108,7 @@ const DEFAULT_ENABLED_BUFFER_OPTIMIZATION = false;
 const DEFAULT_DYNAMIC_SIZE = false;
 const TRACK_BY_PROPERTY_NAME = 'id';
 const DEFAULT_DIRECTION = Directions.VERTICAL;
+const DEFAULT_COLLECTION_MODE = CollectionModes.NORMAL;
 const DISPLAY_OBJECTS_LENGTH_MESUREMENT_ERROR = 1;
 const MAX_SCROLL_TO_ITERATIONS = 5;
 const DEFAULT_SNAPPING_METHOD = SnappingMethods.NORMAL;
@@ -368,11 +401,11 @@ class NgVirtualListService {
         this._trackBox = trackBox;
     }
     itemToFocus;
-    focus(element) {
+    focus(element, align = FocusAlignments.CENTER) {
         element.focus({ preventScroll: true });
         if (element.parentElement) {
             const pos = parseFloat(element.parentElement?.getAttribute('position') ?? '0');
-            this.itemToFocus?.(element, pos);
+            this.itemToFocus?.(element, pos, align);
         }
     }
     areaFocus(id) {
@@ -392,7 +425,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
                 }]
         }], ctorParameters: function () { return []; } });
 
-const ATTR_AREA_SELECTED = 'area-selected', TABINDEX = 'ng-vl-index', KEY_SPACE = " ", KEY_ARR_LEFT = "ArrowLeft", KEY_ARR_UP = "ArrowUp", KEY_ARR_RIGHT = "ArrowRight", KEY_ARR_DOWN = "ArrowDown", EVENT_FOCUS_IN = 'focusin', EVENT_FOCUS_OUT = 'focusout', EVENT_KEY_DOWN = 'keydown';
+const ATTR_AREA_SELECTED = 'area-selected', TABINDEX = 'ng-vl-index', POSITION = 'position', POSITION_ZERO = '0', ID = 'item-id', KEY_SPACE = " ", KEY_ARR_LEFT = "ArrowLeft", KEY_ARR_UP = "ArrowUp", KEY_ARR_RIGHT = "ArrowRight", KEY_ARR_DOWN = "ArrowDown", EVENT_FOCUS_IN = 'focusin', EVENT_FOCUS_OUT = 'focusout', EVENT_KEY_DOWN = 'keydown';
 const getElementByIndex = (index) => {
     return `[${TABINDEX}="${index}"]`;
 };
@@ -406,7 +439,6 @@ class NgVirtualListItemComponent extends BaseVirtualListItemComponent {
     _cdr;
     _elementRef;
     _service;
-    _$unsubscribe = new Subject();
     _id;
     get id() {
         return this._id;
@@ -418,12 +450,12 @@ class NgVirtualListItemComponent extends BaseVirtualListItemComponent {
     _$config = new BehaviorSubject$1({});
     $config = this._$config.asObservable();
     measures = new BehaviorSubject$1(undefined);
-    _$focus = new BehaviorSubject$1(false);
-    $focus = this._$focus.asObservable();
+    _$focused = new BehaviorSubject$1(false);
+    $focused = this._$focused.asObservable();
     _$part = new BehaviorSubject$1(PART_DEFAULT_ITEM);
     $part = this._$part.asObservable();
     regular = false;
-    data = undefined;
+    data;
     _$data = new BehaviorSubject$1(this.data);
     $data = this._$data.asObservable();
     set item(v) {
@@ -490,28 +522,35 @@ class NgVirtualListItemComponent extends BaseVirtualListItemComponent {
         }
         this._service.collapse(data, collapsed);
     };
+    _focusHandler = () => 
+    /**
+    * Focus a list item
+    */
+    (align = FocusAlignments.CENTER) => {
+        this.focus(align);
+    };
     constructor(_cdr, _elementRef, _service) {
         super();
         this._cdr = _cdr;
         this._elementRef = _elementRef;
         this._service = _service;
         this._id = this._service.generateComponentId();
-        const $data = this.$data, $focus = this.$focus;
+        const $data = this.$data, $focus = this.$focused;
         this._elementRef.nativeElement.setAttribute('id', String(this._id));
-        $focus.pipe(takeUntil(this._$unsubscribe), tap$1(v => {
+        $focus.pipe(takeUntilDestroyed(), tap$1(v => {
             this._service.areaFocus(v ? this._id : this._service.focusedId === this._id ? null : this._service.focusedId);
         })).subscribe();
-        fromEvent(this.element, EVENT_FOCUS_IN).pipe(takeUntil(this._$unsubscribe), tap$1(e => {
-            this._$focus.next(true);
+        fromEvent(this.element, EVENT_FOCUS_IN).pipe(takeUntilDestroyed(), tap$1(e => {
+            this._$focused.next(true);
             this.updateConfig(this.data);
             this.updatePartStr(this.data, this._isSelected, this._isCollapsed);
         })).subscribe(),
-            fromEvent(this.element, EVENT_FOCUS_OUT).pipe(takeUntil(this._$unsubscribe), tap$1(e => {
-                this._$focus.next(false);
+            fromEvent(this.element, EVENT_FOCUS_OUT).pipe(takeUntilDestroyed(), tap$1(e => {
+                this._$focused.next(false);
                 this.updateConfig(this.data);
                 this.updatePartStr(this.data, this._isSelected, this._isCollapsed);
             })).subscribe(),
-            fromEvent(this.element, EVENT_KEY_DOWN).pipe(takeUntil(this._$unsubscribe), tap$1(e => {
+            fromEvent(this.element, EVENT_KEY_DOWN).pipe(takeUntilDestroyed(), tap$1(e => {
                 switch (e.key) {
                     case KEY_SPACE: {
                         e.stopImmediatePropagation();
@@ -554,7 +593,7 @@ class NgVirtualListItemComponent extends BaseVirtualListItemComponent {
                         break;
                 }
             })).subscribe();
-        combineLatest([$data, this._service.$methodOfSelecting, this._service.$selectedIds, this._service.$collapsedIds]).pipe(takeUntil(this._$unsubscribe), map(([, m, selectedIds, collapsedIds]) => ({ method: m, selectedIds, collapsedIds })), tap$1(({ method, selectedIds, collapsedIds }) => {
+        combineLatest([$data, this._service.$methodOfSelecting, this._service.$selectedIds, this._service.$collapsedIds]).pipe(takeUntilDestroyed(), map(([, m, selectedIds, collapsedIds]) => ({ method: m, selectedIds, collapsedIds })), tap$1(({ method, selectedIds, collapsedIds }) => {
             switch (method) {
                 case MethodsForSelectingTypes.SELECT: {
                     const id = selectedIds, isSelected = id === this.itemId;
@@ -610,18 +649,29 @@ class NgVirtualListItemComponent extends BaseVirtualListItemComponent {
             }
         }
     }
+    focus(align = FocusAlignments.CENTER) {
+        if (this._service.listElement) {
+            const tabIndex = this.data?.config?.tabIndex ?? 0;
+            let index = tabIndex;
+            const el = this._service.listElement.querySelector(getElementByIndex(index));
+            if (el) {
+                this._service.focus(el, align);
+            }
+        }
+    }
     updateMeasures(v) {
         this.measures.next(v?.measures ? { ...v.measures } : undefined);
     }
     updateConfig(v) {
         this._$config.next({
-            ...v?.config || {}, selected: this._isSelected, collapsed: this._isCollapsed, focus: this._$focus.getValue(),
-            collapse: this._collapseHandler(v), select: this._selectHandler(v)
+            ...v?.config || {}, selected: this._isSelected, collapsed: this._isCollapsed, focused: this._$focused.getValue(),
+            collapse: this._collapseHandler(v), select: this._selectHandler(v), focus: this._focusHandler(),
         });
     }
     update() {
         const data = this.data, regular = this.regular, length = this._regularLength;
         if (data) {
+            this._elementRef.nativeElement.setAttribute(ID, `${data.id}`);
             const styles = this._elementRef.nativeElement.style;
             styles.zIndex = data.config.zIndex;
             if (data.config.snapped) {
@@ -645,6 +695,9 @@ class NgVirtualListItemComponent extends BaseVirtualListItemComponent {
             styles.height = data.config.isVertical ? data.config.dynamic ? SIZE_AUTO : `${data.measures.height}${PX}` : regular ? length : SIZE_100_PERSENT;
             styles.width = data.config.isVertical ? regular ? length : SIZE_100_PERSENT : data.config.dynamic ? SIZE_AUTO : `${data.measures.width}${PX}`;
         }
+        else {
+            this._elementRef.nativeElement.removeAttribute(ID);
+        }
         this._cdr.markForCheck();
     }
     updatePartStr(v, isSelected, isCollapsed) {
@@ -666,7 +719,7 @@ class NgVirtualListItemComponent extends BaseVirtualListItemComponent {
         if (v ? v.config.new : false) {
             part += PART_ITEM_NEW;
         }
-        if (this._$focus.getValue()) {
+        if (this._$focused.getValue()) {
             part += PART_ITEM_FOCUSED;
         }
         this._$part.next(part);
@@ -712,21 +765,15 @@ class NgVirtualListItemComponent extends BaseVirtualListItemComponent {
     onClickHandler() {
         this._service.itemClick(this.data);
     }
-    ngOnDestroy() {
-        if (this._$unsubscribe) {
-            this._$unsubscribe.next();
-            this._$unsubscribe.complete();
-        }
-    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: NgVirtualListItemComponent, deps: [{ token: i0.ChangeDetectorRef }, { token: i0.ElementRef }, { token: NgVirtualListService }], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "16.2.12", type: NgVirtualListItemComponent, selector: "ng-virtual-list-item", host: { attributes: { "role": "listitem" }, classAttribute: "ngvl__item" }, usesInheritance: true, ngImport: i0, template: "<ng-container *ngIf=\"data\">\r\n    <div #listItem [part]=\"$part | async\" [attr.ng-vl-index]=\"data.config.tabIndex || -1\" tabindex=\"0\" class=\"ngvl-item__container\" [ngClass]=\"{'snapped': data.config.snapped,\r\n        'snapped-out': data.config.snappedOut, 'focus': $focus | async}\" (click)=\"onClickHandler()\">\r\n        <ng-container *ngIf=\"itemRenderer\">\r\n            <ng-container [ngTemplateOutlet]=\"itemRenderer\"\r\n                [ngTemplateOutletContext]=\"{data: data.data || {}, measures: measures | async, config: $config | async}\"></ng-container>\r\n        </ng-container>\r\n    </div>\r\n</ng-container>", styles: [":host{display:block;position:absolute;left:0;top:0;box-sizing:border-box;overflow:hidden}.ngvl-item__container{margin:0;padding:0;overflow:hidden;background-color:#fff;width:inherit;height:inherit;box-sizing:border-box}\n"], dependencies: [{ kind: "directive", type: i2.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "directive", type: i2.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "directive", type: i2.NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "pipe", type: i2.AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "16.2.12", type: NgVirtualListItemComponent, selector: "ng-virtual-list-item", host: { attributes: { "role": "listitem" }, classAttribute: "ngvl__item" }, usesInheritance: true, ngImport: i0, template: "<ng-container *ngIf=\"data\">\r\n    <div #listItem [part]=\"$part | async\" [attr.ng-vl-index]=\"data.config.tabIndex || -1\" tabindex=\"0\" class=\"ngvl-item__container\" [ngClass]=\"{'snapped': data.config.snapped,\r\n        'snapped-out': data.config.snappedOut, 'focus': $focused | async}\" (click)=\"onClickHandler()\">\r\n        <ng-container *ngIf=\"itemRenderer\">\r\n            <ng-container [ngTemplateOutlet]=\"itemRenderer\"\r\n                [ngTemplateOutletContext]=\"{data: data.data || {}, measures: measures | async, config: $config | async}\"></ng-container>\r\n        </ng-container>\r\n    </div>\r\n</ng-container>", styles: [":host{display:block;position:absolute;left:0;top:0;box-sizing:border-box;overflow:hidden}.ngvl-item__container{margin:0;padding:0;overflow:hidden;background-color:#fff;width:inherit;height:inherit;box-sizing:border-box}\n"], dependencies: [{ kind: "directive", type: i2.NgClass, selector: "[ngClass]", inputs: ["class", "ngClass"] }, { kind: "directive", type: i2.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "directive", type: i2.NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "pipe", type: i2.AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: NgVirtualListItemComponent, decorators: [{
             type: Component,
             args: [{ selector: 'ng-virtual-list-item', host: {
                         'class': 'ngvl__item',
                         'role': 'listitem',
-                    }, changeDetection: ChangeDetectionStrategy.OnPush, template: "<ng-container *ngIf=\"data\">\r\n    <div #listItem [part]=\"$part | async\" [attr.ng-vl-index]=\"data.config.tabIndex || -1\" tabindex=\"0\" class=\"ngvl-item__container\" [ngClass]=\"{'snapped': data.config.snapped,\r\n        'snapped-out': data.config.snappedOut, 'focus': $focus | async}\" (click)=\"onClickHandler()\">\r\n        <ng-container *ngIf=\"itemRenderer\">\r\n            <ng-container [ngTemplateOutlet]=\"itemRenderer\"\r\n                [ngTemplateOutletContext]=\"{data: data.data || {}, measures: measures | async, config: $config | async}\"></ng-container>\r\n        </ng-container>\r\n    </div>\r\n</ng-container>", styles: [":host{display:block;position:absolute;left:0;top:0;box-sizing:border-box;overflow:hidden}.ngvl-item__container{margin:0;padding:0;overflow:hidden;background-color:#fff;width:inherit;height:inherit;box-sizing:border-box}\n"] }]
+                    }, changeDetection: ChangeDetectionStrategy.OnPush, template: "<ng-container *ngIf=\"data\">\r\n    <div #listItem [part]=\"$part | async\" [attr.ng-vl-index]=\"data.config.tabIndex || -1\" tabindex=\"0\" class=\"ngvl-item__container\" [ngClass]=\"{'snapped': data.config.snapped,\r\n        'snapped-out': data.config.snappedOut, 'focus': $focused | async}\" (click)=\"onClickHandler()\">\r\n        <ng-container *ngIf=\"itemRenderer\">\r\n            <ng-container [ngTemplateOutlet]=\"itemRenderer\"\r\n                [ngTemplateOutletContext]=\"{data: data.data || {}, measures: measures | async, config: $config | async}\"></ng-container>\r\n        </ng-container>\r\n    </div>\r\n</ng-container>", styles: [":host{display:block;position:absolute;left:0;top:0;box-sizing:border-box;overflow:hidden}.ngvl-item__container{margin:0;padding:0;overflow:hidden;background-color:#fff;width:inherit;height:inherit;box-sizing:border-box}\n"] }]
         }], ctorParameters: function () { return [{ type: i0.ChangeDetectorRef }, { type: i0.ElementRef }, { type: NgVirtualListService }]; } });
 
 /**
@@ -1264,7 +1311,11 @@ const bufferInterpolation = (currentBufferValue, array, value, extra) => {
     return Math.ceil(buffer / l);
 };
 
-const TRACK_BOX_CHANGE_EVENT_NAME = 'change';
+var TrackBoxEvents;
+(function (TrackBoxEvents) {
+    TrackBoxEvents["CHANGE"] = "change";
+    TrackBoxEvents["RESET"] = "reset";
+})(TrackBoxEvents || (TrackBoxEvents = {}));
 var ItemDisplayMethods;
 (function (ItemDisplayMethods) {
     ItemDisplayMethods[ItemDisplayMethods["CREATE"] = 0] = "CREATE";
@@ -1272,7 +1323,7 @@ var ItemDisplayMethods;
     ItemDisplayMethods[ItemDisplayMethods["DELETE"] = 2] = "DELETE";
     ItemDisplayMethods[ItemDisplayMethods["NOT_CHANGED"] = 3] = "NOT_CHANGED";
 })(ItemDisplayMethods || (ItemDisplayMethods = {}));
-const DEFAULT_BUFFER_EXTREMUM_THRESHOLD = 15, DEFAULT_MAX_BUFFER_SEQUENCE_LENGTH = 30, DEFAULT_RESET_BUFFER_SIZE_TIMEOUT = 10000;
+const DEFAULT_BUFFER_EXTREMUM_THRESHOLD = 15, DEFAULT_MAX_BUFFER_SEQUENCE_LENGTH = 30, DEFAULT_RESET_BUFFER_SIZE_TIMEOUT = 10000, IS_NEW = 'isNew';
 /**
  * An object that performs tracking, calculations and caching.
  * @link https://github.com/DjonnyX/ng-virtual-list/blob/16.x/projects/ng-virtual-list/src/lib/utils/trackBox.ts
@@ -1309,6 +1360,13 @@ class TrackBox extends CacheMap {
         }
         this._isSnappingMethodAdvanced = v;
     }
+    _isLazy = false;
+    set isLazy(v) {
+        if (this._isLazy === v) {
+            return;
+        }
+        this._isLazy = v;
+    }
     /**
      * Set the trackBy property
      */
@@ -1341,7 +1399,7 @@ class TrackBox extends CacheMap {
     get crudDetected() { return this._crudDetected; }
     fireChangeIfNeed() {
         if (this.changesDetected()) {
-            this.dispatch(TRACK_BOX_CHANGE_EVENT_NAME, this._version);
+            this.dispatch(TrackBoxEvents.CHANGE, this._version);
         }
     }
     _previousTotalSize = 0;
@@ -1357,7 +1415,7 @@ class TrackBox extends CacheMap {
     _maxBufferSize = this._defaultBufferSize;
     _resetBufferSizeTimeout = DEFAULT_RESET_BUFFER_SIZE_TIMEOUT;
     _resetBufferSizeTimer;
-    isInit = true;
+    isReseted = true;
     lifeCircle() {
         this.fireChangeIfNeed();
         this.lifeCircleDo();
@@ -1370,11 +1428,19 @@ class TrackBox extends CacheMap {
             console.warn('Attention! The collection must be immutable.');
             return;
         }
-        if (this.isInit && !(!this._previousCollection || this._previousCollection.length === 0)) {
-            this.isInit = false;
+        let reseted = this.isReseted;
+        if (reseted) {
+            if (!(!this._previousCollection || this._previousCollection.length === 0)) {
+                reseted = false;
+            }
+        }
+        if (!reseted && (!currentCollection || currentCollection.length === 0)) {
+            reseted = true;
         }
+        this.isReseted = reseted;
+        this.dispatch(TrackBoxEvents.RESET, reseted);
         this.updateCache(this._previousCollection, currentCollection, itemSize);
-        this._previousCollection = currentCollection;
+        this._previousCollection = [...(currentCollection || [])];
     }
     /**
      * Update the cache of items from the list
@@ -1597,9 +1663,10 @@ class TrackBox extends CacheMap {
             leftItemsOffset = rightItemsOffset = bufferSize;
         }
         let itemsFromStartToScrollEnd = -1, itemsFromDisplayEndToOffsetEnd = 0, itemsFromStartToDisplayEnd = -1, leftItemLength = 0, rightItemLength = 0, leftItemsWeight = 0, rightItemsWeight = 0, leftHiddenItemsWeight = 0, totalItemsToDisplayEndWeight = 0, leftSizeOfAddedItems = 0, leftSizeOfUpdatedItems = 0, leftSizeOfDeletedItems = 0, itemById = undefined, itemByIdPos = 0, targetDisplayItemIndex = -1, isTargetInOverscroll = false, actualScrollSize = itemByIdPos, totalSize = 0, startIndex, isFromItemIdFound = false, deltaFromStartCreation = 0;
+        let isNew = !this.isReseted && (scrollSize === 0);
         // If the list is dynamic or there are new elements in the collection, then it switches to the long algorithm.
         if (dynamicSize) {
-            let y = 0, stickyCollectionItem = undefined, stickyComponentSize = 0, isNew = true;
+            let y = 0, stickyCollectionItem = undefined, stickyComponentSize = 0;
             for (let i = 0, l = collection.length; i < l; i++) {
                 const ii = i + 1, collectionItem = collection[i], id = collectionItem.id;
                 let componentSize = 0, componentSizeDelta = 0, itemDisplayMethod = ItemDisplayMethods.NOT_CHANGED;
@@ -1607,8 +1674,8 @@ class TrackBox extends CacheMap {
                     const bounds = map.get(id) || { width: typicalItemSize, height: typicalItemSize };
                     componentSize = bounds[sizeProperty];
                     itemDisplayMethod = bounds?.method ?? ItemDisplayMethods.UPDATE;
-                    const isItemNew = bounds.isNew ?? true;
-                    if (isNew && (this.isInit || (!isItemNew && i > 0))) {
+                    const isItemNew = bounds?.[IS_NEW] ?? this._isLazy;
+                    if (!isItemNew && (!this._isLazy || !itemConfigMap[collection[0].id]?.sticky)) {
                         isNew = false;
                     }
                     switch (itemDisplayMethod) {
@@ -1745,8 +1812,15 @@ class TrackBox extends CacheMap {
                     if (map.has(id)) {
                         const bounds = map.get(id);
                         itemDisplayMethod = bounds?.method ?? ItemDisplayMethods.UPDATE;
+                        const isItemNew = bounds?.[IS_NEW] ?? this._isLazy;
+                        if (!isItemNew && (!this._isLazy || !itemConfigMap[collection[0].id]?.sticky)) {
+                            isNew = false;
+                        }
                         if (itemDisplayMethod === ItemDisplayMethods.CREATE) {
-                            map.set(id, { ...bounds, method: ItemDisplayMethods.NOT_CHANGED });
+                            if (isNew) {
+                                deltaFromStartCreation += componentSize;
+                            }
+                            map.set(id, { ...bounds, method: ItemDisplayMethods.NOT_CHANGED, isNew });
                         }
                     }
                     if (deletedItemsMap.hasOwnProperty(i)) {
@@ -1758,7 +1832,9 @@ class TrackBox extends CacheMap {
                     if (y < scrollSize - componentSize) {
                         switch (itemDisplayMethod) {
                             case ItemDisplayMethods.CREATE: {
-                                leftSizeOfUpdatedItems += componentSize;
+                                if (!isNew) {
+                                    leftSizeOfUpdatedItems += componentSize;
+                                }
                                 break;
                             }
                             case ItemDisplayMethods.UPDATE: {
@@ -1854,7 +1930,7 @@ class TrackBox extends CacheMap {
                             height: isVertical ? size : normalizedItemHeight,
                             delta: 0,
                         }, config = {
-                            new: cache.isNew === true,
+                            new: cache?.[IS_NEW] === true,
                             odd: isOdd,
                             even: !isOdd,
                             isVertical,
@@ -1896,7 +1972,7 @@ class TrackBox extends CacheMap {
                             height: h,
                             delta: 0,
                         }, config = {
-                            new: cache.isNew === true,
+                            new: cache?.[IS_NEW] === true,
                             odd: isOdd,
                             even: !isOdd,
                             isVertical,
@@ -1937,7 +2013,7 @@ class TrackBox extends CacheMap {
                         height: isVertical ? size : normalizedItemHeight,
                         delta: 0,
                     }, config = {
-                        new: cache.isNew === true,
+                        new: cache?.[IS_NEW] === true,
                         odd: isOdd,
                         even: !isOdd,
                         isVertical,
@@ -2123,7 +2199,21 @@ const copyValueAsReadonly = (source) => {
     return source;
 };
 
-const ROLE_LIST = 'list', ROLE_LIST_BOX = 'listbox';
+const NORMAL_ALIASES = [CollectionModes.NORMAL, 'normal'], LAZY_ALIASES = [CollectionModes.LAZY, 'lazy'];
+/**
+ * Determines the axis membership of a virtual list
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/16.x/projects/ng-virtual-list/src/lib/utils/isCollectionMode.ts
+ * @author Evgenii Grebennikov
+ * @email djonnyx@gmail.com
+ */
+const isCollectionMode = (src, expected) => {
+    if (LAZY_ALIASES.includes(expected)) {
+        return LAZY_ALIASES.includes(src);
+    }
+    return NORMAL_ALIASES.includes(src);
+};
+
+const ROLE_LIST = 'list', ROLE_LIST_BOX = 'listbox', ITEM_ID = 'item-id', ITEM_CONTAINER = 'ngvl-item__container';
 const validateScrollIteration = (value) => {
     return Number.isNaN(value) || (value < 0) ? 0 : value > MAX_SCROLL_TO_ITERATIONS ? MAX_SCROLL_TO_ITERATIONS : value;
 }, validateId = (id) => {
@@ -2142,6 +2232,11 @@ const validateScrollIteration = (value) => {
     if (!valid) {
         throw Error('The "iteration" parameter must be of type `number`.');
     }
+}, validateFocusAlignment = (align) => {
+    const valid = validateString(align) && (align === 'none' || align === 'start' || align === 'center' || align === 'end');
+    if (!valid) {
+        throw Error('The "align" parameter must have the value `none`, `start`, `center` or `end`.');
+    }
 };
 /**
  * Virtual list component.
@@ -2541,6 +2636,29 @@ class NgVirtualListComponent {
     }
     ;
     get direction() { return this._$direction.getValue(); }
+    _$collectionMode = new BehaviorSubject$1(DEFAULT_COLLECTION_MODE);
+    $collectionMode = this._$collectionMode.asObservable();
+    _collectionModeTransform = (v) => {
+        const valid = validateString(v) && (v === 'normal' || v === 'lazy');
+        if (!valid) {
+            console.error('The "direction" parameter must have the value `normal` or `lazy`.');
+            return DEFAULT_COLLECTION_MODE;
+        }
+        return v;
+    };
+    /**
+     * Determines the action modes for collection elements. Default value is "normal".
+     */
+    set collectionMode(v) {
+        if (this._$collectionMode.getValue() === v) {
+            return;
+        }
+        const transformedValue = this._collectionModeTransform(v);
+        this._$collectionMode.next(transformedValue);
+        this._cdr.markForCheck();
+    }
+    ;
+    get collectionMode() { return this._$collectionMode.getValue(); }
     _$bufferSize = new BehaviorSubject$1(DEFAULT_BUFFER_SIZE);
     $bufferSize = this._$bufferSize.asObservable();
     _bufferSizeTransform = (v) => {
@@ -2664,6 +2782,7 @@ class NgVirtualListComponent {
     ;
     get trackBy() { return this._$trackBy.getValue(); }
     _isVertical = this.getIsVertical();
+    _isLazy = this.getIsLazy();
     get orientation() {
         return this._isVertical ? Directions.VERTICAL : Directions.HORIZONTAL;
     }
@@ -2739,12 +2858,33 @@ class NgVirtualListComponent {
             this._$scrollSize.next(scrollSize);
         }
     };
-    itemToFocus = (element, position) => {
+    itemToFocus = (element, position, align = FocusAlignments.CENTER) => {
         const container = this._container?.nativeElement;
         if (container) {
-            const { width, height } = this._$bounds.getValue(), { width: elementWidth, height: elementHeight } = element.getBoundingClientRect(), isVertical = this._isVertical, pos = isVertical ? position - (height - elementHeight) * .5 : position - (width - elementWidth) * .5;
-            const params = { [this._isVertical ? TOP_PROP_NAME : LEFT_PROP_NAME]: pos, behavior: 'instant' };
-            container.scrollTo(params);
+            const { width, height } = this._$bounds.getValue(), { width: elementWidth, height: elementHeight } = element.getBoundingClientRect(), isVertical = this._isVertical;
+            let pos = Number.NaN;
+            switch (align) {
+                case FocusAlignments.START: {
+                    pos = isVertical ? position : position;
+                    break;
+                }
+                case FocusAlignments.CENTER: {
+                    pos = isVertical ? position - (height - elementHeight) * .5 : position - (width - elementWidth) * .5;
+                    break;
+                }
+                case FocusAlignments.END: {
+                    pos = isVertical ? position - (height - elementHeight) : position - (width - elementWidth);
+                    break;
+                }
+                case FocusAlignments.NONE:
+                default: {
+                    break;
+                }
+            }
+            if (!Number.isNaN(pos)) {
+                const params = { [this._isVertical ? TOP_PROP_NAME : LEFT_PROP_NAME]: pos, behavior: 'instant' };
+                container.scrollTo(params);
+            }
         }
     };
     _$initialized = new BehaviorSubject$1(false);
@@ -2768,6 +2908,20 @@ class NgVirtualListComponent {
     };
     _$cacheVersion = new BehaviorSubject$1(-1);
     get $cacheVersion() { return this._$cacheVersion.asObservable(); }
+    _isResetedReachStart = true;
+    _onTrackBoxResetHandler = (v) => {
+        if (v) {
+            this._isResetedReachStart = true;
+            const container = this._container?.nativeElement;
+            if (container) {
+                const params = {
+                    [this._isVertical ? TOP_PROP_NAME : LEFT_PROP_NAME]: 0,
+                    behavior: BEHAVIOR_INSTANT,
+                };
+                container.scrollTo(params);
+            }
+        }
+    };
     constructor(_cdr, _elementRef, _service) {
         this._cdr = _cdr;
         this._elementRef = _elementRef;
@@ -2785,12 +2939,13 @@ class NgVirtualListComponent {
         })).subscribe();
         this._trackBox.displayComponents = this._displayComponents;
         const $trackBy = this.$trackBy, $selectByClick = this.$selectByClick, $collapseByClick = this.$collapseByClick, $isScrollStart = this._$isScrollStart.asObservable(), $isScrollFinished = this._$isScrollFinished.asObservable();
-        $isScrollStart.pipe(takeUntilDestroyed(), distinctUntilChanged(), skip(1), tap(v => {
-            if (v) {
+        $isScrollStart.pipe(takeUntilDestroyed(), distinctUntilChanged(), tap(v => {
+            if (v && !this._isResetedReachStart) {
                 this.onScrollReachStart.emit();
             }
+            this._isResetedReachStart = false;
         })).subscribe();
-        $isScrollFinished.pipe(takeUntilDestroyed(), distinctUntilChanged(), skip(1), tap(v => {
+        $isScrollFinished.pipe(takeUntilDestroyed(), distinctUntilChanged(), tap(v => {
             if (v) {
                 this.onScrollReachEnd.emit();
             }
@@ -2804,7 +2959,10 @@ class NgVirtualListComponent {
         $trackBy.pipe(takeUntilDestroyed(), tap(v => {
             this._trackBox.trackingPropertyName = v;
         })).subscribe();
-        const $bounds = this._$bounds.asObservable().pipe(filter(b => !!b)), $items = this.$items.pipe(map$1(i => !i ? [] : i)), $scrollSize = this._$scrollSize.asObservable(), $itemSize = this.$itemSize.pipe(map$1(v => v <= 0 ? DEFAULT_ITEM_SIZE : v)), $bufferSize = this.$bufferSize.pipe(map$1(v => v < 0 ? DEFAULT_BUFFER_SIZE : v)), $maxBufferSize = this.$maxBufferSize.pipe(map$1(v => v < 0 ? DEFAULT_MAX_BUFFER_SIZE : v)), $itemConfigMap = this.$itemConfigMap.pipe(map$1(v => !v ? {} : v)), $snap = this.$snap, $isVertical = this.$direction.pipe(map$1(v => this.getIsVertical(v || DEFAULT_DIRECTION))), $dynamicSize = this.$dynamicSize, $enabledBufferOptimization = this.$enabledBufferOptimization, $snappingMethod = this.$snappingMethod.pipe(map$1(v => this.getIsSnappingMethodAdvanced(v || DEFAULT_SNAPPING_METHOD))), $methodForSelecting = this.$methodForSelecting, $selectedIds = this.$selectedIds, $collapsedIds = this.$collapsedIds.pipe(map$1(v => Array.isArray(v) ? v : [])), $collapsedItemIds = this._$collapsedItemIds.asObservable().pipe(map$1(v => Array.isArray(v) ? v : [])), $actualItems = this._$actualItems.asObservable(), $cacheVersion = this.$cacheVersion;
+        const $bounds = this._$bounds.asObservable().pipe(filter(b => !!b)), $items = this.$items.pipe(map$1(i => !i ? [] : i)), $scrollSize = this._$scrollSize.asObservable(), $itemSize = this.$itemSize.pipe(map$1(v => v <= 0 ? DEFAULT_ITEM_SIZE : v)), $bufferSize = this.$bufferSize.pipe(map$1(v => v < 0 ? DEFAULT_BUFFER_SIZE : v)), $maxBufferSize = this.$maxBufferSize.pipe(map$1(v => v < 0 ? DEFAULT_MAX_BUFFER_SIZE : v)), $itemConfigMap = this.$itemConfigMap.pipe(map$1(v => !v ? {} : v)), $snap = this.$snap, $isVertical = this.$direction.pipe(map$1(v => this.getIsVertical(v || DEFAULT_DIRECTION))), $isLazy = this.$collectionMode.pipe(map$1(v => this.getIsLazy(v || DEFAULT_COLLECTION_MODE))), $dynamicSize = this.$dynamicSize, $enabledBufferOptimization = this.$enabledBufferOptimization, $snappingMethod = this.$snappingMethod.pipe(map$1(v => this.getIsSnappingMethodAdvanced(v || DEFAULT_SNAPPING_METHOD))), $methodForSelecting = this.$methodForSelecting, $selectedIds = this.$selectedIds, $collapsedIds = this.$collapsedIds.pipe(map$1(v => Array.isArray(v) ? v : [])), $collapsedItemIds = this._$collapsedItemIds.asObservable().pipe(map$1(v => Array.isArray(v) ? v : [])), $actualItems = this._$actualItems.asObservable(), $cacheVersion = this.$cacheVersion;
+        $isLazy.pipe(takeUntilDestroyed(), tap(v => {
+            this._trackBox.isLazy = v;
+        })).subscribe();
         combineLatest([$items, $itemSize, this.$initialized]).pipe(takeUntilDestroyed(), distinctUntilChanged(), filter(([, , init]) => !!init), map$1(([items, itemSize]) => ({ items, itemSize })), tap(({ items, itemSize }) => {
             this._trackBox.resetCollection(items, itemSize);
         })).subscribe();
@@ -2953,13 +3111,13 @@ class NgVirtualListComponent {
     }
     listenCacheChangesIfNeed(value) {
         if (value) {
-            if (!this._trackBox.hasEventListener(TRACK_BOX_CHANGE_EVENT_NAME, this._onTrackBoxChangeHandler)) {
-                this._trackBox.addEventListener(TRACK_BOX_CHANGE_EVENT_NAME, this._onTrackBoxChangeHandler);
+            if (!this._trackBox.hasEventListener(TrackBoxEvents.CHANGE, this._onTrackBoxChangeHandler)) {
+                this._trackBox.addEventListener(TrackBoxEvents.CHANGE, this._onTrackBoxChangeHandler);
             }
         }
         else {
-            if (this._trackBox.hasEventListener(TRACK_BOX_CHANGE_EVENT_NAME, this._onTrackBoxChangeHandler)) {
-                this._trackBox.removeEventListener(TRACK_BOX_CHANGE_EVENT_NAME, this._onTrackBoxChangeHandler);
+            if (this._trackBox.hasEventListener(TrackBoxEvents.CHANGE, this._onTrackBoxChangeHandler)) {
+                this._trackBox.removeEventListener(TrackBoxEvents.CHANGE, this._onTrackBoxChangeHandler);
             }
         }
     }
@@ -2983,6 +3141,10 @@ class NgVirtualListComponent {
         const dir = d || this.direction;
         return isDirection(dir, Directions.VERTICAL);
     }
+    getIsLazy(m) {
+        const mode = m || this.collectionMode;
+        return isCollectionMode(mode, CollectionModes.LAZY);
+    }
     _componentsResizeObserver = new ResizeObserver(() => {
         this._trackBox.changes();
     });
@@ -3048,6 +3210,20 @@ class NgVirtualListComponent {
         validateId(id);
         return this._trackBox.getItemBounds(id);
     }
+    /**
+     * Focus an list item by a given id.
+     */
+    focus(id, align = FocusAlignments.NONE) {
+        validateId(id);
+        validateFocusAlignment(align);
+        const el = this._list?.nativeElement.querySelector(`[${ITEM_ID}="${id}"]`);
+        if (el) {
+            const focusedEl = el.querySelector(`.${ITEM_CONTAINER}`);
+            if (focusedEl) {
+                this._service.focus(focusedEl, align);
+            }
+        }
+    }
     /**
      * 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".
@@ -3209,7 +3385,7 @@ class NgVirtualListComponent {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: NgVirtualListComponent, deps: [{ token: i0.ChangeDetectorRef }, { token: i0.ElementRef }, { token: NgVirtualListService }], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "16.2.12", type: NgVirtualListComponent, selector: "ng-virtual-list", inputs: { items: "items", selectedIds: "selectedIds", collapsedIds: "collapsedIds", selectByClick: "selectByClick", collapseByClick: "collapseByClick", snap: "snap", enabledBufferOptimization: "enabledBufferOptimization", itemRenderer: "itemRenderer", itemConfigMap: "itemConfigMap", itemSize: "itemSize", dynamicSize: "dynamicSize", direction: "direction", bufferSize: "bufferSize", maxBufferSize: "maxBufferSize", snappingMethod: "snappingMethod", methodForSelecting: "methodForSelecting", trackBy: "trackBy" }, outputs: { onScroll: "onScroll", onScrollEnd: "onScrollEnd", onViewportChange: "onViewportChange", onItemClick: "onItemClick", onSelect: "onSelect", onCollapse: "onCollapse", onScrollReachStart: "onScrollReachStart", onScrollReachEnd: "onScrollReachEnd" }, host: { styleAttribute: "position: relative;" }, providers: [NgVirtualListService], viewQueries: [{ propertyName: "_listContainerRef", first: true, predicate: ["renderersContainer"], descendants: true, read: ViewContainerRef }, { propertyName: "_container", first: true, predicate: ["container"], descendants: true, read: (ElementRef) }, { propertyName: "_list", first: true, predicate: ["list"], descendants: true, read: (ElementRef) }, { propertyName: "_snapContainerRef", first: true, predicate: ["snapRendererContainer"], descendants: true, read: ViewContainerRef }, { propertyName: "_snappedContainer", first: true, predicate: ["snapped"], descendants: true, read: ViewContainerRef }], ngImport: i0, template: "<div *ngIf=\"snap\" #snapped part=\"snapped-item\" class=\"ngvl__list-snapper\">\r\n  <ng-container #snapRendererContainer></ng-container>\r\n</div>\r\n<div #container part=\"scroller\" class=\"ngvl__scroller\">\r\n  <div [attr.aria-orientation]=\"orientation\" [attr.aria-activedescendant]=\"$focusedElement | async\" #list part=\"list\"\r\n    class=\"ngvl__list\">\r\n    <ng-container #renderersContainer></ng-container>\r\n  </div>\r\n</div>", styles: [":host{position:relative;display:block;width:400px;overflow:hidden}:host(.horizontal){height:48px}:host(.horizontal) .ngvl__list{display:inline-flex}:host(.horizontal) .ngvl__scroller{overflow:auto hidden}:host(.vertical) .ngvl__scroller{overflow:hidden auto}:host(.vertical){height:320px}.ngvl__scroller{overflow:auto;width:100%;height:100%}.ngvl__list-snapper{pointer-events:none;position:absolute;list-style:none;left:0;top:0;z-index:1}.ngvl__list{position:relative;list-style:none;padding:0;margin:0;width:100%;height:100%}\n"], dependencies: [{ kind: "directive", type: i2.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "pipe", type: i2.AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush, encapsulation: i0.ViewEncapsulation.ShadowDom });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "16.2.12", type: NgVirtualListComponent, selector: "ng-virtual-list", inputs: { items: "items", selectedIds: "selectedIds", collapsedIds: "collapsedIds", selectByClick: "selectByClick", collapseByClick: "collapseByClick", snap: "snap", enabledBufferOptimization: "enabledBufferOptimization", itemRenderer: "itemRenderer", itemConfigMap: "itemConfigMap", itemSize: "itemSize", dynamicSize: "dynamicSize", direction: "direction", collectionMode: "collectionMode", bufferSize: "bufferSize", maxBufferSize: "maxBufferSize", snappingMethod: "snappingMethod", methodForSelecting: "methodForSelecting", trackBy: "trackBy" }, outputs: { onScroll: "onScroll", onScrollEnd: "onScrollEnd", onViewportChange: "onViewportChange", onItemClick: "onItemClick", onSelect: "onSelect", onCollapse: "onCollapse", onScrollReachStart: "onScrollReachStart", onScrollReachEnd: "onScrollReachEnd" }, host: { styleAttribute: "position: relative;" }, providers: [NgVirtualListService], viewQueries: [{ propertyName: "_listContainerRef", first: true, predicate: ["renderersContainer"], descendants: true, read: ViewContainerRef }, { propertyName: "_container", first: true, predicate: ["container"], descendants: true, read: (ElementRef) }, { propertyName: "_list", first: true, predicate: ["list"], descendants: true, read: (ElementRef) }, { propertyName: "_snapContainerRef", first: true, predicate: ["snapRendererContainer"], descendants: true, read: ViewContainerRef }, { propertyName: "_snappedContainer", first: true, predicate: ["snapped"], descendants: true, read: ViewContainerRef }], ngImport: i0, template: "<div *ngIf=\"snap\" #snapped part=\"snapped-item\" class=\"ngvl__list-snapper\">\r\n  <ng-container #snapRendererContainer></ng-container>\r\n</div>\r\n<div #container part=\"scroller\" class=\"ngvl__scroller\">\r\n  <div [attr.aria-orientation]=\"orientation\" [attr.aria-activedescendant]=\"$focusedElement | async\" #list part=\"list\"\r\n    class=\"ngvl__list\">\r\n    <ng-container #renderersContainer></ng-container>\r\n  </div>\r\n</div>", styles: [":host{position:relative;display:block;width:400px;overflow:hidden}:host(.horizontal){height:48px}:host(.horizontal) .ngvl__list{display:inline-flex}:host(.horizontal) .ngvl__scroller{overflow:auto hidden}:host(.vertical) .ngvl__scroller{overflow:hidden auto}:host(.vertical){height:320px}.ngvl__scroller{overflow:auto;width:100%;height:100%}.ngvl__list-snapper{pointer-events:none;position:absolute;list-style:none;left:0;top:0;z-index:1}.ngvl__list{position:relative;list-style:none;padding:0;margin:0;width:100%;height:100%}\n"], dependencies: [{ kind: "directive", type: i2.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "pipe", type: i2.AsyncPipe, name: "async" }], changeDetection: i0.ChangeDetectionStrategy.OnPush, encapsulation: i0.ViewEncapsulation.ShadowDom });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: NgVirtualListComponent, decorators: [{
             type: Component,
@@ -3271,6 +3447,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
                 type: Input
             }], direction: [{
                 type: Input
+            }], collectionMode: [{
+                type: Input
             }], bufferSize: [{
                 type: Input
             }], maxBufferSize: [{
@@ -3306,5 +3484,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { Directions, MethodsForSelecting, NgVirtualListComponent, NgVirtualListItemComponent, NgVirtualListModule, ScrollEvent, SnappingMethods, debounce, toggleClassName };
+export { CollectionModes, Directions, FocusAlignments, MethodsForSelecting, NgVirtualListComponent, NgVirtualListItemComponent, NgVirtualListModule, ScrollEvent, SnappingMethods, debounce, toggleClassName };
 //# sourceMappingURL=ng-virtual-list.mjs.map