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

package/src/table-of-contents/block.json

@@ -14,7 +14,8 @@
 			"items": {
 				"type": "object"
 			},
-			"default": []
+			"default": [],
+			"role": "local"
 		},
 		"onlyIncludeCurrentPage": {
 			"type": "boolean",

package/src/table-of-contents/deprecated.jsx

@@ -0,0 +1,173 @@
+import { useBlockProps } from '@wordpress/block-editor';
+
+const ENTRY_CLASS_NAME = 'wp-block-table-of-contents__entry';
+
+const attributes = {
+	headings: {
+		type: 'array',
+		items: {
+			type: 'object',
+		},
+		default: [],
+	},
+	onlyIncludeCurrentPage: {
+		type: 'boolean',
+		default: false,
+	},
+	maxLevel: {
+		type: 'number',
+	},
+	ordered: {
+		type: 'boolean',
+		default: true,
+	},
+};
+
+const supports = {
+	anchor: true,
+	ariaLabel: true,
+	html: false,
+	color: {
+		text: true,
+		background: true,
+		gradients: true,
+		link: true,
+	},
+	spacing: {
+		margin: true,
+		padding: true,
+	},
+	typography: {
+		fontSize: true,
+		lineHeight: true,
+		__experimentalFontFamily: true,
+		__experimentalFontWeight: true,
+		__experimentalFontStyle: true,
+		__experimentalTextTransform: true,
+		__experimentalTextDecoration: true,
+		__experimentalLetterSpacing: true,
+		__experimentalDefaultControls: {
+			fontSize: true,
+		},
+	},
+	interactivity: {
+		clientNavigation: true,
+	},
+	__experimentalBorder: {
+		radius: true,
+		color: true,
+		width: true,
+		style: true,
+		__experimentalDefaultControls: {
+			radius: true,
+			color: true,
+			width: true,
+			style: true,
+		},
+	},
+};
+
+function linearToNestedHeadingList( headingList ) {
+	const nestedHeadingList = [];
+
+	headingList.forEach( ( heading, key ) => {
+		if ( heading.content === '' ) {
+			return;
+		}
+
+		if ( heading.level === headingList[ 0 ].level ) {
+			if ( headingList[ key + 1 ]?.level > heading.level ) {
+				let endOfSlice = headingList.length;
+				for ( let i = key + 1; i < headingList.length; i++ ) {
+					if ( headingList[ i ].level === heading.level ) {
+						endOfSlice = i;
+						break;
+					}
+				}
+
+				nestedHeadingList.push( {
+					heading,
+					children: linearToNestedHeadingList(
+						headingList.slice( key + 1, endOfSlice )
+					),
+				} );
+			} else {
+				nestedHeadingList.push( {
+					heading,
+					children: null,
+				} );
+			}
+		}
+	} );
+
+	return nestedHeadingList;
+}
+
+function TableOfContentsList( { nestedHeadingList, ordered = true } ) {
+	return (
+		<>
+			{ nestedHeadingList.map( ( node, index ) => {
+				const { content, link } = node.heading;
+
+				const entry = link ? (
+					<a className={ ENTRY_CLASS_NAME } href={ link }>
+						{ content }
+					</a>
+				) : (
+					<span className={ ENTRY_CLASS_NAME }>{ content }</span>
+				);
+
+				const NestedListTag = ordered ? 'ol' : 'ul';
+
+				return (
+					<li key={ index }>
+						{ entry }
+						{ node.children ? (
+							<NestedListTag>
+								<TableOfContentsList
+									nestedHeadingList={ node.children }
+									ordered={ ordered }
+								/>
+							</NestedListTag>
+						) : null }
+					</li>
+				);
+			} ) }
+		</>
+	);
+}
+
+const hasOwn = ( object, key ) =>
+	Object.prototype.hasOwnProperty.call( object, key );
+
+const v1 = {
+	attributes,
+	supports,
+	isEligible: ( blockAttributes, innerBlocks, { blockNode } = {} ) => {
+		return (
+			hasOwn( blockAttributes, 'headings' ) ||
+			blockNode?.innerHTML?.includes( 'wp-block-table-of-contents' )
+		);
+	},
+	migrate: ( { headings, ...persistentAttributes } ) => persistentAttributes,
+	save( { attributes: { headings = [], ordered = true } } ) {
+		if ( headings.length === 0 ) {
+			return null;
+		}
+		const ListTag = ordered ? 'ol' : 'ul';
+		return (
+			<nav { ...useBlockProps.save() }>
+				<ListTag>
+					<TableOfContentsList
+						nestedHeadingList={ linearToNestedHeadingList(
+							headings
+						) }
+						ordered={ ordered }
+					/>
+				</ListTag>
+			</nav>
+		);
+	},
+};
+
+export default [ v1 ];

package/src/table-of-contents/index.js

@@ -1,9 +1,9 @@
 import { __ } from '@wordpress/i18n';
 import { tableOfContents as icon } from '@wordpress/icons';
 import initBlock from '../utils/init-block';
+import deprecated from './deprecated';
 import metadata from './block.json';
 import edit from './edit';
-import save from './save';
 
 const { name } = metadata;
 
@@ -11,8 +11,8 @@ export { metadata, name };
 
 export const settings = {
 	icon,
+	deprecated,
 	edit,
-	save,
 	example: {
 		innerBlocks: [
 			{

package/src/table-of-contents/index.php

@@ -363,14 +363,27 @@ function block_core_table_of_contents_build_list_items( $nested_headings, $list_
 /**
  * Renders the table of contents block from current post headings.
  *
- * @param array  $attributes Attributes of the block being rendered.
- * @param string $content Content of the block being rendered.
+ * @param array         $attributes Attributes of the block being rendered.
+ * @param string        $content Content of the block being rendered.
+ * @param WP_Block|null $block Block instance.
  *
  * @return string The content of the block being rendered.
  */
-function block_core_table_of_contents_render( $attributes, $content ) {
+function block_core_table_of_contents_render( $attributes, $content, $block = null ) {
 	global $wp_current_filter;
 
+	// Preserve legacy saved markup for old posts that have not been edited and migrated yet.
+	$legacy_content = $content;
+	if ( '' === trim( $legacy_content ) && ! empty( $block->parsed_block['innerHTML'] ) ) {
+		$legacy_content = $block->parsed_block['innerHTML'];
+	}
+
+	// Once a post is edited and saved, the block migrates to dynamic rendering.
+	if ( '' !== trim( $legacy_content ) ) {
+		return block_core_table_of_contents_add_aria_label( $attributes, $legacy_content );
+	}
+
+	// Outside post content rendering, there is no reliable current post to scan.
 	if ( ! is_array( $wp_current_filter ) || ! in_array( 'the_content', $wp_current_filter, true ) ) {
 		return block_core_table_of_contents_add_aria_label( $attributes, $content );
 	}

package/src/tabs/README.md

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

package/src/tabs/index.php

@@ -21,7 +21,7 @@ function block_core_tabs_generate_tabs_list( array $innerblocks = array(), strin
 	// Find tab-panel block
 	foreach ( $innerblocks as $inner_block ) {
 		if ( 'core/tab-panels' === ( $inner_block['blockName'] ?? '' ) ) {
-			$tab_index = 0;
+			$tab_number = 1;
 			foreach ( $inner_block['innerBlocks'] ?? array() as $tab_block ) {
 				if ( 'core/tab-panel' === ( $tab_block['blockName'] ?? '' ) ) {
 					$attrs = $tab_block['attrs'] ?? array();
@@ -29,11 +29,11 @@ function block_core_tabs_generate_tabs_list( array $innerblocks = array(), strin
 					$tab_id = ! empty( $attrs['anchor'] )
 						? $attrs['anchor']
 						: ( ! empty( $tabs_id )
-							? $tabs_id . '-tab-' . $tab_index
-							: 'tab-' . $tab_index );
+							? $tabs_id . '-tab-' . $tab_number
+							: 'tab-' . $tab_number );
 
 					$tabs_list[] = esc_attr( $tab_id );
-					++$tab_index;
+					++$tab_number;
 				}
 			}
 			break;
@@ -59,7 +59,7 @@ function block_core_tabs_provide_context( array $context, array $parsed_block ):
 	if ( 'core/tabs' === $parsed_block['blockName'] ) {
 		// Generate a unique ID for the tabs instance first, so it can be used
 		// to derive stable tab IDs.
-		$tabs_id                   = $parsed_block['attrs']['anchor'] ?? wp_unique_id( 'tabs_' );
+		$tabs_id                   = $parsed_block['attrs']['anchor'] ?? wp_unique_prefixed_id( 'tabs_' );
 		$tabs_list                 = block_core_tabs_generate_tabs_list( $parsed_block['innerBlocks'] ?? array(), $tabs_id );
 		$context['core/tabs-list'] = $tabs_list;
 		$context['core/tabs-id']   = $tabs_id;
@@ -104,7 +104,8 @@ function block_core_tabs_render_block_callback( array $attributes, string $conte
 			)
 		)
 	);
-	$tag_processor->set_attribute( 'data-wp-init', 'callbacks.onTabsInit' );
+	$tag_processor->set_attribute( 'data-wp-init', 'callbacks.activateTabByHash' );
+	$tag_processor->set_attribute( 'data-wp-on-window--hashchange', 'callbacks.activateTabByHash' );
 	$tag_processor->set_attribute( 'data-wp-on--keydown', 'actions.handleTabKeyDown' );
 
 	$output = $tag_processor->get_updated_html();

package/src/tabs/use-tab-list-items-sync.js

@@ -9,7 +9,7 @@ const EMPTY_ARRAY = [];
  *
  * Whenever the list of core/tab-panel blocks changes (add, remove, reorder, or
  * label edit), this hook updates the `tabs` attribute on the core/tab-list
- * block so that save.js can render the correct buttons.
+ * block so that save.jsx can render the correct buttons.
  *
  * @param {string} tabsClientId Client ID of the core/tabs block.
  */

package/src/tabs/view.js

@@ -47,8 +47,26 @@ const { actions, state } = store(
 				return activeTabIndex === tabIndex;
 			},
 			/**
-			 * The value of the tabindex attribute for tab buttons.
-			 * Only the active tab should be in the tab sequence.
+			 * The value of the hidden attribute for tab panels.
+			 *
+			 * Inactive panels use the `until-found` state rather than being
+			 * hidden outright, so their content stays reachable by the
+			 * browser's find-in-page and by fragment navigation. The browser
+			 * fires `beforematch` on the panel before revealing it, which is
+			 * where the matching tab gets activated.
+			 *
+			 * @type {string|null}
+			 */
+			get isHidden() {
+				return state.isActiveTab ? null : 'until-found';
+			},
+			/**
+			 * The value of the tabindex attribute for tab buttons and tab
+			 * panels. Only the active tab should be in the tab sequence.
+			 *
+			 * An inactive panel is hidden with `until-found`, which leaves it
+			 * in the layout, so it stays focusable unless it is taken out of
+			 * the tab sequence here.
 			 *
 			 * @type {number}
 			 */
@@ -96,6 +114,18 @@ const { actions, state } = store(
 					actions.setActiveTab( tabIndex );
 				}
 			} ),
+			/**
+			 * Activates the tab whose panel the browser is about to reveal.
+			 *
+			 * Fired on a panel hidden with `until-found` when find-in-page or
+			 * a fragment navigation matches content inside it.
+			 */
+			handleBeforeMatch: () => {
+				const { tabIndex } = state;
+				if ( tabIndex !== null ) {
+					actions.setActiveTab( tabIndex );
+				}
+			},
 			/**
 			 * Moves focus to a specific tab without activating it.
 			 *
@@ -156,23 +186,47 @@ const { actions, state } = store(
 			},
 		},
 		callbacks: {
-			/**
-			 * When the tabs are initialized, we need to check if there is a hash in the url and if so if it exists in the current tabsList, set the active tab to that index.
-			 *
-			 */
-			onTabsInit: () => {
+			activateTabByHash: () => {
 				const { tabsList } = state;
-				if ( tabsList.length === 0 ) {
+
+				if ( ! tabsList || tabsList.length === 0 ) {
 					return;
 				}
 
-				const { hash } = window.location;
-				const tabId = hash.replace( '#', '' );
-				const tabIndex = tabsList.findIndex( ( t ) => t === tabId );
-				// Check if tabIndex is a positive number and if so we'll auto activate that tab.
-				if ( tabIndex >= 0 ) {
-					actions.setActiveTab( tabIndex, true );
+				const targetElement = document.querySelector( ':target' );
+				if ( ! targetElement ) {
+					return;
+				}
+
+				const panelIndex = tabsList.findIndex(
+					( t ) => t === targetElement.id
+				);
+				if ( panelIndex >= 0 ) {
+					actions.setActiveTab( panelIndex, true );
+					return;
 				}
+
+				// Walk up the panels containing the target rather than taking
+				// the nearest one, so that nested tabs resolve to the panel
+				// belonging to this block.
+				let panel = targetElement.closest( '.wp-block-tab-panel' );
+				let tabIndex = -1;
+
+				while ( panel && tabIndex < 0 ) {
+					tabIndex = tabsList.findIndex( ( t ) => t === panel.id );
+					panel =
+						panel.parentElement?.closest( '.wp-block-tab-panel' ) ??
+						null;
+				}
+
+				if ( tabIndex < 0 ) {
+					return;
+				}
+
+				actions.setActiveTab( tabIndex );
+				window.setTimeout( () => {
+					targetElement.scrollIntoView();
+				}, 0 );
 			},
 		},
 	},

package/src/tag-cloud/README.md

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

package/src/template-part/README.md

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

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

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

package/src/term-description/index.php

@@ -23,7 +23,7 @@ function render_block_core_term_description( $attributes, $content, $block ) {
 	if ( isset( $block->context['termId'] ) && isset( $block->context['taxonomy'] ) ) {
 		$term = get_term( $block->context['termId'], $block->context['taxonomy'] );
 		if ( $term && ! is_wp_error( $term ) ) {
-			$term_description = $term->description;
+			$term_description = get_term_field( 'description', $term );
 		}
 	} elseif ( is_category() || is_tag() || is_tax() ) {
 		$term_description = term_description();

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

package/src/term-template/README.md

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

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

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

package/src/terms-query/README.md

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

package/src/text-columns/README.md

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

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

@@ -1,14 +1,5 @@
 import '@testing-library/jest-dom';
 
-const DEFAULT_PLAYBACK_RATES = [
-	'0.5x',
-	'0.75x',
-	'1x',
-	'1.25x',
-	'1.5x',
-	'1.75x',
-	'2x',
-];
 const FIXTURE_ATTRIBUTE = 'data-player-fixture';
 
 function createDeclarativePlayer( attributes = {} ) {
@@ -33,10 +24,6 @@ function loadWaveformPlayer() {
 	return WaveformPlayer;
 }
 
-function getFragmentedAttributeValue( prefix = '' ) {
-	return `${ prefix }" ${ FIXTURE_ATTRIBUTE }="sample`;
-}
-
 describe( 'Waveform Player dependency', () => {
 	let WaveformPlayer;
 	let originalReadyState;
@@ -102,43 +89,6 @@ describe( 'Waveform Player dependency', () => {
 		).not.toBeNull();
 	} );
 
-	it( 'uses the default alignment when a declarative alignment value is unsupported', () => {
-		const element = createDeclarativePlayer( {
-			'data-button-align': getFragmentedAttributeValue( 'center' ),
-		} );
-
-		WaveformPlayer = loadWaveformPlayer();
-		WaveformPlayer.init();
-
-		const track = element.querySelector( '.waveform-track' );
-		expect( track ).toHaveClass( 'waveform-align-center' );
-		expect( track ).not.toHaveAttribute( FIXTURE_ATTRIBUTE );
-	} );
-
-	it( 'uses the default playback rates when a declarative rate list is unsupported', () => {
-		const element = createDeclarativePlayer( {
-			'data-show-playback-speed': 'true',
-			'data-playback-rates': JSON.stringify( [
-				1,
-				getFragmentedAttributeValue( '1' ),
-				1.5,
-			] ),
-		} );
-
-		WaveformPlayer = loadWaveformPlayer();
-		WaveformPlayer.init();
-
-		const options = [ ...element.querySelectorAll( '.speed-option' ) ];
-		expect( options.map( ( option ) => option.textContent ) ).toEqual(
-			DEFAULT_PLAYBACK_RATES
-		);
-		expect(
-			options.some( ( option ) =>
-				option.hasAttribute( FIXTURE_ATTRIBUTE )
-			)
-		).toBe( false );
-	} );
-
 	it( 'supports custom control icons passed to the constructor', () => {
 		const element = document.createElement( 'div' );
 		const icon = document.createElementNS(
@@ -158,30 +108,6 @@ describe( 'Waveform Player dependency', () => {
 		).not.toBeNull();
 	} );
 
-	it( 'skips programmatic players during explicit declarative scans', () => {
-		const element = createDeclarativePlayer();
-		const icon = document.createElementNS(
-			'http://www.w3.org/2000/svg',
-			'svg'
-		);
-		icon.setAttribute( FIXTURE_ATTRIBUTE, 'constructor-scan' );
-
-		WaveformPlayer = loadWaveformPlayer();
-		const player = new WaveformPlayer( element, {
-			playIcon: icon.outerHTML,
-		} );
-
-		WaveformPlayer.init();
-
-		expect( WaveformPlayer.getAllInstances() ).toHaveLength( 1 );
-		expect( WaveformPlayer.getInstance( element ) ).toBe( player );
-		expect(
-			element.querySelector(
-				`[${ FIXTURE_ATTRIBUTE }="constructor-scan"]`
-			)
-		).not.toBeNull();
-	} );
-
 	it( 'initializes declarative players only after an explicit request', () => {
 		const element = createDeclarativePlayer();
 

package/src/verse/README.md

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

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