@marlinjai/clearify 1.6.4 → 1.6.6

package/dist/node/{chunk-WT5W333R.js → chunk-BCKH7LNY.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-IBK35HZR.js";
 import {
   scanDocs
-} from "./chunk-L24ILRSX.js";
+} from "./chunk-6PUBRHS7.js";
 
 // src/node/check.ts
 import { resolve } from "path";

package/dist/node/{chunk-7VYQMIW2.js → chunk-NJHE2AWL.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-IBK35HZR.js";
 import {
   buildSectionData
-} from "./chunk-L24ILRSX.js";
+} from "./chunk-6PUBRHS7.js";
 
 // src/vite-plugin/index.ts
 import { resolve } from "path";
@@ -26,6 +26,16 @@ var VIRTUAL_MERMAID_SVGS = "virtual:clearify/mermaid-svgs";
 var RESOLVED_VIRTUAL_MERMAID_SVGS = "\0" + VIRTUAL_MERMAID_SVGS;
 var VIRTUAL_OPENAPI_SPEC = "virtual:clearify/openapi-spec";
 var RESOLVED_VIRTUAL_OPENAPI_SPEC = "\0" + VIRTUAL_OPENAPI_SPEC;
+function findFirstNavPath(items) {
+  for (const item of items) {
+    if (item.path) return item.path;
+    if (item.children) {
+      const found = findFirstNavPath(item.children);
+      if (found) return found;
+    }
+  }
+  return void 0;
+}
 function clearifyPlugin(options = {}) {
   let config;
   let userRoot;
@@ -102,20 +112,44 @@ function clearifyPlugin(options = {}) {
         }
       }
     }
+    for (const sectionNav of allSectionNavigations) {
+      const bp = sectionNav.basePath;
+      const hasRoute = allRoutes.some(
+        (r) => r.path === bp || r.path === `${bp}/*`
+      );
+      if (!hasRoute) {
+        const firstPath = findFirstNavPath(sectionNav.navigation);
+        if (firstPath) {
+          allRoutes.push({
+            path: bp,
+            filePath: "",
+            frontmatter: { title: sectionNav.label },
+            sectionId: sectionNav.id,
+            redirectTo: firstPath
+          });
+        }
+      }
+    }
   }
   function generateRoutesCode() {
     const imports = [];
     const routeEntries = [];
     allRoutes.forEach((route, i) => {
-      const varName = `Route${i}`;
-      if (route.componentPath) {
-        imports.push(`const ${varName} = () => import('${route.componentPath}');`);
+      if (route.redirectTo) {
+        routeEntries.push(
+          `  { path: ${JSON.stringify(route.path)}, redirectTo: ${JSON.stringify(route.redirectTo)} }`
+        );
       } else {
-        imports.push(`const ${varName} = () => import(/* @vite-ignore */ '${route.filePath}');`);
+        const varName = `Route${i}`;
+        if (route.componentPath) {
+          imports.push(`const ${varName} = () => import('${route.componentPath}');`);
+        } else {
+          imports.push(`const ${varName} = () => import(/* @vite-ignore */ '${route.filePath}');`);
+        }
+        routeEntries.push(
+          `  { path: ${JSON.stringify(route.path)}, component: ${varName}, frontmatter: ${JSON.stringify(route.frontmatter)} }`
+        );
       }
-      routeEntries.push(
-        `  { path: ${JSON.stringify(route.path)}, component: ${varName}, frontmatter: ${JSON.stringify(route.frontmatter)} }`
-      );
     });
     return `${imports.join("\n")}
 export default [

package/dist/node/{chunk-7IXPTIHW.js → chunk-SY7KZD5Z.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-SCZZB7OE.js";
 import {
   clearifyPlugin
-} from "./chunk-7VYQMIW2.js";
+} from "./chunk-NJHE2AWL.js";
 import {
   loadUserConfig,
   resolveConfig,
@@ -16,7 +16,7 @@ import {
 } from "./chunk-IBK35HZR.js";
 import {
   buildSectionData
-} from "./chunk-L24ILRSX.js";
+} from "./chunk-6PUBRHS7.js";
 
 // src/node/build.ts
 import { build as viteBuild } from "vite";

package/dist/node/core/navigation.js

@@ -3,7 +3,7 @@ import {
   buildRoutes,
   buildSectionData,
   scanDocs
-} from "../chunk-L24ILRSX.js";
+} from "../chunk-6PUBRHS7.js";
 import "../chunk-5TD7NQIW.js";
 export {
   buildNavigation,

package/dist/node/node/build.js

@@ -1,13 +1,13 @@
 import {
   buildSite
-} from "../chunk-7IXPTIHW.js";
+} from "../chunk-SY7KZD5Z.js";
 import "../chunk-PRTER35L.js";
 import "../chunk-SCZZB7OE.js";
-import "../chunk-7VYQMIW2.js";
+import "../chunk-NJHE2AWL.js";
 import "../chunk-B2Q23JW3.js";
 import "../chunk-IBK35HZR.js";
 import "../chunk-V7LLYIRO.js";
-import "../chunk-L24ILRSX.js";
+import "../chunk-6PUBRHS7.js";
 import "../chunk-5TD7NQIW.js";
 export {
   buildSite

package/dist/node/node/check.js

@@ -1,9 +1,9 @@
 import {
   checkLinks
-} from "../chunk-WT5W333R.js";
+} from "../chunk-BCKH7LNY.js";
 import "../chunk-IBK35HZR.js";
 import "../chunk-V7LLYIRO.js";
-import "../chunk-L24ILRSX.js";
+import "../chunk-6PUBRHS7.js";
 import "../chunk-5TD7NQIW.js";
 export {
   checkLinks

package/dist/node/node/index.js

@@ -1,26 +1,26 @@
 import {
   buildSite
-} from "../chunk-7IXPTIHW.js";
+} from "../chunk-SY7KZD5Z.js";
 import {
   remarkMermaidToComponent
 } from "../chunk-PRTER35L.js";
 import "../chunk-SCZZB7OE.js";
 import {
   clearifyPlugin
-} from "../chunk-7VYQMIW2.js";
+} from "../chunk-NJHE2AWL.js";
 import "../chunk-B2Q23JW3.js";
 import {
   init
 } from "../chunk-MWUXPDQK.js";
 import {
   checkLinks
-} from "../chunk-WT5W333R.js";
+} from "../chunk-BCKH7LNY.js";
 import {
   loadUserConfig,
   resolveConfig
 } from "../chunk-IBK35HZR.js";
 import "../chunk-V7LLYIRO.js";
-import "../chunk-L24ILRSX.js";
+import "../chunk-6PUBRHS7.js";
 import "../chunk-5TD7NQIW.js";
 
 // src/node/index.ts

package/dist/node/types/index.d.ts

@@ -73,6 +73,7 @@ interface RouteEntry {
     frontmatter: PageFrontmatter;
     sectionId?: string;
     componentPath?: string;
+    redirectTo?: string;
 }
 declare function defineConfig(config: Partial<ClearifyConfig>): Partial<ClearifyConfig>;
 

package/dist/node/vite-plugin/index.js

@@ -1,10 +1,10 @@
 import {
   clearifyPlugin
-} from "../chunk-7VYQMIW2.js";
+} from "../chunk-NJHE2AWL.js";
 import "../chunk-B2Q23JW3.js";
 import "../chunk-IBK35HZR.js";
 import "../chunk-V7LLYIRO.js";
-import "../chunk-L24ILRSX.js";
+import "../chunk-6PUBRHS7.js";
 import "../chunk-5TD7NQIW.js";
 export {
   clearifyPlugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marlinjai/clearify",
-  "version": "1.6.4",
+  "version": "1.6.6",
   "description": "An open-source documentation site generator. Turn markdown into beautiful docs.",
   "type": "module",
   "bin": {

package/src/client/App.tsx

@@ -1,5 +1,5 @@
 import React, { useEffect, useState, useRef } from 'react';
-import { BrowserRouter, Routes, Route, useLocation } from 'react-router-dom';
+import { BrowserRouter, Routes, Route, Navigate, useLocation } from 'react-router-dom';
 import { MDXProvider } from '@mdx-js/react';
 // @ts-expect-error virtual module
 import routes from 'virtual:clearify/routes';
@@ -15,8 +15,9 @@ import '../theme/styles/globals.css';
 
 interface RouteEntry {
   path: string;
-  component: () => Promise<any>;
-  frontmatter: { title?: string; description?: string };
+  component?: () => Promise<any>;
+  frontmatter?: { title?: string; description?: string };
+  redirectTo?: string;
 }
 
 function PageWrapper({ loader, fallbackFrontmatter }: { loader: () => Promise<any>; fallbackFrontmatter: any }) {
@@ -77,13 +78,17 @@ function AppRoutes() {
   return (
     <Layout config={config} sections={sections}>
       <Routes>
-        {(routes as RouteEntry[]).map((route) => (
-          <Route
-            key={route.path}
-            path={route.path}
-            element={<PageWrapper loader={route.component} fallbackFrontmatter={route.frontmatter} />}
-          />
-        ))}
+        {(routes as RouteEntry[]).map((route) =>
+          route.redirectTo ? (
+            <Route key={route.path} path={route.path} element={<Navigate to={route.redirectTo} replace />} />
+          ) : (
+            <Route
+              key={route.path}
+              path={route.path}
+              element={<PageWrapper loader={route.component!} fallbackFrontmatter={route.frontmatter} />}
+            />
+          )
+        )}
         <Route path="*" element={<NotFound />} />
       </Routes>
     </Layout>

package/dist/node/{chunk-L24ILRSX.js → chunk-6PUBRHS7.js}

@@ -49,6 +49,7 @@ function buildNavigation(docs, basePath = "/") {
   const rootDir = basePath === "/" ? "/" : basePath.replace(/\/$/, "");
   const groups = /* @__PURE__ */ new Map();
   for (const doc of docs) {
+    if (doc.routePath === rootDir || doc.routePath === "/") continue;
     const dir = dirname(doc.routePath);
     if (!groups.has(dir)) groups.set(dir, []);
     groups.get(dir).push(doc);
@@ -64,7 +65,6 @@ function buildNavigation(docs, basePath = "/") {
   const nav = [];
   const rootFiles = groups.get(rootDir) ?? [];
   for (const doc of rootFiles) {
-    if (doc.routePath === rootDir || doc.routePath === "/") continue;
     const item = { label: doc.frontmatter.title, path: doc.routePath };
     if (doc.frontmatter.icon) item.icon = doc.frontmatter.icon;
     nav.push(item);