blume 2.0.2 → 2.1.0

package/src/core/sources/notion.ts

@@ -15,14 +15,15 @@ import {
   pollingWatch,
   snapshotCache,
 } from "./cache.ts";
+import type { InlineRun } from "./lower.ts";
 import {
   codeFence,
   guardBlockStart,
   image,
+  linkParts,
   renderInline,
-  renderLink,
 } from "./lower.ts";
-import { slugifyPath } from "./normalize.ts";
+import { slugify, slugifyPath } from "./normalize.ts";
 import type {
   ContentSource,
   SourceContext,
@@ -160,26 +161,43 @@ interface NotionFrontmatter {
   [key: string]: boolean | string | { order: number } | undefined;
 }
 
+/** Neighboring rich-text runs that link to one `href` (or none), and it. */
+interface LinkedRuns {
+  href?: string;
+  runs: InlineRun[];
+}
+
 /**
- * Rich text as Markdown for an MDX body. Each run goes through the shared
+ * Rich text as Markdown for an MDX body. The runs go through the shared
  * lowering, so a literal `{`, `<`, `*`, or `[` typed in Notion renders as
- * itself instead of opening a JSX expression, a tag, or emphasis, and a code
- * run keeps its text verbatim inside a long-enough code span.
+ * itself instead of opening a JSX expression, a tag, or emphasis, a code run
+ * keeps its text verbatim inside a long-enough code span, neighbors share
+ * their marks' delimiters, and neighbors that link to one `href` share one
+ * link.
  */
-const richToMarkdown = (rich: NotionRichText[] = []): string =>
-  rich
-    .map(({ annotations = {}, href, plain_text: text }) =>
-      renderLink(
-        renderInline(text, {
-          bold: annotations.bold,
-          code: annotations.code,
-          italic: annotations.italic,
-          strike: annotations.strikethrough,
-        }),
-        href ?? undefined
-      )
-    )
-    .join("");
+const richToMarkdown = (rich: NotionRichText[] = []): string => {
+  const linked: LinkedRuns[] = [];
+  for (const { annotations = {}, href, plain_text: text } of rich) {
+    const run: InlineRun = {
+      marks: {
+        bold: annotations.bold,
+        code: annotations.code,
+        italic: annotations.italic,
+        strike: annotations.strikethrough,
+      },
+      text,
+    };
+    const last = linked.at(-1);
+    if (last && last.href === (href ?? undefined)) {
+      last.runs.push(run);
+    } else {
+      linked.push({ href: href ?? undefined, runs: [run] });
+    }
+  }
+  return renderInline(
+    linked.flatMap(({ href, runs }) => linkParts(runs, href))
+  );
+};
 
 const isBlockPayload = (
   value: NotionBlockPayload | boolean | string | undefined
@@ -307,10 +325,14 @@ const renderVideo = (data: NotionBlockPayload): string => {
   const title = caption ? ` title=${jsxString(richToPlain(data.caption))}` : "";
   // Everything else (a Notion upload, or a direct link to a media file) is a
   // real video file: `materializeAssets` rewrites the `src`, which matters most
-  // for uploads, whose Notion URLs are signed and expire.
+  // for uploads, whose Notion URLs are signed and expire. It finds the file by
+  // that quoted `src`, where MDX decodes no backslash escapes — a JSON
+  // string's `\\` and `\"` would corrupt the URL or end the attribute — so the
+  // URL goes in as written, with a double quote as the `%22` it means anyway.
+  // The embed's `url` takes the expression form, like every string prop here.
   const media = isYouTubeUrl(url)
-    ? `<YouTube${title} url=${JSON.stringify(url)} />`
-    : `<video controls src=${JSON.stringify(url)} />`;
+    ? `<YouTube${title} url=${jsxString(url)} />`
+    : `<video controls src="${url.replaceAll('"', "%22")}" />`;
   return caption
     ? `<Frame caption=${jsxString(caption.replaceAll(FRAME_ESCAPED, ""))}>\n${media}\n</Frame>`
     : media;
@@ -577,9 +599,14 @@ export const notionSource = (
     const slugProp = richToPlain(
       page.properties[props.slug ?? "Slug"]?.rich_text
     );
-    // Path-aware: a `guides/setup` slug keeps its `/` (per-segment slugging)
-    // instead of mashing into `guidessetup`.
-    const slug = slugifyPath(slugProp || title) || page.id;
+    // A Slug property is path-aware: `guides/setup` keeps its `/` (per-segment
+    // slugging) instead of mashing into `guidessetup`. A title is one name, so
+    // its slashes become hyphens: "CI/CD Setup" routes to `ci-cd-setup`, not
+    // to `cd-setup` inside an invented `ci` group.
+    const slug =
+      (slugProp
+        ? slugifyPath(slugProp)
+        : slugify(title.replaceAll("/", "-"))) || page.id;
     return { data, slug };
   };
 

package/src/core/sources/obsidian.ts

@@ -21,6 +21,7 @@ import {
   resolveEntryRoute,
   slugifyPath,
   strippedLineOffset,
+  unloadablePathDiagnostic,
 } from "./normalize.ts";
 import type {
   ContentSource,
@@ -587,10 +588,11 @@ const transformBody = (
  * `[#custom-id]` pin and the `setup-1` a later collision gets are honored
  * rather than re-slugged. When no heading holds anything the rewrite changes,
  * the raw body's headings are the staged body's; otherwise the body is lowered
- * once more so the headings are scanned exactly as they ship. A link inside a
- * heading is rewritten here before the other notes' anchors are known, so its
- * own anchor is left off; that only moves the manifest id of a heading that
- * itself holds a heading link, which the docs already flag as unaddressable.
+ * once more so the headings are scanned exactly as they ship. A heading link
+ * inside a heading is rewritten here before every note's anchors are known,
+ * so its href may still lack the anchor it ships with. That moves no id: a
+ * heading is slugged by its rendered text, where the link is its label alone,
+ * so the heading stays as addressable as any other.
  */
 const fillAnchors = (pair: IndexedPair, index: LinkIndex): void => {
   const raw = extractHeadings(pair.note.content);
@@ -958,7 +960,19 @@ export const obsidianSource = (
   const exclude = new Set([...BLUME_IGNORE_DIRS, ...(options.exclude ?? [])]);
 
   const load = async (): Promise<SourceLoadResult> => {
-    const files = await walkVault(vaultDir, vaultDir, exclude);
+    // A note is staged under its vault path, where Astro's content loader
+    // can't read a name holding `#` or `?`; such a note is reported and left
+    // out, and links to it degrade like links to any missing note.
+    const skipped: Diagnostic[] = [];
+    const files: string[] = [];
+    for (const rel of await walkVault(vaultDir, vaultDir, exclude)) {
+      const unloadable = unloadablePathDiagnostic(rel, join(vaultDir, rel));
+      if (unloadable) {
+        skipped.push(unloadable);
+      } else {
+        files.push(rel);
+      }
+    }
     const read = await Promise.all(
       files.map((rel) => readNote(vaultDir, rel, options))
     );
@@ -971,7 +985,10 @@ export const obsidianSource = (
       noteToEntry(pair, index, options, unresolved)
     );
     return {
-      diagnostics: unresolvedDiagnostics(options.name, unresolved),
+      diagnostics: [
+        ...skipped,
+        ...unresolvedDiagnostics(options.name, unresolved),
+      ],
       entries,
     };
   };

package/src/core/sources/portable-text.ts

@@ -4,11 +4,12 @@
  * user-supplied serializer or are skipped with a noted comment. Output is
  * Markdown text that flows through Blume's normal pipeline.
  */
+import type { InlineRun } from "./lower.ts";
 import {
   guardBlockStart,
   image,
+  linkParts,
   renderInline,
-  renderLink,
   unsupported,
   writesMdx,
 } from "./lower.ts";
@@ -73,38 +74,54 @@ const HEADING_STYLES = new Map([
   ["h6", "###### "],
 ]);
 
-/**
- * A span as Markdown for its marks, through the shared lowering every CMS
- * uses: prose is escaped, a code span outruns the backticks inside it, edge
- * whitespace stays outside emphasis, and a link def wraps last (so its label
- * keeps emphasis) only when its destination is safe to click.
- */
-const renderSpan = (
-  span: PortableTextSpan,
-  defs: Map<string, PortableTextMarkDef>
-): string => {
+/** A span's text and the marks Markdown has syntax for. */
+const spanRun = (span: PortableTextSpan): InlineRun => {
   const marks = span.marks ?? [];
-  const link = marks
-    .map((mark) => defs.get(mark))
-    .findLast((def) => def?._type === "link");
-  return renderLink(
-    renderInline(span.text ?? "", {
+  return {
+    marks: {
       bold: marks.includes("strong"),
       code: marks.includes("code"),
       italic: marks.includes("em"),
       strike: marks.includes("strike-through"),
-    }),
-    link?.href
-  );
+    },
+    text: span.text ?? "",
+  };
 };
 
-/** Render the inline children of a block to a single Markdown string. */
+/** Neighboring spans under one link def (or none), and that def. */
+interface LinkedSpans {
+  link?: PortableTextMarkDef;
+  runs: InlineRun[];
+}
+
+/**
+ * Render the inline children of a block to a single Markdown string, through
+ * the shared lowering every CMS uses: prose is escaped, a code span outruns
+ * the backticks inside it, edge whitespace stays outside emphasis, neighbors
+ * share their marks' delimiters, and neighbors under one link def share one
+ * link — wrapped last (so its label keeps emphasis), and only when its
+ * destination is safe to click.
+ */
 const renderChildren = (block: PortableTextBlock): string => {
   const defs = new Map(
     (block.markDefs ?? []).map((def) => [def._key, def] as const)
   );
+  const linked: LinkedSpans[] = [];
+  for (const span of block.children ?? []) {
+    const link = (span.marks ?? [])
+      .map((mark) => defs.get(mark))
+      .findLast((def) => def?._type === "link");
+    const last = linked.at(-1);
+    if (last && last.link === link) {
+      last.runs.push(spanRun(span));
+    } else {
+      linked.push({ link, runs: [spanRun(span)] });
+    }
+  }
   return guardBlockStart(
-    (block.children ?? []).map((span) => renderSpan(span, defs)).join("")
+    renderInline(
+      linked.flatMap(({ link, runs }) => linkParts(runs, link?.href))
+    )
   );
 };
 

package/src/core/sources/read.ts

@@ -2,10 +2,14 @@ import { readFile } from "node:fs/promises";
 
 import { expandIncludes, hasIncludeStatements } from "../includes.ts";
 import type { PageRecord } from "../types.ts";
+import { substituteVariablesInBody } from "../variables.ts";
+import type { ContentVariables } from "../variables.ts";
 import type { ContentSource } from "./types.ts";
 
 /** The subset of a scanned project the entry reader needs. */
 export interface EntryReadContext {
+  /** The site's content variables, substituted into what's read. */
+  config?: { variables?: ContentVariables };
   /** The instantiated sources, keyed for `read()` lookups. */
   sources?: ContentSource[];
 }
@@ -48,9 +52,10 @@ export const readExpandedEntryText = async (
   ctx: EntryReadContext,
   page: PageRecord
 ): Promise<string> => {
+  const variables = ctx.config?.variables;
   const raw = await readEntryText(ctx, page);
   if (!(page.sourcePath && hasIncludeStatements(raw))) {
-    return raw;
+    return substituteVariablesInBody(raw, variables);
   }
   const source = ctx.sources?.find(
     (candidate) => candidate.name === page.source.name
@@ -61,11 +66,11 @@ export const readExpandedEntryText = async (
   // here would splice text the rest of the pipeline never validated, with no
   // content-root bound on resolution.
   if (!source || source.staged || !source.contentRoot) {
-    return raw;
+    return substituteVariablesInBody(raw, variables);
   }
   const expansion = await expandIncludes(raw, {
     contentRoot: source.contentRoot,
     sourcePath: page.sourcePath,
   });
-  return expansion.text;
+  return substituteVariablesInBody(expansion.text, variables);
 };

package/src/core/sources/strapi-blocks.ts

@@ -5,6 +5,7 @@
  */
 import type { JsonObject, JsonValue } from "./json.ts";
 import { asNumber, asObject, asString, objectsIn } from "./json.ts";
+import type { InlinePart } from "./lower.ts";
 import {
   absoluteUrl,
   blockquote,
@@ -12,10 +13,10 @@ import {
   guardBlockStart,
   headingPrefix,
   image,
+  linkParts,
   listItem,
   markdownDocument,
   renderInline,
-  renderLink,
   unsupported,
 } from "./lower.ts";
 
@@ -28,34 +29,37 @@ const children = (node: JsonObject): JsonObject[] => objectsIn(node.children);
 
 const typeOf = (node: JsonObject): string => asString(node.type) ?? "";
 
-const renderInlines = (nodes: JsonObject[]): string =>
-  nodes
-    // oxlint-disable-next-line no-use-before-define -- mutual recursion: a link's label is itself inline content
-    .map((node) => renderInlineNode(node))
-    .join("");
+const inlineParts = (nodes: JsonObject[]): InlinePart[] =>
+  // oxlint-disable-next-line no-use-before-define -- mutual recursion: a link's label is itself inline content
+  nodes.flatMap((node) => inlineNodeParts(node));
 
-const renderInlineNode = (node: JsonObject): string => {
+const inlineNodeParts = (node: JsonObject): InlinePart[] => {
   switch (typeOf(node)) {
     case "text": {
-      return renderInline(asString(node.text) ?? "", {
-        bold: node.bold === true,
-        code: node.code === true,
-        italic: node.italic === true,
-        strike: node.strikethrough === true,
-      });
+      return [
+        {
+          marks: {
+            bold: node.bold === true,
+            code: node.code === true,
+            italic: node.italic === true,
+            strike: node.strikethrough === true,
+          },
+          text: asString(node.text) ?? "",
+        },
+      ];
     }
     case "link": {
-      return renderLink(renderInlines(children(node)), asString(node.url));
+      return linkParts(inlineParts(children(node)), asString(node.url));
     }
     default: {
-      return renderInlines(children(node));
+      return inlineParts(children(node));
     }
   }
 };
 
 /** A text block's inline nodes, joined and guarded as one block. */
 const blockText = (nodes: JsonObject[]): string =>
-  guardBlockStart(renderInlines(nodes));
+  guardBlockStart(renderInline(inlineParts(nodes)));
 
 const renderList = (node: JsonObject): string => {
   const ordered = asString(node.format) === "ordered";

package/src/core/sources/watch.ts

@@ -51,18 +51,26 @@ export const baselineScanIgnore = (): string[] =>
  */
 export const BLUME_WATCH_IGNORE_DIRS = BLUME_IGNORE_DIRS;
 
-/** Extract single-segment ignore dirs (`foo`) from `foo/**`-style excludes. */
+/**
+ * Extract root-anchored ignore dirs (`/foo`) from `foo/**`-style excludes. The
+ * scan's glob `foo/**` matches `foo` at the source root only, so the watcher
+ * skips that one directory: a nested `guides/foo/` is still content, and an
+ * edit there must still reload.
+ */
 export const excludeDirSegments = (patterns: readonly string[]): string[] =>
   patterns
     .map((pattern) => /^(?<dir>[^*/]+)\/\*\*$/u.exec(pattern)?.groups?.dir)
-    .filter((dir): dir is string => dir !== undefined);
+    .filter((dir): dir is string => dir !== undefined)
+    .map((dir) => `/${dir}`);
 
 /**
  * Build a recursive-watch listener that fires `onChange` for content changes but
- * ignores events whose path crosses an ignored directory segment — one in
- * `ignoreDirs`, or one `ignoreSegment` rejects, for a scan whose skip rule is
- * a shape (every dot-name) rather than a list. A missing `filename` — rare;
- * the platform couldn't name the changed path — falls through to `onChange`
+ * ignores events whose path crosses an ignored directory — a segment named in
+ * `ignoreDirs` at any depth, or one `ignoreSegment` rejects, for a scan whose
+ * skip rule is a shape (every dot-name) rather than a list. An entry written
+ * with a leading slash (`/drafts`, see {@link excludeDirSegments}) names a
+ * directory at the watched root only. A missing `filename` — rare; the
+ * platform couldn't name the changed path — falls through to `onChange`
  * rather than silently dropping a real edit. Exported for testing.
  */
 export const ignoringWatchListener = (
@@ -76,7 +84,12 @@ export const ignoringWatchListener = (
       filename !== null &&
       filename
         .split(/[/\\]/u)
-        .some((segment) => ignore.has(segment) || ignoreSegment(segment))
+        .some(
+          (segment, index) =>
+            ignore.has(segment) ||
+            (index === 0 && ignore.has(`/${segment}`)) ||
+            ignoreSegment(segment)
+        )
     ) {
       return;
     }

package/src/core/standard-schema.ts

@@ -50,11 +50,15 @@ export interface StandardSchema<Input = unknown, Output = Input> {
  * Whether a config-supplied value implements the `~standard` contract. Generic
  * so it can decode any input at the config boundary (`z.custom` hands it the
  * raw config value) while narrowing whatever type the caller holds.
+ *
+ * The contract is the `~standard` property, whatever carries it: Zod and
+ * Valibot schemas are objects, but an ArkType type is a callable function. The
+ * optional-chained probe reads the property off either, and off `null`,
+ * `undefined`, or a primitive it finds nothing.
  */
 export const isStandardSchema = <T>(value: T): value is T & StandardSchema =>
-  typeof value === "object" &&
-  value !== null &&
-  // SAFETY: the assertion only widens the checked object for property probing;
-  // the trailing typeof check is what verifies `~standard.validate` exists.
-  typeof (value as { "~standard"?: { validate?: unknown } })["~standard"]
-    ?.validate === "function";
+  // SAFETY: the assertion only widens the value for property probing; the
+  // typeof check is what verifies `~standard.validate` exists.
+  typeof (
+    value as { "~standard"?: { validate?: unknown } } | null | undefined
+  )?.["~standard"]?.validate === "function";

package/src/core/types.ts

@@ -316,7 +316,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,11 +31,18 @@ export const ar: UIStringsOverride = {
     copy: "نسخ المحادثة",
     empty: "اطرح سؤالاً حول الوثائق.",
     error: "عذراً، حدث خطأ ما.",
+    explainCode: "اشرح هذه الشيفرة.",
     label: "اطرح سؤالاً",
+    open: "فتح المساعد",
     placeholder: "اطرح سؤالاً…",
+    rateLimited: "لقد طرحت الكثير من الأسئلة. حاول مرة أخرى بعد بضع دقائق.",
+    removeCode: "إزالة الشيفرة",
     send: "إرسال",
+    support: "تواصل مع الدعم",
+    supportSubject: "سؤال من التوثيق",
     tip: "نصيحة: يمكنك فتح المحادثة وإغلاقها باستخدام",
     title: "المساعد",
+    verifyFailed: "تعذّر التحقق من أنك إنسان. حاول مرة أخرى.",
     you: "أنت",
   },
   banner: { dismiss: "إغلاق الإعلان" },
@@ -42,6 +50,14 @@ export const ar: UIStringsOverride = {
     description: "تحديثات المنتج وملاحظات الإصدارات.",
     title: "سجل التغييرات",
   },
+  consent: {
+    accept: "قبول",
+    decline: "رفض",
+    label: "الموافقة على ملفات تعريف الارتباط",
+    message: "نودّ استخدام ملفات تعريف الارتباط لفهم كيفية استخدام هذا التوثيق.",
+    policy: "سياسة الخصوصية",
+    settings: "إعدادات ملفات تعريف الارتباط",
+  },
   content: {
     code: "الكود",
     copyColor: "نسخ اللون {name} {value}",
@@ -52,6 +68,8 @@ export const ar: UIStringsOverride = {
     preview: "معاينة",
     prop: "الخاصية",
     selectTab: "اختيار علامة تبويب",
+    selectView: "اختيار طريقة العرض",
+    showLess: "عرض أقل",
     showMore: "عرض المزيد",
     stars: "النجوم",
     tab: "علامة التبويب {n}",
@@ -59,12 +77,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 +131,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,11 +32,19 @@ export const bg: UIStringsOverride = {
     copy: "Копирай разговора",
     empty: "Задайте въпрос за документацията.",
     error: "Съжаляваме, нещо се обърка.",
+    explainCode: "Обясни този код.",
     label: "Задайте въпрос",
+    open: "Отваряне на асистента",
     placeholder: "Задайте въпрос…",
+    rateLimited:
+      "Зададохте много въпроси. Опитайте отново след няколко минути.",
+    removeCode: "Премахни кода",
     send: "Изпрати",
+    support: "Свържете се с поддръжката",
+    supportSubject: "Въпрос от документацията",
     tip: "Съвет: Можете да отваряте и затваряте чата с",
     title: "Асистент",
+    verifyFailed: "Не успяхме да потвърдим, че сте човек. Опитайте отново.",
     you: "Вие",
   },
   banner: { dismiss: "Затваряне на съобщението" },
@@ -43,6 +52,15 @@ export const bg: UIStringsOverride = {
     description: "Актуализации на продукта и бележки към изданията.",
     title: "Дневник на промените",
   },
+  consent: {
+    accept: "Приемам",
+    decline: "Отказвам",
+    label: "Съгласие за бисквитки",
+    message:
+      "Бихме искали да използваме бисквитки, за да разберем как се използва тази документация.",
+    policy: "Политика за поверителност",
+    settings: "Настройки за бисквитки",
+  },
   content: {
     code: "Код",
     copyColor: "Копирай цвета {name} {value}",
@@ -53,6 +71,8 @@ export const bg: UIStringsOverride = {
     preview: "Преглед",
     prop: "Свойство",
     selectTab: "Избери раздел",
+    selectView: "Избери изглед",
+    showLess: "Покажи по-малко",
     showMore: "Покажи още",
     stars: "Звезди",
     tab: "Раздел {n}",
@@ -60,12 +80,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 +134,7 @@ export const bg: UIStringsOverride = {
     next: "Напред",
     pagination: "Пагинация",
     previous: "Назад",
+    related: "Свързани страници",
     skipToContent: "Към съдържанието",
   },
   search: {