instantsearch.js 4.55.0 → 4.56.0

package/es/connectors/current-refinements/connectCurrentRefinements.d.ts

@@ -53,7 +53,7 @@ export type CurrentRefinementsConnectorParamsItem = {
     /**
      * Removes the given refinement and triggers a new search.
      */
-    refine(refinement: CurrentRefinementsConnectorParamsRefinement): void;
+    refine: (refinement: CurrentRefinementsConnectorParamsRefinement) => void;
 };
 export type CurrentRefinementsConnectorParams = {
     /**
@@ -87,7 +87,7 @@ export type CurrentRefinementsRenderState = {
     /**
      * Removes the given refinement and triggers a new search.
      */
-    refine(refinement: CurrentRefinementsConnectorParamsRefinement): void;
+    refine: (refinement: CurrentRefinementsConnectorParamsRefinement) => void;
     /**
      * Generates a URL for the next state.
      */

package/es/connectors/dynamic-widgets/connectDynamicWidgets.d.ts

@@ -11,10 +11,10 @@ export type DynamicWidgetsConnectorParams = {
      * Function to return a fallback widget when an attribute isn't found in
      * `widgets`.
      */
-    fallbackWidget?(args: {
+    fallbackWidget?: (args: {
         /** The attribute name to create a widget for. */
         attribute: string;
-    }): Widget;
+    }) => Widget;
     /**
      * Function to transform the items to render.
      * The function also exposes the full search response.

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

@@ -15,7 +15,7 @@ export type GeoSearchRenderState<THit extends BaseHit = Record<string, any>> = {
     /**
      * Reset the current bounding box refinement.
      */
-    clearMapRefinement(): void;
+    clearMapRefinement: () => void;
     /**
      * The current bounding box of the search.
      */
@@ -23,15 +23,15 @@ export type GeoSearchRenderState<THit extends BaseHit = Record<string, any>> = {
     /**
      * Return true if the map has move since the last refinement.
      */
-    hasMapMoveSinceLastRefine(): boolean;
+    hasMapMoveSinceLastRefine: () => boolean;
     /**
      * Return true if the current refinement is set with the map bounds.
      */
-    isRefinedWithMap(): boolean;
+    isRefinedWithMap: () => boolean;
     /**
      * Return true if the user is able to refine on map move.
      */
-    isRefineOnMapMove(): boolean;
+    isRefineOnMapMove: () => boolean;
     /**
      * The matched hits from Algolia API.
      */
@@ -43,7 +43,7 @@ export type GeoSearchRenderState<THit extends BaseHit = Record<string, any>> = {
     /**
      * Sets a bounding box to filter the results from the given map bounds.
      */
-    refine(bounds: Bounds): void;
+    refine: (bounds: Bounds) => void;
     /**
      * Send event to insights middleware
      */
@@ -53,11 +53,11 @@ export type GeoSearchRenderState<THit extends BaseHit = Record<string, any>> = {
      * called on each map move. The call to the function triggers a new rendering
      * only when the value change.
      */
-    setMapMoveSinceLastRefine(): void;
+    setMapMoveSinceLastRefine: () => void;
     /**
      * Toggle the fact that the user is able to refine on map move.
      */
-    toggleRefineOnMapMove(): void;
+    toggleRefineOnMapMove: () => void;
 };
 export type GeoSearchConnectorParams<THit extends BaseHit = Record<string, any>> = {
     /**

package/es/connectors/infinite-hits/connectInfiniteHits.js

@@ -14,7 +14,7 @@ function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToAr
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 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; }
-import { escapeHits, TAG_PLACEHOLDER, checkRendering, createDocumentationMessageGenerator, isEqual, addAbsolutePosition, addQueryID, noop, createSendEventForHits, createBindEventForHits } from "../../lib/utils/index.js";
+import { escapeHits, TAG_PLACEHOLDER, checkRendering, createDocumentationMessageGenerator, isEqual, addAbsolutePosition, addQueryID, noop, createSendEventForHits, createBindEventForHits, walkIndex } from "../../lib/utils/index.js";
 var withUsage = createDocumentationMessageGenerator({
   name: 'infinite-hits',
   connector: true
@@ -165,6 +165,7 @@ var connectInfiniteHits = function connectInfiniteHits(renderFn) {
           });
           isFirstPage = state.page === undefined || getFirstReceivedPage(state, cachedHits) === 0;
         } else {
+          var _results$disjunctiveF, _results$facets, _results$hierarchical;
           var _state$page3 = state.page,
             _page = _state$page3 === void 0 ? 0 : _state$page3;
           if (escapeHTML && results.hits.length > 0) {
@@ -175,7 +176,21 @@ var connectInfiniteHits = function connectInfiniteHits(renderFn) {
           var transformedHits = transformItems(hitsWithAbsolutePositionAndQueryID, {
             results: results
           });
-          if (cachedHits[_page] === undefined && !results.__isArtificial && instantSearchInstance.status === 'idle') {
+
+          /*
+            With dynamic widgets, facets are not included in the state before their relevant widgets are mounted. Until then, we need to bail out of writing this incomplete state representation in cache.
+          */
+          var hasDynamicWidgets = false;
+          walkIndex(instantSearchInstance.mainIndex, function (indexWidget) {
+            if (!hasDynamicWidgets && indexWidget.getWidgets().some(function (_ref7) {
+              var $$type = _ref7.$$type;
+              return $$type === 'ais.dynamicWidgets';
+            })) {
+              hasDynamicWidgets = true;
+            }
+          });
+          var hasNoFacets = !((_results$disjunctiveF = results.disjunctiveFacets) !== null && _results$disjunctiveF !== void 0 && _results$disjunctiveF.length) && !((_results$facets = results.facets) !== null && _results$facets !== void 0 && _results$facets.length) && !((_results$hierarchical = results.hierarchicalFacets) !== null && _results$hierarchical !== void 0 && _results$hierarchical.length);
+          if (cachedHits[_page] === undefined && !results.__isArtificial && instantSearchInstance.status === 'idle' && !(hasDynamicWidgets && hasNoFacets)) {
             cachedHits[_page] = transformedHits;
             cache.write({
               state: normalizeState(state),
@@ -200,8 +215,8 @@ var connectInfiniteHits = function connectInfiniteHits(renderFn) {
           widgetParams: widgetParams
         };
       },
-      dispose: function dispose(_ref7) {
-        var state = _ref7.state;
+      dispose: function dispose(_ref8) {
+        var state = _ref8.state;
         unmountFn();
         var stateWithoutPage = state.setQueryParameter('page', undefined);
         if (!escapeHTML) {
@@ -211,8 +226,8 @@ var connectInfiniteHits = function connectInfiniteHits(renderFn) {
           return _objectSpread(_objectSpread({}, acc), {}, _defineProperty({}, key, undefined));
         }, {}));
       },
-      getWidgetUiState: function getWidgetUiState(uiState, _ref8) {
-        var searchParameters = _ref8.searchParameters;
+      getWidgetUiState: function getWidgetUiState(uiState, _ref9) {
+        var searchParameters = _ref9.searchParameters;
         var page = searchParameters.page || 0;
         if (!page) {
           // return without adding `page` to uiState
@@ -225,8 +240,8 @@ var connectInfiniteHits = function connectInfiniteHits(renderFn) {
           page: page + 1
         });
       },
-      getWidgetSearchParameters: function getWidgetSearchParameters(searchParameters, _ref9) {
-        var uiState = _ref9.uiState;
+      getWidgetSearchParameters: function getWidgetSearchParameters(searchParameters, _ref10) {
+        var uiState = _ref10.uiState;
         var widgetSearchParameters = searchParameters;
         if (escapeHTML) {
           widgetSearchParameters = searchParameters.setQueryParameters(TAG_PLACEHOLDER);

package/es/connectors/menu/connectMenu.d.ts

@@ -61,7 +61,7 @@ export type MenuRenderState = {
     /**
      * Filter the search to item value.
      */
-    refine(value: string): void;
+    refine: (value: string) => void;
     /**
      * True if refinement can be applied.
      */
@@ -73,7 +73,7 @@ export type MenuRenderState = {
     /**
      * Toggles the number of values displayed between `limit` and `showMore.limit`.
      */
-    toggleShowMore(): void;
+    toggleShowMore: () => void;
     /**
      * `true` if the toggleShowMore button can be activated (enough items to display more or
      * already displaying more than `limit` items)

package/es/connectors/pagination/connectPagination.d.ts

@@ -14,7 +14,7 @@ export type PaginationRenderState = {
     /** Creates URLs for the next state, the number is the page to generate the URL for. */
     createURL: CreateURL<number>;
     /** Sets the current page and triggers a search. */
-    refine(page: number): void;
+    refine: (page: number) => void;
     /** true if this search returned more than one page */
     canRefine: boolean;
     /** The number of the page currently displayed. */

package/es/connectors/range/connectRange.d.ts

@@ -14,7 +14,7 @@ export type RangeRenderState = {
      * previously set bound or to set an infinite bound.
      * @param rangeValue tuple of [min, max] bounds
      */
-    refine(rangeValue: RangeBoundaries): void;
+    refine: (rangeValue: RangeBoundaries) => void;
     /**
      * Indicates whether this widget can be refined
      */
@@ -36,8 +36,8 @@ export type RangeRenderState = {
      * Both functions take a `number` as input and should output a `string`.
      */
     format: {
-        from(fromValue: number): string;
-        to(toValue: number): string;
+        from: (fromValue: number) => string;
+        to: (toValue: number) => string;
     };
 };
 export type RangeConnectorParams = {

package/es/connectors/refinement-list/connectRefinementList.d.ts

@@ -79,7 +79,7 @@ export type RefinementListRenderState = {
     /**
      * Action to apply selected refinements.
      */
-    refine(value: string): void;
+    refine: (value: string) => void;
     /**
      * Send event to insights middleware
      */
@@ -87,7 +87,7 @@ export type RefinementListRenderState = {
     /**
      * Searches for values inside the list.
      */
-    searchForItems(query: string): void;
+    searchForItems: (query: string) => void;
     /**
      * `true` if the values are from an index search.
      */
@@ -108,7 +108,7 @@ export type RefinementListRenderState = {
     /**
      * Toggles the number of values displayed between `limit` and `showMoreLimit`.
      */
-    toggleShowMore(): void;
+    toggleShowMore: () => void;
 };
 export type RefinementListWidgetDescription = {
     $$type: 'ais.refinementList';

package/es/connectors/relevant-sort/connectRelevantSort.d.ts

@@ -1,6 +1,6 @@
 import type { Connector, WidgetRenderState } from '../../types';
 export type RelevantSortConnectorParams = Record<string, unknown>;
-type Refine = (relevancyStrictness: number) => void;
+type Refine = (relevancyStrictness: number | undefined) => void;
 export type RelevantSortRenderState = {
     /**
      * Indicates if it has appliedRelevancyStrictness greater than zero

package/es/lib/InstantSearch.d.ts

@@ -10,9 +10,9 @@ type NoInfer<T> = T extends infer S ? S : never;
  */
 export type InstantSearchOptions<TUiState extends UiState = UiState, TRouteState = TUiState> = {
     /**
-     * The name of the main index
+     * The name of the main index. If no indexName is provided, you have to manually add an index widget.
      */
-    indexName: string;
+    indexName?: string;
     /**
      * The search client to plug to InstantSearch.js
      *
@@ -61,7 +61,7 @@ export type InstantSearchOptions<TUiState extends UiState = UiState, TRouteState
      */
     onStateChange?: (params: {
         uiState: TUiState;
-        setUiState(uiState: TUiState | ((previousUiState: TUiState) => TUiState)): void;
+        setUiState: (uiState: TUiState | ((previousUiState: TUiState) => TUiState)) => void;
     }) => void;
     /**
      * Injects a `uiState` to the `instantsearch` instance. You can use this option
@@ -122,8 +122,8 @@ declare class InstantSearch<TUiState extends UiState = UiState, TRouteState = TU
     _searchFunction?: InstantSearchOptions['searchFunction'];
     _mainHelperSearch?: AlgoliaSearchHelper['search'];
     middleware: Array<{
-        creator: Middleware;
-        instance: MiddlewareDefinition;
+        creator: Middleware<TUiState>;
+        instance: MiddlewareDefinition<TUiState>;
     }>;
     sendEventToInsights: (event: InsightsEvent) => void;
     /**
@@ -143,11 +143,11 @@ declare class InstantSearch<TUiState extends UiState = UiState, TRouteState = TU
     /**
      * Hooks a middleware into the InstantSearch lifecycle.
      */
-    use(...middleware: Middleware[]): this;
+    use(...middleware: Array<Middleware<TUiState>>): this;
     /**
      * Removes a middleware from the InstantSearch lifecycle.
      */
-    unuse(...middlewareToUnuse: Middleware[]): this;
+    unuse(...middlewareToUnuse: Array<Middleware<TUiState>>): this;
     EXPERIMENTAL_use(...middleware: Middleware[]): this;
     /**
      * Adds a widget to the search instance.
@@ -193,12 +193,12 @@ declare class InstantSearch<TUiState extends UiState = UiState, TRouteState = TU
      */
     dispose(): void;
     scheduleSearch: (() => void) & {
-        wait(): Promise<void>;
-        cancel(): void;
+        wait: () => Promise<void>;
+        cancel: () => void;
     };
     scheduleRender: ((shouldResetStatus?: boolean) => void) & {
-        wait(): Promise<void>;
-        cancel(): void;
+        wait: () => Promise<void>;
+        cancel: () => void;
     };
     scheduleStalledRender(): void;
     /**
@@ -209,8 +209,8 @@ declare class InstantSearch<TUiState extends UiState = UiState, TRouteState = TU
     setUiState(uiState: TUiState | ((previousUiState: TUiState) => TUiState), callOnStateChange?: boolean): void;
     getUiState(): TUiState;
     onInternalStateChange: (() => void) & {
-        wait(): Promise<void>;
-        cancel(): void;
+        wait: () => Promise<void>;
+        cancel: () => void;
     };
     createURL(nextState?: TUiState): string;
     refresh(): void;

package/es/lib/InstantSearch.js

@@ -21,7 +21,7 @@ import { createMetadataMiddleware, isMetadataEnabled } from "../middlewares/crea
 import { createRouterMiddleware } from "../middlewares/createRouterMiddleware.js";
 import index from "../widgets/index/index.js";
 import createHelpers from "./createHelpers.js";
-import { createDocumentationMessageGenerator, createDocumentationLink, defer, noop, warning, setIndexHelperState } from "./utils/index.js";
+import { createDocumentationMessageGenerator, createDocumentationLink, defer, noop, warning, setIndexHelperState, isIndexWidget } from "./utils/index.js";
 import version from "./version.js";
 var withUsage = createDocumentationMessageGenerator({
   name: 'instantsearch'
@@ -100,7 +100,7 @@ var InstantSearch = /*#__PURE__*/function (_EventEmitter) {
     }));
     _this.setMaxListeners(100);
     var _options$indexName = options.indexName,
-      indexName = _options$indexName === void 0 ? null : _options$indexName,
+      indexName = _options$indexName === void 0 ? '' : _options$indexName,
       numberLocale = options.numberLocale,
       _options$initialUiSta = options.initialUiState,
       initialUiState = _options$initialUiSta === void 0 ? {} : _options$initialUiSta,
@@ -117,9 +117,6 @@ var InstantSearch = /*#__PURE__*/function (_EventEmitter) {
       insightsClient = _options$insightsClie === void 0 ? null : _options$insightsClie,
       _options$onStateChang = options.onStateChange,
       onStateChange = _options$onStateChang === void 0 ? null : _options$onStateChang;
-    if (indexName === null) {
-      throw new Error(withUsage('The `indexName` option is required.'));
-    }
     if (searchClient === null) {
       throw new Error(withUsage('The `searchClient` option is required.'));
     }
@@ -361,6 +358,7 @@ var InstantSearch = /*#__PURE__*/function (_EventEmitter) {
       mainHelper.search = function () {
         _this3.status = 'loading';
         _this3.scheduleRender(false);
+        process.env.NODE_ENV === 'development' ? warning(Boolean(_this3.indexName) || _this3.mainIndex.getWidgets().some(isIndexWidget), 'No indexName provided, nor an explicit index widget in the widgets tree. This is required to be able to display results.') : void 0;
 
         // This solution allows us to keep the exact same API for the users but
         // under the hood, we have a different implementation. It should be

package/es/lib/routers/history.d.ts

@@ -14,7 +14,7 @@ export type BrowserHistoryArgs<TRouteState> = {
     writeDelay: number;
     createURL: CreateURL<TRouteState>;
     parseURL: ParseURL<TRouteState>;
-    getLocation(): Location;
+    getLocation: () => Location;
     start?: (onUpdate: () => void) => void;
     dispose?: () => void;
     push?: (url: string) => void;
@@ -49,7 +49,7 @@ declare class BrowserHistory<TRouteState> implements Router<TRouteState> {
      */
     private readonly getLocation;
     private writeTimer?;
-    private _onPopState;
+    private _onPopState?;
     /**
      * Indicates if last action was back/forward in the browser.
      */

package/es/lib/routers/history.js

@@ -6,7 +6,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
 function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
 import qs from 'qs';
-import { safelyRunOnBrowser } from "../utils/index.js";
+import { safelyRunOnBrowser, warning } from "../utils/index.js";
 var setWindowTitle = function setWindowTitle(title) {
   if (title) {
     // This function is only executed on browsers so we can disable this check.
@@ -15,6 +15,48 @@ var setWindowTitle = function setWindowTitle(title) {
   }
 };
 var BrowserHistory = /*#__PURE__*/function () {
+  /**
+   * Transforms a UI state into a title for the page.
+   */
+
+  /**
+   * Time in milliseconds before performing a write in the history.
+   * It prevents from adding too many entries in the history and
+   * makes the back button more usable.
+   *
+   * @default 400
+   */
+
+  /**
+   * Creates a full URL based on the route state.
+   * The storage adaptor maps all syncable keys to the query string of the URL.
+   */
+
+  /**
+   * Parses the URL into a route state.
+   * It should be symmetrical to `createURL`.
+   */
+
+  /**
+   * Returns the location to store in the history.
+   * @default () => window.location
+   */
+
+  /**
+   * Indicates if last action was back/forward in the browser.
+   */
+
+  /**
+   * Indicates whether the history router is disposed or not.
+   */
+
+  /**
+   * Indicates the window.history.length before the last call to
+   * window.history.pushState (called in `write`).
+   * It allows to determine if a `pushState` has been triggered elsewhere,
+   * and thus to prevent the `write` method from calling `pushState`.
+   */
+
   /**
    * Initializes a new storage provider that syncs the search state to the URL
    * using web APIs (`window.location.pushState` and `onpopstate` event).
@@ -38,6 +80,7 @@ var BrowserHistory = /*#__PURE__*/function () {
     _defineProperty(this, "parseURL", void 0);
     _defineProperty(this, "getLocation", void 0);
     _defineProperty(this, "writeTimer", void 0);
+    _defineProperty(this, "_onPopState", void 0);
     _defineProperty(this, "inPopState", false);
     _defineProperty(this, "isDisposed", false);
     _defineProperty(this, "latestAcknowledgedHistory", 0);
@@ -143,11 +186,21 @@ var BrowserHistory = /*#__PURE__*/function () {
   }, {
     key: "createURL",
     value: function createURL(routeState) {
-      return this._createURL({
+      var url = this._createURL({
         qsModule: qs,
         routeState: routeState,
         location: this.getLocation()
       });
+      if (process.env.NODE_ENV === 'development') {
+        try {
+          // We just want to check if the URL is valid.
+          // eslint-disable-next-line no-new
+          new URL(url);
+        } catch (e) {
+          process.env.NODE_ENV === 'development' ? warning(false, "The URL returned by the `createURL` function is invalid.\nPlease make sure it returns an absolute URL to avoid issues, e.g: `https://algolia.com/search?query=iphone`.") : void 0;
+        }
+      }
+      return url;
     }
 
     /**

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

@@ -1,7 +1,7 @@
 type Callback = (...args: any[]) => void;
 type Defer = {
-    wait(): Promise<void>;
-    cancel(): void;
+    wait: () => Promise<void>;
+    cancel: () => void;
 };
 export declare function defer<TCallback extends Callback>(callback: TCallback): TCallback & Defer;
 export {};

package/es/lib/utils/render-args.js

@@ -19,13 +19,14 @@ export function createInitArgs(instantSearchInstance, parent, uiState) {
 }
 export function createRenderArgs(instantSearchInstance, parent) {
   var results = parent.getResults();
+  var helper = parent.getHelper();
   return {
-    helper: parent.getHelper(),
+    helper: helper,
     parent: parent,
     instantSearchInstance: instantSearchInstance,
     results: results,
     scopedResults: parent.getScopedResults(),
-    state: results._state,
+    state: results ? results._state : helper.state,
     renderState: instantSearchInstance.renderState,
     templatesConfig: instantSearchInstance.templatesConfig,
     createURL: parent.createURL,

package/es/lib/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "4.55.0";
+declare const _default: "4.56.0";
 export default _default;

package/es/lib/version.js

@@ -1 +1 @@
-export default '4.55.0';
+export default '4.56.0';

package/es/types/middleware.d.ts

@@ -9,24 +9,24 @@ export type MiddlewareDefinition<TUiState extends UiState = UiState> = {
     /**
      * Change handler called on every UiState change
      */
-    onStateChange(options: {
+    onStateChange: (options: {
         uiState: TUiState;
-    }): void;
+    }) => void;
     /**
      * Called when the middleware is added to InstantSearch
      */
-    subscribe(): void;
+    subscribe: () => void;
     /**
      * Called when InstantSearch is started
      */
-    started(): void;
+    started: () => void;
     /**
      * Called when the middleware is removed from InstantSearch
      */
-    unsubscribe(): void;
+    unsubscribe: () => void;
 };
 export type MiddlewareOptions = {
     instantSearchInstance: InstantSearch;
 };
 export type InternalMiddleware<TUiState extends UiState = UiState> = (options: MiddlewareOptions) => MiddlewareDefinition<TUiState>;
-export type Middleware = (options: MiddlewareOptions) => AtLeastOne<MiddlewareDefinition>;
+export type Middleware<TUiState extends UiState = UiState> = (options: MiddlewareOptions) => AtLeastOne<MiddlewareDefinition<TUiState>>;

package/es/types/router.d.ts

@@ -10,26 +10,26 @@ export type Router<TRouteState = UiState> = {
      * In the case of the history / URL in a browser, the callback will be called
      * by `onPopState`.
      */
-    onUpdate(callback: (route: TRouteState) => void): void;
+    onUpdate: (callback: (route: TRouteState) => void) => void;
     /**
      * Reads the storage and gets a route object. It does not take parameters,
      * and should return an object
      */
-    read(): TRouteState;
+    read: () => TRouteState;
     /**
      * Pushes a route object into a storage. Takes the UI state mapped by the state
      * mapping configured in the mapping
      */
-    write(route: TRouteState): void;
+    write: (route: TRouteState) => void;
     /**
      * Transforms a route object into a URL. It receives an object and should
      * return a string. It may return an empty string.
      */
-    createURL(state: TRouteState): string;
+    createURL: (state: TRouteState) => string;
     /**
      * Called when InstantSearch is disposed. Used to remove subscriptions.
      */
-    dispose(): void;
+    dispose: () => void;
     /**
      * Called when InstantSearch is started.
      */
@@ -52,13 +52,13 @@ export type StateMapping<TUiState = UiState, TRouteState = TUiState> = {
      * It should return an object of any form as long as this form can be read by
      * the `routeToState` function.
      */
-    stateToRoute(uiState: TUiState): TRouteState;
+    stateToRoute: (uiState: TUiState) => TRouteState;
     /**
      * Transforms route object into a UI state representation.
      * It receives an object that contains the UI state stored by the router.
      * The format is the output of `stateToRoute`.
      */
-    routeToState(routeState: TRouteState): TUiState;
+    routeToState: (routeState: TRouteState) => TUiState;
     /**
      * Identifier for this stateMapping. Used to differentiate between stateMappings.
      */

package/es/types/widget.d.ts

@@ -24,7 +24,7 @@ type SharedRenderOptions = {
     };
     status: InstantSearch['status'];
     error: InstantSearch['error'];
-    createURL(state: SearchParameters): string;
+    createURL: (state: SearchParameters) => string;
 };
 export type InitOptions = SharedRenderOptions & {
     uiState: UiState;

package/es/widgets/dynamic-widgets/dynamic-widgets.d.ts

@@ -14,12 +14,12 @@ export type DynamicWidgetsWidgetParams = {
      * Function to return a fallback widget when an attribute isn't found in
      * `widgets`.
      */
-    fallbackWidget?(args: {
+    fallbackWidget?: (args: {
         /** The attribute name to create a widget for. */
         attribute: string;
         /** CSS Selector or HTMLElement to insert the widget */
         container: HTMLElement;
-    }): Widget;
+    }) => Widget;
 };
 export type DynamicWidgetsWidget = WidgetFactory<DynamicWidgetsWidgetDescription & {
     $$widgetType: 'ais.dynamicWidgets';

package/es/widgets/geo-search/createHTMLMarker.d.ts

@@ -28,7 +28,7 @@ interface Marker {
     };
     latLng: google.maps.LatLng;
     element: HTMLDivElement;
-    getPosition(): google.maps.LatLng;
+    getPosition: () => google.maps.LatLng;
 }
 declare const createHTMLMarker: (googleReference: typeof google) => new (args: HTMLMarkerArguments) => google.maps.OverlayView & Marker;
 export default createHTMLMarker;

package/es/widgets/geo-search/geo-search.d.ts

@@ -44,7 +44,7 @@ export type GeoSearchMarker<TOptions> = {
      * See the documentation for more information:
      * https://developers.google.com/maps/documentation/javascript/reference/3/#MarkerOptions
      */
-    createOptions?(item: GeoHit): TOptions;
+    createOptions?: (item: GeoHit) => TOptions;
     /**
      * Object that takes an event type (ex: `click`, `mouseover`) as key and a
      * listener as value. The listener is provided with an object that contains:

package/es/widgets/hits-per-page/hits-per-page.js

@@ -31,7 +31,9 @@ var renderer = function renderer(_ref) {
     }, h(Selector, {
       cssClasses: cssClasses,
       currentValue: currentValue,
-      options: items,
+      options: items
+      // @ts-expect-error: the refine function expects a number, but setValue will call it with a string. We don't want to change the type of the refine function because it's part of the connector API.
+      ,
       setValue: refine
     })), containerNode);
   };