ng-virtual-list 19.11.3 → 19.12.0

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

@@ -1,8 +1,7 @@
-import { OnDestroy, TemplateRef } from '@angular/core';
+import { OnDestroy, Signal, TemplateRef } from '@angular/core';
 import { IRenderVirtualListItem, IVirtualListCollection, IVirtualListItem, IVirtualListItemConfigMap } from './models';
 import { IScrollEvent, IScrollOptions, IAnimationParams, ISize, IScrollingSettings } from './interfaces';
-import { FocusAlignment, Id } from './types';
-import { CollectionMode, Direction, MethodForSelecting, SnappingMethod, TextDirection } from './enums';
+import { Alignment, ArithmeticExpression, FocusAlignment, Id, ItemTransform, SnappingDistance, CollectionMode, Direction, SelectingMode, SnappingMethod, SnapToItemAlign, TextDirection, CollapsingMode, SpreadingMode } from './types';
 import { BaseVirtualListItemComponent } from './components/ng-list-item/base';
 import { Component$1 } from './models/component.model';
 import { IScrollParams } from './interfaces';
@@ -41,6 +40,10 @@ export declare class NgVirtualListComponent implements OnDestroy {
      * Fires when the viewport size is changed.
      */
     onViewportChange: import("@angular/core").OutputEmitterRef<ISize>;
+    /**
+     * Emit the component ID when an element crosses the alignment line specified by the snapToItemAlign property.
+     */
+    onSnapItem: import("@angular/core").OutputEmitterRef<Id>;
     /**
      * Fires when an element is clicked.
      */
@@ -63,6 +66,8 @@ export declare class NgVirtualListComponent implements OnDestroy {
     onScrollReachEnd: import("@angular/core").OutputEmitterRef<void>;
     private _$show;
     readonly $show: import("rxjs").Observable<boolean>;
+    private _$initialized;
+    readonly $initialized: import("rxjs").Observable<boolean>;
     private _scrollbarThickness;
     /**
      * Scrollbar thickness.
@@ -118,7 +123,7 @@ export declare class NgVirtualListComponent implements OnDestroy {
     collapsedIds: import("@angular/core").InputSignal<Id[]>;
     private _selectByClickOptions;
     /**
-     * If `false`, the element is selected using the config.select method passed to the template;
+     * If `false`, the element is selected using the api.select method passed to the template;
      * if `true`, the element is selected by clicking on it. The default value is `true`.
      */
     selectByClick: import("@angular/core").InputSignal<boolean>;
@@ -130,9 +135,15 @@ export declare class NgVirtualListComponent implements OnDestroy {
     collapseByClick: import("@angular/core").InputSignal<boolean>;
     private _snapOptions;
     /**
-     * Determines whether elements will snap. Default value is "true".
+     * @deprecated
+     * Use the `stickyEnabled` property instead.
      */
     snap: import("@angular/core").InputSignal<boolean>;
+    private _stickyEnabledOptions;
+    /**
+     * Determines whether items with the given `sticky` in `itemConfigMap` will stick to the edges. Default value is "true".
+     */
+    stickyEnabled: import("@angular/core").InputSignal<boolean>;
     private _snapToEndTransitionInstantOffsetOptions;
     /**
      * Sets the offset value; if the scroll area value is exceeded, the scroll animation will be disabled. Default value is "0".
@@ -140,14 +151,16 @@ export declare class NgVirtualListComponent implements OnDestroy {
     snapToEndTransitionInstantOffset: import("@angular/core").InputSignal<number>;
     private _scrollStartOffsetOptions;
     /**
-     * Sets the scroll start offset value; Default value is "0".
+     * Sets the scroll start offset value. Can be specified in absolute or percentage values.
+     * Supports arithmetic expressions of addition `50% + 25` or subtraction `50% - 25`. Default value is "0".
      */
-    scrollStartOffset: import("@angular/core").InputSignal<number>;
+    scrollStartOffset: import("@angular/core").InputSignal<ArithmeticExpression>;
     private _scrollEndOffsetOptions;
     /**
-     * Sets the scroll end offset value; Default value is "0".
+     * Sets the scroll end offset value. Can be specified in absolute or percentage values.
+     * Supports arithmetic expressions of addition `50% + 25` or subtraction `50% - 25`. Default value is "0".
      */
-    scrollEndOffset: import("@angular/core").InputSignal<number>;
+    scrollEndOffset: import("@angular/core").InputSignal<ArithmeticExpression>;
     private _snapScrollToStartOptions;
     /**
      * Determines whether the scroll will be anchored to the start of the list. Default value is "true".
@@ -157,6 +170,7 @@ export declare class NgVirtualListComponent implements OnDestroy {
      * If snapScrollToStart is disabled and snapScrollToEnd is enabled, the list will snap to the end;
      * if you move the scroll bar to the beginning, the list will snap to the beginning.
      * If both snapScrollToStart and snapScrollToEnd are disabled, the list will never snap to the beginning or end.
+     * In the `spreadingMode=SpreadingModes.INFINITY` mode, the `snapScrollToStart` property is automatically disabled, since the list has no beginning or end.
      */
     snapScrollToStart: import("@angular/core").InputSignal<boolean>;
     private _snapScrollToEndOptions;
@@ -167,6 +181,7 @@ export declare class NgVirtualListComponent implements OnDestroy {
      * If snapScrollToStart is disabled and snapScrollToEnd is enabled, the list will snap to the end;
      * if you move the scroll bar to the beginning, the list will snap to the beginning.
      * If both snapScrollToStart and snapScrollToEnd are disabled, the list will never snap to the beginning or end.
+     * In the `spreadingMode=SpreadingModes.INFINITY` mode, the `snapScrollToEnd` property is automatically disabled, since the list has no beginning or end.
      */
     snapScrollToEnd: import("@angular/core").InputSignal<boolean>;
     private _snapScrollToBottomOptions;
@@ -185,6 +200,11 @@ export declare class NgVirtualListComponent implements OnDestroy {
      * Determines whether scrolling using the scrollbar will be possible. The default value is "true".
      */
     scrollbarInteractive: import("@angular/core").InputSignal<boolean>;
+    private _overlappingScrollbarOptions;
+    /**
+     * Determines whether the scroll bar will overlap the list. The default value is "false".
+     */
+    overlappingScrollbar: import("@angular/core").InputSignal<boolean>;
     private _scrollBehaviorOptions;
     /**
      * Defines the scrolling behavior for any element on the page. The default value is "smooth".
@@ -195,15 +215,81 @@ export declare class NgVirtualListComponent implements OnDestroy {
      * Scrolling settings.
      * - frictionalForce - Frictional force. Default value is 0.035.
      * - mass - Mass. Default value is 0.005.
-     * - maxDistance - Maximum scrolling distance. Default value is 12500.
+     * - maxDistance - Maximum scrolling distance. Default value is 100000.
      * - maxDuration - Maximum animation duration. Default value is 4000.
-     * - speedScale - Speed scale. Default value is 15.
+     * - speedScale - Speed scale. Default value is 10.
      * - optimization - Enables scrolling performance optimization. Default value is `true`.
      */
     scrollingSettings: import("@angular/core").InputSignal<IScrollingSettings>;
+    private _itemTransformOptions;
+    /**
+     * Custom transformation of element's position, rotation, scale, opacity and zIndex. The default value is `null`.
+     */
+    itemTransform: import("@angular/core").InputSignal<ItemTransform | null>;
+    private _snapToItemOptions;
+    /**
+     * Snap to an item. The default value is `false`.
+     */
+    snapToItem: import("@angular/core").InputSignal<boolean>;
+    private _snapToItemAlignOptions;
+    /**
+     * Alignment for snapToItem. Available values ​​are `start`, `center`, and `end`. The default value is `center`.
+     */
+    snapToItemAlign: import("@angular/core").InputSignal<SnapToItemAlign>;
+    private _snappingDistanceOptions;
+    /**
+     * Snapping activation distance. Can be specified as a percentage of the element size or in absolute values.
+     * The default value is `25%`.
+     */
+    snappingDistance: import("@angular/core").InputSignal<SnappingDistance>;
+    private _scrollingOneByOneOptions;
+    /**
+     * Specifies whether to scroll one item at a time if true and the scrollToItem property is set. The default value is `false`.
+     */
+    scrollingOneByOne: import("@angular/core").InputSignal<boolean>;
+    private _alignmentOptions;
+    /**
+     * Determines the alignment of the list. Two modes are available: `none` and `center`. The `center` mode aligns the list items to the center of the viewport, ideal for use with the `itemTransform` property.
+     * The `none` mode means no alignment. The default value is `none`.
+     */
+    alignment: import("@angular/core").InputSignal<Alignment>;
+    private _zIndexWhenSelectingOptions;
+    /**
+     * Defines the zIndex when a list item is selected. The default value is `null`.
+     */
+    zIndexWhenSelecting: import("@angular/core").InputSignal<string | null>;
+    private _spreadingModeOptions;
+    /**
+     * The order of list elements. Available values ​​are `standard` and `infinity`.
+     * `normal` — list elements are ordered according to the collection sequence.
+     * `infinity` — list elements are ordered cyclically, forming an infinite list.
+     * When set to `infinity`, the `alignment` property is forced to the value `Alignments.CENTER`, the `scrollbarEnabled` property is forced to the `false`
+     * The default value is `standard`.
+     */
+    spreadingMode: import("@angular/core").InputSignal<SpreadingMode>;
+    private _dividesOptions;
+    /**
+     * Column or row numbers. The default value is `1`.
+     */
+    divides: import("@angular/core").InputSignal<number>;
+    private _motionBlurOptions;
+    /**
+     * Motion blur effect. The default value is `0.15`.
+     */
+    motionBlur: import("@angular/core").InputSignal<number>;
+    private _maxMotionBlurOptions;
+    /**
+     * Maximum motion blur effect. The default value is `0.5`.
+     */
+    maxMotionBlur: import("@angular/core").InputSignal<number>;
+    private _motionBlurEnabledOptions;
+    /**
+     * Determines whether to apply motion blur or not. The default value is `false`.
+     */
+    motionBlurEnabled: import("@angular/core").InputSignal<boolean>;
     private _animationParamsOptions;
     /**
-     * Animation parameters. The default value is "{ scrollToItem: 50, navigateToItem: 150 }".
+     * Animation parameters. The default value is "{ scrollToItem: 50, snapToItem: 150, navigateToItem: 150, navigateByKeyboard: 50 }".
      */
     animationParams: import("@angular/core").InputSignal<IAnimationParams>;
     private _overscrollEnabledOptions;
@@ -227,12 +313,13 @@ export declare class NgVirtualListComponent implements OnDestroy {
     private _itemRenderer;
     private _itemConfigMapOptions;
     /**
-     * Sets `sticky` position, `collapsable` and `selectable` for the list item element. If `sticky` position is greater than `0`, then `sticky` position is applied.
+     * Sets `sticky` position, `fullSize`, `collapsable` and `selectable` for the list item element. If `sticky` position is greater than `0`, then `sticky` position is applied.
      * If the `sticky` value is greater than `0`, then the `sticky` position mode is enabled for the element. `1` - position start, `2` - position end.
      *  Default value is `0`.
      * `selectable` determines whether an element can be selected or not. Default value is `true`.
      * `collapsable` determines whether an element with a `sticky` property greater than zero can collapse and
      *  collapse elements in front that do not have a `sticky` property.
+     * `fullSize` determines the size of an element when rendering lists with cell divisions. If sticky is 1 or 2, fullSize automatically becomes true. The default value is false.
      * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/models/item-config-map.model.ts
      * @author Evgenii Alexandrovich Grebennikov
      * @email djonnyx@gmail.com
@@ -241,10 +328,23 @@ export declare class NgVirtualListComponent implements OnDestroy {
     private _itemSizeOptions;
     /**
      * If direction = 'vertical', then the height of a typical element. If direction = 'horizontal', then the width of a typical element.
-     * If the dynamicSize property is true, the items in the list can have different sizes, and you must specify the itemSize property
+     * If the `dynamicSize` property is true, the items in the list can have different sizes, and you must specify the `itemSize` property
      * to adjust the sizes of the items in the unallocated area.
+     * If the value is 'viewport', the sizes of elements are automatically resized to fit the viewport size.
+     */
+    itemSize: import("@angular/core").InputSignal<number | "viewport">;
+    private _minItemSizeOptions;
+    /**
+     * If the `dynamicSize` property is enabled, the minimum size of the element is set.
+     * If the value is 'viewport', the sizes of elements are automatically resized to fit the viewport size.
+     */
+    minItemSize: import("@angular/core").InputSignal<number | "viewport">;
+    private _maxItemSizeOptions;
+    /**
+     * If the `dynamicSize` property is enabled, the maximum size of the element is set.
+     * If the value is 'viewport', the sizes of elements are automatically resized to fit the viewport size.
      */
-    itemSize: import("@angular/core").InputSignal<number>;
+    maxItemSize: import("@angular/core").InputSignal<number | "viewport">;
     private _dynamicSizeOptions;
     /**
      * If true, items in the list may have different sizes, and the itemSize property must be specified to adjust
@@ -281,14 +381,29 @@ export declare class NgVirtualListComponent implements OnDestroy {
      * 'advanced' - A mask is applied to the viewport area so that the background is displayed underneath the attached group.
      */
     snappingMethod: import("@angular/core").InputSignal<SnappingMethod>;
+    private _collapsingModeOptions;
+    /**
+     * Mode for collapsing list items.
+     * `none` - List items are not selectable.
+     * `multi-collapse` - List items are collapsed one by one.
+     * 'accordion' - Accordion collapsible list items.
+     * Default value is `multi-collapse
+     */
+    collapsingMode: import("@angular/core").InputSignal<CollapsingMode>;
     private _methodForSelectingOptions;
+    /**
+     * @deprecated
+     * The "methodForSelecting" property is deprecated. Use the "selectMode" property.
+     */
+    methodForSelecting: import("@angular/core").InputSignal<SelectingMode>;
+    private _selectingModeOptions;
     /**
      *  Method for selecting list items. Default value is 'none'.
      * 'select' - List items are selected one by one.
      * 'multi-select' - Multiple selection of list items.
      * 'none' - List items are not selectable.
      */
-    methodForSelecting: import("@angular/core").InputSignal<MethodForSelecting>;
+    selectingMode: import("@angular/core").InputSignal<SelectingMode>;
     private _trackByOptions;
     /**
      * The name of the property by which tracking is performed
@@ -309,10 +424,12 @@ export declare class NgVirtualListComponent implements OnDestroy {
      * Can be either "ltr" (left-to-right) or "rtl" (right-to-left).
      */
     langTextDir: import("@angular/core").InputSignal<TextDirection>;
-    private _isNotSelecting;
-    private _isSingleSelecting;
-    private _isMultiSelecting;
+    private _isSingleSelection;
+    private _isMultiSelection;
+    private _isMultipleCollapse;
+    private _isAccordionCollapse;
     private _isSnappingMethodAdvanced;
+    protected _isInfinity: Signal<boolean>;
     private _isVertical;
     protected get isVertical(): boolean;
     protected readonly focusedElement: import("@angular/core").WritableSignal<Id | null>;
@@ -325,11 +442,28 @@ export declare class NgVirtualListComponent implements OnDestroy {
     private _snappedDisplayComponents;
     private _bounds;
     protected get bounds(): import("@angular/core").WritableSignal<ISize | null>;
+    protected _actualScrollbarEnabled: Signal<boolean>;
+    private _actualAlignment;
+    protected get actualAlignment(): Signal<Alignment>;
+    private _actualItemSize;
+    protected get actualItemSize(): import("@angular/core").WritableSignal<number>;
+    private _actualMinItemSize;
+    protected get actualMinItemSize(): import("@angular/core").WritableSignal<number>;
+    private _actualMaxItemSize;
+    protected get actualMaxItemSize(): import("@angular/core").WritableSignal<number>;
     private _totalSize;
     private _listBounds;
-    private _scrollSize;
+    private _$scrollSize;
     private _isScrollStart;
     private _isScrollEnd;
+    protected _precalculatedScrollStartOffset: import("@angular/core").WritableSignal<number>;
+    protected _precalculatedScrollEndOffset: import("@angular/core").WritableSignal<number>;
+    protected _actualScrollStartOffset: import("@angular/core").WritableSignal<number>;
+    protected _actualScrollEndOffset: import("@angular/core").WritableSignal<number>;
+    protected _actualSnapScrollToStart: Signal<boolean>;
+    protected _actualSnapScrollToEnd: Signal<boolean>;
+    protected _alignmentScrollStartOffset: import("@angular/core").WritableSignal<number>;
+    protected _alignmentScrollEndOffset: import("@angular/core").WritableSignal<number>;
     private _resizeSnappedComponentHandler;
     private _resizeSnappedObserver;
     private focusItem;
@@ -366,7 +500,6 @@ export declare class NgVirtualListComponent implements OnDestroy {
     protected readonly $preventScrollSnapping: import("rxjs").Observable<boolean>;
     private _destroyRef;
     private _updateId;
-    private _scrollStateUpdateIndex;
     private _readyForShow;
     private _cached;
     private _isLoading;
@@ -376,7 +509,6 @@ export declare class NgVirtualListComponent implements OnDestroy {
     private readonly $viewInit;
     private _$destroy;
     private readonly $destroy;
-    protected getScrollStateVersion(totalSize: number, scrollSize: number, cacheVersion: number): string;
     constructor();
     ngAfterViewInit(): void;
     private onAfterResize;
@@ -384,9 +516,12 @@ export declare class NgVirtualListComponent implements OnDestroy {
     private snappingHandler;
     private emitScrollEvent;
     private getIsSnappingMethodAdvanced;
-    private getIsNotSelecting;
-    private getIsSingleSelecting;
-    private getIsMultiSelecting;
+    private getIsNoneSelection;
+    private getIsSingleSelection;
+    private getIsMultiSelection;
+    private getIsNoneCollapse;
+    private getIsMultipleCollapse;
+    private getIsAccordionCollapse;
     private getIsVertical;
     private getIsLazy;
     private createDisplayComponentsIfNeed;
@@ -439,5 +574,5 @@ export declare class NgVirtualListComponent implements OnDestroy {
     ngOnDestroy(): void;
     private dispose;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgVirtualListComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<NgVirtualListComponent, "ng-virtual-list", never, { "scrollbarThickness": { "alias": "scrollbarThickness"; "required": false; "isSignal": true; }; "scrollbarMinSize": { "alias": "scrollbarMinSize"; "required": false; "isSignal": true; }; "scrollbarThumbRenderer": { "alias": "scrollbarThumbRenderer"; "required": false; "isSignal": true; }; "scrollbarThumbParams": { "alias": "scrollbarThumbParams"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "waitForPreparation": { "alias": "waitForPreparation"; "required": false; "isSignal": true; }; "clickDistance": { "alias": "clickDistance"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; "isSignal": true; }; "defaultItemValue": { "alias": "defaultItemValue"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "collapsedIds": { "alias": "collapsedIds"; "required": false; "isSignal": true; }; "selectByClick": { "alias": "selectByClick"; "required": false; "isSignal": true; }; "collapseByClick": { "alias": "collapseByClick"; "required": false; "isSignal": true; }; "snap": { "alias": "snap"; "required": false; "isSignal": true; }; "snapToEndTransitionInstantOffset": { "alias": "snapToEndTransitionInstantOffset"; "required": false; "isSignal": true; }; "scrollStartOffset": { "alias": "scrollStartOffset"; "required": false; "isSignal": true; }; "scrollEndOffset": { "alias": "scrollEndOffset"; "required": false; "isSignal": true; }; "snapScrollToStart": { "alias": "snapScrollToStart"; "required": false; "isSignal": true; }; "snapScrollToEnd": { "alias": "snapScrollToEnd"; "required": false; "isSignal": true; }; "snapScrollToBottom": { "alias": "snapScrollToBottom"; "required": false; "isSignal": true; }; "scrollbarEnabled": { "alias": "scrollbarEnabled"; "required": false; "isSignal": true; }; "scrollbarInteractive": { "alias": "scrollbarInteractive"; "required": false; "isSignal": true; }; "scrollBehavior": { "alias": "scrollBehavior"; "required": false; "isSignal": true; }; "scrollingSettings": { "alias": "scrollingSettings"; "required": false; "isSignal": true; }; "animationParams": { "alias": "animationParams"; "required": false; "isSignal": true; }; "overscrollEnabled": { "alias": "overscrollEnabled"; "required": false; "isSignal": true; }; "enabledBufferOptimization": { "alias": "enabledBufferOptimization"; "required": false; "isSignal": true; }; "itemRenderer": { "alias": "itemRenderer"; "required": true; "isSignal": true; }; "itemConfigMap": { "alias": "itemConfigMap"; "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; }; "collectionMode": { "alias": "collectionMode"; "required": false; "isSignal": true; }; "bufferSize": { "alias": "bufferSize"; "required": false; "isSignal": true; }; "maxBufferSize": { "alias": "maxBufferSize"; "required": false; "isSignal": true; }; "snappingMethod": { "alias": "snappingMethod"; "required": false; "isSignal": true; }; "methodForSelecting": { "alias": "methodForSelecting"; "required": false; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; "screenReaderMessage": { "alias": "screenReaderMessage"; "required": false; "isSignal": true; }; "langTextDir": { "alias": "langTextDir"; "required": false; "isSignal": true; }; }, { "onScroll": "onScroll"; "onScrollEnd": "onScrollEnd"; "onViewportChange": "onViewportChange"; "onItemClick": "onItemClick"; "onSelect": "onSelect"; "onCollapse": "onCollapse"; "onScrollReachStart": "onScrollReachStart"; "onScrollReachEnd": "onScrollReachEnd"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NgVirtualListComponent, "ng-virtual-list", never, { "scrollbarThickness": { "alias": "scrollbarThickness"; "required": false; "isSignal": true; }; "scrollbarMinSize": { "alias": "scrollbarMinSize"; "required": false; "isSignal": true; }; "scrollbarThumbRenderer": { "alias": "scrollbarThumbRenderer"; "required": false; "isSignal": true; }; "scrollbarThumbParams": { "alias": "scrollbarThumbParams"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "waitForPreparation": { "alias": "waitForPreparation"; "required": false; "isSignal": true; }; "clickDistance": { "alias": "clickDistance"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": true; "isSignal": true; }; "defaultItemValue": { "alias": "defaultItemValue"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "collapsedIds": { "alias": "collapsedIds"; "required": false; "isSignal": true; }; "selectByClick": { "alias": "selectByClick"; "required": false; "isSignal": true; }; "collapseByClick": { "alias": "collapseByClick"; "required": false; "isSignal": true; }; "snap": { "alias": "snap"; "required": false; "isSignal": true; }; "stickyEnabled": { "alias": "stickyEnabled"; "required": false; "isSignal": true; }; "snapToEndTransitionInstantOffset": { "alias": "snapToEndTransitionInstantOffset"; "required": false; "isSignal": true; }; "scrollStartOffset": { "alias": "scrollStartOffset"; "required": false; "isSignal": true; }; "scrollEndOffset": { "alias": "scrollEndOffset"; "required": false; "isSignal": true; }; "snapScrollToStart": { "alias": "snapScrollToStart"; "required": false; "isSignal": true; }; "snapScrollToEnd": { "alias": "snapScrollToEnd"; "required": false; "isSignal": true; }; "snapScrollToBottom": { "alias": "snapScrollToBottom"; "required": false; "isSignal": true; }; "scrollbarEnabled": { "alias": "scrollbarEnabled"; "required": false; "isSignal": true; }; "scrollbarInteractive": { "alias": "scrollbarInteractive"; "required": false; "isSignal": true; }; "overlappingScrollbar": { "alias": "overlappingScrollbar"; "required": false; "isSignal": true; }; "scrollBehavior": { "alias": "scrollBehavior"; "required": false; "isSignal": true; }; "scrollingSettings": { "alias": "scrollingSettings"; "required": false; "isSignal": true; }; "itemTransform": { "alias": "itemTransform"; "required": false; "isSignal": true; }; "snapToItem": { "alias": "snapToItem"; "required": false; "isSignal": true; }; "snapToItemAlign": { "alias": "snapToItemAlign"; "required": false; "isSignal": true; }; "snappingDistance": { "alias": "snappingDistance"; "required": false; "isSignal": true; }; "scrollingOneByOne": { "alias": "scrollingOneByOne"; "required": false; "isSignal": true; }; "alignment": { "alias": "alignment"; "required": false; "isSignal": true; }; "zIndexWhenSelecting": { "alias": "zIndexWhenSelecting"; "required": false; "isSignal": true; }; "spreadingMode": { "alias": "spreadingMode"; "required": false; "isSignal": true; }; "divides": { "alias": "divides"; "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; }; "animationParams": { "alias": "animationParams"; "required": false; "isSignal": true; }; "overscrollEnabled": { "alias": "overscrollEnabled"; "required": false; "isSignal": true; }; "enabledBufferOptimization": { "alias": "enabledBufferOptimization"; "required": false; "isSignal": true; }; "itemRenderer": { "alias": "itemRenderer"; "required": true; "isSignal": true; }; "itemConfigMap": { "alias": "itemConfigMap"; "required": false; "isSignal": true; }; "itemSize": { "alias": "itemSize"; "required": false; "isSignal": true; }; "minItemSize": { "alias": "minItemSize"; "required": false; "isSignal": true; }; "maxItemSize": { "alias": "maxItemSize"; "required": false; "isSignal": true; }; "dynamicSize": { "alias": "dynamicSize"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "collectionMode": { "alias": "collectionMode"; "required": false; "isSignal": true; }; "bufferSize": { "alias": "bufferSize"; "required": false; "isSignal": true; }; "maxBufferSize": { "alias": "maxBufferSize"; "required": false; "isSignal": true; }; "snappingMethod": { "alias": "snappingMethod"; "required": false; "isSignal": true; }; "collapsingMode": { "alias": "collapsingMode"; "required": false; "isSignal": true; }; "methodForSelecting": { "alias": "methodForSelecting"; "required": false; "isSignal": true; }; "selectingMode": { "alias": "selectingMode"; "required": false; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; "screenReaderMessage": { "alias": "screenReaderMessage"; "required": false; "isSignal": true; }; "langTextDir": { "alias": "langTextDir"; "required": false; "isSignal": true; }; }, { "onScroll": "onScroll"; "onScrollEnd": "onScrollEnd"; "onViewportChange": "onViewportChange"; "onSnapItem": "onSnapItem"; "onItemClick": "onItemClick"; "onSelect": "onSelect"; "onCollapse": "onCollapse"; "onScrollReachStart": "onScrollReachStart"; "onScrollReachEnd": "onScrollReachEnd"; }, never, never, false, never>;
 }

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

@@ -1,9 +1,9 @@
 import { TrackBox } from './core/track-box';
-import { IRenderVirtualListItem, IVirtualListItem } from './models';
-import { IAnimationParams, IScrollOptions, ISize } from './interfaces';
+import { IRenderVirtualListItem, IVirtualListCollection, IVirtualListItem, IVirtualListItemConfigMap } from './models';
+import { IAnimationParams, IRect, IScrollOptions, ISize } from './interfaces';
 import { IRenderVirtualListCollection } from './models/render-collection.model';
-import { TextDirection } from './enums';
-import { MethodsForSelectingTypes } from './enums/method-for-selecting-types';
+import { TextDirection } from './types';
+import { SelectingModesTypes } from './enums/selecting-modes-types';
 import { FocusAlignment, Id } from './types';
 import { FocusItemParams } from './types/focus-item-params';
 import { IScrollToParams } from './interfaces/scroll-to-params';
@@ -20,17 +20,18 @@ export declare class NgVirtualListService {
     private _id;
     get id(): number;
     private _nextComponentId;
-    private _$itemClick;
-    $itemClick: import("rxjs").Observable<IRenderVirtualListItem<any> | null>;
+    private _$virtualClick;
+    $virtualClick: import("rxjs").Observable<IRenderVirtualListItem<any> | null>;
     private _$selectedIds;
     $selectedIds: import("rxjs").Observable<Id | Id[] | null>;
     private _$collapsedIds;
     $collapsedIds: import("rxjs").Observable<Id[]>;
-    private _$methodOfSelecting;
-    $methodOfSelecting: import("rxjs").Observable<MethodsForSelectingTypes>;
-    set methodOfSelecting(v: MethodsForSelectingTypes);
+    private _$selectingMode;
+    $selectingMode: import("rxjs").Observable<SelectingModesTypes>;
+    set selectingMode(v: SelectingModesTypes);
     private _$focusedId;
     $focusedId: import("rxjs").Observable<Id | null>;
+    set focusedId(v: Id | null);
     get focusedId(): Id | null;
     private _$focusItem;
     readonly $focusItem: import("rxjs").Observable<FocusItemParams>;
@@ -48,16 +49,25 @@ export declare class NgVirtualListService {
     lastFocusedItemId: number;
     scrollStartOffset: number;
     scrollEndOffset: number;
+    zIndexWhenSelecting: string | null;
     selectByClick: boolean;
     collapseByClick: boolean;
     defaultItemValue: IVirtualListItem | null;
+    snapToItem: boolean;
+    isInfinity: boolean;
     isVertical: boolean;
     dynamic: boolean;
+    itemSize: number;
     snapScrollToStart: boolean;
     snapScrollToEnd: boolean;
     animationParams: IAnimationParams;
+    isNoneCollapse: boolean;
+    isMultipleCollapse: boolean;
+    isAccordionCollapse: boolean;
     private _trackBox;
     listElement: HTMLDivElement | null;
+    items: IVirtualListCollection;
+    itemConfigMap: IVirtualListItemConfigMap;
     private _$displayItems;
     readonly $displayItems: import("rxjs").Observable<IRenderVirtualListCollection>;
     get displayItems(): IRenderVirtualListCollection;
@@ -74,6 +84,8 @@ export declare class NgVirtualListService {
     set scrollBarSize(v: number);
     private _$scrollBarSize;
     readonly $scrollBarSize: import("rxjs").Observable<number>;
+    private _$intersectionElementBySnapToItemAlign;
+    readonly $intersectionElementBySnapToItemAlign: import("rxjs").Observable<Id | null>;
     private _$clickDistance;
     readonly $clickDistance: import("rxjs").Observable<number>;
     get clickDistance(): number;
@@ -86,8 +98,8 @@ export declare class NgVirtualListService {
     set collapsedIds(ids: Array<Id>);
     get collapsedIds(): Array<Id>;
     constructor();
-    itemClick(data: IRenderVirtualListItem | null): void;
-    update(immediately?: boolean, force?: boolean): void;
+    virtualClick(data: IRenderVirtualListItem | null): void;
+    update(immediately?: boolean): void;
     private getItemConfig;
     /**
      * Selects a list item
@@ -111,10 +123,16 @@ export declare class NgVirtualListService {
      */
     focusById(id: Id, align?: FocusAlignment, scrollBehavior?: ScrollBehavior): void;
     focus(element: HTMLElement, align?: FocusAlignment, behavior?: ScrollBehavior): boolean;
+    focusList(): void;
     focusFirstElement(): void;
-    areaFocus(id: Id | null): void;
     initialize(id: number, trackBox: TrackBox): void;
     generateComponentId(): number;
+    getComponentBoundsByIntersectionPosition(position: number, maxPosition?: number | null): (IRect & {
+        id: Id | null;
+        isFirst: boolean;
+        isLast: boolean;
+    }) | null;
+    setIntersectionElementBySnapToItemAlign(id: Id | null): void;
     /**
       * The method scrolls the list to the element with the given `id` and returns the value of the scrolled area.
       */

package/lib/transformations/deck-of-cards-3d.d.ts

@@ -0,0 +1,54 @@
+import { Color, ItemTransform } from '../types';
+export interface IDeckOfCards3DOptions {
+    /**
+     * Depth Of Field. Default value is `null`.
+     */
+    dof?: number;
+    /**
+     * Fog color. Default value is `null`.
+     */
+    fogColor?: Color;
+    /**
+     * Fog weight. Default value is `null`.
+     */
+    fogWeight?: number;
+    /**
+     * Spacing between items. Default value is `0.5`.
+     */
+    spacingBetweenItems?: number;
+    /**
+     * Angle of inclination. Default value is `1`.
+     */
+    angle?: number;
+    /**
+     * Depth. Default value is `0.15`.
+     */
+    depth?: number;
+    /**
+     * Scale. Default value is `0.15`.
+     */
+    scale?: number;
+    /**
+     * Scale X. Default value is `null`.
+     */
+    scaleX?: number | null;
+    /**
+     * Scale Y. Default value is `null`.
+     */
+    scaleY?: number | null;
+    /**
+     * Depth exponent. Default value is `4`.
+     */
+    depthPow?: number;
+    /**
+     * Sinusoidal distribution. Default value is `false`.
+     */
+    sineWave?: boolean;
+}
+/**
+ * deckOfCards3D
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/transformations/deck-of-cards-3d.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export declare const deckOfCards3D: (options?: IDeckOfCards3DOptions) => ItemTransform;

package/lib/transformations/deck-of-cards.d.ts

@@ -0,0 +1,50 @@
+import { Color, ItemTransform } from '../types';
+export interface IDeckOfCardsOptions {
+    /**
+     * Depth Of Field. Default value is `null`.
+     */
+    dof?: number;
+    /**
+     * Fog color. Default value is `null`.
+     */
+    fogColor?: Color;
+    /**
+     * Fog weight. Default value is `null`.
+     */
+    fogWeight?: number;
+    /**
+     * Spacing between items. Default value is `0.5`.
+     */
+    spacingBetweenItems?: number;
+    /**
+     * Depth. Default value is `0.15`.
+     */
+    depth?: number;
+    /**
+     * Scale. Default value is `0.15`.
+     */
+    scale?: number;
+    /**
+     * Scale X. Default value is `null`.
+     */
+    scaleX?: number | null;
+    /**
+     * Scale Y. Default value is `null`.
+     */
+    scaleY?: number | null;
+    /**
+     * Depth exponent. Default value is `4`.
+     */
+    depthPow?: number;
+    /**
+     * Sinusoidal distribution. Default value is `false`.
+     */
+    sineWave?: boolean;
+}
+/**
+ * deckOfCards
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/transformations/deck-of-cards.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export declare const deckOfCards: (options?: IDeckOfCardsOptions) => ItemTransform;

package/lib/transformations/event-horizon.d.ts

@@ -0,0 +1,26 @@
+import { Color, ItemTransform } from '../types';
+export interface IEventHorizonOptions {
+    /**
+     * Depth Of Field. Default value is `null`.
+     */
+    dof?: number;
+    /**
+     * Fog color. Default value is `null`.
+     */
+    fogColor?: Color;
+    /**
+     * Fog weight. Default value is `null`.
+     */
+    fogWeight?: number;
+    /**
+     * Spacing between items. Default value is `0.5`.
+     */
+    spacingBetweenItems?: number;
+}
+/**
+ * eventHorizon
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/transformations/event-horizon.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export declare const eventHorizon: (options?: IEventHorizonOptions) => ItemTransform;

package/lib/transformations/index.d.ts

@@ -0,0 +1,7 @@
+export declare const ItemTransformations: {
+    EVENT_HORIZON: (options?: import("./event-horizon").IEventHorizonOptions) => import("ng-virtual-list").ItemTransform;
+    LINEAR: (options?: import("./linear").ILintearOptions) => import("ng-virtual-list").ItemTransform;
+    DECK_OF_CARDS: (options?: import("./deck-of-cards").IDeckOfCardsOptions) => import("ng-virtual-list").ItemTransform;
+    DECK_OF_CARDS_3D: (options?: import("./deck-of-cards-3d").IDeckOfCards3DOptions) => import("ng-virtual-list").ItemTransform;
+    SWIPE_3D: (options?: import("./swipe-3d").ISwipe3DOptions) => import("ng-virtual-list").ItemTransform;
+};

package/lib/transformations/linear.d.ts

@@ -0,0 +1,26 @@
+import { Color, ItemTransform } from '../types';
+export interface ILintearOptions {
+    /**
+     * Depth Of Field. Default value is `null`.
+     */
+    dof?: number;
+    /**
+     * Fog color. Default value is `null`.
+     */
+    fogColor?: Color;
+    /**
+     * Fog weight. Default value is `null`.
+     */
+    fogWeight?: number;
+    /**
+     * Spacing between items. Default value is `0.5`.
+     */
+    spacingBetweenItems?: number;
+}
+/**
+ * linear
+ * @link https://github.com/DjonnyX/ng-virtual-list/blob/19.x/projects/ng-virtual-list/src/lib/transformations/linear.ts
+ * @author Evgenii Alexandrovich Grebennikov
+ * @email djonnyx@gmail.com
+ */
+export declare const linear: (options?: ILintearOptions) => ItemTransform;