@qrvey/utils 1.16.1-9 → 1.17.0-1

package/dist/dates/helpers/isValidISOOffset.d.ts

@@ -1,8 +1,2 @@
 import { IDTimezoneOffset } from "../interfaces/IDTimezoneOffset";
-/**
- * Validate if offset uses a valid ISO 8601 offset specification
- * - If the given offset is a numeric, returns an invalid flag.
- * @param {IDTimezoneOffset} offset the timezone offset
- * @returns {boolean} true if the given offset is valid
- */
 export declare function isValidISOOffset(offset: IDTimezoneOffset): boolean;

package/dist/dates/helpers/isValidISOOffset.js

@@ -1,11 +1,5 @@
 import { isEmpty } from "../../general/mix/isEmpty";
 import { ISO_8601_REGEX } from "../constants/ISO_8601_REGEX";
-/**
- * Validate if offset uses a valid ISO 8601 offset specification
- * - If the given offset is a numeric, returns an invalid flag.
- * @param {IDTimezoneOffset} offset the timezone offset
- * @returns {boolean} true if the given offset is valid
- */
 export function isValidISOOffset(offset) {
     if (isEmpty(offset) || typeof offset !== "string")
         return false;

package/dist/dates/helpers/isValidPotentialDate.d.ts

@@ -1,8 +1,2 @@
 import { IDate } from "../interfaces/IDate";
-/**
- * Checks if the given date is allowed to continue the process for adapting dates
- * - If the string is a token or a combination of tokens is not valid
- * @param {IDate} date String, object or millisencond number of the date
- * @returns true: the date is valid.
- */
 export declare function isValidPotentialDate(date: IDate): boolean;

package/dist/dates/helpers/isValidPotentialDate.js

@@ -1,38 +1,17 @@
 import { isEmpty } from "../../general/mix/isEmpty";
 import { DATE_FORMATS } from "../constants/DATE_FORMATS";
 import { areIncludedDateTokens } from "./areIncludedDateTokens";
-/**
- * Checks if the given date is allowed to continue the process for adapting dates
- * - If the string is a token or a combination of tokens is not valid
- * @param {IDate} date String, object or millisencond number of the date
- * @returns true: the date is valid.
- */
 export function isValidPotentialDate(date) {
     return (!isEmpty(date) &&
         !includingDateTokens(date) &&
         (isDateInstance(date) || isStringDate(date) || typeof date === "number"));
 }
-/**
- * Validates if the given date has tokens
- * @param {IDate} date String, object or millisencond number of the date
- * @returns {boolean} true: the date has tokens
- */
 function includingDateTokens(date) {
     return DATE_FORMATS.some((dateFormat) => areIncludedDateTokens(date, dateFormat));
 }
-/**
- * Validates if the given date is a date instance
- * @param {IDate} date String, object or millisencond number of the date
- * @returns {boolean} true: the date is a date instance
- */
 function isDateInstance(date) {
     return date instanceof Date && !isNaN(date);
 }
-/**
- * Validates if the given date is a string date
- * @param {IDate} date String, object or millisencond number of the date
- * @returns {boolean} true: the date is a string date
- */
 function isStringDate(date) {
     return (typeof date === "string" && new Date(date).toString() !== "Invalid Date");
 }

package/dist/dates/helpers/isValidTimezoneOffset.d.ts

@@ -1,7 +1,2 @@
 import { IDTimezoneOffset } from "../interfaces/IDTimezoneOffset";
-/**
- * Validates if the given param is a valid timezone offset
- * @param {IDTimezoneOffset} offset the timezone offset
- * @returns {boolean} true: is valid timezone offset.
- */
 export declare function isValidTimezoneOffset(offset: IDTimezoneOffset): boolean;

package/dist/dates/helpers/isValidTimezoneOffset.js

@@ -1,11 +1,6 @@
 import { isNaNV2 } from "../../general/mix/isNaNV2";
 import { ISOToNumericOffset } from "../adapters/ISOToNumericOffset";
 import { isValidISOOffset } from "./isValidISOOffset";
-/**
- * Validates if the given param is a valid timezone offset
- * @param {IDTimezoneOffset} offset the timezone offset
- * @returns {boolean} true: is valid timezone offset.
- */
 export function isValidTimezoneOffset(offset) {
     if (typeof offset === "string") {
         return (offset === "browser" ||
@@ -16,11 +11,6 @@ export function isValidTimezoneOffset(offset) {
     }
     return false;
 }
-/**
- * Validates if the given offset is in the timezone range
- * @param {IDTimezoneOffset} offset the timezone offset
- * @returns {boolean} true: the offset is in the timezone range
- */
 function isValidOffsetRange(offset) {
     const numericOffset = ISOToNumericOffset(offset);
     return -720 <= numericOffset && numericOffset <= 840;

package/dist/dates/helpers/validateDate.d.ts

@@ -1,11 +1,2 @@
 import { IDateFormat } from "../interfaces/IDateFormat";
-/**
- * Validate a string date depending on giving format
- * - If the string is a token label, the function lets it pass.
- * - Otherwise depends of the format
- * - Some escenarios the string is a mix of token labels and dates
- * @param {string} date String of date
- * @param {IDateFormat} format String of the format to validate
- * @returns {boolean} True if it is valid or not. Undefined if date is undefined
- */
 export declare function validateDate(date: string, format?: IDateFormat): boolean;

package/dist/dates/helpers/validateDate.js

@@ -3,15 +3,6 @@ import { isTokenLabel } from "../../tokens/isTokenLabel";
 import { DATE_FORMAT } from "../constants/DATE_FORMAT";
 import { getDateFormatRegularExpressionInArray } from "./getDateFormatRegularExpressionInArray";
 import { getSeparatorByDateFormat } from "./getSeparatorByDateFormat";
-/**
- * Validate a string date depending on giving format
- * - If the string is a token label, the function lets it pass.
- * - Otherwise depends of the format
- * - Some escenarios the string is a mix of token labels and dates
- * @param {string} date String of date
- * @param {IDateFormat} format String of the format to validate
- * @returns {boolean} True if it is valid or not. Undefined if date is undefined
- */
 export function validateDate(date, format = DATE_FORMAT.DAY) {
     if (isEmpty(date) || typeof date !== "string")
         return false;

package/dist/dates/relative/RelativeStatementAdapter.d.ts

@@ -12,67 +12,12 @@ export declare class RelativeStatementAdapter {
     get includeCurrent(): any;
     get isCalendarDate(): any;
     get(prop: string): any;
-    /**
-     * Resolves statement and returns statement value
-     * @returns {AbsoluteRange|string}
-     */
     value(): string | AbsoluteStatement;
-    /**
-     * Resolves statement as an anchor
-     * @returns {string}
-     */
     valueAsAnchor(): string;
-    /**
-     * Convert verbal statement to range value
-     * @private
-     * @returns {AbsoluteRange}
-     */
     private _statementToRange;
-    /**
-     * Apply 'this' cursor logic to statement
-     * @private
-     * @returns {AbsoluteStatement}
-     */
     private _resolveAsThis;
-    /**
-     * Apply 'the last' cursor logic to statement
-     * @private
-     * @returns {AbsoluteStatement}
-     */
     private _resolveAsTheLast;
-    /**
-     * Apply 'the next' cursor logic to statement
-     * @private
-     * @returns {AbsoluteStatement}
-     */
     private _resolveAsTheNext;
-    /**
-     * Replace '@now' token inside a string
-     * @param {string} value
-     * @param {Date} now
-     * @returns {string}
-     */
     static replaceNowToken(value: string, now: Date): string;
-    /**
-     * Returns a range object (date) from a group of statement params
-     * @example
-     * pivot = '2021-03-03T12:30:40'
-     * unit = month
-     * steps = 2
-     * setTo = END
-     * resolverAsCalendar: true
-     * => Returns  '2021-05-31T23:59:59'
-     *
-     * @example
-     * pivot = '2021-03-03T12:30:40'
-     * unit = month
-     * steps = -2
-     * setTo = START
-     * resolverAsCalendar: false
-     * => Returns '2021-01-03T00:00:00'
-     *
-     * @param {RelativeToAbsoluteStruct} args
-     * @returns {string}
-     */
     static convertRelativeToAbsolute(args: RelativeToAbsoluteStruct): string;
 }

package/dist/dates/relative/RelativeStatementAdapter.js

@@ -8,6 +8,8 @@ import { parseDate } from "./helpers/parseDate";
 import { DATETIME_FORMAT } from "./constants/DATE_FORMATS";
 import { isEmpty } from "../../general";
 export class RelativeStatementAdapter {
+    statement;
+    now;
     constructor(statement, now = new Date()) {
         this.statement =
             typeof statement === "string" ? statement : formatStatement(statement);
@@ -36,19 +38,11 @@ export class RelativeStatementAdapter {
             return null;
         return this.statement[prop];
     }
-    /**
-     * Resolves statement and returns statement value
-     * @returns {AbsoluteRange|string}
-     */
     value() {
         return typeof this.statement === "string"
             ? RelativeStatementAdapter.replaceNowToken(this.statement, this.now)
             : this._statementToRange();
     }
-    /**
-     * Resolves statement as an anchor
-     * @returns {string}
-     */
     valueAsAnchor() {
         if (typeof this.statement === "string")
             return RelativeStatementAdapter.replaceNowToken(this.statement, this.now);
@@ -62,11 +56,6 @@ export class RelativeStatementAdapter {
         }
         return _get(value, path, new Date());
     }
-    /**
-     * Convert verbal statement to range value
-     * @private
-     * @returns {AbsoluteRange}
-     */
     _statementToRange() {
         switch (this.cursor) {
             case RELATIVE_CURSOR.LAST:
@@ -78,11 +67,6 @@ export class RelativeStatementAdapter {
                 return this._resolveAsThis();
         }
     }
-    /**
-     * Apply 'this' cursor logic to statement
-     * @private
-     * @returns {AbsoluteStatement}
-     */
     _resolveAsThis() {
         const gte = RelativeStatementAdapter.convertRelativeToAbsolute({
             unit: this.unit,
@@ -96,11 +80,6 @@ export class RelativeStatementAdapter {
         });
         return { gte, lte };
     }
-    /**
-     * Apply 'the last' cursor logic to statement
-     * @private
-     * @returns {AbsoluteStatement}
-     */
     _resolveAsTheLast() {
         const statementCase = getStatementCase(this.includeCurrent, this.isCalendarDate);
         const pivot = new RelativeStatementAdapter(this.anchor, this.now).valueAsAnchor();
@@ -109,12 +88,20 @@ export class RelativeStatementAdapter {
             unit: this.unit,
             resolveAsCalendar: this.isCalendarDate,
         };
-        const gte = RelativeStatementAdapter.convertRelativeToAbsolute(Object.assign(Object.assign({}, args), { setTo: COMMON_CONSTANTS.START, steps: -this.number +
+        const gte = RelativeStatementAdapter.convertRelativeToAbsolute({
+            ...args,
+            setTo: COMMON_CONSTANTS.START,
+            steps: -this.number +
                 (statementCase === COMMON_CONSTANTS.INCLUSIVE_AND_CALENDAR ||
                     (this.includeCurrent && this.unit === DATE_GROUPING_PROPERTY.DAY)
                     ? 1
-                    : 0) }));
-        const lte = RelativeStatementAdapter.convertRelativeToAbsolute(Object.assign(Object.assign({}, args), { setTo: COMMON_CONSTANTS.END, steps: statementCase === COMMON_CONSTANTS.EXCLUSIVE_AND_CALENDAR ? -1 : 0 }));
+                    : 0),
+        });
+        const lte = RelativeStatementAdapter.convertRelativeToAbsolute({
+            ...args,
+            setTo: COMMON_CONSTANTS.END,
+            steps: statementCase === COMMON_CONSTANTS.EXCLUSIVE_AND_CALENDAR ? -1 : 0,
+        });
         return {
             gte,
             lte: statementCase === COMMON_CONSTANTS.EXCLUSIVE_AND_ROLLING
@@ -127,11 +114,6 @@ export class RelativeStatementAdapter {
                 : lte,
         };
     }
-    /**
-     * Apply 'the next' cursor logic to statement
-     * @private
-     * @returns {AbsoluteStatement}
-     */
     _resolveAsTheNext() {
         const statementCase = getStatementCase(this.includeCurrent, this.isCalendarDate);
         const pivot = new RelativeStatementAdapter(this.anchor, this.now).valueAsAnchor();
@@ -140,12 +122,20 @@ export class RelativeStatementAdapter {
             unit: this.unit,
             resolveAsCalendar: this.isCalendarDate,
         };
-        const gte = RelativeStatementAdapter.convertRelativeToAbsolute(Object.assign(Object.assign({}, args), { setTo: COMMON_CONSTANTS.START, steps: statementCase === COMMON_CONSTANTS.EXCLUSIVE_AND_CALENDAR ? 1 : 0 }));
-        const lte = RelativeStatementAdapter.convertRelativeToAbsolute(Object.assign(Object.assign({}, args), { setTo: COMMON_CONSTANTS.END, steps: this.number +
+        const gte = RelativeStatementAdapter.convertRelativeToAbsolute({
+            ...args,
+            setTo: COMMON_CONSTANTS.START,
+            steps: statementCase === COMMON_CONSTANTS.EXCLUSIVE_AND_CALENDAR ? 1 : 0,
+        });
+        const lte = RelativeStatementAdapter.convertRelativeToAbsolute({
+            ...args,
+            setTo: COMMON_CONSTANTS.END,
+            steps: this.number +
                 (statementCase === COMMON_CONSTANTS.INCLUSIVE_AND_CALENDAR ||
                     (this.includeCurrent && this.unit === DATE_GROUPING_PROPERTY.DAY)
                     ? -1
-                    : 0) }));
+                    : 0),
+        });
         return {
             lte,
             gte: statementCase === COMMON_CONSTANTS.EXCLUSIVE_AND_ROLLING
@@ -158,36 +148,9 @@ export class RelativeStatementAdapter {
                 : gte,
         };
     }
-    /**
-     * Replace '@now' token inside a string
-     * @param {string} value
-     * @param {Date} now
-     * @returns {string}
-     */
     static replaceNowToken(value, now) {
         return value.replace(COMMON_CONSTANTS.NOW_TOKEN, parseDate(now).format(DATETIME_FORMAT));
     }
-    /**
-     * Returns a range object (date) from a group of statement params
-     * @example
-     * pivot = '2021-03-03T12:30:40'
-     * unit = month
-     * steps = 2
-     * setTo = END
-     * resolverAsCalendar: true
-     * => Returns  '2021-05-31T23:59:59'
-     *
-     * @example
-     * pivot = '2021-03-03T12:30:40'
-     * unit = month
-     * steps = -2
-     * setTo = START
-     * resolverAsCalendar: false
-     * => Returns '2021-01-03T00:00:00'
-     *
-     * @param {RelativeToAbsoluteStruct} args
-     * @returns {string}
-     */
     static convertRelativeToAbsolute(args) {
         const { pivot, unit, steps = 0, setTo, resolveAsCalendar = true } = args;
         const loweredUnit = unit.toLowerCase();

package/dist/dates/relative/constants/RELATIVE_CURSOR_INFO_LIST.d.ts

@@ -1,5 +1,2 @@
 import { IRelativeCursorInfo } from "../interfaces/IRelativeCursorInfo";
-/**
- * @description Key/array of compound relative cursor info
- */
 export declare const RELATIVE_CURSOR_INFO_LIST: IRelativeCursorInfo[];

package/dist/dates/relative/constants/RELATIVE_CURSOR_INFO_LIST.js

@@ -1,8 +1,5 @@
 import { RELATIVE_CURSOR_INFO } from "./RELATIVE_CURSOR_INFO";
 import { RELATIVE_CURSOR } from "./RELATIVE_CURSOR";
-/**
- * @description Key/array of compound relative cursor info
- */
 export const RELATIVE_CURSOR_INFO_LIST = [
     RELATIVE_CURSOR_INFO[RELATIVE_CURSOR.THIS],
     RELATIVE_CURSOR_INFO[RELATIVE_CURSOR.LAST],

package/dist/dates/relative/constants/RELATIVE_DATE_TIME_UNIT_INFO_LIST.d.ts

@@ -1,5 +1,2 @@
 import { IRelativeUnitInfo } from "../interfaces/IRelativeUnitInfo";
-/**
- * @description Key/array of compound relative unit info of date-time
- */
 export declare const RELATIVE_DATE_TIME_UNIT_INFO_LIST: IRelativeUnitInfo[];

package/dist/dates/relative/constants/RELATIVE_DATE_TIME_UNIT_INFO_LIST.js

@@ -1,7 +1,4 @@
 import { RELATIVE_UNIT_INFO } from "./RELATIVE_UNIT_INFO";
-/**
- * @description Key/array of compound relative unit info of date-time
- */
 export const RELATIVE_DATE_TIME_UNIT_INFO_LIST = [
     RELATIVE_UNIT_INFO.HOUR,
     RELATIVE_UNIT_INFO.MINUTE,

package/dist/dates/relative/constants/RELATIVE_DATE_UNIT_INFO_LIST.d.ts

@@ -1,5 +1,2 @@
 import { IRelativeUnitInfo } from "../interfaces/IRelativeUnitInfo";
-/**
- * @description Key/array of compound relative unit info of dates
- */
 export declare const RELATIVE_DATE_UNIT_INFO_LIST: IRelativeUnitInfo[];

package/dist/dates/relative/constants/RELATIVE_DATE_UNIT_INFO_LIST.js

@@ -1,7 +1,4 @@
 import { RELATIVE_UNIT_INFO } from "./RELATIVE_UNIT_INFO";
-/**
- * @description Key/array of compound relative unit info of dates
- */
 export const RELATIVE_DATE_UNIT_INFO_LIST = [
     RELATIVE_UNIT_INFO.YEAR,
     RELATIVE_UNIT_INFO.QUARTER,

package/dist/dates/relative/helpers/formatStatement.d.ts

@@ -1,7 +1,2 @@
 import { RelativeStatement } from "../interfaces/RelativeStatement";
-/**
- * Build a proper relative date statement type
- * @param {RelativeStatement} statement
- * @returns {RelativeStatement}
- */
 export declare function formatStatement(statement: RelativeStatement): RelativeStatement;

package/dist/dates/relative/helpers/formatStatement.js

@@ -3,11 +3,6 @@ import { _get } from "../../../general/object/get";
 import { mapValues } from "../../../general/object/mapValues";
 import { DATE_GROUPING_PROPERTY } from "../../constants/DATE_GROUPING_PROPERTY";
 import { COMMON_CONSTANTS } from "../constants/COMMON";
-/**
- * Build a proper relative date statement type
- * @param {RelativeStatement} statement
- * @returns {RelativeStatement}
- */
 export function formatStatement(statement) {
     const loweredStatement = mapValues(statement, (s) => typeof s === "string" ? s.toLowerCase() : s);
     return {

package/dist/dates/relative/helpers/getStatementCase.d.ts

@@ -1,8 +1,2 @@
 import { COMMON_CONSTANTS } from "../constants/COMMON";
-/**
- * Returns a number/constant that identifies a relative date case
- * @param {boolean} includeCurrent
- * @param {boolean} isCalendarDate
- * @returns {number}
- */
 export declare function getStatementCase(includeCurrent: boolean, isCalendarDate: boolean): COMMON_CONSTANTS.INCLUSIVE_AND_CALENDAR | COMMON_CONSTANTS.EXCLUSIVE_AND_CALENDAR | COMMON_CONSTANTS.EXCLUSIVE_AND_ROLLING | COMMON_CONSTANTS.INCLUSIVE_AND_ROLLING;

package/dist/dates/relative/helpers/getStatementCase.js

@@ -1,10 +1,4 @@
 import { COMMON_CONSTANTS } from "../constants/COMMON";
-/**
- * Returns a number/constant that identifies a relative date case
- * @param {boolean} includeCurrent
- * @param {boolean} isCalendarDate
- * @returns {number}
- */
 export function getStatementCase(includeCurrent, isCalendarDate) {
     if (includeCurrent && isCalendarDate) {
         return COMMON_CONSTANTS.INCLUSIVE_AND_CALENDAR;

package/dist/dates/relative/helpers/parseDate.d.ts

@@ -1,10 +1,5 @@
 import { Dayjs } from "./dayjs-module";
 type ParserDate = string | Dayjs | Date;
 type ParserDateReturnType = Dayjs | null;
-/**
- * Parses a string date and returns a dayjs date
- * @param {string|Dayjs|Date} date
- * @returns {Dayjs|null} A dayjs date
- */
 export declare function parseDate(date: ParserDate): ParserDateReturnType;
 export {};

package/dist/dates/relative/helpers/parseDate.js

@@ -1,10 +1,5 @@
 import dayjs from "./dayjs-module";
 import { INPUT_FORMATS } from "../constants/DATE_FORMATS";
-/**
- * Parses a string date and returns a dayjs date
- * @param {string|Dayjs|Date} date
- * @returns {Dayjs|null} A dayjs date
- */
 export function parseDate(date) {
     if (dayjs.isDayjs(date)) {
         return date;

package/dist/dates/relative/relative.d.ts

@@ -1,21 +1,2 @@
 import { RelativeStatement } from "./interfaces/RelativeStatement";
-/**
- * Resolve a list of relative statements according to operator
- * @example
- * Input:
- * {
- *  "cursor": "the_next",
- *  "unit": "year",
- *  "number": 1,
- *  "includeCurrent": false,
- *  "isCalendarDate": false,
- *  "anchor": "03/05/2021"
- * }
- *
- * Output:
- * { gte: "03/06/2021 00:00:00", lte: "03/05/2022 23:59:59" }
- * @param statements - Raw statements/values
- * @param clock - Clock/time reference for relative date resolution
- * @returns
- */
 export declare function resolveRelative(statements: RelativeStatement[], clock?: Date): (string | import("./interfaces").AbsoluteStatement)[];

package/dist/dates/relative/relative.js

@@ -1,23 +1,4 @@
 import { RelativeStatementAdapter } from "./RelativeStatementAdapter";
-/**
- * Resolve a list of relative statements according to operator
- * @example
- * Input:
- * {
- *  "cursor": "the_next",
- *  "unit": "year",
- *  "number": 1,
- *  "includeCurrent": false,
- *  "isCalendarDate": false,
- *  "anchor": "03/05/2021"
- * }
- *
- * Output:
- * { gte: "03/06/2021 00:00:00", lte: "03/05/2022 23:59:59" }
- * @param statements - Raw statements/values
- * @param clock - Clock/time reference for relative date resolution
- * @returns
- */
 export function resolveRelative(statements, clock = new Date()) {
     return statements.map((s) => new RelativeStatementAdapter(s, clock).value());
 }

package/dist/elements/helpers/fixed.d.ts

@@ -3,79 +3,16 @@ import { FindAvailablePositionOptions } from "../interfaces/IFixedPosition";
 import { VemFixed } from "../interfaces/IVemCore";
 import { VemPositionFixed } from "../interfaces/IVemPosition";
 export declare const CANVAS_EXTRA_HEIGHT = 10;
-/**
- * update the position for a specific device
- * @param element element to be updated
- * @param newDevicePosition new position attributes for the element
- * @param device device for the update
- * @returns new element with its position updated
- */
 export declare function updateFixedPosition(element: VemFixed, newDevicePosition: Partial<VemPositionFixed>, device: CanvasDevice): VemFixed;
-/**
- * Finds the first available position within a canvas where a new element can be placed without overlapping existing elements.
- * @param canvasWidth - The width of the canvas in pixels.
- * @param newElement - The new element to be placed, with fixed position properties.
- * @param elements - The list of existing elements on the canvas.
- * @param device - The device type (e.g., desktop, tablet, mobile) for determining element positions.
- * @param [options] - Additional options for position finding.
- * @param [options.canvasHeight] - The maximum height of the canvas in pixels. Defaults to `Infinity`.
- * @param [options.findRightToLeft] - Whether to search for positions from right to left. Defaults to `false`.
- * @param [options.initialY] - The initial Y-coordinate to start the search. Defaults to `0`.
- * @returns - The x and y coordinates of the first available position.
- * @throws {Error} - Throws an error if no valid position is found and `canvasHeight` is not specified.
- */
 export declare function findAvailablePosition(canvasWidth: number, newElement: VemFixed, elements: VemFixed[], device: CanvasDevice, options?: FindAvailablePositionOptions): {
     x: number;
     y: number;
 };
 export declare const getFixedPositionByDevice: (item: VemFixed, device: CanvasDevice) => VemPositionFixed | undefined;
-/**
- * Finds available positions for multiple new elements within a canvas, ensuring they do not overlap with existing elements.
- * @param canvasWidth - The width of the canvas in pixels.
- * @param newElements - The list of new elements to be positioned, each with fixed position properties.
- * @param elements - The list of existing elements on the canvas.
- * @param device - The device type (e.g., desktop, tablet, mobile) for determining element positions.
- * @param [startWithPositionY] - Whether to start the position search for each new element based on its initial Y-coordinate. Defaults to `false`.
- * @param [findRightToLeft] - Whether to search for positions from right to left. Defaults to `false`.
- * @param [canvasHeight] - The maximum height of the canvas in pixels. If not provided, the search height is unlimited.
- * @returns List of elements with their recalculated positions.
- */
 export declare function findFixedAvailablePositions(canvasWidth: number, newElements: VemFixed[], elements: VemFixed[], device: CanvasDevice, startWithPositionY?: boolean, findRightToLeft?: boolean, canvasHeight?: number): VemFixed[];
-/**
- * Recalculates the positions of elements on the canvas, preserving the position of those
- * that meet certain conditions (no overflow or overlap). Elements that do not meet these
- * conditions are recalculated to find a new valid position.
- * @param elements - List of elements to recalculate.
- * @param scopeElements - scope Elements
- * @param device - The device on which the canvas is being rendered.
- * @param resolution - The resolution of the canvas.
- * @param [canvasHeight] - Optional height of the canvas.
- * @returns - List of elements with their recalculated positions.
- */
 export declare const recalculatePreservingPositions: (elements: VemFixed[], scopeElements: VemFixed[], device: CanvasDevice, resolution: number, canvasHeight?: number) => VemFixed[];
-/**
- * Adjusts the `width` of a fixed element to fit within the specified canvas width and updates its position.
- * @param element - The fixed element to adjust.
- * @param canvasWidth - The width of the canvas in grid columns.
- * @param canvasDevice - The target device type (e.g., desktop, tablet, mobile).
- * @returns - The updated responsive element with an adjusted `width`.
- */
 export declare function updateFixedElementWidth(element: VemFixed, canvasWidth: number, canvasDevice: CanvasDevice): VemFixed;
-/**
- * @param elements elements to calculate
- * @param device  current device
- * @returns height
- */
 export declare const getFixedGridElementsBottomLimit: (elements: VemFixed[], device: CanvasDevice) => number;
-/**
- * Calculates distances of elements from a given reference point on the canvas device.
- * @param elements - Array of `VemFixed` elements to calculate distances for.
- * @param device - Canvas device providing the coordinates of the elements.
- * @param referencePoint - The reference point to calculate distances from.
- * @param referencePoint.x
- * @param referencePoint.y
- * @returns An array of objects containing the original elements and their calculated distances from the reference point.
- */
 export declare const calculateDistancesToReferencePoint: (elements: VemFixed[], device: CanvasDevice, referencePoint: {
     x: number;
     y: number;
@@ -83,25 +20,8 @@ export declare const calculateDistancesToReferencePoint: (elements: VemFixed[],
     distance: number;
     element: VemFixed;
 }[];
-/**
- * Sorts elements based on their distance from a reference point on the canvas.
- * @param elements - Array of `VemFixed` elements to be sorted.
- * @param device - Canvas device providing the coordinates of the elements.
- * @param referencePoint - The reference point to calculate distances from.
- * @param referencePoint.x
- * @param referencePoint.y
- * @returns An array of `VemFixed` elements sorted by their distance from the reference point (0, 0).
- */
 export declare const sortElementsFromReferencePoint: (elements: VemFixed<unknown>[], device: CanvasDevice, referencePoint: {
     x: number;
     y: number;
 }) => VemFixed<unknown>[];
-/**
- * Updates the height of a given container element based on the bottom limit of other scoped elements.
- * It ensures the container has at least the height required to encompass all scoped elements.
- * @param containerItem - The element to update.
- * @param  device - The target device context (used to access device-specific dimensions).
- * @param scopeElements
- * @returns  - A new version of the container element with updated height if needed.
- */
 export declare const updateFixedElementDimensions: (containerItem: VemFixed<unknown>, device: CanvasDevice, scopeElements: VemFixed<unknown>[]) => VemFixed<unknown>;