scavold 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -9,6 +9,14 @@ one offered; a patch release does not.
 
 ## [Unreleased]
 
+## [0.2.1] — 2026-10-04
+
+### Fixed
+
+- Menus and breadcrumbs no longer link a folder without an `index.md` — there is no page
+  to go to, and the link was dead. Such a folder is named as text above its pages where a
+  menu shows them, left out where a menu does not, and named as text in a breadcrumb.
+
 ## [0.2.0] — 2026-10-04
 
 ### Added
@@ -361,7 +369,8 @@ First published release. Version `0.1.0` existed in-tree only.
 - Only images are processed out of `media_folder`; other file types (video, documents)
   are never copied into the build output and have to live in the static folder.
 
-[Unreleased]: https://gitlab.com/cratly/scavold/-/compare/v0.2.0...main
+[Unreleased]: https://gitlab.com/cratly/scavold/-/compare/v0.2.1...main
+[0.2.1]: https://gitlab.com/cratly/scavold/-/compare/v0.2.0...v0.2.1
 [0.2.0]: https://gitlab.com/cratly/scavold/-/compare/v0.2.0-rc.12...v0.2.0
 [0.2.0-rc.12]: https://gitlab.com/cratly/scavold/-/compare/v0.2.0-rc.11...v0.2.0-rc.12
 [0.2.0-rc.11]: https://gitlab.com/cratly/scavold/-/compare/v0.2.0-rc.10...v0.2.0-rc.11

package/COMPONENTS.md

@@ -28,6 +28,9 @@ Each item in the trail carries `.active` (all ancestor items) and `.current` (th
 last item, if the current page is included). This makes it straightforward to style
 the current crumb differently in CSS.
 
+A folder on the way that has no `index.md` is named as text, a `<span>` in place of the
+`<a>`: it is part of where the page sits, but there is no page to go to.
+
 #### Props
 
 | Prop | Type | Default | Description |
@@ -486,6 +489,10 @@ The `.active` class is set on any item that is an ancestor of the current page o
 current page itself. The `.current` class is set only on the item that exactly matches
 the current page.
 
+A folder without an `index.md` has no page to link to. Where the menu shows the
+pages below it, the folder is named as text — a `<span>` in place of the `<a>` — and
+groups them; where it does not, the folder is left out, as it would lead nowhere.
+
 #### Label resolution
 
 Item labels are resolved in this order:

package/components/ScavoldMenuItems.vue

@@ -19,7 +19,9 @@ const { nodeLabel, nodeHref } = useHierarchy();
         current: item.current,
       }"
     >
-      <a :href="nodeHref( item.node )" :aria-current="item.current ? 'page' : undefined">{{ nodeLabel( item.node ) }}</a>
+      <a v-if="item.node.isPage" :href="nodeHref( item.node )" :aria-current="item.current ? 'page' : undefined">{{ nodeLabel( item.node ) }}</a>
+      <!-- A folder without an index.md: there is no page to go to, only the ones below. -->
+      <span v-else>{{ nodeLabel( item.node ) }}</span>
       <ScavoldMenuItems
         v-if="item.children.length"
         :items="item.children"

package/composables/hierarchy.ts

@@ -152,7 +152,10 @@ export function useHierarchy() {
 						? collectItems( node, remaining === -1 ? -1 : remaining - 1, activeOnly, expand )
 						: [],
 				};
-			} );
+			} )
+			// A folder without an index.md is no page to link to: it only groups the
+			// pages below it, and where those are not shown it leads nowhere.
+			.filter( item => item.node.isPage || item.children.length );
 	};
 
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "scavold",
-	"version": "0.2.0",
+	"version": "0.2.1",
 	"type": "module",
 	"description": "VitePress theme framework — a scaffold for building custom VitePress themes with Vue at the core",
 	"keywords": [

package/scripts/check-fixture.js

@@ -352,6 +352,21 @@ expect( menu.includes( '<a href="/containers.html">' ),
 expect( crumbs.includes( '<a href="/blog/index.html"' ) && crumbs.includes( 'aria-current="page"' ),
 	"marks the page the breadcrumb ends on" );
 
+console.log( "\nfolders without an index page" );
+
+const sitemapNav = ( blogPage.match( /<nav aria-label="Sitemap"[\s\S]*?<\/nav>/ ) ?? [""] )[0];
+const guidePage = built( join( "guides", "first.html" ) );
+const guideCrumbs = ( guidePage.match( /<nav class="breadcrumb"[\s\S]*?<\/nav>/ ) ?? [""] )[0];
+
+expect( ![ blogPage, guidePage ].some( page => page.includes( 'href="/guides.html"' ) ),
+	"never links a folder that has no page of its own" );
+expect( !/>guides</.test( menu ),
+	"leaves such a folder out of a menu that shows none of the pages below it" );
+expect( /<span>guides<\/span><ul>(?:<!--\[-->)?<li[^>]*><a href="\/guides\/first\.html"/.test( sitemapNav ),
+	"names such a folder as text above its pages where the menu shows them" );
+expect( /<span>guides<\/span>/.test( guideCrumbs ) && guideCrumbs.includes( 'aria-current="page"' ),
+	"names such a folder as text in the breadcrumb" );
+
 console.log( "\nnamed menus" );
 
 const footer = ( blogPage.match( /<nav aria-label="Footer"[\s\S]*?<\/nav>/ ) ?? [""] )[0];
@@ -413,7 +428,9 @@ expect( entryTitles( dated ).join( " | " ) === "Newest post | Middle post",
 expect( entryTitles( titled ).join( " | " ) === "Middle post | Newest post | Not announced | Oldest post",
 	"orders by title and lists every page when the limit is 0",
 	`found ${entryTitles( titled ).join( " | " ) || "nothing"}` );
-expect( !blog.includes( "Unlisted draft" ), "leaves out a page whose front matter says hide: list" );
+// Menus are left aside: hide: list keeps a page out of lists, not navigation.
+expect( !blog.replace( /<nav[\s\S]*?<\/nav>/g, "" ).includes( "Unlisted draft" ),
+	"leaves out a page whose front matter says hide: list" );
 expect( /<h3 class="scavold-pagelist__title"/.test( dated ) && !/<h\d class="scavold-pagelist__title"/.test( titled ),
 	"uses the requested heading level, and no heading at all without one" );
 // The displayed text follows the page's locale, which the fixture leaves to the