blume 1.3.1 → 1.4.1

package/src/core/tsconfig-aliases.ts

@@ -1,8 +1,7 @@
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { createRequire } from "node:module";
-import { pathToFileURL } from "node:url";
+import { existsSync } from "node:fs";
 
-import { dirname, isAbsolute, join, resolve } from "pathe";
+import { parseTsconfig } from "get-tsconfig";
+import { dirname, join, resolve } from "pathe";
 
 /**
  * Read the project's TypeScript path aliases (`compilerOptions.paths`) and turn
@@ -15,177 +14,28 @@ import { dirname, isAbsolute, join, resolve } from "pathe";
  * import would have to be rewritten to a relative path. Reading the aliases here
  * lets those components port over unchanged.
  *
- * Best-effort and non-fatal: tsconfig is parsed leniently (it is JSONC —
- * comments and trailing commas), a single `extends` chain is followed to the
- * file that actually declares `paths`, and anything unparseable yields no
- * aliases (the prior behavior).
+ * Parsing is get-tsconfig's job — JSONC, the full `extends` chain (relative
+ * paths, directories, package specifiers, TS 5.0 arrays), and the rebasing of
+ * inherited relative paths all follow tsc's own semantics. Best-effort and
+ * non-fatal: anything unparseable yields no aliases.
  */
 
-interface ScanStep {
-  append: string;
-  inString: boolean;
-  next: number;
-}
+/** TS 5.5's config-relative template prefix, literal by design in tsconfig. */
+// oxlint-disable-next-line no-template-curly-in-string -- tsconfig's own syntax
+const CONFIG_DIR_TEMPLATE = "${configDir}";
 
-/** Scan one character (or comment/escape run) starting at `index`. */
-const scanJsonChar = (
-  text: string,
-  index: number,
-  inString: boolean
-): ScanStep => {
-  const char = text[index];
-  if (inString) {
-    if (char === "\\") {
-      return {
-        append: char + (text[index + 1] ?? ""),
-        inString: true,
-        next: index + 2,
-      };
-    }
-    return { append: char ?? "", inString: char !== '"', next: index + 1 };
-  }
-  if (char === '"') {
-    return { append: char, inString: true, next: index + 1 };
-  }
-  if (char === "/" && text[index + 1] === "/") {
-    const newline = text.indexOf("\n", index + 2);
-    return {
-      append: "",
-      inString: false,
-      next: newline === -1 ? text.length : newline,
-    };
-  }
-  if (char === "/" && text[index + 1] === "*") {
-    const end = text.indexOf("*/", index + 2);
-    return {
-      append: "",
-      inString: false,
-      next: end === -1 ? text.length : end + 2,
-    };
-  }
-  return { append: char ?? "", inString: false, next: index + 1 };
-};
-
-/** Strip `//` line and `/* *\/` block comments that sit outside strings. */
-const stripJsonComments = (text: string): string => {
-  let out = "";
-  let inString = false;
-  let index = 0;
-  while (index < text.length) {
-    const {
-      append,
-      inString: nextInString,
-      next,
-    } = scanJsonChar(text, index, inString);
-    out += append;
-    inString = nextInString;
-    index = next;
-  }
-  return out;
-};
-
-const TRAILING_COMMA = /,(?<rest>\s*[}\]])/gu;
-
-/** Parse JSONC (tsconfig) into a plain object, or null if it can't be read. */
-const parseJsonc = (text: string): Record<string, unknown> | null => {
-  try {
-    const cleaned = stripJsonComments(text).replaceAll(
-      TRAILING_COMMA,
-      "$<rest>"
-    );
-    const value: unknown = JSON.parse(cleaned);
-    return value && typeof value === "object" && !Array.isArray(value)
-      ? (value as Record<string, unknown>)
-      : null;
-  } catch {
-    return null;
-  }
-};
-
-const isFile = (path: string): boolean => {
-  try {
-    return statSync(path).isFile();
-  } catch {
-    return false;
-  }
-};
-
-/** Resolve a tsconfig `extends` target (relative path, directory, or package). */
-const resolveExtends = (spec: string, fromDir: string): string | null => {
-  if (spec.startsWith(".") || isAbsolute(spec)) {
-    const candidates = spec.endsWith(".json")
-      ? [resolve(fromDir, spec)]
-      : [
-          resolve(fromDir, `${spec}.json`),
-          resolve(fromDir, spec, "tsconfig.json"),
-          resolve(fromDir, spec),
-        ];
-    return candidates.find(isFile) ?? null;
-  }
-  // A bare specifier points at a package's shared config (e.g. `@tsconfig/*`).
-  try {
-    const requireFromDir = createRequire(
-      pathToFileURL(join(fromDir, "_.js")).href
-    );
-    for (const sub of [`${spec}/tsconfig.json`, spec]) {
-      try {
-        return requireFromDir.resolve(sub);
-      } catch {
-        // try the next candidate
-      }
-    }
-  } catch {
-    // createRequire failed; fall through
-  }
-  return null;
-};
-
-interface LoadedPaths {
-  /** Directory `paths` entries resolve against (`dirname(file)` + `baseUrl`). */
-  baseDir: string;
-  paths: Record<string, unknown>;
-}
-
-/** Find the nearest tsconfig in an `extends` chain that declares `paths`. */
-const loadPaths = (file: string, seen: Set<string>): LoadedPaths | null => {
-  if (seen.has(file) || !existsSync(file)) {
-    return null;
-  }
-  seen.add(file);
-  const json = parseJsonc(readFileSync(file, "utf-8"));
-  if (!json) {
-    return null;
-  }
-  const options = (json.compilerOptions ?? {}) as Record<string, unknown>;
-  if (options.paths && typeof options.paths === "object") {
-    const baseUrl = typeof options.baseUrl === "string" ? options.baseUrl : ".";
-    return {
-      baseDir: resolve(dirname(file), baseUrl),
-      paths: options.paths as Record<string, unknown>,
-    };
-  }
-  // `extends` is a string or, since TS 5.0, an array searched first-to-last.
-  const bases = Array.isArray(json.extends)
-    ? json.extends
-    : [json.extends].filter(Boolean);
-  for (const base of bases) {
-    if (typeof base !== "string") {
-      continue;
-    }
-    const resolved = resolveExtends(base, dirname(file));
-    const found = resolved ? loadPaths(resolved, seen) : null;
-    if (found) {
-      return found;
-    }
-  }
-  return null;
-};
+/** Substitute a leading `${configDir}` template with the config's directory. */
+const substituteConfigDir = (value: string, configDir: string): string =>
+  value.startsWith(CONFIG_DIR_TEMPLATE)
+    ? join(configDir, value.slice(CONFIG_DIR_TEMPLATE.length))
+    : value;
 
 /** Convert one tsconfig `paths` mapping to a Vite alias, or null to skip. */
 const toAlias = (
   key: string,
   value: unknown,
-  baseDir: string
+  baseDir: string,
+  configDir: string
 ): { find: string; replacement: string } | null => {
   // tsconfig allows a fallback array; Vite aliases are 1:1, so take the first.
   const first = Array.isArray(value) ? value[0] : value;
@@ -198,7 +48,10 @@ const toAlias = (
   if (find === "" || find === "*") {
     return null;
   }
-  return { find, replacement: resolve(baseDir, target) };
+  return {
+    find,
+    replacement: resolve(baseDir, substituteConfigDir(target, configDir)),
+  };
 };
 
 /**
@@ -215,13 +68,27 @@ export const resolveTsconfigAliases = (
   if (!entry) {
     return {};
   }
-  const loaded = loadPaths(entry, new Set());
-  if (!loaded) {
+  let options: ReturnType<typeof parseTsconfig>["compilerOptions"];
+  try {
+    options = parseTsconfig(entry).compilerOptions;
+  } catch {
+    // Unparseable config or unresolvable extends: no aliases, as before.
+    return {};
+  }
+  const paths = options?.paths;
+  if (!paths) {
     return {};
   }
+  const configDir = dirname(entry);
+  // get-tsconfig rebases inherited relative values onto the entry config, so
+  // `baseUrl` (and bare `paths` entries) anchor here after substitution.
+  const baseDir = resolve(
+    configDir,
+    substituteConfigDir(options?.baseUrl ?? ".", configDir)
+  );
   const aliases: Record<string, string> = {};
-  for (const [key, value] of Object.entries(loaded.paths)) {
-    const alias = toAlias(key, value, loaded.baseDir);
+  for (const [key, value] of Object.entries(paths)) {
+    const alias = toAlias(key, value, baseDir, configDir);
     if (alias) {
       aliases[alias.find] = alias.replacement;
     }

package/src/core/types.ts

@@ -146,9 +146,10 @@ export interface PageRecord {
   contentType: string;
   meta: PageMeta;
   /**
-   * Custom frontmatter values declared via `frontmatter.extend`, validated by
-   * the user-supplied schemas (schema output, so transforms apply). Present
-   * only when the project opts in and the page carries at least one value.
+   * Custom frontmatter values declared via `frontmatter.extend` or the page
+   * type's `content.types.<type>.frontmatter`, validated by the user-supplied
+   * schemas (schema output, so transforms apply). Present only when the
+   * project opts in and the page carries at least one value.
    */
   custom?: Record<string, unknown>;
   headings: Heading[];

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

@@ -9,25 +9,40 @@ export const ar: UIStringsOverride = {
     connectMcp: "الاتصال بـ MCP",
     copied: "تم النسخ!",
     copyClaudeCode: "نسخ أمر Claude Code",
+    copyCode: "نسخ الكود",
+    copyCodex: "نسخ أمر Codex",
     copyMarkdown: "نسخ بصيغة Markdown",
     copyServerUrl: "نسخ عنوان URL للخادم",
     edit: "التعديل على GitHub",
+    export: "تصدير",
+    exportEpub: "التصدير إلى EPUB",
+    exportPdf: "التصدير إلى PDF",
+    generating: "جارٍ الإنشاء…",
+    openIn: "فتح في {name}",
     openInChat: "فتح في المحادثة",
     scrollToTop: "العودة إلى الأعلى",
   },
   ask: {
+    ai: "الذكاء الاصطناعي",
+    clear: "مسح المحادثة",
+    close: "إغلاق",
+    copy: "نسخ المحادثة",
     empty: "اطرح سؤالاً حول الوثائق.",
     error: "عذراً، حدث خطأ ما.",
     label: "اطرح سؤالاً",
     placeholder: "اطرح سؤالاً…",
     send: "إرسال",
+    tip: "نصيحة: يمكنك فتح المحادثة وإغلاقها باستخدام",
     title: "اسأل الذكاء الاصطناعي",
+    you: "أنت",
   },
   banner: { dismiss: "إغلاق الإعلان" },
   changelog: {
     description: "تحديثات المنتج وملاحظات الإصدارات.",
+    showReleases: "عرض إصدارات {version}",
     title: "سجل التغييرات",
   },
+  content: { diagramError: "تعذّر عرض هذا المخطط." },
   feedback: {
     no: "لا",
     question: "هل كانت هذه الصفحة مفيدة؟",
@@ -35,7 +50,24 @@ export const ar: UIStringsOverride = {
     yes: "نعم",
   },
   languageSwitcher: { label: "اللغة", untranslated: "غير مترجم" },
-  nav: { breadcrumb: "مسار التنقل" },
+  nav: {
+    back: "رجوع",
+    breadcrumb: "مسار التنقل",
+    closeNavigation: "إغلاق التنقل",
+    deprecated: "مهمل",
+    featured: "مميز",
+    githubRepository: "مستودع GitHub",
+    navigation: "التنقل",
+    primary: "رئيسي",
+    sections: "الأقسام",
+    toggleNavigation: "تبديل التنقل",
+    toggleTheme: "تبديل سمة الألوان",
+  },
+  notFound: {
+    description: "لم نتمكن من العثور على الصفحة التي تبحث عنها.",
+    home: "العودة إلى الصفحة الرئيسية",
+    title: "الصفحة غير موجودة",
+  },
   page: {
     lastUpdated: "آخر تحديث في",
     next: "التالي",
@@ -45,11 +77,20 @@ export const ar: UIStringsOverride = {
   },
   search: {
     all: "الكل",
+    allLanguages: "جميع اللغات",
+    askAi: "اسأل الذكاء الاصطناعي",
+    askAiHint: "احصل على إجابة فورية من الذكاء الاصطناعي",
     button: "بحث",
     devOnly: "البحث متاح في إصدار الإنتاج.",
+    error: "حدث خطأ ما. يرجى المحاولة مرة أخرى.",
     label: "البحث في الوثائق",
+    navigate: "تنقل",
     noResults: "لم يتم العثور على نتائج.",
+    open: "فتح",
     placeholder: "البحث في الوثائق…",
+    popular: "شائع",
+    preview: "معاينة",
+    results: "النتائج",
   },
   toc: { title: "في هذه الصفحة" },
 };

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

@@ -9,25 +9,40 @@ export const bg: UIStringsOverride = {
     connectMcp: "Свържи се с MCP",
     copied: "Копирано!",
     copyClaudeCode: "Копирай командата на Claude Code",
+    copyCode: "Копирай кода",
+    copyCodex: "Копирай командата на Codex",
     copyMarkdown: "Копирай като Markdown",
     copyServerUrl: "Копирай URL на сървъра",
     edit: "Редактирай в GitHub",
+    export: "Експортирай",
+    exportEpub: "Експортирай в EPUB",
+    exportPdf: "Експортирай в PDF",
+    generating: "Генериране…",
+    openIn: "Отвори в {name}",
     openInChat: "Отвори в чата",
     scrollToTop: "Нагоре",
   },
   ask: {
+    ai: "ИИ",
+    clear: "Изчисти разговора",
+    close: "Затвори",
+    copy: "Копирай разговора",
     empty: "Задайте въпрос за документацията.",
     error: "Съжаляваме, нещо се обърка.",
     label: "Задайте въпрос",
     placeholder: "Задайте въпрос…",
     send: "Изпрати",
+    tip: "Съвет: Можете да отваряте и затваряте чата с",
     title: "Попитай ИИ",
+    you: "Вие",
   },
   banner: { dismiss: "Затваряне на съобщението" },
   changelog: {
     description: "Актуализации на продукта и бележки към изданията.",
+    showReleases: "Покажи изданията на {version}",
     title: "Дневник на промените",
   },
+  content: { diagramError: "Тази диаграма не можа да бъде показана." },
   feedback: {
     no: "Не",
     question: "Беше ли полезна тази страница?",
@@ -35,7 +50,24 @@ export const bg: UIStringsOverride = {
     yes: "Да",
   },
   languageSwitcher: { label: "Език", untranslated: "Непреведено" },
-  nav: { breadcrumb: "Навигационна пътека" },
+  nav: {
+    back: "Назад",
+    breadcrumb: "Навигационна пътека",
+    closeNavigation: "Затвори навигацията",
+    deprecated: "остаряло",
+    featured: "Препоръчано",
+    githubRepository: "Хранилище в GitHub",
+    navigation: "Навигация",
+    primary: "Основно",
+    sections: "Раздели",
+    toggleNavigation: "Превключи навигацията",
+    toggleTheme: "Превключи цветовата тема",
+  },
+  notFound: {
+    description: "Не успяхме да намерим страницата, която търсите.",
+    home: "Обратно към началната страница",
+    title: "Страницата не е намерена",
+  },
   page: {
     lastUpdated: "Последна актуализация",
     next: "Напред",
@@ -45,11 +77,20 @@ export const bg: UIStringsOverride = {
   },
   search: {
     all: "Всички",
+    allLanguages: "Всички езици",
+    askAi: "Попитай ИИ",
+    askAiHint: "Получете незабавен отговор от ИИ",
     button: "Търсене",
     devOnly: "Търсенето е достъпно в производствената компилация.",
+    error: "Нещо се обърка. Моля, опитайте отново.",
     label: "Търсене в документацията",
+    navigate: "навигация",
     noResults: "Няма намерени резултати.",
+    open: "отвори",
     placeholder: "Търсене в документацията…",
+    popular: "Популярни",
+    preview: "преглед",
+    results: "Резултати",
   },
   toc: { title: "На тази страница" },
 };

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

@@ -9,25 +9,40 @@ export const bn: UIStringsOverride = {
     connectMcp: "MCP-তে সংযোগ করুন",
     copied: "অনুলিপি করা হয়েছে!",
     copyClaudeCode: "Claude Code কমান্ড অনুলিপি করুন",
+    copyCode: "কোড অনুলিপি করুন",
+    copyCodex: "Codex কমান্ড অনুলিপি করুন",
     copyMarkdown: "Markdown হিসেবে অনুলিপি করুন",
     copyServerUrl: "সার্ভার URL অনুলিপি করুন",
     edit: "GitHub-এ সম্পাদনা করুন",
+    export: "এক্সপোর্ট করুন",
+    exportEpub: "EPUB-এ এক্সপোর্ট করুন",
+    exportPdf: "PDF-এ এক্সপোর্ট করুন",
+    generating: "তৈরি হচ্ছে…",
+    openIn: "{name}-এ খুলুন",
     openInChat: "চ্যাটে খুলুন",
     scrollToTop: "উপরে যান",
   },
   ask: {
+    ai: "AI",
+    clear: "কথোপকথন মুছুন",
+    close: "বন্ধ করুন",
+    copy: "কথোপকথন অনুলিপি করুন",
     empty: "ডকুমেন্টেশন সম্পর্কে একটি প্রশ্ন করুন।",
     error: "দুঃখিত, কিছু একটা ভুল হয়েছে।",
     label: "একটি প্রশ্ন করুন",
     placeholder: "একটি প্রশ্ন করুন…",
     send: "পাঠান",
+    tip: "টিপ: চ্যাট খুলতে ও বন্ধ করতে চাপুন",
     title: "AI-কে জিজ্ঞাসা করুন",
+    you: "আপনি",
   },
   banner: { dismiss: "ঘোষণা বন্ধ করুন" },
   changelog: {
     description: "পণ্য আপডেট এবং রিলিজ নোট।",
+    showReleases: "{version} রিলিজ দেখান",
     title: "পরিবর্তন লগ",
   },
+  content: { diagramError: "এই ডায়াগ্রামটি রেন্ডার করা যায়নি।" },
   feedback: {
     no: "না",
     question: "এই পৃষ্ঠাটি কি সহায়ক ছিল?",
@@ -35,7 +50,24 @@ export const bn: UIStringsOverride = {
     yes: "হ্যাঁ",
   },
   languageSwitcher: { label: "ভাষা", untranslated: "অনূদিত নয়" },
-  nav: { breadcrumb: "ব্রেডক্রাম্ব" },
+  nav: {
+    back: "ফিরে যান",
+    breadcrumb: "ব্রেডক্রাম্ব",
+    closeNavigation: "নেভিগেশন বন্ধ করুন",
+    deprecated: "অপ্রচলিত",
+    featured: "ফিচার্ড",
+    githubRepository: "GitHub রিপোজিটরি",
+    navigation: "নেভিগেশন",
+    primary: "প্রধান",
+    sections: "বিভাগসমূহ",
+    toggleNavigation: "নেভিগেশন টগল করুন",
+    toggleTheme: "রঙের থিম টগল করুন",
+  },
+  notFound: {
+    description: "আপনি যে পৃষ্ঠাটি খুঁজছেন তা আমরা খুঁজে পাইনি।",
+    home: "হোমে ফিরে যান",
+    title: "পৃষ্ঠা পাওয়া যায়নি",
+  },
   page: {
     lastUpdated: "সর্বশেষ আপডেট",
     next: "পরবর্তী",
@@ -45,11 +77,20 @@ export const bn: UIStringsOverride = {
   },
   search: {
     all: "সব",
+    allLanguages: "সব ভাষা",
+    askAi: "AI-কে জিজ্ঞাসা করুন",
+    askAiHint: "AI থেকে তাৎক্ষণিক উত্তর পান",
     button: "অনুসন্ধান",
     devOnly: "অনুসন্ধান প্রোডাকশন বিল্ডে উপলব্ধ।",
+    error: "কিছু একটা ভুল হয়েছে। অনুগ্রহ করে আবার চেষ্টা করুন।",
     label: "ডকুমেন্টেশন অনুসন্ধান করুন",
+    navigate: "নেভিগেট",
     noResults: "কোনো ফলাফল পাওয়া যায়নি।",
+    open: "খুলুন",
     placeholder: "ডকুমেন্টেশন অনুসন্ধান করুন…",
+    popular: "জনপ্রিয়",
+    preview: "প্রিভিউ",
+    results: "ফলাফল",
   },
   toc: { title: "এই পৃষ্ঠায়" },
 };

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

@@ -9,25 +9,42 @@ export const ca: UIStringsOverride = {
     connectMcp: "Connecta a MCP",
     copied: "Copiat!",
     copyClaudeCode: "Copia l'ordre de Claude Code",
+    copyCode: "Copia el codi",
+    copyCodex: "Copia l'ordre de Codex",
     copyMarkdown: "Copia com a Markdown",
     copyServerUrl: "Copia l'URL del servidor",
     edit: "Edita a GitHub",
+    export: "Exporta",
+    exportEpub: "Exporta a EPUB",
+    exportPdf: "Exporta a PDF",
+    generating: "S'està generant…",
+    openIn: "Obre a {name}",
     openInChat: "Obre al xat",
     scrollToTop: "Torna a dalt",
   },
   ask: {
+    ai: "IA",
+    clear: "Esborra la conversa",
+    close: "Tanca",
+    copy: "Copia la conversa",
     empty: "Fes una pregunta sobre la documentació.",
     error: "Ho sentim, alguna cosa ha anat malament.",
     label: "Fes una pregunta",
     placeholder: "Fes una pregunta…",
     send: "Envia",
+    tip: "Consell: pots obrir i tancar el xat amb",
     title: "Pregunta a la IA",
+    you: "Tu",
   },
   banner: { dismiss: "Tanca l'anunci" },
   changelog: {
     description: "Actualitzacions del producte i notes de la versió.",
+    showReleases: "Mostra les versions {version}",
     title: "Registre de canvis",
   },
+  content: {
+    diagramError: "No s'ha pogut mostrar aquest diagrama.",
+  },
   feedback: {
     no: "No",
     question: "Aquesta pàgina t'ha estat útil?",
@@ -35,7 +52,24 @@ export const ca: UIStringsOverride = {
     yes: "Sí",
   },
   languageSwitcher: { label: "Idioma", untranslated: "Sense traduir" },
-  nav: { breadcrumb: "Ruta de navegació" },
+  nav: {
+    back: "Enrere",
+    breadcrumb: "Ruta de navegació",
+    closeNavigation: "Tanca la navegació",
+    deprecated: "obsolet",
+    featured: "Destacat",
+    githubRepository: "Repositori de GitHub",
+    navigation: "Navegació",
+    primary: "Principal",
+    sections: "Seccions",
+    toggleNavigation: "Mostra o amaga la navegació",
+    toggleTheme: "Canvia el tema de color",
+  },
+  notFound: {
+    description: "No hem pogut trobar la pàgina que cerques.",
+    home: "Torna a l'inici",
+    title: "Pàgina no trobada",
+  },
   page: {
     lastUpdated: "Última actualització el",
     next: "Següent",
@@ -45,11 +79,20 @@ export const ca: UIStringsOverride = {
   },
   search: {
     all: "Tots",
+    allLanguages: "Tots els idiomes",
+    askAi: "Pregunta a la IA",
+    askAiHint: "Obtén una resposta instantània de la IA",
     button: "Cerca",
     devOnly: "La cerca està disponible a la compilació de producció.",
+    error: "Alguna cosa ha anat malament. Torna-ho a provar.",
     label: "Cerca a la documentació",
+    navigate: "navega",
     noResults: "No s'ha trobat cap resultat.",
+    open: "obre",
     placeholder: "Cerca a la documentació…",
+    popular: "Populars",
+    preview: "previsualitza",
+    results: "Resultats",
   },
   toc: { title: "En aquesta pàgina" },
 };