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

package/dist/commands/dry-run.js

@@ -0,0 +1,148 @@
+/**
+ * «Сухая» активация собранного плагина: исполнить `main.js` под Node и посмотреть, что он
+ * зарегистрирует, — ради двух отказов, которые оболочка иначе покажет только при включении.
+ *
+ * - **`not-a-plugin` и `id-mismatch`** — экспорты точки входа узнаются правилом загрузчика
+ *   (`pluginFromExports` из контракта), `id` сверяется с манифестом.
+ * - **`provides-unregistered`** — оболочка после `activate` смотрит, занят ли в реестре служб
+ *   слот каждой объявленной возможности. Здесь то же: реестр служб контекста записывает,
+ *   под какими идентификаторами плагин что-то зарегистрировал.
+ *
+ * ## Что настоящее, а что нет
+ *
+ * Настоящий — пакет контракта (`@reformer/builder-plugin-api`, он же `@builder/sdk`): токены
+ * служб в нём — объекты с `id`, и регистрация под подменным токеном дала бы ложный отказ.
+ * Остальные модули рантайма (React, ядро форм, кит) и всё в контексте, кроме реестра служб, —
+ * заглушки, принимающие любое обращение. Подними мы их по-настоящему, проверка требовала бы DOM
+ * и всего билдера.
+ *
+ * Отсюда граница честности. Если код падает НА ЗАГЛУШКЕ — при исполнении модуля или в `activate`,
+ * — это не отказ: вне оболочки такое бывает у рабочих плагинов (например, `activate` читает
+ * значение службы, которой здесь нет). Такой исход возвращается ЗАМЕТКОЙ «не проверено»,
+ * а не отказом, и сборка проходит. Отказом становится только то, что видно наверняка.
+ *
+ * @module @reformer/builder-plugin-cli/commands/dry-run
+ */
+import { pluginFromExports, PLUGIN_RUNTIME_MODULES, } from '@reformer/builder-plugin-api/tooling';
+const PLUGIN_API_SPECIFIERS = new Set(['@builder/sdk', '@reformer/builder-plugin-api']);
+/**
+ * Заглушка, принимающая любое обращение: свойство, вызов, `new`.
+ *
+ * `then` отсутствует намеренно — иначе `await stub` никогда бы не завершился. Приведение
+ * к строке и числу даёт пустое значение, чтобы шаблонные строки в коде плагина не падали.
+ */
+function createStub() {
+    const target = function stub() { };
+    const proxy = new Proxy(target, {
+        get(_, key) {
+            if (key === 'then')
+                return undefined;
+            if (key === Symbol.toPrimitive)
+                return () => '';
+            if (key === Symbol.iterator)
+                return function* () { };
+            return proxy;
+        },
+        apply: () => proxy,
+        construct: () => proxy,
+    });
+    return proxy;
+}
+function describe(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * @param code собранный `main.js` (CommonJS)
+ * @param manifest манифест, против которого сверяются `id` и `provides`
+ */
+export async function dryActivate(code, manifest) {
+    const pluginApi = (await import('@reformer/builder-plugin-api'));
+    const requireShim = (specifier) => {
+        if (PLUGIN_API_SPECIFIERS.has(specifier))
+            return pluginApi;
+        if (PLUGIN_RUNTIME_MODULES.includes(specifier))
+            return createStub();
+        // Сюда сборка не пропускает: всё, что не модуль рантайма, вложено в `main.js`.
+        throw new Error(`модуль «${specifier}» оболочка не подставляет`);
+    };
+    const module = { exports: {} };
+    try {
+        const evaluate = new Function('module', 'exports', 'require', code);
+        evaluate(module, module.exports, requireShim);
+    }
+    catch (error) {
+        return {
+            findings: [],
+            notices: [`модуль не исполнился вне оболочки (${describe(error)}) — экспорты не проверены`],
+        };
+    }
+    const plugin = pluginFromExports(module.exports);
+    if (plugin === undefined) {
+        return {
+            findings: [
+                {
+                    code: 'not-a-plugin',
+                    message: 'main.js не экспортировал плагин: ожидается объект с «id» и «activate» ' +
+                        'в module.exports или в экспорте по умолчанию',
+                    file: 'main.js',
+                },
+            ],
+            notices: [],
+        };
+    }
+    if (plugin.id !== manifest.id) {
+        return {
+            findings: [
+                {
+                    code: 'id-mismatch',
+                    message: `код объявляет плагин «${plugin.id}», а манифест — «${manifest.id}»`,
+                    file: 'main.js',
+                },
+            ],
+            notices: [],
+        };
+    }
+    const provides = manifest.provides ?? [];
+    if (provides.length === 0)
+        return { findings: [], notices: [] };
+    const registered = new Set();
+    const disposable = { dispose: () => undefined };
+    const services = {
+        register: (token) => {
+            registered.add(token.id);
+            return disposable;
+        },
+        get: () => undefined,
+        require: () => createStub(),
+        onDidChange: () => disposable,
+    };
+    const stub = createStub();
+    const ctx = new Proxy({ id: manifest.id, services, subscriptions: [] }, {
+        get: (target, key) => key in target ? target[key] : stub[key],
+    });
+    try {
+        await Promise.resolve(plugin.activate(ctx));
+    }
+    catch (error) {
+        return {
+            findings: [],
+            notices: [`activate упал вне оболочки (${describe(error)}) — «provides» не проверен`],
+        };
+    }
+    const missing = provides.filter((item) => !registered.has(item.id));
+    if (missing.length === 0)
+        return { findings: [], notices: [] };
+    const names = missing.map((item) => `«${item.id}» версии ${item.version}`).join(', ');
+    return {
+        findings: [
+            {
+                code: 'provides-unregistered',
+                message: `манифест обещает ${names}, но activate это не зарегистрировал. ` +
+                    'Оболочка выключит такой плагин при включении',
+                file: 'manifest.json',
+            },
+        ],
+        notices: [],
+    };
+}
+//# sourceMappingURL=dry-run.js.map

package/dist/commands/dry-run.js.map

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

package/dist/commands/findings.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Замечания команд CLI — одним типом на `validate`, `build`, `dev` и `pack`.
+ *
+ * Отказы, которые знает оболочка, идут её кодами ({@link PluginProblem}): автор ищет их
+ * в документации оболочки, и второй словарь для тех же бед только мешал бы. Свои коды у CLI —
+ * только для того, чего оболочка не видит: `package.json`, сборки и каталога вывода.
+ *
+ * @module @reformer/builder-plugin-cli/commands/findings
+ */
+import type { PluginProblem } from '@reformer/builder-plugin-api/tooling';
+export type CliFindingCode = 
+/** Версия `package.json` не совпадает с версией манифеста. */
+'package-version'
+/** Сборщик отказал: синтаксис, неразрешённый импорт. */
+ | 'build-failed'
+/** Импорт `@reformer/*`, которого оболочка не подставляет. */
+ | 'module-unavailable'
+/** Код импортирует CSS: стили плагина объявляются в манифесте. */
+ | 'css-from-code'
+/** Каталог вывода не пуст и не содержит сборку этого же плагина. */
+ | 'output-not-ours'
+/** `npm pack` отказал. */
+ | 'pack-failed';
+export type Finding = PluginProblem | {
+    readonly code: CliFindingCode;
+    readonly message: string;
+    readonly file?: string;
+};
+/** Одна строка для терминала: `✗ файл: сообщение`. */
+export declare function formatFinding(finding: Finding): string;
+//# sourceMappingURL=findings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../../src/commands/findings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E,MAAM,MAAM,cAAc;AACxB,8DAA8D;AAC5D,iBAAiB;AACnB,wDAAwD;GACtD,cAAc;AAChB,8DAA8D;GAC5D,oBAAoB;AACtB,kEAAkE;GAChE,eAAe;AACjB,oEAAoE;GAClE,iBAAiB;AACnB,0BAA0B;GACxB,aAAa,CAAC;AAElB,MAAM,MAAM,OAAO,GACf,aAAa,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEtD"}

package/dist/commands/findings.js

@@ -0,0 +1,14 @@
+/**
+ * Замечания команд CLI — одним типом на `validate`, `build`, `dev` и `pack`.
+ *
+ * Отказы, которые знает оболочка, идут её кодами ({@link PluginProblem}): автор ищет их
+ * в документации оболочки, и второй словарь для тех же бед только мешал бы. Свои коды у CLI —
+ * только для того, чего оболочка не видит: `package.json`, сборки и каталога вывода.
+ *
+ * @module @reformer/builder-plugin-cli/commands/findings
+ */
+/** Одна строка для терминала: `✗ файл: сообщение`. */
+export function formatFinding(finding) {
+    return `✗ ${finding.file === undefined ? '' : `${finding.file}: `}${finding.message}`;
+}
+//# sourceMappingURL=findings.js.map

package/dist/commands/findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../../src/commands/findings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,sDAAsD;AACtD,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,KAAK,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;AACxF,CAAC"}

package/dist/commands/pack.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `reformer-plugin pack`: собранный плагин → npm-архив `<имя>-<версия>.tgz`.
+ *
+ * В архиве ровно каталог сборки плюс `package.json`: установка из npm (фаза 9 плана) распакует
+ * его в каталог плагина, и загрузчик найдёт там то же, что после `build`. Исходники, тесты
+ * и `node_modules` в архив не попадают — упаковывается временный каталог, а не каталог автора.
+ *
+ * `package.json` архива собирается из исходного: имя, версия, описание, лицензия и ключевые
+ * слова, к которым добавляется `reformer-builder-plugin` — по нему плагин ищется в реестре.
+ * `private` снимается, зависимостей нет: всё, что плагину нужно, вложено в `main.js`
+ * или подставляется оболочкой. Версия берётся из манифеста — `validate` уже проверил, что
+ * с `package.json` она совпадает.
+ *
+ * Сам архив делает `npm pack`: формат tarball'а npm — не то, что стоит повторять руками.
+ *
+ * @module @reformer/builder-plugin-cli/commands/pack
+ */
+import type { Finding } from './findings.js';
+export interface PackOptions {
+    readonly dir: string;
+    /** Куда положить архив; умолчание — каталог исходников. */
+    readonly destination?: string;
+}
+export type PackResult = {
+    readonly ok: true;
+    readonly file: string;
+    readonly notices: readonly string[];
+} | {
+    readonly ok: false;
+    readonly findings: readonly Finding[];
+};
+export declare function packPlugin(options: PackOptions): Promise<PackResult>;
+//# sourceMappingURL=pack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAO7C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,CAAC;AAElE,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsD1E"}

package/dist/commands/pack.js

@@ -0,0 +1,78 @@
+/**
+ * `reformer-plugin pack`: собранный плагин → npm-архив `<имя>-<версия>.tgz`.
+ *
+ * В архиве ровно каталог сборки плюс `package.json`: установка из npm (фаза 9 плана) распакует
+ * его в каталог плагина, и загрузчик найдёт там то же, что после `build`. Исходники, тесты
+ * и `node_modules` в архив не попадают — упаковывается временный каталог, а не каталог автора.
+ *
+ * `package.json` архива собирается из исходного: имя, версия, описание, лицензия и ключевые
+ * слова, к которым добавляется `reformer-builder-plugin` — по нему плагин ищется в реестре.
+ * `private` снимается, зависимостей нет: всё, что плагину нужно, вложено в `main.js`
+ * или подставляется оболочкой. Версия берётся из манифеста — `validate` уже проверил, что
+ * с `package.json` она совпадает.
+ *
+ * Сам архив делает `npm pack`: формат tarball'а npm — не то, что стоит повторять руками.
+ *
+ * @module @reformer/builder-plugin-cli/commands/pack
+ */
+import { exec } from 'node:child_process';
+import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { promisify } from 'node:util';
+import { buildPlugin } from './build.js';
+const run = promisify(exec);
+/** Ключевое слово, по которому плагины билдера ищутся в реестре npm. */
+const PLUGIN_KEYWORD = 'reformer-builder-plugin';
+export async function packPlugin(options) {
+    const dir = resolve(options.dir);
+    const destination = resolve(dir, options.destination ?? '.');
+    const staging = await mkdtemp(join(tmpdir(), 'reformer-plugin-pack-'));
+    try {
+        const built = await buildPlugin({ dir, outDir: staging });
+        if (!built.ok)
+            return built;
+        const { manifest } = built;
+        let source = {};
+        try {
+            source = JSON.parse(await readFile(join(dir, 'package.json'), 'utf8'));
+        }
+        catch {
+            // Без package.json имя пакета — идентификатор плагина.
+        }
+        const keywords = Array.isArray(source.keywords) ? source.keywords : [];
+        const pkg = {
+            name: typeof source.name === 'string' ? source.name : manifest.id.toLowerCase(),
+            version: manifest.version,
+            ...(typeof source.description === 'string' ? { description: source.description } : {}),
+            ...(typeof source.license === 'string' ? { license: source.license } : {}),
+            keywords: [...new Set([...keywords, PLUGIN_KEYWORD])],
+        };
+        await writeFile(join(staging, 'package.json'), `${JSON.stringify(pkg, null, 2)}\n`, 'utf8');
+        try {
+            // Одной строкой через оболочку — ради Windows: `npm` там командный файл и без оболочки
+            // не запускается, а массив аргументов вместе с `shell` Node объявил устаревшим (DEP0190).
+            // Единственный подставляемый аргумент — путь, и он в кавычках JSON.
+            const { stdout } = await run(`npm pack --json --pack-destination ${JSON.stringify(destination)}`, { cwd: staging });
+            const [info] = JSON.parse(stdout);
+            if (info === undefined)
+                throw new Error('npm pack не назвал архив');
+            return { ok: true, file: join(destination, info.filename), notices: built.notices };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                findings: [
+                    {
+                        code: 'pack-failed',
+                        message: `npm pack отказал: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+            };
+        }
+    }
+    finally {
+        await rm(staging, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=pack.js.map

package/dist/commands/pack.js.map

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

package/dist/commands/template.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Шаблон нового плагина: файлы, которые `reformer-plugin create` кладёт в пустой каталог.
+ *
+ * Шаблон — функции, а не файлы в пакете. Файлы пришлось бы копировать при сборке и не забыть
+ * в поле `files`, а их содержимое всё равно зависит от идентификатора и версий: подстановка
+ * в строках честнее мини-шаблонизатора.
+ *
+ * ## Что в шаблоне и почему
+ *
+ * - **`manifest.json` исходников** — `main` указывает на `src/main.ts`, словари объявлены.
+ *   Сразу проходит `reformer-plugin validate`: это проверяется тестом, иначе первым опытом
+ *   автора был бы отказ на только что созданном плагине.
+ * - **`src/main.ts`** — одна команда и её подпись из словаря. Минимум, который виден в оболочке
+ *   (палитра команд) и при этом показывает оба обязательных приёма: вклад через `subscriptions`
+ *   и строку через ключ, а не текстом.
+ * - **`locales/ru.json`, `locales/en.json`** — плоские словари.
+ * - **`src/main.test.ts`** — проверка, которую иначе сделает только оболочка: `id` кода совпадает
+ *   с `id` манифеста. Расхождение — отказ загрузки (`id-mismatch`), и лучше увидеть его в тесте.
+ * - **`package.json`** — `@reformer/builder-plugin-api` в `devDependencies`: в рантайме модуль
+ *   даёт оболочка, в сборку он не попадает (см. README пакета контракта).
+ *
+ * @module @reformer/builder-plugin-cli/commands/template
+ */
+export interface TemplateInput {
+    readonly id: string;
+    readonly name: string;
+    /** Версия самого CLI — для диапазона в `devDependencies` шаблона. */
+    readonly cliVersion: string;
+}
+/** Путь внутри каталога плагина → содержимое. */
+export type TemplateFiles = Readonly<Record<string, string>>;
+export declare function manifestTemplate({ id, name }: Pick<TemplateInput, 'id' | 'name'>): string;
+export declare function pluginTemplate(input: TemplateInput): TemplateFiles;
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAS7D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG,MAAM,CAWzF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAmElE"}

package/dist/commands/template.js

@@ -0,0 +1,109 @@
+/**
+ * Шаблон нового плагина: файлы, которые `reformer-plugin create` кладёт в пустой каталог.
+ *
+ * Шаблон — функции, а не файлы в пакете. Файлы пришлось бы копировать при сборке и не забыть
+ * в поле `files`, а их содержимое всё равно зависит от идентификатора и версий: подстановка
+ * в строках честнее мини-шаблонизатора.
+ *
+ * ## Что в шаблоне и почему
+ *
+ * - **`manifest.json` исходников** — `main` указывает на `src/main.ts`, словари объявлены.
+ *   Сразу проходит `reformer-plugin validate`: это проверяется тестом, иначе первым опытом
+ *   автора был бы отказ на только что созданном плагине.
+ * - **`src/main.ts`** — одна команда и её подпись из словаря. Минимум, который виден в оболочке
+ *   (палитра команд) и при этом показывает оба обязательных приёма: вклад через `subscriptions`
+ *   и строку через ключ, а не текстом.
+ * - **`locales/ru.json`, `locales/en.json`** — плоские словари.
+ * - **`src/main.test.ts`** — проверка, которую иначе сделает только оболочка: `id` кода совпадает
+ *   с `id` манифеста. Расхождение — отказ загрузки (`id-mismatch`), и лучше увидеть его в тесте.
+ * - **`package.json`** — `@reformer/builder-plugin-api` в `devDependencies`: в рантайме модуль
+ *   даёт оболочка, в сборку он не попадает (см. README пакета контракта).
+ *
+ * @module @reformer/builder-plugin-cli/commands/template
+ */
+import { BUILDER_API_VERSION } from '@reformer/builder-plugin-api/tooling';
+const json = (value) => `${JSON.stringify(value, null, 2)}\n`;
+/** Мажор API оболочки: диапазон, против которого написан новый плагин. */
+function apiMajor() {
+    return BUILDER_API_VERSION.split('.')[0] ?? '1';
+}
+export function manifestTemplate({ id, name }) {
+    return json({
+        id,
+        name,
+        version: '0.1.0',
+        apiVersion: `^${apiMajor()}`,
+        main: 'src/main.ts',
+        contributes: {
+            messages: { ru: 'locales/ru.json', en: 'locales/en.json' },
+        },
+    });
+}
+export function pluginTemplate(input) {
+    const { id, name, cliVersion } = input;
+    const commandId = `${id}.hello`;
+    return {
+        'manifest.json': manifestTemplate(input),
+        'package.json': json({
+            // Имя пакета npm — только строчные; идентификатор плагина вправе быть другим.
+            name: id.toLowerCase(),
+            version: '0.1.0',
+            private: true,
+            type: 'module',
+            scripts: {
+                validate: 'reformer-plugin validate',
+                build: 'reformer-plugin build',
+                pack: 'reformer-plugin pack',
+                test: 'vitest run',
+            },
+            devDependencies: {
+                '@reformer/builder-plugin-api': `^${apiMajor()}.0.0`,
+                '@reformer/builder-plugin-cli': `^${cliVersion}`,
+                typescript: '^5.9.3',
+                vitest: '^4.0.8',
+            },
+        }),
+        'tsconfig.json': json({
+            compilerOptions: {
+                target: 'ES2022',
+                module: 'ESNext',
+                moduleResolution: 'bundler',
+                strict: true,
+                noEmit: true,
+                skipLibCheck: true,
+                resolveJsonModule: true,
+            },
+            include: ['src'],
+        }),
+        '.gitignore': 'node_modules/\ndist/\n',
+        'src/main.ts': `import { definePlugin } from '@reformer/builder-plugin-api';
+
+export default definePlugin({
+  id: '${id}',
+  activate(ctx) {
+    ctx.subscriptions.push(
+      ctx.commands.register({
+        id: '${commandId}',
+        // Ключ словаря плагина, а не текст: строки лежат в locales/*.json.
+        titleKey: 'command.hello',
+        run: () => true,
+      })
+    );
+  },
+});
+`,
+        'src/main.test.ts': `import { expect, it } from 'vitest';
+
+import manifest from '../manifest.json';
+import plugin from './main';
+
+it('идентификатор кода совпадает с манифестом', () => {
+  // Иначе оболочка откажет в загрузке (id-mismatch).
+  expect(plugin.id).toBe(manifest.id);
+});
+`,
+        'locales/ru.json': json({ 'command.hello': `${name}: привет` }),
+        'locales/en.json': json({ 'command.hello': `${name}: hello` }),
+    };
+}
+//# sourceMappingURL=template.js.map

package/dist/commands/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAY3E,MAAM,IAAI,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAE/E,0EAA0E;AAC1E,SAAS,QAAQ;IACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAsC;IAC/E,OAAO,IAAI,CAAC;QACV,EAAE;QACF,IAAI;QACJ,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,IAAI,QAAQ,EAAE,EAAE;QAC5B,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE;YACX,QAAQ,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,iBAAiB,EAAE;SAC3D;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,SAAS,GAAG,GAAG,EAAE,QAAQ,CAAC;IAEhC,OAAO;QACL,eAAe,EAAE,gBAAgB,CAAC,KAAK,CAAC;QACxC,cAAc,EAAE,IAAI,CAAC;YACnB,8EAA8E;YAC9E,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE;YACtB,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE;gBACP,QAAQ,EAAE,0BAA0B;gBACpC,KAAK,EAAE,uBAAuB;gBAC9B,IAAI,EAAE,sBAAsB;gBAC5B,IAAI,EAAE,YAAY;aACnB;YACD,eAAe,EAAE;gBACf,8BAA8B,EAAE,IAAI,QAAQ,EAAE,MAAM;gBACpD,8BAA8B,EAAE,IAAI,UAAU,EAAE;gBAChD,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE,QAAQ;aACjB;SACF,CAAC;QACF,eAAe,EAAE,IAAI,CAAC;YACpB,eAAe,EAAE;gBACf,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,QAAQ;gBAChB,gBAAgB,EAAE,SAAS;gBAC3B,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,IAAI;gBACZ,YAAY,EAAE,IAAI;gBAClB,iBAAiB,EAAE,IAAI;aACxB;YACD,OAAO,EAAE,CAAC,KAAK,CAAC;SACjB,CAAC;QACF,YAAY,EAAE,wBAAwB;QACtC,aAAa,EAAE;;;SAGV,EAAE;;;;eAII,SAAS;;;;;;;;CAQvB;QACG,kBAAkB,EAAE;;;;;;;;;CASvB;QACG,iBAAiB,EAAE,IAAI,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,UAAU,EAAE,CAAC;QAC/D,iBAAiB,EAAE,IAAI,CAAC,EAAE,eAAe,EAAE,GAAG,IAAI,SAAS,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `reformer-plugin validate`: пропустит ли оболочка этот плагин — ДО оболочки.
+ *
+ * Каждое правило здесь взято из пакета контракта, а не написано заново: разбор манифеста,
+ * разбор словаря, расширения кода. Валидатор, пропускающий то, что оболочка отвергнет, хуже
+ * отсутствия валидатора, — поэтому своего у CLI только то, чего оболочка не видит вовсе.
+ *
+ * ## Что проверяется
+ *
+ * 1. **Манифест исходников** — `parsePluginSourceManifest`: всё, что проверяет оболочка, кроме
+ *    имени каталога, плюс обязательная версия. Отказ здесь останавливает проверку: без манифеста
+ *    не известно, какие файлы искать.
+ * 2. **Файлы, на которые манифест ссылается**: точка входа (есть и это код), таблица стилей,
+ *    словари (есть и плоские). Оболочка отказывает на них при загрузке — здесь то же
+ *    отказом, но до неё. Эти проверки собираются ВСЕ: автору полезнее список, чем первая беда.
+ * 3. **Версия `package.json`**, если он есть, совпадает с версией манифеста. Оболочка
+ *    `package.json` не читает, поэтому расхождение она не заметит, — а упаковка опубликует пакет
+ *    одной версии с манифестом другой.
+ *
+ * Чего здесь НЕТ и почему: сверки `provides` с тем, что плагин регистрирует, потолка числа
+ * файлов и сверки `compatibility.builder` с версией билдера. Первое требует исполнить код,
+ * второе относится к собранному каталогу, а третьего CLI знать не может: в каком билдере плагин
+ * запустят, решает не он, и отказ по этому полю был бы отказом по выдуманному числу. Форма
+ * диапазона при этом проверяется — опечатка ловится здесь, а не у человека при загрузке.
+ *
+ * @module @reformer/builder-plugin-cli/commands/validate
+ */
+import { type PluginSourceManifest } from '@reformer/builder-plugin-api/tooling';
+import type { Finding } from './findings.js';
+/** Замечание валидатора; общий тип всех команд — `./findings`. */
+export type ValidationFinding = Finding;
+export type ValidationResult = {
+    readonly ok: true;
+    readonly manifest: PluginSourceManifest;
+} | {
+    readonly ok: false;
+    /** Есть, если манифест разобран, а отказали файлы вокруг него. */
+    readonly manifest?: PluginSourceManifest;
+    readonly findings: readonly ValidationFinding[];
+};
+/** Проверяет каталог исходников плагина. Ничего не бросает: отказы — данные. */
+export declare function validatePlugin(dir: string): Promise<ValidationResult>;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,EAKL,KAAK,oBAAoB,EAC1B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAExC,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,GAC9D;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD,CAAC;AAkBN,gFAAgF;AAChF,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoF3E"}