vevet 4.4.2 → 5.0.1

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

@@ -1,113 +1,73 @@
-import { NPreloader } from '../Preloader';
-export declare namespace NProgressPreloader {
-    interface IStaticProps extends NPreloader.IStaticProps {
-        /**
-         * The default number of resources to preload. This can be incremented using custom logic.
-         * @default 0
-         */
-        resourcesQuantity?: number;
-        /**
-         * Whether to preload images automatically.
-         * @default true
-         */
-        canPreloadImages?: boolean;
-        /**
-         * Whether to preload videos automatically.
-         * @default false
-         */
-        canPreloadVideos?: boolean;
-        /**
-         * The selector for custom resources to be preloaded. These elements should have properties such as `isLoaded`, `isComplete`, or the attribute `data-is-loaded` (from 0 to 1 or a boolean) for tracking loading status.
-         * Custom elements may also use the `data-load-count` attribute to indicate their weight.
-         *
-         * @default '.js-preload'
-         */
-        preloadCustomSelector?: string;
-        /**
-         * A class name that can be added to elements (such as images, videos, or custom resources) that should be ignored during the preload process.
-         * @default 'js-preload-ignore'
-         */
-        preloadIgnoreClassName?: string;
-        /**
-         * The amount of linear interpolation to apply to the loading progress. If set to `false`, no interpolation will be used, and the progress will update instantly.
-         * @default 0.1
-         */
-        lerp?: number | false;
-        /**
-         * If `true` and the animated progress is less than `1`, a timeline will automatically complete the progress when nearing the end. If `false`, progress will continue using linear interpolation until it completes.
-         * @default 500
-         */
-        forceEnd?: number | false;
-    }
-    interface IChangeableProps extends NPreloader.IChangeableProps {
-    }
-    interface ICallbacksTypes extends NPreloader.ICallbacksTypes {
-        /**
-         * Triggered when the preloader's progress is updated.
-         */
-        progress: IProgressParameter;
-        /**
-         * Triggered each time a resource is loaded during the preload process.
-         */
-        resourceLoad: IResourceLoadParameter;
-    }
-    interface IProgressParameter {
-        /**
-         * The current preloader progress (between 0 and 1).
-         */
-        progress: number;
-        /**
-         * The current progress based on loaded resources (between 0 and 1).
-         */
-        loadProgress: number;
-    }
-    interface IResourceLoadParameter {
-        /**
-         * The resource element that was loaded, if applicable.
-         */
-        element?: Element;
-        /**
-         * The progress value when the resource was loaded.
-         */
-        atProgress: number;
-        /**
-         * The overall load progress when this resource was loaded.
-         */
-        loadProgress: number;
-        /**
-         * Whether the resource was successfully loaded.
-         */
-        isSuccess: boolean;
-    }
-    interface IHandleLoadedResourceParameter {
-        /**
-         * The resource element that was loaded, if applicable.
-         */
-        element?: Element;
-        /**
-         * Whether the resource was successfully loaded.
-         */
-        isSuccess: boolean;
-    }
-    interface ICustomResource extends Element {
-        /**
-         * Indicates whether the custom resource has been fully loaded. Can be a boolean or a number representing the loading progress.
-         */
-        isLoaded?: boolean | number;
-        /**
-         * Indicates whether the custom resource is complete. Can be a boolean or a number representing the loading progress.
-         */
-        isComplete?: boolean | number;
-    }
-    interface ICustomResourceData {
-        /**
-         * The custom resource element to be preloaded.
-         */
-        element: ICustomResource;
-        /**
-         * The target progress value (between 0 and 1) for this resource, based on its `data-load-count` attribute.
-         */
-        targetProgress: number;
-    }
+import { IPreloaderCallbacksMap, IPreloaderMutableProps, IPreloaderStaticProps } from '../Preloader';
+/**
+ * Static properties for configuring the progress preloader.
+ */
+export interface IProgressPreloaderStaticProps extends IPreloaderStaticProps {
+    /**
+     * Enables automatic preloading of images.
+     * @default true
+     */
+    preloadImages?: boolean;
+    /**
+     * Enables automatic preloading of videos.
+     * @default false
+     */
+    preloadVideos?: boolean;
+    /**
+     * Selector for custom resources to preload. Elements should include `data-weight` and `data-loaded` attributes.
+     * Example: `data-weight="10"` for a weight of 10, `data-loaded="10"` when loaded.
+     * @default '.js-preload'
+     */
+    customSelector?: string;
+    /**
+     * Class name for elements to exclude from preloading.
+     * @default 'js-preload-ignore'
+     */
+    ignoreClassName?: string;
+    /**
+     * Linear interpolation factor for smooth progress updates. `1` disables interpolation for instant updates.
+     * @default 0.1
+     */
+    lerp?: number;
+    /**
+     * Duration (ms) to complete the preloader if resources are loaded but progress < 1.
+     * @default 500
+     */
+    endDuration?: number;
+}
+/**
+ * Mutable properties for the progress preloader.
+ */
+export interface IProgressPreloaderMutableProps extends IPreloaderMutableProps {
+}
+/**
+ * Callback events for the progress preloader.
+ */
+export interface IProgressPreloaderCallbacksMap extends IPreloaderCallbacksMap {
+    /**
+     * Fired when the preloader's progress updates.
+     */
+    progress: undefined;
+    /**
+     * Fired each time a resource is loaded during preloading.
+     */
+    resource: IProgressPreloaderResource;
+}
+/**
+ * Data structure for custom resources to preload.
+ */
+export interface IProgressPreloaderResource {
+    /**
+     * The custom resource identifier.
+     */
+    id: Element | string;
+    /**
+     * A resource may be split into multiple parts. This is the resource weight
+     */
+    weight: number;
+    /**
+     * Loaded weight
+     */
+    loaded: number;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/ProgressPreloader/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,yBAAiB,kBAAkB,CAAC;IAClC,UAAiB,YAAa,SAAQ,UAAU,CAAC,YAAY;QAC3D;;;WAGG;QACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAE3B;;;WAGG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAE3B;;;WAGG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAE3B;;;;;WAKG;QACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAE/B;;;WAGG;QACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAEhC;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAEtB;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;KAC3B;IAED,UAAiB,gBAAiB,SAAQ,UAAU,CAAC,gBAAgB;KAAG;IAExE,UAAiB,eAAgB,SAAQ,UAAU,CAAC,eAAe;QACjE;;WAEG;QACH,QAAQ,EAAE,kBAAkB,CAAC;QAE7B;;WAEG;QACH,YAAY,EAAE,sBAAsB,CAAC;KACtC;IAED,UAAiB,kBAAkB;QACjC;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;KACtB;IAED,UAAiB,sBAAsB;QACrC;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,YAAY,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,SAAS,EAAE,OAAO,CAAC;KACpB;IAED,UAAiB,8BAA8B;QAC7C;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;QAElB;;WAEG;QACH,SAAS,EAAE,OAAO,CAAC;KACpB;IAED,UAAiB,eAAgB,SAAQ,OAAO;QAC9C;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QAE5B;;WAEG;QACH,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;KAC/B;IAED,UAAiB,mBAAmB;QAClC;;WAEG;QACH,OAAO,EAAE,eAAe,CAAC;QAEzB;;WAEG;QACH,cAAc,EAAE,MAAM,CAAC;KACxB;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/ProgressPreloader/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,6BAA8B,SAAQ,qBAAqB;IAC1E;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,8BACf,SAAQ,sBAAsB;CAAG;AAEnC;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,sBAAsB;IAC5E;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,0BAA0B,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,EAAE,EAAE,OAAO,GAAG,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/lib/types/components/ProgressPreloader/utils/preloadCustomElement.d.ts

@@ -1,7 +1,6 @@
-import { Module } from '../../../base/Module';
-import { NProgressPreloader } from '../types';
+import { IProgressPreloaderResource } from '../types';
 /**
  * Preloads a custom resource element by recursively checking its load progress until the target progress is reached.
  */
-export declare function preloadCustomElement(data: NProgressPreloader.ICustomResourceData, instance: Module<any, any, any>): Promise<void>;
+export declare function preloadCustomElement({ id, weight }: IProgressPreloaderResource, onLoad: (loadedWeight: number) => void): void;
 //# sourceMappingURL=preloadCustomElement.d.ts.map

package/lib/types/components/ProgressPreloader/utils/preloadCustomElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preloadCustomElement.d.ts","sourceRoot":"","sources":["../../../../../src/components/ProgressPreloader/utils/preloadCustomElement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAqD9C;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,kBAAkB,CAAC,mBAAmB,EAC5C,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,iBAwBhC"}
+{"version":3,"file":"preloadCustomElement.d.ts","sourceRoot":"","sources":["../../../../../src/components/ProgressPreloader/utils/preloadCustomElement.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAYtD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,0BAA0B,EAC1C,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,QA2BvC"}

package/lib/types/components/ProgressPreloader/utils/preloadImage.d.ts

@@ -1,2 +1,2 @@
-export declare function preloadImage(imageProp: HTMLImageElement, action: (isSuccess: boolean) => void): void;
+export declare function preloadImage(resource: HTMLImageElement, onLoad: () => void): void;
 //# sourceMappingURL=preloadImage.d.ts.map

package/lib/types/components/ProgressPreloader/utils/preloadImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preloadImage.d.ts","sourceRoot":"","sources":["../../../../../src/components/ProgressPreloader/utils/preloadImage.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAC1B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,QAerC"}
+{"version":3,"file":"preloadImage.d.ts","sourceRoot":"","sources":["../../../../../src/components/ProgressPreloader/utils/preloadImage.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,IAAI,QAc1E"}

package/lib/types/components/ProgressPreloader/utils/preloadVideo.d.ts

@@ -1,2 +1,2 @@
-export declare function preloadVideo(video: HTMLVideoElement, action: (isSuccess: boolean) => void): void;
+export declare function preloadVideo(resource: HTMLVideoElement, onLoad: () => void): void;
 //# sourceMappingURL=preloadVideo.d.ts.map

package/lib/types/components/ProgressPreloader/utils/preloadVideo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preloadVideo.d.ts","sourceRoot":"","sources":["../../../../../src/components/ProgressPreloader/utils/preloadVideo.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAC1B,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,QAgBrC"}
+{"version":3,"file":"preloadVideo.d.ts","sourceRoot":"","sources":["../../../../../src/components/ProgressPreloader/utils/preloadVideo.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,IAAI,QAe1E"}

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

@@ -0,0 +1,63 @@
+import { TRequiredProps } from '../../internal/requiredProps';
+import { Module } from '../../base/Module';
+import { IRafCallbacksMap, IRafMutableProps, IRafStaticProps } from './types';
+export * from './types';
+/**
+ * Manages an animation frame loop with configurable FPS and playback controls.
+ *
+ * [Documentation](https://antonbobrov.github.io/vevet/docs/components/Raf)
+ *
+ * @group Components
+ */
+export declare class Raf<CallbacksMap extends IRafCallbacksMap = IRafCallbacksMap, StaticProps extends IRafStaticProps = IRafStaticProps, MutableProps extends IRafMutableProps = IRafMutableProps> extends Module<CallbacksMap, StaticProps, MutableProps> {
+    /** Get default static properties */
+    _getStatic(): TRequiredProps<StaticProps>;
+    /** Get default mutable properties */
+    _getMutable(): TRequiredProps<MutableProps>;
+    /** Indicates if the animation frame is currently running */
+    protected _isPlaying: boolean;
+    /** Playback state of the animation frame */
+    get isPlaying(): boolean;
+    /** Active requestAnimationFrame ID, or `null` if not running */
+    protected _raf: number | null;
+    /** Timestamp of the last frame */
+    protected _lastTimestamp: null | number;
+    /** Timestamp of the current frame */
+    protected _timestamp: null | number;
+    /** Timestamp of the current frame */
+    get timestamp(): number;
+    /** Current frame index */
+    protected _index: number;
+    /** Current frame index */
+    get index(): number;
+    /** Real-time FPS */
+    protected _fps: number;
+    /** Real-time FPS */
+    get fps(): number;
+    /** Duration of the last frame in ms */
+    protected _duration: number;
+    /** Duration of the last frame in ms */
+    get duration(): number;
+    /** Scaling coefficient based on a 60 FPS target */
+    get fpsFactor(): number;
+    constructor(props?: StaticProps & MutableProps);
+    /** Handle property mutations */
+    protected _handleProps(): void;
+    /** Start the animation loop */
+    play(): void;
+    /** Internal method to start the loop */
+    protected _play(): void;
+    /** Pause the animation loop */
+    pause(): void;
+    /** Internal method to pause the loop */
+    protected _pause(): void;
+    /** Animation loop handler, calculates FPS, and triggers callbacks */
+    protected _animate(): void;
+    /** Calculate linear interpolation factor to make animations run the same regardless of FPS */
+    lerpFactor(ease: number): number;
+    /** Compute real-time FPS from frame durations */
+    protected _computeFPS(): void;
+    /** Destroy the animation frame and stop the loop */
+    protected _destroy(): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Raf/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE9E,cAAc,SAAS,CAAC;AAExB;;;;;;GAMG;AACH,qBAAa,GAAG,CACd,YAAY,SAAS,gBAAgB,GAAG,gBAAgB,EACxD,WAAW,SAAS,eAAe,GAAG,eAAe,EACrD,YAAY,SAAS,gBAAgB,GAAG,gBAAgB,CACxD,SAAQ,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;IACvD,oCAAoC;IAC7B,UAAU,IAAI,cAAc,CAAC,WAAW,CAAC;IAIhD,qCAAqC;IAC9B,WAAW,IAAI,cAAc,CAAC,YAAY,CAAC;IASlD,4DAA4D;IAC5D,SAAS,CAAC,UAAU,UAAS;IAE7B,4CAA4C;IAC5C,IAAI,SAAS,YAEZ;IAED,gEAAgE;IAChE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAQ;IAErC,kCAAkC;IAClC,SAAS,CAAC,cAAc,EAAE,IAAI,GAAG,MAAM,CAAQ;IAE/C,qCAAqC;IACrC,SAAS,CAAC,UAAU,EAAE,IAAI,GAAG,MAAM,CAAQ;IAE3C,qCAAqC;IACrC,IAAI,SAAS,WAEZ;IAED,0BAA0B;IAC1B,SAAS,CAAC,MAAM,SAAK;IAErB,0BAA0B;IAC1B,IAAI,KAAK,WAER;IAED,oBAAoB;IACpB,SAAS,CAAC,IAAI,SAAM;IAEpB,oBAAoB;IACpB,IAAI,GAAG,WAEN;IAED,uCAAuC;IACvC,SAAS,CAAC,SAAS,SAAK;IAExB,uCAAuC;IACvC,IAAI,QAAQ,WAEX;IAED,mDAAmD;IACnD,IAAI,SAAS,WAEZ;gBAEW,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY;IAY9C,gCAAgC;IAChC,SAAS,CAAC,YAAY;IAYtB,+BAA+B;IACxB,IAAI;IAQX,wCAAwC;IACxC,SAAS,CAAC,KAAK;IAaf,+BAA+B;IACxB,KAAK;IAQZ,wCAAwC;IACxC,SAAS,CAAC,MAAM;IAgBhB,qEAAqE;IACrE,SAAS,CAAC,QAAQ;IAiClB,8FAA8F;IACvF,UAAU,CAAC,IAAI,EAAE,MAAM;IAI9B,iDAAiD;IACjD,SAAS,CAAC,WAAW;IAkBrB,oDAAoD;IACpD,SAAS,CAAC,QAAQ;CAKnB"}

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

@@ -0,0 +1,44 @@
+import { IModuleCallbacksMap, IModuleMutableProps, IModuleStaticProps } from '../../base/Module';
+/** Static properties for the Raf module */
+export interface IRafStaticProps extends IModuleStaticProps {
+}
+/** Mutable properties for the Raf module */
+export interface IRafMutableProps extends IModuleMutableProps {
+    /**
+     * Frames per second (FPS) for the animation. Set to 'auto' for dynamic adjustment.
+     * @default 'auto'
+     */
+    fps?: 'auto' | number;
+    /**
+     * Enables or disables the Raf animation loop.
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * The number of frames after which the FPS is recalculated.
+     * This value determines how often the FPS calculation is updated based on frame counts.
+     * @default 10
+     */
+    fpsRecalcFrames?: number;
+}
+/** Callbacks for Raf module events */
+export interface IRafCallbacksMap extends IModuleCallbacksMap {
+    /** Triggered when the animation starts */
+    play: undefined;
+    /** Triggered when the animation is paused */
+    pause: undefined;
+    /** Triggered when play/pause state toggles */
+    toggle: undefined;
+    /** Triggered on every animation frame */
+    frame: {
+        /** Current frames per second */
+        fps: number;
+        /** Scaling coefficient based on a 60 FPS target */
+        fpsFactor: number;
+        /** Duration of the last frame in ms */
+        duration: number;
+        /** Calculate linear interpolation factor to make animations run the same regardless of FPS */
+        lerpFactor: (factor: number) => number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/Raf/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAEvB,2CAA2C;AAC3C,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;CAAG;AAE9D,4CAA4C;AAC5C,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,0CAA0C;IAC1C,IAAI,EAAE,SAAS,CAAC;IAEhB,6CAA6C;IAC7C,KAAK,EAAE,SAAS,CAAC;IAEjB,8CAA8C;IAC9C,MAAM,EAAE,SAAS,CAAC;IAElB,yCAAyC;IACzC,KAAK,EAAE;QACL,gCAAgC;QAChC,GAAG,EAAE,MAAM,CAAC;QACZ,mDAAmD;QACnD,SAAS,EAAE,MAAM,CAAC;QAClB,uCAAuC;QACvC,QAAQ,EAAE,MAAM,CAAC;QACjB,8FAA8F;QAC9F,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;KACxC,CAAC;CACH"}

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

@@ -0,0 +1,91 @@
+import { IScrollProgressBounds, IScrollProgressCallbacksMap, IScrollProgressMutableProps, IScrollProgressStaticProps } from './types';
+import { Module } from '../../base';
+import { TRequiredProps } from '../../internal/requiredProps';
+export * from './types';
+/**
+ * `ScrollProgress` is a component that tracks the scroll progress of a specified section element.
+ *
+ * This component can be used for creating scroll-based animations such as parallax effects.
+ *
+ * [Documentation](https://antonbobrov.github.io/vevet/docs/components/ScrollProgress)
+ *
+ * @group Components
+ */
+export declare class ScrollProgress<CallbacksMap extends IScrollProgressCallbacksMap = IScrollProgressCallbacksMap, StaticProps extends IScrollProgressStaticProps = IScrollProgressStaticProps, MutableProps extends IScrollProgressMutableProps = IScrollProgressMutableProps> extends Module<CallbacksMap, StaticProps, MutableProps> {
+    /** Retrieves the default static properties. */
+    _getStatic(): TRequiredProps<StaticProps>;
+    /** Retrieves the default mutable properties. */
+    _getMutable(): TRequiredProps<MutableProps>;
+    /**
+     * Returns the section element being tracked for scroll progress.
+     */
+    get section(): Element;
+    /** Indicates whether the section is currently visible within the viewport or root element. */
+    protected _isVisible: boolean;
+    /** Indicates whether the section is currently visible within the viewport or root element. */
+    get isVisible(): boolean;
+    /** The bounds of the root element used for scroll calculations. */
+    protected _rootBounds: IScrollProgressBounds;
+    /** The bounds of the root element used for scroll calculations. */
+    get rootBounds(): IScrollProgressBounds;
+    /** The bounds of the section element relative to the root element. */
+    protected _sectionBounds: IScrollProgressBounds;
+    /** The bounds of the section element relative to the root element. */
+    get sectionBounds(): IScrollProgressBounds;
+    constructor(props?: StaticProps & MutableProps);
+    /** Sets up events */
+    protected _setup(): void;
+    /**
+     * Sets up an `IntersectionObserver` to track the visibility of the section.
+     */
+    protected _setupObserver(): void;
+    /**
+     * Sets up a scroll event listener to track and update progress.
+     */
+    protected _setupScroll(): void;
+    /** Updates the section and root bounds, and emits an update callback. */
+    update(): void;
+    /**
+     * Calculates the section scroll progress relative to the root element.
+     *
+     * The function takes top or left corner of the section as the reference point.
+     *
+     * @param topThreshold - Top threshold of the section position.
+     * @param rightThreshold - Right threshold of the section position.
+     * @param bottomThreshold - Bottom threshold of the section position.
+     * @param leftThreshold - Left threshold of the section position.
+     * @returns The scroll progress along the x and y axes.
+     *
+     * @example
+     *
+     * const progress = getProgress(0, vevet.width, vevet.height / 2, 0)
+     *
+     * // `progress.y` is `0` when the top corner of the section is at the beginning of the viewport or root element
+     * // `progress.y` is `1` when the top corner of the section is at the center of the viewport or root element
+     */
+    getProgress(topThreshold: number, rightThreshold: number, bottomThreshold: number, leftThreshold: number): {
+        x: number;
+        y: number;
+    };
+    /** Calculates the progress of the section entering the root element. */
+    get inProgress(): {
+        x: number;
+        y: number;
+    };
+    /** Calculates the progress of the section leaving the root element. */
+    get outProgress(): {
+        x: number;
+        y: number;
+    };
+    /** Calculates the progress of the section's movement within the root element. */
+    get moveProgress(): {
+        x: number;
+        y: number;
+    };
+    /** Calculates the global scroll progress of the section relative to the root element. */
+    get progress(): {
+        x: number;
+        y: number;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ScrollProgress/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI1D,cAAc,SAAS,CAAC;AAExB;;;;;;;;GAQG;AACH,qBAAa,cAAc,CACzB,YAAY,SACV,2BAA2B,GAAG,2BAA2B,EAC3D,WAAW,SAAS,0BAA0B,GAAG,0BAA0B,EAC3E,YAAY,SACV,2BAA2B,GAAG,2BAA2B,CAC3D,SAAQ,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;IACvD,+CAA+C;IACxC,UAAU,IAAI,cAAc,CAAC,WAAW,CAAC;IAShD,gDAAgD;IACzC,WAAW,IAAI,cAAc,CAAC,YAAY,CAAC;IAIlD;;OAEG;IACH,IAAI,OAAO,YAEV;IAED,8FAA8F;IAC9F,SAAS,CAAC,UAAU,UAAS;IAE7B,8FAA8F;IAC9F,IAAI,SAAS,YAEZ;IAED,mEAAmE;IACnE,SAAS,CAAC,WAAW,EAAE,qBAAqB,CAK1C;IAEF,mEAAmE;IACnE,IAAI,UAAU,0BAEb;IAED,sEAAsE;IACtE,SAAS,CAAC,cAAc,EAAE,qBAAqB,CAK7C;IAEF,sEAAsE;IACtE,IAAI,aAAa,0BAEhB;gBAEW,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY;IAQ9C,qBAAqB;IACrB,SAAS,CAAC,MAAM;IAKhB;;OAEG;IACH,SAAS,CAAC,cAAc;IAqBxB;;OAEG;IACH,SAAS,CAAC,YAAY;IAiBtB,yEAAyE;IAClE,MAAM;IA4Bb;;;;;;;;;;;;;;;;;OAiBG;IACI,WAAW,CAChB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM;;;;IAkBvB,wEAAwE;IACxE,IAAI,UAAU;;;MAkBb;IAED,uEAAuE;IACvE,IAAI,WAAW;;;MASd;IAED,iFAAiF;IACjF,IAAI,YAAY;;;MAwBf;IAED,yFAAyF;IACzF,IAAI,QAAQ;;;MASX;CACF"}

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

@@ -0,0 +1,43 @@
+import { IModuleCallbacksMap, IModuleMutableProps, IModuleStaticProps } from '../../base';
+/** Static properties for the ScrollProgress module */
+export interface IScrollProgressStaticProps extends IModuleStaticProps {
+    /**
+     * The element whose scroll progress is tracked.
+     */
+    section: Element;
+    /**
+     * The root element used as a reference for scroll progress calculation.
+     * Usually it is the scroll container.
+     * If `null`, the viewport is used as the reference.
+     * @default null
+     */
+    root?: Element | null;
+    /**
+     * If `true`, progress is calculated only while the section is within the viewport or the root element.
+     * Improves performance by avoiding unnecessary calculations.
+     * @default true
+     */
+    optimized?: boolean;
+    /**
+     * If `true`, the scroll progress is calculated based on the small viewport height (svh in css) instead of the current viewport height (vh in css).
+     * @default false
+     */
+    useSvh?: boolean;
+}
+/** Mutable properties for the ScrollProgress module */
+export interface IScrollProgressMutableProps extends IModuleMutableProps {
+}
+/** Callbacks for ScrollProgress module events */
+export interface IScrollProgressCallbacksMap extends IModuleCallbacksMap {
+    /**
+     * Triggered on each scroll progress update.
+     */
+    update: undefined;
+}
+export interface IScrollProgressBounds {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/ScrollProgress/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,QAAQ,CAAC;AAEhB,sDAAsD;AACtD,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,uDAAuD;AACvD,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;CAAG;AAE3E,iDAAiD;AACjD,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}

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

@@ -0,0 +1,113 @@
+import { TRequiredProps } from '../../internal/requiredProps';
+import { Module } from '../../base';
+import { IScrollbarCallbacksMap, IScrollbarMutableProps, IScrollbarStaticProps } from './types';
+import { ISwipeCoords } from '../Swipe';
+export * from './types';
+/**
+ * A custom scrollbar component. Supports both `window` and `HTMLElement` containers.
+ *
+ * [Documentation](https://antonbobrov.github.io/vevet/docs/components/Scrollbar)
+ *
+ * @group Components
+ */
+export declare class Scrollbar<CallbacksMap extends IScrollbarCallbacksMap = IScrollbarCallbacksMap, StaticProps extends IScrollbarStaticProps = IScrollbarStaticProps, MutableProps extends IScrollbarMutableProps = IScrollbarMutableProps> extends Module<CallbacksMap, StaticProps, MutableProps> {
+    /** Get default static properties. */
+    _getStatic(): TRequiredProps<StaticProps>;
+    /** Get default mutable properties. */
+    _getMutable(): TRequiredProps<MutableProps>;
+    get prefix(): string;
+    /**
+     * The element to which the scrollbar is applied.
+     */
+    get container(): Window | HTMLElement;
+    /**
+     * Scrollbar outer element.
+     */
+    protected _outer: HTMLElement;
+    /**
+     * Scrollbar outer element
+     */
+    get outer(): HTMLElement;
+    /**
+     * Scrollbar track element (the container of the thumb).
+     */
+    protected _track: HTMLElement;
+    /**
+     * Scrollbar track element (the container of the thumb).
+     */
+    get track(): HTMLElement;
+    /**
+     * Scrollbar thumb element (draggable handle).
+     */
+    protected _thumb: HTMLElement;
+    /**
+     * Scrollbar thumb element (draggable handle).
+     */
+    get thumb(): HTMLElement;
+    /** Save scroll value on swipe start */
+    protected _valueOnSwipeStart: number;
+    /** Timeout for scroll action */
+    protected _addInActionTimeout?: NodeJS.Timeout;
+    /** Timeout for scroll action */
+    protected _removeInActionTimeout?: NodeJS.Timeout;
+    /** Previous scroll value */
+    protected _prevScrollValue: number;
+    constructor(props?: StaticProps & MutableProps);
+    /** Handles property mutations */
+    protected _handleProps(): void;
+    /** Scroll axis */
+    get axis(): "x" | "y";
+    /**
+     * The element where the scrollbar is appended.
+     * If `parent` is not set, it defaults to `container` or `document.body` (if applied to `window`).
+     */
+    get parent(): HTMLElement;
+    /**
+     * The actual scrollable element.
+     * Returns `document.documentElement` for `window`, otherwise the `container` itself.
+     */
+    get scrollElement(): HTMLElement;
+    /**
+     * Returns the total scroll width/height of the content.
+     */
+    get scrollSize(): number;
+    /**
+     * Returns the total scrollable distance.
+     */
+    get scrollableSize(): number;
+    /**
+     * Returns scrollTop or scrollLeft of the scrollable element.
+     */
+    get scrollValue(): number;
+    /** Returns the current track size. */
+    get trackSize(): number;
+    /** Returns the current thumb size. */
+    get thumbSize(): number;
+    /** Create elements */
+    protected _create(): void;
+    /** Create outer element */
+    protected _createOuter(): HTMLDivElement;
+    /** Create track element */
+    protected _createTrack(): HTMLDivElement;
+    /** Create thumb element */
+    protected _createThumb(): HTMLDivElement;
+    /** Set resize events */
+    protected _setResize(): void;
+    /** Set scroll events */
+    protected _setOnscroll(): void;
+    /** Set swipe events */
+    protected _setSwipe(): void;
+    /** Resize the scrollbar. */
+    resize(): void;
+    /** Render the scrollbar. */
+    protected _render(): void;
+    /** Handle scroll update */
+    protected _onScroll(): void;
+    /** Handle swipe move */
+    protected _onSwipeMove({ diff }: ISwipeCoords): void;
+    /**
+     * Destroys the component and cleans up resources.
+     */
+    protected _destroy(): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Scrollbar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAIjB,OAAO,EAAE,YAAY,EAAS,MAAM,UAAU,CAAC;AAE/C,cAAc,SAAS,CAAC;AAExB;;;;;;GAMG;AACH,qBAAa,SAAS,CACpB,YAAY,SAAS,sBAAsB,GAAG,sBAAsB,EACpE,WAAW,SAAS,qBAAqB,GAAG,qBAAqB,EACjE,YAAY,SAAS,sBAAsB,GAAG,sBAAsB,CACpE,SAAQ,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;IACvD,qCAAqC;IAC9B,UAAU,IAAI,cAAc,CAAC,WAAW,CAAC;IAahD,sCAAsC;IAC/B,WAAW,IAAI,cAAc,CAAC,YAAY,CAAC;IAQlD,IAAI,MAAM,WAET;IAED;;OAEG;IACH,IAAI,SAAS,yBAEZ;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAG,WAAW,CAAC;IAE/B;;OAEG;IACH,IAAI,KAAK,gBAER;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAG,WAAW,CAAC;IAE/B;;OAEG;IACH,IAAI,KAAK,gBAER;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAG,WAAW,CAAC;IAE/B;;OAEG;IACH,IAAI,KAAK,gBAER;IAED,uCAAuC;IACvC,SAAS,CAAC,kBAAkB,SAAK;IAEjC,gCAAgC;IAChC,SAAS,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IAE/C,gCAAgC;IAChC,SAAS,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IAElD,4BAA4B;IAC5B,SAAS,CAAC,gBAAgB,SAAK;gBAEnB,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY;IAe9C,iCAAiC;IACjC,SAAS,CAAC,YAAY;IAMtB,kBAAkB;IAClB,IAAI,IAAI,cAEP;IAED;;;OAGG;IACH,IAAI,MAAM,gBAMT;IAED;;;OAGG;IACH,IAAI,aAAa,gBAEhB;IAED;;OAEG;IACH,IAAI,UAAU,WAMb;IAED;;OAEG;IACH,IAAI,cAAc,WAMjB;IAED;;OAEG;IACH,IAAI,WAAW,WAQd;IAED,sCAAsC;IACtC,IAAI,SAAS,WAIZ;IAED,sCAAsC;IACtC,IAAI,SAAS,WAIZ;IAED,sBAAsB;IACtB,SAAS,CAAC,OAAO;IA0BjB,2BAA2B;IAC3B,SAAS,CAAC,YAAY;IAwBtB,2BAA2B;IAC3B,SAAS,CAAC,YAAY;IAYtB,2BAA2B;IAC3B,SAAS,CAAC,YAAY;IAUtB,wBAAwB;IACxB,SAAS,CAAC,UAAU;IAYpB,wBAAwB;IACxB,SAAS,CAAC,YAAY;IAatB,uBAAuB;IACvB,SAAS,CAAC,SAAS;IAkCnB,4BAA4B;IACrB,MAAM;IA4Cb,4BAA4B;IAC5B,SAAS,CAAC,OAAO;IAcjB,2BAA2B;IAC3B,SAAS,CAAC,SAAS;IA2BnB,wBAAwB;IACxB,SAAS,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,YAAY;IAc7C;;OAEG;IACH,SAAS,CAAC,QAAQ;CAWnB"}

package/lib/types/components/Scrollbar/styles.d.ts

@@ -0,0 +1,2 @@
+export declare function createScrollbarStyles(prefix: string): HTMLStyleElement;
+//# sourceMappingURL=styles.d.ts.map

package/lib/types/components/Scrollbar/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/components/Scrollbar/styles.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,oBAoFnD"}