@digitaldefiance/express-suite-react-components 5.0.2 → 5.0.3

package/src/hooks/useEmailVerification.d.ts

@@ -0,0 +1,10 @@
+export interface UseEmailVerificationResult {
+    isVerifying: boolean;
+    error: Error | null;
+    verifyEmail: (token: string) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+}
+export declare const useEmailVerification: () => UseEmailVerificationResult;
+//# sourceMappingURL=useEmailVerification.d.ts.map

package/src/hooks/useEmailVerification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEmailVerification.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/useEmailVerification.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,CACX,KAAK,EAAE,MAAM,KACV,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,eAAO,MAAM,oBAAoB,QAAO,0BAqCvC,CAAC"}

package/src/hooks/useEmailVerification.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEmailVerification = void 0;
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const react_1 = require("react");
+const contexts_1 = require("../contexts");
+const services_1 = require("../services");
+const useEmailVerification = () => {
+    const { baseUrl } = (0, contexts_1.useSuiteConfig)();
+    const api = (0, react_1.useMemo)(() => (0, services_1.createAuthenticatedApiClient)(baseUrl), [baseUrl]);
+    const [isVerifying, setIsVerifying] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const verifyEmail = (0, react_1.useCallback)(async (verificationToken) => {
+        setIsVerifying(true);
+        setError(null);
+        try {
+            const result = await api.post('/user/verify-email', {
+                token: verificationToken,
+            });
+            return { success: true, message: result.data.message };
+        }
+        catch (err) {
+            const axiosError = err;
+            const errorMessage = axiosError.response?.data?.message ||
+                (0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Error_VerificationFailed);
+            const error = new Error(errorMessage);
+            setError(error);
+            return { success: false, message: errorMessage };
+        }
+        finally {
+            setIsVerifying(false);
+        }
+    }, [api]);
+    return {
+        isVerifying,
+        error,
+        verifyEmail,
+    };
+};
+exports.useEmailVerification = useEmailVerification;

package/src/hooks/useExpiringValue.d.ts

@@ -0,0 +1,14 @@
+export interface TimerInfo {
+    timeout: NodeJS.Timeout;
+    startTime: number;
+    durationMs: number;
+}
+export interface ExpiringValueReturn<T> {
+    value: T | undefined;
+    setValue: (newValue: T, durationSeconds?: number, saveToStorage?: boolean) => () => void;
+    clearValue: () => void;
+    getRemainingTime: () => number;
+    isActive: boolean;
+}
+export declare function useExpiringValue<T>(defaultDurationSeconds: number, localStorageKey?: string): ExpiringValueReturn<T>;
+//# sourceMappingURL=useExpiringValue.d.ts.map

package/src/hooks/useExpiringValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExpiringValue.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/useExpiringValue.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;IACzF,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,gBAAgB,EAAE,MAAM,MAAM,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,sBAAsB,EAAE,MAAM,EAC9B,eAAe,CAAC,EAAE,MAAM,GACvB,mBAAmB,CAAC,CAAC,CAAC,CA0DxB"}

package/src/hooks/useExpiringValue.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useExpiringValue = useExpiringValue;
+const react_1 = require("react");
+function useExpiringValue(defaultDurationSeconds, localStorageKey) {
+    const [value, _setValue] = (0, react_1.useState)(undefined);
+    const [timer, setTimer] = (0, react_1.useState)(undefined);
+    const [durationSeconds, _setDurationSeconds] = (0, react_1.useState)(() => {
+        if (localStorageKey) {
+            const stored = localStorage.getItem(localStorageKey);
+            return stored ? parseInt(stored, 10) : defaultDurationSeconds;
+        }
+        return defaultDurationSeconds;
+    });
+    const getRemainingTime = (0, react_1.useCallback)(() => {
+        if (!timer)
+            return 0;
+        const elapsed = Date.now() - timer.startTime;
+        const remaining = Math.max(0, timer.durationMs - elapsed);
+        return Math.ceil(remaining / 1000);
+    }, [timer]);
+    const setValue = (0, react_1.useCallback)((newValue, customDurationSeconds, saveToStorage) => {
+        const finalDurationSeconds = customDurationSeconds ?? durationSeconds;
+        if (saveToStorage && customDurationSeconds !== undefined && localStorageKey) {
+            _setDurationSeconds(customDurationSeconds);
+            localStorage.setItem(localStorageKey, customDurationSeconds.toString());
+        }
+        _setValue(newValue);
+        if (timer) {
+            clearTimeout(timer.timeout);
+        }
+        const startTime = Date.now();
+        const durationMs = finalDurationSeconds * 1000;
+        const timeout = setTimeout(() => {
+            _setValue(undefined);
+            setTimer(undefined);
+        }, durationMs);
+        setTimer({ timeout, startTime, durationMs });
+        return () => {
+            clearTimeout(timeout);
+            setTimer(undefined);
+        };
+    }, [durationSeconds, timer, localStorageKey]);
+    const clearValue = (0, react_1.useCallback)(() => {
+        if (timer) {
+            clearTimeout(timer.timeout);
+            setTimer(undefined);
+        }
+        _setValue(undefined);
+    }, [timer]);
+    const isActive = Boolean(timer && value !== undefined);
+    return { value, setValue, clearValue, getRemainingTime, isActive };
+}

package/src/hooks/useLocalStorage.d.ts

@@ -0,0 +1,2 @@
+export declare function useLocalStorage<T>(key: string, defaultValue: T): [T, (value: T) => void];
+//# sourceMappingURL=useLocalStorage.d.ts.map

package/src/hooks/useLocalStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/useLocalStorage.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,GACd,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAWzB"}

package/src/hooks/useLocalStorage.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLocalStorage = useLocalStorage;
+const react_1 = require("react");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+function useLocalStorage(key, defaultValue) {
+    const [storedValue, setStoredValue] = (0, react_1.useState)(() => {
+        return suite_core_lib_1.LocalStorageManager.getValue(key, defaultValue);
+    });
+    const setValue = (0, react_1.useCallback)((value) => {
+        setStoredValue(value);
+        suite_core_lib_1.LocalStorageManager.setValue(key, value);
+    }, [key]);
+    return [storedValue, setValue];
+}

package/src/hooks/useUserSettings.d.ts

@@ -0,0 +1,48 @@
+import { IUserSettings, IUserSettingsDTO } from '@digitaldefiance/suite-core-lib';
+export interface UseUserSettingsOptions {
+    authenticatedApi: {
+        post: <T = unknown>(url: string, data: Record<string, unknown>) => Promise<{
+            data: T;
+        }>;
+    };
+    isAuthenticated: boolean;
+}
+export interface UseUserSettingsResult {
+    currentLanguage: string;
+    changeLanguage: (languageCode: string) => Promise<void>;
+    userSettings: IUserSettings | undefined;
+    setUserSettingAndUpdateSettings: (setting?: Partial<IUserSettings>) => Promise<void>;
+    toggleColorMode: () => Promise<void>;
+}
+/**
+ * Hook for managing user settings state and synchronization.
+ * Used by AuthProvider to handle user settings logic.
+ */
+export declare const useUserSettings: ({ authenticatedApi, isAuthenticated, }: UseUserSettingsOptions) => UseUserSettingsResult;
+export interface UserSettingsValues extends IUserSettingsDTO {
+    [key: string]: string | boolean | undefined;
+}
+export interface UseUserSettingsPublicResult {
+    settings: UserSettingsValues | null;
+    isLoading: boolean;
+    error: Error | null;
+    updateSettings: (values: UserSettingsValues) => Promise<{
+        success: boolean;
+        message: string;
+    } | {
+        error: string;
+        errorType?: string;
+        field?: string;
+        errors?: Array<{
+            path: string;
+            msg: string;
+        }>;
+    }>;
+    refreshSettings: () => Promise<void>;
+}
+/**
+ * Public hook for components to manage user settings.
+ * Provides a simpler API for fetching and updating settings.
+ */
+export declare const useUserSettingsPublic: () => UseUserSettingsPublicResult;
+//# sourceMappingURL=useUserSettings.d.ts.map

package/src/hooks/useUserSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserSettings.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/hooks/useUserSettings.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,aAAa,EACb,gBAAgB,EAGjB,MAAM,iCAAiC,CAAC;AAYzC,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,GAAG,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC;YAAE,IAAI,EAAE,CAAC,CAAA;SAAE,CAAC,CAAC;KAC3B,CAAC;IACF,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,YAAY,EAAE,aAAa,GAAG,SAAS,CAAC;IACxC,+BAA+B,EAAE,CAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,KAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,wCAG7B,sBAAsB,KAAG,qBAsF3B,CAAC;AAGF,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CACnD;QACE,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,GACD;QACE,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/C,CACJ,CAAC;IACF,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,2BAoGxC,CAAC"}

package/src/hooks/useUserSettings.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useUserSettingsPublic = exports.useUserSettings = void 0;
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+const i18n_lib_1 = require("@digitaldefiance/i18n-lib");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const react_1 = require("react");
+const contexts_1 = require("../contexts");
+const defaultUserSettings = {
+    darkMode: false,
+    currency: new i18n_lib_1.CurrencyCode(i18n_lib_1.DefaultCurrencyCode),
+    timezone: new i18n_lib_1.Timezone(i18n_lib_1.DefaultTimezone),
+    siteLanguage: i18n_lib_1.DefaultLanguageCode,
+    directChallenge: false,
+};
+/**
+ * Hook for managing user settings state and synchronization.
+ * Used by AuthProvider to handle user settings logic.
+ */
+const useUserSettings = ({ authenticatedApi, isAuthenticated, }) => {
+    const { setColorMode: themeSetPaletteMode, mode: currentThemeMode } = (0, contexts_1.useTheme)();
+    const { currentLanguage, changeLanguage } = (0, contexts_1.useI18n)();
+    const [userSettings, setUserSettings] = (0, react_1.useState)(undefined);
+    const setUserSettingAndUpdateSettings = (0, react_1.useCallback)(async (setting) => {
+        if (setting) {
+            // Merge settings with defaults and existing settings
+            const merged = {
+                ...defaultUserSettings,
+                ...(userSettings ? userSettings : {}),
+                ...setting,
+            };
+            // TypeScript requires all IUserSettings fields, but during initialization
+            // some fields like email may not be set yet. We'll use Partial until
+            // all required fields are available.
+            setUserSettings(merged);
+            if (setting.darkMode !== undefined) {
+                themeSetPaletteMode(setting.darkMode ? 'dark' : 'light');
+            }
+            if (setting.siteLanguage !== undefined &&
+                setting.siteLanguage !== currentLanguage) {
+                await changeLanguage(setting.siteLanguage);
+            }
+            // Send to server if authenticated and we have complete settings (including email)
+            if (isAuthenticated && merged.email) {
+                const dehydratedSettings = (0, suite_core_lib_1.dehydrateUserSettings)(merged);
+                await authenticatedApi.post('/user/settings', dehydratedSettings);
+            }
+        }
+        else {
+            setUserSettings(undefined);
+            themeSetPaletteMode('light');
+        }
+    }, [
+        isAuthenticated,
+        userSettings,
+        currentLanguage,
+        changeLanguage,
+        themeSetPaletteMode,
+        authenticatedApi,
+    ]);
+    const changeLanguageSetting = (0, react_1.useCallback)(async (languageCode) => {
+        await setUserSettingAndUpdateSettings({ siteLanguage: languageCode });
+    }, [setUserSettingAndUpdateSettings]);
+    const toggleColorMode = (0, react_1.useCallback)(async () => {
+        // When not authenticated, read from the current theme mode
+        // When authenticated, read from userSettings (synced with server)
+        const currentDarkMode = isAuthenticated
+            ? userSettings?.darkMode ?? false
+            : currentThemeMode === 'dark';
+        await setUserSettingAndUpdateSettings({ darkMode: !currentDarkMode });
+    }, [
+        isAuthenticated,
+        userSettings?.darkMode,
+        currentThemeMode,
+        setUserSettingAndUpdateSettings,
+    ]);
+    return {
+        changeLanguage: changeLanguageSetting,
+        currentLanguage,
+        userSettings,
+        setUserSettingAndUpdateSettings,
+        toggleColorMode,
+    };
+};
+exports.useUserSettings = useUserSettings;
+/**
+ * Public hook for components to manage user settings.
+ * Provides a simpler API for fetching and updating settings.
+ */
+const useUserSettingsPublic = () => {
+    const { userData, setUserSetting, userSettings } = (0, contexts_1.useAuth)();
+    const [settings, setSettings] = (0, react_1.useState)(null);
+    const [isLoading, setIsLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    const refreshSettings = (0, react_1.useCallback)(async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            if (userSettings) {
+                const dehydratedSettings = (0, suite_core_lib_1.dehydrateUserSettings)(userSettings);
+                setSettings(dehydratedSettings);
+            }
+            else if (userData) {
+                const fallback = {
+                    email: userData.email || '',
+                    timezone: userData.timezone || 'UTC',
+                    siteLanguage: userData.siteLanguage || 'en-US',
+                    currency: userData.currency || 'USD',
+                    darkMode: userData.darkMode || false,
+                    directChallenge: userData.directChallenge || false,
+                    ...(userData.displayName !== undefined ? { displayName: userData.displayName } : {}),
+                };
+                setSettings(fallback);
+            }
+        }
+        catch (err) {
+            setError(err instanceof Error
+                ? err
+                : new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Settings_RetrieveFailure));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [userSettings, userData]);
+    (0, react_1.useEffect)(() => {
+        refreshSettings();
+    }, [refreshSettings]);
+    const updateSettings = (0, react_1.useCallback)(async (values) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            await setUserSetting({
+                darkMode: values.darkMode,
+                currency: new i18n_lib_1.CurrencyCode(values.currency),
+                timezone: new i18n_lib_1.Timezone(values.timezone),
+                siteLanguage: values.siteLanguage,
+                email: new ecies_lib_1.EmailString(values.email),
+                directChallenge: values.directChallenge,
+                ...(values.displayName !== undefined ? { displayName: values.displayName } : {}),
+            });
+            setSettings(values);
+            return {
+                success: true,
+                message: (0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Settings_SaveSuccess),
+            };
+        }
+        catch (err) {
+            const axiosError = err;
+            const errorMessage = axiosError.response?.data?.message ||
+                (0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Settings_UpdateFailed);
+            setError(err instanceof Error ? err : new Error(errorMessage));
+            return {
+                error: errorMessage,
+                errorType: axiosError.response?.data?.errorType,
+                field: axiosError.response?.data?.field,
+                errors: axiosError.response?.data?.errors,
+            };
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [setUserSetting]);
+    return {
+        settings,
+        isLoading,
+        error,
+        updateSettings,
+        refreshSettings,
+    };
+};
+exports.useUserSettingsPublic = useUserSettingsPublic;

package/src/{index.ts → index.d.ts}

@@ -1,4 +1,3 @@
-// Export all components
 export * from './auth';
 export * from './components';
 export * from './contexts';
@@ -7,3 +6,4 @@ export * from './interfaces';
 export * from './services';
 export * from './types';
 export * from './wrappers';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-express-suite-react-components/src/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC"}

package/src/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// Export all components
+tslib_1.__exportStar(require("./auth"), exports);
+tslib_1.__exportStar(require("./components"), exports);
+tslib_1.__exportStar(require("./contexts"), exports);
+tslib_1.__exportStar(require("./hooks"), exports);
+tslib_1.__exportStar(require("./interfaces"), exports);
+tslib_1.__exportStar(require("./services"), exports);
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./wrappers"), exports);

package/src/interfaces/IAppConfig.d.ts

@@ -0,0 +1,8 @@
+export interface IAppConfig {
+    hostname: string;
+    siteTitle: string;
+    server: string;
+    /** Whether TOTP two-factor authentication is available on this deployment. */
+    totpAvailable?: boolean;
+}
+//# sourceMappingURL=IAppConfig.d.ts.map

package/src/interfaces/IAppConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAppConfig.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/interfaces/IAppConfig.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/src/interfaces/IAppConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/interfaces/ICategoryConfig.d.ts

@@ -0,0 +1,41 @@
+import { ReactElement, ReactNode } from 'react';
+/**
+ * Configuration for a TopMenu category (mega-menu container).
+ *
+ * Categories let you group multiple icon dropdowns under a single AppBar
+ * button. Menus opt into a category by setting `IMenuConfig.category` (or
+ * `AdditionalDropdownMenu.category`) to this category's `id`. The TopMenu
+ * renders one icon button per category that has at least one matching menu;
+ * clicking it opens a popover containing the matching menus as icon tiles.
+ *
+ * Backwards compatibility: if `TopMenu` is not given a `categories` array,
+ * or if a menu does not declare a `category`, it renders inline in the AppBar
+ * exactly as before.
+ */
+export interface ICategoryConfig {
+    /** Unique identifier referenced by `IMenuConfig.category`. */
+    id: string;
+    /** Icon shown on the AppBar trigger button. */
+    icon: ReactElement;
+    /**
+     * Optional accessible label / tooltip / panel header. Plain string for
+     * tooltip; render-prop or node for the panel header if `showHeader` is true.
+     */
+    label?: string;
+    /** Optional header content shown above the tile grid when `showHeader` is true. */
+    header?: ReactNode;
+    /** Show the `header` (or `label`) above the tile grid. Defaults to false. */
+    showHeader?: boolean;
+    /** Show the menu label under each tile inside the popover. Defaults to true. */
+    showLabels?: boolean;
+    /**
+     * Sort order for placement in the AppBar. Higher numbers render first
+     * (same convention as `IMenuConfig.priority`). Defaults to 0.
+     */
+    priority?: number;
+    /** Number of tile columns in the popover grid. Defaults to 3. */
+    columns?: number;
+    /** Hide the category trigger when it has no matching menus. Defaults to true. */
+    hideWhenEmpty?: boolean;
+}
+//# sourceMappingURL=ICategoryConfig.d.ts.map

package/src/interfaces/ICategoryConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICategoryConfig.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/interfaces/ICategoryConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,IAAI,EAAE,YAAY,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/src/interfaces/ICategoryConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/interfaces/IMenuConfig.d.ts

@@ -0,0 +1,28 @@
+import { ReactElement } from 'react';
+import { IMenuOption } from './IMenuOption';
+import { createMenuType } from '../types';
+export interface IMenuConfig {
+    menuType: ReturnType<typeof createMenuType>;
+    menuIcon: ReactElement;
+    priority?: number;
+    options: IMenuOption[];
+    isUserMenu?: boolean;
+    /** Optional callback invoked when the icon button is clicked. */
+    action?: () => void;
+    /** When true, the menu icon is hidden if there are no sub-options. Defaults to false. */
+    hideWhenEmpty?: boolean;
+    /**
+     * Optional category identifier. When the TopMenu is configured with matching
+     * `categories`, this menu is rendered as a tile inside that category's
+     * mega-menu popover instead of inline in the AppBar. When omitted (or no
+     * matching category exists), the menu renders inline as a normal dropdown.
+     */
+    category?: string;
+    /**
+     * Optional human-readable label. When the menu is rendered as a tile inside
+     * a category popover with `showLabels` enabled, this is shown under the icon.
+     * Also used as the IconButton tooltip. Falls back to `menuType` when omitted.
+     */
+    label?: string;
+}
+//# sourceMappingURL=IMenuConfig.d.ts.map

package/src/interfaces/IMenuConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMenuConfig.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/interfaces/IMenuConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC5C,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,yFAAyF;IACzF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/src/interfaces/IMenuConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/interfaces/IMenuOption.d.ts

@@ -0,0 +1,82 @@
+import { ReactNode } from 'react';
+import { To } from 'react-router';
+import { MenuType } from '../types/MenuType';
+import { SxProps } from '@mui/system';
+import { Theme } from '@mui/material';
+export interface IMenuOption {
+    /**
+     * Unique identifier for the menu option
+     */
+    id: string;
+    /**
+     * Text to display for the menu option
+     */
+    label: string | ReactNode | Array<ReactNode>;
+    /**
+     * Where the menu option should be displayed
+     */
+    includeOnMenus: MenuType[];
+    /**
+     * Display order for the menu option. Lower numbers are displayed first.
+     */
+    index: number;
+    /**
+     * Whether the menu option is a divider
+     */
+    divider?: boolean;
+    /**
+     * Icon to display for the menu option
+     */
+    icon?: ReactNode;
+    /**
+     * Link to navigate to when the menu option is clicked
+     * Mutually exclusive with `action`
+     * Can be a string, a react-router To object, or an object with pathname and optional state
+     */
+    link?: To | {
+        pathname: string;
+        state?: unknown;
+    };
+    /**
+     * Function to execute when the menu option is clicked
+     * Mutually exclusive with `link`
+     * @returns void
+     */
+    action?: () => void;
+    /**
+     * Whether the menu option requires authentication
+     * true = requires authentication
+     * false = requires unauthenticated
+     * undefined = always show
+     */
+    requiresAuth: boolean | undefined;
+    /**
+     * Whether the menu option requires the user to be a global admin
+     * true = only show to global admins
+     * undefined/false = no admin requirement
+     */
+    requiresAdmin?: boolean;
+    /**
+     * Custom filter function to determine if the menu option should be displayed
+     * @param option - The menu option to filter
+     * @returns boolean
+     */
+    filter?: (option: IMenuOption) => boolean;
+    /**
+     * Additional CSS properties
+     */
+    additionalSx?: SxProps<Theme>;
+    /**
+     * Additional CSS properties for the side menu variant
+     */
+    sideSx?: SxProps<Theme>;
+    /**
+     * Additional CSS properties for the side menu variant Icon sub item
+     */
+    sideIconSx?: SxProps<Theme>;
+    /**
+     * Additional CSS properties for the side menu variant Text sub item
+     */
+    sideTextSx?: SxProps<Theme>;
+}
+//# sourceMappingURL=IMenuOption.d.ts.map

package/src/interfaces/IMenuOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMenuOption.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/interfaces/IMenuOption.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7C;;OAEG;IACH,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAClD;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;OAKG;IACH,YAAY,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC;IAC1C;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CAC7B"}

package/src/interfaces/IMenuOption.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/interfaces/{index.ts → index.d.ts}

@@ -2,3 +2,4 @@ export * from './IAppConfig';
 export * from './IMenuOption';
 export * from './IMenuConfig';
 export * from './ICategoryConfig';
+//# sourceMappingURL=index.d.ts.map

package/src/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-express-suite-react-components/src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}

package/src/interfaces/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./IAppConfig"), exports);
+tslib_1.__exportStar(require("./IMenuOption"), exports);
+tslib_1.__exportStar(require("./IMenuConfig"), exports);
+tslib_1.__exportStar(require("./ICategoryConfig"), exports);

package/src/services/__mocks__/authService.d.ts

@@ -0,0 +1,21 @@
+export declare const mockAuthService: {
+    verifyToken: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    directLogin: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    emailChallengeLogin: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    refreshToken: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    register: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    requestEmailLogin: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    backupCodeLogin: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    changePassword: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+};
+export declare const createAuthService: import("jest-mock").Mock<() => {
+    verifyToken: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    directLogin: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    emailChallengeLogin: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    refreshToken: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    register: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    requestEmailLogin: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    backupCodeLogin: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+    changePassword: import("jest-mock").Mock<import("jest-mock").UnknownFunction>;
+}>;
+//# sourceMappingURL=authService.d.ts.map

package/src/services/__mocks__/authService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authService.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-express-suite-react-components/src/services/__mocks__/authService.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe;;;;;;;;;CAS3B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;EAAiC,CAAC"}