@wordpress/block-library 9.48.1 → 10.0.0

package/src/tab-panel/edit.js

@@ -8,7 +8,7 @@ import {
 	store as blockEditorStore,
 } from '@wordpress/block-editor';
 import { useSelect, useDispatch } from '@wordpress/data';
-import { useMemo, useRef, useEffect } from '@wordpress/element';
+import { useMemo, useEffect } from '@wordpress/element';
 
 /**
  * Internal dependencies
@@ -24,25 +24,12 @@ const TEMPLATE = [
 	],
 ];
 
-const { cancelAnimationFrame } = window;
-
 export default function Edit( { clientId, context, isSelected } ) {
-	const focusRef = useRef();
-
 	// Consume tab indices from context
 	const activeTabIndex = context[ 'core/tabs-activeTabIndex' ];
 	const editorActiveTabIndex = context[ 'core/tabs-editorActiveTabIndex' ];
 	const effectiveActiveIndex = editorActiveTabIndex ?? activeTabIndex;
 
-	// Clean up animation frames on unmount.
-	useEffect( () => {
-		return () => {
-			if ( focusRef.current ) {
-				cancelAnimationFrame( focusRef.current );
-			}
-		};
-	}, [] );
-
 	const { blockIndex, hasInnerBlocksSelected, tabsClientId } = useSelect(
 		( select ) => {
 			const {

package/src/tab-panel/index.php

@@ -8,7 +8,7 @@
 /**
  * Render callback for core/tab-panel.
  *
- * @since 7.0.0
+ * @since 7.1.0
  *
  * @param array     $attributes Block attributes.
  * @param string    $content    Block content.
@@ -41,31 +41,8 @@ function block_core_tab_panel_render( array $attributes, string $content, \WP_Bl
 		$tag_processor->set_attribute( 'id', $tab_id );
 	}
 
-	/**
-	 * Add interactivity to the tab element.
-	 */
-	$tag_processor->set_attribute(
-		'data-wp-interactive',
-		'core/tabs/private'
-	);
-	$tag_processor->set_attribute(
-		'data-wp-context',
-		wp_json_encode(
-			array(
-				'tab' => array(
-					'id' => $tab_id,
-				),
-			)
-		)
-	);
-
-	/**
-	 * Process accessibility and interactivity attributes.
-	 */
-	$tag_processor->set_attribute( 'role', 'tabpanel' );
 	$tag_processor->set_attribute( 'aria-labelledby', 'tab__' . $tab_id );
 	$tag_processor->set_attribute( 'data-wp-bind--hidden', '!state.isActiveTab' );
-	$tag_processor->set_attribute( 'tabindex', 0 );
 
 	return (string) $tag_processor->get_updated_html();
 }
@@ -75,7 +52,7 @@ function block_core_tab_panel_render( array $attributes, string $content, \WP_Bl
  *
  * @hook init
  *
- * @since 7.0.0
+ * @since 7.1.0
  */
 function register_block_core_tab_panel() {
 	register_block_type_from_metadata(

package/src/tab-panel/remove-tab-toolbar-control.js

@@ -11,8 +11,8 @@ import { useDispatch, useSelect } from '@wordpress/data';
 
 /**
  * "Remove Tab" button in the block toolbar for the tabs block.
- * Removes the currently active core/tab-panel and its corresponding
- * core/tab, keeping both in sync.
+ * Removes the currently active core/tab-panel. The tab-list items
+ * attribute is kept in sync automatically via useTabListItemsSync.
  *
  * @param {Object} props
  * @param {string} props.tabsClientId The client ID of the parent tabs block.
@@ -28,17 +28,17 @@ export default function RemoveTabToolbarControl( { tabsClientId } ) {
 
 	const {
 		activeTabPanelClientId,
-		activeTabClientId,
 		tabCount,
 		editorActiveTabIndex,
+		tabListClientId,
 	} = useSelect(
 		( select ) => {
 			if ( ! tabsClientId ) {
 				return {
 					activeTabPanelClientId: null,
-					activeTabClientId: null,
 					tabCount: 0,
 					editorActiveTabIndex: 0,
+					tabListClientId: null,
 				};
 			}
 			const { getBlocks, getBlockAttributes } =
@@ -56,15 +56,13 @@ export default function RemoveTabToolbarControl( { tabsClientId } ) {
 				( block ) => block.name === 'core/tab-list'
 			);
 			const tabPanelBlocks = tabPanels?.innerBlocks || [];
-			const tabs = tabList?.innerBlocks || [];
 			const activeTabPanel = tabPanelBlocks[ activeIndex ];
-			const activeTab = tabs[ activeIndex ];
 
 			return {
 				activeTabPanelClientId: activeTabPanel?.clientId || null,
-				activeTabClientId: activeTab?.clientId || null,
-				tabCount: tabs.length,
+				tabCount: tabPanelBlocks.length,
 				editorActiveTabIndex: activeIndex,
+				tabListClientId: tabList?.clientId || null,
 			};
 		},
 		[ tabsClientId ]
@@ -86,14 +84,12 @@ export default function RemoveTabToolbarControl( { tabsClientId } ) {
 			editorActiveTabIndex: newActiveIndex,
 		} );
 
-		// Remove the tab panel and corresponding tab
+		// Remove the tab panel.
 		removeBlock( activeTabPanelClientId, false );
-		if ( activeTabClientId ) {
-			removeBlock( activeTabClientId, false );
-		}
 
-		if ( tabsClientId ) {
-			selectBlock( tabsClientId );
+		// Select the tab-list so focus moves to the new active tab button.
+		if ( tabListClientId ) {
+			selectBlock( tabListClientId );
 		}
 	};
 

package/src/tab-panel/save.js

@@ -6,6 +6,7 @@ import { useBlockProps, useInnerBlocksProps } from '@wordpress/block-editor';
 export default function save() {
 	const blockProps = useBlockProps.save( {
 		role: 'tabpanel',
+		tabIndex: 0,
 	} );
 	const innerBlocksProps = useInnerBlocksProps.save( blockProps );
 

package/src/tab-panel/style.scss

@@ -1,23 +1,6 @@
 .wp-block-tab-panel {
-	max-width: 100%;
-	flex-basis: 100%;
-	flex-grow: 1;
-	box-sizing: border-box;
-
-	& > *:first-child {
-		margin-top: 0;
-	}
-	& > *:last-child {
-		margin-bottom: 0;
-	}
-
 	&[hidden],
 	&:empty {
 		display: none !important;
 	}
 }
-
-.wp-block-tab-panel.wp-block.has-background,
-.wp-block-tab-panel:not(.wp-block).has-background {
-	padding: var(--wp--preset--spacing--30);
-}

package/src/tab-panels/README.md

@@ -28,34 +28,18 @@ _This block has no custom attributes._
 
 _Defined via the [`supports`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/) property in block.json._
 
-- [`anchor`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#anchor): `false`
 - [`html`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#html): `false`
-- [`reusable`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#reusable): `false`
 - [`visibility`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#visibility): `false`
 - [`lock`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#lock): `false`
-- [`dimensions`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#dimensions):
-  - `aspectRatio`: `false`
-  - `height`: `false`
-  - `minHeight`: `false`
-  - `width`: `false`
 - [`color`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color):
   - [`background`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-background): `true`
   - [`text`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-text): `true`
   - [`heading`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-heading): `true`
   - [`link`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-link): `true`
 - [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
-  - `blockGap`: `false`
   - `padding`: `true`
-  - `margin`: `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`
-- [`layout`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout):
-  - [`default`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-default): `{"type":"flex","flexWrap":"nowrap","justifyContent":"stretch","orientation":"vertical"}`
-  - [`allowSwitching`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-allowswitching): `false`
-  - [`allowVerticalAlignment`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-allowverticalalignment): `false`
-  - [`allowOrientation`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-alloworientation): `false`
-  - [`allowJustification`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-allowjustification): `true`
-  - [`allowSizingOnChildren`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-allowsizingonchildren): `false`
 
 ## Block Markup
 

package/src/tab-panels/block.json

@@ -9,19 +9,10 @@
 	"textdomain": "default",
 	"parent": [ "core/tabs" ],
 	"allowedBlocks": [ "core/tab-panel" ],
-	"attributes": {},
 	"supports": {
-		"anchor": false,
 		"html": false,
-		"reusable": false,
 		"visibility": false,
 		"lock": false,
-		"dimensions": {
-			"aspectRatio": false,
-			"height": false,
-			"minHeight": false,
-			"width": false
-		},
 		"color": {
 			"background": true,
 			"text": true,
@@ -33,34 +24,17 @@
 			}
 		},
 		"spacing": {
-			"blockGap": false,
-			"padding": true,
-			"margin": true
+			"padding": true
 		},
 		"typography": {
 			"fontSize": true,
 			"__experimentalFontFamily": true
 		},
-		"layout": {
-			"default": {
-				"type": "flex",
-				"flexWrap": "nowrap",
-				"justifyContent": "stretch",
-				"orientation": "vertical"
-			},
-			"allowSwitching": false,
-			"allowVerticalAlignment": false,
-			"allowOrientation": false,
-			"allowJustification": true,
-			"allowSizingOnChildren": false
-		},
 		"__experimentalBorder": {
 			"radius": true,
 			"color": true,
 			"width": true,
 			"style": true
 		}
-	},
-	"editorScript": "file:./index.js",
-	"style": "file:./style-index.css"
+	}
 }

package/src/tab-panels/init.js

@@ -0,0 +1,6 @@
+/**
+ * Internal dependencies
+ */
+import { init } from './';
+
+export default init();

package/src/table/edit.js

@@ -563,7 +563,6 @@ function TableEdit( {
 						onSubmit={ onCreateTable }
 					>
 						<TextControl
-							__next40pxDefaultSize
 							type="number"
 							label={ __( 'Column count' ) }
 							value={ initialColumnCount }
@@ -572,7 +571,6 @@ function TableEdit( {
 							className="blocks-table__placeholder-input"
 						/>
 						<TextControl
-							__next40pxDefaultSize
 							type="number"
 							label={ __( 'Row count' ) }
 							value={ initialRowCount }

package/src/tabs/README.md

@@ -35,12 +35,7 @@ _Defined via the [`supports`](https://developer.wordpress.org/block-editor/refer
   - [`text`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-text): `true`
   - [`background`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-background): `true`
 - [`layout`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout):
-  - [`default`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-default): `{"type":"flex","flexWrap":"nowrap","justifyContent":"stretch","verticalAlignment":"stretch","orientation":"vertical"}`
-  - [`allowSwitching`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-allowswitching): `false`
-  - [`allowVerticalAlignment`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-allowverticalalignment): `true`
-  - [`allowJustification`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-allowjustification): `true`
-  - [`allowOrientation`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-alloworientation): `true`
-  - [`allowSizingOnChildren`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-allowsizingonchildren): `true`
+  - [`allowEditing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-allowediting): `false`
 - [`html`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#html): `false`
 - [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity): `true`
 - [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
@@ -49,7 +44,6 @@ _Defined via the [`supports`](https://developer.wordpress.org/block-editor/refer
   - `padding`: `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`
-- [`renaming`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#renaming): `true`
 
 ## Context
 

package/src/tabs/block.json

@@ -30,18 +30,7 @@
 			}
 		},
 		"layout": {
-			"default": {
-				"type": "flex",
-				"flexWrap": "nowrap",
-				"justifyContent": "stretch",
-				"verticalAlignment": "stretch",
-				"orientation": "vertical"
-			},
-			"allowSwitching": false,
-			"allowVerticalAlignment": true,
-			"allowJustification": true,
-			"allowOrientation": true,
-			"allowSizingOnChildren": true
+			"allowEditing": false
 		},
 		"html": false,
 		"interactivity": true,
@@ -53,16 +42,13 @@
 		"typography": {
 			"fontSize": true,
 			"__experimentalFontFamily": true
-		},
-		"renaming": true
+		}
 	},
 	"providesContext": {
 		"core/tabs-activeTabIndex": "activeTabIndex",
 		"core/tabs-editorActiveTabIndex": "editorActiveTabIndex"
 	},
 	"usesContext": [ "core/tabs-list", "core/tabs-id" ],
-	"editorScript": "file:./index.js",
-	"editorStyle": "file:./index.css",
-	"style": "file:./style-index.css",
+	"style": "wp-block-tabs",
 	"viewScriptModule": "@wordpress/block-library/tabs/view"
 }

package/src/tabs/edit.js

@@ -14,7 +14,7 @@ import { useMemo } from '@wordpress/element';
  * Internal dependencies
  */
 import Controls from './controls';
-import useTabListSync from './use-tab-list-sync';
+import useTabListItemsSync from './use-tab-list-items-sync';
 
 const EMPTY_ARRAY = [];
 
@@ -32,15 +32,15 @@ const EMPTY_ARRAY = [];
  */
 const TABS_TEMPLATE = [ [ 'core/tab-list' ], [ 'core/tab-panels' ] ];
 
-function Edit( { clientId, attributes, setAttributes } ) {
+function Edit( { clientId, attributes } ) {
 	const { anchor, activeTabIndex, editorActiveTabIndex } = attributes;
 
-	const { tabPanels, tabPanelsClientId, tabs, tabListClientId } = useSelect(
+	const { tabPanels, tabListClientId } = useSelect(
 		( select ) => {
 			const { getBlocks } = select( blockEditorStore );
 			const innerBlocks = getBlocks( clientId );
 
-			const tabPanelBlocks = innerBlocks.find(
+			const tabPanelsBlock = innerBlocks.find(
 				( block ) => block.name === 'core/tab-panels'
 			);
 			const tabList = innerBlocks.find(
@@ -48,21 +48,14 @@ function Edit( { clientId, attributes, setAttributes } ) {
 			);
 
 			return {
-				tabPanels: tabPanelBlocks?.innerBlocks ?? EMPTY_ARRAY,
-				tabPanelsClientId: tabPanelBlocks?.clientId ?? null,
-				tabs: tabList?.innerBlocks ?? EMPTY_ARRAY,
+				tabPanels: tabPanelsBlock?.innerBlocks ?? EMPTY_ARRAY,
 				tabListClientId: tabList?.clientId ?? null,
 			};
 		},
 		[ clientId ]
 	);
 
-	useTabListSync( {
-		tabPanels,
-		tabs,
-		tabPanelsClientId,
-		tabListClientId,
-	} );
+	useTabListItemsSync( { tabPanels, tabListClientId } );
 
 	/**
 	 * Memoize context value to prevent unnecessary re-renders.
@@ -70,7 +63,7 @@ function Edit( { clientId, attributes, setAttributes } ) {
 	const contextValue = useMemo( () => {
 		/**
 		 * Compute tabs list from innerblocks to provide via context.
-		 * This traverses the tab-panel block to find all tab blocks
+		 * This traverses the tab-panels block to find all tab-panel blocks
 		 * and extracts their label and anchor for the tab-list to consume.
 		 */
 		const tabList = tabPanels.map( ( tab, index ) => ( {
@@ -100,11 +93,7 @@ function Edit( { clientId, attributes, setAttributes } ) {
 	return (
 		<BlockContextProvider value={ contextValue }>
 			<div { ...innerBlockProps }>
-				<Controls
-					clientId={ clientId }
-					attributes={ attributes }
-					setAttributes={ setAttributes }
-				/>
+				<Controls clientId={ clientId } />
 				{ innerBlockProps.children }
 			</div>
 		</BlockContextProvider>

package/src/tabs/index.js

@@ -22,16 +22,12 @@ export const settings = {
 		innerBlocks: [
 			{
 				name: 'core/tab-list',
-				innerBlocks: [
-					{
-						name: 'core/tab',
-						attributes: { anchor: 'tab-1-button' },
-					},
-					{
-						name: 'core/tab',
-						attributes: { anchor: 'tab-2-button' },
-					},
-				],
+				attributes: {
+					tabs: [
+						{ label: __( 'Tab 1' ) },
+						{ label: __( 'Tab 2' ) },
+					],
+				},
 			},
 			{
 				name: 'core/tab-panels',

package/src/tabs/index.php

@@ -8,12 +8,12 @@
 /**
  * Extract tabs list from tab-panel innerblocks.
  *
- * @since 7.0.0
+ * @since 7.1.0
  *
  * @param array  $innerblocks Parsed inner blocks of tabs block.
  * @param string $tabs_id     Unique ID for the tabs instance, used to generate tab IDs.
  *
- * @return array List of tabs with id, label, index.
+ * @return array List of tab IDs.
  */
 function block_core_tabs_generate_tabs_list( array $innerblocks = array(), string $tabs_id = '' ): array {
 	$tabs_list = array();
@@ -24,8 +24,7 @@ function block_core_tabs_generate_tabs_list( array $innerblocks = array(), strin
 			$tab_index = 0;
 			foreach ( $inner_block['innerBlocks'] ?? array() as $tab_block ) {
 				if ( 'core/tab-panel' === ( $tab_block['blockName'] ?? '' ) ) {
-					$attrs     = $tab_block['attrs'] ?? array();
-					$tab_label = $attrs['label'] ?? '';
+					$attrs = $tab_block['attrs'] ?? array();
 
 					$tab_id = ! empty( $attrs['anchor'] )
 						? $attrs['anchor']
@@ -33,11 +32,7 @@ function block_core_tabs_generate_tabs_list( array $innerblocks = array(), strin
 							? $tabs_id . '-tab-' . $tab_index
 							: 'tab-' . $tab_index );
 
-					$tabs_list[] = array(
-						'id'    => esc_attr( $tab_id ),
-						'label' => $tab_label,
-						'index' => $tab_index,
-					);
+					$tabs_list[] = esc_attr( $tab_id );
 					++$tab_index;
 				}
 			}
@@ -53,7 +48,7 @@ function block_core_tabs_generate_tabs_list( array $innerblocks = array(), strin
  * It is more performant to do this here, once, rather than in the tabs render and tabs context filters.
  * In this way core/tabs is both a provider and a consumer of the core/tabs-list context.
  *
- * @since 7.0.0
+ * @since 7.1.0
  *
  * @param array $context      Default block context.
  * @param array $parsed_block The block being rendered.
@@ -63,8 +58,7 @@ function block_core_tabs_generate_tabs_list( array $innerblocks = array(), strin
 function block_core_tabs_provide_context( array $context, array $parsed_block ): array {
 	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. Used for 3rd party extensibility to identify
-		// the tabs instance.
+		// to derive stable tab IDs.
 		$tabs_id                   = $parsed_block['attrs']['anchor'] ?? wp_unique_id( 'tabs_' );
 		$tabs_list                 = block_core_tabs_generate_tabs_list( $parsed_block['innerBlocks'] ?? array(), $tabs_id );
 		$context['core/tabs-list'] = $tabs_list;
@@ -78,7 +72,7 @@ add_filter( 'render_block_context', 'block_core_tabs_provide_context', 10, 2 );
 /**
  * Render callback for core/tabs.
  *
- * @since 7.0.0
+ * @since 7.1.0
  *
  * @param array     $attributes Block attributes.
  * @param string    $content    Block content.
@@ -96,22 +90,10 @@ function block_core_tabs_render_block_callback( array $attributes, string $conte
 		return '';
 	}
 
-	$is_vertical = false;
-
 	$tag_processor = new WP_HTML_Tag_Processor( $content );
 
 	$tag_processor->next_tag( array( 'class_name' => 'wp-block-tabs' ) );
-	$tag_processor->set_attribute( 'data-wp-interactive', 'core/tabs/private' );
-
-	// Inspect inside the tab-list to see if its vertical or not.
-	$tag_processor->set_bookmark( 'core/tabs_wrapper' );
-	while ( $tag_processor->next_tag( array( 'class_name' => 'wp-block-tabs-list' ) ) ) {
-		if ( $tag_processor->has_class( 'is-vertical' ) ) {
-			$is_vertical = true;
-			break;
-		}
-	}
-	$tag_processor->seek( 'core/tabs_wrapper' );
+	$tag_processor->set_attribute( 'data-wp-interactive', 'core/tabs' );
 
 	$tag_processor->set_attribute(
 		'data-wp-context',
@@ -119,7 +101,6 @@ function block_core_tabs_render_block_callback( array $attributes, string $conte
 			array(
 				'tabsId'         => $tabs_id,
 				'activeTabIndex' => $active_tab_index,
-				'isVertical'     => $is_vertical,
 			)
 		)
 	);
@@ -129,12 +110,11 @@ function block_core_tabs_render_block_callback( array $attributes, string $conte
 	$output = $tag_processor->get_updated_html();
 
 	/**
-	 * Builds a client side state for just this tabs instance.
-	 * This allows 3rd party extensibility of tabs while retaining
-	 * client side state management per core/tabs instance, like context.
+	 * Builds a client side state for just this tabs instance, so each
+	 * core/tabs block manages its own state, like context.
 	 */
 	wp_interactivity_state(
-		'core/tabs/private',
+		'core/tabs',
 		array(
 			$tabs_id => $tabs_list,
 		)
@@ -146,7 +126,7 @@ function block_core_tabs_render_block_callback( array $attributes, string $conte
 /**
  * Registers the `core/tabs` block on the server.
  *
- * @since 7.0.0
+ * @since 7.1.0
  */
 function register_block_core_tabs() {
 	register_block_type_from_metadata(

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

@@ -0,0 +1,49 @@
+/**
+ * WordPress dependencies
+ */
+import { store as blockEditorStore } from '@wordpress/block-editor';
+import { useDispatch } from '@wordpress/data';
+import { useEffect, useRef } from '@wordpress/element';
+
+/**
+ * Keep the tab-list block's `tabs` attribute in sync with the tab-panel blocks.
+ *
+ * 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.
+ *
+ * @param {Object}      props
+ * @param {Array}       props.tabPanels       Raw core/tab-panel block objects.
+ * @param {string|null} props.tabListClientId Client ID of the core/tab-list block.
+ */
+export default function useTabListItemsSync( { tabPanels, tabListClientId } ) {
+	const { updateBlockAttributes, __unstableMarkNextChangeAsNotPersistent } =
+		useDispatch( blockEditorStore );
+
+	const prevTabsRef = useRef( null );
+
+	useEffect( () => {
+		if ( ! tabListClientId ) {
+			return;
+		}
+
+		const newTabs = tabPanels.map( ( tab ) => ( {
+			label: tab.attributes.label || '',
+		} ) );
+
+		// Only update if tabs actually changed to avoid unnecessary re-renders.
+		const serialized = JSON.stringify( newTabs );
+		if ( serialized === prevTabsRef.current ) {
+			return;
+		}
+		prevTabsRef.current = serialized;
+
+		__unstableMarkNextChangeAsNotPersistent();
+		updateBlockAttributes( tabListClientId, { tabs: newTabs } );
+	}, [
+		tabPanels,
+		tabListClientId,
+		updateBlockAttributes,
+		__unstableMarkNextChangeAsNotPersistent,
+	] );
+}