blume 1.7.3 → 2.0.1

package/src/core/ui-packs/sv.ts

@@ -5,7 +5,6 @@ export const sv: UIStringsOverride = {
   actions: {
     addToCursor: "Lägg till i Cursor",
     addToVscode: "Lägg till i VS Code",
-    askAI: "Fråga AI om den här sidan",
     connectMcp: "Anslut till MCP",
     copied: "Kopierat!",
     copyClaudeCode: "Kopiera Claude Code-kommando",
@@ -25,7 +24,7 @@ export const sv: UIStringsOverride = {
       "Läs {url} så att jag kan ställa frågor om den här sidan.",
     scrollToTop: "Till toppen",
   },
-  ask: {
+  assistant: {
     ai: "AI",
     clear: "Rensa konversationen",
     close: "Stäng",
@@ -36,16 +35,19 @@ export const sv: UIStringsOverride = {
     placeholder: "Ställ en fråga…",
     send: "Skicka",
     tip: "Tips: Du kan öppna och stänga chatten med",
-    title: "Fråga AI",
+    title: "Assistent",
     you: "Du",
   },
   banner: { dismiss: "Stäng meddelandet" },
   changelog: {
     description: "Produktuppdateringar och versionsinformation.",
-    showReleases: "Visa utgåvor för {version}",
     title: "Ändringslogg",
   },
-  content: { diagramError: "Det här diagrammet kunde inte visas." },
+  content: {
+    copyColor: "Kopiera färgen {name} {value}",
+    copyPrompt: "Kopiera prompt",
+    diagramError: "Det här diagrammet kunde inte visas.",
+  },
   feedback: {
     no: "Nej",
     question: "Var den här sidan till hjälp?",
@@ -61,6 +63,7 @@ export const sv: UIStringsOverride = {
     featured: "Utvalda",
     githubRepository: "GitHub-repository",
     navigation: "Navigering",
+    opensInNewTab: "Öppnas i en ny flik",
     primary: "Primär",
     sections: "Avsnitt",
     toggleNavigation: "Växla navigering",
@@ -81,8 +84,8 @@ export const sv: UIStringsOverride = {
   search: {
     all: "Alla",
     allLanguages: "Alla språk",
-    askAi: "Fråga AI",
-    askAiHint: "Få ett omedelbart svar från AI",
+    assistant: "Assistent",
+    assistantHint: "Få ett omedelbart svar från AI",
     button: "Sök",
     devOnly: "Sökning är tillgänglig i produktionsbygget.",
     error: "Något gick fel. Försök igen.",

package/src/core/ui-packs/th.ts

@@ -5,7 +5,6 @@ export const th: UIStringsOverride = {
   actions: {
     addToCursor: "เพิ่มไปยัง Cursor",
     addToVscode: "เพิ่มไปยัง VS Code",
-    askAI: "ถาม AI เกี่ยวกับหน้านี้",
     connectMcp: "เชื่อมต่อกับ MCP",
     copied: "คัดลอกแล้ว!",
     copyClaudeCode: "คัดลอกคำสั่ง Claude Code",
@@ -24,7 +23,7 @@ export const th: UIStringsOverride = {
     openInChatPrompt: "อ่าน {url} เพื่อให้ฉันถามคำถามเกี่ยวกับหน้านี้ได้",
     scrollToTop: "กลับไปด้านบน",
   },
-  ask: {
+  assistant: {
     ai: "AI",
     clear: "ล้างการสนทนา",
     close: "ปิด",
@@ -35,16 +34,17 @@ export const th: UIStringsOverride = {
     placeholder: "ถามคำถาม…",
     send: "ส่ง",
     tip: "เคล็ดลับ: คุณสามารถเปิดและปิดแชทได้ด้วย",
-    title: "ถาม AI",
+    title: "ผู้ช่วย",
     you: "คุณ",
   },
   banner: { dismiss: "ปิดประกาศ" },
   changelog: {
     description: "อัปเดตผลิตภัณฑ์และบันทึกประจำรุ่น",
-    showReleases: "แสดงรุ่นของ {version}",
     title: "บันทึกการเปลี่ยนแปลง",
   },
   content: {
+    copyColor: "คัดลอกสี {name} {value}",
+    copyPrompt: "คัดลอกพรอมต์",
     diagramError: "ไม่สามารถแสดงไดอะแกรมนี้ได้",
   },
   feedback: {
@@ -62,6 +62,7 @@ export const th: UIStringsOverride = {
     featured: "แนะนำ",
     githubRepository: "ที่เก็บ GitHub",
     navigation: "การนำทาง",
+    opensInNewTab: "เปิดในแท็บใหม่",
     primary: "หลัก",
     sections: "หมวด",
     toggleNavigation: "สลับการนำทาง",
@@ -82,8 +83,8 @@ export const th: UIStringsOverride = {
   search: {
     all: "ทั้งหมด",
     allLanguages: "ทุกภาษา",
-    askAi: "ถาม AI",
-    askAiHint: "รับคำตอบทันทีจาก AI",
+    assistant: "ผู้ช่วย",
+    assistantHint: "รับคำตอบทันทีจาก AI",
     button: "ค้นหา",
     devOnly: "การค้นหาพร้อมใช้งานในบิลด์โปรดักชัน",
     error: "เกิดข้อผิดพลาดบางอย่าง โปรดลองอีกครั้ง",

package/src/core/ui-packs/tr.ts

@@ -5,7 +5,6 @@ export const tr: UIStringsOverride = {
   actions: {
     addToCursor: "Cursor'a ekle",
     addToVscode: "VS Code'a ekle",
-    askAI: "Bu sayfa hakkında yapay zekâya sor",
     connectMcp: "MCP'ye bağlan",
     copied: "Kopyalandı!",
     copyClaudeCode: "Claude Code komutunu kopyala",
@@ -25,7 +24,7 @@ export const tr: UIStringsOverride = {
       "Bu sayfa hakkında sorular sorabilmem için {url} adresini okuyun.",
     scrollToTop: "Başa dön",
   },
-  ask: {
+  assistant: {
     ai: "Yapay zekâ",
     clear: "Konuşmayı temizle",
     close: "Kapat",
@@ -36,16 +35,19 @@ export const tr: UIStringsOverride = {
     placeholder: "Bir soru sorun…",
     send: "Gönder",
     tip: "İpucu: Sohbeti şu tuşla açıp kapatabilirsiniz:",
-    title: "Yapay zekâya sor",
+    title: "Asistan",
     you: "Siz",
   },
   banner: { dismiss: "Duyuruyu kapat" },
   changelog: {
     description: "Ürün güncellemeleri ve sürüm notları.",
-    showReleases: "{version} sürümlerini göster",
     title: "Değişiklik günlüğü",
   },
-  content: { diagramError: "Bu diyagram görüntülenemedi." },
+  content: {
+    copyColor: "Rengi kopyala: {name} {value}",
+    copyPrompt: "İstemi kopyala",
+    diagramError: "Bu diyagram görüntülenemedi.",
+  },
   feedback: {
     no: "Hayır",
     question: "Bu sayfa yardımcı oldu mu?",
@@ -61,6 +63,7 @@ export const tr: UIStringsOverride = {
     featured: "Öne çıkan",
     githubRepository: "GitHub deposu",
     navigation: "Gezinme",
+    opensInNewTab: "Yeni sekmede açılır",
     primary: "Birincil",
     sections: "Bölümler",
     toggleNavigation: "Gezinmeyi aç/kapat",
@@ -81,8 +84,8 @@ export const tr: UIStringsOverride = {
   search: {
     all: "Tümü",
     allLanguages: "Tüm diller",
-    askAi: "Yapay zekâya sor",
-    askAiHint: "Yapay zekâdan anında yanıt alın",
+    assistant: "Asistan",
+    assistantHint: "Yapay zekâdan anında yanıt alın",
     button: "Ara",
     devOnly: "Arama, üretim derlemesinde kullanılabilir.",
     error: "Bir şeyler ters gitti. Lütfen tekrar deneyin.",

package/src/core/ui-packs/uk.ts

@@ -5,7 +5,6 @@ export const uk: UIStringsOverride = {
   actions: {
     addToCursor: "Додати до Cursor",
     addToVscode: "Додати до VS Code",
-    askAI: "Запитати ШІ про цю сторінку",
     connectMcp: "Підключитися до MCP",
     copied: "Скопійовано!",
     copyClaudeCode: "Скопіювати команду Claude Code",
@@ -25,7 +24,7 @@ export const uk: UIStringsOverride = {
       "Прочитайте {url} — я ставитиму запитання щодо цієї сторінки.",
     scrollToTop: "Нагору",
   },
-  ask: {
+  assistant: {
     ai: "ШІ",
     clear: "Очистити бесіду",
     close: "Закрити",
@@ -36,16 +35,19 @@ export const uk: UIStringsOverride = {
     placeholder: "Поставте запитання…",
     send: "Надіслати",
     tip: "Порада: чат можна відкрити й закрити за допомогою",
-    title: "Запитати ШІ",
+    title: "Асистент",
     you: "Ви",
   },
   banner: { dismiss: "Закрити оголошення" },
   changelog: {
     description: "Оновлення продукту та примітки до випусків.",
-    showReleases: "Показати випуски {version}",
     title: "Журнал змін",
   },
-  content: { diagramError: "Не вдалося відобразити цю діаграму." },
+  content: {
+    copyColor: "Скопіювати колір {name} {value}",
+    copyPrompt: "Скопіювати промпт",
+    diagramError: "Не вдалося відобразити цю діаграму.",
+  },
   feedback: {
     no: "Ні",
     question: "Чи була ця сторінка корисною?",
@@ -61,6 +63,7 @@ export const uk: UIStringsOverride = {
     featured: "Рекомендоване",
     githubRepository: "Репозиторій GitHub",
     navigation: "Навігація",
+    opensInNewTab: "Відкривається в новій вкладці",
     primary: "Основне",
     sections: "Розділи",
     toggleNavigation: "Перемкнути навігацію",
@@ -81,8 +84,8 @@ export const uk: UIStringsOverride = {
   search: {
     all: "Усі",
     allLanguages: "Усі мови",
-    askAi: "Запитати ШІ",
-    askAiHint: "Отримайте миттєву відповідь від ШІ",
+    assistant: "Асистент",
+    assistantHint: "Отримайте миттєву відповідь від ШІ",
     button: "Пошук",
     devOnly: "Пошук доступний у production-збірці.",
     error: "Щось пішло не так. Спробуйте ще раз.",

package/src/core/ui-packs/vi.ts

@@ -5,7 +5,6 @@ export const vi: UIStringsOverride = {
   actions: {
     addToCursor: "Thêm vào Cursor",
     addToVscode: "Thêm vào VS Code",
-    askAI: "Hỏi AI về trang này",
     connectMcp: "Kết nối với MCP",
     copied: "Đã sao chép!",
     copyClaudeCode: "Sao chép lệnh Claude Code",
@@ -24,7 +23,7 @@ export const vi: UIStringsOverride = {
     openInChatPrompt: "Hãy đọc {url} để tôi có thể đặt câu hỏi về trang này.",
     scrollToTop: "Lên đầu trang",
   },
-  ask: {
+  assistant: {
     ai: "AI",
     clear: "Xóa cuộc trò chuyện",
     close: "Đóng",
@@ -35,16 +34,17 @@ export const vi: UIStringsOverride = {
     placeholder: "Đặt câu hỏi…",
     send: "Gửi",
     tip: "Mẹo: Bạn có thể mở và đóng trò chuyện bằng",
-    title: "Hỏi AI",
+    title: "Trợ lý",
     you: "Bạn",
   },
   banner: { dismiss: "Đóng thông báo" },
   changelog: {
     description: "Cập nhật sản phẩm và ghi chú phát hành.",
-    showReleases: "Hiện các bản phát hành {version}",
     title: "Nhật ký thay đổi",
   },
   content: {
+    copyColor: "Sao chép màu {name} {value}",
+    copyPrompt: "Sao chép prompt",
     diagramError: "Không thể hiển thị sơ đồ này.",
   },
   feedback: {
@@ -62,6 +62,7 @@ export const vi: UIStringsOverride = {
     featured: "Nổi bật",
     githubRepository: "Kho lưu trữ GitHub",
     navigation: "Điều hướng",
+    opensInNewTab: "Mở trong thẻ mới",
     primary: "Chính",
     sections: "Chuyên mục",
     toggleNavigation: "Chuyển đổi điều hướng",
@@ -82,8 +83,8 @@ export const vi: UIStringsOverride = {
   search: {
     all: "Tất cả",
     allLanguages: "Tất cả ngôn ngữ",
-    askAi: "Hỏi AI",
-    askAiHint: "Nhận câu trả lời tức thì từ AI",
+    assistant: "Trợ lý",
+    assistantHint: "Nhận câu trả lời tức thì từ AI",
     button: "Tìm kiếm",
     devOnly: "Tìm kiếm có sẵn trong bản dựng production.",
     error: "Đã xảy ra sự cố. Vui lòng thử lại.",

package/src/core/ui-packs/zh-tw.ts

@@ -5,7 +5,6 @@ export const zhTW: UIStringsOverride = {
   actions: {
     addToCursor: "新增至 Cursor",
     addToVscode: "新增至 VS Code",
-    askAI: "向 AI 詢問此頁面",
     connectMcp: "連線至 MCP",
     copied: "已複製！",
     copyClaudeCode: "複製 Claude Code 指令",
@@ -24,7 +23,7 @@ export const zhTW: UIStringsOverride = {
     openInChatPrompt: "請閱讀 {url} 以便我針對此頁面提問。",
     scrollToTop: "回到頂部",
   },
-  ask: {
+  assistant: {
     ai: "AI",
     clear: "清除對話",
     close: "關閉",
@@ -35,16 +34,17 @@ export const zhTW: UIStringsOverride = {
     placeholder: "提出問題…",
     send: "傳送",
     tip: "提示：可透過以下快捷鍵開啟和關閉聊天",
-    title: "向 AI 提問",
+    title: "助理",
     you: "你",
   },
   banner: { dismiss: "關閉公告" },
   changelog: {
     description: "產品更新與版本說明。",
-    showReleases: "顯示 {version} 的發布",
     title: "更新日誌",
   },
   content: {
+    copyColor: "複製顏色 {name} {value}",
+    copyPrompt: "複製提示詞",
     diagramError: "無法顯示此圖表。",
   },
   feedback: {
@@ -62,6 +62,7 @@ export const zhTW: UIStringsOverride = {
     featured: "精選",
     githubRepository: "GitHub 儲存庫",
     navigation: "導覽",
+    opensInNewTab: "在新分頁中開啟",
     primary: "主要",
     sections: "章節",
     toggleNavigation: "切換導覽",
@@ -82,8 +83,8 @@ export const zhTW: UIStringsOverride = {
   search: {
     all: "全部",
     allLanguages: "所有語言",
-    askAi: "向 AI 提問",
-    askAiHint: "從 AI 即時取得解答",
+    assistant: "助理",
+    assistantHint: "從 AI 即時取得解答",
     button: "搜尋",
     devOnly: "搜尋在正式版組建中可用。",
     error: "發生了一些問題，請再試一次。",

package/src/core/ui-packs/zh.ts

@@ -5,7 +5,6 @@ export const zh: UIStringsOverride = {
   actions: {
     addToCursor: "添加到 Cursor",
     addToVscode: "添加到 VS Code",
-    askAI: "向 AI 询问此页面",
     connectMcp: "连接到 MCP",
     copied: "已复制！",
     copyClaudeCode: "复制 Claude Code 命令",
@@ -24,7 +23,7 @@ export const zh: UIStringsOverride = {
     openInChatPrompt: "请阅读 {url} 以便我就此页面提问。",
     scrollToTop: "回到顶部",
   },
-  ask: {
+  assistant: {
     ai: "AI",
     clear: "清空对话",
     close: "关闭",
@@ -35,16 +34,17 @@ export const zh: UIStringsOverride = {
     placeholder: "提出问题…",
     send: "发送",
     tip: "提示：可通过以下快捷键打开和关闭聊天",
-    title: "向 AI 提问",
+    title: "助手",
     you: "你",
   },
   banner: { dismiss: "关闭公告" },
   changelog: {
     description: "产品更新与版本说明。",
-    showReleases: "显示 {version} 的发布",
     title: "更新日志",
   },
   content: {
+    copyColor: "复制颜色 {name} {value}",
+    copyPrompt: "复制提示词",
     diagramError: "无法渲染此图表。",
   },
   feedback: {
@@ -62,6 +62,7 @@ export const zh: UIStringsOverride = {
     featured: "精选",
     githubRepository: "GitHub 仓库",
     navigation: "导航",
+    opensInNewTab: "在新标签页中打开",
     primary: "主要",
     sections: "章节",
     toggleNavigation: "切换导航",
@@ -82,8 +83,8 @@ export const zh: UIStringsOverride = {
   search: {
     all: "全部",
     allLanguages: "所有语言",
-    askAi: "向 AI 提问",
-    askAiHint: "从 AI 即时获取答案",
+    assistant: "助手",
+    assistantHint: "从 AI 即时获取答案",
     button: "搜索",
     devOnly: "搜索在生产构建中可用。",
     error: "出了点问题，请重试。",

package/src/core/unrecognized-keys.ts

@@ -0,0 +1,10 @@
+/**
+ * Zod's own wording for unknown keys no removed-key hint covers, appended to
+ * a hint so an unrelated typo isn't silently dropped from the diagnostic
+ * beside it. Shared by every config object that names a removed field's
+ * replacement (the root config, `ai.assistant`, `openapi()`/`asyncapi()`, …).
+ */
+export const unrecognizedKeysMessage = (keys: string[]): string =>
+  `Unrecognized key${keys.length > 1 ? "s" : ""}: ${keys
+    .map((key) => JSON.stringify(key))
+    .join(", ")}`;

package/src/core/version-cut.ts

@@ -11,6 +11,7 @@ import { localizeRoute } from "./i18n.ts";
 import type { BlumeProject } from "./project-graph.ts";
 import { isWithin, scanProject } from "./project-graph.ts";
 import { VERSION_ID } from "./schema.ts";
+import type { Diagnostic } from "./types.ts";
 import { VERSION_LIKE, versionizeRoute } from "./versions.ts";
 
 /** What `cutVersion` did, for the CLI to report. */
@@ -21,6 +22,11 @@ export interface CutResult {
   rewritten: { file: string; count: number }[];
   /** Whether `blume.config.ts` was updated in place. */
   configUpdated: boolean;
+  /**
+   * Whether that update added the whole `versions` block — the first cut of a
+   * project that had no versioning — rather than one `archived` entry.
+   */
+  versionsAdded: boolean;
   /** Ready-to-paste config snippet when in-place update was not possible. */
   configSnippet: string | null;
   /** Absolute path of the created snapshot directory. */
@@ -144,11 +150,17 @@ export const rewriteSnapshotLinks = (
   return { count, text: lines.join("\n") };
 };
 
+/**
+ * The switcher label a first cut gives the live docs. `versions.current.label`
+ * is required, and "Latest" reads right until the author names the release.
+ */
+const CURRENT_LABEL = "Latest";
+
 /** The config entry to add, as a paste-ready snippet for the fallback path. */
 const snippetFor = (id: string, hasVersions: boolean): string =>
   hasVersions
     ? `Add to versions.archived in blume.config.ts (newest first):\n\n  { id: "${id}" },\n`
-    : `Add to blume.config.ts:\n\n  versions: {\n    archived: [{ id: "${id}" }],\n    current: { label: "…" },\n  },\n`;
+    : `Add to blume.config.ts:\n\n  versions: {\n    archived: [{ id: "${id}" }],\n    current: { label: "${CURRENT_LABEL}" },\n  },\n`;
 
 /**
  * Best-effort in-place config update: insert the new id at the head of an
@@ -192,6 +204,101 @@ export const insertArchivedVersion = async (
   return true;
 };
 
+/** The opening brace of the config object: `defineConfig({` or `export default {`. */
+const CONFIG_OBJECT = /(?:defineConfig\(\s*|export\s+default\s+)\{/gu;
+
+/**
+ * Best-effort in-place registration of a first version: add a `versions` block
+ * (the id archived, the live docs labeled {@link CURRENT_LABEL}) as the first
+ * property of the config object. Only the plain shape is edited — exactly one
+ * `defineConfig({` or `export default {` and no `versions` key yet — so a
+ * config built any other way falls back to the printed snippet rather than
+ * risk corrupting it.
+ */
+export const insertVersionsBlock = async (
+  configPath: string,
+  id: string
+): Promise<boolean> => {
+  let text: string;
+  try {
+    text = await readFile(configPath, "utf-8");
+  } catch {
+    return false;
+  }
+  const matches = [...text.matchAll(CONFIG_OBJECT)];
+  const [match] = matches;
+  if (matches.length !== 1 || !match || /\bversions\s*:/u.test(text)) {
+    return false;
+  }
+  const insertAt = match.index + match[0].length;
+  const rest = text.slice(insertAt);
+  const eol = text.includes("\r\n") ? "\r\n" : "\n";
+  const lineStart = text.lastIndexOf("\n", match.index) + 1;
+  const outer = /^[ \t]*/u.exec(text.slice(lineStart))?.[0] ?? "";
+  // Match the indentation of the property on the next line, when there is one.
+  const indent =
+    /^[ \t]*\r?\n(?<indent>[ \t]*)\S/u.exec(rest)?.groups?.indent ??
+    `${outer}  `;
+  const block = [
+    "versions: {",
+    `  archived: [{ id: "${id}" }],`,
+    `  current: { label: "${CURRENT_LABEL}" },`,
+    "},",
+  ]
+    .map((line) => `${indent}${line}`)
+    .join(eol);
+  const body = rest.trimStart();
+  let tail: string;
+  if (body.startsWith("}")) {
+    // An empty object: close it on its own line.
+    tail = `${eol}${outer}${body}`;
+  } else if (/^[ \t]*\r?\n/u.test(rest)) {
+    tail = rest;
+  } else {
+    // An inline object: move its first property onto the next line.
+    tail = `${eol}${indent}${body}`;
+  }
+  await writeTextAtomic(
+    configPath,
+    `${text.slice(0, insertAt)}${eol}${block}${tail}`
+  );
+  return true;
+};
+
+/**
+ * Version-shaped folders (`v1.0/`) at the top of the content root of a project
+ * with no `versions` config — usually a snapshot `blume version` cut but
+ * couldn't register — which build as ordinary content at `/v1.0/…`, so every
+ * page ships twice. With versioning configured, the scan's own
+ * `BLUME_VERSIONS_UNCONFIGURED_VERSION` covers a folder it doesn't list; this
+ * check is `blume doctor`'s alone, since an unversioned site can have a real
+ * `v1/` section that a warning on every build would only nag about.
+ */
+export const unregisteredSnapshotDiagnostics = (
+  project: BlumeProject
+): Diagnostic[] => {
+  if (project.config.versions) {
+    return [];
+  }
+  const { contentRoot } = project.context;
+  const folders = new Set<string>();
+  for (const page of project.graph.pages) {
+    const [first, ...rest] = page.sourcePath
+      ? relative(contentRoot, page.sourcePath).split("/")
+      : [];
+    if (first && rest.length > 0 && VERSION_LIKE.test(first)) {
+      folders.add(first);
+    }
+  }
+  return [...folders].toSorted().map((folder) => ({
+    code: "BLUME_VERSIONS_UNCONFIGURED_VERSION",
+    file: join(contentRoot, folder),
+    message: `Folder "${folder}/" looks like a version snapshot, but versioning isn't configured, so its pages build as ordinary content at /${folder}/….`,
+    severity: "warning",
+    suggestion: `If it's a snapshot, register it with \`versions: { archived: [{ id: "${folder}" }], current: { label: "${CURRENT_LABEL}" } }\` in blume.config.ts; if it's an ordinary section, ignore this.`,
+  }));
+};
+
 /**
  * Freeze the current docs as an archived version: copy the content tree into
  * `<contentRoot>/<id>/` (excluding existing snapshots), rewrite root-absolute
@@ -304,18 +411,19 @@ export const cutVersion = async (
   };
   await walk(dir);
 
-  const configPath = join(root, "blume.config.ts");
-  const configUpdated =
-    project.config.versions !== undefined &&
-    (await insertArchivedVersion(configPath, id));
+  const configPath =
+    project.context.configFile ?? join(root, "blume.config.ts");
+  const firstVersion = project.config.versions === undefined;
+  const configUpdated = firstVersion
+    ? await insertVersionsBlock(configPath, id)
+    : await insertArchivedVersion(configPath, id);
 
   return {
-    configSnippet: configUpdated
-      ? null
-      : snippetFor(id, project.config.versions !== undefined),
+    configSnippet: configUpdated ? null : snippetFor(id, !firstVersion),
     configUpdated,
     copied,
     dir,
     rewritten,
+    versionsAdded: configUpdated && firstVersion,
   };
 };