blume 2.0.3 → 2.1.1

package/src/core/sources/remote.ts

@@ -1,7 +1,9 @@
 import { join } from "pathe";
 
+import { BlumeError } from "../diagnostics.ts";
 import matter from "../frontmatter.ts";
 import { neutralizeUnsafeLinks } from "../safe-links.ts";
+import type { Diagnostic } from "../types.ts";
 import {
   hashText,
   loadWithCache,
@@ -9,7 +11,7 @@ import {
   snapshotCache,
 } from "./cache.ts";
 import type { JsonObject, JsonValue } from "./json.ts";
-import { asString, getPath, isStringValue } from "./json.ts";
+import { asNumber, asString, getPath, isStringValue } from "./json.ts";
 import { slugify, slugifyPath } from "./normalize.ts";
 import type {
   ContentSource,
@@ -27,8 +29,15 @@ export interface RemoteSourceOptions {
    * offline warning.
    */
   assertConfigured?: () => void;
-  /** Pull every entry from the API; called on refresh and on each poll. */
-  fetchEntries: () => Promise<SourceEntry[]>;
+  /**
+   * Pull every entry from the API; called on refresh and on each poll.
+   * `warn` reports a problem with the content itself (an embed the API
+   * couldn't resolve, a node with no Markdown), which the load returns
+   * beside the entries; a load served from the snapshot repeats none.
+   */
+  fetchEntries: (
+    warn: (diagnostic: Diagnostic) => void
+  ) => Promise<SourceEntry[]>;
   name: string;
   /** Opt-in dev polling interval (seconds); omit to freeze for the session. */
   pollInterval?: number;
@@ -56,14 +65,24 @@ export const remoteSource = (
     refresh = ctx?.refresh ?? true
   ): Promise<SourceLoadResult> => {
     options.assertConfigured?.();
+    // Set only once a fetch succeeds, so a failed one that falls back to the
+    // snapshot reports nothing about pages it never delivered.
+    let warnings: Diagnostic[] = [];
     const result = await loadWithCache(
       options.name,
       cache,
-      options.fetchEntries,
+      async () => {
+        const found: Diagnostic[] = [];
+        const entries = await options.fetchEntries((diagnostic) => {
+          found.push(diagnostic);
+        });
+        warnings = found;
+        return entries;
+      },
       refresh
     );
     snapshot = new Map(result.entries.map((entry) => [entry.ref, entry]));
-    return result;
+    return { ...result, diagnostics: [...result.diagnostics, ...warnings] };
   };
 
   const read = async (ref: string): Promise<string> => {
@@ -96,6 +115,7 @@ export const remoteSource = (
 export interface RemoteFrontmatter {
   description?: string;
   draft?: boolean;
+  sidebar?: { order: number };
   title?: string;
 }
 
@@ -124,6 +144,20 @@ export const stagedEntry = (
   };
 };
 
+/**
+ * The error a source throws before its first request when the token its API
+ * always requires is unset (Notion, Contentful's Delivery API). Sent without
+ * one, the request could only fail, and the build would report the API's
+ * wording as a fetch failure instead of the variable to set.
+ */
+export const missingSecretError = (name: string, env: string): BlumeError =>
+  new BlumeError({
+    code: "BLUME_MISSING_SECRET",
+    message: `Source "${name}" needs ${env}, which is not set.`,
+    severity: "error",
+    suggestion: `Set ${env} in .env.local for local dev, or in your host's environment for production.`,
+  });
+
 /** How a source calls its CMS: the API's auth headers and an injectable fetch. */
 export interface RestClient {
   /** Injected for tests; defaults to the global `fetch`. */
@@ -183,31 +217,50 @@ export interface RemoteFieldMap {
   description?: string;
   /** Field holding the last-modified ISO date. */
   lastModified?: string;
+  /** Field holding the sidebar order (a number); no default. */
+  order?: string;
   /** Field holding the route slug. */
   slug?: string;
   /** Field holding the page title. */
   title?: string;
 }
 
+/** A field map with its defaults filled in; `order` is read only when set. */
+export type RemoteFields = Required<Omit<RemoteFieldMap, "order">> &
+  Pick<RemoteFieldMap, "order">;
+
+/**
+ * The slug a document's staged entry is named by. It falls back to the
+ * document's id when the slug field is missing or slugifies to nothing (pure
+ * punctuation), so distinct documents never collapse onto one
+ * `untitled.md`; a slashed slug keeps its segments.
+ */
+export const documentSlug = (
+  doc: JsonObject,
+  slugField: string,
+  id: string
+): string =>
+  slugifyPath(asString(getPath(doc, slugField)) ?? id) ||
+  slugify(id) ||
+  "untitled";
+
 /**
- * Map a document to a staged entry. The slug falls back to the document's id
- * when the slug field is missing or slugifies to nothing (pure punctuation),
- * so distinct documents never collapse onto one `untitled.md`; a slashed
- * slug keeps its segments. A string body is Markdown and passes through as
- * `.md`, its unsafe links reduced to their labels; any other shape goes to
- * the CMS's lowerer, and is written as `.mdx`
- * when `lowersToMdx` (the source has serializers, see `writesMdx`).
+ * Map a document to a staged entry named by its {@link documentSlug}. A
+ * number in the `order` field, when one is mapped, becomes the page's
+ * sidebar order. A string body is Markdown and passes through as `.md`, its
+ * unsafe links reduced to their labels; any other shape goes to the CMS's
+ * lowerer, and is written as `.mdx` when `lowersToMdx` (the source has
+ * serializers, see `writesMdx`).
  */
 export const documentEntry = (
   doc: JsonObject,
-  fields: Required<RemoteFieldMap>,
+  fields: RemoteFields,
   id: string,
   lower: (body: JsonValue) => string,
   draft = false,
   lowersToMdx = false
 ): SourceEntry => {
-  const slugValue = asString(getPath(doc, fields.slug)) ?? id;
-  const slug = slugifyPath(slugValue) || slugify(id) || "untitled";
+  const slug = documentSlug(doc, fields.slug, id);
   const data: RemoteFrontmatter = {};
   const title = asString(getPath(doc, fields.title));
   const description = asString(getPath(doc, fields.description));
@@ -220,6 +273,10 @@ export const documentEntry = (
   if (draft) {
     data.draft = true;
   }
+  const order = fields.order ? asNumber(getPath(doc, fields.order)) : undefined;
+  if (order !== undefined) {
+    data.sidebar = { order };
+  }
   const body = getPath(doc, fields.body);
   let markdown = "";
   let format: "md" | "mdx" = "md";

package/src/core/sources/resolve.ts

@@ -138,7 +138,17 @@ const buildSource = (
       return notionSource({ ...adapter.options, name }, ctx());
     }
     case "contentful": {
-      return contentfulSource({ ...adapter.options, name }, ctx());
+      // i18n and versions place an entry hyperlink's route as they do the
+      // linked entry's page.
+      return contentfulSource(
+        {
+          ...adapter.options,
+          i18n: config.i18n,
+          name,
+          versions: config.versions,
+        },
+        ctx()
+      );
     }
     case "payload": {
       return payloadSource({ ...adapter.options, name }, ctx());

package/src/core/sources/sanity.ts

@@ -3,6 +3,8 @@ import { join } from "pathe";
 import { BlumeError } from "../diagnostics.ts";
 import matter from "../frontmatter.ts";
 import { nodeRequire } from "../node-require.ts";
+import { neutralizeUnsafeLinks } from "../safe-links.ts";
+import type { Diagnostic } from "../types.ts";
 import {
   hashText,
   loadWithCache,
@@ -10,7 +12,7 @@ import {
   snapshotCache,
 } from "./cache.ts";
 import type { JsonObject } from "./json.ts";
-import { asString, getPath } from "./json.ts";
+import { asString, getPath, isStringValue } from "./json.ts";
 import { writesMdx } from "./lower.ts";
 import { slugify, slugifyPath } from "./normalize.ts";
 import { portableTextToMarkdown } from "./portable-text.ts";
@@ -35,7 +37,7 @@ export interface SanityFieldMap {
   description?: string;
   /** Route slug (dot path); default `slug.current`. */
   slug?: string;
-  /** Portable Text body field; default `body`. */
+  /** Body field, Portable Text or a Markdown string; default `body`. */
   body?: string;
   /** Last-modified ISO date; default `_updatedAt`. */
   lastModified?: string;
@@ -172,29 +174,32 @@ export const sanitySource = (
       data.description = description;
     }
 
-    // SAFETY: the configured body field holds Portable Text blocks; a value of
-    // any other shape fails the `Array.isArray` check below and yields an
-    // empty body, and the serializer tolerates malformed blocks.
-    const blocks = (getPath(doc, fields.body ?? "body") ??
-      []) as PortableTextBlock[];
-    const markdown = Array.isArray(blocks)
-      ? portableTextToMarkdown(blocks, {
-          imageUrl: (block) => {
-            // SAFETY: `asset` on an image block is Sanity's asset reference
-            // object; any other shape yields no `_ref` and the image is
-            // skipped.
-            const ref = (block.asset as { _ref?: string } | undefined)?._ref;
-            return ref
-              ? imageUrlFromRef(ref, options.projectId, options.dataset)
-              : null;
-          },
-          serializers: options.serializers,
-        })
-      : "";
-
+    const body = getPath(doc, fields.body ?? "body");
+    let markdown = "";
     // Serializer output is MDX (components, directives), so a source with
-    // serializers writes its entries as `.mdx`.
-    const format = writesMdx(options.serializers) ? "mdx" : "md";
+    // serializers writes its Portable Text entries as `.mdx`.
+    let format: "md" | "mdx" = writesMdx(options.serializers) ? "mdx" : "md";
+    if (isStringValue(body)) {
+      // A Markdown field passes through as `.md`, its unsafe links reduced to
+      // their labels, as the other CMS sources do (see `documentEntry`).
+      markdown = neutralizeUnsafeLinks(`${body.trimEnd()}\n`);
+      format = "md";
+    } else if (Array.isArray(body)) {
+      // SAFETY: an array in the body field is Portable Text blocks; the
+      // serializer tolerates malformed blocks.
+      markdown = portableTextToMarkdown(body as PortableTextBlock[], {
+        imageUrl: (block) => {
+          // SAFETY: `asset` on an image block is Sanity's asset reference
+          // object; any other shape yields no `_ref` and the image is
+          // skipped.
+          const ref = (block.asset as { _ref?: string } | undefined)?._ref;
+          return ref
+            ? imageUrlFromRef(ref, options.projectId, options.dataset)
+            : null;
+        },
+        serializers: options.serializers,
+      });
+    }
     const raw = matter.stringify(markdown, data);
     return {
       body: { format, text: markdown },
@@ -211,18 +216,31 @@ export const sanitySource = (
   const load = async (
     refresh = ctx?.refresh ?? true
   ): Promise<SourceLoadResult> => {
+    const empty: Diagnostic[] = [];
     const result = await loadWithCache(
       options.name,
       cache,
       async () => {
         const client = resolveClient(options, ctx?.preview ?? false);
         const docs = await client.fetch<SanityDocument[]>(options.query);
+        // A private dataset answers a query without a token with no
+        // documents rather than an error, so an empty result is the only
+        // sign the token is missing.
+        if (docs.length === 0 && !(options.token ?? process.env.SANITY_TOKEN)) {
+          empty.push({
+            code: "BLUME_MISSING_SECRET",
+            message: `Source "${options.name}" found no documents, and SANITY_TOKEN is not set. A private dataset returns nothing to a query without a token.`,
+            severity: "warning",
+            suggestion:
+              "Set SANITY_TOKEN to a token with read access if the dataset is private.",
+          });
+        }
         return docs.map(toEntry);
       },
       refresh
     );
     snapshot = new Map(result.entries.map((entry) => [entry.ref, entry]));
-    return result;
+    return { ...result, diagnostics: [...result.diagnostics, ...empty] };
   };
 
   const read = async (ref: string): Promise<string> => {

package/src/core/sources/strapi.ts

@@ -1,6 +1,6 @@
 import type { JsonObject } from "./json.ts";
 import { asNumber, asObject, asString, getPath, objectsIn } from "./json.ts";
-import type { RemoteFieldMap, RestClient } from "./remote.ts";
+import type { RemoteFieldMap, RemoteFields, RestClient } from "./remote.ts";
 import {
   documentEntry,
   fetchJson,
@@ -38,7 +38,7 @@ export interface StrapiSourceOptions {
 
 const PAGE_SIZE = 100;
 
-const DEFAULT_FIELDS: Required<RemoteFieldMap> = {
+const DEFAULT_FIELDS: RemoteFields = {
   body: "content",
   description: "description",
   lastModified: "updatedAt",

package/src/core/types.ts

@@ -62,6 +62,10 @@ export interface PageLink {
    * only those go through the image pipeline; a plain link to the same path
    * resolves as a site route. */
   image?: boolean;
+  /** Set when the target is a lowercase `<a href>`, which ships as written:
+   * the Markdown pipeline neither resolves its relative path file-style nor
+   * mounts the base path on it, so it's checked the way a browser reads it. */
+  raw?: boolean;
   /** 1-based line number in the source file. */
   line: number;
   /** 1-based column of the target within the line. */
@@ -72,6 +76,18 @@ export interface PageLink {
   file?: string;
 }
 
+/** A `<Component path="…">` in a page, located like a {@link PageLink}. */
+export interface ExampleUse {
+  /** The example's key as written: its path under `examples/`, sans extension. */
+  path: string;
+  /** 1-based line number in the source file. */
+  line: number;
+  /** 1-based column of the `path` value within the line. */
+  column: number;
+  /** Absolute path of the included partial it was written in, if not the page. */
+  file?: string;
+}
+
 /**
  * Resolved project paths. Computed once per CLI invocation and threaded
  * through the core pipeline.
@@ -194,6 +210,8 @@ export interface PageRecord {
   links: PageLink[];
   /** Capitalized JSX component tags used in the body (`.mdx` only). */
   componentsUsed?: string[];
+  /** The string `path` of each `<Component>` example in the body (`.mdx` only). */
+  examplesUsed?: ExampleUse[];
   /** Resolved "last updated" ISO date, when the feature is enabled. */
   lastModified?: string;
   /** Absolute paths of files this page `<include>`s, transitively. Drives the
@@ -316,7 +334,7 @@ export interface Navigation {
   cta?: HeaderAction | null;
   /** Pinned links shown above the sidebar sections, unscoped by tab. */
   featured: FeaturedLink[];
-  /** Repo URL for the header link, or null when hidden (`navigation.repo`). */
+  /** Repo URL for the footer's GitHub link, or null when hidden (`navigation.repo`). */
   repoUrl?: string | null;
   /**
    * Where the header's brand link points in this locale: `logo.href` moved

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

@@ -5,6 +5,7 @@ export const ar: UIStringsOverride = {
   actions: {
     addToCursor: "إضافة إلى Cursor",
     addToVscode: "إضافة إلى VS Code",
+    askAboutCode: "اسأل عن هذه الشيفرة",
     connectMcp: "الاتصال بـ MCP",
     copied: "تم النسخ!",
     copyClaudeCode: "نسخ أمر Claude Code",
@@ -30,18 +31,34 @@ export const ar: UIStringsOverride = {
     copy: "نسخ المحادثة",
     empty: "اطرح سؤالاً حول الوثائق.",
     error: "عذراً، حدث خطأ ما.",
+    explainCode: "اشرح هذه الشيفرة.",
     label: "اطرح سؤالاً",
+    open: "فتح المساعد",
     placeholder: "اطرح سؤالاً…",
+    rateLimited: "لقد طرحت الكثير من الأسئلة. حاول مرة أخرى بعد بضع دقائق.",
+    removeCode: "إزالة الشيفرة",
     send: "إرسال",
+    support: "تواصل مع الدعم",
+    supportSubject: "سؤال من التوثيق",
     tip: "نصيحة: يمكنك فتح المحادثة وإغلاقها باستخدام",
     title: "المساعد",
+    verifyFailed: "تعذّر التحقق من أنك إنسان. حاول مرة أخرى.",
     you: "أنت",
   },
   banner: { dismiss: "إغلاق الإعلان" },
   changelog: {
     description: "تحديثات المنتج وملاحظات الإصدارات.",
+    empty: "لا توجد إدخالات في سجل التغييرات بعد.",
     title: "سجل التغييرات",
   },
+  consent: {
+    accept: "قبول",
+    decline: "رفض",
+    label: "الموافقة على ملفات تعريف الارتباط",
+    message: "نودّ استخدام ملفات تعريف الارتباط لفهم كيفية استخدام هذا التوثيق.",
+    policy: "سياسة الخصوصية",
+    settings: "إعدادات ملفات تعريف الارتباط",
+  },
   content: {
     code: "الكود",
     copyColor: "نسخ اللون {name} {value}",
@@ -52,6 +69,8 @@ export const ar: UIStringsOverride = {
     preview: "معاينة",
     prop: "الخاصية",
     selectTab: "اختيار علامة تبويب",
+    selectView: "اختيار طريقة العرض",
+    showLess: "عرض أقل",
     showMore: "عرض المزيد",
     stars: "النجوم",
     tab: "علامة التبويب {n}",
@@ -59,12 +78,36 @@ export const ar: UIStringsOverride = {
     update: "تحديث",
   },
   feedback: {
+    comment: "أخبرنا بالمزيد (اختياري)",
     no: "لا",
     question: "هل كانت هذه الصفحة مفيدة؟",
+    send: "إرسال",
     thanks: "شكراً على ملاحظاتك!",
     yes: "نعم",
   },
   languageSwitcher: { label: "اللغة", untranslated: "غير مترجم" },
+  narration: {
+    cueDanger: "خطر.",
+    cueInfo: "معلومة.",
+    cueNote: "ملاحظة.",
+    cueSection: "قسم قابل للتوسيع.",
+    cueStep: "الخطوة {n}.",
+    cueSuccess: "نجاح.",
+    cueTab: "علامة التبويب {title}.",
+    cueTip: "نصيحة.",
+    cueWarning: "تحذير.",
+    error: "تعذّر تحميل القراءة الصوتية.",
+    follow: "متابعة القراءة",
+    label: "استمع إلى هذه الصفحة",
+    minutes: "{n} دقيقة",
+    next: "الجملة التالية",
+    pause: "إيقاف مؤقت",
+    play: "تشغيل",
+    previous: "الجملة السابقة",
+    progress: "تقدّم القراءة",
+    speed: "سرعة التشغيل",
+    stop: "إيقاف الاستماع",
+  },
   nav: {
     back: "رجوع",
     breadcrumb: "مسار التنقل",
@@ -89,6 +132,7 @@ export const ar: UIStringsOverride = {
     next: "التالي",
     pagination: "ترقيم الصفحات",
     previous: "السابق",
+    related: "صفحات ذات صلة",
     skipToContent: "الانتقال إلى المحتوى",
   },
   search: {

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

@@ -5,6 +5,7 @@ export const bg: UIStringsOverride = {
   actions: {
     addToCursor: "Добави в Cursor",
     addToVscode: "Добави във VS Code",
+    askAboutCode: "Попитай за този код",
     connectMcp: "Свържи се с MCP",
     copied: "Копирано!",
     copyClaudeCode: "Копирай командата на Claude Code",
@@ -31,18 +32,36 @@ export const bg: UIStringsOverride = {
     copy: "Копирай разговора",
     empty: "Задайте въпрос за документацията.",
     error: "Съжаляваме, нещо се обърка.",
+    explainCode: "Обясни този код.",
     label: "Задайте въпрос",
+    open: "Отваряне на асистента",
     placeholder: "Задайте въпрос…",
+    rateLimited:
+      "Зададохте много въпроси. Опитайте отново след няколко минути.",
+    removeCode: "Премахни кода",
     send: "Изпрати",
+    support: "Свържете се с поддръжката",
+    supportSubject: "Въпрос от документацията",
     tip: "Съвет: Можете да отваряте и затваряте чата с",
     title: "Асистент",
+    verifyFailed: "Не успяхме да потвърдим, че сте човек. Опитайте отново.",
     you: "Вие",
   },
   banner: { dismiss: "Затваряне на съобщението" },
   changelog: {
     description: "Актуализации на продукта и бележки към изданията.",
+    empty: "Все още няма записи в дневника на промените.",
     title: "Дневник на промените",
   },
+  consent: {
+    accept: "Приемам",
+    decline: "Отказвам",
+    label: "Съгласие за бисквитки",
+    message:
+      "Бихме искали да използваме бисквитки, за да разберем как се използва тази документация.",
+    policy: "Политика за поверителност",
+    settings: "Настройки за бисквитки",
+  },
   content: {
     code: "Код",
     copyColor: "Копирай цвета {name} {value}",
@@ -53,6 +72,8 @@ export const bg: UIStringsOverride = {
     preview: "Преглед",
     prop: "Свойство",
     selectTab: "Избери раздел",
+    selectView: "Избери изглед",
+    showLess: "Покажи по-малко",
     showMore: "Покажи още",
     stars: "Звезди",
     tab: "Раздел {n}",
@@ -60,12 +81,36 @@ export const bg: UIStringsOverride = {
     update: "Актуализация",
   },
   feedback: {
+    comment: "Разкажете ни повече (по избор)",
     no: "Не",
     question: "Беше ли полезна тази страница?",
+    send: "Изпрати",
     thanks: "Благодарим за обратната връзка!",
     yes: "Да",
   },
   languageSwitcher: { label: "Език", untranslated: "Непреведено" },
+  narration: {
+    cueDanger: "Опасност.",
+    cueInfo: "Информация.",
+    cueNote: "Бележка.",
+    cueSection: "Разгъваем раздел.",
+    cueStep: "Стъпка {n}.",
+    cueSuccess: "Успех.",
+    cueTab: "Раздел {title}.",
+    cueTip: "Съвет.",
+    cueWarning: "Предупреждение.",
+    error: "Аудиоверсията не можа да бъде заредена.",
+    follow: "Следи четенето",
+    label: "Слушай тази страница",
+    minutes: "{n} мин",
+    next: "Следващо изречение",
+    pause: "Пауза",
+    play: "Пусни",
+    previous: "Предишно изречение",
+    progress: "Напредък на четенето",
+    speed: "Скорост на възпроизвеждане",
+    stop: "Спри слушането",
+  },
   nav: {
     back: "Назад",
     breadcrumb: "Навигационна пътека",
@@ -90,6 +135,7 @@ export const bg: UIStringsOverride = {
     next: "Напред",
     pagination: "Пагинация",
     previous: "Назад",
+    related: "Свързани страници",
     skipToContent: "Към съдържанието",
   },
   search: {

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

@@ -5,6 +5,7 @@ export const bn: UIStringsOverride = {
   actions: {
     addToCursor: "Cursor-এ যোগ করুন",
     addToVscode: "VS Code-এ যোগ করুন",
+    askAboutCode: "এই কোড সম্পর্কে জিজ্ঞাসা করুন",
     connectMcp: "MCP-তে সংযোগ করুন",
     copied: "অনুলিপি করা হয়েছে!",
     copyClaudeCode: "Claude Code কমান্ড অনুলিপি করুন",
@@ -30,18 +31,34 @@ export const bn: UIStringsOverride = {
     copy: "কথোপকথন অনুলিপি করুন",
     empty: "ডকুমেন্টেশন সম্পর্কে একটি প্রশ্ন করুন।",
     error: "দুঃখিত, কিছু একটা ভুল হয়েছে।",
+    explainCode: "এই কোডটি ব্যাখ্যা করুন।",
     label: "একটি প্রশ্ন করুন",
+    open: "সহকারী খুলুন",
     placeholder: "একটি প্রশ্ন করুন…",
+    rateLimited: "আপনি অনেক প্রশ্ন করেছেন। কয়েক মিনিট পরে আবার চেষ্টা করুন।",
+    removeCode: "কোড সরান",
     send: "পাঠান",
+    support: "সহায়তার সঙ্গে যোগাযোগ করুন",
+    supportSubject: "ডকুমেন্টেশন থেকে প্রশ্ন",
     tip: "টিপ: চ্যাট খুলতে ও বন্ধ করতে চাপুন",
     title: "সহকারী",
+    verifyFailed: "আপনি মানুষ কি না তা যাচাই করা যায়নি। আবার চেষ্টা করুন।",
     you: "আপনি",
   },
   banner: { dismiss: "ঘোষণা বন্ধ করুন" },
   changelog: {
     description: "পণ্য আপডেট এবং রিলিজ নোট।",
+    empty: "পরিবর্তন লগে এখনও কোনো এন্ট্রি নেই।",
     title: "পরিবর্তন লগ",
   },
+  consent: {
+    accept: "গ্রহণ করুন",
+    decline: "প্রত্যাখ্যান করুন",
+    label: "কুকি সম্মতি",
+    message: "এই ডকুমেন্টেশন কীভাবে ব্যবহার হয় তা বুঝতে আমরা কুকি ব্যবহার করতে চাই।",
+    policy: "গোপনীয়তা নীতি",
+    settings: "কুকি সেটিংস",
+  },
   content: {
     code: "কোড",
     copyColor: "{name} রং {value} অনুলিপি করুন",
@@ -52,6 +69,8 @@ export const bn: UIStringsOverride = {
     preview: "প্রিভিউ",
     prop: "প্রপ",
     selectTab: "ট্যাব নির্বাচন করুন",
+    selectView: "ভিউ নির্বাচন করুন",
+    showLess: "কম দেখান",
     showMore: "আরও দেখান",
     stars: "স্টার",
     tab: "ট্যাব {n}",
@@ -59,12 +78,36 @@ export const bn: UIStringsOverride = {
     update: "আপডেট",
   },
   feedback: {
+    comment: "আরও বলুন (ঐচ্ছিক)",
     no: "না",
     question: "এই পৃষ্ঠাটি কি সহায়ক ছিল?",
+    send: "পাঠান",
     thanks: "আপনার মতামতের জন্য ধন্যবাদ!",
     yes: "হ্যাঁ",
   },
   languageSwitcher: { label: "ভাষা", untranslated: "অনূদিত নয়" },
+  narration: {
+    cueDanger: "বিপদ।",
+    cueInfo: "তথ্য।",
+    cueNote: "নোট।",
+    cueSection: "প্রসারণযোগ্য অংশ।",
+    cueStep: "ধাপ {n}।",
+    cueSuccess: "সফল।",
+    cueTab: "{title} ট্যাব।",
+    cueTip: "টিপ।",
+    cueWarning: "সতর্কতা।",
+    error: "অডিও লোড করা যায়নি।",
+    follow: "পাঠের সাথে থাকুন",
+    label: "এই পৃষ্ঠাটি শুনুন",
+    minutes: "{n} মিনিট",
+    next: "পরবর্তী বাক্য",
+    pause: "বিরতি",
+    play: "চালান",
+    previous: "পূর্ববর্তী বাক্য",
+    progress: "পাঠের অগ্রগতি",
+    speed: "প্লেব্যাকের গতি",
+    stop: "শোনা বন্ধ করুন",
+  },
   nav: {
     back: "ফিরে যান",
     breadcrumb: "ব্রেডক্রাম্ব",
@@ -89,6 +132,7 @@ export const bn: UIStringsOverride = {
     next: "পরবর্তী",
     pagination: "পেজিনেশন",
     previous: "পূর্ববর্তী",
+    related: "সম্পর্কিত পৃষ্ঠা",
     skipToContent: "বিষয়বস্তুতে যান",
   },
   search: {