@vernikr/size-report 2.0.1 → 2.0.2

package/CHANGELOG.md

@@ -18,6 +18,38 @@
 где за основу взяты `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`, и каталог создаётся сам.

package/README.md

@@ -10,7 +10,7 @@
 
 ## Статус
 
-**Выпуск 2.0.1 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
+**Выпуск 2.0.2 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
 реестре — `@vernikr/size-report` (публикуется тегом из CI, без секрета). Настроек
 проект может не заводить вовсе: без файла инструмент выводит их из самого проекта и
 говорит об этом строкой, а `--init` закрепляет выведенное файлом (чем этот шаг
@@ -643,7 +643,7 @@ pnpm add -D @vernikr/size-report
 ```
 
 Пакет **опубликован в реестре**, и публично: `npm view @vernikr/size-report
-version` отвечает `2.0.1`, `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` принимают то же
 имя; ни ключа, ни ссылки на репозиторий не нужно.
 
@@ -651,11 +651,11 @@ version` отвечает `2.0.1`, `npm access get status @vernikr/size-report`
 реестра, но остаётся привязанной к ревизии:
 
 ```bash
-pnpm add -D github:vernikr/size-report#v2.0.1
+pnpm add -D github:vernikr/size-report#v2.0.2
 ```
 
 Без сети (или если тянуть из codeload нечем) — тарболл: `pnpm pack` в клоне
-пакета, затем `pnpm add -D ./vernikr-size-report-2.0.1.tgz`.
+пакета, затем `pnpm add -D ./vernikr-size-report-2.0.2.tgz`.
 
 **Почему тег, а не sha.** Короткий sha pnpm разрешает только через видимые рефы, а
 `git ls-remote` отдаёт одни верхушки веток: пока ревизия — верхушка, короткий sha
@@ -663,7 +663,7 @@ pnpm add -D github:vernikr/size-report#v2.0.1
 <sha> to a commit`. Это не рассуждение, а проба: короткий пин `6530237` ставился,
 пока `main` стоял на нём, и перестал — на следующем же коммите, а тот же sha
 целиком поставился. Имя ветки (`#main`) или тег принимаются оба, но ветка —
-движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v2.0.1`, он же и в
+движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v2.0.2`, он же и в
 примере (сорок знаков тоже годятся, но их придётся брать глазами из истории).
 
 Ревизия в примере — не украшение, а часть утверждения: она закреплена за тем, что
@@ -836,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.1",
+  "version": "2.0.2",
   "author": "vernikr",
   "repository": {
     "type": "git",
@@ -66,7 +66,7 @@
     "report"
   ],
   "devDependencies": {
-    "@vernikr/size-report": "2.0.0",
+    "@vernikr/size-report": "2.0.1",
     "c8": "10",
     "dependency-cruiser": "17",
     "eslint": "^9.18.0",

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