Add specification for new sparse vector query; deprecate specification for text_expansion and weighted_tokens queries (#2642)

* Add sparse_vector query to client specification

* Fix error and update contrib

* PR feedback

* Populate endpoint deprecation from request definition (#2640)

* Update specification output

* Wrap ts-morph errors to provide helpful error (#2644)

* wrap ts-morph errors to provide helpful error

* improve after lint

* Bump braces from 3.0.2 to 3.0.3 in /typescript-generator (#2645)

Bumps [braces](https://github.com/micromatch/braces) from 3.0.2 to 3.0.3.
- [Changelog](https://github.com/micromatch/braces/blob/master/CHANGELOG.md)
- [Commits](micromatch/braces@3.0.2...3.0.3)

---
updated-dependencies:
- dependency-name: braces
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* [Query Rules] Update Query Rules API for 8.15 (#2639)

* Mark existing query rules APIs as GA

* Add individual CRUD API calls

* Linting

* PR feedback

* PR feedback

* Update specification output

* Update output

* Update output

* Fix variant annotations for SparseVectorQuery

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: Florian Bernd <git@flobernd.de>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Co-authored-by: Laurent Saint-Félix <laurent.saintfelix@elastic.co>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Author: 5 people

output/openapi/elasticsearch-openapi.json

@@ -57225,6 +57225,9 @@
           "span_within": {
             "$ref": "#/components/schemas/_types.query_dsl:SpanWithinQuery"
           },
+          "sparse_vector": {
+            "$ref": "#/components/schemas/_types.query_dsl:SparseVectorQuery"
+          },
           "term": {
             "externalDocs": {
               "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-term-query.html"
@@ -57253,6 +57256,7 @@
             "maxProperties": 1
           },
           "text_expansion": {
+            "deprecated": true,
             "externalDocs": {
               "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-text-expansion-query.html"
             },
@@ -57265,6 +57269,7 @@
             "maxProperties": 1
           },
           "weighted_tokens": {
+            "deprecated": true,
             "description": "Supports returning text_expansion query results by sending in precomputed tokens with the query.",
             "type": "object",
             "additionalProperties": {
@@ -61163,6 +61168,73 @@
           }
         ]
       },
+      "_types.query_dsl:SparseVectorQuery": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/_types.query_dsl:QueryBase"
+          },
+          {
+            "allOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "field": {
+                    "$ref": "#/components/schemas/_types:Field"
+                  }
+                },
+                "required": [
+                  "field"
+                ]
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "query_vector": {
+                    "description": "Dictionary of precomputed sparse vectors and their associated weights.\nOnly one of inference_id or query_vector may be supplied in a request.",
+                    "type": "object",
+                    "additionalProperties": {
+                      "type": "number"
+                    }
+                  },
+                  "inference_id": {
+                    "$ref": "#/components/schemas/_types:Id"
+                  },
+                  "query": {
+                    "description": "The query text you want to use for search.\nIf inference_id is specified, query must also be specified.",
+                    "type": "string"
+                  },
+                  "prune": {
+                    "description": "Whether to perform pruning, omitting the non-significant tokens from the query to improve query performance.\nIf prune is true but the pruning_config is not specified, pruning will occur but default values will be used.\nDefault: false",
+                    "type": "boolean"
+                  },
+                  "pruning_config": {
+                    "$ref": "#/components/schemas/_types.query_dsl:TokenPruningConfig"
+                  }
+                },
+                "minProperties": 1,
+                "maxProperties": 1
+              }
+            ]
+          }
+        ]
+      },
+      "_types.query_dsl:TokenPruningConfig": {
+        "type": "object",
+        "properties": {
+          "tokens_freq_ratio_threshold": {
+            "description": "Tokens whose frequency is more than this threshold times the average frequency of all tokens in the specified field are considered outliers and pruned.",
+            "type": "number"
+          },
+          "tokens_weight_threshold": {
+            "description": "Tokens whose weight is less than this threshold are considered nonsignificant and pruned.",
+            "type": "number"
+          },
+          "only_score_pruned_tokens": {
+            "description": "Whether to only score pruned tokens, vs only scoring kept tokens.",
+            "type": "boolean"
+          }
+        }
+      },
       "_types.query_dsl:TermQuery": {
         "allOf": [
           {
@@ -61250,23 +61322,6 @@
           }
         ]
       },
-      "_types.query_dsl:TokenPruningConfig": {
-        "type": "object",
-        "properties": {
-          "tokens_freq_ratio_threshold": {
-            "description": "Tokens whose frequency is more than this threshold times the average frequency of all tokens in the specified field are considered outliers and pruned.",
-            "type": "number"
-          },
-          "tokens_weight_threshold": {
-            "description": "Tokens whose weight is less than this threshold are considered nonsignificant and pruned.",
-            "type": "number"
-          },
-          "only_score_pruned_tokens": {
-            "description": "Whether to only score pruned tokens, vs only scoring kept tokens.",
-            "type": "boolean"
-          }
-        }
-      },
       "_types.query_dsl:WeightedTokensQuery": {
         "allOf": [
           {