synthesisui 0.16.128 → 0.16.130

package/dist/anatomy-read.js

@@ -288,6 +288,15 @@ sketch) {
                 if (measured?.behaviourProps &&
                     Object.keys(measured.behaviourProps).length > 0)
                     node_.behaviourProps = measured.behaviourProps;
+                /**
+                 * O QUE ELE RECEBE E O QUE ELE REPETE, pela mesma consulta. As duas peças que fazem uma
+                 * receita de TELA carregar a fiação de dados, e não só a casca - ver `SketchNode.passes`
+                 * e `SketchNode.repeats`.
+                 */
+                if (measured?.passes && Object.keys(measured.passes).length > 0)
+                    node_.passes = measured.passes;
+                if (measured?.repeats)
+                    node_.repeats = measured.repeats;
             }
             else {
                 if (node.when)

package/dist/commands/import.js

@@ -261,6 +261,8 @@ export async function takeCensus(root, opts) {
     const tally = emptyTally();
     const internal = await internalSpecifiers(root);
     const defined = [];
+    /** Nome → arquivo e fonte, para toda leitura por componente - ver o preenchimento abaixo. */
+    const sourceOf = new Map();
     /** What the gate turned away, with the reason. Never dropped in silence. */
     const skips = [];
     // Kept for the reference check below, which needs every file at once: a name
@@ -411,6 +413,21 @@ export async function takeCensus(root, opts) {
                 componentFiles += 1;
             }
             defined.push(...found);
+            /**
+             * O ARQUIVO E A FONTE DE CADA COMPONENTE QUE GANHA UM LOOK.
+             *
+             * O contrato de dados era estampado a partir de `defined`, a lista que o PORTÃO de
+             * componente aceita - 36 numa biblioteca e 29 num app de 690 arquivos. Então 242 receitas
+             * do dashboard dele e 19 do web-review chegavam sem `api` nenhum: sem props, sem
+             * derivação, sem tipo de eixo e sem o especificador de import, embora 41% e 61% dos
+             * arquivos declarem um `<Nome>Props` (04/08).
+             *
+             * É a mesma classe de defeito da elegibilidade, um nível ao lado: uma leitura pendurada
+             * numa lista feita para biblioteca. O look já nasce aqui, com o arquivo e a fonte na mão,
+             * e é aqui que a leitura tem que se pendurar.
+             */
+            for (const d of found)
+                sourceOf.set(d.name, { file: rel, source: src });
             // THE LOOK, from their own class names. One transcription per file, keyed
             // by the component it defines - the root element's classes are the
             // component's own look, and everything below it is a part this slice does
@@ -1076,7 +1093,21 @@ export async function takeCensus(root, opts) {
             console.log(body(paint.faint(`  and ${unreadableByComponent.length - 8} more components`)));
         }
     }
-    const coverageLines = describeCoverage(coverage);
+    /**
+     * QUANTOS DECIDEM ARRANJO EM VEZ DE APARÊNCIA - a mesma conta que a plataforma faz para
+     * marcar `composition: true`: uma receita sem uma única declaração nunca prometeu cor.
+     * Dito ANTES de importar, porque "36 de 271 saíram com aparência" faz parecer que 235 se
+     * perderam, e eles não se perderam (04/08).
+     */
+    const composition = Object.values(looks).filter((look) => {
+        const l = look;
+        return (Object.keys(l.base ?? {}).length === 0 &&
+            Object.keys(l.dark ?? {}).length === 0 &&
+            Object.keys(l.states ?? {}).length === 0 &&
+            Object.keys(l.parts ?? {}).length === 0 &&
+            (l.layers ?? []).length === 0);
+    }).length;
+    const coverageLines = describeCoverage(coverage, composition);
     if (coverageLines.length > 0) {
         console.log("");
         console.log(section("What this version reads, on your files"));
@@ -1225,12 +1256,23 @@ export async function takeCensus(root, opts) {
      * as not exported. See `publicApi`.
      */
     const api = await publicApi(root);
-    for (const c of components) {
-        const file = defined.find((d) => d.name === c.name)?.file;
-        const source = file
-            ? sources.find((s) => s.file.endsWith(file))?.source
-            : undefined;
-        const required = source ? requiredProps(source, c.name) : [];
+    /**
+     * TODO NOME QUE TEM LEITURA, e não só os que o inventário de USO lista.
+     *
+     * O laço iterava `components` - o inventário de uso - e pendurava o arquivo em `defined`. Duas
+     * listas feitas para biblioteca, e num app nenhuma das duas alcança uma tela: 242 receitas do
+     * dashboard dele ficaram sem `api` (04/08). Agora a leitura acompanha o LOOK, que é onde o
+     * resto da leitura daquele componente já vive, e o inventário continua sendo inventário.
+     */
+    const named = [
+        ...new Set([...components.map((c) => c.name), ...Object.keys(looks)]),
+    ];
+    for (const name of named) {
+        const c = components.find((x) => x.name === name);
+        const at = sourceOf.get(name);
+        const file = at?.file;
+        const source = at?.source;
+        const required = source ? requiredProps(source, name) : [];
         /**
          * THE COMPONENT'S DATA CONTRACT - its props, its derivations, the copy an option
          * carries, and the type that names an axis's options.
@@ -1242,11 +1284,11 @@ export async function takeCensus(root, opts) {
          * Stamped whether or not the folder is a package: a `src/components` with no
          * manifest of its own has no specifier to offer and its components still have props.
          */
-        const span = source ? definitionSpan(source, c.name) : null;
+        const span = source ? definitionSpan(source, name) : null;
         const contract = source
-            ? dataContract(source, span ? source.slice(span.from, span.to) : source, c.name, (c.declaredAxes ?? {}))
+            ? dataContract(source, span ? source.slice(span.from, span.to) : source, name, (c?.declaredAxes ?? looks[name]?.declaredAxes ?? {}))
             : null;
-        c.api = {
+        const stamped = {
             /**
              * SILENCE WHEN THE ENTRY WAS NOT READ. An unreadable entry gives an empty export
              * set, and calling that "internal" would have marked every component internal at
@@ -1254,7 +1296,7 @@ export async function takeCensus(root, opts) {
              */
             ...(!api?.read
                 ? {}
-                : api.exports.has(c.name)
+                : api.exports.has(name)
                     ? { from: api.from }
                     : { exported: false }),
             /**
@@ -1280,8 +1322,18 @@ export async function takeCensus(root, opts) {
                 : {}),
         };
         // An api with nothing in it is not a fact - it is an empty object on 36 components.
-        if (Object.keys(c.api).length === 0)
-            c.api = undefined;
+        /**
+         * ONDE ELE MORA: no LOOK, que é por componente, e também na entrada do inventário quando
+         * existe uma. A entrada é o que a plataforma sempre leu; o look é o que alcança as 242 que
+         * o inventário não tem. Uma leitura, dois endereços, e a plataforma prefere o look.
+         */
+        if (Object.keys(stamped).length === 0)
+            continue;
+        if (c)
+            c.api = stamped;
+        const look = looks[name];
+        if (look)
+            look.api = stamped;
     }
     const brokenRefs = findBrokenRefs(sources, declaredNames);
     const conventions = detectConventions(sources);

package/dist/doctor/coverage.js

@@ -105,12 +105,30 @@ export function summarizeCoverage(counts, components, read, declarations) {
  * then names every shape that is not fully read, with the reason. No percentages without
  * the count behind them: "75%" of an unknown total is a marketing number.
  */
-export function describeCoverage(c) {
+export function describeCoverage(c, 
+/**
+ * QUANTOS SÃO COMPOSIÇÃO, quando quem chama sabe - ver `componentRecipe.composition`.
+ *
+ * Numa biblioteca é zero e a frase não aparece. Num app é a maioria, e dizer só "36 de 271
+ * saíram com aparência" faz parecer que 235 se perderam. Eles não se perderam: decidem
+ * arranjo e fluxo, e é isso que a receita deles carrega. Medido no dashboard dele: 235 de
+ * 271 (04/08).
+ */
+composition) {
     if (c.components === 0)
         return [];
     const lines = [];
     const pct = Math.round((c.read / c.components) * 100);
     lines.push(`${c.read} of ${c.components} components came out with a look - ${pct}%, ${c.declarations} declarations in total. This is measured on your files, not an estimate.`);
+    if (composition && composition > 0) {
+        lines.push(
+        /**
+         * DIZ O QUE FOI MEDIDO, e não o que a plataforma vai concluir. Este número é "não tem
+         * look próprio nos seus arquivos"; a receita final é decidida depois, com a paleta em
+         * mão, e as duas contas não são a mesma. Prometer a segunda aqui seria inventar precisão.
+         */
+        `  and ${composition} have no look of their own in your files - a screen that composes others, in a grid, passing data down. Those arrive as COMPOSITION recipes: the tree, the slots, and what each child receives, with no palette to grade. Nothing was lost; it is a different kind of recipe.`);
+    }
     for (const { shape, files, examples } of c.counts) {
         const share = Math.round((files / c.components) * 100);
         const head = `  ${files} (${share}%) ${shape.label}`;

package/dist/doctor/sketch.js

@@ -351,6 +351,82 @@ export function conditionalPropsOf(body) {
             out[m[1]] = m[2].trim();
     return Object.keys(out).length > 0 ? out : null;
 }
+/**
+ * Toda prop de um elemento, com o valor como eles escreveram - ver `SketchNode.passes`.
+ *
+ * Quatro formas atravessam, porque as quatro são evidência do que a tela liga: a string
+ * literal (a cópia dele), o identificador ou caminho (a fiação), o literal numérico ou
+ * booleano, e a expressão composta curta. Duas não atravessam: função inline e objeto inline.
+ */
+export function passedProps(body, 
+/** O que `behaviourProps` já levou, para cada fato viver num lugar só. */
+taken) {
+    const out = {};
+    const SKIP = /^(className|class|key|ref|style|children)$/;
+    for (const m of body.matchAll(/(\w+)=(?:"([^"]{0,80})"|'([^']{0,80})'|\{([^{}]{1,80})\})/g)) {
+        const prop = m[1];
+        if (SKIP.test(prop) || taken?.[prop] || out[prop])
+            continue;
+        const literal = m[2] ?? m[3];
+        if (literal != null) {
+            out[prop] = literal;
+            continue;
+        }
+        const value = (m[4] ?? "").replace(/\s+/g, " ").trim();
+        // Um corpo de função é código que chama o que a receita não tem; um objeto é estilo.
+        if (!value || /=>|\bfunction\b/.test(value) || value.startsWith("{"))
+            continue;
+        out[prop] = value;
+    }
+    return Object.keys(out).length > 0 ? out : null;
+}
+/**
+ * A expressão que um `map` percorre, quando este elemento está dentro de um - ver `repeats`.
+ *
+ * Mesma forma de `guardAt`: uma varredura para trás até a chamada que envolve este offset, e
+ * o alvo é o que vem antes do `.map(`. Nada é avaliado; a expressão é evidência de que este nó
+ * é uma LISTA.
+ */
+export function repeatOf(source, at) {
+    const MAP = /([A-Za-z_$][\w$.?[\]]{0,60})\s*\.map\s*\(/g;
+    MAP.lastIndex = 0;
+    let found = null;
+    for (const m of source.matchAll(MAP)) {
+        const open = (m.index ?? 0) + m[0].length - 1;
+        if (open > at)
+            break;
+        const end = closeOf(source, open);
+        if (end === -1 || end <= at)
+            continue;
+        found = m[1].replace(/\?$/, "");
+    }
+    return found;
+}
+/** O índice do fecha-parêntese que corresponde ao abre em `open`, ou -1. */
+function closeOf(source, open) {
+    let depth = 0;
+    let quote = "";
+    for (let i = open; i < source.length; i++) {
+        const c = source[i];
+        if (quote) {
+            if (c === "\\")
+                i += 1;
+            else if (c === quote)
+                quote = "";
+            continue;
+        }
+        if (c === '"' || c === "'" || c === "`")
+            quote = c;
+        else if (c === "(")
+            depth += 1;
+        else if (c === ")") {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
 export function sketchOf(source, name) {
     /**
      * READ THE IMPORTS BEFORE SLICING - they live at the top of the file, and the
@@ -433,6 +509,16 @@ export function sketchOf(source, name) {
         const conditional = conditionalPropsOf(event.body);
         if (conditional)
             node.behaviourProps = conditional;
+        /**
+         * O QUE ELE RECEBE E O QUE ELE REPETE - ver `passes` e `repeats`. As duas peças que faltavam
+         * para a receita de uma TELA carregar a fiação, e não só a casca.
+         */
+        const given = passedProps(event.body, conditional);
+        if (given)
+            node.passes = given;
+        const list = repeatOf(source, event.at);
+        if (list)
+            node.repeats = list;
         // What has to be true for this element to exist at all - see `guardAt`.
         const guard = guardAt(source, event.at);
         if (guard) {

package/package.json

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