instantsearch.js 4.61.0 → 4.62.0

package/cjs/connectors/breadcrumb/connectBreadcrumb.js

@@ -6,9 +6,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _utils = require("../../lib/utils");
-var _excluded = ["hierarchicalMenu"];
-function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
-function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -126,7 +123,7 @@ var connectBreadcrumb = function connectBreadcrumb(renderFn) {
         var path = searchParameters.getHierarchicalFacetBreadcrumb(hierarchicalFacetName);
         return removeEmptyRefinementsFromUiState(_objectSpread(_objectSpread({}, uiState), {}, {
           hierarchicalMenu: _objectSpread(_objectSpread({}, uiState.hierarchicalMenu), {}, _defineProperty({}, hierarchicalFacetName, path))
-        }));
+        }), hierarchicalFacetName);
       },
       getWidgetSearchParameters: function getWidgetSearchParameters(searchParameters, _ref4) {
         var uiState = _ref4.uiState;
@@ -177,18 +174,17 @@ function shiftItemsValues(array) {
     };
   });
 }
-function removeEmptyRefinementsFromUiState(indexUiState) {
-  var hierarchicalMenu = indexUiState.hierarchicalMenu,
-    indexUiStateBase = _objectWithoutProperties(indexUiState, _excluded);
-  if (!hierarchicalMenu) {
+function removeEmptyRefinementsFromUiState(indexUiState, attribute) {
+  if (!indexUiState.hierarchicalMenu) {
     return indexUiState;
   }
-  var connectorUiState = Object.keys(hierarchicalMenu).reduce(function (acc, key) {
-    return _objectSpread(_objectSpread({}, acc), hierarchicalMenu[key].length > 0 ? _defineProperty({}, key, hierarchicalMenu[key]) : {});
-  }, {});
-  return _objectSpread(_objectSpread({}, indexUiStateBase), Object.keys(connectorUiState).length > 0 ? {
-    hierarchicalMenu: connectorUiState
-  } : {});
+  if (!indexUiState.hierarchicalMenu[attribute] || !indexUiState.hierarchicalMenu[attribute].length) {
+    delete indexUiState.hierarchicalMenu[attribute];
+  }
+  if (Object.keys(indexUiState.hierarchicalMenu).length === 0) {
+    delete indexUiState.hierarchicalMenu;
+  }
+  return indexUiState;
 }
 var _default = connectBreadcrumb;
 exports.default = _default;

package/cjs/connectors/hierarchical-menu/connectHierarchicalMenu.js

@@ -6,8 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _utils = require("../../lib/utils");
-var _excluded = ["name", "escapedValue", "data", "path"],
-  _excluded2 = ["hierarchicalMenu"];
+var _excluded = ["name", "escapedValue", "data", "path"];
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -208,7 +207,7 @@ var connectHierarchicalMenu = function connectHierarchicalMenu(renderFn) {
         var path = searchParameters.getHierarchicalFacetBreadcrumb(hierarchicalFacetName);
         return removeEmptyRefinementsFromUiState(_objectSpread(_objectSpread({}, uiState), {}, {
           hierarchicalMenu: _objectSpread(_objectSpread({}, uiState.hierarchicalMenu), {}, _defineProperty({}, hierarchicalFacetName, path))
-        }));
+        }), hierarchicalFacetName);
       },
       getWidgetSearchParameters: function getWidgetSearchParameters(searchParameters, _ref6) {
         var uiState = _ref6.uiState;
@@ -241,18 +240,17 @@ var connectHierarchicalMenu = function connectHierarchicalMenu(renderFn) {
     };
   };
 };
-function removeEmptyRefinementsFromUiState(indexUiState) {
-  var hierarchicalMenu = indexUiState.hierarchicalMenu,
-    indexUiStateBase = _objectWithoutProperties(indexUiState, _excluded2);
-  if (!hierarchicalMenu) {
+function removeEmptyRefinementsFromUiState(indexUiState, attribute) {
+  if (!indexUiState.hierarchicalMenu) {
     return indexUiState;
   }
-  var connectorUiState = Object.keys(hierarchicalMenu).reduce(function (acc, key) {
-    return _objectSpread(_objectSpread({}, acc), hierarchicalMenu[key].length > 0 ? _defineProperty({}, key, hierarchicalMenu[key]) : {});
-  }, {});
-  return _objectSpread(_objectSpread({}, indexUiStateBase), Object.keys(connectorUiState).length > 0 ? {
-    hierarchicalMenu: connectorUiState
-  } : {});
+  if (!indexUiState.hierarchicalMenu[attribute] || indexUiState.hierarchicalMenu[attribute].length === 0) {
+    delete indexUiState.hierarchicalMenu[attribute];
+  }
+  if (Object.keys(indexUiState.hierarchicalMenu).length === 0) {
+    delete indexUiState.hierarchicalMenu;
+  }
+  return indexUiState;
 }
 var _default = connectHierarchicalMenu;
 exports.default = _default;

package/cjs/connectors/menu/connectMenu.js

@@ -5,8 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _utils = require("../../lib/utils");
-var _excluded = ["name", "escapedValue", "path"],
-  _excluded2 = ["menu"];
+var _excluded = ["name", "escapedValue", "path"];
 function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
@@ -180,7 +179,7 @@ var connectMenu = function connectMenu(renderFn) {
           value = _searchParameters$get2[0];
         return removeEmptyRefinementsFromUiState(_objectSpread(_objectSpread({}, uiState), {}, {
           menu: _objectSpread(_objectSpread({}, uiState.menu), {}, _defineProperty({}, attribute, value))
-        }));
+        }), attribute);
       },
       getWidgetSearchParameters: function getWidgetSearchParameters(searchParameters, _ref5) {
         var uiState = _ref5.uiState;
@@ -206,19 +205,17 @@ var connectMenu = function connectMenu(renderFn) {
     };
   };
 };
-function removeEmptyRefinementsFromUiState(indexUiState) {
-  var menu = indexUiState.menu,
-    indexUiStateBase = _objectWithoutProperties(indexUiState, _excluded2);
-  if (!menu) {
+function removeEmptyRefinementsFromUiState(indexUiState, attribute) {
+  if (!indexUiState.menu) {
     return indexUiState;
   }
-  var connectorUiState = Object.keys(menu).reduce(function (acc, key) {
-    var _menu$key;
-    return _objectSpread(_objectSpread({}, acc), ((_menu$key = menu[key]) === null || _menu$key === void 0 ? void 0 : _menu$key.length) > 0 ? _defineProperty({}, key, menu[key]) : {});
-  }, {});
-  return _objectSpread(_objectSpread({}, indexUiStateBase), Object.keys(connectorUiState).length > 0 ? {
-    menu: connectorUiState
-  } : {});
+  if (indexUiState.menu[attribute] === undefined) {
+    delete indexUiState.menu[attribute];
+  }
+  if (Object.keys(indexUiState.menu).length === 0) {
+    delete indexUiState.menu;
+  }
+  return indexUiState;
 }
 var _default = connectMenu;
 exports.default = _default;

package/cjs/connectors/numeric-menu/connectNumericMenu.js

@@ -5,10 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _utils = require("../../lib/utils");
-var _excluded = ["numericMenu"];
 function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
-function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
-function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e2) { throw _e2; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e3) { didErr = true; err = _e3; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
@@ -106,7 +103,7 @@ var connectNumericMenu = function connectNumericMenu(renderFn) {
         var max = values['<='] && values['<='][0] || '';
         return removeEmptyRefinementsFromUiState(_objectSpread(_objectSpread({}, uiState), {}, {
           numericMenu: _objectSpread(_objectSpread({}, uiState.numericMenu), {}, _defineProperty({}, attribute, "".concat(min, ":").concat(max)))
-        }));
+        }), attribute);
       },
       getWidgetSearchParameters: function getWidgetSearchParameters(searchParameters, _ref6) {
         var uiState = _ref6.uiState;
@@ -268,18 +265,17 @@ function getRefinedState(state, attribute, facetValue) {
 function hasNumericRefinement(currentRefinements, operator, value) {
   return currentRefinements[operator] !== undefined && currentRefinements[operator].includes(value);
 }
-function removeEmptyRefinementsFromUiState(indexUiState) {
-  var numericMenu = indexUiState.numericMenu,
-    indexUiStateBase = _objectWithoutProperties(indexUiState, _excluded);
-  if (!numericMenu) {
+function removeEmptyRefinementsFromUiState(indexUiState, attribute) {
+  if (!indexUiState.numericMenu) {
     return indexUiState;
   }
-  var connectorUiState = Object.keys(numericMenu).reduce(function (acc, key) {
-    return _objectSpread(_objectSpread({}, acc), numericMenu[key] !== ':' ? _defineProperty({}, key, numericMenu[key]) : {});
-  }, {});
-  return _objectSpread(_objectSpread({}, indexUiStateBase), Object.keys(connectorUiState).length > 0 ? {
-    numericMenu: connectorUiState
-  } : {});
+  if (indexUiState.numericMenu[attribute] === ':') {
+    delete indexUiState.numericMenu[attribute];
+  }
+  if (Object.keys(indexUiState.numericMenu).length === 0) {
+    delete indexUiState.numericMenu;
+  }
+  return indexUiState;
 }
 var _default = connectNumericMenu;
 exports.default = _default;

package/cjs/connectors/rating-menu/connectRatingMenu.js

@@ -6,9 +6,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _utils = require("../../lib/utils");
-var _excluded = ["ratingMenu"];
-function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
-function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
@@ -267,7 +264,7 @@ var connectRatingMenu = function connectRatingMenu(renderFn) {
         var value = _getRefinedStar(searchParameters);
         return removeEmptyRefinementsFromUiState(_objectSpread(_objectSpread({}, uiState), {}, {
           ratingMenu: _objectSpread(_objectSpread({}, uiState.ratingMenu), {}, _defineProperty({}, attribute, typeof value === 'number' ? value : undefined))
-        }));
+        }), attribute);
       },
       getWidgetSearchParameters: function getWidgetSearchParameters(searchParameters, _ref8) {
         var uiState = _ref8.uiState;
@@ -284,18 +281,17 @@ var connectRatingMenu = function connectRatingMenu(renderFn) {
     };
   };
 };
-function removeEmptyRefinementsFromUiState(indexUiState) {
-  var ratingMenu = indexUiState.ratingMenu,
-    indexUiStateBase = _objectWithoutProperties(indexUiState, _excluded);
-  if (!ratingMenu) {
+function removeEmptyRefinementsFromUiState(indexUiState, attribute) {
+  if (!indexUiState.ratingMenu) {
     return indexUiState;
   }
-  var connectorUiState = Object.keys(ratingMenu).reduce(function (acc, key) {
-    return _objectSpread(_objectSpread({}, acc), typeof ratingMenu[key] === 'number' ? _defineProperty({}, key, ratingMenu[key]) : {});
-  }, {});
-  return _objectSpread(_objectSpread({}, indexUiStateBase), Object.keys(connectorUiState).length > 0 ? {
-    ratingMenu: connectorUiState
-  } : {});
+  if (typeof indexUiState.ratingMenu[attribute] !== 'number') {
+    delete indexUiState.ratingMenu[attribute];
+  }
+  if (Object.keys(indexUiState.ratingMenu).length === 0) {
+    delete indexUiState.ratingMenu;
+  }
+  return indexUiState;
 }
 var _default = connectRatingMenu;
 exports.default = _default;

package/cjs/connectors/refinement-list/connectRefinementList.js

@@ -7,8 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _utils = require("../../lib/utils");
 var _excluded = ["name", "escapedValue"],
-  _excluded2 = ["escapedValue", "value"],
-  _excluded3 = ["refinementList"];
+  _excluded2 = ["escapedValue", "value"];
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -252,7 +251,7 @@ var connectRefinementList = function connectRefinementList(renderFn) {
         var values = operator === 'or' ? searchParameters.getDisjunctiveRefinements(attribute) : searchParameters.getConjunctiveRefinements(attribute);
         return removeEmptyRefinementsFromUiState(_objectSpread(_objectSpread({}, uiState), {}, {
           refinementList: _objectSpread(_objectSpread({}, uiState.refinementList), {}, _defineProperty({}, attribute, values))
-        }));
+        }), attribute);
       },
       getWidgetSearchParameters: function getWidgetSearchParameters(searchParameters, _ref6) {
         var uiState = _ref6.uiState;
@@ -282,18 +281,17 @@ var connectRefinementList = function connectRefinementList(renderFn) {
     };
   };
 };
-function removeEmptyRefinementsFromUiState(indexUiState) {
-  var refinementList = indexUiState.refinementList,
-    indexUiStateBase = _objectWithoutProperties(indexUiState, _excluded3);
-  if (!refinementList) {
+function removeEmptyRefinementsFromUiState(indexUiState, attribute) {
+  if (!indexUiState.refinementList) {
     return indexUiState;
   }
-  var connectorUiState = Object.keys(refinementList).reduce(function (acc, key) {
-    return _objectSpread(_objectSpread({}, acc), refinementList[key].length > 0 ? _defineProperty({}, key, refinementList[key]) : {});
-  }, {});
-  return _objectSpread(_objectSpread({}, indexUiStateBase), Object.keys(connectorUiState).length > 0 ? {
-    refinementList: connectorUiState
-  } : {});
+  if (!indexUiState.refinementList[attribute] || indexUiState.refinementList[attribute].length === 0) {
+    delete indexUiState.refinementList[attribute];
+  }
+  if (Object.keys(indexUiState.refinementList).length === 0) {
+    delete indexUiState.refinementList;
+  }
+  return indexUiState;
 }
 var _default = connectRefinementList;
 exports.default = _default;

package/cjs/lib/InstantSearch.js

@@ -44,7 +44,8 @@ function defaultCreateURL() {
  * Global options for an InstantSearch instance.
  */
 var INSTANTSEARCH_FUTURE_DEFAULTS = {
-  preserveSharedStateOnUnmount: false
+  preserveSharedStateOnUnmount: false,
+  persistHierarchicalRootCount: false
 };
 
 /**
@@ -381,7 +382,9 @@ var InstantSearch = /*#__PURE__*/function (_EventEmitter) {
       // DerivedHelper scoped into the `index` widgets.
       // In Vue InstantSearch' hydrate, a main helper gets set before start, so
       // we need to respect this helper as a way to keep all listeners correct.
-      var mainHelper = this.mainHelper || (0, _algoliasearchHelper.default)(this.client, this.indexName);
+      var mainHelper = this.mainHelper || (0, _algoliasearchHelper.default)(this.client, this.indexName, undefined, {
+        persistHierarchicalRootCount: this.future.persistHierarchicalRootCount
+      });
       mainHelper.search = function () {
         _this3.status = 'loading';
         _this3.scheduleRender(false);

package/cjs/lib/version.js

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

package/dist/instantsearch.development.d.ts

@@ -2627,6 +2627,16 @@ declare type InstantSearchOptions<TUiState extends UiState = UiState, TRouteStat
          * @default false
          */
         preserveSharedStateOnUnmount?: boolean;
+        /**
+         * Changes the way root levels of hierarchical facets have their count displayed.
+         *
+         * If `false` (by default), the count of the refined root level is updated to match the count of the actively refined parent level.
+         *
+         * If `true`, the count of the root level stays the same as the count of all children levels.
+         *
+         * @default false
+         */
+        persistHierarchicalRootCount?: boolean;
     };
 };