@reformer/builder 3.0.0-beta.6 → 3.0.0-beta.8

package/README.md

@@ -1,219 +1,53 @@
 # @reformer/builder
 
-Визуальный билдер JSON-схем форм для экосистемы **ReFormer**. Это самодостаточный офлайн-SPA: вы
-запускаете его локально через `npx`, собираете форму мышкой из компонентов `@reformer/ui-kit`, и билдер
-отдаёт готовую схему / код. Каталог компонентов `@reformer/ui-kit` вшит в бандл — устанавливать сам ui-kit
-для запуска билдера не требуется.
-
-## Установка
-
-```bash
-npm i -D @reformer/builder
-```
-
-> До первого стабильного релиза устанавливайте beta-канал: `npm i -D @reformer/builder@develop`.
+Визуальный конструктор форм ReFormer. Пакет несёт уже собранный офлайн-SPA
+в `dist/` и zero-dependency лаунчер: `npx reformer-builder` поднимает локальный сервер
+и открывает браузер. Серверной логики нет — файлы проекта билдер читает и пишет прямо
+из браузера через File System Access API (нужен Chromium: Chrome/Edge/Arc/Brave).
 
 ## Запуск
 
 ```bash
-npx reformer-builder            # поднимет локальный сервер и откроет браузер
-npx reformer-builder --port 5000
-npx reformer-builder --no-open  # не открывать браузер автоматически
-
-# локальная кастомизация клиента: свой каталог компонентов и/или конфиг билдера
-npx reformer-builder --catalog ./component-catalog.json --config ./reformer-builder.config.json
+npx reformer-builder [--port 4321] [--host 127.0.0.1] [--no-open] [--config <path>]
 ```
 
-Или добавьте скрипт в свой `package.json`:
-
-```json
-{
-  "scripts": {
-    "builder": "reformer-builder"
-  }
-}
-```
-
-```bash
-npm run builder
-```
-
-### Опции CLI
-
-| Опция              | По умолчанию | Описание                                            |
-| ------------------ | ------------ | --------------------------------------------------- |
-| `-p, --port <n>`   | `4321`       | Порт (если занят — берётся следующий свободный)     |
-| `--host <h>`       | `127.0.0.1`  | Хост                                                |
-| `--no-open`        | —            | Не открывать браузер автоматически                  |
-| `--catalog <path>` | —            | JSON-каталог компонентов (замещает вшитый)          |
-| `--config <path>`  | —            | JSON-конфиг билдера (палитра, UI, брендинг, проект) |
-| `-h, --help`       | —            | Справка                                             |
-| `-v, --version`    | —            | Версия                                              |
-
-Без `--catalog`/`--config` билдер пытается подхватить `component-catalog.json` и
-`reformer-builder.config.json` из текущей папки; если их нет — работает на вшитых дефолтах.
-
-## Режимы работы
-
-- **Mode B (основной)** — открыть папку своего проекта прямо в браузере, найти в ней JSON-схемы форм,
-  редактировать их визуально и записывать обратно в исходники (dev-сервер подхватит изменения через HMR).
-  Использует **File System Access API**, поэтому работает **только в Chromium-браузерах** (Chrome, Edge,
-  Arc, Brave).
-- **Mode A** — создать новую схему с нуля и выгрузить/скопировать JSON или сгенерированный код.
-
-## Ассистент
-
-Ассистент живёт в правой панели наравне с инспектором: вкладки «Свойства» и «Ассистент» на правом
-рейле переключают зону, `⌘/Ctrl+Shift+K` открывает ассистента, `⌥⌘B` сворачивает зону целиком.
-Он правит форму по описанию на обычном языке: «добавь email», «сделай телефон обязательным»,
-«поставь имя и фамилию в одну строку».
+## Конфигурация — каталог `.ui_builder/`
 
-Как это устроено и почему так:
+Один конвенционный каталог на два момента чтения:
 
-- **Модель не пишет JSON.** Она вызывает операции редактора (вставить узел, задать свойство,
-  перенести, сгруппировать), а схему собирает сам билдер — теми же функциями, что палитра и
-  инспектор. Имена компонентов модель обязана брать из каталога; выдуманное имя отклоняется.
-- **Изменения показываются до применения.** Ход агента правит копию схемы; вы видите список
-  изменений и решаете, применять ли. Применённый ход отменяется **одним** `Ctrl+Z`.
-- **Если форму правили руками, пока агент работал**, применение сообщит о расхождении вместо того,
-  чтобы молча перезаписать вашу правку.
+| Что                                                                                                                                                | Где                                         | Когда читается                                                                                                   |
+| -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `config.json` — брендинг, дефолты UI                                                                                                               | каталог запуска (`--config` переопределяет) | лаунчером при старте                                                                                             |
+| `config.json`                                                                                                                                      | открытый проект                             | при каждом открытии проекта; перекрывает уровень запуска по полю (`defaults` действуют только на уровне запуска) |
+| `plugins/<id>/` — плагины: `manifest.json`, `main.js` (собранный) или `main.ts` (в разработке — транспиляция на лету, авто-перезагрузка по правке) | открытый проект                             | при открытии; включение — явное действие человека                                                                |
+| `templates/<slug>/` — шаблоны форм                                                                                                                 | открытый проект                             | службой шаблонов                                                                                                 |
+| `codegen/*.eta` — свои цели генерации                                                                                                              | открытый проект                             | плагином кодогенерации                                                                                           |
 
-### Подключение канала к модели
+Запустили `npx reformer-builder` в корне проекта и его же открыли — вся конфигурация
+в одном `.ui_builder/`, без дублей.
 
-Ключ вводится в самой панели (кнопка ⚙) и хранится **в этом браузере**. Поддерживаются:
+`config.json` (все секции опциональны; `$schema` даёт автодополнение в IDE):
 
-| Канал                        | Куда идёт запрос                | Ключ            |
-| ---------------------------- | ------------------------------- | --------------- |
-| Anthropic                    | напрямую из браузера            | ваш             |
-| OpenAI                       | напрямую из браузера            | ваш             |
-| Локальный OpenAI-совместимый | `localhost` (Ollama, LM Studio) | обычно не нужен |
-
-Список моделей запрашивается у провайдера — вшитого списка нет, устаревать нечему.
-
-**О безопасности честно.** В облачных каналах запрос идёт из браузера напрямую к провайдеру, и ключ
-доступен странице. Это приемлемо для локального инструмента с вашим собственным ключом (Anthropic
-описывает такой сценарий явно — отсюда заголовок `anthropic-dangerous-direct-browser-access`), но
-для публичного стенда — нет. Используйте ключ с ограниченным бюджетом. Для Ollama потребуется
-разрешить обращение со страницы: `OLLAMA_ORIGINS`.
-
-**Содержимое формы — данные, а не команды.** Подписи и тексты внутри схемы могут содержать текст,
-похожий на инструкцию агенту; ассистент их не исполняет.
-
-Без настроенного канала панель объясняет, чего не хватает, а остальной редактор работает как
-обычно. Ни SDK, ни сама панель не попадают в первый чанк: за ассистента не платит размером тот,
-кто им не пользуется.
-
-## Шаблоны форм
-
-Новая форма создаётся из **шаблона** — набора файлов с плейсхолдерами вместо имени формы. Панель
-«Шаблоны» в левом сайдбаре показывает все доступные шаблоны, генерация — ПКМ в дереве файлов →
-«Сгенерировать → Выбрать шаблон…» (имя формы, шаблон и какие его файлы создать).
-
-Три источника шаблонов:
-
-- **встроенные** — «Простая форма» (одна страница полей) и «Пошаговая форма» (визард на два шага с
-  адаптером к ui-kit `FormWizard`). Оба дают полный набор: модель, схема, валидация, поведение формы
-  и UI, реестр, страница-компонент — она тянет остальные файлы, без них не соберётся;
-- **проект** — папки в `.reformer/templates/<slug>/` (каталог переопределяется
-  `project.templatesDir`). Обычные файлы + `template.json` с именем и описанием: шаблон едет в git,
-  правится руками в IDE и работает у всей команды;
-- **локальный** — сохранённый в IndexedDB браузера, доступен и без открытого проекта.
-
-Свой шаблон делается из готовой формы: выделить её файлы в дереве (⌘/Ctrl+клик — добавить к выбору,
-⇧+клик — диапазон) → ПКМ → «Создать шаблон…». Имя формы-источника (базовое имя) заменяется
-плейсхолдерами во всех написаниях, чтобы при генерации подставлялось имя новой формы:
-
-| Плейсхолдер     | Форма `user-profile` |
-| --------------- | -------------------- |
-| `__FormName__`  | `UserProfile`        |
-| `__formName__`  | `userProfile`        |
-| `__form-name__` | `user-profile`       |
-| `__form_name__` | `user_profile`       |
-
-Плейсхолдеры работают и в именах файлов (`__form-name__.css`), поэтому шаблон переживает любое имя
-новой формы. Бинарные файлы (картинки, шрифты) в шаблон не попадают.
-
-## Каталог компонентов (`@reformer/ui-kit/catalog`)
-
-Палитра билдера строится из **каталога компонентов** `@reformer/ui-kit` — это
-сгенерированный JSON-файл (`component-catalog.json`), который `@reformer/ui-kit` отдаёт
-через subpath-экспорт `@reformer/ui-kit/catalog`. Для каждого компонента в нём описаны имя,
-роль (поле / контейнер / массив) и JSON-схема props — из этого билдер собирает список
-доступных компонентов и инспектор свойств.
-
-Каталог **вшивается в бандл на этапе сборки** билдера (Vite инлайнит импорт
-`@reformer/ui-kit/catalog`), поэтому опубликованный `@reformer/builder` самодостаточен и
-показывает набор компонентов той версии `@reformer/ui-kit`, с которой был собран. Этот вшитый
-каталог можно **переопределить при локальном старте** флагом `--catalog` (см. ниже) — без
-пересборки билдера.
-
-`@reformer/ui-kit` — не единственный вариант: билдер держит несколько китов и версий, активный
-выбирается в переключателе тулбара. Как подключить свой кит — другую версию, форк или стороннюю
-дизайн-систему — см. [docs/instructions/add-ui-kit.md](docs/instructions/add-ui-kit.md).
-
-## Локальная кастомизация (`--catalog` / `--config`)
-
-Клиент может передать при локальном старте два JSON-файла — они читаются launcher'ом и
-применяются в браузере на бутстрапе. Оба **опциональны**: если файла нет — берутся встроенные
-дефолты (билдер стартует и работает как обычно). Если переданный файл невалиден — билдер
-показывает экран с ошибкой валидации (не запускается с частичной конфигурацией).
-
-- **`--catalog <path>`** — JSON-каталог компонентов по тому же контракту, что
-  `@reformer/ui-kit/catalog` (`{ version, components: [{ name, role, propsSchema, category? }] }`).
-  Замещает вшитый каталог: палитра и инспектор строятся из него.
-- **`--config <path>`** — конфиг поведения самого билдера. Все секции опциональны:
-
-```jsonc
+```json
 {
   "$schema": "./node_modules/@reformer/builder/runtime-config.schema.json",
-  "version": "1.0",
-  // Брендинг оболочки
-  "branding": {
-    "productName": "Acme Forms",
-    "title": "Acme Builder",
-    "logoUrl": "data:image/svg+xml;...",
-  },
-  // Палитра: категории, порядок разделов, свёрнутые по умолчанию, глифы-бейджи
-  "palette": {
-    "categoryByName": { "AcmeRating": "Поля ввода" },
-    "order": ["Поля ввода", "Выбор и переключатели", "Контейнеры", "Действия"],
-    "collapsedByDefault": ["HTML", "Типографика"],
-    "glyphs": { "AcmeRating": "Ar" },
-  },
-  // Доступные компоненты: whitelist/blacklist + тоглы синтетических записей билдера
-  "components": {
-    "exclude": ["Chart", "Carousel"],
-    "synthetic": {
-      "html": true,
-      "htmlTags": ["div", "section", "fieldset"],
-      "formArray": true,
-      "wizard": false,
-    },
-  },
-  // Дефолты интерфейса при старте
-  "ui": { "theme": "light", "leftPanel": "palette", "rightOpen": true, "preview": "wire" },
-  // Работа с проектом (Mode B discovery), каталог шаблонов + стартовая схема Mode A (null — пустая форма)
-  "project": {
-    "ignoreDirs": ["fixtures"],
-    "templatesDir": ".reformer/templates",
-    "seedSchema": null,
-  },
+  "branding": { "title": "Формы Acme" },
+  "defaults": { "locale": "ru", "theme": "system" }
 }
 ```
 
-Семантика слияния: карты (`palette.categoryByName`, `palette.glyphs`) и списки безопасных
-дефолтов (`project.ignoreDirs`, `project.skipFiles`, `project.formSchemaMarkers`) **дополняют**
-встроенные; `palette.order`, `palette.collapsedByDefault`, `components.*`, `ui.*`, `branding.*` —
-**замещают** дефолт, если заданы. JSON Schema контракта конфига публикуется в пакете как
-`@reformer/builder/runtime-config.schema.json` (для автодополнения в редакторе через `$schema`).
+Сторонний ui-kit встраивается плагином (плагин привозит и каталог компонентов, и код),
+а не файлом данных — механизм в работе.
 
-> **Требование к упаковке `@reformer/ui-kit`:** чтобы subpath `@reformer/ui-kit/catalog`
-> резолвился у внешних потребителей, `component-catalog.json` обязан входить в поле `files`
-> пакета `@reformer/ui-kit` — иначе файла нет в npm-тарболе и импорт падает. Для самого
-> билдера это некритично (каталог уже вшит в его `dist`), но важно для CI-проверки
-> `check:subpaths` и для любых Node-ESM-потребителей этого subpath (импортировать JSON в
-> Node ESM нужно с атрибутом `with { type: 'json' }`).
+## Отличия от 2.x
 
-## Лицензия
+Версия 3 — переписанный билдер, и контракт запуска у него другой:
 
-MIT © Alexandr Bukhtatyy
+- **флага `--catalog` больше нет.** Сторонний ui-kit подключается плагином из
+  `.ui_builder/plugins/`: плагин привозит и каталог компонентов, и их код — файлом данных
+  превью нечем рисовать;
+- **конфиг переехал** из `reformer-builder.config.json` рядом с запуском в
+  `.ui_builder/config.json` (или `--config <path>`), и в нём остались брендинг и дефолты UI:
+  палитра, набор компонентов и раскладка настраиваются плагинами;
+- **битый конфиг больше не роняет билдер**: приложение открывается, а каждая проблема
+  называется в уведомлении.

package/bin/reformer-builder.d.mts

@@ -1,6 +1,6 @@
 /**
- * Типы для тестируемых экспортов launcher'а (`reformer-builder.mjs` — zero-dependency JS без
- * деклараций). Позволяет `.ts`-тестам импортировать хелперы без implicit-any (TS7016).
+ * Типы для тестируемых экспортов лаунчера (`reformer-builder.mjs` — zero-dependency JS без
+ * деклараций). Позволяют `.ts`-тестам импортировать хелперы без implicit-any (TS7016).
  */
 
 export interface LauncherOpts {
@@ -9,24 +9,22 @@ export interface LauncherOpts {
   open: boolean;
   help: boolean;
   version: boolean;
-  /** Путь к каталогу компонентов (`--catalog`) или `null` (авто-детект в cwd). */
-  catalog: string | null;
-  /** Путь к конфигу билдера (`--config`) или `null` (авто-детект в cwd). */
+  /** Путь к конфигу билдера (`--config`) или `null` (авто-детект `.ui_builder/config.json` в cwd). */
   config: string | null;
 }
 
 export interface RuntimeBundleResult {
-  payload: { catalog: unknown; config: unknown };
-  sources: { catalog: string | null; config: string | null };
+  payload: { config: unknown };
+  sources: { config: string | null };
 }
 
-/** URL раздачи клиентского bundle. */
+/** URL раздачи конфига запуска. */
 export const RUNTIME_BUNDLE_URL: string;
 
 export function parseArgs(argv: string[]): LauncherOpts;
 
 export function loadRuntimeBundle(
-  opts: { catalog: string | null; config: string | null },
+  opts: { config: string | null },
   cwd: string
 ): Promise<RuntimeBundleResult>;
 

package/bin/reformer-builder.mjs

@@ -1,19 +1,25 @@
 #!/usr/bin/env node
 /**
- * reformer-builder — локальный запуск визуального билдера ReFormer-схем.
+ * reformer-builder — локальный запуск визуального билдера ReFormer.
  *
- * Опубликованный пакет несёт УЖЕ собранный SPA в `dist/` (каталог компонентов @reformer/ui-kit вшит
- * в бандл на этапе сборки). Этот скрипт — zero-dependency статик-сервер на встроенных модулях Node:
- * поднимает `dist/` на localhost и открывает браузер. Серверной логики у билдера нет — вся работа с
- * файлами проекта идёт в браузере через File System Access API (нужен Chromium-браузер).
+ * Опубликованный пакет несёт УЖЕ собранный SPA в `dist/`. Этот скрипт — zero-dependency
+ * статик-сервер на встроенных модулях Node (перенесён из первой версии билдера, она же
+ * в истории git): поднимает `dist/` на localhost и открывает браузер. Серверной
+ * логики у билдера нет — вся работа с файлами проекта идёт в браузере через File System Access
+ * (нужен Chromium-браузер).
  *
- * Клиент может передать 2 JSON-файла для локальной кастомизации: каталог компонентов (--catalog)
- * и конфиг билдера (--config). Launcher читает их с диска и отдаёт SPA по /__reformer-builder/
- * runtime.json; без флагов пытается авто-подхватить одноимённые файлы из cwd. Отсутствие файлов —
- * билдер работает на вшитых дефолтах.
+ * Конфигурация уровня запуска — ОДИН файл: конфиг билдера (брендинг, дефолты UI). Launcher
+ * читает его с диска и отдаёт SPA по `/__reformer-builder/runtime.json`; без флага `--config`
+ * пытается авто-подхватить `<cwd>/.ui_builder/config.json` — тот же конвенционный каталог,
+ * в котором живут плагины, шаблоны и цели кодогена открытого проекта. Частый случай «запустил
+ * в корне проекта и его же открыл» даёт один каталог конфигурации без дублей.
+ *
+ * Каталога компонентов (`--catalog` первой версии) здесь НЕТ намеренно: сторонний ui-kit
+ * встраивается плагином (`.ui_builder/plugins/`), а не файлом данных — плагин привозит
+ * и каталог, и код компонентов.
  *
  * Использование:
- *   npx reformer-builder [--port <n>] [--host <h>] [--no-open] [--catalog <path>] [--config <path>]
+ *   npx reformer-builder [--port <n>] [--host <h>] [--no-open] [--config <path>]
  */
 
 import { createServer } from 'node:http';
@@ -22,12 +28,11 @@ import { spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { extname, join, normalize, resolve, sep } from 'node:path';
 
-/** URL, по которому SPA забирает клиентский bundle (совпадает с RUNTIME_BUNDLE_PATH в src/config/load). */
+/** URL, по которому SPA забирает конфиг (совпадает с RUNTIME_BUNDLE_PATH в shell/boot/runtime-config). */
 export const RUNTIME_BUNDLE_URL = '/__reformer-builder/runtime.json';
 
-/** Имена файлов для авто-детекта в cwd, если флаги `--catalog`/`--config` не заданы. */
-const DEFAULT_CATALOG_FILE = 'component-catalog.json';
-const DEFAULT_CONFIG_FILE = 'reformer-builder.config.json';
+/** Путь авто-детекта конфига в cwd, если флаг `--config` не задан. */
+const DEFAULT_CONFIG_FILE = join('.ui_builder', 'config.json');
 
 // Без хвостового разделителя: иначе `distDir + sep` даёт двойной слэш и проверка
 // границы каталога в resolveFsPath() никогда не совпадает (все запросы → 400).
@@ -64,61 +69,53 @@ async function readVersion() {
 }
 
 /**
- * Прочитать и распарсить клиентский JSON-файл. Явно переданный (`--catalog`/`--config`) файл
- * обязателен — при ошибке чтения/парсинга завершаемся с сообщением. Авто-детект: отсутствие файла
- * (ENOENT) — тихий пропуск (fallback на вшитые дефолты); присутствует, но битый JSON — ошибка
- * (файл явно предназначен к использованию).
+ * Прочитать и распарсить конфиг. Явно переданный (`--config`) файл обязателен — при ошибке
+ * чтения/парсинга завершаемся с сообщением. Авто-детект: отсутствие файла — тихий пропуск
+ * (вшитые дефолты); присутствует, но битый JSON — ошибка: файл явно предназначен
+ * к использованию, и молча проигнорировать его значило бы обмануть положившего.
  */
-async function readRuntimeFile(path, { explicit, label }) {
+async function readRuntimeFile(path, { explicit }) {
   let text;
   try {
     text = await readFile(path, 'utf8');
   } catch (err) {
     if (explicit) {
-      console.error(`reformer-builder: не удалось прочитать ${label} "${path}": ${err.message}`);
+      console.error(`reformer-builder: не удалось прочитать конфиг "${path}": ${err.message}`);
       process.exit(1);
     }
-    return null; // авто-детект: файла нет — работаем на вшитых дефолтах
+    return null;
   }
   try {
     return JSON.parse(text);
   } catch (err) {
-    console.error(`reformer-builder: невалидный JSON в ${label} "${path}": ${err.message}`);
+    console.error(`reformer-builder: невалидный JSON в конфиге "${path}": ${err.message}`);
     process.exit(1);
   }
 }
 
 /**
- * Собрать runtime-bundle для SPA из файлов клиента. Пути берутся из флагов, иначе — авто-детект
- * одноимённых файлов в cwd. Структурную валидацию делает SPA (реюз validateCatalog + AJV конфига);
- * здесь ловим только отсутствие/JSON-синтаксис.
+ * Собрать runtime-bundle для SPA. Путь берётся из флага, иначе — авто-детект
+ * `<cwd>/.ui_builder/config.json`. Структурную валидацию делает SPA (точные сообщения
+ * о полях — его словарь); здесь ловим только отсутствие и JSON-синтаксис.
  */
 export async function loadRuntimeBundle(opts, cwd) {
-  const catalogPath = resolve(cwd, opts.catalog ?? DEFAULT_CATALOG_FILE);
   const configPath = resolve(cwd, opts.config ?? DEFAULT_CONFIG_FILE);
-  const catalog = await readRuntimeFile(catalogPath, {
-    explicit: Boolean(opts.catalog),
-    label: 'каталог (--catalog)',
-  });
-  const config = await readRuntimeFile(configPath, {
-    explicit: Boolean(opts.config),
-    label: 'конфиг (--config)',
-  });
+  const config = await readRuntimeFile(configPath, { explicit: Boolean(opts.config) });
   return {
-    payload: { catalog: catalog ?? null, config: config ?? null },
-    sources: { catalog: catalog ? catalogPath : null, config: config ? configPath : null },
+    payload: { config: config ?? null },
+    sources: { config: config === null ? null : configPath },
   };
 }
 
 export function parseArgs(argv) {
   const opts = {
+    // 4321 — исторический порт билдера: он записан в чужих package.json и в памяти людей.
     port: 4321,
     host: '127.0.0.1',
     open: true,
     help: false,
     version: false,
-    // Явно переданные клиентом пути (null — не задан, будет авто-детект в cwd).
-    catalog: null,
+    /** Явно переданный путь к конфигу (null — не задан, будет авто-детект в cwd). */
     config: null,
   };
   for (let i = 0; i < argv.length; i++) {
@@ -131,8 +128,6 @@ export function parseArgs(argv) {
     else if (a.startsWith('--port=')) opts.port = Number(a.slice('--port='.length));
     else if (a === '--host') opts.host = String(argv[++i]);
     else if (a.startsWith('--host=')) opts.host = a.slice('--host='.length);
-    else if (a === '--catalog') opts.catalog = String(argv[++i]);
-    else if (a.startsWith('--catalog=')) opts.catalog = a.slice('--catalog='.length);
     else if (a === '--config') opts.config = String(argv[++i]);
     else if (a.startsWith('--config=')) opts.config = a.slice('--config='.length);
     else {
@@ -157,13 +152,13 @@ function printHelp() {
   -p, --port <n>       Порт (по умолчанию 4321; занят — берётся следующий свободный)
       --host <h>       Хост (по умолчанию 127.0.0.1)
       --no-open        Не открывать браузер автоматически
-      --catalog <path> Каталог компонентов (JSON) для палитры/инспектора
-      --config <path>  Конфиг билдера (JSON): палитра, доступные компоненты, дефолты UI, брендинг
+      --config <path>  Конфиг билдера (JSON): брендинг, дефолты UI, состав плагинов
   -h, --help           Показать эту справку
   -v, --version        Показать версию
 
-Без --catalog/--config билдер пытается подхватить component-catalog.json и
-reformer-builder.config.json из текущей папки; если их нет — работает на вшитых дефолтах.
+Без --config билдер пытается подхватить .ui_builder/config.json из текущей папки;
+если его нет — работает на вшитых дефолтах. Плагины, шаблоны форм и цели кодогена
+живут в .ui_builder/ ОТКРЫТОГО проекта и читаются самим приложением.
 
 Примечание: режим «открыть папку проекта» (File System Access API) работает только в
 Chromium-браузерах (Chrome/Edge/Arc/Brave).`);
@@ -201,7 +196,6 @@ function resolveFsPath(pathname) {
   } catch {
     return null;
   }
-  // Отбрасываем query/hash уже сделано вызывающим; нормализуем и запрещаем выход за distDir.
   const rel = normalize(decoded).replace(/^(\.\.(\/|\\|$))+/, '');
   const full = join(distDir, rel);
   if (full !== distDir && !full.startsWith(distDir + sep)) return null;
@@ -227,7 +221,7 @@ export function createRequestHandler(indexHtmlPath, runtimeBundleBody) {
       return;
     }
     const pathname = (req.url || '/').split('?')[0].split('#')[0];
-    // Клиентский runtime-bundle (каталог/конфиг из файлов) — отдаём ДО резолва static/dist.
+    // Конфиг уровня запуска — отдаём ДО резолва static/dist.
     if (pathname === RUNTIME_BUNDLE_URL) {
       res.writeHead(200, {
         'Content-Type': 'application/json; charset=utf-8',
@@ -246,7 +240,6 @@ export function createRequestHandler(indexHtmlPath, runtimeBundleBody) {
     try {
       const info = await stat(target);
       if (info.isDirectory()) {
-        // Каталог → отдаём его index.html, иначе SPA-fallback.
         const dirIndex = join(target, 'index.html');
         try {
           await stat(dirIndex);
@@ -278,7 +271,7 @@ export function createRequestHandler(indexHtmlPath, runtimeBundleBody) {
 
 /** Поднять сервер, при EADDRINUSE — попробовать следующий порт (до +20). */
 function listenWithFallback(server, host, startPort, attemptsLeft = 20) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolvePort, reject) => {
     const tryPort = (port) => {
       const onError = (err) => {
         if (err.code === 'EADDRINUSE' && attemptsLeft > 0) {
@@ -291,7 +284,7 @@ function listenWithFallback(server, host, startPort, attemptsLeft = 20) {
       server.once('error', onError);
       server.listen(port, host, () => {
         server.removeListener('error', onError);
-        resolve(port);
+        resolvePort(port);
       });
     };
     tryPort(startPort);
@@ -315,13 +308,11 @@ async function main() {
   } catch {
     console.error(
       `reformer-builder: не найден собранный dist/ (ожидался ${indexHtmlPath}).\n` +
-        `Похоже, пакет установлен без бандла — переустановите @reformer/builder.`
+        `Похоже, пакет установлен без бандла — переустановите его.`
     );
     process.exit(1);
   }
 
-  // Клиентский конфиг/каталог из файлов (флаги или авто-детект в cwd). Отдаётся SPA по
-  // RUNTIME_BUNDLE_URL; отсутствие файлов ⇒ пустой bundle ⇒ билдер на вшитых дефолтах.
   const runtime = await loadRuntimeBundle(opts, process.cwd());
   const runtimeBundleBody = Buffer.from(JSON.stringify(runtime.payload));
 
@@ -338,7 +329,6 @@ async function main() {
   const url = `http://${displayHost}:${port}/`;
   console.log(`\n  reformer-builder v${await readVersion()}`);
   console.log(`  Локальный сервер:  ${url}`);
-  if (runtime.sources.catalog) console.log(`  Каталог из файла:  ${runtime.sources.catalog}`);
   if (runtime.sources.config) console.log(`  Конфиг из файла:   ${runtime.sources.config}`);
   console.log(`  Режим «открыть папку проекта» требует Chromium-браузер (File System Access API).`);
   console.log(`  Остановить: Ctrl+C\n`);
@@ -347,7 +337,6 @@ async function main() {
 
   const shutdown = () => {
     server.close(() => process.exit(0));
-    // На случай зависших соединений — жёсткий выход.
     setTimeout(() => process.exit(0), 500).unref();
   };
   process.on('SIGINT', shutdown);