updates nomenclature "category" > "tab"

update e2e tests
remove `_experimental` Flag for initialTab prop

docs/reference-guides/data/data-core-customize-widgets.md

@@ -78,7 +78,7 @@ _Parameters_
 -   _value_ `boolean|Object`: Whether the inserter should be opened (true) or closed (false). To specify an insertion point, use an object.
 -   _value.rootClientId_ `string`: The root client ID to insert at.
 -   _value.insertionIndex_ `number`: The index to insert at.
--   _value.initialCategory_ `string`: The tab category to display first when the block editor inserter is opened. A category corresponds to one of the tab categories defined in packages/block-editor/src/components/inserter/tabs.js.
+-   _value.initialTab_ `string`: The id of the tab to display first when the block editor inserter is opened. A category corresponds to one of the tab ids defined in packages/block-editor/src/components/inserter/tabs.js.
 
 _Returns_
 

docs/reference-guides/data/data-core-edit-widgets.md

@@ -215,7 +215,7 @@ _Parameters_
 -   _value_ `boolean|Object`: Whether the inserter should be opened (true) or closed (false). To specify an insertion point, use an object.
 -   _value.rootClientId_ `string`: The root client ID to insert at.
 -   _value.insertionIndex_ `number`: The index to insert at.
--   _value.initialCategory_ `string`: The tab category to display first when the block editor inserter is opened. A category corresponds to one of the tab categories defined in packages/block-editor/src/components/inserter/tabs.js.
+-   _value.initialTab_ `string`: The id of the tab to display first when the block editor inserter is opened. A category corresponds to one of the tab ids defined in packages/block-editor/src/components/inserter/tabs.js.
 
 _Returns_
 

docs/reference-guides/data/data-core-editor.md

@@ -1382,7 +1382,7 @@ _Parameters_
 -   _value_ `boolean|Object`: Whether the inserter should be opened (true) or closed (false). To specify an insertion point, use an object.
 -   _value.rootClientId_ `string`: The root client ID to insert at.
 -   _value.insertionIndex_ `number`: The index to insert at.
--   _value.initialCategory_ `string`: The tab category to display first when the block editor inserter is opened. A category corresponds to one of the tab categories defined in packages/block-editor/src/components/inserter/tabs.js.
+-   _value.initialTab_ `string`: The id of the tab to display first when the block editor inserter is opened. A category corresponds to one of the tab ids defined in packages/block-editor/src/components/inserter/tabs.js.
 
 _Returns_
 

packages/block-editor/src/components/inserter/library.js

@@ -21,7 +21,7 @@ function InserterLibrary(
 		showMostUsedBlocks = false,
 		__experimentalInsertionIndex,
 		__experimentalFilterValue,
-		__experimentalInitialCategory,
+		initialInserterTab,
 		onSelect = noop,
 		shouldFocusBlock = false,
 	},
@@ -47,7 +47,7 @@ function InserterLibrary(
 			isAppender={ isAppender }
 			showInserterHelpPanel={ showInserterHelpPanel }
 			showMostUsedBlocks={ showMostUsedBlocks }
-			__experimentalInitialCategory={ __experimentalInitialCategory }
+			initialInserterTab={ initialInserterTab }
 			__experimentalInsertionIndex={ __experimentalInsertionIndex }
 			__experimentalFilterValue={ __experimentalFilterValue }
 			shouldFocusBlock={ shouldFocusBlock }

packages/block-editor/src/components/inserter/menu.js

@@ -45,7 +45,7 @@ function InserterMenu(
 		showMostUsedBlocks,
 		__experimentalFilterValue = '',
 		shouldFocusBlock = true,
-		__experimentalInitialCategory,
+		initialInserterTab,
 	},
 	ref
 ) {
@@ -58,7 +58,7 @@ function InserterMenu(
 	const [ selectedMediaCategory, setSelectedMediaCategory ] =
 		useState( null );
 	const [ selectedTab, setSelectedTab ] = useState(
-		__experimentalInitialCategory || null
+		initialInserterTab || null
 	);
 	const [ destinationRootClientId, onInsertBlocks, onToggleInsertionPoint ] =
 		useInsertionPoint( {
@@ -261,7 +261,7 @@ function InserterMenu(
 						showMedia={ showMedia }
 						onSelect={ handleSetSelectedTab }
 						tabsContents={ inserterTabsContents }
-						initialTabId={ __experimentalInitialCategory }
+						initialTabId={ initialInserterTab }
 					/>
 				) }
 				{ ! delayedFilterValue && ! showAsTabs && (

packages/block-library/src/post-content/edit.js

@@ -15,11 +15,7 @@ import {
 	Warning,
 	store as blockEditorStore,
 } from '@wordpress/block-editor';
-import {
-	useEntityProp,
-	useEntityBlockEditor,
-	store as coreStore,
-} from '@wordpress/core-data';
+import { useEntityProp, useEntityBlockEditor } from '@wordpress/core-data';
 import { useSelect, useDispatch } from '@wordpress/data';
 import { Placeholder, Button } from '@wordpress/components';
 import { postContent as icon } from '@wordpress/icons';
@@ -105,23 +101,14 @@ function EditableContent( { context = {}, clientId } ) {
 		{ id: postId }
 	);
 
-	const { entityRecord, setInserterIsOpened } = useSelect(
-		( select ) => {
-			return {
-				entityRecord: select( coreStore ).getEntityRecord(
-					'postType',
-					postType,
-					postId
-				),
-				setInserterIsOpened:
-					select( blockEditorStore ).getSettings()
-						.__experimentalSetIsInserterOpened,
-			};
-		},
+	const setInserterIsOpened = useSelect(
+		( select ) =>
+			select( blockEditorStore ).getSettings()
+				.__experimentalSetIsInserterOpened,
 		[ postType, postId ]
 	);
 
-	const hasInnerBlocks = !! entityRecord?.content?.raw || blocks?.length;
+	const hasInnerBlocks = blocks?.length;
 
 	const { children, ...props } = useInnerBlocksProps(
 		useBlockProps( {
@@ -144,7 +131,7 @@ function EditableContent( { context = {}, clientId } ) {
 
 	const openInserter = () => {
 		setInserterIsOpened( {
-			initialCategory: 'patterns',
+			initialTab: 'patterns',
 			rootClientId: clientId,
 			insertionIndex: 0,
 		} );

packages/customize-widgets/src/store/actions.js

@@ -1,14 +1,14 @@
 /**
  * Returns an action object used to open/close the inserter.
  *
- * @param {boolean|Object} value                 Whether the inserter should be
- *                                               opened (true) or closed (false).
- *                                               To specify an insertion point,
- *                                               use an object.
- * @param {string}         value.rootClientId    The root client ID to insert at.
- * @param {number}         value.insertionIndex  The index to insert at.
- * @param {string}         value.initialCategory The tab category to display first when the block editor inserter is opened.
- *                                               A category corresponds to one of the tab categories defined in packages/block-editor/src/components/inserter/tabs.js.
+ * @param {boolean|Object} value                Whether the inserter should be
+ *                                              opened (true) or closed (false).
+ *                                              To specify an insertion point,
+ *                                              use an object.
+ * @param {string}         value.rootClientId   The root client ID to insert at.
+ * @param {number}         value.insertionIndex The index to insert at.
+ * @param {string}         value.initialTab     The id of the tab to display first when the block editor inserter is opened.
+ *                                              A category corresponds to one of the tab ids defined in packages/block-editor/src/components/inserter/tabs.js.
  *
  * @example
  * ```js

packages/edit-widgets/src/store/actions.js

@@ -342,14 +342,14 @@ export function setIsWidgetAreaOpen( clientId, isOpen ) {
 /**
  * Returns an action object used to open/close the inserter.
  *
- * @param {boolean|Object} value                 Whether the inserter should be
- *                                               opened (true) or closed (false).
- *                                               To specify an insertion point,
- *                                               use an object.
- * @param {string}         value.rootClientId    The root client ID to insert at.
- * @param {number}         value.insertionIndex  The index to insert at.
- * @param {string}         value.initialCategory The tab category to display first when the block editor inserter is opened.
- *                                               A category corresponds to one of the tab categories defined in packages/block-editor/src/components/inserter/tabs.js.
+ * @param {boolean|Object} value                Whether the inserter should be
+ *                                              opened (true) or closed (false).
+ *                                              To specify an insertion point,
+ *                                              use an object.
+ * @param {string}         value.rootClientId   The root client ID to insert at.
+ * @param {number}         value.insertionIndex The index to insert at.
+ * @param {string}         value.initialTab     The id of the tab to display first when the block editor inserter is opened.
+ *                                              A category corresponds to one of the tab ids defined in packages/block-editor/src/components/inserter/tabs.js.
  *
  * @return {Object} Action object.
  */

packages/editor/src/components/inserter-sidebar/index.js

@@ -20,15 +20,15 @@ import { unlock } from '../../lock-unlock';
 import { store as editorStore } from '../../store';
 
 export default function InserterSidebar() {
-	const { insertionPoint, inserterInitialCategory, showMostUsedBlocks } =
+	const { insertionPoint, initialInserterTab, showMostUsedBlocks } =
 		useSelect( ( select ) => {
-			const { getInsertionPoint, getInserterInitialCategory } = unlock(
+			const { getInsertionPoint, getInserterInitialTab } = unlock(
 				select( editorStore )
 			);
 			const { get } = select( preferencesStore );
 			return {
 				insertionPoint: getInsertionPoint(),
-				inserterInitialCategory: getInserterInitialCategory(),
+				initialInserterTab: getInserterInitialTab(),
 				showMostUsedBlocks: get( 'core', 'mostUsedBlocks' ),
 			};
 		}, [] );
@@ -68,7 +68,7 @@ export default function InserterSidebar() {
 					__experimentalInsertionIndex={
 						insertionPoint.insertionIndex
 					}
-					__experimentalInitialCategory={ inserterInitialCategory }
+					initialInserterTab={ initialInserterTab }
 					__experimentalFilterValue={ insertionPoint.filterValue }
 					ref={ libraryRef }
 				/>

packages/editor/src/store/actions.js

@@ -691,14 +691,14 @@ export function removeEditorPanel( panelName ) {
 /**
  * Returns an action object used to open/close the inserter.
  *
- * @param {boolean|Object} value                 Whether the inserter should be
- *                                               opened (true) or closed (false).
- *                                               To specify an insertion point,
- *                                               use an object.
- * @param {string}         value.rootClientId    The root client ID to insert at.
- * @param {number}         value.insertionIndex  The index to insert at.
- * @param {string}         value.initialCategory The tab category to display first when the block editor inserter is opened.
- *                                               A category corresponds to one of the tab categories defined in packages/block-editor/src/components/inserter/tabs.js.
+ * @param {boolean|Object} value                Whether the inserter should be
+ *                                              opened (true) or closed (false).
+ *                                              To specify an insertion point,
+ *                                              use an object.
+ * @param {string}         value.rootClientId   The root client ID to insert at.
+ * @param {number}         value.insertionIndex The index to insert at.
+ * @param {string}         value.initialTab     The id of the tab to display first when the block editor inserter is opened.
+ *                                              A category corresponds to one of the tab ids defined in packages/block-editor/src/components/inserter/tabs.js.
  *
  * @return {Object} Action object.
  */

packages/editor/src/store/private-selectors.js

@@ -51,17 +51,17 @@ export const getInsertionPoint = createRegistrySelector(
 );
 
 /**
- * Get the initial category for the inserter.
- * A category corresponds to one of the tab categories defined in packages/block-editor/src/components/inserter/tabs.js.
+ * Get the initial tab id for the inserter.
+ * A category corresponds to one of the tab ids defined in packages/block-editor/src/components/inserter/tabs.js.
  *
  * @param {Object} state Global application state.
  *
  * @return {string} The initial tab category to open when the inserter is opened.
  */
-export const getInserterInitialCategory = createRegistrySelector(
+export const getInserterInitialTab = createRegistrySelector(
 	() => ( state ) =>
 		typeof state.blockInserterPanel === 'object'
-			? state.blockInserterPanel?.initialCategory
+			? state.blockInserterPanel?.initialTab
 			: null
 );
 

test/e2e/specs/site-editor/pages.spec.js

@@ -23,8 +23,8 @@ async function addPageContent( editor, page ) {
 		.getByRole( 'document', {
 			name: 'Block: Content',
 		} )
-		.getByRole( 'document', {
-			name: 'Empty block; start writing or type forward slash to choose a block',
+		.getByRole( 'button', {
+			name: 'Start blank',
 		} )
 		.click();
 
@@ -124,9 +124,7 @@ test.describe( 'Pages', () => {
 			editor.canvas.getByRole( 'document', {
 				name: 'Block: Content',
 			} )
-		).toContainText(
-			'This is the Content block, it will display all the blocks in any single post or page.'
-		);
+		).toContainText( 'This block will be replaced with your content.' );
 		await expect(
 			page.locator(
 				'role=button[name="Dismiss this notice"i] >> text="Editing template. Changes made here affect all posts and pages that use the template."'