docs: a main landmark, a switcher named by its text, code blocks off the landmark list, buttons that keep their own language, a localized Open-in prompt, and a CI rule for the locale chrome

apps/docs/app/[lang]/docs/[[...slug]]/page.tsx

@@ -345,7 +345,18 @@ export default async function Page(props: {
           dangerouslySetInnerHTML={{ __html: jsonLdHtml(item) }}
         />
       ))}
+      {/*
+        `role="main"`: the page's main landmark (#308). Fumadocs 16.8.12
+        renders none anywhere in the docs layout, so a screen reader's "main"
+        jump went nowhere. DocsPage passes its other props to the `<article>`
+        it renders (breadcrumb, title, body, footer; not the sidebar or the
+        table of contents), and ARIA in HTML allows `main` on an article.
+        Upgrade note: fumadocs-ui 16.16.2 wraps that article in a `<main>` of
+        its own. On a version that does, delete this prop, or the page has two
+        main landmarks (`patches/fumadocs-ui@16.8.12.patch` says the same).
+      */}
       <DocsPage
+        role="main"
         toc={isFallback ? tocInLanguage(loaded.toc, contentLang) : loaded.toc}
         full={page.data.full}
       >
@@ -371,6 +382,7 @@ export default async function Page(props: {
               openInGitHub: text.openInGitHub,
               openInChatGPT: text.openInChatGPT,
               openInClaude: text.openInClaude,
+              openInLLMPrompt: text.pageActionsOpenInLLMPrompt,
             }}
           />
         </div>

apps/docs/components/ai/page-actions.tsx

@@ -107,12 +107,20 @@ export function ViewOptions({
     openInGitHub: string;
     openInChatGPT: string;
     openInClaude: string;
+    /**
+     * The sentence the assistant is opened with, in the route locale, with
+     * `{url}` where the read URL goes (#308). Upstream fumadocs-ui 16.9.0's
+     * `pageActionsOpenInLLMPrompt`, same placeholder and same English.
+     */
+    openInLLMPrompt: string;
   };
 }) {
   const items = useMemo(() => {
     const fullReadUrl =
       typeof window !== 'undefined' ? new URL(readUrl, window.location.origin) : 'loading';
-    const q = `Read ${fullReadUrl}, I want to ask questions about it.`;
+    // A replacer function, not a replacement string: in a replacement string
+    // `$&` and its kin are patterns, and nothing stops a URL containing `$`.
+    const q = labels.openInLLMPrompt.replace('{url}', () => String(fullReadUrl));
 
     return [
       {

apps/docs/lib/ui-text.ts

@@ -71,6 +71,13 @@ const en = {
   openInGitHub: 'Open in GitHub',
   openInChatGPT: 'Open in ChatGPT',
   openInClaude: 'Open in Claude',
+  /**
+   * What "Open in ChatGPT / Claude" asks the assistant (#308): `{url}` is
+   * replaced by the page's read URL. The key, the placeholder and the English
+   * are upstream fumadocs-ui 16.9.0's own. It is an app key, not passed to
+   * fumadocs: the page actions are this app's component.
+   */
+  pageActionsOpenInLLMPrompt: 'Read {url}, I want to ask questions about it.',
   /**
    * The notice on a locale URL whose page has no source file in that locale,
    * so the body below it is the English page. Never rendered in English — an
@@ -103,6 +110,11 @@ export type FumadocsTranslations = { [K in keyof Translations]: Translations[K]
 
 type Locale = (typeof i18n.languages)[number];
 
+/** The `{name}` placeholders a string carries, sorted, one entry per occurrence. */
+function placeholders(value: string): string[] {
+  return (value.match(/\{[A-Za-z]+\}/g) ?? []).sort();
+}
+
 /**
  * A locale table, held to EXACTLY the English key set.
  *
@@ -111,8 +123,26 @@ type Locale = (typeof i18n.languages)[number];
  * parameter type closes that: any key English does not have must be `never`,
  * which a JSON string value is not, so a stale or misspelled key is a type
  * error instead of dead weight nobody reads.
+ *
+ * Placeholders are held to English too, which a type cannot do for a JSON
+ * string. A translation that drops `{url}` from `pageActionsOpenInLLMPrompt`
+ * would open the assistant on a prompt naming no page, so a mismatch throws
+ * while this module loads, which fails `next build` on the first page that
+ * renders.
  */
-function table<T extends UiText>(text: T & Record<Exclude<keyof T, keyof UiText>, never>): UiText {
+function table<T extends UiText>(
+  locale: string,
+  text: T & Record<Exclude<keyof T, keyof UiText>, never>,
+): UiText {
+  for (const key of Object.keys(en) as (keyof UiText)[]) {
+    const want = placeholders(en[key]).join(' ');
+    const got = placeholders(text[key]).join(' ');
+    if (got !== want) {
+      throw new Error(
+        `lib/ui-text/${locale}.json: "${key}" has placeholders [${got}], English has [${want}]`,
+      );
+    }
+  }
   return text;
 }
 
@@ -123,13 +153,13 @@ function table<T extends UiText>(text: T & Record<Exclude<keyof T, keyof UiText>
  */
 const TEXT: Record<Locale, UiText> = {
   en,
-  'zh-Hans': table(zhHans),
-  'zh-Hant': table(zhHant),
-  ja: table(ja),
-  de: table(de),
-  es: table(es),
-  fr: table(fr),
-  ko: table(ko),
+  'zh-Hans': table('zh-Hans', zhHans),
+  'zh-Hant': table('zh-Hant', zhHant),
+  ja: table('ja', ja),
+  de: table('de', de),
+  es: table('es', es),
+  fr: table('fr', fr),
+  ko: table('ko', ko),
 };
 
 function isLocale(lang: string): lang is Locale {

apps/docs/lib/ui-text/de.json

@@ -23,6 +23,7 @@
   "openInGitHub": "In GitHub öffnen",
   "openInChatGPT": "In ChatGPT öffnen",
   "openInClaude": "In Claude öffnen",
+  "pageActionsOpenInLLMPrompt": "Lies {url}, ich möchte Fragen dazu stellen.",
   "notTranslated": "Diese Seite ist noch nicht übersetzt; angezeigt wird die englische Fassung.",
   "legalNav": "Rechtliches",
   "privacy": "Datenschutz",

apps/docs/lib/ui-text/es.json

@@ -23,6 +23,7 @@
   "openInGitHub": "Abrir en GitHub",
   "openInChatGPT": "Abrir en ChatGPT",
   "openInClaude": "Abrir en Claude",
+  "pageActionsOpenInLLMPrompt": "Lee {url}, quiero hacer preguntas sobre su contenido.",
   "notTranslated": "Esta página aún no está traducida; se muestra en inglés.",
   "legalNav": "Información legal",
   "privacy": "Privacidad",

apps/docs/lib/ui-text/fr.json

@@ -23,6 +23,7 @@
   "openInGitHub": "Ouvrir dans GitHub",
   "openInChatGPT": "Ouvrir dans ChatGPT",
   "openInClaude": "Ouvrir dans Claude",
+  "pageActionsOpenInLLMPrompt": "Lis {url}, je voudrais poser des questions à son sujet.",
   "notTranslated": "Cette page n'est pas encore traduite. Elle s'affiche en anglais.",
   "legalNav": "Mentions légales",
   "privacy": "Confidentialité",

apps/docs/lib/ui-text/ja.json

@@ -23,6 +23,7 @@
   "openInGitHub": "GitHub で開く",
   "openInChatGPT": "ChatGPT で開く",
   "openInClaude": "Claude で開く",
+  "pageActionsOpenInLLMPrompt": "{url} を読んでください。この内容について質問したいです。",
   "notTranslated": "このページはまだ翻訳されていません。英語版を表示しています。",
   "legalNav": "法的情報",
   "privacy": "プライバシー",

apps/docs/lib/ui-text/ko.json

@@ -23,6 +23,7 @@
   "openInGitHub": "GitHub에서 열기",
   "openInChatGPT": "ChatGPT에서 열기",
   "openInClaude": "Claude에서 열기",
+  "pageActionsOpenInLLMPrompt": "{url} 문서를 읽어 주세요. 이 내용에 대해 질문하고 싶습니다.",
   "notTranslated": "이 페이지는 아직 번역되지 않았습니다. 영어 원문을 표시합니다.",
   "legalNav": "법적 고지",
   "privacy": "개인정보 보호",

apps/docs/lib/ui-text/zh-Hans.json

@@ -23,6 +23,7 @@
   "openInGitHub": "在 GitHub 中打开",
   "openInChatGPT": "在 ChatGPT 中打开",
   "openInClaude": "在 Claude 中打开",
+  "pageActionsOpenInLLMPrompt": "请阅读 {url}，我想就其中的内容提问。",
   "notTranslated": "本页尚未翻译，以下显示英文原文。",
   "legalNav": "法律信息",
   "privacy": "隐私",

apps/docs/lib/ui-text/zh-Hant.json

@@ -23,6 +23,7 @@
   "openInGitHub": "在 GitHub 中開啟",
   "openInChatGPT": "在 ChatGPT 中開啟",
   "openInClaude": "在 Claude 中開啟",
+  "pageActionsOpenInLLMPrompt": "請閱讀 {url}，我想就其中的內容提問。",
   "notTranslated": "本頁尚未翻譯，以下顯示英文原文。",
   "legalNav": "法律資訊",
   "privacy": "隱私",