@rio-cloud/rio-uikit 1.10.0 → 1.11.0

package/lib/es/components/assetTree/TreeNode.d.ts

@@ -4,6 +4,7 @@ export type TreeNodeProps = {
     node: GroupedItem;
     hasMultiselect?: boolean;
     isSelected?: boolean;
+    isOpen?: boolean;
     isIndeterminate?: boolean;
     onToggleNode: (nodeId: string) => void;
     onSelect: (node: GroupedItem, isIndeterminate: boolean) => void;

package/lib/es/components/assetTree/TreeNode.js

@@ -13,10 +13,11 @@ const withRioglyphPrefix = (name) => {
     return name.startsWith('rioglyph-') ? name : `rioglyph-${name}`;
 };
 const TreeNode = react_1.default.memo((props) => {
-    const { node, hasMultiselect = false, isSelected = false, isIndeterminate = false, onToggleNode, onSelect } = props;
+    const { node, hasMultiselect = false, isSelected = false, isOpen = false, isIndeterminate = false, onToggleNode, onSelect, } = props;
     const treeNodeClassNames = (0, classnames_1.default)('TreeNode', 'from-group', isSelected && 'checked', node.className && node.className);
     const hasChildren = !!node.items.length;
-    const iconName = withRioglyphPrefix(node.icon);
+    const expandedIcon = node.expandedIcon || node.icon;
+    const iconName = isOpen ? withRioglyphPrefix(expandedIcon) : withRioglyphPrefix(node.icon);
     return ((0, jsx_runtime_1.jsxs)("div", { className: treeNodeClassNames, "data-key": node.id, onClick: () => hasChildren && onToggleNode(node.id), children: [hasMultiselect && ((0, jsx_runtime_1.jsx)(Checkbox_1.default, { className: 'TreeCheckbox', checked: isSelected, disabled: node.disabled, indeterminate: isIndeterminate, onClick: () => onSelect(node, isIndeterminate) })), (0, jsx_runtime_1.jsxs)("span", { className: 'TreeLabel TreeLabelName', children: [iconName && (0, jsx_runtime_1.jsx)("span", { className: `rioglyph ${iconName}` }), (0, jsx_runtime_1.jsx)("span", { className: 'TreeLabelNameText', children: (0, jsx_runtime_1.jsx)("span", { className: 'TreeLabelNameTextHeadline', children: node.name }) }), (0, jsx_runtime_1.jsx)("span", { className: 'TreeLabelCount label label-muted label-filled label-condensed', children: node.items.length }), (0, jsx_runtime_1.jsx)("span", { className: `TreeLabelExpander rioglyph rioglyph-chevron-down ${hasChildren ? '' : 'text-color-light'}` })] })] }));
 });
 exports.default = TreeNode;

package/lib/es/components/dialog/SplitDialog.d.ts

@@ -37,6 +37,12 @@ export type SplitDialogProps = Omit<BaseDialogProps, 'useOverflow'> & {
      * @default true
      */
     useOverflow?: boolean;
+    /**
+     * Allows to disable the divider.
+     *
+     * @default true
+     */
+    showDivider?: boolean;
 };
 declare const SplitDialog: (props: SplitDialogProps) => import("react/jsx-runtime").JSX.Element;
 export default SplitDialog;

package/lib/es/components/dialog/SplitDialog.js

@@ -5,10 +5,10 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const classnames_1 = tslib_1.__importDefault(require("classnames"));
 const Dialog_1 = tslib_1.__importDefault(require("./Dialog"));
 const SplitDialog = (props) => {
-    const { leftContent, rightContent, leftContentClassName = '', rightContentClassName = '', className = '', useOverflow = true, ...remainingProps } = props;
+    const { leftContent, rightContent, leftContentClassName = '', rightContentClassName = '', className = '', useOverflow = true, showDivider = true, ...remainingProps } = props;
     const dialogClassName = `split-dialog ${className}`;
     const dividerClasses = (0, classnames_1.default)('split-divider', 'bg-lighter');
-    const body = ((0, jsx_runtime_1.jsxs)("div", { className: 'split-wrapper', children: [(0, jsx_runtime_1.jsxs)("div", { className: `split-left ${leftContentClassName}`, children: [leftContent, (0, jsx_runtime_1.jsx)("div", { className: dividerClasses })] }), (0, jsx_runtime_1.jsx)("div", { className: `split-right ${rightContentClassName}`, children: rightContent })] }));
+    const body = ((0, jsx_runtime_1.jsxs)("div", { className: 'split-wrapper', children: [(0, jsx_runtime_1.jsxs)("div", { className: `split-left ${leftContentClassName}`, children: [leftContent, showDivider && (0, jsx_runtime_1.jsx)("div", { className: dividerClasses })] }), (0, jsx_runtime_1.jsx)("div", { className: `split-right ${rightContentClassName}`, children: rightContent })] }));
     return (0, jsx_runtime_1.jsx)(Dialog_1.default, { ...remainingProps, body: body, className: dialogClassName, useOverflow: useOverflow });
 };
 exports.default = SplitDialog;

package/lib/es/components/filepicker/FilePicker.d.ts

@@ -25,7 +25,7 @@ export type FilePickerProps = {
      */
     label?: string | ReactNode;
     /**
-     * Maximum file size.
+     * Maximum file size in byte. 5 MB = 5,242,880 byte
      */
     maxSize?: number;
     /**

package/lib/es/components/formLabel/FormLabel.js

@@ -26,7 +26,7 @@ const FormLabel = (props) => {
         }
     }, []);
     const supportingTextClasses = (0, classnames_1.default)('text-color-gray', 'text-italic', parentSize === 'sm' && 'text-size-10', parentSize === 'lg' && 'text-size-14', !parentSize && 'text-size-12');
-    if (isLabel) {
+    if (isLabel && remainingProps.htmlFor) {
         const labelClasses = (0, classnames_1.default)(!supportingText && 'display-inline-block', supportingText && 'display-inline-flex flex-wrap justify-content-between width-100pct', className);
         return (
         // biome-ignore lint/a11y/noLabelWithoutControl: <explanation>

package/lib/es/components/map/components/Map.js

@@ -44,6 +44,15 @@ const Map = (props) => {
         else {
             console.debug('initialize here map');
         }
+        if (api?.map) {
+            // Cleanup any previously initialized map before doing anything else
+            console.debug('disposing previous map');
+            (0, eventHandling_1.removeEventListenerMap)(api.map);
+            if (api.mapEvents) {
+                api.mapEvents.dispose();
+            }
+            api.map.dispose();
+        }
         const bounds = boundingBox && (0, mapUtils_1.getMapBounds)(boundingBox);
         // Initialize communication with the platform
         const platform = (0, rendering_1.getPlatform)(credentials);
@@ -56,7 +65,7 @@ const Map = (props) => {
         // @ts-ignore-next-line: according to the Here docs, the engine type exists
         // see https://www.here.com/docs/bundle/maps-api-for-javascript-developer-guide/page/topics/harp-migrate.html
         const defaultLayers = platform.createDefaultLayers({ engineType, lg: language, pois: true });
-        const defaultLayerMap = (0, rendering_1.getBaseLayer)({
+        (0, rendering_1.getBaseLayer)({
             baseLayerName: baseLayer,
             defaultLayers,
             enableWebGL,
@@ -66,76 +75,69 @@ const Map = (props) => {
             language,
             minZoom,
             maxZoom: safeMaxZoom,
-        });
-        // Initialize the map
-        const hereMap = new H.Map(mapRef.current, defaultLayerMap.baseLayer, {
-            zoom,
-            center,
-            bounds,
-            engineType,
-            pixelRatio: devicePixelRatio,
-            fixedCenter: true,
-        });
-        if (defaultLayerMap.overlayLayer) {
-            // Special case for satellite map where we render street labels and road signs as well as additional pois as vector data
-            hereMap.addLayer(defaultLayerMap.overlayLayer);
-        }
-        setMapInitialized(true);
-        let hereMapEvents = false;
-        let hereBehavior;
-        // Enable the map event system
-        if (!disableMapEvents) {
-            hereMapEvents = new H.mapevents.MapEvents(hereMap);
-        }
-        if (!(disableMapEvents || disableBehavior)) {
-            hereBehavior = new H.mapevents.Behavior(hereMapEvents);
-            // @ts-ignore-next-line
-            hereBehavior.disable(H.mapevents.Behavior.Feature.FRACTIONAL_ZOOM);
-            if (disableZoomMomentum) {
-                // Disable the inertia that occurs on WebGL maps when scrolling/zooming.
-                // This resulted in a very high scroll sensitivity.
-                // @ts-ignore-next-line
-                hereBehavior.disable(H.mapevents.Behavior.Feature.ZOOM_MOMENTUM);
+        }).then(defaultLayerMap => {
+            // Initialize the map
+            const hereMap = new H.Map(mapRef.current, defaultLayerMap.baseLayer, {
+                zoom,
+                center,
+                bounds,
+                engineType,
+                pixelRatio: devicePixelRatio,
+                fixedCenter: true,
+            });
+            if (defaultLayerMap.overlayLayer) {
+                // Special case for satellite map where we render street labels and road signs as well as additional pois as vector data
+                // hereMap.setBaseLayer(defaultLayerMap.baseLayer);
+                hereMap.addLayer(defaultLayerMap.overlayLayer);
             }
-        }
-        (0, eventHandling_1.addEventListenerMap)(hereMap, eventListenerMap, hereMap);
-        const hereUi = (0, mapUi_1.getHereUi)(hereMap, defaultLayers, showScaleBar, language);
-        // The api will be passed to services when using a render function.
-        // This allows the service to access the map internals
-        setApi({
-            credentials,
-            defaultLayers,
-            map: hereMap,
-            mapEvents: hereMapEvents,
-            behavior: hereBehavior,
-            platform,
-            ui: hereUi,
-            utils: (0, mapUtils_1.createUtils)(hereMap),
-            // Put settings back into the map API object so the invoking service
-            // can check on these settings for instance inside a test
-            settings: {
-                enableWebGL,
-                baseLayer,
-                activeLayers,
-                showCluster,
-                minZoom,
-                maxZoom: safeMaxZoom,
-            },
-        });
-        // If the base layer changed, re-add all previous objects again,
-        // otherwise the map would be empty
-        if (allMapObjects) {
-            hereMap.addObjects(allMapObjects);
-        }
-        return () => {
-            if (hereMap) {
-                (0, eventHandling_1.removeEventListenerMap)(hereMap);
-                if (hereMapEvents) {
-                    hereMapEvents.dispose();
+            setMapInitialized(true);
+            let hereMapEvents = false;
+            let hereBehavior;
+            if (!disableMapEvents) {
+                // Enable the map event system
+                hereMapEvents = new H.mapevents.MapEvents(hereMap);
+            }
+            if (!(disableMapEvents || disableBehavior)) {
+                hereBehavior = new H.mapevents.Behavior(hereMapEvents);
+                // @ts-ignore-next-line
+                hereBehavior.disable(H.mapevents.Behavior.Feature.FRACTIONAL_ZOOM);
+                if (disableZoomMomentum) {
+                    // Disable the inertia that occurs on WebGL maps when scrolling/zooming.
+                    // This resulted in a very high scroll sensitivity.
+                    // @ts-ignore-next-line
+                    hereBehavior.disable(H.mapevents.Behavior.Feature.ZOOM_MOMENTUM);
                 }
-                hereMap.dispose();
             }
-        };
+            (0, eventHandling_1.addEventListenerMap)(hereMap, eventListenerMap, hereMap);
+            const hereUi = (0, mapUi_1.getHereUi)(hereMap, defaultLayers, showScaleBar, language);
+            // The api will be passed to services when using a render function.
+            // This allows the service to access the map internals
+            setApi({
+                credentials,
+                defaultLayers,
+                map: hereMap,
+                mapEvents: hereMapEvents,
+                behavior: hereBehavior,
+                platform,
+                ui: hereUi,
+                utils: (0, mapUtils_1.createUtils)(hereMap),
+                // Put settings back into the map API object so the invoking service
+                // can check on these settings for instance inside a test
+                settings: {
+                    enableWebGL,
+                    baseLayer,
+                    activeLayers,
+                    showCluster,
+                    minZoom,
+                    maxZoom: safeMaxZoom,
+                },
+            });
+            if (allMapObjects) {
+                // If the base layer changed, re-add all previous objects again,
+                // otherwise the map would be empty
+                hereMap.addObjects(allMapObjects);
+            }
+        });
     }, [enableWebGL, enableDevicePixelRatio, language, baseLayer, minZoom, maxZoom]);
     const isDarkMode = (0, useDarkMode_1.default)();
     (0, react_1.useEffect)(() => {

package/lib/es/components/map/components/features/settings/builtinSettings/MapTypeSettings.d.ts

@@ -3,7 +3,7 @@ import type { MapType } from '../../../../utils/mapTypes';
 export type MapTypeSettingsProps = {
     mapType?: string;
     enableNightMap?: boolean;
-    onMapTypeChange?: () => MapType;
+    onMapTypeChange?: (type: MapType) => void;
     defaultTypeLabel?: string | JSX.Element;
     truckTypeLabel?: string | JSX.Element;
     terrainTypeLabel?: string | JSX.Element;

package/lib/es/components/map/utils/rendering.d.ts

@@ -20,4 +20,4 @@ export type BaseLayerResponse = {
     baseLayer: H.map.layer.Layer;
     overlayLayer?: H.map.layer.Layer;
 };
-export declare const getBaseLayer: ({ baseLayerName, defaultLayers, enableWebGL, platform, engineType, language, vehicleRestrictions, minZoom, maxZoom, }: BaseLayer) => BaseLayerResponse;
+export declare const getBaseLayer: ({ baseLayerName, defaultLayers, enableWebGL, platform, engineType, language, vehicleRestrictions, minZoom, maxZoom, }: BaseLayer) => Promise<BaseLayerResponse>;

package/lib/es/components/map/utils/rendering.js

@@ -55,7 +55,7 @@ const getEngineType = (baseLayerName, enableWebGL) => {
     }
 };
 exports.getEngineType = getEngineType;
-const getBaseLayer = ({ baseLayerName, defaultLayers, enableWebGL, platform, engineType, language, vehicleRestrictions, minZoom, maxZoom, }) => {
+const getBaseLayer = async ({ baseLayerName, defaultLayers, enableWebGL, platform, engineType, language, vehicleRestrictions, minZoom, maxZoom, }) => {
     const restriction = 'disabled'; // vehicleRestrictions ? 'active_and_inactive' : 'disabled';
     const features = `pois:all,environmental_zones:all,congestion_zones:all,vehicle_restrictions:${restriction}`;
     if (enableWebGL && baseLayerName === constants_1.MAP_TYPE_DEFAULT) {
@@ -70,7 +70,7 @@ const getBaseLayer = ({ baseLayerName, defaultLayers, enableWebGL, platform, eng
             if (enableWebGL) {
                 // This is a workaround for setting the min and max zoom limit for satellite map
                 // since the setMin/setMax cannot be set on the "defaultLayers.hybrid.liteday.raster".
-                // The HERE support suggests to create a hybrid layer for that and set the zoom limits
+                // The HERE support suggested to create a hybrid layer for that and set the zoom limits
                 // on the two layers.
                 const hybridStyleConfig = {
                     base: {
@@ -78,24 +78,20 @@ const getBaseLayer = ({ baseLayerName, defaultLayers, enableWebGL, platform, eng
                         scheme: 'hybrid.day',
                     },
                 };
-                let baseLayer;
-                let overlayLayer;
                 // This method creates hybrid map layers. A hybrid map consists of raster satellite base layer and vector layers on top.
                 // Layers created by this method can be used only when the Map is instantiated with H.Map.EngineType.HARP engineType.
                 // See https://www.here.com/docs/bundle/maps-api-for-javascript-api-reference/page/H.service.Platform_4.html#createHybridLayers
                 // @ts-ignore-next-line
-                platform.createHybridLayers(hybridStyleConfig, (layers) => {
+                await platform.createHybridLayers(hybridStyleConfig, (layers) => {
                     layers.raster.setMin(minZoom);
                     layers.raster.setMax(maxZoom);
                     layers.vector.setMin(minZoom);
                     layers.vector.setMax(maxZoom);
-                    baseLayer = layers.raster;
-                    overlayLayer = layers.vector;
+                    return {
+                        baseLayer: layers.raster,
+                        overlayLayer: layers.vector,
+                    };
                 }, console.error);
-                return {
-                    baseLayer,
-                    overlayLayer,
-                };
             }
             return {
                 baseLayer: (0, exports.getBaseTileLayer)((0, exports.getBaseRasterTileService)(platform, 'explore.satellite.day', features, language), engineType, minZoom, maxZoom),

package/lib/es/hooks/useAverage.d.ts

@@ -0,0 +1,18 @@
+export type UseAverageOptions = {
+    /**
+     * The locale used to parse localized number formats (e.g. "de-DE", "en-GB").
+     * @default "en-GB".
+     */
+    locale?: string;
+};
+/**
+ * Calculates the average of numeric values from a list of objects.
+ * Values are extracted using a dot-separated path and parsed with locale awareness.
+ *
+ * @param items - The list of objects to aggregate.
+ * @param path - Dot-separated path to the value in each object.
+ * @param options - Optional configuration (e.g. locale for number parsing).
+ * @returns The average of all valid values as a number. Returns 0 if no values are valid.
+ */
+declare const useAverage: (items: unknown[], path: string, options?: UseAverageOptions) => number;
+export default useAverage;

package/lib/es/hooks/useAverage.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const formatUtils_1 = require("../utils/formatUtils");
+/**
+ * Calculates the average of numeric values from a list of objects.
+ * Values are extracted using a dot-separated path and parsed with locale awareness.
+ *
+ * @param items - The list of objects to aggregate.
+ * @param path - Dot-separated path to the value in each object.
+ * @param options - Optional configuration (e.g. locale for number parsing).
+ * @returns The average of all valid values as a number. Returns 0 if no values are valid.
+ */
+const useAverage = (items, path, options = {}) => {
+    const { locale = 'en-GB' } = options;
+    return (0, react_1.useMemo)(() => {
+        const values = items
+            .map(item => {
+            const raw = (0, formatUtils_1.getValueByPath)(item, path);
+            return (0, formatUtils_1.parseNumberFromValue)(raw, locale);
+        })
+            .filter(num => !Number.isNaN(num) && num !== 0);
+        if (values.length === 0) {
+            return 0;
+        }
+        const sum = values.reduce((total, value) => total + value, 0);
+        return sum / values.length;
+    }, [items, path, locale]);
+};
+exports.default = useAverage;

package/lib/es/hooks/useCount.d.ts

@@ -0,0 +1,22 @@
+export type UseCountOptions = {
+    /**
+     * Count only values that strictly equal this value.
+     * If omitted and no `match` is provided, any value that is not null or undefined will be counted.
+     */
+    equals?: unknown;
+    /**
+     * A custom matcher function. If provided, it overrides the `equals` option.
+     */
+    match?: (value: unknown) => boolean;
+};
+/**
+ * Counts how many items in a list match a specific condition at a given path.
+ * Supports exact value comparison or custom predicate logic.
+ *
+ * @param items - The list of objects to evaluate.
+ * @param path - Dot-separated path to the target property.
+ * @param options - Optional config with `equals` or a custom `match` function.
+ * @returns Number of items that satisfy the condition.
+ */
+declare const useCount: (items: unknown[], path: string, options?: UseCountOptions) => number;
+export default useCount;

package/lib/es/hooks/useCount.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const formatUtils_1 = require("../utils/formatUtils");
+/**
+ * Counts how many items in a list match a specific condition at a given path.
+ * Supports exact value comparison or custom predicate logic.
+ *
+ * @param items - The list of objects to evaluate.
+ * @param path - Dot-separated path to the target property.
+ * @param options - Optional config with `equals` or a custom `match` function.
+ * @returns Number of items that satisfy the condition.
+ */
+const useCount = (items, path, options = {}) => {
+    const { equals, match } = options;
+    return (0, react_1.useMemo)(() => {
+        return items.reduce((count, item) => {
+            const value = (0, formatUtils_1.getValueByPath)(item, path);
+            let shouldCount = false;
+            if (typeof match === 'function') {
+                shouldCount = match(value);
+            }
+            else if (equals !== undefined) {
+                shouldCount = value === equals;
+            }
+            else {
+                shouldCount = value != null; // fallback: count all defined values
+            }
+            return shouldCount ? count + 1 : count;
+        }, 0);
+    }, [items, path, equals, match]);
+};
+exports.default = useCount;

package/lib/es/hooks/useMax.d.ts

@@ -0,0 +1,18 @@
+export type UseMaxOptions = {
+    /**
+     * The locale used to parse localized number formats (e.g. "de-DE", "en-GB").
+     * @default "en-GB".
+     */
+    locale?: string;
+};
+/**
+ * Finds the maximum numeric value from a list of objects.
+ * Values are extracted using a dot-separated path and parsed with locale awareness.
+ *
+ * @param items - The list of objects to evaluate.
+ * @param path - Dot-separated path to the value in each object.
+ * @param options - Optional configuration (e.g. locale for number parsing).
+ * @returns The largest of all valid values, or 0 if none are valid.
+ */
+declare const useMax: (items: unknown[], path: string, options?: UseMaxOptions) => number;
+export default useMax;

package/lib/es/hooks/useMax.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const formatUtils_1 = require("../utils/formatUtils");
+/**
+ * Finds the maximum numeric value from a list of objects.
+ * Values are extracted using a dot-separated path and parsed with locale awareness.
+ *
+ * @param items - The list of objects to evaluate.
+ * @param path - Dot-separated path to the value in each object.
+ * @param options - Optional configuration (e.g. locale for number parsing).
+ * @returns The largest of all valid values, or 0 if none are valid.
+ */
+const useMax = (items, path, options = {}) => {
+    const { locale = 'en-GB' } = options;
+    return (0, react_1.useMemo)(() => {
+        const values = items
+            .map(item => {
+            const valueFromPath = (0, formatUtils_1.getValueByPath)(item, path);
+            return (0, formatUtils_1.parseNumberFromValue)(valueFromPath, locale);
+        })
+            .filter(num => !Number.isNaN(num));
+        return values.length > 0 ? Math.max(...values) : 0;
+    }, [items, path, locale]);
+};
+exports.default = useMax;

package/lib/es/hooks/useMin.d.ts

@@ -0,0 +1,18 @@
+export type UseMinOptions = {
+    /**
+     * The locale used to parse localized number formats (e.g. "de-DE", "en-GB").
+     * @default "en-GB".
+     */
+    locale?: string;
+};
+/**
+ * Finds the minimum numeric value from a list of objects.
+ * Values are extracted using a dot-separated path and parsed with locale awareness.
+ *
+ * @param items - The list of objects to evaluate.
+ * @param path - Dot-separated path to the value in each object.
+ * @param options - Optional configuration (e.g. locale for number parsing).
+ * @returns The smallest of all valid values, or 0 if none are valid.
+ */
+declare const useMin: (items: unknown[], path: string, options?: UseMinOptions) => number;
+export default useMin;

package/lib/es/hooks/useMin.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const formatUtils_1 = require("../utils/formatUtils");
+/**
+ * Finds the minimum numeric value from a list of objects.
+ * Values are extracted using a dot-separated path and parsed with locale awareness.
+ *
+ * @param items - The list of objects to evaluate.
+ * @param path - Dot-separated path to the value in each object.
+ * @param options - Optional configuration (e.g. locale for number parsing).
+ * @returns The smallest of all valid values, or 0 if none are valid.
+ */
+const useMin = (items, path, options = {}) => {
+    const { locale = 'en-GB' } = options;
+    return (0, react_1.useMemo)(() => {
+        const values = items
+            .map(item => {
+            const valueFromPath = (0, formatUtils_1.getValueByPath)(item, path);
+            return (0, formatUtils_1.parseNumberFromValue)(valueFromPath, locale);
+        })
+            .filter(num => !Number.isNaN(num));
+        return values.length > 0 ? Math.min(...values) : 0;
+    }, [items, path, locale]);
+};
+exports.default = useMin;

package/lib/es/hooks/useSum.d.ts

@@ -0,0 +1,18 @@
+export type UseSumOptions = {
+    /**
+     * The locale used to parse localized number formats (e.g. "de-DE", "en-GB").
+     * @default "en-GB".
+     */
+    locale?: string;
+};
+/**
+ * Calculates the sum of numeric values from a list of objects, using a defined property path.
+ * Supports localized number strings (e.g. "1.234,56 €", "1,000.75").
+ *
+ * @param items - The list of objects to sum values from.
+ * @param path - The dot-separated path to the target value in each object.
+ * @param options - Optional configuration such as locale for parsing.
+ * @returns The total sum of all valid parsed values as a number.
+ */
+declare const useSum: (items: unknown[], path: string, options?: UseSumOptions) => number;
+export default useSum;

package/lib/es/hooks/useSum.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const formatUtils_1 = require("../utils/formatUtils");
+/**
+ * Calculates the sum of numeric values from a list of objects, using a defined property path.
+ * Supports localized number strings (e.g. "1.234,56 €", "1,000.75").
+ *
+ * @param items - The list of objects to sum values from.
+ * @param path - The dot-separated path to the target value in each object.
+ * @param options - Optional configuration such as locale for parsing.
+ * @returns The total sum of all valid parsed values as a number.
+ */
+const useSum = (items, path, options = {}) => {
+    const { locale = 'en-GB' } = options;
+    const sum = (0, react_1.useMemo)(() => {
+        return items.reduce((total, item) => {
+            const raw = (0, formatUtils_1.getValueByPath)(item, path);
+            const value = (0, formatUtils_1.parseNumberFromValue)(raw, locale);
+            return total + value;
+        }, 0);
+    }, [items, path, locale]);
+    return sum;
+};
+exports.default = useSum;

package/lib/es/useAverage.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hooks/useAverage';
+export * from './hooks/useAverage';

package/lib/es/useAverage.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+const tslib_1 = require("tslib");
+var useAverage_1 = require("./hooks/useAverage");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return tslib_1.__importDefault(useAverage_1).default; } });
+tslib_1.__exportStar(require("./hooks/useAverage"), exports);

package/lib/es/useCount.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hooks/useCount';
+export * from './hooks/useCount';

package/lib/es/useCount.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+const tslib_1 = require("tslib");
+var useCount_1 = require("./hooks/useCount");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return tslib_1.__importDefault(useCount_1).default; } });
+tslib_1.__exportStar(require("./hooks/useCount"), exports);

package/lib/es/useMax.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hooks/useMax';
+export * from './hooks/useMax';

package/lib/es/useMax.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+const tslib_1 = require("tslib");
+var useMax_1 = require("./hooks/useMax");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return tslib_1.__importDefault(useMax_1).default; } });
+tslib_1.__exportStar(require("./hooks/useMax"), exports);

package/lib/es/useMin.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hooks/useMin';
+export * from './hooks/useMin';

package/lib/es/useMin.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+const tslib_1 = require("tslib");
+var useMin_1 = require("./hooks/useMin");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return tslib_1.__importDefault(useMin_1).default; } });
+tslib_1.__exportStar(require("./hooks/useMin"), exports);

package/lib/es/useSum.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hooks/useSum';
+export * from './hooks/useSum';

package/lib/es/useSum.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+const tslib_1 = require("tslib");
+var useSum_1 = require("./hooks/useSum");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return tslib_1.__importDefault(useSum_1).default; } });
+tslib_1.__exportStar(require("./hooks/useSum"), exports);

package/lib/es/utils/formatUtils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Helper to extract a number from a string that may have units or grouping delimiters. It take localization into account.
+ *
+ * @param value
+ * @param locale
+ * @returns parsed number
+ */
+export declare const parseNumberFromValue: (value: unknown, locale: string) => number;
+/**
+ * Retrieves a nested property value from an object using dot-notation.
+ *
+ * @param obj - The object to retrieve the value from.
+ * @param path - Dot-separated path to the desired property (e.g. "price.amount").
+ * @returns The value at the given path or undefined if not found.
+ */
+export declare const getValueByPath: (obj: unknown, path: string) => unknown;