instantsearch.js 4.43.1 → 4.45.0

package/es/components/Highlight/Highlight.d.ts

@@ -0,0 +1,7 @@
+import { h } from 'preact';
+import type { HighlightProps as InternalHighlightProps, HighlightClassNames as InternalHighlightClassNames } from '@algolia/ui-components-highlight-vdom';
+export declare type HighlightClassNames = InternalHighlightClassNames;
+export declare type HighlightProps = Omit<InternalHighlightProps, 'classNames'> & {
+    classNames?: Partial<HighlightClassNames>;
+};
+export declare function Highlight({ classNames, ...props }: HighlightProps): h.JSX.Element;

package/es/components/Highlight/Highlight.js

@@ -0,0 +1,24 @@
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+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; }
+
+/** @jsx h */
+import { cx } from '@algolia/ui-components-shared';
+import { h } from 'preact';
+import { InternalHighlight } from "../InternalHighlight/InternalHighlight.js";
+export function Highlight(_ref) {
+  var _ref$classNames = _ref.classNames,
+      classNames = _ref$classNames === void 0 ? {} : _ref$classNames,
+      props = _objectWithoutProperties(_ref, ["classNames"]);
+
+  return h(InternalHighlight, _extends({
+    classNames: {
+      root: cx('ais-Highlight', classNames.root),
+      highlighted: cx('ais-Highlight-highlighted', classNames.highlighted),
+      nonHighlighted: cx('ais-Highlight-nonHighlighted', classNames.nonHighlighted),
+      separator: cx('ais-Highlight-separator', classNames.separator)
+    }
+  }, props));
+}

package/es/components/InternalHighlight/InternalHighlight.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="react" />
+export declare const InternalHighlight: ({ parts, highlightedTagName, nonHighlightedTagName, separator, className, classNames, ...props }: import("@algolia/ui-components-highlight-vdom").HighlightProps) => JSX.Element;

package/es/components/InternalHighlight/InternalHighlight.js

@@ -0,0 +1,6 @@
+import { createHighlightComponent } from '@algolia/ui-components-highlight-vdom';
+import { createElement, Fragment } from 'preact';
+export var InternalHighlight = createHighlightComponent({
+  createElement: createElement,
+  Fragment: Fragment
+});

package/es/components/ReverseHighlight/ReverseHighlight.d.ts

@@ -0,0 +1,7 @@
+import { h } from 'preact';
+import type { HighlightProps as InternalHighlightProps, HighlightClassNames as InternalHighlightClassNames } from '@algolia/ui-components-highlight-vdom';
+export declare type ReverseHighlightClassNames = InternalHighlightClassNames;
+export declare type ReverseHighlightProps = Omit<InternalHighlightProps, 'classNames'> & {
+    classNames?: Partial<ReverseHighlightClassNames>;
+};
+export declare function ReverseHighlight({ classNames, ...props }: ReverseHighlightProps): h.JSX.Element;

package/es/components/ReverseHighlight/ReverseHighlight.js

@@ -0,0 +1,24 @@
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+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; }
+
+/** @jsx h */
+import { cx } from '@algolia/ui-components-shared';
+import { h } from 'preact';
+import { InternalHighlight } from "../InternalHighlight/InternalHighlight.js";
+export function ReverseHighlight(_ref) {
+  var _ref$classNames = _ref.classNames,
+      classNames = _ref$classNames === void 0 ? {} : _ref$classNames,
+      props = _objectWithoutProperties(_ref, ["classNames"]);
+
+  return h(InternalHighlight, _extends({
+    classNames: {
+      root: cx('ais-ReverseHighlight', classNames.root),
+      highlighted: cx('ais-ReverseHighlight-highlighted', classNames.highlighted),
+      nonHighlighted: cx('ais-ReverseHighlight-nonHighlighted', classNames.nonHighlighted),
+      separator: cx('ais-ReverseHighlight-separator', classNames.separator)
+    }
+  }, props));
+}

package/es/components/ReverseSnippet/ReverseSnippet.d.ts

@@ -0,0 +1,7 @@
+import { h } from 'preact';
+import type { HighlightProps as InternalHighlightProps, HighlightClassNames as InternalHighlightClassNames } from '@algolia/ui-components-highlight-vdom';
+export declare type ReverseSnippetClassNames = InternalHighlightClassNames;
+export declare type ReverseSnippetProps = Omit<InternalHighlightProps, 'classNames'> & {
+    classNames?: Partial<ReverseSnippetClassNames>;
+};
+export declare function ReverseSnippet({ classNames, ...props }: ReverseSnippetProps): h.JSX.Element;

package/es/components/ReverseSnippet/ReverseSnippet.js

@@ -0,0 +1,24 @@
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+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; }
+
+/** @jsx h */
+import { cx } from '@algolia/ui-components-shared';
+import { h } from 'preact';
+import { InternalHighlight } from "../InternalHighlight/InternalHighlight.js";
+export function ReverseSnippet(_ref) {
+  var _ref$classNames = _ref.classNames,
+      classNames = _ref$classNames === void 0 ? {} : _ref$classNames,
+      props = _objectWithoutProperties(_ref, ["classNames"]);
+
+  return h(InternalHighlight, _extends({
+    classNames: {
+      root: cx('ais-ReverseSnippet', classNames.root),
+      highlighted: cx('ais-ReverseSnippet-highlighted', classNames.highlighted),
+      nonHighlighted: cx('ais-ReverseSnippet-nonHighlighted', classNames.nonHighlighted),
+      separator: cx('ais-ReverseSnippet-separator', classNames.separator)
+    }
+  }, props));
+}

package/es/components/Snippet/Snippet.d.ts

@@ -0,0 +1,7 @@
+import { h } from 'preact';
+import type { HighlightProps as InternalHighlightProps, HighlightClassNames as InternalHighlightClassNames } from '@algolia/ui-components-highlight-vdom';
+export declare type SnippetClassNames = InternalHighlightClassNames;
+export declare type SnippetProps = Omit<InternalHighlightProps, 'classNames'> & {
+    classNames?: Partial<SnippetClassNames>;
+};
+export declare function Snippet({ classNames, ...props }: SnippetProps): h.JSX.Element;

package/es/components/Snippet/Snippet.js

@@ -0,0 +1,24 @@
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+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; }
+
+/** @jsx h */
+import { cx } from '@algolia/ui-components-shared';
+import { h } from 'preact';
+import { InternalHighlight } from "../InternalHighlight/InternalHighlight.js";
+export function Snippet(_ref) {
+  var _ref$classNames = _ref.classNames,
+      classNames = _ref$classNames === void 0 ? {} : _ref$classNames,
+      props = _objectWithoutProperties(_ref, ["classNames"]);
+
+  return h(InternalHighlight, _extends({
+    classNames: {
+      root: cx('ais-Snippet', classNames.root),
+      highlighted: cx('ais-Snippet-highlighted', classNames.highlighted),
+      nonHighlighted: cx('ais-Snippet-nonHighlighted', classNames.nonHighlighted),
+      separator: cx('ais-Snippet-separator', classNames.separator)
+    }
+  }, props));
+}

package/es/connectors/geo-search/connectGeoSearch.d.ts

@@ -1,6 +1,6 @@
 import type { SendEventForHits } from '../../lib/utils';
-import type { Connector, GeoLoc, Hit, TransformItems, WidgetRenderState } from '../../types';
-export declare type GeoHit = Hit & Required<Pick<Hit, '_geoloc'>>;
+import type { BaseHit, Connector, GeoLoc, Hit, TransformItems, WidgetRenderState } from '../../types';
+export declare type GeoHit<THit extends BaseHit = Record<string, any>> = Hit<THit> & Required<Pick<Hit, '_geoloc'>>;
 declare type Bounds = {
     /**
      * The top right corner of the map view.
@@ -11,7 +11,7 @@ declare type Bounds = {
      */
     southWest: GeoLoc;
 };
-export declare type GeoSearchRenderState = {
+export declare type GeoSearchRenderState<THit extends BaseHit = Record<string, any>> = {
     /**
      * Reset the current bounding box refinement.
      */
@@ -35,7 +35,7 @@ export declare type GeoSearchRenderState = {
     /**
      * The matched hits from Algolia API.
      */
-    items: GeoHit[];
+    items: Array<GeoHit<THit>>;
     /**
      * The current position of the search.
      */
@@ -59,7 +59,7 @@ export declare type GeoSearchRenderState = {
      */
     toggleRefineOnMapMove(): void;
 };
-export declare type GeoSearchConnectorParams = {
+export declare type GeoSearchConnectorParams<THit extends BaseHit = Record<string, any>> = {
     /**
      * If true, refine will be triggered as you move the map.
      * @default true
@@ -69,13 +69,13 @@ export declare type GeoSearchConnectorParams = {
      * Function to transform the items passed to the templates.
      * @default items => items
      */
-    transformItems?: TransformItems<GeoHit>;
+    transformItems?: TransformItems<GeoHit<THit>>;
 };
-export declare type GeoSearchWidgetDescription = {
+export declare type GeoSearchWidgetDescription<THit extends BaseHit = Record<string, any>> = {
     $$type: 'ais.geoSearch';
-    renderState: GeoSearchRenderState;
+    renderState: GeoSearchRenderState<THit>;
     indexRenderState: {
-        geoSearch: WidgetRenderState<GeoSearchRenderState, GeoSearchConnectorParams>;
+        geoSearch: WidgetRenderState<GeoSearchRenderState<THit>, GeoSearchConnectorParams<THit>>;
     };
     indexUiState: {
         geoSearch: {
@@ -90,7 +90,7 @@ export declare type GeoSearchWidgetDescription = {
         };
     };
 };
-export declare type GeoSearchConnector = Connector<GeoSearchWidgetDescription, GeoSearchConnectorParams>;
+export declare type GeoSearchConnector<THit extends BaseHit = Record<string, any>> = Connector<GeoSearchWidgetDescription<THit>, GeoSearchConnectorParams<THit>>;
 /**
  * The **GeoSearch** connector provides the logic to build a widget that will display the results on a map. It also provides a way to search for results based on their position. The connector provides functions to manage the search experience (search on map interaction or control the interaction for example).
  *

package/es/connectors/hits-per-page/connectHitsPerPage.d.ts

@@ -50,8 +50,13 @@ export declare type HitsPerPageRenderState = {
     refine: (value: number) => void;
     /**
      * Indicates whether or not the search has results.
+     * @deprecated Use `canRefine` instead.
      */
     hasNoResults: boolean;
+    /**
+     * Indicates if search state can be refined.
+     */
+    canRefine: boolean;
 };
 export declare type HitsPerPageWidgetDescription = {
     $$type: 'ais.hitsPerPage';

package/es/connectors/hits-per-page/connectHitsPerPage.js

@@ -119,6 +119,7 @@ var connectHitsPerPage = function connectHitsPerPage(renderFn) {
             results = _ref5.results,
             createURL = _ref5.createURL,
             helper = _ref5.helper;
+        var canRefine = results ? results.nbHits > 0 : false;
         return {
           items: transformItems(normalizeItems(state), {
             results: results
@@ -128,7 +129,8 @@ var connectHitsPerPage = function connectHitsPerPage(renderFn) {
             state: state,
             createURL: createURL
           }),
-          hasNoResults: results ? results.nbHits === 0 : true,
+          hasNoResults: !canRefine,
+          canRefine: canRefine,
           widgetParams: widgetParams
         };
       },

package/es/connectors/numeric-menu/connectNumericMenu.d.ts

@@ -56,8 +56,16 @@ export declare type NumericMenuRenderState = {
     createURL: CreateURL<NumericMenuRenderStateItem['value']>;
     /**
      * `true` if the last search contains no result
+     * @deprecated Use `canRefine` instead.
      */
     hasNoResults: boolean;
+    /**
+     * Indicates if search state can be refined.
+     *
+     * This is `true` if the last search contains no result and
+     * "All" range is selected
+     */
+    canRefine: boolean;
     /**
      * Sets the selected value and trigger a new search
      */

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

@@ -1,3 +1,5 @@
+function _createForOfIteratorHelper(o, allowArrayLike) { var it; if (typeof Symbol === "undefined" || o[Symbol.iterator] == null) { 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 = o[Symbol.iterator](); }, 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."); }
@@ -16,7 +18,7 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
 
 function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 
-import { checkRendering, createDocumentationMessageGenerator, isFiniteNumber, convertNumericRefinementsToFilters, noop } from "../../lib/utils/index.js";
+import { checkRendering, createDocumentationMessageGenerator, isFiniteNumber, noop } from "../../lib/utils/index.js";
 var withUsage = createDocumentationMessageGenerator({
   name: 'numeric-menu',
   connector: true
@@ -24,46 +26,11 @@ var withUsage = createDocumentationMessageGenerator({
 var $$type = 'ais.numericMenu';
 
 var createSendEvent = function createSendEvent(_ref) {
-  var instantSearchInstance = _ref.instantSearchInstance,
-      helper = _ref.helper,
-      attribute = _ref.attribute;
+  var instantSearchInstance = _ref.instantSearchInstance;
   return function () {
-    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-      args[_key] = arguments[_key];
-    }
-
-    if (args.length === 1) {
-      instantSearchInstance.sendEventToInsights(args[0]);
-      return;
-    }
-
-    var eventType = args[0],
-        facetValue = args[1],
-        _args$ = args[2],
-        eventName = _args$ === void 0 ? 'Filter Applied' : _args$;
-
-    if (eventType !== 'click') {
+    if (arguments.length === 1) {
+      instantSearchInstance.sendEventToInsights(arguments.length <= 0 ? undefined : arguments[0]);
       return;
-    } // facetValue === "%7B%22start%22:5,%22end%22:10%7D"
-
-
-    var filters = convertNumericRefinementsToFilters(getRefinedState(helper.state, attribute, facetValue), attribute);
-
-    if (filters && filters.length > 0) {
-      /*
-        filters === ["price<=10", "price>=5"]
-      */
-      instantSearchInstance.sendEventToInsights({
-        insightsMethod: 'clickedFilters',
-        widgetType: $$type,
-        eventType: eventType,
-        payload: {
-          eventName: eventName,
-          index: helper.getIndex(),
-          filters: filters
-        },
-        attribute: attribute
-      });
     }
   };
 };
@@ -208,18 +175,39 @@ var connectNumericMenu = function connectNumericMenu(renderFn) {
 
         if (!connectorState.sendEvent) {
           connectorState.sendEvent = createSendEvent({
-            instantSearchInstance: instantSearchInstance,
-            helper: helper,
-            attribute: attribute
+            instantSearchInstance: instantSearchInstance
           });
         }
 
+        var hasNoResults = results ? results.nbHits === 0 : true;
+        var preparedItems = prepareItems(state);
+        var allIsSelected = true;
+
+        var _iterator = _createForOfIteratorHelper(preparedItems),
+            _step;
+
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var item = _step.value;
+
+            if (item.isRefined && decodeURI(item.value) !== '{}') {
+              allIsSelected = false;
+              break;
+            }
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+
         return {
           createURL: connectorState.createURL(state),
-          items: transformItems(prepareItems(state), {
+          items: transformItems(preparedItems, {
             results: results
           }),
-          hasNoResults: results ? results.nbHits === 0 : true,
+          hasNoResults: hasNoResults,
+          canRefine: !(hasNoResults && allIsSelected),
           refine: connectorState.refine,
           sendEvent: connectorState.sendEvent,
           widgetParams: widgetParams

package/es/connectors/range/connectRange.js

@@ -16,7 +16,7 @@ function _iterableToArrayLimit(arr, i) { if (typeof Symbol === "undefined" || !(
 
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
-import { checkRendering, createDocumentationMessageGenerator, convertNumericRefinementsToFilters, isFiniteNumber, find, noop } from "../../lib/utils/index.js";
+import { checkRendering, createDocumentationMessageGenerator, isFiniteNumber, find, noop } from "../../lib/utils/index.js";
 var withUsage = createDocumentationMessageGenerator({
   name: 'range-input',
   connector: true
@@ -148,50 +148,12 @@ var connectRange = function connectRange(renderFn) {
       return null;
     };
 
-    var sendEventWithRefinedState = function sendEventWithRefinedState(refinedState, instantSearchInstance, helper) {
-      var eventName = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'Filter Applied';
-      var filters = convertNumericRefinementsToFilters(refinedState, attribute);
-
-      if (filters && filters.length > 0) {
-        instantSearchInstance.sendEventToInsights({
-          insightsMethod: 'clickedFilters',
-          widgetType: $$type,
-          eventType: 'click',
-          payload: {
-            eventName: eventName,
-            index: helper.getIndex(),
-            filters: filters
-          },
-          attribute: attribute
-        });
-      }
-    };
-
-    var createSendEvent = function createSendEvent(instantSearchInstance, helper, currentRange) {
+    var createSendEvent = function createSendEvent(instantSearchInstance) {
       return function () {
-        for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-          args[_key] = arguments[_key];
-        }
-
-        if (args.length === 1) {
-          instantSearchInstance.sendEventToInsights(args[0]);
+        if (arguments.length === 1) {
+          instantSearchInstance.sendEventToInsights(arguments.length <= 0 ? undefined : arguments[0]);
           return;
         }
-
-        var eventType = args[0],
-            facetValue = args[1],
-            eventName = args[2];
-
-        if (eventType !== 'click') {
-          return;
-        }
-
-        var _facetValue = _slicedToArray(facetValue, 2),
-            nextMin = _facetValue[0],
-            nextMax = _facetValue[1];
-
-        var refinedState = getRefinedState(helper, currentRange, nextMin, nextMax);
-        sendEventWithRefinedState(refinedState, instantSearchInstance, helper, eventName);
       };
     };
 
@@ -237,7 +199,7 @@ var connectRange = function connectRange(renderFn) {
       return [min, max];
     }
 
-    function _refine(instantSearchInstance, helper, currentRange) {
+    function _refine(helper, currentRange) {
       return function () {
         var _ref11 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [undefined, undefined],
             _ref12 = _slicedToArray(_ref11, 2),
@@ -247,7 +209,6 @@ var connectRange = function connectRange(renderFn) {
         var refinedState = getRefinedState(helper, currentRange, nextMin, nextMax);
 
         if (refinedState) {
-          sendEventWithRefinedState(refinedState, instantSearchInstance, helper);
           helper.setState(refinedState).search();
         }
       };
@@ -293,12 +254,12 @@ var connectRange = function connectRange(renderFn) {
           // On first render pass an empty range
           // to be able to bypass the validation
           // related to it
-          refine = _refine(instantSearchInstance, helper, {
+          refine = _refine(helper, {
             min: undefined,
             max: undefined
           });
         } else {
-          refine = _refine(instantSearchInstance, helper, currentRange);
+          refine = _refine(helper, currentRange);
         }
 
         return {
@@ -306,7 +267,7 @@ var connectRange = function connectRange(renderFn) {
           canRefine: currentRange.min !== currentRange.max,
           format: rangeFormatter,
           range: currentRange,
-          sendEvent: createSendEvent(instantSearchInstance, helper, currentRange),
+          sendEvent: createSendEvent(instantSearchInstance),
           widgetParams: _objectSpread(_objectSpread({}, widgetParams), {}, {
             precision: precision
           }),

package/es/connectors/rating-menu/connectRatingMenu.d.ts

@@ -56,6 +56,8 @@ export declare type RatingMenuRenderState = {
     refine: (value: string) => void;
     /**
      * `true` if the last search contains no result.
+     *
+     * @deprecated Use `canRefine` instead.
      */
     hasNoResults: boolean;
     /**

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

@@ -210,6 +210,9 @@ var connectRatingMenu = function connectRatingMenu(renderFn) {
           });
         }
 
+        var refinementIsApplied = false;
+        var totalCount = 0;
+
         if (results) {
           var facetResults = results.getFacetValues(attribute, {});
           var maxValuesPerFacet = facetResults.length;
@@ -225,6 +228,7 @@ var connectRatingMenu = function connectRatingMenu(renderFn) {
 
           var _loop = function _loop(star) {
             var isRefined = refinedStar === star;
+            refinementIsApplied = refinementIsApplied || isRefined;
             var count = facetResults.filter(function (f) {
               return Number(f.name) >= star && Number(f.name) <= max;
             }).map(function (f) {
@@ -232,6 +236,7 @@ var connectRatingMenu = function connectRatingMenu(renderFn) {
             }).reduce(function (sum, current) {
               return sum + current;
             }, 0);
+            totalCount += count;
 
             if (refinedStar && !isRefined && count === 0) {
               // skip count==0 when at least 1 refinement is enabled
@@ -261,10 +266,11 @@ var connectRatingMenu = function connectRatingMenu(renderFn) {
         }
 
         facetValues = facetValues.reverse();
+        var hasNoResults = results ? results.nbHits === 0 : true;
         return {
           items: facetValues,
-          hasNoResults: results ? results.nbHits === 0 : true,
-          canRefine: facetValues.length > 0,
+          hasNoResults: hasNoResults,
+          canRefine: (!hasNoResults || refinementIsApplied) && totalCount > 0,
           refine: connectorState.toggleRefinementFactory(helper),
           sendEvent: sendEvent,
           createURL: connectorState.createURLFactory({

package/es/connectors/sort-by/connectSortBy.d.ts

@@ -43,8 +43,13 @@ export declare type SortByRenderState = {
     refine: (value: string) => void;
     /**
      * `true` if the last search contains no result.
+     * @deprecated Use `canRefine` instead.
      */
     hasNoResults: boolean;
+    /**
+     * `true` if we can refine.
+     */
+    canRefine: boolean;
 };
 export declare type SortByWidgetDescription = {
     $$type: 'ais.sortBy';

package/es/connectors/sort-by/connectSortBy.js

@@ -77,13 +77,15 @@ var connectSortBy = function connectSortBy(renderFn) {
           };
         }
 
+        var hasNoResults = results ? results.nbHits === 0 : true;
         return {
           currentRefinement: state.index,
           options: transformItems(items, {
             results: results
           }),
           refine: connectorState.setIndex,
-          hasNoResults: results ? results.nbHits === 0 : true,
+          hasNoResults: hasNoResults,
+          canRefine: !hasNoResults && items.length > 0,
           widgetParams: widgetParams
         };
       },

package/es/helpers/components/Highlight.d.ts

@@ -0,0 +1,10 @@
+/** @jsx h */
+import { h } from 'preact';
+import type { BaseHit, Hit, PartialKeys } from '../../types';
+import type { HighlightProps as HighlightUiComponentProps } from '../../components/Highlight/Highlight';
+export declare type HighlightProps<THit extends Hit<BaseHit>> = {
+    hit: THit;
+    attribute: keyof THit | string[];
+    cssClasses?: HighlightUiComponentProps['classNames'];
+} & PartialKeys<Omit<HighlightUiComponentProps, 'parts' | 'classNames'>, 'highlightedTagName' | 'nonHighlightedTagName' | 'separator'>;
+export declare function Highlight<THit extends Hit<BaseHit>>({ hit, attribute, cssClasses, ...props }: HighlightProps<THit>): h.JSX.Element;

package/es/helpers/components/Highlight.js

@@ -0,0 +1,31 @@
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+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; }
+
+/** @jsx h */
+import { h } from 'preact';
+import { Highlight as HighlightUiComponent } from "../../components/Highlight/Highlight.js";
+import getHighlightedParts from "../../lib/utils/getHighlightedParts.js";
+import getPropertyByPath from "../../lib/utils/getPropertyByPath.js";
+import unescape from "../../lib/utils/unescape.js";
+import { warning } from "../../lib/utils/logger.js";
+export function Highlight(_ref) {
+  var hit = _ref.hit,
+      attribute = _ref.attribute,
+      cssClasses = _ref.cssClasses,
+      props = _objectWithoutProperties(_ref, ["hit", "attribute", "cssClasses"]);
+
+  var property = getPropertyByPath(hit._highlightResult, attribute) || [];
+  var properties = Array.isArray(property) ? property : [property];
+  process.env.NODE_ENV === 'development' ? warning(Boolean(properties.length), "Could not enable highlight for \"".concat(attribute.toString(), "\", will display an empty string.\nPlease check whether this attribute exists and is either searchable or specified in `attributesToHighlight`.\n\nSee: https://alg.li/highlighting\n")) : void 0;
+  var parts = properties.map(function (_ref2) {
+    var value = _ref2.value;
+    return getHighlightedParts(unescape(value || ''));
+  });
+  return h(HighlightUiComponent, _extends({}, props, {
+    parts: parts,
+    classNames: cssClasses
+  }));
+}

package/es/helpers/components/ReverseHighlight.d.ts

@@ -0,0 +1,10 @@
+/** @jsx h */
+import { h } from 'preact';
+import type { BaseHit, Hit, PartialKeys } from '../../types';
+import type { ReverseHighlightProps as ReverseHighlightUiComponentProps } from '../../components/ReverseHighlight/ReverseHighlight';
+export declare type ReverseHighlightProps<THit extends Hit<BaseHit>> = {
+    hit: THit;
+    attribute: keyof THit | string[];
+    cssClasses?: ReverseHighlightUiComponentProps['classNames'];
+} & PartialKeys<Omit<ReverseHighlightUiComponentProps, 'parts' | 'classNames'>, 'highlightedTagName' | 'nonHighlightedTagName' | 'separator'>;
+export declare function ReverseHighlight<THit extends Hit<BaseHit>>({ hit, attribute, cssClasses, ...props }: ReverseHighlightProps<THit>): h.JSX.Element;