@wordpress/block-editor 12.6.0 → 12.8.0

package/build/store/actions.js

@@ -1,7 +1,6 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -33,6 +32,7 @@ exports.resetSelection = resetSelection;
 exports.selectBlock = selectBlock;
 exports.selectPreviousBlock = exports.selectNextBlock = void 0;
 exports.selectionChange = selectionChange;
+exports.setBlockEditingMode = setBlockEditingMode;
 exports.setBlockMovingClientId = void 0;
 exports.setBlockVisibility = setBlockVisibility;
 exports.setHasControlledInnerBlocks = setHasControlledInnerBlocks;
@@ -49,30 +49,21 @@ exports.synchronizeTemplate = void 0;
 exports.toggleBlockHighlight = toggleBlockHighlight;
 exports.toggleBlockMode = toggleBlockMode;
 exports.toggleSelection = toggleSelection;
+exports.unsetBlockEditingMode = unsetBlockEditingMode;
 exports.updateBlock = updateBlock;
 exports.updateBlockAttributes = updateBlockAttributes;
 exports.updateBlockListSettings = updateBlockListSettings;
 exports.updateSettings = updateSettings;
 exports.validateBlocksToTemplate = void 0;
-
 var _blocks = require("@wordpress/blocks");
-
 var _a11y = require("@wordpress/a11y");
-
 var _i18n = require("@wordpress/i18n");
-
 var _richText = require("@wordpress/rich-text");
-
 var _deprecated = _interopRequireDefault(require("@wordpress/deprecated"));
-
 var _utils = require("./utils");
-
 var _selection = require("../utils/selection");
-
 var _privateActions = require("./private-actions");
-
 /* eslint no-console: [ 'error', { allow: [ 'error', 'warn' ] } ] */
-
 /**
  * WordPress dependencies
  */
@@ -82,15 +73,15 @@ var _privateActions = require("./private-actions");
  */
 
 /** @typedef {import('../components/use-on-block-drop/types').WPDropOperation} WPDropOperation */
+
 const castArray = maybeArray => Array.isArray(maybeArray) ? maybeArray : [maybeArray];
+
 /**
  * Action that resets blocks state to the specified array of blocks, taking precedence
  * over any other content reflected as an edit in state.
  *
  * @param {Array} blocks Array of blocks.
  */
-
-
 const resetBlocks = blocks => ({
   dispatch
 }) => {
@@ -100,6 +91,7 @@ const resetBlocks = blocks => ({
   });
   dispatch(validateBlocksToTemplate(blocks));
 };
+
 /**
  * Block validity is a function of blocks state (at the point of a
  * reset) and the template setting. As a compromise to its placement
@@ -108,27 +100,26 @@ const resetBlocks = blocks => ({
  *
  * @param {Array} blocks Array of blocks.
  */
-
-
 exports.resetBlocks = resetBlocks;
-
 const validateBlocksToTemplate = blocks => ({
   select,
   dispatch
 }) => {
   const template = select.getTemplate();
-  const templateLock = select.getTemplateLock(); // Unlocked templates are considered always valid because they act
-  // as default values only.
+  const templateLock = select.getTemplateLock();
 
-  const isBlocksValidToTemplate = !template || templateLock !== 'all' || (0, _blocks.doBlocksMatchTemplate)(blocks, template); // Update if validity has changed.
+  // Unlocked templates are considered always valid because they act
+  // as default values only.
+  const isBlocksValidToTemplate = !template || templateLock !== 'all' || (0, _blocks.doBlocksMatchTemplate)(blocks, template);
 
+  // Update if validity has changed.
   const isValidTemplate = select.isValidTemplate();
-
   if (isBlocksValidToTemplate !== isValidTemplate) {
     dispatch.setTemplateValidity(isBlocksValidToTemplate);
     return isBlocksValidToTemplate;
   }
 };
+
 /**
  * A block selection object.
  *
@@ -150,7 +141,6 @@ const validateBlocksToTemplate = blocks => ({
  */
 
 /* eslint-disable jsdoc/valid-types */
-
 /**
  * Returns an action object used in signalling that selection state should be
  * reset to the specified selection.
@@ -161,10 +151,7 @@ const validateBlocksToTemplate = blocks => ({
  *
  * @return {Object} Action object.
  */
-
-
 exports.validateBlocksToTemplate = validateBlocksToTemplate;
-
 function resetSelection(selectionStart, selectionEnd, initialPosition) {
   /* eslint-enable jsdoc/valid-types */
   return {
@@ -174,6 +161,7 @@ function resetSelection(selectionStart, selectionEnd, initialPosition) {
     initialPosition
   };
 }
+
 /**
  * Returns an action object used in signalling that blocks have been received.
  * Unlike resetBlocks, these should be appended to the existing known set, not
@@ -185,8 +173,6 @@ function resetSelection(selectionStart, selectionEnd, initialPosition) {
  *
  * @return {Object} Action object.
  */
-
-
 function receiveBlocks(blocks) {
   (0, _deprecated.default)('wp.data.dispatch( "core/block-editor" ).receiveBlocks', {
     since: '5.9',
@@ -197,6 +183,7 @@ function receiveBlocks(blocks) {
     blocks
   };
 }
+
 /**
  * Action that updates attributes of multiple blocks with the specified client IDs.
  *
@@ -206,8 +193,6 @@ function receiveBlocks(blocks) {
  * @param {boolean}         uniqueByBlock true if each block in clientIds array has a unique set of attributes
  * @return {Object} Action object.
  */
-
-
 function updateBlockAttributes(clientIds, attributes, uniqueByBlock = false) {
   return {
     type: 'UPDATE_BLOCK_ATTRIBUTES',
@@ -216,6 +201,7 @@ function updateBlockAttributes(clientIds, attributes, uniqueByBlock = false) {
     uniqueByBlock
   };
 }
+
 /**
  * Action that updates the block with the specified client ID.
  *
@@ -224,8 +210,6 @@ function updateBlockAttributes(clientIds, attributes, uniqueByBlock = false) {
  *
  * @return {Object} Action object.
  */
-
-
 function updateBlock(clientId, updates) {
   return {
     type: 'UPDATE_BLOCK',
@@ -233,8 +217,8 @@ function updateBlock(clientId, updates) {
     updates
   };
 }
-/* eslint-disable jsdoc/valid-types */
 
+/* eslint-disable jsdoc/valid-types */
 /**
  * Returns an action object used in signalling that the block with the
  * specified client ID has been selected, optionally accepting a position
@@ -247,8 +231,6 @@ function updateBlock(clientId, updates) {
  *
  * @return {Object} Action object.
  */
-
-
 function selectBlock(clientId, initialPosition = 0) {
   /* eslint-enable jsdoc/valid-types */
   return {
@@ -257,6 +239,7 @@ function selectBlock(clientId, initialPosition = 0) {
     clientId
   };
 }
+
 /**
  * Yields action objects used in signalling that the block preceding the given
  * clientId (or optionally, its first parent from bottom to top)
@@ -265,70 +248,61 @@ function selectBlock(clientId, initialPosition = 0) {
  * @param {string}  clientId         Block client ID.
  * @param {boolean} fallbackToParent If true, select the first parent if there is no previous block.
  */
-
-
 const selectPreviousBlock = (clientId, fallbackToParent = false) => ({
   select,
   dispatch
 }) => {
   const previousBlockClientId = select.getPreviousBlockClientId(clientId);
-
   if (previousBlockClientId) {
     dispatch.selectBlock(previousBlockClientId, -1);
   } else if (fallbackToParent) {
     const firstParentClientId = select.getBlockRootClientId(clientId);
-
     if (firstParentClientId) {
       dispatch.selectBlock(firstParentClientId, -1);
     }
   }
 };
+
 /**
  * Yields action objects used in signalling that the block following the given
  * clientId should be selected.
  *
  * @param {string} clientId Block client ID.
  */
-
-
 exports.selectPreviousBlock = selectPreviousBlock;
-
 const selectNextBlock = clientId => ({
   select,
   dispatch
 }) => {
   const nextBlockClientId = select.getNextBlockClientId(clientId);
-
   if (nextBlockClientId) {
     dispatch.selectBlock(nextBlockClientId);
   }
 };
+
 /**
  * Action that starts block multi-selection.
  *
  * @return {Object} Action object.
  */
-
-
 exports.selectNextBlock = selectNextBlock;
-
 function startMultiSelect() {
   return {
     type: 'START_MULTI_SELECT'
   };
 }
+
 /**
  * Action that stops block multi-selection.
  *
  * @return {Object} Action object.
  */
-
-
 function stopMultiSelect() {
   return {
     type: 'STOP_MULTI_SELECT'
   };
 }
+
 /**
  * Action that changes block multi-selection.
  *
@@ -336,19 +310,17 @@ function stopMultiSelect() {
  * @param {string}      end                           Last block of the multiselection.
  * @param {number|null} __experimentalInitialPosition Optional initial position. Pass as null to skip focus within editor canvas.
  */
-
-
 const multiSelect = (start, end, __experimentalInitialPosition = 0) => ({
   select,
   dispatch
 }) => {
   const startBlockRootClientId = select.getBlockRootClientId(start);
-  const endBlockRootClientId = select.getBlockRootClientId(end); // Only allow block multi-selections at the same level.
+  const endBlockRootClientId = select.getBlockRootClientId(end);
 
+  // Only allow block multi-selections at the same level.
   if (startBlockRootClientId !== endBlockRootClientId) {
     return;
   }
-
   dispatch({
     type: 'MULTI_SELECT',
     start,
@@ -356,24 +328,22 @@ const multiSelect = (start, end, __experimentalInitialPosition = 0) => ({
     initialPosition: __experimentalInitialPosition
   });
   const blockCount = select.getSelectedBlockCount();
-  (0, _a11y.speak)((0, _i18n.sprintf)(
-  /* translators: %s: number of selected blocks */
+  (0, _a11y.speak)((0, _i18n.sprintf)( /* translators: %s: number of selected blocks */
   (0, _i18n._n)('%s block selected.', '%s blocks selected.', blockCount), blockCount), 'assertive');
 };
+
 /**
  * Action that clears the block selection.
  *
  * @return {Object} Action object.
  */
-
-
 exports.multiSelect = multiSelect;
-
 function clearSelectedBlock() {
   return {
     type: 'CLEAR_SELECTED_BLOCK'
   };
 }
+
 /**
  * Action that enables or disables block selection.
  *
@@ -382,49 +352,42 @@ function clearSelectedBlock() {
  *
  * @return {Object} Action object.
  */
-
-
 function toggleSelection(isSelectionEnabled = true) {
   return {
     type: 'TOGGLE_SELECTION',
     isSelectionEnabled
   };
 }
-
 function getBlocksWithDefaultStylesApplied(blocks, blockEditorSettings) {
   var _blockEditorSettings$;
-
   const preferredStyleVariations = (_blockEditorSettings$ = blockEditorSettings?.__experimentalPreferredStyleVariations?.value) !== null && _blockEditorSettings$ !== void 0 ? _blockEditorSettings$ : {};
   return blocks.map(block => {
     const blockName = block.name;
-
     if (!(0, _blocks.hasBlockSupport)(blockName, 'defaultStylePicker', true)) {
       return block;
     }
-
     if (!preferredStyleVariations[blockName]) {
       return block;
     }
-
     const className = block.attributes?.className;
-
     if (className?.includes('is-style-')) {
       return block;
     }
-
     const {
       attributes = {}
     } = block;
     const blockStyle = preferredStyleVariations[blockName];
-    return { ...block,
-      attributes: { ...attributes,
+    return {
+      ...block,
+      attributes: {
+        ...attributes,
         className: `${className || ''} is-style-${blockStyle}`.trim()
       }
     };
   });
 }
-/* eslint-disable jsdoc/valid-types */
 
+/* eslint-disable jsdoc/valid-types */
 /**
  * Action that replaces given blocks with one or more replacement blocks.
  *
@@ -436,8 +399,6 @@ function getBlocksWithDefaultStylesApplied(blocks, blockEditorSettings) {
  *
  * @return {Object} Action object.
  */
-
-
 const replaceBlocks = (clientIds, blocks, indexToSelect, initialPosition = 0, meta) => ({
   select,
   dispatch
@@ -445,17 +406,15 @@ const replaceBlocks = (clientIds, blocks, indexToSelect, initialPosition = 0, me
   /* eslint-enable jsdoc/valid-types */
   clientIds = castArray(clientIds);
   blocks = getBlocksWithDefaultStylesApplied(castArray(blocks), select.getSettings());
-  const rootClientId = select.getBlockRootClientId(clientIds[0]); // Replace is valid if the new blocks can be inserted in the root block.
-
+  const rootClientId = select.getBlockRootClientId(clientIds[0]);
+  // Replace is valid if the new blocks can be inserted in the root block.
   for (let index = 0; index < blocks.length; index++) {
     const block = blocks[index];
     const canInsertBlock = select.canInsertBlockType(block.name, rootClientId);
-
     if (!canInsertBlock) {
       return;
     }
   }
-
   dispatch({
     type: 'REPLACE_BLOCKS',
     clientIds,
@@ -467,6 +426,7 @@ const replaceBlocks = (clientIds, blocks, indexToSelect, initialPosition = 0, me
   });
   dispatch.ensureDefaultBlock();
 };
+
 /**
  * Action that replaces a single block with one or more replacement blocks.
  *
@@ -475,13 +435,11 @@ const replaceBlocks = (clientIds, blocks, indexToSelect, initialPosition = 0, me
  *
  * @return {Object} Action object.
  */
-
-
 exports.replaceBlocks = replaceBlocks;
-
 function replaceBlock(clientId, block) {
   return replaceBlocks(clientId, block);
 }
+
 /**
  * Higher-order action creator which, given the action type to dispatch creates
  * an action creator for managing block movement.
@@ -490,29 +448,25 @@ function replaceBlock(clientId, block) {
  *
  * @return {Function} Action creator.
  */
-
-
 const createOnMove = type => (clientIds, rootClientId) => ({
   select,
   dispatch
 }) => {
   // If one of the blocks is locked or the parent is locked, we cannot move any block.
   const canMoveBlocks = select.canMoveBlocks(clientIds, rootClientId);
-
   if (!canMoveBlocks) {
     return;
   }
-
   dispatch({
     type,
     clientIds: castArray(clientIds),
     rootClientId
   });
 };
-
 const moveBlocksDown = createOnMove('MOVE_BLOCKS_DOWN');
 exports.moveBlocksDown = moveBlocksDown;
 const moveBlocksUp = createOnMove('MOVE_BLOCKS_UP');
+
 /**
  * Action that moves given blocks to a new position.
  *
@@ -521,35 +475,34 @@ const moveBlocksUp = createOnMove('MOVE_BLOCKS_UP');
  * @param {?string} toRootClientId   Root client ID destination.
  * @param {number}  index            The index to move the blocks to.
  */
-
 exports.moveBlocksUp = moveBlocksUp;
-
 const moveBlocksToPosition = (clientIds, fromRootClientId = '', toRootClientId = '', index) => ({
   select,
   dispatch
 }) => {
-  const canMoveBlocks = select.canMoveBlocks(clientIds, fromRootClientId); // If one of the blocks is locked or the parent is locked, we cannot move any block.
+  const canMoveBlocks = select.canMoveBlocks(clientIds, fromRootClientId);
 
+  // If one of the blocks is locked or the parent is locked, we cannot move any block.
   if (!canMoveBlocks) {
     return;
-  } // If moving inside the same root block the move is always possible.
-
+  }
 
+  // If moving inside the same root block the move is always possible.
   if (fromRootClientId !== toRootClientId) {
-    const canRemoveBlocks = select.canRemoveBlocks(clientIds, fromRootClientId); // If we're moving to another block, it means we're deleting blocks from
-    // the original block, so we need to check if removing is possible.
+    const canRemoveBlocks = select.canRemoveBlocks(clientIds, fromRootClientId);
 
+    // If we're moving to another block, it means we're deleting blocks from
+    // the original block, so we need to check if removing is possible.
     if (!canRemoveBlocks) {
       return;
     }
+    const canInsertBlocks = select.canInsertBlocks(clientIds, toRootClientId);
 
-    const canInsertBlocks = select.canInsertBlocks(clientIds, toRootClientId); // If moving to other parent block, the move is possible if we can insert a block of the same type inside the new parent block.
-
+    // If moving to other parent block, the move is possible if we can insert a block of the same type inside the new parent block.
     if (!canInsertBlocks) {
       return;
     }
   }
-
   dispatch({
     type: 'MOVE_BLOCKS_TO_POSITION',
     fromRootClientId,
@@ -558,6 +511,7 @@ const moveBlocksToPosition = (clientIds, fromRootClientId = '', toRootClientId =
     index
   });
 };
+
 /**
  * Action that moves given block to a new position.
  *
@@ -566,13 +520,11 @@ const moveBlocksToPosition = (clientIds, fromRootClientId = '', toRootClientId =
  * @param {?string} toRootClientId   Root client ID destination.
  * @param {number}  index            The index to move the block to.
  */
-
-
 exports.moveBlocksToPosition = moveBlocksToPosition;
-
 function moveBlockToPosition(clientId, fromRootClientId = '', toRootClientId = '', index) {
   return moveBlocksToPosition([clientId], fromRootClientId, toRootClientId, index);
 }
+
 /**
  * Action that inserts a single block, optionally at a specific index respective a root block list.
  *
@@ -587,13 +539,11 @@ function moveBlockToPosition(clientId, fromRootClientId = '', toRootClientId = '
  *
  * @return {Object} Action object.
  */
-
-
 function insertBlock(block, index, rootClientId, updateSelection, meta) {
   return insertBlocks([block], index, rootClientId, updateSelection, 0, meta);
 }
-/* eslint-disable jsdoc/valid-types */
 
+/* eslint-disable jsdoc/valid-types */
 /**
  * Action that inserts an array of blocks, optionally at a specific index respective a root block list.
  *
@@ -609,8 +559,6 @@ function insertBlock(block, index, rootClientId, updateSelection, meta) {
  *
  * @return {Object} Action object.
  */
-
-
 const insertBlocks = (blocks, index, rootClientId, updateSelection = true, initialPosition = 0, meta) => ({
   select,
   dispatch
@@ -624,18 +572,14 @@ const insertBlocks = (blocks, index, rootClientId, updateSelection = true, initi
       hint: 'The meta argument is now the 6th argument of the function'
     });
   }
-
   blocks = getBlocksWithDefaultStylesApplied(castArray(blocks), select.getSettings());
   const allowedBlocks = [];
-
   for (const block of blocks) {
     const isValid = select.canInsertBlockType(block.name, rootClientId);
-
     if (isValid) {
       allowedBlocks.push(block);
     }
   }
-
   if (allowedBlocks.length) {
     dispatch({
       type: 'INSERT_BLOCKS',
@@ -649,6 +593,7 @@ const insertBlocks = (blocks, index, rootClientId, updateSelection = true, initi
     });
   }
 };
+
 /**
  * Action that shows the insertion point.
  *
@@ -662,10 +607,7 @@ const insertBlocks = (blocks, index, rootClientId, updateSelection = true, initi
  *
  * @return {Object} Action object.
  */
-
-
 exports.insertBlocks = insertBlocks;
-
 function showInsertionPoint(rootClientId, index, __unstableOptions = {}) {
   const {
     __unstableWithInserter,
@@ -682,8 +624,6 @@ function showInsertionPoint(rootClientId, index, __unstableOptions = {}) {
 /**
  * Action that hides the insertion point.
  */
-
-
 const hideInsertionPoint = () => ({
   select,
   dispatch
@@ -691,11 +631,11 @@ const hideInsertionPoint = () => ({
   if (!select.isBlockInsertionPointVisible()) {
     return;
   }
-
   dispatch({
     type: 'HIDE_INSERTION_POINT'
   });
 };
+
 /**
  * Action that resets the template validity.
  *
@@ -703,23 +643,19 @@ const hideInsertionPoint = () => ({
  *
  * @return {Object} Action object.
  */
-
-
 exports.hideInsertionPoint = hideInsertionPoint;
-
 function setTemplateValidity(isValid) {
   return {
     type: 'SET_TEMPLATE_VALIDITY',
     isValid
   };
 }
+
 /**
  * Action that synchronizes the template with the list of blocks.
  *
  * @return {Object} Action object.
  */
-
-
 const synchronizeTemplate = () => ({
   select,
   dispatch
@@ -732,15 +668,13 @@ const synchronizeTemplate = () => ({
   const updatedBlockList = (0, _blocks.synchronizeBlocksWithTemplate)(blocks, template);
   dispatch.resetBlocks(updatedBlockList);
 };
+
 /**
  * Delete the current selection.
  *
  * @param {boolean} isForward
  */
-
-
 exports.synchronizeTemplate = synchronizeTemplate;
-
 const __unstableDeleteSelection = isForward => ({
   registry,
   select,
@@ -748,23 +682,24 @@ const __unstableDeleteSelection = isForward => ({
 }) => {
   const selectionAnchor = select.getSelectionStart();
   const selectionFocus = select.getSelectionEnd();
-  if (selectionAnchor.clientId === selectionFocus.clientId) return; // It's not mergeable if there's no rich text selection.
+  if (selectionAnchor.clientId === selectionFocus.clientId) return;
 
+  // It's not mergeable if there's no rich text selection.
   if (!selectionAnchor.attributeKey || !selectionFocus.attributeKey || typeof selectionAnchor.offset === 'undefined' || typeof selectionFocus.offset === 'undefined') return false;
   const anchorRootClientId = select.getBlockRootClientId(selectionAnchor.clientId);
-  const focusRootClientId = select.getBlockRootClientId(selectionFocus.clientId); // It's not mergeable if the selection doesn't start and end in the same
-  // block list. Maybe in the future it should be allowed.
+  const focusRootClientId = select.getBlockRootClientId(selectionFocus.clientId);
 
+  // It's not mergeable if the selection doesn't start and end in the same
+  // block list. Maybe in the future it should be allowed.
   if (anchorRootClientId !== focusRootClientId) {
     return;
   }
-
   const blockOrder = select.getBlockOrder(anchorRootClientId);
   const anchorIndex = blockOrder.indexOf(selectionAnchor.clientId);
-  const focusIndex = blockOrder.indexOf(selectionFocus.clientId); // Reassign selection start and end based on order.
+  const focusIndex = blockOrder.indexOf(selectionFocus.clientId);
 
+  // Reassign selection start and end based on order.
   let selectionStart, selectionEnd;
-
   if (anchorIndex > focusIndex) {
     selectionStart = selectionFocus;
     selectionEnd = selectionAnchor;
@@ -772,15 +707,12 @@ const __unstableDeleteSelection = isForward => ({
     selectionStart = selectionAnchor;
     selectionEnd = selectionFocus;
   }
-
   const targetSelection = isForward ? selectionEnd : selectionStart;
   const targetBlock = select.getBlock(targetSelection.clientId);
   const targetBlockType = (0, _blocks.getBlockType)(targetBlock.name);
-
   if (!targetBlockType.merge) {
     return;
   }
-
   const selectionA = selectionStart;
   const selectionB = selectionEnd;
   const blockA = select.getBlock(selectionA.clientId);
@@ -800,8 +732,9 @@ const __unstableDeleteSelection = isForward => ({
     ...(0, _utils.mapRichTextSettings)(attributeDefinitionB)
   });
   valueA = (0, _richText.remove)(valueA, selectionA.offset, valueA.text.length);
-  valueB = (0, _richText.insert)(valueB, _selection.START_OF_SELECTED_AREA, 0, selectionB.offset); // Clone the blocks so we don't manipulate the original.
+  valueB = (0, _richText.insert)(valueB, _selection.START_OF_SELECTED_AREA, 0, selectionB.offset);
 
+  // Clone the blocks so we don't manipulate the original.
   const cloneA = (0, _blocks.cloneBlock)(blockA, {
     [selectionA.attributeKey]: (0, _richText.toHTMLString)({
       value: valueA,
@@ -814,17 +747,17 @@ const __unstableDeleteSelection = isForward => ({
       ...(0, _utils.mapRichTextSettings)(attributeDefinitionB)
     })
   });
-  const followingBlock = isForward ? cloneA : cloneB; // We can only merge blocks with similar types
-  // thus, we transform the block to merge first
+  const followingBlock = isForward ? cloneA : cloneB;
 
-  const blocksWithTheSameType = blockA.name === blockB.name ? [followingBlock] : (0, _blocks.switchToBlockType)(followingBlock, targetBlockType.name); // If the block types can not match, do nothing
+  // We can only merge blocks with similar types
+  // thus, we transform the block to merge first
+  const blocksWithTheSameType = blockA.name === blockB.name ? [followingBlock] : (0, _blocks.switchToBlockType)(followingBlock, targetBlockType.name);
 
+  // If the block types can not match, do nothing
   if (!blocksWithTheSameType || !blocksWithTheSameType.length) {
     return;
   }
-
   let updatedAttributes;
-
   if (isForward) {
     const blockToMerge = blocksWithTheSameType.pop();
     updatedAttributes = targetBlockType.merge(blockToMerge.attributes, cloneB.attributes);
@@ -832,7 +765,6 @@ const __unstableDeleteSelection = isForward => ({
     const blockToMerge = blocksWithTheSameType.shift();
     updatedAttributes = targetBlockType.merge(cloneA.attributes, blockToMerge.attributes);
   }
-
   const newAttributeKey = (0, _selection.retrieveSelectedAttribute)(updatedAttributes);
   const convertedHtml = updatedAttributes[newAttributeKey];
   const convertedValue = (0, _richText.create)({
@@ -847,48 +779,50 @@ const __unstableDeleteSelection = isForward => ({
   });
   updatedAttributes[newAttributeKey] = newHtml;
   const selectedBlockClientIds = select.getSelectedBlockClientIds();
-  const replacement = [...(isForward ? blocksWithTheSameType : []), { // Preserve the original client ID.
+  const replacement = [...(isForward ? blocksWithTheSameType : []), {
+    // Preserve the original client ID.
     ...targetBlock,
-    attributes: { ...targetBlock.attributes,
+    attributes: {
+      ...targetBlock.attributes,
       ...updatedAttributes
     }
   }, ...(isForward ? [] : blocksWithTheSameType)];
   registry.batch(() => {
     dispatch.selectionChange(targetBlock.clientId, newAttributeKey, newOffset, newOffset);
-    dispatch.replaceBlocks(selectedBlockClientIds, replacement, 0, // If we don't pass the `indexToSelect` it will default to the last block.
+    dispatch.replaceBlocks(selectedBlockClientIds, replacement, 0,
+    // If we don't pass the `indexToSelect` it will default to the last block.
     select.getSelectedBlocksInitialCaretPosition());
   });
 };
+
 /**
  * Split the current selection.
  */
-
-
 exports.__unstableDeleteSelection = __unstableDeleteSelection;
-
 const __unstableSplitSelection = () => ({
   select,
   dispatch
 }) => {
   const selectionAnchor = select.getSelectionStart();
   const selectionFocus = select.getSelectionEnd();
-  if (selectionAnchor.clientId === selectionFocus.clientId) return; // Can't split if the selection is not set.
+  if (selectionAnchor.clientId === selectionFocus.clientId) return;
 
+  // Can't split if the selection is not set.
   if (!selectionAnchor.attributeKey || !selectionFocus.attributeKey || typeof selectionAnchor.offset === 'undefined' || typeof selectionFocus.offset === 'undefined') return;
   const anchorRootClientId = select.getBlockRootClientId(selectionAnchor.clientId);
-  const focusRootClientId = select.getBlockRootClientId(selectionFocus.clientId); // It's not splittable if the selection doesn't start and end in the same
-  // block list. Maybe in the future it should be allowed.
+  const focusRootClientId = select.getBlockRootClientId(selectionFocus.clientId);
 
+  // It's not splittable if the selection doesn't start and end in the same
+  // block list. Maybe in the future it should be allowed.
   if (anchorRootClientId !== focusRootClientId) {
     return;
   }
-
   const blockOrder = select.getBlockOrder(anchorRootClientId);
   const anchorIndex = blockOrder.indexOf(selectionAnchor.clientId);
-  const focusIndex = blockOrder.indexOf(selectionFocus.clientId); // Reassign selection start and end based on order.
+  const focusIndex = blockOrder.indexOf(selectionFocus.clientId);
 
+  // Reassign selection start and end based on order.
   let selectionStart, selectionEnd;
-
   if (anchorIndex > focusIndex) {
     selectionStart = selectionFocus;
     selectionEnd = selectionAnchor;
@@ -896,7 +830,6 @@ const __unstableSplitSelection = () => ({
     selectionStart = selectionAnchor;
     selectionEnd = selectionFocus;
   }
-
   const selectionA = selectionStart;
   const selectionB = selectionEnd;
   const blockA = select.getBlock(selectionA.clientId);
@@ -917,32 +850,33 @@ const __unstableSplitSelection = () => ({
   });
   valueA = (0, _richText.remove)(valueA, selectionA.offset, valueA.text.length);
   valueB = (0, _richText.remove)(valueB, 0, selectionB.offset);
-  dispatch.replaceBlocks(select.getSelectedBlockClientIds(), [{ // Preserve the original client ID.
+  dispatch.replaceBlocks(select.getSelectedBlockClientIds(), [{
+    // Preserve the original client ID.
     ...blockA,
-    attributes: { ...blockA.attributes,
+    attributes: {
+      ...blockA.attributes,
       [selectionA.attributeKey]: (0, _richText.toHTMLString)({
         value: valueA,
         ...(0, _utils.mapRichTextSettings)(attributeDefinitionA)
       })
     }
-  }, (0, _blocks.createBlock)((0, _blocks.getDefaultBlockName)()), { // Preserve the original client ID.
+  }, {
+    // Preserve the original client ID.
     ...blockB,
-    attributes: { ...blockB.attributes,
+    attributes: {
+      ...blockB.attributes,
       [selectionB.attributeKey]: (0, _richText.toHTMLString)({
         value: valueB,
         ...(0, _utils.mapRichTextSettings)(attributeDefinitionB)
       })
     }
-  }], 1, // If we don't pass the `indexToSelect` it will default to the last block.
-  select.getSelectedBlocksInitialCaretPosition());
+  }]);
 };
+
 /**
  * Expand the selection to cover the entire blocks, removing partial selection.
  */
-
-
 exports.__unstableSplitSelection = __unstableSplitSelection;
-
 const __unstableExpandSelection = () => ({
   select,
   dispatch
@@ -958,16 +892,14 @@ const __unstableExpandSelection = () => ({
     }
   });
 };
+
 /**
  * Action that merges two blocks.
  *
  * @param {string} firstBlockClientId  Client ID of the first block to merge.
  * @param {string} secondBlockClientId Client ID of the second block to merge.
  */
-
-
 exports.__unstableExpandSelection = __unstableExpandSelection;
-
 const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
   registry,
   select,
@@ -982,25 +914,25 @@ const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
   const blockA = select.getBlock(clientIdA);
   const blockAType = (0, _blocks.getBlockType)(blockA.name);
   if (!blockAType) return;
+  if (!blockAType.merge && !(0, _blocks.getBlockSupport)(blockA.name, '__experimentalOnMerge')) {
+    dispatch.selectBlock(blockA.clientId);
+    return;
+  }
   const blockB = select.getBlock(clientIdB);
-
-  if (blockAType && !blockAType.merge) {
+  if (!blockAType.merge) {
     // If there's no merge function defined, attempt merging inner
     // blocks.
-    const blocksWithTheSameType = (0, _blocks.switchToBlockType)(blockB, blockAType.name); // Only focus the previous block if it's not mergeable.
-
+    const blocksWithTheSameType = (0, _blocks.switchToBlockType)(blockB, blockAType.name);
+    // Only focus the previous block if it's not mergeable.
     if (blocksWithTheSameType?.length !== 1) {
       dispatch.selectBlock(blockA.clientId);
       return;
     }
-
     const [blockWithSameType] = blocksWithTheSameType;
-
     if (blockWithSameType.innerBlocks.length < 1) {
       dispatch.selectBlock(blockA.clientId);
       return;
     }
-
     registry.batch(() => {
       dispatch.insertBlocks(blockWithSameType.innerBlocks, undefined, clientIdA);
       dispatch.removeBlock(clientIdB);
@@ -1008,7 +940,6 @@ const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
     });
     return;
   }
-
   const blockBType = (0, _blocks.getBlockType)(blockB.name);
   const {
     clientId,
@@ -1017,24 +948,23 @@ const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
   } = select.getSelectionStart();
   const selectedBlockType = clientId === clientIdA ? blockAType : blockBType;
   const attributeDefinition = selectedBlockType.attributes[attributeKey];
-  const canRestoreTextSelection = (clientId === clientIdA || clientId === clientIdB) && attributeKey !== undefined && offset !== undefined && // We cannot restore text selection if the RichText identifier
+  const canRestoreTextSelection = (clientId === clientIdA || clientId === clientIdB) && attributeKey !== undefined && offset !== undefined &&
+  // We cannot restore text selection if the RichText identifier
   // is not a defined block attribute key. This can be the case if the
   // fallback intance ID is used to store selection (and no RichText
   // identifier is set), or when the identifier is wrong.
   !!attributeDefinition;
-
   if (!attributeDefinition) {
     if (typeof attributeKey === 'number') {
       window.console.error(`RichText needs an identifier prop that is the block attribute key of the attribute it controls. Its type is expected to be a string, but was ${typeof attributeKey}`);
     } else {
       window.console.error('The RichText identifier prop does not match any attributes defined by the block.');
     }
-  } // Clone the blocks so we don't insert the character in a "live" block.
-
+  }
 
+  // Clone the blocks so we don't insert the character in a "live" block.
   const cloneA = (0, _blocks.cloneBlock)(blockA);
   const cloneB = (0, _blocks.cloneBlock)(blockB);
-
   if (canRestoreTextSelection) {
     const selectedBlock = clientId === clientIdA ? cloneA : cloneB;
     const html = selectedBlock.attributes[attributeKey];
@@ -1046,19 +976,19 @@ const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
       value,
       ...(0, _utils.mapRichTextSettings)(attributeDefinition)
     });
-  } // We can only merge blocks with similar types
-  // thus, we transform the block to merge first.
-
+  }
 
-  const blocksWithTheSameType = blockA.name === blockB.name ? [cloneB] : (0, _blocks.switchToBlockType)(cloneB, blockA.name); // If the block types can not match, do nothing.
+  // We can only merge blocks with similar types
+  // thus, we transform the block to merge first.
+  const blocksWithTheSameType = blockA.name === blockB.name ? [cloneB] : (0, _blocks.switchToBlockType)(cloneB, blockA.name);
 
+  // If the block types can not match, do nothing.
   if (!blocksWithTheSameType || !blocksWithTheSameType.length) {
     return;
-  } // Calling the merge to update the attributes and remove the block to be merged.
-
+  }
 
+  // Calling the merge to update the attributes and remove the block to be merged.
   const updatedAttributes = blockAType.merge(cloneA.attributes, blocksWithTheSameType[0].attributes);
-
   if (canRestoreTextSelection) {
     const newAttributeKey = (0, _selection.retrieveSelectedAttribute)(updatedAttributes);
     const convertedHtml = updatedAttributes[newAttributeKey];
@@ -1075,14 +1005,16 @@ const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
     updatedAttributes[newAttributeKey] = newHtml;
     dispatch.selectionChange(blockA.clientId, newAttributeKey, newOffset, newOffset);
   }
-
-  dispatch.replaceBlocks([blockA.clientId, blockB.clientId], [{ ...blockA,
-    attributes: { ...blockA.attributes,
+  dispatch.replaceBlocks([blockA.clientId, blockB.clientId], [{
+    ...blockA,
+    attributes: {
+      ...blockA.attributes,
       ...updatedAttributes
     }
   }, ...blocksWithTheSameType.slice(1)], 0 // If we don't pass the `indexToSelect` it will default to the last block.
   );
 };
+
 /**
  * Yields action objects used in signalling that the blocks corresponding to
  * the set of specified client IDs are to be removed.
@@ -1094,11 +1026,9 @@ const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
  *                                         should be selected
  *                                         when a block is removed.
  */
-
-
 exports.mergeBlocks = mergeBlocks;
-
 const removeBlocks = (clientIds, selectPrevious = true) => (0, _privateActions.privateRemoveBlocks)(clientIds, selectPrevious);
+
 /**
  * Returns an action object used in signalling that the block with the
  * specified client ID is to be removed.
@@ -1109,15 +1039,12 @@ const removeBlocks = (clientIds, selectPrevious = true) => (0, _privateActions.p
  *
  * @return {Object} Action object.
  */
-
-
 exports.removeBlocks = removeBlocks;
-
 function removeBlock(clientId, selectPrevious) {
   return removeBlocks([clientId], selectPrevious);
 }
-/* eslint-disable jsdoc/valid-types */
 
+/* eslint-disable jsdoc/valid-types */
 /**
  * Returns an action object used in signalling that the inner blocks with the
  * specified client ID should be replaced.
@@ -1128,8 +1055,6 @@ function removeBlock(clientId, selectPrevious) {
  * @param {0|-1|null} initialPosition Initial block position.
  * @return {Object} Action object.
  */
-
-
 function replaceInnerBlocks(rootClientId, blocks, updateSelection = false, initialPosition = 0) {
   /* eslint-enable jsdoc/valid-types */
   return {
@@ -1141,6 +1066,7 @@ function replaceInnerBlocks(rootClientId, blocks, updateSelection = false, initi
     time: Date.now()
   };
 }
+
 /**
  * Returns an action object used to toggle the block editing mode between
  * visual and HTML modes.
@@ -1149,38 +1075,35 @@ function replaceInnerBlocks(rootClientId, blocks, updateSelection = false, initi
  *
  * @return {Object} Action object.
  */
-
-
 function toggleBlockMode(clientId) {
   return {
     type: 'TOGGLE_BLOCK_MODE',
     clientId
   };
 }
+
 /**
  * Returns an action object used in signalling that the user has begun to type.
  *
  * @return {Object} Action object.
  */
-
-
 function startTyping() {
   return {
     type: 'START_TYPING'
   };
 }
+
 /**
  * Returns an action object used in signalling that the user has stopped typing.
  *
  * @return {Object} Action object.
  */
-
-
 function stopTyping() {
   return {
     type: 'STOP_TYPING'
   };
 }
+
 /**
  * Returns an action object used in signalling that the user has begun to drag blocks.
  *
@@ -1188,26 +1111,24 @@ function stopTyping() {
  *
  * @return {Object} Action object.
  */
-
-
 function startDraggingBlocks(clientIds = []) {
   return {
     type: 'START_DRAGGING_BLOCKS',
     clientIds
   };
 }
+
 /**
  * Returns an action object used in signalling that the user has stopped dragging blocks.
  *
  * @return {Object} Action object.
  */
-
-
 function stopDraggingBlocks() {
   return {
     type: 'STOP_DRAGGING_BLOCKS'
   };
 }
+
 /**
  * Returns an action object used in signalling that the caret has entered formatted text.
  *
@@ -1215,8 +1136,6 @@ function stopDraggingBlocks() {
  *
  * @return {Object} Action object.
  */
-
-
 function enterFormattedText() {
   (0, _deprecated.default)('wp.data.dispatch( "core/block-editor" ).enterFormattedText', {
     since: '6.1',
@@ -1226,6 +1145,7 @@ function enterFormattedText() {
     type: 'DO_NOTHING'
   };
 }
+
 /**
  * Returns an action object used in signalling that the user caret has exited formatted text.
  *
@@ -1233,8 +1153,6 @@ function enterFormattedText() {
  *
  * @return {Object} Action object.
  */
-
-
 function exitFormattedText() {
   (0, _deprecated.default)('wp.data.dispatch( "core/block-editor" ).exitFormattedText', {
     since: '6.1',
@@ -1244,6 +1162,7 @@ function exitFormattedText() {
     type: 'DO_NOTHING'
   };
 }
+
 /**
  * Action that changes the position of the user caret.
  *
@@ -1254,8 +1173,6 @@ function exitFormattedText() {
  *
  * @return {Object} Action object.
  */
-
-
 function selectionChange(clientId, attributeKey, startOffset, endOffset) {
   if (typeof clientId === 'string') {
     return {
@@ -1266,12 +1183,12 @@ function selectionChange(clientId, attributeKey, startOffset, endOffset) {
       endOffset
     };
   }
-
   return {
     type: 'SELECTION_CHANGE',
     ...clientId
   };
 }
+
 /**
  * Action that adds a new block of the default type to the block list.
  *
@@ -1280,21 +1197,18 @@ function selectionChange(clientId, attributeKey, startOffset, endOffset) {
  *                               to append.
  * @param {?number} index        Optional index where to insert the default block.
  */
-
-
 const insertDefaultBlock = (attributes, rootClientId, index) => ({
   dispatch
 }) => {
   // Abort if there is no default block type (if it has been unregistered).
   const defaultBlockName = (0, _blocks.getDefaultBlockName)();
-
   if (!defaultBlockName) {
     return;
   }
-
   const block = (0, _blocks.createBlock)(defaultBlockName, attributes);
   return dispatch.insertBlock(block, index, rootClientId);
 };
+
 /**
  * Action that changes the nested settings of a given block.
  *
@@ -1304,10 +1218,7 @@ const insertDefaultBlock = (attributes, rootClientId, index) => ({
  *
  * @return {Object} Action object
  */
-
-
 exports.insertDefaultBlock = insertDefaultBlock;
-
 function updateBlockListSettings(clientId, settings) {
   return {
     type: 'UPDATE_BLOCK_LIST_SETTINGS',
@@ -1315,6 +1226,7 @@ function updateBlockListSettings(clientId, settings) {
     settings
   };
 }
+
 /**
  * Action that updates the block editor settings.
  *
@@ -1322,13 +1234,12 @@ function updateBlockListSettings(clientId, settings) {
  *
  * @return {Object} Action object
  */
-
-
 function updateSettings(settings) {
   return (0, _privateActions.__experimentalUpdateSettings)(settings, {
     stripExperimentalSettings: true
   });
 }
+
 /**
  * Action that signals that a temporary reusable block has been saved
  * in order to switch its temporary id with the real id.
@@ -1338,8 +1249,6 @@ function updateSettings(settings) {
  *
  * @return {Object} Action object.
  */
-
-
 function __unstableSaveReusableBlock(id, updatedId) {
   return {
     type: 'SAVE_REUSABLE_BLOCK_SUCCESS',
@@ -1347,30 +1256,29 @@ function __unstableSaveReusableBlock(id, updatedId) {
     updatedId
   };
 }
+
 /**
  * Action that marks the last block change explicitly as persistent.
  *
  * @return {Object} Action object.
  */
-
-
 function __unstableMarkLastChangeAsPersistent() {
   return {
     type: 'MARK_LAST_CHANGE_AS_PERSISTENT'
   };
 }
+
 /**
  * Action that signals that the next block change should be marked explicitly as not persistent.
  *
  * @return {Object} Action object.
  */
-
-
 function __unstableMarkNextChangeAsNotPersistent() {
   return {
     type: 'MARK_NEXT_CHANGE_AS_NOT_PERSISTENT'
   };
 }
+
 /**
  * Action that marks the last block change as an automatic change, meaning it was not
  * performed by the user, and can be undone using the `Escape` and `Backspace` keys.
@@ -1378,8 +1286,6 @@ function __unstableMarkNextChangeAsNotPersistent() {
  * consequence of it, so it is recommended to be called at the next idle period to ensure all
  * selection changes have been recorded.
  */
-
-
 const __unstableMarkAutomaticChange = () => ({
   dispatch
 }) => {
@@ -1395,29 +1301,25 @@ const __unstableMarkAutomaticChange = () => ({
     });
   });
 };
+
 /**
  * Action that enables or disables the navigation mode.
  *
  * @param {boolean} isNavigationMode Enable/Disable navigation mode.
  */
-
-
 exports.__unstableMarkAutomaticChange = __unstableMarkAutomaticChange;
-
 const setNavigationMode = (isNavigationMode = true) => ({
   dispatch
 }) => {
   dispatch.__unstableSetEditorMode(isNavigationMode ? 'navigation' : 'edit');
 };
+
 /**
  * Action that sets the editor mode
  *
  * @param {string} mode Editor mode
  */
-
-
 exports.setNavigationMode = setNavigationMode;
-
 const __unstableSetEditorMode = mode => ({
   dispatch,
   select
@@ -1425,17 +1327,14 @@ const __unstableSetEditorMode = mode => ({
   // When switching to zoom-out mode, we need to select the root block
   if (mode === 'zoom-out') {
     const firstSelectedClientId = select.getBlockSelectionStart();
-
     if (firstSelectedClientId) {
       dispatch.selectBlock(select.getBlockHierarchyRootClientId(firstSelectedClientId));
     }
   }
-
   dispatch({
     type: 'SET_EDITOR_MODE',
     mode
   });
-
   if (mode === 'navigation') {
     (0, _a11y.speak)((0, _i18n.__)('You are currently in navigation mode. Navigate blocks using the Tab key and Arrow keys. Use Left and Right Arrow keys to move between nesting levels. To exit navigation mode and edit the selected block, press Enter.'));
   } else if (mode === 'edit') {
@@ -1444,15 +1343,13 @@ const __unstableSetEditorMode = mode => ({
     (0, _a11y.speak)((0, _i18n.__)('You are currently in zoom-out mode.'));
   }
 };
+
 /**
  * Action that enables or disables the block moving mode.
  *
  * @param {string|null} hasBlockMovingClientId Enable/Disable block moving mode.
  */
-
-
 exports.__unstableSetEditorMode = __unstableSetEditorMode;
-
 const setBlockMovingClientId = (hasBlockMovingClientId = null) => ({
   dispatch
 }) => {
@@ -1460,64 +1357,54 @@ const setBlockMovingClientId = (hasBlockMovingClientId = null) => ({
     type: 'SET_BLOCK_MOVING_MODE',
     hasBlockMovingClientId
   });
-
   if (hasBlockMovingClientId) {
     (0, _a11y.speak)((0, _i18n.__)('Use the Tab key and Arrow keys to choose new block location. Use Left and Right Arrow keys to move between nesting levels. Once location is selected press Enter or Space to move the block.'));
   }
 };
+
 /**
  * Action that duplicates a list of blocks.
  *
  * @param {string[]} clientIds
  * @param {boolean}  updateSelection
  */
-
-
 exports.setBlockMovingClientId = setBlockMovingClientId;
-
 const duplicateBlocks = (clientIds, updateSelection = true) => ({
   select,
   dispatch
 }) => {
   if (!clientIds || !clientIds.length) {
     return;
-  } // Return early if blocks don't exist.
-
+  }
 
+  // Return early if blocks don't exist.
   const blocks = select.getBlocksByClientId(clientIds);
-
   if (blocks.some(block => !block)) {
     return;
-  } // Return early if blocks don't support multiple usage.
-
+  }
 
+  // Return early if blocks don't support multiple usage.
   const blockNames = blocks.map(block => block.name);
-
   if (blockNames.some(blockName => !(0, _blocks.hasBlockSupport)(blockName, 'multiple', true))) {
     return;
   }
-
   const rootClientId = select.getBlockRootClientId(clientIds[0]);
   const clientIdsArray = castArray(clientIds);
   const lastSelectedIndex = select.getBlockIndex(clientIdsArray[clientIdsArray.length - 1]);
   const clonedBlocks = blocks.map(block => (0, _blocks.__experimentalCloneSanitizedBlock)(block));
   dispatch.insertBlocks(clonedBlocks, lastSelectedIndex + 1, rootClientId, updateSelection);
-
   if (clonedBlocks.length > 1 && updateSelection) {
     dispatch.multiSelect(clonedBlocks[0].clientId, clonedBlocks[clonedBlocks.length - 1].clientId);
   }
-
   return clonedBlocks.map(block => block.clientId);
 };
+
 /**
  * Action that inserts an empty block before a given block.
  *
  * @param {string} clientId
  */
-
-
 exports.duplicateBlocks = duplicateBlocks;
-
 const insertBeforeBlock = clientId => ({
   select,
   dispatch
@@ -1525,26 +1412,21 @@ const insertBeforeBlock = clientId => ({
   if (!clientId) {
     return;
   }
-
   const rootClientId = select.getBlockRootClientId(clientId);
   const isLocked = select.getTemplateLock(rootClientId);
-
   if (isLocked) {
     return;
   }
-
   const firstSelectedIndex = select.getBlockIndex(clientId);
   return dispatch.insertDefaultBlock({}, rootClientId, firstSelectedIndex);
 };
+
 /**
  * Action that inserts an empty block after a given block.
  *
  * @param {string} clientId
  */
-
-
 exports.insertBeforeBlock = insertBeforeBlock;
-
 const insertAfterBlock = clientId => ({
   select,
   dispatch
@@ -1552,27 +1434,22 @@ const insertAfterBlock = clientId => ({
   if (!clientId) {
     return;
   }
-
   const rootClientId = select.getBlockRootClientId(clientId);
   const isLocked = select.getTemplateLock(rootClientId);
-
   if (isLocked) {
     return;
   }
-
   const firstSelectedIndex = select.getBlockIndex(clientId);
   return dispatch.insertDefaultBlock({}, rootClientId, firstSelectedIndex + 1);
 };
+
 /**
  * Action that toggles the highlighted block state.
  *
  * @param {string}  clientId      The block's clientId.
  * @param {boolean} isHighlighted The highlight state.
  */
-
-
 exports.insertAfterBlock = insertAfterBlock;
-
 function toggleBlockHighlight(clientId, isHighlighted) {
   return {
     type: 'TOGGLE_BLOCK_HIGHLIGHT',
@@ -1580,13 +1457,12 @@ function toggleBlockHighlight(clientId, isHighlighted) {
     isHighlighted
   };
 }
+
 /**
  * Action that "flashes" the block with a given `clientId` by rhythmically highlighting it.
  *
  * @param {string} clientId Target block client ID.
  */
-
-
 const flashBlock = clientId => async ({
   dispatch
 }) => {
@@ -1594,16 +1470,14 @@ const flashBlock = clientId => async ({
   await new Promise(resolve => setTimeout(resolve, 150));
   dispatch(toggleBlockHighlight(clientId, false));
 };
+
 /**
  * Action that sets whether a block has controlled inner blocks.
  *
  * @param {string}  clientId                 The block's clientId.
  * @param {boolean} hasControlledInnerBlocks True if the block's inner blocks are controlled.
  */
-
-
 exports.flashBlock = flashBlock;
-
 function setHasControlledInnerBlocks(clientId, hasControlledInnerBlocks) {
   return {
     type: 'SET_HAS_CONTROLLED_INNER_BLOCKS',
@@ -1611,19 +1485,19 @@ function setHasControlledInnerBlocks(clientId, hasControlledInnerBlocks) {
     clientId
   };
 }
+
 /**
  * Action that sets whether given blocks are visible on the canvas.
  *
  * @param {Record<string,boolean>} updates For each block's clientId, its new visibility setting.
  */
-
-
 function setBlockVisibility(updates) {
   return {
     type: 'SET_BLOCK_VISIBILITY',
     updates
   };
 }
+
 /**
  * Action that sets whether a block is being temporaritly edited as blocks.
  *
@@ -1633,14 +1507,13 @@ function setBlockVisibility(updates) {
  *
  * @param {?string} temporarilyEditingAsBlocks The block's clientId being temporaritly edited as blocks.
  */
-
-
 function __unstableSetTemporarilyEditingAsBlocks(temporarilyEditingAsBlocks) {
   return {
     type: 'SET_TEMPORARILY_EDITING_AS_BLOCKS',
     temporarilyEditingAsBlocks
   };
 }
+
 /**
  * Interface for inserter media requests.
  *
@@ -1762,10 +1635,7 @@ function __unstableSetTemporarilyEditingAsBlocks(temporarilyEditingAsBlocks) {
  *                                                                                                   the report url for the media item. It accepts the `InserterMediaItem` as an argument.
  * @property {boolean}                                                [isExternalResource]           If the media category is an external resource, this should be set to true.
  *                                                                                                   This is used to avoid making a request to the external resource when the user
- *
  */
-
-
 const registerInserterMediaCategory = category => ({
   select,
   dispatch
@@ -1774,38 +1644,31 @@ const registerInserterMediaCategory = category => ({
     console.error('Category should be an `InserterMediaCategory` object.');
     return;
   }
-
   if (!category.name) {
     console.error('Category should have a `name` that should be unique among all media categories.');
     return;
   }
-
   if (!category.labels?.name) {
     console.error('Category should have a `labels.name`.');
     return;
   }
-
   if (!['image', 'audio', 'video'].includes(category.mediaType)) {
     console.error('Category should have `mediaType` property that is one of `image|audio|video`.');
     return;
   }
-
   if (!category.fetch || typeof category.fetch !== 'function') {
     console.error('Category should have a `fetch` function defined with the following signature `(InserterMediaRequest) => Promise<InserterMediaItem[]>`.');
     return;
   }
-
   const {
     inserterMediaCategories = []
   } = select.getSettings();
-
   if (inserterMediaCategories.some(({
     name
   }) => name === category.name)) {
     console.error(`A category is already registered with the same name: "${category.name}".`);
     return;
   }
-
   if (inserterMediaCategories.some(({
     labels: {
       name
@@ -1813,21 +1676,59 @@ const registerInserterMediaCategory = category => ({
   }) => name === category.labels?.name)) {
     console.error(`A category is already registered with the same labels.name: "${category.labels.name}".`);
     return;
-  } // `inserterMediaCategories` is a private block editor setting, which means it cannot
+  }
+  // `inserterMediaCategories` is a private block editor setting, which means it cannot
   // be updated through the public `updateSettings` action. We preserve this setting as
   // private, so extenders can only add new inserter media categories and don't have any
   // control over the core media categories.
-
-
   dispatch({
     type: 'UPDATE_SETTINGS',
     settings: {
-      inserterMediaCategories: [...inserterMediaCategories, { ...category,
+      inserterMediaCategories: [...inserterMediaCategories, {
+        ...category,
         isExternalResource: true
       }]
     }
   });
 };
 
+/**
+ * @typedef {import('../components/block-editing-mode').BlockEditingMode} BlockEditingMode
+ */
+
+/**
+ * Sets the block editing mode for a given block.
+ *
+ * @see useBlockEditingMode
+ *
+ * @param {string}           clientId The block client ID, or `''` for the root container.
+ * @param {BlockEditingMode} mode     The block editing mode. One of `'disabled'`,
+ *                                    `'contentOnly'`, or `'default'`.
+ *
+ * @return {Object} Action object.
+ */
 exports.registerInserterMediaCategory = registerInserterMediaCategory;
+function setBlockEditingMode(clientId = '', mode) {
+  return {
+    type: 'SET_BLOCK_EDITING_MODE',
+    clientId,
+    mode
+  };
+}
+
+/**
+ * Clears the block editing mode for a given block.
+ *
+ * @see useBlockEditingMode
+ *
+ * @param {string} clientId The block client ID, or `''` for the root container.
+ *
+ * @return {Object} Action object.
+ */
+function unsetBlockEditingMode(clientId = '') {
+  return {
+    type: 'UNSET_BLOCK_EDITING_MODE',
+    clientId
+  };
+}
 //# sourceMappingURL=actions.js.map