synthesisui 0.16.308 → 0.16.310

package/dist/commands/gaps.js

@@ -26,8 +26,12 @@ export async function gaps(opts) {
         return;
     }
     let ledger;
+    /** A régua única - ver `describeValueRuler`. Ausente num censo medido antes de 0.16.308. */
+    let values;
     try {
-        ledger = JSON.parse(raw).ledger;
+        const census = JSON.parse(raw);
+        ledger = census.ledger;
+        values = census.values?.classes ?? undefined;
     }
     catch {
         console.log(body(`${path} is not readable JSON.`));
@@ -42,7 +46,7 @@ export async function gaps(opts) {
         console.log(body(`This measurement was written by a tool version that did not count style fragments yet, so the numbers do not exist rather than being zero. Run \`synthesisui import --dry\` again with ${opts.cli} to measure.`));
         return;
     }
-    for (const line of describeTriage(triageLedger(ledger, opts.cli)))
+    for (const line of describeTriage(triageLedger(ledger, opts.cli), values))
         console.log(body(line));
     /**
      * E O QUE A CAMADA GLOBAL JÁ LEVOU - o desconto, sem o qual este comando repete a mentira que ele

package/dist/commands/import.js

@@ -1849,7 +1849,29 @@ export async function takeCensus(root, opts) {
      * AS LEIS DAS PÁGINAS, ditas onde a arquitetura já é dita - governam o sistema, não uma peça,
      * então `applies` é vazio e elas chegam a todo prompt. Ver `pageLaws`.
      */
-    const ledgerLines = describeLedger(ledger);
+    /**
+     * A CONTABILIDADE POR VALOR, contada AQUI porque o material é daqui: os tokens de classe que
+     * vestem cada componente admitido (os nós do sketch e as camadas condicionais cruas), contra
+     * os tokens que o CSS dele declara. Ver `Census.values` e `doctor/value-ledger.ts` - é a
+     * reconciliação do item 11, e a soma fecha com `seen` por construção.
+     *
+     * ANTES do relatório do ledger de propósito: "quanto vocês entenderam?" tem UMA resposta (dono,
+     * 26/08), e é esta régua - a mesma que a tela usa. A frase do ledger passa a liderar com ela.
+     */
+    const valueByComponent = {};
+    for (const [lookName, look] of Object.entries(looks)) {
+        const tokens = [];
+        for (const node of look.sketch ?? []) {
+            tokens.push(...(node.classes ?? "").split(/\s+/).filter(Boolean));
+        }
+        for (const layer of look.rawLayers ?? [])
+            tokens.push(...layer.classes);
+        if (tokens.length > 0) {
+            valueByComponent[lookName] = accountClasses(tokens, declaredValues);
+        }
+    }
+    const valuesTotal = sumAccounts(Object.values(valueByComponent));
+    const ledgerLines = describeLedger(ledger, valuesTotal);
     if (ledgerLines.length > 0) {
         say("");
         say(section("Every style fragment, accounted for"));
@@ -2138,25 +2160,6 @@ export async function takeCensus(root, opts) {
         const target = c?.canonical ?? (c?.bucket === "exclusive" ? c.name : null);
         return target ? safePartName(target) : null;
     }, (pkg) => versions[pkg]);
-    /**
-     * A CONTABILIDADE POR VALOR, contada AQUI porque o material é daqui: os tokens de classe que
-     * vestem cada componente admitido (os nós do sketch e as camadas condicionais cruas), contra
-     * os tokens que o CSS dele declara. Ver `Census.values` e `doctor/value-ledger.ts` - é a
-     * reconciliação do item 11, e a soma fecha com `seen` por construção.
-     */
-    const valueByComponent = {};
-    for (const [lookName, look] of Object.entries(looks)) {
-        const tokens = [];
-        for (const node of look.sketch ?? []) {
-            tokens.push(...(node.classes ?? "").split(/\s+/).filter(Boolean));
-        }
-        for (const layer of look.rawLayers ?? [])
-            tokens.push(...layer.classes);
-        if (tokens.length > 0) {
-            valueByComponent[lookName] = accountClasses(tokens, declaredValues);
-        }
-    }
-    const valuesTotal = sumAccounts(Object.values(valueByComponent));
     return {
         census: 1,
         project: {

package/dist/doctor/gap-triage.js

@@ -20,6 +20,7 @@
  * decisão de escrever é de quem lê - a esteira opinando sobre o nosso backlog no terminal do
  * cliente é ela falando de um assunto que não é dela (dono, 05/08).
  */
+import { describeValueRuler } from "./style-ledger.js";
 /**
  * QUEM É DONO DE CADA FORMA, hoje.
  *
@@ -173,11 +174,23 @@ function isOlder(measured, current) {
  * do não interpretado ser o portão funcionando é a informação mais importante da tela, e ela vem
  * antes de qualquer lista de tarefa.
  */
-export function describeTriage(t) {
+export function describeTriage(t, 
+/**
+ * A RÉGUA ÚNICA (ver `describeValueRuler`): quando o censo carrega o ledger de valores, o
+ * percentual que abre esta tela é o MESMO da tela do sistema e do fim do `import`. Era aqui
+ * que nascia a segunda resposta - "348 fragmentos, 36%" contra os 91% reais do codelevel
+ * (26/08) - e o agente do dono repassou a errada ao cliente.
+ */
+values) {
     const unread = t.counted - t.interpreted;
-    const lines = [
-        `${t.counted} style fragments accounted for, ${t.interpreted} interpreted (${t.percent}%). The ${unread} below are sorted by what to do about them.`,
-    ];
+    const lines = values
+        ? [
+            ...describeValueRuler(values),
+            `The ${unread} style fragments not interpreted are sorted below by what to do about them.`,
+        ]
+        : [
+            `${t.counted} style fragments accounted for, ${t.interpreted} interpreted (${t.percent}%). The ${unread} below are sorted by what to do about them.`,
+        ];
     if (t.stale) {
         lines.push("", `MEASURED BY CLI ${t.measuredBy}, TRIAGED BY ${t.triagedBy}. Re-run \`import\` before concluding anything from the numbers below - a gap here may already be closed, and the work already done.`);
     }

package/dist/doctor/style-ledger.js

@@ -278,14 +278,27 @@ function blank() {
  * nomeia cada lacuna com o número do repo dela. Um percentual sem a contagem atrás é número de
  * marketing, e um zero sem motivo lê como falha nossa.
  */
-export function describeLedger(l) {
+export function describeLedger(l, 
+/**
+ * A RÉGUA ÚNICA - o ledger de valores por declaração (ver `Census.values.classes`). Quando ela
+ * existe, "quanto vocês entenderam?" tem UMA resposta, e é esta: a mesma que a tela usa. O
+ * total de fragmentos continua dito - é a promessa de contabilidade -, mas sem um segundo
+ * percentual competindo (o agente do dono liderou com "36%" quando a leitura real era 91%,
+ * medido no codelevel em 26/08).
+ */
+values) {
     const total = sum(l.counted);
     if (total === 0)
         return [];
     const read = sum(l.interpreted);
-    const lines = [
-        `${total} style fragments in your files, and every one is accounted for: ${read} interpreted (${Math.round((read / total) * 100)}%), ${total - read} listed below with the file and line where each lives.`,
-    ];
+    const lines = values
+        ? [
+            ...describeValueRuler(values),
+            `And every one of the ${total} style fragments in your files is accounted for - the ${total - read} not interpreted are listed below with the file and line where each lives.`,
+        ]
+        : [
+            `${total} style fragments in your files, and every one is accounted for: ${read} interpreted (${Math.round((read / total) * 100)}%), ${total - read} listed below with the file and line where each lives.`,
+        ];
     /**
      * POR FORMA, ANTES DOS GRUPOS. O total responde "quanto"; esta tabela responde "de que jeito o
      * projeto escreve estilo", que é a pergunta que decide qual leitor vale construir. Sem ela, 56%
@@ -319,3 +332,16 @@ export function describeLedger(l) {
 function sum(counts) {
     return Object.values(counts).reduce((n, k) => n + k, 0);
 }
+/**
+ * A frase da régua única, com todo denominador em palavras - `import` e `gaps` a imprimem
+ * IDÊNTICA, porque duas variações da mesma frase viram duas respostas na cabeça de quem lê.
+ * A conta é a da tela: decisões = vistas - estrutura; fechadas = interpretadas + respondidas.
+ */
+export function describeValueRuler(values) {
+    const decisions = values.seen - values.structure;
+    const closed = values.interpreted + values.answered;
+    const percent = decisions > 0 ? Math.round((closed / decisions) * 100) : 0;
+    return [
+        `Of the ${values.seen} class declarations on your components, ${values.structure} are structure (layout plumbing, not design decisions). Of the ${decisions} design decisions, ${closed} are interpreted${values.answered > 0 ? ` (${values.answered} of them answered by you)` : ""} - ${percent}%.`,
+    ];
+}

package/package.json

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