fix: renombrar .gitignore a gitignore en templates para que npm lo incluya

npm excluye archivos llamados .gitignore del paquete publicado.
Los scaffolders populares (create-next-app, create-vite) usan el mismo
truco: guardan el archivo como 'gitignore' (sin punto) y lo renombran
a '.gitignore' al copiar al proyecto destino.

- Renombrado template/.gitignore -> template/gitignore
- Renombrado template-api/.gitignore -> template-api/gitignore
- Agregado renameDotfiles() en copy-template.ts que renombra
  gitignore -> .gitignore después de copiar
- .npmignore agregado en la raíz del repo
- Tests actualizados para reflejar el rename

Author: gonzoblasco

.npmignore

@@ -0,0 +1,11 @@
+# Excluir lo que no vamos a publicar
+node_modules/
+coverage/
+playwright-report/
+test-results/
+*.log
+.DS_Store
+
+# Pero incluir TODO lo del template, incluyendo dotfiles
+!template/**
+!template-api/**

src/copy-template.ts

@@ -1,4 +1,4 @@
-import { cp, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { cp, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { dirname, join, relative } from "node:path";
 
 export type CopyOptions = {
@@ -36,6 +36,7 @@ export async function copyTemplate(
 	// Hoy solo es package.json (su nombre), pero dejamos la puerta abierta.
 	await customizePackageJson(targetDir, options.projectName);
 	await customizeReadme(targetDir, options.projectName, options.pm);
+	await renameDotfiles(targetDir);
 }
 
 /**
@@ -120,3 +121,27 @@ export async function listFiles(dir: string): Promise<string[]> {
 export function getRelativePath(from: string, to: string): string {
 	return relative(dirname(from), to);
 }
+
+/**
+ * Renombra archivos que npm excluye (como .gitignore) de su versión sin punto
+ * a la versión con punto en el destino.
+ *
+ * npm no publica archivos llamados .gitignore, así que en el template los
+ * guardamos como 'gitignore' (sin punto) y los renombramos al copiar.
+ */
+async function renameDotfiles(targetDir: string): Promise<void> {
+	const renames: Record<string, string> = {
+		gitignore: ".gitignore",
+	};
+
+	for (const [from, to] of Object.entries(renames)) {
+		const fromPath = join(targetDir, from);
+		const toPath = join(targetDir, to);
+		try {
+			await cp(fromPath, toPath);
+			await rm(fromPath);
+		} catch {
+			// Si el archivo no existe, no hay nada que renombrar
+		}
+	}
+}

src/test/copy-template.test.ts

@@ -68,10 +68,13 @@ describe("copyTemplate", () => {
 		const templateFiles = await listFiles(templateDir);
 		const targetFiles = await listFiles(targetDir);
 
-		// Cada archivo del template debe existir en el destino
+		// Cada archivo del template debe existir en el destino,
+		// con excepción de los dotfiles que se renombran (gitignore → .gitignore)
+		const renames: Record<string, string> = { gitignore: ".gitignore" };
 		for (const file of templateFiles) {
-			expect(targetFiles, `Archivo faltante en destino: ${file}`).toContain(
-				file,
+			const expectedFile = renames[file] ?? file;
+			expect(targetFiles, `Archivo faltante en destino: ${expectedFile}`).toContain(
+				expectedFile,
 			);
 		}
 	});
@@ -176,6 +179,6 @@ describe("listFiles", () => {
 		const templateDir = join(process.cwd(), "template");
 		const files = await listFiles(templateDir);
 
-		expect(files).toContain(".gitignore");
+		expect(files).toContain("gitignore");
 	});
 });