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 CHANGED
@@ -1,127 +1,157 @@
1
1
  # kuza-lang
2
2
 
3
- **Kuza** — маленький язык программирования, который компилируется в JavaScript.
4
- Короче и понятнее, чем JavaScript: `log >> "привет";`, `:x = 5;`, `?x > 3 >> [ ... ]`,
5
- таблицы с `select ... from ... where ...`.
3
+ `kuza-lang` — пакет с командой `kuza`: создание проектов, запуск сайта на
4
+ localhost, сборка, проверка, сервер, ИИ-помощник и REPL. Компилятор живёт в
5
+ отдельном пакете `kuza-core`, который уже входит в зависимости.
6
6
 
7
- ## Установка
7
+ ## Установка и первый сайт
8
8
 
9
9
  ```bash
10
- npm i -g kuza-lang
10
+ mkdir my-site && cd my-site
11
+ npm install kuza-lang
12
+ npm run dev
11
13
  ```
12
14
 
13
- После установки в терминале появляется команда `kuza`.
14
- Пакет называется `kuza-lang`, потому что имя `kuza` реестр npm не принимает
15
- (слишком похоже на существующий пакет `koa`) — на саму команду это не влияет.
15
+ `postinstall` в пустой папке создаст:
16
16
 
17
- Без глобальной установки можно запускать через `npx kuza-lang run main.kuza`.
18
-
19
- ## Быстрый старт
20
-
21
- ```bash
22
- kuza init # создаст main.kuza с примером
23
- kuza run main.kuza # выполнит программу
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
- ```kuza
32
- ## main.kuza
33
- :name = "мир";
34
- log >> "Привет, {name}!";
30
+ Без установки: `npx kuza-lang new my-site`.
35
31
 
36
- :users = table<id, name, age>;
37
- users.add<1, "Аня", 17>;
38
- users.add<2, "Боря", 22>;
32
+ ## Команды CLI
39
33
 
40
- :adults = select name, age from users where age >= 18 order by age desc;
41
- table >> adults;
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
- update users set age = age + 1 where id = 1;
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
- - переменные `:x = 5;`, функции `func add<a, b> >> [ return a + b; ]`;
51
- - условия `? ... >> [ ... ] || [ ... ]`, циклы `while<>`, `for<>`, `foreach<>`, диапазоны `1..10`;
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
- Полный список команд: `docs/commands.md` в репозитории языка.
55
+ view App<> >> [
56
+ page >> "Hello, Kuza!";
60
57
 
61
- ## Сайты прямо на Kuza
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
- Каркас — обычный `index.html`, а в `body` стоит метка, куда попадёт программа:
64
+ render;
65
+ ];
64
66
 
65
- ```html
66
- <body>
67
- {main.kuza}
68
- </body>
67
+ func increase<> >> [
68
+ count = count + 1; // view перерисуется сам
69
+ ];
69
70
  ```
70
71
 
71
- Создать такой проект: `kuza init --web`. Дальше страница собирается из вложенных блоков —
72
- как компоненты в React, только без сборщика и зависимостей:
72
+ `view` — один экран. Переменные, которые он использует, становятся
73
+ реактивными: достаточно присваивания, ручного `draw<>()` не нужно.
74
+ Классы внутри `<"..." >` — Tailwind; `index.html` шаблона уже подключает его.
73
75
 
74
- ```kuza
75
- :count = 0;
76
+ Контейнеры: `body`, `section`, `nav`, `row`, `column`, `card`, `box`. Внутри —
77
+ `heading`, `para`, `button`, `field`, `list`, `link`, `image`. `render` рисует
78
+ собранное дерево.
76
79
 
77
- func Card<t> >> [
78
- card >> [
79
- heading >> t;
80
- para >> "Компонент — обычная функция Kuza.";
81
- ];
82
- ];
83
-
84
- func draw<> >> [
85
- page >> "Мой сайт";
80
+ ### Многостраничность
86
81
 
87
- body >> [
88
- heading >> "Привет! Это сайт на Kuza";
82
+ `main.kuza` — главная страница. Файл `pages/about.kuza` становится `/about`
83
+ в dev-сервере и `dist/about/index.html` после сборки. Статика из `public/`
84
+ копируется в `dist/`.
89
85
 
90
- row >> [
91
- Card<"Первый">;
92
- Card<"Второй">;
93
- ];
86
+ ## Хранилище и бэкенд
94
87
 
95
- column >> [
96
- heading >> "Счётчик: {count}";
97
- button >> <"Прибавить", increase>;
98
- ];
99
- ];
88
+ ```kuza
89
+ storeSet >> <"visits", 3>;
90
+ :visits = storeGet >> <"visits", 0>;
91
+ ```
100
92
 
101
- render;
93
+ ```kuza
94
+ func home<> >> [
95
+ respond >> <{ ok: true, name: query >> "name" }, 200>;
102
96
  ];
103
97
 
104
- func increase<> >> [
105
- count = count + 1;
106
- draw<>;
107
- ];
98
+ route >> <"GET", "/", home>;
99
+ listen >> 3000;
100
+ ```
108
101
 
109
- draw<>;
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
- ```bash
113
- kuza build main.kuza --web # → main.html, код вставляется в метку {main.kuza}
114
- kuza watch main.kuza --web # пересборка при каждом сохранении
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
- Контейнеры: `body`, `section`, `nav`, `row`, `column` (алиас `col`), `box`, `card`.
118
- Внутри — `heading`, `para`, `list`, `button`, `field` + `fieldValue`, `link`, `image`.
119
- `page` задаёт заголовок вкладки, `render` рисует собранное после изменения состояния.
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
- `kuza build main.kuza` создаёт самостоятельный JavaScript-файл с рантаймом —
125
- его можно запускать через `node main.js` без установленного Kuza.
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
+ }