@olddevs/ui 0.0.0-stage → 4.0.1

package/src/i18n/useMessages.ts

@@ -0,0 +1,47 @@
+"use client";
+
+import { useContext } from "react";
+import { useLocale } from "react-aria-components";
+import type { Density } from "../lib/variants.js";
+import { UiContext } from "./context.js";
+import { DEFAULT_MESSAGES } from "./defaults.js";
+import type { UiMessages } from "./messages.js";
+
+/**
+ * Каталог сообщений: провайдера нет — английский фолбэк.
+ *
+ * Хук намеренно не принимает ключ и не режет каталог по пространствам имён:
+ * компонент читает `messages.pagination.next`, и это видно в его коде. Хук вида
+ * `useMessage("pagination.next")` спрятал бы ключ в строку, где ни компилятор,
+ * ни поиск по репозиторию его не увидят.
+ */
+export function useMessages(): UiMessages {
+  return useContext(UiContext)?.messages ?? DEFAULT_MESSAGES;
+}
+
+/**
+ * Локаль для `Intl` и `@internationalized/date`.
+ *
+ * Порядок: явная локаль `UiProvider` → локаль `I18nProvider` потребителя →
+ * локаль браузера. Последние две даёт `useLocale` из react-aria, поэтому кит
+ * не спорит с приложением, а встраивается в него.
+ */
+export function useUiLocale(): string {
+  const explicit = useContext(UiContext)?.locale;
+  const { locale } = useLocale();
+  return explicit ?? locale;
+}
+
+/** Направление письма, контейнер порталов и плотность, объявленные провайдером. */
+export function useUiConfig(): {
+  dir: "ltr" | "rtl";
+  portalContainer: HTMLElement | null;
+  density: Density;
+} {
+  const ctx = useContext(UiContext);
+  return {
+    dir: ctx?.dir ?? "ltr",
+    portalContainer: ctx?.portalContainer ?? null,
+    density: ctx?.density ?? "comfortable",
+  };
+}

package/src/icons.ts

@@ -0,0 +1,566 @@
+/**
+ * Семантический словарь иконок дизайн-системы.
+ *
+ * ЧТО ЭТО И ПОЧЕМУ ОТДЕЛЬНЫМ ФАЙЛОМ, А НЕ ПРОСТО `import { X } from "lucide-react"`
+ * В КАЖДОМ МЕСТЕ ВЫЗОВА:
+ *
+ * Геометрию иконок мы арендуем у lucide, а системное решение — не в путях SVG,
+ * а в словаре: «удаление — это корзина, а не крестик; ИИ — это `WandSparkles`;
+ * поиск похожих — это `ScanSearch`». Это решение дизайн-системы, и оно должно
+ * жить в одном месте, а не быть размазанным по полусотне файлов потребителя.
+ *
+ * Отсюда три следствия:
+ *
+ * 1. Смена визуального языка целиком (уйти с lucide на phosphor, нарисовать своё)
+ *    — это правка ОДНОГО файла, а не форк компонентов.
+ * 2. Точечная замена («шестерёнка не нравится, хочу другую») — одна строка здесь,
+ *    и она разъезжается по всем местам вызова сразу.
+ * 3. Потребитель не решает заново, какой иконкой обозначить удаление. Именно
+ *    поэтому имена семантические (`DeleteIcon`), а не геометрические (`Trash2Icon`)
+ *    везде, где смысл важнее формы.
+ *
+ * СТИЛЬ (размер, толщина, цвет) здесь НЕ задаётся — это работа `LucideProvider`
+ * у потребителя. Разделение намеренное: словарь отвечает за «что», провайдер за «как».
+ *
+ * ИМЕНА СВЕРЯЮТСЯ ПО УСТАНОВЛЕННОМУ ПАКЕТУ, НЕ ПО ДОКАМ И НЕ ПО ЧЕЙНДЖЛОГУ.
+ * Проверено: `pending-cw` числится в релиз-нотах lucide 1.27.0, а экспорта
+ * `PendingCw` в опубликованном пакете нет. Страхует `tests/icons.test.ts`.
+ *
+ * И ТОЛЬКО КАНОНИЧЕСКИЕ ИМЕНА, А НЕ АЛИАСЫ. `Trash2`, `Filter`, `Home`, `History`
+ * в установленном пакете — лишь второе имя рисунка (`Trash`, `Funnel`, `House`,
+ * `RotateCcwClock`), а алиасы уезжают в мажорах lucide. Иногда алиас ведёт и не
+ * туда, куда ждёшь: `BarChart` — это `ChartNoAxesColumnIncreasing`, а не
+ * `ChartColumn`. Каноническое имя — `displayName` компонента.
+ *
+ * С 3.29.0 в словаре есть базовый набор: смыслы, которые есть в наборах иконок
+ * почти всех крупных систем (ADR-0049). Остальное — по заявке, как раньше.
+ */
+
+export {
+  // ── Навигация и разделы ────────────────────────────────────────────────
+  LayoutDashboard as DashboardIcon,
+  LibraryBig as LibraryIcon,
+  Search as SearchIcon,
+  Calendar as CalendarIcon,
+  Folder as FolderIcon,
+  /**
+   * Перечень записей: список задач, дел, пунктов.
+   *
+   * Отличается от `FolderIcon` и `LibraryIcon` смыслом: те про хранилище и
+   * вложенность, этот — про сам перечень.
+   *
+   * Рисунок «несколько горизонтальных линий» в наборе уже был — это
+   * `NavigationIcon`, гамбургер. Второй смысл на него не вешается: в ряду
+   * вкладок он прочитается как «меню».
+   *
+   * Маркеры, а не флажки (`ListTodo` у lucide): галочка внутри иконки читается
+   * как «выполнено» и спорит с `SuccessIcon`, который в таком ряду стоит
+   * обычно рядом.
+   *
+   * Он же — маркированный список в панели Редактора: смысл тот же, «перечень
+   * с маркерами», и второе имя на этот рисунок словарь не заводит (ADR-0049).
+   */
+  List as ListIcon,
+  /**
+   * Цель, за которую берутся: мишень.
+   *
+   * Имя по рисунку — редкое в этом словаре исключение, и оно намеренное.
+   * Смысл мишени киту не принадлежит: у одного потребителя это «доступно
+   * сейчас», у другого — план или точность. Назвать её по одному из этих
+   * смыслов значило бы закрыть её для остальных.
+   *
+   * Не `PlayIcon` («начать») и не `FavoriteIcon` («моё»): оба заняты, и оба
+   * означают выбор человека, а не свойство самой записи.
+   */
+  Target as TargetIcon,
+  Settings as SettingsIcon,
+  Bell as BellIcon,
+  /** Открыть навигацию на узком экране: «гамбургер» шапки. */
+  Menu as NavigationIcon,
+  /** Главная, корень приложения. Не `DashboardIcon`: тот — раздел-сводка, а не корень. */
+  House as HomeIcon,
+  /** Назад по истории или на уровень выше. Не `ChevronLeftIcon`: шеврон — шаг, «предыдущий». */
+  ArrowLeft as BackIcon,
+  /** Далее, перейти. Пара к `BackIcon`; не `ChevronRightIcon` — тот про шаг и вложенность. */
+  ArrowRight as ForwardIcon,
+  /** Показать или скрыть боковую панель. Не `NavigationIcon`: гамбургер открывает навигацию на узком экране. */
+  PanelLeft as SidebarIcon,
+  /** Раздел кампаний. */
+  Ad as CampaignIcon,
+  /** Telegram-канал как адресат публикации. */
+  Megaphone as ChannelIcon,
+
+  // ── Разделы настроек ───────────────────────────────────────────────────
+  /** Профиль пользователя. */
+  User as ProfileIcon,
+  /** Внешний вид: тема, акцент, плотность. */
+  Contrast as AppearanceIcon,
+  /** ИИ и автоматизация. */
+  Cpu as AutomationIcon,
+  /** Внешние интеграции. */
+  Plug as IntegrationIcon,
+  /** Хранилище и API. */
+  Database as StorageIcon,
+  /** Безопасность и доступ. */
+  Shield as SecurityIcon,
+
+  // ── Действия ───────────────────────────────────────────────────────────
+  Upload as UploadIcon,
+  Download as DownloadIcon,
+  Funnel as FilterIcon,
+  Ellipsis as MoreIcon,
+  /** Ручка перетаскивания: за неё берут строку сортируемого списка. */
+  GripVertical as DragHandleIcon,
+  Pencil as EditIcon,
+  Check as CheckIcon,
+  /**
+   * Третье состояние флажка — «часть выбрана».
+   *
+   * Не `CheckIcon` под другим углом и не своя рисовка: словарь обязан назвать
+   * это состояние отдельным смыслом, иначе сменить его начертание можно будет
+   * только правкой самого `Checkbox`.
+   */
+  Minus as MinusIcon,
+  /** Закрыть. Самое частое действие во фронте. */
+  X as CloseIcon,
+  Plus as AddIcon,
+  /**
+   * Начать воспроизведение или отсчёт: настоящее транспортное действие.
+   *
+   * Только кнопка. Пометкой «начал» в истории `PlayIcon` быть перестал — для
+   * неё заведён `FirstStepIcon`: два play с разным смыслом в одном ряду
+   * потребитель уже прочитал неверно, приняв запись в историю за кнопку.
+   *
+   * Продолжение после паузы — он же: это ровно тот смысл, под который он заведён.
+   */
+  Play as PlayIcon,
+  /**
+   * Приостановить воспроизведение или отсчёт.
+   *
+   * Пара к `PlayIcon` и вторая половина транспорта. Иконки «стоп» рядом нет и
+   * не заводится: завершение — действие с последствиями, оно подписывается
+   * словом, а не метафорой.
+   */
+  Pause as PauseIcon,
+  Copy as CopyIcon,
+  /** Копирование пачкой — в старом наборе звалось `copy2`. */
+  Files as CopyManyIcon,
+  ClipboardPaste as PasteIcon,
+  Trash as DeleteIcon,
+  /** Отменить действие. `Undo2`, а не дуга `Undo`: дуга со стрелкой — это `RefreshIcon`. */
+  Undo2 as UndoIcon,
+  /** Повторить отменённое. Не `RecurringIcon`: тот — «повторяется по правилу», свойство записи. */
+  Redo2 as RedoIcon,
+  /** Поделиться. Узлы, а не коробка со стрелкой (`Share`): та спорит с `UploadIcon`. */
+  Share2 as ShareIcon,
+  /** Закрепить: колонку, запись, представление. Не `FavoriteIcon` — тот про «моё», а не про место. */
+  Pin as PinIcon,
+  /** Настроить этот вид. Не `SettingsIcon` (раздел настроек) и не `FilterIcon` (сузить данные). */
+  SlidersHorizontal as AdjustIcon,
+  /** Сортировать. Стрелки, а не шевроны: шевроны «вверх-вниз» — это `SelectIcon`. */
+  ArrowUpDown as SortIcon,
+  ArrowUpNarrowWide as SortAscendingIcon,
+  ArrowDownWideNarrow as SortDescendingIcon,
+  /** Масштаб. Третья лупа после `SearchIcon` и `FindSimilarIcon`: рядом без подписи не ставить. */
+  ZoomIn as ZoomInIcon,
+  ZoomOut as ZoomOutIcon,
+  Printer as PrintIcon,
+  Link as LinkIcon,
+  /** Ссылка ведёт наружу — за пределы приложения. Иконка у `Link external`. */
+  ExternalLink as ExternalLinkIcon,
+  Send as SendIcon,
+  RefreshCw as RefreshIcon,
+  Archive as ArchiveIcon,
+  /** Убрать из архива/коллекции. */
+  ArchiveX as ArchiveRemoveIcon,
+  /** «Найти похожие» — семантический поиск по картинке. */
+  ScanSearch as FindSimilarIcon,
+  Maximize2 as ExpandIcon,
+  Minimize2 as CollapseIcon,
+  /**
+   * Выход из аккаунта.
+   *
+   * Дверной проём со стрелкой наружу: по отдельности ни то, ни другое не
+   * читается — голая стрелка означает «дальше», проём без стрелки «вход».
+   * Имя по действию, а не по рисунку (`DoorIcon`): рисунок у иконки действия
+   * может смениться, действие — нет.
+   *
+   * `CloseIcon` здесь не подмена, а худший из промахов: в меню крестик значит
+   * «закрыть меню», то есть ровно противоположное — человек ждёт, что меню
+   * свернётся, а его разлогинит.
+   */
+  LogOut as LogoutIcon,
+
+  // ── Шевроны ────────────────────────────────────────────────────────────
+  ChevronRight as ChevronRightIcon,
+  ChevronLeft as ChevronLeftIcon,
+  ChevronDown as ChevronDownIcon,
+  ChevronUp as ChevronUpIcon,
+  ChevronsRight as ChevronDoubleRightIcon,
+  ChevronsLeft as ChevronDoubleLeftIcon,
+  /** Триггер выпадающего списка. */
+  ChevronsUpDown as SelectIcon,
+
+  // ── Состояния и признаки ───────────────────────────────────────────────
+  Eye as VisibleIcon,
+  EyeOff as HiddenIcon,
+  /** Метка, ярлык: ценник. Решётку системы называют «hashtag», это другой смысл. */
+  Tag as TagIcon,
+  TriangleAlert as WarningIcon,
+  Image as ImageIcon,
+  /** Пояснение, информация. Кружок с «i». */
+  Info as InfoIcon,
+  /** Помощь: кружок с «?». Не `InfoIcon` — помощь и информацию системы держат раздельно. */
+  CircleQuestionMark as HelpIcon,
+  /** Совет, подсказка. Не `InfoIcon`: тот — нейтральное пояснение. */
+  Lightbulb as TipIcon,
+  /** Пометить проблему, пожаловаться. Не для начала работы — это `FirstStepIcon`. */
+  Flag as FlagIcon,
+  /** Запрещено. Не `ErrorIcon` (не получилось) и не `LockIcon` (заперто, но доступно с ключом). */
+  Ban as BlockedIcon,
+  /**
+   * Успех — в сообщении, а не в флажке.
+   *
+   * Отдельный смысл от `CheckIcon`: та означает «отмечено», эта — «получилось».
+   * Совмещать их значило бы, что сменить начертание одного нельзя, не сменив
+   * второе.
+   */
+  CircleCheck as SuccessIcon,
+  /** Ошибка — то, что не получилось и требует внимания. */
+  CircleAlert as ErrorIcon,
+  /**
+   * Срок, к которому нужно сделать: дедлайн записи.
+   *
+   * ЗАЧЕМ ОТДЕЛЬНОЕ ИМЯ, КОГДА ЕСТЬ `CalendarIcon`. Дата в словаре была ровно
+   * одна и означала «дата вообще». Но у записи их бывает две, и они
+   * ортогональны: «когда станет актуально» и «когда горит». Один рисунок на
+   * обе помечает одинаково ровно то, что продукт и заведён различать (заявка
+   * Nextable).
+   *
+   * Песочные часы, а не второй календарь: календарный силуэт на 14 пикселях
+   * читается как «дата», и в соседней колонке с `CalendarIcon` разница между
+   * ними исчезает. У часов силуэт вертикальный и ни на что в словаре не похож.
+   *
+   * Отвергнуты и остальные соседи, у каждого свой смысл: `TargetIcon` — цель,
+   * за которую берутся; `BellIcon` — напоминание; `WarningIcon` — просрочка,
+   * то есть вычисленное состояние, а не поле; `Clock` и `ClockAlert` читаются
+   * «время вообще» и «тревога»; `FlagTriangleRight` на 14 пикселях
+   * превращается в треугольник play — та же ловушка, из-за которой пометку
+   * начала работы рисует `FirstStepIcon`.
+   */
+  Hourglass as DeadlineIcon,
+  /**
+   * Повторяется по правилу: запись возвращается сама.
+   *
+   * НЕ `RefreshIcon`, и разница не в рисунке, а в смысле. Круговые стрелки в
+   * интерфейсе означают перезагрузку — «обнови то, что видишь»; повтор
+   * означает свойство самой записи. Один рисунок на оба закрыл бы второй смысл
+   * для всех потребителей — та же развилка, на которой словарь уже развёл
+   * `CheckIcon` и `SuccessIcon`.
+   *
+   * `Repeat`, а не `RotateCw` и не `IterationCw`: у первого прямоугольная
+   * петля из двух стрелок — знак повтора из плееров, и рядом с круглым
+   * `RefreshIcon` он различим даже на 14 пикселях. Вторые два — дуга со
+   * стрелкой, то есть «отменить» и «повторить действие».
+   */
+  Repeat as RecurringIcon,
+  /**
+   * Приступил к работе: первый шаг сделан.
+   *
+   * Это ПОМЕТКА, а не кнопка: запись в истории о том, что дело сдвинулось.
+   * Раньше на этом месте стоял `PlayIcon`, и владелец продукта прочитал его как
+   * транспортную кнопку — попросил «поставить на паузу», нажав на пометку. С
+   * появлением паузы в том же ряду два play стали бы неразличимы по смыслу.
+   *
+   * Следы, а не флажок: флажок в трекерах означает «проблема, заблокировано»
+   * (так он подан в Jira), и пометка о начале работы читалась бы тревогой.
+   * `FlagTriangleRight` отвергнут по рисунку — в ряду 14 пикселей он и есть
+   * треугольник play, то есть повторил бы ровно ту ошибку, ради которой иконка
+   * заводится. `Hourglass` означает ожидание, а не начало; `CircleDot` в ряду
+   * читается как переключатель; `Timer` спорит с самим таймером полосы.
+   *
+   * Имя по смыслу, а не по рисунку: следы могут смениться, «первый шаг» — нет.
+   */
+  Footprints as FirstStepIcon,
+  /**
+   * Ручка перетаскивания.
+   *
+   * @deprecated Тот же рисунок, что `DragHandleIcon`: берите его. Уйдёт в 4.0.0.
+   */
+  GripVertical as DragIcon,
+  Layers as LayersIcon,
+  Palette as PaletteIcon,
+  Keyboard as KeyboardIcon,
+  /** Подтвердить ввод или отправить поиск с экранной клавиатуры. */
+  CornerDownLeft as EnterIcon,
+  /** Смена языка ввода и раскладки. */
+  Earth as LanguageIcon,
+  Heart as FavoriteIcon,
+  /** Звезда оценки. Отличается от избранного смыслом: избранное — отметка
+      «моё», оценка — величина (ADR-0040). */
+  Star as RatingStarIcon,
+  Sparkle as SparkleIcon,
+  Sparkles as SparklesIcon,
+  /** Генерация текста ИИ. */
+  WandSparkles as AiIcon,
+
+  // ── Файлы и общение ────────────────────────────────────────────────────
+  /** Вложение: прикреплённый файл. Не `LinkIcon` — тот ссылка. */
+  Paperclip as AttachmentIcon,
+  /** Файл, документ. Не `FolderIcon`: тот — вместилище. */
+  File as FileIcon,
+  FolderOpen as FolderOpenIcon,
+  /** Комментарий, обсуждение. Квадратное облачко: круглое на 14 px сливается с `InfoIcon`. */
+  MessageSquare as CommentIcon,
+  /** Упоминание (@). Не `MailIcon`: тот — письмо как тема дела. */
+  AtSign as MentionIcon,
+  BellOff as NotificationsOffIcon,
+
+  // ── Люди и доступ ──────────────────────────────────────────────────────
+  /** Команда, участники. Не `ProfileIcon`: один человек — профиль. */
+  Users as TeamIcon,
+  UserPlus as AddUserIcon,
+  /** Вход в аккаунт. Пара к `LogoutIcon`; не `EnterIcon` — тот клавиша Enter. */
+  LogIn as LoginIcon,
+  /** Заперто, только чтение, приватно. Не `SecurityIcon`: щит — раздел настроек. */
+  Lock as LockIcon,
+  LockOpen as UnlockIcon,
+  KeyRound as KeyIcon,
+
+  // ── Время и место ──────────────────────────────────────────────────────
+  /** Время вообще. Не `DeadlineIcon` (срок) и не `HistoryIcon` (часы со стрелкой — прошлое). */
+  Clock as TimeIcon,
+  /** История изменений. Не `UndoIcon` и не `RefreshIcon`: те — действия, а не журнал. */
+  RotateCcwClock as HistoryIcon,
+  /** Место, адрес. Не `TripIcon` (поездка как тема дела) и не `PinIcon` (закрепить). */
+  MapPin as LocationIcon,
+
+  // ── Вид данных ─────────────────────────────────────────────────────────
+  Table as TableIcon,
+  /** Выбор колонок таблицы. Не `AdjustIcon`: тот настраивает вид целиком. */
+  Columns3 as ColumnsIcon,
+  /** Аналитика, график. Не `DashboardIcon` — тот раздел-сводка. */
+  ChartColumn as ChartIcon,
+
+  // ── Предметные темы ────────────────────────────────────────────────────
+  //
+  // ЗАЧЕМ ПРОДУКТОВО-НЕЙТРАЛЬНОМУ СЛОВАРЮ ТЕМЫ ПРЕДМЕТНОГО МИРА. Остальные
+  // разделы описывают интерфейс: навигацию, действия, состояния. Эти десять
+  // описывают то, о чём задача, — и это первый такой раздел.
+  //
+  // Заведён он не ради одного потребителя, а потому что альтернатива хуже.
+  // Потребителю нужна иконка «позвонить» в строке списка; в словаре нет ни
+  // одной такой темы, и по правилу набора брать «что-то похожее» из lucide мимо
+  // словаря нельзя. Значит, либо тема живёт здесь одним решением, либо каждый
+  // продукт выбирает её заново — и через полгода в двух приложениях одного кита
+  // «звонок» нарисован по-разному.
+  //
+  // Набор закрытый и расширяется заявкой, как и всё остальное здесь. Значение
+  // «без темы» в словаре не заводится: отсутствие темы — это отсутствие
+  // значения, а не одиннадцатая иконка.
+  //
+  // Все десять проверены столбцом на 16 пикселях — размер, в котором они стоят
+  // в строке списка. По одному проходят любые; сторожит именно столбец.
+  /**
+   * Разработка, код.
+   *
+   * Каноническое имя lucide — `CodeXml`; `Code2`, под которым рисунок знают,
+   * с 1.41.0 лишь алиас к нему, и в словаре ему делать нечего: алиасы из
+   * набора уезжают в мажорах, а мы сверяемся с установленным пакетом.
+   *
+   * Не `AutomationIcon` (процессор): тот про ИИ и автоматизацию, а не про
+   * работу с кодом.
+   */
+  CodeXml as CodeIcon,
+  /** Игра. `Gamepad2`, а не `Gamepad`: второй остался от прежней геометрии набора. */
+  Gamepad2 as GameIcon,
+  /** Покупка: корзина. */
+  ShoppingCart as PurchaseIcon,
+  /**
+   * Здоровье: визит к врачу, лекарства, самочувствие.
+   *
+   * Сердце с пульсом, и пульс здесь — единственное, чем иконка отличается от
+   * `FavoriteIcon` на 16 пикселях. Разница смысловая и существенная: избранное
+   * — выбор человека, здоровье — тема дела. Ставить их в один столбец без
+   * подписи не стоит.
+   */
+  HeartPulse as HealthIcon,
+  /**
+   * Звонок.
+   *
+   * `Phone`, а не `PhoneCall`: у второго по бокам трубки расходящиеся дуги, на
+   * 16 пикселях они сливаются в шум и смысла не добавляют.
+   */
+  Phone as CallIcon,
+  /** Письмо как тема дела. Не `SendIcon`: тот — действие отправки. */
+  Mail as MailIcon,
+  /**
+   * Встреча: рукопожатие.
+   *
+   * До 3.29.0 здесь стояли `Users`, но их забрала «команда» (`TeamIcon`): этот
+   * смысл есть во всех крупных системах, а у встречи общепринятого рисунка нет,
+   * так что уступила она (ADR-0049).
+   *
+   * Не `CalendarIcon`: календарь в ките занят отложенностью, и на одном экране
+   * это был бы один рисунок в двух смыслах.
+   */
+  Handshake as MeetingIcon,
+  /**
+   * Поездка: самолёт.
+   *
+   * Силуэтом соседствует с `SendIcon` — бумажным самолётиком отправки. Рядом
+   * их лучше не ставить; смысл разный: тема дела против действия.
+   */
+  Plane as TripIcon,
+  /** Оплата: кошелёк. Не `StorageIcon` (база данных) — тот про хранилище. */
+  Wallet as PaymentIcon,
+  /** Чтение. Не `LibraryIcon`: тот — раздел-хранилище, полка, а не чтение. */
+  BookOpen as ReadingIcon,
+
+  // ── Форматирование текста ──────────────────────────────────────────────
+  //
+  // Пополнение по заявке, как велит ADR-0049: заявка — панель
+  // `RichTextEditor` (ADR-0050). Рисунки — канонические имена
+  // lucide. Уже занятые смыслы не дублируются: маркированный список —
+  // `ListIcon`, отменить и повторить — `UndoIcon` и `RedoIcon`.
+  /** Заголовок вообще, без уровня: пункты заголовков Меню вставки. Уровень — `Heading1Icon`…`Heading4Icon`. */
+  Heading as HeadingIcon,
+  Bold as BoldIcon,
+  Italic as ItalicIcon,
+  Underline as UnderlineIcon,
+  Strikethrough as StrikethroughIcon,
+  /**
+   * Строчный код — метка внутри абзаца. Не `CodeIcon`: тот предметная тема
+   * «разработка» (`</>`), и в одном ряду с ним этот читался бы его повтором.
+   */
+  Code as InlineCodeIcon,
+  /**
+   * Цвет текста: буква с полосой под ней, в Панели Редактора. Не `PaletteIcon`:
+   * палитра — выбор цветовой схемы, а здесь красится сам текст.
+   */
+  Baseline as TextColorIcon,
+  /** Маркер: выделить текст цветной подложкой. Не `TextColorIcon`: тот красит буквы, этот — фон под ними. */
+  Highlighter as HighlightIcon,
+  /** Выравнивание Блока по краю или по центру. Четыре смысла — это четыре начертания, а не один общий. */
+  AlignLeft as AlignLeftIcon,
+  AlignCenter as AlignCenterIcon,
+  AlignRight as AlignRightIcon,
+  /** По ширине. В Панели Редактора его нет (рваные пробелы), но смысл есть у потребителя. */
+  AlignJustify as AlignJustifyIcon,
+  /** Блок кода. Не `InlineCodeIcon`: тот — метка внутри строки, этот — отдельный Блок в рамке. */
+  SquareCode as CodeBlockIcon,
+  /**
+   * Исходный HTML Документа — кнопка HTML-режима Редактора: лист с
+   * `</>`, «код всего документа». Не `CodeBlockIcon`: тот — Блок кода внутри
+   * Документа; не `CodeIcon`: тот — предметная тема «разработка».
+   */
+  FileCode as SourceIcon,
+  Superscript as SuperscriptIcon,
+  Subscript as SubscriptIcon,
+  /** Снять форматирование с выделения. Не `DeleteIcon`: текст остаётся, уходят метки. */
+  RemoveFormatting as ClearFormattingIcon,
+  ListOrdered as OrderedListIcon,
+  /**
+   * Чек-лист: пункты с флажками. Галочка внутри — ровно его смысл, и потому он
+   * отдельный от `ListIcon`, где флажки отвергнуты.
+   */
+  ListTodo as TaskListIcon,
+  /** Цитата. */
+  Quote as QuoteIcon,
+  /** Разделитель между Блоками. Не `MinusIcon`: тот — третье состояние флажка. */
+  SeparatorHorizontal as DividerIcon,
+  /**
+   * Обычный абзац — пункт «Превратить в» Меню вставки. Не
+   * `HeadingIcon`: тот — тип Блока вообще, этот — именно «просто текст».
+   */
+  Pilcrow as ParagraphIcon,
+  /*
+    Меню «¶» редактора (по ADR-0049): у пунктов
+    типа Блока свои иконки. Заголовок вообще — по-прежнему `HeadingIcon`;
+    иконка с цифрой — именно уровень.
+  */
+  /** Заголовок первого уровня. Не `HeadingIcon`: тот — тип Блока вообще, без уровня. */
+  Heading1 as Heading1Icon,
+  /** Заголовок второго уровня. */
+  Heading2 as Heading2Icon,
+  /** Заголовок третьего уровня. */
+  Heading3 as Heading3Icon,
+  /** Заголовок четвёртого уровня. */
+  Heading4 as Heading4Icon,
+  /**
+   * Обычный текст — пункт «Текст» меню типа Блока. Не `ParagraphIcon`: тот —
+   * пилкроу, «абзац» в Меню вставки; и не `HeadingIcon`: заголовок — другой тип.
+   */
+  Type as TextIcon,
+  /*
+    Таблица в документе. Вставка — уже занятый `TableIcon`, удаление
+    строки, столбца и таблицы — `DeleteIcon`, сортировка — `SortAscendingIcon` и
+    `SortDescendingIcon`, выравнивание столбца — `AlignLeftIcon` и соседи.
+    Направление вставки рисует сама иконка: у lucide на каждую сторону свой.
+  */
+  /** Вставить строку таблицы выше. Не `AddIcon`: тот — «создать» вообще. */
+  BetweenHorizontalStart as InsertRowAboveIcon,
+  /** Вставить строку таблицы ниже. */
+  BetweenHorizontalEnd as InsertRowBelowIcon,
+  /** Вставить столбец таблицы слева. Не `ColumnsIcon`: тот — выбор колонок таблицы данных. */
+  BetweenVerticalStart as InsertColumnLeftIcon,
+  /** Вставить столбец таблицы справа. */
+  BetweenVerticalEnd as InsertColumnRightIcon,
+  /** Объединить выделенные ячейки таблицы в одну. */
+  TableCellsMerge as MergeCellsIcon,
+  /** Разделить объединённую ячейку обратно. */
+  TableCellsSplit as SplitCellIcon,
+  /** Первая строка — заголовки столбцов. Не `TableIcon`: тот — вся таблица. */
+  PanelTop as HeaderRowIcon,
+  /**
+   * Эмодзи: лицо-смайл, кнопка сетки эмодзи в Панели Редактора.
+   * Имя по смыслу «эмодзи», а не по рисунку: лицо в другом месте означало бы
+   * настроение или оценку, и это другое решение (ADR-0049). Не `Smile` без
+   * приставки: словарь называет смысл, а не форму.
+   */
+  Smile as EmojiIcon,
+  /*
+    Ручка Блока редактора (по ADR-0049): кнопка «⋮» у Блока и пункты
+    её меню. Добавить, формат и удалить берут уже занятые `AddIcon`,
+    `ParagraphIcon` и `DeleteIcon`.
+  */
+  /**
+   * «Ещё» в столбец: меню действий у строки или Блока. Не `MoreIcon`: тот — в
+   * ряду кнопок; не `DragHandleIcon`: за эту ручку не тянут, её нажимают.
+   */
+  EllipsisVertical as MoreVerticalIcon,
+  /** Стрелка вверх. Имя по форме (ADR-0049, п. 3): переставить выше, прокрутить, сортировать. */
+  ArrowUp as ArrowUpIcon,
+  /** Стрелка вниз — пара к `ArrowUpIcon`. */
+  ArrowDown as ArrowDownIcon,
+  /** Дублировать: копия рядом с оригиналом. Не `CopyIcon`: тот — в буфер обмена. */
+  CopyPlus as DuplicateIcon,
+  /**
+   * Раскладка Документа колонками — Блок «Раскладка» Редактора.
+   * Не `ColumnsIcon`: тот — выбор колонок таблицы данных, другой смысл на
+   * другом рисунке (ADR-0049).
+   */
+  Columns2 as ColumnLayoutIcon,
+  /**
+   * Обёртка — Блок, собирающий группу Блоков в Редакторе: рамка
+   * пунктирными углами вокруг двух Блоков. Не `ColumnLayoutIcon`: колонки
+   * ставят Блоки рядом, Обёртка — группирует их, не меняя порядка (ADR-0049).
+   */
+  Group as WrapperIcon,
+  /**
+   * Снять Обёртку: Блоки остаются, рамки нет. Пара к `WrapperIcon`, как у
+   * lucide; не `DeleteIcon` — удаляется не содержимое, а только контейнер.
+   */
+  Ungroup as UnwrapIcon,
+
+  // ── Тема и плотность сетки ─────────────────────────────────────────────
+  Sun as ThemeLightIcon,
+  Moon as ThemeDarkIcon,
+  SunMoon as ThemeAutoIcon,
+  Monitor as DesktopIcon,
+  Smartphone as MobileIcon,
+  Grid2x2 as GridSparseIcon,
+  Grid3x3 as GridDenseIcon,
+} from "lucide-react";
+
+export type { LucideProps as IconProps } from "lucide-react";