@vernikr/size-report 2.0.0 → 2.0.2

package/CHANGELOG.md

@@ -18,6 +18,69 @@
 где за основу взяты `fixtures/synthetic/config.json`, метрики — `raw`, `min`, `tok`, а
 способ минификации — `strip` или `esbuild`.
 
+## 2.0.2 — 2026-09-15
+
+Инструкция перестала обещать лишний ручной шаг и назвала платформенную разницу.
+
+- **README учил ставить хук руками.** В §6 осталась строка прежнего выпуска — «хуки
+  ставятся только командой `install-hook`, ни один обычный запуск их не создаёт», — а с
+  2.0.0 постановка своя (`bin/postinstall.js` и первый запуск). Текст теперь говорит то,
+  что делает код, и называет единственное исключение: pnpm 10 не исполняет скрипты
+  зависимостей («Ignored build scripts») — там хук ставит первый запуск, либо сборка
+  разрешается `pnpm.onlyBuiltDependencies` в манифесте потребителя.
+- **Названа одна ручная ступень, которая была невидимой.** Первый отчёт создаётся, но не
+  коммитится (новый файл в чужой истории — решение человека): это сказано в §6 и в
+  шаблоне `templates/README.md`, дальше отчёт обновляется отдельными коммитами сам.
+
+### Что изменится в числах
+
+**Ничего.** Правка — только текст инструкции; движок тот же, что у 2.0.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** |
+
+## 2.0.1 — 2026-09-15
+
+Место отчёта в свежем проекте: `docs/size-report.html`, и каталог создаётся сам.
+
+- **Отчёт больше не ложится в корень.** Первая редакция вывода выбирала «рядом с
+  доками, если каталог `docs` есть, иначе в корне»: в проекте, который только что
+  поставил пакет, каталога ещё нет — и отчёт оказывался там, где его не ищут (замер:
+  свежий клон, установка из реестра, `docs/` не появился, файл лёг в корень). Теперь
+  адрес один: `docs/size-report.html`; каталог — часть адреса, а создаёт его тот, кто
+  пишет файл. Имя из настроек по-прежнему перебивает вывод.
+- Стережёт это проверка: проект без настроек и без каталога `docs` — отчёт в `docs/`,
+  в корне его нет, контрольный режим зелёный.
+
+### Что изменится в числах
+
+**Ничего.** Правка — про путь файла, а не про измерение. Таблица та же, что у 2.0.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** |
+
 ## 2.0.0 — 2026-09-15
 
 Один отчёт вместо двух, и он же появляется сам: форма отчёта сведена к одному

package/README.md

@@ -10,7 +10,7 @@
 
 ## Статус
 
-**Выпуск 2.0.0 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
+**Выпуск 2.0.2 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
 реестре — `@vernikr/size-report` (публикуется тегом из CI, без секрета). Настроек
 проект может не заводить вовсе: без файла инструмент выводит их из самого проекта и
 говорит об этом строкой, а `--init` закрепляет выведенное файлом (чем этот шаг
@@ -219,10 +219,10 @@
 
 | Прогон | Команда | Проверок |
 |---|---|---|
-| Быстрый — каждая правка | `pnpm test` | **65 из 168** |
-| Полный — выкладка и CI | `pnpm test:all` | **168** |
+| Быстрый — каждая правка | `pnpm test` | **65 из 169** |
+| Полный — выкладка и CI | `pnpm test:all` | **169** |
 
-Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 168 теми же
+Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 169 теми же
 файлами, а быстрый берёт их часть. Умолчание — полный: файл становится быстрым только
 явно и с причиной, поэтому новое дорогое не может тихо уехать в быстрый. Стерегут это
 объявление `test/suites.test.js` (полнота классификации и причина у каждого файла) и
@@ -480,6 +480,7 @@ deльт задан один раз и по артефакту: рост зел
 | `PLAN.md` | **Главный документ:** инвентаризация, границы, инварианты, архитектура, семь шагов переноса, приёмка, риски, открытые вопросы |
 | `docs/requirements.md` | Требования заказчика: что и зачем |
 | `docs/module-design.md` | Архитектурный проект выноса: как устроен модуль |
+| `docs/size-report.html` | Отчёт об объёме этого самого проекта: один самодостаточный файл, который обновляет хук после каждого коммита (отдельным коммитом) |
 | `WORKLOG.md` | Журнал запросов и сделанного |
 | `BLOCKERS.md` | Открытые блокеры и известные пробелы (обход обязан держаться проверкой) |
 | `REFACTOR.md` | Поканальный план чистки: объём кода, потом скорость; границы и чем доказывается, что поведение не изменилось |
@@ -642,7 +643,7 @@ pnpm add -D @vernikr/size-report
 ```
 
 Пакет **опубликован в реестре**, и публично: `npm view @vernikr/size-report
-version` отвечает `2.0.0`, `npm access get status @vernikr/size-report` — `public`,
+version` отвечает `2.0.2`, `npm access get status @vernikr/size-report` — `public`,
 а анонимный запрос тарболла — код 200. `npm i -D` и `yarn add -D` принимают то же
 имя; ни ключа, ни ссылки на репозиторий не нужно.
 
@@ -650,11 +651,11 @@ version` отвечает `2.0.0`, `npm access get status @vernikr/size-report`
 реестра, но остаётся привязанной к ревизии:
 
 ```bash
-pnpm add -D github:vernikr/size-report#v2.0.0
+pnpm add -D github:vernikr/size-report#v2.0.2
 ```
 
 Без сети (или если тянуть из codeload нечем) — тарболл: `pnpm pack` в клоне
-пакета, затем `pnpm add -D ./vernikr-size-report-2.0.0.tgz`.
+пакета, затем `pnpm add -D ./vernikr-size-report-2.0.2.tgz`.
 
 **Почему тег, а не sha.** Короткий sha pnpm разрешает только через видимые рефы, а
 `git ls-remote` отдаёт одни верхушки веток: пока ревизия — верхушка, короткий sha
@@ -662,7 +663,7 @@ pnpm add -D github:vernikr/size-report#v2.0.0
 <sha> to a commit`. Это не рассуждение, а проба: короткий пин `6530237` ставился,
 пока `main` стоял на нём, и перестал — на следующем же коммите, а тот же sha
 целиком поставился. Имя ветки (`#main`) или тег принимаются оба, но ветка —
-движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v2.0.0`, он же и в
+движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v2.0.2`, он же и в
 примере (сорок знаков тоже годятся, но их придётся брать глазами из истории).
 
 Ревизия в примере — не украшение, а часть утверждения: она закреплена за тем, что
@@ -736,7 +737,7 @@ 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-report.html`, если каталог `docs/` есть, иначе в корне; имя отчёта — его имя, а каталог решает только где ему лежать) |
+| `output` | файл отчёта (в выведенном профиле — `docs/size-report.html`; каталог создаётся сам, имя отчёта — его имя) |
 | `journal` | где искать разделы журнала, на которые ссылаются строки |
 | `links.commitUrl` | шаблон ссылки на коммит, например `https://github.com/org/repo/commit/{sha}`; выводится из адреса `origin` у GitHub и GitLab (у остальных хозяев — пусто, а не догадка) |
 | `skip` | пути, которые колонкой не стали: и те, что ею быть не могут (сам отчёт, замки зависимостей), и те, что в колонки не поместились (выведенный профиль объявляет исключениями всё остальное — поэтому первый `check` полон) |
@@ -835,18 +836,26 @@ pnpm exec size doctor     # 0 — делать нечего; иначе перв
 | 4 | нет датчика | `minify.engine: "esbuild"`, а минификатора нет: числа получены упрощением. Отчёт собран, причина и починка — в тексте; если при этом таблица расходится с историей, код остаётся **1** (нарушение старше приближения), а заметка о другом счёте печатается рядом |
 | 5 | внутренняя ошибка | это дефект инструмента: текст нужен нам, см. «Ловушки» ниже |
 
-### 6. Отчёт обновляется сам после коммита (по желанию)
+### 6. Отчёт обновляется сам после коммита
 
 ```bash
 pnpm exec size install-hook     # поставить post-commit и post-merge
 pnpm exec size uninstall-hook   # снять и вернуть проект к прежнему поведению
 ```
 
-Хуки ставятся **только этой командой**: ни один обычный запуск их не создаёт и
-проект до неё не меняется (файлы живут в `.git`, `git status` их не видит). После
-каждого коммита и слияния отчёт пересобирается, а если он лежит в git — ложится
-отдельным коммитом с подписью `chore(report): отчёт пересобран после <sha>`.
-Коммитится только путь отчёта: чужой индекс и незакоммиченная работа не тронуты.
+Хуки ставятся **сами**, и это единственное, что проект замечает от установки пакета:
+после `npm i` — скриптом установки, у pnpm 10 — первым запуском инструмента (pnpm не
+исполняет скрипты зависимостей: «Ignored build scripts»; разрешить можно
+`pnpm.onlyBuiltDependencies: ["@vernikr/size-report"]` в своём манифесте). Ставшие
+файлы живут в `.git`, `git status` их не видит, снимаются командой выше. После
+каждого коммита и слияния отчёт пересобирается: каталог `docs` и файл `size-report.html`
+создаются, если их ещё нет, а **отслеживаемый** в git отчёт ложится отдельным коммитом
+с подписью `chore(report): отчёт пересобран после <sha>`. Коммитится только путь отчёта:
+чужой индекс и незакоммиченная работа не тронуты.
+
+Первый отчёт — исключение из «сам»: файл создан, но не закоммичен, потому что новый
+файл в чужой истории — решение человека, а не услуга. Один `git add docs/size-report.html`
+(или обычный `git add -A`, если отчёт нужен в проекте) — и дальше он едет коммитами сам.
 Слияние обрабатывается тем же входом, что обычный коммит, но другим файлом —
 `post-merge`: git создаёт коммит слияния сам и `post-commit` при этом не зовёт.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vernikr/size-report",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "author": "vernikr",
   "repository": {
     "type": "git",
@@ -66,7 +66,7 @@
     "report"
   ],
   "devDependencies": {
-    "@vernikr/size-report": "1.3.1",
+    "@vernikr/size-report": "2.0.1",
     "c8": "10",
     "dependency-cruiser": "17",
     "eslint": "^9.18.0",

package/src/project.js

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

package/templates/README.md

@@ -56,7 +56,7 @@ README и журнал колонкой не отслеживаются, — т
   именно этот объект выводит `size --init`, когда журнал в проекте есть.
 - `paths` внутри колонки — псевдонимы одного файла: если файл переименовывали,
   перечислите и старое имя, и новое, и колонка не разорвётся.
-- `output: "docs/size-report.html"` — файл отчёта (он один: самодостаточная страница со всеми числами, фильтрами и ссылкой); каталог инструмент создаст сам, а хук — тоже: после установки пакета и первого запуска отчёт обновляется после каждого коммита без ручного шага.
+- `output: "docs/size-report.html"` — файл отчёта (он один: самодостаточная страница со всеми числами, фильтрами и ссылкой); каталог инструмент создаст сам. Хук обновления ставится сам — скриптом установки (npm, yarn) или первым запуском (pnpm 10 не исполняет скрипты зависимостей, если не разрешить `pnpm.onlyBuiltDependencies`), и после каждого коммита отчёт пересобирается. Первый отчёт остаётся неотслеживаемым, пока вы не добавите его в git; дальше он обновляется коммитами сам.
 
 ## Проверка в CI