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

package/src/playlist-track/test/edit.jsx

@@ -0,0 +1,316 @@
+import { act, fireEvent, render, screen, within } from '@testing-library/react';
+import { useDispatch } from '@wordpress/data';
+import PlaylistTrackEdit from '../edit';
+import { PlaylistContext } from '../../playlist/context';
+import { useUploadMediaFromBlobURL } from '../../utils/hooks';
+
+let mockMediaReplaceFlowProps;
+
+jest.mock( '@wordpress/block-editor', () => {
+	const PlainText = jest.requireActual(
+		'../../../../block-editor/src/components/plain-text'
+	).default;
+
+	return {
+		BlockControls: ( { children } ) => <div>{ children }</div>,
+		BlockIcon: () => <span />,
+		InspectorControls: ( { children } ) => <div>{ children }</div>,
+		MediaPlaceholder: () => <div />,
+		MediaReplaceFlow: ( props ) => {
+			mockMediaReplaceFlowProps = props;
+			const { name, onSelect } = props;
+			return <button onClick={ () => onSelect( {} ) }>{ name }</button>;
+		},
+		MediaUpload: ( { render: renderMediaUpload } ) =>
+			renderMediaUpload( { open: jest.fn() } ),
+		MediaUploadCheck: ( { children } ) => <div>{ children }</div>,
+		PlainText,
+		useBlockProps: jest.fn( () => ( {} ) ),
+	};
+} );
+
+jest.mock( '@wordpress/data', () => {
+	const data = jest.requireActual( '@wordpress/data' );
+	const mockUseDispatch = jest.fn();
+
+	return new Proxy( data, {
+		get( target, property ) {
+			if ( property === 'useDispatch' ) {
+				return mockUseDispatch;
+			}
+
+			return target[ property ];
+		},
+	} );
+} );
+
+jest.mock( '@wordpress/notices', () => ( {
+	store: 'core/notices',
+} ) );
+
+jest.mock( '../../utils/hooks', () => ( {
+	useUploadMediaFromBlobURL: jest.fn(),
+} ) );
+
+// The handler only forwards the message to a notice, so its text is
+// irrelevant to what these tests check.
+const UPLOAD_ERROR = 'Upload failed.';
+
+const defaultAttributes = {
+	id: 1,
+	src: 'https://example.com/song.mp3',
+	album: 'Great Album',
+	artist: 'The Artist',
+	image: 'https://example.com/cover.jpg',
+	imageAlt: 'A bright abstract track image',
+	length: '3:45',
+	title: 'Song One',
+};
+
+function renderEdit( props = {} ) {
+	const setAttributes = jest.fn();
+	const setCurrentTrackClientId = props.setCurrentTrackClientId || jest.fn();
+	const removeTrack = props.removeTrack || jest.fn();
+
+	render(
+		<PlaylistContext.Provider
+			value={ {
+				currentTrackClientId: props.currentTrackClientId ?? null,
+				setCurrentTrackClientId,
+				removeTrack,
+			} }
+		>
+			<PlaylistTrackEdit
+				attributes={ {
+					...defaultAttributes,
+					...props.attributes,
+				} }
+				setAttributes={ setAttributes }
+				context={ {
+					showArtists: true,
+					showImages: true,
+					...props.context,
+				} }
+				clientId={ props.clientId || 'playlist-track-client-id' }
+				isSelected={ props.isSelected ?? false }
+			/>
+		</PlaylistContext.Provider>
+	);
+
+	return { setAttributes, setCurrentTrackClientId, removeTrack };
+}
+
+describe( 'PlaylistTrackEdit', () => {
+	beforeEach( () => {
+		mockMediaReplaceFlowProps = undefined;
+		useDispatch.mockReturnValue( {
+			createErrorNotice: jest.fn(),
+		} );
+		useUploadMediaFromBlobURL.mockClear();
+	} );
+
+	it( 'shows the title control for a single selected playlist track', () => {
+		renderEdit( { isSelected: true } );
+
+		expect(
+			screen.getByRole( 'textbox', { name: 'Title' } )
+		).toBeInTheDocument();
+	} );
+
+	it( 'shows the replace track control for a single selected playlist track', () => {
+		renderEdit( { isSelected: true } );
+
+		expect( mockMediaReplaceFlowProps ).toBeDefined();
+	} );
+
+	it( 'does not show the replace track control when multiple playlist tracks are selected', () => {
+		renderEdit( { isSelected: false } );
+
+		expect( mockMediaReplaceFlowProps ).toBeUndefined();
+	} );
+
+	it( 'does not show the title control when multiple playlist tracks are selected', () => {
+		// The track inspector only renders for the selected block, or for the
+		// first block of a same-type multi-selection, where `isSelected` is
+		// false.
+		renderEdit( { isSelected: false } );
+
+		expect(
+			screen.queryByRole( 'textbox', { name: 'Title' } )
+		).not.toBeInTheDocument();
+		expect(
+			screen.getByRole( 'textbox', { name: 'Artist' } )
+		).toBeInTheDocument();
+		expect(
+			screen.getByRole( 'textbox', { name: 'Album' } )
+		).toBeInTheDocument();
+	} );
+
+	it( 'allows the track image alternative text to be edited', () => {
+		const { setAttributes } = renderEdit();
+
+		expect(
+			screen.getByRole( 'link', {
+				name: /Describe the purpose of the image\./,
+			} )
+		).toHaveAttribute(
+			'href',
+			'https://www.w3.org/WAI/tutorials/images/decision-tree/'
+		);
+		expect(
+			screen.queryByText( 'Leave empty if decorative.' )
+		).not.toBeInTheDocument();
+
+		fireEvent.change( screen.getByLabelText( 'Alternative text' ), {
+			target: { value: 'A silver microphone on a red background' },
+		} );
+
+		expect( setAttributes ).toHaveBeenCalledWith( {
+			imageAlt: 'A silver microphone on a red background',
+		} );
+	} );
+
+	it( 'does not show the alternative text control without a track image', () => {
+		renderEdit( {
+			attributes: {
+				image: undefined,
+				imageAlt: undefined,
+			},
+		} );
+
+		expect(
+			screen.queryByLabelText( 'Alternative text' )
+		).not.toBeInTheDocument();
+	} );
+
+	it( 'sets the selected track as the current track', () => {
+		const { setCurrentTrackClientId } = renderEdit( {
+			currentTrackClientId: 'another-track-client-id',
+			isSelected: true,
+		} );
+
+		expect( setCurrentTrackClientId ).toHaveBeenCalledWith(
+			'playlist-track-client-id'
+		);
+	} );
+
+	it( 'does not set a selected placeholder track as the current track', () => {
+		const { setCurrentTrackClientId } = renderEdit( {
+			attributes: {
+				blob: undefined,
+				src: undefined,
+			},
+			currentTrackClientId: 'another-track-client-id',
+			isSelected: true,
+		} );
+
+		expect( setCurrentTrackClientId ).not.toHaveBeenCalled();
+	} );
+
+	it( 'uploads temporary blob tracks', () => {
+		renderEdit( {
+			attributes: {
+				blob: 'blob:https://example.com/temporary-track',
+				length: undefined,
+				src: undefined,
+			},
+		} );
+
+		expect( useUploadMediaFromBlobURL ).toHaveBeenCalledWith(
+			expect.objectContaining( {
+				url: 'blob:https://example.com/temporary-track',
+			} )
+		);
+		const trackButton = screen.getByRole( 'button', {
+			name: /Song One/,
+		} );
+
+		expect(
+			within( trackButton ).getByRole( 'presentation', { hidden: true } )
+		).toBeInTheDocument();
+	} );
+
+	it( 'removes the track when its initial upload fails', () => {
+		const createErrorNotice = jest.fn();
+		const removeBlock = jest.fn();
+		useDispatch.mockReturnValue( { createErrorNotice, removeBlock } );
+
+		const { removeTrack } = renderEdit( {
+			attributes: {
+				blob: 'blob:https://example.com/temporary-track',
+				id: undefined,
+				length: undefined,
+				src: undefined,
+			},
+			clientId: 'temporary-track',
+		} );
+
+		const { onError } = useUploadMediaFromBlobURL.mock.calls[ 0 ][ 0 ];
+		act( () => {
+			onError( UPLOAD_ERROR );
+		} );
+
+		expect( createErrorNotice ).toHaveBeenCalled();
+		// The playlist owns its inner blocks: removing the track directly
+		// would take an unmodified playlist with it.
+		expect( removeTrack ).toHaveBeenCalledWith( 'temporary-track' );
+		expect( removeBlock ).not.toHaveBeenCalled();
+	} );
+
+	// `onUploadError` also fires when replacing an existing track's media, so
+	// removing the block unconditionally would discard the original track.
+	it( 'keeps a track that already has a source when an upload fails', () => {
+		const createErrorNotice = jest.fn();
+		const removeBlock = jest.fn();
+		useDispatch.mockReturnValue( { createErrorNotice, removeBlock } );
+
+		const { setAttributes } = renderEdit( {
+			clientId: 'existing-track',
+			isSelected: true,
+		} );
+
+		// A failed replacement is reported by MediaReplaceFlow, not the
+		// blob uploader, which never runs for a track that has a source.
+		act( () => {
+			mockMediaReplaceFlowProps.onError( UPLOAD_ERROR );
+		} );
+
+		expect( createErrorNotice ).toHaveBeenCalled();
+		expect( removeBlock ).not.toHaveBeenCalled();
+		// The original track is left untouched, so its source still plays.
+		expect( setAttributes ).not.toHaveBeenCalled();
+		expect(
+			screen.getByRole( 'button', { name: /Song One/ } )
+		).toBeInTheDocument();
+	} );
+
+	it( 'preserves the current track source when a replacement upload fails', () => {
+		const { setAttributes } = renderEdit( { isSelected: true } );
+
+		mockMediaReplaceFlowProps.onSelect();
+
+		expect( setAttributes ).toHaveBeenCalledTimes( 1 );
+		expect( setAttributes.mock.calls[ 0 ][ 0 ] ).not.toHaveProperty(
+			'src'
+		);
+	} );
+
+	it( 'accepts raw uploaded attachment data when replacing a track', () => {
+		const { setAttributes } = renderEdit( { isSelected: true } );
+
+		mockMediaReplaceFlowProps.onSelect( {
+			id: 2,
+			source_url: 'https://example.com/replacement.mp3',
+			title: { raw: 'Replacement &amp; Track' },
+		} );
+
+		expect( setAttributes ).toHaveBeenCalledWith(
+			expect.objectContaining( {
+				blob: undefined,
+				id: 2,
+				src: 'https://example.com/replacement.mp3',
+				title: 'Replacement & Track',
+			} )
+		);
+	} );
+} );

package/src/post-author/README.md

@@ -73,6 +73,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/post-author/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/post-author/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-author/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-author-biography/README.md

@@ -54,6 +54,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/post-author-biography/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/post-author-biography/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-author-biography/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-author-name/README.md

@@ -58,6 +58,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/post-author-name/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/post-author-name/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-author-name/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-comment/README.md

@@ -56,6 +56,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/post-comment/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/post-comment/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-comment/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-comments-count/README.md

@@ -53,6 +53,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/post-comments-count/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/post-comments-count/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-comments-count/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-comments-form/README.md

@@ -54,6 +54,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/post-comments-form/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/post-comments-form/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-comments-form/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-comments-form/style.scss

@@ -59,15 +59,6 @@
 		}
 	}
 
-	.comment-form-author,
-	.comment-form-email,
-	.comment-form-url {
-		label {
-			display: block;
-			margin-bottom: 0.25em;
-		}
-	}
-
 	.comment-form-cookies-consent {
 		display: flex;
 		gap: 0.25em;
@@ -85,3 +76,10 @@
 		}
 	}
 }
+
+:where(.wp-block-post-comments-form .comment-form-author label),
+:where(.wp-block-post-comments-form .comment-form-email label),
+:where(.wp-block-post-comments-form .comment-form-url label) {
+	display: block;
+	margin-bottom: 0.25em;
+}

package/src/post-comments-link/README.md

@@ -55,6 +55,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/post-comments-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/post-comments-link/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-comments-link/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-content/README.md

@@ -67,6 +67,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/post-content/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/post-content/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-content/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-content/index.php

@@ -60,7 +60,7 @@ function render_block_core_post_content( $attributes, $content, $block ) {
 		/**
 		 * The allowed tag names match the options offered in the editor.
 		 *
-		 * @see packages/block-library/src/post-content/edit.js
+		 * @see packages/block-library/src/post-content/edit.jsx
 		 */
 		$allowed_tag_names   = array( 'div', 'main', 'section', 'article' );
 		$normalized_tag_name = strtolower( $attributes['tagName'] );

package/src/post-date/README.md

@@ -60,6 +60,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/post-date/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/post-date/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-date/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-excerpt/README.md

@@ -61,6 +61,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/post-excerpt/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/post-excerpt/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-excerpt/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-featured-image/README.md

@@ -81,6 +81,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/post-featured-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/post-featured-image/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-featured-image/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-navigation-link/README.md

@@ -58,6 +58,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/post-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/post-navigation-link/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-navigation-link/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-template/README.md

@@ -67,6 +67,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/post-template/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/post-template/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-template/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-template/{edit.js → edit.jsx}

@@ -14,10 +14,19 @@ import { Spinner, ToolbarGroup } from '@wordpress/components';
 import { store as coreStore } from '@wordpress/core-data';
 import { list, grid } from '@wordpress/icons';
 
+// The Post Template's layout attribute arranges the post items, not the
+// blocks of the template, which always stack vertically inside each post
+// item. Override the inherited layout so inner block UI (movers, inserters,
+// grid controls) doesn't follow the post items' grid.
+const INNER_BLOCKS_LAYOUT = { type: 'default' };
+
 function PostTemplateInnerBlocks( { classList } ) {
 	const innerBlocksProps = useInnerBlocksProps(
 		{ className: clsx( 'wp-block-post', classList ) },
-		{ __unstableDisableLayoutClassNames: true }
+		{
+			__unstableDisableLayoutClassNames: true,
+			layout: INNER_BLOCKS_LAYOUT,
+		}
 	);
 	return <li { ...innerBlocksProps } />;
 }

package/src/post-terms/README.md

@@ -60,6 +60,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/post-terms/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/post-terms/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-terms/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-time-to-read/README.md

@@ -58,6 +58,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/post-time-to-read/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/post-time-to-read/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-time-to-read/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-title/README.md

@@ -64,6 +64,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/post-title/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/post-title/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/post-title/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/post-title/{edit.js → edit.jsx}

@@ -14,7 +14,6 @@ import {
 	__experimentalToolsPanelItem as ToolsPanelItem,
 } from '@wordpress/components';
 import { __ } from '@wordpress/i18n';
-import { createBlock, getDefaultBlockName } from '@wordpress/blocks';
 import { useEntityProp, store as coreStore } from '@wordpress/core-data';
 import { useSelect } from '@wordpress/data';
 import { createInterpolateElement } from '@wordpress/element';
@@ -24,7 +23,6 @@ export default function PostTitleEdit( {
 	attributes: { level, levelOptions, isLink, rel, linkTarget, placeholder },
 	setAttributes,
 	context: { postType, postId, queryId },
-	insertBlocksAfter,
 } ) {
 	const TagName = level === 0 ? 'p' : `h${ level }`;
 	const isDescendentOfQueryLoop = Number.isFinite( queryId );
@@ -56,11 +54,6 @@ export default function PostTitleEdit( {
 		postId
 	);
 	const [ link ] = useEntityProp( 'postType', postType, 'link', postId );
-	const onSplitAtEnd = insertBlocksAfter
-		? () => {
-				insertBlocksAfter( createBlock( getDefaultBlockName() ) );
-		  }
-		: undefined;
 	const blockProps = useBlockProps();
 	const blockEditingMode = useBlockEditingMode();
 	const dropdownMenuProps = useToolsPanelDropdownMenuProps();
@@ -77,7 +70,7 @@ export default function PostTitleEdit( {
 				value={ rawTitle }
 				onChange={ setTitle }
 				__experimentalVersion={ 2 }
-				__unstableOnSplitAtEnd={ onSplitAtEnd }
+				disableLineBreaks
 				{ ...blockProps }
 			/>
 		) : (
@@ -104,7 +97,7 @@ export default function PostTitleEdit( {
 					value={ rawTitle }
 					onChange={ setTitle }
 					__experimentalVersion={ 2 }
-					__unstableOnSplitAtEnd={ onSplitAtEnd }
+					disableLineBreaks
 				/>
 			</TagName>
 		) : (

package/src/preformatted/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/preformatted/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/preformatted/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/preformatted/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/private-apis.js

@@ -1,4 +1,3 @@
-import { default as BlockKeyboardShortcuts } from './block-keyboard-shortcuts';
 import { NAVIGATION_OVERLAY_TEMPLATE_PART_AREA } from './navigation/constants';
 import { NavigationLinkUI } from './navigation/edit/navigation-link-ui';
 import { lock } from './lock-unlock';
@@ -8,7 +7,6 @@ import { lock } from './lock-unlock';
  */
 export const privateApis = {};
 lock( privateApis, {
-	BlockKeyboardShortcuts,
 	NAVIGATION_OVERLAY_TEMPLATE_PART_AREA,
 	NavigationLinkUI,
 } );

package/src/pullquote/README.md

@@ -60,6 +60,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/pullquote/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/pullquote/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/pullquote/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/query/README.md

@@ -29,6 +29,8 @@ _Defined via the [`supports`](https://developer.wordpress.org/block-editor/refer
 - [`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`
 - [`layout`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout): `true`
+- [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
+  - `blockGap`: `true`
 - [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity): `true`
 
 ## Context
@@ -60,6 +62,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/query/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/query/) — browse `edit.js`, `save.js`, `index.php`, and more.
+- [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/query/) — browse the `edit` and `save` source files, `index.php`, and more.
 
 <!-- END TOKEN(Autogenerated block API docs) -->

package/src/query/block.json

@@ -55,6 +55,9 @@
 		"align": [ "wide", "full" ],
 		"html": false,
 		"layout": true,
+		"spacing": {
+			"blockGap": true
+		},
 		"interactivity": true
 	},
 	"editorStyle": "wp-block-query-editor"

package/src/query/edit/inspector-controls/{index.js → index.jsx}

@@ -476,7 +476,10 @@ export default function QueryInspectorControls( props ) {
 					{ showExcludeCurrentControl && (
 						<ToolsPanelItem
 							label={ __( 'Exclude' ) }
-							hasValue={ () => excludeCurrent !== null }
+							hasValue={ () =>
+								excludeCurrent !== undefined &&
+								excludeCurrent !== null
+							}
 							onDeselect={ () =>
 								setQuery( { excludeCurrent: null } )
 							}