iter

lucene/CHANGES.txt

@@ -114,6 +114,9 @@ API Changes
 
 * GITHUB#13708: Move Operations.sameLanguage/subsetOf to test-framework. (Robert Muir)
 
+* GITHUB#13733: Move FacetsCollector#search utility methods to `FacetsCollectorManager`, replace the `Collector`
+  argument with a `FacetsCollectorManager` and update the return type to include both `TopDocs` results as well as
+  facets results. (Luca Cavanna)
 
 New Features
 ---------------------

lucene/MIGRATE.md

@@ -793,6 +793,13 @@ Specifically, the method `FunctionValues#getScorer(Weight weight, LeafReaderCont
 Callers must now keep track of the Weight instance that created the Scorer if they need it, instead of relying on 
 Scorer.
 
+### `FacetsCollector#search` utility methods moved and updated
+
+The static `search` methods exposed by `FacetsCollector` have been moved to `FacetsCollectorManager`. 
+Furthermore, they take a `FacetsCollectorManager` last argument in place of a `Collector` so that they support 
+intra query concurrency. The return type has also be updated to `FacetsCollectorManager.FacetsResult` which includes 
+both `TopDocs` as well as facets results included in a reduced `FacetsCollector` instance.
+
 ### `SearchWithCollectorTask` no longer supports the `collector.class` config parameter 
 
 `collector.class` used to allow users to load a custom collector implementation. `collector.manager.class`