@wordpress/block-editor 7.0.1 → 8.0.0

package/build-module/store/actions.js

@@ -9,56 +9,57 @@ import { castArray, findKey, first, isObject, last, some } from 'lodash';
 import { cloneBlock, __experimentalCloneSanitizedBlock, createBlock, doBlocksMatchTemplate, getBlockType, getDefaultBlockName, hasBlockSupport, switchToBlockType, synchronizeBlocksWithTemplate } from '@wordpress/blocks';
 import { speak } from '@wordpress/a11y';
 import { __, _n, sprintf } from '@wordpress/i18n';
-import { controls } from '@wordpress/data';
 import { create, insert, remove, toHTMLString } from '@wordpress/rich-text';
 import deprecated from '@wordpress/deprecated';
 /**
- * Internal dependencies
- */
-
-import { __unstableMarkAutomaticChangeFinalControl } from '../store/controls';
-import { STORE_NAME as blockEditorStoreName } from './constants';
-/**
- * Generator which will yield a default block insert action if there
- * are no other blocks at the root of the editor. This generator should be used
+ * Action which will insert a default block insert action if there
+ * are no other blocks at the root of the editor. This action should be used
  * in actions which may result in no blocks remaining in the editor (removal,
  * replacement, etc).
  */
 
-function* ensureDefaultBlock() {
-  const count = yield controls.select(blockEditorStoreName, 'getBlockCount'); // To avoid a focus loss when removing the last block, assure there is
+const ensureDefaultBlock = () => ({
+  select,
+  dispatch
+}) => {
+  // To avoid a focus loss when removing the last block, assure there is
   // always a default block if the last of the blocks have been removed.
+  const count = select.getBlockCount();
 
-  if (count === 0) {
-    const {
-      __unstableHasCustomAppender
-    } = yield controls.select(blockEditorStoreName, 'getSettings'); // If there's an custom appender, don't insert default block.
-    // We have to remember to manually move the focus elsewhere to
-    // prevent it from being lost though.
+  if (count > 0) {
+    return;
+  } // If there's an custom appender, don't insert default block.
+  // We have to remember to manually move the focus elsewhere to
+  // prevent it from being lost though.
 
-    if (__unstableHasCustomAppender) {
-      return;
-    }
 
-    return yield insertDefaultBlock();
+  const {
+    __unstableHasCustomAppender
+  } = select.getSettings();
+
+  if (__unstableHasCustomAppender) {
+    return;
   }
-}
+
+  dispatch.insertDefaultBlock();
+};
 /**
- * Returns an action object used in signalling that blocks state should be
- * reset to the specified array of blocks, taking precedence over any other
- * content reflected as an edit in state.
+ * 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 function* resetBlocks(blocks) {
-  yield {
+export const resetBlocks = blocks => ({
+  dispatch
+}) => {
+  dispatch({
     type: 'RESET_BLOCKS',
     blocks
-  };
-  return yield* validateBlocksToTemplate(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
@@ -68,20 +69,23 @@ export function* resetBlocks(blocks) {
  * @param {Array} blocks Array of blocks.
  */
 
-export function* validateBlocksToTemplate(blocks) {
-  const template = yield controls.select(blockEditorStoreName, 'getTemplate');
-  const templateLock = yield controls.select(blockEditorStoreName, 'getTemplateLock'); // Unlocked templates are considered always valid because they act
+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 isBlocksValidToTemplate = !template || templateLock !== 'all' || doBlocksMatchTemplate(blocks, template); // Update if validity has changed.
 
-  const isValidTemplate = yield controls.select(blockEditorStoreName, 'isValidTemplate');
+  const isValidTemplate = select.isValidTemplate();
 
   if (isBlocksValidToTemplate !== isValidTemplate) {
-    yield setTemplateValidity(isBlocksValidToTemplate);
+    dispatch.setTemplateValidity(isBlocksValidToTemplate);
     return isBlocksValidToTemplate;
   }
-}
+};
 /**
  * A block selection object.
  *
@@ -93,6 +97,8 @@ export function* validateBlocksToTemplate(blocks) {
  *                                 text value. See `wp.richText.create`.
  */
 
+/* eslint-disable jsdoc/valid-types */
+
 /**
  * Returns an action object used in signalling that selection state should be
  * reset to the specified selection.
@@ -105,6 +111,7 @@ export function* validateBlocksToTemplate(blocks) {
  */
 
 export function resetSelection(selectionStart, selectionEnd, initialPosition) {
+  /* eslint-enable jsdoc/valid-types */
   return {
     type: 'RESET_SELECTION',
     selectionStart,
@@ -117,20 +124,25 @@ export function resetSelection(selectionStart, selectionEnd, initialPosition) {
  * Unlike resetBlocks, these should be appended to the existing known set, not
  * replacing.
  *
+ * @deprecated
+ *
  * @param {Object[]} blocks Array of block objects.
  *
  * @return {Object} Action object.
  */
 
 export function receiveBlocks(blocks) {
+  deprecated('wp.data.dispatch( "core/block-editor" ).receiveBlocks', {
+    since: '5.9',
+    alternative: 'resetBlocks or insertBlocks'
+  });
   return {
     type: 'RECEIVE_BLOCKS',
     blocks
   };
 }
 /**
- * Returns an action object used in signalling that the multiple blocks'
- * attributes with the specified client IDs have been updated.
+ * Action that updates attributes of multiple blocks with the specified client IDs.
  *
  * @param {string|string[]} clientIds     Block client IDs.
  * @param {Object}          attributes    Block attributes to be merged. Should be keyed by clientIds if
@@ -148,8 +160,7 @@ export function updateBlockAttributes(clientIds, attributes, uniqueByBlock = fal
   };
 }
 /**
- * Returns an action object used in signalling that the block with the
- * specified client ID has been updated.
+ * Action that updates the block with the specified client ID.
  *
  * @param {string} clientId Block client ID.
  * @param {Object} updates  Block attributes to be merged.
@@ -164,6 +175,8 @@ export function updateBlock(clientId, updates) {
     updates
   };
 }
+/* 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
@@ -178,6 +191,7 @@ export function updateBlock(clientId, updates) {
  */
 
 export function selectBlock(clientId, initialPosition = 0) {
+  /* eslint-enable jsdoc/valid-types */
   return {
     type: 'SELECT_BLOCK',
     initialPosition,
@@ -191,14 +205,16 @@ export function selectBlock(clientId, initialPosition = 0) {
  * @param {string} clientId Block client ID.
  */
 
-export function* selectPreviousBlock(clientId) {
-  const previousBlockClientId = yield controls.select(blockEditorStoreName, 'getPreviousBlockClientId', clientId);
+export const selectPreviousBlock = clientId => ({
+  select,
+  dispatch
+}) => {
+  const previousBlockClientId = select.getPreviousBlockClientId(clientId);
 
   if (previousBlockClientId) {
-    yield selectBlock(previousBlockClientId, -1);
-    return [previousBlockClientId];
+    dispatch.selectBlock(previousBlockClientId, -1);
   }
-}
+};
 /**
  * Yields action objects used in signalling that the block following the given
  * clientId should be selected.
@@ -206,16 +222,18 @@ export function* selectPreviousBlock(clientId) {
  * @param {string} clientId Block client ID.
  */
 
-export function* selectNextBlock(clientId) {
-  const nextBlockClientId = yield controls.select(blockEditorStoreName, 'getNextBlockClientId', clientId);
+export const selectNextBlock = clientId => ({
+  select,
+  dispatch
+}) => {
+  const nextBlockClientId = select.getNextBlockClientId(clientId);
 
   if (nextBlockClientId) {
-    yield selectBlock(nextBlockClientId);
-    return [nextBlockClientId];
+    dispatch.selectBlock(nextBlockClientId);
   }
-}
+};
 /**
- * Returns an action object used in signalling that a block multi-selection has started.
+ * Action that starts block multi-selection.
  *
  * @return {Object} Action object.
  */
@@ -226,7 +244,7 @@ export function startMultiSelect() {
   };
 }
 /**
- * Returns an action object used in signalling that block multi-selection stopped.
+ * Action that stops block multi-selection.
  *
  * @return {Object} Action object.
  */
@@ -237,32 +255,35 @@ export function stopMultiSelect() {
   };
 }
 /**
- * Returns an action object used in signalling that block multi-selection changed.
+ * Action that changes block multi-selection.
  *
  * @param {string} start First block of the multi selection.
  * @param {string} end   Last block of the multiselection.
  */
 
-export function* multiSelect(start, end) {
-  const startBlockRootClientId = yield controls.select(blockEditorStoreName, 'getBlockRootClientId', start);
-  const endBlockRootClientId = yield controls.select(blockEditorStoreName, 'getBlockRootClientId', end); // Only allow block multi-selections at the same level.
+export const multiSelect = (start, end) => ({
+  select,
+  dispatch
+}) => {
+  const startBlockRootClientId = select.getBlockRootClientId(start);
+  const endBlockRootClientId = select.getBlockRootClientId(end); // Only allow block multi-selections at the same level.
 
   if (startBlockRootClientId !== endBlockRootClientId) {
     return;
   }
 
-  yield {
+  dispatch({
     type: 'MULTI_SELECT',
     start,
     end
-  };
-  const blockCount = yield controls.select(blockEditorStoreName, 'getSelectedBlockCount');
+  });
+  const blockCount = select.getSelectedBlockCount();
   speak(sprintf(
   /* translators: %s: number of selected blocks */
   _n('%s block selected.', '%s blocks selected.', blockCount), blockCount), 'assertive');
-}
+};
 /**
- * Returns an action object used in signalling that the block selection is cleared.
+ * Action that clears the block selection.
  *
  * @return {Object} Action object.
  */
@@ -273,7 +294,7 @@ export function clearSelectedBlock() {
   };
 }
 /**
- * Returns an action object that enables or disables block selection.
+ * Action that enables or disables block selection.
  *
  * @param {boolean} [isSelectionEnabled=true] Whether block selection should
  *                                            be enabled.
@@ -322,9 +343,10 @@ function getBlocksWithDefaultStylesApplied(blocks, blockEditorSettings) {
     };
   });
 }
+/* eslint-disable jsdoc/valid-types */
+
 /**
- * Returns an action object signalling that a blocks should be replaced with
- * one or more replacement blocks.
+ * Action that replaces given blocks with one or more replacement blocks.
  *
  * @param {(string|string[])} clientIds       Block client ID(s) to replace.
  * @param {(Object|Object[])} blocks          Replacement block(s).
@@ -332,25 +354,29 @@ function getBlocksWithDefaultStylesApplied(blocks, blockEditorSettings) {
  * @param {0|-1|null}         initialPosition Index of caret after in the selected block after the operation.
  * @param {?Object}           meta            Optional Meta values to be passed to the action object.
  *
- * @yield {Object} Action object.
+ * @return {Object} Action object.
  */
 
 
-export function* replaceBlocks(clientIds, blocks, indexToSelect, initialPosition = 0, meta) {
+export const replaceBlocks = (clientIds, blocks, indexToSelect, initialPosition = 0, meta) => ({
+  select,
+  dispatch
+}) => {
+  /* eslint-enable jsdoc/valid-types */
   clientIds = castArray(clientIds);
-  blocks = getBlocksWithDefaultStylesApplied(castArray(blocks), yield controls.select(blockEditorStoreName, 'getSettings'));
-  const rootClientId = yield controls.select(blockEditorStoreName, 'getBlockRootClientId', first(clientIds)); // Replace is valid if the new blocks can be inserted in the root block.
+  blocks = getBlocksWithDefaultStylesApplied(castArray(blocks), select.getSettings());
+  const rootClientId = select.getBlockRootClientId(first(clientIds)); // 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 = yield controls.select(blockEditorStoreName, 'canInsertBlockType', block.name, rootClientId);
+    const canInsertBlock = select.canInsertBlockType(block.name, rootClientId);
 
     if (!canInsertBlock) {
       return;
     }
   }
 
-  yield {
+  dispatch({
     type: 'REPLACE_BLOCKS',
     clientIds,
     blocks,
@@ -358,12 +384,11 @@ export function* replaceBlocks(clientIds, blocks, indexToSelect, initialPosition
     indexToSelect,
     initialPosition,
     meta
-  };
-  yield* ensureDefaultBlock();
-}
+  });
+  dispatch(ensureDefaultBlock());
+};
 /**
- * Returns an action object signalling that a single block should be replaced
- * with one or more replacement blocks.
+ * Action that replaces a single block with one or more replacement blocks.
  *
  * @param {(string|string[])} clientId Block client ID to replace.
  * @param {(Object|Object[])} block    Replacement block(s).
@@ -383,82 +408,83 @@ export function replaceBlock(clientId, block) {
  * @return {Function} Action creator.
  */
 
-function createOnMove(type) {
-  return (clientIds, rootClientId) => {
-    return {
-      clientIds: castArray(clientIds),
-      type,
-      rootClientId
-    };
-  };
-}
+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');
 /**
- * Returns an action object signalling that the given blocks should be moved to
- * a new position.
+ * Action that moves given blocks to a new position.
  *
  * @param {?string} clientIds        The client IDs of the blocks.
  * @param {?string} fromRootClientId Root client ID source.
  * @param {?string} toRootClientId   Root client ID destination.
  * @param {number}  index            The index to move the blocks to.
- *
- * @yield {Object} Action object.
  */
 
-export function* moveBlocksToPosition(clientIds, fromRootClientId = '', toRootClientId = '', index) {
-  const templateLock = yield controls.select(blockEditorStoreName, 'getTemplateLock', fromRootClientId); // If locking is equal to all on the original clientId (fromRootClientId),
-  // it is not possible to move the block to any other position.
+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.
 
-  if (templateLock === 'all') {
+  if (!canMoveBlocks) {
     return;
+  } // 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.
+
+    if (!canRemoveBlocks) {
+      return;
+    }
+
+    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 (!canInsertBlocks) {
+      return;
+    }
   }
 
-  const action = {
+  dispatch({
     type: 'MOVE_BLOCKS_TO_POSITION',
     fromRootClientId,
     toRootClientId,
     clientIds,
     index
-  }; // If moving inside the same root block the move is always possible.
-
-  if (fromRootClientId === toRootClientId) {
-    yield action;
-    return;
-  } // If templateLock is insert we can not remove the block from the parent.
-  // Given that here we know that we are moving the block to a different
-  // parent, the move should not be possible if the condition is true.
-
-
-  if (templateLock === 'insert') {
-    return;
-  }
-
-  const canInsertBlocks = yield controls.select(blockEditorStoreName, '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 (canInsertBlocks) {
-    yield action;
-  }
-}
+  });
+};
 /**
- * Returns an action object signalling that the given block should be moved to a
- * new position.
+ * Action that moves given block to a new position.
  *
  * @param {?string} clientId         The client ID of the block.
  * @param {?string} fromRootClientId Root client ID source.
  * @param {?string} toRootClientId   Root client ID destination.
  * @param {number}  index            The index to move the block to.
- *
- * @yield {Object} Action object.
  */
 
-export function* moveBlockToPosition(clientId, fromRootClientId = '', toRootClientId = '', index) {
-  yield moveBlocksToPosition([clientId], fromRootClientId, toRootClientId, index);
+export function moveBlockToPosition(clientId, fromRootClientId = '', toRootClientId = '', index) {
+  return moveBlocksToPosition([clientId], fromRootClientId, toRootClientId, index);
 }
 /**
- * Returns an action object used in signalling that a single block should be
- * inserted, optionally at a specific index respective a root block list.
+ * Action that inserts a single block, optionally at a specific index respective a root block list.
  *
  * @param {Object}   block           Block object to insert.
  * @param {?number}  index           Index at which block should be inserted.
@@ -469,12 +495,13 @@ export function* moveBlockToPosition(clientId, fromRootClientId = '', toRootClie
  * @return {Object} Action object.
  */
 
-export function insertBlock(block, index, rootClientId, updateSelection = true, meta) {
+export function insertBlock(block, index, rootClientId, updateSelection, meta) {
   return insertBlocks([block], index, rootClientId, updateSelection, 0, meta);
 }
+/* eslint-disable jsdoc/valid-types */
+
 /**
- * Returns an action object used in signalling that an array of blocks should
- * be inserted, optionally at a specific index respective a root block list.
+ * Action that inserts an array of blocks, optionally at a specific index respective a root block list.
  *
  * @param {Object[]}  blocks          Block objects to insert.
  * @param {?number}   index           Index at which block should be inserted.
@@ -485,7 +512,11 @@ export function insertBlock(block, index, rootClientId, updateSelection = true,
  * @return {Object} Action object.
  */
 
-export function* insertBlocks(blocks, index, rootClientId, updateSelection = true, initialPosition = 0, meta) {
+export const insertBlocks = (blocks, index, rootClientId, updateSelection = true, initialPosition = 0, meta) => ({
+  select,
+  dispatch
+}) => {
+  /* eslint-enable jsdoc/valid-types */
   if (isObject(initialPosition)) {
     meta = initialPosition;
     initialPosition = 0;
@@ -496,11 +527,11 @@ export function* insertBlocks(blocks, index, rootClientId, updateSelection = tru
     });
   }
 
-  blocks = getBlocksWithDefaultStylesApplied(castArray(blocks), yield controls.select(blockEditorStoreName, 'getSettings'));
+  blocks = getBlocksWithDefaultStylesApplied(castArray(blocks), select.getSettings());
   const allowedBlocks = [];
 
   for (const block of blocks) {
-    const isValid = yield controls.select(blockEditorStoreName, 'canInsertBlockType', block.name, rootClientId);
+    const isValid = select.canInsertBlockType(block.name, rootClientId);
 
     if (isValid) {
       allowedBlocks.push(block);
@@ -508,7 +539,7 @@ export function* insertBlocks(blocks, index, rootClientId, updateSelection = tru
   }
 
   if (allowedBlocks.length) {
-    return {
+    dispatch({
       type: 'INSERT_BLOCKS',
       blocks: allowedBlocks,
       index,
@@ -517,12 +548,11 @@ export function* insertBlocks(blocks, index, rootClientId, updateSelection = tru
       updateSelection,
       initialPosition: updateSelection ? initialPosition : null,
       meta
-    };
+    });
   }
-}
+};
 /**
- * Returns an action object used in signalling that the insertion point should
- * be shown.
+ * Action that shows the insertion point.
  *
  * @param {?string} rootClientId      Optional root client ID of block list on
  *                                    which to insert.
@@ -544,7 +574,7 @@ export function showInsertionPoint(rootClientId, index, __unstableOptions = {})
   };
 }
 /**
- * Returns an action object hiding the insertion point.
+ * Action that hides the insertion point.
  *
  * @return {Object} Action object.
  */
@@ -555,7 +585,7 @@ export function hideInsertionPoint() {
   };
 }
 /**
- * Returns an action object resetting the template validity.
+ * Action that resets the template validity.
  *
  * @param {boolean} isValid template validity flag.
  *
@@ -569,49 +599,55 @@ export function setTemplateValidity(isValid) {
   };
 }
 /**
- * Returns an action object synchronize the template with the list of blocks
+ * Action that synchronizes the template with the list of blocks.
  *
  * @return {Object} Action object.
  */
 
-export function* synchronizeTemplate() {
-  yield {
+export const synchronizeTemplate = () => ({
+  select,
+  dispatch
+}) => {
+  dispatch({
     type: 'SYNCHRONIZE_TEMPLATE'
-  };
-  const blocks = yield controls.select(blockEditorStoreName, 'getBlocks');
-  const template = yield controls.select(blockEditorStoreName, 'getTemplate');
+  });
+  const blocks = select.getBlocks();
+  const template = select.getTemplate();
   const updatedBlockList = synchronizeBlocksWithTemplate(blocks, template);
-  return yield resetBlocks(updatedBlockList);
-}
+  dispatch.resetBlocks(updatedBlockList);
+};
 /**
- * Returns an action object used in signalling that two blocks should be merged
+ * 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 function* mergeBlocks(firstBlockClientId, secondBlockClientId) {
+export const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
+  select,
+  dispatch
+}) => {
   const blocks = [firstBlockClientId, secondBlockClientId];
-  yield {
+  dispatch({
     type: 'MERGE_BLOCKS',
     blocks
-  };
+  });
   const [clientIdA, clientIdB] = blocks;
-  const blockA = yield controls.select(blockEditorStoreName, 'getBlock', clientIdA);
+  const blockA = select.getBlock(clientIdA);
   const blockAType = getBlockType(blockA.name); // Only focus the previous block if it's not mergeable
 
-  if (!blockAType.merge) {
-    yield selectBlock(blockA.clientId);
+  if (blockAType && !blockAType.merge) {
+    dispatch.selectBlock(blockA.clientId);
     return;
   }
 
-  const blockB = yield controls.select(blockEditorStoreName, 'getBlock', clientIdB);
+  const blockB = select.getBlock(clientIdB);
   const blockBType = getBlockType(blockB.name);
   const {
     clientId,
     attributeKey,
     offset
-  } = yield controls.select(blockEditorStoreName, 'getSelectionStart');
+  } = 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
@@ -689,15 +725,16 @@ export function* mergeBlocks(firstBlockClientId, secondBlockClientId) {
       preserveWhiteSpace
     });
     updatedAttributes[newAttributeKey] = newHtml;
-    yield selectionChange(blockA.clientId, newAttributeKey, newOffset, newOffset);
+    dispatch.selectionChange(blockA.clientId, newAttributeKey, newOffset, newOffset);
   }
 
-  yield* replaceBlocks([blockA.clientId, blockB.clientId], [{ ...blockA,
+  dispatch.replaceBlocks([blockA.clientId, blockB.clientId], [{ ...blockA,
     attributes: { ...blockA.attributes,
       ...updatedAttributes
     }
-  }, ...blocksWithTheSameType.slice(1)]);
-}
+  }, ...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.
@@ -707,36 +744,34 @@ export function* mergeBlocks(firstBlockClientId, secondBlockClientId) {
  *                                         selected when a block is removed.
  */
 
-export function* removeBlocks(clientIds, selectPrevious = true) {
+export const removeBlocks = (clientIds, selectPrevious = true) => ({
+  select,
+  dispatch
+}) => {
   if (!clientIds || !clientIds.length) {
     return;
   }
 
   clientIds = castArray(clientIds);
-  const rootClientId = yield controls.select(blockEditorStoreName, 'getBlockRootClientId', clientIds[0]);
-  const isLocked = yield controls.select(blockEditorStoreName, 'getTemplateLock', rootClientId);
+  const rootClientId = select.getBlockRootClientId(clientIds[0]);
+  const canRemoveBlocks = select.canRemoveBlocks(clientIds, rootClientId);
 
-  if (isLocked) {
+  if (!canRemoveBlocks) {
     return;
   }
 
-  let previousBlockId;
-
   if (selectPrevious) {
-    previousBlockId = yield selectPreviousBlock(clientIds[0]);
-  } else {
-    previousBlockId = yield controls.select(blockEditorStoreName, 'getPreviousBlockClientId', clientIds[0]);
+    dispatch.selectPreviousBlock(clientIds[0]);
   }
 
-  yield {
+  dispatch({
     type: 'REMOVE_BLOCKS',
     clientIds
-  }; // To avoid a focus loss when removing the last block, assure there is
+  }); // To avoid a focus loss when removing the last block, assure there is
   // always a default block if the last of the blocks have been removed.
 
-  const defaultBlockId = yield* ensureDefaultBlock();
-  return [previousBlockId || defaultBlockId];
-}
+  dispatch(ensureDefaultBlock());
+};
 /**
  * Returns an action object used in signalling that the block with the
  * specified client ID is to be removed.
@@ -751,6 +786,8 @@ export function* removeBlocks(clientIds, selectPrevious = true) {
 export function removeBlock(clientId, selectPrevious) {
   return removeBlocks([clientId], selectPrevious);
 }
+/* eslint-disable jsdoc/valid-types */
+
 /**
  * Returns an action object used in signalling that the inner blocks with the
  * specified client ID should be replaced.
@@ -763,6 +800,7 @@ export function removeBlock(clientId, selectPrevious) {
  */
 
 export function replaceInnerBlocks(rootClientId, blocks, updateSelection = false, initialPosition = 0) {
+  /* eslint-enable jsdoc/valid-types */
   return {
     type: 'REPLACE_INNER_BLOCKS',
     rootClientId,
@@ -857,8 +895,7 @@ export function exitFormattedText() {
   };
 }
 /**
- * Returns an action object used in signalling that the user caret has changed
- * position.
+ * Action that changes the position of the user caret.
  *
  * @param {string} clientId     The selected block client ID.
  * @param {string} attributeKey The selected block attribute key.
@@ -878,8 +915,7 @@ export function selectionChange(clientId, attributeKey, startOffset, endOffset)
   };
 }
 /**
- * Returns an action object used in signalling that a new block of the default
- * type should be added to the block list.
+ * Action that adds a new block of the default type to the block list.
  *
  * @param {?Object} attributes   Optional attributes of the block to assign.
  * @param {?string} rootClientId Optional root client ID of block list on which
@@ -901,7 +937,7 @@ export function insertDefaultBlock(attributes, rootClientId, index) {
   return insertBlock(block, index, rootClientId);
 }
 /**
- * Returns an action object that changes the nested settings of a given block.
+ * Action that changes the nested settings of a given block.
  *
  * @param {string} clientId Client ID of the block whose nested setting are
  *                          being received.
@@ -918,7 +954,7 @@ export function updateBlockListSettings(clientId, settings) {
   };
 }
 /**
- * Returns an action object used in signalling that the block editor settings have been updated.
+ * Action that updates the block editor settings.
  *
  * @param {Object} settings Updated settings
  *
@@ -932,7 +968,7 @@ export function updateSettings(settings) {
   };
 }
 /**
- * Returns an action object used in signalling that a temporary reusable blocks have been saved
+ * Action that signals that a temporary reusable block has been saved
  * in order to switch its temporary id with the real id.
  *
  * @param {string} id        Reusable block's id.
@@ -949,7 +985,7 @@ export function __unstableSaveReusableBlock(id, updatedId) {
   };
 }
 /**
- * Returns an action object used in signalling that the last block change should be marked explicitly as persistent.
+ * Action that marks the last block change explicitly as persistent.
  *
  * @return {Object} Action object.
  */
@@ -960,7 +996,7 @@ export function __unstableMarkLastChangeAsPersistent() {
   };
 }
 /**
- * Returns an action object used in signalling that the next block change should be marked explicitly as not persistent.
+ * Action that signals that the next block change should be marked explicitly as not persistent.
  *
  * @return {Object} Action object.
  */
@@ -971,138 +1007,156 @@ export function __unstableMarkNextChangeAsNotPersistent() {
   };
 }
 /**
- * Returns an action object used in signalling that the last block change is
- * an automatic change, meaning it was not performed by the user, and can be
- * undone using the `Escape` and `Backspace` keys. This action must be called
- * after the change was made, and any actions that are a consequence of it, so
- * it is recommended to be called at the next idle period to ensure all
+ * 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.
+ * This action must be called after the change was made, and any actions that are a
+ * consequence of it, so it is recommended to be called at the next idle period to ensure all
  * selection changes have been recorded.
  */
 
-export function* __unstableMarkAutomaticChange() {
-  yield {
+export const __unstableMarkAutomaticChange = () => ({
+  dispatch
+}) => {
+  dispatch({
     type: 'MARK_AUTOMATIC_CHANGE'
-  };
-  yield __unstableMarkAutomaticChangeFinalControl();
-}
-export function __unstableMarkAutomaticChangeFinal() {
-  return {
-    type: 'MARK_AUTOMATIC_CHANGE_FINAL'
-  };
-}
+  });
+  const {
+    requestIdleCallback = cb => setTimeout(cb, 100)
+  } = window;
+  requestIdleCallback(() => {
+    dispatch({
+      type: 'MARK_AUTOMATIC_CHANGE_FINAL'
+    });
+  });
+};
 /**
- * Generators that triggers an action used to enable or disable the navigation mode.
+ * Action that enables or disables the navigation mode.
  *
  * @param {string} isNavigationMode Enable/Disable navigation mode.
  */
 
-export function* setNavigationMode(isNavigationMode = true) {
-  yield {
+export const setNavigationMode = (isNavigationMode = true) => ({
+  dispatch
+}) => {
+  dispatch({
     type: 'SET_NAVIGATION_MODE',
     isNavigationMode
-  };
+  });
 
   if (isNavigationMode) {
     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 {
     speak(__('You are currently in edit mode. To return to the navigation mode, press Escape.'));
   }
-}
+};
 /**
- * Generator that triggers an action used to enable or disable the block moving mode.
+ * Action that enables or disables the block moving mode.
  *
  * @param {string|null} hasBlockMovingClientId Enable/Disable block moving mode.
  */
 
-export function* setBlockMovingClientId(hasBlockMovingClientId = null) {
-  yield {
+export const setBlockMovingClientId = (hasBlockMovingClientId = null) => ({
+  dispatch
+}) => {
+  dispatch({
     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.'));
   }
-}
+};
 /**
- * Generator that triggers an action used to duplicate a list of blocks.
+ * Action that duplicates a list of blocks.
  *
  * @param {string[]} clientIds
  * @param {boolean}  updateSelection
  */
 
-export function* duplicateBlocks(clientIds, updateSelection = true) {
-  if (!clientIds && !clientIds.length) {
+export const duplicateBlocks = (clientIds, updateSelection = true) => ({
+  select,
+  dispatch
+}) => {
+  if (!clientIds || !clientIds.length) {
     return;
-  }
+  } // Return early if blocks don't exist.
+
 
-  const blocks = yield controls.select(blockEditorStoreName, 'getBlocksByClientId', clientIds);
-  const rootClientId = yield controls.select(blockEditorStoreName, 'getBlockRootClientId', clientIds[0]); // Return early if blocks don't exist.
+  const blocks = select.getBlocksByClientId(clientIds);
 
   if (some(blocks, block => !block)) {
     return;
-  }
+  } // Return early if blocks don't support multiple usage.
 
-  const blockNames = blocks.map(block => block.name); // Return early if blocks don't support multiple usage.
 
-  if (some(blockNames, blockName => !hasBlockSupport(blockName, 'multiple', true))) {
+  const blockNames = blocks.map(block => block.name);
+
+  if (blockNames.some(blockName => !hasBlockSupport(blockName, 'multiple', true))) {
     return;
   }
 
-  const lastSelectedIndex = yield controls.select(blockEditorStoreName, 'getBlockIndex', last(castArray(clientIds)), rootClientId);
+  const rootClientId = select.getBlockRootClientId(clientIds[0]);
+  const lastSelectedIndex = select.getBlockIndex(last(castArray(clientIds)), rootClientId);
   const clonedBlocks = blocks.map(block => __experimentalCloneSanitizedBlock(block));
-  yield insertBlocks(clonedBlocks, lastSelectedIndex + 1, rootClientId, updateSelection);
+  dispatch.insertBlocks(clonedBlocks, lastSelectedIndex + 1, rootClientId, updateSelection);
 
   if (clonedBlocks.length > 1 && updateSelection) {
-    yield multiSelect(first(clonedBlocks).clientId, last(clonedBlocks).clientId);
+    dispatch.multiSelect(first(clonedBlocks).clientId, last(clonedBlocks).clientId);
   }
 
   return clonedBlocks.map(block => block.clientId);
-}
+};
 /**
- * Generator used to insert an empty block after a given block.
+ * Action that inserts an empty block before a given block.
  *
  * @param {string} clientId
  */
 
-export function* insertBeforeBlock(clientId) {
+export const insertBeforeBlock = clientId => ({
+  select,
+  dispatch
+}) => {
   if (!clientId) {
     return;
   }
 
-  const rootClientId = yield controls.select(blockEditorStoreName, 'getBlockRootClientId', clientId);
-  const isLocked = yield controls.select(blockEditorStoreName, 'getTemplateLock', rootClientId);
+  const rootClientId = select.getBlockRootClientId(clientId);
+  const isLocked = select.getTemplateLock(rootClientId);
 
   if (isLocked) {
     return;
   }
 
-  const firstSelectedIndex = yield controls.select(blockEditorStoreName, 'getBlockIndex', clientId, rootClientId);
-  return yield insertDefaultBlock({}, rootClientId, firstSelectedIndex);
-}
+  const firstSelectedIndex = select.getBlockIndex(clientId, rootClientId);
+  return dispatch.insertDefaultBlock({}, rootClientId, firstSelectedIndex);
+};
 /**
- * Generator used to insert an empty block before a given block.
+ * Action that inserts an empty block after a given block.
  *
  * @param {string} clientId
  */
 
-export function* insertAfterBlock(clientId) {
+export const insertAfterBlock = clientId => ({
+  select,
+  dispatch
+}) => {
   if (!clientId) {
     return;
   }
 
-  const rootClientId = yield controls.select(blockEditorStoreName, 'getBlockRootClientId', clientId);
-  const isLocked = yield controls.select(blockEditorStoreName, 'getTemplateLock', rootClientId);
+  const rootClientId = select.getBlockRootClientId(clientId);
+  const isLocked = select.getTemplateLock(rootClientId);
 
   if (isLocked) {
     return;
   }
 
-  const firstSelectedIndex = yield controls.select(blockEditorStoreName, 'getBlockIndex', clientId, rootClientId);
-  return yield insertDefaultBlock({}, rootClientId, firstSelectedIndex + 1);
-}
+  const firstSelectedIndex = select.getBlockIndex(clientId, rootClientId);
+  return dispatch.insertDefaultBlock({}, rootClientId, firstSelectedIndex + 1);
+};
 /**
- * Returns an action object that toggles the highlighted block state.
+ * Action that toggles the highlighted block state.
  *
  * @param {string}  clientId      The block's clientId.
  * @param {boolean} isHighlighted The highlight state.
@@ -1116,22 +1170,20 @@ export function toggleBlockHighlight(clientId, isHighlighted) {
   };
 }
 /**
- * Yields action objects used in signalling that the block corresponding to the
- * given clientId should appear to "flash" by rhythmically highlighting it.
+ * Action that "flashes" the block with a given `clientId` by rhythmically highlighting it.
  *
  * @param {string} clientId Target block client ID.
  */
 
-export function* flashBlock(clientId) {
-  yield toggleBlockHighlight(clientId, true);
-  yield {
-    type: 'SLEEP',
-    duration: 150
-  };
-  yield toggleBlockHighlight(clientId, false);
-}
+export const flashBlock = clientId => async ({
+  dispatch
+}) => {
+  dispatch(toggleBlockHighlight(clientId, true));
+  await new Promise(resolve => setTimeout(resolve, 150));
+  dispatch(toggleBlockHighlight(clientId, false));
+};
 /**
- * Returns an action object that sets whether the block has controlled innerblocks.
+ * 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.