@vernikr/size-report 2.4.0 → 2.6.0

package/CHANGELOG.md

@@ -1,690 +0,0 @@
-# CHANGELOG
-
-История выпусков `@vernikr/size-report`. Версии — SemVer (`PLAN.md` §8.2); версия данных —
-`schema: 1`, она заморожена выпуском 1.0.0 и меняется только вместе с MAJOR.
-
-## Что значит «изменились числа»
-
-Числа этого инструмента — его продукт, а не отладочная печать: у каждой метрики есть
-источник (`raw` — размер объекта git, `min` — сжатая форма, `tok` — токены) и есть
-честность (точный счёт или приближение с пометкой). Поэтому у выпуска обязателен
-раздел «Что изменится в числах»: он отвечает, **у кого числа поедут и почему**.
-Выпуск, после которого число меняется молча, — дефект этого инструмента, а не выпуск.
-
-Замеры в этих разделах сняты на фикстуре пакета — `fixtures/synthetic/history.bundle`,
-16 коммитов и 10 колонок, состояние на её верхушке. Таблица выпуска не пересказ: её
-сверяет с живым прогоном инструмента `test/changelog.test.js`, а повторить замер
-руками можно, склонировав бандл и прогнав `node bin/size.js --config <настройки> --data`,
-где за основу взяты `fixtures/synthetic/config.json`, метрики — `raw`, `min`, `tok`, а
-способ минификации — `strip` или `esbuild`.
-
-## 2.4.0 — 2026-09-15
-
-Вид дерева и порядок колонок: чего в отчёте нет — после остальных и со снятой
-галочкой, колонки последнего коммита — впереди, складка папки не считает числа.
-
-- **Файл вне отчёта был подписью без галочки, а папка, где измерять нечего, —
-  без неё вовсе.** Один и тот же вопрос — «почему у этого нет числа» — читался
-  по-разному в двух строках подряд, а рядом с колонками такие строки выбивались из
-  ряда. Теперь у всего, что вне отчёта, галочка **стоит на месте, снята и
-  недоступна**: ряд строк ровный (глаз сравнивает одно с одним), а недоступность
-  говорит, что это не выбор читателя, — причина во всплывающей строке, как и
-  раньше. Заодно всё, чего в отчёте нет (и папки, и листья), идёт **после** того,
-  что в нём есть: в списке, где половина строк не переключается, отчёт виден сразу,
-  а не среди чужого.
-- **Складывание папки считало числа, которых не меняет.** Клик по знаку пересобирал
-  панель и таблицу целиком — то есть платил за всю таблицу (в этом репозитории 97
-  строк × 136 колонок, 39 576 клеток) ради того, чтобы спрятать строки. Замер в
-  настоящем Chrome на этой же странице: **107 + 380 мс** перерисовки — столько же,
-  сколько стоит переключение одного файла. Стало **0,6 мс** в обработчике (и 6 мс на
-  перекладку страницы, которая прячет 42 строки): поддерево лежит в разметке и
-  прячется классом на строке, а клик меняет только то, что читатель и видит, —
-  класс, знак и запись в памяти.
-- **Колонки, которых коснулся последний коммит, идут впереди остальных.** Отчёт
-  пересобирается после каждого коммита, и первый вопрос читателя — что принесла эта
-  правка. Знак приходит из истории (`last` в контракте `--data`), а не из чисел:
-  правка без изменения размера — тоже правка. Берётся последний коммит, задевший
-  хотя бы одну колонку: коммиты мимо колонок (и прежде всего сам отчёт, который
-  коммитит хук) пропускаются — иначе знак зависел бы от собственного коммита
-  отчёта, тот же прогон давал бы другие байты, и хук коммитил бы отчёт второй раз
-  на пустом месте. Внутри каждой части порядок прежний, из настроек.
-
-### Что изменится в числах
-
-**Ничего.** Числа считает тот же движок теми же датчиками: выпуск про то, что и в
-каком порядке видно на странице, а не про измерение. Таблица та же, что у 2.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** |
-
-## 2.3.0 — 2026-09-15
-
-Отчёт описывает проект целиком: колонкой идёт каждый отслеживаемый файл, а дерево
-складывается.
-
-- **Колонками была выборка из проекта.** Без файла настроек инструмент брал
-  двенадцать крупнейших файлов — по одному от каждого расширения — и называл
-  прочие исключениями. Отчёт при этом считал «общий объём» по горсти файлов, и
-  читатель принимал это за объём проекта (в этом репозитории — 12 файлов из 148).
-  Теперь колонка — **каждый отслеживаемый git файл, который можно измерить**, и
-  `skip` называет только то, что колонкой быть не может: сам отчёт, замки
-  зависимостей, карты, собранное, незнакомый формат, файл сверх 512 КБ — и путь,
-  которого на HEAD нет (он живёт только в истории: измерять в нём нечего).
-- **Цена названа замером** (этот же репозиторий, 149 коммитов, 135 колонок против
-  12): сборка отчёта 2,4 с → **6,3 с**, файл отчёта 122 КБ → **417 КБ**, `check` —
-  6,1 с. Отчёт пересобирает хук после каждого коммита, поэтому столько теперь стоит
-  и каждый коммит; кому это дорого — колонки задают файлом настроек (`size --init`
-  даёт черновик, дальше его правят: прежний выбор воспроизводится списком из
-  двенадцати файлов).
-- **Дерево складывается.** У каждой папки свой знак (▾/▸): он отвечает за то,
-  сколько дерева видно, а галочка — за то, что считается, и потому это две разные
-  цели нажатия, а не одна. Сложенное помнится между заходами и **не уезжает в
-  ссылку**: ссылку отправляют ради чисел, а не ради того, как у кого разложено
-  дерево. Запись у складывания своя (тот же паспорт отчёта), разворот всех папок её
-  убирает — как и возврат галочек. На 148 путях проекта это единственный способ
-  добраться до его середины.
-- **Вклейка программы страницы получила сторож.** Модульный синтаксис снимается
-  построчно, поэтому многострочный `import` оставлял в странице хвост и ломал её
-  целиком — теперь проверка ищет в вклеенной программе и имя модуля, а не только
-  начало строки.
-
-### Что изменится в числах
-
-**Колонка — каждый отслеживаемый файл, поэтому там, где настройки не заданы, колонок
-станет больше** (в этом репозитории 12 → 135), а вместе с ними вырастут «общий объём»
-(он и раньше считался по колонкам) и время прогона — оно названо выше. Числа ниже
-замерены на фикстуре, где колонки заданы файлом настроек: такой проект замер видит
-точно так же, как 2.2.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.2.0 — 2026-09-15
-
-Дерево страницы — дерево проекта: видно всё, числа есть у измеряемых.
-
-- **В дереве было видно только то, что стало колонками.** В проекте со 147 файлами
-  и выведёнными настройками колонок двенадцать — дерево и показывало двенадцать
-  листьев, а про остальные молчало: читатель видел не дерево проекта, а список
-  измеренного, и решить, что файлы потерялись, было проще всего. Теперь в контракте
-  (`--data`) едет **каталог** — все пути, которые видит git (`ls-files`), — и дерево
-  строится по нему.
-- **Числа — только у колонок, и это видно, а не подразумевается.** Лист вне отчёта
-  стоит на своём месте, но подписью без галочки, а причина — во всплывающей строке,
-  и причин две: `rule` — такой файл колонкой быть не может (сам отчёт, замок
-  зависимостей, собранное, слишком крупный или формат без текста), `choice` — мог бы,
-  но в набор колонок не выбран (его задают настройки). Знак причины движок ставит
-  **теми же** правилами, по которым выбирает колонки, — иначе подсказка говорила бы
-  одно, а выбор делал другое. Сам отчёт в дереве назван **всегда** — и пока не
-  собран, и когда он вне git: его отслеживаемость это свойство момента, и зависеть
-  от неё отчёт не должен (иначе первая же пересборка в свежем клоне даёт другие
-  байты, и хук коммитит отчёт второй раз на пустом месте).
-- **Счётчик папки со смешанным составом — доля** («2/5»: два файла в отчёте из
-  пяти в папке), а целиком измеряемая папка считает как раньше («5»). Папка, где
-  измеряемых нет вовсе, галочки не получает: включать в ней нечего, но на месте она
-  остаётся — дерево не должно врать о том, что в проекте есть.
-- **Цена названа:** набор колонок этим не меняется, поэтому прогон не подорожал.
-  Замер на этом же проекте (162 колонки × 79 строк против 12): с токенами 16,1 с
-  вместо 2,4 с, а на живой истории полный набор ещё и отказывает (перенос состояния
-  теряет правку пути, которого нет на HEAD) — поэтому «мерить всё» решением не стало.
-
-### Что изменится в числах
-
-**Ничего.** Числа считает тот же движок теми же датчиками: выпуск про то, что видно в
-дереве панели, а не про измерение. Таблица та же, что у 2.1.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.1.0 — 2026-09-15
-
-Вид страницы на десктопе: числам — вся оставшаяся высота, панели — своя прокрутка.
-
-- **Под таблицей была пустота, а список файлов задавал высоту страницы.** На широком
-  экране оба столбца шли каждый со своей высотой (`align-items: start`), поэтому
-  высота страницы равнялась тому, что вышло у панели: замер до правки при окне
-  1440×900 — панель 883 px, страница 1097 при окне 900, под таблицей 195 px пустоты,
-  а нижние файлы дерева — за нижним краем окна (список при этом ещё и резался своим
-  потолком в 62vh). Теперь страница целиком укладывается в окно: строки сетки
-  названы по предмету, тянется одна рабочая — таблица берёт всю оставшуюся высоту
-  (1440×900: 1060 × 735 вместо 602), панель — не больше неё и прокручивается сама
-  (содержимое 804 при высоте 785). Список файлов на широком экране больше не режется:
-  все 23 подписи дерева видны сразу.
-- **Клик по галочке возвращал список к началу.** Панель рисуется заново, и вместе с
-  ней терялось место, до которого докурили: до нижних файлов дерева было не
-  добраться. Прокрутка панели и списка теперь часть вида — запоминается перед
-  пересборкой и ставится обратно (подтверждено в Chrome: при окне 1440×500
-  `panel.scrollTop` = 421 до клика и 421 после).
-- **Строка категорий липнет** к верху панели, пока листается дерево. Чтобы под
-  липкой строкой не читались проезжающие файлы, верхний отступ панели переехал в
-  первое поле: прокручиваемое видно и в отступе прокрутки (в полосе 13 px читались
-  `parity/` и `data.json` — теперь там сама строка).
-- **Расшифровка под деревом убрана**, а шрифт подписей файлов стал как у чисел
-  таблицы (12,5 px): расшифровка отодвигала числа, а её смысл стоит у того, что
-  объясняет — цвет дельты называет знак числа, способ и точность стоят под
-  переключателями метрик, знак пропуска — в подсказке клетки.
-- **Граница широкой раскладки — 899 px.** При ровно 900 px обе половины оформления
-  применялись к одной странице, и от «узкой» в «широкой» оставался потолок высоты
-  таблицы: те же пустые 179 px под ней на одном размере окна.
-
-### Что изменится в числах
-
-**Ничего.** Правка — про вид страницы и прокрутку; движок тот же, что у 2.0.2, а
-страница получает от него готовые числа.
-
-| Файл | 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.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
-
-Один отчёт вместо двух, и он же появляется сам: форма отчёта сведена к одному
-файлу, а обновление — к одному решению (хук ставится сам).
-
-- **Отчёт — один файл: самодостаточная страница `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
-
-Выпуск выведенных настроек: чтобы получить отчёт, проект больше не обязан себя
-описывать.
-
-- **Файла настроек может не быть.** Их выводит сам инструмент — по проекту: колонками
-  крупнейшие файлы, по одному от каждого расширения (иначе отчёт состоял бы из одних
-  крупных `.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
-
-Выпуск имени, а не измерения: пакет переехал в область владельца
-(`@vernikr/size-report`) — имя `size-report` в реестре занято чужим пакетом, и
-опубликоваться под ним было нельзя (`PLAN.md` §10). Заодно в поставку вошёл файл
-лицензии, которого манифест обещал, а в дереве не было.
-
-- **Имя пакета — `@vernikr/size-report`.** `bin` остался `size`, установка —
-  `pnpm add -D @vernikr/size-report`, зов — `pnpm exec size`.
-- Тот же выпуск закрывает три правки после 1.1.0: совет отказа проверяется
-  исполнением, а не на слово (`REFACTOR.md` R-4.22), якорь фикстуры выведен из
-  дерева в историю (R-1.5, R-3.4) и числа переименования в `PLAN.md` §10 сверены
-  с фактом.
-- **Имя инструмента в данных (`--data`) совпадает с именем пакета** — оно же
-  входит в паспорт отчёта, от которого зависят ключ памяти страницы и якорь
-  ссылки. Поэтому у отчёта, пересобранного этим выпуском, **сохранённый выбор
-  читателя в браузере не подхватится один раз**: запись прошлого выпуска лежит
-  под другим ключом. Числа и разметка от этого не меняются, а первый читатель и
-  так видит умолчание.
-- В поставку добавлен `LICENSE` (MIT) — манифест называл лицензию, а файла в
-  тарболле не было.
-
-### Что изменится в числах
-
-**Ничего.** Это не обещание, а замер: таблица ниже снята выпуском 1.1.1 и
-совпадает с таблицей 1.1.0 до последней клетки — измерение этот выпуск не трогает
-вовсе, а правки лежат в имени пакета, текстах отказов и выводе якоря фикстуры.
-Доказано не словом: вывод `--json` и артефакт побайтово равны замороженному
-эталону на фикстуре и на живой истории проекта-потребителя, а его закоммиченная
-таблица пересобирается в те же байты (`sha256 863ce3e9…`).
-
-| Файл | 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.0.0 и 1.1.0, и читаются так же: `raw` — размер объекта
-git; `min` со `strip` — упрощение, под которым снят эталон паритета; `min` со
-`esbuild` — то, что даёт настоящий минификатор (`minify.engine`); `tok` — словарь
-`o200k_base` с `gpt-tokenizer 4.0.0`. У проекта прежние настройки означают
-`strip`, поэтому обновление «само» чисел не меняет. gzip в выпуск по-прежнему не
-входит (`PLAN.md` §10, D4).
-
-## 1.1.0 — 2026-09-15
-
-Первый выпуск после 1.0.0, и в нём **ни одной правки измерения** — только то, что
-нашлось живыми прогонами после выпуска, все в ответах инструмента человеку.
-
-- `explain` понимает то, чем коммиты зовут на самом деле: `HEAD`, ветку, тег,
-  `HEAD~1`, полный и короткий sha. Раньше имя ревизии выглядело как несуществующий
-  коммит («в истории нет коммита «HEAD»») — то есть отказ называл не ту причину.
-  Коммит вне истории отчёта теперь отдельная причина с названным sha.
-- У отказов появился **каталог и сторож** (`tools/refusals.js`): по строке на
-  каждый отказ с кодом выхода и обязательными фразами, карты мест отказа держат
-  числа, а две проверки делят обе половины обещания — одна вызывает отказ, другая
-  требует у каждого места пункт каталога. Новый отказ не может появиться без
-  проверки. Заодно исправлены шесть мест, где текст врал или молчал о починке, и
-  появилась одна новая причина: **`нет git`** — раньше «git не запустился» и
-  «здесь нет репозитория» назывались одним текстом с оговоркой «или», то есть не
-  назывались вовсе.
-- Проверка настроек отвергает колонку, у которой путь — не непустая строка
-  (`"paths": [123]`): раньше такая колонка ни с чем не совпадала, а отчёт отдавал
-  нули **за успех**.
-- `--init` в каталоге без знакомых расширений больше не печатает «✗» при коде
-  выхода 0: знак и код говорили разное.
-- **Репозиторий пакета стал публичным**, поэтому установка не требует ни ключа,
-  ни токена, ни шага в CI: `github:` pnpm разрешает в архив `codeload.github.com`
-  по HTTPS (`WORKLOG.md` §44).
-
-### Что изменится в числах
-
-**Ничего.** Это не обещание, а замер: таблица ниже снята выпуском 1.1.0 и совпадает
-с таблицей 1.0.0 до последней клетки — метрики, настройки по умолчанию и датчики те
-же, а правки этого выпуска лежат в текстах отказов, разборе аргументов командной
-строки и проверке настроек, куда измерение не заходит. Доказано не словом: вывод
-`--json` и артефакт побайтово равны замороженному эталону на фикстуре и на живой
-истории проекта-потребителя, а его закоммиченная таблица (211 КБ) тем же выпуском
-пересобирается в те же байты (`sha256 863ce3e9…`).
-
-| Файл | 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.0.0, и читаются так же: `raw` — размер объекта git (ни от
-чего, кроме него, не зависит); `min` со `strip` — умолчание, под которым снят
-эталон паритета; `min` со `esbuild` — то, что даёт настоящий минификатор, если его
-включить (`minify.engine`); `tok` — словарь `o200k_base` с `gpt-tokenizer 4.0.0`.
-У проекта прежние настройки означают `strip`, поэтому обновление «само» чисел не
-меняет; способ `esbuild` остаётся осознанным решением того, кто его включает.
-gzip в выпуск по-прежнему не входит (`PLAN.md` §10, D4).
-
-## 1.0.0 — 2026-09-14
-
-Первый выпуск: инструмент вынесен из проекта-потребителя в отдельный пакет
-(`PLAN.md` §5, шаги 0–5) — раньше он жил копией внутри чужого репозитория. Выпусков
-до него не было: версия в манифесте стояла `0.0.0`, а работа шла внутри этого
-репозитория (`WORKLOG.md`, `REFACTOR.md`, `PLAN.md`); номера `0.1.0`–`0.5.0` в
-`PLAN.md` §12 — план выпусков, а не их история.
-
-Версия `1.0.0` — не про объём изменений, а про заморозку: `schema: 1` данных этой
-версией объявлена стабильной, и сломать её теперь можно только MAJOR-выпуском с
-миграцией. Версия инструмента попадает в данные (`tool.version`), версии
-минификатора и словаря — в способ получения числа, поэтому «числа этого выпуска» —
-это числа с `esbuild 0.28.2` и `gpt-tokenizer 4.0.0` в тех разрезах, где они
-задействованы.
-
-### Что изменится в числах
-
-Замер на фикстуре, состояние на HEAD (`now`), метрики `raw`, `min`, `tok`, словарь
-`o200k_base`:
-
-| Файл | 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** |
-
-- **У проекта с прежними настройками не поедет ничего.** Существующие конфиги
-  `minify.engine` не задают, а умолчание — `strip`: те же комментарии и отступы, те
-  же имена, те же байты, что у инструмента до этого выпуска. Это доказано не словом:
-  вывод `--json` и собранный артефакт совпадают побайтово с замороженным эталоном —
-  на фикстуре и на живой истории проекта-потребителя (`fixtures/synthetic/`,
-  `fixtures/parity/`, проверки `test/parity.test.js`, `test/frozen.test.js`).
-- **`raw` не зависит ни от чего, кроме объекта git**: это его размер, содержимое
-  файла для этой метрики не читается вовсе. Ни настройки, ни способ минификации, ни
-  версия инструмента на него не влияют.
-- **`min` со `esbuild` меньше**, чем со `strip`, и это единственное, что меняет
-  числа, если включить настоящее сжатие: имена сокращены, пробелы убраны. На фикстуре
-  итог 1597 → **1483** (−7 %), по файлам — **−33 %** на `code.js` (276 → 185) и
-  **−22 %** на `style.css` (55 → 43). Для форматов, которых минификатор не берёт
-  (`.md`, `.txt`, `.toml`, `.json`), число то же, что со `strip`: 303, 60, 299, 69.
-  Именно поэтому метрика помечена приближением **целиком**: точность колонки
-  считается по худшей клетке, а не по большинству (пометка стоит и у отдельной
-  клетки — `test/minify.test.js`). Способ `esbuild` ставит `--init` новым проектам;
-  перевод существующего проекта на него — осознанное решение, а не побочный эффект
-  обновления.
-- **`tok` — число новое, сравнивать его не с чем**: метрики не было у прежнего
-  инструмента, это не «изменилось», а «появилось». Точный счёт словарём даёт на
-  фикстуре **540**; та же фикстура без словаря считается оценкой по длине
-  (1 токен ≈ 3 знака) и даёт **583** — число другое, поэтому оно помечено
-  приближением, а прогон отдаёт **код 4**, а не зелёный успех
-  (`SIZE_REPORT_NO_OPTIONAL` воспроизводит установку без необязательных
-  зависимостей).
-- **Без `esbuild`** `min` отступает к `strip`: те же 1597, с пометкой приближения и
-  кодом 4. Числа от этого не ломаются, но и не выдаются за сжатие.
-- **`gzip` в 1.0.0 не поставляется**: метрики нет ни в черновике настроек, ни в
-  документации; в реестре она пока принимается, а её удаление — `PLAN.md` §10 (D4),
-  изменение поведения, а не перенос.
-- **Окружение машины на числа не влияет — и это тоже изменение**, относительно
-  инструмента до этого выпуска: он читал пути и переводы строк так, как настроена
-  машина, и на установке Git «по умолчанию» либо давал неверные числа, либо падал
-  вовсе (`BLOCKERS.md` §B1, §B2, §N10). Теперь вывод одинаков в любой среде, и это
-  доказывается прогоном с погашенными настройками машины (`GIT_CONFIG_GLOBAL=/dev/null`).
-
-### Что вошло
-
-- Три метрики: `raw` (размер объекта git), `min` (в двух способах — снятие балласта
-  и настоящее сжатие через `esbuild`), `tok` (токены выбранного словаря). Числа
-  абсолютные, производные (дельты, суммы, фильтры) считает страница.
-- Интерактивный отчёт: дерево файлов, категории, переключение метрик, память выбора
-  между открытиями и передача выбора ссылкой; страница — один самодостаточный файл,
-  открывается с диска без сети.
-- Команды: сборка отчёта, сверка с историей (`size check`), объяснение пропущенной
-  строки (`size explain <sha>`), диагностика (`size doctor`), установка и снятие
-  хука автообновления отчёта, `--init` с черновиком настроек.
-- Шаблоны для подключаемого проекта: черновик настроек и описание проверки для CI.
-- Сторожа, которыми проверяется не код, а обещания: паритет с замороженным эталоном,
-  живая история, работа из собранного пака, утверждения документации, закрепления
-  настроек git на границе вызова.
-
-### Исправлено
-
-- Молчание при опечатках и в несовместимых сочетаниях ключей: неизвестное слово,
-  лишнее слово, два режима сразу, ключ без значения и `--json` там, где ответа в
-  JSON нет, — теперь отказ с названным виновником и готовой командой, а не код 0 с
-  чужой работой.
-- Колонка, чей файл жил в истории и был удалён до HEAD, роняла прогон с бессмысленным
-  текстом отказа; выбор пути перестал зависеть от настроек переименований
-  (`BLOCKERS.md` §B3, §N8).
-- Зависимость чисел от окружения машины (`BLOCKERS.md` §B1, §B2, §N10).
-
-### Не входит в 1.0.0
-
-- `docs/METHODS.md`, `docs/DATA-FORMAT.md`, `docs/ARCHITECTURE.md` — документация
-  пакета из `PLAN.md` §8.3; сегодня роль каждого числа описана в `README.md`.
-- Кэш замеров, разделение быстрого и медленного наборов проверок, профиль на истории
-  в пару тысяч коммитов — `PLAN.md` §5, шаг 6.
-- Удаление метрики `gzip` из реестра (`PLAN.md` §10, D4) и лицензионный файл
-  (открытый вопрос §10).
-- Поставка `dist/app.js` (пре-собранная программа отчёта) и публикация в npm:
-  установка идёт git-зависимостью из публичного репозитория (публичным он стал
-  2026-09-14, `WORKLOG.md` §44), а в npm пакет не опубликован — `PLAN.md` §8.4.
-- Минификация разметки (HTML), JSX/TSX и другие семейства токенизаторов, кроме
-  `openai`: у них нет своего словаря, а считать чужим — выдавать догадку за число.