Add more tests coverage

getdave · getdave · commit 79d5a644c64a · 2025-12-12T09:28:10.000Z
diff --git a/packages/block-library/src/navigation/edit/overlay-template-part-selector.js b/packages/block-library/src/navigation/edit/overlay-template-part-selector.js
@@ -143,6 +143,10 @@ export default function OverlayTemplatePartSelector( {
 				} );
 			}
 		} catch ( error ) {
+			// Error handling pattern matches CreateTemplatePartModalContents.
+			// See: packages/fields/src/components/create-template-part-modal/index.tsx
+			// The 'unknown_error' code check ensures generic error codes don't show
+			// potentially confusing technical messages, instead showing a user-friendly fallback.
 			const errorMessage =
 				error instanceof Error &&
 				'code' in error &&
diff --git a/packages/block-library/src/navigation/edit/test/utils.js b/packages/block-library/src/navigation/edit/test/utils.js
@@ -0,0 +1,75 @@
+/**
+ * Internal dependencies
+ */
+import { getUniqueTemplatePartTitle, getCleanTemplatePartSlug } from '../utils';
+
+describe( 'getUniqueTemplatePartTitle', () => {
+	it( 'should return the title if it is unique', () => {
+		const title = 'My Template Part';
+		const templateParts = [
+			{
+				title: {
+					rendered: 'Template Part With Another Title',
+				},
+			},
+		];
+
+		expect( getUniqueTemplatePartTitle( title, templateParts ) ).toBe(
+			title
+		);
+	} );
+
+	it( 'should return the title with a suffix if it is not unique', () => {
+		const title = 'My Template Part';
+		const templateParts = [
+			{
+				title: {
+					rendered: 'My Template Part',
+				},
+			},
+		];
+
+		expect( getUniqueTemplatePartTitle( title, templateParts ) ).toBe(
+			'My Template Part 2'
+		);
+	} );
+
+	it( 'should return the title with correct suffix when multiple titles exist', () => {
+		const title = 'My Template Part';
+		const templateParts = [
+			{
+				title: {
+					rendered: 'My Template Part',
+				},
+			},
+			{
+				title: {
+					rendered: 'My Template Part 2',
+				},
+			},
+		];
+
+		expect( getUniqueTemplatePartTitle( title, templateParts ) ).toBe(
+			'My Template Part 3'
+		);
+	} );
+} );
+
+describe( 'getCleanTemplatePartSlug', () => {
+	it( 'should return a slug with only latin chars', () => {
+		const title = 'Myɶ Template Partɮ';
+		expect( getCleanTemplatePartSlug( title ) ).toBe( 'my-template-part' );
+	} );
+
+	it( 'should return a slug with only latin chars and numbers', () => {
+		const title = 'My Template Part 2';
+		expect( getCleanTemplatePartSlug( title ) ).toBe(
+			'my-template-part-2'
+		);
+	} );
+
+	it( 'should default the slug to wp-custom-part', () => {
+		const title = '';
+		expect( getCleanTemplatePartSlug( title ) ).toBe( 'wp-custom-part' );
+	} );
+} );
diff --git a/packages/block-library/src/navigation/edit/use-create-overlay.js b/packages/block-library/src/navigation/edit/use-create-overlay.js
@@ -15,7 +15,8 @@ import { getUniqueTemplatePartTitle, getCleanTemplatePartSlug } from './utils';
  * Hook to create a new overlay template part.
  *
  * @param {Array} overlayTemplateParts Array of existing overlay template parts.
- * @return {Function} Function to create a new overlay template part.
+ * @return {function(): Promise<Object>} Function to create a new overlay template part.
+ *                                      The function returns a Promise that resolves to the created template part object.
  */
 export default function useCreateOverlayTemplatePart( overlayTemplateParts ) {
 	const { saveEntityRecord } = useDispatch( coreStore );
