Patterns: Add rename/delete options for pattern categories in site editor

packages/core-data/src/resolvers.js

@@ -7,6 +7,7 @@ import { camelCase } from 'change-case';
  * WordPress dependencies
  */
 import { addQueryArgs } from '@wordpress/url';
+import { decodeEntities } from '@wordpress/html-entities';
 import apiFetch from '@wordpress/api-fetch';
 
 /**
@@ -659,7 +660,7 @@ export const getUserPatternCategories =
 		const mappedPatternCategories =
 			patternCategories?.map( ( userCategory ) => ( {
 				...userCategory,
-				label: userCategory.name,
+				label: decodeEntities( userCategory.name ),
 				name: userCategory.slug,
 			} ) ) || [];
 

packages/edit-site/src/components/page-patterns/delete-category-menu-item.js

@@ -0,0 +1,102 @@
+/**
+ * WordPress dependencies
+ */
+import {
+	MenuItem,
+	__experimentalConfirmDialog as ConfirmDialog,
+} from '@wordpress/components';
+import { store as coreStore } from '@wordpress/core-data';
+import { useDispatch } from '@wordpress/data';
+import { useState } from '@wordpress/element';
+import { decodeEntities } from '@wordpress/html-entities';
+import { __, sprintf } from '@wordpress/i18n';
+import { store as noticesStore } from '@wordpress/notices';
+import { privateApis as routerPrivateApis } from '@wordpress/router';
+
+/**
+ * Internal dependencies
+ */
+import { unlock } from '../../lock-unlock';
+import { PATTERN_TYPES, PATTERN_DEFAULT_CATEGORY } from '../../utils/constants';
+
+const { useHistory } = unlock( routerPrivateApis );
+
+export default function DeleteCategoryMenuItem( { category, onClose } ) {
+	const [ isModalOpen, setIsModalOpen ] = useState( false );
+	const history = useHistory();
+
+	const { createSuccessNotice, createErrorNotice } =
+		useDispatch( noticesStore );
+	const { deleteEntityRecord, invalidateResolution } =
+		useDispatch( coreStore );
+
+	if ( ! category?.id ) {
+		return null;
+	}
+
+	const onDelete = async () => {
+		try {
+			await deleteEntityRecord(
+				'taxonomy',
+				'wp_pattern_category',
+				category.id,
+				{ force: true },
+				{ throwOnError: true }
+			);
+
+			// Prevent the need to refresh the page to get up-to-date categories
+			// and pattern categorization.
+			invalidateResolution( 'getUserPatternCategories' );
+			invalidateResolution( 'getEntityRecords', [
+				'postType',
+				PATTERN_TYPES.user,
+				{ per_page: -1 },
+			] );
+
+			createSuccessNotice(
+				sprintf(
+					/* translators: The pattern category's name */
+					__( '"%s" deleted.' ),
+					category.label
+				),
+				{ type: 'snackbar', id: 'pattern-category-delete' }
+			);
+
+			onClose?.();
+			history.push( {
+				path: `/patterns`,
+				categoryType: PATTERN_TYPES.theme,
+				categoryId: PATTERN_DEFAULT_CATEGORY,
+			} );
+		} catch ( error ) {
+			const errorMessage =
+				error.message && error.code !== 'unknown_error'
+					? error.message
+					: __( 'An error occurred while deleting the pattern.' );
+
+			createErrorNotice( errorMessage, {
+				type: 'snackbar',
+				id: 'pattern-category-delete',
+			} );
+		}
+	};
+
+	return (
+		<>
+			<MenuItem isDestructive onClick={ () => setIsModalOpen( true ) }>
+				{ __( 'Delete' ) }
+			</MenuItem>
+			<ConfirmDialog
+				isOpen={ isModalOpen }
+				onConfirm={ onDelete }
+				onCancel={ () => setIsModalOpen( false ) }
+			>
+				{ sprintf(
+					// translators: %s: The pattern category's name.
+					__( 'Are you sure you want to delete "%s"?' ),
+					decodeEntities( category.label )
+				) }
+			</ConfirmDialog>
+		</>
+	);
+}

packages/edit-site/src/components/page-patterns/header.js

@@ -2,16 +2,23 @@
  * WordPress dependencies
  */
 import {
-	__experimentalVStack as VStack,
+	DropdownMenu,
+	MenuGroup,
+	__experimentalHStack as HStack,
 	__experimentalHeading as Heading,
 	__experimentalText as Text,
+	__experimentalVStack as VStack,
 } from '@wordpress/components';
 import { store as editorStore } from '@wordpress/editor';
 import { useSelect } from '@wordpress/data';
+import { __, sprintf } from '@wordpress/i18n';
+import { moreVertical } from '@wordpress/icons';
 
 /**
  * Internal dependencies
  */
+import RenameCategoryMenuItem from './rename-category-menu-item';
+import DeleteCategoryMenuItem from './delete-category-menu-item';
 import usePatternCategories from '../sidebar-navigation-screen-patterns/use-pattern-categories';
 import { TEMPLATE_PART_POST_TYPE, PATTERN_TYPES } from '../../utils/constants';
 
@@ -28,15 +35,15 @@ export default function PatternsHeader( {
 		[]
 	);
 
-	let title, description;
+	let title, description, patternCategory;
 	if ( type === TEMPLATE_PART_POST_TYPE ) {
 		const templatePartArea = templatePartAreas.find(
 			( area ) => area.area === categoryId
 		);
 		title = templatePartArea?.label;
 		description = templatePartArea?.description;
 	} else if ( type === PATTERN_TYPES.theme ) {
-		const patternCategory = patternCategories.find(
+		patternCategory = patternCategories.find(
 			( category ) => category.name === categoryId
 		);
 		title = patternCategory?.label;
@@ -47,9 +54,38 @@ export default function PatternsHeader( {
 
 	return (
 		<VStack className="edit-site-patterns__section-header">
-			<Heading as="h2" level={ 4 } id={ titleId }>
-				{ title }
-			</Heading>
+			<HStack justify="space-between">
+				<Heading as="h2" level={ 4 } id={ titleId }>
+					{ title }
+				</Heading>
+				{ !! patternCategory?.id && (
+					<DropdownMenu
+						icon={ moreVertical }
+						label={ __( 'Actions' ) }
+						toggleProps={ {
+							className: 'edit-site-patterns__button',
+							describedBy: sprintf(
+								/* translators: %s: pattern category name */
+								__( 'Action menu for %s pattern category' ),
+								title
+							),
+						} }
+					>
+						{ ( { onClose } ) => (
+							<MenuGroup>
+								<RenameCategoryMenuItem
+									category={ patternCategory }
+									onClose={ onClose }
+								/>
+								<DeleteCategoryMenuItem
+									category={ patternCategory }
+									onClose={ onClose }
+								/>
+							</MenuGroup>
+						) }
+					</DropdownMenu>
+				) }
+			</HStack>
 			{ description ? (
 				<Text variant="muted" as="p" id={ descriptionId }>
 					{ description }

packages/edit-site/src/components/page-patterns/rename-category-menu-item.js

@@ -0,0 +1,48 @@
+/**
+ * WordPress dependencies
+ */
+import { MenuItem } from '@wordpress/components';
+import { useState } from '@wordpress/element';
+import { __ } from '@wordpress/i18n';
+import { privateApis as patternsPrivateApis } from '@wordpress/patterns';
+
+/**
+ * Internal dependencies
+ */
+import { unlock } from '../../lock-unlock';
+
+const { RenamePatternCategoryModal } = unlock( patternsPrivateApis );
+
+export default function RenameCategoryMenuItem( { category, onClose } ) {
+	const [ isModalOpen, setIsModalOpen ] = useState( false );
+
+	if ( ! category?.id ) {
+		return null;
+	}
+
+	// User created pattern categories have their properties updated when
+	// retrieved via `getUserPatternCategories`. The rename modal expects an
+	// object that will match the pattern category entity.
+	const normalizedCategory = {
+		id: category.id,
+		slug: category.slug,
+		name: category.label,
+	};
+
+	return (
+		<>
+			<MenuItem onClick={ () => setIsModalOpen( true ) }>
+				{ __( 'Rename' ) }
+			</MenuItem>
+			{ isModalOpen && (
+				<RenamePatternCategoryModal
+					category={ normalizedCategory }
+					onClose={ () => {
+						setIsModalOpen( false );
+						onClose();
+					} }
+				/>
+			) }
+		</>
+	);
+}

packages/edit-site/src/components/page-patterns/style.scss

@@ -101,6 +101,10 @@
 	background: $gray-900;
 	padding: $grid-unit-40 $grid-unit-40 $grid-unit-20;
 	z-index: z-index(".edit-site-patterns__header");
+
+	.edit-site-patterns__button {
+		color: $gray-600;
+	}
 }
 
 .edit-site-patterns__section {

packages/patterns/src/components/rename-pattern-category-modal.js

@@ -0,0 +1,122 @@
+/**
+ * WordPress dependencies
+ */
+import {
+	Modal,
+	Button,
+	TextControl,
+	__experimentalHStack as HStack,
+	__experimentalVStack as VStack,
+} from '@wordpress/components';
+import { store as coreStore } from '@wordpress/core-data';
+import { useDispatch } from '@wordpress/data';
+import { useState } from '@wordpress/element';
+import { decodeEntities } from '@wordpress/html-entities';
+import { __ } from '@wordpress/i18n';
+import { store as noticesStore } from '@wordpress/notices';
+
+/**
+ * Internal dependencies
+ */
+import { CATEGORY_SLUG } from './category-selector';
+
+export default function RenamePatternCategoryModal( {
+	category,
+	onClose,
+	onError,
+	onSuccess,
+	...props
+} ) {
+	const [ name, setName ] = useState( decodeEntities( category.name ) );
+	const [ isSaving, setIsSaving ] = useState( false );
+
+	const { saveEntityRecord, invalidateResolution } = useDispatch( coreStore );
+
+	const { createErrorNotice, createSuccessNotice } =
+		useDispatch( noticesStore );
+
+	const onRename = async ( event ) => {
+		event.preventDefault();
+
+		if ( ! name || name === category.name || isSaving ) {
+			return;
+		}
+
+		try {
+			setIsSaving( true );
+			setName( '' );
+			onClose?.();
+
+			// User pattern category properties may differ as they can be
+			// normalized for use alongside template part areas, core pattern
+			// categories etc. As a result we won't just destructure the passed
+			// category object.
+			const savedRecord = await saveEntityRecord(
+				'taxonomy',
+				CATEGORY_SLUG,
+				{
+					id: category.id,
+					slug: category.slug,
+					name,
+				}
+			);
+
+			invalidateResolution( 'getUserPatternCategories' );
+			onSuccess?.( savedRecord );
+
+			createSuccessNotice( __( 'Pattern category renamed.' ), {
+				type: 'snackbar',
+				id: 'pattern-category-update',
+			} );
+		} catch ( error ) {
+			onError?.();
+			createErrorNotice( error.message, {
+				type: 'snackbar',
+				id: 'pattern-category-update',
+			} );
+		} finally {
+			setIsSaving( false );
+			setName( '' );
+		}
+	};
+
+	const onRequestClose = () => {
+		onClose?.();
+		setName( '' );
+	};
+
+	return (
+		<Modal
+			title={ __( 'Rename' ) }
+			onRequestClose={ onRequestClose }
+			{ ...props }
+		>
+			<form onSubmit={ onRename }>
+				<VStack spacing="5">
+					<TextControl
+						__nextHasNoMarginBottom
+						label={ __( 'Name' ) }
+						value={ name }
+						onChange={ setName }
+						required
+					/>
+					<HStack justify="right">
+						<Button variant="tertiary" onClick={ onRequestClose }>
+							{ __( 'Cancel' ) }
+						</Button>
+						<Button
+							variant="primary"
+							type="submit"
+							aria-disabled={
+								! name || name === category.name || isSaving
+							}
+							isBusy={ isSaving }
+						>
+							{ __( 'Save' ) }
+						</Button>
+					</HStack>
+				</VStack>
+			</form>
+		</Modal>
+	);
+}