kuza-lang 0.4.0 → 0.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 +118 -88
- package/dist/ask.js +108 -0
- package/dist/config.js +56 -0
- package/dist/index.js +345 -183
- package/dist/scaffold.js +82 -0
- package/package.json +5 -2
- package/scripts/postinstall.mjs +39 -0
- package/templates/START.md +133 -0
- package/templates/index.html +19 -0
- package/templates/main-script.kuza +14 -0
- package/templates/main.kuza +36 -0
- package/templates/public/favicon.svg +4 -0
package/README.md
CHANGED
|
@@ -1,127 +1,157 @@
|
|
|
1
1
|
# kuza-lang
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
`kuza-lang` — пакет с командой `kuza`: создание проектов, запуск сайта на
|
|
4
|
+
localhost, сборка, проверка, сервер, ИИ-помощник и REPL. Компилятор живёт в
|
|
5
|
+
отдельном пакете `kuza-core`, который уже входит в зависимости.
|
|
6
6
|
|
|
7
|
-
## Установка
|
|
7
|
+
## Установка и первый сайт
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
|
|
10
|
+
mkdir my-site && cd my-site
|
|
11
|
+
npm install kuza-lang
|
|
12
|
+
npm run dev
|
|
11
13
|
```
|
|
12
14
|
|
|
13
|
-
|
|
14
|
-
Пакет называется `kuza-lang`, потому что имя `kuza` реестр npm не принимает
|
|
15
|
-
(слишком похоже на существующий пакет `koa`) — на саму команду это не влияет.
|
|
15
|
+
`postinstall` в пустой папке создаст:
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
kuza build main.kuza # соберёт main.js — работает обычным node main.js
|
|
25
|
-
kuza # откроет консоль (REPL)
|
|
26
|
-
kuza help # справка
|
|
17
|
+
```text
|
|
18
|
+
index.html каркас страницы с Tailwind и меткой {main.kuza}
|
|
19
|
+
main.kuza приложение (счётчик, иконка и ссылка на документацию)
|
|
20
|
+
public/favicon.svg иконка сайта
|
|
21
|
+
START.md инструкция: CLI, ИИ, плагины, бэкенд, VS Code
|
|
22
|
+
README.md
|
|
23
|
+
.gitignore
|
|
27
24
|
```
|
|
28
25
|
|
|
29
|
-
|
|
26
|
+
`npm install` в существующем проекте (React, Next.js и т.п.) **не** перезаписывает
|
|
27
|
+
файлы — скаффолд срабатывает только когда нет `index.html`, `src/`, `app/`,
|
|
28
|
+
`pages/` и других зависимостей, кроме `kuza-lang`.
|
|
30
29
|
|
|
31
|
-
|
|
32
|
-
## main.kuza
|
|
33
|
-
:name = "мир";
|
|
34
|
-
log >> "Привет, {name}!";
|
|
30
|
+
Без установки: `npx kuza-lang new my-site`.
|
|
35
31
|
|
|
36
|
-
|
|
37
|
-
users.add<1, "Аня", 17>;
|
|
38
|
-
users.add<2, "Боря", 22>;
|
|
32
|
+
## Команды CLI
|
|
39
33
|
|
|
40
|
-
|
|
41
|
-
|
|
34
|
+
| Команда | Что делает |
|
|
35
|
+
| --- | --- |
|
|
36
|
+
| `kuza new <dir>` (`init`, `create`) | создать проект; `--script` — консольная программа, `--force` — перезаписать |
|
|
37
|
+
| `kuza start` (`dev`) | dev-сервер на `http://localhost:5173`; `--port=3000` |
|
|
38
|
+
| `kuza build` | собрать `dist/index.html` и `dist/<страница>/index.html` |
|
|
39
|
+
| `kuza check` (`doctor`) | проверить все `.kuza` файлы без запуска |
|
|
40
|
+
| `kuza serve server.kuza` | поднять HTTP-сервер, описанный на Kuza |
|
|
41
|
+
| `kuza ai "вопрос" --file main.kuza` | ИИ, который читает файлы проекта |
|
|
42
|
+
| `kuza run main.kuza` | выполнить файл в Node.js |
|
|
43
|
+
| `kuza build main.kuza` | собрать самостоятельный `.js` |
|
|
44
|
+
| `kuza watch main.kuza --web` | пересобирать HTML при изменениях |
|
|
45
|
+
| `kuza docs` | путь к `START.md` или ссылка на документацию |
|
|
46
|
+
| `kuza help` | справка |
|
|
42
47
|
|
|
43
|
-
|
|
44
|
-
delete from users where age < 18;
|
|
45
|
-
log >> "Осталось: {len >> users}";
|
|
46
|
-
```
|
|
48
|
+
`npm start` в созданном проекте — алиас `npm run dev`.
|
|
47
49
|
|
|
48
|
-
##
|
|
50
|
+
## Сайт на Kuza
|
|
49
51
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
- строки с подстановками `"Привет, {name}!"`, лямбды `(x) -> x * 2`, цепочки `|>`;
|
|
53
|
-
- 100+ встроенных команд: строки, массивы, JSON, файлы, HTTP, время, DOM;
|
|
54
|
-
- таблицы: `table<...>`, `select`, `update`, `delete`, сохранение в JSON;
|
|
55
|
-
- сайты: `body`, `box`, `row`, `column`, `card`, `section`, `nav` (вложенные блоки),
|
|
56
|
-
а внутри — `heading`, `para`, `button`, `field`, `list`, `link`, `image`, `render`;
|
|
57
|
-
- модули `use math;`, `use time;`, `use "./helpers.kuza";`.
|
|
52
|
+
```kuza
|
|
53
|
+
:count = 0;
|
|
58
54
|
|
|
59
|
-
|
|
55
|
+
view App<> >> [
|
|
56
|
+
page >> "Hello, Kuza!";
|
|
60
57
|
|
|
61
|
-
|
|
58
|
+
body<"mx-auto max-w-2xl p-8"> >> [
|
|
59
|
+
heading >> <"Hello, Kuza!", "text-4xl font-bold">;
|
|
60
|
+
para >> <"Count: {count}", "text-orange-400">;
|
|
61
|
+
button >> <"Add one", increase, "rounded bg-orange-500 px-4 py-2">;
|
|
62
|
+
];
|
|
62
63
|
|
|
63
|
-
|
|
64
|
+
render;
|
|
65
|
+
];
|
|
64
66
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
</body>
|
|
67
|
+
func increase<> >> [
|
|
68
|
+
count = count + 1; // view перерисуется сам
|
|
69
|
+
];
|
|
69
70
|
```
|
|
70
71
|
|
|
71
|
-
|
|
72
|
-
|
|
72
|
+
`view` — один экран. Переменные, которые он использует, становятся
|
|
73
|
+
реактивными: достаточно присваивания, ручного `draw<>()` не нужно.
|
|
74
|
+
Классы внутри `<"..." >` — Tailwind; `index.html` шаблона уже подключает его.
|
|
73
75
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
+
Контейнеры: `body`, `section`, `nav`, `row`, `column`, `card`, `box`. Внутри —
|
|
77
|
+
`heading`, `para`, `button`, `field`, `list`, `link`, `image`. `render` рисует
|
|
78
|
+
собранное дерево.
|
|
76
79
|
|
|
77
|
-
|
|
78
|
-
card >> [
|
|
79
|
-
heading >> t;
|
|
80
|
-
para >> "Компонент — обычная функция Kuza.";
|
|
81
|
-
];
|
|
82
|
-
];
|
|
83
|
-
|
|
84
|
-
func draw<> >> [
|
|
85
|
-
page >> "Мой сайт";
|
|
80
|
+
### Многостраничность
|
|
86
81
|
|
|
87
|
-
|
|
88
|
-
|
|
82
|
+
`main.kuza` — главная страница. Файл `pages/about.kuza` становится `/about`
|
|
83
|
+
в dev-сервере и `dist/about/index.html` после сборки. Статика из `public/`
|
|
84
|
+
копируется в `dist/`.
|
|
89
85
|
|
|
90
|
-
|
|
91
|
-
Card<"Первый">;
|
|
92
|
-
Card<"Второй">;
|
|
93
|
-
];
|
|
86
|
+
## Хранилище и бэкенд
|
|
94
87
|
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
];
|
|
88
|
+
```kuza
|
|
89
|
+
storeSet >> <"visits", 3>;
|
|
90
|
+
:visits = storeGet >> <"visits", 0>;
|
|
91
|
+
```
|
|
100
92
|
|
|
101
|
-
|
|
93
|
+
```kuza
|
|
94
|
+
func home<> >> [
|
|
95
|
+
respond >> <{ ok: true, name: query >> "name" }, 200>;
|
|
102
96
|
];
|
|
103
97
|
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
];
|
|
98
|
+
route >> <"GET", "/", home>;
|
|
99
|
+
listen >> 3000;
|
|
100
|
+
```
|
|
108
101
|
|
|
109
|
-
|
|
102
|
+
Запуск: `kuza serve server.kuza`. Маршруты поддерживают параметры
|
|
103
|
+
`/users/:id`; запрос читают `param`, `query`, `requestBody`, `header`, `method`,
|
|
104
|
+
`serverPath`.
|
|
105
|
+
|
|
106
|
+
## Плагины
|
|
107
|
+
|
|
108
|
+
`kuza.config.js` рядом с `package.json`:
|
|
109
|
+
|
|
110
|
+
```js
|
|
111
|
+
export default {
|
|
112
|
+
commands: [
|
|
113
|
+
{
|
|
114
|
+
id: "shout", name: "shout", aliases: [], category: "output",
|
|
115
|
+
args: "single", params: ["text"],
|
|
116
|
+
description: "Верхний регистр", example: 'shout >> "hi";',
|
|
117
|
+
codegen: "console.log(String({0}).toUpperCase())",
|
|
118
|
+
},
|
|
119
|
+
],
|
|
120
|
+
plugins: [
|
|
121
|
+
{
|
|
122
|
+
name: "example",
|
|
123
|
+
setup(api) {
|
|
124
|
+
api.onCompile(({ source }) => source);
|
|
125
|
+
api.onBuild(({ code }) => code);
|
|
126
|
+
api.onRun(({ result }) => result);
|
|
127
|
+
},
|
|
128
|
+
},
|
|
129
|
+
],
|
|
130
|
+
};
|
|
110
131
|
```
|
|
111
132
|
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
133
|
+
Команда плагина становится доступной в `.kuza` файлах и в подсветке после
|
|
134
|
+
перезапуска CLI.
|
|
135
|
+
|
|
136
|
+
## ИИ
|
|
137
|
+
|
|
138
|
+
Ключ берётся из `.env` или окружения:
|
|
139
|
+
|
|
140
|
+
```dotenv
|
|
141
|
+
KUZA_AI_KEY=sk-...
|
|
142
|
+
KUZA_AI_PROVIDER=openai
|
|
143
|
+
KUZA_AI_MODEL=gpt-4o-mini
|
|
144
|
+
KUZA_AI_BASE_URL=https://api.openai.com/v1
|
|
115
145
|
```
|
|
116
146
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
Обычный консольный код (`log`, `for`, `try`) работает в том же файле.
|
|
147
|
+
Поддерживаются OpenAI, OpenRouter, Groq, Ollama, Freebuff и Anthropic
|
|
148
|
+
(`ANTHROPIC_API_KEY`). Команда `kuza ai` читает файлы проекта и ошибки
|
|
149
|
+
компиляции; ключ никогда не печатается.
|
|
121
150
|
|
|
122
|
-
##
|
|
151
|
+
## Ссылки
|
|
123
152
|
|
|
124
|
-
|
|
125
|
-
|
|
153
|
+
- Все команды: `docs/commands.md` в репозитории.
|
|
154
|
+
- Компилятор как библиотека: `kuza-core`.
|
|
155
|
+
- Расширение: `kuza-vscode`.
|
|
126
156
|
|
|
127
157
|
Лицензия: MIT.
|
package/dist/ask.js
ADDED
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
/** Одноразовый вызов ИИ из CLI: kuza ai "вопрос" --file main.kuza */
|
|
2
|
+
import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
|
|
3
|
+
import { extname, join, relative, resolve } from "node:path";
|
|
4
|
+
import { compile, formatDiagnostic } from "kuza-core";
|
|
5
|
+
import { askAi, resolveAiConfig, systemPrompt } from "./ai.js";
|
|
6
|
+
import { bold, danger, dim, primary } from "./ui.js";
|
|
7
|
+
const ALLOWED = new Set([".kuza", ".html", ".js", ".ts", ".json", ".md", ".css", ".txt", ".mjs"]);
|
|
8
|
+
const SKIP = new Set(["node_modules", "dist", ".git", ".vsix"]);
|
|
9
|
+
const MAX_FILES = 24;
|
|
10
|
+
const MAX_CHARS = 60000;
|
|
11
|
+
function collectFiles(root, explicit) {
|
|
12
|
+
if (explicit.length > 0) {
|
|
13
|
+
return explicit
|
|
14
|
+
.map((name) => resolve(root, name))
|
|
15
|
+
.filter((path) => existsSync(path) && statSync(path).isFile());
|
|
16
|
+
}
|
|
17
|
+
const found = [];
|
|
18
|
+
const walk = (dir, depth) => {
|
|
19
|
+
if (depth > 2 || found.length >= MAX_FILES)
|
|
20
|
+
return;
|
|
21
|
+
let entries = [];
|
|
22
|
+
try {
|
|
23
|
+
entries = readdirSync(dir);
|
|
24
|
+
}
|
|
25
|
+
catch {
|
|
26
|
+
return;
|
|
27
|
+
}
|
|
28
|
+
for (const entry of entries) {
|
|
29
|
+
if (SKIP.has(entry) || entry.startsWith("."))
|
|
30
|
+
continue;
|
|
31
|
+
const path = join(dir, entry);
|
|
32
|
+
if (!existsSync(path))
|
|
33
|
+
continue;
|
|
34
|
+
if (statSync(path).isDirectory()) {
|
|
35
|
+
walk(path, depth + 1);
|
|
36
|
+
continue;
|
|
37
|
+
}
|
|
38
|
+
if (ALLOWED.has(extname(entry)))
|
|
39
|
+
found.push(path);
|
|
40
|
+
if (found.length >= MAX_FILES)
|
|
41
|
+
break;
|
|
42
|
+
}
|
|
43
|
+
};
|
|
44
|
+
walk(root, 0);
|
|
45
|
+
// Сначала самые важные файлы проекта.
|
|
46
|
+
const priority = ["main.kuza", "index.kuza", "index.html", "START.md", "package.json"];
|
|
47
|
+
found.sort((a, b) => {
|
|
48
|
+
const nameA = relative(root, a).replace(/\\/g, "/");
|
|
49
|
+
const nameB = relative(root, b).replace(/\\/g, "/");
|
|
50
|
+
const rankA = priority.indexOf(nameA);
|
|
51
|
+
const rankB = priority.indexOf(nameB);
|
|
52
|
+
return (rankA === -1 ? 99 : rankA) - (rankB === -1 ? 99 : rankB);
|
|
53
|
+
});
|
|
54
|
+
return found.slice(0, MAX_FILES);
|
|
55
|
+
}
|
|
56
|
+
function diagnostics(root) {
|
|
57
|
+
for (const name of ["main.kuza", "index.kuza"]) {
|
|
58
|
+
const path = join(root, name);
|
|
59
|
+
if (!existsSync(path))
|
|
60
|
+
continue;
|
|
61
|
+
const source = readFileSync(path, "utf8");
|
|
62
|
+
const result = compile(source, { filename: path });
|
|
63
|
+
if (!result.ok) {
|
|
64
|
+
return `\nОшибка компиляции ${name}:\n${formatDiagnostic(result.errors[0], source)}`;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
return "";
|
|
68
|
+
}
|
|
69
|
+
export async function runAiQuestion(question, explicitFiles = []) {
|
|
70
|
+
const config = resolveAiConfig();
|
|
71
|
+
if (!config) {
|
|
72
|
+
console.log(danger("ИИ не настроен. Добавь KUZA_AI_KEY в .env или окружение."));
|
|
73
|
+
console.log(dim("Подробности: START.md → раздел «AI assistant»"));
|
|
74
|
+
return;
|
|
75
|
+
}
|
|
76
|
+
const root = process.cwd();
|
|
77
|
+
const files = collectFiles(root, explicitFiles);
|
|
78
|
+
const parts = [`Проект в ${root}. Файлы:`];
|
|
79
|
+
let total = 0;
|
|
80
|
+
for (const path of files) {
|
|
81
|
+
const name = relative(root, path).replace(/\\/g, "/");
|
|
82
|
+
let text = readFileSync(path, "utf8");
|
|
83
|
+
if (text.length > 12000)
|
|
84
|
+
text = text.slice(0, 12000) + "\n… [обрезано]";
|
|
85
|
+
if (total + text.length > MAX_CHARS)
|
|
86
|
+
break;
|
|
87
|
+
total += text.length;
|
|
88
|
+
parts.push(`\n--- ${name} ---\n${text}`);
|
|
89
|
+
}
|
|
90
|
+
if (files.length === 0)
|
|
91
|
+
parts.push("(в папке не найдены текстовые файлы проекта)");
|
|
92
|
+
parts.push(diagnostics(root));
|
|
93
|
+
const messages = [
|
|
94
|
+
{
|
|
95
|
+
role: "user",
|
|
96
|
+
content: `${parts.join("\n")}\n\nЗадача: ${question}`,
|
|
97
|
+
},
|
|
98
|
+
];
|
|
99
|
+
console.log(dim(`ИИ читает ${files.length} файл(ов)…`));
|
|
100
|
+
try {
|
|
101
|
+
const answer = await askAi(config, messages, systemPrompt());
|
|
102
|
+
console.log("");
|
|
103
|
+
console.log(bold(primary("Kuza AI")) + "\n" + answer);
|
|
104
|
+
}
|
|
105
|
+
catch (error) {
|
|
106
|
+
console.log(danger(`Ошибка ИИ: ${error instanceof Error ? error.message : String(error)}`));
|
|
107
|
+
}
|
|
108
|
+
}
|
package/dist/config.js
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Поддержка kuza.config.js: плагины, хуки и свои команды.
|
|
3
|
+
*
|
|
4
|
+
* Файл лежит рядом с package.json и подключается перед компиляцией.
|
|
5
|
+
* Ошибка в конфиге не должна ломать CLI — показываем предупреждение.
|
|
6
|
+
*/
|
|
7
|
+
import { existsSync } from "node:fs";
|
|
8
|
+
import { join } from "node:path";
|
|
9
|
+
import { pathToFileURL } from "node:url";
|
|
10
|
+
import { defineCommand } from "kuza-core";
|
|
11
|
+
export async function loadProjectConfig(dir = process.cwd()) {
|
|
12
|
+
const loaded = { compile: [], build: [], run: [], warnings: [] };
|
|
13
|
+
const path = join(dir, "kuza.config.js");
|
|
14
|
+
if (!existsSync(path))
|
|
15
|
+
return loaded;
|
|
16
|
+
try {
|
|
17
|
+
const module = (await import(pathToFileURL(path).href + "?t=" + Date.now()));
|
|
18
|
+
const config = module.default ?? module;
|
|
19
|
+
for (const command of config.commands ?? [])
|
|
20
|
+
defineCommand(command);
|
|
21
|
+
const api = {
|
|
22
|
+
defineCommand,
|
|
23
|
+
onCompile: (hook) => loaded.compile.push(hook),
|
|
24
|
+
onBuild: (hook) => loaded.build.push(hook),
|
|
25
|
+
onRun: (hook) => loaded.run.push(hook),
|
|
26
|
+
};
|
|
27
|
+
for (const plugin of config.plugins ?? []) {
|
|
28
|
+
await plugin.setup(api);
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
catch (error) {
|
|
32
|
+
loaded.warnings.push(`kuza.config.js: ${error instanceof Error ? error.message : String(error)}`);
|
|
33
|
+
}
|
|
34
|
+
return loaded;
|
|
35
|
+
}
|
|
36
|
+
export function applyCompileHooks(config, context) {
|
|
37
|
+
let source = context.source;
|
|
38
|
+
for (const hook of config.compile) {
|
|
39
|
+
source = hook({ ...context, source }) ?? source;
|
|
40
|
+
}
|
|
41
|
+
return source;
|
|
42
|
+
}
|
|
43
|
+
export function applyBuildHooks(config, context) {
|
|
44
|
+
let code = context.code;
|
|
45
|
+
for (const hook of config.build) {
|
|
46
|
+
code = hook({ ...context, code }) ?? code;
|
|
47
|
+
}
|
|
48
|
+
return code;
|
|
49
|
+
}
|
|
50
|
+
export function applyRunHooks(config, context) {
|
|
51
|
+
let result = context.result;
|
|
52
|
+
for (const hook of config.run) {
|
|
53
|
+
result = hook({ ...context, result }) ?? result;
|
|
54
|
+
}
|
|
55
|
+
return result;
|
|
56
|
+
}
|