@aravindc26/velu 0.11.9 → 0.11.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aravindc26/velu",
-  "version": "0.11.9",
+  "version": "0.11.11",
   "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/engine/lib/velu.ts

@@ -936,21 +936,30 @@ export function getContextualOptions(): VeluContextualOption[] {
   const raw = config.contextual?.options;
 
   const ids = raw ?? DEFAULT_CONTEXTUAL_OPTIONS;
+  const options: VeluContextualOption[] = [];
 
-  return ids.map((entry, index) => {
+  ids.forEach((entry, index) => {
     if (typeof entry === 'string') {
       const preset = CONTEXTUAL_PRESETS[entry];
-      if (!preset) return null;
-      return { id: entry, title: preset.title, description: preset.description, type: 'builtin' as const };
+      if (!preset) return;
+      options.push({ id: entry, title: preset.title, description: preset.description, type: 'builtin' });
+      return;
     }
-    return {
+
+    const title = trimString(entry.title);
+    const href = trimString(entry.href);
+    if (!title || !href) return;
+
+    options.push({
       id: `custom-${index}`,
-      title: entry.title,
-      description: entry.description ?? '',
-      href: entry.href,
-      type: 'custom' as const,
-    };
-  }).filter((item): item is VeluContextualOption => item !== null);
+      title,
+      description: trimString(entry.description) ?? '',
+      href,
+      type: 'custom',
+    });
+  });
+
+  return options;
 }
 
 export function getSiteOrigin(): string {

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 };