@ozdao/scriptorium 0.0.0-stage → 0.1.0

package/src/content/markdown.js

@@ -0,0 +1,182 @@
+// Рендер markdown страницы документации в HTML — один для loader'а страниц
+// (markdown.loader.js) и индекса поиска (search-index.loader.js): текст в поиске
+// и на странице обязан совпадать, вплоть до якорей заголовков.
+//
+// markdown-it и подсветка shiki — по одному экземпляру на процесс: highlighter
+// грузит грамматики и темы асинхронно и дорого, создавать его на каждый файл
+// нельзя. Языки кода догружаются по мере появления в документах.
+import fs from 'node:fs';
+import path from 'node:path';
+import matter from 'gray-matter';
+import MarkdownIt from 'markdown-it';
+import anchor from 'markdown-it-anchor';
+import container from 'markdown-it-container';
+import { createHighlighter, bundledLanguages } from 'shiki';
+
+import { pageUrl } from './scan.js';
+
+const code_themes = { light: 'github-light', dark: 'github-dark' };
+
+// Подписи блоков по умолчанию — как у VitePress; своя подпись пишется после имени: ::: tip Совет
+const block_titles = {
+  tip: 'TIP',
+  warning: 'WARNING',
+  danger: 'DANGER',
+  info: 'INFO',
+  details: 'Details',
+};
+
+// Якорь заголовка — тот же, что строит VitePress (@mdit-vue/shared): ссылки
+// вида #заголовок, написанные под старый сайт, продолжают вести куда вели.
+const control_characters = /[\u0000-\u001f]/g;
+const special_characters = /[\s~`!@#$%^&*()\-_+=[\]{}|\\;:"'“”‘’<>,.?/]+/g;
+const combining_marks = /[̀-ͯ]/g;
+
+function slugify(text) {
+  return text
+    .normalize('NFKD')
+    .replace(combining_marks, '')
+    .replace(control_characters, '')
+    .replace(special_characters, '-')
+    .replace(/-{2,}/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .replace(/^(\d)/, '_$1')
+    .toLowerCase();
+}
+
+function escapeHtml(text) {
+  return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+
+let highlighter_promise = null;
+
+function getHighlighter() {
+  highlighter_promise ??= createHighlighter({ themes: Object.values(code_themes), langs: [] });
+  return highlighter_promise;
+}
+
+// Язык блока кода: первое слово info-строки ('js {1,3}' → 'js'). Неизвестный
+// shiki язык красится как текст, а не роняет сборку.
+function fenceLanguage(info) {
+  const name = (info || '').trim().split(/\s+/)[0].toLowerCase();
+  return name in bundledLanguages ? name : 'text';
+}
+
+let markdown = null;
+
+function getMarkdown(highlighter) {
+  if (markdown) return markdown;
+
+  markdown = new MarkdownIt({
+    html: true,
+    linkify: true,
+    highlight: (code, info) => highlighter.codeToHtml(code, {
+      lang: fenceLanguage(info),
+      themes: code_themes,
+      defaultColor: false,
+    }),
+  });
+
+  markdown.use(anchor, {
+    level: [2, 3, 4, 5, 6],
+    slugify,
+    permalink: anchor.permalink.linkInsideHeader({
+      symbol: '#',
+      placement: 'before',
+      class: 'header-anchor',
+    }),
+  });
+
+  for (const name of ['tip', 'warning', 'danger', 'info']) {
+    markdown.use(container, name, {
+      render(tokens, index) {
+        const token = tokens[index];
+        if (token.nesting !== 1) return '</div>\n';
+        const title = token.info.trim().slice(name.length).trim() || block_titles[name];
+        return `<div class="${name} custom-block"><p class="custom-block-title">${escapeHtml(title)}</p>\n`;
+      },
+    });
+  }
+
+  markdown.use(container, 'details', {
+    render(tokens, index) {
+      const token = tokens[index];
+      if (token.nesting !== 1) return '</details>\n';
+      const title = token.info.trim().slice('details'.length).trim() || block_titles.details;
+      return `<details class="details custom-block"><summary>${escapeHtml(title)}</summary>\n`;
+    },
+  });
+
+  // Таблицы — блоком .table дизайн-системы martyrs.
+  markdown.renderer.rules.table_open = (tokens, index, options, env, self) => {
+    tokens[index].attrJoin('class', 'table');
+    return self.renderToken(tokens, index, options);
+  };
+
+  // Ссылки: на .md страницы сайта → адрес страницы; внешние — в новой вкладке.
+  // Ссылка на .md в пропущенной папке (шаблоны, ../marketing) страницей не
+  // является и остаётся как есть; на несуществующий файл — предупреждение сборки.
+  markdown.renderer.rules.link_open = (tokens, index, options, env, self) => {
+    const token = tokens[index];
+    const href = token.attrGet('href');
+
+    if (href && /^(https?:)?\/\//i.test(href)) {
+      token.attrSet('target', '_blank');
+      token.attrSet('rel', 'noreferrer');
+    } else if (href && !/^[a-z][a-z0-9+.-]*:/i.test(href)) {
+      const clean = href.replace(/[?#].*$/, '');
+      if (clean.endsWith('.md')) {
+        const decoded = safeDecode(clean);
+        const target = decoded.startsWith('/')
+          ? path.posix.normalize(decoded.slice(1))
+          : path.posix.normalize(path.posix.join(path.posix.dirname(env.file), decoded));
+
+        if (env.page_files.has(target)) {
+          token.attrSet('href', encodeURI(pageUrl(target)) + href.slice(clean.length));
+        } else if (!fs.existsSync(path.join(env.docs_root, target))) {
+          env.warnings.push(`битая ссылка "${href}": файла ${target} нет`);
+        }
+      }
+    }
+
+    return self.renderToken(tokens, index, options);
+  };
+
+  return markdown;
+}
+
+export function safeDecode(value) {
+  try {
+    return decodeURI(value);
+  } catch {
+    return value;
+  }
+}
+
+// Файл документации → frontmatter, токены markdown-it и HTML.
+//   source     — текст файла;
+//   file       — путь относительно корня репозитория (для ссылок и сообщений);
+//   page_files — Set путей всех страниц сайта: ссылки на .md → адреса страниц.
+// warnings — предупреждения сборки (битые ссылки); выводит их вызывающий.
+export async function renderMarkdown({ source, file, docs_root, page_files }) {
+  let parsed;
+  try {
+    parsed = matter(source);
+  } catch (error) {
+    throw new Error(`[scriptorium] битый frontmatter в ${path.join(docs_root, file)}: ${error.message}`);
+  }
+
+  const highlighter = await getHighlighter();
+  const md = getMarkdown(highlighter);
+
+  const env = { docs_root, file, page_files, warnings: [] };
+  const tokens = md.parse(parsed.content, env);
+
+  const languages = new Set(tokens.filter((token) => token.type === 'fence').map((token) => fenceLanguage(token.info)));
+  const missing = [...languages].filter((name) => name !== 'text' && !highlighter.getLoadedLanguages().includes(name));
+  if (missing.length) await highlighter.loadLanguage(...missing);
+
+  const html = md.renderer.render(tokens, md.options, env);
+
+  return { frontmatter: parsed.data, tokens, html, warnings: env.warnings };
+}

package/src/content/markdown.loader.js

@@ -0,0 +1,95 @@
+// Rspack-loader для .md: страница документации → JS-модуль
+//   export const frontmatter — данные frontmatter (PageMeta потребителя)
+//   export const title       — первый h1 (заголовок вкладки)
+//   export const headers     — заголовки для оглавления [{ level, title, slug }]
+//   export default           — Vue-компонент с готовым HTML
+//
+// Сам рендер markdown (markdown-it, подсветка shiki, ссылки на страницы) — в
+// markdown.js: его же зовёт индекс поиска (search-index.loader.js).
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { config_file, docs_root, listMarkdown, loadSiteConfig } from './scan.js';
+import { renderMarkdown, safeDecode } from './markdown.js';
+
+// Текст заголовка без разметки: так его видит читатель и так он встаёт в оглавление.
+function inlineText(token) {
+  return (token.children || [])
+    .filter((child) => child.type === 'text' || child.type === 'code_inline')
+    .map((child) => child.content)
+    .join('')
+    .trim();
+}
+
+// Относительные картинки → import: rspack кладёт файл в сборку (asset/resource)
+// и подставляет его адрес. HTML режется на куски, между ними — переменные импортов.
+function splitImages(html, md_dir, warnings) {
+  const imports = [];
+  const parts = [];
+  const image_source = /(<img\b[^>]*?\ssrc=")([^"]+)(")/gi;
+  let last_index = 0;
+
+  for (const match of html.matchAll(image_source)) {
+    const source = match[2];
+    if (/^([a-z][a-z0-9+.-]*:|\/|#)/i.test(source)) continue;
+
+    const file = path.resolve(md_dir, safeDecode(source.replace(/&amp;/g, '&')).replace(/[?#].*$/, ''));
+    if (!fs.existsSync(file)) {
+      warnings.push(`картинка "${source}" не найдена: ${file}`);
+      continue;
+    }
+
+    const start = match.index + match[1].length;
+    parts.push(JSON.stringify(html.slice(last_index, start)));
+    parts.push(`image_${imports.length}`);
+    imports.push(`import image_${imports.length} from ${JSON.stringify(file)};`);
+    last_index = start + source.length;
+  }
+
+  parts.push(JSON.stringify(html.slice(last_index)));
+  return { imports, html_code: parts.join(' + ') };
+}
+
+export default function markdownLoader(source) {
+  const callback = this.async();
+  const md_file = this.resourcePath;
+
+  (async () => {
+    const config = await loadSiteConfig();
+    this.addDependency(config_file);
+
+    const file = path.relative(docs_root, md_file).split(path.sep).join('/');
+    const { frontmatter, tokens, html, warnings } = await renderMarkdown({
+      source,
+      file,
+      docs_root,
+      page_files: new Set(listMarkdown(docs_root, config)),
+    });
+
+    const [level_from, level_to] = config.outline.level;
+    const headers = [];
+    let title = null;
+
+    tokens.forEach((token, index) => {
+      if (token.type !== 'heading_open') return;
+      const level = Number(token.tag.slice(1));
+      const text = inlineText(tokens[index + 1]);
+      if (level === 1 && title === null) title = text;
+      const slug = token.attrGet('id');
+      if (slug && level >= level_from && level <= level_to) headers.push({ level, title: text, slug });
+    });
+
+    const { imports, html_code } = splitImages(html, path.dirname(md_file), warnings);
+
+    for (const warning of warnings) this.emitWarning(new Error(`[scriptorium] ${file}: ${warning}`));
+
+    return `import { h } from 'vue';
+${imports.join('\n')}
+export const frontmatter = ${JSON.stringify(frontmatter)};
+export const title = ${JSON.stringify(title)};
+export const headers = ${JSON.stringify(headers)};
+const html = ${html_code};
+export default { name: 'DocPage', render() { return h('div', { class: 'doc', innerHTML: html }); } };
+`;
+  })().then((code) => callback(null, code), (error) => callback(error));
+}

package/src/content/pages.js

@@ -0,0 +1,5 @@
+// Список страниц сайта. Содержимое модуля целиком генерирует pages.loader.js при
+// сборке (правило в bin/scriptorium.js): скан папок документации →
+//   export const pages = [{ url, file, title, frontmatter, load }]
+// Код ниже — только на случай, если файл импортирован мимо сборки.
+export const pages = [];

package/src/content/pages.loader.js

@@ -0,0 +1,33 @@
+// Rspack-loader модуля pages.js: сканирует репозиторий документации и отдаёт
+// список страниц с ленивой загрузкой каждой ('@docs/<файл>.md' → чанк страницы).
+//
+// Зависимости для пересборки списка:
+//  - контекст корня репозитория — добавление и удаление .md;
+//  - каждый .md — правка frontmatter меняет подпись в сайдбаре;
+//  - config.js — skipped_names и прочее меняют состав страниц.
+import path from 'node:path';
+
+import { config_file, docs_root, loadSiteConfig, scanPages } from './scan.js';
+
+export default function pagesLoader() {
+  const callback = this.async();
+
+  (async () => {
+    const config = await loadSiteConfig();
+    const pages = scanPages(docs_root, config);
+
+    this.addContextDependency(docs_root);
+    this.addDependency(config_file);
+    for (const page of pages) this.addDependency(path.join(docs_root, page.file));
+
+    const entries = pages.map((page) => `  {
+    url: ${JSON.stringify(page.url)},
+    file: ${JSON.stringify(page.file)},
+    title: ${JSON.stringify(page.title)},
+    frontmatter: ${JSON.stringify(page.frontmatter)},
+    load: () => import(${JSON.stringify(`@docs/${page.file}`)}),
+  }`);
+
+    return `export const pages = [\n${entries.join(',\n')}\n];\n`;
+  })().then((code) => callback(null, code), (error) => callback(error));
+}

package/src/content/scan.js

@@ -0,0 +1,101 @@
+// Обход репозитория документации: какие .md становятся страницами и по каким
+// адресам. Работает в node (loader'ы сборки), в бандл сайта не попадает.
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import matter from 'gray-matter';
+
+import { resolveSiteConfig } from './site-config.js';
+
+// CLI запускается из папки documentation/ (как vitepress из папки сайта): она же
+// корень приложения martyrs — package.json, node_modules, config.js, theme/,
+// public/, builds/. Корень репозитория с .md — папка над ней. cwd общий на
+// процесс: его видят и loader'ы сборки, и server.js в dev-воркере.
+export const docs_dir = process.cwd();
+export const docs_root = path.resolve(docs_dir, '..');
+export const config_file = path.join(docs_dir, 'config.js');
+
+// Папки, которых на сайте нет никогда, что бы ни стояло в конфиге: зависимости
+// и папка самого сайта (конфиг и тема, как .vitepress у VitePress).
+const always_skipped_names = ['node_modules'];
+const always_skipped_paths = [path.relative(docs_root, docs_dir).split(path.sep).join('/')];
+
+// Конфиг читается заново при каждой правке файла: query с mtime обходит кэш
+// ESM-модулей node, иначе правка skipped_names не доехала бы до сборки.
+export async function loadSiteConfig() {
+  let stat;
+  try {
+    stat = fs.statSync(config_file);
+  } catch {
+    throw new Error(`[scriptorium] нет ${config_file} — конфиг сайта обязателен`);
+  }
+  const module = await import(`${pathToFileURL(config_file).href}?t=${stat.mtimeMs}`);
+  return resolveSiteConfig(module.default);
+}
+
+// путь файла относительно корня репозитория → путь страницы: AGENTS.md становится индексом своей папки
+export function pagePath(file) {
+  return file.replace(/(^|\/)AGENTS\.md$/, '$1index.md');
+}
+
+// путь файла относительно корня репозитория → адрес страницы на сайте: без .md, AGENTS.md папки — адрес папки со слешем
+export function pageUrl(file) {
+  return '/' + pagePath(file).replace(/index\.md$/, '').replace(/\.md$/, '');
+}
+
+// все .md, из которых строятся страницы, пути относительно корня репозитория с разделителем '/'.
+// Скрытые папки (.git, .claude, .codex) пропускаются; skipped_names — на любой глубине,
+// skipped_paths — пути от корня.
+export function listMarkdown(docs_root, config) {
+  const skipped_names = [...always_skipped_names, ...config.skipped_names];
+  const skipped_paths = [...always_skipped_paths, ...config.skipped_paths];
+
+  const walk = (dir, prefix) => {
+    const files = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      if (entry.isDirectory()) {
+        if (entry.name.startsWith('.') || skipped_names.includes(entry.name) || skipped_paths.includes(prefix + entry.name)) continue;
+        files.push(...walk(path.join(dir, entry.name), prefix + entry.name + '/'));
+      } else if (entry.isFile() && entry.name.endsWith('.md')) {
+        files.push(prefix + entry.name);
+      }
+    }
+    return files;
+  };
+
+  return walk(docs_root, '');
+}
+
+// Страницы сайта: файл, адрес, подпись в сайдбаре (frontmatter.title, иначе имя
+// файла) и frontmatter. Два файла на один адрес (AGENTS.md и index.md одной
+// папки) — ошибка: какая из страниц настоящая, решает автор, а не порядок обхода.
+export function scanPages(docs_root, config) {
+  const pages = [];
+  const file_of_url = new Map();
+
+  for (const file of listMarkdown(docs_root, config)) {
+    const url = pageUrl(file);
+    if (file_of_url.has(url)) {
+      throw new Error(`[scriptorium] два файла на один адрес ${url}: ${file_of_url.get(url)} и ${file} — оставь один`);
+    }
+    file_of_url.set(url, file);
+
+    let frontmatter;
+    try {
+      frontmatter = matter(fs.readFileSync(path.join(docs_root, file), 'utf-8')).data;
+    } catch (error) {
+      throw new Error(`[scriptorium] битый frontmatter в ${file}: ${error.message}`);
+    }
+
+    pages.push({
+      file,
+      url,
+      title: frontmatter.title !== undefined && frontmatter.title !== null && frontmatter.title !== ''
+        ? String(frontmatter.title)
+        : path.posix.basename(file, '.md'),
+      frontmatter,
+    });
+  }
+
+  return pages;
+}

package/src/content/search-index.js

@@ -0,0 +1,7 @@
+// Индекс поиска по документации — JSON-строка MiniSearch. Содержимое модуля
+// целиком генерирует search-index.loader.js при клиентской сборке (правило в
+// bin/scriptorium.js): export default '<JSON индекса>'. Клиент грузит модуль лениво
+// (import() в SearchBox.vue) отдельным чанком.
+// Код ниже — для render-бандла сервера, где правила нет: поиск открывается
+// только в браузере, и индекс в SSR-бандл не попадает.
+export default '';

package/src/content/search-index.loader.js

@@ -0,0 +1,144 @@
+// Rspack-loader модуля search-index.js: индекс локального поиска по всем
+// страницам сайта — порт localSearchPlugin VitePress 1.6.4.
+//
+// Страница рендерится тем же renderMarkdown, что и сама страница, HTML режется
+// на секции по заголовкам h1–h6. Секция — документ индекса:
+//   id     — адрес страницы + '#якорь' (h1 и текст до первого заголовка — адрес страницы без якоря);
+//   title  — текст заголовка секции;
+//   titles — заголовки-предки (крошки в результатах);
+//   text   — текст секции без разметки.
+// Модуль отдаёт JSON индекса строкой: export default '<JSON>'.
+//
+// Зависимости для пересборки: контекст корня репозитория (новые и удалённые .md),
+// каждый .md (правка текста) и config.js (состав страниц).
+import fs from 'node:fs';
+import path from 'node:path';
+import MiniSearch from 'minisearch';
+
+import { config_file, docs_root, loadSiteConfig, scanPages } from './scan.js';
+import { renderMarkdown } from './markdown.js';
+import { search_options } from './search-options.js';
+
+const heading_pattern = /<h([1-6])\b([^>]*)>([\s\S]*?)<\/h\1>/gi;
+const id_pattern = /\bid="([^"]*)"/i;
+// Значок '#' внутри заголовка (markdown-it-anchor, linkInsideHeader) — не часть текста заголовка.
+const header_anchor_pattern = /<a\b[^>]*\bclass="header-anchor"[^>]*>[\s\S]*?<\/a>/gi;
+
+const named_entities = { amp: '&', lt: '<', gt: '>', quot: '"', apos: "'", nbsp: ' ' };
+
+function decodeEntities(text) {
+  return text.replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (entity, name) => {
+    if (name[0] !== '#') return named_entities[name.toLowerCase()] ?? entity;
+    const code = name[1] === 'x' || name[1] === 'X' ? parseInt(name.slice(2), 16) : parseInt(name.slice(1), 10);
+    return Number.isNaN(code) ? entity : String.fromCodePoint(code);
+  });
+}
+
+// HTML → текст, как его читает человек: без тегов, с раскрытыми сущностями,
+// пробельные последовательности (переносы строк кода, отступы) — одним пробелом.
+function plainText(html) {
+  return decodeEntities(html.replace(/<[^>]*>/g, ' ')).replace(/\s+/g, ' ').trim();
+}
+
+// HTML страницы → секции { level, anchor, title, text } в порядке документа.
+// Заголовок без якоря (h2–h6 из сырого HTML) секцию не открывает — его текст
+// остаётся в тексте текущей секции, как у VitePress. h1 якоря не имеет
+// (markdown-it-anchor ставит якоря h2–h6) и открывает секцию верха страницы.
+// Текст до первого заголовка — секция уровня 0.
+function splitSections(html) {
+  const sections = [];
+  let current = { level: 0, anchor: '', title: '' };
+  let last_index = 0;
+
+  for (const match of html.matchAll(heading_pattern)) {
+    const level = Number(match[1]);
+    const anchor = decodeEntities(match[2].match(id_pattern)?.[1] ?? '');
+    if (!anchor && level !== 1) continue;
+
+    sections.push({ ...current, text: plainText(html.slice(last_index, match.index)) });
+    current = { level, anchor, title: plainText(match[3].replace(header_anchor_pattern, '')) };
+    last_index = match.index + match[0].length;
+  }
+
+  sections.push({ ...current, text: plainText(html.slice(last_index)) });
+  return sections;
+}
+
+// Секции страницы → документы индекса. Цепочка предков — как splitPageIntoSections
+// VitePress: заголовок уровня N заменяет N-й элемент цепочки и отрезает глубже.
+// Документы с одним id (второй h1, текст до h1) сливаются: MiniSearch требует
+// уникальный id, а ведут они в одно место — верх страницы.
+function pageDocuments(page, html) {
+  const documents = new Map();
+  let parent_titles = [];
+
+  for (const section of splitSections(html)) {
+    let title = section.title;
+    let titles = [];
+
+    if (section.level === 0) {
+      if (!section.text) continue;
+      // Текст до первого заголовка — под подписью страницы из сайдбара.
+      title = page.title;
+    } else {
+      if (!title) continue;
+      const depth = section.level - 1;
+      titles = parent_titles.slice(0, depth);
+      titles[depth] = title;
+      titles = titles.filter(Boolean).slice(0, -1);
+
+      if (depth === 0) parent_titles = [title];
+      else parent_titles[depth] = title;
+    }
+
+    const id = section.anchor ? `${page.url}#${section.anchor}` : page.url;
+    const existing = documents.get(id);
+    if (existing) {
+      existing.text = [existing.text, section.text].filter(Boolean).join(' ');
+      continue;
+    }
+    documents.set(id, { id, title, titles, text: section.text });
+  }
+
+  return [...documents.values()];
+}
+
+// Индекс всего сайта. Страница с frontmatter search: false в индекс не идёт — как у VitePress.
+// Отдельной функцией, чтобы индекс можно было собрать и проверить из node без rspack.
+export async function buildSearchIndex(docs_root, config) {
+  const pages = scanPages(docs_root, config);
+  const page_files = new Set(pages.map((page) => page.file));
+  const index = new MiniSearch(search_options);
+
+  const documents = await Promise.all(pages.map(async (page) => {
+    const source = fs.readFileSync(path.join(docs_root, page.file), 'utf-8');
+    const { frontmatter, html } = await renderMarkdown({ source, file: page.file, docs_root, page_files });
+    if (frontmatter.search === false) return [];
+    return pageDocuments(page, html);
+  }));
+
+  index.addAll(documents.flat());
+  return { index, pages };
+}
+
+export default function searchIndexLoader() {
+  const callback = this.async();
+
+  (async () => {
+    // Корень и конфиг — до сборки: если она упадёт на битом файле, правка
+    // файла всё равно перезапустит loader.
+    this.addContextDependency(docs_root);
+    this.addDependency(config_file);
+
+    const config = await loadSiteConfig();
+    const { index, pages } = await buildSearchIndex(docs_root, config);
+
+    for (const page of pages) this.addDependency(path.join(docs_root, page.file));
+
+    // В dev модуль принимает своё обновление сам: правка .md не перезагружает
+    // страницу, новый индекс SearchBox берёт следующим import().
+    return `export default ${JSON.stringify(JSON.stringify(index))};
+if (import.meta.webpackHot) import.meta.webpackHot.accept();
+`;
+  })().then((code) => callback(null, code), (error) => callback(error));
+}

package/src/content/search-options.js

@@ -0,0 +1,16 @@
+// Опции MiniSearch — те же, что у локального поиска VitePress. Один объект на
+// сборку индекса (search-index.loader.js, node) и его загрузку в браузере
+// (SearchBox.vue): MiniSearch.loadJSON требует те же поля, что были при сборке.
+//
+// Токенизатор — по умолчанию MiniSearch 7: режет по пробелам и пунктуации
+// Юникода (/[\n\r\p{Z}\p{P}]+/u) и приводит к нижнему регистру, кириллицу
+// режет верно — своя функция не нужна.
+export const search_options = {
+  fields: ['title', 'titles', 'text'],
+  storeFields: ['title', 'titles'],
+  searchOptions: {
+    fuzzy: 0.2,
+    prefix: true,
+    boost: { title: 4, text: 2, titles: 1 },
+  },
+};