jamdesk 1.1.122 → 1.1.123

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.122",
+  "version": "1.1.123",
   "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",

package/vendored/lib/seo.ts

@@ -11,7 +11,7 @@
 import type { Metadata } from 'next';
 import type { DocsConfig, Logo, LogoConfig, Favicon, LanguageConfig, LanguageCode } from './docs-types';
 import { normalizeLogo } from './docs-types';
-import { findHreflangAliasCollisions, transformLanguagePath, toHreflang } from './language-utils';
+import { findHreflangAliasCollisions, transformLanguagePath, toHreflang, resolveLocaleFromPath } from './language-utils';
 import { logger } from '../shared/logger';
 
 // Dedupe per-process: same docs.json shape produces the same collision
@@ -228,6 +228,7 @@ function numericMeta(metatags: Record<string, string>, key: string): number | un
 
 type FallbackOg = {
   title?: string; description?: string; url: string; siteName: string; ogImageUrl: string;
+  locale?: string;
 };
 
 /**
@@ -261,7 +262,10 @@ export function buildOpenGraphMetadata(
   og.description = metatags['og:description'] || fb.description;
   og.url = metatags['og:url'] || fb.url;
   og.siteName = metatags['og:site_name'] || fb.siteName;
-  if (metatags['og:locale']) og.locale = metatags['og:locale'];
+  // Explicit og:locale wins; otherwise fall back to the locale derived from the
+  // page's resolved language (multi-language sites only — see derivePageLocale).
+  const ogLocale = metatags['og:locale'] || fb.locale;
+  if (ogLocale) og.locale = ogLocale;
   // og:determiner is a narrow Next union ('a'|'an'|'the'|'auto'|''); ignore invalid.
   if (['a', 'an', 'the', 'auto', ''].includes(metatags['og:determiner'])) {
     og.determiner = metatags['og:determiner'];
@@ -563,6 +567,31 @@ export function buildHreflangAlternates(
   return alternates;
 }
 
+/**
+ * Derive an `og:locale` value from the page's resolved language.
+ *
+ * Open Graph wants `language_TERRITORY` (underscore). We reuse the hreflang
+ * BCP-47 mapping and swap the hyphen for an underscore, so region-bearing codes
+ * map exactly (`pt-BR` → `pt_BR`, `fr-CA` → `fr_CA`, `cn` → `zh_Hans`) and bare
+ * codes emit the language alone (`fr` → `fr`). We deliberately do NOT invent a
+ * territory for bare codes — guessing `es_ES` for a Latin-American site would be
+ * worse than emitting `es`.
+ *
+ * Gated to multi-language sites: with one (or zero) declared languages we can't
+ * know the site's locale, so we emit nothing rather than guess `en`. The default
+ * (unprefixed) page resolves to the configured default language.
+ */
+function derivePageLocale(pagePath: string, languages?: LanguageConfig[]): string | undefined {
+  if (!languages || languages.length <= 1) return undefined;
+  const declared = languages.map((l) => l.language);
+  const fromPath = resolveLocaleFromPath(pagePath, declared);
+  const code = (fromPath
+    || languages.find((l) => l.default)?.language
+    || languages[0]?.language) as LanguageCode | undefined;
+  if (!code) return undefined;
+  return toHreflang(code).replace(/-/g, '_');
+}
+
 /**
  * Build SEO metadata for a documentation page.
  *
@@ -683,6 +712,7 @@ export function buildSeoMetadata(
       url: pageUrl,
       siteName: config.name,
       ogImageUrl,
+      locale: derivePageLocale(pagePath, languages),
     });
   }