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

package/dist/commands/build.js

@@ -0,0 +1,261 @@
+/**
+ * `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 { existsSync, readFileSync } from 'node:fs';
+import { mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { isBundledPluginModule, isPluginCodeFile, parsePluginManifest, PLUGIN_FILE_LIMIT, PLUGIN_MANIFEST_FILE, PLUGIN_RUNTIME_MODULES, } from '@reformer/builder-plugin-api/tooling';
+import * as esbuild from 'esbuild';
+import { dryActivate } from './dry-run.js';
+import { validatePlugin } from './validate.js';
+/** Имена, под которыми сборка кладёт код и стили. */
+const BUILT_MAIN = 'main.js';
+const BUILT_STYLES = 'styles.css';
+const fail = (...findings) => ({ ok: false, findings });
+/** Спецификатор пакета — не путь: ни относительный, ни абсолютный (в том числе `D:\`). */
+function isBareSpecifier(path) {
+    return !path.startsWith('.') && !path.startsWith('/') && !/^[a-zA-Z]:[\\/]/.test(path);
+}
+/**
+ * Имя пакета, которому принадлежит файл, — по ближайшему `package.json` вверх по дереву.
+ *
+ * По ИМЕНИ, а не по пути: пакет стека приходит и из `node_modules`, и ссылкой рабочей области
+ * (`packages/…`), и путь у них разный, а имя одно.
+ */
+const ownerCache = new Map();
+function ownerPackageOf(file) {
+    let dir = dirname(file);
+    const visited = [];
+    for (;;) {
+        const cached = ownerCache.get(dir);
+        if (cached !== undefined) {
+            for (const seen of visited)
+                ownerCache.set(seen, cached);
+            return cached;
+        }
+        visited.push(dir);
+        const manifest = join(dir, 'package.json');
+        if (existsSync(manifest)) {
+            let name = null;
+            try {
+                const value = JSON.parse(readFileSync(manifest, 'utf8')).name;
+                name = typeof value === 'string' ? value : null;
+            }
+            catch {
+                name = null;
+            }
+            for (const seen of visited)
+                ownerCache.set(seen, name);
+            return name;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            for (const seen of visited)
+                ownerCache.set(seen, null);
+            return null;
+        }
+        dir = parent;
+    }
+}
+/**
+ * Модули рантайма — внешние; пакеты стеков и их внутренности — вкладываются; прочее
+ * `@reformer/*` — отказ с объяснением.
+ */
+const runtimeModules = {
+    name: 'reformer-runtime-modules',
+    setup(build) {
+        build.onResolve({ filter: /.*/ }, (args) => {
+            if (args.kind === 'entry-point' || !isBareSpecifier(args.path))
+                return undefined;
+            if (PLUGIN_RUNTIME_MODULES.includes(args.path))
+                return { path: args.path, external: true };
+            if (isBundledPluginModule(args.path))
+                return undefined;
+            const owner = args.importer === '' ? null : ownerPackageOf(args.importer);
+            if (owner !== null && isBundledPluginModule(owner))
+                return undefined;
+            if (args.path.startsWith('@reformer/') || args.path.startsWith('@builder/')) {
+                return {
+                    errors: [
+                        {
+                            text: `модуль «${args.path}» оболочка не подставляет, а вкладывать его в сборку нельзя — ` +
+                                'это был бы второй экземпляр пакета',
+                            detail: 'module-unavailable',
+                        },
+                    ],
+                };
+            }
+            return undefined;
+        });
+    },
+};
+async function prepareOutDir(outDir, id) {
+    let entries;
+    try {
+        entries = await readdir(outDir);
+    }
+    catch {
+        return undefined;
+    }
+    if (entries.length > 0) {
+        let previousId;
+        try {
+            const text = await readFile(join(outDir, PLUGIN_MANIFEST_FILE), 'utf8');
+            previousId = JSON.parse(text).id;
+        }
+        catch {
+            previousId = undefined;
+        }
+        if (previousId !== id) {
+            return {
+                code: 'output-not-ours',
+                message: `каталог вывода «${outDir}» не пуст и не содержит сборку «${id}»: ` +
+                    'очищать чужой каталог сборка не станет',
+            };
+        }
+    }
+    await rm(outDir, { recursive: true, force: true });
+    return undefined;
+}
+function buildFailure(error) {
+    const messages = error.errors;
+    if (messages === undefined || messages.length === 0) {
+        return [
+            { code: 'build-failed', message: error instanceof Error ? error.message : String(error) },
+        ];
+    }
+    return messages.map((message) => ({
+        code: message.detail === 'module-unavailable' ? 'module-unavailable' : 'build-failed',
+        message: message.text,
+        ...(message.location === null ? {} : { file: message.location.file }),
+    }));
+}
+export async function buildPlugin(options) {
+    const dir = resolve(options.dir);
+    const outDir = resolve(dir, options.outDir ?? 'dist');
+    const validated = await validatePlugin(dir);
+    if (!validated.ok)
+        return fail(...validated.findings);
+    const { manifest } = validated;
+    let code;
+    try {
+        const result = await esbuild.build({
+            absWorkingDir: dir,
+            entryPoints: [join(dir, manifest.main)],
+            outfile: join(outDir, BUILT_MAIN),
+            bundle: true,
+            write: false,
+            format: 'cjs',
+            platform: 'browser',
+            target: 'es2020',
+            jsx: 'automatic',
+            logLevel: 'silent',
+            plugins: [runtimeModules],
+        });
+        const css = result.outputFiles.find((file) => file.path.endsWith('.css'));
+        if (css !== undefined) {
+            return fail({
+                code: 'css-from-code',
+                message: 'код импортирует CSS. Стили плагина объявляются в манифесте полем «styles» — ' +
+                    'только такую таблицу оболочка изолирует',
+            });
+        }
+        const js = result.outputFiles.find((file) => file.path.endsWith('.js'));
+        code = js?.text ?? '';
+    }
+    catch (error) {
+        return fail(...buildFailure(error));
+    }
+    let styles;
+    if (manifest.styles !== undefined) {
+        try {
+            const result = await esbuild.build({
+                absWorkingDir: dir,
+                entryPoints: [join(dir, manifest.styles.file)],
+                outfile: join(outDir, BUILT_STYLES),
+                bundle: true,
+                write: false,
+                logLevel: 'silent',
+            });
+            styles = result.outputFiles.find((file) => file.path.endsWith('.css'))?.text ?? '';
+        }
+        catch (error) {
+            return fail(...buildFailure(error));
+        }
+    }
+    // Манифест вывода — ИСХОДНЫЙ JSON с двумя заменами, а не сериализация разобранного:
+    // разбор нормализует и подставляет умолчания, и автор увидел бы в сборке не свой файл.
+    const raw = JSON.parse(await readFile(join(dir, PLUGIN_MANIFEST_FILE), 'utf8'));
+    raw.main = BUILT_MAIN;
+    if (manifest.styles !== undefined) {
+        raw.styles = { ...raw.styles, file: BUILT_STYLES };
+    }
+    const manifestText = `${JSON.stringify(raw, null, 2)}\n`;
+    const files = new Map([
+        [PLUGIN_MANIFEST_FILE, manifestText],
+        [BUILT_MAIN, code],
+    ]);
+    if (styles !== undefined)
+        files.set(BUILT_STYLES, styles);
+    const messages = manifest.contributes?.messages ?? {};
+    for (const file of Object.values(messages)) {
+        files.set(file, await readFile(join(dir, file), 'utf8'));
+    }
+    // Проверки выхода — ДО записи: не прошедшая их сборка не должна затирать прошлую рабочую.
+    const shipped = parsePluginManifest(manifestText, { kind: 'project', dir: manifest.id });
+    if (!shipped.ok)
+        return fail(shipped.problem);
+    const codeFiles = [...files.keys()].filter(isPluginCodeFile).length;
+    if (codeFiles > PLUGIN_FILE_LIMIT) {
+        return fail({
+            code: 'too-many-files',
+            message: `в сборке ${String(codeFiles)} файлов кода, оболочка читает не больше ${String(PLUGIN_FILE_LIMIT)}`,
+        });
+    }
+    const dryRun = await dryActivate(code, manifest);
+    if (dryRun.findings.length > 0)
+        return fail(...dryRun.findings);
+    const refused = await prepareOutDir(outDir, manifest.id);
+    if (refused !== undefined)
+        return fail(refused);
+    for (const [path, content] of files) {
+        const target = join(outDir, path);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, content, 'utf8');
+    }
+    return { ok: true, manifest, outDir, files: [...files.keys()], notices: dryRun.notices };
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

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

package/dist/commands/create.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `reformer-plugin create <каталог>`: новый плагин из шаблона.
+ *
+ * Идентификатор проверяется РАЗБОРОМ манифеста, а не своим выражением: шаблон собирает манифест
+ * и отдаёт его `parsePluginSourceManifest`. Так «годится ли id» решает то же правило, что
+ * у оболочки, и CLI не может разрешить идентификатор, который оболочка не примет.
+ *
+ * В непустой каталог не пишет: перезапись чужих файлов шаблоном — не та ошибка, которую
+ * хочется обнаружить после.
+ *
+ * @module @reformer/builder-plugin-cli/commands/create
+ */
+export interface CreateOptions {
+    /** Каталог нового плагина. Создаётся, если его нет; обязан быть пустым, если есть. */
+    readonly dir: string;
+    /** Идентификатор; умолчание — имя каталога. */
+    readonly id?: string;
+    /** Подпись в списке плагинов; умолчание — идентификатор. */
+    readonly name?: string;
+    readonly cliVersion: string;
+}
+export type CreateResult = {
+    readonly ok: true;
+    readonly dir: string;
+    readonly files: readonly string[];
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+export declare function createPlugin(options: CreateOptions): Promise<CreateResult>;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAUrD,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAmBhF"}

package/dist/commands/create.js

@@ -0,0 +1,43 @@
+/**
+ * `reformer-plugin create <каталог>`: новый плагин из шаблона.
+ *
+ * Идентификатор проверяется РАЗБОРОМ манифеста, а не своим выражением: шаблон собирает манифест
+ * и отдаёт его `parsePluginSourceManifest`. Так «годится ли id» решает то же правило, что
+ * у оболочки, и CLI не может разрешить идентификатор, который оболочка не примет.
+ *
+ * В непустой каталог не пишет: перезапись чужих файлов шаблоном — не та ошибка, которую
+ * хочется обнаружить после.
+ *
+ * @module @reformer/builder-plugin-cli/commands/create
+ */
+import { mkdir, readdir, writeFile } from 'node:fs/promises';
+import { basename, dirname, join, resolve } from 'node:path';
+import { parsePluginSourceManifest } from '@reformer/builder-plugin-api/tooling';
+import { manifestTemplate, pluginTemplate } from './template.js';
+async function isEmptyOrMissing(dir) {
+    try {
+        return (await readdir(dir)).length === 0;
+    }
+    catch (error) {
+        return error.code === 'ENOENT';
+    }
+}
+export async function createPlugin(options) {
+    const dir = resolve(options.dir);
+    const id = options.id ?? basename(dir);
+    const name = options.name ?? id;
+    const checked = parsePluginSourceManifest(manifestTemplate({ id, name }));
+    if (!checked.ok)
+        return { ok: false, message: checked.problem.message };
+    if (!(await isEmptyOrMissing(dir))) {
+        return { ok: false, message: `каталог «${dir}» не пуст: шаблон не перезаписывает файлы` };
+    }
+    const files = pluginTemplate({ id, name, cliVersion: options.cliVersion });
+    for (const [path, content] of Object.entries(files)) {
+        const target = join(dir, path);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, content, 'utf8');
+    }
+    return { ok: true, dir, files: Object.keys(files) };
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAgBjE,KAAK,UAAU,gBAAgB,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAsB;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAEhC,MAAM,OAAO,GAAG,yBAAyB,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1E,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAExE,IAAI,CAAC,CAAC,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,GAAG,2CAA2C,EAAE,CAAC;IAC5F,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3E,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AACtD,CAAC"}

package/dist/commands/dev.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `reformer-plugin dev --project <каталог>`: сборка прямо в каталог плагинов открытого проекта
+ * и пересборка на каждое сохранение.
+ *
+ * Пишет в `<проект>/.ui_builder/plugins/<id>/` — туда, где загрузчик оболочки плагин и найдёт.
+ * Отдельного подкаталога «для разработки» нет: загрузчик считает плагином каждый
+ * подкаталог каталога плагинов, и `development/` стал бы плагином с именем `development`.
+ *
+ * Перезагрузку делает оболочка, а не CLI: плагин, помеченный в списке «в разработке», перечитывается
+ * при возврате фокуса в окно (`shell/platform/plugin/dev-watch`). Так правка во внешнем редакторе
+ * доходит до билдера без канала между ними — File System Access наблюдать за файлами не даёт.
+ *
+ * Наблюдение — `fs.watch` с `recursive`, поэтому Node не ниже 20. Каталоги `node_modules`, вывода
+ * и скрытые не наблюдаются: сборка сама пишет файлы, и реакция на свою же запись зациклила бы её.
+ *
+ * @module @reformer/builder-plugin-cli/commands/dev
+ */
+import { type BuildResult } from './build.js';
+export interface DevOptions {
+    /** Каталог исходников плагина. */
+    readonly dir: string;
+    /** Корень проекта билдера, в котором плагин будет подхвачен. */
+    readonly project: string;
+    /** Пауза после последнего изменения перед пересборкой, мс. */
+    readonly debounceMs?: number;
+    /** Вызывается после каждой сборки, первой — сразу. */
+    readonly onBuild: (result: BuildResult) => void;
+}
+export interface DevSession {
+    /** Первая сборка: завершается, когда её результат уже отдан в `onBuild`. */
+    readonly ready: Promise<void>;
+    close(): void;
+}
+export declare function startDev(options: DevOptions): DevSession;
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,KAAK,IAAI,IAAI,CAAC;CACf;AAeD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CA0CxD"}

package/dist/commands/dev.js

@@ -0,0 +1,79 @@
+/**
+ * `reformer-plugin dev --project <каталог>`: сборка прямо в каталог плагинов открытого проекта
+ * и пересборка на каждое сохранение.
+ *
+ * Пишет в `<проект>/.ui_builder/plugins/<id>/` — туда, где загрузчик оболочки плагин и найдёт.
+ * Отдельного подкаталога «для разработки» нет: загрузчик считает плагином каждый
+ * подкаталог каталога плагинов, и `development/` стал бы плагином с именем `development`.
+ *
+ * Перезагрузку делает оболочка, а не CLI: плагин, помеченный в списке «в разработке», перечитывается
+ * при возврате фокуса в окно (`shell/platform/plugin/dev-watch`). Так правка во внешнем редакторе
+ * доходит до билдера без канала между ними — File System Access наблюдать за файлами не даёт.
+ *
+ * Наблюдение — `fs.watch` с `recursive`, поэтому Node не ниже 20. Каталоги `node_modules`, вывода
+ * и скрытые не наблюдаются: сборка сама пишет файлы, и реакция на свою же запись зациклила бы её.
+ *
+ * @module @reformer/builder-plugin-cli/commands/dev
+ */
+import { watch } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join, resolve, sep } from 'node:path';
+import { PLUGIN_CATALOG_DIR, PLUGIN_MANIFEST_FILE } from '@reformer/builder-plugin-api/tooling';
+import { buildPlugin } from './build.js';
+const IGNORED = new Set(['node_modules', 'dist']);
+/** Каталог вывода для плагина в проекте. `id` читается из манифеста на каждой сборке. */
+async function outDirFor(dir, project) {
+    try {
+        const text = await readFile(join(dir, PLUGIN_MANIFEST_FILE), 'utf8');
+        const id = JSON.parse(text).id;
+        return typeof id === 'string' && id !== '' ? join(project, PLUGIN_CATALOG_DIR, id) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function startDev(options) {
+    const dir = resolve(options.dir);
+    const project = resolve(options.project);
+    const debounceMs = options.debounceMs ?? 100;
+    let running = Promise.resolve();
+    let pending = false;
+    let timer;
+    let closed = false;
+    // Сборки строго по одной: изменение во время сборки не теряется, а откладывает ещё одну.
+    const rebuild = () => {
+        if (pending)
+            return running;
+        pending = true;
+        running = running.then(async () => {
+            pending = false;
+            if (closed)
+                return;
+            // Без манифеста (или без id) каталог вывода не вычислить — сборка сама объяснит почему.
+            const outDir = (await outDirFor(dir, project)) ?? join(dir, 'dist');
+            options.onBuild(await buildPlugin({ dir, outDir }));
+        });
+        return running;
+    };
+    const ready = rebuild();
+    const watcher = watch(dir, { recursive: true }, (_, filename) => {
+        if (filename === null)
+            return;
+        const first = filename.split(sep)[0] ?? '';
+        if (first.startsWith('.') || IGNORED.has(first))
+            return;
+        if (timer !== undefined)
+            clearTimeout(timer);
+        timer = setTimeout(() => void rebuild(), debounceMs);
+    });
+    return {
+        ready,
+        close() {
+            closed = true;
+            if (timer !== undefined)
+                clearTimeout(timer);
+            watcher.close();
+        },
+    };
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

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

package/dist/commands/dry-run.d.ts

@@ -0,0 +1,38 @@
+/**
+ * «Сухая» активация собранного плагина: исполнить `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 { type PluginManifestBase } from '@reformer/builder-plugin-api/tooling';
+import type { Finding } from './findings.js';
+export interface DryRunResult {
+    readonly findings: readonly Finding[];
+    /** Почему проверку не удалось довести до конца. Не отказ. */
+    readonly notices: readonly string[];
+}
+/**
+ * @param code собранный `main.js` (CommonJS)
+ * @param manifest манифест, против которого сверяются `id` и `provides`
+ */
+export declare function dryActivate(code: string, manifest: Pick<PluginManifestBase, 'id' | 'provides'>): Promise<DryRunResult>;
+//# sourceMappingURL=dry-run.d.ts.map

package/dist/commands/dry-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../../src/commands/dry-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AA6BD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,UAAU,CAAC,GACpD,OAAO,CAAC,YAAY,CAAC,CAoGvB"}