@xyd-js/framework 0.1.0-xyd.6 → 0.1.0-xyd.73

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 xyd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/dist/Sidebar-CdavG0uc.d.ts

@@ -0,0 +1,23 @@
+import { Metadata } from '@xyd-js/core';
+
+interface FwSidebarGroupProps {
+    group: string;
+    groupIndex: number;
+    items: FwSidebarItemProps[];
+    icon?: string;
+}
+interface FwSidebarItemProps {
+    title: string;
+    href: string;
+    uniqIndex: number;
+    icon?: string;
+    sidebarTitle?: string;
+    items?: FwSidebarItemProps[];
+    active?: boolean;
+    readonly level?: number;
+    readonly groupIndex?: number;
+    readonly itemIndex?: number;
+    readonly pageMeta?: Metadata;
+}
+
+export type { FwSidebarGroupProps as F };

package/dist/hydration.d.ts

@@ -1,11 +1,17 @@
-import { Settings } from '@xyd-js/core';
+import { Settings, MetadataMap, Metadata } from '@xyd-js/core';
 import { IBreadcrumb, INavLinks } from '@xyd-js/ui';
-import { F as FwSidebarGroupProps } from './sidebar-Dwf54qYp.js';
+import { F as FwSidebarGroupProps } from './Sidebar-CdavG0uc.js';
 
-declare function mapSettingsToProps(settings: Settings, slug: string): Promise<{
+declare function mapSettingsToProps(settings: Settings, pagePathMapping: {
+    [key: string]: string;
+}, slug: string, frontmatters?: MetadataMap): Promise<{
     groups: FwSidebarGroupProps[];
     breadcrumbs: IBreadcrumb[];
     navlinks?: INavLinks;
+    hiddenPages?: {
+        [key: string]: boolean;
+    };
+    metadata?: Metadata | null;
 }>;
 
 export { mapSettingsToProps };

package/dist/hydration.js

@@ -1,91 +1,28 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// packages/hydration/index.ts
-var hydration_exports = {};
-__export(hydration_exports, {
-  mapSettingsToProps: () => mapSettingsToProps
-});
-module.exports = __toCommonJS(hydration_exports);
-
-// packages/hydration/settings-to-props.ts
-var import_navigation = require("@xyd-js/content/navigation");
-function filterNavigation(settings, slug) {
-  var _a;
-  const sidebarItems = [];
-  let multiSidebarMatch = null;
-  (_a = settings == null ? void 0 : settings.structure) == null ? void 0 : _a.sidebar.filter((sidebar) => {
-    var _a2;
-    if ("match" in sidebar) {
-      const sideMatch = normalizeHref(sidebar.match);
-      const normalizeSlug = normalizeHref(slug);
-      if (normalizeSlug.startsWith(sideMatch)) {
-        if (multiSidebarMatch) {
-          const findByMatchLvl = multiSidebarMatch.match.split("/").length;
-          const urlMatchLvl = sideMatch.split("/").length;
-          if (urlMatchLvl > findByMatchLvl) {
-            multiSidebarMatch = sidebar;
-          }
-        } else {
-          multiSidebarMatch = sidebar;
-        }
-      }
-      return;
-    }
-    const ok = (0, import_navigation.filterNavigationByLevels)(((_a2 = settings == null ? void 0 : settings.structure) == null ? void 0 : _a2.header) || [], slug)(sidebar);
-    if (ok) {
-      sidebarItems.push(sidebar);
-    }
-  });
-  if (multiSidebarMatch != null) {
-    const side = multiSidebarMatch;
-    sidebarItems.push(...side.items);
-  }
-  return sidebarItems;
-}
-function normalizeHrefCheck(first, second) {
-  if (first.startsWith("/")) {
-    first = first.slice(1);
-  }
-  if (second.startsWith("/")) {
-    second = second.slice(1);
-  }
-  return first === second;
-}
-function normalizeHref(href) {
-  if (href.startsWith("/")) {
-    return href;
-  }
-  return `/${href}`;
-}
-function safePageLink(page) {
-  return (page == null ? void 0 : page.startsWith("/")) ? page : `/${page}`;
-}
-async function mapSettingsToProps(settings, slug) {
+// packages/hydration/mapSettingsToProps.ts
+import { pageFrontMatters } from "@xyd-js/content";
+async function mapSettingsToProps(settings, pagePathMapping, slug, frontmatters) {
+  let uniqIndex = 0;
   const filteredNav = filterNavigation(settings, slug);
-  const frontmatters = await (0, import_navigation.pageFrontMatters)(filteredNav);
+  if (!frontmatters) {
+    frontmatters = await pageFrontMatters(filteredNav, pagePathMapping);
+  }
   const slugFrontmatter = frontmatters[slug] || null;
   const breadcrumbs = [];
   let navlinks = void 0;
+  const hiddenPages = Object.keys(frontmatters).reduce((acc, page) => {
+    if (frontmatters[page].hidden) {
+      acc[page] = true;
+    }
+    return acc;
+  }, {});
   function mapItems(page, currentNav, nav) {
-    var _a;
-    if (typeof page !== "string") {
-      const items = (_a = page.pages) == null ? void 0 : _a.map((p) => mapItems(p, page, nav));
+    var _a, _b;
+    if (!frontmatters) {
+      console.error("frontmatters not found");
+      return null;
+    }
+    if (typeof page !== "string" && !("virtual" in page)) {
+      const items = (_b = (_a = page.pages) == null ? void 0 : _a.map((p) => mapItems(p, page, nav))) == null ? void 0 : _b.filter(Boolean);
       if (items == null ? void 0 : items.find((item) => normalizeHrefCheck(item.href, slug))) {
         breadcrumbs.unshift({
           title: page.group || "",
@@ -97,10 +34,21 @@ async function mapSettingsToProps(settings, slug) {
         title: page.group,
         href: "",
         active: false,
+        uniqIndex: uniqIndex++,
+        icon: page.icon,
         items
       };
     }
-    const matterTitle = frontmatters && frontmatters[page] && frontmatters[page].title;
+    let pageName = "";
+    if (typeof page === "string") {
+      pageName = page;
+    } else {
+      pageName = page.page;
+    }
+    if (hiddenPages[pageName]) {
+      return null;
+    }
+    const matterTitle = frontmatters && frontmatters[pageName] && frontmatters[pageName].title;
     let title = "";
     if (typeof matterTitle === "string") {
       title = matterTitle;
@@ -108,10 +56,11 @@ async function mapSettingsToProps(settings, slug) {
       title = matterTitle;
     }
     if (!title) {
-      console.error("Title not found for page", page);
+      console.debug(`\u26A0\uFE0F Title not found for page "${pageName}"`);
     }
-    if (slugFrontmatter && slugFrontmatter === frontmatters[page]) {
-      const nlinks = mapNavToLinks(page, currentNav, nav, frontmatters);
+    const meta = frontmatters[pageName];
+    if (slugFrontmatter && slugFrontmatter === meta) {
+      const nlinks = mapNavToLinks(pageName, currentNav, nav, frontmatters, hiddenPages);
       if (nlinks) {
         navlinks = nlinks;
       }
@@ -125,147 +74,196 @@ async function mapSettingsToProps(settings, slug) {
       breadcrumbs.push({
         // @ts-ignore
         title,
-        href: page
+        href: pageName
       });
     }
     return {
-      // @ts-ignore
       title,
-      href: safePageLink(page),
-      active: false
-      // TODO:
+      href: safePageLink(pageName),
+      active: false,
+      uniqIndex: uniqIndex++,
+      icon: (meta == null ? void 0 : meta.icon) || "",
+      sidebarTitle: (meta == null ? void 0 : meta.sidebarTitle) || "",
+      pageMeta: meta || null
     };
   }
   const groups = filteredNav.map((nav) => {
-    var _a;
-    if ("match" in nav) {
+    var _a, _b, _c;
+    if ("route" in nav) {
+      if ((_a = nav.pages) == null ? void 0 : _a.length) {
+        const items2 = (((_b = nav.pages) == null ? void 0 : _b.map((p) => mapItems(p, nav, filteredNav))) || []).filter(Boolean);
+        return {
+          items: items2
+        };
+      }
       return {
         group: "",
-        items: []
+        items: [],
+        groupIndex: 0
       };
     }
+    const items = (((_c = nav.pages) == null ? void 0 : _c.map((p) => mapItems(p, nav, filteredNav))) || []).filter(Boolean);
     return {
       group: nav.group,
-      items: ((_a = nav.pages) == null ? void 0 : _a.map((p) => {
-        return mapItems(p, nav, filteredNav);
-      })) || []
+      icon: nav == null ? void 0 : nav.icon,
+      items
     };
   }) || [];
   return {
     groups,
     breadcrumbs,
-    navlinks
+    navlinks,
+    hiddenPages,
+    metadata: slugFrontmatter
   };
 }
-function mapNavToLinks(page, currentNav, nav, frontmatters) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
-  if (!currentNav.group) {
-    console.error("current nav need group to calculate navlinks");
-    return;
-  }
-  const currentPageIndex = (_a = currentNav == null ? void 0 : currentNav.pages) == null ? void 0 : _a.findIndex((p) => page === p);
-  const foundPageIndex = currentPageIndex != void 0 && currentPageIndex !== -1;
-  if (!foundPageIndex) {
+function filterNavigation(settings, slug) {
+  var _a, _b;
+  const sidebarItems = [];
+  let multiSidebarMatch = null;
+  let flatPagesOnly = false;
+  let foundRoute = false;
+  function findRoute(sidebar) {
+    var _a2;
+    if ("route" in sidebar) {
+      const sideMatch = normalizeHref(sidebar.route);
+      const normalizeSlug = normalizeHref(slug);
+      if (normalizeSlug.startsWith(sideMatch)) {
+        if (multiSidebarMatch) {
+          const findByMatchLvl = multiSidebarMatch.route.split("/").length;
+          const urlMatchLvl = sideMatch.split("/").length;
+          if (urlMatchLvl > findByMatchLvl) {
+            if (!foundRoute) {
+              foundRoute = true;
+              sidebarItems.length = 0;
+            }
+            multiSidebarMatch = sidebar;
+          }
+        } else {
+          if (!foundRoute) {
+            foundRoute = true;
+            sidebarItems.length = 0;
+          }
+          multiSidebarMatch = sidebar;
+        }
+      }
+      if ("pages" in sidebar && ((_a2 = sidebar.pages) == null ? void 0 : _a2.length)) {
+        for (const page of sidebar.pages) {
+          findRoute(page);
+        }
+      }
+    }
     return;
   }
-  let prev = (_b = currentNav == null ? void 0 : currentNav.pages) == null ? void 0 : _b[currentPageIndex - 1];
-  let next = (_c = currentNav == null ? void 0 : currentNav.pages) == null ? void 0 : _c[currentPageIndex + 1];
-  if (prev && next) {
-    if (typeof prev !== "string" || typeof next !== "string") {
-      console.error("currently nested pages for navlinks are not supported (step 1)");
+  (_a = settings == null ? void 0 : settings.navigation) == null ? void 0 : _a.sidebar.filter((sidebar) => {
+    if (flatPagesOnly) {
       return;
     }
-    const prevTitle2 = ((_d = frontmatters[prev]) == null ? void 0 : _d.title) || "";
-    const nextTitle2 = ((_e = frontmatters[next]) == null ? void 0 : _e.title) || "";
-    return {
-      prev: {
-        // @ts-ignore
-        title: prevTitle2,
-        href: safePageLink(prev)
-      },
-      next: {
-        // @ts-ignore
-        title: nextTitle2,
-        href: safePageLink(next)
-      }
-    };
+    if (typeof sidebar === "string") {
+      flatPagesOnly = true;
+      return;
+    }
+    if ("route" in sidebar) {
+      findRoute(sidebar);
+      return;
+    }
+    if (foundRoute) {
+      return;
+    }
+    sidebarItems.push(sidebar);
+  });
+  if (multiSidebarMatch != null) {
+    const side = multiSidebarMatch;
+    sidebarItems.push(...(side == null ? void 0 : side.pages) || []);
   }
-  const currentNavPosition = nav.findIndex((n) => n.group === currentNav.group);
-  const foundNavIndex = currentNavPosition != void 0 && currentNavPosition !== -1;
-  if (!foundNavIndex) {
-    return;
+  if (flatPagesOnly) {
+    sidebarItems.push({
+      pages: (_b = settings == null ? void 0 : settings.navigation) == null ? void 0 : _b.sidebar
+    });
   }
-  if (!prev) {
-    const prevNav = nav[currentNavPosition - 1];
-    if (prevNav) {
-      const prevNavLastPge = (_f = prevNav == null ? void 0 : prevNav.pages) == null ? void 0 : _f[prevNav.pages.length - 1];
-      if (typeof prevNavLastPge != "string") {
-        console.error("currently nested pages for navlinks are not supported (step 2)");
-      } else {
-        prev = prevNavLastPge;
-      }
-    }
+  return sidebarItems;
+}
+function normalizeHrefCheck(first, second) {
+  if (first.startsWith("/")) {
+    first = first.slice(1);
   }
-  if (!next) {
-    const nextNav = nav[currentNavPosition + 1];
-    if (nextNav) {
-      const nextNavFirstPage = (_g = nextNav == null ? void 0 : nextNav.pages) == null ? void 0 : _g[0];
-      if (typeof nextNavFirstPage != "string") {
-        console.error("currently nested pages for navlinks are not supported (step 3)");
-      } else {
-        next = nextNavFirstPage;
-      }
-    }
+  if (second.startsWith("/")) {
+    second = second.slice(1);
   }
-  if (!prev) {
-    if (typeof next == "string") {
-      const nextTitle2 = ((_h = frontmatters[next]) == null ? void 0 : _h.title) || "";
-      return {
-        next: {
-          // @ts-ignore
-          title: nextTitle2,
-          href: safePageLink(next)
+  return first === second;
+}
+function normalizeHref(href) {
+  if (href.startsWith("/")) {
+    return href;
+  }
+  return `/${href}`;
+}
+function safePageLink(page) {
+  return (page == null ? void 0 : page.startsWith("/")) ? page : `/${page}`;
+}
+function mapNavToLinks(page, currentNav, nav, frontmatters, hiddenPages) {
+  var _a, _b;
+  if (!currentNav.group) {
+    console.debug("current nav need group to calculate navlinks");
+    return;
+  }
+  const allPages = [];
+  nav.forEach((group, groupIndex) => {
+    if (group.pages) {
+      group.pages.forEach((pageItem, pageIndex) => {
+        let pageName = "";
+        if (typeof pageItem === "string") {
+          pageName = pageItem;
+        } else if ("virtual" in pageItem) {
+          pageName = pageItem.page;
+        } else if ("pages" in pageItem) {
+          return;
+        } else if ("page" in pageItem && typeof pageItem === "object") {
+          pageName = pageItem.page;
         }
-      };
-    } else {
-      console.error("currently nested pages for navlinks are not supported (step 4)");
+        if (pageName && !hiddenPages[pageName]) {
+          allPages.push({
+            page: pageName,
+            group: group.group || "",
+            groupIndex,
+            pageIndex
+          });
+        }
+      });
     }
+  });
+  const currentPageIndex = allPages.findIndex((p) => p.page === page);
+  if (currentPageIndex === -1) {
+    return void 0;
   }
-  if (!next) {
-    if (typeof prev == "string") {
-      const nextTitle2 = ((_i = frontmatters[prev]) == null ? void 0 : _i.title) || "";
-      return {
-        prev: {
-          // @ts-ignore
-          title: nextTitle2,
-          href: safePageLink(prev)
-        }
+  const prevPage = allPages[currentPageIndex - 1];
+  const nextPage = allPages[currentPageIndex + 1];
+  let prevLink;
+  let nextLink;
+  if (prevPage) {
+    const prevTitle = ((_a = frontmatters[prevPage.page]) == null ? void 0 : _a.title) || prevPage.page;
+    if (typeof prevTitle === "string") {
+      prevLink = {
+        title: prevTitle,
+        href: safePageLink(prevPage.page)
       };
-    } else {
-      console.error("currently nested pages for navlinks are not supported (step 5)");
     }
   }
-  if (typeof prev !== "string" || typeof next !== "string") {
-    console.error("currently nested pages for navlinks are not supported (step 6)");
-    return;
+  if (nextPage) {
+    const nextTitle = ((_b = frontmatters[nextPage.page]) == null ? void 0 : _b.title) || nextPage.page;
+    if (typeof nextTitle === "string") {
+      nextLink = {
+        title: nextTitle,
+        href: safePageLink(nextPage.page)
+      };
+    }
   }
-  const prevTitle = ((_j = frontmatters[prev]) == null ? void 0 : _j.title) || "";
-  const nextTitle = ((_k = frontmatters[next]) == null ? void 0 : _k.title) || "";
   return {
-    prev: {
-      // @ts-ignore
-      title: prevTitle,
-      href: safePageLink(prev)
-    },
-    next: {
-      // @ts-ignore
-      title: nextTitle,
-      href: safePageLink(next)
-    }
+    prev: prevLink || void 0,
+    next: nextLink || void 0
   };
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
+export {
   mapSettingsToProps
-});
+};
 //# sourceMappingURL=hydration.js.map

package/dist/hydration.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../packages/hydration/index.ts","../packages/hydration/settings-to-props.ts"],"sourcesContent":["export {\n    mapSettingsToProps\n} from \"./settings-to-props\"","// server-only\n\nimport {Sidebar, PageFrontMatter, Settings, SidebarMulti} from \"@xyd-js/core\";\nimport {filterNavigationByLevels, pageFrontMatters} from \"@xyd-js/content/navigation\";\nimport {IBreadcrumb, INavLinks} from \"@xyd-js/ui\";\n\nimport {FwSidebarGroupProps} from \"../react\";\n\n// TODO: framework vs content responsibility\n\nfunction filterNavigation(settings: Settings, slug: string): Sidebar[] {\n    const sidebarItems: Sidebar[] = []\n\n    let multiSidebarMatch: SidebarMulti | null = null\n\n    settings?.structure?.sidebar.filter(sidebar => {\n        if (\"match\" in sidebar) {\n            const sideMatch = normalizeHref(sidebar.match)\n            const normalizeSlug = normalizeHref(slug)\n\n            // TODO: startWith is not enough e.g `/docs/apps/buildISSUE` if `/docs/apps/build`\n            if (normalizeSlug.startsWith(sideMatch)) {\n                if (multiSidebarMatch) {\n                    const findByMatchLvl = multiSidebarMatch.match.split(\"/\").length\n                    const urlMatchLvl = sideMatch.split(\"/\").length\n\n                    if (urlMatchLvl > findByMatchLvl) {\n                        multiSidebarMatch = sidebar\n                    }\n                } else {\n                    multiSidebarMatch = sidebar\n                }\n            }\n\n            return\n        }\n\n        // TODO: better algorithm\n        const ok = filterNavigationByLevels(settings?.structure?.header || [], slug)(sidebar)\n\n        if (ok) {\n            sidebarItems.push(sidebar)\n        }\n    })\n\n    if (multiSidebarMatch != null) {\n        const side = multiSidebarMatch as SidebarMulti\n        sidebarItems.push(...side.items)\n    }\n\n    return sidebarItems\n}\n\n// TODO: rename this because it's no longer 'navigation' because it returns breadcrumbs, sidebar and nextlinks props\n// TODO: breadcrumbs and frontmatters as content plugins?\n// TODO: idea - calculate breadcrumbs and navlinks near server-side component?\n\nfunction normalizeHrefCheck(first: string, second: string) {\n    if (first.startsWith(\"/\")) {\n        first = first.slice(1)\n    }\n\n    if (second.startsWith(\"/\")) {\n        second = second.slice(1)\n    }\n\n    return first === second\n}\n\nfunction normalizeHref(href: string) {\n    if (href.startsWith(\"/\")) {\n        return href\n    }\n\n    return `/${href}`\n}\n\nfunction safePageLink(page: string): string {\n    return page?.startsWith(\"/\") ? page : `/${page}`\n}\n\n// mapNavigationToProps maps @xyd-js/core navigation into @xyd-js/ui props\nexport async function mapSettingsToProps(\n    settings: Settings,\n    slug: string\n): Promise<{\n    groups: FwSidebarGroupProps[],\n    breadcrumbs: IBreadcrumb[]\n    navlinks?: INavLinks\n}> {\n    const filteredNav = filterNavigation(settings, slug)\n    const frontmatters = await pageFrontMatters(filteredNav)\n\n    const slugFrontmatter = frontmatters[slug] || null\n    const breadcrumbs: IBreadcrumb[] = []\n    let navlinks: INavLinks | undefined = undefined\n\n    function mapItems(\n        page: string | Sidebar,\n        currentNav: Sidebar,\n        nav: Sidebar[]\n    ) {\n        if (typeof page !== \"string\") {\n            const items = page.pages?.map((p) => mapItems(p, page, nav))\n\n            if (items?.find(item => normalizeHrefCheck(item.href, slug))) {\n                breadcrumbs.unshift({\n                    title: page.group || \"\",\n                    href: \"\", // TODO:\n                })\n            }\n\n            return {\n                title: page.group,\n                href: \"\",\n                active: false,\n                items,\n            }\n        }\n\n        const matterTitle = frontmatters && frontmatters[page] && frontmatters[page].title\n\n        let title = \"\"\n\n        if (typeof matterTitle === \"string\") {\n            title = matterTitle\n        } else {\n            // @ts-ignore\n            title = matterTitle\n        }\n\n        if (!title) {\n            console.error(\"Title not found for page\", page)\n        }\n\n        // TODO: better data structures - for example flat array of filtered nav\n        if (slugFrontmatter && (slugFrontmatter === frontmatters[page])) {\n            const nlinks = mapNavToLinks(page, currentNav, nav, frontmatters)\n\n            if (nlinks) {\n                navlinks = nlinks\n            }\n\n            if (currentNav.group) {\n                breadcrumbs.push({\n                    title: currentNav.group,\n                    href: \"\", // TODO:\n                })\n            }\n            breadcrumbs.push({\n                // @ts-ignore\n                title,\n                href: page,\n            })\n        }\n\n        return {\n            // @ts-ignore\n            title,\n            href: safePageLink(page),\n            active: false // TODO:\n        }\n    }\n\n    const groups = filteredNav.map((nav) => {\n        // TODO: finish\n        if (\"match\" in nav) {\n            return {\n                group: \"\",\n                items: [],\n            } as FwSidebarGroupProps\n        }\n\n        return {\n            group: nav.group,\n            items: nav.pages?.map((p) => {\n                // @ts-ignore\n                return mapItems(p, nav, filteredNav)\n            }) || [],\n        } as FwSidebarGroupProps\n    }) || []\n\n    return {\n        groups,\n        breadcrumbs,\n        navlinks\n    }\n}\n\nfunction mapNavToLinks(\n    page: string | Sidebar,\n    currentNav: Sidebar,\n    nav: Sidebar[],\n    frontmatters: PageFrontMatter\n): INavLinks | undefined {\n    if (!currentNav.group) {\n        console.error(\"current nav need group to calculate navlinks\")\n        return\n    }\n\n    const currentPageIndex = currentNav?.pages?.findIndex(p => page === p)\n    const foundPageIndex = currentPageIndex != undefined && currentPageIndex !== -1\n\n    if (!foundPageIndex) {\n        return\n    }\n\n    let prev = currentNav?.pages?.[currentPageIndex - 1]\n    let next = currentNav?.pages?.[currentPageIndex + 1]\n\n    if (prev && next) {\n        if (typeof prev !== \"string\" || typeof next !== \"string\") {\n            console.error(\"currently nested pages for navlinks are not supported (step 1)\")\n            return\n        }\n\n        const prevTitle = frontmatters[prev]?.title || \"\"\n        const nextTitle = frontmatters[next]?.title || \"\"\n\n        // prev and next found on same nav (pages)\n        return {\n            prev: {\n                // @ts-ignore\n                title: prevTitle,\n                href: safePageLink(prev),\n            },\n            next: {\n                // @ts-ignore\n                title: nextTitle,\n                href: safePageLink(next),\n            }\n        }\n    }\n\n    const currentNavPosition = nav.findIndex(n => n.group === currentNav.group)\n    const foundNavIndex = currentNavPosition != undefined && currentNavPosition !== -1\n\n    if (!foundNavIndex) {\n        return\n    }\n\n    // search prev in previous nav\n    if (!prev) {\n        const prevNav = nav[currentNavPosition - 1]\n\n        if (prevNav) {\n            const prevNavLastPge = prevNav?.pages?.[prevNav.pages.length - 1]\n\n            if (typeof prevNavLastPge != \"string\") {\n                console.error(\"currently nested pages for navlinks are not supported (step 2)\")\n            } else {\n                prev = prevNavLastPge\n            }\n        }\n    }\n\n    // search next in next nav\n    if (!next) {\n        const nextNav = nav[currentNavPosition + 1]\n\n        if (nextNav) {\n            const nextNavFirstPage = nextNav?.pages?.[0]\n\n            if (typeof nextNavFirstPage != \"string\") {\n                console.error(\"currently nested pages for navlinks are not supported (step 3)\")\n            } else {\n                next = nextNavFirstPage\n            }\n        }\n    }\n\n\n    if (!prev) {\n        if (typeof next == \"string\") {\n            const nextTitle = frontmatters[next]?.title || \"\"\n\n            return {\n                next: {\n                    // @ts-ignore\n                    title: nextTitle,\n                    href: safePageLink(next),\n                },\n            }\n        } else {\n            console.error(\"currently nested pages for navlinks are not supported (step 4)\")\n        }\n    }\n\n    if (!next) {\n        if (typeof prev == \"string\") {\n            const nextTitle = frontmatters[prev]?.title || \"\"\n\n            return {\n                prev: {\n                    // @ts-ignore\n                    title: nextTitle,\n                    href: safePageLink(prev),\n                },\n            }\n        } else {\n            console.error(\"currently nested pages for navlinks are not supported (step 5)\")\n        }\n    }\n\n    if (typeof prev !== \"string\" || typeof next !== \"string\") {\n        console.error(\"currently nested pages for navlinks are not supported (step 6)\")\n        return\n    }\n\n    const prevTitle = frontmatters[prev]?.title || \"\"\n    const nextTitle = frontmatters[next]?.title || \"\"\n\n    return {\n        prev: {\n            // @ts-ignore\n            title: prevTitle,\n            href: safePageLink(prev),\n        },\n        next: {\n            // @ts-ignore\n            title: nextTitle,\n            href: safePageLink(next),\n        }\n    }\n}\n"],"mappings":"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","names":["_a","prevTitle","nextTitle"]}
+{"version":3,"sources":["../packages/hydration/mapSettingsToProps.ts"],"sourcesContent":["// server-only\n\nimport { Sidebar, MetadataMap, Settings, SidebarRoute, Metadata, PageURL } from \"@xyd-js/core\";\nimport { pageFrontMatters } from \"@xyd-js/content\";\nimport { IBreadcrumb, INavLinks } from \"@xyd-js/ui\";\n\nimport { FwSidebarGroupProps } from \"../react\";\n\n// TODO: framework vs content responsibility\n\n// mapSettingsToProps maps @xyd-js/core settings into xyd props\nexport async function mapSettingsToProps(\n    settings: Settings,\n    pagePathMapping: { [key: string]: string },\n    slug: string,\n    frontmatters?: MetadataMap\n): Promise<{\n    groups: FwSidebarGroupProps[],\n    breadcrumbs: IBreadcrumb[]\n    navlinks?: INavLinks\n    hiddenPages?: { [key: string]: boolean }\n    metadata?: Metadata | null\n}> {\n    let uniqIndex = 0\n    const filteredNav = filterNavigation(settings, slug)\n    if (!frontmatters) {\n        frontmatters = await pageFrontMatters(filteredNav, pagePathMapping) as MetadataMap\n    }\n\n    const slugFrontmatter = frontmatters[slug] || null\n    const breadcrumbs: IBreadcrumb[] = []\n    let navlinks: INavLinks | undefined = undefined\n\n    const hiddenPages = Object.keys(frontmatters).reduce((acc, page) => {\n        if (frontmatters[page].hidden) {\n            acc[page] = true\n        }\n\n        return acc\n    }, {})\n\n    function mapItems(\n        page: PageURL,\n        currentNav: Sidebar,\n        nav: Sidebar[]\n    ) {\n        if (!frontmatters) {\n            console.error(\"frontmatters not found\")\n            return null\n        }\n\n        if (typeof page !== \"string\" && !(\"virtual\" in page)) {\n            const items = page.pages\n                ?.map((p) => mapItems(p, page, nav))\n                ?.filter(Boolean)\n\n            if (items?.find(item => normalizeHrefCheck(item.href, slug))) {\n                breadcrumbs.unshift({\n                    title: page.group || \"\",\n                    href: \"\", // TODO:\n                })\n            }\n\n            return {\n                title: page.group,\n                href: \"\",\n                active: false,\n                uniqIndex: uniqIndex++,\n                icon: page.icon,\n                items,\n            }\n        }\n        let pageName = \"\"\n        if (typeof page === \"string\") {\n            pageName = page\n        } else {\n            pageName = page.page\n        }\n\n        if (hiddenPages[pageName]) {\n            return null\n        }\n\n        const matterTitle = frontmatters && frontmatters[pageName] && frontmatters[pageName].title\n\n        let title = \"\"\n\n        if (typeof matterTitle === \"string\") {\n            title = matterTitle\n        } else {\n            // @ts-ignore\n            title = matterTitle\n        }\n\n        if (!title) {\n            console.debug(`⚠️ Title not found for page \"${pageName}\"`)\n        }\n\n        const meta = frontmatters[pageName]\n\n        // TODO: better data structures - for example flat array of filtered nav\n        if (slugFrontmatter && (slugFrontmatter === meta)) {\n            const nlinks = mapNavToLinks(pageName, currentNav, nav, frontmatters, hiddenPages)\n\n            if (nlinks) {\n                navlinks = nlinks\n            }\n\n            if (currentNav.group) {\n                breadcrumbs.push({\n                    title: currentNav.group,\n                    href: \"\", // TODO:\n                })\n            }\n            breadcrumbs.push({\n                // @ts-ignore\n                title,\n                href: pageName,\n            })\n        }\n\n        return {\n            title,\n            href: safePageLink(pageName),\n            active: false,\n            uniqIndex: uniqIndex++,\n            icon: meta?.icon || \"\",\n            sidebarTitle: meta?.sidebarTitle || \"\",\n            pageMeta: meta || null,\n        }\n    }\n\n    const groups = filteredNav\n        .map((nav) => {\n            // TODO: finish\n            if (\"route\" in nav) {\n                if (nav.pages?.length) {\n                    const items = (nav.pages?.map((p) => mapItems(p, nav, filteredNav)) || [])\n                        .filter(Boolean)\n\n                    return {\n                        items\n                    } as FwSidebarGroupProps\n                }\n\n                return {\n                    group: \"\",\n                    items: [],\n                    groupIndex: 0,\n                } as FwSidebarGroupProps\n            }\n\n            const items = (nav.pages?.map((p) => mapItems(p, nav, filteredNav)) || [])\n                .filter(Boolean)\n\n            return {\n                group: nav.group,\n                icon: nav?.icon,\n                items\n            } as FwSidebarGroupProps\n        }) || []\n\n    return {\n        groups,\n        breadcrumbs,\n        navlinks,\n        hiddenPages,\n        metadata: slugFrontmatter\n    }\n}\n\nfunction filterNavigation(settings: Settings, slug: string): Sidebar[] {\n    const sidebarItems: Sidebar[] = []\n\n    let multiSidebarMatch: SidebarRoute | null = null\n\n    let flatPagesOnly = false\n\n    let foundRoute = false\n\n    function findRoute(sidebar: Sidebar | SidebarRoute) {\n        if (\"route\" in sidebar) {\n            const sideMatch = normalizeHref(sidebar.route)\n            const normalizeSlug = normalizeHref(slug)\n\n            // TODO: startWith is not enough e.g `/docs/apps/buildISSUE` if `/docs/apps/build`\n            if (normalizeSlug.startsWith(sideMatch)) {\n                if (multiSidebarMatch) {\n                    const findByMatchLvl = multiSidebarMatch.route.split(\"/\").length\n                    const urlMatchLvl = sideMatch.split(\"/\").length\n\n                    if (urlMatchLvl > findByMatchLvl) {\n                        if (!foundRoute) {\n                            foundRoute = true\n                            sidebarItems.length = 0\n                        }\n                        \n                        multiSidebarMatch = sidebar\n                    }\n                } else {\n                    if (!foundRoute) {\n                        foundRoute = true\n                        sidebarItems.length = 0\n                    }\n                  \n                    multiSidebarMatch = sidebar\n                }\n            }\n\n            if (\"pages\" in sidebar && sidebar.pages?.length) {\n                for (const page of sidebar.pages) {\n                    findRoute(page)\n                }\n            }\n        }\n\n        return\n    }\n\n    settings?.navigation?.sidebar.filter(sidebar => {\n        if (flatPagesOnly) {\n            return\n        }\n        if (typeof sidebar === \"string\") {\n            flatPagesOnly = true\n            return\n        }\n\n        if (\"route\" in sidebar) {\n            findRoute(sidebar)\n\n            return\n        }\n\n        if (foundRoute) {\n            return\n        }\n\n        sidebarItems.push(sidebar)\n    })\n\n    if (multiSidebarMatch != null) {\n        const side = multiSidebarMatch as SidebarRoute\n        sidebarItems.push(...(side?.pages || []))\n    }\n\n    if (flatPagesOnly) {\n        sidebarItems.push({\n            pages: settings?.navigation?.sidebar as string[]\n        })\n    }\n\n    return sidebarItems\n}\n\n// TODO: rename this because it's no longer 'navigation' because it returns breadcrumbs, sidebar and nextlinks props\n// TODO: breadcrumbs and frontmatters as content plugins?\n// TODO: idea - calculate breadcrumbs and navlinks near server-side component?\n\nfunction normalizeHrefCheck(first: string, second: string) {\n    if (first.startsWith(\"/\")) {\n        first = first.slice(1)\n    }\n\n    if (second.startsWith(\"/\")) {\n        second = second.slice(1)\n    }\n\n    return first === second\n}\n\nfunction normalizeHref(href: string) {\n    if (href.startsWith(\"/\")) {\n        return href\n    }\n\n    return `/${href}`\n}\n\nfunction safePageLink(page: string): string {\n    return page?.startsWith(\"/\") ? page : `/${page}`\n}\n\n// TODO: support next-prev for different 'groups' levels\nfunction mapNavToLinks(\n    page: string,\n    currentNav: Sidebar,\n    nav: Sidebar[],\n    frontmatters: MetadataMap,\n    hiddenPages: { [key: string]: boolean }\n): INavLinks | undefined {\n    if (!currentNav.group) {\n        console.debug(\"current nav need group to calculate navlinks\")\n        return\n    }\n\n    // Flatten all pages from all groups to find the sequence\n    const allPages: Array<{ page: string, group: string, groupIndex: number, pageIndex: number }> = []\n\n    nav.forEach((group, groupIndex) => {\n        if (group.pages) {\n            group.pages.forEach((pageItem, pageIndex) => {\n                let pageName = \"\"\n                if (typeof pageItem === \"string\") {\n                    pageName = pageItem\n                } else if (\"virtual\" in pageItem) {\n                    pageName = pageItem.page\n                } else if (\"pages\" in pageItem) {\n                    // This is a nested Sidebar, skip for now as it's not supported\n                    return\n                } else if (\"page\" in pageItem && typeof pageItem === \"object\") {\n                    // This is a VirtualPage object with page property\n                    pageName = (pageItem as { page: string }).page\n                }\n\n                if (pageName && !hiddenPages[pageName]) {\n                    allPages.push({\n                        page: pageName,\n                        group: group.group || \"\",\n                        groupIndex,\n                        pageIndex\n                    })\n                }\n            })\n        }\n    })\n\n    // Find current page in the flattened list\n    const currentPageIndex = allPages.findIndex(p => p.page === page)\n\n    if (currentPageIndex === -1) {\n        return undefined\n    }\n\n    // Get previous and next pages\n    const prevPage = allPages[currentPageIndex - 1]\n    const nextPage = allPages[currentPageIndex + 1]\n\n    let prevLink\n    let nextLink\n\n    if (prevPage) {\n        const prevTitle = frontmatters[prevPage.page]?.title || prevPage.page\n        if (typeof prevTitle === \"string\") {\n            prevLink = {\n                title: prevTitle,\n                href: safePageLink(prevPage.page),\n            }\n        }\n    }\n\n    if (nextPage) {\n        const nextTitle = frontmatters[nextPage.page]?.title || nextPage.page\n        if (typeof nextTitle === \"string\") {\n            nextLink = {\n                title: nextTitle,\n                href: safePageLink(nextPage.page),\n            }\n        }\n    }\n\n    return {\n        prev: prevLink || undefined,\n        next: nextLink || undefined,\n    }\n}\n"],"mappings":"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","names":["items","_a"]}

package/dist/index.d.ts

@@ -1,6 +1,24 @@
-interface ITheme<T> {
-    children: JSX.Element | JSX.Element[];
-    themeSettings?: T;
+import React from 'react';
+
+declare enum SurfaceTarget {
+    NavRight = "nav.right",
+    SidebarTop = "sidebar.top",
+    PageFooterBottom = "page.footer.bottom",
+    SidebarItemLeft = "sidebar.item.left",
+    SidebarItemRight = "sidebar.item.right"
+}
+type SurfaceTargetType = SurfaceTarget | `${SurfaceTarget}`;
+interface SurfaceOptions {
+    append?: boolean;
+}
+interface ROSurface {
+    get(target: SurfaceTargetType): React.JSX.Element | React.JSX.Element[] | undefined;
+}
+declare class Surfaces implements ROSurface {
+    private registry;
+    define(target: SurfaceTargetType, component: React.JSX.Element | React.ComponentType<any>, // TODO: fix any
+    opts?: SurfaceOptions): void;
+    get(target: SurfaceTargetType): React.JSX.Element | React.JSX.Element[] | undefined;
 }
 
-export type { ITheme };
+export { type ROSurface, type SurfaceOptions, SurfaceTarget, type SurfaceTargetType, Surfaces };