@olddevs/ui 4.5.1 → 4.6.0

package/src/editor/core/toolDescriptor.ts

@@ -1,4 +1,5 @@
 import type { Editor, Extensions } from "@tiptap/core";
+import type { StarterKitOptions } from "@tiptap/starter-kit";
 import type { ComponentType, ReactNode } from "react";
 import type { UiMessages } from "../../i18n/messages.js";
 import type { IconProps } from "../../icons.js";
@@ -21,7 +22,7 @@ import type { Tool } from "./tools.js";
  * Внутреннее описание встроенного Инструмента (ADR-0058, п. 10).
  *
  * НАДФОРМА. Тип — надмножество будущего публичного описания своего
- * Инструмента: те же Часть для движка, Признаки Блока и UI-записи, а сверху
+ * Инструмента: те же Extensions, Признаки Блока и UI-записи, а сверху
  * привилегии кита, которых своему Инструменту не дают (теги Схемы кита,
  * модель содержимого, виджеты Панели, своё место в порядке поверхности).
  * Наружу описания встроенных не экспортируются: публичны только имена и
@@ -31,36 +32,36 @@ import type { Tool } from "./tools.js";
  * (`expandTools`, `features/builtins.ts`), и реестры по имени — движок, Меню
  * вставки, «¶», справочник сочетаний и следующие за ними — читают его
  * проекцию (`projectRecords`). Правило «выключенный Инструмент убирает и
- * кнопку, и Схему» этим держится само: записи и Часть для движка Инструмента,
+ * кнопку, и Схему» этим держится само: записи и Extensions Инструмента,
  * которого нет в списке, не попадают никуда.
  *
- * ПЕРЕЕЗД ПОСТЕПЕННЫЙ. Встроенный Инструмент без описания стоит в списке
- * заглушкой `legacy` и берётся из старых реестров (`INSERT_ITEMS`, `SHORTCUTS`,
- * `createEditorExtensions`…). Переезд Инструмента — его записи удаляются из
- * старых реестров и ложатся в описание в `BUILTIN_TOOLS`; место на поверхности
- * при этом не меняется — его держит порядок кита этой поверхности
- * (`INSERT_ORDER`, `BLOCK_TYPE_ORDER`), а не реестр записей.
+ * У КАЖДОГО ВСТРОЕННОГО — ОПИСАНИЕ: `BUILTIN_TOOLS` полон, и
+ * компилятор не даст добавить имя в `TOOLS` без описания. Место записи на
+ * поверхности держит порядок кита этой поверхности (`INSERT_ORDER`,
+ * `BLOCK_TYPE_ORDER`, `SHORTCUT_ORDER`, `ENGINE_ORDER`), а не описание. Виджеты
+ * Панели и Меню выделения, «…», подменю Ручки и поповеры картинки остаются
+ * компонентами кита и спрашивают набор по имени (`tools.has`).
  */
 export interface ToolDescriptor {
   /** Имя Инструмента — то же, что в `tools`; у своего — с Префиксом потребителя. */
   name: Tool | PrefixedName;
   /**
-   * Заглушка не переехавшего встроенного: его записи и Часть для движка — в
-   * старых реестрах. Остальные поля у заглушки пусты, кроме `blockActions`:
-   * Действия над Блоком переезжают отдельно от остального и
-   * читаются у всех описаний списка, переехавших и нет (`blockActionsOf`).
-   */
-  legacy?: true;
-
-  /**
-   * Часть для движка: расширения Tiptap Инструмента — Node, Mark, Extension,
+   * Extensions: расширения Tiptap Инструмента — Node, Mark, Extension,
    * плагины ProseMirror. Функция от контекста — привилегия кита: встроенным
    * нужны мосты `RichTextEditor` (поповер ссылки, Меню вставки, `Alt+F10`).
    * Второй аргумент — Опции этого Редактора (`options`), если они есть.
    */
   engine?: (context: ToolEngineContext, options?: object) => Extensions;
   /**
-   * Загрузчик Части для движка (`toolLoader.ts`): движок создаётся после
+   * Доля StarterKit: ключи `StarterKit.configure`, которые включают Блоки и
+   * Метки Инструмента (`bold: {}`, `heading: { levels }`). Привилегия кита.
+   * Доли всех описаний сливаются в ОДИН `StarterKit` (`extensions.ts`): так
+   * порядок Меток в сохранённом HTML и список пакетов движка остаются теми же,
+   * что при StarterKit целиком. Ключ, которого нет ни в одной доле, выключен.
+   */
+  starterKit?: (context: ToolEngineContext) => Partial<StarterKitOptions>;
+  /**
+   * Загрузчик Extensions (`toolLoader.ts`): движок создаётся после
    * загрузчиков всех описаний списка, и `engine` читает отданное `loaded`.
    */
   load?: ToolLoader;
@@ -134,7 +135,7 @@ export interface ToolDescriptor {
   /** Пункты виджета «¶» Панели: у него свои слова и иконки (`blockTypes.ts`). */
   blockTypes?: readonly BlockTypeItem[];
   /**
-   * Строки справочника сочетаний для клавиш, которые вешает Часть для движка
+   * Строки справочника сочетаний для клавиш, которые вешают Extensions
    * (`shortcuts.ts`): у записи сочетание — её поле, а у Метки из движка — нет.
    */
   shortcuts?: readonly ShortcutCommand[];
@@ -189,8 +190,16 @@ export interface ToolBridge {
 /** Символ-триггер Инструмента в списке описаний: публичная запись и имя владельца для сообщений. */
 export type TriggerRecord = CustomTrigger & { tool: string };
 
-/** Что Часть для движка встроенного получает от `RichTextEditor`. */
-export type ToolEngineContext = Omit<EditorExtensionOptions, "tools">;
+/**
+ * Что Extensions встроенного Инструмента получают от `RichTextEditor`: мосты и —
+ * вместо всего набора — вопрос `has`. Связи между Инструментами (уровни
+ * заголовка при `heading1`, Обёртка в колонке Раскладки, очистка формата)
+ * спрашивают его, а не список описаний.
+ */
+export type ToolEngineContext = Omit<EditorExtensionOptions, "tools"> & {
+  /** Включён ли Инструмент кита в этом Редакторе. */
+  has: (tool: Tool) => boolean;
+};
 
 type EditorMessages = UiMessages["editor"];
 
@@ -276,24 +285,38 @@ export type ToolButton = ToolButtonFields &
  * Кнопка встроенного Инструмента: публичная форма и привилегии кита, которых
  * своей кнопке не дают.
  */
-export type KitToolButton = ToolButton & {
-  /**
-   * Группа справочника сочетаний. Нет — строка встаёт в группу Инструмента без
-   * заголовка после групп кита, как у своего Инструмента.
-   */
-  shortcutGroup?: ShortcutGroup;
-  /** Рамка поповера, если она не умолчание кита (у кнопки, по содержимому). */
-  popoverFrame?: {
+export type KitToolButton = ToolButton &
+  (
+    | {
+        /**
+         * Сочетание, которое вешает не кит, а Extensions (`undoRedo` у
+         * StarterKit, `Mod-B` у Метки): только подпись — подсказка,
+         * `aria-keyshortcuts` и строка справочника. Взаимоисключимо с
+         * `shortcut`: та и вешает клавишу, и подписывает её, и две привязки
+         * одной клавиши спорили бы.
+         */
+        keys: readonly string[];
+        shortcut?: undefined;
+      }
+    | { keys?: undefined }
+  ) & {
     /**
-     * `selection` — рамка всегда у выделения, и щелчком по кнопке тоже: поповер
-     * правит выделенный текст, и стоит у него при любом способе открыть
-     * (поповер ссылки).
+     * Группа справочника сочетаний. Нет — строка встаёт в группу Инструмента без
+     * заголовка после групп кита, как у своего Инструмента.
      */
-    anchor?: "selection";
-    /** Классы размера и отступов рамки вместо умолчания `w-auto p-2`. */
-    className?: string;
+    shortcutGroup?: ShortcutGroup;
+    /** Рамка поповера, если она не умолчание кита (у кнопки, по содержимому). */
+    popoverFrame?: {
+      /**
+       * `selection` — рамка всегда у выделения, и щелчком по кнопке тоже: поповер
+       * правит выделенный текст, и стоит у него при любом способе открыть
+       * (поповер ссылки).
+       */
+      anchor?: "selection";
+      /** Классы размера и отступов рамки вместо умолчания `w-auto p-2`. */
+      className?: string;
+    };
   };
-};
 
 /** Действие над Блоком: пункт меню Ручки Блока, в секции Инструмента перед «Удалить». */
 export interface BlockAction {
@@ -338,9 +361,9 @@ export interface TextCardRecord {
  * Развёрнутый набор Инструментов: список описаний и — как `Set` — имена
  * включённых Инструментов кита.
  *
- * Набор имён — тоже проекция списка: реестры, которые ещё фильтруют свои
- * записи по имени (`tools.has("table")`), читают его без правок. Свои
- * Инструменты есть только в списке описаний.
+ * Набор имён — тоже проекция списка: виджеты кита, которые спрашивают набор по
+ * имени (`tools.has("table")`), читают его без правок. Свои Инструменты есть
+ * только в списке описаний.
  */
 export interface ToolList extends ReadonlySet<Tool> {
   /**
@@ -350,8 +373,8 @@ export interface ToolList extends ReadonlySet<Tool> {
    */
   readonly error?: string;
   /**
-   * Описания включённых Инструментов: встроенные в порядке кита (у не
-   * переехавших — заглушки `legacy`), за ними свои в порядке `tools`.
+   * Описания включённых Инструментов: встроенные в порядке кита, за ними
+   * свои в порядке `tools`.
    */
   readonly descriptors: readonly ToolDescriptor[];
 }
@@ -380,11 +403,6 @@ export function toolOptions<Name extends ConfigurableToolName>(
   return descriptor?.options as RichTextTools[Name]["options"] | undefined;
 }
 
-/** Описания переехавших Инструментов набора — в порядке списка. */
-export function describedTools(tools: ToolList): readonly ToolDescriptor[] {
-  return tools.descriptors.filter((descriptor) => !descriptor.legacy);
-}
-
 /**
  * Действия над Блоком набора — проекция списка описаний, в порядке кита. Фильтра
  * по Блоку здесь нет: имя и предикат видимости спрашивает меню Ручки на
@@ -429,7 +447,6 @@ export function blockActionVisible(
  * - `order` — место встроенных Инструментов на поверхности, привилегия кита.
  *   Инструменты набора вне него идут следом, в порядке списка: так встаёт
  *   запись, у которой своего места на поверхности нет.
- * - `legacy` — старый реестр: записи Инструмента, ещё не переехавшего на описание.
  * - `own` — поле описания с записями этой поверхности.
  *
  * Фильтра по включённым Инструментам здесь нет: его держит сам список.
@@ -437,14 +454,10 @@ export function blockActionVisible(
 export function projectRecords<R>(
   tools: ToolList,
   order: readonly Tool[],
-  legacy: (name: Tool) => readonly R[] | undefined,
   own: (descriptor: ToolDescriptor) => readonly R[] | undefined
 ): R[] {
   const list = tools.descriptors;
   const placed = order.flatMap((name) => list.filter((descriptor) => descriptor.name === name));
   const rest = list.filter((descriptor) => !(order as readonly string[]).includes(descriptor.name));
-  return [...placed, ...rest].flatMap(
-    // Заглушка `legacy` бывает только у встроенного: имя — из `Tool`.
-    (descriptor) => (descriptor.legacy ? legacy(descriptor.name as Tool) : own(descriptor)) ?? []
-  );
+  return [...placed, ...rest].flatMap((descriptor) => own(descriptor) ?? []);
 }

package/src/editor/core/toolLoader.ts

@@ -3,17 +3,17 @@
 import { devError } from "../../lib/dev-warn.js";
 
 /*
-  Загрузчики Частей для движка (ADR-0058, п. 1.3 и 11.3–11.6).
+  Загрузчики Extensions (ADR-0058, п. 1.3 и 11.3–11.6).
 
   Промис кэшируется на самой функции загрузчика, а не на Редакторе: второй
   Редактор на странице с тем же Инструментом ничего не ждёт и загрузчик не
   зовёт. Упавший остаётся в кэше упавшим — иначе каждая перерисовка звала бы
   его снова; заново его зовёт только «Повторить» (`retry`). Механизм общий:
-  встроенный Инструмент с ленивой Частью для движка кладёт свой загрузчик в
+  встроенный Инструмент с ленивыми Extensions кладёт свой загрузчик в
   то же поле описания (`ToolDescriptor.load`).
 */
 
-/** Загрузчик Части для движка: функция с динамическим импортом. */
+/** Загрузчик Extensions: функция с динамическим импортом. */
 export type ToolLoader = () => Promise<unknown>;
 
 /** Ход загрузки: промис не отклоняется никогда, итог — в `done` или `failed`. */

package/src/editor/core/toolOptions.ts

@@ -59,10 +59,25 @@ export interface TocToolOptions {
   listWidth: number | string;
 }
 
+/**
+ * Опции Инструмента `details` (по расширению Details из Tiptap, ADR-0048).
+ */
+export interface DetailsToolOptions {
+  /**
+   * Пишется ли открытость Блока в Документ: открытый Блок сохраняется с
+   * `open` и открытым же отдаётся в `RichTextView`. По умолчанию `false`, как
+   * у Tiptap: раскрытый при правке Блок не публикуется раскрытым без спроса,
+   * открытость живёт только в показе (в Редакторе и в Просмотре читатель
+   * открывает Блок сам). Со `true` Блок, вставленный из Меню вставки, сразу
+   * открыт и пишет `open`, а `open` из `value` и вставки читается.
+   */
+  persist: boolean;
+}
+
 /**
  * Типы Инструментов Редактора по имени: что экран задаёт при настройке (`options`),
  * что читает (`state`) и что вызывает (`commands`). Расширяемый интерфейс, как
- * `Storage` и `Commands` у Tiptap: кит объявляет в нём `search` и `toc`, а
+ * `Storage` и `Commands` у Tiptap: кит объявляет в нём `search`, `toc` и `details`, а
  * потребитель дописывает свои Инструменты через declaration merging:
  *
  * ```ts
@@ -92,6 +107,10 @@ export interface RichTextTools {
     state: TocToolState;
     commands: TocToolCommands;
   };
+  // Только Опции: Состояния и Команд у сворачиваемого Блока нет.
+  details: {
+    options: DetailsToolOptions;
+  };
 }
 
 /**
@@ -182,7 +201,7 @@ export function mergeOptions(base: object, given: object): object {
  * опции (из JS без типов) заменяется умолчанием, в разработке — один
  * `console.error`; опции своего Инструмента проверяет его автор.
  *
- * Встроенный — только Инструмент с опциями: `search` и `toc`. Серверно-безопасна.
+ * Встроенный — только Инструмент с опциями: `search`, `toc` и `details`. Серверно-безопасна.
  */
 export function tool<Name extends ConfigurableToolName>(
   name: Name,

package/src/editor/core/tools.ts

@@ -15,7 +15,7 @@
  * новым именем для него не ломающее. Зато имя без реализации стало бы
  * молчаливой ловушкой: `tools={["x"]}` компилировался бы и ничего не давал.
  * Так пришли `link`, `color`, `highlight`, `align`, `table`, `image`, `emoji`,
- * `layout`, `wrapper` и `source`; зарезервированных имён сейчас нет.
+ * `layout`, `wrapper`, `details` и `source`; зарезервированных имён сейчас нет.
  *
  * `heading1` — заголовок первого уровня, надстройка над `heading`:
  * с ним уровни Блока — 1–4, без него — 2–4. Отдельным инструментом он стоит
@@ -44,6 +44,14 @@
  * Выключенный инструмент разворачивает Обёртку из вставки и `value` в Блоки
  * подряд. В `basic` её нет по той же причине, что и Раскладки.
  *
+ * `details` — сворачиваемый Блок: заголовок (`summary`) и содержимое из Блоков
+ * (`details.ts`), API по расширению Details из Tiptap (ADR-0048: заказчика при
+ * выпуске не было). Кнопки Панели у него нет — Меню вставки и меню ручки.
+ * Выключенный инструмент разворачивает Блок из вставки и `value`: заголовок
+ * становится абзацем, содержимое идёт Блоками следом. Есть в `full`, в `basic`
+ * нет — по той же причине, что у Раскладки и Обёртки. Открытость в Документ
+ * пишет Опция `tool("details", { persist: true })`.
+ *
  * `source` — HTML-режим: кнопка «HTML» фиксированной Панели меняет
  * Документ на поле с его исходным HTML, а выход применяет правку через Схему,
  * как входящий `value`. Своей Схемы у него нет, как у `clearFormatting`:
@@ -88,6 +96,7 @@ export const TOOLS = [
   "image",
   "layout",
   "wrapper",
+  "details",
   "emoji",
   "source",
   "search",

package/src/editor/core/viewIsland.ts

@@ -7,7 +7,7 @@ import { customToolOf } from "./toolDefinition.js";
 
   Модуль серверный: `RichTextView` выбирает из `tools` лишь то, что нужно
   острову, и отдаёт клиентскому компоненту ссылки на Острова — описание целиком
-  (Часть для движка, функции) через границу RSC не пройдёт. Выбор идёт по
+  (Extensions, функции) через границу RSC не пройдёт. Выбор идёт по
   Документу, как `hasCodeBlocks` у «Копировать»: Остров Блока, которого в
   Документе нет, в клиентский граф не попадает, а значит, и его код не грузится.
 */

package/src/editor/features/builtins.ts

@@ -2,13 +2,30 @@
 
 import Blockquote from "@tiptap/extension-blockquote";
 import HorizontalRule from "@tiptap/extension-horizontal-rule";
-import { DividerIcon, QuoteIcon, UnwrapIcon } from "../../icons.js";
+import { DividerIcon, QuoteIcon } from "../../icons.js";
 import { turnIntoTypes } from "../core/blockTypes.js";
 import type { InsertItem } from "../core/insertItems.js";
-import type { ShortcutCommand } from "../core/shortcuts.js";
+import { INSERT_MENU_TOOL } from "../core/insertMenuTool.js";
+import { SHORTCUT_KEYS, type ShortcutCommand } from "../core/shortcuts.js";
+import { ALIGN_TOOL, COLOR_TOOL, HIGHLIGHT_TOOL } from "./color/colorTools.js";
 import { CODE_BLOCK_TOOL } from "./code/codeBlockTool.js";
+import { DETAILS_TOOL } from "./details/detailsTool.js";
 import { EMOJI_TOOL } from "./emoji/emojiTool.js";
+import { HEADING1_TOOL, HEADING_TOOL } from "./heading/headingTool.js";
+import { HISTORY_TOOL } from "./history/historyTool.js";
+import { IMAGE_TOOL } from "./image/imageTool.js";
+import { LAYOUT_TOOL } from "./layout/layoutTool.js";
 import { LINK_TOOL } from "./link/linkTool.js";
+import { BULLET_LIST_TOOL, ORDERED_LIST_TOOL, TASK_LIST_TOOL } from "./lists/listTools.js";
+import {
+  BOLD_TOOL,
+  CODE_TOOL,
+  ITALIC_TOOL,
+  STRIKE_TOOL,
+  SUBSCRIPT_TOOL,
+  SUPERSCRIPT_TOOL,
+  UNDERLINE_TOOL,
+} from "./marks/markTools.js";
 import { devError } from "../../lib/dev-warn.js";
 import type { ToolEntry } from "../core/customTool.js";
 import { describeCustomTool, describeDefinition } from "../core/customToolEngine.js";
@@ -18,14 +35,14 @@ import { SEARCH_TOOL } from "./search/searchTool.js";
 import { TABLE_TOOL } from "./table/tableTool.js";
 import { TOC_TOOL } from "./toc/tocTool.js";
 import { resolveTools, TOOLS, type RichTextEditorPreset, type Tool } from "../core/tools.js";
-import { unwrapWrapperAt, WRAPPER_NODE } from "./wrapper/wrapper.js";
+import { WRAPPER_TOOL } from "./wrapper/wrapperTool.js";
 
 /** Сочетание цитаты: одна запись на справочник, Меню вставки и «¶». */
 const BLOCKQUOTE_SHORTCUT: ShortcutCommand = {
   id: "blockquote",
   group: "blockType",
   tool: "blockquote",
-  keys: ["mod", "shift", "B"],
+  keys: SHORTCUT_KEYS.blockquote,
   label: (m) => m.blockquote,
 };
 
@@ -43,47 +60,27 @@ const BLOCKQUOTE_ITEMS: readonly InsertItem[] = [
 ];
 
 /**
- * Описания встроенных Инструментов, переехавших со старых реестров
- * (ADR-0058, п. 10; тип — `toolDescriptor.ts`).
+ * Описания встроенных Инструментов (ADR-0058, п. 10; тип — `toolDescriptor.ts`).
  *
- * Сюда Инструмент переезжает целиком: его записи удаляются из старых
- * реестров, и с этой минуты он берётся только из описания. Кого здесь нет, тот
- * стоит в развёрнутом списке заглушкой `legacy` и по-прежнему живёт в старых
- * реестрах. `image`, `layout` и виджеты Панели переезжают постепенно, и выпуск
- * их не ждёт.
+ * Запись полная, по каждому имени `TOOLS`: встроенный Инструмент
+ * берётся только из описания, старых реестров по имени нет, и компилятор не
+ * пропустит новое имя без описания. Виджеты Панели и Меню выделения остаются
+ * компонентами кита и спрашивают набор по имени.
  */
-export const BUILTIN_TOOLS: Partial<Record<Tool, ToolDescriptor>> = {
+export const BUILTIN_TOOLS: Record<Tool, ToolDescriptor> = {
   search: SEARCH_TOOL,
   // Оглавление несёт только Опции: полоса и список рисуются в `RichTextEditor`.
   toc: TOC_TOOL,
+  layout: LAYOUT_TOOL,
+  color: COLOR_TOOL,
+  highlight: HIGHLIGHT_TOOL,
+  align: ALIGN_TOOL,
+  wrapper: WRAPPER_TOOL,
+  details: DETAILS_TOOL,
   /*
-    Обёртка переехала только Действием над Блоком, поэтому
-    `legacy`: её узел, вставка и сочетания остаются в старых реестрах. «Тон ›» —
-    меню-виджет, своего Инструмента у него нет, и он собирается в Ручке по-старому.
-  */
-  wrapper: {
-    name: "wrapper",
-    legacy: true,
-    blockActions: [
-      {
-        id: "unwrap",
-        label: (messages) => messages.unwrap,
-        icon: UnwrapIcon,
-        blocks: [WRAPPER_NODE],
-        // Одна правка: Блоки встают на место Обёртки, отмена — одна.
-        run: (editor, pos) =>
-          void editor
-            .chain()
-            .focus()
-            .command(({ tr }) => unwrapWrapperAt(tr, pos))
-            .run(),
-      },
-    ],
-  },
-  /*
-    Проверочный набор: Инструмент с пунктом вставки и Инструмент
-    с «Превратить в». Поля `insertItems` и `engine` совпадают с будущим
-    публичным описанием, чтобы его форма проверялась кодом кита.
+    Разделитель и цитата: Инструмент с пунктом вставки и Инструмент с
+    «Превратить в». Поля `insertItems` и `engine` те же, что у публичного
+    описания своего Инструмента: форму проверяет код кита.
   */
   horizontalRule: {
     name: "horizontalRule",
@@ -109,11 +106,49 @@ export const BUILTIN_TOOLS: Partial<Record<Tool, ToolDescriptor>> = {
     // Клавишу вешает расширение Tiptap; строка справочника — подпись к ней.
     shortcuts: [BLOCKQUOTE_SHORTCUT],
   },
+  history: HISTORY_TOOL,
+  bold: BOLD_TOOL,
+  italic: ITALIC_TOOL,
+  underline: UNDERLINE_TOOL,
+  strike: STRIKE_TOOL,
+  code: CODE_TOOL,
+  superscript: SUPERSCRIPT_TOOL,
+  subscript: SUBSCRIPT_TOOL,
+  heading: HEADING_TOOL,
+  heading1: HEADING1_TOOL,
   link: LINK_TOOL,
+  bulletList: BULLET_LIST_TOOL,
+  orderedList: ORDERED_LIST_TOOL,
+  taskList: TASK_LIST_TOOL,
+  image: IMAGE_TOOL,
   emoji: EMOJI_TOOL,
+  insertMenu: INSERT_MENU_TOOL,
+  /*
+    Своего расширения у «Очистить форматирование» нет: клавишу `⌘\` держит
+    `BlockCommands` ядра (он спрашивает `has("clearFormatting")`), а кнопка в
+    «…» — виджет кита. В описании — только строка справочника.
+  */
+  clearFormatting: {
+    name: "clearFormatting",
+    shortcuts: [
+      {
+        id: "clearFormatting",
+        group: "clear",
+        tool: "clearFormatting",
+        keys: SHORTCUT_KEYS.clearFormatting,
+        label: (m) => m.clearFormatting,
+      },
+    ],
+  },
+  /*
+    HTML-режим — виджет «HTML» Панели и режим `RichTextEditor`, показ по
+    `has("source")`. Ни Схемы, ни записей у Инструмента нет, но описание
+    есть у каждого встроенного — даже пустое.
+  */
+  source: { name: "source" },
   /*
     Ленивые встроенные (ADR-0058, п. 11.1): их нет в `basic`, а
-    Часть для движка тяжелее 10 кБ gzip, поэтому она грузится загрузчиком
+    Extensions тяжелее 10 кБ gzip, поэтому они грузятся загрузчиком
     (`load`) — тем же, что у своего Инструмента.
   */
   codeBlock: CODE_BLOCK_TOOL,
@@ -184,7 +219,7 @@ export function expandTools(
   );
   const builtin = TOOLS.filter((name) => names.has(name)).map((name) =>
     resolveOptions(
-      BUILTIN_TOOLS[name] ?? { name, legacy: true },
+      BUILTIN_TOOLS[name],
       configured.find((entry) => entry.name === name)
     )
   );

package/src/editor/features/code/codeBlockTool.ts

@@ -5,7 +5,7 @@ import { CodeBlockIcon } from "../../../icons.js";
 // Только тип: статический импорт модуля втянул бы чанк в «старт».
 import type * as CodeBlockChunk from "./codeBlock.js";
 import { normalizeCodeLanguage, type CodeLanguageId } from "./codeLanguages.js";
-import { shortcutKeys } from "../../core/shortcuts.js";
+import { SHORTCUT_KEYS, shortcutKeys } from "../../core/shortcuts.js";
 import type { ToolDescriptor } from "../../core/toolDescriptor.js";
 import { loaded } from "../../core/toolLoader.js";
 
@@ -57,22 +57,30 @@ const CodeBlockShape = Node.create({
 
 /**
  * Блок кода на описании Инструмента (ADR-0058, п. 11.1): его нет в
- * `basic`, а Часть для движка тяжелее 10 кБ, поэтому она грузится тем же
+ * `basic`, а Extensions тяжелее 10 кБ, поэтому они грузятся тем же
  * загрузчиком, что у своего Инструмента. До загрузки Редактор с блоком кода —
  * Скелет (`RichTextEditor.tsx`).
  *
- * Переехали Часть для движка и пункты Меню вставки. Сочетание `Mod+Alt+C`
- * вешает расширение, и его строка справочника осталась в `SHORTCUTS`: на неё
- * ссылаются пункты меню (`shortcutKeys`), «Формат ›» и место строки цитаты
- * (`MOVED_BEFORE`). Кнопка «Блок кода» меню «…» и «¶» — виджеты Панели, они
- * переезжают позже (ADR-0058, «Последствия»).
+ * Сочетание `Mod+Alt+C` вешает расширение, поэтому строка справочника — только
+ * подпись (`shortcuts`); клавиши пунктов меню и «Формат ›» берутся из
+ * `SHORTCUT_KEYS`, место строки — из `SHORTCUT_ORDER`. Кнопка «Блок кода» меню
+ * «…» и «¶» — виджеты Панели и остаются у кита.
  */
 export const CODE_BLOCK_TOOL: ToolDescriptor = {
   name: "codeBlock",
   load: loadCodeBlock,
+  shortcuts: [
+    {
+      id: "codeBlock",
+      group: "blockType",
+      tool: "codeBlock",
+      keys: SHORTCUT_KEYS.codeBlock,
+      label: (m) => m.codeBlock,
+    },
+  ],
   /*
     `Alt+F10` блока кода (в кнопку языка) обязан сработать раньше общего
-    `ToolbarFocus`: Части для движка описаний регистрируются после него
+    `ToolbarFocus`: Extensions описаний регистрируются после него
     (`extensions.ts`), а из равных по приоритету Tiptap первым опрашивает
     зарегистрированное последним.
   */

package/src/editor/features/color/colorTools.ts

@@ -0,0 +1,68 @@
+"use client";
+
+import { SHORTCUT_KEYS } from "../../core/shortcuts.js";
+import type { ToolDescriptor } from "../../core/toolDescriptor.js";
+import {
+  HighlightExtension,
+  TEXT_COLOR_EXTENSIONS,
+  TextAlignExtension,
+} from "./styleExtensions.js";
+
+/*
+  Цвет, маркер и выравнивание пишут `data-color` и `data-align`, а не `style`
+  (`styleExtensions.ts`; единственное исключение — цвет автора, `customColor.ts`):
+  выключенный Инструмент не отдаёт ни атрибута, ни правила разбора, и такой
+  атрибут из вставки отбрасывается.
+
+  Виджеты — «Маркер» на Панели, «Цвет» и «Маркер» в Меню выделения
+  (`ColorMenus.tsx`, `SelectionBubble.tsx`) и ленивый поповер своего цвета —
+  остаются у кита, показ по `has(name)`. Сочетаний и пунктов вставки у цвета
+  и маркера нет, поэтому их описания — только Extensions.
+*/
+
+/** Цвет текста: Метка `textStyle` с `data-color` и цвет автора. */
+export const COLOR_TOOL: ToolDescriptor = {
+  name: "color",
+  engine: () => TEXT_COLOR_EXTENSIONS,
+};
+
+/** Маркер: Метка `highlight` с `data-color` (несколько цветов). */
+export const HIGHLIGHT_TOOL: ToolDescriptor = {
+  name: "highlight",
+  engine: () => [HighlightExtension],
+};
+
+/**
+ * Выравнивание: `data-align` на абзаце и заголовке.
+ *
+ * Клавиши `Mod-Shift-L/E/R` вешает само расширение, а три строки справочника —
+ * подпись к ним. Меню «Выравнивание ▾» (`AlignMenu`, `FormatMenus.tsx`) — виджет
+ * кита, он читает те же сочетания из `SHORTCUT_KEYS`.
+ */
+export const ALIGN_TOOL: ToolDescriptor = {
+  name: "align",
+  engine: () => [TextAlignExtension],
+  shortcuts: [
+    {
+      id: "alignLeft",
+      group: "align",
+      tool: "align",
+      keys: SHORTCUT_KEYS.alignLeft,
+      label: (m) => m.alignLeft,
+    },
+    {
+      id: "alignCenter",
+      group: "align",
+      tool: "align",
+      keys: SHORTCUT_KEYS.alignCenter,
+      label: (m) => m.alignCenter,
+    },
+    {
+      id: "alignRight",
+      group: "align",
+      tool: "align",
+      keys: SHORTCUT_KEYS.alignRight,
+      label: (m) => m.alignRight,
+    },
+  ],
+};