starlight-cannoli-plugins 0.1.0 → 1.0.1

package/README.md

@@ -6,13 +6,22 @@ A collection of powerful plugins for [Astro Starlight](https://starlight.astro.b
 
 ### Starlight Index-Only Sidebar
 
-Automatically generates your Starlight sidebar by scanning for `index.md` files in specified directories. Only directories containing an `index.md` file will appear in the sidebar.
+Automatically generates a nested Starlight sidebar by recursively scanning directories for `index.md`/`index.mdx` files. Only directories with index files appear in the sidebar, creating a clean, minimal navigation structure.
 
 **Features:**
-- Scans directories recursively for `index.md` files
+- Recursively scans directories for `index.md` or `index.mdx` files
+- Creates sidebar entries only for pages with index files
 - Respects frontmatter: `draft: true` and `sidebar.hidden: true` hide entries
-- Option to use directory names as sidebar labels with automatic formatting (e.g., `csci-316` → `CSCI 316`)
-- No manual sidebar configuration needed
+- Automatically collapses single-child groups (no intermediate wrappers)
+- Configurable depth limiting to flatten deeply nested content
+- Two labeling modes: directory names or frontmatter titles
+- Ignores `assets` directories entirely
+
+**Options:**
+
+- `directories` (required): Array of directory names to scan (e.g., `["guides", "api"]`)
+- `maxDepthNesting` (optional, default: `100`): Maximum nesting depth. Root is level 0. At max depth, deeper index files are flattened as sibling items.
+- `dirnameDeterminesLabels` (optional, default: `true`): When `true`, all labels use raw directory names. When `false`, slug item labels come from frontmatter `title` field; group labels still use directory names.
 
 **Usage:**
 
@@ -28,11 +37,9 @@ export default defineConfig({
       title: "My Docs",
       plugins: [
         starlightIndexOnlySidebar({
-          directories: [
-            { label: "Guides", directory: "guides" },
-            { label: "API Docs", directory: "api" },
-          ],
-          dirnameDeterminesLabel: false, // optional: use directory names as labels
+          directories: ["guides", "api", "tutorials"],
+          maxDepthNesting: 2,           // optional
+          dirnameDeterminesLabels: false, // optional
         }),
       ],
     }),
@@ -50,6 +57,7 @@ A rehype plugin that validates all internal links in your Markdown/MDX files at
 - Auto-expands extensionless links to match `.md` or `.mdx` files
 - Converts internal links to site-absolute paths
 - Throws build errors for broken links
+- Skip validation for forward-reference links using multiple approaches
 
 **Usage:**
 
@@ -73,6 +81,48 @@ Or import directly:
 import { rehypeValidateLinks } from "cannoli-starlight-plugins/rehype-validate-links";
 ```
 
+**Skipping Link Validation:**
+
+There are three ways to skip validation for specific links:
+
+**1. Question Mark Prefix** (Per-link, in markdown)
+
+Prepend a `?` to the link href to skip validation:
+
+```mdx
+[Grade Calculator](?csci-320-331-obrenic/grade-calculator)
+[Grade Calculator](?./csci-320-331-obrenic/grade-calculator)
+[Grade Calculator](?/csci-320-331-obrenic/grade-calculator)
+```
+
+**2. HTML Data Attribute** (Per-link, requires HTML syntax)
+
+Use the `data-no-link-check` attribute on anchor tags:
+
+```mdx
+<a href="csci-320-331-obrenic/grade-calculator" data-no-link-check>Grade Calculator</a>
+```
+
+**3. Global Skip Patterns** (Configuration-based)
+
+Use the `skipPatterns` option to exclude links matching glob patterns:
+
+```ts
+// astro.config.mjs
+export default defineConfig({
+  markdown: {
+    rehypePlugins: [
+      [rehypeValidateLinks, {
+        skipPatterns: [
+          '/csci-320-331-obrenic/grade-calculator',  // exact match
+          '**/draft-*',                               // glob pattern
+        ]
+      }],
+    ],
+  },
+});
+```
+
 ## Installation
 
 ```bash

package/dist/chunk-NTIYGHZG.js

@@ -0,0 +1,246 @@
+// src/plugins/starlight-index-only-sidebar.ts
+import { join as join2 } from "path";
+
+// src/plugins/utils/sidebar-builder-utils.ts
+import * as fs from "fs";
+import * as path from "path";
+import { parse as parseYaml } from "yaml";
+function isDir(filePath) {
+  try {
+    return fs.statSync(filePath).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function findIndexMd(dirPath) {
+  const indexMd = path.join(dirPath, "index.md");
+  const indexMdx = path.join(dirPath, "index.mdx");
+  try {
+    if (fs.statSync(indexMd).isFile()) return indexMd;
+    if (fs.statSync(indexMdx).isFile()) return indexMdx;
+  } catch {
+  }
+  return null;
+}
+function parseFrontmatter(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) return {};
+    const frontmatter = parseYaml(match[1]);
+    return typeof frontmatter === "object" && frontmatter ? frontmatter : {};
+  } catch {
+    return {};
+  }
+}
+function getSlug(dirPath, rootDir) {
+  const normalized = path.normalize(dirPath).replace(/\\/g, "/");
+  const rootParent = path.normalize(path.dirname(rootDir)).replace(/\\/g, "/");
+  const slug = normalized.startsWith(rootParent) ? normalized.slice(rootParent.length + 1) : normalized;
+  return slug + "/index";
+}
+function hasIndexMdInSubtree(dirPath) {
+  const indexFile = findIndexMd(dirPath);
+  if (indexFile) {
+    const fm = parseFrontmatter(indexFile);
+    if (fm.draft || fm.sidebar?.hidden) return false;
+    return true;
+  }
+  try {
+    const entries = fs.readdirSync(dirPath);
+    for (const entry of entries) {
+      if (entry === "assets") continue;
+      const fullPath = path.join(dirPath, entry);
+      if (isDir(fullPath) && hasIndexMdInSubtree(fullPath)) {
+        return true;
+      }
+    }
+  } catch {
+    return false;
+  }
+  return false;
+}
+function isGroupItem(item) {
+  return "items" in item;
+}
+function pathSegmentToLabel(pathSegment) {
+  let label = pathSegment.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  const match = label.match(/^([a-z]+) [0-9]{2,}/i);
+  if (match) {
+    const firstGroup = match[1];
+    const uppercasedFirstGroup = firstGroup.toUpperCase();
+    label = uppercasedFirstGroup + label.substring(firstGroup.length);
+  }
+  return label;
+}
+function buildSidebarItems(dirPath, rootDir, currentDepth, maxDepth, dirnameDeterminesLabels, parentDirName = "") {
+  const items = [];
+  const indexFile = findIndexMd(dirPath);
+  if (indexFile) {
+    const fm = parseFrontmatter(indexFile);
+    if (!fm.draft && !fm.sidebar?.hidden) {
+      let label;
+      if (currentDepth >= maxDepth && parentDirName) {
+        label = parentDirName;
+      } else if (dirnameDeterminesLabels) {
+        label = "Overview";
+      } else {
+        label = fm.title || "Overview";
+      }
+      items.push({
+        label,
+        slug: getSlug(dirPath, rootDir)
+      });
+    }
+  }
+  if (currentDepth >= maxDepth) {
+    const flattenedItems = flattenIndexFilesAtDepth(
+      dirPath,
+      rootDir,
+      dirnameDeterminesLabels
+    );
+    items.push(...flattenedItems);
+    return items;
+  }
+  try {
+    const entries = fs.readdirSync(dirPath).sort();
+    for (const entry of entries) {
+      if (entry === "assets") continue;
+      const fullPath = path.join(dirPath, entry);
+      if (!isDir(fullPath)) continue;
+      if (!hasIndexMdInSubtree(fullPath)) continue;
+      const subItems = buildSidebarItems(
+        fullPath,
+        rootDir,
+        currentDepth + 1,
+        maxDepth,
+        dirnameDeterminesLabels,
+        entry
+      );
+      const hasIndex = findIndexMd(fullPath) !== null;
+      if (!hasIndex) {
+        const allGroups = subItems.length > 0 && subItems.every(isGroupItem);
+        if (allGroups || subItems.length === 1 && isGroupItem(subItems[0])) {
+          items.push(...subItems);
+        } else {
+          items.push({
+            label: pathSegmentToLabel(entry),
+            items: subItems
+          });
+        }
+      } else {
+        items.push({
+          label: pathSegmentToLabel(entry),
+          items: subItems
+        });
+      }
+    }
+  } catch {
+  }
+  return items;
+}
+function flattenIndexFilesAtDepth(dirPath, rootDir, dirnameDeterminesLabels) {
+  const items = [];
+  try {
+    const entries = fs.readdirSync(dirPath);
+    for (const entry of entries) {
+      if (entry === "assets") continue;
+      const fullPath = path.join(dirPath, entry);
+      if (!isDir(fullPath)) continue;
+      const indexFile = findIndexMd(fullPath);
+      if (indexFile) {
+        const fm = parseFrontmatter(indexFile);
+        if (!fm.draft && !fm.sidebar?.hidden) {
+          items.push({
+            label: pathSegmentToLabel(entry),
+            slug: getSlug(fullPath, rootDir)
+          });
+        }
+      }
+      items.push(
+        ...flattenIndexFilesAtDepth(fullPath, rootDir, dirnameDeterminesLabels)
+      );
+    }
+  } catch {
+  }
+  return items;
+}
+function getIndexMdSidebarItems(directory, options = {}) {
+  const maxDepth = options.maxDepthNesting ?? 100;
+  const dirnameDeterminesLabels = options.dirnameDeterminesLabels ?? true;
+  const rootDirName = pathSegmentToLabel(path.basename(directory));
+  const items = buildSidebarItems(
+    directory,
+    directory,
+    0,
+    maxDepth,
+    dirnameDeterminesLabels
+  );
+  return [
+    {
+      label: rootDirName,
+      items
+    }
+  ];
+}
+
+// src/plugins/starlight-index-only-sidebar.ts
+var SITE_DOCS_ROOT = "./src/content/docs";
+function normalizeSlug(slug) {
+  return slug.endsWith("/index") ? slug.slice(0, -6) : slug;
+}
+function normalizeItems(items) {
+  return items.map((item) => {
+    if ("items" in item) {
+      return {
+        label: item.label,
+        items: normalizeItems(item.items)
+      };
+    }
+    if ("slug" in item) {
+      return {
+        label: item.label,
+        slug: normalizeSlug(item.slug)
+      };
+    }
+    return item;
+  });
+}
+function starlightIndexOnlySidebar(pluginOptions) {
+  return {
+    name: "index-only-sidebar",
+    hooks: {
+      "config:setup": (hookOptions) => {
+        const { updateConfig } = hookOptions;
+        const { directories, maxDepthNesting, dirnameDeterminesLabels } = pluginOptions;
+        const functionOptions = {
+          maxDepthNesting,
+          dirnameDeterminesLabels
+        };
+        const sidebarItems = directories.map((directory) => {
+          const dirPath = join2(SITE_DOCS_ROOT, directory);
+          const rawItems = getIndexMdSidebarItems(dirPath, functionOptions);
+          const rootGroup = rawItems[0];
+          if (!rootGroup || !("items" in rootGroup)) {
+            return void 0;
+          }
+          const items = rootGroup.items || [];
+          const normalizedItems = normalizeItems(items);
+          return {
+            label: rootGroup.label,
+            items: normalizedItems
+          };
+        }).filter(
+          (group) => group !== void 0 && group.items.length > 0
+        );
+        updateConfig({
+          sidebar: sidebarItems
+        });
+      }
+    }
+  };
+}
+
+export {
+  starlightIndexOnlySidebar
+};

package/dist/{chunk-WOOF7XZX.js → chunk-TXRBCETT.js}

@@ -1,19 +1,32 @@
 // src/plugins/rehype-validate-links.ts
 import { existsSync } from "fs";
 import { sync as globSync } from "glob";
+import { minimatch } from "minimatch";
 import { dirname, join, relative, resolve } from "path";
 import { visit } from "unist-util-visit";
 var PROJECT_DOCS_DIR = "src/content/docs";
+function matchesSkipPattern(path, patterns) {
+  if (!patterns || patterns.length === 0) {
+    return false;
+  }
+  return patterns.some((pattern) => minimatch(path, pattern));
+}
 function getResolvedLink(href, currentFilePath) {
+  let skipValidation = false;
+  let processedHref = href;
+  if (href.startsWith("?")) {
+    skipValidation = true;
+    processedHref = href.slice(1);
+  }
   try {
-    new URL(href);
+    new URL(processedHref);
     return null;
   } catch {
   }
-  if (!href) {
+  if (!processedHref) {
     return null;
   }
-  const fragmentMatch = href.split("#");
+  const fragmentMatch = processedHref.split("#");
   const withoutFragment = fragmentMatch[0];
   const fragment = fragmentMatch[1] || "";
   if (!withoutFragment) {
@@ -46,7 +59,8 @@ function getResolvedLink(href, currentFilePath) {
     original_href: href,
     project_absolute_href: finalProjectAbsoluteHref,
     site_absolute_href: siteAbsoluteHref,
-    fragment
+    fragment,
+    skipValidation
   };
 }
 function validateLink(link) {
@@ -73,7 +87,7 @@ function validateLink(link) {
     }
   }
 }
-function rehypeValidateLinks() {
+function rehypeValidateLinks(options) {
   return (tree, file) => {
     const filePath = file.path;
     if (!filePath) {
@@ -82,7 +96,7 @@ function rehypeValidateLinks() {
       );
       return;
     }
-    visit(tree, "element", (node) => {
+    visit(tree, "element", (node, index, parent) => {
       let resourcePath;
       let attributeName = null;
       if (node.tagName === "a") {
@@ -95,6 +109,29 @@ function rehypeValidateLinks() {
       if (!resourcePath || !attributeName) return;
       const link = getResolvedLink(resourcePath, filePath);
       if (!link) return;
+      if (link.skipValidation) {
+        node.properties = node.properties || {};
+        node.properties[attributeName] = link.site_absolute_href;
+        return;
+      }
+      if (node.properties?.["data-no-link-check"] !== void 0) {
+        node.properties = node.properties || {};
+        node.properties[attributeName] = link.site_absolute_href;
+        return;
+      }
+      if (matchesSkipPattern(link.site_absolute_href, options?.skipPatterns)) {
+        node.properties = node.properties || {};
+        node.properties[attributeName] = link.site_absolute_href;
+        return;
+      }
+      if (index !== void 0 && parent && "children" in parent && Array.isArray(parent.children)) {
+        const nextNode = parent.children[index + 1];
+        if (nextNode && "type" in nextNode && nextNode.type === "comment" && "value" in nextNode && typeof nextNode.value === "string" && nextNode.value.includes("no-link-check")) {
+          node.properties = node.properties || {};
+          node.properties[attributeName] = link.site_absolute_href;
+          return;
+        }
+      }
       validateLink(link);
       node.properties = node.properties || {};
       node.properties[attributeName] = link.site_absolute_href;

package/dist/index.js

@@ -1,9 +1,9 @@
 import {
   starlightIndexOnlySidebar
-} from "./chunk-6XXMT37V.js";
+} from "./chunk-NTIYGHZG.js";
 import {
   rehypeValidateLinks
-} from "./chunk-WOOF7XZX.js";
+} from "./chunk-TXRBCETT.js";
 export {
   rehypeValidateLinks,
   starlightIndexOnlySidebar

package/dist/plugins/rehype-validate-links.d.ts

@@ -1,9 +1,12 @@
 import { Root } from 'hast';
 import { VFile } from 'vfile';
 
+type TRehypeValidateLinksOptions = {
+    skipPatterns?: string[];
+};
 /**
  * Rehype plugin to validate all internal links and convert them to absolute paths
  */
-declare function rehypeValidateLinks(): (tree: Root, file: VFile) => void;
+declare function rehypeValidateLinks(options?: TRehypeValidateLinksOptions): (tree: Root, file: VFile) => void;
 
 export { rehypeValidateLinks as default, rehypeValidateLinks };

package/dist/plugins/rehype-validate-links.js

@@ -1,7 +1,7 @@
 import {
   rehypeValidateLinks,
   rehype_validate_links_default
-} from "../chunk-WOOF7XZX.js";
+} from "../chunk-TXRBCETT.js";
 export {
   rehype_validate_links_default as default,
   rehypeValidateLinks

package/dist/plugins/starlight-index-only-sidebar.d.ts

@@ -1,14 +1,13 @@
 import { HookParameters } from '@astrojs/starlight/types';
 
-type TDirectoryConfig = {
-    label: string;
-    directory: string;
+type TOptions = {
+    maxDepthNesting?: number;
+    dirnameDeterminesLabels?: boolean;
 };
-type TIndexOnlySidebarPluginOptions = {
-    directories: Array<TDirectoryConfig>;
-    dirnameDeterminesLabel?: boolean;
+type TIndexOnlySidebarPluginOptions = TOptions & {
+    directories: string[];
 };
-declare function starlightIndexOnlySidebar(options: TIndexOnlySidebarPluginOptions): {
+declare function starlightIndexOnlySidebar(pluginOptions: TIndexOnlySidebarPluginOptions): {
     name: string;
     hooks: {
         "config:setup": (hookOptions: HookParameters<"config:setup">) => void;

package/dist/plugins/starlight-index-only-sidebar.js

@@ -1,6 +1,6 @@
 import {
   starlightIndexOnlySidebar
-} from "../chunk-6XXMT37V.js";
+} from "../chunk-NTIYGHZG.js";
 export {
   starlightIndexOnlySidebar
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "starlight-cannoli-plugins",
   "type": "module",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "description": "Starlight plugins for automatic sidebar generation and link validation",
   "license": "ISC",
   "main": "./dist/index.js",
@@ -36,16 +36,20 @@
     "url": "https://github.com/OccasionalCoderByTrade/astro-starlight-plugins"
   },
   "scripts": {
-    "build:lib": "tsup",
-    "dev": "node scripts/sync-docs-to-public.js && astro dev --port 5600",
-    "build": "npm run build:lib && node scripts/sync-docs-to-public.js && astro build",
-    "preview": "astro build && astro preview --port 5600",
-    "help": "astro --help",
-    "check": "astro check",
-    "prepublishOnly": "npm run build:lib"
+    "app:dev": "node scripts/sync-docs-to-public.js && rm -rf .astro/ && astro dev --port 5600",
+    "app:build": "rm -rf .astro/ && node scripts/sync-docs-to-public.js && astro build",
+    "app:preview": "astro build && astro preview --port 5600",
+    "app:help": "astro --help",
+    "app:check": "astro check",
+    "lib:build": "tsup",
+    "prepublishOnly": "npm run lib:build",
+    "tree:index": "tree -P index.md src/content/docs",
+    "tree:depth": "bash scripts/tree-depth.sh",
+    "clean:empty-dirs": "find src/content/docs -type d -empty -delete"
   },
   "dependencies": {
     "glob": "^13.0.6",
+    "minimatch": "^10.2.4",
     "unist-util-visit": "^5.0.0",
     "yaml": "^2.4.0"
   },
@@ -64,29 +68,31 @@
   "devDependencies": {
     "@astrojs/check": "^0.9.6",
     "@astrojs/starlight": "^0.37.6",
+    "@eslint/js": "^10.0.1",
+    "@eslint/markdown": "^7.5.1",
     "@expressive-code/plugin-line-numbers": "^0.41.7",
     "@hpcc-js/wasm": "^2.33.1",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
     "@types/hast": "^2.3.10",
+    "@typescript-eslint/eslint-plugin": "^8.56.1",
+    "@typescript-eslint/parser": "^8.56.1",
     "astro": "^5.6.1",
+    "eslint": "^10.0.2",
+    "eslint-md-cannoli-plugins": "^1.0.2",
+    "globals": "^17.4.0",
     "hast": "^1.0.0",
+    "jiti": "^2.6.1",
+    "lodash": "^4.17.23",
     "rehype-graphviz": "^0.3.0",
     "rehype-mathjax": "^7.1.0",
     "rehype-raw": "^7.0.0",
     "remark-math": "^6.0.0",
+    "sass-embedded": "^1.97.3",
     "sharp": "^0.34.2",
     "tsup": "^8.3.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vfile": "^6.0.0",
-    "@eslint/js": "^10.0.1",
-    "@eslint/markdown": "^7.5.1",
-    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
-    "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.56.1",
-    "eslint": "^10.0.2",
-    "eslint-md-cannoli-plugins": "^1.0.2",
-    "globals": "^17.4.0",
-    "jiti": "^2.6.1",
-    "sass-embedded": "^1.97.3",
-    "typescript-eslint": "^8.56.1"
+    "typescript-eslint": "^8.56.1",
+    "vfile": "^6.0.0"
   }
 }

package/dist/chunk-6XXMT37V.js

@@ -1,162 +0,0 @@
-// src/plugins/starlight-index-only-sidebar.ts
-import { readFileSync, readdirSync, statSync } from "fs";
-import { join } from "path";
-import { parse as parseYaml } from "yaml";
-var SITE_DOCS_ROOT = "./src/content/docs";
-function getFrontmatterMetadata(mdFilePath) {
-  const defaultMetadata = {
-    title: null,
-    draft: false,
-    sidebarHidden: false
-  };
-  try {
-    const content = readFileSync(mdFilePath, "utf-8");
-    const match = content.match(/^---\n([\s\S]*?)\n---/);
-    if (!match) return defaultMetadata;
-    const frontmatterText = match[1];
-    const frontmatter = parseYaml(frontmatterText);
-    if (!frontmatter || typeof frontmatter !== "object") {
-      return defaultMetadata;
-    }
-    const title = typeof frontmatter.title === "string" ? frontmatter.title : null;
-    const draft = frontmatter.draft === true;
-    let sidebarHidden = false;
-    if (frontmatter.sidebar) {
-      if (typeof frontmatter.sidebar === "object" && frontmatter.sidebar !== null) {
-        sidebarHidden = frontmatter.sidebar.hidden === true;
-      }
-    }
-    return {
-      title,
-      draft,
-      sidebarHidden
-    };
-  } catch {
-    return defaultMetadata;
-  }
-}
-function pathSegmentToLabel(pathSegment) {
-  let label = pathSegment.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-  const match = label.match(/^([a-z]+) [0-9]{2,}/i);
-  if (match) {
-    const firstGroup = match[1];
-    const uppercasedFirstGroup = firstGroup.toUpperCase();
-    label = uppercasedFirstGroup + label.substring(firstGroup.length);
-  }
-  return label;
-}
-function processRootIndex(dir, basePath, dirDeterminesLabel, items) {
-  if (!basePath || basePath.includes("/")) {
-    return;
-  }
-  const indexPath = join(dir, "index.md");
-  try {
-    statSync(indexPath);
-  } catch {
-    return;
-  }
-  const metadata = getFrontmatterMetadata(indexPath);
-  if (metadata.draft || metadata.sidebarHidden) {
-    return;
-  }
-  if (dirDeterminesLabel) {
-    const lastSegment = basePath.split("/").pop() || basePath;
-    items.push({
-      label: pathSegmentToLabel(lastSegment),
-      slug: basePath
-    });
-  } else {
-    items.push(basePath);
-  }
-}
-function buildIndexSidebar(dir, basePath = "", docsRoot, dirDeterminesLabel = false) {
-  const items = [];
-  try {
-    processRootIndex(dir, basePath, dirDeterminesLabel, items);
-    const entries = readdirSync(dir).sort();
-    for (const entry of entries) {
-      if (entry.startsWith(".")) continue;
-      const fullPath = join(dir, entry);
-      const stat = statSync(fullPath);
-      if (stat.isDirectory()) {
-        const indexPath = join(fullPath, "index.md");
-        const slug = basePath ? `${basePath}/${entry}` : entry;
-        try {
-          statSync(indexPath);
-          const metadata = getFrontmatterMetadata(indexPath);
-          if (metadata.draft || metadata.sidebarHidden) {
-            continue;
-          }
-          const subItems = buildIndexSidebar(fullPath, slug, docsRoot, dirDeterminesLabel);
-          if (subItems.length > 0) {
-            let groupLabel;
-            if (dirDeterminesLabel) {
-              groupLabel = pathSegmentToLabel(entry);
-            } else {
-              const title = metadata.title || entry;
-              groupLabel = title;
-            }
-            items.push({
-              label: groupLabel,
-              items: [dirDeterminesLabel ? { label: groupLabel, slug } : slug, ...subItems]
-            });
-          } else {
-            if (dirDeterminesLabel) {
-              items.push({
-                label: pathSegmentToLabel(entry),
-                slug
-              });
-            } else {
-              items.push(slug);
-            }
-          }
-        } catch {
-          const subItems = buildIndexSidebar(fullPath, slug, docsRoot, dirDeterminesLabel);
-          if (subItems.length > 0) {
-            items.push(...subItems);
-          }
-        }
-      }
-    }
-  } catch (error) {
-    console.error(`Error reading directory ${dir}:`, error);
-  }
-  return items.sort((a, b) => {
-    const aIsGroup = typeof a === "object" && "items" in a;
-    const bIsGroup = typeof b === "object" && "items" in b;
-    if (!aIsGroup && bIsGroup) return -1;
-    if (aIsGroup && !bIsGroup) return 1;
-    return 0;
-  });
-}
-function starlightIndexOnlySidebar(options) {
-  return {
-    name: "index-only-sidebar",
-    hooks: {
-      "config:setup": (hookOptions) => {
-        const { updateConfig } = hookOptions;
-        const dirnameDeterminesLabel = options.dirnameDeterminesLabel ?? false;
-        const sidebarItems = options.directories.map((dirConfig) => {
-          const dirItems = buildIndexSidebar(
-            join(SITE_DOCS_ROOT, dirConfig.directory),
-            dirConfig.directory,
-            SITE_DOCS_ROOT,
-            dirnameDeterminesLabel
-          );
-          const label = dirnameDeterminesLabel ? pathSegmentToLabel(dirConfig.directory) : dirConfig.label;
-          return {
-            label,
-            items: dirItems
-          };
-        }).filter((group) => group.items.length > 0);
-        updateConfig({
-          sidebar: sidebarItems
-        });
-      }
-    }
-  };
-}
-
-export {
-  starlightIndexOnlySidebar
-};