synthesisui 0.16.299 → 0.16.301

package/dist/commands/gaps.js

@@ -12,7 +12,7 @@
  * E o texto que ele imprime é o que a pessoa manda para quem vai escrever o leitor - por isso ele
  * nomeia o módulo e nunca sugere código.
  */
-import { readFile } from "node:fs/promises";
+import { readdir, readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { describeTriage, triageLedger } from "../doctor/gap-triage.js";
 import { body, section } from "../output.js";
@@ -44,4 +44,79 @@ export async function gaps(opts) {
     }
     for (const line of describeTriage(triageLedger(ledger, opts.cli)))
         console.log(body(line));
+    /**
+     * E O QUE A CAMADA GLOBAL JÁ LEVOU - o desconto, sem o qual este comando repete a mentira que ele
+     * veio consertar.
+     *
+     * MEDIDO no repositório do dono (24/08): a triagem acima diz *"214 fragmentos, 96% do que não foi
+     * interpretado"*, e 141 daquelas declarações estão no sistema dele - `globals.base`,
+     * `globals.utilities`, `globals.properties`. As 22 `@utility` que ele escreveu estão lá com o nome
+     * dele.
+     *
+     * A triagem não está errada: ela responde *"o que nenhum leitor interpretou"*, e uma regra
+     * `::selection` continua sem leitor. O que faltava é que "sem leitor" deixou de significar "sem
+     * lugar" quando a camada global nasceu.
+     *
+     * LIDO DO DOCUMENTO INSTALADO, e não recalculado: quem decide o que entra na camada é o servidor,
+     * e refazer a classificação aqui seria uma segunda opinião livre para discordar da primeira. Sem
+     * sistema instalado não há o que dizer, e o comando cala - que é o caso de quem só rodou
+     * `import --dry`.
+     */
+    const carried = await carriedByGlobals(root);
+    if (carried) {
+        console.log("");
+        console.log(body(`${carried.total} of those declarations are already in your system - ${carried.parts}. They are not component recipes, which is why they count as "not interpreted" above; they did arrive.`));
+    }
+}
+/**
+ * O QUE A CAMADA GLOBAL DO SISTEMA INSTALADO CARREGA - lido, nunca recalculado.
+ *
+ * `null` quando não há sistema instalado, quando o documento não tem camada, ou quando ela está
+ * vazia. Em qualquer um dos três não há nada a dizer, e uma frase que aparece sempre é uma frase que
+ * ninguém lê.
+ */
+async function carriedByGlobals(root) {
+    const dir = join(root, "_synthesisui", "ds");
+    const slugs = await readdir(dir).catch(() => []);
+    for (const slug of slugs) {
+        const lock = join(dir, slug);
+        const versions = await readdir(lock).catch(() => []);
+        /** A maior versão instalada - `v1`, `v2`… - é a que o repositório dele está usando. */
+        const latest = versions
+            .filter((v) => /^v\d+$/.test(v))
+            .sort((a, b) => Number(b.slice(1)) - Number(a.slice(1)))[0];
+        if (!latest)
+            continue;
+        const doc = await readFile(join(lock, latest, "design-system.json"), "utf8").catch(() => null);
+        if (!doc)
+            continue;
+        let globals;
+        try {
+            globals = JSON.parse(doc).globals ?? {};
+        }
+        catch {
+            continue;
+        }
+        const rules = (globals.base ?? []).reduce((n, r) => n + Object.keys(r.declarations ?? {}).length, 0);
+        const utils = Object.values(globals.utilities ?? {}).reduce((n, u) => n + Object.keys(u.declarations ?? {}).length, 0);
+        const props = Object.keys(globals.properties ?? {}).length;
+        const total = rules + utils + props;
+        if (total === 0)
+            continue;
+        const parts = [
+            (globals.base ?? []).length > 0
+                ? `${(globals.base ?? []).length} base rules`
+                : "",
+            Object.keys(globals.utilities ?? {}).length > 0
+                ? `${Object.keys(globals.utilities ?? {}).length} of your utilities`
+                : "",
+            props > 0
+                ? `${props} registered ${props === 1 ? "property" : "properties"}`
+                : "",
+        ]
+            .filter(Boolean)
+            .join(", ");
+        return { total, parts };
+    }
+    return null;
 }

package/dist/doctor/style-ledger.js

@@ -117,7 +117,20 @@ const A_READER_REACHES = new Set([
     "component-not-admitted",
 ]);
 const BECAUSE = {
-    "shape-not-read": "no reader in this version understands this shape, so the styles it holds reach no recipe",
+    "shape-not-read": 
+    /**
+     * A FRASE DIZ O QUE ESTE LADO SABE, E PARA AÍ - conserto de 24/08.
+     *
+     * Ela dizia *"so the styles it holds reach no recipe"*, e um cliente leu isso sobre 198
+     * declarações cujas 22 `@utility` estavam no sistema dele. A frase não mentia sobre receita:
+     * uma regra `::selection` não é receita de componente nenhum. Ela mentia por PROMETER O
+     * DESFECHO - e o desfecho acontece do outro lado, na camada global, depois do envio.
+     *
+     * O CLI não tem como saber: a classificação roda no servidor. Então ele relata o que mediu -
+     * nenhum leitor DESTA versão entendeu a forma - e deixa de afirmar onde aquilo foi parar. Quem
+     * sabe é quem escreve, e é de lá que sai a nota com o número.
+     */
+    "no reader in this version understands this shape - what happens to these depends on where they belong, and the system says so once it is built",
     "value-not-read": "the shape is read and this value is not - a utility or property outside the scales this project declares",
     computed: "the value is assembled at render time, so it is not in the source at any level and there is nothing to read",
     "component-not-admitted": "read, and it belongs to a component this scope does not admit into the system - the styles exist and no recipe claims them",

package/package.json

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