test/themematrix.test.js

Rama main · réplica de lectura del repositorio original.

import { test } from "node:test";
import assert from "node:assert/strict";
import { themeMatrix, signature } from "../src/themematrix.js";

/**
 * Every theme against every slide type, as a permanent gate.
 *
 * A layout or margin change is cheap to make in one theme and expensive to
 * notice in another: the fitter drops to the readable floor, refuses to go
 * below it, and the slide ships with a body missing. The .pptx still writes,
 * so nothing fails. This runs the whole 38 x 75 product in about three seconds
 * and holds the failure set exactly where it is.
 *
 * ALLOWED is a debt list, not a configuration. Adding a line to it is a
 * decision to ship a slide that cannot seat its text; removing one is the
 * point. The test fails in both directions — a new failure is a regression, a
 * stale entry is a claim about the product that is no longer true.
 */
const ALLOWED = [
  // Empty, and meant to stay that way. It held twelve entries when this sweep
  // was written: the `flow` spine, the `branching-flow` decision label and the
  // `before-after` headings. Every one of them was a constant that decided
  // whether text survived — a 0.26in body budget three thousandths of an inch
  // short of a line, a diamond sized without reference to its label, a card
  // title budgeted one line whatever it held. None of them was visible as a
  // number until this sweep printed it.
  //
  // Adding a line here is a decision to ship a slide that cannot seat its
  // text. Do it only when the alternative is worse, and say why.
];

/**
 * A speaker note reserves 0.7in off the bottom of every content slide, and the
 * specimen carries none — so that 0.7in had never been exercised by any sweep.
 * Turning it on found 29 failures across four types at once. These two are what
 * is left, both on `minimal-muji`, which pairs an inset frame with generous
 * margins. Same discipline as ALLOWED — this list shrinks, never grows.
 * `high-contrast-mono compare` came off it when the verdict bar stopped taking
 * a flat 1.24in from the two cards regardless of what it held, and both
 * `diagram` lines came off when it stopped fitting a body that a dense graph
 * never draws.
 */
const ALLOWED_WITH_NOTES = [
  "minimal-muji feature-grid",
  "minimal-muji feature-grid",
];

test("every theme seats every slide type at a readable size", async () => {
  const result = await themeMatrix();

  const failed = result.runs.filter((r) => r.failed);
  assert.equal(failed.length, 0, `render threw: ${failed.map((r) => `${r.theme}: ${r.problems[0].detail}`).join("; ")}`);

  const now = signature(result);
  const tally = (arr) => arr.reduce((m, k) => m.set(k, (m.get(k) ?? 0) + 1), new Map());
  const have = tally(now), want = tally([...ALLOWED].sort());

  const unexpected = [...have].filter(([k, n]) => n > (want.get(k) ?? 0)).map(([k]) => k);
  assert.deepEqual(
    unexpected, [],
    `new fit failure(s): ${unexpected.join(", ")}\n` +
    `Fix the layout, or record the debt in ALLOWED with why it is acceptable.`,
  );

  const stale = [...want].filter(([k, n]) => n > (have.get(k) ?? 0)).map(([k]) => k);
  assert.deepEqual(
    stale, [],
    `ALLOWED names failure(s) that no longer happen: ${stale.join(", ")}\n` +
    `Delete those lines — the list is debt, and this one is paid.`,
  );
});

test("a speaker note does not cost a slide its text", async () => {
  const result = await themeMatrix({ notes: true });
  const tally = (arr) => arr.reduce((m, k) => m.set(k, (m.get(k) ?? 0) + 1), new Map());
  const have = tally(signature(result)), want = tally([...ALLOWED_WITH_NOTES].sort());

  const unexpected = [...have].filter(([k, n]) => n > (want.get(k) ?? 0)).map(([k]) => k);
  assert.deepEqual(unexpected, [], `a speaker note costs text on: ${unexpected.join(", ")}`);

  const stale = [...want].filter(([k, n]) => n > (have.get(k) ?? 0)).map(([k]) => k);
  assert.deepEqual(stale, [], `ALLOWED_WITH_NOTES names failure(s) that no longer happen: ${stale.join(", ")}`);
});