synthesisui 0.16.293 → 0.16.294

package/dist/commands/component.js

@@ -34,6 +34,22 @@ async function writeCn(root, compDir, slug) {
 /** Slugs/names are kebab-case by contract; reject anything else before it ever
  *  reaches a filesystem path (defense-in-depth against `../` traversal). */
 const SAFE_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/**
+ * O NOME QUE O ARQUIVO VAI TER - o do blueprint, ou o que ele pediu.
+ *
+ * Puro e exportado porque é a decisão, e ela precisa ser provada sem rede nem disco. O nome vem da
+ * linha de comando e termina dentro de um `join`, então a validação é defesa em profundidade e não
+ * capricho: `--as ../escape` não pode chegar ao sistema de arquivos.
+ */
+export function localName(blueprint, asked) {
+    const wanted = asked?.trim();
+    if (!wanted)
+        return blueprint;
+    if (!SAFE_NAME.test(wanted)) {
+        throw new RegistryError(`Invalid --as "${wanted}" - use kebab-case, like \`--as my-${blueprint}\`.`);
+    }
+    return wanted;
+}
 /**
  * Brings ONE component from a design system into the project (granular "bring
  * specific", INS-18 fatia 3):
@@ -172,7 +188,15 @@ export async function component(slug, name, opts) {
             console.log(body("Nothing of yours was touched. Which name it takes is your call, not ours."));
             return;
         }
-        const compDir = join(root, config.componentsDir, res.name);
+        /**
+         * O NOME QUE O ARQUIVO VAI TER - ver `localName`.
+         *
+         * `--as` é o que permite ele VER o que um blueprint produz num repositório que já tem o
+         * componente. O CSS não muda de nome: a receita é a do blueprint, e as classes dela são
+         * `.ds-<blueprint>` - o componente novo veste o mesmo desenho, com o nome dele no arquivo.
+         */
+        const local = localName(res.name, opts.as);
+        const compDir = join(root, config.componentsDir, local);
         await mkdir(compDir, { recursive: true });
         let filenames;
         if (wantInteractive) {
@@ -180,10 +204,10 @@ export async function component(slug, name, opts) {
             // it wears (.css) + the barrel. Ignores the css|tailwind flavor - the
             // template drives itself off the .ds-* classes.
             const tsx = interactiveTemplate(res.name);
-            await writeFile(join(compDir, `${res.name}.tsx`), tsx, "utf8");
-            await writeFile(join(compDir, `${res.name}.css`), `${css}\n`, "utf8");
-            await writeFile(join(compDir, "index.ts"), `export * from "./${res.name}";\n`, "utf8");
-            filenames = [`${res.name}.tsx`, `${res.name}.css`, "index.ts"];
+            await writeFile(join(compDir, `${local}.tsx`), tsx, "utf8");
+            await writeFile(join(compDir, `${local}.css`), `${css}\n`, "utf8");
+            await writeFile(join(compDir, "index.ts"), `export * from "./${local}";\n`, "utf8");
+            filenames = [`${local}.tsx`, `${local}.css`, "index.ts"];
         }
         else {
             const files = generateComponentFiles(slug, res.name, res.recipe, css, res.version, config.styles, await reactMajorOf(root), 
@@ -195,7 +219,17 @@ export async function component(slug, name, opts) {
              * it, so the TSX and the stylesheet in the same folder agree by
              * construction. Falling back to disk keeps an older registry working.
              */
-            res.classNames ?? (await readInstalledConvention(root, slug)), res.name, await readInstalledScheme(root, slug));
+            res.classNames ?? (await readInstalledConvention(root, slug)), 
+            /**
+             * O NOME LOCAL, e o codegen já sabia fazer isto - ver `localName` em
+             * `component-codegen.ts`: *"A project that already exports `Button` should not have to give
+             * the name up to install ours"*. A capacidade existia e nenhuma flag a alcançava, então a
+             * recusa oferecia `--as` e o comando ignorava.
+             *
+             * O ARQUIVO e o EXPORT levam o nome dele; a CLASSE continua sendo a do blueprint. Um
+             * `<CardPreview>` vestindo `.ds-card` está estilizado certo e não faz sombra em nada dele.
+             */
+            local, await readInstalledScheme(root, slug));
             /**
              * AS DECLARAÇÕES DO ARQUIVO DELE QUE O INTERPRETADOR NÃO LEU - ver `unread-for-component.ts`.
              *
@@ -217,7 +251,7 @@ export async function component(slug, name, opts) {
             filenames = files.map((f) => f.filename);
         }
         const flavor = wantInteractive ? "interactive" : `styles: ${config.styles}`;
-        console.log(`✓ ${config.componentsDir}/${res.name}/ → ${filenames.join(", ")}  (${flavor})`);
+        console.log(`✓ ${config.componentsDir}/${local}/ → ${filenames.join(", ")}  (${flavor})${local === res.name ? "" : `  - the "${res.name}" blueprint, under your name`}`);
     }
     else if (opts.interactive && !hasInteractiveTemplate(res.name)) {
         console.log(`  note: no interactive template for "${res.name}" - materialized the standard shell.`);

package/dist/index.js

@@ -522,6 +522,14 @@ async function main() {
                 version,
                 artifactsOnly: flags["artifacts-only"] === true,
                 interactive: flags.interactive === true,
+                /**
+                 * O NOME LOCAL - ver `localName` em `component.ts`.
+                 *
+                 * A recusa por nome ocupado já oferecia `--as`, e a flag não era lida: quem seguia a
+                 * instrução da tela recebia o arquivo com o nome de sempre.
+                 */
+                ...(typeof flags.as === "string" ? { as: flags.as } : {}),
+                ...(flags.force === true ? { force: true } : {}),
             });
             break;
         }

package/package.json

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