feat(specs): add specific documentation for facets query parameter in Composition API (generated)

algolia/api-clients-automation#5477

Co-authored-by: algolia-bot <[email protected]>
Co-authored-by: Clara Muller <[email protected]>

Author: algolia-bot

src/main/scala/algoliasearch/composition/MainInjectionQueryParameters.scala

@@ -210,8 +210,11 @@ import algoliasearch.composition.SupportedLanguage._
   *   the same facet values for the `attributeForDistinct`.
   * @param facets
   *   Facets for which to retrieve facet values that match the search criteria and the number of matching facet values
-  *   To retrieve all facets, use the wildcard character `*`. For more information, see
-  *   [facets](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#contextual-facet-values-and-counts).
+  *   To retrieve all facets, use the wildcard character `*`. To retrieve disjunctive facets lists, annotate any facets
+  *   with the `disjunctive` modifier. For more information, see
+  *   [facets](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#contextual-facet-values-and-counts)
+  *   and [disjunctive faceting for Smart
+  *   Groups](https://www.algolia.com/doc/guides/managing-results/compositions/search-based-groups#facets-including-disjunctive-faceting).
   * @param hitsPerPage
   *   Number of hits per page.
   * @param maxValuesPerFacet

src/main/scala/algoliasearch/composition/Params.scala

@@ -61,8 +61,11 @@ import algoliasearch.composition.SupportedLanguage._
   *   Use this setting to strike a balance between the relevance and number of returned results.
   * @param facets
   *   Facets for which to retrieve facet values that match the search criteria and the number of matching facet values
-  *   To retrieve all facets, use the wildcard character `*`. For more information, see
-  *   [facets](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#contextual-facet-values-and-counts).
+  *   To retrieve all facets, use the wildcard character `*`. To retrieve disjunctive facets lists, annotate any facets
+  *   with the `disjunctive` modifier. For more information, see
+  *   [facets](https://www.algolia.com/doc/guides/managing-results/refine-results/faceting/#contextual-facet-values-and-counts)
+  *   and [disjunctive faceting for Smart
+  *   Groups](https://www.algolia.com/doc/guides/managing-results/compositions/search-based-groups#facets-including-disjunctive-faceting).
   * @param hitsPerPage
   *   Number of hits per page.
   * @param aroundLatLng
@@ -129,8 +132,8 @@ case class Params(
     page: Option[Int] = scala.None,
     getRankingInfo: Option[Boolean] = scala.None,
     relevancyStrictness: Option[Int] = scala.None,
-    facets: Option[Seq[String]] = scala.None,
     facetFilters: Option[FacetFilters] = scala.None,
+    facets: Option[Seq[String]] = scala.None,
     optionalFilters: Option[OptionalFilters] = scala.None,
     numericFilters: Option[NumericFilters] = scala.None,
     hitsPerPage: Option[Int] = scala.None,