@olddevs/ui 4.5.1 → 4.6.0

package/src/editor/core/blockTypes.ts

@@ -1,20 +1,8 @@
 "use client";
 
-import type { ChainedCommands } from "@tiptap/core";
 import type { Node as PmNode } from "@tiptap/pm/model";
 import type { EditorState } from "@tiptap/pm/state";
-import type { ComponentType } from "react";
-import {
-  Heading1Icon,
-  Heading2Icon,
-  Heading3Icon,
-  Heading4Icon,
-  ListIcon,
-  OrderedListIcon,
-  TaskListIcon,
-  TextIcon,
-  type IconProps,
-} from "../../icons.js";
+import { TextIcon } from "../../icons.js";
 import type { PrefixedName } from "./customTool.js";
 import type { InsertItem } from "./insertItems.js";
 import { shortcutKeys } from "./shortcuts.js";
@@ -30,8 +18,8 @@ import type { Tool } from "./tools.js";
  * заново — одной транзакцией, на одну отмену. Своего пути смены типа у меню
  * нет: два пути разошлись бы на первом же списке внутри цитаты.
  *
- * Отдельный реестр, а не выборка из `INSERT_ITEMS`, потому что у меню «¶»
- * другие слова и иконки: «Текст» с иконкой `T`, а не
+ * Пункты «¶» — поле описания `blockTypes`, а не выборка из `insertItems`,
+ * потому что у меню «¶» могут быть другие слова и иконки: «Текст» с иконкой `T`, а не
  * «Абзац» с пилкроу, и уровень заголовка на иконке. Блока кода в нём нет — у
  * него своя кнопка Панели.
  */
@@ -61,70 +49,24 @@ export function turnIntoTypes(
     .map((item) => ({ ...item, section: "turnInto", tool, keys: item.keys ?? [] }));
 }
 
-const heading = (level: 1 | 2 | 3 | 4, icon: ComponentType<IconProps>): BlockTypeItem => ({
-  id: `heading${level}`,
-  section: "turnInto",
-  tool: "heading",
-  alsoTool: level === 1 ? "heading1" : undefined,
-  label: (m) => m.heading({ level }),
-  icon,
-  keys: shortcutKeys(`h${level}`),
-  run: (chain: ChainedCommands) => chain.setHeading({ level }),
-});
-
 /**
- * Пункты «¶» по порядку показа. Сочетания — подписи из общей таблицы
- * (`shortcuts.ts`), по тем же id, что у Меню вставки и справочника:
- * вешают их расширения движка, и подпись обязана совпадать с ними.
+ * «Текст» — пункт кита, а не Инструмента: абзац есть в любом наборе. Сочетание —
+ * подпись из общей таблицы (`shortcuts.ts`): вешает его расширение движка.
  */
-export const BLOCK_TYPE_ITEMS: readonly BlockTypeItem[] = [
-  {
-    id: "text",
-    section: "turnInto",
-    tool: null,
-    label: (m) => m.textBlock,
-    icon: TextIcon,
-    keys: shortcutKeys("paragraph"),
-    run: (chain) => chain.setParagraph(),
-  },
-  heading(1, Heading1Icon),
-  heading(2, Heading2Icon),
-  heading(3, Heading3Icon),
-  heading(4, Heading4Icon),
-  {
-    id: "bulletList",
-    section: "turnInto",
-    tool: "bulletList",
-    label: (m) => m.bulletList,
-    icon: ListIcon,
-    keys: shortcutKeys("bulletList"),
-    run: (chain) => chain.toggleBulletList(),
-  },
-  {
-    id: "orderedList",
-    section: "turnInto",
-    tool: "orderedList",
-    label: (m) => m.orderedList,
-    icon: OrderedListIcon,
-    keys: shortcutKeys("orderedList"),
-    run: (chain) => chain.toggleOrderedList(),
-  },
-  {
-    id: "taskList",
-    section: "turnInto",
-    tool: "taskList",
-    label: (m) => m.taskList,
-    icon: TaskListIcon,
-    keys: shortcutKeys("taskList"),
-    run: (chain) => chain.toggleTaskList(),
-  },
-];
+const TEXT_ITEM: BlockTypeItem = {
+  id: "text",
+  section: "turnInto",
+  tool: null,
+  label: (m) => m.textBlock,
+  icon: TextIcon,
+  keys: shortcutKeys("paragraph"),
+  run: (chain) => chain.setParagraph(),
+};
 
 /**
  * Место встроенных Инструментов в «¶». «Текст» стоит первым всегда: абзац —
- * не Инструмент. Держится отдельно от `BLOCK_TYPE_ITEMS`: Инструмент,
- * переехавший на описание (`toolDescriptor.ts`), уходит из реестра, а место
- * остаётся здесь.
+ * не Инструмент. Пункты живут в описаниях, а место на поверхности — привилегия
+ * кита.
  */
 const BLOCK_TYPE_ORDER: readonly Tool[] = [
   "heading",
@@ -135,18 +77,12 @@ const BLOCK_TYPE_ORDER: readonly Tool[] = [
 ];
 
 /**
- * Пункты «¶» набора — проекция списка описаний: у переехавшего Инструмента —
- * из описания (`blockTypes`), у остальных — из `BLOCK_TYPE_ITEMS`.
+ * Пункты «¶» набора: «Текст» и проекция списка описаний (`blockTypes`).
  */
 function blockTypeItemsOf(tools: ToolList): readonly BlockTypeItem[] {
   return [
-    ...BLOCK_TYPE_ITEMS.filter((item) => item.tool === null),
-    ...projectRecords(
-      tools,
-      BLOCK_TYPE_ORDER,
-      (tool) => BLOCK_TYPE_ITEMS.filter((item) => item.tool === tool),
-      (descriptor) => descriptor.blockTypes
-    ),
+    TEXT_ITEM,
+    ...projectRecords(tools, BLOCK_TYPE_ORDER, (descriptor) => descriptor.blockTypes),
   ].filter((item) => item.alsoTool === undefined || tools.has(item.alsoTool));
 }
 

package/src/editor/core/containers.ts

@@ -24,8 +24,9 @@ export { WRAPPER_NODE };
 
 /**
  * Узлы, внутри которых контейнерного Блока нет ни одного: Обёртка, цитата,
- * пункты списков и ячейки таблицы. Колонки здесь нет — Обёртку она принимает;
- * Раскладка добавляет её своим аргументом.
+ * пункты списков, ячейки таблицы и содержимое сворачиваемого Блока
+ * (`details.ts`). Колонки здесь нет — Обёртку она принимает; Раскладка
+ * добавляет её своим аргументом.
  */
 const CONTAINER_FREE_NODES = [
   WRAPPER_NODE,
@@ -34,6 +35,7 @@ const CONTAINER_FREE_NODES = [
   "taskItem",
   "tableCell",
   "tableHeader",
+  "detailsContent",
 ];
 
 /**

package/src/editor/core/customMarkdown.ts

@@ -12,7 +12,7 @@ import { devWarn } from "../../lib/dev-warn.js";
 /*
   Markdown своего Инструмента по умолчанию (ADR-0058, п. 3.1).
 
-  Свои правила Markdown — в Части для движка: `renderMarkdown` и токенайзер
+  Свои правила Markdown — в Extensions: `renderMarkdown` и токенайзер
   Tiptap, отдельного поля в описании нет. Без них `@tiptap/markdown` молча
   выгрузил бы узел пустой строкой — вместе со всем текстом внутри. Поэтому
   Node и Mark без `renderMarkdown` кит дописывает сам: Блок выгружается своим
@@ -31,7 +31,7 @@ export const MARKDOWN_FALLBACK = "kitMarkdownFallback";
 /** Предупреждение о Markdown по умолчанию — одно на Инструмент (`devWarn` помнит текст). */
 export function warnNoMarkdown(tool: string): void {
   devWarn(
-    `custom tool "${tool}" has no Markdown rules (renderMarkdown in its engine part): ` +
+    `custom tool "${tool}" has no Markdown rules (renderMarkdown in its Extensions): ` +
       "getMarkdown() writes its blocks as their content and its atoms as their text"
   );
 }

package/src/editor/core/customTool.ts

@@ -67,7 +67,7 @@ export interface CustomBlock {
   /**
    * Остров Блока в `RichTextView` — клиентский компонент из модуля с
    * директивой `"use client"` (ADR-0058, п. 3.3). Без него Блок в Просмотре —
-   * очищенный HTML. Редактор поле не читает: его вид — Часть для движка.
+   * очищенный HTML. Редактор поле не читает: его вид задают Extensions.
    *
    * Только компонент из модуля с директивой: серверный компонент и функция-
    * загрузчик через границу RSC не проходят — сервер получает ссылку на
@@ -103,7 +103,7 @@ export interface CustomMark {
  * встроенных (`ToolDescriptor`, ADR-0058, п. 10). Передаётся в `tools`
  * вперемешку с именами Инструментов кита.
  *
- * Обязательное — имя, Часть для движка и правила Схемы для каждого Блока и
+ * Обязательное — имя, Extensions и правила Схемы для каждого Блока и
  * Метки, которые она определяет. Остальное — по умолчанию (ADR-0058, п. 1.6):
  * обычный Блок без Признаков, без UI-записей.
  */
@@ -111,8 +111,8 @@ export interface CustomTool {
   /** Имя с Префиксом потребителя, уникальное в `tools`. */
   name: PrefixedName;
   /**
-   * Часть для движка — расширения Tiptap: Node, Mark, Extension, плагины
-   * ProseMirror, React-вид узла, `renderText` атома. Её контракт следует
+   * Extensions — расширения Tiptap: Node, Mark, Extension, плагины
+   * ProseMirror, React-вид узла, `renderText` атома. Их контракт следует
    * мажору Tiptap. Node и Mark стоят на верхнем уровне массива: группу,
    * разбор HTML и свои атрибуты им ставит кит по правилам.
    *
@@ -123,9 +123,9 @@ export interface CustomTool {
    * того поле показывает Скелет; промис кэшируется на функции загрузчика.
    */
   engine: Extensions | (() => Promise<Extensions>);
-  /** Правила Схемы для каждого Node Части для движка — по имени узла. */
+  /** Правила Схемы для каждого Node из Extensions — по имени узла. */
   blocks?: Readonly<Record<PrefixedName, CustomBlock>>;
-  /** Правила Схемы для каждой Mark Части для движка — по имени Метки. */
+  /** Правила Схемы для каждой Mark из Extensions — по имени Метки. */
   marks?: Readonly<Record<PrefixedName, CustomMark>>;
 
   /* UI-записи (ADR-0058, п. 5 и 6): кнопки, пункты вставки и Действия над Блоком. */

package/src/editor/core/customToolEngine.ts

@@ -43,13 +43,13 @@ import { loaded } from "./toolLoader.js";
   Свой Инструмент в движке (ADR-0058, разделы 1 и 2): из
   публичного описания — внутреннее, и проверка набора при сборке.
 
-  ПРАВИЛА СХЕМЫ — ЕДИНСТВЕННЫЙ ИСТОЧНИК HTML. Node и Mark Части для движка кит
+  ПРАВИЛА СХЕМЫ — ЕДИНСТВЕННЫЙ ИСТОЧНИК HTML. Node и Mark из Extensions кит
   дописывает сам: группу и строчность — по виду Блока, разбор HTML — только
   `div|span[data-block="<имя>"]` и `span[data-mark="<имя>"]`, свои атрибуты —
   `data-<имя>` со значением по виду из правил, Признаки Блока — в spec узла.
   Своё правило разбора чужого Блока поэтому не займёт тег кита, а значение вне
   правил не войдёт в Документ ни из `value`, ни из вставки: проверяет код кита,
-  и ослабить проверку Частью для движка нельзя. Поведение — содержимое,
+  и ослабить проверку через Extensions нельзя. Поведение — содержимое,
   `atom`, React-вид, `renderText`, команды — остаётся за потребителем.
 */
 
@@ -67,7 +67,7 @@ function allowed(rule: CustomAttribute, value: unknown): string | null {
   return isAllowedAttributeValue(rule, text) ? text : null;
 }
 
-/** Node или Mark Части для движка, дописанный по своим правилам Схемы. */
+/** Node или Mark из Extensions, дописанный по своим правилам Схемы. */
 function bindRules(extension: AnyExtension, tool: CustomTool): AnyExtension {
   const { name } = extension;
   const block = extension.type === "node" ? blocksOf(tool)[name] : undefined;
@@ -80,7 +80,7 @@ function bindRules(extension: AnyExtension, tool: CustomTool): AnyExtension {
   const config = {
     ...markdownFallback(extension, tool.name),
     parseHTML: () => [{ tag: selector }],
-    // Свой `renderHTML` остаётся у Части для движка (текст внутри атома);
+    // Свой `renderHTML` остаётся у Extensions (текст внутри атома);
     // соглашение с ним сверяет `customToolsError`.
     ...(getExtensionField(extension, "renderHTML") === undefined && {
       renderHTML: ({ node, HTMLAttributes }: { node?: PmNode; HTMLAttributes: object }) =>
@@ -211,7 +211,7 @@ function uiRecords(tool: CustomTool) {
   return { insertItems, blockTypes, blockActions, textCards };
 }
 
-/** Часть для движка: массив сразу или то, что отдал загрузчик; не массив — пустая. */
+/** Extensions: массив сразу или то, что отдал загрузчик; не массив — пустой массив. */
 function engineOf(tool: CustomTool): Extensions {
   const engine = typeof tool.engine === "function" ? loaded(tool.engine) : tool.engine;
   return Array.isArray(engine) ? engine : [];
@@ -222,7 +222,7 @@ export function describeCustomTool(tool: CustomTool): ToolDescriptor {
   return {
     name: tool.name,
     custom: tool,
-    // Загрузчик: правила Схемы ложатся на Часть, когда она пришла (`engineOf`).
+    // Загрузчик: правила Схемы ложатся на Extensions, когда они пришли (`engineOf`).
     load: typeof tool.engine === "function" ? tool.engine : undefined,
     engine: () => engineOf(tool).map((extension) => bindRules(extension, tool)),
     ...uiRecords(tool),
@@ -330,8 +330,8 @@ export interface CustomToolsError {
 /**
  * Ошибка сборки набора Инструментов или `null` (ADR-0058, п. 1.5, 2.4).
  *
- * Имя без Префикса потребителя, совпадение имён, Node или Mark Части для
- * движка без правил Схемы (и правило без них), атрибут, которого нет в
+ * Имя без Префикса потребителя, совпадение имён, Node или Mark из
+ * Extensions без правил Схемы (и правило без них), атрибут, которого нет в
  * правилах, HTML мимо соглашения, Схема, которую движок не собрал, — всё это
  * потеря данных на сервере или в самом Редакторе, и автор должен увидеть её
  * до первого сохранения. `extensions` — полный набор движка, свои уже в нём.
@@ -442,7 +442,7 @@ export function customToolsError(tools: ToolList, extensions: Extensions): Custo
         if (extra) return fail(`has attribute "${extra}" with no rule`);
         /*
           HTML — по соглашению: `toDOM` экземпляра по умолчанию даёт тег и
-          метку с именем. Свой `renderHTML` Части для движка мог уйти от них, и
+          метку с именем. Свой `renderHTML` в Extensions мог уйти от них, и
           тогда Блок не прочитался бы обратно из собственного `getHTML()`.
         */
         const { tag, marker } = customElement(

package/src/editor/core/extensions.ts

@@ -7,35 +7,25 @@
 
 import { Extension, type Extensions } from "@tiptap/core";
 import { Plugin, PluginKey } from "@tiptap/pm/state";
-import { TaskItem, TaskList } from "@tiptap/extension-list";
-import { Subscript } from "@tiptap/extension-subscript";
-import { Superscript } from "@tiptap/extension-superscript";
 import { Placeholder } from "@tiptap/extensions";
-import { StarterKit } from "@tiptap/starter-kit";
+import { StarterKit, type StarterKitOptions } from "@tiptap/starter-kit";
 import { AtomText } from "./atomText.js";
 import { BlockCommands, BlockMenuKey } from "./blockCommands.js";
 import { FieldNoticeExtension, type FieldNoticeOptions } from "./fieldNotice.js";
-import { RichImage, type RichImageOptions } from "../features/image/image.js";
+import type { RichImageOptions } from "../features/image/image.js";
 import { createDocumentNode } from "./document.js";
-import { LAYOUT_NODE, layoutExtensions } from "../features/layout/layout.js";
 import { createMarkdown, MarkdownPaste } from "./markdown.js";
 import { MaxLength } from "./maxLength.js";
+import { TriggerCommand, type SlashBridge, type TriggerBinding } from "./slashCommand.js";
 import {
-  HighlightExtension,
-  TEXT_COLOR_EXTENSIONS,
-  TextAlignExtension,
-} from "../features/color/styleExtensions.js";
-import {
-  SlashCommand,
-  TriggerCommand,
-  type SlashBridge,
-  type TriggerBinding,
-} from "./slashCommand.js";
-import { describedTools, type ToolList } from "./toolDescriptor.js";
+  type BlockTraits,
+  type ToolDescriptor,
+  type ToolEngineContext,
+  type ToolList,
+} from "./toolDescriptor.js";
 import { ToolButtons, type ToolPopoverEntry, type ToolPopoverRequest } from "./toolButtons.js";
 import { ToolEntryShortcuts } from "./toolEntryShortcuts.js";
 import type { Tool } from "./tools.js";
-import { WRAPPER_EXTENSIONS, WRAPPER_NODE } from "../features/wrapper/wrapper.js";
 
 export interface EditorExtensionOptions {
   /** Включённые инструменты: выключенный не попадает в Схему вовсе. */
@@ -46,6 +36,11 @@ export interface EditorExtensionOptions {
   limit: () => number | undefined;
   /** Имя флажка пункта чек-листа — из каталога, читается при каждой перерисовке пункта. */
   taskCheckbox: (text: string) => string;
+  /**
+   * Имя кнопки раскрытия сворачиваемого Блока по тексту его заголовка — из
+   * каталога, читается при каждой перерисовке кнопки.
+   */
+  detailsToggle: (text: string) => string;
   /**
    * Мост Меню вставки по `/`. Нет — меню не открывается: инструмент
    * `insertMenu` выключен или пунктов для него нет.
@@ -123,6 +118,115 @@ const HandledTabStaysInside = Extension.create({
   ],
 });
 
+/**
+ * Признаки Блоков описаний (`blocks`) — в spec узлов Схемы: `blockContainer`,
+ * `turnInto` и `plainAtom`, которые читают ручка и Меню выделения. Расширение
+ * без разметки: `extendNodeSchema` у Tiptap зовётся для каждого узла набора, и
+ * признак находит свой узел по имени. Нет признаков — расширения нет.
+ */
+function blockTraitsExtension(traits: Readonly<Record<string, BlockTraits>>) {
+  return Extension.create({
+    name: "blockTraits",
+    extendNodeSchema: (extension) => {
+      const own = Object.hasOwn(traits, extension.name) ? traits[extension.name] : undefined;
+      return own
+        ? {
+            blockContainer: own.container === true,
+            turnInto: own.turnInto === true,
+            plainAtom: own.plainAtom === true,
+          }
+        : {};
+    },
+  });
+}
+
+/**
+ * Ключи StarterKit, которые принадлежат Инструментам. Все выключены, пока их не
+ * включит доля описания (`starterKit`): Метка, которой нет в наборе, не
+ * попадает в Схему. Цитата, разделитель, блок кода и
+ * ссылка — свои расширения кита, а `trailingNode` выключен всегда (см. выше).
+ * Документ, абзац, текст, перенос, пункт списка, его клавиши и курсоры
+ * StarterKit остаются его умолчаниями: они есть в любом наборе.
+ */
+const STARTER_KIT_OFF: Partial<StarterKitOptions> = {
+  heading: false,
+  bold: false,
+  italic: false,
+  underline: false,
+  strike: false,
+  code: false,
+  bulletList: false,
+  orderedList: false,
+  undoRedo: false,
+  blockquote: false,
+  codeBlock: false,
+  horizontalRule: false,
+  link: false,
+  trailingNode: false,
+};
+
+/** Место символов-триггеров в `ENGINE_ORDER`: они не Инструмент, но порядок держат. */
+const TRIGGERS = "triggers";
+
+/**
+ * ПОРЯДОК РЕГИСТРАЦИИ Extensions встроенных Инструментов — привилегия кита, как
+ * порядок поверхностей, и описание его не задаёт. От него зависят:
+ *
+ * - **ранг Меток** — а с ним вложенность Меток в сохранённом HTML;
+ * - **вставка и drop** (ADR-0058, п. 9.5): плагины ProseMirror у Tiptap идут в
+ *   обратном порядке регистрации при равном `priority`, и зарегистрированное
+ *   последним опрашивается первым. Свои Инструменты стоят после встроенных
+ *   (`expandTools`), поэтому `transformPastedHTML`, `transformPasted`,
+ *   `handlePaste` и `handleDrop` своего Инструмента видят событие раньше и могут
+ *   забрать его. Давать встроенному плагину `priority` выше 100 нельзя без правки
+ *   этого правила;
+ * - **клавиши**: `Enter`, `Backspace` и стрелки сворачиваемого Блока (`details`)
+ *   срабатывают только в его заголовке и в пустом конце содержимого, поэтому
+ *   с клавишами других Блоков не спорят. Он стоит сразу за контейнерами
+ *   (Раскладка, Обёртка): позже ядра и StarterKit, значит, опрашивается раньше
+ *   них — `Enter` в заголовке уходит в содержимое, а не режет заголовок надвое;
+ * - **клавиши**: `Alt+F10` блока кода (`codeBlockTool.ts`) зарегистрирован после
+ *   `ToolbarFocus` и опрашивается раньше; Tab в таблице — раньше Раскладки.
+ *
+ * Список сохраняет порядок, который был до переезда встроенных на описания, —
+ * эталонные тесты (`rich-text-editor-golden.test.tsx`) держат сохранённый HTML и клавиши. Метки и
+ * Блоки из StarterKit регистрирует он сам, в своём порядке.
+ */
+const ENGINE_ORDER: readonly (Tool | typeof TRIGGERS)[] = [
+  "superscript",
+  "subscript",
+  "color",
+  "highlight",
+  "align",
+  "taskList",
+  "image",
+  "layout",
+  "wrapper",
+  "details",
+  "insertMenu",
+  TRIGGERS,
+  "history",
+  "heading",
+  "heading1",
+  "bold",
+  "italic",
+  "underline",
+  "strike",
+  "code",
+  "clearFormatting",
+  "link",
+  "bulletList",
+  "orderedList",
+  "blockquote",
+  "codeBlock",
+  "horizontalRule",
+  "table",
+  "emoji",
+  "source",
+  "search",
+  "toc",
+];
+
 /**
  * Набор расширений — это и есть Схема в коде: что не зарегистрировано здесь,
  * ProseMirror не разберёт ни из `value`, ни из буфера. Белый список ДАННЫМИ,
@@ -148,56 +252,29 @@ const HandledTabStaysInside = Extension.create({
  *   `codeBlock` из StarterKit: язык из `codeLanguages.ts` и подсветка
  *   декорациями lowlight (ADR-0051). В Документ по-прежнему уходит только
  *   `class="language-*"` на `<code>`. Оно, как и таблица, приходит
- *   ленивой Частью для движка из описания (`codeBlockTool.ts`, `tableTool.ts`).
+ *   из описания ленивыми Extensions (`codeBlockTool.ts`, `tableTool.ts`).
  */
 export function createEditorExtensions(options: EditorExtensionOptions): Extensions {
   /*
-    Движок — проекция списка описаний (`toolDescriptor.ts`): Часть для движка
-    переехавшего Инструмента берётся из описания, остальных — отсюда, как
-    раньше. `on` — «Инструмент включён и его расширение ещё здесь»; связи
-    между Инструментами (уровни заголовка, Обёртка в колонке) спрашивают сам
-    набор.
+    Движок — проекция списка описаний (`toolDescriptor.ts`): Extensions
+    Инструмента берутся из его описания. Связи между Инструментами (уровни
+    заголовка, Обёртка в колонке) спрашивают `has` контекста.
   */
-  const described = describedTools(options.tools);
-  const on = (tool: Tool) =>
-    options.tools.has(tool) && !described.some((descriptor) => descriptor.name === tool);
-  // `false` выключает расширение внутри StarterKit, `undefined` оставляет его
-  // настройки по умолчанию.
-  const toggle = (tool: Tool) => (on(tool) ? undefined : false);
+  const described = options.tools.descriptors;
+  // Без самого набора: связи между Инструментами — только через `has`.
+  const { tools, ...bridges } = options;
+  const context: ToolEngineContext = { ...bridges, has: (tool) => tools.has(tool) };
   // Контейнеры Блоков верхнего уровня: их принимает только свой Документ.
-  const containers = [
-    ...(on("layout") ? [LAYOUT_NODE] : []),
-    ...(on("wrapper") ? [WRAPPER_NODE] : []),
-    ...described.flatMap((descriptor) => descriptor.documentContent ?? []),
-  ];
+  const containers = described.flatMap((descriptor) => descriptor.documentContent ?? []);
 
   const extensions: Extensions = [
     StarterKit.configure({
+      ...STARTER_KIT_OFF,
+      // Доли описаний — одним StarterKit: порядок его Меток не меняется.
+      ...Object.assign({}, ...described.map((descriptor) => descriptor.starterKit?.(context))),
       // С Раскладкой или Обёрткой Документ — свой (`document.ts`): они не в
       // группе `block`, и принять их может только тот, кто назвал их поимённо.
       document: containers.length > 0 ? false : undefined,
-      // H1 — только с `heading1`; без него `#` и `<h1>` остаются
-      // прежними: правило ввода и разбор HTML строятся по этим уровням.
-      heading: on("heading")
-        ? { levels: options.tools.has("heading1") ? [1, 2, 3, 4] : [2, 3, 4] }
-        : false,
-      bold: toggle("bold"),
-      italic: toggle("italic"),
-      underline: toggle("underline"),
-      strike: toggle("strike"),
-      code: toggle("code"),
-      bulletList: toggle("bulletList"),
-      orderedList: toggle("orderedList"),
-      // Цитата и разделитель переехали на описание (`features/builtins.ts`): их Часть для движка — оттуда.
-      blockquote: false,
-      // Блок кода — `RichCodeBlock` из описания (`codeBlockTool.ts`): язык и подсветка (ADR-0051).
-      codeBlock: false,
-      horizontalRule: false,
-      undoRedo: toggle("history"),
-      // Ссылка — `RichLink` из описания Инструмента (`linkTool.tsx`): StarterKit
-      // отдаёт только опции, а разбор `<a>` нужно сузить до Схемы.
-      link: false,
-      trailingNode: false,
     }),
     ...(containers.length > 0 ? [createDocumentNode(containers)] : []),
     Placeholder.configure({ placeholder: () => options.placeholder() }),
@@ -212,64 +289,36 @@ export function createEditorExtensions(options: EditorExtensionOptions): Extensi
     HandledTabStaysInside,
     // Команды над Блоками — своей разметки нет, включены всегда (`blockCommands.ts`).
     // После ядра Tiptap: его `Mod+A` (весь Документ) опрашивается позже нашего.
-    BlockCommands.configure({ clearFormatting: on("clearFormatting") }),
+    BlockCommands.configure({ clearFormatting: options.tools.has("clearFormatting") }),
     // `⌘/` — меню ручки Блока по месту клавиши, раньше карт Меток (`blockCommands.ts`).
     BlockMenuKey.configure({ openBlockMenu: options.openBlockMenu }),
     // `showNotice` — в каждом Редакторе: сообщить может любой Инструмент (`fieldNotice.ts`).
     FieldNoticeExtension.configure({ onNotice: options.onNotice }),
   ];
-  if (on("superscript")) extensions.push(Superscript);
-  if (on("subscript")) extensions.push(Subscript);
-  // Цвет, маркер и выравнивание пишут `data-color` и `data-align`, а не `style`
-  // (`styleExtensions.ts`; единственное исключение — цвет автора, `customColor.ts`):
-  // выключенный инструмент не отдаёт ни атрибута, ни правила разбора, и такой
-  // атрибут из вставки отбрасывается.
-  if (on("color")) extensions.push(...TEXT_COLOR_EXTENSIONS);
-  if (on("highlight")) extensions.push(HighlightExtension);
-  if (on("align")) extensions.push(TextAlignExtension);
-  if (on("taskList")) {
-    extensions.push(
-      TaskList,
-      TaskItem.configure({
-        // Вложенные чек-листы — как вложенные обычные списки: Tab и Shift+Tab.
-        nested: true,
-        a11y: { checkboxLabel: (node) => options.taskCheckbox(node.textContent) },
-      })
-    );
-  }
-  // Картинка — `figure` с подписью (`image.ts`). Без инструмента `<img>` из
-  // вставки и `value` отбрасывается, а файлы из буфера не перехватываются.
-  if (on("image") && options.image) extensions.push(RichImage.configure(options.image));
-  // Раскладка — узлы колонок и их клавиатура (`layout.ts`). Без инструмента
-  // `div[data-block]` из вставки и `value` не разбирается, и Блоки колонок
-  // встают в Документ подряд.
-  if (on("layout")) extensions.push(...layoutExtensions({ wrapper: options.tools.has("wrapper") }));
-  // Обёртка — узел и выход из неё по Enter (`wrapper.ts`). Без инструмента
-  // `div[data-block="wrapper"]` из вставки и `value` не разбирается, и её
-  // Блоки встают на её место подряд.
-  if (on("wrapper")) extensions.push(...WRAPPER_EXTENSIONS);
-  if (on("insertMenu") && options.slash) {
-    extensions.push(SlashCommand.configure({ bridge: options.slash }));
+  // Признаки Блоков описаний (`blocks`) — одним расширением на весь набор.
+  const traits: Record<string, BlockTraits> = Object.assign(
+    {},
+    ...described.map((descriptor) => descriptor.blocks)
+  );
+  if (Object.keys(traits).length > 0) extensions.push(blockTraitsExtension(traits));
+  // Extensions встроенных Инструментов — в порядке кита, свои — следом в порядке списка.
+  const engineOf = (descriptor: ToolDescriptor) =>
+    descriptor.engine?.(context, descriptor.options) ?? [];
+  for (const slot of ENGINE_ORDER) {
+    if (slot === TRIGGERS) {
+      if (options.triggers?.length) {
+        extensions.push(TriggerCommand.configure({ triggers: options.triggers }));
+      }
+      continue;
+    }
+    const descriptor = described.find((candidate) => candidate.name === slot);
+    if (descriptor) extensions.push(...engineOf(descriptor));
   }
-  if (options.triggers?.length) {
-    extensions.push(TriggerCommand.configure({ triggers: options.triggers }));
+  for (const descriptor of described) {
+    if (!(ENGINE_ORDER as readonly string[]).includes(descriptor.name)) {
+      extensions.push(...engineOf(descriptor));
+    }
   }
-  /*
-    Части для движка переехавших Инструментов — в порядке списка. ЗДЕСЬ ЖЕ
-    ЗАДАЁТСЯ ПОРЯДОК ВСТАВКИ И DROP (ADR-0058, п. 9.5): плагины ProseMirror у
-    Tiptap идут в обратном порядке регистрации при равном `priority`, и
-    зарегистрированное последним опрашивается первым. Свои Инструменты стоят в
-    конце списка (`expandTools`: за встроенными), а встроенные вставка Markdown,
-    загрузка картинок и Раскладка зарегистрированы выше — поэтому
-    `transformPastedHTML`, `transformPasted`, `handlePaste` и `handleDrop` своего
-    Инструмента видят событие раньше и могут забрать его. Менять порядок
-    регистрации или давать встроенному плагину `priority` выше 100 нельзя без
-    правки этого правила. На том же порядке держится `Alt+F10` блока кода
-    (`codeBlockTool.ts`): его расширение здесь, после `ToolbarFocus`, и
-    опрашивается раньше.
-  */
-  for (const descriptor of described)
-    extensions.push(...(descriptor.engine?.(options, descriptor.options) ?? []));
   // Сочетания кнопок описаний вешает кит: поле записи — их единственный источник.
   const buttons = described.flatMap((descriptor) => descriptor.buttons ?? []);
   // Поповер пункта вставки и Действия открывает та же команда, что у кнопки.
@@ -281,8 +330,14 @@ export function createEditorExtensions(options: EditorExtensionOptions): Extensi
     .flatMap(({ id, label, popover }): ToolPopoverEntry[] =>
       popover ? [{ id, label: ({ messages, locale }) => label(messages, locale), popover }] : []
     );
-  if (buttons.length + entries.length > 0) {
-    extensions.push(ToolButtons.configure({ buttons, entries, openPopover: options.openPopover }));
+  // Кнопке без сочетания и поповера (отмена, картинка) расширение не нужно: её
+  // `run` зовёт Панель. Так набор расширений не меняется от того, что кнопка
+  // переехала в описание.
+  const keyed = buttons.filter((button) => button.shortcut || button.popover);
+  if (keyed.length + entries.length > 0) {
+    extensions.push(
+      ToolButtons.configure({ buttons: keyed, entries, openPopover: options.openPopover })
+    );
   }
   // То же — у пунктов вставки и Действий над Блоком.
   const keyedItems = described.flatMap((d) => d.insertItems ?? []).filter((i) => i.shortcut);