@qrvey/utils 1.16.0-4 → 1.16.0-5

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

@@ -94,3 +94,13 @@ export declare const sortElementsFromReferencePoint: (elements: VemFixed<unknown
     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>;

package/dist/cjs/elements/helpers/fixed.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sortElementsFromReferencePoint = exports.calculateDistancesToReferencePoint = exports.getFixedGridElementsBottomLimit = exports.updateFixedElementWidth = exports.recalculatePreservingPositions = exports.findFixedAvailablePositions = exports.getFixedPositionByDevice = exports.findAvailablePosition = exports.updateFixedPosition = void 0;
+exports.updateFixedElementDimensions = exports.sortElementsFromReferencePoint = exports.calculateDistancesToReferencePoint = exports.getFixedGridElementsBottomLimit = exports.updateFixedElementWidth = exports.recalculatePreservingPositions = exports.findFixedAvailablePositions = exports.getFixedPositionByDevice = exports.findAvailablePosition = exports.updateFixedPosition = void 0;
 /* eslint-disable @typescript-eslint/explicit-function-return-type */
 const ICanvasGrid_1 = require("../interfaces/ICanvasGrid");
 const IVemPosition_1 = require("../interfaces/IVemPosition");
@@ -246,3 +246,22 @@ const sortElementsFromReferencePoint = (elements, device, referencePoint) => {
     return sortedElements.map((element) => element.element);
 };
 exports.sortElementsFromReferencePoint = sortElementsFromReferencePoint;
+/**
+ * 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.
+ */
+const updateFixedElementDimensions = (containerItem, device, scopeElements) => {
+    let currentElement = containerItem;
+    const calculatedHeight = (0, fixed_position_1.dxGetFixedGridItemsBottomLimit)(scopeElements, device);
+    const currentHeight = currentElement.position.fixed[device].height;
+    currentElement = updateFixedPosition(currentElement, {
+        height: Math.max(currentHeight, calculatedHeight),
+    }, device);
+    return currentElement;
+};
+exports.updateFixedElementDimensions = updateFixedElementDimensions;

package/dist/cjs/elements/helpers/gridStrategy.d.ts

@@ -17,6 +17,18 @@ interface RecalculateOptions {
  * @returns - A list of elements with updated positions if the canvas type is "fixed" or "responsive".
  */
 export declare function recalculateElements(newElements: Vem[], currentElements: Vem[], canvasWidth: number, canvasType: string, device: CanvasDevice, options?: RecalculateOptions): Vem[];
+/**
+ * Updates the dimensions of a container element using a strategy based on the given canvas type.
+ *
+ * Delegates the update logic to a specific strategy found in `updateDimensionStrategies`
+ * using the provided `canvasType` key.
+ * @param containerItem The element whose dimensions need to be updated
+ * @param scopeElements A list of elements to consider in the update strategy
+ * @param device The device context (e.g., desktop, tablet, mobile) used to retrieve device-specific properties
+ * @param canvasType The type of canvas that determines which strategy to use.
+ * @returns  - The updated element with modified dimensions, or `undefined` if no strategy is found.
+ */
+export declare function updateElementDimensions(containerItem: Vem, scopeElements: Vem[], device: CanvasDevice, canvasType: string): Vem | undefined;
 /**
  * The calculation is delegated to a specific strategy based on the `canvasType`.
  * @param elements - The list of elements in the canvas.

package/dist/cjs/elements/helpers/gridStrategy.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateCanvasHeight = exports.recalculateElements = void 0;
+exports.calculateCanvasHeight = exports.updateElementDimensions = exports.recalculateElements = void 0;
 const fixed_1 = require("./fixed");
 const responsive_1 = require("./responsive");
 const interfaces_1 = require("../interfaces");
 const element_1 = require("../utils/element");
+const updateDimensionStrategies = {
+    fixed: (containerItem, scopeElements, device) => {
+        return (0, fixed_1.updateFixedElementDimensions)(containerItem, device, scopeElements);
+    },
+};
 const recalculateStrategies = {
     fixed: (elements, currentElements, canvasWidth, device, options) => {
         const isSorted = !currentElements.length;
@@ -18,7 +23,7 @@ const recalculateStrategies = {
                 y: 0,
             })
             : changedElements;
-        return options.canvasHeight
+        return options.keepPosition
             ? (0, fixed_1.recalculatePreservingPositions)(orderedElements, device, canvasWidth, options.canvasHeight)
             : (0, fixed_1.findFixedAvailablePositions)(canvasWidth, orderedElements, currentElements, device, false, false, options === null || options === void 0 ? void 0 : options.canvasHeight);
     },
@@ -65,6 +70,25 @@ function recalculateElements(newElements, currentElements, canvasWidth, canvasTy
     return strategy(newElements, currentElements, canvasWidth, device, calculatedOptions);
 }
 exports.recalculateElements = recalculateElements;
+/**
+ * Updates the dimensions of a container element using a strategy based on the given canvas type.
+ *
+ * Delegates the update logic to a specific strategy found in `updateDimensionStrategies`
+ * using the provided `canvasType` key.
+ * @param containerItem The element whose dimensions need to be updated
+ * @param scopeElements A list of elements to consider in the update strategy
+ * @param device The device context (e.g., desktop, tablet, mobile) used to retrieve device-specific properties
+ * @param canvasType The type of canvas that determines which strategy to use.
+ * @returns  - The updated element with modified dimensions, or `undefined` if no strategy is found.
+ */
+function updateElementDimensions(containerItem, scopeElements, device, canvasType) {
+    const strategy = updateDimensionStrategies[canvasType];
+    if (!strategy) {
+        return;
+    }
+    return strategy(containerItem, scopeElements, device);
+}
+exports.updateElementDimensions = updateElementDimensions;
 /**
  * The calculation is delegated to a specific strategy based on the `canvasType`.
  * @param elements - The list of elements in the canvas.

package/dist/cjs/elements/utils/fixed.position.d.ts

@@ -10,3 +10,4 @@ export declare const dxGetFixedGridItemY: (element: VemFixed, device: CanvasDevi
 export declare const dxGetFixedGridItemZ: (element: VemFixed, device: CanvasDevice) => number;
 export declare const dxGetFixedGridItemHeight: (element: VemFixed, device: CanvasDevice) => number;
 export declare const dxGetFixedGridItemWidth: (element: VemFixed, device: CanvasDevice) => number;
+export declare const dxGetFixedGridItemsBottomLimit: (items: VemFixed[], device: CanvasDevice, allowNegative?: boolean) => number;

package/dist/cjs/elements/utils/fixed.position.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dxGetFixedGridItemWidth = exports.dxGetFixedGridItemHeight = exports.dxGetFixedGridItemZ = exports.dxGetFixedGridItemY = exports.dxGetFixedGridItemX = exports.dxGetFixedGridItemDevice = exports.checkFixedGridItemsOverlap = exports.itemYOverflow = exports.itemXOverflow = exports.hasOverlap = exports.hasOverflow = void 0;
+exports.dxGetFixedGridItemsBottomLimit = exports.dxGetFixedGridItemWidth = exports.dxGetFixedGridItemHeight = exports.dxGetFixedGridItemZ = exports.dxGetFixedGridItemY = exports.dxGetFixedGridItemX = exports.dxGetFixedGridItemDevice = exports.checkFixedGridItemsOverlap = exports.itemYOverflow = exports.itemXOverflow = exports.hasOverlap = exports.hasOverflow = void 0;
 const hasOverflow = (element, device, resolution, canvasHeight) => {
     const hasXOverflow = (0, exports.itemXOverflow)(element, device, resolution);
     const hasYOverflow = canvasHeight
@@ -84,3 +84,10 @@ const dxGetFixedGridItemWidth = (element, device) => {
     return (_a = position === null || position === void 0 ? void 0 : position.width) !== null && _a !== void 0 ? _a : 400;
 };
 exports.dxGetFixedGridItemWidth = dxGetFixedGridItemWidth;
+const dxGetFixedGridItemsBottomLimit = (items, device, allowNegative = false) => {
+    return items.length === 0
+        ? 0
+        : Math.max(...items.map((gridItem) => (0, exports.dxGetFixedGridItemY)(gridItem, device, allowNegative) +
+            (0, exports.dxGetFixedGridItemHeight)(gridItem, device)));
+};
+exports.dxGetFixedGridItemsBottomLimit = dxGetFixedGridItemsBottomLimit;

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

@@ -94,3 +94,13 @@ export declare const sortElementsFromReferencePoint: (elements: VemFixed<unknown
     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>;

package/dist/elements/helpers/fixed.js

@@ -1,7 +1,7 @@
 /* eslint-disable @typescript-eslint/explicit-function-return-type */
 import { CanvasDevice } from "../interfaces/ICanvasGrid";
 import { VemPositionType } from "../interfaces/IVemPosition";
-import { dxGetFixedGridItemDevice, hasOverflow, hasOverlap, } from "../utils/fixed.position";
+import { dxGetFixedGridItemDevice, dxGetFixedGridItemsBottomLimit, hasOverflow, hasOverlap, } from "../utils/fixed.position";
 import { sortByDistanceFunction } from "../utils/general";
 import { OverlapIntervalTree } from "../utils/overlap";
 import { setElementPosition } from "../utils/position";
@@ -234,3 +234,21 @@ export const sortElementsFromReferencePoint = (elements, device, referencePoint)
     const sortedElements = [...calculatedElements].sort(sortByDistanceFunction);
     return sortedElements.map((element) => element.element);
 };
+/**
+ * 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 const updateFixedElementDimensions = (containerItem, device, scopeElements) => {
+    let currentElement = containerItem;
+    const calculatedHeight = dxGetFixedGridItemsBottomLimit(scopeElements, device);
+    const currentHeight = currentElement.position.fixed[device].height;
+    currentElement = updateFixedPosition(currentElement, {
+        height: Math.max(currentHeight, calculatedHeight),
+    }, device);
+    return currentElement;
+};

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

@@ -17,6 +17,18 @@ interface RecalculateOptions {
  * @returns - A list of elements with updated positions if the canvas type is "fixed" or "responsive".
  */
 export declare function recalculateElements(newElements: Vem[], currentElements: Vem[], canvasWidth: number, canvasType: string, device: CanvasDevice, options?: RecalculateOptions): Vem[];
+/**
+ * Updates the dimensions of a container element using a strategy based on the given canvas type.
+ *
+ * Delegates the update logic to a specific strategy found in `updateDimensionStrategies`
+ * using the provided `canvasType` key.
+ * @param containerItem The element whose dimensions need to be updated
+ * @param scopeElements A list of elements to consider in the update strategy
+ * @param device The device context (e.g., desktop, tablet, mobile) used to retrieve device-specific properties
+ * @param canvasType The type of canvas that determines which strategy to use.
+ * @returns  - The updated element with modified dimensions, or `undefined` if no strategy is found.
+ */
+export declare function updateElementDimensions(containerItem: Vem, scopeElements: Vem[], device: CanvasDevice, canvasType: string): Vem | undefined;
 /**
  * The calculation is delegated to a specific strategy based on the `canvasType`.
  * @param elements - The list of elements in the canvas.

package/dist/elements/helpers/gridStrategy.js

@@ -1,7 +1,12 @@
-import { findFixedAvailablePositions, getFixedGridElementsBottomLimit, recalculatePreservingPositions, sortElementsFromReferencePoint, } from "./fixed";
+import { findFixedAvailablePositions, getFixedGridElementsBottomLimit, recalculatePreservingPositions, sortElementsFromReferencePoint, updateFixedElementDimensions, } from "./fixed";
 import { findResponsiveAvailablePositions, getResponsiveGridElementsBottomLimit, sortResponsiveElements, } from "./responsive";
 import { CanvasDevice, VemPositionType, } from "../interfaces";
 import { copyDesktopPositionToDevice } from "../utils/element";
+const updateDimensionStrategies = {
+    fixed: (containerItem, scopeElements, device) => {
+        return updateFixedElementDimensions(containerItem, device, scopeElements);
+    },
+};
 const recalculateStrategies = {
     fixed: (elements, currentElements, canvasWidth, device, options) => {
         const isSorted = !currentElements.length;
@@ -15,7 +20,7 @@ const recalculateStrategies = {
                 y: 0,
             })
             : changedElements;
-        return options.canvasHeight
+        return options.keepPosition
             ? recalculatePreservingPositions(orderedElements, device, canvasWidth, options.canvasHeight)
             : findFixedAvailablePositions(canvasWidth, orderedElements, currentElements, device, false, false, options === null || options === void 0 ? void 0 : options.canvasHeight);
     },
@@ -61,6 +66,24 @@ export function recalculateElements(newElements, currentElements, canvasWidth, c
     const calculatedOptions = Object.assign(Object.assign({}, defaultOptions), options);
     return strategy(newElements, currentElements, canvasWidth, device, calculatedOptions);
 }
+/**
+ * Updates the dimensions of a container element using a strategy based on the given canvas type.
+ *
+ * Delegates the update logic to a specific strategy found in `updateDimensionStrategies`
+ * using the provided `canvasType` key.
+ * @param containerItem The element whose dimensions need to be updated
+ * @param scopeElements A list of elements to consider in the update strategy
+ * @param device The device context (e.g., desktop, tablet, mobile) used to retrieve device-specific properties
+ * @param canvasType The type of canvas that determines which strategy to use.
+ * @returns  - The updated element with modified dimensions, or `undefined` if no strategy is found.
+ */
+export function updateElementDimensions(containerItem, scopeElements, device, canvasType) {
+    const strategy = updateDimensionStrategies[canvasType];
+    if (!strategy) {
+        return;
+    }
+    return strategy(containerItem, scopeElements, device);
+}
 /**
  * The calculation is delegated to a specific strategy based on the `canvasType`.
  * @param elements - The list of elements in the canvas.

package/dist/elements/utils/fixed.position.d.ts

@@ -10,3 +10,4 @@ export declare const dxGetFixedGridItemY: (element: VemFixed, device: CanvasDevi
 export declare const dxGetFixedGridItemZ: (element: VemFixed, device: CanvasDevice) => number;
 export declare const dxGetFixedGridItemHeight: (element: VemFixed, device: CanvasDevice) => number;
 export declare const dxGetFixedGridItemWidth: (element: VemFixed, device: CanvasDevice) => number;
+export declare const dxGetFixedGridItemsBottomLimit: (items: VemFixed[], device: CanvasDevice, allowNegative?: boolean) => number;

package/dist/elements/utils/fixed.position.js

@@ -70,3 +70,9 @@ export const dxGetFixedGridItemWidth = (element, device) => {
     const position = element.position.fixed[device];
     return (_a = position === null || position === void 0 ? void 0 : position.width) !== null && _a !== void 0 ? _a : 400;
 };
+export const dxGetFixedGridItemsBottomLimit = (items, device, allowNegative = false) => {
+    return items.length === 0
+        ? 0
+        : Math.max(...items.map((gridItem) => dxGetFixedGridItemY(gridItem, device, allowNegative) +
+            dxGetFixedGridItemHeight(gridItem, device)));
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qrvey/utils",
-  "version": "1.16.0-4",
+  "version": "1.16.0-5",
   "description": "Helper, Utils for all Qrvey Projects",
   "homepage": "https://bitbucket.org/qrvey/qrvey_utils/wiki/Home",
   "main": "dist/index.js",