@hitachivantara/app-shell-ui 2.3.2 → 2.3.3

package/dist/utils/documentUtil.js

@@ -1,13 +1,13 @@
-const createAppContainerElement = (id) => {
-  const panelContainerId = "app-shell-panel-container";
-  let panelContainerElement = document.getElementById(panelContainerId);
-  if (!panelContainerElement) {
-    panelContainerElement = document.createElement("div");
-    panelContainerElement.id = panelContainerId;
-    document.body.appendChild(panelContainerElement);
-  }
-  return panelContainerElement;
-};
-export {
-  createAppContainerElement as default
+//#region src/utils/documentUtil.ts
+var createAppContainerElement = (id) => {
+	const panelContainerId = "app-shell-panel-container";
+	let panelContainerElement = document.getElementById(id ?? panelContainerId);
+	if (!panelContainerElement) {
+		panelContainerElement = document.createElement("div");
+		panelContainerElement.id = panelContainerId;
+		document.body.appendChild(panelContainerElement);
+	}
+	return panelContainerElement;
 };
+//#endregion
+export { createAppContainerElement as default };

package/dist/utils/filterModel.js

@@ -1,178 +1,142 @@
-const shouldInclude = (conditions, conditionResults) => {
-  if (!conditions || conditions.length === 0) {
-    return true;
-  }
-  for (const condition of conditions) {
-    if (!conditionResults[condition.globalIndex]) {
-      return false;
-    }
-  }
-  return true;
+//#region src/utils/filterModel.ts
+var shouldInclude = (conditions, conditionResults) => {
+	if (!conditions || conditions.length === 0) return true;
+	for (const condition of conditions) if (!conditionResults[condition.globalIndex]) return false;
+	return true;
 };
-const filterViews = (views, conditionResults) => {
-  const filteredViews = [];
-  let hasChanged = false;
-  for (const view of views) {
-    const include = shouldInclude(view.conditions, conditionResults);
-    if (!include) {
-      hasChanged = true;
-      continue;
-    }
-    if (!view.views) {
-      filteredViews.push(view);
-      continue;
-    }
-    const [filteredSubViews, subViewsChanged] = filterViews(
-      view.views,
-      conditionResults
-    );
-    if (subViewsChanged) {
-      filteredViews.push({ ...view, views: filteredSubViews });
-      hasChanged = true;
-    } else {
-      filteredViews.push(view);
-    }
-  }
-  return [hasChanged ? filteredViews : views, hasChanged];
+var filterViews = (views, conditionResults) => {
+	const filteredViews = [];
+	let hasChanged = false;
+	for (const view of views) {
+		if (!shouldInclude(view.conditions, conditionResults)) {
+			hasChanged = true;
+			continue;
+		}
+		if (!view.views) {
+			filteredViews.push(view);
+			continue;
+		}
+		const [filteredSubViews, subViewsChanged] = filterViews(view.views, conditionResults);
+		if (subViewsChanged) {
+			filteredViews.push({
+				...view,
+				views: filteredSubViews
+			});
+			hasChanged = true;
+		} else filteredViews.push(view);
+	}
+	return [hasChanged ? filteredViews : views, hasChanged];
 };
-const filterMenus = (menus, conditionResults) => {
-  const filteredMenus = [];
-  let hasChanged = false;
-  for (const menu of menus) {
-    const include = shouldInclude(menu.conditions, conditionResults);
-    const hasSubmenus = menu.submenus && menu.submenus.length > 0;
-    if (!include || !menu.target && !hasSubmenus) {
-      hasChanged = true;
-      continue;
-    }
-    if (!hasSubmenus) {
-      filteredMenus.push(menu);
-      continue;
-    }
-    const [filteredSubmenus, submenusChanged] = filterMenus(
-      menu.submenus,
-      conditionResults
-    );
-    if (filteredSubmenus.length === 0) {
-      hasChanged = true;
-      continue;
-    }
-    if (submenusChanged) {
-      filteredMenus.push({
-        ...menu,
-        submenus: filteredSubmenus
-      });
-      hasChanged = true;
-    } else {
-      filteredMenus.push(menu);
-    }
-  }
-  return [hasChanged ? filteredMenus : menus, hasChanged];
+/**
+* Recursively filters menu entries based on condition results and structural validity.
+*
+* A menu is excluded when:
+* 1. Its conditions evaluate to false (condition-based filtering), or
+* 2. It has no `target` and no `submenus` (invalid config guard), or
+* 3. It is a parent whose children were all filtered out, leaving it empty.
+*
+* Preserves object references when no changes occur to minimize re-renders.
+*/
+var filterMenus = (menus, conditionResults) => {
+	const filteredMenus = [];
+	let hasChanged = false;
+	for (const menu of menus) {
+		const include = shouldInclude(menu.conditions, conditionResults);
+		const hasSubmenus = menu.submenus && menu.submenus.length > 0;
+		if (!include || !menu.target && !hasSubmenus) {
+			hasChanged = true;
+			continue;
+		}
+		if (!hasSubmenus) {
+			filteredMenus.push(menu);
+			continue;
+		}
+		const [filteredSubmenus, submenusChanged] = filterMenus(menu.submenus, conditionResults);
+		if (filteredSubmenus.length === 0) {
+			hasChanged = true;
+			continue;
+		}
+		if (submenusChanged) {
+			filteredMenus.push({
+				...menu,
+				submenus: filteredSubmenus
+			});
+			hasChanged = true;
+		} else filteredMenus.push(menu);
+	}
+	return [hasChanged ? filteredMenus : menus, hasChanged];
 };
-const filterActions = (actions, conditionResults) => {
-  const filteredHeaderActions = [];
-  for (const action of actions) {
-    const include = shouldInclude(action.conditions, conditionResults);
-    if (include) filteredHeaderActions.push(action);
-  }
-  const hasChanged = filteredHeaderActions.length !== actions.length;
-  return [hasChanged ? filteredHeaderActions : actions, hasChanged];
+var filterActions = (actions, conditionResults) => {
+	const filteredHeaderActions = [];
+	for (const action of actions) if (shouldInclude(action.conditions, conditionResults)) filteredHeaderActions.push(action);
+	const hasChanged = filteredHeaderActions.length !== actions.length;
+	return [hasChanged ? filteredHeaderActions : actions, hasChanged];
 };
-const filterProviders = (providers, conditionResults) => {
-  const filteredProviders = [];
-  for (const provider of providers) {
-    const include = shouldInclude(provider.conditions, conditionResults);
-    if (include) filteredProviders.push(provider);
-  }
-  const hasChanged = filteredProviders.length !== providers.length;
-  return [hasChanged ? filteredProviders : providers, hasChanged];
+var filterProviders = (providers, conditionResults) => {
+	const filteredProviders = [];
+	for (const provider of providers) if (shouldInclude(provider.conditions, conditionResults)) filteredProviders.push(provider);
+	const hasChanged = filteredProviders.length !== providers.length;
+	return [hasChanged ? filteredProviders : providers, hasChanged];
 };
-const filterServices = (services, conditionResults) => {
-  if (!services) {
-    return [services, false];
-  }
-  const filteredServices = {};
-  let hasChanged = false;
-  for (const [serviceId, serviceProviderModels] of Object.entries(services)) {
-    const result = [];
-    let localChanged = false;
-    for (const serviceConfigModel of serviceProviderModels) {
-      const include = shouldInclude(
-        serviceConfigModel.conditions,
-        conditionResults
-      );
-      if (include) {
-        result.push(serviceConfigModel);
-      } else {
-        localChanged = true;
-      }
-    }
-    if (localChanged) hasChanged = true;
-    filteredServices[serviceId] = localChanged ? result : serviceProviderModels;
-  }
-  return [hasChanged ? filteredServices : services, hasChanged];
+var filterServices = (services, conditionResults) => {
+	if (!services) return [services, false];
+	const filteredServices = {};
+	let hasChanged = false;
+	for (const [serviceId, serviceProviderModels] of Object.entries(services)) {
+		const result = [];
+		let localChanged = false;
+		for (const serviceConfigModel of serviceProviderModels) if (shouldInclude(serviceConfigModel.conditions, conditionResults)) result.push(serviceConfigModel);
+		else localChanged = true;
+		if (localChanged) hasChanged = true;
+		filteredServices[serviceId] = localChanged ? result : serviceProviderModels;
+	}
+	return [hasChanged ? filteredServices : services, hasChanged];
 };
 function filterModel(model, conditionResults) {
-  let hasChanged = false;
-  const filtered = { ...model };
-  if (model.mainPanel?.views) {
-    const [filteredViews, viewsChanged] = filterViews(
-      model.mainPanel.views,
-      conditionResults
-    );
-    if (viewsChanged) {
-      filtered.mainPanel = {
-        ...model.mainPanel,
-        views: filteredViews
-      };
-      hasChanged = true;
-    }
-  }
-  if (model.menu) {
-    const [filteredMenus, menusChanged] = filterMenus(
-      model.menu,
-      conditionResults
-    );
-    if (menusChanged) {
-      filtered.menu = filteredMenus;
-      hasChanged = true;
-    }
-  }
-  if (model.header?.actions) {
-    const [filteredActions, actionsChanged] = filterActions(
-      model.header.actions,
-      conditionResults
-    );
-    if (actionsChanged) {
-      filtered.header = {
-        ...model.header,
-        actions: filteredActions
-      };
-      hasChanged = true;
-    }
-  }
-  if (model.providers) {
-    const [filteredProviders, providersChanged] = filterProviders(
-      model.providers,
-      conditionResults
-    );
-    if (providersChanged) {
-      filtered.providers = filteredProviders;
-      hasChanged = true;
-    }
-  }
-  if (model.services) {
-    const [filteredServices, servicesChanged] = filterServices(
-      model.services,
-      conditionResults
-    );
-    if (servicesChanged) {
-      filtered.services = filteredServices;
-      hasChanged = true;
-    }
-  }
-  return hasChanged ? filtered : model;
+	let hasChanged = false;
+	const filtered = { ...model };
+	if (model.mainPanel?.views) {
+		const [filteredViews, viewsChanged] = filterViews(model.mainPanel.views, conditionResults);
+		if (viewsChanged) {
+			filtered.mainPanel = {
+				...model.mainPanel,
+				views: filteredViews
+			};
+			hasChanged = true;
+		}
+	}
+	if (model.menu) {
+		const [filteredMenus, menusChanged] = filterMenus(model.menu, conditionResults);
+		if (menusChanged) {
+			filtered.menu = filteredMenus;
+			hasChanged = true;
+		}
+	}
+	if (model.header?.actions) {
+		const [filteredActions, actionsChanged] = filterActions(model.header.actions, conditionResults);
+		if (actionsChanged) {
+			filtered.header = {
+				...model.header,
+				actions: filteredActions
+			};
+			hasChanged = true;
+		}
+	}
+	if (model.providers) {
+		const [filteredProviders, providersChanged] = filterProviders(model.providers, conditionResults);
+		if (providersChanged) {
+			filtered.providers = filteredProviders;
+			hasChanged = true;
+		}
+	}
+	if (model.services) {
+		const [filteredServices, servicesChanged] = filterServices(model.services, conditionResults);
+		if (servicesChanged) {
+			filtered.services = filteredServices;
+			hasChanged = true;
+		}
+	}
+	return hasChanged ? filtered : model;
 }
-export {
-  filterModel as default
-};
+//#endregion
+export { filterModel as default };

package/dist/utils/lazyImport.js

@@ -1,40 +1,35 @@
+//#region src/utils/lazyImport.ts
 async function lazyImport(bundle) {
-  try {
-    const module = await import(
-      /* @vite-ignore */
-      bundle
-    );
-    return {
-      isPending: false,
-      error: null,
-      module: module.default
-    };
-  } catch (err) {
-    const error = err instanceof Error ? err : new Error(String(err));
-    return {
-      isPending: false,
-      error,
-      module: void 0
-    };
-  }
+	try {
+		return {
+			isPending: false,
+			error: null,
+			module: (await import(
+				/* @vite-ignore */
+				bundle
+)).default
+		};
+	} catch (err) {
+		return {
+			isPending: false,
+			error: err instanceof Error ? err : new Error(String(err)),
+			module: void 0
+		};
+	}
 }
 async function importAllBundles(bundles) {
-  const results = await Promise.all(
-    bundles.map((bundle) => lazyImport(bundle))
-  );
-  const preloadedBundles = /* @__PURE__ */ new Map();
-  for (let i = 0; i < results.length; i++) {
-    const result = results[i];
-    const bundle = bundles[i];
-    if (result.error) {
-      console.error(`Failed to load bundle ${bundle}:`, result.error);
-      continue;
-    }
-    preloadedBundles.set(bundle, result.module);
-  }
-  return preloadedBundles;
+	const results = await Promise.all(bundles.map((bundle) => lazyImport(bundle)));
+	const preloadedBundles = /* @__PURE__ */ new Map();
+	for (let i = 0; i < results.length; i++) {
+		const result = results[i];
+		const bundle = bundles[i];
+		if (result.error) {
+			console.error(`Failed to load bundle ${bundle}:`, result.error);
+			continue;
+		}
+		preloadedBundles.set(bundle, result.module);
+	}
+	return preloadedBundles;
 }
-export {
-  importAllBundles,
-  lazyImport
-};
+//#endregion
+export { importAllBundles };

package/dist/utils/navigationUtil.js

@@ -1,58 +1,73 @@
-import { jsx } from "react/jsx-runtime";
 import { ConfigIcon } from "../components/ConfigIcon.js";
-const createNavigationMenuItems = (t, menuItems, maxDepth) => {
-  if (maxDepth !== void 0 && maxDepth <= 0) {
-    return [];
-  }
-  return menuItems?.reduce((accumulator, currentValue) => {
-    const updatedDepth = maxDepth !== void 0 ? maxDepth - 1 : void 0;
-    const navItem = {
-      ...currentValue,
-      icon: currentValue.icon && /* @__PURE__ */ jsx(ConfigIcon, { icon: currentValue.icon }),
-      data: currentValue.data ? createNavigationMenuItems(t, currentValue.data, updatedDepth) : void 0
-    };
-    accumulator.push(navItem);
-    return accumulator;
-  }, []) ?? [];
-};
-const findItemById = (data, itemId) => {
-  let foundItem = null;
-  data.some((obj) => {
-    const { id: objId, data: childData } = obj;
-    if (objId === itemId) {
-      foundItem = obj;
-      return true;
-    }
-    if (childData && childData.length > 0) {
-      foundItem = findItemById(childData, itemId);
-      return foundItem !== null;
-    }
-    return false;
-  });
-  return foundItem;
+import { jsx } from "react/jsx-runtime";
+//#region src/utils/navigationUtil.tsx
+/**
+* Creates a navigation data structure ({@link MenuItem}) from the provided menu configuration ({@link NavigationMenuItem}).
+*
+* @param t
+* @param menuItems The set of menu items from configuration.
+* @param maxDepth The maximum depth up until the recursiveness should occur for the creation of the menu items.
+*
+* @returns An array of {@link MenuItem}.
+*/
+var createNavigationMenuItems = (t, menuItems, maxDepth) => {
+	if (maxDepth !== void 0 && maxDepth <= 0) return [];
+	return menuItems?.reduce((accumulator, currentValue) => {
+		const updatedDepth = maxDepth !== void 0 ? maxDepth - 1 : void 0;
+		const navItem = {
+			...currentValue,
+			icon: currentValue.icon && /* @__PURE__ */ jsx(ConfigIcon, { icon: currentValue.icon }),
+			data: currentValue.data ? createNavigationMenuItems(t, currentValue.data, updatedDepth) : void 0
+		};
+		accumulator.push(navItem);
+		return accumulator;
+	}, []) ?? [];
 };
-const getAppIdFromBundle = (bundle) => {
-  const bundleTokens = bundle.split("/");
-  let appId;
-  if (bundleTokens[0].startsWith("@")) {
-    appId = `${bundleTokens[0]}/${bundleTokens[1]}`;
-  } else {
-    [appId] = bundleTokens;
-  }
-  return appId;
+/**
+* Searches for an item with the specified id.
+*
+* @param {NavigationMenuItem[]} data - The navigation data structure.
+* @param {string} itemId - The item id.
+* @returns The item with matching id.
+*/
+var findItemById = (data, itemId) => {
+	let foundItem = null;
+	data.some((obj) => {
+		const { id: objId, data: childData } = obj;
+		if (objId === itemId) {
+			foundItem = obj;
+			return true;
+		}
+		if (childData && childData.length > 0) {
+			foundItem = findItemById(childData, itemId);
+			return foundItem !== null;
+		}
+		return false;
+	});
+	return foundItem;
 };
-const removeHrefFromMenuItemsWithChildren = (items) => {
-  return items.map((item) => {
-    const { href, data, ...rest } = item;
-    if (data && data.length > 0) {
-      return { ...rest, data: removeHrefFromMenuItemsWithChildren(data) };
-    }
-    return item;
-  });
+var getAppIdFromBundle = (bundle) => {
+	const bundleTokens = bundle.split("/");
+	let appId;
+	if (bundleTokens[0].startsWith("@")) appId = `${bundleTokens[0]}/${bundleTokens[1]}`;
+	else [appId] = bundleTokens;
+	return appId;
 };
-export {
-  createNavigationMenuItems,
-  findItemById,
-  getAppIdFromBundle,
-  removeHrefFromMenuItemsWithChildren
+/**
+* Recursively removes the href property from items in the array if they have a non-empty data property.
+*
+* @param items - The array of items.
+* @returns The new array with the href property removed from items with children.
+*/
+var removeHrefFromMenuItemsWithChildren = (items) => {
+	return items.map((item) => {
+		const { href, data, ...rest } = item;
+		if (data && data.length > 0) return {
+			...rest,
+			data: removeHrefFromMenuItemsWithChildren(data)
+		};
+		return item;
+	});
 };
+//#endregion
+export { createNavigationMenuItems, findItemById, getAppIdFromBundle, removeHrefFromMenuItemsWithChildren };