@jackuait/blok 0.8.3-beta.4 → 0.9.0

package/src/components/i18n/locales/my/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "မျဉ်းသား",
   "toolNames.strikethrough": "ဖျက်မျဉ်း",
   "toolNames.callout": "မှတ်သားချက်",
+  "toolNames.divider": "ပိုင်းခြားမျဉ်း",
   "tools.callout.placeholder": "မှတ်သားချက်",
   "tools.callout.addEmoji": "အီမိုဂျီထည့်",
   "tools.callout.editIcon": "အိုင်ကွန် တည်းဖြတ်",

package/src/components/i18n/locales/ne/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "रेखांकन",
   "toolNames.strikethrough": "स्ट्राइकथ्रु",
   "toolNames.callout": "कलआउट",
+  "toolNames.divider": "विभाजक",
   "tools.callout.placeholder": "कलआउट",
   "tools.callout.addEmoji": "इमोजी थप्नुहोस्",
   "tools.callout.editIcon": "आइकन सम्पादन गर्नुहोस्",

package/src/components/i18n/locales/nl/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Onderstrepen",
   "toolNames.strikethrough": "Doorhalen",
   "toolNames.callout": "Toelichting",
+  "toolNames.divider": "Scheidingslijn",
   "tools.callout.placeholder": "Toelichting",
   "tools.callout.addEmoji": "Emoji toevoegen",
   "tools.callout.editIcon": "Pictogram bewerken",

package/src/components/i18n/locales/no/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Understreking",
   "toolNames.strikethrough": "Gjennomstreking",
   "toolNames.callout": "Merknad",
+  "toolNames.divider": "Skillelinje",
   "tools.callout.placeholder": "Merknad",
   "tools.callout.addEmoji": "Legg til emoji",
   "tools.callout.editIcon": "Rediger ikon",

package/src/components/i18n/locales/pa/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "ਅੰਡਰਲਾਈਨ",
   "toolNames.strikethrough": "ਸਟ੍ਰਾਈਕਥਰੂ",
   "toolNames.callout": "ਕਾਲਆਊਟ",
+  "toolNames.divider": "ਵੰਡਣਹਾਰਾ",
   "tools.callout.placeholder": "ਕਾਲਆਊਟ",
   "tools.callout.addEmoji": "ਇਮੋਜੀ ਜੋੜੋ",
   "tools.callout.editIcon": "ਆਈਕਨ ਸੰਪਾਦਿਤ ਕਰੋ",

package/src/components/i18n/locales/pl/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Podkreślenie",
   "toolNames.strikethrough": "Przekreślenie",
   "toolNames.callout": "Objaśnienie",
+  "toolNames.divider": "Separator",
   "tools.callout.placeholder": "Objaśnienie",
   "tools.callout.addEmoji": "Dodaj emoji",
   "tools.callout.editIcon": "Edytuj ikonę",

package/src/components/i18n/locales/ps/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "کرښنلیک",
   "toolNames.strikethrough": "پرېکړلیک",
   "toolNames.callout": "یادونه",
+  "toolNames.divider": "بېلونکی",
   "tools.callout.placeholder": "یادونه",
   "tools.callout.addEmoji": "ایموجي اضافه کړئ",
   "tools.callout.editIcon": "آیکون سمون",

package/src/components/i18n/locales/pt/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Sublinhado",
   "toolNames.strikethrough": "Tachado",
   "toolNames.callout": "Destaque",
+  "toolNames.divider": "Divisor",
   "tools.callout.placeholder": "Destaque",
   "tools.callout.addEmoji": "Adicionar emoji",
   "tools.callout.editIcon": "Editar ícone",

package/src/components/i18n/locales/ro/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Subliniat",
   "toolNames.strikethrough": "Tăiat",
   "toolNames.callout": "Evidențiere",
+  "toolNames.divider": "Separator",
   "tools.callout.placeholder": "Evidențiere",
   "tools.callout.addEmoji": "Adaugă emoji",
   "tools.callout.editIcon": "Editează pictograma",

package/src/components/i18n/locales/ru/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Подчёркнутый",
   "toolNames.strikethrough": "Зачёркнутый",
   "toolNames.callout": "Выноска",
+  "toolNames.divider": "Разделитель",
   "tools.callout.placeholder": "Выноска",
   "tools.callout.addEmoji": "Добавить эмодзи",
   "tools.callout.editIcon": "Изменить иконку",

package/src/components/i18n/locales/sd/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "هيٺ لڪير",
   "toolNames.strikethrough": "وچ لڪير",
   "toolNames.callout": "نوٽ",
+  "toolNames.divider": "ورهائيندڙ",
   "tools.callout.placeholder": "نوٽ",
   "tools.callout.addEmoji": "ايموجي شامل ڪريو",
   "tools.callout.editIcon": "آئیکن تبديل ڪريو",

package/src/components/i18n/locales/si/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "යටිරේඛනය",
   "toolNames.strikethrough": "ඉරිතැලීම",
   "toolNames.callout": "කෝලවුට්",
+  "toolNames.divider": "බෙදුම්කරු",
   "tools.callout.placeholder": "කෝලවුට්",
   "tools.callout.addEmoji": "ඉමෝජි එක් කරන්න",
   "tools.callout.editIcon": "නිරූපකය සංස්කරණය කරන්න",

package/src/components/i18n/locales/sk/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Podčiarknuté",
   "toolNames.strikethrough": "Prečiarknuté",
   "toolNames.callout": "Popisok",
+  "toolNames.divider": "Oddeľovač",
   "tools.callout.placeholder": "Popisok",
   "tools.callout.addEmoji": "Pridať emoji",
   "tools.callout.editIcon": "Upraviť ikonu",

package/src/components/i18n/locales/sl/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Podčrtano",
   "toolNames.strikethrough": "Prečrtano",
   "toolNames.callout": "Opomba",
+  "toolNames.divider": "Ločilnik",
   "tools.callout.placeholder": "Opomba",
   "tools.callout.addEmoji": "Dodaj emoji",
   "tools.callout.editIcon": "Uredi ikono",

package/src/components/i18n/locales/sq/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Nënvizim",
   "toolNames.strikethrough": "Vizë përmes",
   "toolNames.callout": "Theksim",
+  "toolNames.divider": "Ndarës",
   "tools.callout.placeholder": "Theksim",
   "tools.callout.addEmoji": "Shto emoji",
   "tools.callout.editIcon": "Ndrysho ikonën",

package/src/components/i18n/locales/sr/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Подвучено",
   "toolNames.strikethrough": "Прецртано",
   "toolNames.callout": "Истакнуто",
+  "toolNames.divider": "Раздвајач",
   "tools.callout.placeholder": "Истакнуто",
   "tools.callout.addEmoji": "Додај емоџи",
   "tools.callout.editIcon": "Уреди икону",

package/src/components/i18n/locales/sv/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Understrykning",
   "toolNames.strikethrough": "Genomstrykning",
   "toolNames.callout": "Notering",
+  "toolNames.divider": "Avdelare",
   "tools.callout.placeholder": "Notering",
   "tools.callout.addEmoji": "Lägg till emoji",
   "tools.callout.editIcon": "Redigera ikon",

package/src/components/i18n/locales/sw/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Mstari chini",
   "toolNames.strikethrough": "Mstari katikati",
   "toolNames.callout": "Angazio",
+  "toolNames.divider": "Kigawanyo",
   "tools.callout.placeholder": "Angazio",
   "tools.callout.addEmoji": "Ongeza emoji",
   "tools.callout.editIcon": "Hariri ikoni",

package/src/components/i18n/locales/ta/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "அடிக்கோடு",
   "toolNames.strikethrough": "நடுக்கோடு",
   "toolNames.callout": "குறிப்புப்பெட்டி",
+  "toolNames.divider": "பிரிப்பான்",
   "tools.callout.placeholder": "குறிப்புப்பெட்டி",
   "tools.callout.addEmoji": "இமோஜி சேர்",
   "tools.callout.editIcon": "ஐகானைத் திருத்து",

package/src/components/i18n/locales/te/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "అండర్‌లైన్",
   "toolNames.strikethrough": "స్ట్రైక్‌త్రూ",
   "toolNames.callout": "కాలౌట్",
+  "toolNames.divider": "విభజకం",
   "tools.callout.placeholder": "కాలౌట్",
   "tools.callout.addEmoji": "ఇమోజీ జోడించండి",
   "tools.callout.editIcon": "చిహ్నాన్ని సవరించండి",

package/src/components/i18n/locales/th/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "ขีดเส้นใต้",
   "toolNames.strikethrough": "ขีดทับ",
   "toolNames.callout": "กล่องเน้น",
+  "toolNames.divider": "เส้นคั่น",
   "tools.callout.placeholder": "กล่องเน้น",
   "tools.callout.addEmoji": "เพิ่มอีโมจิ",
   "tools.callout.editIcon": "แก้ไขไอคอน",

package/src/components/i18n/locales/tr/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Altı çizili",
   "toolNames.strikethrough": "Üstü çizili",
   "toolNames.callout": "Bilgi kutusu",
+  "toolNames.divider": "Ayırıcı",
   "tools.callout.placeholder": "Bilgi kutusu",
   "tools.callout.addEmoji": "Emoji ekle",
   "tools.callout.editIcon": "Simgeyi düzenle",

package/src/components/i18n/locales/ug/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "ئاستى سىزىق",
   "toolNames.strikethrough": "ئۆچۈرۈش سىزىقى",
   "toolNames.callout": "ئەسكەرتىش",
+  "toolNames.divider": "بۆلگۈچ",
   "tools.callout.placeholder": "ئەسكەرتىش",
   "tools.callout.addEmoji": "ئېموجى قوشۇش",
   "tools.callout.editIcon": "سىنبەلگە تەھرىرلەش",

package/src/components/i18n/locales/uk/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Підкреслений",
   "toolNames.strikethrough": "Закреслений",
   "toolNames.callout": "Виноска",
+  "toolNames.divider": "Роздільник",
   "tools.callout.placeholder": "Виноска",
   "tools.callout.addEmoji": "Додати емодзі",
   "tools.callout.editIcon": "Редагувати іконку",

package/src/components/i18n/locales/ur/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "خط کشیدہ",
   "toolNames.strikethrough": "کٹا ہوا",
   "toolNames.callout": "نوٹ",
+  "toolNames.divider": "تقسیم کار",
   "tools.callout.placeholder": "نوٹ",
   "tools.callout.addEmoji": "ایموجی شامل کریں",
   "tools.callout.editIcon": "آئیکن ترمیم کریں",

package/src/components/i18n/locales/vi/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "Gạch chân",
   "toolNames.strikethrough": "Gạch ngang",
   "toolNames.callout": "Chú thích",
+  "toolNames.divider": "Đường phân cách",
   "tools.callout.placeholder": "Chú thích",
   "tools.callout.addEmoji": "Thêm biểu tượng",
   "tools.callout.editIcon": "Chỉnh sửa biểu tượng",

package/src/components/i18n/locales/yi/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "אונטערשטרייכן",
   "toolNames.strikethrough": "דורכשטרייכן",
   "toolNames.callout": "באַמערקונג",
+  "toolNames.divider": "טיילער",
   "tools.callout.placeholder": "באַמערקונג",
   "tools.callout.addEmoji": "צולייגן עמאָדזשי",
   "tools.callout.editIcon": "רעדאַקטירן בילדל",

package/src/components/i18n/locales/zh/messages.json

@@ -87,6 +87,7 @@
   "toolNames.underline": "下划线",
   "toolNames.strikethrough": "删除线",
   "toolNames.callout": "标注",
+  "toolNames.divider": "分隔线",
   "tools.callout.placeholder": "标注",
   "tools.callout.addEmoji": "添加表情",
   "tools.callout.editIcon": "编辑图标",

package/src/components/icons/index.ts

@@ -441,6 +441,13 @@ export const IconPaintRoller = `<svg xmlns="http://www.w3.org/2000/svg" width="2
   <rect x="8" y="14" width="3" height="3.5" rx="0.75" stroke="currentColor" stroke-width="1.25"/>
 </svg>`;
 
+// Divider icon
+export const IconDivider = `
+<svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M4 10h12" stroke="currentColor" stroke-width="1.25" stroke-linecap="round"/>
+</svg>
+`;
+
 // Emoji Picker Category Icons
 
 // Star icon (Callout category)

package/src/components/modules/blockEvents/composers/markdownShortcuts.ts

@@ -1,5 +1,5 @@
 import type { Block } from '../../../block';
-import { HEADER_PATTERN, CHECKLIST_PATTERN, UNORDERED_LIST_PATTERN, ORDERED_LIST_PATTERN, TOGGLE_HEADER_PATTERN, TOGGLE_PATTERN, HEADER_TOOL_NAME, LIST_TOOL_NAME, TOGGLE_TOOL_NAME } from '../constants';
+import { HEADER_PATTERN, CHECKLIST_PATTERN, UNORDERED_LIST_PATTERN, ORDERED_LIST_PATTERN, TOGGLE_HEADER_PATTERN, TOGGLE_PATTERN, HEADER_TOOL_NAME, LIST_TOOL_NAME, TOGGLE_TOOL_NAME, DIVIDER_TOOL_NAME, DIVIDER_PATTERN } from '../constants';
 
 import { BlockEventComposer } from './__base';
 
@@ -20,7 +20,18 @@ export class MarkdownShortcuts extends BlockEventComposer {
    * @returns true if a shortcut was triggered and handled
    */
   public handleInput(event: InputEvent): boolean {
-    if (event.inputType !== 'insertText' || event.data !== ' ') {
+    if (event.inputType !== 'insertText') {
+      return false;
+    }
+
+    /**
+     * Divider shortcut triggers on the third hyphen — no space needed.
+     */
+    if (event.data === '-') {
+      return this.handleDividerShortcut();
+    }
+
+    if (event.data !== ' ') {
       return false;
     }
 
@@ -339,6 +350,58 @@ export class MarkdownShortcuts extends BlockEventComposer {
     return true;
   }
 
+  /**
+   * Check if current block content is exactly "---" and convert to divider.
+   * Unlike other shortcuts, this triggers on the third hyphen keystroke — no space needed.
+   */
+  private handleDividerShortcut(): boolean {
+    const { BlockManager, Tools, Caret } = this.Blok;
+    const currentBlock = BlockManager.currentBlock;
+
+    if (!currentBlock) {
+      return false;
+    }
+
+    if (!currentBlock.tool.isDefault) {
+      return false;
+    }
+
+    const dividerTool = Tools.blockTools.get(DIVIDER_TOOL_NAME);
+
+    if (!dividerTool) {
+      return false;
+    }
+
+    const currentInput = currentBlock.currentInput;
+
+    if (!currentInput) {
+      return false;
+    }
+
+    const textContent = currentInput.textContent || '';
+
+    if (!DIVIDER_PATTERN.test(textContent)) {
+      return false;
+    }
+
+    this.Blok.YjsManager.stopCapturing();
+
+    const newBlock = BlockManager.replace(currentBlock, DIVIDER_TOOL_NAME, {});
+
+    /**
+     * Insert an empty paragraph after the divider and set caret there,
+     * so the user can continue typing.
+     */
+    const newBlockIndex = BlockManager.getBlockIndex(newBlock);
+    const paragraphBlock = BlockManager.insertDefaultBlockAtIndex(newBlockIndex + 1);
+
+    Caret.setToBlock(paragraphBlock, Caret.positions.START);
+
+    this.Blok.YjsManager.stopCapturing();
+
+    return true;
+  }
+
   /**
    * Match default header shortcuts like "# ", "## ", etc.
    */

package/src/components/modules/blockEvents/constants.ts

@@ -82,3 +82,14 @@ export const TOGGLE_HEADER_PATTERN = /^>(#{1,6})\s([\s\S]*)$/;
  * Captures remaining content after the shortcut in group 1.
  */
 export const TOGGLE_PATTERN = /^>\s([\s\S]*)$/;
+
+/**
+ * Tool name for divider blocks.
+ */
+export const DIVIDER_TOOL_NAME = 'divider';
+
+/**
+ * Regex pattern for detecting divider shortcuts.
+ * Matches exactly three hyphens with no other content.
+ */
+export const DIVIDER_PATTERN = /^-{3}$/;

package/src/components/utils/data-model-transform.ts

@@ -260,10 +260,6 @@ const hasHierarchicalRefs = (block: OutputBlockData): boolean => {
 export const analyzeDataFormat = (blocks: OutputBlockData[]): DataFormatAnalysis => {
   const foundHierarchicalRefs = blocks.some(hasHierarchicalRefs);
 
-  if (foundHierarchicalRefs) {
-    return { format: 'hierarchical', hasHierarchy: true };
-  }
-
   // Check if any block uses legacy list format (items[] array)
   const foundLegacyList = blocks.some(isLegacyListBlock);
 
@@ -273,9 +269,15 @@ export const analyzeDataFormat = (blocks: OutputBlockData[]): DataFormatAnalysis
   // Check if any block uses legacy callout format (has body field)
   const foundLegacyCallout = blocks.some(isLegacyCalloutBlock);
 
-  if (foundLegacyList || foundLegacyToggle || foundLegacyCallout) {
+  const hasLegacyBlocks = foundLegacyList || foundLegacyToggle || foundLegacyCallout;
+
+  if (foundHierarchicalRefs && !hasLegacyBlocks) {
+    return { format: 'hierarchical', hasHierarchy: true };
+  }
+
+  if (hasLegacyBlocks) {
     // Check if there's actual nesting for the hasHierarchy flag
-    const hasNesting = blocks.some(hasNestedItems) || blocks.some(block =>
+    const hasNesting = foundHierarchicalRefs || blocks.some(hasNestedItems) || blocks.some(block =>
       isLegacyToggleListBlock(block) && block.data.body?.blocks !== undefined && block.data.body.blocks.length > 0
     ) || blocks.some(block =>
       isLegacyCalloutBlock(block) && block.data.body?.blocks !== undefined && block.data.body.blocks.length > 0

package/src/styles/main.css

@@ -1164,16 +1164,18 @@
  * Callout emoji vertical centering for heading first children.
  * Headings have taller line boxes than the emoji button, so the emoji
  * needs a top margin to shift its center down to match the heading's
- * first line center.  Values: (heading-line-height − emoji-content) / 2 + 1px mt-px.
+ * first line center.  Values: (heading-line-height − emoji-line-height) / 2 + 1px mt-px.
+ * Emoji button: text-[1.5rem] leading-[1] → line-height 24px.
+ * H1 text-3xl leading-[1.3] → 39px; H2 text-2xl → 31.2px; H3 text-xl → 26px.
  */
 [data-blok-component="callout"] button:has(+ [data-blok-toggle-children] > :first-child h1) {
-  margin-top: 7.5px;
+  margin-top: 8.5px;
 }
 [data-blok-component="callout"] button:has(+ [data-blok-toggle-children] > :first-child h2) {
-  margin-top: 3.6px;
+  margin-top: 4.6px;
 }
 [data-blok-component="callout"] button:has(+ [data-blok-toggle-children] > :first-child h3) {
-  margin-top: 1px;
+  margin-top: 2px;
 }
 
 /**

package/src/tools/callout/constants.ts

@@ -26,5 +26,5 @@ export const DEFAULT_EMOJI = '💡';
 
 // CSS — Tailwind classes
 export const WRAPPER_STYLES = 'rounded-xl px-4 py-[5px] my-1 flex items-start gap-2';
-export const EMOJI_BUTTON_STYLES = 'text-[1.25rem] cursor-pointer bg-transparent border-0 px-0 py-[7px] flex-shrink-0 select-none';
+export const EMOJI_BUTTON_STYLES = 'text-[1.5rem] leading-[1] cursor-pointer bg-transparent border-0 px-0 py-[7px] flex-shrink-0 select-none';
 export const CHILDREN_STYLES = 'flex-1 min-w-0';

package/src/tools/callout/emoji-picker/index.ts

@@ -246,7 +246,6 @@ export class EmojiPicker {
     randomBtn.type = 'button';
     randomBtn.setAttribute('data-emoji-picker-random', '');
     randomBtn.setAttribute('aria-label', this.i18n.t(PICK_RANDOM_KEY));
-    randomBtn.title = this.i18n.t(PICK_RANDOM_KEY);
     randomBtn.className = [
       'flex-shrink-0 w-[34px] h-[34px] flex items-center justify-center rounded-lg',
       'text-neutral-400 hover:bg-neutral-100 hover:text-neutral-600',
@@ -262,7 +261,6 @@ export class EmojiPicker {
     removeBtn.type = 'button';
     removeBtn.setAttribute('data-emoji-picker-remove', '');
     removeBtn.setAttribute('aria-label', this.i18n.t(REMOVE_EMOJI_KEY));
-    removeBtn.title = this.i18n.t(REMOVE_EMOJI_KEY);
     removeBtn.className = [
       'flex-shrink-0 w-[34px] h-[34px] flex items-center justify-center rounded-lg',
       'text-neutral-400 hover:bg-neutral-100 hover:text-neutral-600',
@@ -653,7 +651,6 @@ export class EmojiPicker {
       const btn = document.createElement('button');
       btn.type = 'button';
       btn.textContent = this.getSkinnedNative(emoji);
-      btn.title = this.getDisplayName(emoji);
       btn.setAttribute('data-emoji-native', emoji.native);
       btn.className = [
         'aspect-square flex items-center justify-center',

package/src/tools/divider/index.ts

@@ -0,0 +1,96 @@
+import type {
+  BlockTool,
+  BlockToolConstructorOptions,
+  PasteConfig,
+  SanitizerConfig,
+  ToolboxConfig,
+} from '../../../types';
+import type { DividerData } from './types';
+import { IconDivider } from '../../components/icons';
+import { twMerge } from '../../components/utils/tw';
+
+/**
+ * Divider block tool — renders a thin horizontal line separator.
+ * Contentless void block with no editable content or settings.
+ */
+export class DividerTool implements BlockTool {
+  /**
+   * Rendered wrapper element
+   */
+  private element: HTMLElement | null = null;
+
+  /**
+   * @param _options - block tool constructor options (unused for divider)
+   */
+  constructor(_options: BlockToolConstructorOptions<DividerData>) {}
+
+  /**
+   * Render a wrapper with a semantic <hr> element inside.
+   * Wrapper uses padding for spacing and minimal line-height so the
+   * toolbar positioning algorithm centers correctly on the divider line.
+   */
+  public render(): HTMLElement {
+    const wrapper = document.createElement('div');
+
+    wrapper.className = twMerge('py-3', 'leading-[1px]');
+
+    const hr = document.createElement('hr');
+
+    hr.className = twMerge('border-t', 'border-border-primary', 'border-b-0', 'border-l-0', 'border-r-0');
+    wrapper.appendChild(hr);
+    this.element = wrapper;
+
+    return wrapper;
+  }
+
+  /**
+   * Return empty data — divider has no content
+   */
+  public save(): DividerData {
+    return {} as DividerData;
+  }
+
+  /**
+   * Always valid — nothing to validate
+   */
+  public validate(_data: DividerData): boolean {
+    return true;
+  }
+
+  /**
+   * Toolbox appearance
+   */
+  public static get toolbox(): ToolboxConfig {
+    return {
+      icon: IconDivider,
+      titleKey: 'divider',
+      shortcut: '---',
+      searchTerms: ['hr', 'line', 'separator', 'rule', '---'],
+    };
+  }
+
+  /**
+   * Divider works in read-only mode
+   */
+  public static get isReadOnlySupported(): boolean {
+    return true;
+  }
+
+  /**
+   * Paste three-or-more hyphens to create a divider
+   */
+  public static get pasteConfig(): PasteConfig {
+    return {
+      patterns: {
+        divider: /^-{3,}$/,
+      },
+    };
+  }
+
+  /**
+   * Nothing to sanitize — no HTML content
+   */
+  public static get sanitize(): SanitizerConfig {
+    return {};
+  }
+}

package/src/tools/divider/types.ts

@@ -0,0 +1,6 @@
+import type { BlockToolData } from '../../../types';
+
+/**
+ * Divider block data. Empty — dividers have no configurable properties.
+ */
+export interface DividerData extends BlockToolData {}

package/src/tools/index.ts

@@ -26,6 +26,7 @@ export { ListItem as List } from './list';
 export { Table } from './table';
 export { ToggleItem as Toggle } from './toggle';
 export { CalloutTool as Callout } from './callout';
+export { DividerTool as Divider } from './divider';
 
 // Inline tools
 export { BoldInlineTool as Bold } from '../components/inline-tools/inline-tool-bold';
@@ -45,6 +46,7 @@ export const defaultBlockTools = {
   table: {},
   toggle: {},
   callout: {},
+  divider: {},
 } as const;
 
 export const defaultInlineTools = {

package/types/tools/divider.d.ts

@@ -0,0 +1,11 @@
+import { BlockTool, BlockToolConstructable, BlockToolConstructorOptions, BlockToolData } from './block-tool';
+
+/**
+ * Divider Tool's input and output data format.
+ * Empty — dividers have no configurable properties.
+ */
+export interface DividerData extends BlockToolData {}
+
+export interface DividerConstructable extends BlockToolConstructable {
+  new(options: BlockToolConstructorOptions<DividerData>): BlockTool;
+}

package/types/tools-entry.d.ts

@@ -8,6 +8,7 @@ import { ParagraphConstructable, ParagraphData, ParagraphConfig } from './tools/
 import { ListConstructable, ListData, ListConfig, ListStyle } from './tools/list';
 import { TableConstructable, TableData, TableConfig, CellContent } from './tools/table';
 import { ToggleConstructable, ToggleData, ToggleConfig } from './tools/toggle';
+import { DividerConstructable, DividerData } from './tools/divider';
 import { InlineToolConstructable } from './tools/inline-tool';
 import { BlockTuneConstructable } from './block-tunes';
 import { ToolSettings } from './tools';
@@ -18,6 +19,7 @@ export const Header: HeaderConstructable;
 export const List: ListConstructable;
 export const Table: TableConstructable;
 export const Toggle: ToggleConstructable;
+export const Divider: DividerConstructable;
 
 // Re-export data and config types for convenience
 export { HeaderData, HeaderConfig } from './tools/header';
@@ -25,6 +27,7 @@ export { ParagraphData, ParagraphConfig } from './tools/paragraph';
 export { ListData, ListConfig, ListStyle } from './tools/list';
 export { TableData, TableConfig, CellContent } from './tools/table';
 export { ToggleData, ToggleConfig } from './tools/toggle';
+export { DividerData } from './tools/divider';
 
 // Inline tools
 export const Bold: InlineToolConstructable;
@@ -42,10 +45,13 @@ export const Delete: BlockTuneConstructable;
  * Default block tools configuration
  */
 export const defaultBlockTools: {
-  readonly paragraph: { readonly inlineToolbar: true; readonly config: { readonly preserveBlank: true } };
-  readonly header: { readonly inlineToolbar: true };
-  readonly list: { readonly inlineToolbar: true };
+  readonly paragraph: { readonly preserveBlank: true };
+  readonly header: {};
+  readonly list: {};
   readonly table: {};
+  readonly toggle: {};
+  readonly callout: {};
+  readonly divider: {};
 };
 
 /**