@marlinjai/clearify 1.6.3 → 1.6.5

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

@@ -8,7 +8,7 @@ import {
 } from "./chunk-SCZZB7OE.js";
 import {
   clearifyPlugin
-} from "./chunk-7VYQMIW2.js";
+} from "./chunk-WAWXVHUA.js";
 import {
   loadUserConfig,
   resolveConfig,

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

@@ -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/node/build.js

@@ -1,9 +1,9 @@
 import {
   buildSite
-} from "../chunk-7IXPTIHW.js";
+} from "../chunk-E3KDK3VB.js";
 import "../chunk-PRTER35L.js";
 import "../chunk-SCZZB7OE.js";
-import "../chunk-7VYQMIW2.js";
+import "../chunk-WAWXVHUA.js";
 import "../chunk-B2Q23JW3.js";
 import "../chunk-IBK35HZR.js";
 import "../chunk-V7LLYIRO.js";

package/dist/node/node/index.js

@@ -1,13 +1,13 @@
 import {
   buildSite
-} from "../chunk-7IXPTIHW.js";
+} from "../chunk-E3KDK3VB.js";
 import {
   remarkMermaidToComponent
 } from "../chunk-PRTER35L.js";
 import "../chunk-SCZZB7OE.js";
 import {
   clearifyPlugin
-} from "../chunk-7VYQMIW2.js";
+} from "../chunk-WAWXVHUA.js";
 import "../chunk-B2Q23JW3.js";
 import {
   init

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,6 +1,6 @@
 import {
   clearifyPlugin
-} from "../chunk-7VYQMIW2.js";
+} from "../chunk-WAWXVHUA.js";
 import "../chunk-B2Q23JW3.js";
 import "../chunk-IBK35HZR.js";
 import "../chunk-V7LLYIRO.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marlinjai/clearify",
-  "version": "1.6.3",
+  "version": "1.6.5",
   "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/src/theme/Sidebar.tsx

@@ -254,7 +254,7 @@ export function Sidebar({ sections, open, onClose }: SidebarProps) {
               setSelectedSectionId(id);
               const section = sections.find((s) => s.id === id);
               if (section) {
-                const firstPath = findFirstPath(section.navigation) ?? section.basePath;
+                const firstPath = section.basePath ?? findFirstPath(section.navigation);
                 if (firstPath && firstPath !== location.pathname) {
                   navigate(firstPath);
                 }