@brandup/ui-richeditor 1.0.36 → 1.0.39

package/README.md

@@ -8,7 +8,7 @@
 
 ## Установка
 
-```
+```bash
 npm i @brandup/ui-richeditor
 ```
 
@@ -40,13 +40,15 @@ editor.onChange(({ value }) => console.log(value));
 ## Опции (`RichEditorOptions`)
 
 | Опция | Тип | Описание |
-|---|---|---|
+| --- | --- | --- |
 | `format` | `boolean` | Включает форматирование и панель инструментов |
 | `tools` | `FormatTool[]` | Состав инструментов (по умолчанию все) |
+| `actions` | `EditorAction[]` | Кнопки действий в панели: `emoji`, `erase`, `undo`, `redo` (по умолчанию нет) |
 | `storage` | `"html" \| "markdown"` | Формат сериализации значения (по умолчанию `html`) |
 | `markers` | `Partial<FormatMarkers>` | Переопределение markdown-маркеров по инструментам |
 | `placeholder` | `string \| null` | Текст-заглушка |
 | `multiline` | `boolean` | Многострочный режим |
+| `paragraph` | `"block" \| "break"` | Что делает Enter: новый абзац (по умолчанию) или мягкий перенос |
 | `readonly` | `boolean` | Только для чтения — запрещает ввод и изменение текста (выделение и копирование остаются) |
 | `toolbarContainer` | `HTMLElement \| null` | Контейнер для панели; по умолчанию `document.body` (`position: fixed`). Если задан — панель монтируется в него и позиционируется над ним (`position: absolute`). Контейнер должен быть `position: relative` |
 | `value` | `string` | Начальное значение |
@@ -60,24 +62,79 @@ editor.onChange(({ value }) => console.log(value));
 ## API
 
 | Член | Описание |
-|---|---|
+| --- | --- |
 | `editable` | Редактируемый элемент |
-| `format`, `formatTools`, `formatStorage`, `formatMarkers`, `multiline` | Параметры экземпляра |
-| `getValue(): string` | Сериализованное значение (по `storage`) |
+| `format`, `formatTools`, `editorActions`, `formatStorage`, `formatMarkers`, `multiline` | Параметры экземпляра |
+| `getValue(): string` | Сериализованное значение (по `storage`) — считается по DOM, всегда актуально |
 | `setValue(value: string): void` | Установить значение (нормализует, генерирует `change`) |
+| `flushChange(): void` | Доставить отложенное `change` немедленно (см. ниже) |
 | `getLength(): number` | Длина текста (без учёта переводов строк) |
 | `focus(): void` | Установить фокус |
+| `applyFormat(tool): void` | Переключить формат на выделении (слово целиком) |
+| `isToolActive(tool): boolean` | Активен ли формат на текущем выделении |
+| `activeTools(): ReadonlySet<FormatTool>` | Активные форматы всех инструментов сразу (панель обновляется на каждое движение каретки, поштучный опрос обходил бы содержимое на каждую кнопку) |
+| `clearFormat(): void` | Снять всё форматирование с выделения (без выделения — со слова под кареткой) |
+| `clearAllFormat(): void` | Снять всё форматирование со всего содержимого |
+| `undo(): void`, `redo(): void` | Отмена и повтор |
+| `canUndo`, `canRedo` | Доступность отмены/повтора |
+| `applyAction(action): void` | Выполнить действие панели (`erase`/`undo`/`redo`) |
+| `isActionEnabled(action): boolean` | Доступно ли действие сейчас |
+| `insertText(text): void` | Вставить текст в каретку (или вместо выделения) с учётом режима набора |
+| `selection: Selection \| null` | Выделение, если оно внутри редактора (иначе `null`) — единая точка доступа для хоста |
+| `selectNode(node): void` | Выделить узел внутри редактора: следующая вставка заменит его целиком |
 | `onChange(handler)` | Подписка на событие `richeditor-change` |
 | `destroy(): void` | Разворачивает элемент обратно и освобождает ресурсы |
 
+## Событие изменения
+
+`getValue()` считает значение по DOM и точен всегда. А вот **уведомление** `richeditor-change` при печати доставляется с задержкой: сериализация — самая дорогая операция редактора (обход всего содержимого), а печать даёт `input` на каждый символ.
+
+Это троттлинг, а не debounce: при непрерывном наборе событие приходит каждые ~150 мс, а не откладывается до паузы. Откладывается только печать — вставка, форматирование, отмена/повтор, `setValue` и Enter сообщаются сразу.
+
+Отложенное доставляется немедленно:
+
+- при потере фокуса и при `destroy()` — редактором самостоятельно;
+- по вызову `flushChange()` — его должен звать хост перед тем, как значение прочитают снаружи.
+
+Хосты пакета (`@brandup/ui-textbox`, `@brandup/ui-messageeditor`) держат в поле формы копию значения и сбрасывают отложенное перед каждым чтением значения снаружи: отправка формы, `validate()`, `getValue()`. На `submit` синхронизация идёт в фазе перехвата на документе — то есть раньше любого обработчика самой формы и независимо от того, включена ли её валидация (`novalidate`). Так что в отправляемых данных значение всегда актуально; свой хост обязан делать то же самое (в `@brandup/ui-input` для этого есть `__syncValue()`).
+
+Не покрыт единственный случай: `new FormData(form)` **вне** отправки формы, в пределах окна троттлинга после ввода. Список полей там собирается до того, как о нём можно узнать, а точечно заменить свою запись `FormData` не позволяет. Читайте в таком коде `getValue()` хоста — он синхронизирует сам.
+
 ## Поведение форматирования
 
 - Формат — переключатель (toggle): повторное применение снимает его.
 - Применяется к слову целиком: курсор внутри слова или выделение его части → формат охватывает всё слово; исходное выделение/каретка сохраняются.
 - **Режим набора**: на пустом месте (между пробелами / в пустом поле) кнопка/хоткей включают «ожидающий» формат — он применится к следующему введённому тексту. Сбрасывается при перемещении каретки, клике или потере фокуса.
 - Хоткеи `Ctrl/Cmd+B/I/U`. Зачёркивание — только кнопкой.
-- **Отмена/повтор**: `Ctrl/Cmd+Z` — отмена, `Ctrl+Y` или `Ctrl/Cmd+Shift+Z` — повтор. История форматирования, абзацев, переносов и печати ведётся редактором (нативный undo не видит ручных DOM-правок), поэтому **доступна только при включённом форматировании** (`format: true`). Печать коалесится в один шаг отмены по паузе ~300 мс; глубина истории — 100 шагов.
-- При потере фокуса и после `setValue` пробелы нормализуются (схлопывание повторов + обрезка краёв строк).
+- **Отмена/повтор**: `Ctrl/Cmd+Z` — отмена, `Ctrl+Y` или `Ctrl/Cmd+Shift+Z` — повтор. История форматирования, абзацев, переносов и печати ведётся редактором (нативный undo не видит ручных DOM-правок), поэтому **доступна только при включённом форматировании** (`format: true`). Печать коалесится в один шаг отмены по паузе ~300 мс; глубина истории — 100 шагов, но не более ~512 КБ снимков суммарно (снимок — это всё содержимое редактора, поэтому на длинном тексте старые шаги вытесняются раньше).
+- При потере фокуса и после `setValue` пробелы нормализуются (схлопывание повторов + обрезка краёв строк). Неразрывный пробел (`U+00A0`) считается обычным: браузер сам подставляет его в `contenteditable` вместо пробела, который иначе схлопнулся бы при отображении, и в значение он не попадает.
+
+## Очистка форматирования и действия панели
+
+`clearFormat()` снимает **все** форматы сразу — с выделения, а без выделения со слова под кареткой (та же логика, что и у применения формата). Режим набора при этом сбрасывается. Распознаются и теги-синонимы (`STRONG`/`EM`/`DEL`/`INS`), которые могли прийти из вставки или `setValue`. `clearAllFormat()` чистит всё содержимое и выделения не требует.
+
+Обе операции попадают в историю (откатываются одним `Ctrl+Z`) и не создают пустой шаг отмены, если очищать нечего.
+
+Кроме кнопок форматирования панель может показывать кнопки действий — они подключаются **явно** через `actions`:
+
+```typescript
+new RichEditor(elem, { format: true, actions: ["emoji", "erase", "undo", "redo"] });
+```
+
+| Действие | Кнопка | Что делает | Когда недоступна |
+| --- | --- | --- | --- |
+| `emoji` | Вставить смайлик | открывает панель вставки | в режиме `readonly` |
+| `erase` | Очистить форматирование | `clearFormat()` | нет форматирования на выделении |
+| `undo` | Отменить | `undo()` | история пуста |
+| `redo` | Повторить | `redo()` | нечего повторять |
+
+Кнопки действий (`.action-button`) отделены от кнопок форматирования (`.format-button`) разделителем `.split` и получают атрибут `disabled`, когда действие недоступно. Панель показывается и в том случае, если инструментов форматирования нет, а действия заданы.
+
+### Панель смайликов
+
+Кнопка `emoji` открывает под панелью попап `.ui-richeditor-emoji` со списком символов (`EMOJIS` — экспортируется пакетом). Выбранный символ вставляется через `insertText()`, то есть в текущую каретку и с учётом ожидающих форматов режима набора; попап после выбора закрывается.
+
+Открытием и закрытием управляет `PopupManager` из [`@brandup/ui-kit`](../brandup-ui-kit) — оттуда же приходят базовые стили `.ui-popup`. Ни кнопка, ни попап не забирают фокус у редактора (`mousedown` гасится), поэтому каретка и выделение сохраняются. Список кнопок собирается лениво, при первом открытии.
 
 ## Многострочный режим: абзацы и переносы
 
@@ -87,32 +144,47 @@ editor.onChange(({ value }) => console.log(value));
 - **Shift+Enter** или **Ctrl/Cmd+Enter** → мягкий перенос (`<br>`) внутри абзаца;
 - блуждающий текст и `<div>` нормализуются в `<p>` при вводе.
 
+Опция `paragraph: "break"` меняет это местами — Enter даёт мягкий перенос, а абзац набирается модификатором либо просто двумя переносами. Так устроены мессенджеры, и это важно при `storage: "markdown"`: в режиме по умолчанию каждый Enter уходит в значение пустой строкой (`\n\n`), а в `break` — одним переносом (`\n`).
+
+В этом режиме абзацных блоков в содержимом нет вовсе: значение загружается плоским текстом, где каждый `\n` становится `<br>` внутри единственного `<p>`. Иначе два переноса рисовались бы двумя абзацами, а у хоста без отступов между ними это неотличимо от одного переноса — значение расходилось бы с видимым текстом.
+
 Хвостовой перенос абзаца отбрасывается (это `<br>`-заполнитель); пустая строка делается отдельным абзацем.
 
 При нормализации (потеря фокуса, `setValue`, инициализация) пустые абзацы удаляются.
 
-## Вставка форматированного текста
+## Вставка текста
 
 При включённом форматировании вставка (`paste`) сохраняет форматирование из буфера обмена (`text/html`):
 
 - разметка санитизируется до включённых инструментов (синонимы `STRONG/EM/DEL/INS` → канонические `b/i/s/u`, всё прочее — `span`, стили, классы, `<style>`/`<script>` — отбрасывается, текст сохраняется);
 - **multiline** сохраняет абзацы `<p>` и мягкие переносы `<br>`, разбивая текущий абзац по каретке; **single-line** — инлайн, абзацы/переносы становятся пробелами;
-- если `text/html` нет — простая текстовая вставка (как раньше);
 - хук `filterPaste` остаётся в силе: вернул `null` — вставка отклоняется; изменил текст (обрезка по длине, фильтр по типу) — форматирование не сохраняется, вставляется очищенный текст.
 
-Вся вставка — один шаг истории (Ctrl+Z откатывает целиком).
+Если `text/html` нет (или форматирование выключено), вставляется простой текст — по той же модели абзацев:
+
+- **multiline**, режим `block` — пустая строка разделяет абзацы `<p>`, одиночный перенос остаётся мягким `<br>`;
+- **multiline**, режим `break` — абзацы не создаются, все переносы мягкие;
+- **single-line** — строки склеиваются пробелами.
+
+Каретка в обоих случаях встаёт сразу за вставленным текстом, а вся вставка — один шаг истории (Ctrl+Z откатывает целиком).
 
 ## Формат хранения
 
 | `storage` | Хранение | Абзац / мягкий перенос | Маркеры форматирования |
-|---|---|---|---|
+| --- | --- | --- | --- |
 | `html` | Санитизированный HTML | `<p>…</p>` / `<br>` | `<b>`, `<i>`, `<s>`, `<u>` |
-| `markdown` | Лёгкая разметка | `\n\n` / `\n` | `**жирный**`, `*курсив*`, `~~зачёркнутый~~`, `++подчёркнутый++` |
+| `markdown` | Лёгкая разметка | `\n\n` / `\n` | `**жирный**`, `_курсив_`, `~зачёркнутый~`, `__подчёркнутый__` |
 
 Без форматирования (plain) значение хранится как markdown без инструментов: абзацы `\n\n`, мягкий перенос `\n`.
 
 Маркеры markdown настраиваются через `markers`. При разборе применяются по убыванию длины, поэтому длинный маркер срабатывает раньше короткого-префикса. Глубоко вложенные комбинации гарантированно сохраняются только в режиме `html`.
 
+Вложенные пары разбираются (`_а **б** в_`), а вот **пересекающиеся** остаются текстом: в `**а _б** в_` внутренняя пара пересекает внешнюю, разметкой такое невыразимо, и короткий маркер отбрасывается — как и в мессенджерах.
+
+Разметка распознаётся по правилам мессенджеров: маркер стоит на **границе слова**, содержимое не начинается и не заканчивается пробелом и не пересекает перенос строки. Поэтому `5**4 = 20`, `2 ** 2 ** 2` и `файл_имя_файла.txt` остаются обычным текстом — иначе редактор показывал бы форматирование там, где получатель увидит исходные символы. Форматирование применяется к словам целиком, так что собственный вывод редактора всегда разбирается обратно.
+
+Краевые пробелы при сериализации выносятся за маркеры (`<b> слово </b>дальше` → `**слово** дальше`), иначе разметка не сработала бы ни у нас, ни у мессенджера. А вот формат, приклеенный к соседнему слову — такое приходит только со вставкой внешнего HTML (`супер<b>бонус</b>`), — маркерами невыразим: значение сохранится как `супер**бонус**` и разметкой уже не станет. Это осознанное решение: текст остаётся ровно тем, что набрал пользователь, а не молча теряет форматирование.
+
 ## CSS
 
 Подключается `richeditor.less`. Цветовые переменные `--input-*` берутся из `@brandup/ui-kit` (с fallback-значениями для standalone). Классы: `focused` на обёртке (поле в фокусе), `visible` на общей панели (показана), `active` на кнопке инструмента (формат активен на выделении).

package/package.json

@@ -27,11 +27,12 @@
     "email": "it@brandup.online"
   },
   "license": "Apache-2.0",
-  "version": "1.0.36",
+  "version": "1.0.39",
   "main": "source/index.ts",
   "types": "source/index.ts",
   "dependencies": {
-    "@brandup/ui": "^2.0.5"
+    "@brandup/ui": "^2.0.7",
+    "@brandup/ui-kit": "^1.0.39"
   },
   "files": [
     "source",

package/source/editing.ts

@@ -1,13 +1,11 @@
 // Низкоуровневые операции редактирования на чистом Selection/Range: абзацы, мягкие переносы,
-// каретка, расширение/обрезка выделения. Без состояния редактора и без истории —
-// вызывающий сам решает, когда записывать undo-шаг.
-
-function isBlock(node: Node): boolean {
-	return (
-		node.nodeType === Node.ELEMENT_NODE &&
-		((node as Element).tagName === "P" || (node as Element).tagName === "DIV")
-	);
-}
+// каретка, расширение/обрезка выделения, разбор вставляемого содержимого. Без состояния
+// редактора и без истории — вызывающий сам решает, когда записывать undo-шаг.
+
+import { deserialize } from "./serialize";
+import { isBlock } from "./paragraphs";
+import { documentSelection, innerSelection } from "./selection";
+import type { FormatMarkers, FormatTool } from "./format-config";
 
 function emptyParagraph(): HTMLParagraphElement {
 	const p = document.createElement("p");
@@ -25,7 +23,7 @@ function caretToStart(node: Node) {
 	const range = document.createRange();
 	range.setStart(node, 0);
 	range.collapse(true);
-	const selection = window.getSelection();
+	const selection = documentSelection(node);
 	if (selection) {
 		selection.removeAllRanges();
 		selection.addRange(range);
@@ -40,7 +38,7 @@ export function caretToEnd(editable: HTMLElement, multiline: boolean) {
 	const last = multiline ? editable.lastElementChild : null;
 	range.selectNodeContents(last && isBlock(last) ? last : editable);
 	range.collapse(false);
-	const sel = window.getSelection();
+	const sel = documentSelection(editable);
 	if (sel) {
 		sel.removeAllRanges();
 		sel.addRange(range);
@@ -50,13 +48,13 @@ export function caretToEnd(editable: HTMLElement, multiline: boolean) {
 /** Фокус и выделение всего содержимого (например, readonly-режим). */
 export function selectAllContent(editable: HTMLElement) {
 	editable.focus();
-	window.getSelection()?.selectAllChildren(editable);
+	documentSelection(editable)?.selectAllChildren(editable);
 }
 
 /** Enter в multiline: разбить текущий абзац по каретке на два <p>. */
 export function insertParagraph(editable: HTMLElement) {
-	const selection = window.getSelection();
-	if (!selection || selection.rangeCount === 0 || !editable.contains(selection.anchorNode)) return;
+	const selection = innerSelection(editable);
+	if (!selection) return;
 
 	const range = selection.getRangeAt(0);
 	range.deleteContents();
@@ -101,8 +99,8 @@ export function insertParagraph(editable: HTMLElement) {
 
 /** Shift/Ctrl+Enter в multiline: вставить мягкий перенос <br>. */
 export function insertSoftBreak(editable: HTMLElement) {
-	const selection = window.getSelection();
-	if (!selection || selection.rangeCount === 0 || !editable.contains(selection.anchorNode)) return;
+	const selection = innerSelection(editable);
+	if (!selection) return;
 
 	const range = selection.getRangeAt(0);
 	range.deleteContents();
@@ -168,21 +166,88 @@ export function insertPastedParagraphs(editable: HTMLElement, paras: HTMLElement
 }
 
 /** Обрезает пробелы по краям абзаца (после схлопывания) — у крайних текстовых узлов. */
-export function trimParagraphEdges(p: HTMLElement) {
+function trimParagraphEdges(p: HTMLElement) {
 	const walker = document.createTreeWalker(p, NodeFilter.SHOW_TEXT);
 	const texts: Text[] = [];
 	for (let t = walker.nextNode() as Text | null; t; t = walker.nextNode() as Text | null) texts.push(t);
 	if (!texts.length) return;
 
-	texts[0].textContent = (texts[0].textContent ?? "").replace(/^ /, "");
+	// неразрывный пробел режем наравне с обычным — из буфера обмена он приходит регулярно
+	texts[0].textContent = (texts[0].textContent ?? "").replace(/^[ \u00A0]/, "");
 	const last = texts[texts.length - 1];
-	last.textContent = (last.textContent ?? "").replace(/ $/, "");
+	last.textContent = (last.textContent ?? "").replace(/[ \u00A0]$/, "");
 }
 
-/** Расширяет выделение до целых слов на границах (для применения формата к слову целиком). */
-export function expandSelectionToWords(editable: HTMLElement, selection: Selection) {
-	const range = selection.getRangeAt(0);
+/**
+ * Строки вставляемого текста → абзацы `<p>` с мягкими переносами `<br>` внутри.
+ *
+ * При `blocks` абзацы разделяет пустая строка (режим `block` многострочного редактора);
+ * иначе весь текст — один абзац, а все переносы мягкие: так вставка ложится в ту же модель,
+ * которую даёт Enter, и значение после неё разбирается обратно.
+ */
+export function buildParagraphs(lines: string[], blocks: boolean): HTMLElement[] {
+	const groups: string[][] = [];
+
+	if (blocks) {
+		let group: string[] = [];
+		for (const line of lines) {
+			if (line !== "") group.push(line);
+			else if (group.length) {
+				groups.push(group);
+				group = [];
+			}
+		}
+		if (group.length) groups.push(group);
+	} else if (lines.length) groups.push(lines);
+
+	return groups.map((group) => {
+		const p = document.createElement("p");
+		group.forEach((line, index) => {
+			if (index > 0) p.appendChild(document.createElement("br"));
+			p.appendChild(document.createTextNode(line));
+		});
+
+		return p;
+	});
+}
 
+/**
+ * Разбирает HTML из буфера обмена в абзацы `<p>`, оставляя только разрешённые инструменты.
+ * Пустой результат — вставлять нечего (вызывающий откатится на простой текст).
+ */
+export function sanitizePastedHtml(html: string, tools: FormatTool[], markers: FormatMarkers): HTMLElement[] {
+	// убираем мусорные элементы (Word/браузер: стили, скрипты, заголовок документа)
+	const source = document.createElement("template");
+	source.innerHTML = html;
+	source.content.querySelectorAll("script, style, head, meta, link, title, noscript").forEach((el) => el.remove());
+
+	// единый источник санитизации — deserialize (теги-синонимы → канонические, лишнее развёрнуто)
+	const holder = document.createElement("template");
+	holder.innerHTML = deserialize(source.innerHTML, "html", tools, markers, true);
+
+	// внешний HTML: пробелы/переводы строк между тегами не значимы — схлопываем,
+	// иначе литеральные \n (pre-wrap) и отступы дают лишние переносы
+	const walker = document.createTreeWalker(holder.content, NodeFilter.SHOW_TEXT);
+	for (let t = walker.nextNode(); t; t = walker.nextNode())
+		t.textContent = (t.textContent ?? "").replace(/\s+/g, " ");
+
+	const paras = Array.from(holder.content.children) as HTMLElement[];
+	for (const p of paras) trimParagraphEdges(p);
+
+	// отбрасываем пустые краевые абзацы (ведущие/хвостовые \n и <br>-обёртки из буфера),
+	// иначе перед и после вставленного текста появляются пустые строки
+	while (paras.length && (paras[0].textContent ?? "").trim() === "") paras.shift();
+	while (paras.length && (paras[paras.length - 1].textContent ?? "").trim() === "") paras.pop();
+
+	return paras;
+}
+
+/**
+ * Диапазон, расширенный до целых слов на границах (для применения формата к слову целиком).
+ * Возвращает новый Range и не трогает выделение — вызывающий сам решает, править ли по нему
+ * и когда двигать каретку.
+ */
+export function expandRangeToWords(editable: HTMLElement, range: Range): Range {
 	const { startContainer, endContainer } = range;
 	let startOffset = range.startOffset;
 	let endOffset = range.endOffset;
@@ -197,20 +262,18 @@ export function expandSelectionToWords(editable: HTMLElement, selection: Selecti
 		while (endOffset < text.length && !/\s/.test(text[endOffset])) endOffset++;
 	}
 
-	if (startOffset === range.startOffset && endOffset === range.endOffset) return;
-
 	const expanded = document.createRange();
 	expanded.setStart(startContainer, startOffset);
 	expanded.setEnd(endContainer, endOffset);
-	selection.removeAllRanges();
-	selection.addRange(expanded);
+	return expanded;
 }
 
 /** Убирает пробелы по краям выделения (например, после двойного клика по слову). */
 export function trimSelectionWhitespace(editable: HTMLElement) {
-	const selection = window.getSelection();
-	if (!selection || selection.rangeCount === 0 || selection.isCollapsed) return;
+	const selection = innerSelection(editable);
+	if (!selection || selection.isCollapsed) return;
 
+	// внутри редактора должно быть не только начало выделения, но и его конец
 	const range = selection.getRangeAt(0);
 	if (!editable.contains(range.startContainer) || !editable.contains(range.endContainer)) return;
 

package/source/emoji.ts

@@ -0,0 +1,53 @@
+// Набор смайликов для кнопки вставки в тулбаре. Все символы — одиночные кодпойнты (без
+// ZWJ-последовательностей и модификаторов), поэтому переносятся в текст как единое целое.
+// Внимание: в UTF-16 каждый занимает две единицы, и getLength() (а значит и maxlength у
+// хоста) считает такой символ за два.
+
+/** Смайлики, доступные в панели вставки (порядок сохраняется в UI). */
+export const EMOJIS: string[] = [
+	"😀", "😁", "😂", "😃", "😄", "😅", "😆", "😉", "😊", "😋", "😌", "😍", "😏", "😒", "😓", "😔",
+	"😖", "😘", "😚", "😜", "😝", "😞", "😠", "😡", "😢", "😣", "😤", "😥", "😨", "😩", "😪", "😫",
+	"😭", "😰", "😱", "😲", "😳", "😵", "😷", "😸", "😹", "😺", "😻", "😼", "😽", "😾", "😿", "🙀",
+	"🙅", "🙆", "🙇", "🙈", "🙉", "🙊", "🙋", "🙌", "🙍", "🙎", "🙏", "🚀", "🚃", "🚄", "🚅", "🚇",
+	"🚉", "🚌", "🚏", "🚑", "🚒", "🚓", "🚕", "🚗", "🚙", "🚚", "🚢", "🚤", "🚥", "🚧", "🚨", "🚩",
+	"🚪", "🚫", "🚬", "🚭", "🚲", "🚶", "🚹", "🚺", "🚻", "🚼", "🚽", "🚾", "🛀", "🅰", "🅱", "🅾",
+	"🅿", "🆎", "🆑", "🆒", "🆓", "🆔", "🆕", "🆖", "🆗", "🆘", "🆙", "🆚", "🈁", "🈂", "🈚", "🈯",
+	"🈲", "🈳", "🈴", "🈵", "🈶", "🈷", "🈸", "🈹", "🈺", "🉐", "🉑", "🀄", "🃏", "🌀", "🌁", "🌂",
+	"🌃", "🌄", "🌅", "🌆", "🌇", "🌈", "🌉", "🌊", "🌋", "🌌", "🌏", "🌑", "🌓", "🌔", "🌕", "🌙",
+	"🌛", "🌟", "🌠", "🌰", "🌱", "🌴", "🌵", "🌷", "🌸", "🌹", "🌺", "🌻", "🌼", "🌽", "🌾", "🌿",
+	"🍀", "🍁", "🍂", "🍃", "🍄", "🍅", "🍆", "🍇", "🍈", "🍉", "🍊", "🍌", "🍍", "🍎", "🍏", "🍑",
+	"🍒", "🍓", "🍔", "🍕", "🍖", "🍗", "🍘", "🍙", "🍚", "🍛", "🍜", "🍝", "🍞", "🍟", "🍠", "🍡",
+	"🍢", "🍣", "🍤", "🍥", "🍦", "🍧", "🍨", "🍩", "🍪", "🍫", "🍬", "🍭", "🍮", "🍯", "🍰", "🍱",
+	"🍲", "🍳", "🍴", "🍵", "🍶", "🍷", "🍸", "🍹", "🍺", "🍻", "🎀", "🎁", "🎂", "🎃", "🎄", "🎅",
+	"🎆", "🎇", "🎈", "🎉", "🎊", "🎋", "🎌", "🎍", "🎎", "🎏", "🎐", "🎑", "🎒", "🎓", "🎠", "🎡",
+	"🎢", "🎣", "🎤", "🎥", "🎦", "🎧", "🎨", "🎩", "🎪", "🎫", "🎬", "🎭", "🎮", "🎯", "🎰", "🎱",
+	"🎲", "🎳", "🎴", "🎵", "🎶", "🎷", "🎸", "🎹", "🎺", "🎻", "🎼", "🎽", "🎾", "🎿", "🏀", "🏁",
+	"🏂", "🏃", "🏄", "🏆", "🏈", "🏊", "🏠", "🏡", "🏢", "🏣", "🏥", "🏦", "🏧", "🏨", "🏩", "🏪",
+	"🏫", "🏬", "🏭", "🏮", "🏯", "🏰", "🐌", "🐍", "🐎", "🐑", "🐒", "🐔", "🐗", "🐘", "🐙", "🐚",
+	"🐛", "🐜", "🐝", "🐞", "🐟", "🐠", "🐡", "🐢", "🐣", "🐤", "🐥", "🐦", "🐧", "🐨", "🐩", "🐫",
+	"🐬", "🐭", "🐮", "🐯", "🐰", "🐱", "🐲", "🐳", "🐴", "🐵", "🐶", "🐷", "🐸", "🐹", "🐺", "🐻",
+	"🐼", "🐽", "🐾", "👀", "👂", "👃", "👄", "👅", "👆", "👇", "👈", "👉", "👊", "👋", "👌", "👍",
+	"👎", "👏", "👐", "👑", "👒", "👓", "👔", "👕", "👖", "👗", "👘", "👙", "👚", "👛", "👜", "👝",
+	"👞", "👟", "👠", "👡", "👢", "👣", "👤", "👦", "👧", "👨", "👩", "👪", "👫", "👮", "👯", "👰",
+	"👱", "👲", "👳", "👴", "👵", "👶", "👷", "👸", "👹", "👺", "👻", "👼", "👽", "👾", "👿", "💀",
+	"💁", "💂", "💃", "💄", "💅", "💆", "💇", "💈", "💉", "💊", "💋", "💌", "💍", "💎", "💏", "💐",
+	"💑", "💒", "💓", "💔", "💕", "💖", "💗", "💘", "💙", "💚", "💛", "💜", "💝", "💞", "💟", "💠",
+	"💡", "💢", "💣", "💤", "💥", "💦", "💧", "💨", "💩", "💪", "💫", "💬", "💮", "💯", "💰", "💱",
+	"💲", "💳", "💴", "💵", "💸", "💹", "💺", "💻", "💼", "💽", "💾", "💿", "📀", "📁", "📂", "📃",
+	"📄", "📅", "📆", "📇", "📈", "📉", "📊", "📋", "📌", "📍", "📎", "📏", "📐", "📑", "📒", "📓",
+	"📔", "📕", "📖", "📗", "📘", "📙", "📚", "📛", "📜", "📝", "📞", "📟", "📠", "📡", "📢", "📣",
+	"📤", "📥", "📦", "📧", "📨", "📩", "📪", "📫", "📮", "📰", "📱", "📲", "📳", "📴", "📶", "📷",
+	"📹", "📺", "📻", "📼", "🔃", "🔊", "🔋", "🔌", "🔍", "🔎", "🔏", "🔐", "🔑", "🔒", "🔓", "🔔",
+	"🔖", "🔗", "🔘", "🔙", "🔚", "🔛", "🔜", "🔝", "🔞", "🔟", "🔠", "🔡", "🔢", "🔣", "🔤", "🔥",
+	"🔦", "🔧", "🔨", "🔩", "🔪", "🔫", "🔮", "🔯", "🔰", "🔱", "🔲", "🔳", "🔴", "🔵", "🔶", "🔷",
+	"🔸", "🔹", "🔺", "🔻", "🔼", "🔽", "🕐", "🕑", "🕒", "🕓", "🕔", "🕕", "🕖", "🕗", "🕘", "🕙",
+	"🕚", "🕛", "🗻", "🗼", "🗽", "🗾", "🗿", "😇", "😈", "😎", "😐", "😑", "😕", "😗", "😙", "😛",
+	"😟", "😦", "😧", "😬", "😮", "😯", "😴", "😶", "🚁", "🚂", "🚆", "🚈", "🚊", "🚍", "🚎", "🚐",
+	"🚔", "🚖", "🚘", "🚛", "🚜", "🚝", "🚞", "🚟", "🚠", "🚡", "🚣", "🚦", "🚮", "🚯", "🚰", "🚱",
+	"🚳", "🚴", "🚵", "🚷", "🚸", "🚿", "🛁", "🛂", "🛃", "🛄", "🛅", "🌍", "🌎", "🌐", "🌒", "🌖",
+	"🌗", "🌘", "🌚", "🌜", "🌝", "🌞", "🌲", "🌳", "🍋", "🍐", "🍼", "🏇", "🏉", "🏤", "🐀", "🐁",
+	"🐂", "🐃", "🐄", "🐅", "🐆", "🐇", "🐈", "🐉", "🐊", "🐋", "🐏", "🐐", "🐓", "🐕", "🐖", "🐪",
+	"👥", "👬", "👭", "💭", "💶", "💷", "📬", "📭", "📯", "📵", "🔀", "🔁", "🔂", "🔄", "🔅", "🔆",
+	"🔇", "🔉", "🔕", "🔬", "🔭", "🕜", "🕝", "🕞", "🕟", "🕠", "🕡", "🕢", "🕣", "🕤", "🕥", "🕦",
+	"🕧",
+];

package/source/format-config.ts

@@ -3,11 +3,23 @@
 export type FormatTool = "bold" | "italic" | "strike" | "underline";
 export type FormatStorage = "html" | "markdown";
 
+/**
+ * Что делает Enter в многострочном режиме.
+ *
+ * `block` — новый абзац (`<p>`, в markdown `\n\n`); модификатор даёт мягкий перенос.
+ * `break` — мягкий перенос (`<br>`, в markdown `\n`), как в мессенджерах: абзац там набирается
+ * двумя переносами. Без этого каждый Enter уезжал бы в хранилище пустой строкой.
+ */
+export type ParagraphMode = "block" | "break";
+
+/** Действие редактора (не формат): вставка смайлика, очистка форматирования, отмена и повтор. */
+export type EditorAction = "emoji" | "erase" | "undo" | "redo";
+
 export const ALL_FORMAT_TOOLS: FormatTool[] = ["bold", "italic", "strike", "underline"];
 
+export const ALL_EDITOR_ACTIONS: EditorAction[] = ["emoji", "erase", "undo", "redo"];
+
 interface FormatToolDef {
-	/** Имя команды (атрибут command у кнопки и registerCommand). */
-	command: string;
 	/** Канонический тег при оборачивании и сериализации. */
 	tag: string;
 	/** Теги, распознаваемые при разборе входного HTML. */
@@ -22,7 +34,6 @@ interface FormatToolDef {
 
 export const FORMAT_TOOLS: Record<FormatTool, FormatToolDef> = {
 	bold: {
-		command: "format-bold",
 		tag: "b",
 		matchTags: ["B", "STRONG"],
 		md: "**",
@@ -30,31 +41,40 @@ export const FORMAT_TOOLS: Record<FormatTool, FormatToolDef> = {
 		title: "Жирный",
 	},
 	italic: {
-		command: "format-italic",
 		tag: "i",
 		matchTags: ["I", "EM"],
-		md: "*",
+		md: "_",
 		hotkey: "i",
 		title: "Курсив",
 	},
 	strike: {
-		command: "format-strike",
 		tag: "s",
 		matchTags: ["S", "STRIKE", "DEL"],
-		md: "~~",
+		md: "~",
 		hotkey: "",
 		title: "Зачёркнутый",
 	},
 	underline: {
-		command: "format-underline",
 		tag: "u",
 		matchTags: ["U", "INS"],
-		md: "++",
+		md: "__",
 		hotkey: "u",
 		title: "Подчёркнутый",
 	},
 };
 
+interface EditorActionDef {
+	/** Подсказка на кнопке. */
+	title: string;
+}
+
+export const EDITOR_ACTIONS: Record<EditorAction, EditorActionDef> = {
+	emoji: { title: "Вставить смайлик" },
+	erase: { title: "Очистить форматирование" },
+	undo: { title: "Отменить (Ctrl+Z)" },
+	redo: { title: "Повторить (Ctrl+Y)" },
+};
+
 /** Markdown-маркер для каждого инструмента форматирования. */
 export type FormatMarkers = Record<FormatTool, string>;
 
@@ -75,15 +95,22 @@ export const HOTKEY_TOOLS: Record<string, FormatTool> = (() => {
 	return map;
 })();
 
-/** Разбирает значение атрибута data-format-tools, оставляя только известные инструменты. */
-export function parseFormatTools(value: string | null): FormatTool[] {
-	if (value === null) return ALL_FORMAT_TOOLS.slice();
+// Разбор атрибута-списка через пробел: оставляет только известные значения,
+// убирает дубли и восстанавливает порядок объявления.
+function parseList<T extends string>(value: string, known: T[]): T[] {
+	const parsed = value.split(/\s+/).filter(Boolean);
+	return known.filter((item) => parsed.includes(item));
+}
 
-	const tools = value
-		.split(/\s+/)
-		.filter(Boolean)
-		.filter((t): t is FormatTool => (ALL_FORMAT_TOOLS as string[]).includes(t));
+/** Разбирает значение атрибута data-format-tools; отсутствие атрибута — все инструменты. */
+export function parseFormatTools(value: string | null): FormatTool[] {
+	return value === null ? ALL_FORMAT_TOOLS.slice() : parseList(value, ALL_FORMAT_TOOLS);
+}
 
-	// убираем дубли, сохраняя порядок объявления
-	return ALL_FORMAT_TOOLS.filter((t) => tools.includes(t));
+/**
+ * Разбирает значение атрибута data-editor-actions. В отличие от инструментов,
+ * действия подключаются явно: отсутствие атрибута — пустой набор.
+ */
+export function parseEditorActions(value: string | null): EditorAction[] {
+	return value === null ? [] : parseList(value, ALL_EDITOR_ACTIONS);
 }

package/source/format.ts

@@ -5,15 +5,35 @@
 //   paragraphs    — нормализация пробелов и приведение к абзацам <p>
 
 export {
+	ALL_EDITOR_ACTIONS,
 	ALL_FORMAT_TOOLS,
+	EDITOR_ACTIONS,
 	FORMAT_TOOLS,
 	HOTKEY_TOOLS,
 	defaultFormatMarkers,
+	parseEditorActions,
 	parseFormatTools,
+	type EditorAction,
 	type FormatMarkers,
 	type FormatStorage,
+	type ParagraphMode,
 	type FormatTool,
 } from "./format-config";
 export { serialize, deserialize } from "./serialize";
-export { selectionCharBounds, restoreSelection, toggleFormat, insertFormattedText, isFormatActive } from "./selection";
-export { normalizeWhitespace, normalizeParagraphs, ensureParagraphs } from "./paragraphs";
+export {
+	documentSelection,
+	innerSelection,
+	preserveCaret,
+	selectionCharBounds,
+	restoreSelection,
+	mapCharOffset,
+	activeFormats,
+	toggleFormat,
+	clearFormat,
+	clearAllFormat,
+	hasFormatting,
+	hasAnyFormatting,
+	insertFormattedText,
+	isFormatActive,
+} from "./selection";
+export { isBlock, normalizeWhitespace, normalizeParagraphs, ensureParagraphs } from "./paragraphs";