synthesisui 0.16.282 → 0.16.283

package/dist/guide.js

@@ -262,6 +262,23 @@ export function buildGuide(payload) {
     const { document: doc, slug, name, version } = payload;
     const { meta, foundations, motion, components } = doc;
     const semanticRoles = Object.keys(foundations.color.semantic);
+    /**
+     * O NOME QUE ELE DÁ AO PAPEL, quando o documento sabe qual é - `semanticNames`.
+     *
+     * O guia listava `info, faint, muted, scrim, accent, border, canvas, danger, raised, overlay,
+     * primary, success, surface, warning` e chamava isso de vocabulário do sistema DELE. Nenhuma dessas
+     * palavras está no código dele: `canvas` é `paper`, `primary` é `brand-blue`, `danger` é
+     * `feedback-error`. Este arquivo é o que o agente dele LÊ antes de escrever, então a nossa língua
+     * aqui vira o código dele.
+     *
+     * A missão de 16/08 tirou o nosso identificador das telas e da saída de texto do CLI; o guia é
+     * artefato e escapou da varredura. Medido em 22/08 no `codelevel-ui`: 14 papéis listados, 12 com
+     * nome dele guardado no documento e nenhum aparecendo.
+     *
+     * Sem `semanticNames` o papel sai como está - é o caso de um sistema que NASCEU aqui, e aí o nome
+     * é nosso mesmo.
+     */
+    const theirRole = (role) => foundations.color.semanticNames?.[role] ?? role;
     /**
      * AS CORES QUE ELE NOMEIA POR PROPÓSITO, no arquivo que o agente lê primeiro.
      *
@@ -679,7 +696,10 @@ ${hasTailwind
   The token names below are the source vocabulary - every utility derives from them.`
         : ""}
 - **Always use semantic tokens**, never raw values nor primitives directly.
-  Color: \`var(--ds-color-semantic-<role>)\`${hasTailwind ? " (utility: `bg-<role>`/`text-<role>`)" : ""}. The roles are: ${list(semanticRoles)}.
+  Color: \`var(--ds-color-semantic-<role>)\`${hasTailwind ? " (utility: `bg-<role>`/`text-<role>`)" : ""}. The roles are: ${list(semanticRoles.map((r) => {
+        const theirs = theirRole(r);
+        return theirs === r ? r : `${r} (${theirs} in your code)`;
+    }))}.
 - Primitives (\`--ds-color-<palette>-<step>\`) exist but should **not** be referenced directly -
   they feed the semantic roles.${namedColours.length > 0
         ? `\n- **Yours by name** → \`var(--ds-color-<name>)\`: ${namedColours.length} colour${namedColours.length === 1 ? "" : "s"} your code names by PURPOSE rather than by step, so no scale could hold ${namedColours.length === 1 ? "it" : "them"} - ${list(namedColours.slice(0, 8))}${namedColours.length > 8 ? ", …" : ""}. These are yours: reach for them when the purpose matches, and prefer a semantic role when it does not.`

package/dist/install-marks.js

@@ -128,7 +128,7 @@
  * é sempre o bump deste PR - nunca o número que o `package.json` já carrega, porque alguém pode
  * publicar no meio.
  */
-export const MATERIALISER_SINCE = "0.16.281";
+export const MATERIALISER_SINCE = "0.16.283";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/package.json

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