@vernikr/size-report 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -18,6 +18,59 @@
 где за основу взяты `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
 
 Дерево страницы — дерево проекта: видно всё, числа есть у измеряемых.

package/README.md

@@ -10,7 +10,7 @@
 
 ## Статус
 
-**Выпуск 2.2.0 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
+**Выпуск 2.3.0 (2026-09-15).** Инструмент живёт отдельным пакетом: имя в
 реестре — `@vernikr/size-report` (публикуется тегом из CI, без секрета). Настроек
 проект может не заводить вовсе: без файла инструмент выводит их из самого проекта и
 говорит об этом строкой, а `--init` закрепляет выведенное файлом (чем этот шаг
@@ -21,10 +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` (только реэкспорт),
@@ -223,10 +224,10 @@
 
 | Прогон | Команда | Проверок |
 |---|---|---|
-| Быстрый — каждая правка | `pnpm test` | **68 из 172** |
-| Полный — выкладка и CI | `pnpm test:all` | **172** |
+| Быстрый — каждая правка | `pnpm test` | **69 из 174** |
+| Полный — выкладка и CI | `pnpm test:all` | **174** |
 
-Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 172 теми же
+Ни одна проверка не потеряна и не ослаблена: полный прогон запускает все 174 теми же
 файлами, а быстрый берёт их часть. Умолчание — полный: файл становится быстрым только
 явно и с причиной, поэтому новое дорогое не может тихо уехать в быстрый. Стерегут это
 объявление `test/suites.test.js` (полнота классификации и причина у каждого файла) и
@@ -319,7 +320,7 @@ deльт задан один раз и по артефакту: рост зел
 строки в `src/table.css` плюс пересборка эталона артефакта, больше цвета нигде нет.
 
 **Левая панель страницы — дерево файлов проекта** (`REFACTOR.md` R-2.4, каталог
-путей — `CHANGELOG.md` 2.2.0). Дерево строится по путям проекта, а не по одним
+путей — `CHANGELOG.md` 2.2.0, складывание папок — 2.3.0). Дерево строится по путям проекта, а не по одним
 колонкам, поэтому в нём видно и то, что в отчёт не попало: такой лист — подпись без
 галочки с причиной во всплывающей строке («колонкой быть не может» — правило пакета
 — или «в набор колонок не попал» — выбор проекта), а счётчик папки со смешанным
@@ -329,11 +330,16 @@ deльт задан один раз и по артефакту: рост зел
 папки три состояния — все её файлы включены, часть, ни одного, — и переключатель
 папки ведёт за собой всё поддерево; рядом стоит число файлов. Своего состояния у
 папки и у быстрой кнопки категории нет: обе переставляют галочки файлов, поэтому
-дерево, кнопки и таблица не могут разойтись. Список файлов длиннее панели
+дерево, кнопки и таблица не могут разойтись. У каждой папки есть ещё свой знак
+(▾/▸): он отвечает за то, сколько дерева видно, — это дело смотрящего, а не выбор
+читателя, поэтому знак помнится между заходами и в ссылку не идёт (у записи свой
+ключ и тот же паспорт отчёта; разворот всех папок её убирает, как возврат галочек —
+запись выбора). Список файлов длиннее панели
 прокручивается, а не выталкивает таблицу, — и прокрутка эта одна: на широком
-экране листается панель целиком (дерево в ней видно целиком: 23 подписи из 23 при
-окне 1440×900), а на узком — сам список, потому что там панель растёт вместе со
-страницей.
+экране листается панель целиком (при окне 1440×900 страница укладывается в окно, а
+таблица берёт всю оставшуюся высоту), а на узком — сам список, потому что там
+панель растёт вместе со страницей. Дерево стало длинным (в этом репозитории 148
+подписей), поэтому папки и складываются: иначе до его середины не добраться.
 
 **На широком экране панель стоит слева от таблицы и не вытесняет числа**
 (от 900 px, `src/page/app.css`). Это не украшение: на десктопе бокового места
@@ -561,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` | Сборка страницы: данные, оформление и программа в одном файле без внешних ссылок |
@@ -686,7 +692,7 @@ pnpm add -D @vernikr/size-report
 ```
 
 Пакет **опубликован в реестре**, и публично: `npm view @vernikr/size-report
-version` отвечает `2.2.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` принимают то же
 имя; ни ключа, ни ссылки на репозиторий не нужно.
 
@@ -694,11 +700,11 @@ version` отвечает `2.2.0`, `npm access get status @vernikr/size-report`
 реестра, но остаётся привязанной к ревизии:
 
 ```bash
-pnpm add -D github:vernikr/size-report#v2.2.0
+pnpm add -D github:vernikr/size-report#v2.3.0
 ```
 
 Без сети (или если тянуть из codeload нечем) — тарболл: `pnpm pack` в клоне
-пакета, затем `pnpm add -D ./vernikr-size-report-2.2.0.tgz`.
+пакета, затем `pnpm add -D ./vernikr-size-report-2.3.0.tgz`.
 
 **Почему тег, а не sha.** Короткий sha pnpm разрешает только через видимые рефы, а
 `git ls-remote` отдаёт одни верхушки веток: пока ревизия — верхушка, короткий sha
@@ -706,7 +712,7 @@ pnpm add -D github:vernikr/size-report#v2.2.0
 <sha> to a commit`. Это не рассуждение, а проба: короткий пин `6530237` ставился,
 пока `main` стоял на нём, и перестал — на следующем же коммите, а тот же sha
 целиком поставился. Имя ветки (`#main`) или тег принимаются оба, но ветка —
-движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v2.2.0`, он же и в
+движущаяся цель, а тег постоянен: этот выпуск стоит на теге `v2.3.0`, он же и в
 примере (сорок знаков тоже годятся, но их придётся брать глазами из истории).
 
 Ревизия в примере — не украшение, а часть утверждения: она закреплена за тем, что
@@ -739,8 +745,10 @@ pnpm exec size --init      # закрепить выведенное в size-tab
 ```
 
 Начинать с настроек не нужно: без файла инструмент выводит их из проекта — колонками
-берёт крупнейшие файлы, по одному от каждого расширения (иначе отчёт состоял бы из
-одних крупных `.md`, и ни один `.js` не попал бы под настоящее сжатие), журналом —
+берёт **каждый отслеживаемый git файл, который можно измерить** (отчёт называет
+объём проекта, а не выборки из него; границы остались только у того, что колонкой
+быть не может: сам отчёт, замки зависимостей, собранное, незнакомый формат и файл
+сверх 512 КБ), а прочие называет в `skip`, журналом —
 первый знакомый (`WORKLOG.md`, `CHANGELOG.md`, …), файлом отчёта — `docs/`, если
 каталог есть, командой починки — объявленный скрипт `sizes`, а без него — путь
 к установленному пакету (его цитируют подпись отчёта и отказы, поэтому он обязан
@@ -750,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.2.0",
+  "version": "2.3.0",
   "author": "vernikr",
   "repository": {
     "type": "git",
@@ -66,7 +66,7 @@
     "report"
   ],
   "devDependencies": {
-    "@vernikr/size-report": "2.1.0",
+    "@vernikr/size-report": "2.2.0",
     "c8": "10",
     "dependency-cruiser": "17",
     "eslint": "^9.18.0",

package/src/locales.js

@@ -20,6 +20,10 @@ export const LOCALES = {
       files: 'Файлы',
       dir: 'все файлы папки {name} ({n})',
       dirNone: 'ни один файл папки {name} в отчёт не попал (в папке {n})',
+      /* Знак сложенной папки — своя цель нажатия: галочка отвечает за числа,
+       * знак — за то, сколько дерева видно. */
+      foldClose: 'свернуть папку {name}',
+      foldOpen: 'развернуть папку {name}',
       /* Причина — у листа: в дереве он подписью, а не галочкой, и без этих слов
        * читатель решил бы, что файл потерялся. */
       notMeasuredRule: 'не измеряется: такой файл колонкой быть не может'
@@ -78,6 +82,8 @@ export const LOCALES = {
       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'

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 на поле ввода), и вспомогательные
  * технологии. */

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

@@ -63,6 +63,8 @@ function uiText(page, loc) {
     files: page.files,
     dir: page.dir,
     dirNone: page.dirNone,
+    foldClose: page.foldClose,
+    foldOpen: page.foldOpen,
     all: page.all,
     linkForeign: page.linkForeign,
     linkBroken: page.linkBroken,

package/src/page/panel.js

@@ -1,5 +1,5 @@
 import { appEl, appBox } from './dom.js';
-import { appData, appUi, appView, appFileAt, appMeasured } from './state.js';
+import { appData, appUi, appView, appFileAt, appFoldSet, appMeasured } from './state.js';
 
 /* Галочку файла ставит только файл: и категория, и папка в дереве — способы
  * переставить те же галочки сразу группой, а своего состояния у них нет. Иначе
@@ -71,6 +71,20 @@ function appDirHead(name, sub) {
   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) {
@@ -82,14 +96,18 @@ function appLeaves(node) {
 }
 
 /* Узлы одного уровня: сперва папки по алфавиту, затем листья (их порядок — из
- * `appLeaves`). */
-function appTreeList(node) {
+ * `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(appFoldBox(name, here));
     li.appendChild(appDirHead(name, sub));
-    li.appendChild(appTreeList(sub));
+    if (appView.folded[here] !== true) li.appendChild(appTreeList(sub, here));
     list.appendChild(li);
   });
   appLeaves(node).forEach((leaf) => {
@@ -123,7 +141,7 @@ function appTree() {
   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); });
 
@@ -231,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,8 +238,9 @@ 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)
   };

package/templates/README.md

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