@intent-driven/adapter-antd-blockeditor-tiptap

Tiptap-backed BlockEditor primitive для @intent-driven/adapter-antd. Опциональный upgrade поверх reference textarea-impl: rich-text inline-formatting (bold / italic / code) через ProseMirror StarterKit, родная Tiptap-обработка структурных kind'ов (paragraph / heading 1–3 / lists / quote / code / hr), slash-commands menu (Notion-style /heading, /todo и т.п.), InlineBubbleMenu для inline-formatting на selection.

Закрывает SDK backlog §12.10 P0 (Notion field-test BlockEditor primitive). Drag-handles и indent — v0.3+ (BlockNote upgrade-path).

Установка

npm install @intent-driven/adapter-antd-blockeditor-tiptap
# peer deps уже стоят: react, react-dom, antd, @intent-driven/adapter-antd

Использование

import { antdAdapter } from "@intent-driven/adapter-antd";
import { registerUIAdapter } from "@intent-driven/renderer";
import { applyTiptapBlockEditor } from "@intent-driven/adapter-antd-blockeditor-tiptap";

applyTiptapBlockEditor(antdAdapter);
registerUIAdapter(antdAdapter);

applyTiptapBlockEditor() mutating заменяет adapter.primitive.blockEditor и обновляет adapter.capabilities.primitive.blockEditor descriptor:

{
  kinds: ["paragraph", "heading-1..3", "bulleted-list-item",
          "numbered-list-item", "to-do", "quote", "code", "divider"],
  slashCommands: true,    // v0.2 — Notion-style /heading /todo /code и т.п.
  indent: false,
  dragHandles: false,
  inlineFormatting: true, // v0.2 — InlineBubbleMenu (B/I/S/code marks)
}

Вызывающему коду (host wrapper, e.g. notion BlockCanvas через <BlockEditor> из @intent-driven/renderer) ничего менять не нужно — primitive получит блоки в том же contract'е (blocks / onChange / onKindChange / readOnly).

Архитектура (v0.2)

• Per-block Tiptap editor instance. Один блок ↔ один ProseMirror. Прозрачное reverse-mapping (text/kind/checked) и stable IDs из domain. Trade-off: нет «слитного» selection через границу блока, нет автоматической slice-операции через несколько блоков.
• AntD Select over each block — kind transition (paragraph → heading-2, и т. п.) как fallback к slash-меню.
• StarterKit-only block extensions — paragraph, heading 1–3, bulletList, orderedList, taskList, blockquote, codeBlock, horizontalRule, hardBreak. Inline marks: bold, italic, code, strike.
• Slash-commands menu (/) — @tiptap/suggestion extension + React popup через createPortal. 10 опций с aliases (h1/title, h2, todo/task/check, hr/rule и т.п.). Keyboard: ↑/↓/Enter/Escape. Pure helper filterSlashOptions(query) экспортирован.
• InlineBubbleMenu — BubbleMenu из @tiptap/react/menus над selection. 4 mark-toggle кнопки (B/I/S/code), скрыт в codeBlock и при readOnly.
• Реактивный sync через useEffect: если родитель сменил block.content извне (другой пользователь/agent через intent), editor setContent без emitUpdate.

Roadmap (v0.3+)

| Фича | Статус | Dependency | |---|---|---| | Drag-handles & block-reorder | TODO | BlockNote или custom NodeView | | Indent / outdent | TODO | tree-aware editor (BlockNote) | | Image / bookmark blocks | TODO | @tiptap/extension-image + uploader contract | | Mention / cross-block link | research | @tiptap/extension-mention |

Reader-симметрия

Соответствует §23 axiom 5 манифеста IDF: voice / agent-API / document материализаторы читают block-tree из Φ напрямую через ontology+materializers, pixels-reader (этот пакет) делегирует rich-text визуализацию Tiptap'у. Renderer-bundle не растёт на размер ProseMirror — потребитель устанавливает пакет только если ему нужен этот UX.

License

MIT