synthesisui 0.16.369 → 0.16.371

package/dist/commands/add.js

@@ -552,8 +552,36 @@ export async function add(slug, opts) {
      * saíram por serem nossos, com os primeiros nomes. Quem lê pode discordar de qualquer um.
      */
     if (aligned.dropped.length > 0) {
-        console.log(line(`  ${aligned.kept} Tailwind utilit${aligned.kept === 1 ? "y" : "ies"} now point at your own decisions; ${aligned.dropped.length} were left alone because the value would be ours (${aligned.dropped.slice(0, 3).join(", ")}${aligned.dropped.length > 3 ? ", …" : ""}) - your classes keep meaning what they mean today.`));
+        console.log(line(
+        /**
+         * A LINHA DIZ QUE FICARAM DE FORA - e nao AFIRMA por que, porque ela nao sabe.
+         *
+         * O DEFEITO, lido pelo dono na propria tela em 04/09: ela dizia *"left alone because THE
+         * VALUE WOULD BE OURS"* e listava `--background-image-gradient-grad-aurora`,
+         * `grad-cool`, `grad-fire` - os cinco gradientes DELE, que estao em `ownedNames.gradients`.
+         * A frase afirmava a origem do valor e errava.
+         *
+         * Sao TRES razoes diferentes e `onlyWhatMatched` so' distingue uma: o valor e' nosso · a
+         * familia nao tem como casar (gradiente nao esta' em `FAMILY_KIND`) · apontar criaria ciclo
+         * (a linha propria abaixo). Afirmar a primeira para as tres e' a mesma classe do aviso de
+         * aprovacao do MCP, que dizia "pendente" lendo duas listas vazias: uma frase que declara um
+         * estado que o codigo nao observou.
+         *
+         * Entao a linha diz o FATO que ela tem - a classe dele continua significando o que
+         * significa - e nomeia os primeiros, para quem quiser discordar de qualquer um.
+         */
+        `  ${aligned.kept} Tailwind utilit${aligned.kept === 1 ? "y" : "ies"} now point at your own decisions; ${aligned.dropped.length} were left as ${aligned.dropped.length === 1 ? "it is" : "they are"} (${aligned.dropped.slice(0, 3).join(", ")}${aligned.dropped.length > 3 ? ", …" : ""}) - your classes keep meaning what they mean today.`));
     }
+    /**
+     * O CICLO RECUSADO É DITO, e não engolido - senão o cliente lê um número menor sem saber por quê.
+     *
+     * A folha traz a ponte (`--ease-in-out: var(--ds-motion-easings-in-out)`) para que a utility dele
+     * resolva pelo sistema. Apontar de volta fecharia um ciclo, e um ciclo de custom property não deixa
+     * o valor errado: invalida a propriedade no elemento e em todos os descendentes. Recusar é o certo,
+     * e a linha diz que nada foi perdido - a utility dele continua resolvendo pelo sistema.
+     */
+    if (theirVars.cycles > 0)
+        console.log(`  ${theirVars.cycles} ${theirVars.cycles === 1 ? "value" : "values"} already had the bridge pointing the other way, so ${theirVars.cycles === 1 ? "it was" : "they were"} left alone - your own utility still resolves through this system, and pointing back would have cancelled both.`);
     if (theirVars.pointed > 0)
         console.log(`  ${theirVars.pointed} value${theirVars.pointed === 1 ? "" : "s"} in tokens.css now point at the name YOUR code already gives ${theirVars.pointed === 1 ? "it" : "them"} - change yours and the system follows${theirVars.pruned > 0 ? `; ${theirVars.pruned} matched but your build does not emit ${theirVars.pruned === 1 ? "that name" : "those names"}, so ${theirVars.pruned === 1 ? "it keeps" : "they keep"} the value` : ""}`);
     /**

package/dist/commands/mcp.js

@@ -203,7 +203,7 @@ const TOOLS = [
     },
     {
         name: "apply_upgrade",
-        description: "The optimisation this system can write on its OWN, and the one question to ask before writing it. Call it with { slug } to GET the question - it comes back composed, with their numbers in it, and you deliver it as it is rather than rephrasing it. Only after they say yes, call again with { slug, confirmed: true }. What it writes never adds a word they did not write and never moves a value they chose: a literal only becomes a reference when it resolves to the same value. Everything that would need a NAME from them stays out and comes back counted, so you can say what is still waiting. Do NOT call this with confirmed:true off your own judgement - the whole point of the question is that the answer is theirs.",
+        description: "The optimisation this system can write on its OWN, and the one question to ask before writing it. Call it with { slug } to GET the question - it comes back composed, with their numbers in it, and you deliver it as it is rather than rephrasing it. Only after they say yes, call again with { slug, confirmed: true }. What it writes never adds a word they did not write and never moves a value they chose: a literal only becomes a reference when it resolves to the same value. Everything that would need a NAME from them stays out and comes back counted, so you can say what is still waiting. Do NOT call this with confirmed:true off your own judgement - the whole point of the question is that the answer is theirs. AND THIS RUN ENDS WHEN IT IS APPLIED: report what changed in one short block and stop. If you found something else worth doing - a wiring gap, a defect, a fix waiting - name it in ONE line and offer it as a next step, never as a second investigation in the same breath. A run that answers `optimise my design system` with a nine-row impact table and a second three-option decision has buried the result it was asked for: whatever you measured is worth its own turn, where they can arrive with attention instead of spending what is left of it.",
         inputSchema: {
             type: "object",
             properties: {

package/dist/install-marks.js

@@ -170,7 +170,7 @@
  * O que o cliente ganha ao rodar `upgrade`: o agente dele no Codex passa a poder PERGUNTAR ao
  * sistema, em vez de só receber as regras e adivinhar o resto.
  */
-export const MATERIALISER_SINCE = "0.16.362";
+export const MATERIALISER_SINCE = "0.16.370";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/dist/their-vars.js

@@ -101,11 +101,22 @@ export function pointAtTheirNames(css, theirs, resolvable) {
      * buildou não tem como provar o que resolve, e um par afirmado sem prova é pior que par nenhum.
      */
     if (!resolvable || theirs.byName.size === 0)
-        return { css, pointed: 0, pruned: 0, pairs: [] };
+        return { css, pointed: 0, pruned: 0, cycles: 0, pairs: [] };
     const ours = buildTable({ css, source: "installed" });
     const alias = theirNames(ours, theirs);
+    /**
+     * A PONTE QUE JÁ ESTÁ NA FOLHA: o nome DELE -> o nosso token para o qual ele já aponta.
+     *
+     * Lido da própria folha e não de uma lista, porque quem decide o que é bridgeado é o compilador e a
+     * lista dele muda: hoje são famílias, pesos, easings, escala de tipo e gradientes, e amanhã pode ser
+     * outra. Uma cópia da regra aqui divergiria no dia em que uma família entrasse lá.
+     */
+    const bridged = new Map();
+    for (const [, theirName, ourName] of css.matchAll(/^\s*(--[a-zA-Z0-9_-]+)\s*:\s*var\((--ds-[a-zA-Z0-9_-]+)\)\s*;/gm))
+        bridged.set(theirName, ourName);
     let pointed = 0;
     let pruned = 0;
+    let cycles = 0;
     /** Ver `PointedAt.pairs`: o mapa sai do mesmo casamento que reescreve a linha. */
     const pairs = [];
     const out = css.replace(/^(\s*)(--ds-[a-zA-Z0-9_-]+)(\s*:\s*)([^;]+);/gm, (line, indent, name, sep, value) => {
@@ -118,6 +129,15 @@ export function pointAtTheirNames(css, theirs, resolvable) {
         const theirName = alias.get(`${kind}:${normalizeValue(value.trim(), ours.rootPx)}`)?.name;
         if (!theirName || theirName === name)
             return line;
+        /**
+         * A PONTE JÁ APONTA PARA CÁ - então apontar de volta fecha um ciclo, e um ciclo não deixa o
+         * valor errado: deixa a propriedade INVÁLIDA. A utility dele já resolve pelo nosso token, que é
+         * o que a ponte existe para fazer, então esta linha não tem nada a ganhar e tudo a perder.
+         */
+        if (bridged.get(theirName) === name) {
+            cycles += 1;
+            return line;
+        }
         if (!resolvable.has(theirName)) {
             pruned += 1;
             return line;
@@ -126,7 +146,7 @@ export function pointAtTheirNames(css, theirs, resolvable) {
         pairs.push({ ours: name, theirs: theirName, value: value.trim() });
         return `${indent}${name}${sep}var(${theirName});`;
     });
-    return { css: out, pointed, pruned, pairs };
+    return { css: out, pointed, pruned, cycles, pairs };
 }
 /**
  * O PREFIXO DA NOSSA VARIÁVEL -> A FAMÍLIA, e a chave que `theirNames` devolve é `<família>:<valor>`.
@@ -151,7 +171,7 @@ const FAMILY_KIND = {
 export async function pointTokensAtTheirNames(root, payload) {
     const css = payload.artifacts["tokens.css"] ?? "";
     if (!css)
-        return { css, pointed: 0, pruned: 0, pairs: [] };
+        return { css, pointed: 0, pruned: 0, cycles: 0, pairs: [] };
     const [theirs, resolvable] = await Promise.all([
         harvestTheirCss(root),
         resolvableVars(root),

package/package.json

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