@wordpress/block-editor 12.20.0 → 12.22.0

package/src/components/global-styles/test/typography-utils.js

@@ -52,20 +52,109 @@ describe( 'typography utils', () => {
 					size: '28px',
 					fluid: false,
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected: '28px',
 			},
 
+			{
+				message: 'should return value when fluid config is empty`',
+				preset: {
+					size: '28px',
+				},
+				settings: {
+					typography: {
+						fluid: {},
+					},
+				},
+				expected: '28px',
+			},
+
+			{
+				message:
+					'should return  clamp value with `minViewportWidth` override',
+				preset: {
+					size: '28px',
+				},
+				settings: {
+					typography: {
+						fluid: {
+							minViewportWidth: '500px',
+						},
+					},
+				},
+				expected:
+					'clamp(17.905px, 1.119rem + ((1vw - 5px) * 0.918), 28px)',
+			},
+
+			{
+				message:
+					'should return  clamp value with `maxViewportWidth` override',
+				preset: {
+					size: '28px',
+				},
+				settings: {
+					typography: {
+						fluid: {
+							maxViewportWidth: '500px',
+						},
+					},
+				},
+				expected:
+					'clamp(17.905px, 1.119rem + ((1vw - 3.2px) * 5.608), 28px)',
+			},
+
+			{
+				message:
+					'should return clamp value with `layout.wideSize` override',
+				preset: {
+					size: '28px',
+				},
+				settings: {
+					typography: {
+						fluid: true,
+					},
+					layout: {
+						wideSize: '500px',
+					},
+				},
+				expected:
+					'clamp(17.905px, 1.119rem + ((1vw - 3.2px) * 5.608), 28px)',
+			},
+
+			{
+				message:
+					'should return clamp value with `maxViewportWidth` preferred over fallback `layout.wideSize` value',
+				preset: {
+					size: '28px',
+				},
+				settings: {
+					typography: {
+						fluid: {
+							maxViewportWidth: '1000px',
+						},
+					},
+					layout: {
+						wideSize: '500px',
+					},
+				},
+				expected:
+					'clamp(17.905px, 1.119rem + ((1vw - 3.2px) * 1.485), 28px)',
+			},
+
 			{
 				message: 'should return already clamped value',
 				preset: {
 					size: 'clamp(21px, 1.313rem + ((1vw - 7.68px) * 2.524), 42px)',
 					fluid: false,
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(21px, 1.313rem + ((1vw - 7.68px) * 2.524), 42px)',
@@ -77,8 +166,10 @@ describe( 'typography utils', () => {
 					size: '1000%',
 					fluid: false,
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected: '1000%',
 			},
@@ -88,8 +179,10 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '1.75rem',
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(1.119rem, 1.119rem + ((1vw - 0.2rem) * 0.789), 1.75rem)',
@@ -101,9 +194,11 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '1.75rem',
 				},
-				typographySettings: {
-					fluid: {
-						maxViewportWidth: '1200px',
+				settings: {
+					typography: {
+						fluid: {
+							maxViewportWidth: '1200px',
+						},
 					},
 				},
 				expected:
@@ -116,9 +211,11 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '1.75rem',
 				},
-				typographySettings: {
-					fluid: {
-						minViewportWidth: '800px',
+				settings: {
+					typography: {
+						fluid: {
+							minViewportWidth: '800px',
+						},
 					},
 				},
 				expected:
@@ -130,8 +227,10 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '1.75em',
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(1.119em, 1.119rem + ((1vw - 0.2em) * 0.789), 1.75em)',
@@ -142,8 +241,10 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '70.175px',
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(37.897px, 2.369rem + ((1vw - 3.2px) * 2.522), 70.175px)',
@@ -156,8 +257,10 @@ describe( 'typography utils', () => {
 					size: 33,
 					fluid: true,
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(20.515px, 1.282rem + ((1vw - 3.2px) * 0.975), 33px)',
@@ -169,8 +272,10 @@ describe( 'typography utils', () => {
 					size: 70.175,
 					fluid: true,
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(37.897px, 2.369rem + ((1vw - 3.2px) * 2.522), 70.175px)',
@@ -183,8 +288,10 @@ describe( 'typography utils', () => {
 					size: '28px',
 					fluid: [],
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(17.905px, 1.119rem + ((1vw - 3.2px) * 0.789), 28px)',
@@ -196,8 +303,10 @@ describe( 'typography utils', () => {
 					size: '28px',
 					fluid: null,
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(17.905px, 1.119rem + ((1vw - 3.2px) * 0.789), 28px)',
@@ -213,8 +322,10 @@ describe( 'typography utils', () => {
 						max: '125px',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(70px, 4.375rem + ((1vw - 3.2px) * 4.297), 125px)',
@@ -230,9 +341,11 @@ describe( 'typography utils', () => {
 						max: '125px',
 					},
 				},
-				typographySettings: {
-					fluid: {
-						maxViewportWidth: '1100px',
+				settings: {
+					typography: {
+						fluid: {
+							maxViewportWidth: '1100px',
+						},
 					},
 				},
 				expected:
@@ -248,8 +361,10 @@ describe( 'typography utils', () => {
 						max: '7.8125rem',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(4.375rem, 4.375rem + ((1vw - 0.2rem) * 4.298), 7.8125rem)',
@@ -265,8 +380,10 @@ describe( 'typography utils', () => {
 						max: '32px',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected: 'clamp(5rem, 5rem + ((1vw - 0.2rem) * -3.75), 32px)',
 			},
@@ -280,8 +397,10 @@ describe( 'typography utils', () => {
 						max: '50%',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected: '10em',
 			},
@@ -292,8 +411,10 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '3px',
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected: '3px',
 			},
@@ -304,8 +425,10 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '14px',
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected: '14px',
 			},
@@ -320,8 +443,10 @@ describe( 'typography utils', () => {
 						max: '50rem',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(20px, 1.25rem + ((1vw - 3.2px) * 60.938), 50rem)',
@@ -336,8 +461,10 @@ describe( 'typography utils', () => {
 						min: '2.6rem',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(2.6rem, 2.6rem + ((1vw - 0.2rem) * 0.656), 50px)',
@@ -352,8 +479,10 @@ describe( 'typography utils', () => {
 						max: '80px',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(17.905px, 1.119rem + ((1vw - 3.2px) * 4.851), 80px)',
@@ -369,8 +498,10 @@ describe( 'typography utils', () => {
 						max: '5rem',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(0.5rem, 0.5rem + ((1vw - 0.2rem) * 5.625), 5rem)',
@@ -385,8 +516,10 @@ describe( 'typography utils', () => {
 						min: '12px',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(12px, 0.75rem + ((1vw - 3.2px) * 0.625), 20px)',
@@ -401,13 +534,14 @@ describe( 'typography utils', () => {
 						max: '20rem',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(0.875rem, 0.875rem + ((1vw - 0.2rem) * 23.906), 20rem)',
 			},
-
 			{
 				message:
 					'should return clamp value when min and max font sizes are equal',
@@ -418,8 +552,10 @@ describe( 'typography utils', () => {
 						max: '30px',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected: 'clamp(30px, 1.875rem + ((1vw - 3.2px) * 1), 30px)',
 			},
@@ -430,9 +566,11 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '15px',
 				},
-				typographySettings: {
-					fluid: {
-						minFontSize: '16%',
+				settings: {
+					typography: {
+						fluid: {
+							minFontSize: '16%',
+						},
 					},
 				},
 				expected:
@@ -445,9 +583,11 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '17px',
 				},
-				typographySettings: {
-					fluid: {
-						minFontSize: '16px',
+				settings: {
+					typography: {
+						fluid: {
+							minFontSize: '16px',
+						},
 					},
 				},
 				expected: 'clamp(16px, 1rem + ((1vw - 3.2px) * 0.078), 17px)',
@@ -459,9 +599,11 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '15px',
 				},
-				typographySettings: {
-					fluid: {
-						minFontSize: '16px',
+				settings: {
+					typography: {
+						fluid: {
+							minFontSize: '16px',
+						},
 					},
 				},
 				expected: '15px',
@@ -473,8 +615,10 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '12rem',
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(5.174rem, 5.174rem + ((1vw - 0.2rem) * 8.533), 12rem)',
@@ -486,8 +630,10 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '200px',
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(85.342px, 5.334rem + ((1vw - 3.2px) * 8.958), 200px)',
@@ -502,8 +648,10 @@ describe( 'typography utils', () => {
 						min: '100px',
 					},
 				},
-				typographySettings: {
-					fluid: true,
+				settings: {
+					typography: {
+						fluid: true,
+					},
 				},
 				expected:
 					'clamp(100px, 6.25rem + ((1vw - 3.2px) * 7.813), 200px)',
@@ -514,20 +662,22 @@ describe( 'typography utils', () => {
 				preset: {
 					size: '17px',
 				},
-				typographySettings: {
-					fluid: {
-						minFontSize: '16px',
-						maxViewportWidth: '1200px',
-						minViewportWidth: '640px',
+				settings: {
+					typography: {
+						fluid: {
+							minFontSize: '16px',
+							maxViewportWidth: '1200px',
+							minViewportWidth: '640px',
+						},
 					},
 				},
 				expected: 'clamp(16px, 1rem + ((1vw - 6.4px) * 0.179), 17px)',
 			},
-		].forEach( ( { message, preset, typographySettings, expected } ) => {
+		].forEach( ( { message, preset, settings, expected } ) => {
 			it( `${ message }`, () => {
-				expect(
-					getTypographyFontSizeValue( preset, typographySettings )
-				).toBe( expected );
+				expect( getTypographyFontSizeValue( preset, settings ) ).toBe(
+					expected
+				);
 			} );
 		} );
 	} );
@@ -587,7 +737,7 @@ describe( 'typography utils', () => {
 
 			{
 				message:
-					'should return fluid settings with merged `layout.wideSize`d',
+					'should return fluid settings with merged `layout.wideSize`',
 				settings: {
 					typography: { fluid: { minFontSize: '16px' } },
 					layout: { wideSize: '1000rem' },

package/src/components/global-styles/test/use-global-styles-output.js

@@ -968,6 +968,37 @@ describe( 'global styles renderer', () => {
 				'font-size: 15px',
 			] );
 		} );
+
+		it( 'should correctly resolve referenced values', () => {
+			const stylesWithRef = {
+				typography: {
+					fontSize: {
+						ref: 'styles.elements.h1.typography.fontSize',
+					},
+					letterSpacing: {
+						ref: 'styles.elements.h1.typography.letterSpacing',
+					},
+				},
+			};
+			const tree = {
+				styles: {
+					elements: {
+						h1: {
+							typography: {
+								fontSize: 'var:preset|font-size|xx-large',
+								letterSpacing: '2px',
+							},
+						},
+					},
+				},
+			};
+			expect(
+				getStylesDeclarations( stylesWithRef, '.wp-block', false, tree )
+			).toEqual( [
+				'font-size: var(--wp--preset--font-size--xx-large)',
+				'letter-spacing: 2px',
+			] );
+		} );
 	} );
 
 	describe( 'processCSSNesting', () => {

package/src/components/global-styles/typography-utils.js

@@ -40,15 +40,16 @@ import {
  * Takes into account fluid typography parameters and attempts to return a css formula depending on available, valid values.
  *
  * @param {Preset}                     preset
- * @param {Object}                     typographyOptions
- * @param {boolean|TypographySettings} typographyOptions.fluid Whether fluid typography is enabled, and, optionally, fluid font size options.
+ * @param {Object}                     settings
+ * @param {boolean|TypographySettings} settings.typography.fluid  Whether fluid typography is enabled, and, optionally, fluid font size options.
+ * @param {Object?}                    settings.typography.layout Layout options.
  *
  * @return {string|*} A font-size value or the value of preset.size.
  */
-export function getTypographyFontSizeValue( preset, typographyOptions ) {
+export function getTypographyFontSizeValue( preset, settings ) {
 	const { size: defaultSize } = preset;
 
-	if ( ! isFluidTypographyEnabled( typographyOptions ) ) {
+	if ( ! isFluidTypographyEnabled( settings?.typography ) ) {
 		return defaultSize;
 	}
 	/*
@@ -60,9 +61,11 @@ export function getTypographyFontSizeValue( preset, typographyOptions ) {
 		return defaultSize;
 	}
 
-	const fluidTypographySettings =
-		typeof typographyOptions?.fluid === 'object'
-			? typographyOptions?.fluid
+	let fluidTypographySettings =
+		getFluidTypographyOptionsFromSettings( settings );
+	fluidTypographySettings =
+		typeof fluidTypographySettings?.fluid === 'object'
+			? fluidTypographySettings?.fluid
 			: {};
 
 	const fluidFontSizeValue = getComputedFluidTypographyValue( {