From 145dc0e3106e55d31c72fb01cecc9cf768c65193 Mon Sep 17 00:00:00 2001
From: Mitchell Austin <mr.fye@oneandthesame.net>
Date: Thu, 5 Oct 2023 09:47:23 -0700
Subject: [PATCH] Comment and rename per feedback

---
 packages/components/src/modal/index.tsx | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/packages/components/src/modal/index.tsx b/packages/components/src/modal/index.tsx
index 4b99136c64b56..041c592166ab7 100644
--- a/packages/components/src/modal/index.tsx
+++ b/packages/components/src/modal/index.tsx
@@ -46,7 +46,7 @@ import type { ModalProps } from './types';
 const level0Dismissers: MutableRefObject<
 	ModalProps[ 'onRequestClose' ] | undefined
 >[] = [];
-const context = createContext( level0Dismissers );
+const ModalContext = createContext( level0Dismissers );
 
 let isBodyOpenClassActive = false;
 
@@ -142,8 +142,10 @@ function UnforwardedModal(
 		refOnRequestClose.current = onRequestClose;
 	}, [ onRequestClose ] );
 
-	const dismissers = useContext( context );
-	const isLevel0 = dismissers === level0Dismissers;
+	// The list of `onRequestClose` callbacks of open (non-nested) Modals. Only
+	// one should remain open at a time and the list enables closing prior ones.
+	const dismissers = useContext( ModalContext );
+	// Used for the tracking and dismissing any nested modals.
 	const nestedDismissers = useRef< typeof level0Dismissers >( [] );
 
 	// Updates the stack tracking open modals at this level and calls
@@ -160,6 +162,7 @@ function UnforwardedModal(
 		};
 	}, [ dismissers ] );
 
+	const isLevel0 = dismissers === level0Dismissers;
 	// Adds/removes the value of bodyOpenClassName to body element.
 	useEffect( () => {
 		if ( ! isBodyOpenClassActive ) {
@@ -351,9 +354,9 @@ function UnforwardedModal(
 	);
 
 	return createPortal(
-		<context.Provider value={ nestedDismissers.current }>
+		<ModalContext.Provider value={ nestedDismissers.current }>
 			{ modal }
-		</context.Provider>,
+		</ModalContext.Provider>,
 		document.body
 	);
 }