@wordpress/block-library 11.0.2-next.v.202609171837.0 → 11.2.0

package/src/term-name/block.json

@@ -25,6 +25,15 @@
 		"anchor": true,
 		"align": [ "wide", "full" ],
 		"html": false,
+		"background": {
+			"backgroundImage": true,
+			"backgroundSize": true,
+			"gradient": true,
+			"__experimentalDefaultControls": {
+				"backgroundImage": true,
+				"gradient": true
+			}
+		},
 		"color": {
 			"gradients": true,
 			"link": true,
@@ -34,8 +43,14 @@
 				"link": true
 			}
 		},
+		"dimensions": {
+			"minHeight": true,
+			"minWidth": true
+		},
+		"shadow": true,
 		"spacing": {
-			"padding": true
+			"padding": true,
+			"margin": true
 		},
 		"typography": {
 			"fontSize": true,

package/src/term-name/index.php

@@ -33,7 +33,7 @@ function render_block_core_term_name( $attributes, $content, $block ) {
 		return '';
 	}
 
-	$term_name = $term->name;
+	$term_name = get_term_field( 'name', $term );
 	$level     = $attributes['level'] ?? 0;
 	$tag_name  = 0 === $level ? 'p' : 'h' . (int) $level;
 

package/src/term-template/README.md

@@ -28,18 +28,26 @@ _Defined via the [`supports`](https://developer.wordpress.org/block-editor/refer
 - [`html`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#html): `false`
 - [`align`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#align): `"wide"`, `"full"`
 - [`layout`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout): `true`
+- [`background`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#background):
+  - `backgroundImage`: `true`
+  - `backgroundSize`: `true`
+  - `gradient`: `true`
 - [`color`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color):
   - [`gradients`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-gradients): `true`
   - [`link`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-link): `true`
 - [`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`
   - [`lineHeight`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography-lineheight): `true`
+- [`dimensions`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#dimensions):
+  - `minHeight`: `true`
+  - `minWidth`: `true`
 - [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
   - `margin`: `true`
   - `padding`: `true`
   - `blockGap`: `{"__experimentalDefault":"1.25em"}`
 - [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity):
   - `clientNavigation`: `true`
+- [`shadow`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#shadow): `true`
 
 ## Context
 

package/src/term-template/block.json

@@ -14,6 +14,14 @@
 		"html": false,
 		"align": [ "wide", "full" ],
 		"layout": true,
+		"background": {
+			"backgroundImage": true,
+			"backgroundSize": true,
+			"gradient": true,
+			"__experimentalDefaultControls": {
+				"backgroundImage": true
+			}
+		},
 		"color": {
 			"gradients": true,
 			"link": true,
@@ -35,6 +43,10 @@
 				"fontSize": true
 			}
 		},
+		"dimensions": {
+			"minHeight": true,
+			"minWidth": true
+		},
 		"spacing": {
 			"margin": true,
 			"padding": true,
@@ -55,7 +67,8 @@
 			"color": true,
 			"width": true,
 			"style": true
-		}
+		},
+		"shadow": true
 	},
 	"style": "wp-block-term-template",
 	"editorStyle": "wp-block-term-template-editor"

package/src/utils/search-patterns.js

@@ -1,4 +1,7 @@
-import removeAccents from 'remove-accents';
+import { privateApis as blockEditorPrivateApis } from '@wordpress/block-editor';
+import { unlock } from '../lock-unlock';
+
+const { normalizeString, searchItems } = unlock( blockEditorPrivateApis );
 
 /**
  * Sanitizes the search input string.
@@ -8,49 +11,11 @@ import removeAccents from 'remove-accents';
  * @return {string} The normalized search input.
  */
 export function normalizeSearchInput( input = '' ) {
-	// Disregard diacritics.
-	input = removeAccents( input );
-
-	// Trim & Lowercase.
-	input = input.trim().toLowerCase();
-
-	return input;
-}
-
-/**
- * Get the search rank for a given pattern and a specific search term.
- *
- * @param {Object} pattern     Pattern to rank
- * @param {string} searchValue Search term
- * @return {number} A pattern search rank
- */
-export function getPatternSearchRank( pattern, searchValue ) {
-	const normalizedSearchValue = normalizeSearchInput( searchValue );
-	const normalizedTitle = normalizeSearchInput( pattern.title );
-
-	let rank = 0;
-
-	if ( normalizedSearchValue === normalizedTitle ) {
-		rank += 30;
-	} else if ( normalizedTitle.startsWith( normalizedSearchValue ) ) {
-		rank += 20;
-	} else {
-		const searchTerms = normalizedSearchValue.split( ' ' );
-		const hasMatchedTerms = searchTerms.every( ( searchTerm ) =>
-			normalizedTitle.includes( searchTerm )
-		);
-
-		// Prefer pattern with every search word in the title.
-		if ( hasMatchedTerms ) {
-			rank += 10;
-		}
-	}
-
-	return rank;
+	return normalizeString( input ).trim();
 }
 
 /**
- * Filters an pattern list given a search term.
+ * Filters a pattern list given a search term.
  *
  * @param {Array}  patterns    Item list
  * @param {string} searchValue Search input.
@@ -58,16 +23,7 @@ export function getPatternSearchRank( pattern, searchValue ) {
  * @return {Array} Filtered pattern list.
  */
 export function searchPatterns( patterns = [], searchValue = '' ) {
-	if ( ! searchValue ) {
-		return patterns;
-	}
-
-	const rankedPatterns = patterns
-		.map( ( pattern ) => {
-			return [ pattern, getPatternSearchRank( pattern, searchValue ) ];
-		} )
-		.filter( ( [ , rank ] ) => rank > 0 );
-
-	rankedPatterns.sort( ( [ , rank1 ], [ , rank2 ] ) => rank2 - rank1 );
-	return rankedPatterns.map( ( [ pattern ] ) => pattern );
+	return searchItems( patterns, searchValue, {
+		fields: [ { get: ( pattern ) => pattern.title } ],
+	} );
 }

package/src/utils/style-state.js

@@ -1,9 +1,11 @@
-import { privateApis as blockEditorPrivateApis } from '@wordpress/block-editor';
+import {
+	getStyleForState,
+	setStyleForState,
+	privateApis as blockEditorPrivateApis,
+} from '@wordpress/block-editor';
 import { unlock } from '../lock-unlock';
 
-const { cleanEmptyObject, getStyleForState, setStyleForState } = unlock(
-	blockEditorPrivateApis
-);
+const { cleanEmptyObject } = unlock( blockEditorPrivateApis );
 
 function getStateStyle( style, selectedState ) {
 	return getStyleForState( style, selectedState ) || {};

package/src/utils/test/{search-patterns.js → search-patterns.jsdom.test.js}

@@ -1,9 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import {
-	normalizeSearchInput,
-	getPatternSearchRank,
-	searchPatterns,
-} from '../search-patterns';
+import { normalizeSearchInput, searchPatterns } from '../search-patterns';
 
 describe( 'normalizeSearchInput', () => {
 	it( 'should remove accents', () => {
@@ -15,23 +11,6 @@ describe( 'normalizeSearchInput', () => {
 	} );
 } );
 
-describe( 'getPatternSearchRank', () => {
-	it( 'should give a high rank to exact matches', () => {
-		const pattern = { title: 'Foo' };
-		expect( getPatternSearchRank( pattern, 'Foo' ) ).toBe( 30 );
-	} );
-
-	it( 'should give a high rank to prefix matches', () => {
-		const pattern = { title: 'Foo' };
-		expect( getPatternSearchRank( pattern, 'Fo' ) ).toBe( 20 );
-	} );
-
-	it( 'should give a low rank to no matches', () => {
-		const pattern = { title: 'Foo' };
-		expect( getPatternSearchRank( pattern, 'Bar' ) ).toBe( 0 );
-	} );
-} );
-
 describe( 'searchPatterns', () => {
 	it( 'should return all patterns if no search term is provided', () => {
 		const patterns = [ { title: 'Foo' }, { title: 'Bar' } ];

package/src/utils/test/waveform-player-auto-init.jsdom.test.js

@@ -0,0 +1,25 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+/*
+ * Kept in a file of its own: the dependency is evaluated once per file and CI
+ * shuffles test order, so any sibling test importing it first would leave this
+ * one asserting an already scanned document.
+ */
+describe( 'Waveform Player auto-initialization', () => {
+	afterEach( () => {
+		vi.resetModules();
+		document.body.innerHTML = '';
+		delete window.WaveformPlayer;
+	} );
+
+	it( 'leaves declarative markup it does not own uninitialized', async () => {
+		const element = document.createElement( 'div' );
+		element.setAttribute( 'data-waveform-player', '' );
+		document.body.appendChild( element );
+
+		await import( '../waveform-utils' );
+
+		expect( element ).not.toHaveAttribute( 'data-waveform-initialized' );
+		expect( element ).toBeEmptyDOMElement();
+	} );
+} );

package/src/utils/test/waveform-player-dependency.jsdom.test.js

@@ -1,25 +1,17 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
-const FIXTURE_ATTRIBUTE = 'data-player-fixture';
-
-function createDeclarativePlayer( attributes = {} ) {
+function createDeclarativePlayer() {
 	const element = document.createElement( 'div' );
 	element.setAttribute( 'data-waveform-player', '' );
-
-	for ( const [ name, value ] of Object.entries( attributes ) ) {
-		element.setAttribute( name, value );
-	}
-
 	document.body.appendChild( element );
 	return element;
 }
 
-async function loadWaveformPlayer() {
-	return ( await import( '@arraypress/waveform-player' ) ).default;
+async function loadWaveformUtils() {
+	await import( '../waveform-utils' );
 }
 
 describe( 'Waveform Player dependency', () => {
-	let WaveformPlayer;
 	let originalReadyState;
 	let jsdomStubs;
 
@@ -48,12 +40,11 @@ describe( 'Waveform Player dependency', () => {
 	} );
 
 	afterEach( () => {
-		WaveformPlayer?.destroyAll();
+		window.WaveformPlayer?.destroyAll();
 		jsdomStubs.forEach( ( stub ) => stub.mockRestore() );
 		vi.useRealTimers();
 		vi.resetModules();
 		document.body.innerHTML = '';
-		delete window.WaveformPlayer;
 
 		if ( originalReadyState ) {
 			Object.defineProperty( document, 'readyState', originalReadyState );
@@ -62,55 +53,11 @@ describe( 'Waveform Player dependency', () => {
 		}
 	} );
 
-	it( 'uses the default control icons when declarative icon values are unsupported', async () => {
-		const iconValue = `<span ${ FIXTURE_ATTRIBUTE }></span>`;
-		const element = createDeclarativePlayer( {
-			'data-play-icon': iconValue,
-			'data-pause-icon': iconValue,
-		} );
-
-		WaveformPlayer = await loadWaveformPlayer();
-		WaveformPlayer.init();
-
-		expect(
-			element.querySelector( `[${ FIXTURE_ATTRIBUTE }]` )
-		).toBeNull();
-		expect(
-			element.querySelector( '.waveform-icon-play svg' )
-		).not.toBeNull();
-		expect(
-			element.querySelector( '.waveform-icon-pause svg' )
-		).not.toBeNull();
-	} );
-
-	it( 'supports custom control icons passed to the constructor', async () => {
-		const element = document.createElement( 'div' );
-		const icon = document.createElementNS(
-			'http://www.w3.org/2000/svg',
-			'svg'
-		);
-		icon.setAttribute( FIXTURE_ATTRIBUTE, 'constructor' );
-		document.body.appendChild( element );
-
-		WaveformPlayer = await loadWaveformPlayer();
-		new WaveformPlayer( element, {
-			playIcon: icon.outerHTML,
-		} );
-
-		expect(
-			element.querySelector( `[${ FIXTURE_ATTRIBUTE }="constructor"]` )
-		).not.toBeNull();
-	} );
-
-	it( 'initializes declarative players only after an explicit request', async () => {
+	it( 'initializes declarative markup that is requested explicitly', async () => {
 		const element = createDeclarativePlayer();
 
-		WaveformPlayer = await loadWaveformPlayer();
-
-		expect( element ).not.toHaveAttribute( 'data-waveform-initialized' );
-		expect( element ).toBeEmptyDOMElement();
-
-		WaveformPlayer.init();
+		await loadWaveformUtils();
+		window.WaveformPlayer.init( element );
 
 		expect( element ).toHaveAttribute(
 			'data-waveform-initialized',

package/src/utils/test/waveform-utils.browser.test.js

@@ -757,24 +757,12 @@ describe( 'Waveform utilities', () => {
 	} );
 
 	describe( 'logPlayError', () => {
-		let consoleErrorSpy;
-
-		beforeEach( () => {
-			consoleErrorSpy = vi
-				.spyOn( console, 'error' )
-				.mockImplementation( () => {} );
-		} );
-
-		afterEach( () => {
-			consoleErrorSpy.mockRestore();
-		} );
-
 		it( 'should not log AbortError', () => {
 			const abortError = new DOMException( 'Aborted', 'AbortError' );
 
 			logPlayError( abortError );
 
-			expect( consoleErrorSpy ).not.toHaveBeenCalled();
+			expect( console ).not.toHaveErrored();
 		} );
 
 		it( 'should log other errors', () => {
@@ -782,7 +770,7 @@ describe( 'Waveform utilities', () => {
 
 			logPlayError( otherError );
 
-			expect( consoleErrorSpy ).toHaveBeenCalledWith(
+			expect( console ).toHaveErroredWith(
 				'Playlist play error:',
 				otherError
 			);
@@ -796,7 +784,7 @@ describe( 'Waveform utilities', () => {
 
 			logPlayError( notAllowedError );
 
-			expect( consoleErrorSpy ).toHaveBeenCalledWith(
+			expect( console ).toHaveErroredWith(
 				'Playlist play error:',
 				notAllowedError
 			);

package/src/utils/waveform-utils.js

@@ -3,7 +3,7 @@
  * Used by both the WaveformPlayer component (editor) and view.js (frontend).
  */
 import { colord } from 'colord';
-import WaveformPlayerLib from '@arraypress/waveform-player';
+import WaveformPlayerLib from '@arraypress/waveform-player/no-autoinit';
 
 /**
  * Configuration constants.

package/src/verse/README.md

@@ -31,10 +31,14 @@ _Defined via the [`supports`](https://developer.wordpress.org/block-editor/refer
   - [`link`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-link): `true`
 - [`dimensions`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#dimensions):
   - `minHeight`: `true`
+  - `minWidth`: `true`
 - [`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`
   - [`lineHeight`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography-lineheight): `true`
   - [`textAlign`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography-textalign): `true`
+  - `textColumns`: `true`
+  - `textIndent`: `true`
+  - `fitText`: `true`
 - [`shadow`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#shadow): `true`
 - [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
   - `margin`: `true`

package/src/verse/block.json

@@ -37,6 +37,7 @@
 		},
 		"dimensions": {
 			"minHeight": true,
+			"minWidth": true,
 			"__experimentalDefaultControls": {
 				"minHeight": false
 			}
@@ -46,12 +47,15 @@
 			"__experimentalFontFamily": true,
 			"lineHeight": true,
 			"textAlign": true,
+			"textColumns": true,
+			"textIndent": true,
 			"__experimentalFontStyle": true,
 			"__experimentalFontWeight": true,
 			"__experimentalLetterSpacing": true,
 			"__experimentalTextTransform": true,
 			"__experimentalTextDecoration": true,
 			"__experimentalWritingMode": true,
+			"fitText": true,
 			"__experimentalDefaultControls": {
 				"fontSize": true
 			}

package/src/verse/style.scss

@@ -2,13 +2,22 @@ pre.wp-block-verse {
 	box-sizing: border-box;
 	overflow: auto;
 	white-space: pre-wrap;
+	word-break: normal;
+	overflow-wrap: break-word;
+}
 
+:root :where(pre.wp-block-verse) {
 	// Prevent text overflow off-screen when the previous block has float.
+	// :root :where() matches Global Styles specificity so a minimum width set
+	// there can win, since block library styles load first.
 	min-width: 1em;
-	word-break: normal;
-	overflow-wrap: break-word;
 }
 
 :where(pre.wp-block-verse) {
 	font-family: inherit;
 }
+
+// Fit text sets `white-space: nowrap`, which collapses the spacing poetry relies on.
+pre.wp-block-verse.has-fit-text {
+	white-space: pre !important;
+}

package/src/video/README.md

@@ -36,11 +36,22 @@ _Defined via the [`supports`](https://developer.wordpress.org/block-editor/refer
 
 - [`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): `true`
+- [`filter`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#filter):
+  - [`duotone`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#filter-duotone): `true`
 - [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
   - `margin`: `true`
   - `padding`: `true`
 - [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity):
   - `clientNavigation`: `true`
+- [`shadow`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#shadow): `true`
+
+## CSS Selectors
+
+_Defined via the [`selectors`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-selectors/) property in block.json._
+
+- **shadow**: `.wp-block-video video`
+- **filter**:
+  - duotone: `.wp-block-video video`
 
 ## Block Markup
 

package/src/video/block.json

@@ -91,6 +91,9 @@
 	"supports": {
 		"anchor": true,
 		"align": true,
+		"filter": {
+			"duotone": true
+		},
 		"spacing": {
 			"margin": true,
 			"padding": true,
@@ -101,6 +104,15 @@
 		},
 		"interactivity": {
 			"clientNavigation": true
+		},
+		"shadow": {
+			"__experimentalSkipSerialization": true
+		}
+	},
+	"selectors": {
+		"shadow": ".wp-block-video video",
+		"filter": {
+			"duotone": ".wp-block-video video"
 		}
 	},
 	"editorStyle": "wp-block-video-editor",