@seeqdev/qomponents 0.0.184 → 0.0.185

package/dist/src/Tooltip/Qtip.js

@@ -0,0 +1,168 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import DOMPurify from 'dompurify';
+import React, { useEffect, useRef, useState } from 'react';
+import { arrow, computePosition, offset, flip, shift } from '@floating-ui/dom';
+import { useIntervalWhen } from 'rooks';
+import { DEFAULT_TOOL_TIP_DELAY } from './Tooltip.types';
+const getArrowStyle = (position, x, arrowWidth, tooltipHeight, tooltipWidth) => {
+    switch (position) {
+        case 'bottom':
+            return {
+                left: `${x}px`,
+                top: `${-arrowWidth}px`,
+            };
+        case 'left':
+            return {
+                left: `${tooltipWidth - arrowWidth}px`,
+                top: `${tooltipHeight / 2 - arrowWidth}px`,
+            };
+        case 'right':
+            return {
+                left: `${-arrowWidth}px`,
+                top: `${tooltipHeight / 2 - arrowWidth}px`,
+            };
+        default: // 'top':
+            return {
+                left: `${x}px`,
+                top: `${tooltipHeight - 10 + arrowWidth}px`,
+            };
+    }
+};
+const HTMLTip = ({ text }) => {
+    return React.createElement('div', {
+        dangerouslySetInnerHTML: { __html: DOMPurify.sanitize(text) },
+    });
+};
+/** Tooltips can cause SystemTests to be flaky, so we suppress them in Playwright and Protractor */
+const suppressTooltip = () => {
+    return window.navigator.userAgent === 'Playwright' || window.navigator.userAgent.includes('Protractor');
+};
+/**
+ * QTip
+ *
+ * QTip is a Singleton Tooltip component that guarantees high-performance and reduces component wrappers!
+ *
+ * QTip is used by all qomponents that support the display of tooltips.
+ * If you want to add a Tooltip to your application you can do so by adding the following html data-attributes:
+ *
+ *    'data-qtip-text': the tooltip text to display; this can also be a string containing valid HTML
+ *    'data-qtip-placement': one of TooltipPosition (top, bottom, right, or left)
+ *    'data-qtip-is-html': set this to true if you provided a text that contains HTML,
+ *    'data-qtip-delay': this can be used to delay the showing of the tooltip. this should be a number representing
+ *    the # of milliseconds you want to delay the tooltip for. If no delay is provided the DEFAULT_TOOL_TIP_DELAY is
+ *    applied!
+ *    'data-qtip-testid': use this attribute to provide a value for a data-testid of your tooltip; this is useful
+ *    for tests
+ *
+ * In order for QTip to be able to display Tooltips you must add the QTip component to your top-most component
+ * (often that's App or Application) - simply add:
+ *
+ *    <QTip />
+ *
+ * and enjoy beautiful & performant tooltips!
+ */
+export const QTip = () => {
+    const tooltipRef = useRef(null);
+    const tooltipTarget = useRef(null);
+    const tooltipArrowRef = useRef(null);
+    const [tooltipText, setTooltipText] = useState('');
+    const [tooltipTargetOriginalPosition, setTooltipTargetOriginalPosition] = useState(null);
+    const [show, setShow] = useState(false);
+    const [html, setHtml] = useState(false);
+    const [tooltipTestId, setTooltipTestId] = useState('');
+    const [overTooltip, setOverTooltip] = useState(false);
+    // Check every 300ms if the tooltip target position has changed and hide the tooltip if this happens.
+    useIntervalWhen(() => {
+        const currentPosition = tooltipTarget?.current?.getBoundingClientRect();
+        if (overTooltip) {
+            return;
+        }
+        if (tooltipTargetOriginalPosition?.y !== currentPosition?.y ||
+            tooltipTargetOriginalPosition?.x !== currentPosition?.x) {
+            setShow(false);
+        }
+    }, 300, show);
+    useEffect(() => {
+        !suppressTooltip() && document.body.addEventListener('mousemove', onMouseMove);
+        return () => {
+            !suppressTooltip() && document.removeEventListener('mousemove', onMouseMove);
+        };
+    }, []);
+    const ttTimeout = useRef(null);
+    const findTooltipData = (element) => {
+        // Traverse up to 8 levels to find the tooltip data
+        for (let i = 0; i < 8 && element; i++) {
+            if (!element) {
+                return null;
+            }
+            if (element?.dataset?.qtipText) {
+                return element.dataset;
+            }
+            element = element?.parentElement;
+        }
+        return null;
+    };
+    const onMouseMove = (e) => {
+        if (ttTimeout.current) {
+            clearTimeout(ttTimeout.current);
+        }
+        // Find tooltip data on the current or parent elements
+        const target = e.target;
+        const dataset = findTooltipData(target);
+        if (!dataset) {
+            // No tooltip data found
+            tooltipTarget.current = null;
+            return;
+        }
+        tooltipTarget.current = target;
+        const text = dataset.qtipText;
+        if (text) {
+            const delay = parseInt(dataset.qtipDelay || `${DEFAULT_TOOL_TIP_DELAY}`, 10);
+            const placement = dataset.qtipPlacement || 'top';
+            const isHtml = dataset.qtipIsHtml === 'true';
+            const testId = dataset.qtipTestid;
+            // Debounced tooltip display
+            ttTimeout.current = setTimeout(() => {
+                makeTooltip(text, placement, isHtml, testId, delay);
+            }, delay);
+        }
+    };
+    const makeTooltip = (tooltipText, position = 'top', isHtml, dataTestId, delay) => {
+        if (tooltipText && tooltipTarget.current) {
+            setHtml(isHtml);
+            setTooltipText(tooltipText);
+            setTooltipTestId(dataTestId);
+            setTooltipTargetOriginalPosition(tooltipTarget.current.getBoundingClientRect());
+            const positionTooltip = () => {
+                if (tooltipRef.current && tooltipTarget.current) {
+                    computePosition(tooltipTarget.current, tooltipRef.current, {
+                        placement: position,
+                        middleware: [offset(10), flip(), shift({ padding: 8 }), arrow({ element: tooltipArrowRef.current })],
+                    }).then(({ x, y, middlewareData, placement: finalPlacement }) => {
+                        Object.assign(tooltipRef.current?.style, {
+                            left: `${x}px`,
+                            top: `${y}px`,
+                        });
+                        if (middlewareData.arrow) {
+                            const { x, y } = middlewareData.arrow;
+                            const arrowWidth = tooltipArrowRef.current?.offsetHeight / 2;
+                            const tooltipHeight = tooltipRef.current?.offsetHeight;
+                            const tooltipWidth = tooltipRef.current?.offsetWidth;
+                            const style = getArrowStyle(finalPlacement, x || y, arrowWidth, tooltipHeight, tooltipWidth);
+                            Object.assign(tooltipArrowRef.current.style, style);
+                        }
+                        setShow(true);
+                    });
+                }
+            };
+            delay > 0
+                ? requestAnimationFrame(() => {
+                    positionTooltip();
+                })
+                : positionTooltip();
+        }
+    };
+    return (_jsx(_Fragment, { children: _jsxs("div", { onMouseEnter: () => setOverTooltip(true), onMouseLeave: () => setOverTooltip(false), "data-testid": tooltipTestId, ref: tooltipRef, className: 'tw-absolute tw-rounded tw-bg-black tw-max-w-96 tw-p-2 tw-text-xs tw-text-white tw-z-[9999] fade-in ' +
+                (show ? 'tw-visible' : 'tw-invisible tw-pointer-events-none'), children: [html ? _jsx(HTMLTip, { text: tooltipText }) : tooltipText, _jsx("div", { className: "tw-absolute tw-w-[10px] tw-h-[10px] tw-rotate-45 tw-bg-black", ref: tooltipArrowRef })
+            ] }) }));
+};

package/dist/src/Tooltip/Tooltip.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import '../styles.css';
+import { TooltipProps } from './Tooltip.types';
+/**
+ * @deprecated
+ * Note: Tooltip has been replaced by QTip - a singleton JS tooltip that behaves well even with overflow settings :)
+ * See @QTip for more info!
+ *
+ * This component displays a Tooltip for the provided children. It is a CSS only tooltip that will not display
+ * correctly if a parent element has an overflow CSS property assigned. Please use QTip to ensure your tooltips
+ * display correctly.
+ */
+export declare const Tooltip: React.FunctionComponent<TooltipProps>;

package/dist/src/Tooltip/Tooltip.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import '../styles.css';
+import { DEFAULT_TOOL_TIP_DELAY } from './Tooltip.types';
+/**
+ * @deprecated
+ * Note: Tooltip has been replaced by QTip - a singleton JS tooltip that behaves well even with overflow settings :)
+ * See @QTip for more info!
+ *
+ * This component displays a Tooltip for the provided children. It is a CSS only tooltip that will not display
+ * correctly if a parent element has an overflow CSS property assigned. Please use QTip to ensure your tooltips
+ * display correctly.
+ */
+export const Tooltip = ({ position = 'bottom', children, text, delay = DEFAULT_TOOL_TIP_DELAY, }) => {
+    const arrowBaseClasses = "before:tw-content-[''] before:tw-absolute before:tw-border-8";
+    const centerArrowVertically = 'before:tw-top-1/2 before:-tw-translate-y-1/2';
+    const centerArrowHorizontally = 'before:tw-left-1/2 before:-tw-translate-x-1/2';
+    const arrowRight = `${arrowBaseClasses} ${centerArrowVertically} before:tw-right-[100%] before:tw-border-y-transparent 
+  before:tw-border-l-transparent before:tw-border-r-black`;
+    const arrowLeft = `${arrowBaseClasses} ${centerArrowVertically} before:tw-left-[100%] before:tw-border-y-transparent
+   before:tw-border-l-black before:tw-border-r-transparent`;
+    const arrowBottom = `${arrowBaseClasses} ${centerArrowHorizontally} before:-tw-top-4 before:tw-border-b-black 
+  before:tw-border-r-transparent before:tw-border-l-transparent before:tw-border-t-transparent`;
+    const arrowTop = `${arrowBaseClasses} ${centerArrowHorizontally} before:-tw-bottom-4 before:tw-border-b-transparent 
+  before:tw-border-t-black before:tw-border-l-transparent before:tw-border-r-transparent`;
+    const placements = {
+        top: `-tw-top-2 -tw-translate-y-full tw-left-1/2 -tw-translate-x-1/2 ${arrowTop}`,
+        left: `-tw-translate-x-full -tw-left-3 -tw-translate-y-1/2 tw-top-1/2 ${arrowLeft}`,
+        right: `tw-translate-x-full -tw-right-3 -tw-translate-y-1/2 tw-top-1/2 ${arrowRight}`,
+        bottom: `-tw-bottom-2 tw-translate-y-full tw-left-1/2 -tw-translate-x-1/2 ${arrowBottom}`,
+    };
+    return (_jsxs("div", { className: "tw-group tw-relative tw-inline-block", children: [children, _jsx("div", { className: `tw-z-50 tw-whitespace-nowrap tw-hidden group-hover:tw-inline-block group-hover:tw-delay-[${delay}ms] 
+        tw-absolute tw-opacity-0 group-hover:tw-opacity-100 tw-rounded tw-bg-black tw-p-2 tw-text-xs tw-text-white ${placements[position]}`, children: text })
+        ] }));
+};

package/dist/src/Tooltip/Tooltip.stories.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    title: string;
+};
+export default _default;
+export declare const AllTooltips: () => import("react/jsx-runtime").JSX.Element;

package/dist/src/Tooltip/Tooltip.stories.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Tooltip } from './Tooltip';
+import Icon from '../Icon';
+import Button from '../Button';
+import { tooltipPositions } from './Tooltip.types';
+export default {
+    title: 'Tooltip',
+};
+export const AllTooltips = () => {
+    const renderButtonsWithTooltip = () => tooltipPositions.map((position) => (_jsx("div", { children: _jsx(Tooltip, { text: `Tooltip on the ${position}`, position: position, children: _jsx(Button, { label: position }) }) }, `${position}_button`)));
+    const renderIconsWithHtmlTooltip = () => tooltipPositions.map((position) => (_jsx("div", { children: _jsx(Tooltip, { text: _jsxs("div", { children: [
+                    _jsx("h2", { children: "Fancy Tooltip" }),
+                    " This is a special tooltip. Why?",
+                    _jsx("br", {}),
+                    "Because it supports ",
+                    _jsx("b", { children: "HTML!" })
+                ] }), position: position, children: _jsx(Icon, { icon: "fc-sun" }) }) }, `${position}_icon`)));
+    const renderTextTooltipOnText = () => tooltipPositions.map((position) => (_jsx("div", { children: _jsx(Tooltip, { text: "Helpful information provided here", position: position, children: _jsxs("span", { children: ["Hover for Tooltip (on the ", position, ")"] }) }) }, `${position}_text`)));
+    return (_jsxs("div", { className: "tw-grid tw-grid-cols-4 tw-gap-4 tw-text-center", children: [renderButtonsWithTooltip(), renderIconsWithHtmlTooltip(), renderTextTooltipOnText()] }));
+};

package/dist/src/Tooltip/Tooltip.types.d.ts

@@ -0,0 +1,22 @@
+export declare const DEFAULT_TOOL_TIP_DELAY = 500;
+export declare const tooltipPositions: readonly ["top", "left", "right", "bottom"];
+import React from 'react';
+export type TooltipPosition = typeof tooltipPositions[number];
+export interface TooltipProps {
+    position?: TooltipPosition;
+    children?: React.JSX.Element | string;
+    text: React.JSX.Element | string;
+    delay?: number;
+}
+export interface TooltipComponentProps {
+    /** text to display on tooltip */
+    tooltip?: string;
+    /** number of milliseconds to wait before showing a tooltip on-hover */
+    tooltipDelay?: number;
+    /** one of four possible tooltip positions */
+    tooltipPlacement?: TooltipPosition;
+    /** true if the provided tooltip text should be rendered as HTML */
+    isHtmlTooltip?: boolean;
+    /** optional testId applied to the tooltip - useful for testing */
+    tooltipTestId?: string;
+}

package/dist/src/Tooltip/Tooltip.types.js

@@ -0,0 +1,2 @@
+export const DEFAULT_TOOL_TIP_DELAY = 500;
+export const tooltipPositions = ['top', 'left', 'right', 'bottom'];

package/dist/src/Tooltip/TooltipPerformance.stories.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    title: string;
+};
+export default _default;
+export declare const TooltipPerformance: () => import("react/jsx-runtime").JSX.Element;

package/dist/src/Tooltip/TooltipPerformance.stories.js

@@ -0,0 +1,25 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Tooltip } from './Tooltip';
+import Icon from '../Icon';
+export default {
+    title: 'Tooltip',
+};
+const renderManyTooltips = () => {
+    const colsCount = 100;
+    const rowCount = 100;
+    const rows = [];
+    const getCols = (rowId) => {
+        const cols = [];
+        for (let i = 0; i < colsCount; i++) {
+            cols.push(_jsx("td", { children: _jsx(Tooltip, { text: `hello there ${i}`, children: _jsx(Icon, { icon: "fc-sun" }) }) }, 'col_' + i + '_row_' + rowId));
+        }
+        return cols;
+    };
+    for (let i = 0; i < rowCount; i++) {
+        rows.push(_jsxs("tr", { children: [...getCols(i)] }, 'row_' + i));
+    }
+    return (_jsx("table", { children: _jsx("tbody", { children: rows.map((row) => row) }) }));
+};
+export const TooltipPerformance = () => {
+    return (_jsx(_Fragment, { children: _jsx("div", { className: "tw-grid tw-grid-cols-4 tw-gap-4 tw-text-center", children: renderManyTooltips() }) }));
+};

package/dist/src/Tooltip/index.d.ts

@@ -0,0 +1,2 @@
+export { Tooltip } from './Tooltip';
+export { QTip } from './Qtip';

package/dist/src/Tooltip/index.js

@@ -0,0 +1,2 @@
+export { Tooltip } from './Tooltip';
+export { QTip } from './Qtip';

package/dist/src/Tooltip/qTip.utilities.d.ts

@@ -0,0 +1,3 @@
+import { QTipDataAttributes } from './QTip.types';
+import { TooltipComponentProps } from './Tooltip.types';
+export declare const getQTipData: ({ tooltip, tooltipPlacement, isHtmlTooltip, tooltipTestId, tooltipDelay, }: TooltipComponentProps) => QTipDataAttributes | undefined;

package/dist/src/Tooltip/qTip.utilities.js

@@ -0,0 +1,10 @@
+import { DEFAULT_TOOL_TIP_DELAY } from './Tooltip.types';
+export const getQTipData = ({ tooltip, tooltipPlacement, isHtmlTooltip, tooltipTestId, tooltipDelay = DEFAULT_TOOL_TIP_DELAY, }) => tooltip
+    ? {
+        'data-qtip-text': tooltip,
+        'data-qtip-placement': tooltipPlacement,
+        'data-qtip-is-html': isHtmlTooltip,
+        'data-qtip-testid': tooltipTestId,
+        'data-qtip-delay': tooltipDelay,
+    }
+    : undefined;

package/dist/src/index.d.ts

@@ -0,0 +1,46 @@
+import Button from './Button';
+import ToolbarButton from './ToolbarButton';
+import TextField from './TextField';
+import Checkbox from './Checkbox';
+import TextArea from './TextArea';
+import { QTip, Tooltip } from './Tooltip';
+import Icon from './Icon';
+import Select from './Select';
+import { SelectCompoents } from './Select';
+import Modal from './Modal';
+import Tabs from './Tabs';
+import Accordion from './Accordion';
+import ButtonWithPopover from './ButtonWithPopover';
+import ButtonWithDropdown from './ButtonWithDropdown';
+import Alert from './Alert';
+import SeeqActionDropdown from './SeeqActionDropdown';
+import InputGroup from './InputGroup';
+import Collapse from './Collapse';
+import Slider from './Slider';
+import ProgressBar from './ProgressBar';
+import ButtonGroup from './ButtonGroup';
+import Carousel from './Carousel';
+export { Tabs };
+export { Button };
+export { ToolbarButton };
+export { TextField };
+export { TextArea };
+export { Tooltip };
+export { Checkbox };
+export { Icon };
+export { Select };
+export { SelectCompoents };
+export { QTip };
+export { Modal };
+export { Accordion };
+export { ButtonWithPopover };
+export { ButtonWithDropdown };
+export { Alert };
+export { SeeqActionDropdown };
+export { InputGroup };
+export { Collapse };
+export { Slider };
+export { ProgressBar };
+export { ButtonGroup };
+export { Carousel };
+export * from './types';

package/dist/src/index.js

@@ -0,0 +1,47 @@
+import Button from './Button';
+import ToolbarButton from './ToolbarButton';
+import TextField from './TextField';
+import Checkbox from './Checkbox';
+import TextArea from './TextArea';
+import { QTip, Tooltip } from './Tooltip';
+import Icon from './Icon';
+import Select from './Select';
+import { SelectCompoents } from './Select';
+import Modal from './Modal';
+import Tabs from './Tabs';
+import Accordion from './Accordion';
+import ButtonWithPopover from './ButtonWithPopover';
+import ButtonWithDropdown from './ButtonWithDropdown';
+import Alert from './Alert';
+import SeeqActionDropdown from './SeeqActionDropdown';
+import InputGroup from './InputGroup';
+import Collapse from './Collapse';
+import Slider from './Slider';
+import ProgressBar from './ProgressBar';
+import ButtonGroup from './ButtonGroup';
+import Carousel from './Carousel';
+export { Tabs };
+export { Button };
+export { ToolbarButton };
+export { TextField };
+export { TextArea };
+export { Tooltip };
+export { Checkbox };
+export { Icon };
+export { Select };
+export { SelectCompoents };
+export { QTip };
+export { Modal };
+export { Accordion };
+export { ButtonWithPopover };
+export { ButtonWithDropdown };
+export { Alert };
+export { SeeqActionDropdown };
+export { InputGroup };
+export { Collapse };
+export { Slider };
+export { ProgressBar };
+export { ButtonGroup };
+export { Carousel };
+// Export types
+export * from './types';

package/dist/src/setupTests.d.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom';

package/dist/src/setupTests.js

@@ -0,0 +1,5 @@
+// jest-dom adds custom jest matchers for asserting on DOM nodes.
+// allows you to do things like:
+// expect(element).toHaveTextContent(/react/i)
+// learn more: https://github.com/testing-library/jest-dom
+import '@testing-library/jest-dom';

package/dist/src/types.d.ts

@@ -0,0 +1,27 @@
+export type InputGroupPlacement = 'left' | 'right' | undefined;
+export type FormControlElement = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
+export * from './Accordion/Accordion.types';
+export * from './Alert/Alert.types';
+export * from './Button/Button.types';
+export * from './ButtonGroup/ButtonGroup.types';
+export * from './ButtonWithDropdown/ButtonWithDropdown.types';
+export * from './ButtonWithPopover/ButtonWithPopover.types';
+export * from './Carousel/Carousel.types';
+export * from './Checkbox/Checkbox.types';
+export * from './Collapse/Collapse.types';
+export * from './Icon/Icon.types';
+export * from './InputGroup/InputGroup.types';
+export * from './Modal/Modal.types';
+export * from './ProgressBar/ProgressBar.types';
+export * from './SeeqActionDropdown/SeeqActionDropdown.types';
+export * from './Select/Select.types';
+export * from './Slider/Slider.types';
+export * from './SvgIcon/SvgIcon.types';
+export * from './Tabs/Tabs.types';
+export * from './TextArea/TextArea.types';
+export * from './TextField/TextField.types';
+export * from './ToolbarButton/ToolbarButton.types';
+export * from './Tooltip/QTip.types';
+export * from './Tooltip/Tooltip.types';
+export type { ToolbarButtonVariant, ToolbarButtonProps } from './ToolbarButton/ToolbarButton.types';
+export { toolbarButtonVariants } from './ToolbarButton/ToolbarButton.types';

package/dist/src/types.js

@@ -0,0 +1,25 @@
+// Export all component types
+export * from './Accordion/Accordion.types';
+export * from './Alert/Alert.types';
+export * from './Button/Button.types';
+export * from './ButtonGroup/ButtonGroup.types';
+export * from './ButtonWithDropdown/ButtonWithDropdown.types';
+export * from './ButtonWithPopover/ButtonWithPopover.types';
+export * from './Carousel/Carousel.types';
+export * from './Checkbox/Checkbox.types';
+export * from './Collapse/Collapse.types';
+export * from './Icon/Icon.types';
+export * from './InputGroup/InputGroup.types';
+export * from './Modal/Modal.types';
+export * from './ProgressBar/ProgressBar.types';
+export * from './SeeqActionDropdown/SeeqActionDropdown.types';
+export * from './Select/Select.types';
+export * from './Slider/Slider.types';
+export * from './SvgIcon/SvgIcon.types';
+export * from './Tabs/Tabs.types';
+export * from './TextArea/TextArea.types';
+export * from './TextField/TextField.types';
+export * from './ToolbarButton/ToolbarButton.types';
+export * from './Tooltip/QTip.types';
+export * from './Tooltip/Tooltip.types';
+export { toolbarButtonVariants } from './ToolbarButton/ToolbarButton.types';

package/dist/src/utils/browserId.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @exports the browser id (i.e., 'IE 11' 'Chrome 90')
+ * @see http://stackoverflow.com/questions/2400935/browser-detection-in-javascript
+ */
+export declare const browserId: string;
+export declare const browserName: string;
+export declare const browserVersion: number | "";
+export declare const browserIsFirefox: boolean | "";
+export declare const browserIsEdgeBeforeChromium: boolean | "" | 0;

package/dist/src/utils/browserId.js

@@ -0,0 +1,28 @@
+/**
+ * @exports the browser id (i.e., 'IE 11' 'Chrome 90')
+ * @see http://stackoverflow.com/questions/2400935/browser-detection-in-javascript
+ */
+export const browserId = (function () {
+    let tem;
+    const ua = navigator.userAgent;
+    let M = ua.match(/(opera|chrome|safari|firefox|msie|trident(?=\/))\/?\s*(\d+)/i) || [];
+    if (/trident/i.test(M[1])) {
+        tem = /\brv[ :]+(\d+)/g.exec(ua) || [];
+        return `IE ${tem[1] || ''}`;
+    }
+    if (M[1] === 'Chrome') {
+        tem = ua.match(/\b(OPR|Edge?)\/(\d+)/);
+        if (tem !== null) {
+            return tem.slice(1).join(' ').replace('OPR', 'Opera').replace('Edg ', 'Edge ');
+        }
+    }
+    M = M[2] ? [M[1], M[2]] : [navigator.appName, navigator.appVersion, '-?'];
+    if ((tem = ua.match(/version\/(\d+)/i)) !== null) {
+        M.splice(1, 1, tem[1]);
+    }
+    return M.join(' ');
+})();
+export const browserName = browserId && browserId.split(' ', 2)[0];
+export const browserVersion = browserId && parseInt(browserId.split(' ', 2)[1], 10);
+export const browserIsFirefox = browserId && browserName === 'Firefox';
+export const browserIsEdgeBeforeChromium = browserName && browserVersion && browserName === 'Edge' && browserVersion < 70;

package/dist/src/utils/svg.d.ts

@@ -0,0 +1,15 @@
+export declare const SVG_PATH = "svgpath:";
+/**
+ * Determines if an icon is SVG
+ *
+ * @param icon - an icon string that will either be an icon class or an SVG path definition (e.g. "fa fa-wrench" or
+ * "svgpath:M 17.0181 0 ...")
+ */
+export declare function isSvgIcon(icon: string): boolean;
+/**
+ * Retrieves the SVG path from an SVG icon
+ *
+ * @param icon - an SVG icon string including path definition (e.g. "svgpath:M 17.0181 0 ...")
+ * @returns the SVG icon path or an empty string if the supplied icon is not SVG
+ */
+export declare function getSvgIconPath(icon: string): string;

package/dist/src/utils/svg.js

@@ -0,0 +1,19 @@
+export const SVG_PATH = 'svgpath:';
+/**
+ * Determines if an icon is SVG
+ *
+ * @param icon - an icon string that will either be an icon class or an SVG path definition (e.g. "fa fa-wrench" or
+ * "svgpath:M 17.0181 0 ...")
+ */
+export function isSvgIcon(icon) {
+    return icon.startsWith(SVG_PATH);
+}
+/**
+ * Retrieves the SVG path from an SVG icon
+ *
+ * @param icon - an SVG icon string including path definition (e.g. "svgpath:M 17.0181 0 ...")
+ * @returns the SVG icon path or an empty string if the supplied icon is not SVG
+ */
+export function getSvgIconPath(icon) {
+    return isSvgIcon(icon) ? icon.substring(SVG_PATH.length) : '';
+}

package/dist/src/utils/validateStyleDimension.d.ts

@@ -0,0 +1,2 @@
+import { DimensionStyle } from '../TextField/TextField.types';
+export declare const setValidInputDimension: (width?: number, height?: number) => DimensionStyle | undefined;

package/dist/src/utils/validateStyleDimension.js

@@ -0,0 +1,13 @@
+export const setValidInputDimension = (width, height) => {
+    let inputStyle;
+    if (typeof width === 'number' && width > 0) {
+        inputStyle = {
+            width: `${width}px`,
+        };
+    }
+    if (typeof height === 'number' && height > 0) {
+        inputStyle = inputStyle || {};
+        inputStyle['height'] = `${height}px`;
+    }
+    return inputStyle;
+};

package/dist/src/utils/validateStyleDimension.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/validateStyleDimension.test.js

@@ -0,0 +1,19 @@
+import { setValidInputDimension } from './validateStyleDimension';
+describe('setValidInputDimension', () => {
+    it('returns undefined if both width and height are undefined', () => {
+        const result = setValidInputDimension();
+        expect(result).toBeUndefined();
+    });
+    it('returns a DimensionStyle object with width if width is a valid number', () => {
+        const result = setValidInputDimension(300);
+        expect(result).toEqual({ width: '300px' });
+    });
+    it('returns a DimensionStyle object with height if height is a valid number', () => {
+        const result = setValidInputDimension(undefined, 400);
+        expect(result).toEqual({ height: '400px' });
+    });
+    it('returns a DimensionStyle object with both width and height if both are valid numbers', () => {
+        const result = setValidInputDimension(500, 600);
+        expect(result).toEqual({ width: '500px', height: '600px' });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seeqdev/qomponents",
-  "version": "0.0.184",
+  "version": "0.0.185",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
   "types": "dist/src/index.d.ts",
@@ -44,6 +44,7 @@
     "@typescript/native-preview": "7.0.0-dev.20260102.1",
     "autoprefixer": "10.4.17",
     "color": "4.2.3",
+    "cross-env": "10.0.0",
     "identity-obj-proxy": "3.0.0",
     "jest": "29.7.0",
     "jest-cli": "29.7.0",
@@ -83,9 +84,14 @@
   },
   "scripts": {
     "build": "rollup -c --bundleConfigAsCjs",
-    "watchRollup": "rollup -c --bundleConfigAsCjs --watch",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "dev": "ladle serve"
+    "build:watch": "rollup -c --bundleConfigAsCjs --watch",
+    "test": "cross-env TZ=UTC LANG=en-US jest",
+    "test:watch": "cross-env TZ=UTC LANG=en-US jest --watch",
+    "dev": "ladle serve",
+    "lint": "echo 'ESLint not configured yet'",
+    "lint:fix": "echo 'ESLint not configured yet'",
+    "format:check": "prettier --check \"**/*.{ts,tsx,js,json,css}\"",
+    "format:write": "prettier --write \"**/*.{ts,tsx,js,json,css}\"",
+    "type:check": "tsc --noEmit"
   }
 }