@rio-cloud/rio-uikit 1.10.1 → 1.12.0

package/src/utils/cssuseragent.js

@@ -0,0 +1,321 @@
+/* eslint-disable */
+/**
+ * CssUserAgent (cssua.js) v2.1.31
+ * http://cssuseragent.org
+ *
+ * Copyright (c)2006-2015 Stephen M. McKamey.
+ * Licensed under The MIT License.
+ */
+/*jshint smarttabs:true, regexp:false, browser:true */
+/**
+ * @param html {Object} root DOM element
+ * @param userAgent {string} browser userAgent string
+ * @return {Object}
+ */
+export const cssua = (html, userAgent, sa) => {
+    'use strict';
+    /**
+     * @const
+     * @type {string}
+     */
+    var PREFIX = ' ua-';
+    /**
+     * @const
+     * @type {RegExp}
+     */
+    var R_Platform = /\s*([\-\w ]+)[\s\/\:]([\d_]+\b(?:[\-\._\/]\w+)*)/;
+    /**
+     * @const
+     * @type {RegExp}
+     */
+    var R_Version = /([\w\-\.]+[\s\/][v]?[\d_]+\b(?:[\-\._\/]\w+)*)/g;
+    /**
+     * @const
+     * @type {RegExp}
+     */
+    var R_BlackBerry = /\b(?:(blackberry\w*|bb10)|(rim tablet os))(?:\/(\d+\.\d+(?:\.\w+)*))?/;
+    /**
+     * @const
+     * @type {RegExp}
+     */
+    var R_Silk = /\bsilk-accelerated=true\b/;
+    /**
+     * @const
+     * @type {RegExp}
+     */
+    var R_FluidApp = /\bfluidapp\b/;
+    /**
+     * @const
+     * @type {RegExp}
+     */
+    var R_desktop = /(\bwindows\b|\bmacintosh\b|\blinux\b|\bunix\b)/;
+    /**
+     * @const
+     * @type {RegExp}
+     */
+    var R_mobile = /(\bandroid\b|\bipad\b|\bipod\b|\bwindows phone\b|\bwpdesktop\b|\bxblwp7\b|\bzunewp7\b|\bwindows ce\b|\bblackberry\w*|\bbb10\b|\brim tablet os\b|\bmeego|\bwebos\b|\bpalm|\bsymbian|\bj2me\b|\bdocomo\b|\bpda\b|\bchtml\b|\bmidp\b|\bcldc\b|\w*?mobile\w*?|\w*?phone\w*?)/;
+    /**
+     * @const
+     * @type {RegExp}
+     */
+    var R_game = /(\bxbox\b|\bplaystation\b|\bnintendo\s+\w+)/;
+    /**
+     * The root CssUserAgent
+     * @type {Object}
+     */
+    var cssua = {
+        parse: 
+        /**
+         * @param uaStr {string}
+         * @return {Object}
+         */
+        function (uaStr, sa) {
+            /**
+             * @type {Object}
+             */
+            var ua = {};
+            if (sa) {
+                ua.standalone = sa;
+            }
+            uaStr = ('' + uaStr).toLowerCase();
+            if (!uaStr) {
+                return ua;
+            }
+            var i, count, raw = uaStr.split(/[()]/);
+            for (var j = 0, rawCount = raw.length; j < rawCount; j++) {
+                if (j % 2) {
+                    // inside parens covers platform identifiers
+                    var platforms = raw[j].split(';');
+                    for (i = 0, count = platforms.length; i < count; i++) {
+                        if (R_Platform.exec(platforms[i])) {
+                            var key = RegExp.$1.split(' ').join('_'), val = RegExp.$2;
+                            // if duplicate entries favor highest version
+                            if (!ua[key] || parseFloat(ua[key]) < parseFloat(val)) {
+                                ua[key] = val;
+                            }
+                        }
+                    }
+                }
+                else {
+                    // outside parens covers most version identifiers
+                    var uas = raw[j].match(R_Version);
+                    if (uas) {
+                        for (i = 0, count = uas.length; i < count; i++) {
+                            var parts = uas[i].split(/[\/\s]+/);
+                            if (parts.length && parts[0] !== 'mozilla') {
+                                ua[parts[0].split(' ').join('_')] = parts.slice(1).join('-');
+                            }
+                        }
+                    }
+                }
+            }
+            if (R_mobile.exec(uaStr)) {
+                // mobile device indicators
+                ua.mobile = RegExp.$1;
+                if (R_BlackBerry.exec(uaStr)) {
+                    delete ua[ua.mobile];
+                    ua.blackberry = ua.version || RegExp.$3 || RegExp.$2 || RegExp.$1;
+                    if (RegExp.$1) {
+                        // standardize non-tablet blackberry
+                        ua.mobile = 'blackberry';
+                    }
+                    else if (ua.version === '0.0.1') {
+                        // fix playbook 1.0 quirk
+                        ua.blackberry = '7.1.0.0';
+                    }
+                }
+            }
+            else if (R_game.exec(uaStr)) {
+                // game console indicators
+                ua.game = RegExp.$1;
+                var game = ua.game.split(' ').join('_');
+                if (ua.version && !ua[game]) {
+                    ua[game] = ua.version;
+                }
+            }
+            else if (R_desktop.exec(uaStr)) {
+                // desktop OS indicators
+                ua.desktop = RegExp.$1;
+            }
+            // platform naming standardizations
+            if (ua.intel_mac_os_x) {
+                ua.mac_os_x = ua.intel_mac_os_x.split('_').join('.');
+                delete ua.intel_mac_os_x;
+            }
+            else if (ua.cpu_iphone_os) {
+                ua.ios = ua.cpu_iphone_os.split('_').join('.');
+                delete ua.cpu_iphone_os;
+            }
+            else if (ua.cpu_os) {
+                ua.ios = ua.cpu_os.split('_').join('.');
+                delete ua.cpu_os;
+            }
+            else if (ua.mobile === 'iphone' && !ua.ios) {
+                ua.ios = '1';
+            }
+            // UA naming standardizations
+            if (ua.opera && ua.version) {
+                ua.opera = ua.version;
+                // version/XXX refers to opera
+                delete ua.blackberry;
+            }
+            else if (R_Silk.exec(uaStr)) {
+                ua.silk_accelerated = true;
+            }
+            else if (R_FluidApp.exec(uaStr)) {
+                ua.fluidapp = ua.version;
+            }
+            if (ua.edge) {
+                delete ua.applewebkit;
+                delete ua.safari;
+                delete ua.chrome;
+                delete ua.android;
+            }
+            if (ua.applewebkit) {
+                ua.webkit = ua.applewebkit;
+                delete ua.applewebkit;
+                if (ua.opr) {
+                    ua.opera = ua.opr;
+                    delete ua.opr;
+                    delete ua.chrome;
+                }
+                if (ua.safari) {
+                    if (ua.chrome ||
+                        ua.crios ||
+                        ua.fxios ||
+                        ua.opera ||
+                        ua.silk ||
+                        ua.fluidapp ||
+                        ua.phantomjs ||
+                        (ua.mobile && !ua.ios)) {
+                        delete ua.safari;
+                        if (ua.vivaldi) {
+                            delete ua.chrome;
+                        }
+                    }
+                    else if (ua.version && !ua.rim_tablet_os) {
+                        ua.safari = ua.version;
+                    }
+                    else {
+                        ua.safari =
+                            {
+                                419: '2.0.4',
+                                417: '2.0.3',
+                                416: '2.0.2',
+                                412: '2.0',
+                                312: '1.3',
+                                125: '1.2',
+                                85: '1.0',
+                            }[parseInt(ua.safari, 10)] || ua.safari;
+                    }
+                }
+            }
+            else if (ua.msie || ua.trident) {
+                if (!ua.opera) {
+                    // standardize Internet Explorer
+                    ua.ie = ua.msie || ua.rv;
+                }
+                delete ua.msie;
+                delete ua.android;
+                if (ua.windows_phone_os) {
+                    // standardize window phone
+                    ua.windows_phone = ua.windows_phone_os;
+                    delete ua.windows_phone_os;
+                }
+                else if (ua.mobile === 'wpdesktop' || ua.mobile === 'xblwp7' || ua.mobile === 'zunewp7') {
+                    ua.mobile = 'windows desktop';
+                    ua.windows_phone = +ua.ie < 9 ? '7.0' : +ua.ie < 10 ? '7.5' : '8.0';
+                    delete ua.windows_nt;
+                }
+            }
+            else if (ua.gecko || ua.firefox) {
+                ua.gecko = ua.rv;
+            }
+            if (ua.rv) {
+                delete ua.rv;
+            }
+            if (ua.version) {
+                delete ua.version;
+            }
+            return ua;
+        },
+        format: 
+        /**
+         * @param ua {Object}
+         * @return {string}
+         */
+        function (ua) {
+            /**
+             * @param b {string} browser key
+             * @param v {string} browser value
+             * @return {string} formatted CSS classes
+             */
+            function format(b, v) {
+                b = b.split('.').join('-');
+                /**
+                 * @type {string}
+                 */
+                var css = PREFIX + b;
+                if (typeof v === 'string') {
+                    v = v.split(' ').join('_').split('.').join('-');
+                    var i = v.indexOf('-');
+                    while (i > 0) {
+                        // loop through chopping last '-' to end off
+                        // concat result onto return string
+                        css += PREFIX + b + '-' + v.substring(0, i);
+                        i = v.indexOf('-', i + 1);
+                    }
+                    css += PREFIX + b + '-' + v;
+                }
+                return css;
+            }
+            /**
+             * @type {string}
+             */
+            var uaCss = '';
+            for (var b in ua) {
+                if (b && ua.hasOwnProperty(b)) {
+                    uaCss += format(b, ua[b]);
+                }
+            }
+            // user-agent classNames
+            return uaCss;
+        },
+        encode: 
+        /**
+         * Encodes parsed userAgent object as a compact URI-Encoded key-value collection
+         * @param ua {Object}
+         * @return {string}
+         */
+        function (ua) {
+            var query = '';
+            for (var b in ua) {
+                if (b && ua.hasOwnProperty(b)) {
+                    if (query) {
+                        query += '&';
+                    }
+                    query += encodeURIComponent(b) + '=' + encodeURIComponent(ua[b]);
+                }
+            }
+            return query;
+        },
+    };
+    /**
+     * @const
+     * @type {Object}
+     */
+    cssua.userAgent = cssua.ua = cssua.parse(userAgent, sa);
+    /**
+     * @const
+     * @type {string}
+     */
+    var ua = cssua.format(cssua.ua) + ' js';
+    // append CSS classes to HTML node
+    if (html.className) {
+        html.className = html.className.replace(/\bno-js\b/g, '') + ua;
+    }
+    else {
+        html.className = ua.substr(1);
+    }
+    return cssua;
+};

package/src/utils/currentColors.d.ts

@@ -0,0 +1,3 @@
+export declare const currentColorOptions: readonly ["primary", "secondary", "info", "success", "warning", "danger"];
+export type CurrentColor = (typeof currentColorOptions)[number];
+export declare const getCurrentBackgroundColor: (color: CurrentColor) => string;

package/src/utils/currentColors.js

@@ -0,0 +1,10 @@
+export const currentColorOptions = ['primary', 'secondary', 'info', 'success', 'warning', 'danger'];
+const currentColorMapping = {
+    primary: '--brand-primary',
+    secondary: '--brand-secondary',
+    info: '--brand-info',
+    success: '--brand-success',
+    warning: '--brand-warning',
+    danger: '--brand-danger',
+};
+export const getCurrentBackgroundColor = (color) => `var(${currentColorMapping[`${color}`]})`;

package/src/utils/darkModeCDN.d.ts

@@ -0,0 +1,3 @@
+declare const COOKIE_NAME: "uikit-color-scheme";
+declare function readColorSchemeFromCookie(): "default" | "dark" | "light" | "system" | undefined;
+declare function listenForCookieChange(): void;

package/src/utils/darkModeCDN.js

@@ -0,0 +1,48 @@
+"use strict";
+const COOKIE_NAME = 'uikit-color-scheme';
+const readColorSchemeFromCookie = () => {
+    const THEME_DATA_ATTRIBUTE = 'data-theme';
+    const THEME_DEFAULT = 'default';
+    const THEME_SYSTEM = 'system';
+    const THEME_LIGHT = 'light';
+    const THEME_DARK = 'dark';
+    const decodedCookie = decodeURIComponent(document.cookie);
+    // console.debug(decodedCookie);
+    const [uikitCname] = decodedCookie.split(';').filter(entry => entry.includes(COOKIE_NAME));
+    if (!uikitCname) {
+        return;
+    }
+    const [, colorScheme] = uikitCname.split('=');
+    console.debug(`readColorSchemeFromCookie: ${colorScheme}`);
+    if (!colorScheme) {
+        return;
+    }
+    const html = document.documentElement;
+    if (colorScheme === THEME_DEFAULT) {
+        html.removeAttribute(THEME_DATA_ATTRIBUTE);
+        return colorScheme;
+    }
+    if (colorScheme === THEME_SYSTEM) {
+        if (window.matchMedia('(prefers-color-scheme: dark)').matches) {
+            html.setAttribute(THEME_DATA_ATTRIBUTE, THEME_DARK);
+        }
+        else {
+            html.setAttribute(THEME_DATA_ATTRIBUTE, THEME_LIGHT);
+        }
+        return colorScheme;
+    }
+    if (colorScheme === THEME_LIGHT || colorScheme === THEME_DARK) {
+        html.setAttribute(THEME_DATA_ATTRIBUTE, colorScheme);
+        return colorScheme;
+    }
+};
+const listenForCookieChange = () => {
+    const eventHandler = event => {
+        if (event.data === 'themechange') {
+            readColorSchemeFromCookie();
+        }
+    };
+    window?.addEventListener('message', eventHandler, false);
+};
+readColorSchemeFromCookie();
+listenForCookieChange();

package/src/utils/deviceUtils.d.ts

@@ -0,0 +1,13 @@
+export declare const hasTouch: () => boolean;
+export declare const MOBILE_SCREEN = 480;
+export declare const SCREEN_SM = 768;
+export declare const SCREEN_MD = 992;
+export declare const SCREEN_LG = 1200;
+export declare const SCREEN_XL = 1700;
+export declare const isMobileScreen: () => boolean;
+export declare const isMobile: () => boolean;
+export declare const isDesktop: () => boolean;
+export declare const isMac: () => boolean;
+export declare const isRetinaDevice: () => boolean;
+export declare const inIframe: () => boolean;
+export declare const toggleZoomOnMobile: () => void;

package/src/utils/deviceUtils.js

@@ -0,0 +1,70 @@
+import { cssua } from './cssuseragent';
+// As "cssuseragent" is accessing the html dom object directly without checking whether it exists or not,
+// we need to initialize only when html really exists. This avoids issues when running the UIKIT in a web-worker
+if (document?.documentElement) {
+    cssua(document.documentElement, navigator.userAgent, navigator.standalone);
+}
+// biome-ignore lint/suspicious/noExplicitAny: <explanation>
+const isDefined = (val) => val !== undefined && val !== null;
+// see https://patrickhlauke.github.io/touch/touchscreen-detection/ for reference
+export const hasTouch = () => {
+    if (window.PointerEvent && isDefined(navigator.maxTouchPoints)) {
+        // if Pointer Events are supported, just check maxTouchPoints
+        if (navigator.maxTouchPoints > 0) {
+            return true;
+        }
+    }
+    else if (window.matchMedia?.('(any-pointer:coarse)').matches) {
+        // no Pointer Events...
+        // check for any-pointer:coarse which mostly means touchscreen
+        return true;
+    }
+    else if (window.TouchEvent || isDefined(window.ontouchstart)) {
+        // last resort - check for exposed touch events API / event handler
+        return true;
+    }
+    return false;
+};
+// Screen sizes
+export const MOBILE_SCREEN = 480;
+export const SCREEN_SM = 768;
+export const SCREEN_MD = 992;
+export const SCREEN_LG = 1200;
+export const SCREEN_XL = 1700;
+export const isMobileScreen = () => window.matchMedia(`(max-width: ${MOBILE_SCREEN}px)`).matches;
+export const isMobile = () => document?.documentElement.classList.contains('ua-mobile');
+export const isDesktop = () => document?.documentElement.classList.contains('ua-desktop');
+export const isMac = () => document?.documentElement.classList.contains('ua-desktop-macintosh');
+export const isRetinaDevice = () => window.devicePixelRatio > 1;
+export const inIframe = () => {
+    try {
+        return window.self !== window.top;
+    }
+    catch (_) {
+        return true;
+    }
+};
+// Disables the Zoom for the mobile devices.
+// This is not good for accessibility but makes the webpage feel more like a native app.
+// <meta name="viewport" content="user-scalable=0 ..." />
+const USER_SCALABLE = 'user-scalable=0 maximum-scale=1';
+export const toggleZoomOnMobile = () => {
+    if (!document) {
+        return;
+    }
+    const viewportMeta = document.head.querySelector('[name="viewport"]');
+    if (!viewportMeta) {
+        return;
+    }
+    const isScalable = viewportMeta.content.includes(USER_SCALABLE);
+    // Restrict the zoom for mobile if not yet set
+    if (isMobile() && !isScalable) {
+        viewportMeta.content += ` ${USER_SCALABLE}`;
+        return;
+    }
+    // Remove the setting, for non mobile cases
+    if (!isMobile() && isScalable) {
+        viewportMeta.content = viewportMeta.content.replace(USER_SCALABLE, '').trim();
+        return;
+    }
+};

package/src/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;

package/src/utils/formatUtils.js

@@ -0,0 +1,49 @@
+import isNil from 'lodash/fp/isNil';
+/**
+ * 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 const parseNumberFromValue = (value, locale) => {
+    if (isNil(value)) {
+        return 0;
+    }
+    if (typeof value === 'number') {
+        return value;
+    }
+    if (typeof value !== 'string') {
+        return 0;
+    }
+    const example = 1234567.89;
+    const parts = new Intl.NumberFormat(locale).formatToParts(example);
+    const groupSymbol = parts.find(p => p.type === 'group')?.value ?? ',';
+    const decimalSymbol = parts.find(p => p.type === 'decimal')?.value ?? '.';
+    // Extract numeric part only (up to last digit or decimal), ignore units
+    const match = value.match(/[-\d.,'\u00A0\s]+/);
+    if (!match) {
+        return 0;
+    }
+    let numeric = match[0].trim();
+    // Normalize: remove group symbols (thousand delimiter)
+    if (groupSymbol !== decimalSymbol) {
+        numeric = numeric.replaceAll(groupSymbol, '');
+    }
+    // Replace decimal with dot for number parsing
+    if (decimalSymbol !== '.') {
+        numeric = numeric.replace(decimalSymbol, '.');
+    }
+    const parsed = Number.parseFloat(numeric);
+    return Number.isNaN(parsed) ? Number.NaN : parsed;
+};
+/**
+ * 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 const getValueByPath = (obj, path) => {
+    return path.split('.').reduce((acc, key) => (acc && typeof acc === 'object' ? acc[key] : undefined), obj);
+};

package/src/utils/fuelTypeUtils.d.ts

@@ -0,0 +1,62 @@
+import type { IconType } from '../components/rioglyph/Rioglyph';
+export type FuelType = 'unknown' | 'gas' | 'diesel' | 'kerosene' | 'heavy_fuel_oil' | 'methanol' | 'ethanol' | 'lpg' | 'cng' | 'propane' | 'ng' | 'ng_compressed' | 'electric' | 'bi_fuel_gas' | 'bi_fuel_methanol' | 'bi_fuel_ethanol' | 'bi_fuel_lpg' | 'bi_fuel_cng' | 'bi_fuel_ng' | 'bi_fuel_diesel' | 'bi_fuel_propane' | 'bi_fuel_battery' | 'bi_fuel_battery_combustion' | 'hybrid_gas' | 'hybrid_gas_ethanol' | 'hybrid_diesel' | 'hybrid_battery' | 'hybrid_battery_combustion' | 'hybrid_regeneration_mode' | 'dual_fuel_diesel_cng' | 'dual_fuel_diesel_lng' | 'hydrogen' | 'fuel_cell_hydrogen';
+export type FuelTypeGroup = 'liquid' | 'gas' | 'electric' | 'hydrogen' | 'hybrid' | 'unknown';
+/**
+ * Maps each fuel type group to its representative icon.
+ *
+ * This icon can be used to visually identify the group in the UI,
+ * such as in filter buttons or labels.
+ */
+export declare const fuelTypeGroupIcons: Record<FuelTypeGroup, IconType>;
+/**
+ * List of all defined fuel type groups (excluding "unknown").
+ *
+ * Used to render UI elements like filter buttons or fuel group selectors.
+ */
+export declare const fuelTypeGroups: FuelTypeGroup[];
+/**
+ * Returns the icon for a given fuel type group.
+ *
+ * @param fuelTypeGroup - The fuel group to get the icon for.
+ * @returns The corresponding icon for the group.
+ *
+ * @example
+ * getFuelTypeGroupIcon('gas') // → 'rioglyph-fuel-gas'
+ */
+export declare const getFuelTypeGroupIcon: (fuelTypeGroup: FuelTypeGroup) => "rioglyph-status-available" | "rioglyph-status-working" | "rioglyph-status-driving" | "rioglyph-status-resting" | "rioglyph-arrow-left" | "rioglyph-remove" | "rioglyph-arrow-right" | "rioglyph-empty" | "rioglyph-truck-breakdown" | "rioglyph-chevron-down" | "rioglyph-ban-circle" | "rioglyph-wrench" | "rioglyph-stars" | "rioglyph-looking-glass-man" | "rioglyph-academic-cap" | "rioglyph-addressbook" | "rioglyph-air-pay" | "rioglyph-am" | "rioglyph-angle-double-down" | "rioglyph-angle-double-left" | "rioglyph-angle-double-right" | "rioglyph-angle-double-up" | "rioglyph-antenna" | "rioglyph-api" | "rioglyph-archive" | "rioglyph-area-chart" | "rioglyph-area-in" | "rioglyph-area-out" | "rioglyph-arrow-down" | "rioglyph-arrow-up" | "rioglyph-axle" | "rioglyph-battery-level-empty" | "rioglyph-battery-level-full" | "rioglyph-battery-level-low" | "rioglyph-beacon" | "rioglyph-book" | "rioglyph-bookable-poi" | "rioglyph-bookmark-square" | "rioglyph-bookmark" | "rioglyph-border-crossing" | "rioglyph-brake" | "rioglyph-building" | "rioglyph-bus-baseline" | "rioglyph-bus-breakdown" | "rioglyph-bus" | "rioglyph-businessman" | "rioglyph-calendar-parking" | "rioglyph-calendar-plus" | "rioglyph-calendar-today" | "rioglyph-calendar" | "rioglyph-camera" | "rioglyph-car-baseline" | "rioglyph-car-wash" | "rioglyph-car" | "rioglyph-card-hotel" | "rioglyph-card-reader" | "rioglyph-cards-add" | "rioglyph-cards-grid" | "rioglyph-cards-list" | "rioglyph-cards-table" | "rioglyph-cargo" | "rioglyph-carrier" | "rioglyph-chat" | "rioglyph-check-badge" | "rioglyph-check-shield" | "rioglyph-checkbox-checked" | "rioglyph-checkbox" | "rioglyph-checkboxes" | "rioglyph-chevron-left" | "rioglyph-chevron-right" | "rioglyph-chevron-up" | "rioglyph-circle-stack" | "rioglyph-click" | "rioglyph-climate-control" | "rioglyph-clipboard" | "rioglyph-cloud-download" | "rioglyph-cloud-not-saved" | "rioglyph-cloud-upload" | "rioglyph-cloud" | "rioglyph-coasting" | "rioglyph-code-braces" | "rioglyph-code-brackets" | "rioglyph-cog" | "rioglyph-color-swatch" | "rioglyph-comment" | "rioglyph-compare" | "rioglyph-component-custom-recurrent" | "rioglyph-component-custom" | "rioglyph-component" | "rioglyph-construction" | "rioglyph-cookie" | "rioglyph-cooling" | "rioglyph-cost-efficency" | "rioglyph-cruise-control" | "rioglyph-csv" | "rioglyph-currency-euro" | "rioglyph-damages" | "rioglyph-dangerousgoods" | "rioglyph-dashboard" | "rioglyph-delivery-completed" | "rioglyph-delivery-error" | "rioglyph-delivery-late" | "rioglyph-delivery-on-track" | "rioglyph-delivery-warning" | "rioglyph-delivery" | "rioglyph-design" | "rioglyph-desktop" | "rioglyph-detail-view-info" | "rioglyph-detail-view" | "rioglyph-direction" | "rioglyph-document-out" | "rioglyph-document" | "rioglyph-download" | "rioglyph-drag-n-drop" | "rioglyph-drive-history" | "rioglyph-driver-card" | "rioglyph-driver" | "rioglyph-drivercard-in" | "rioglyph-drivercard-out" | "rioglyph-duplicate" | "rioglyph-earphone" | "rioglyph-engine" | "rioglyph-envelope-indicator" | "rioglyph-envelope-open" | "rioglyph-envelope" | "rioglyph-erase" | "rioglyph-error-sign" | "rioglyph-euro-note" | "rioglyph-exclamation-sign" | "rioglyph-exclamation" | "rioglyph-eye-close" | "rioglyph-eye-option" | "rioglyph-face-frown" | "rioglyph-face-neutral" | "rioglyph-face-smile" | "rioglyph-facetime-video" | "rioglyph-factory" | "rioglyph-file-signature" | "rioglyph-files" | "rioglyph-fill" | "rioglyph-filling-e-station" | "rioglyph-filling-station" | "rioglyph-filter-active" | "rioglyph-filter" | "rioglyph-fingerprint" | "rioglyph-finish" | "rioglyph-fire" | "rioglyph-flag" | "rioglyph-flash" | "rioglyph-folder-closed" | "rioglyph-folder-open" | "rioglyph-fuel-diesel" | "rioglyph-fuel-electric" | "rioglyph-fuel-gas" | "rioglyph-fuel-hydrogen" | "rioglyph-fuel-liquid" | "rioglyph-fuel-mix" | "rioglyph-fullscreen" | "rioglyph-geofence" | "rioglyph-globe" | "rioglyph-group" | "rioglyph-hand-down" | "rioglyph-hand-left" | "rioglyph-hand-right" | "rioglyph-hand-up" | "rioglyph-handshake" | "rioglyph-hash" | "rioglyph-heart" | "rioglyph-heating" | "rioglyph-home-sign" | "rioglyph-home" | "rioglyph-hour-glass" | "rioglyph-id" | "rioglyph-inbox-in" | "rioglyph-inbox-out" | "rioglyph-inbox-stack" | "rioglyph-inbox" | "rioglyph-info-sign" | "rioglyph-info" | "rioglyph-key" | "rioglyph-kickdown" | "rioglyph-language" | "rioglyph-layer-pois" | "rioglyph-layer" | "rioglyph-light-bulb" | "rioglyph-line-chart" | "rioglyph-link" | "rioglyph-load-unload" | "rioglyph-load" | "rioglyph-location-arrow" | "rioglyph-lock-open" | "rioglyph-lock" | "rioglyph-log-in" | "rioglyph-logout" | "rioglyph-looking-glass" | "rioglyph-maintenance-components" | "rioglyph-map-location" | "rioglyph-map-marker" | "rioglyph-map" | "rioglyph-megaphone" | "rioglyph-menu-hamburger" | "rioglyph-merge" | "rioglyph-milage" | "rioglyph-minus-light" | "rioglyph-minus-sign" | "rioglyph-minus" | "rioglyph-missing" | "rioglyph-mode-dark-light" | "rioglyph-more" | "rioglyph-new-window" | "rioglyph-newspaper" | "rioglyph-notification" | "rioglyph-number-1" | "rioglyph-number-2" | "rioglyph-number-3" | "rioglyph-off" | "rioglyph-oil-can" | "rioglyph-ok-circle" | "rioglyph-ok-sign" | "rioglyph-ok" | "rioglyph-onboarding" | "rioglyph-ongoing" | "rioglyph-option-horizontal" | "rioglyph-option-vertical" | "rioglyph-order" | "rioglyph-palette-broken" | "rioglyph-palette" | "rioglyph-paper-clip" | "rioglyph-parcel-broken" | "rioglyph-parcel" | "rioglyph-parking" | "rioglyph-pause-circle" | "rioglyph-pause" | "rioglyph-pdf-file" | "rioglyph-pencil-square" | "rioglyph-pencil" | "rioglyph-phone" | "rioglyph-pictures" | "rioglyph-pin-range" | "rioglyph-pin" | "rioglyph-play-circle" | "rioglyph-play" | "rioglyph-plugged-off" | "rioglyph-plugged-on" | "rioglyph-plus-light" | "rioglyph-plus-sign" | "rioglyph-plus" | "rioglyph-pm" | "rioglyph-poi" | "rioglyph-polygon" | "rioglyph-position" | "rioglyph-print" | "rioglyph-progress-ongoing" | "rioglyph-progress-remaining" | "rioglyph-pto-off" | "rioglyph-pto-on" | "rioglyph-pushpin" | "rioglyph-puzzle" | "rioglyph-pylon" | "rioglyph-qr-code" | "rioglyph-question-sign" | "rioglyph-question" | "rioglyph-record" | "rioglyph-refresh" | "rioglyph-remove-circle" | "rioglyph-remove-sign" | "rioglyph-repeat" | "rioglyph-resize-full" | "rioglyph-resize-horizontal" | "rioglyph-resize-small" | "rioglyph-resize-vertical" | "rioglyph-retrofit" | "rioglyph-retweet" | "rioglyph-revert" | "rioglyph-rio-marker" | "rioglyph-rio" | "rioglyph-road-restrictions" | "rioglyph-road" | "rioglyph-robot" | "rioglyph-rocket" | "rioglyph-role-management" | "rioglyph-route-option" | "rioglyph-route-view" | "rioglyph-route" | "rioglyph-ruler" | "rioglyph-save" | "rioglyph-scale" | "rioglyph-scan" | "rioglyph-scissors" | "rioglyph-search-list" | "rioglyph-search-truck" | "rioglyph-search" | "rioglyph-send" | "rioglyph-series" | "rioglyph-server-stack" | "rioglyph-settings" | "rioglyph-share-alt" | "rioglyph-share-nodes" | "rioglyph-share" | "rioglyph-ship" | "rioglyph-shopping-bag" | "rioglyph-shopping-cart" | "rioglyph-signature" | "rioglyph-slope-down-max" | "rioglyph-slope-down-min" | "rioglyph-slope-up-max" | "rioglyph-slope-up-min" | "rioglyph-sort-by-attributes-alt" | "rioglyph-sort-by-attributes" | "rioglyph-sort" | "rioglyph-sparkles" | "rioglyph-speed" | "rioglyph-sphere" | "rioglyph-spinner" | "rioglyph-split-view" | "rioglyph-stack" | "rioglyph-star-empty" | "rioglyph-star" | "rioglyph-start" | "rioglyph-stats" | "rioglyph-steering-wheel" | "rioglyph-stopover" | "rioglyph-support" | "rioglyph-table-view" | "rioglyph-tachograph-download" | "rioglyph-tachograph" | "rioglyph-tag" | "rioglyph-tasks" | "rioglyph-temperature" | "rioglyph-th-list" | "rioglyph-thumbs-down" | "rioglyph-thumbs-up" | "rioglyph-tickets" | "rioglyph-time-alt" | "rioglyph-time-cancle" | "rioglyph-time" | "rioglyph-tire" | "rioglyph-tms" | "rioglyph-to-bottom" | "rioglyph-to-left" | "rioglyph-to-right" | "rioglyph-to-top" | "rioglyph-traffic-lights" | "rioglyph-trailer-baseline" | "rioglyph-trailer" | "rioglyph-trailerposition" | "rioglyph-train" | "rioglyph-transfer" | "rioglyph-trash" | "rioglyph-triangle-bottom" | "rioglyph-triangle-left" | "rioglyph-triangle-right" | "rioglyph-triangle-top" | "rioglyph-trophy" | "rioglyph-truck-baseline" | "rioglyph-truck-unit" | "rioglyph-truck" | "rioglyph-unlink" | "rioglyph-upload" | "rioglyph-user-add" | "rioglyph-user-group" | "rioglyph-user-ok" | "rioglyph-user-remove" | "rioglyph-user-sign-off" | "rioglyph-user-sign" | "rioglyph-user" | "rioglyph-van-baseline" | "rioglyph-van" | "rioglyph-volume" | "rioglyph-wallet" | "rioglyph-warning-sign" | "rioglyph-weather-cloudy" | "rioglyph-weather-icy" | "rioglyph-weather-overcast" | "rioglyph-weather-raining" | "rioglyph-weather-snowing" | "rioglyph-weather-stormy" | "rioglyph-weather-sunny" | "rioglyph-weather-thundering" | "rioglyph-weather-windy" | "rioglyph-weight" | "rioglyph-width" | "rioglyph-wifi-off" | "rioglyph-wifi" | "rioglyph-window" | "rioglyph-workshop" | "rioglyph-xmas-raindeer" | "rioglyph-xmas-santa" | "rioglyph-video-off" | "rioglyph-video";
+/**
+ * Returns the representative icon for a specific fuel type.
+ *
+ * This function maps a fuel type to its logical fuel group,
+ * and returns the icon associated with that group.
+ *
+ * @param fuelType - The specific fuel type of the item. Default is 'unknown'.
+ * @returns The icon associated with the resolved fuel group.
+ *
+ * @example
+ * getFuelIcon('cng') // → 'rioglyph-fuel-gas'
+ */
+export declare const getFuelIcon: (fuelType?: FuelType) => IconType;
+/**
+ * Filters a list of items by fuel group.
+ *
+ * @param items - The list of items to filter.
+ * @param activeGroups - The selected fuel type groups to include in the result.
+ * @param getFuelType - Function to extract the fuel type from an item.
+ * @returns The filtered list containing only items that belong to one of the specified fuel groups.
+ *
+ * @example
+ * filterByFuelTypeGroup(vehicles, ['electric'], v => v.fuelType);
+ */
+export declare const filterByFuelTypeGroup: <T>(items: T[], activeGroups: FuelTypeGroup[], getFuelType: (item: T) => FuelType | undefined) => T[];
+/**
+ * Counts how many items belong to each fuel type group.
+ *
+ * @param items - The list of items to count.
+ * @param getFuelType - Function to extract the fuel type from an item.
+ * @returns An object mapping each fuel type group to its count.
+ *
+ * @example
+ * countFuelTypeGroups(vehicles, v => v.fuelType);
+ */
+export declare const countFuelTypeGroups: <T>(items: T[], getFuelType: (item: T) => FuelType | undefined) => Record<FuelTypeGroup, number>;