Merge branch 'master' into add/entity-provider-and-refactor-custom-so…

…urces

docs/designers-developers/developers/data/data-core-editor.md

@@ -483,6 +483,8 @@ _Related_
 
 <a name="getReferenceByDistinctEdits" href="#getReferenceByDistinctEdits">#</a> **getReferenceByDistinctEdits**
 
+> **Deprecated** since Gutenberg 6.5.0.
+
 Returns a new reference when edited values have changed. This is useful in
 inferring where an edit has been made between states by comparison of the
 return values using strict equality.

docs/designers-developers/developers/data/data-core.md

@@ -246,6 +246,27 @@ _Returns_
 
 -   `?Object`: The edit.
 
+<a name="getReferenceByDistinctEdits" href="#getReferenceByDistinctEdits">#</a> **getReferenceByDistinctEdits**
+
+Returns a new reference when edited values have changed. This is useful in
+inferring where an edit has been made between states by comparison of the
+return values using strict equality.
+
+_Usage_
+
+    const hasEditOccurred = (
+       getReferenceByDistinctEdits( beforeState ) !==
+       getReferenceByDistinctEdits( afterState )
+    );
+
+_Parameters_
+
+-   _state_ `Object`: Editor state.
+
+_Returns_
+
+-   `*`: A value whose reference will change only when an edit occurs.
+
 <a name="getThemeSupports" href="#getThemeSupports">#</a> **getThemeSupports**
 
 Return theme supports data in the index.

docs/designers-developers/developers/tutorials/block-tutorial/generate-blocks-with-wp-cli.md

@@ -5,7 +5,7 @@ It turns out that writing the simplest possible block which contains only static
 - [zgordon/gutenberg-course](https://github.com/zgordon/gutenberg-course) - a repository for Zac Gordon's Gutenberg Development Course
 - [ahmadawais/create-guten-block](https://github.com/ahmadawais/create-guten-block) - A zero-configuration developer toolkit for building WordPress Gutenberg block plugins
 
-It might be also a good idea to browse the folder with [all core blocks](/packages/block-library/src) to see how they are implemented.
+It might be also a good idea to browse the folder with [all core blocks](https://github.com/WordPress/gutenberg/tree/master/packages/block-library/src) to see how they are implemented.
 
 ## WP-CLI
 

gutenberg.php

@@ -3,7 +3,7 @@
  * Plugin Name: Gutenberg
  * Plugin URI: https://github.com/WordPress/gutenberg
  * Description: Printing since 1440. This is the development plugin for the new block editor in core.
- * Version: 6.4.0
+ * Version: 6.5.0-rc.1
  * Author: Gutenberg Team
  * Text Domain: gutenberg
  *

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "gutenberg",
-	"version": "6.4.0",
+	"version": "6.5.0-rc.1",
 	"private": true,
 	"description": "A new WordPress editor experience.",
 	"author": "The WordPress Contributors",

packages/annotations/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/annotations",
-	"version": "1.6.0",
+	"version": "1.7.0",
 	"description": "Annotate content in the Gutenberg editor.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/api-fetch/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/api-fetch",
-	"version": "3.5.0",
+	"version": "3.6.0",
 	"description": "Utility to make WordPress REST API requests.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/babel-preset-default/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/babel-preset-default",
-	"version": "4.5.0",
+	"version": "4.6.0",
 	"description": "Default Babel preset for WordPress development.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/block-directory/CHANGELOG.md

@@ -1,3 +1,3 @@
-## Master
+## 1.0.0 (2019-09-16)
 
 -   Initial release.

packages/block-directory/package.json

@@ -1,11 +1,11 @@
 {
 	"name": "@wordpress/block-directory",
-	"version": "1.0.0-alpha.0",
+	"version": "1.0.0",
 	"description": "Extend editor with block directory features to search, download and install blocks.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
 	"keywords": [
-		"wordpress",		
+		"wordpress",
 		"block directory"
 	],
 	"homepage": "https://github.com/WordPress/gutenberg/tree/master/packages/block-directory/README.md",

packages/block-editor/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/block-editor",
-	"version": "3.1.0",
+	"version": "3.2.0",
 	"description": "Generic block editor.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/block-library/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/block-library",
-	"version": "2.8.0",
+	"version": "2.9.0",
 	"description": "Block library for the WordPress editor.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/blocks/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/blocks",
-	"version": "6.6.0",
+	"version": "6.7.0",
 	"description": "Block API for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/components/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/components",
-	"version": "8.2.0",
+	"version": "8.3.0",
 	"description": "UI components for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/compose/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/compose",
-	"version": "3.6.0",
+	"version": "3.7.0",
 	"description": "WordPress higher-order components (HOCs).",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/core-data/README.md

@@ -459,6 +459,27 @@ _Returns_
 
 -   `?Object`: The edit.
 
+<a name="getReferenceByDistinctEdits" href="#getReferenceByDistinctEdits">#</a> **getReferenceByDistinctEdits**
+
+Returns a new reference when edited values have changed. This is useful in
+inferring where an edit has been made between states by comparison of the
+return values using strict equality.
+
+_Usage_
+
+    const hasEditOccurred = (
+       getReferenceByDistinctEdits( beforeState ) !==
+       getReferenceByDistinctEdits( afterState )
+    );
+
+_Parameters_
+
+-   _state_ `Object`: Editor state.
+
+_Returns_
+
+-   `*`: A value whose reference will change only when an edit occurs.
+
 <a name="getThemeSupports" href="#getThemeSupports">#</a> **getThemeSupports**
 
 Return theme supports data in the index.

packages/core-data/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/core-data",
-	"version": "2.6.0",
+	"version": "2.7.0",
 	"description": "Access to and manipulation of core WordPress entities.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/core-data/src/selectors.js

@@ -478,3 +478,26 @@ export function getAutosave( state, postType, postId, authorId ) {
 export const hasFetchedAutosaves = createRegistrySelector( ( select ) => ( state, postType, postId ) => {
 	return select( REDUCER_KEY ).hasFinishedResolution( 'getAutosaves', [ postType, postId ] );
 } );
+
+/**
+ * Returns a new reference when edited values have changed. This is useful in
+ * inferring where an edit has been made between states by comparison of the
+ * return values using strict equality.
+ *
+ * @example
+ *
+ * ```
+ * const hasEditOccurred = (
+ *    getReferenceByDistinctEdits( beforeState ) !==
+ *    getReferenceByDistinctEdits( afterState )
+ * );
+ * ```
+ *
+ * @param {Object} state Editor state.
+ *
+ * @return {*} A value whose reference will change only when an edit occurs.
+ */
+export const getReferenceByDistinctEdits = createSelector(
+	() => [],
+	( state ) => [ state.undo.length, state.undo.offset ],
+);

packages/core-data/src/test/selectors.js

@@ -15,6 +15,7 @@ import {
 	getAutosave,
 	getAutosaves,
 	getCurrentUser,
+	getReferenceByDistinctEdits,
 } from '../selectors';
 
 describe( 'getEntityRecord', () => {
@@ -275,3 +276,45 @@ describe( 'getCurrentUser', () => {
 		expect( getCurrentUser( state ) ).toEqual( currentUser );
 	} );
 } );
+
+describe( 'getReferenceByDistinctEdits', () => {
+	it( 'should return referentially equal values across empty states', () => {
+		const state = { undo: [] };
+		expect( getReferenceByDistinctEdits( state ) ).toBe( getReferenceByDistinctEdits( state ) );
+
+		const beforeState = { undo: [] };
+		const afterState = { undo: [] };
+		expect( getReferenceByDistinctEdits( beforeState ) ).toBe( getReferenceByDistinctEdits( afterState ) );
+	} );
+
+	it( 'should return referentially equal values across unchanging non-empty state', () => {
+		const undoStates = [ {} ];
+		const state = { undo: undoStates };
+		expect( getReferenceByDistinctEdits( state ) ).toBe( getReferenceByDistinctEdits( state ) );
+
+		const beforeState = { undo: undoStates };
+		const afterState = { undo: undoStates };
+		expect( getReferenceByDistinctEdits( beforeState ) ).toBe( getReferenceByDistinctEdits( afterState ) );
+	} );
+
+	describe( 'when adding edits', () => {
+		it( 'should return referentially different values across changing states', () => {
+			const beforeState = { undo: [ {} ] };
+			beforeState.undo.offset = 0;
+			const afterState = { undo: [ {}, {} ] };
+			afterState.undo.offset = 1;
+			expect( getReferenceByDistinctEdits( beforeState ) ).not.toBe( getReferenceByDistinctEdits( afterState ) );
+		} );
+	} );
+
+	describe( 'when using undo', () => {
+		it( 'should return referentially different values across changing states', () => {
+			const beforeState = { undo: [ {}, {} ] };
+			beforeState.undo.offset = 1;
+			const afterState = { undo: [ {}, {} ] };
+			afterState.undo.offset = 0;
+			expect( getReferenceByDistinctEdits( beforeState ) ).not.toBe( getReferenceByDistinctEdits( afterState ) );
+		} );
+	} );
+} );
+

packages/data-controls/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/data-controls",
-	"version": "1.2.0",
+	"version": "1.3.0",
 	"description": "A set of common controls for the @wordpress/data api.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/data/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/data",
-	"version": "4.8.0",
+	"version": "4.9.0",
 	"description": "Data module for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/dependency-extraction-webpack-plugin/CHANGELOG.md

@@ -1,4 +1,4 @@
-## Master
+## 2.0.0 (2019-09-16)
 
 ### Breaking Changes
 

packages/dependency-extraction-webpack-plugin/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/dependency-extraction-webpack-plugin",
-	"version": "1.2.0",
+	"version": "2.0.0",
 	"description": "Extract WordPress script dependencies from webpack bundles.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/e2e-test-utils/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/e2e-test-utils",
-	"version": "2.3.0",
+	"version": "2.4.0",
 	"description": "End-To-End (E2E) test utils for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",

packages/e2e-tests/CHANGELOG.md

@@ -1,4 +1,4 @@
-## Master
+## 1.7.0 (2019-09-16)
 
 ## 1.6.0 (2019-09-03)
 

packages/e2e-tests/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/e2e-tests",
-	"version": "1.6.0",
+	"version": "1.7.0",
 	"description": "End-To-End (E2E) tests for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",