vevet 4.4.2 → 5.0.1

package/lib/types/base/Module/types.d.ts

@@ -1,50 +1,18 @@
-import { NCallbacks } from '../Callbacks/types';
-export declare namespace NModule {
-    /**
-     * Interface representing the properties that can change dynamically.
-     * These properties may be updated during window resize events or through
-     * the {@linkcode Module.changeProps} method.
-     */
-    interface IChangeableProps {
-        __fixHelperChangeableProps?: any;
-    }
-    /**
-     * Interface representing static properties that remain constant and do not change
-     * after initialization.
-     */
-    interface IStaticProps {
-        __fixHelperStaticProps?: any;
-    }
+import { ICallbacksMap } from '../Callbacks';
+export interface IModuleStaticProps {
+    __staticProp?: null;
+}
+export interface IModuleMutableProps {
+    __mutableProp?: null;
+}
+export interface IModuleCallbacksMap extends ICallbacksMap {
     /**
-     * Defines the available callback types for the module.
-     * These callbacks allow interaction with specific module events.
+     * Triggered when the module is destroyed.
      */
-    interface ICallbacksTypes extends NCallbacks.ITypes {
-        /**
-         * Triggered when the module is destroyed.
-         */
-        destroy: undefined;
-        /**
-         * Triggered when module properties are manually changed.
-         */
-        propsChange: undefined;
-        /**
-         * Triggered when module properties mutate due to responsive settings or other updates.
-         */
-        propsMutate: undefined;
-    }
+    destroy: undefined;
     /**
-     * Represents the class names to be removed from an element when the module is destroyed.
+     * Triggered when the module's properties are updated.
      */
-    interface IClassNamesToRemove {
-        /**
-         * The DOM element from which the class name should be removed.
-         */
-        element: Element;
-        /**
-         * The class name that should be removed from the element.
-         */
-        className: string;
-    }
+    props: undefined;
 }
 //# sourceMappingURL=types.d.ts.map

package/lib/types/base/Module/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/base/Module/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,yBAAiB,OAAO,CAAC;IACvB;;;;OAIG;IACH,UAAiB,gBAAgB;QAC/B,0BAA0B,CAAC,EAAE,GAAG,CAAC;KAClC;IAED;;;OAGG;IACH,UAAiB,YAAY;QAC3B,sBAAsB,CAAC,EAAE,GAAG,CAAC;KAC9B;IAED;;;OAGG;IACH,UAAiB,eAAgB,SAAQ,UAAU,CAAC,MAAM;QACxD;;WAEG;QACH,OAAO,EAAE,SAAS,CAAC;QAEnB;;WAEG;QACH,WAAW,EAAE,SAAS,CAAC;QAEvB;;WAEG;QACH,WAAW,EAAE,SAAS,CAAC;KACxB;IAED;;OAEG;IACH,UAAiB,mBAAmB;QAClC;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;KACnB;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/base/Module/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD;;OAEG;IACH,OAAO,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;CAClB"}

package/lib/types/base/Responsive/index.d.ts

@@ -0,0 +1,35 @@
+import { TResponsiveProps, TResponsiveRule, TResponsiveSource } from './types';
+export * from './types';
+export declare class Responsive<T extends TResponsiveSource> {
+    protected _source: T;
+    protected _rules: TResponsiveRule<T>[];
+    protected _onChange?: ((props: TResponsiveProps<T>) => void) | undefined;
+    /** Tracks whether the instance has been destroyed */
+    protected _isDestroyed: boolean;
+    /** Destroyable actions */
+    protected _destructors: (() => void)[];
+    /** Previously active breakpoints */
+    protected _prevBreakpoints: string;
+    /** Initial props */
+    protected _initProps: TResponsiveProps<T>;
+    /** Current props */
+    protected _props: TResponsiveProps<T>;
+    /** Current props */
+    get props(): TResponsiveProps<T>;
+    constructor(_source: T, _rules: TResponsiveRule<T>[], _onChange?: ((props: TResponsiveProps<T>) => void) | undefined);
+    /** Set initial props */
+    protected _fetchInitProps(): void;
+    /** Get active rules */
+    protected _getActiveRules(): TResponsiveRule<T>[];
+    /** Get responsive props */
+    protected _getResponsiveProps(): {};
+    /** Update properties */
+    protected _handleUpdate(): void;
+    /**
+     * Destroy the instance and clean up resources.
+     *
+     * The instance is destroyed automatically when it is used to mutate Module's props.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/base/Responsive/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG/E,cAAc,SAAS,CAAC;AAExB,qBAAa,UAAU,CAAC,CAAC,SAAS,iBAAiB;IAsB/C,SAAS,CAAC,OAAO,EAAE,CAAC;IACpB,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE;IACtC,SAAS,CAAC,SAAS,CAAC,GAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI;IAvB5D,qDAAqD;IACrD,SAAS,CAAC,YAAY,UAAS;IAE/B,0BAA0B;IAC1B,SAAS,CAAC,YAAY,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAM;IAE5C,oCAAoC;IACpC,SAAS,CAAC,gBAAgB,SAAQ;IAElC,oBAAoB;IACpB,SAAS,CAAC,UAAU,EAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAE3C,oBAAoB;IACpB,SAAS,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAEtC,oBAAoB;IACpB,IAAI,KAAK,wBAER;gBAGW,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,EAC5B,SAAS,CAAC,GAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,aAAA;IA6C5D,wBAAwB;IACxB,SAAS,CAAC,eAAe;IAkBzB,uBAAuB;IACvB,SAAS,CAAC,eAAe;IAoDzB,2BAA2B;IAC3B,SAAS,CAAC,mBAAmB;IAW7B,wBAAwB;IACxB,SAAS,CAAC,aAAa;IAqBvB;;;;OAIG;IACI,OAAO;CASf"}

package/lib/types/base/Responsive/types.d.ts

@@ -0,0 +1,10 @@
+import { Module } from '../Module';
+export type TResponsiveSource = Record<string, any> | Module;
+export type TResponsivePick<T> = T extends Module<any, any, any> ? Partial<ReturnType<T['_getMutable']>> : Partial<T>;
+export type TResponsiveQuery = 'tablet' | 'phone' | 'mobile' | 'non_mobile' | 'lg' | 'md' | 'sm' | 'landscape' | 'portrait' | (string & {});
+export type TResponsiveRule<T extends TResponsiveSource> = {
+    at: TResponsiveQuery;
+    props: TResponsivePick<T>;
+};
+export type TResponsiveProps<T extends TResponsiveSource> = T extends Module ? T['props'] : T;
+//# sourceMappingURL=types.d.ts.map

package/lib/types/base/Responsive/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/base/Responsive/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;AAE7D,MAAM,MAAM,eAAe,CAAC,CAAC,IAC3B,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAC3B,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC,CAAC;AAEjB,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,WAAW,GACX,UAAU,GACV,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,iBAAiB,IAAI;IACzD,EAAE,EAAE,gBAAgB,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,iBAAiB,IAAI,CAAC,SAAS,MAAM,GACxE,CAAC,CAAC,OAAO,CAAC,GACV,CAAC,CAAC"}

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

@@ -1,6 +1,4 @@
 export * from './Callbacks';
-export * from './Component';
 export * from './Module';
-export * from './MutableProps';
-export * from './Plugin';
+export * from './Responsive';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,58 @@
+import { TRequiredProps } from '../../internal/requiredProps';
+import { Module } from '../../base/Module';
+import { ICanvasCallbacksMap, ICanvasMutableProps, ICanvasStaticProps, TCanvasRender } from './types';
+export * from './types';
+/**
+ * A class for managing an HTML5 Canvas element and its 2D context.
+ *
+ * [Documentation](https://antonbobrov.github.io/vevet/docs/components/Canvas)
+ *
+ * @group Components
+ */
+export declare class Canvas<CallbacksMap extends ICanvasCallbacksMap = ICanvasCallbacksMap, StaticProps extends ICanvasStaticProps = ICanvasStaticProps, MutableProps extends ICanvasMutableProps = ICanvasMutableProps> extends Module<CallbacksMap, StaticProps, MutableProps> {
+    /** Get default static properties */
+    _getStatic(): TRequiredProps<StaticProps>;
+    /** Get default mutable properties */
+    _getMutable(): TRequiredProps<MutableProps>;
+    /** The canvas element created for rendering */
+    protected _canvas: HTMLCanvasElement;
+    /** The canvas element instance. */
+    get canvas(): HTMLCanvasElement;
+    /** The 2D rendering context. */
+    protected _ctx: CanvasRenderingContext2D;
+    /** Returns the 2D rendering context */
+    get ctx(): CanvasRenderingContext2D;
+    /** The current width of the canvas, considering the device pixel ratio (DPR) */
+    protected _width: number;
+    /** Canvas width (DPR applied). */
+    get width(): number;
+    /** Width without DPR scaling. */
+    get offsetWidth(): number;
+    /** The current height of the canvas, considering the device pixel ratio (DPR) */
+    protected _height: number;
+    /** Canvas height (DPR applied). */
+    get height(): number;
+    /** Height without DPR scaling. */
+    get offsetHeight(): number;
+    /** The current device pixel ratio (DPR) */
+    protected _dpr: number;
+    /** Current device pixel ratio. */
+    get dpr(): number;
+    /** Checks if the canvas is ready to render. */
+    get canRender(): boolean;
+    /**
+     * Constructor for the Ctx2D class.
+     */
+    constructor(props?: StaticProps & MutableProps);
+    /** Handle property mutations */
+    protected _handleProps(): void;
+    /** Triggers a canvas resize based on container or viewport dimensions. */
+    resize(): void;
+    /**
+     * Renders content on the canvas if it's ready.
+     *
+     * @param render - A function that performs the actual rendering on the canvas.
+     */
+    render(render: TCanvasRender): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Canvas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACd,MAAM,SAAS,CAAC;AAGjB,cAAc,SAAS,CAAC;AAExB;;;;;;GAMG;AACH,qBAAa,MAAM,CACjB,YAAY,SAAS,mBAAmB,GAAG,mBAAmB,EAC9D,WAAW,SAAS,kBAAkB,GAAG,kBAAkB,EAC3D,YAAY,SAAS,mBAAmB,GAAG,mBAAmB,CAC9D,SAAQ,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;IACvD,oCAAoC;IAC7B,UAAU,IAAI,cAAc,CAAC,WAAW,CAAC;IAYhD,qCAAqC;IAC9B,WAAW,IAAI,cAAc,CAAC,YAAY,CAAC;IASlD,+CAA+C;IAC/C,SAAS,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAErC,mCAAmC;IACnC,IAAI,MAAM,sBAET;IAED,gCAAgC;IAChC,SAAS,CAAC,IAAI,EAAE,wBAAwB,CAAC;IAEzC,uCAAuC;IACvC,IAAI,GAAG,6BAEN;IAED,gFAAgF;IAChF,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzB,kCAAkC;IAClC,IAAI,KAAK,WAER;IAED,iCAAiC;IACjC,IAAI,WAAW,WAEd;IAED,iFAAiF;IACjF,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAE1B,mCAAmC;IACnC,IAAI,MAAM,WAET;IAED,kCAAkC;IAClC,IAAI,YAAY,WAEf;IAED,2CAA2C;IAC3C,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IAEvB,kCAAkC;IAClC,IAAI,GAAG,WAEN;IAED,+CAA+C;IAC/C,IAAI,SAAS,YAEZ;IAED;;OAEG;gBACS,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY;IAwD9C,gCAAgC;IAChC,SAAS,CAAC,YAAY;IAMtB,0EAA0E;IACnE,MAAM;IAsCb;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,aAAa;CAepC"}

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

@@ -0,0 +1,104 @@
+import { IViewportCallbacksMap } from '../../core/exported';
+import { IModuleCallbacksMap, IModuleMutableProps, IModuleStaticProps } from '../../base/Module';
+/**
+ * Static properties for canvas configuration.
+ */
+export interface ICanvasStaticProps extends IModuleStaticProps {
+    /**
+     * Parent element used to determine canvas size. If `null`, it uses the viewport.
+     * @default null
+     */
+    container?: HTMLElement | null;
+    /**
+     * If `true`, appends the canvas to the `container`. Ignored if `container` is `null`.
+     * @default true
+     */
+    append?: boolean;
+    /**
+     * Automatically adjusts canvas size on initialization.
+     * @default true
+     */
+    resizeOnInit?: boolean;
+    /**
+     * Enables dynamic resizing based on viewport or container changes.
+     * @default false
+     */
+    resizeOnRuntime?: boolean;
+    /**
+     * Defines which dimension(s) should trigger a resize.
+     * @default 'any'
+     */
+    viewportTarget?: keyof IViewportCallbacksMap;
+    /**
+     * Debounce time (ms) for resize handling.
+     * @default 0
+     */
+    resizeDebounce?: number;
+}
+/**
+ * Mutable properties for canvas configuration.
+ */
+export interface ICanvasMutableProps extends IModuleMutableProps {
+    /**
+     * Canvas width. Use `'auto'` to match the container's width.
+     * @default 'auto'
+     */
+    width?: 'auto' | number;
+    /**
+     * Canvas height. Use `'auto'` to match the container's height.
+     * @default 'auto'
+     */
+    height?: 'auto' | number;
+    /**
+     * Device Pixel Ratio (DPR). Use `'auto'` for automatic detection.
+     * @default 'auto'
+     */
+    dpr?: 'auto' | number;
+}
+/**
+ * Event callbacks for canvas operations.
+ */
+export interface ICanvasCallbacksMap extends IModuleCallbacksMap {
+    /**
+     * Fires when the canvas is resized.
+     */
+    resize: undefined;
+}
+/**
+ * Arguments provided to the canvas render function.
+ */
+export interface ICanvasRenderArg {
+    /**
+     * 2D rendering context of the canvas.
+     */
+    ctx: CanvasRenderingContext2D;
+    /**
+     * Canvas width, adjusted for DPR.
+     */
+    width: number;
+    /**
+     * Canvas height, adjusted for DPR.
+     */
+    height: number;
+    /**
+     * Device pixel ratio used for rendering.
+     */
+    dpr: number;
+    /**
+     * Canvas offset width (before DPR adjustment).
+     */
+    offsetWidth: number;
+    /**
+     * Canvas offset height (before DPR adjustment).
+     */
+    offsetHeight: number;
+    /**
+     * HTMLCanvasElement associated with the canvas.
+     */
+    canvas: HTMLCanvasElement;
+}
+/**
+ * Function type for canvas rendering.
+ */
+export type TCanvasRender = (props: ICanvasRenderArg) => void;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/Canvas/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D;;;OAGG;IACH,SAAS,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAE/B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,qBAAqB,CAAC;IAE7C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,EAAE,wBAAwB,CAAC;IAE9B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC"}

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

@@ -0,0 +1,34 @@
+import { TRequiredProps } from '../../internal/requiredProps';
+import { ICanvasMediaCallbacksMap, ICanvasMediaMutableProps, ICanvasMediaStaticProps } from './types';
+import { Canvas, ICanvasRenderArg } from '../Canvas';
+export * from './types';
+/**
+ * The `CanvasMedia` class allows pre-rendering of media (such as images or video) onto a canvas.
+ * This can be useful for reducing payloads by preparing the media for further use in a more optimized form.
+ *
+ * [Documentation](https://antonbobrov.github.io/vevet/docs/components/CanvasMedia)
+ *
+ * @group Components
+ */
+export declare class CanvasMedia<CallbacksMap extends ICanvasMediaCallbacksMap = ICanvasMediaCallbacksMap, StaticProps extends ICanvasMediaStaticProps = ICanvasMediaStaticProps, MutableProps extends ICanvasMediaMutableProps = ICanvasMediaMutableProps> extends Canvas<CallbacksMap, StaticProps, MutableProps> {
+    /** Get default static properties */
+    _getStatic(): TRequiredProps<StaticProps>;
+    /** Get default mutable properties */
+    _getMutable(): TRequiredProps<MutableProps>;
+    constructor(props?: StaticProps & MutableProps);
+    /** Checks if the media element has the `requestVideoFrameCallback` method */
+    protected get hasRequestVideoFrameCallback(): boolean;
+    /** Add media events */
+    protected _setMediaEvents(): void;
+    /** Resize the canvas */
+    resize(): void;
+    /** Auto rendering for videos */
+    protected _requestVideoFrame(): void;
+    /** Pre-renders the media resource onto the canvas. */
+    render(): void;
+    /**
+     * Prerenders the media onto the canvas using the specified positioning rule.
+     */
+    protected _prerender({ width, height, ctx }: ICanvasRenderArg): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/CanvasMedia/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGrD,cAAc,SAAS,CAAC;AAExB;;;;;;;GAOG;AACH,qBAAa,WAAW,CACtB,YAAY,SAAS,wBAAwB,GAAG,wBAAwB,EACxE,WAAW,SAAS,uBAAuB,GAAG,uBAAuB,EACrE,YAAY,SAAS,wBAAwB,GAAG,wBAAwB,CACxE,SAAQ,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;IACvD,oCAAoC;IAC7B,UAAU,IAAI,cAAc,CAAC,WAAW,CAAC;IAOhD,qCAAqC;IAC9B,WAAW,IAAI,cAAc,CAAC,YAAY,CAAC;gBAOtC,KAAK,CAAC,EAAE,WAAW,GAAG,YAAY;IAM9C,6EAA6E;IAC7E,SAAS,KAAK,4BAA4B,YAEzC;IAED,uBAAuB;IACvB,SAAS,CAAC,eAAe;IAsBzB,wBAAwB;IACjB,MAAM;IAMb,gCAAgC;IAChC,SAAS,CAAC,kBAAkB;IAc5B,sDAAsD;IAC/C,MAAM;IAIb;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,gBAAgB;CAkC9D"}

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

@@ -0,0 +1,37 @@
+import { Canvas } from '../Canvas';
+import { ICanvasCallbacksMap, ICanvasMutableProps, ICanvasStaticProps } from '../Canvas/types';
+/**
+ * Static properties for the CanvasMedia class.
+ */
+export interface ICanvasMediaStaticProps extends ICanvasStaticProps {
+    /**
+     * The media element to be rendered.
+     * Accepts a Canvas instance or common media elements like images and videos.
+     */
+    media: Canvas | HTMLImageElement | SVGImageElement | HTMLVideoElement | HTMLCanvasElement;
+    /**
+     * If `true`, video elements will automatically render on each frame update.
+     * @default true
+     */
+    autoRenderVideo?: boolean;
+}
+/**
+ * Extended mutable properties for the CanvasMedia class.
+ */
+export interface ICanvasMediaMutableProps extends ICanvasMutableProps {
+    /**
+     * Defines how the media element is positioned within the canvas.
+     * @default 'cover'
+     */
+    rule?: 'cover' | 'contain' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+}
+/**
+ * Extended callbacks map for the CanvasMedia class.
+ */
+export interface ICanvasMediaCallbacksMap extends ICanvasCallbacksMap {
+    /**
+     * Fires after the media element has been rendered onto the canvas.
+     */
+    render: undefined;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/CanvasMedia/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE;;;OAGG;IACH,KAAK,EACD,MAAM,GACN,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,iBAAiB,CAAC;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE;;;OAGG;IACH,IAAI,CAAC,EACD,OAAO,GACP,SAAS,GACT,UAAU,GACV,WAAW,GACX,aAAa,GACb,cAAc,GACd,QAAQ,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB"}

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

@@ -0,0 +1,126 @@
+import { TRequiredProps } from '../../internal/requiredProps';
+import { ICursorCallbacksMap, ICursorFullCoords, ICursorHoveredElement, ICursorMutableProps, ICursorStaticProps, ICursorType } from './types';
+import { Module } from '../../base/Module';
+import { Raf } from '../Raf';
+export * from './types';
+/**
+ * A customizable custom cursor component with smooth animations and hover interactions.
+ * Supports dynamic appearance changes and enhanced user interaction.
+ *
+ * [Documentation](https://antonbobrov.github.io/vevet/docs/components/Cursor)
+ *
+ * @group Components
+ */
+export declare class Cursor<CallbacksMap extends ICursorCallbacksMap = ICursorCallbacksMap, StaticProps extends ICursorStaticProps = ICursorStaticProps, MutableProps extends ICursorMutableProps = ICursorMutableProps> extends Module<CallbacksMap, StaticProps, MutableProps> {
+    /** Get default static properties */
+    _getStatic(): TRequiredProps<StaticProps>;
+    /** Get default mutable properties */
+    _getMutable(): TRequiredProps<MutableProps>;
+    /**
+     * Classname prefix for styling elements.
+     */
+    get prefix(): string;
+    /** The cursor container */
+    get container(): Element | Window;
+    /** Returns the DOM parent for the cursor element. */
+    get domContainer(): HTMLElement;
+    /** The outer element of the custom cursor */
+    protected _outer: HTMLElement;
+    /**
+     * The outer element of the custom cursor.
+     * This is the visual element that represents the cursor on screen.
+     */
+    get outer(): HTMLElement;
+    /** The inner element of the custom cursor. */
+    protected _inner: HTMLElement;
+    /**
+     * The inner element of the custom cursor.
+     * This element is nested inside the outer element and can provide additional styling.
+     */
+    get inner(): HTMLElement;
+    /** The currently hovered element */
+    protected _hoveredElement?: ICursorHoveredElement;
+    /**
+     * The currently hovered element.
+     * Stores information about the element that the cursor is currently interacting with.
+     */
+    get hoveredElement(): ICursorHoveredElement | undefined;
+    set hoveredElement(value: ICursorHoveredElement | undefined);
+    /** Request animation frame handler */
+    protected _raf: Raf;
+    /** The current coordinates */
+    protected _coords: ICursorFullCoords;
+    /**
+     * The current coordinates (x, y, width, height).
+     * These are updated during cursor movement.
+     */
+    get coords(): ICursorFullCoords;
+    /** Target coordinates of the cursor (without smooth interpolation). */
+    protected _targetCoords: ICursorFullCoords;
+    /** Target coordinates of the cursor (without smooth interpolation). */
+    get targetCoords(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Defines if the cursor has been moved after initialization */
+    protected _isFirstMove: boolean;
+    /** Cursor types */
+    protected _types: ICursorType[];
+    /** Active cursor types */
+    protected _activeTypes: string[];
+    constructor(props?: StaticProps & MutableProps);
+    /** Creates the custom cursor and appends it to the DOM. */
+    protected _createElements(): void;
+    /** Sets up the various event listeners for the cursor, such as mouse movements and clicks. */
+    protected _setEvents(): void;
+    /** Handles property mutations */
+    protected _handleProps(): void;
+    /** Enables cursor animation. */
+    protected _toggle(enabled: boolean): void;
+    /** Handles mouse enter events. */
+    protected _handleMouseEnter(evt: MouseEvent): void;
+    /** Handles mouse leave events. */
+    protected _handleMouseLeave(): void;
+    /** Handles mouse move events. */
+    protected _handleMouseMove(evt: MouseEvent): void;
+    /** Handles mouse down events. */
+    protected _handleMouseDown(evt: MouseEvent): void;
+    /** Handles mouse up events. */
+    protected _handleMouseUp(): void;
+    /** Handles window blur events. */
+    protected _handleWindowBlur(): void;
+    /**
+     * Registers an element to interact with the cursor, enabling dynamic size and position changes based on hover effects.
+     * @param settings The settings for the hovered element.
+     * @param {number} [enterTimeout=100] The timeout before the hover effect is applied.
+     * @returns Returns a destructor
+     */
+    attachElement(settings: ICursorHoveredElement, enterTimeout?: number): () => void;
+    /**
+     * Registers a cursor type.
+     */
+    attachCursor({ element, type }: ICursorType): void;
+    /** Enable or disable a cursor type */
+    protected _toggleType(type: string, isEnabled: boolean): void;
+    /**
+     * Checks if all coordinates are interpolated.
+     * @returns {boolean} True if all coordinates are interpolated, false otherwise.
+     */
+    protected get isInterpolated(): boolean;
+    /** Renders the cursor. */
+    render(): void;
+    /** Recalculates current coordinates. */
+    protected _calculate(): void;
+    /**
+     * Performs linear interpolation.
+     * @param {number} current The current value.
+     * @param {number} target The target value.
+     * @returns {number} The interpolated value.
+     */
+    protected _lerp(current: number, target: number): number;
+    /** Renders the cursor elements. */
+    protected _renderElements(): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/lib/types/components/Cursor/styles.d.ts

@@ -0,0 +1,2 @@
+export declare function createCursorStyles(prefix: string): HTMLStyleElement;
+//# sourceMappingURL=styles.d.ts.map

package/lib/types/components/Cursor/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/components/Cursor/styles.ts"],"names":[],"mappings":"AAEA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,oBAsEhD"}

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

@@ -0,0 +1,109 @@
+import { IModuleCallbacksMap, IModuleMutableProps, IModuleStaticProps } from '../../base/Module';
+export interface ICursorStaticProps extends IModuleStaticProps {
+    /**
+     * The container where the custom cursor is active.
+     * Use `window` for full-window activation.
+     * @default window
+     */
+    container?: Element | Window;
+    /**
+     * Hides the native cursor if set to `true`.
+     * @default false
+     */
+    hideNative?: boolean;
+}
+export interface ICursorMutableProps extends IModuleMutableProps {
+    /**
+     * Enables or disables the custom cursor interactions.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * The initial width of the custom cursor.
+     * @default 50
+     */
+    width?: number;
+    /**
+     * The initial height of the custom cursor.
+     * @default 50
+     */
+    height?: number;
+    /**
+     * Linear interpolation factor for smooth cursor movement.
+     * The value must be between `0` and `1`, with higher values indicating faster movement.
+     * @default 0.2
+     */
+    lerp?: number;
+    /**
+     * Stops rendering the cursor automatically when its coordinates and size
+     * closely match the target values.
+     * @default true
+     */
+    autoStop?: boolean;
+}
+/**
+ * Callback types for the custom cursor component.
+ */
+export interface ICursorCallbacksMap extends IModuleCallbacksMap {
+    /**
+     * Triggered on each render to update the cursor's position.
+     */
+    render: undefined;
+}
+/**
+ * Represents the cursor's position.
+ */
+export interface ICursorCoords {
+    x: number;
+    y: number;
+}
+/**
+ * Represents the cursor's position and size.
+ */
+export interface ICursorFullCoords {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Information about the currently hovered element affecting cursor behavior.
+ */
+export interface ICursorHoveredElement {
+    /**
+     * The currently hovered element.
+     */
+    element: Element;
+    /** Cursor type */
+    type?: string;
+    /**
+     * Indicates whether the hover state should persist on the element.
+     */
+    sticky?: boolean;
+    /**
+     * Target width of the cursor while hovering over this element.
+     * @default null
+     */
+    width?: null | number | 'auto';
+    /**
+     * Target height of the cursor while hovering over this element.
+     * @default null
+     */
+    height?: null | number | 'auto';
+    /**
+     * Padding around the cursor while hovering over this element.
+     */
+    padding?: number;
+}
+/**
+ * Information about the currently hovered element affecting cursor behavior.
+ */
+export interface ICursorType {
+    /**
+     * The currently hovered element.
+     */
+    element: Element;
+    /** Cursor type */
+    type: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/Cursor/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAE7B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAE/B;;;OAGG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAEhC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;CACd"}