Editor: Rename all the hooks moved from blocks to editor

docs/extensibility/autocomplete.md

@@ -1,13 +1,13 @@
 Autocomplete
 ============
 
-Gutenberg provides a `blocks.Autocomplete.completers` filter for extending and overriding the list of autocompleters used by blocks.
+Gutenberg provides a `editor.Autocomplete.completers` filter for extending and overriding the list of autocompleters used by blocks.
 
 The `Autocomplete` component found in `@wordpress/editor` applies this filter. The `@wordpress/components` package provides the foundational `Autocomplete` component that does not apply such a filter, but blocks should generally use the component provided by `@wordpress/editor`.
 
 ### Example
 
-Here is an example of using the `blocks.Autocomplete.completers` filter to add an acronym completer. You can find full documentation for the autocompleter interface with the `Autocomplete` component in the `@wordpress/components` package.
+Here is an example of using the `editor.Autocomplete.completers` filter to add an acronym completer. You can find full documentation for the autocompleter interface with the `Autocomplete` component in the `@wordpress/components` package.
 
 {% codetabs %}
 {% ES5 %}
@@ -46,7 +46,7 @@ function appendAcronymCompleter( completers, blockName ) {
 
 // Adding the filter
 wp.hooks.addFilter(
-	'blocks.Autocomplete.completers',
+	'editor.Autocomplete.completers',
 	'my-plugin/autocompleters/acronyms',
 	appendAcronymCompleter
 );
@@ -81,7 +81,7 @@ function appendAcronymCompleter( completers, blockName ) {
 
 // Adding the filter
 wp.hooks.addFilter(
-	'blocks.Autocomplete.completers',
+	'editor.Autocomplete.completers',
 	'my-plugin/autocompleters/acronym',
 	appendAcronymCompleter
 );

docs/extensibility/extending-blocks.md

@@ -10,10 +10,6 @@ To modify the behavior of existing blocks, Gutenberg exposes the following Filte
 
 Used to filter the block settings. It receives the block settings and the name of the block the registered block as arguments.
 
-#### `blocks.BlockEdit`
-
-Used to modify the block's `edit` component. It receives the original block `edit` component and returns a new wrapped component.
-
 #### `blocks.getSaveElement`
 
 A filter that applies to the result of a block's `save` function. This filter is used to replace or extend the element, for example using `wp.element.cloneElement` to modify the element's props or replace its children, or returning an entirely new element.
@@ -70,6 +66,75 @@ Used internally by the default block (paragraph) to exclude the attributes from
 
 Used to filters an individual transform result from block transformation. All of the original blocks are passed, since transformations are many-to-many, not one-to-one.
 
+#### `editor.BlockEdit`
+
+Used to modify the block's `edit` component. It receives the original block `BlockEdit` component and returns a new wrapped component.
+
+_Example:_
+
+```js
+var el = wp.element.createElement;
+
+var withInspectorControls = wp.element.createHigherOrderComponent( function( BlockEdit ) {
+	return function( props ) {
+		return el(
+			wp.element.Fragment,
+			{},
+			el(
+				BlockEdit,
+				props
+			),
+			el(
+				wp.editor.InspectorControls,
+				{},
+				el(
+					wp.components.PanelBody,
+					{},
+					'My custom control'
+				)
+			)
+		);
+	};
+}, 'withInspectorControls' );
+
+wp.hooks.addFilter( 'editor.BlockEdit', 'my-plugin/with-inspector-controls', withInspectorControls );
+```
+
+#### `editor.BlockListBlock`
+
+Used to modify the block's wrapper component containing the block's `edit` component and all toolbars. It receives the original `BlockListBlock` component and returns a new wrapped component.
+
+_Example:_
+
+```js
+var el = wp.element.createElement;
+
+var withDataAlign = wp.element.createHigherOrderComponent( function( BlockListBlock ) {
+	return function( props ) {
+		var newProps = Object.assign(
+			{},
+			props,
+			{
+				wrapperProps: Object.assign(
+					{},
+					props.wrapperProps,
+					{
+						'data-align': props.block.attributes.align
+					}
+				)
+			}
+		);
+
+		return el(
+			BlockListBlock,
+			newProps
+		);
+	};
+}, 'withAlign' );
+
+wp.hooks.addFilter( 'editor.BlockListBlock', 'my-plugin/with-data-align', withDataAlign );
+```
+
 ## Removing Blocks
 
 ### Using a blacklist

edit-post/hooks/blocks/index.js → edit-post/hooks/components/index.js

@@ -11,7 +11,7 @@ import MediaUpload from './media-upload';
 const replaceMediaUpload = () => MediaUpload;
 
 addFilter(
-	'blocks.MediaUpload',
-	'core/edit-post/blocks/media-upload/replaceMediaUpload',
+	'editor.MediaUpload',
+	'core/edit-post/components/media-upload/replace-media-upload',
 	replaceMediaUpload
 );

edit-post/hooks/index.js

@@ -1,6 +1,6 @@
 /**
  * Internal dependencies
  */
-import './blocks';
+import './components';
 import './more-menu';
 import './validate-multiple-use';

edit-post/hooks/validate-multiple-use/index.js

@@ -125,7 +125,7 @@ function getOutboundType( blockName ) {
 }
 
 addFilter(
-	'blocks.BlockEdit',
-	'core/validation/multiple',
+	'editor.BlockEdit',
+	'core/edit-post/validate-multiple-use/with-multiple-validation',
 	withMultipleValidation
 );

editor/components/autocomplete/README.md

@@ -1,6 +1,6 @@
 Autocomplete
 ============
 
-This is an Autocomplete component for use in block UI. It is based on `Autocomplete` from `@wordpress/components` and takes the same props. In addition, it passes its autocompleters through a `blocks.Autocomplete.completers` filter to give developers an opportunity to override or extend them.
+This is an Autocomplete component for use in block UI. It is based on `Autocomplete` from `@wordpress/components` and takes the same props. In addition, it passes its autocompleters through a `editor.Autocomplete.completers` filter to give developers an opportunity to override or extend them.
 
 The autocompleter interface is documented with the original `Autocomplete` component in `@wordpress/components`.

editor/components/autocomplete/index.js

@@ -78,10 +78,9 @@ export function withFilteredAutocompleters( Autocomplete ) {
 			let nextCompleters = completers;
 			const lastFilteredCompletersProp = nextCompleters;
 
-			// Todo: Rename filter
-			if ( hasFilter( 'blocks.Autocomplete.completers' ) ) {
+			if ( hasFilter( 'editor.Autocomplete.completers' ) ) {
 				nextCompleters = applyFilters(
-					'blocks.Autocomplete.completers',
+					'editor.Autocomplete.completers',
 					// Provide copies so filters may directly modify them.
 					nextCompleters && nextCompleters.map( clone ),
 					blockName,

editor/components/autocomplete/test/index.js

@@ -23,7 +23,7 @@ describe( 'Autocomplete', () => {
 	let wrapper = null;
 
 	afterEach( () => {
-		removeFilter( 'blocks.Autocomplete.completers', 'test/autocompleters-hook' );
+		removeFilter( 'editor.Autocomplete.completers', 'test/autocompleters-hook' );
 
 		if ( wrapper ) {
 			wrapper.unmount();
@@ -34,7 +34,7 @@ describe( 'Autocomplete', () => {
 	it( 'filters supplied completers when next focused', () => {
 		const completersFilter = jest.fn();
 		addFilter(
-			'blocks.Autocomplete.completers',
+			'editor.Autocomplete.completers',
 			'test/autocompleters-hook',
 			completersFilter
 		);
@@ -55,7 +55,7 @@ describe( 'Autocomplete', () => {
 
 		const completersFilter = jest.fn();
 		addFilter(
-			'blocks.Autocomplete.completers',
+			'editor.Autocomplete.completers',
 			'test/autocompleters-hook',
 			completersFilter
 		);
@@ -70,7 +70,7 @@ describe( 'Autocomplete', () => {
 	it( 'provides copies of completers to filter', () => {
 		const completersFilter = jest.fn();
 		addFilter(
-			'blocks.Autocomplete.completers',
+			'editor.Autocomplete.completers',
 			'test/autocompleters-hook',
 			completersFilter
 		);
@@ -91,7 +91,7 @@ describe( 'Autocomplete', () => {
 		const expectedFilteredCompleters = [ {}, {} ];
 		const completersFilter = jest.fn( () => expectedFilteredCompleters );
 		addFilter(
-			'blocks.Autocomplete.completers',
+			'editor.Autocomplete.completers',
 			'test/autocompleters-hook',
 			completersFilter
 		);

editor/components/block-edit/edit.js

@@ -36,4 +36,4 @@ export const Edit = ( props ) => {
 	);
 };
 
-export default withFilters( 'blocks.BlockEdit' )( Edit );
+export default withFilters( 'editor.BlockEdit' )( Edit );

editor/components/media-upload/README.md

@@ -14,8 +14,8 @@ import MediaUpload from './media-upload';
 const replaceMediaUpload = () => MediaUpload;
 
 addFilter(
-	'blocks.MediaUpload',
-	'core/edit-post/blocks/media-upload/replaceMediaUpload',
+	'editor.MediaUpload',
+	'core/edit-post/components/media-upload/replace-media-upload',
 	replaceMediaUpload
 );
 ```

editor/components/media-upload/index.js

@@ -6,11 +6,11 @@ import { withFilters } from '@wordpress/components';
 /**
  * This is a placeholder for the media upload component necessary to make it possible to provide
  * an integration with the core blocks that handle media files. By default it renders nothing but
- * it provides a way to have it overridden with the `blocks.MediaUpload` filter.
+ * it provides a way to have it overridden with the `editor.MediaUpload` filter.
  *
  * @return {WPElement} Media upload element.
  */
 const MediaUpload = () => null;
 
 // Todo: rename the filter
-export default withFilters( 'blocks.MediaUpload' )( MediaUpload );
+export default withFilters( 'editor.MediaUpload' )( MediaUpload );

editor/hooks/align.js

@@ -97,7 +97,7 @@ export const withToolbarControls = createHigherOrderComponent( ( BlockEdit ) =>
  * @param  {Function} BlockListBlock Original component
  * @return {Function}                Wrapped component
  */
-export const withAlign = createHigherOrderComponent( ( BlockListBlock ) => {
+export const withDataAlign = createHigherOrderComponent( ( BlockListBlock ) => {
 	return ( props ) => {
 		const { align } = props.block.attributes;
 		const validAlignments = getBlockValidAlignments( props.block.name );
@@ -109,7 +109,7 @@ export const withAlign = createHigherOrderComponent( ( BlockListBlock ) => {
 
 		return <BlockListBlock { ...props } wrapperProps={ wrapperProps } />;
 	};
-}, 'withAlign' );
+}, 'withDataAlign' );
 
 /**
  * Override props assigned to save component to inject alignment class name if
@@ -131,7 +131,7 @@ export function addAssignedAlign( props, blockType, attributes ) {
 }
 
 addFilter( 'blocks.registerBlockType', 'core/align/addAttribute', addAttribute );
-addFilter( 'editor.BlockListBlock', 'core/align/withAlign', withAlign );
-addFilter( 'blocks.BlockEdit', 'core/align/withToolbarControls', withToolbarControls );
+addFilter( 'editor.BlockListBlock', 'core/editor/align/with-data-align', withDataAlign );
+addFilter( 'editor.BlockEdit', 'core/editor/align/with-toolbar-controls', withToolbarControls );
 addFilter( 'blocks.getSaveContent.extraProps', 'core/align/addAssignedAlign', addAssignedAlign );
 

editor/hooks/anchor.js

@@ -104,5 +104,5 @@ export function addSaveProps( extraProps, blockType, attributes ) {
 }
 
 addFilter( 'blocks.registerBlockType', 'core/anchor/attribute', addAttribute );
-addFilter( 'blocks.BlockEdit', 'core/anchor/inspector-control', withInspectorControl );
+addFilter( 'editor.BlockEdit', 'core/editor/anchor/with-inspector-control', withInspectorControl );
 addFilter( 'blocks.getSaveContent.extraProps', 'core/anchor/save-props', addSaveProps );

editor/hooks/custom-class-name.js

@@ -94,5 +94,5 @@ export function addSaveProps( extraProps, blockType, attributes ) {
 }
 
 addFilter( 'blocks.registerBlockType', 'core/custom-class-name/attribute', addAttribute );
-addFilter( 'blocks.BlockEdit', 'core/custom-class-name/inspector-control', withInspectorControl );
+addFilter( 'editor.BlockEdit', 'core/editor/custom-class-name/with-inspector-control', withInspectorControl );
 addFilter( 'blocks.getSaveContent.extraProps', 'core/custom-class-name/save-props', addSaveProps );

editor/hooks/default-autocompleters.js

@@ -40,7 +40,7 @@ function setDefaultCompleters( completers, blockName ) {
 }
 
 addFilter(
-	'blocks.Autocomplete.completers',
-	'blocks/autocompleters/set-default-completers',
+	'editor.Autocomplete.completers',
+	'editor/autocompleters/set-default-completers',
 	setDefaultCompleters
 );

editor/hooks/test/default-autocompleters.js

@@ -14,7 +14,7 @@ describe( 'default-autocompleters', () => {
 	const defaultAutocompleters = [ userAutocompleter ];
 
 	it( 'provides default completers if none are provided', () => {
-		const result = applyFilters( 'blocks.Autocomplete.completers', null, BLOCK_NAME );
+		const result = applyFilters( 'editor.Autocomplete.completers', null, BLOCK_NAME );
 		/*
 		 * Assert structural equality because defaults are provided as a
 		 * list of cloned completers (and not referentially equal).
@@ -24,20 +24,20 @@ describe( 'default-autocompleters', () => {
 
 	it( 'does not provide default completers for empty completer list', () => {
 		const emptyList = [];
-		const result = applyFilters( 'blocks.Autocomplete.completers', emptyList, BLOCK_NAME );
+		const result = applyFilters( 'editor.Autocomplete.completers', emptyList, BLOCK_NAME );
 		// Assert referential equality because the list should be unchanged.
 		expect( result ).toBe( emptyList );
 	} );
 
 	it( 'does not provide default completers for a populated completer list', () => {
 		const populatedList = [ {}, {} ];
-		const result = applyFilters( 'blocks.Autocomplete.completers', populatedList, BLOCK_NAME );
+		const result = applyFilters( 'editor.Autocomplete.completers', populatedList, BLOCK_NAME );
 		// Assert referential equality because the list should be unchanged.
 		expect( result ).toBe( populatedList );
 	} );
 
 	it( 'provides copies of defaults so they may be directly modified', () => {
-		const result = applyFilters( 'blocks.Autocomplete.completers', null, BLOCK_NAME );
+		const result = applyFilters( 'editor.Autocomplete.completers', null, BLOCK_NAME );
 		result.forEach( ( completer, i ) => {
 			const defaultCompleter = defaultAutocompleters[ i ];
 			expect( completer ).not.toBe( defaultCompleter );

test/e2e/test-plugins/hooks-api/index.js

@@ -53,7 +53,7 @@
 	}
 
 	addFilter(
-		'blocks.BlockEdit',
+		'editor.BlockEdit',
 		'e2e/hooks-api/add-reset-block-button',
 		addResetBlockButton,
 		100