@wordpress/block-library 9.33.1-next.ff1cebbba.0 → 9.33.2-next.36001005c.0

package/src/breadcrumbs/index.php

@@ -17,6 +17,11 @@
  * @return string Returns the post breadcrumb for hierarchical post types.
  */
 function render_block_core_breadcrumbs( $attributes, $content, $block ) {
+	// Exclude breadcrumbs from special contexts like archives, search, 404, etc.
+	// until they are explicitly supported.
+	if ( is_archive() || is_search() || is_404() || is_home() || is_front_page() ) {
+		return '';
+	}
 	if ( ! isset( $block->context['postId'] ) || ! isset( $block->context['postType'] ) ) {
 		return '';
 	}
@@ -24,16 +29,12 @@ function render_block_core_breadcrumbs( $attributes, $content, $block ) {
 	$post_id   = $block->context['postId'];
 	$post_type = $block->context['postType'];
 
-	// Only render for hierarchical post types.
-	if ( ! is_post_type_hierarchical( $post_type ) ) {
-		return '';
-	}
-
 	$post = get_post( $post_id );
 	if ( ! $post ) {
 		return '';
 	}
 
+	$type             = $attributes['type'];
 	$breadcrumb_items = array();
 	if ( $attributes['showHomeLink'] ) {
 		$breadcrumb_items[] = sprintf(
@@ -42,18 +43,14 @@ function render_block_core_breadcrumbs( $attributes, $content, $block ) {
 			esc_html__( 'Home' )
 		);
 	}
-
-	$ancestors = get_post_ancestors( $post_id );
-	$ancestors = array_reverse( $ancestors );
-
-	foreach ( $ancestors as $ancestor_id ) {
-		$breadcrumb_items[] = sprintf(
-			'<a href="%s">%s</a>',
-			esc_url( get_permalink( $ancestor_id ) ),
-			get_the_title( $ancestor_id )
-		);
+	$supported_types = array( 'postWithAncestors', 'postWithTerms' );
+	// If `type` is not set to a specific breadcrumb type, determine it based on the block's default heuristics.
+	$breadcrumbs_type = in_array( $type, $supported_types, true ) ? $type : block_core_breadcrumbs_get_breadcrumbs_type( $post_type );
+	if ( 'postWithAncestors' === $breadcrumbs_type ) {
+		$breadcrumb_items = array_merge( $breadcrumb_items, block_core_breadcrumbs_get_hierarchical_post_type_breadcrumbs( $post_id ) );
+	} else {
+		$breadcrumb_items = array_merge( $breadcrumb_items, block_core_breadcrumbs_get_terms_breadcrumbs( $post_id, $post_type ) );
 	}
-
 	// Add current post title (not linked).
 	$breadcrumb_items[] = sprintf( '<span aria-current="page">%s</span>', get_the_title( $post ) );
 	$wrapper_attributes = get_block_wrapper_attributes(
@@ -80,6 +77,111 @@ function render_block_core_breadcrumbs( $attributes, $content, $block ) {
 	return $breadcrumb_html;
 }
 
+/**
+ * Determines the breadcrumb type based on the block's default heuristics.
+ *
+ * @since 6.9.0
+ *
+ * @param string $post_type The post type name.
+ *
+ * @return string The breadcrumb type.
+ */
+function block_core_breadcrumbs_get_breadcrumbs_type( $post_type ) {
+	return is_post_type_hierarchical( $post_type ) ? 'postWithAncestors' : 'postWithTerms';
+}
+
+/**
+ * Generates breadcrumb items from hierarchical post type ancestors.
+ *
+ * @since 6.9.0
+ *
+ * @param int    $post_id   The post ID.
+ *
+ * @return array Array of breadcrumb HTML items.
+ */
+function block_core_breadcrumbs_get_hierarchical_post_type_breadcrumbs( $post_id ) {
+	$breadcrumb_items = array();
+	$ancestors        = get_post_ancestors( $post_id );
+	$ancestors        = array_reverse( $ancestors );
+
+	foreach ( $ancestors as $ancestor_id ) {
+		$breadcrumb_items[] = sprintf(
+			'<a href="%s">%s</a>',
+			esc_url( get_permalink( $ancestor_id ) ),
+			get_the_title( $ancestor_id )
+		);
+	}
+	return $breadcrumb_items;
+}
+
+
+/**
+ * Generates breadcrumb items from taxonomy terms.
+ *
+ * Finds the first publicly queryable taxonomy with terms assigned to the post
+ * and generates breadcrumb links, including hierarchical term ancestors if applicable.
+ *
+ * @since 6.9.0
+ *
+ * @param int    $post_id   The post ID.
+ * @param string $post_type The post type name.
+ *
+ * @return array Array of breadcrumb HTML items.
+ */
+function block_core_breadcrumbs_get_terms_breadcrumbs( $post_id, $post_type ) {
+	$breadcrumb_items = array();
+	// Get public taxonomies for this post type.
+	$taxonomies = wp_filter_object_list(
+		get_object_taxonomies( $post_type, 'objects' ),
+		array(
+			'publicly_queryable' => true,
+			'show_in_rest'       => true,
+		)
+	);
+
+	if ( empty( $taxonomies ) ) {
+		return array();
+	}
+
+	// Find the first taxonomy that has terms assigned to this post.
+	$taxonomy_name = null;
+	$terms         = array();
+	foreach ( $taxonomies as $taxonomy ) {
+		$post_terms = get_the_terms( $post_id, $taxonomy->name );
+		if ( ! empty( $post_terms ) && ! is_wp_error( $post_terms ) ) {
+			$taxonomy_name = $taxonomy->name;
+			$terms         = $post_terms;
+			break;
+		}
+	}
+
+	if ( ! empty( $terms ) ) {
+		// Use the first term (if multiple are assigned).
+		$term = reset( $terms );
+		// Check if taxonomy is hierarchical also add ancestor term links
+		if ( is_taxonomy_hierarchical( $taxonomy_name ) ) {
+			$term_ancestors = get_ancestors( $term->term_id, $taxonomy_name, 'taxonomy' );
+			$term_ancestors = array_reverse( $term_ancestors );
+			foreach ( $term_ancestors as $ancestor_id ) {
+				$ancestor_term = get_term( $ancestor_id, $taxonomy_name );
+				if ( $ancestor_term && ! is_wp_error( $ancestor_term ) ) {
+					$breadcrumb_items[] = sprintf(
+						'<a href="%s">%s</a>',
+						esc_url( get_term_link( $ancestor_term ) ),
+						esc_html( $ancestor_term->name )
+					);
+				}
+			}
+		}
+		$breadcrumb_items[] = sprintf(
+			'<a href="%s">%s</a>',
+			esc_url( get_term_link( $term ) ),
+			esc_html( $term->name )
+		);
+	}
+	return $breadcrumb_items;
+}
+
 /**
  * Registers the `core/breadcrumbs` block on the server.
  *

package/src/buttons/transforms.js

@@ -7,7 +7,7 @@ import { __unstableCreateElement as createElement } from '@wordpress/rich-text';
 /**
  * Internal dependencies
  */
-import { getTransformedMetadata } from '../utils/get-transformed-metadata';
+import { getTransformedAttributes } from '../utils/get-transformed-attributes';
 
 const transforms = {
 	from: [
@@ -38,7 +38,7 @@ const transforms = {
 					{},
 					// Loop the selected buttons.
 					buttons.map( ( attributes ) => {
-						const { content, metadata } = attributes;
+						const { content } = attributes;
 						const element = createElement( document, content );
 						// Remove any HTML tags.
 						const text = element.innerText || '';
@@ -47,15 +47,15 @@ const transforms = {
 						const url = link?.getAttribute( 'href' );
 						// Create singular button in the buttons block.
 						return createBlock( 'core/button', {
-							text,
-							url,
-							metadata: getTransformedMetadata(
-								metadata,
+							...getTransformedAttributes(
+								attributes,
 								'core/button',
 								( { content: contentBinding } ) => ( {
 									text: contentBinding,
 								} )
 							),
+							text,
+							url,
 						} );
 					} )
 				),

package/src/code/transforms.js

@@ -7,7 +7,7 @@ import { create, toHTMLString } from '@wordpress/rich-text';
 /**
  * Internal dependencies
  */
-import { getTransformedMetadata } from '../utils/get-transformed-metadata';
+import { getTransformedAttributes } from '../utils/get-transformed-attributes';
 
 const transforms = {
 	from: [
@@ -19,21 +19,24 @@ const transforms = {
 		{
 			type: 'block',
 			blocks: [ 'core/paragraph' ],
-			transform: ( { content, metadata } ) =>
-				createBlock( 'core/code', {
+			transform: ( attributes ) => {
+				const { content } = attributes;
+				return createBlock( 'core/code', {
+					...getTransformedAttributes( attributes, 'core/code' ),
 					content,
-					metadata: getTransformedMetadata( metadata, 'core/code' ),
-				} ),
+				} );
+			},
 		},
 		{
 			type: 'block',
 			blocks: [ 'core/html' ],
-			transform: ( { content: text, metadata } ) => {
+			transform: ( attributes ) => {
+				const { content: text } = attributes;
 				return createBlock( 'core/code', {
+					...getTransformedAttributes( attributes, 'core/code' ),
 					// The HTML is plain text (with plain line breaks), so
 					// convert it to rich text.
 					content: toHTMLString( { value: create( { text } ) } ),
-					metadata: getTransformedMetadata( metadata, 'core/code' ),
 				} );
 			},
 		},
@@ -60,14 +63,13 @@ const transforms = {
 		{
 			type: 'block',
 			blocks: [ 'core/paragraph' ],
-			transform: ( { content, metadata } ) =>
-				createBlock( 'core/paragraph', {
+			transform: ( attributes ) => {
+				const { content } = attributes;
+				return createBlock( 'core/paragraph', {
+					...getTransformedAttributes( attributes, 'core/paragraph' ),
 					content,
-					metadata: getTransformedMetadata(
-						metadata,
-						'core/paragraph'
-					),
-				} ),
+				} );
+			},
 		},
 	],
 };

package/src/heading/index.js

@@ -13,7 +13,6 @@ import edit from './edit';
 import metadata from './block.json';
 import save from './save';
 import transforms from './transforms';
-import variations from './variations';
 
 const { name } = metadata;
 
@@ -66,7 +65,6 @@ export const settings = {
 	},
 	edit,
 	save,
-	variations,
 };
 
 export const init = () => initBlock( { name, metadata, settings } );

package/src/heading/transforms.js

@@ -7,7 +7,7 @@ import { createBlock, getBlockAttributes } from '@wordpress/blocks';
  * Internal dependencies
  */
 import { getLevelFromHeadingNodeName } from './shared';
-import { getTransformedMetadata } from '../utils/get-transformed-metadata';
+import { getTransformedAttributes } from '../utils/get-transformed-attributes';
 
 const transforms = {
 	from: [
@@ -16,21 +16,21 @@ const transforms = {
 			isMultiBlock: true,
 			blocks: [ 'core/paragraph' ],
 			transform: ( attributes ) =>
-				attributes.map(
-					( { content, anchor, align: textAlign, metadata } ) =>
-						createBlock( 'core/heading', {
-							content,
-							anchor,
-							textAlign,
-							metadata: getTransformedMetadata(
-								metadata,
-								'core/heading',
-								( { content: contentBinding } ) => ( {
-									content: contentBinding,
-								} )
-							),
-						} )
-				),
+				attributes.map( ( _attributes ) => {
+					const { content, anchor, align: textAlign } = _attributes;
+					return createBlock( 'core/heading', {
+						...getTransformedAttributes(
+							_attributes,
+							'core/heading',
+							( { content: contentBinding } ) => ( {
+								content: contentBinding,
+							} )
+						),
+						content,
+						anchor,
+						textAlign,
+					} );
+				} ),
 		},
 		{
 			type: 'raw',
@@ -91,19 +91,20 @@ const transforms = {
 			isMultiBlock: true,
 			blocks: [ 'core/paragraph' ],
 			transform: ( attributes ) =>
-				attributes.map( ( { content, textAlign: align, metadata } ) =>
-					createBlock( 'core/paragraph', {
-						content,
-						align,
-						metadata: getTransformedMetadata(
-							metadata,
+				attributes.map( ( _attributes ) => {
+					const { content, textAlign: align } = _attributes;
+					return createBlock( 'core/paragraph', {
+						...getTransformedAttributes(
+							_attributes,
 							'core/paragraph',
 							( { content: contentBinding } ) => ( {
 								content: contentBinding,
 							} )
 						),
-					} )
-				),
+						content,
+						align,
+					} );
+				} ),
 		},
 	],
 };

package/src/index.js

@@ -72,6 +72,7 @@ import * as image from './image';
 import * as latestComments from './latest-comments';
 import * as latestPosts from './latest-posts';
 import * as list from './list';
+import * as math from './math';
 import * as listItem from './list-item';
 import * as logInOut from './loginout';
 import * as mediaText from './media-text';
@@ -163,7 +164,6 @@ const getAllBlocks = () => {
 		accordionPanel,
 		archives,
 		audio,
-		breadcrumbs,
 		button,
 		buttons,
 		calendar,
@@ -178,6 +178,7 @@ const getAllBlocks = () => {
 		file,
 		group,
 		html,
+		math,
 		latestComments,
 		latestPosts,
 		mediaText,
@@ -254,13 +255,14 @@ const getAllBlocks = () => {
 		termCount,
 		termDescription,
 		termName,
+		termsQuery,
+		termTemplate,
 		queryTitle,
 		postAuthorBiography,
 	];
 
 	if ( window?.__experimentalEnableBlockExperiments ) {
-		blocks.push( termsQuery );
-		blocks.push( termTemplate );
+		blocks.push( breadcrumbs );
 	}
 
 	if ( window?.__experimentalEnableFormBlocks ) {

package/src/math/block.json

@@ -0,0 +1,21 @@
+{
+	"$schema": "https://schemas.wp.org/trunk/block.json",
+	"apiVersion": 3,
+	"name": "core/math",
+	"title": "Math",
+	"category": "text",
+	"description": "Display mathematical notation using LaTeX.",
+	"keywords": [ "equation", "formula", "latex", "mathematics" ],
+	"textdomain": "default",
+	"attributes": {
+		"latex": {
+			"type": "string",
+			"role": "content"
+		},
+		"mathML": {
+			"type": "string",
+			"source": "html",
+			"selector": "math"
+		}
+	}
+}

package/src/math/edit.js

@@ -0,0 +1,123 @@
+/**
+ * WordPress dependencies
+ */
+import { __ } from '@wordpress/i18n';
+import {
+	useBlockProps,
+	store as blockEditorStore,
+} from '@wordpress/block-editor';
+import {
+	TextareaControl,
+	Popover,
+	__experimentalVStack as VStack,
+	privateApis as componentsPrivateApis,
+} from '@wordpress/components';
+import { useState, useEffect, useRef } from '@wordpress/element';
+import { useDispatch } from '@wordpress/data';
+
+/**
+ * Internal dependencies
+ */
+import { unlock } from '../lock-unlock';
+
+const { Badge } = unlock( componentsPrivateApis );
+
+export default function MathEdit( { attributes, setAttributes, isSelected } ) {
+	const { latex } = attributes;
+	const [ blockRef, setBlockRef ] = useState();
+	const [ error, setError ] = useState( null );
+	const [ latexToMathML, setLatexToMathML ] = useState();
+	const initialLatex = useRef( attributes.latex );
+	const { __unstableMarkNextChangeAsNotPersistent } =
+		useDispatch( blockEditorStore );
+
+	useEffect( () => {
+		import( '@wordpress/latex-to-mathml' ).then( ( module ) => {
+			setLatexToMathML( () => module.default );
+			if ( initialLatex.current ) {
+				__unstableMarkNextChangeAsNotPersistent();
+				setAttributes( {
+					mathML: module.default( initialLatex.current, {
+						displayMode: true,
+					} ),
+				} );
+			}
+		} );
+	}, [
+		initialLatex,
+		setAttributes,
+		__unstableMarkNextChangeAsNotPersistent,
+	] );
+
+	const blockProps = useBlockProps( {
+		ref: setBlockRef,
+		position: 'relative',
+	} );
+
+	return (
+		<div { ...blockProps }>
+			{ attributes.mathML ? (
+				<math
+					// We can't spread block props on the math element because
+					// it only supports a limited amount of global attributes.
+					// For example, draggable will have no effect.
+					display="block"
+					dangerouslySetInnerHTML={ { __html: attributes.mathML } }
+				/>
+			) : (
+				'\u200B'
+			) }
+			{ isSelected && (
+				<Popover
+					placement="bottom-start"
+					offset={ 8 }
+					anchor={ blockRef }
+					focusOnMount="firstContentElement"
+				>
+					<div style={ { padding: '4px', minWidth: '300px' } }>
+						<VStack spacing={ 1 }>
+							<TextareaControl
+								__nextHasNoMarginBottom
+								__next40pxDefaultSize
+								label={ __( 'LaTeX math syntax' ) }
+								hideLabelFromVision
+								value={ latex }
+								onChange={ ( newLatex ) => {
+									if ( ! latexToMathML ) {
+										setAttributes( { latex: newLatex } );
+										return;
+									}
+									let mathML = '';
+									try {
+										mathML = latexToMathML( newLatex, {
+											displayMode: true,
+										} );
+										setError( null );
+									} catch ( err ) {
+										setError( err.message );
+									}
+									setAttributes( {
+										mathML,
+										latex: newLatex,
+									} );
+								} }
+								placeholder={ __( 'e.g., x^2, \\frac{a}{b}' ) }
+							/>
+							{ error && (
+								<>
+									<Badge
+										intent="error"
+										className="wp-block-math__error"
+									>
+										{ error }
+									</Badge>
+									<style children=".wp-block-math__error .components-badge__content{white-space:normal}" />
+								</>
+							) }
+						</VStack>
+					</div>
+				</Popover>
+			) }
+		</div>
+	);
+}

package/src/math/index.js

@@ -0,0 +1,31 @@
+/**
+ * WordPress dependencies
+ */
+import { math as icon } from '@wordpress/icons';
+
+/**
+ * Internal dependencies
+ */
+import initBlock from '../utils/init-block';
+import edit from './edit';
+import metadata from './block.json';
+import save from './save';
+
+const { name } = metadata;
+
+export { metadata, name };
+
+export const settings = {
+	icon,
+	example: {
+		attributes: {
+			latex: 'x = \\frac{-b \\pm \\sqrt{b^2-4ac}}{2a}',
+			mathML: '<semantics><mrow><mi>x</mi><mo>=</mo><mfrac><mrow><mo lspace="0em" rspace="0em">−</mo><mi>b</mi><mo>±</mo><msqrt><mrow><msup><mi>b</mi><mn>2</mn></msup><mo>−</mo><mn>4</mn><mi>a</mi><mi>c</mi></mrow></msqrt></mrow><mrow><mn>2</mn><mi>a</mi></mrow></mfrac></mrow><annotation encoding="application/x-tex">x = \\frac{-b \\pm \\sqrt{b^2-4ac}}{2a}</annotation></semantics>',
+		},
+		viewportWidth: 300,
+	},
+	edit,
+	save,
+};
+
+export const init = () => initBlock( { name, metadata, settings } );

package/src/math/init.js

@@ -0,0 +1,4 @@
+/**
+ * Internal dependencies
+ */
+export { init, metadata, name, settings } from './index';

package/src/math/save.js

@@ -0,0 +1,20 @@
+/**
+ * WordPress dependencies
+ */
+import { useBlockProps } from '@wordpress/block-editor';
+
+export default function save( { attributes } ) {
+	const { latex, mathML } = attributes;
+
+	if ( ! latex ) {
+		return null;
+	}
+
+	return (
+		<math
+			{ ...useBlockProps.save() }
+			display="block"
+			dangerouslySetInnerHTML={ { __html: mathML } }
+		/>
+	);
+}

package/src/navigation/edit/menu-inspector-controls.js

@@ -111,17 +111,18 @@ function AdditionalBlockContent( { block, insertedBlock, setInsertedBlock } ) {
 			} }
 			onChange={ ( updatedValue ) => {
 				// updateAttributes determines the final state and returns metadata
-				const { isEntityLink } = updateAttributes(
-					updatedValue,
-					setInsertedBlockAttributes( insertedBlock?.clientId ),
-					insertedBlock?.attributes
-				);
+				const { isEntityLink, attributes: updatedAttributes } =
+					updateAttributes(
+						updatedValue,
+						setInsertedBlockAttributes( insertedBlock?.clientId ),
+						insertedBlock?.attributes
+					);
 
 				// Handle URL binding based on the final computed state
 				// Only create bindings for entity links (posts, pages, taxonomies)
 				// Never create bindings for custom links (manual URLs)
 				if ( isEntityLink ) {
-					createBinding();
+					createBinding( updatedAttributes );
 				} else {
 					clearBinding();
 				}

package/src/navigation-link/edit.js

@@ -543,7 +543,10 @@ export default function NavigationLinkEdit( {
 							anchor={ popoverAnchor }
 							onRemove={ removeLink }
 							onChange={ ( updatedValue ) => {
-								const { isEntityLink } = updateAttributes(
+								const {
+									isEntityLink,
+									attributes: updatedAttributes,
+								} = updateAttributes(
 									updatedValue,
 									setAttributes,
 									attributes
@@ -553,7 +556,7 @@ export default function NavigationLinkEdit( {
 								// Only create bindings for entity links (posts, pages, taxonomies)
 								// Never create bindings for custom links (manual URLs)
 								if ( isEntityLink ) {
-									createBinding();
+									createBinding( updatedAttributes );
 								} else {
 									clearBinding();
 								}

package/src/navigation-link/editor.scss

@@ -110,7 +110,7 @@
 .link-control-transform__subheading {
 	font-size: 11px;
 	text-transform: uppercase;
-	font-weight: 500;
+	font-weight: $font-weight-medium;
 	color: $gray-900;
 	margin-bottom: 1.5em;
 }