From b6092cc04cd9d60295222104c042a25dcb452fc6 Mon Sep 17 00:00:00 2001
From: Luigi Teschio <gigitux@gmail.com>
Date: Fri, 10 May 2024 10:36:40 +0200
Subject: [PATCH] create a public and a private version of blockpopover

---
 packages/block-editor/README.md               |  4 +++-
 .../src/components/block-popover/README.md    |  2 +-
 .../src/components/block-popover/index.js     | 24 ++++++++++++++++++-
 packages/block-editor/src/private-apis.js     |  2 ++
 4 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/packages/block-editor/README.md b/packages/block-editor/README.md
index 8159e555618f62..de914a553c0bca 100644
--- a/packages/block-editor/README.md
+++ b/packages/block-editor/README.md
@@ -209,7 +209,9 @@ Undocumented declaration.
 
 ### BlockPopover
 
-Undocumented declaration.
+_Related_
+
+-   <https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/block-popover/README.md>
 
 ### BlockPreview
 
diff --git a/packages/block-editor/src/components/block-popover/README.md b/packages/block-editor/src/components/block-popover/README.md
index c60da7a982ae87..c50e8c90647f69 100644
--- a/packages/block-editor/src/components/block-popover/README.md
+++ b/packages/block-editor/src/components/block-popover/README.md
@@ -30,7 +30,7 @@ This determines whether the block popover always shifts into the viewport or rem
 -	Required: No
 -	Default: `true`
 
-## BlockPopoverInbetween
+## BlockPopoverInbetween - Private Component
 
 ### Props
 
diff --git a/packages/block-editor/src/components/block-popover/index.js b/packages/block-editor/src/components/block-popover/index.js
index 9dd700b1e06e6d..a088178be0a121 100644
--- a/packages/block-editor/src/components/block-popover/index.js
+++ b/packages/block-editor/src/components/block-popover/index.js
@@ -152,4 +152,26 @@ function BlockPopover(
 	);
 }
 
-export default forwardRef( BlockPopover );
+export const PrivateBlockPopover = forwardRef( BlockPopover );
+
+const PublicBlockPopover = ( {
+	clientId,
+	bottomClientId,
+	children,
+	...props
+} ) => (
+	<BlockPopover
+		{ ...props }
+		bottomClientId={ bottomClientId }
+		clientId={ clientId }
+		__unstableContentRef={ undefined }
+		__unstablePopoverSlot={ undefined }
+	>
+		{ children }
+	</BlockPopover>
+);
+
+/**
+ * @see https://github.com/WordPress/gutenberg/blob/HEAD/packages/block-editor/src/components/block-popover/README.md
+ */
+export default forwardRef( PublicBlockPopover );
diff --git a/packages/block-editor/src/private-apis.js b/packages/block-editor/src/private-apis.js
index f10fcc4df2c726..997f5d2644e39d 100644
--- a/packages/block-editor/src/private-apis.js
+++ b/packages/block-editor/src/private-apis.js
@@ -38,6 +38,7 @@ import {
 } from './store/private-keys';
 import { requiresWrapperOnCopy } from './components/writing-flow/utils';
 import { PrivateRichText } from './components/rich-text/';
+import { PrivateBlockPopover } from './components/block-popover';
 
 /**
  * Private @wordpress/block-editor APIs.
@@ -76,4 +77,5 @@ lock( privateApis, {
 	requiresWrapperOnCopy,
 	PrivateRichText,
 	reusableBlocksSelectKey,
+	PrivateBlockPopover,
 } );