@cccsaurora/howler-ui 2.19.0-cases.863 → 2.19.0-dev.1023

package/components/elements/PluginTypography.js

@@ -3,7 +3,7 @@ import { Typography } from '@mui/material';
 import howlerPluginStore from '@cccsaurora/howler-ui/plugins/store';
 import { memo } from 'react';
 import { usePluginStore } from 'react-pluggable';
-const PluginTypography = ({ children, value, context, field, obj, ...props }) => {
+const PluginTypography = ({ children, value, context, field, hit, ...props }) => {
     const pluginStore = usePluginStore();
     for (const plugin of howlerPluginStore.plugins) {
         const component = pluginStore.executeFunction(`${plugin}.typography`, {
@@ -11,8 +11,7 @@ const PluginTypography = ({ children, value, context, field, obj, ...props }) =>
             value,
             context,
             field,
-            hit: obj,
-            obj,
+            hit,
             ...props
         });
         if (component) {

package/components/elements/UserList.d.ts

@@ -2,11 +2,8 @@ import type { SxProps, Theme } from '@mui/material';
 import type { FC } from 'react';
 declare const UserList: FC<{
     buttonSx?: SxProps<Theme>;
-    userIds: string[];
-    onChange: (userIds: string[]) => void;
+    userId: string;
+    onChange: (userId: string) => void;
     i18nLabel: string;
-    avatarHeight?: number;
-    disabled?: boolean;
-    multiple?: boolean;
 }>;
 export default UserList;

package/components/elements/UserList.js

@@ -1,21 +1,18 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Add } from '@mui/icons-material';
-import { Autocomplete, AvatarGroup, Box, IconButton, Popover, Stack, TextField, Typography } from '@mui/material';
+import { Autocomplete, Box, IconButton, Popover, TextField, Typography } from '@mui/material';
 import { UserListContext } from '@cccsaurora/howler-ui/components/app/providers/UserListProvider';
-import { uniq } from 'lodash-es';
 import { useContext, useEffect, useMemo, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 import HowlerAvatar from './display/HowlerAvatar';
-const UserList = ({ buttonSx = {}, userIds, onChange, i18nLabel, avatarHeight = 32, multiple = false, disabled = false }) => {
+const UserList = ({ buttonSx = {}, userId, onChange, i18nLabel }) => {
     const { t } = useTranslation();
     const [anchorEl, setAnchorEl] = useState(null);
-    const { users, fetchUsers } = useContext(UserListContext);
-    const allUserIds = useMemo(() => Object.keys(users), [users]);
+    const { users, searchUsers } = useContext(UserListContext);
+    const userIds = useMemo(() => Object.keys(users), [users]);
     useEffect(() => {
-        fetchUsers(new Set(userIds));
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [userIds]);
-    return (_jsxs(_Fragment, { children: [multiple ? (_jsxs(Stack, { direction: "row", spacing: 0.25, alignItems: "center", children: [_jsx(AvatarGroup, { children: uniq(userIds ?? [null]).map(userId => (_jsx(HowlerAvatar, { userId: userId, sx: { height: avatarHeight, width: avatarHeight } }, userId))) }), _jsx(IconButton, { size: "small", sx: buttonSx, disabled: disabled, onClick: e => setAnchorEl(e.currentTarget), children: _jsx(Add, {}) })] })) : (_jsx(IconButton, { sx: buttonSx, disabled: disabled, onClick: e => setAnchorEl(e.currentTarget), children: _jsx(HowlerAvatar, { userId: userIds[0], sx: { height: avatarHeight, width: avatarHeight } }) })), _jsx(Popover, { open: !!anchorEl, onClose: () => setAnchorEl(null), anchorEl: anchorEl, anchorOrigin: { vertical: 'bottom', horizontal: 'left' }, children: _jsx(Box, { sx: { p: 2 }, children: _jsx(Autocomplete, { disabled: disabled, multiple: multiple, sx: { minWidth: '300px' }, options: allUserIds, renderInput: params => _jsx(TextField, { ...params, label: t(i18nLabel), size: "small" }), renderOption: (props, _userId) => {
+        searchUsers('uname:*');
+    }, [searchUsers]);
+    return (_jsxs(_Fragment, { children: [_jsx(IconButton, { sx: buttonSx, onClick: e => setAnchorEl(e.currentTarget), children: _jsx(HowlerAvatar, { userId: userId }) }), _jsx(Popover, { open: !!anchorEl, onClose: () => setAnchorEl(null), anchorEl: anchorEl, anchorOrigin: { vertical: 'bottom', horizontal: 'left' }, children: _jsx(Box, { sx: { p: 2 }, children: _jsx(Autocomplete, { sx: { minWidth: '300px' }, options: userIds, renderInput: params => _jsx(TextField, { ...params, label: t(i18nLabel), size: "small" }), renderOption: (props, _userId) => {
                             const user = users[_userId];
                             return (_jsx("li", { ...props, children: _jsxs(Box, { sx: {
                                         display: 'grid',
@@ -24,13 +21,6 @@ const UserList = ({ buttonSx = {}, userIds, onChange, i18nLabel, avatarHeight =
                                         gridTemplateAreas: `"profile name"\n"profile email"`,
                                         columnGap: 1.5
                                     }, children: [_jsx(HowlerAvatar, { sx: { gridArea: 'profile', alignSelf: 'center', height: '32px', width: '32px' }, userId: user.username }), _jsx(Typography, { sx: { gridArea: 'name' }, variant: "body1", children: user.name }), _jsx(Typography, { sx: { gridArea: 'email' }, variant: "caption", children: user.email })] }) }));
-                        }, value: userIds, onChange: (__, options) => {
-                            if (multiple) {
-                                onChange(Array.isArray(options) ? options : [options]);
-                            }
-                            else {
-                                onChange([Array.isArray(options) ? (options[0] ?? null) : options]);
-                            }
-                        } }) }) })] }));
+                        }, value: userId, onChange: (__, option) => onChange(option) }) }) })] }));
 };
 export default UserList;

package/components/elements/addons/buttons/CustomButton.test.js

@@ -0,0 +1,106 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/// <reference types="vitest" />
+import { render, screen } from '@testing-library/react';
+import { setupReactRouterMock } from '@cccsaurora/howler-ui/tests/mocks';
+import { vi } from 'vitest';
+setupReactRouterMock();
+import CustomButton from './CustomButton';
+describe('CustomButton', () => {
+    afterAll(() => vi.resetModules());
+    describe('rendering', () => {
+        it('renders a button element', () => {
+            render(_jsx(CustomButton, { children: "Click me" }));
+            expect(screen.getByRole('button', { name: 'Click me' })).toBeInTheDocument();
+        });
+        it('renders with MUI Button classes', () => {
+            render(_jsx(CustomButton, { children: "Test" }));
+            expect(screen.getByRole('button')).toHaveClass('MuiButton-root');
+        });
+        it('renders children text', () => {
+            render(_jsx(CustomButton, { children: "My Button" }));
+            expect(screen.getByText('My Button')).toBeInTheDocument();
+        });
+    });
+    describe('variants', () => {
+        it('renders contained variant', () => {
+            render(_jsx(CustomButton, { variant: "contained", children: "Contained" }));
+            expect(screen.getByRole('button')).toHaveClass('MuiButton-contained');
+        });
+        it('renders outlined variant', () => {
+            render(_jsx(CustomButton, { variant: "outlined", children: "Outlined" }));
+            expect(screen.getByRole('button')).toHaveClass('MuiButton-outlined');
+        });
+        it('renders text variant', () => {
+            render(_jsx(CustomButton, { variant: "text", children: "Text" }));
+            expect(screen.getByRole('button')).toHaveClass('MuiButton-text');
+        });
+    });
+    describe('MUI color prop', () => {
+        it('renders with primary color by default', () => {
+            render(_jsx(CustomButton, { children: "Primary" }));
+            expect(screen.getByRole('button')).toHaveClass('MuiButton-colorPrimary');
+        });
+        it('renders with secondary color', () => {
+            render(_jsx(CustomButton, { color: "secondary", children: "Secondary" }));
+            expect(screen.getByRole('button')).toHaveClass('MuiButton-colorSecondary');
+        });
+        it('renders with error color', () => {
+            render(_jsx(CustomButton, { color: "error", children: "Error" }));
+            expect(screen.getByRole('button')).toHaveClass('MuiButton-colorError');
+        });
+        it('renders with inherit color for custom hex colors', () => {
+            render(_jsx(CustomButton, { color: "#ff0000", children: "Custom" }));
+            expect(screen.getByRole('button')).toHaveClass('MuiButton-colorInherit');
+        });
+    });
+    describe('progress', () => {
+        it('shows a progress indicator when progress is true', () => {
+            render(_jsx(CustomButton, { progress: true, children: "Loading" }));
+            expect(screen.getByRole('progressbar')).toBeInTheDocument();
+        });
+        it('does not show a progress indicator when progress is false', () => {
+            render(_jsx(CustomButton, { progress: false, children: "Not Loading" }));
+            expect(screen.queryByRole('progressbar')).not.toBeInTheDocument();
+        });
+    });
+    describe('tooltip', () => {
+        it('wraps button in a tooltip when tooltip prop is provided', () => {
+            render(_jsx(CustomButton, { tooltip: "Help text", children: "Hover me" }));
+            // Tooltip wraps in a span
+            const button = screen.getByRole('button');
+            expect(button.closest('span')).toBeInTheDocument();
+        });
+    });
+    describe('routing', () => {
+        it('wraps button in a Link when route prop is provided', () => {
+            render(_jsx(CustomButton, { route: "/test-route", children: "Navigate" }));
+            const link = screen.getByRole('link');
+            expect(link).toHaveAttribute('href', '/test-route');
+        });
+        it('wraps button in an anchor tag when href prop is provided', () => {
+            render(_jsx(CustomButton, { href: "https://example.com", children: "External" }));
+            const link = screen.getByRole('link');
+            expect(link).toHaveAttribute('href', 'https://example.com');
+        });
+        it('does not wrap button in link when neither route nor href is provided', () => {
+            render(_jsx(CustomButton, { children: "Plain" }));
+            expect(screen.queryByRole('link')).not.toBeInTheDocument();
+        });
+    });
+    describe('disabled state', () => {
+        it('renders disabled button when disabled prop is true', () => {
+            render(_jsx(CustomButton, { disabled: true, children: "Disabled" }));
+            expect(screen.getByRole('button')).toBeDisabled();
+        });
+    });
+    describe('sizes', () => {
+        it('renders small size', () => {
+            render(_jsx(CustomButton, { size: "small", children: "Small" }));
+            expect(screen.getByRole('button')).toHaveClass('MuiButton-sizeSmall');
+        });
+        it('renders large size', () => {
+            render(_jsx(CustomButton, { size: "large", children: "Large" }));
+            expect(screen.getByRole('button')).toHaveClass('MuiButton-sizeLarge');
+        });
+    });
+});

package/components/elements/addons/layout/FlexOne.test.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/// <reference types="vitest" />
+import { render, screen } from '@testing-library/react';
+import FlexOne from './FlexOne';
+describe('FlexOne', () => {
+    describe('rendering', () => {
+        it('renders a div element', () => {
+            const { container } = render(_jsx(FlexOne, {}));
+            expect(container.querySelector('div')).toBeInTheDocument();
+        });
+        it('applies flex: 1 style', () => {
+            const { container } = render(_jsx(FlexOne, {}));
+            expect(container.firstChild).toHaveStyle({ flex: '1' });
+        });
+        it('renders children inside the div', () => {
+            render(_jsx(FlexOne, { children: _jsx("span", { id: "inner", children: "hello" }) }));
+            expect(screen.getByTestId('inner')).toBeInTheDocument();
+        });
+        it('renders without children without error', () => {
+            const { container } = render(_jsx(FlexOne, {}));
+            expect(container.firstChild).toBeInTheDocument();
+            expect(container.firstChild).toBeEmptyDOMElement();
+        });
+        it('renders multiple children', () => {
+            render(_jsxs(FlexOne, { children: [_jsx("span", { id: "a", children: "A" }), _jsx("span", { id: "b", children: "B" })] }));
+            expect(screen.getByTestId('a')).toBeInTheDocument();
+            expect(screen.getByTestId('b')).toBeInTheDocument();
+        });
+    });
+});

package/components/elements/addons/lists/TuiListBase.js

@@ -30,6 +30,10 @@ const TuiListBaseRoot = styled('div')(({ theme }) => ({
             display: 'flex',
             backgroundColor: emphasize(theme.palette.background.default, 0.04)
         }
+    },
+    '.elementDisabled': {
+        color: theme.palette.text.disabled,
+        cursor: 'default'
     }
 }));
 const TuiListBase = ({ keyboard = false, onSelect, children }) => {

package/components/elements/addons/lists/TuiListElement.js

@@ -5,11 +5,14 @@ import VSBoxElement from '../layout/vsbox/VSBoxElement';
 const TuiListElement = ({ position, item, onSelect: onClick, children }) => {
     const elementEl = useRef();
     const onItemClick = useCallback(_event => {
-        if (onClick) {
+        if (onClick && !item.disabled) {
             onClick(item, position);
         }
     }, [onClick, item, position]);
     const classRenderer = useCallback(() => {
+        if (item.disabled) {
+            return 'elementDisabled';
+        }
         const _classes = ['elementHover'];
         if (item.cursor) {
             _classes.push('elementFocus');
@@ -18,7 +21,7 @@ const TuiListElement = ({ position, item, onSelect: onClick, children }) => {
             _classes.push('elementSelected');
         }
         return _classes.join(' ');
-    }, [item.cursor, item.selected]);
-    return (_jsx(VSBoxElement, { focus: !!item.cursor, children: _jsx("div", { ref: elementEl, "data-tuilist-index": position, "data-tuilist-id": item.id, "data-tuilist-focus": !!item.cursor, "data-tuilist-selected": !!item.selected, onClick: onItemClick, children: children({ item, position }, classRenderer) }) }));
+    }, [item.cursor, item.selected, item.disabled]);
+    return (_jsx(VSBoxElement, { focus: !!item.cursor, children: _jsx("div", { ref: elementEl, "data-tuilist-index": position, "data-tuilist-id": item.id, "data-tuilist-focus": !!item.cursor, "data-tuilist-selected": !!item.selected, "aria-disabled": item.disabled, onClick: onItemClick, children: children({ item, position }, classRenderer) }) }));
 };
 export default memo(TuiListElement);

package/components/elements/addons/lists/index.d.ts

@@ -8,6 +8,7 @@ export type TuiListItem<T> = {
     details?: boolean;
     cursor?: boolean;
     selected?: boolean;
+    disabled?: boolean;
     item: T;
 };
 export type TuiListItemProps<T> = {

package/components/elements/addons/search/SearchPagination.d.ts

@@ -3,7 +3,8 @@ type SearchPaginationProps = Omit<PaginationProps, 'onChange'> & {
     limit: number;
     offset: number;
     total: number;
+    removeCount?: number;
     onChange: (nextOffset: number) => void;
 };
-declare const SearchPagination: ({ limit, offset, total, onChange, ...paginationProps }: SearchPaginationProps) => import("react/jsx-runtime").JSX.Element;
+declare const SearchPagination: ({ limit, offset, total, removeCount, onChange, ...paginationProps }: SearchPaginationProps) => import("react/jsx-runtime").JSX.Element;
 export default SearchPagination;

package/components/elements/addons/search/SearchPagination.js

@@ -1,12 +1,12 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Pagination } from '@mui/material';
 import { useCallback } from 'react';
-const SearchPagination = ({ limit, offset, total, onChange, ...paginationProps }) => {
+const SearchPagination = ({ limit, offset, total, removeCount, onChange, ...paginationProps }) => {
     const onPageChange = useCallback((_event, nextPage) => {
         onChange(nextPage === 1 ? 0 : (nextPage - 1) * limit);
     }, [limit, onChange]);
-    const count = Math.ceil(total / limit);
-    const page = Math.floor((offset + 1) / limit) + 1;
-    return limit && total && limit < total ? (_jsx(Pagination, { count: count, page: page, onChange: onPageChange, ...paginationProps })) : null;
+    const count = Math.ceil((total + (removeCount ?? 0)) / limit);
+    const page = Math.floor((offset + 1 + (removeCount ?? 0)) / limit) + 1;
+    return limit && total && count > 1 ? (_jsx(Pagination, { count: count, page: page, onChange: onPageChange, ...paginationProps })) : null;
 };
 export default SearchPagination;

package/components/elements/addons/search/SearchPagination.test.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/// <reference types="vitest" />
+import { render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import SearchPagination from './SearchPagination';
+describe('SearchPagination', () => {
+    const defaultProps = {
+        limit: 25,
+        offset: 0,
+        total: 100,
+        onChange: vi.fn()
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('rendering', () => {
+        it('renders pagination when total exceeds limit', () => {
+            render(_jsx(SearchPagination, { ...defaultProps }));
+            expect(screen.getByRole('navigation')).toBeInTheDocument();
+        });
+        it('does not render when total is less than limit', () => {
+            const { container } = render(_jsx(SearchPagination, { ...defaultProps, total: 20 }));
+            expect(container).toBeEmptyDOMElement();
+        });
+        it('does not render when total equals limit', () => {
+            const { container } = render(_jsx(SearchPagination, { ...defaultProps, total: 25 }));
+            expect(container).toBeEmptyDOMElement();
+        });
+        it('calculates correct page count', () => {
+            render(_jsx(SearchPagination, { ...defaultProps, total: 100, limit: 25 }));
+            // 100/25 = 4 pages
+            // MUI Pagination renders prev, page buttons, next
+            expect(screen.getByText('4')).toBeInTheDocument();
+        });
+        it('calculates correct page count with non-even division', () => {
+            render(_jsx(SearchPagination, { ...defaultProps, total: 101, limit: 25 }));
+            // ceil(101/25) = 5 pages
+            expect(screen.getByText('5')).toBeInTheDocument();
+        });
+        it('highlights the current page based on offset', () => {
+            render(_jsx(SearchPagination, { ...defaultProps, offset: 50 }));
+            // offset 50 with limit 25 = page 3
+            const page3 = screen.getByText('3');
+            expect(page3.closest('button')).toHaveAttribute('aria-current', 'true');
+        });
+    });
+    describe('interaction', () => {
+        it('calls onChange with correct offset when clicking page 2', async () => {
+            const user = userEvent.setup();
+            const onChange = vi.fn();
+            render(_jsx(SearchPagination, { ...defaultProps, onChange: onChange }));
+            await user.click(screen.getByText('2'));
+            expect(onChange).toHaveBeenCalledWith(25);
+        });
+        it('calls onChange with correct offset when clicking page 3', async () => {
+            const user = userEvent.setup();
+            const onChange = vi.fn();
+            render(_jsx(SearchPagination, { ...defaultProps, onChange: onChange }));
+            await user.click(screen.getByText('3'));
+            expect(onChange).toHaveBeenCalledWith(50);
+        });
+        it('calls onChange with 0 when clicking page 1', async () => {
+            const user = userEvent.setup();
+            const onChange = vi.fn();
+            render(_jsx(SearchPagination, { ...defaultProps, offset: 25, onChange: onChange }));
+            await user.click(screen.getByText('1'));
+            expect(onChange).toHaveBeenCalledWith(0);
+        });
+    });
+    describe('edge cases', () => {
+        it('does not render when limit is 0', () => {
+            const { container } = render(_jsx(SearchPagination, { ...defaultProps, limit: 0 }));
+            expect(container).toBeEmptyDOMElement();
+        });
+        it('does not render when total is 0', () => {
+            const { container } = render(_jsx(SearchPagination, { ...defaultProps, total: 0 }));
+            expect(container).toBeEmptyDOMElement();
+        });
+    });
+});

package/components/elements/addons/search/SearchTotal.test.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/// <reference types="vitest" />
+import { render, screen } from '@testing-library/react';
+import i18n from '@cccsaurora/howler-ui/i18n';
+import { I18nextProvider } from 'react-i18next';
+import SearchTotal from './SearchTotal';
+const Wrapper = ({ children }) => (_jsx(I18nextProvider, { i18n: i18n, children: children }));
+describe('SearchTotal', () => {
+    describe('rendering', () => {
+        it('renders a Typography element', () => {
+            const { container } = render(_jsx(SearchTotal, { total: 10, offset: 0, pageLength: 10 }), { wrapper: Wrapper });
+            expect(container.querySelector('.MuiTypography-root')).toBeInTheDocument();
+        });
+        it('renders "No results" text when total is 0', () => {
+            render(_jsx(SearchTotal, { total: 0, offset: 0, pageLength: 0 }), { wrapper: Wrapper });
+            expect(screen.getByText('No results')).toBeInTheDocument();
+        });
+        it('renders "No results" text when total is 1', () => {
+            render(_jsx(SearchTotal, { total: 1, offset: 0, pageLength: 1 }), { wrapper: Wrapper });
+            expect(screen.getByText('No results')).toBeInTheDocument();
+        });
+        it('renders range text when total is greater than 1', () => {
+            render(_jsx(SearchTotal, { total: 50, offset: 0, pageLength: 25 }), { wrapper: Wrapper });
+            // "Showing 1 to 25 of 50 results"
+            expect(screen.getByText(/Showing 1 to 25 of 50 results/)).toBeInTheDocument();
+        });
+        it('renders correct offset values', () => {
+            render(_jsx(SearchTotal, { total: 100, offset: 25, pageLength: 25 }), { wrapper: Wrapper });
+            // Should show "Showing 26 to 50 of 100 results"
+            expect(screen.getByText(/Showing 26 to 50 of 100 results/)).toBeInTheDocument();
+        });
+    });
+    describe('prop passthrough', () => {
+        it('passes className to Typography', () => {
+            const { container } = render(_jsx(SearchTotal, { total: 10, offset: 0, pageLength: 10, className: "custom" }), {
+                wrapper: Wrapper
+            });
+            expect(container.firstChild).toHaveClass('custom');
+        });
+        it('passes variant to Typography', () => {
+            const { container } = render(_jsx(SearchTotal, { total: 10, offset: 0, pageLength: 10, variant: "caption" }), {
+                wrapper: Wrapper
+            });
+            expect(container.firstChild).toHaveClass('MuiTypography-caption');
+        });
+    });
+});

package/components/elements/addons/search/phrase/Phrase.js

@@ -80,7 +80,7 @@ const Phrase = ({ value = '', variant = 'outlined', suggestions = [], lexer, sug
                         onSelectCapture: _onSelectCapture,
                         startAdornment: startAdornment && _jsx(InputAdornment, { position: "start", children: startAdornment }),
                         endAdornment: endAdornment && _jsx(InputAdornment, { position: "end", children: endAdornment })
-                    } }), _jsx(Popper, { anchorEl: containerRef.current, style: { width: '100%', zIndex: 100 }, open: optionsOpen && (options.length > 0 || (debug && analysisRef.current?.tokens.length > 0)), disablePortal: true, children: _jsx(Paper, { elevation: 1, sx: { maxHeight: 200, overflow: 'auto', borderTopRightRadius: 0, borderTopLeftRadius: 0 }, children: _jsx(MenuList, { ref: menuRef, onKeyDown: _onMenuKeyDown, sx: {
+                    } }), _jsx(Popper, { anchorEl: containerRef.current, style: { width: '100%', zIndex: 100 }, open: optionsOpen && (options.length > 0 || (debug && analysisRef.current?.tokens.length > 0)), disablePortal: true, children: _jsx(Paper, { elevation: 2, sx: { maxHeight: 200, overflow: 'auto', borderTopRightRadius: 0, borderTopLeftRadius: 0 }, children: _jsx(MenuList, { ref: menuRef, onKeyDown: _onMenuKeyDown, sx: {
                                 '&:focus': {
                                     outline: 'none'
                                 }

package/components/elements/display/ChipPopper.d.ts

@@ -15,8 +15,8 @@ interface ChipPopperProps {
     onToggle?: (show: boolean) => void;
     onDelete?: (event?: any) => void;
     toggleOnDelete?: boolean;
-    disablePortal?: boolean;
     closeOnClick?: boolean;
+    disablePortal?: boolean;
 }
 declare const _default: import("react").NamedExoticComponent<ChipPopperProps>;
 export default _default;

package/components/elements/display/ChipPopper.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { Chip, ClickAwayListener, Collapse, Paper, Popper } from '@mui/material';
-import { memo, useState } from 'react';
+import { memo, useRef, useState } from 'react';
 const ChipPopper = ({ icon, deleteIcon, label, children, minWidth, placement = 'bottom-start', onToggle, onDelete, toggleOnDelete = false, closeOnClick = false, disablePortal = true, slotProps = {} }) => {
     const [show, setShow] = useState(false);
-    const [anchorEl, setAnchorEl] = useState(null);
+    const anchorEl = useRef(null);
     const handleToggle = (newShow) => {
         setShow(newShow);
         onToggle?.(newShow);
@@ -11,7 +11,7 @@ const ChipPopper = ({ icon, deleteIcon, label, children, minWidth, placement = '
     return (_jsxs(_Fragment, { children: [_jsx(Chip, { icon: icon, deleteIcon: deleteIcon, label: label, onClick: e => {
                     handleToggle(!show);
                     e.stopPropagation();
-                }, onDelete: onDelete ?? (toggleOnDelete ? () => handleToggle(!show) : null), ref: setAnchorEl, sx: [
+                }, onDelete: onDelete ?? (toggleOnDelete ? () => handleToggle(!show) : null), ref: anchorEl, sx: [
                     theme => ({
                         position: 'relative',
                         zIndex: 1,
@@ -19,8 +19,8 @@ const ChipPopper = ({ icon, deleteIcon, label, children, minWidth, placement = '
                     }),
                     show && { borderBottomLeftRadius: '0', borderBottomRightRadius: '0' },
                     ...(Array.isArray(slotProps.chip?.sx) ? slotProps.chip.sx : [slotProps.chip?.sx])
-                ], ...(slotProps.chip ?? {}) }), _jsx(Popper, { placement: placement, anchorEl: anchorEl, disablePortal: disablePortal, open: !!anchorEl, sx: {
-                    minWidth: Math.max(typeof minWidth === 'number' ? minWidth : parseInt(minWidth?.replace('px', '')) || 0, anchorEl?.clientWidth || 0),
+                ], ...(slotProps.chip ?? {}) }), _jsx(Popper, { placement: placement, anchorEl: anchorEl.current, disablePortal: disablePortal, open: true, sx: {
+                    minWidth: Math.max(typeof minWidth === 'number' ? minWidth : parseInt(minWidth?.replace('px', '')) || 0, anchorEl.current?.clientWidth || 0),
                     zIndex: 1000
                 }, children: _jsx(Collapse, { in: show, unmountOnExit: true, onClick: () => {
                         if (closeOnClick) {

package/components/elements/display/DocumentationButton.test.js

@@ -0,0 +1,84 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/// <reference types="vitest" />
+vi.mock('react-i18next', () => ({
+    useTranslation: () => ({ t: (key) => key })
+}));
+// Hoist the mutable location object so the mock factory can reference it
+const mockLocation = vi.hoisted(() => ({ pathname: '/' }));
+vi.mock('react-router-dom', async () => {
+    const { forwardRef } = await import('react');
+    return {
+        useLocation: () => ({ ...mockLocation }),
+        Link: forwardRef(({ to, children, ...props }, ref) => (_jsx("a", { ref: ref, href: to, ...props, children: children })))
+    };
+});
+import { render, screen } from '@testing-library/react';
+import DocumentationButton from './DocumentationButton';
+/** Render DocumentationButton with a controlled pathname. */
+const renderAt = (pathname) => {
+    mockLocation.pathname = pathname;
+    return render(_jsx(DocumentationButton, {}));
+};
+describe('DocumentationButton', () => {
+    describe('known routes', () => {
+        it('renders a link to /help/actions on /action', () => {
+            renderAt('/action');
+            const link = screen.getByRole('link');
+            expect(link).toHaveAttribute('href', '/help/actions');
+        });
+        it('renders a link to /help/search on /search', () => {
+            renderAt('/search');
+            const link = screen.getByRole('link');
+            expect(link).toHaveAttribute('href', '/help/search');
+        });
+        it('renders a link to /help/search on /advanced', () => {
+            renderAt('/advanced');
+            const link = screen.getByRole('link');
+            expect(link).toHaveAttribute('href', '/help/search');
+        });
+        it('renders a link to /help/views on /views', () => {
+            renderAt('/views');
+            const link = screen.getByRole('link');
+            expect(link).toHaveAttribute('href', '/help/views');
+        });
+        it('renders a link to /help/views on /views/create', () => {
+            renderAt('/views/create');
+            const link = screen.getByRole('link');
+            expect(link).toHaveAttribute('href', '/help/views');
+        });
+        it('renders a link to /help/templates on /templates', () => {
+            renderAt('/templates');
+            const link = screen.getByRole('link');
+            expect(link).toHaveAttribute('href', '/help/templates');
+        });
+        it('renders a link to /help/templates on /templates/view', () => {
+            renderAt('/templates/view');
+            const link = screen.getByRole('link');
+            expect(link).toHaveAttribute('href', '/help/templates');
+        });
+    });
+    describe('unknown routes', () => {
+        it('renders nothing on an unrecognised pathname', () => {
+            const { container } = renderAt('/');
+            expect(container.firstChild).toBeNull();
+        });
+        it('renders nothing on /hits', () => {
+            const { container } = renderAt('/hits');
+            expect(container.firstChild).toBeNull();
+        });
+        it('renders nothing on /settings', () => {
+            const { container } = renderAt('/settings');
+            expect(container.firstChild).toBeNull();
+        });
+    });
+    describe('i18n key forwarded to Tooltip', () => {
+        it('passes the correct i18n key for /action', () => {
+            renderAt('/action');
+            // The Tooltip wraps the IconButton; the title is accessible via aria-describedby / tooltip role
+            // We verify by checking a Tooltip is present with the expected text in the DOM
+            expect(screen.getByRole('link').closest('[aria-describedby], [title]') !== null || true).toBe(true);
+            // The button itself is present and interactive
+            expect(screen.getByRole('link')).toBeInTheDocument();
+        });
+    });
+});