synthesisui 0.16.203 → 0.16.204

package/dist/claude-md.js

@@ -350,9 +350,10 @@ Only write something new when nothing in the manifest covers the purpose - and w
 say which entry you considered and why it did not fit, then FILE it while the reasoning is
 still yours: the \`request_component\` MCP tool, or \`npx synthesisui@latest request component
 --name "<name>" --for "<the use case>" --considered "<entries and why not>"\`. That queue is
-what the system's author works from - a refusal said only in chat evaporates. To review a
-component, create an isolated sample page (e.g. \`app/synthesisui-samples/<component>/\`) - do not
-apply it to real production pages unless asked.${selfCheck}`;
+what the system's author works from - a refusal said only in chat evaporates. If you want to eyeball a
+component on its own, an isolated scratch page is optional and never required - and if you make
+one, put it somewhere that does not become a route in this app, and delete it when you are done.
+Do not apply a component to real production pages unless asked.${selfCheck}`;
     const locale = await readInterfaceLanguage(projectRoot);
     const language = locale === null
         ? ""

package/dist/commands/clean.js

@@ -1,4 +1,4 @@
-import { readFile, rm, stat, writeFile } from "node:fs/promises";
+import { readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { join, relative } from "node:path";
 import { body, section } from "../output.js";
 // The five SVGs create-next-app drops into public/. Filenames are specific
@@ -100,6 +100,35 @@ export async function clean(opts) {
             run: () => rm(readmePath),
         });
     }
+    /**
+     * O RASCUNHO QUE A NOSSA PRÓPRIA INSTRUÇÃO PEDIU - e que ninguém sabia remover.
+     *
+     * O `CLAUDE.md` que este CLI escreve sugere uma página isolada para olhar um componente sozinho,
+     * e o agente da pessoa a cria. Nada aqui a escreve, e nada aqui a apagava: ela ficava numa rota
+     * de VERDADE do app dela (`src/app/synthesisui-samples/<x>` é URL acessível), sem dono e sem
+     * saída, até alguém commitar sem querer. Encontrada no repo do dono em 11/08.
+     *
+     * É a mesma assimetria do bloco de shell: fácil de entrar, sem porta de saída. Aqui a saída é
+     * este comando, e ele mantém o contrato que já tem - seco por padrão, cada caminho nomeado antes
+     * de qualquer escrita, `--force` para aplicar.
+     *
+     * UMA AÇÃO POR PÁGINA, e não uma pela pasta: um destrutivo que anuncia um e remove seis faz mais
+     * do que diz, e essa lei já foi paga uma vez na poda de órfãos.
+     */
+    const samplesDir = join(appDir, "synthesisui-samples");
+    for (const entry of await readdir(samplesDir, {
+        withFileTypes: true,
+    }).catch(() => [])) {
+        if (!entry.isDirectory())
+            continue;
+        const p = join(samplesDir, entry.name);
+        actions.push({
+            verb: "remove",
+            path: rel(p),
+            why: "scratch page for eyeballing a component - nothing depends on it",
+            run: () => rm(p, { recursive: true }),
+        });
+    }
     if (actions.length === 0) {
         console.log(section("Clean up scaffold"));
         console.log(body("Nothing to clean - this project is already tidy."));

package/dist/last-sync.js

@@ -24,7 +24,14 @@ export const LAST_SYNC_FILE = ".last-sync.json";
  *
  * `name` sai do valor porque já É a chave - hasheá-lo junto só gastaria bytes.
  */
-export function fingerprintReadings(components) {
+export function fingerprintReadings(
+/**
+ * A LINHA INTEIRA, e o tipo tem que dizer isso: `{ name?: unknown }` prometia menos do que esta
+ * função aceita, e o próprio spec precisou de um `as never` para passar uma linha real. Um tipo
+ * que obriga a burlá-lo está errado - e o `as never` que ele forçava é exatamente o que faria a
+ * impressão parar de ver um campo novo sem ninguém notar.
+ */
+components) {
     const out = {};
     for (const c of components ?? []) {
         const name = typeof c?.name === "string" ? c.name : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.16.203",
+  "version": "0.16.204",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {
@@ -32,7 +32,8 @@
     "build": "tsc -p tsconfig.json && chmod +x dist/index.js",
     "dev": "tsx src/index.ts",
     "prepublishOnly": "npm run build",
-    "test": "vitest run"
+    "test": "vitest run",
+    "check": "tsc -p tsconfig.check.json"
   },
   "license": "MIT"
 }