@vernikr/size-report 2.8.9 → 2.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vernikr/size-report",
-  "version": "2.8.9",
+  "version": "2.9.1",
   "author": "vernikr",
   "repository": {
     "type": "git",
@@ -65,7 +65,7 @@
     "report"
   ],
   "devDependencies": {
-    "@vernikr/size-report": "2.8.8",
+    "@vernikr/size-report": "2.9.0",
     "c8": "10",
     "dependency-cruiser": "17",
     "eslint": "^9.18.0",

package/src/locales.js

@@ -36,23 +36,17 @@ export const LOCALES = {
       categoryFromConfig: 'из настроек',
       categoryByExtension: 'по расширению',
       all: 'все',
-      sub: '{tool} {version} · {artifact}',
       panelMethod: 'способ:',
       emptyMetrics: 'Ни одна метрика не выбрана — таблицу не из чего собрать. '
         + 'Включите хотя бы одну в панели выше: без метрик нет ни одной колонки с числом.',
       noFiles: 'Ни один файл не выбран: в таблице остался только общий объём. '
         + 'Включите файл в панели выше, чтобы увидеть его колонки.',
-      linkForeign: 'Ссылка собрана в другом отчёте и не применена: показано то, что '
-        + 'выбрано в этом браузере. Адрес не тронут.',
       linkBroken: 'В адресе испорченный выбор — прочитать его не удалось. Показано то, '
         + 'что выбрано в этом браузере.',
       linkExtra: 'Часть ссылки пропущена: в этом отчёте нет {n} названных имён. '
         + 'Остальное применено.',
       unpack: 'Данные отчёта сжаты, а браузер не умеет их распаковать: в нём нет DecompressionStream. '
-        + 'Обновите браузер — таблицу показывать не из чего.',
-      note: 'Абсолютные размеры стоят один раз — в строке «{now}». Строк: {rows}: коммиты без '
-        + 'изменения объёма и коммиты, тронувшие только выключенные файлы, строк не получают. '
-        + 'Собрано из истории git: {command}.'
+        + 'Обновите браузер — таблицу показывать не из чего.'
     },
     note: {
       intro: 'Строка — коммит, колонка — файл. ',
@@ -94,14 +88,11 @@ export const LOCALES = {
       categoryFromConfig: 'from the settings',
       categoryByExtension: 'by extension',
       all: 'all',
-      sub: '{tool} {version} · {artifact}',
       panelMethod: 'method:',
       emptyMetrics: 'No metric is selected — there is nothing to build the table from. '
         + 'Turn on at least one above: without metrics there is no column holding a number.',
       noFiles: 'No file is selected: the table shows the total only. '
         + 'Turn on a file above to see its columns.',
-      linkForeign: 'The link was built for another report, so it is not applied: you '
-        + 'see what this browser has. The address is left as it is.',
       linkBroken: 'The choice in the address is unreadable. You see what this browser '
         + 'has.',
       linkExtra: 'Part of the link is skipped: this report has none of the {n} names '
@@ -109,10 +100,7 @@ export const LOCALES = {
       /* The report's data lies in the file compressed and the browser unpacks it; this text is what a
        * browser without `DecompressionStream` gets instead of an empty table. */
       unpack: 'The report\u2019s data is compressed and this browser cannot unpack it: there is no '
-        + 'DecompressionStream. Update the browser — there is nothing to build the table from.',
-      note: 'Absolute sizes appear once — in the “{now}” row. Rows: {rows}: commits that change '
-        + 'no number, and commits touching only the disabled files, get no row. '
-        + 'Collected from git history: {command}.'
+        + 'DecompressionStream. Update the browser — there is nothing to build the table from.'
     },
     note: {
       intro: 'A row is a commit, a column is a file. ',

package/src/page/app.css

@@ -31,11 +31,10 @@ body {
   font: 14px/1.5 ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
   -webkit-text-size-adjust: 100%;
 }
-h1 { margin: 0 0 3px; font-size: 21px; font-weight: 650; letter-spacing: -.012em; }
-.sub { margin: 0 0 calc(var(--gap) + 4px); color: var(--muted); font-size: 12.5px; }
+h1 { margin: 0 0 9px; font-size: 21px; font-weight: 650; letter-spacing: -.012em; }
 
 /* The panel of choices is a card: it separates the controls from the data and does not merge with the table that begins
- * below. */
+ * below. The report's heading opens it: the page has no band above the numbers (the markup is in `src/page/build.js`). */
 .panel {
   margin: 0 0 var(--gap);
   padding: 12px 14px 13px;
@@ -54,10 +53,6 @@ h1 { margin: 0 0 3px; font-size: 21px; font-weight: 650; letter-spacing: -.012em
   letter-spacing: .07em;
 }
 .panel .row { display: flex; flex-wrap: wrap; gap: 3px 6px; align-items: center; }
-/* The way of counting is visible text under the switches: the token dictionary and the way of compression come from the
- * settings of the run rather than from a checkbox, so pointing a mouse is not enough — the reader has to see what produced
- * the number. */
-.panel .about { margin: 5px 0 0; color: var(--muted); font-size: 11.5px; }
 
 /* The file tree: nesting is shown by an indent and a level line, and a folder is a switch like a file — only its checkbox
  * answers for the whole subtree, while the number beside it says for how many files. The list is longer than the window,
@@ -155,9 +150,6 @@ h1 { margin: 0 0 3px; font-size: 21px; font-weight: 650; letter-spacing: -.012em
 }
 .state[hidden], .shell[hidden] { display: none; }
 
-.note { margin: 14px 0 0; max-width: 90em; color: var(--muted); font-size: 12px; }
-.note code { background: var(--tint); padding: 0 3px; border-radius: 3px; }
-
 /* The keyboard: the focus ring is visible on any background (the system accent colour) and shifts no layout. Journal links
  * and every switch are reachable with Tab. */
 :focus-visible { outline: 2px solid AccentColor; outline-offset: 2px; border-radius: 3px; }
@@ -169,10 +161,10 @@ h1 { margin: 0 0 3px; font-size: 21px; font-weight: 650; letter-spacing: -.012em
  *
  * The layout is a grid on `body` rather than a wrapper in the markup: the page is assembled by pasting chapters
  * (`src/page/build.js`), and adding nodes to it for the sake of styling would mean changing the page's shape in two places
- * instead of one. There are five rows, named by subject: the heading, the message about a link, the **working row**, the
- * empty state and the note. Only the working row stretches — the table gets all the remaining height and the panel no more
- * than that; the panel's own height is not "whatever came out" (it would push the table off the screen) but that same
- * working row, inside which it scrolls: a file list longer than the window is the usual case.
+ * instead of one. There are three rows, named by subject: the message about a link, the **working row** and the empty
+ * state — while the panel of choices spans them all in the left column, its heading inside it. Only the working row
+ * stretches: the table gets all the remaining height and the panel no more than that; the panel's own height is not
+ * "whatever came out" (it would push the table off the screen) but that same working row, inside which it scrolls.
  *
  * The threshold of 900px is the same as the adaptations' below: one border between "wide" and "narrow", or the page would
  * be left with no rule at all between two thresholds. */
@@ -185,21 +177,18 @@ h1 { margin: 0 0 3px; font-size: 21px; font-weight: 650; letter-spacing: -.012em
     overflow: auto;
     display: grid;
     grid-template-columns: minmax(230px, 300px) minmax(0, 1fr);
-    grid-template-rows: auto auto minmax(0, 1fr) auto auto;
+    grid-template-rows: auto minmax(0, 1fr) auto;
     column-gap: var(--gap);
     align-items: stretch;
   }
-  header { grid-area: 1 / 1 / 2 / -1; }
-  #notice { grid-area: 2 / 2 / 3 / 3; }
-  #shell { grid-area: 3 / 2 / 4 / 3; }
-  #state { grid-area: 4 / 2 / 5 / 3; align-self: start; }
-  #note { grid-area: 5 / 2 / 6 / 3; }
+  #notice { grid-area: 1 / 2 / 2 / 3; }
+  #shell { grid-area: 2 / 2 / 3 / 3; }
+  #state { grid-area: 3 / 2 / 4 / 3; align-self: start; }
   /* The working row runs the full height, as the table does: the panel ends where it ends. The panel scrolls rather than the
-   * page. It has no top padding here: the list drives under it, and the sticky row of categories would stand not flush with
-   * the edge but under a band of passing files. The padding has not gone anywhere — it is on the first field and travels
-   * away with it. */
-  #panel { grid-area: 2 / 1 / -1 / 2; min-height: 0; margin-bottom: 0; padding-top: 0; overflow: auto; }
-  .panel > fieldset:first-child { padding-top: 12px; }
+   * page, and its top padding is gone: the heading carries that room instead and travels away with the list, while the
+   * sticky row of categories stands flush with the card's edge rather than under a band of passing rows. */
+  .panel { grid-area: 1 / 1 / -1 / 2; min-height: 0; margin-bottom: 0; padding-top: 0; overflow: auto; }
+  .panel h1 { padding-top: 12px; }
   /* Here the row rather than the window sets the table's height: it needs a height rule of its own only in a narrow window,
    * where the whole page scrolls. */
   .shell { max-height: none; }
@@ -217,7 +206,7 @@ h1 { margin: 0 0 3px; font-size: 21px; font-weight: 650; letter-spacing: -.012em
   }
   /* Without metrics there is no table, and a stretched empty row has no place there: the empty state takes the free space of
    * that row rather than the band above it. */
-  body:has(#shell[hidden]) #state { grid-area: 3 / 2 / 4 / 3; }
+  body:has(#shell[hidden]) #state { grid-area: 2 / 2 / 3 / 3; }
 }
 
 /* Adaptations: the one place where the page overrides the shared geometry — because the shared part is frozen by the
@@ -226,7 +215,7 @@ h1 { margin: 0 0 3px; font-size: 21px; font-weight: 650; letter-spacing: -.012em
  * empty space under it at that single window size. */
 @media (max-width: 899px) {
   body { padding: 14px 14px 32px; }
-  h1 { font-size: 18px; }
+  h1 { font-size: 19px; }
   #grid { font-size: 12px; }
   .shell { max-height: calc(100vh - 260px); }
   /* The commit column keeps its width on a narrow screen, and that is deliberate rather than forgotten: the numbers

package/src/page/app.js

@@ -14,14 +14,6 @@ import { appPanel, appPanelAll, appPanelState } from './panel.js';
 // The table's window: made once, at the first drawing.
 let appCache = null;
 
-/* The note under the table: what a row is and how the report was made. It does not depend on the choice, so it is
- * written once — with the table rather than with every drawing of it. */
-function appNote() {
-  document.getElementById('note').textContent = appUi.note
-    .replace('{rows}', appData.rows.length)
-    .replace('{command}', appData.report.fixCommand);
-}
-
 /* What the empty states are told: how many metrics and how many files are left. The window stands there in either
  * case — the words are about what is shown. */
 export function appCounts() {
@@ -76,7 +68,6 @@ export function appSwitchMetric() {
 function appFirst() {
   appPanel();
   appCache = appTable(document.getElementById('grid'));
-  appNote();
   appPaint();
 }
 

package/src/page/build.js

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import zlib from 'zlib';
-import { fill, LOCALES } from '../locales.js';
+import { LOCALES } from '../locales.js';
 import { PAGE_CSS, TABLE_CSS } from '../css.js';
 import { assertCompilable, stripCss, stripJs, stripLines } from '../strip.js';
 
@@ -71,16 +71,6 @@ export function pageScript() {
   return code;
 }
 
-/* The note under the heading: what built the report and where it lies. The path is plain text rather than a link: the
- * page opens from disk and depends on nothing. */
-function subText(data, page) {
-  return fill(page.sub, {
-    tool: data.tool.name,
-    version: data.tool.version,
-    artifact: data.report.artifact
-  });
-}
-
 /* The page's texts: column captions, panel labels, the legend and the empty states. They are the page's dictionary
  * rather than the report's: the data block carries none of them, and the report's own words live in the locale. */
 function uiText(page, loc) {
@@ -95,7 +85,6 @@ function uiText(page, loc) {
     foldClose: page.foldClose,
     foldOpen: page.foldOpen,
     all: page.all,
-    linkForeign: page.linkForeign,
     linkBroken: page.linkBroken,
     linkExtra: page.linkExtra,
     /* What a host that cannot unpack the block is told: the page's one message about its own file rather than about
@@ -114,9 +103,7 @@ function uiText(page, loc) {
     categoryByExtension: page.categoryByExtension,
     methodLabel: page.panelMethod,
     empty: page.emptyMetrics,
-    noFiles: page.noFiles,
-    /* {command} is substituted by the page, which holds the data, while {now} is filled in here. */
-    note: page.note.replace(/\{now\}/g, loc.now)
+    noFiles: page.noFiles
   };
 }
 
@@ -208,13 +195,13 @@ export function pagePayload(data) {
   const out = {
     schema: 2,
     tool: data.tool,
-    /* The report's own words are the ones the page reads: `heading` is the artifact's `<h1>` and `journal` is null
-     * today, so neither is carried — the page builds no heading and prints no journal. */
+    /* The report's own words are the ones the page reads: `heading` is the artifact's `<h1>`, built before the block,
+     * `journal` is null today, and `fixCommand` belongs to a refusal and to the contract rather than to the page, which
+     * builds no heading, prints no journal and suggests no command. */
     report: {
       locale: data.report.locale,
       title: data.report.title,
       artifact: data.report.artifact,
-      fixCommand: data.report.fixCommand,
       showSha: data.report.showSha
     },
     hrefPrefix: prefix,
@@ -248,20 +235,22 @@ export function pagePacked(text) {
 }
 
 /* The report's page is one file: the data lies in it, the script is pasted in, there are no external references. Hence
- * it opens with a double click and works without a network. */
+ * it opens with a double click and works without a network.
+ *
+ * The page's chrome is the panel and the table, and nothing stands above the numbers: the heading opens the panel — the
+ * one place holding the reader's own controls — and neither the tool, nor its version, nor the artifact's path is printed
+ * anywhere, the file lying in a directory whose name already says where. The panel's card is the markup's and its fields
+ * are the script's: `#panel` is emptied and rebuilt on every opening, hence the heading is the card's other child. */
 export function pageHtml(data, cfg) {
   const loc = LOCALES[cfg.locale];
   return '<!doctype html>\n<html lang="' + esc(loc.html) + '">\n<head>\n<meta charset="utf-8">\n'
     + '<meta name="viewport" content="width=device-width, initial-scale=1">\n'
     + '<title>' + esc(data.report.title) + '</title>\n<style>\n'
     + squeezedCss(TABLE_CSS) + '\n' + squeezedCss(PAGE_CSS) + '\n</style>\n</head>\n<body>\n'
-    + '<header>\n<h1>' + esc(data.report.heading) + '</h1>\n'
-    + '<p class="sub">' + esc(subText(data, loc.page)) + '</p>\n</header>\n'
-    + '<div id="panel" class="panel"></div>\n'
+    + '<div class="panel">\n<h1>' + esc(data.report.heading) + '</h1>\n<div id="panel"></div>\n</div>\n'
     + '<p id="notice" class="notice" hidden></p>\n'
     + '<div id="shell" class="shell"><div id="grid" class="grid"></div></div>\n'
     + '<p id="state" class="state" hidden></p>\n'
-    + '<p id="note" class="note"></p>\n'
     + '<script type="application/octet-stream" id="data" data-pack="base64+gzip">'
     + pagePacked(jsonInHtml(pagePayload(data))) + '</script>\n'
     + '<script type="application/json" id="ui">' + jsonInHtml(uiText(loc.page, loc)) + '</script>\n'

package/src/page/panel.js

@@ -1,5 +1,5 @@
 import { appEl, appBox, appOffBox } from './dom.js';
-import { appData, appUi, appView, appFileAt, appFoldSet, appMeasured } from './state.js';
+import { appCatOf, appData, appUi, appView, appFileAt, appFoldSet, appMeasured } from './state.js';
 
 /* Only a file sets a file's checkbox: both a category and a folder in the tree are ways to set the same checkboxes as
  * a group and keep no state of their own. Otherwise one and the same decision would live in two places and drift
@@ -188,8 +188,11 @@ export function appPanel() {
   const metrics = appEl('fieldset');
   metrics.appendChild(appEl('legend', null, appUi.metrics));
   const mrow = appEl('div', 'row');
+  /* What a metric is and how its number was obtained stand in the tooltip of the box that switches it: the dictionary
+   * and the minifier come from the run's settings, so the reader has to see with what he is counting, and the box is
+   * where he looks. */
   appData.metrics.forEach((m) => {
-    const box = appBox(m.label, m.note, appView.metrics[m.key], (e) => {
+    const box = appBox(m.label, m.note + ' — ' + appUi.methodLabel + ' ' + m.method, appView.metrics[m.key], (e) => {
       appView.metrics[m.key] = e.target.checked;
       appSwitchMetric();
     }, 'metric');
@@ -197,12 +200,6 @@ export function appPanel() {
     mrow.appendChild(box);
   });
   metrics.appendChild(mrow);
-  /* What produced each number is visible rather than hidden in a tooltip: the token dictionary and the way of
-   * compression are chosen by the settings of the run, the page has nothing to switch them with, and the reader needs
-   * to know this without pointing a mouse. */
-  appData.metrics.forEach((m) => {
-    metrics.appendChild(appEl('p', 'about', m.label + ' — ' + appUi.methodLabel + ' ' + m.method));
-  });
   panel.appendChild(metrics);
 
   const files = appEl('fieldset', 'files');
@@ -211,8 +208,7 @@ export function appPanel() {
    * in the wide layout, which is where the panel scrolls). */
   const cats = appEl('div', 'row cats');
   appData.categories.forEach((cat) => {
-    const idx = [];
-    appData.files.forEach((f, i) => { if (f.category === cat.key) idx.push(i); });
+    const idx = appCatOf(cat.key);
     const box = appBox(cat.label, appUi.all + ' · ' + cat.label, idx.every((i) => appView.files[i]),
       (e) => appSwitchGroup(idx, e.target.checked), 'all');
     appFields.cat[cat.key] = box.querySelector('input');
@@ -246,19 +242,14 @@ function appDirState(path) {
   input.indeterminate = on > 0 && on < boxes.length;
 }
 
-/* A category's field from its files — the same rule, taken from the data: a category's files are named by the
- * category itself (`category`), and the boxes of the tree are a different view of the same files. */
+/* A category's field from its files — the same rule, taken from the data: a category's files are named by the category
+ * itself (`appCatOf`), and the boxes of the tree are a different view of the same files. */
 function appCatState(key) {
-  let all = 0;
-  let on = 0;
-  appData.files.forEach((f, i) => {
-    if (f.category !== key) return;
-    all++;
-    if (appView.files[i] === true) on++;
-  });
+  const idx = appCatOf(key);
+  const on = idx.filter((i) => appView.files[i] === true).length;
   const input = appFields.cat[key];
-  input.checked = on === all;
-  input.indeterminate = on > 0 && on < all;
+  input.checked = on === idx.length;
+  input.indeterminate = on > 0 && on < idx.length;
 }
 
 /* The folders a file lies in: the prefixes of its path, from the root down. The tree's folders are exactly those

package/src/page/payload.js

@@ -146,8 +146,9 @@ function appRowOf(p, r, values) {
   };
 }
 
-/* The whole block, unrolled into the dense contract the page reads: `schema: 2` is refused by `appRecordOk`
- * rather than unrolled — a record written for a block of another form describes another choice. */
+/* The whole block, unrolled into the dense contract the page reads: the block is a shape of that contract rather than a
+ * subset of it, so `schema` and `tool` come over with the rest although the page reads neither — the form mark and the
+ * author belong to the answer an agent is given, and one shape is cheaper to keep than two. */
 export function appDecode(p) {
   const keys = p.metrics.map((m) => appText(p, m[0]));
   const hist = appUnroll(p, keys);

package/src/page/state.js

@@ -11,9 +11,10 @@ import { appDecode } from './payload.js';
  * network: the styling arrives in the same file, and the cell markup follows the rules of the shared part of the styling
  * (`clip`, a commit's caption).
  *
- * The panel remembers the reader's choice between visits ("the choice's memory" below): the record is tied to the
- * report's passport and keeps only what is switched off, by name, so someone else's record is not applied while a
- * vanished name simply means nothing. The record stays in the browser's memory and nowhere else: a report opened from
+ * The panel remembers the reader's choice between visits ("the choice's memory" below): one record for the browser, under
+ * a name of this page's own, keeping the fact of a whole category and the names of the files switched off one by one —
+ * only what is off is written down, and a name the report does not hold matches nothing. The choice is the reader's
+ * rather than a report's, since all `file://` pages share one storage, and it stays in the browser: a report opened from
  * disk keeps a clean address, and a link made in an earlier release is still read (`appLinkUse`).
  *
  * The page draws no conclusion about how a number was obtained: the method of each metric arrives in the data, and the
@@ -29,8 +30,6 @@ export let appData = null;
 export let appView = null;
 export let appMetric = null;
 export let appMeasured = null;
-let appKey = null;
-let appFoldKey = null;
 
 /* One place that turns the unpacked block into what the chapters speak: the sparse form is unrolled by the payload
  * chapter into the dense contract every number comes from — snapshots per commit, the texts themselves, "now" as
@@ -43,8 +42,8 @@ let appFoldKey = null;
  * page's tree is the project's tree while the numbers belong to columns only); the name follows the same rule as the
  * choice's record (`appFileAt`), so the tree and the reader's memory cannot drift apart.
  *
- * The key the reader's memory lives under is counted here as well, because it is the report's passport: it depends
- * on the data, and until the block is unpacked there is nothing to count it from. */
+ * What other namings left in this storage go at the same moment (`appSweep`), before anything of the reader's memory is
+ * read. */
 export function appBoot(text) {
   appData = appDecode(JSON.parse(text));
   /* The tree is folded as it opens: a project's tree is longer than the window, and the reader's first look is at a
@@ -55,8 +54,7 @@ export function appBoot(text) {
   appMeasured = {};
   appData.metrics.forEach((m) => { appView.metrics[m.key] = true; appMetric[m.key] = m; });
   appData.files.forEach((_f, i) => { appView.files.push(true); appMeasured[appFileAt(i)] = i; });
-  appKey = 'size-report:' + appPassport();
-  appFoldKey = appKey + ':tree';
+  appSweep();
 }
 
 /* A link is that same choice in the address, under a name of its own: someone else's anchor on the page does not count
@@ -70,6 +68,12 @@ let appTransient = false;
 
 /* -------- the reader's memory of his choice -------- */
 
+/* The two keys of this page's memory: the choice and the unfolded tree. The namespace is this page's own and it is one
+ * for every report — all `file://` pages share a storage, so the memory belongs to the reader rather than to a report. */
+const APP_STORE = 'size-report:';
+const APP_KEY = APP_STORE + 'choice';
+const APP_FOLD_KEY = APP_STORE + 'tree';
+
 /* The name of a file for the record is its path at HEAD, or the last of the settings when the file is already gone from
  * there: that is the name it is recognised by in the report. */
 export function appFileAt(i) {
@@ -77,50 +81,58 @@ export function appFileAt(i) {
   return f.path === null ? f.paths[0] : f.path;
 }
 
-/* The passport's fingerprint: an identifying mark of a record rather than protection against forgery, so 32 bits are
- * enough (FNV-1a). */
-function appHash(text) {
-  let h = 2166136261;
-  for (let i = 0; i < text.length; i++) {
-    h ^= text.charCodeAt(i);
-    h = Math.imul(h, 16777619);
-  }
-  return (h >>> 0).toString(16);
+/* The files of one category, in the order of the data: a category is a group as the engine named it (`category`), and
+ * the panel's boxes, their fields and the record all ask for that group here. */
+export function appCatOf(key) {
+  const idx = [];
+  appData.files.forEach((f, i) => { if (f.category === key) idx.push(i); });
+  return idx;
 }
 
-/* The report's passport: the tool's name, the data schema, the artifact's path, the title and the column labels in the
- * report's order. It is what tells one report from another — the record's key is chosen by it, so a choice made in
- * someone else's report is not picked up. The package version and the top of the history are absent on purpose: this is
- * the same report — updating the tool does not change what a column means, while a grown history is the very history the
- * reader comes back to.
- *
- * Counted once per document: it is a constant of the report, which depends on nothing the reader can change, and every
- * click asks for it (the key of the memory and the passport of the record). A second count would be a second answer
- * waiting to happen, and the labels it reads do not change while the page is open. */
-let appPassportValue = null;
-function appPassport() {
-  if (appPassportValue === null) {
-    appPassportValue = appHash([appData.tool.name, appData.schema, appData.report.artifact,
-      appData.report.title, appData.files.map((f) => f.label).join('|')].join('\n'));
+/* What other namings left in this storage: the memory is read under the two keys above and under nothing else, so any
+ * other name in the namespace is dead weight — an address counted per build, a record of an older form. They go once,
+ * when a report is opened. */
+function appSweep() {
+  try {
+    for (let i = window.localStorage.length - 1; i >= 0; i--) {
+      const key = window.localStorage.key(i);
+      if (key !== null && key.indexOf(APP_STORE) === 0 && key !== APP_KEY && key !== APP_FOLD_KEY) {
+        window.localStorage.removeItem(key);
+      }
+    }
+  } catch (_e) {
+    /* There is no memory (the browser grants this page none): there is nothing to sweep either. */
   }
-  return appPassportValue;
 }
 
-/* One record of the choice: only what is switched off is kept, by name. "Switched on" and "no record" are the same
- * state, hence `null` rather than an empty record — turning every checkbox back on removes the record instead of leaving
- * a trace indistinguishable from a choice. */
+/* One record of the choice: the facts of the groups, the names of the files switched off one by one, and nothing else.
+ *
+ * A category wholly off or wholly on is written down as that fact — the group is named, so a file joining it later is
+ * switched with it and the record does not grow with the project — while a category in the third state cannot speak for
+ * the reader, whose choice was made file by file: those files go into `files` by name, and the category stays out of
+ * `cats`, which is how a group fact differs from no group fact to state.
+ *
+ * "Switched on" and "no record" are the same state, hence `null` rather than an empty record: turning every box back on
+ * removes it instead of leaving a trace indistinguishable from a choice. */
 function appRecord() {
   const metrics = {};
+  const cats = {};
   const files = {};
   appData.metrics.forEach((m) => { if (!appView.metrics[m.key]) metrics[m.key] = false; });
-  appData.files.forEach((_f, i) => { if (!appView.files[i]) files[appFileAt(i)] = false; });
-  const empty = Object.keys(metrics).length === 0 && Object.keys(files).length === 0;
-  return empty ? null : { v: 1, passport: appPassport(), metrics: metrics, files: files };
+  appData.categories.forEach((c) => {
+    const idx = appCatOf(c.key);
+    const on = idx.filter((i) => appView.files[i] === true).length;
+    if (on === idx.length || on === 0) { cats[c.key] = on === idx.length; return; }
+    idx.forEach((i) => { if (appView.files[i] !== true) files[appFileAt(i)] = false; });
+  });
+  const empty = Object.keys(metrics).length === 0 && Object.keys(files).length === 0
+    && Object.keys(cats).every((key) => cats[key] === true);
+  return empty ? null : { v: 1, metrics: metrics, cats: cats, files: files };
 }
 
-// Whether a record is ours and of the right format — one rule for the memory and the address alike.
+// Whether a record is of this format — one rule for the memory and the address alike.
 function appRecordOk(rec) {
-  return rec !== null && typeof rec === 'object' && rec.v === 1 && rec.passport === appPassport();
+  return rec !== null && typeof rec === 'object' && rec.v === 1;
 }
 
 /* A record into the browser's memory or out of it, and what is read back from it: the two halves of the memory, written
@@ -141,7 +153,7 @@ function appKeep(key, rec) {
 }
 
 export function appWrite() {
-  if (!appTransient) appKeep(appKey, appRecord());
+  if (!appTransient) appKeep(APP_KEY, appRecord());
 }
 
 /* What the browser saved under a key: its absence, a foreign record, a broken one and a record of another report amount
@@ -165,10 +177,10 @@ function appAll() {
   appData.files.forEach((_f, i) => { appView.files[i] = true; });
 }
 
-/* What the address says. It answers either with a record of ours or with a refusal (`linkForeign` — a link of another
- * report, `linkBroken` — nothing to read): someone else's or a broken choice is not applied, but it does not stay silent
- * either — otherwise the reader would not understand why he sees something other than what was sent to him. An address
- * without the link's name is no link at all: silence, so as not to argue with the page's ordinary anchors. */
+/* What the address says. It answers either with a record of this format or with a refusal (`linkBroken` — nothing to
+ * read): a choice that cannot be read is not applied, but it does not stay silent either — otherwise the reader would not
+ * understand why he sees something other than what was sent to him. An address without the link's name is no link at
+ * all: silence, so as not to argue with the page's ordinary anchors. */
 function appLinkRead() {
   const hash = window.location.hash || '';
   if (hash.indexOf(APP_LINK) !== 0) return { rec: null, refused: null };
@@ -183,10 +195,7 @@ function appLinkRead() {
       return { rec: null, refused: 'linkBroken' };
     }
   }
-  if (!appRecordOk(rec)) {
-    return { rec: null, refused: rec === null || typeof rec !== 'object' || rec.v !== 1
-      ? 'linkBroken' : 'linkForeign' };
-  }
+  if (!appRecordOk(rec)) return { rec: null, refused: 'linkBroken' };
   return { rec: rec, refused: null, extra: appUnknown(rec) };
 }
 
@@ -227,18 +236,28 @@ export function appLinkUse() {
   return 'none';
 }
 
-// Reading: the reader's own choice, as he left it — another report's record lies under another key.
+// Reading: the reader's own choice, as he left it.
 export function appRead() {
-  return appLoad(appKey);
+  return appLoad(APP_KEY);
 }
 
-/* Applying goes by name: a file is recognised by its path, a metric by its key. A name the report does not hold matches
- * nothing (a column was pointed at another path, a metric was dropped from the settings), while files and metrics that
- * appeared stay switched on — the way someone opening the page for the first time sees them. */
+/* Applying goes by name: a file is recognised by its path, a metric by its key, a category by the key the engine gave
+ * it. A name the report does not hold matches nothing (a column was pointed at another path, a metric was dropped from
+ * the settings), while files, categories and metrics that appeared stay switched on — the way someone opening the page
+ * for the first time sees them.
+ *
+ * The groups go first, the names after them: the file-by-file decision is the finer one, and a record that knows no
+ * groups is applied by its names. */
 export function appApply(rec) {
   const metrics = rec.metrics || {};
+  const cats = rec.cats || {};
   const files = rec.files || {};
   appData.metrics.forEach((m) => { if (metrics[m.key] === false) appView.metrics[m.key] = false; });
+  appData.categories.forEach((c) => {
+    const on = cats[c.key];
+    if (on !== true && on !== false) return;
+    appCatOf(c.key).forEach((i) => { appView.files[i] = on; });
+  });
   appData.files.forEach((_f, i) => { if (files[appFileAt(i)] === false) appView.files[i] = false; });
 }
 
@@ -248,10 +267,9 @@ export function appApply(rec) {
  * what the onlooker looks at rather than about which numbers are read, which is why it never goes into a link and never
  * leaves the browser. The tree opens folded, so **the unfolded folders are what is kept** (`true`) — the default is the
  * absence of the name, the same way "switched on" is the absence of a choice. A folder's name is its path ("src/page"),
- * so a vanished name simply means nothing. `appFoldKey` is set with the model (`appBoot`), for the reason the key itself
- * is. */
+ * so a vanished name simply means nothing. */
 export function appFoldRead() {
-  const rec = appLoad(appFoldKey);
+  const rec = appLoad(APP_FOLD_KEY);
   if (rec === null) return;
   const open = rec.open || {};
   Object.keys(open).forEach((p) => { if (open[p] === true) appView.open[p] = true; });
@@ -263,7 +281,5 @@ export function appFoldSet(path, open) {
   if (open) appView.open[path] = true;
   else delete appView.open[path];
   const names = Object.keys(appView.open);
-  appKeep(appFoldKey, names.length === 0
-    ? null
-    : { v: 1, passport: appPassport(), open: appView.open });
+  appKeep(APP_FOLD_KEY, names.length === 0 ? null : { v: 1, open: appView.open });
 }

package/templates/README.md

@@ -40,7 +40,8 @@ What is worth knowing about the template's values:
   without the optional dependencies, a platform that has none) the tool still works, but says that the
   numbers were counted another way, and returns **code 4** — that is a named different count rather than an
   error of the settings.
-- `fixCommand` — the command the report's signature and the refusals quote. In the template it is
+- `fixCommand` — the command the refusals quote and the contract hands to an agent (the page prints
+  nothing of it). In the template it is
   `node node_modules/@vernikr/size-report/bin/size.js --write` — the path to the installed package inside
   the project. **The package name as a command cannot stand here:** `npx <name>` in a project without the
   installed package goes to the registry and pulls the package over the network, so the advice that is meant