instantsearch.js 4.79.2 → 4.80.0

package/cjs/components/Template/Template.js

@@ -66,7 +66,7 @@ var RawHtml = /*#__PURE__*/function (_Component) {
       });
       // if there is one TextNode first and one TextNode last, the
       // last one's nodeValue will be assigned to the first.
-      if (this.nodes[0].nodeValue) {
+      if (this.nodes[0] && this.nodes[0].nodeValue) {
         this.nodes[0].nodeValue = '';
       }
     }

package/cjs/lib/InstantSearch.js

@@ -329,12 +329,9 @@ var InstantSearch = /*#__PURE__*/function (_EventEmitter) {
       if (!Array.isArray(widgets)) {
         throw new Error(withUsage('The `addWidgets` method expects an array of widgets. Please use `addWidget`.'));
       }
-      if (widgets.some(function (widget) {
-        return typeof widget.init !== 'function' && typeof widget.render !== 'function';
+      if (this.compositionID && widgets.some(function (w) {
+        return !Array.isArray(w) && (0, _utils.isIndexWidget)(w) && !w._isolated;
       })) {
-        throw new Error(withUsage('The widget definition expects a `render` and/or an `init` method.'));
-      }
-      if (this.compositionID && widgets.some(_utils.isIndexWidget)) {
         throw new Error(withUsage('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
       }
       this.mainIndex.addWidgets(widgets);
@@ -367,11 +364,6 @@ var InstantSearch = /*#__PURE__*/function (_EventEmitter) {
       if (!Array.isArray(widgets)) {
         throw new Error(withUsage('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
       }
-      if (widgets.some(function (widget) {
-        return typeof widget.dispose !== 'function';
-      })) {
-        throw new Error(withUsage('The widget definition expects a `dispose` method.'));
-      }
       this.mainIndex.removeWidgets(widgets);
       return this;
     }

package/cjs/lib/version.js

@@ -4,4 +4,4 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _default = exports.default = '4.79.2';
+var _default = exports.default = '4.80.0';

package/cjs/widgets/index/index.js

@@ -117,12 +117,18 @@ function resolveScopedResultsFromWidgets(widgets) {
   }, []);
 }
 var index = function index(widgetParams) {
-  if (widgetParams === undefined || widgetParams.indexName === undefined) {
+  if (widgetParams === undefined || widgetParams.indexName === undefined && !widgetParams.EXPERIMENTAL_isolated) {
     throw new Error(withUsage('The `indexName` option is required.'));
   }
-  var indexName = widgetParams.indexName,
+
+  // When isolated=true, we use an empty string as the default indexName.
+  // This is intentional: isolated indices do not require a real index name.
+  var _widgetParams$indexNa = widgetParams.indexName,
+    indexName = _widgetParams$indexNa === void 0 ? '' : _widgetParams$indexNa,
     _widgetParams$indexId = widgetParams.indexId,
-    indexId = _widgetParams$indexId === void 0 ? indexName : _widgetParams$indexId;
+    indexId = _widgetParams$indexId === void 0 ? indexName : _widgetParams$indexId,
+    _widgetParams$EXPERIM = widgetParams.EXPERIMENTAL_isolated,
+    isolated = _widgetParams$EXPERIM === void 0 ? false : _widgetParams$EXPERIM;
   var localWidgets = [];
   var localUiState = {};
   var localInstantSearchInstance = null;
@@ -135,6 +141,7 @@ var index = function index(widgetParams) {
   return {
     $$type: 'ais.index',
     $$widgetType: 'ais.index',
+    _isolated: isolated,
     getIndexName: function getIndexName() {
       return indexName;
     },
@@ -186,7 +193,7 @@ var index = function index(widgetParams) {
       return resolveScopedResultsFromWidgets(widgetSiblings);
     },
     getParent: function getParent() {
-      return localParent;
+      return isolated ? null : localParent;
     },
     createURL: function createURL(nextState) {
       if (typeof nextState === 'function') {
@@ -205,12 +212,15 @@ var index = function index(widgetParams) {
       if (!Array.isArray(widgets)) {
         throw new Error(withUsage('The `addWidgets` method expects an array of widgets.'));
       }
-      if (widgets.some(function (widget) {
+      var flatWidgets = widgets.reduce(function (acc, w) {
+        return acc.concat(Array.isArray(w) ? w : [w]);
+      }, []);
+      if (flatWidgets.some(function (widget) {
         return typeof widget.init !== 'function' && typeof widget.render !== 'function';
       })) {
         throw new Error(withUsage('The widget definition expects a `render` and/or an `init` method.'));
       }
-      widgets.forEach(function (widget) {
+      flatWidgets.forEach(function (widget) {
         if ((0, _utils.isIndexWidget)(widget)) {
           return;
         }
@@ -225,8 +235,8 @@ var index = function index(widgetParams) {
         }
         (0, _addWidgetId.addWidgetId)(widget);
       });
-      localWidgets = localWidgets.concat(widgets);
-      if (localInstantSearchInstance && Boolean(widgets.length)) {
+      localWidgets = localWidgets.concat(flatWidgets);
+      if (localInstantSearchInstance && Boolean(flatWidgets.length)) {
         privateHelperSetState(helper, {
           state: getLocalWidgetsSearchParameters(localWidgets, {
             uiState: localUiState,
@@ -242,7 +252,7 @@ var index = function index(widgetParams) {
         // We compute the render state before calling `init` in a separate loop
         // to construct the whole render state object that is then passed to
         // `init`.
-        widgets.forEach(function (widget) {
+        flatWidgets.forEach(function (widget) {
           if (widget.getRenderState) {
             var renderState = widget.getRenderState(localInstantSearchInstance.renderState[_this.getIndexId()] || {}, (0, _utils.createInitArgs)(localInstantSearchInstance, _this, localInstantSearchInstance._initialUiState));
             storeRenderState({
@@ -252,12 +262,17 @@ var index = function index(widgetParams) {
             });
           }
         });
-        widgets.forEach(function (widget) {
+        flatWidgets.forEach(function (widget) {
           if (widget.init) {
             widget.init((0, _utils.createInitArgs)(localInstantSearchInstance, _this, localInstantSearchInstance._initialUiState));
           }
         });
-        localInstantSearchInstance.scheduleSearch();
+        if (isolated) {
+          var _helper2;
+          (_helper2 = helper) === null || _helper2 === void 0 ? void 0 : _helper2.search();
+        } else {
+          localInstantSearchInstance.scheduleSearch();
+        }
       }
       return this;
     },
@@ -266,13 +281,16 @@ var index = function index(widgetParams) {
       if (!Array.isArray(widgets)) {
         throw new Error(withUsage('The `removeWidgets` method expects an array of widgets.'));
       }
-      if (widgets.some(function (widget) {
+      var flatWidgets = widgets.reduce(function (acc, w) {
+        return acc.concat(Array.isArray(w) ? w : [w]);
+      }, []);
+      if (flatWidgets.some(function (widget) {
         return typeof widget.dispose !== 'function';
       })) {
         throw new Error(withUsage('The widget definition expects a `dispose` method.'));
       }
       localWidgets = localWidgets.filter(function (widget) {
-        return widgets.indexOf(widget) === -1;
+        return flatWidgets.indexOf(widget) === -1;
       });
       localWidgets.forEach(function (widget) {
         if ((0, _utils.isIndexWidget)(widget)) {
@@ -288,8 +306,8 @@ var index = function index(widgetParams) {
           hasSearchWidget = true;
         }
       });
-      if (localInstantSearchInstance && Boolean(widgets.length)) {
-        var _widgets$reduce = widgets.reduce(function (states, widget) {
+      if (localInstantSearchInstance && Boolean(flatWidgets.length)) {
+        var _flatWidgets$reduce = flatWidgets.reduce(function (states, widget) {
             // the `dispose` method exists at this point we already assert it
             var next = widget.dispose({
               helper: helper,
@@ -307,8 +325,8 @@ var index = function index(widgetParams) {
             cleanedSearchState: helper.state,
             cleanedRecommendState: helper.recommendState
           }),
-          cleanedSearchState = _widgets$reduce.cleanedSearchState,
-          cleanedRecommendState = _widgets$reduce.cleanedRecommendState;
+          cleanedSearchState = _flatWidgets$reduce.cleanedSearchState,
+          cleanedRecommendState = _flatWidgets$reduce.cleanedRecommendState;
         var newState = localInstantSearchInstance.future.preserveSharedStateOnUnmount ? getLocalWidgetsSearchParameters(localWidgets, {
           uiState: localUiState,
           initialSearchParameters: new _algoliasearchHelper.default.SearchParameters({
@@ -328,7 +346,12 @@ var index = function index(widgetParams) {
         helper.setState(newState);
         helper.recommendState = cleanedRecommendState;
         if (localWidgets.length) {
-          localInstantSearchInstance.scheduleSearch();
+          if (isolated) {
+            var _helper3;
+            (_helper3 = helper) === null || _helper3 === void 0 ? void 0 : _helper3.search();
+          } else {
+            localInstantSearchInstance.scheduleSearch();
+          }
         }
       }
       return this;
@@ -366,13 +389,20 @@ var index = function index(widgetParams) {
       // This Helper is only used for state management we do not care about the
       // `searchClient`. Only the "main" Helper created at the `InstantSearch`
       // level is aware of the client.
-      helper = (0, _algoliasearchHelper.default)({}, parameters.index, parameters);
+      helper = (0, _algoliasearchHelper.default)(mainHelper.getClient(), parameters.index, parameters);
       helper.recommendState = recommendParameters;
 
       // We forward the call to `search` to the "main" instance of the Helper
       // which is responsible for managing the queries (it's the only one that is
       // aware of the `searchClient`).
       helper.search = function () {
+        if (isolated) {
+          instantSearchInstance.status = 'loading';
+          _this3.render({
+            instantSearchInstance: instantSearchInstance
+          });
+          return instantSearchInstance.compositionID ? helper.searchWithComposition() : helper.searchOnlyWithDerivedHelpers();
+        }
         if (instantSearchInstance.onStateChange) {
           instantSearchInstance.onStateChange({
             uiState: instantSearchInstance.mainIndex.getWidgetUiState({}),
@@ -396,7 +426,9 @@ var index = function index(widgetParams) {
         var state = helper.state.setQueryParameters(userState);
         return mainHelper.searchForFacetValues(facetName, facetValue, maxFacetHits, state);
       };
-      derivedHelper = mainHelper.derive(function () {
+      var isolatedHelper = indexName ? helper : (0, _algoliasearchHelper.default)({}, '__empty_index__', {});
+      var derivingHelper = isolated ? isolatedHelper : nearestIsolatedHelper(parent, mainHelper);
+      derivedHelper = derivingHelper.derive(function () {
         return _utils.mergeSearchParameters.apply(void 0, [mainHelper.state].concat(_toConsumableArray((0, _utils.resolveSearchParameters)(_this3))));
       }, function () {
         return _this3.getHelper().recommendState;
@@ -538,7 +570,9 @@ var index = function index(widgetParams) {
 
       // We only render index widgets if there are no results.
       // This makes sure `render` is never called with `results` being `null`.
-      var widgetsToRender = this.getResults() || (_derivedHelper2 = derivedHelper) !== null && _derivedHelper2 !== void 0 && _derivedHelper2.lastRecommendResults ? localWidgets : localWidgets.filter(_utils.isIndexWidget);
+      // If it's an isolated index without an index name, we render all widgets,
+      // as there are no results to display for the isolated index itself.
+      var widgetsToRender = this.getResults() || (_derivedHelper2 = derivedHelper) !== null && _derivedHelper2 !== void 0 && _derivedHelper2.lastRecommendResults || isolated && !indexName ? localWidgets : localWidgets.filter(_utils.isIndexWidget);
       widgetsToRender = widgetsToRender.filter(function (widget) {
         if (!widget.shouldRender) {
           return true;
@@ -572,7 +606,7 @@ var index = function index(widgetParams) {
     },
     dispose: function dispose() {
       var _this5 = this,
-        _helper2,
+        _helper4,
         _derivedHelper3;
       localWidgets.forEach(function (widget) {
         if (widget.dispose && helper) {
@@ -592,13 +626,15 @@ var index = function index(widgetParams) {
       });
       localInstantSearchInstance = null;
       localParent = null;
-      (_helper2 = helper) === null || _helper2 === void 0 ? void 0 : _helper2.removeAllListeners();
+      (_helper4 = helper) === null || _helper4 === void 0 ? void 0 : _helper4.removeAllListeners();
       helper = null;
       (_derivedHelper3 = derivedHelper) === null || _derivedHelper3 === void 0 ? void 0 : _derivedHelper3.detach();
       derivedHelper = null;
     },
     getWidgetUiState: function getWidgetUiState(uiState) {
-      return localWidgets.filter(_utils.isIndexWidget).reduce(function (previousUiState, innerIndex) {
+      return localWidgets.filter(_utils.isIndexWidget).filter(function (w) {
+        return !w._isolated;
+      }).reduce(function (previousUiState, innerIndex) {
         return innerIndex.getWidgetUiState(previousUiState);
       }, _objectSpread(_objectSpread({}, uiState), {}, _defineProperty({}, indexId, _objectSpread(_objectSpread({}, uiState[indexId]), localUiState))));
     },
@@ -634,4 +670,17 @@ function storeRenderState(_ref8) {
     parent = _ref8.parent;
   var parentIndexName = parent ? parent.getIndexId() : instantSearchInstance.mainIndex.getIndexId();
   instantSearchInstance.renderState = _objectSpread(_objectSpread({}, instantSearchInstance.renderState), {}, _defineProperty({}, parentIndexName, _objectSpread(_objectSpread({}, instantSearchInstance.renderState[parentIndexName]), renderState)));
+}
+
+/**
+ * Walk up the parent chain to find the closest isolated index, or fall back to mainHelper
+ */
+function nearestIsolatedHelper(current, mainHelper) {
+  while (current) {
+    if (current._isolated) {
+      return current.getHelper();
+    }
+    current = current.getParent();
+  }
+  return mainHelper;
 }

package/dist/instantsearch.development.d.ts

@@ -4758,8 +4758,8 @@ declare type IndexWidget<TUiState extends UiState = UiState> = Omit<Widget<Index
     getParent: () => IndexWidget | null;
     getWidgets: () => Array<Widget | IndexWidget>;
     createURL: (nextState: SearchParameters | ((state: IndexUiState) => IndexUiState)) => string;
-    addWidgets: (widgets: Array<Widget | IndexWidget>) => IndexWidget;
-    removeWidgets: (widgets: Array<Widget | IndexWidget>) => IndexWidget;
+    addWidgets: (widgets: Array<Widget | IndexWidget | Widget[]>) => IndexWidget;
+    removeWidgets: (widgets: Array<Widget | IndexWidget | Widget[]>) => IndexWidget;
     init: (options: IndexInitOptions) => void;
     render: (options: IndexRenderOptions) => void;
     dispose: () => void;
@@ -4782,6 +4782,12 @@ declare type IndexWidget<TUiState extends UiState = UiState> = Omit<Widget<Index
      * Can only be called after `init`.
      */
     setIndexUiState: (indexUiState: TUiState[string] | ((previousIndexUiState: TUiState[string]) => TUiState[string])) => void;
+    /**
+     * This index is isolated, meaning it will not be merged with the main
+     * helper's state.
+     * @private
+     */
+    _isolated: boolean;
 };
 
 declare type IndexWidgetDescription = {
@@ -4790,7 +4796,45 @@ declare type IndexWidgetDescription = {
 };
 
 declare type IndexWidgetParams = {
+    /**
+     * The index or composition id to target.
+     */
     indexName: string;
+    /**
+     * Id to use for the index if there are multiple indices with the same name.
+     * This will be used to create the URL and the render state.
+     */
+    indexId?: string;
+    /**
+     * If `true`, the index will not be merged with the main helper's state.
+     * This means that the index will not be part of the main search request.
+     *
+     * @default false
+     */
+    EXPERIMENTAL_isolated?: false;
+} | {
+    /**
+     * If `true`, the index will not be merged with the main helper's state.
+     * This means that the index will not be part of the main search request.
+     *
+     * This option is EXPERIMENTAL, and implementation details may change in the future.
+     * Things that could change are:
+     * - which widgets get rendered when a change happens
+     * - whether the index searches automatically
+     * - whether the index is included in the URL / UiState
+     * - whether the index is included in server-side rendering
+     *
+     * @default false
+     */
+    EXPERIMENTAL_isolated: true;
+    /**
+     * The index or composition id to target.
+     */
+    indexName?: string;
+    /**
+     * Id to use for the index if there are multiple indices with the same name.
+     * This will be used to create the URL and the render state.
+     */
     indexId?: string;
 };
 
@@ -5125,7 +5169,7 @@ declare class InstantSearch<TUiState extends UiState = UiState, TRouteState = TU
      * Widgets can be added either before or after InstantSearch has started.
      * @param widgets The array of widgets to add to InstantSearch.
      */
-    addWidgets(widgets: Array<Widget | IndexWidget>): this;
+    addWidgets(widgets: Array<Widget | IndexWidget | Widget[]>): this;
     /**
      * Removes a widget from the search instance.
      * @deprecated This method will still be supported in 4.x releases, but not further. It is replaced by `removeWidgets([widget])`
@@ -5140,7 +5184,7 @@ declare class InstantSearch<TUiState extends UiState = UiState, TRouteState = TU
      *
      * The widgets must implement a `dispose()` method to clear their states.
      */
-    removeWidgets(widgets: Array<Widget | IndexWidget>): this;
+    removeWidgets(widgets: Array<Widget | IndexWidget | Widget[]>): this;
     /**
      * Ends the initialization of InstantSearch.js and triggers the
      * first search.

package/dist/instantsearch.development.js

@@ -1,4 +1,4 @@
-/*! InstantSearch.js 4.79.2 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
+/*! InstantSearch.js 4.80.0 | © Algolia, Inc. and contributors; MIT License | https://github.com/algolia/instantsearch */
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
   typeof define === 'function' && define.amd ? define(factory) :
@@ -15857,12 +15857,18 @@
     }, []);
   }
   var index = function index(widgetParams) {
-    if (widgetParams === undefined || widgetParams.indexName === undefined) {
+    if (widgetParams === undefined || widgetParams.indexName === undefined && !widgetParams.EXPERIMENTAL_isolated) {
       throw new Error(withUsage$u('The `indexName` option is required.'));
     }
-    var indexName = widgetParams.indexName,
+
+    // When isolated=true, we use an empty string as the default indexName.
+    // This is intentional: isolated indices do not require a real index name.
+    var _widgetParams$indexNa = widgetParams.indexName,
+      indexName = _widgetParams$indexNa === void 0 ? '' : _widgetParams$indexNa,
       _widgetParams$indexId = widgetParams.indexId,
-      indexId = _widgetParams$indexId === void 0 ? indexName : _widgetParams$indexId;
+      indexId = _widgetParams$indexId === void 0 ? indexName : _widgetParams$indexId,
+      _widgetParams$EXPERIM = widgetParams.EXPERIMENTAL_isolated,
+      isolated = _widgetParams$EXPERIM === void 0 ? false : _widgetParams$EXPERIM;
     var localWidgets = [];
     var localUiState = {};
     var localInstantSearchInstance = null;
@@ -15875,6 +15881,7 @@
     return {
       $$type: 'ais.index',
       $$widgetType: 'ais.index',
+      _isolated: isolated,
       getIndexName: function getIndexName() {
         return indexName;
       },
@@ -15926,7 +15933,7 @@
         return resolveScopedResultsFromWidgets(widgetSiblings);
       },
       getParent: function getParent() {
-        return localParent;
+        return isolated ? null : localParent;
       },
       createURL: function createURL(nextState) {
         if (typeof nextState === 'function') {
@@ -15945,12 +15952,15 @@
         if (!Array.isArray(widgets)) {
           throw new Error(withUsage$u('The `addWidgets` method expects an array of widgets.'));
         }
-        if (widgets.some(function (widget) {
+        var flatWidgets = widgets.reduce(function (acc, w) {
+          return acc.concat(Array.isArray(w) ? w : [w]);
+        }, []);
+        if (flatWidgets.some(function (widget) {
           return typeof widget.init !== 'function' && typeof widget.render !== 'function';
         })) {
           throw new Error(withUsage$u('The widget definition expects a `render` and/or an `init` method.'));
         }
-        widgets.forEach(function (widget) {
+        flatWidgets.forEach(function (widget) {
           if (isIndexWidget(widget)) {
             return;
           }
@@ -15965,8 +15975,8 @@
           }
           addWidgetId(widget);
         });
-        localWidgets = localWidgets.concat(widgets);
-        if (localInstantSearchInstance && Boolean(widgets.length)) {
+        localWidgets = localWidgets.concat(flatWidgets);
+        if (localInstantSearchInstance && Boolean(flatWidgets.length)) {
           privateHelperSetState(helper, {
             state: getLocalWidgetsSearchParameters(localWidgets, {
               uiState: localUiState,
@@ -15982,7 +15992,7 @@
           // We compute the render state before calling `init` in a separate loop
           // to construct the whole render state object that is then passed to
           // `init`.
-          widgets.forEach(function (widget) {
+          flatWidgets.forEach(function (widget) {
             if (widget.getRenderState) {
               var renderState = widget.getRenderState(localInstantSearchInstance.renderState[_this.getIndexId()] || {}, createInitArgs(localInstantSearchInstance, _this, localInstantSearchInstance._initialUiState));
               storeRenderState({
@@ -15992,12 +16002,17 @@
               });
             }
           });
-          widgets.forEach(function (widget) {
+          flatWidgets.forEach(function (widget) {
             if (widget.init) {
               widget.init(createInitArgs(localInstantSearchInstance, _this, localInstantSearchInstance._initialUiState));
             }
           });
-          localInstantSearchInstance.scheduleSearch();
+          if (isolated) {
+            var _helper2;
+            (_helper2 = helper) === null || _helper2 === void 0 ? void 0 : _helper2.search();
+          } else {
+            localInstantSearchInstance.scheduleSearch();
+          }
         }
         return this;
       },
@@ -16006,13 +16021,16 @@
         if (!Array.isArray(widgets)) {
           throw new Error(withUsage$u('The `removeWidgets` method expects an array of widgets.'));
         }
-        if (widgets.some(function (widget) {
+        var flatWidgets = widgets.reduce(function (acc, w) {
+          return acc.concat(Array.isArray(w) ? w : [w]);
+        }, []);
+        if (flatWidgets.some(function (widget) {
           return typeof widget.dispose !== 'function';
         })) {
           throw new Error(withUsage$u('The widget definition expects a `dispose` method.'));
         }
         localWidgets = localWidgets.filter(function (widget) {
-          return widgets.indexOf(widget) === -1;
+          return flatWidgets.indexOf(widget) === -1;
         });
         localWidgets.forEach(function (widget) {
           if (isIndexWidget(widget)) {
@@ -16028,8 +16046,8 @@
             hasSearchWidget = true;
           }
         });
-        if (localInstantSearchInstance && Boolean(widgets.length)) {
-          var _widgets$reduce = widgets.reduce(function (states, widget) {
+        if (localInstantSearchInstance && Boolean(flatWidgets.length)) {
+          var _flatWidgets$reduce = flatWidgets.reduce(function (states, widget) {
               // the `dispose` method exists at this point we already assert it
               var next = widget.dispose({
                 helper: helper,
@@ -16047,8 +16065,8 @@
               cleanedSearchState: helper.state,
               cleanedRecommendState: helper.recommendState
             }),
-            cleanedSearchState = _widgets$reduce.cleanedSearchState,
-            cleanedRecommendState = _widgets$reduce.cleanedRecommendState;
+            cleanedSearchState = _flatWidgets$reduce.cleanedSearchState,
+            cleanedRecommendState = _flatWidgets$reduce.cleanedRecommendState;
           var newState = localInstantSearchInstance.future.preserveSharedStateOnUnmount ? getLocalWidgetsSearchParameters(localWidgets, {
             uiState: localUiState,
             initialSearchParameters: new algoliasearchHelper_1.SearchParameters({
@@ -16068,7 +16086,12 @@
           helper.setState(newState);
           helper.recommendState = cleanedRecommendState;
           if (localWidgets.length) {
-            localInstantSearchInstance.scheduleSearch();
+            if (isolated) {
+              var _helper3;
+              (_helper3 = helper) === null || _helper3 === void 0 ? void 0 : _helper3.search();
+            } else {
+              localInstantSearchInstance.scheduleSearch();
+            }
           }
         }
         return this;
@@ -16106,13 +16129,20 @@
         // This Helper is only used for state management we do not care about the
         // `searchClient`. Only the "main" Helper created at the `InstantSearch`
         // level is aware of the client.
-        helper = algoliasearchHelper_1({}, parameters.index, parameters);
+        helper = algoliasearchHelper_1(mainHelper.getClient(), parameters.index, parameters);
         helper.recommendState = recommendParameters;
 
         // We forward the call to `search` to the "main" instance of the Helper
         // which is responsible for managing the queries (it's the only one that is
         // aware of the `searchClient`).
         helper.search = function () {
+          if (isolated) {
+            instantSearchInstance.status = 'loading';
+            _this3.render({
+              instantSearchInstance: instantSearchInstance
+            });
+            return instantSearchInstance.compositionID ? helper.searchWithComposition() : helper.searchOnlyWithDerivedHelpers();
+          }
           if (instantSearchInstance.onStateChange) {
             instantSearchInstance.onStateChange({
               uiState: instantSearchInstance.mainIndex.getWidgetUiState({}),
@@ -16136,7 +16166,9 @@
           var state = helper.state.setQueryParameters(userState);
           return mainHelper.searchForFacetValues(facetName, facetValue, maxFacetHits, state);
         };
-        derivedHelper = mainHelper.derive(function () {
+        var isolatedHelper = indexName ? helper : algoliasearchHelper_1({}, '__empty_index__', {});
+        var derivingHelper = isolated ? isolatedHelper : nearestIsolatedHelper(parent, mainHelper);
+        derivedHelper = derivingHelper.derive(function () {
           return mergeSearchParameters.apply(void 0, [mainHelper.state].concat(_toConsumableArray(resolveSearchParameters(_this3))));
         }, function () {
           return _this3.getHelper().recommendState;
@@ -16278,7 +16310,9 @@
 
         // We only render index widgets if there are no results.
         // This makes sure `render` is never called with `results` being `null`.
-        var widgetsToRender = this.getResults() || (_derivedHelper2 = derivedHelper) !== null && _derivedHelper2 !== void 0 && _derivedHelper2.lastRecommendResults ? localWidgets : localWidgets.filter(isIndexWidget);
+        // If it's an isolated index without an index name, we render all widgets,
+        // as there are no results to display for the isolated index itself.
+        var widgetsToRender = this.getResults() || (_derivedHelper2 = derivedHelper) !== null && _derivedHelper2 !== void 0 && _derivedHelper2.lastRecommendResults || isolated && !indexName ? localWidgets : localWidgets.filter(isIndexWidget);
         widgetsToRender = widgetsToRender.filter(function (widget) {
           if (!widget.shouldRender) {
             return true;
@@ -16312,7 +16346,7 @@
       },
       dispose: function dispose() {
         var _this5 = this,
-          _helper2,
+          _helper4,
           _derivedHelper3;
         localWidgets.forEach(function (widget) {
           if (widget.dispose && helper) {
@@ -16332,13 +16366,15 @@
         });
         localInstantSearchInstance = null;
         localParent = null;
-        (_helper2 = helper) === null || _helper2 === void 0 ? void 0 : _helper2.removeAllListeners();
+        (_helper4 = helper) === null || _helper4 === void 0 ? void 0 : _helper4.removeAllListeners();
         helper = null;
         (_derivedHelper3 = derivedHelper) === null || _derivedHelper3 === void 0 ? void 0 : _derivedHelper3.detach();
         derivedHelper = null;
       },
       getWidgetUiState: function getWidgetUiState(uiState) {
-        return localWidgets.filter(isIndexWidget).reduce(function (previousUiState, innerIndex) {
+        return localWidgets.filter(isIndexWidget).filter(function (w) {
+          return !w._isolated;
+        }).reduce(function (previousUiState, innerIndex) {
           return innerIndex.getWidgetUiState(previousUiState);
         }, _objectSpread2(_objectSpread2({}, uiState), {}, _defineProperty({}, indexId, _objectSpread2(_objectSpread2({}, uiState[indexId]), localUiState))));
       },
@@ -16375,6 +16411,19 @@
     instantSearchInstance.renderState = _objectSpread2(_objectSpread2({}, instantSearchInstance.renderState), {}, _defineProperty({}, parentIndexName, _objectSpread2(_objectSpread2({}, instantSearchInstance.renderState[parentIndexName]), renderState)));
   }
 
+  /**
+   * Walk up the parent chain to find the closest isolated index, or fall back to mainHelper
+   */
+  function nearestIsolatedHelper(current, mainHelper) {
+    while (current) {
+      if (current._isolated) {
+        return current.getHelper();
+      }
+      current = current.getParent();
+    }
+    return mainHelper;
+  }
+
   function formatNumber(value, numberLocale) {
     return value.toLocaleString(numberLocale);
   }
@@ -16440,7 +16489,7 @@
     };
   }
 
-  var version$1 = '4.79.2';
+  var version$1 = '4.80.0';
 
   var withUsage$v = createDocumentationMessageGenerator({
     name: 'instantsearch'
@@ -16741,12 +16790,9 @@
         if (!Array.isArray(widgets)) {
           throw new Error(withUsage$v('The `addWidgets` method expects an array of widgets. Please use `addWidget`.'));
         }
-        if (widgets.some(function (widget) {
-          return typeof widget.init !== 'function' && typeof widget.render !== 'function';
+        if (this.compositionID && widgets.some(function (w) {
+          return !Array.isArray(w) && isIndexWidget(w) && !w._isolated;
         })) {
-          throw new Error(withUsage$v('The widget definition expects a `render` and/or an `init` method.'));
-        }
-        if (this.compositionID && widgets.some(isIndexWidget)) {
           throw new Error(withUsage$v('The `index` widget cannot be used with a composition-based InstantSearch implementation.'));
         }
         this.mainIndex.addWidgets(widgets);
@@ -16779,11 +16825,6 @@
         if (!Array.isArray(widgets)) {
           throw new Error(withUsage$v('The `removeWidgets` method expects an array of widgets. Please use `removeWidget`.'));
         }
-        if (widgets.some(function (widget) {
-          return typeof widget.dispose !== 'function';
-        })) {
-          throw new Error(withUsage$v('The widget definition expects a `dispose` method.'));
-        }
         this.mainIndex.removeWidgets(widgets);
         return this;
       }
@@ -19068,7 +19109,7 @@
         });
         // if there is one TextNode first and one TextNode last, the
         // last one's nodeValue will be assigned to the first.
-        if (this.nodes[0].nodeValue) {
+        if (this.nodes[0] && this.nodes[0].nodeValue) {
           this.nodes[0].nodeValue = '';
         }
       }