synthesisui 0.16.238 → 0.16.240

package/dist/anatomy-read.js

@@ -417,6 +417,7 @@ sxSpacing) {
                     (kind === "headless" || kind === "motion" || kind === "icon")) {
                     node_.from = measured.from;
                     node_.refName = measured.tag;
+                    // a versão vem do apanhador geral abaixo - um lugar só, depois de todos os ramos
                 }
             }
             /**
@@ -431,6 +432,20 @@ sxSpacing) {
                 if (measured?.motionProps)
                     node_.motionProps = measured.motionProps;
             }
+            /**
+             * TODO NÓ COM PACOTE LEVA A VERSÃO - o apanhador geral, depois de todos os ramos.
+             *
+             * A costura já falhou QUATRO vezes ramo a ramo (frontier-kind, import 09/08, o ramo de
+             * fronteira, o ramo icon/motion), porque cada caminho novo que carimba `from` esquecia de
+             * carimbar a versão. Medido no caminho DERIVADO em 16/08: base-ui com 1 de 23 nós
+             * versionados e lucide com 11 de 45 - os nós nasciam no `anatomyFromSketch` com `from` e
+             * sem versão, e nenhum ramo daqui os alcançava. Um lugar só, depois de todos.
+             */
+            if (node_.from && !node_.version) {
+                const v = deps?.[packageRoot(String(node_.from))] ?? deps?.[String(node_.from)];
+                if (v)
+                    node_.version = v;
+            }
             // The NAME is what carries the styles, so it is claimed even when nothing
             // resolved: the tree triggers on presence, and structure is most of the
             // value. A node with no name is pure structure and that is legitimate.

package/dist/claude-md.js

@@ -186,9 +186,9 @@ session. It costs nothing when nothing changed: the tool holds both versions and
 refuses politely when there is nothing to refresh, so calling it is cheaper than
 deciding whether to.
 
-It re-measures this repo with the current reader, reuses the reading that was already
-authored, and sends it - a newer reader sees styles the old one could not, and until
-it runs, this project's system is missing them.
+It re-measures this repo with the current reader, reuses what was already written
+about this app, and sends it - a newer reader sees styles the old one could not, and
+until it runs, this project's system is missing them.
 
 It never asks anyone anything, and it never overwrites a recipe a person wrote on
 the screen: when a send would rewrite one, it refuses and names them. If it says
@@ -196,8 +196,8 @@ nothing changed, nothing changed - carry on.
 
 **And when you describe this system, open with the age of the measurement:** the
 \`ledger.cli\` and the date in \`_synthesisui/census.json\`. A long, correct report
-about a census taken by an older reader is the worst way to be right - every absence
-in it may have been filled since, and the reader who trusts it has no way to know.
+about a measurement taken by an older reader is the worst way to be right - every
+absence in it may have been filled since, and the reader who trusts it has no way to know.
 
 **And if it says the design system needs updating, do these three things in order:**
 say the one line, ask, and run it.
@@ -334,7 +334,8 @@ extend that. The person who asked you for a feature should never have to know th
 names or type them; finding the right component is your job, not theirs.
 
 Overriding a style a component already sets just works - write
-\`className="text-info"\`, with no \`!\`. The generated components resolve your class
+\`className="text-<role>"\` with one of this system's own colour roles (the GUIDE
+lists them), with no \`!\`. The generated components resolve your class
 against their own, so the last one written wins, which is what the call site reads like.
 If an override is ignored, that component predates the resolver: regenerate it with
 \`npx synthesisui@latest component <slug> <name>\` rather than reaching for \`!\`.

package/dist/commands/adopt.js

@@ -134,6 +134,14 @@ async function findTokens(root, only) {
 /** The contract. Names THEIR tokens - there is no translation layer. */
 function guide(name, slug, tokens) {
     const lines = [...tokens.entries()].map(([k, v]) => `  ${k}: ${v};`);
+    /**
+     * O EXEMPLO É UM TOKEN REAL DELE. A promessa três linhas abaixo é "YOUR tokens, under YOUR
+     * names" - e o exemplo inventava `--<slug>-color-primary`, um prefixo derivado por nós + um papel
+     * nosso, que pode não existir no CSS de ninguém. O primeiro token de cor DELE cumpre a promessa.
+     */
+    const example = [...tokens.entries()].find(([, v]) => /^#|^(rgb|hsl|oklch|color)\(/i.test(v.trim()))?.[0] ??
+        [...tokens.keys()][0] ??
+        `--${slug}-color-primary`;
     return `# ${name} - the contract your agent follows
 
 Adopted from this repository by \`synthesisui adopt\`. These are YOUR tokens,
@@ -145,7 +153,7 @@ When writing or editing UI in this project, use these custom properties.
 Do not write raw colours, spacings or radii that a token already covers.
 
     ✗  background: #3b82f6
-    ✓  background: var(--${slug}-color-primary)
+    ✓  background: var(${example})
 
 If a value has no token, say so instead of inventing one silently - a new
 token is a decision for a person to make.

package/dist/commands/doctor.js

@@ -1179,17 +1179,21 @@ export async function doctor(opts) {
             const w = Math.max(...repeats.map((r) => r.literal.length));
             for (const r of repeats) {
                 const where = `${r.count}\u00d7 in ${r.files} file${r.files === 1 ? "" : "s"}`;
-                const near = nameToWrite(r) ? null : nearestToken(table, r.literal);
+                const near = nameToWrite(r)
+                    ? null
+                    : nearestToken(table, r.literal, r.kind);
                 /**
                  * COINCIDÊNCIA NÃO É RESPOSTA - ver `crossFamily` em `scan.ts`. Para aquele `kind` o
                  * sistema não tem nome; o valor mora noutra família, e dizer só a seta afirma o contrário.
+                 * MAS quando o REPO DELE nomeia o valor (`theirToken`), esse nome vale - `apply-fix.ts:140`
+                 * e a classificação de sugestão já tratam assim; só a impressão tinha ficado para trás.
                  */
-                const named = r.crossFamily
+                const named = r.crossFamily && !r.theirToken
                     ? `  → no ${r.kind} named for it · the value lives as ${r.token}`
                     : nameToWrite(r)
                         ? `  → ${nameToWrite(r)}`
                         : near
-                            ? `  → nearest is ${near.name} (${near.value})`
+                            ? `  → nearest is ${near.theirs ?? near.name} (${near.value})`
                             : "";
                 say(`      ${r.literal.padEnd(w)}  ${where}${named}`);
             }
@@ -1205,13 +1209,15 @@ export async function doctor(opts) {
             for (const x of shown) {
                 // A dead end with a neighbour is not a dead end. Only for lengths -
                 // "nearly the same blue" is the guess this tool must never make.
-                const near = nameToWrite(x) ? null : nearestToken(table, x.literal);
-                const named = x.crossFamily
+                const near = nameToWrite(x)
+                    ? null
+                    : nearestToken(table, x.literal, x.kind);
+                const named = x.crossFamily && !x.theirToken
                     ? `→ no ${x.kind} named for it · the value lives as ${x.token}`
                     : nameToWrite(x)
                         ? `→ ${nameToWrite(x)}`
                         : near
-                            ? `→ nearest is ${near.name} (${near.value})`
+                            ? `→ nearest is ${near.theirs ?? near.name} (${near.value})`
                             : "→ no token holds this value yet";
                 say(`      ${String(x.line).padStart(4)}  ${x.literal}  ${named}`);
             }
@@ -1308,13 +1314,14 @@ export async function doctor(opts) {
     if (frozen.length > 0) {
         say(section("These will not follow your other scheme"));
         say(body(frozen.length === 1
-            ? "One recipe names a primitive where a SURFACE role of yours holds the same value."
-            : `${frozen.length} recipes name a primitive where a SURFACE role of yours holds the same value.`));
+            ? "One recipe pins a fixed shade where a surface colour of this system holds the same value."
+            : `${frozen.length} recipes pin a fixed shade where a surface colour of this system holds the same value.`));
         say("");
         for (const f of frozen) {
             say(body(`ds-${f.component} · ${f.where}`));
             say(`          binds ${f.wrote}`);
-            say(`          {color.semantic.${f.role}} holds that, and becomes ${f.becomes}`);
+            /** A grafia que EXISTE no repo dele - o CSS compilado carrega esta variável; `{color.semantic.*}` é formato nosso e não sai. */
+            say(`          var(--ds-color-semantic-${f.role}) holds that, and becomes ${f.becomes}`);
             say("");
         }
         say(body("The value resolves and the CSS compiles, so nothing"));
@@ -1557,7 +1564,7 @@ export async function doctor(opts) {
         });
     }
     for (const r of unnamed.slice(0, migrating ? 3 : 2)) {
-        const near = nearestToken(table, r.literal);
+        const near = nearestToken(table, r.literal, r.kind);
         plan.push({
             rank: migrating ? 3 : 4,
             /**
@@ -1567,7 +1574,7 @@ export async function doctor(opts) {
              * fila da anterior: aquela tem nome esperando, esta precisa de um.
              */
             what: near
-                ? `${r.literal} - name it, or snap to ${near.name}`
+                ? `${r.literal} - name it, or snap to ${near.theirs ?? near.name}`
                 : r.crossFamily
                     ? `${r.literal} - no ${r.kind} named for it, and the value lives as ${r.token} in another family`
                     : `${r.literal} - no name for it, here or in your CSS`,
@@ -1753,7 +1760,8 @@ export async function doctor(opts) {
         const verdict = compareToBaseline(d, base, {
             ...(relScopes.length ? { scope: relScopes.join(",") } : {}),
         });
-        console.log(section(verdict.worse ? "Drift went up" : "Ratchet"));
+        /** "Drift" é a nossa palavra e não sai (ver a tradução da seção principal); aqui idem. */
+        console.log(section(verdict.worse ? "Hand-written values went up" : "Holding the line"));
         for (const line of describeVerdict(verdict))
             console.log(body(line));
         if (verdict.worse)

package/dist/commands/gaps.js

@@ -22,7 +22,7 @@ export async function gaps(opts) {
     const raw = await readFile(path, "utf8").catch(() => null);
     console.log(section("What this pipeline did not read"));
     if (!raw) {
-        console.log(body(`No census at ${path}. Run \`synthesisui import --dry\` first - that is what measures your files, and it writes the census there.`));
+        console.log(body(`No measurement at ${path}. Run \`synthesisui import --dry\` first - that is what measures your files, and it writes the result there.`));
         return;
     }
     let ledger;
@@ -39,7 +39,7 @@ export async function gaps(opts) {
      * contar.
      */
     if (!ledger) {
-        console.log(body(`This census was written by a CLI 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.`));
+        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)))

package/dist/commands/import.js

@@ -36,7 +36,7 @@ import { frontierKind, packageRoot } from "../frontier-kind.js";
 import { withLibraryStructure } from "../library-structure.js";
 import { body, paint, section } from "../output.js";
 import { phase, startProgress } from "../progress.js";
-import { detectStack, resolveDeps } from "../stack.js";
+import { detectStack, resolveDeps, stackVersions } from "../stack.js";
 import { walk, walkAll } from "./doctor.js";
 /**
  * How many distinct values travel, PER KIND.
@@ -1739,18 +1739,23 @@ export async function takeCensus(root, opts) {
     }));
     const pkgRaw = await readFile(join(root, "package.json"), "utf8").catch(() => null);
     let name = null;
-    /** Their pinned ranges, so a library signal cites the version rather than going stale. */
-    let versions = {};
     if (pkgRaw) {
         try {
-            const pkg = JSON.parse(pkgRaw);
-            name = pkg.name ?? null;
-            versions = { ...pkg.devDependencies, ...pkg.dependencies };
+            name = JSON.parse(pkgRaw).name ?? null;
         }
         catch {
             // an unreadable package.json costs the name, not the run
         }
     }
+    /**
+     * Their pinned ranges, so a library signal cites the version rather than going stale.
+     *
+     * PELO RESOLVEDOR, nunca pela leitura crua de um nível: com `--scope packages/ui` este `root` é a
+     * pasta do escopo, cujo manifesto tem ZERO deps - e 15 de 15 bibliotecas do censo vivo saíam sem
+     * versão (medido 16/08). `resolveDeps` sobe até a raiz do workspace e anda para os irmãos que os
+     * `workspaces` declaram, que é onde recharts/chakra/mui realmente moram.
+     */
+    const versions = await resolveDeps(root).catch(() => ({}));
     finishSignals(signals, importTally, versions);
     // Every name their CSS defines, from the same harvest the token table came
     // from - so a reference is judged against what actually exists, not against
@@ -1862,7 +1867,13 @@ export async function takeCensus(root, opts) {
     const classStyle = detectClassStyle(sources);
     return {
         census: 1,
-        project: { name, stack: await detectStack(root) },
+        project: {
+            name,
+            stack: await detectStack(root),
+            ...(Object.keys(stackVersions(versions)).length > 0
+                ? { versions: stackVersions(versions) }
+                : {}),
+        },
         declared: Object.fromEntries(table.byName),
         ...(Object.keys(keyframes).length > 0 ? { keyframes } : {}),
         ...(animations.size > 0 ? { animations: [...animations].sort() } : {}),
@@ -3113,7 +3124,7 @@ export async function runImport(opts) {
     if (creds && !sameRegistry(creds.registry, base)) {
         console.log("");
         console.log(body(`You are logged in to ${paint.strong(creds.registry ?? "another registry")}, and this would go to ${paint.strong(base)}.`));
-        console.log(body("The census is on disk. Either name the one you meant:"));
+        console.log(body(`Your measurement is saved at ${out}. Either name the one you meant:`));
         console.log("");
         console.log(body(`    synthesisui import --census ${out} --registry ${creds.registry}`));
         console.log(body("or log in to this one:"));
@@ -3143,7 +3154,7 @@ export async function runImport(opts) {
         // which of the two it was (dono, 31/07). A stale token gets past the
         // `readToken` guard above and only fails here.
         if (res?.status === 401) {
-            console.log(body("Your session has expired. The census is on disk."));
+            console.log(body(`Your session has expired. Your measurement is saved at ${out}.`));
             console.log("");
             console.log(body(`    ${paint.strong("synthesisui login")}`));
             console.log(body(`    synthesisui import --census ${out}${chosen ? ` --name "${chosen}"` : ""}`));
@@ -3152,7 +3163,7 @@ export async function runImport(opts) {
         }
         console.log(body(res
             ? `The registry refused it (HTTP ${res.status})${detail ? `: ${detail}` : "."}`
-            : "Could not reach the registry. The census is on disk - try again later."));
+            : `Could not reach the registry. Your measurement is saved at ${out} - try again later.`));
         console.log("");
         return;
     }

package/dist/commands/mcp.js

@@ -6,7 +6,7 @@ import { readToken, resolveRegistry } from "../config.js";
 import { readEvents } from "../doctor/ledger.js";
 import { fileRequest } from "../doctor/requests.js";
 import { diagnose, nameToWrite, scanSource } from "../doctor/scan.js";
-import { nearestToken, tokenFor } from "../doctor/tokens.js";
+import { nearestToken, normalizeValue, tokenFor } from "../doctor/tokens.js";
 import { repoStateOf } from "../repo-state.js";
 import { component } from "./component.js";
 import { loadSystem, walkAll } from "./doctor.js";
@@ -290,12 +290,29 @@ async function findToken(root, value) {
     const { table } = await loadSystem(root);
     if (table.byName.size === 0)
         return "No design system installed here.";
+    /**
+     * O NOME DELE PRIMEIRO, como no doctor (`nameToWrite`): `loadSystem` já devolve a tabela COM os
+     * aliases dele (`withTheirNames`) e este era o único leitor que nunca os consultava. Sem o `kind`
+     * do contexto, a busca varre as famílias - um alias em qualquer uma delas é o nome que o repo
+     * DELE dá àquele valor.
+     */
+    const theirNameFor = (v) => {
+        const norm = normalizeValue(v, table.rootPx);
+        for (const [key, name] of table.aliases)
+            if (key.endsWith(`:${norm}`))
+                return name;
+        return null;
+    };
     const exact = tokenFor(table, value);
-    if (exact)
-        return `${value} is ${exact} in this system. Use var(${exact}).`;
+    if (exact) {
+        const shown = theirNameFor(value) ?? exact;
+        return `${value} is ${shown} in this project. Use var(${shown}).`;
+    }
     const near = nearestToken(table, value);
-    if (near)
-        return `No token holds ${value}. The closest is ${near.name} at ${near.value}. If that is what you meant, use it - if it genuinely is not, say so rather than inventing a token.`;
+    if (near) {
+        const shown = theirNameFor(near.value) ?? near.name;
+        return `No token holds ${value}. The closest is ${shown} at ${near.value}. If that is what you meant, use it - if it genuinely is not, say so rather than inventing a token.`;
+    }
     // Same words the managed block uses. A refusal is only useful if it is the
     // same refusal every time.
     return `No token in this system holds ${value}, and nothing is close. Do NOT invent one. Say which value you need and what you would call it, and let a person decide.`;

package/dist/commands/sync.js

@@ -269,9 +269,9 @@ export async function remeasure(args) {
         }
     }
     console.log(section("Measuring your repository again"));
-    console.log(body(paint.faint(`${scope ? `scope ${scope}` : "the whole repo"}${local.system && local.system !== stored.scope
-        ? " · read from your own census, which is where the last measurement recorded it"
-        : ""} · the reading you already authored travels unchanged`)));
+    console.log(body(paint.faint(`${scope ? `reading ${scope}` : "the whole repo"}${local.system && local.system !== stored.scope
+        ? " · read from _synthesisui/census.json, where the last measurement recorded it"
+        : ""} · what you already wrote about your app travels unchanged`)));
     const census = await takeCensus(scope ? join(root, scope) : root, {
         ...(scope ? { scopeLabel: scope } : {}),
         ...(args.cli ? { cli: args.cli } : {}),
@@ -333,7 +333,7 @@ export async function remeasure(args) {
      * repositório inteiro e o rascunho curado de 37 vira 339).
      */
     if (!fresh.scope && local.system)
-        console.log(body(`⚠ the census was written without a scope while "${local.system}" is the one recorded - the next re-measure would read the whole repo. Please report this: it is a state we have not reproduced.`));
+        console.log(body(`⚠ the last measurement was saved without the folder it read, while "${local.system}" is the one recorded - the next one would read the whole repo. Please report this: it is a state we have not reproduced.`));
     if (usage.length > 0)
         fresh.usage = usage;
     for (const key of ["scheme", "reading"])

package/dist/commands/use.js

@@ -57,14 +57,43 @@ export async function use(slug, intent, opts) {
             : "",
         `- ${base}/v${version}/GUIDE.md - how to apply the system, the recipes and the token vocabulary`,
     ].filter(Boolean);
+    /**
+     * OS EXEMPLOS SÃO DO SISTEMA DELE, não uma lista nossa de cor. `bg-primary`/`p-md` cravados
+     * ensinavam classes que um sistema importado pode nem compilar - os nomes reais moram no
+     * `design-system.json` instalado, e é dele que os exemplos saem. Ilegível, ficam os genéricos.
+     */
+    let utilities = "`bg-primary`, `text-foreground`, `p-md`, `rounded-lg`, `font-display`";
+    try {
+        const doc = JSON.parse(await readFile(join(slugDir, `v${version}`, "design-system.json"), "utf8"));
+        const roles = Object.keys(doc.foundations?.color?.semantic ?? {});
+        const spacing = Object.keys(doc.foundations?.spacing ?? {});
+        const radius = Object.keys(doc.foundations?.radius ?? {});
+        const parts = [
+            roles.length > 0
+                ? `\`bg-${roles.includes("primary") ? "primary" : roles[0]}\``
+                : null,
+            roles.includes("foreground")
+                ? "`text-foreground`"
+                : roles[1]
+                    ? `\`text-${roles[1]}\``
+                    : null,
+            spacing[0] ? `\`p-${spacing[0]}\`` : null,
+            radius[0] ? `\`rounded-${radius[0]}\`` : null,
+            "`font-display`",
+        ].filter(Boolean);
+        if (parts.length >= 3)
+            utilities = parts.join(", ");
+    }
+    catch {
+        // sem manifesto legível, os exemplos genéricos ficam - pior seria nenhum
+    }
     // The styling contract differs by target: Next projects in this product use
     // Tailwind v4 backed by the DS; the "general" target is framework-agnostic CSS.
     const stylingRule = config.target === "general"
         ? `- Style with the design system only: reuse the \`.ds-*\` recipe classes and the ` +
             `\`var(--ds-*)\` custom properties. Never use raw hex/px outside the system's scale.`
         : `- Style with the design system only: reuse the \`.ds-*\` recipe classes and the ` +
-            `DS-backed Tailwind utilities (\`bg-primary\`, \`text-foreground\`, \`p-md\`, \`rounded-lg\`, ` +
-            `\`font-display\`…). Never use raw hex/px outside the system's scale.`;
+            `DS-backed Tailwind utilities (${utilities}…). Never use raw hex/px outside the system's scale.`;
     const task = intent.trim() || "build the UI I describe next";
     const prompt = [
         `Use the "${name}" design system (slug: ${slug}, v${version}) to: ${task}`,

package/dist/doctor/ci-format.js

@@ -79,12 +79,20 @@ export function compareToBaseline(d, base, now) {
             : {}),
     };
 }
-/** O que a mensagem de uma anotação diz, e é a mesma frase nos dois formatos. */
+/**
+ * O que a mensagem de uma anotação diz, e é a mesma frase nos dois formatos.
+ *
+ * O NOME DELE PRIMEIRO, como em todo o resto do doctor (`nameToWrite`): este era o único caminho
+ * que ignorava `their-names` por completo - e é o que aparece anotado na linha do PR de todo o
+ * time dele. Um `theirToken` também desarma o caso `crossFamily`: o repo DELE nomeia o valor, então
+ * a troca existe (mesma regra de `apply-fix.ts`).
+ */
 function messageFor(f) {
-    return f.token
-        ? f.crossFamily
+    const shown = f.theirToken ?? f.token;
+    return shown
+        ? f.crossFamily && !f.theirToken
             ? `${f.literal} is written by hand, and this project's system has no ${f.kind} named for it. The value does exist elsewhere in the system - as \`${f.token}\`, in another family - so this is a decision to make, not a swap: name a ${f.kind}, or leave it.`
-            : `${f.literal} is written by hand, and this project's system already names it: var(${f.token}). Use the token.`
+            : `${f.literal} is written by hand, and this project already names it: var(${shown}). Use the name.`
         : `${f.literal} is a ${f.kind} value written by hand, and the system has no name for it yet. Name it, or file a token request: npx synthesisui request token`;
 }
 /**
@@ -192,7 +200,8 @@ export function describeVerdict(v) {
         lines.push(`Baseline not comparable: ${v.incomparable}.`);
         return lines;
     }
-    lines.push(`Drift ${v.drift.was} → ${v.drift.now}${v.phantoms.was || v.phantoms.now ? ` · phantom tokens ${v.phantoms.was} → ${v.phantoms.now}` : ""}.`);
+    /** "Drift"/"phantom" são palavras nossas - a linha fala do que ELE vê: valores à mão e nomes que não resolvem. */
+    lines.push(`Hand-written values ${v.drift.was} → ${v.drift.now}${v.phantoms.was || v.phantoms.now ? ` · names that resolve to nothing ${v.phantoms.was} → ${v.phantoms.now}` : ""}.`);
     if (v.improved > 0)
         lines.push(`${v.improved} file${v.improved === 1 ? "" : "s"} improved since the baseline.`);
     if (v.regressed.length === 0) {

package/dist/doctor/tokens.js

@@ -467,7 +467,9 @@ export function buildTable(input) {
  * Deliberately narrow: same unit, within 25% or 8px, and never for a colour -
  * "nearly the same blue" is exactly the guess this tool must not make.
  */
-export function nearestToken(table, literal) {
+export function nearestToken(table, literal, 
+/** A família do achado - com ela, o vizinho também é oferecido pelo NOME DELE quando o repo o nomeia. */
+kind) {
     const m = /^(-?\d*\.?\d+)(px|rem)$/.exec(literal.trim().toLowerCase());
     if (!m)
         return null;
@@ -490,7 +492,17 @@ export function nearestToken(table, literal) {
     if (!best)
         return null;
     const limit = unit === "rem" ? Math.max(n * 0.25, 0.5) : Math.max(n * 0.25, 8);
-    return best.delta <= limit ? best : null;
+    if (best.delta > limit)
+        return null;
+    /**
+     * O VIZINHO PELO NOME DELE - a mesma chave que `theirNames` construiu (`kind:valor`), porque o
+     * valor sozinho não decide a família. Só a tabela nossa era consultada aqui, então a oferta saía
+     * sempre no nosso vocabulário mesmo quando o repo dele nomeia o mesmo valor.
+     */
+    const theirs = kind
+        ? table.aliases.get(`${kind}:${normalizeValue(best.value, table.rootPx)}`)
+        : undefined;
+    return theirs ? { ...best, theirs } : best;
 }
 /**
  * The family a token belongs to, from the drift it was found in.

package/dist/install-marks.js

@@ -80,7 +80,16 @@
  * Zero ocorrências no sistema real medido (todos os headings dele estão aninhados, e o `children > 0`
  * já os pegava), então para ele o `upgrade` é no-op. A marca é sobre o caso geral.
  */
-export const MATERIALISER_SINCE = "0.16.237";
+/**
+ * 0.16.237 -> 0.16.239 em 16/08: os arquivos que o agente dele LÊ mudam de conselho, não só de
+ * bytes. O bloco gerenciado do CLAUDE.md ensinava `text-info` cravado - uma classe que um sistema
+ * importado pode nem compilar - e passa a apontar para os papéis que o GUIDE do sistema DELE lista;
+ * o GUIDE do sistema adotado exemplificava com `--<slug>-color-primary`, um nome que nós derivamos,
+ * e passa a usar o primeiro token de cor REAL dele (a promessa três linhas acima do exemplo é
+ * "YOUR tokens, under YOUR names"). É a fatia de CLI da decisão de 16/08: toda superfície fala a
+ * língua do cliente.
+ */
+export const MATERIALISER_SINCE = "0.16.239";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *
@@ -175,8 +184,14 @@ export const CHECKER_SINCE = "0.16.232";
  *               comparação com UM literal, e a divisão do motivo as tirou dele em silêncio
  *
  * Um censo medido antes disto carrega as duas leituras erradas.
+ *
+ *     0.16.240  a VERSÃO passa a viajar (fase B1, 16/08): `project.versions` (frameworks pinados),
+ *               15 de 15 `signals.libraries` com versão (o leitor de manifesto lia o package.json
+ *               do ESCOPO, que tinha zero deps), e todo nó de fronteira com pacote carimba o range
+ *               (era 53% no melhor caminho; o derivado dava 38%). Um censo medido antes disto não
+ *               tem versão nenhuma - e o mapa de blueprints por versão não tem o que consultar.
  */
-export const READER_SINCE = "0.16.215";
+export const READER_SINCE = "0.16.240";
 /**
  * O QUE ESTÁ INSTALADO AQUI FICOU PARA TRÁS - e as DUAS condições que fazem isso ser verdade.
  *

package/dist/skill-import.js

@@ -12,4 +12,4 @@
  * invocada, e ela não é segredo - a esteira é.
  */
 export const IMPORT_SKILL_PATH = ".claude/skills/sui-import-ds/SKILL.md";
-export const IMPORT_SKILL = '---\nname: sui-import-ds\ndescription: Turn a codebase the user ALREADY has into a SynthesisUI design system. Use when someone points at an existing repo, app or component library and asks to import it, adopt it, bring it in, or "make a design system from this" (e.g. "/sui-import-ds", "importa o meu packages/ui", "turn this app into a design system"). Drives the full pipeline - census \u2192 your reading \u2192 import \u2192 v2 proposal - and answers the questions arithmetic cannot.\n---\n\n# Import Design System - served live\n\nThis playbook is served from the platform, not shipped in this file - it is\nalways current, and your context only carries the step you are on.\n\n1. Call the `playbook` tool on the `synthesisui` MCP server with\n   { "skill": "import" } - you get the framing and a table of contents.\n2. Fetch ONLY the chapter for the step you are on:\n   { "skill": "import", "section": "<id from the toc>" }. Never fetch more\n   than the current step needs.\n3. Follow it exactly. When the step is done, fetch the next chapter.\n\nIf the tool answers that you are not signed in, run `npx synthesisui login`\nin the terminal and call it again. If the `synthesisui` MCP server is not\navailable at all, run `npx synthesisui connect`, restart the session, and\ninvoke this skill again.\n';
+export const IMPORT_SKILL = '---\nname: sui-import-ds\ndescription: Turn a codebase the user ALREADY has into a SynthesisUI design system. Use when someone points at an existing repo, app or component library and asks to import it, adopt it, bring it in, or "make a design system from this" (e.g. "/sui-import-ds", "importa o meu packages/ui", "turn this app into a design system"). Drives the full pipeline - measurement \u2192 your reading of the app \u2192 import \u2192 upgrade proposal - and answers the questions arithmetic cannot.\n---\n\n# Import Design System - served live\n\nThis playbook is served from the platform, not shipped in this file - it is\nalways current, and your context only carries the step you are on.\n\n1. Call the `playbook` tool on the `synthesisui` MCP server with\n   { "skill": "import" } - you get the framing and a table of contents.\n2. Fetch ONLY the chapter for the step you are on:\n   { "skill": "import", "section": "<id from the toc>" }. Never fetch more\n   than the current step needs.\n3. Follow it exactly. When the step is done, fetch the next chapter.\n\nIf the tool answers that you are not signed in, run `npx synthesisui login`\nin the terminal and call it again. If the `synthesisui` MCP server is not\navailable at all, run `npx synthesisui connect`, restart the session, and\ninvoke this skill again.\n';

package/dist/stack.js

@@ -9,7 +9,7 @@
  * One implementation, because two detectors that disagreed would put a rule in a
  * project the census said was something else.
  */
-import { readFile } from "node:fs/promises";
+import { readdir, readFile } from "node:fs/promises";
 import { join } from "node:path";
 /**
  * Dependencies as the project actually resolves them - which means reading
@@ -19,36 +19,98 @@ import { join } from "node:path";
  * Next + React + Tailwind app, because a workspace hoists those to the root and
  * the leaf package.json lists only its own icons. Three levels up covers every
  * pnpm/npm workspace layout without wandering into someone's home directory.
+ *
+ * E PARA OS LADOS TAMBÉM, pelos `workspaces` do manifesto que os declara. Subir
+ * sozinho deixou 15 de 15 bibliotecas do censo vivo sem versão (16/08): o escopo
+ * era `packages/ui` (zero deps) e recharts/chakra/mui moram em `apps/*`, um
+ * IRMÃO - invisível para uma caminhada que só sobe. O componente medido vem do
+ * app que usa o sistema, então o manifesto daquele app é evidência tanto quanto
+ * o da raiz.
  */
 export async function resolveDeps(root) {
     const deps = {};
-    let dir = root;
-    for (let up = 0; up < 4; up++) {
+    const workspaceDirs = [];
+    const readManifest = async (dir) => {
         const raw = await readFile(join(dir, "package.json"), "utf8").catch(() => null);
-        if (raw) {
-            try {
-                const p = JSON.parse(raw);
-                // The nearest package.json wins on a version clash; we only ever ask
-                // whether a name is present, so first-seen is enough.
-                for (const [k, v] of Object.entries({
-                    ...p.dependencies,
-                    ...p.devDependencies,
-                })) {
-                    if (deps[k] == null)
-                        deps[k] = String(v);
-                }
+        if (!raw)
+            return;
+        try {
+            const p = JSON.parse(raw);
+            // The nearest package.json wins on a version clash; we only ever ask
+            // whether a name is present, so first-seen is enough. The up-chain is
+            // read before any sibling, so siblings only ever FILL, never override.
+            for (const [k, v] of Object.entries({
+                ...p.dependencies,
+                ...p.devDependencies,
+            })) {
+                if (deps[k] == null)
+                    deps[k] = String(v);
             }
-            catch {
-                // unreadable manifest costs the detection, not the run
+            const globs = Array.isArray(p.workspaces)
+                ? p.workspaces
+                : Array.isArray(p.workspaces?.packages)
+                    ? p.workspaces.packages
+                    : [];
+            for (const g of globs) {
+                if (typeof g !== "string")
+                    continue;
+                // Only the two shapes real manifests use: `packages/*` and a literal
+                // path. Anything fancier is skipped rather than guessed at.
+                if (g.endsWith("/*")) {
+                    const parent = join(dir, g.slice(0, -2));
+                    const children = await readdir(parent, {
+                        withFileTypes: true,
+                    }).catch(() => []);
+                    for (const c of children)
+                        if (c.isDirectory())
+                            workspaceDirs.push(join(parent, c.name));
+                }
+                else if (!g.includes("*")) {
+                    workspaceDirs.push(join(dir, g));
+                }
             }
         }
+        catch {
+            // unreadable manifest costs the detection, not the run
+        }
+    };
+    let dir = root;
+    for (let up = 0; up < 4; up++) {
+        await readManifest(dir);
         const parent = join(dir, "..");
         if (parent === dir)
             break;
         dir = parent;
     }
+    for (const w of workspaceDirs)
+        await readManifest(w);
     return deps;
 }
+/**
+ * OS FRAMEWORKS DO PROJETO, COM A VERSÃO PINADA - o que `Census.project.versions` carrega.
+ *
+ * `detectStack` colapsa `next@16.0.8` na string `"next"`, e nada no censo guardava versão de
+ * framework nenhuma (medido 16/08: zero em todos os campos). Curado de propósito: framework aqui,
+ * biblioteca por biblioteca em `signals.libraries` - duas listas com dois papéis, nunca o
+ * package.json inteiro dentro do censo.
+ */
+const STACK_PACKAGES = [
+    "next",
+    "react",
+    "react-dom",
+    "vue",
+    "svelte",
+    "vite",
+    "tailwindcss",
+    "typescript",
+];
+export function stackVersions(deps) {
+    const out = {};
+    for (const name of STACK_PACKAGES)
+        if (deps[name])
+            out[name] = deps[name];
+    return out;
+}
 export async function detectStack(root) {
     const stack = [];
     const has = async (f) => (await readFile(join(root, f), "utf8").catch(() => null)) !== null;

package/package.json

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