@olddevs/ui 4.5.1 → 4.6.1

package/src/editor/core/schema.ts

@@ -63,6 +63,13 @@ export const RICH_TEXT_SCHEMA = {
    * Стоит на верхнем уровне и прямо в колонке Раскладки; внутри — Блоки, кроме
    * другой Обёртки и Раскладки.
    *
+   * `details` — сворачиваемый Блок: `details > summary` и следом
+   * `div[data-type="detailsContent"]` с Блоками; `open` — только у `details` и
+   * только пустым (`open=""`), так его пишет Редактор с Опцией `persist`.
+   * `summary` вне `details` и обёртка содержимого вне него снимаются —
+   * Блоки остаются подряд. Теги и атрибуты Блока открыты только в этой форме:
+   * `iframe` и ему подобное так не открывается.
+   *
    * Таблица — `table > tbody > tr > th|td`, без `thead`, `colgroup` и
    * `caption`: строка-заголовок — это обычная первая строка из `th`. На ячейке
    * бывают только слияние (`colspan`, `rowspan`) и выравнивание столбца
@@ -94,6 +101,8 @@ export const RICH_TEXT_SCHEMA = {
     "figure",
     "img",
     "figcaption",
+    "details",
+    "summary",
   ],
   /**
    * Метки и строчные узлы. `br` — мягкий перенос по Shift+Enter. `mark` —
@@ -112,9 +121,13 @@ export const RICH_TEXT_SCHEMA = {
      * Раскладка и её колонка: `data-block="layout"` и `data-block="column"`;
      * `data-layout` — вариант из `layouts`, только у Раскладки. Обёртка —
      * `data-block="wrapper"` и, если у неё есть тон, `data-tone` — имя из
-     * `wrapperTones`, только у Обёртки. У `div` пункта чек-листа атрибутов нет.
+     * `wrapperTones`, только у Обёртки. Обёртка содержимого сворачиваемого
+     * Блока — `data-type="detailsContent"`, только прямо в `details`. У `div`
+     * пункта чек-листа атрибутов нет.
      */
-    div: ["data-block", "data-layout", "data-tone"],
+    div: ["data-block", "data-layout", "data-tone", "data-type"],
+    /** Открытый сворачиваемый Блок: пустой `open`, только с Опцией `persist`. */
+    details: ["open"],
     /** Пункт чек-листа: `data-type="taskItem"` и `data-checked="true|false"`. */
     li: ["data-type", "data-checked"],
     /** Флажок пункта чек-листа: всегда `type="checkbox"`, `checked` — у отмеченного. */
@@ -369,8 +382,8 @@ function customAttributes(
  * набор отвергает ошибкой поля, а у сервера ошибок нет — и описание с именем
  * кита (`wrapper`, атрибут `tone`) не должно открыть обход правил кита.
  *
- * Читаются только данные описания (`blocks`, `marks`), Часть для движка не
- * трогается: модуль с описанием своего Инструмента импортируется на сервере,
+ * Читаются только данные описания (`blocks`, `marks`), Extensions не
+ * трогаются: модуль с описанием своего Инструмента импортируется на сервере,
  * и Tiptap здесь не нужен.
  */
 export function richTextSchema(tools: readonly ToolEntry[] = []): RichTextSchema {
@@ -584,6 +597,10 @@ export interface RichTextPurifier {
  *   колонке Раскладки, не в другой Обёртке, списке, цитате и таблице; иначе
  *   снимается так же, вместе с тоном; `data-tone` — имя из `wrapperTones` и
  *   только на Обёртке;
+ * - сворачиваемый Блок — `details` с `summary` прямо в нём и обёрткой содержимого
+ *   `div[data-type="detailsContent"]` тоже прямо в нём; `open` — только пустой и
+ *   только на `details`. `summary` и обёртка вне `details` теряют тег, их Блоки
+ *   остаются подряд;
  * - `colspan`, `rowspan` — на `th`/`td`, целое от 1 до `tableSpans`;
  * - ссылка — `href` по `protocols` (выражение конфига), `rel` всегда
  *   `"noopener noreferrer"`, ссылка без адреса становится текстом;
@@ -648,7 +665,14 @@ const ATTRIBUTE_RULES: Record<string, (node: Element, value: string) => boolean>
   start: (node) => node.nodeName === "OL",
   "data-type": (node, value) =>
     (node.nodeName === "UL" && value === "taskList") ||
-    (node.nodeName === "LI" && value === "taskItem"),
+    (node.nodeName === "LI" && value === "taskItem") ||
+    // Обёртка содержимого сворачиваемого Блока: только `div` прямо в `details`.
+    (node.nodeName === "DIV" &&
+      value === DETAILS_CONTENT &&
+      node.parentElement?.nodeName === "DETAILS"),
+  // Открытый Блок: `open=""`, как его пишет Редактор; значение `open="open"` из
+  // чужого HTML атрибут теряет, Блок остаётся закрытым.
+  open: (node, value) => node.nodeName === "DETAILS" && value === "",
   "data-checked": (node, value) =>
     node.nodeName === "LI" &&
     node.getAttribute("data-type") === "taskItem" &&
@@ -787,6 +811,9 @@ const PARENT_OF: Record<string, string> = {
   SPAN: `${TASK_ITEM} > label`,
 };
 
+/** Значение `div[data-type]` обёртки содержимого сворачиваемого Блока (`details.ts`). */
+const DETAILS_CONTENT = "detailsContent";
+
 /** Значения `div[data-block]`: Раскладка, её колонка и Обёртка. */
 const LAYOUT_BLOCK = "layout";
 const COLUMN_BLOCK = "column";
@@ -794,10 +821,10 @@ const WRAPPER_BLOCK = "wrapper";
 
 /**
  * Где Раскладки быть не может: в другой Раскладке (её колонке), в Обёртке, в
- * списке, цитате и ячейке. Редактор такую не отдаёт — у колонки и прочих контейнеров
+ * списке, цитате, ячейке и сворачиваемом Блоке. Редактор такую не отдаёт — у колонки и прочих контейнеров
  * в Схеме движка её нет, — и при загрузке разворачивает в Блоки подряд.
  */
-const NOT_A_LAYOUT_PLACE = "div[data-block], li, blockquote, th, td";
+const NOT_A_LAYOUT_PLACE = "div[data-block], li, blockquote, th, td, details";
 
 /**
  * Раскладка, колонка и Обёртка: `true` — элемент обработан (оставлен или
@@ -868,6 +895,14 @@ function checkStructure(node: Element, schema: RichTextSchema): void {
     return;
   }
   if (node.nodeName === "SPAN" && coloured) return;
+  // Сворачиваемый Блок: `summary` — только прямо в `details`, обёртка
+  // содержимого с `data-type` — тоже (атрибут уже снят хуком, если она не там).
+  // Вне Блока они теряют обёртку, содержимое остаётся.
+  if (node.nodeName === "SUMMARY") {
+    if (node.parentElement?.nodeName !== "DETAILS") node.replaceWith(...node.childNodes);
+    return;
+  }
+  if (node.nodeName === "DIV" && node.getAttribute("data-type") === DETAILS_CONTENT) return;
   // Картинка — `img` с адресом прямо внутри `figure`, и только так: `figure`
   // без годной картинки разворачивается в содержимое, `img` вне `figure` или без
   // адреса удаляется, `figcaption` вне `figure` теряет обёртку.

package/src/editor/core/shortcuts.ts

@@ -1,5 +1,5 @@
 import type { UiMessages } from "../../i18n/messages.js";
-import { describedTools, toolLabel, type ToolList } from "./toolDescriptor.js";
+import { toolLabel, type ToolList } from "./toolDescriptor.js";
 import type { PrefixedName } from "./customTool.js";
 import type { Tool } from "./tools.js";
 
@@ -65,7 +65,94 @@ export interface ShortcutCommand {
 const LIST_TOOLS: readonly Tool[] = ["bulletList", "orderedList", "taskList"];
 
 /**
- * Таблица — сочетания кита и Инструментов, ещё не переехавших на описание.
+ * Сочетания встроенных команд по id — данные, а не привязки. Строка справочника
+ * берёт клавиши отсюда, где бы она ни жила: в `SHORTCUTS` или в описании
+ * Инструмента (`shortcuts`, `keys` кнопки). Поэтому подписи Меню вставки и «¶»,
+ * которые читаются при загрузке модуля (`shortcutKeys`), не зависят от того,
+ * где лежит строка.
+ */
+export const SHORTCUT_KEYS = {
+  selectBlock: ["mod", "A"],
+  selectDocument: ["mod", "A"],
+  undo: ["mod", "Z"],
+  redo: ["mod", "shift", "Z"],
+  duplicateBlock: ["mod", "shift", "D"],
+  moveBlockUp: ["alt", "shift", "↑"],
+  moveBlockDown: ["alt", "shift", "↓"],
+  blockActions: ["mod", "/"],
+  clearFormatting: ["mod", "\\"],
+  bold: ["mod", "B"],
+  italic: ["mod", "I"],
+  strike: ["mod", "shift", "S"],
+  underline: ["mod", "U"],
+  code: ["mod", "E"],
+  superscript: ["mod", "."],
+  subscript: ["mod", ","],
+  paragraph: ["mod", "alt", "0"],
+  h1: ["mod", "alt", "1"],
+  h2: ["mod", "alt", "2"],
+  h3: ["mod", "alt", "3"],
+  h4: ["mod", "alt", "4"],
+  blockquote: ["mod", "shift", "B"],
+  codeBlock: ["mod", "alt", "C"],
+  bulletList: ["mod", "shift", "8"],
+  orderedList: ["mod", "shift", "7"],
+  taskList: ["mod", "shift", "9"],
+  indentListItem: ["mod", "]"],
+  outdentListItem: ["mod", "["],
+  alignLeft: ["mod", "shift", "L"],
+  alignCenter: ["mod", "shift", "E"],
+  alignRight: ["mod", "shift", "R"],
+  focusToolbar: ["alt", "F10"],
+} as const satisfies Record<string, readonly string[]>;
+
+/** Id строки справочника из таблицы кита. */
+export type ShortcutId = keyof typeof SHORTCUT_KEYS;
+
+/**
+ * Порядок строк справочника внутри групп — привилегия кита, как `INSERT_ORDER`
+ * у Меню вставки, и не зависит от того, где живёт строка: в `SHORTCUTS` или в
+ * описании Инструмента. Строки вне списка (кнопки описаний, свои Инструменты)
+ * встают в конец своей группы в порядке набора.
+ */
+export const SHORTCUT_ORDER: readonly ShortcutId[] = [
+  "selectBlock",
+  "selectDocument",
+  "undo",
+  "redo",
+  "duplicateBlock",
+  "moveBlockUp",
+  "moveBlockDown",
+  "blockActions",
+  "clearFormatting",
+  "bold",
+  "italic",
+  "strike",
+  "underline",
+  "code",
+  "superscript",
+  "subscript",
+  "paragraph",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "blockquote",
+  "codeBlock",
+  "bulletList",
+  "orderedList",
+  "taskList",
+  "indentListItem",
+  "outdentListItem",
+  "alignLeft",
+  "alignCenter",
+  "alignRight",
+  "focusToolbar",
+];
+
+/**
+ * Таблица — сочетания кита: команды, которые есть при любом наборе (выделение,
+ * Блоки, сдвиг пункта списка, `Alt+F10`). Строки Инструментов — в их описаниях.
  * Сочетание кнопки описания — поле самой кнопки (`toolDescriptor.ts`): её
  * строку справочник берёт оттуда, клавишу вешает `toolButtons.ts`.
  */
@@ -75,45 +162,36 @@ export const SHORTCUTS: readonly ShortcutCommand[] = [
     id: "selectBlock",
     group: "selection",
     tool: null,
-    keys: ["mod", "A"],
+    keys: SHORTCUT_KEYS.selectBlock,
     label: (m) => m.selectBlock,
   },
   {
     id: "selectDocument",
     group: "selection",
     tool: null,
-    keys: ["mod", "A"],
+    keys: SHORTCUT_KEYS.selectDocument,
     label: (m) => m.selectDocument,
   },
 
-  { id: "undo", group: "history", tool: "history", keys: ["mod", "Z"], label: (m) => m.undo },
-  {
-    id: "redo",
-    group: "history",
-    tool: "history",
-    keys: ["mod", "shift", "Z"],
-    label: (m) => m.redo,
-  },
-
   {
     id: "duplicateBlock",
     group: "blocks",
     tool: null,
-    keys: ["mod", "shift", "D"],
+    keys: SHORTCUT_KEYS.duplicateBlock,
     label: (m) => m.duplicateBlock,
   },
   {
     id: "moveBlockUp",
     group: "blocks",
     tool: null,
-    keys: ["alt", "shift", "↑"],
+    keys: SHORTCUT_KEYS.moveBlockUp,
     label: (m) => m.moveBlockUp,
   },
   {
     id: "moveBlockDown",
     group: "blocks",
     tool: null,
-    keys: ["alt", "shift", "↓"],
+    keys: SHORTCUT_KEYS.moveBlockDown,
     label: (m) => m.moveBlockDown,
   },
   // Меню ручки Блока: ручка есть в любой правке, при любой Панели.
@@ -121,172 +199,41 @@ export const SHORTCUTS: readonly ShortcutCommand[] = [
     id: "blockActions",
     group: "blocks",
     tool: null,
-    keys: ["mod", "/"],
+    keys: SHORTCUT_KEYS.blockActions,
     label: (m) => m.blockActions,
   },
 
-  {
-    id: "clearFormatting",
-    group: "clear",
-    tool: "clearFormatting",
-    keys: ["mod", "\\"],
-    label: (m) => m.clearFormatting,
-  },
-
-  { id: "bold", group: "marks", tool: "bold", keys: ["mod", "B"], label: (m) => m.bold },
-  { id: "italic", group: "marks", tool: "italic", keys: ["mod", "I"], label: (m) => m.italic },
-  {
-    id: "strike",
-    group: "marks",
-    tool: "strike",
-    keys: ["mod", "shift", "S"],
-    label: (m) => m.strike,
-  },
-  {
-    id: "underline",
-    group: "marks",
-    tool: "underline",
-    keys: ["mod", "U"],
-    label: (m) => m.underline,
-  },
-  { id: "code", group: "marks", tool: "code", keys: ["mod", "E"], label: (m) => m.code },
-  {
-    id: "superscript",
-    group: "marks",
-    tool: "superscript",
-    keys: ["mod", "."],
-    label: (m) => m.superscript,
-  },
-  {
-    id: "subscript",
-    group: "marks",
-    tool: "subscript",
-    keys: ["mod", ","],
-    label: (m) => m.subscript,
-  },
-
-  // Подпись — как у пункта «¶» («Текст»), а не «Абзац» Меню вставки: справочник
-  // называет команду тем словом, которым её выбирают на Панели.
-  {
-    id: "paragraph",
-    group: "blockType",
-    tool: "heading",
-    keys: ["mod", "alt", "0"],
-    label: (m) => m.textBlock,
-  },
-  {
-    id: "h1",
-    group: "blockType",
-    tool: "heading1",
-    requires: "heading",
-    keys: ["mod", "alt", "1"],
-    label: (m) => m.heading({ level: 1 }),
-  },
-  {
-    id: "h2",
-    group: "blockType",
-    tool: "heading",
-    keys: ["mod", "alt", "2"],
-    label: (m) => m.heading({ level: 2 }),
-  },
-  {
-    id: "h3",
-    group: "blockType",
-    tool: "heading",
-    keys: ["mod", "alt", "3"],
-    label: (m) => m.heading({ level: 3 }),
-  },
-  {
-    id: "h4",
-    group: "blockType",
-    tool: "heading",
-    keys: ["mod", "alt", "4"],
-    label: (m) => m.heading({ level: 4 }),
-  },
-  {
-    id: "codeBlock",
-    group: "blockType",
-    tool: "codeBlock",
-    keys: ["mod", "alt", "C"],
-    label: (m) => m.codeBlock,
-  },
-
-  {
-    id: "bulletList",
-    group: "lists",
-    tool: "bulletList",
-    keys: ["mod", "shift", "8"],
-    label: (m) => m.bulletList,
-  },
-  {
-    id: "orderedList",
-    group: "lists",
-    tool: "orderedList",
-    keys: ["mod", "shift", "7"],
-    label: (m) => m.orderedList,
-  },
-  {
-    id: "taskList",
-    group: "lists",
-    tool: "taskList",
-    keys: ["mod", "shift", "9"],
-    label: (m) => m.taskList,
-  },
   {
     id: "indentListItem",
     group: "lists",
     tool: LIST_TOOLS,
-    keys: ["mod", "]"],
+    keys: SHORTCUT_KEYS.indentListItem,
     label: (m) => m.indentListItem,
   },
   {
     id: "outdentListItem",
     group: "lists",
     tool: LIST_TOOLS,
-    keys: ["mod", "["],
+    keys: SHORTCUT_KEYS.outdentListItem,
     label: (m) => m.outdentListItem,
   },
 
-  {
-    id: "alignLeft",
-    group: "align",
-    tool: "align",
-    keys: ["mod", "shift", "L"],
-    label: (m) => m.alignLeft,
-  },
-  {
-    id: "alignCenter",
-    group: "align",
-    tool: "align",
-    keys: ["mod", "shift", "E"],
-    label: (m) => m.alignCenter,
-  },
-  {
-    id: "alignRight",
-    group: "align",
-    tool: "align",
-    keys: ["mod", "shift", "R"],
-    label: (m) => m.alignRight,
-  },
-
   {
     id: "focusToolbar",
     group: "toolbar",
     tool: null,
-    keys: ["alt", "F10"],
+    keys: SHORTCUT_KEYS.focusToolbar,
     label: (m) => m.focusToolbar,
   },
 ];
 
-const BY_ID = new Map(SHORTCUTS.map((command) => [command.id, command]));
-
 /**
  * Сочетание команды по id или `undefined`, если у команды его нет. Панель
  * спрашивает так про каждую свою кнопку: у горизонтальной линии, картинки и
  * меню цвета сочетаний нет.
  */
 export function findShortcutKeys(id: string): readonly string[] | undefined {
-  return BY_ID.get(id)?.keys;
+  return Object.hasOwn(SHORTCUT_KEYS, id) ? SHORTCUT_KEYS[id as ShortcutId] : undefined;
 }
 
 /**
@@ -318,21 +265,13 @@ export interface ShortcutSection {
   commands: readonly ShortcutRow[];
 }
 
-/**
- * Место строки переехавшего Инструмента в своей группе: id строки → id строки
- * из `SHORTCUTS`, перед которой она встаёт. Остальные переехавшие строки идут
- * в конец группы. Порядок справочника — не поле описания: место на поверхности
- * держит кит, как `INSERT_ORDER` у Меню вставки.
- */
-const MOVED_BEFORE: Readonly<Record<string, string>> = { blockquote: "codeBlock" };
-
 /**
  * Команды включённых инструментов по группам; пустые группы не возвращаются.
  *
- * Проекция списка описаний: строки не переехавших Инструментов — из
- * `SHORTCUTS`, переехавших — из их описаний (`toolDescriptor.ts`): клавиши
- * Части для движка — поле `shortcuts`, сочетания кнопок — поле кнопки. Строка
- * встаёт на место из `MOVED_BEFORE` или следом за строками своей группы кита;
+ * Проекция списка описаний: строки кита — из `SHORTCUTS`, строки Инструментов —
+ * из их описаний (`toolDescriptor.ts`): клавиши
+ * Extensions — поле `shortcuts`, сочетания кнопок — поле кнопки. Место
+ * строки в группе — `SHORTCUT_ORDER`, а строки вне него — следом в порядке набора;
  * кнопка без группы кита — в группу своего Инструмента после групп кита, в
  * порядке списка (ADR-0058, п. 6.8).
  */
@@ -341,25 +280,18 @@ export function shortcutGroupsFor(
   /** Локаль `UiProvider` — для подписи кнопки, заданной функцией от контекста. */
   locale = "en-US"
 ): readonly ShortcutSection[] {
-  const described = describedTools(tools);
+  const described = tools.descriptors;
   const moved = described.flatMap((descriptor) => descriptor.shortcuts ?? []);
-  const anchored = (row: ShortcutCommand) =>
-    SHORTCUTS.some((command) => command.id === MOVED_BEFORE[row.id]);
-  const commands = [
-    ...SHORTCUTS.flatMap((command) => [
-      ...moved.filter((row) => MOVED_BEFORE[row.id] === command.id),
-      command,
-    ]),
-    ...moved.filter((row) => !anchored(row)),
-  ].filter((command) => enabled(command, tools));
+  const commands = [...SHORTCUTS, ...moved].filter((command) => enabled(command, tools));
   const ownGroups: ShortcutSection[] = [];
   for (const descriptor of described) {
     const own: ShortcutRow[] = [];
     for (const button of descriptor.buttons ?? []) {
-      if (!button.shortcut) continue;
+      const keys = button.shortcut ?? button.keys;
+      if (!keys) continue;
       const row: ShortcutRow = {
         id: button.id,
-        keys: button.shortcut,
+        keys,
         label: (messages) => toolLabel(button.label, { locale, messages }),
       };
       // Набор уже отфильтрован: кнопка есть только у включённого Инструмента.
@@ -380,10 +312,17 @@ export function shortcutGroupsFor(
     }
     if (own.length > 0) ownGroups.push({ group: descriptor.name, commands: own });
   }
+  // Сортировка устойчивая: строки вне `SHORTCUT_ORDER` сохраняют порядок набора.
+  const rank = (id: string) => {
+    const index = (SHORTCUT_ORDER as readonly string[]).indexOf(id);
+    return index === -1 ? SHORTCUT_ORDER.length : index;
+  };
   return [
     ...SHORTCUT_GROUPS.map((group) => ({
       group,
-      commands: commands.filter((command) => command.group === group),
+      commands: commands
+        .filter((command) => command.group === group)
+        .sort((left, right) => rank(left.id) - rank(right.id)),
     })),
     ...ownGroups,
   ].filter((entry) => entry.commands.length > 0);

package/src/editor/core/skeleton.ts

@@ -19,9 +19,9 @@ import type { ToolLoader } from "./toolLoader.js";
   набора и выгружается обратно в HTML — в документ, тоже инертный. Что Схема не
   знает (теги, атрибуты, обработчики, `javascript:`), не доходит до страницы.
 
-  Схема — та, что получит движок, но без Частей для движка, чьи загрузчики ещё
+  Схема — та, что получит движок, но без Extensions, чьи загрузчики ещё
   не отработали: их Блоки видны текстом, обёртку Схема снимает. Ленивый
-  встроенный (`codeBlock`, `table`) вместо Части для движка даёт
+  встроенный (`codeBlock`, `table`) вместо Extensions даёт
   форму Блоков (`skeleton` описания) — его Блоки видны своей разметкой, и поле
   не прыгает с приходом чанка. Шапка блока кода — та же, что у `RichTextView`
   (`withCodeHeaders`): в Редакторе она есть, и без неё Скелет был бы ниже. Набор
@@ -37,6 +37,7 @@ const SCHEMA_ONLY: Omit<EditorExtensionOptions, "tools"> = {
   placeholder: () => "",
   limit: () => undefined,
   taskCheckbox: (text) => text,
+  detailsToggle: (text) => text,
   openPopover: quiet,
   focusToolbar: no,
   openBlockMenu: no,
@@ -83,7 +84,7 @@ function cleaned(html: string, tools: ToolList): string | null {
 }
 
 /**
- * Документ Скелета: `html`, очищенный Схемой набора без Частей ещё не
+ * Документ Скелета: `html`, очищенный Схемой набора без Extensions ещё не
  * отработавших загрузчиков (`pending`). Только в браузере.
  *
  * Набор с ошибкой своих Инструментов Схемы не даёт (ошибка поля, ADR-0058,

package/src/editor/core/toolButtons.ts

@@ -70,9 +70,9 @@ export function keymapName(keys: readonly string[]): string {
 }
 
 /**
- * Часть для движка у кнопок описаний (ADR-0058, п. 5.7): сочетание — поле
- * записи и единственный его источник, поэтому клавишу вешает кит, а не Часть
- * для движка Инструмента. `run` выполняется, поповер открывается у выделения.
+ * Сочетания у кнопок описаний (ADR-0058, п. 5.7): сочетание — поле
+ * записи и единственный его источник, поэтому клавишу вешает кит, а не
+ * Extensions Инструмента. `run` выполняется, поповер открывается у выделения.
  * Недоступная кнопка клавишу не берёт: она идёт дальше, в Документ.
  */
 export const ToolButtons = Extension.create<ToolButtonsOptions>({

package/src/editor/core/toolDefinition.ts

@@ -10,7 +10,7 @@ import { isConfiguredTool, mergeOptions } from "./toolOptions.js";
   же формой `CustomTool` (ADR-0058): отдельного пути сборки у определения нет,
   кит собирает из него обычное описание Инструмента (`describeDefinition`), и
   все правила своего Инструмента — Префикс потребителя, уникальность имени,
-  проверки набора, загрузчик Части для движка — действуют как были.
+  проверки набора, загрузчик Extensions — действуют как были.
 
   ИМЯ ФАЙЛА — НЕ `defineTool.ts`. Под этим именем сборка потребителя на Next.js
   15.5 (`check:consumer`) теряла `RichTextEditor` из клиентского манифеста RSC:
@@ -107,14 +107,14 @@ export interface ToolDefinition<
  * - `defaults` — полный набор Опций; тип Опций выводится из него, второй раз его
  *   объявлять не нужно.
  * - `create(options)` отдаёт тело описания — ту же форму, что `CustomTool`, без
- *   имени: Часть для движка, правила Схемы, UI-записи. Зовётся один раз на запись
+ *   имени: Extensions, правила Схемы, UI-записи. Зовётся один раз на запись
  *   `tools` (определение само или объект, что вернул `tool(definition, options)`):
  *   кит запоминает результат, и Остров, замкнутый над Опциями, один и тот же на
  *   каждом рендере. Запись, созданная заново на каждом рендере экрана
  *   (`tools={[tool(mention, …)]}` в теле компонента), для кита новая — выносите
- *   `tools` из рендера. Загрузчик Части для движка стоит держать константой
+ *   `tools` из рендера. Загрузчик Extensions стоит держать константой
  *   модуля: кэш загрузчика живёт на самой функции, а новая функция на каждый
- *   вызов `create` загружала бы Часть заново для каждой записи.
+ *   вызов `create` загружала бы Extensions заново для каждой записи.
  * - `state({ editor, options })` — Состояние для `useRichTextToolState(ref, name)`.
  *   Зовётся при каждой транзакции и при каждом чтении хука, поэтому должна быть
  *   быстрой и без побочных эффектов; вернуть — данные без DOM-узлов. Простые данные