vevet 4.4.2 → 5.0.1

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

@@ -0,0 +1,105 @@
+import { IModuleCallbacksMap, IModuleMutableProps, IModuleStaticProps } from '../../base';
+export interface IPointersStaticProps extends IModuleStaticProps {
+    /**
+     * The element that listens for pointer events.
+     *
+     * Ensure the element has the appropriate [touch-action](https://developer.mozilla.org/en-US/docs/Web/CSS/touch-action)
+     * property to prevent conflicts with browser gestures.
+     */
+    container: HTMLElement | SVGElement;
+    /**
+     * Calculate coordinates relative to the container.
+     * @default false
+     */
+    relative?: boolean;
+    /**
+     * Determines which mouse buttons trigger events.
+     * - 0: Main button pressed, usually the left button or the un-initialized state
+     * - 1: Auxiliary button pressed, usually the wheel button or the middle button (if present)
+     * - 2: Secondary button pressed, usually the right button
+     * - 3: Fourth button, typically the Browser Back button
+     * - 4: Fifth button, typically the Browser Forward button
+     *
+     * See [MouseEvent.button](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/button).
+     *
+     * @default [0]
+     */
+    buttons?: number[];
+    /**
+     * Minimum number of active pointers required to trigger the "start" callback.
+     * @default 1
+     */
+    minPointers?: number;
+    /**
+     * Maximum number of pointers that can be tracked simultaneously.
+     * @default 5
+     */
+    maxPointers?: number;
+    /**
+     * Disable user selection on drag.
+     * @default true
+     */
+    disableUserSelect?: boolean;
+}
+export interface IPointersMutableProps extends IModuleMutableProps {
+    /**
+     * Enables or disables pointer events.
+     * @default true
+     */
+    enabled?: boolean;
+}
+export interface IPointersCallbacksMap extends IModuleCallbacksMap {
+    /**
+     * Fired when the required number of pointers is reached.
+     */
+    start: undefined;
+    /**
+     * Fired when a pointer is added.
+     */
+    pointerdown: {
+        event: PointerEvent;
+        pointer: IPointersItem;
+    };
+    /**
+     * Fired when a pointer moves.
+     */
+    pointermove: {
+        event: PointerEvent;
+        pointer: IPointersItem;
+    };
+    /**
+     * Fired when a pointer is removed.
+     */
+    pointerup: {
+        pointer: IPointersItem;
+    };
+    /**
+     * Fired when pointer events are canceled.
+     */
+    end: undefined;
+}
+export interface IPointersVec2 {
+    /** X-coordinate relative to the container. */
+    x: number;
+    /** Y-coordinate relative to the container. */
+    y: number;
+}
+export interface IPointersItem {
+    /** Unique pointer identifier. */
+    id: number;
+    /** Index assigned to the pointer. */
+    index: number;
+    /** Coordinates at the start of the interaction. */
+    start: IPointersVec2;
+    /** Previous recorded coordinates. */
+    prev: IPointersVec2;
+    /** Current pointer coordinates. */
+    current: IPointersVec2;
+    /** Movement offset from the starting position. */
+    diff: IPointersVec2;
+    /** Movement offset from the previous position. */
+    step: IPointersVec2;
+    /** Total accumulated movement since start. */
+    accum: IPointersVec2;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/Pointers/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,QAAQ,CAAC;AAEhB,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D;;;;;OAKG;IACH,SAAS,EAAE,WAAW,GAAG,UAAU,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,WAAW,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;IAE7D;;OAEG;IACH,WAAW,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;IAE7D;;OAEG;IACH,SAAS,EAAE;QAAE,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;IAEtC;;OAEG;IACH,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAC;IACV,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,EAAE,aAAa,CAAC;IACrB,qCAAqC;IACrC,IAAI,EAAE,aAAa,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,aAAa,CAAC;IACvB,kDAAkD;IAClD,IAAI,EAAE,aAAa,CAAC;IACpB,kDAAkD;IAClD,IAAI,EAAE,aAAa,CAAC;IACpB,8CAA8C;IAC9C,KAAK,EAAE,aAAa,CAAC;CACtB"}

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

@@ -1,83 +1,73 @@
-import { PCancelable } from '../../utils/common/PCancelable';
-import { NPreloader } from './types';
-import { Component as ComponentClass } from '../../base/Component';
-export type { NPreloader };
+import { TRequiredProps } from '../../internal/requiredProps';
+import { IPreloaderCallbacksMap, IPreloaderMutableProps, IPreloaderStaticProps } from './types';
+import { Module } from '../../base/Module';
+export * from './types';
 /**
- * Page preloader component, which manages the visibility of a preloader during page loading.
- * It can hide the preloader after the page is fully loaded and trigger related events.
+ * Page preloader component that manages the visibility and lifecycle of a loading screen.
+ * The module does not provide styling for the container.
  *
- * @requires Requires styles: `@import '~vevet/lib/styles/components/Preloader';`
+ * [Documentation](https://antonbobrov.github.io/vevet/docs/components/Preloader)
  *
- * @link See examples https://antonbobrov.github.io/vevet-demo/preloader/
- *
- * @link See docs https://antonbobrov.github.io/vevet/classes/Preloader.html
+ * @group Components
  */
-export declare class Preloader<StaticProps extends NPreloader.IStaticProps = NPreloader.IStaticProps, ChangeableProps extends NPreloader.IChangeableProps = NPreloader.IChangeableProps, CallbacksTypes extends NPreloader.ICallbacksTypes = NPreloader.ICallbacksTypes> extends ComponentClass<StaticProps, ChangeableProps, CallbacksTypes> {
-    protected _getDefaultProps(): {
-        container: string;
-        hideAnimation: number;
-    };
-    get prefix(): string;
-    /**
-     * The preloader container element.
-     */
-    protected _container?: HTMLElement | false;
+export declare class Preloader<CallbacksMap extends IPreloaderCallbacksMap = IPreloaderCallbacksMap, StaticProps extends IPreloaderStaticProps = IPreloaderStaticProps, MutableProps extends IPreloaderMutableProps = IPreloaderMutableProps> extends Module<CallbacksMap, StaticProps, MutableProps> {
     /**
-     * Returns the preloader container element.
+     * Retrieves the default static properties.
      */
-    get container(): false | HTMLElement | undefined;
+    _getStatic(): TRequiredProps<StaticProps>;
     /**
-     * Indicates if the preloader is in the process of being hidden.
-     */
-    protected _isToBeHidden: boolean;
-    /**
-     * Indicates if the preloader has already been hidden.
+     * Retrieves the default mutable properties.
      */
+    _getMutable(): TRequiredProps<MutableProps>;
+    /** Indicates if the preloader is in the process of being hidden. */
+    protected _shouldHide: boolean;
+    /** Indicates if the preloader has already been hidden. */
     protected _isHidden: boolean;
+    /** Indicates if the page is fully loaded. */
+    protected _isLoaded: boolean;
     /**
-     * Returns whether the preloader is hidden.
+     * Returns whether the preloader is currently hidden.
      */
     get isHidden(): boolean;
-    constructor(initialProps?: StaticProps & ChangeableProps, canInit?: boolean);
-    /**
-     * Initializes the preloader and sets event listeners.
-     */
-    protected _init(): void;
-    /**
-     * Sets up the preloader's event handling for when the page is fully loaded.
-     */
-    protected _setEvents(): void;
+    constructor(props?: StaticProps & MutableProps);
     /**
      * Handles the page load event, triggering when the page is fully loaded.
      */
-    protected _onLoaded(): PCancelable<void>;
+    protected _onLoaded(callback: () => void): void;
     /**
      * Handles the logic that occurs after the page is fully loaded.
      */
     protected _handleLoaded(): void;
     /**
-     * Hides the preloader with an optional animation duration.
+     * Hides the preloader with a custom animation duration.
      *
-     * @param duration - The duration of the hide animation (in milliseconds).
+     * @param duration - The duration of the hide animation (in milliseconds). Applies only when the container is used.
+     * @param callback - The callback to execute when the hide animation is complete.
+     *
+     * @returns Returns an action destructor.
+     */
+    hide(duration: number, callback?: () => void): (() => void) | undefined;
+    /**
+     * Executes the hiding animation for the preloader container.
      */
-    hide(duration?: number): PCancelable<any>;
+    protected _hideContainer(onHidden: () => void, duration: number): void;
     /**
      * Handles actions when the preloader is fully hidden.
      */
-    protected _handleHidden(): void;
+    protected _onHidden(): void;
     /**
      * Registers a callback for when the preloader starts hiding.
      *
      * @param action - The callback function to execute.
-     * @returns A cancelable action or undefined if already in hiding process.
+     * @returns A destructor.
      */
-    onHide(action: () => void): import("../..").NCallbacks.IAddedCallback | undefined;
+    onHide(action: () => void): () => void;
     /**
      * Registers a callback for when the preloader is fully hidden.
      *
      * @param action - The callback function to execute.
-     * @returns A cancelable action or undefined if already hidden.
+     * @returns A destructor.
      */
-    onHidden(action: () => void): import("../..").NCallbacks.IAddedCallback | undefined;
+    onHidden(action: () => void): () => void;
 }
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Preloader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAK/D,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;;;;;;;;GASG;AACH,qBAAa,SAAS,CACpB,WAAW,SAAS,UAAU,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,EACrE,eAAe,SACb,UAAU,CAAC,gBAAgB,GAAG,UAAU,CAAC,gBAAgB,EAC3D,cAAc,SACZ,UAAU,CAAC,eAAe,GAAG,UAAU,CAAC,eAAe,CACzD,SAAQ,cAAc,CAAC,WAAW,EAAE,eAAe,EAAE,cAAc,CAAC;IACpE,SAAS,CAAC,gBAAgB;;;;IAQ1B,IAAI,MAAM,WAET;IAED;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAE3C;;OAEG;IACH,IAAI,SAAS,oCAEZ;IAED;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,IAAI,QAAQ,YAEX;gBAEW,YAAY,CAAC,EAAE,WAAW,GAAG,eAAe,EAAE,OAAO,UAAO;IAsBxE;;OAEG;IACH,SAAS,CAAC,KAAK;IAMf;;OAEG;IACH,SAAS,CAAC,UAAU;IAgBpB;;OAEG;IACH,SAAS,CAAC,SAAS;IAInB;;OAEG;IACH,SAAS,CAAC,aAAa;IAQvB;;;;OAIG;IACI,IAAI,CACT,QAAQ,SAED;IAgCT;;OAEG;IACH,SAAS,CAAC,aAAa;IAKvB;;;;;OAKG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI;IAUhC;;;;;OAKG;IACI,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI;CASnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Preloader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAKvC,cAAc,SAAS,CAAC;AAExB;;;;;;;GAOG;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;;OAEG;IACI,UAAU,IAAI,cAAc,CAAC,WAAW,CAAC;IAOhD;;OAEG;IACI,WAAW,IAAI,cAAc,CAAC,YAAY,CAAC;IAIlD,oEAAoE;IACpE,SAAS,CAAC,WAAW,UAAS;IAE9B,0DAA0D;IAC1D,SAAS,CAAC,SAAS,UAAS;IAE5B,6CAA6C;IAC7C,SAAS,CAAC,SAAS,UAAS;IAE5B;;OAEG;IACH,IAAI,QAAQ,YAEX;gBAEW,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY;IAW9C;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI;IAIxC;;OAEG;IACH,SAAS,CAAC,aAAa;IAavB;;;;;;;OAOG;IACI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI;IAuBnD;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,QAAQ,EAAE,MAAM;IAsB/D;;OAEG;IACH,SAAS,CAAC,SAAS;IAKnB;;;;;OAKG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI;IAUhC;;;;;OAKG;IACI,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI;CASnC"}

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

@@ -1,37 +1,42 @@
-import { NComponent } from '../../base/Component/types';
-export declare namespace NPreloader {
-    interface IStaticProps extends NComponent.IStaticProps {
-        /**
-         * The container for the preloader. You can pass a CSS selector string,
-         * an HTML element, or set it to `false` if you only need the preloader callbacks.
-         *
-         * @default '#v-preloader'
-         */
-        container?: string | HTMLElement | false;
-    }
-    interface IChangeableProps extends NComponent.IChangeableProps {
-        /**
-         * Defines whether to automatically hide the preloader container.
-         * Set `false` to disable the hiding animation, allowing you to manage it manually.
-         * Set a `number` to specify the animation duration in milliseconds.
-         *
-         * @default 250
-         */
-        hideAnimation?: false | number;
-    }
-    interface ICallbacksTypes extends NComponent.ICallbacksTypes {
-        /**
-         * Triggered when the page is fully loaded.
-         */
-        loaded: undefined;
-        /**
-         * Triggered when the preloader starts hiding.
-         */
-        hide: undefined;
-        /**
-         * Triggered when the preloader is completely hidden.
-         */
-        hidden: undefined;
-    }
+import { IModuleCallbacksMap, IModuleMutableProps, IModuleStaticProps } from '../../base/Module';
+/**
+ * Static properties for the Preloader module.
+ */
+export interface IPreloaderStaticProps extends IModuleStaticProps {
+    /**
+     * The container for the preloader. Set it to `null` if you only need the preloader logic.
+     */
+    container: HTMLElement | null;
+    /**
+     * Defines whether to automatically hide the preloader container.
+     * - `false`: Disables the hiding animation, allowing you to manage it manually.
+     * - `number`: Specifies the animation duration in milliseconds.
+     *   This works only if the container is an HTML element.
+     *
+     * @default 250
+     */
+    hide?: false | number;
+}
+/**
+ * Mutable properties for the Preloader module.
+ */
+export interface IPreloaderMutableProps extends IModuleMutableProps {
+}
+/**
+ * Callbacks map for the Preloader module.
+ */
+export interface IPreloaderCallbacksMap extends IModuleCallbacksMap {
+    /**
+     * Triggered when the page is fully loaded.
+     */
+    loaded: undefined;
+    /**
+     * Triggered when the preloader starts hiding.
+     */
+    hide: undefined;
+    /**
+     * Triggered when the preloader is completely hidden.
+     */
+    hidden: undefined;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/Preloader/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,yBAAiB,UAAU,CAAC;IAC1B,UAAiB,YAAa,SAAQ,UAAU,CAAC,YAAY;QAC3D;;;;;WAKG;QACH,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC;KAC1C;IAED,UAAiB,gBAAiB,SAAQ,UAAU,CAAC,gBAAgB;QACnE;;;;;;WAMG;QACH,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KAChC;IAED,UAAiB,eAAgB,SAAQ,UAAU,CAAC,eAAe;QACjE;;WAEG;QACH,MAAM,EAAE,SAAS,CAAC;QAElB;;WAEG;QACH,IAAI,EAAE,SAAS,CAAC;QAEhB;;WAEG;QACH,MAAM,EAAE,SAAS,CAAC;KACnB;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/Preloader/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D;;OAEG;IACH,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;CAAG;AAEtE;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB"}

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

@@ -1,136 +1,84 @@
-import { PCancelable } from '../../utils/common/PCancelable';
-import { AnimationFrame } from '../AnimationFrame';
+import { TRequiredProps } from '../../internal/requiredProps';
+import { IProgressPreloaderCallbacksMap, IProgressPreloaderResource, IProgressPreloaderMutableProps, IProgressPreloaderStaticProps } from './types';
 import { Preloader } from '../Preloader';
-import { Timeline } from '../Timeline';
-import { NProgressPreloader } from './types';
-export type { NProgressPreloader };
+import { Raf } from '../Raf';
+export * from './types';
 /**
- * Page preloader that calculates the loading progress of page resources such as images, videos, and custom elements.
- * Provides smooth progress calculation using an animation frame and optionally a timeline for forced completion.
+ * Page preloader for calculating and displaying the loading progress of resources (images, videos, custom elements).
+ * Provides smooth progress transitions.
  *
- * @requires Requires styles: `@import '~vevet/lib/styles/components/Preloader';`
+ * [Documentation](https://antonbobrov.github.io/vevet/docs/components/ProgressPreloader)
  *
- * @link See examples https://antonbobrov.github.io/vevet-demo/progress-preloader/
- *
- * @link See docs https://antonbobrov.github.io/vevet/classes/ProgressPreloader.html
+ * @group Components
  */
-export declare class ProgressPreloader<StaticProps extends NProgressPreloader.IStaticProps = NProgressPreloader.IStaticProps, ChangeableProps extends NProgressPreloader.IChangeableProps = NProgressPreloader.IChangeableProps, CallbacksTypes extends NProgressPreloader.ICallbacksTypes = NProgressPreloader.ICallbacksTypes> extends Preloader<StaticProps, ChangeableProps, CallbacksTypes> {
-    protected _getDefaultProps(): {
-        resourcesQuantity: number;
-        canPreloadImages: boolean;
-        canPreloadVideos: boolean;
-        preloadCustomSelector: string;
-        preloadIgnoreClassName: string;
-        lerp: number;
-        forceEnd: number;
-        container: string;
-        hideAnimation: number;
-    };
-    /**
-     * List of images to be preloaded.
-     */
-    protected _images: HTMLImageElement[];
-    /**
-     * Returns the list of images to be preloaded.
-     */
-    get images(): HTMLImageElement[];
-    /**
-     * List of videos to be preloaded.
-     */
-    protected _videos: HTMLVideoElement[];
-    /**
-     * Returns the list of videos to be preloaded.
-     */
-    get videos(): HTMLVideoElement[];
+export declare class ProgressPreloader<CallbacksMap extends IProgressPreloaderCallbacksMap = IProgressPreloaderCallbacksMap, StaticProps extends IProgressPreloaderStaticProps = IProgressPreloaderStaticProps, MutableProps extends IProgressPreloaderMutableProps = IProgressPreloaderMutableProps> extends Preloader<CallbacksMap, StaticProps, MutableProps> {
     /**
-     * List of custom resources to be preloaded based on custom selectors.
+     * Retrieves the default static properties.
      */
-    protected _customResources: NProgressPreloader.ICustomResourceData[];
+    _getStatic(): TRequiredProps<StaticProps>;
     /**
-     * Returns the list of custom resources to be preloaded.
+     * Retrieves the default mutable properties.
      */
-    get customResources(): NProgressPreloader.ICustomResourceData[];
+    _getMutable(): TRequiredProps<MutableProps>;
     /**
-     * The total quantity of resources to be preloaded, including images, videos, custom elements, and user-defined amounts.
+     * List of custom resources to preload based on selectors.
      */
-    protected _resourcesQuantity: number;
+    protected _resources: IProgressPreloaderResource[];
     /**
-     * Returns the total number of resources to be preloaded, accounting for user-defined resources and automatic resources.
+     * The list of custom resources to preload.
      */
-    get resourcesQuantity(): number;
+    get resources(): IProgressPreloaderResource[];
     /**
-     * The quantity of loaded resources.
+     * Calculates the total number of resources to preload, including their weight.
      */
-    protected _loadedResourcesQuantity: number;
+    get totalWeight(): number;
     /**
-     * Returns the number of resources that have been successfully loaded.
+     * Loaded weight
      */
-    get loadedResourcesQuantity(): number;
+    get loadedWeight(): number;
     /**
-     * The current loading progress as a fraction between 0 and 1.
+     * Current loading progress (0 to 1).
      */
     get loadProgress(): number;
     /**
-     * The preloader's current progress value.
+     * Current interpolated progress value for smooth transitions.
      */
     protected _progress: number;
     /**
-     * Returns the current preloader progress value.
+     * Gets the current progress value.
      */
     get progress(): number;
+    /** Animation frame instance for managing smooth progress updates. */
+    protected _raf: Raf;
+    constructor(props?: StaticProps & MutableProps);
+    /** Preload images */
+    protected _fetchImages(): void;
+    /** Preload videos */
+    protected _fetchVideos(): void;
+    /** Preload custom resources */
+    protected _fetchResources(): void;
     /**
-     * Sets the preloader's progress value and triggers progress change handling.
-     */
-    protected set progress(val: number);
-    /**
-     * Animation frame instance used for smooth progress calculation.
-     */
-    protected _raf?: AnimationFrame;
-    /**
-     * Timeline used to finish progress animation if forced.
-     */
-    protected _endTimeline?: Timeline;
-    constructor(initialProps?: StaticProps & ChangeableProps, canInit?: boolean);
-    /**
-     * Initializes the preloader and retrieves the resources to be preloaded.
-     */
-    protected _init(): void;
-    /**
-     * Sets up event listeners and handles resource preloading.
-     */
-    protected _setEvents(): void;
-    /**
-     * Searches for all the images, videos, and custom elements that need to be preloaded.
-     */
-    protected _getResources(): void;
-    /** Catch the moment when the page is fully loaded. */
-    protected _onLoaded(): PCancelable<any>;
-    /**
-     * Preloads all gathered resources including images, videos, and custom elements.
-     */
-    protected _preloadResources(): void;
-    /**
-     * Handles a resource being fully loaded and updates the loaded resource count.
+     * Adds a custom resource
+     * @param id - The custom resource element or identifier to preload.
+     * @param weight - The resource weight
      */
-    protected _handleLoadedResource({ element, isSuccess, }: NProgressPreloader.IHandleLoadedResourceParameter): void;
+    addResource(id: Element | string, weight?: number): void;
     /**
-     * Increments the loaded resources count by a given quantity.
-     *
-     * @param quantity - The number of resources to consider as loaded.
+     * Emits a resource load event and updates the count of loaded resources.
+     * @param id - The resource element or identifier being loaded.
      */
-    iterateLoadedResources(quantityProp?: number): void;
+    resolveResource(id: Element | string, loadedWeight?: number): void;
     /**
-     * Increments the total resource count by a given quantity.
-     *
-     * @param quantity - The number of resources to add to the total.
+     * Handles updates to the preloader's progress, triggering events and animations as needed.
+     * @param newProgress - The updated progress value.
      */
-    iterateResourcesQuantity(quantity?: number): void;
+    protected _handleUpdate(newProgress: number): void;
     /**
-     * Handles the change in preloader progress, triggering callbacks and determining when to hide the preloader.
+     * Resolves when the page and all resources are fully loaded.
      */
-    protected _handleProgressChange(): void;
+    protected _onLoaded(callback: () => void): void;
     /**
-     * Destroys the component and cleans up any remaining resources or animations.
+     * Cleans up resources and destroys the preloader instance.
      */
     protected _destroy(): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ProgressPreloader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAQ7C,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;;;;;;;;GASG;AACH,qBAAa,iBAAiB,CAC5B,WAAW,SACT,kBAAkB,CAAC,YAAY,GAAG,kBAAkB,CAAC,YAAY,EACnE,eAAe,SACb,kBAAkB,CAAC,gBAAgB,GAAG,kBAAkB,CAAC,gBAAgB,EAC3E,cAAc,SACZ,kBAAkB,CAAC,eAAe,GAAG,kBAAkB,CAAC,eAAe,CACzE,SAAQ,SAAS,CAAC,WAAW,EAAE,eAAe,EAAE,cAAc,CAAC;IAC/D,SAAS,CAAC,gBAAgB;;;;;;;;;;;IAa1B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAEtC;;OAEG;IACH,IAAI,MAAM,uBAET;IAED;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAEtC;;OAEG;IACH,IAAI,MAAM,uBAET;IAED;;OAEG;IACH,SAAS,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,mBAAmB,EAAE,CAAC;IAErE;;OAEG;IACH,IAAI,eAAe,6CAElB;IAED;;OAEG;IACH,SAAS,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,IAAI,iBAAiB,WASpB;IAED;;OAEG;IACH,SAAS,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAE3C;;OAEG;IACH,IAAI,uBAAuB,WAE1B;IAED;;OAEG;IACH,IAAI,YAAY,WAEf;IAED;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,IAAI,QAAQ,IAOgB,MAAM,CALjC;IAED;;OAEG;IACH,SAAS,KAAK,QAAQ,CAAC,GAAG,EAAE,MAAM,EAIjC;IAED;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC;gBAEtB,YAAY,CAAC,EAAE,WAAW,GAAG,eAAe,EAAE,OAAO,UAAO;IAexE;;OAEG;IACH,SAAS,CAAC,KAAK;IAMf;;OAEG;IACH,SAAS,CAAC,UAAU;IA0BpB;;OAEG;IACH,SAAS,CAAC,aAAa;IA4DvB,sDAAsD;IACtD,SAAS,CAAC,SAAS;IAmBnB;;OAEG;IACH,SAAS,CAAC,iBAAiB;IAyB3B;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,EAC9B,OAAO,EACP,SAAS,GACV,EAAE,kBAAkB,CAAC,8BAA8B;IAmBpD;;;;OAIG;IACI,sBAAsB,CAAC,YAAY,SAAI;IAQ9C;;;;OAIG;IACI,wBAAwB,CAAC,QAAQ,SAAI;IAI5C;;OAEG;IACH,SAAS,CAAC,qBAAqB;IA2C/B;;OAEG;IACH,SAAS,CAAC,QAAQ;CAMnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ProgressPreloader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM1D,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B,cAAc,SAAS,CAAC;AAExB;;;;;;;GAOG;AACH,qBAAa,iBAAiB,CAC5B,YAAY,SACV,8BAA8B,GAAG,8BAA8B,EACjE,WAAW,SACT,6BAA6B,GAAG,6BAA6B,EAC/D,YAAY,SACV,8BAA8B,GAAG,8BAA8B,CACjE,SAAQ,SAAS,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;IAC1D;;OAEG;IACI,UAAU,IAAI,cAAc,CAAC,WAAW,CAAC;IAYhD;;OAEG;IACI,WAAW,IAAI,cAAc,CAAC,YAAY,CAAC;IAIlD;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,0BAA0B,EAAE,CAEhD;IAEF;;OAEG;IACH,IAAI,SAAS,iCAEZ;IAED;;OAEG;IACH,IAAI,WAAW,WAEd;IAED;;OAEG;IACH,IAAI,YAAY,WAEf;IAED;;OAEG;IACH,IAAI,YAAY,WAEf;IAED;;OAEG;IACH,SAAS,CAAC,SAAS,SAAK;IAExB;;OAEG;IACH,IAAI,QAAQ,WAEX;IAED,qEAAqE;IACrE,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC;gBAER,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY;IAqB9C,qBAAqB;IACrB,SAAS,CAAC,YAAY;IAyBtB,qBAAqB;IACrB,SAAS,CAAC,YAAY;IAuBtB,+BAA+B;IAC/B,SAAS,CAAC,eAAe;IAsBzB;;;;OAIG;IACI,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,EAAE,MAAM,SAAI;IAcnD;;;OAGG;IACI,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAelE;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM;IAiC3C;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI;IAexC;;OAEG;IACH,SAAS,CAAC,QAAQ;CAKnB"}