synthesisui 0.16.473 → 0.16.475

package/dist/commands/doctor.js

@@ -385,8 +385,16 @@ measured) {
      * unidade. Uma raiz por tabela seria a forma mais silenciosa de discordar.
      */
     const theirs = await harvestOwnTokens([root], measured);
+    const table = withTheirNames(ours, theirs);
+    /**
+     * AS LARGURAS DO SISTEMA - ver `breakpoints` em `TokenTable`. `var()` não funciona em `@media`, então o `tokens.css`
+     * não as carrega e a escala sai do documento (bateria, 28/09).
+     */
+    const breakpoints = breakpointsOf(documents, table.rootPx);
+    if (breakpoints.size > 0)
+        table.breakpoints = breakpoints;
     return {
-        table: withTheirNames(ours, theirs),
+        table,
         theirs,
         recipes,
         documents,
@@ -1977,3 +1985,17 @@ export async function doctor(opts) {
             process.exitCode = 1;
     }
 }
+/** `foundations.breakpoints` de cada documento instalado, em px - `{ md: "768px" }` -> `md` -> 768. */
+export function breakpointsOf(documents, rootPx) {
+    const out = new Map();
+    for (const doc of documents) {
+        const bps = doc?.foundations?.breakpoints;
+        for (const [name, raw] of Object.entries(bps ?? {})) {
+            const m = /^\s*([\d.]+)(px|rem|em)\s*$/.exec(String(raw));
+            if (!m || out.has(name))
+                continue;
+            out.set(name, m[2] === "px" ? Number(m[1]) : Number(m[1]) * rootPx);
+        }
+    }
+    return out;
+}

package/dist/commands/hook.js

@@ -5,7 +5,7 @@ import { changedSince } from "../changed-files.js";
 import { emptyTally, exportedNames, internalSpecifiers, scanComponentsInto, tallyToInventory, } from "../doctor/components-scan.js";
 import { checkContracts } from "../doctor/contract-check.js";
 import { appendEvent, ledgerPath } from "../doctor/ledger.js";
-import { diagnose, nameToWrite, scanSource } from "../doctor/scan.js";
+import { describeOffScale, diagnose, nameToWrite, scanSource } from "../doctor/scan.js";
 import { declarados, falaDaPrateleira, naPrateleira } from "../doctor/shelf.js";
 import { governs, ungovernedIn } from "../governed.js";
 import { readMode } from "../mode.js";
@@ -307,6 +307,8 @@ async function report(root, filePath, mode) {
      */
     const unnamed = d.findings.filter((f) => !nameToWrite(f));
     const phantoms = d.files.flatMap((f) => f.phantoms ?? []);
+    /** Fora da escala - ver `OffScale` (bateria, 28/09). Entra nas mesmas portas que os `phantoms`. */
+    const offScale = describeOffScale(d.files);
     // Every check leaves one line in the ledger - INCLUDING the clean ones,
     // because a fix is itself a write, so the clean re-check of a file that was
     // just flagged is the evidence the agent read the report and acted. Without
@@ -326,6 +328,7 @@ async function report(root, filePath, mode) {
         broke.length === 0 &&
         named.length === 0 &&
         phantoms.length === 0 &&
+        offScale.length === 0 &&
         unnamed.length === 0) {
         const hello = await greet(root, rel);
         return hello ? say(hello) : null;
@@ -362,7 +365,8 @@ async function report(root, filePath, mode) {
     if (composed.length === 0 &&
         broke.length > 0 &&
         named.length === 0 &&
-        phantoms.length === 0)
+        phantoms.length === 0 &&
+        offScale.length === 0)
         return say(broke.join("\n"));
     const sample = unnamed
         .slice(0, 3)
@@ -371,7 +375,8 @@ async function report(root, filePath, mode) {
     if (composed.length === 0 &&
         broke.length === 0 &&
         named.length === 0 &&
-        phantoms.length === 0)
+        phantoms.length === 0 &&
+        offScale.length === 0)
         return say([
             `${rel} - ${unnamed.length} value${unnamed.length === 1 ? "" : "s"} here ${unnamed.length === 1 ? "has" : "have"} no name in this system, and nothing to replace ${unnamed.length === 1 ? "it" : "them"} with: ${sample}${unnamed.length > 3 ? `, +${unnamed.length - 3} more` : ""}.`,
             "Do not invent a name - leave them, or ask the person what they would call it.",
@@ -419,6 +424,7 @@ async function report(root, filePath, mode) {
     if (phantoms.length > 0) {
         lines.push("", "Names this system does not declare. These look tokenized and apply nothing at all:", ...phantoms.slice(0, 20).map((p) => `  line ${p.line}  ${p.name}`), "", "Use a name the system has, or say which value you need and what you would call it. Do NOT invent a token.");
     }
+    lines.push(...offScale);
     return say(lines.join("\n"));
 }
 /**

package/dist/commands/import.js

@@ -1,4 +1,5 @@
 import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { importMark, writeSyncMark } from "../last-sync.js";
 import { readStyleSheet } from "../doctor/scss-lens.js";
 import { tsTokenObjects, tsTokensAsVars } from "../doctor/ts-tokens-lens.js";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
@@ -5234,6 +5235,12 @@ export async function runImport(opts) {
      * mais longa do produto ficar mais longa no lugar onde ela já é mais difícil de ler.
      */
     if (payload?.slug) {
+        /**
+         * O PONTO DE PARTIDA DO PRIMEIRO `sync` - ver `importMark`. Sem ele, o que o agente cria depois do import nunca é
+         * anunciado (bateria, 28/09: 16 componentes no b7, nenhum dito). Só aqui, com o sistema nascido: um `--dry` não
+         * envia nada, e uma marca sem envio mentiria sobre o que a plataforma tem.
+         */
+        await writeSyncMark(root, importMark(census, opts.cli));
         /**
          * O QUE O CSS DELE AINDA IMPORTA - e este aviso sai do CLI, não da skill.
          *

package/dist/commands/mcp.js

@@ -10,7 +10,7 @@ import { declareForm } from "../doctor/declared-forms.js";
 import { describeTriage, triageLedger } from "../doctor/gap-triage.js";
 import { readEvents } from "../doctor/ledger.js";
 import { fileRequest } from "../doctor/requests.js";
-import { diagnose, nameToWrite, scanSource } from "../doctor/scan.js";
+import { describeOffScale, diagnose, nameToWrite, scanSource } from "../doctor/scan.js";
 import { nearestToken, normalizeValue, tokenFor } from "../doctor/tokens.js";
 import { ruleLine } from "../doctrine.js";
 import { fromCensus } from "../memory/observation.js";
@@ -437,7 +437,10 @@ async function checkFile(root, path) {
     if (phantoms.length > 0) {
         out.push("", "Names this system does not declare. These look tokenized and apply nothing at all:", ...phantoms);
     }
-    if (d.findings.length === 0 && phantoms.length === 0)
+    /** Fora da escala - ver `OffScale` (bateria, 28/09). */
+    const offScale = describeOffScale(d.files);
+    out.push(...offScale);
+    if (d.findings.length === 0 && phantoms.length === 0 && offScale.length === 0)
         out.push("", "Nothing to fix here.");
     return fromContract(out.join("\n"));
 }

package/dist/doctor/scan.js

@@ -534,6 +534,7 @@ const DECLARES_ALL = /(?:^|[\s{;])(--[a-z0-9-]+)\s*:\s*([^;{}]+);/gi;
 function scanCore(file, source, table) {
     const findings = [];
     const phantoms = [];
+    const offScale = [];
     const ownDeclared = [];
     /**
      * OS NOMES SASS DELE, VISTOS PELA LENTE - rodada 10 do refinamento, 27/09. Num `.scss` lido por `scss-lens.ts`,
@@ -653,6 +654,8 @@ function scanCore(file, source, table) {
         }
         for (const name of findPhantoms(line, table))
             phantoms.push({ name, line: at });
+        for (const o of offScaleOf(file, line, table, setAside))
+            offScale.push({ ...o, line: at });
         // Depth at the START of this line, carried before the early return so a
         // blank line inside an <svg> cannot close the region by accident. The
         // per-match depth is recomputed below, because an icon is often written on
@@ -904,6 +907,7 @@ function scanCore(file, source, table) {
         findings,
         tokenUses,
         ...(phantoms.length > 0 ? { phantoms } : null),
+        ...(offScale.length > 0 ? { offScale } : null),
         ...(ownDeclared.length > 0 ? { ownDeclared } : null),
         ...(ownCandidates.size > 0
             ? {
@@ -1066,3 +1070,50 @@ context = []) {
         repeats,
     };
 }
+const MEDIA_WIDTH = /\b(?:(?:min|max)-)?width\s*(?::|[<>]=?)\s*([\d.]+)(px|rem|em)\b/g;
+const TOKEN_ARITHMETIC = /(?:\$\{\s*|:\s*)([A-Za-z_$][\w$]*(?:\.[\w$]+)*\.(?:[\w$]*(?:space|spacing|gap|radius|size|font)[\w$]*)(?:\.[\w$]+)*)\s*([+\-*/])\s*(\d+(?:\.\d+)?)\b/gi;
+const BORDER_WIDTH = /\bborder(?:-(?:top|right|bottom|left))?(?:-width)?\s*:\s*(\d+(?:\.\d+)?px)\b/g;
+const BORDER_NAME = /border|line|hairline|stroke|rule|divider|thin/i;
+/**
+ * FORA DA ESCALA, linha a linha - ver `OffScale`. `setAside` recebe o que foi medido e está certo: o ponto de quebra
+ * na escala é dito pelo nome ("breakpoint md (768px), on your system's scale"), para o silêncio ter motivo.
+ */
+function offScaleOf(file, line, table, setAside) {
+    const out = [];
+    const scale = table.breakpoints;
+    if (scale && scale.size > 0 && /^@media\b/.test(line)) {
+        for (const m of line.matchAll(MEDIA_WIDTH)) {
+            const n = Number(m[1]);
+            const px = m[2] === "px" ? n : n * table.rootPx;
+            let best = null;
+            for (const [name, bp] of scale)
+                if (!best || Math.abs(bp - px) < Math.abs(best[1] - px))
+                    best = [name, bp];
+            if (!best)
+                continue;
+            if (Math.abs(best[1] - px) < 0.5)
+                setAside(`breakpoint ${best[0]} (${best[1]}px), on your system's scale`);
+            else
+                out.push({ literal: `${m[1]}${m[2]}`, why: "breakpoint", nearest: `${best[0]} ${best[1]}px` });
+        }
+    }
+    if (/\.(t|j)sx?$/.test(file))
+        for (const m of line.matchAll(TOKEN_ARITHMETIC))
+            out.push({ literal: `${m[1]} ${m[2]} ${m[3]}`, why: "arithmetic" });
+    for (const m of line.matchAll(BORDER_WIDTH)) {
+        const v = normalizeValue(m[1], table.rootPx);
+        const theirs = [table.aliases.get(`spacing:${v}`), table.aliases.get(`radius:${v}`)].find((a) => a && BORDER_NAME.test(a.name));
+        if (theirs)
+            out.push({ literal: m[1], why: "named", nearest: `var(${theirs.name})` });
+    }
+    return out;
+}
+/** As linhas que o `check_file` e o fim do turno dizem sobre `OffScale` - uma frase por caso, a mesma nos dois. */
+export function describeOffScale(files) {
+    const rows = files.flatMap((f) => (f.offScale ?? []).map((o) => o.why === "breakpoint"
+        ? `  ${f.file}:${o.line}  ${o.literal} - a breakpoint off your system's widths; the nearest is ${o.nearest} (a media query cannot use a token, so match the width)`
+        : o.why === "arithmetic"
+            ? `  ${f.file}:${o.line}  ${o.literal} - arithmetic on a token lands between the steps; use a step the system has, or ask for one`
+            : `  ${f.file}:${o.line}  ${o.literal} - this repo calls it ${o.nearest}`));
+    return rows.length > 0 ? ["", "Off this system's scale:", ...rows] : [];
+}

package/dist/install-marks.js

@@ -485,7 +485,17 @@ export const COUNTED_DIFFERENTLY = "this run counts a value as named only when Y
  * `:root { --q-stone: #44403c; … }` de uma linha atribui ao token. Um hook anterior manda trocar a definição pelo
  * próprio nome, e quem obedece apaga a cor.
  */
-export const CHECKER_SINCE = "0.16.473";
+/**
+ * 0.16.473 -> 0.16.474 em 28/09, e o passo 1 dá **SIM** (a bateria, b5): o que o fim do turno diz de um componente novo
+ * passa a medir as regras da folha global que ele veste pelo `className`. Um hook anterior diz "no colour or spacing of
+ * its own to measure" sobre o componente de um projeto que estiliza por classe global.
+ */
+/**
+ * 0.16.474 -> 0.16.475 em 28/09, e o passo 1 dá **SIM** (a bateria, e a régua dele de 17:39-17:41): o fim do turno diz o
+ * que sai da escala - o ponto de quebra fora das larguras do sistema, a conta em cima de um token, e o `1px` de borda
+ * num projeto que tem nome para ele. Um hook anterior aprova os três.
+ */
+export const CHECKER_SINCE = "0.16.475";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *

package/dist/last-sync.js

@@ -45,6 +45,26 @@ components) {
     }
     return out;
 }
+/**
+ * A MARCA QUE O IMPORT DEIXA - o ponto de partida do primeiro `sync`. Bateria, 28/09 (b7): um projeto sem componente
+ * ganhou 16 ao longo de cinco telas e nenhum foi anunciado, porque só o `sync` gravava marca e `whatGrew` sem marca
+ * anterior não anuncia nada. Os mesmos campos que o `sync` grava, lidos do mesmo censo - nunca uma segunda conta.
+ * `components` é o que o censo admitiu, que é o que o import envia.
+ */
+export function importMark(census, cli) {
+    const sum = (r) => Object.values(r ?? {}).reduce((n, v) => n + v, 0);
+    const readings = fingerprintReadings(census.components);
+    return {
+        at: new Date().toISOString(),
+        components: Object.keys(readings).length,
+        declarations: census.coverage?.declarations ?? 0,
+        seen: sum(census.ledger?.counted),
+        interpreted: sum(census.ledger?.interpreted),
+        unread: Object.fromEntries((census.ledger?.unread ?? []).map((g) => [g.reason ?? "unknown", g.uses ?? 0])),
+        ...(cli ? { cli } : {}),
+        readings,
+    };
+}
 const path = (root) => join(root, "_synthesisui", LAST_SYNC_FILE);
 export async function readSyncMark(root) {
     try {

package/dist/what-grew.js

@@ -16,12 +16,16 @@ before) {
         return { born: [], gone };
     const { table } = await loadSystem(root).catch(() => ({ table: null }));
     const context = [];
+    /** As folhas GLOBAIS (não `.module.*`) - ver `globalRulesFor`. */
+    const globals = [];
     if (table) {
         for await (const file of walkAll([root])) {
             const rel = relative(root, file);
             if (!/\.(css|scss|sass|less)$/i.test(rel))
                 continue;
             const src = await readFile(file, "utf8").catch(() => "");
+            if (src && !/\.module\.[a-z]+$/i.test(rel))
+                globals.push({ rel, src });
             const report = src ? scanSource(rel, src, table) : null;
             if (report?.ownDeclared?.length)
                 context.push(report);
@@ -49,6 +53,17 @@ before) {
             if (css)
                 reports.push(scanSource(sheet, css, table));
         }
+        /**
+         * E AS REGRAS GLOBAIS QUE ELE VESTE - bateria, 28/09 (b5): o componente de um projeto que estiliza por classe global
+         * não importa folha nenhuma, e saía "no colour or spacing of its own to measure".
+         */
+        const worn = classesWorn(src);
+        if (worn.size > 0)
+            for (const g of globals) {
+                const rules = globalRulesFor(g.src, worn);
+                if (rules)
+                    reports.push(scanSource(g.rel, rules, table));
+            }
         const d = diagnose(reports, context);
         /** Classes utilitárias numa string qualquer do arquivo - `className="…"`, `cn("…")`, `cva("…")` (f11, 28/09). */
         const utilities = !d.reach.measured &&
@@ -117,3 +132,26 @@ export async function takeGrowthNote(root) {
         return null;
     }
 }
+/** As classes escritas por extenso no `className` - `className="a b"`, `'a'` ou `` `a b` `` sem interpolação. */
+function classesWorn(src) {
+    const out = new Set();
+    for (const m of src.matchAll(/className=(?:"([^"]*)"|'([^']*)'|\{`([^`$]*)`\})/g))
+        for (const c of (m[1] ?? m[2] ?? m[3] ?? "").split(/\s+/))
+            if (c)
+                out.add(c);
+    return out;
+}
+/**
+ * AS REGRAS DE UMA FOLHA GLOBAL CUJO SELETOR NOMEIA UMA DAS CLASSES QUE ELE VESTE, recortadas como CSS - só o bloco
+ * mais interno (`[^{}]`), então uma regra dentro de `@media` também entra. `null` quando nenhuma casa.
+ */
+function globalRulesFor(css, worn) {
+    const out = [];
+    for (const m of css.matchAll(/([^{}]+)\{([^{}]*)\}/g)) {
+        const selector = (m[1] ?? "").trim();
+        const names = [...selector.matchAll(/\.([A-Za-z_][\w-]*)/g)].map((x) => x[1]);
+        if (names.some((n) => worn.has(n)))
+            out.push(`${selector} { ${(m[2] ?? "").trim()} }`);
+    }
+    return out.length > 0 ? `${out.join("\n")}\n` : null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.16.473",
+  "version": "0.16.475",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {