@vernikr/size-report 2.0.0 → 2.0.1

package/CHANGELOG.md

@@ -18,6 +18,37 @@
 где за основу взяты `fixtures/synthetic/config.json`, метрики — `raw`, `min`, `tok`, а
 способ минификации — `strip` или `esbuild`.
 
+## 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.1 (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.1`, `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.1
 ```
 
 Без сети (или если тянуть из codeload нечем) — тарболл: `pnpm pack` в клоне
-пакета, затем `pnpm add -D ./vernikr-size-report-2.0.0.tgz`.
+пакета, затем `pnpm add -D ./vernikr-size-report-2.0.1.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.1`, он же и в
 примере (сорок знаков тоже годятся, но их придётся брать глазами из истории).
 
 Ревизия в примере — не украшение, а часть утверждения: она закреплена за тем, что
@@ -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` полон) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vernikr/size-report",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "author": "vernikr",
   "repository": {
     "type": "git",
@@ -66,7 +66,7 @@
     "report"
   ],
   "devDependencies": {
-    "@vernikr/size-report": "1.3.1",
+    "@vernikr/size-report": "2.0.0",
     "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-файлу, а не догадкой: команда обязана существовать