instantsearch.js 4.79.1 → 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/connectors/infinite-hits/connectInfiniteHits.js

@@ -98,22 +98,20 @@ var connectInfiniteHits = exports.default = function connectInfiniteHits(renderF
         return Math.max.apply(Math, [page].concat(_toConsumableArray(pages)));
       }
     };
-    var getShowPrevious = function getShowPrevious(helper) {
+    var getShowPrevious = function getShowPrevious(helper, getCachedHits) {
       return function () {
+        var cachedHits = getCachedHits();
         // Using the helper's `overrideStateWithoutTriggeringChangeEvent` method
         // avoid updating the browser URL when the user displays the previous page.
         helper.overrideStateWithoutTriggeringChangeEvent(_objectSpread(_objectSpread({}, helper.state), {}, {
-          page: getFirstReceivedPage(helper.state, cache.read({
-            state: normalizeState(helper.state)
-          }) || {}) - 1
+          page: getFirstReceivedPage(helper.state, cachedHits) - 1
         })).searchWithoutTriggeringOnStateChange();
       };
     };
-    var getShowMore = function getShowMore(helper) {
+    var getShowMore = function getShowMore(helper, getCachedHits) {
       return function () {
-        helper.setPage(getLastReceivedPage(helper.state, cache.read({
-          state: normalizeState(helper.state)
-        }) || {}) + 1).search();
+        var cachedHits = getCachedHits();
+        helper.setPage(getLastReceivedPage(helper.state, cachedHits) + 1).search();
       };
     };
     return {
@@ -145,6 +143,12 @@ var connectInfiniteHits = exports.default = function connectInfiniteHits(renderF
           parent = _ref6.parent,
           existingState = _ref6.state,
           instantSearchInstance = _ref6.instantSearchInstance;
+        var getCacheHits = function getCacheHits() {
+          var state = parent.getPreviousState() || existingState;
+          return cache.read({
+            state: normalizeState(state)
+          }) || {};
+        };
         var isFirstPage;
         var currentPageHits = [];
         /**
@@ -153,13 +157,15 @@ var connectInfiniteHits = exports.default = function connectInfiniteHits(renderF
          * is loading.
          */
         var state = parent.getPreviousState() || existingState;
-        var cachedHits = cache.read({
-          state: normalizeState(state)
-        }) || {};
+        var cachedHits = getCacheHits();
         var banner = results === null || results === void 0 ? void 0 : (_results$renderingCon = results.renderingContent) === null || _results$renderingCon === void 0 ? void 0 : (_results$renderingCon2 = _results$renderingCon.widgets) === null || _results$renderingCon2 === void 0 ? void 0 : (_results$renderingCon3 = _results$renderingCon2.banners) === null || _results$renderingCon3 === void 0 ? void 0 : _results$renderingCon3[0];
         if (!showPrevious) {
-          showPrevious = getShowPrevious(helper);
-          showMore = getShowMore(helper);
+          showPrevious = function showPrevious() {
+            return getShowPrevious(helper, getCacheHits)();
+          };
+          showMore = function showMore() {
+            return getShowMore(helper, getCacheHits)();
+          };
         }
         if (!sendEvent) {
           sendEvent = (0, _utils.createSendEventForHits)({

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.1';
+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.