@wordpress/block-library 10.6.1-next.v.202609031004.0 → 11.0.0

package/src/playlist/test/edit-component.jsdom.test.jsx

@@ -1,3 +1,4 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { fireEvent, render, screen } from '@testing-library/react';
 import { useDispatch, useSelect } from '@wordpress/data';
 import PlaylistEdit from '../edit';
@@ -8,7 +9,7 @@ let mediaReplaceFlowProps;
 // test can look at what ended up in the tracklist.
 let mockTracks = [];
 
-jest.mock( '@wordpress/block-editor', () => ( {
+vi.mock( '@wordpress/block-editor', () => ( {
 	store: {},
 	BlockControls: ( { children } ) => <div>{ children }</div>,
 	BlockIcon: () => <span />,
@@ -51,19 +52,19 @@ jest.mock( '@wordpress/block-editor', () => ( {
 	} ),
 } ) );
 
-jest.mock( '@wordpress/blocks', () => ( {
-	createBlock: jest.fn( ( name, attributes ) => ( {
+vi.mock( '@wordpress/blocks', () => ( {
+	createBlock: vi.fn( ( name, attributes ) => ( {
 		name,
 		attributes,
 		clientId: 'new-track',
 	} ) ),
 } ) );
 
-jest.mock( '@wordpress/blob', () => ( {
-	createBlobURL: jest.fn( () => 'blob:track' ),
+vi.mock( '@wordpress/blob', () => ( {
+	createBlobURL: vi.fn( () => 'blob:track' ),
 } ) );
 
-jest.mock( '@wordpress/components', () => ( {
+vi.mock( '@wordpress/components', () => ( {
 	Disabled: ( { children } ) => <div>{ children }</div>,
 	SelectControl: () => <div />,
 	ToggleControl: () => <div />,
@@ -71,33 +72,33 @@ jest.mock( '@wordpress/components', () => ( {
 	__experimentalToolsPanelItem: ( { children } ) => <div>{ children }</div>,
 } ) );
 
-jest.mock( '@wordpress/data', () => ( {
-	useDispatch: jest.fn(),
-	useSelect: jest.fn(),
+vi.mock( '@wordpress/data', () => ( {
+	useDispatch: vi.fn(),
+	useSelect: vi.fn(),
 } ) );
 
-jest.mock( '@wordpress/i18n', () => ( {
+vi.mock( '@wordpress/i18n', () => ( {
 	__: ( text ) => text,
 	_x: ( text ) => text,
 } ) );
 
-jest.mock( '@wordpress/icons', () => ( {
+vi.mock( '@wordpress/icons', () => ( {
 	playlist: 'playlist',
 } ) );
 
-jest.mock( '@wordpress/notices', () => ( {
+vi.mock( '@wordpress/notices', () => ( {
 	store: {},
 } ) );
 
-jest.mock( '../../utils/caption', () => ( {
+vi.mock( '../../utils/caption', () => ( {
 	Caption: () => <figcaption />,
 } ) );
 
-jest.mock( '../../utils/hooks', () => ( {
+vi.mock( '../../utils/hooks', () => ( {
 	useToolsPanelDropdownMenuProps: () => ( {} ),
 } ) );
 
-jest.mock( '../../utils/waveform-player', () => ( {
+vi.mock( '../../utils/waveform-player', () => ( {
 	WaveformPlayer: () => <div />,
 } ) );
 
@@ -141,15 +142,15 @@ describe( 'PlaylistEdit', () => {
 	beforeEach( () => {
 		mediaPlaceholderProps = undefined;
 		mediaReplaceFlowProps = undefined;
-		replaceInnerBlocks = jest.fn();
-		insertBlocks = jest.fn();
-		selectBlock = jest.fn();
+		replaceInnerBlocks = vi.fn();
+		insertBlocks = vi.fn();
+		selectBlock = vi.fn();
 		useDispatch.mockReturnValue( {
-			createErrorNotice: jest.fn(),
+			createErrorNotice: vi.fn(),
 			replaceInnerBlocks,
 			insertBlocks,
 			selectBlock,
-			__unstableMarkNextChangeAsNotPersistent: jest.fn(),
+			__unstableMarkNextChangeAsNotPersistent: vi.fn(),
 		} );
 		trackStore( [
 			{
@@ -170,9 +171,9 @@ describe( 'PlaylistEdit', () => {
 			<PlaylistEdit
 				attributes={ defaultAttributes }
 				clientId="playlist-1"
-				insertBlocksAfter={ jest.fn() }
+				insertBlocksAfter={ vi.fn() }
 				isSelected={ false }
-				setAttributes={ jest.fn() }
+				setAttributes={ vi.fn() }
 			/>
 		);
 
@@ -184,9 +185,9 @@ describe( 'PlaylistEdit', () => {
 			<PlaylistEdit
 				attributes={ defaultAttributes }
 				clientId="playlist-1"
-				insertBlocksAfter={ jest.fn() }
+				insertBlocksAfter={ vi.fn() }
 				isSelected={ false }
-				setAttributes={ jest.fn() }
+				setAttributes={ vi.fn() }
 			/>
 		);
 
@@ -201,9 +202,9 @@ describe( 'PlaylistEdit', () => {
 					showTracklist: false,
 				} }
 				clientId="playlist-1"
-				insertBlocksAfter={ jest.fn() }
+				insertBlocksAfter={ vi.fn() }
 				isSelected={ false }
-				setAttributes={ jest.fn() }
+				setAttributes={ vi.fn() }
 			/>
 		);
 
@@ -233,9 +234,9 @@ describe( 'PlaylistEdit', () => {
 			<PlaylistEdit
 				attributes={ defaultAttributes }
 				clientId="playlist-1"
-				insertBlocksAfter={ jest.fn() }
+				insertBlocksAfter={ vi.fn() }
 				isSelected={ false }
-				setAttributes={ jest.fn() }
+				setAttributes={ vi.fn() }
 			/>
 		);
 
@@ -253,9 +254,9 @@ describe( 'PlaylistEdit', () => {
 			<PlaylistEdit
 				attributes={ defaultAttributes }
 				clientId="playlist-1"
-				insertBlocksAfter={ jest.fn() }
+				insertBlocksAfter={ vi.fn() }
 				isSelected={ false }
-				setAttributes={ jest.fn() }
+				setAttributes={ vi.fn() }
 			/>
 		);
 

package/src/playlist/test/edit.jsdom.test.js

@@ -1,3 +1,4 @@
+import { describe, expect, it } from 'vitest';
 import { getTrackAttributes } from '../utils';
 
 describe( 'Playlist block edit utilities', () => {

package/src/playlist/test/transforms.jsdom.test.js

@@ -1,3 +1,4 @@
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
 import {
 	createBlock,
 	getPossibleBlockTransformations,

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

@@ -1,3 +1,4 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { act, fireEvent, render, screen, within } from '@testing-library/react';
 import { useDispatch } from '@wordpress/data';
 import PlaylistTrackEdit from '../edit';
@@ -6,10 +7,10 @@ import { useUploadMediaFromBlobURL } from '../../utils/hooks';
 
 let mockMediaReplaceFlowProps;
 
-jest.mock( '@wordpress/block-editor', () => {
-	const PlainText = jest.requireActual(
+vi.mock( '@wordpress/block-editor', async () => {
+	const { default: PlainText } = await import(
 		'../../../../block-editor/src/components/plain-text'
-	).default;
+	);
 
 	return {
 		BlockControls: ( { children } ) => <div>{ children }</div>,
@@ -22,16 +23,16 @@ jest.mock( '@wordpress/block-editor', () => {
 			return <button onClick={ () => onSelect( {} ) }>{ name }</button>;
 		},
 		MediaUpload: ( { render: renderMediaUpload } ) =>
-			renderMediaUpload( { open: jest.fn() } ),
+			renderMediaUpload( { open: vi.fn() } ),
 		MediaUploadCheck: ( { children } ) => <div>{ children }</div>,
 		PlainText,
-		useBlockProps: jest.fn( () => ( {} ) ),
+		useBlockProps: vi.fn( () => ( {} ) ),
 	};
 } );
 
-jest.mock( '@wordpress/data', () => {
-	const data = jest.requireActual( '@wordpress/data' );
-	const mockUseDispatch = jest.fn();
+vi.mock( import( '@wordpress/data' ), async ( importOriginal ) => {
+	const data = await importOriginal();
+	const mockUseDispatch = vi.fn();
 
 	return new Proxy( data, {
 		get( target, property ) {
@@ -44,12 +45,12 @@ jest.mock( '@wordpress/data', () => {
 	} );
 } );
 
-jest.mock( '@wordpress/notices', () => ( {
+vi.mock( '@wordpress/notices', () => ( {
 	store: 'core/notices',
 } ) );
 
-jest.mock( '../../utils/hooks', () => ( {
-	useUploadMediaFromBlobURL: jest.fn(),
+vi.mock( '../../utils/hooks', () => ( {
+	useUploadMediaFromBlobURL: vi.fn(),
 } ) );
 
 // The handler only forwards the message to a notice, so its text is
@@ -68,9 +69,9 @@ const defaultAttributes = {
 };
 
 function renderEdit( props = {} ) {
-	const setAttributes = jest.fn();
-	const setCurrentTrackClientId = props.setCurrentTrackClientId || jest.fn();
-	const removeTrack = props.removeTrack || jest.fn();
+	const setAttributes = vi.fn();
+	const setCurrentTrackClientId = props.setCurrentTrackClientId || vi.fn();
+	const removeTrack = props.removeTrack || vi.fn();
 
 	render(
 		<PlaylistContext.Provider
@@ -104,7 +105,7 @@ describe( 'PlaylistTrackEdit', () => {
 	beforeEach( () => {
 		mockMediaReplaceFlowProps = undefined;
 		useDispatch.mockReturnValue( {
-			createErrorNotice: jest.fn(),
+			createErrorNotice: vi.fn(),
 		} );
 		useUploadMediaFromBlobURL.mockClear();
 	} );
@@ -231,8 +232,8 @@ describe( 'PlaylistTrackEdit', () => {
 	} );
 
 	it( 'removes the track when its initial upload fails', () => {
-		const createErrorNotice = jest.fn();
-		const removeBlock = jest.fn();
+		const createErrorNotice = vi.fn();
+		const removeBlock = vi.fn();
 		useDispatch.mockReturnValue( { createErrorNotice, removeBlock } );
 
 		const { removeTrack } = renderEdit( {
@@ -260,8 +261,8 @@ describe( 'PlaylistTrackEdit', () => {
 	// `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();
+		const createErrorNotice = vi.fn();
+		const removeBlock = vi.fn();
 		useDispatch.mockReturnValue( { createErrorNotice, removeBlock } );
 
 		const { setAttributes } = renderEdit( {

package/src/post-author/index.php

@@ -10,9 +10,9 @@
  *
  * @since 5.9.0
  *
- * @param  array    $attributes Block attributes.
- * @param  string   $content    Block default content.
- * @param  WP_Block $block      Block instance.
+ * @param array    $attributes Block attributes.
+ * @param string   $content    Block default content.
+ * @param WP_Block $block      Block instance.
  * @return string Returns the rendered author block.
  */
 function render_block_core_post_author( $attributes, $content, $block ) {

package/src/post-author-biography/index.php

@@ -10,9 +10,9 @@
  *
  * @since 6.0.0
  *
- * @param  array    $attributes Block attributes.
- * @param  string   $content    Block default content.
- * @param  WP_Block $block      Block instance.
+ * @param array    $attributes Block attributes.
+ * @param string   $content    Block default content.
+ * @param WP_Block $block      Block instance.
  * @return string Returns the rendered post author biography block.
  */
 function render_block_core_post_author_biography( $attributes, $content, $block ) {

package/src/post-author-name/index.php

@@ -10,9 +10,9 @@
  *
  * @since 6.2.0
  *
- * @param  array    $attributes Block attributes.
- * @param  string   $content    Block default content.
- * @param  WP_Block $block      Block instance.
+ * @param array    $attributes Block attributes.
+ * @param string   $content    Block default content.
+ * @param WP_Block $block      Block instance.
  * @return string Returns the rendered post author name block.
  */
 function render_block_core_post_author_name( $attributes, $content, $block ) {

package/src/post-comments-link/index.php

@@ -10,10 +10,10 @@
  *
  * @since 6.9.0
  *
- * @param  array    $attributes Block attributes.
- * @param  string   $content    Block default content.
- * @param  WP_Block $block      Block instance.
- * @return string   Returns the rendered link.
+ * @param array    $attributes Block attributes.
+ * @param string   $content    Block default content.
+ * @param WP_Block $block      Block instance.
+ * @return string Returns the rendered link.
  */
 function render_block_core_post_comments_link( $attributes, $content, $block ) {
 	if (

package/src/post-date/test/edit.jsdom.test.js

@@ -1,3 +1,4 @@
+import { describe, expect, test } from 'vitest';
 import { is12HourFormat } from '../edit';
 
 describe( 'is12HourFormat', () => {

package/src/post-template/edit.jsx

@@ -75,7 +75,9 @@ export default function PostTemplateEdit( {
 		query: {
 			perPage,
 			offset = 0,
-			postType,
+			// Match `build_query_vars_from_query_block()`, which queries posts when
+			// `query` has no post type.
+			postType = 'post',
 			order,
 			orderBy,
 			author,

package/src/post-time-to-read/index.php

@@ -92,9 +92,9 @@ function block_core_post_time_to_read_word_count( $text, $type ) {
  *
  * @since 6.9.0
  *
- * @param  array    $attributes Block attributes.
- * @param  string   $content    Block default content.
- * @param  WP_Block $block      Block instance.
+ * @param array    $attributes Block attributes.
+ * @param string   $content    Block default content.
+ * @param WP_Block $block      Block instance.
  * @return string Returns the rendered post author name block.
  */
 function render_block_core_post_time_to_read( $attributes, $content, $block ) {

package/src/preformatted/index.js

@@ -1,14 +1,10 @@
 import { __ } from '@wordpress/i18n';
 import { preformatted as icon } from '@wordpress/icons';
-import { privateApis as blocksPrivateApis } from '@wordpress/blocks';
 import initBlock from '../utils/init-block';
 import edit from './edit';
 import metadata from './block.json';
 import save from './save';
 import transforms from './transforms';
-import { unlock } from '../lock-unlock';
-
-const { fieldsKey, formKey } = unlock( blocksPrivateApis );
 
 const { name } = metadata;
 
@@ -36,18 +32,4 @@ export const settings = {
 	},
 };
 
-if ( window.__experimentalContentOnlyInspectorFields ) {
-	settings[ fieldsKey ] = [
-		{
-			id: 'content',
-			label: __( 'Content' ),
-			type: 'text',
-			Edit: 'rich-text', // TODO: replace with custom component
-		},
-	];
-	settings[ formKey ] = {
-		fields: [ 'content' ],
-	};
-}
-
 export const init = () => initBlock( { name, metadata, settings } );

package/src/pullquote/index.js

@@ -1,15 +1,11 @@
 import { __ } from '@wordpress/i18n';
 import { pullquote as icon } from '@wordpress/icons';
-import { privateApis as blocksPrivateApis } from '@wordpress/blocks';
 import initBlock from '../utils/init-block';
 import deprecated from './deprecated';
 import edit from './edit';
 import metadata from './block.json';
 import save from './save';
 import transforms from './transforms';
-import { unlock } from '../lock-unlock';
-
-const { fieldsKey, formKey } = unlock( blocksPrivateApis );
 
 const { name } = metadata;
 
@@ -33,24 +29,4 @@ export const settings = {
 	deprecated,
 };
 
-if ( window.__experimentalContentOnlyInspectorFields ) {
-	settings[ fieldsKey ] = [
-		{
-			id: 'value',
-			label: __( 'Content' ),
-			type: 'text',
-			Edit: 'rich-text', // TODO: replace with custom component
-		},
-		{
-			id: 'citation',
-			label: __( 'Citation' ),
-			type: 'text',
-			Edit: 'rich-text', // TODO: replace with custom component
-		},
-	];
-	settings[ formKey ] = {
-		fields: [ 'value', 'citation' ],
-	};
-}
-
 export const init = () => initBlock( { name, metadata, settings } );

package/src/query/edit/inspector-controls/index.jsx

@@ -42,7 +42,9 @@ export default function QueryInspectorControls( props ) {
 		orderBy,
 		author: authorIds,
 		pages,
-		postType,
+		// Match `build_query_vars_from_query_block()`, which queries posts when
+		// `query` has no post type.
+		postType = 'post',
 		perPage,
 		offset,
 		sticky,
@@ -172,7 +174,7 @@ export default function QueryInspectorControls( props ) {
 		isControlAllowed( allowedControls, 'excludeCurrent' );
 	const postTypeSingularName = useSelect(
 		( select ) =>
-			select( coreStore ).getPostType( postType )?.labels.singular_name,
+			select( coreStore ).getPostType( postType )?.labels?.singular_name,
 		[ postType ]
 	);
 
@@ -432,14 +434,17 @@ export default function QueryInspectorControls( props ) {
 					{ showSearchControl && (
 						<ToolsPanelItem
 							hasValue={ () => !! querySearch }
-							label={ __( 'Keyword' ) }
+							label={ __( 'Search terms' ) }
 							onDeselect={ () => {
 								setQuery( { search: '' } );
 								setQuerySearch( '' );
 							} }
 						>
 							<TextControl
-								label={ __( 'Keyword' ) }
+								label={ __( 'Search terms' ) }
+								help={ __(
+									'Filter the query by keywords that appear in the content, title, or excerpt.'
+								) }
 								value={ querySearch }
 								onChange={ ( newQuerySearch ) => {
 									debouncedQuerySearch( newQuerySearch );

package/src/query/index.php

@@ -108,8 +108,8 @@ function block_core_query_disable_enhanced_pagination( $parsed_block ) {
 			 * by adding an attribute called `data-wp-navigation-disabled` which
 			 * is later handled by the front-end logic.
 			 *
-			 * @param string   $content  The block content.
-			 * @param array    $block    The full block, including name and attributes.
+			 * @param string $content The block content.
+			 * @param array  $block   The full block, including name and attributes.
 			 * @return string Returns the modified output of the query block.
 			 */
 			$render_query_callback = static function ( $content, $block ) use ( &$enhanced_query_stack, &$dirty_enhanced_queries, &$render_query_callback ) {

package/src/query/test/utils.jsdom.test.js

@@ -1,3 +1,4 @@
+import { describe, expect, it } from 'vitest';
 import { terms } from './fixtures';
 import {
 	getEntitiesInfo,

package/src/quote/test/migrate.jsdom.test.js

@@ -1,3 +1,4 @@
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
 import {
 	registerBlockType,
 	serialize,

package/src/read-more/index.php

@@ -13,7 +13,7 @@
  * @param array    $attributes Block attributes.
  * @param string   $content    Block default content.
  * @param WP_Block $block      Block instance.
- * @return string  Returns the post link.
+ * @return string Returns the post link.
  */
 function render_block_core_read_more( $attributes, $content, $block ) {
 	if ( ! isset( $block->context['postId'] ) ) {

package/src/search/index.js

@@ -1,13 +1,9 @@
 import { __ } from '@wordpress/i18n';
 import { search as icon } from '@wordpress/icons';
-import { privateApis as blocksPrivateApis } from '@wordpress/blocks';
 import initBlock from '../utils/init-block';
 import metadata from './block.json';
 import edit from './edit';
 import variations from './variations';
-import { unlock } from '../lock-unlock';
-
-const { fieldsKey, formKey } = unlock( blocksPrivateApis );
 
 const { name } = metadata;
 
@@ -23,30 +19,4 @@ export const settings = {
 	edit,
 };
 
-if ( window.__experimentalContentOnlyInspectorFields ) {
-	settings[ fieldsKey ] = [
-		{
-			id: 'label',
-			label: __( 'Label' ),
-			type: 'text',
-			Edit: 'rich-text', // TODO: replace with custom component
-		},
-		{
-			id: 'buttonText',
-			label: __( 'Button text' ),
-			type: 'text',
-			Edit: 'rich-text', // TODO: replace with custom component
-		},
-		{
-			id: 'placeholder',
-			label: __( 'Placeholder' ),
-			type: 'text',
-			Edit: 'rich-text', // TODO: replace with custom component
-		},
-	];
-	settings[ formKey ] = {
-		fields: [ 'label', 'buttonText', 'placeholder' ],
-	};
-}
-
 export const init = () => initBlock( { name, metadata, settings } );

package/src/search/index.php

@@ -360,7 +360,7 @@ function apply_block_core_search_border_styles( $attributes, $property, &$wrappe
  *
  * @since 5.8.0
  *
- * @param  array $attributes The block attributes.
+ * @param array $attributes The block attributes.
  *
  * @return array Style HTML attribute.
  */

package/src/separator/test/edit.jsdom.test.jsx

@@ -1,10 +1,11 @@
+import { beforeEach, describe, expect, test, vi } from 'vitest';
 import { render } from '@testing-library/react';
 import { useBlockProps } from '@wordpress/block-editor';
 import SeparatorEdit from '../edit';
 
-jest.mock( '@wordpress/block-editor', () => ( {
-	...jest.requireActual( '@wordpress/block-editor' ),
-	useBlockProps: jest.fn(),
+vi.mock( import( '@wordpress/block-editor' ), async ( importOriginal ) => ( {
+	...( await importOriginal() ),
+	useBlockProps: vi.fn(),
 } ) );
 
 const defaultAttributes = {
@@ -16,7 +17,7 @@ const defaultAttributes = {
 };
 const defaultProps = {
 	attributes: defaultAttributes,
-	setAttributes: jest.fn(),
+	setAttributes: vi.fn(),
 };
 
 describe( 'Separator block edit method', () => {

package/src/site-logo/index.php

@@ -139,7 +139,7 @@ add_filter( 'theme_mod_custom_logo', '_override_custom_logo_theme_mod' );
  *
  * @since 5.8.0
  *
- * @param  mixed $value Attachment ID of the custom logo or an empty value.
+ * @param mixed $value Attachment ID of the custom logo or an empty value.
  * @return mixed
  */
 function _sync_custom_logo_to_site_logo( $value ) {

package/src/site-tagline/edit.jsx

@@ -1,5 +1,5 @@
-import { useDispatch, useSelect } from '@wordpress/data';
-import { store as coreStore } from '@wordpress/core-data';
+import { useSelect } from '@wordpress/data';
+import { store as coreStore, useEntityProp } from '@wordpress/core-data';
 import {
 	useBlockProps,
 	BlockControls,
@@ -15,33 +15,24 @@ export default function SiteTaglineEdit( props ) {
 
 	const { attributes, setAttributes, insertBlocksAfter } = props;
 	const { level, levelOptions } = attributes;
-	const { canUserEdit, tagline } = useSelect( ( select ) => {
-		const { canUser, getEntityRecord, getEditedEntityRecord } =
-			select( coreStore );
-		const canEdit = canUser( 'update', {
-			kind: 'root',
-			name: 'site',
-		} );
-		const settings = canEdit ? getEditedEntityRecord( 'root', 'site' ) : {};
-		const readOnlySettings = getEntityRecord( 'root', '__unstableBase' );
-
-		return {
-			canUserEdit: canEdit,
-			tagline: canEdit
-				? settings?.description
-				: readOnlySettings?.description,
-		};
-	}, [] );
+	const canUserEdit = useSelect(
+		( select ) =>
+			select( coreStore ).canUser( 'update', {
+				kind: 'root',
+				name: 'site',
+			} ),
+		[]
+	);
+	// Users who cannot edit the site settings cannot read them either, so the
+	// tagline comes from the base entity instead.
+	const [ tagline, setTagline ] = useEntityProp(
+		'root',
+		canUserEdit ? 'site' : '__unstableBase',
+		'description',
+		undefined
+	);
 
 	const TagName = level === 0 ? 'p' : `h${ level }`;
-	const { editEntityRecord } = useDispatch( coreStore );
-
-	function setTagline( newTagline ) {
-		editEntityRecord( 'root', 'site', undefined, {
-			description: newTagline,
-		} );
-	}
-
 	const blockProps = useBlockProps( {
 		className:
 			! canUserEdit && ! tagline && 'wp-block-site-tagline__placeholder',