@reformer/builder-plugin-cli 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Alexandr Bukhtatyy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+# @reformer/builder-plugin-cli
+
+`reformer-plugin` — командная строка автора плагина ReFormer Builder: создать плагин из шаблона,
+проверить и собрать его **теми же правилами, которыми его проверит оболочка**, разрабатывать
+прямо в открытом проекте и упаковать для npm.
+
+```bash
+npx @reformer/builder-plugin-cli create acme-forms --name "Acme Forms"
+cd acme-forms && npm install
+npx reformer-plugin validate
+npx reformer-plugin dev --project ../my-builder-project
+npx reformer-plugin pack
+```
+
+Нужен Node 20 или новее (`dev` наблюдает за каталогом рекурсивно).
+
+## Команды
+
+### `create <каталог> [--id <id>] [--name <имя>]`
+
+Кладёт в пустой (или несуществующий) каталог готовый плагин:
+
+| Файл                            | Что это                                                                       |
+| ------------------------------- | ----------------------------------------------------------------------------- |
+| `manifest.json`                 | манифест исходников: `main` → `src/main.ts`, словари объявлены                |
+| `src/main.ts`                   | плагин с одной командой, подпись которой берётся из словаря                   |
+| `src/main.test.ts`              | `id` кода совпадает с `id` манифеста — иначе оболочка откажет (`id-mismatch`) |
+| `locales/ru.json`, `en.json`    | плоские словари «ключ → строка»                                               |
+| `package.json`, `tsconfig.json` | `@reformer/builder-plugin-api` в `devDependencies`                            |
+
+Идентификатор по умолчанию — имя каталога. Годится ли он, решает разбор манифеста оболочки,
+а не собственное правило CLI. В непустой каталог команда не пишет.
+
+Созданный плагин можно положить в `.ui_builder/plugins/<id>/` проекта как есть: оболочка сама
+транспилирует `src/main.ts`.
+
+### `validate [каталог]`
+
+Код выхода `0` — оболочка плагин примет, `1` — нет, и почему именно, напечатано построчно.
+
+- **манифест** — разбором из `@reformer/builder-plugin-api/tooling`, тем же, что у оболочки.
+  Отличий у исходников два: имя каталога с `id` не сверяется (репозиторий зовётся как угодно),
+  а `version` обязательна и должна быть версией — по ней публикуется пакет;
+- **файлы, на которые ссылается манифест**: точка входа существует и это код, таблица стилей
+  существует, словари существуют и плоские. Эти отказы собираются все сразу;
+- **версия `package.json`** совпадает с версией манифеста. Этого оболочка не проверяет —
+  `package.json` она не читает, — а расхождение означает пакет одной версии с плагином другой.
+
+Коды отказов — коды оболочки (`manifest-invalid`, `api-version`, `entry-missing`,
+`messages-invalid`, `provides-unregistered`…). Свои коды у CLI — для того, чего оболочка не видит:
+`package-version`, `build-failed`, `module-unavailable`, `css-from-code`, `output-not-ours`,
+`pack-failed`.
+
+Соответствие `provides` регистрации и потолок числа файлов `validate` не проверяет: первое
+требует исполнить код, второе относится к собранному каталогу. Обе проверки делает `build`.
+
+### `build [каталог] [--out <каталог>]`
+
+Собирает каталог, который оболочка грузит как есть (по умолчанию `dist/`): `manifest.json`
+с `main: "main.js"`, один `main.js`, `styles.css`, если стили объявлены, и словари по тем же путям.
+
+- `main.js` — CommonJS: линковщик оболочки исполняет CommonJS, и готовый JS идёт у него без
+  транспиляции;
+- модули, которые подставляет оболочка (`PLUGIN_RUNTIME_MODULES` контракта: React, `@reformer/*`,
+  сам контракт), остаются внешними. Импорт `@reformer/*` или `@builder/*` вне этого списка —
+  отказ `module-unavailable`: вложенная копия была бы вторым экземпляром пакета;
+- импорт CSS из кода — отказ `css-from-code`: стили объявляются полем `styles` манифеста,
+  и только такую таблицу оболочка изолирует.
+
+На выходе сборка проходит то, что пройдёт у оболочки: разбор манифеста поставки `project`, потолок
+числа файлов кода и **«сухую» активацию** — `main.js` исполняется под Node с настоящим пакетом
+контракта и заглушками остального. Так ловятся `not-a-plugin`, `id-mismatch` и
+`provides-unregistered`. Если код падает на заглушке (например, `activate` трогает DOM), это
+не отказ, а заметка `! … не проверено`: вне оболочки так ведут себя и рабочие плагины.
+
+Каталог вывода очищается, только если он пуст или содержит сборку этого же плагина; иначе —
+отказ `output-not-ours`. Не прошедшая проверки сборка прошлую не затирает.
+
+### `dev [каталог] --project <каталог проекта>`
+
+Собирает в `<проект>/.ui_builder/plugins/<id>/` и пересобирает на каждое изменение исходников
+(`node_modules`, `dist` и скрытые каталоги не наблюдаются). Перезагружает плагин оболочка:
+отметьте его в списке плагинов «в разработке», и он перечитывается при возврате в окно билдера.
+
+### `pack [каталог] [--out <каталог>]`
+
+Собирает во временный каталог и упаковывает `npm pack` в `<имя>-<версия>.tgz`. В архиве только
+сборка и `package.json` (имя, описание, лицензия и ключевые слова из исходного, версия — из
+манифеста, ключевое слово `reformer-builder-plugin` добавляется); исходников и зависимостей нет.
+
+## Программный вход
+
+```ts
+import { buildPlugin } from '@reformer/builder-plugin-cli';
+
+const result = await buildPlugin({ dir: './acme-forms', outDir: './out' });
+if (!result.ok) console.log(result.findings);
+```
+
+## Лицензия
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * `reformer-plugin` — точка входа командной строки.
+ *
+ * Разбор аргументов и печать отделены от процесса: {@link runCli} получает argv и куда писать,
+ * а возвращает код выхода. Так команды проверяются тестом целиком, без запуска дочернего
+ * процесса, а `process` трогает только последняя строка файла.
+ *
+ * @module @reformer/builder-plugin-cli/cli
+ */
+import { type DevSession } from './commands/dev.js';
+export interface CliIo {
+    readonly out: (line: string) => void;
+    readonly err: (line: string) => void;
+    /** Каталог, относительно которого читаются пути аргументов. */
+    readonly cwd: string;
+    /**
+     * Чем ждать конца `dev`: сеанс наблюдения живёт, пока его не закроют. Процесс ждёт сигнала,
+     * тест — закрывает сразу после первой сборки.
+     */
+    readonly waitDev?: (session: DevSession) => Promise<void>;
+}
+/** Версия CLI из его собственного package.json: `dist/cli.js` → `../package.json`. */
+export declare function cliVersion(): string;
+export declare function runCli(argv: readonly string[], io: CliIo): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AASH,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK9D,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAeD,sFAAsF;AACtF,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA8IhF"}

package/dist/cli.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+/**
+ * `reformer-plugin` — точка входа командной строки.
+ *
+ * Разбор аргументов и печать отделены от процесса: {@link runCli} получает argv и куда писать,
+ * а возвращает код выхода. Так команды проверяются тестом целиком, без запуска дочернего
+ * процесса, а `process` трогает только последняя строка файла.
+ *
+ * @module @reformer/builder-plugin-cli/cli
+ */
+import { readFileSync, realpathSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseArgs } from 'node:util';
+import { buildPlugin } from './commands/build.js';
+import { createPlugin } from './commands/create.js';
+import { startDev } from './commands/dev.js';
+import { formatFinding } from './commands/findings.js';
+import { packPlugin } from './commands/pack.js';
+import { validatePlugin } from './commands/validate.js';
+const USAGE = `Использование: reformer-plugin <команда> [аргументы]
+
+Команды:
+  create <каталог> [--id <id>] [--name <имя>]  новый плагин из шаблона
+  validate [каталог]                           проверить плагин правилами оболочки
+  build [каталог] [--out <каталог>]            собрать в каталог, который оболочка грузит как есть
+  dev [каталог] --project <каталог проекта>    собирать в .ui_builder/plugins/<id>/ на каждое сохранение
+  pack [каталог] [--out <каталог>]             собрать и упаковать в npm-архив
+
+Параметры:
+  -h, --help     эта справка
+  -v, --version  версия CLI`;
+/** Версия CLI из его собственного package.json: `dist/cli.js` → `../package.json`. */
+export function cliVersion() {
+    const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+    return pkg.version;
+}
+export async function runCli(argv, io) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: [...argv],
+            allowPositionals: true,
+            options: {
+                id: { type: 'string' },
+                name: { type: 'string' },
+                out: { type: 'string' },
+                project: { type: 'string' },
+                help: { type: 'boolean', short: 'h' },
+                version: { type: 'boolean', short: 'v' },
+            },
+        });
+    }
+    catch (error) {
+        io.err(error instanceof Error ? error.message : String(error));
+        io.err(USAGE);
+        return 2;
+    }
+    const { values, positionals } = parsed;
+    if (values.version === true) {
+        io.out(cliVersion());
+        return 0;
+    }
+    const [command, target, ...rest] = positionals;
+    if (values.help === true || command === undefined) {
+        io.out(USAGE);
+        return command === undefined && values.help !== true ? 2 : 0;
+    }
+    if (rest.length > 0) {
+        io.err(`лишние аргументы: ${rest.join(' ')}`);
+        return 2;
+    }
+    const path = (value) => resolve(io.cwd, value);
+    const printFindings = (findings) => {
+        for (const finding of findings)
+            io.err(formatFinding(finding));
+    };
+    /** Печатает отказы или заметки сборки; `true` — сборка удалась. */
+    const printBuild = (result) => {
+        if (!result.ok) {
+            printFindings(result.findings);
+            return false;
+        }
+        for (const notice of result.notices)
+            io.out(`! ${notice}`);
+        return true;
+    };
+    // Параметры принимаются только теми командами, которым они что-то значат: молча
+    // проигнорированный `--out` у validate хуже отказа.
+    const accepted = {
+        create: ['id', 'name'],
+        validate: [],
+        build: ['out'],
+        dev: ['project'],
+        pack: ['out'],
+    };
+    const extra = Object.keys(values).filter((key) => key !== 'help' && key !== 'version' && !(accepted[command] ?? []).includes(key));
+    if (command in accepted && extra.length > 0) {
+        io.err(`${command}: параметры ${extra.map((key) => `--${key}`).join(', ')} не принимаются`);
+        return 2;
+    }
+    switch (command) {
+        case 'create': {
+            if (target === undefined) {
+                io.err('create: не указан каталог нового плагина');
+                return 2;
+            }
+            const result = await createPlugin({
+                dir: path(target),
+                id: values.id,
+                name: values.name,
+                cliVersion: cliVersion(),
+            });
+            if (!result.ok) {
+                io.err(`✗ ${result.message}`);
+                return 1;
+            }
+            io.out(`✓ плагин создан в ${result.dir}`);
+            for (const file of result.files)
+                io.out(`  ${file}`);
+            return 0;
+        }
+        case 'validate': {
+            const result = await validatePlugin(path(target ?? '.'));
+            if (result.ok) {
+                io.out(`✓ ${result.manifest.id} ${result.manifest.version}: оболочка его примет`);
+                return 0;
+            }
+            printFindings(result.findings);
+            return 1;
+        }
+        case 'build': {
+            const result = await buildPlugin({
+                dir: path(target ?? '.'),
+                outDir: values.out === undefined ? undefined : path(values.out),
+            });
+            if (!printBuild(result))
+                return 1;
+            io.out(`✓ ${result.manifest.id} ${result.manifest.version} собран в ${result.outDir}`);
+            return 0;
+        }
+        case 'dev': {
+            if (values.project === undefined) {
+                io.err('dev: не указан --project — корень проекта, в котором плагин будет подхвачен');
+                return 2;
+            }
+            const session = startDev({
+                dir: path(target ?? '.'),
+                project: path(values.project),
+                onBuild: (result) => {
+                    if (printBuild(result)) {
+                        io.out(`✓ ${new Date().toLocaleTimeString()} собран в ${result.outDir}`);
+                    }
+                },
+            });
+            await session.ready;
+            await (io.waitDev ?? waitForSignal)(session);
+            session.close();
+            return 0;
+        }
+        case 'pack': {
+            const result = await packPlugin({
+                dir: path(target ?? '.'),
+                destination: values.out === undefined ? undefined : path(values.out),
+            });
+            if (!result.ok) {
+                printFindings(result.findings);
+                return 1;
+            }
+            for (const notice of result.notices)
+                io.out(`! ${notice}`);
+            io.out(`✓ ${result.file}`);
+            return 0;
+        }
+        default:
+            io.err(`неизвестная команда «${command}»`);
+            io.err(USAGE);
+            return 2;
+    }
+}
+/** Ждёт Ctrl+C: `dev` работает, пока его не остановят. */
+function waitForSignal() {
+    return new Promise((done) => {
+        process.once('SIGINT', () => done());
+    });
+}
+/** Запущен ли файл как программа, а не импортирован (тестом). Через ссылку npm — тоже. */
+function isMain() {
+    const entry = process.argv[1];
+    if (entry === undefined)
+        return false;
+    try {
+        return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isMain()) {
+    const code = await runCli(process.argv.slice(2), {
+        out: (line) => process.stdout.write(`${line}\n`),
+        err: (line) => process.stderr.write(`${line}\n`),
+        cwd: process.cwd(),
+    });
+    process.exitCode = code;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/build.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `reformer-plugin build`: исходники плагина → каталог, который оболочка грузит как есть.
+ *
+ * ## Что получается
+ *
+ * `manifest.json` (тот же, с `main: "main.js"` и `styles.file: "styles.css"`), один `main.js`,
+ * `styles.css`, если стили объявлены, и словари по тем же путям, что в исходниках.
+ *
+ * - **`main.js` — CommonJS.** Линковщик оболочки исполняет модули как CommonJS, и готовый JS
+ *   идёт у него без транспиляции (`shell/platform/modules/loader`): собери мы ESM, оболочке
+ *   пришлось бы будить транспилятор ради уже собранного файла.
+ * - **Модули рантайма — внешние, ровно по списку** `PLUGIN_RUNTIME_MODULES`. Вложенная копия
+ *   React или ядра форм — второй экземпляр и тихая поломка. Импорт `@reformer/*` или
+ *   `@builder/*`, которого в списке нет, — ОТКАЗ сборки: вложить его нельзя (тот же второй
+ *   экземпляр), а оставить внешним — значит плагин, падающий на спецификаторе при загрузке.
+ * - **Пакеты стеков — вкладываются** (`PLUGIN_BUNDLED_PACKAGES`): чистые функции без синглтонов,
+ *   которых оболочка не подставляет, потому что стека не знает. Вместе с ними вкладывается то,
+ *   что они сами берут из `@reformer/*` вне списка рантайма (глубокие импорты `@reformer/mcp`
+ *   у стека ReFormer), — это их внутренность, а не выбор автора плагина. Модули рантайма и из
+ *   пакета стека остаются внешними.
+ * - **CSS из кода — отказ.** Стили плагина объявляются в манифесте (`styles`), и только тогда
+ *   оболочка их изолирует. Импорт `.css` из кода дал бы таблицу, о которой манифест молчит.
+ *
+ * ## Что проверяется на выходе
+ *
+ * Собранный каталог проходит то, что пройдёт у оболочки: разбор манифеста поставки `project`
+ * (с каталогом, названным по `id`), потолок числа файлов кода и «сухую» активацию
+ * (`./dry-run`) — узнавание плагина в экспортах, `id` кода и `provides`.
+ *
+ * ## Каталог вывода не чужой
+ *
+ * Перед записью каталог очищается, но только если он пуст или в нём лежит сборка ЭТОГО ЖЕ
+ * плагина (манифест с тем же `id`). Иначе — отказ: `--out ~/project` не должен стирать проект.
+ *
+ * @module @reformer/builder-plugin-cli/commands/build
+ */
+import { type PluginSourceManifest } from '@reformer/builder-plugin-api/tooling';
+import type { Finding } from './findings.js';
+export interface BuildOptions {
+    /** Каталог исходников плагина (с `manifest.json`). */
+    readonly dir: string;
+    /** Куда класть сборку; умолчание — `dist` в каталоге исходников. */
+    readonly outDir?: string;
+}
+export type BuildResult = {
+    readonly ok: true;
+    readonly manifest: PluginSourceManifest;
+    readonly outDir: string;
+    readonly files: readonly string[];
+    /** Проверки, которые не удалось довести до конца вне оболочки. Не отказы. */
+    readonly notices: readonly string[];
+} | {
+    readonly ok: false;
+    readonly findings: readonly Finding[];
+};
+export declare function buildPlugin(options: BuildOptions): Promise<BuildResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAMH,OAAO,EAOL,KAAK,oBAAoB,EAC1B,MAAM,sCAAsC,CAAC;AAI9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,CAAC;AA2HlE,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAmG7E"}