Use unstable

WordPress · getdave · Aug 8, 2025 · Aug 5, 2025 · Aug 5, 2025 · Aug 6, 2025
commit d3cd4ec9c9dc38dc1874ed79660eab90746fa601
diff --git a/packages/block-editor/src/components/rich-text/with-write-mode-filter.js b/packages/block-editor/src/components/rich-text/with-write-mode-filter.js
@@ -14,12 +14,12 @@ import { useBlockEditingMode } from '../block-editing-mode';
  * Higher-Order Component that filters format edit components based on write mode.
  *
  * @param {Function} WrappedComponent The format edit component to wrap
- * @param {Object}   formatSettings   The format settings including essential flag
+ * @param {Object}   formatSettings   The format settings including __unstableEssential flag
  * @return {Function} The wrapped component
  */
 const withWriteModeFilter = ( WrappedComponent, formatSettings ) => {
-	// Early return if format is essential - no filtering needed
-	if ( formatSettings?.essential ) {
+	// Early return if format is __unstableEssential - no filtering needed
+	if ( formatSettings?.__unstableEssential ) {
 		return WrappedComponent;
 	}
 

@@ -18,7 +18,7 @@ export const bold = {
 	title,
 	tagName: 'strong',
 	className: null,
-	essential: true,
+	__unstableEssential: true,
 	edit( { isActive, value, onChange, onFocus } ) {
 		function onToggle() {
 			onChange( toggleFormat( value, { type: name, title } ) );

diff --git a/packages/format-library/src/code/index.js b/packages/format-library/src/code/index.js
@@ -17,7 +17,7 @@ export const code = {
 	title,
 	tagName: 'code',
 	className: null,
-	essential: false,
+
 	__unstableInputRule( value ) {
 		const BACKTICK = '`';
 		const { start, text } = value;

diff --git a/packages/format-library/src/image/index.js b/packages/format-library/src/image/index.js
@@ -56,6 +56,7 @@ export const image = {
 		url: 'src',
 		alt: 'alt',
 	},
+
 	edit: Edit,
 };
 

@@ -18,7 +18,7 @@ export const italic = {
 	title,
 	tagName: 'em',
 	className: null,
-	essential: true,
+	__unstableEssential: true,
 	edit( { isActive, value, onChange, onFocus } ) {
 		function onToggle() {
 			onChange( toggleFormat( value, { type: name, title } ) );

diff --git a/packages/format-library/src/language/index.js b/packages/format-library/src/language/index.js
@@ -26,6 +26,7 @@ export const language = {
 	name,
 	tagName: 'bdo',
 	className: null,
+
 	edit: Edit,
 	title,
 };

@@ -228,7 +228,7 @@ export const link = {
 		target: 'target',
 		rel: 'rel',
 	},
-	essential: true,
+	__unstableEssential: true,
 	__unstablePasteRule( value, { html, plainText } ) {
 		const pastedText = ( html || plainText )
 			.replace( /<[^>]+>/g, '' )

diff --git a/packages/format-library/src/non-breaking-space/index.js b/packages/format-library/src/non-breaking-space/index.js
@@ -13,6 +13,7 @@ export const nonBreakingSpace = {
 	title,
 	tagName: 'nbsp',
 	className: null,
+
 	edit( { value, onChange } ) {
 		function addNonBreakingSpace() {
 			onChange( insert( value, '\u00a0' ) );

diff --git a/packages/format-library/src/strikethrough/index.js b/packages/format-library/src/strikethrough/index.js
@@ -17,7 +17,7 @@ export const strikethrough = {
 	title,
 	tagName: 's',
 	className: null,
-	essential: false,
+
 	edit( { isActive, value, onChange, onFocus } ) {
 		function onClick() {
 			onChange( toggleFormat( value, { type: name, title } ) );

diff --git a/packages/format-library/src/subscript/index.js b/packages/format-library/src/subscript/index.js
@@ -14,6 +14,7 @@ export const subscript = {
 	title,
 	tagName: 'sub',
 	className: null,
+
 	edit( { isActive, value, onChange, onFocus } ) {
 		function onToggle() {
 			onChange( toggleFormat( value, { type: name, title } ) );

diff --git a/packages/format-library/src/superscript/index.js b/packages/format-library/src/superscript/index.js
@@ -14,6 +14,7 @@ export const superscript = {
 	title,
 	tagName: 'sup',
 	className: null,
+
 	edit( { isActive, value, onChange, onFocus } ) {
 		function onToggle() {
 			onChange( toggleFormat( value, { type: name, title } ) );

diff --git a/packages/format-library/src/text-color/index.js b/packages/format-library/src/text-color/index.js
@@ -128,5 +128,6 @@ export const textColor = {
 		style: 'style',
 		class: 'class',
 	},
+
 	edit: TextColorEdit,
 };
diff --git a/packages/format-library/src/underline/index.js b/packages/format-library/src/underline/index.js
@@ -19,7 +19,7 @@ export const underline = {
 	attributes: {
 		style: 'style',
 	},
-	essential: false,
+
 	edit( { value, onChange } ) {
 		const onToggle = () => {
 			onChange(

diff --git a/packages/format-library/src/unknown/index.js b/packages/format-library/src/unknown/index.js
@@ -25,6 +25,7 @@ export const unknown = {
 	title,
 	tagName: '*',
 	className: null,
+
 	edit( { isActive, value, onChange, onFocus } ) {
 		if ( ! isActive && ! selectionContainsUnknownFormats( value ) ) {
 			return null;
-Original file line number
+Diff line change
@@ Expand Up / @@ -56,6 +56,7 @@ export const image = { @@
     		url: 'src',
     		alt: 'alt',
     	},
     	edit: Edit,
     };
@@ Expand Down @@