vevet 3.19.2 → 4.0.0-beta.0

package/lib/types/components/CustomCursor/types.d.ts

@@ -1,81 +1,121 @@
 import { NComponent } from '../../base/Component/types';
 export declare namespace NCustomCursor {
+    /**
+     * Static properties that do not change after initialization.
+     */
     interface IStaticProps extends NComponent.IStaticProps {
         /**
-         * Cursor parent element
+         * The container where the custom cursor will be active.
+         * Can be the `window`, a specific DOM element, or a string selector.
          * @default window
          */
         container: Window | Element | string;
         /**
-         * If need to hide the native cursor
+         * Determines whether the native cursor should be hidden.
          * @default false
          */
         isNativeCursorHidden?: boolean;
     }
+    /**
+     * Changeable properties that can be updated dynamically during the lifecycle of the custom cursor.
+     */
     interface IChangeableProps extends NComponent.IChangeableProps {
         /**
-         * Custom cursor is enabled
+         * Enables or disables the custom cursor.
          * @default true
          */
         isEnabled?: boolean;
         /**
+         * The width of the custom cursor.
          * @default 50
          */
         width?: number;
         /**
+         * The height of the custom cursor.
          * @default 50
          */
         height?: number;
         /**
-         * Coords linear interpolation
+         * Linear interpolation factor for smooth cursor movement.
+         * A value between `0` and `1` where higher values result in faster movement.
          * @default 0.2
          */
         lerp?: number;
         /**
-         * On different screens with different FPS, animation may be slower or faster.
-         * This property is to normalize animation speed across different screens.
+         * Normalizes the animation speed across different screens with varying FPS.
+         * Ensures consistent movement speed across different devices.
          * @default true
          */
         isFpsNormalized?: boolean;
         /**
-         * Automatically stop rendering after the target and current values are approximated.
+         * Automatically stops rendering the cursor once the target coordinates and size
+         * approximate the current ones closely enough.
          * @default true
          */
         shouldAutoStop?: boolean;
     }
+    /**
+     * Types of callbacks available for the custom cursor component.
+     */
     interface ICallbacksTypes extends NComponent.ICallbacksTypes {
+        /**
+         * Triggered when the custom cursor is created.
+         * Provides access to the outer and inner HTML elements of the cursor.
+         */
         create: {
             outerElement: HTMLElement;
             innerElement: HTMLElement;
         };
+        /**
+         * Triggered on each render to update the cursor's position.
+         * Provides the current x and y coordinates.
+         */
         render: IVector2;
     }
+    /**
+     * Represents 2D vector coordinates for cursor position (x, y).
+     */
     interface IVector2 {
         x: number;
         y: number;
     }
+    /**
+     * Describes the cursor’s coordinates and size for rendering.
+     */
     interface ICoords {
         x: number;
         y: number;
         width: number;
         height: number;
     }
+    /**
+     * Information about the hovered element, which can affect cursor behavior.
+     */
     interface IHoveredElement {
-        /** Hovered element */
+        /**
+         * The element currently being hovered over.
+         */
         element: Element;
-        /** Hover ist sticky */
+        /**
+         * Whether the hover state should "stick" to the element,
+         * meaning the cursor remains over the element even after moving away.
+         */
         isSticky?: boolean;
         /**
-         * Target cursor width
+         * The target width of the cursor when hovering over this element.
+         * Can be set to a specific number, `false` (no change), or `auto`.
          * @default 'auto'
          */
         width?: false | number | 'auto';
         /**
-         * Target cursor height
+         * The target height of the cursor when hovering over this element.
+         * Can be set to a specific number, `false` (no change), or `auto`.
          * @default 'auto'
          */
         height?: false | number | 'auto';
-        /** Target cursor padding */
+        /**
+         * Padding around the cursor when hovering over this element.
+         */
         padding?: number;
     }
 }

package/lib/types/components/CustomCursor/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/CustomCursor/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,yBAAiB,aAAa,CAAC;IAC7B,UAAiB,YAAa,SAAQ,UAAU,CAAC,YAAY;QAC3D;;;WAGG;QACH,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;QACrC;;;WAGG;QACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC;IAED,UAAiB,gBAAiB,SAAQ,UAAU,CAAC,gBAAgB;QACnE;;;WAGG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd;;;;WAIG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B;;;WAGG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B;IAED,UAAiB,eAAgB,SAAQ,UAAU,CAAC,eAAe;QACjE,MAAM,EAAE;YACN,YAAY,EAAE,WAAW,CAAC;YAC1B,YAAY,EAAE,WAAW,CAAC;SAC3B,CAAC;QACF,MAAM,EAAE,QAAQ,CAAC;KAClB;IAED,UAAiB,QAAQ;QACvB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX;IAED,UAAiB,OAAO;QACtB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB;IAED,UAAiB,eAAe;QAC9B,sBAAsB;QACtB,OAAO,EAAE,OAAO,CAAC;QACjB,uBAAuB;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB;;;WAGG;QACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;QAChC;;;WAGG;QACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;QACjC,4BAA4B;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/CustomCursor/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,yBAAiB,aAAa,CAAC;IAC7B;;OAEG;IACH,UAAiB,YAAa,SAAQ,UAAU,CAAC,YAAY;QAC3D;;;;WAIG;QACH,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;QAErC;;;WAGG;QACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC;IAED;;OAEG;IACH,UAAiB,gBAAiB,SAAQ,UAAU,CAAC,gBAAgB;QACnE;;;WAGG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;QAEpB;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;;WAGG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;;;WAIG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;;;WAIG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;QAE1B;;;;WAIG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B;IAED;;OAEG;IACH,UAAiB,eAAgB,SAAQ,UAAU,CAAC,eAAe;QACjE;;;WAGG;QACH,MAAM,EAAE;YACN,YAAY,EAAE,WAAW,CAAC;YAC1B,YAAY,EAAE,WAAW,CAAC;SAC3B,CAAC;QAEF;;;WAGG;QACH,MAAM,EAAE,QAAQ,CAAC;KAClB;IAED;;OAEG;IACH,UAAiB,QAAQ;QACvB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX;IAED;;OAEG;IACH,UAAiB,OAAO;QACtB,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB;IAED;;OAEG;IACH,UAAiB,eAAe;QAC9B;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;;WAGG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB;;;;WAIG;QACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;QAEhC;;;;WAIG;QACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;QAEjC;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF"}

package/lib/types/components/{SmoothScroll → CustomScroll}/AnimatonFrame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimatonFrame.d.ts","sourceRoot":"","sources":["../../../../src/components/SmoothScroll/AnimatonFrame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG1E,UAAU,MAAM;IACd,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,GAAG,EAAE,mBAAmB,GAAG,KAAK,CAAC;CAClC;AAED,qBAAa,cAAc;IAkBb,OAAO,CAAC,MAAM;IAjB1B,4BAA4B;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAsB;IAEnC,OAAO,CAAC,MAAM,CAAC,CAA4B;IAE3C,OAAO,KAAK,GAAG,GAEd;IAED,IAAI,IAAI,WAEP;IAED,OAAO,KAAK,KAAK,GAEhB;gBAEmB,MAAM,EAAE,MAAM;IAE3B,MAAM;IAwBb,wBAAwB;IACjB,OAAO;IAOP,OAAO;CAKf"}
+{"version":3,"file":"AnimatonFrame.d.ts","sourceRoot":"","sources":["../../../../src/components/CustomScroll/AnimatonFrame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG1E,UAAU,MAAM;IACd,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,GAAG,EAAE,mBAAmB,GAAG,KAAK,CAAC;CAClC;AAED,qBAAa,cAAc;IAkBb,OAAO,CAAC,MAAM;IAjB1B,4BAA4B;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAsB;IAEnC,OAAO,CAAC,MAAM,CAAC,CAA4B;IAE3C,OAAO,KAAK,GAAG,GAEd;IAED,IAAI,IAAI,WAEP;IAED,OAAO,KAAK,KAAK,GAEhB;gBAEmB,MAAM,EAAE,MAAM;IAE3B,MAAM;IAwBb,wBAAwB;IACjB,OAAO;IAOP,OAAO;CAKf"}

package/lib/types/components/{SmoothScroll → CustomScroll}/Elements.d.ts

@@ -1,6 +1,6 @@
-import { NSmoothScroll } from './types';
+import { NCustomScroll } from './types';
 type TPickedProps = 'elements' | 'hasWillChange' | 'translatePrecision';
-interface IProps extends Required<Pick<NSmoothScroll.IStaticProps, TPickedProps>> {
+interface IProps extends Required<Pick<NCustomScroll.IStaticProps, TPickedProps>> {
     container: Element;
     wrapperClassName: string;
 }
@@ -10,7 +10,7 @@ export declare class Elements {
     get wrapper(): HTMLElement;
     private _wrapperExists;
     private _elements;
-    get elements(): NSmoothScroll.IElement[];
+    get elements(): NCustomScroll.IElement[];
     get props(): IProps;
     constructor(_props: IProps);
     /** Create scrollable wrapper */

package/lib/types/components/{SmoothScroll → CustomScroll}/Elements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Elements.d.ts","sourceRoot":"","sources":["../../../../src/components/SmoothScroll/Elements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,KAAK,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAExE,UAAU,MACR,SAAQ,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAChE,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,QAAQ;IAmBP,OAAO,CAAC,MAAM;IAlB1B,OAAO,CAAC,QAAQ,CAAe;IAE/B,IAAI,OAAO,gBAEV;IAED,OAAO,CAAC,cAAc,CAAW;IAEjC,OAAO,CAAC,SAAS,CAA4B;IAE7C,IAAI,QAAQ,6BAEX;IAED,IAAI,KAAK,WAER;gBAEmB,MAAM,EAAE,MAAM;IAKlC,gCAAgC;IAChC,OAAO,CAAC,cAAc;IAqBtB,iCAAiC;IACjC,OAAO,CAAC,eAAe;IAqBvB,kCAAkC;IAC3B,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAgBxD,OAAO,CAAC,WAAW;IAUnB,sBAAsB;IACf,MAAM;IAWb,8CAA8C;IACvC,UAAU;IAUV,OAAO;CAkBf"}
+{"version":3,"file":"Elements.d.ts","sourceRoot":"","sources":["../../../../src/components/CustomScroll/Elements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,KAAK,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAExE,UAAU,MACR,SAAQ,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAChE,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,QAAQ;IAmBP,OAAO,CAAC,MAAM;IAlB1B,OAAO,CAAC,QAAQ,CAAe;IAE/B,IAAI,OAAO,gBAEV;IAED,OAAO,CAAC,cAAc,CAAW;IAEjC,OAAO,CAAC,SAAS,CAA4B;IAE7C,IAAI,QAAQ,6BAEX;IAED,IAAI,KAAK,WAER;gBAEmB,MAAM,EAAE,MAAM;IAKlC,gCAAgC;IAChC,OAAO,CAAC,cAAc;IAqBtB,iCAAiC;IACjC,OAAO,CAAC,eAAe;IAqBvB,kCAAkC;IAC3B,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAgBxD,OAAO,CAAC,WAAW;IAUnB,sBAAsB;IACf,MAAM;IAWb,8CAA8C;IACvC,UAAU;IAUV,OAAO;CAkBf"}

package/lib/types/components/{SmoothScroll → CustomScroll}/index.d.ts

@@ -1,14 +1,17 @@
 /// <reference types="node" />
 import { Component as ComponentClass } from '../../base/Component';
-import { NSmoothScroll } from './types';
+import { NCustomScroll } from './types';
 import { IScrollLike } from '../../types/general';
 import { Elements } from './Elements';
 import { AnimationFrame } from './AnimatonFrame';
-export type { NSmoothScroll };
+export type { NCustomScroll };
 /**
- * Smooth scrolling
+ * Custom smooth scrolling component that replaces native scrolling behavior.
+ * It provides smooth interpolation, custom scroll events, and integration with other elements.
+ *
+ * @requires Requires styles: `@import '~vevet/lib/styles/components/CustomScroll';`
  */
-export declare class SmoothScroll<StaticProps extends NSmoothScroll.IStaticProps = NSmoothScroll.IStaticProps, ChangeableProps extends NSmoothScroll.IChangeableProps = NSmoothScroll.IChangeableProps, CallbacksTypes extends NSmoothScroll.ICallbacksTypes = NSmoothScroll.ICallbacksTypes> extends ComponentClass<StaticProps, ChangeableProps, CallbacksTypes> implements IScrollLike {
+export declare class CustomScroll<StaticProps extends NCustomScroll.IStaticProps = NCustomScroll.IStaticProps, ChangeableProps extends NCustomScroll.IChangeableProps = NCustomScroll.IChangeableProps, CallbacksTypes extends NCustomScroll.ICallbacksTypes = NCustomScroll.ICallbacksTypes> extends ComponentClass<StaticProps, ChangeableProps, CallbacksTypes> implements IScrollLike {
     protected _getDefaultProps(): {
         container: string;
         elements: boolean;
@@ -19,6 +22,7 @@ export declare class SmoothScroll<StaticProps extends NSmoothScroll.IStaticProps
         translatePrecision: number;
         isEnabled: boolean;
         hasWheel: boolean;
+        wheelSpeed: number;
         direction: string;
         isInversedHandlerDirection: boolean;
         shouldAutoStop: boolean;
@@ -28,79 +32,89 @@ export declare class SmoothScroll<StaticProps extends NSmoothScroll.IStaticProps
         lerpApproximation: number;
     };
     get prefix(): string;
-    /** Scroll container */
+    /** Scroll container element */
     protected _container: HTMLElement;
-    /** Scroll container */
+    /** Scroll container element */
     get container(): HTMLElement;
+    /**
+     * Internal handler for the scroll elements
+     * @ignore
+     */
     protected _elements: Elements;
     /**
-     * Scroll wrapper. If the element does not exist indide the `container`,
-     * it will be created automatically
+     * Scroll wrapper. If the element does not exist indide the `container`, it will be created automatically
      */
     get wrapper(): HTMLElement;
-    /** `scrollLeft` target value */
+    /** The `scrollLeft` target value */
     protected _targetLeft: number;
-    /** `scrollLeft` target value */
+    /** The `scrollLeft` target value */
     get targetLeft(): number;
     set targetLeft(value: number);
     /** Update `targetLeft` without animation */
     protected setTargetLeft(value: number): void;
-    /** `scrollTop` target value */
+    /** The `scrollTop` target value */
     protected _targetTop: number;
-    /** `scrollTop` target value */
+    /** The `scrollTop` target value */
     get targetTop(): number;
     set targetTop(value: number);
     /** Update `targetTop` without animation */
     protected setTargetTop(value: number): void;
-    /** `scrollLeft` */
+    /** The current `scrollLeft` value */
     protected _scrollLeft: number;
-    /** `scrollLeft` */
+    /** The current `scrollLeft` value */
     get scrollLeft(): number;
     set scrollLeft(value: number);
-    /** `scrollTop` */
+    /** The current `scrollTop` value */
     protected _scrollTop: number;
-    /** `scrollTop` */
+    /** The current `scrollTop` value */
     get scrollTop(): number;
     set scrollTop(value: number);
-    /** Scroll width */
+    /** The scroll width of the container */
     protected _scrollWidth: number;
-    /** Scroll width */
+    /** The scroll width of the container */
     get scrollWidth(): number;
-    /** Scroll height */
+    /** The scroll height of the container */
     protected _scrollHeight: number;
-    /** Scroll height */
+    /** The scroll width of the container */
     get scrollHeight(): number;
-    /** Container width */
+    /** The container width */
     protected _clientWidth: number;
-    /** Container width */
+    /** The container width */
     get clientWidth(): number;
-    /** Container height */
+    /** The container height */
     protected _clientHeight: number;
-    /** Container height */
+    /** The container height */
     get clientHeight(): number;
-    /** Wrapper width */
+    /** The wrapper width */
     protected _wrapperWidth: number;
-    /** Wrapper height */
+    /** The wrapper height */
     protected _wrapperHeight: number;
     /** Maximum scrollable area of the X axis */
     get maxScrollableWidth(): number;
     /** Maximum scrollable area of the Y axis */
     get maxScrollableHeight(): number;
-    /** Has scroll */
+    /** The container has scroll */
     get hasScroll(): boolean;
     /** If the approximation between the target and current scroll values must be instantaneous */
     protected _isInstant?: boolean;
-    /** Animation frame */
+    /**
+     * Animation frame
+     * @ignore
+     */
     protected _raf: AnimationFrame;
     /** Frame index */
     protected _frameIndex: number;
-    /** Equal lerp for all elements */
+    /** Use equal lerp for all elements */
     protected _isEqualLerp: boolean;
-    /** `_disable` timeout */
+    /** Disable timeout */
     protected _disableDelayDebounce?: NodeJS.Timeout;
-    get isSmoothScroll(): boolean;
+    /** If the component is a custom scroll */
+    get isCustomScroll(): boolean;
     constructor(initialProps?: StaticProps & ChangeableProps, canInit?: boolean);
     protected _init(): void;
+    /**
+     * Sets the class names for the elements.
+     */
     protected _setClassNames(isActive: boolean): void;
     /** Set events */
     protected _setEvents(): void;
@@ -135,7 +149,7 @@ export declare class SmoothScroll<StaticProps extends NSmoothScroll.IStaticProps
     /** Interpolate values */
     protected _lerp(current: number, target: number, ease?: number): number;
     /** Get lerp */
-    protected _getLerp(element?: NSmoothScroll.IElement): number;
+    protected _getLerp(element?: NCustomScroll.IElement): number;
     /** Scroll to */
     scrollTo({ top, left, behavior }: ScrollToOptions): void;
     /** Destroy the module */

package/lib/types/components/CustomScroll/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/CustomScroll/index.ts"],"names":[],"mappings":"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"}

package/lib/types/components/CustomScroll/types.d.ts

@@ -0,0 +1,137 @@
+import { NComponent } from '../../base/Component/types';
+import { AnimationFrame } from '../AnimationFrame';
+import { TOnResizeTarget } from '../../utils/listeners/onResize';
+export declare namespace NCustomScroll {
+    interface IStaticProps extends NComponent.IStaticProps {
+        /**
+         * Selector or HTMLElement for the scrollable container.
+         * @default '#v-custom-scroll'
+         */
+        container?: string | HTMLElement;
+        /**
+         * Defines the scrollable elements inside the wrapper. Can be a selector, a list of elements, or a single element.
+         * If set to `false`, no specific elements are defined.
+         * @default false
+         */
+        elements?: false | string | NodeListOf<HTMLElement> | HTMLElement | HTMLElement[];
+        /**
+         * Optional `AnimationFrame` instance to control scrolling animation externally.
+         * @default false
+         */
+        animationFrame?: false | AnimationFrame;
+        /**
+         * Target for the viewport resize event.
+         * @default 'any'
+         */
+        viewportTarget?: TOnResizeTarget;
+        /**
+         * Timeout value for the resize event, useful for debouncing resize calculations.
+         * @default 0
+         */
+        resizeDebounce?: number;
+        /**
+         * If `true`, the `will-change` CSS property will be applied to the scrollable elements to improve performance.
+         * @default true
+         */
+        hasWillChange?: boolean;
+        /**
+         * Sets precision for the `transform` property by limiting the number of decimal places.
+         * Helps prevent choppy scrolling caused by large decimal values in transforms.
+         * Set to `false` to disable precision rounding.
+         * @default 2
+         */
+        translatePrecision?: false | number;
+    }
+    interface IChangeableProps extends NComponent.IChangeableProps {
+        /**
+         * If `true`, scrolling is enabled.
+         * @default true
+         */
+        isEnabled?: boolean;
+        /**
+         * If `true`, enables scrolling via mouse wheel.
+         * @default true
+         */
+        hasWheel?: boolean;
+        /**
+         * Defines the scroll speed multiplier for the mouse wheel.
+         * @default 1
+         */
+        wheelSpeed?: number;
+        /**
+         * Defines the main scrolling direction. Can be either horizontal or vertical.
+         * @default 'vertical'
+         */
+        direction?: 'horizontal' | 'vertical';
+        /**
+         * Inverts the scroll direction. Useful for reversed scrolling behaviors.
+         * @default false
+         */
+        isInversedHandlerDirection?: boolean;
+        /**
+         * Automatically stops the animation frame when the target and current scroll values are equal.
+         * Improves performance by preventing unnecessary renders.
+         * @default true
+         */
+        shouldAutoStop?: boolean;
+        /**
+         * If `true`, stops propagation of the scroll event to parent elements.
+         * @default true
+         */
+        hasStopPropagation?: boolean;
+        /**
+         * Linear interpolation factor for smooth scrolling. Scroll elements can override this value using the `customScrollLerp` property or the "data-custom-scroll-lerp" attribute.
+         * @default 0.1
+         */
+        lerp?: number;
+        /**
+         * Normalizes the scroll speed across different screens by accounting for varying FPS rates.
+         * @default true
+         */
+        isFpsNormalized?: boolean;
+        /**
+         * Approximation factor for interpolation, used to prevent animation from getting too slow at very small differences between current and target values.
+         * @default 0.1
+         */
+        lerpApproximation?: number;
+    }
+    interface ICallbacksTypes extends NComponent.ICallbacksTypes {
+        /**
+         * Fired when the component renders a new scroll frame.
+         */
+        render: undefined;
+        /**
+         * Fired when the component or viewport is resized.
+         */
+        resize: undefined;
+        /**
+         * Fired when a scroll event is detected from a mouse wheel interaction.
+         */
+        wheel: IWheelParameter;
+    }
+    interface IWheelParameter {
+        /**
+         * The original wheel event that triggered the scroll.
+         */
+        event: WheelEvent;
+    }
+    /**
+     * Represents a scrollable element within the CustomScroll component.
+     * These elements can track custom scroll positions and include custom interpolation settings.
+     */
+    interface IElement extends HTMLElement {
+        /**
+         * The current custom scroll top value for this element.
+         */
+        customScrollTop: number;
+        /**
+         * The current custom scroll left value for this element.
+         */
+        customScrollLeft: number;
+        /**
+         * Optional custom interpolation (lerp) value specific to this element.
+         */
+        customScrollLerp?: number;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/components/CustomScroll/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/CustomScroll/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,yBAAiB,aAAa,CAAC;IAC7B,UAAiB,YAAa,SAAQ,UAAU,CAAC,YAAY;QAC3D;;;WAGG;QACH,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;QAEjC;;;;WAIG;QACH,QAAQ,CAAC,EACL,KAAK,GACL,MAAM,GACN,UAAU,CAAC,WAAW,CAAC,GACvB,WAAW,GACX,WAAW,EAAE,CAAC;QAElB;;;WAGG;QACH,cAAc,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC;QAExC;;;WAGG;QACH,cAAc,CAAC,EAAE,eAAe,CAAC;QAEjC;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB;;;WAGG;QACH,aAAa,CAAC,EAAE,OAAO,CAAC;QAExB;;;;;WAKG;QACH,kBAAkB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KACrC;IAED,UAAiB,gBAAiB,SAAQ,UAAU,CAAC,gBAAgB;QACnE;;;WAGG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;QAEpB;;;WAGG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB;;;WAGG;QACH,SAAS,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;QAEtC;;;WAGG;QACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;QAErC;;;;WAIG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QAEzB;;;WAGG;QACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAE7B;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;;WAGG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;QAE1B;;;WAGG;QACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B;IAED,UAAiB,eAAgB,SAAQ,UAAU,CAAC,eAAe;QACjE;;WAEG;QACH,MAAM,EAAE,SAAS,CAAC;QAElB;;WAEG;QACH,MAAM,EAAE,SAAS,CAAC;QAElB;;WAEG;QACH,KAAK,EAAE,eAAe,CAAC;KACxB;IAED,UAAiB,eAAe;QAC9B;;WAEG;QACH,KAAK,EAAE,UAAU,CAAC;KACnB;IAED;;;OAGG;IACH,UAAiB,QAAS,SAAQ,WAAW;QAC3C;;WAEG;QACH,eAAe,EAAE,MAAM,CAAC;QAExB;;WAEG;QACH,gBAAgB,EAAE,MAAM,CAAC;QAEzB;;WAEG;QACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;CACF"}

package/lib/types/components/CustomScrollDragPlugin/index.d.ts

@@ -0,0 +1,62 @@
+import { Plugin } from '../../base/Plugin';
+import { NCustomScrollDragPlugin } from './types';
+import type { CustomScroll as CustomScrollInstance } from '../CustomScroll';
+import { DraggerMove, NDraggerMove } from '../DraggerMove';
+import { NCallbacks } from '../../base/Callbacks';
+export type { NCustomScrollDragPlugin };
+/**
+ * Plugin to add dragging functionality to a `CustomScroll` instance.
+ * It allows the user to control the scroll by dragging within the container.
+ */
+export declare class CustomScrollDragPlugin<StaticProp extends NCustomScrollDragPlugin.IStaticProps = NCustomScrollDragPlugin.IStaticProps, ChangeableProp extends NCustomScrollDragPlugin.IChangeableProps = NCustomScrollDragPlugin.IChangeableProps, CallbacksTypes extends NCustomScrollDragPlugin.ICallbacksTypes = NCustomScrollDragPlugin.ICallbacksTypes> extends Plugin<StaticProp, ChangeableProp, CallbacksTypes, CustomScrollInstance> {
+    protected _getDefaultProps(): {
+        isEnabled: boolean;
+        speed: number;
+        lerp: boolean;
+        stopPropagationThreshold: boolean;
+        stopPropagationDirection: string;
+    };
+    /** Instance of the DraggerMove component that handles dragging. */
+    protected _dragger?: DraggerMove;
+    /** List of callbacks added to the CustomScroll instance. */
+    protected _componentCallbacks?: NCallbacks.IAddedCallback[];
+    /** Holds the previous lerp value of the CustomScroll component. */
+    protected _prevComponentLerp?: number;
+    /**
+     * Determines whether dragging is currently active.
+     */
+    get isDragging(): boolean;
+    protected _init(): void;
+    protected _onPropsMutate(): void;
+    /**
+     * Enables or disables the dragger based on the `isEnabled` property.
+     */
+    protected _toggleDragger(): void;
+    /**
+     * Adds the dragger functionality to the CustomScroll instance.
+     */
+    protected _addDragger(): void;
+    /**
+     * Removes the dragger and cleans up callbacks.
+     */
+    protected _removeDragger(): void;
+    /**
+     * Determines if dragging is possible based on the current scroll state.
+     */
+    protected _getIsDragAvailable(): boolean;
+    /**
+     * Handles the start of dragging.
+     */
+    protected _handleDragStart(): void;
+    /**
+     * Handles the dragging move event and updates scroll values.
+     */
+    protected _handleDragMove({ event, coords, start, step, }: NDraggerMove.ICallbacksTypes['move']): void;
+    /**
+     * Handles the end of dragging and restores the scroll state.
+     */
+    protected _handleDragEnd(): void;
+    /** Cleans up and destroys the plugin. */
+    protected _destroy(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/types/components/CustomScrollDragPlugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/CustomScrollDragPlugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,IAAI,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAExC;;;GAGG;AACH,qBAAa,sBAAsB,CACjC,UAAU,SACR,uBAAuB,CAAC,YAAY,GAAG,uBAAuB,CAAC,YAAY,EAC7E,cAAc,SACZ,uBAAuB,CAAC,gBAAgB,GAAG,uBAAuB,CAAC,gBAAgB,EACrF,cAAc,SACZ,uBAAuB,CAAC,eAAe,GAAG,uBAAuB,CAAC,eAAe,CACnF,SAAQ,MAAM,CACd,UAAU,EACV,cAAc,EACd,cAAc,EACd,oBAAoB,CACrB;IACC,SAAS,CAAC,gBAAgB;;;;;;;IAW1B,mEAAmE;IACnE,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEjC,4DAA4D;IAC5D,SAAS,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC,cAAc,EAAE,CAAC;IAE5D,mEAAmE;IACnE,SAAS,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAEtC;;OAEG;IACH,IAAI,UAAU,YAEb;IAED,SAAS,CAAC,KAAK;IAMf,SAAS,CAAC,cAAc;IAMxB;;OAEG;IACH,SAAS,CAAC,cAAc;IAQxB;;OAEG;IACH,SAAS,CAAC,WAAW;IA4BrB;;OAEG;IACH,SAAS,CAAC,cAAc;IAYxB;;OAEG;IACH,SAAS,CAAC,mBAAmB;IAiB7B;;OAEG;IACH,SAAS,CAAC,gBAAgB;IAe1B;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,EACxB,KAAK,EACL,MAAM,EACN,KAAK,EACL,IAAI,GACL,EAAE,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC;IAqCvC;;OAEG;IACH,SAAS,CAAC,cAAc;IAcxB,yCAAyC;IACzC,SAAS,CAAC,QAAQ;CAKnB"}

package/lib/types/components/CustomScrollDragPlugin/types.d.ts

@@ -0,0 +1,52 @@
+import { NPlugin } from '../../base/Plugin/types';
+export declare namespace NCustomScrollDragPlugin {
+    interface IStaticProps extends NPlugin.IStaticProps {
+    }
+    interface IChangeableProps extends NPlugin.IChangeableProps {
+        /**
+         * Determines if the dragger functionality is enabled.
+         * @default true
+         */
+        isEnabled?: boolean;
+        /**
+         * Defines the speed of the dragger movement.
+         * Higher values make the dragging movement faster.
+         * @default 1
+         */
+        speed?: number;
+        /**
+         * Custom linear interpolation (lerp) value for smooth scrolling.
+         * If set to `false`, the lerp value from the `CustomScroll` instance is used.
+         * Values range between 0 and 1, with 1 being an instant scroll.
+         * @default false
+         */
+        lerp?: number | false;
+        /**
+         * Threshold in pixels to stop the event propagation during a drag.
+         * If set to `false`, no threshold is applied.
+         * @default false
+         */
+        stopPropagationThreshold?: false | number;
+        /**
+         * Defines the direction in which to stop event propagation.
+         * Either the X-axis ('x') or the Y-axis ('y').
+         * @default 'y'
+         */
+        stopPropagationDirection?: 'x' | 'y';
+    }
+    interface ICallbacksTypes extends NPlugin.ICallbacksTypes {
+        /**
+         * Fired when dragging starts.
+         */
+        start: undefined;
+        /**
+         * Fired while dragging is in progress.
+         */
+        move: undefined;
+        /**
+         * Fired when dragging ends.
+         */
+        end: undefined;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/components/CustomScrollDragPlugin/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/CustomScrollDragPlugin/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,yBAAiB,uBAAuB,CAAC;IACvC,UAAiB,YAAa,SAAQ,OAAO,CAAC,YAAY;KAAG;IAE7D,UAAiB,gBAAiB,SAAQ,OAAO,CAAC,gBAAgB;QAChE;;;WAGG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;QAEpB;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;;;;WAKG;QACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAEtB;;;;WAIG;QACH,wBAAwB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QAE1C;;;;WAIG;QACH,wBAAwB,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;KACtC;IAED,UAAiB,eAAgB,SAAQ,OAAO,CAAC,eAAe;QAC9D;;WAEG;QACH,KAAK,EAAE,SAAS,CAAC;QAEjB;;WAEG;QACH,IAAI,EAAE,SAAS,CAAC;QAEhB;;WAEG;QACH,GAAG,EAAE,SAAS,CAAC;KAChB;CACF"}

package/lib/types/components/CustomScrollKeyboardPlugin/index.d.ts

@@ -0,0 +1,47 @@
+/// <reference types="node" />
+import { Plugin } from '../../base/Plugin';
+import { NCustomScrollKeyboardPlugin } from './types';
+import type { CustomScroll as CustomScrollInstance } from '../CustomScroll';
+export type { NCustomScrollKeyboardPlugin };
+/**
+ * CustomScrollKeyboardPlugin adds keyboard navigation functionality to the `CustomScroll` component.
+ * It allows scrolling the container using keyboard arrow keys, space bar, page up/down, home, end, and tab.
+ */
+export declare class CustomScrollKeyboardPlugin<StaticProps extends NCustomScrollKeyboardPlugin.IStaticProps = NCustomScrollKeyboardPlugin.IStaticProps, ChangeableProps extends NCustomScrollKeyboardPlugin.IChangeableProps = NCustomScrollKeyboardPlugin.IChangeableProps, CallbacksTypes extends NCustomScrollKeyboardPlugin.ICallbacksTypes = NCustomScrollKeyboardPlugin.ICallbacksTypes> extends Plugin<StaticProps, ChangeableProps, CallbacksTypes, CustomScrollInstance> {
+    protected _getDefaultProps(): {
+        iterator: number;
+    };
+    /**
+     * Timeout for handling the Tab key navigation.
+     */
+    protected _tabTimeout?: NodeJS.Timeout;
+    /** Initializes the plugin by adding event listeners for keyboard events. */
+    protected _init(): void;
+    /**
+     * Determines if keyboard events should be ignored, based on the currently active element.
+     */
+    protected _canIgnoreEvents(): boolean;
+    /**
+     * Checks if the scroll container is visible in the viewport.
+     */
+    protected _isInViewport(): boolean;
+    /**
+     * Determines whether the scroll has reached its end.
+     */
+    protected _checkIsEndOfScroll(): boolean;
+    /**
+     * Handles the `keydown` event for navigating the scrollable container with the keyboard.
+     */
+    protected _handleKeydown(event: KeyboardEvent): void;
+    /**
+     * Handles the Tab key for focusing elements inside the scrollable container and adjusting the scroll position.
+     */
+    protected _handleTab(): void;
+    /**
+     * Handles the Spacebar key to scroll down the container by a fixed amount.
+     */
+    protected _handleSpace(event: KeyboardEvent): void;
+    /** Destroys the plugin and clears any timeouts or event listeners. */
+    protected _destroy(): void;
+}
+//# sourceMappingURL=index.d.ts.map