@seeqdev/qomponents 0.0.184 → 0.0.185

package/dist/src/ToolbarButton/ToolbarButton.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from 'react';
+import * as PopoverPrimitive from '@radix-ui/react-popover';
+import Icon from '../Icon';
+import { DEFAULT_TOOL_TIP_DELAY } from '../Tooltip/Tooltip.types';
+import { getSvgIconPath } from '../utils/svg';
+const popoverBorderStyles = [
+    'tw-border-solid',
+    'tw-border',
+    'tw-rounded-md',
+    'tw-border-sq-disabled-gray',
+    'dark:tw-border-gray-500',
+].join(' ');
+const triggerBackgroundStyles = [
+    'tw-bg-transparent',
+    'hover:tw-bg-sq-worksheetspanel-gray',
+    'active:tw-bg-sq-worksheetspanel-gray',
+    'dark:tw-bg-transparent',
+    'dark:hover:tw-bg-sq-field-disabled-gray',
+    'dark:active:tw-bg-sq-field-disabled-gray',
+].join(' ');
+const activeBackgroundStyles = [
+    'active',
+    'tw-bg-sq-overlay-gray',
+    'hover:tw-bg-sq-overlay-gray',
+    'active:tw-bg-sq-overlay-gray',
+    'dark:tw-bg-sq-dark-disabled-gray',
+    'dark:hover:tw-border-sq-dark-disabled-gray',
+    'dark:active:tw-bg-sq-dark-disabled-gray',
+].join(' ');
+const bgStyles = ['tw-bg-sq-white', 'dark:tw-bg-sq-dark-background'].join(' ');
+const disabledClasses = ['tw-opacity-50', 'tw-cursor-not-allowed'].join(' ');
+const PopoverContent = React.forwardRef(({ className, align = 'center', sideOffset = 4, ...props }, ref) => (_jsx(PopoverPrimitive.Content, { ref: ref, align: align, sideOffset: sideOffset, ...props, asChild: true })));
+export const ToolbarButton = ({ isSmall = false, label, icon, secondIcon, forceSmallIcon = false, tooltipText, id, popoverContent, extraClassNames, testId, tooltipTestId, tooltipOptions, isActive = false, isHtmlTooltip = false, hasArrow = false, disabled = false, isPrimaryAnSvg = false, primaryIconExtraClassNames = false, iconHeight = 24, iconWidth = 24, primaryIconViewbox = '0 0 24 24', onClick, onHide, }) => {
+    let tooltipData = undefined;
+    if (tooltipText) {
+        tooltipData = {
+            'data-qtip-text': tooltipText,
+            'data-qtip-placement': tooltipOptions?.position,
+            'data-qtip-is-html': isHtmlTooltip,
+            'data-qtip-testid': tooltipTestId,
+            'data-qtip-delay': tooltipOptions?.delay ?? DEFAULT_TOOL_TIP_DELAY,
+        };
+    }
+    const onOpenChange = (open) => {
+        if (!open) {
+            onHide && onHide();
+        }
+    };
+    return (_jsxs(PopoverPrimitive.Root, { defaultOpen: false, onOpenChange: onOpenChange, children: [
+            _jsx(PopoverPrimitive.Trigger, { id: id, className: `tw-border-none tw-mx-[1.5px] first:tw-ml-0 last:tw-mr-0 ${isActive ? 'active' : ''}`, disabled: disabled, "data-testid": testId, onClick: (e) => {
+                    onClick && onClick(e);
+                }, children: _jsxs("div", { ...tooltipData, className: `tw-flex tw-flex-col tw-items-center tw-rounded-md ${isSmall ? 'tw-py-[1px] tw-px-1' : 'tw-px-2 tw-py-[5px]'} ${disabled ? disabledClasses : isActive ? activeBackgroundStyles : triggerBackgroundStyles} ${extraClassNames || ''}`, children: [
+                        _jsxs("span", { className: "tw-nowrap", children: [isPrimaryAnSvg ? (_jsx("svg", { xmlns: "http://www.w3.org/2000/svg", className: `tw-text-sq-text-color dark:tw-text-sq-dark-text ${primaryIconExtraClassNames || ''}`, viewBox: primaryIconViewbox, height: `${iconHeight}px`, width: `${iconWidth}px`, fill: "currentColor", "data-testid": testId, children: _jsx("path", { d: getSvgIconPath(icon) }) })) : (_jsx(Icon, { icon: icon, testId: "firstIcon", type: "text", large: !isSmall && !label && !secondIcon && !forceSmallIcon, extraClassNames: `tw-text-sq-text-color dark:tw-text-sq-dark-text` })), secondIcon && _jsx(Icon, { icon: secondIcon, type: "text", testId: "secondIcon" }), popoverContent ? (_jsx(Icon, { icon: "fc-arrow-dropdown", extraClassNames: "tw-text-sq-text-color dark:tw-text-sq-dark-text tw-ml-[3px] tw-text-[0.5rem]", type: "text" })) : undefined] }), !isSmall && (_jsx("small", { className: "tw-text-sq-text-color dark:tw-text-sq-dark-text tw-text-[0.625rem]", children: label }))] }) }), !!popoverContent ? (_jsx(PopoverContent, { sideOffset: 2, align: "start", children: _jsxs("div", { className: bgStyles +
+                        ' tw-relative tw-z-[1000] tw-min-w-6 tw-p-[0.5rem] focus-visible:tw-outline-none tw-outline-none data-[state=open]:animate-in data-[state=closed]:animate-out' +
+                        ' data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2' +
+                        popoverBorderStyles, children: [hasArrow && (_jsx(PopoverPrimitive.Arrow, { asChild: true, children: _jsx("div", { className: " tw-fill-transparent tw-bg-white tw-w-[15px] tw-h-[15px] tw-mt-[-7px] tw-rotate-45 dark:tw-bg-sq-dark-background tw-border-b tw-border-r tw-border-sq-disabled-gray dark:tw-border-gray-500" }) })), popoverContent] }) })) : undefined] }));
+};

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

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

package/dist/src/ToolbarButton/ToolbarButton.stories.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ToolbarButton } from './ToolbarButton';
+import Icon from '../Icon';
+import { QTip } from '../Tooltip/Qtip';
+export default {
+    title: 'Toolbar Button',
+};
+export const AllToolbarButtonVariants = () => {
+    const options = [
+        { value: 'a', label: 'Chocolate' },
+        { value: 'b', label: 'Strawberry' },
+        { value: 'c', label: 'Vanilla' },
+        { value: 'd', label: 'Rocky Road' },
+        { value: 'e', label: 'Crazy Cow' },
+        { value: 'f', label: 'Almond Joy' },
+        { value: 'g', label: 'All of the above' },
+    ];
+    const colorOptions = [
+        { value: 'h', label: 'pink' },
+        { value: 'i', label: 'purple' },
+        { value: 'j', label: 'green' },
+        { value: 'k', label: 'red' },
+    ];
+    const allToolbarButtons = (isDark) => (_jsxs("div", { className: isDark ? 'tw-dark tw-bg-sq-dark-background' : '', children: [
+            _jsx("div", { className: "tw-p-5 ", children: _jsx(ToolbarButton, { icon: "fc-y-axis", label: "Popover", testId: "basic-popover1", tooltipText: "This is a small popover.", tooltipOptions: { position: 'top', delay: 0 }, isHtmlTooltip: false, isSmall: true, popoverContent: _jsxs("div", { className: "tw-text-sm dark:tw-text-white", children: [
+                            _jsx("p", { className: "tw-bg-gray-200 dark:tw-bg-gray-700 tw-p-2", children: "Flavors" }), options.map((option) => (_jsxs("div", { className: "tw-flex tw-items-center tw-p-2 hover:tw-bg-green-500", children: [
+                                    _jsx(Icon, { type: "color", color: "green", icon: "fc-check", extraClassNames: "tw-mr-2" }), _jsx("span", { children: option.label })
+                                ] }, option.value))), _jsx("p", { className: "tw-bg-gray-200 dark:tw-bg-gray-700 tw-p-2", children: "Colors" }), colorOptions.map((option) => (_jsxs("div", { className: "tw-flex tw-items-center tw-p-2", children: [
+                                    _jsx(Icon, { type: "color", color: "green", icon: "fc-check", extraClassNames: "tw-mr-2" }), _jsx("span", { children: option.label })
+                                ] }, option.value)))] }) }) }), _jsx("div", { className: "tw-p-5 ", children: _jsx(ToolbarButton, { icon: "fc-y-axis", label: "Normal", testId: "basic-popover1", tooltipText: "This is a normal popover.", tooltipOptions: { position: 'top', delay: 0 }, isHtmlTooltip: false, popoverContent: _jsxs("div", { className: "tw-text-sm dark:tw-text-white", children: [
+                            _jsx("p", { className: "tw-bg-gray-200 dark:tw-bg-gray-700 tw-p-2", children: "Flavors" }), options.map((option) => (_jsxs("div", { className: "tw-flex tw-items-center tw-p-2 hover:tw-bg-green-500", children: [
+                                    _jsx(Icon, { type: "color", color: "green", icon: "fc-check", extraClassNames: "tw-mr-2" }), _jsx("span", { children: option.label })
+                                ] }, option.value))), _jsx("p", { className: "tw-bg-gray-200 dark:tw-bg-gray-700 tw-p-2", children: "Colors" }), colorOptions.map((option) => (_jsxs("div", { className: "tw-flex tw-items-center tw-p-2", children: [
+                                    _jsx(Icon, { type: "color", color: "green", icon: "fc-check", extraClassNames: "tw-mr-2" }), _jsx("span", { children: option.label })
+                                ] }, option.value)))] }) }) }), _jsxs("div", { className: "tw-p-5 tw-flex", children: [
+                    _jsx(ToolbarButton, { icon: "fc-y-axis", label: "With arrow", testId: "basic-popover1", tooltipText: "This is a normal popover.", tooltipOptions: { position: 'top', delay: 0 }, hasArrow: true, isHtmlTooltip: false, popoverContent: _jsxs("div", { className: "tw-text-sm dark:tw-text-white", children: [
+                                _jsx("p", { className: "tw-bg-gray-200 dark:tw-bg-gray-700 tw-p-2", children: "Flavors" }), options.map((option) => (_jsxs("div", { className: "tw-flex tw-items-center tw-p-2 hover:tw-bg-green-500", children: [
+                                        _jsx(Icon, { type: "color", color: "green", icon: "fc-check", extraClassNames: "tw-mr-2" }), _jsx("span", { children: option.label })
+                                    ] }, option.value))), _jsx("p", { className: "tw-bg-gray-200 dark:tw-bg-gray-700 tw-p-2", children: "Colors" }), colorOptions.map((option) => (_jsxs("div", { className: "tw-flex tw-items-center tw-p-2", children: [
+                                        _jsx(Icon, { type: "color", color: "green", icon: "fc-check", extraClassNames: "tw-mr-2" }), _jsx("span", { children: option.label })
+                                    ] }, option.value)))] }) }), _jsx(ToolbarButton, { icon: "fc-y-axis", tooltipText: "This is a large popover icon", tooltipOptions: { position: 'top', delay: 0 }, testId: "basic-popover4", isHtmlTooltip: false })
+                ] }), _jsxs("div", { className: "tw-p-5 ", children: [
+                    _jsx("p", { className: "tw-text-sq-color-dark tw-text-[0.625rem]", children: "Without popup" }), _jsx(ToolbarButton, { icon: "fc-y-axis", label: "Button", testId: "basic-popover3", isHtmlTooltip: false })
+                ] }), _jsx("div", { className: "tw-p-5 tw-flex", children: _jsx(ToolbarButton, { icon: "fc-y-axis", label: "Disabled", testId: "basic-popover2", tooltipText: "This is a popover.", tooltipOptions: { position: 'top' }, isHtmlTooltip: false, disabled: true, popoverContent: _jsxs("div", { className: "tw-border tw-border-gray-100 tw-p-2 tw-rounded-sm tw-text-sm dark:tw-bg-sq-dark-background", children: [
+                            _jsx("p", { className: "tw-bg-gray-200 dark:tw-bg-gray-700 tw-p-2", children: "Flavors" }), options.map((option) => (_jsxs("div", { className: "tw-flex tw-items-center tw-p-2 hover:tw-bg-green-500", children: [
+                                    _jsx(Icon, { type: "color", color: "green", icon: "fc-check", extraClassNames: "tw-mr-2" }), _jsx("span", { children: option.label })
+                                ] }, option.value))), _jsx("p", { className: "tw-bg-gray-200 dark:tw-bg-gray-700 tw-p-2", children: "Colors" }), colorOptions.map((option) => (_jsxs("div", { className: "tw-flex tw-items-center tw-p-2", children: [
+                                    _jsx(Icon, { type: "color", color: "green", icon: "fc-check", extraClassNames: "tw-mr-2" }), _jsx("span", { children: option.label })
+                                ] }, option.value)))] }) }) }), _jsx("div", { className: "tw-p-5 ", children: _jsx(ToolbarButton, { id: "scatterPlotFlipXY", isActive: false, disabled: true, testId: "scatterPlotFlipXY", label: "", icon: "fc-grab-window", tooltipText: "This is a large disabled popover.", tooltipOptions: { position: 'top' }, extraClassNames: "no-border ml5" }) }), _jsx("div", { className: "tw-p-5 ", children: _jsx(ToolbarButton, { icon: "fc-y-axis", tooltipText: "This is a large popover icon", tooltipOptions: { position: 'top', delay: 0 }, testId: "basic-popover4", isHtmlTooltip: false }) }), _jsx("div", { className: "tw-p-5 ", children: _jsx(ToolbarButton, { icon: "fc-y-axis", label: "Active", testId: "basic-popover5", tooltipText: "This is a button.", tooltipOptions: { position: 'top', delay: 0 }, isHtmlTooltip: false, isActive: true }) }), _jsx("div", { className: "tw-p-5 ", children: _jsx(ToolbarButton, { isPrimaryAnSvg: true, iconHeight: 13, iconWidth: 13, icon: "svgpath:M 19 2.76 L 18.016 4.066 L 7.678 17.765 L 6.745 19 L 5.812 17.765 L 0.984 11.373 L 0 10.067 L 1.867 7.307 L 2.851 8.613 L 6.745 13.771 L 16.149 1.306 L 17.133 0 L 19 2.76 Z", label: "Active", testId: "basic-popover5", tooltipText: "This is a button.", tooltipOptions: { position: 'top', delay: 0 }, isHtmlTooltip: false, isActive: true }) })
+        ] }));
+    const renderAllVariations = () => (_jsxs("div", { className: "tw-grid tw-grid-cols-2 tw-gap-4 tw-p-4", children: [allToolbarButtons(), allToolbarButtons(true)] }));
+    return (_jsxs("div", { children: [
+            _jsxs("div", { className: "tw-grid tw-grid-cols-2 tw-gap-4", children: [
+                    _jsx(QTip, {}), _jsxs("div", { className: "color_topic", children: [
+                            _jsx("b", { children: "Topic Colors" }), renderAllVariations()] }), _jsxs("div", { className: "color_analysis", children: [
+                            _jsx("b", { children: "Analysis Colors" }), renderAllVariations()] })
+                ] }), _jsxs("div", { className: "tw-grid tw-grid-cols-2 tw-gap-4", children: [
+                    _jsxs("div", { className: "color_datalab", children: [
+                            _jsx("b", { children: "Datalab Colors" }), renderAllVariations()] }), _jsxs("div", { className: "color_vantage", children: [
+                            _jsx("b", { children: "Vantage Colors" }), renderAllVariations()] })
+                ] })
+        ] }));
+};

package/dist/src/ToolbarButton/ToolbarButton.test.d.ts

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

package/dist/src/ToolbarButton/ToolbarButton.test.js

@@ -0,0 +1,89 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import '@testing-library/jest-dom';
+import { render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { ToolbarButton } from './ToolbarButton';
+import Icon from '../Icon';
+describe('ToolbarButton', () => {
+    const options = [
+        { value: 'a', label: 'Chocolate' },
+        { value: 'b', label: 'Strawberry' },
+        { value: 'c', label: 'Vanilla' },
+        { value: 'd', label: 'Rocky Road' },
+        { value: 'e', label: 'Crazy Cow' },
+        { value: 'f', label: 'Almond Joy' },
+        { value: 'g', label: 'All of the above' },
+    ];
+    const colorOptions = [
+        { value: 'h', label: 'pink' },
+        { value: 'i', label: 'purple' },
+        { value: 'j', label: 'green' },
+        { value: 'k', label: 'red' },
+    ];
+    const popoverContent = (_jsxs("div", { className: "tw-text-sm", children: [
+            _jsx("p", { className: "tw-bg-gray-200 tw-p-2", children: "Flavors" }), options.map((option) => (_jsxs("div", { className: "tw-flex tw-items-center tw-p-2 hover:tw-bg-green-500", children: [
+                    _jsx(Icon, { type: "color", color: "green", icon: "fc-check", extraClassNames: "tw-mr-2" }), _jsx("span", { children: option.label })
+                ] }, option.value))), _jsx("p", { children: "Colors" }), colorOptions.map((option) => (_jsxs("div", { className: "tw-flex tw-items-center tw-p-2", children: [
+                    _jsx(Icon, { type: "color", color: "green", icon: "fc-check", extraClassNames: "tw-mr-2" }), _jsx("span", { children: option.label })
+                ] }, option.value)))] }));
+    const mockOnClick = jest.fn();
+    class Context {
+        testId = 'popoverTestId';
+        label = 'popover label';
+        props = {
+            label: this.label,
+            onClick: mockOnClick,
+            testId: this.testId,
+            icon: 'fc-y-axis',
+            tooltipText: 'This is a popover.',
+            tooltipOptions: { position: 'top', delay: 0 },
+            isHtmlTooltip: false,
+            isSmall: false,
+            popoverContent,
+        };
+    }
+    let tc;
+    beforeEach(() => {
+        tc = new Context();
+        jest.clearAllMocks();
+    });
+    const renderToolbarButton = (props) => render(_jsx(ToolbarButton, { ...props }));
+    const openPopover = async () => {
+        const popover = screen.getByTestId(tc.testId);
+        await userEvent.click(popover);
+    };
+    it('renders popover icon without label when small', () => {
+        tc.props.isSmall = true;
+        renderToolbarButton(tc.props);
+        const popoverLabel = screen.queryByText(tc.label);
+        expect(popoverLabel).not.toBeInTheDocument();
+    });
+    it('renders popover trigger button', () => {
+        renderToolbarButton(tc.props);
+        expect(screen.getByText(tc.label)).toBeInTheDocument();
+    });
+    it('opens popover on click', async () => {
+        renderToolbarButton(tc.props);
+        await openPopover();
+        expect(screen.getByText(options[2].label)).toBeVisible();
+    });
+    it('renders disabled popover trigger', async () => {
+        renderToolbarButton({ ...tc.props, disabled: true });
+        await openPopover();
+        expect(mockOnClick).not.toHaveBeenCalled();
+    });
+    it('handles click events', async () => {
+        const handleClick = jest.fn();
+        tc.props.onClick = handleClick;
+        const { getByTestId } = renderToolbarButton(tc.props);
+        await userEvent.click(getByTestId(tc.testId));
+        expect(handleClick).toHaveBeenCalled();
+    });
+    it('handles click events within popover and does not close the popover', async () => {
+        renderToolbarButton(tc.props);
+        expect(screen.queryByText(options[4].label)).not.toBeInTheDocument();
+        await openPopover();
+        await userEvent.click(screen.getByText(options[3].label));
+        expect(screen.getByText(options[4].label)).toBeInTheDocument();
+    });
+});

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

@@ -0,0 +1,122 @@
+import React, { MouseEvent } from 'react';
+import { TooltipProps } from '../Tooltip/Tooltip.types';
+export declare const toolbarButtonVariants: readonly ["outline", "theme", "theme-light", "warning", "danger", "no-border"];
+export type ToolbarButtonVariant = typeof toolbarButtonVariants[number];
+/**
+ * Props for the ToolbarButton component that creates toolbar-style buttons with optional popovers.
+ * Designed for use in toolbars, action bars, and similar UI contexts.
+ */
+export interface ToolbarButtonProps {
+    /**
+     * Primary icon class name to display on the button.
+     * Typically uses FontAwesome classes (e.g., 'fc-zoom', 'fc-delete').
+     * This is the main visual identifier for the button's function.
+     */
+    icon: string;
+    /**
+     * Secondary icon class name to display alongside the primary icon.
+     * Useful for showing state indicators, badges, or additional context.
+     */
+    secondIcon?: string;
+    /**
+     * When true, forces the primary icon to render in a smaller size.
+     * Overrides automatic sizing based on button variant or layout.
+     */
+    forceSmallIcon?: boolean;
+    /**
+     * Text label for the toolbar button.
+     * Typically shown when the toolbar has sufficient width or in expanded states.
+     * Helps users understand the button's function when icons alone aren't clear.
+     */
+    label?: string;
+    /**
+     * React content to display in an attached popover when the button is clicked.
+     * Can be any React elements including forms, menus, or complex layouts.
+     * When provided, the button becomes a popover trigger.
+     */
+    popoverContent?: React.ReactNode;
+    /**
+     * When true, renders the button in a compact, icon-only mode.
+     * Hides the label even if provided and uses minimal padding for space-constrained layouts.
+     */
+    isSmall?: boolean;
+    /**
+     * HTML ID attribute for the toolbar button element.
+     * Should be unique across the page for proper HTML semantics and accessibility.
+     */
+    id?: string;
+    /**
+     * Additional CSS classes to apply to the toolbar button container.
+     * Use this to customize the button's appearance beyond the built-in variants.
+     */
+    extraClassNames?: string;
+    /**
+     * Test ID attribute for the toolbar button element used in automated testing.
+     * Applied to the button element for test targeting and interaction.
+     */
+    testId?: string;
+    /**
+     * Text to display in the button's tooltip when hovering.
+     * Provides additional context or instructions about the button's function.
+     */
+    tooltipText?: string;
+    /**
+     * When true, the tooltip text is rendered as HTML allowing for rich content.
+     * When false (default), the tooltip text is treated as plain text for security.
+     * Only set to true if you trust the tooltip content source.
+     */
+    isHtmlTooltip?: boolean;
+    /**
+     * Test ID attribute specifically for the tooltip element used in automated testing.
+     * Helps identify and interact with the tooltip separately from the button.
+     */
+    tooltipTestId?: string;
+    /**
+     * Configuration options for customizing tooltip behavior and appearance.
+     * Omits the 'text' property since that's handled by the `tooltipText` prop.
+     * Includes options like position, delay, and other tooltip-specific settings.
+     */
+    tooltipOptions?: Omit<TooltipProps, 'text'>;
+    /**
+     * When true, disables the toolbar button preventing user interaction.
+     * Disabled buttons appear visually dimmed and don't respond to clicks or show popovers.
+     */
+    disabled?: boolean;
+    /**
+     * Callback function triggered when the toolbar button is clicked.
+     * Primarily used for tracking, analytics, or additional click handling.
+     * Note: this doesn't prevent popover opening if popoverContent is provided.
+     */
+    onClick?: (e: MouseEvent) => void;
+    /**
+     * When true, displays the button in an "active" or "pressed" visual state.
+     * Useful for toggle buttons or indicating the current tool/mode in a toolbar.
+     */
+    isActive?: boolean;
+    /**
+     * Callback function triggered when an attached popover is hidden/closed.
+     * Use this for cleanup, state management, or other hide-related side effects.
+     */
+    onHide?: () => void;
+    /**
+     * When true, displays a visual arrow on the button indicating it has a dropdown/popover.
+     * Helps users understand that clicking will reveal additional options or content.
+     */
+    hasArrow?: boolean;
+    /**
+     * When true, treats the primary icon string as an SVG identifier instead of a font icon class.
+     * Changes how the icon is rendered and styled within the component.
+     */
+    isPrimaryAnSvg?: boolean;
+    /**
+     * Additional CSS classes to apply specifically to the primary icon element.
+     * Use this to customize the icon's appearance independently from the button container.
+     */
+    primaryIconExtraClassNames?: string;
+    /** height for the icon */
+    iconHeight?: number;
+    /** width for the icon */
+    iconWidth?: number;
+    /** viewbox for the icon */
+    primaryIconViewbox?: string;
+}

package/dist/src/ToolbarButton/ToolbarButton.types.js

@@ -0,0 +1 @@
+export const toolbarButtonVariants = ['outline', 'theme', 'theme-light', 'warning', 'danger', 'no-border'];

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

@@ -0,0 +1 @@
+export { ToolbarButton as default } from './ToolbarButton';

package/dist/src/ToolbarButton/index.js

@@ -0,0 +1 @@
+export { ToolbarButton as default } from './ToolbarButton';

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

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

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

@@ -0,0 +1,22 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Button from '../Button';
+import { tooltipPositions } from './Tooltip.types';
+import { QTip } from './Qtip';
+import Icon from '../Icon';
+export default {
+    title: 'Tooltip',
+};
+export const AllQTips = () => {
+    const renderSvgWithTooltip = () => tooltipPositions.map((position) => (_jsx("div", { className: "tw-w-full tw-flex tw-justify-center tw-items-center", children: _jsx("div", { "data-qtip-text": "this is a test tooltip", "data-qtip-placement": position, children: _jsx("svg", { viewBox: "0 0 19 19", xmlns: "http://www.w3.org/2000/svg", className: "seeq-icon p2", height: "19", width: "19", children: _jsx("path", { d: "M 2.714 1.188 L 2.714 0 L 0 0 L 0 1.188 L 0 2.375 L 0 13.656 L 0 17.813 L 0 19 L 2.714 19 L 2.714 17.813 L 2.714 13.063 L 5.441 12.465 C 7.184 12.083 9.029 12.261 10.637 12.962 C 12.511 13.782 14.687 13.883 16.646 13.237 L 19 12.469 L 19 0.594 L 16.693 1.603 C 14.729 2.464 12.418 2.464 10.454 1.603 C 8.966 0.95 7.256 0.787 5.641 1.139 L 2.714 1.781 L 2.714 1.188 Z", fill: "red" }) }) }, `${position}_svg`) })));
+    const renderButtonsWithTooltip = () => tooltipPositions.map((position) => (_jsx("div", { children: _jsx(Button, { tooltip: `Tooltip on the ${position}`, label: position, tooltipOptions: { position } }) }, `${position}_button`)));
+    const renderIconsWithHtmlTooltip = () => tooltipPositions.map((position) => (_jsx("div", { children: _jsx(Icon, { tooltip: "<div><h2>Fancy Tooltip</h2> This is a special tooltip. Why? <br />Because it supports <b>HTML!</b></div>", tooltipPlacement: position, icon: "fc-sun", isHtmlTooltip: true }) }, `${position}_icon`)));
+    const renderTextTooltipOnText = () => tooltipPositions.map((position) => (_jsx("div", { children: _jsxs("span", { "data-qtip-text": "Helpful information provided here", "data-qtip-placement": position, children: ["Hover for Tooltip (on the ", position, ")"] }) }, `${position}_text`)));
+    const renderTextTooltipOnTextWithDelay = () => tooltipPositions.map((position) => (_jsx("div", { children: _jsxs("span", { "data-qtip-text": "Helpful information provided here", "data-qtip-placement": position, "data-qtip-delay": 1500, children: ["Hover for Tooltip (on the ", position, ") - with delay (1500ms)"] }) }, `${position}_text`)));
+    const renderTextTooltipOnOverflowHiddenText = () => tooltipPositions.map((position) => (_jsx("div", { className: "tw-overflow-hidden", children: _jsxs("span", { "data-qtip-text": "Helpful information provided here", "data-qtip-placement": position, children: ["Hover for Tooltip (on the ", position, ")",
+                _jsx("br", {}),
+                "(Overflow set to hidden)"] }) }, `${position}_text`)));
+    const renderTextTooltipToRealignAtScreenEdge = () => tooltipPositions.map((position) => (_jsx("div", { className: "tw-overflow-hidden", children: _jsx("span", { "data-qtip-text": "This tooltip will realign its arrow and position if the data to be displayed within it goes beyond the screen edge. The text after this will be dummy text just to show a lot of text. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.", "data-qtip-placement": position, children: "Hover for Tooltip (Should avoid screen edges)" }) }, `${position}_text`)));
+    return (_jsxs(_Fragment, { children: [
+            _jsx(QTip, {}), _jsxs("div", { className: "tw-grid tw-grid-cols-4 tw-gap-4 tw-text-center", children: [renderSvgWithTooltip(), renderButtonsWithTooltip(), renderIconsWithHtmlTooltip(), renderTextTooltipOnText(), renderTextTooltipOnTextWithDelay(), renderTextTooltipOnOverflowHiddenText(), renderTextTooltipToRealignAtScreenEdge()] })
+        ] }));
+};

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

@@ -0,0 +1,13 @@
+import { TooltipPosition } from './Tooltip.types';
+export interface QTipDataAttributes {
+    /** text displayed by the tooltip */
+    'data-qtip-text': string;
+    /** one of TooltipPosition */
+    'data-qtip-placement'?: TooltipPosition;
+    /** set to true to render the provided text as html */
+    'data-qtip-is-html'?: boolean;
+    /** number of milliseconds to wait before showing a tooltip on-hover */
+    'data-qtip-delay'?: number;
+    /** useful for testing; sets the provided string as the data-testid attribute of the tooltip */
+    'data-qtip-testid'?: string;
+}

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

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

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

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

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

@@ -0,0 +1,27 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { QTip } from './Qtip';
+import Icon from '../Icon';
+export default {
+    title: 'Tooltip',
+};
+const renderManyQTips = () => {
+    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(Icon, { icon: "fc-sun", tooltip: `hello there ${i}` }) }, '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 QtipPerformance = () => {
+    return (_jsxs(_Fragment, { children: [
+            _jsx(QTip, {}), _jsx("div", { className: "tw-grid tw-grid-cols-4 tw-gap-4 tw-text-center", children: renderManyQTips() })
+        ] }));
+};

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

@@ -0,0 +1,26 @@
+import React from 'react';
+/**
+ * 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 declare const QTip: React.FunctionComponent<any>;