From d41c32e85a0d11d1d7534687c80fac73da5ea91d Mon Sep 17 00:00:00 2001
From: Marek Hrabe <marekhrabe@me.com>
Date: Mon, 28 Oct 2019 14:53:25 +0100
Subject: [PATCH] Mark Link Creation Interface as Experimental (#18110)

* mark main component as experimental

* mark new URLInput props as experimental

* add experimental onKeyPress

* remove key handlers

* Updates to use alias on experimental props

Addresses https://github.com/WordPress/gutenberg/pull/18110#discussion_r339427180
---
 packages/block-editor/README.md                     |  4 ----
 packages/block-editor/src/components/index.js       |  2 +-
 .../src/components/link-control/input-search.js     |  6 +++---
 .../block-editor/src/components/url-input/index.js  | 13 ++++++++-----
 playground/src/index.js                             |  4 ++--
 5 files changed, 14 insertions(+), 15 deletions(-)

diff --git a/packages/block-editor/README.md b/packages/block-editor/README.md
index db24c0972ef30..432d36a72ac70 100644
--- a/packages/block-editor/README.md
+++ b/packages/block-editor/README.md
@@ -314,10 +314,6 @@ _Related_
 
 -   <https://github.com/WordPress/gutenberg/blob/master/packages/block-editor/src/components/inspector-controls/README.md>
 
-<a name="LinkControl" href="#LinkControl">#</a> **LinkControl**
-
-Undocumented declaration.
-
 <a name="MediaPlaceholder" href="#MediaPlaceholder">#</a> **MediaPlaceholder**
 
 _Related_
diff --git a/packages/block-editor/src/components/index.js b/packages/block-editor/src/components/index.js
index 10f202577fe0a..9b094396d9d8b 100644
--- a/packages/block-editor/src/components/index.js
+++ b/packages/block-editor/src/components/index.js
@@ -26,7 +26,7 @@ export { default as __experimentalGradientPickerPanel } from './gradient-picker/
 export { default as InnerBlocks } from './inner-blocks';
 export { default as InspectorAdvancedControls } from './inspector-advanced-controls';
 export { default as InspectorControls } from './inspector-controls';
-export { default as LinkControl } from './link-control';
+export { default as __experimentalLinkControl } from './link-control';
 export { default as MediaPlaceholder } from './media-placeholder';
 export { default as MediaUpload } from './media-upload';
 export { default as MediaUploadCheck } from './media-upload/check';
diff --git a/packages/block-editor/src/components/link-control/input-search.js b/packages/block-editor/src/components/link-control/input-search.js
index 990f401cc31e4..fcd566139cbda 100644
--- a/packages/block-editor/src/components/link-control/input-search.js
+++ b/packages/block-editor/src/components/link-control/input-search.js
@@ -50,9 +50,9 @@ const LinkControlInputSearch = ( {
 				value={ value }
 				onChange={ selectItemHandler }
 				placeholder={ __( 'Search or type url' ) }
-				renderSuggestions={ renderSuggestions }
-				fetchLinkSuggestions={ fetchSuggestions }
-				handleURLSuggestions={ true }
+				__experimentalRenderSuggestions={ renderSuggestions }
+				__experimentalFetchLinkSuggestions={ fetchSuggestions }
+				__experimentalHandleURLSuggestions={ true }
 			/>
 
 			<IconButton
diff --git a/packages/block-editor/src/components/url-input/index.js b/packages/block-editor/src/components/url-input/index.js
index 7fe3edf23beaa..d937f36563356 100644
--- a/packages/block-editor/src/components/url-input/index.js
+++ b/packages/block-editor/src/components/url-input/index.js
@@ -1,7 +1,7 @@
 /**
  * External dependencies
  */
-import { throttle, isFunction, noop } from 'lodash';
+import { throttle, isFunction } from 'lodash';
 import classnames from 'classnames';
 import scrollIntoView from 'dom-scroll-into-view';
 
@@ -71,7 +71,10 @@ class URLInput extends Component {
 	}
 
 	updateSuggestions( value ) {
-		const { fetchLinkSuggestions, handleURLSuggestions } = this.props;
+		const {
+			__experimentalFetchLinkSuggestions: fetchLinkSuggestions,
+			__experimentalHandleURLSuggestions: handleURLSuggestions,
+		} = this.props;
 		if ( ! fetchLinkSuggestions ) {
 			return;
 		}
@@ -258,7 +261,7 @@ class URLInput extends Component {
 			id,
 			isFullWidth,
 			hasBorder,
-			renderSuggestions,
+			__experimentalRenderSuggestions: renderSuggestions,
 			placeholder = __( 'Paste URL or type to search' ),
 			value = '',
 			autoFocus = true,
@@ -371,12 +374,12 @@ export default compose(
 	withSelect( ( select, props ) => {
 		// If a link suggestions handler is already provided then
 		// bail
-		if ( isFunction( props.fetchLinkSuggestions ) ) {
+		if ( isFunction( props.__experimentalFetchLinkSuggestions ) ) {
 			return;
 		}
 		const { getSettings } = select( 'core/block-editor' );
 		return {
-			fetchLinkSuggestions: getSettings().__experimentalFetchLinkSuggestions,
+			__experimentalFetchLinkSuggestions: getSettings().__experimentalFetchLinkSuggestions,
 		};
 	} )
 )( URLInput );
diff --git a/playground/src/index.js b/playground/src/index.js
index 4969725e75148..819a96827b82e 100644
--- a/playground/src/index.js
+++ b/playground/src/index.js
@@ -17,7 +17,7 @@ import {
 	BlockInspector,
 	WritingFlow,
 	ObserveTyping,
-	LinkControl,
+	__experimentalLinkControl,
 } from '@wordpress/block-editor';
 import {
 	Button,
@@ -131,7 +131,7 @@ function App() {
 								<WritingFlow>
 									<ObserveTyping>
 										{ isVisible &&
-											<LinkControl
+											<__experimentalLinkControl
 												currentLink={ link }
 												currentSettings={ linkSettings }
 												onLinkChange={ ( theLink ) => {