@olddevs/ui 4.5.1 → 4.6.1

package/docs/icons.en.md

@@ -2,7 +2,7 @@
 entrypoint: "@olddevs/ui/icons"
 source: src/icons.ts
 status: stable
-sourceHash: d5e61db56b70
+sourceHash: 8b6aa04a1c0a
 ---
 
 # Icons `@olddevs/ui/icons`
@@ -113,9 +113,10 @@ import { DeleteIcon, SearchIcon } from "@olddevs/ui/icons";
 | Vertical "more": the Block menu     | `MoreVerticalIcon`                              | `MoreIcon`, `DragHandleIcon`   |
 | Duplicate next to the original      | `DuplicateIcon`                                 | `CopyIcon`                     |
 | Arrow up / down                     | `ArrowUpIcon`, `ArrowDownIcon`                  | `ChevronUpIcon`, `SortIcon`    |
-| Document Layout in columns          | `ColumnLayoutIcon`                              | `ColumnsIcon`                  |
+| A Column layout of the Document     | `ColumnLayoutIcon`                              | `ColumnsIcon`                  |
 | Wrapper: a group of Blocks          | `WrapperIcon`                                   | `ColumnLayoutIcon`             |
 | Remove the Wrapper, keep the Blocks | `UnwrapIcon`                                    | `DeleteIcon`                   |
+| Collapsible Block of the Editor     | `DetailsIcon`                                   | `ChevronDownIcon`              |
 
 ## Subject topics
 
@@ -184,15 +185,15 @@ has no checkboxes, so that a list of records does not read as "done".
 The only visible label on the Toolbar buttons is the icon; the button's name
 comes from `aria-label`, and the keyboard shortcut is shown by a tooltip.
 
-The Insert menu added `ParagraphIcon` (¶) — the "Turn into
+The Slash menu added `ParagraphIcon` (¶) — the "Turn into
 paragraph" item. `HeadingIcon` does not fit it: that one is a heading in general, with no
-level. The "+" button of the Insert menu reuses the existing `AddIcon`.
+level. The "+" button of the Slash menu reuses the existing `AddIcon`.
 
 The Block type menu "¶" (under ADR-0049) added
 `Heading1Icon`–`Heading4Icon` (a heading with the level digit) and `TextIcon` (the letter
 "T", the "Text" item). `HeadingIcon` remains the icon of a heading without a level: the items of the
-Insert menu need it that way. `TextIcon` does not repeat `ParagraphIcon`: that one is
-the "paragraph" pilcrow in the Insert menu, and this one is "Text" in the Block type menu. The "¶" button
+Slash menu need it that way. `TextIcon` does not repeat `ParagraphIcon`: that one is
+the "paragraph" pilcrow in the Slash menu, and this one is "Text" in the Block type menu. The "¶" button
 on the Toolbar shows the icon of the current type: the icon of its menu item,
 `CodeBlockIcon` in a code Block, or the pilcrow `ParagraphIcon` when there is no text
 Block under the caret (an image is selected).
@@ -211,11 +212,13 @@ The Block handle added four names: `MoreVerticalIcon` — "⋮", the button of t
 
 Emoji added `EmojiIcon` — a smiley face, the button of the emoji grid in the Toolbar. The name is by the meaning "emoji", not by the glyph: a face elsewhere would mean mood or rating, and that would be a different decision under ADR-0049.
 
-HTML mode added `SourceIcon` — a sheet with `</>` (`FileCode`), the "HTML" button of the Toolbar: the source code of the whole Document. `CodeBlockIcon` already means a code Block inside a Document, and `CodeIcon` the subject topic "development"; a third meaning is not attached to them (ADR-0049).
+Source mode added `SourceIcon` — a sheet with `</>` (`FileCode`), the "HTML" button of the Toolbar: the source code of the whole Document. `CodeBlockIcon` already means a code Block inside a Document, and `CodeIcon` the subject topic "development"; a third meaning is not attached to them (ADR-0049).
 
-Layout added `ColumnLayoutIcon` — two columns, the "Layout" item of the Insert menu. `ColumnsIcon` with three columns already means "choosing the columns of a data table", and a second meaning is not attached to it (ADR-0049): the Layout has its own glyph.
+Column layout added `ColumnLayoutIcon` — two columns, the "Layout" item of the Slash menu. `ColumnsIcon` with three columns already means "choosing the columns of a data table", and a second meaning is not attached to it (ADR-0049): the Column layout has its own glyph.
 
-Wrapper added the pair `WrapperIcon` and `UnwrapIcon` — lucide's `Group` and `Ungroup`: a frame with dashed corners around two Blocks and the same Blocks without a frame. The icons sit at the "Wrapper" item of the Insert menu and the "Remove Wrapper" item in the Block handle menu. This is not `ColumnLayoutIcon`: columns put Blocks side by side, while a Wrapper groups them without changing their order. `DeleteIcon` does not fit removal: only the container is deleted, not the content.
+Wrapper added the pair `WrapperIcon` and `UnwrapIcon` — lucide's `Group` and `Ungroup`: a frame with dashed corners around two Blocks and the same Blocks without a frame. The icons sit at the "Wrapper" item of the Slash menu and the "Remove Wrapper" item in the Block handle menu. This is not `ColumnLayoutIcon`: columns put Blocks side by side, while a Wrapper groups them without changing their order. `DeleteIcon` does not fit removal: only the container is deleted, not the content.
+
+Collapsible block added `DetailsIcon` — lucide's `ListCollapse`: a list with collapse arrows, the "Collapsible block" item of the Slash menu. The dictionary had no fitting name: `ChevronDownIcon` is a step and nesting, `CollapseIcon` is collapsing a window, while here it is a whole Block with a title and hidden content. Removing the Block uses the already taken `UnwrapIcon` (ADR-0049).
 
 The first iteration of the table made do with two icons for four directions
 (`AddRowIcon`, `AddColumnIcon`) and an icon for the separate "Table

package/docs/icons.md

@@ -115,6 +115,7 @@ import { DeleteIcon, SearchIcon } from "@olddevs/ui/icons";
 | Раскладка Документа колонками        | `ColumnLayoutIcon`                              | `ColumnsIcon`                  |
 | Обёртка: группа Блоков               | `WrapperIcon`                                   | `ColumnLayoutIcon`             |
 | Снять Обёртку, Блоки остаются        | `UnwrapIcon`                                    | `DeleteIcon`                   |
+| Сворачиваемый Блок Редактора         | `DetailsIcon`                                   | `ChevronDownIcon`              |
 
 ## Предметные темы
 
@@ -216,6 +217,8 @@ HTML-режим добавил `SourceIcon` — лист с `</>` (`FileCode`),
 
 Обёртка добавила пару `WrapperIcon` и `UnwrapIcon` — `Group` и `Ungroup` у lucide: рамка пунктирными углами вокруг двух Блоков и те же Блоки без рамки. Иконки стоят у пункта «Обёртка» Меню вставки и пункта «Снять обёртку» в меню Ручки Блока. Это не `ColumnLayoutIcon`: колонки ставят Блоки рядом, а Обёртка группирует их, не меняя порядка. Для снятия не подходит `DeleteIcon`: удаляется только контейнер, а не содержимое.
 
+Сворачиваемый Блок добавил `DetailsIcon` — `ListCollapse` у lucide: список со стрелками сворачивания, пункт «Сворачиваемый блок» Меню вставки. Подходящего имени в словаре не было: `ChevronDownIcon` — шаг и вложенность, `CollapseIcon` — свернуть окно, а здесь Блок целиком с заголовком и спрятанным содержимым. Снять Блок — уже занятый `UnwrapIcon` (ADR-0049).
+
 Первый срез таблицы обходился двумя рисунками на четыре направления
 (`AddRowIcon`, `AddColumnIcon`) и иконкой отдельной кнопки «Действия с
 таблицей» (`TableEditIcon`). С меню «Таблица» кнопка ушла, а направление

package/docs/palette.en.md

@@ -61,7 +61,7 @@ blue tint of `cloud`: the background of the inverse surface in the light theme.
 
 ### Tones
 
-The "Used by" column is the only way to see why a family has exactly this many
+The "Used by" column is the only way to see why a color scale has exactly this many
 steps: each one exists for a specific role in a specific theme, and there are no spare ones.
 
 | Primitive       | Value     | Used by                                                          |
@@ -155,7 +155,7 @@ text, borders, shadows and `--topbar-bg`, and takes tones and accent from the da
 ### Inverse surface
 
 A pill that has to differ from everything around it by sign, not by step
-of brightness: the Editor's Selection menu (`toolbar="bubble"`), which sits directly on the
+of brightness: the Editor's Bubble menu (`toolbar="bubble"`), which sits directly on the
 Document. Light in the dark themes, dark in the light one. It has the utilities
 `bg-surface-inverse`, `bg-surface-inverse-hover`, `bg-surface-inverse-pressed`,
 `text-text-on-inverse`, `outline-accent-on-inverse`.
@@ -366,7 +366,7 @@ VS Code and macOS; 3:1 is not the goal, because in a dark theme such a fill no l
 holds 4.5:1 for light text on top of it. `--selection-light` is the light variant in
 any app theme: the Editor's Paper (`surface="paper"`) takes it.
 `--selection-dark` is the dark mirror in any theme: the Editor's
-HTML mode field takes it, dark in the light theme too; the dark themes assign
+Source mode field takes it, dark in the light theme too; the dark themes assign
 it to `--selection`.
 
 The `teal` brand primitives are declared inside its own block and are not part of the shared

package/docs/theming.en.md

@@ -25,11 +25,11 @@ it writes the class `bg-bg-0`, backed by the `@theme` bridge.
 
 ### Layer 1 — primitives
 
-Three neutral ramps, one per theme (`slate` for dark, `cloud` for light,
-`navy` for dim), and seven tone families. Within a ramp the step number increases with lightness:
+Three neutral scales, one per theme (`slate` for dark, `cloud` for light,
+`navy` for dim), and seven tone scales. Within a scale the step number increases with lightness:
 1 is the darkest, 12 the lightest.
 
-Three ramps instead of one is not duplication: each theme's neutrals are tuned
+Three scales instead of one is not duplication: each theme's neutrals are tuned
 by hand for its own background, and reducing them to one scale would mean recoloring two
 themes out of three.
 
@@ -58,7 +58,7 @@ cover both; details and numbers are in the comments of `styles.css`.
 
 **Inverse surface** is a separate group of roles for a pill
 that sits directly on the Document and has to differ from it by polarity, not by a single
-step: the Editor's Selection menu. `--surface-inverse` (the background),
+step: the Editor's Bubble menu. `--surface-inverse` (the background),
 `--surface-inverse-hover` and `--surface-inverse-pressed` (hover and press),
 `--text-on-inverse` (text and icons) are light in `dark` and `dim`, and dark in
 `light`. The focus outline on it is `--accent-on-inverse`: it is the `--accent-strong`
@@ -71,7 +71,7 @@ a compatibility layer. Components get their colors through them, via Tailwind cl
 
 ### Layer 3 — component tokens
 
-The list is **closed**. A component token is added when a family has a real
+The list is **closed**. A component token is added when a component family has a real
 reason to differ from the semantics, not "just in case"; a token with no reader is
 not added at all.
 
@@ -346,7 +346,7 @@ The order is exactly this, checked on `teal`, which ships in the package as a sa
 
 **3. Check the light theme separately.** `--accent-strong` is read on a background,
 and the light theme almost certainly needs its own step; `--accent-on-inverse` is
-the opposite, light: the Selection menu pill is dark in the light theme. `--selection`
+the opposite, light: the Bubble menu pill is dark in the light theme. `--selection`
 returns to the light variant only here: the brand block comes after the light theme
 in the file and would override it with the dark one.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olddevs/ui",
-  "version": "4.5.1",
+  "version": "4.6.1",
   "description": "Olddevs UI — design system: tokens, themes and accessible UI primitives",
   "license": "MIT",
   "private": false,
@@ -117,6 +117,7 @@
     "@tiptap/core": "^3.31.4",
     "@tiptap/extension-blockquote": "^3.31.4",
     "@tiptap/extension-code-block-lowlight": "^3.31.4",
+    "@tiptap/extension-details": "^3.31.4",
     "@tiptap/extension-highlight": "^3.31.4",
     "@tiptap/extension-horizontal-rule": "^3.31.4",
     "@tiptap/extension-link": "^3.31.4",

package/src/editor/RichTextEditor.tsx

@@ -157,7 +157,7 @@ export interface RichTextEditorProps {
    * Редактор готов: движок создан, методы Хэндла (`ref`) уже действуют — например,
    * вставить шаблон. Без аргументов, один раз за монтаж, в том числе при
    * `readOnly` и `disabled`; перерисовка и смена колбэка повторного вызова не
-   * дают. Ждёт загрузчики Частей для движка своих Инструментов. Серверный
+   * дают. Ждёт загрузчики Extensions своих Инструментов. Серверный
    * рендер, ошибка набора `tools` и упавший загрузчик (движка нет) его не вызывают.
    */
   onReady?: () => void;
@@ -261,7 +261,7 @@ export interface RichTextEditorProps {
    * включает Инструмент и без имени, а имя из пресета уступает ей; две записи
    * `tool()` с одним именем — ошибка поля. Неизвестное имя отбрасывается
    * молча; описание с ошибкой (имя без Префикса потребителя, совпадение имён,
-   * Часть для движка мимо правил Схемы) — ошибка поля: движок не создаётся,
+   * Extensions мимо правил Схемы) — ошибка поля: движок не создаётся,
    * значение формы остаётся входящим, причина — в консоли разработчика.
    *
    * `preset` и `tools`, а с ними и Опции Инструментов, читаются при создании
@@ -522,17 +522,17 @@ export const RichTextEditor = forwardRef<RichTextEditorHandle, RichTextEditorPro
       Набор инструментов замораживается при монтаже: из него собрана Схема, а
       Схему у живого движка не поменять. Панель читает тот же замороженный
       набор — иначе новый `tools` показал бы кнопку, которой Схема не знает.
-      Набор — список описаний Инструментов (`features/builtins.ts`), реестры
+      Набор — список описаний Инструментов (`features/builtins.ts`), поверхности
       читают его проекцию.
     */
     const [enabledTools] = useState(() => expandTools(preset, tools));
     /*
-      Загрузчики Частей для движка (ADR-0058, п. 11.3–11.6). Загрузка стартует
+      Загрузчики Extensions (ADR-0058, п. 11.3–11.6). Загрузка стартует
       в рендере, а не в эффекте: с первого рендера в браузере, ещё до монтажа;
       на сервере — никогда. Промис кэширован на загрузчике (`toolLoader.ts`):
       повторный рендер и второй Редактор его не зовут. Набор движка собирается,
       только когда отработали все (`ready`): Схема фиксируется при создании, и
-      Блоки из `value` без Части для движка потерялись бы при разборе.
+      Блоки из `value` без Extensions потерялись бы при разборе.
     */
     const loaders = enabledTools.descriptors.flatMap((descriptor) => descriptor.load ?? []);
     const loads = loaders.map((loader) =>
@@ -603,6 +603,8 @@ export const RichTextEditor = forwardRef<RichTextEditorHandle, RichTextEditorPro
     placeholderRef.current = placeholderText;
     const taskCheckboxRef = useRef(messages.editor.taskCheckbox);
     taskCheckboxRef.current = messages.editor.taskCheckbox;
+    const detailsToggleRef = useRef(messages.editor.detailsToggle);
+    detailsToggleRef.current = messages.editor.detailsToggle;
     // Загрузчик и строки картинки — тоже через ref: расширение их читает в
     // момент вставки файла и при перерисовке подписи, а не при создании движка.
     const uploadRef = useRef(onUploadImage);
@@ -887,6 +889,7 @@ export const RichTextEditor = forwardRef<RichTextEditorHandle, RichTextEditorPro
           placeholder: () => placeholderRef.current,
           limit: () => limitRef.current,
           taskCheckbox: (text) => taskCheckboxRef.current({ text }),
+          detailsToggle: (text) => detailsToggleRef.current({ text }),
           slash: slashBridge,
           triggers: triggerBindings,
           openPopover: (request) => setToolPopover({ request, open: true }),
@@ -917,7 +920,7 @@ export const RichTextEditor = forwardRef<RichTextEditorHandle, RichTextEditorPro
       `value`. Движок тогда собирается из запасного набора и пустым, а наружу
       не выходит (`editor` ниже — `null`, как до монтажа): Хэндл тихий,
       скрытое поле несёт входящее значение, `onChange` молчит. Набор с
-      загрузчиками проверяется, когда они отработали: Часть для движка — их итог.
+      загрузчиками проверяется, когда они отработали: Extensions — их итог.
     */
     const toolsError = useMemo(
       () => extensions && customToolsError(enabledTools, extensions),

package/src/editor/core/atomText.ts

@@ -16,7 +16,7 @@ import { MARKDOWN_FALLBACK, warnNoMarkdown } from "./customMarkdown.js";
   Текст атома (ADR-0058, раздел 4). Одно правило для встроенных и
   своих атомов, и всё, что выдаёт текст Документа, читает его отсюда:
 
-  - Текст атома даёт `renderText` из Части для движка. Листовой атом без него —
+  - Текст атома даёт `renderText` из Extensions. Листовой атом без него —
     пустая строка, атом с содержимым (картинка с подписью) — текст своих детей;
   - вес атома в `maxLength` — длина этого текста (`countCharacters`);
   - `getText`, `getSelectedText`, копирование текстом и Markdown отдают тот же
@@ -90,7 +90,7 @@ export function atomText(node: ProseMirrorNode): string {
 */
 
 /**
- * Узлы по выгрузке в Markdown: `true` — Часть для движка умеет сама, строка —
+ * Узлы по выгрузке в Markdown: `true` — Extensions умеют сами, строка —
  * атом своего Инструмента без правил (имя Инструмента — для предупреждения).
  */
 function markdownHandled(editor: Editor): Map<string, true | string> {

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(