@wordpress/block-editor 12.6.0 → 12.8.0

package/build-module/store/actions.js

@@ -1,31 +1,30 @@
 /* eslint no-console: [ 'error', { allow: [ 'error', 'warn' ] } ] */
-
 /**
  * WordPress dependencies
  */
-import { cloneBlock, __experimentalCloneSanitizedBlock, createBlock, doBlocksMatchTemplate, getBlockType, getDefaultBlockName, hasBlockSupport, switchToBlockType, synchronizeBlocksWithTemplate } from '@wordpress/blocks';
+import { cloneBlock, __experimentalCloneSanitizedBlock, createBlock, doBlocksMatchTemplate, getBlockType, getDefaultBlockName, hasBlockSupport, switchToBlockType, synchronizeBlocksWithTemplate, getBlockSupport } from '@wordpress/blocks';
 import { speak } from '@wordpress/a11y';
 import { __, _n, sprintf } from '@wordpress/i18n';
 import { create, insert, remove, toHTMLString } from '@wordpress/rich-text';
 import deprecated from '@wordpress/deprecated';
+
 /**
  * Internal dependencies
  */
-
 import { mapRichTextSettings } from './utils';
 import { retrieveSelectedAttribute, START_OF_SELECTED_AREA } from '../utils/selection';
 import { __experimentalUpdateSettings, privateRemoveBlocks } from './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.
  */
-
-
 export const resetBlocks = blocks => ({
   dispatch
 }) => {
@@ -35,6 +34,7 @@ export 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
@@ -43,24 +43,25 @@ export const resetBlocks = blocks => ({
  *
  * @param {Array} blocks Array of blocks.
  */
-
 export 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' || 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' || doBlocksMatchTemplate(blocks, template);
 
+  // Update if validity has changed.
   const isValidTemplate = select.isValidTemplate();
-
   if (isBlocksValidToTemplate !== isValidTemplate) {
     dispatch.setTemplateValidity(isBlocksValidToTemplate);
     return isBlocksValidToTemplate;
   }
 };
+
 /**
  * A block selection object.
  *
@@ -82,7 +83,6 @@ export 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.
@@ -93,7 +93,6 @@ export const validateBlocksToTemplate = blocks => ({
  *
  * @return {Object} Action object.
  */
-
 export function resetSelection(selectionStart, selectionEnd, initialPosition) {
   /* eslint-enable jsdoc/valid-types */
   return {
@@ -103,6 +102,7 @@ export 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
@@ -114,7 +114,6 @@ export function resetSelection(selectionStart, selectionEnd, initialPosition) {
  *
  * @return {Object} Action object.
  */
-
 export function receiveBlocks(blocks) {
   deprecated('wp.data.dispatch( "core/block-editor" ).receiveBlocks', {
     since: '5.9',
@@ -125,6 +124,7 @@ export function receiveBlocks(blocks) {
     blocks
   };
 }
+
 /**
  * Action that updates attributes of multiple blocks with the specified client IDs.
  *
@@ -134,7 +134,6 @@ export function receiveBlocks(blocks) {
  * @param {boolean}         uniqueByBlock true if each block in clientIds array has a unique set of attributes
  * @return {Object} Action object.
  */
-
 export function updateBlockAttributes(clientIds, attributes, uniqueByBlock = false) {
   return {
     type: 'UPDATE_BLOCK_ATTRIBUTES',
@@ -143,6 +142,7 @@ export function updateBlockAttributes(clientIds, attributes, uniqueByBlock = fal
     uniqueByBlock
   };
 }
+
 /**
  * Action that updates the block with the specified client ID.
  *
@@ -151,7 +151,6 @@ export function updateBlockAttributes(clientIds, attributes, uniqueByBlock = fal
  *
  * @return {Object} Action object.
  */
-
 export function updateBlock(clientId, updates) {
   return {
     type: 'UPDATE_BLOCK',
@@ -159,8 +158,8 @@ export 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
@@ -173,7 +172,6 @@ export function updateBlock(clientId, updates) {
  *
  * @return {Object} Action object.
  */
-
 export function selectBlock(clientId, initialPosition = 0) {
   /* eslint-enable jsdoc/valid-types */
   return {
@@ -182,6 +180,7 @@ export 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)
@@ -190,62 +189,59 @@ export 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.
  */
-
 export 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.
  */
-
 export 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.
  */
-
 export function startMultiSelect() {
   return {
     type: 'START_MULTI_SELECT'
   };
 }
+
 /**
  * Action that stops block multi-selection.
  *
  * @return {Object} Action object.
  */
-
 export function stopMultiSelect() {
   return {
     type: 'STOP_MULTI_SELECT'
   };
 }
+
 /**
  * Action that changes block multi-selection.
  *
@@ -253,18 +249,17 @@ export 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.
  */
-
 export 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,
@@ -272,21 +267,21 @@ export const multiSelect = (start, end, __experimentalInitialPosition = 0) => ({
     initialPosition: __experimentalInitialPosition
   });
   const blockCount = select.getSelectedBlockCount();
-  speak(sprintf(
-  /* translators: %s: number of selected blocks */
+  speak(sprintf( /* translators: %s: number of selected blocks */
   _n('%s block selected.', '%s blocks selected.', blockCount), blockCount), 'assertive');
 };
+
 /**
  * Action that clears the block selection.
  *
  * @return {Object} Action object.
  */
-
 export function clearSelectedBlock() {
   return {
     type: 'CLEAR_SELECTED_BLOCK'
   };
 }
+
 /**
  * Action that enables or disables block selection.
  *
@@ -295,48 +290,42 @@ export function clearSelectedBlock() {
  *
  * @return {Object} Action object.
  */
-
 export 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 (!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.
  *
@@ -348,8 +337,6 @@ function getBlocksWithDefaultStylesApplied(blocks, blockEditorSettings) {
  *
  * @return {Object} Action object.
  */
-
-
 export const replaceBlocks = (clientIds, blocks, indexToSelect, initialPosition = 0, meta) => ({
   select,
   dispatch
@@ -357,17 +344,15 @@ export const replaceBlocks = (clientIds, blocks, indexToSelect, initialPosition
   /* 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,
@@ -379,6 +364,7 @@ export const replaceBlocks = (clientIds, blocks, indexToSelect, initialPosition
   });
   dispatch.ensureDefaultBlock();
 };
+
 /**
  * Action that replaces a single block with one or more replacement blocks.
  *
@@ -387,10 +373,10 @@ export const replaceBlocks = (clientIds, blocks, indexToSelect, initialPosition
  *
  * @return {Object} Action object.
  */
-
 export 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.
@@ -399,27 +385,24 @@ export 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
   });
 };
-
 export const moveBlocksDown = createOnMove('MOVE_BLOCKS_DOWN');
 export const moveBlocksUp = createOnMove('MOVE_BLOCKS_UP');
+
 /**
  * Action that moves given blocks to a new position.
  *
@@ -428,33 +411,33 @@ export const moveBlocksUp = createOnMove('MOVE_BLOCKS_UP');
  * @param {?string} toRootClientId   Root client ID destination.
  * @param {number}  index            The index to move the blocks to.
  */
-
 export 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,
@@ -463,6 +446,7 @@ export const moveBlocksToPosition = (clientIds, fromRootClientId = '', toRootCli
     index
   });
 };
+
 /**
  * Action that moves given block to a new position.
  *
@@ -471,10 +455,10 @@ export const moveBlocksToPosition = (clientIds, fromRootClientId = '', toRootCli
  * @param {?string} toRootClientId   Root client ID destination.
  * @param {number}  index            The index to move the block to.
  */
-
 export 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.
  *
@@ -489,12 +473,11 @@ export function moveBlockToPosition(clientId, fromRootClientId = '', toRootClien
  *
  * @return {Object} Action object.
  */
-
 export 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.
  *
@@ -510,7 +493,6 @@ export function insertBlock(block, index, rootClientId, updateSelection, meta) {
  *
  * @return {Object} Action object.
  */
-
 export const insertBlocks = (blocks, index, rootClientId, updateSelection = true, initialPosition = 0, meta) => ({
   select,
   dispatch
@@ -524,18 +506,14 @@ export const insertBlocks = (blocks, index, rootClientId, updateSelection = true
       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',
@@ -549,6 +527,7 @@ export const insertBlocks = (blocks, index, rootClientId, updateSelection = true
     });
   }
 };
+
 /**
  * Action that shows the insertion point.
  *
@@ -562,7 +541,6 @@ export const insertBlocks = (blocks, index, rootClientId, updateSelection = true
  *
  * @return {Object} Action object.
  */
-
 export function showInsertionPoint(rootClientId, index, __unstableOptions = {}) {
   const {
     __unstableWithInserter,
@@ -579,7 +557,6 @@ export function showInsertionPoint(rootClientId, index, __unstableOptions = {})
 /**
  * Action that hides the insertion point.
  */
-
 export const hideInsertionPoint = () => ({
   select,
   dispatch
@@ -587,11 +564,11 @@ export const hideInsertionPoint = () => ({
   if (!select.isBlockInsertionPointVisible()) {
     return;
   }
-
   dispatch({
     type: 'HIDE_INSERTION_POINT'
   });
 };
+
 /**
  * Action that resets the template validity.
  *
@@ -599,19 +576,18 @@ export const hideInsertionPoint = () => ({
  *
  * @return {Object} Action object.
  */
-
 export function setTemplateValidity(isValid) {
   return {
     type: 'SET_TEMPLATE_VALIDITY',
     isValid
   };
 }
+
 /**
  * Action that synchronizes the template with the list of blocks.
  *
  * @return {Object} Action object.
  */
-
 export const synchronizeTemplate = () => ({
   select,
   dispatch
@@ -624,12 +600,12 @@ export const synchronizeTemplate = () => ({
   const updatedBlockList = synchronizeBlocksWithTemplate(blocks, template);
   dispatch.resetBlocks(updatedBlockList);
 };
+
 /**
  * Delete the current selection.
  *
  * @param {boolean} isForward
  */
-
 export const __unstableDeleteSelection = isForward => ({
   registry,
   select,
@@ -637,23 +613,24 @@ export 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;
@@ -661,15 +638,12 @@ export const __unstableDeleteSelection = isForward => ({
     selectionStart = selectionAnchor;
     selectionEnd = selectionFocus;
   }
-
   const targetSelection = isForward ? selectionEnd : selectionStart;
   const targetBlock = select.getBlock(targetSelection.clientId);
   const targetBlockType = getBlockType(targetBlock.name);
-
   if (!targetBlockType.merge) {
     return;
   }
-
   const selectionA = selectionStart;
   const selectionB = selectionEnd;
   const blockA = select.getBlock(selectionA.clientId);
@@ -689,8 +663,9 @@ export const __unstableDeleteSelection = isForward => ({
     ...mapRichTextSettings(attributeDefinitionB)
   });
   valueA = remove(valueA, selectionA.offset, valueA.text.length);
-  valueB = insert(valueB, START_OF_SELECTED_AREA, 0, selectionB.offset); // Clone the blocks so we don't manipulate the original.
+  valueB = insert(valueB, START_OF_SELECTED_AREA, 0, selectionB.offset);
 
+  // Clone the blocks so we don't manipulate the original.
   const cloneA = cloneBlock(blockA, {
     [selectionA.attributeKey]: toHTMLString({
       value: valueA,
@@ -703,17 +678,17 @@ export const __unstableDeleteSelection = isForward => ({
       ...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] : 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] : 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);
@@ -721,7 +696,6 @@ export const __unstableDeleteSelection = isForward => ({
     const blockToMerge = blocksWithTheSameType.shift();
     updatedAttributes = targetBlockType.merge(cloneA.attributes, blockToMerge.attributes);
   }
-
   const newAttributeKey = retrieveSelectedAttribute(updatedAttributes);
   const convertedHtml = updatedAttributes[newAttributeKey];
   const convertedValue = create({
@@ -736,45 +710,49 @@ export 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.
  */
-
 export 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;
@@ -782,7 +760,6 @@ export const __unstableSplitSelection = () => ({
     selectionStart = selectionAnchor;
     selectionEnd = selectionFocus;
   }
-
   const selectionA = selectionStart;
   const selectionB = selectionEnd;
   const blockA = select.getBlock(selectionA.clientId);
@@ -803,29 +780,32 @@ export const __unstableSplitSelection = () => ({
   });
   valueA = remove(valueA, selectionA.offset, valueA.text.length);
   valueB = 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]: toHTMLString({
         value: valueA,
         ...mapRichTextSettings(attributeDefinitionA)
       })
     }
-  }, createBlock(getDefaultBlockName()), { // Preserve the original client ID.
+  }, {
+    // Preserve the original client ID.
     ...blockB,
-    attributes: { ...blockB.attributes,
+    attributes: {
+      ...blockB.attributes,
       [selectionB.attributeKey]: toHTMLString({
         value: valueB,
         ...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.
  */
-
 export const __unstableExpandSelection = () => ({
   select,
   dispatch
@@ -841,13 +821,13 @@ export 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.
  */
-
 export const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
   registry,
   select,
@@ -862,25 +842,25 @@ export const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
   const blockA = select.getBlock(clientIdA);
   const blockAType = getBlockType(blockA.name);
   if (!blockAType) return;
+  if (!blockAType.merge && !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 = switchToBlockType(blockB, blockAType.name); // Only focus the previous block if it's not mergeable.
-
+    const blocksWithTheSameType = 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);
@@ -888,7 +868,6 @@ export const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
     });
     return;
   }
-
   const blockBType = getBlockType(blockB.name);
   const {
     clientId,
@@ -897,24 +876,23 @@ export 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 = cloneBlock(blockA);
   const cloneB = cloneBlock(blockB);
-
   if (canRestoreTextSelection) {
     const selectedBlock = clientId === clientIdA ? cloneA : cloneB;
     const html = selectedBlock.attributes[attributeKey];
@@ -926,19 +904,19 @@ export const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
       value,
       ...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] : 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] : 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 = retrieveSelectedAttribute(updatedAttributes);
     const convertedHtml = updatedAttributes[newAttributeKey];
@@ -955,14 +933,16 @@ export 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.
@@ -974,8 +954,8 @@ export const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
  *                                         should be selected
  *                                         when a block is removed.
  */
-
 export const removeBlocks = (clientIds, selectPrevious = true) => privateRemoveBlocks(clientIds, selectPrevious);
+
 /**
  * Returns an action object used in signalling that the block with the
  * specified client ID is to be removed.
@@ -986,12 +966,11 @@ export const removeBlocks = (clientIds, selectPrevious = true) => privateRemoveB
  *
  * @return {Object} Action object.
  */
-
 export 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.
@@ -1002,7 +981,6 @@ export function removeBlock(clientId, selectPrevious) {
  * @param {0|-1|null} initialPosition Initial block position.
  * @return {Object} Action object.
  */
-
 export function replaceInnerBlocks(rootClientId, blocks, updateSelection = false, initialPosition = 0) {
   /* eslint-enable jsdoc/valid-types */
   return {
@@ -1014,6 +992,7 @@ export function replaceInnerBlocks(rootClientId, blocks, updateSelection = false
     time: Date.now()
   };
 }
+
 /**
  * Returns an action object used to toggle the block editing mode between
  * visual and HTML modes.
@@ -1022,35 +1001,35 @@ export function replaceInnerBlocks(rootClientId, blocks, updateSelection = false
  *
  * @return {Object} Action object.
  */
-
 export 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.
  */
-
 export function startTyping() {
   return {
     type: 'START_TYPING'
   };
 }
+
 /**
  * Returns an action object used in signalling that the user has stopped typing.
  *
  * @return {Object} Action object.
  */
-
 export function stopTyping() {
   return {
     type: 'STOP_TYPING'
   };
 }
+
 /**
  * Returns an action object used in signalling that the user has begun to drag blocks.
  *
@@ -1058,24 +1037,24 @@ export function stopTyping() {
  *
  * @return {Object} Action object.
  */
-
 export 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.
  */
-
 export function stopDraggingBlocks() {
   return {
     type: 'STOP_DRAGGING_BLOCKS'
   };
 }
+
 /**
  * Returns an action object used in signalling that the caret has entered formatted text.
  *
@@ -1083,7 +1062,6 @@ export function stopDraggingBlocks() {
  *
  * @return {Object} Action object.
  */
-
 export function enterFormattedText() {
   deprecated('wp.data.dispatch( "core/block-editor" ).enterFormattedText', {
     since: '6.1',
@@ -1093,6 +1071,7 @@ export function enterFormattedText() {
     type: 'DO_NOTHING'
   };
 }
+
 /**
  * Returns an action object used in signalling that the user caret has exited formatted text.
  *
@@ -1100,7 +1079,6 @@ export function enterFormattedText() {
  *
  * @return {Object} Action object.
  */
-
 export function exitFormattedText() {
   deprecated('wp.data.dispatch( "core/block-editor" ).exitFormattedText', {
     since: '6.1',
@@ -1110,6 +1088,7 @@ export function exitFormattedText() {
     type: 'DO_NOTHING'
   };
 }
+
 /**
  * Action that changes the position of the user caret.
  *
@@ -1120,7 +1099,6 @@ export function exitFormattedText() {
  *
  * @return {Object} Action object.
  */
-
 export function selectionChange(clientId, attributeKey, startOffset, endOffset) {
   if (typeof clientId === 'string') {
     return {
@@ -1131,12 +1109,12 @@ export 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.
  *
@@ -1145,20 +1123,18 @@ export function selectionChange(clientId, attributeKey, startOffset, endOffset)
  *                               to append.
  * @param {?number} index        Optional index where to insert the default block.
  */
-
 export const insertDefaultBlock = (attributes, rootClientId, index) => ({
   dispatch
 }) => {
   // Abort if there is no default block type (if it has been unregistered).
   const defaultBlockName = getDefaultBlockName();
-
   if (!defaultBlockName) {
     return;
   }
-
   const block = createBlock(defaultBlockName, attributes);
   return dispatch.insertBlock(block, index, rootClientId);
 };
+
 /**
  * Action that changes the nested settings of a given block.
  *
@@ -1168,7 +1144,6 @@ export const insertDefaultBlock = (attributes, rootClientId, index) => ({
  *
  * @return {Object} Action object
  */
-
 export function updateBlockListSettings(clientId, settings) {
   return {
     type: 'UPDATE_BLOCK_LIST_SETTINGS',
@@ -1176,6 +1151,7 @@ export function updateBlockListSettings(clientId, settings) {
     settings
   };
 }
+
 /**
  * Action that updates the block editor settings.
  *
@@ -1183,12 +1159,12 @@ export function updateBlockListSettings(clientId, settings) {
  *
  * @return {Object} Action object
  */
-
 export function updateSettings(settings) {
   return __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.
@@ -1198,7 +1174,6 @@ export function updateSettings(settings) {
  *
  * @return {Object} Action object.
  */
-
 export function __unstableSaveReusableBlock(id, updatedId) {
   return {
     type: 'SAVE_REUSABLE_BLOCK_SUCCESS',
@@ -1206,28 +1181,29 @@ export function __unstableSaveReusableBlock(id, updatedId) {
     updatedId
   };
 }
+
 /**
  * Action that marks the last block change explicitly as persistent.
  *
  * @return {Object} Action object.
  */
-
 export 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.
  */
-
 export 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.
@@ -1235,7 +1211,6 @@ export 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.
  */
-
 export const __unstableMarkAutomaticChange = () => ({
   dispatch
 }) => {
@@ -1251,23 +1226,23 @@ export const __unstableMarkAutomaticChange = () => ({
     });
   });
 };
+
 /**
  * Action that enables or disables the navigation mode.
  *
  * @param {boolean} isNavigationMode Enable/Disable navigation mode.
  */
-
 export const setNavigationMode = (isNavigationMode = true) => ({
   dispatch
 }) => {
   dispatch.__unstableSetEditorMode(isNavigationMode ? 'navigation' : 'edit');
 };
+
 /**
  * Action that sets the editor mode
  *
  * @param {string} mode Editor mode
  */
-
 export const __unstableSetEditorMode = mode => ({
   dispatch,
   select
@@ -1275,17 +1250,14 @@ export 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') {
     speak(__('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') {
@@ -1294,12 +1266,12 @@ export const __unstableSetEditorMode = mode => ({
     speak(__('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.
  */
-
 export const setBlockMovingClientId = (hasBlockMovingClientId = null) => ({
   dispatch
 }) => {
@@ -1307,58 +1279,52 @@ export const setBlockMovingClientId = (hasBlockMovingClientId = null) => ({
     type: 'SET_BLOCK_MOVING_MODE',
     hasBlockMovingClientId
   });
-
   if (hasBlockMovingClientId) {
     speak(__('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
  */
-
 export 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 => !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 => __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
  */
-
 export const insertBeforeBlock = clientId => ({
   select,
   dispatch
@@ -1366,23 +1332,20 @@ export 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
  */
-
 export const insertAfterBlock = clientId => ({
   select,
   dispatch
@@ -1390,24 +1353,21 @@ export 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.
  */
-
 export function toggleBlockHighlight(clientId, isHighlighted) {
   return {
     type: 'TOGGLE_BLOCK_HIGHLIGHT',
@@ -1415,12 +1375,12 @@ export 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.
  */
-
 export const flashBlock = clientId => async ({
   dispatch
 }) => {
@@ -1428,13 +1388,13 @@ export 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.
  */
-
 export function setHasControlledInnerBlocks(clientId, hasControlledInnerBlocks) {
   return {
     type: 'SET_HAS_CONTROLLED_INNER_BLOCKS',
@@ -1442,18 +1402,19 @@ export 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.
  */
-
 export function setBlockVisibility(updates) {
   return {
     type: 'SET_BLOCK_VISIBILITY',
     updates
   };
 }
+
 /**
  * Action that sets whether a block is being temporaritly edited as blocks.
  *
@@ -1463,13 +1424,13 @@ export function setBlockVisibility(updates) {
  *
  * @param {?string} temporarilyEditingAsBlocks The block's clientId being temporaritly edited as blocks.
  */
-
 export function __unstableSetTemporarilyEditingAsBlocks(temporarilyEditingAsBlocks) {
   return {
     type: 'SET_TEMPORARILY_EDITING_AS_BLOCKS',
     temporarilyEditingAsBlocks
   };
 }
+
 /**
  * Interface for inserter media requests.
  *
@@ -1591,9 +1552,7 @@ export function __unstableSetTemporarilyEditingAsBlocks(temporarilyEditingAsBloc
  *                                                                                                   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
- *
  */
-
 export const registerInserterMediaCategory = category => ({
   select,
   dispatch
@@ -1602,38 +1561,31 @@ export 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
@@ -1641,19 +1593,58 @@ export 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.
+ */
+export 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.
+ */
+export function unsetBlockEditingMode(clientId = '') {
+  return {
+    type: 'UNSET_BLOCK_EDITING_MODE',
+    clientId
+  };
+}
 //# sourceMappingURL=actions.js.map