@xyd-js/framework 0.1.0-xyd.31 → 0.1.0-xyd.34

package/dist/react.js

@@ -1,298 +1,280 @@
 // packages/react/components/index.tsx
-import React5, { isValidElement } from "react";
-import { useLocation as useLocation3 } from "react-router";
-import { Breadcrumbs, NavLinks } from "@xyd-js/components/writer";
-import { Toc, SubNav, UISidebar as UISidebar2, Nav } from "@xyd-js/ui";
+import React5, { isValidElement, useState as useState3 } from "react";
+import { Link, useLocation as useLocation2, useMatches as useMatches2 } from "react-router";
+import { Nav, SubNav, Toc, UISidebar as UISidebar2 } from "@xyd-js/ui";
+import { Anchor, Breadcrumbs, Button as Button2, ColorSchemeButton, Icon as Icon2, NavLinks, useColorScheme } from "@xyd-js/components/writer";
 
-// packages/react/contexts/framework.tsx
+// packages/react/components/Surfaces.tsx
 import React, { createContext, useContext } from "react";
+var SurfaceTarget = /* @__PURE__ */ ((SurfaceTarget2) => {
+  SurfaceTarget2["NavRight"] = "nav.right";
+  SurfaceTarget2["SidebarTop"] = "sidebar.top";
+  SurfaceTarget2["PageFooterBottom"] = "page.footer.bottom";
+  SurfaceTarget2["SidebarItemLeft"] = "sidebar.item.left";
+  SurfaceTarget2["SidebarItemRight"] = "sidebar.item.right";
+  return SurfaceTarget2;
+})(SurfaceTarget || {});
+var SurfaceContext = createContext({
+  surfaces: void 0
+});
+var Surfaces = class {
+  constructor() {
+    this.registry = {};
+  }
+  define(target, component, opts) {
+    if (opts == null ? void 0 : opts.append) {
+      if (Array.isArray(this.registry[target])) {
+        this.registry[target].push(component);
+        return;
+      }
+      if (this.registry[target]) {
+        this.registry[target] = [this.registry[target], component];
+        return;
+      }
+      this.registry[target] = [component];
+      return;
+    }
+    this.registry[target] = component;
+  }
+  get(target) {
+    return this.registry[target];
+  }
+};
+function Surface(props) {
+  const { target } = props;
+  const registry = useContext(SurfaceContext);
+  if (!registry.surfaces) {
+    return null;
+  }
+  const components = registry.surfaces.get(target);
+  if (!components) {
+    return null;
+  }
+  if (!Array.isArray(components)) {
+    if (typeof components === "function") {
+      const Component = components;
+      return /* @__PURE__ */ React.createElement(Component, { ...props.props });
+    }
+    return /* @__PURE__ */ React.createElement(React.Fragment, null, components);
+  }
+  if (!components.length) {
+    return null;
+  }
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, components.map((Component, index) => {
+    if (typeof Component === "function") {
+      const Comp = Component;
+      return /* @__PURE__ */ React.createElement(Comp, { key: index, ...props.props });
+    }
+    return /* @__PURE__ */ React.createElement(React.Fragment, { key: index }, Component);
+  }));
+}
+
+// packages/react/contexts/framework.tsx
+import React2, { createContext as createContext2, useContext as useContext2, useEffect, useState } from "react";
+import { useNavigation } from "react-router";
+import { ProgressBar } from "@xyd-js/ui";
+import { Banner } from "@xyd-js/components/writer";
 var framework = {
   settings: {},
-  sidebarGroups: []
+  metadata: {
+    title: ""
+  },
+  sidebarGroups: [],
+  setMetadata: () => {
+  }
 };
-var FrameworkContext = createContext(framework);
+var FrameworkContext = createContext2(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
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  const navigation = useNavigation();
+  const [metadata, setMetadata] = useState(props.metadata);
+  const BannerContent = props.BannerContent || null;
+  const BannerComponent = ((_c = (_b = (_a = props == null ? void 0 : props.settings) == null ? void 0 : _a.theme) == null ? void 0 : _b.banner) == null ? void 0 : _c.kind) === "secondary" ? Banner.Secondary : Banner;
+  return /* @__PURE__ */ React2.createElement(React2.Fragment, null, /* @__PURE__ */ React2.createElement(FrameworkContext, { value: {
+    settings: Object.freeze({ ...props.settings }),
+    sidebarGroups: Object.freeze([...props.sidebarGroups]),
+    metadata: Object.freeze({ ...metadata, title: (metadata == null ? void 0 : metadata.title) || "" }),
+    setMetadata
+  } }, /* @__PURE__ */ React2.createElement(SurfaceContext, { value: {
+    surfaces: props.surfaces
+  } }, /* @__PURE__ */ React2.createElement(ProgressBar, { isActive: navigation.state === "loading" }), BannerContent ? /* @__PURE__ */ React2.createElement(
+    BannerComponent,
+    {
+      label: (_f = (_e = (_d = props.settings) == null ? void 0 : _d.theme) == null ? void 0 : _e.banner) == null ? void 0 : _f.label,
+      icon: (_i = (_h = (_g = props.settings) == null ? void 0 : _g.theme) == null ? void 0 : _h.banner) == null ? void 0 : _i.icon
+    },
+    /* @__PURE__ */ React2.createElement(BannerContent, null)
+  ) : null, props.children)));
+}
+var FrameworkPageContext = createContext2({
+  ContentComponent: () => /* @__PURE__ */ React2.createElement(React2.Fragment, null),
+  metadata: {
+    title: ""
+  }
+});
+function FrameworkPage(props) {
+  const { setMetadata } = useContext2(FrameworkContext);
+  useEffect(() => {
+    setMetadata(props.metadata);
+  }, []);
+  return /* @__PURE__ */ React2.createElement(FrameworkPageContext, { value: {
+    ContentComponent: props.ContentComponent || (() => /* @__PURE__ */ React2.createElement(React2.Fragment, null)),
+    metadata: Object.freeze(props.metadata),
+    breadcrumbs: Object.freeze(props.breadcrumbs),
+    rawPage: Object.freeze(props.rawPage),
+    toc: Object.freeze(props.toc || []),
+    navlinks: Object.freeze(props.navlinks)
   } }, props.children);
 }
 function useSidebarGroups() {
-  const ctx = useContext(FrameworkContext);
+  const ctx = useContext2(FrameworkContext);
   return ctx.sidebarGroups;
 }
 function useSettings() {
-  const ctx = useContext(FrameworkContext);
+  const ctx = useContext2(FrameworkContext);
   return ctx.settings;
 }
+function useMetadata() {
+  const ctx = useContext2(FrameworkContext);
+  return ctx.metadata;
+}
 function useToC() {
-  const ctx = useContext(FrameworkContext);
-  return ctx.toc;
+  const ctx = useContext2(FrameworkPageContext);
+  const toc = ctx.toc || [];
+  return toc;
 }
 function useBreadcrumbs() {
-  const ctx = useContext(FrameworkContext);
+  const ctx = useContext2(FrameworkPageContext);
   return ctx.breadcrumbs;
 }
 function useNavLinks() {
-  const ctx = useContext(FrameworkContext);
+  const ctx = useContext2(FrameworkPageContext);
   return ctx.navlinks;
 }
+function useRawPage() {
+  const ctx = useContext2(FrameworkPageContext);
+  return ctx.rawPage;
+}
+function useContentComponent() {
+  const ctx = useContext2(FrameworkPageContext);
+  return ctx.ContentComponent;
+}
 
 // packages/react/components/Sidebar/Sidebar.tsx
-import React3 from "react";
-import { Badge } from "@xyd-js/components/writer";
+import React4 from "react";
 import { UISidebar } from "@xyd-js/ui";
+import { Icon } from "@xyd-js/components/writer";
 
 // packages/react/components/Sidebar/SidebarGroup.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/SidebarGroup.tsx
-var groupContext = createContext3({
+import React3, { createContext as createContext3, useContext as useContext3, useState as useState2, useEffect as useEffect2 } from "react";
+import { useNavigation as useNavigation2 } from "react-router";
+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 FwSidebarGroupContext(props) {
+  const { children, initialActiveItems } = props;
+  const groupBehaviour = useDefaultBehaviour(initialActiveItems);
+  return /* @__PURE__ */ React3.createElement(GroupContext, { value: {
+    active: groupBehaviour
+  } }, 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;
+  return useContext3(GroupContext);
 }
 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 navigation = useNavigation2();
+  const [activeItems, setActiveItems] = useState2(() => createItemsMap(initialActiveItems));
+  const [, setForceUpdate] = useState2(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));
-  };
-  return (item) => [
-    hasItem(item) || false,
-    () => {
-      if (hasItem(item)) {
-        deleteItem(item);
-      } else {
-        addItem(item);
-      }
+  useEffect2(() => {
+    if (navigation.state !== "loading") {
+      setActiveItems(createItemsMap(initialActiveItems));
+      forceUpdate();
     }
-  ];
-}
-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));
+  }, [initialActiveItems, navigation.state]);
+  function addItem(item) {
+    const key = itemId(item);
+    setActiveItems((prev) => {
+      const newMap = new Map(prev);
+      newMap.set(key, true);
+      return newMap;
+    });
     forceUpdate();
-  };
-  const hasItem = (item) => {
-    return weakSet.has(stringify(item));
-  };
-  const clear = () => {
-    weakSet.clear();
+  }
+  function deleteItem(item) {
+    const key = itemId(item);
+    setActiveItems((prev) => {
+      const newMap = new Map(prev);
+      newMap.delete(key);
+      return newMap;
+    });
     forceUpdate();
-  };
-  return (item) => [
-    hasItem(item),
-    () => {
-      setLastLevel(item.level);
-      if (hasItem(item) && item.level == 0) {
-        setLastLevel(false);
-        clear();
-        return;
-      }
-      if (hasItem(item)) {
-        setLastLevel(false);
+  }
+  function hasItem(item) {
+    const key = itemId(item);
+    return activeItems.get(key) || false;
+  }
+  return (item) => {
+    return [
+      hasItem(item) || false,
+      () => {
+        if (!hasItem(item)) {
+          addItem(item);
+          return;
+        }
         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" });
-  }
+function itemId(item) {
+  const id = `${item.uniqIndex}:${item.groupIndex}-${item.level}-${item.itemIndex}`;
+  return id;
+}
+function createItemsMap(items) {
+  const map = /* @__PURE__ */ new Map();
+  items.forEach((item) => {
+    const key = itemId(item);
+    map.set(key, true);
+  });
+  return map;
 }
 
 // packages/react/components/Sidebar/Sidebar.tsx
 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(
+  const icon = props.icon ? /* @__PURE__ */ React4.createElement(Icon, { name: props.icon || "", size: 16 }) : null;
+  return /* @__PURE__ */ React4.createElement(React4.Fragment, null, /* @__PURE__ */ React4.createElement(UISidebar.ItemHeader, { icon }, props.group), props.items.map((item, index) => /* @__PURE__ */ React4.createElement(
     FwSidebarItem,
     {
+      uniqIndex: item.uniqIndex,
+      groupIndex: props.groupIndex,
+      level: 0,
+      itemIndex: index,
       key: index + item.href,
       title: item.title,
+      sidebarTitle: item.sidebarTitle,
+      pageMeta: item.pageMeta,
       href: item.href,
       items: item.items,
       active: item.active,
-      level: 0
+      icon: item.icon
     }
   )));
 }
-var components = {
-  Frontmatter: {
-    // TODO: css
-    Title: ({ children }) => /* @__PURE__ */ React3.createElement("div", { style: {
-      display: "flex",
-      alignItems: "center",
-      width: "100%",
-      gap: "10px"
-    } }, children)
-  },
-  Badge: ({ children, ...rest }) => /* @__PURE__ */ React3.createElement(Badge, { ...rest }, 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, _d;
-  const { active, onClick } = useGroup();
+  const { active } = useGroup();
   const [isActive, setActive] = active(props);
-  let Title;
-  if (typeof props.title === "object" && "code" in props.title) {
-    const code = props.title.code;
-    Title = () => mdxExport(
-      code.replace("() => ", ""),
-      components
-    );
-  } else {
-    Title = () => props.title;
-  }
-  const handleClick = () => {
-    var _a2;
-    if (props.href) {
-      setActive();
-    } else if ((_a2 = props.items) == null ? void 0 : _a2.length) {
-      setActive();
+  const title = props.sidebarTitle || props.title || "";
+  const nested = !!((_a = props.items) == null ? void 0 : _a.length);
+  function handleClick() {
+    if (!nested) {
+      return;
     }
-  };
-  const hasActiveChild = (_a = props.items) == null ? void 0 : _a.some((item) => {
+    setActive();
+  }
+  const hasActiveChild = (_b = props.items) == null ? void 0 : _b.some((item) => {
     var _a2;
     const [itemActive] = active(item);
     return itemActive && item.href || ((_a2 = item.items) == null ? void 0 : _a2.some((subItem) => {
@@ -302,187 +284,190 @@ function FwSidebarItem(props) {
   });
   const isActiveItem = !!(isActive && props.href);
   const isParentActive = hasActiveChild;
-  return /* @__PURE__ */ React3.createElement(
+  const icon = /* @__PURE__ */ React4.createElement(Icon, { name: props.icon || "", size: 16 });
+  return /* @__PURE__ */ React4.createElement(
     UISidebar.Item,
     {
-      button: !!((_b = props.items) == null ? void 0 : _b.length),
+      button: nested,
       href: props.href,
       active: isActiveItem,
       isParentActive,
-      onClick: handleClick
+      onClick: handleClick,
+      icon
     },
-    /* @__PURE__ */ React3.createElement(Title, null),
-    ((_c = props.items) == null ? void 0 : _c.length) && /* @__PURE__ */ React3.createElement(UISidebar.SubTree, { isOpen: isActive }, /* @__PURE__ */ React3.createElement(React3.Fragment, null, (_d = props.items) == null ? void 0 : _d.map((item, index) => /* @__PURE__ */ React3.createElement(
+    /* @__PURE__ */ React4.createElement("div", { part: "item-title-container" }, /* @__PURE__ */ React4.createElement(
+      Surface,
+      {
+        target: "sidebar.item.left",
+        props: {
+          active: isActiveItem,
+          pageMeta: props.pageMeta
+        }
+      }
+    ), /* @__PURE__ */ React4.createElement("div", { part: "item-title" }, title), /* @__PURE__ */ React4.createElement(
+      Surface,
+      {
+        target: "sidebar.item.right",
+        props: {
+          active: isActiveItem,
+          pageMeta: props.pageMeta
+        }
+      }
+    )),
+    ((_c = props.items) == null ? void 0 : _c.length) && /* @__PURE__ */ React4.createElement(UISidebar.SubTree, { isOpen: isActive }, /* @__PURE__ */ React4.createElement(React4.Fragment, null, (_d = props.items) == null ? void 0 : _d.map((item, index) => /* @__PURE__ */ React4.createElement(
       FwSidebarItem,
       {
+        uniqIndex: item.uniqIndex,
+        groupIndex: props.groupIndex,
+        level: (props.level || 0) + 1,
+        itemIndex: index,
         key: index + item.href,
         title: item.title,
         href: item.href,
         items: item.items,
         active: active(item)[0],
-        level: (props.level || 0) + 1
+        icon: item.icon,
+        pageMeta: item.pageMeta
       }
     ))))
   );
 }
 
-// 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}`;
-}
+import { useMatches } from "react-router";
 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) => {
+  const matches = useMatches();
+  const lastMatchId = (_a = matches[matches.length - 1]) == null ? void 0 : _a.id;
+  let matchedSubnav = (_c = (_b = settings.navigation) == null ? void 0 : _b.segments) == null ? void 0 : _c.find((item) => {
     var _a2;
-    return normalizeHref(location.pathname).startsWith(normalizeHref(((_a2 = item.sub) == null ? void 0 : _a2.match) || ""));
+    return (_a2 = item.pages) == null ? void 0 : _a2.find((page) => {
+      return sanitizeUrl(page.page || "") === sanitizeUrl(lastMatchId);
+    });
   });
   if (!matchedSubnav) {
     return null;
   }
-  return matchedSubnav.sub || null;
+  return matchedSubnav || null;
+}
+function sanitizeUrl(url) {
+  if (url.startsWith("/")) {
+    return url;
+  }
+  return `/${url}`;
 }
 
 // packages/react/components/index.tsx
 function FwNavLogo() {
-  var _a, _b, _c;
+  var _a;
   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);
+  const logo = typeof ((_a = settings == null ? void 0 : settings.theme) == null ? void 0 : _a.logo);
+  if (!logo) {
+    return null;
+  }
+  return /* @__PURE__ */ React5.createElement("a", { href: "/" }, /* @__PURE__ */ React5.createElement(FwLogo, null));
 }
 function FwNav({ kind }) {
-  var _a, _b, _c;
+  var _a, _b;
+  const matches = useMatches2();
   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 || ""));
+  const lastMatch = matches[matches.length - 1];
+  const header = ((_a = settings == null ? void 0 : settings.navigation) == null ? void 0 : _a.header) || [];
+  const active = header.find((item) => {
+    if (matchedSubnav) {
+      return pageLink(item.page || "") === pageLink(matchedSubnav == null ? void 0 : matchedSubnav.route);
+    }
+    return pageLink(item.page || "") === (lastMatch == null ? void 0 : lastMatch.id);
+  });
+  function createHeader(item) {
+    return /* @__PURE__ */ React5.createElement(
+      Nav.Item,
+      {
+        key: (item.page || "") + item.page,
+        href: pageLink((item == null ? void 0 : item.page) || ""),
+        value: item.page || "",
+        as: $Link
+      },
+      item.title
+    );
+  }
+  const headerMap = header.reduce((acc, item) => {
+    const float = item.float || "default";
+    return {
+      ...acc,
+      [float]: [...acc[float] || [], createHeader(item)]
+    };
+  }, {});
+  const rightHeaderExists = ((_b = headerMap["right"]) == null ? void 0 : _b.length) > 0;
   return /* @__PURE__ */ React5.createElement(
     Nav,
     {
-      value: (active == null ? void 0 : active.url) || "",
+      value: (active == null ? void 0 : active.page) || "",
       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) => {
-      if (item.sub) {
-        return null;
-      }
-      return /* @__PURE__ */ React5.createElement(
-        Nav.Item,
+      rightSurface: /* @__PURE__ */ React5.createElement(React5.Fragment, null, rightHeaderExists ? /* @__PURE__ */ React5.createElement(
+        Nav.Tab,
         {
-          key: index + (item.url || "") + item.name,
-          href: (item == null ? void 0 : item.url) || "",
-          value: item.url
+          value: (active == null ? void 0 : active.page) || ""
         },
-        item.name
-      );
-    })
+        headerMap["right"]
+      ) : null, /* @__PURE__ */ React5.createElement(Surface, { target: "nav.right" /* NavRight */ }), /* @__PURE__ */ React5.createElement(ColorSchemeButton, null))
+    },
+    headerMap["default"]
   );
 }
 function FwSubNav() {
   const matchedSubnav = useMatchedSubNav();
-  const location = useLocation3();
+  const location = useLocation2();
+  const pathname = trailingSlash(location.pathname);
   if (!matchedSubnav) {
     return null;
   }
-  const active = matchedSubnav == null ? void 0 : matchedSubnav.items.findLast((item) => location.pathname.startsWith(item.url || ""));
+  const active = matchedSubnav == null ? void 0 : matchedSubnav.pages.findLast((item) => {
+    return pathname.startsWith(pageLink(item.page || ""));
+  });
   return /* @__PURE__ */ React5.createElement(
     SubNav,
     {
-      title: (matchedSubnav == null ? void 0 : matchedSubnav.name) || "",
-      value: (active == null ? void 0 : active.url) || "",
+      title: (matchedSubnav == null ? void 0 : matchedSubnav.title) || "",
+      value: (active == null ? void 0 : active.page) || "",
       onChange: () => {
       }
     },
-    matchedSubnav == null ? void 0 : matchedSubnav.items.map((item, index) => {
-      return /* @__PURE__ */ React5.createElement(SubNav.Item, { value: item.url || "", href: item.url }, item.name);
+    matchedSubnav == null ? void 0 : matchedSubnav.pages.map((item, index) => {
+      return /* @__PURE__ */ React5.createElement(
+        SubNav.Item,
+        {
+          value: item.page || "",
+          href: pageLink(item.page || ""),
+          as: $Link
+        },
+        item.title
+      );
     })
   );
 }
-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 location = useLocation2();
+  const pathname = trailingSlash(location.pathname);
   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 footerItems = (_c = (_b = (_a = settings.navigation) == null ? void 0 : _a.anchors) == null ? void 0 : _b.bottom) == null ? void 0 : _c.map((anchor) => {
+    return /* @__PURE__ */ React5.createElement(UISidebar2.FooterItem, { href: anchor.url, icon: /* @__PURE__ */ React5.createElement(Icon2, { name: anchor.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]);
+  groups.forEach((group, groupIndex) => {
+    const activeLevels = recursiveSearch(group.items, pathname) || [];
+    activeLevels.reduce((acc, index, level) => {
+      initialActiveItems.push({
+        ...acc[index],
+        groupIndex,
+        level,
+        itemIndex: index
+      });
       acc[index].active = true;
       return acc[index].items;
     }, group.items);
@@ -491,53 +476,45 @@ function FwSidebarGroups(props) {
   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(
+    /* @__PURE__ */ React5.createElement(UISidebar2, { footerItems: footerItems && footerItems }, /* @__PURE__ */ React5.createElement(Surface, { target: "sidebar.top" /* SidebarTop */ }), groups == null ? void 0 : groups.map((group, index) => /* @__PURE__ */ React5.createElement(
       FwSidebarItemGroup,
       {
         key: index + group.group,
-        ...group
+        ...group,
+        groupIndex: index
       }
     )))
   );
 }
 function FwToc() {
   var _a;
+  const metadata = useMetadata();
+  const settings = useSettings();
   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);
-    });
+  const maxDepth = (metadata == null ? void 0 : metadata.maxTocDepth) || ((_a = settings == null ? void 0 : settings.theme) == null ? void 0 : _a.maxTocDepth) || 2;
+  const renderTocItems = (items, uiDepth = 0) => {
+    return items.map((item) => /* @__PURE__ */ React5.createElement(React5.Fragment, { key: item.id }, /* @__PURE__ */ React5.createElement(
+      Toc.Item,
+      {
+        id: item.id,
+        depth: uiDepth
+      },
+      item.value
+    ), item.children && item.children.length > 0 && renderTocItems(item.children, uiDepth + 1)));
   };
-  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
-  )));
+  return /* @__PURE__ */ React5.createElement(Toc, { maxDepth }, renderTocItems(toc));
 }
 function FwBreadcrumbs() {
-  const breadcrumbs = useBreadcrumbs();
+  const fwBreadcrumbs = useBreadcrumbs();
+  const breadcrumbs = fwBreadcrumbs == null ? void 0 : fwBreadcrumbs.map((item) => ({
+    title: item.title,
+    href: item.href
+  }));
   return /* @__PURE__ */ React5.createElement(
     Breadcrumbs,
     {
@@ -552,113 +529,110 @@ function FwNavLinks() {
       NavLinks,
       {
         prev: navlinks.prev,
-        next: navlinks.next
+        next: navlinks.next,
+        as: $Link
       }
     );
   }
   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 FwLogo() {
+  var _a, _b, _c, _d, _e, _f;
+  const settings = useSettings();
+  const [colorScheme] = useColorScheme();
+  if (typeof ((_a = settings == null ? void 0 : settings.theme) == null ? void 0 : _a.logo) === "string") {
+    return /* @__PURE__ */ React5.createElement("img", { src: (_b = settings == null ? void 0 : settings.theme) == null ? void 0 : _b.logo });
+  }
+  if (isValidElement((_c = settings == null ? void 0 : settings.theme) == null ? void 0 : _c.logo)) {
+    return /* @__PURE__ */ React5.createElement("a", { href: "/" }, (_d = settings == null ? void 0 : settings.theme) == null ? void 0 : _d.logo);
+  }
+  if (typeof ((_e = settings == null ? void 0 : settings.theme) == null ? void 0 : _e.logo) === "object" && colorScheme) {
+    return /* @__PURE__ */ React5.createElement("img", { src: (_f = settings == null ? void 0 : settings.theme) == null ? void 0 : _f.logo[colorScheme] });
+  }
+  return null;
 }
-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 FwLink({ children, ...rest }) {
+  return /* @__PURE__ */ React5.createElement(Anchor, { ...rest, as: $Link }, children);
 }
-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 FwCopyPage() {
+  const [isCopied, setIsCopied] = useState3(false);
+  const rawPage = useRawPage();
+  const handleCopy = () => {
+    navigator.clipboard.writeText(rawPage || "");
+    setIsCopied(true);
+    setTimeout(() => setIsCopied(false), 2e3);
+  };
+  return /* @__PURE__ */ React5.createElement(Button2, { icon: isCopied ? /* @__PURE__ */ React5.createElement(Icon2, { name: "check", size: 12 }) : /* @__PURE__ */ React5.createElement(Icon2, { name: "copy", size: 12 }), onClick: handleCopy }, "Copy page");
+}
+function $Link({ children, ...rest }) {
+  let to = "";
+  if (rest.href) {
+    try {
+      new URL(rest.href);
+      to = rest.href;
+    } catch (error) {
+      if (rest.href.startsWith("/")) {
+        const url = new URL(`https://example.com${rest.href}`);
+        to = {
+          pathname: url.pathname,
+          search: url.search,
+          hash: url.hash
+        };
+      } else {
+        return /* @__PURE__ */ React5.createElement(Anchor, { as: "button", onClick: () => {
+          const url = new URL(window.location.href);
+          const currentParams = url.searchParams;
+          new URLSearchParams(rest.href).forEach((value, key) => {
+            currentParams.set(key, value);
+          });
+          url.search = currentParams.toString();
+          history.replaceState(null, "", url);
+        } }, children);
       }
-    )
-  );
+    }
+  }
+  return /* @__PURE__ */ React5.createElement(Link, { ...rest, to }, children);
 }
-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"
+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 trailingSlash(path) {
+  return path.endsWith("/") ? path.slice(0, -1) : path;
+}
+function pageLink(page) {
+  return page.startsWith("/") ? page : `/${page}`;
 }
 export {
   Framework,
+  FrameworkPage,
   FwBreadcrumbs,
+  FwCopyPage,
+  FwLink,
+  FwLogo,
   FwNav,
   FwNavLinks,
   FwSidebarGroups,
   FwSubNav,
   FwToc,
-  useMatchedSubNav
+  Surface,
+  SurfaceContext,
+  SurfaceTarget,
+  Surfaces,
+  useContentComponent,
+  useMatchedSubNav,
+  useMetadata,
+  useSettings
 };
 //# sourceMappingURL=react.js.map