vevet 3.20.0 → 4.0.0-beta.1

package/lib/cjs/utils/image/load.js

@@ -15,18 +15,18 @@ exports.loadImage = void 0;
 var PCancelable_1 = require("../common/PCancelable");
 var cachedImages = [];
 /**
- * Load an image
+ * Loads an image from a given source, either a URL or an HTMLImageElement.
+ * Supports caching and handling cross-origin requests.
  *
  * @example
- *
  * const loaderWithoutCache = loadImage('/image.jpg');
- *
  * loaderWithoutCache.then((img) => console.log(img)).catch(() => {});
  *
  * const loaderWithCache = loadImage('/image.jpg', {
  *   crossOrigin: 'anonymous',
  *   useCache: true,
  * });
+ * loaderWithCache.then((img) => console.log(img)).catch(() => {});
  */
 function loadImage(source, props) {
     var defaultLoadProps = {

package/lib/cjs/utils/image/load.js.map

@@ -1 +1 @@
-{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../../src/utils/image/load.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,0DAAyD;AAEzD,IAAM,YAAY,GAGZ,EAAE,CAAC;AAaT;;;;;;;;;;;;;GAaG;AACH,SAAgB,SAAS,CACvB,MAAiC,EACjC,KAAuB;IAEvB,IAAM,gBAAgB,GAA8B;QAClD,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,KAAK;KAChB,CAAC;IACF,IAAM,SAAS,yBACV,gBAAgB,GAChB,KAAK,CACT,CAAC;IAEF,IAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAElE,OAAO,IAAI,yBAAW,CACpB,UAAC,OAAwC,EAAE,MAAkB;QAC3D,IAAM,WAAW,GACf,SAAS,CAAC,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,UAAC,GAAG,IAAK,OAAA,GAAG,CAAC,GAAG,KAAK,QAAQ,EAApB,CAAoB,CAAC,CAAC;QAEzE,uBAAuB;QACvB,IAAI,WAAW,EAAE;YACf,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAE3B,OAAO;SACR;QAED,wBAAwB;QACxB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;YAC9B,IAAM,KAAG,GAAG,IAAI,KAAK,EAAE,CAAC;YAExB,KAAG,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;YAExC,KAAG,CAAC,MAAM,GAAG;gBACX,IAAI,SAAS,CAAC,QAAQ,EAAE;oBACtB,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAG,EAAE,CAAC,CAAC;iBAClD;gBAED,OAAO,CAAC,KAAG,CAAC,CAAC;YACf,CAAC,CAAC;YAEF,KAAG,CAAC,OAAO,GAAG,cAAM,OAAA,MAAM,EAAE,EAAR,CAAQ,CAAC;YAE7B,KAAG,CAAC,GAAG,GAAG,MAAM,CAAC;YAEjB,OAAO;SACR;QAED,kCAAkC;QAClC,IAAI,MAAM,YAAY,gBAAgB,EAAE;YACtC,IAAI,MAAM,CAAC,QAAQ,EAAE;gBACnB,OAAO,CAAC,MAAM,CAAC,CAAC;aACjB;iBAAM;gBACL,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE;oBAC9B,IAAI,SAAS,CAAC,QAAQ,EAAE;wBACtB,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;qBACrD;oBAED,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC;gBAEH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAM,OAAA,MAAM,EAAE,EAAR,CAAQ,CAAC,CAAC;aAClD;SACF;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAlED,8BAkEC"}
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../../src/utils/image/load.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,0DAAyD;AAEzD,IAAM,YAAY,GAGZ,EAAE,CAAC;AAiBT;;;;;;;;;;;;;GAaG;AACH,SAAgB,SAAS,CACvB,MAAiC,EACjC,KAAuB;IAEvB,IAAM,gBAAgB,GAA8B;QAClD,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEF,IAAM,SAAS,yBACV,gBAAgB,GAChB,KAAK,CACT,CAAC;IAEF,IAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAElE,OAAO,IAAI,yBAAW,CACpB,UAAC,OAAwC,EAAE,MAAkB;QAC3D,IAAM,WAAW,GACf,SAAS,CAAC,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,UAAC,GAAG,IAAK,OAAA,GAAG,CAAC,GAAG,KAAK,QAAQ,EAApB,CAAoB,CAAC,CAAC;QAEzE,uBAAuB;QACvB,IAAI,WAAW,EAAE;YACf,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAE3B,OAAO;SACR;QAED,wBAAwB;QACxB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;YAC9B,IAAM,KAAG,GAAG,IAAI,KAAK,EAAE,CAAC;YAExB,KAAG,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;YAExC,KAAG,CAAC,MAAM,GAAG;gBACX,IAAI,SAAS,CAAC,QAAQ,EAAE;oBACtB,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAG,EAAE,CAAC,CAAC;iBAClD;gBAED,OAAO,CAAC,KAAG,CAAC,CAAC;YACf,CAAC,CAAC;YAEF,KAAG,CAAC,OAAO,GAAG,cAAM,OAAA,MAAM,EAAE,EAAR,CAAQ,CAAC;YAE7B,KAAG,CAAC,GAAG,GAAG,MAAM,CAAC;YAEjB,OAAO;SACR;QAED,kCAAkC;QAClC,IAAI,MAAM,YAAY,gBAAgB,EAAE;YACtC,IAAI,MAAM,CAAC,QAAQ,EAAE;gBACnB,OAAO,CAAC,MAAM,CAAC,CAAC;aACjB;iBAAM;gBACL,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE;oBAC9B,IAAI,SAAS,CAAC,QAAQ,EAAE;wBACtB,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;qBACrD;oBAED,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC;gBAEH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAM,OAAA,MAAM,EAAE,EAAR,CAAQ,CAAC,CAAC;aAClD;SACF;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAnED,8BAmEC"}

package/lib/cjs/utils/image/pathsToProps.js

@@ -4,17 +4,23 @@ exports.imagePathsToProps = void 0;
 var getApp_1 = require("../internal/getApp");
 var sizesToSrcSet_1 = require("./sizesToSrcSet");
 /**
- * Transform image paths to properties
+ * Transforms image paths into properties for use in `src` and `srcSet` attributes.
+ * Supports adaptive images with WebP and fallback formats.
  *
- * @example
+ * Depending on WebP support, this function selects the most appropriate image for `src`
+ * and generates the `srcSet` if adaptive image sizes are provided.
  *
+ * @example
+ * // Basic usage with original, thumb, and thumbWebp paths
  * imagePathsToProps({
  *   original: '/original.jpg',
  *   thumb: '/thumb.jpg',
  *   thumbWebp: '/thumb.webp',
  * });
- * // => {"src":"/thumb.webp","srcSet":""}
+ * // => { src: '/thumb.webp', srcSet: '' }
  *
+ * @example
+ * // Usage with adaptive sizes for different screen widths
  * imagePathsToProps({
  *   original: '/original.jpg',
  *   thumb: '/thumb.jpg',
@@ -36,7 +42,7 @@ var sizesToSrcSet_1 = require("./sizesToSrcSet");
  *     2560: '/2560.webp',
  *   },
  * });
- * // => {"src":"/thumb.webp","srcSet":"/640.webp 640w, /750.webp 750w, /1024.webp 1024w, /1440.webp 1440w, /1920.webp 1920w, /2560.webp 2560w"}
+ * // => { src: '/thumb.webp', srcSet: '/640.webp 640w, /750.webp 750w, /1024.webp 1024w, /1440.webp 1440w, /1920.webp 1920w, /2560.webp 2560w' }
  */
 function imagePathsToProps(data) {
     var app = typeof window !== 'undefined' ? (0, getApp_1.getApp)() : undefined;

package/lib/cjs/utils/image/pathsToProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"pathsToProps.js","sourceRoot":"","sources":["../../../../src/utils/image/pathsToProps.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAC5C,iDAAqD;AAerD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,SAAgB,iBAAiB,CAAC,IAAuC;IACvE,IAAM,GAAG,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAA,eAAM,GAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjE,UAAU;IACV,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;IACxB,IAAI,IAAI,CAAC,KAAK,EAAE;QACd,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;KAClB;IACD,IAAI,GAAG,IAAI,GAAG,CAAC,eAAe,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE;QAClD,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;KACtB;IAED,cAAc;IACd,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,kBAAkB;IAClB,IAAI,GAAG,IAAI,GAAG,CAAC,eAAe,IAAI,WAAW,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE;QACzE,MAAM,GAAG,IAAA,kCAAkB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;KAC7C;SAAM,IAAI,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE;QAC1C,MAAM,GAAG,IAAA,kCAAkB,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;KACzC;IAED,OAAO;QACL,GAAG,KAAA;QACH,MAAM,QAAA;KACP,CAAC;AACJ,CAAC;AAzBD,8CAyBC"}
+{"version":3,"file":"pathsToProps.js","sourceRoot":"","sources":["../../../../src/utils/image/pathsToProps.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAC5C,iDAAqD;AAerD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,SAAgB,iBAAiB,CAAC,IAAuC;IACvE,IAAM,GAAG,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAA,eAAM,GAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjE,UAAU;IACV,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;IACxB,IAAI,IAAI,CAAC,KAAK,EAAE;QACd,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;KAClB;IACD,IAAI,GAAG,IAAI,GAAG,CAAC,eAAe,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE;QAClD,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;KACtB;IAED,cAAc;IACd,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,kBAAkB;IAClB,IAAI,GAAG,IAAI,GAAG,CAAC,eAAe,IAAI,WAAW,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE;QACzE,MAAM,GAAG,IAAA,kCAAkB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;KAC7C;SAAM,IAAI,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE;QAC1C,MAAM,GAAG,IAAA,kCAAkB,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;KACzC;IAED,OAAO;QACL,GAAG,KAAA;QACH,MAAM,QAAA;KACP,CAAC;AACJ,CAAC;AAzBD,8CAyBC"}

package/lib/cjs/utils/image/sizesToSrcSet.js

@@ -2,17 +2,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.imageSizesToSrcSet = void 0;
 /**
- * Transform image sizes to src set
+ * Transforms an object of image sizes into a `srcSet` string suitable for
+ * responsive images using the `srcSet` attribute.
  *
- * @example
+ * Each key in the `sizes` object represents a width in pixels, and the associated value is the image URL.
+ *
+ * @param {Record<string | number, string>} sizes - An object where the keys are widths (in pixels) and the values are URLs for the images.
+ * @returns {string} A `srcSet` string, where each image URL is followed by its width (e.g., "640w").
  *
+ * @example
  * imageSizesToSrcSet({
  *   640: '/640.jpg',
  *   750: '/750.jpg',
  *   1024: '/1024.jpg',
  *   1440: '/1440.jpg',
  * });
- *
  * // => "/640.jpg 640w, /750.jpg 750w, /1024.jpg 1024w, /1440.jpg 1440w"
  */
 function imageSizesToSrcSet(sizes) {

package/lib/cjs/utils/image/sizesToSrcSet.js.map

@@ -1 +1 @@
-{"version":3,"file":"sizesToSrcSet.js","sourceRoot":"","sources":["../../../../src/utils/image/sizesToSrcSet.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;GAaG;AACH,SAAgB,kBAAkB,CAAC,KAAsC;IACvE,IAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,IAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,UAAC,GAAG;QAC5B,IAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,EAAE;YACT,OAAO,UAAG,KAAK,cAAI,GAAG,MAAG,CAAC;SAC3B;QAED,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,MAAM,CAAC,UAAC,IAAI,IAAK,OAAA,CAAC,CAAC,IAAI,EAAN,CAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAZD,gDAYC"}
+{"version":3,"file":"sizesToSrcSet.js","sourceRoot":"","sources":["../../../../src/utils/image/sizesToSrcSet.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,kBAAkB,CAAC,KAAsC;IACvE,IAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,IAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,UAAC,GAAG;QAC5B,IAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,EAAE;YACT,OAAO,UAAG,KAAK,cAAI,GAAG,MAAG,CAAC;SAC3B;QAED,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,MAAM,CAAC,UAAC,IAAI,IAAK,OAAA,CAAC,CAAC,IAAI,EAAN,CAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAZD,gDAYC"}

package/lib/cjs/utils/internal/getApp.js

@@ -1,8 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getApp = void 0;
+var Vevet_1 = require("../../Vevet");
 function getApp() {
+    var _a;
+    if (!window.vevetApp) {
+        var appProps = (_a = window.VEVET_PROPS) !== null && _a !== void 0 ? _a : {};
+        var app = (0, Vevet_1.Vevet)(appProps);
+        window.vevetApp = app;
+    }
     return window.vevetApp;
 }
 exports.getApp = getApp;
+if (typeof window !== 'undefined') {
+    // @ts-ignore
+    // eslint-disable-next-line no-underscore-dangle
+    window.__vevetAutoInitialize = getApp();
+}
 //# sourceMappingURL=getApp.js.map

package/lib/cjs/utils/internal/getApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"getApp.js","sourceRoot":"","sources":["../../../../src/utils/internal/getApp.ts"],"names":[],"mappings":";;;AAAA,SAAgB,MAAM;IACpB,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC;AAFD,wBAEC"}
+{"version":3,"file":"getApp.js","sourceRoot":"","sources":["../../../../src/utils/internal/getApp.ts"],"names":[],"mappings":";;;AAAA,qCAAoC;AAEpC,SAAgB,MAAM;;IACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;QACpB,IAAM,QAAQ,GAAG,MAAA,MAAM,CAAC,WAAW,mCAAI,EAAE,CAAC;QAE1C,IAAM,GAAG,GAAG,IAAA,aAAK,EAAC,QAAQ,CAAC,CAAC;QAE5B,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC;KACvB;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC;AAVD,wBAUC;AAED,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;IACjC,aAAa;IACb,gDAAgD;IAChD,MAAM,CAAC,qBAAqB,GAAG,MAAM,EAAE,CAAC;CACzC"}

package/lib/cjs/utils/listeners/isIntersectionObserverSupported.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isIntersectionObserverSupported = void 0;
 /**
- * Check if intersection observer is supported
+ * Check if `IntersectionObserver` is supported
  */
 function isIntersectionObserverSupported() {
     if (!('IntersectionObserver' in window) ||

package/lib/cjs/utils/listeners/onResize.js

@@ -3,9 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.onResize = void 0;
 var getApp_1 = require("../internal/getApp");
 /**
- * Add events on resize.
- * If `element` is provided, `ResizeObserver` will be used (first callback will not be fired).
- * Otherwise, viewport callbacks will be used.
+ * Adds resize event listeners to either an element (using `ResizeObserver`) or the viewport (using custom resize events).
+ * It handles debouncing and allows the removal of listeners when no longer needed.
+ * If both `element` and `hasBothEvents` are provided, both `ResizeObserver` and viewport resize events will be used.
  *
  * @example
  *
@@ -13,18 +13,18 @@ var getApp_1 = require("../internal/getApp");
  *   onResize: () => console.log('resize'),
  *   element: document.getElementById('app')!,
  *   viewportTarget: 'any',
- *   hasBothEvents: true,   // trace both element and viewport sizes
+ *   hasBothEvents: true,   // Trace both element and viewport sizes
  *   resizeDebounce: 100,
  * });
  *
- * // resize with timeout called twice, but `onResize` will be called only once
+ * // Trigger resize with debounce
  * handler.debounceResize();
  * handler.debounceResize();
  *
- * // resize without timeout
+ * // Trigger resize without debounce
  * handler.resize();
  *
- * // remove listeners
+ * // Remove listeners
  * handler.remove();
  */
 function onResize(_a) {
@@ -39,9 +39,7 @@ function onResize(_a) {
         }
         timeout = setTimeout(function () { return handleResize(props !== null && props !== void 0 ? props : { trigger: 'unknown' }); }, delay !== null && delay !== void 0 ? delay : resizeDebounce);
     };
-    if (element &&
-        (element instanceof Element || Array.isArray(element)) &&
-        'ResizeObserver' in window) {
+    if (element && (element instanceof Element || Array.isArray(element))) {
         resizeObserver = new ResizeObserver(function () {
             if (isFirstResizeObserverCallback) {
                 isFirstResizeObserverCallback = false;

package/lib/cjs/utils/listeners/onResize.js.map

@@ -1 +1 @@
-{"version":3,"file":"onResize.js","sourceRoot":"","sources":["../../../../src/utils/listeners/onResize.ts"],"names":[],"mappings":";;;AAEA,6CAA4C;AA6C5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,QAAQ,CAAC,EAMR;QALL,YAAY,cAAA,EACtB,OAAO,aAAA,EACP,sBAAsB,EAAtB,cAAc,mBAAG,KAAK,KAAA,EACtB,qBAAqB,EAArB,aAAa,mBAAG,KAAK,KAAA,EACrB,sBAAkB,EAAlB,cAAc,mBAAG,CAAC,KAAA;IAElB,IAAI,OAAmC,CAAC;IACxC,IAAI,cAA0C,CAAC;IAC/C,IAAI,6BAA6B,GAAG,IAAI,CAAC;IAEzC,IAAI,gBAAuD,CAAC;IAE5D,IAAM,cAAc,GAAG,UAAC,KAA8B,EAAE,KAAc;QACpE,IAAI,OAAO,EAAE;YACX,YAAY,CAAC,OAAO,CAAC,CAAC;SACvB;QAED,OAAO,GAAG,UAAU,CAClB,cAAM,OAAA,YAAY,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAA7C,CAA6C,EACnD,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,cAAc,CACxB,CAAC;IACJ,CAAC,CAAC;IAEF,IACE,OAAO;QACP,CAAC,OAAO,YAAY,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtD,gBAAgB,IAAI,MAAM,EAC1B;QACA,cAAc,GAAG,IAAI,cAAc,CAAC;YAClC,IAAI,6BAA6B,EAAE;gBACjC,6BAA6B,GAAG,KAAK,CAAC;gBAEtC,OAAO;aACR;YAED,cAAc,CACZ,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAC7B,IAAA,eAAM,GAAE,CAAC,KAAK,CAAC,cAAc,GAAG,cAAc,CAC/C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC1B,OAAO,CAAC,OAAO,CAAC,UAAC,IAAI,IAAK,OAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,OAAO,CAAC,IAAI,CAAC,EAA7B,CAA6B,CAAC,CAAC;SAC1D;aAAM;YACL,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;SACjC;KACF;IAED,IAAI,aAAa,IAAI,CAAC,cAAc,EAAE;QACpC,gBAAgB,GAAG,IAAA,eAAM,GAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE;YACjE,OAAA,cAAc,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QAAvC,CAAuC,CACxC,CAAC;KACH;IAED,OAAO;QACL,MAAM,EAAE;YACN,IAAI,OAAO,EAAE;gBACX,YAAY,CAAC,OAAO,CAAC,CAAC;aACvB;YAED,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,UAAU,EAAE,CAAC;YAC7B,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAE,MAAM,EAAE,CAAC;QAC7B,CAAC;QACD,MAAM,EAAE,cAAM,OAAA,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAApC,CAAoC;QAClD,cAAc,EAAE,cAAM,OAAA,cAAc,EAAE,EAAhB,CAAgB;QACtC,iBAAiB,EAAE,CAAC,CAAC,cAAc;KACpC,CAAC;AACJ,CAAC;AApED,4BAoEC"}
+{"version":3,"file":"onResize.js","sourceRoot":"","sources":["../../../../src/utils/listeners/onResize.ts"],"names":[],"mappings":";;;AACA,6CAA4C;AA6C5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,QAAQ,CAAC,EAMR;QALL,YAAY,cAAA,EACtB,OAAO,aAAA,EACP,sBAAsB,EAAtB,cAAc,mBAAG,KAAK,KAAA,EACtB,qBAAqB,EAArB,aAAa,mBAAG,KAAK,KAAA,EACrB,sBAAkB,EAAlB,cAAc,mBAAG,CAAC,KAAA;IAElB,IAAI,OAAmC,CAAC;IACxC,IAAI,cAA0C,CAAC;IAC/C,IAAI,6BAA6B,GAAG,IAAI,CAAC;IAEzC,IAAI,gBAAuD,CAAC;IAE5D,IAAM,cAAc,GAAG,UAAC,KAA8B,EAAE,KAAc;QACpE,IAAI,OAAO,EAAE;YACX,YAAY,CAAC,OAAO,CAAC,CAAC;SACvB;QAED,OAAO,GAAG,UAAU,CAClB,cAAM,OAAA,YAAY,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAA7C,CAA6C,EACnD,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,cAAc,CACxB,CAAC;IACJ,CAAC,CAAC;IAEF,IAAI,OAAO,IAAI,CAAC,OAAO,YAAY,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE;QACrE,cAAc,GAAG,IAAI,cAAc,CAAC;YAClC,IAAI,6BAA6B,EAAE;gBACjC,6BAA6B,GAAG,KAAK,CAAC;gBAEtC,OAAO;aACR;YAED,cAAc,CACZ,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAC7B,IAAA,eAAM,GAAE,CAAC,KAAK,CAAC,cAAc,GAAG,cAAc,CAC/C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC1B,OAAO,CAAC,OAAO,CAAC,UAAC,IAAI,IAAK,OAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,OAAO,CAAC,IAAI,CAAC,EAA7B,CAA6B,CAAC,CAAC;SAC1D;aAAM;YACL,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;SACjC;KACF;IAED,IAAI,aAAa,IAAI,CAAC,cAAc,EAAE;QACpC,gBAAgB,GAAG,IAAA,eAAM,GAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE;YACjE,OAAA,cAAc,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QAAvC,CAAuC,CACxC,CAAC;KACH;IAED,OAAO;QACL,MAAM,EAAE;YACN,IAAI,OAAO,EAAE;gBACX,YAAY,CAAC,OAAO,CAAC,CAAC;aACvB;YAED,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,UAAU,EAAE,CAAC;YAC7B,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAE,MAAM,EAAE,CAAC;QAC7B,CAAC;QACD,MAAM,EAAE,cAAM,OAAA,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAApC,CAAoC;QAClD,cAAc,EAAE,cAAM,OAAA,cAAc,EAAE,EAAhB,CAAgB;QACtC,iBAAiB,EAAE,CAAC,CAAC,cAAc;KACpC,CAAC;AACJ,CAAC;AAhED,4BAgEC"}

package/lib/cjs/utils/math/clamp.js

@@ -2,22 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.clamp = void 0;
 /**
- * Clamp the value between two points
+ * Clamp the value between two points.
+ * Ensures that `value` is between the minimum and maximum of the provided `scope`.
+ *
+ * @param value - The value to be clamped.
+ * @param scope - The range to clamp the value between, defaulting to [0, 1].
  *
  * @example
  *
  * clamp(1.5, [0.1, 0.9]); // => 0.9
  * clamp(0.001, [0.1, 0.9]); // => 0.1
+ * clamp(0.5, [0, 1]); // => 0.5
  */
-function clamp(val, scope) {
+function clamp(value, scope) {
     if (scope === void 0) { scope = [0, 1]; }
-    if (val < scope[0]) {
+    if (value < scope[0]) {
         return scope[0];
     }
-    if (val > scope[1]) {
+    if (value > scope[1]) {
         return scope[1];
     }
-    return val;
+    return value;
 }
 exports.clamp = clamp;
 //# sourceMappingURL=clamp.js.map

package/lib/cjs/utils/math/clamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../../../src/utils/math/clamp.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,SAAgB,KAAK,CAAC,GAAW,EAAE,KAAc;IAAd,sBAAA,EAAA,SAAS,CAAC,EAAE,CAAC,CAAC;IAC/C,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;QAClB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;KACjB;IACD,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;QAClB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;KACjB;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AATD,sBASC"}
+{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../../../src/utils/math/clamp.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,SAAgB,KAAK,CAAC,KAAa,EAAE,KAAc;IAAd,sBAAA,EAAA,SAAS,CAAC,EAAE,CAAC,CAAC;IACjD,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;QACpB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;KACjB;IACD,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;QACpB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;KACjB;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AATD,sBASC"}

package/lib/cjs/utils/math/clampScope.js

@@ -4,7 +4,14 @@ exports.clampScope = void 0;
 var scoped_1 = require("./scoped");
 var clamp_1 = require("./clamp");
 /**
- * Get progress relatively to the scope and clamp it within two points
+ * Get progress relative to a given scope and then clamp it within another range.
+ *
+ * The function first scales the `value` relative to `scopeProp` using the `scoped` function,
+ * and then clamps the result within `clampProp` using the `clamp` function.
+ *
+ * @param value - The value to be scaled and clamped.
+ * @param scopeProp - The scope within which the value will be scaled.
+ * @param clampProp - The range to clamp the scaled value within.
  *
  * @example
  *

package/lib/cjs/utils/math/clampScope.js.map

@@ -1 +1 @@
-{"version":3,"file":"clampScope.js","sourceRoot":"","sources":["../../../../src/utils/math/clampScope.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAClC,iCAAgC;AAEhC;;;;;;;GAOG;AACH,SAAgB,UAAU,CACxB,KAAa,EACb,SAAkB,EAClB,SAAkB;IADlB,0BAAA,EAAA,aAAa,CAAC,EAAE,CAAC,CAAC;IAClB,0BAAA,EAAA,aAAa,CAAC,EAAE,CAAC,CAAC;IAElB,OAAO,IAAA,aAAK,EAAC,IAAA,eAAM,EAAC,KAAK,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC;AAND,gCAMC"}
+{"version":3,"file":"clampScope.js","sourceRoot":"","sources":["../../../../src/utils/math/clampScope.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAClC,iCAAgC;AAEhC;;;;;;;;;;;;;;GAcG;AACH,SAAgB,UAAU,CACxB,KAAa,EACb,SAAkB,EAClB,SAAkB;IADlB,0BAAA,EAAA,aAAa,CAAC,EAAE,CAAC,CAAC;IAClB,0BAAA,EAAA,aAAa,CAAC,EAAE,CAAC,CAAC;IAElB,OAAO,IAAA,aAAK,EAAC,IAAA,eAAM,EAAC,KAAK,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC;AAND,gCAMC"}

package/lib/cjs/utils/math/easing.js

@@ -35,7 +35,10 @@ Object.defineProperty(exports, "EaseOutQuart", { enumerable: true, get: function
 Object.defineProperty(exports, "EaseOutQuint", { enumerable: true, get: function () { return easing_progress_2.EaseOutQuint; } });
 Object.defineProperty(exports, "EaseOutSine", { enumerable: true, get: function () { return easing_progress_2.EaseOutSine; } });
 /**
- * Easing progress
+ * Calculates easing progress using a specified easing function, bezier curve, or custom easing function.
+ *
+ * @param progress - The current progress value (between 0 and 1).
+ * @param easingType - The easing type to apply. It can be a predefined easing function, a bezier array, or a custom easing function. Defaults to the global app's easing settings if available.
  *
  * @example
  *

package/lib/cjs/utils/math/easing.js.map

@@ -1 +1 @@
-{"version":3,"file":"easing.js","sourceRoot":"","sources":["../../../../src/utils/math/easing.ts"],"names":[],"mappings":";;;AAAA,mDAA2D;AAC3D,6CAA4C;AAE5C,mDA+ByB;AA9BvB,6GAAA,UAAU,OAAA;AACV,+GAAA,YAAY,OAAA;AACZ,6GAAA,UAAU,OAAA;AACV,8GAAA,WAAW,OAAA;AACX,gHAAA,aAAa,OAAA;AACb,6GAAA,UAAU,OAAA;AACV,gHAAA,aAAa,OAAA;AACb,kHAAA,eAAe,OAAA;AACf,gHAAA,aAAa,OAAA;AACb,iHAAA,cAAc,OAAA;AACd,mHAAA,gBAAgB,OAAA;AAChB,gHAAA,aAAa,OAAA;AACb,gHAAA,aAAa,OAAA;AACb,iHAAA,cAAc,OAAA;AACd,iHAAA,cAAc,OAAA;AACd,gHAAA,aAAa,OAAA;AACb,6GAAA,UAAU,OAAA;AACV,8GAAA,WAAW,OAAA;AACX,8GAAA,WAAW,OAAA;AACX,6GAAA,UAAU,OAAA;AACV,8GAAA,WAAW,OAAA;AACX,gHAAA,aAAa,OAAA;AACb,8GAAA,WAAW,OAAA;AACX,+GAAA,YAAY,OAAA;AACZ,iHAAA,cAAc,OAAA;AACd,8GAAA,WAAW,OAAA;AACX,8GAAA,WAAW,OAAA;AACX,+GAAA,YAAY,OAAA;AACZ,+GAAA,YAAY,OAAA;AACZ,8GAAA,WAAW,OAAA;AASb;;;;;;;;GAQG;AACI,IAAM,MAAM,GAA0B,UAC3C,QAAQ,EACR,UAA4C;;IAA5C,2BAAA,EAAA,mBAAa,MAAA,IAAA,eAAM,GAAE,0CAAE,KAAK,CAAC,MAAM,mCAAI,KAAK;IACzC,OAAA,IAAA,wBAAc,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;CAAA,CAAC;AAH7B,QAAA,MAAM,UAGuB"}
+{"version":3,"file":"easing.js","sourceRoot":"","sources":["../../../../src/utils/math/easing.ts"],"names":[],"mappings":";;;AAAA,mDAA2D;AAC3D,6CAA4C;AAE5C,mDA+ByB;AA9BvB,6GAAA,UAAU,OAAA;AACV,+GAAA,YAAY,OAAA;AACZ,6GAAA,UAAU,OAAA;AACV,8GAAA,WAAW,OAAA;AACX,gHAAA,aAAa,OAAA;AACb,6GAAA,UAAU,OAAA;AACV,gHAAA,aAAa,OAAA;AACb,kHAAA,eAAe,OAAA;AACf,gHAAA,aAAa,OAAA;AACb,iHAAA,cAAc,OAAA;AACd,mHAAA,gBAAgB,OAAA;AAChB,gHAAA,aAAa,OAAA;AACb,gHAAA,aAAa,OAAA;AACb,iHAAA,cAAc,OAAA;AACd,iHAAA,cAAc,OAAA;AACd,gHAAA,aAAa,OAAA;AACb,6GAAA,UAAU,OAAA;AACV,8GAAA,WAAW,OAAA;AACX,8GAAA,WAAW,OAAA;AACX,6GAAA,UAAU,OAAA;AACV,8GAAA,WAAW,OAAA;AACX,gHAAA,aAAa,OAAA;AACb,8GAAA,WAAW,OAAA;AACX,+GAAA,YAAY,OAAA;AACZ,iHAAA,cAAc,OAAA;AACd,8GAAA,WAAW,OAAA;AACX,8GAAA,WAAW,OAAA;AACX,+GAAA,YAAY,OAAA;AACZ,+GAAA,YAAY,OAAA;AACZ,8GAAA,WAAW,OAAA;AASb;;;;;;;;;;;GAWG;AACI,IAAM,MAAM,GAA0B,UAC3C,QAAQ,EACR,UAA4C;;IAA5C,2BAAA,EAAA,mBAAa,MAAA,IAAA,eAAM,GAAE,0CAAE,KAAK,CAAC,MAAM,mCAAI,KAAK;IACzC,OAAA,IAAA,wBAAc,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;CAAA,CAAC;AAH7B,QAAA,MAAM,UAGuB"}

package/lib/cjs/utils/math/inScope.js

@@ -2,7 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.inScope = void 0;
 /**
- * Check if the value is within the scope
+ * Check if a given value is within a defined scope (inclusive of the scope's boundaries).
+ *
+ * @param value - The value to check.
+ * @param scopeValue - An array defining the range [min, max] where `value` should be compared against.
  *
  * @example
  *
@@ -11,9 +14,9 @@ exports.inScope = void 0;
  * inScope(2, [0, 1]); // => false
  * inScope(-1, [0, 1]); // => false
  */
-function inScope(val, scopeValue) {
+function inScope(value, scopeValue) {
     if (scopeValue === void 0) { scopeValue = [0, 1]; }
-    return val >= scopeValue[0] && val <= scopeValue[1];
+    return value >= scopeValue[0] && value <= scopeValue[1];
 }
 exports.inScope = inScope;
 //# sourceMappingURL=inScope.js.map

package/lib/cjs/utils/math/inScope.js.map

@@ -1 +1 @@
-{"version":3,"file":"inScope.js","sourceRoot":"","sources":["../../../../src/utils/math/inScope.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,SAAgB,OAAO,CAAC,GAAW,EAAE,UAAmB;IAAnB,2BAAA,EAAA,cAAc,CAAC,EAAE,CAAC,CAAC;IACtD,OAAO,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAFD,0BAEC"}
+{"version":3,"file":"inScope.js","sourceRoot":"","sources":["../../../../src/utils/math/inScope.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,SAAgB,OAAO,CAAC,KAAa,EAAE,UAAmB;IAAnB,2BAAA,EAAA,cAAc,CAAC,EAAE,CAAC,CAAC;IACxD,OAAO,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAFD,0BAEC"}

package/lib/cjs/utils/math/lerp.js

@@ -2,16 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.lerp = void 0;
 /**
- * Linear interpolation
+ * Performs linear interpolation between the current and target values using an ease factor.
+ *
+ * Linear interpolation (LERP) calculates the intermediate value between two values (`current` and `target`)
+ * based on a given easing factor.
+ *
+ * @param current - The current value or starting point.
+ * @param target - The target value or end point.
+ * @param factor - The factor, typically between 0 and 1, which controls how fast the interpolation happens. A value closer to 0 makes the change slower, and a value closer to 1 makes it faster.
+ * @param approximationLeft - The threshold within which the difference between `current` and `target` is considered negligible, and the function returns the `target` value directly.
  *
  * @example
  *
  * lerp(0, 1, 0.4); // => 0.4
  * lerp(0.75, 0.8, 0.98); // => 0.799
  */
-function lerp(current, target, ease, approximationLeft) {
+function lerp(current, target, factor, approximationLeft) {
     if (approximationLeft === void 0) { approximationLeft = 0.001; }
-    var value = current * (1 - ease) + target * ease;
+    var value = current * (1 - factor) + target * factor;
     var difference = Math.abs(target - value);
     if (difference <= approximationLeft) {
         return target;

package/lib/cjs/utils/math/lerp.js.map

@@ -1 +1 @@
-{"version":3,"file":"lerp.js","sourceRoot":"","sources":["../../../../src/utils/math/lerp.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,SAAgB,IAAI,CAClB,OAAe,EACf,MAAc,EACd,IAAY,EACZ,iBAAyB;IAAzB,kCAAA,EAAA,yBAAyB;IAEzB,IAAM,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACnD,IAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IAE5C,IAAI,UAAU,IAAI,iBAAiB,EAAE;QACnC,OAAO,MAAM,CAAC;KACf;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAdD,oBAcC"}
+{"version":3,"file":"lerp.js","sourceRoot":"","sources":["../../../../src/utils/math/lerp.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,IAAI,CAClB,OAAe,EACf,MAAc,EACd,MAAc,EACd,iBAAyB;IAAzB,kCAAA,EAAA,yBAAyB;IAEzB,IAAM,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;IACvD,IAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IAE5C,IAAI,UAAU,IAAI,iBAAiB,EAAE;QACnC,OAAO,MAAM,CAAC;KACf;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAdD,oBAcC"}

package/lib/cjs/utils/math/normalizeNestedScope.js

@@ -2,12 +2,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeNestedScope = void 0;
 /**
- * Cast scope value relative to global scope
+ * Normalizes a nested scope (`innerScope`) relative to a larger `globalScope`.
+ *
+ * This function calculates the relative position of an inner scope within a global scope,
+ * adjusting the inner scope's values based on the size and position of the global scope.
+ *
+ * @param innerScope - The scope that is nested within the global scope. This is a range [start, end] relative to the global scope.
+ * @param globalScope - The global scope or range [start, end] that the inner scope should be normalized to.
  *
  * @example
  *
- * normalizeNestedScope([0, 1], [0.1, 0.8]); // => [0.1, 0.8]
- * normalizeNestedScope([0.2, 0.9], [0.1, 0.8]); // => [0.24, 0.73]
+ * normalizeNestedScope([0, 1], [0.1, 0.8]);
+ * // => [0.1, 0.8] // No change, since innerScope matches the full globalScope
+ *
+ * normalizeNestedScope([0.2, 0.9], [0.1, 0.8]);
+ * // => [0.24, 0.73] // Adjusted to fit within globalScope [0.1, 0.8]
  */
 function normalizeNestedScope(innerScope, globalScope) {
     var dist = globalScope[1] - globalScope[0];

package/lib/cjs/utils/math/normalizeNestedScope.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalizeNestedScope.js","sourceRoot":"","sources":["../../../../src/utils/math/normalizeNestedScope.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAClC,UAAuC,EACvC,WAAwC;IAExC,IAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAE7C,OAAO;QACL,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;QACrC,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;KACtC,CAAC;AACJ,CAAC;AAVD,oDAUC"}
+{"version":3,"file":"normalizeNestedScope.js","sourceRoot":"","sources":["../../../../src/utils/math/normalizeNestedScope.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,oBAAoB,CAClC,UAAuC,EACvC,WAAwC;IAExC,IAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAE7C,OAAO;QACL,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;QACrC,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;KACtC,CAAC;AACJ,CAAC;AAVD,oDAUC"}

package/lib/cjs/utils/math/scoped.js

@@ -2,17 +2,28 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scoped = void 0;
 /**
- * Get progress relatively to the scope.
+ * Get the progress of a value (`value`) relative to a given scope (`scope`).
+ *
+ * This function calculates how far along a value is within a specific range (scope),
+ * providing a normalized result between 0 and 1, depending on its position in the scope.
+ *
+ * @param value - The value for which to determine the relative progress within the scope.
+ * @param scope - The range (start, end) within which the value's progress will be calculated. Defaults to [0, 1].
  *
  * @example
  *
- * scoped(0.35, [0, 1]); // => 0.35
- * scoped(0.35, [0.25, 1]); // => 0.133
- * scoped(0.35, [0.25, 0.9]); // => 0.153
+ * scoped(0.35, [0, 1]);
+ * // => 0.35  // Progress of 0.35 within the full range [0, 1]
+ *
+ * scoped(0.35, [0.25, 1]);
+ * // => 0.133  // Progress of 0.35 within the range [0.25, 1]
+ *
+ * scoped(0.35, [0.25, 0.9]);
+ * // => 0.153  // Progress of 0.35 within the narrower range [0.25, 0.9]
  */
-function scoped(val, scopeValue) {
-    if (scopeValue === void 0) { scopeValue = [0, 1]; }
-    var result = (val - scopeValue[0]) / (scopeValue[1] - scopeValue[0]);
+function scoped(value, scope) {
+    if (scope === void 0) { scope = [0, 1]; }
+    var result = (value - scope[0]) / (scope[1] - scope[0]);
     return result;
 }
 exports.scoped = scoped;

package/lib/cjs/utils/math/scoped.js.map

@@ -1 +1 @@
-{"version":3,"file":"scoped.js","sourceRoot":"","sources":["../../../../src/utils/math/scoped.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,SAAgB,MAAM,CAAC,GAAW,EAAE,UAAmB;IAAnB,2BAAA,EAAA,cAAc,CAAC,EAAE,CAAC,CAAC;IACrD,IAAM,MAAM,GAAG,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvE,OAAO,MAAM,CAAC;AAChB,CAAC;AAJD,wBAIC"}
+{"version":3,"file":"scoped.js","sourceRoot":"","sources":["../../../../src/utils/math/scoped.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,MAAM,CAAC,KAAa,EAAE,KAAc;IAAd,sBAAA,EAAA,SAAS,CAAC,EAAE,CAAC,CAAC;IAClD,IAAM,MAAM,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAJD,wBAIC"}

package/lib/cjs/utils/math/spreadScope.js

@@ -2,12 +2,26 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.spreadScope = void 0;
 /**
- * Distribute scope progress among a certain quantity of timelines.
+ * Distribute the progress scope evenly across a specified number of timelines,
+ * with an optional overlap or shift between them.
+ *
+ * The function divides the range `[0, 1]` into segments, where each segment represents
+ * the progress of a timeline. The `shift` parameter allows overlap or space between
+ * the timelines. A `shift` of 0 means no overlap, while positive values introduce
+ * overlap between timelines.
+ *
+ * @param quantity - The number of timelines to distribute the progress scope over.
+ * @param shift - A value from `0` to `1` that determines how much overlap exists between timelines. A `shift` of 0 means no overlap, while a shift closer to `1` results in more overlap. Negative values could introduce gaps between the timelines.
  *
  * @example
  *
- * spreadScope(3, 0.1); // => [[0,0.35714285714285715],[0.32142857142857145,0.6785714285714286],[0.6428571428571429,1]]
- * spreadScope(3, 0.9); // => [[0,0.8333333333333334],[0.08333333333333331,0.9166666666666667],[0.16666666666666663,1]]
+ * spreadScope(3, 0.1);
+ * // => [[0, 0.357], [0.321, 0.678], [0.642, 1]]
+ * // Progress of 3 timelines with 0.1 shift (slight overlap)
+ *
+ * spreadScope(3, 0.9);
+ * // => [[0, 0.833], [0.083, 0.916], [0.167, 1]]
+ * // Progress of 3 timelines with 0.9 shift (more overlap)
  */
 function spreadScope(quantity, shift) {
     var timelines = [];

package/lib/cjs/utils/math/spreadScope.js.map

@@ -1 +1 @@
-{"version":3,"file":"spreadScope.js","sourceRoot":"","sources":["../../../../src/utils/math/spreadScope.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,QAAgB,EAAE,KAAa;IACzD,IAAM,SAAS,GAAe,EAAE,CAAC;IAEjC,4BAA4B;IAC5B,IAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;IAEzD,sBAAsB;IACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE;QAChD,IAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;QAC7C,IAAM,GAAG,GAAG,KAAK,GAAG,QAAQ,CAAC;QAC7B,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;KAC9B;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAdD,kCAcC"}
+{"version":3,"file":"spreadScope.js","sourceRoot":"","sources":["../../../../src/utils/math/spreadScope.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,WAAW,CAAC,QAAgB,EAAE,KAAa;IACzD,IAAM,SAAS,GAAe,EAAE,CAAC;IAEjC,4BAA4B;IAC5B,IAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;IAEzD,sBAAsB;IACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE;QAChD,IAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;QAC7C,IAAM,GAAG,GAAG,KAAK,GAAG,QAAQ,CAAC;QAC7B,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;KAC9B;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAdD,kCAcC"}

package/lib/cjs/utils/math/wrap.js

@@ -5,15 +5,21 @@ function conditionalReturn(value, func) {
     return value || value === 0 ? func(value) : func;
 }
 /**
- * Wrap values
+ * Wrap a value around a specified range.
+ * When the value exceeds the `max`, it wraps back to `min`, and when it's below `min`,
+ * it wraps around to `max`.
+ *
+ * @param min - The minimum value of the range.
+ * @param max - The maximum value of the range.
+ * @param value - The value to wrap around the range.
  *
  * @example
  *
  * wrap(0, 3, 0); // => 0
  * wrap(0, 3, 1); // => 1
  * wrap(0, 3, 2); // => 2
- * wrap(0, 3, 3); // => 0
- * wrap(0, 3, -1); // => 2
+ * wrap(0, 3, 3); // => 0 (wraps back to the start)
+ * wrap(0, 3, -1); // => 2 (wraps from below to the end)
  * wrap(0, 3, -2); // => 1
  * wrap(0, 3, -3); // => 0
  */

package/lib/cjs/utils/math/wrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrap.js","sourceRoot":"","sources":["../../../../src/utils/math/wrap.ts"],"names":[],"mappings":";;;AAAA,SAAS,iBAAiB,CAAC,KAAa,EAAE,IAA6B;IACrE,OAAO,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,IAAI,CAAC,GAAW,EAAE,GAAW,EAAE,KAAa;IAC1D,IAAM,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC;IAExB,OAAO,iBAAiB,CACtB,KAAK,EACL,UAAC,GAAG,IAAK,OAAA,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,EAA/C,CAA+C,CAC/C,CAAC;AACd,CAAC;AAPD,oBAOC"}
+{"version":3,"file":"wrap.js","sourceRoot":"","sources":["../../../../src/utils/math/wrap.ts"],"names":[],"mappings":";;;AAAA,SAAS,iBAAiB,CAAC,KAAa,EAAE,IAA6B;IACrE,OAAO,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,IAAI,CAAC,GAAW,EAAE,GAAW,EAAE,KAAa;IAC1D,IAAM,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC;IAExB,OAAO,iBAAiB,CACtB,KAAK,EACL,UAAC,GAAG,IAAK,OAAA,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,EAA/C,CAA+C,CAC/C,CAAC;AACd,CAAC;AAPD,oBAOC"}

package/lib/cjs/utils/scroll/getScrollValues.js

@@ -2,11 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getScrollValues = void 0;
 /**
- * Get scroll values of a certain element
+ * Get the scroll values (scrollTop and scrollLeft) of a specific element, window, or a custom scroll-like object.
+ * This function retrieves the vertical and horizontal scroll positions.
+ *
+ * @param selector - The element, window, or custom scroll-like object to get scroll values from. If no selector is provided, it defaults to `window`.
  *
  * @example
  *
+ * // Get scroll values of the window
  * getScrollValues(window); // => { scrollTop: 0, scrollLeft: 0 }
+ *
+ * // Get scroll values of a specific DOM element
+ * const element = document.querySelector('.scrollable');
+ * getScrollValues(element); // => { scrollTop: 100, scrollLeft: 50 }
+ *
+ * // Get scroll values of a custom scroll-like object
+ * const customScroll: IScrollLike = { scrollTop: 200, scrollLeft: 75 };
+ * getScrollValues(customScroll); // => { scrollTop: 200, scrollLeft: 75 }
  */
 function getScrollValues(selector) {
     if (selector === void 0) { selector = window; }

package/lib/cjs/utils/scroll/getScrollValues.js.map

@@ -1 +1 @@
-{"version":3,"file":"getScrollValues.js","sourceRoot":"","sources":["../../../../src/utils/scroll/getScrollValues.ts"],"names":[],"mappings":";;;AAOA;;;;;;GAMG;AACH,SAAgB,eAAe,CAC7B,QAA6D;IAA7D,yBAAA,EAAA,iBAA6D;IAE7D,IAAI,CAAC,QAAQ,EAAE;QACb,OAAO,SAAS,CAAC;KAClB;IAED,IAAM,SAAS,GACb,QAAQ,YAAY,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;IAEzE,IAAM,UAAU,GACd,QAAQ,YAAY,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;IAE1E,OAAO;QACL,SAAS,WAAA;QACT,UAAU,YAAA;KACX,CAAC;AACJ,CAAC;AAjBD,0CAiBC"}
+{"version":3,"file":"getScrollValues.js","sourceRoot":"","sources":["../../../../src/utils/scroll/getScrollValues.ts"],"names":[],"mappings":";;;AAOA;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,eAAe,CAC7B,QAA6D;IAA7D,yBAAA,EAAA,iBAA6D;IAE7D,IAAI,CAAC,QAAQ,EAAE;QACb,OAAO,SAAS,CAAC;KAClB;IAED,IAAM,SAAS,GACb,QAAQ,YAAY,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;IAEzE,IAAM,UAAU,GACd,QAAQ,YAAY,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;IAE1E,OAAO;QACL,SAAS,WAAA;QACT,UAAU,YAAA;KACX,CAAC;AACJ,CAAC;AAjBD,0CAiBC"}

package/lib/cjs/utils/scroll/isPageScrolling.js

@@ -7,6 +7,10 @@ var ids = [];
 var timeout = null;
 var listener;
 var isScrolling = false;
+/**
+ * Creates a scroll event listener if it doesn't exist and updates the `isScrolling` state.
+ * This listener detects if the user is scrolling and sets a timeout of 150ms to reset the `isScrolling` state.
+ */
 function createListener() {
     if (!listener) {
         listener = (0, vevet_dom_1.addEventListener)(window, 'scroll', function () {
@@ -20,22 +24,48 @@ function createListener() {
         });
     }
 }
+/**
+ * Destroys the scroll event listener when there are no more IDs associated with it..
+ */
 function destroyListener() {
     if (ids.length === 0) {
         listener === null || listener === void 0 ? void 0 : listener.remove();
         listener = undefined;
     }
 }
+/**
+ * Creates an instance to check whether the page is currently scrolling.
+ * This function manages the scroll state across multiple instances, ensuring the listener is created only once.
+ *
+ * @example
+ *
+ * const scrollChecker = createIsPageScrolling();
+ *
+ * // Check if page is scrolling
+ * const isPageScrolling = scrollChecker.get(); // => true or false
+ *
+ * // Destroy the instance when not needed
+ * scrollChecker.destroy();
+ */
 function createIsPageScrolling() {
     var id = (0, common_1.uid)('is-page-scrolling');
     ids.push(id);
     createListener();
+    /**
+     * Removes the current instance's ID from the tracking list and destroys the listener if no other IDs exist.
+     */
     function destroy() {
         ids = ids.filter(function (item) { return item !== id; });
         destroyListener();
     }
     return {
+        /**
+         * @returns {boolean} - Returns whether the page is currently scrolling.
+         */
         get: function () { return isScrolling; },
+        /**
+         * Destroys the scroll listener instance.
+         */
         destroy: destroy,
     };
 }

package/lib/cjs/utils/scroll/isPageScrolling.js.map

@@ -1 +1 @@
-{"version":3,"file":"isPageScrolling.js","sourceRoot":"","sources":["../../../../src/utils/scroll/isPageScrolling.ts"],"names":[],"mappings":";;;AAAA,uCAA6C;AAE7C,oCAAgC;AAEhC,IAAI,GAAG,GAAa,EAAE,CAAC;AAEvB,IAAI,OAAO,GAA0B,IAAI,CAAC;AAC1C,IAAI,QAAgC,CAAC;AAErC,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,SAAS,cAAc;IACrB,IAAI,CAAC,QAAQ,EAAE;QACb,QAAQ,GAAG,IAAA,4BAAgB,EAAC,MAAM,EAAE,QAAQ,EAAE;YAC5C,IAAI,OAAO,EAAE;gBACX,YAAY,CAAC,OAAO,CAAC,CAAC;aACvB;YAED,WAAW,GAAG,IAAI,CAAC;YAEnB,OAAO,GAAG,UAAU,CAAC;gBACnB,WAAW,GAAG,KAAK,CAAC;YACtB,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC,CAAC;KACJ;AACH,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE;QACpB,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,GAAG,SAAS,CAAC;KACtB;AACH,CAAC;AAED,SAAgB,qBAAqB;IACnC,IAAM,EAAE,GAAG,IAAA,YAAG,EAAC,mBAAmB,CAAC,CAAC;IACpC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,cAAc,EAAE,CAAC;IAEjB,SAAS,OAAO;QACd,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,UAAC,IAAI,IAAK,OAAA,IAAI,KAAK,EAAE,EAAX,CAAW,CAAC,CAAC;QACxC,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,OAAO;QACL,GAAG,EAAE,cAAM,OAAA,WAAW,EAAX,CAAW;QACtB,OAAO,SAAA;KACR,CAAC;AACJ,CAAC;AAfD,sDAeC"}
+{"version":3,"file":"isPageScrolling.js","sourceRoot":"","sources":["../../../../src/utils/scroll/isPageScrolling.ts"],"names":[],"mappings":";;;AAAA,uCAA6C;AAE7C,oCAAgC;AAEhC,IAAI,GAAG,GAAa,EAAE,CAAC;AAEvB,IAAI,OAAO,GAA0B,IAAI,CAAC;AAC1C,IAAI,QAAgC,CAAC;AAErC,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;;GAGG;AACH,SAAS,cAAc;IACrB,IAAI,CAAC,QAAQ,EAAE;QACb,QAAQ,GAAG,IAAA,4BAAgB,EAAC,MAAM,EAAE,QAAQ,EAAE;YAC5C,IAAI,OAAO,EAAE;gBACX,YAAY,CAAC,OAAO,CAAC,CAAC;aACvB;YAED,WAAW,GAAG,IAAI,CAAC;YAEnB,OAAO,GAAG,UAAU,CAAC;gBACnB,WAAW,GAAG,KAAK,CAAC;YACtB,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC,CAAC;KACJ;AACH,CAAC;AAED;;GAEG;AACH,SAAS,eAAe;IACtB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE;QACpB,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,GAAG,SAAS,CAAC;KACtB;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,qBAAqB;IACnC,IAAM,EAAE,GAAG,IAAA,YAAG,EAAC,mBAAmB,CAAC,CAAC;IACpC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,cAAc,EAAE,CAAC;IAEjB;;OAEG;IACH,SAAS,OAAO;QACd,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,UAAC,IAAI,IAAK,OAAA,IAAI,KAAK,EAAE,EAAX,CAAW,CAAC,CAAC;QACxC,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,OAAO;QACL;;WAEG;QACH,GAAG,EAAE,cAAM,OAAA,WAAW,EAAX,CAAW;QAEtB;;WAEG;QACH,OAAO,SAAA;KACR,CAAC;AACJ,CAAC;AAzBD,sDAyBC"}