instantsearch.js 4.44.1 → 4.46.0

package/es/components/Answers/Answers.d.ts

@@ -1,11 +1,11 @@
 /** @jsx h */
 import { h } from 'preact';
 import type { AnswersCSSClasses, AnswersTemplates } from '../../widgets/answers/answers';
-import type { ComponentCSSClasses, Hits } from '../../types';
+import type { ComponentCSSClasses, Hit } from '../../types';
 export declare type AnswersComponentCSSClasses = ComponentCSSClasses<AnswersCSSClasses>;
 export declare type AnswersComponentTemplates = Required<AnswersTemplates>;
 export declare type AnswersProps = {
-    hits: Hits;
+    hits: Hit[];
     isLoading: boolean;
     cssClasses: AnswersComponentCSSClasses;
     templateProps: {

package/es/components/Hits/Hits.d.ts

@@ -2,18 +2,18 @@
 import { h } from 'preact';
 import type { SearchResults } from 'algoliasearch-helper';
 import type { BindEventForHits, SendEventForHits } from '../../lib/utils';
-import type { ComponentCSSClasses, Hits as HitsArray } from '../../types';
+import type { ComponentCSSClasses, Hit } from '../../types';
 import type { HitsCSSClasses, HitsTemplates } from '../../widgets/hits/hits';
 import type { PreparedTemplateProps } from '../../lib/utils/prepareTemplateProps';
 export declare type HitsComponentCSSClasses = ComponentCSSClasses<HitsCSSClasses>;
 export declare type HitsComponentTemplates = Required<HitsTemplates>;
 export declare type HitsProps = {
     results: SearchResults;
-    hits: HitsArray;
+    hits: Hit[];
     sendEvent?: SendEventForHits;
     bindEvent?: BindEventForHits;
     cssClasses: HitsComponentCSSClasses;
     templateProps: PreparedTemplateProps<HitsComponentTemplates>;
 };
-declare const Hits: ({ results, hits, bindEvent, cssClasses, templateProps, }: HitsProps) => h.JSX.Element;
+declare const Hits: ({ results, hits, bindEvent, sendEvent, cssClasses, templateProps, }: HitsProps) => h.JSX.Element;
 export default Hits;

package/es/components/Hits/Hits.js

@@ -15,6 +15,7 @@ var Hits = function Hits(_ref) {
   var results = _ref.results,
       hits = _ref.hits,
       bindEvent = _ref.bindEvent,
+      sendEvent = _ref.sendEvent,
       cssClasses = _ref.cssClasses,
       templateProps = _ref.templateProps;
 
@@ -43,7 +44,8 @@ var Hits = function Hits(_ref) {
       data: _objectSpread(_objectSpread({}, hit), {}, {
         __hitIndex: index
       }),
-      bindEvent: bindEvent
+      bindEvent: bindEvent,
+      sendEvent: sendEvent
     }));
   })));
 };

package/es/components/InfiniteHits/InfiniteHits.d.ts

@@ -1,14 +1,14 @@
 /** @jsx h */
 import { h } from 'preact';
 import type { SearchResults } from 'algoliasearch-helper';
-import type { ComponentCSSClasses, Hits } from '../../types';
+import type { ComponentCSSClasses, Hit } from '../../types';
 import type { InfiniteHitsCSSClasses, InfiniteHitsTemplates } from '../../widgets/infinite-hits/infinite-hits';
 import type { SendEventForHits, BindEventForHits } from '../../lib/utils';
 export declare type InfiniteHitsComponentCSSClasses = ComponentCSSClasses<InfiniteHitsCSSClasses>;
 export declare type InfiniteHitsComponentTemplates = Required<InfiniteHitsTemplates>;
 export declare type InfiniteHitsProps = {
     cssClasses: InfiniteHitsComponentCSSClasses;
-    hits: Hits;
+    hits: Hit[];
     results: SearchResults;
     hasShowPrevious: boolean;
     showPrevious: () => void;
@@ -22,5 +22,5 @@ export declare type InfiniteHitsProps = {
     sendEvent: SendEventForHits;
     bindEvent: BindEventForHits;
 };
-declare const InfiniteHits: ({ results, hits, bindEvent, hasShowPrevious, showPrevious, showMore, isFirstPage, isLastPage, cssClasses, templateProps, }: InfiniteHitsProps) => h.JSX.Element;
+declare const InfiniteHits: ({ results, hits, bindEvent, sendEvent, hasShowPrevious, showPrevious, showMore, isFirstPage, isLastPage, cssClasses, templateProps, }: InfiniteHitsProps) => h.JSX.Element;
 export default InfiniteHits;

package/es/components/InfiniteHits/InfiniteHits.js

@@ -15,6 +15,7 @@ var InfiniteHits = function InfiniteHits(_ref) {
   var results = _ref.results,
       hits = _ref.hits,
       bindEvent = _ref.bindEvent,
+      sendEvent = _ref.sendEvent,
       hasShowPrevious = _ref.hasShowPrevious,
       showPrevious = _ref.showPrevious,
       showMore = _ref.showMore,
@@ -56,7 +57,8 @@ var InfiniteHits = function InfiniteHits(_ref) {
       data: _objectSpread(_objectSpread({}, hit), {}, {
         __hitIndex: position
       }),
-      bindEvent: bindEvent
+      bindEvent: bindEvent,
+      sendEvent: sendEvent
     }));
   })), h(Template, _extends({}, templateProps, {
     templateKey: "showMoreText",

package/es/components/Template/Template.d.ts

@@ -1,6 +1,7 @@
 /** @jsx h */
 import type { JSX } from 'preact';
 import { Component } from 'preact';
+import type { BindEventForHits, SendEventForHits } from '../../lib/utils';
 import type { PreparedTemplateProps } from '../../lib/utils/prepareTemplateProps';
 import type { Templates } from '../../types';
 declare const defaultProps: {
@@ -10,12 +11,13 @@ declare const defaultProps: {
     templates: {};
     templatesConfig: {};
 };
-declare type TemplateProps = {
+export declare type TemplateProps = {
     data?: Record<string, any>;
     rootProps?: Record<string, any>;
     rootTagName?: keyof JSX.IntrinsicElements;
     templateKey: string;
-    bindEvent?: (...args: any[]) => string;
+    bindEvent?: BindEventForHits;
+    sendEvent?: SendEventForHits;
 } & PreparedTemplateProps<Templates> & Readonly<typeof defaultProps>;
 declare class Template extends Component<TemplateProps> {
     static readonly defaultProps: {

package/es/components/Template/Template.js

@@ -1,7 +1,7 @@
-function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
-
 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 _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
@@ -26,7 +26,7 @@ function _defineProperty(obj, key, value) { if (key in obj) { Object.definePrope
 
 /** @jsx h */
 import { h, Component } from 'preact';
-import { renderTemplate, isEqual } from "../../lib/utils/index.js";
+import { warning, renderTemplate, isEqual } from "../../lib/utils/index.js";
 var defaultProps = {
   data: {},
   rootTagName: 'div',
@@ -55,6 +55,11 @@ var Template = /*#__PURE__*/function (_Component) {
   }, {
     key: "render",
     value: function render() {
+      var _this = this;
+
+      process.env.NODE_ENV === 'development' ? warning(Object.keys(this.props.templates).every(function (key) {
+        return typeof _this.props.templates[key] === 'function';
+      }), "Hogan.js and string-based templates are deprecated and will not be supported in InstantSearch.js 5.x.\n\nYou can replace them with function-form templates and use either the provided `html` function or JSX templates.\n\nSee: https://www.algolia.com/doc/guides/building-search-ui/upgrade-guides/js/#upgrade-templates") : void 0;
       var RootTagName = this.props.rootTagName;
       var useCustomCompileOptions = this.props.useCustomCompileOptions[this.props.templateKey];
       var compileOptions = useCustomCompileOptions ? this.props.templatesConfig.compileOptions : {};
@@ -64,7 +69,8 @@ var Template = /*#__PURE__*/function (_Component) {
         compileOptions: compileOptions,
         helpers: this.props.templatesConfig.helpers,
         data: this.props.data,
-        bindEvent: this.props.bindEvent
+        bindEvent: this.props.bindEvent,
+        sendEvent: this.props.sendEvent
       });
 
       if (content === null) {
@@ -73,6 +79,10 @@ var Template = /*#__PURE__*/function (_Component) {
         return null;
       }
 
+      if (_typeof(content) === 'object') {
+        return h(RootTagName, this.props.rootProps, content);
+      }
+
       return h(RootTagName, _extends({}, this.props.rootProps, {
         dangerouslySetInnerHTML: {
           __html: content

package/es/connectors/answers/connectAnswers.d.ts

@@ -1,9 +1,9 @@
-import type { Connector, Hits, FindAnswersOptions, WidgetRenderState } from '../../types';
+import type { Connector, Hit, FindAnswersOptions, WidgetRenderState } from '../../types';
 export declare type AnswersRenderState = {
     /**
      * The matched hits from Algolia API.
      */
-    hits: Hits;
+    hits: Hit[];
     /**
      * Whether it's still loading the results from the Answers API.
      */

package/es/connectors/autocomplete/connectAutocomplete.d.ts

@@ -1,6 +1,6 @@
 import type { SearchResults } from 'algoliasearch-helper';
 import type { SendEventForHits } from '../../lib/utils';
-import type { Hits, Connector, WidgetRenderState } from '../../types';
+import type { Hit, Connector, WidgetRenderState } from '../../types';
 export declare type AutocompleteConnectorParams = {
     /**
      * Escapes HTML entities from hits string values.
@@ -25,7 +25,7 @@ export declare type AutocompleteRenderState = {
         /**
          * The resolved hits from the index matching the query.
          */
-        hits: Hits;
+        hits: Hit[];
         /**
          * The full results object from the Algolia API.
          */

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."); }
@@ -177,12 +179,35 @@ var connectNumericMenu = function connectNumericMenu(renderFn) {
           });
         }
 
+        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/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,8 +210,11 @@ var connectRatingMenu = function connectRatingMenu(renderFn) {
           });
         }
 
-        if (results) {
-          var facetResults = results.getFacetValues(attribute, {});
+        var refinementIsApplied = false;
+        var totalCount = 0;
+        var facetResults = results === null || results === void 0 ? void 0 : results.getFacetValues(attribute, {});
+
+        if (results && facetResults) {
           var maxValuesPerFacet = facetResults.length;
           var maxDecimalPlaces = getFacetsMaxDecimalPlaces(facetResults);
           var maxFacets = Math.pow(10, maxDecimalPlaces) * max;
@@ -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/lib/createHelpers.js

@@ -5,11 +5,12 @@ 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 { highlight as _highlight, reverseHighlight as _reverseHighlight, snippet as _snippet, reverseSnippet as _reverseSnippet, insights as _insights } from "../helpers/index.js";
+import { formatNumber as _formatNumber } from "./formatNumber.js";
 export default function hoganHelpers(_ref) {
   var numberLocale = _ref.numberLocale;
   return {
     formatNumber: function formatNumber(value, render) {
-      return Number(render(value)).toLocaleString(numberLocale);
+      return _formatNumber(Number(render(value)), numberLocale);
     },
     highlight: function highlight(options, render) {
       try {

package/es/lib/formatNumber.d.ts

@@ -0,0 +1 @@
+export declare function formatNumber(value: number, numberLocale?: string): string;

package/es/lib/formatNumber.js

@@ -0,0 +1,3 @@
+export function formatNumber(value, numberLocale) {
+  return value.toLocaleString(numberLocale);
+}

package/es/lib/insights/client.d.ts

@@ -1,9 +1,9 @@
 import type { SearchResults } from 'algoliasearch-helper';
-import type { Hits, InsightsClientMethod, InsightsClientPayload, Connector } from '../../types';
+import type { Hit, InsightsClientMethod, InsightsClientPayload, Connector } from '../../types';
 export declare const inferPayload: ({ method, results, hits, objectIDs, }: {
     method: InsightsClientMethod;
     results: SearchResults;
-    hits: Hits;
+    hits: Hit[];
     objectIDs: string[];
 }) => Omit<InsightsClientPayload, 'eventName'>;
 /**

package/es/lib/utils/createSendEventForHits.d.ts

@@ -1,11 +1,11 @@
 /**
  * @jest-environment jsdom
  */
-import type { InstantSearch, Hit, Hits } from '../../types';
-declare type BuiltInSendEventForHits = (eventType: string, hits: Hit | Hits, eventName?: string) => void;
+import type { InstantSearch, Hit } from '../../types';
+declare type BuiltInSendEventForHits = (eventType: string, hits: Hit | Hit[], eventName?: string) => void;
 declare type CustomSendEventForHits = (customPayload: any) => void;
 export declare type SendEventForHits = BuiltInSendEventForHits & CustomSendEventForHits;
-declare type BuiltInBindEventForHits = (eventType: string, hits: Hit | Hits, eventName?: string) => string;
+declare type BuiltInBindEventForHits = (eventType: string, hits: Hit | Hit[], eventName?: string) => string;
 declare type CustomBindEventForHits = (customPayload: any) => string;
 export declare type BindEventForHits = BuiltInBindEventForHits & CustomBindEventForHits;
 export declare function createSendEventForHits({ instantSearchInstance, index, widgetType, }: {

package/es/lib/utils/cx.d.ts

@@ -0,0 +1 @@
+export declare function cx(cssClasses?: string | string[] | undefined): string;

package/es/lib/utils/cx.js

@@ -0,0 +1,3 @@
+export function cx(cssClasses) {
+  return Array.isArray(cssClasses) ? cssClasses.filter(Boolean).join(' ') : cssClasses || '';
+}

package/es/lib/utils/index.d.ts

@@ -45,3 +45,4 @@ export { debounce } from './debounce';
 export { serializePayload, deserializePayload } from './serializer';
 export { getWidgetAttribute } from './getWidgetAttribute';
 export { safelyRunOnBrowser } from './safelyRunOnBrowser';
+export { cx } from './cx';

package/es/lib/utils/index.js

@@ -44,4 +44,5 @@ export { createConcurrentSafePromise } from "./createConcurrentSafePromise.js";
 export { debounce } from "./debounce.js";
 export { serializePayload, deserializePayload } from "./serializer.js";
 export { getWidgetAttribute } from "./getWidgetAttribute.js";
-export { safelyRunOnBrowser } from "./safelyRunOnBrowser.js";
+export { safelyRunOnBrowser } from "./safelyRunOnBrowser.js";
+export { cx } from "./cx.js";

package/es/lib/utils/renderTemplate.d.ts

@@ -1,12 +1,13 @@
 import type { HoganOptions } from 'hogan.js';
 import type { Templates, HoganHelpers } from '../../types';
-import type { BindEventForHits } from './createSendEventForHits';
-declare function renderTemplate({ templates, templateKey, compileOptions, helpers, data, bindEvent, }: {
+import type { BindEventForHits, SendEventForHits } from './createSendEventForHits';
+declare function renderTemplate({ templates, templateKey, compileOptions, helpers, data, bindEvent, sendEvent, }: {
     templates: Templates;
     templateKey: string;
     compileOptions?: HoganOptions;
     helpers?: HoganHelpers;
     data?: Record<string, any>;
     bindEvent?: BindEventForHits;
-}): string;
+    sendEvent?: SendEventForHits;
+}): string | import("preact").VNode<{}> | import("preact").VNode<{}>[];
 export default renderTemplate;

package/es/lib/utils/renderTemplate.js

@@ -7,6 +7,8 @@ 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 hogan from 'hogan.js';
+import { Highlight, ReverseHighlight, ReverseSnippet, Snippet } from "../../helpers/components/index.js";
+import { html } from 'htm/preact';
 
 // We add all our template helper methods to the template as lambdas. Note
 // that lambdas in Mustache are supposed to accept a second argument of
@@ -37,7 +39,8 @@ function renderTemplate(_ref) {
       compileOptions = _ref.compileOptions,
       helpers = _ref.helpers,
       data = _ref.data,
-      bindEvent = _ref.bindEvent;
+      bindEvent = _ref.bindEvent,
+      sendEvent = _ref.sendEvent;
   var template = templates[templateKey];
 
   if (typeof template !== 'string' && typeof template !== 'function') {
@@ -45,7 +48,17 @@ function renderTemplate(_ref) {
   }
 
   if (typeof template === 'function') {
-    return template(data, bindEvent);
+    // @MAJOR no longer pass bindEvent when string templates are removed
+    var params = bindEvent || {};
+    params.html = html;
+    params.sendEvent = sendEvent;
+    params.components = {
+      Highlight: Highlight,
+      ReverseHighlight: ReverseHighlight,
+      Snippet: Snippet,
+      ReverseSnippet: ReverseSnippet
+    };
+    return template(data, params);
   }
 
   var transformedHelpers = transformHelpersToHogan(helpers, compileOptions, data);

package/es/lib/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "4.44.1";
+declare const _default: "4.46.0";
 export default _default;

package/es/lib/version.js

@@ -1 +1 @@
-export default '4.44.1';
+export default '4.46.0';

package/es/types/connector.d.ts

@@ -1,7 +1,7 @@
 import type { SearchResults } from 'algoliasearch-helper';
 import type { InstantSearch } from './instantsearch';
 import type { InsightsClient } from './insights';
-import type { Hits } from './results';
+import type { Hit } from './results';
 import type { UnknownWidgetParams, Widget, WidgetDescription } from './widget';
 /**
  * The base renderer options. All render functions receive
@@ -25,7 +25,7 @@ export declare type RendererOptions<TWidgetParams> = {
      * The mutable list of hits. The may change depending
      * of the given transform items function.
      */
-    hits?: Hits;
+    hits?: Hit[];
     /**
      * The current insights client, if any.
      */

package/es/types/templates.d.ts

@@ -1,6 +1,19 @@
-import type { BindEventForHits } from '../lib/utils';
-export declare type Template<TTemplateData = void> = string | ((data: TTemplateData) => string);
-export declare type TemplateWithBindEvent<TTemplateData = void> = string | ((data: TTemplateData, bindEvent: BindEventForHits) => string);
+import type { VNode } from 'preact';
+import type { Highlight, ReverseHighlight, ReverseSnippet, Snippet } from '../helpers/components';
+import type { html } from 'htm/preact';
+import type { BindEventForHits, SendEventForHits } from '../lib/utils';
+export declare type Template<TTemplateData = void> = string | ((data: TTemplateData, params: TemplateParams) => VNode | VNode[] | string);
+export declare type TemplateParams = BindEventForHits & {
+    html: typeof html;
+    components: {
+        Highlight: typeof Highlight;
+        ReverseHighlight: typeof ReverseHighlight;
+        Snippet: typeof Snippet;
+        ReverseSnippet: typeof ReverseSnippet;
+    };
+    sendEvent?: SendEventForHits;
+};
+export declare type TemplateWithBindEvent<TTemplateData = void> = string | ((data: TTemplateData, params: TemplateParams) => VNode | VNode[] | string);
 export declare type Templates = {
     [key: string]: Template<any> | TemplateWithBindEvent<any> | undefined;
 };

package/es/widgets/answers/defaultTemplates.js

@@ -1,6 +1,10 @@
 var defaultTemplates = {
-  header: '',
-  loader: '',
+  header: function header() {
+    return '';
+  },
+  loader: function loader() {
+    return '';
+  },
   item: function item(_item) {
     return JSON.stringify(_item);
   }

package/es/widgets/breadcrumb/defaultTemplates.js

@@ -1,5 +1,9 @@
 var defaultTemplates = {
-  home: 'Home',
-  separator: '>'
+  home: function home() {
+    return 'Home';
+  },
+  separator: function separator() {
+    return '>';
+  }
 };
 export default defaultTemplates;

package/es/widgets/clear-refinements/clear-refinements.d.ts

@@ -19,7 +19,9 @@ export declare type ClearRefinementsTemplates = Partial<{
     /**
      * Template for the content of the button
      */
-    resetLabel: Template;
+    resetLabel: Template<{
+        hasRefinements: boolean;
+    }>;
 }>;
 export declare type ClearRefinementsWidgetParams = {
     /**

package/es/widgets/clear-refinements/clear-refinements.js

@@ -24,7 +24,7 @@ var renderer = function renderer(_ref) {
       templates = _ref.templates;
   return function (_ref2, isFirstRendering) {
     var refine = _ref2.refine,
-        hasRefinements = _ref2.hasRefinements,
+        canRefine = _ref2.canRefine,
         instantSearchInstance = _ref2.instantSearchInstance;
 
     if (isFirstRendering) {
@@ -39,7 +39,7 @@ var renderer = function renderer(_ref) {
     render(h(ClearRefinements, {
       refine: refine,
       cssClasses: cssClasses,
-      hasRefinements: hasRefinements,
+      hasRefinements: canRefine,
       templateProps: renderState.templateProps
     }), containerNode);
   };

package/es/widgets/clear-refinements/defaultTemplates.js

@@ -1,4 +1,6 @@
 var defaultTemplates = {
-  resetLabel: 'Clear refinements'
+  resetLabel: function resetLabel() {
+    return 'Clear refinements';
+  }
 };
 export default defaultTemplates;