create-codeverse 0.0.1 → 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.
- package/LICENSE +21 -0
- package/ReadMe.MD +484 -457
- package/bin/cli.js +160 -94
- package/lib/apply/front.js +122 -122
- package/lib/apply/test.js +8 -2
- package/lib/desktop.js +61 -9
- package/lib/installDependencies.js +96 -37
- package/lib/openInEditor.js +14 -14
- package/lib/packageJson.js +33 -19
- package/lib/paths.js +4 -4
- package/lib/prompts.js +147 -68
- package/lib/runCommand.js +44 -40
- package/lib/templates.js +25 -7
- package/lib/validateProjectName.js +24 -24
- package/lib/versions.js +110 -50
- package/package.json +5 -2
- package/templates/codeskills.enc +0 -0
- package/templates/extras/test-componentes/ReadMe.MD +44 -0
- package/templates/front/ReadMe.MD +51 -36
- package/templates/front/biome.json +42 -42
- package/templates/front/next.config.mjs +11 -11
- package/templates/integracao/ReadMe.MD +41 -0
- package/templates/integracao/package.template.json +2 -1
- package/templates/test/ReadMe.MD +49 -0
- package/templates/versions.json +84 -81
package/lib/desktop.js
CHANGED
|
@@ -1,13 +1,65 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { spawn } from 'node:child_process';
|
|
2
|
+
import { mkdir } from 'node:fs/promises';
|
|
2
3
|
import { homedir } from 'node:os';
|
|
3
4
|
import { join } from 'node:path';
|
|
4
5
|
|
|
5
|
-
//
|
|
6
|
-
//
|
|
7
|
-
//
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
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;
|
|
13
65
|
}
|
|
@@ -1,37 +1,96 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
//
|
|
6
|
-
//
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
1
|
+
import { spawnSync } from 'node:child_process';
|
|
2
|
+
|
|
3
|
+
import { runCommand } from './runCommand.js';
|
|
4
|
+
|
|
5
|
+
// Comandos npm que deixam o projeto completo, na ordem em que rodam. Normalmente
|
|
6
|
+
// é só o 1º, porque o CLI já troca os "latest" por ^X.Y.Z (pinLatestVersions);
|
|
7
|
+
// o 2º e o 3º só aparecem se o registry não puder ser consultado:
|
|
8
|
+
// 1. `npm install` se há pacotes com versão fixada no package.json
|
|
9
|
+
// 2. `npm install a@latest` pacotes com "latest" (o npm grava ^X.Y.Z sozinho)
|
|
10
|
+
// 3. `npm install -D b@latest` idem, para devDependencies
|
|
11
|
+
export function buildInstallCommands({ pinned, latest }) {
|
|
12
|
+
const commands = [];
|
|
13
|
+
|
|
14
|
+
const hasPinned = Object.keys(pinned.dependencies).length + Object.keys(pinned.devDependencies).length > 0;
|
|
15
|
+
if (hasPinned) commands.push(['install']);
|
|
16
|
+
|
|
17
|
+
if (latest.dependencies.length > 0) {
|
|
18
|
+
commands.push(['install', ...latest.dependencies.map((name) => `${name}@latest`)]);
|
|
19
|
+
}
|
|
20
|
+
if (latest.devDependencies.length > 0) {
|
|
21
|
+
commands.push(['install', '-D', ...latest.devDependencies.map((name) => `${name}@latest`)]);
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
return commands;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export const formatCommand = (args) => `npm ${args.join(' ')}`;
|
|
28
|
+
|
|
29
|
+
// Sem audit e fund: menos chamadas de rede durante a instalação.
|
|
30
|
+
const QUIET_FLAGS = ['--no-audit', '--no-fund'];
|
|
31
|
+
|
|
32
|
+
// `--prefer-offline` usa o cache do npm do PC sem conferir de novo no registry;
|
|
33
|
+
// só vai à internet o que não estiver no cache. Se falhar (ex.: cache antigo sem
|
|
34
|
+
// a versão pedida), o mesmo comando roda de novo sem ele, buscando na internet
|
|
35
|
+
// (a não ser que a instalação tenha sido cancelada).
|
|
36
|
+
async function npmInstall(args, cwd, control) {
|
|
37
|
+
try {
|
|
38
|
+
await runCommand('npm', [...args, '--prefer-offline', ...QUIET_FLAGS], {
|
|
39
|
+
cwd,
|
|
40
|
+
onSpawn: control.onSpawn,
|
|
41
|
+
});
|
|
42
|
+
} catch (err) {
|
|
43
|
+
if (control.isCancelled()) throw err;
|
|
44
|
+
await runCommand('npm', [...args, ...QUIET_FLAGS], { cwd, onSpawn: control.onSpawn });
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
const noControl = { onSpawn: undefined, isCancelled: () => false };
|
|
49
|
+
|
|
50
|
+
// Roda os comandos em sequência. Se um falhar, o erro carrega em `pending` os
|
|
51
|
+
// comandos que ainda faltavam (o que falhou e os seguintes), para o aluno
|
|
52
|
+
// poder terminar a instalação manualmente.
|
|
53
|
+
export async function installDependencies(projectDir, commands, control = noControl) {
|
|
54
|
+
for (const [index, args] of commands.entries()) {
|
|
55
|
+
try {
|
|
56
|
+
if (control.isCancelled()) throw new Error('Instalação cancelada.');
|
|
57
|
+
await npmInstall(args, projectDir, control);
|
|
58
|
+
} catch (err) {
|
|
59
|
+
err.pending = commands.slice(index);
|
|
60
|
+
throw err;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
// Encerra o npm e tudo o que ele abriu. No Windows o npm roda dentro de um shell
|
|
66
|
+
// (ver runCommand), então só o `taskkill /T` alcança os processos filhos.
|
|
67
|
+
function killTree(child) {
|
|
68
|
+
if (!child?.pid || child.exitCode !== null) return;
|
|
69
|
+
if (process.platform === 'win32') {
|
|
70
|
+
spawnSync('taskkill', ['/pid', String(child.pid), '/T', '/F'], { stdio: 'ignore' });
|
|
71
|
+
} else {
|
|
72
|
+
child.kill();
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
// Começa a instalação em segundo plano (enquanto o aluno responde as últimas
|
|
77
|
+
// perguntas). `done` termina como `installDependencies` (com `err.pending` se
|
|
78
|
+
// falhar); `cancel()` para o npm em andamento e impede novas tentativas.
|
|
79
|
+
export function startInstall(projectDir, commands) {
|
|
80
|
+
let current = null;
|
|
81
|
+
let cancelled = false;
|
|
82
|
+
const done = installDependencies(projectDir, commands, {
|
|
83
|
+
onSpawn: (child) => {
|
|
84
|
+
current = child;
|
|
85
|
+
},
|
|
86
|
+
isCancelled: () => cancelled,
|
|
87
|
+
});
|
|
88
|
+
done.catch(() => {}); // o erro é tratado quando o CLI aguardar `done`
|
|
89
|
+
return {
|
|
90
|
+
done,
|
|
91
|
+
cancel() {
|
|
92
|
+
cancelled = true;
|
|
93
|
+
killTree(current);
|
|
94
|
+
},
|
|
95
|
+
};
|
|
96
|
+
}
|
package/lib/openInEditor.js
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
|
-
import { runCommand } from './runCommand.js';
|
|
2
|
-
|
|
3
|
-
// O VS Code define TERM_PROGRAM=vscode nos seus terminais integrados.
|
|
4
|
-
export const isInsideVsCode = () => process.env.TERM_PROGRAM === 'vscode';
|
|
5
|
-
|
|
6
|
-
// Abre a pasta no VS Code. Devolve false se o comando `code` não existir.
|
|
7
|
-
// `reuseWindow` (`code -r`) troca a pasta da janela atual em vez de abrir outra;
|
|
8
|
-
// o terminal integrado dessa janela é encerrado na troca.
|
|
9
|
-
export function openInEditor(projectDir, { reuseWindow = false } = {}) {
|
|
10
|
-
const args = reuseWindow ? ['-r', '.'] : ['.'];
|
|
11
|
-
return runCommand('code', args, { cwd: projectDir, capture: false })
|
|
12
|
-
.then(() => true)
|
|
13
|
-
.catch(() => false);
|
|
14
|
-
}
|
|
1
|
+
import { runCommand } from './runCommand.js';
|
|
2
|
+
|
|
3
|
+
// O VS Code define TERM_PROGRAM=vscode nos seus terminais integrados.
|
|
4
|
+
export const isInsideVsCode = () => process.env.TERM_PROGRAM === 'vscode';
|
|
5
|
+
|
|
6
|
+
// Abre a pasta no VS Code. Devolve false se o comando `code` não existir.
|
|
7
|
+
// `reuseWindow` (`code -r`) troca a pasta da janela atual em vez de abrir outra;
|
|
8
|
+
// o terminal integrado dessa janela é encerrado na troca.
|
|
9
|
+
export function openInEditor(projectDir, { reuseWindow = false } = {}) {
|
|
10
|
+
const args = reuseWindow ? ['-r', '.'] : ['.'];
|
|
11
|
+
return runCommand('code', args, { cwd: projectDir, capture: false })
|
|
12
|
+
.then(() => true)
|
|
13
|
+
.catch(() => false);
|
|
14
|
+
}
|
package/lib/packageJson.js
CHANGED
|
@@ -1,19 +1,33 @@
|
|
|
1
|
-
import { readFile, rm, writeFile } from 'node:fs/promises';
|
|
2
|
-
import { join } from 'node:path';
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
//
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
pkg
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
await
|
|
19
|
-
|
|
1
|
+
import { readFile, rm, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
|
|
4
|
+
const save = (file, pkg) => writeFile(file, `${JSON.stringify(pkg, null, 4)}\n`, 'utf8');
|
|
5
|
+
|
|
6
|
+
// Transforma o package.template.json do projeto copiado em package.json: aplica
|
|
7
|
+
// o nome do projeto e as dependências com versão fixada (o suficiente para o
|
|
8
|
+
// `npm install` começar). Só mexe no package.json do projeto do aluno, nunca no do CLI.
|
|
9
|
+
export async function writePackageJson(projectDir, { projectName }, pinned) {
|
|
10
|
+
const templateFile = join(projectDir, 'package.template.json');
|
|
11
|
+
const pkg = JSON.parse(await readFile(templateFile, 'utf8'));
|
|
12
|
+
|
|
13
|
+
pkg.name = projectName;
|
|
14
|
+
for (const group of ['dependencies', 'devDependencies']) {
|
|
15
|
+
if (Object.keys(pinned[group]).length > 0) pkg[group] = pinned[group];
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
await save(join(projectDir, 'package.json'), pkg);
|
|
19
|
+
await rm(templateFile);
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
// Grava as respostas dadas enquanto o `npm install` rodava: a descrição (só se o
|
|
23
|
+
// aluno digitou uma; senão fica a do template) e o autor (nome do DEV). Roda
|
|
24
|
+
// depois do install, para não disputar o package.json com o npm.
|
|
25
|
+
export async function setPackageInfo(projectDir, { description, devName }) {
|
|
26
|
+
const file = join(projectDir, 'package.json');
|
|
27
|
+
const pkg = JSON.parse(await readFile(file, 'utf8'));
|
|
28
|
+
|
|
29
|
+
if (description) pkg.description = description;
|
|
30
|
+
pkg.author = { name: devName };
|
|
31
|
+
|
|
32
|
+
await save(file, pkg);
|
|
33
|
+
}
|
package/lib/paths.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { fileURLToPath } from 'node:url';
|
|
2
|
-
|
|
3
|
-
// Pasta `templates/` dentro do pacote (funciona igual local, com npm link e publicado).
|
|
4
|
-
export const TEMPLATES_DIR = fileURLToPath(new URL('../templates/', import.meta.url));
|
|
1
|
+
import { fileURLToPath } from 'node:url';
|
|
2
|
+
|
|
3
|
+
// Pasta `templates/` dentro do pacote (funciona igual local, com npm link e publicado).
|
|
4
|
+
export const TEMPLATES_DIR = fileURLToPath(new URL('../templates/', import.meta.url));
|
package/lib/prompts.js
CHANGED
|
@@ -1,68 +1,147 @@
|
|
|
1
|
-
import { setTimeout } from 'node:timers/promises';
|
|
2
|
-
import { styleText } from 'node:util';
|
|
3
|
-
|
|
4
|
-
import { cancel, isCancel, spinner, updateSettings } from '@clack/prompts';
|
|
5
|
-
|
|
6
|
-
// Traduz os textos internos do clack que aceitam configuração. As instruções
|
|
7
|
-
// de teclado (↑/↓, Enter) são fixas em inglês, por isso os menus usam
|
|
8
|
-
// `showInstructions: false`.
|
|
9
|
-
export function configurePrompts() {
|
|
10
|
-
updateSettings({
|
|
11
|
-
messages: {
|
|
12
|
-
cancel: 'Operação cancelada. 😢',
|
|
13
|
-
error: 'Algo deu errado. 😢',
|
|
14
|
-
},
|
|
15
|
-
});
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
// Troca a linha de resposta que o clack acabou de escrever (a última, "│ ...").
|
|
19
|
-
// Chamada logo depois da resposta: sobe uma linha, pula a barra e os 2 espaços
|
|
20
|
-
// (3 colunas), apaga até o fim da linha e escreve `text`. `previous` é o texto
|
|
21
|
-
// que o clack escreveu: se ele não coube numa linha do terminal, não mexe (subir
|
|
22
|
-
// uma linha só apagaria parte dele). É só cosmético: se a saída não for um
|
|
23
|
-
// terminal ou algo falhar, a linha original do clack continua e o fluxo segue.
|
|
24
|
-
export function replaceAnswerLine(text, previous, output = process.stdout) {
|
|
25
|
-
try {
|
|
26
|
-
if (!output.isTTY) return;
|
|
27
|
-
if (output.columns && previous.length + 3 > output.columns) return;
|
|
28
|
-
output.write(`\x1b[1A\r\x1b[3C\x1b[0K${styleText('dim', text)}\n`);
|
|
29
|
-
} catch {
|
|
30
|
-
// mantém a linha original
|
|
31
|
-
}
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
// Opções de select/multiselect com os hints alinhados. O clack escreve
|
|
35
|
-
// "label (hint)" só na opção com o cursor, então os labels são completados com
|
|
36
|
-
// espaços até o maior deles e o "(" fica sempre na mesma coluna. Só `ready: false`
|
|
37
|
-
// ganha o "em breve" (os extras não têm `ready`). No multiselect, o resumo junta
|
|
38
|
-
// os labels com vírgula e os espaços aparecem: corrigir com `replaceAnswerLine`.
|
|
39
|
-
export function alignedOptions(items) {
|
|
40
|
-
const width = Math.max(...items.map(({ label }) => label.length));
|
|
41
|
-
return items.map(({ id, label, hint, ready }) => ({
|
|
42
|
-
value: id,
|
|
43
|
-
label: label.padEnd(width),
|
|
44
|
-
hint: ready === false ? `${hint} · em breve` : hint,
|
|
45
|
-
}));
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
// Spinner com contagem regressiva ("<message> em 3s...", 2s, 1s) que termina
|
|
49
|
-
// com `message`. Serve para dar tempo de o aluno ler antes de uma ação.
|
|
50
|
-
export async function countdown(message, seconds) {
|
|
51
|
-
const wait =
|
|
52
|
-
wait.start(`${message} em ${seconds}s...`);
|
|
53
|
-
for (let left = seconds; left > 0; left--) {
|
|
54
|
-
wait.message(`${message} em ${left}s...`);
|
|
55
|
-
await setTimeout(1000);
|
|
56
|
-
}
|
|
57
|
-
wait.stop(message);
|
|
58
|
-
}
|
|
59
|
-
|
|
60
|
-
//
|
|
61
|
-
//
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
1
|
+
import { setTimeout } from 'node:timers/promises';
|
|
2
|
+
import { styleText } from 'node:util';
|
|
3
|
+
|
|
4
|
+
import { cancel, isCancel, spinner, updateSettings } from '@clack/prompts';
|
|
5
|
+
|
|
6
|
+
// Traduz os textos internos do clack que aceitam configuração. As instruções
|
|
7
|
+
// de teclado (↑/↓, Enter) são fixas em inglês, por isso os menus usam
|
|
8
|
+
// `showInstructions: false`.
|
|
9
|
+
export function configurePrompts() {
|
|
10
|
+
updateSettings({
|
|
11
|
+
messages: {
|
|
12
|
+
cancel: 'Operação cancelada. 😢',
|
|
13
|
+
error: 'Algo deu errado. 😢',
|
|
14
|
+
},
|
|
15
|
+
});
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
// Troca a linha de resposta que o clack acabou de escrever (a última, "│ ...").
|
|
19
|
+
// Chamada logo depois da resposta: sobe uma linha, pula a barra e os 2 espaços
|
|
20
|
+
// (3 colunas), apaga até o fim da linha e escreve `text`. `previous` é o texto
|
|
21
|
+
// que o clack escreveu: se ele não coube numa linha do terminal, não mexe (subir
|
|
22
|
+
// uma linha só apagaria parte dele). É só cosmético: se a saída não for um
|
|
23
|
+
// terminal ou algo falhar, a linha original do clack continua e o fluxo segue.
|
|
24
|
+
export function replaceAnswerLine(text, previous, output = process.stdout) {
|
|
25
|
+
try {
|
|
26
|
+
if (!output.isTTY) return;
|
|
27
|
+
if (output.columns && previous.length + 3 > output.columns) return;
|
|
28
|
+
output.write(`\x1b[1A\r\x1b[3C\x1b[0K${styleText('dim', text)}\n`);
|
|
29
|
+
} catch {
|
|
30
|
+
// mantém a linha original
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
// Opções de select/multiselect com os hints alinhados. O clack escreve
|
|
35
|
+
// "label (hint)" só na opção com o cursor, então os labels são completados com
|
|
36
|
+
// espaços até o maior deles e o "(" fica sempre na mesma coluna. Só `ready: false`
|
|
37
|
+
// ganha o "em breve" (os extras não têm `ready`). No multiselect, o resumo junta
|
|
38
|
+
// os labels com vírgula e os espaços aparecem: corrigir com `replaceAnswerLine`.
|
|
39
|
+
export function alignedOptions(items) {
|
|
40
|
+
const width = Math.max(...items.map(({ label }) => label.length));
|
|
41
|
+
return items.map(({ id, label, hint, ready }) => ({
|
|
42
|
+
value: id,
|
|
43
|
+
label: label.padEnd(width),
|
|
44
|
+
hint: ready === false ? `${hint} · em breve` : hint,
|
|
45
|
+
}));
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
// Spinner com contagem regressiva ("<message> em 3s...", 2s, 1s) que termina
|
|
49
|
+
// com `message`. Serve para dar tempo de o aluno ler antes de uma ação.
|
|
50
|
+
export async function countdown(message, seconds) {
|
|
51
|
+
const wait = cancellableSpinner();
|
|
52
|
+
wait.start(`${message} em ${seconds}s...`);
|
|
53
|
+
for (let left = seconds; left > 0; left--) {
|
|
54
|
+
wait.message(`${message} em ${left}s...`);
|
|
55
|
+
await setTimeout(1000);
|
|
56
|
+
}
|
|
57
|
+
wait.stop(message);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
// Pausa de `ms` para o aluno ler o terminal, com um spinner que some no fim.
|
|
61
|
+
// Enquanto gira, o próprio clack bloqueia o teclado: as teclas apertadas nesse
|
|
62
|
+
// tempo são descartadas e não sobram para o próximo menu (ex.: um Enter
|
|
63
|
+
// escolheria a 1ª opção na hora). Não mexer no stdin por conta própria
|
|
64
|
+
// (setRawMode/resume/pause): no Windows isso travava o 2º menu (os extras).
|
|
65
|
+
export async function readingPause(ms) {
|
|
66
|
+
const wait = cancellableSpinner();
|
|
67
|
+
wait.start('Carregando o menu');
|
|
68
|
+
await setTimeout(ms);
|
|
69
|
+
wait.clear();
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
const CANCEL_MESSAGE = 'Operação cancelada. 😢';
|
|
73
|
+
|
|
74
|
+
// Limpezas que rodam se o aluno cancelar (Ctrl+C), ex.: parar o npm e apagar a
|
|
75
|
+
// pasta do projeto já criada. Precisam ser síncronas (rodam antes do process.exit).
|
|
76
|
+
// Devolve uma função que remove a limpeza (quando ela não serve mais).
|
|
77
|
+
const cancelCleanups = new Set();
|
|
78
|
+
export function onCancel(cleanup) {
|
|
79
|
+
cancelCleanups.add(cleanup);
|
|
80
|
+
return () => cancelCleanups.delete(cleanup);
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
function runCleanups() {
|
|
84
|
+
for (const cleanup of cancelCleanups) {
|
|
85
|
+
try {
|
|
86
|
+
cleanup();
|
|
87
|
+
} catch {
|
|
88
|
+
// segue encerrando mesmo se uma limpeza falhar
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
cancelCleanups.clear();
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
// Roda as limpezas, mostra a mensagem de cancelamento e encerra com código 130.
|
|
95
|
+
// `showMessage: false` quando o spinner do clack já escreveu a mensagem.
|
|
96
|
+
function exitCancelled({ showMessage = true } = {}) {
|
|
97
|
+
activeSpinner = null;
|
|
98
|
+
runCleanups();
|
|
99
|
+
if (showMessage) cancel(CANCEL_MESSAGE);
|
|
100
|
+
process.exit(130);
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
// Enquanto um spinner gira, o clack bloqueia o teclado e o Ctrl+C chega como
|
|
104
|
+
// tecla: o clack encerra na hora (process.exit(0)), sem as nossas limpezas. Por
|
|
105
|
+
// isso, se o processo terminar com um spinner ainda ativo, foi um Ctrl+C: o
|
|
106
|
+
// spinner fecha como cancelado (■ vermelho), as limpezas rodam (parar o npm,
|
|
107
|
+
// apagar a pasta) e o código de saída vira 130.
|
|
108
|
+
let activeSpinner = null;
|
|
109
|
+
process.on('exit', () => {
|
|
110
|
+
if (!activeSpinner) return;
|
|
111
|
+
const current = activeSpinner;
|
|
112
|
+
activeSpinner = null;
|
|
113
|
+
current.cancel(CANCEL_MESSAGE);
|
|
114
|
+
runCleanups();
|
|
115
|
+
process.exitCode = 130;
|
|
116
|
+
});
|
|
117
|
+
|
|
118
|
+
// Spinner do clack que encerra o CLI no Ctrl+C (pelo teclado, acima, ou pelo
|
|
119
|
+
// sinal SIGINT, no `onCancel`). Sozinho, o spinner do clack não roda as limpezas.
|
|
120
|
+
export function cancellableSpinner() {
|
|
121
|
+
const inner = spinner({ onCancel: () => exitCancelled({ showMessage: false }) });
|
|
122
|
+
const finish = (method) => (message) => {
|
|
123
|
+
activeSpinner = null;
|
|
124
|
+
method(message);
|
|
125
|
+
};
|
|
126
|
+
return {
|
|
127
|
+
start(message) {
|
|
128
|
+
activeSpinner = inner;
|
|
129
|
+
inner.start(message);
|
|
130
|
+
},
|
|
131
|
+
message: (message) => inner.message(message),
|
|
132
|
+
stop: finish(inner.stop),
|
|
133
|
+
error: finish(inner.error),
|
|
134
|
+
cancel: finish(inner.cancel),
|
|
135
|
+
clear: () => {
|
|
136
|
+
activeSpinner = null;
|
|
137
|
+
inner.clear();
|
|
138
|
+
},
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
// Envolve qualquer resposta do clack: se o aluno cancelou (Ctrl+C), encerra
|
|
143
|
+
// com uma mensagem amigável; senão devolve o valor respondido.
|
|
144
|
+
export function exitIfCancel(value) {
|
|
145
|
+
if (isCancel(value)) exitCancelled();
|
|
146
|
+
return value;
|
|
147
|
+
}
|
package/lib/runCommand.js
CHANGED
|
@@ -1,40 +1,44 @@
|
|
|
1
|
-
import { spawn } from 'node:child_process';
|
|
2
|
-
|
|
3
|
-
const TAIL_LINES = 12;
|
|
4
|
-
|
|
5
|
-
// No Windows, comandos como npm e code são atalhos .cmd, que o spawn só
|
|
6
|
-
// consegue abrir por um shell. O comando vai como uma string única (sem array
|
|
7
|
-
// de argumentos, evitando o aviso DEP0190). Os argumentos vêm sempre de textos
|
|
8
|
-
// fixos do CLI e dos nomes de pacote do versions.json, nunca do que o aluno
|
|
9
|
-
// digita, então não há o que escapar.
|
|
10
|
-
//
|
|
11
|
-
// `capture: true` guarda a saída para mostrar o final dela se o comando falhar;
|
|
12
|
-
// `capture: false` descarta tudo (usado para abrir o VS Code, que não pode
|
|
13
|
-
// prender o CLI esperando a janela fechar).
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
child.on('
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
1
|
+
import { spawn } from 'node:child_process';
|
|
2
|
+
|
|
3
|
+
const TAIL_LINES = 12;
|
|
4
|
+
|
|
5
|
+
// No Windows, comandos como npm e code são atalhos .cmd, que o spawn só
|
|
6
|
+
// consegue abrir por um shell. O comando vai como uma string única (sem array
|
|
7
|
+
// de argumentos, evitando o aviso DEP0190). Os argumentos vêm sempre de textos
|
|
8
|
+
// fixos do CLI e dos nomes de pacote do versions.json, nunca do que o aluno
|
|
9
|
+
// digita, então não há o que escapar.
|
|
10
|
+
//
|
|
11
|
+
// `capture: true` guarda a saída para mostrar o final dela se o comando falhar;
|
|
12
|
+
// `capture: false` descarta tudo (usado para abrir o VS Code, que não pode
|
|
13
|
+
// prender o CLI esperando a janela fechar).
|
|
14
|
+
// `onSpawn(child)` recebe o processo criado (usado para encerrar o npm no Ctrl+C).
|
|
15
|
+
// Não usar `detached` aqui: no Windows, cada processo que o npm abrir ganharia uma
|
|
16
|
+
// janela de console própria (aparecem várias janelas na tela).
|
|
17
|
+
export function runCommand(command, args, { cwd, capture = true, onSpawn } = {}) {
|
|
18
|
+
return new Promise((resolve, reject) => {
|
|
19
|
+
const stdio = capture ? ['ignore', 'pipe', 'pipe'] : 'ignore';
|
|
20
|
+
const child =
|
|
21
|
+
process.platform === 'win32'
|
|
22
|
+
? spawn([command, ...args].join(' '), [], { cwd, stdio, shell: true, windowsHide: true })
|
|
23
|
+
: spawn(command, args, { cwd, stdio });
|
|
24
|
+
onSpawn?.(child);
|
|
25
|
+
|
|
26
|
+
let output = '';
|
|
27
|
+
child.stdout?.on('data', (chunk) => {
|
|
28
|
+
output += chunk;
|
|
29
|
+
});
|
|
30
|
+
child.stderr?.on('data', (chunk) => {
|
|
31
|
+
output += chunk;
|
|
32
|
+
});
|
|
33
|
+
|
|
34
|
+
child.on('error', reject);
|
|
35
|
+
child.on('close', (code) => {
|
|
36
|
+
if (code === 0) {
|
|
37
|
+
resolve(output);
|
|
38
|
+
return;
|
|
39
|
+
}
|
|
40
|
+
const tail = output.trim().split(/\r?\n/).slice(-TAIL_LINES).join('\n');
|
|
41
|
+
reject(new Error(`${[command, ...args].join(' ')} saiu com código ${code}.${tail ? `\n${tail}` : ''}`));
|
|
42
|
+
});
|
|
43
|
+
});
|
|
44
|
+
}
|