@alfacapital-tech/c4builder 0.9.0-rc.2 → 0.9.0-rc.3

package/README.MD

@@ -5,7 +5,7 @@
 **Architecture as code that an agent writes, checks and reads.**
 
 C4-Builder is a CLI that builds a folder of markdown files and [PlantUML](https://plantuml.com/),
-[D2](https://d2lang.com/) or [BPMN](https://www.bpmn.org/) diagrams into documentation: a [docsify](https://docsify.js.org/)
+[D2](https://d2lang.com/), [BPMN](https://www.bpmn.org/) or [Mermaid](https://mermaid.js.org/) diagrams into documentation: a [docsify](https://docsify.js.org/)
 site, a markdown file per folder, or a single file. Folders follow the
 [C4 model](https://c4model.com/) (system → container → component), and git keeps the history of
 architecture decisions next to the code.
@@ -19,7 +19,7 @@ than a hundred diagrams, so we continue it as a maintained fork, adapted to work
 - **Deterministic offline rendering.** The PlantUML jar, the diagram font and the engines ship
   with the package; layout is computed by PlantUML's built-in Smetana engine, no Graphviz. The
   same sources produce the same SVG on a laptop, in CI and in Docker, with no network access.
-- **`c4builder check`** validates individual `.puml`/`.iuml`/`.d2`/`.bpmn` files with the build's own
+- **`c4builder check`** validates individual `.puml`/`.iuml`/`.d2`/`.bpmn`/`.mmd` files with the build's own
   engine and returns an exit code and the error line — fast feedback for agents, pre-commit
   hooks and CI.
 - **Plugins.** `openspec` publishes an [OpenSpec](https://github.com/Fission-AI/OpenSpec) store
@@ -29,6 +29,8 @@ than a hundred diagrams, so we continue it as a maintained fork, adapted to work
   without a system Java, c4builder downloads a private JRE.
 - **BPMN** processes written as BPMN 2.0 XML without coordinates: the build validates the model
   and lays it out with horizontal pools and lanes.
+- **Mermaid** `.mmd` files and ```` ```mermaid ```` blocks are rendered at build time by real mermaid,
+  without a browser: images in every output instead of client-side rendering.
 - **Maintained.** TypeScript, golden rendering snapshots, CI on every pull request, releases to
   npm and GHCR. The PDF output of the original was removed.
 

package/dist/cli/commands/check.js

@@ -7,8 +7,9 @@ import { resolveJava } from "../../core/render/jre.js";
 import { renderDiagram } from "../../core/render/diagrams.js";
 import { renderD2, teardownD2 } from "../../core/render/d2renderer.js";
 import { BpmnError, renderBpmn, teardownBpmn } from "../../core/render/bpmnrenderer.js";
+import { MermaidError, renderMermaid, teardownMermaid } from "../../core/render/mermaidrenderer.js";
 // `c4builder check <file...>` — валидация отдельных диаграмм ТЕМ ЖЕ движком, что и
-// сборка (вендорный PlantUML jar + системная/managed java, бандл D2, конвейер BPMN), без проекта и
+// сборка (вендорный PlantUML jar + системная/managed java, бандл D2, конвейер BPMN, mermaid), без проекта и
 // `.c4builder`. Рендер идёт в память и выбрасывается: проверяем ровно то, что упало бы
 // в сборке (системный `plantuml` может отличаться версией). Код выхода 0 — все файлы ок,
 // 1 — есть ошибка (движка, неизвестного расширения или чтения файла).
@@ -64,11 +65,12 @@ const CHECKERS = {
     '.puml': checkPlantUml,
     '.iuml': checkPlantUml,
     '.d2': (abs) => renderD2(abs),
-    '.bpmn': async (abs) => renderBpmn(await readFile(abs, 'utf8'), path.relative(process.cwd(), abs))
+    '.bpmn': async (abs) => renderBpmn(await readFile(abs, 'utf8'), path.relative(process.cwd(), abs)),
+    '.mmd': async (abs) => renderMermaid(await readFile(abs, 'utf8'), path.relative(process.cwd(), abs))
 };
 export default async (files) => {
     if (files.length === 0) {
-        console.log(chalk.red('usage: c4builder check <file...>  (.puml | .iuml | .d2 | .bpmn)'));
+        console.log(chalk.red('usage: c4builder check <file...>  (.puml | .iuml | .d2 | .bpmn | .mmd)'));
         process.exit(1);
     }
     let failed = 0;
@@ -78,20 +80,21 @@ export default async (files) => {
         const check = CHECKERS[path.extname(abs).toLowerCase()];
         try {
             if (!check)
-                throw new Error('unsupported extension (expected .puml, .iuml, .d2 or .bpmn)');
+                throw new Error('unsupported extension (expected .puml, .iuml, .d2, .bpmn or .mmd)');
             await check(abs);
             console.log(chalk.green(`✓ ${file}`));
         }
         catch (e) {
             failed++;
-            // BPMN: по строке на нарушение — агент правит их по id элемента.
-            const problems = e instanceof BpmnError ? e.problems : [e.message];
+            // BPMN: по строке на нарушение — агент правит их по id элемента; mermaid — `line N: …`.
+            const problems = e instanceof BpmnError || e instanceof MermaidError ? e.problems : [e.message];
             for (const p of problems)
                 console.error(chalk.red(`✗ ${file}: ${p}`));
         }
     }
     await teardownD2();
     await teardownBpmn();
+    await teardownMermaid();
     if (failed)
         process.exit(1);
 };

package/dist/cli/commands/site.comments.js

@@ -1,3 +1,4 @@
+import { UI_STRINGS } from "./site.i18n.js";
 export const COMMENTS_PATH = '/__c4builder/comments';
 export const FEEDBACK_PATH = '/__c4builder/feedback';
 export const FEEDBACK_HEADER = 'X-C4builder-Feedback';
@@ -10,6 +11,9 @@ const CSS = [
     '.c4b-cpop textarea,.c4b-review textarea{width:100%;box-sizing:border-box;min-height:70px;padding:6px;border:1px solid #ccc;border-radius:4px;font:13px/1.4 sans-serif;resize:vertical}',
     '.c4b-cpop .c4b-row{display:flex;justify-content:space-between;align-items:center;gap:8px;margin-top:8px}',
     '.c4b-cpop small{color:#888;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+    // Кнопки поповера не сжимаются: длинную подсказку обрезает многоточие, а не кнопки уходят
+    // на вторую строку (русские подписи и длинные названия разделов).
+    '.c4b-cpop .c4b-row>span{flex:none}',
     '.c4b-cpop button,.c4b-review button{padding:4px 12px;border:1px solid #ccc;border-radius:4px;background:#fff;color:#2c3e50;cursor:pointer;font:13px sans-serif}',
     '.c4b-cpop button.c4b-primary,.c4b-review button.c4b-primary{border-color:#42b983;background:#42b983;color:#fff}',
     '.c4b-cpop button:disabled,.c4b-review button:disabled{opacity:.6;cursor:default}',
@@ -18,6 +22,9 @@ const CSS = [
     '.c4b-review{position:fixed;left:50%;bottom:16px;transform:translateX(-50%);z-index:1000;width:520px;max-width:calc(100vw - 32px);box-sizing:border-box;padding:8px 12px;border:1px solid #3b82f6;border-radius:6px;background:#fff;color:#2c3e50;font:13px/1.4 sans-serif;box-shadow:0 2px 8px rgba(0,0,0,.2)}',
     '.c4b-review .c4b-row{display:flex;flex-wrap:wrap;align-items:center;gap:6px}',
     '.c4b-review .c4b-row small{flex:1;color:#888;white-space:nowrap}',
+    // Кнопки панели переносятся одной группой: иначе при нехватке места часть уезжает на
+    // вторую строку, а Discard остаётся один в первой.
+    '.c4b-review .c4b-acts{display:flex;gap:6px;margin-left:auto}',
     '.c4b-review button.c4b-link{padding:0;border:0;background:none;color:#2c3e50;font-weight:700;text-decoration:underline dotted}',
     '.c4b-review ul{margin:6px 0;padding:0;list-style:none;max-height:40vh;overflow:auto}',
     '.c4b-review li{padding:3px 0;border-top:1px solid #eee;overflow-wrap:anywhere}',
@@ -36,27 +43,47 @@ const CSS = [
     '.c4b-del:hover{color:#fff;background:#c0392b;border-color:#c0392b}',
     '.c4b-del:disabled{opacity:.5;cursor:default}'
 ].join('');
-const jsString = (s) => JSON.stringify(s)
+const jsValue = (v) => JSON.stringify(v)
     .replace(/</g, '\\u003c')
     .replace(/[\u0080-￿]/g, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
 // Начальное состояние агентского режима и ключ проекта вставляет сервер, дальше его обновляют
 // события `c4builder:agent` от сниппета livereload (change site-agent-feedback, design D4, D8).
-export const commentsSnippet = (heading, { agent = false, listening = false, project = '' } = {}) => `
+// Язык выбирает сам скрипт: при `auto` — по navigator.languages (change site-ui-language, D1).
+export const commentsSnippet = (heading, { agent = false, listening = false, project = '', language = 'auto' } = {}) => `
 <script>
 (function () {
     if (window.__c4builderComments) return;
     window.__c4builderComments = true;
     var ENDPOINT = '${COMMENTS_PATH}';
     var FEEDBACK = '${FEEDBACK_PATH}';
-    var HEADING = ${jsString(heading)};
+    var HEADING = ${jsValue(heading)};
     var TOAST_KEY = '__c4builderCommentToast';
-    var DRAFT_KEY = '__c4builderReview:' + ${jsString(project)};
+    var DRAFT_KEY = '__c4builderReview:' + ${jsValue(project)};
     var AGENT = { on: ${agent}, listening: ${listening} };
     var BLOCKS = 'p,li,td,th,h1,h2,h3,h4,h5,h6,pre,blockquote,dd,dt,div,section,details,summary';
     var style = document.createElement('style');
-    style.textContent = ${jsString(CSS)};
+    style.textContent = ${jsValue(CSS)};
     document.head.appendChild(style);
 
+    var STRINGS = ${jsValue(UI_STRINGS)};
+    var has = function (lang) { return Object.prototype.hasOwnProperty.call(STRINGS, lang); };
+    var LANG = (function (pref) {
+        if (has(pref)) return pref;
+        var prefs = [].concat(navigator.languages || [], navigator.language || []);
+        for (var i = 0; i < prefs.length; i++) {
+            var tag = String(prefs[i]).toLowerCase().split('-')[0];
+            if (has(tag)) return tag;
+        }
+        return 'en';
+    })(${jsValue(language)});
+    var plural = new Intl.PluralRules(LANG);
+    var t = function (key, vars) {
+        vars = vars || {};
+        var s = STRINGS[LANG][key];
+        if (typeof s === 'object') s = s[plural.select(vars.n)];
+        return s.replace(/\\{(\\w+)\\}/g, function (m, k) { return k in vars ? String(vars[k]) : m; });
+    };
+
     var collapse = function (s) { return String(s).replace(/\\s+/g, ' ').trim(); };
     var same = function (a, b) { return collapse(a).toLowerCase() === collapse(b).toLowerCase(); };
 
@@ -203,18 +230,18 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
             del.type = 'button';
             del.className = 'c4b-del';
             del.textContent = '\\u00d7';
-            del.title = 'Remove this question';
+            del.title = t('removeQuestion');
             del.addEventListener('click', function (e) {
                 e.preventDefault();
                 e.stopPropagation();
                 del.disabled = true;
                 send({ page: pageFile(), number: Number(item.number) || null, text: collapse(item.text) }, 'DELETE').then(function (r) {
-                    var msg = 'Removed from ' + r.file;
+                    var msg = t('removed', { file: r.file });
                     try { sessionStorage.setItem(TOAST_KEY, msg); } catch (e) {}
                     toast(msg);
                 }, function (err) {
                     del.disabled = false;
-                    toast('Remove failed: ' + (err && err.message ? err.message : err), true);
+                    failure('removeFailed')(err);
                 });
             });
             item.cell.appendChild(del);
@@ -272,10 +299,10 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
     var btns = document.createElement('div');
     btns.className = 'c4b-cbtns';
     btns.hidden = true;
-    var fbBtn = button('Feedback', null, 'c4b-fb');
-    fbBtn.title = 'Tell the agent what to change';
-    var qBtn = button('Question');
-    qBtn.title = 'Add a question to the ' + HEADING + ' section of the source file';
+    var fbBtn = button(t('feedback'), null, 'c4b-fb');
+    fbBtn.title = t('feedbackTitle');
+    var qBtn = button(t('question'));
+    qBtn.title = t('questionTitle', { heading: HEADING });
     btns.appendChild(fbBtn);
     btns.appendChild(qBtn);
     document.body.appendChild(btns);
@@ -347,8 +374,8 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
             });
         });
     };
-    var failure = function (what) {
-        return function (err) { toast(what + ' failed: ' + (err && err.message ? err.message : err), true); };
+    var failure = function (key) {
+        return function (err) { toast(t(key, { error: err && err.message ? err.message : err }), true); };
     };
 
     // Feedback to the agent: "Delivered" only after the server handed the batch to
@@ -356,15 +383,15 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
     var delivered = {}, pending = {};
     var sendBatch = function (decision, comments, general) {
         return send({ decision: decision, comments: comments, general: general }, 'POST', FEEDBACK).then(function (r) {
-            if (delivered[r.id]) return toast('Delivered to the agent');
+            if (delivered[r.id]) return toast(t('delivered'));
             pending[r.id] = true;
-            toast(r.queued ? 'Queued \\u2014 agent is not listening' : 'Sent to the agent');
+            toast(t(r.queued ? 'queued' : 'sent'));
         });
     };
     window.addEventListener('c4builder:delivered', function (e) {
         var id = e.detail && e.detail.id;
         delivered[id] = true;
-        if (pending[id]) { delete pending[id]; toast('Delivered to the agent'); }
+        if (pending[id]) { delete pending[id]; toast(t('delivered')); }
     });
 
     // Review draft lives in localStorage per project: it survives livereload and a closed tab;
@@ -411,7 +438,7 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
     listen.className = 'c4b-listen';
     var list = document.createElement('ul');
     var general = document.createElement('textarea');
-    general.placeholder = 'Overall comment (optional, Ctrl+Enter to submit, Esc to hide)';
+    general.placeholder = t('generalPlaceholder');
     general.hidden = true;
     var finish = function (decision) {
         var items = draft(), ids = items.map(function (it) { return it.id; });
@@ -422,18 +449,18 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
             general.hidden = true;
             expanded = false;
             saveDraft(draft().filter(function (it) { return ids.indexOf(it.id) < 0; }));
-        }, failure('Review')).then(function () { busy = false; renderPanel(); });
+        }, failure('reviewFailed')).then(function () { busy = false; renderPanel(); });
     };
-    var discard = button('Discard', function () {
+    var discard = button(t('discard'), function () {
         var n = draft().length;
-        if (n && !window.confirm('Discard ' + n + ' pending comment' + (n === 1 ? '' : 's') + '?')) return;
+        if (n && !window.confirm(t('discardConfirm', { n: n }))) return;
         general.value = '';
         general.hidden = true;
         saveDraft([]);
     });
-    var approve = button('Approve', function () { finish('approved'); });
-    approve.title = 'Tell the agent there is nothing more to change (pending comments go along)';
-    var submit = button('Submit review', function () {
+    // One finishing action, two labels: on an empty draft "Approve" does not read as "finish".
+    var approve = button('', function () { finish('approved'); });
+    var submit = button(t('submitReview'), function () {
         if (!general.hidden) return finish('submitted');
         general.hidden = false;
         general.focus();
@@ -444,20 +471,23 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
     });
     var head = document.createElement('div');
     head.className = 'c4b-row';
-    [count, listen, discard, approve, submit].forEach(function (el) { head.appendChild(el); });
+    var acts = document.createElement('span');
+    acts.className = 'c4b-acts';
+    [discard, approve, submit].forEach(function (el) { acts.appendChild(el); });
+    [count, listen, acts].forEach(function (el) { head.appendChild(el); });
     panel.appendChild(head);
     panel.appendChild(list);
     panel.appendChild(general);
     document.body.appendChild(panel);
     var renderPanel = function () {
         panel.hidden = !AGENT.on;
-        var items = draft(), pages = {};
+        var items = draft(), pages = {}, empty = !items.length;
         items.forEach(function (it) { pages[it.page] = true; });
         var n = Object.keys(pages).length;
-        count.textContent = items.length
-            ? 'Review: ' + items.length + ' pending (' + n + (n === 1 ? ' page)' : ' pages)')
-            : 'Review: nothing pending';
-        count.disabled = !items.length;
+        count.textContent = empty
+            ? t('reviewEmpty')
+            : t('reviewCount', { comments: t('comments', { n: items.length }), pages: t('pages', { n: n }) });
+        count.disabled = empty;
         list.textContent = '';
         items.forEach(function (it) {
             var li = document.createElement('li');
@@ -466,19 +496,23 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
             var del = button('\\u00d7', function () {
                 saveDraft(draft().filter(function (x) { return x.id !== it.id; }));
             }, 'c4b-del');
-            del.title = 'Remove from the review';
+            del.title = t('removeFromReview');
             li.appendChild(del);
             list.appendChild(li);
         });
-        list.hidden = !expanded || !items.length;
+        list.hidden = !expanded || empty;
+        approve.textContent = t(empty ? 'done' : 'approve');
+        approve.title = t(empty ? 'doneTitle' : 'approveTitle');
+        approve.className = empty ? 'c4b-primary' : '';
+        discard.hidden = submit.hidden = empty;
         discard.disabled = busy;
         approve.disabled = busy;
-        submit.disabled = busy || !items.length;
+        submit.disabled = busy || empty;
     };
     var renderAgent = function () {
         fbBtn.hidden = !AGENT.on;
         renderPanel();
-        var text = 'agent: ' + (AGENT.listening ? 'listening \\u25cf' : 'not listening \\u25cb');
+        var text = t(AGENT.listening ? 'listening' : 'notListening');
         var els = document.querySelectorAll('.c4b-listen');
         for (var i = 0; i < els.length; i++) { els[i].textContent = text; els[i].title = text; }
     };
@@ -503,14 +537,14 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
         var quote = document.createElement('blockquote');
         quote.textContent = data.quote;
         var ta = document.createElement('textarea');
-        ta.placeholder = (feedback ? 'What should the agent change?' : 'Your question') + ' (Ctrl+Enter to send, Esc to cancel)';
+        ta.placeholder = t(feedback ? 'feedbackPlaceholder' : 'questionPlaceholder');
         var row = document.createElement('div');
         row.className = 'c4b-row';
         var hint = document.createElement('small');
         if (feedback) hint.className = 'c4b-listen';
-        else hint.textContent = hint.title = 'To: ' + HEADING + (data.section ? ' / ' + data.section : '');
+        else hint.textContent = hint.title = t('questionTo', { target: HEADING + (data.section ? ' / ' + data.section : '') });
         var actions = document.createElement('span');
-        var buttons = [button('Cancel', close)];
+        var buttons = [button(t('cancel'), close)];
         var run = function (action) {
             return function () {
                 var comment = ta.value.trim();
@@ -518,7 +552,7 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
                 buttons.forEach(function (b) { b.disabled = true; });
                 action(comment).then(close, function (err) {
                     buttons.forEach(function (b) { b.disabled = false; });
-                    failure(feedback ? 'Feedback' : 'Question')(err);
+                    failure(feedback ? 'feedbackFailed' : 'questionFailed')(err);
                 });
             };
         };
@@ -527,20 +561,20 @@ export const commentsSnippet = (heading, { agent = false, listening = false, pro
         };
         var primary;
         if (feedback) {
-            var add = button('Add to review', run(function (c) {
+            var add = button(t('addToReview'), run(function (c) {
                 var it = item(c);
                 it.id = Date.now().toString(36) + Math.random().toString(36).slice(2, 6);
                 saveDraft(draft().concat([it]));
                 return Promise.resolve();
             }));
-            var now = button('Send now', run(function (c) { return sendBatch('submitted', [item(c)], ''); }));
+            var now = button(t('sendNow'), run(function (c) { return sendBatch('submitted', [item(c)], ''); }));
             buttons.push(add, now);
             // As in a GitLab merge request: once a review is started, comments go into it.
             primary = draft().length ? add : now;
         } else {
-            primary = button('Add question', run(function (c) {
+            primary = button(t('addQuestion'), run(function (c) {
                 return send(item(c)).then(function (r) {
-                    var msg = 'Added to ' + r.file + (r.number ? ' as #' + r.number : '');
+                    var msg = t(r.number ? 'addedNumber' : 'added', { file: r.file, number: r.number });
                     try { sessionStorage.setItem(TOAST_KEY, msg); } catch (e) {}
                     toast(msg);
                 });

package/dist/cli/commands/site.i18n.js

@@ -0,0 +1,88 @@
+// Словарь интерфейса страницы `site -w` (change site-ui-language). Единственный файл `src/`, где
+// тест cli-language разрешает кириллицу: это текст страницы в браузере, а не вывод CLI. Наборы
+// ключей en и ru совпадают (проверяет тот же тест). `{name}` подставляет скрипт страницы; строка
+// с числом — объект форм для Intl.PluralRules, число в ней — `{n}`.
+export const UI_STRINGS = {
+    en: {
+        feedback: 'Feedback',
+        feedbackTitle: 'Tell the agent what to change',
+        question: 'Question',
+        questionTitle: 'Add a question to the {heading} section of the source file',
+        removeQuestion: 'Remove this question',
+        removed: 'Removed from {file}',
+        added: 'Added to {file}',
+        addedNumber: 'Added to {file} as #{number}',
+        sent: 'Sent to the agent',
+        delivered: 'Delivered to the agent',
+        queued: 'Queued — agent is not listening',
+        reviewFailed: 'Review failed: {error}',
+        feedbackFailed: 'Feedback failed: {error}',
+        questionFailed: 'Question failed: {error}',
+        removeFailed: 'Remove failed: {error}',
+        generalPlaceholder: 'Overall comment (optional, Ctrl+Enter to submit, Esc to hide)',
+        discard: 'Discard',
+        discardConfirm: { one: 'Discard {n} pending comment?', other: 'Discard {n} pending comments?' },
+        approve: 'Approve',
+        approveTitle: 'Tell the agent there is nothing more to change (pending comments go along)',
+        done: 'Done — no changes',
+        doneTitle: 'Tell the agent there is nothing to change',
+        submitReview: 'Submit review',
+        reviewEmpty: 'Review: nothing pending',
+        reviewCount: 'Review: {comments} ({pages})',
+        comments: { one: '{n} pending', other: '{n} pending' },
+        pages: { one: '{n} page', other: '{n} pages' },
+        removeFromReview: 'Remove from the review',
+        listening: 'agent: listening ●',
+        notListening: 'agent: not listening ○',
+        feedbackPlaceholder: 'What should the agent change? (Ctrl+Enter to send, Esc to cancel)',
+        questionPlaceholder: 'Your question (Ctrl+Enter to send, Esc to cancel)',
+        questionTo: 'To: {target}',
+        cancel: 'Cancel',
+        addToReview: 'Add to review',
+        sendNow: 'Send now',
+        addQuestion: 'Add question'
+    },
+    ru: {
+        feedback: 'Замечание',
+        feedbackTitle: 'Сказать агенту, что изменить',
+        question: 'Вопрос',
+        questionTitle: 'Добавить вопрос в раздел «{heading}» исходного файла',
+        removeQuestion: 'Удалить вопрос',
+        removed: 'Удалено из {file}',
+        added: 'Добавлено в {file}',
+        addedNumber: 'Добавлено в {file} под номером {number}',
+        sent: 'Отправлено агенту',
+        delivered: 'Доставлено агенту',
+        queued: 'В очереди: агент не слушает',
+        reviewFailed: 'Не удалось отправить ревью: {error}',
+        feedbackFailed: 'Не удалось отправить замечание: {error}',
+        questionFailed: 'Не удалось добавить вопрос: {error}',
+        removeFailed: 'Не удалось удалить вопрос: {error}',
+        generalPlaceholder: 'Общий комментарий (необязательно; Ctrl+Enter — отправить, Esc — скрыть)',
+        discard: 'Очистить',
+        discardConfirm: {
+            one: 'Удалить из ревью {n} замечание?',
+            few: 'Удалить из ревью {n} замечания?',
+            many: 'Удалить из ревью {n} замечаний?'
+        },
+        approve: 'Одобрить',
+        approveTitle: 'Сообщить агенту, что правок больше нет (замечания из ревью уйдут вместе с этим)',
+        done: 'Готово, правок нет',
+        doneTitle: 'Сообщить агенту, что правок нет',
+        submitReview: 'Отправить ревью',
+        reviewEmpty: 'Ревью: замечаний нет',
+        reviewCount: 'Ревью: {comments} {pages}',
+        comments: { one: '{n} замечание', few: '{n} замечания', many: '{n} замечаний' },
+        pages: { one: 'на {n} странице', few: 'на {n} страницах', many: 'на {n} страницах' },
+        removeFromReview: 'Убрать из ревью',
+        listening: 'агент: слушает ●',
+        notListening: 'агент: не слушает ○',
+        feedbackPlaceholder: 'Что должен изменить агент? (Ctrl+Enter — отправить, Esc — отмена)',
+        questionPlaceholder: 'Ваш вопрос (Ctrl+Enter — отправить, Esc — отмена)',
+        questionTo: 'Куда: {target}',
+        cancel: 'Отмена',
+        addToReview: 'В ревью',
+        sendNow: 'Отправить',
+        addQuestion: 'Добавить вопрос'
+    }
+};

package/dist/cli/commands/site.js

@@ -154,7 +154,8 @@ pages = () => new Map()) => {
                 commentsSnippet(currentConfiguration.QUESTIONS_HEADING, {
                     agent: agent.on,
                     listening,
-                    project: projectKey
+                    project: projectKey,
+                    language: currentConfiguration.UI_LANGUAGE
                 }) +
                 (next ? updateBanner(next) : '');
             if (html.includes('</body>'))

package/dist/cli/dispatch.js

@@ -25,6 +25,7 @@ import { acquireBuildLock, BuildLockHeldError, waitBuildLock } from "../util/loc
 // больше не будет (одиночный запуск).
 import { teardownD2 } from "../core/render/d2renderer.js";
 import { teardownBpmn } from "../core/render/bpmnrenderer.js";
+import { teardownMermaid } from "../core/render/mermaidrenderer.js";
 import { packageJson as pkg } from "../util/paths.js";
 import { outputDirs, parseConfig } from "../config/options.js";
 import { isValidPort } from "../config/schema.js";
@@ -105,6 +106,7 @@ function getOptions(c) {
         EXCLUDE_OTHER_FILES: c.excludeOtherFiles,
         USE_SYSTEM_FONTS: c.useSystemFonts,
         QUESTIONS_HEADING: c.questionsHeading,
+        UI_LANGUAGE: c.uiLanguage,
         PLUGINS: c.plugins
     };
 }
@@ -352,6 +354,7 @@ export default async () => {
             if (!opts.watch) {
                 await teardownD2();
                 await teardownBpmn();
+                await teardownMermaid();
             }
         }
         isBuilding = false;

package/dist/config/defaults.js

@@ -32,6 +32,7 @@ const defaultConfig = {
     d2Layout: 'dagre',
     charset: 'UTF-8',
     useSystemFonts: false,
-    questionsHeading: 'Open questions'
+    questionsHeading: 'Open questions',
+    uiLanguage: 'auto'
 };
 export { defaultConfig };

package/dist/config/schema.js

@@ -60,6 +60,8 @@ export const configSchema = z.object({
     // Заголовок раздела, куда `site -w` дописывает комментарии к странице (в коде кириллицы
     // быть не может — русский заголовок задаёт сам проект).
     questionsHeading: str(defaultConfig.questionsHeading),
+    // Язык интерфейса страницы `site -w`; `auto` — по языку браузера (change site-ui-language).
+    uiLanguage: z.preprocess(strPre, z.enum(['auto', 'en', 'ru'], 'expected auto, en or ru').default(defaultConfig.uiLanguage)),
     // Задаются явно (флаг/промпт) либо тонкой правкой файла — в defaultConfig не входят.
     projectName: optStr(),
     webFileName: optStr(),

package/dist/core/compose/markdown.js

@@ -223,7 +223,7 @@ export const generateLlmsTxt = (tree, options) => {
     });
     return (`# ${options.PROJECT_NAME}\n\n` +
         '> Architecture documentation built with c4builder. Pages are markdown; full text with ' +
-        'diagram sources (PlantUML/D2/BPMN): [llms-full.txt](llms-full.txt).\n\n' +
+        'diagram sources (PlantUML/D2/BPMN/Mermaid): [llms-full.txt](llms-full.txt).\n\n' +
         `## Pages\n\n${pages.join('')}`);
 };
 // Fence длиннее самой длинной серии обратных кавычек текста — иначе блок закрылся бы изнутри.
@@ -235,7 +235,8 @@ const FENCE_LANG = {
     '.puml': 'plantuml',
     '.iuml': 'plantuml',
     '.d2': 'd2',
-    '.bpmn': 'xml'
+    '.bpmn': 'xml',
+    '.mmd': 'mermaid'
 };
 // llms-full.txt: состав complete-документа, но диаграмма — исходником (C4-PlantUML/D2-текст
 // агенту полезнее SVG). Локальные include/импорты — один раз в приложении, а не инлайном:

package/dist/core/render/bpmnrenderer.js

@@ -10,7 +10,7 @@ import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import chalk from 'chalk';
 import { DEFAULT_FONT_NAME } from "./fonts.js";
-import { getResvg, resvgFontOptions } from "./pngraster.js";
+import { ASCENT, DESCENT, clearTextWidths, textWidth } from "./textmetrics.js";
 // Третий бэкенд рендера: BPMN 2.0 XML без координат → валидация (bpmnlint) → раскладка
 // (bpmn-auto-layout) → рендер bpmn-js в jsdom → SVG. Все пакеты — optionalDependencies,
 // грузятся лениво при первом .bpmn: проекты без BPMN их не трогают (как D2).
@@ -112,32 +112,7 @@ const C4BUILDER_RULES = {
     })
 };
 // Ширины строк для переноса подписей: diagram-js меряет текст только через
-// canvas.measureText, а jsdom канваса не умеет. Меряем вендорный Nimbus Sans тем же
-// resvg, что растрирует PNG: ширина = bbox «|текст|» минус bbox «||» — так получается
-// advance-ширина с пробелами по краям, а не ширина чернил. Режим системных шрифтов на
-// BPMN не влияет (как и на D2): детерминизм важнее.
-const widthMemo = new Map();
-const escapeXml = (s) => s.replace(/[&<>]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;' })[c]);
-const inkWidth = (text, size) => {
-    const { Resvg } = getResvg();
-    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1"><text y="${size}" ` +
-        `font-family="${DEFAULT_FONT_NAME}" font-size="${size}" xml:space="preserve">${escapeXml(text)}</text></svg>`;
-    return new Resvg(svg, { font: resvgFontOptions(false) }).getBBox()?.width ?? 0;
-};
-const textWidth = (text, size) => {
-    const key = `${size}\0${text}`;
-    let width = widthMemo.get(key);
-    if (width === undefined) {
-        // Округление гасит f32-шум resvg между платформами: координаты текста в SVG
-        // считаются из этой ширины и должны совпадать побайтно.
-        width = Math.round((inkWidth(`|${text}|`, size) - inkWidth('||', size)) * 100) / 100;
-        widthMemo.set(key, width);
-    }
-    return width;
-};
-// hhea Nimbus Sans Regular: ascender 729, descender −271 на 1000 единиц (vendor/fonts).
-const ASCENT = 0.729;
-const DESCENT = 0.271;
+// canvas.measureText, а jsdom канваса не умеет — меряем вендорный шрифт (textmetrics).
 // Полифилы окна jsdom: ровно то, что bpmn-js зовёт при импорте и saveSVG. Трансформации
 // пишутся в атрибут сразу — сериализатор берёт атрибуты, а не baseVal.
 const installPolyfills = (window) => {
@@ -334,7 +309,7 @@ export const teardownBpmn = async () => {
         return;
     const pending = enginePromise;
     enginePromise = null;
-    widthMemo.clear();
+    clearTextWidths();
     try {
         (await pending).window.close();
     }