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

package/components/app/providers/SocketProvider.d.ts

@@ -48,18 +48,9 @@ interface SocketContextType {
      */
     reconnect: () => void;
     /**
-     * Helper to tell if the socket is open
+     * Helper function to tell if the socket is open
      */
-    open: boolean;
-    /**
-     * A map of entity IDs to their current viewers.
-     */
-    viewers: Record<string, string[]>;
-    /**
-     * Fetch the current viewers for an entity via REST, then keep in sync via socket.
-     * @param entityId The entity ID to fetch viewers for
-     */
-    fetchViewers: (entityId: string) => Promise<void>;
+    isOpen: () => boolean;
 }
 export declare const SocketContext: import("react").Context<SocketContextType>;
 declare const SocketProvider: React.FC<PropsWithChildren>;

package/components/app/providers/SocketProvider.js

@@ -1,12 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 /* eslint-disable no-console */
 import api from '@cccsaurora/howler-ui/api';
-import useMyApi from '@cccsaurora/howler-ui/components/hooks/useMyApi';
 import useMyLocalStorage from '@cccsaurora/howler-ui/components/hooks/useMyLocalStorage';
-import { createContext, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { createContext, useCallback, useEffect, useRef, useState } from 'react';
 import { StorageKey } from '@cccsaurora/howler-ui/utils/constants';
 import { getStored, setAxiosCache, setStored } from '@cccsaurora/howler-ui/utils/sessionStorage';
-import { isHitUpdate, isViewersUpdate } from '@cccsaurora/howler-ui/utils/socketUtils';
+import { isHitUpdate } from '@cccsaurora/howler-ui/utils/socketUtils';
 /**
  * Enum to help track the status of the Websocket, since the corresponding websocket enums are directly on the object
  */
@@ -20,7 +19,6 @@ export var Status;
 export const SocketContext = createContext(null);
 const SocketProvider = ({ children }) => {
     const { get } = useMyLocalStorage();
-    const { dispatchApi } = useMyApi();
     // In order to persist the connection through state changes, we use a ref
     const socket = useRef();
     // Due to react setState race conditions, listeners are also stored in a ref
@@ -33,8 +31,6 @@ const SocketProvider = ({ children }) => {
     const [retry, setRetry] = useState(true);
     // Track the number of failed attempts when connecting to the server
     const [failedAttempts, setFailedAttempts] = useState(0);
-    // Track active viewers per entity ID
-    const [viewers, setViewers] = useState({});
     const onClose = useCallback(e => {
         // https://www.rfc-editor.org/rfc/rfc6455:
         // 1006 is a reserved value and MUST NOT be set as a status code in a
@@ -187,7 +183,7 @@ const SocketProvider = ({ children }) => {
     const addListener = useCallback((key, callback) => {
         // If a listener with the same key already exists, remove it.
         if (listeners.current[key]) {
-            socket.current?.removeEventListener('message', listeners.current[key]);
+            socket.current?.removeEventListener('message', listeners[key]);
         }
         // We wrap the callback so that all the listeners don't need to JSON.parse the data
         const wrapped = ev => {
@@ -204,9 +200,6 @@ const SocketProvider = ({ children }) => {
                     api_status_code: parsedData.status
                 });
             }
-            if (isViewersUpdate(parsedData)) {
-                setViewers(prev => ({ ...prev, [parsedData.id]: parsedData.viewers }));
-            }
             callback(parsedData);
         };
         socket.current?.addEventListener('message', wrapped);
@@ -226,14 +219,8 @@ const SocketProvider = ({ children }) => {
         }
         socket.current?.send(data);
     }, [status]);
-    const open = useMemo(() => status === Status.OPEN, [status]);
+    const isOpen = useCallback(() => status === Status.OPEN, [status]);
     const reconnect = useCallback(() => setRetry(true), []);
-    const fetchViewers = useCallback(async (entityId) => {
-        const result = await dispatchApi(api.socket.viewers.get(entityId), { throwError: false });
-        if (result) {
-            setViewers(prev => ({ ...prev, [entityId]: result }));
-        }
-    }, [dispatchApi]);
-    return (_jsx(SocketContext.Provider, { value: { addListener, removeListener, emit, status, reconnect, open, viewers, fetchViewers }, children: children }));
+    return (_jsx(SocketContext.Provider, { value: { addListener, removeListener, emit, status, reconnect, isOpen }, children: children }));
 };
 export default SocketProvider;

package/components/app/providers/UserListProvider.js

@@ -1,15 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import api from '@cccsaurora/howler-ui/api';
 import useMyApi from '@cccsaurora/howler-ui/components/hooks/useMyApi';
-import { createContext, useCallback, useEffect, useRef, useState } from 'react';
+import { createContext, useCallback, useState } from 'react';
 export const UserListContext = createContext(null);
 const UserListProvider = ({ children }) => {
     const { dispatchApi } = useMyApi();
     const [users, setUsers] = useState({});
-    const usersRef = useRef(users);
-    usersRef.current = users;
-    const pendingIds = useRef(new Set());
-    const debounceTimer = useRef(null);
     const searchUsers = useCallback(async (query) => {
         const newUsers = (await dispatchApi(api.search.user.post({ query, rows: 1000 }), {
             throwError: false,
@@ -21,30 +17,14 @@ const UserListProvider = ({ children }) => {
             ...newUsers
         }));
     }, [dispatchApi]);
-    const fetchUsers = useCallback((ids) => {
-        const nextIds = new Set(ids);
-        nextIds.delete('Unknown');
-        nextIds.forEach(id => pendingIds.current.add(id));
-        if (debounceTimer.current) {
-            clearTimeout(debounceTimer.current);
+    const fetchUsers = useCallback(async (ids) => {
+        ids.delete('Unknown');
+        const idsToGet = Array.from(ids.values()).filter(id => !Object.keys(users).includes(id));
+        if (idsToGet.length <= 0) {
+            return;
         }
-        debounceTimer.current = setTimeout(async () => {
-            const idsToGet = Array.from(pendingIds.current).filter(id => !Object.keys(usersRef.current).includes(id));
-            pendingIds.current = new Set();
-            debounceTimer.current = null;
-            if (idsToGet.length <= 0) {
-                return;
-            }
-            await searchUsers(`id:${idsToGet.join(' OR ')}`);
-        }, 200);
-    }, [searchUsers]);
-    useEffect(() => {
-        return () => {
-            if (debounceTimer.current) {
-                clearTimeout(debounceTimer.current);
-            }
-        };
-    }, []);
+        await searchUsers(`id:${[...idsToGet].join(' OR ')}`);
+    }, [searchUsers, users]);
     return _jsx(UserListContext.Provider, { value: { users, fetchUsers, searchUsers }, children: children });
 };
 export default UserListProvider;

package/components/elements/PluginTypography.d.ts

@@ -1,11 +1,10 @@
 import { type TypographyProps } from '@mui/material';
 import type { Hit } from '@cccsaurora/howler-ui/models/entities/generated/Hit';
-import type { Observable } from '@cccsaurora/howler-ui/models/entities/generated/Observable';
 export type PluginTypographyProps = TypographyProps & {
     value: string;
     context: string;
     field?: string;
-    obj?: Hit | Observable;
+    hit?: Hit;
 };
 declare const _default: import("react").NamedExoticComponent<PluginTypographyProps>;
 export default _default;

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.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,45 @@
+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) {