Merge changes published in the Gutenberg plugin "release/10.2" branch

.eslintrc.js

@@ -2,6 +2,8 @@
  * External dependencies
  */
 const { escapeRegExp } = require( 'lodash' );
+const glob = require( 'glob' ).sync;
+const { join } = require( 'path' );
 
 /**
  * Internal dependencies
@@ -28,6 +30,11 @@ const developmentFiles = [
 	'**/@(storybook|stories)/**/*.js',
 ];
 
+// All files from packages that have types provided with TypeScript.
+const typedFiles = glob( 'packages/*/package.json' )
+	.filter( ( fileName ) => require( join( __dirname, fileName ) ).types )
+	.map( ( fileName ) => fileName.replace( 'package.json', '**/*.js' ) );
+
 module.exports = {
 	root: true,
 	extends: [
@@ -54,6 +61,9 @@ module.exports = {
 			},
 		],
 		'@wordpress/no-unsafe-wp-apis': 'off',
+		'@wordpress/data-no-store-string-literals': 'warn',
+		'import/default': 'error',
+		'import/named': 'error',
 		'no-restricted-imports': [
 			'error',
 			{
@@ -152,6 +162,7 @@ module.exports = {
 			rules: {
 				'import/no-extraneous-dependencies': 'off',
 				'import/no-unresolved': 'off',
+				'import/named': 'off',
 			},
 		},
 		{
@@ -199,5 +210,12 @@ module.exports = {
 				'no-console': 'off',
 			},
 		},
+		{
+			files: typedFiles,
+			rules: {
+				'jsdoc/no-undefined-types': 'off',
+				'jsdoc/valid-types': 'off',
+			},
+		},
 	],
 };

.github/CODEOWNERS

@@ -46,20 +46,21 @@
 /bin                                            @ntwb @nerrad @ajitbohra
 /bin/api-docs                                   @ntwb @nerrad @ajitbohra @nosolosw
 /docs/tool                                      @chrisvanpatten @ajitbohra @nosolosw
-/packages/babel-plugin-import-jsx-pragma        @gziolo @ntwb @nerrad @ajitbohra
+/packages/babel-plugin-import-jsx-pragma        @ntwb @nerrad @ajitbohra
 /packages/babel-plugin-makepot                  @ntwb @nerrad @ajitbohra
 /packages/babel-preset-default                  @gziolo @ntwb @nerrad @ajitbohra
-/packages/browserslist-config                   @gziolo @ntwb @nerrad @ajitbohra
+/packages/browserslist-config                   @ntwb @nerrad @ajitbohra
 /packages/create-block                          @gziolo @mkaz
+/packages/create-block-tutorial-template        @gziolo
 /packages/custom-templated-path-webpack-plugin  @ntwb @nerrad @ajitbohra
 /packages/docgen                                @nosolosw
-/packages/e2e-test-utils                        @gziolo @ntwb @nerrad @ajitbohra
+/packages/e2e-test-utils                        @ntwb @nerrad @ajitbohra
 /packages/e2e-tests                             @ntwb @nerrad @ajitbohra
 /packages/eslint-plugin                         @gziolo @ntwb @nerrad @ajitbohra
 /packages/jest-console                          @gziolo @ntwb @nerrad @ajitbohra
 /packages/jest-preset-default                   @gziolo @ntwb @nerrad @ajitbohra
 /packages/jest-puppeteer-axe                    @gziolo @ntwb @nerrad @ajitbohra
-/packages/library-export-default-webpack-plugin @gziolo @ntwb @nerrad @ajitbohra
+/packages/library-export-default-webpack-plugin @ntwb @nerrad @ajitbohra
 /packages/npm-package-json-lint-config          @gziolo @ntwb @nerrad @ajitbohra
 /packages/postcss-themes                        @ntwb @nerrad @ajitbohra
 /packages/scripts                               @gziolo @ntwb @nerrad @ajitbohra
@@ -97,7 +98,7 @@
 /packages/keyboard-shortcuts
 
 # Extensibility
-/packages/hooks                                 @gziolo @adamsilverstein
+/packages/hooks                                 @adamsilverstein
 /packages/plugins                               @gziolo @adamsilverstein
 
 # Rich Text
@@ -106,7 +107,7 @@
 /packages/block-editor/src/components/rich-text @ellatrix @cameronvoell @guarani
 
 # Project Management
-/.github                                        @mapk @karmatosed
+/.github
 /packages/project-management-automation
 
 # wp-env

.github/ISSUE_TEMPLATE/Bug_report_mobile.md

@@ -1,7 +1,7 @@
 ---
 name: Bug report (Mobile)
 about: Report a bug with the mobile app version of Gutenberg
-labels: Mobile App Android/iOS
+labels: Mobile App - i.e. Android or iOS
 
 ---
 

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,4 @@
-blank_issues_enabled: false
+blank_issues_enabled: true
 contact_links:
   - name: General help request
     url: https://wordpress.org/support/forum/how-to-and-troubleshooting/

.github/PULL_REQUEST_TEMPLATE.md

@@ -20,6 +20,7 @@
 - [ ] My code is tested.
 - [ ] My code follows the WordPress code style. <!-- Check code: `npm run lint`, Guidelines: https://developer.wordpress.org/coding-standards/wordpress-coding-standards/javascript/ -->
 - [ ] My code follows the accessibility standards. <!-- Guidelines: https://developer.wordpress.org/coding-standards/wordpress-coding-standards/accessibility/ -->
+- [ ] I've tested my changes with keyboard and screen readers. <!-- Instructions: https://github.com/WordPress/gutenberg/blob/HEAD/docs/contributors/accessibility-testing.md -->
 - [ ] My code has proper inline documentation. <!-- Guidelines: https://developer.wordpress.org/coding-standards/inline-documentation-standards/javascript/ -->
 - [ ] I've included developer documentation if appropriate. <!-- Handbook: https://developer.wordpress.org/block-editor/ -->
 - [ ] I've updated all React Native files affected by any refactorings/renamings in this PR. <!-- React Native mobile Gutenberg guidelines: https://github.com/WordPress/gutenberg/blob/HEAD/docs/contributors/native-mobile.md -->

.github/workflows/build-plugin-zip.yml

@@ -5,7 +5,7 @@ on:
     paths-ignore:
     - '**.md'
   push:
-    branches: [master]
+    branches: [trunk]
     tags:
       - 'v*'
     paths-ignore:
@@ -17,10 +17,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@master
+        uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f # v2.3.4
 
       - name: Cache node modules
-        uses: actions/cache@v2
+        uses: actions/cache@26968a09c0ea4f3e233fdddbafd1166051a095f6 # v2.1.4
         env:
           cache-name: cache-node-modules
         with:
@@ -33,7 +33,7 @@ jobs:
             ${{ runner.os }}-
 
       - name: Use Node.js 14.x
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@46071b5c7a2e0c34e49c3cb8a0e792e86e18d5ea # v2.1.5
         with:
           node-version: 14.x
 
@@ -43,7 +43,7 @@ jobs:
           NO_CHECKS: 'true'
 
       - name: Upload artifact
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@e448a9b857ee2131e752b06002bf0e093c65e571 # v2.2.2
         with:
           name: gutenberg-plugin
           path: ./gutenberg.zip
@@ -59,7 +59,7 @@ jobs:
         run: echo ::set-output name=version::$(echo $GITHUB_REF | cut -d / -f 3 | sed s/^v// | sed 's/-rc./ RC/' )
 
       - name: Download Plugin Zip Artifact
-        uses: actions/download-artifact@v2
+        uses: actions/download-artifact@4a7a711286f30c025902c28b541c10e147a9b843 # v2.0.8
         with:
           name: gutenberg-plugin
 
@@ -71,7 +71,7 @@ jobs:
 
       - name: Create Release Draft
         id: create_release
-        uses: actions/create-release@v1
+        uses: actions/create-release@0cb9c9b65d5d1901c1f53e5e66eaf4afd303e70e # v1.1.4
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
@@ -83,20 +83,11 @@ jobs:
 
       - name: Upload Release Asset
         id: upload-release-asset
-        uses: actions/[email protected].1
+        uses: actions/upload-release-asset@e8f9f06c4b078e705bd2ea027f0926603fc9b4d5 # v1.0.2
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           upload_url: ${{ steps.create_release.outputs.upload_url }}
           asset_path: ./gutenberg.zip
           asset_name: gutenberg.zip
           asset_content_type: application/zip
-
-      - name: Publish Release
-        run: |
-          curl \
-            --request PATCH \
-            --url https://api.github.com/repos/${{ github.repository }}/releases/${{ steps.create_release.outputs.id }} \
-            --header 'Authorization: token ${{ secrets.GITHUB_TOKEN }}' \
-            --header "Accept: application/vnd.github.v3+json" \
-            --data-raw '{"draft":false}'

.github/workflows/bundle-size.yml

@@ -8,11 +8,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f # v2.3.4
       with:
         fetch-depth: 1
 
-    - uses: preactjs/compressed-size-action@v2
+    - uses: preactjs/compressed-size-action@7d87f60a6b0c7d193b8183ce859ed00b356ea92f # v2.1.0
       with:
         repo-token: "${{ secrets.GITHUB_TOKEN }}"
         pattern: "{build/**/*.js,build/**/*.css}"

.github/workflows/cancel.yml

@@ -9,7 +9,7 @@ jobs:
       - name: Get all workflow ids and set to env variable
         run: echo "WORKFLOW_IDS_TO_CANCEL=$(curl https://api.github.com/repos/${GITHUB_REPOSITORY}/actions/workflows -s | jq -r '.workflows | map(.id|tostring) | join(",")')" >> $GITHUB_ENV
 
-      - uses: styfle/cancel-workflow-action@0.4.0
+      - uses: styfle/cancel-workflow-action@3d86a7cc43670094ac248017207be0295edbc31d # v0.8.0
         with:
           workflow_id: ${{ env.WORKFLOW_IDS_TO_CANCEL }}
           access_token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/create-block.yml

@@ -7,7 +7,7 @@ on:
     - '!packages/**/test/**'
     - '!packages/**/*.md'
   push:
-    branches: [master, wp/trunk]
+    branches: [trunk, wp/trunk]
     paths:
     - 'packages/**'
     - '!packages/**/test/**'
@@ -23,10 +23,10 @@ jobs:
         node: [12, 14]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f # v2.3.4
 
     - name: Cache node modules
-      uses: actions/cache@v2
+      uses: actions/cache@26968a09c0ea4f3e233fdddbafd1166051a095f6 # v2.1.4
       env:
         cache-name: cache-node-modules
       with:
@@ -39,7 +39,7 @@ jobs:
           ${{ runner.os }}-
 
     - name: Use Node.js ${{ matrix.node }}.x
-      uses: actions/setup-node@v1
+      uses: actions/setup-node@46071b5c7a2e0c34e49c3cb8a0e792e86e18d5ea # v2.1.5
       with:
         node-version: ${{ matrix.node }}
 

.github/workflows/end2end-test.yml

@@ -5,7 +5,9 @@ on:
     paths-ignore:
     - '**.md'
   push:
-    branches: [master]
+    branches:
+      - trunk
+      - 'wp/**'
     paths-ignore:
     - '**.md'
 
@@ -22,10 +24,10 @@ jobs:
 
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f # v2.3.4
 
     - name: Cache node modules
-      uses: actions/cache@v2
+      uses: actions/cache@26968a09c0ea4f3e233fdddbafd1166051a095f6 # v2.1.4
       env:
         cache-name: cache-node-modules
       with:
@@ -38,7 +40,7 @@ jobs:
           ${{ runner.os }}-
 
     - name: Use Node.js 14.x
-      uses: actions/setup-node@v1
+      uses: actions/setup-node@46071b5c7a2e0c34e49c3cb8a0e792e86e18d5ea # v2.1.5
       with:
         node-version: 14.x
 
@@ -58,7 +60,7 @@ jobs:
         $( npm bin )/wp-scripts test-e2e --config=./packages/e2e-tests/jest.config.js --cacheDirectory="$HOME/.jest-cache" --runTestsByPath $( awk 'NR % 4 == ${{ matrix.part }} - 1' < ~/.jest-e2e-tests )
 
     - name: Archive debug artifacts (screenshots, HTML snapshots)
-      uses: actions/upload-artifact@v2
+      uses: actions/upload-artifact@e448a9b857ee2131e752b06002bf0e093c65e571 # v2.2.2
       if: always()
       with:
         name: failures-artifacts

.github/workflows/performance.yml

@@ -14,10 +14,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f # v2.3.4
 
     - name: Cache node modules
-      uses: actions/cache@v2
+      uses: actions/cache@26968a09c0ea4f3e233fdddbafd1166051a095f6 # v2.1.4
       env:
         cache-name: cache-node-modules
       with:
@@ -30,17 +30,17 @@ jobs:
           ${{ runner.os }}-
 
     - name: Use Node.js 14.x
-      uses: actions/setup-node@v1
+      uses: actions/setup-node@46071b5c7a2e0c34e49c3cb8a0e792e86e18d5ea # v2.1.5
       with:
         node-version: 14.x
 
     - name: Npm install
       run: |
         npm ci
 
-    - name: Compare performance with master
+    - name: Compare performance with trunk
       if: github.event_name == 'pull_request'
-      run: ./bin/plugin/cli.js perf --ci $GITHUB_SHA master --tests-branch $GITHUB_SHA
+      run: ./bin/plugin/cli.js perf --ci $GITHUB_SHA trunk --tests-branch $GITHUB_SHA
 
     - name: Compare performance with current WordPress Core and previous Gutenberg versions
       if: github.event_name == 'release'
@@ -56,5 +56,5 @@ jobs:
         IFS='.' read -r -a WP_VERSION_ARRAY <<< "$WP_VERSION"
         WP_BRANCH="wp/${WP_VERSION_ARRAY[0]}.${WP_VERSION_ARRAY[1]}"
         ./bin/plugin/cli.js perf --ci $WP_BRANCH $PREVIOUS_RELEASE_BRANCH $CURRENT_RELEASE_BRANCH
-      
+
 

.github/workflows/pull-request-automation.yml

@@ -9,10 +9,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     # Checkout defaults to using the branch which triggered the event, which
-    # isn't necessarily `master` (e.g. in the case of a merge).
-    - uses: actions/checkout@v2
+    # isn't necessarily `trunk` (e.g. in the case of a merge).
+    - uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f # v2.3.4
       with:
-        ref: master
+        ref: trunk
 
     # Changing into the action's directory and running `npm install` is much
     # faster than a full project-wide `npm ci`.