hyperbook 0.76.2 → 0.77.1

package/dist/assets/content.css

@@ -100,8 +100,8 @@ figure {
   clear: both;
   justify-items: center;
   align-content: center;
-  margin-top: 10px;
-  margin-bottom: 10px;
+  margin-top: 0;
+  margin-bottom: var(--element-gap);
 }
 
 .hyperbook-markdown figure.normal img {
@@ -177,7 +177,7 @@ figure {
 }
 
 .hyperbook-markdown li>p {
-  margin-top: 16px;
+  margin: 0;
 }
 
 .hyperbook-markdown p,
@@ -188,12 +188,23 @@ figure {
 .hyperbook-markdown pre,
 .hyperbook-markdown details {
   margin-top: 0;
-  margin-bottom: 10px;
+  margin-bottom: var(--element-gap);
+}
+
+.hyperbook-markdown figure[data-rehype-pretty-code-figure] {
+  margin-top: 0;
+  margin-bottom: var(--element-gap);
+}
+
+.hyperbook-markdown [class^="directive-"],
+.hyperbook-markdown [class*=" directive-"] {
+  margin-top: 0;
+  margin-bottom: var(--element-gap);
 }
 
 .hyperbook-markdown blockquote {
   width: 90%;
-  margin: 20px auto;
+  margin: 0 auto var(--element-gap) auto;
   font-style: italic;
   padding: 1.2em 30px 1.2em 75px;
   border-left: 8px solid var(--color-brand);
@@ -215,6 +226,10 @@ figure {
   content: "";
 }
 
+.hyperbook-markdown blockquote p:last-child {
+  margin-bottom: 0;
+}
+
 .hyperbook-markdown table {
   display: block;
   border-collapse: collapse;
@@ -252,8 +267,8 @@ figure {
 .hyperbook-markdown h6 {
   clear: both;
   font-family: hyperbook-heading, sans-serif;
-  margin-top: 24px;
-  margin-bottom: 16px;
+  margin-top: 0;
+  margin-bottom: var(--element-gap);
   font-weight: 600;
   line-height: 1.25;
 }
@@ -293,7 +308,7 @@ figure {
 
 .hyperbook-markdown p {
   margin-top: 0;
-  margin-bottom: 10px;
+  margin-bottom: var(--element-gap);
 }
 
 .hyperbook-markdown h1,

package/dist/assets/dark.css

@@ -24,6 +24,18 @@ header {
   background-color: var(--color-brand) !important;
 }
 
+nav.breadcrumb {
+  color: color-mix(in srgb, var(--color-text), black 35%) !important;
+}
+
+nav.breadcrumb a {
+  color: color-mix(in srgb, var(--color-text), black 35%) !important;
+}
+
+nav.breadcrumb a:hover {
+  color: var(--color-brand) !important;
+}
+
 figure[data-rehype-pretty-code-figure] pre,
 code[data-theme*=" "],
 code[data-theme*=" "] span {
@@ -63,3 +75,4 @@ color: rgb(253, 224, 71) !important;
 background-color: #6b21a880 !important;
 color: rgb(233, 213, 255) !important;
 }
+

package/dist/assets/directive-alert/style.css

@@ -4,7 +4,11 @@
 }
 
 .directive-alert>p {
-  margin-bottom: 10px;
+  margin-bottom: 0;
+}
+
+.directive-alert>p:last-child {
+  margin-bottom: 0;
 }
 
 .directive-alert {
@@ -14,17 +18,16 @@
   font-size: inherit;
   line-height: 1.6rem;
   word-spacing: 0.05rem;
-  border-bottom-right-radius: 2px;
-  border-top-right-radius: 2px;
-  padding: 8px 12px 8px 20px;
-  margin-bottom: 16px;
+  border-bottom-right-radius: 0.16rem;
+  border-top-right-radius: 0.16rem;
+  padding: 0.5rem 0.7rem 0.5rem 1.2rem;
   position: relative;
-  border-left-width: 4px;
+  border-left-width: 0.25rem;
   border-left-style: solid;
   background-color: var(--color-nav);
   border-left-color: var(--alert-color);
   border-left-style: solid;
-  border-left-width: 4px;
+  border-left-width: 0.25rem;
 
   a,
   strong {
@@ -44,14 +47,14 @@
   border-radius: 100%;
   font-size: 0.875rem;
   font-weight: 700;
-  left: -14px;
+  left: -0.9rem;
   display: flex;
   align-items: center;
   justify-content: center;
   position: absolute;
-  height: 24px;
-  width: 24px;
-  top: 8px;
+  height: 1.5rem;
+  width: 1.5rem;
+  top: 0.5rem;
   color: #fff;
   content: var(--alert-content);
   background-color: var(--alert-color);

package/dist/assets/directive-archive/style.css

@@ -6,7 +6,6 @@
   border-radius: 4px;
   border-style: solid;
   border-width: 1px;
-  margin-bottom: 10px;
 }
 
 .directive-archive:hover {

package/dist/assets/directive-audio/style.css

@@ -1,7 +1,3 @@
-.directive-audio {
-  margin-bottom: 16px;
-}
-
 .directive-audio .information {
   margin-top: 4px;
   text-align: center;

package/dist/assets/directive-collapsible/style.css

@@ -12,7 +12,7 @@
   font-size: 100%;
   padding: 8px 16px;
   border-radius: 4px;
-  margin-bottom: 10px;
+  margin-bottom: 0;
   list-style: none;
   color: var(--color-text);
   border-color: var(--color-spacer);
@@ -49,7 +49,7 @@
 
 .directive-collapsible .content {
   border-top: none;
-  margin-bottom: 10px;
+  margin-bottom: 0;
 }
 
 .directive-collapsible[open] .content {
@@ -59,7 +59,7 @@
   border-top: none;
   padding: 6px 12px;
   padding-top: 12px;
-  margin-bottom: 10px;
+  margin-bottom: 0;
   border-bottom-left-radius: 4px;
   border-bottom-right-radius: 4px;
   border-color: var(--color-spacer);

package/dist/assets/directive-download/style.css

@@ -6,7 +6,6 @@
   border-radius: 4px;
   border-style: solid;
   border-width: 1px;
-  margin-bottom: 10px;
 }
 
 .directive-download:hover {

package/dist/assets/directive-embed/style.css

@@ -1,5 +1,4 @@
 .directive-embed {
-  margin-bottom: 8px;
   width: 100%;
   position: relative;
   overflow: hidden;

package/dist/assets/directive-excalidraw/style.css

@@ -5,6 +5,5 @@
   border-color: var(--color-spacer);
   width: 100%;
   position: relative;
-  margin-bottom: 10px;
   overflow: hidden;
 }

package/dist/assets/directive-h5p/style.css

@@ -5,7 +5,3 @@
   padding: 8px;
   background-color: #fefefe;
 }
-
-.directive-h5p {
-  margin-bottom: 8px;
-}

package/dist/assets/directive-jsxgraph/style.css

@@ -1,7 +1,6 @@
 .directive-jsxgraph {
     background: white;
-    margin-bottom: 16px;
     border-radius: 8px;
     justify-content: center;
-    margin: 12px auto;
+    margin: 0 auto;
 }

package/dist/assets/directive-onlineide/style.css

@@ -1,5 +1,4 @@
 .directive-onlineide {
-  margin-bottom: 10px;
   border: 1px solid var(--color-spacer);
   border-radius: 8px;
   background: #1e1e1e;

package/dist/assets/directive-p5/style.css

@@ -3,7 +3,6 @@
   justify-content: center;
   align-items: center;
   flex-direction: column;
-  margin-bottom: 16px;
   overflow: hidden;
   gap: 8px;
 }

package/dist/assets/directive-pyide/style.css

@@ -3,7 +3,6 @@
   justify-content: center;
   align-items: center;
   flex-direction: column;
-  margin-bottom: 16px;
   overflow: hidden;
   gap: 8px;
 }

package/dist/assets/directive-qr/style.css

@@ -4,7 +4,6 @@
   border-radius: 8px;
   width: fit-content;
   text-align: center;
-  margin-bottom: 10px;
 }
 
 .directive-qr .code {

package/dist/assets/directive-slideshow/style.css

@@ -1,5 +1,4 @@
 .directive-slideshow {
-  margin-bottom: 8px;
   position: relative;
 }
 

package/dist/assets/directive-sqlide/style.css

@@ -1,5 +1,4 @@
 .directive-sqlide {
-  margin-bottom: 10px;
   border: 1px solid var(--color-spacer);
   border-radius: 8px;
   background: #1e1e1e;

package/dist/assets/directive-struktog/style.css

@@ -1,6 +1,4 @@
 .directive-struktog {
-  margin-top: 8px;
-  margin-bottom: 8px;
   overflow: hidden;
 }
 

package/dist/assets/directive-tabs/style.css

@@ -41,7 +41,7 @@
   border-style: solid;
   border-width: 1px;
   border-top: none;
-  margin-bottom: 12px;
+  margin-bottom: 0;
   border-bottom-right-radius: 4px;
   border-bottom-left-radius: 4px;
   border-color: var(--color-spacer);

package/dist/assets/directive-tiles/style.css

@@ -89,6 +89,8 @@
   bottom: 0.5rem;
   right: 0.5rem;
   font-size: 2rem;
+  line-height: normal;
+  text-align: center;
   pointer-events: none;
 }
 

package/dist/assets/directive-typst/style.css

@@ -3,7 +3,6 @@
   justify-content: center;
   align-items: center;
   flex-direction: column;
-  margin-bottom: 16px;
   overflow: hidden;
   gap: 8px;
   height: calc(100dvh - 128px);

package/dist/assets/directive-video/style.css

@@ -1,7 +1,3 @@
-.directive-video {
-  margin-bottom: 16px;
-}
-
 .directive-video .information {
   margin-top: 4px;
   text-align: center;

package/dist/assets/directive-webide/style.css

@@ -3,7 +3,6 @@
   justify-content: center;
   align-items: center;
   flex-direction: column;
-  margin-bottom: 16px;
   overflow: hidden;
   gap: 8px;
 }

package/dist/assets/shell.css

@@ -4,7 +4,7 @@
 
 .main-grid * {
   box-sizing: border-box;
-  line-height: 1.5;
+  line-height: 1.5rem;
 }
 
 .main-grid {
@@ -356,11 +356,51 @@ main {
   overflow-y: auto;
 }
 
+/* Breadcrumb Navigation */
+nav.breadcrumb {
+  max-width: var(--main-width);
+  color: color-mix(in srgb, var(--color-text), white 35%);
+  margin: 0 auto;
+  margin-bottom: var(--element-gap);
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.25rem;
+  font-size: 0.9rem;
+}
+
+nav.breadcrumb a {
+  color: color-mix(in srgb, var(--color-text), white 35%);
+  text-decoration: none;
+}
+
+nav.breadcrumb a:hover {
+  color: var(--color-brand);
+  text-decoration: underline;
+}
+
+nav.breadcrumb .breadcrumb-separator {
+  margin: 0 4px;
+}
+
+nav.breadcrumb .breadcrumb-empty {
+  font-style: italic;
+}
+
+nav.breadcrumb .breadcrumb-current {
+  font-weight: 500;
+}
+
+nav.breadcrumb .breadcrumb-home,
+nav.breadcrumb .breadcrumb-current {
+  text-decoration: none;
+}
+
 article {
   max-width: var(--main-width);
   margin: 0 auto;
   grid-area: article;
-  line-height: 1.5;
+  line-height: 1.5rem;
 }
 
 header {
@@ -544,10 +584,10 @@ header {
   display: flex;
   align-items: center;
   justify-content: center;
-  margin-right: 10px;
-  height: 40px;
+  margin-right: 0.625rem;
+  height: 2.5rem;
   width: auto;
-  min-width: 40px;
+  min-width: 2.5rem;
 }
 
 .branding .logo img {
@@ -565,7 +605,7 @@ header {
   display: flex;
   max-width: var(--main-width);
   margin: 0 auto;
-  margin-top: 40px;
+  margin-top: 2.5rem;
   clear: both;
 }
 
@@ -899,3 +939,7 @@ nav.toc li.level-3 {
 .main-grid.layout-standalone #custom-links-footer {
   display: none;
 }
+
+.main-grid.layout-standalone .breadcrumb {
+  display: none;
+}

package/dist/index.js

@@ -56005,6 +56005,7 @@ const fs_2 = __importDefault(__nccwpck_require__(79896));
 const mime_1 = __importDefault(__nccwpck_require__(94931));
 const ws_1 = __nccwpck_require__(55999);
 const chalk_1 = __importDefault(__nccwpck_require__(2434));
+const rimraf_1 = __nccwpck_require__(52114);
 async function runDev({ port = 8080 }) {
     const root = process.cwd();
     const rootProject = await fs_1.hyperproject.get(root);
@@ -56113,12 +56114,18 @@ window.onload = () => {
         });
     });
     let rebuilding = false;
-    const rebuild = (status) => async (file) => {
+    const rebuild = (status, shouldClean = false) => async (file) => {
         if (!rebuilding) {
             console.log(`${chalk_1.default.yellow(`[Rebuilding ${status}]`)}: ${file}.`);
             rebuilding = true;
             try {
                 const rootProject = await fs_1.hyperproject.get(process.cwd());
+                // Clean output folder when files are deleted or renamed to avoid stale files
+                if (shouldClean) {
+                    const cleanOutDir = path_1.default.join(rootProject.src, ".hyperbook", "out");
+                    console.log(`${chalk_1.default.yellow(`[Cleaning]`)}: ${cleanOutDir}`);
+                    await (0, rimraf_1.rimraf)(cleanOutDir);
+                }
                 await (0, build_1.runBuildProject)(rootProject, rootProject);
                 console.log(`${chalk_1.default.yellow(`[Reloading]`)}: Website`);
                 reloadServer.emit("reload");
@@ -56151,7 +56158,7 @@ window.onload = () => {
     })
         .on("add", rebuild("(Added)"))
         .on("change", rebuild("(Changed)"))
-        .on("unlink", rebuild("(Deleted)"));
+        .on("unlink", rebuild("(Deleted)", true));
 }
 
 
@@ -93398,7 +93405,7 @@ var getNavigationForFile = async (pageList, currentFile) => {
     current = pageList[i] || null;
     const allPages = pageList;
     const filteredPageList = pageList.filter(
-      (p) => (!p.isEmpty || p.href === currentFile.path.href) && !p.hide
+      (p) => (!p.isEmpty || p.href === currentFile.path.href) && !p.hide && p.navigation !== "hidden"
     );
     i = filteredPageList.findIndex((p) => p.href === currentFile.path.href);
     const resolveLink = (link) => {
@@ -93484,8 +93491,10 @@ var getPagesAndSections = async (root) => {
       if (!data.name) {
         data.name = data.title || file.name;
       }
+      const pageNavigation = data.navigation === "default" || data.navigation === "hidden" ? data.navigation : void 0;
       const page = {
         ...data,
+        navigation: pageNavigation,
         path: file.path
       };
       const repo = makeRepoLink(hyperbook.repo, file);
@@ -178151,6 +178160,8 @@ var en_default = {
   "shell-reset-hyperbook": "Reset Hyperbook",
   "shell-import-hyperbook": "Import Hyperbook from a file",
   "shell-export-hyperbook": "Export Hyperbook to a file",
+  "breadcrumb-navigation": "Breadcrumb",
+  "breadcrumb-home": "Home",
   "qr-code": "QR Code",
   "p5-update": "Update",
   "p5-code-preview": "Code Preview",
@@ -178230,6 +178241,8 @@ var de_default = {
   "shell-reset-hyperbook": "Das Hyperbook zur\xFCcksetzen",
   "shell-import-hyperbook": "Das Hyperbook aus einer Datei importieren",
   "shell-export-hyperbook": "Das Hyperbook in eine Datei exportieren",
+  "breadcrumb-navigation": "Brotkr\xFCmelnavigation",
+  "breadcrumb-home": "Startseite",
   "qr-code": "QR-Code",
   "p5-update": "Aktualisieren",
   "p5-code-preview": "Code-Vorschau",
@@ -179158,9 +179171,10 @@ body::-webkit-scrollbar {
   --color-brand-dark: ${colors?.brandDark || colors?.brand || "#b5e3d8"};
   --color-brand-text: ${colors?.brandText || "white"};
   --main-width: 980px;
-  --header-height: 60px;
+  --header-height: 3.75rem;
   --nav-width: minmax(300px, 0.33fr);
   --nav-font-size: 0.9rem;
+  --element-gap: 1.5rem;
 }`;
   if (font) {
     rootCss += `
@@ -179720,6 +179734,154 @@ HYPERBOOK_ASSETS = "${makeUrl("/", "assets")}"
 };
 
 // src/rehypeShell.ts
+var resolveEmoji = (text9) => {
+  return text9.replace(/:([+\w-]+):/g, (_, name) => {
+    return github_emojis_default[name] ?? `:${name}:`;
+  });
+};
+var buildBreadcrumbPath = (ctx) => {
+  const currentHref = ctx.navigation.current?.href;
+  if (!currentHref) return [];
+  const path9 = [];
+  const findPath = (sections, pages, currentPath) => {
+    for (const page of pages) {
+      if (page.href === currentHref) {
+        return [...currentPath, {
+          name: page.name,
+          href: page.href || null,
+          isEmpty: page.isEmpty || false,
+          hide: page.hide
+        }];
+      }
+    }
+    for (const section of sections) {
+      const sectionItem = {
+        name: section.name,
+        href: section.href || null,
+        isEmpty: section.isEmpty || false,
+        hide: section.hide
+      };
+      if (section.href === currentHref) {
+        return [...currentPath, sectionItem];
+      }
+      const result2 = findPath(
+        section.sections,
+        section.pages,
+        [...currentPath, sectionItem]
+      );
+      if (result2) return result2;
+    }
+    return null;
+  };
+  const result = findPath(
+    ctx.navigation.sections,
+    ctx.navigation.pages,
+    []
+  );
+  return result || [];
+};
+var makeBreadcrumbElements = (ctx) => {
+  const currentHref = ctx.navigation.current?.href;
+  if (!currentHref || currentHref === "/") return [];
+  const pageBreadcrumb = ctx.navigation.current?.breadcrumb;
+  const globalBreadcrumb = ctx.config.breadcrumb;
+  let breadcrumbEnabled;
+  if (pageBreadcrumb !== void 0) {
+    breadcrumbEnabled = pageBreadcrumb;
+  } else {
+    breadcrumbEnabled = globalBreadcrumb;
+  }
+  if (!breadcrumbEnabled) return [];
+  let home = "\u{1F3E0}";
+  let separator = ">";
+  if (typeof breadcrumbEnabled === "object") {
+    if (breadcrumbEnabled.home !== void 0) {
+      home = resolveEmoji(breadcrumbEnabled.home);
+    }
+    if (breadcrumbEnabled.separator !== void 0) {
+      separator = resolveEmoji(breadcrumbEnabled.separator);
+    }
+  }
+  const breadcrumbPath = buildBreadcrumbPath(ctx);
+  if (breadcrumbPath.length === 0) return [];
+  const elements = [];
+  elements.push({
+    type: "element",
+    tagName: "a",
+    properties: {
+      class: "breadcrumb-home",
+      href: ctx.makeUrl("/", "book"),
+      "aria-label": i18n.get("breadcrumb-home")
+    },
+    children: [
+      {
+        type: "text",
+        value: home
+      }
+    ]
+  });
+  for (let i = 0; i < breadcrumbPath.length; i++) {
+    const item = breadcrumbPath[i];
+    const isLast = i === breadcrumbPath.length - 1;
+    elements.push({
+      type: "element",
+      tagName: "span",
+      properties: {
+        class: "breadcrumb-separator",
+        "aria-hidden": "true"
+      },
+      children: [
+        {
+          type: "text",
+          value: separator
+        }
+      ]
+    });
+    if (item.isEmpty || item.hide || !item.href) {
+      elements.push({
+        type: "element",
+        tagName: "span",
+        properties: {
+          class: isLast ? "breadcrumb-item breadcrumb-current" : "breadcrumb-item breadcrumb-empty",
+          "aria-current": isLast ? "page" : void 0
+        },
+        children: [
+          {
+            type: "text",
+            value: item.name
+          }
+        ]
+      });
+    } else {
+      elements.push({
+        type: "element",
+        tagName: "a",
+        properties: {
+          class: isLast ? "breadcrumb-item breadcrumb-current" : "breadcrumb-item",
+          href: ctx.makeUrl(item.href, "book"),
+          "aria-current": isLast ? "page" : void 0
+        },
+        children: [
+          {
+            type: "text",
+            value: item.name
+          }
+        ]
+      });
+    }
+  }
+  return [
+    {
+      type: "element",
+      tagName: "nav",
+      properties: {
+        class: "breadcrumb",
+        "aria-label": i18n.get("breadcrumb-navigation")
+      },
+      children: elements
+    }
+  ];
+};
 var makeNavigationPageElement = (ctx, page) => {
   return {
     type: "element",
@@ -179743,10 +179905,35 @@ var makeNavigationPageElement = (ctx, page) => {
     ]
   };
 };
+var makeNavigationSectionAsPageElement = (ctx, section) => {
+  const { href, name } = section;
+  return {
+    type: "element",
+    tagName: "li",
+    properties: {},
+    children: [
+      {
+        type: "element",
+        tagName: "a",
+        properties: {
+          class: ctx.navigation.current?.href === href ? "page active" : "page",
+          href: ctx.makeUrl(href || "", "book")
+        },
+        children: [
+          {
+            type: "text",
+            value: name
+          }
+        ]
+      }
+    ]
+  };
+};
 var makeNavigationSectionElement = (ctx, section) => {
-  const { virtual, isEmpty, href, name, pages, sections, expanded } = section;
-  let isExpanded = ctx.navigation.current?.href?.startsWith(href || "") || expanded;
-  const pagesElements = pages.filter((page) => !page.hide).map((page) => makeNavigationPageElement(ctx, page));
+  const { virtual, isEmpty, href, name, pages, sections, expanded, navigation } = section;
+  const isVirtual = navigation === "virtual" || navigation === void 0 && virtual;
+  const isExpanded = navigation === "expanded" || navigation === void 0 && expanded || ctx.navigation.current?.href?.startsWith(href || "");
+  const pagesElements = pages.filter((page) => !page.hide && page.navigation !== "hidden" && page.href !== href).map((page) => makeNavigationPageElement(ctx, page));
   const linksElements = [];
   if (pagesElements.length > 0) {
     linksElements.push({
@@ -179758,9 +179945,40 @@ var makeNavigationSectionElement = (ctx, section) => {
       children: pagesElements
     });
   }
-  const sectionElements = sections.filter((s3) => !s3.hide).map((s3) => makeNavigationSectionElement(ctx, s3));
+  const pageModeChildSections = sections.filter((s3) => !s3.hide && s3.navigation !== "hidden" && s3.navigation === "page" && !s3.isEmpty);
+  if (pageModeChildSections.length > 0) {
+    const combinedItems = [
+      ...pages.filter((page) => !page.hide && page.navigation !== "hidden" && page.href !== href).map((page) => ({
+        index: page.index,
+        name: page.name,
+        element: makeNavigationPageElement(ctx, page)
+      })),
+      ...pageModeChildSections.map((s3) => ({
+        index: s3.index,
+        name: s3.name,
+        element: makeNavigationSectionAsPageElement(ctx, s3)
+      }))
+    ].sort((a, b) => {
+      const aIndex = a.index !== void 0 ? a.index : 9999;
+      const bIndex = b.index !== void 0 ? b.index : 9999;
+      if (aIndex !== bIndex) return aIndex - bIndex;
+      return a.name > b.name ? 1 : -1;
+    });
+    linksElements.length = 0;
+    if (combinedItems.length > 0) {
+      linksElements.push({
+        type: "element",
+        tagName: "ul",
+        properties: {
+          class: "pages"
+        },
+        children: combinedItems.map((item) => item.element)
+      });
+    }
+  }
+  const sectionElements = sections.filter((s3) => !s3.hide && s3.navigation !== "hidden" && s3.navigation !== "page").map((s3) => makeNavigationSectionElement(ctx, s3));
   linksElements.push(...sectionElements);
-  if (virtual) {
+  if (isVirtual) {
     return {
       type: "element",
       tagName: "div",
@@ -179843,6 +180061,15 @@ var makeNavigationSectionElement = (ctx, section) => {
   };
 };
 var makeNavigationElements = (ctx) => {
+  const pageItems = ctx.navigation.pages.filter((p4) => !p4.hide && p4.navigation !== "hidden").map((p4) => ({ type: "page", item: p4 }));
+  const pageModeSecions = ctx.navigation.sections.filter((s3) => !s3.hide && s3.navigation !== "hidden" && s3.navigation === "page" && !s3.isEmpty).map((s3) => ({ type: "section", item: s3 }));
+  const regularSections = ctx.navigation.sections.filter((s3) => !s3.hide && s3.navigation !== "hidden" && s3.navigation !== "page");
+  const combinedItems = [...pageItems, ...pageModeSecions].sort((a, b) => {
+    const aIndex = a.item.index !== void 0 ? a.item.index : 9999;
+    const bIndex = b.item.index !== void 0 ? b.item.index : 9999;
+    if (aIndex !== bIndex) return aIndex - bIndex;
+    return a.item.name > b.item.name ? 1 : -1;
+  });
   return [
     {
       type: "element",
@@ -179853,9 +180080,15 @@ var makeNavigationElements = (ctx) => {
           type: "element",
           tagName: "ul",
           properties: {},
-          children: ctx.navigation.pages.filter((p4) => !p4.hide).map((p4) => makeNavigationPageElement(ctx, p4))
+          children: combinedItems.map((navItem) => {
+            if (navItem.type === "page") {
+              return makeNavigationPageElement(ctx, navItem.item);
+            } else {
+              return makeNavigationSectionAsPageElement(ctx, navItem.item);
+            }
+          })
         },
-        ...ctx.navigation.sections.filter((s3) => !s3.hide).map((s3) => makeNavigationSectionElement(ctx, s3))
+        ...regularSections.map((s3) => makeNavigationSectionElement(ctx, s3))
       ]
     }
   ];
@@ -180680,6 +180913,7 @@ var rehypeShell_default = (ctx) => () => {
             tagName: "main",
             properties: {},
             children: [
+              ...makeBreadcrumbElements(ctx),
               {
                 type: "element",
                 tagName: "article",
@@ -193367,7 +193601,7 @@ var getNavigationForFile = async (pageList, currentFile) => {
     current = pageList[i] || null;
     const allPages = pageList;
     const filteredPageList = pageList.filter(
-      (p4) => (!p4.isEmpty || p4.href === currentFile.path.href) && !p4.hide
+      (p4) => (!p4.isEmpty || p4.href === currentFile.path.href) && !p4.hide && p4.navigation !== "hidden"
     );
     i = filteredPageList.findIndex((p4) => p4.href === currentFile.path.href);
     const resolveLink = (link3) => {
@@ -193453,8 +193687,10 @@ var getPagesAndSections = async (root5) => {
       if (!data.name) {
         data.name = data.title || file.name;
       }
+      const pageNavigation = data.navigation === "default" || data.navigation === "hidden" ? data.navigation : void 0;
       const page = {
         ...data,
+        navigation: pageNavigation,
         path: file.path
       };
       const repo = makeRepoLink(hyperbook.repo, file);
@@ -201543,7 +201779,7 @@ module.exports = /*#__PURE__*/JSON.parse('{"application/1d-interleaved-parityfec
 /***/ ((module) => {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"hyperbook","version":"0.76.2","author":"Mike Barkmin","homepage":"https://github.com/openpatch/hyperbook#readme","license":"MIT","bin":{"hyperbook":"./dist/index.js"},"files":["dist"],"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/openpatch/hyperbook.git","directory":"packages/hyperbook"},"bugs":{"url":"https://github.com/openpatch/hyperbook/issues"},"engines":{"node":">=18"},"scripts":{"version":"pnpm build","lint":"tsc --noEmit","dev":"ncc build ./index.ts -w -o dist/","build":"rimraf dist && ncc build ./index.ts -o ./dist/ --no-cache --no-source-map-register --external favicons --external sharp && node postbuild.mjs"},"dependencies":{"favicons":"^7.2.0"},"devDependencies":{"create-hyperbook":"workspace:*","@hyperbook/fs":"workspace:*","@hyperbook/markdown":"workspace:*","@hyperbook/types":"workspace:*","@pnpm/exportable-manifest":"1000.0.6","@types/archiver":"6.0.3","@types/async-retry":"1.4.9","@types/cross-spawn":"6.0.6","@types/lunr":"^2.3.7","@types/prompts":"2.4.9","@types/tar":"6.1.13","@types/ws":"^8.5.14","@vercel/ncc":"0.38.3","archiver":"7.0.1","async-retry":"1.3.3","chalk":"5.4.1","chokidar":"4.0.3","commander":"12.1.0","cpy":"11.1.0","cross-spawn":"7.0.6","domutils":"^3.2.2","extract-zip":"^2.0.1","got":"12.6.0","htmlparser2":"^10.0.0","lunr":"^2.3.9","lunr-languages":"^1.14.0","mime":"^4.0.6","prompts":"2.4.2","rimraf":"6.0.1","tar":"7.4.3","update-check":"1.5.4","ws":"^8.18.0"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"hyperbook","version":"0.77.1","author":"Mike Barkmin","homepage":"https://github.com/openpatch/hyperbook#readme","license":"MIT","bin":{"hyperbook":"./dist/index.js"},"files":["dist"],"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/openpatch/hyperbook.git","directory":"packages/hyperbook"},"bugs":{"url":"https://github.com/openpatch/hyperbook/issues"},"engines":{"node":">=18"},"scripts":{"version":"pnpm build","lint":"tsc --noEmit","dev":"ncc build ./index.ts -w -o dist/","build":"rimraf dist && ncc build ./index.ts -o ./dist/ --no-cache --no-source-map-register --external favicons --external sharp && node postbuild.mjs"},"dependencies":{"favicons":"^7.2.0"},"devDependencies":{"create-hyperbook":"workspace:*","@hyperbook/fs":"workspace:*","@hyperbook/markdown":"workspace:*","@hyperbook/types":"workspace:*","@pnpm/exportable-manifest":"1000.0.6","@types/archiver":"6.0.3","@types/async-retry":"1.4.9","@types/cross-spawn":"6.0.6","@types/lunr":"^2.3.7","@types/prompts":"2.4.9","@types/tar":"6.1.13","@types/ws":"^8.5.14","@vercel/ncc":"0.38.3","archiver":"7.0.1","async-retry":"1.3.3","chalk":"5.4.1","chokidar":"4.0.3","commander":"12.1.0","cpy":"11.1.0","cross-spawn":"7.0.6","domutils":"^3.2.2","extract-zip":"^2.0.1","got":"12.6.0","htmlparser2":"^10.0.0","lunr":"^2.3.9","lunr-languages":"^1.14.0","mime":"^4.0.6","prompts":"2.4.2","rimraf":"6.0.1","tar":"7.4.3","update-check":"1.5.4","ws":"^8.18.0"}}');
 
 /***/ })
 

package/dist/locales/de.json

@@ -12,6 +12,8 @@
     "shell-reset-hyperbook": "Das Hyperbook zurücksetzen",
     "shell-import-hyperbook": "Das Hyperbook aus einer Datei importieren",
     "shell-export-hyperbook": "Das Hyperbook in eine Datei exportieren",
+    "breadcrumb-navigation": "Brotkrümelnavigation",
+    "breadcrumb-home": "Startseite",
     "qr-code": "QR-Code",
     "p5-update": "Aktualisieren",
     "p5-code-preview": "Code-Vorschau",

package/dist/locales/en.json

@@ -12,6 +12,8 @@
     "shell-reset-hyperbook": "Reset Hyperbook",
     "shell-import-hyperbook": "Import Hyperbook from a file",
     "shell-export-hyperbook": "Export Hyperbook to a file",
+    "breadcrumb-navigation": "Breadcrumb",
+    "breadcrumb-home": "Home",
     "qr-code": "QR Code",
     "p5-update": "Update",
     "p5-code-preview": "Code Preview",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperbook",
-  "version": "0.76.2",
+  "version": "0.77.1",
   "author": "Mike Barkmin",
   "homepage": "https://github.com/openpatch/hyperbook#readme",
   "license": "MIT",
@@ -56,10 +56,10 @@
     "tar": "7.4.3",
     "update-check": "1.5.4",
     "ws": "^8.18.0",
-    "create-hyperbook": "0.3.1",
-    "@hyperbook/fs": "0.23.0",
-    "@hyperbook/markdown": "0.47.2",
-    "@hyperbook/types": "0.19.0"
+    "create-hyperbook": "0.3.2",
+    "@hyperbook/fs": "0.24.0",
+    "@hyperbook/markdown": "0.48.1",
+    "@hyperbook/types": "0.20.0"
   },
   "scripts": {
     "version": "pnpm build",