@wordpress/block-editor 8.5.4 → 9.0.0

package/build-module/store/selectors.js

@@ -13,6 +13,7 @@ import { applyFilters } from '@wordpress/hooks';
 import { symbol } from '@wordpress/icons';
 import { __ } from '@wordpress/i18n';
 import { create, remove, toHTMLString } from '@wordpress/rich-text';
+import deprecated from '@wordpress/deprecated';
 /**
  * Internal dependencies
  */
@@ -1205,13 +1206,17 @@ export function isAncestorBeingDragged(state, clientId) {
 /**
  * Returns true if the caret is within formatted text, or false otherwise.
  *
- * @param {Object} state Global application state.
+ * @deprecated
  *
  * @return {boolean} Whether the caret is within formatted text.
  */
 
-export function isCaretWithinFormattedText(state) {
-  return state.isCaretWithinFormattedText;
+export function isCaretWithinFormattedText() {
+  deprecated('wp.data.select( "core/block-editor" ).isCaretWithinFormattedText', {
+    since: '6.1',
+    version: '6.3'
+  });
+  return false;
 }
 /**
  * Returns the insertion point, the index at which the new inserted block would
@@ -1534,6 +1539,28 @@ export function canMoveBlocks(state, clientIds) {
   let rootClientId = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
   return clientIds.every(clientId => canMoveBlock(state, clientId, rootClientId));
 }
+/**
+ * Determines if the given block is allowed to be edited.
+ *
+ * @param {Object} state    Editor state.
+ * @param {string} clientId The block client Id.
+ *
+ * @return {boolean} Whether the given block is allowed to be edited.
+ */
+
+export function canEditBlock(state, clientId) {
+  const attributes = getBlockAttributes(state, clientId);
+
+  if (attributes === null) {
+    return true;
+  }
+
+  const {
+    lock
+  } = attributes; // When the edit is true, we cannot edit the block.
+
+  return !(lock !== null && lock !== void 0 && lock.edit);
+}
 /**
  * Determines if the given block type can be locked/unlocked by a user.
  *
@@ -1865,26 +1892,28 @@ export const getInserterItems = createSelector(function (state) {
  *
  * Items are returned ordered descendingly by their 'frecency'.
  *
- * @param    {Object}  state        Editor state.
- * @param    {?string} rootClientId Optional root client ID of block list.
+ * @param    {Object}          state        Editor state.
+ * @param    {Object|Object[]} blocks       Block object or array objects.
+ * @param    {?string}         rootClientId Optional root client ID of block list.
  *
  * @return {WPEditorTransformItem[]} Items that appear in inserter.
  *
  * @typedef {Object} WPEditorTransformItem
- * @property {string}  id           Unique identifier for the item.
- * @property {string}  name         The type of block to create.
- * @property {string}  title        Title of the item, as it appears in the inserter.
- * @property {string}  icon         Dashicon for the item, as it appears in the inserter.
- * @property {boolean} isDisabled   Whether or not the user should be prevented from inserting
- *                                  this item.
- * @property {number}  frecency     Heuristic that combines frequency and recency.
+ * @property {string}          id           Unique identifier for the item.
+ * @property {string}          name         The type of block to create.
+ * @property {string}          title        Title of the item, as it appears in the inserter.
+ * @property {string}          icon         Dashicon for the item, as it appears in the inserter.
+ * @property {boolean}         isDisabled   Whether or not the user should be prevented from inserting
+ *                                          this item.
+ * @property {number}          frecency     Heuristic that combines frequency and recency.
  */
 
 export const getBlockTransformItems = createSelector(function (state, blocks) {
   var _itemsByName$sourceBl;
 
   let rootClientId = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
-  const [sourceBlock] = blocks;
+  const normalizedBlocks = castArray(blocks);
+  const [sourceBlock] = normalizedBlocks;
   const buildBlockTypeTransformItem = buildBlockTypeItem(state, {
     buildScope: 'transform'
   });
@@ -1902,9 +1931,9 @@ export const getBlockTransformItems = createSelector(function (state, blocks) {
     isDisabled: false,
     name: '*',
     title: __('Unwrap'),
-    icon: (_itemsByName$sourceBl = itemsByName[sourceBlock.name]) === null || _itemsByName$sourceBl === void 0 ? void 0 : _itemsByName$sourceBl.icon
+    icon: (_itemsByName$sourceBl = itemsByName[sourceBlock === null || sourceBlock === void 0 ? void 0 : sourceBlock.name]) === null || _itemsByName$sourceBl === void 0 ? void 0 : _itemsByName$sourceBl.icon
   };
-  const possibleTransforms = getPossibleBlockTransformations(blocks).reduce((accumulator, block) => {
+  const possibleTransforms = getPossibleBlockTransformations(normalizedBlocks).reduce((accumulator, block) => {
     if (block === '*') {
       accumulator.push(itemsByName['*']);
     } else if (itemsByName[block === null || block === void 0 ? void 0 : block.name]) {