@wordpress/block-library 10.4.0 → 10.5.2-next.v.202608281122.0

package/src/group/README.md

@@ -39,7 +39,7 @@ _Defined via the [`supports`](https://developer.wordpress.org/block-editor/refer
 - [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
   - `margin`: `["top","bottom"]`
   - `padding`: `true`
-  - `blockGap`: `true`
+  - `blockGap`: `["horizontal","vertical"]`
 - [`dimensions`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#dimensions):
   - `minHeight`: `true`
   - `minWidth`: `true`
@@ -75,6 +75,6 @@ This is a [**static block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/group/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/group/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/group/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/group/block.json

@@ -47,7 +47,7 @@
 		"spacing": {
 			"margin": [ "top", "bottom" ],
 			"padding": true,
-			"blockGap": true,
+			"blockGap": [ "horizontal", "vertical" ],
 			"__experimentalDefaultControls": {
 				"padding": true,
 				"blockGap": true

package/src/heading/README.md

@@ -55,6 +55,6 @@ This is a [**hybrid block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/heading/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/heading/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/heading/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/heading/transforms.js

@@ -1,4 +1,5 @@
 import { createBlock, getBlockAttributes } from '@wordpress/blocks';
+import { __, sprintf } from '@wordpress/i18n';
 import { getLevelFromHeadingNodeName } from './shared';
 import { getTransformedAttributes } from '../utils/get-transformed-attributes';
 
@@ -8,6 +9,23 @@ const transforms = {
 			type: 'block',
 			isMultiBlock: true,
 			blocks: [ 'core/paragraph' ],
+			// The level shortcuts are declared here as well as on the
+			// variations, so that they reach a paragraph and not only a
+			// heading. Both declarations describe the same shortcut, and only
+			// one of them can apply to any given selection.
+			shortcuts: [ 1, 2, 3, 4, 5, 6 ].map( ( level ) => ( {
+				name: `core/block-editor/transform-to-heading-${ level }`,
+				description: sprintf(
+					/* translators: %d: heading level e.g: "1", "2", "3" */
+					__( 'Transform the selected block into a heading %d.' ),
+					level
+				),
+				keyCombination: {
+					modifier: 'access',
+					character: `${ level }`,
+				},
+				variationName: `h${ level }`,
+			} ) ),
 			transform: ( attributes ) =>
 				attributes.map( ( _attributes ) => {
 					const { content, anchor, style } = _attributes;
@@ -96,6 +114,24 @@ const transforms = {
 			type: 'block',
 			isMultiBlock: true,
 			blocks: [ 'core/paragraph' ],
+			shortcuts: [
+				{
+					name: 'core/block-editor/transform-heading-to-paragraph',
+					description: __(
+						'Transform the selected heading into a paragraph.'
+					),
+					keyCombination: {
+						modifier: 'access',
+						character: '0',
+					},
+					aliases: [
+						{
+							modifier: 'access',
+							character: '7',
+						},
+					],
+				},
+			],
 			transform: ( attributes ) =>
 				attributes.map( ( _attributes ) => {
 					const { content, style } = _attributes;

package/src/heading/variations.js

@@ -33,6 +33,18 @@ const variations = [
 		scope: [ 'block', 'transform' ],
 		keywords: [ `h${ level }` ],
 		isActive: ( blockAttributes ) => blockAttributes.level === level,
+		shortcut: {
+			name: `core/block-editor/transform-to-heading-${ level }`,
+			description: sprintf(
+				/* translators: %d: heading level e.g: "1", "2", "3" */
+				__( 'Transform the selected block into a heading %d.' ),
+				level
+			),
+			keyCombination: {
+				modifier: 'access',
+				character: `${ level }`,
+			},
+		},
 	} ) ),
 ];
 

package/src/home-link/README.md

@@ -61,6 +61,6 @@ This is a [**hybrid block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/home-link/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/home-link/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/home-link/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/home-link/{edit.js → edit.jsx}

@@ -9,7 +9,7 @@ import {
 	Button,
 	CheckboxControl,
 	TextControl,
-	TextareaControl,
+	TextareaControl as WCTextareaControl,
 	__experimentalToolsPanel as ToolsPanel,
 	__experimentalToolsPanelItem as ToolsPanelItem,
 } from '@wordpress/components';
@@ -165,7 +165,7 @@ export default function HomeEdit( { attributes, setAttributes, context } ) {
 						}
 						isShownByDefault
 					>
-						<TextareaControl
+						<WCTextareaControl
 							label={ __( 'Description' ) }
 							value={ description || '' }
 							onChange={ ( descriptionValue ) => {

package/src/html/README.md

@@ -44,6 +44,6 @@ This is a [**static block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/html/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/html/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/html/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/icon/README.md

@@ -59,6 +59,6 @@ In post content, it is stored as a block comment:
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/icon/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/icon/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/icon/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/icon/{edit.js → edit.jsx}

@@ -59,7 +59,15 @@ export function Edit( { attributes, setAttributes } ) {
 	const isContentOnlyMode = useBlockEditingMode() === 'contentOnly';
 
 	const colorProps = useColorProps( attributes );
-	const spacingProps = useSpacingProps( attributes );
+	// Only padding is applied to the inner SVG element, matching the front
+	// end. The margin support is serialized to the block wrapper instead.
+	const spacingProps = useSpacingProps( {
+		style: {
+			spacing: {
+				padding: attributes.style?.spacing?.padding,
+			},
+		},
+	} );
 	const borderProps = useBorderProps( attributes );
 	const dimensionsProps = useDimensionsProps( attributes );
 

package/src/image/README.md

@@ -98,6 +98,6 @@ This is a [**hybrid block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/image/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/image/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/image/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/image/{image.js → image.jsx}

@@ -4,7 +4,7 @@ import {
 	FocalPointPicker,
 	ResizableBox,
 	Spinner,
-	TextareaControl,
+	TextareaControl as WCTextareaControl,
 	TextControl,
 	CheckboxControl,
 	ToolbarButton,
@@ -185,7 +185,7 @@ function ContentOnlyControls( {
 					variant="toolbar"
 				>
 					<div className="wp-block-image__toolbar_content_textarea__container">
-						<TextareaControl
+						<WCTextareaControl
 							className="wp-block-image__toolbar_content_textarea"
 							label={ __( 'Alternative text' ) }
 							value={ attributes.alt || '' }
@@ -918,7 +918,7 @@ export default function Image( {
 							onClick={ openImageMediaEditorModal }
 							aria-haspopup="dialog"
 							icon={ crop }
-							label={ __( 'Crop' ) }
+							label={ __( 'Edit image' ) }
 							// Disable rather than hide while the edited image
 							// loads, so the button keeps focus when the modal
 							// closes instead of dropping it to the canvas.
@@ -1006,7 +1006,7 @@ export default function Image( {
 									setAttributes( { alt: undefined } )
 								}
 							>
-								<TextareaControl
+								<WCTextareaControl
 									label={ __( 'Alternative text' ) }
 									value={ alt || '' }
 									onChange={ updateAlt }

package/src/latest-comments/README.md

@@ -52,6 +52,6 @@ In post content, it is stored as a block comment:
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/latest-comments/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/latest-comments/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/latest-comments/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/latest-posts/README.md

@@ -66,6 +66,6 @@ In post content, it is stored as a block comment:
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/latest-posts/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/latest-posts/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/latest-posts/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/list/README.md

@@ -32,6 +32,7 @@ _Defined via the [`attributes`](https://developer.wordpress.org/block-editor/ref
 _Defined via the [`supports`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/) property in block.json._
 
 - [`anchor`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#anchor): `true`
+- [`align`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#align): `"wide"`, `"full"`
 - [`html`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#html): `false`
 - [`typography`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography):
   - [`fontSize`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography-fontsize): `true`
@@ -65,6 +66,6 @@ This is a [**hybrid block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/list/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/list/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/list/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/list/block.json

@@ -37,6 +37,7 @@
 	},
 	"supports": {
 		"anchor": true,
+		"align": [ "wide", "full" ],
 		"html": false,
 		"__experimentalBorder": {
 			"color": true,

package/src/list-item/README.md

@@ -66,6 +66,6 @@ This is a [**static block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/list-item/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/list-item/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/list-item/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/list-item/hooks/use-merge.js

@@ -9,6 +9,7 @@ export default function useMerge( clientId, onMerge ) {
 		getPreviousBlockClientId,
 		getNextBlockClientId,
 		getBlockOrder,
+		getBlockIndex,
 		getBlockRootClientId,
 		getBlockName,
 		getBlock,
@@ -60,6 +61,18 @@ export default function useMerge( clientId, onMerge ) {
 							clientIdB,
 							clientIdA
 						);
+					} else if (
+						getParentListItemId( clientIdB ) === clientIdA
+					) {
+						// Merging into the parent item's own line: the
+						// children take the item's place in its list, one
+						// level up, since their line moved there.
+						moveBlocksToPosition(
+							getBlockOrder( nestedListClientId ),
+							nestedListClientId,
+							getBlockRootClientId( clientIdB ),
+							getBlockIndex( clientIdB ) + 1
+						);
 					} else {
 						moveBlocksToPosition(
 							getBlockOrder( nestedListClientId ),
@@ -68,7 +81,13 @@ export default function useMerge( clientId, onMerge ) {
 						);
 					}
 				}
+				const listId = getBlockRootClientId( clientIdB );
 				mergeBlocks( clientIdA, clientIdB );
+				// Merging the last item of a nested list into its parent
+				// line leaves the list block empty.
+				if ( ! getBlockOrder( listId ).length ) {
+					removeBlock( listId, false );
+				}
 			} );
 		}
 
@@ -126,24 +145,24 @@ export default function useMerge( clientId, onMerge ) {
 						}
 					}
 				}
-			} else if ( getParentListItemId( nextBlockClientId ) ) {
-				outdentListItem( nextBlockClientId );
 			} else {
 				mergeWithNested( clientId, nextBlockClientId );
 			}
 		} else {
-			// Merging is only done from the top level. For lowel levels, the
-			// list item is outdented instead.
-			if ( getParentListItemId( clientId ) ) {
-				outdentListItem( clientId );
-				return;
-			}
+			// Merge into the previous line: the trailing item of the
+			// previous sibling, or the parent item's own line for a first
+			// child.
 			const previousBlockClientId = getPreviousBlockClientId( clientId );
 			if ( previousBlockClientId ) {
 				const trailingId = getTrailingId( previousBlockClientId );
 				mergeWithNested( trailingId, clientId );
 				return;
 			}
+			const parentListItemId = getParentListItemId( clientId );
+			if ( parentListItemId ) {
+				mergeWithNested( parentListItemId, clientId );
+				return;
+			}
 
 			const blockOrder = getBlockOrder( clientId );
 			if (

package/src/list-item/hooks/use-outdent-list-item.js

@@ -5,12 +5,8 @@ import { cloneBlock } from '@wordpress/blocks';
 
 export default function useOutdentListItem() {
 	const registry = useRegistry();
-	const {
-		moveBlocksToPosition,
-		removeBlock,
-		insertBlock,
-		updateBlockListSettings,
-	} = useDispatch( blockEditorStore );
+	const { moveBlocksToPosition, removeBlock, removeBlocks, insertBlock } =
+		useDispatch( blockEditorStore );
 	const {
 		getBlockRootClientId,
 		getBlockName,
@@ -18,7 +14,6 @@ export default function useOutdentListItem() {
 		getBlockIndex,
 		getSelectedBlockClientIds,
 		getBlock,
-		getBlockListSettings,
 	} = useSelect( blockEditorStore );
 
 	function getParentListItemId( id ) {
@@ -65,29 +60,28 @@ export default function useOutdentListItem() {
 
 		registry.batch( () => {
 			if ( followingListItems.length ) {
-				let nestedListId = getBlockOrder( firstClientId )[ 0 ];
+				const nestedListId = getBlockOrder( firstClientId )[ 0 ];
 
-				if ( ! nestedListId ) {
+				if ( nestedListId ) {
+					moveBlocksToPosition(
+						followingListItems,
+						parentListId,
+						nestedListId
+					);
+				} else {
+					// Insert the list with the items already inside: an
+					// empty list would be scaffolded with the list block
+					// type's template at insertion. Removing the items
+					// first frees them to be reinserted with their client
+					// IDs kept.
 					const nestedListBlock = cloneBlock(
 						getBlock( parentListId ),
 						{},
-						[]
+						followingListItems.map( ( id ) => getBlock( id ) )
 					);
-					nestedListId = nestedListBlock.clientId;
+					removeBlocks( followingListItems, false );
 					insertBlock( nestedListBlock, 0, firstClientId, false );
-					// Immediately update the block list settings, otherwise
-					// blocks can't be moved here due to canInsert checks.
-					updateBlockListSettings(
-						nestedListId,
-						getBlockListSettings( parentListId )
-					);
 				}
-
-				moveBlocksToPosition(
-					followingListItems,
-					parentListId,
-					nestedListId
-				);
 			}
 			moveBlocksToPosition(
 				clientIds,

package/src/loginout/README.md

@@ -51,6 +51,6 @@ In post content, it is stored as a block comment:
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/loginout/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/loginout/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/loginout/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/math/README.md

@@ -45,6 +45,6 @@ This is a [**static block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/math/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/math/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/math/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/math/{edit.js → edit.jsx}

@@ -3,15 +3,10 @@ import {
 	useBlockProps,
 	store as blockEditorStore,
 } from '@wordpress/block-editor';
-import {
-	Popover,
-	privateApis as componentsPrivateApis,
-} from '@wordpress/components';
+import { Popover } from '@wordpress/components';
+import { ValidatedTextareaControl } from '@wordpress/ui';
 import { useState, useEffect, useRef } from '@wordpress/element';
 import { useDispatch } from '@wordpress/data';
-import { unlock } from '../lock-unlock';
-
-const { ValidatedTextareaControl } = unlock( componentsPrivateApis );
 
 export default function MathEdit( { attributes, setAttributes, isSelected } ) {
 	const { latex, mathML } = attributes;
@@ -78,14 +73,14 @@ export default function MathEdit( { attributes, setAttributes, isSelected } ) {
 						<ValidatedTextareaControl
 							label={ __( 'LaTeX math syntax' ) }
 							hideLabelFromVision
-							value={ latex }
+							value={ latex ?? '' }
 							className="wp-block-math__textarea-control"
 							customValidity={
 								error
 									? { type: 'invalid', message: error }
 									: undefined
 							}
-							onChange={ ( newLatex ) => {
+							onValueChange={ ( newLatex ) => {
 								if ( ! latexToMathML ) {
 									setAttributes( { latex: newLatex } );
 									return;

package/src/media-text/README.md

@@ -87,6 +87,6 @@ This is a [**hybrid block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/media-text/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/media-text/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/media-text/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/media-text/{edit.js → edit.jsx}

@@ -15,7 +15,7 @@ import {
 } from '@wordpress/block-editor';
 import {
 	RangeControl,
-	TextareaControl,
+	TextareaControl as WCTextareaControl,
 	ToggleControl,
 	ToolbarButton,
 	ExternalLink,
@@ -431,7 +431,7 @@ function MediaTextEdit( {
 					hasValue={ () => !! mediaAlt }
 					onDeselect={ () => setAttributes( { mediaAlt: '' } ) }
 				>
-					<TextareaControl
+					<WCTextareaControl
 						label={ __( 'Alternative text' ) }
 						value={ mediaAlt }
 						onChange={ onMediaAltChange }

package/src/missing/README.md

@@ -50,6 +50,6 @@ This is a [**static block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/missing/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/missing/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/missing/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/more/README.md

@@ -1,7 +1,7 @@
 # More
 
 <!-- START TOKEN(Autogenerated block API docs) -->
-Content before this block will be shown in the excerpt on your archives page.
+Content before this block is shown in the excerpt on blog and archive pages. Where a theme shows the full content instead, visitors get a “Read more” link to the rest of the post.
 
 - **Name:** `core/more`
 - **Category:** [design](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/)
@@ -44,6 +44,6 @@ This is a [**static block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/more/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/more/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/more/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/more/block.json

@@ -4,7 +4,7 @@
 	"name": "core/more",
 	"title": "More",
 	"category": "design",
-	"description": "Content before this block will be shown in the excerpt on your archives page.",
+	"description": "Content before this block is shown in the excerpt on blog and archive pages. Where a theme shows the full content instead, visitors get a “Read more” link to the rest of the post.",
 	"keywords": [ "read more" ],
 	"textdomain": "default",
 	"attributes": {

package/src/navigation/README.md

@@ -124,6 +124,6 @@ This is a [**hybrid block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/navigation/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/navigation/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/navigation/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/navigation/edit/{overlay-template-part-selector.js → overlay-template-part-selector.jsx}

@@ -8,12 +8,12 @@ import {
 	FlexBlock,
 	FlexItem,
 	__experimentalHStack as HStack,
-	__experimentalText as WCText,
 } from '@wordpress/components';
 import { __, sprintf } from '@wordpress/i18n';
 import { decodeEntities } from '@wordpress/html-entities';
 import { store as noticesStore } from '@wordpress/notices';
 import { plus } from '@wordpress/icons';
+import { Text } from '@wordpress/ui';
 import { createTemplatePartId } from '../../template-part/edit/utils/create-template-part-id';
 import useCreateOverlayTemplatePart from './use-create-overlay';
 import DeletedOverlayWarning from './deleted-overlay-warning';
@@ -343,15 +343,11 @@ export default function OverlayTemplatePartSelector( {
 				alignment="flex-start"
 				className="wp-block-navigation__overlay-help-text-wrapper"
 			>
-				<WCText
-					variant="muted"
-					isBlock
-					className="wp-block-navigation__overlay-help-text"
-				>
+				<Text>
 					{ __(
 						'An overlay template allows you to customize the appearance of the dialog that opens when the menu button is pressed.'
 					) }
-				</WCText>
+				</Text>
 			</HStack>
 		</div>
 	);

package/src/navigation/index.php

@@ -279,8 +279,14 @@ class WP_Navigation_Block_Renderer {
 
 		foreach ( $inner_blocks as $inner_block ) {
 			$inner_block_markup = static::get_markup_for_inner_block( $inner_block );
-			$p                  = new WP_HTML_Tag_Processor( $inner_block_markup );
-			$is_list_item       = $p->next_tag( 'LI' );
+			// Skip hidden blocks (e.g. hidden via block visibility) that render
+			// as an empty string. Without this check, empty markup is mistaken
+			// for a non-list-item and incorrectly closes the open <ul>.
+			if ( '' === $inner_block_markup ) {
+				continue;
+			}
+			$p            = new WP_HTML_Tag_Processor( $inner_block_markup );
+			$is_list_item = $p->next_tag( 'LI' );
 
 			if ( $is_list_item && ! $is_list_open ) {
 				$is_list_open       = true;

package/src/navigation-link/README.md

@@ -88,6 +88,6 @@ This is a [**hybrid block**](https://developer.wordpress.org/block-editor/gettin
 ## Source
 
 - [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/navigation-link/block.json) ([reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
-- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/navigation-link/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/navigation-link/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/navigation-link/shared/{controls.js → controls.jsx}

@@ -4,7 +4,7 @@ import {
 	__experimentalToolsPanelItem as ToolsPanelItem,
 	CheckboxControl,
 	TextControl,
-	TextareaControl,
+	TextareaControl as WCTextareaControl,
 } from '@wordpress/components';
 import { __, sprintf } from '@wordpress/i18n';
 import { __unstableStripHTML as stripHTML } from '@wordpress/dom';
@@ -265,7 +265,7 @@ export function Controls( {
 				onDeselect={ () => setAttributes( { description: '' } ) }
 				isShownByDefault={ ! isContentOnly }
 			>
-				<TextareaControl
+				<WCTextareaControl
 					label={ __( 'Description' ) }
 					value={ description || '' }
 					onChange={ ( descriptionValue ) => {