@hitachivantara/app-shell-ui 2.3.2 → 2.3.3

package/dist/hooks/useLocalStorage.js

@@ -1,28 +1,28 @@
-import { useState, useEffect } from "react";
-const LOCAL_STORAGE_KEYS = {
-  COLOR_MODE: "hv/user-preferences/color-mode",
-  NAV_EXPANDED: "hv/app-shell/expanded"
+import { useEffect, useState } from "react";
+//#region src/hooks/useLocalStorage.ts
+var LOCAL_STORAGE_KEYS = {
+	COLOR_MODE: "hv/user-preferences/color-mode",
+	NAV_EXPANDED: "hv/app-shell/expanded"
 };
-const useLocalStorage = (storageKey) => {
-  const key = LOCAL_STORAGE_KEYS[storageKey] || storageKey;
-  const [value, setValue] = useState(() => localStorage.getItem(key));
-  const setStoredValue = (newValue) => {
-    localStorage.setItem(key, newValue);
-  };
-  useEffect(() => {
-    const handleStorageChange = (event) => {
-      if (event.key === key) {
-        setValue(event.newValue);
-      }
-    };
-    window.addEventListener("storage", handleStorageChange);
-    return () => {
-      window.removeEventListener("storage", handleStorageChange);
-    };
-  }, [key]);
-  return { value, setStoredValue };
-};
-export {
-  LOCAL_STORAGE_KEYS,
-  useLocalStorage as default
+var useLocalStorage = (storageKey) => {
+	const key = LOCAL_STORAGE_KEYS[storageKey] || storageKey;
+	const [value, setValue] = useState(() => localStorage.getItem(key));
+	const setStoredValue = (newValue) => {
+		localStorage.setItem(key, newValue);
+	};
+	useEffect(() => {
+		const handleStorageChange = (event) => {
+			if (event.key === key) setValue(event.newValue);
+		};
+		window.addEventListener("storage", handleStorageChange);
+		return () => {
+			window.removeEventListener("storage", handleStorageChange);
+		};
+	}, [key]);
+	return {
+		value,
+		setStoredValue
+	};
 };
+//#endregion
+export { useLocalStorage as default };

package/dist/hooks/useModelFromConfig.js

@@ -1,42 +1,46 @@
-import { useMemo, useCallback } from "react";
-import { useAsync } from "@hitachivantara/app-shell-shared";
 import { importAllBundles } from "../utils/lazyImport.js";
 import processConfig from "../utils/processConfig.js";
-const useModelFromConfig = (config) => {
-  const initialModel = useMemo(
-    () => config ? processConfig(config) : void 0,
-    [config]
-  );
-  const systemProvidersBundles = useMemo(
-    () => (initialModel?.systemProviders ?? []).map((p) => p.bundle),
-    [initialModel]
-  );
-  const conditionBundles = useMemo(
-    () => (initialModel?.allConditions ?? []).map((c) => c.bundle),
-    [initialModel]
-  );
-  const providerBundles = useMemo(
-    () => (initialModel?.providers ?? []).map((p) => p.bundle),
-    [initialModel]
-  );
-  const bundles = useMemo(
-    () => [...systemProvidersBundles, ...conditionBundles, ...providerBundles],
-    [systemProvidersBundles, conditionBundles, providerBundles]
-  );
-  const promiseFactory = useCallback(async () => {
-    if (!initialModel) {
-      return;
-    }
-    if (bundles.length === 0) {
-      return {
-        ...initialModel
-      };
-    }
-    const preloadedBundles = await importAllBundles(bundles);
-    return { ...initialModel, preloadedBundles };
-  }, [initialModel, bundles]);
-  return useAsync(promiseFactory, { dataProp: "model" });
-};
-export {
-  useModelFromConfig
+import { useCallback, useMemo } from "react";
+import { useAsync } from "@hitachivantara/app-shell-shared";
+//#region src/hooks/useModelFromConfig.ts
+/**
+* Build an App Shell model from a configuration and preload referenced bundles.
+*
+* @param config - The App Shell configuration object.
+* @returns An object containing the loading state, any error encountered, and
+*          the constructed `HvAppShellModel` with preloaded bundles.
+*
+* @remarks
+* - Synchronously processes the provided `config` (adds internal keys and
+*   global indices to condition definitions) to produce a base `HvAppShellModel`.
+* - Extracts bundle paths from all conditions and providers, concatenates them
+*   and preloads those bundles using `importAllBundles`.
+* - Returns an AsyncResult-shaped value so callers can read `isPending`,
+*   `error` and the `model` property (the data property is named `model`).
+*/
+var useModelFromConfig = (config) => {
+	const initialModel = useMemo(() => config ? processConfig(config) : void 0, [config]);
+	const systemProvidersBundles = useMemo(() => (initialModel?.systemProviders ?? []).map((p) => p.bundle), [initialModel]);
+	const conditionBundles = useMemo(() => (initialModel?.allConditions ?? []).map((c) => c.bundle), [initialModel]);
+	const providerBundles = useMemo(() => (initialModel?.providers ?? []).map((p) => p.bundle), [initialModel]);
+	const bundles = useMemo(() => [
+		...systemProvidersBundles,
+		...conditionBundles,
+		...providerBundles
+	], [
+		systemProvidersBundles,
+		conditionBundles,
+		providerBundles
+	]);
+	return useAsync(useCallback(async () => {
+		if (!initialModel) return;
+		if (bundles.length === 0) return { ...initialModel };
+		const preloadedBundles = await importAllBundles(bundles);
+		return {
+			...initialModel,
+			preloadedBundles
+		};
+	}, [initialModel, bundles]), { dataProp: "model" });
 };
+//#endregion
+export { useModelFromConfig };

package/dist/hooks/useNavigationMenuItems.js

@@ -1,35 +1,32 @@
+import { createNavigationMenuItems } from "../utils/navigationUtil.js";
 import { useEffect } from "react";
 import { useTranslation } from "react-i18next";
+import { CONFIG_TRANSLATIONS_NAMESPACE, useHvAppShellModel, useHvAppShellRuntimeContext, useHvMenuItems } from "@hitachivantara/app-shell-shared";
 import { useLocation } from "react-router-dom";
 import { useHvNavigation } from "@hitachivantara/app-shell-navigation";
-import { useHvAppShellModel, useHvAppShellRuntimeContext, CONFIG_TRANSLATIONS_NAMESPACE, useHvMenuItems } from "@hitachivantara/app-shell-shared";
-import { createNavigationMenuItems } from "../utils/navigationUtil.js";
-const MAX_TOP_MENU_DEPTH = 2;
-const useNavigationMenuItems = () => {
-  const { pathname } = useLocation();
-  const { navigationMode } = useHvAppShellModel();
-  const { navigate } = useHvNavigation();
-  const { i18n } = useHvAppShellRuntimeContext();
-  const { t: tConfig } = useTranslation(CONFIG_TRANSLATIONS_NAMESPACE, {
-    i18n
-  });
-  const { items, selectedMenuItemId, rootMenuItemId } = useHvMenuItems();
-  const navigationMenuItemsTmp = createNavigationMenuItems(
-    tConfig,
-    items,
-    navigationMode === "ONLY_TOP" ? MAX_TOP_MENU_DEPTH : void 0
-  );
-  useEffect(() => {
-    if (!selectedMenuItemId && pathname === "/" && items[0]?.href) {
-      navigate(items[0].href);
-    }
-  }, [pathname, items, navigate, selectedMenuItemId]);
-  return {
-    items: navigationMenuItemsTmp,
-    selectedMenuItemId,
-    rootMenuItemId
-  };
-};
-export {
-  useNavigationMenuItems as default
+//#region src/hooks/useNavigationMenuItems.tsx
+var MAX_TOP_MENU_DEPTH = 2;
+var useNavigationMenuItems = () => {
+	const { pathname } = useLocation();
+	const { navigationMode } = useHvAppShellModel();
+	const { navigate } = useHvNavigation();
+	const { i18n } = useHvAppShellRuntimeContext();
+	const { t: tConfig } = useTranslation(CONFIG_TRANSLATIONS_NAMESPACE, { i18n });
+	const { items, selectedMenuItemId, rootMenuItemId } = useHvMenuItems();
+	const navigationMenuItemsTmp = createNavigationMenuItems(tConfig, items, navigationMode === "ONLY_TOP" ? MAX_TOP_MENU_DEPTH : void 0);
+	useEffect(() => {
+		if (!selectedMenuItemId && pathname === "/" && items[0]?.href) navigate(items[0].href);
+	}, [
+		pathname,
+		items,
+		navigate,
+		selectedMenuItemId
+	]);
+	return {
+		items: navigationMenuItemsTmp,
+		selectedMenuItemId,
+		rootMenuItemId
+	};
 };
+//#endregion
+export { useNavigationMenuItems as default };

package/dist/hooks/useNotificationsEventListener.js

@@ -1,44 +1,37 @@
-import { useHvSnackbar } from "@hitachivantara/uikit-react-core";
 import { useBannerContext } from "../providers/BannerProvider.js";
-const useNotificationsEventListener = () => {
-  const { enqueueSnackbar } = useHvSnackbar();
-  const { show } = useBannerContext();
-  const handleCustomEventSnackbar = (notification) => {
-    const { message, variant, actions, onAction } = notification;
-    let snackbarContentProps;
-    if (actions) {
-      snackbarContentProps = {
-        action: Array.isArray(actions) ? actions[0] : actions,
-        onAction
-      };
-    }
-    if (message) {
-      enqueueSnackbar(message, {
-        variant: variant ?? "default",
-        snackbarContentProps
-      });
-    }
-  };
-  const handleCustomEventBanner = (notification) => {
-    if (notification.message) {
-      show(notification);
-    }
-  };
-  const handleNotificationEvent = (event) => {
-    const notificationEvent = event.detail;
-    switch (notificationEvent.type) {
-      case "snackbar":
-        handleCustomEventSnackbar(notificationEvent);
-        break;
-      case "banner":
-        handleCustomEventBanner(notificationEvent);
-        break;
-      default:
-        console.warn("Invalid notification type", notificationEvent.type);
-    }
-  };
-  return { handleNotificationEvent };
-};
-export {
-  useNotificationsEventListener as default
+import { useHvSnackbar } from "@hitachivantara/uikit-react-core";
+//#region src/hooks/useNotificationsEventListener.ts
+var useNotificationsEventListener = () => {
+	const { enqueueSnackbar } = useHvSnackbar();
+	const { show } = useBannerContext();
+	const handleCustomEventSnackbar = (notification) => {
+		const { message, variant, actions, onAction } = notification;
+		let snackbarContentProps;
+		if (actions) snackbarContentProps = {
+			action: Array.isArray(actions) ? actions[0] : actions,
+			onAction
+		};
+		if (message) enqueueSnackbar(message, {
+			variant: variant ?? "default",
+			snackbarContentProps
+		});
+	};
+	const handleCustomEventBanner = (notification) => {
+		if (notification.message) show(notification);
+	};
+	const handleNotificationEvent = (event) => {
+		const notificationEvent = event.detail;
+		switch (notificationEvent.type) {
+			case "snackbar":
+				handleCustomEventSnackbar(notificationEvent);
+				break;
+			case "banner":
+				handleCustomEventBanner(notificationEvent);
+				break;
+			default: console.warn("Invalid notification type", notificationEvent.type);
+		}
+	};
+	return { handleNotificationEvent };
 };
+//#endregion
+export { useNotificationsEventListener as default };

package/dist/hooks/useResizeObserver.js

@@ -1,16 +1,16 @@
 import { useEffect } from "react";
+//#region src/hooks/useResizeObserver.ts
 function useResizeObserver(ref, onResize) {
-  useEffect(() => {
-    if (!ref.current) return void 0;
-    const observer = new ResizeObserver(([entry]) => {
-      onResize(entry.contentRect.width, entry.contentRect.height);
-    });
-    observer.observe(ref.current);
-    return () => {
-      observer.disconnect();
-    };
-  }, [onResize, ref]);
+	useEffect(() => {
+		if (!ref.current) return void 0;
+		const observer = new ResizeObserver(([entry]) => {
+			onResize(entry.contentRect.width, entry.contentRect.height);
+		});
+		observer.observe(ref.current);
+		return () => {
+			observer.disconnect();
+		};
+	}, [onResize, ref]);
 }
-export {
-  useResizeObserver
-};
+//#endregion
+export { useResizeObserver };

package/dist/hooks/useThemeEventListener.js

@@ -1,20 +1,19 @@
-import { useTheme } from "@hitachivantara/uikit-react-core";
 import useLocalStorage from "./useLocalStorage.js";
-const useThemeEventListener = () => {
-  const { selectedMode, colorModes, changeMode } = useTheme();
-  const { setStoredValue } = useLocalStorage("COLOR_MODE");
-  const getNextColorMode = () => {
-    const nextIndex = colorModes.indexOf(selectedMode) + 1;
-    return colorModes[nextIndex % colorModes.length];
-  };
-  const handleThemeEvent = (event) => {
-    const { colorMode } = event.detail;
-    const newColorMode = !colorMode || colorModes.indexOf(colorMode) === -1 ? getNextColorMode() : colorMode;
-    changeMode(newColorMode);
-    setStoredValue(newColorMode);
-  };
-  return { handleThemeEvent };
-};
-export {
-  useThemeEventListener as default
+import { useTheme } from "@hitachivantara/uikit-react-core";
+//#region src/hooks/useThemeEventListener.ts
+var useThemeEventListener = () => {
+	const { selectedMode, colorModes, changeMode } = useTheme();
+	const { setStoredValue } = useLocalStorage("COLOR_MODE");
+	const getNextColorMode = () => {
+		return colorModes[(colorModes.indexOf(selectedMode) + 1) % colorModes.length];
+	};
+	const handleThemeEvent = (event) => {
+		const { colorMode } = event.detail;
+		const newColorMode = !colorMode || colorModes.indexOf(colorMode) === -1 ? getNextColorMode() : colorMode;
+		changeMode(newColorMode);
+		setStoredValue(newColorMode);
+	};
+	return { handleThemeEvent };
 };
+//#endregion
+export { useThemeEventListener as default };

package/dist/i18n/constants.js

@@ -1,6 +1,5 @@
-import { CONFIG_TRANSLATIONS_NAMESPACE } from "@hitachivantara/app-shell-shared";
-const APP_SHELL_NAMESPACE = "appShell";
-export {
-  APP_SHELL_NAMESPACE,
-  CONFIG_TRANSLATIONS_NAMESPACE
-};
+import { CONFIG_TRANSLATIONS_NAMESPACE as CONFIG_TRANSLATIONS_NAMESPACE$1 } from "@hitachivantara/app-shell-shared";
+//#region src/i18n/constants.ts
+var APP_SHELL_NAMESPACE = "appShell";
+//#endregion
+export { APP_SHELL_NAMESPACE, CONFIG_TRANSLATIONS_NAMESPACE$1 as CONFIG_TRANSLATIONS_NAMESPACE };

package/dist/i18n/index.js

@@ -1,24 +1,30 @@
+import { APP_SHELL_NAMESPACE, CONFIG_TRANSLATIONS_NAMESPACE } from "./constants.js";
+import "./useI18nInit.js";
 import LanguageDetector from "i18next-browser-languagedetector";
 import { createI18n } from "@hitachivantara/app-shell-i18next";
 import en from "../locales/en/appShell.json";
-import { APP_SHELL_NAMESPACE } from "./constants.js";
-import { CONFIG_TRANSLATIONS_NAMESPACE } from "@hitachivantara/app-shell-shared";
-import { CONFIG_TRANSLATIONS_NAMESPACE as CONFIG_TRANSLATIONS_NAMESPACE2 } from "@hitachivantara/app-shell-shared";
-const createI18NextInstance = () => {
-  const instance = createI18n({
-    ns: [APP_SHELL_NAMESPACE, CONFIG_TRANSLATIONS_NAMESPACE],
-    fallbackLng: "en",
-    detection: { order: ["navigator"] },
-    partialBundledLanguages: true,
-    resources: {
-      en: { [APP_SHELL_NAMESPACE]: en }
-    }
-  });
-  instance.use(LanguageDetector);
-  return instance;
-};
-export {
-  APP_SHELL_NAMESPACE,
-  CONFIG_TRANSLATIONS_NAMESPACE2 as CONFIG_TRANSLATIONS_NAMESPACE,
-  createI18NextInstance
+//#region src/i18n/index.ts
+/**
+* Creates the i18next instance and registers the language detector, but does
+* NOT register the HTTP backend or call init().
+*
+* The HTTP backend is conditionally registered by `useI18nInit` only when
+* `translationsBaseUrl` is not `false` — this avoids the backend's `init()`
+* being called without a `baseUrl` when HTTP loading is disabled.
+*
+* The instance must be created at module level so the same reference is
+* provided to `I18nextProvider` across renders.
+*/
+var createI18NextInstance = () => {
+	const instance = createI18n({
+		ns: [APP_SHELL_NAMESPACE, CONFIG_TRANSLATIONS_NAMESPACE],
+		fallbackLng: "en",
+		detection: { order: ["navigator"] },
+		partialBundledLanguages: true,
+		resources: { en: { [APP_SHELL_NAMESPACE]: en } }
+	});
+	instance.use(LanguageDetector);
+	return instance;
 };
+//#endregion
+export { createI18NextInstance };

package/dist/i18n/useI18nInit.js

@@ -1,71 +1,77 @@
-import { useRef, useMemo } from "react";
+import { APP_SHELL_NAMESPACE } from "./constants.js";
+import { useMemo, useRef } from "react";
 import { HttpResourcesBackend, useI18n } from "@hitachivantara/app-shell-i18next";
-import { CONFIG_TRANSLATIONS_NAMESPACE } from "@hitachivantara/app-shell-shared";
 import en from "../locales/en/appShell.json";
-import { APP_SHELL_NAMESPACE } from "./constants.js";
-const toAbsoluteUrl = (url) => new URL(url, document.baseURI).href;
-const resolveTranslationsBaseUrl = (translationsBaseUrl, configUrl, baseUrl) => {
-  const raw = translationsBaseUrl ?? "./";
-  const base = configUrl ? new URL(".", toAbsoluteUrl(configUrl)).href : toAbsoluteUrl(baseUrl ?? "./");
-  const resolved = new URL(raw, base).href;
-  return resolved.endsWith("/") ? resolved : `${resolved}/`;
-};
-const buildResources = (translations) => {
-  const resources = {
-    en: {
-      [APP_SHELL_NAMESPACE]: en,
-      [CONFIG_TRANSLATIONS_NAMESPACE]: {}
-    }
-  };
-  if (translations) {
-    Object.entries(translations).forEach(([lng, bundle]) => {
-      resources[lng] = {
-        ...resources[lng],
-        [CONFIG_TRANSLATIONS_NAMESPACE]: bundle
-      };
-    });
-  }
-  return resources;
+import { CONFIG_TRANSLATIONS_NAMESPACE } from "@hitachivantara/app-shell-shared";
+//#region src/i18n/useI18nInit.ts
+/**
+* Resolves a possibly-relative URL to an absolute one.
+* Uses `document.baseURI` as the fallback so that paths like `/foo/bar/`
+* are turned into full URLs before being fed to the `URL` constructor as
+* a base.
+*/
+var toAbsoluteUrl = (url) => new URL(url, document.baseURI).href;
+/** Resolves the translations base URL to an absolute URL. */
+var resolveTranslationsBaseUrl = (translationsBaseUrl, configUrl, baseUrl) => {
+	const raw = translationsBaseUrl ?? "./";
+	const base = configUrl ? new URL(".", toAbsoluteUrl(configUrl)).href : toAbsoluteUrl(baseUrl ?? "./");
+	const resolved = new URL(raw, base).href;
+	return resolved.endsWith("/") ? resolved : `${resolved}/`;
 };
-const useI18nInit = (i18n, config, configUrl) => {
-  const reloadTriggered = useRef(false);
-  const translationsBaseUrl = config?.translationsBaseUrl;
-  const backendDisabled = translationsBaseUrl === false;
-  const initOptions = useMemo(() => {
-    return {
-      resources: buildResources(config?.translations),
-      partialBundledLanguages: true,
-      ...backendDisabled ? {} : {
-        backend: {
-          baseUrl: resolveTranslationsBaseUrl(
-            translationsBaseUrl,
-            configUrl,
-            config?.baseUrl
-          )
-        }
-      }
-    };
-  }, [
-    configUrl,
-    config?.baseUrl,
-    config?.translations,
-    translationsBaseUrl,
-    backendDisabled
-  ]);
-  if (!backendDisabled && !i18n.modules.backend) {
-    i18n.use(HttpResourcesBackend);
-  }
-  const result = useI18n(i18n, initOptions);
-  if (!reloadTriggered.current && !backendDisabled) {
-    reloadTriggered.current = true;
-    i18n.reloadResources("en", [
-      APP_SHELL_NAMESPACE,
-      CONFIG_TRANSLATIONS_NAMESPACE
-    ]).catch(() => {
-    });
-  }
-  return result;
+/**
+* Builds the `resources` object for i18next init.
+* Always includes `en/appShell` (bundled) and `en/app` (empty placeholder).
+* Merges any inline translations from the config per language.
+*/
+var buildResources = (translations) => {
+	const resources = { en: {
+		[APP_SHELL_NAMESPACE]: en,
+		[CONFIG_TRANSLATIONS_NAMESPACE]: {}
+	} };
+	if (translations) Object.entries(translations).forEach(([lng, bundle]) => {
+		resources[lng] = {
+			...resources[lng],
+			[CONFIG_TRANSLATIONS_NAMESPACE]: bundle
+		};
+	});
+	return resources;
 };
-export {
-  useI18nInit as default
+/**
+* Initializes the App Shell's i18next instance with the resolved config.
+*
+* - Pre-loads `appShell` (English) and config `translations` into `resources`
+*   so they're available before the backend fetches remote bundles.
+* - Computes `translationsBaseUrl` internally from the config.
+* - Right after the first init call, triggers `reloadResources` for both
+*   `appShell` and `app` namespaces (English) so server-side translations
+*   override the pre-bundled defaults.
+*
+* Returns `{ isInitialized }` — same shape as `useI18n`.
+*/
+var useI18nInit = (i18n, config, configUrl) => {
+	const reloadTriggered = useRef(false);
+	const translationsBaseUrl = config?.translationsBaseUrl;
+	const backendDisabled = translationsBaseUrl === false;
+	const initOptions = useMemo(() => {
+		return {
+			resources: buildResources(config?.translations),
+			partialBundledLanguages: true,
+			...backendDisabled ? {} : { backend: { baseUrl: resolveTranslationsBaseUrl(translationsBaseUrl, configUrl, config?.baseUrl) } }
+		};
+	}, [
+		configUrl,
+		config?.baseUrl,
+		config?.translations,
+		translationsBaseUrl,
+		backendDisabled
+	]);
+	if (!backendDisabled && !i18n.modules.backend) i18n.use(HttpResourcesBackend);
+	const result = useI18n(i18n, initOptions);
+	if (!reloadTriggered.current && !backendDisabled) {
+		reloadTriggered.current = true;
+		i18n.reloadResources("en", [APP_SHELL_NAMESPACE, CONFIG_TRANSLATIONS_NAMESPACE]).catch(() => {});
+	}
+	return result;
 };
+//#endregion
+export { useI18nInit as default };

package/dist/index.js

@@ -1,4 +1,5 @@
 import HvAppShell from "./components/AppShell/AppShell.js";
-export {
-  HvAppShell as default
-};
+//#region src/index.ts
+var src_default = HvAppShell;
+//#endregion
+export { src_default as default };