v4.1.1

### Bug Fixes

* **configureRelatedItems:** use `facetFilters` to exclude `obje… ([algolia#4264](algolia#4264)) ([9bc66cf](algolia@9bc66cf))
* **index:** fix warning for widgets sharing connectors ([algolia#4260](algolia#4260)) ([ec97b4a](algolia@ec97b4a))
* **insights:** export Insights helper in the ESM build ([algolia#4261](algolia#4261)) ([20649af](algolia@20649af))
* **insights:** move 'insightsClient not provided error' to wrapper level ([algolia#4254](algolia#4254)) ([15d38dd](algolia@15d38dd))

### Features

* **insights:** add hogan helper ([algolia#4253](algolia#4253)) ([85739d7](algolia@85739d7))

v4.1.0

The 4.0.1 release contained experimental TypeScript definitions in the ESM build by accident. We rolled this back in 4.1.0 because types will first be released on an experimental tag: `experimental-typescript`.

### Bug Fixes

* **core:** display correct object types in messages ([algolia#4249](algolia#4249)) ([fb2c3c9](algolia@fb2c3c9))
* **insights:** detect clicks on children of `[data-insights]` HTML elements ([algolia#4197](algolia#4197)) ([9cac5a3](algolia@9cac5a3))
* **insights:** display docs URL when missing ([algolia#4231](algolia#4231)) ([9df1e7f](algolia@9df1e7f))
* **widgets:** override connectors' `$$type` ([algolia#4227](algolia#4227)) ([50f4af3](algolia@50f4af3))

### Features

* **middleware:** introduce `EXPERIMENTAL_use` to plug middleware into InstantSearch ([algolia#4224](algolia#4224)) ([9d1f7be](algolia@9d1f7be))
* **router:** plug router as a middleware ([algolia#4224](algolia#4224)) ([9d1f7be](algolia@9d1f7be))
* **insights:** detect window.aa when available on global scope and a function ([algolia#4191](algolia#4191)) ([d6df5af](algolia@d6df5af))
* **typescript:** add declaration files (experimental) ([algolia#4220](algolia#4220)) ([ebacfe5](algolia@ebacfe5))
* **widgets:** introduce Related Items widgets as experimental (`EXPERIMENTAL_configureRelatedItems` and `EXPERIMENTAL_connectConfigureRelatedItems`) ([algolia#4233](algolia#4233)) ([f811f4e](algolia@f811f4e))
# Please enter the commit message for your changes. Lines starting
# with '#' will be kept; you may remove them yourself if you want to.
# An empty message aborts the commit.
#
# Date:      Tue Dec 10 10:36:24 2019 +0100
#
# On branch master
# Your branch is ahead of 'origin/master' by 23 commits.
#   (use "git push" to publish your local commits)
#
# Changes to be committed:
#	modified:   CHANGELOG.md
#	modified:   CONTRIBUTING.md
#	modified:   package.json
#	modified:   src/lib/version.ts
#

# Please enter the commit message for your changes. Lines starting
# with '#' will be kept; you may remove them yourself if you want to.
# An empty message aborts the commit.
#
# Date:      Tue Dec 10 10:36:24 2019 +0100
#
# On branch master
# Your branch is ahead of 'origin/master' by 23 commits.
#   (use "git push" to publish your local commits)
#
# Changes to be committed:
#	modified:   CHANGELOG.md
#	modified:   CONTRIBUTING.md
#	modified:   package.json
#	modified:   src/lib/version.ts
#

v4.0.1

## [4.0.1](algolia/instantsearch@v4.0.0...v4.0.1) (2019-11-28)

### Bug Fixes

* widget name in documentation link for index ([algolia#4172](algolia#4172)) ([fe7e588](algolia@fe7e588))
* **helper:** rely on stable version of algoliasearch-helper ([algolia#4200](algolia#4200)) ([ff11731](algolia@ff11731))
* **infiniteHits:** correct widget options types ([algolia#4222](algolia#4222)) ([bb1b327](algolia@bb1b327))
* **queryHook:** restore behaviour of queryHook ([algolia#4202](algolia#4202)) ([7bf96cb](algolia@7bf96cb)), closes [/github.com/algolia/instantsearch.js/commit/c073a9acb51fff3c15278fcd563e47fec55c8365#diff-530222e0c4597f2110dc6ba173a306b0L98](https://github.com//github.com/algolia/instantsearch.js/commit/c073a9acb51fff3c15278fcd563e47fec55c8365/issues/diff-530222e0c4597f2110dc6ba173a306b0L98)

### Features

* **transformers:** add tests ([algolia#4153](algolia#4153)) ([5a28415](algolia@5a28415))

v4.0.0

* **configure:** merge with the previous parameters ([algolia#4085](algolia#4085)) ([a215d0c](algolia@a215d0c))
* **configure:** update lifecycle state ([algolia#3994](algolia#3994)) ([3d8d967](algolia@3d8d967))
* **connectInfiniteHits:** fix page state when adding or removing widgets ([algolia#4104](algolia#4104)) ([1077340](algolia@1077340))
* **connectInfiniteHits:** fix state when navigating or adding/removing widgets ([algolia#4123](algolia#4123)) ([9cbd24a](algolia@9cbd24a))
* **createURL:** support multi-index ([algolia#4082](algolia#4082)) ([179a6e5](algolia@179a6e5))
* **defer:** recover from error ([algolia#3933](algolia#3933)) ([f22b9e2](algolia@f22b9e2))
* **helper:** expose .lastResults to .helper ([algolia#4170](algolia#4170)) ([236eb7b](algolia@236eb7b))
* **history:** avoid empty query string ([algolia#4130](algolia#4130)) ([18fee7c](algolia@18fee7c))
* **hits:** update lifecycle state ([algolia#3977](algolia#3977)) ([6e55ba6](algolia@6e55ba6))
* **hitsPerPage:** avoid sync default value ([algolia#4086](algolia#4086)) ([3f8b958](algolia@3f8b958))
* **hitsPerPage:** update lifecycle state ([algolia#3978](algolia#3978)) ([d21d620](algolia@d21d620))
* **index:** ensure that we always use the index set by widgets ([algolia#4125](algolia#4125)) ([952dc70](algolia@952dc70)), closes [/github.com/algolia/algoliasearch-helper-js/blob/5a0352aa233c5ea932df6b054a16989c8d302404/src/algoliasearch.helper.js#L124](https://github.com//github.com/algolia/algoliasearch-helper-js/blob/5a0352aa233c5ea932df6b054a16989c8d302404/src/algoliasearch.helper.js/issues/L124)
* **index:** prevent render without results ([algolia#3932](algolia#3932)) ([1b9b5f4](algolia@1b9b5f4))
* **index:** subscribe to state change only after init for uiState ([algolia#4003](algolia#4003)) ([9490ca9](algolia@9490ca9))
* **index:** support custom UI params in UI state warning ([algolia#4165](algolia#4165)) ([80d32fc](algolia@80d32fc))
* **index:** warn for inconsistent UI state in development mode ([algolia#4140](algolia#4140)) ([7e277dc](algolia@7e277dc))
* **infiniteHits:** update lifecycle state ([algolia#3983](algolia#3983)) ([4b8bee5](algolia@4b8bee5))
* **instantsearch:** return instance in widgets methods ([algolia#4143](algolia#4143)) ([77ffb93](algolia@77ffb93))
* **InstantSearch:** cancel scheduled operations ([algolia#3930](algolia#3930)) ([3aafbad](algolia@3aafbad))
* **InstantSearch:** fix initialUIState when refinements are already present in the route ([algolia#4103](algolia#4103)) ([079db57](algolia@079db57))
* **InstantSearch:** remove useless walk/duplicate request ([algolia#4127](algolia#4127)) ([70163a8](algolia@70163a8))
* **menu:** apply & remove refinement ([algolia#4027](algolia#4027)) ([85de2cf](algolia@85de2cf))
* **menu:** prevent error on stale search ([algolia#3934](algolia#3934)) ([5f9e138](algolia@5f9e138))
* **numericMenu:** take array into account for empty state ([algolia#4084](algolia#4084)) ([2c05a01](algolia@2c05a01))
* **pagination:** update lifecycle state ([algolia#3979](algolia#3979)) ([2b08344](algolia@2b08344))
* **pagination:** update no refinement behavior ([algolia#4124](algolia#4124)) ([8d222ad](algolia@8d222ad))
* **range:** clear widget state on empty refinements ([algolia#4157](algolia#4157)) ([23cd112](algolia@23cd112))
* **ratingMenu:** update lifecycle state ([algolia#3987](algolia#3987)) ([ffadf64](algolia@ffadf64))
* **RefinementList:** remove root css class on sublists ([algolia#4117](algolia#4117)) ([ceddd42](algolia@ceddd42)), closes [/github.com/algolia/instantsearch.js/blob/v2/src/decorators/headerFooter.js#L22](https://github.com//github.com/algolia/instantsearch.js/blob/v2/src/decorators/headerFooter.js/issues/L22)
* **searchBox:** update lifecycle state ([algolia#3981](algolia#3981)) ([0ea4950](algolia@0ea4950))
* **sortBy:** ensure a return value for getWidgetSearchParameters ([algolia#4126](algolia#4126)) ([569d573](algolia@569d573))
* **sortBy:** read initial index name from parent index ([algolia#4079](algolia#4079)) ([fe23c55](algolia@fe23c55))
* display warnings only in development ([algolia#4150](algolia#4150)) ([44f69a0](algolia@44f69a0))
* remove useless types  ([algolia#3958](algolia#3958)) ([ddebf53](algolia@ddebf53))
* **stories:** hide Places ([algolia#4152](algolia#4152)) ([7ff843f](algolia@7ff843f))
* **toggleRefinement:** update lifecycle state ([algolia#3993](algolia#3993)) ([f1beff6](algolia@f1beff6))
* **voiceSearch:** update lifecycle state ([algolia#3982](algolia#3982)) ([798e3c1](algolia@798e3c1))
* **warnings:** remove v3 warnings ([algolia#4134](algolia#4134)) ([7eb6810](algolia@7eb6810))

* **autocomplete:** leverage scoped results ([algolia#3975](algolia#3975)) ([8f05968](algolia@8f05968))
* **autocomplete:** participate in routing ([algolia#4029](algolia#4029)) ([a9ca0c5](algolia@a9ca0c5))
* **autocomplete:** provide indexId ([algolia#4142](algolia#4142)) ([b641e23](algolia@b641e23))
* **clearRefinements:** support multiple indices ([algolia#4036](algolia#4036)) ([3611b11](algolia@3611b11))
* **connectAutocomplete:** add default value on getConfiguration ([algolia#3836](algolia#3836)) ([724b83f](algolia@724b83f))
* **connectAutocomplete:** clear the state on dispose ([algolia#3815](algolia#3815)) ([8ae87d8](algolia@8ae87d8))
* **connectHierarchicalMenu:** update getWidgetSearchParameters ([algolia#4053](algolia#4053)) ([c99f822](algolia@c99f822))
* **connectHits:** clear the state on dispose ([algolia#3816](algolia#3816)) ([c4de730](algolia@c4de730))
* **connectHits:** implement getWidgetSearchParameters ([algolia#4001](algolia#4001)) ([c77cf66](algolia@c77cf66))
* **connectHitsPerPage:** clear the state on dispose ([algolia#3818](algolia#3818)) ([d7a5c89](algolia@d7a5c89))
* **connectInfiniteHits:** add default value on getConfiguration ([algolia#3837](algolia#3837)) ([8c65249](algolia@8c65249))
* **connectInfiniteHits:** clear the state on dispose ([algolia#3819](algolia#3819)) ([60ce151](algolia@60ce151))
* **connectMenu:** update getWidgetSearchParameters ([algolia#4054](algolia#4054)) ([7d001e7](algolia@7d001e7))
* **connectNumericMenu:** update state lifecycle  ([algolia#4013](algolia#4013)) ([2620c90](algolia@2620c90))
* **connectPagination:** add default value on getConfiguration ([algolia#3838](algolia#3838)) ([aa4602c](algolia@aa4602c))
* **connectPagination:** clear the state on dispose ([algolia#3821](algolia#3821)) ([5b8ef49](algolia@5b8ef49))
* **connectPagination:** update getWidgetSearchParameters ([algolia#4004](algolia#4004)) ([eed7e77](algolia@eed7e77))
* **connectRange:** default `precision` to 0 ([algolia#3953](algolia#3953)) ([632e06b](algolia@632e06b))
* **connectRatingMenu:** update getWidgetSearchParameters  ([algolia#4008](algolia#4008)) ([d3c96bf](algolia@d3c96bf))
* **connectRefinementList:** update getWidgetSearchParameters  ([algolia#4010](algolia#4010)) ([ddc8fc4](algolia@ddc8fc4))
* **connectSearchBox:** clear the state on dispose ([algolia#3822](algolia#3822)) ([940522c](algolia@940522c))
* **connectSearchBox:** mount with a default query ([algolia#3840](algolia#3840)) ([c3a7d69](algolia@c3a7d69))
* **connectSearchBox:** update getWidgetSearchParameters ([algolia#4002](algolia#4002)) ([5c6fcd8](algolia@5c6fcd8))
* **connectVoiceSearch:** add default value on getConfiguration ([algolia#3841](algolia#3841)) ([fb70363](algolia@fb70363))
* **connectVoiceSearch:** clear the state on dispose ([algolia#3823](algolia#3823)) ([705b3e6](algolia@705b3e6))
* **connectVoiceSearch:** update getWidgetSearchParameters ([algolia#4055](algolia#4055)) ([b8c669f](algolia@b8c669f))
* **core:** deprecate addWidget & removeWidget ([algolia#4131](algolia#4131)) ([e5dafef](algolia@e5dafef))
* **currentRefinements:** support multiple indices ([algolia#4012](algolia#4012)) ([e997728](algolia@e997728))
* **defer:** implement cancellable callback ([algolia#3916](algolia#3916)) ([43a0bf8](algolia@43a0bf8))
* **federated:** keep a consistent state in the RefinementList life cycle ([algolia#3976](algolia#3976)) ([31d0fd6](algolia@31d0fd6))
* **hitsPerPage:** support new routing system ([algolia#4038](algolia#4038)) ([02502cb](algolia@02502cb)), closes [algolia#4069](algolia#4069)
* **index:** accept indexId ([algolia#4070](algolia#4070)) ([b74f8e3](algolia@b74f8e3))
* **index:** add mergeSearchParameters function ([algolia#3917](algolia#3917)) ([c0fe7bb](algolia@c0fe7bb))
* **index:** add widget ([dbbda0f](algolia@dbbda0f)), closes [algolia#3892](algolia#3892) [algolia#3893](algolia#3893) [algolia#3914](algolia#3914)
* **index:** compute local uiState ([algolia#3997](algolia#3997)) ([997c0f4](algolia@997c0f4))
* **index:** merge `ruleContexts` search parameter ([algolia#3944](algolia#3944)) ([e94752d](algolia@e94752d))
* **index:** provide scoped results to render hook ([algolia#3964](algolia#3964)) ([37c6aad](algolia@37c6aad))
* **index:** replicate searchFunction hack ([algolia#4078](algolia#4078)) ([1d2a816](algolia@1d2a816)), closes [/github.com/algolia/instantsearch.js/blob/509513c0feafaad522f6f18d87a441559f4aa050/src/lib/RoutingManager.ts#L113-L130](https://github.com//github.com/algolia/instantsearch.js/blob/509513c0feafaad522f6f18d87a441559f4aa050/src/lib/RoutingManager.ts/issues/L113-L130)
* **index:** reset page of child indexes ([algolia#3962](algolia#3962)) ([131b1ce](algolia@131b1ce))
* **index:** resolve parent SearchParameters ([algolia#3937](algolia#3937)) ([2611da5](algolia@2611da5))
* **index:** use uiState driven SearchParameters ([algolia#4059](algolia#4059)) ([b12bb9f](algolia@b12bb9f))
* **infiniteHits:** support new routing system ([algolia#4040](algolia#4040)) ([49315cf](algolia@49315cf))
* **instantsearch:** add onStateChange method ([algolia#4080](algolia#4080)) ([9f68da5](algolia@9f68da5))
* **InstantSearch:** switch to DerivedHelper only ([algolia#3885](algolia#3885)) ([d6fc317](algolia@d6fc317))
* **places:** add Places widget ([algolia#4167](algolia#4167)) ([1d754d1](algolia@1d754d1))
* drop support of searchParameters for initialUiState ([algolia#4081](algolia#4081)) ([571efeb](algolia@571efeb))
* **range:** support new routing system ([algolia#4039](algolia#4039)) ([8cba05a](algolia@8cba05a))
* **routing:** add a "single index" compatibility mode ([algolia#4087](algolia#4087)) ([842eb0f](algolia@842eb0f))
* **RoutingManager:** update state on route update ([algolia#4100](algolia#4100)) ([88f2615](algolia@88f2615))
* **toggleRefinement:** support new routing system ([algolia#4037](algolia#4037)) ([6a9d99f](algolia@6a9d99f))
* **types:** DerivedHelper ([algolia#3887](algolia#3887)) ([0f38b4a](algolia@0f38b4a))
* **types:** rename RenderOptions -> RendererOptions ([algolia#3867](algolia#3867)) ([05c6f72](algolia@05c6f72))
* **utils:** implement defer ([algolia#3882](algolia#3882)) ([8af470e](algolia@8af470e))
* **voice:** add additional query parameters ([algolia#3738](algolia#3738)) ([c555255](algolia@c555255))
* drop suppot for onHistoryChange ([algolia#3941](algolia#3941)) ([697f609](algolia@697f609))
* introduce initialUiState option ([algolia#4074](algolia#4074)) ([de00707](algolia@de00707))
* update UiState definition ([algolia#4075](algolia#4075)) ([9e7d3d8](algolia@9e7d3d8))
* **widgets:** add `$$type` to widgets definition ([algolia#3960](algolia#3960)) ([344d1b7](algolia@344d1b7))

v3.7.0

# [3.7.0](algolia/instantsearch@v3.5.4...v3.7.0) (2019-10-08)

### Bug Fixes

* **clearRefinements:** reset page to 0 ([algolia#3936](algolia#3936)) ([7378a0a](algolia@7378a0a))
* **connectSortBy:** never update the initial index ([algolia#4015](algolia#4015)) ([bc0f9e2](algolia@bc0f9e2))
* **deps:** update dependency instantsearch.js to v3.5.4 ([algolia#3929](algolia#3929)) ([eff84c5](algolia@eff84c5))
* **deps:** update dependency instantsearch.js to v3.6.0 ([algolia#4021](algolia#4021)) ([7719bba](algolia@7719bba))
* **enhanceConfiguration:** deduplicate the hierarchicalFacets ([algolia#3966](algolia#3966)) ([baf8a35](algolia@baf8a35))
* **examples:** fix IE11 compatibility for e-commerce demo ([algolia#4049](algolia#4049)) ([dc6f350](algolia@dc6f350))
* **examples:** fix missing polyfill in e-commerce demo ([algolia#4076](algolia#4076)) ([4bf3ab3](algolia@4bf3ab3))
* **hierarchicalFacets:** prevent different rootPath on same attribute ([algolia#3965](algolia#3965)) ([5ee79fa](algolia@5ee79fa))
* **instantsearch:** warn deprecated usage of  ([algolia#4151](algolia#4151)) ([18e1c36](algolia@18e1c36))
* **menuSelect:** unmount component ([algolia#3911](algolia#3911)) ([f6debce](algolia@f6debce))
* **rangeInput:** unmount component ([algolia#3910](algolia#3910)) ([f6c29e8](algolia@f6c29e8))
* **refinementList:** fix showMore button to work after search ([algolia#3082](algolia#3082)) ([23e46b6](algolia@23e46b6))
* pass noop as default value to unmountFn at connectors ([algolia#3955](algolia#3955)) ([7c38744](algolia@7c38744))

v3.6.0

# [3.6.0](algolia/instantsearch@v3.5.4...v3.6.0) (2019-07-30)

### Bug Fixes

* **clearRefinements:** reset page to 0 ([algolia#3936](algolia#3936)) ([7378a0a](algolia@7378a0a))
* **deps:** update dependency instantsearch.js to v3.5.4 ([algolia#3929](algolia#3929)) ([eff84c5](algolia@eff84c5))
* pass noop as default value to unmountFn at connectors ([algolia#3955](algolia#3955)) ([7c38744](algolia@7c38744))
* **enhanceConfiguration:** deduplicate the hierarchicalFacets ([algolia#3966](algolia#3966)) ([baf8a35](algolia@baf8a35))
* **hierarchicalFacets:** prevent different rootPath on same attribute ([algolia#3965](algolia#3965)) ([5ee79fa](algolia@5ee79fa))
* **menuSelect:** unmount component ([algolia#3911](algolia#3911)) ([f6debce](algolia@f6debce))
* **rangeInput:** unmount component ([algolia#3910](algolia#3910)) ([f6c29e8](algolia@f6c29e8))
* **refinementList:** fix showMore button to work after search ([algolia#3082](algolia#3082)) ([23e46b6](algolia@23e46b6))

v3.6.0

# [3.6.0](algolia/instantsearch@v3.5.4...v3.6.0) (2019-07-30)

### Bug Fixes

* **clearRefinements:** reset page to 0 ([algolia#3936](algolia#3936)) ([7378a0a](algolia@7378a0a))
* **deps:** update dependency instantsearch.js to v3.5.4 ([algolia#3929](algolia#3929)) ([eff84c5](algolia@eff84c5))
* pass noop as default value to unmountFn at connectors ([algolia#3955](algolia#3955)) ([7c38744](algolia@7c38744))
* **enhanceConfiguration:** deduplicate the hierarchicalFacets ([algolia#3966](algolia#3966)) ([baf8a35](algolia@baf8a35))
* **hierarchicalFacets:** prevent different rootPath on same attribute ([algolia#3965](algolia#3965)) ([5ee79fa](algolia@5ee79fa))
* **menuSelect:** unmount component ([algolia#3911](algolia#3911)) ([f6debce](algolia@f6debce))
* **rangeInput:** unmount component ([algolia#3910](algolia#3910)) ([f6c29e8](algolia@f6c29e8))
* **refinementList:** fix showMore button to work after search ([algolia#3082](algolia#3082)) ([23e46b6](algolia@23e46b6))

v2.10.5

<a name="2.10.5"></a>

* **routing:** enforce RoutingManager is the last widget ([algolia#3149](algolia#3149)) ([1e86b2e](algolia@1e86b2e)), closes [algolia#3148](algolia#3148)
* **routing:** support parsing URLs with up to 100 refinements ([algolia#3935](algolia#3935)) ([d6476e2](algolia@d6476e2))