@contentful/field-editor-rich-text 3.14.3 → 3.15.1

package/dist/esm/plugins/Quote/components/Quote.js

@@ -8,7 +8,7 @@ const style = css({
     fontStyle: 'normal'
 });
 export function Quote(props) {
-    return React.createElement("blockquote", {
+    return /*#__PURE__*/ React.createElement("blockquote", {
         ...props.attributes,
         className: style
     }, props.children);

package/dist/esm/plugins/Quote/components/ToolbarQuoteButton.js

@@ -13,11 +13,11 @@ export function ToolbarQuoteButton(props) {
         focus(editor);
     }
     if (!editor) return null;
-    return React.createElement(ToolbarButton, {
+    return /*#__PURE__*/ React.createElement(ToolbarButton, {
         title: "Blockquote",
         onClick: handleOnClick,
         testId: "quote-toolbar-button",
         isDisabled: props.isDisabled,
         isActive: isBlockSelected(editor, BLOCKS.QUOTE)
-    }, React.createElement(QuoteIcon, null));
+    }, /*#__PURE__*/ React.createElement(QuoteIcon, null));
 }

package/dist/esm/plugins/Quote/createQuotePlugin.js

@@ -25,6 +25,7 @@ export function createQuotePlugin() {
         },
         resetNode: [
             {
+                // toggle off blockquote on backspace when it's empty
                 hotkey: 'backspace',
                 types: [
                     BLOCKS.QUOTE

package/dist/esm/plugins/Quote/shouldResetQuote.js

@@ -1,7 +1,12 @@
 import { BLOCKS, TEXT_CONTAINERS } from '@contentful/rich-text-types';
 import { isLastChild, hasSingleChild } from '@udecode/plate-common';
 import { getAboveNode, getBlockAbove, isAncestorEmpty } from '../../internal/queries';
-export const shouldResetQuoteOnBackspace = (editor)=>{
+/**
+ * Returns true if we are:
+ * 1) Inside a blockquote
+ * 2) With no only one child paragraph/heading and
+ * 3) that child is empty
+ */ export const shouldResetQuoteOnBackspace = (editor)=>{
     const container = getAboveNode(editor, {
         match: {
             type: TEXT_CONTAINERS

package/dist/esm/plugins/Quote/toggleQuote.js

@@ -25,7 +25,7 @@ export function toggleQuote(editor, logAction) {
     });
 }
 export const onKeyDownToggleQuote = (editor, plugin)=>(event)=>{
-        const { hotkey  } = plugin.options;
+        const { hotkey } = plugin.options;
         if (hotkey && isHotkey(hotkey, event)) {
             event.preventDefault();
             toggleQuote(editor, editor.tracking.onShortcutAction);

package/dist/esm/plugins/Quote/withQuote.js

@@ -3,7 +3,7 @@ import { Element, Point } from 'slate';
 import { getAboveNode, getText } from '../../internal/queries';
 import { deleteText, insertNodes } from '../../internal/transforms';
 export const withQuote = (editor)=>{
-    const { insertFragment  } = editor;
+    const { insertFragment } = editor;
     editor.insertFragment = (fragment)=>{
         const startingNode = fragment.length && fragment[0];
         const startsWithBlockquote = Element.isElement(startingNode) && startingNode.type === BLOCKS.QUOTE;
@@ -14,13 +14,15 @@ export const withQuote = (editor)=>{
         });
         const containerIsNotEmpty = containerEntry && getText(editor, containerEntry[1]) !== '';
         if (startsWithBlockquote && containerIsNotEmpty) {
-            const { selection  } = editor;
+            const { selection } = editor;
             const isContentSelected = (selection)=>!!selection && Point.compare(selection.anchor, selection.focus) !== 0;
+            // if something is selected (highlighted) we replace the selection
             if (isContentSelected(selection)) {
                 deleteText(editor, {
                     at: selection
                 });
             }
+            // get the cursor entry again, it may be different after deletion
             const containerEntry = getAboveNode(editor, {
                 match: {
                     type: TEXT_CONTAINERS

package/dist/esm/plugins/SelectOnBackspace/createSelectOnBackspacePlugin.js

@@ -3,6 +3,7 @@ import { createSelectOnBackspacePlugin as createDefaultSelectPlugin } from '@ude
 export const createSelectOnBackspacePlugin = ()=>createDefaultSelectPlugin({
         options: {
             query: {
+                // `createTextPlugin` is taking care of block elements
                 allow: [
                     INLINES.EMBEDDED_ENTRY
                 ]

package/dist/esm/plugins/Table/__tests__/createTablePlugin.test.js

@@ -1,26 +1,26 @@
-import { assertOutput, jsx } from '../../../test-utils';
+/* eslint-disable react/no-unknown-property */ /** @jsx jsx */ import { assertOutput, jsx } from '../../../test-utils';
 describe('normalization', ()=>{
     describe('Table', ()=>{
         it('removes empty table nodes', ()=>{
-            const input = jsx("editor", null, jsx("htable", null));
-            const expected = jsx("editor", null, jsx("hp", null, jsx("text", null)));
+            const input = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null));
+            const expected = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("text", null)));
             assertOutput({
                 input,
                 expected
             });
         });
         it('moves tables to the root level except nested tables', ()=>{
-            const table = jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "Cell 1")), jsx("htd", null, jsx("hp", null, "Cell 2"))));
-            const input = jsx("editor", null, jsx("hp", null, "hello", table), jsx("hquote", null, jsx("hp", null, "quote", table)), jsx("hul", null, jsx("hli", null, jsx("hp", null, "item", table))), jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell with table: ", table)))));
-            const expected = jsx("editor", null, jsx("hp", null, "hello"), table, jsx("hquote", null, jsx("hp", null, "quote")), table, jsx("hul", null, jsx("hli", null, jsx("hp", null, "item"))), table, jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell with table: "), jsx("hp", null, "Cell 1"), jsx("hp", null, "Cell 2")))), jsx("hp", null, jsx("htext", null)));
+            const table = /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "Cell 1")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "Cell 2"))));
+            const input = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("hp", null, "hello", table), /*#__PURE__*/ jsx("hquote", null, /*#__PURE__*/ jsx("hp", null, "quote", table)), /*#__PURE__*/ jsx("hul", null, /*#__PURE__*/ jsx("hli", null, /*#__PURE__*/ jsx("hp", null, "item", table))), /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell with table: ", table)))));
+            const expected = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("hp", null, "hello"), table, /*#__PURE__*/ jsx("hquote", null, /*#__PURE__*/ jsx("hp", null, "quote")), table, /*#__PURE__*/ jsx("hul", null, /*#__PURE__*/ jsx("hli", null, /*#__PURE__*/ jsx("hp", null, "item"))), table, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell with table: "), /*#__PURE__*/ jsx("hp", null, "Cell 1"), /*#__PURE__*/ jsx("hp", null, "Cell 2")))), /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", null)));
             assertOutput({
                 input,
                 expected
             });
         });
         it('removes invalid children', ()=>{
-            const input = jsx("editor", null, jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "Cell 1")), jsx("htd", null, jsx("hp", null, "Cell 2"))), jsx("htd", null, "invalid cell"), "invalid text"), jsx("hp", null));
-            const expected = jsx("editor", null, jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "Cell 1")), jsx("htd", null, jsx("hp", null, "Cell 2")))), jsx("hp", null, jsx("htext", null)));
+            const input = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "Cell 1")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "Cell 2"))), /*#__PURE__*/ jsx("htd", null, "invalid cell"), "invalid text"), /*#__PURE__*/ jsx("hp", null));
+            const expected = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "Cell 1")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "Cell 2")))), /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", null)));
             assertOutput({
                 input,
                 expected
@@ -29,22 +29,22 @@ describe('normalization', ()=>{
     });
     describe('Table cell', ()=>{
         it('converts invalid children to paragraphs', ()=>{
-            const input = jsx("editor", null, jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "Cell 1")), jsx("htd", null, jsx("hp", null, "Cell 2"), jsx("hquote", null, jsx("hp", null, jsx("htext", {
+            const input = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "Cell 1")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "Cell 2"), /*#__PURE__*/ jsx("hquote", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", {
                 bold: true,
                 italic: true,
                 underline: true
-            }, "quote"), jsx("hinline", {
+            }, "quote"), /*#__PURE__*/ jsx("hinline", {
                 type: "Entry",
                 id: "entry-id"
-            })))))), jsx("hp", null));
-            const expected = jsx("editor", null, jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "Cell 1")), jsx("htd", null, jsx("hp", null, "Cell 2"), jsx("hp", null, jsx("htext", {
+            })))))), /*#__PURE__*/ jsx("hp", null));
+            const expected = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "Cell 1")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "Cell 2"), /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", {
                 bold: true,
                 italic: true,
                 underline: true
-            }, "quote"), jsx("hinline", {
+            }, "quote"), /*#__PURE__*/ jsx("hinline", {
                 type: "Entry",
                 id: "entry-id"
-            }), jsx("htext", null))))), jsx("hp", null, jsx("htext", null)));
+            }), /*#__PURE__*/ jsx("htext", null))))), /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", null)));
             assertOutput({
                 input,
                 expected
@@ -53,32 +53,32 @@ describe('normalization', ()=>{
     });
     describe('Table row', ()=>{
         it('must be wrapped in a table', ()=>{
-            const input = jsx("editor", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell"))));
-            const expected = jsx("editor", null, jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell")))), jsx("hp", null, jsx("text", null)));
+            const input = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell"))));
+            const expected = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell")))), /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("text", null)));
             assertOutput({
                 input,
                 expected
             });
         });
         it('removes empty rows', ()=>{
-            const input = jsx("editor", null, jsx("htr", null));
-            const expected = jsx("editor", null, jsx("hp", null, jsx("text", null)));
+            const input = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htr", null));
+            const expected = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("text", null)));
             assertOutput({
                 input,
                 expected
             });
         });
         it('wraps invalid children in table cells', ()=>{
-            const input = jsx("editor", null, jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell 1")), jsx("hp", null, "cell 2"))));
-            const expected = jsx("editor", null, jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell 1")), jsx("htd", null, jsx("hp", null, "cell 2")))), jsx("hp", null, jsx("text", null)));
+            const input = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 1")), /*#__PURE__*/ jsx("hp", null, "cell 2"))));
+            const expected = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 1")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 2")))), /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("text", null)));
             assertOutput({
                 input,
                 expected
             });
         });
         it('ensures all table rows have the same width', ()=>{
-            const input = jsx("editor", null, jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell 1"))), jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell 2")), jsx("htd", null, jsx("hp", null, "cell 3")), jsx("htd", null, jsx("hp", null, "cell 4"))), jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell 5")), jsx("htd", null, jsx("hp", null, "cell 6")))));
-            const expected = jsx("editor", null, jsx("htable", null, jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell 1")), jsx("htd", null, jsx("hp", null, jsx("text", null))), jsx("htd", null, jsx("hp", null, jsx("text", null)))), jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell 2")), jsx("htd", null, jsx("hp", null, "cell 3")), jsx("htd", null, jsx("hp", null, "cell 4"))), jsx("htr", null, jsx("htd", null, jsx("hp", null, "cell 5")), jsx("htd", null, jsx("hp", null, "cell 6")), jsx("htd", null, jsx("hp", null, jsx("text", null))))), jsx("hp", null, jsx("text", null)));
+            const input = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 1"))), /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 2")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 3")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 4"))), /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 5")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 6")))));
+            const expected = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 1")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("text", null))), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("text", null)))), /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 2")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 3")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 4"))), /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 5")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, "cell 6")), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("text", null))))), /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("text", null)));
             assertOutput({
                 input,
                 expected

package/dist/esm/plugins/Table/__tests__/helpers.test.js

@@ -1,12 +1,12 @@
-import { jsx, assertOutput, createTestEditor } from '../../../test-utils';
+/** @jsx jsx */ import { jsx, assertOutput, createTestEditor } from '../../../test-utils';
 import { insertTableAndFocusFirstCell } from '../helpers';
 test('insertTableAndFocusFirstCell', ()=>{
-    const input = jsx("editor", null, jsx("hp", null, jsx("htext", null), jsx("cursor", null)), jsx("hp", null));
-    const { editor  } = createTestEditor({
+    const input = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", null), /*#__PURE__*/ jsx("cursor", null)), /*#__PURE__*/ jsx("hp", null));
+    const { editor } = createTestEditor({
         input
     });
     insertTableAndFocusFirstCell(editor);
-    const expected = jsx("editor", null, jsx("htable", null, jsx("htr", null, jsx("hth", null, jsx("hp", null, jsx("htext", null), jsx("cursor", null))), jsx("hth", null, jsx("hp", null, jsx("htext", null)))), jsx("htr", null, jsx("htd", null, jsx("hp", null, jsx("htext", null))), jsx("htd", null, jsx("hp", null, jsx("htext", null))))), jsx("hp", null, jsx("htext", null)));
+    const expected = /*#__PURE__*/ jsx("editor", null, /*#__PURE__*/ jsx("htable", null, /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("hth", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", null), /*#__PURE__*/ jsx("cursor", null))), /*#__PURE__*/ jsx("hth", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", null)))), /*#__PURE__*/ jsx("htr", null, /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", null))), /*#__PURE__*/ jsx("htd", null, /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", null))))), /*#__PURE__*/ jsx("hp", null, /*#__PURE__*/ jsx("htext", null)));
     assertOutput({
         input,
         expected

package/dist/esm/plugins/Table/actions/addColumn.js

@@ -2,7 +2,7 @@ import { BLOCKS } from '@contentful/rich-text-types';
 import { getEmptyCellNode } from '@udecode/plate-table';
 import { getAboveNode, getNextPath, someNode } from '../../../internal/queries';
 import { insertNodes } from '../../../internal/transforms';
-const addColumn = (editor, { header  }, getNextCellPath)=>{
+const addColumn = (editor, { header }, getNextCellPath)=>{
     if (someNode(editor, {
         match: {
             type: BLOCKS.TABLE
@@ -31,6 +31,7 @@ const addColumn = (editor, { header  }, getNextCellPath)=>{
                     header: header && rowIdx === 0
                 }), {
                     at: newCellPath,
+                    // Select the first cell of the new column
                     select: rowIdx === 0
                 });
             });

package/dist/esm/plugins/Table/actions/addRow.js

@@ -21,8 +21,10 @@ const addRow = (editor, getNextRowPath)=>{
                 colCount: currentRowElem.children.length
             }), {
                 at: nextRowPath,
+                // Note: this selects the last cell of the new row
                 select: true
             });
+            // Select the first cell in the current row
             select(editor, getStartPoint(editor, nextRowPath));
         }
     }
@@ -34,6 +36,7 @@ export const addRowBelow = (editor)=>{
 };
 export const addRowAbove = (editor)=>{
     addRow(editor, (currentRowPath)=>{
+        // The new row will be in in-place of the old row
         return currentRowPath;
     });
 };

package/dist/esm/plugins/Table/components/Cell.js

@@ -17,9 +17,9 @@ const style = css`
 `;
 export const Cell = (props)=>{
     const isSelected = useSelected();
-    return React.createElement("td", {
+    return /*#__PURE__*/ React.createElement("td", {
         ...props.attributes,
         ...props.element.data,
         className: style
-    }, isSelected && React.createElement(TableActions, null), props.children);
+    }, isSelected && /*#__PURE__*/ React.createElement(TableActions, null), props.children);
 };

package/dist/esm/plugins/Table/components/HeaderCell.js

@@ -20,9 +20,9 @@ const style = css`
 `;
 export const HeaderCell = (props)=>{
     const isSelected = useSelected();
-    return React.createElement("th", {
+    return /*#__PURE__*/ React.createElement("th", {
         ...props.attributes,
         ...props.element.data,
         className: style
-    }, isSelected && React.createElement(TableActions, null), props.children);
+    }, isSelected && /*#__PURE__*/ React.createElement(TableActions, null), props.children);
 };

package/dist/esm/plugins/Table/components/Row.js

@@ -9,7 +9,7 @@ const style = css`
     background-color: transparent !important;
   }
 `;
-export const Row = (props)=>React.createElement("tr", {
+export const Row = (props)=>/*#__PURE__*/ React.createElement("tr", {
         ...props.attributes,
         className: style
     }, props.children);

package/dist/esm/plugins/Table/components/Table.js

@@ -13,10 +13,10 @@ const style = css`
   overflow: hidden;
 `;
 export const Table = (props)=>{
-    return React.createElement("div", {
+    return /*#__PURE__*/ React.createElement("div", {
         "data-block-type": BLOCKS.TABLE
-    }, React.createElement("table", {
+    }, /*#__PURE__*/ React.createElement("table", {
         className: style,
         ...props.attributes
-    }, React.createElement("tbody", null, props.children)));
+    }, /*#__PURE__*/ React.createElement("tbody", null, props.children)));
 };

package/dist/esm/plugins/Table/components/TableActions.js

@@ -70,6 +70,7 @@ export const TableActions = ()=>{
                     header: isHeaderEnabled
                 });
             });
+            // Tracking
             const actionName = `${type}Table${element === 'Table' ? '' : element}`;
             editor.tracking.onViewportAction(actionName, {
                 tableSize
@@ -82,37 +83,37 @@ export const TableActions = ()=>{
     if (isDisabled) {
         return null;
     }
-    return React.createElement(Menu, {
+    return /*#__PURE__*/ React.createElement(Menu, {
         placement: "left",
         isOpen: isOpen,
         onOpen: ()=>{
             setOpen(true);
         },
         onClose: close
-    }, React.createElement(Menu.Trigger, null, React.createElement(IconButton, {
+    }, /*#__PURE__*/ React.createElement(Menu.Trigger, null, /*#__PURE__*/ React.createElement(IconButton, {
         size: "small",
         variant: "transparent",
         tabIndex: -1,
         className: styles.topRight,
-        icon: React.createElement(ChevronDownIcon, null),
+        icon: /*#__PURE__*/ React.createElement(ChevronDownIcon, null),
         "aria-label": "Open table menu",
         testId: "cf-table-actions-button"
-    })), React.createElement(Menu.List, null, React.createElement(Menu.Item, {
+    })), /*#__PURE__*/ React.createElement(Menu.List, null, /*#__PURE__*/ React.createElement(Menu.Item, {
         onClick: action(addRowAbove, 'insert', 'Row'),
         disabled: !canInsertRowAbove
-    }, "Add row above"), React.createElement(Menu.Item, {
+    }, "Add row above"), /*#__PURE__*/ React.createElement(Menu.Item, {
         onClick: action(addRowBelow, 'insert', 'Row')
-    }, "Add row below"), React.createElement(Menu.Item, {
+    }, "Add row below"), /*#__PURE__*/ React.createElement(Menu.Item, {
         onClick: action(addColumnLeft, 'insert', 'Column')
-    }, "Add column left"), React.createElement(Menu.Item, {
+    }, "Add column left"), /*#__PURE__*/ React.createElement(Menu.Item, {
         onClick: action(addColumnRight, 'insert', 'Column')
-    }, "Add column right"), React.createElement(Menu.Divider, null), React.createElement(Menu.Item, {
+    }, "Add column right"), /*#__PURE__*/ React.createElement(Menu.Divider, null), /*#__PURE__*/ React.createElement(Menu.Item, {
         onClick: toggleHeader
-    }, isHeaderEnabled ? 'Disable table header' : 'Enable table header'), React.createElement(Menu.Divider, null), React.createElement(Menu.Item, {
+    }, isHeaderEnabled ? 'Disable table header' : 'Enable table header'), /*#__PURE__*/ React.createElement(Menu.Divider, null), /*#__PURE__*/ React.createElement(Menu.Item, {
         onClick: action(deleteRow, 'remove', 'Row')
-    }, "Delete row"), React.createElement(Menu.Item, {
+    }, "Delete row"), /*#__PURE__*/ React.createElement(Menu.Item, {
         onClick: action(deleteColumn, 'remove', 'Column')
-    }, "Delete column"), React.createElement(Menu.Item, {
+    }, "Delete column"), /*#__PURE__*/ React.createElement(Menu.Item, {
         onClick: action(deleteTable, 'remove', 'Table')
     }, "Delete table")));
 };

package/dist/esm/plugins/Table/components/ToolbarButton.js

@@ -14,11 +14,12 @@ export function ToolbarTableButton(props) {
         focus(editor);
     }
     if (!editor) return null;
-    return React.createElement(ToolbarButton, {
+    return /*#__PURE__*/ React.createElement(ToolbarButton, {
         title: "Table",
         testId: "table-toolbar-button",
         onClick: handleClick,
+        // TODO: active state looks off since the button will be disabled. Do we still need it?
         isActive: !!isActive,
         isDisabled: props.isDisabled
-    }, React.createElement(TableIcon, null));
+    }, /*#__PURE__*/ React.createElement(TableIcon, null));
 }

package/dist/esm/plugins/Table/createTablePlugin.js

@@ -15,11 +15,15 @@ import { addTableTrackingEvents, withInvalidCellChildrenTracking } from './table
 export const createTablePlugin = ()=>createDefaultTablePlugin({
         type: BLOCKS.TABLE,
         handlers: {
+            // @ts-expect-error
             onKeyDown: onKeyDownTable
         },
         withOverrides: (editor, plugin)=>{
-            const { normalizeNode  } = editor;
+            const { normalizeNode } = editor;
+            // injects important fixes from plate's original table plugin
             withTable(editor, plugin);
+            // Resets all normalization rules added by @udecode/plate-table as
+            // they conflict with our own
             editor.normalizeNode = normalizeNode;
             addTableTrackingEvents(editor);
             editor.insertFragment = insertTableFragment(editor);
@@ -34,7 +38,10 @@ export const createTablePlugin = ()=>createDefaultTablePlugin({
                         validNode: isNotEmpty
                     },
                     {
+                        // Move to root level unless nested
                         validNode: (editor, [, path])=>{
+                            // Nested tables are handled by another normalization
+                            // rule in a the table cell level
                             const isNestedTable = !!getBlockAbove(editor, {
                                 at: path,
                                 match: {
@@ -62,9 +69,11 @@ export const createTablePlugin = ()=>createDefaultTablePlugin({
                         transform: transformWrapIn(BLOCKS.TABLE_CELL)
                     },
                     {
+                        // Remove empty rows
                         validNode: isNotEmpty
                     },
                     {
+                        // Parent must be a table
                         validNode: (editor, [, path])=>{
                             const parent = getParentNode(editor, path)?.[0];
                             return parent && parent.type === BLOCKS.TABLE;
@@ -72,6 +81,7 @@ export const createTablePlugin = ()=>createDefaultTablePlugin({
                         transform: transformWrapIn(BLOCKS.TABLE)
                     },
                     {
+                        // ensure consistent number of cells in each row
                         validNode: (editor, entry)=>{
                             return getNoOfMissingTableCellsInRow(editor, entry) === 0;
                         },

package/dist/esm/plugins/Table/helpers.js

@@ -71,21 +71,30 @@ export function replaceEmptyParagraphWithTable(editor) {
     const [previousNode] = nodes;
     const isPreviousNodeTextEmpty = isAncestorEmpty(editor, previousNode);
     if (isPreviousNodeTextEmpty) {
+        // Switch table with previous empty paragraph
         moveNodes(editor, {
             at: tablePath,
             to: previousPath
         });
+        // Remove previous paragraph that now is under the table
         removeNodes(editor, {
             at: tablePath
         });
     }
 }
-export const getNoOfMissingTableCellsInRow = (editor, rowEntry)=>{
+/**
+ * Returns the number of cells in a given row vs the table width
+ *
+ * Note: We should only get different table rows cell counts in between
+ * normalization cycles.
+ */ export const getNoOfMissingTableCellsInRow = (editor, rowEntry)=>{
     const [, rowPath] = rowEntry;
     const parent = getParentNode(editor, rowPath);
+    // This is ensured by normalization. The error is here just in case
     if (!parent) {
         throw new Error('table rows must be wrapped in a table node');
     }
+    // The longest table row determines its width
     const tableWidth = Math.max(...getChildren(parent).map((entry)=>getChildren(entry).length));
     const rowWidth = getChildren(rowEntry).length;
     return tableWidth - rowWidth;

package/dist/esm/plugins/Table/insertTableFragment.js

@@ -2,18 +2,29 @@ import { BLOCKS } from '@contentful/rich-text-types';
 import { insertEmptyParagraph } from '../../helpers/editor';
 import { getText, isElement } from '../../internal/queries';
 import { isTable } from './helpers';
-const trimUnnecessaryTableWrapper = (node)=>{
+/**
+ * Removes table wrappers when pasting a single table cell
+ *
+ * In Plate/Slate, copying the content of a table cell wraps
+ * it in a <table><tr><td>{content}</td></tr></table> even
+ * when copying partial cell content.
+ *
+ * That's really annoying as there is no way to remove the table
+ * wrappers in that case.
+ */ const trimUnnecessaryTableWrapper = (node)=>{
     if (!isElement(node)) {
         return [
             node
         ];
     }
+    // must be a table with a single row
     if (node.type !== BLOCKS.TABLE || node.children?.length !== 1) {
         return [
             node
         ];
     }
     const row = node.children[0];
+    // the row must contain a single cell
     if (row?.children?.length !== 1) {
         return [
             node
@@ -23,12 +34,14 @@ const trimUnnecessaryTableWrapper = (node)=>{
     return cell.children;
 };
 export const insertTableFragment = (editor)=>{
-    const { insertFragment  } = editor;
+    const { insertFragment } = editor;
     return (fragments)=>{
         if (!editor.selection) {
             return;
         }
         fragments = fragments.flatMap(trimUnnecessaryTableWrapper);
+        // We need to make sure we have a new, empty and clean paragraph in order to paste tables as-is due to how Slate behaves
+        // More info: https://github.com/ianstormtaylor/slate/pull/4489 and https://github.com/ianstormtaylor/slate/issues/4542
         const isInsertingTable = fragments.some((fragment)=>isTable(fragment));
         const isTableFirstFragment = fragments.findIndex((fragment)=>isTable(fragment)) === 0;
         const currentLineHasText = getText(editor, editor.selection?.focus.path) !== '';

package/dist/esm/plugins/Table/onKeyDownTable.js

@@ -7,8 +7,12 @@ import { addRowBelow } from './actions';
 export const onKeyDownTable = (editor, plugin)=>{
     const defaultHandler = defaultKeyDownTable(editor, plugin);
     return (event)=>{
+        // This fixes `Cannot resolve a Slate point from DOM point:
+        // [object HTMLDivElement]` when typing while the cursor is before table
         const windowSelection = window.getSelection();
         if (windowSelection) {
+            // @ts-expect-error
+            // this attribute comes from `plugins/Table/components/Table.tsx`
             const blockType = windowSelection.anchorNode.attributes?.['data-block-type']?.value;
             const isBeforeTable = blockType === BLOCKS.TABLE;
             if (isBeforeTable) {
@@ -30,10 +34,11 @@ export const onKeyDownTable = (editor, plugin)=>{
                 return;
             }
         }
+        // TODO clean this up
         if (event.key === 'Backspace') {
             const entry = getTableEntries(editor, {});
             if (entry) {
-                const { table , row , cell  } = entry;
+                const { table, row, cell } = entry;
                 const cellText = getText(editor, cell[1]);
                 const isFirstCell = isFirstChild(row[1]);
                 const isFirstRow = isFirstChild(table[1]);
@@ -44,15 +49,18 @@ export const onKeyDownTable = (editor, plugin)=>{
                 }
             }
         }
+        // Pressing Tab on the last cell creates a new row
+        // Otherwise, jumping between cells is handled in the defaultKeyDownTable
         if (event.key === 'Tab' && !event.shiftKey) {
             event.preventDefault();
             const entry = getTableEntries(editor, {});
             if (entry) {
-                const { table , row , cell  } = entry;
+                const { table, row, cell } = entry;
                 const isLastCell = isLastChildPath(row, cell[1]);
                 const isLastRow = isLastChildPath(table, row[1]);
                 if (isLastRow && isLastCell) {
                     addRowBelow(editor);
+                    // skip default handler
                     return;
                 } else {
                     defaultHandler(event);

package/dist/esm/plugins/Table/tableTracking.js

@@ -2,22 +2,22 @@ import { BLOCKS } from '@contentful/rich-text-types';
 import { isElement } from '../../internal/queries';
 import { getPastingSource } from '../../plugins/Tracking';
 function hasTables(nodes) {
-    return nodes.some(({ type  })=>{
+    return nodes.some(({ type })=>{
         return type === BLOCKS.TABLE;
     });
 }
-const isTableHeaderCell = ({ type  })=>type === BLOCKS.TABLE_HEADER_CELL;
+const isTableHeaderCell = ({ type })=>type === BLOCKS.TABLE_HEADER_CELL;
 function hasHeadersOutsideFirstRow(nodes) {
-    return nodes.filter(({ type  })=>type === BLOCKS.TABLE).flatMap(({ children  })=>children.slice(1)).some(({ children  })=>children.some(isTableHeaderCell));
+    return nodes.filter(({ type })=>type === BLOCKS.TABLE).flatMap(({ children })=>children.slice(1)).some(({ children })=>children.some(isTableHeaderCell));
 }
 export function addTableTrackingEvents(editor) {
-    const { insertData  } = editor;
+    const { insertData } = editor;
     editor.insertData = (data)=>{
         const html = data.getData('text/html');
         if (html) {
-            const { children: markupBefore  } = editor;
+            const { children: markupBefore } = editor;
             insertData(data);
-            const { children: markupAfter  } = editor;
+            const { children: markupAfter } = editor;
             setTimeout(()=>{
                 if (hasTables(markupBefore)) return;
                 if (hasTables(markupAfter)) {