@wordpress/editor 13.15.0 → 13.17.0

package/build-module/store/actions.js

@@ -9,13 +9,14 @@ import { store as coreStore } from '@wordpress/core-data';
 import { store as blockEditorStore } from '@wordpress/block-editor';
 import { applyFilters } from '@wordpress/hooks';
 import { store as preferencesStore } from '@wordpress/preferences';
+
 /**
  * Internal dependencies
  */
-
 import { TRASH_POST_NOTICE_ID } from './constants';
 import { localAutosaveSet } from './local-autosave';
 import { getNotificationArgumentsForSaveSuccess, getNotificationArgumentsForSaveFail, getNotificationArgumentsForTrashFail } from './utils/notice-builder';
+
 /**
  * Returns an action generator used in signalling that editor has initialized with
  * the specified post object and editor settings.
@@ -24,60 +25,54 @@ import { getNotificationArgumentsForSaveSuccess, getNotificationArgumentsForSave
  * @param {Object} edits    Initial edited attributes object.
  * @param {Array?} template Block Template.
  */
-
 export const setupEditor = (post, edits, template) => ({
   dispatch
 }) => {
-  dispatch.setupEditorState(post); // Apply a template for new posts only, if exists.
-
+  dispatch.setupEditorState(post);
+  // Apply a template for new posts only, if exists.
   const isNewPost = post.status === 'auto-draft';
-
   if (isNewPost && template) {
     // In order to ensure maximum of a single parse during setup, edits are
     // included as part of editor setup action. Assume edited content as
     // canonical if provided, falling back to post.
     let content;
-
     if ('content' in edits) {
       content = edits.content;
     } else {
       content = post.content.raw;
     }
-
     let blocks = parse(content);
     blocks = synchronizeBlocksWithTemplate(blocks, template);
     dispatch.resetEditorBlocks(blocks, {
       __unstableShouldCreateUndoLevel: false
     });
   }
-
   if (edits && Object.values(edits).some(([key, edit]) => {
     var _post$key$raw;
-
     return edit !== ((_post$key$raw = post[key]?.raw) !== null && _post$key$raw !== void 0 ? _post$key$raw : post[key]);
   })) {
     dispatch.editPost(edits);
   }
 };
+
 /**
  * Returns an action object signalling that the editor is being destroyed and
  * that any necessary state or side-effect cleanup should occur.
  *
  * @return {Object} Action object.
  */
-
 export function __experimentalTearDownEditor() {
   return {
     type: 'TEAR_DOWN_EDITOR'
   };
 }
+
 /**
  * Returns an action object used in signalling that the latest version of the
  * post has been received, either by initialization or save.
  *
  * @deprecated Since WordPress 6.0.
  */
-
 export function resetPost() {
   deprecated("wp.data.dispatch( 'core/editor' ).resetPost", {
     since: '6.0',
@@ -88,6 +83,7 @@ export function resetPost() {
     type: 'DO_NOTHING'
   };
 }
+
 /**
  * Returns an action object used in signalling that a patch of updates for the
  * latest version of the post have been received.
@@ -95,7 +91,6 @@ export function resetPost() {
  * @return {Object} Action object.
  * @deprecated since Gutenberg 9.7.0.
  */
-
 export function updatePost() {
   deprecated("wp.data.dispatch( 'core/editor' ).updatePost", {
     since: '5.7',
@@ -105,6 +100,7 @@ export function updatePost() {
     type: 'DO_NOTHING'
   };
 }
+
 /**
  * Returns an action object used to setup the editor state when first opening
  * an editor.
@@ -113,13 +109,13 @@ export function updatePost() {
  *
  * @return {Object} Action object.
  */
-
 export function setupEditorState(post) {
   return {
     type: 'SETUP_EDITOR_STATE',
     post
   };
 }
+
 /**
  * Returns an action object used in signalling that attributes of the post have
  * been edited.
@@ -127,7 +123,6 @@ export function setupEditorState(post) {
  * @param {Object} edits   Post attributes to edit.
  * @param {Object} options Options for the edit.
  */
-
 export const editPost = (edits, options) => ({
   select,
   registry
@@ -138,12 +133,12 @@ export const editPost = (edits, options) => ({
   } = select.getCurrentPost();
   registry.dispatch(coreStore).editEntityRecord('postType', type, id, edits, options);
 };
+
 /**
  * Action for saving the current post in the editor.
  *
  * @param {Object} options
  */
-
 export const savePost = (options = {}) => async ({
   select,
   dispatch,
@@ -152,9 +147,7 @@ export const savePost = (options = {}) => async ({
   if (!select.isEditedPostSaveable()) {
     return;
   }
-
   const content = select.getEditedPostContent();
-
   if (!options.isAutosave) {
     dispatch.editPost({
       content
@@ -162,7 +155,6 @@ export const savePost = (options = {}) => async ({
       undoIgnore: true
     });
   }
-
   const previousRecord = select.getCurrentPost();
   const edits = {
     id: previousRecord.id,
@@ -175,25 +167,21 @@ export const savePost = (options = {}) => async ({
   });
   await registry.dispatch(coreStore).saveEntityRecord('postType', previousRecord.type, edits, options);
   let error = registry.select(coreStore).getLastEntitySaveError('postType', previousRecord.type, previousRecord.id);
-
   if (!error) {
     await applyFilters('editor.__unstableSavePost', Promise.resolve(), options).catch(err => {
       error = err;
     });
   }
-
   dispatch({
     type: 'REQUEST_POST_UPDATE_FINISH',
     options
   });
-
   if (error) {
     const args = getNotificationArgumentsForSaveFail({
       post: previousRecord,
       edits,
       error
     });
-
     if (args.length) {
       registry.dispatch(noticesStore).createErrorNotice(...args);
     }
@@ -205,24 +193,22 @@ export const savePost = (options = {}) => async ({
       postType: await registry.resolveSelect(coreStore).getPostType(updatedRecord.type),
       options
     });
-
     if (args.length) {
       registry.dispatch(noticesStore).createSuccessNotice(...args);
-    } // Make sure that any edits after saving create an undo level and are
+    }
+    // Make sure that any edits after saving create an undo level and are
     // considered for change detection.
-
-
     if (!options.isAutosave) {
       registry.dispatch(blockEditorStore).__unstableMarkLastChangeAsPersistent();
     }
   }
 };
+
 /**
  * Action for refreshing the current post.
  *
  * @deprecated Since WordPress 6.0.
  */
-
 export function refreshPost() {
   deprecated("wp.data.dispatch( 'core/editor' ).refreshPost", {
     since: '6.0',
@@ -233,10 +219,10 @@ export function refreshPost() {
     type: 'DO_NOTHING'
   };
 }
+
 /**
  * Action for trashing the current post in the editor.
  */
-
 export const trashPost = () => async ({
   select,
   dispatch,
@@ -252,7 +238,6 @@ export const trashPost = () => async ({
   dispatch({
     type: 'REQUEST_POST_DELETE_START'
   });
-
   try {
     const post = select.getCurrentPost();
     await apiFetch({
@@ -265,11 +250,11 @@ export const trashPost = () => async ({
       error
     }));
   }
-
   dispatch({
     type: 'REQUEST_POST_DELETE_FINISH'
   });
 };
+
 /**
  * Action that autosaves the current post.  This
  * includes server-side autosaving (default) and client-side (a.k.a. local)
@@ -278,7 +263,6 @@ export const trashPost = () => async ({
  *
  * @param {Object?} options Extra flags to identify the autosave.
  */
-
 export const autosave = ({
   local = false,
   ...options
@@ -302,13 +286,12 @@ export const autosave = ({
 };
 export const __unstableSaveForPreview = ({
   forceIsAutosaveable
-}) => async ({
+} = {}) => async ({
   select,
   dispatch
 }) => {
   if ((forceIsAutosaveable || select.isEditedPostAutosaveable()) && !select.isPostLocked()) {
     const isDraft = ['draft', 'auto-draft'].includes(select.getEditedPostAttribute('status'));
-
     if (isDraft) {
       await dispatch.savePost({
         isPreview: true
@@ -319,33 +302,32 @@ export const __unstableSaveForPreview = ({
       });
     }
   }
-
   return select.getEditedPostPreviewLink();
 };
+
 /**
  * Action that restores last popped state in undo history.
  */
-
 export const redo = () => ({
   registry
 }) => {
   registry.dispatch(coreStore).redo();
 };
+
 /**
  * Action that pops a record from undo history and undoes the edit.
  */
-
 export const undo = () => ({
   registry
 }) => {
   registry.dispatch(coreStore).undo();
 };
+
 /**
  * Action that creates an undo history record.
  *
  * @deprecated Since WordPress 6.0
  */
-
 export function createUndoLevel() {
   deprecated("wp.data.dispatch( 'core/editor' ).createUndoLevel", {
     since: '6.0',
@@ -356,37 +338,38 @@ export function createUndoLevel() {
     type: 'DO_NOTHING'
   };
 }
+
 /**
  * Action that locks the editor.
  *
  * @param {Object} lock Details about the post lock status, user, and nonce.
  * @return {Object} Action object.
  */
-
 export function updatePostLock(lock) {
   return {
     type: 'UPDATE_POST_LOCK',
     lock
   };
 }
+
 /**
  * Enable the publish sidebar.
  */
-
 export const enablePublishSidebar = () => ({
   registry
 }) => {
   registry.dispatch(preferencesStore).set('core/edit-post', 'isPublishSidebarEnabled', true);
 };
+
 /**
  * Disables the publish sidebar.
  */
-
 export const disablePublishSidebar = () => ({
   registry
 }) => {
   registry.dispatch(preferencesStore).set('core/edit-post', 'isPublishSidebarEnabled', false);
 };
+
 /**
  * Action that locks post saving.
  *
@@ -430,13 +413,13 @@ export const disablePublishSidebar = () => ({
  *
  * @return {Object} Action object
  */
-
 export function lockPostSaving(lockName) {
   return {
     type: 'LOCK_POST_SAVING',
     lockName
   };
 }
+
 /**
  * Action that unlocks post saving.
  *
@@ -450,13 +433,13 @@ export function lockPostSaving(lockName) {
  *
  * @return {Object} Action object
  */
-
 export function unlockPostSaving(lockName) {
   return {
     type: 'UNLOCK_POST_SAVING',
     lockName
   };
 }
+
 /**
  * Action that locks post autosaving.
  *
@@ -470,13 +453,13 @@ export function unlockPostSaving(lockName) {
  *
  * @return {Object} Action object
  */
-
 export function lockPostAutosaving(lockName) {
   return {
     type: 'LOCK_POST_AUTOSAVING',
     lockName
   };
 }
+
 /**
  * Action that unlocks post autosaving.
  *
@@ -490,20 +473,19 @@ export function lockPostAutosaving(lockName) {
  *
  * @return {Object} Action object
  */
-
 export function unlockPostAutosaving(lockName) {
   return {
     type: 'UNLOCK_POST_AUTOSAVING',
     lockName
   };
 }
+
 /**
  * Returns an action object used to signal that the blocks have been updated.
  *
  * @param {Array}   blocks  Block Array.
  * @param {?Object} options Optional options.
  */
-
 export const resetEditorBlocks = (blocks, options = {}) => ({
   select,
   dispatch,
@@ -517,30 +499,27 @@ export const resetEditorBlocks = (blocks, options = {}) => ({
     blocks,
     selection
   };
-
   if (__unstableShouldCreateUndoLevel !== false) {
     const {
       id,
       type
     } = select.getCurrentPost();
     const noChange = registry.select(coreStore).getEditedEntityRecord('postType', type, id).blocks === edits.blocks;
-
     if (noChange) {
       registry.dispatch(coreStore).__unstableCreateUndoLevel('postType', type, id);
-
       return;
-    } // We create a new function here on every persistent edit
+    }
+
+    // We create a new function here on every persistent edit
     // to make sure the edit makes the post dirty and creates
     // a new undo level.
-
-
     edits.content = ({
       blocks: blocksForSerialization = []
     }) => __unstableSerializeAndClean(blocksForSerialization);
   }
-
   dispatch.editPost(edits);
 };
+
 /*
  * Returns an action object used in signalling that the post editor settings have been updated.
  *
@@ -548,13 +527,13 @@ export const resetEditorBlocks = (blocks, options = {}) => ({
  *
  * @return {Object} Action object
  */
-
 export function updateEditorSettings(settings) {
   return {
     type: 'UPDATE_EDITOR_SETTINGS',
     settings
   };
 }
+
 /**
  * Backward compatibility
  */
@@ -569,160 +548,159 @@ const getBlockEditorAction = name => (...args) => ({
   });
   registry.dispatch(blockEditorStore)[name](...args);
 };
+
 /**
  * @see resetBlocks in core/block-editor store.
  */
-
-
 export const resetBlocks = getBlockEditorAction('resetBlocks');
+
 /**
  * @see receiveBlocks in core/block-editor store.
  */
-
 export const receiveBlocks = getBlockEditorAction('receiveBlocks');
+
 /**
  * @see updateBlock in core/block-editor store.
  */
-
 export const updateBlock = getBlockEditorAction('updateBlock');
+
 /**
  * @see updateBlockAttributes in core/block-editor store.
  */
-
 export const updateBlockAttributes = getBlockEditorAction('updateBlockAttributes');
+
 /**
  * @see selectBlock in core/block-editor store.
  */
-
 export const selectBlock = getBlockEditorAction('selectBlock');
+
 /**
  * @see startMultiSelect in core/block-editor store.
  */
-
 export const startMultiSelect = getBlockEditorAction('startMultiSelect');
+
 /**
  * @see stopMultiSelect in core/block-editor store.
  */
-
 export const stopMultiSelect = getBlockEditorAction('stopMultiSelect');
+
 /**
  * @see multiSelect in core/block-editor store.
  */
-
 export const multiSelect = getBlockEditorAction('multiSelect');
+
 /**
  * @see clearSelectedBlock in core/block-editor store.
  */
-
 export const clearSelectedBlock = getBlockEditorAction('clearSelectedBlock');
+
 /**
  * @see toggleSelection in core/block-editor store.
  */
-
 export const toggleSelection = getBlockEditorAction('toggleSelection');
+
 /**
  * @see replaceBlocks in core/block-editor store.
  */
-
 export const replaceBlocks = getBlockEditorAction('replaceBlocks');
+
 /**
  * @see replaceBlock in core/block-editor store.
  */
-
 export const replaceBlock = getBlockEditorAction('replaceBlock');
+
 /**
  * @see moveBlocksDown in core/block-editor store.
  */
-
 export const moveBlocksDown = getBlockEditorAction('moveBlocksDown');
+
 /**
  * @see moveBlocksUp in core/block-editor store.
  */
-
 export const moveBlocksUp = getBlockEditorAction('moveBlocksUp');
+
 /**
  * @see moveBlockToPosition in core/block-editor store.
  */
-
 export const moveBlockToPosition = getBlockEditorAction('moveBlockToPosition');
+
 /**
  * @see insertBlock in core/block-editor store.
  */
-
 export const insertBlock = getBlockEditorAction('insertBlock');
+
 /**
  * @see insertBlocks in core/block-editor store.
  */
-
 export const insertBlocks = getBlockEditorAction('insertBlocks');
+
 /**
  * @see showInsertionPoint in core/block-editor store.
  */
-
 export const showInsertionPoint = getBlockEditorAction('showInsertionPoint');
+
 /**
  * @see hideInsertionPoint in core/block-editor store.
  */
-
 export const hideInsertionPoint = getBlockEditorAction('hideInsertionPoint');
+
 /**
  * @see setTemplateValidity in core/block-editor store.
  */
-
 export const setTemplateValidity = getBlockEditorAction('setTemplateValidity');
+
 /**
  * @see synchronizeTemplate in core/block-editor store.
  */
-
 export const synchronizeTemplate = getBlockEditorAction('synchronizeTemplate');
+
 /**
  * @see mergeBlocks in core/block-editor store.
  */
-
 export const mergeBlocks = getBlockEditorAction('mergeBlocks');
+
 /**
  * @see removeBlocks in core/block-editor store.
  */
-
 export const removeBlocks = getBlockEditorAction('removeBlocks');
+
 /**
  * @see removeBlock in core/block-editor store.
  */
-
 export const removeBlock = getBlockEditorAction('removeBlock');
+
 /**
  * @see toggleBlockMode in core/block-editor store.
  */
-
 export const toggleBlockMode = getBlockEditorAction('toggleBlockMode');
+
 /**
  * @see startTyping in core/block-editor store.
  */
-
 export const startTyping = getBlockEditorAction('startTyping');
+
 /**
  * @see stopTyping in core/block-editor store.
  */
-
 export const stopTyping = getBlockEditorAction('stopTyping');
+
 /**
  * @see enterFormattedText in core/block-editor store.
  */
-
 export const enterFormattedText = getBlockEditorAction('enterFormattedText');
+
 /**
  * @see exitFormattedText in core/block-editor store.
  */
-
 export const exitFormattedText = getBlockEditorAction('exitFormattedText');
+
 /**
  * @see insertDefaultBlock in core/block-editor store.
  */
-
 export const insertDefaultBlock = getBlockEditorAction('insertDefaultBlock');
+
 /**
  * @see updateBlockListSettings in core/block-editor store.
  */
-
 export const updateBlockListSettings = getBlockEditorAction('updateBlockListSettings');
 //# sourceMappingURL=actions.js.map