synthesisui 0.16.279 → 0.16.281

package/dist/commands/add.js

@@ -1,4 +1,4 @@
-import { access, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { access, mkdir, readdir, readFile, rm, writeFile, } from "node:fs/promises";
 import { join } from "node:path";
 import { syncClaudeMd } from "../claude-md.js";
 import { readProjectConfig, resolveRegistry } from "../config.js";
@@ -126,16 +126,55 @@ async function readRootLock(path) {
 }
 const exists = (path) => access(path).then(() => true, () => false);
 /**
- * Where the app's routes live: the configured pagesDir at the project root
- * (`app/`) or nested under `src/` (`src/app/` - create-next-app's other
- * layout). Null when neither exists (instructions-only mode).
+ * ONDE AS ROTAS DELE MORAM DE VERDADE - e num monorepo elas não moram na raiz.
+ *
+ * Olhava só `app/` e `src/app/` na raiz. O `codelevel-monorepo` tem `apps/web/app` e
+ * `apps/landing/app`, então a busca voltava null, o `appDir` caía no default `"app"`, e TODO caminho
+ * impresso no setup apontava para uma pasta que não existe: `app/globals.css`, `app/layout.tsx`,
+ * `app/fonts.ts`. O cliente lê três instruções e nenhuma serve para o repositório dele.
+ *
+ * O que faz uma pasta ser raiz de app é o `layout` do App Router morar dentro dela - por isso o
+ * `apps/api` do Nest, que também é um workspace, não entra na lista.
+ *
+ * DEVOLVE TODAS, em ordem determinística: o setup é "once per app" e num monorepo isso é literal.
+ * Escolher uma calada seria acertar uma e errar a outra sem dizer qual.
  */
-async function detectAppDir(root, pagesDir) {
-    if (await exists(join(root, pagesDir)))
-        return pagesDir;
-    if (await exists(join(root, "src", pagesDir)))
-        return `src/${pagesDir}`;
-    return null;
+export async function detectAppDirs(root, pagesDir) {
+    const isAppRoot = async (dir) => {
+        if (!(await exists(join(root, dir))))
+            return false;
+        for (const ext of ["tsx", "jsx", "ts", "js"])
+            if (await exists(join(root, dir, `layout.${ext}`)))
+                return true;
+        return false;
+    };
+    const here = [pagesDir, `src/${pagesDir}`];
+    const nested = [];
+    for (const group of ["apps", "packages"]) {
+        let entries;
+        try {
+            entries = await readdir(join(root, group));
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries.sort())
+            nested.push(`${group}/${entry}/${pagesDir}`, `${group}/${entry}/src/${pagesDir}`);
+    }
+    const found = [];
+    for (const dir of [...here, ...nested])
+        if (await isAppRoot(dir))
+            found.push(dir);
+    /**
+     * A RAIZ QUE EXISTE MAS NÃO TEM LAYOUT ainda é o melhor palpite de um app avulso - é o caso de um
+     * `create-next-app` no meio de uma migração. Sem isto, um projeto de app único perderia a detecção
+     * que já funcionava.
+     */
+    if (found.length === 0)
+        for (const dir of here)
+            if (await exists(join(root, dir)))
+                return [dir];
+    return found;
 }
 /**
  * Materializes a published DS into `_synthesisui/ds/<slug>/v<version>/`, points
@@ -355,10 +394,19 @@ export async function add(slug, opts) {
     // Where the app actually lives (app/ vs src/app/) drives every printed
     // path: the @import depth, the layout example, and where fonts.ts lands.
     const projectConfig = await readProjectConfig(projectRoot);
-    const appDir = (await detectAppDir(projectRoot, projectConfig.pagesDir)) ??
-        projectConfig.pagesDir;
+    const appDirs = await detectAppDirs(projectRoot, projectConfig.pagesDir);
+    /** Nenhuma pasta encontrada: os caminhos viram exemplo, e o texto abaixo diz isso. */
+    const appDir = appDirs[0] ?? projectConfig.pagesDir;
+    const appDirFound = appDirs.length > 0;
     const importPrefix = "../".repeat(appDir.split("/").length);
     console.log(section("One-time setup (once per app)"));
+    /**
+     * "ONCE PER APP" É LITERAL NUM MONOREPO, e calar os outros apps entrega metade da fiação. Os
+     * caminhos abaixo são de um só; sem esta linha o cliente conclui que o repositório inteiro está
+     * ligado quando só o primeiro está.
+     */
+    if (appDirs.length > 1)
+        console.log(line(`(${appDirs.length} apps here: ${appDirs.join(", ")} - the paths below are for ${appDir}; repeat for the others.)`));
     console.log(line(`1. Import the system in your GLOBAL stylesheet, e.g. ${appDir}/globals.css`));
     console.log(line(`   (the path is relative to that file - hence the leading ${importPrefix}):`));
     console.log("");
@@ -434,7 +482,14 @@ export async function add(slug, opts) {
             console.log(line("   Finish the wiring with two small edits:"));
         }
         else {
-            console.log(line(`3. Load the type via next/font (${appDir}/fonts.ts already exists - left untouched; it should export:)`));
+            console.log(line(appDirFound
+                ? `3. Load the type via next/font (${appDir}/fonts.ts already exists - left untouched; it should export:)`
+                : /**
+                   * A FRASE DIZIA "already exists" PARA DOIS ESTADOS DIFERENTES, e um deles é o contrário
+                   * disso: não achei a pasta do app. No monorepo dele o arquivo não existia e o terminal
+                   * dizia que existia - o cliente não tem como saber que os caminhos acima são chute.
+                   */
+                    `3. Load the type via next/font (I could not find your app folder from here, so the paths above are examples - create ${appDir}/fonts.ts wherever your app router lives):`));
             console.log("");
             console.log(snippet(nextFonts.fontsFile));
             console.log("");

package/dist/commands/sync.js

@@ -117,7 +117,7 @@ export async function sync(opts) {
         console.log(body(measured
             ? "This repo has a census but no installed system, so there is nowhere to send it. `import` created the system on the platform; bringing it back is what tells sync which one this repo feeds:"
             : "No installed system here, so there is nowhere to sync to. Install one first:"));
-        console.log(body(paint.blue("    npx synthesisui@latest bp <slug>      # or: add <slug>")));
+        console.log(body(paint.blue("    npx synthesisui@latest add <slug>")));
         console.log(body(paint.faint("    npx synthesisui@latest list --mine    # the slugs you own")));
         return;
     }

package/dist/fonts.js

@@ -12,6 +12,22 @@ const GENERIC_FAMILIES = new Set([
     "inherit",
     "initial",
 ]);
+/**
+ * A PRIMEIRA FAMÍLIA DE UMA PILHA - `"Geist Mono", ui-monospace, monospace` é `Geist Mono`.
+ *
+ * O DOCUMENTO GUARDA A PILHA INTEIRA DE PROPÓSITO: é o que o código dele declara, e a lei 12 diz que
+ * o que ele declarou vence. O que não pode é a pilha virar NOME - e era o que acontecia aqui. O `add`
+ * do codelevel-ui imprimiu, em 22/08, um `fonts.ts` que não compila:
+ *
+ *     export const mono = "Geist_Mono",_ui-monospace,_monospace({   // ← não é JavaScript
+ *
+ * e um href com `family="Geist+Mono",+ui-monospace,+monospace`, que o Google Fonts não resolve. Duas
+ * das quatro vagas do sistema dele saíam quebradas, e o cliente só descobriria colando o snippet.
+ *
+ * Um download pede UM nome de família; a pilha é o fallback do navegador e não viaja na URL. A mesma
+ * regra já existia em `read-unread.ts` na plataforma - existia num lugar e faltava neste.
+ */
+const firstFamily = (value) => (value.split(",")[0] ?? "").trim().replace(/^["']|["']$/g, "");
 /**
  * TODA VAGA DE FONTE DO DOCUMENTO, dedup e sem os genéricos.
  *
@@ -36,7 +52,7 @@ export function customFontFamilies(families) {
     const seen = new Set();
     const names = [];
     for (const slot of familySlots(families)) {
-        const name = families[slot]?.trim();
+        const name = firstFamily(families[slot] ?? "");
         if (!name)
             continue;
         const key = name.toLowerCase();
@@ -68,17 +84,17 @@ export function googleFontsHref(families) {
 export function nextFontSnippet(families, slug, appDir = "app") {
     /** Toda vaga que o documento tem, não só as nossas três - ver `customFontFamilies`. */
     const roles = familySlots(families).filter((role) => {
-        const name = families[role]?.trim();
+        const name = firstFamily(families[role] ?? "");
         return name && !GENERIC_FAMILIES.has(name.toLowerCase());
     });
     if (roles.length === 0)
         return null;
-    const importName = (name) => name.trim().replace(/ /g, "_");
+    const importName = (name) => firstFamily(name).replace(/ /g, "_");
     const seen = new Map(); // family name -> const name
     const importNames = [];
     const consts = [];
     for (const role of roles) {
-        const name = (families[role] ?? "").trim();
+        const name = firstFamily(families[role] ?? "");
         if (!seen.has(name)) {
             seen.set(name, role);
             importNames.push(importName(name));
@@ -101,13 +117,13 @@ export function nextFontSnippet(families, slug, appDir = "app") {
         ...consts,
     ];
     const roleVar = (role) => {
-        const name = (families[role] ?? "").trim();
+        const name = firstFamily(families[role] ?? "");
         return `--font-ds-${seen.get(name)}`;
     };
     const layout = [
         `// ${appDir}/layout.tsx`,
-        `import { ${[...new Set(roles.map((r) => seen.get((families[r] ?? "").trim())))].join(", ")} } from "./fonts";`,
-        `<body data-ds="${slug}" className={\`${[...new Set(roles.map((r) => `\${${seen.get((families[r] ?? "").trim())}.variable}`))].join(" ")}\`}>`,
+        `import { ${[...new Set(roles.map((r) => seen.get(firstFamily(families[r] ?? ""))))].join(", ")} } from "./fonts";`,
+        `<body data-ds="${slug}" className={\`${[...new Set(roles.map((r) => `\${${seen.get(firstFamily(families[r] ?? ""))}.variable}`))].join(" ")}\`}>`,
     ];
     const css = [
         `/* ${appDir}/globals.css - AFTER the tokens.css import */`,

package/dist/index.js

@@ -44,8 +44,8 @@ Usage - deterministic, FREE:
   synthesisui list [options]               list the published design systems
   synthesisui list --mine                  your own systems, with their group
   synthesisui add <slug> [options]         materialize a DS into _synthesisui/ds/<slug>/
-  synthesisui bp  <slug> [options]         the same command, short for blueprint
   synthesisui component <slug> <name>      bring one EXISTING component in as YOUR <Pascal>.tsx
+  synthesisui bp <slug> <name>             the same command, short for blueprint
   synthesisui template <slug> <name>       materialize a whole page from a DS template
                                            (--as landing-home names the output - multi-page safe)
   synthesisui upgrade <slug>               update an installed DS + regenerate your components + migration brief
@@ -349,15 +349,6 @@ async function main() {
              */
             await list({ registry, mine: flags.mine === true });
             break;
-        /**
-         * `bp` É O MESMO COMANDO QUE `add`, e o apelido existe porque `blueprint` é o nome público do
-         * que a plataforma produz.
-         *
-         * Apelido e não substituição: `add` está escrito em toda mensagem que o CLI já imprimiu, em
-         * todo GUIDE.md já materializado e na cabeça de quem usa. Trocá-lo faria um comando que a pessoa
-         * digitou ontem parar de existir hoje.
-         */
-        case "bp":
         case "add": {
             const slug = args[0];
             if (!slug) {
@@ -463,6 +454,20 @@ async function main() {
             });
             break;
         }
+        /**
+         * `bp` É O MESMO COMANDO QUE `component`, e é AQUI que ele pertence.
+         *
+         * O apelido nasceu em 22/08 pendurado no `add`, e estava errado: `add` instala o SISTEMA
+         * inteiro - tokens, receitas, GUIDE - e `blueprint` é um COMPONENTE. A tela do Studio lista
+         * `componentNames + blockNames` sob a frase "No blueprints yet", e a ferramenta MCP
+         * `add_blueprint` materializa exatamente um.
+         *
+         * O custo do erro apareceu na primeira vez que alguém leu: o dono viu
+         * `npx synthesisui bp codelevel-ui` e entendeu "gerar um componente novo", que é o que a
+         * palavra promete - e o comando instalava o sistema. Um apelido que promete outra coisa é pior
+         * que apelido nenhum.
+         */
+        case "bp":
         case "component": {
             const slug = args[0];
             const name = args[1];

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.278";
+export const MATERIALISER_SINCE = "0.16.281";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/package.json

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