synthesisui 0.16.259 → 0.16.261

package/dist/anatomy-from-sketch.js

@@ -180,6 +180,33 @@ function nameOfTag(tag) {
         .replace(/[^a-z0-9]+/g, "-")
         .replace(/^-|-$/g, "");
 }
+/**
+ * O NOME QUE ELE MESMO DEU AO ELEMENTO - a classe do CSS Module.
+ *
+ * `className={styles.senderConfigContent}` é o cliente nomeando aquele nó. Antes
+ * disto o nó virava `box`, que é o nosso nome para "caixa que carrega decisões e
+ * cujo papel não se lê da tag" - correto e mudo. Medido no monorepo do dono em
+ * 20/08: **1185 dos 5319 nós de sketch carregam `moduleClass`**, em 381 nomes
+ * distintos - `content`, `formControl`, `senderConfig`, `title`, `actions`, `list`.
+ * Todos eles chegavam como `box`.
+ *
+ * É a lei 12 no nível do nó: o que ele declarou vence o que a gente deduziria. E é
+ * a promessa de paridade SEMÂNTICA - devolver o componente com os nomes dele, não
+ * com os nossos.
+ *
+ * A PRIMEIRA palavra, e não a mais longa nem a mais rara: `styles.card styles.open`
+ * é o elemento (`card`) mais um estado (`open`), nessa ordem, porque é assim que
+ * uma pessoa escreve. Escolher outra seria adivinhar qual das duas é o papel.
+ */
+function nameOfModule(moduleClass) {
+    const first = String(moduleClass ?? "")
+        .trim()
+        .split(/\s+/)[0];
+    if (!first)
+        return undefined;
+    const name = nameOfTag(first);
+    return name || undefined;
+}
 /**
  * A HEADLESS PRIMITIVE'S OWN MEMBER NAME, when it says what the thing is.
  *
@@ -517,7 +544,12 @@ versionOf) {
          * chegava com 2 das 35 (04/08).
          */
         if (!name && (classes || node.moduleClass))
-            name = "box";
+            /**
+             * `box` VIROU A ÚLTIMA OPÇÃO, não a primeira - ver `nameOfModule`. Um nó com
+             * classe de module tem nome, e o nome é dele.
+             */
+            name =
+                nameOfModule(node.moduleClass) ?? "box";
         /**
          * A NODE WHOSE CONTENT IS THE CALLER'S is a slot, and it keeps its own name
          * and classes - the border and the hover on a `<tr>{children}</tr>` are real

package/dist/commands/import.js

@@ -13,7 +13,7 @@ import { isNearDuplicate, isNeutral, lightness, } from "../doctor/color-distance
 import { describeGate, gateComponent, groupSkips, SCREENS_FOR_SYSTEM, } from "../doctor/component-gate.js";
 import { emptyTally, internalSpecifiers, scanComponentsInto, tallyToInventory, } from "../doctor/components-scan.js";
 import { countShape, describeCoverage, summarizeCoverage, } from "../doctor/coverage.js";
-import { crosswalk, floorSize, isLibrary, observedRules, useLiveCatalogue, } from "../doctor/crosswalk.js";
+import { classifyAside, crosswalk, floorSize, isLibrary, observedRules, useLiveCatalogue, } from "../doctor/crosswalk.js";
 import { keyframeOffsets, moduleImports, partialCandidates, readGlobalClasses, readModuleCss, readModuleUsage, sheetImports, transcribeModule, } from "../doctor/css-modules.js";
 import { dataContract } from "../doctor/data-contract.js";
 import { reconcile, scanDefinitions, } from "../doctor/definitions-scan.js";
@@ -703,6 +703,10 @@ export async function takeCensus(root, opts) {
                     if (esize > 0 || etag || esketch.length > 0) {
                         looks[extra.name] = {
                             ...(esketch.length > 0 ? { sketch: esketch } : {}),
+                            /** Ver `CensusLook.aside` - o segundo componente do arquivo também. */
+                            ...(classifyAside(extra.name)
+                                ? { aside: classifyAside(extra.name) }
+                                : {}),
                             ...et,
                             ...(etag ? { rootTag: etag } : {}),
                             ...rootPackage(etag, esketch),
@@ -992,6 +996,10 @@ export async function takeCensus(root, opts) {
                 if (size > 0 || tag) {
                     looks[found[0].name] = {
                         ...(sketch.length > 0 ? { sketch } : {}),
+                        /** Ver `CensusLook.aside`: o fato viaja, a regra fica de um lado só. */
+                        ...(classifyAside(found[0].name)
+                            ? { aside: classifyAside(found[0].name) }
+                            : {}),
                         ...withoutDark,
                         base,
                         states,

package/dist/doctor/architecture.js

@@ -115,6 +115,38 @@ export function architectureRule(a) {
         evidence: `${a.evidence.join("/")} under ${a.root}, holding ${a.files} component file${a.files === 1 ? "" : "s"}`,
     };
 }
+/**
+ * A ESTRUTURA, ESCRITA - as pastas que a forma tem, na ordem em que ela as usa.
+ *
+ * Uma opção que diz só o nome da forma e um número não é uma escolha de
+ * organização: "escada atômica, 6 arquivos" não diz a ninguém o que ele está
+ * escolhendo. O dono leu duas opções assim e a pergunta ficou ilegível (19/08).
+ * Então cada opção mostra a árvore, e ela é medida - `evidence` são os diretórios
+ * que fizeram a leitura.
+ */
+export function describeShape(a) {
+    return `${a.root}/${a.evidence.length > 0 ? `{${a.evidence.join(", ")}}` : ""}`;
+}
+/**
+ * QUAIS FORMAS SÃO OPÇÃO, E QUAIS SÃO NOTA DE PÉ - decidido pela escala.
+ *
+ * Duas formas só são uma escolha quando as duas governam código de verdade. No
+ * monorepo do dono a segunda tinha 6 arquivos contra 780 da primeira - duas ordens
+ * de magnitude -, e oferecê-las lado a lado transformou um fato ("existe um canto
+ * organizado assim") numa pergunta que sugere que as duas disputam o repositório.
+ *
+ * O corte é um DÉCIMO da dominante: abaixo dele a forma continua verdadeira e é
+ * dita, mas não pede decisão. Um décimo e não um número redondo qualquer porque é
+ * a fronteira entre "convive" e "um canto".
+ */
+export const MINOR_SHARE = 0.1;
+export function splitByWeight(found) {
+    if (found.length === 0)
+        return { options: [], notes: [] };
+    const top = found[0].files;
+    const options = found.filter((a) => a.files >= top * MINOR_SHARE);
+    return { options, notes: found.filter((a) => !options.includes(a)) };
+}
 /**
  * One line naming what was found, and the choice it leaves open.
  *
@@ -125,10 +157,17 @@ export function describeChoice(found) {
     if (found.length === 0)
         return null;
     if (found.length === 1) {
-        return `One shape, read off your directories: ${found[0].kind} under \`${found[0].root}\`.`;
+        return `One shape, read off your directories: ${found[0].kind} in \`${describeShape(found[0])}\`.`;
+    }
+    const { options, notes } = splitByWeight(found);
+    const say = (a) => `${a.kind} in \`${describeShape(a)}\` (${a.files} files)`;
+    /**
+     * Uma dominante e o resto em cantos: isto não é uma pergunta sobre o retrato, é
+     * uma pergunta sobre a REGRA daqui em diante - e a skill é quem a faz.
+     */
+    if (options.length === 1) {
+        return `One shape governs this code: ${say(options[0])}. Also here, and staying true without deciding anything: ${notes.map(say).join(", ")}.`;
     }
-    const list = found
-        .map((a) => `${a.kind} under \`${a.root}\` (${a.files} files)`)
-        .join(", ");
-    return `${found.length} shapes, and none of them is a mistake: ${list}. A library organised atomically inside a monorepo whose apps are organised by feature is two true answers. Pick which one has PRIORITY - it becomes the rule every prompt reads, and the others stay true without deciding.`;
+    const list = options.map(say).join(", ");
+    return `${options.length} shapes govern real code, and none of them is a mistake: ${list}.${notes.length > 0 ? ` Smaller corners, reported and not asked about: ${notes.map(say).join(", ")}.` : ""} Pick which one has PRIORITY - it becomes the rule every prompt reads, and the others stay true without deciding.`;
 }

package/dist/install-marks.js

@@ -202,7 +202,7 @@ export const CHECKER_SINCE = "0.16.250";
  *               (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.240";
+export const READER_SINCE = "0.16.261";
 /**
  * O QUE ESTÁ INSTALADO AQUI FICOU PARA TRÁS - e as DUAS condições que fazem isso ser verdade.
  *

package/package.json

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