ts-vibe 2.2.0 → 2.5.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/README.md +239 -8
- package/config.json +13 -12
- package/index.js +33 -13
- package/languages/en.json +47 -7
- package/languages/ru.json +49 -9
- package/package.json +5 -6
- package/src/cmd.mjs +65 -41
- package/src/fs/dir.mjs +5 -9
- package/src/project/features.mjs +186 -0
- package/src/project/index.mjs +5 -133
- package/src/project/setup.mjs +169 -90
- package/src/project/transaction.mjs +185 -0
- package/src/ts.mjs +64 -27
- package/src/utils/cmd.mjs +84 -34
package/README.md
CHANGED
|
@@ -1,13 +1,244 @@
|
|
|
1
1
|
# ts-vibe
|
|
2
2
|
|
|
3
|
-
CLI
|
|
3
|
+
Интерактивный CLI для быстрого создания современных TypeScript-проектов под Node.js.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
`ts-vibe` настраивает структуру проекта, TypeScript, npm-скрипты и выбранные инструменты разработки. Интерфейс построен на [`@clack/prompts`](https://github.com/bombshell-dev/clack) и следует привычному сценарию `create-vite`.
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Возможности
|
|
8
8
|
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
-
|
|
9
|
+
- готовая рекомендуемая конфигурация;
|
|
10
|
+
- ручной выбор инструментов;
|
|
11
|
+
- поддержка ESM и CommonJS;
|
|
12
|
+
- типы Node.js;
|
|
13
|
+
- алиас `@/*` для каталога `src`;
|
|
14
|
+
- современный ESLint Flat Config;
|
|
15
|
+
- тестирование через Vitest;
|
|
16
|
+
- Prettier;
|
|
17
|
+
- README для создаваемого проекта;
|
|
18
|
+
- инициализация Git и создание первого коммита;
|
|
19
|
+
- русский и английский интерфейс;
|
|
20
|
+
- создание без установки зависимостей через `--skip-install`;
|
|
21
|
+
- безопасная работа с непустыми директориями;
|
|
22
|
+
- транзакционная генерация и автоматический rollback при ошибке.
|
|
23
|
+
|
|
24
|
+
## Требования
|
|
25
|
+
|
|
26
|
+
- Node.js 20.12 или новее;
|
|
27
|
+
- npm;
|
|
28
|
+
- Git (опционально).
|
|
29
|
+
|
|
30
|
+
## Запуск
|
|
31
|
+
|
|
32
|
+
Без глобальной установки:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
npx ts-vibe
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Или установите CLI глобально:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
npm install --global ts-vibe
|
|
42
|
+
ts-vibe
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Чтобы создать файлы проекта без запуска `npm install`:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
npx ts-vibe --skip-install
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
После генерации CLI покажет необходимые команды:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
cd my-project
|
|
55
|
+
npm install # только при использовании --skip-install
|
|
56
|
+
npm start
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Процесс создания проекта
|
|
60
|
+
|
|
61
|
+
CLI последовательно предложит:
|
|
62
|
+
|
|
63
|
+
1. Ввести имя проекта. Используйте `.` для текущей директории.
|
|
64
|
+
2. Выбрать поведение, если целевая папка не пуста.
|
|
65
|
+
3. Выбрать рекомендуемый или ручной режим настройки.
|
|
66
|
+
4. В ручном режиме выбрать возможности и систему модулей.
|
|
67
|
+
5. Проверить итоговую конфигурацию.
|
|
68
|
+
6. Подтвердить создание проекта.
|
|
69
|
+
|
|
70
|
+
До финального подтверждения `ts-vibe` не изменяет файловую систему.
|
|
71
|
+
|
|
72
|
+
## Режимы настройки
|
|
73
|
+
|
|
74
|
+
### Recommended
|
|
75
|
+
|
|
76
|
+
Рекомендуемый вариант создаёт ESM-проект и включает:
|
|
77
|
+
|
|
78
|
+
- Git;
|
|
79
|
+
- `README.md`;
|
|
80
|
+
- типы Node.js;
|
|
81
|
+
- алиас `@/*` → `src/*`.
|
|
82
|
+
|
|
83
|
+
### Custom
|
|
84
|
+
|
|
85
|
+
Ручной режим позволяет выбрать:
|
|
86
|
+
|
|
87
|
+
| Возможность | Что добавляется |
|
|
88
|
+
| --- | --- |
|
|
89
|
+
| Git | `.gitignore`, `.gitattributes` и Git-инициализация |
|
|
90
|
+
| README.md | Документация создаваемого проекта |
|
|
91
|
+
| Node.js types | `@types/node` и типы Node.js в `tsconfig.json` |
|
|
92
|
+
| `@/` path alias | Алиас `@/*` → `src/*` |
|
|
93
|
+
| ESLint | ESLint Flat Config для TypeScript |
|
|
94
|
+
| Vitest | Vitest, пример теста и команды запуска |
|
|
95
|
+
| Prettier | Конфигурация и npm-скрипт форматирования |
|
|
96
|
+
|
|
97
|
+
Также можно выбрать `module` или `commonjs`. ESM-проекты используют `NodeNext`, поэтому проверка типов, компиляция и запуск через Node.js следуют одним правилам разрешения модулей.
|
|
98
|
+
|
|
99
|
+
## Предпросмотр конфигурации
|
|
100
|
+
|
|
101
|
+
Перед генерацией CLI показывает:
|
|
102
|
+
|
|
103
|
+
- имя и абсолютный путь проекта;
|
|
104
|
+
- режим работы с целевой директорией;
|
|
105
|
+
- систему модулей;
|
|
106
|
+
- выбранные возможности;
|
|
107
|
+
- необходимость установки зависимостей;
|
|
108
|
+
- поведение Git;
|
|
109
|
+
- список создаваемых файлов.
|
|
110
|
+
|
|
111
|
+
Это позволяет проверить настройки до любых изменений на диске.
|
|
112
|
+
|
|
113
|
+
## Генерируемый проект
|
|
114
|
+
|
|
115
|
+
Базовая структура:
|
|
116
|
+
|
|
117
|
+
```text
|
|
118
|
+
my-project/
|
|
119
|
+
├── src/
|
|
120
|
+
│ └── index.ts
|
|
121
|
+
├── package.json
|
|
122
|
+
└── tsconfig.json
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
В зависимости от выбранных возможностей также могут быть созданы:
|
|
126
|
+
|
|
127
|
+
```text
|
|
128
|
+
├── .gitattributes
|
|
129
|
+
├── .gitignore
|
|
130
|
+
├── .prettierignore
|
|
131
|
+
├── .prettierrc
|
|
132
|
+
├── eslint.config.mjs
|
|
133
|
+
├── src/index.test.ts
|
|
134
|
+
└── README.md
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
### npm-скрипты
|
|
138
|
+
|
|
139
|
+
Каждый проект получает базовые команды:
|
|
140
|
+
|
|
141
|
+
| Команда | Назначение |
|
|
142
|
+
| --- | --- |
|
|
143
|
+
| `npm run dev` | Запустить проект через `tsx` в watch-режиме |
|
|
144
|
+
| `npm start` | Запустить `src/index.ts` один раз |
|
|
145
|
+
| `npm run check` | Проверить типы без создания JavaScript-файлов |
|
|
146
|
+
| `npm run build` | Скомпилировать TypeScript в `dist` |
|
|
147
|
+
| `npm run prod` | Запустить собранный `dist/index.js` |
|
|
148
|
+
| `npm run lint` | Проверить проект ESLint, если он выбран |
|
|
149
|
+
| `npm test` | Запустить Vitest в watch-режиме, если он выбран |
|
|
150
|
+
| `npm run test:run` | Выполнить тесты Vitest один раз |
|
|
151
|
+
| `npm run format` | Отформатировать проект, если выбран Prettier |
|
|
152
|
+
|
|
153
|
+
## ESLint
|
|
154
|
+
|
|
155
|
+
При выборе ESLint создаётся `eslint.config.mjs` на основе Flat Config и устанавливаются совместимые версии:
|
|
156
|
+
|
|
157
|
+
- `eslint`;
|
|
158
|
+
- `@eslint/js`;
|
|
159
|
+
- `typescript-eslint`;
|
|
160
|
+
- `eslint-config-prettier`;
|
|
161
|
+
- `globals`.
|
|
162
|
+
|
|
163
|
+
Игнорирование `dist` и `node_modules` настраивается непосредственно в Flat Config, поэтому отдельный `.eslintignore` не создаётся.
|
|
164
|
+
|
|
165
|
+
## Vitest
|
|
166
|
+
|
|
167
|
+
Vitest доступен в режиме `Custom` и не включается в рекомендуемый минимальный профиль. При выборе этой возможности создаётся `src/index.test.ts` с простым примером теста и добавляются команды:
|
|
168
|
+
|
|
169
|
+
```bash
|
|
170
|
+
npm test # интерактивный watch-режим
|
|
171
|
+
npm run test:run # однократный запуск
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
Используется Vitest 4, совместимый с минимальной поддерживаемой версией Node.js 20.12.
|
|
175
|
+
|
|
176
|
+
## Безопасность генерации
|
|
177
|
+
|
|
178
|
+
Проект сначала полностью подготавливается во временной staging-директории внутри ожидаемой целевой папки. Поэтому во время установки рядом не появляется каталог с техническим именем `.ts-vibe-stage-*`:
|
|
179
|
+
|
|
180
|
+
1. Создаются файлы.
|
|
181
|
+
2. При необходимости устанавливаются зависимости.
|
|
182
|
+
3. Инициализируется новый Git-репозиторий.
|
|
183
|
+
4. Готовый проект публикуется в целевую директорию.
|
|
184
|
+
|
|
185
|
+
Если создание или установка нового проекта завершается ошибкой, созданная целевая папка удаляется целиком. Для существующего проекта временные файлы удаляются, а исходное содержимое восстанавливается.
|
|
186
|
+
|
|
187
|
+
После успешной подготовки файлы публикуются из внутреннего staging-каталога. При объединении с существующей папкой используется журнал изменений и backup для rollback.
|
|
188
|
+
|
|
189
|
+
### Работа с Git
|
|
190
|
+
|
|
191
|
+
- Для нового самостоятельного проекта создаётся репозиторий и первый коммит.
|
|
192
|
+
- Внутри существующего Git-репозитория `ts-vibe` не создаёт вложенный репозиторий.
|
|
193
|
+
- В существующем репозитории CLI не выполняет автоматические `git add` и `git commit`, чтобы не захватить пользовательские изменения.
|
|
194
|
+
|
|
195
|
+
## Язык интерфейса
|
|
196
|
+
|
|
197
|
+
Язык выбирается автоматически на основе системной локали:
|
|
198
|
+
|
|
199
|
+
- `ru` — русский;
|
|
200
|
+
- остальные или неизвестные локали — английский.
|
|
201
|
+
|
|
202
|
+
## Разработка
|
|
203
|
+
|
|
204
|
+
Клонируйте репозиторий и установите зависимости:
|
|
205
|
+
|
|
206
|
+
```bash
|
|
207
|
+
git clone https://github.com/yar1kpr0grammer/ts-vibe.git
|
|
208
|
+
cd ts-vibe
|
|
209
|
+
npm install
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
Запуск CLI из исходного кода:
|
|
213
|
+
|
|
214
|
+
```bash
|
|
215
|
+
npm start
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
Запуск автоматических тестов:
|
|
219
|
+
|
|
220
|
+
```bash
|
|
221
|
+
npm test
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
Тесты проверяют:
|
|
225
|
+
|
|
226
|
+
- декларативный план ESLint;
|
|
227
|
+
- транзакционное создание нового проекта;
|
|
228
|
+
- режимы очистки и объединения;
|
|
229
|
+
- сохранение `.git`;
|
|
230
|
+
- rollback при ошибке установки;
|
|
231
|
+
- безопасную передачу аргументов без shell.
|
|
232
|
+
|
|
233
|
+
## Архитектура
|
|
234
|
+
|
|
235
|
+
Ключевые модули:
|
|
236
|
+
|
|
237
|
+
| Файл | Ответственность |
|
|
238
|
+
| --- | --- |
|
|
239
|
+
| `src/project/setup.mjs` | Интерактивный сбор настроек и предпросмотр |
|
|
240
|
+
| `src/project/features.mjs` | Декларативное описание возможностей |
|
|
241
|
+
| `src/project/transaction.mjs` | Staging, публикация и rollback |
|
|
242
|
+
| `src/cmd.mjs` | Безопасный запуск дочерних процессов |
|
|
243
|
+
| `src/utils/cmd.mjs` | Компоненты терминального интерфейса |
|
|
244
|
+
| `languages/` | Русская и английская локализации |
|
package/config.json
CHANGED
|
@@ -1,12 +1,13 @@
|
|
|
1
|
-
{
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"default_code": {
|
|
3
|
+
"indexTs": "const message: string = \"Hello, TypeScript!\";\nconsole.log(message);\n",
|
|
4
|
+
"eslintConfig": "import js from \"@eslint/js\";\nimport eslintConfigPrettier from \"eslint-config-prettier\";\nimport globals from \"globals\";\nimport tseslint from \"typescript-eslint\";\n\nexport default tseslint.config(\n {\n ignores: [\"dist/**\", \"node_modules/**\"],\n },\n js.configs.recommended,\n ...tseslint.configs.recommended,\n {\n files: [\"**/*.ts\"],\n languageOptions: {\n globals: globals.node,\n },\n },\n eslintConfigPrettier,\n);",
|
|
5
|
+
"vitestTest": "import { describe, expect, it } from \"vitest\";\n\ndescribe(\"TypeScript project\", () => {\n it(\"works\", () => {\n expect(2 + 2).toBe(4);\n });\n});\n",
|
|
6
|
+
"prettierrc": "{\n \"semi\": true,\n \"singleQuote\": true,\n \"printWidth\": 80\n}"
|
|
7
|
+
},
|
|
8
|
+
"ignores": {
|
|
9
|
+
"git": "node_modules\ndist\n.env\n.vscode\n.idea\n*.log\ncoverage",
|
|
10
|
+
"eslint": "node_modules\ndist",
|
|
11
|
+
"prettier": "node_modules\ndist"
|
|
12
|
+
}
|
|
13
|
+
}
|
package/index.js
CHANGED
|
@@ -1,22 +1,42 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
|
|
3
|
+
import { parseArgs } from "node:util";
|
|
4
|
+
|
|
3
5
|
import { init } from "./src/project/index.mjs";
|
|
4
6
|
import { setupProject } from "./src/project/setup.mjs";
|
|
5
|
-
import {
|
|
7
|
+
import { cancel, outro } from "./src/utils/cmd.mjs";
|
|
8
|
+
import colors from "picocolors";
|
|
9
|
+
|
|
10
|
+
function logInstructions(project) {
|
|
11
|
+
const { dir, install, language } = project;
|
|
12
|
+
const commands = [
|
|
13
|
+
dir === "." ? null : `cd ${dir}`,
|
|
14
|
+
install ? null : "npm install",
|
|
15
|
+
"npm start",
|
|
16
|
+
].filter(Boolean);
|
|
17
|
+
const nextSteps = commands
|
|
18
|
+
.map((command) => ` ${colors.cyan(command)}`)
|
|
19
|
+
.join("\n");
|
|
6
20
|
|
|
7
|
-
|
|
8
|
-
console.log("\n--------------\n");
|
|
9
|
-
if (dir !== ".") {
|
|
10
|
-
console.log(`cd ${name}`);
|
|
11
|
-
}
|
|
12
|
-
console.log(`npm start\n`);
|
|
13
|
-
console.log("--------------");
|
|
21
|
+
outro(`${language.done}\n\n${language.next_steps}\n${nextSteps}`);
|
|
14
22
|
}
|
|
15
23
|
|
|
16
24
|
async function main() {
|
|
17
|
-
const {
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
25
|
+
const { values } = parseArgs({
|
|
26
|
+
options: {
|
|
27
|
+
"skip-install": { type: "boolean", default: false },
|
|
28
|
+
},
|
|
29
|
+
strict: true,
|
|
30
|
+
});
|
|
31
|
+
const project = await setupProject({
|
|
32
|
+
skipInstall: values["skip-install"],
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
await init(project);
|
|
36
|
+
logInstructions(project);
|
|
21
37
|
}
|
|
22
|
-
|
|
38
|
+
|
|
39
|
+
main().catch((error) => {
|
|
40
|
+
cancel(error instanceof Error ? error.message : String(error));
|
|
41
|
+
process.exitCode = 1;
|
|
42
|
+
});
|
package/languages/en.json
CHANGED
|
@@ -1,18 +1,58 @@
|
|
|
1
1
|
{
|
|
2
|
+
"cli_title": "Create a TypeScript project",
|
|
2
3
|
"success": "Success",
|
|
3
4
|
"error": "Error",
|
|
4
5
|
"choose_node_type": "Choose Node type",
|
|
5
6
|
"update_ts_config": "Update tsconfig.json",
|
|
6
7
|
"update_package": "Update package.json",
|
|
7
8
|
"create_readme": "Create README.md",
|
|
8
|
-
"
|
|
9
|
-
"
|
|
10
|
-
"
|
|
11
|
-
"
|
|
12
|
-
"
|
|
9
|
+
"enter_project_name": "Project name",
|
|
10
|
+
"name_not_valid": "Use letters, numbers, dots, dashes, or underscores",
|
|
11
|
+
"dir_is_not_empty": "The target directory is not empty. How would you like to proceed?",
|
|
12
|
+
"dir_action_cancel": "Cancel operation",
|
|
13
|
+
"dir_action_clear": "Remove existing files and continue",
|
|
14
|
+
"dir_action_ignore": "Ignore existing files and continue",
|
|
15
|
+
"operation_cancelled": "Operation cancelled",
|
|
16
|
+
"done": "Project created successfully.",
|
|
17
|
+
"next_steps": "Now run:",
|
|
18
|
+
"target_is_symlink": "The target directory cannot be a symbolic link",
|
|
19
|
+
"target_is_not_directory": "The target path is not a directory",
|
|
20
|
+
"feature_git": "Git",
|
|
21
|
+
"feature_readme": "README.md",
|
|
22
|
+
"feature_node": "Node.js types",
|
|
23
|
+
"feature_alias": "@/ path alias",
|
|
24
|
+
"feature_eslint": "ESLint",
|
|
25
|
+
"feature_vitest": "Vitest",
|
|
26
|
+
"feature_prettier": "Prettier",
|
|
27
|
+
"summary_title": "Project configuration",
|
|
28
|
+
"summary_project": "Project",
|
|
29
|
+
"summary_target": "Target",
|
|
30
|
+
"summary_directory": "Directory",
|
|
31
|
+
"summary_module": "Module system",
|
|
32
|
+
"summary_features": "Features",
|
|
33
|
+
"summary_install": "Install dependencies",
|
|
34
|
+
"summary_git": "Git",
|
|
35
|
+
"summary_files": "Files to generate",
|
|
36
|
+
"summary_policy_create": "create a new directory",
|
|
37
|
+
"summary_policy_clear": "replace existing files",
|
|
38
|
+
"summary_policy_ignore": "merge with existing files",
|
|
39
|
+
"summary_git_new": "initialize a new repository and create the first commit",
|
|
40
|
+
"summary_git_existing": "use the existing repository without an automatic commit",
|
|
41
|
+
"summary_git_disabled": "disabled",
|
|
42
|
+
"confirm_create": "Create the project with this configuration?",
|
|
43
|
+
"create_and_install": "Create project and install dependencies",
|
|
44
|
+
"create_without_install": "Create project without installing dependencies",
|
|
45
|
+
"step_generate": "Generate project files",
|
|
46
|
+
"step_install": "Install dependencies",
|
|
47
|
+
"step_git": "Initialize Git repository",
|
|
48
|
+
"step_publish": "Publish project",
|
|
49
|
+
"yes": "Yes",
|
|
50
|
+
"no": "No",
|
|
51
|
+
"none": "none",
|
|
13
52
|
"lint_tip": "- To lint the project: `npm run lint`\n",
|
|
14
|
-
"prettier_tip": "- To format the code: `npm
|
|
15
|
-
"
|
|
53
|
+
"prettier_tip": "- To format the code: `npm run format`\n",
|
|
54
|
+
"test_tip": "- To run tests in watch mode: `npm test`\n- To run tests once: `npm run test:run`\n",
|
|
55
|
+
"readme_content": "# ts-vibe\n[Source code](https://github.com/yar1kpr0grammer/ts-vibe)\n\n***\n\n**Main file:** `src/index.ts`\n\n## Scripts\n\n| Command | Description |\n|---|---|\n| `npm run dev` | Starts the project in development mode with watch enabled |\n| `npm start` | Runs the project once using tsx |\n| `npm run check` | Checks types without emitting JavaScript files |\n| `npm run build` | Compiles TypeScript files into the `dist` folder |\n| `npm run prod` | Runs the compiled production build |\n\n\n## Project Structure\n\n```txt\nsrc/ - source code\ndist/ - compiled JavaScript output\n```\n",
|
|
16
56
|
"choose_project_template": "Choose project template:",
|
|
17
57
|
"template_recommended": "Recommended",
|
|
18
58
|
"template_custom": "Custom",
|
package/languages/ru.json
CHANGED
|
@@ -1,20 +1,60 @@
|
|
|
1
1
|
{
|
|
2
|
-
"
|
|
2
|
+
"cli_title": "Создание TypeScript-проекта",
|
|
3
|
+
"success": "Готово",
|
|
3
4
|
"error": "Ошибка",
|
|
4
5
|
"choose_node_type": "Выберите тип Nodejs",
|
|
5
6
|
"update_ts_config": "Обновление tsconfig.json",
|
|
6
7
|
"update_package": "Обновление package.json",
|
|
7
8
|
"create_readme": "Создание README.md",
|
|
8
|
-
"
|
|
9
|
-
"
|
|
10
|
-
"
|
|
11
|
-
"
|
|
12
|
-
"
|
|
9
|
+
"enter_project_name": "Название проекта",
|
|
10
|
+
"name_not_valid": "Используйте буквы, цифры, точки, дефисы или подчёркивания",
|
|
11
|
+
"dir_is_not_empty": "Целевая папка не пуста. Как продолжить?",
|
|
12
|
+
"dir_action_cancel": "Отменить операцию",
|
|
13
|
+
"dir_action_clear": "Удалить существующие файлы и продолжить",
|
|
14
|
+
"dir_action_ignore": "Оставить существующие файлы и продолжить",
|
|
15
|
+
"operation_cancelled": "Операция отменена",
|
|
16
|
+
"done": "Проект успешно создан.",
|
|
17
|
+
"next_steps": "Теперь выполните:",
|
|
18
|
+
"target_is_symlink": "Целевая папка не может быть символической ссылкой",
|
|
19
|
+
"target_is_not_directory": "Целевой путь не является папкой",
|
|
20
|
+
"feature_git": "Git",
|
|
21
|
+
"feature_readme": "README.md",
|
|
22
|
+
"feature_node": "Типы Node.js",
|
|
23
|
+
"feature_alias": "Алиас путей @/",
|
|
24
|
+
"feature_eslint": "ESLint",
|
|
25
|
+
"feature_vitest": "Vitest",
|
|
26
|
+
"feature_prettier": "Prettier",
|
|
27
|
+
"summary_title": "Конфигурация проекта",
|
|
28
|
+
"summary_project": "Проект",
|
|
29
|
+
"summary_target": "Путь",
|
|
30
|
+
"summary_directory": "Папка",
|
|
31
|
+
"summary_module": "Система модулей",
|
|
32
|
+
"summary_features": "Возможности",
|
|
33
|
+
"summary_install": "Установка зависимостей",
|
|
34
|
+
"summary_git": "Git",
|
|
35
|
+
"summary_files": "Создаваемые файлы",
|
|
36
|
+
"summary_policy_create": "создать новую папку",
|
|
37
|
+
"summary_policy_clear": "заменить существующие файлы",
|
|
38
|
+
"summary_policy_ignore": "объединить с существующими файлами",
|
|
39
|
+
"summary_git_new": "создать репозиторий и первый коммит",
|
|
40
|
+
"summary_git_existing": "использовать существующий репозиторий без автоматического коммита",
|
|
41
|
+
"summary_git_disabled": "отключён",
|
|
42
|
+
"confirm_create": "Создать проект с этой конфигурацией?",
|
|
43
|
+
"create_and_install": "Создание проекта и установка зависимостей",
|
|
44
|
+
"create_without_install": "Создание проекта без установки зависимостей",
|
|
45
|
+
"step_generate": "Создание файлов проекта",
|
|
46
|
+
"step_install": "Установка зависимостей",
|
|
47
|
+
"step_git": "Инициализация Git-репозитория",
|
|
48
|
+
"step_publish": "Публикация проекта",
|
|
49
|
+
"yes": "Да",
|
|
50
|
+
"no": "Нет",
|
|
51
|
+
"none": "нет",
|
|
13
52
|
"lint_tip": "- Чтобы запустить проверку ошибок: `npm run lint`\n",
|
|
14
|
-
"prettier_tip": "- Чтобы отформатировать код: `npm run
|
|
15
|
-
"
|
|
53
|
+
"prettier_tip": "- Чтобы отформатировать код: `npm run format`\n",
|
|
54
|
+
"test_tip": "- Чтобы запустить тесты в watch-режиме: `npm test`\n- Чтобы выполнить тесты один раз: `npm run test:run`\n",
|
|
55
|
+
"readme_content": "# ts-vibe\n[Исходный код](https://github.com/yar1kpr0grammer/ts-vibe)\n\n***\n\n**Главный файл:** `src/index.ts`\n\n## Скрипты\n\n| Команда | Описание |\n|---|---|\n| `npm run dev` | Запускает проект в режиме разработки с автоматической перезагрузкой |\n| `npm start` | Запускает проект один раз через tsx |\n| `npm run check` | Проверяет типы без создания JavaScript-файлов |\n| `npm run build` | Компилирует TypeScript-файлы в папку `dist` |\n| `npm run prod` | Запускает production-сборку из папки `dist` |\n\n\n## Структура проекта\n\n```txt\nsrc/ - исходный код\ndist/ - скомпилированный JavaScript\n```\n",
|
|
16
56
|
"choose_project_template": "Выберите вариант проекта:",
|
|
17
57
|
"template_recommended": "Рекомендуемый",
|
|
18
58
|
"template_custom": "Настроить самостоятельно",
|
|
19
|
-
"choose_packages": "
|
|
59
|
+
"choose_packages": "Выберите, что добавить в проект:"
|
|
20
60
|
}
|
package/package.json
CHANGED
|
@@ -1,13 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ts-vibe",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.5.0",
|
|
4
4
|
"description": "",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"ts-vibe": "./index.js"
|
|
8
8
|
},
|
|
9
9
|
"scripts": {
|
|
10
|
-
"start": "node index.js"
|
|
10
|
+
"start": "node index.js",
|
|
11
|
+
"test": "node --test tests/generator.test.mjs"
|
|
11
12
|
},
|
|
12
13
|
"keywords": [],
|
|
13
14
|
"files": [
|
|
@@ -19,10 +20,8 @@
|
|
|
19
20
|
"license": "MIT",
|
|
20
21
|
"type": "module",
|
|
21
22
|
"dependencies": {
|
|
22
|
-
"@
|
|
23
|
-
"@inquirer/prompts": "^8.4.2",
|
|
24
|
-
"chalk": "^5.6.2",
|
|
23
|
+
"@clack/prompts": "^1.9.0",
|
|
25
24
|
"json5": "^2.2.3",
|
|
26
|
-
"
|
|
25
|
+
"picocolors": "^1.1.1"
|
|
27
26
|
}
|
|
28
27
|
}
|
package/src/cmd.mjs
CHANGED
|
@@ -1,57 +1,81 @@
|
|
|
1
|
-
import
|
|
2
|
-
import
|
|
3
|
-
import
|
|
1
|
+
import { spawn } from "node:child_process";
|
|
2
|
+
import fs from "node:fs";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import process from "node:process";
|
|
4
5
|
|
|
5
|
-
|
|
6
|
+
function findNpmCli() {
|
|
7
|
+
const candidates = [];
|
|
8
|
+
const npmExecPath = process.env.npm_execpath;
|
|
9
|
+
|
|
10
|
+
if (npmExecPath && path.basename(npmExecPath).toLowerCase() === "npm-cli.js") {
|
|
11
|
+
candidates.push(npmExecPath);
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
candidates.push(
|
|
15
|
+
path.join(
|
|
16
|
+
path.dirname(process.execPath),
|
|
17
|
+
"node_modules",
|
|
18
|
+
"npm",
|
|
19
|
+
"bin",
|
|
20
|
+
"npm-cli.js",
|
|
21
|
+
),
|
|
22
|
+
);
|
|
23
|
+
|
|
24
|
+
for (const directory of (process.env.PATH ?? "").split(path.delimiter)) {
|
|
25
|
+
if (directory) {
|
|
26
|
+
candidates.push(
|
|
27
|
+
path.join(directory, "node_modules", "npm", "bin", "npm-cli.js"),
|
|
28
|
+
);
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
return candidates.find((candidate) => fs.existsSync(candidate));
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
function invocation(command, args) {
|
|
36
|
+
if (process.platform === "win32" && command === "npm") {
|
|
37
|
+
const npmCli = findNpmCli();
|
|
38
|
+
if (npmCli) {
|
|
39
|
+
return { command: process.execPath, args: [npmCli, ...args] };
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
return { command, args };
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export function exec(command, args = [], options = {}) {
|
|
6
47
|
return new Promise((resolve, reject) => {
|
|
7
|
-
const
|
|
8
|
-
|
|
48
|
+
const resolved = invocation(command, args);
|
|
49
|
+
const child = spawn(resolved.command, resolved.args, {
|
|
50
|
+
cwd: options.cwd,
|
|
51
|
+
env: process.env,
|
|
52
|
+
shell: false,
|
|
9
53
|
stdio: "pipe",
|
|
10
54
|
});
|
|
11
|
-
|
|
12
55
|
let stdout = "";
|
|
13
56
|
let stderr = "";
|
|
14
57
|
|
|
15
|
-
child.stdout.on("data", (
|
|
16
|
-
stdout +=
|
|
58
|
+
child.stdout.on("data", (chunk) => {
|
|
59
|
+
stdout += chunk;
|
|
17
60
|
});
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
stderr += data.toString();
|
|
61
|
+
child.stderr.on("data", (chunk) => {
|
|
62
|
+
stderr += chunk;
|
|
21
63
|
});
|
|
22
|
-
|
|
23
|
-
child.on("close", (code) => {
|
|
64
|
+
child.on("error", reject);
|
|
65
|
+
child.on("close", (code, signal) => {
|
|
24
66
|
if (code === 0) {
|
|
25
67
|
resolve(stdout);
|
|
26
|
-
|
|
27
|
-
reject(new Error(stderr || stdout));
|
|
68
|
+
return;
|
|
28
69
|
}
|
|
29
|
-
});
|
|
30
70
|
|
|
31
|
-
|
|
32
|
-
|
|
71
|
+
const renderedCommand = [command, ...args].join(" ");
|
|
72
|
+
const reason = signal ? `signal ${signal}` : `exit code ${code}`;
|
|
73
|
+
const details = stderr.trim() || stdout.trim();
|
|
74
|
+
reject(
|
|
75
|
+
new Error(
|
|
76
|
+
`${renderedCommand} failed with ${reason}${details ? `\n${details}` : ""}`,
|
|
77
|
+
),
|
|
78
|
+
);
|
|
33
79
|
});
|
|
34
80
|
});
|
|
35
81
|
}
|
|
36
|
-
|
|
37
|
-
const rl = readline.createInterface({
|
|
38
|
-
input: process.stdin,
|
|
39
|
-
output: process.stdout,
|
|
40
|
-
});
|
|
41
|
-
|
|
42
|
-
export const input = (prompt) =>
|
|
43
|
-
new Promise((resolve) => rl.question(chalk.bold(prompt), resolve));
|
|
44
|
-
|
|
45
|
-
export async function ask(
|
|
46
|
-
prompt,
|
|
47
|
-
questionPrompt = " [y/n] ",
|
|
48
|
-
confirmVariants = ["y", "yes"],
|
|
49
|
-
) {
|
|
50
|
-
const ans = await input(chalk.bold(prompt + questionPrompt));
|
|
51
|
-
|
|
52
|
-
return confirmVariants.includes(ans.trim().toLowerCase());
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
export function closeInput() {
|
|
56
|
-
rl.close();
|
|
57
|
-
}
|
package/src/fs/dir.mjs
CHANGED
|
@@ -6,6 +6,10 @@ async function clear(folderPath = ".") {
|
|
|
6
6
|
const items = await fsPromises.readdir(folderPath);
|
|
7
7
|
|
|
8
8
|
for (const item of items) {
|
|
9
|
+
if (item === ".git") {
|
|
10
|
+
continue;
|
|
11
|
+
}
|
|
12
|
+
|
|
9
13
|
const fullPath = path.join(folderPath, item);
|
|
10
14
|
await fsPromises.rm(fullPath, {
|
|
11
15
|
recursive: true,
|
|
@@ -20,15 +24,7 @@ export function create(path) {
|
|
|
20
24
|
|
|
21
25
|
export async function hasFiles(dirPath = ".") {
|
|
22
26
|
const items = await fsPromises.readdir(dirPath);
|
|
23
|
-
|
|
24
|
-
for (const item of items) {
|
|
25
|
-
const fullPath = path.join(dirPath, item);
|
|
26
|
-
const stat = await fsPromises.stat(fullPath);
|
|
27
|
-
if (stat.isFile()) {
|
|
28
|
-
return true;
|
|
29
|
-
}
|
|
30
|
-
}
|
|
31
|
-
return false;
|
|
27
|
+
return items.some((item) => item !== ".git");
|
|
32
28
|
}
|
|
33
29
|
|
|
34
30
|
export default { clear, create, hasFiles };
|