vevet 4.4.1 → 5.0.0

package/lib/types/core/global.d.ts

@@ -0,0 +1,85 @@
+import { IViewport, TViewportCallbacks, TViewportCallbacksOn } from './handlers/createViewport/types';
+import { ICoreProps } from './types';
+/** Vevet Core */
+export interface ICore extends IViewport {
+    /** Current Vevet version */
+    version: string;
+    /** Application properties */
+    props: ICoreProps;
+    /** Prefix used by Vevet for class names. */
+    prefix: string;
+    /** Is phone device */
+    phone: boolean;
+    /** Is tablet device */
+    tablet: boolean;
+    /** Is mobile device */
+    mobile: boolean;
+    /**
+     * OS name in lowercase. Popular results:
+     *
+     * - windows
+     * - macos
+     * - android
+     * - ios
+     */
+    osName: string;
+    /**
+     * Browser name in lowercase. Popular results:
+     *
+     * - chrome
+     * - edge-chromium
+     * - opera
+     * - firefox
+     * - safari
+     * - ios (safari & in-app safari)
+     * - crios (chrome in ios)
+     * - samsung
+     * - yandexbrowser
+     * - ios-webview
+     */
+    browserName: string;
+    /** Document */
+    doc: Document;
+    /** HTML element */
+    html: HTMLElement;
+    /** Body element */
+    body: HTMLElement;
+    /** If the page is loaded */
+    loaded: boolean;
+    /** List of viewport callbacks */
+    viewportCallbacks: TViewportCallbacks;
+    /**
+     * Add an event on page load.
+     *
+     * @example
+     * const destruct = vevet.onLoad(() => {
+     *   console.log('Page loaded');
+     * });
+     *
+     * // cancel the event
+     * destruct();
+     */
+    onLoad: (callback: () => void) => () => void;
+    /**
+     * Adds viewport callbacks.
+     *
+     * @example
+     *
+     * vevet.onViewport('width', () => console.log('width changed'));
+     *
+     * vevet.onViewport('height', () => console.log('height changed'));
+     *
+     * vevet.onViewport('both', () => console.log('both width and height changed'));
+     *
+     * vevet.onViewport('width_', () => console.log('only width changed'));
+     *
+     * vevet.onViewport('height_', () => console.log('only height changed'));
+     *
+     * const destruct = vevet.onViewport('any', () => console.log('any change'));
+     *
+     * // cancel the event
+     * destruct();
+     */
+    onViewport: TViewportCallbacksOn;
+}
+//# sourceMappingURL=global.d.ts.map

package/lib/types/core/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../../src/core/global.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,iBAAiB;AACjB,MAAM,WAAW,KAAM,SAAQ,SAAS;IACtC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAEhB,6BAA6B;IAC7B,KAAK,EAAE,UAAU,CAAC;IAElB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IAEf,sBAAsB;IACtB,KAAK,EAAE,OAAO,CAAC;IAEf,uBAAuB;IACvB,MAAM,EAAE,OAAO,CAAC;IAEhB,uBAAuB;IACvB,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;;;;;;;OAaG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,eAAe;IACf,GAAG,EAAE,QAAQ,CAAC;IAEd,mBAAmB;IACnB,IAAI,EAAE,WAAW,CAAC;IAElB,mBAAmB;IACnB,IAAI,EAAE,WAAW,CAAC;IAElB,4BAA4B;IAC5B,MAAM,EAAE,OAAO,CAAC;IAEhB,iCAAiC;IACjC,iBAAiB,EAAE,kBAAkB,CAAC;IAEtC;;;;;;;;;;OAUG;IACH,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAE7C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,UAAU,EAAE,oBAAoB,CAAC;CAClC"}

package/lib/types/core/handlers/createPageLoad/index.d.ts

@@ -0,0 +1,10 @@
+interface IProps {
+    prefix: string;
+    applyClassNames: boolean;
+}
+export declare function createPageLoad({ prefix, applyClassNames }: IProps): {
+    onLoad: (callback: () => void) => () => void;
+    getIsLoaded: () => boolean;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/types/core/handlers/createPageLoad/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/handlers/createPageLoad/index.ts"],"names":[],"mappings":"AAIA,UAAU,MAAM;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,MAAM;uBA6BtC,MAAM,IAAI;;EAWrC"}

package/lib/types/core/handlers/createPageLoad/types.d.ts

@@ -0,0 +1,5 @@
+import { ICallbacksMap } from '../../../base/Callbacks';
+export interface IPageLoadCallbacksMap extends ICallbacksMap {
+    loaded: undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/core/handlers/createPageLoad/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/handlers/createPageLoad/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,MAAM,EAAE,SAAS,CAAC;CACnB"}

package/lib/types/core/handlers/createViewport/index.d.ts

@@ -0,0 +1,13 @@
+import { IViewport, TViewportCallbacks } from './types';
+import { ICoreProps } from '../../../core/types';
+interface IProps {
+    prefix: string;
+    props: ICoreProps;
+    isMobile: boolean;
+}
+export declare function createViewport({ prefix, props, isMobile }: IProps): {
+    data: IViewport;
+    callbacks: TViewportCallbacks;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/types/core/handlers/createViewport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/handlers/createViewport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,UAAU,MAAM;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM;;;EAsJjE"}

package/lib/types/core/handlers/createViewport/types.d.ts

@@ -0,0 +1,68 @@
+import { Callbacks, ICallbacksMap } from '../../../base/Callbacks';
+export interface IViewportCallbacksMap extends ICallbacksMap {
+    /**
+     * When the width is changed regardless of the height
+     */
+    width: undefined;
+    /**
+     * When the height is changed regardless of the width
+     */
+    height: undefined;
+    /**
+     * When both the width and height are changed
+     */
+    both: undefined;
+    /**
+     * When only the width is changed
+     */
+    width_: undefined;
+    /**
+     * When only the height is changed
+     */
+    height_: undefined;
+    /**
+     * Any change
+     */
+    any: undefined;
+}
+export interface IViewport {
+    /** Current viewport width */
+    width: number;
+    /** Current viewport height */
+    height: number;
+    /**
+     * Current viewport small height
+     *
+     * Used to prevent layout shifts on some browsers such as In-App Safari.
+     */
+    sHeight: number;
+    /** Current viewport width divided by 100 */
+    vw: number;
+    /** Current viewport height divided by 100 */
+    vh: number;
+    /**
+     * Current viewport small height divided by 100 (svh).
+     *
+     * Used to prevent layout shifts on some browsers such as In-App Safari.
+     */
+    svh: number;
+    /** Root `font-size` in pixels (`1rem` to pixels) */
+    rem: number;
+    /** Is viewport in landscape mode */
+    landscape: boolean;
+    /** Is viewport in portrait mode */
+    portrait: boolean;
+    /** Device pixel ratio */
+    dpr: number;
+    /** Lower device pixel ratio (1 for desktop and maximum 2 for mobile devices) */
+    lowerDpr: number;
+    /** SM breakpoint is active */
+    sm: boolean;
+    /** MD breakpoint is active */
+    md: boolean;
+    /** LG breakpoint is active */
+    lg: boolean;
+}
+export type TViewportCallbacks = Callbacks<IViewportCallbacksMap>;
+export type TViewportCallbacksOn = TViewportCallbacks['on'];
+//# sourceMappingURL=types.d.ts.map

package/lib/types/core/handlers/createViewport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/handlers/createViewport/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IAEd,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IAEX,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IAEZ,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IAEnB,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAElB,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IAEZ,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IAEjB,8BAA8B;IAC9B,EAAE,EAAE,OAAO,CAAC;IAEZ,8BAA8B;IAC9B,EAAE,EAAE,OAAO,CAAC;IAEZ,8BAA8B;IAC9B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC,qBAAqB,CAAC,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC"}

package/lib/types/core/index.d.ts

@@ -0,0 +1,4 @@
+import { ICoreProps } from './types';
+import { ICore } from './global';
+export declare function Core(input: Partial<ICoreProps>): ICore;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,KAAK,CA8FtD"}

package/lib/types/core/scripts/presetCssVars.d.ts

@@ -0,0 +1,2 @@
+export declare const presetCssVars = "var presetVevetCss = function update() {\n  if (window.vevet5) {\n    return;\n  }\n\n  var doc = document.documentElement;\n\n  var styles = document.createElement('style');\n  styles.id = 'vevet_css_preset';\n  document.body.appendChild(styles);\n\n  var w = window.innerWidth;\n  var h = window.innerHeight;\n  var sh = doc.clientHeight;\n\n  styles.innerHTML = 'html { --vw: ' + w / 100 + 'px; --vh: ' + h / 100 + 'px; --svh: ' + sh / 100 + 'px; }';\n};\n\nwindow.addEventListener('resize', presetVevetCss);\n\npresetVevetCss();";
+//# sourceMappingURL=presetCssVars.d.ts.map

package/lib/types/core/scripts/presetCssVars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presetCssVars.d.ts","sourceRoot":"","sources":["../../../../src/core/scripts/presetCssVars.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,yhBAoBR,CAAC"}

package/lib/types/core/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Application configuration properties for initializing Vevet.
+ */
+export interface ICoreProps {
+    /**
+     * Medium breakpoint in pixels.
+     * When changing this property, you need to
+     * update the SASS variable: `$md`. The values must be equal.
+     * @default 1199
+     */
+    md: number;
+    /**
+     * Small breakpoint in pixels.
+     * When changing this property, you need to
+     * update the SASS variable: `$sm`. The values must be equal.
+     * @default 899
+     */
+    sm: number;
+    /**
+     * Timeout (in milliseconds) for viewport callbacks debouncing.
+     * @default 16
+     */
+    resizeDebounce: number;
+    /**
+     * If need to apply class names for the root element: such as browser, OS name, etc.
+     * @default false
+     */
+    applyClassNames: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B"}

package/lib/types/global/initVevet.d.ts

@@ -0,0 +1,13 @@
+import { ICore } from '../core/global';
+import { ICoreProps } from '../core/types';
+declare global {
+    interface Window {
+        vevet5: Readonly<ICore>;
+        VEVET_PROPS: Partial<ICoreProps>;
+    }
+}
+/**
+ * @group Utils
+ */
+export declare function initVevet(): Readonly<ICore>;
+//# sourceMappingURL=initVevet.d.ts.map

package/lib/types/global/initVevet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initVevet.d.ts","sourceRoot":"","sources":["../../../src/global/initVevet.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxB,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;KAClC;CACF;AAED;;GAEG;AACH,wBAAgB,SAAS,oBAWxB"}

package/lib/types/index.d.ts

@@ -1,20 +1,14 @@
-import { IVevet } from './Vevet/global';
-import { IVevetProps } from './Vevet/types';
+import { ICore } from './core/global';
+import { initVevet } from './global/initVevet';
+export { initVevet };
 /**
- * Vevet Application
+ * Vevet Core
  *
- * @see {@linkcode IVevet}
+ * @group Core
  */
-export declare const vevet: IVevet;
-declare global {
-    interface Window {
-        vevetApp: IVevet;
-        VEVET_PROPS: Partial<IVevetProps>;
-    }
-}
-export * from './Vevet/exported';
+export declare const vevet: Readonly<ICore>;
+export * from './core/exported';
 export * from './utils';
 export * from './base';
 export * from './components';
-export * from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAEP,CAAC;AAEZ,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;KACnC;CACF;AAED,cAAc,kBAAkB,CAAC;AAEjC,cAAc,SAAS,CAAC;AAExB,cAAc,QAAQ,CAAC;AAEvB,cAAc,cAAc,CAAC;AAE7B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB;;;;GAIG;AACH,eAAO,MAAM,KAAK,EAEb,QAAQ,CAAC,KAAK,CAAC,CAAC;AAErB,cAAc,iBAAiB,CAAC;AAEhC,cAAc,SAAS,CAAC;AAExB,cAAc,QAAQ,CAAC;AAEvB,cAAc,cAAc,CAAC"}

package/lib/types/internal/requiredProps.d.ts

@@ -0,0 +1,12 @@
+interface IModuleLike {
+    prefix: string;
+    destroy: () => void;
+}
+declare type TPrimitive = string | number | boolean | bigint | symbol | undefined | null;
+declare type TBuiltin = TPrimitive | Function | Date | Error | RegExp | Element | Window | IModuleLike;
+declare type TTRequiredProps<T> = T extends TBuiltin ? NonNullable<T> : T extends Map<infer K, infer V> ? Map<TTRequiredProps<K>, TTRequiredProps<V>> : T extends ReadonlyMap<infer K, infer V> ? ReadonlyMap<TTRequiredProps<K>, TTRequiredProps<V>> : T extends WeakMap<infer K, infer V> ? WeakMap<TTRequiredProps<K>, TTRequiredProps<V>> : T extends Set<infer U> ? Set<TTRequiredProps<U>> : T extends ReadonlySet<infer U> ? ReadonlySet<TTRequiredProps<U>> : T extends WeakSet<infer U> ? WeakSet<TTRequiredProps<U>> : T extends Promise<infer U> ? Promise<TTRequiredProps<U>> : T extends {} ? {
+    [K in keyof T]-?: TTRequiredProps<T[K]>;
+} : NonNullable<T>;
+export declare type TRequiredProps<T> = TTRequiredProps<T>;
+export {};
+//# sourceMappingURL=requiredProps.d.ts.map

package/lib/types/internal/requiredProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requiredProps.d.ts","sourceRoot":"","sources":["../../../src/internal/requiredProps.ts"],"names":[],"mappings":"AAAA,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,OAAO,MAAM,UAAU,GACnB,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,GACT,IAAI,CAAC;AAET,OAAO,MAAM,QAAQ,GACjB,UAAU,GACV,QAAQ,GACR,IAAI,GACJ,KAAK,GACL,MAAM,GACN,OAAO,GACP,MAAM,GACN,WAAW,CAAC;AAEhB,OAAO,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,GAChD,WAAW,CAAC,CAAC,CAAC,GACd,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC7B,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,GAC3C,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GACrC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,GACnD,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GACjC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,GAC/C,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GACpB,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GACvB,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAC5B,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAC/B,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GACxB,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAC3B,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GACxB,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAC3B,CAAC,SAAS,EAAE,GACV;KACG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACxC,GACD,WAAW,CAAC,CAAC,CAAC,CAAC;AAEnC,MAAM,CAAC,OAAO,MAAM,cAAc,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC"}

package/lib/types/utils/common/index.d.ts

@@ -1,4 +1,3 @@
-export * from './normalizedTimeoutCallback';
-export * from './PCancelable';
 export * from './uid';
+export * from './toPixels';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/utils/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC"}

package/lib/types/utils/common/toPixels.d.ts

@@ -0,0 +1,18 @@
+type TCache = Map<string | number, number>;
+declare global {
+    interface Window {
+        vevet5_toPixelsCache: TCache;
+    }
+}
+/**
+ * Transform value to pixels. Supported units: `px` | 'rem' | 'vw' | 'vh' | 'svh'.
+ *
+ * @group Utils
+ *
+ * @example
+ * toPixels('100px'); // => 100
+ * toPixels('1vw'); // => 19.20
+ */
+export declare function toPixels(value: string | number): number;
+export {};
+//# sourceMappingURL=toPixels.d.ts.map

package/lib/types/utils/common/toPixels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toPixels.d.ts","sourceRoot":"","sources":["../../../../src/utils/common/toPixels.ts"],"names":[],"mappings":"AAEA,KAAK,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,oBAAoB,EAAE,MAAM,CAAC;KAC9B;CACF;AAID;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,UA0C9C"}

package/lib/types/utils/common/uid.d.ts

@@ -4,10 +4,12 @@
  * 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.
  *
+ * @group Utils
+ *
  * @example
  * uid(); // => 'id_1'
  * uid('test'); // => 'test_2'
- * uid('0'); // => '0_3'
+ * uid(0); // => '0_3'
  */
-export declare function uid(prefix?: string): string;
+export declare function uid(prefix?: string | number): string;
 //# sourceMappingURL=uid.d.ts.map

package/lib/types/utils/common/uid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uid.d.ts","sourceRoot":"","sources":["../../../../src/utils/common/uid.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,GAAG,CAAC,MAAM,SAAO,GAAG,MAAM,CAIzC"}
+{"version":3,"file":"uid.d.ts","sourceRoot":"","sources":["../../../../src/utils/common/uid.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,MAAM,GAAE,MAAM,GAAG,MAAa,GAAG,MAAM,CAI1D"}

package/lib/types/utils/index.d.ts

@@ -1,6 +1,4 @@
 export * from './common';
-export * from './image';
 export * from './listeners';
 export * from './math';
-export * from './scroll';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC"}

package/lib/types/utils/listeners/addEventListener.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A utility function to add an event listener to a specified element.
+ *
+ * This function adds an event listener for the specified event type and
+ * returns a function that can be called to remove the event listener.
+ *
+ * @param element - The target element to which the event listener will be attached.
+ * @param target - The name of the event to listen for (e.g., 'click', 'scroll').
+ * @param listener - The callback function to execute when the event occurs.
+ * @param options - Optional parameters for the event listener.
+ *
+ * @group Utils
+ *
+ * @example
+ * const button = document.getElementById('myButton');
+ * const removeClickListener = addEventListener(button, 'click', (event) => {
+ *   console.log('Button clicked!');
+ * });
+ *
+ * // To remove the event listener later
+ * removeClickListener();
+ */
+export declare function addEventListener<Target extends keyof HTMLElementEventMap, Listener extends (event: DocumentEventMap[Target]) => void>(element: Document | Element | Window, target: Target, listener: Listener, options?: boolean | AddEventListenerOptions): () => void;
+//# sourceMappingURL=addEventListener.d.ts.map

package/lib/types/utils/listeners/addEventListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addEventListener.d.ts","sourceRoot":"","sources":["../../../../src/utils/listeners/addEventListener.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,SAAS,MAAM,mBAAmB,EACxC,QAAQ,SAAS,CAAC,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,IAAI,EAE1D,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,EACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,cAS5C"}

package/lib/types/utils/listeners/index.d.ts

@@ -1,3 +1,4 @@
-export * from './isIntersectionObserverSupported';
+export * from './addEventListener';
+export * from './normalizeWheel';
 export * from './onResize';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/utils/listeners/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/listeners/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/listeners/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/lib/types/utils/listeners/normalizeWheel.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Normalize wheel delta. This function is re-exported from `normalize-wheel` for convenience.
+ * It helps normalize the wheel event's delta values (spinX, spinY, pixelX, pixelY) across different browsers.
+ *
+ * @see https://www.npmjs.com/package/normalize-wheel
+ *
+ * @group Utils
+ *
+ * @example
+ *
+ * document.addEventListener('wheel', (event) => {
+ *   const normalized = normalizeWheel(event);
+ *   console.log(normalized);
+ *   // => { spinX: -0, spinY: 1.25, pixelX: -0, pixelY: 125 }
+ * });
+ */
+export declare function normalizeWheel(event: WheelEvent): {
+    spinX: number;
+    spinY: number;
+    pixelX: number;
+    pixelY: number;
+};
+/**
+ * Type definition for the normalized wheel event.
+ */
+export type TNormalizeWheel = ReturnType<typeof normalizeWheel>;
+//# sourceMappingURL=normalizeWheel.d.ts.map

package/lib/types/utils/listeners/normalizeWheel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeWheel.d.ts","sourceRoot":"","sources":["../../../../src/utils/listeners/normalizeWheel.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU;;;;;EAE/C;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/lib/types/utils/listeners/onResize.d.ts

@@ -1,65 +1,61 @@
-import { IViewportCallbackTypes } from '../../Vevet/events/createViewport/types';
-export type TOnResizeTarget = keyof IViewportCallbackTypes;
-export interface IOnResizeCallbackProps {
-    trigger: 'unknown' | 'Viewport' | 'ResizeObserver';
-}
-export type TOnResizeCallback = (props: IOnResizeCallbackProps) => void;
+import { IViewportCallbacksMap } from '../../core/exported';
+export type TOnResizeCallback = () => void;
 export interface IOnResizeProps {
-    /** Callback on resize */
-    onResize: TOnResizeCallback;
-    /** Observable element */
-    element?: Element | Element[] | false;
     /**
-     * Viewport target on resize.
-     * It will be used if `element` is not provided or `ResizeObserver` is not supported.
-     * @default 'any'
+     * Callback to invoke on resize.
+     */
+    callback: TOnResizeCallback;
+    /**
+     * Elements to observe for size changes. If null, only viewport events are used.
      */
-    viewportTarget?: TOnResizeTarget;
+    element?: Element | Element[] | null;
     /**
-     * Has both `viewport` callbacks and `ResizeObserver`
-     * @default false
+     * Target viewport property for resize events (enables viewport listeners).
      */
-    hasBothEvents?: boolean;
+    viewportTarget?: keyof IViewportCallbacksMap;
     /**
-     * Resize debounce timeout
+     * Debounce delay (ms) for resize events.
      * @default 0
      */
     resizeDebounce?: number;
+    /** Viewport callback name. Used for debugging */
+    name?: string;
 }
 export interface IOnResize {
-    /** Remove resize events */
+    /**
+     * Remove all resize listeners.
+     */
     remove: () => void;
-    /** Launch resize callback */
+    /**
+     * Trigger the resize callback immediately.
+     */
     resize: () => void;
-    /** Launch resize callback with debounce */
+    /**
+     * Trigger the resize callback with `resizeDebounce` delay.
+     */
     debounceResize: () => void;
-    /** `ResizeObserver` was used */
-    hasResizeObserver: boolean;
 }
 /**
- * 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.
+ * Adds resize listeners to elements (using `ResizeObserver`) and/or the viewport.
  *
- * @example
+ * @group Utils
  *
- * const handler = onResize({
- *   onResize: () => console.log('resize'),
- *   element: document.getElementById('app')!,
- *   viewportTarget: 'any',
- *   hasBothEvents: true,   // Trace both element and viewport sizes
- *   resizeDebounce: 100,
+ * @example
+ * const resizeWithElement = onResize({
+ *   callback: () => console.log('Element resized'),
+ *   element: document.getElementById('app'),
  * });
  *
- * // Trigger resize with debounce
- * handler.debounceResize();
- * handler.debounceResize();
- *
- * // Trigger resize without debounce
- * handler.resize();
+ * const resizeWithViewport = onResize({
+ *   callback: () => console.log('Viewport resized'),
+ *   viewportTarget: 'width',
+ * });
  *
- * // Remove listeners
- * handler.remove();
+ * const resizeWithBoth = onResize({
+ *   callback: () => console.log('Both resized'),
+ *   element: document.getElementById('app'),
+ *   viewportTarget: 'any',
+ * });
  */
-export declare function onResize({ onResize: handleResize, element, viewportTarget, hasBothEvents, resizeDebounce, }: IOnResizeProps): IOnResize;
+export declare function onResize({ callback, element, viewportTarget, resizeDebounce, name, }: IOnResizeProps): IOnResize;
 //# sourceMappingURL=onResize.d.ts.map

package/lib/types/utils/listeners/onResize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onResize.d.ts","sourceRoot":"","sources":["../../../../src/utils/listeners/onResize.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEjF,MAAM,MAAM,eAAe,GAAG,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,gBAAgB,CAAC;CACpD;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,yBAAyB;IACzB,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;IACtC;;;;OAIG;IACH,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,gCAAgC;IAChC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EAAE,YAAY,EACtB,OAAO,EACP,cAAsB,EACtB,aAAqB,EACrB,cAAkB,GACnB,EAAE,cAAc,GAAG,SAAS,CA0D5B"}
+{"version":3,"file":"onResize.d.ts","sourceRoot":"","sources":["../../../../src/utils/listeners/onResize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,MAAM,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,EAAE,iBAAiB,CAAC;IAE5B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,qBAAqB,CAAC;IAE7C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB;;OAEG;IACH,cAAc,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,OAAO,EACP,cAAc,EACd,cAAkB,EAClB,IAAI,GACL,EAAE,cAAc,GAAG,SAAS,CAsD5B"}

package/lib/types/utils/math/clamp.d.ts

@@ -1,15 +1,19 @@
 /**
- * Clamp the value between two points.
- * Ensures that `value` is between the minimum and maximum of the provided `scope`.
+ * Restricts a value to lie within a specified range.
  *
- * @param value - The value to be clamped.
- * @param scope - The range to clamp the value between, defaulting to [0, 1].
+ * Ensures that `value` is no less than `min` and no greater than `max`.
  *
- * @example
+ * @param {number} value - The input value to be clamped.
+ * @param {number} [min=0] - The lower bound of the range (default is 0).
+ * @param {number} [max=1] - The upper bound of the range (default is 1).
+ * @returns {number} - The clamped value within the range [min, max].
+ *
+ * @group Utils
  *
- * 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
+ * @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 declare function clamp(value: number, scope?: number[]): number;
+export declare function clamp(value: number, min?: number, max?: number): number;
 //# sourceMappingURL=clamp.d.ts.map

package/lib/types/utils/math/clamp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clamp.d.ts","sourceRoot":"","sources":["../../../../src/utils/math/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,WAAS,GAAG,MAAM,CAS3D"}
+{"version":3,"file":"clamp.d.ts","sourceRoot":"","sources":["../../../../src/utils/math/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAI,EAAE,GAAG,SAAI,UAEpD"}