@vernikr/size-report 1.1.1 → 1.3.0

package/CHANGELOG.md

@@ -18,6 +18,109 @@
 где за основу взяты `fixtures/synthetic/config.json`, метрики — `raw`, `min`, `tok`, а
 способ минификации — `strip` или `esbuild`.
 
+## 1.3.0 — 2026-09-15
+
+Выпуск выведенных настроек: чтобы получить отчёт, проект больше не обязан себя
+описывать.
+
+- **Файла настроек может не быть.** Их выводит сам инструмент — по проекту: колонками
+  крупнейшие файлы, по одному от каждого расширения (иначе отчёт состоял бы из одних
+  крупных `.md`, и ни один `.js` не попал бы под настоящее сжатие), журналом — первый
+  знакомый (`WORKLOG.md`, `CHANGELOG.md`, …), файлом отчёта — `docs/`, если каталог есть,
+  командой починки — объявленный скрипт `sizes`, а без него путь к установленному
+  пакету внутри проекта, ссылкой на коммит — адрес `origin` (GitHub или GitLab: у
+  остальных хозяев пусто, догадка вела бы не туда), метриками — `raw`, `min`, `tok`.
+  Команда починки и ссылка берутся готовыми, а не выдуманными: её цитируют подпись
+  отчёта и отказы, и зов скрипта, которого в проекте ещё нет, ответил бы «нет такого
+  скрипта» ровно там, где человеку нужна работающая команда.
+- **Всё, что колонкой быть не может или в неё не поместилось, названо в `skip`** (сам
+  отчёт, замки зависимостей, карты, собранное): поэтому первый же `size check` полон, а не
+  красный, — «пути мимо колонок» появляются от новых правок, а не от того, что проект ещё
+  не настраивали. Колонка — это файл: список путей колонки движок читает как её
+  переименования, поэтому «папка целиком» колонкой не бывает.
+- **О выведенных настройках сказано строкой** в stderr, с готовой командой `--init` —
+  она их закрепляет, и дальше их правят как обычные настройки. Закрепляется то же,
+  чем проект работает без файла (вывод поверх умолчаний), поэтому смена умолчаний в
+  новой версии пакета не поедет по уже настроенному проекту молча. Без закрепления
+  профиль выводится на каждом запуске: числа не «поехали», но повторить прежний замер
+  можно только закрепив его.
+- **Отказ остался у названного файла:** `--config <файл>`, которого нет, — код 2 с той же
+  починкой `--init <файл>` (опечатку в пути покрывать догадкой нельзя). У умолчательного
+  имени отказа нет вовсе; коды выхода ни в одном другом случае не изменились.
+- Номер **1.3.0** — по SemVer: появилась возможность, которой не было; схема данных
+  (`schema: 1`) та же.
+
+### Что изменится в числах
+
+**У кого настройки есть — ничего.** Этот выпуск не трогает ни форму отчёта, ни счёт:
+таблица ниже та же, что у 1.2.0.
+
+**У кого настроек нет** — числа появятся там, где был отказ (код 2): их даст выведенный
+профиль. Выведенное и закреплённое (`--init`) друг от друга не отличаются: файл — это тот
+же профиль, только записанный. Повторить замер можно только по закреплённому: без файла
+профиль выводится заново каждый запуск.
+
+| Файл | 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.2.0 — 2026-09-15
+
+Выпуск причины, а не измерения: проверка («таблица совпадает с историей?») теперь
+называет другой счёт, когда он есть, — и делает это всегда, а не только там, где
+всё сошлось. Нашлось это прогулкой по собственной инструкции (`WORKLOG.md` §54),
+починено по правилу «нарушение старше приближения» (`REFACTOR.md` R-4.23).
+
+- **`size` и `size check` печатают заметку о датчике всегда.** Раньше заметка
+  печаталась только при благополучном вердикте: если отчёт собран с настоящим
+  минификатором, а прогон идёт без него (установка без необязательных
+  зависимостей, платформа без `esbuild`), числа честно расходились, а причины
+  «счёт другой» в выводе не было вовсе — читатель видел расхождение строки
+  подписи и ничего о том, откуда оно.
+- **Вердикт остаётся первым по важности.** Нарушение старше приближения — тот же
+  порядок, что у `size check` и `size doctor`: код **4** утверждал бы, что
+  расхождение объясняется датчиком, а этого никто не проверял (расхождение может
+  быть и правкой мимо отчёта). Поэтому ответ в этом случае — по-прежнему **код 1**
+  плюс заметка с починкой: кода выхода выпуск не меняет ни в одном случае.
+- Ни сборка отчёта, ни его форма, ни смысл настроек не тронуты. Остальное в этом
+  выпуске — не про поставку: выпуск по тегу из CI (R-4.24) и снятые цели по
+  времени у набора проверок (R-5.8) касаются репозитория пакета, а не того, что
+  устанавливают.
+- Номер **1.2.0** назван владельцем пакета; по строгому SemVer содержимое —
+  исправление (PATCH): новых возможностей в поставке нет.
+
+### Что изменится в числах
+
+**Ничего.** Таблица ниже та же, что у 1.1.0 и 1.1.1, до последней клетки: этот
+выпуск меняет текст под расхождением, а не числа. Замер на фикстуре — тот же
+(16 коммитов, 10 колонок), доказано не словом: артефакт (22 112 Б), страница
+(59 376 Б) и оба замороженных эталона не переснимались, а `--json` и артефакт
+побайтово равны эталону на фикстуре и на живой истории проекта-потребителя.
+
+| Файл | 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.1.1 — 2026-09-15
 
 Выпуск имени, а не измерения: пакет переехал в область владельца