@qrvey/utils 1.15.0-9 → 1.16.0-0

package/dist/cjs/globalization/helpers/getI18nDateGroupLabel.js

@@ -6,6 +6,12 @@ const DATE_GROUPING_PROPERTY_1 = require("../../dates/constants/DATE_GROUPING_PR
 const DATE_YEAR_MONTHS_1 = require("../../dates/constants/DATE_YEAR_MONTHS");
 const isEmpty_1 = require("../../general/mix/isEmpty");
 const isTokenLabel_1 = require("../../tokens/isTokenLabel");
+/**
+ *
+ * @param label
+ * @param dateGroup
+ * @param translate
+ */
 function getI18nDateGroupLabel(label, dateGroup, translate) {
     if ((0, isEmpty_1.isEmpty)(label))
         return label;
@@ -19,14 +25,26 @@ function getI18nDateGroupLabel(label, dateGroup, translate) {
         return getI18nYearMonthLabel(label, translate);
     else if (dateGroup === DATE_DISTINCT_PROPERTY_1.DATE_DISTINCT_PROPERTY.YEAR_QUARTER)
         return getI18nYearQuarterLabel(label, translate);
+    else if (dateGroup === DATE_DISTINCT_PROPERTY_1.DATE_DISTINCT_PROPERTY.DAY_CUSTOM)
+        return getI18nDayCustomLabel(label, translate);
     return label;
 }
 exports.getI18nDateGroupLabel = getI18nDateGroupLabel;
+/**
+ *
+ * @param label
+ * @param translate
+ */
 function getI18nMonthLabel(label, translate) {
     const splittedLabel = label.split(" ");
     splittedLabel[0] = getI18nYearMonthLabel(splittedLabel[0], translate);
     return splittedLabel.join(" ");
 }
+/**
+ *
+ * @param label
+ * @param translate
+ */
 function getI18nYearMonthLabel(label, translate) {
     let newLabel = label;
     if (!(0, isTokenLabel_1.isTokenLabel)(newLabel) && !(0, isEmpty_1.isEmpty)(translate)) {
@@ -36,6 +54,10 @@ function getI18nYearMonthLabel(label, translate) {
     }
     return newLabel;
 }
+/**
+ *
+ * @param index
+ */
 function getI18nMonthPropertyByIndex(index) {
     const months = [
         "january",
@@ -53,11 +75,21 @@ function getI18nMonthPropertyByIndex(index) {
     ];
     return months[index];
 }
+/**
+ *
+ * @param label
+ * @param translate
+ */
 function getI18nQuarterLabel(label, translate) {
     const splittedLabel = label.split(" ");
     splittedLabel[0] = getI18nYearQuarterLabel(splittedLabel[0], translate);
     return splittedLabel.join(" ");
 }
+/**
+ *
+ * @param label
+ * @param translate
+ */
 function getI18nYearQuarterLabel(label, translate) {
     let newLabel = label;
     if (!(0, isTokenLabel_1.isTokenLabel)(newLabel) && !(0, isEmpty_1.isEmpty)(translate)) {
@@ -65,11 +97,21 @@ function getI18nYearQuarterLabel(label, translate) {
     }
     return newLabel;
 }
+/**
+ *
+ * @param label
+ * @param translate
+ */
 function getI18nWeekLabel(label, translate) {
     const splittedLabel = label.split(" ");
     splittedLabel[0] = getI18nYearWeekLabel(splittedLabel[0], translate);
     return splittedLabel.join(" ");
 }
+/**
+ *
+ * @param label
+ * @param translate
+ */
 function getI18nYearWeekLabel(label, translate) {
     let newLabel = label;
     if (!(0, isTokenLabel_1.isTokenLabel)(newLabel) && !(0, isEmpty_1.isEmpty)(translate)) {
@@ -77,3 +119,81 @@ function getI18nYearWeekLabel(label, translate) {
     }
     return newLabel;
 }
+/**
+ *
+ * @param label
+ * @param translate
+ */
+function getI18nDayCustomLabel(label, translate) {
+    const dayMapper = {
+        Monday: "monday",
+        Tuesday: "tuesday",
+        Wednesday: "wednesday",
+        Thursday: "thursday",
+        Friday: "friday",
+        Saturday: "saturday",
+        Sunday: "sunday",
+    };
+    const dayAbbMapper = {
+        Mon: "monday",
+        Tue: "tuesday",
+        Wed: "wednesday",
+        Thu: "thursday",
+        Fri: "friday",
+        Sat: "saturday",
+        Sun: "sunday",
+    };
+    const monthMapper = {
+        January: "january",
+        February: "february",
+        March: "march",
+        April: "april",
+        May: "may",
+        June: "june",
+        July: "july",
+        August: "august",
+        September: "september",
+        October: "october",
+        November: "november",
+        December: "december",
+    };
+    const monthAbbMapper = {
+        Jan: "january",
+        Feb: "february",
+        Mar: "march",
+        Apr: "april",
+        May: "may",
+        Jun: "june",
+        Jul: "july",
+        Aug: "august",
+        Sep: "september",
+        Oct: "october",
+        Nov: "november",
+        Dec: "december",
+    };
+    let newLabel = label;
+    if (!(0, isTokenLabel_1.isTokenLabel)(newLabel) && !(0, isEmpty_1.isEmpty)(translate)) {
+        const regex = new RegExp([
+            ...Object.keys(dayMapper),
+            ...Object.keys(dayAbbMapper),
+            ...Object.keys(monthMapper),
+            ...Object.keys(monthAbbMapper),
+        ].join("|"), "g");
+        newLabel = newLabel.replace(regex, (match) => {
+            if (dayMapper[match]) {
+                return translate(`common.day_names.${dayMapper[match]}_dddd`);
+            }
+            else if (dayAbbMapper[match]) {
+                return translate(`common.day_names.${dayAbbMapper[match]}_ddd`);
+            }
+            else if (monthMapper[match]) {
+                return translate(`common.date_grouping.${monthMapper[match]}_mmmm`);
+            }
+            else if (monthAbbMapper[match]) {
+                return translate(`common.date_grouping.${monthAbbMapper[match]}_mmm`);
+            }
+            return match;
+        });
+    }
+    return newLabel;
+}

package/dist/cjs/globalization/interfaces/chart_builder/II18nChartBuilderSorting.d.ts

@@ -17,4 +17,6 @@ export interface II18nChartBuilderSorting {
     sorting_by_calculated_value: string;
     title: string;
     value: string;
+    empty_row_message?: string;
+    empty_column_message?: string;
 }

package/dist/cjs/globalization/interfaces/export/II18nExportingModal.d.ts

@@ -7,16 +7,20 @@ export interface I18nExportingModal {
     cancel_button_label: string;
     error_messages: II18nExportingModalErrorMessages;
     file_name_label: string;
+    new_dataset_name_label: string;
+    new_dataset_name_placeholder: string;
     recurrence: II18nExportingModalRecurrence;
     time_stamp: II18nExportingModalTimeStamp;
     time_zone_label: string;
     title_label: string;
+    title_new_dataset: string;
     uniqueness_concatenate: string;
     toast_messages: {
         failed_scheduling: string;
         successful_scheduling: string;
     };
     pivoting_export: {
+        source_label: string;
         dataset_label: string;
         filter_label: string;
         pivoting: {
@@ -28,12 +32,14 @@ export interface I18nExportingModal {
         columns_section: {
             title: string;
             subtitle: string;
+            subtitle_new_dataset: string;
             select_all_label: string;
             dataset_columns: string;
             pivot_columns_label: string;
             pivot_columns_sublabel: string;
         };
         columns_to_export_label: string;
+        columns_to_create_dataset_label: string;
         no_results_found: string;
     };
     schedule: {

package/dist/cjs/globalization/interfaces/export/II18nExportingModalApplyButtonLabel.d.ts

@@ -1,3 +1,4 @@
 export interface II18nExportingModalApplyButtonLabel {
     export_now: string;
+    create_dataset: string;
 }

package/dist/cjs/globalization/labels/chart_builder/I18N_CHART_BUILDER_GENERAL_OPTIONS.js

@@ -102,6 +102,8 @@ exports.I18N_CHART_BUILDER_GENERAL_OPTIONS = {
         sorting_by_calculated_value: "Sorting by Calculated Value",
         title: "Sorting",
         value: "Value",
+        empty_row_message: "Add rows to apply sorting",
+        empty_column_message: "Add columns to apply sorting",
     },
     menu_actions: {
         title: "Self-service Options",

package/dist/cjs/globalization/labels/export/I18N_EXPORT_MODAL.js

@@ -5,12 +5,17 @@ exports.EXPORTING_MODAL = void 0;
  * @deprecated since version 1.12.0; Qrvey version 8.3. Those default poroperties will be replaced by Qrvey Globalization JSON
  */
 exports.EXPORTING_MODAL = {
-    apply_button_label: { export_now: "Export Now" },
+    apply_button_label: {
+        export_now: "Export Now",
+        create_dataset: "Create Dataset",
+    },
     cancel_button_label: "Cancel",
     error_messages: {
         special_characters: "Special characters are not allowed in file name.",
     },
     file_name_label: "File Name",
+    new_dataset_name_label: "New Dataset Name",
+    new_dataset_name_placeholder: "Type",
     recurrence: {
         label: "Recurrence",
         value: { does_not_repeat: "Does not repeat" },
@@ -22,12 +27,14 @@ exports.EXPORTING_MODAL = {
     },
     time_zone_label: "Time Zone",
     title_label: "Export",
+    title_new_dataset: "New Dataset",
     uniqueness_concatenate: "For Uniqueness Concatenate",
     toast_messages: {
         failed_scheduling: "The export could not be scheduled at this time.",
         successful_scheduling: "The export of {{fileName}} has been scheduled successfully.",
     },
     pivoting_export: {
+        source_label: "Source",
         dataset_label: "Dataset",
         filter_label: "Filter",
         pivoting: {
@@ -39,12 +46,14 @@ exports.EXPORTING_MODAL = {
         columns_section: {
             title: "Columns",
             subtitle: "(Select columns to export)",
+            subtitle_new_dataset: "(Select columns for new dataset)",
             select_all_label: "Add All Columns",
             dataset_columns: "Dataset Columns",
             pivot_columns_label: "Pivot Columns",
             pivot_columns_sublabel: "Displaying only the first 100 results.",
         },
         columns_to_export_label: "Columns to export",
+        columns_to_create_dataset_label: "Dataset columns",
         no_results_found: "No results found",
     },
     schedule: {

package/dist/cjs/index.d.ts

@@ -16,3 +16,4 @@ export * from "./typescript/index";
 export * from "./tokens/index";
 export * from "./column_format/index";
 export * from "./themes/index";
+export * from "./elements/index";

package/dist/cjs/index.js

@@ -32,3 +32,4 @@ __exportStar(require("./typescript/index"), exports);
 __exportStar(require("./tokens/index"), exports);
 __exportStar(require("./column_format/index"), exports);
 __exportStar(require("./themes/index"), exports);
+__exportStar(require("./elements/index"), exports);

package/dist/cjs/interfaces/SatinizerStrategy.d.ts

@@ -0,0 +1,3 @@
+export interface SanitizerStrategy {
+    sanitize(html: string): string;
+}

package/dist/cjs/interfaces/SatinizerStrategy.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/themes/constants/AUTOMATIC_GLOBAL_CSS_VARIABLES_FOR_LIGHT.js

@@ -6,10 +6,10 @@ const GLOBAL_CSS_VARIABLES_1 = require("./GLOBAL_CSS_VARIABLES");
  * Collection of CSS Variables for Light Themes and its assigned values.
  */
 exports.AUTOMATIC_GLOBAL_CSS_VARIABLES_FOR_LIGHT = {
-    [GLOBAL_CSS_VARIABLES_1.GLOBAL_CSS_VARIABLES.HEADER_BACKGROUND_COLOR]: "#00000009",
+    [GLOBAL_CSS_VARIABLES_1.GLOBAL_CSS_VARIABLES.HEADER_BACKGROUND_COLOR]: "#F7F8FB",
     [GLOBAL_CSS_VARIABLES_1.GLOBAL_CSS_VARIABLES.BACKGROUND_OPACITY_BLACK_COLOR]: "#FFFFFF10",
-    [GLOBAL_CSS_VARIABLES_1.GLOBAL_CSS_VARIABLES.BORDER_COLOR]: "#00000020",
-    [GLOBAL_CSS_VARIABLES_1.GLOBAL_CSS_VARIABLES.DIVIDER_COLOR]: "#00000020",
+    [GLOBAL_CSS_VARIABLES_1.GLOBAL_CSS_VARIABLES.BORDER_COLOR]: "#00000017",
+    [GLOBAL_CSS_VARIABLES_1.GLOBAL_CSS_VARIABLES.DIVIDER_COLOR]: "#00000010",
     [GLOBAL_CSS_VARIABLES_1.GLOBAL_CSS_VARIABLES.HOVER_COLOR]: "#00000010",
     [GLOBAL_CSS_VARIABLES_1.GLOBAL_CSS_VARIABLES.PLACEHOLDER_COLOR]: "#00000070",
     [GLOBAL_CSS_VARIABLES_1.GLOBAL_CSS_VARIABLES.PILLS_BACKGROUND_COLOR]: "#FFFFFF40",

package/dist/columns/constants/COLUMN_ICON.js

@@ -3,36 +3,36 @@ import { COMPLEX_COLUMN } from "./COMPLEX_COLUMN";
 import { COMPOUND_COLUMN } from "./COMPOUND_COLUMN";
 import { NUMERICAL_COLUMN } from "./NUMERICAL_COLUMN";
 export const COLUMN_ICON = {
-    [NUMERICAL_COLUMN.RATING]: "q-icon-star",
-    [COMPLEX_COLUMN.TEXTFIELD]: "q-icon-short-text",
-    [COMPLEX_COLUMN.LONGTEXT]: "q-icon-long-text",
-    [COLUMN.TEXT_LABEL]: "q-icon-text-left",
-    [COLUMN.TEXT_CATEGORY]: "q-icon-text-left",
-    [COLUMN.YES_NO]: "q-icon-yes-no",
-    [COLUMN.RANKING]: "q-icon-ranking",
-    [COLUMN.DATE]: "q-icon-date",
-    [COLUMN.TIME]: "q-icon-time",
-    [NUMERICAL_COLUMN.SLIDEBAR]: "q-icon-slidebar",
-    [COMPLEX_COLUMN.IMAGEUPLOAD]: "q-icon-image-upload",
-    [COLUMN.SIGNATURE]: "q-icon-signature",
-    [COMPLEX_COLUMN.EXPRESSION]: "q-icon-expression",
-    [NUMERICAL_COLUMN.NUMERIC]: "q-icon-numeric",
-    [COLUMN.IMAGE]: "q-icon-image",
-    [COMPOUND_COLUMN.NAME]: "q-icon-name",
-    [COLUMN.EMAIL_FORM]: "q-icon-email",
-    [COLUMN.PHONE]: "q-icon-phone",
-    [COMPOUND_COLUMN.USADDRESS]: "q-icon-us-address",
-    [COMPOUND_COLUMN.ADDRESS]: "q-icon-address",
-    [COLUMN.PASSWORD]: "q-icon-password",
-    [COLUMN.DROPDOWN]: "q-icon-dropdown",
-    [COLUMN.LOOKUP]: "q-icon-Lookup",
-    [COLUMN.SINGLE_CHOICE]: "q-icon-multiple-choice",
-    [COLUMN.MULTIPLE_CHOICE]: "q-icon-multiple-choice",
-    [COLUMN.BUCKET]: "q-icon-bucket",
-    [COLUMN.FORMULA]: "q-icon-formula",
-    [COLUMN.TEXT_FORMULA]: "q-icon-formula",
-    [COLUMN.DATE_FORMULA]: "q-icon-formula",
-    [COLUMN.NUMERIC_FORMULA]: "q-icon-formula",
-    [COMPLEX_COLUMN.FILEUPLOAD]: "q-icon-file_upload",
-    [COLUMN.AGGREGATED_FORMULA]: "q-icon-an-aggcb",
+    [NUMERICAL_COLUMN.RATING]: "new-q-icon-wf-rating",
+    [COMPLEX_COLUMN.TEXTFIELD]: "new-q-icon-wf-short-text",
+    [COMPLEX_COLUMN.LONGTEXT]: "new-q-icon-wf-long-text",
+    [COLUMN.TEXT_LABEL]: "new-q-icon-qv-justify-left",
+    [COLUMN.TEXT_CATEGORY]: "new-q-icon-qv-justify-left",
+    [COLUMN.YES_NO]: "new-q-icon-wf-yes-no",
+    [COLUMN.RANKING]: "new-q-icon-wf-ranking",
+    [COLUMN.DATE]: "new-q-icon-wf-date",
+    [COLUMN.TIME]: "new-q-icon-wf-dt-time",
+    [NUMERICAL_COLUMN.SLIDEBAR]: "new-q-icon-wf-slide-bar",
+    [COMPLEX_COLUMN.IMAGEUPLOAD]: "new-q-icon-wf-image-upload",
+    [COLUMN.SIGNATURE]: "new-q-icon-wf-signature",
+    [COMPLEX_COLUMN.EXPRESSION]: "new-q-icon-wf-expression",
+    [NUMERICAL_COLUMN.NUMERIC]: "new-q-icon-wf-numeric",
+    [COLUMN.IMAGE]: "new-q-icon-wf-image",
+    [COMPOUND_COLUMN.NAME]: "new-q-icon-wf-name",
+    [COLUMN.EMAIL_FORM]: "new-q-icon-wf-email",
+    [COLUMN.PHONE]: "new-q-icon-wf-phone-number",
+    [COMPOUND_COLUMN.USADDRESS]: "new-q-icon-wf-us-address",
+    [COMPOUND_COLUMN.ADDRESS]: "new-q-icon-wf-address",
+    [COLUMN.PASSWORD]: "new-q-icon-wf-password",
+    [COLUMN.DROPDOWN]: "new-q-icon-wf-dropdown",
+    [COLUMN.LOOKUP]: "new-q-icon-wf-lookup",
+    [COLUMN.SINGLE_CHOICE]: "new-q-icon-wf-multiple-choice",
+    [COLUMN.MULTIPLE_CHOICE]: "new-q-icon-wf-multiple-choice",
+    [COLUMN.BUCKET]: "new-q-icon-an-buckets",
+    [COLUMN.FORMULA]: "new-q-icon-an-formula",
+    [COLUMN.TEXT_FORMULA]: "new-q-icon-an-formula",
+    [COLUMN.DATE_FORMULA]: "new-q-icon-an-formula",
+    [COLUMN.NUMERIC_FORMULA]: "new-q-icon-an-formula",
+    [COMPLEX_COLUMN.FILEUPLOAD]: "new-q-icon-wf-file-upload",
+    [COLUMN.AGGREGATED_FORMULA]: "new-q-icon-wf-dt-array-aggregate",
 };

package/dist/columns/helpers/index.d.ts

@@ -6,3 +6,4 @@ export * from "./isComplexColumn";
 export * from "./isCompoundColumn";
 export * from "./isDateColumn";
 export * from "./isNumericalColumn";
+export * from "./isStringColumn";

package/dist/columns/helpers/index.js

@@ -6,3 +6,4 @@ export * from "./isComplexColumn";
 export * from "./isCompoundColumn";
 export * from "./isDateColumn";
 export * from "./isNumericalColumn";
+export * from "./isStringColumn";

package/dist/columns/helpers/isNumericalColumn.d.ts

@@ -1,7 +1,7 @@
 import { IColumn } from "../interfaces/IColumn";
 /**
  * Validates if the given column is numerical type
- * @param {IColumn} column the column info
+ * @param column the column info
  * @returns true: the column is numerical type
  */
 export declare const isNumericalColumn: (column: IColumn) => boolean;

package/dist/columns/helpers/isNumericalColumn.js

@@ -5,7 +5,7 @@ import { COLUMN } from "../constants/COLUMN";
 import { NUMERICAL_COLUMNS } from "../constants/NUMERICAL_COLUMNS";
 /**
  * Validates if the given column is numerical type
- * @param {IColumn} column the column info
+ * @param column the column info
  * @returns true: the column is numerical type
  */
 export const isNumericalColumn = (column) => !isEmpty(column) &&

package/dist/columns/helpers/isStringColumn.d.ts

@@ -0,0 +1,7 @@
+import { IColumn } from "../interfaces/IColumn";
+/**
+ * Validates if the given column is text type
+ * @param column the column info
+ * @returns true: the column is numerical type
+ */
+export declare const isStringColumn: (column: IColumn) => boolean;

package/dist/columns/helpers/isStringColumn.js

@@ -0,0 +1,15 @@
+import { FORMULA } from "../../formulas/constants/FORMULA";
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isObject } from "../../general/object/isObject";
+import { COLUMN } from "../constants/COLUMN";
+/**
+ * Validates if the given column is text type
+ * @param column the column info
+ * @returns true: the column is numerical type
+ */
+export const isStringColumn = (column) => !isEmpty(column) &&
+    isObject(column) &&
+    ([COLUMN.TEXT_LABEL, COLUMN.LONGTEXT, COLUMN.TEXT_FORMULA].includes(column.type) ||
+        (column.type === COLUMN.FORMULA && column.formulaType === FORMULA.TEXT) ||
+        (column.type === COLUMN.AGGREGATED_FORMULA &&
+            column.formulaType === FORMULA.TEXT));

package/dist/dates/constants/DATE_DISTINCT_PROPERTY.d.ts

@@ -1,5 +1,6 @@
 export declare enum DATE_DISTINCT_PROPERTY {
     YEAR_QUARTER = "quarter_only",
     YEAR_MONTH = "month_only",
-    MONTH_DAY = "day_only"
+    MONTH_DAY = "day_only",
+    DAY_CUSTOM = "day_custom"
 }

package/dist/dates/constants/DATE_DISTINCT_PROPERTY.js

@@ -5,4 +5,5 @@ export var DATE_DISTINCT_PROPERTY;
     // YEAR_DAY = 'p-y-day',
     DATE_DISTINCT_PROPERTY["MONTH_DAY"] = "day_only";
     // WEEK_DAY = 'p-w-day'
+    DATE_DISTINCT_PROPERTY["DAY_CUSTOM"] = "day_custom";
 })(DATE_DISTINCT_PROPERTY || (DATE_DISTINCT_PROPERTY = {}));

package/dist/dates/relative/RelativeStatementAdapter.js

@@ -6,6 +6,7 @@ import { getStatementCase } from "./helpers/getStatementCase";
 import { DATE_GROUPING_PROPERTY } from "../constants/DATE_GROUPING_PROPERTY";
 import { parseDate } from "./helpers/parseDate";
 import { DATETIME_FORMAT } from "./constants/DATE_FORMATS";
+import { isEmpty } from "../../general";
 export class RelativeStatementAdapter {
     constructor(statement, now = new Date()) {
         this.statement =
@@ -19,7 +20,7 @@ export class RelativeStatementAdapter {
         return this.get("unit");
     }
     get anchor() {
-        return this.get("anchor");
+        return isEmpty(this.get("anchor")) ? undefined : this.get("anchor");
     }
     get number() {
         return this.get("number");

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

@@ -0,0 +1,96 @@
+import { CanvasDevice } from "../interfaces/ICanvasGrid";
+import { FindAvailablePositionOptions } from "../interfaces/IFixedPosition";
+import { VemFixed } from "../interfaces/IVemCore";
+import { VemPositionFixed } from "../interfaces/IVemPosition";
+/**
+ * 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 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[], 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;
+}) => {
+    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>[];