@wordpress/block-editor 10.2.0 → 10.3.0

package/build-module/store/actions.js

@@ -12,6 +12,7 @@ import deprecated from '@wordpress/deprecated';
 
 import { mapRichTextSettings } from './utils';
 import { retrieveSelectedAttribute, START_OF_SELECTED_AREA } from '../utils/selection';
+/** @typedef {import('../components/use-on-block-drop/types').WPDropOperation} WPDropOperation */
 
 const castArray = maybeArray => Array.isArray(maybeArray) ? maybeArray : [maybeArray];
 /**
@@ -605,10 +606,13 @@ export const insertBlocks = function (blocks, index, rootClientId) {
 /**
  * Action that shows the insertion point.
  *
- * @param {?string} rootClientId      Optional root client ID of block list on
- *                                    which to insert.
- * @param {?number} index             Index at which block should be inserted.
- * @param {Object}  __unstableOptions Whether or not to show an inserter button.
+ * @param    {?string}         rootClientId           Optional root client ID of block list on
+ *                                                    which to insert.
+ * @param    {?number}         index                  Index at which block should be inserted.
+ * @param    {?Object}         __unstableOptions      Additional options.
+ * @property {boolean}         __unstableWithInserter Whether or not to show an inserter button.
+ * @property {WPDropOperation} operation              The operation to perform when applied,
+ *                                                    either 'insert' or 'replace' for now.
  *
  * @return {Object} Action object.
  */
@@ -617,26 +621,35 @@ export function showInsertionPoint(rootClientId, index) {
   let __unstableOptions = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
 
   const {
-    __unstableWithInserter
+    __unstableWithInserter,
+    operation
   } = __unstableOptions;
   return {
     type: 'SHOW_INSERTION_POINT',
     rootClientId,
     index,
-    __unstableWithInserter
+    __unstableWithInserter,
+    operation
   };
 }
 /**
  * Action that hides the insertion point.
- *
- * @return {Object} Action object.
  */
 
-export function hideInsertionPoint() {
-  return {
+export const hideInsertionPoint = () => _ref11 => {
+  let {
+    select,
+    dispatch
+  } = _ref11;
+
+  if (!select.isBlockInsertionPointVisible()) {
+    return;
+  }
+
+  dispatch({
     type: 'HIDE_INSERTION_POINT'
-  };
-}
+  });
+};
 /**
  * Action that resets the template validity.
  *
@@ -657,11 +670,11 @@ export function setTemplateValidity(isValid) {
  * @return {Object} Action object.
  */
 
-export const synchronizeTemplate = () => _ref11 => {
+export const synchronizeTemplate = () => _ref12 => {
   let {
     select,
     dispatch
-  } = _ref11;
+  } = _ref12;
   dispatch({
     type: 'SYNCHRONIZE_TEMPLATE'
   });
@@ -676,12 +689,12 @@ export const synchronizeTemplate = () => _ref11 => {
  * @param {boolean} isForward
  */
 
-export const __unstableDeleteSelection = isForward => _ref12 => {
+export const __unstableDeleteSelection = isForward => _ref13 => {
   let {
     registry,
     select,
     dispatch
-  } = _ref12;
+  } = _ref13;
   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.
@@ -799,11 +812,11 @@ export const __unstableDeleteSelection = isForward => _ref12 => {
  * Split the current selection.
  */
 
-export const __unstableSplitSelection = () => _ref13 => {
+export const __unstableSplitSelection = () => _ref14 => {
   let {
     select,
     dispatch
-  } = _ref13;
+  } = _ref14;
   const selectionAnchor = select.getSelectionStart();
   const selectionFocus = select.getSelectionEnd();
   if (selectionAnchor.clientId === selectionFocus.clientId) return; // Can't split if the selection is not set.
@@ -874,11 +887,11 @@ export const __unstableSplitSelection = () => _ref13 => {
  * Expand the selection to cover the entire blocks, removing partial selection.
  */
 
-export const __unstableExpandSelection = () => _ref14 => {
+export const __unstableExpandSelection = () => _ref15 => {
   let {
     select,
     dispatch
-  } = _ref14;
+  } = _ref15;
   const selectionAnchor = select.getSelectionStart();
   const selectionFocus = select.getSelectionEnd();
   dispatch.selectionChange({
@@ -897,12 +910,12 @@ export const __unstableExpandSelection = () => _ref14 => {
  * @param {string} secondBlockClientId Client ID of the second block to merge.
  */
 
-export const mergeBlocks = (firstBlockClientId, secondBlockClientId) => _ref15 => {
+export const mergeBlocks = (firstBlockClientId, secondBlockClientId) => _ref16 => {
   let {
     registry,
     select,
     dispatch
-  } = _ref15;
+  } = _ref16;
   const blocks = [firstBlockClientId, secondBlockClientId];
   dispatch({
     type: 'MERGE_BLOCKS',
@@ -1024,11 +1037,11 @@ export const mergeBlocks = (firstBlockClientId, secondBlockClientId) => _ref15 =
 
 export const removeBlocks = function (clientIds) {
   let selectPrevious = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
-  return _ref16 => {
+  return _ref17 => {
     let {
       select,
       dispatch
-    } = _ref16;
+    } = _ref17;
 
     if (!clientIds || !clientIds.length) {
       return;
@@ -1229,10 +1242,10 @@ export function selectionChange(clientId, attributeKey, startOffset, endOffset)
  * @param {?number} index        Optional index where to insert the default block.
  */
 
-export const insertDefaultBlock = (attributes, rootClientId, index) => _ref17 => {
+export const insertDefaultBlock = (attributes, rootClientId, index) => _ref18 => {
   let {
     dispatch
-  } = _ref17;
+  } = _ref18;
   // Abort if there is no default block type (if it has been unregistered).
   const defaultBlockName = getDefaultBlockName();
 
@@ -1321,10 +1334,10 @@ export function __unstableMarkNextChangeAsNotPersistent() {
  * selection changes have been recorded.
  */
 
-export const __unstableMarkAutomaticChange = () => _ref18 => {
+export const __unstableMarkAutomaticChange = () => _ref19 => {
   let {
     dispatch
-  } = _ref18;
+  } = _ref19;
   dispatch({
     type: 'MARK_AUTOMATIC_CHANGE'
   });
@@ -1345,10 +1358,10 @@ export const __unstableMarkAutomaticChange = () => _ref18 => {
 
 export const setNavigationMode = function () {
   let isNavigationMode = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
-  return _ref19 => {
+  return _ref20 => {
     let {
       dispatch
-    } = _ref19;
+    } = _ref20;
 
     dispatch.__unstableSetEditorMode(isNavigationMode ? 'navigation' : 'edit');
   };
@@ -1359,11 +1372,11 @@ export const setNavigationMode = function () {
  * @param {string} mode Editor mode
  */
 
-export const __unstableSetEditorMode = mode => _ref20 => {
+export const __unstableSetEditorMode = mode => _ref21 => {
   let {
     dispatch,
     select
-  } = _ref20;
+  } = _ref21;
 
   // When switching to zoom-out mode, we need to select the root block
   if (mode === 'zoom-out') {
@@ -1395,10 +1408,10 @@ export const __unstableSetEditorMode = mode => _ref20 => {
 
 export const setBlockMovingClientId = function () {
   let hasBlockMovingClientId = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
-  return _ref21 => {
+  return _ref22 => {
     let {
       dispatch
-    } = _ref21;
+    } = _ref22;
     dispatch({
       type: 'SET_BLOCK_MOVING_MODE',
       hasBlockMovingClientId
@@ -1418,11 +1431,11 @@ export const setBlockMovingClientId = function () {
 
 export const duplicateBlocks = function (clientIds) {
   let updateSelection = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
-  return _ref22 => {
+  return _ref23 => {
     let {
       select,
       dispatch
-    } = _ref22;
+    } = _ref23;
 
     if (!clientIds || !clientIds.length) {
       return;
@@ -1461,11 +1474,11 @@ export const duplicateBlocks = function (clientIds) {
  * @param {string} clientId
  */
 
-export const insertBeforeBlock = clientId => _ref23 => {
+export const insertBeforeBlock = clientId => _ref24 => {
   let {
     select,
     dispatch
-  } = _ref23;
+  } = _ref24;
 
   if (!clientId) {
     return;
@@ -1487,11 +1500,11 @@ export const insertBeforeBlock = clientId => _ref23 => {
  * @param {string} clientId
  */
 
-export const insertAfterBlock = clientId => _ref24 => {
+export const insertAfterBlock = clientId => _ref25 => {
   let {
     select,
     dispatch
-  } = _ref24;
+  } = _ref25;
 
   if (!clientId) {
     return;
@@ -1527,10 +1540,10 @@ export function toggleBlockHighlight(clientId, isHighlighted) {
  * @param {string} clientId Target block client ID.
  */
 
-export const flashBlock = clientId => async _ref25 => {
+export const flashBlock = clientId => async _ref26 => {
   let {
     dispatch
-  } = _ref25;
+  } = _ref26;
   dispatch(toggleBlockHighlight(clientId, true));
   await new Promise(resolve => setTimeout(resolve, 150));
   dispatch(toggleBlockHighlight(clientId, false));