Promote fetchLinkSuggestions to non-experimental API

packages/block-editor/src/components/link-control/README.md

@@ -28,7 +28,7 @@ When this suggestion is selected it will call the `createSuggestion` prop afford
 
 ### Data sources
 
-By default `LinkControl` utilizes the `__experimentalFetchLinkSuggestions` API from `core/block-editor` in order to retrieve search suggestions for matching post-type entities.
+By default `LinkControl` utilizes the `fetchLinkSuggestions` API from `core/block-editor` in order to retrieve search suggestions for matching post-type entities.
 
 By default this provides no functionality and so you must implement and provide this in your own Editor instance ([example](https://github.com/WordPress/gutenberg/blob/65c752816f46a9334b84f4801d80dea00ed76fba/packages/editor/src/components/provider/use-block-editor-settings.js#L114-L115)).
 
@@ -69,9 +69,7 @@ An array of settings objects associated with a link (for example: a setting to d
 To disable settings, pass in an empty array. for example:
 
 ```jsx
-<LinkControl
-	settings={ [] }
-/>
+<LinkControl settings={ [] } />
 ```
 
 ### onChange
@@ -192,7 +190,8 @@ A `suggestion` should have the following shape:
 	)}
 />
 ```
-### renderControlBottom 
+
+### renderControlBottom
 
 -   Type: `Function`
 -   Required: No
@@ -262,9 +261,9 @@ The same as `value` in LinkControl, refer to an earlier section of this README f
 -   Type: `Function`
 -   Required: No
 
-Custom search handler for suggestions. If specified, it's passed to `URLInput` as `__experimentalFetchLinkSuggestions`, if not, the default handler is used.
+Custom search handler for suggestions. If specified, it's passed to `URLInput` as `fetchLinkSuggestions`, if not, the default handler is used.
 
-Refer to URLInput's README.md for more details about `__experimentalFetchLinkSuggestions` and see the [createSuggestion](#createSuggestion) section of this file to learn more about suggestions.
+Refer to URLInput's README.md for more details about `fetchLinkSuggestions` and see the [createSuggestion](#createSuggestion) section of this file to learn more about suggestions.
 
 ### onChange
 

packages/block-editor/src/components/link-control/index.js

@@ -91,7 +91,7 @@ import { DEFAULT_LINK_SETTINGS } from './constants';
  * @property {boolean=}                   showSuggestions            Whether to present suggestions when typing the URL.
  * @property {boolean=}                   showInitialSuggestions     Whether to present initial suggestions immediately.
  * @property {boolean=}                   withCreateSuggestion       Whether to allow creation of link value from suggestion.
- * @property {Object=}                    suggestionsQuery           Query parameters to pass along to wp.blockEditor.__experimentalFetchLinkSuggestions.
+ * @property {Object=}                    suggestionsQuery           Query parameters to pass along to wp.blockEditor.fetchLinkSuggestions.
  * @property {boolean=}                   noURLSuggestion            Whether to add a fallback suggestion which treats the search query as a URL.
  * @property {string|Function|undefined}  createSuggestionButtonText The text to use in the button that calls createSuggestion.
  * @property {Function}                   renderControlBottom        Optional controls to be rendered at the bottom of the component.

packages/block-editor/src/components/link-control/search-input.js

@@ -133,7 +133,7 @@ const LinkControlSearchInput = forwardRef(
 					__experimentalRenderSuggestions={
 						showSuggestions ? handleRenderSuggestions : null
 					}
-					__experimentalFetchLinkSuggestions={ searchHandler }
+					fetchLinkSuggestions={ searchHandler }
 					__experimentalHandleURLSuggestions={ true }
 					__experimentalShowInitialSuggestions={
 						showInitialSuggestions

packages/block-editor/src/components/link-control/use-search-handler.js

@@ -132,8 +132,7 @@ export default function useSearchHandler(
 
 		return {
 			pageOnFront: getSettings().pageOnFront,
-			fetchSearchSuggestions: getSettings()
-				.__experimentalFetchLinkSuggestions,
+			fetchSearchSuggestions: getSettings().fetchLinkSuggestions,
 		};
 	}, [] );
 

packages/block-editor/src/components/url-input/index.js

@@ -136,7 +136,7 @@ class URLInput extends Component {
 
 	updateSuggestions( value = '' ) {
 		const {
-			__experimentalFetchLinkSuggestions: fetchLinkSuggestions,
+			fetchLinkSuggestions,
 			__experimentalHandleURLSuggestions: handleURLSuggestions,
 		} = this.props;
 
@@ -580,13 +580,12 @@ export default compose(
 	withSelect( ( select, props ) => {
 		// If a link suggestions handler is already provided then
 		// bail.
-		if ( isFunction( props.__experimentalFetchLinkSuggestions ) ) {
+		if ( isFunction( props.fetchLinkSuggestions ) ) {
 			return;
 		}
 		const { getSettings } = select( blockEditorStore );
 		return {
-			__experimentalFetchLinkSuggestions: getSettings()
-				.__experimentalFetchLinkSuggestions,
+			fetchLinkSuggestions: getSettings().fetchLinkSuggestions,
 		};
 	} )
 )( URLInput );

packages/components/src/mobile/link-picker/link-picker-results.native.js

@@ -39,10 +39,11 @@ export default function LinkPickerResults( {
 		const { getSettings } = select( 'core/block-editor' );
 		const fetchLinkSuggestions = async ( { search } ) => {
 			if ( meetsThreshold( search ) ) {
-				return await getSettings().__experimentalFetchLinkSuggestions(
-					search,
-					{ page: nextPage.current, type: 'post', perPage: PER_PAGE }
-				);
+				return await getSettings().fetchLinkSuggestions( search, {
+					page: nextPage.current,
+					type: 'post',
+					perPage: PER_PAGE,
+				} );
 			}
 		};
 		const fetchMore = async ( {

packages/core-data/src/fetch/__experimental-fetch-link-suggestions.js

@@ -65,13 +65,13 @@ import { __ } from '@wordpress/i18n';
  *
  * @example
  * ```js
- * import { __experimentalFetchLinkSuggestions as fetchLinkSuggestions } from '@wordpress/core-data';
+ * import { fetchLinkSuggestions } from '@wordpress/core-data';
  *
  * //...
  *
  * export function initialize( id, settings ) {
  *
- * settings.__experimentalFetchLinkSuggestions = (
+ * settings.fetchLinkSuggestions = (
  *     search,
  *     searchOptions
  * ) => fetchLinkSuggestions( search, searchOptions, settings );

packages/core-data/src/fetch/index.js

@@ -1,2 +1,2 @@
-export { default as __experimentalFetchLinkSuggestions } from './__experimental-fetch-link-suggestions';
+export { default as fetchLinkSuggestions } from './__experimental-fetch-link-suggestions';
 export { default as __experimentalFetchUrlData } from './__experimental-fetch-url-data';

packages/edit-navigation/src/index.js

@@ -10,7 +10,7 @@ import { dispatch, useDispatch } from '@wordpress/data';
 import { render, useMemo } from '@wordpress/element';
 import {
 	__experimentalFetchUrlData,
-	__experimentalFetchLinkSuggestions as fetchLinkSuggestions,
+	fetchLinkSuggestions,
 	store as coreStore,
 } from '@wordpress/core-data';
 import { __ } from '@wordpress/i18n';
@@ -31,7 +31,7 @@ function NavEditor( { settings } ) {
 	const __experimentalSetIsInserterOpened = setIsInserterOpened;
 
 	// Provide link suggestions handler to fetch search results for Link UI.
-	const __experimentalFetchLinkSuggestions = ( search, searchOptions ) => {
+	const _fetchLinkSuggestions = ( search, searchOptions ) => {
 		// Bump the default number of suggestions.
 		// See https://github.com/WordPress/gutenberg/issues/34283.
 		searchOptions.perPage = 10;
@@ -41,15 +41,11 @@ function NavEditor( { settings } ) {
 	const editorSettings = useMemo( () => {
 		return {
 			...settings,
-			__experimentalFetchLinkSuggestions,
+			fetchLinkSuggestions: _fetchLinkSuggestions,
 			__experimentalSetIsInserterOpened,
 			__experimentalFetchRichUrlData: __experimentalFetchUrlData,
 		};
-	}, [
-		settings,
-		__experimentalFetchLinkSuggestions,
-		__experimentalSetIsInserterOpened,
-	] );
+	}, [ settings, _fetchLinkSuggestions, __experimentalSetIsInserterOpened ] );
 
 	return <Layout blockEditorSettings={ editorSettings } />;
 }

packages/edit-site/src/index.js

@@ -9,7 +9,7 @@ import {
 import { dispatch, select } from '@wordpress/data';
 import { render, unmountComponentAtNode } from '@wordpress/element';
 import {
-	__experimentalFetchLinkSuggestions as fetchLinkSuggestions,
+	fetchLinkSuggestions,
 	__experimentalFetchUrlData as fetchUrlData,
 } from '@wordpress/core-data';
 import { store as editorStore } from '@wordpress/editor';
@@ -100,7 +100,7 @@ export function reinitializeEditor( target, settings ) {
  * @param {Object} settings Editor settings.
  */
 export function initializeEditor( id, settings ) {
-	settings.__experimentalFetchLinkSuggestions = ( search, searchOptions ) =>
+	settings.fetchLinkSuggestions = ( search, searchOptions ) =>
 		fetchLinkSuggestions( search, searchOptions, settings );
 	settings.__experimentalFetchRichUrlData = fetchUrlData;
 	settings.__experimentalSpotlightEntityBlocks = [ 'core/template-part' ];

packages/edit-widgets/src/index.js

@@ -14,7 +14,7 @@ import {
 	__experimentalGetCoreBlocks,
 	__experimentalRegisterExperimentalCoreBlocks,
 } from '@wordpress/block-library';
-import { __experimentalFetchLinkSuggestions as fetchLinkSuggestions } from '@wordpress/core-data';
+import { fetchLinkSuggestions } from '@wordpress/core-data';
 import {
 	registerLegacyWidgetBlock,
 	registerLegacyWidgetVariations,
@@ -97,7 +97,7 @@ export function initialize( id, settings ) {
 	registerBlock( widgetArea );
 	registerWidgetGroupBlock();
 
-	settings.__experimentalFetchLinkSuggestions = ( search, searchOptions ) =>
+	settings.fetchLinkSuggestions = ( search, searchOptions ) =>
 		fetchLinkSuggestions( search, searchOptions, settings );
 
 	// As we are unregistering `core/freeform` to avoid the Classic block, we must

packages/editor/src/components/provider/use-block-editor-settings.js

@@ -10,7 +10,7 @@ import { Platform, useMemo } from '@wordpress/element';
 import { useDispatch, useSelect } from '@wordpress/data';
 import {
 	store as coreStore,
-	__experimentalFetchLinkSuggestions as fetchLinkSuggestions,
+	fetchLinkSuggestions,
 	__experimentalFetchUrlData as fetchUrlData,
 } from '@wordpress/core-data';
 import { __ } from '@wordpress/i18n';
@@ -144,7 +144,7 @@ function useBlockEditorSettings( settings, hasTemplate ) {
 			__experimentalReusableBlocks: reusableBlocks,
 			__experimentalBlockPatterns: blockPatterns,
 			__experimentalBlockPatternCategories: blockPatternCategories,
-			__experimentalFetchLinkSuggestions: ( search, searchOptions ) =>
+			fetchLinkSuggestions: ( search, searchOptions ) =>
 				fetchLinkSuggestions( search, searchOptions, settings ),
 			__experimentalFetchRichUrlData: fetchUrlData,
 			__experimentalCanUserUseUnfilteredHTML: canUseUnfilteredHTML,