xmlui 0.11.4 → 0.11.7

package/dist/scripts/src/components/App/App.js

@@ -1,581 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.appRenderer = exports.AppMd = void 0;
-const jsx_runtime_1 = require("react/jsx-runtime");
-const App_module_scss_1 = __importDefault(require("./App.module.scss"));
-const Sheet_module_scss_1 = __importDefault(require("./Sheet.module.scss"));
-const renderers_1 = require("../../components-core/renderers");
-const themeVars_1 = require("../../components-core/theming/themeVars");
-const metadata_helpers_1 = require("../../components/metadata-helpers");
-const AppLayoutContext_1 = require("./AppLayoutContext");
-const AppNative_1 = require("./AppNative");
-const react_1 = require("react");
-const IndexerContext_1 = require("./IndexerContext");
-const react_dom_1 = require("react-dom");
-const AppContext_1 = require("../../components-core/AppContext");
-const SearchContext_1 = require("./SearchContext");
-const COMP = "App";
-exports.AppMd = (0, metadata_helpers_1.createMetadata)({
-    status: "stable",
-    description: "The `App` component is the root container that defines your application's overall " +
-        "structure and layout. It provides a complete UI framework with built-in navigation, " +
-        "header, footer, and content areas that work together seamlessly.",
-    props: {
-        layout: {
-            description: `This property sets the layout template of the app. This setting determines the position ` +
-                `and size of the app parts (such as header, navigation bar, footer, etc.) and the app's ` +
-                `scroll behavior.`,
-            availableValues: AppLayoutContext_1.appLayoutMd,
-        },
-        loggedInUser: {
-            description: "Stores information about the currently logged-in user. By not defining this property, " +
-                "you can indicate that no user is logged in.",
-            valueType: "string",
-        },
-        logoTemplate: (0, metadata_helpers_1.dComponent)("Optional template of the app logo"),
-        logo: {
-            description: "Optional logo path",
-            valueType: "string",
-        },
-        "logo-dark": {
-            description: "Optional logo path in dark tone",
-            valueType: "string",
-        },
-        "logo-light": {
-            description: "Optional logo path in light tone",
-            valueType: "string",
-        },
-        name: {
-            description: "Optional application name (visible in the browser tab). When you do not define " +
-                "this property, the tab name falls back to the one defined in the app\'s configuration. " +
-                'If the name is not configured, "XMLUI App" is displayed in the tab.',
-            valueType: "string",
-        },
-        scrollWholePage: {
-            description: `This boolean property specifies whether the whole page should scroll (\`true\`) or just ` +
-                `the content area (\`false\`). The default value is \`true\`.`,
-            valueType: "boolean",
-            defaultValue: AppNative_1.defaultProps.scrollWholePage,
-        },
-        noScrollbarGutters: {
-            description: "This boolean property specifies whether the scrollbar gutters should be hidden.",
-            valueType: "boolean",
-            defaultValue: AppNative_1.defaultProps.noScrollbarGutters,
-        },
-        defaultTone: {
-            description: 'This property sets the app\'s default tone ("light" or "dark").',
-            valueType: "string",
-            defaultValue: AppNative_1.defaultProps.defaultTone,
-            availableValues: ["light", "dark"],
-        },
-        defaultTheme: {
-            description: "This property sets the app's default theme.",
-            valueType: "string",
-            defaultValue: AppNative_1.defaultProps.defaultTheme,
-        },
-        autoDetectTone: {
-            description: 'This boolean property enables automatic detection of the system theme preference. ' +
-                'When set to true and no defaultTone is specified, the app will automatically use ' +
-                '"light" or "dark" tone based on the user\'s system theme setting. The app will ' +
-                'also respond to changes in the system theme preference.',
-            valueType: "boolean",
-            defaultValue: AppNative_1.defaultProps.autoDetectTone,
-        },
-    },
-    events: {
-        ready: {
-            description: `This event fires when the \`${COMP}\` component finishes rendering on the page.`,
-        },
-        messageReceived: {
-            description: `This event fires when the \`${COMP}\` component receives a message from another window or iframe via the window.postMessage API.`,
-        },
-    },
-    themeVars: Object.assign(Object.assign({}, (0, themeVars_1.parseScssVar)(App_module_scss_1.default.themeVars)), (0, themeVars_1.parseScssVar)(Sheet_module_scss_1.default.themeVars)),
-    limitThemeVarsToComponent: true,
-    themeVarDescriptions: {
-        "maxWidth-content-App": "This theme variable defines the maximum width of the main content. If the main " +
-            "content is broader, the engine adds margins to keep the expected maximum size.",
-        "boxShadow‑header‑App": "This theme variable sets the shadow of the app's header section.",
-        "boxShadow‑navPanel‑App": "This theme variable sets the shadow of the app's navigation panel section " +
-            "(visible only in vertical layouts).",
-        "width‑navPanel‑App": "This theme variable sets the width of the navigation panel when the app is displayed " +
-            "with one of the vertical layouts.",
-    },
-    defaultThemeVars: {
-        "maxWidth-Drawer": "100%",
-        [`width-navPanel-${COMP}`]: "$space-64",
-        [`backgroundColor-navPanel-${COMP}`]: "$backgroundColor",
-        [`maxWidth-content-${COMP}`]: "$maxWidth-content",
-        [`boxShadow-header-${COMP}`]: "none",
-        [`boxShadow-navPanel-${COMP}`]: "$boxShadow-spread",
-        [`scroll-padding-block-Pages`]: "$space-4",
-        [`backgroundColor-content-App`]: "$backgroundColor",
-        light: {
-        // --- No light-specific theme vars
-        },
-        dark: {
-        // --- No dark-specific theme vars
-        },
-    },
-});
-function AppNode({ node, extractValue, renderChild, className, lookupEventHandler, registerComponentApi }) {
-    // --- Use ref to track if we've already processed the navigation to avoid duplicates in strict mode
-    const processedNavRef = (0, react_1.useRef)(false);
-    // --- Memoize the layout type to avoid unnecessary re-extraction
-    const layoutType = (0, react_1.useMemo)(() => extractValue(node.props.layout), [node.props.layout, extractValue]);
-    // --- Memoize helper functions that are used in multiple places
-    // --- Parse a string into hierarchy labels, handling escaped pipe characters
-    const parseHierarchyLabels = (0, react_1.useMemo)(() => {
-        // Cache to hold previously computed results
-        const cache = new Map();
-        return (labelText) => {
-            // Return cached result if we've seen this input before
-            if (cache.has(labelText)) {
-                return cache.get(labelText);
-            }
-            const result = [];
-            let currentLabel = "";
-            let escaped = false;
-            for (let i = 0; i < labelText.length; i++) {
-                const char = labelText[i];
-                if (escaped) {
-                    // --- If this character was escaped, just add it literally
-                    currentLabel += char;
-                    escaped = false;
-                }
-                else if (char === "\\") {
-                    // --- Start of an escape sequence
-                    escaped = true;
-                }
-                else if (char === "|") {
-                    // --- Unescaped pipe indicates hierarchy separator
-                    result.push(currentLabel.trim());
-                    currentLabel = "";
-                }
-                else {
-                    // --- Regular character
-                    currentLabel += char;
-                }
-            }
-            // --- Don't forget to add the last segment
-            if (currentLabel.length > 0) {
-                result.push(currentLabel.trim());
-            }
-            // Cache the result
-            cache.set(labelText, result);
-            return result;
-        };
-    }, []);
-    // --- Helper function to check if a label exists in the navigation hierarchy
-    const labelExistsInHierarchy = (0, react_1.useMemo)(() => {
-        // Cache for previously checked labels within a hierarchy
-        const cache = new Map();
-        return (searchLabel, hierarchy) => {
-            // Create a cache key (could be improved with a better serialization of hierarchy)
-            const cacheKey = searchLabel + "_" + hierarchy.length;
-            if (cache.has(cacheKey)) {
-                return cache.get(cacheKey);
-            }
-            const result = hierarchy.some((node) => {
-                if (node.label === searchLabel) {
-                    return true;
-                }
-                if (node.children && node.children.length > 0) {
-                    return labelExistsInHierarchy(searchLabel, node.children);
-                }
-                return false;
-            });
-            cache.set(cacheKey, result);
-            return result;
-        };
-    }, []);
-    // --- Helper function to find or create NavGroups in the hierarchy
-    const findOrCreateNavGroup = (0, react_1.useMemo)(() => {
-        return (navItems, groupLabel) => {
-            // --- Check if a NavGroup with this label already exists
-            const existingGroup = navItems.find((item) => { var _a; return item.type === "NavGroup" && ((_a = item.props) === null || _a === void 0 ? void 0 : _a.label) === groupLabel; });
-            if (existingGroup) {
-                return existingGroup;
-            }
-            // --- Create a new NavGroup and add it to the array
-            const newGroup = {
-                type: "NavGroup",
-                props: {
-                    label: groupLabel,
-                },
-                children: [],
-            };
-            navItems.push(newGroup);
-            return newGroup;
-        };
-    }, []);
-    const { AppHeader, Footer, NavPanel, Pages, restChildren } = (0, react_1.useMemo)(() => {
-        var _a;
-        let AppHeader;
-        let Footer;
-        let NavPanel;
-        let Pages;
-        const restChildren = [];
-        (_a = node.children) === null || _a === void 0 ? void 0 : _a.forEach((rootChild) => {
-            var _a;
-            let transformedChild = Object.assign({}, rootChild);
-            if (rootChild.type === "Theme") {
-                transformedChild.children = (_a = rootChild.children) === null || _a === void 0 ? void 0 : _a.filter((child) => {
-                    if (child.type === "AppHeader") {
-                        AppHeader = Object.assign(Object.assign({}, rootChild), { children: [child] });
-                        return false;
-                    }
-                    else if (child.type === "Footer") {
-                        Footer = Object.assign(Object.assign({}, rootChild), { children: [child] });
-                        return false;
-                    }
-                    else if (child.type === "NavPanel") {
-                        NavPanel = Object.assign(Object.assign({}, rootChild), { children: [child] });
-                        return false;
-                    }
-                    return true;
-                });
-                if (!transformedChild.children.length) {
-                    transformedChild = null;
-                }
-            }
-            if (rootChild.type === "AppHeader") {
-                AppHeader = rootChild;
-            }
-            else if (rootChild.type === "Footer") {
-                Footer = rootChild;
-            }
-            else if (rootChild.type === "NavPanel") {
-                NavPanel = rootChild;
-            }
-            else if (rootChild.type === "Pages") {
-                Pages = rootChild;
-                restChildren.push(transformedChild);
-            }
-            else if (transformedChild !== null) {
-                restChildren.push(transformedChild);
-            }
-        });
-        // --- Check if there is any extra NavPanel in Pages
-        const extraNavs = extractNavPanelFromPages(Pages, NavPanel, processedNavRef, extractValue, parseHierarchyLabels, labelExistsInHierarchy, findOrCreateNavGroup);
-        // --- If we found extra navigation items
-        if (extraNavs === null || extraNavs === void 0 ? void 0 : extraNavs.length) {
-            if (NavPanel) {
-                // --- Create a new NavPanel with combined children instead of mutating the existing one
-                NavPanel = Object.assign(Object.assign({}, NavPanel), { children: NavPanel.children ? [...NavPanel.children, ...extraNavs] : extraNavs });
-            }
-            else {
-                // --- Create a new NavPanel component definition if none exists
-                NavPanel = {
-                    type: "NavPanel",
-                    props: {},
-                    children: extraNavs,
-                };
-            }
-        }
-        return {
-            AppHeader,
-            Footer,
-            NavPanel,
-            Pages,
-            restChildren,
-        };
-    }, [
-        node.children,
-        extractValue,
-        parseHierarchyLabels,
-        labelExistsInHierarchy,
-        findOrCreateNavGroup,
-    ]);
-    const applyDefaultContentPadding = !Pages;
-    // --- Memoize all app props to prevent unnecessary re-renders
-    const appProps = (0, react_1.useMemo)(() => ({
-        scrollWholePage: extractValue.asOptionalBoolean(node.props.scrollWholePage, true),
-        noScrollbarGutters: extractValue.asOptionalBoolean(node.props.noScrollbarGutters, false),
-        className,
-        layout: layoutType,
-        loggedInUser: extractValue(node.props.loggedInUser),
-        onReady: lookupEventHandler("ready"),
-        onMessageReceived: lookupEventHandler("messageReceived"),
-        name: extractValue(node.props.name),
-        logo: extractValue(node.props.logo),
-        logoDark: extractValue(node.props["logo-dark"]),
-        logoLight: extractValue(node.props["logo-light"]),
-        defaultTone: extractValue(node.props.defaultTone),
-        defaultTheme: extractValue(node.props.defaultTheme),
-        autoDetectTone: extractValue.asOptionalBoolean(node.props.autoDetectTone, false),
-        applyDefaultContentPadding
-    }), [
-        extractValue,
-        layoutType,
-        lookupEventHandler,
-        node.props.loggedInUser,
-        node.props.noScrollbarGutters,
-        node.props.scrollWholePage,
-        node.props.name,
-        node.props.logo,
-        node.props["logo-dark"],
-        node.props["logo-light"],
-        node.props.defaultTone,
-        node.props.defaultTheme,
-        node.props.autoDetectTone,
-        className,
-        applyDefaultContentPadding
-    ]);
-    // Memoize the rendered children to prevent unnecessary re-renders
-    const renderedHeader = (0, react_1.useMemo)(() => renderChild(AppHeader), [AppHeader, renderChild]);
-    const renderedFooter = (0, react_1.useMemo)(() => renderChild(Footer), [Footer, renderChild]);
-    const renderedNavPanel = (0, react_1.useMemo)(() => renderChild(NavPanel), [NavPanel, renderChild]);
-    const renderedContent = (0, react_1.useMemo)(() => renderChild(restChildren), [restChildren, renderChild]);
-    return ((0, jsx_runtime_1.jsxs)(AppNative_1.App, Object.assign({}, appProps, { header: renderedHeader, footer: renderedFooter, navPanel: renderedNavPanel, navPanelDef: NavPanel, logoContentDef: node.props.logoTemplate, renderChild: renderChild, registerComponentApi: registerComponentApi, children: [renderedContent, (0, jsx_runtime_1.jsx)(SearchIndexCollector, { Pages: Pages, renderChild: renderChild })] })));
-}
-const HIDDEN_STYLE = {
-    position: "absolute",
-    top: "-9999px",
-    display: "none",
-};
-const indexerContextValue = {
-    indexing: true,
-};
-function SearchIndexCollector({ Pages, renderChild }) {
-    var _a, _b;
-    const appContext = (0, AppContext_1.useAppContext)();
-    const setIndexing = (0, SearchContext_1.useSearchContextSetIndexing)();
-    const [isClient, setIsClient] = (0, react_1.useState)(false);
-    (0, react_1.useEffect)(() => {
-        setIsClient(true); // Ensure document.body is available
-        return () => {
-            setIndexing(false);
-        };
-    }, [setIndexing]);
-    // 1. Memoize the list of pages to be indexed
-    const pagesToIndex = (0, react_1.useMemo)(() => {
-        var _a;
-        return (((_a = Pages === null || Pages === void 0 ? void 0 : Pages.children) === null || _a === void 0 ? void 0 : _a.filter((child) => {
-            var _a;
-            return child.type === "Page" && // Ensure 'Page' matches your actual component type name
-                ((_a = child.props) === null || _a === void 0 ? void 0 : _a.url) && // Ensure URL exists
-                !child.props.url.includes("*") &&
-                !child.props.url.includes(":");
-        })) || []);
-    }, [Pages === null || Pages === void 0 ? void 0 : Pages.children]);
-    const [currentIndex, setCurrentIndex] = (0, react_1.useState)(0);
-    const [isDoneIndexing, setIsDoneIndexing] = (0, react_1.useState)(false);
-    const [, startTransitionParent] = (0, react_1.useTransition)(); // Transition for parent updates
-    const handlePageIndexed = (0, react_1.useCallback)(() => {
-        startTransitionParent(() => {
-            // Transition the update to the next page
-            setCurrentIndex((prevIndex) => {
-                const nextIndex = prevIndex + 1;
-                if (nextIndex >= pagesToIndex.length) {
-                    // console.log("All pages indexed.");
-                    setIsDoneIndexing(true); // All pages processed
-                }
-                return nextIndex;
-            });
-        });
-    }, [pagesToIndex.length]); // Recreate if the total number of pages changes
-    if (!((_a = appContext.appGlobals) === null || _a === void 0 ? void 0 : _a.searchIndexEnabled) || isDoneIndexing || !isClient) {
-        return null;
-    }
-    const currentPageToProcess = pagesToIndex[currentIndex];
-    if (!currentPageToProcess) {
-        // This can happen if pagesToIndex is empty or currentIndex went out of bounds unexpectedly.
-        // Setting isDoneIndexing if pagesToIndex is empty initially.
-        if (pagesToIndex.length === 0 && currentIndex === 0 && !isDoneIndexing) {
-            setIsDoneIndexing(true);
-        }
-        return null;
-    }
-    return ((0, jsx_runtime_1.jsx)(IndexerContext_1.IndexerContext.Provider, { value: indexerContextValue, children: (0, react_dom_1.createPortal)((0, jsx_runtime_1.jsx)("div", { style: HIDDEN_STYLE, "aria-hidden": "true", children: (0, jsx_runtime_1.jsx)(PageIndexer, { Page: currentPageToProcess, renderChild: renderChild, onIndexed: handlePageIndexed }, ((_b = currentPageToProcess.props) === null || _b === void 0 ? void 0 : _b.url) || currentIndex) }), document.body) }));
-}
-function PageIndexer({ Page, renderChild, onIndexed, }) {
-    var _a, _b;
-    const contentRef = (0, react_1.useRef)(null);
-    const pageUrl = ((_a = Page.props) === null || _a === void 0 ? void 0 : _a.url) || "";
-    const navLabel = ((_b = Page.props) === null || _b === void 0 ? void 0 : _b.navLabel) || "";
-    const searchContextUpdater = (0, SearchContext_1.useSearchContextUpdater)();
-    const [isContentRendered, setIsContentRendered] = (0, react_1.useState)(false);
-    const [isCollected, setIsCollected] = (0, react_1.useState)(false);
-    const [isProcessing, startTransition] = (0, react_1.useTransition)();
-    // Effect 1: Schedule the rendering of the Page's children (low priority)
-    (0, react_1.useEffect)(() => {
-        // console.log(`PageIndexer (${pageUrl}): Scheduling content render.`);
-        startTransition(() => {
-            setIsContentRendered(true); // This will trigger rendering of Page.children
-        });
-    }, [pageUrl]); // Re-run if the Page prop itself changes identity (due to key in parent)
-    // Effect 2: Extract content once Page.children is rendered and ref is available (low priority)
-    (0, react_1.useEffect)(() => {
-        if (isContentRendered && contentRef.current && !isCollected && !isProcessing) {
-            // console.log(`PageIndexer (${pageUrl}): Content rendered, scheduling extraction.`);
-            startTransition(() => {
-                // console.log(`PageIndexer (${pageUrl}): Starting extraction...`);
-                const currentContent = contentRef.current; // Capture ref value
-                if (!currentContent)
-                    return;
-                const clone = currentContent.cloneNode(true);
-                const elementsToRemove = clone.querySelectorAll("style, script");
-                elementsToRemove.forEach((el) => el.remove());
-                const titleElement = clone.querySelector("h1");
-                const title = titleElement
-                    ? titleElement.innerText
-                    : navLabel || pageUrl.split("/").pop() || pageUrl;
-                titleElement === null || titleElement === void 0 ? void 0 : titleElement.remove(); // Remove title element from clone to avoid duplication
-                const textContent = (clone.textContent || "").trim().replace(/\s+/g, " ");
-                const entry = {
-                    title: title,
-                    content: textContent,
-                    path: pageUrl,
-                };
-                searchContextUpdater(entry);
-                // console.log(`PageIndexer (${pageUrl}): Extraction complete, signaling parent.`);
-                onIndexed(); // Signal completion to parent
-                setIsCollected(true); // Mark as collected
-            });
-        }
-    }, [
-        isContentRendered,
-        pageUrl,
-        searchContextUpdater,
-        onIndexed,
-        isCollected,
-        isProcessing,
-        navLabel,
-    ]); // Ensure all dependencies are listed
-    // If this PageIndexer instance's work is done, or content not yet rendered, render nothing.
-    // The parent (SearchIndexCollector) will unmount this and mount the next one.
-    if (isCollected || !isContentRendered) {
-        // console.log(`PageIndexer (${pageUrl}): Null render (isCollected: ${isCollected}, isContentRendered: ${isContentRendered})`);
-        return null;
-    }
-    // This part renders when isContentRendered is true and isCollected is false.
-    // The content needs to be in the DOM for contentRef.current to be populated.
-    // console.log(`PageIndexer (${pageUrl}): Rendering content for ref population.`);
-    return (0, jsx_runtime_1.jsx)("div", { ref: contentRef, children: renderChild(Page.children) });
-}
-exports.appRenderer = (0, renderers_1.createComponentRenderer)(COMP, exports.AppMd, ({ node, extractValue, renderChild, className, lookupEventHandler, registerComponentApi }) => {
-    return ((0, jsx_runtime_1.jsx)(AppNode, { node: node, renderChild: renderChild, extractValue: extractValue, className: className, lookupEventHandler: lookupEventHandler, registerComponentApi: registerComponentApi }));
-});
-// --- Process the entire navigation tree recursively and build hierarchy
-function processNavItems(items, parentHierarchy, extractValue) {
-    items.forEach((navItem) => {
-        var _a, _b, _c, _d;
-        // --- Process NavLink items
-        if (navItem.type === "NavLink") {
-            let itemLabel = (_a = navItem.props) === null || _a === void 0 ? void 0 : _a.label;
-            let itemPath = (_b = navItem.props) === null || _b === void 0 ? void 0 : _b.to;
-            if (!itemLabel) {
-                if (((_c = navItem.children) === null || _c === void 0 ? void 0 : _c.length) === 1 && navItem.children[0].type === "TextNode") {
-                    itemLabel = navItem.children[0].props.value;
-                }
-            }
-            if (itemLabel) {
-                const labelValue = extractValue(itemLabel);
-                // --- Add to hierarchy
-                parentHierarchy.push({
-                    type: "NavLink",
-                    label: labelValue,
-                    path: itemPath ? extractValue(itemPath) : undefined,
-                });
-            }
-        }
-        // --- Process NavGroup items (which may contain nested NavLink or NavGroup items)
-        else if (navItem.type === "NavGroup") {
-            let groupLabel = (_d = navItem.props) === null || _d === void 0 ? void 0 : _d.label;
-            if (groupLabel) {
-                const labelValue = extractValue(groupLabel);
-                // --- Create group node
-                const groupNode = {
-                    type: "NavGroup",
-                    label: labelValue,
-                    children: [],
-                };
-                // --- Add to parent hierarchy
-                parentHierarchy.push(groupNode);
-                // --- Recursively process children of the NavGroup
-                if (navItem.children && navItem.children.length > 0) {
-                    processNavItems(navItem.children, groupNode.children, extractValue);
-                }
-            }
-            else if (navItem.children && navItem.children.length > 0) {
-                // --- If no label but has children, still process them under parent
-                processNavItems(navItem.children, parentHierarchy, extractValue);
-            }
-        }
-    });
-}
-// --- Extract navigation panel items from Pages component
-function extractNavPanelFromPages(Pages, NavPanel, processedNavRef, extractValue, parseHierarchyLabels, labelExistsInHierarchy, findOrCreateNavGroup) {
-    var _a;
-    // --- Skip extraction if we've already processed this navigation structure
-    // --- This prevents duplicate items when React renders twice in strict mode
-    if (!Pages || processedNavRef.current)
-        return null;
-    // --- Mark as processed
-    processedNavRef.current = true;
-    const extraNavs = [];
-    // --- Root of navigation hierarchy
-    const navigationHierarchy = [];
-    // --- Start processing the navigation tree if NavPanel exists
-    if (NavPanel === null || NavPanel === void 0 ? void 0 : NavPanel.children) {
-        processNavItems(NavPanel.children, navigationHierarchy, extractValue);
-    }
-    // --- Process Pages to create hierarchical navigation structure
-    (_a = Pages.children) === null || _a === void 0 ? void 0 : _a.forEach((page) => {
-        if (page.type === "Page" && page.props.navLabel) {
-            const label = extractValue(page.props.navLabel);
-            const url = extractValue(page.props.url);
-            // --- Parse hierarchy labels separated by unescaped pipe characters
-            const hierarchyLabels = parseHierarchyLabels(label);
-            // --- Skip if we have no labels
-            if (hierarchyLabels.length === 0) {
-                return;
-            }
-            // --- For a single level, just add a NavLink directly
-            if (hierarchyLabels.length === 1) {
-                // --- Check if this exact NavLink already exists in the navigation hierarchy
-                if (!labelExistsInHierarchy(hierarchyLabels[0], navigationHierarchy)) {
-                    extraNavs.push({
-                        type: "NavLink",
-                        props: {
-                            label: hierarchyLabels[0],
-                            to: url,
-                        },
-                    });
-                }
-                return;
-            }
-            // --- For multi-level hierarchies, create NavGroups and a final NavLink
-            let currentLevel = extraNavs;
-            // --- Create NavGroups for all levels except the last one
-            for (let i = 0; i < hierarchyLabels.length - 1; i++) {
-                const groupLabel = hierarchyLabels[i];
-                const navGroup = findOrCreateNavGroup(currentLevel, groupLabel);
-                // --- Initialize children array if it doesn't exist
-                if (!navGroup.children) {
-                    navGroup.children = [];
-                }
-                // --- Move to the next level
-                currentLevel = navGroup.children;
-            }
-            // --- Add the leaf NavLink to the deepest NavGroup
-            const leafLabel = hierarchyLabels[hierarchyLabels.length - 1];
-            // --- Check if this NavLink already exists at this level
-            const existingNavLink = currentLevel.find((item) => { var _a; return item.type === "NavLink" && ((_a = item.props) === null || _a === void 0 ? void 0 : _a.label) === leafLabel; });
-            if (!existingNavLink) {
-                currentLevel.push({
-                    type: "NavLink",
-                    props: {
-                        label: leafLabel,
-                        to: url,
-                    },
-                });
-            }
-        }
-    });
-    return extraNavs;
-}