@rio-cloud/rio-uikit 1.10.1 → 1.12.0

package/lib/es/src/utils/init/initCSS.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkCSSVersion = exports.initCSS = void 0;
+const initConfig_1 = require("./initConfig");
+const version_json_1 = require("../../version.json");
+const documentHas = (selector) => !!document.head.querySelector(selector);
+const documentHasAnyOf = (selectors) => selectors.some(documentHas);
+const BRANDS = ['rio', 'man', 'vw', 'scania', 'traton'];
+const isValidBrand = (input) => BRANDS.includes(input);
+const getBrand = (input) => (isValidBrand(input) ? input : 'rio');
+const initCSS = () => {
+    if (!window.CSS || !window.CSS.supports || !window.CSS.supports('gap: 1px')) {
+        document.documentElement.classList.add('css-no-gap');
+    }
+    if (initConfig_1.isInIframe) {
+        document.documentElement.classList.add('window-iframe');
+    }
+    if (document.title?.includes('UIKIT Demo')) {
+        return;
+    }
+    (0, initConfig_1.debug)('Checking for UIKIT CSS in document head.');
+    const hasUikitCssLink = documentHasAnyOf(['link[href*="rio-uikit.css"]', 'link[href*="rio-uikit-core.css"]']);
+    const isUikitDemoPage = documentHas('style[data-vite-dev-id*="uikit.scss"]');
+    const hasUikitBrandCssLink = documentHasAnyOf([
+        'link[href*="man-uikit.css"]',
+        'link[href*="vw-uikit.css"]',
+        'link[href*="scania-uikit.css"]',
+        'link[href*="traton-uikit.css"]',
+        'link[href*="rio-website.css"]',
+    ]);
+    if (hasUikitCssLink || isUikitDemoPage || hasUikitBrandCssLink) {
+        (0, initConfig_1.debug)('UIKIT CSS found in document head.');
+        return;
+    }
+    // If nothing is set, add a link tag to fetch the CSS from the UIKIT CDN.
+    // Note: there is no way to differentiate between core + responsive or full CSS
+    (0, initConfig_1.debug)('No UIKIT CSS found => append link tag to document head.');
+    const brand = getBrand(document.documentElement.dataset.brand);
+    const link = document.createElement('link');
+    link.rel = 'stylesheet';
+    link.type = 'text/css';
+    link.href = `https://uikit.developers.rio.cloud/${version_json_1.version}/${brand}-uikit.css`;
+    document.head.appendChild(link);
+};
+exports.initCSS = initCSS;
+const checkCSSVersion = () => {
+    const cssLinks = [...document.querySelectorAll('link[rel="stylesheet"]')];
+    cssLinks.forEach(cssLink => {
+        const { href } = cssLink;
+        if (href.includes('uikit.developers.rio.cloud')) {
+            const [, uikitVersionCSS] = new URL(href).pathname.split('/');
+            if (!href.includes(version_json_1.version)) {
+                console.warn(
+                // biome-ignore lint/style/useTemplate: <explanation>
+                'You are using different UIKIT JS and CSS versions.\n' +
+                    `Your current JS version is ${version_json_1.version} and ` +
+                    `your current CSS version is ${uikitVersionCSS}.\n` +
+                    'If this is not on purpose, please fix it. Otherwise, this may lead to UI bugs.');
+            }
+        }
+        else if (href.includes('cdn.rio.cloud/libs/rio-uikit')) {
+            console.error('You are still using an old "cdn.rio.cloud" css import. This will most likely cause major UI bugs! ' +
+                'Please update to the CSS URLs as explained on https://uikit.developers.rio.cloud/#start/howto.');
+        }
+    });
+};
+exports.checkCSSVersion = checkCSSVersion;
+// remote URL is not supported by most browsers yet
+// export const addTabsClippingSVG = () => {
+//     const clippingSVG = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+//     clippingSVG.setAttribute('width', '0');
+//     clippingSVG.setAttribute('height', '0');
+//     clippingSVG.setAttribute('id', 'tabs-rounded-clipping-mask');
+//     clippingSVG.innerHTML = `
+//         <clipPath id='tabs-rounded-clip-mask'>
+//             <path fill-rule='evenodd' d='M0 4a4 4 0 0 0 4-4v4z' />
+//         </clipPath>`;
+//     document.body.appendChild(clippingSVG);
+// };

package/lib/es/src/utils/init/initConfig.d.ts

@@ -0,0 +1,4 @@
+export declare const isProd: boolean;
+export declare const isTest: boolean;
+export declare const isInIframe: boolean;
+export declare const debug: (message: string) => false | void;

package/lib/es/src/utils/init/initConfig.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debug = exports.isInIframe = exports.isTest = exports.isProd = void 0;
+const tslib_1 = require("tslib");
+const process_1 = tslib_1.__importDefault(require("process"));
+const deviceUtils_1 = require("../deviceUtils");
+// Note: using import.meta.env.DEV does not work here due to backward compatibility with webpack and jest setups
+exports.isProd = process_1.default.env.NODE_ENV === 'production' || location.protocol.startsWith('https');
+exports.isTest = process_1.default.env.NODE_ENV === 'test';
+exports.isInIframe = (0, deviceUtils_1.inIframe)();
+const debug = (message) => !exports.isTest && console.debug(message);
+exports.debug = debug;

package/lib/es/src/utils/init/initDocumentBootstrapping.d.ts

@@ -0,0 +1 @@
+export declare const initDocumentBootstrapping: () => Promise<void>;

package/lib/es/src/utils/init/initDocumentBootstrapping.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initDocumentBootstrapping = void 0;
+const colorScheme_1 = require("../colorScheme");
+const initConfig_1 = require("./initConfig");
+const usedUikitVersion_1 = require("./usedUikitVersion");
+const weAreHiring_1 = require("./weAreHiring");
+const doNotUseTailwind_1 = require("./doNotUseTailwind");
+const initCSS_1 = require("./initCSS");
+const checkForReleaseVersion_1 = require("./checkForReleaseVersion");
+const styledLogs_1 = require("./styledLogs");
+const initDocumentBootstrapping = async () => {
+    if (!document || !document.documentElement) {
+        return;
+    }
+    // Initialize the CSS setup
+    (0, initCSS_1.initCSS)();
+    if (!initConfig_1.isTest) {
+        // Handle the current color scheme (e.g., light/dark mode)
+        (0, colorScheme_1.getColorScheme)();
+        (0, colorScheme_1.listenForSchemeChange)();
+        // Verify the UIKIT version of the application
+        await (0, checkForReleaseVersion_1.checkForReleaseVersion)();
+        // Ensure the correct CSS version is being used
+        (0, initCSS_1.checkCSSVersion)();
+        if (!initConfig_1.isInIframe) {
+            const logStyled = (message) => console.log('%c%s', (0, styledLogs_1.getConsoleStyle)(), message);
+            logStyled('- - - - - - - - - - - - - - - - - -');
+            // Log or validate the UI Kit version
+            (0, usedUikitVersion_1.usedUikitVersion)();
+            // Show a hiring message
+            (0, weAreHiring_1.weAreHiring)();
+            logStyled('- - - - - - - - - - - - - - - - - -');
+        }
+    }
+    // Enforce the rule that Tailwind CSS should not be used
+    await (0, doNotUseTailwind_1.doNotUseTailwind)();
+};
+exports.initDocumentBootstrapping = initDocumentBootstrapping;

package/lib/es/src/utils/init/styledLogs.d.ts

@@ -0,0 +1,3 @@
+export declare const getConsoleStyle: (params?: {
+    isBold?: boolean;
+}) => string;

package/lib/es/src/utils/init/styledLogs.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConsoleStyle = void 0;
+const getConsoleStyle = (params) => {
+    return `color: #697a8b; ${params?.isBold ? 'font-weight: 800' : ''}`;
+};
+exports.getConsoleStyle = getConsoleStyle;

package/lib/es/src/utils/init/usedUikitVersion.d.ts

@@ -0,0 +1 @@
+export declare const usedUikitVersion: () => void;

package/lib/es/src/utils/init/usedUikitVersion.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usedUikitVersion = void 0;
+const version_json_1 = require("../../version.json");
+const styledLogs_1 = require("./styledLogs");
+const logStyled = (message) => console.log('%c%s', (0, styledLogs_1.getConsoleStyle)(), message);
+const usedUikitVersion = () => {
+    const message = `RIO UIKIT Version ${version_json_1.version}\nhttps://uikit.developers.rio.cloud`;
+    logStyled(message);
+};
+exports.usedUikitVersion = usedUikitVersion;

package/lib/es/src/utils/init/weAreHiring.d.ts

@@ -0,0 +1 @@
+export declare const weAreHiring: () => void;

package/lib/es/src/utils/init/weAreHiring.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.weAreHiring = void 0;
+const styledLogs_1 = require("./styledLogs");
+const logStyled = (message) => console.log('%c%s', (0, styledLogs_1.getConsoleStyle)(), message);
+const weAreHiring = () => {
+    const message = 'You are a Developer? RIO is hiring!\nhttps://company.rio.cloud/en/career/jobs';
+    logStyled(message);
+};
+exports.weAreHiring = weAreHiring;

package/lib/es/src/utils/logDeprecatedWarnings.d.ts

@@ -0,0 +1,9 @@
+export declare const BASE_URL = "https://uikit.developers.rio.cloud/";
+type DeprecatedPropType = {
+    prop: string;
+    propCaption?: string;
+    replacement?: string;
+    url?: string;
+};
+export declare const logDeprecatedWarnings: (deprecatedProps: DeprecatedPropType[], props: unknown, componentName?: string, removeVersion?: string, additionalText?: string) => void;
+export default logDeprecatedWarnings;

package/lib/es/src/utils/logDeprecatedWarnings.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logDeprecatedWarnings = exports.BASE_URL = void 0;
+const tslib_1 = require("tslib");
+const has_1 = tslib_1.__importDefault(require("lodash/fp/has"));
+exports.BASE_URL = 'https://uikit.developers.rio.cloud/';
+// Logs deprecation warnings to console if prop is used.
+// use this function in the render method of a component.
+const logDeprecatedWarnings = (deprecatedProps, props, componentName, removeVersion, additionalText) => {
+    deprecatedProps.forEach(deprecatedProp => {
+        // Check whether the deprecated prop is used by checking the component props
+        if ((0, has_1.default)(deprecatedProp.prop, props)) {
+            console.warn([
+                'RIO UIKIT: ',
+                deprecatedProp.propCaption ? deprecatedProp.propCaption : 'Prop',
+                ` "${deprecatedProp.prop}" is deprecated`,
+                componentName ? ` for "${componentName}"` : '',
+                removeVersion ? ` and will be removed in v${removeVersion}` : '',
+                deprecatedProp.replacement ? `. Please use "${deprecatedProp.replacement}" instead` : '',
+                deprecatedProp.url ? ` as documented in ${exports.BASE_URL}${deprecatedProp.url}. ` : '.',
+                additionalText ? ` ${additionalText}` : '',
+            ].join(''));
+        }
+    });
+};
+exports.logDeprecatedWarnings = logDeprecatedWarnings;
+exports.default = exports.logDeprecatedWarnings;

package/lib/es/src/utils/mergeRefs.d.ts

@@ -0,0 +1,3 @@
+import { type Ref } from 'react';
+declare const mergeRefs: <T>(refs: Ref<T>[]) => Ref<T>;
+export default mergeRefs;

package/lib/es/src/utils/mergeRefs.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Utility function to merge multiple refs
+const mergeRefs = (refs) => {
+    return (value) => {
+        refs.forEach(ref => {
+            if (typeof ref === 'function') {
+                ref(value);
+            }
+            else if (ref) {
+                ref.current = value;
+            }
+        });
+    };
+};
+exports.default = mergeRefs;

package/lib/es/src/utils/portalRoot.d.ts

@@ -0,0 +1,2 @@
+export declare const PORTAL_ROOT_ID = "uikit-root";
+export declare const getOrCreatePortalRoot: () => HTMLElement;

package/lib/es/src/utils/portalRoot.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOrCreatePortalRoot = exports.PORTAL_ROOT_ID = void 0;
+exports.PORTAL_ROOT_ID = 'uikit-root';
+const getOrCreatePortalRoot = () => {
+    const dropdownRoot = document.getElementById(exports.PORTAL_ROOT_ID);
+    const newRoot = document.createElement('div');
+    newRoot.setAttribute('id', exports.PORTAL_ROOT_ID);
+    return dropdownRoot ? dropdownRoot : document.body.appendChild(newRoot);
+};
+exports.getOrCreatePortalRoot = getOrCreatePortalRoot;

package/lib/es/src/utils/routeUtils.d.ts

@@ -0,0 +1,15 @@
+export type ColumnsSettings = {
+    columnOrder: string[];
+    hiddenColumns: string[];
+    columnsDetails: Record<string, {
+        width: number;
+        defaultWidth?: number;
+    }>;
+};
+export declare const getSortDirShort: (sortDir: string) => "-" | "+";
+export declare const parseSorting: (sortValueShort: string) => {
+    sortBy: string;
+    sortDir: "desc" | "asc";
+};
+export declare const mapColumnsSettingsToStrings: ({ columnOrder, hiddenColumns, columnsDetails, }: ColumnsSettings) => string[];
+export declare const parseColumnsSettingsStrings: (settings: string[], defaultColumnsDetails: ColumnsSettings["columnsDetails"]) => ColumnsSettings;

package/lib/es/src/utils/routeUtils.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseColumnsSettingsStrings = exports.mapColumnsSettingsToStrings = exports.parseSorting = exports.getSortDirShort = void 0;
+const tslib_1 = require("tslib");
+const get_1 = tslib_1.__importDefault(require("lodash/fp/get"));
+const isFinite_1 = tslib_1.__importDefault(require("lodash/fp/isFinite"));
+const SortUtils_1 = require("./SortUtils");
+const getSortDirShort = (sortDir) => (sortDir === SortUtils_1.SortDirection.DESCENDING ? '-' : '+');
+exports.getSortDirShort = getSortDirShort;
+const parseSorting = (sortValueShort) => {
+    const sortDir = sortValueShort.startsWith('-') ? SortUtils_1.SortDirection.DESCENDING : SortUtils_1.SortDirection.ASCENDING;
+    // Note: due to a bug in qs 6.7.0 the '+' sorting will be parsed as a space by qs even though decoding is disabled
+    // therefore, we need to trim the value
+    return {
+        sortBy: sortValueShort.replace(/^[+-]/, '').trim(),
+        sortDir,
+    };
+};
+exports.parseSorting = parseSorting;
+const mapColumnsSettingsToStrings = ({ columnOrder = [], hiddenColumns = [], columnsDetails = {}, }) => {
+    const mappedColumns = columnOrder.map(column => {
+        const currentWidth = (0, get_1.default)('width')(columnsDetails[column]);
+        const defaultWidth = (0, get_1.default)('defaultWidth')(columnsDetails[column]);
+        const width = currentWidth !== 0 && currentWidth !== defaultWidth ? `:${currentWidth}` : '';
+        const hiddenSign = hiddenColumns.includes(column) ? '-' : '';
+        return `${hiddenSign}${column}${width}`;
+    });
+    return mappedColumns;
+};
+exports.mapColumnsSettingsToStrings = mapColumnsSettingsToStrings;
+const parseColumnsSettingsStrings = (settings, defaultColumnsDetails) => {
+    const columns = {
+        columnOrder: [],
+        hiddenColumns: [],
+        columnsDetails: { ...defaultColumnsDetails },
+    };
+    settings.map(setting => {
+        const [column, columnWidth] = setting.split(':');
+        const columnKey = column.startsWith('-') ? column.substr(1) : column;
+        columns.columnOrder = [...columns.columnOrder, columnKey];
+        if (columnWidth) {
+            const width = parseInt(columnWidth, 10);
+            if ((0, isFinite_1.default)(width)) {
+                columns.columnsDetails[columnKey] = { ...columns.columnsDetails[columnKey], width };
+            }
+        }
+        else {
+            columns.columnsDetails[columnKey] = { ...defaultColumnsDetails[columnKey] };
+        }
+        if (column.startsWith('-')) {
+            columns.hiddenColumns = [...columns.hiddenColumns, columnKey];
+        }
+    });
+    return columns;
+};
+exports.parseColumnsSettingsStrings = parseColumnsSettingsStrings;

package/lib/es/src/utils/scrollItemIntoView.d.ts

@@ -0,0 +1,3 @@
+export declare const UP = "up";
+export declare const DOWN = "down";
+export declare const scrollItemIntoView: (direction: string, dropDownDOMNode: HTMLElement | null, focusedItemDOMNode: HTMLElement | null | undefined) => void;

package/lib/es/src/utils/scrollItemIntoView.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scrollItemIntoView = exports.DOWN = exports.UP = void 0;
+exports.UP = 'up';
+exports.DOWN = 'down';
+// Scroll to selected dropdown menu-item in case the item is not visible due to overflow
+const scrollItemIntoView = (direction, dropDownDOMNode, focusedItemDOMNode) => {
+    if (!dropDownDOMNode || !focusedItemDOMNode) {
+        return;
+    }
+    const menuHeight = dropDownDOMNode.clientHeight;
+    const itemHeight = focusedItemDOMNode.clientHeight;
+    const itemOffsetTop = focusedItemDOMNode.offsetTop;
+    switch (direction) {
+        case exports.UP:
+            if (itemOffsetTop < dropDownDOMNode.scrollTop) {
+                dropDownDOMNode.scrollTop = dropDownDOMNode.scrollTop - itemHeight;
+            }
+            break;
+        case exports.DOWN:
+            if (itemOffsetTop > menuHeight - itemHeight) {
+                dropDownDOMNode.scrollTop = dropDownDOMNode.scrollTop + itemHeight;
+            }
+            break;
+        default:
+            break;
+    }
+};
+exports.scrollItemIntoView = scrollItemIntoView;

package/lib/es/src/utils/searchNormalized.d.ts

@@ -0,0 +1,2 @@
+export declare const normalizeForSearch: (input: string) => string;
+export declare const searchNormalized: (input: string, search: string) => boolean;

package/lib/es/src/utils/searchNormalized.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchNormalized = exports.normalizeForSearch = void 0;
+const normalizeForSearch = (input) => input.replaceAll(/\s+/g, ' ').toLowerCase();
+exports.normalizeForSearch = normalizeForSearch;
+const searchNormalized = (input, search) => (0, exports.normalizeForSearch)(input).includes((0, exports.normalizeForSearch)(search));
+exports.searchNormalized = searchNormalized;

package/lib/es/src/utils/storageUtils.d.ts

@@ -0,0 +1,5 @@
+export declare const storage: {
+    save: (key: string, value: string, prefix?: string) => string | null;
+    load: (key: string, prefix?: string) => string | null;
+    removeItem: (key: string, prefix?: string) => void;
+};

package/lib/es/src/utils/storageUtils.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storage = void 0;
+const localStorage = window.localStorage;
+const STORAGE_PREFIX = '';
+const save = (key, value, prefix = STORAGE_PREFIX) => {
+    try {
+        localStorage.setItem(`${prefix}${key}`, JSON.stringify(value));
+        return value;
+    }
+    catch (_) {
+        // Intentionally left blank
+    }
+    return null;
+};
+const removeItem = (key, prefix = STORAGE_PREFIX) => {
+    try {
+        localStorage.removeItem(`${prefix}${key}`);
+    }
+    catch (_) {
+        // Intentionally left blank
+    }
+};
+const load = (key, prefix = STORAGE_PREFIX) => {
+    try {
+        const item = localStorage.getItem(`${prefix}${key}`);
+        return item && JSON.parse(item);
+    }
+    catch (_) {
+        // Intentionally left blank
+    }
+    return null;
+};
+exports.storage = { save, load, removeItem };

package/lib/es/src/utils/urlFeatureToggles.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_PREFIX = "featureToggle.";
+export type ToggleType = string | boolean | number;
+export declare const cleanupOldToggles: (oldToggles: string[], prefix: string) => void;
+export declare const asBoolean: (urlParamName: string) => (prefix: string) => boolean | null;
+export declare const asBooleanWithDefault: (urlParamName: string, defaultValue: boolean) => (prefix: string) => boolean;
+export declare const asString: (urlParamName: string) => (prefix: string) => string | null;
+export declare const asStringWithDefault: (urlParamName: string, defaultValue: string) => (prefix: string) => string;
+export declare const asNumber: (urlParamName: string) => (prefix: string) => number | null;
+export declare const asNumberWithDefault: (urlParamName: string, defaultValue: number) => (prefix: string) => number;
+type ToggleValueExtractor = (prefix: string) => ToggleType | null;
+type ToggleValues<TOGGLE_DEFS> = TOGGLE_DEFS extends Record<string, ToggleValueExtractor> ? {
+    [K in keyof TOGGLE_DEFS]: ReturnType<TOGGLE_DEFS[K]>;
+} : never;
+export declare const detectFeatureToggles: <TOGGLE_DEFS extends Record<string, ToggleValueExtractor>>(toggleDefinitions: TOGGLE_DEFS, oldToggles?: string[], prefix?: string) => ToggleValues<TOGGLE_DEFS>;
+export {};

package/lib/es/src/utils/urlFeatureToggles.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectFeatureToggles = exports.asNumberWithDefault = exports.asNumber = exports.asStringWithDefault = exports.asString = exports.asBooleanWithDefault = exports.asBoolean = exports.cleanupOldToggles = exports.DEFAULT_PREFIX = void 0;
+const tslib_1 = require("tslib");
+const qs_1 = tslib_1.__importDefault(require("qs"));
+const mapValues_1 = tslib_1.__importDefault(require("lodash/fp/mapValues"));
+const forEach_1 = tslib_1.__importDefault(require("lodash/fp/forEach"));
+const get_1 = tslib_1.__importDefault(require("lodash/fp/get"));
+const storageUtils_1 = require("./storageUtils");
+exports.DEFAULT_PREFIX = 'featureToggle.';
+const cleanupOldToggles = (oldToggles, prefix) => {
+    try {
+        (0, forEach_1.default)(toggle => storageUtils_1.storage.removeItem(toggle, prefix), oldToggles);
+    }
+    catch (error) {
+        console.error(error);
+    }
+};
+exports.cleanupOldToggles = cleanupOldToggles;
+const detectToggle = (param, prefix, transformFn, defaultValue) => {
+    const [_, searchParams = ''] = window.location.hash.split('?');
+    const urlSearchParams = qs_1.default.parse(searchParams);
+    const urlValue = (0, get_1.default)(param, urlSearchParams)?.toString() || '';
+    const storageValue = urlValue ? storageUtils_1.storage.save(param, urlValue, prefix) : storageUtils_1.storage.load(param, prefix);
+    return storageValue ? transformFn(storageValue) : defaultValue;
+};
+const transformBoolean = (value) => value === 'true' || value === '1';
+const transformString = (value) => value;
+const transformNumber = (value) => Number.parseFloat(value);
+const asBoolean = (urlParamName) => (prefix) => detectToggle(urlParamName, prefix, transformBoolean, null);
+exports.asBoolean = asBoolean;
+const asBooleanWithDefault = (urlParamName, defaultValue) => (prefix) => detectToggle(urlParamName, prefix, transformBoolean, defaultValue);
+exports.asBooleanWithDefault = asBooleanWithDefault;
+const asString = (urlParamName) => (prefix) => detectToggle(urlParamName, prefix, transformString, null);
+exports.asString = asString;
+const asStringWithDefault = (urlParamName, defaultValue) => (prefix) => detectToggle(urlParamName, prefix, transformString, defaultValue);
+exports.asStringWithDefault = asStringWithDefault;
+const asNumber = (urlParamName) => (prefix) => detectToggle(urlParamName, prefix, transformNumber, null);
+exports.asNumber = asNumber;
+const asNumberWithDefault = (urlParamName, defaultValue) => (prefix) => detectToggle(urlParamName, prefix, transformNumber, defaultValue);
+exports.asNumberWithDefault = asNumberWithDefault;
+const detectFeatureToggles = (toggleDefinitions, oldToggles = [], prefix = exports.DEFAULT_PREFIX) => {
+    (0, exports.cleanupOldToggles)(oldToggles, prefix);
+    return (0, mapValues_1.default)(toggleFn => toggleFn(prefix), toggleDefinitions);
+};
+exports.detectFeatureToggles = detectFeatureToggles;

package/lib/es/src/utils/useDropDirection.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+export type DropDirection = {
+    pullRight: boolean;
+    dropup: boolean;
+};
+export type UseDropDirection = {
+    pullRight: boolean;
+    dropup: boolean;
+    autoDropDirection: boolean;
+    dropdownMenuRef: React.RefObject<HTMLUListElement>;
+};
+export declare const useDropDirection: ({ pullRight, dropup, autoDropDirection, dropdownMenuRef }: UseDropDirection, dependencies: unknown[]) => DropDirection;

package/lib/es/src/utils/useDropDirection.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDropDirection = void 0;
+const tslib_1 = require("tslib");
+// biome-ignore lint/style/useImportType: required for JSX runtime compatibility with older toolchains
+const react_1 = require("react");
+const getDropDirection_1 = tslib_1.__importDefault(require("./getDropDirection"));
+const useDropDirection = ({ pullRight = false, dropup = false, autoDropDirection = false, dropdownMenuRef }, dependencies) => {
+    // Note: Using an object for local state has lead to tests getting stuck here.
+    // The solution was to split the values into dedicated state primitives here.
+    const [internalPullRight, setInternalPullRight] = (0, react_1.useState)(pullRight);
+    const [internalDropup, setInternalDropup] = (0, react_1.useState)(dropup);
+    const isAutoDropActive = () => !(!autoDropDirection || dropup || pullRight);
+    // Overwrite position of dropdown menu in case auto drop is enabled
+    (0, react_1.useEffect)(() => {
+        if (dropdownMenuRef.current && isAutoDropActive()) {
+            const result = (0, getDropDirection_1.default)(dropdownMenuRef.current.parentNode, dropdownMenuRef.current);
+            setInternalPullRight(result.pullRight);
+            setInternalDropup(result.dropup);
+        }
+    }, [...dependencies, dropdownMenuRef.current]);
+    return {
+        pullRight: internalPullRight,
+        dropup: internalDropup,
+    };
+};
+exports.useDropDirection = useDropDirection;

package/lib/es/src/values/Placement.d.ts

@@ -0,0 +1,19 @@
+import type { ObjectValues } from '../utils/ObjectValues';
+export declare const PLACEMENT: {
+    readonly AUTO_START: "auto-start";
+    readonly AUTO: "auto";
+    readonly AUTO_END: "auto-end";
+    readonly TOP_START: "top-start";
+    readonly TOP: "top";
+    readonly TOP_END: "top-end";
+    readonly RIGHT_START: "right-start";
+    readonly RIGHT: "right";
+    readonly RIGHT_END: "right-end";
+    readonly BOTTOM_START: "bottom-start";
+    readonly BOTTOM: "bottom";
+    readonly BOTTOM_END: "bottom-end";
+    readonly LEFT_START: "left-start";
+    readonly LEFT: "left";
+    readonly LEFT_END: "left-end";
+};
+export type Placement = ObjectValues<typeof PLACEMENT>;

package/lib/es/src/values/Placement.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLACEMENT = void 0;
+exports.PLACEMENT = {
+    AUTO_START: 'auto-start',
+    AUTO: 'auto',
+    AUTO_END: 'auto-end',
+    TOP_START: 'top-start',
+    TOP: 'top',
+    TOP_END: 'top-end',
+    RIGHT_START: 'right-start',
+    RIGHT: 'right',
+    RIGHT_END: 'right-end',
+    BOTTOM_START: 'bottom-start',
+    BOTTOM: 'bottom',
+    BOTTOM_END: 'bottom-end',
+    LEFT_START: 'left-start',
+    LEFT: 'left',
+    LEFT_END: 'left-end',
+};

package/lib/es/src/values/TextAlignment.d.ts

@@ -0,0 +1,7 @@
+import type { ObjectValues } from '../utils/ObjectValues';
+export declare const TEXT_ALIGNMENT: {
+    readonly LEFT: "left";
+    readonly CENTER: "center";
+    readonly RIGHT: "right";
+};
+export type TextAlignment = ObjectValues<typeof TEXT_ALIGNMENT>;

package/lib/es/src/values/TextAlignment.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEXT_ALIGNMENT = void 0;
+exports.TEXT_ALIGNMENT = {
+    LEFT: 'left',
+    CENTER: 'center',
+    RIGHT: 'right',
+};

package/lib/es/src/values/Trigger.d.ts

@@ -0,0 +1,8 @@
+import type { ObjectValues } from '../utils/ObjectValues';
+export declare const TRIGGER: {
+    readonly HOVER: "hover";
+    readonly CLICK: "click";
+    readonly FOCUS: "focus";
+};
+export type TriggerType = ObjectValues<typeof TRIGGER>;
+export type Trigger = TriggerType | TriggerType[];

package/lib/es/src/values/Trigger.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRIGGER = void 0;
+exports.TRIGGER = {
+    HOVER: 'hover',
+    CLICK: 'click',
+    FOCUS: 'focus',
+};

package/lib/es/src/version.json

@@ -0,0 +1,3 @@
+{
+    "version": "1.12.0"
+}

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';