@wordpress/block-editor 7.0.1 → 8.0.0

package/build/store/actions.js

@@ -5,32 +5,21 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.resetBlocks = resetBlocks;
-exports.validateBlocksToTemplate = validateBlocksToTemplate;
 exports.resetSelection = resetSelection;
 exports.receiveBlocks = receiveBlocks;
 exports.updateBlockAttributes = updateBlockAttributes;
 exports.updateBlock = updateBlock;
 exports.selectBlock = selectBlock;
-exports.selectPreviousBlock = selectPreviousBlock;
-exports.selectNextBlock = selectNextBlock;
 exports.startMultiSelect = startMultiSelect;
 exports.stopMultiSelect = stopMultiSelect;
-exports.multiSelect = multiSelect;
 exports.clearSelectedBlock = clearSelectedBlock;
 exports.toggleSelection = toggleSelection;
-exports.replaceBlocks = replaceBlocks;
 exports.replaceBlock = replaceBlock;
-exports.moveBlocksToPosition = moveBlocksToPosition;
 exports.moveBlockToPosition = moveBlockToPosition;
 exports.insertBlock = insertBlock;
-exports.insertBlocks = insertBlocks;
 exports.showInsertionPoint = showInsertionPoint;
 exports.hideInsertionPoint = hideInsertionPoint;
 exports.setTemplateValidity = setTemplateValidity;
-exports.synchronizeTemplate = synchronizeTemplate;
-exports.mergeBlocks = mergeBlocks;
-exports.removeBlocks = removeBlocks;
 exports.removeBlock = removeBlock;
 exports.replaceInnerBlocks = replaceInnerBlocks;
 exports.toggleBlockMode = toggleBlockMode;
@@ -47,17 +36,9 @@ exports.updateSettings = updateSettings;
 exports.__unstableSaveReusableBlock = __unstableSaveReusableBlock;
 exports.__unstableMarkLastChangeAsPersistent = __unstableMarkLastChangeAsPersistent;
 exports.__unstableMarkNextChangeAsNotPersistent = __unstableMarkNextChangeAsNotPersistent;
-exports.__unstableMarkAutomaticChange = __unstableMarkAutomaticChange;
-exports.__unstableMarkAutomaticChangeFinal = __unstableMarkAutomaticChangeFinal;
-exports.setNavigationMode = setNavigationMode;
-exports.setBlockMovingClientId = setBlockMovingClientId;
-exports.duplicateBlocks = duplicateBlocks;
-exports.insertBeforeBlock = insertBeforeBlock;
-exports.insertAfterBlock = insertAfterBlock;
 exports.toggleBlockHighlight = toggleBlockHighlight;
-exports.flashBlock = flashBlock;
 exports.setHasControlledInnerBlocks = setHasControlledInnerBlocks;
-exports.moveBlocksUp = exports.moveBlocksDown = void 0;
+exports.flashBlock = exports.insertAfterBlock = exports.insertBeforeBlock = exports.duplicateBlocks = exports.setBlockMovingClientId = exports.setNavigationMode = exports.__unstableMarkAutomaticChange = exports.removeBlocks = exports.mergeBlocks = exports.synchronizeTemplate = exports.insertBlocks = exports.moveBlocksToPosition = exports.moveBlocksUp = exports.moveBlocksDown = exports.replaceBlocks = exports.multiSelect = exports.selectNextBlock = exports.selectPreviousBlock = exports.validateBlocksToTemplate = exports.resetBlocks = void 0;
 
 var _lodash = require("lodash");
 
@@ -67,16 +48,10 @@ var _a11y = require("@wordpress/a11y");
 
 var _i18n = require("@wordpress/i18n");
 
-var _data = require("@wordpress/data");
-
 var _richText = require("@wordpress/rich-text");
 
 var _deprecated = _interopRequireDefault(require("@wordpress/deprecated"));
 
-var _controls = require("../store/controls");
-
-var _constants = require("./constants");
-
 /**
  * External dependencies
  */
@@ -86,49 +61,53 @@ var _constants = require("./constants");
  */
 
 /**
- * Internal dependencies
- */
-
-/**
- * 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 _data.controls.select(_constants.STORE_NAME, '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 _data.controls.select(_constants.STORE_NAME, '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.
  */
 
 
-function* resetBlocks(blocks) {
-  yield {
+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
@@ -139,20 +118,25 @@ function* resetBlocks(blocks) {
  */
 
 
-function* validateBlocksToTemplate(blocks) {
-  const template = yield _data.controls.select(_constants.STORE_NAME, 'getTemplate');
-  const templateLock = yield _data.controls.select(_constants.STORE_NAME, 'getTemplateLock'); // Unlocked templates are considered always valid because they act
+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 isBlocksValidToTemplate = !template || templateLock !== 'all' || (0, _blocks.doBlocksMatchTemplate)(blocks, template); // Update if validity has changed.
 
-  const isValidTemplate = yield _data.controls.select(_constants.STORE_NAME, 'isValidTemplate');
+  const isValidTemplate = select.isValidTemplate();
 
   if (isBlocksValidToTemplate !== isValidTemplate) {
-    yield setTemplateValidity(isBlocksValidToTemplate);
+    dispatch.setTemplateValidity(isBlocksValidToTemplate);
     return isBlocksValidToTemplate;
   }
-}
+};
 /**
  * A block selection object.
  *
@@ -164,6 +148,8 @@ 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.
@@ -176,7 +162,10 @@ function* validateBlocksToTemplate(blocks) {
  */
 
 
+exports.validateBlocksToTemplate = validateBlocksToTemplate;
+
 function resetSelection(selectionStart, selectionEnd, initialPosition) {
+  /* eslint-enable jsdoc/valid-types */
   return {
     type: 'RESET_SELECTION',
     selectionStart,
@@ -189,6 +178,8 @@ 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.
@@ -196,14 +187,17 @@ function resetSelection(selectionStart, selectionEnd, initialPosition) {
 
 
 function receiveBlocks(blocks) {
+  (0, _deprecated.default)('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
@@ -222,8 +216,7 @@ function updateBlockAttributes(clientIds, attributes, uniqueByBlock = false) {
   };
 }
 /**
- * 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.
@@ -239,6 +232,8 @@ 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
@@ -254,6 +249,7 @@ function updateBlock(clientId, updates) {
 
 
 function selectBlock(clientId, initialPosition = 0) {
+  /* eslint-enable jsdoc/valid-types */
   return {
     type: 'SELECT_BLOCK',
     initialPosition,
@@ -268,14 +264,16 @@ function selectBlock(clientId, initialPosition = 0) {
  */
 
 
-function* selectPreviousBlock(clientId) {
-  const previousBlockClientId = yield _data.controls.select(_constants.STORE_NAME, 'getPreviousBlockClientId', clientId);
+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.
@@ -284,28 +282,34 @@ function* selectPreviousBlock(clientId) {
  */
 
 
-function* selectNextBlock(clientId) {
-  const nextBlockClientId = yield _data.controls.select(_constants.STORE_NAME, 'getNextBlockClientId', clientId);
+exports.selectPreviousBlock = selectPreviousBlock;
+
+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.
  */
 
 
+exports.selectNextBlock = selectNextBlock;
+
 function startMultiSelect() {
   return {
     type: 'START_MULTI_SELECT'
   };
 }
 /**
- * Returns an action object used in signalling that block multi-selection stopped.
+ * Action that stops block multi-selection.
  *
  * @return {Object} Action object.
  */
@@ -317,45 +321,50 @@ 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.
  */
 
 
-function* multiSelect(start, end) {
-  const startBlockRootClientId = yield _data.controls.select(_constants.STORE_NAME, 'getBlockRootClientId', start);
-  const endBlockRootClientId = yield _data.controls.select(_constants.STORE_NAME, 'getBlockRootClientId', end); // Only allow block multi-selections at the same level.
+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 _data.controls.select(_constants.STORE_NAME, 'getSelectedBlockCount');
+  });
+  const blockCount = select.getSelectedBlockCount();
   (0, _a11y.speak)((0, _i18n.sprintf)(
   /* translators: %s: number of selected blocks */
   (0, _i18n._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.
  */
 
 
+exports.multiSelect = multiSelect;
+
 function clearSelectedBlock() {
   return {
     type: 'CLEAR_SELECTED_BLOCK'
   };
 }
 /**
- * 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.
@@ -405,9 +414,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).
@@ -415,25 +425,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.
  */
 
 
-function* replaceBlocks(clientIds, blocks, indexToSelect, initialPosition = 0, meta) {
+const replaceBlocks = (clientIds, blocks, indexToSelect, initialPosition = 0, meta) => ({
+  select,
+  dispatch
+}) => {
+  /* eslint-enable jsdoc/valid-types */
   clientIds = (0, _lodash.castArray)(clientIds);
-  blocks = getBlocksWithDefaultStylesApplied((0, _lodash.castArray)(blocks), yield _data.controls.select(_constants.STORE_NAME, 'getSettings'));
-  const rootClientId = yield _data.controls.select(_constants.STORE_NAME, 'getBlockRootClientId', (0, _lodash.first)(clientIds)); // Replace is valid if the new blocks can be inserted in the root block.
+  blocks = getBlocksWithDefaultStylesApplied((0, _lodash.castArray)(blocks), select.getSettings());
+  const rootClientId = select.getBlockRootClientId((0, _lodash.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 _data.controls.select(_constants.STORE_NAME, 'canInsertBlockType', block.name, rootClientId);
+    const canInsertBlock = select.canInsertBlockType(block.name, rootClientId);
 
     if (!canInsertBlock) {
       return;
     }
   }
 
-  yield {
+  dispatch({
     type: 'REPLACE_BLOCKS',
     clientIds,
     blocks,
@@ -441,12 +455,11 @@ function* replaceBlocks(clientIds, blocks, indexToSelect, initialPosition = 0, m
     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).
@@ -455,6 +468,8 @@ function* replaceBlocks(clientIds, blocks, indexToSelect, initialPosition = 0, m
  */
 
 
+exports.replaceBlocks = replaceBlocks;
+
 function replaceBlock(clientId, block) {
   return replaceBlocks(clientId, block);
 }
@@ -468,86 +483,89 @@ function replaceBlock(clientId, block) {
  */
 
 
-function createOnMove(type) {
-  return (clientIds, rootClientId) => {
-    return {
-      clientIds: (0, _lodash.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: (0, _lodash.castArray)(clientIds),
+    rootClientId
+  });
+};
 
 const moveBlocksDown = createOnMove('MOVE_BLOCKS_DOWN');
 exports.moveBlocksDown = moveBlocksDown;
 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.
  */
 
 exports.moveBlocksUp = moveBlocksUp;
 
-function* moveBlocksToPosition(clientIds, fromRootClientId = '', toRootClientId = '', index) {
-  const templateLock = yield _data.controls.select(_constants.STORE_NAME, '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.
+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 _data.controls.select(_constants.STORE_NAME, '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.
  */
 
 
-function* moveBlockToPosition(clientId, fromRootClientId = '', toRootClientId = '', index) {
-  yield moveBlocksToPosition([clientId], fromRootClientId, toRootClientId, index);
+exports.moveBlocksToPosition = moveBlocksToPosition;
+
+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.
@@ -559,12 +577,13 @@ function* moveBlockToPosition(clientId, fromRootClientId = '', toRootClientId =
  */
 
 
-function insertBlock(block, index, rootClientId, updateSelection = true, meta) {
+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.
@@ -576,7 +595,11 @@ function insertBlock(block, index, rootClientId, updateSelection = true, meta) {
  */
 
 
-function* insertBlocks(blocks, index, rootClientId, updateSelection = true, initialPosition = 0, meta) {
+const insertBlocks = (blocks, index, rootClientId, updateSelection = true, initialPosition = 0, meta) => ({
+  select,
+  dispatch
+}) => {
+  /* eslint-enable jsdoc/valid-types */
   if ((0, _lodash.isObject)(initialPosition)) {
     meta = initialPosition;
     initialPosition = 0;
@@ -587,11 +610,11 @@ function* insertBlocks(blocks, index, rootClientId, updateSelection = true, init
     });
   }
 
-  blocks = getBlocksWithDefaultStylesApplied((0, _lodash.castArray)(blocks), yield _data.controls.select(_constants.STORE_NAME, 'getSettings'));
+  blocks = getBlocksWithDefaultStylesApplied((0, _lodash.castArray)(blocks), select.getSettings());
   const allowedBlocks = [];
 
   for (const block of blocks) {
-    const isValid = yield _data.controls.select(_constants.STORE_NAME, 'canInsertBlockType', block.name, rootClientId);
+    const isValid = select.canInsertBlockType(block.name, rootClientId);
 
     if (isValid) {
       allowedBlocks.push(block);
@@ -599,7 +622,7 @@ function* insertBlocks(blocks, index, rootClientId, updateSelection = true, init
   }
 
   if (allowedBlocks.length) {
-    return {
+    dispatch({
       type: 'INSERT_BLOCKS',
       blocks: allowedBlocks,
       index,
@@ -608,12 +631,11 @@ function* insertBlocks(blocks, index, rootClientId, updateSelection = true, init
       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.
@@ -624,6 +646,8 @@ function* insertBlocks(blocks, index, rootClientId, updateSelection = true, init
  */
 
 
+exports.insertBlocks = insertBlocks;
+
 function showInsertionPoint(rootClientId, index, __unstableOptions = {}) {
   const {
     __unstableWithInserter
@@ -636,7 +660,7 @@ function showInsertionPoint(rootClientId, index, __unstableOptions = {}) {
   };
 }
 /**
- * Returns an action object hiding the insertion point.
+ * Action that hides the insertion point.
  *
  * @return {Object} Action object.
  */
@@ -648,7 +672,7 @@ function hideInsertionPoint() {
   };
 }
 /**
- * Returns an action object resetting the template validity.
+ * Action that resets the template validity.
  *
  * @param {boolean} isValid template validity flag.
  *
@@ -663,51 +687,59 @@ 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.
  */
 
 
-function* synchronizeTemplate() {
-  yield {
+const synchronizeTemplate = () => ({
+  select,
+  dispatch
+}) => {
+  dispatch({
     type: 'SYNCHRONIZE_TEMPLATE'
-  };
-  const blocks = yield _data.controls.select(_constants.STORE_NAME, 'getBlocks');
-  const template = yield _data.controls.select(_constants.STORE_NAME, 'getTemplate');
+  });
+  const blocks = select.getBlocks();
+  const template = select.getTemplate();
   const updatedBlockList = (0, _blocks.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.
  */
 
 
-function* mergeBlocks(firstBlockClientId, secondBlockClientId) {
+exports.synchronizeTemplate = synchronizeTemplate;
+
+const mergeBlocks = (firstBlockClientId, secondBlockClientId) => ({
+  select,
+  dispatch
+}) => {
   const blocks = [firstBlockClientId, secondBlockClientId];
-  yield {
+  dispatch({
     type: 'MERGE_BLOCKS',
     blocks
-  };
+  });
   const [clientIdA, clientIdB] = blocks;
-  const blockA = yield _data.controls.select(_constants.STORE_NAME, 'getBlock', clientIdA);
+  const blockA = select.getBlock(clientIdA);
   const blockAType = (0, _blocks.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 _data.controls.select(_constants.STORE_NAME, 'getBlock', clientIdB);
+  const blockB = select.getBlock(clientIdB);
   const blockBType = (0, _blocks.getBlockType)(blockB.name);
   const {
     clientId,
     attributeKey,
     offset
-  } = yield _data.controls.select(_constants.STORE_NAME, '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
@@ -785,15 +817,16 @@ 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.
@@ -804,36 +837,36 @@ function* mergeBlocks(firstBlockClientId, secondBlockClientId) {
  */
 
 
-function* removeBlocks(clientIds, selectPrevious = true) {
+exports.mergeBlocks = mergeBlocks;
+
+const removeBlocks = (clientIds, selectPrevious = true) => ({
+  select,
+  dispatch
+}) => {
   if (!clientIds || !clientIds.length) {
     return;
   }
 
   clientIds = (0, _lodash.castArray)(clientIds);
-  const rootClientId = yield _data.controls.select(_constants.STORE_NAME, 'getBlockRootClientId', clientIds[0]);
-  const isLocked = yield _data.controls.select(_constants.STORE_NAME, '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 _data.controls.select(_constants.STORE_NAME, '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.
@@ -846,9 +879,13 @@ function* removeBlocks(clientIds, selectPrevious = true) {
  */
 
 
+exports.removeBlocks = removeBlocks;
+
 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.
@@ -862,6 +899,7 @@ function removeBlock(clientId, selectPrevious) {
 
 
 function replaceInnerBlocks(rootClientId, blocks, updateSelection = false, initialPosition = 0) {
+  /* eslint-enable jsdoc/valid-types */
   return {
     type: 'REPLACE_INNER_BLOCKS',
     rootClientId,
@@ -963,8 +1001,7 @@ 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.
@@ -985,8 +1022,7 @@ 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
@@ -1009,7 +1045,7 @@ 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.
@@ -1027,7 +1063,7 @@ 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
  *
@@ -1042,7 +1078,7 @@ 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.
@@ -1060,7 +1096,7 @@ 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.
  */
@@ -1072,7 +1108,7 @@ 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.
  */
@@ -1084,151 +1120,180 @@ 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.
  */
 
 
-function* __unstableMarkAutomaticChange() {
-  yield {
+const __unstableMarkAutomaticChange = () => ({
+  dispatch
+}) => {
+  dispatch({
     type: 'MARK_AUTOMATIC_CHANGE'
-  };
-  yield (0, _controls.__unstableMarkAutomaticChangeFinalControl)();
-}
-
-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.
  */
 
 
-function* setNavigationMode(isNavigationMode = true) {
-  yield {
+exports.__unstableMarkAutomaticChange = __unstableMarkAutomaticChange;
+
+const setNavigationMode = (isNavigationMode = true) => ({
+  dispatch
+}) => {
+  dispatch({
     type: 'SET_NAVIGATION_MODE',
     isNavigationMode
-  };
+  });
 
   if (isNavigationMode) {
     (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 {
     (0, _a11y.speak)((0, _i18n.__)('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.
  */
 
 
-function* setBlockMovingClientId(hasBlockMovingClientId = null) {
-  yield {
+exports.setNavigationMode = setNavigationMode;
+
+const setBlockMovingClientId = (hasBlockMovingClientId = null) => ({
+  dispatch
+}) => {
+  dispatch({
     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.'));
   }
-}
+};
 /**
- * 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
  */
 
 
-function* duplicateBlocks(clientIds, updateSelection = true) {
-  if (!clientIds && !clientIds.length) {
+exports.setBlockMovingClientId = setBlockMovingClientId;
+
+const duplicateBlocks = (clientIds, updateSelection = true) => ({
+  select,
+  dispatch
+}) => {
+  if (!clientIds || !clientIds.length) {
     return;
-  }
+  } // Return early if blocks don't exist.
+
 
-  const blocks = yield _data.controls.select(_constants.STORE_NAME, 'getBlocksByClientId', clientIds);
-  const rootClientId = yield _data.controls.select(_constants.STORE_NAME, 'getBlockRootClientId', clientIds[0]); // Return early if blocks don't exist.
+  const blocks = select.getBlocksByClientId(clientIds);
 
   if ((0, _lodash.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.
+  const blockNames = blocks.map(block => block.name);
 
-  if ((0, _lodash.some)(blockNames, blockName => !(0, _blocks.hasBlockSupport)(blockName, 'multiple', true))) {
+  if (blockNames.some(blockName => !(0, _blocks.hasBlockSupport)(blockName, 'multiple', true))) {
     return;
   }
 
-  const lastSelectedIndex = yield _data.controls.select(_constants.STORE_NAME, 'getBlockIndex', (0, _lodash.last)((0, _lodash.castArray)(clientIds)), rootClientId);
+  const rootClientId = select.getBlockRootClientId(clientIds[0]);
+  const lastSelectedIndex = select.getBlockIndex((0, _lodash.last)((0, _lodash.castArray)(clientIds)), rootClientId);
   const clonedBlocks = blocks.map(block => (0, _blocks.__experimentalCloneSanitizedBlock)(block));
-  yield insertBlocks(clonedBlocks, lastSelectedIndex + 1, rootClientId, updateSelection);
+  dispatch.insertBlocks(clonedBlocks, lastSelectedIndex + 1, rootClientId, updateSelection);
 
   if (clonedBlocks.length > 1 && updateSelection) {
-    yield multiSelect((0, _lodash.first)(clonedBlocks).clientId, (0, _lodash.last)(clonedBlocks).clientId);
+    dispatch.multiSelect((0, _lodash.first)(clonedBlocks).clientId, (0, _lodash.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
  */
 
 
-function* insertBeforeBlock(clientId) {
+exports.duplicateBlocks = duplicateBlocks;
+
+const insertBeforeBlock = clientId => ({
+  select,
+  dispatch
+}) => {
   if (!clientId) {
     return;
   }
 
-  const rootClientId = yield _data.controls.select(_constants.STORE_NAME, 'getBlockRootClientId', clientId);
-  const isLocked = yield _data.controls.select(_constants.STORE_NAME, 'getTemplateLock', rootClientId);
+  const rootClientId = select.getBlockRootClientId(clientId);
+  const isLocked = select.getTemplateLock(rootClientId);
 
   if (isLocked) {
     return;
   }
 
-  const firstSelectedIndex = yield _data.controls.select(_constants.STORE_NAME, '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
  */
 
 
-function* insertAfterBlock(clientId) {
+exports.insertBeforeBlock = insertBeforeBlock;
+
+const insertAfterBlock = clientId => ({
+  select,
+  dispatch
+}) => {
   if (!clientId) {
     return;
   }
 
-  const rootClientId = yield _data.controls.select(_constants.STORE_NAME, 'getBlockRootClientId', clientId);
-  const isLocked = yield _data.controls.select(_constants.STORE_NAME, 'getTemplateLock', rootClientId);
+  const rootClientId = select.getBlockRootClientId(clientId);
+  const isLocked = select.getTemplateLock(rootClientId);
 
   if (isLocked) {
     return;
   }
 
-  const firstSelectedIndex = yield _data.controls.select(_constants.STORE_NAME, '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.
  */
 
 
+exports.insertAfterBlock = insertAfterBlock;
+
 function toggleBlockHighlight(clientId, isHighlighted) {
   return {
     type: 'TOGGLE_BLOCK_HIGHLIGHT',
@@ -1237,29 +1302,29 @@ 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.
  */
 
 
-function* flashBlock(clientId) {
-  yield toggleBlockHighlight(clientId, true);
-  yield {
-    type: 'SLEEP',
-    duration: 150
-  };
-  yield toggleBlockHighlight(clientId, false);
-}
+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.
  */
 
 
+exports.flashBlock = flashBlock;
+
 function setHasControlledInnerBlocks(clientId, hasControlledInnerBlocks) {
   return {
     type: 'SET_HAS_CONTROLLED_INNER_BLOCKS',