vevet 3.19.2 → 4.0.0-beta.0

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAEhC,cAAc,SAAS,CAAC;AAExB,cAAc,eAAe,CAAC;AAE9B,cAAc,QAAQ,CAAC;AAEvB,cAAc,cAAc,CAAC;AAE7B,2BAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;AAEZ,cAAc,kBAAkB,CAAC;AAEjC,cAAc,SAAS,CAAC;AAExB,cAAc,QAAQ,CAAC;AAEvB,cAAc,cAAc,CAAC;AAE7B,cAAc,SAAS,CAAC"}

package/lib/esm/types/index.js

@@ -0,0 +1,3 @@
+export * from './general';
+export * from './utility';
+//# sourceMappingURL=index.js.map

package/lib/esm/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/lib/esm/utils/common/PCancelable.js

@@ -1,3 +1,19 @@
 import PCancelable from '@anton.bobrov/p-cancelable';
 export { PCancelable };
+/**
+ * This module imports and re-exports the `PCancelable` class from the `@anton.bobrov/p-cancelable` package.
+ *
+ * `PCancelable` provides a way to create promises that can be canceled. It is useful in scenarios where
+ * you want to cancel an ongoing asynchronous operation before it finishes.
+ *
+ * @example
+ * const p = new PCancelable((resolve, reject, onCancel) => {
+ *   const timeout = setTimeout(resolve, 1000);
+ *   onCancel(() => clearTimeout(timeout));
+ * });
+ *
+ * p.cancel(); // Cancels the operation
+ *
+ * @see {@link https://github.com/antonbobrov/p-cancelable}
+ */
 //# sourceMappingURL=PCancelable.js.map

package/lib/esm/utils/common/PCancelable.js.map

@@ -1 +1 @@
-{"version":3,"file":"PCancelable.js","sourceRoot":"","sources":["../../../../src/utils/common/PCancelable.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,4BAA4B,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"PCancelable.js","sourceRoot":"","sources":["../../../../src/utils/common/PCancelable.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,4BAA4B,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;;;;;;;;;;;;GAeG"}

package/lib/esm/utils/common/normalizedTimeoutCallback.js

@@ -1,11 +1,23 @@
 /**
- * Launch a function in a certain amount of time
- * If the `delay` argument is zero, the callback will be launched synchronously
+ * Launches a function after a specified delay. If the `delay` is zero,
+ * the callback is executed immediately (synchronously).
+ *
+ * @param callback - The function to be executed after the delay.
+ * @param delay - The amount of time (in milliseconds) to wait before executing the callback.
+ * If the delay is `0`, the callback will be executed synchronously.
+ *
+ * @returns {Object} An object with a `clear` method that can be used to cancel the timeout.
  *
  * @example
+ * // Executes the callback after 1 second (1000 milliseconds).
+ * normalizedTimeoutCallback(() => {
+ *   console.log('Executed after 1 second');
+ * }, 1000);
  *
- * normalizedTimeoutCallback(callback, 1000);
- * normalizedTimeoutCallback(callback, 0); // synchronous, without delay
+ * // Executes the callback immediately.
+ * normalizedTimeoutCallback(() => {
+ *   console.log('Executed synchronously');
+ * }, 0);
  */
 export function normalizedTimeoutCallback(callback, delay) {
     let timeout;
@@ -16,6 +28,9 @@ export function normalizedTimeoutCallback(callback, delay) {
         timeout = setTimeout(() => callback(), delay);
     }
     return {
+        /**
+         * Clears the timeout if it was set.
+         */
         clear: () => {
             if (timeout) {
                 clearTimeout(timeout);

package/lib/esm/utils/common/normalizedTimeoutCallback.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalizedTimeoutCallback.js","sourceRoot":"","sources":["../../../../src/utils/common/normalizedTimeoutCallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAkB,EAAE,KAAa;IACzE,IAAI,OAAmC,CAAC;IAExC,IAAI,KAAK,KAAK,CAAC,EAAE;QACf,QAAQ,EAAE,CAAC;KACZ;SAAM;QACL,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;KAC/C;IAED,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,OAAO,EAAE;gBACX,YAAY,CAAC,OAAO,CAAC,CAAC;aACvB;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"normalizedTimeoutCallback.js","sourceRoot":"","sources":["../../../../src/utils/common/normalizedTimeoutCallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAkB,EAAE,KAAa;IACzE,IAAI,OAAmC,CAAC;IAExC,IAAI,KAAK,KAAK,CAAC,EAAE;QACf,QAAQ,EAAE,CAAC;KACZ;SAAM;QACL,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;KAC/C;IAED,OAAO;QACL;;WAEG;QACH,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,OAAO,EAAE;gBACX,YAAY,CAAC,OAAO,CAAC,CAAC;aACvB;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/esm/utils/common/objectKeys.js

@@ -1,4 +1,14 @@
-/** Get object keys */
+/**
+ * Retrieves the keys of an object as an array of the object's keys.
+ *
+ * This function ensures that the returned keys are typed correctly based on the input object.
+ *
+ * @param object - The object from which the keys will be retrieved.
+ *
+ * @example
+ * const person = { name: 'Alice', age: 25 };
+ * const keys = objectKeys(person); // ['name', 'age']
+ */
 export function objectKeys(object) {
     return Object.keys(object);
 }

package/lib/esm/utils/common/objectKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"objectKeys.js","sourceRoot":"","sources":["../../../../src/utils/common/objectKeys.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,MAAM,UAAU,UAAU,CAAI,MAAS;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAa,CAAQ,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"objectKeys.js","sourceRoot":"","sources":["../../../../src/utils/common/objectKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAI,MAAS;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAa,CAAgB,CAAC;AACnD,CAAC"}

package/lib/esm/utils/common/pickObjectProps.js

@@ -1,9 +1,21 @@
 /**
- * Pick object properties
+ * Pick specific properties from an object.
+ *
+ * This function creates a new object composed of the properties listed in the `keys` array,
+ * extracted from the `source` object.
+ *
+ * @param source - The source object from which to pick properties.
+ * @param keys - An array of keys that should be picked from the source object.
  *
  * @example
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const result = pickObjectProps(obj, ['a', 'c']);
+ * // => { a: 1, c: 3 }
  *
- * pickObjectProps({ a: 1, b: 2, c: 3 }, ['a', 'c']); // => { a: 1, c: 3 }
+ * @example
+ * const user = { name: 'John', age: 30, email: 'john@example.com' };
+ * const picked = pickObjectProps(user, ['name', 'email']);
+ * // => { name: 'John', email: 'john@example.com' }
  */
 export function pickObjectProps(source, keys) {
     const result = {};

package/lib/esm/utils/common/pickObjectProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"pickObjectProps.js","sourceRoot":"","sources":["../../../../src/utils/common/pickObjectProps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAG7B,MAAS,EAAE,IAAS;IACpB,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"pickObjectProps.js","sourceRoot":"","sources":["../../../../src/utils/common/pickObjectProps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAG7B,MAAS,EAAE,IAAS;IACpB,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAoB,CAAC;AAC9B,CAAC"}

package/lib/esm/utils/common/times.js

@@ -1,10 +1,19 @@
 /**
- * Repeat something `n` times
+ * Repeats a function `n` times and returns an array of the results.
+ *
+ * The function executes the provided `callback` for each iteration, passing the current index and the total count as arguments.
+ * It collects and returns the results of the callback in an array.
+ *
+ * @param callback - The function to be called on each iteration. Receives the current index and the total count.
+ * @param count - The number of times to execute the callback.
  *
  * @example
+ * const result = times((index, count) => index / count, 5);
+ * // => [0, 0.2, 0.4, 0.6, 0.8]
  *
- * times((index, count) => index / count, 5);
- * // [0, 0.2, 0.4, 0.6, 0.8]
+ * @example
+ * const repeatedStrings = times(() => 'hello', 3);
+ * // => ['hello', 'hello', 'hello']
  */
 export function times(callback, count) {
     let index = 0;

package/lib/esm/utils/common/times.js.map

@@ -1 +1 @@
-{"version":3,"file":"times.js","sourceRoot":"","sources":["../../../../src/utils/common/times.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CACnB,QAA6C,EAC7C,KAAa;IAEb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAQ,EAAE,CAAC;IAErB,OAAO,KAAK,GAAG,KAAK,EAAE;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,CAAC;KACZ;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"times.js","sourceRoot":"","sources":["../../../../src/utils/common/times.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,KAAK,CACnB,QAA6C,EAC7C,KAAa;IAEb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAQ,EAAE,CAAC;IAErB,OAAO,KAAK,GAAG,KAAK,EAAE;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,CAAC;KACZ;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/esm/utils/common/uid.js

@@ -1,9 +1,11 @@
 let index = 0;
 /**
- * Generate a unique ID
+ * Generates a unique ID with an optional prefix.
  *
- * @example
+ * This function returns a string that combines a prefix (default is 'id') with a unique incrementing number.
+ * It ensures each call will return a unique identifier.
  *
+ * @example
  * uid(); // => 'id_1'
  * uid('test'); // => 'test_2'
  * uid('0'); // => '0_3'

package/lib/esm/utils/common/uid.js.map

@@ -1 +1 @@
-{"version":3,"file":"uid.js","sourceRoot":"","sources":["../../../../src/utils/common/uid.ts"],"names":[],"mappings":"AAAA,IAAI,KAAK,GAAG,CAAC,CAAC;AAEd;;;;;;;;GAQG;AACH,MAAM,UAAU,GAAG,CAAC,MAAM,GAAG,IAAI;IAC/B,KAAK,IAAI,CAAC,CAAC;IAEX,OAAO,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"uid.js","sourceRoot":"","sources":["../../../../src/utils/common/uid.ts"],"names":[],"mappings":"AAAA,IAAI,KAAK,GAAG,CAAC,CAAC;AAEd;;;;;;;;;;GAUG;AACH,MAAM,UAAU,GAAG,CAAC,MAAM,GAAG,IAAI;IAC/B,KAAK,IAAI,CAAC,CAAC;IAEX,OAAO,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -1,18 +1,18 @@
 import { PCancelable } from '../common/PCancelable';
 const 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(() => {});
  */
 export function loadImage(source, props) {
     const defaultLoadProps = {

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

@@ -1 +1 @@
-{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../../src/utils/image/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,MAAM,YAAY,GAGZ,EAAE,CAAC;AAaT;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CACvB,MAAiC,EACjC,KAAuB;IAEvB,MAAM,gBAAgB,GAA8B;QAClD,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,KAAK;KAChB,CAAC;IACF,MAAM,SAAS,mCACV,gBAAgB,GAChB,KAAK,CACT,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAElE,OAAO,IAAI,WAAW,CACpB,CAAC,OAAwC,EAAE,MAAkB,EAAE,EAAE;QAC/D,MAAM,WAAW,GACf,SAAS,CAAC,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,QAAQ,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,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;YAExB,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;YAExC,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE;gBAChB,IAAI,SAAS,CAAC,QAAQ,EAAE;oBACtB,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;iBAClD;gBAED,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC,CAAC;YAEF,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;YAE7B,GAAG,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,GAAG,EAAE;oBACnC,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,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;aAClD;SACF;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../../src/utils/image/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,MAAM,YAAY,GAGZ,EAAE,CAAC;AAiBT;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CACvB,MAAiC,EACjC,KAAuB;IAEvB,MAAM,gBAAgB,GAA8B;QAClD,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEF,MAAM,SAAS,mCACV,gBAAgB,GAChB,KAAK,CACT,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAElE,OAAO,IAAI,WAAW,CACpB,CAAC,OAAwC,EAAE,MAAkB,EAAE,EAAE;QAC/D,MAAM,WAAW,GACf,SAAS,CAAC,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,QAAQ,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,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;YAExB,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;YAExC,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE;gBAChB,IAAI,SAAS,CAAC,QAAQ,EAAE;oBACtB,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;iBAClD;gBAED,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC,CAAC;YAEF,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;YAE7B,GAAG,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,GAAG,EAAE;oBACnC,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,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;aAClD;SACF;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -1,16 +1,23 @@
+import { getApp } from '../internal/getApp';
 import { imageSizesToSrcSet } from './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',
@@ -32,10 +39,10 @@ import { imageSizesToSrcSet } from './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' }
  */
 export function imagePathsToProps(data) {
-    const app = typeof window !== 'undefined' ? window.vevetApp : undefined;
+    const app = typeof window !== 'undefined' ? getApp() : undefined;
     // get src
     let src = data.original;
     if (data.thumb) {

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

@@ -1 +1 @@
-{"version":3,"file":"pathsToProps.js","sourceRoot":"","sources":["../../../../src/utils/image/pathsToProps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAerD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAuC;IACvE,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,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,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;KAC7C;SAAM,IAAI,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE;QAC1C,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;KACzC;IAED,OAAO;QACL,GAAG;QACH,MAAM;KACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"pathsToProps.js","sourceRoot":"","sources":["../../../../src/utils/image/pathsToProps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAerD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAuC;IACvE,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,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,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;KAC7C;SAAM,IAAI,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE;QAC1C,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;KACzC;IAED,OAAO;QACL,GAAG;QACH,MAAM;KACP,CAAC;AACJ,CAAC"}

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

@@ -1,15 +1,19 @@
 /**
- * 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"
  */
 export function imageSizesToSrcSet(sizes) {

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

@@ -1 +1 @@
-{"version":3,"file":"sizesToSrcSet.js","sourceRoot":"","sources":["../../../../src/utils/image/sizesToSrcSet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAsC;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,EAAE;YACT,OAAO,GAAG,KAAK,IAAI,GAAG,GAAG,CAAC;SAC3B;QAED,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"sizesToSrcSet.js","sourceRoot":"","sources":["../../../../src/utils/image/sizesToSrcSet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAsC;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,EAAE;YACT,OAAO,GAAG,KAAK,IAAI,GAAG,GAAG,CAAC;SAC3B;QAED,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC"}

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

@@ -1,4 +1,16 @@
+import { Vevet } from '../../Vevet';
 export function getApp() {
+    var _a;
+    if (!window.vevetApp) {
+        const appProps = (_a = window.VEVET_PROPS) !== null && _a !== void 0 ? _a : {};
+        const app = Vevet(appProps);
+        window.vevetApp = app;
+    }
     return window.vevetApp;
 }
+if (typeof window !== 'undefined') {
+    // @ts-ignore
+    // eslint-disable-next-line no-underscore-dangle
+    window.__vevetAutoInitialize = getApp();
+}
 //# sourceMappingURL=getApp.js.map

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

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

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

@@ -1,5 +1,5 @@
 /**
- * Check if intersection observer is supported
+ * Check if `IntersectionObserver` is supported
  */
 export function isIntersectionObserverSupported() {
     if (!('IntersectionObserver' in window) ||

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

@@ -1,7 +1,8 @@
+import { getApp } from '../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
  *
@@ -9,18 +10,18 @@
  *   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();
  */
 export function onResize({ onResize: handleResize, element, viewportTarget = 'any', hasBothEvents = false, resizeDebounce = 0, }) {
@@ -34,15 +35,13 @@ export function onResize({ onResize: handleResize, element, viewportTarget = 'an
         }
         timeout = setTimeout(() => 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(() => {
             if (isFirstResizeObserverCallback) {
                 isFirstResizeObserverCallback = false;
                 return;
             }
-            debounceResize({ trigger: 'ResizeObserver' }, window.vevetApp.props.resizeDebounce + resizeDebounce);
+            debounceResize({ trigger: 'ResizeObserver' }, getApp().props.resizeDebounce + resizeDebounce);
         });
         if (Array.isArray(element)) {
             element.forEach((item) => resizeObserver === null || resizeObserver === void 0 ? void 0 : resizeObserver.observe(item));
@@ -52,7 +51,7 @@ export function onResize({ onResize: handleResize, element, viewportTarget = 'an
         }
     }
     if (hasBothEvents || !resizeObserver) {
-        viewportCallback = window.vevetApp.viewport.callbacks.add(viewportTarget, () => debounceResize({ trigger: 'Viewport' }));
+        viewportCallback = getApp().viewport.callbacks.add(viewportTarget, () => debounceResize({ trigger: 'Viewport' }));
     }
     return {
         remove: () => {

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

@@ -1 +1 @@
-{"version":3,"file":"onResize.js","sourceRoot":"","sources":["../../../../src/utils/listeners/onResize.ts"],"names":[],"mappings":"AA8CA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,QAAQ,EAAE,YAAY,EACtB,OAAO,EACP,cAAc,GAAG,KAAK,EACtB,aAAa,GAAG,KAAK,EACrB,cAAc,GAAG,CAAC,GACH;IACf,IAAI,OAAmC,CAAC;IACxC,IAAI,cAA0C,CAAC;IAC/C,IAAI,6BAA6B,GAAG,IAAI,CAAC;IAEzC,IAAI,gBAAuD,CAAC;IAE5D,MAAM,cAAc,GAAG,CAAC,KAA8B,EAAE,KAAc,EAAE,EAAE;QACxE,IAAI,OAAO,EAAE;YACX,YAAY,CAAC,OAAO,CAAC,CAAC;SACvB;QAED,OAAO,GAAG,UAAU,CAClB,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,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,GAAG,EAAE;YACvC,IAAI,6BAA6B,EAAE;gBACjC,6BAA6B,GAAG,KAAK,CAAC;gBAEtC,OAAO;aACR;YAED,cAAc,CACZ,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAC7B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,GAAG,cAAc,CACtD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC1B,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;SAC1D;aAAM;YACL,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;SACjC;KACF;IAED,IAAI,aAAa,IAAI,CAAC,cAAc,EAAE;QACpC,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CACvD,cAAc,EACd,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAC9C,CAAC;KACH;IAED,OAAO;QACL,MAAM,EAAE,GAAG,EAAE;YACX,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,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAClD,cAAc,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE;QACtC,iBAAiB,EAAE,CAAC,CAAC,cAAc;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"onResize.js","sourceRoot":"","sources":["../../../../src/utils/listeners/onResize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA6C5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,QAAQ,EAAE,YAAY,EACtB,OAAO,EACP,cAAc,GAAG,KAAK,EACtB,aAAa,GAAG,KAAK,EACrB,cAAc,GAAG,CAAC,GACH;IACf,IAAI,OAAmC,CAAC;IACxC,IAAI,cAA0C,CAAC;IAC/C,IAAI,6BAA6B,GAAG,IAAI,CAAC;IAEzC,IAAI,gBAAuD,CAAC;IAE5D,MAAM,cAAc,GAAG,CAAC,KAA8B,EAAE,KAAc,EAAE,EAAE;QACxE,IAAI,OAAO,EAAE;YACX,YAAY,CAAC,OAAO,CAAC,CAAC;SACvB;QAED,OAAO,GAAG,UAAU,CAClB,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,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,GAAG,EAAE;YACvC,IAAI,6BAA6B,EAAE;gBACjC,6BAA6B,GAAG,KAAK,CAAC;gBAEtC,OAAO;aACR;YAED,cAAc,CACZ,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAC7B,MAAM,EAAE,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,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;SAC1D;aAAM;YACL,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;SACjC;KACF;IAED,IAAI,aAAa,IAAI,CAAC,cAAc,EAAE;QACpC,gBAAgB,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,EAAE,CACtE,cAAc,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CACxC,CAAC;KACH;IAED,OAAO;QACL,MAAM,EAAE,GAAG,EAAE;YACX,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,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAClD,cAAc,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE;QACtC,iBAAiB,EAAE,CAAC,CAAC,cAAc;KACpC,CAAC;AACJ,CAAC"}

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

@@ -1,18 +1,23 @@
 /**
- * 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
  */
-export function clamp(val, scope = [0, 1]) {
-    if (val < scope[0]) {
+export function clamp(value, scope = [0, 1]) {
+    if (value < scope[0]) {
         return scope[0];
     }
-    if (val > scope[1]) {
+    if (value > scope[1]) {
         return scope[1];
     }
-    return val;
+    return value;
 }
 //# sourceMappingURL=clamp.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../../../src/utils/math/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,KAAK,GAAG,CAAC,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"}
+{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../../../src/utils/math/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC,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"}

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

@@ -1,7 +1,14 @@
 import { scoped } from './scoped';
 import { clamp } from './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/esm/utils/math/clampScope.js.map

@@ -1 +1 @@
-{"version":3,"file":"clampScope.js","sourceRoot":"","sources":["../../../../src/utils/math/clampScope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAElB,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"clampScope.js","sourceRoot":"","sources":["../../../../src/utils/math/clampScope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAElB,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC"}

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

@@ -1,7 +1,11 @@
 import { easing as easingProgress } from 'easing-progress';
+import { getApp } from '../internal/getApp';
 export { EaseInBack, EaseInBounce, EaseInCirc, EaseInCubic, EaseInElastic, EaseInExpo, EaseInOutBack, EaseInOutBounce, EaseInOutCirc, EaseInOutCubic, EaseInOutElastic, EaseInOutExpo, EaseInOutQuad, EaseInOutQuart, EaseInOutQuint, EaseInOutSine, EaseInQuad, EaseInQuart, EaseInQuint, EaseInSine, EaseOutBack, EaseOutBounce, EaseOutCirc, EaseOutCubic, EaseOutElastic, EaseOutExpo, EaseOutQuad, EaseOutQuart, EaseOutQuint, EaseOutSine, } from 'easing-progress';
 /**
- * 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
  *
@@ -9,5 +13,5 @@ export { EaseInBack, EaseInBounce, EaseInCirc, EaseInCubic, EaseInElastic, EaseI
  * easing(0.35, [.25, .1, .25, 1]); // => 0.604
  * easing(0.35, (value) => Math.sin(Math.PI * 0.5 * value)); // => 0.522
  */
-export const easing = (progress, easingType) => { var _a, _b; if (easingType === void 0) { easingType = (_b = (_a = window.vevetApp) === null || _a === void 0 ? void 0 : _a.props.easing) !== null && _b !== void 0 ? _b : false; } return easingProgress(progress, easingType); };
+export const easing = (progress, easingType) => { var _a, _b; if (easingType === void 0) { easingType = (_b = (_a = getApp()) === null || _a === void 0 ? void 0 : _a.props.easing) !== null && _b !== void 0 ? _b : false; } return easingProgress(progress, easingType); };
 //# sourceMappingURL=easing.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"easing.js","sourceRoot":"","sources":["../../../../src/utils/math/easing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAQzB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAA0B,CAC3C,QAAQ,EACR,UAAmD,EACnD,EAAE,0CADF,EAAA,mBAAa,MAAA,MAAM,CAAC,QAAQ,0CAAE,KAAK,CAAC,MAAM,mCAAI,KAAK,IAChD,OAAA,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA,EAAA,CAAC"}
+{"version":3,"file":"easing.js","sourceRoot":"","sources":["../../../../src/utils/math/easing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,aAAa,EACb,UAAU,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAQzB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,MAAM,GAA0B,CAC3C,QAAQ,EACR,UAA4C,EAC5C,EAAE,0CADF,EAAA,mBAAa,MAAA,MAAM,EAAE,0CAAE,KAAK,CAAC,MAAM,mCAAI,KAAK,IACzC,OAAA,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA,EAAA,CAAC"}

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

@@ -1,5 +1,8 @@
 /**
- * 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
  *
@@ -8,7 +11,7 @@
  * inScope(2, [0, 1]); // => false
  * inScope(-1, [0, 1]); // => false
  */
-export function inScope(val, scopeValue = [0, 1]) {
-    return val >= scopeValue[0] && val <= scopeValue[1];
+export function inScope(value, scopeValue = [0, 1]) {
+    return value >= scopeValue[0] && value <= scopeValue[1];
 }
 //# sourceMappingURL=inScope.js.map

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

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

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

@@ -1,13 +1,21 @@
 /**
- * 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
  */
-export function lerp(current, target, ease, approximationLeft = 0.001) {
-    const value = current * (1 - ease) + target * ease;
+export function lerp(current, target, factor, approximationLeft = 0.001) {
+    const value = current * (1 - factor) + target * factor;
     const difference = Math.abs(target - value);
     if (difference <= approximationLeft) {
         return target;

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

@@ -1 +1 @@
-{"version":3,"file":"lerp.js","sourceRoot":"","sources":["../../../../src/utils/math/lerp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAClB,OAAe,EACf,MAAc,EACd,IAAY,EACZ,iBAAiB,GAAG,KAAK;IAEzB,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACnD,MAAM,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"}
+{"version":3,"file":"lerp.js","sourceRoot":"","sources":["../../../../src/utils/math/lerp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,IAAI,CAClB,OAAe,EACf,MAAc,EACd,MAAc,EACd,iBAAiB,GAAG,KAAK;IAEzB,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;IACvD,MAAM,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"}

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

@@ -1,10 +1,19 @@
 /**
- * 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]
  */
 export function normalizeNestedScope(innerScope, globalScope) {
     const dist = globalScope[1] - globalScope[0];

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

@@ -1 +1 @@
-{"version":3,"file":"normalizeNestedScope.js","sourceRoot":"","sources":["../../../../src/utils/math/normalizeNestedScope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAuC,EACvC,WAAwC;IAExC,MAAM,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"}
+{"version":3,"file":"normalizeNestedScope.js","sourceRoot":"","sources":["../../../../src/utils/math/normalizeNestedScope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAuC,EACvC,WAAwC;IAExC,MAAM,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"}

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

@@ -1,14 +1,25 @@
 /**
- * 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]
  */
-export function scoped(val, scopeValue = [0, 1]) {
-    const result = (val - scopeValue[0]) / (scopeValue[1] - scopeValue[0]);
+export function scoped(value, scope = [0, 1]) {
+    const result = (value - scope[0]) / (scope[1] - scope[0]);
     return result;
 }
 //# sourceMappingURL=scoped.js.map