@wordpress/block-library 9.48.0 → 10.0.0

package/src/tabs/view.js

@@ -8,44 +8,8 @@ import {
 	withSyncEvent,
 } from '@wordpress/interactivity';
 
-function createReadOnlyProxy( obj ) {
-	const arrayMutationMethods = new Set( [
-		'push',
-		'pop',
-		'shift',
-		'unshift',
-		'splice',
-		'sort',
-		'reverse',
-		'copyWithin',
-		'fill',
-	] );
-
-	return new Proxy( obj, {
-		get( target, prop ) {
-			// If accessing an array mutation method, return a no-op function.
-			if ( Array.isArray( target ) && arrayMutationMethods.has( prop ) ) {
-				return () => {};
-			}
-
-			const value = target[ prop ];
-			if ( typeof value === 'object' && value !== null ) {
-				return createReadOnlyProxy( value );
-			}
-			return value;
-		},
-		set() {
-			return false;
-		},
-		deleteProperty() {
-			return false;
-		},
-	} );
-}
-
-// Private store for internal tabs functionality and security.
-const { actions: privateActions, state: privateState } = store(
-	'core/tabs/private',
+const { actions, state } = store(
+	'core/tabs',
 	{
 		state: {
 			/**
@@ -56,7 +20,7 @@ const { actions: privateActions, state: privateState } = store(
 			get tabsList() {
 				const context = getContext();
 				const tabsId = context?.tabsId;
-				const tabsList = privateState[ tabsId ];
+				const tabsList = state[ tabsId ];
 				return tabsList;
 			},
 			/**
@@ -71,8 +35,8 @@ const { actions: privateActions, state: privateState } = store(
 				if ( ! tabId ) {
 					return null;
 				}
-				const { tabsList } = privateState;
-				const tabIndex = tabsList.findIndex( ( t ) => t.id === tabId );
+				const { tabsList } = state;
+				const tabIndex = tabsList.findIndex( ( t ) => t === tabId );
 				return tabIndex;
 			},
 			/**
@@ -82,7 +46,7 @@ const { actions: privateActions, state: privateState } = store(
 			 */
 			get isActiveTab() {
 				const { activeTabIndex } = getContext();
-				const { tabIndex } = privateState;
+				const { tabIndex } = state;
 				return activeTabIndex === tabIndex;
 			},
 			/**
@@ -92,7 +56,7 @@ const { actions: privateActions, state: privateState } = store(
 			 * @type {number}
 			 */
 			get tabIndexAttribute() {
-				return privateState.isActiveTab ? 0 : -1;
+				return state.isActiveTab ? 0 : -1;
 			},
 		},
 		actions: {
@@ -102,26 +66,18 @@ const { actions: privateActions, state: privateState } = store(
 			 * @param {KeyboardEvent} event The keydown event.
 			 */
 			handleTabKeyDown: withSyncEvent( ( event ) => {
-				const context = getContext();
-				const { isVertical } = context;
-				const { tabIndex } = privateState;
+				const { tabIndex } = state;
 
 				if ( tabIndex === null ) {
 					return;
 				}
 
-				if ( event.key === 'ArrowRight' && ! isVertical ) {
-					event.preventDefault();
-					privateActions.moveFocus( tabIndex + 1 );
-				} else if ( event.key === 'ArrowLeft' && ! isVertical ) {
+				if ( event.key === 'ArrowRight' ) {
 					event.preventDefault();
-					privateActions.moveFocus( tabIndex - 1 );
-				} else if ( event.key === 'ArrowDown' && isVertical ) {
+					actions.moveFocus( tabIndex + 1 );
+				} else if ( event.key === 'ArrowLeft' ) {
 					event.preventDefault();
-					privateActions.moveFocus( tabIndex + 1 );
-				} else if ( event.key === 'ArrowUp' && isVertical ) {
-					event.preventDefault();
-					privateActions.moveFocus( tabIndex - 1 );
+					actions.moveFocus( tabIndex - 1 );
 				}
 			} ),
 			/**
@@ -132,9 +88,9 @@ const { actions: privateActions, state: privateState } = store(
 			handleTabClick: withSyncEvent( ( event ) => {
 				event.preventDefault();
 
-				const { tabIndex } = privateState;
+				const { tabIndex } = state;
 				if ( tabIndex !== null ) {
-					privateActions.setActiveTab( tabIndex );
+					actions.setActiveTab( tabIndex );
 				}
 			} ),
 			/**
@@ -143,7 +99,7 @@ const { actions: privateActions, state: privateState } = store(
 			 * @param {number} tabIndex The index to move focus to.
 			 */
 			moveFocus: ( tabIndex ) => {
-				const { tabsList } = privateState;
+				const { tabsList } = state;
 
 				if ( ! tabsList || tabsList.length === 0 ) {
 					return;
@@ -156,20 +112,20 @@ const { actions: privateActions, state: privateState } = store(
 					newIndex = 0;
 				}
 
-				const tabId = tabsList[ newIndex ].id;
+				const tabId = tabsList[ newIndex ];
 				const tabElement = document.getElementById( 'tab__' + tabId );
 				if ( tabElement ) {
 					tabElement.focus();
 				}
 			},
 			/**
-			 * Sets the active tab index (internal implementation).
+			 * Sets the active tab index.
 			 *
 			 * @param {number}  tabIndex    The index of the active tab.
 			 * @param {boolean} scrollToTab Whether to scroll to the tab element.
 			 */
 			setActiveTab: ( tabIndex, scrollToTab = false ) => {
-				const { tabsList } = privateState;
+				const { tabsList } = state;
 
 				if ( ! tabsList || tabsList.length === 0 ) {
 					return;
@@ -186,7 +142,7 @@ const { actions: privateActions, state: privateState } = store(
 				context.activeTabIndex = newIndex;
 
 				if ( scrollToTab ) {
-					const tabId = tabsList[ newIndex ].id;
+					const tabId = tabsList[ newIndex ];
 					const tabElement = document.getElementById( tabId );
 					if ( tabElement ) {
 						setTimeout( () => {
@@ -202,17 +158,17 @@ const { actions: privateActions, state: privateState } = store(
 			 *
 			 */
 			onTabsInit: () => {
-				const { tabsList } = privateState;
+				const { tabsList } = state;
 				if ( tabsList.length === 0 ) {
 					return;
 				}
 
 				const { hash } = window.location;
 				const tabId = hash.replace( '#', '' );
-				const tabIndex = tabsList.findIndex( ( t ) => t.id === tabId );
+				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 ) {
-					privateActions.setActiveTab( tabIndex, true );
+					actions.setActiveTab( tabIndex, true );
 				}
 			},
 		},
@@ -221,47 +177,3 @@ const { actions: privateActions, state: privateState } = store(
 		lock: true,
 	}
 );
-
-// Public store for third-party extensibility.
-store( 'core/tabs', {
-	state: {
-		/**
-		 * Gets a contextually aware list of tabs for the current tabs block.
-		 * Public API for third-party access.
-		 *
-		 * @type {Array}
-		 */
-		get tabsList() {
-			return createReadOnlyProxy( privateState.tabsList );
-		},
-		/**
-		 * Gets the index of the active tab element whether it
-		 * is a tab label or tab panel.
-		 *
-		 * @type {number|null}
-		 */
-		get tabIndex() {
-			return privateState.tabIndex;
-		},
-		/**
-		 * Whether the tab panel or tab label is the active tab.
-		 *
-		 * @type {boolean}
-		 */
-		get isActiveTab() {
-			return privateState.isActiveTab;
-		},
-	},
-	actions: {
-		/**
-		 * Sets the active tab index.
-		 * Public API for third-party programmatic tab activation.
-		 *
-		 * @param {number}  tabIndex    The index of the active tab.
-		 * @param {boolean} scrollToTab Whether to scroll to the tab element.
-		 */
-		setActiveTab: ( tabIndex, scrollToTab = false ) => {
-			privateActions.setActiveTab( tabIndex, scrollToTab );
-		},
-	},
-} );

package/src/tag-cloud/README.md

@@ -0,0 +1,62 @@
+# Tag Cloud
+
+<!-- START TOKEN(Autogenerated block API docs) -->
+A cloud of popular keywords, each sized by how often it appears.
+
+- **Name:** `core/tag-cloud`
+- **Category:** [widgets](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-widgets/)
+- **API Version:** [3](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-api-versions/)
+- **Block Type:** [Dynamic](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/) (server-rendered)
+
+## Attributes
+
+_Defined via the [`attributes`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/) property in block.json._
+
+| Attribute | [Type](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#type-validation) | [Default](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#default-value) | Description |
+|-----------|------|---------|-------------|
+| `numberOfTags` | `number` | `45` | — |
+| `taxonomy` | `string` | `"post_tag"` | — |
+| `showTagCounts` | `boolean` | `false` | — |
+| `smallestFontSize` | `string` | `"8pt"` | — |
+| `largestFontSize` | `string` | `"22pt"` | — |
+
+## Supports
+
+_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): `true`
+- [`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): `true`
+- [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
+  - `margin`: `true`
+  - `padding`: `true`
+- [`typography`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography):
+  - [`lineHeight`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography-lineheight): `true`
+- [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity):
+  - `clientNavigation`: `true`
+
+## Block Styles
+
+_Defined via the [`styles`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-styles/) property in block.json._
+
+| Style Name | Label | Default |
+|------------|-------|---------|
+| `default` | Default | Yes |
+| `outline` | Outline | No |
+
+## Block Markup
+
+This is a [**dynamic block**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/). It is rendered on the server and does not save HTML in post content.
+
+In post content, it is stored as a block comment:
+
+```html
+<!-- wp:tag-cloud {"taxonomy":"category"} /-->
+```
+
+## 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.
+
+<!-- END TOKEN(Autogenerated block API docs) -->

package/src/template-part/README.md

@@ -0,0 +1,48 @@
+# Template Part
+
+<!-- START TOKEN(Autogenerated block API docs) -->
+Edit the different global regions of your site, like the header, footer, sidebar, or create your own.
+
+- **Name:** `core/template-part`
+- **Category:** [theme](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-theme/)
+- **API Version:** [3](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-api-versions/)
+- **Block Type:** [Dynamic](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/) (server-rendered)
+
+## Attributes
+
+_Defined via the [`attributes`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/) property in block.json._
+
+| Attribute | [Type](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#type-validation) | [Default](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#default-value) | Description |
+|-----------|------|---------|-------------|
+| `slug` | `string` | — | — |
+| `theme` | `string` | — | — |
+| `tagName` | `string` | — | — |
+| `area` | `string` | — | — |
+
+## Supports
+
+_Defined via the [`supports`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/) property in block.json._
+
+- [`align`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#align): `true`
+- [`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`
+- [`renaming`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#renaming): `false`
+- [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity):
+  - `clientNavigation`: `true`
+
+## Block Markup
+
+This is a [**dynamic block**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/). It is rendered on the server and does not save HTML in post content.
+
+In post content, it is stored as a block comment:
+
+```html
+<!-- wp:template-part {"slug":"header","theme":"twentytwenty"} /-->
+```
+
+## 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.
+
+<!-- END TOKEN(Autogenerated block API docs) -->

package/src/template-part/edit/advanced-controls.js

@@ -57,7 +57,6 @@ export function TemplatePartAdvancedControls( {
 			{ isEntityAvailable && (
 				<>
 					<TextControl
-						__next40pxDefaultSize
 						label={ __( 'Title' ) }
 						value={ title }
 						onChange={ ( value ) => {

package/src/template-part/edit/title-modal.js

@@ -39,7 +39,6 @@ export default function TitleModal( { areaLabel, onClose, onSubmit } ) {
 						value={ title }
 						onChange={ setTitle }
 						placeholder={ __( 'Custom Template Part' ) }
-						__next40pxDefaultSize
 					/>
 					<HStack justify="right">
 						<Button

package/src/term-count/README.md

@@ -0,0 +1,59 @@
+# Term Count
+
+<!-- START TOKEN(Autogenerated block API docs) -->
+Displays the post count of a taxonomy term.
+
+- **Name:** `core/term-count`
+- **Category:** [theme](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-theme/)
+- **API Version:** [3](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-api-versions/)
+- **Block Type:** [Dynamic](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/) (server-rendered)
+
+## Attributes
+
+_Defined via the [`attributes`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/) property in block.json._
+
+| Attribute | [Type](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#type-validation) | [Default](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#default-value) | Description |
+|-----------|------|---------|-------------|
+| `bracketType` | `string` | `"round"` | [Enum](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#enum-validation): `none`, `round`, `square`, `curly`, `angle` |
+
+## Supports
+
+_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): `true`
+- [`html`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#html): `false`
+- [`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`
+- [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
+  - `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`
+  - [`lineHeight`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography-lineheight): `true`
+- [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity):
+  - `clientNavigation`: `true`
+
+## Context
+
+_Defined via the [`usesContext` and `providesContext`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-context/) properties in block.json._
+
+**Uses context:**
+
+- `termId`
+- `taxonomy`
+
+## Block Markup
+
+This is a [**dynamic block**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/). It is rendered on the server and does not save HTML in post content.
+
+In post content, it is stored as a block comment:
+
+```html
+<!-- wp:term-count /-->
+```
+
+## 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.
+
+<!-- END TOKEN(Autogenerated block API docs) -->

package/src/term-description/README.md

@@ -0,0 +1,60 @@
+# Term Description
+
+<!-- START TOKEN(Autogenerated block API docs) -->
+Display the description of categories, tags and custom taxonomies when viewing an archive.
+
+- **Name:** `core/term-description`
+- **Category:** [theme](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-theme/)
+- **API Version:** [3](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-api-versions/)
+- **Block Type:** [Dynamic](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/) (server-rendered)
+
+## Attributes
+
+_Defined via the [`attributes`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/) property in block.json._
+
+_This block has no custom attributes._
+
+## Supports
+
+_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): `true`
+- [`align`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#align): `"wide"`, `"full"`
+- [`html`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#html): `false`
+- [`color`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color):
+  - [`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):
+  - `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`
+  - [`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`
+- [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity):
+  - `clientNavigation`: `true`
+
+## Context
+
+_Defined via the [`usesContext` and `providesContext`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-context/) properties in block.json._
+
+**Uses context:**
+
+- `termId`
+- `taxonomy`
+
+## Block Markup
+
+This is a [**dynamic block**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/). It is rendered on the server and does not save HTML in post content.
+
+In post content, it is stored as a block comment:
+
+```html
+<!-- wp:term-description {"align":"full"} /-->
+```
+
+## 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.
+
+<!-- END TOKEN(Autogenerated block API docs) -->

package/src/term-name/README.md

@@ -0,0 +1,65 @@
+# Term Name
+
+<!-- START TOKEN(Autogenerated block API docs) -->
+Displays the name of a taxonomy term.
+
+- **Name:** `core/term-name`
+- **Category:** [theme](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-theme/)
+- **API Version:** [3](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-api-versions/)
+- **Block Type:** [Dynamic](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/) (server-rendered)
+- **Keywords:** `term title`
+
+## Attributes
+
+_Defined via the [`attributes`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/) property in block.json._
+
+| Attribute | [Type](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#type-validation) | [Default](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#default-value) | Description |
+|-----------|------|---------|-------------|
+| `textAlign` | `string` | — | — |
+| `level` | `number` | `0` | — |
+| `isLink` | `boolean` | `false` | — |
+| `levelOptions` | `array` | — | — |
+
+## Supports
+
+_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): `true`
+- [`align`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#align): `"wide"`, `"full"`
+- [`html`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#html): `false`
+- [`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`
+- [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
+  - `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`
+  - [`lineHeight`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography-lineheight): `true`
+- [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity):
+  - `clientNavigation`: `true`
+
+## Context
+
+_Defined via the [`usesContext` and `providesContext`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-context/) properties in block.json._
+
+**Uses context:**
+
+- `termId`
+- `taxonomy`
+
+## Block Markup
+
+This is a [**dynamic block**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/). It is rendered on the server and does not save HTML in post content.
+
+In post content, it is stored as a block comment:
+
+```html
+<!-- wp:term-name /-->
+```
+
+## 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.
+
+<!-- END TOKEN(Autogenerated block API docs) -->

package/src/term-template/README.md

@@ -0,0 +1,65 @@
+# Term Template
+
+<!-- START TOKEN(Autogenerated block API docs) -->
+Contains the block elements used to render a taxonomy term, like the name, description, and more.
+
+- **Name:** `core/term-template`
+- **Category:** [theme](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-theme/)
+- **API Version:** [3](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-api-versions/)
+- **Block Type:** [Hybrid](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/) (static save + server enhancements)
+
+## Block Relationships
+
+**[Ancestor](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/#ancestor) blocks:**
+- [`core/terms-query`](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-theme/core-block-terms-query/)
+
+## Attributes
+
+_Defined via the [`attributes`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/) property in block.json._
+
+_This block has no custom attributes._
+
+## Supports
+
+_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): `true`
+- [`reusable`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#reusable): `false`
+- [`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`
+- [`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`
+- [`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`
+
+## Context
+
+_Defined via the [`usesContext` and `providesContext`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-context/) properties in block.json._
+
+**Uses context:**
+
+- `termQuery`
+
+## Block Markup
+
+This is a [**hybrid block**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/). It saves static markup that the server may enhance during rendering.
+
+```html
+<!-- wp:term-template /-->
+```
+
+## 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.
+
+<!-- END TOKEN(Autogenerated block API docs) -->