jamdesk 1.1.28 → 1.1.30

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://www.jamdesk.com">
-    <img src="https://www.jamdesk.com/logo-light.png" width="280" alt="Jamdesk" />
+    <img src="https://www.jamdesk.com/logo-universal.png" width="280" alt="Jamdesk" />
   </a>
 </p>
 
@@ -435,6 +435,7 @@ See the [docs.json reference](https://www.jamdesk.com/docs/config/docs-json-refe
 
 - Node.js v20.0.0+
 - npm v8+ (recommended)
+- macOS, Linux, or Windows (all tested in CI)
 
 ## Learn More
 
@@ -446,6 +447,7 @@ See the [docs.json reference](https://www.jamdesk.com/docs/config/docs-json-refe
 - [OpenAPI](https://www.jamdesk.com/docs/api-reference/openapi-setup)
 - [Deployment](https://www.jamdesk.com/docs/deploy)
 - [npm Package](https://www.npmjs.com/package/jamdesk)
+- [Release History](https://www.npmjs.com/package/jamdesk?activeTab=versions)
 - [Homepage](https://www.jamdesk.com)
 - [Pricing](https://www.jamdesk.com/pricing)
 

package/dist/lib/deps.js

@@ -73,8 +73,8 @@ export const REQUIRED_DEPS = {
     'unified': '^11.0.0',
     'unist-util-visit': '^5.0.0',
     // CSS
-    'tailwindcss': '^4.2.2',
-    '@tailwindcss/postcss': '^4.2.2',
+    'tailwindcss': '^4.2.4',
+    '@tailwindcss/postcss': '^4.2.4',
     '@tailwindcss/typography': '^0.5.10',
     'postcss': '^8.5.10',
     'autoprefixer': '^10.4.24',
@@ -83,7 +83,7 @@ export const REQUIRED_DEPS = {
     'json5': '^2.2.3',
     'glob': '^13.0.6',
     // TypeScript (needed for Next.js to avoid auto-install breaking symlink)
-    'typescript': '^6.0.2',
+    'typescript': '^6.0.3',
     '@types/node': '^25.5.2',
     '@types/react': '^19.2.14',
     '@types/react-dom': '^19.0.0',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.28",
+  "version": "1.1.30",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",
@@ -114,7 +114,7 @@
     "json5": "^2.2.3",
     "nspell": "^2.1.5",
     "open": "^11.0.0",
-    "ora": "^9.3.0",
+    "ora": "^9.4.0",
     "tar": "^7.5.9"
   },
   "devDependencies": {
@@ -122,7 +122,7 @@
     "@types/fs-extra": "^11.0.0",
     "@types/node": "^25.5.0",
     "typescript": "^6.0.2",
-    "vitest": "^4.1.3"
+    "vitest": "^4.1.5"
   },
   "engines": {
     "node": ">=20.0.0"

package/vendored/app/[[...slug]]/page.tsx

@@ -74,6 +74,9 @@ import {
   type CodeExample,
   type AuthMethod,
 } from '@/lib/openapi';
+import { extractLanguageFromPath, isValidLanguageCode } from '@/lib/language-utils';
+import { findFirstNavPage } from '@/lib/find-first-nav-page';
+import { candidateSpecPaths } from '@/lib/openapi/lang-spec-path';
 import { ApiEndpoint } from '@/components/mdx/ApiEndpoint';
 import { ImagePriorityProvider } from '@/components/mdx/ImagePriorityProvider';
 import { AIActionsMenu } from '@/components/AIActionsMenu';
@@ -182,100 +185,19 @@ function getAllDocPaths(): string[] {
   return paths;
 }
 
-/**
- * Find the first page in navigation (used to resolve empty root slug in place).
- */
-function findFirstPage(config: DocsConfig): string {
-  const navigation = config.navigation;
-
-  // Helper to extract page path from a page entry
-  const getPagePath = (page: unknown): string | null => {
-    if (typeof page === 'string') return page;
-    if (typeof page === 'object' && page && 'page' in page) {
-      return (page as { page: string }).page;
-    }
-    return null;
-  };
-
-  // Helper to extract first page from a group
-  const extractFirstFromGroup = (group: { pages?: unknown[] }): string | null => {
-    const itemPages = group.pages || [];
-    for (const page of itemPages) {
-      if (typeof page === 'object' && page && 'group' in page) {
-        const result = extractFirstFromGroup(page as { pages?: unknown[] });
-        if (result) return result;
-        continue;
-      }
-      const pagePath = getPagePath(page);
-      if (pagePath) return pagePath;
-    }
-    return null;
-  };
-
-  // Check languages first (multi-language navigation structure)
-  if (navigation.languages && navigation.languages.length > 0) {
-    const firstLang = navigation.languages[0];
-    if (firstLang.tabs && firstLang.tabs.length > 0) {
-      for (const tab of firstLang.tabs) {
-        if (tab.groups) {
-          for (const group of tab.groups) {
-            const result = extractFirstFromGroup(group);
-            if (result) return result;
-          }
-        }
-      }
-    }
-  }
-
-  // Check tabs first
-  if (navigation.tabs && navigation.tabs.length > 0) {
-    for (const tab of navigation.tabs) {
-      if (tab.groups) {
-        for (const group of tab.groups) {
-          const result = extractFirstFromGroup(group);
-          if (result) return result;
-        }
-      }
-    }
-  }
-
-  // Check top-level groups
-  if (navigation.groups && navigation.groups.length > 0) {
-    for (const group of navigation.groups) {
-      const result = extractFirstFromGroup(group);
-      if (result) return result;
-    }
-  }
-
-  // Check anchors
-  if (navigation.anchors && navigation.anchors.length > 0) {
-    for (const anchor of navigation.anchors) {
-      if (anchor.groups) {
-        for (const group of anchor.groups) {
-          const result = extractFirstFromGroup(group);
-          if (result) return result;
-        }
-      }
-    }
-  }
+function findFirstPage(config: DocsConfig, lang?: string): string {
+  const nav = config.navigation;
+  const langBlock = lang ? nav.languages?.find((l) => l.language === lang) : undefined;
+  const result = (langBlock && findFirstNavPage(langBlock)) || findFirstNavPage(nav);
+  return result ? result.replace(/^\//, '') : 'introduction';
+}
 
-  // Check pages array (flat format with groups inside pages)
-  if (navigation.pages && Array.isArray(navigation.pages)) {
-    for (const item of navigation.pages) {
-      // Could be a string page
-      const directPath = getPagePath(item);
-      if (directPath) return directPath;
-
-      // Could be a group object { group: "...", pages: [...] }
-      if (item && typeof item === 'object' && 'group' in item) {
-        const result = extractFirstFromGroup(item as { pages?: unknown[] });
-        if (result) return result;
-      }
-    }
+function resolveSlug(normalizedSlug: string[], config: DocsConfig): string[] {
+  if (normalizedSlug.length === 0) return pathToSlug(findFirstPage(config));
+  if (normalizedSlug.length === 1 && isValidLanguageCode(normalizedSlug[0])) {
+    return pathToSlug(findFirstPage(config, normalizedSlug[0]));
   }
-
-  // Fallback
-  return 'introduction';
+  return normalizedSlug;
 }
 
 export async function generateStaticParams() {
@@ -342,17 +264,12 @@ export async function generateMetadata({ params }: PageProps) {
   // Normalize slug: strip /docs prefix when hostAtDocs=true.
   // Empty root → resolve to first page (see DocPage for the full rationale).
   const normalizedSlug = normalizeSlugForContent(resolvedParams.slug || [], hostAtDocs);
+  const config = await loader.getConfig();
+  const slug = resolveSlug(normalizedSlug, config);
   const isRoot = normalizedSlug.length === 0;
-  const slug = isRoot
-    ? pathToSlug(findFirstPage(await loader.getConfig()))
-    : normalizedSlug;
   const pagePath = slug.join('/');
 
-  // Fetch content and config in parallel
-  const [fileContents, config] = await Promise.all([
-    loader.getContent(pagePath).catch(() => null),
-    loader.getConfig(),
-  ]);
+  const fileContents = await loader.getContent(pagePath).catch(() => null);
 
   if (!fileContents) {
     return {
@@ -428,14 +345,11 @@ export default async function DocPage({ params }: PageProps) {
   // redirect() emits cache-control: private, blocking CDN caching. Canonical
   // + noindex in generateMetadata prevent duplicate indexing.
   const normalizedSlug = normalizeSlugForContent(resolvedParams.slug || [], hostAtDocs);
-  const slug = normalizedSlug.length === 0
-    ? pathToSlug(findFirstPage(await loader.getConfig()))
-    : normalizedSlug;
+  const config = await loader.getConfig();
+  const slug = resolveSlug(normalizedSlug, config);
   const pagePath = slug.join('/');
-  const [fileContents, config] = await Promise.all([
-    loader.getContent(pagePath).catch(() => null),
-    loader.getConfig(),
-  ]);
+  const currentLang = extractLanguageFromPath(`/${pagePath}`);
+  const fileContents = await loader.getContent(pagePath).catch(() => null);
 
   // Check if content exists (getContent returns null via catch if not found)
   if (!fileContents) {
@@ -567,9 +481,13 @@ export default async function DocPage({ params }: PageProps) {
         allSpecPaths.length > 0 ? allSpecPaths : undefined
       );
 
-      const specsToTry = parsed.isShortFormat && allSpecPaths.length > 1
+      const baseSpecs = parsed.isShortFormat && allSpecPaths.length > 1
         ? allSpecPaths
         : [parsed.specPath];
+      // For each base spec, expand into [<base>.<lang>.ext, <base>.ext] when
+      // the page is under a localized URL. Resolver tries each in order; the
+      // first that loads wins. Missing lang variant falls back to English.
+      const specsToTry = baseSpecs.flatMap(p => candidateSpecPaths(p, currentLang));
 
       // Hoist mode-dependent values before the loop
       const useIsr = isIsrMode() && !!projectSlug;
@@ -580,7 +498,8 @@ export default async function DocPage({ params }: PageProps) {
 
       let lastError: unknown = null;
 
-      for (const specPath of specsToTry) {
+      for (let i = 0; i < specsToTry.length; i++) {
+        const specPath = specsToTry[i];
         try {
           if (resolveSpec && projectSlug) {
             const spec = await resolveSpec(projectSlug, specPath);
@@ -598,6 +517,14 @@ export default async function DocPage({ params }: PageProps) {
           break;
         } catch (err) {
           lastError = err;
+          const isLast = i === specsToTry.length - 1;
+          if (!isLast) {
+            // Lang variant (or intermediate candidate) failed — log so we
+            // notice transient R2 errors that silently fall through to English.
+            console.warn(
+              `[openapi] spec candidate "${specPath}" failed; trying next: ${(err as Error).message}`
+            );
+          }
         }
       }
 

package/vendored/app/api/assets/[...path]/route.ts

@@ -8,6 +8,7 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { fetchAsset } from '@/lib/r2-content';
 import { log } from '@/lib/logger';
+import { isIsrMode } from '@/lib/page-isr-helpers';
 
 // Cache durations by content type (in seconds)
 const CACHE_DURATIONS: Record<string, number> = {
@@ -27,8 +28,7 @@ export async function GET(
   request: NextRequest,
   { params }: { params: Promise<{ path: string[] }> }
 ) {
-  // Check if ISR mode is enabled
-  if (process.env.ISR_MODE !== 'true') {
+  if (!isIsrMode()) {
     return new NextResponse('Asset serving only available in ISR mode', {
       status: 404,
     });