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

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

Author: algolia-bot

clients/algoliasearch-client-csharp/algoliasearch/Models/Composition/MainInjectionQueryParameters.cs

@@ -347,9 +347,9 @@ public MainInjectionQueryParameters() { }
   public bool? FacetingAfterDistinct { get; set; }
 
   /// <summary>
-  /// 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).
+  /// 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 `*`. 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).
   /// </summary>
-  /// <value>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). </value>
+  /// <value>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 `*`. 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). </value>
   [JsonPropertyName("facets")]
   public List<string> Facets { get; set; }
 

clients/algoliasearch-client-csharp/algoliasearch/Models/Composition/Params.cs

@@ -56,19 +56,19 @@ public Params() { }
   [JsonPropertyName("relevancyStrictness")]
   public int? RelevancyStrictness { get; set; }
 
-  /// <summary>
-  /// 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).
-  /// </summary>
-  /// <value>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). </value>
-  [JsonPropertyName("facets")]
-  public List<string> Facets { get; set; }
-
   /// <summary>
   /// Gets or Sets FacetFilters
   /// </summary>
   [JsonPropertyName("facetFilters")]
   public FacetFilters FacetFilters { get; set; }
 
+  /// <summary>
+  /// 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 `*`. 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).
+  /// </summary>
+  /// <value>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 `*`. 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). </value>
+  [JsonPropertyName("facets")]
+  public List<string> Facets { get; set; }
+
   /// <summary>
   /// Gets or Sets OptionalFilters
   /// </summary>
@@ -224,8 +224,8 @@ public override string ToString()
     sb.Append("  Page: ").Append(Page).Append("\n");
     sb.Append("  GetRankingInfo: ").Append(GetRankingInfo).Append("\n");
     sb.Append("  RelevancyStrictness: ").Append(RelevancyStrictness).Append("\n");
-    sb.Append("  Facets: ").Append(Facets).Append("\n");
     sb.Append("  FacetFilters: ").Append(FacetFilters).Append("\n");
+    sb.Append("  Facets: ").Append(Facets).Append("\n");
     sb.Append("  OptionalFilters: ").Append(OptionalFilters).Append("\n");
     sb.Append("  NumericFilters: ").Append(NumericFilters).Append("\n");
     sb.Append("  HitsPerPage: ").Append(HitsPerPage).Append("\n");
@@ -280,14 +280,14 @@ public override bool Equals(object obj)
         RelevancyStrictness == input.RelevancyStrictness
         || RelevancyStrictness.Equals(input.RelevancyStrictness)
       )
-      && (
-        Facets == input.Facets
-        || Facets != null && input.Facets != null && Facets.SequenceEqual(input.Facets)
-      )
       && (
         FacetFilters == input.FacetFilters
         || (FacetFilters != null && FacetFilters.Equals(input.FacetFilters))
       )
+      && (
+        Facets == input.Facets
+        || Facets != null && input.Facets != null && Facets.SequenceEqual(input.Facets)
+      )
       && (
         OptionalFilters == input.OptionalFilters
         || (OptionalFilters != null && OptionalFilters.Equals(input.OptionalFilters))
@@ -385,14 +385,14 @@ public override int GetHashCode()
       hashCode = (hashCode * 59) + Page.GetHashCode();
       hashCode = (hashCode * 59) + GetRankingInfo.GetHashCode();
       hashCode = (hashCode * 59) + RelevancyStrictness.GetHashCode();
-      if (Facets != null)
-      {
-        hashCode = (hashCode * 59) + Facets.GetHashCode();
-      }
       if (FacetFilters != null)
       {
         hashCode = (hashCode * 59) + FacetFilters.GetHashCode();
       }
+      if (Facets != null)
+      {
+        hashCode = (hashCode * 59) + Facets.GetHashCode();
+      }
       if (OptionalFilters != null)
       {
         hashCode = (hashCode * 59) + OptionalFilters.GetHashCode();

clients/algoliasearch-client-dart/packages/client_composition/lib/src/model/main_injection_query_parameters.dart

@@ -286,7 +286,7 @@ final class MainInjectionQueryParameters {
   @JsonKey(name: r'facetingAfterDistinct')
   final bool? facetingAfterDistinct;
 
-  /// 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).
+  /// 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 `*`. 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).
   @JsonKey(name: r'facets')
   final List<String>? facets;
 

clients/algoliasearch-client-dart/packages/client_composition/lib/src/model/params.dart

@@ -16,8 +16,8 @@ final class Params {
     this.page,
     this.getRankingInfo,
     this.relevancyStrictness,
-    this.facets,
     this.facetFilters,
+    this.facets,
     this.optionalFilters,
     this.numericFilters,
     this.hitsPerPage,
@@ -62,17 +62,17 @@ final class Params {
   @JsonKey(name: r'relevancyStrictness')
   final int? relevancyStrictness;
 
-  /// 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).
-  @JsonKey(name: r'facets')
-  final List<String>? facets;
-
   /// One of types:
   /// - [List<List<FacetFilters>>]
   /// - [String]
   /// - [List<String>]
   @JsonKey(name: r'facetFilters')
   final dynamic facetFilters;
 
+  /// 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 `*`. 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).
+  @JsonKey(name: r'facets')
+  final List<String>? facets;
+
   /// One of types:
   /// - [String]
   /// - [List<List<OptionalFilters>>]
@@ -181,8 +181,8 @@ final class Params {
           other.page == page &&
           other.getRankingInfo == getRankingInfo &&
           other.relevancyStrictness == relevancyStrictness &&
-          other.facets == facets &&
           other.facetFilters == facetFilters &&
+          other.facets == facets &&
           other.optionalFilters == optionalFilters &&
           other.numericFilters == numericFilters &&
           other.hitsPerPage == hitsPerPage &&
@@ -212,8 +212,8 @@ final class Params {
       page.hashCode +
       getRankingInfo.hashCode +
       relevancyStrictness.hashCode +
-      facets.hashCode +
       facetFilters.hashCode +
+      facets.hashCode +
       optionalFilters.hashCode +
       numericFilters.hashCode +
       hitsPerPage.hashCode +