@vernikr/size-report 1.3.0 → 2.0.0

package/src/css.js

@@ -5,31 +5,22 @@ import fs from 'node:fs';
  * редактор, а не только шаблонная строка. Читаются они с диска относительно
  * своего места, поэтому работают и у того, кто поставил пакет.
  *
- * Наборов три, и у каждого своя роль:
+ * Наборов два, и у каждого своя роль:
  *
- *   1. `table.css` — **общая часть таблицы**: геометрия клеток, липкие шапка и
- *      колонка коммита, подпись коммита, цвета дельт. Её берут оба вывода, поэтому
- *      расхождению в оформлении самой таблицы взяться неоткуда. Файл — дословный
- *      текст этой части, без шапки: он попадает в артефакт побайтово, а артефакт
- *      заморожен эталоном паритета, и любая добавленная строка меняла бы
- *      зафиксированный вывод проекта-потребителя.
- *   2. `artifact.css` — оформление статического артефакта **сверх таблицы**: холст,
- *      заголовок, примечание.
- *   3. `page/app.css` — оформление страницы **сверх таблицы**: холст, панель
+ *   1. `table.css` — **таблица**: геометрия клеток, липкие шапка и колонка коммита,
+ *      подпись коммита, цвета дельт.
+ *   2. `page/app.css` — оформление страницы **сверх таблицы**: холст, панель
  *      выбора, легенда, состояния пустоты и адаптации под узкое окно.
  *
  * Соглашение о цвете дельт задано один раз — в `table.css`: `.up` зелёный, `.down`
- * красный (рост — «больше логики», а не тревога). Артефакт заморожен побайтово, и
- * менять его цвета нельзя, не пересняв эталон; страница следует тому же
- * соглашению, потому что два отчёта одной истории не могут показывать рост
- * разными цветами. Смена соглашения — две строки в `table.css` и пересъёмка
- * эталона артефакта; отдельного места у цвета дельт нет намеренно.
+ * красный (рост — «больше логики», а не тревога). Второго места у него нет
+ * намеренно: рост не может быть показан разными цветами в двух местах одной
+ * страницы. Смена соглашения — две строки в `table.css`.
  *
  * Путь у `readCss` — от каталога `src/`: так его видит движок, где бы он ни лежал.
  */
 
 export const TABLE_CSS = readCss('./table.css');
-export const ARTIFACT_CSS = readCss('./artifact.css');
 export const PAGE_CSS = readCss('./page/app.css');
 
 function readCss(name) {

package/src/hook.js

@@ -15,10 +15,15 @@ import { rebuild } from './artifact.js';
  *
  * Что он делает и почему именно так:
  *
- * - **Ставится только явной командой** (`install-hook`) и снимается
- *   (`uninstall-hook`): установка — это правка чужого `.git`, и делать её вслепую
- *   нельзя. До установки проект не меняется ничем, после снятия — возвращается к
- *   прежнему поведению.
+ * - **Ставится сам** — после установки пакета (`bin/postinstall.js`) и при первом
+ *   запуске в проекте (`autoInstall`, зовётся из входа): от человека не требуется
+ *   ни ручного шага, ни файла настроек, иначе первого обновления отчёта он не
+ *   увидел бы вовсе. Ставится там, где это безопасно (обычный `.git/hooks`, нет
+ *   чужого хука, есть чем звать инструмент, не CI); где небезопасно — молчит.
+ *   Снимается явной командой (`uninstall-hook`), и проект возвращается к прежнему
+ *   поведению: и поставленное, и снятое — одно и то же место состояния (`git-dir`).
+ *   Ручная команда (`install-hook`) остаётся: она называет причину, когда поставить
+ *   не удалось, а тихая постановка причин не объясняет.
  * - **Сам коммитов не создаёт** — за одним исключением: отчёт, лежащий в git,
  *   коммитится отдельно от кода. Раньше это делал человек (отсюда ловушка «правка
  *   кода и таблицы в одном коммите»), и хук для того и нужен, чтобы ручного шага не
@@ -185,6 +190,7 @@ export function installHook(root, cfg) {
     return { code: EXIT.OK, lines: [
       '· хук уже установлен: ' + rels.join(', '),
       '  автоматика работает после каждого коммита и слияния',
+      '  выключить, не снимая: «"hooks": {"enabled": false}» в файле настроек',
       '  снять: ' + cliCommand('uninstall-hook')
     ] };
   }
@@ -208,6 +214,38 @@ export function installHook(root, cfg) {
   return { code: EXIT.OK, lines: lines };
 }
 
+/* Постановка без спроса. Отвечает списком путей, если поставила, и `null`, если не
+ * тронула ничего, — второй ответ не ошибка, а норма: эта услуга фоновая, и там, где
+ * она не к месту, её просто нет. Поэтому всё, что мешает поставить, решается
+ * молчанием, а не отказом: отказ от фоновой работы после каждого запуска был бы
+ * шумом, а причина уже названа точной командой (`install-hook`).
+ *
+ * Чужой `core.hooksPath` сюда же: этот каталог версионируется и часто лежит в
+ * другом репозитории — вписывать строку в чужой файл по своей воле нельзя, и
+ * человек берёт её у `install-hook` (готовую и без метки). */
+export function autoInstall(root, cfg) {
+  if (process.env.CI || process.env[NO_HOOK]) return null;
+  if (cfg !== null && cfg.hooks.enabled === false) return null;
+  try {
+    const hooks = hooksDir(root);
+    const entry = hookEntry(root);
+    if (hooks.custom || entry === null) return null;
+    const files = HOOKS.map((name) => path.join(hooks.dir, name));
+    if (files.some((f) => fs.existsSync(f) && !isOurs(f))) return null;
+    if (files.every(isOurs)) return null;
+    fs.mkdirSync(hooks.dir, { recursive: true });
+    files.forEach((file) => {
+      fs.writeFileSync(file, script(entry));
+      fs.chmodSync(file, 0o755);
+    });
+    return files.map((f) => path.relative(root, f));
+  } catch (_e) {
+    /* Не git-репозиторий, нет прав на `.git`, чужой формат — всё это значит одно:
+     * автоматики здесь не будет, а работа инструмента от неё не зависит. */
+    return null;
+  }
+}
+
 /* Снятие: убирается только то, что поставили мы. Файл не «похож на наш», а помечен
  * меткой, иначе чужой хук был бы стёрт молча. */
 export function uninstallHook(root) {

package/src/locales.js

@@ -12,14 +12,15 @@ export const LOCALES = {
     total: 'Общий объём',
     now: 'сейчас',
     categories: { code: 'Код', docs: 'Документация', chore: 'Служебные', assets: 'Ресурсы' },
-    /* Тексты страницы отчёта: в артефакт они не попадают, поэтому меняются
-     * независимо от его заморожённых байтов. */
+    /* Тексты страницы отчёта. Они лежат в самом файле отчёта (отдельным словарём,
+     * рядом с данными), поэтому меняются вместе с ним — и правка слова стоит
+     * пересборки отчёта, иначе файл разойдётся с историей. */
     page: {
       metrics: 'Метрики',
       files: 'Файлы',
       dir: 'все файлы папки {name} ({n})',
       all: 'все',
-      sub: '{tool} {version} · рядом со страницей — статическая таблица: {artifact}',
+      sub: '{tool} {version} · {artifact}',
       legendUp: 'рост',
       legendDown: 'спад',
       legendSame: 'пустая клетка — не менялось',
@@ -75,7 +76,7 @@ export const LOCALES = {
       files: 'Files',
       dir: 'all files in “{name}” ({n})',
       all: 'all',
-      sub: '{tool} {version} · a static table sits next to this page: {artifact}',
+      sub: '{tool} {version} · {artifact}',
       legendUp: 'growth',
       legendDown: 'fall',
       legendSame: 'an empty cell — no change',

package/src/modes.js

@@ -9,11 +9,9 @@ import { coverage, coverageText } from './check.js';
 import { explainCommit, explainText } from './explain.js';
 import { doctor, doctorText } from './doctor.js';
 import { hookRun, installHook, uninstallHook } from './hook.js';
-import { rebuild, writeFileEnsured } from './artifact.js';
+import { artifact, rebuild } from './artifact.js';
 import { sensorGaps } from './metrics.js';
-import { render } from './render.js';
 import { totalsOf } from './derived.js';
-import { pageHtml } from './page/build.js';
 
 /* Режимы: что инструмент делает по запросу. Разбор аргументов — в `src/args.js`, а
  * сюда приходит готовый план: какой режим, какой ключ, что печатать. Здесь же их
@@ -21,10 +19,10 @@ import { pageHtml } from './page/build.js';
  * на все режимы, потому что один и тот же счёт и один и тот же знак не должны
  * разойтись между `--write`, `--data`, `--page` и `size check`.
  *
- * Что где: сборка и сверка таблицы (`--write`, проверка), данные и страница
- * (`--data`, `--page`), полнота покрытия (`size check`), диагностика (`doctor`),
- * хук и объяснение пропущенной строки. Файл знает про все остальные модули сразу —
- * это его работа: связать их в одну команду.
+ * Что где: сборка и сверка отчёта (`--write`, проверка), данные контракта
+ * (`--data`), полнота покрытия (`size check`), диагностика (`doctor`), хук и
+ * объяснение пропущенной строки. Файл знает про все остальные модули сразу — это
+ * его работа: связать их в одну команду.
  */
 
 function kmb(bytes) {
@@ -81,23 +79,31 @@ export function check(cfg, want, root) {
   return 1;
 }
 
-export function writeMode(cfg, root) {
-  const { rows, dropped, state, html } = rebuild(cfg, root);
-  console.log('✓ ' + cfg.output + ': ' + rows.length + ' строк × ' + cfg.columns.length + ' файлов, '
-    + kmb(byteLen(html)) + ' (пропущено без строки: ' + dropped.length + ' — '
-    + dropped.map(skipLine).join(', ') + ')');
-  console.log('  состояние на HEAD: ' + cfg.columns.map((c, i) => c.label + ' '
-    + (state[i] === null ? '—' : cfg.metrics.map((m) => state[i].cells[m]).join('/'))).join(', '));
+/* Путь, названный ключом (`--write <файл>`), — это настройка `output` этого
+ * запуска: отчёт обязан называть себя тем путём, по которому лежит, иначе подпись в
+ * нём указывала бы на чужое место. */
+function withOutput(cfg, root, file) {
+  if (typeof file !== 'string') return cfg;
+  return Object.assign({}, cfg, { output: path.relative(root, path.resolve(file)) });
+}
+
+export function writeMode(cfg, root, file) {
+  const out = rebuild(withOutput(cfg, root, file), root);
+  const { rows, files, now, skipped } = out.data;
+  console.log('✓ ' + path.relative(root, out.file) + ': ' + rows.length + ' строк × ' + files.length + ' файлов, '
+    + kmb(byteLen(out.html)) + ' (пропущено без строки: ' + skipped.length + ' — '
+    + skipped.join(', ') + ')');
+  console.log('  состояние на HEAD: ' + files.map((f, i) => f.label + ' '
+    + (now[i] === null ? '—' : cfg.metrics.map((m) => now[i][m]).join('/'))).join(', '));
   return sensorNote(cfg);
 }
 
 export function checkMode(cfg, root) {
-  const { rows } = build(cfg, root);
-  const html = render(rows, cfg);
-  const code = check(cfg, html, root);
+  const out = artifact(cfg, root);
+  const code = check(cfg, out.html, root);
   if (code === 0) {
-    console.log('✓ таблица размеров: ' + rows.length + ' коммитов × ' + cfg.columns.length + ' файлов '
-      + 'совпадает с историей (' + cfg.output + ', ' + kmb(byteLen(html)) + ')');
+    console.log('✓ отчёт: ' + out.data.rows.length + ' коммитов × ' + out.data.files.length + ' файлов '
+      + 'совпадает с историей (' + cfg.output + ', ' + kmb(byteLen(out.html)) + ')');
   }
   return verdict(code, sensorGaps(cfg));
 }
@@ -162,21 +168,6 @@ export function dataMode(cfg, root) {
   return sensorNote(cfg);
 }
 
-/* Страница отчёта: собирается тем же проходом по истории, что и артефакт — иначе
- * два отчёта могли бы показывать разные числа. Файл кладётся рядом с таблицей,
- * потому что он из неё и растёт. */
-const PAGE_NAME = 'size-report.html';
-
-export function pageMode(cfg, root, file) {
-  const data = reportData(cfg, root);
-  const target = file ? path.resolve(file) : path.join(root, path.dirname(cfg.output), PAGE_NAME);
-  const html = pageHtml(data, cfg);
-  writeFileEnsured(target, html);
-  console.log('✓ ' + path.relative(root, target) + ': ' + data.rows.length + ' строк × '
-    + data.files.length + ' файлов, ' + kmb(byteLen(html)));
-  return sensorNote(cfg);
-}
-
 export function jsonMode(cfg, root) {
   const { rows, dropped } = build(cfg, root);
   process.stdout.write(JSON.stringify({

package/src/page/app.css

@@ -154,6 +154,36 @@ h1 { margin: 0 0 3px; font-size: 21px; font-weight: 650; letter-spacing: -.012em
  * сдвигает разметку. Ссылки журнала и все переключатели доступны с Tab. */
 :focus-visible { outline: 2px solid AccentColor; outline-offset: 2px; border-radius: 3px; }
 
+/* Широкая страница: панель выбора (метрики, дерево файлов, легенда) стоит **слева**
+ * от таблицы. Это не украшение: на десктопе бокового места много, а вертикального
+ * мало — переключатели и числа видны одновременно, и прокрутка страницы не уводит
+ * управление за экран. Узкое окно эту же раскладку снимает (ниже): там столбцы
+ * снова идут друг под другом, потому что рядом им не хватает ширины.
+ *
+ * Раскладка — сетка на `body`, а не обёртка в разметке: страница собирается
+ * вклейкой глав (`src/page/build.js`), и добавлять ей узлы ради оформления значило
+ * бы менять форму страницы в двух местах вместо одного.
+ *
+ * Порог 900px — тот же, что у адаптаций ниже: одна граница на «широко» и «узко»,
+ * иначе между двумя порогами страница осталась бы без ни одного правила. */
+@media (min-width: 900px) {
+  body {
+    display: grid;
+    grid-template-columns: minmax(230px, 300px) minmax(0, 1fr);
+    column-gap: var(--gap);
+    /* Оба столбца начинаются сверху и не растягиваются под соседа: у панели своя
+     * высота, у таблицы своя. */
+    align-content: start;
+    align-items: start;
+  }
+  header { grid-column: 1 / -1; }
+  #panel { grid-column: 1; }
+  #notice, #shell, #state, #note { grid-column: 2; }
+  /* В столбце дерево прокручивается выше, чем над таблицей: место занимает
+   * боковая колонка, а числа не отодвигает. */
+  .panel .files { max-height: min(62vh, 620px); }
+}
+
 /* Адаптации: единственное место, где страница правит общую геометрию, — потому что
  * общая часть заморожена байтами артефакта, а не потому что так удобнее. */
 @media (max-width: 900px) {

package/src/page/build.js

@@ -1,8 +1,13 @@
 import fs from 'fs';
 import { fill, LOCALES } from '../locales.js';
-import { esc } from '../render.js';
 import { PAGE_CSS, TABLE_CSS } from '../css.js';
 
+/* Экранирование текста в разметке — здесь, потому что единственный, кто собирает
+ * разметку из данных, — эта сборка: остальное рисует страница узлами. */
+export function esc(s) {
+  return String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+
 /* Сборка страницы отчёта: данные и программа в одном файле, внешних ссылок нет.
  * Оформление — тоже обычные файлы: общая часть таблицы (`table.css`) и своё
  * оформление страницы (`app.css`).
@@ -37,8 +42,8 @@ export function pageScript() {
   return pageSource('../derived.js') + '\n' + PAGE_PARTS.map((part) => pageSource(part)).join('');
 }
 
-/* Подпись под заголовком: чем собрана страница и что у неё рядом. Путь к таблице
- * текстом, а не ссылкой: страница открывается с диска и ни от чего не зависит. */
+/* Подпись под заголовком: чем собран отчёт и где он лежит. Путь — текстом, а не
+ * ссылкой: страница открывается с диска и ни от чего не зависит. */
 function subText(data, page) {
   return fill(page.sub, {
     tool: data.tool.name,
@@ -81,6 +86,20 @@ function uiText(page, loc) {
   };
 }
 
+/* Что в файл не идёт. Первое — список пропущенных коммитов: он меняется от
+ * коммита самого отчёта (тот, кому нечего сказать, попадает в список), и файл
+ * перестал бы быть **неподвижной точкой** — пересборка после его же коммита давала
+ * бы другие байты, а хук коммитил бы отчёт бесконечно. Странице этот список не
+ * нужен вовсе: она его не показывает. Читателю он по-прежнему доступен — `--data`,
+ * `--json` и `explain` отвечают этим же проходом. */
+const NOT_IN_FILE = ['skipped'];
+
+export function pagePayload(data) {
+  const out = Object.assign({}, data);
+  NOT_IN_FILE.forEach((key) => delete out[key]);
+  return out;
+}
+
 /* Страница отчёта — один файл: данные лежат в нём же, скрипт вклеен, внешних
  * ссылок нет. Поэтому она открывается двойным щелчком и работает без сети.
  * `<` в данных экранируется: иначе подпись коммита или путь закрыли бы тег
@@ -98,7 +117,7 @@ export function pageHtml(data, cfg) {
     + '<div id="shell" class="shell"><table id="grid"></table></div>\n'
     + '<p id="state" class="state" hidden></p>\n'
     + '<p id="note" class="note"></p>\n'
-    + '<script type="application/json" id="data">' + jsonInHtml(data) + '</script>\n'
+    + '<script type="application/json" id="data">' + jsonInHtml(pagePayload(data)) + '</script>\n'
     + '<script type="application/json" id="ui">' + jsonInHtml(uiText(loc.page, loc)) + '</script>\n'
     + '<script>\n' + pageScript() + '</script>\n</body>\n</html>\n';
 }

package/src/project.js

@@ -97,8 +97,11 @@ function exists(root, p) {
   return fs.existsSync(path.join(root, p));
 }
 
+/* Имя отчёта — одно на пакет и на проект: файл это и есть страница отчёта, и
+ * называться иначе она не может. Каталог решает только, где ей лежать: рядом с
+ * доками, если они в проекте есть, иначе в корне. */
 function outputOf(root) {
-  return (exists(root, 'docs') ? 'docs/' : '') + 'size-table.html';
+  return (exists(root, 'docs') ? 'docs/' : '') + 'size-report.html';
 }
 
 /* Менеджер пакетов — по lock-файлу, а не догадкой: команда обязана существовать

package/src/refusal.js

@@ -91,7 +91,8 @@ export function advicePath(p) {
 }
 
 export const USAGE = [
-  '@vernikr/size-report — таблица объёма файлов по коммитам.',
+  '@vernikr/size-report — отчёт об объёме файлов по коммитам: один файл,',
+  'самодостаточная страница (данные, оформление и программа лежат в ней же).',
   '',
   'Запуск: ' + invocation() + ' [команда] [режим] [ключи]',
   '',
@@ -101,19 +102,18 @@ export const USAGE = [
   '  explain <коммит>  почему у коммита нет строки (имя ревизии, sha или его начало)',
   '  doctor [--json]   диагностика одним ответом: окружение, зависимости, настройки,',
   '                    покрытие (код 0 — делать нечего, иначе — первый по важности)',
-  '  install-hook      поставить хуки post-commit и post-merge: отчёт пересобирается',
-  '                    сам после каждого коммита и слияния, а если он в git — ложится',
-  '                    отдельным коммитом',
+  '  install-hook      поставить хуки post-commit и post-merge (они ставятся сами при',
+  '                    первом запуске в проекте): отчёт пересобирается после каждого',
+  '                    коммита и слияния, а если он в git — ложится отдельным коммитом',
   '  uninstall-hook    убрать хук и его состояние (проект возвращается к прежнему)',
   '  hook-run          то, что зовёт хук: пересборка и коммит отчёта (вручную не нужно)',
   '',
   'Режимы:',
   '  --init [файл]   закрепить настройки файлом (--force — перезаписать существующий)',
-  '  --write         собрать таблицу в файл из настроек',
-  '  --data          данные контракта в stdout — для страницы и для агента',
-  '  --page [файл]   страница отчёта (по умолчанию рядом с таблицей)',
+  '  --write [файл]  собрать отчёт в файл из настроек (каталог создаётся сам)',
+  '  --data          данные контракта в stdout — для отчёта и для агента',
   '  --json          прежняя форма данных в stdout',
-  '  (без режима)    проверить, что таблица совпадает с историей',
+  '  (без режима)    проверить, что отчёт совпадает с историей',
   '',
   'Ключи: --config <файл> — другие настройки; --help — эта справка.',
   '',

package/src/size-table.js

@@ -37,13 +37,16 @@
  * начинает работать и для стратегии «пересобрать и дописать в тот же коммит»:
  * без sha артефакт становится неподвижной точкой сборки.
  *
+ * Отчёт один: самодостаточная страница (`size-report.html`), в которой лежат и
+ * данные, и оформление, и программа. Второй формы того же отчёта нет намеренно: два
+ * вывода одной истории разошлись бы молча, а выбрать, какой верный, было бы нечем.
+ *
  * Запуск (из любого места репозитория; `size` — когда пакет установлен, иначе
  * `node bin/size.js`):
- *   size                    проверка: таблица совпадает с историей (CI)
- *   size --write            перегенерировать таблицу
+ *   size                    проверка: отчёт совпадает с историей (CI)
+ *   size --write [файл]     перегенерировать отчёт
  *   size --json             строки как JSON в stdout
- *   size --data             данные для страницы и агента в stdout
- *   size --page [файл]      собрать страницу отчёта
+ *   size --data             данные для отчёта и агента в stdout
  *   size --init [файл]      закрепить настройки файлом (без него они выводятся из проекта)
  *   size --config <путь>    другой файл настроек
  *   size --help             справка и коды выхода
@@ -64,8 +67,8 @@
  *   config → project, git, refusal, locales, metrics, data — настройки проекта;
  *   history → git, metrics, journal, refusal           — сборка по истории;
  *   data → locales, metrics, journal, history, tool    — контракт со страницей;
- *   render → locales, metrics, journal, derived        — статический артефакт;
- *   page/build → locales, render                       — страница отчёта;
+ *   page/build → locales, css                          — отчёт одним файлом;
+ *   artifact → data, page/build                        — запись отчёта;
  *   modes → почти все                                  — что делать по запросу;
  *   init → config, project, refusal, artifact          — закрепление настроек файлом;
  *   cli → args, modes, init, config, refusal           — вход: разбор и доставка.
@@ -76,11 +79,10 @@
 export { main } from './cli.js';
 export { initMode } from './init.js';
 export { sniffColumns } from './project.js';
-export { check, dataMode, pageMode } from './modes.js';
+export { check, dataMode, writeMode } from './modes.js';
 export { reportData, categoryOf, CATEGORY_EXTS, CATEGORY_ORDER } from './data.js';
 export { measureHistory } from './history.js';
-export { render, noteText, cellHtml, valueHtml } from './render.js';
-export { pageHtml, pageScript, pageSource, stripModules } from './page/build.js';
+export { pageHtml, pageScript, pageSource, stripModules, esc } from './page/build.js';
 export { measureBlob, METRICS } from './metrics.js';
 export { minifyForm, strategyFor, stripCss, stripHtml, stripJs, stripLines, compactJson,
   STRATEGIES } from './strip.js';

package/templates/README.md

@@ -11,6 +11,11 @@
 | `size-report.config.json` | `size-table.config.json` в корне проекта | **Поправить колонки** и, если нужно, остальное |
 | `ci.yml` | `.github/workflows/size-report.yml` | Ничего: файл работает как есть |
 
+Отчёт в проекте появляется без ручной работы: после установки пакета и первого
+запуска инструмент сам ставит хуки `post-commit`/`post-merge`, и `docs/` с
+`size-report.html` создаётся первым же коммитом. Снять автоматику — `size
+uninstall-hook`, выключить, не снимая, — `"hooks": {"enabled": false}`.
+
 ## Настройки
 
 **Файл настроек заводить не нужно.** Без него инструмент выводит профиль из самого
@@ -51,7 +56,7 @@ README и журнал колонкой не отслеживаются, — т
   именно этот объект выводит `size --init`, когда журнал в проекте есть.
 - `paths` внутри колонки — псевдонимы одного файла: если файл переименовывали,
   перечислите и старое имя, и новое, и колонка не разорвётся.
-- `output: "docs/size-table.html"` — файл таблицы; каталог инструмент создаст сам.
+- `output: "docs/size-report.html"` — файл отчёта (он один: самодостаточная страница со всеми числами, фильтрами и ссылкой); каталог инструмент создаст сам, а хук — тоже: после установки пакета и первого запуска отчёт обновляется после каждого коммита без ручного шага.
 
 ## Проверка в CI
 

package/templates/ci.yml

@@ -2,7 +2,8 @@
 # Положите файл в .github/workflows/size-report.yml — правок он не требует.
 #
 # Что проверяется и почему так:
-#   * таблица объёма на диске сходится с историей git — это числа отчёта;
+#   * отчёт на диске сходится с историей git — это его числа (отчёт один:
+#     самодостаточная страница `size-report.html`);
 #   * тот же снимок чисел, снятый в среде, где настроек git нет вовсе,
 #     совпадает побайтово: вывод инструмента не должен зависеть от того, что
 #     настроено на машине (BLOCKERS.md §B1, §B2).
@@ -23,7 +24,7 @@
 # Нужен явный путь — `node node_modules/@vernikr/size-report/bin/size.js`.
 #
 # Отчёт не в git? Такое тоже задумано требованиями (отчёт — выводимый артефакт):
-# тогда вместо шага «Таблица объёма совпадает с историей» поставьте сборку —
+# тогда вместо шага «Отчёт совпадает с историей» поставьте сборку —
 # `pnpm exec size --write` — и этот шаг будет проверять, что отчёт собирается.
 
 name: size-report
@@ -34,7 +35,7 @@ jobs:
   size:
     runs-on: ubuntu-latest
     steps:
-      # История нужна целиком: таблица строится по коммитам, и на обрезанном
+      # История нужна целиком: отчёт строится по коммитам, и на обрезанном
       # клоне инструмент отказывается работать (код 3), а не пишет короткую.
       - uses: actions/checkout@v7
         with:
@@ -50,9 +51,9 @@ jobs:
       - name: Установка
         run: pnpm install --frozen-lockfile
 
-      # Проверка — та же команда `size` без ключей: она собирает таблицу заново
+      # Проверка — та же команда `size` без ключей: она собирает отчёт заново
       # и сверяет с файлом на диске. Своего набора тестов потребителю не нужно.
-      - name: Таблица объёма совпадает с историей
+      - name: Отчёт совпадает с историей
         run: pnpm exec size
 
       - name: Снимок чисел контракта

package/templates/size-report.config.json

@@ -1,5 +1,5 @@
 {
-  "output": "docs/size-table.html",
+  "output": "docs/size-report.html",
   "locale": "ru",
   "title": "Объём файлов по коммитам",
   "heading": "Объём файлов по коммитам",

package/src/artifact.css

@@ -1,8 +0,0 @@
-:root { color-scheme: light dark; }
-/* Фон и цвет текста заданы явно и одной парой (Canvas/CanvasText): без этого
- * страница берёт цвет текста из схемы, а фон — нет, и в тёмной схеме числа
- * оказывались белыми на белом. */
-body { margin: 0; padding: 20px; background: Canvas; color: CanvasText; font: 12.5px/1.4 ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif; }
-h1 { margin: 0 0 6px; font-size: 16px; }
-.note { margin: 0 0 14px; max-width: 80em; opacity: .75; font-size: 12px; }
-.note code { background: rgba(127, 127, 127, .15); padding: 0 3px; border-radius: 3px; }