synthesisui 0.16.356 → 0.16.357

package/dist/doctor/their-names.js

@@ -59,23 +59,49 @@ const segments = (name) => name.replace(/^--/, "").split("-");
  *
  *     1. quantos segmentos ele compartilha com o nosso token daquela família
  *        `--ds-radius-xs` puxa `--radius-xs` (2) e não `--spacing` (0)
- *     2. a convenção dominante dele - o primeiro segmento mais frequente entre os tokens dele
+ *     2. quantos segmentos dele são um PAPEL que este sistema declara - ver `roles`
+ *     3. a convenção dominante dele - o primeiro segmento mais frequente entre os tokens dele
  *        no repo real, `--color-*` (57) contra `--dashboard-*` (25)
- *     3. ordem de declaração, que é o desempate que sempre existe e nunca inventa
+ *     4. ordem de declaração, que é o desempate que sempre existe e nunca inventa
+ *
+ * O CRITÉRIO 2 NASCEU DE UMA DECISÃO DO DONO (03/09), e o critério 1 não alcançava o caso. No
+ * sistema dele `#f59e0b` é `--color-tier-gold` E `--color-feedback-warning`, e medindo o censo:
+ * `tier-gold` tem 59 menções contra 7, e uma escada própria (bronze 13, prata 13). Pela contagem
+ * bruta ele venceria - e vencia, sempre que o nosso token daquele valor não existisse para o
+ * critério 1 comparar: aí caía na ORDEM DE DECLARAÇÃO, e `tier-gold` vem antes no CSS dele.
+ *
+ * A ESCOLHA NÃO É PELO MAIS FREQUENTE, É PELO ERRO QUE SE ANUNCIA. `feedback-warning` escrito num
+ * badge de nível mostra "warning" onde devia ser ouro, e quem lê corrige. `tier-gold` escrito num
+ * alerta pinta a cor CERTA com o nome de outro domínio - a tela fica visualmente correta e ninguém
+ * corrige nunca. Entre dois nomes dele, o que descreve um PAPEL erra alto; o que descreve um
+ * domínio de negócio erra calado.
  */
-function pick(candidates, ours, convention) {
+function pick(candidates, ours, convention, 
+/**
+ * OS PAPÉIS QUE ESTE SISTEMA DECLARA - o critério 2, e o único que decide quando não há token
+ * nosso daquele valor para comparar.
+ *
+ * DERIVADO, nunca escrito: são os segmentos finais dos papéis semânticos do próprio sistema, e
+ * por isso a regra vale em qualquer projeto. Um projeto que chame o aviso de `atencao` puxa
+ * `atencao`; nenhum nome de família deste ou daquele repositório entra aqui (`INV-GERAL-07`).
+ */
+roles) {
     const mine = ours ? new Set(segments(ours)) : null;
     let best = candidates[0];
-    let bestScore = [-1, -1];
+    let bestScore = [-1, -1, -1];
     for (const name of candidates) {
         const parts = segments(name);
         const shared = mine ? parts.filter((p) => mine.has(p)).length : 0;
         const score = [
             shared,
+            parts.filter((p) => roles.has(p)).length,
             convention.get(parts[0] ?? "") ?? 0,
         ];
         if (score[0] > bestScore[0] ||
-            (score[0] === bestScore[0] && score[1] > bestScore[1])) {
+            (score[0] === bestScore[0] && score[1] > bestScore[1]) ||
+            (score[0] === bestScore[0] &&
+                score[1] === bestScore[1] &&
+                score[2] > bestScore[2])) {
             best = name;
             bestScore = score;
         }
@@ -106,14 +132,29 @@ function pick(candidates, ours, convention) {
  * sistema do dono, `#f59e0b` é `--color-tier-gold` E `--color-feedback-warning` - dois conceitos
  * dele, gamificação e estado -, e o relatório dizia `→ {color.tier-gold}` como se fosse fato.
  */
-function escolha(candidates, ours, convention) {
-    const name = pick(candidates, ours, convention);
+function escolha(candidates, ours, convention, roles) {
+    const name = pick(candidates, ours, convention, roles);
     return { name, also: candidates.filter((c) => c !== name) };
 }
 export function theirNames(ours, theirs) {
     const out = new Map();
     if (theirs.byName.size === 0)
         return out;
+    /**
+     * OS PAPÉIS QUE ESTE SISTEMA DECLARA, derivados dos NOSSOS nomes - ver o critério 2 de `pick`.
+     *
+     * O último segmento de cada token semântico é o papel: `--ds-color-semantic-warning` dá
+     * `warning`. Sai daqui e não de uma lista escrita porque uma lista seria o nosso vocabulário
+     * virando régua - um sistema que chame o aviso de `atencao` tem que puxar `atencao`.
+     */
+    const roles = new Set();
+    for (const name of ours.byName.keys()) {
+        if (!name.includes("-semantic-"))
+            continue;
+        const last = segments(name).at(-1);
+        if (last)
+            roles.add(last);
+    }
     /** A convenção dominante dele, contada e não suposta - ver `pick`. */
     const convention = new Map();
     for (const name of theirs.byName.keys()) {
@@ -151,7 +192,7 @@ export function theirNames(ours, theirs) {
                 : candidates.filter((n) => familySays(kind, n));
             if (usable.length === 0)
                 continue;
-            out.set(key, escolha(usable, name, convention));
+            out.set(key, escolha(usable, name, convention, roles));
         }
     }
     for (const [value, candidates] of theirs.byValue) {
@@ -161,7 +202,7 @@ export function theirNames(ours, theirs) {
             const key = `${kind}:${value}`;
             if (out.has(key))
                 continue;
-            out.set(key, escolha(candidates, null, convention));
+            out.set(key, escolha(candidates, null, convention, roles));
         }
     }
     return out;

package/package.json

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