create-codeverse 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/LICENSE +21 -0
  2. package/ReadMe.MD +484 -0
  3. package/bin/cli.js +346 -0
  4. package/lib/apply/front.js +122 -0
  5. package/lib/apply/test.js +73 -0
  6. package/lib/copyTemplate.js +73 -0
  7. package/lib/desktop.js +65 -0
  8. package/lib/installDependencies.js +96 -0
  9. package/lib/openInEditor.js +14 -0
  10. package/lib/packageJson.js +33 -0
  11. package/lib/paths.js +4 -0
  12. package/lib/prompts.js +147 -0
  13. package/lib/runCommand.js +44 -0
  14. package/lib/secret.js +80 -0
  15. package/lib/templates.js +97 -0
  16. package/lib/validateProjectName.js +24 -0
  17. package/lib/versions.js +110 -0
  18. package/package.json +49 -6
  19. package/templates/codeskills.enc +0 -0
  20. package/templates/extras/test-componentes/ReadMe.MD +44 -0
  21. package/templates/extras/test-componentes/cypress/component/Login.cy.jsx +120 -0
  22. package/templates/extras/test-componentes/cypress/fixtures/example.json +5 -0
  23. package/templates/extras/test-componentes/cypress/support/commands.js +25 -0
  24. package/templates/extras/test-componentes/cypress/support/component-index.html +14 -0
  25. package/templates/extras/test-componentes/cypress/support/component.js +24 -0
  26. package/templates/extras/test-componentes/cypress.config.js +10 -0
  27. package/templates/extras/test-componentes/src/app/page.jsx +5 -0
  28. package/templates/extras/test-componentes/src/components/Login.jsx +47 -0
  29. package/templates/extras/test-dependencias/tests/nome-do-script.test.js +79 -0
  30. package/templates/front/.env.example +0 -0
  31. package/templates/front/ReadMe.MD +51 -0
  32. package/templates/front/_gitignore +42 -0
  33. package/templates/front/biome.json +42 -0
  34. package/templates/front/jsconfig.json +8 -0
  35. package/templates/front/next.config.mjs +11 -0
  36. package/templates/front/package.template.json +41 -0
  37. package/templates/front/public/fonts/gitkeep +0 -0
  38. package/templates/front/public/icons/gitkeep +0 -0
  39. package/templates/front/public/images/gitkeep +0 -0
  40. package/templates/front/public/media/gitkeep +0 -0
  41. package/templates/front/public/sounds/gitkeep +0 -0
  42. package/templates/front/src/app/favicon.ico +0 -0
  43. package/templates/front/src/app/globals.css +9 -0
  44. package/templates/front/src/app/layout.js +14 -0
  45. package/templates/front/src/app/nome-da-rota/nome-da-rota.module.css +0 -0
  46. package/templates/front/src/app/nome-da-rota/page.jsx +5 -0
  47. package/templates/front/src/app/page.jsx +39 -0
  48. package/templates/front/src/app/page.module.css +98 -0
  49. package/templates/front/src/components/Nome-do-componente.jsx +5 -0
  50. package/templates/front/src/components/Nome-do-componente.module.css +0 -0
  51. package/templates/integracao/ReadMe.MD +41 -0
  52. package/templates/integracao/cypress/e2e/meu-teste.cy.js +75 -0
  53. package/templates/integracao/cypress/fixtures/example.json +5 -0
  54. package/templates/integracao/cypress/support/commands.js +25 -0
  55. package/templates/integracao/cypress/support/e2e.js +17 -0
  56. package/templates/integracao/cypress.config.js +7 -0
  57. package/templates/integracao/package.template.json +38 -0
  58. package/templates/test/.env.example +0 -0
  59. package/templates/test/ReadMe.MD +49 -0
  60. package/templates/test/_gitignore +25 -0
  61. package/templates/test/jest.reporters.config.mjs +14 -0
  62. package/templates/test/package.template.json +42 -0
  63. package/templates/test/src/nome-do-seu-script.js +4 -0
  64. package/templates/test/tests/nome-do-script.test.js +40 -0
  65. package/templates/versions.json +84 -0
  66. package/README.md +0 -3
package/bin/cli.js ADDED
@@ -0,0 +1,346 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { existsSync, rmSync } from 'node:fs';
4
+ import { join } from 'node:path';
5
+
6
+ import { intro, log, multiselect, note, outro, password, select, text } from '@clack/prompts';
7
+
8
+ import { copyTemplate, writeSecretTemplate } from '../lib/copyTemplate.js';
9
+ import { getDesktopDir, startDesktopLookup } from '../lib/desktop.js';
10
+ import { buildInstallCommands, formatCommand, startInstall } from '../lib/installDependencies.js';
11
+ import { isInsideVsCode, openInEditor } from '../lib/openInEditor.js';
12
+ import { setPackageInfo, writePackageJson } from '../lib/packageJson.js';
13
+ import {
14
+ alignedOptions,
15
+ cancellableSpinner,
16
+ configurePrompts,
17
+ countdown,
18
+ exitIfCancel,
19
+ onCancel,
20
+ readingPause,
21
+ replaceAnswerLine,
22
+ } from '../lib/prompts.js';
23
+ import { openSecretTemplate } from '../lib/secret.js';
24
+ import { templates } from '../lib/templates.js';
25
+ import { validateProjectName } from '../lib/validateProjectName.js';
26
+ import { mergePackages, prepareVersions } from '../lib/versions.js';
27
+
28
+ const OPEN_DELAY_SECONDS = 5;
29
+
30
+ // Apaga a pasta do projeto no Ctrl+C. Logo depois de o npm ser encerrado, o Windows
31
+ // (ou o antivírus) ainda pode estar soltando os arquivos, então tenta várias vezes;
32
+ // se não der, avisa para apagar manualmente.
33
+ function removeProjectFolder(targetDir) {
34
+ try {
35
+ rmSync(targetDir, { recursive: true, force: true, maxRetries: 10, retryDelay: 300 });
36
+ } catch {
37
+ log.warn(`Não consegui apagar a pasta do projeto. Apague manualmente:\n${targetDir}`);
38
+ }
39
+ }
40
+ const READING_PAUSE_MS = 2000;
41
+
42
+ // true se o projeto tem cypress e o programa dessa versão ainda não está no PC.
43
+ // Aceita "X.Y.Z" e "^X.Y.Z" (o "latest" já consultado no registry vira "^X.Y.Z",
44
+ // que é a própria última versão, a mesma que o npm instala). Na dúvida ("latest"
45
+ // sem consulta, outro formato ou sem LOCALAPPDATA), considera que vai baixar.
46
+ function needsCypressDownload({ pinned, latest }) {
47
+ if (latest.devDependencies.includes('cypress')) return true;
48
+ const version = pinned.devDependencies.cypress?.replace(/^\^/, '');
49
+ if (!version) return false;
50
+ const cacheRoot = process.env.LOCALAPPDATA;
51
+ if (!cacheRoot || !/^\d+\.\d+\.\d+$/.test(version)) return true;
52
+ return !existsSync(join(cacheRoot, 'Cypress', 'Cache', version));
53
+ }
54
+
55
+ async function main() {
56
+ startDesktopLookup();
57
+ console.clear();
58
+ configurePrompts();
59
+ intro('Bem-vindo(a) ao CodeVerse ⚡');
60
+ note('Seu ambiente de desenvolvimento começa aqui ... 💫', 'O que vamos construir hoje? 🙌');
61
+ // 1 s para o aluno ler as boas-vindas antes do menu (teclas nesse tempo são ignoradas).
62
+ // A consulta da Área de Trabalho (PowerShell, começou no início do CLI) termina
63
+ // ANTES do primeiro menu: um processo encerrando com um menu aberto pode mexer no
64
+ // modo do teclado do terminal e travar o menu. Normalmente já terminou na pausa.
65
+ const [baseDir] = await Promise.all([getDesktopDir(), readingPause(READING_PAUSE_MS)]);
66
+
67
+ // Assim que cada pergunta do menu é respondida, a consulta das versões
68
+ // "latest" daqueles blocos começa em segundo plano, enquanto o aluno responde
69
+ // as próximas. Os resultados são juntados na hora de criar o projeto; um erro
70
+ // aqui só aparece lá (o `.catch` vazio evita o aviso de erro não tratado).
71
+ const versionLookups = [];
72
+ const lookupVersions = (blockPaths) => {
73
+ const lookup = prepareVersions(blockPaths);
74
+ lookup.catch(() => {});
75
+ versionLookups.push(lookup);
76
+ };
77
+
78
+ // Ordem alfabética, exceto os templates com `last: true`, que ficam sempre no fim.
79
+ const sortedTemplates = [...templates].sort(
80
+ (a, b) => Boolean(a.last) - Boolean(b.last) || a.label.localeCompare(b.label, 'pt-BR'),
81
+ );
82
+
83
+ // Templates com `secret: true` pedem o código secreto. Código errado volta
84
+ // para este menu; código certo deixa em `secretFiles` os arquivos já abertos.
85
+ let template;
86
+ let secretFiles = null;
87
+ while (true) {
88
+ const templateId = exitIfCancel(
89
+ await select({
90
+ showInstructions: false,
91
+ message: 'O que vamos construir hoje? Sua próxima grande ideia começa aqui! ✨',
92
+ options: alignedOptions(sortedTemplates),
93
+ }),
94
+ );
95
+
96
+ template = templates.find((item) => item.id === templateId);
97
+
98
+ if (!template.ready) {
99
+ note(
100
+ 'Em breve teremos muito mais novidades para vocês!!!',
101
+ 'Estamos trabalhando nisso 🚧',
102
+ );
103
+ outro('Até a próxima, DEV! 🚀');
104
+ return;
105
+ }
106
+
107
+ if (!template.secret) break;
108
+
109
+ const code = exitIfCancel(
110
+ await password({
111
+ message: 'Digite o código super secreto 🔒',
112
+ validate: (raw) => {
113
+ if (!String(raw ?? '')) return 'Digite o código, fera ...';
114
+ },
115
+ }),
116
+ );
117
+
118
+ const checking = cancellableSpinner();
119
+ checking.start('Verificando o código...');
120
+ try {
121
+ secretFiles = await openSecretTemplate(template.id, code);
122
+ } catch (err) {
123
+ checking.error(err.message);
124
+ process.exitCode = 1;
125
+ return;
126
+ }
127
+ if (secretFiles) {
128
+ checking.stop('Código aceito! 🔓');
129
+ break;
130
+ }
131
+ checking.error('Código inválido. Escolha o template de novo. 😢');
132
+ }
133
+
134
+ // Sem `choice`, os blocos já são conhecidos aqui: `versions` do template (ex.:
135
+ // CodeSkills = "front.base" + "codeskills.base") ou "<id>.base". Com `choice`,
136
+ // os blocos vêm do sub-template escolhido.
137
+ if (!template.choice) lookupVersions(template.versions ?? [`${template.id}.base`]);
138
+
139
+ // Templates com `choice` (ex.: Test) escolhem um sub-template de seleção única,
140
+ // com pasta (`dir`), extras e `apply` próprios. Os demais usam multiselect de extras.
141
+ let dir = template.id;
142
+ let chosenOptions = [];
143
+ let apply = template.apply;
144
+ if (template.choice) {
145
+ // Ordem fixa definida em lib/templates.js (não alfabética).
146
+ const choiceId = exitIfCancel(
147
+ await select({
148
+ showInstructions: false,
149
+ message: 'Que tipo de teste você vai fazer? 🧪',
150
+ options: alignedOptions(template.options),
151
+ }),
152
+ );
153
+
154
+ const choice = template.options.find((item) => item.id === choiceId);
155
+ if (!choice.ready) {
156
+ note(
157
+ 'Em breve teremos muito mais novidades para vocês!!!',
158
+ 'Estamos trabalhando nisso 🚧',
159
+ );
160
+ outro('Até a próxima, DEV! 🚀');
161
+ return;
162
+ }
163
+
164
+ dir = choice.dir;
165
+ apply = choice.apply;
166
+ lookupVersions(choice.versions);
167
+ } else if (template.options?.length) {
168
+ const sortedOptions = [...template.options].sort((a, b) =>
169
+ a.label.localeCompare(b.label, 'pt-BR'),
170
+ );
171
+ const extraOptions = alignedOptions(sortedOptions);
172
+ chosenOptions = exitIfCancel(
173
+ await multiselect({
174
+ showInstructions: false,
175
+ message: 'Quais extras vão turbinar seu projeto? (opcional) ⚡',
176
+ options: extraOptions,
177
+ required: false,
178
+ }),
179
+ );
180
+
181
+ // O resumo do clack usa os labels alinhados ("Axios , Toast-Hot");
182
+ // reescreve a linha com os labels sem os espaços, na mesma ordem.
183
+ if (chosenOptions.length === 0) {
184
+ replaceAnswerLine('Nenhum extra selecionado', 'none');
185
+ } else {
186
+ const chosenLabels = extraOptions
187
+ .filter(({ value }) => chosenOptions.includes(value))
188
+ .map(({ label }) => label);
189
+ replaceAnswerLine(
190
+ chosenLabels.map((label) => label.trimEnd()).join(', '),
191
+ chosenLabels.join(', '),
192
+ );
193
+ // Cada extra usa o próprio `versions` (ex.: Ant Design = "front.antd" +
194
+ // "front.antdRegistry") ou, sem ele, o bloco "<template>.<extra>".
195
+ lookupVersions(
196
+ chosenOptions.flatMap(
197
+ (id) =>
198
+ template.options.find((item) => item.id === id).versions ?? [
199
+ `${template.id}.${id}`,
200
+ ],
201
+ ),
202
+ );
203
+ }
204
+ }
205
+
206
+ // O projeto é sempre criado na Área de Trabalho do Windows (`baseDir`, a real,
207
+ // inclusive no OneDrive), descoberta antes do primeiro menu.
208
+
209
+ const projectName = exitIfCancel(
210
+ await text({
211
+ message: 'Qual é o nome do seu projeto/app? 💻',
212
+ placeholder: 'num-crasha-por-favor',
213
+ validate: (raw) => {
214
+ const result = validateProjectName(raw);
215
+ if (!result.valid) return result.message;
216
+ if (existsSync(join(baseDir, result.value))) {
217
+ return 'Já existe uma pasta com esse nome na Área de Trabalho. Escolha outro nome.';
218
+ }
219
+ },
220
+ }),
221
+ ).trim();
222
+
223
+ const targetDir = join(baseDir, projectName);
224
+
225
+ // Com o nome do projeto, o projeto já é criado e o `npm install` começa em
226
+ // segundo plano, enquanto o aluno responde as últimas perguntas.
227
+ // Ctrl+C daqui até o fim da instalação (pergunta ou spinner): para o npm e apaga
228
+ // a pasta, para nada sobrar no disco. A pasta não existia (o nome foi validado),
229
+ // então só é apagado o que o próprio CLI criou.
230
+ let install = null;
231
+ const stopCleanup = onCancel(() => {
232
+ install?.cancel();
233
+ removeProjectFolder(targetDir);
234
+ });
235
+
236
+ const progress = cancellableSpinner();
237
+ progress.start('Criando o seu projeto...');
238
+
239
+ let commands;
240
+ let packages;
241
+ try {
242
+ // Template secreto: os arquivos vêm do .enc já aberto; as versões, como nos
243
+ // demais, vêm do versions.json.
244
+ if (secretFiles) await writeSecretTemplate(secretFiles, targetDir);
245
+ else await copyTemplate(dir, targetDir);
246
+
247
+ // Junta as consultas feitas durante o menu (base + extras, ou o sub-template).
248
+ // Com as versões "latest" já consultadas, o package.json sai completo e roda
249
+ // um único `npm install`. Sem acesso ao registry, segue com os `@latest`.
250
+ packages = mergePackages(await Promise.all(versionLookups));
251
+ commands = buildInstallCommands(packages);
252
+ await writePackageJson(targetDir, { projectName }, packages.pinned);
253
+ await apply?.(targetDir, chosenOptions);
254
+ progress.stop('Projeto criado! 👍');
255
+ } catch (err) {
256
+ stopCleanup();
257
+ progress.error(err.message);
258
+ process.exitCode = 1;
259
+ return;
260
+ }
261
+
262
+ install = startInstall(targetDir, commands);
263
+
264
+ // Opcional: em branco, o package.json fica com a descrição do template.
265
+ const description = String(
266
+ exitIfCancel(
267
+ await text({
268
+ message: 'Qual é a descrição do seu projeto/app? (opcional) 📝',
269
+ placeholder: 'Meu app vai mudar o mundo',
270
+ }),
271
+ ) ?? '',
272
+ ).trim();
273
+
274
+ const devName = exitIfCancel(
275
+ await text({
276
+ message: 'Qual é o seu nome, DEV? 👧',
277
+ placeholder: 'Buguilino Undefined NotNull',
278
+ validate: (raw) => {
279
+ if (!String(raw ?? '').trim()) return 'Digite o seu nome, fera ...';
280
+ },
281
+ }),
282
+ ).trim();
283
+
284
+ // Espera o que faltar da instalação (se já terminou, fecha na hora).
285
+ // Se a instalação falhar, a pasta é mantida e `pending` guarda o que faltou.
286
+ // O cypress baixa o próprio programa (~200 MB) ao ser instalado, então avisa o aluno,
287
+ // a não ser que essa versão já esteja no cache do PC (%LOCALAPPDATA%\Cypress\Cache\<versão>).
288
+ let pending = [];
289
+ progress.start(
290
+ needsCypressDownload(packages)
291
+ ? 'Baixando o Cypress, pode demorar alguns minutos ⏳ '
292
+ : 'Instalando dependências ⏳ ',
293
+ );
294
+ try {
295
+ await install.done;
296
+ progress.stop('Dependências instaladas!');
297
+ } catch (err) {
298
+ pending = err.pending ?? commands;
299
+ progress.error('Falha ao instalar as dependências.');
300
+ log.error(err.message);
301
+ }
302
+
303
+ // Instalação encerrada (com ou sem falha): a partir daqui o projeto fica, mesmo
304
+ // com Ctrl+C (ex.: na contagem para abrir o VS Code).
305
+ stopCleanup();
306
+
307
+ // Descrição e autor entram depois do install, para não disputar o package.json com o npm.
308
+ try {
309
+ await setPackageInfo(targetDir, { description, devName });
310
+ } catch (err) {
311
+ log.warn(`Não consegui gravar a descrição e o autor no package.json: ${err.message}`);
312
+ }
313
+
314
+ if (pending.length > 0) {
315
+ const manualSteps = [`cd "${targetDir}"`, ...pending.map(formatCommand)].join('\n');
316
+ note(manualSteps, 'Falta instalar as dependências. Rode no terminal:');
317
+ process.exitCode = 1;
318
+ } else {
319
+ note("Para rodar, abra o terminal do VS Code (Ctrl + ') e execute:\nnpm run dev");
320
+ }
321
+
322
+ // A abertura do VS Code é o último passo, depois de uma contagem que dá tempo
323
+ // de ler as mensagens acima. Dentro do terminal do VS Code, o projeto novo troca
324
+ // a janela atual (`code -r`), o que encerra este terminal.
325
+ await countdown('Abrindo o VS Code', OPEN_DELAY_SECONDS);
326
+ outro(
327
+ pending.length > 0
328
+ ? 'Projeto criado com pendências.'
329
+ : 'Parabéns e bom desenvolvimento! 🚀',
330
+ );
331
+
332
+ const opened = await openInEditor(targetDir, { reuseWindow: isInsideVsCode() });
333
+ if (!opened)
334
+ log.warn(`VS Code não encontrado. Abra manualmente a pasta do projeto: ${targetDir}`);
335
+ }
336
+
337
+ // Encerra assim que o fluxo termina (inclusive no "em breve" e nos erros). No
338
+ // Windows, depois dos menus o terminal fica esperando uma linha do teclado e o
339
+ // processo só terminaria com um Enter. O código de saída (process.exitCode) é mantido.
340
+ // Um erro inesperado ainda aparece na tela e sai com código 1.
341
+ main()
342
+ .catch((err) => {
343
+ console.error(err);
344
+ process.exitCode = 1;
345
+ })
346
+ .finally(() => process.exit());
@@ -0,0 +1,122 @@
1
+ import { readFile, rm, writeFile } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+
4
+ const POSTCSS_CONFIG = `const config = {
5
+ plugins: {
6
+ '@tailwindcss/postcss': {},
7
+ },
8
+ };
9
+
10
+ export default config;
11
+ `;
12
+
13
+ // Com Tailwind, o globals.css fica só com o import (o preflight do Tailwind
14
+ // substitui o reset que existia antes).
15
+ const TAILWIND_GLOBALS = '@import "tailwindcss";\n';
16
+
17
+ // Mesma tela do page.jsx original, com classes do Tailwind no lugar do
18
+ // page.module.css (que é removido nesse caso).
19
+ const TAILWIND_PAGE = `export default function Home() {
20
+ return (
21
+ <main className="flex min-h-screen w-full flex-col items-center justify-start bg-[image:linear-gradient(to_bottom,rgba(10,15,30,0.35),rgba(10,15,30,0.5)),url('https://minio.codeverse.dev.br/mural/1785759396834-148tgv.jpeg')] bg-cover bg-center bg-no-repeat px-6 py-8 text-center font-sans">
22
+ <div className="mt-60 flex flex-col items-center">
23
+ <h1 className="m-0 bg-[linear-gradient(135deg,#a5b4fc_0%,#38bdf8_100%)] bg-clip-text text-[clamp(2.5rem,6vw,4.5rem)] font-extrabold tracking-[-0.02em] text-transparent">
24
+ Codeverse
25
+ </h1>
26
+ <p className="mt-1 text-[clamp(1rem,2.5vw,1.4rem)] font-normal tracking-[0.15em] text-slate-300 uppercase">
27
+ Explore. Aprenda. Colabore.
28
+ </p>
29
+
30
+ <a
31
+ href="https://codeverse.dev.br"
32
+ target="_blank"
33
+ rel="noopener noreferrer"
34
+ className="mt-4 inline-flex items-center gap-[0.6rem] rounded-full bg-[linear-gradient(135deg,#a5b4fc_0%,#38bdf8_100%)] px-9 py-[0.85rem] font-bold text-[#0a0f1e] no-underline transition-[transform,box-shadow] duration-200 ease-in-out hover:-translate-y-0.5 hover:shadow-[0_10px_30px_rgba(56,189,248,0.35)]">
35
+ <svg
36
+ className="h-[25px] w-[25px] animate-[spin_6s_linear_infinite]"
37
+ viewBox="-11.5 -10.23174 23 20.46348"
38
+ width="25"
39
+ height="25"
40
+ aria-hidden="true">
41
+ <circle r="2.05" fill="currentColor" />
42
+ <g stroke="currentColor" strokeWidth="1" fill="none">
43
+ <ellipse rx="11" ry="4.2" />
44
+ <ellipse rx="11" ry="4.2" transform="rotate(60)" />
45
+ <ellipse rx="11" ry="4.2" transform="rotate(120)" />
46
+ </g>
47
+ </svg>
48
+ Ver material tutorial
49
+ </a>
50
+
51
+ <p className="mt-4 text-[0.85rem] tracking-[0.1em] text-slate-400 uppercase">
52
+ Scaffolding oficial - Codeverse
53
+ </p>
54
+ </div>
55
+
56
+ <footer className="text-[0.85rem] text-slate-400/60">
57
+ <p>Pouco pra quem vê..., muito pra quem aprende.</p>
58
+ </footer>
59
+ </main>
60
+ );
61
+ }
62
+ `;
63
+
64
+ const GLOBALS_IMPORT_RE = /import '\.\/globals\.css';\r?\n/;
65
+ const BODY_MARKER = '<body>{children}</body>';
66
+
67
+ // CSS modules que o Tailwind substitui. Só são removidos com Tailwind; sem ele,
68
+ // ficam todos no projeto.
69
+ const MODULE_CSS_TO_REMOVE = [
70
+ ['src', 'app', 'page.module.css'],
71
+ ['src', 'app', 'nome-da-rota', 'nome-da-rota.module.css'],
72
+ ['src', 'components', 'Nome-do-componente.module.css'],
73
+ ];
74
+
75
+ async function applyTailwind(projectDir) {
76
+ await writeFile(join(projectDir, 'postcss.config.mjs'), POSTCSS_CONFIG, 'utf8');
77
+
78
+ await writeFile(join(projectDir, 'src', 'app', 'globals.css'), TAILWIND_GLOBALS, 'utf8');
79
+ await writeFile(join(projectDir, 'src', 'app', 'page.jsx'), TAILWIND_PAGE, 'utf8');
80
+
81
+ for (const parts of MODULE_CSS_TO_REMOVE) {
82
+ await rm(join(projectDir, ...parts), { force: true });
83
+ }
84
+ }
85
+
86
+ async function applyLayoutIntegrations(projectDir, { antd, toast, tailwind }) {
87
+ if (!antd && !toast && !tailwind) return;
88
+
89
+ const layoutPath = join(projectDir, 'src', 'app', 'layout.js');
90
+ let content = await readFile(layoutPath, 'utf8');
91
+
92
+ const imports = [];
93
+ if (antd) imports.push("import { AntdRegistry } from '@ant-design/nextjs-registry';");
94
+ if (toast) imports.push("import { Toaster } from 'react-hot-toast';");
95
+ if (imports.length > 0) {
96
+ content = content.replace(GLOBALS_IMPORT_RE, (match) => {
97
+ const eol = match.endsWith('\r\n') ? '\r\n' : '\n';
98
+ return `${match}${imports.join(eol)}${eol}`;
99
+ });
100
+ }
101
+
102
+ const children = antd ? '<AntdRegistry>{children}</AntdRegistry>' : '{children}';
103
+ const toaster = toast ? '\n <Toaster />' : '';
104
+ const body = `\n ${children}${toaster}\n `;
105
+
106
+ const bodyOpenTag = tailwind ? '<body className="min-h-screen antialiased">' : '<body>';
107
+ content = content.replace(BODY_MARKER, `${bodyOpenTag}${body}</body>`);
108
+
109
+ await writeFile(layoutPath, content, 'utf8');
110
+ }
111
+
112
+ // Alterações no código do template FrontEnd conforme os extras marcados.
113
+ export async function applyFront(projectDir, optionIds) {
114
+ const selected = {
115
+ antd: optionIds.includes('antd'),
116
+ toast: optionIds.includes('toast'),
117
+ tailwind: optionIds.includes('tailwind'),
118
+ };
119
+
120
+ if (selected.tailwind) await applyTailwind(projectDir);
121
+ await applyLayoutIntegrations(projectDir, selected);
122
+ }
@@ -0,0 +1,73 @@
1
+ import { appendFile, cp, readFile, rm, writeFile } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+
4
+ import { TEMPLATES_DIR } from '../paths.js';
5
+
6
+ const EXTRA_DIR = join(TEMPLATES_DIR, 'extras', 'test-dependencias');
7
+ const COMPONENTES_DIR = join(TEMPLATES_DIR, 'extras', 'test-componentes');
8
+
9
+ const COMPONENTES_DESCRIPTION =
10
+ 'Projeto template didático de testes de componentes com Next.js (App Router) e Cypress.';
11
+
12
+ const COMPONENTES_KEYWORDS = [
13
+ 'javascript',
14
+ 'nextjs',
15
+ 'app-router',
16
+ 'cypress',
17
+ 'testes',
18
+ 'testes-de-componentes',
19
+ 'component-testing',
20
+ 'biome',
21
+ 'codeverse',
22
+ ];
23
+
24
+ // Mesmo script do templates/integracao/package.template.json. O `rem` é o
25
+ // comentário do cmd: roda sem mostrar nada (o package.json não aceita comentários).
26
+ const CYPRESS_CLEAN_SCRIPT =
27
+ 'cls && npx cypress cache prune && rem Apaga do PC as versões antigas do programa Cypress, cerca de 200 MB cada, e mantém só a usada neste projeto';
28
+
29
+ const CYPRESS_GITIGNORE = `
30
+ # Gerados pelo Cypress ao rodar os testes
31
+ cypress/screenshots/
32
+ cypress/videos/
33
+ cypress/downloads/
34
+ `;
35
+
36
+ // Opção "Dependências": troca o arquivo de testes do projeto por exemplos de
37
+ // mock (jest.fn). Os arquivos com o mesmo nome são sobrescritos.
38
+ export async function applyTestDependencias(projectDir) {
39
+ await cp(EXTRA_DIR, projectDir, { recursive: true });
40
+ }
41
+
42
+ // Arquivos e pastas do template FrontEnd que não fazem parte do Component Testing.
43
+ const COMPONENTES_TO_REMOVE = [
44
+ ['.env.example'],
45
+ ['src', 'app', 'page.module.css'],
46
+ ['src', 'app', 'nome-da-rota'],
47
+ ['src', 'components', 'Nome-do-componente.jsx'],
48
+ ['src', 'components', 'Nome-do-componente.module.css'],
49
+ ['public', 'fonts'],
50
+ ['public', 'icons'],
51
+ ['public', 'images'],
52
+ ['public', 'media'],
53
+ ['public', 'sounds'],
54
+ ];
55
+
56
+ // Opção "Component Testing": parte do template FrontEnd e acrescenta o Cypress.
57
+ // O page.jsx passa a mostrar só o componente Login (teste em cypress/component/Login.cy.jsx).
58
+ // O package.json já gerado ganha os scripts de teste e de limpeza do cache do Cypress
59
+ // e a descrição própria (se o aluno digitar uma, ela substitui esta depois).
60
+ export async function applyTestComponentes(projectDir) {
61
+ await cp(COMPONENTES_DIR, projectDir, { recursive: true });
62
+ for (const parts of COMPONENTES_TO_REMOVE) {
63
+ await rm(join(projectDir, ...parts), { recursive: true, force: true });
64
+ }
65
+ await appendFile(join(projectDir, '.gitignore'), CYPRESS_GITIGNORE, 'utf8');
66
+
67
+ const pkgPath = join(projectDir, 'package.json');
68
+ const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
69
+ pkg.description = COMPONENTES_DESCRIPTION;
70
+ pkg.keywords = COMPONENTES_KEYWORDS;
71
+ pkg.scripts = { ...pkg.scripts, test: 'cls && cypress open', clean: CYPRESS_CLEAN_SCRIPT };
72
+ await writeFile(pkgPath, `${JSON.stringify(pkg, null, 4)}\n`, 'utf8');
73
+ }
@@ -0,0 +1,73 @@
1
+ import { cp, mkdir, rename, stat, writeFile } from 'node:fs/promises';
2
+ import { basename, dirname, join, relative, resolve, sep } from 'node:path';
3
+
4
+ import { TEMPLATES_DIR } from './paths.js';
5
+
6
+ // Nunca copiados para o projeto do aluno.
7
+ const SKIP = new Set(['node_modules', '.next', 'package-lock.json']);
8
+
9
+ async function pathExists(target) {
10
+ try {
11
+ await stat(target);
12
+ return true;
13
+ } catch (err) {
14
+ if (err.code === 'ENOENT') return false;
15
+ throw err;
16
+ }
17
+ }
18
+
19
+ async function assertNotExists(destDir) {
20
+ if (await pathExists(destDir)) {
21
+ throw new Error(`A pasta "${destDir}" já existe. Escolha outro nome de projeto ou remova a pasta existente.`);
22
+ }
23
+ }
24
+
25
+ // "gitkeep" só existe para as pastas vazias sobreviverem ao publish do npm;
26
+ // a pasta é criada, mas sem o arquivo marcador dentro.
27
+ const isGitkeep = (path) => basename(path) === 'gitkeep';
28
+
29
+ // O npm remove arquivos chamados ".gitignore" no publish, então o template
30
+ // guarda "_gitignore" e ele volta ao nome certo aqui.
31
+ async function restoreGitignore(destDir) {
32
+ try {
33
+ await rename(join(destDir, '_gitignore'), join(destDir, '.gitignore'));
34
+ } catch (err) {
35
+ if (err.code !== 'ENOENT') throw err;
36
+ }
37
+ }
38
+
39
+ export async function copyTemplate(templateId, destDir) {
40
+ await assertNotExists(destDir);
41
+
42
+ const sourceDir = join(TEMPLATES_DIR, templateId);
43
+
44
+ await cp(sourceDir, destDir, {
45
+ recursive: true,
46
+ filter(source) {
47
+ const rel = relative(sourceDir, source);
48
+ if (rel === '') return true;
49
+ if (isGitkeep(source)) return false;
50
+ return !SKIP.has(rel.split(sep)[0]);
51
+ },
52
+ });
53
+
54
+ await restoreGitignore(destDir);
55
+ }
56
+
57
+ // Grava os arquivos do template secreto (já abertos com o código certo).
58
+ // files: [{ path: 'src/index.js', data: Buffer }]
59
+ export async function writeSecretTemplate(files, destDir) {
60
+ await assertNotExists(destDir);
61
+ const root = resolve(destDir);
62
+
63
+ for (const { path, data } of files) {
64
+ const target = resolve(root, path);
65
+ if (target !== root && !target.startsWith(root + sep)) {
66
+ throw new Error(`Caminho inválido no template secreto: ${path}`);
67
+ }
68
+ await mkdir(dirname(target), { recursive: true });
69
+ if (!isGitkeep(target)) await writeFile(target, data);
70
+ }
71
+
72
+ await restoreGitignore(destDir);
73
+ }
package/lib/desktop.js ADDED
@@ -0,0 +1,65 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { mkdir } from 'node:fs/promises';
3
+ import { homedir } from 'node:os';
4
+ import { join } from 'node:path';
5
+
6
+ // Pergunta ao Windows onde fica a Área de Trabalho de verdade. Ela pode ter sido
7
+ // movida (ex.: OneDrive: %USERPROFILE%\OneDrive\Área de Trabalho). A saída sai em
8
+ // UTF-8 para não estragar nomes com acento.
9
+ const DESKTOP_COMMAND =
10
+ "[Console]::OutputEncoding=[Text.Encoding]::UTF8; [Environment]::GetFolderPath('Desktop')";
11
+
12
+ // O PowerShell roda `detached` (sem console): ligado ao mesmo terminal, ao terminar
13
+ // ele restaura o modo do teclado do console e os menus do clack param de receber
14
+ // as teclas (ex.: o multiselect dos extras "trava"). A saída vem pelo pipe.
15
+ function askWindowsDesktop() {
16
+ if (process.platform !== 'win32') return Promise.resolve(null);
17
+ return new Promise((resolve) => {
18
+ let stdout = '';
19
+ let child;
20
+ try {
21
+ child = spawn('powershell', ['-NoProfile', '-NonInteractive', '-Command', DESKTOP_COMMAND], {
22
+ detached: true,
23
+ windowsHide: true,
24
+ stdio: ['ignore', 'pipe', 'ignore'],
25
+ });
26
+ } catch {
27
+ resolve(null);
28
+ return;
29
+ }
30
+ const timer = setTimeout(() => {
31
+ child.kill();
32
+ resolve(null);
33
+ }, 5000);
34
+ child.stdout.setEncoding('utf8');
35
+ child.stdout.on('data', (chunk) => {
36
+ stdout += chunk;
37
+ });
38
+ child.on('error', () => {
39
+ clearTimeout(timer);
40
+ resolve(null);
41
+ });
42
+ child.on('close', (code) => {
43
+ clearTimeout(timer);
44
+ resolve(code === 0 ? stdout.trim() || null : null);
45
+ });
46
+ });
47
+ }
48
+
49
+ let lookup = null;
50
+
51
+ // O PowerShell leva um pouco para abrir, então a consulta começa logo no início
52
+ // do CLI e roda enquanto o aluno responde o menu.
53
+ export function startDesktopLookup() {
54
+ lookup ??= askWindowsDesktop();
55
+ }
56
+
57
+ // Pasta onde os projetos são criados: sempre a Área de Trabalho do Windows (a
58
+ // real, inclusive no OneDrive), independente de onde o comando rodou. Se não der
59
+ // para descobrir, usa %USERPROFILE%\Desktop. A pasta é criada se não existir.
60
+ export async function getDesktopDir() {
61
+ startDesktopLookup();
62
+ const desktop = (await lookup) ?? join(homedir(), 'Desktop');
63
+ await mkdir(desktop, { recursive: true });
64
+ return desktop;
65
+ }