vevet 3.20.0 → 4.0.0-beta.1

package/lib/esm/components/Preloader/index.js

@@ -4,7 +4,10 @@ import { Component as ComponentClass } from '../../base/Component';
 import { normalizedTimeoutCallback } from '../../utils/common';
 import { getApp } from '../../utils/internal/getApp';
 /**
- * Page preloader
+ * 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.
+ *
+ * @requires Requires styles: `@import '~vevet/lib/styles/components/Preloader';`
  */
 export class Preloader extends ComponentClass {
     _getDefaultProps() {
@@ -13,17 +16,21 @@ export class Preloader extends ComponentClass {
     get prefix() {
         return `${getApp().prefix}preloader`;
     }
-    /** Preloader container */
+    /**
+     * Returns the preloader container element.
+     */
     get container() {
         return this._container;
     }
-    /** Preloader is hidden */
+    /**
+     * Returns whether the preloader is hidden.
+     */
     get isHidden() {
         return this._isHidden;
     }
     constructor(initialProps, canInit = true) {
         super(initialProps, false);
-        // get preloader container
+        // Get the preloader container
         if (this.props.container) {
             const container = selectOne(this.props.container);
             if (container instanceof HTMLElement) {
@@ -31,19 +38,23 @@ export class Preloader extends ComponentClass {
                 this.toggleClassName(container, this.className(''), true);
             }
         }
-        // set default vars
+        // Set default values
         this._isToBeHidden = false;
         this._isHidden = false;
         if (canInit) {
             this.init();
         }
     }
-    /** Init the class */
+    /**
+     * Initializes the preloader and sets event listeners.
+     */
     _init() {
         super._init();
         this._setEvents();
     }
-    /** Set module event */
+    /**
+     * Sets up the preloader's event handling for when the page is fully loaded.
+     */
     _setEvents() {
         const loadEvent = this._onLoaded();
         loadEvent
@@ -56,19 +67,26 @@ export class Preloader extends ComponentClass {
             .catch(() => { });
         this.addDestroyableAction(() => loadEvent.cancel());
     }
-    /** Catch the moment when the page is fully loaded */
+    /**
+     * Handles the page load event, triggering when the page is fully loaded.
+     */
     _onLoaded() {
         return getApp().onPageLoad();
     }
-    /** When the page is fully loaded */
+    /**
+     * Handles the logic that occurs after the page is fully loaded.
+     */
     _handleLoaded() {
         this.callbacks.tbt('loaded', undefined);
-        // hide the preloader
         if (typeof this.props.hideAnimation !== 'boolean') {
             this.hide();
         }
     }
-    /** Hide the preloader */
+    /**
+     * Hides the preloader with an optional animation duration.
+     *
+     * @param duration - The duration of the hide animation (in milliseconds).
+     */
     hide(duration = typeof this.props.hideAnimation !== 'boolean'
         ? this.props.hideAnimation
         : 250) {
@@ -76,13 +94,12 @@ export class Preloader extends ComponentClass {
         this.callbacks.tbt('hide', undefined);
         return new PCancelable((resolve) => {
             const container = this._container;
-            // if container is not to be hidden
             if (!container) {
                 this._handleHidden();
                 resolve();
                 return;
             }
-            // if need to hide the container
+            // Apply hide animation
             container.style.transition = `opacity ${duration}ms, visibility ${duration}ms`;
             container.style.opacity = '0';
             container.style.visibility = 'hidden';
@@ -94,12 +111,19 @@ export class Preloader extends ComponentClass {
             this.addDestroyableAction(() => timeout.clear());
         });
     }
-    /** Handle the moment when the preloader is hidden */
+    /**
+     * Handles actions when the preloader is fully hidden.
+     */
     _handleHidden() {
         this._isHidden = true;
         this.callbacks.tbt('hidden', undefined);
     }
-    /** Callback for the moment when the preloader starts hiding */
+    /**
+     * 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.
+     */
     onHide(action) {
         if (this._isToBeHidden) {
             action();
@@ -107,7 +131,12 @@ export class Preloader extends ComponentClass {
         }
         return this.addCallback('hide', (() => action()));
     }
-    /** Callback for the moment when the preloader is hidden */
+    /**
+     * 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.
+     */
     onHidden(action) {
         if (this._isHidden) {
             action();

package/lib/esm/components/Preloader/index.js.map

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

package/lib/esm/components/ProgressPreloader/index.js

@@ -9,25 +9,36 @@ import { preloadVideo } from './utils/preloadVideo';
 import { preloadCustomElement } from './utils/preloadCustomElement';
 import { getApp } from '../../utils/internal/getApp';
 /**
- * Page preloader with smooth progress calculation
+ * 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.
+ *
+ * @requires Requires styles: `@import '~vevet/lib/styles/components/Preloader';`
  */
 export class ProgressPreloader extends Preloader {
     _getDefaultProps() {
         return Object.assign(Object.assign({}, super._getDefaultProps()), { resourcesQuantity: 0, canPreloadImages: true, canPreloadVideos: false, preloadCustomSelector: '.js-preload', preloadIgnoreClassName: 'js-preload-ignore', lerp: 0.1, forceEnd: 500 });
     }
-    /** Images to be preloaded */
+    /**
+     * Returns the list of images to be preloaded.
+     */
     get images() {
         return this._images;
     }
-    /** Videos to be preloaded */
+    /**
+     * Returns the list of videos to be preloaded.
+     */
     get videos() {
         return this._videos;
     }
-    /** Custom resources to be preloaded */
+    /**
+     * Returns the list of custom resources to be preloaded.
+     */
     get customResources() {
         return this._customResources;
     }
-    /** Quantity of resources to be preloader */
+    /**
+     * Returns the total number of resources to be preloaded, accounting for user-defined resources and automatic resources.
+     */
     get resourcesQuantity() {
         return (this._resourcesQuantity +
             this.props.resourcesQuantity +
@@ -36,25 +47,33 @@ export class ProgressPreloader extends Preloader {
             this.customResources.length +
             1);
     }
-    /** Quantity of loaded resources  */
+    /**
+     * Returns the number of resources that have been successfully loaded.
+     */
     get loadedResourcesQuantity() {
         return clamp(this._loadedResourcesQuantity, [0, this.resourcesQuantity]);
     }
-    /** Loading progress */
+    /**
+     * The current loading progress as a fraction between 0 and 1.
+     */
     get loadProgress() {
         return this.loadedResourcesQuantity / this.resourcesQuantity;
     }
-    /** Preloader progress */
+    /**
+     * Returns the current preloader progress value.
+     */
     get progress() {
         return this._progress;
     }
+    /**
+     * Sets the preloader's progress value and triggers progress change handling.
+     */
     set progress(val) {
         this._progress = val;
         this._handleProgressChange();
     }
     constructor(initialProps, canInit = true) {
         super(initialProps, false);
-        // set default vars
         this._images = [];
         this._videos = [];
         this._customResources = [];
@@ -65,21 +84,26 @@ export class ProgressPreloader extends Preloader {
             this.init();
         }
     }
+    /**
+     * Initializes the preloader and retrieves the resources to be preloaded.
+     */
     _init() {
         this._getResources();
         super._init();
     }
-    /** Set events */
+    /**
+     * Sets up event listeners and handles resource preloading.
+     */
     _setEvents() {
         super._setEvents();
         const { lerp: lerpProp } = this.props;
         // create animation frame if needed
-        if (typeof lerpProp === 'number') {
-            this._animationFrame = new AnimationFrame();
-            this._animationFrame.addCallback('frame', () => {
+        if (typeof lerpProp === 'number' && lerpProp < 1) {
+            this._raf = new AnimationFrame();
+            this._raf.addCallback('frame', () => {
                 this.progress = lerp(this.progress, this.loadProgress, lerpProp);
             });
-            this._animationFrame.play();
+            this._raf.play();
         }
         // iterate resources on page load
         getApp()
@@ -89,10 +113,12 @@ export class ProgressPreloader extends Preloader {
         // preload resources
         this._preloadResources();
     }
-    /** Get resources to be preloaded */
+    /**
+     * Searches for all the images, videos, and custom elements that need to be preloaded.
+     */
     _getResources() {
         const { canPreloadImages, canPreloadVideos, preloadCustomSelector, preloadIgnoreClassName, } = this.props;
-        // get images
+        // Get images
         if (canPreloadImages) {
             const images = selectAll('img');
             images.forEach((image) => {
@@ -103,7 +129,7 @@ export class ProgressPreloader extends Preloader {
                 }
             });
         }
-        // get videos
+        // Get videos
         if (canPreloadVideos) {
             const videos = selectAll('video');
             videos.forEach((video) => {
@@ -112,7 +138,7 @@ export class ProgressPreloader extends Preloader {
                 }
             });
         }
-        // get custom resources
+        // Get custom resources
         if (preloadCustomSelector) {
             Array.from(selectAll(preloadCustomSelector)).forEach((element) => {
                 if (element.classList.contains(preloadIgnoreClassName)) {
@@ -132,26 +158,26 @@ export class ProgressPreloader extends Preloader {
             });
         }
     }
-    /** Catch the moment when the page is fully loaded */
+    /** Catch the moment when the page is fully loaded. */
     _onLoaded() {
         return new PCancelable((resolve) => {
             let isCallbackDone = false;
             this.callbacks.add('progress', 
             // @ts-ignore
-            ({ progress }) => {
-                if (progress >= 1 && !isCallbackDone) {
+            (data) => {
+                if (data.progress >= 1 && !isCallbackDone) {
                     isCallbackDone = true;
                     resolve();
                 }
             }, { isProtected: true, name: this.name });
         });
     }
-    /** Preload all resources */
+    /**
+     * Preloads all gathered resources including images, videos, and custom elements.
+     */
     _preloadResources() {
         this.images.forEach((image) => preloadImage(image, (isSuccess) => this._handleLoadedResource({ element: image, isSuccess })));
-        // preload videos
         this.videos.forEach((video) => preloadVideo(video, (isSuccess) => this._handleLoadedResource({ element: video, isSuccess })));
-        // preload custom resources
         this._customResources.forEach((data) => {
             preloadCustomElement(data, this)
                 .then(() => this._handleLoadedResource({
@@ -161,7 +187,9 @@ export class ProgressPreloader extends Preloader {
                 .catch(() => { });
         });
     }
-    /** Event on resource loaded */
+    /**
+     * Handles a resource being fully loaded and updates the loaded resource count.
+     */
     _handleLoadedResource({ element, isSuccess, }) {
         if (this.loadProgress >= 1) {
             return;
@@ -174,22 +202,32 @@ export class ProgressPreloader extends Preloader {
             isSuccess,
         });
         // update progress if no animation frame
-        if (!this._animationFrame) {
+        if (!this._raf) {
             this.progress = this.loadProgress;
         }
     }
-    /** Iterate quantity of loaded resources */
+    /**
+     * Increments the loaded resources count by a given quantity.
+     *
+     * @param quantity - The number of resources to consider as loaded.
+     */
     iterateLoadedResources(quantityProp = 1) {
         const quantity = Math.abs(quantityProp);
         for (let index = 0; index < quantity; index += 1) {
             this._handleLoadedResource({ isSuccess: true });
         }
     }
-    /** Iterate quantity of total resources */
+    /**
+     * Increments the total resource count by a given quantity.
+     *
+     * @param quantity - The number of resources to add to the total.
+     */
     iterateResourcesQuantity(quantity = 1) {
         this._resourcesQuantity += quantity;
     }
-    /** Event on progress change */
+    /**
+     * Handles the change in preloader progress, triggering callbacks and determining when to hide the preloader.
+     */
     _handleProgressChange() {
         this.callbacks.tbt('progress', {
             progress: this.progress,
@@ -199,21 +237,20 @@ export class ProgressPreloader extends Preloader {
         // we hide the preloader
         if (this.progress >= 1) {
             // destroy animations
-            if (this._animationFrame) {
-                this._animationFrame.destroy();
-                this._animationFrame = undefined;
+            if (this._raf) {
+                this._raf.destroy();
+                this._raf = undefined;
             }
             return;
         }
-        // otherwise, we check if there's a need to launch a timeline
-        // to end the animation
+        // otherwise, we check if there's a need to launch a timeline to finish the animation
         if (typeof this.props.forceEnd === 'number' &&
             this.loadProgress >= 1 &&
             !this._endTimeline) {
-            // destroy animation frame
-            if (this._animationFrame) {
-                this._animationFrame.destroy();
-                this._animationFrame = undefined;
+            // destroy the animation frame
+            if (this._raf) {
+                this._raf.destroy();
+                this._raf = undefined;
             }
             // create a timeline
             this._endTimeline = new Timeline({ duration: this.props.forceEnd });
@@ -225,11 +262,13 @@ export class ProgressPreloader extends Preloader {
             this._endTimeline.play();
         }
     }
-    /** Destroy the component */
+    /**
+     * Destroys the component and cleans up any remaining resources or animations.
+     */
     _destroy() {
         var _a, _b;
         super._destroy();
-        (_a = this._animationFrame) === null || _a === void 0 ? void 0 : _a.destroy();
+        (_a = this._raf) === null || _a === void 0 ? void 0 : _a.destroy();
         (_b = this._endTimeline) === null || _b === void 0 ? void 0 : _b.destroy();
     }
 }

package/lib/esm/components/ProgressPreloader/index.js.map

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

package/lib/esm/components/ProgressPreloader/utils/preloadCustomElement.js

@@ -1,4 +1,8 @@
+/**
+ * Retrieves the load progress of a custom resource element based on its properties or attributes.
+ */
 function getLoadProgress({ element, targetProgress, }) {
+    // Check if the element is marked as complete
     if (typeof element.isComplete !== 'undefined') {
         if (typeof element.isComplete === 'boolean' && element.isComplete) {
             return targetProgress;
@@ -8,6 +12,7 @@ function getLoadProgress({ element, targetProgress, }) {
         }
         return 0;
     }
+    // Check if the element is marked as loaded
     if (typeof element.isLoaded !== 'undefined') {
         if (typeof element.isLoaded === 'boolean' && element.isLoaded) {
             return targetProgress;
@@ -16,12 +21,13 @@ function getLoadProgress({ element, targetProgress, }) {
             return element.isLoaded;
         }
     }
+    // Check for a `data-is-loaded` attribute
     const isLoadedAttr = element.getAttribute('data-is-loaded');
     if (isLoadedAttr !== null &&
         isLoadedAttr !== '' &&
         isLoadedAttr !== 'false') {
         const isLoadedAttrNum = parseFloat(isLoadedAttr);
-        // if the value is non-numeric, we think that the resource is loaded
+        // If the value is non-numeric, treat the resource as loaded
         if (Number.isNaN(isLoadedAttrNum)) {
             return targetProgress;
         }
@@ -29,14 +35,19 @@ function getLoadProgress({ element, targetProgress, }) {
     }
     return 0;
 }
+/**
+ * Preloads a custom resource element by recursively checking its load progress until the target progress is reached.
+ */
 export function preloadCustomElement(data, instance) {
     return new Promise((resolve) => {
         const { targetProgress } = data;
         const loadProgress = getLoadProgress(data);
+        // If the load progress has reached or exceeded the target, resolve the promise
         if (loadProgress >= targetProgress) {
             resolve();
             return;
         }
+        // Recursively check the load progress every 50ms
         setTimeout(() => {
             if (instance.isDestroyed) {
                 return;

package/lib/esm/components/ProgressPreloader/utils/preloadCustomElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"preloadCustomElement.js","sourceRoot":"","sources":["../../../../../src/components/ProgressPreloader/utils/preloadCustomElement.ts"],"names":[],"mappings":"AAGA,SAAS,eAAe,CAAC,EACvB,OAAO,EACP,cAAc,GACyB;IACvC,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,WAAW,EAAE;QAC7C,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE;YACjE,OAAO,cAAc,CAAC;SACvB;QAED,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,EAAE;YAC1C,OAAO,OAAO,CAAC,UAAU,CAAC;SAC3B;QAED,OAAO,CAAC,CAAC;KACV;IAED,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,WAAW,EAAE;QAC3C,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE;YAC7D,OAAO,cAAc,CAAC;SACvB;QAED,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE;YACxC,OAAO,OAAO,CAAC,QAAQ,CAAC;SACzB;KACF;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAC5D,IACE,YAAY,KAAK,IAAI;QACrB,YAAY,KAAK,EAAE;QACnB,YAAY,KAAK,OAAO,EACxB;QACA,MAAM,eAAe,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;QAEjD,oEAAoE;QACpE,IAAI,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE;YACjC,OAAO,cAAc,CAAC;SACvB;QAED,OAAO,eAAe,CAAC;KACxB;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAA4C,EAC5C,QAA+B;IAE/B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAE3C,IAAI,YAAY,IAAI,cAAc,EAAE;YAClC,OAAO,EAAE,CAAC;YAEV,OAAO;SACR;QAED,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,QAAQ,CAAC,WAAW,EAAE;gBACxB,OAAO;aACR;YAED,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC;iBACjC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;iBACrB,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"preloadCustomElement.js","sourceRoot":"","sources":["../../../../../src/components/ProgressPreloader/utils/preloadCustomElement.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,SAAS,eAAe,CAAC,EACvB,OAAO,EACP,cAAc,GACyB;IACvC,6CAA6C;IAC7C,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,WAAW,EAAE;QAC7C,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE;YACjE,OAAO,cAAc,CAAC;SACvB;QAED,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,EAAE;YAC1C,OAAO,OAAO,CAAC,UAAU,CAAC;SAC3B;QAED,OAAO,CAAC,CAAC;KACV;IAED,2CAA2C;IAC3C,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,WAAW,EAAE;QAC3C,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE;YAC7D,OAAO,cAAc,CAAC;SACvB;QAED,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE;YACxC,OAAO,OAAO,CAAC,QAAQ,CAAC;SACzB;KACF;IAED,yCAAyC;IACzC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAC5D,IACE,YAAY,KAAK,IAAI;QACrB,YAAY,KAAK,EAAE;QACnB,YAAY,KAAK,OAAO,EACxB;QACA,MAAM,eAAe,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;QAEjD,4DAA4D;QAC5D,IAAI,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE;YACjC,OAAO,cAAc,CAAC;SACvB;QAED,OAAO,eAAe,CAAC;KACxB;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAA4C,EAC5C,QAA+B;IAE/B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAE3C,+EAA+E;QAC/E,IAAI,YAAY,IAAI,cAAc,EAAE;YAClC,OAAO,EAAE,CAAC;YAEV,OAAO;SACR;QAED,iDAAiD;QACjD,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,QAAQ,CAAC,WAAW,EAAE;gBACxB,OAAO;aACR;YAED,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC;iBACjC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;iBACrB,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC,CAAC,CAAC;AACL,CAAC"}