jamdesk 1.1.134 → 1.1.136

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.134",
+  "version": "1.1.136",
   "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/app/api/markdown-export/[project]/[...slug]/route.ts

@@ -17,6 +17,7 @@ import { siteHasOpenApiSpecs } from '@/lib/api-specs-bundle';
 import { getContextualOptions } from '@/lib/contextual-defaults';
 import { isIsrMode, getBaseUrlFromConfig } from '@/lib/page-isr-helpers';
 import { apiSpecsMarkdownFooter } from '@/lib/api-specs-markdown-hint';
+import { injectAgentDirective } from '@/lib/agent-directive';
 import { logger } from '@/shared/logger';
 import type { DocsConfig } from '@/lib/docs-types';
 
@@ -60,10 +61,31 @@ export async function GET(
   }
 
   const filtered = filterVisibility(raw, 'agents');
-  // Arg order is load-bearing: `filtered` is the agent-visible body the footer
-  // is appended to; `raw` is the unfiltered source the helper reads frontmatter
-  // from (visibility filtering never touches the leading YAML block).
-  const body = await withApiSpecsHint(filtered, raw, project);
+
+  // One config fetch feeds both the directive (hostAtDocs link prefix) and the
+  // api-specs hint. A failed fetch must never 500 an export: directive falls
+  // back to the subdomain-rooted /llms.txt and the hint keeps its own defaults.
+  let config: DocsConfig | null = null;
+  try {
+    config = await fetchDocsConfig(project);
+  } catch (err) {
+    logger.warn('[markdown-export] config fetch failed', {
+      project,
+      error: err instanceof Error ? err.message : String(err),
+    });
+  }
+
+  // hostAtDocs rides the middleware-stamped header — the stored docs.json
+  // never carries it (runtime-only field, see DocsConfig), so reading it off
+  // `config` alone always resolved false in prod. The config check stays as a
+  // fallback for callers that bypassed the middleware rewrite.
+  const hostAtDocs =
+    request.headers.get('x-host-at-docs') === 'true' || !!config?.hostAtDocs;
+  const withDirective = injectAgentDirective(filtered, hostAtDocs);
+  // Arg order is load-bearing: `withDirective` is the agent-visible body the
+  // footer is appended to; `raw` is the unfiltered source the helper reads
+  // frontmatter from (visibility filtering never touches the leading YAML block).
+  const body = await withApiSpecsHint(withDirective, raw, project, config);
 
   // Two paths reach this handler via proxy rewrite:
   //   (a) `.md` URL: unique CDN cache key, safe to share.
@@ -102,6 +124,7 @@ async function withApiSpecsHint(
   markdown: string,
   raw: string,
   project: string,
+  config: DocsConfig | null,
 ): Promise<string> {
   try {
     if (!isIsrMode()) return markdown;
@@ -111,20 +134,10 @@ async function withApiSpecsHint(
     const pageHasApi = !!data.api;
     if (!(pageHasOpenApi || pageHasApi)) return markdown;
 
-    // Config drives the site-wide spec check, the menu-enabled check, and the
-    // hostAtDocs link prefix. A failure must not 500 the export and must not
-    // block a page-level `openapi:` page (which qualifies on its own). Treat a
-    // failed/missing config as "no site specs" but keep the default-enabled menu.
-    let config: DocsConfig | null = null;
-    try {
-      config = await fetchDocsConfig(project);
-    } catch (err) {
-      logger.warn('[api-specs-hint] config fetch failed', {
-        project,
-        error: err instanceof Error ? err.message : String(err),
-      });
-    }
-
+    // Config (fetched once in GET) drives the site-wide spec check, the
+    // menu-enabled check, and the hostAtDocs link prefix. A failed/missing
+    // config must not block a page-level `openapi:` page (which qualifies on
+    // its own): treat it as "no site specs" but keep the default-enabled menu.
     const zipUrl = `${getBaseUrlFromConfig(project, !!config?.hostAtDocs)}/api-specs.zip`;
 
     const footer = apiSpecsMarkdownFooter({

package/vendored/components/mdx/Widget.tsx

@@ -129,12 +129,12 @@ export function Widget({
 
   if (trigger) return null;
 
-  return (
+  const buttonEl = (
     <button
       type="button"
       id={buttonId}
       className={
-        'jd-widget-trigger my-4 inline-flex cursor-pointer items-center gap-2 rounded-lg ' +
+        'jd-widget-trigger inline-flex cursor-pointer items-center gap-2 rounded-lg ' +
         'border border-gray-200 bg-white px-4 py-2 text-sm font-medium ' +
         'text-gray-900 shadow-sm transition hover:shadow-md ' +
         'dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100' +
@@ -145,4 +145,23 @@ export function Widget({
       {label}
     </button>
   );
+
+  // No slug → the trigger can't bind (see the effect above), which is the
+  // normal state in local `jamdesk dev`. Render a visible caption beside the
+  // button so a clicked-but-inert button doesn't read as broken — the console
+  // hint alone is invisible to anyone without devtools open. Never renders in
+  // the deployed build, where the slug is always set and the button works.
+  if (!resolvedBase) {
+    return (
+      <span className="jd-widget-preview my-4 flex flex-col items-start gap-1.5">
+        {buttonEl}
+        <span className="text-xs text-gray-500 dark:text-gray-400">
+          Live preview — opens on your deployed docs site, not in local{' '}
+          <code className="rounded bg-gray-100 px-1 py-0.5 dark:bg-gray-800">jamdesk dev</code>.
+        </span>
+      </span>
+    );
+  }
+
+  return <span className="jd-widget my-4 inline-flex">{buttonEl}</span>;
 }

package/vendored/lib/agent-directive.tsx

@@ -0,0 +1,101 @@
+// builder/build-service/lib/agent-directive.tsx
+import React from 'react';
+
+/**
+ * Agent-facing llms.txt directive (agentdocsspec.com "llms-txt-directive-html"
+ * and "llms-txt-directive-md" checks).
+ *
+ * Most AI agents fetch HTML by default and have no signal that a markdown
+ * path exists. The HTML variant is visually hidden but present in the DOM
+ * near the top of <body>, so HTML→markdown conversion surfaces it first.
+ * aria-hidden keeps it out of the accessibility tree — screen readers must
+ * not announce it on every page.
+ */
+
+/** Site-relative llms.txt path. Relative URLs resolve against the fetch origin. */
+export function llmsTxtPath(hostAtDocs: boolean): string {
+  return hostAtDocs ? '/docs/llms.txt' : '/llms.txt';
+}
+
+/** Plain-text directive for the hidden HTML element — points agents at llms.txt and the .md exports. */
+export function agentDirectiveText(hostAtDocs: boolean): string {
+  return (
+    `For AI agents: the documentation index for this site is at ${llmsTxtPath(hostAtDocs)}. ` +
+    'For a markdown version of any page, append .md to its URL or request it ' +
+    'with Accept: text/markdown.'
+  );
+}
+
+/** Single-line blockquote — markdown pages put this directly after frontmatter. */
+export function agentDirectiveMarkdown(hostAtDocs: boolean): string {
+  return (
+    `> **For AI agents:** the complete documentation index is at ` +
+    `[llms.txt](${llmsTxtPath(hostAtDocs)}). Append \`.md\` to any page URL ` +
+    'for its markdown version.'
+  );
+}
+
+/**
+ * Frontmatter must stay first — tools parse the leading YAML block. Anchored
+ * match only (a `---` thematic break mid-document is not frontmatter). The
+ * closing fence may sit at EOF with no trailing newline — R2 user content
+ * doesn't guarantee one (cf. frontmatter-utils.ts).
+ */
+const FRONTMATTER_RE = /^\uFEFF?---\r?\n[\s\S]*?\r?\n---(\r?\n|$)/;
+
+export function injectAgentDirective(markdown: string, hostAtDocs: boolean): string {
+  if (agentDirectiveDisabled()) return markdown;
+  const directive = agentDirectiveMarkdown(hostAtDocs);
+  const m = markdown.match(FRONTMATTER_RE);
+  if (m) {
+    const head = m[0];
+    const rest = markdown.slice(head.length).replace(/^\r?\n/, '');
+    return `${head}\n${directive}\n\n${rest}`;
+  }
+  return `${directive}\n\n${markdown}`;
+}
+
+/** Inline (not Tailwind) so it works on every theme and in vendored CLI dev. */
+const SR_ONLY: React.CSSProperties = {
+  position: 'absolute',
+  width: 1,
+  height: 1,
+  padding: 0,
+  margin: -1,
+  overflow: 'hidden',
+  clip: 'rect(0, 0, 0, 0)',
+  whiteSpace: 'nowrap',
+  border: 0,
+};
+
+/**
+ * Env kill switch — disable the directive fleet-wide without a code revert
+ * (precedent: EMBED_WIDGET_ENABLED, JD_PRUNE_CONTENT_DISABLED). Vercel env
+ * change + redeploy beats reverting three surfaces.
+ */
+export function agentDirectiveDisabled(): boolean {
+  // Lenient env-flag semantics, matching isCacheDisabled() (cached-redis.ts)
+  // and envFlag() (r2-cleanup.ts): Vercel env values can pick up trailing
+  // newlines, and operators set "true" as often as "1". Implemented locally —
+  // importing envFlag from r2-cleanup would pull @aws-sdk into a
+  // layout-rendered file.
+  const v = process.env.JD_AGENT_DIRECTIVE_DISABLED?.trim().toLowerCase();
+  if (!v) return false;
+  return v !== '0' && v !== 'false';
+}
+
+export function AgentDirective({ hostAtDocs }: { hostAtDocs: boolean }) {
+  if (agentDirectiveDisabled()) return null;
+  return (
+    // data-nosnippet keeps Google from surfacing the directive as a search
+    // snippet on description-less pages. The real <a> is what afdocs'
+    // LINK_PATTERN prefers and what DOM-walking agents can follow;
+    // tabIndex={-1} because an aria-hidden subtree must not be tabbable.
+    <div data-jd-agent-directive aria-hidden="true" data-nosnippet="" style={SR_ONLY}>
+      {agentDirectiveText(hostAtDocs)}{' '}
+      <a href={llmsTxtPath(hostAtDocs)} tabIndex={-1}>
+        llms.txt
+      </a>
+    </div>
+  );
+}

package/vendored/lib/icon-utils.ts

@@ -24,6 +24,7 @@ const brandIcons = new Set([
   'flickr',
   'goodreads',
   'guilded',
+  'hacker-news',
   'instagram',
   'kakao-talk',
   'line',

package/vendored/lib/language-utils.ts

@@ -335,7 +335,9 @@ export function transformLanguagePath(
 }
 
 /**
- * Check if a string is a valid language code
+ * Case-SENSITIVE membership test: only canonical-cased codes ('fr-CA', not
+ * 'fr-ca') return true. For URL segments or declared docs.json codes — which
+ * may carry any casing — use isKnownLanguageCode instead.
  */
 export function isValidLanguageCode(code: string): code is LanguageCode {
   return code in LANGUAGE_DISPLAY_NAMES;
@@ -358,6 +360,31 @@ const LANGUAGE_CODE_BY_LOWER: Map<string, LanguageCode> = (() => {
   return m;
 })();
 
+/**
+ * Case-insensitive membership test against the supported language-code list.
+ * Use this (not the case-sensitive isValidLanguageCode) for input that may
+ * carry declared or URL-sourced casing (e.g. 'fr-ca' declared in docs.json,
+ * '/fr-ca/' URL segment).
+ */
+export function isKnownLanguageCode(code: string): boolean {
+  return LANGUAGE_CODE_BY_LOWER.has(code.toLowerCase());
+}
+
+/**
+ * Display name for a declared language code, tolerant of casing drift.
+ * Direct `LANGUAGE_DISPLAY_NAMES` hit first, then the lowered canonical map
+ * above (declared `'pt-br'` → canonical `'pt-BR'` → 'Português (BR)' —
+ * display-name keys are canonical-cased, so a strict keyed lookup would
+ * silently fall back to the bare code for lowercase region variants), else
+ * the bare code. Used by llms.txt cross-language links.
+ */
+export function languageDisplayName(code: string): string {
+  const direct = (LANGUAGE_DISPLAY_NAMES as Record<string, string>)[code];
+  if (direct) return direct;
+  const canonical = LANGUAGE_CODE_BY_LOWER.get(code.toLowerCase());
+  return canonical ? LANGUAGE_DISPLAY_NAMES[canonical] : code;
+}
+
 /**
  * Extract language code from a pathname
  *

package/vendored/lib/layout-helpers.tsx

@@ -25,6 +25,7 @@ import type { BackgroundConfig, DocsConfig, FontConfig, LanguageCode } from '@/l
 import { LinkPrefixProvider } from '@/lib/link-prefix-context';
 import { ProjectSlugProvider } from '@/lib/project-slug-context';
 import { getAnalyticsScript } from '@/lib/analytics-script';
+import { AgentDirective } from './agent-directive';
 import { fetchCustomCss, fetchCustomJs } from '@/lib/r2-content';
 import { toHreflang } from '@/lib/language-utils';
 
@@ -655,6 +656,7 @@ export async function DocsChrome({
         )}
       </head>
       <body className={fontClassName} data-theme={themeName || 'jam'} data-decoration={decoration || undefined} suppressHydrationWarning>
+        {!embed && <AgentDirective hostAtDocs={!!config.hostAtDocs} />}
         {config.integrations?.gtm?.tagId && (
           <ConditionalGTM gtmId={config.integrations.gtm.tagId} />
         )}

package/vendored/lib/r2-cleanup.ts

@@ -12,6 +12,7 @@ import {
   ListObjectsV2Command,
 } from '@aws-sdk/client-s3';
 import { getR2S3Client, getR2Config } from './r2.js';
+import { isKnownLanguageCode } from './language-utils.js';
 import { logger } from '../shared/logger.js';
 
 // AWS / R2 cap DeleteObjects to 1000 keys per request. Match ListObjectsV2's
@@ -315,6 +316,79 @@ export async function pruneRemovedContent(
   return { deleted, failed, skipped: false };
 }
 
+/**
+ * Given top-level CommonPrefixes from a delimiter='/' listing of `{slug}/`,
+ * return per-locale llms.txt keys whose locale is a KNOWN language code but
+ * is no longer declared — left behind when a project removes a language.
+ * Only ever targets our own `<locale>/llms.txt` artifact keys, so content
+ * dirs (content/, snippets/, openapi/, assets/) can never be touched.
+ */
+export function staleLocaleLlmsKeys(
+  commonPrefixes: string[],
+  projectSlug: string,
+  activeLocales: Set<string>,
+): string[] {
+  const keys: string[] = [];
+  for (const prefix of commonPrefixes) {
+    if (!prefix.startsWith(`${projectSlug}/`)) continue;
+    const dir = prefix.slice(projectSlug.length + 1).replace(/\/$/, '');
+    if (!dir || dir.includes('/')) continue;
+    if (!isKnownLanguageCode(dir)) continue;
+    // Case-sensitive has() is correct here: activeLocales keys use declared
+    // casing, which matches the R2 paths this build just uploaded. A dir whose
+    // casing differs is either a renamed locale or a leftover from a prior
+    // casing change — both legitimately stale.
+    if (activeLocales.has(dir)) continue;
+    keys.push(`${projectSlug}/${dir}/llms.txt`);
+  }
+  return keys;
+}
+
+/**
+ * List `{slug}/`'s top-level dirs and delete `<locale>/llms.txt` for any
+ * known-language dir no longer declared. Paginates the listing like
+ * deleteAllProjectR2Objects — a delimiter listing of a huge project could
+ * truncate, and an abandoned page would silently orphan its stale locales.
+ * Non-fatal by contract: callers treat a throw as a warning — a stale
+ * locale index is a cosmetic orphan.
+ */
+export async function sweepStaleLocaleLlmsTxt(
+  projectSlug: string,
+  activeLocales: Set<string>,
+): Promise<string[]> {
+  const client = getR2S3Client();
+  const { bucketName } = getR2Config();
+  const prefixes: string[] = [];
+  let continuationToken: string | undefined;
+
+  do {
+    const listed: {
+      CommonPrefixes?: Array<{ Prefix?: string }>;
+      IsTruncated?: boolean;
+      NextContinuationToken?: string;
+    } = await client.send(
+      new ListObjectsV2Command({
+        Bucket: bucketName,
+        Prefix: `${projectSlug}/`,
+        Delimiter: '/',
+        ContinuationToken: continuationToken,
+      }),
+    );
+    for (const p of listed.CommonPrefixes ?? []) {
+      if (typeof p.Prefix === 'string') prefixes.push(p.Prefix);
+    }
+    continuationToken = listed.IsTruncated ?
+      listed.NextContinuationToken :
+      undefined;
+  } while (continuationToken);
+
+  const staleKeys = staleLocaleLlmsKeys(prefixes, projectSlug, activeLocales);
+  for (const key of staleKeys) {
+    await client.send(new DeleteObjectCommand({ Bucket: bucketName, Key: key }));
+  }
+  return staleKeys;
+}
+
 /**
  * Delete EVERY R2 object under the `{slug}/` prefix.
  *

package/vendored/lib/seo.ts

@@ -710,13 +710,15 @@ export function buildSeoMetadata(
   if (hasOgFamily || frontmatter.title) {
     // A custom og:image becomes the card BACKGROUND (text renders on top) rather
     // than a bare static image, so the emitted OG image is always the generated card.
+    // The card text follows og:title/og:description overrides so the image matches
+    // the link-card text built in buildOpenGraphMetadata.
     const customImage = metatags['og:image']?.trim();
     const ogImageUrl = buildOgImageUrl(
       baseUrl,
-      frontmatter.title || 'Documentation',
+      metatags['og:title'] || frontmatter.title || 'Documentation',
       config.name,
       {
-        description: frontmatter.description,
+        description: metatags['og:description'] || frontmatter.description,
         section: frontmatter.section,
         logo: config.logo,
         favicon: config.favicon,

package/vendored/lib/static-artifacts.ts

@@ -10,6 +10,8 @@ import { RECURSE_KEYS } from './enhance-navigation.js';
 import { filterVisibility } from './visibility-filter.js';
 import {
   buildLoweredLocaleSet,
+  languageDisplayName,
+  resolveLanguageWithFallback,
   resolveLocaleFromPath,
   resolveLocaleWithLoweredSet,
 } from './language-utils.js';
@@ -170,6 +172,22 @@ export interface LlmsTxtOptions {
    * handling across all artifacts.
    */
   visibility?: VisibilityInputs;
+  /** Page path → section title (from extractNavigationSections). Nav order matters. */
+  sections?: Map<string, string>;
+  /** Cross-links to sibling-locale llms.txt files; rendered as the final H2 section. */
+  otherLanguages?: Array<{ label: string; url: string }>;
+}
+
+/**
+ * llmstxt.org reserves the bare "## Optional" heading as a skip-signal —
+ * agents wanting shorter context may drop that whole section. A customer
+ * tab/group literally named "Optional" must not inherit that semantics (its
+ * pages would be silently skipped) nor collide with our cross-language
+ * section, so nav sections render a disambiguated heading; only the language
+ * cross-link section emits the reserved bare name.
+ */
+function renderSectionName(section: string): string {
+  return section === 'Optional' ? 'Optional (docs)' : section;
 }
 
 /**
@@ -182,7 +200,10 @@ export interface LlmsTxtOptions {
  * @returns Plain text string
  */
 export function generateLlmsTxt(options: LlmsTxtOptions): string {
-  const { name, description, baseUrl, pages, hostAtDocs = false, visibility } = options;
+  const {
+    name, description, baseUrl, pages, hostAtDocs = false, visibility,
+    sections, otherLanguages,
+  } = options;
 
   // NOTE: noindex is intentionally NOT respected here. AI agents fetch llms.txt
   // directly and do not honor robots directives, so this file is generated
@@ -192,20 +213,158 @@ export function generateLlmsTxt(options: LlmsTxtOptions): string {
   const urlPrefix = hostAtDocs ? '/docs' : '';
 
   let output = `# ${name}\n\n`;
+  // Always emit the blockquote — llms-txt-valid requires H1 + blockquote +
+  // sections, and most projects never set a docs.json description.
+  output += `> ${description || `Documentation for ${name}.`}\n\n`;
+
+  const included = pages.filter((page) => isPageMetadataIncluded(page, visibility));
+
+  // Bucket pages by section. Section order = nav order (Map insertion order);
+  // pages keep nav order within a section via their index in the sections Map.
+  // Unsectioned pages land in a trailing "Documentation" bucket.
+  const FALLBACK_SECTION = 'Documentation';
+  const sectionOrder: string[] = sections ? [...new Set(sections.values())] : [];
+  const navIndex = new Map<string, number>(
+    sections ? [...sections.keys()].map((p, i) => [p, i] as const) : [],
+  );
+  const buckets = new Map<string, typeof included>();
+  for (const page of included) {
+    const section = sections?.get(page.path) ?? FALLBACK_SECTION;
+    if (!buckets.has(section)) buckets.set(section, []);
+    buckets.get(section)!.push(page);
+  }
+  const orderedSections = [
+    ...sectionOrder.filter((s) => buckets.has(s)),
+    ...(buckets.has(FALLBACK_SECTION) && !sectionOrder.includes(FALLBACK_SECTION)
+      ? [FALLBACK_SECTION]
+      : []),
+  ];
 
-  if (description) {
-    output += `> ${description}\n\n`;
+  for (const section of orderedSections) {
+    output += `## ${renderSectionName(section)}\n\n`;
+    const bucket = buckets.get(section)!;
+    // `?? 0` (not Infinity): named buckets always carry nav indexes, so the
+    // fallback only fires in the Documentation bucket where EVERY page lacks
+    // one — all-zero comparisons let the stable sort keep page-array order.
+    // (`Infinity - Infinity` = NaN, a spec-undefined comparator result.)
+    bucket.sort((a, b) => (navIndex.get(a.path) ?? 0) - (navIndex.get(b.path) ?? 0));
+    for (const page of bucket) {
+      const url = `${baseUrl}${urlPrefix}/${page.path}.md`;
+      // Frontmatter strings can carry raw newlines — collapse them so a
+      // crafted title/description can't forge fake "## " section headings or
+      // split the entry across lines (llms.txt is line-oriented).
+      const safeTitle = page.title.replace(/[\r\n]+/g, ' ');
+      const desc = page.description ? `: ${page.description.replace(/[\r\n]+/g, ' ')}` : '';
+      output += `- [${safeTitle}](${url})${desc}\n`;
+    }
+    output += '\n';
+  }
+
+  if (otherLanguages && otherLanguages.length > 0) {
+    // llmstxt.org reserves "## Optional" as the skip-signal section — agents
+    // wanting shorter context skip it, agents needing another language still
+    // see the links. Descriptive labels keep it human-readable.
+    output += `## Optional\n\n`;
+    for (const lang of otherLanguages) {
+      output += `- [${lang.label}](${lang.url}): ${lang.label} documentation index\n`;
+    }
+    output += '\n';
   }
 
+  return output.trim();
+}
+
+/**
+ * Options for generating the per-locale llms.txt file set.
+ */
+export interface LlmsTxtFilesOptions extends Omit<LlmsTxtOptions, 'sections' | 'otherLanguages'> {
+  /** docs.json navigation — source of the H2 section mapping. */
+  navigation?: NavigationConfig;
+  /** Declared languages (navigation.languages) — drives the locale split. */
+  languages?: LanguageConfig[];
+}
+
+/**
+ * Render the root llms.txt (default locale) plus one file per declared,
+ * non-hidden, non-default language. Locale membership comes from the page
+ * path prefix (resolveLocaleFromPath, whitelisted against declared codes —
+ * same semantics as the search index), NOT from nav position. Cross-links
+ * between locale files render under the trailing "## Optional" section.
+ */
+export function generateLlmsTxtFiles(
+  options: LlmsTxtFilesOptions,
+): { root: string; byLocale: Record<string, string> } {
+  const { navigation, languages, baseUrl, hostAtDocs = false, pages, ...rest } = options;
+  const urlPrefix = hostAtDocs ? '/docs' : '';
+  const sections = extractNavigationSections(navigation);
+
+  const declared = (languages ?? []).filter(
+    (l): l is LanguageConfig & { language: string } =>
+      typeof l.language === 'string' && !l.hidden,
+  );
+  // Dedupe case-insensitively, first declaration wins: a language declared
+  // twice in docs.json would otherwise render its cross-link twice in every
+  // "## Optional" section.
+  const codes = declared
+    .map((l) => l.language)
+    .filter(
+      (code, i, all) =>
+        all.findIndex((c) => c.toLowerCase() === code.toLowerCase()) === i,
+    );
+  const defaultCode = resolveLanguageWithFallback(null, languages);
+
+  if (codes.length === 0) {
+    const root = generateLlmsTxt({ ...rest, baseUrl, hostAtDocs, pages, sections });
+    return { root, byLocale: {} };
+  }
+
+  const byLocalePages = new Map<string, typeof pages>();
   for (const page of pages) {
-    if (!isPageMetadataIncluded(page, visibility)) continue;
+    // resolveLocaleFromPath returns '' (NOT the default code) for unprefixed
+    // paths and for prefixes outside the whitelist — both belong to the root
+    // (default-locale) file. `|| defaultCode` is load-bearing: without it,
+    // every standard site's root llms.txt would render empty.
+    // `.toLowerCase()` is equally load-bearing: the resolver returns the
+    // CANONICAL casing (e.g. 'fr-CA' for a declared 'fr-ca'), so bucketing by
+    // its raw return and reading back by the declared code would silently
+    // drop those pages from every llms.txt file.
+    const locale = (resolveLocaleFromPath(page.path, codes) || defaultCode).toLowerCase();
+    if (!byLocalePages.has(locale)) byLocalePages.set(locale, []);
+    byLocalePages.get(locale)!.push(page);
+  }
+
+  const llmsUrl = (code: string): string =>
+    code === defaultCode
+      ? `${baseUrl}${urlPrefix}/llms.txt`
+      : `${baseUrl}${urlPrefix}/${code}/llms.txt`;
+  // Declared-but-untranslated languages produce empty files nobody should be
+  // sent to — generate and cross-link only locales that actually have pages
+  // (the default locale always exists as the root file).
+  const activeCodes = codes.filter(
+    (c) => c === defaultCode || (byLocalePages.get(c.toLowerCase())?.length ?? 0) > 0,
+  );
+  const activeCrossLinks = (selfCode: string) =>
+    activeCodes
+      .filter((c) => c !== selfCode)
+      .map((c) => ({ label: languageDisplayName(c), url: llmsUrl(c) }));
+
+  const root = generateLlmsTxt({
+    ...rest, baseUrl, hostAtDocs, sections,
+    pages: byLocalePages.get(defaultCode.toLowerCase()) ?? [],
+    otherLanguages: activeCrossLinks(defaultCode),
+  });
 
-    const url = `${baseUrl}${urlPrefix}/${page.path}.md`;
-    const desc = page.description ? `: ${page.description}` : '';
-    output += `- [${page.title}](${url})${desc}\n`;
+  const byLocale: Record<string, string> = {};
+  for (const code of activeCodes) {
+    if (code === defaultCode) continue;
+    byLocale[code] = generateLlmsTxt({
+      ...rest, baseUrl, hostAtDocs, sections,
+      pages: byLocalePages.get(code.toLowerCase()) ?? [],
+      otherLanguages: activeCrossLinks(code),
+    });
   }
 
-  return output.trim();
+  return { root, byLocale };
 }
 
 /**
@@ -332,6 +491,64 @@ export function extractNavigationPaths(
   return paths;
 }
 
+/** Container keys whose string value names a section, checked in order. */
+const SECTION_NAME_KEYS = ['tab', 'group', 'dropdown', 'product', 'anchor'] as const;
+
+/**
+ * Map every nav page path to its OUTERMOST named container (tab > top-level
+ * group > dropdown/product/legacy-anchor). Languages and versions are
+ * transparent: locale is derived from the page path, not the section, so
+ * "Guides" in the fr subtree and the en subtree share a section name.
+ * First mapping wins (a page referenced twice keeps its first home).
+ * Insertion order of values follows nav order — generateLlmsTxt relies on it.
+ *
+ * Traverses the same tree shapes as extractNavigationPaths above — keep the
+ * two walkers' pages-handling in sync.
+ */
+export function extractNavigationSections(
+  navigation: NavigationConfig | undefined,
+): Map<string, string> {
+  const sections = new Map<string, string>();
+  if (!navigation) return sections;
+
+  function walk(node: Record<string, unknown>, inherited: string | null): void {
+    let section = inherited;
+    if (!section) {
+      for (const key of SECTION_NAME_KEYS) {
+        if (typeof node[key] === 'string') {
+          section = (node[key] as string).replace(/\s+/g, ' ').trim();
+          break;
+        }
+      }
+    }
+
+    if (Array.isArray(node.pages)) {
+      for (const item of node.pages) {
+        if (typeof item === 'string') {
+          if (section && !sections.has(item)) sections.set(item, section);
+        } else if (typeof item === 'object' && item !== null) {
+          const obj = item as Record<string, unknown>;
+          if (typeof obj.page === 'string' && section && !sections.has(obj.page)) {
+            sections.set(obj.page, section);
+          }
+          if ('group' in obj) walk(obj, section);
+        }
+      }
+    }
+
+    for (const key of RECURSE_KEYS) {
+      if (Array.isArray(node[key])) {
+        for (const child of node[key] as Record<string, unknown>[]) {
+          walk(child, section);
+        }
+      }
+    }
+  }
+
+  walk(navigation as Record<string, unknown>, null);
+  return sections;
+}
+
 /**
  * Page info with content for llms-full.txt generation.
  */
@@ -447,6 +664,8 @@ export interface GenerateAllOptions {
   llmsFullPages?: LlmsFullPageInfo[];
   /** Language configurations (forwarded to sitemap for hreflang siblings) */
   languages?: LanguageConfig[];
+  /** docs.json navigation tree (enhanced) — powers llms.txt H2 sections. */
+  navigation?: NavigationConfig;
   /**
    * Visibility inputs from lib/visibility.ts. When provided, all artifact
    * generators use computePageVisibility for consistent hidden/orphan/searchable
@@ -463,6 +682,8 @@ export interface GenerateAllOptions {
 export interface GeneratedArtifacts {
   sitemap: string;
   llmsTxt: string;
+  /** Non-default-locale llms.txt files, keyed by language code. */
+  llmsTxtByLocale: Record<string, string>;
   llmsFullTxt: string;
   robotsTxt: string;
   rssFeed: string | null;
@@ -484,12 +705,13 @@ export interface GeneratedArtifacts {
 export function generateAllArtifacts(options: GenerateAllOptions): GeneratedArtifacts {
   const {
     baseUrl, name, description, pages, hostAtDocs, noindex, rssPages, llmsFullPages, languages,
-    visibility,
+    navigation, visibility,
   } = options;
 
   const sitemap = generateSitemap({ baseUrl, pages, hostAtDocs, noindex, languages, visibility });
-  const llmsTxt = generateLlmsTxt({
+  const { root: llmsTxt, byLocale: llmsTxtByLocale } = generateLlmsTxtFiles({
     name, description, baseUrl, pages, hostAtDocs, noindex, visibility,
+    navigation, languages,
   });
   const llmsFullTxt = llmsFullPages
     ? generateLlmsFullTxt({ name, pages: llmsFullPages, noindex, visibility })
@@ -510,7 +732,7 @@ export function generateAllArtifacts(options: GenerateAllOptions): GeneratedArti
 
   const changelog = generateChangelog(updates);
 
-  return { sitemap, llmsTxt, llmsFullTxt, robotsTxt, rssFeed, changelog };
+  return { sitemap, llmsTxt, llmsTxtByLocale, llmsFullTxt, robotsTxt, rssFeed, changelog };
 }
 
 // =============================================================================

package/vendored/lib/static-file-route.ts

@@ -11,6 +11,7 @@ import path from 'path';
 
 import { NextRequest, NextResponse } from 'next/server';
 
+import { isKnownLanguageCode } from '@/lib/language-utils';
 import { log } from '@/lib/logger';
 import { isIsrMode } from '@/lib/page-isr-helpers';
 import { fetchStaticFile } from '@/lib/r2-content';
@@ -22,6 +23,9 @@ export const STATIC_FILE_NAMES = [
 ] as const;
 
 /** All CDN paths for static file routes — used by revalidation to purge CDN cache. */
+// Per-locale llms.txt paths (/{locale}/llms.txt) are intentionally absent:
+// locales are per-project, unenumerable here. They self-heal via s-maxage=3600,
+// identical to llms.txt's behavior between explicit purges.
 export const STATIC_REVALIDATION_PATHS = STATIC_FILE_NAMES.flatMap(
   f => [`/${f}`, `/docs/${f}`]
 );
@@ -129,6 +133,63 @@ export function createCorsStaticFileHandler(
   };
 }
 
+/**
+ * GET handler for per-locale llms.txt (`/{locale}/llms.txt`, `/docs/{locale}/llms.txt`).
+ *
+ * Locale is validated (case-insensitively) against the supported language-code
+ * list BEFORE any R2 I/O so arbitrary path segments (`/foo/llms.txt`) fast-404.
+ * Like llms.txt, locale files are intentionally NOT suppressed on
+ * `x-jd-noindex` — AI agents fetch them directly and don't honor robots
+ * semantics.
+ */
+export function createLocaleLlmsTxtHandler(): (
+  request: NextRequest,
+  ctx: { params: Promise<{ locale: string }> },
+) => Promise<NextResponse> {
+  return async function GET(request, ctx): Promise<NextResponse> {
+    const { locale } = await ctx.params;
+    if (!isKnownLanguageCode(locale)) {
+      return new NextResponse('Not found', { status: 404 });
+    }
+    // Fetch with the segment verbatim: R2 keys are written with the DECLARED
+    // code, and every advertised URL is generated from that same code, so
+    // segment casing and key casing always agree for real links.
+    const filename = `${locale}/llms.txt`;
+
+    if (!isIsrMode()) {
+      const localPath = path.join(process.cwd(), 'public', filename);
+      if (fs.existsSync(localPath)) {
+        return new NextResponse(fs.readFileSync(localPath), {
+          headers: { 'Content-Type': 'text/plain; charset=utf-8', 'Cache-Control': 'no-cache' },
+        });
+      }
+      return new NextResponse('Not found', { status: 404 });
+    }
+
+    const projectSlug = request.headers.get('x-project-slug');
+    if (!projectSlug) {
+      log('warn', 'Locale llms.txt request missing project slug');
+      return new NextResponse('Project not found', { status: 404 });
+    }
+
+    try {
+      const content = await fetchStaticFile(projectSlug, filename);
+      if (content === null) {
+        return new NextResponse('Not found', { status: 404 });
+      }
+      return new NextResponse(content, {
+        headers: {
+          'Content-Type': 'text/plain; charset=utf-8',
+          'Cache-Control': 'public, max-age=3600, s-maxage=3600',
+        },
+      });
+    } catch (error) {
+      log('error', 'Error serving locale llms.txt', { projectSlug, locale, error: String(error) });
+      return new NextResponse('Error serving locale llms.txt', { status: 500 });
+    }
+  };
+}
+
 /**
  * Create a GET handler that serves a static file from R2.
  *

package/vendored/themes/pulsar/variables.css

@@ -764,6 +764,12 @@ body[data-theme="pulsar"] header [data-theme-toggle] {
   body[data-theme="pulsar"] #content-scroll-container {
     display: flex;
     justify-content: center;
+    /* Without this, the default stretch pins the article's height to the
+     * visible container height; long content overflows the article box, the
+     * article's bottom padding lands mid-page, and the scroll area ends flush
+     * against the footer's last pixel ("Powered by Jamdesk" touching the
+     * viewport bottom). flex-start restores the article's natural height. */
+    align-items: flex-start;
     /* Hide scrollbar but keep scrollable */
     scrollbar-width: none; /* Firefox */
     -ms-overflow-style: none; /* IE/Edge */

package/vendored/workspace-package-lock.json

@@ -912,15 +912,15 @@
       }
     },
     "node_modules/@next/env": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/env/-/env-16.2.7.tgz",
-      "integrity": "sha512-tMJizPlj6ZYpBMMdK8S0LJufrP4QTdR6pcv9KQ/bVETPAmg0j1mlHE9G2c38UyGHxoBapgwuj7XjbGJ2RcDFOg==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/env/-/env-16.2.9.tgz",
+      "integrity": "sha512-ki5VxxXfzD/9TDe13wyeTKIjQTAwBVpnr8KhRDUr8ltMUq1/NBpWNT5tiPoxiGl+PHM4X2ahSOiPk6iAimIzPg==",
       "license": "MIT"
     },
     "node_modules/@next/mdx": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/mdx/-/mdx-16.2.7.tgz",
-      "integrity": "sha512-4RmM0KISxvfHr37/cn9TAGD2oy1nvTQ+ycgknz2xpd8IrY980N7XDU3CXhfKOXPhIVgbshxFF9HQEQC32ZVa9A==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/mdx/-/mdx-16.2.9.tgz",
+      "integrity": "sha512-SdweShKGCuN639JjyFSMQ8uldo+I+254+HucpjwdbFfaWHqUNN6dnQ1Of6laahnFyo48CcfDXEc2OBCS/Wfngw==",
       "license": "MIT",
       "dependencies": {
         "source-map": "^0.7.0"
@@ -939,9 +939,9 @@
       }
     },
     "node_modules/@next/swc-darwin-arm64": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-16.2.7.tgz",
-      "integrity": "sha512-vm1EDI/pVaBNNiychmxk3fft+OhQPVD9cIM/tReLZIQ3TfQ4kqI9DwKk00dzuS1ulC7icbrzCFrmRRlk9PfNdw==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-16.2.9.tgz",
+      "integrity": "sha512-HkfxNYUCmcct0Xsqib5KxqMSHV4AHJq857BNRchyBDs4YS19aHzVfn1kDuBYKqLLQBjXgnkIsjV2Kd4d2wzYhw==",
       "cpu": [
         "arm64"
       ],
@@ -955,9 +955,9 @@
       }
     },
     "node_modules/@next/swc-darwin-x64": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/swc-darwin-x64/-/swc-darwin-x64-16.2.7.tgz",
-      "integrity": "sha512-O3IRSv1ZBL1zs0WrIgefTEcTKFVn+ryxBNe54erJ6KsD+2f/Mmt7g2jOYh8PSBdUwPtKQJuCsTMlZ7tIu2AcsQ==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/swc-darwin-x64/-/swc-darwin-x64-16.2.9.tgz",
+      "integrity": "sha512-7IAtK4MeybpqRV9GRABWEhJ62mOS+rzWOzOTFie4cSEtm12xsoOMJRcECoZx3FHPzFAqN/IJtHqWAFOLfl152w==",
       "cpu": [
         "x64"
       ],
@@ -971,9 +971,9 @@
       }
     },
     "node_modules/@next/swc-linux-arm64-gnu": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-gnu/-/swc-linux-arm64-gnu-16.2.7.tgz",
-      "integrity": "sha512-Re6PZtjBDd0aMU+VcZcC/PrIvj4WhrjDYtMhhCVQamWN4L90EVP0pcEOBQD25prSlw7OzNw5QpHLWMilRLsRNw==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-gnu/-/swc-linux-arm64-gnu-16.2.9.tgz",
+      "integrity": "sha512-hBD75iWpUtkL9SmQmcRhmLomn9jgkPzCEkbOcLgHymPEKzv+6ONy13RRiIEz/iEObjkS2Jlb5gYS2XGoS3X4rw==",
       "cpu": [
         "arm64"
       ],
@@ -990,9 +990,9 @@
       }
     },
     "node_modules/@next/swc-linux-arm64-musl": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-musl/-/swc-linux-arm64-musl-16.2.7.tgz",
-      "integrity": "sha512-qyogG9QtBzWxgJfeGBvOEHI3851gTfCF3wLZ5RDLTBJGAmE9p1qDwKCOdrBrvBzRvYDT+gUDp72pzlSEfAXgNA==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-musl/-/swc-linux-arm64-musl-16.2.9.tgz",
+      "integrity": "sha512-qZTI3pf9SGc/obr8NkQAekBxmp1QK+kVm+VAf3BALLfFAj+1kUhkTxmrWpVos9R/UYIA8AWX2p6cGI5WdwzVUA==",
       "cpu": [
         "arm64"
       ],
@@ -1009,9 +1009,9 @@
       }
     },
     "node_modules/@next/swc-linux-x64-gnu": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-gnu/-/swc-linux-x64-gnu-16.2.7.tgz",
-      "integrity": "sha512-Vhe4ZDuBpmMogrGi5D4R2Kq4JAQlj6+wvgaFYy31zfES0zPmt6TLA+cuYpM/OLrPZjo2MYQTHVqNUSCR6+fDZQ==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-gnu/-/swc-linux-x64-gnu-16.2.9.tgz",
+      "integrity": "sha512-xm0HfRNX+UkH4R3c18ynswjj5o5uEj/7iI9p9omdtTSIsRCzQqkGMA+10nzJ4EHnYC3as65IMhbbl5fWRUWHYg==",
       "cpu": [
         "x64"
       ],
@@ -1028,9 +1028,9 @@
       }
     },
     "node_modules/@next/swc-linux-x64-musl": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-musl/-/swc-linux-x64-musl-16.2.7.tgz",
-      "integrity": "sha512-srvian89JahFLw1YLBEuhvPJ0DO5lpUeJQMXy4xYo7g628ZlNgXdNkqoxSAv9OYrBfByh6vxISMwW/mRbzCY+g==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-x64-musl/-/swc-linux-x64-musl-16.2.9.tgz",
+      "integrity": "sha512-QumimHkGEG6vM3PfEDWKyKen03NcqLOkeKB1EfcPe7VxzmEiCa4jNnMyBn/US5zcd/VE1CI+O8Ovb3lfjVHfGw==",
       "cpu": [
         "x64"
       ],
@@ -1047,9 +1047,9 @@
       }
     },
     "node_modules/@next/swc-win32-arm64-msvc": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/swc-win32-arm64-msvc/-/swc-win32-arm64-msvc-16.2.7.tgz",
-      "integrity": "sha512-GX3wvLpULFuRFJzwHaKfm7QZJ18F4ZSuxlPJ96BoBglCzBmdSjyeBKF+ZhWhvL/ckxNfLnNa7bsObO2ipYpszw==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-arm64-msvc/-/swc-win32-arm64-msvc-16.2.9.tgz",
+      "integrity": "sha512-hzQpKZvw8rAwI6A2uQh6SacCSvNAXaIkPNsWwzqqfRiIMiXMfH936skDhz1OO6KpvdKkJrgHHtqQOq5PIXOvdQ==",
       "cpu": [
         "arm64"
       ],
@@ -1063,9 +1063,9 @@
       }
     },
     "node_modules/@next/swc-win32-x64-msvc": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.2.7.tgz",
-      "integrity": "sha512-J4WlM72NMk076Qsg0jTdK3SNXatlSdnjW7L7oNGLst1tAGjHrJh/FYi+pw9wyIjEtGRKDNzD0zuiY16oWYWVaw==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.2.9.tgz",
+      "integrity": "sha512-qr2VL3Ce5QrwgO2yh1ujSBawrimjVKX8FGF/cOynmdYKJY0BdHpGVNIRK1tqONB10Vkm25Ub1BD2bkjWs4+96w==",
       "cpu": [
         "x64"
       ],
@@ -1079,9 +1079,9 @@
       }
     },
     "node_modules/@next/third-parties": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/@next/third-parties/-/third-parties-16.2.7.tgz",
-      "integrity": "sha512-mSvF8eg2egIqP0GaPYn0sDvsP45CodwVsavl7RkLsOVQL/CDy7wUg0WUV5uEtlWoWOq0pEYRRsbld7NQIh+Eqg==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/@next/third-parties/-/third-parties-16.2.9.tgz",
+      "integrity": "sha512-JZPGQRN8eQs2WMfBXOf6Zjrma+JIN0KyA24MvmIa3bUI4BwTaJ1UlxmYVc5ri6l30LQ8fPv6Kmx20447hCltrg==",
       "license": "MIT",
       "dependencies": {
         "third-party-capital": "1.0.20"
@@ -2145,9 +2145,9 @@
       }
     },
     "node_modules/baseline-browser-mapping": {
-      "version": "2.10.34",
-      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.34.tgz",
-      "integrity": "sha512-IMDedajPifLnHNY0X9n8hKxRTQ6/eTHwr5bDo04WnuqxyKw6LYtQywCuuqPZwhl3aBXMvQpJov42GLCwRRdQzw==",
+      "version": "2.10.35",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.35.tgz",
+      "integrity": "sha512-honAfLBde0HAFLdNyBEfuuENkF6zR+ozxqxa/2zJKHBe1qzLqyTSeRKpdPEHAP03rlDGyQOPnCSxnVpVqQo9Mg==",
       "license": "Apache-2.0",
       "bin": {
         "baseline-browser-mapping": "dist/cli.cjs"
@@ -2924,9 +2924,9 @@
       }
     },
     "node_modules/dompurify": {
-      "version": "3.4.8",
-      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.4.8.tgz",
-      "integrity": "sha512-yb1cEmaOum7wFvOCSQxyfgVlv5D47Rc30iZWoMpbDIWTnJ6grDDQyu2KFJzB2k7u0pMuJcQ1zphH//fFnw2tjQ==",
+      "version": "3.4.9",
+      "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.4.9.tgz",
+      "integrity": "sha512-4dPSRMRDqHvs0V4YDFCsaIZo4if5u0xM+llyxiM2fwuZFdKArUBAF3VtI2+n8NKg9P870WMdYk0UhqQNoWXbfQ==",
       "license": "(MPL-2.0 OR Apache-2.0)",
       "optionalDependencies": {
         "@types/trusted-types": "^2.0.7"
@@ -2939,9 +2939,9 @@
       "license": "MIT"
     },
     "node_modules/electron-to-chromium": {
-      "version": "1.5.368",
-      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.368.tgz",
-      "integrity": "sha512-7RckJJK4uESJF9PxvfMWd3TGqIiieUTG4HxnKaKuIpGbcr+r2ZEB3g2gAhCP3Fqm42vJSzLfgab9eva/C4/XVw==",
+      "version": "1.5.371",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.371.tgz",
+      "integrity": "sha512-e9htk9mAYL6AzmkEhSvVVw7IWGSBJ/Bqdn2eRyRLrj1g6sncN4WbFt5qnILYoCktktr45pyjIrOiRvBThQ808w==",
       "license": "ISC"
     },
     "node_modules/enhanced-resolve": {
@@ -5306,12 +5306,12 @@
       }
     },
     "node_modules/next": {
-      "version": "16.2.7",
-      "resolved": "https://registry.npmjs.org/next/-/next-16.2.7.tgz",
-      "integrity": "sha512-eMJxgjRzBaj3olkP4cBamHDXL79A8FC6u1GcsO1D1Tsx8bw/LLXUJCaoajVxtnhD3A1IJqIT8IcRJjgBIPJq4w==",
+      "version": "16.2.9",
+      "resolved": "https://registry.npmjs.org/next/-/next-16.2.9.tgz",
+      "integrity": "sha512-MEOJiq/UvuezAdqVSceHbqDgZt1kDw2tpGVOlsdIoJsQdbN2JY2hpVG4xnXGkbdJUOEWhnRfiu/O4Hpc9Juwww==",
       "license": "MIT",
       "dependencies": {
-        "@next/env": "16.2.7",
+        "@next/env": "16.2.9",
         "@swc/helpers": "0.5.15",
         "baseline-browser-mapping": "^2.9.19",
         "caniuse-lite": "^1.0.30001579",
@@ -5325,14 +5325,14 @@
         "node": ">=20.9.0"
       },
       "optionalDependencies": {
-        "@next/swc-darwin-arm64": "16.2.7",
-        "@next/swc-darwin-x64": "16.2.7",
-        "@next/swc-linux-arm64-gnu": "16.2.7",
-        "@next/swc-linux-arm64-musl": "16.2.7",
-        "@next/swc-linux-x64-gnu": "16.2.7",
-        "@next/swc-linux-x64-musl": "16.2.7",
-        "@next/swc-win32-arm64-msvc": "16.2.7",
-        "@next/swc-win32-x64-msvc": "16.2.7",
+        "@next/swc-darwin-arm64": "16.2.9",
+        "@next/swc-darwin-x64": "16.2.9",
+        "@next/swc-linux-arm64-gnu": "16.2.9",
+        "@next/swc-linux-arm64-musl": "16.2.9",
+        "@next/swc-linux-x64-gnu": "16.2.9",
+        "@next/swc-linux-x64-musl": "16.2.9",
+        "@next/swc-win32-arm64-msvc": "16.2.9",
+        "@next/swc-win32-x64-msvc": "16.2.9",
         "sharp": "^0.34.5"
       },
       "peerDependencies": {
@@ -6079,9 +6079,9 @@
       }
     },
     "node_modules/semver": {
-      "version": "7.8.3",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.3.tgz",
-      "integrity": "sha512-wnilbGyMxzbY7dNOl7jpKbLSjcfeweJWU5j4+u5qW+6/wuGD9KzIGOyZnQVSBM9E7DtWaaH3CyHkppYrKYoxwg==",
+      "version": "7.8.4",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.4.tgz",
+      "integrity": "sha512-rUCObTnP32Q08R2uuIrt7r9PlEonuTmtuXYcW6s5kjdlj3xbnwe+21yXptAUYcMAABLkYYTtnmzb3w3EDZfueA==",
       "license": "ISC",
       "optional": true,
       "bin": {
@@ -6323,9 +6323,9 @@
       }
     },
     "node_modules/ts-dedent": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/ts-dedent/-/ts-dedent-2.2.0.tgz",
-      "integrity": "sha512-q5W7tVM71e2xjHZTlgfTDoPF/SmqKG5hddq9SzR49CH2hayqRKJtQ4mtRlSxKaJlR/+9rEM+mnBHf7I2/BQcpQ==",
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/ts-dedent/-/ts-dedent-2.3.0.tgz",
+      "integrity": "sha512-JfJeIHke7y2egdGGgRAvpCwYFUsHlM2gPcrVOxFkznt/4uzQ7HFmvE63iFHVLBJNDuyDOQgijDK/tXH/f6Msjg==",
       "license": "MIT",
       "engines": {
         "node": ">=6.10"