@wakastellar/ui 3.3.3 → 3.5.0

package/src/components/editor/index.ts

@@ -0,0 +1,279 @@
+/**
+ * WakaEditor — Plate.js rich text editor components for @wakastellar/ui
+ *
+ * Usage:
+ * ```ts
+ * import { WakaEditor } from "@wakastellar/ui/editor"
+ * import { WakaAIWriter } from "@wakastellar/ui/editor"
+ * import { WakaDocumentEditor } from "@wakastellar/ui/editor"
+ * ```
+ *
+ * Core peer dependencies (always required):
+ * - platejs (>=52.0.0)
+ * - @platejs/basic-nodes (>=52.0.0)
+ * - @platejs/table (>=52.0.0)
+ * - @platejs/layout (>=52.0.0)
+ * - @platejs/callout (>=52.0.0)
+ *
+ * Optional peer dependencies (install based on components/features used):
+ * - @platejs/link        — links
+ * - @platejs/media       — images, videos
+ * - @platejs/mention     — @mentions (WakaMentionEditor)
+ * - @platejs/dnd         — drag & drop (WakaDnDEditor)
+ * - @platejs/toc         — table of contents
+ * - @platejs/indent      — indentation
+ * - @platejs/markdown    — markdown import/export (WakaMarkdownEditor)
+ * - @platejs/selection   — block selection
+ * - @platejs/ai          — AI features (WakaAIWriter)
+ * - @platejs/combobox    — slash commands (WakaSlashMenu)
+ * - @platejs/floating    — floating toolbar (WakaFloatingToolbar)
+ * - @platejs/diff        — document diff (WakaDiffViewer)
+ * - @platejs/emoji       — emoji picker
+ * - @platejs/resizable   — resizable elements
+ * - @platejs/yjs         — collaborative editing (WakaCollaborativeEditor)
+ */
+
+// ─── Base editor ─────────────────────────────────────────────────────────────
+
+export { WakaEditor } from "./waka-editor"
+export type { WakaEditorProps, SlateNode } from "./waka-editor"
+
+// ─── Fixed toolbar ───────────────────────────────────────────────────────────
+
+export { WakaEditorToolbar, DEFAULT_TOOLBAR_GROUPS } from "./waka-editor-toolbar"
+export type {
+  WakaEditorToolbarProps,
+  ToolbarAction,
+  ToolbarGroup,
+} from "./waka-editor-toolbar"
+
+// ─── Floating toolbar ────────────────────────────────────────────────────────
+
+export { WakaFloatingToolbar, DEFAULT_FLOATING_BUTTONS } from "./waka-floating-toolbar"
+export type {
+  WakaFloatingToolbarProps,
+  FloatingToolbarButton,
+} from "./waka-floating-toolbar"
+
+// ─── Slash menu ──────────────────────────────────────────────────────────────
+
+export { WakaSlashMenu, DEFAULT_SLASH_COMMANDS, createSlashCommandPlugins } from "./waka-slash-menu"
+export type {
+  WakaSlashMenuProps,
+  SlashCommand,
+} from "./waka-slash-menu"
+
+// ─── AI Writer ───────────────────────────────────────────────────────────────
+
+export { WakaAIWriter, DEFAULT_AI_ACTIONS } from "./waka-ai-writer"
+export type {
+  WakaAIWriterProps,
+  AIAction,
+} from "./waka-ai-writer"
+
+// ─── Document editor ─────────────────────────────────────────────────────────
+
+export { WakaDocumentEditor } from "./waka-document-editor"
+export type {
+  WakaDocumentEditorProps,
+  TocEntry,
+} from "./waka-document-editor"
+
+// ─── Markdown editor ─────────────────────────────────────────────────────────
+
+export { WakaMarkdownEditor } from "./waka-markdown-editor"
+export type {
+  WakaMarkdownEditorProps,
+  MarkdownEditorMode,
+} from "./waka-markdown-editor"
+
+// ─── Spec editor ─────────────────────────────────────────────────────────────
+
+export { WakaSpecEditor, DEFAULT_SPEC_TEMPLATES } from "./waka-spec-editor"
+export type {
+  WakaSpecEditorProps,
+  SpecBlockTemplate,
+} from "./waka-spec-editor"
+
+// ─── DnD editor ──────────────────────────────────────────────────────────────
+
+export { WakaDnDEditor } from "./waka-dnd-editor"
+export type { WakaDnDEditorProps } from "./waka-dnd-editor"
+
+// ─── Collaborative editor ────────────────────────────────────────────────────
+
+export { WakaCollaborativeEditor } from "./waka-collaborative-editor"
+export type {
+  WakaCollaborativeEditorProps,
+  CollaborationUser,
+  CollaborationProviderConfig,
+} from "./waka-collaborative-editor"
+
+// ─── Diff viewer ─────────────────────────────────────────────────────────────
+
+export { WakaDiffViewer } from "./waka-diff-viewer"
+export type {
+  WakaDiffViewerProps,
+  DiffStats,
+} from "./waka-diff-viewer"
+
+// ─── Mention editor ──────────────────────────────────────────────────────────
+
+export { WakaMentionEditor, MentionSuggestions } from "./waka-mention-editor"
+export type {
+  WakaMentionEditorProps,
+  MentionableUser,
+  InsertedMention,
+} from "./waka-mention-editor"
+
+// ─── Elements (for custom rendering or extension) ────────────────────────────
+
+export {
+  TableElement,
+  TableRowElement,
+  TableCellElement,
+  TableCellHeaderElement,
+  ColumnGroupElement,
+  ColumnElement,
+  CalloutElement,
+  H1Element,
+  H2Element,
+  H3Element,
+  H4Element,
+  H5Element,
+  H6Element,
+  BlockquoteElement,
+  ParagraphElement,
+  LinkElement,
+  MentionElement,
+  SeparatorElement,
+} from "./waka-editor-elements"
+export type { PlateElementProps } from "./waka-editor-elements"
+
+// ─── Leaves (for custom rendering or extension) ──────────────────────────────
+
+export {
+  BoldLeaf,
+  ItalicLeaf,
+  UnderlineLeaf,
+  StrikethroughLeaf,
+  CodeLeaf,
+  HighlightLeaf,
+  SuperscriptLeaf,
+  SubscriptLeaf,
+} from "./waka-editor-leaves"
+export type { PlateLeafProps } from "./waka-editor-leaves"
+
+// ─── Plugin utilities ────────────────────────────────────────────────────────
+
+export {
+  loadCorePlugins,
+  loadLinkPlugin,
+  loadMediaPlugins,
+  loadMentionPlugins,
+  loadDndPlugin,
+  loadTocPlugin,
+  loadIndentPlugin,
+  loadMarkdownPlugin,
+  loadSelectionPlugin,
+  loadAIPlugins,
+  loadEmojiPlugin,
+  loadFloatingPlugin,
+  loadDiffPlugin,
+  loadComboboxPlugins,
+  getPresetLoaders,
+} from "./waka-editor-plugins"
+export type { WakaEditorPreset } from "./waka-editor-plugins"
+
+// ─── Custom WakaStart Blocks ────────────────────────────────────────────────
+
+export {
+  // Block components
+  WakaUserStoryBlock,
+  WakaAcceptanceCriteriaBlock,
+  WakaApiEndpointBlock,
+  WakaDiagramBlock,
+  WakaAiAssistBlock,
+  WakaVersionDiffBlock,
+  WakaEmbedBlock,
+  WakaCodePlaygroundBlock,
+  WakaCommentThreadBlock,
+  WakaSlashMenuBlock,
+  // Node factories
+  createUserStoryNodes,
+  createAcceptanceCriteriaNodes,
+  createApiEndpointNodes,
+  createDiagramNodes,
+  createAiAssistNodes,
+  createVersionDiffNodes,
+  createEmbedNodes,
+  createCodePlaygroundNodes,
+  createCommentThreadNodes,
+  // Plugin factories
+  createUserStoryPlugin,
+  createAcceptanceCriteriaPlugin,
+  createApiEndpointPlugin,
+  createDiagramPlugin,
+  createAiAssistPlugin,
+  createVersionDiffPlugin,
+  createEmbedPlugin,
+  createCodePlaygroundPlugin,
+  createCommentThreadPlugin,
+  // Slash menu helpers
+  getAllWakaSlashCommands,
+  createWakaSlashPlugins,
+  WAKA_BLOCK_COMMANDS,
+  // Load all at once
+  loadAllWakaBlockPlugins,
+  // Block type constants
+  USER_STORY_BLOCK_TYPE,
+  ACCEPTANCE_CRITERIA_BLOCK_TYPE,
+  API_ENDPOINT_BLOCK_TYPE,
+  DIAGRAM_BLOCK_TYPE,
+  AI_ASSIST_BLOCK_TYPE,
+  VERSION_DIFF_BLOCK_TYPE,
+  EMBED_BLOCK_TYPE,
+  CODE_PLAYGROUND_BLOCK_TYPE,
+  COMMENT_THREAD_BLOCK_TYPE,
+  // URL utilities
+  detectEmbedProvider,
+  resolveEmbedUrl,
+} from "./blocks"
+
+export type {
+  // Block element types
+  UserStoryElement,
+  AcceptanceCriterion,
+  AcceptanceCriteriaElement,
+  HttpMethod,
+  ApiParam,
+  ApiResponse,
+  ApiEndpointElement,
+  DiagramSyntax,
+  DiagramElement,
+  AiAssistStatus,
+  AiAssistElement,
+  DiffLine,
+  DiffHunk,
+  VersionDiffElement,
+  EmbedProvider,
+  EmbedElement,
+  PlaygroundLanguage,
+  ExecutionStatus,
+  CodePlaygroundElement,
+  ThreadComment,
+  ThreadStatus,
+  CommentThreadElement,
+  // Block props types
+  WakaUserStoryBlockProps,
+  WakaAcceptanceCriteriaBlockProps,
+  WakaApiEndpointBlockProps,
+  WakaDiagramBlockProps,
+  WakaAiAssistBlockProps,
+  WakaVersionDiffBlockProps,
+  WakaEmbedBlockProps,
+  WakaCodePlaygroundBlockProps,
+  WakaCommentThreadBlockProps,
+  WakaSlashBlockCommand,
+  WakaSlashMenuBlockProps,
+} from "./blocks"