@cyberyozh/text-editor 0.1.1

package/src/utils/custom-emoji.ts

@@ -0,0 +1,174 @@
+import TiptapCalloutInfo from "../icons/color/TiptapCalloutInfo";
+import TiptapCalloutSuccess from "../icons/color/TiptapCalloutSuccess";
+import TiptapCalloutWarning from "../icons/color/TiptapCalloutWarning";
+import TiptapCalloutError from "../icons/color/TiptapCalloutError";
+
+export const calloutIconComponents = {
+  "callout-info": TiptapCalloutInfo,
+  "callout-success": TiptapCalloutSuccess,
+  "callout-warning": TiptapCalloutWarning,
+  "callout-error": TiptapCalloutError,
+};
+
+// Favorite emojis list - these are regular emojis, not custom
+// Just the Unicode strings that should be suggested/shown first
+export const favoriteEmojis = [
+  "👋", // wave
+  "💡", // bulb
+  "🔥", // fire
+  "🔒", // lock
+  "🏆", // trophy
+  "🔑", // key
+  "👮", // police
+  "⭐", // star
+  "⛔", // no entry sign
+  "🧠", // brain
+  "⚠️", // warning
+  "📕", // book
+  "💎", // gem
+  "🚫", // no entry
+  "❗", // exclamation
+  "⚡", // lightning
+  "📝", // memo
+  "❤️", // heart
+];
+
+// Mapping from favorite custom emoji IDs to actual emoji characters
+export const favoriteEmojiIdMap: Record<string, string> = {
+  "fav-wave": "👋",
+  "fav-bulb": "💡",
+  "fav-fire": "🔥",
+  "fav-lock": "🔒",
+  "fav-trophy": "🏆",
+  "fav-key": "🔑",
+  "fav-police": "👮",
+  "fav-star": "⭐",
+  "fav-no-entry-sign": "⛔",
+  "fav-brain": "🧠",
+  "fav-warning": "⚠️",
+  "fav-book": "📕",
+  "fav-gem": "💎",
+  "fav-no-entry": "🚫",
+  "fav-exclamation": "❗",
+  "fav-lightning": "⚡",
+  "fav-memo": "📝",
+  "fav-heart": "❤️",
+};
+
+// Favorites - custom emojis category with specific emojis
+// These will appear in a "Custom" category group in the emoji picker
+export const favoriteCustomEmojis = [
+  {
+    id: "fav-wave",
+    names: ["wave", "hand", "hello", "hi"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f44b.png",
+  },
+  {
+    id: "fav-bulb",
+    names: ["bulb", "light", "idea"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f4a1.png",
+  },
+  {
+    id: "fav-fire",
+    names: ["fire", "flame", "hot"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f525.png",
+  },
+  {
+    id: "fav-lock",
+    names: ["lock", "locked", "secure"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f512.png",
+  },
+  {
+    id: "fav-trophy",
+    names: ["trophy", "award", "win"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f3c6.png",
+  },
+  {
+    id: "fav-key",
+    names: ["key", "password", "unlock"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f511.png",
+  },
+  {
+    id: "fav-police",
+    names: ["police", "officer", "cop"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f46e.png",
+  },
+  {
+    id: "fav-star",
+    names: ["star", "favorite"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/2b50.png",
+  },
+  {
+    id: "fav-no-entry-sign",
+    names: ["no entry sign", "prohibited", "banned"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/26d4.png",
+  },
+  {
+    id: "fav-brain",
+    names: ["brain", "think", "smart"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f9e0.png",
+  },
+  {
+    id: "fav-warning",
+    names: ["warning", "alert", "caution"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/26a0-fe0f.png",
+  },
+  {
+    id: "fav-book",
+    names: ["book", "read", "closed book"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f4d5.png",
+  },
+  {
+    id: "fav-gem",
+    names: ["gem", "diamond", "jewel"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f48e.png",
+  },
+  {
+    id: "fav-no-entry",
+    names: ["no entry", "stop", "do not enter"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f6ab.png",
+  },
+  {
+    id: "fav-exclamation",
+    names: ["exclamation", "important", "alert"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/2757.png",
+  },
+  {
+    id: "fav-lightning",
+    names: ["lightning", "bolt", "zap"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/26a1.png",
+  },
+  {
+    id: "fav-memo",
+    names: ["memo", "note", "pencil"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f4dd.png",
+  },
+  {
+    id: "fav-heart",
+    names: ["heart", "love", "red heart"],
+    imgUrl: "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/2764-fe0f.png",
+  },
+];
+
+export const calloutCustomEmojis = [
+  {
+    id: "callout-info",
+    names: ["info", "information", "callout info"],
+    imgUrl: `data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 20 20'%3E%3Cpath fill='%23FE9738' d='m11.654 11.196 3.51-2.75.549-4.789-4.06-2.234-1.647 2.264a2.79 2.79 0 0 1 1.531 2.28 2.8 2.8 0 0 1-1.85 2.84 3.96 3.96 0 0 0-2.624 3.728v.72c0 .937.76 1.697 1.696 1.697h2.482zm-4.895-3.32H4.277c-.937 0-1.697-.76-1.697-1.697q0-.432.06-.86C3.084 2.135 5.954-.196 9.172.015h2.482L9.888 1.797m1.353 14.796H8.759c-.937 0-1.696.76-1.696 1.696v.014c0 .938.76 1.697 1.696 1.697h2.18'/%3E%3Cpath fill='%23FFD15B' d='M11.241 14.951c-.937 0-1.697-.76-1.697-1.697v-.72a3.955 3.955 0 0 1 2.625-3.727 2.8 2.8 0 0 0 1.85-2.84A2.79 2.79 0 0 0 11.432 3.4a2.8 2.8 0 0 0-2.976 2.78 1.697 1.697 0 0 1-3.394 0q0-.434.06-.86C5.566 2.133 8.435-.198 11.654.014c3.055.2 5.527 2.653 5.75 5.706a6.2 6.2 0 0 1-4.104 6.286.56.56 0 0 0-.362.529v.72c0 .936-.76 1.696-1.697 1.696m0 5.05c-.937 0-1.697-.76-1.697-1.698v-.014a1.697 1.697 0 0 1 3.394 0v.014c0 .937-.76 1.697-1.697 1.697'/%3E%3Cpath fill='%23FFC344' d='M6.622 5.32q-.06.427-.06.86c0 .667.386 1.245.947 1.521A1.697 1.697 0 0 1 5.062 6.18q0-.432.06-.86C5.566 2.134 8.436-.197 11.654.014q.173.012.343.033C9.273.382 7.012 2.521 6.622 5.32m7.047 3.486a3.96 3.96 0 0 0-2.625 3.729v.72c0 .667.386 1.245.947 1.521a1.696 1.696 0 0 1-2.447-1.522v-.72a3.955 3.955 0 0 1 2.625-3.728 2.8 2.8 0 0 0 1.85-2.839 2.79 2.79 0 0 0-2.022-2.47 2.786 2.786 0 0 1 3.522 2.47 2.8 2.8 0 0 1-1.85 2.84m-1.678 11.02a1.696 1.696 0 0 1-2.447-1.522v-.015a1.697 1.697 0 0 1 2.448-1.523 1.7 1.7 0 0 0-.948 1.523v.014c0 .668.386 1.246.947 1.522'/%3E%3C/svg%3E`,
+  },
+  {
+    id: "callout-success",
+    names: ["success", "check", "done", "callout success"],
+    imgUrl: `data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 20 20'%3E%3Cg clip-path='url(%23a)'%3E%3Cpath fill='%2335495E' d='M1.972 18.004.06 7.138a2.4 2.4 0 0 1-.035-.317 2.47 2.47 0 0 1 2.073-2.493l3.693-.652-.1 14.328z'/%3E%3Cpath fill='%232C3E50' d='M16.186 17.528a.69.69 0 0 1-.548.517l-10.87 1.917a2.42 2.42 0 0 1-2.83-2.276 2.46 2.46 0 0 1 1.934-2.462l3.045.855h-.003l-2.742.487a1.037 1.037 0 0 0-.786 1.396 1.066 1.066 0 0 0 1.186.635l8.307-1.466z'/%3E%3Cpath fill='%23F9EAB0' d='m6.914 16.08-2.742.486a1.035 1.035 0 0 0-.786 1.396 1.066 1.066 0 0 0 1.186.635l8.307-1.466z'/%3E%3Cpath fill='%23E64C3C' d='M4.423 11.438 6.339.571a.695.695 0 0 1 .799-.559l10.785 1.902a2.47 2.47 0 0 1 2.074 2.495 3 3 0 0 1-.034.316l-1.917 10.867z'/%3E%3Cpath fill='%233F5C6C' d='M15.668 3.612a.4.4 0 0 1-.06-.005l-7.81-1.378a.345.345 0 0 1 .12-.677l7.81 1.375a.345.345 0 0 1-.06.685M14.01 5.069a.3.3 0 0 1-.06-.005l-5.094-.897a.345.345 0 0 1 .12-.68l5.094.897a.345.345 0 0 1-.06.685'/%3E%3Cpath fill='%23ECF0F1' d='m14.727 6.608-7.131-1.26a.345.345 0 0 0-.4.28l-.6 3.395a.345.345 0 0 0 .28.4l7.13 1.26a.345.345 0 0 0 .4-.28l.6-3.396a.345.345 0 0 0-.28-.4'/%3E%3Cpath fill='%23C03A2B' d='M19.997 4.407a2 2 0 0 1-.035.317L18.045 15.59l-2.659-.81 1.542-8.738.365-2.063.373-2.11.258.045a2.47 2.47 0 0 1 2.073 2.493'/%3E%3Cpath fill='%23802F34' d='M16.007 12.78 5.22 10.88a.69.69 0 0 0-.238 1.358l10.865 1.914a1.038 1.038 0 0 1 .783 1.4 1.06 1.06 0 0 1-1.183.63L4.624 14.277a.69.69 0 0 0-.241 1.359l10.869 1.913a2.416 2.416 0 0 0 2.83-2.272 2.474 2.474 0 0 0-2.075-2.496'/%3E%3Cpath fill='%23F9EAB0' d='M16.63 15.552a1.06 1.06 0 0 1-1.182.63L4.624 14.277l.359-2.038 10.865 1.914a1.04 1.04 0 0 1 .783 1.4'/%3E%3C/g%3E%3Cdefs%3E%3CclipPath id='a'%3E%3Cpath fill='%23fff' d='M0 0h20v20H0z'/%3E%3C/clipPath%3E%3C/defs%3E%3C/svg%3E`,
+  },
+  {
+    id: "callout-warning",
+    names: ["warning", "alert", "caution", "callout warning"],
+    imgUrl: `data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 20 20'%3E%3Cpath fill='%23FFF59D' fill-opacity='0.6' d='M1.667 9.167a8.333 8.333 0 1 0 16.666 0 8.333 8.333 0 0 0-16.666 0'/%3E%3Cpath fill='%23FBC02D' d='M15.417 9.167c0-3.209-2.75-5.75-6.042-5.375-2.5.291-4.5 2.291-4.75 4.791a5.27 5.27 0 0 0 1.917 4.709c.583.5.958 1.208.958 2v.125h5v-.042c0-.75.333-1.5.917-2 1.208-1 2-2.5 2-4.208'/%3E%3Cpath fill='%23FFF59D' d='m12.75 8.417-1.25-.834a.45.45 0 0 0-.458 0L10 8.25l-1-.667a.45.45 0 0 0-.458 0l-1.25.834c-.084.083-.167.166-.167.291s0 .25.083.334L8.792 11v4.417h.833v-4.584c0-.083-.042-.166-.083-.25L8.167 8.875l.625-.417 1 .667a.45.45 0 0 0 .458 0l1-.667.625.417-1.375 1.708a.6.6 0 0 0-.083.25v4.584h.833V11l1.583-1.958a.32.32 0 0 0 .084-.334c-.042-.125-.084-.25-.167-.291'/%3E%3Cpath fill='%235C6BC0' d='M8.75 18.334a1.25 1.25 0 1 0 2.5 0 1.25 1.25 0 0 0-2.5 0'/%3E%3Cpath fill='%239FA8DA' d='M10.833 18.75H9.167C8.25 18.75 7.5 18 7.5 17.083V15h5v2.083c0 .917-.75 1.667-1.667 1.667'/%3E%3Cpath fill='%235C6BC0' d='m12.5 17.083-4.833.667c.125.291.375.583.666.75l3.917-.542q.25-.375.25-.875m-5-.958v.833l5-.708v-.834z'/%3E%3C/svg%3E`,
+  },
+  {
+    id: "callout-error",
+    names: ["error", "danger", "fail", "callout error"],
+    imgUrl: `data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 20 20'%3E%3Cg clip-path='url(%23a)'%3E%3Cpath fill='%23E03757' d='M10 0C4.477 0 0 4.477 0 10s4.477 10 10 10 10-4.477 10-10S15.523 0 10 0'/%3E%3Cpath fill='%23F04760' d='M4.692 15.603c6.011 0 10.885-4.874 10.885-10.885a10.9 10.9 0 0 0-.525-3.35A9.95 9.95 0 0 0 10 0C4.477 0 0 4.477 0 10a9.95 9.95 0 0 0 1.394 5.094c1.066.338 2.179.51 3.298.509'/%3E%3Cpath fill='%23fff' d='M9.996 16.783a1.626 1.626 0 1 1 0-3.251 1.626 1.626 0 0 1 0 3.251m1.575-5.598c-.027.252-.14.486-.321.663a1.13 1.13 0 0 1-.674.315h-.008q-.239.027-.48.027a6 6 0 0 1-.575-.027h-.007a1.13 1.13 0 0 1-.674-.315 1.1 1.1 0 0 1-.321-.663c-.04-.366-.059-2.914-.059-3.481 0-.568.02-3.122.059-3.488.027-.252.14-.487.32-.665.183-.177.42-.289.675-.315h.007q.287-.029.576-.017.24-.012.479.017h.008c.254.027.492.14.674.319.18.177.294.412.321.664.04.366.059 2.92.059 3.488 0 .567-.02 3.113-.059 3.478'/%3E%3C/g%3E%3Cdefs%3E%3CclipPath id='a'%3E%3Cpath fill='%23fff' d='M0 0h20v20H0z'/%3E%3C/clipPath%3E%3C/defs%3E%3C/svg%3E`,
+  },
+];

package/src/utils/detect-video-hosting.ts

@@ -0,0 +1,106 @@
+export enum VideoHosting {
+  Youtube = 'youtube',
+  Vimeo = 'vimeo',
+  Rutube = 'rutube',
+  VK = 'vk',
+}
+
+export interface VideoInfo {
+  hosting: VideoHosting;
+  videoId: string;
+  embedUrl: string;
+}
+
+const VIDEO_PATTERNS = {
+  youtube: /(?:https?:\/\/)?(?:www\.)?(?:youtube\.com|youtu\.be)\/(?:watch\?v=|shorts\/)?([a-zA-Z0-9_-]{11})/,
+  youtubeEmbed: /(?:https?:\/\/)?(?:www\.)?(?:youtube\.com|youtube-nocookie\.com)\/embed\/([a-zA-Z0-9_-]{11})/,
+  vimeo: /(?:http|https)?:\/\/(?:www\.)?vimeo\.com\/(?:channels\/(?:\w+\/)?|groups\/(?:[^/]*)?\/videos\/)?(\d+)(?:|\/\?)/,
+  rutube: /^https:\/\/rutube\.ru\/video\/([\w-]+)/,
+  vk: /(?:https?:\/\/)?(?:vk\.com|vkvideo\.ru)\/video(-?\d+)_(\d+)/,
+} as const;
+
+/**
+ * Detects video hosting platform and extracts video information from URL
+ * Supports YouTube, Vimeo, Rutube, and VK video platforms
+ *
+ * Note: This function is synchronous as it only performs regex pattern matching.
+ * It can be safely used in both client and server-side rendering contexts.
+ */
+export const detectVideoHosting = (src: string): VideoInfo | null => {
+  if (!src || typeof src !== 'string') {
+    return null;
+  }
+
+  const cleanSrc = src.trim();
+  if (!cleanSrc) {
+    return null;
+  }
+
+  try {
+    // Check YouTube embed URLs (already in embed format from old editor)
+    const youTubeEmbedMatch = VIDEO_PATTERNS.youtubeEmbed.exec(cleanSrc);
+    if (youTubeEmbedMatch?.[1]) {
+      const videoId = youTubeEmbedMatch[1];
+      return {
+        hosting: VideoHosting.Youtube,
+        videoId,
+        embedUrl: `https://www.youtube-nocookie.com/embed/${videoId}`,
+      };
+    }
+
+    // Check YouTube regular URLs
+    const youTubeMatch = VIDEO_PATTERNS.youtube.exec(cleanSrc);
+    if (youTubeMatch?.[1]) {
+      const videoId = youTubeMatch[1];
+      return {
+        hosting: VideoHosting.Youtube,
+        videoId,
+        embedUrl: `https://www.youtube-nocookie.com/embed/${videoId}`,
+      };
+    }
+
+    // Check Vimeo
+    const vimeoMatch = VIDEO_PATTERNS.vimeo.exec(cleanSrc);
+    if (vimeoMatch?.[1]) {
+      const videoId = vimeoMatch[1];
+      // Extract hash parameter if present
+      const hashRegex = /\/(\d+)\/([a-fA-F0-9]+)/;
+      const hashMatch = hashRegex.exec(cleanSrc);
+      const hash = hashMatch?.[2] || null;
+      const hashParam = hash ? `?h=${hash}` : '';
+
+      return {
+        hosting: VideoHosting.Vimeo,
+        videoId,
+        embedUrl: `https://player.vimeo.com/video/${videoId}${hashParam}`,
+      };
+    }
+
+    // Check Rutube
+    const ruTubeMatch = VIDEO_PATTERNS.rutube.exec(cleanSrc);
+    if (ruTubeMatch?.[1]) {
+      const videoId = ruTubeMatch[1];
+      return {
+        hosting: VideoHosting.Rutube,
+        videoId,
+        embedUrl: `https://rutube.ru/play/embed/${videoId}`,
+      };
+    }
+
+    // Check VK
+    const vkMatch = VIDEO_PATTERNS.vk.exec(cleanSrc);
+    if (vkMatch?.[1] && vkMatch?.[2]) {
+      const videoId = `${vkMatch[1]}_${vkMatch[2]}`;
+      return {
+        hosting: VideoHosting.VK,
+        videoId,
+        embedUrl: `https://vk.com/video_ext.php?oid=${vkMatch[1]}&id=${vkMatch[2]}`,
+      };
+    }
+  } catch {
+    // Silent failure for unsupported video URLs
+    // Error details available in development via devtools
+  }
+
+  return null;
+};

package/src/utils/get-shared-extensions.ts

@@ -0,0 +1,45 @@
+import StarterKit from "@tiptap/starter-kit";
+import { Details, DetailsContent, DetailsSummary } from "@tiptap/extension-details";
+import Highlight from "@tiptap/extension-highlight";
+import { LinkExtension, BaseMythReality, BaseMythRealityBlock } from "@/extensions/base";
+import Subscript from "@tiptap/extension-subscript";
+import Superscript from "@tiptap/extension-superscript";
+import TextAlign from "@tiptap/extension-text-align";
+import { TextStyleKit } from "@tiptap/extension-text-style";
+import { LegacyInlineLatexSE } from "@/extensions/base/compatibility";
+
+/**
+ * Get all Tiptap extensions for editing and rendering without ReactNodeViewRenderer for Editor
+ * Can be used for both static render and editor
+ */
+export function getSharedExtensions() {
+  return [
+    StarterKit.configure({
+      codeBlock: false,
+      link: false,
+    }),
+    Highlight.configure({ multicolor: true }),
+    LinkExtension,
+    Superscript,
+    Subscript,
+    TextAlign.configure({
+      types: ["heading", "paragraph"],
+    }),
+    TextStyleKit.configure({
+      color: {
+        types: ["textStyle"],
+      },
+    }),
+    Details.configure({
+      persist: true,
+      HTMLAttributes: {
+        class: "details",
+      },
+    }),
+    DetailsSummary,
+    DetailsContent,
+    BaseMythReality,
+    BaseMythRealityBlock,
+    LegacyInlineLatexSE,
+  ];
+}

package/src/utils/get-translations.ts

@@ -0,0 +1,25 @@
+/**
+ * Tiptap Editor Translations
+ */
+
+import ruTranslations from "../translations/ru.json";
+import enTranslations from "../translations/en.json";
+
+export type TiptapTranslations = typeof ruTranslations;
+
+export type SupportedLanguage = "ru" | "en";
+
+const translations: Record<SupportedLanguage, TiptapTranslations> = {
+  ru: ruTranslations,
+  en: enTranslations,
+};
+
+/**
+ * Get translations for specified language
+ * @param lang - ISO 2-letter language code ('ru' or 'en')
+ * @returns Translation object for the specified language
+ * @default 'ru' - Falls back to Russian if language not found
+ */
+export function getTranslations(lang: SupportedLanguage): TiptapTranslations {
+  return translations[lang];
+}

package/src/utils/handle-exit-node.ts

@@ -0,0 +1,61 @@
+import { Editor } from "@tiptap/core";
+import { TextSelection } from "@tiptap/pm/state";
+
+/**
+ * Handles exiting a node (like callout) when pressing Enter on an empty paragraph
+ * @param editor - The Tiptap editor instance
+ * @param nodeName - The name of the node type to exit from (e.g., 'callout')
+ * @returns true if the exit was handled, false otherwise
+ */
+export function handleExitNode(editor: Editor, nodeName: string): boolean {
+  const { view, schema } = editor;
+  const { state } = view;
+  const { selection } = state;
+
+  const $pos = selection.$from;
+  const currentNode = $pos.node();
+
+  let depth = $pos.depth;
+  let isInsideTargetNode = false;
+  let targetNodeDepth = 0;
+  while (depth > 0) {
+    const parentNode = $pos.node(depth);
+    if (parentNode.type.name === nodeName) {
+      isInsideTargetNode = true;
+      targetNodeDepth = depth;
+      break;
+    }
+    depth--;
+  }
+
+  const isCurrentNodeEmptyParagraph =
+    currentNode.type.name === "paragraph" && currentNode.content.size === 0;
+
+  if (!isInsideTargetNode || !isCurrentNodeEmptyParagraph) {
+    return false;
+  }
+
+  const { tr } = state;
+  const posAfterTargetNode = $pos.after(targetNodeDepth);
+
+  const targetNode = $pos.node(targetNodeDepth);
+  let newPosAfterTargetNode = posAfterTargetNode;
+
+  if (targetNode.childCount > 1) {
+    const emptyParagraphStart = $pos.before();
+    const emptyParagraphEnd = $pos.after();
+    const deletionLength = emptyParagraphEnd - emptyParagraphStart;
+
+    tr.delete(emptyParagraphStart, emptyParagraphEnd);
+    newPosAfterTargetNode = posAfterTargetNode - deletionLength;
+  }
+
+  const paragraphNode = schema.nodes.paragraph.createAndFill();
+  if (!paragraphNode) return false;
+
+  tr.insert(newPosAfterTargetNode, paragraphNode);
+  tr.setSelection(TextSelection.create(tr.doc, newPosAfterTargetNode + 1));
+
+  view.dispatch(tr);
+  return true;
+}

package/src/utils/image-src-resolver.ts

@@ -0,0 +1,74 @@
+/**
+ * Utility for resolving image sources from fileId or direct src
+ */
+
+export interface ImageSrcResolverOptions {
+  /**
+   * Optional function to resolve fileId to URL
+   * If not provided, fileId will be used as-is or src will be used
+   */
+  getImageById?: (fileId: string) => string | null;
+}
+
+export interface ImageAttributes {
+  fileId?: string | null;
+  src?: string | null;
+}
+
+/**
+ * Resolves image src with clear priority:
+ * 1. If fileId exists AND getImageById provided → resolve via getImageById(fileId)
+ * 2. If no fileId OR no getImageById → use src/fileUrl directly
+ * 3. If both missing → return empty string (error state)
+ *
+ * Clear separation:
+ * - fileId workflow: fileId + getImageById() → resolved URL
+ * - Direct URL workflow: fileUrl/src → used as-is
+ */
+export function resolveImageSrc(attrs: ImageAttributes, options?: ImageSrcResolverOptions): string {
+  const { fileId, src } = attrs;
+  const { getImageById } = options || {};
+
+  // Path 1: FileId workflow with resolution function
+  if (fileId && getImageById) {
+    const resolvedSrc = getImageById(fileId);
+    if (resolvedSrc) {
+      return resolvedSrc;
+    }
+    // If resolution fails, this is an error - return empty to show broken image
+    console.warn(`Failed to resolve fileId: ${fileId}`);
+    return "";
+  }
+
+  // Path 2: Direct URL workflow (fileUrl/src)
+  if (src) {
+    return src;
+  }
+
+  // Path 3: FileId without getImageById (legacy or misconfigured)
+  if (fileId) {
+    console.warn("fileId provided but no getImageById function - cannot resolve image");
+    return "";
+  }
+
+  // Error state: no way to display image
+  return "";
+}
+
+/**
+ * Normalizes attributes for storage
+ * Prefers fileId over src if both are provided
+ */
+export function normalizeImageAttributes(attrs: ImageAttributes): ImageAttributes {
+  if (attrs.fileId) {
+    // If fileId exists, it's the source of truth
+    return {
+      fileId: attrs.fileId,
+    };
+  }
+
+  // Otherwise use src
+  return {
+    src: attrs.src,
+  };
+}

package/src/utils/index.ts

@@ -0,0 +1,2 @@
+export { copyToClipboard } from './copy-to-clipboard';
+export { pluralize } from './pluralize';

package/src/utils/migrate-legacy-callouts.ts

@@ -0,0 +1,59 @@
+import { Editor } from "@tiptap/core";
+
+export type CalloutType = "info" | "warning" | "success" | "error";
+
+const legacyTypeMap: Record<string, CalloutType> = {
+  question: "info",
+  idea: "warning",
+  info: "success",
+  error: "error",
+};
+
+export function migrateLegacyCallouts(editor: Editor) {
+  const { doc, schema } = editor.state;
+  const calloutsToMigrate: Array<{ node: any; pos: number }> = [];
+
+  doc.descendants((node, pos) => {
+    if (node.type.name === "callout" && node.attrs.calloutType) {
+      calloutsToMigrate.push({ node, pos });
+    }
+  });
+
+  if (calloutsToMigrate.length === 0) return;
+
+  const tr = editor.state.tr;
+  calloutsToMigrate.sort((a, b) => b.pos - a.pos);
+
+  for (const { node, pos } of calloutsToMigrate) {
+    const oldType = node.attrs.calloutType;
+    const newType = legacyTypeMap[oldType] || oldType;
+    const hasInlineContent = node.content.size > 0 && !node.firstChild?.isBlock;
+
+    if (hasInlineContent) {
+      const paragraph = schema.nodes.paragraph?.create(null, node.content);
+      const newContent = paragraph ? [paragraph] : [];
+
+      tr.replaceRangeWith(
+        pos,
+        pos + node.nodeSize,
+        schema.nodes.callout.create(
+          {
+            type: newType,
+            calloutType: null,
+            callout: null,
+          },
+          newContent
+        )
+      );
+    } else {
+      tr.setNodeMarkup(pos, undefined, {
+        ...node.attrs,
+        type: newType,
+        calloutType: null,
+        callout: null,
+      });
+    }
+  }
+
+  editor.view.dispatch(tr);
+}

package/src/utils/pluralize.ts

@@ -0,0 +1,38 @@
+/**
+ * Returns the correct plural form for Russian language based on the number
+ *
+ * @param count - The number to determine plural form
+ * @param forms - Array of 3 forms: [one, few, many]
+ *   - one: for 1, 21, 31, etc. (символ)
+ *   - few: for 2-4, 22-24, etc. (символа)
+ *   - many: for 0, 5-20, 25-30, etc. (символов)
+ *
+ * @example
+ * pluralize(1, ['символ', 'символа', 'символов']) // символ
+ * pluralize(2, ['символ', 'символа', 'символов']) // символа
+ * pluralize(5, ['символ', 'символа', 'символов']) // символов
+ * pluralize(21, ['символ', 'символа', 'символов']) // символ
+ */
+export function pluralize(count: number, forms: readonly [string, string, string]): string {
+  const absCount = Math.abs(count);
+  const lastDigit = absCount % 10;
+  const lastTwoDigits = absCount % 100;
+
+  // Special case for 11-14 (always use 'many' form)
+  if (lastTwoDigits >= 11 && lastTwoDigits <= 14) {
+    return forms[2];
+  }
+
+  // For numbers ending in 1 (except 11)
+  if (lastDigit === 1) {
+    return forms[0];
+  }
+
+  // For numbers ending in 2-4 (except 12-14)
+  if (lastDigit >= 2 && lastDigit <= 4) {
+    return forms[1];
+  }
+
+  // For numbers ending in 0, 5-9, and 11-14
+  return forms[2];
+}