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

Author: gutenbergplugin

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

@@ -29,7 +29,7 @@ jobs:
         name: Compute current and next stable release branches
         runs-on: ubuntu-latest
         permissions:
-          contents: read
+            contents: read
         if: ${{ github.event_name == 'workflow_dispatch' }}
         outputs:
             current_stable_branch: ${{ steps.get_branches.outputs.current_stable_branch }}
@@ -57,7 +57,7 @@ jobs:
         name: Bump version
         runs-on: ubuntu-latest
         permissions:
-          contents: write
+            contents: write
         needs: compute-stable-branches
         if: |
             github.event_name == 'workflow_dispatch' && (
@@ -132,7 +132,7 @@ jobs:
                   github.event.inputs.version == 'stable' ||
                   contains( steps.get_version.outputs.old_version, 'rc' )
               env:
-                 TARGET_BRANCH: ${{ steps.get_version.outputs.release_branch }}
+                  TARGET_BRANCH: ${{ steps.get_version.outputs.release_branch }}
               run: |
                   git fetch --depth=1 origin "$TARGET_BRANCH"
                   git checkout "$TARGET_BRANCH"
@@ -182,7 +182,7 @@ jobs:
         name: Build Release Artifact
         runs-on: ubuntu-latest
         permissions:
-          contents: read
+            contents: read
         needs: bump-version
         if: |
             always() && (
@@ -246,7 +246,7 @@ jobs:
         needs: [bump-version, build]
         runs-on: ubuntu-latest
         permissions:
-          contents: write
+            contents: write
         if: |
             always() &&
             ( needs.build.outputs.job_status == 'failure' ) &&
@@ -302,7 +302,7 @@ jobs:
         needs: [bump-version, build]
         runs-on: ubuntu-latest
         permissions:
-          contents: write
+            contents: write
 
         steps:
             - name: Set Release Version
@@ -349,7 +349,7 @@ jobs:
         name: Publish WordPress packages to npm
         runs-on: ubuntu-latest
         permissions:
-          contents: read
+            contents: read
         environment: WordPress packages
         needs: [bump-version, build]
         if: ${{ endsWith( needs.bump-version.outputs.new_version, '-rc.1' ) }}
@@ -370,7 +370,7 @@ jobs:
                   ref: trunk
                   token: ${{ secrets.GUTENBERG_TOKEN }}
                   show-progress: ${{ runner.debug == '1' && 'true' || 'false' }}
-                  persist-credentials: false
+                  persist-credentials: true
 
             - name: Configure git user name and email (for publishing)
               run: |

.github/workflows/publish-npm-packages.yml

@@ -10,6 +10,7 @@ on:
                 default: 'development'
                 options:
                     - development
+                    - latest
                     - bugfix
                     - wp
             wp_version:
@@ -32,7 +33,7 @@ jobs:
         name: Release - ${{ github.event.inputs.release_type }}
         runs-on: ubuntu-latest
         permissions:
-          contents: read
+            contents: read
         environment: WordPress packages
         steps:
             - name: Checkout (for CLI)
@@ -53,7 +54,7 @@ jobs:
                   ref: trunk
                   token: ${{ secrets.GUTENBERG_TOKEN }}
                   show-progress: ${{ runner.debug == '1' && 'true' || 'false' }}
-                  persist-credentials: false
+                  persist-credentials: true
 
             - name: Checkout (for publishing WP major version)
               if: ${{ github.event.inputs.release_type == 'wp' && github.event.inputs.wp_version }}
@@ -99,6 +100,15 @@ jobs:
               env:
                   NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+            - name: Publish packages based on the latest Gutenberg plugin to npm ("latest" dist-tag)
+              if: ${{ github.event.inputs.release_type == 'latest' }}
+              run: |
+                  cd cli
+                  npm ci
+                  ./bin/plugin/cli.js npm-latest --semver minor --ci --repository-path ../publish
+              env:
+                  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
             - name: Publish packages to npm with bug fixes ("latest" dist-tag)
               if: ${{ github.event.inputs.release_type == 'bugfix' }}
               run: |

.stylelintrc.js

@@ -10,17 +10,17 @@ module.exports = {
 				'flex-direction': '/^(?!(row|column)-reverse).*$/',
 			},
 			{
-				message:
-					'Avoid the flex-direction reverse values. For accessibility reasons, visual, reading, and DOM order must match. Only use the reverse values when they do not affect reading order, meaning, and interaction.',
+				message: ( property, value ) =>
+					`Avoid "${ value }" value for the "${ property }" property. For accessibility reasons, visual, reading, and DOM order must match. Only use the reverse values when they do not affect reading order, meaning, and interaction.`,
 			},
 		],
 		'declaration-property-value-disallowed-list': [
 			{
 				'/.*/': [ '/--wp-components-color-/' ],
 			},
 			{
-				message:
-					'--wp-components-color-* variables are not ready to be used outside of the components package.',
+				message: ( property, value ) =>
+					`Avoid using "${ value }" in "${ property }". --wp-components-color-* variables are not ready to be used outside of the components package.`,
 			},
 		],
 		'font-weight-notation': null,

changelog.txt

@@ -1,8 +1,130 @@
 == Changelog ==
 
-= 20.8.0-rc.1 =
+= 20.9.0-rc.1 =
 
 
+## Changelog
+
+### Enhancements
+
+- Base Styles: Update to modern Sass module system. ([70135](https://github.com/WordPress/gutenberg/pull/70135))
+- Post Publish Panel: Open view post links in a new tab. ([70127](https://github.com/WordPress/gutenberg/pull/70127))
+- Revert Admin bar: Update the Edit Site link. ([69974](https://github.com/WordPress/gutenberg/pull/69974))
+
+#### Block Library
+- Custom HTML: Add role attribute to content in `block.json`. ([70154](https://github.com/WordPress/gutenberg/pull/70154))
+- HTML Block: Remove space below textarea. ([70055](https://github.com/WordPress/gutenberg/pull/70055))
+- Post Navigation Link: Reverse order of variations. ([70149](https://github.com/WordPress/gutenberg/pull/70149))
+- RSS: Add role attribute to content in `block.json`. ([70166](https://github.com/WordPress/gutenberg/pull/70166))
+- Search Block: Move search setting to inspector. ([70144](https://github.com/WordPress/gutenberg/pull/70144))
+
+#### Write mode
+- Details block: Add role attribute to summary. ([70124](https://github.com/WordPress/gutenberg/pull/70124))
+- Enable Code block content editing in contentOnly. ([70111](https://github.com/WordPress/gutenberg/pull/70111))
+- Enable More block's "Read more" text editing in contentOnly mode. ([70100](https://github.com/WordPress/gutenberg/pull/70100))
+- Post blocks: Enhance contentOnly editing experience. ([70148](https://github.com/WordPress/gutenberg/pull/70148))
+- Table Block: Enhance contentOnly Editing Experience. ([70114](https://github.com/WordPress/gutenberg/pull/70114))
+
+#### Components
+- ColorPicker: Add a visual cue when the value is copied. ([70083](https://github.com/WordPress/gutenberg/pull/70083))
+- Snackbar: Add support to open links in new tab. ([69905](https://github.com/WordPress/gutenberg/pull/69905))
+
+#### Block Transforms
+- Block Library: Add missing transforms between Verse and Preformatted blocks. ([70101](https://github.com/WordPress/gutenberg/pull/70101))
+
+#### Global Styles
+- Remove "global" from styles variation in schema descriptions. ([70089](https://github.com/WordPress/gutenberg/pull/70089))
+
+#### Site Editor
+- Move `Styles` to top of sidebar navigation. ([68582](https://github.com/WordPress/gutenberg/pull/68582))
+
+
+### Bug Fixes
+
+- DOM: Add summary element to focusable elements. ([70051](https://github.com/WordPress/gutenberg/pull/70051))
+- Site Editor: Fix PHP warnings in `gutenberg_get_site_editor_redirection`. ([70062](https://github.com/WordPress/gutenberg/pull/70062))
+- URL: Handle HTML entities and ampersand in 'cleanForSlug'. ([70078](https://github.com/WordPress/gutenberg/pull/70078))
+- Workflows: Persist git credentials when publishing packages via Lerna. ([70058](https://github.com/WordPress/gutenberg/pull/70058))
+
+#### Block Library
+- Button: Limit scope of width style for link. ([70054](https://github.com/WordPress/gutenberg/pull/70054))
+- Image: Provide 'defaultValue' for 'ResolutionTool' component. ([70122](https://github.com/WordPress/gutenberg/pull/70122))
+- Post Template: Don't rely on the default 'ignore_sticky' REST API value. ([70020](https://github.com/WordPress/gutenberg/pull/70020))
+
+#### Components
+- Fix Styling for `TextControl`and `TextAreaControl` in dark themes. ([69640](https://github.com/WordPress/gutenberg/pull/69640))
+- Fix `URLPopover` input handling to properly update value. ([70156](https://github.com/WordPress/gutenberg/pull/70156))
+
+#### Post Editor
+- Editor: Honor rich/code editor settings when deriving the editor mode. ([70080](https://github.com/WordPress/gutenberg/pull/70080))
+- Hide "Create template part" menu from block settings dropdown for classic themes. ([65568](https://github.com/WordPress/gutenberg/pull/65568))
+
+#### Block Editor
+- MediaPlaceholder: Fix potential error in 'handleBlocksDrop'. ([70090](https://github.com/WordPress/gutenberg/pull/70090))
+
+
+### Accessibility
+
+- Editor: Add label in`TextareaControl` in CollabSidebar. ([70133](https://github.com/WordPress/gutenberg/pull/70133))
+
+#### Global Styles
+- Background Image Panel: Fix focus loss. ([69813](https://github.com/WordPress/gutenberg/pull/69813))
+- Move `Randomize colors` button to Edit Palette panel. ([70128](https://github.com/WordPress/gutenberg/pull/70128))
+
+
+### Documentation
+
+- Add example doc comment. ([70116](https://github.com/WordPress/gutenberg/pull/70116))
+- Docs: Clarify versions in WordPress page title. ([70112](https://github.com/WordPress/gutenberg/pull/70112))
+- Docs: Fix PEG.js link. ([70082](https://github.com/WordPress/gutenberg/pull/70082))
+- Docs: Interactivity API Block removed. ([69513](https://github.com/WordPress/gutenberg/pull/69513))
+- Modify the spinner example code. ([70084](https://github.com/WordPress/gutenberg/pull/70084))
+- Popover: Update Popover component documentation. ([70106](https://github.com/WordPress/gutenberg/pull/70106))
+- RichText Readme - Fix 404 URL To Mozilla documentation. ([70171](https://github.com/WordPress/gutenberg/pull/70171))
+- Updated backticks to quotes. ([70070](https://github.com/WordPress/gutenberg/pull/70070))
+
+
+### Code Quality
+
+- ServerSideRender: Colocate delayed spinner logic. ([70147](https://github.com/WordPress/gutenberg/pull/70147))
+- Stylelint: Customise warning for `CSS` variables used outside `components` package. ([70108](https://github.com/WordPress/gutenberg/pull/70108))
+- Stylelint: Customise warning message for `flex-direction` warning. ([70057](https://github.com/WordPress/gutenberg/pull/70057))
+
+#### Block Library
+- Blocks: Remove TODO for post comment block conversion. ([70110](https://github.com/WordPress/gutenberg/pull/70110))
+
+#### Components
+- `withIgnoreIMEEvents`: Update documentation for clarity. ([70098](https://github.com/WordPress/gutenberg/pull/70098))
+
+#### Font Library
+- Fix missing trailing period in user message. ([70132](https://github.com/WordPress/gutenberg/pull/70132))
+
+
+### Tools
+
+#### Build Tooling
+- Workflows: Add option for publishing the latest npm packages. ([70079](https://github.com/WordPress/gutenberg/pull/70079))
+
+#### Testing
+- end-to-end Tests: Add test suite for columns block template lock. ([69089](https://github.com/WordPress/gutenberg/pull/69089))
+
+
+## First-time contributors
+
+The following PRs were merged by first-time contributors:
+
+- @jasalt: Docs: Fix PEG.js link. ([70082](https://github.com/WordPress/gutenberg/pull/70082))
+
+
+## Contributors
+
+The following contributors merged PRs in this release:
+
+@carolinan @himanshupathak95 @igorradovanov @im3dabasia @Infinite-Null @jasalt @karthikeya-io @Mamaduka @Mayank-Tripathi32 @peterwilsoncc @SainathPoojary @shimotmk @SirLouen @StevenDufresne @Sukhendu2002 @t-hamano @unscripted @yogeshbhutkar
+
+
+= 20.8.0 =
+
 ## Changelog
 
 ### Enhancements
@@ -147,6 +269,8 @@ The following contributors merged PRs in this release:
 @bph @Debarghya-Banerjee @georgestephanis @himanshupathak95 @im3dabasia @Infinite-Null @johnbillion @jrmd @karthikeya-io @Maikuolan @Mamaduka @Mayank-Tripathi32 @Rishit30G @SH4LIN @shimotmk @stokesman @Sukhendu2002 @t-hamano @yogeshbhutkar
 
 
+
+
 = 20.7.0 =
 
 ## Changelog

docs/contributors/versions-in-wordpress.md

@@ -1,4 +1,4 @@
-# Versions in WordPress
+# Gutenberg versions in WordPress
 
 With each major release of WordPress a new version of Gutenberg is included. This has caused confusion over time as people have tried to figure out how to best debug problems and report bugs appropriately. To make this easier we have made this document to serve as a canonical list of the Gutenberg versions integrated into each major WordPress release. Of note, during the beta period of a WordPress release, additional bug fixes from later Gutenberg releases than those noted are added into the WordPress release where it is needed. If you want details about what's in each Gutenberg release outside of the high level items shared as part of major WordPress releases, please review the [release notes shared on Make Core](https://make.wordpress.org/core/tag/gutenberg-new/).
 

docs/manifest.json

@@ -2388,7 +2388,7 @@
 		"parent": "contributors"
 	},
 	{
-		"title": "Versions in WordPress",
+		"title": "Gutenberg versions in WordPress",
 		"slug": "versions-in-wordpress",
 		"markdown_source": "../docs/contributors/versions-in-wordpress.md",
 		"parent": "contributors"

docs/reference-guides/data/data-core-edit-widgets.md

@@ -140,6 +140,27 @@ _Returns_
 
 Returns whether widget saving is locked.
 
+_Usage_
+
+```jsx
+import { __ } from '@wordpress/i18n';
+import { store as widgetStore } from '@wordpress/edit-widgets';
+import { useSelect } from '@wordpress/data';
+
+const ExampleComponent = () => {
+	const isSavingLocked = useSelect(
+		( select ) => select( widgetStore ).isWidgetSavingLocked(),
+		[]
+	);
+
+	return isSavingLocked ? (
+		<p>{ __( 'Widget saving is locked' ) }</p>
+	) : (
+		<p>{ __( 'Widget saving is not locked' ) }</p>
+	);
+};
+```
+
 _Parameters_
 
 -   _state_ `Object`: Global application state.
@@ -166,6 +187,22 @@ _Returns_
 
 Returns an action object used to signal that widget saving is locked.
 
+_Usage_
+
+```js
+import { store as widgetStore } from '@wordpress/edit-widgets';
+import { useDispatch } from '@wordpress/data';
+
+const ExampleComponent = () => {
+	const { lockWidgetSaving } = useDispatch( widgetStore );
+	return (
+		<Button onClick={ () => lockWidgetSaving( 'lockName' ) }>
+			{ __( 'Lock Widget Saving' ) }
+		</Button>
+	);
+};
+```
+
 _Parameters_
 
 -   _lockName_ `string`: The lock name.
@@ -298,6 +335,22 @@ _Returns_
 
 Returns an action object used to signal that widget saving is unlocked.
 
+_Usage_
+
+```js
+import { store as widgetStore } from '@wordpress/edit-widgets';
+import { useDispatch } from '@wordpress/data';
+
+const ExampleComponent = () => {
+	const { unlockWidgetSaving } = useDispatch( widgetStore );
+	return (
+		<Button onClick={ () => unlockWidgetSaving( 'lockName' ) }>
+			{ __( 'Unlock Widget Saving' ) }
+		</Button>
+	);
+};
+```
+
 _Parameters_
 
 -   _lockName_ `string`: The lock name.

docs/reference-guides/interactivity-api/README.md

@@ -115,7 +115,7 @@ Here you have some more resources to learn/read more about the Interactivity API
 -   [Interactivity API Discussions](https://github.com/WordPress/gutenberg/discussions/52882), especially the [showcase](https://github.com/WordPress/gutenberg/discussions/55642#discussioncomment-9667164) discussions.
 -   [wpmovies.dev](https://wpmovies.dev/) demo and its [wp-movies-demo](https://github.com/WordPress/wp-movies-demo) repo
 -   Examples using the Interactivity API at [block-development-examples](https://github.com/WordPress/block-development-examples):
-    -   [`interactivity-api-block-833d15`](https://github.com/WordPress/block-development-examples/tree/trunk/plugins/interactivity-api-block-833d15)
+    -   [`my-first-interactive-block`](https://github.com/WordPress/block-development-examples/tree/trunk/plugins/my-first-interactive-block)
     -   [`interactivity-api-countdown-3cd73e`](https://github.com/WordPress/block-development-examples/tree/trunk/plugins/interactivity-api-countdown-3cd73e)
     -   [`interactivity-api-quiz-1835fa`](https://github.com/WordPress/block-development-examples/tree/trunk/plugins/interactivity-api-quiz-1835fa)
 

gutenberg.php

@@ -5,7 +5,7 @@
  * Description: Printing since 1440. This is the development plugin for the block editor, site editor, and other future WordPress core functionality.
  * Requires at least: 6.7
  * Requires PHP: 7.2
- * Version: 20.8.0-rc.1
+ * Version: 20.9.0-rc.1
  * Author: Gutenberg Team
  * Text Domain: gutenberg
  *