make utils private

tellthemachines · tellthemachines · commit 5c65a629f562 · 2025-12-10T10:24:34.000+11:00
diff --git a/packages/edit-post/src/hooks/use-navigate-to-entity-record.js b/packages/edit-post/src/hooks/use-navigate-to-entity-record.js
@@ -3,7 +3,14 @@
  */
 import { useCallback, useReducer } from '@wordpress/element';
 import { useSelect, useDispatch } from '@wordpress/data';
-import { store as editorStore, useGenerateBlockPath } from '@wordpress/editor';
+import { store as editorStore, privateApis } from '@wordpress/editor';
+
+/**
+ * Internal dependencies
+ */
+import { unlock } from '../lock-unlock';
+
+const { useGenerateBlockPath } = unlock( privateApis );
 
 /**
  * A hook that records the 'entity' history in the post editor as a user
diff --git a/packages/edit-site/src/components/block-editor/use-navigate-to-entity-record.js b/packages/edit-site/src/components/block-editor/use-navigate-to-entity-record.js
@@ -4,14 +4,15 @@
 import { privateApis as routerPrivateApis } from '@wordpress/router';
 import { useCallback } from '@wordpress/element';
 import { addQueryArgs } from '@wordpress/url';
-import { useGenerateBlockPath } from '@wordpress/editor';
+import { privateApis as editorPrivateApis } from '@wordpress/editor';
 
 /**
  * Internal dependencies
  */
 import { unlock } from '../../lock-unlock';
 
 const { useHistory, useLocation } = unlock( routerPrivateApis );
+const { useGenerateBlockPath } = unlock( editorPrivateApis );
 
 /**
  * Hook to handle navigation to entity records and retrieve initial block selection.
diff --git a/packages/editor/README.md b/packages/editor/README.md
@@ -1729,14 +1729,6 @@ _Returns_
 
 -   `Object`: An object containing the following properties: - dirtyEntityRecords: An array of dirty entity records. - isDirty: A boolean indicating if there are any dirty entity records. - setUnselectedEntities: A function to set the unselected entities. - unselectedEntities: An array of unselected entities.
 
-### useGenerateBlockPath
-
-Hook that returns a function to generate a block path for a given block clientId. The path is an array of steps from root to the target block, where each step contains the block name and index within its parent.
-
-_Returns_
-
--   `Function`: Function that takes a clientId and returns the block path or null.
-
 ### usePostScheduleLabel
 
 Custom hook to get the label for post schedule.
@@ -1774,14 +1766,6 @@ _Type_
 
 -   `Object`
 
-### useRestoreBlockFromPath
-
-Hook that returns a function to restore a block selection using a previously generated block path. Walks the path from root to target, matching block name and index at each level.
-
-_Returns_
-
--   `Function`: Function that takes a path and returns the clientId or null.
-
 ### VisualEditorGlobalKeyboardShortcuts
 
 Handles the keyboard shortcuts for the editor.
diff --git a/packages/editor/src/components/editor/index.js b/packages/editor/src/components/editor/index.js
@@ -13,7 +13,7 @@ import { store as blockEditorStore } from '@wordpress/block-editor';
  */
 import { store as editorStore } from '../../store';
 import { TEMPLATE_POST_TYPE } from '../../store/constants';
-import { useRestoreBlockFromPath } from '../../utils';
+import { useRestoreBlockFromPath } from '../../utils/block-selection-path';
 import EditorInterface from '../editor-interface';
 import { ExperimentalEditorProvider } from '../provider';
 import Sidebar from '../sidebar';
diff --git a/packages/editor/src/private-apis.js b/packages/editor/src/private-apis.js
@@ -29,6 +29,10 @@ import GlobalStylesUIWrapper from './components/global-styles';
 import { StyleBookPreview } from './components/style-book';
 import { useGlobalStyles, useStyle } from './components/global-styles/hooks';
 import { GlobalStylesActionMenu } from './components/global-styles/menu';
+import {
+	useGenerateBlockPath,
+	useRestoreBlockFromPath,
+} from './utils/block-selection-path';
 
 const { store: interfaceStore, ...remainingInterfaceApis } = interfaceApis;
 
@@ -56,6 +60,9 @@ lock( privateApis, {
 	StyleBookPreview,
 	useGlobalStyles,
 	useStyle,
+	// Block selection
+	useGenerateBlockPath,
+	useRestoreBlockFromPath,
 	// This is a temporary private API while we're updating the site editor to use EditorProvider.
 	interfaceStore,
 	...remainingInterfaceApis,
diff --git a/packages/editor/src/utils/index.js b/packages/editor/src/utils/index.js
@@ -6,7 +6,3 @@ import mediaUpload from './media-upload';
 export { mediaUpload };
 export { cleanForSlug } from './url.js';
 export { getTemplatePartIcon } from './get-template-part-icon';
-export {
-	useGenerateBlockPath,
-	useRestoreBlockFromPath,
-} from './block-selection-path';
