Merge branch 'main' into pr/3099

Author: guimachiavelli

.github/workflows/code-sample-automation.yml

@@ -8,7 +8,7 @@ on:
 
 jobs:
   add-pr-to-project:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     steps:
       - uses: actions/add-to-project@f5473ace9aeee8b97717b281e26980aa5097023f
         with:

.github/workflows/preview-info.yml

@@ -10,7 +10,7 @@ env:
 
 jobs:
   preview-info:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     steps:
       - uses: actions/checkout@v4
       - name: Prepare comment content

.github/workflows/validate-docs-links.yml

@@ -6,7 +6,7 @@ on:
 
 jobs:
   link-check:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     if: github.base_ref == 'main'
     steps:
       - uses: actions/checkout@v4

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019-2024 Meili SAS
+Copyright (c) 2019-2025 Meili SAS
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

learn/resources/comparison_to_alternatives.mdx

@@ -165,7 +165,7 @@ Can't find a client you'd like us to support? [Submit your idea or vote for it](
 |---|:---:|:----:|:---:|:---:|
 | Status page | ✅ | ✅ | ✅ | ✅ |
 | Free support channels | Instant messaging / chatbox (2-3h delay),<br /> emails, <br /> public Discord community, <br /> GitHub issues & discussions | Instant messaging / chatbox, <br /> public community forum |  Instant messaging/chatbox (24h-48h delay),<br /> public Slack community, <br /> GitHub issues. | Public Slack community, <br /> public community forum,<br /> GitHub issues |
-| Paid support channels | _Support is free!_ | Emails | Emails, <br /> phone, <br /> private Slack | Web support, <br /> emails, <br /> phone |
+| Paid support channels | Slack Channel, emails, personalized support — whatever you need, we’ll be there! | Emails | Emails, <br /> phone, <br /> private Slack | Web support, <br /> emails, <br /> phone |
 
 ## Approach comparison
 

reference/api/experimental_features.mdx

@@ -23,12 +23,13 @@ The experimental API route is not compatible with all experimental features. Con
 }
 ```
 
-| Name                      | Type    | Description                                                               |
-| :------------------------ | :------ | :--------------------------------------------- |
-| **`metrics`**             | Boolean | `true` if feature is active, `false` otherwise |
-| **`scoreDetails`**        | Boolean | `true` if feature is active, `false` otherwise |
-| **`logsRoute`**           | Boolean | `true` if feature is active, `false` otherwise |
-| **`vectorStore`**         | Boolean | `true` if feature is active, `false` otherwise |
+| Name                          | Type    | Description                                                               |
+| :---------------------------- | :------ | :--------------------------------------------- |
+| **`metrics`**                 | Boolean | `true` if feature is active, `false` otherwise |
+| **`logsRoute`**               | Boolean | `true` if feature is active, `false` otherwise |
+| **`vectorStore`**             | Boolean | `true` if feature is active, `false` otherwise |
+| **`containsFilter`**          | Boolean | `true` if feature is active, `false` otherwise |
+| **`editDocumentsByFunction`** | Boolean | `true` if feature is active, `false` otherwise |
 
 ## Get all experimental features
 

reference/api/multi_search.mdx

@@ -95,7 +95,7 @@ When both `facetsByIndex` and `mergeFacets` are present and not null, facet info
 {
   "hits": [ … ],
   …
-  "facetFederation": {
+  "facetDistribution": {
     "ATTRIBUTE": {
       "VALUE": <Integer>,
       "VALUE": <Integer>
@@ -207,19 +207,14 @@ Federated search requests return a single object and the following fields:
 
 | Name                     | Type             | Description                                                                      |
 | :----------------------- | :--------------- | :------------------------------------------------------------------------------- |
-| **`indexUid`**           | String           | [`uid`](/learn/getting_started/indexes#index-uid) of the requested index           |
 | **`hits`**               | Array of objects | Results of the query                                                             |
 | **`offset`**             | Number           | Number of documents skipped                                                      |
 | **`limit`**              | Number           | Number of documents to take                                                      |
 | **`estimatedTotalHits`** | Number           | Estimated total number of matches                                                |
-| **`totalHits`**          | Number           | Exhaustive total number of matches                                               |
-| **`totalPages`**         | Number           | Exhaustive total number of search result pages                                   |
-| **`hitsPerPage`**        | Number           | Number of results on each page                                                   |
-| **`page`**               | Number           | Current search results page                                                      |
-| **`facetDistribution`**  | Object           | **[Distribution of the given facets](/reference/api/search#facetdistribution)**  |
-| **`facetStats`**         | Object           | [The numeric `min` and `max` values per facet](/reference/api/search#facetstats) |
 | **`processingTimeMs`**   | Number           | Processing time of the query                                                     |
-| **`query`**              | String           | Query originating the response                                                   |
+| **`facetsByIndex`**      | Object           | [Data for facets present in the search results](#facetsbyindex)                                                     |
+| **`facetDistribution`**  | Object           | [Distribution of the given facets](#mergefacets)                                                       |
+| **`facetStats`**         | Object           | [The numeric `min` and `max` values per facet](#mergefacets)                                                     |
 
 Each result in the `hits` array contains an additional `_federation` field with the following fields:
 

reference/api/search.mdx

@@ -59,7 +59,7 @@ By default, [this endpoint returns a maximum of 1000 results](/learn/resources/k
 | **[`hybrid`](#hybrid-search-experimental)**             | Object           | `null`        | Return results based on query keywords and meaning  |
 | **[`vector`](#vector-experimental)**                    | Array of numbers | `null`        | Search using a custom query vector                  |
 | **[`retrieveVectors`](#display-_vectors-in-response-experimental)** | Boolean          | `false`       | Return document vector data                         |
-| **[`locales`](#query-locales)** | Array of strings          | `null`       | Explicitly language used in a query                         |
+| **[`locales`](#query-locales)** | Array of strings          | `null`       | Explicitly specify languages used in a query              |
 
 [Learn more about how to use each search parameter](#search-parameters).
 
@@ -173,7 +173,7 @@ By default, [this endpoint returns a maximum of 1000 results](/learn/resources/k
 | **[`hybrid`](#hybrid-search-experimental)**             | Object           | `null`        | Return results based on query keywords and meaning  |
 | **[`vector`](#vector-experimental)**                    | Array of numbers | `null`        | Search using a custom query vector                  |
 | **[`retrieveVectors`](#display-_vectors-in-response-experimental)** | Boolean          | `false`       | Return document vector data                         |
-| **[`locales`](#query-locales)** | Array of strings          | `null`       | Explicitly language used in a query                         |
+| **[`locales`](#query-locales)** | Array of strings          | `null`       | Explicitly specify languages used in a query              |
 
 [Learn more about how to use each search parameter](#search-parameters).
 
@@ -248,6 +248,7 @@ This is not necessary when using the `POST` route or one of our [SDKs](/learn/re
 | **[`page`](#page)**                                     | Integer          | `1`           | Request a specific page of results                  |
 | **[`filter`](#filter)**                                 | Array of strings | `null`        | Filter queries by an attribute's value              |
 | **[`facets`](#facets)**                                 | Array of strings | `null`        | Display the count of matches per facet              |
+| **[`distinct`](#distinct-attributes-at-search-time)**   | String           | `null`        | Restrict search to documents with unique values of the attribute defined as distinct. |
 | **[`attributesToRetrieve`](#attributes-to-retrieve)**   | Array of strings | `["*"]`       | Attributes to display in the returned documents     |
 | **[`attributesToCrop`](#attributes-to-crop)**           | Array of strings | `null`        | Attributes whose values have to be cropped          |
 | **[`cropLength`](#crop-length)**                        | Integer          | `10`          | Maximum length of cropped value in words            |
@@ -263,7 +264,7 @@ This is not necessary when using the `POST` route or one of our [SDKs](/learn/re
 | **[`hybrid`](#hybrid-search-experimental)**             | Object           | `null`        | Return results based on query keywords and meaning  |
 | **[`vector`](#vector-experimental)**                    | Array of numbers | `null`        | Search using a custom query vector                  |
 | **[`retrieveVectors`](#display-_vectors-in-response-experimental)** | Boolean          | `false`       | Return document vector data                         |
-| **[`locales`](#query-locales)** | Array of strings          | `null`       | Explicitly language used in a query                         |
+| **[`locales`](#query-locales)** | Array of strings          | `null`       | Explicitly specify languages used in a query              |
 
 ### Query (q)
 

reference/api/settings.mdx

@@ -908,7 +908,7 @@ Update the localized attributes settings of an index.
 
 You can use the returned `taskUid` to get more details on [the status of the task](/reference/api/tasks#get-one-task).
 
-### Reset pagination settings
+### Reset localized attributes settings
 
 <RouteHighlighter method="RESET" route="/indexes/{index_uid}/settings/localized-attributes"/>