@reformer/builder-plugin-api 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,206 @@
+# @reformer/builder-plugin-api
+
+Контракт плагина ReFormer Builder: всё, что плагин видит от платформы, и ничего сверх.
+
+```bash
+npm install --save-dev @reformer/builder-plugin-api
+```
+
+## Зачем отдельный пакет
+
+Плагин каталога проекта компилируется **не в билдере**: у него свой `tsconfig`, своя сборка
+и свой CI. Пока контракт жил исходниками приложения, компилировать плагин было не против чего,
+а «скопируйте типы себе» означало вторую копию, расходящуюся с первой молча.
+
+Версия пакета независима от версии билдера: она описывает КОНТРАКТ, а не приложение. Мажор
+растёт тогда, когда из контракта что-то уходит или меняет смысл, — и ровно это диапазон
+`apiVersion` в манифесте плагина и проверяет.
+
+## Зависимость только на сборку
+
+В рантайме плагин получает **объект оболочки**, а не код этого пакета: загрузчик занимает
+спецификатор `@reformer/builder-plugin-api` тем же экземпляром, которым пользуется сама
+оболочка. Второй экземпляр означал бы плагин, регистрирующий вклады в чужой пустой реестр —
+без отказа и без исключения, просто не появившаяся панель. Поэтому пакет ставится
+в `devDependencies`, а сборка плагина держит его во внешних.
+
+## Что здесь есть
+
+Плоский список в `src/index.ts` — и он плоский намеренно: так ЦЕНА платформы для плагина видна
+в diff'е одного файла, а не растворяется в сотне импортов. Сюда попадает только то, чем плагин
+пользуется по факту, а не «на будущее».
+
+Чего здесь нет и не будет: реестров, рабочей области, хранилищ, самой оболочки. Доступ к ним
+плагин получает через `PluginContext` — то есть по правилам, а не по импорту.
+
+## `./internal`
+
+Второй вход — платформенные примитивы целиком, для оболочки билдера. Обещаний совместимости
+у него нет: он существует, чтобы оболочка пользовалась ТЕМИ ЖЕ модулями, а не своей копией.
+Плагину он не нужен, и то, что попало только туда, контрактом не является.
+
+## Имена в рантайме
+
+Оболочка занимает ОДНИМ объектом два спецификатора: `@reformer/builder-plugin-api` — имя, под которым
+контракт опубликован и против которого плагин компилируется, и `@builder/sdk` — прежнее имя,
+оставленное, пока по нему написаны плагины. Подменить ни одно из них плагин не может.
+
+Встроенные плагины билдера импортируют этот же пакет, и линтер билдера запрещает им что-либо ещё
+из платформы — в том числе вход `./internal`. Второй поверхности «для своих» нет: всё, что нужно
+встроенному, обязано быть здесь, иначе этого нет и у внешнего.
+
+## Версия
+
+Версия пакета описывает КОНТРАКТ и независима от версии билдера. Манифест плагина объявляет
+диапазон полем `apiVersion` (`"^1"`), и оболочка сверяет его со своим `BUILDER_API_VERSION` до
+загрузки кода: минор растёт на добавление имени, мажор — на удаление или смену смысла. Политики
+совместимости между мажорами нет — при расхождении плагин не грузится и объясняет почему.
+
+Поля `compatibility.builder` (диапазон версий самого приложения) нет. Проверять его нечем:
+версии в рантайме у билдера нет, а поле, которое ничего не принуждает, создавало бы ложное
+ощущение проверки.
+
+## Права
+
+`permissions` в манифесте — ключ к службе, которую оболочка отдаёт не всем, а не объявление
+намерений. Сегодня право одно, `workspace.save`, и за ним стоит `WorkspaceSaveServiceToken` —
+сохранение в источник, единственная операция, выносящая написанное наружу.
+
+```json
+{ "permissions": ["workspace.save"] }
+```
+
+Плагину без подтверждённого права службы не видно: `ctx.services.get` отвечает `undefined`,
+`require` отказывает, а занять её слот самому нельзя. Спрашивают человека при включении плагина;
+подтверждение живёт в настройках проекта. Список прав закрыт и растёт по одному имени на одну
+такую службу: право, за которым не заперта дверь, было бы тем самым ложным ощущением границы,
+из-за которого поля `permissions` не было вовсе.
+
+## Контракт редактора
+
+Редактор — вклад в `EditorPoint`. Три обязанности, без которых он ломает соседей молча.
+
+**Фокус.** Текстовый редактор ОБЯЗАН писать в реестр фокуса (`TextEditorFocusToken`):
+`setFocused(id, true)` при получении фокуса полем документа и `setFocused(id, false)` при потере.
+Рабочая область откладывает перерисовку буфера из модели, пока человек печатает; редактор,
+не пишущий в реестр, получает буфер, переписанный под руками, — набранное просто исчезает.
+
+**`flush` — после снятия фокуса, не до.** Потеряв фокус, редактор просит рабочую область догнать
+буфер моделью: `documents.flush(id)`. Порядок несущий: `flush` сам спрашивает реестр фокуса и при
+живом фокусе отложит перерисовку снова, так что вызов до `setFocused(id, false)` оставит буфер
+отставшим до следующего повода.
+
+**Стабильное тело.** `Body` — это ОДНА ссылка на компонент на всё время жизни вклада, а не функция,
+создающая компонент при каждом обращении. React сравнивает тип элемента по ссылке: новая ссылка —
+размонтирование и монтирование заново, то есть потерянные прокрутка, каретка и состояние движка
+на каждой перерисовке родителя. Если тело нужно соседям (режим «рядом» у другого редактора),
+его отдают возможностью, а не собирают второй раз.
+
+Состояние вида (прокрутка, свёрнутые ветки, каретка) — через `viewState` вклада или хранилище
+снимков `EditorViewStatesToken`, адресованное документом. Выделение туда не входит: оно часть
+модели правки и живёт в снимке отмены.
+
+**Отмена модельного документа — обязанность редактора стека.** История живёт в ручке модели
+(`ModelDocumentHandle.undo/redo/canUndo/canRedo`), а клавиши `mod+z`/`mod+shift+z` вносит редактор
+того стека, чей документ, с условием по виду документа: `activeResourceKind == <provider-id>`.
+Оболочка своих команд отмены не заводит: у текстового документа своя отмена у Monaco, у каждого
+стека — свой вид документа, и условие по нему делает сочетания стеков непересекающимися. Образцы —
+`plugins/editor-schema` (`form.schema`) и `plugins/plain` (`plain.form`).
+
+## Контракт словаря
+
+Словарь плагина приходит полем `ctx.i18n` и живёт в ЕГО пространстве имён: `panel.title` двух
+плагинов — две разные строки. Пространство имён — отдельное измерение, а не префикс в ключе,
+поэтому ключ `sub.title` плагина `acme` не пересекается с ключом `title` плагина `acme.sub`.
+
+- **Внести:** `ctx.i18n.contribute(locale, messages)` в `activate`, или декларативно — полем
+  манифеста `contributes.messages: { "ru": "locales/ru.json" }`. Повторный вклад той же локали
+  дополняет словарь; сообщение, которое не разбирается, отвергает весь вызов с именем ключа.
+- **Показать в React:** `useTranslate(ctx.i18n)` — хук подписывает компонент на смену языка;
+  голый `t` отвечает, как строка звучит СЕЙЧАС, и панель осталась бы на прежнем языке.
+- **Промах виден:** в разработке отсутствующий ключ показывается маркером `⟦id.key⟧`, в сборке
+  откатывается на `en`. Тихого возврата самого ключа нет никогда.
+- **Не переводится здесь** текст диагностик: одна ошибка обязана выглядеть одинаково в редакторе,
+  в панели проблем и в логе, поэтому находка несёт код и параметры, а переводит тот, кто показывает.
+  Голый код переводит словарь оболочки (`errors.<code>`). Свои коды плагин помечает владельцем —
+  `pluginDiagnosticCode(pluginId, code)` даёт `<plugin-id>:<code>`, — и такой код переводится
+  по ключу `errors.<code>` ЕГО словарём: стек, пришедший плагином, в словарь оболочки не пишет.
+
+Заголовки команд (`titleKey`) и панелей разрешаются словарём ВНЁСШЕГО плагина — реестр проставляет
+владельца сам, и чужим словарём заголовок не разрешится даже по ошибке.
+
+## Превью: поверхности и живой вид
+
+Поверхности превью вносят плагины РАЗНЫХ стеков: стек ReFormer рисует схему `@reformer/renderer-json`,
+другой стек — свой формат. Поэтому точка `PreviewSurfacePoint` и её контракт — здесь. Модель
+документа в контракте `unknown`: поверхность берётся за документ по `DocumentRef.providerId` —
+провайдеру модели, который его разобрал, — и сама сужает модель своей проверкой. Обязанности
+поверхности:
+
+- **`applies(doc)`** — синхронно и дёшево, по адресу, виду и провайдеру модели; `.json` бывает
+  схемой любого стека, поэтому медиатипа недостаточно;
+- **хит-тест** — узлы формы размечены классом с префиксом `rbnode-` (`[class*="rbnode-"]`),
+  и поверхность сообщает о щелчке `select(ids)` теми же адресами (`$nodeId`), что у редактора;
+- **`keepValues`** — перед пересборкой и при размонтировании поверхность САМА отдаёт введённые
+  значения на хранение: только она знает, когда её модель ещё жива;
+- **`publishForm`** — живой объект собранной формы для наблюдателей (панель модели); необязателен;
+- **`report(source, problems)`** — находки сборки, список ЗАМЕЩАЕТСЯ целиком по имени поверхности;
+- **`title()`** — имя, УЖЕ переведённое словарём внёсшего плагина; нет — показывают `id`.
+
+Живой вид — возможность `PreviewLiveCapability` (`reformer.preview.live`), провайдер — плагин
+превью. Им редактор ЛЮБОГО стека показывает документ: служба выбирает поверхность общим правилом
+и монтирует её в элемент редактора, а `formOf` отдаёт опубликованную форму наблюдателю. Превью
+выключаемо, поэтому возможность спрашивают в момент вопроса, а не при активации.
+
+## Модель документа и механизмы оболочки
+
+Редактор модели — плагин стека, и всё, что ему нужно от оболочки, он берёт возможностями:
+
+| Возможность                                              | Что даёт                                                                        |
+| -------------------------------------------------------- | ------------------------------------------------------------------------------- |
+| `DocumentModelsCapability` (`reformer.workspace.models`) | `handleOf(id)` — ручка модельного документа: модель, правка операциями, история |
+| `WorkspaceFilesCapability` (`reformer.workspace.files`)  | соседи, чтение, адресация; `executesCode(id)` и `onDidChange` — с версии 1.1    |
+| `ModuleLoaderCapability` (`reformer.modules`)            | загрузчик модулей с прогретым компилятором — исполнить код рабочей копии        |
+| `HostMessagesCapability` (`reformer.host.messages`)      | словарь оболочки на чтение: перевести код чужой находки                         |
+
+Ручка отдаёт модель как `unknown`: оболочка держит провайдеров разом несколько и ни одной модели
+не знает. Плагин сверяет `handle.document.providerId` со своим провайдером и только тогда сужает
+тип — иначе редактор получил бы модель другого стека под своим типом. Провайдер модели
+(`DocumentModelPoint`) вправе ответить `nodePaths(model)` — где в тексте лежит каждый узел; этим
+текстовый редактор подчёркивает находку на узле, у которого в тексте нет своего идентификатора.
+
+## `./tooling` — для инструментов автора плагина
+
+Сборщику, валидатору и упаковщику плагина нужно то, что обязано совпадать с оболочкой
+буквально, — поэтому оно живёт здесь, а не копируется в инструмент:
+
+- **разбор манифеста** (`parsePluginManifest`) — тот же, которым оболочка решает, грузить ли
+  плагин. Два разбора разошлись бы на первой же правке правил, и валидатор пропускал бы то,
+  что оболочка отвергнет;
+- **модули рантайма** (`PLUGIN_RUNTIME_MODULES`) — спецификаторы, которые оболочка подставляет
+  своими объектами; сборка плагина обязана держать их внешними. Билдер тестом сверяет с этим
+  списком свой реестр модулей;
+- **вкладываемые пакеты** (`PLUGIN_BUNDLED_PACKAGES`, `isBundledPluginModule`) — пакеты стеков
+  (`@reformer/builder-toolkit`, `@reformer/builder-stack-*`), которые сборка кладёт в `main.js`
+  плагина сама: оболочка стека не знает и их не подставляет, а второй экземпляр чистых функций
+  без синглтонов безвреден. Что эти пакеты берут из рантайма, остаётся внешним; что берут
+  из `@reformer/*` вне списка (глубокие импорты `@reformer/mcp` у стека ReFormer), вкладывается
+  вместе с ними. Тот же импорт из кода самого плагина — по-прежнему отказ `module-unavailable`;
+- **нормализация пути модуля** (`normalizeModulePath`) — та же, которой линковщик ищет точку
+  входа: выход за каталог плагина — данные отказа, а не исключение;
+- **раскладка каталога и словари** (`PLUGIN_CATALOG_DIR`, `PLUGIN_FILE_LIMIT`,
+  `isPluginCodeFile`, `parseMessagesBundle`) — потолок файлов, расширения кода и форма
+  `locales/*.json`, по которым загрузчик оболочки отказывает плагину;
+- **узнавание плагина в экспортах** (`pluginFromExports`) — то же, что у загрузчика: сборка
+  проверяет им собранный `main.js`, чтобы не выпустить то, что оболочка отвергнет с `not-a-plugin`;
+- **манифест исходников** (`parsePluginSourceManifest`) — тот же разбор для репозитория автора
+  до сборки. Отличий два: имя каталога с `id` не сверяется, `version` обязательна.
+
+Пользуется этим входом `@reformer/builder-plugin-cli` (`reformer-plugin`).
+
+В отличие от `./internal`, это контракт и версионируется вместе с пакетом. Типы манифеста
+(`PluginManifest`, `ProjectPluginManifest`, `BuiltinPluginManifest`) отдаются этим же входом.
+
+## Лицензия
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,147 @@
+/**
+ * `@reformer/builder-plugin-api` — вся поверхность платформы, видимая плагину ReFormer Builder.
+ *
+ * Это буквально тот объект, который оболочка подставит плагину каталога проекта: встроенный
+ * плагин импортирует его как обычный пакет, внешний получит ТО ЖЕ САМОЕ через линковщик
+ * (слот занят самим пакетом), и разойтись они не смогут, потому что источник один.
+ *
+ * ## Правило состава
+ *
+ * Сюда попадает **только то, чем плагин пользуется**, и попадает по факту, а не «на будущее».
+ * Модуль этим и ценен: он делает видимой ЦЕНУ платформы для плагина, и любое расширение
+ * поверхности видно в diff'е ОДНОГО файла, а не растворяется в сотне импортов по всему
+ * `plugins/`. Поэтому файл и остаётся плоским списком: делить его на `primitives/ui/services`
+ * значило бы разменять единственное свойство, ради которого он существует.
+ *
+ * Отсюда же следует, чего здесь нет и не будет: реестров, рабочей области, хранилищ, оболочки.
+ * Плагин получает доступ к ним через `PluginContext` — то есть по правилам, а не по импорту.
+ *
+ * ## Почему это отдельный пакет, а не каталог в билдере
+ *
+ * Плагин каталога проекта компилируется НЕ в билдере: у него свой `tsconfig`, своя сборка
+ * и свой CI. Компилировать его не против чего, пока контракт живёт исходниками приложения,
+ * — а «скопируйте типы себе» означает вторую копию, расходящуюся с первой молча. Версия
+ * пакета при этом независима от версии билдера: она описывает КОНТРАКТ, а не приложение,
+ * и мажор у неё растёт тогда, когда из контракта что-то уходит.
+ *
+ * ## Что здесь значения, а не только типы
+ *
+ * Значения бывают ровно четырёх родов, и каждый обязан быть значением:
+ *
+ * - **точки расширения** — вклад вносится ПО НИМ, и реестр берёт из них `id`, которым ключует
+ *   вклады; реэкспорт, а не переобъявление, нужен ради единого источника имени и параметра
+ *   типа: разъехавшись по типу вклада, копия сузила бы чужую точку под себя;
+ * - **токены служб** — токен и есть ключ реестра, а не описание ключа;
+ * - **объявители** (`definePlugin`, `defineService`, `defineCapability`) — проверка и вывод
+ *   типов в месте объявления;
+ * - **чистые функции и константы** без состояния — вторая их реализация в плагине разошлась бы
+ *   с платформенной, а состояния они не несут, поэтому копия ничем не лучше.
+ *
+ * Ни одно из них не тянет платформу в бандл плагина: это либо стираемые типы, либо мелкие
+ * листовые модули.
+ *
+ * ## Встроенные плагины пользуются тем же входом
+ *
+ * Встроенный плагин билдера импортирует этот пакет ровно так же, как внешний, — и линтер
+ * билдера запрещает ему что-либо ещё из платформы. Второй поверхности для «своих» нет:
+ * всё, что нужно встроенному, обязано быть здесь, иначе этого нет и у внешнего.
+ *
+ * @module @reformer/builder-plugin-api
+ */
+export { definePlugin } from './plugin/types.js';
+export type { Plugin, PluginContext } from './plugin/types.js';
+export { useTranslate } from './ui/useTranslate.js';
+export type { Translate } from './ui/useTranslate.js';
+export type { PluginI18n } from './services/i18n.js';
+export { pluginMessageKey, splitMessageKey } from './services/i18n.js';
+export type { Disposable } from './primitives/disposable.js';
+export type { ResourceId, ResourceRef } from './primitives/resource.js';
+export { validateResourceName, splitName } from './workspace/resource-names.js';
+export type { NameRejection } from './workspace/resource-names.js';
+export type { Diagnostic, DiagnosticSeverity, DiagnosticTarget, NodePart, QuickFix, TextRange, } from './services/diagnostics/types.js';
+export { usableFixes, withUsableFixes } from './services/diagnostics/fixes.js';
+export type { CommandLookup, FixesOptions } from './services/diagnostics/fixes.js';
+export { ValidatorPoint } from './services/validation/types.js';
+export type { DocumentRef, ValidateContext, ValidatorContribution, } from './services/validation/types.js';
+export type { DocumentKind } from './workspace/document.js';
+export { PanelPoint } from './ui/slots.js';
+export type { PanelContribution, SlotId } from './ui/slots.js';
+export { EditorPoint } from './ui/contributions/editors.js';
+export type { EditorContribution } from './ui/contributions/editors.js';
+export type { EditorProbe } from './workspace/model/provider.js';
+export { ResourceDecorationPoint } from './ui/contributions/decorations.js';
+export type { Decoration, ResourceDecorationContribution } from './ui/contributions/decorations.js';
+export { PaletteItemsPoint } from './ui/menu/palette.js';
+export type { PaletteItem, PaletteItemProvider } from './ui/menu/palette.js';
+export { CatalogPluginSettingsPoint } from './ui/contributions/plugin-settings.js';
+export type { CatalogPluginSettingsContribution } from './ui/contributions/plugin-settings.js';
+export { pluginSettingsKey } from './services/plugin-settings.js';
+export type { CommandContribution } from './primitives/command.js';
+export type { WhenContext, FocusTarget } from './primitives/when-context.js';
+export { parseWhen, compileWhen, evaluateWhen, WHEN_TRUE } from './primitives/when-expr.js';
+export type { WhenExpr, WhenNode, WhenParseError, WhenParseResult, } from './primitives/when-expr.js';
+export { ScopeStackServiceToken, DIALOG_SCOPE } from './ui/keyboard/scope.js';
+export type { ScopeId, ScopeStack } from './ui/keyboard/scope.js';
+export { chordOfCommand, KeymapServiceToken } from './ui/keyboard/keymap.js';
+export type { KeymapService } from './ui/keyboard/keymap.js';
+export type { KeybindingIndex, KeybindingLayer, KeybindingRule, } from './ui/keyboard/keybinding-rules.js';
+export { detectPlatformModifier, formatChord, formatKeybinding, } from './ui/keyboard/keybindings.js';
+export type { PlatformModifier } from './ui/keyboard/keybindings.js';
+export { MAX_CHORD_STEPS, normalizeChord, normalizeKeybinding } from './primitives/command.js';
+export { ContextKeyServiceToken } from './services/context-keys.js';
+export type { ContextKey, ContextKeyReader, ContextKeyService, ContextKeySnapshot, } from './services/context-keys.js';
+export { defineService } from './primitives/service.js';
+export type { ServiceToken, ServiceRegistry } from './primitives/service.js';
+export { defineCapability } from './primitives/capability.js';
+export type { Capability, CapabilityAccess, CapabilityDeclaration, CapabilityProvider, CapabilityRequirement, } from './primitives/capability.js';
+export { SettingsServiceToken } from './services/settings.js';
+export type { SettingsService } from './services/settings.js';
+export { ThemeServiceToken } from './services/theme.js';
+export type { ThemeService, ThemePreference } from './services/theme.js';
+export { NotificationsServiceToken } from './services/notifications.js';
+export type { NotificationsService } from './services/notifications.js';
+export { DiagnosticsServiceToken } from './services/diagnostics/service.js';
+export type { DiagnosticsService } from './services/diagnostics/service.js';
+export { DocumentsServiceToken } from './services/documents.js';
+export { WorkspaceFilesServiceToken, WorkspaceFilesCapability, } from './services/workspace-files.js';
+export type { WorkspaceFilesService } from './services/workspace-files.js';
+export { PluginsCatalogServiceToken, PluginsCatalogCapability, } from './services/plugins-catalog.js';
+export type { ManagedPlugin, ManagedPluginState, PluginsCatalogService, } from './services/plugins-catalog.js';
+export { WorkspaceResourcesServiceToken, WorkspaceResourcesCapability, } from './services/workspace-resources.js';
+export type { WorkspaceResourcesService, WorkspaceBatchResult, } from './services/workspace-resources.js';
+export { WorkspaceSaveServiceToken, WorkspaceSaveCapability } from './services/workspace-save.js';
+export type { WorkspaceSaveService } from './services/workspace-save.js';
+export { PLUGIN_PERMISSIONS } from './plugin/permissions.js';
+export type { PluginPermission } from './plugin/permissions.js';
+export { useActiveDocument } from './ui/useActiveDocument.js';
+export type { DocumentsService, OpenDocumentOptions } from './services/documents.js';
+export type { Document } from './workspace/document.js';
+export type { WriteOptions } from './workspace/write-options.js';
+export { TextEditorFocusToken } from './workspace/model/text-editor-focus.js';
+export type { TextEditorFocusRegistry } from './workspace/model/text-editor-focus.js';
+export { EditorViewStatesToken } from './workspace/model/editor-view-states.js';
+export type { EditorViewStates, EditorViewStateSlice, } from './workspace/model/editor-view-states.js';
+export { SelectionServiceToken } from './services/selection.js';
+export type { SelectionService } from './services/selection.js';
+export { PreviewSurfacePoint, PreviewLiveCapability } from './services/preview.js';
+export type { LiveSurfaceContext, LiveSurfaceInfo, PreviewCapabilities, PreviewContext, PreviewFormHandle, PreviewLiveService, PreviewMock, PreviewProblem, PreviewProblemPhase, PreviewSurface, PreviewValues, } from './services/preview.js';
+export { DocumentModelPoint } from './workspace/model/provider.js';
+export type { DocumentModelProvider, EditOp, ApplyResult, NodeId, JsonSchemaHint, TextStringSite, TextCompletion, } from './workspace/model/provider.js';
+export { DocumentModelsCapability } from './services/document-models.js';
+export type { DocumentModelsService } from './services/document-models.js';
+export type { ApplyOptions, ApplyOutcome, ApplyRejection, DocumentSyncState, ModelChange, ModelChangeReason, ModelDocument, ModelDocumentHandle, ParseFailure, } from './workspace/model/model-document.js';
+export { ModuleLoaderCapability } from './services/modules.js';
+export type { ModuleGraph, ModuleLoadProblem, ModuleLoaderService, PrimedCompile, } from './services/modules.js';
+export { HostMessagesCapability } from './services/host-messages.js';
+export type { HostMessagesService } from './services/host-messages.js';
+export { SEVERITY_RANK, pluginDiagnosticCode, splitDiagnosticCode, } from './services/diagnostics/types.js';
+export { MenuPoint, MENU_ROOT_IDS, CONTEXT_MENU_IDS } from './ui/menu/menu.js';
+export type { ContextMenuId, MenuContribution, MenuDynamicContribution, MenuDynamicItem, MenuItemContribution, MenuPath, MenuRootContribution, MenuRootId, MenuSubmenuContribution, MenuTarget, } from './ui/menu/menu.js';
+export { RESOURCE_CONTEXT_MENU, argsOfResource, asResourceTarget, selectedIds, whenResource, } from './ui/menu/resource-menu.js';
+export type { ResourceMenuTarget } from './ui/menu/resource-menu.js';
+export { EDITOR_TITLE_MENU, argsOfEditor, whenEditor } from './ui/menu/editor-menu.js';
+export type { EditorMenuTarget } from './ui/menu/editor-menu.js';
+export { PromptServiceToken } from './services/prompt.js';
+export type { PromptPickItem, PromptPickRequest, PromptService } from './services/prompt.js';
+export { ResourceClipboardServiceToken } from './services/resource-clipboard.js';
+export type { ClipboardMode, ClipboardState, ResourceClipboardService, } from './services/resource-clipboard.js';

package/dist/index.js

@@ -0,0 +1,76 @@
+import { $ as s, C as i, j as o, D as t, n, L as r, M as c, o as l, a5 as S, E as T, G as p, Q as d, K as u, _ as g, Z as k, O as v, N as C, c as P, P as E, t as m, r as R, J as y, I as M, a8 as b, a0 as f, a9 as _, R as D, U as N, S as O, H as I, m as W, F as h, T as K, V as U, q as w, W as x, y as F, x as L, A, z as H, a6 as V, a1 as X, a2 as z, f as G, l as Y, d as j, k as q, g as B, h as J, i as Q, X as Z, p as $, e as ee, a3 as ae, Y as se, s as ie, a as oe, b as te, B as ne, u as re, v as ce, a7 as le, a4 as Se, w as Te } from "./resource-clipboard-Bdk_Is5N.js";
+import { M as de, P as ue, W as ge, c as ke, e as ve, n as Ce, a as Pe, p as Ee } from "./permissions-BWlsUVPs.js";
+export {
+  s as CONTEXT_MENU_IDS,
+  i as CatalogPluginSettingsPoint,
+  o as ContextKeyServiceToken,
+  t as DIALOG_SCOPE,
+  n as DiagnosticsServiceToken,
+  r as DocumentModelPoint,
+  c as DocumentModelsCapability,
+  l as DocumentsServiceToken,
+  S as EDITOR_TITLE_MENU,
+  T as EditorPoint,
+  p as EditorViewStatesToken,
+  d as HostMessagesCapability,
+  u as KeymapServiceToken,
+  de as MAX_CHORD_STEPS,
+  g as MENU_ROOT_IDS,
+  k as MenuPoint,
+  v as ModuleLoaderCapability,
+  C as NotificationsServiceToken,
+  ue as PLUGIN_PERMISSIONS,
+  P as PaletteItemsPoint,
+  E as PanelPoint,
+  m as PluginsCatalogCapability,
+  R as PluginsCatalogServiceToken,
+  y as PreviewLiveCapability,
+  M as PreviewSurfacePoint,
+  b as PromptServiceToken,
+  f as RESOURCE_CONTEXT_MENU,
+  _ as ResourceClipboardServiceToken,
+  D as ResourceDecorationPoint,
+  N as SEVERITY_RANK,
+  O as ScopeStackServiceToken,
+  I as SelectionServiceToken,
+  W as SettingsServiceToken,
+  h as TextEditorFocusToken,
+  K as ThemeServiceToken,
+  U as ValidatorPoint,
+  ge as WHEN_TRUE,
+  w as WorkspaceFilesCapability,
+  x as WorkspaceFilesServiceToken,
+  F as WorkspaceResourcesCapability,
+  L as WorkspaceResourcesServiceToken,
+  A as WorkspaceSaveCapability,
+  H as WorkspaceSaveServiceToken,
+  V as argsOfEditor,
+  X as argsOfResource,
+  z as asResourceTarget,
+  G as chordOfCommand,
+  ke as compileWhen,
+  Y as defineCapability,
+  j as definePlugin,
+  q as defineService,
+  B as detectPlatformModifier,
+  ve as evaluateWhen,
+  J as formatChord,
+  Q as formatKeybinding,
+  Ce as normalizeChord,
+  Pe as normalizeKeybinding,
+  Ee as parseWhen,
+  Z as pluginDiagnosticCode,
+  $ as pluginMessageKey,
+  ee as pluginSettingsKey,
+  ae as selectedIds,
+  se as splitDiagnosticCode,
+  ie as splitMessageKey,
+  oe as splitName,
+  te as usableFixes,
+  ne as useActiveDocument,
+  re as useTranslate,
+  ce as validateResourceName,
+  le as whenEditor,
+  Se as whenResource,
+  Te as withUsableFixes
+};

package/dist/internal.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Платформенные примитивы ЦЕЛИКОМ — вход для оболочки билдера, а не для плагина.
+ *
+ * Контрактом плагина остаётся `.` (см. `./index`), и он обязан оставаться КУРИРОВАННЫМ:
+ * попади сюда путевая арифметика, `toDisposable` и генератор неповторяющихся имён, свойство
+ * «цена платформы для плагина видна в одном файле» перестало бы что-либо значить. Но модули
+ * от этого не делятся надвое: `makeResourceId` живёт там же, где `ResourceId`, потому что
+ * это его конструктор, и растащить их значило бы завести два места для одного понятия.
+ *
+ * Отсюда второй вход. Обещаний совместимости у него нет: он существует ради того, чтобы
+ * оболочка билдера пользовалась ТЕМИ ЖЕ модулями, а не своей копией, и меняется вместе с ней.
+ *
+ * @module @reformer/builder-plugin-api/internal
+ */
+export * from './plugin/layout.js';
+export * from './plugin/manifest.js';
+export * from './plugin/manifest-parser.js';
+export * from './plugin/messages-bundle.js';
+export * from './plugin/permissions.js';
+export * from './plugin/plugin-exports.js';
+export * from './plugin/runtime-modules.js';
+export * from './plugin/storage.js';
+export * from './plugin/types.js';
+export * from './primitives/capability.js';
+export * from './primitives/command.js';
+export * from './primitives/disposable.js';
+export * from './primitives/event.js';
+export * from './primitives/extension-point.js';
+export * from './primitives/module-path.js';
+export * from './primitives/resource.js';
+export * from './primitives/semver.js';
+export * from './primitives/service.js';
+export * from './primitives/when-context.js';
+export * from './primitives/when-expr.js';
+export * from './services/context-keys.js';
+export * from './services/diagnostics/fixes.js';
+export * from './services/diagnostics/service.js';
+export * from './services/diagnostics/types.js';
+export * from './services/documents.js';
+export * from './services/i18n.js';
+export * from './services/notifications.js';
+export * from './services/plugin-settings.js';
+export * from './services/prompt.js';
+export * from './services/resource-clipboard.js';
+export * from './services/selection.js';
+export * from './services/settings.js';
+export * from './services/theme.js';
+export * from './services/validation/types.js';
+export * from './services/workspace-files.js';
+export * from './services/plugins-catalog.js';
+export * from './services/workspace-resources.js';
+export * from './services/workspace-save.js';
+export * from './services/preview.js';
+export * from './services/document-models.js';
+export * from './services/modules.js';
+export * from './services/host-messages.js';
+export * from './ui/contributions/decorations.js';
+export * from './ui/contributions/editors.js';
+export * from './ui/contributions/plugin-settings.js';
+export * from './ui/keyboard/keybinding-rules.js';
+export * from './ui/keyboard/keybindings.js';
+export * from './ui/keyboard/keymap.js';
+export * from './ui/keyboard/scope.js';
+export * from './ui/menu/editor-menu.js';
+export * from './ui/menu/menu.js';
+export * from './ui/menu/palette.js';
+export * from './ui/menu/resource-menu.js';
+export * from './ui/slots.js';
+export * from './ui/useActiveDocument.js';
+export * from './ui/useLocale.js';
+export * from './ui/useTranslate.js';
+export * from './workspace/document.js';
+export * from './workspace/model/editor-view-states.js';
+export * from './workspace/model/provider.js';
+export * from './workspace/model/model-document.js';
+export * from './workspace/model/text-editor-focus.js';
+export * from './workspace/resource-names.js';
+export * from './workspace/write-options.js';