@aravindc26/velu 0.11.9 → 0.11.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aravindc26/velu",
-  "version": "0.11.9",
+  "version": "0.11.10",
   "description": "A modern documentation site generator powered by Markdown and JSON configuration",
   "type": "module",
   "license": "MIT",

package/src/cli.ts

@@ -39,7 +39,7 @@ function printHelp() {
     velu lint              Validate docs.json (or velu.json) and check referenced pages
     velu run [--port N]    Build site and start dev server (default: 4321)
     velu build             Build a deployable static site (SSG)
-    velu paths             Output all navigation paths and their source files as JSON
+    velu paths             Output navigation paths and source files as JSON (grouped by language)
 
   Options:
     --port <number>   Port for the dev server (default: 4321)
@@ -159,7 +159,7 @@ interface PathEntry {
 }
 
 async function paths(docsDir: string) {
-  const { collectPages } = await import("./validate.js");
+  const { collectPagesByLanguage } = await import("./validate.js");
   const { normalizeConfigNavigation } = await import("./navigation-normalize.js");
   const { readFileSync, existsSync } = await import("node:fs");
   const { join } = await import("node:path");
@@ -172,25 +172,32 @@ async function paths(docsDir: string) {
 
   const raw = JSON.parse(readFileSync(configPath, "utf-8"));
   const config = normalizeConfigNavigation(raw);
-  const pages = collectPages(config);
-
-  const entries: PathEntry[] = pages.map((pagePath) => {
-    // Check for .mdx first, then .md
-    const mdxPath = join(docsDir, `${pagePath}.mdx`);
-    const mdPath = join(docsDir, `${pagePath}.md`);
-
-    if (existsSync(mdxPath)) {
-      return { path: pagePath, file: `${pagePath}.mdx` };
-    }
-    if (existsSync(mdPath)) {
-      return { path: pagePath, file: `${pagePath}.md` };
-    }
-    return { path: pagePath, file: null };
-  });
+  const pagesByLanguage = collectPagesByLanguage(config);
+  const groupedEntries: Record<string, PathEntry[]> = {};
+  const flatEntries: PathEntry[] = [];
+
+  for (const [language, pages] of Object.entries(pagesByLanguage)) {
+    const entries: PathEntry[] = pages.map((pagePath) => {
+      // Check for .mdx first, then .md
+      const mdxPath = join(docsDir, `${pagePath}.mdx`);
+      const mdPath = join(docsDir, `${pagePath}.md`);
+
+      if (existsSync(mdxPath)) {
+        return { path: pagePath, file: `${pagePath}.mdx` };
+      }
+      if (existsSync(mdPath)) {
+        return { path: pagePath, file: `${pagePath}.md` };
+      }
+      return { path: pagePath, file: null };
+    });
+    groupedEntries[language] = entries;
+    flatEntries.push(...entries);
+  }
 
   const output = {
-    paths: entries,
-    count: entries.length,
+    pathsByLanguage: groupedEntries,
+    paths: flatEntries,
+    count: flatEntries.length,
   };
 
   console.log(JSON.stringify(output, null, 2));

package/src/validate.ts

@@ -116,6 +116,7 @@ type VeluOpenApiSource = string | string[] | Record<string, unknown>;
 interface VeluConfig {
   $schema?: string;
   variables?: Record<string, string>;
+  languages?: string[];
   icons?: {
     library?: "fontawesome" | "lucide" | "tabler";
   };
@@ -262,6 +263,28 @@ function collectPages(config: VeluConfig): string[] {
   return collectPagesFromTabs(tabs);
 }
 
+function collectPagesByLanguage(config: VeluConfig): Record<string, string[]> {
+  const grouped: Record<string, string[]> = {};
+
+  if (config.navigation.languages && config.navigation.languages.length > 0) {
+    for (const lang of config.navigation.languages) {
+      grouped[lang.language] = collectPagesFromTabs(lang.tabs);
+    }
+    return grouped;
+  }
+
+  const basePages = collectPagesFromTabs(config.navigation.tabs ?? []);
+  if (config.languages && config.languages.length > 0) {
+    for (const lang of config.languages) {
+      grouped[lang] = [...basePages];
+    }
+    return grouped;
+  }
+
+  grouped.english = basePages;
+  return grouped;
+}
+
 function validateVeluConfig(docsDir: string, schemaPath: string): { valid: boolean; errors: string[] } {
   const errors: string[] = [];
 
@@ -331,4 +354,4 @@ function validateVeluConfig(docsDir: string, schemaPath: string): { valid: boole
   return { valid: errors.length === 0, errors };
 }
 
-export { validateVeluConfig, collectPages, VeluConfig, VeluGroup, VeluTab, VeluSeparator, VeluLink, VeluAnchor };
+export { validateVeluConfig, collectPages, collectPagesByLanguage, VeluConfig, VeluGroup, VeluTab, VeluSeparator, VeluLink, VeluAnchor };