@jackuait/blok 0.6.0-beta.5 → 0.6.0-beta.6

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

@@ -1,24 +1,24 @@
 {
-  "blockSettings.dragToMove": "తరలించడానికి డ్రాగ్ చేయండి",
-  "blockSettings.clickToOpenMenu": "మెనూ తెరవడానికి క్లిక్ చేయండి",
-  "toolbox.addBelow": "క్రింద జోడించడానికి క్లిక్ చేయండి",
-  "toolbox.optionAddAbove": "పైన జోడించడానికి Option-క్లిక్ చేయండి",
-  "toolbox.ctrlAddAbove": "పైన జోడించడానికి Ctrl-క్లిక్ చేయండి",
+  "blockSettings.dragToMove": "తరలించడానికి లాగండి",
+  "blockSettings.clickToOpenMenu": "జాబితా తెరవడానికి నొక్కండి",
+  "toolbox.addBelow": "క్రింద జోడించడానికి నొక్కండి",
+  "toolbox.optionAddAbove": "పైన జోడించడానికి Option-నొక్కండి",
+  "toolbox.ctrlAddAbove": "పైన జోడించడానికి Ctrl-నొక్కండి",
   "popover.search": "వెతకండి",
   "popover.nothingFound": "ఏమీ కనుగొనబడలేదు",
   "popover.convertTo": "మార్చు",
-  "toolNames.text": "టెక్స్ట్",
+  "toolNames.text": "వచనం",
   "toolNames.heading": "శీర్షిక",
   "toolNames.link": "లింక్",
-  "toolNames.bold": "బోల్డ్",
-  "toolNames.italic": "ఇటాలిక్",
-  "toolNames.bulletedList": "బుల్లెట్ జాబితా",
-  "toolNames.numberedList": "నంబర్ జాబితా",
+  "toolNames.bold": "గాఢం",
+  "toolNames.italic": "వాలు",
+  "toolNames.bulletedList": "చుక్కల జాబితా",
+  "toolNames.numberedList": "అంకెల జాబితా",
   "toolNames.todoList": "చేయవలసిన పనుల జాబితా",
   "tools.link.addLink": "లింక్ జోడించండి",
   "tools.link.invalidLink": "చెల్లని లింక్",
   "tools.stub.error": "లోపం",
-  "tools.stub.blockCannotBeDisplayed": "ఈ బ్లాక్‌ను ప్రదర్శించలేము",
+  "tools.stub.blockCannotBeDisplayed": "ఈ విభాగాన్ని ప్రదర్శించలేము",
   "tools.header.heading1": "శీర్షిక 1",
   "tools.header.heading2": "శీర్షిక 2",
   "tools.header.heading3": "శీర్షిక 3",
@@ -27,33 +27,33 @@
   "tools.header.heading6": "శీర్షిక 6",
   "tools.list.placeholder": "జాబితా",
   "blockSettings.delete": "తొలగించు",
-  "a11y.dragHandle": "బ్లాక్ తరలించడానికి డ్రాగ్ చేయండి లేదా మెనూ కోసం క్లిక్ చేయండి",
-  "a11y.dragHandleRole": "డ్రాగ్ హ్యాండిల్",
-  "a11y.dragStarted": "బ్లాక్ డ్రాగ్ అవుతోంది",
-  "a11y.dragStartedMultiple": "{count} బ్లాక్‌లు డ్రాగ్ అవుతున్నాయి",
-  "a11y.dropPosition": "{total} లో {position} స్థానంలో డ్రాప్ అవుతుంది",
-  "a11y.dropCancelled": "డ్రాగ్ రద్దు చేయబడింది",
-  "a11y.blockMoved": "బ్లాక్ {total} లో {position} స్థానానికి తరలించబడింది",
-  "a11y.blocksMoved": "{count} బ్లాక్‌లు {position} స్థానానికి తరలించబడ్డాయి",
-  "a11y.blockDuplicated": "బ్లాక్ {total} లో {position} స్థానంలో నకలు చేయబడింది",
-  "a11y.blocksDuplicated": "{count} బ్లాక్‌లు {position} స్థానం నుండి నకలు చేయబడ్డాయి",
-  "a11y.movedUp": "బ్లాక్ {total} లో {position} స్థానానికి పైకి తరలించబడింది",
-  "a11y.movedDown": "బ్లాక్ {total} లో {position} స్థానానికి క్రిందికి తరలించబడింది",
-  "a11y.atTop": "బ్లాక్ పైన ఉంది, పైకి తరలించలేము",
-  "a11y.atBottom": "బ్లాక్ క్రింద ఉంది, క్రిందికి తరలించలేము",
-  "tools.paragraph.placeholder": "ఏదైనా రాయండి లేదా ఎంచుకోడానికి / నొక్కండి",
+  "a11y.dragHandle": "విభాగం తరలించడానికి లాగండి లేదా జాబితా కోసం నొక్కండి",
+  "a11y.dragHandleRole": "లాగు పట్టిక",
+  "a11y.dragStarted": "విభాగం తరలుతోంది",
+  "a11y.dragStartedMultiple": "{count} విభాగాలు తరలుతున్నాయి",
+  "a11y.dropPosition": "{total} లో {position} స్థానంలో వదులుతుంది",
+  "a11y.dropCancelled": "లాగడం రద్దు చేయబడింది",
+  "a11y.blockMoved": "విభాగం {total} లో {position} స్థానానికి తరలించబడింది",
+  "a11y.blocksMoved": "{count} విభాగాలు {position} స్థానానికి తరలించబడ్డాయి",
+  "a11y.blockDuplicated": "విభాగం {total} లో {position} స్థానంలో నకలు చేయబడింది",
+  "a11y.blocksDuplicated": "{count} విభాగాలు {position} స్థానం నుండి నకలు చేయబడ్డాయి",
+  "a11y.movedUp": "విభాగం {total} లో {position} స్థానానికి పైకి తరలించబడింది",
+  "a11y.movedDown": "విభాగం {total} లో {position} స్థానానికి క్రిందికి తరలించబడింది",
+  "a11y.atTop": "విభాగం పైన ఉంది, పైకి తరలించలేము",
+  "a11y.atBottom": "విభాగం క్రింద ఉంది, క్రిందికి తరలించలేము",
+  "tools.paragraph.placeholder": "ఏదైనా రాయండి లేదా సాధనం ఎంచుకోడానికి / నొక్కండి",
   "tools.table.title": "పట్టిక",
-  "tools.table.clearSelection": "క్లియర్ చేయండి",
-  "tools.table.headerColumn": "హెడర్ కాలమ్",
-  "tools.table.insertColumnLeft": "ఎడమవైపు కాలమ్ చొప్పించు",
-  "tools.table.insertColumnRight": "కుడివైపు కాలమ్ చొప్పించు",
+  "tools.table.clearSelection": "తుడుచు",
+  "tools.table.headerColumn": "శీర్ష స్తంభం",
+  "tools.table.insertColumnLeft": "ఎడమవైపు స్తంభం చొప్పించు",
+  "tools.table.insertColumnRight": "కుడివైపు స్తంభం చొప్పించు",
   "tools.table.deleteColumn": "తొలగించు",
-  "tools.table.headerRow": "హెడర్ వరుస",
+  "tools.table.headerRow": "శీర్ష వరుస",
   "tools.table.insertRowAbove": "పైన వరుస చొప్పించు",
   "tools.table.insertRowBelow": "క్రింద వరుస చొప్పించు",
   "tools.table.deleteRow": "తొలగించు",
-  "tools.table.clickToAddRow": "కొత్త వరుస జోడించడానికి క్లిక్ చేయండి",
-  "tools.table.dragToAddRemoveRows": "వరుసలు జోడించడానికి లేదా తొలగించడానికి డ్రాగ్ చేయండి",
-  "tools.table.clickToAddColumn": "కొత్త కాలమ్ జోడించడానికి క్లిక్ చేయండి",
-  "tools.table.dragToAddRemoveColumns": "కాలమ్‌లు జోడించడానికి లేదా తొలగించడానికి డ్రాగ్ చేయండి"
+  "tools.table.clickToAddRow": "కొత్త వరుస జోడించడానికి నొక్కండి",
+  "tools.table.dragToAddRemoveRows": "వరుసలు జోడించడానికి లేదా తొలగించడానికి లాగండి",
+  "tools.table.clickToAddColumn": "కొత్త స్తంభం జోడించడానికి నొక్కండి",
+  "tools.table.dragToAddRemoveColumns": "స్తంభాలు జోడించడానికి లేదా తొలగించడానికి లాగండి"
 }

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

@@ -1,9 +1,9 @@
 {
   "blockSettings.dragToMove": "ลากเพื่อย้าย",
   "blockSettings.clickToOpenMenu": "คลิกเพื่อเปิดเมนู",
-  "toolbox.addBelow": "เพิ่มบล็อก",
-  "toolbox.optionAddAbove": "⌥ — เพิ่มด้านบน",
-  "toolbox.ctrlAddAbove": "Ctrl — เพิ่มด้านบน",
+  "toolbox.addBelow": "คลิกเพื่อเพิ่มด้านล่าง",
+  "toolbox.optionAddAbove": "⌥ คลิกเพื่อเพิ่มด้านบน",
+  "toolbox.ctrlAddAbove": "Ctrl คลิกเพื่อเพิ่มด้านบน",
   "popover.search": "ค้นหา",
   "popover.nothingFound": "ไม่พบผลลัพธ์",
   "popover.convertTo": "แปลงเป็น",
@@ -35,13 +35,13 @@
   "a11y.dropCancelled": "ยกเลิกการลาก",
   "a11y.blockMoved": "ย้ายบล็อกไปตำแหน่ง {position} จาก {total}",
   "a11y.blocksMoved": "ย้าย {count} บล็อกไปตำแหน่ง {position}",
-  "a11y.blockDuplicated": "คัดลอกบล็อกไปตำแหน่ง {position} จาก {total}",
+  "a11y.blockDuplicated": "คัดลอกบล็อกที่ตำแหน่ง {position} จาก {total}",
   "a11y.blocksDuplicated": "คัดลอก {count} บล็อก เริ่มจากตำแหน่ง {position}",
   "a11y.movedUp": "ย้ายบล็อกขึ้น ตำแหน่ง {position} จาก {total}",
   "a11y.movedDown": "ย้ายบล็อกลง ตำแหน่ง {position} จาก {total}",
   "a11y.atTop": "บล็อกอยู่บนสุดแล้ว ไม่สามารถย้ายขึ้นได้",
   "a11y.atBottom": "บล็อกอยู่ล่างสุดแล้ว ไม่สามารถย้ายลงได้",
-  "tools.paragraph.placeholder": "เขียนอะไรสักอย่าง หรือกด / เพื่อเลือก",
+  "tools.paragraph.placeholder": "เขียนอะไรสักอย่าง หรือกด / เพื่อเลือกเครื่องมือ",
   "tools.table.title": "ตาราง",
   "tools.table.clearSelection": "ล้าง",
   "tools.table.headerColumn": "คอลัมน์หัวข้อ",

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

@@ -1,12 +1,12 @@
 {
   "blockSettings.dragToMove": "Kéo để di chuyển",
   "blockSettings.clickToOpenMenu": "Nhấp để mở menu",
-  "toolbox.addBelow": "Thêm khối",
-  "toolbox.optionAddAbove": "⌥ Thêm ở trên",
-  "toolbox.ctrlAddAbove": "Ctrl Thêm ở trên",
+  "toolbox.addBelow": "Nhấp để thêm bên dưới",
+  "toolbox.optionAddAbove": "⌥ Nhấp để thêm bên trên",
+  "toolbox.ctrlAddAbove": "Ctrl+Nhấp để thêm bên trên",
   "popover.search": "Tìm kiếm",
   "popover.nothingFound": "Không tìm thấy",
-  "popover.convertTo": "Chuyển đổi",
+  "popover.convertTo": "Chuyển sang",
   "toolNames.text": "Văn bản",
   "toolNames.heading": "Tiêu đề",
   "toolNames.link": "Liên kết",
@@ -26,7 +26,7 @@
   "tools.header.heading5": "Tiêu đề 5",
   "tools.header.heading6": "Tiêu đề 6",
   "tools.list.placeholder": "Danh sách",
-  "tools.paragraph.placeholder": "Viết gì đó hoặc nhấn / để chọn",
+  "tools.paragraph.placeholder": "Viết gì đó hoặc nhấn / để chọn công cụ",
   "tools.table.title": "Bảng",
   "tools.table.clearSelection": "Xóa",
   "tools.table.headerColumn": "Cột tiêu đề",
@@ -46,14 +46,14 @@
   "a11y.dragHandleRole": "tay nắm kéo",
   "a11y.dragStarted": "Đang kéo khối",
   "a11y.dragStartedMultiple": "Đang kéo {count} khối",
-  "a11y.dropPosition": "Sẽ thả vào vị trí {position} trên {total}",
+  "a11y.dropPosition": "Sẽ thả vào vị trí {position} trong {total}",
   "a11y.dropCancelled": "Đã hủy kéo",
-  "a11y.blockMoved": "Khối đã được di chuyển đến vị trí {position} trên {total}",
+  "a11y.blockMoved": "Khối đã được di chuyển đến vị trí {position} trong {total}",
   "a11y.blocksMoved": "{count} khối đã được di chuyển đến vị trí {position}",
-  "a11y.blockDuplicated": "Khối đã được sao chép tại vị trí {position} trên {total}",
+  "a11y.blockDuplicated": "Khối đã được sao chép tại vị trí {position} trong {total}",
   "a11y.blocksDuplicated": "{count} khối đã được sao chép từ vị trí {position}",
-  "a11y.movedUp": "Khối đã di chuyển lên, vị trí {position} trên {total}",
-  "a11y.movedDown": "Khối đã di chuyển xuống, vị trí {position} trên {total}",
+  "a11y.movedUp": "Khối đã di chuyển lên đến vị trí {position} trong {total}",
+  "a11y.movedDown": "Khối đã di chuyển xuống đến vị trí {position} trong {total}",
   "a11y.atTop": "Khối đang ở trên cùng, không thể di chuyển lên",
   "a11y.atBottom": "Khối đang ở dưới cùng, không thể di chuyển xuống"
 }

package/src/components/modules/api/history.ts

@@ -0,0 +1,64 @@
+/**
+ * @module HistoryAPI
+ * @copyright <CodeX> 2018
+ *
+ * Provides public methods for undo/redo operations
+ */
+import type { History } from '../../../../types/api';
+import { Module } from '../../__module';
+
+/**
+ * @class HistoryAPI
+ */
+export class HistoryAPI extends Module {
+  /**
+   * Available methods
+   * @returns {History}
+   */
+  public get methods(): History {
+    return {
+      undo: (): void => this.undo(),
+      redo: (): void => this.redo(),
+      canUndo: (): boolean => this.canUndo(),
+      canRedo: (): boolean => this.canRedo(),
+      clear: (): void => this.clear(),
+    };
+  }
+
+  /**
+   * Undo the last operation
+   */
+  public undo(): void {
+    this.Blok.YjsManager.undo();
+  }
+
+  /**
+   * Redo the last undone operation
+   */
+  public redo(): void {
+    this.Blok.YjsManager.redo();
+  }
+
+  /**
+   * Check if undo is available
+   * @returns {boolean} true if undo is available
+   */
+  public canUndo(): boolean {
+    return this.Blok.YjsManager.canUndo();
+  }
+
+  /**
+   * Check if redo is available
+   * @returns {boolean} true if redo is available
+   */
+  public canRedo(): boolean {
+    return this.Blok.YjsManager.canRedo();
+  }
+
+  /**
+   * Clear all history
+   */
+  public clear(): void {
+    this.Blok.YjsManager.clear();
+  }
+}

package/src/components/modules/api/index.ts

@@ -21,6 +21,7 @@ export class API extends Module {
       caret: this.Blok.CaretAPI.methods,
       tools: this.Blok.ToolsAPI.methods,
       events: this.Blok.EventsAPI.methods,
+      history: this.Blok.HistoryAPI.methods,
       listeners: this.Blok.ListenersAPI.methods,
       notifier: this.Blok.NotifierAPI.methods,
       sanitizer: this.Blok.SanitizerAPI.methods,

package/src/components/modules/api/readonly.ts

@@ -12,9 +12,10 @@ export class ReadOnlyAPI extends Module {
   public get methods(): ReadOnly {
     const getIsEnabled = (): boolean => this.isEnabled;
 
-     
+
     return {
       toggle: (state): Promise<boolean> => this.toggle(state),
+      set: (state): Promise<boolean> => this.set(state),
       get isEnabled(): boolean {
         return getIsEnabled();
       },
@@ -30,6 +31,15 @@ export class ReadOnlyAPI extends Module {
     return this.Blok.ReadOnly.toggle(state);
   }
 
+  /**
+   * Set read-only mode to the specified boolean state
+   * @param {boolean} state - read-only state to set
+   * @returns {Promise<boolean>} the new read-only state
+   */
+  public set(state: boolean): Promise<boolean> {
+    return this.Blok.ReadOnly.set(state);
+  }
+
   /**
    * Returns current read-only state
    */

package/src/components/modules/blockManager/blockManager.ts

@@ -7,6 +7,7 @@
 import type { BlockToolData, OutputBlockData, PasteEvent } from '../../../../types';
 import type { BlockTuneData } from '../../../../types/block-tunes/block-tune-data';
 import type { BlockMutationEventMap, BlockMutationType } from '../../../../types/events/block';
+import { BlockAddedMutationType } from '../../../../types/events/block/BlockAdded';
 import { BlockChangedMutationType } from '../../../../types/events/block/BlockChanged';
 import { BlockRemovedMutationType } from '../../../../types/events/block/BlockRemoved';
 import { Module } from '../../__module';
@@ -307,6 +308,12 @@ export class BlockManager extends Module {
         replaceBlock: (index, newBlock) => {
           this.blocksStore.replace(index, newBlock);
         },
+        onBlockRemoved: (block, index) => {
+          this.blockDidMutated(BlockRemovedMutationType, block, { index });
+        },
+        onBlockAdded: (block, index) => {
+          this.blockDidMutated(BlockAddedMutationType, block, { index });
+        },
       },
       this.blocksStore
     );

package/src/components/modules/blockManager/yjs-sync.ts

@@ -43,6 +43,10 @@ export interface SyncHandlers {
   updateIndentation: (block: Block) => void;
   /** Called to replace a block at a specific index with a new block instance */
   replaceBlock: (index: number, newBlock: Block) => void;
+  /** Called when a block is removed during undo/redo (before DOM removal) */
+  onBlockRemoved: (block: Block, index: number) => void;
+  /** Called when a block is added during undo/redo (after insertion) */
+  onBlockAdded: (block: Block, index: number) => void;
 }
 
 /**
@@ -273,10 +277,12 @@ export class BlockYjsSync {
         bindEventsImmediately: true,
       });
 
-      // Insert into blocks store at correct position - caller must handle this
-      // This is a limitation - we need the blocksStore.insert method
       this.blocksStore.insert(targetIndex, block);
 
+      // Emit block-added event so listeners (e.g., TableCellBlocks) can
+      // claim the block for the correct cell during undo/redo
+      this.handlers.onBlockAdded(block, targetIndex);
+
       // Apply indentation if needed
       if (parentId !== undefined) {
         this.handlers.updateIndentation(block);
@@ -300,6 +306,10 @@ export class BlockYjsSync {
       return;
     }
 
+    // Emit block-removed event BEFORE removal so listeners can inspect
+    // the block's DOM position (e.g., which table cell it's in)
+    this.handlers.onBlockRemoved(block, index);
+
     // Remove from DOM
     this.blocksStore.remove(index);
 

package/src/components/modules/index.ts

@@ -1,6 +1,7 @@
 import { BlocksAPI } from './api/blocks';
 import { CaretAPI } from './api/caret';
 import { EventsAPI } from './api/events';
+import { HistoryAPI } from './api/history';
 import { I18nAPI } from './api/i18n';
 import { API } from './api/index';
 import { InlineToolbarAPI } from './api/inlineToolbar';
@@ -44,6 +45,7 @@ export {
   BlocksAPI,
   CaretAPI,
   EventsAPI,
+  HistoryAPI,
   I18nAPI,
   API,
   InlineToolbarAPI,
@@ -91,6 +93,7 @@ export const Modules = {
   BlocksAPI,
   CaretAPI,
   EventsAPI,
+  HistoryAPI,
   I18nAPI,
   API,
   InlineToolbarAPI,

package/src/components/modules/readonly.ts

@@ -125,6 +125,17 @@ export class ReadOnly extends Module {
     return this.readOnlyEnabled;
   }
 
+  /**
+   * Set read-only mode to the specified boolean state
+   * Unlike toggle(), this method requires a parameter and does not have default toggle behavior
+   * Call all Modules `toggleReadOnly` method and re-render Blok
+   * @param state - read-only state to set (required)
+   * @returns the new read-only state
+   */
+  public async set(state: boolean): Promise<boolean> {
+    return this.toggle(state);
+  }
+
   /**
    * Throws an error about tools which don't support read-only mode
    */

package/src/components/modules/yjs/index.ts

@@ -189,6 +189,29 @@ export class YjsManager extends Module {
     this.undoHistory.redo();
   }
 
+  /**
+   * Check if undo is available.
+   * @returns true if undo is available
+   */
+  public canUndo(): boolean {
+    return this.undoHistory.canUndo();
+  }
+
+  /**
+   * Check if redo is available.
+   * @returns true if redo is available
+   */
+  public canRedo(): boolean {
+    return this.undoHistory.canRedo();
+  }
+
+  /**
+   * Clear all history.
+   */
+  public clear(): void {
+    this.undoHistory.clear();
+  }
+
   /**
    * Stop capturing changes into current undo group.
    * Call this to force next change into a new undo entry.

package/src/tools/table/index.ts

@@ -72,6 +72,7 @@ export class Table implements BlockTool {
   private element: HTMLDivElement | null = null;
   private blockId: string | undefined;
   private pendingHighlight: PendingHighlight | null = null;
+  private isNewTable = false;
 
   constructor({ data, config, api, readOnly, block }: BlockToolConstructorOptions<TableData, TableConfig>) {
     this.api = api;
@@ -127,6 +128,8 @@ export class Table implements BlockTool {
       wrapper.setAttribute('data-blok-table-readonly', '');
     }
 
+    this.isNewTable = this.data.content.length === 0;
+
     const rows = this.data.content.length || this.config.rows || DEFAULT_ROWS;
     const cols = this.data.content[0]?.length || this.config.cols || DEFAULT_COLS;
 
@@ -178,6 +181,10 @@ export class Table implements BlockTool {
 
     this.data.content = this.cellBlocks?.initializeCells(this.data.content) ?? this.data.content;
 
+    if (this.isNewTable) {
+      populateNewCells(gridEl, this.cellBlocks);
+    }
+
     if (this.data.initialColWidth === undefined) {
       const widths = this.data.colWidths ?? readPixelWidths(gridEl);
 
@@ -190,6 +197,12 @@ export class Table implements BlockTool {
     this.initAddControls(gridEl);
     this.initRowColControls(gridEl);
     this.initCellSelection(gridEl);
+
+    if (this.isNewTable) {
+      const firstEditable = gridEl.querySelector<HTMLElement>('[contenteditable="true"]');
+
+      firstEditable?.focus();
+    }
   }
 
   public save(blockContent: HTMLElement): TableData {
@@ -313,6 +326,13 @@ export class Table implements BlockTool {
       wrapper: this.element,
       grid: gridEl,
       i18n: this.api.i18n,
+      getNewColumnWidth: () => {
+        const colWidths = this.data.colWidths ?? readPixelWidths(gridEl);
+
+        return this.data.initialColWidth !== undefined
+          ? Math.round((this.data.initialColWidth / 2) * 100) / 100
+          : computeHalfAvgWidth(colWidths);
+      },
       onAddRow: () => {
         this.grid.addRow(gridEl);
         populateNewCells(gridEl, this.cellBlocks);

package/src/tools/table/table-add-controls.ts

@@ -56,6 +56,8 @@ interface TableAddControlsOptions {
   onDragAddCol: () => void;
   onDragRemoveCol: () => void;
   onDragEnd: () => void;
+  /** Returns the pixel width of a newly added column, used as the drag unit size. */
+  getNewColumnWidth?: () => number;
 }
 
 /**
@@ -89,6 +91,7 @@ export class TableAddControls {
   private boundPointerUp: (e: PointerEvent) => void;
   private boundRowPointerDown: (e: PointerEvent) => void;
   private boundColPointerDown: (e: PointerEvent) => void;
+  private getNewColumnWidth: (() => number) | undefined;
 
   constructor(options: TableAddControlsOptions) {
     this.wrapper = options.wrapper;
@@ -103,6 +106,7 @@ export class TableAddControls {
     this.onDragAddCol = options.onDragAddCol;
     this.onDragRemoveCol = options.onDragRemoveCol;
     this.onDragEnd = options.onDragEnd;
+    this.getNewColumnWidth = options.getNewColumnWidth;
     this.boundMouseMove = this.handleMouseMove.bind(this);
     this.boundMouseLeave = this.handleMouseLeave.bind(this);
     this.boundPointerMove = this.handlePointerMove.bind(this);
@@ -283,6 +287,10 @@ export class TableAddControls {
       return lastRow?.offsetHeight || 30;
     }
 
+    if (this.getNewColumnWidth) {
+      return this.getNewColumnWidth();
+    }
+
     const firstRow = this.grid.querySelector('[data-blok-table-row]');
 
     if (!firstRow) {

package/src/tools/table/table-cell-blocks.ts

@@ -229,6 +229,7 @@ export class TableCellBlocks {
    * Initialize all cells with blocks.
    * - Empty cells or legacy string cells get a new paragraph block.
    * - Cells that already have block references get those blocks mounted.
+   * - If referenced blocks are missing from BlockManager, a fallback paragraph is created.
    */
   public initializeCells(content: LegacyCellContent[][]): CellContent[][] {
     const rowElements = this.gridElement.querySelectorAll(`[${ROW_ATTR}]`);
@@ -257,9 +258,12 @@ export class TableCellBlocks {
           return;
         }
 
-        if (isCellWithBlocks(cellContent)) {
-          this.mountBlocksInCell(container, cellContent.blocks);
-          normalizedRow.push(cellContent);
+        const mountedIds = isCellWithBlocks(cellContent)
+          ? this.mountBlocksInCell(container, cellContent.blocks)
+          : [];
+
+        if (mountedIds.length > 0) {
+          normalizedRow.push({ blocks: mountedIds });
         } else {
           const text = typeof cellContent === 'string' ? cellContent : '';
           const block = this.api.blocks.insert('paragraph', { text }, {}, this.api.blocks.getBlocksCount(), false);
@@ -291,9 +295,12 @@ export class TableCellBlocks {
   }
 
   /**
-   * Mount existing blocks into a cell container by their IDs
+   * Mount existing blocks into a cell container by their IDs.
+   * Returns the IDs of blocks that were successfully mounted.
    */
-  private mountBlocksInCell(container: HTMLElement, blockIds: string[]): void {
+  private mountBlocksInCell(container: HTMLElement, blockIds: string[]): string[] {
+    const mountedIds: string[] = [];
+
     for (const blockId of blockIds) {
       const index = this.api.blocks.getBlockIndex(blockId);
 
@@ -308,7 +315,10 @@ export class TableCellBlocks {
       }
 
       container.appendChild(block.holder);
+      mountedIds.push(blockId);
     }
+
+    return mountedIds;
   }
 
   /**

package/src/types-internal/blok-modules.d.ts

@@ -2,6 +2,7 @@
 import { BlocksAPI } from '../components/modules/api/blocks';
 import { CaretAPI } from '../components/modules/api/caret';
 import { EventsAPI } from '../components/modules/api/events';
+import { HistoryAPI } from '../components/modules/api/history';
 import { I18nAPI } from '../components/modules/api/i18n';
 import { API } from '../components/modules/api/index';
 import { InlineToolbarAPI } from '../components/modules/api/inlineToolbar';
@@ -45,6 +46,7 @@ export interface BlokModules {
   CaretAPI: CaretAPI,
   ToolsAPI: ToolsAPI,
   EventsAPI: EventsAPI,
+  HistoryAPI: HistoryAPI,
   I18nAPI: I18nAPI,
   API: API,
   InlineToolbarAPI: InlineToolbarAPI,

package/types/api/history.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Describes Blok's history API
+ */
+export interface History {
+  /**
+   * Undo the last operation
+   */
+  undo(): void;
+
+  /**
+   * Redo the last undone operation
+   */
+  redo(): void;
+
+  /**
+   * Check if undo is available
+   *
+   * @returns {boolean} true if undo is available
+   */
+  canUndo(): boolean;
+
+  /**
+   * Check if redo is available
+   *
+   * @returns {boolean} true if redo is available
+   */
+  canRedo(): boolean;
+
+  /**
+   * Clear all history
+   */
+  clear(): void;
+}

package/types/api/index.d.ts

@@ -1,5 +1,6 @@
 export * from './blocks';
 export * from './events';
+export * from './history';
 export * from './listeners';
 export * from './sanitizer';
 export * from './saver';

package/types/api/readonly.d.ts

@@ -3,10 +3,20 @@
  */
 export interface ReadOnly {
   /**
-   * Set or toggle read-only state
+   * Set read-only mode to the specified boolean state
    *
-   * @param {Boolean|undefined} state - set or toggle state
+   * @param {Boolean} state - read-only state to set
+   * @returns {Promise<boolean>} the new read-only state
+   */
+  set: (state: boolean) => Promise<boolean>;
+
+  /**
+   * Toggle read-only state (deprecated - use set() instead)
+   * Without parameter, toggles current state. With parameter, sets to specified state.
+   *
+   * @param {Boolean|undefined} state - optional state to set (if omitted, toggles)
    * @returns {Promise<boolean>} current value
+   * @deprecated Use `set()` method for clearer intent
    */
   toggle: (state?: boolean) => Promise<boolean>;
 

package/types/index.d.ts

@@ -16,6 +16,7 @@ import {
   Blocks,
   Caret,
   Events,
+  History,
   InlineToolbar,
   Listeners,
   Notifier,
@@ -90,6 +91,7 @@ export {
   Blocks,
   Caret,
   Events,
+  History,
   InlineToolbar,
   Listeners,
   Notifier,
@@ -127,6 +129,7 @@ export interface API {
   caret: Caret;
   tools: Tools;
   events: Events;
+  history: History;
   listeners: Listeners;
   notifier: Notifier;
   sanitizer: Sanitizer;