@xyd-js/framework 0.1.0-xyd.14 → 0.1.0-xyd.16

package/dist/hydration.d.ts

@@ -0,0 +1,11 @@
+import { Settings } from '@xyd-js/core';
+import { IBreadcrumb, INavLinks } from '@xyd-js/ui';
+import { F as FwSidebarGroupProps } from './sidebar-Dwf54qYp.js';
+
+declare function mapSettingsToProps(settings: Settings, slug: string): Promise<{
+    groups: FwSidebarGroupProps[];
+    breadcrumbs: IBreadcrumb[];
+    navlinks?: INavLinks;
+}>;
+
+export { mapSettingsToProps };

package/dist/hydration.js

@@ -0,0 +1,245 @@
+// packages/hydration/settings-to-props.ts
+import { filterNavigationByLevels, pageFrontMatters } from "@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 = 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) {
+  const filteredNav = filterNavigation(settings, slug);
+  const frontmatters = await pageFrontMatters(filteredNav);
+  const slugFrontmatter = frontmatters[slug] || null;
+  const breadcrumbs = [];
+  let navlinks = void 0;
+  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));
+      if (items == null ? void 0 : items.find((item) => normalizeHrefCheck(item.href, slug))) {
+        breadcrumbs.unshift({
+          title: page.group || "",
+          href: ""
+          // TODO:
+        });
+      }
+      return {
+        title: page.group,
+        href: "",
+        active: false,
+        items
+      };
+    }
+    const matterTitle = frontmatters && frontmatters[page] && frontmatters[page].title;
+    let title = "";
+    if (typeof matterTitle === "string") {
+      title = matterTitle;
+    } else {
+      title = matterTitle;
+    }
+    if (!title) {
+      console.error("Title not found for page", page);
+    }
+    if (slugFrontmatter && slugFrontmatter === frontmatters[page]) {
+      const nlinks = mapNavToLinks(page, currentNav, nav, frontmatters);
+      if (nlinks) {
+        navlinks = nlinks;
+      }
+      if (currentNav.group) {
+        breadcrumbs.push({
+          title: currentNav.group,
+          href: ""
+          // TODO:
+        });
+      }
+      breadcrumbs.push({
+        // @ts-ignore
+        title,
+        href: page
+      });
+    }
+    return {
+      // @ts-ignore
+      title,
+      href: safePageLink(page),
+      active: false
+      // TODO:
+    };
+  }
+  const groups = filteredNav.map((nav) => {
+    var _a;
+    if ("match" in nav) {
+      return {
+        group: "",
+        items: []
+      };
+    }
+    return {
+      group: nav.group,
+      items: ((_a = nav.pages) == null ? void 0 : _a.map((p) => {
+        return mapItems(p, nav, filteredNav);
+      })) || []
+    };
+  }) || [];
+  return {
+    groups,
+    breadcrumbs,
+    navlinks
+  };
+}
+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) {
+    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)");
+      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)
+      }
+    };
+  }
+  const currentNavPosition = nav.findIndex((n) => n.group === currentNav.group);
+  const foundNavIndex = currentNavPosition != void 0 && currentNavPosition !== -1;
+  if (!foundNavIndex) {
+    return;
+  }
+  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;
+      }
+    }
+  }
+  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 (!prev) {
+    if (typeof next == "string") {
+      const nextTitle2 = ((_h = frontmatters[next]) == null ? void 0 : _h.title) || "";
+      return {
+        next: {
+          // @ts-ignore
+          title: nextTitle2,
+          href: safePageLink(next)
+        }
+      };
+    } else {
+      console.error("currently nested pages for navlinks are not supported (step 4)");
+    }
+  }
+  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)
+        }
+      };
+    } 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;
+  }
+  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)
+    }
+  };
+}
+export {
+  mapSettingsToProps
+};
+//# sourceMappingURL=hydration.js.map

package/dist/hydration.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../packages/hydration/settings-to-props.ts"],"sourcesContent":["// 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"]}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+
+interface ITheme<T> {
+    children: React.ReactNode;
+    themeSettings?: T;
+}
+
+export type { ITheme };

package/dist/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/react.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import * as _xyd_js_core from '@xyd-js/core';
+import { Settings } from '@xyd-js/core';
+import { ITOC, IBreadcrumb, INavLinks } from '@xyd-js/ui';
+import { F as FwSidebarGroupProps } from './sidebar-Dwf54qYp.js';
+
+declare function FwNav({ kind }: {
+    kind?: "middle";
+}): React.JSX.Element;
+declare function FwSubNav(): React.JSX.Element | null;
+interface FwSidebarGroupsProps {
+    onePathBehaviour?: boolean;
+    clientSideRouting?: boolean;
+}
+declare function FwSidebarGroups(props: FwSidebarGroupsProps): React.JSX.Element;
+declare function FwToc(): React.JSX.Element | null;
+declare function FwBreadcrumbs(): React.JSX.Element;
+declare function FwNavLinks(): React.JSX.Element | null;
+
+interface FrameworkProps {
+    children: React.ReactNode;
+    settings: Settings;
+    sidebarGroups: FwSidebarGroupProps[];
+    toc?: ITOC[];
+    breadcrumbs?: IBreadcrumb[];
+    navlinks?: INavLinks;
+}
+declare function Framework(props: FrameworkProps): React.JSX.Element;
+
+declare function useMatchedSubNav(): _xyd_js_core.SubHeader | null;
+
+export { Framework, type FrameworkProps, FwBreadcrumbs, FwNav, FwNavLinks, FwSidebarGroupProps, FwSidebarGroups, type FwSidebarGroupsProps, FwSubNav, FwToc, useMatchedSubNav };

package/dist/react.js

@@ -0,0 +1,651 @@
+// packages/react/components/index.tsx
+import React5, { isValidElement } from "react";
+import { useLocation as useLocation3 } from "react-router";
+import { Toc, SubNav, UISidebar as UISidebar2 } from "@xyd-js/ui";
+import { Breadcrumbs, NavLinks } from "@xyd-js/components/writer";
+
+// packages/react/contexts/framework.tsx
+import React, { createContext, useContext } from "react";
+var framework = {
+  settings: {},
+  sidebarGroups: []
+};
+var FrameworkContext = createContext(framework);
+function Framework(props) {
+  return /* @__PURE__ */ React.createElement(FrameworkContext.Provider, { value: {
+    settings: props.settings,
+    sidebarGroups: props.sidebarGroups,
+    toc: props.toc,
+    breadcrumbs: props.breadcrumbs,
+    navlinks: props.navlinks
+  } }, props.children);
+}
+function useSidebarGroups() {
+  const ctx = useContext(FrameworkContext);
+  return ctx.sidebarGroups;
+}
+function useSettings() {
+  const ctx = useContext(FrameworkContext);
+  return ctx.settings;
+}
+function useToC() {
+  const ctx = useContext(FrameworkContext);
+  return ctx.toc;
+}
+function useBreadcrumbs() {
+  const ctx = useContext(FrameworkContext);
+  return ctx.breadcrumbs;
+}
+function useNavLinks() {
+  const ctx = useContext(FrameworkContext);
+  return ctx.navlinks;
+}
+
+// packages/react/components/sidebar/sidebar-group.tsx
+import React2, { createContext as createContext3, useContext as useContext2, useEffect, useState } from "react";
+import { useLocation } from "react-router";
+
+// packages/react/contexts/ui.tsx
+import { createContext as createContext2 } from "react";
+var UIContext = createContext2({
+  href: "",
+  setHref: (v) => {
+  }
+});
+
+// packages/react/components/sidebar/sidebar-group.tsx
+var groupContext = createContext3({
+  active: () => [false, () => {
+  }],
+  onClick: () => null
+  // TODO: should be deprecated?
+});
+function FwSidebarGroupContext({
+  children,
+  onePathBehaviour,
+  clientSideRouting,
+  initialActiveItems
+}) {
+  let groupBehaviour;
+  if (onePathBehaviour) {
+    groupBehaviour = useOnePathBehaviour(initialActiveItems);
+  } else {
+    groupBehaviour = useDefaultBehaviour(initialActiveItems);
+  }
+  const location = useLocation();
+  const [href, setHref] = useState(location.pathname);
+  return /* @__PURE__ */ React2.createElement(UIContext.Provider, { value: {
+    href,
+    setHref: (value) => {
+      setHref(value);
+    }
+  } }, /* @__PURE__ */ React2.createElement(groupContext.Provider, { value: {
+    active: groupBehaviour,
+    onClick: clientSideRouting ? (event, item) => {
+      setHref(item.href);
+      scrollToDataSlug(event, item);
+    } : void 0
+  } }, children));
+}
+function useGroup() {
+  return useContext2(groupContext);
+}
+function getLastValue(set) {
+  let value;
+  for (value of set) ;
+  return value;
+}
+function stringify(item) {
+  var _a;
+  return JSON.stringify({
+    title: item.title,
+    href: item.href,
+    items: (_a = item.items) == null ? void 0 : _a.map((item2) => stringify(item2))
+  });
+}
+function recursiveSearch(items, href, levels = []) {
+  for (let i = 0; i < items.length; i++) {
+    const item = items[i];
+    if (item.href === href) {
+      return [...levels, i];
+    }
+    if (item.items) {
+      const result = recursiveSearch(item.items, href, [...levels, i]);
+      if (result) {
+        return result;
+      }
+    }
+  }
+  return null;
+}
+function calcActive(groups, url) {
+  const initialActiveItems = [];
+  groups.forEach((group) => {
+    const activeLevels = recursiveSearch(group.items, url) || [];
+    activeLevels.reduce((acc, index) => {
+      initialActiveItems.push({
+        ...acc[index],
+        active: true
+      });
+      return acc[index].items;
+    }, group.items);
+    return group;
+  });
+  return initialActiveItems;
+}
+function useDefaultBehaviour(initialActiveItems) {
+  const groups = useSidebarGroups();
+  const [weakSet] = useState(() => new Set(initialActiveItems.map((item) => stringify(item))));
+  const [, setForceUpdate] = useState(0);
+  useEffect(() => {
+    window.addEventListener("xyd.history.pushState", (event) => {
+      var _a;
+      const url = (_a = event.detail) == null ? void 0 : _a.url;
+      if (!url) {
+        return;
+      }
+      const active = calcActive(groups, url);
+      weakSet.clear();
+      active.forEach((item) => {
+        addItem(item);
+      });
+    });
+  }, []);
+  const forceUpdate = () => setForceUpdate((prev) => prev + 1);
+  const addItem = (item) => {
+    weakSet.add(stringify(item));
+    forceUpdate();
+  };
+  const deleteItem = (item) => {
+    weakSet.delete(stringify(item));
+    forceUpdate();
+  };
+  const hasItem = (item) => {
+    return weakSet.has(stringify(item));
+  };
+  return (item) => [
+    hasItem(item) || false,
+    () => {
+      if (hasItem(item)) {
+        deleteItem(item);
+      } else {
+        addItem(item);
+      }
+    }
+  ];
+}
+function useOnePathBehaviour(initialActiveItems) {
+  const [weakSet] = useState(() => new Set(initialActiveItems.map((item) => stringify(item))));
+  const [lastLevel, setLastLevel] = useState(false);
+  const [, setForceUpdate] = useState(0);
+  const forceUpdate = () => setForceUpdate((prev) => prev + 1);
+  const addItem = (item) => {
+    weakSet.add(stringify(item));
+    forceUpdate();
+  };
+  const deleteItem = (item) => {
+    weakSet.delete(stringify(item));
+    forceUpdate();
+  };
+  const hasItem = (item) => {
+    return weakSet.has(stringify(item));
+  };
+  const clear = () => {
+    weakSet.clear();
+    forceUpdate();
+  };
+  return (item) => [
+    hasItem(item),
+    () => {
+      setLastLevel(item.level);
+      if (hasItem(item) && item.level == 0) {
+        setLastLevel(false);
+        clear();
+        return;
+      }
+      if (hasItem(item)) {
+        setLastLevel(false);
+        deleteItem(item);
+        return;
+      }
+      if ((item.level || 0) > (lastLevel || 0) || lastLevel == false) {
+        addItem(item);
+      } else {
+        const v = getLastValue(weakSet);
+        deleteItem(JSON.parse(v));
+        addItem(item);
+      }
+    }
+  ];
+}
+function scrollToDataSlug(event, item) {
+  event.preventDefault();
+  const dataSlug = document.querySelector(`[data-slug="${item.href}"]`);
+  if (dataSlug) {
+    dataSlug.scrollIntoView({ block: "start", inline: "nearest" });
+  }
+}
+
+// packages/react/components/sidebar/sidebar.tsx
+import React3 from "react";
+import { Badge } from "@xyd-js/components/writer";
+import { UISidebar } from "@xyd-js/ui";
+function FwSidebarItemGroup(props) {
+  return /* @__PURE__ */ React3.createElement(React3.Fragment, null, /* @__PURE__ */ React3.createElement(UISidebar.ItemHeader, null, props.group), props.items.map((item, index) => /* @__PURE__ */ React3.createElement(
+    FwSidebarItem,
+    {
+      key: index + item.href,
+      title: item.title,
+      href: item.href,
+      items: item.items,
+      active: item.active,
+      level: 0
+    }
+  )));
+}
+var components = {
+  Frontmatter: {
+    // TODO: css
+    Title: ({ children }) => /* @__PURE__ */ React3.createElement("div", { style: {
+      display: "flex",
+      alignItems: "center",
+      justifyContent: "space-between",
+      width: "100%",
+      gap: "10px"
+    } }, children)
+  },
+  Badge: ({ children }) => /* @__PURE__ */ React3.createElement(Badge, null, children)
+};
+function mdxExport(code, components2) {
+  const scope = {
+    Fragment: React3.Fragment,
+    jsxs: React3.createElement,
+    jsx: React3.createElement,
+    jsxDEV: React3.createElement,
+    _jsxs: React3.createElement,
+    _jsx: React3.createElement,
+    ...components2
+  };
+  const fn = new Function(...Object.keys(scope), `return ${code}`);
+  return fn(...Object.values(scope));
+}
+function FwSidebarItem(props) {
+  var _a, _b, _c;
+  const { active, onClick } = useGroup();
+  const [isActive, setActive] = active(props);
+  let Title;
+  if (typeof props.title === "object" && "code" in props.title) {
+    const code = props.title.code;
+    Title = () => mdxExport(
+      // TODO: in the future better mechanism + support props + better components (provider?) - similar to codehik
+      code.replace("() => ", ""),
+      components
+    );
+  } else {
+    Title = () => props.title;
+  }
+  return /* @__PURE__ */ React3.createElement(
+    UISidebar.Item,
+    {
+      button: !!((_a = props.items) == null ? void 0 : _a.length),
+      href: props.href,
+      active: isActive,
+      onClick: () => {
+        setActive();
+      }
+    },
+    /* @__PURE__ */ React3.createElement(Title, null),
+    ((_b = props.items) == null ? void 0 : _b.length) && /* @__PURE__ */ React3.createElement(UISidebar.SubTree, { isOpen: isActive }, /* @__PURE__ */ React3.createElement(React3.Fragment, null, (_c = props.items) == null ? void 0 : _c.map((item, index) => /* @__PURE__ */ React3.createElement(
+      FwSidebarItem,
+      {
+        key: index + item.href,
+        title: item.title,
+        href: item.href,
+        items: item.items,
+        active: active(item)[0],
+        level: (props.level || 0) + 1
+      }
+    ))))
+  );
+}
+
+// packages/react/components/index.tsx
+import { Nav } from "@xyd-js/ui";
+
+// packages/react/utils/manualHydration.ts
+import React4 from "react";
+function manualHydration(obj, key = 0) {
+  if (typeof obj !== "object" || obj === null) {
+    return React4.createElement(React4.Fragment, { key });
+  }
+  const { type, props } = obj || {};
+  if (typeof type !== "string" && typeof type !== "function") {
+    return React4.createElement(React4.Fragment, { key });
+  }
+  let children = [];
+  if (props == null ? void 0 : props.children) {
+    if (Array.isArray(props.children)) {
+      children = props.children.map((child, i) => manualHydration(child, key + i)) || [];
+    } else {
+      children = [manualHydration(props.children, key)];
+    }
+  }
+  const elementProps = { ...props, children, key };
+  return React4.createElement(type, elementProps);
+}
+
+// packages/react/hooks/useMatchedNav.tsx
+import { useLocation as useLocation2 } from "react-router";
+function normalizeHref(href) {
+  if (href.startsWith("/")) {
+    return href;
+  }
+  return `/${href}`;
+}
+function useMatchedSubNav() {
+  var _a, _b, _c;
+  const settings = useSettings();
+  const location = useLocation2();
+  const matchedSubnav = (_c = (_b = (_a = settings.structure) == null ? void 0 : _a.header) == null ? void 0 : _b.filter((item) => item.sub)) == null ? void 0 : _c.find((item) => {
+    var _a2;
+    return normalizeHref(location.pathname).startsWith(normalizeHref(((_a2 = item.sub) == null ? void 0 : _a2.match) || ""));
+  });
+  if (!matchedSubnav) {
+    return null;
+  }
+  return matchedSubnav.sub || null;
+}
+
+// packages/react/components/index.tsx
+function FwNavLogo() {
+  var _a, _b, _c;
+  const settings = useSettings();
+  const logo = isValidElement((_a = settings == null ? void 0 : settings.styling) == null ? void 0 : _a.logo) ? (_b = settings == null ? void 0 : settings.styling) == null ? void 0 : _b.logo : manualHydration((_c = settings == null ? void 0 : settings.styling) == null ? void 0 : _c.logo);
+  return /* @__PURE__ */ React5.createElement("a", { href: "/" }, logo);
+}
+function FwNav({ kind }) {
+  var _a, _b, _c;
+  const matchedSubnav = useMatchedSubNav();
+  const location = useLocation3();
+  const settings = useSettings();
+  const headers = matchedSubnav ? matchedSubnav == null ? void 0 : matchedSubnav.items : (_a = settings == null ? void 0 : settings.structure) == null ? void 0 : _a.header;
+  const active = headers == null ? void 0 : headers.find((item) => location.pathname.startsWith(item.url || ""));
+  return /* @__PURE__ */ React5.createElement(
+    Nav,
+    {
+      value: (active == null ? void 0 : active.url) || "",
+      kind,
+      logo: /* @__PURE__ */ React5.createElement(FwNavLogo, null),
+      onChange: () => {
+      }
+    },
+    (_c = (_b = settings == null ? void 0 : settings.structure) == null ? void 0 : _b.header) == null ? void 0 : _c.map((item, index) => {
+      return /* @__PURE__ */ React5.createElement(
+        Nav.Item,
+        {
+          key: index + (item.url || "") + item.name,
+          href: (item == null ? void 0 : item.url) || "",
+          value: item.url
+        },
+        item.name
+      );
+    })
+  );
+}
+function FwSubNav() {
+  const matchedSubnav = useMatchedSubNav();
+  const location = useLocation3();
+  if (!matchedSubnav) {
+    return null;
+  }
+  const active = matchedSubnav == null ? void 0 : matchedSubnav.items.findLast((item) => location.pathname.startsWith(item.url || ""));
+  return /* @__PURE__ */ React5.createElement(
+    SubNav,
+    {
+      title: (matchedSubnav == null ? void 0 : matchedSubnav.name) || "",
+      value: (active == null ? void 0 : active.url) || "",
+      onChange: () => {
+      }
+    },
+    matchedSubnav == null ? void 0 : matchedSubnav.items.map((item, index) => {
+      return /* @__PURE__ */ React5.createElement(SubNav.Item, { value: item.url || "", href: item.url }, item.name);
+    })
+  );
+}
+function recursiveSearch2(items, href, levels = []) {
+  for (let i = 0; i < items.length; i++) {
+    const item = items[i];
+    if (item.href === href) {
+      return [...levels, i];
+    }
+    if (item.items) {
+      const result = recursiveSearch2(item.items, href, [...levels, i]);
+      if (result) {
+        return result;
+      }
+    }
+  }
+  return null;
+}
+function FwSidebarGroups(props) {
+  var _a, _b, _c;
+  const groups = useSidebarGroups();
+  const settings = useSettings();
+  const footerItems = (_c = (_b = (_a = settings.structure) == null ? void 0 : _a.anchors) == null ? void 0 : _b.bottom) == null ? void 0 : _c.map((anchor) => {
+    let icon;
+    if (typeof anchor.icon === "string") {
+      switch (anchor.icon) {
+        case "icon-cookbook": {
+          icon = /* @__PURE__ */ React5.createElement(IconCookbook, null);
+          break;
+        }
+        case "icon-community": {
+          icon = /* @__PURE__ */ React5.createElement(IconCommunity, null);
+          break;
+        }
+        case "icon-marketplace": {
+          icon = /* @__PURE__ */ React5.createElement(IconMarketplace, null);
+          break;
+        }
+        case "icon-sdk": {
+          icon = /* @__PURE__ */ React5.createElement(IconSDK, null);
+          break;
+        }
+        default: {
+          icon = null;
+        }
+      }
+    } else {
+      icon = isValidElement(anchor.icon) ? anchor.icon : manualHydration(anchor.icon);
+    }
+    return /* @__PURE__ */ React5.createElement(UISidebar2.FooterItem, { href: anchor.url, icon }, anchor.name);
+  });
+  const location = useLocation3();
+  const initialActiveItems = [];
+  groups.forEach((group) => {
+    const activeLevels = recursiveSearch2(group.items, location.pathname) || [];
+    activeLevels.reduce((acc, index) => {
+      initialActiveItems.push(acc[index]);
+      acc[index].active = true;
+      return acc[index].items;
+    }, group.items);
+    return group;
+  });
+  return /* @__PURE__ */ React5.createElement(
+    FwSidebarGroupContext,
+    {
+      onePathBehaviour: props.onePathBehaviour,
+      clientSideRouting: props.clientSideRouting,
+      initialActiveItems
+    },
+    /* @__PURE__ */ React5.createElement(UISidebar2, { footerItems: footerItems && footerItems }, groups == null ? void 0 : groups.map((group, index) => /* @__PURE__ */ React5.createElement(
+      FwSidebarItemGroup,
+      {
+        key: index + group.group,
+        ...group
+      }
+    )))
+  );
+}
+function FwToc() {
+  var _a;
+  const toc = useToC();
+  if (!toc) {
+    return null;
+  }
+  const flatToc = [];
+  const flatten = (toc2) => {
+    if (!toc2) {
+      return;
+    }
+    toc2.forEach((item) => {
+      flatToc.push({
+        depth: item.depth,
+        value: item.value
+      });
+      flatten(item.children);
+    });
+  };
+  flatten(toc);
+  const tocFinal = flatToc.filter((item) => item.depth === 2);
+  const location = useLocation3();
+  const defaultValue = location.hash ? location.hash.replace("#", "") : (_a = tocFinal[0]) == null ? void 0 : _a.value;
+  return /* @__PURE__ */ React5.createElement(Toc, { defaultValue }, tocFinal.map((item, index) => /* @__PURE__ */ React5.createElement(
+    Toc.Item,
+    {
+      key: index + item.value + item.depth,
+      value: item.value
+    },
+    item.value
+  )));
+}
+function FwBreadcrumbs() {
+  const breadcrumbs = useBreadcrumbs();
+  return /* @__PURE__ */ React5.createElement(
+    Breadcrumbs,
+    {
+      items: breadcrumbs || []
+    }
+  );
+}
+function FwNavLinks() {
+  var _a, _b;
+  const navlinks = useNavLinks();
+  if (typeof ((_a = navlinks == null ? void 0 : navlinks.prev) == null ? void 0 : _a.title) !== "string" || typeof ((_b = navlinks == null ? void 0 : navlinks.next) == null ? void 0 : _b.title) !== "string") {
+    return null;
+  }
+  if ((navlinks == null ? void 0 : navlinks.prev) || (navlinks == null ? void 0 : navlinks.next)) {
+    return /* @__PURE__ */ React5.createElement(
+      NavLinks,
+      {
+        prev: navlinks.prev,
+        next: navlinks.next
+      }
+    );
+  }
+  return null;
+}
+function IconCookbook() {
+  return /* @__PURE__ */ React5.createElement(
+    "svg",
+    {
+      xmlns: "http://www.w3.org/2000/svg",
+      viewBox: "0 0 24 24",
+      width: "1em",
+      height: "1em"
+    },
+    /* @__PURE__ */ React5.createElement(
+      "path",
+      {
+        fillRule: "evenodd",
+        d: "M14.447 7.106a1 1 0 0 1 .447 1.341l-4 8a1 1 0 1 1-1.788-.894l4-8a1 1 0 0 1 1.341-.447ZM6.6 7.2a1 1 0 0 1 .2 1.4L4.25 12l2.55 3.4a1 1 0 0 1-1.6 1.2l-3-4a1 1 0 0 1 0-1.2l3-4a1 1 0 0 1 1.4-.2Zm10.8 0a1 1 0 0 1 1.4.2l3 4a1 1 0 0 1 0 1.2l-3 4a1 1 0 0 1-1.6-1.2l2.55-3.4-2.55-3.4a1 1 0 0 1 .2-1.4Z",
+        clipRule: "evenodd"
+      }
+    )
+  );
+}
+function IconCommunity() {
+  return /* @__PURE__ */ React5.createElement(
+    "svg",
+    {
+      xmlns: "http://www.w3.org/2000/svg",
+      fill: "currentColor",
+      viewBox: "0 0 24 24",
+      width: "1em",
+      height: "1em"
+    },
+    /* @__PURE__ */ React5.createElement(
+      "path",
+      {
+        fillRule: "evenodd",
+        d: "M10.5 8.5a1.5 1.5 0 1 1 3 0 1.5 1.5 0 0 1-3 0ZM12 5a3.5 3.5 0 1 0 0 7 3.5 3.5 0 0 0 0-7ZM3 9.5a1 1 0 1 1 2 0 1 1 0 0 1-2 0Zm1-3a3 3 0 1 0 0 6 3 3 0 0 0 0-6Zm16 2a1 1 0 1 0 0 2 1 1 0 0 0 0-2Zm-3 1a3 3 0 1 1 6 0 3 3 0 0 1-6 0ZM8 18c0-.974.438-1.684 1.142-2.185C9.876 15.293 10.911 15 12 15c1.09 0 2.124.293 2.858.815.704.5 1.142 1.21 1.142 2.185a1 1 0 1 0 2 0c0-1.692-.812-2.982-1.983-3.815C14.876 13.373 13.411 13 12 13c-1.41 0-2.876.373-4.017 1.185C6.812 15.018 6 16.308 6 18a1 1 0 1 0 2 0Zm-3.016-3.675a1 1 0 0 1-.809 1.16C2.79 15.732 2 16.486 2 17.5a1 1 0 1 1-2 0c0-2.41 1.978-3.655 3.825-3.985a1 1 0 0 1 1.16.81Zm14.84 1.16a1 1 0 1 1 .351-1.97C22.022 13.845 24 15.09 24 17.5a1 1 0 1 1-2 0c0-1.014-.79-1.768-2.175-2.015Z",
+        clipRule: "evenodd"
+      }
+    )
+  );
+}
+function IconMarketplace() {
+  return /* @__PURE__ */ React5.createElement(
+    "svg",
+    {
+      xmlns: "http://www.w3.org/2000/svg",
+      viewBox: "0 0 24 24",
+      fill: "none",
+      width: "1em",
+      height: "1em"
+    },
+    /* @__PURE__ */ React5.createElement(
+      "path",
+      {
+        "fill-rule": "evenodd",
+        "clip-rule": "evenodd",
+        d: "M3.78163 3.28449C3.8768 2.96725 4.16879 2.75 4.5 2.75H19.5C19.8312 2.75 20.1232 2.96725 20.2184 3.28449L21.7184 8.28449C21.7393 8.3544 21.75 8.42701 21.75 8.5C21.75 10.5711 20.0711 12.25 18 12.25C16.7733 12.25 15.6842 11.661 15 10.7504C14.3158 11.661 13.2267 12.25 12 12.25C10.7733 12.25 9.68417 11.661 9 10.7504C8.31583 11.661 7.2267 12.25 6 12.25C3.92893 12.25 2.25 10.5711 2.25 8.5C2.25 8.42701 2.26066 8.3544 2.28163 8.28449L3.78163 3.28449ZM9.75 8.5C9.75 9.74264 10.7574 10.75 12 10.75C13.2426 10.75 14.25 9.74264 14.25 8.5C14.25 8.08579 14.5858 7.75 15 7.75C15.4142 7.75 15.75 8.08579 15.75 8.5C15.75 9.74264 16.7574 10.75 18 10.75C19.2083 10.75 20.1942 9.79754 20.2477 8.60244L18.942 4.25H5.05802L3.75229 8.60244C3.80584 9.79753 4.79169 10.75 6 10.75C7.24264 10.75 8.25 9.74264 8.25 8.5C8.25 8.08579 8.58579 7.75 9 7.75C9.41421 7.75 9.75 8.08579 9.75 8.5Z"
+      }
+    ),
+    /* @__PURE__ */ React5.createElement(
+      "path",
+      {
+        "fill-rule": "evenodd",
+        "clip-rule": "evenodd",
+        d: "M4 10.25C4.41421 10.25 4.75 10.5858 4.75 11V19.75H6.5C6.91421 19.75 7.25 20.0858 7.25 20.5C7.25 20.9142 6.91421 21.25 6.5 21.25H4C3.58579 21.25 3.25 20.9142 3.25 20.5V11C3.25 10.5858 3.58579 10.25 4 10.25ZM20 10.25C20.4142 10.25 20.75 10.5858 20.75 11V20.5C20.75 20.9142 20.4142 21.25 20 21.25H10.5C10.0858 21.25 9.75 20.9142 9.75 20.5C9.75 20.0858 10.0858 19.75 10.5 19.75H19.25V11C19.25 10.5858 19.5858 10.25 20 10.25Z"
+      }
+    ),
+    /* @__PURE__ */ React5.createElement(
+      "path",
+      {
+        d: "M12.003 19C11.31 18.9996 10.6384 18.7598 10.102 18.3213C9.56564 17.8829 9.19745 17.2726 9.05983 16.594C8.92222 15.9154 9.02364 15.2101 9.34693 14.5976C9.67022 13.9852 10.1955 13.5032 10.8337 13.2333C11.5673 12.9262 12.393 12.9221 13.1296 13.2222C13.8661 13.5222 14.4536 14.1018 14.7631 14.8338C15.0727 15.5659 15.0791 16.3907 14.7808 17.1274C14.4827 17.8642 13.9042 18.4527 13.1724 18.7641C12.8025 18.9205 12.4047 19.0007 12.003 19ZM11.1458 14.7215C11.1124 14.7215 11.0803 14.7348 11.0567 14.7584C11.0331 14.782 11.0198 14.8141 11.0198 14.8475V17.1923C11.0198 17.2258 11.0331 17.2578 11.0567 17.2814C11.0803 17.305 11.1124 17.3183 11.1458 17.3183C11.1671 17.3183 11.188 17.3128 11.2065 17.3024L13.3399 16.13C13.3597 16.1192 13.3761 16.1032 13.3876 16.0838C13.3991 16.0644 13.4052 16.0423 13.4052 16.0197C13.4052 15.9972 13.3991 15.9751 13.3876 15.9557C13.3761 15.9362 13.3597 15.9203 13.3399 15.9094L11.2063 14.7373C11.1879 14.727 11.1671 14.7215 11.1458 14.7215Z"
+      }
+    )
+  );
+}
+function IconSDK() {
+  return /* @__PURE__ */ React5.createElement(
+    "svg",
+    {
+      viewBox: "0 0 15 15",
+      xmlns: "http://www.w3.org/2000/svg",
+      width: "1em",
+      height: "1em"
+    },
+    /* @__PURE__ */ React5.createElement(
+      "path",
+      {
+        d: "M7.28856 0.796908C7.42258 0.734364 7.57742 0.734364 7.71144 0.796908L13.7114 3.59691C13.8875 3.67906 14 3.85574 14 4.05V10.95C14 11.1443 13.8875 11.3209 13.7114 11.4031L7.71144 14.2031C7.57742 14.2656 7.42258 14.2656 7.28856 14.2031L1.28856 11.4031C1.11252 11.3209 1 11.1443 1 10.95V4.05C1 3.85574 1.11252 3.67906 1.28856 3.59691L7.28856 0.796908ZM2 4.80578L7 6.93078V12.9649L2 10.6316V4.80578ZM8 12.9649L13 10.6316V4.80578L8 6.93078V12.9649ZM7.5 6.05672L12.2719 4.02866L7.5 1.80176L2.72809 4.02866L7.5 6.05672Z",
+        fill: "currentColor",
+        fillRule: "evenodd",
+        clipRule: "evenodd"
+      }
+    )
+  );
+}
+export {
+  Framework,
+  FwBreadcrumbs,
+  FwNav,
+  FwNavLinks,
+  FwSidebarGroups,
+  FwSubNav,
+  FwToc,
+  useMatchedSubNav
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../packages/react/components/index.tsx","../packages/react/contexts/framework.tsx","../packages/react/components/sidebar/sidebar-group.tsx","../packages/react/contexts/ui.tsx","../packages/react/components/sidebar/sidebar.tsx","../packages/react/utils/manualHydration.ts","../packages/react/hooks/useMatchedNav.tsx"],"sourcesContent":["import React, {isValidElement} from \"react\";\nimport {useLocation} from \"react-router\";\n\nimport {Toc, SubNav, UISidebar} from \"@xyd-js/ui\"\nimport type {ITOC} from \"@xyd-js/ui\";\nimport {Breadcrumbs, NavLinks} from \"@xyd-js/components/writer\";\n\nimport {useBreadcrumbs, useNavLinks, useSettings, useSidebarGroups, useToC} from \"../contexts\";\nimport {FwSidebarItemGroup, FwSidebarGroupContext, FwSidebarItemProps} from \"./sidebar\";\nimport {Nav} from \"@xyd-js/ui\";\n\nimport {manualHydration} from \"../utils/manualHydration\";\nimport {useMatchedSubNav} from \"../hooks\";\n\nfunction FwNavLogo() {\n    const settings = useSettings()\n\n    const logo = isValidElement(settings?.styling?.logo) ? settings?.styling?.logo : manualHydration(settings?.styling?.logo)\n\n    // TODO: configurable url?\n    return <a href=\"/\">\n        {logo}\n    </a>\n}\n\nfunction FwNav({kind}: { kind?: \"middle\" }) {\n    const matchedSubnav = useMatchedSubNav()\n    const location = useLocation()\n\n    const settings = useSettings()\n\n    const headers = matchedSubnav ? matchedSubnav?.items : settings?.structure?.header\n    const active = headers?.find(item => location.pathname.startsWith(item.url || \"\"))\n\n    return <Nav\n        value={active?.url || \"\"}\n        kind={kind}\n        logo={<FwNavLogo/>}\n        onChange={() => {\n        }}\n    >\n        {\n            settings?.structure?.header?.map((item, index) => {\n                return <Nav.Item\n                    key={index + (item.url || \"\") + item.name}\n                    href={item?.url || \"\"}\n                    value={item.url}\n                >\n                    {item.name}\n                </Nav.Item>\n            })\n        }\n    </Nav>\n}\n\nfunction FwSubNav() {\n    const matchedSubnav = useMatchedSubNav()\n    const location = useLocation()\n\n    if (!matchedSubnav) {\n        return null\n    }\n\n    // TODO: in the future routing props from settings like {match: \"/docs/api/browser\"}\n    const active = matchedSubnav?.items.findLast(item => location.pathname.startsWith(item.url || \"\"))\n\n    // TODO: value\n    return <SubNav\n        title={matchedSubnav?.name || \"\"}\n        value={active?.url || \"\"}\n        onChange={() => {\n        }}\n    >\n        {matchedSubnav?.items.map((item, index) => {\n            return <SubNav.Item value={item.url || \"\"} href={item.url}>\n                {item.name}\n            </SubNav.Item>\n        })}\n    </SubNav>\n\n}\n\nexport interface FwSidebarGroupsProps {\n    onePathBehaviour?: boolean\n    clientSideRouting?: boolean\n}\n\nfunction recursiveSearch(items: FwSidebarItemProps[], href: string, levels: any[] = []) {\n    for (let i = 0; i < items.length; i++) {\n        const item = items[i]\n\n        if (item.href === href) {\n            return [...levels, i]\n        }\n\n        if (item.items) {\n            const result = recursiveSearch(item.items, href, [...levels, i])\n            if (result) {\n                return result\n            }\n        }\n    }\n    return null\n}\n\nfunction FwSidebarGroups(props: FwSidebarGroupsProps) {\n    const groups = useSidebarGroups()\n\n    const settings = useSettings()\n\n    const footerItems = settings.structure?.anchors?.bottom?.map(anchor => {\n        let icon\n\n        // TODO: refactor this !!!\n        if (typeof anchor.icon === \"string\") {\n            switch (anchor.icon) {\n                case \"icon-cookbook\": {\n                    icon = <IconCookbook/>\n                    break\n                }\n\n                case \"icon-community\": {\n                    icon = <IconCommunity/>\n                    break\n                }\n\n                case \"icon-marketplace\": {\n                    icon = <IconMarketplace/>\n                    break\n                }\n\n                case \"icon-sdk\": {\n                    icon = <IconSDK/>\n                    break\n                }\n\n                default: {\n                    icon = null\n                }\n            }\n        } else {\n            icon = isValidElement(anchor.icon) ? anchor.icon : manualHydration(anchor.icon)\n        }\n\n        return <UISidebar.FooterItem href={anchor.url} icon={icon}>\n            {anchor.name}\n        </UISidebar.FooterItem>\n    })\n\n    const location = useLocation()\n    const initialActiveItems: any[] = []\n    groups.forEach(group => {\n        const activeLevels = recursiveSearch(group.items, location.pathname) || []\n\n        activeLevels.reduce((acc, index) => {\n            initialActiveItems.push(acc[index])\n            acc[index].active = true\n            return acc[index].items\n        }, group.items)\n\n        return group\n    })\n\n    return <FwSidebarGroupContext\n        onePathBehaviour={props.onePathBehaviour}\n        clientSideRouting={props.clientSideRouting}\n        initialActiveItems={initialActiveItems}\n    >\n        <UISidebar footerItems={footerItems && footerItems}>\n            {\n                groups?.map((group, index) => <FwSidebarItemGroup\n                    key={index + group.group}\n                    {...group}\n                />)\n            }\n        </UISidebar>\n    </FwSidebarGroupContext>\n}\n\ntype FlatTOC = {\n    depth: number\n    value: string\n}\n\nfunction FwToc() {\n    const toc = useToC()\n\n    if (!toc) {\n        return null\n    }\n\n    const flatToc: FlatTOC[] = []\n\n    const flatten = (toc?: ITOC[]) => {\n        if (!toc) {\n            return\n        }\n\n        toc.forEach(item => {\n            flatToc.push({\n                depth: item.depth,\n                value: item.value\n            })\n\n            flatten(item.children)\n        })\n    }\n\n    flatten(toc)\n\n    // TODO: its temporary\n    const tocFinal = flatToc.filter(item => item.depth === 2)\n\n    const location = useLocation()\n\n    // TODO: better in the future\n    const defaultValue = location.hash ? location.hash.replace(\"#\", \"\") : tocFinal[0]?.value\n\n    return <Toc defaultValue={defaultValue}>\n        {\n            tocFinal.map((item, index) => <Toc.Item\n                key={index + item.value + item.depth}\n                value={item.value}\n            >\n                {item.value}\n            </Toc.Item>)\n        }\n    </Toc>\n}\n\n// TODO: finish\nfunction FwBreadcrumbs() {\n    const breadcrumbs = useBreadcrumbs()\n\n    return <Breadcrumbs\n        items={breadcrumbs || []}\n    />\n}\n\n// TDOO: finish\nfunction FwNavLinks() {\n    const navlinks = useNavLinks()\n\n    // TODO: in the future - because of custom react frontmatter\n    if (typeof navlinks?.prev?.title !== \"string\" || typeof navlinks?.next?.title !== \"string\") {\n        return null\n    }\n\n    if (navlinks?.prev || navlinks?.next) {\n        return <NavLinks\n            prev={navlinks.prev}\n            next={navlinks.next}\n        />\n    }\n\n    return null\n}\n\n// TODO: issues with below svgs inside settigns - REFACTOR THIS\nfunction IconCookbook() {\n    return <svg\n        xmlns=\"http://www.w3.org/2000/svg\"\n        viewBox=\"0 0 24 24\"\n        width=\"1em\"\n        height=\"1em\"\n    >\n        <path\n            fillRule=\"evenodd\"\n            d=\"M14.447 7.106a1 1 0 0 1 .447 1.341l-4 8a1 1 0 1 1-1.788-.894l4-8a1 1 0 0 1 1.341-.447ZM6.6 7.2a1 1 0 0 1 .2 1.4L4.25 12l2.55 3.4a1 1 0 0 1-1.6 1.2l-3-4a1 1 0 0 1 0-1.2l3-4a1 1 0 0 1 1.4-.2Zm10.8 0a1 1 0 0 1 1.4.2l3 4a1 1 0 0 1 0 1.2l-3 4a1 1 0 0 1-1.6-1.2l2.55-3.4-2.55-3.4a1 1 0 0 1 .2-1.4Z\"\n            clipRule=\"evenodd\"\n        />\n    </svg>\n}\n\nfunction IconCommunity() {\n    return <svg\n        xmlns=\"http://www.w3.org/2000/svg\"\n        fill=\"currentColor\"\n        viewBox=\"0 0 24 24\"\n        width=\"1em\"\n        height=\"1em\"\n    >\n        <path\n            fillRule=\"evenodd\"\n            d=\"M10.5 8.5a1.5 1.5 0 1 1 3 0 1.5 1.5 0 0 1-3 0ZM12 5a3.5 3.5 0 1 0 0 7 3.5 3.5 0 0 0 0-7ZM3 9.5a1 1 0 1 1 2 0 1 1 0 0 1-2 0Zm1-3a3 3 0 1 0 0 6 3 3 0 0 0 0-6Zm16 2a1 1 0 1 0 0 2 1 1 0 0 0 0-2Zm-3 1a3 3 0 1 1 6 0 3 3 0 0 1-6 0ZM8 18c0-.974.438-1.684 1.142-2.185C9.876 15.293 10.911 15 12 15c1.09 0 2.124.293 2.858.815.704.5 1.142 1.21 1.142 2.185a1 1 0 1 0 2 0c0-1.692-.812-2.982-1.983-3.815C14.876 13.373 13.411 13 12 13c-1.41 0-2.876.373-4.017 1.185C6.812 15.018 6 16.308 6 18a1 1 0 1 0 2 0Zm-3.016-3.675a1 1 0 0 1-.809 1.16C2.79 15.732 2 16.486 2 17.5a1 1 0 1 1-2 0c0-2.41 1.978-3.655 3.825-3.985a1 1 0 0 1 1.16.81Zm14.84 1.16a1 1 0 1 1 .351-1.97C22.022 13.845 24 15.09 24 17.5a1 1 0 1 1-2 0c0-1.014-.79-1.768-2.175-2.015Z\"\n            clipRule=\"evenodd\"\n        />\n    </svg>\n}\n\n// TODO: but this svg works on settings\nfunction IconMarketplace() {\n    return <svg\n        xmlns=\"http://www.w3.org/2000/svg\"\n        viewBox=\"0 0 24 24\"\n        fill=\"none\"\n        width=\"1em\"\n        height=\"1em\"\n    >\n        <path fill-rule=\"evenodd\" clip-rule=\"evenodd\"\n              d=\"M3.78163 3.28449C3.8768 2.96725 4.16879 2.75 4.5 2.75H19.5C19.8312 2.75 20.1232 2.96725 20.2184 3.28449L21.7184 8.28449C21.7393 8.3544 21.75 8.42701 21.75 8.5C21.75 10.5711 20.0711 12.25 18 12.25C16.7733 12.25 15.6842 11.661 15 10.7504C14.3158 11.661 13.2267 12.25 12 12.25C10.7733 12.25 9.68417 11.661 9 10.7504C8.31583 11.661 7.2267 12.25 6 12.25C3.92893 12.25 2.25 10.5711 2.25 8.5C2.25 8.42701 2.26066 8.3544 2.28163 8.28449L3.78163 3.28449ZM9.75 8.5C9.75 9.74264 10.7574 10.75 12 10.75C13.2426 10.75 14.25 9.74264 14.25 8.5C14.25 8.08579 14.5858 7.75 15 7.75C15.4142 7.75 15.75 8.08579 15.75 8.5C15.75 9.74264 16.7574 10.75 18 10.75C19.2083 10.75 20.1942 9.79754 20.2477 8.60244L18.942 4.25H5.05802L3.75229 8.60244C3.80584 9.79753 4.79169 10.75 6 10.75C7.24264 10.75 8.25 9.74264 8.25 8.5C8.25 8.08579 8.58579 7.75 9 7.75C9.41421 7.75 9.75 8.08579 9.75 8.5Z\"\n        />\n        <path fill-rule=\"evenodd\" clip-rule=\"evenodd\"\n              d=\"M4 10.25C4.41421 10.25 4.75 10.5858 4.75 11V19.75H6.5C6.91421 19.75 7.25 20.0858 7.25 20.5C7.25 20.9142 6.91421 21.25 6.5 21.25H4C3.58579 21.25 3.25 20.9142 3.25 20.5V11C3.25 10.5858 3.58579 10.25 4 10.25ZM20 10.25C20.4142 10.25 20.75 10.5858 20.75 11V20.5C20.75 20.9142 20.4142 21.25 20 21.25H10.5C10.0858 21.25 9.75 20.9142 9.75 20.5C9.75 20.0858 10.0858 19.75 10.5 19.75H19.25V11C19.25 10.5858 19.5858 10.25 20 10.25Z\"\n        />\n        <path\n            d=\"M12.003 19C11.31 18.9996 10.6384 18.7598 10.102 18.3213C9.56564 17.8829 9.19745 17.2726 9.05983 16.594C8.92222 15.9154 9.02364 15.2101 9.34693 14.5976C9.67022 13.9852 10.1955 13.5032 10.8337 13.2333C11.5673 12.9262 12.393 12.9221 13.1296 13.2222C13.8661 13.5222 14.4536 14.1018 14.7631 14.8338C15.0727 15.5659 15.0791 16.3907 14.7808 17.1274C14.4827 17.8642 13.9042 18.4527 13.1724 18.7641C12.8025 18.9205 12.4047 19.0007 12.003 19ZM11.1458 14.7215C11.1124 14.7215 11.0803 14.7348 11.0567 14.7584C11.0331 14.782 11.0198 14.8141 11.0198 14.8475V17.1923C11.0198 17.2258 11.0331 17.2578 11.0567 17.2814C11.0803 17.305 11.1124 17.3183 11.1458 17.3183C11.1671 17.3183 11.188 17.3128 11.2065 17.3024L13.3399 16.13C13.3597 16.1192 13.3761 16.1032 13.3876 16.0838C13.3991 16.0644 13.4052 16.0423 13.4052 16.0197C13.4052 15.9972 13.3991 15.9751 13.3876 15.9557C13.3761 15.9362 13.3597 15.9203 13.3399 15.9094L11.2063 14.7373C11.1879 14.727 11.1671 14.7215 11.1458 14.7215Z\"\n        />\n    </svg>\n}\n\nfunction IconSDK() {\n    return <svg\n        viewBox=\"0 0 15 15\"\n        xmlns=\"http://www.w3.org/2000/svg\"\n        width=\"1em\"\n        height=\"1em\"\n    >\n        <path\n            d=\"M7.28856 0.796908C7.42258 0.734364 7.57742 0.734364 7.71144 0.796908L13.7114 3.59691C13.8875 3.67906 14 3.85574 14 4.05V10.95C14 11.1443 13.8875 11.3209 13.7114 11.4031L7.71144 14.2031C7.57742 14.2656 7.42258 14.2656 7.28856 14.2031L1.28856 11.4031C1.11252 11.3209 1 11.1443 1 10.95V4.05C1 3.85574 1.11252 3.67906 1.28856 3.59691L7.28856 0.796908ZM2 4.80578L7 6.93078V12.9649L2 10.6316V4.80578ZM8 12.9649L13 10.6316V4.80578L8 6.93078V12.9649ZM7.5 6.05672L12.2719 4.02866L7.5 1.80176L2.72809 4.02866L7.5 6.05672Z\"\n            fill=\"currentColor\"\n            fillRule=\"evenodd\"\n            clipRule=\"evenodd\"\n        />\n    </svg>\n}\n\nexport {\n    FwNav,\n    FwSubNav,\n\n    FwBreadcrumbs,\n    FwToc,\n    FwNavLinks,\n\n    FwSidebarGroups,\n}\n","import React, {createContext, useContext} from \"react\";\n\nimport {Settings} from \"@xyd-js/core\";\nimport type {ITOC, IBreadcrumb, INavLinks} from \"@xyd-js/ui\";\n\nimport {FwSidebarGroupProps} from \"../components/sidebar\";\n\nexport interface IFramework {\n    settings: Settings\n\n    sidebarGroups: FwSidebarGroupProps[]\n\n    toc?: ITOC[]\n\n    breadcrumbs?: IBreadcrumb[]\n\n    navlinks?: INavLinks\n}\n\n// TODO: page context + app context?\nconst framework: IFramework = {\n    settings: {},\n    sidebarGroups: []\n}\nconst FrameworkContext = createContext<IFramework>(framework)\n\nexport interface FrameworkProps {\n    children: React.ReactNode\n\n    settings: Settings,\n    sidebarGroups: FwSidebarGroupProps[],\n    toc?: ITOC[],\n    breadcrumbs?: IBreadcrumb[],\n    navlinks?: INavLinks\n}\n\nexport function Framework(props: FrameworkProps) {\n    return <FrameworkContext.Provider value={{\n        settings: props.settings,\n        sidebarGroups: props.sidebarGroups,\n        toc: props.toc,\n        breadcrumbs: props.breadcrumbs,\n        navlinks: props.navlinks,\n    }}>\n        {props.children}\n    </FrameworkContext.Provider>\n}\n\n\nexport function useSidebarGroups() {\n    const ctx = useContext(FrameworkContext)\n\n    return ctx.sidebarGroups\n}\n\nexport function useSettings() {\n    const ctx = useContext(FrameworkContext)\n\n    return ctx.settings\n}\n\nexport function useToC() {\n    const ctx = useContext(FrameworkContext)\n\n    return ctx.toc\n}\n\nexport function useBreadcrumbs() {\n    const ctx = useContext(FrameworkContext)\n\n    return ctx.breadcrumbs\n}\n\nexport function useNavLinks() {\n    const ctx = useContext(FrameworkContext)\n\n    return ctx.navlinks\n}\n","import React, {createContext, useContext, useEffect, useState} from \"react\";\nimport {useLocation, useNavigation, useNavigate} from \"react-router\";\n\nimport {FwSidebarGroupProps, FwSidebarItemProps} from \"./sidebar\";\nimport {UIContext} from \"../../contexts/ui\";\nimport {useSidebarGroups} from \"../../contexts\";\n\n\nexport interface FwGroupContext {\n    active: (item: FwSidebarItemProps) => [boolean, () => void],\n    onClick?: (event: React.MouseEvent<HTMLAnchorElement, MouseEvent>, item: FwSidebarItemProps) => void,\n}\n\ntype GroupBehaviour = (item: FwSidebarItemProps) => [boolean, () => void]\n\nconst groupContext = createContext<FwGroupContext>({\n    active: () => [false, () => {\n    }],\n    onClick: () => null // TODO: should be deprecated?\n})\n\nexport function FwSidebarGroupContext({\n                                          children,\n                                          onePathBehaviour,\n                                          clientSideRouting,\n                                          initialActiveItems,\n                                      }:\n                                      {\n                                          children: React.ReactNode,\n                                          onePathBehaviour?: boolean,\n                                          clientSideRouting?: boolean // TODO: scrollRouting?,\n                                          initialActiveItems: any[]\n                                      }) {\n\n    let groupBehaviour: GroupBehaviour\n\n    if (onePathBehaviour) {\n        groupBehaviour = useOnePathBehaviour(initialActiveItems)\n    } else {\n        groupBehaviour = useDefaultBehaviour(initialActiveItems)\n    }\n    const location = useLocation()\n\n    const [href, setHref] = useState(location.pathname)\n\n    return <UIContext.Provider value={{\n        href: href,\n        setHref: (value) => {\n            setHref(value)\n        }\n    }}>\n        <groupContext.Provider value={{\n            active: groupBehaviour,\n            onClick: clientSideRouting ? (event, item) => {\n                setHref(item.href)\n                scrollToDataSlug(event, item)\n                // navigate(item.href)\n            } : undefined\n        }}>\n            {children}\n        </groupContext.Provider>\n    </UIContext.Provider>\n}\n\nexport function useGroup() {\n    return useContext(groupContext)\n}\n\n\n// TODO: !!! better algorithm (JSON.stringify is not good) !!!!!\n// TODO: !!!! use array structure instad! !!!\n\nfunction getLastValue(set) {\n    let value;\n    for (value of set) ;\n    return value;\n}\n\nfunction stringify(item: FwSidebarItemProps) {\n    return JSON.stringify({\n        title: item.title,\n        href: item.href,\n        items: item.items?.map((item) => stringify(item)),\n    })\n}\n\nfunction recursiveSearch(items: FwSidebarItemProps[], href: string, levels: any[] = []) {\n    for (let i = 0; i < items.length; i++) {\n        const item = items[i]\n\n        if (item.href === href) {\n            return [...levels, i]\n        }\n\n        if (item.items) {\n            const result = recursiveSearch(item.items, href, [...levels, i])\n            if (result) {\n                return result\n            }\n        }\n    }\n    return null\n}\n\nfunction calcActive(groups: FwSidebarGroupProps[], url: any) {\n    const initialActiveItems: any[] = []\n\n    groups.forEach(group => {\n        const activeLevels = recursiveSearch(group.items, url) || []\n\n        activeLevels.reduce((acc, index) => {\n            initialActiveItems.push({\n                ...acc[index],\n                active: true\n            })\n            return acc[index].items\n        }, group.items)\n\n        return group\n    })\n\n    return initialActiveItems\n}\n\nfunction useDefaultBehaviour(initialActiveItems: any[]) {\n    const groups = useSidebarGroups()\n    const [weakSet] = useState(() => new Set<string>(initialActiveItems.map((item) => stringify(item))));\n    const [, setForceUpdate] = useState(0);\n\n    useEffect(() => {\n        window.addEventListener('xyd.history.pushState', (event: CustomEvent) => {\n            const url = event.detail?.url\n\n            if (!url) {\n                return\n            }\n            // TODO: better data structures\n            const active = calcActive(groups, url)\n            weakSet.clear()\n            active.forEach((item) => {\n                addItem(item)\n            })\n        });\n    }, [])\n\n    const forceUpdate = () => setForceUpdate((prev) => prev + 1);\n\n    const addItem = (item: FwSidebarItemProps) => {\n        weakSet.add(stringify(item));\n        forceUpdate();\n    };\n\n    const deleteItem = (item: FwSidebarItemProps) => {\n        weakSet.delete(stringify(item));\n        forceUpdate();\n    };\n\n    const hasItem = (item: FwSidebarItemProps) => {\n        return weakSet.has(stringify(item));\n    };\n\n    return (item: FwSidebarItemProps): [boolean, () => void] => [\n        hasItem(item) || false,\n        () => {\n            if (hasItem(item)) {\n                deleteItem(item);\n            } else {\n                addItem(item);\n            }\n        }\n    ]\n}\n\nfunction useOnePathBehaviour(initialActiveItems: any[]) {\n    const [weakSet] = useState(() => new Set<string>(initialActiveItems.map((item) => stringify(item))));\n    const [lastLevel, setLastLevel] = useState<false | number | undefined>(false);\n    const [, setForceUpdate] = useState(0);\n\n    const forceUpdate = () => setForceUpdate((prev) => prev + 1);\n\n    const addItem = (item: FwSidebarItemProps) => {\n        weakSet.add(stringify(item));\n        forceUpdate();\n    };\n\n    const deleteItem = (item: FwSidebarItemProps) => {\n        weakSet.delete(stringify(item));\n        forceUpdate();\n    };\n\n    const hasItem = (item: FwSidebarItemProps) => {\n        return weakSet.has(stringify(item));\n    };\n\n    const clear = () => {\n        weakSet.clear();\n        forceUpdate();\n    };\n\n    return (item: FwSidebarItemProps): [boolean, () => void] => [\n        hasItem(item),\n        () => {\n            setLastLevel(item.level)\n            if (hasItem(item) && item.level == 0) {\n                setLastLevel(false)\n                clear()\n                return\n            }\n\n            if (hasItem(item)) {\n                setLastLevel(false)\n                deleteItem(item);\n                return\n            }\n\n\n            if (((item.level || 0) > (lastLevel || 0)) || lastLevel == false) {\n                addItem(item)\n            } else {\n                const v = getLastValue(weakSet)\n                deleteItem(JSON.parse(v))\n                addItem(item)\n            }\n        }\n    ]\n}\n\nfunction scrollToDataSlug(event: React.MouseEvent<HTMLAnchorElement, MouseEvent>, item: FwSidebarItemProps) {\n    event.preventDefault()\n\n    // TODO: find another solution because data-slug is added by 'atlas'\n\n    const dataSlug = document.querySelector(`[data-slug=\"${item.href}\"]`)\n\n    if (dataSlug) {\n        dataSlug.scrollIntoView({block: \"start\", inline: \"nearest\"})\n    }\n}\n\n\n","import {createContext} from 'react';\n\nexport const UIContext = createContext({\n    href: '',\n    setHref: (v: any) => {}\n});","import React, {} from \"react\"\n\nimport {Badge} from \"@xyd-js/components/writer\"\nimport {UISidebar} from \"@xyd-js/ui\";\n\nimport {useGroup} from \"./sidebar-group\";\n\n// TODO: custom hooks for active onclick handler etc?\n\nexport interface FwSidebarGroupProps {\n    group: string\n\n    items: FwSidebarItemProps[]\n}\n\nexport function FwSidebarItemGroup(props: FwSidebarGroupProps) {\n    return <>\n        <UISidebar.ItemHeader>\n            {props.group}\n        </UISidebar.ItemHeader>\n\n        {props.items.map((item, index) => <FwSidebarItem\n            key={index + item.href}\n            title={item.title}\n            href={item.href}\n            items={item.items}\n            active={item.active}\n            level={0}\n        />)}\n    </>\n}\n\nexport interface FwSidebarItemProps {\n    title: string | {\n        code: string\n    }\n\n    href: string\n\n    items?: FwSidebarItemProps[]\n\n    active?: boolean\n\n    // internal\n    readonly level?: number\n    // internal\n}\n\n// TODO: move to @xyd-js/components/content\nconst components = {\n    Frontmatter: {\n        // TODO: css\n        Title: ({children}) => <div style={{\n            display: \"flex\",\n            alignItems: \"center\",\n            justifyContent: \"space-between\",\n            width: \"100%\",\n            gap: \"10px\",\n        }}>\n            {children}\n        </div>,\n    },\n    Badge: ({children}) => <Badge>\n        {children}\n    </Badge>\n}\n\nfunction mdxExport(code: string, components: any) {\n    const scope = {\n        Fragment: React.Fragment,\n        jsxs: React.createElement,\n        jsx: React.createElement,\n        jsxDEV: React.createElement,\n        _jsxs: React.createElement,\n        _jsx: React.createElement,\n        ...components\n    }\n    const fn = new Function(...Object.keys(scope), `return ${code}`)\n    return fn(...Object.values(scope))\n}\n\nfunction FwSidebarItem(props: FwSidebarItemProps) {\n    const {active, onClick} = useGroup()\n    const [isActive, setActive] = active(props)\n\n    let Title: any\n\n    if (typeof props.title === \"object\" && \"code\" in props.title) {\n        const code = props.title.code\n\n        Title = () => mdxExport(\n            // TODO: in the future better mechanism + support props + better components (provider?) - similar to codehik\n            code.replace(\"() => \", \"\"),\n            components\n        )\n    } else {\n        Title = () => props.title\n    }\n\n    return <UISidebar.Item\n        button={!!props.items?.length}\n        href={props.href}\n        active={isActive}\n        onClick={() => {\n            setActive()\n        }}\n    >\n        <Title/>\n\n        {\n            props.items?.length && <UISidebar.SubTree isOpen={isActive}>\n                <>\n                    {\n                        props.items?.map((item, index) => <FwSidebarItem\n                            key={index + item.href}\n                            title={item.title}\n                            href={item.href}\n                            items={item.items}\n                            active={active(item)[0]}\n                            level={(props.level || 0) + 1}\n                        />)\n                    }\n                </>\n            </UISidebar.SubTree>\n        }\n    </UISidebar.Item>\n}\n","import React, {ReactElement} from \"react\";\n\nexport function manualHydration(obj: any, key = 0): ReactElement<any, string | React.JSXElementConstructor<any>> {\n    if (typeof obj !== 'object' || obj === null) {\n        return React.createElement(React.Fragment, {key});\n    }\n\n    const {type, props} = obj || {};\n    if (typeof type !== 'string' && typeof type !== 'function') {\n        return React.createElement(React.Fragment, {key});\n    }\n\n    let children: ReactElement<any, string | React.JSXElementConstructor<any>>[] = [];\n    if (props?.children) {\n        if (Array.isArray(props.children)) {\n            children = props.children.map((child: any, i) => manualHydration(child, key + i)) || [];\n        } else {\n            children = [manualHydration(props.children, key)];\n        }\n    }\n\n    const elementProps = {...props, children, key};\n\n    return React.createElement(type, elementProps);\n}","import {useLocation} from \"react-router\";\n\nimport {useSettings} from \"../contexts\";\n\nimport {manualHydration} from \"../utils/manualHydration\";\n\nfunction normalizeHref(href: string) {\n    if (href.startsWith(\"/\")) {\n        return href\n    }\n\n    return `/${href}`\n}\n\n// TODO: better data structures\nexport function useMatchedSubNav() {\n    const settings = useSettings()\n    const location = useLocation()\n\n    const matchedSubnav = settings.structure?.header\n        ?.filter(item => item.sub)\n        ?.find(item => normalizeHref(location.pathname).startsWith(normalizeHref(item.sub?.match || \"\")))\n\n    if (!matchedSubnav) {\n        return null\n    }\n\n    return matchedSubnav.sub || null\n}\n"],"mappings":"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","names":["React","useLocation","UISidebar","React","createContext","useContext","createContext","createContext","React","useContext","item","React","React","components","React","useLocation","useLocation","_a","React","useLocation","recursiveSearch","UISidebar","toc"]}

package/dist/sidebar-Dwf54qYp.d.ts

@@ -0,0 +1,15 @@
+interface FwSidebarGroupProps {
+    group: string;
+    items: FwSidebarItemProps[];
+}
+interface FwSidebarItemProps {
+    title: string | {
+        code: string;
+    };
+    href: string;
+    items?: FwSidebarItemProps[];
+    active?: boolean;
+    readonly level?: number;
+}
+
+export type { FwSidebarGroupProps as F };

package/package.json

@@ -1,20 +1,26 @@
 {
   "name": "@xyd-js/framework",
-  "version": "0.1.0-xyd.14",
+  "version": "0.1.0-xyd.16",
   "description": "",
-  "main": "dist/index.js",
   "type": "module",
+  "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     "./package.json": "./package.json",
     "./index.css": "./dist/index.css",
-    ".": "./dist/index.js",
-    "./hydration": "./dist/hydration.js",
-    "./react": "./dist/react.js"
+    ".": {
+      "import": "./dist/index.js"
+    },
+    "./hydration": {
+      "import": "./dist/hydration.js"
+    },
+    "./react": {
+      "import": "./dist/react.js"
+    }
   },
   "files": [
-    "dist",
-    "package.json"
+    "package.json",
+    "dist"
   ],
   "author": "",
   "dependencies": {},
@@ -22,10 +28,10 @@
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-router": "^7.1.1",
-    "@xyd-js/components": "0.1.0-xyd.1",
+    "@xyd-js/core": "0.1.0-xyd.2",
     "@xyd-js/ui": "0.1.0-xyd.4",
-    "@xyd-js/content": "0.1.0-xyd.4",
-    "@xyd-js/core": "0.1.0-xyd.2"
+    "@xyd-js/components": "0.1.0-xyd.1",
+    "@xyd-js/content": "0.1.0-xyd.4"
   },
   "devDependencies": {
     "@babel/preset-react": "^7.24.7",