@wordpress/block-editor 11.3.6 → 11.5.0

package/src/hooks/font-appearance.js

@@ -1,146 +0,0 @@
-/**
- * WordPress dependencies
- */
-import { hasBlockSupport } from '@wordpress/blocks';
-
-/**
- * Internal dependencies
- */
-import FontAppearanceControl from '../components/font-appearance-control';
-import useSetting from '../components/use-setting';
-import { cleanEmptyObject } from './utils';
-
-/**
- * Key within block settings' support array indicating support for font style.
- */
-export const FONT_STYLE_SUPPORT_KEY = 'typography.__experimentalFontStyle';
-
-/**
- * Key within block settings' support array indicating support for font weight.
- */
-export const FONT_WEIGHT_SUPPORT_KEY = 'typography.__experimentalFontWeight';
-
-/**
- * Inspector control panel containing the font appearance options.
- *
- * @param {Object} props Block properties.
- *
- * @return {WPElement} Font appearance edit element.
- */
-export function FontAppearanceEdit( props ) {
-	const {
-		attributes: { style },
-		setAttributes,
-	} = props;
-
-	const hasFontStyles = ! useIsFontStyleDisabled( props );
-	const hasFontWeights = ! useIsFontWeightDisabled( props );
-
-	const onChange = ( newStyles ) => {
-		setAttributes( {
-			style: cleanEmptyObject( {
-				...style,
-				typography: {
-					...style?.typography,
-					fontStyle: newStyles.fontStyle,
-					fontWeight: newStyles.fontWeight,
-				},
-			} ),
-		} );
-	};
-
-	const fontStyle = style?.typography?.fontStyle;
-	const fontWeight = style?.typography?.fontWeight;
-
-	return (
-		<FontAppearanceControl
-			onChange={ onChange }
-			hasFontStyles={ hasFontStyles }
-			hasFontWeights={ hasFontWeights }
-			value={ { fontStyle, fontWeight } }
-			size="__unstable-large"
-		/>
-	);
-}
-
-/**
- * Checks if font style support has been disabled either by not opting in for
- * support or by failing to provide preset styles.
- *
- * @param {Object} props      Block properties.
- * @param {string} props.name Name for the block type.
- *
- * @return {boolean} Whether font style support has been disabled.
- */
-export function useIsFontStyleDisabled( { name: blockName } = {} ) {
-	const styleSupport = hasBlockSupport( blockName, FONT_STYLE_SUPPORT_KEY );
-	const hasFontStyles = useSetting( 'typography.fontStyle' );
-
-	return ! styleSupport || ! hasFontStyles;
-}
-
-/**
- * Checks if font weight support has been disabled either by not opting in for
- * support or by failing to provide preset weights.
- *
- * @param {Object} props      Block properties.
- * @param {string} props.name Name for the block type.
- *
- * @return {boolean} Whether font weight support has been disabled.
- */
-export function useIsFontWeightDisabled( { name: blockName } = {} ) {
-	const weightSupport = hasBlockSupport( blockName, FONT_WEIGHT_SUPPORT_KEY );
-	const hasFontWeights = useSetting( 'typography.fontWeight' );
-
-	return ! weightSupport || ! hasFontWeights;
-}
-
-/**
- * Checks if font appearance support has been disabled.
- *
- * @param {Object} props Block properties.
- *
- * @return {boolean} Whether font appearance support has been disabled.
- */
-export function useIsFontAppearanceDisabled( props ) {
-	const stylesDisabled = useIsFontStyleDisabled( props );
-	const weightsDisabled = useIsFontWeightDisabled( props );
-
-	return stylesDisabled && weightsDisabled;
-}
-
-/**
- * Checks if there is either a font style or weight value set within the
- * typography styles.
- *
- * @param {Object} props Block props.
- * @return {boolean}     Whether or not the block has a font style or weight.
- */
-export function hasFontAppearanceValue( props ) {
-	const { fontStyle, fontWeight } = props.attributes.style?.typography || {};
-	return !! fontStyle || !! fontWeight;
-}
-
-/**
- * Resets the font style and weight block support attributes. This can be used
- * when disabling the font appearance support controls for a block via a
- * progressive discovery panel.
- *
- * @param {Object} props               Block props.
- * @param {Object} props.attributes    Block's attributes.
- * @param {Object} props.setAttributes Function to set block's attributes.
- */
-export function resetFontAppearance( { attributes = {}, setAttributes } ) {
-	const { style } = attributes;
-
-	setAttributes( {
-		style: cleanEmptyObject( {
-			...style,
-			typography: {
-				...style?.typography,
-				fontStyle: undefined,
-				fontWeight: undefined,
-			},
-		} ),
-	} );
-}

package/src/hooks/letter-spacing.js

@@ -1,101 +0,0 @@
-/**
- * WordPress dependencies
- */
-import { hasBlockSupport } from '@wordpress/blocks';
-
-/**
- * Internal dependencies
- */
-import LetterSpacingControl from '../components/letter-spacing-control';
-import useSetting from '../components/use-setting';
-import { cleanEmptyObject } from './utils';
-
-/**
- * Key within block settings' supports array indicating support for letter-spacing
- * e.g. settings found in `block.json`.
- */
-export const LETTER_SPACING_SUPPORT_KEY =
-	'typography.__experimentalLetterSpacing';
-
-/**
- * Inspector control panel containing the letter-spacing options.
- *
- * @param {Object} props Block properties.
- * @return {WPElement}    Letter-spacing edit element.
- */
-export function LetterSpacingEdit( props ) {
-	const {
-		attributes: { style },
-		setAttributes,
-	} = props;
-
-	function onChange( newSpacing ) {
-		setAttributes( {
-			style: cleanEmptyObject( {
-				...style,
-				typography: {
-					...style?.typography,
-					letterSpacing: newSpacing,
-				},
-			} ),
-		} );
-	}
-
-	return (
-		<LetterSpacingControl
-			value={ style?.typography?.letterSpacing }
-			onChange={ onChange }
-			__unstableInputWidth={ '100%' }
-			size="__unstable-large"
-		/>
-	);
-}
-
-/**
- * Checks if letter-spacing settings have been disabled.
- *
- * @param {string} name Name of the block.
- * @return {boolean}     Whether or not the setting is disabled.
- */
-export function useIsLetterSpacingDisabled( { name: blockName } = {} ) {
-	const notSupported = ! hasBlockSupport(
-		blockName,
-		LETTER_SPACING_SUPPORT_KEY
-	);
-	const hasLetterSpacing = useSetting( 'typography.letterSpacing' );
-
-	return notSupported || ! hasLetterSpacing;
-}
-
-/**
- * Checks if there is a current value set for the letter spacing block support.
- *
- * @param {Object} props Block props.
- * @return {boolean}     Whether or not the block has a letter spacing set.
- */
-export function hasLetterSpacingValue( props ) {
-	return !! props.attributes.style?.typography?.letterSpacing;
-}
-
-/**
- * Resets the letter spacing block support attribute. This can be used when
- * disabling the letter spacing support controls for a block via a progressive
- * discovery panel.
- *
- * @param {Object} props               Block props.
- * @param {Object} props.attributes    Block's attributes.
- * @param {Object} props.setAttributes Function to set block's attributes.
- */
-export function resetLetterSpacing( { attributes = {}, setAttributes } ) {
-	const { style } = attributes;
-
-	setAttributes( {
-		style: cleanEmptyObject( {
-			...style,
-			typography: {
-				...style?.typography,
-				letterSpacing: undefined,
-			},
-		} ),
-	} );
-}

package/src/hooks/min-height.js

@@ -1,104 +0,0 @@
-/**
- * WordPress dependencies
- */
-import { getBlockSupport } from '@wordpress/blocks';
-import { __ } from '@wordpress/i18n';
-
-/**
- * Internal dependencies
- */
-import useSetting from '../components/use-setting';
-import HeightControl from '../components/height-control';
-import { DIMENSIONS_SUPPORT_KEY } from './dimensions';
-import { cleanEmptyObject } from './utils';
-
-/**
- * Determines if there is minHeight support.
- *
- * @param {string|Object} blockType Block name or Block Type object.
- * @return {boolean} Whether there is support.
- */
-export function hasMinHeightSupport( blockType ) {
-	const support = getBlockSupport( blockType, DIMENSIONS_SUPPORT_KEY );
-	return !! ( true === support || support?.minHeight );
-}
-
-/**
- * Checks if there is a current value in the minHeight block support attributes.
- *
- * @param {Object} props Block props.
- * @return {boolean} Whether or not the block has a minHeight value set.
- */
-export function hasMinHeightValue( props ) {
-	return props.attributes.style?.dimensions?.minHeight !== undefined;
-}
-
-/**
- * Resets the minHeight block support attributes. This can be used when disabling
- * the padding support controls for a block via a `ToolsPanel`.
- *
- * @param {Object} props               Block props.
- * @param {Object} props.attributes    Block's attributes.
- * @param {Object} props.setAttributes Function to set block's attributes.
- */
-export function resetMinHeight( { attributes = {}, setAttributes } ) {
-	const { style } = attributes;
-
-	setAttributes( {
-		style: cleanEmptyObject( {
-			...style,
-			dimensions: {
-				...style?.dimensions,
-				minHeight: undefined,
-			},
-		} ),
-	} );
-}
-
-/**
- * Custom hook that checks if minHeight controls have been disabled.
- *
- * @param {string} name The name of the block.
- * @return {boolean} Whether minHeight control is disabled.
- */
-export function useIsMinHeightDisabled( { name: blockName } = {} ) {
-	const isDisabled = ! useSetting( 'dimensions.minHeight' );
-	return ! hasMinHeightSupport( blockName ) || isDisabled;
-}
-
-/**
- * Inspector control panel containing the minHeight related configuration.
- *
- * @param {Object} props Block props.
- * @return {WPElement} Edit component for height.
- */
-export function MinHeightEdit( props ) {
-	const {
-		attributes: { style },
-		setAttributes,
-	} = props;
-
-	if ( useIsMinHeightDisabled( props ) ) {
-		return null;
-	}
-
-	const onChange = ( next ) => {
-		const newStyle = {
-			...style,
-			dimensions: {
-				...style?.dimensions,
-				minHeight: next,
-			},
-		};
-
-		setAttributes( { style: cleanEmptyObject( newStyle ) } );
-	};
-
-	return (
-		<HeightControl
-			label={ __( 'Min. height' ) }
-			value={ style?.dimensions?.minHeight }
-			onChange={ onChange }
-		/>
-	);
-}

package/src/hooks/text-decoration.js

@@ -1,102 +0,0 @@
-/**
- * WordPress dependencies
- */
-import { hasBlockSupport } from '@wordpress/blocks';
-
-/**
- * Internal dependencies
- */
-import TextDecorationControl from '../components/text-decoration-control';
-import useSetting from '../components/use-setting';
-import { cleanEmptyObject } from './utils';
-
-/**
- * Key within block settings' supports array indicating support for text
- * decorations e.g. settings found in `block.json`.
- */
-export const TEXT_DECORATION_SUPPORT_KEY =
-	'typography.__experimentalTextDecoration';
-
-/**
- * Inspector control panel containing the text decoration options.
- *
- * @param {Object} props Block properties.
- *
- * @return {WPElement} Text decoration edit element.
- */
-export function TextDecorationEdit( props ) {
-	const {
-		attributes: { style },
-		setAttributes,
-	} = props;
-
-	function onChange( newDecoration ) {
-		setAttributes( {
-			style: cleanEmptyObject( {
-				...style,
-				typography: {
-					...style?.typography,
-					textDecoration: newDecoration,
-				},
-			} ),
-		} );
-	}
-
-	return (
-		<TextDecorationControl
-			value={ style?.typography?.textDecoration }
-			onChange={ onChange }
-			size="__unstable-large"
-		/>
-	);
-}
-
-/**
- * Checks if text-decoration settings have been disabled.
- *
- * @param {string} name Name of the block.
- *
- * @return {boolean} Whether or not the setting is disabled.
- */
-export function useIsTextDecorationDisabled( { name: blockName } = {} ) {
-	const notSupported = ! hasBlockSupport(
-		blockName,
-		TEXT_DECORATION_SUPPORT_KEY
-	);
-	const hasTextDecoration = useSetting( 'typography.textDecoration' );
-
-	return notSupported || ! hasTextDecoration;
-}
-
-/**
- * Checks if there is a current value set for the text decoration block support.
- *
- * @param {Object} props Block props.
- * @return {boolean}     Whether or not the block has a text decoration set.
- */
-export function hasTextDecorationValue( props ) {
-	return !! props.attributes.style?.typography?.textDecoration;
-}
-
-/**
- * Resets the text decoration block support attribute. This can be used when
- * disabling the text decoration support controls for a block via a progressive
- * discovery panel.
- *
- * @param {Object} props               Block props.
- * @param {Object} props.attributes    Block's attributes.
- * @param {Object} props.setAttributes Function to set block's attributes.
- */
-export function resetTextDecoration( { attributes = {}, setAttributes } ) {
-	const { style } = attributes;
-
-	setAttributes( {
-		style: cleanEmptyObject( {
-			...style,
-			typography: {
-				...style?.typography,
-				textDecoration: undefined,
-			},
-		} ),
-	} );
-}

package/src/hooks/text-transform.js

@@ -1,101 +0,0 @@
-/**
- * WordPress dependencies
- */
-import { hasBlockSupport } from '@wordpress/blocks';
-
-/**
- * Internal dependencies
- */
-import TextTransformControl from '../components/text-transform-control';
-import useSetting from '../components/use-setting';
-import { cleanEmptyObject } from './utils';
-
-/**
- * Key within block settings' supports array indicating support for text
- * transforms e.g. settings found in `block.json`.
- */
-export const TEXT_TRANSFORM_SUPPORT_KEY =
-	'typography.__experimentalTextTransform';
-
-/**
- * Inspector control panel containing the text transform options.
- *
- * @param {Object} props Block properties.
- *
- * @return {WPElement} Text transform edit element.
- */
-export function TextTransformEdit( props ) {
-	const {
-		attributes: { style },
-		setAttributes,
-	} = props;
-
-	function onChange( newTransform ) {
-		setAttributes( {
-			style: cleanEmptyObject( {
-				...style,
-				typography: {
-					...style?.typography,
-					textTransform: newTransform,
-				},
-			} ),
-		} );
-	}
-
-	return (
-		<TextTransformControl
-			value={ style?.typography?.textTransform }
-			onChange={ onChange }
-			size="__unstable-large"
-		/>
-	);
-}
-
-/**
- * Checks if text-transform settings have been disabled.
- *
- * @param {string} name Name of the block.
- *
- * @return {boolean} Whether or not the setting is disabled.
- */
-export function useIsTextTransformDisabled( { name: blockName } = {} ) {
-	const notSupported = ! hasBlockSupport(
-		blockName,
-		TEXT_TRANSFORM_SUPPORT_KEY
-	);
-	const hasTextTransforms = useSetting( 'typography.textTransform' );
-	return notSupported || ! hasTextTransforms;
-}
-
-/**
- * Checks if there is a current value set for the text transform block support.
- *
- * @param {Object} props Block props.
- * @return {boolean}     Whether or not the block has a text transform set.
- */
-export function hasTextTransformValue( props ) {
-	return !! props.attributes.style?.typography?.textTransform;
-}
-
-/**
- * Resets the text transform block support attribute. This can be used when
- * disabling the text transform support controls for a block via a progressive
- * discovery panel.
- *
- * @param {Object} props               Block props.
- * @param {Object} props.attributes    Block's attributes.
- * @param {Object} props.setAttributes Function to set block's attributes.
- */
-export function resetTextTransform( { attributes = {}, setAttributes } ) {
-	const { style } = attributes;
-
-	setAttributes( {
-		style: cleanEmptyObject( {
-			...style,
-			typography: {
-				...style?.typography,
-				textTransform: undefined,
-			},
-		} ),
-	} );
-}