@vernikr/size-report 2.1.0 → 2.3.0

package/CHANGELOG.md

@@ -18,6 +18,107 @@
 где за основу взяты `fixtures/synthetic/config.json`, метрики — `raw`, `min`, `tok`, а
 способ минификации — `strip` или `esbuild`.
 
+## 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
 
 Вид страницы на десктопе: числам — вся оставшаяся высота, панели — своя прокрутка.

package/README.md

@@ -10,7 +10,7 @@
 
 ## Статус
 
-**Выпуск 2.1.0 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
+**Выпуск 2.3.0 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
 реестре — `@vernikr/size-report` (публикуется тегом из CI, без секрета). Настроек
 проект может не заводить вовсе: без файла инструмент выводит их из самого проекта и
 говорит об этом строкой, а `--init` закрепляет выведенное файлом (чем этот шаг
@@ -21,9 +21,11 @@
 Версия — в манифесте, а у выпуска есть `CHANGELOG.md` с разделом «Что изменится
 в числах»:
 таблица чисел в нём не пересказ, а замер на фикстуре, который сверяется с живым
-прогоном (`test/changelog.test.js`). Числа этим выпуском не меняются — правки
-лежат в виде страницы отчёта на десктопе; `schema: 1` данных, замороженная 1.0.0,
-остаётся той же.
+прогоном (`test/changelog.test.js`). Числа на фикстуре этим выпуском не меняются —
+правки в том, **что именно считается**: без файла настроек колонкой идёт каждый
+отслеживаемый файл (а не выборка из двенадцати), и в дереве панели теперь
+складываются папки; `schema: 1` данных, замороженная 1.0.0, остаётся той же (выпуск
+добавил поле, а не поменял смысл прежних).
 
 **Шаг 1 плана пройден — перенос без изменения поведения.** Команда —
 `bin/size.js`, точка входа пакета — `src/size-table.js` (только реэкспорт),
@@ -76,7 +78,10 @@
 вывод: страница показывает то, что сказал движок, и своего правила точности не
 заводит. Панель страницы — дерево файлов по папкам, с переключателем у каждой
 папки на всё поддерево; выбор читателя переживает перезаход и передаётся
-ссылкой — адрес страницы и есть ссылка.
+ссылкой — адрес страницы и есть ссылка. В контракте же едет **каталог проекта** —
+все пути, которые видит git: дерево страницы — дерево проекта, а числа есть только
+у тех файлов, что стали колонками (чем это отличается от прежнего дерева, где
+были одни колонки, — `CHANGELOG.md` 2.2.0).
 Минификация и токены сделаны первыми срезами шагов 3 и 4 (ниже).
 Разбиение движка по файлам сделано (пункт D1 плана, R-1.3 `REFACTOR.md`).
 Источник инструмента — скрипт `size-table.js` (1145 строк) в проекте
@@ -219,10 +224,10 @@
 
 | Прогон | Команда | Проверок |
 |---|---|---|
-| Быстрый — каждая правка | `pnpm test` | **66 из 170** |
-| Полный — выкладка и CI | `pnpm test:all` | **170** |
+| Быстрый — каждая правка | `pnpm test` | **69 из 174** |
+| Полный — выкладка и CI | `pnpm test:all` | **174** |
 
-Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 170 теми же
+Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 174 теми же
 файлами, а быстрый берёт их часть. Умолчание — полный: файл становится быстрым только
 явно и с причиной, поэтому новое дорогое не может тихо уехать в быстрый. Стерегут это
 объявление `test/suites.test.js` (полнота классификации и причина у каждого файла) и
@@ -314,16 +319,27 @@ Trusted Publisher в настройках пакета), права **publish**
 deльт задан один раз и по артефакту: рост зелёный, спад красный — смена это две
 строки в `src/table.css` плюс пересборка эталона артефакта, больше цвета нигде нет.
 
-**Левая панель страницы — дерево файлов** (`REFACTOR.md` R-2.4). Папки берутся из
-тех же путей, что показаны в подписи файла (ни одного перечисления руками), у
+**Левая панель страницы — дерево файлов проекта** (`REFACTOR.md` R-2.4, каталог
+путей — `CHANGELOG.md` 2.2.0, складывание папок — 2.3.0). Дерево строится по путям проекта, а не по одним
+колонкам, поэтому в нём видно и то, что в отчёт не попало: такой лист — подпись без
+галочки с причиной во всплывающей строке («колонкой быть не может» — правило пакета
+— или «в набор колонок не попал» — выбор проекта), а счётчик папки со смешанным
+составом написан долей («2/5»: два файла в отчёте из пяти в папке). Сам отчёт в
+дереве назван всегда: его отслеживаемость — свойство момента, и от неё содержимое
+страницы не зависит. У
 папки три состояния — все её файлы включены, часть, ни одного, — и переключатель
 папки ведёт за собой всё поддерево; рядом стоит число файлов. Своего состояния у
 папки и у быстрой кнопки категории нет: обе переставляют галочки файлов, поэтому
-дерево, кнопки и таблица не могут разойтись. Список файлов длиннее панели
+дерево, кнопки и таблица не могут разойтись. У каждой папки есть ещё свой знак
+(▾/▸): он отвечает за то, сколько дерева видно, — это дело смотрящего, а не выбор
+читателя, поэтому знак помнится между заходами и в ссылку не идёт (у записи свой
+ключ и тот же паспорт отчёта; разворот всех папок её убирает, как возврат галочек —
+запись выбора). Список файлов длиннее панели
 прокручивается, а не выталкивает таблицу, — и прокрутка эта одна: на широком
-экране листается панель целиком (дерево в ней видно целиком: 23 подписи из 23 при
-окне 1440×900), а на узком — сам список, потому что там панель растёт вместе со
-страницей.
+экране листается панель целиком (при окне 1440×900 страница укладывается в окно, а
+таблица берёт всю оставшуюся высоту), а на узком — сам список, потому что там
+панель растёт вместе со страницей. Дерево стало длинным (в этом репозитории 148
+подписей), поэтому папки и складываются: иначе до его середины не добраться.
 
 **На широком экране панель стоит слева от таблицы и не вытесняет числа**
 (от 900 px, `src/page/app.css`). Это не украшение: на десктопе бокового места
@@ -551,9 +567,9 @@ deльт задан один раз и по артефакту: рост зел
 | `src/css.js` | Чтение оформления с диска: какие наборы стилей есть и какая у них роль |
 | `src/table.css` | Таблица отчёта: геометрия клеток, липкие шапка и колонка, цвет дельт |
 | `src/page/app.css` | Оформление страницы сверх общей части: панель с деревом файлов и липкой строкой категорий (на широком экране — колонка слева, страница в окно), состояния пустоты, узкое окно |
-| `src/page/state.js` | Состояние страницы: данные отчёта, вид галочек, паспорт записи, память браузера и обмен ссылкой — глава программы страницы |
+| `src/page/state.js` | Состояние страницы: данные отчёта, вид галочек, указатель «какой путь — какая колонка», сложенные папки, паспорт записи, память браузера и обмен ссылкой — глава программы страницы |
 | `src/page/dom.js` | Узлы страницы: мелкие помощники разметки (`appEl`, `appBox`) — одни на панель и таблицу |
-| `src/page/panel.js` | Панель выбора: галочки метрик и файлов, категории, дерево путей; перерисовку просит у главы сборки |
+| `src/page/panel.js` | Панель выбора: галочки метрик и файлов, категории, дерево путей проекта (файлы вне отчёта — подписью с причиной, папки — со знаком складывания); перерисовку просит у главы сборки |
 | `src/page/table.js` | Таблица страницы: клетка, подпись коммита, шапка и состояния пустоты — разметка поверх общего расчёта |
 | `src/page/app.js` | Сборка и запуск страницы: таблица целиком, перерисовка по выбору читателя (с возвратом фокуса и прокрутки), первая отрисовка и смена якоря; вклеивается в собранную страницу
 | `src/page/build.js` | Сборка страницы: данные, оформление и программа в одном файле без внешних ссылок |
@@ -576,9 +592,9 @@ deльт задан один раз и по артефакту: рост зел
 | `bin/postinstall.js` | Установка хука после постановки пакета: ищет проект-потребитель и молчит, если поставить негде |
 | `src/artifact.js` | Отчёт на диске: единственное место, где он превращается в файл (им пользуются и `--write`, и хук); отчёт — самодостаточная страница |
 | `src/journal.js` | Журнал и ссылки: к какому разделу относится коммит и куда ведёт описание |
-| `src/data.js` | Категории файлов и контракт со страницей (`--data`) |
+| `src/data.js` | Категории файлов и контракт со страницей (`--data`): числа, устройство таблицы и каталог путей проекта |
 | `src/config.js` | Настройки проекта-потребителя: умолчания, чтение, проверка |
-| `src/project.js` | Настройки, выведенные из самого проекта (дерево и история): колонки, журнал, исключения. Без файла настроек он и есть настройки; `--init` закрепляет его файлом |
+| `src/project.js` | Настройки, выведенные из самого проекта (дерево и история): колонки, журнал, исключения, каталог путей для дерева страницы. Без файла настроек он и есть настройки; `--init` закрепляет его файлом |
 | `src/locales.js`, `src/refusal.js`, `src/tool.js` | Тексты отчёта; коды выхода и справка; имя и версия пакета |
 | `src/cli.js` | Вход инструмента: разбор строки, чтение проекта и доставка запроса режиму; главный файл пакета |
 | `src/args.js` | Грамматика командной строки: режимы, ключи и команды плюс проверки их сочетаний — отказ называет виновника и готовую команду |
@@ -603,7 +619,8 @@ deльт задан один раз и по артефакту: рост зел
 | `test/refusals-catalog.test.js` | Сторож каталога отказов: у каждого места отказа в исходниках есть пункт, у каждого пункта — объявленный совет, а отказы, отданные другой проверке, ею в самом деле утверждаются (названные файл и строка проверяются) |
 | `test/contract-data.test.js` | Контракт данных: числа против эталона, состав полей против производных, пометки приближения против подписи метрики |
 | `test/contract-derived.test.js` | Производные против чисел артефакта: итоги строки, дельты клетки и дельта итога — на коде, который лежит в дереве |
-| `test/page-view.test.js` | Собранная страница: вклейка без копий расчёта, самодостаточность, дерево файлов, состояния пустоты, оформление и переключатели |
+| `test/page-view.test.js` | Собранная страница: вклейка без копий расчёта, самодостаточность, состояния пустоты, оформление и переключатели |
+| `test/page-tree.test.js` | Дерево файлов панели: папки по путям проекта, три состояния, поддерево, файлы вне отчёта и прокрутка при пересборке |
 | `test/page-choice.test.js` | Память выбора и обмен ссылкой: перезаход, чужой отчёт, чужая и битая запись, смена адреса на открытой странице |
 | `test/module.test.js` | Модуль в расширении `.js`: измеряется без правок настроек; гард стриппера жив (доказано мутацией) и не обвиняет невиновного |
 | `test/guard.test.js` | Разбор модуля: идёт потоком, оба пути дают один вердикт, отступление работает без файла потока, сотни разборов дешевле запуска |
@@ -675,7 +692,7 @@ pnpm add -D @vernikr/size-report
 ```
 
 Пакет **опубликован в реестре**, и публично: `npm view @vernikr/size-report
-version` отвечает `2.1.0`, `npm access get status @vernikr/size-report` — `public`,
+version` отвечает `2.3.0`, `npm access get status @vernikr/size-report` — `public`,
 а анонимный запрос тарболла — код 200. `npm i -D` и `yarn add -D` принимают то же
 имя; ни ключа, ни ссылки на репозиторий не нужно.
 
@@ -683,11 +700,11 @@ version` отвечает `2.1.0`, `npm access get status @vernikr/size-report`
 реестра, но остаётся привязанной к ревизии:
 
 ```bash
-pnpm add -D github:vernikr/size-report#v2.1.0
+pnpm add -D github:vernikr/size-report#v2.3.0
 ```
 
 Без сети (или если тянуть из codeload нечем) — тарболл: `pnpm pack` в клоне
-пакета, затем `pnpm add -D ./vernikr-size-report-2.1.0.tgz`.
+пакета, затем `pnpm add -D ./vernikr-size-report-2.3.0.tgz`.
 
 **Почему тег, а не sha.** Короткий sha pnpm разрешает только через видимые рефы, а
 `git ls-remote` отдаёт одни верхушки веток: пока ревизия — верхушка, короткий sha
@@ -695,7 +712,7 @@ pnpm add -D github:vernikr/size-report#v2.1.0
 <sha> to a commit`. Это не рассуждение, а проба: короткий пин `6530237` ставился,
 пока `main` стоял на нём, и перестал — на следующем же коммите, а тот же sha
 целиком поставился. Имя ветки (`#main`) или тег принимаются оба, но ветка —
-движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v2.1.0`, он же и в
+движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v2.3.0`, он же и в
 примере (сорок знаков тоже годятся, но их придётся брать глазами из истории).
 
 Ревизия в примере — не украшение, а часть утверждения: она закреплена за тем, что
@@ -728,8 +745,10 @@ pnpm exec size --init      # закрепить выведенное в size-tab
 ```
 
 Начинать с настроек не нужно: без файла инструмент выводит их из проекта — колонками
-берёт крупнейшие файлы, по одному от каждого расширения (иначе отчёт состоял бы из
-одних крупных `.md`, и ни один `.js` не попал бы под настоящее сжатие), журналом —
+берёт **каждый отслеживаемый git файл, который можно измерить** (отчёт называет
+объём проекта, а не выборки из него; границы остались только у того, что колонкой
+быть не может: сам отчёт, замки зависимостей, собранное, незнакомый формат и файл
+сверх 512 КБ), а прочие называет в `skip`, журналом —
 первый знакомый (`WORKLOG.md`, `CHANGELOG.md`, …), файлом отчёта — `docs/`, если
 каталог есть, командой починки — объявленный скрипт `sizes`, а без него — путь
 к установленному пакету (его цитируют подпись отчёта и отказы, поэтому он обязан
@@ -739,8 +758,9 @@ pnpm exec size --init      # закрепить выведенное в size-tab
 этих необязательных зависимостей метрика честно отступает к другому счёту и прогон
 отдаёт код 4 — правки настроек и тут не требуются.
 
-Всё, что колонкой быть не может или в неё не поместилось (сам отчёт, замки
-зависимостей, карты, собранное), называется в `skip` — поэтому первый же `size check`
+Всё, что колонкой быть не может (сам отчёт, замки зависимостей, карты, собранное,
+незнакомый формат, слишком крупный файл) и чего git не отслеживает, называется
+в `skip` — поэтому первый же `size check`
 полон, а не красен: «пути мимо колонок» появляются от новых правок, а не от того, что
 проект ещё не описан. О том, что настройки выведены, инструмент говорит строкой в
 stderr и называет команду, которая их закрепляет, — `--init`; закреплённое проходит

package/package.json

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

package/src/data.js

@@ -3,6 +3,7 @@ import { LOCALES } from './locales.js';
 import { metricView } from './metrics.js';
 import { rowHref } from './journal.js';
 import { build, skipLine } from './history.js';
+import { projectTree } from './project.js';
 import { TOOL_PKG } from './tool.js';
 
 /* Категории файлов и контракт со страницей: абсолютные значения и устройство
@@ -66,6 +67,10 @@ export function reportData(cfg, root) {
     categories: CATEGORY_ORDER.filter((key) => files.some((f) => f.category === key))
       .map((key) => ({ key: key, label: loc.categories[key] })),
     files: files,
+    /* Дерево страницы — дерево проекта: все пути, а не только колонки. Числа есть
+     * лишь у колонок, поэтому у каждой записи каталога сказано, чего ей не
+     * досталось: `why` пусто — файл измеряется, иначе названа причина. */
+    catalog: projectTree(root, cfg.output, files.map((f) => (f.path === null ? f.paths[0] : f.path))),
     rows: rows.map((r) => Object.assign(rowShape(r),
       { href: rowHref(r.section, r.sha, cfg), values: r.cells })),
     now: state.map((s) => (s === null ? null : s.cells)),

package/src/locales.js

@@ -19,6 +19,17 @@ export const LOCALES = {
       metrics: 'Метрики',
       files: 'Файлы',
       dir: 'все файлы папки {name} ({n})',
+      dirNone: 'ни один файл папки {name} в отчёт не попал (в папке {n})',
+      /* Знак сложенной папки — своя цель нажатия: галочка отвечает за числа,
+       * знак — за то, сколько дерева видно. */
+      foldClose: 'свернуть папку {name}',
+      foldOpen: 'развернуть папку {name}',
+      /* Причина — у листа: в дереве он подписью, а не галочкой, и без этих слов
+       * читатель решил бы, что файл потерялся. */
+      notMeasuredRule: 'не измеряется: такой файл колонкой быть не может'
+        + ' (собранный, замок зависимостей, сам отчёт или слишком крупный)',
+      notMeasuredChoice: 'не измеряется: в набор колонок отчёта не попал'
+        + ' — набор задают настройки (columns)',
       all: 'все',
       sub: '{tool} {version} · {artifact}',
       /* Слова точности: подпись метрики говорит про худшее в колонке, а клетки —
@@ -70,6 +81,13 @@ export const LOCALES = {
       metrics: 'Metrics',
       files: 'Files',
       dir: 'all files in “{name}” ({n})',
+      dirNone: 'no file of “{name}” made it into the report ({n} in it)',
+      foldClose: 'collapse “{name}”',
+      foldOpen: 'expand “{name}”',
+      notMeasuredRule: 'not measured: such a file cannot be a column'
+        + ' (built, a dependency lock, the report itself, or too large)',
+      notMeasuredChoice: 'not measured: it is not in the report’s set of columns'
+        + ' — that set comes from the settings (columns)',
       all: 'all',
       sub: '{tool} {version} · {artifact}',
       exact: 'an exact number',

package/src/page/app.css

@@ -71,12 +71,27 @@ h1 { margin: 0 0 3px; font-size: 21px; font-weight: 650; letter-spacing: -.012em
  * кто и вправду ограничен окном. Шрифт файлов — тот же, что у чисел таблицы:
  * подписей в списке много и они короткие, а рядом с ними стоит таблица. */
 .panel .files { max-height: min(30vh, 320px); overflow: auto; font-size: 12.5px; }
-.panel .tree { margin: 0; padding: 0; list-style: none; }
+.panel .tree { margin: 0; padding: 0 0 0 14px; list-style: none; }
 .panel .tree .tree { margin-left: 14px; padding-left: 9px; border-left: 1px solid var(--line); }
 .panel .tree .box { padding: 1px 7px 1px 5px; }
 .box.dir { font-weight: 600; }
 .box .n { margin-left: 1px; color: var(--muted); font-size: 11px; }
 
+/* Знак сложенной папки: место под него есть у каждой строки (отступ строки), а сам
+ * он только у папок — так листья и папки выстроены в один столбец. Он не часть
+ * галочки: галочка отвечает за числа, знак — за то, сколько дерева видно. */
+.panel .tree li { position: relative; }
+.panel .tree li > .fold {
+  position: absolute;
+  left: -13px;
+  width: 14px;
+  text-align: center;
+  color: var(--muted);
+  cursor: pointer;
+  user-select: none;
+}
+.panel .tree li > .fold:hover { color: var(--ink); }
+
 /* Переключатель — метка вокруг поля ввода: и подпись, и цель нажатия одна, поэтому
  * по нему попадает и мышь, и клавиатура (Space на поле ввода), и вспомогательные
  * технологии. */
@@ -91,6 +106,10 @@ h1 { margin: 0 0 3px; font-size: 21px; font-weight: 650; letter-spacing: -.012em
 .box:hover { background: var(--tint); }
 .box input { margin: 0; accent-color: AccentColor; }
 .box.all { font-weight: 600; }
+/* Файл вне отчёта: подпись на месте галочки — чисел для него не измеряли. Он
+ * приглушён и не отзывается на мышь: обещать нажатие нечем. */
+.box.plain { cursor: default; opacity: .55; }
+.box.plain:hover { background: none; }
 
 /* Расшифровки под деревом файлов нет намеренно: под списком она отодвигала
  * числа, а её содержимое и так стоит рядом с тем, что объясняет, — цвет дельт

package/src/page/app.js

@@ -1,4 +1,4 @@
-import { appData, appUi, appView, appWrite, appNotice, appLinkUse, appRead, appApply } from './state.js';
+import { appData, appUi, appView, appWrite, appNotice, appLinkUse, appRead, appApply, appFoldRead } from './state.js';
 import { appBody, appHead, appState } from './table.js';
 import { appPanel } from './panel.js';
 
@@ -76,6 +76,10 @@ if (appStart !== 'ours') {
   const appSaved = appRead();
   if (appSaved !== null) appApply(appSaved);
 }
+/* Сложенное дерево — память смотрящего, а не выбор читателя: она возвращается и
+ * тогда, когда открыта чужая ссылка (иначе присланная ссылка разложила бы дерево
+ * заново на каждом заходе). */
+appFoldRead();
 appRender(true);
 appStartup = false;
 appForeign = false;

package/src/page/build.js

@@ -62,6 +62,9 @@ function uiText(page, loc) {
     metrics: page.metrics,
     files: page.files,
     dir: page.dir,
+    dirNone: page.dirNone,
+    foldClose: page.foldClose,
+    foldOpen: page.foldOpen,
     all: page.all,
     linkForeign: page.linkForeign,
     linkBroken: page.linkBroken,
@@ -71,6 +74,10 @@ function uiText(page, loc) {
     exact: page.exact,
     approximate: page.approximate,
     approxCell: page.approximateCell,
+    /* Почему файла нет в отчёте — словами: причину называет движок знаком (`why`),
+     * а страница одевает знак в текст, как и всё остальное в панели. */
+    notMeasuredRule: page.notMeasuredRule,
+    notMeasuredChoice: page.notMeasuredChoice,
     methodLabel: page.panelMethod,
     empty: page.emptyMetrics,
     noFiles: page.noFiles,

package/src/page/panel.js

@@ -1,5 +1,5 @@
 import { appEl, appBox } from './dom.js';
-import { appData, appUi, appView, appFileAt } from './state.js';
+import { appData, appUi, appView, appFileAt, appFoldSet, appMeasured } from './state.js';
 
 /* Галочку файла ставит только файл: и категория, и папка в дереве — способы
  * переставить те же галочки сразу группой, а своего состояния у них нет. Иначе
@@ -14,58 +14,134 @@ function appFileBox(i) {
   });
 }
 
-/* Все файлы поддерева — то, чем управляет переключатель папки. */
+/* Файл, которого в отчёте нет: он стоит в дереве на своём месте, но галочки у
+ * него нет — чисел для него не измеряли, и переключать нечего. Причину читатель
+ * видит во всплывающей строке, а не догадывается по виду. */
+function appUnmeasuredBox(entry) {
+  const box = appEl('span', 'box plain', entry.path.split('/').pop());
+  box.title = entry.path + ' · '
+    + (entry.why === 'rule' ? appUi.notMeasuredRule : appUi.notMeasuredChoice);
+  return box;
+}
+
+/* Все измеряемые файлы поддерева — то, чем управляет переключатель папки: файл
+ * вне отчёта переключать нечего. */
 function appIndexes(node) {
   const out = node.files.slice();
   node.dirs.forEach((sub) => { out.push(...appIndexes(sub)); });
   return out;
 }
 
-/* Узлы одного уровня: сперва папки по алфавиту, затем файлы в порядке данных.
- * Переключатель папки стоит над своим поддеревом и показывает три состояния: все
- * файлы включены, часть, ни одного. */
-function appTreeList(node) {
-  const list = appEl('ul', 'tree');
-  [...node.dirs.keys()].sort().forEach((name) => {
-    const sub = node.dirs.get(name);
-    const idx = appIndexes(sub);
+/* Сколько файлов в поддереве — вместе с теми, что в отчёт не попали. */
+function appCount(node) {
+  let n = node.files.length + node.others.length;
+  node.dirs.forEach((sub) => { n += appCount(sub); });
+  return n;
+}
+
+/* Узел дерева: измеряемые файлы (колонки), прочие файлы проекта и подпапки. */
+function appNode() {
+  return { files: [], others: [], dirs: new Map() };
+}
+
+/* Переключатель папки: его галочка ведёт за собой всё поддерево и показывает три
+ * состояния — все файлы включены, часть, ни одного. Рядом число файлов; если в
+ * папке есть и те, что вне отчёта, оно написано долей («2/5»): читателю важно, что
+ * в папке пять файлов, а измеряются два. Папка без единого измеряемого файла
+ * галочки не получает — включать в ней нечего, — но на месте остаётся. */
+function appDirHead(name, sub) {
+  const idx = appIndexes(sub);
+  const total = appCount(sub);
+  const label = name + '/';
+  let head;
+  if (idx.length === 0) {
+    head = appEl('span', 'box dir plain', label);
+    head.title = appUi.dirNone.replace('{name}', name).replace('{n}', total);
+  } else {
     const on = idx.map((i) => appView.files[i]);
-    const some = on.some((v) => v);
-    const head = appBox(name + '/', appUi.dir.replace('{name}', name).replace('{n}', idx.length),
-      some && on.every((v) => v), (e) => {
+    const every = on.every((v) => v);
+    head = appBox(label, appUi.dir.replace('{name}', name).replace('{n}', idx.length),
+      every, (e) => {
         idx.forEach((i) => { appView.files[i] = e.target.checked; });
         appRender();
       }, 'dir');
-    head.querySelector('input').indeterminate = some && !on.every((v) => v);
-    head.appendChild(appEl('span', 'n', idx.length));
+    head.querySelector('input').indeterminate = !every && on.some((v) => v);
+  }
+  head.appendChild(appEl('span', 'n', idx.length === total ? String(total) : idx.length + '/' + total));
+  return head;
+}
+
+/* Знак папки — своя цель нажатия, отдельная от галочки: галочка отвечает за числа
+ * (включает файлы поддерева), а знак — за то, сколько дерева видно. Одна цель на
+ * два разных действия означала бы, что сложить папку можно только вместе с
+ * включением её файлов. Знак нарисован спаном, а не кнопкой, потому что в строке
+ * папки рядом уже стоит метка-галочка, а вложенная в метку кнопка поднимала бы её
+ * же нажатие. */
+function appFoldBox(name, path) {
+  const folded = appView.folded[path] === true;
+  const box = appEl('span', 'fold', folded ? '▸' : '▾');
+  box.title = (folded ? appUi.foldOpen : appUi.foldClose).replace('{name}', name);
+  box.addEventListener('click', () => { appFoldSet(path, !folded); appRender(); });
+  return box;
+}
+
+/* Листья уровня: измеряемые файлы и файлы вне отчёта — вперемешку и по алфавиту
+ * имени, как в дереве файлов, а не отдельными списками. */
+function appLeaves(node) {
+  const items = node.files.map((i) => ({ name: appData.files[i].label, i: i, entry: null }));
+  node.others.forEach((entry) => {
+    items.push({ name: entry.path.split('/').pop(), i: null, entry: entry });
+  });
+  return items.sort((a, b) => (a.name < b.name ? -1 : (a.name > b.name ? 1 : 0)));
+}
+
+/* Узлы одного уровня: сперва папки по алфавиту, затем листья (их порядок — из
+ * `appLeaves`). Сложенная папка — это та, у которой нет самого списка: прятать
+ * поддерево оформлением значило бы держать в разметке то, чего не видно, и
+ * пересобирать её на каждый клик по знаку. */
+function appTreeList(node, prefix) {
+  const list = appEl('ul', 'tree');
+  [...node.dirs.keys()].sort().forEach((name) => {
+    const sub = node.dirs.get(name);
+    const here = prefix === '' ? name : prefix + '/' + name;
     const li = appEl('li');
-    li.appendChild(head);
-    li.appendChild(appTreeList(sub));
+    li.appendChild(appFoldBox(name, here));
+    li.appendChild(appDirHead(name, sub));
+    if (appView.folded[here] !== true) li.appendChild(appTreeList(sub, here));
     list.appendChild(li);
   });
-  node.files.forEach((i) => {
+  appLeaves(node).forEach((leaf) => {
     const li = appEl('li');
-    li.appendChild(appFileBox(i));
+    li.appendChild(leaf.entry === null ? appFileBox(leaf.i) : appUnmeasuredBox(leaf.entry));
     list.appendChild(li);
   });
   return list;
 }
 
-/* Дерево файлов: путь делится по «/», папки становятся узлами, файлы — листьями.
- * Строится из тех же путей, что показаны в подписи файла, поэтому дерево и список
- * файлов не могут разойтись. */
+/* Место листа в дереве: путь делится по «/», промежуточные папки заводятся по
+ * дороге. Одно место на измеряемые и прочие — иначе они разошлись бы папками. */
+function appLeafAt(node, p, i, entry) {
+  const parts = p.split('/');
+  for (let d = 0; d < parts.length - 1; d++) {
+    if (!node.dirs.has(parts[d])) node.dirs.set(parts[d], appNode());
+    node = node.dirs.get(parts[d]);
+  }
+  if (entry === null) node.files.push(i);
+  else node.others.push(entry);
+}
+
+/* Дерево страницы — дерево проекта: узлы берутся из каталога (все пути, которые
+ * видит git), поэтому в нём есть и файлы вне отчёта. Измеряемый лист — колонка, и
+ * путь у него тот же, что в подписи файла; колонка, чьего файла на HEAD уже нет, в
+ * каталог не попала (в индексе её нет) и стоит на месте по последнему известному
+ * пути. */
 function appTree() {
-  const root = { files: [], dirs: new Map() };
-  appData.files.forEach((f, i) => {
-    const parts = (f.path === null ? f.paths[0] : f.path).split('/');
-    let node = root;
-    for (let d = 0; d < parts.length - 1; d++) {
-      if (!node.dirs.has(parts[d])) node.dirs.set(parts[d], { files: [], dirs: new Map() });
-      node = node.dirs.get(parts[d]);
-    }
-    node.files.push(i);
+  const root = appNode();
+  appData.files.forEach((_f, i) => appLeafAt(root, appFileAt(i), i, null));
+  appData.catalog.forEach((entry) => {
+    if (appMeasured[entry.path] === undefined) appLeafAt(root, entry.path, null, entry);
   });
-  return appTreeList(root);
+  return appTreeList(root, '');
 }
 
 export function appPanel() {

package/src/page/state.js

@@ -25,7 +25,7 @@
 
 export const appData = JSON.parse(document.getElementById('data').textContent);
 export const appUi = JSON.parse(document.getElementById('ui').textContent);
-export const appView = { metrics: {}, files: [] };
+export const appView = { metrics: {}, files: [], folded: {} };
 appData.metrics.forEach((m) => { appView.metrics[m.key] = true; });
 appData.files.forEach(() => { appView.files.push(true); });
 
@@ -35,6 +35,13 @@ appData.files.forEach(() => { appView.files.push(true); });
 export const appMetric = {};
 appData.metrics.forEach((m) => { appMetric[m.key] = m; });
 
+/* Колонка по пути файла: дерево страницы — дерево проекта (все пути каталога), а
+ * числа есть только у колонок, поэтому лист дерева по этому указателю и решает,
+ * галочка он или подпись. Имя берётся тем же правилом, что у записи выбора
+ * (`appFileAt`), — дерево и память читателя разойтись не могут. */
+export const appMeasured = {};
+appData.files.forEach((_f, i) => { appMeasured[appFileAt(i)] = i; });
+
 /* Ссылка — это тот же выбор в адресе, под своим именем: чужой якорь страницы
  * ссылкой не считается, и спорить с ним нечем. */
 const APP_LINK = '#size-report=';
@@ -224,3 +231,44 @@ export function appApply(rec) {
   appData.metrics.forEach((m) => { if (metrics[m.key] === false) appView.metrics[m.key] = false; });
   appData.files.forEach((_f, i) => { if (files[appFileAt(i)] === false) appView.files[i] = false; });
 }
+
+/* -------- сложенное дерево -------- */
+
+/* Сложенные папки — память того же рода, что выбор, но своей записи: она про то,
+ * сколько дерева видно, а не про то, какие числа читают. Поэтому в адрес она не
+ * идёт: ссылку отправляют ради чисел, а разложенное дерево — дело смотрящего. Как и
+ * у выбора, здесь помнится только сложенное (`true`), а имя папки — это путь
+ * («src/page»), поэтому исчезнувшее имя просто ничего не значит. */
+const appFoldKey = appKey + ':tree';
+
+export function appFoldRead() {
+  let text = null;
+  try {
+    text = window.localStorage.getItem(appFoldKey);
+  } catch (_e) {
+    return;
+  }
+  if (text === null) return;
+  let rec = null;
+  try {
+    rec = JSON.parse(text);
+  } catch (_e) {
+    return;
+  }
+  if (!appRecordOk(rec)) return;
+  const folded = rec.folded || {};
+  Object.keys(folded).forEach((p) => { if (folded[p] === true) appView.folded[p] = true; });
+}
+
+export function appFoldSet(path, folded) {
+  if (folded) appView.folded[path] = true;
+  else delete appView.folded[path];
+  const rec = { v: 1, passport: appPassport(), folded: Object.assign({}, appView.folded) };
+  try {
+    if (Object.keys(rec.folded).length === 0) window.localStorage.removeItem(appFoldKey);
+    else window.localStorage.setItem(appFoldKey, JSON.stringify(rec));
+  } catch (_e) {
+    /* Памяти нет: сложенное не переживёт закрытия страницы, а вид от этого не
+     * зависит — дерево сложено ровно так, как его сложил читатель сейчас. */
+  }
+}

package/src/project.js

@@ -18,15 +18,16 @@ import { cliCommand, invocation } from './refusal.js';
  *
  * **Колонка — это файл.** Состояние движка хранит на колонку один путь, а список
  * путей колонки — её переименования (в ревизии берётся тот, который в ней есть).
- * Поэтому «папка целиком» колонкой быть не может, и профиль выбирает файлы, а не
- * группы путей.
+ * Поэтому «папка целиком» колонкой быть не может, и профиль называет файлы, а не
+ * группы путей. Колонкой идёт **каждый** отслеживаемый файл, который можно
+ * измерить: выборка из проекта выдавала объём выборки за объём проекта.
  *
  * **Профиль обязан проходить ту же проверку, которой его встретит первый запуск**
  * (BLOCKERS §N2, REFACTOR R-0.4): путь, не ставший колонкой и не объявленный
  * исключением, — это код 1 на первом же прогоне. Поэтому `skip` называет и то,
- * что колонкой быть не может (сам отчёт, замки зависимостей, карты, собранное), и
- * то, что в колонки не поместилось: так первый `check` зелёный, а что не попало в
- * отчёт — сказано в файле, а не умолчано.
+ * что колонкой быть не может (сам отчёт, замки зависимостей, собранное, незнакомый
+ * формат, слишком крупный файл), и то, чего git не отслеживает: так первый `check`
+ * зелёный, а про каждый файл вне отчёта сказано, почему его там нет.
  */
 
 /* Что вообще берётся колонкой: текстовые формы, с которыми движок умеет работать.
@@ -41,11 +42,6 @@ const JOURNALS = ['WORKLOG.md', 'CHANGELOG.md', 'CHANGES.md', 'HISTORY.md'];
  * сгенерирован, и в отчёте он перевесил бы весь проект. */
 const MAX_BYTES = 512 * 1024;
 
-/* Сколько файлов идут колонками: отчёт читают глазами, а сотня колонок читается
- * хуже, чем скачок. Остальное остаётся на виду — в `skip`, откуда его берут
- * колонкой, когда оно важно. */
-const COLUMN_LIMIT = 12;
-
 /* Индекс — путь и размер: `ls-files -s` даёт объекты, размер спрашивается у них
  * одной пачкой (`cat-file --batch-check`), а не чтением содержимого. */
 function indexFiles(root) {
@@ -173,11 +169,17 @@ function labelFor(used, p) {
   return p + ' (' + n + ')';
 }
 
-/* Выбор колонок: по кругу от каждого расширения берётся его крупнейший файл — иначе
- * в отчёте оказались бы одни крупные `.md`, и ни один `.js` не попал бы под
- * настоящее сжатие (первый отчёт нового проекта обязан быть точным, а не
- * приближённым). Порядок круга — по весу расширения: сперва то, чего в проекте
- * больше всего. */
+/* Выбор колонок: колонкой идёт всё, что можно измерить, — то есть каждый файл
+ * проекта, а не выборка из него. Выборка (прежде — крупнейшие по одному от каждого
+ * расширения, всего не больше двенадцати) врала дважды: отчёт называл объём файлов,
+ * которых в нём не было, а читатель принимал это за объём проекта. Границы остались
+ * только у того, что колонкой **не может** быть: сам отчёт, замки, собранное,
+ * незнакомый формат и слишком крупный файл (`generated` и `MAX_BYTES`) — они уходят
+ * в `skip` и называются там.
+ *
+ * Порядок колонок — по кругу от каждого расширения, от крупнейшего к мелкому:
+ * сперва то, чего в проекте больше всего, и в каждом расширении крупное раньше
+ * мелкого. Это порядок чтения отчёта, а не вес: числа от него не зависят. */
 function columnsOf(files, journal) {
   const byExt = new Map();
   files.forEach((f) => {
@@ -194,11 +196,11 @@ function columnsOf(files, journal) {
     used.push(columns[columns.length - 1].label);
   };
   if (journal !== '' && files.some((f) => f.p === journal)) take(journal);
-  for (let round = 0; columns.length < COLUMN_LIMIT; round++) {
+  for (let round = 0; columns.length < files.length; round++) {
     const before = columns.length;
     rings.forEach((ring) => {
       const f = ring[round];
-      if (f !== undefined && columns.length < COLUMN_LIMIT && f.p !== journal) take(f.p);
+      if (f !== undefined && f.p !== journal) take(f.p);
     });
     if (columns.length === before) break;
   }
@@ -209,7 +211,11 @@ export function projectConfig(root) {
   const output = outputOf(root);
   const journal = journalOf(root);
   const files = allPaths(root);
-  const readable = files.filter((f) => !generated(f.p, output) && f.size <= MAX_BYTES);
+  /* Колонками идёт отслеживаемое git: файл, которого на HEAD нет, измерять нечего
+   * (в отчёте он был бы пуст во всех строках). Путь, живущий только в истории,
+   * поэтому — исключение, а не колонка; сам список путей — всё равно полный. */
+  const tracked = new Set(indexFiles(root).map((f) => f.p));
+  const readable = files.filter((f) => tracked.has(f.p) && !generated(f.p, output) && f.size <= MAX_BYTES);
   const columns = columnsOf(readable, journal);
   const taken = new Set(columns.reduce((all, c) => all.concat(c.paths), []));
   // Язык, заголовок, порядок строк и выключатель хука не выводятся ни из чего:
@@ -232,13 +238,40 @@ export function projectConfig(root) {
       anchor: 'heading'
     },
     links: { commitUrl: commitUrlOf(root) },
-    // Исключения — всё, что колонкой не стало: и то, что ею быть не может, и то, что
-    // в отчёт не поместилось. Так первый запуск полон, а непоместившееся названо.
+    // Исключения — всё, что колонкой не стало: то, что ею быть не может, и то, чего
+    // git не отслеживает (путь из одной истории). Так первый запуск полон, а
+    // названное в `skip` — это ответ на вопрос «почему его нет в отчёте».
     skip: [output].concat(files.filter((f) => !taken.has(f.p)).map((f) => f.p))
       .filter((p, i, all) => all.indexOf(p) === i)
   };
 }
 
+/* Путь самого отчёта — в проекте ли он назван (не пустой, не абсолютный и не с
+ * выходом наверх): только такой путь дереву можно назвать листом. */
+const ownPath = (output) => output !== '' && !path.isAbsolute(output) && output.indexOf('..') !== 0;
+
+/* Каталог проекта для страницы: все пути, которые видит git, и причина у тех из
+ * них, что колонкой не стали (`null` — стал: страница по этому знаку решает, лист
+ * — галочка или подпись). Дерево страницы — дерево проекта, поэтому пути берутся
+ * из индекса, а не из колонок; причины — **теми же** правилами, по которым профиль
+ * выбирает колонки (`generated` и предел размера), иначе подсказка говорила бы
+ * одно, а выбор колонок делал другое. Колонка, чьего файла на HEAD уже нет, в
+ * каталог не попадает: в индексе её нет, а на месте в дереве её держит страница.
+ *
+ * Сам отчёт в каталоге есть всегда — и пока он ещё не собран, и когда он вне git:
+ * его отслеживаемость — свойство момента, а не проекта. Зависеть от неё отчёт не
+ * должен: иначе первая же пересборка в свежем клоне даёт другие байты (отчёт в
+ * каталоге появился), и хук коммитит его второй раз на пустом месте. */
+export function projectTree(root, output, measured) {
+  const files = indexFiles(root);
+  if (ownPath(output) && files.every((f) => f.p !== output)) files.push({ p: output, size: 0 });
+  return files.sort((a, b) => (a.p < b.p ? -1 : 1)).map((f) => ({
+    path: f.p,
+    why: measured.indexOf(f.p) >= 0 ? null
+      : (generated(f.p, output) || f.size > MAX_BYTES ? 'rule' : 'choice')
+  }));
+}
+
 /* Имя черновика (`sniffColumns`) осталось публичным: на него опираются те, кто звал
  * вывод колонок (`test/api.test.js` держит список имён), и форма ответа та же —
  * колонки, знакомые расширения проекта и сколько путей всего. */

package/src/size-table.js

@@ -63,10 +63,10 @@
  *   strip → refusal, parse                             — снятие балласта и гард;
  *   metrics → strip                                    — реестр метрик;
  *   git → refusal                                      — всё, что читается у git;
- *   project → git, refusal, data                       — что проект говорит о себе сам;
+ *   project → git, refusal                            — что проект говорит о себе сам;
  *   config → project, git, refusal, locales, metrics, data — настройки проекта;
  *   history → git, metrics, journal, refusal           — сборка по истории;
- *   data → locales, metrics, journal, history, tool    — контракт со страницей;
+ *   data → locales, metrics, journal, history, project, tool — контракт со страницей;
  *   page/build → locales, css                          — отчёт одним файлом;
  *   artifact → data, page/build                        — запись отчёта;
  *   modes → почти все                                  — что делать по запросу;

package/templates/README.md

@@ -19,8 +19,9 @@ uninstall-hook`, выключить, не снимая, — `"hooks": {"enabled"
 ## Настройки
 
 **Файл настроек заводить не нужно.** Без него инструмент выводит профиль из самого
-проекта: колонками — крупнейшие файлы по одному от каждого расширения (иначе в отчёте
-оказались бы одни крупные `.md`), журналом — первый знакомый (`WORKLOG.md`,
+проекта: колонками — каждый отслеживаемый файл, который можно измерить (отчёт тогда
+описывает проект целиком, а не несколько самых крупных его файлов), журналом —
+первый знакомый (`WORKLOG.md`,
 `CHANGELOG.md`, …), файлом отчёта — `docs/`, если каталог есть, командой починки —
 объявленный скрипт `sizes`, ссылкой на коммит — адрес `origin`. О том, что настройки
 выведены, инструмент говорит строкой, а закрепляет их файлом `size --init`: дальше