@vernikr/size-report 1.3.0 → 2.0.0

package/CHANGELOG.md

@@ -18,6 +18,87 @@
 где за основу взяты `fixtures/synthetic/config.json`, метрики — `raw`, `min`, `tok`, а
 способ минификации — `strip` или `esbuild`.
 
+## 2.0.0 — 2026-09-15
+
+Один отчёт вместо двух, и он же появляется сам: форма отчёта сведена к одному
+файлу, а обновление — к одному решению (хук ставится сам).
+
+- **Отчёт — один файл: самодостаточная страница `size-report.html`.** Данные,
+  оформление и программа лежат в нём же; внешних ссылок нет. Прежние две формы
+  (статическая таблица и рядом страница) убраны вместе с их кодом (`src/render.js`,
+  `src/artifact.css`): два вывода одной истории расходились бы молча, а выбрать,
+  какой верный, было бы нечем. Колонка движка — это файл, значит и отчёт — файл.
+- **Запись одна: `--write [файл]`** (прежняя `--page` убрана — это ломающее
+  изменение). Значение ключа пишет отчёт по названному пути (каталог создаётся сам)
+  и становится его же `output`: отчёт называет себя тем путём, по которому лежит.
+- **По умолчанию — `docs/size-report.html`**, если каталог `docs/` в проекте есть,
+  иначе в корне. Имя больше не выводится из настроек: файл это и есть отчёт.
+- **Хук ставится сам** — после постановки пакета (`bin/postinstall.js`) и при первом
+  запуске в проекте. Поэтому `docs/` с отчётом появляется первым же коммитом, без
+  ручного шага; ставится там, где это безопасно (обычный `.git/hooks`, нет чужого
+  хука, есть чем звать инструмент, не CI), и там же молчит, где нельзя.
+- Коммит отчёта виден в хуке как раньше: отдельным коммитом, только этим путём.
+  Отчёт остаётся **неподвижной точкой** — список пропущенных коммитов в файл не
+  идёт (он меняется от коммита самого отчёта), и хук не коммитит его бесконечно;
+  читателю этот список по-прежнему доступен: `--data`, `--json`, `size explain`.
+
+### Что изменится в числах
+
+**Ничего.** Измерение не тронуто: те же датчики, те же способы, те же колонки. Что
+меняется у потребителя — **форма файла и его путь**: `size` (проверка) на прежнем
+файле будет красным, пока отчёт не пересобран, а скрипты, звавшие `--page`,
+получат отказ с названным ключом. Таблица ниже та же, что у 1.3.1, до последней
+клетки.
+
+| Файл | raw | min со strip | min с esbuild | tok |
+|---|---|---|---|---|
+| code.js | 735 | 276 | 185 | 168 |
+| modern.js | 246 | 51 | 45 | 44 |
+| config.mjs | 172 | 45 | 40 | 40 |
+| заметки.md | 306 | 303 | 303 | 53 |
+| crlf.txt | 63 | 60 | 60 | 10 |
+| package.json | 87 | 69 | 69 | 34 |
+| style.css | 156 | 55 | 43 | 38 |
+| table.toml | 300 | 299 | 299 | 52 |
+| empty.js | 0 | 0 | 0 | 0 |
+| WORKLOG.md | 446 | 439 | 439 | 101 |
+| **ИТОГО** | **2511** | **1597** | **1483** | **540** |
+
+## 1.3.1 — 2026-09-15
+
+Правка раскладки страницы: на широком экране панель выбора встаёт слева от таблицы.
+
+- **От 900 px панель — колонка слева от таблицы.** Метрики, дерево файлов и легенда
+  видны одновременно с числами: прокрутка нижних строк больше не уводит управление за
+  верх экрана, а таблица получает всё оставшееся по горизонтали (1060 px при окне
+  1440 против 1372 у прежней раскладки в одну колонку). Узкое окно раскладку снимает:
+  там столбцы снова идут друг под другом, как было.
+- Раскладка — сетка на `body` (`src/page/app.css`), а не обёртка в разметке: страница
+  собирается вклейкой глав, и форма страницы осталась в одном месте. Порог тот же,
+  что у адаптаций: между «широко» и «узко» нет промежутка без правил.
+- Ни поведение, ни артефакт, ни данные не тронуты — правка только в оформлении
+  страницы (`--page`); статический артефакт (`--write`) этот выпуск не касается.
+
+### Что изменится в числах
+
+**Ничего.** Этот выпуск не трогает ни измерение, ни форму отчёта: изменилась
+раскладка страницы, а числа считает тот же движок теми же датчиками. Таблица ниже та
+же, что у 1.3.0, до последней клетки.
+
+| Файл | raw | min со strip | min с esbuild | tok |
+|---|---|---|---|---|
+| code.js | 735 | 276 | 185 | 168 |
+| modern.js | 246 | 51 | 45 | 44 |
+| config.mjs | 172 | 45 | 40 | 40 |
+| заметки.md | 306 | 303 | 303 | 53 |
+| crlf.txt | 63 | 60 | 60 | 10 |
+| package.json | 87 | 69 | 69 | 34 |
+| style.css | 156 | 55 | 43 | 38 |
+| table.toml | 300 | 299 | 299 | 52 |
+| empty.js | 0 | 0 | 0 | 0 |
+| WORKLOG.md | 446 | 439 | 439 | 101 |
+| **ИТОГО** | **2511** | **1597** | **1483** | **540** |
+
 ## 1.3.0 — 2026-09-15
 
 Выпуск выведенных настроек: чтобы получить отчёт, проект больше не обязан себя

package/README.md

@@ -10,11 +10,14 @@
 
 ## Статус
 
-**Выпуск 1.3.0 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
+**Выпуск 2.0.0 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
 реестре — `@vernikr/size-report` (публикуется тегом из CI, без секрета). Настроек
 проект может не заводить вовсе: без файла инструмент выводит их из самого проекта и
 говорит об этом строкой, а `--init` закрепляет выведенное файлом (чем этот шаг
-отличается от прежнего — `CHANGELOG.md` 1.3.0).
+отличается от прежнего — `CHANGELOG.md` 1.3.0). Отчёт — **один файл**,
+самодостаточная страница `docs/size-report.html`, и он появляется сам: хук обновления
+ставится после установки пакета и при первом запуске (чем это отличается от двух
+файлов прежних выпусков — `CHANGELOG.md` 2.0.0).
 Версия — в манифесте, а у выпуска есть `CHANGELOG.md` с разделом «Что изменится
 в числах»:
 таблица чисел в нём не пересказ, а замер на фикстуре, который сверяется с живым
@@ -67,7 +70,7 @@
 
 **Шаг 2 начат первым срезом — контрактом данных.** Движок отдаёт абсолютные
 значения и устройство таблицы (`--data`), а дельты, суммы, «сейчас» и фильтры
-считает страница (`--page`, `size-report.html` рядом с таблицей): без этого
+считает страница (она же и есть отчёт — `size-report.html`): без этого
 фильтры и «итого по выбору» невозможны в принципе. В контракте едет и точность
 числа — рядом пометок `approx` по клеткам, — потому что это факт замера, а не
 вывод: страница показывает то, что сказал движок, и своего правила точности не
@@ -216,10 +219,10 @@
 
 | Прогон | Команда | Проверок |
 |---|---|---|
-| Быстрый — каждая правка | `pnpm test` | **65 из 167** |
-| Полный — выкладка и CI | `pnpm test:all` | **167** |
+| Быстрый — каждая правка | `pnpm test` | **65 из 168** |
+| Полный — выкладка и CI | `pnpm test:all` | **168** |
 
-Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 167 теми же
+Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 168 теми же
 файлами, а быстрый берёт их часть. Умолчание — полный: файл становится быстрым только
 явно и с причиной, поэтому новое дорогое не может тихо уехать в быстрый. Стерегут это
 объявление `test/suites.test.js` (полнота классификации и причина у каждого файла) и
@@ -316,9 +319,20 @@ deльт задан один раз и по артефакту: рост зел
 папки три состояния — все её файлы включены, часть, ни одного, — и переключатель
 папки ведёт за собой всё поддерево; рядом стоит число файлов. Своего состояния у
 папки и у быстрой кнопки категории нет: обе переставляют галочки файлов, поэтому
-дерево, кнопки и таблица не могут разойтись. Список файлов длиной больше трети
-экрана прокручивается внутри панели, а не выталкивает таблицу: на живой истории
-(91 строка × 25 файлов) панель занимает 429 px, таблица начинается на 544-м.
+дерево, кнопки и таблица не могут разойтись. Список файлов длиной больше экрана
+прокручивается внутри панели, а не выталкивает таблицу: на живой истории
+(87 строк × 12 колонок) дерево занимает 558 px из 883 у панели.
+
+**На широком экране панель стоит слева от таблицы** (от 900 px, `src/page/app.css`).
+Это не украшение: на десктопе бокового места много, а вертикального мало —
+переключатели, дерево и числа видны одновременно, и прокрутка нижних строк не
+уводит управление за верх экрана. Раскладка сделана сеткой на `body`: обёртки в
+разметке нет, потому что страница собирается вклейкой глав и форма страницы должна
+жить в одном месте. Порог один с адаптациями — промежутка без правил между «широко»
+и «узко» нет. Измерено в настоящем Chrome на живой истории: при окне 1440×900
+панель — колонка 300 px слева, таблица начинается на 346-м и на той же высоте
+(103), её собственное окно 1060 × 602; при 1024 — те же 300 и 651; при 899
+раскладка снимается и столбцы снова идут друг под другом (панель 79, таблица 557).
 Стрежет это проверка на числах таблицы, а не на разметке: выключение папки убирает
 ровно её колонки и ровно её объём из итога (`test/contract.test.js`). Проверено в
 настоящем Chrome: 9 папок до трёх уровней вложенности (`.github/workflows`,
@@ -421,8 +435,8 @@ deльт задан один раз и по артефакту: рост зел
 профиль ведёт новые проекты сразу на токены.
 
 **Волна 0 чистки пройдена** (`REFACTOR.md`): у отказов командной строки появились
-коды выхода и справка вместо стека, `--help` отвечает, `--page` и `--write`
-создают недостающий каталог, подсказка в отказе ведёт к работающей команде, а
+коды выхода и справка вместо стека, `--help` отвечает, `--write`
+создаёт недостающий каталог, подсказка в отказе ведёт к работающей команде, а
 вывод настроек больше не предлагает колонкой саму таблицу — иначе первая же
 проверка настроек его отвергала.
 
@@ -473,8 +487,8 @@ deльт задан один раз и по артефакту: рост зел
 | `tools/parity-freeze.js` | Снимает эталон паритета (`pnpm run parity`): замороженной копией, на ревизии проекта из манифеста — `--json`, конфиг, хеш артефакта, хеш инструмента |
 | `tools/make-fixture.js` | Собирает синтетическую фикстуру (`pnpm run fixture`): детерминированную историю с ловушками плюс эталонные числа |
 | `tools/synthetic/` | Сюжеты той сборки по предметам: `repo.js` — как говорим с git (закреплённые время, автор, настройки), `content.js` — что лежит в файлах, `history.js` — какие коммиты из этого получаются, `note.js` — записка к фикстуре со списком ловушек |
-| `tools/parity-live.js` | Сверяет движок с живым проектом на клоне: числа и артефакт (`pnpm run parity:live`) |
-| `tools/pack-check.js` | Собирает тарболл и проверяет, что из него всё работает: все исходники доехали, числа, артефакт и страница — как из репозитория (`pnpm run pack:check`) |
+| `tools/parity-live.js` | Сверяет движок с живым проектом на клоне: числа и самодостаточный отчёт по пути из настроек потребителя (`pnpm run parity:live`) |
+| `tools/pack-check.js` | Собирает тарболл и проверяет, что из него всё работает: все исходники доехали, числа и отчёт — как из репозитория (`pnpm run pack:check`) |
 | `tools/check-standards.js` | Проверяет, что оба эталона воспроизводятся: пересъём идёт в никуда и сверяется с закоммиченным (наши файлы — побайтово, бандл — по содержимому) и что бандл живой истории несёт `HEAD` (`pnpm run check:standards`) |
 | `.github/workflows/ci.yml` | CI: работа `verify` на каждый пуш и запрос правки зовёт `pnpm run verify` — тот же профиль, что локально; действия закреплены по SHA коммита |
 | `.github/workflows/verify-slow.yml` | Slow-профиль по расписанию: то же плюс покрытие под c8 — дорогое не в каждом прогоне |
@@ -486,6 +500,7 @@ deльт задан один раз и по артефакту: рост зел
 | `tools/gates/gatefiles.js` | Защита гейт-файлов: правка порогов, баз и обвязки без трейлера `Gate-Change:` — красный (хук `commit-msg` и CI по диапазону) |
 | `tools/gates/common.js`, `tools/gate-probe.js` | Общее у датчиков (корень, разбор ключей, отчёты) и обвязка их проб: датчик зовётся командой, а не импортом |
 | `.githooks/commit-msg`, `.githooks/pre-commit`, `.githooks/pre-push` | Хуки: защита гейт-файлов, быстрый профиль на правку и перед отправкой; ставятся `pnpm run hooks:install` (свой менеджер хуков не заводится) |
+| `.githooks/post-commit` | Обновление отчёта после коммита: зов установленной копии пакета (строка вписана человеком — инструмент чужие каталоги хуков не правит) |
 | `eslint.metrics.config.js`, `.eslint-suppressions.json` | Правила датчика раздувания и его база: пороги из замеров, всё, что выше, — в базе и разбирается постепенно |
 | `.jscpd.json`, `dup-baseline.json` | Настройки и база датчика дублей: отпечаток считается по содержимому клона, поэтому база переносима |
 | `.dependency-cruiser.cjs`, `.c8rc.json`, `coverage-baseline.json` | Правила графа связей, настройки снятия покрытия и его база по файлам |
@@ -493,17 +508,16 @@ deльт задан один раз и по артефакту: рост зел
 | `.github/workflows/release.yml` | Выпуск по тегу: тот же полный набор, сверка версии манифеста с тегом и публикация в реестр по удостоверению GitHub Actions — без секрета и без кода из аутентификатора |
 | `templates/` | То, что проект берёт как есть: `size-report.config.json` (черновик настроек), `ci.yml` (описание проверки) и `README.md` (куда что кладётся и что в них менять); едут в поставке и стерегутся `pack:check` и `test/templates.test.js` |
 | `fixtures/parity/` | Эталон с `safe-resets` на коммите `bd6ef9d`: 95 строк × 27 колонок. Копия реализации, которой он снят, в дереве не лежит — её байты живут в истории и берутся оттуда по требованию (`REFACTOR.md` R-1.5) |
-| `fixtures/synthetic/` | Бандл фикстуры на 16 коммитов, её конфиг, эталонные числа и хеш артефакта |
+| `fixtures/synthetic/` | Бандл фикстуры на 16 коммитов, её конфиг, эталонные числа (`--json` прежней копии) и хеш её артефакта прежней формы — запись того, с чем сверялся перенос |
 | `fixtures/live/history.bundle`, `fixtures/live/README.md` | История проекта-потребителя на ревизии эталона `bd6ef9d` и записка о том, какую ревизию бандл несёт и почему он лежит в репозитории: живая сверка работает без доступа к приватному проекту |
 | `bin/size.js` | Команда `size`: то, что ставит пакет (`package.json` → `bin`); сама ничего не считает, только зовёт точку входа |
 | `LICENSE` | MIT: условия лицензии едут в поставке вместе с пакетом |
 | `.gitignore`, `pnpm-lock.yaml` | Что в репозиторий не идёт; lock-файл pnpm, а версия менеджера — в поле `packageManager` (оттуда её берёт CI) |
-| `src/size-table.js` | Точка входа пакета: только реэкспорт публичного API (58 имён), ни одного расчёта |
-| `src/derived.js` | Общий расчёт отчёта: итоги, дельты, клетка, подпись коммита — одно место на артефакт и страницу |
+| `src/size-table.js` | Точка входа пакета: только реэкспорт публичного API (55 имён), ни одного расчёта |
+| `src/derived.js` | Общий расчёт отчёта: итоги, дельты, клетка, подпись коммита — один на движок и программу страницы |
 | `src/css.js` | Чтение оформления с диска: какие наборы стилей есть и какая у них роль |
-| `src/table.css` | Общая часть таблицы: геометрия клеток, липкие шапка и колонка, цвет дельт — одна на артефакт и страницу |
-| `src/artifact.css` | Оформление статического артефакта сверх общей части |
-| `src/page/app.css` | Оформление страницы сверх общей части: панель с деревом файлов, состояния пустоты, узкое окно |
+| `src/table.css` | Таблица отчёта: геометрия клеток, липкие шапка и колонка, цвет дельт |
+| `src/page/app.css` | Оформление страницы сверх общей части: панель с деревом файлов (на широком экране — колонка слева от таблицы), состояния пустоты, узкое окно |
 | `src/page/state.js` | Состояние страницы: данные отчёта, вид галочек, паспорт записи, память браузера и обмен ссылкой — глава программы страницы |
 | `src/page/dom.js` | Узлы страницы: мелкие помощники разметки (`appEl`, `appBox`) — одни на панель и таблицу |
 | `src/page/panel.js` | Панель выбора: галочки метрик и файлов, категории, дерево путей, легенда; перерисовку просит у главы сборки |
@@ -525,17 +539,17 @@ deльт задан один раз и по артефакту: рост зел
 | `src/check.js` | Полнота покрытия (`size check`): настройки, история, пути, датчики — что прошло мимо колонок и чем это чинится |
 | `src/explain.js` | Объяснение пропущенной строки (`size explain <коммит>`): причина, улики и готовая починка |
 | `src/doctor.js` | Диагностика одним ответом (`size doctor`): окружение, зависимости, настройки, покрытие, состояние хука — сборкой из существующих кусков |
-| `src/hook.js` | Хуки автообновления (`install-hook` / `uninstall-hook` / `hook-run`): установка и снятие, коммит только отчёта, замок и запись о запуске |
-| `src/artifact.js` | Артефакт на диске: единственное место, где отчёт превращается в файл (им пользуются и `--write`, и хук) |
+| `src/hook.js` | Хуки автообновления: постановка сама (`autoInstall` — из входа и `bin/postinstall.js`), снятие командой, коммит только отчёта, замок и запись о запуске |
+| `bin/postinstall.js` | Установка хука после постановки пакета: ищет проект-потребитель и молчит, если поставить негде |
+| `src/artifact.js` | Отчёт на диске: единственное место, где он превращается в файл (им пользуются и `--write`, и хук); отчёт — самодостаточная страница |
 | `src/journal.js` | Журнал и ссылки: к какому разделу относится коммит и куда ведёт описание |
 | `src/data.js` | Категории файлов и контракт со страницей (`--data`) |
-| `src/render.js` | Статический артефакт: клетки, таблица, примечание (стили — в `src/css.js`) |
 | `src/config.js` | Настройки проекта-потребителя: умолчания, чтение, проверка |
 | `src/project.js` | Настройки, выведенные из самого проекта (дерево и история): колонки, журнал, исключения. Без файла настроек он и есть настройки; `--init` закрепляет его файлом |
 | `src/locales.js`, `src/refusal.js`, `src/tool.js` | Тексты отчёта; коды выхода и справка; имя и версия пакета |
 | `src/cli.js` | Вход инструмента: разбор строки, чтение проекта и доставка запроса режиму; главный файл пакета |
 | `src/args.js` | Грамматика командной строки: режимы, ключи и команды плюс проверки их сочетаний — отказ называет виновника и готовую команду |
-| `src/modes.js` | Режимы: собрать таблицу, сверить её с историей, отдать данные или страницу, полноту покрытия и диагностику |
+| `src/modes.js` | Режимы: собрать отчёт, сверить его с историей, отдать данные, полноту покрытия и диагностику |
 | `src/init.js` | Закрепление настроек файлом (`--init`): то, что проект вывел о себе сам, ложится файлом — и проходит ту же проверку, что первый запуск |
 | `test/api.test.js` | Публичный API пакета: список имён заморожен, разбиение не имеет права его менять |
 | `eslint.config.js` | Правила оформления: те же, что у проекта-потребителя, плюс запрет склейки операторов в строке (`pnpm run lint`, `pnpm run lint:strict`) |
@@ -546,7 +560,7 @@ deльт задан один раз и по артефакту: рост зел
 | `tools/docs-facts.js` | Чтение фактов из документации — один слой на четыре проверки сторожа: что документ называет (пути, зовы, адреса разделов) против того, что есть в репозитории |
 | `tools/yaml.js` | Разбор подмножества YAML — один разборщик на два сторожа описаний (`templates/ci.yml` и `.github/workflows/release.yml`): вне подмножества — ошибка, а не молча пропущенная строка, включая двоеточие с пробелом в незакавыченном значении (именно оно делало описание выпуска неразбираемым, пока проверка искала подстроки) |
 | `tools/refusals.js` | Каталог отказов: по строке на каждый — причина, код выхода, обязательные фразы вывода, **что отказ советует** (`advice`: `run` — команда, `template` — форма с подстановкой, `manual` — действие человека с причиной, `coveredBy` — отдан другой проверке), а для непроверяемого — почему; карты мест отказа (`SITES`, `PRINTED`) держат числа, чтобы новый отказ не появился молча, а маркеры совета — чтобы не появился молча новый совет |
-| `test/parity.test.js` | Паритет движка с эталоном: числа, артефакт, локаль |
+| `test/parity.test.js` | Паритет движка с эталоном: числа, самодостаточность отчёта, локаль |
 | `test/frozen.test.js` | Замороженная копия: та ли это ревизия, с которой снят эталон, и воспроизводит ли она его |
 | `test/environment.test.js` | Герметичность: вывод не зависит от настроек git машины и локали |
 | `test/crlf.test.js` | Выкладка с CRLF (`core.autocrlf`) не мешает сверке |
@@ -628,7 +642,7 @@ pnpm add -D @vernikr/size-report
 ```
 
 Пакет **опубликован в реестре**, и публично: `npm view @vernikr/size-report
-version` отвечает `1.3.0`, `npm access get status @vernikr/size-report` — `public`,
+version` отвечает `2.0.0`, `npm access get status @vernikr/size-report` — `public`,
 а анонимный запрос тарболла — код 200. `npm i -D` и `yarn add -D` принимают то же
 имя; ни ключа, ни ссылки на репозиторий не нужно.
 
@@ -636,11 +650,11 @@ version` отвечает `1.3.0`, `npm access get status @vernikr/size-report`
 реестра, но остаётся привязанной к ревизии:
 
 ```bash
-pnpm add -D github:vernikr/size-report#v1.3.0
+pnpm add -D github:vernikr/size-report#v2.0.0
 ```
 
 Без сети (или если тянуть из codeload нечем) — тарболл: `pnpm pack` в клоне
-пакета, затем `pnpm add -D ./vernikr-size-report-1.3.0.tgz`.
+пакета, затем `pnpm add -D ./vernikr-size-report-2.0.0.tgz`.
 
 **Почему тег, а не sha.** Короткий sha pnpm разрешает только через видимые рефы, а
 `git ls-remote` отдаёт одни верхушки веток: пока ревизия — верхушка, короткий sha
@@ -648,7 +662,7 @@ pnpm add -D github:vernikr/size-report#v1.3.0
 <sha> to a commit`. Это не рассуждение, а проба: короткий пин `6530237` ставился,
 пока `main` стоял на нём, и перестал — на следующем же коммите, а тот же sha
 целиком поставился. Имя ветки (`#main`) или тег принимаются оба, но ветка —
-движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v1.3.0`, он же и в
+движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v2.0.0`, он же и в
 примере (сорок знаков тоже годятся, но их придётся брать глазами из истории).
 
 Ревизия в примере — не украшение, а часть утверждения: она закреплена за тем, что
@@ -708,7 +722,7 @@ stderr и называет команду, которая их закрепля
 проекту молча.
 
 > Subкоманды `size init` пока нет — CLI знает только флаги (`--init`, `--write`,
-> `--page`, `--data`, `--json`, без флага — проверка); полный список даёт `size --help`.
+> `--data`, `--json`, без флага — проверка); полный список даёт `size --help`.
 > Subкоманды — шаг 5 плана (`REFACTOR.md` R-4.5).
 
 ### 3. Что правится в конфиге
@@ -722,14 +736,14 @@ stderr и называет команду, которая их закрепля
 | `metrics` | из чего состоит число: `raw` (размер объекта git), `min` (минифицированная форма — какая именно, решает `minify.engine`), `tok` (токены), `gzip` |
 | `tokens.family`, `tokens.encoding` | словарь для `tok`: семейство (`openai`) и кодировка (`o200k_base` или `cl100k_base`) — кодировка меняет число, поэтому она и в настройках, и в подписи метрики |
 | `minify.engine` | чем считается `min`: `strip` (комментарии и отступы, точность не обещается) или `esbuild` (настоящее сжатие; форматы без минификатора — упрощение, и это видно в подписи метрики) |
-| `output` | файл таблицы (в выведенном профиле — `docs/size-table.html`, если каталог `docs/` есть, иначе в корне) |
+| `output` | файл отчёта (в выведенном профиле — `docs/size-report.html`, если каталог `docs/` есть, иначе в корне; имя отчёта — его имя, а каталог решает только где ему лежать) |
 | `journal` | где искать разделы журнала, на которые ссылаются строки |
 | `links.commitUrl` | шаблон ссылки на коммит, например `https://github.com/org/repo/commit/{sha}`; выводится из адреса `origin` у GitHub и GitLab (у остальных хозяев — пусто, а не догадка) |
 | `skip` | пути, которые колонкой не стали: и те, что ею быть не могут (сам отчёт, замки зависимостей), и те, что в колонки не поместились (выведенный профиль объявляет исключениями всё остальное — поэтому первый `check` полон) |
 | `fixCommand` | команда, которую цитирует подпись отчёта и подсказывает отказ; в выведенном профиле — ваш скрипт `sizes`, если он объявлен, иначе путь к установленному пакету внутри проекта (зов по имени пакета уходит в реестр — `REFACTOR.md` R-4.21) |
 | `locale`, `title`, `heading` | язык текстов отчёта и его заголовки; пустые `title`/`heading` значат «взять из локали» |
 | `minify.guard` | расширения, где результат стриппера проверяется разбором; модуль в `.js` гард понимает сам, трогать его не нужно |
-| `hooks.enabled` | выключатель хука автообновления (`false` — хук остаётся на месте, но молчит; убирается он только `size uninstall-hook`) |
+| `hooks.enabled` | выключатель хука автообновления (`false` — хук не ставится сам и молчит, если уже стоит; убирается он только `size uninstall-hook`) |
 
 Остальные ключи и умолчания — `src/config.js` (`DEFAULT_CONFIG`).
 
@@ -741,14 +755,13 @@ stderr и называет команду, которая их закрепля
 ```
 
 ```bash
-pnpm run sizes            # → docs/size-table.html — таблица коммитов и чисел
-pnpm exec size --page     # → docs/size-report.html — интерактивная страница
+pnpm run sizes            # → docs/size-report.html — отчёт: таблица, фильтры, ссылка
 ```
 
-Оба отчёта — самодостаточные файлы: открываются двойным щелчком, без сервера и
-без сети (внешних ссылок в них нет вовсе, данные и программа вклеены). Числа
-между ними одни и те же — страница считает производные (дельты, итоги, фильтры)
-из тех же абсолютных значений тем же кодом, что и таблица.
+Отчёт — один самодостаточный файл: открывается двойным щелчком, без сервера и без
+сети (внешних ссылок в нём нет вовсе, данные, оформление и программа вклеены).
+Производные (дельты, итоги, фильтры) считает сама страница — из абсолютных
+значений, которые даёт движок, и тем же кодом, что и его расчёт.
 
 **Порядок правок:** код → `pnpm run sizes` → коммит с одной таблицей. Таблица
 обновляется **отдельным коммитом**, потому что строка коммита не может попасть в
@@ -984,7 +997,7 @@ R-4.1): пути, таблица файлов, зовы и ключи инстр
 - `--json` — форма ответа, а не отдельный режим, и правило у него одно: ответ
   бывает ровно у четырёх вызовов. Без команды это прежняя форма данных
   (заморожена эталоном паритета), у `check`, `explain` и `doctor` — их ответ.
-  У команды без ответа и рядом с режимом (`--write`, `--data`, `--page`, `--init`)
+  У команды без ответа и рядом с режимом (`--write`, `--data`, `--init`)
   он отказ, а не тишина: просить JSON там, где его не бывает, — ошибка вызова.
 - `size doctor --json` — вся диагностика одним ответом: окружение, зависимости,
   настройки, покрытие и находки с уровнем (`action` — делать, `note` — знать).
@@ -1019,8 +1032,8 @@ pnpm test:all                  # полный прогон (выкладка и
                                # сборка на дисках, сверка с деревом, хуки, метрики
 pnpm run suites:measure        # замерить длительность каждого файла набора
 pnpm run parity:live           # паритет с живым проектом на клоне, две среды
-node bin/size.js --data        # контракт данных: страница и агент
-node bin/size.js --page        # минимальная страница отчёта
+node bin/size.js --data        # контракт данных: отчёт и агент
+node bin/size.js --write       # минимальный отчёт
 node bin/size.js --help        # справка и коды выхода
 pnpm run parity                # переснять эталон паритета: проект и ревизия — из манифеста
 pnpm run fixture               # пересобрать фикстуру и её эталон

package/bin/postinstall.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+/* Постановка хука после установки пакета: чтобы отчёт обновлялся с первого же
+ * коммита, не требуя ни запуска инструмента, ни файла настроек.
+ *
+ * Здесь только поиск проекта-потребителя: сам хук ставит `autoInstall`
+ * (`src/hook.js`) — то же место, что и при первом запуске, иначе «поставлено при
+ * установке» и «поставлено при запуске» могли бы разойтись содержимым файла.
+ *
+ * Код выхода всегда 0: установка зависимостей не должна падать из-за того, что
+ * услугу не удалось оказать (нет git, нет прав, чужой хук, CI). Причина не
+ * печатается: у фоновой работы нет читателя, а точная причина есть у команды
+ * `install-hook`.
+ *
+ * Отдельная тонкость: платформы, где скрипты зависимостей по умолчанию не
+ * исполняются (pnpm 10, yarn berry), зовут этот файл не всегда — тогда хук
+ * ставится при первом запуске инструмента в проекте. Оба пути ведут в одно место. */
+
+import fs from 'fs';
+import path from 'path';
+import { autoInstall } from '../src/hook.js';
+
+/* Каталог проекта-потребителя ищется в порядке убывания точности: `INIT_CWD`
+ * (его ставят npm и pnpm, запуская скрипт пакета), `npm_config_local_prefix`,
+ * затем подъём от текущего каталога вверх до ближайшего `.git`. Подъём нужен,
+ * потому что сам скрипт исполняется из `node_modules`, где репозитория нет. */
+function projectRoot() {
+  const candidates = [process.env.INIT_CWD, process.env.npm_config_local_prefix, process.cwd()];
+  for (const start of candidates) {
+    const found = gitRootOf(start);
+    if (found !== null) return found;
+  }
+  return null;
+}
+
+function gitRootOf(start) {
+  if (typeof start !== 'string' || start === '') return null;
+  let dir = path.resolve(start);
+  for (;;) {
+    if (fs.existsSync(path.join(dir, '.git'))) return dir;
+    const up = path.dirname(dir);
+    if (up === dir) return null;
+    dir = up;
+  }
+}
+
+const root = projectRoot();
+const files = root === null ? null : autoInstall(root, null);
+if (files !== null && process.env.SIZE_REPORT_QUIET !== '1') {
+  console.error('· size-report: хук поставлен (' + files.join(', ') + ') — отчёт обновляется после'
+    + ' каждого коммита; снять: size uninstall-hook');
+}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@vernikr/size-report",
-  "version": "1.3.0",
+  "version": "2.0.0",
   "author": "vernikr",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vernikr/size-report.git"
   },
-  "description": "Учёт роста объёма кода и документов по истории git: raw / min / токены, интерактивный отчёт вне git",
+  "description": "Учёт роста объёма кода и документов по истории git: raw / min / токены; отчёт — один самодостаточный файл, обновляется хуком сам",
   "type": "module",
   "license": "MIT",
   "packageManager": "pnpm@10.6.1",
@@ -32,6 +32,7 @@
   ],
   "sideEffects": false,
   "scripts": {
+    "postinstall": "node bin/postinstall.js",
     "test": "node tools/run-tests.js fast",
     "test:all": "node tools/run-tests.js full",
     "suites:measure": "node tools/run-tests.js measure",
@@ -65,7 +66,7 @@
     "report"
   ],
   "devDependencies": {
-    "@vernikr/size-report": "1.2.0",
+    "@vernikr/size-report": "1.3.1",
     "c8": "10",
     "dependency-cruiser": "17",
     "eslint": "^9.18.0",

package/src/args.js

@@ -21,15 +21,15 @@ import { cliCommand, advicePath, refuseCause } from './refusal.js';
  * места и требует проверки на каждое.
  */
 
-const MODES = ['--init', '--write', '--data', '--page'];
-const VALUE_FLAGS = ['--config', '--init', '--page'];
+const MODES = ['--init', '--write', '--data'];
+const VALUE_FLAGS = ['--config', '--init', '--write'];
 const FLAGS = ['--help', '-h'].concat(MODES, VALUE_FLAGS, ['--json', '--force']);
 const COMMANDS = ['check', 'explain', 'doctor', 'install-hook', 'uninstall-hook', 'hook-run'];
 const ANSWER_COMMANDS = ['check', 'explain', 'doctor'];
 export const HOOK_COMMANDS = ['install-hook', 'uninstall-hook', 'hook-run'];
 
 /* Ключ со значением: забирает следующий аргумент и возвращает, сколько съел. У
- * `--init` и `--page` пустое значение — законное «по умолчанию», а у `--config`
+ * `--init` и `--write` пустое значение — законное «по умолчанию», а у `--config`
  * это молчаливый пропуск: настройки были бы взяты не те, что назвал человек. */
 function takeValue(flag, args, i, values) {
   const next = args[i + 1];
@@ -95,7 +95,7 @@ function checkModes(plan) {
 
 /* Слово, которого команда не знает. Отдельным вопросом, потому что виновников
  * тут двое: опечатка в команде — и лишнее значение режима, который своё значение
- * уже забрал (у `--init` и `--page` оно одно). Оба случая обязаны назвать своего
+ * уже забрал (у `--init` и `--write` оно одно). Оба случая обязаны назвать своего
  * виновника: у `--config` остаток — именно команда, и зов её разбирается как
  * команда, а не как лишнее слово. */
 function checkUnknownWord(plan) {

package/src/artifact.js

@@ -1,28 +1,37 @@
 import fs from 'fs';
 import path from 'path';
-import { build } from './history.js';
-import { render } from './render.js';
+import { reportData } from './data.js';
+import { pageHtml } from './page/build.js';
 
-/* Артефакт на диске: единственное место, где отчёт превращается в файл. Им
- * пользуются оба потребителя — режим `--write` и хук после коммита (`src/hook.js`),
- * поэтому «что записано в файл» не может разойтись между ними: в коммит хук кладёт
- * ровно те байты, которые показывает `--write`.
+/* Отчёт — один файл: самодостаточная страница. Она и есть артефакт, потому что
+ * несёт всё сама (данные, оформление, программу), а второй формы того же отчёта не
+ * существует: два вывода одной истории разошлись бы молча, и выбрать, какой из них
+ * верный, было бы нечем.
  *
- * Каталог создаётся здесь же: `--write .size-report/report.html` в свежем проекте —
- * обычный запуск, а не ошибка пользователя. */
+ * Через это место проходят оба потребителя — режим записи (`--write`) и хук после
+ * коммита (`src/hook.js`), поэтому «что записано в файл» не может разойтись между
+ * ними: в коммит хук кладёт ровно те байты, которые показывает `--write`.
+ *
+ * Каталог создаётся здесь же: `--write docs/size-report.html` в свежем проекте —
+ * обычный запуск, а не ошибка пользователя. Тем же путём пишется черновик настроек
+ * (`--init`), поэтому он один на пакет. */
 
-/* Запись файла с созданием каталога: `--write .size-report/report.html` в свежем
- * проекте — обычный запуск, а не ошибка пользователя. Тем же путём пишутся
- * страница (`--page`) и черновик настроек (`--init`), поэтому он один на пакет. */
+/* Запись файла с созданием каталога: путь может не существовать ни одной своей
+ * частью — это не ошибка того, кто его назвал. */
 export function writeFileEnsured(file, text) {
   fs.mkdirSync(path.dirname(file), { recursive: true });
   fs.writeFileSync(file, text);
 }
 
+/* Собранные байты отчёта без записи: они же нужны проверке (`таблица совпадает с
+ * историей`), и собирать их вторым способом значило бы сверять не то, что пишется. */
+export function artifact(cfg, root) {
+  const data = reportData(cfg, root);
+  return { data: data, html: pageHtml(data, cfg), file: path.join(root, cfg.output) };
+}
+
 export function rebuild(cfg, root) {
-  const { rows, dropped, state } = build(cfg, root);
-  const html = render(rows, cfg);
-  const file = path.join(root, cfg.output);
-  writeFileEnsured(file, html);
-  return { rows: rows, dropped: dropped, state: state, html: html, file: file };
+  const out = artifact(cfg, root);
+  writeFileEnsured(out.file, out.html);
+  return out;
 }

package/src/cli.js

@@ -1,11 +1,12 @@
 import path from 'path';
-import { EXIT, Refusal, USAGE } from './refusal.js';
+import { EXIT, Refusal, USAGE, cliCommand } from './refusal.js';
 import { CONFIG_NAME, gitRoot, loadConfig } from './config.js';
 import { HOOK_COMMANDS, parseArgs } from './args.js';
 import { initMode } from './init.js';
 import { derivedLines } from './project.js';
+import { autoInstall } from './hook.js';
 import {
-  checkMode, coverageMode, dataMode, doctorMode, explainMode, hookMode, jsonMode, pageMode, writeMode
+  checkMode, coverageMode, dataMode, doctorMode, explainMode, hookMode, jsonMode, writeMode
 } from './modes.js';
 
 /* Вход инструмента: разбор строки, чтение проекта и доставка запроса режиму.
@@ -28,13 +29,23 @@ const RUNNERS = {
   check: (c, x) => coverageMode(x.cfg, x.root, x.configFile, c.json),
   explain: (c, x) => explainMode(x.cfg, x.root, c.arg[0], c.json),
   '--data': (c, x) => dataMode(x.cfg, x.root),
-  '--page': (c, x) => pageMode(x.cfg, x.root, c.values['--page']),
-  '--write': (c, x) => writeMode(x.cfg, x.root),
+  '--write': (c, x) => writeMode(x.cfg, x.root, c.values['--write']),
   '': (c, x) => (c.json ? jsonMode(x.cfg, x.root) : checkMode(x.cfg, x.root))
 };
 
 const asked = (cmd) => (cmd.verb === null ? (cmd.mode === null ? '' : cmd.mode) : cmd.verb);
 
+/* Постановка хука без спроса — здесь, а не в `doctor` и не в `hook-run`: первый
+ * только докладывает, а второй зовётся уже из поставленного хука. Ставится один раз
+ * в клоне и называется вслух, дальше молчит: отчёт обновляется после каждого
+ * коммита без ручного шага (устройство и границы — `src/hook.js`). */
+function ensureHook(root, cfg) {
+  const files = autoInstall(root, cfg);
+  if (files === null) return;
+  console.error('· хук поставлен: ' + files.join(', ') + ' — отчёт обновляется после каждого'
+    + ' коммита (снять: ' + cliCommand('uninstall-hook') + ')');
+}
+
 /* Доставка. Диагностика и хук отвечают до чтения настроек: им нужен не весь
  * проект, а окружение, и отказывать им из-за настроек было бы неверно — про
  * настройки они как раз и докладывают. */
@@ -45,6 +56,7 @@ function deliver(cmd, base) {
   // Примечание идёт в stderr: у `--json` и `--data` в stdout лежат данные, и
   // подмешивать в них рассказ о настройках значило бы ломать разбор.
   if (ctx.cfg.derived) derivedLines(ctx.cfg).forEach((line) => console.error(line));
+  ensureHook(base.root, ctx.cfg);
   return RUNNERS[asked(cmd)](cmd, ctx);
 }
 

package/src/config.js

@@ -16,7 +16,7 @@ import { projectConfig } from './project.js';
 export const CONFIG_NAME = 'size-table.config.json';
 
 export const DEFAULT_CONFIG = {
-  output: 'size-table.html',
+  output: 'size-report.html',
   locale: 'ru',
   title: '',          // по умолчанию — заголовок из локали
   heading: '',
@@ -30,9 +30,10 @@ export const DEFAULT_CONFIG = {
   minify: { engine: 'strip', ext: {}, guard: ['.js', '.mjs', '.cjs'] },
   // Токены: каким словарём считать. Семейство — про модели, кодировка — про число.
   tokens: Object.assign({}, TOKEN_DEFAULTS),
-  // Автоматика хука: хук ставится только явной командой (`install-hook`), а этот
-  // ключ — её выключатель (`.size-report/…` не нужен: снятие хука возвращает
-  // проект к прежнему поведению).
+  // Автоматика хука: хук обновляет отчёт после каждого коммита и ставится сам —
+  // после установки пакета (`bin/postinstall.js`) и при первом запуске в проекте
+  // (`src/hook.js`); этот ключ — её выключатель (`.size-report/…` не нужен: снятие
+  // хука возвращает проект к прежнему поведению).
   hooks: { enabled: true },
   journal: null,
   links: { commitUrl: '' },