fix(support): deprecate answers & places (#6057)

Author: Haroenv

packages/instantsearch.js/src/connectors/answers/connectAnswers.ts

@@ -105,6 +105,9 @@ export type AnswersConnector = Connector<
   AnswersConnectorParams
 >;
 
+/**
+ * @deprecated the answers service is no longer offered, and this widget will be removed in InstantSearch.js v5
+ */
 const connectAnswers: AnswersConnector = function connectAnswers(
   renderFn,
   unmountFn = noop

packages/instantsearch.js/src/widgets/answers/answers.tsx

@@ -9,6 +9,7 @@ import { component } from '../../lib/suit';
 import { prepareTemplateProps } from '../../lib/templating';
 import {
   createDocumentationMessageGenerator,
+  deprecate,
   getContainerNode,
 } from '../../lib/utils';
 
@@ -139,6 +140,9 @@ export type AnswersWidget = WidgetFactory<
   AnswersWidgetParams
 >;
 
+/**
+ * @deprecated the answers service is no longer offered, and this widget will be removed in InstantSearch.js v5
+ */
 const answersWidget: AnswersWidget = (widgetParams) => {
   const {
     container,
@@ -192,4 +196,7 @@ const answersWidget: AnswersWidget = (widgetParams) => {
   };
 };
 
-export default answersWidget;
+export default deprecate(
+  answersWidget,
+  'The answers widget is deprecated and will be removed in InstantSearch.js 5.0'
+);

packages/instantsearch.js/src/widgets/places/places.ts

@@ -1,3 +1,5 @@
+import { deprecate } from '../../lib/utils';
+
 import type { WidgetFactory, WidgetRenderState } from '../../types';
 /* Places.js is an optional dependency, no error should be reported if the package is missing */
 /** @ts-ignore */
@@ -54,6 +56,7 @@ export type PlacesWidget = WidgetFactory<
 /**
  * This widget sets the geolocation value for the search based on the selected
  * result in the Algolia Places autocomplete.
+ * @deprecated the places service is no longer offered, and this widget will be removed in InstantSearch.js v5
  */
 const placesWidget: PlacesWidget = (widgetParams) => {
   const {
@@ -172,4 +175,7 @@ const placesWidget: PlacesWidget = (widgetParams) => {
   };
 };
 
-export default placesWidget;
+export default deprecate(
+  placesWidget,
+  'The places widget is deprecated and will be removed in InstantSearch.js 5.0.'
+);