[ES|QL] Update function metadata (elastic#245490)

This PR updates the function definitions and inline docs based on the
latest metadata from Elasticsearch.

---------

Co-authored-by: Stratou <efstratia.kalafateli@elastic.co>

Author: kibanamachine

src/platform/packages/private/kbn-language-documentation/src/sections/generated/scalar_functions.tsx

@@ -283,6 +283,30 @@ export const functions = {
   ROW a=1.8
   | EVAL a=CEIL(a)
   \`\`\`
+  `,
+          description:
+            'Text is in markdown. Do not translate function names, special characters, or field names like sum(bytes)',
+          ignoreTag: true,
+        }),
+      },
+    },
+    // Do not edit manually... automatically generated by scripts/generate_esql_docs.ts
+    {
+      label: i18n.translate('languageDocumentation.documentationESQL.chunk', {
+        defaultMessage: 'CHUNK',
+      }),
+      preview: true,
+      license: undefined,
+      description: {
+        markdownContent: i18n.translate('languageDocumentation.documentationESQL.chunk.markdown', {
+          defaultMessage: `
+  ### CHUNK
+  Use \`CHUNK\` to split a text field into smaller chunks.
+
+  \`\`\`esql
+  FROM books
+  | EVAL chunks = CHUNK(description)
+  \`\`\`
   `,
           description:
             'Text is in markdown. Do not translate function names, special characters, or field names like sum(bytes)',
@@ -329,7 +353,7 @@ export const functions = {
         markdownContent: i18n.translate('languageDocumentation.documentationESQL.clamp.markdown', {
           defaultMessage: `
   ### CLAMP
-  Clamps the values of all samples to have a lower limit of min and an upper limit of max.
+  Limits (or clamps) the values of all samples to have a lower limit of min and an upper limit of max.
 
   \`\`\`esql
   TS k8s
@@ -356,7 +380,7 @@ export const functions = {
           {
             defaultMessage: `
   ### CLAMP MAX
-  Returns clamps the values of all input samples clamped to have an upper limit of max.
+  Limits (or clamps) all input sample values to an upper bound of max. Any value above max is reduced to max.
 
   \`\`\`esql
   TS k8s
@@ -383,7 +407,7 @@ export const functions = {
           {
             defaultMessage: `
   ### CLAMP MIN
-  Returns clamps the values of all input samples clamped to have a lower limit of min.
+  Limits (or clamps) all input sample values to a lower bound of min. Any value below min is set to min.
 
   \`\`\`esql
   FROM k8s

src/platform/packages/private/kbn-language-documentation/src/sections/generated/timeseries_aggregation_functions.tsx

@@ -163,7 +163,7 @@ export const functions = {
       label: i18n.translate('languageDocumentation.documentationESQL.deriv', {
         defaultMessage: 'DERIV',
       }),
-      preview: false,
+      preview: true,
       license: undefined,
       description: {
         markdownContent: i18n.translate('languageDocumentation.documentationESQL.deriv.markdown', {
@@ -172,7 +172,7 @@ export const functions = {
   Calculates the derivative over time of a numeric field using linear regression.
 
   \`\`\`esql
-  TS k8s
+  TS datenanos-k8s
   | WHERE pod == "three"
   | STATS max_deriv = MAX(DERIV(network.cost)) BY time_bucket = BUCKET(@timestamp,5minute), pod
   \`\`\`

src/platform/packages/shared/kbn-esql-ast/src/definitions/generated/scalar_functions.ts

@@ -811,7 +811,6 @@ const chunkDefinition: FunctionDefinition = {
   description: i18n.translate('kbn-esql-ast.esql.definitions.chunk', {
     defaultMessage: 'Use `CHUNK` to split a text field into smaller chunks.',
   }),
-  ignoreAsSuggestion: true,
   preview: true,
   alias: undefined,
   signatures: [
@@ -923,7 +922,7 @@ const clampDefinition: FunctionDefinition = {
   name: 'clamp',
   description: i18n.translate('kbn-esql-ast.esql.definitions.clamp', {
     defaultMessage:
-      'Clamps the values of all samples to have a lower limit of min and an upper limit of max.',
+      'Limits (or clamps) the values of all samples to have a lower limit of min and an upper limit of max.',
   }),
   preview: false,
   alias: undefined,
@@ -1373,7 +1372,7 @@ const clampMaxDefinition: FunctionDefinition = {
   name: 'clamp_max',
   description: i18n.translate('kbn-esql-ast.esql.definitions.clamp_max', {
     defaultMessage:
-      'Returns clamps the values of all input samples clamped to have an upper limit of max.',
+      'Limits (or clamps) all input sample values to an upper bound of max. Any value above max is reduced to max.',
   }),
   preview: false,
   alias: undefined,
@@ -1718,7 +1717,7 @@ const clampMinDefinition: FunctionDefinition = {
   name: 'clamp_min',
   description: i18n.translate('kbn-esql-ast.esql.definitions.clamp_min', {
     defaultMessage:
-      'Returns clamps the values of all input samples clamped to have a lower limit of min.',
+      'Limits (or clamps) all input sample values to a lower bound of min. Any value below min is set to min.',
   }),
   preview: false,
   alias: undefined,

src/platform/packages/shared/kbn-esql-ast/src/definitions/generated/settings.ts

@@ -12,7 +12,7 @@ const projectRouting = {
   name: 'project_routing',
   type: 'keyword',
   serverlessOnly: true,
-  preview: false,
+  preview: true,
   snapshotOnly: true,
   description:
     'A project routing expression, used to define which projects to route the query to. Only supported if Cross-Project Search is enabled.',

src/platform/packages/shared/kbn-esql-ast/src/definitions/generated/time_series_agg_functions.ts

@@ -1143,7 +1143,7 @@ const derivDefinition: FunctionDefinition = {
     defaultMessage:
       'Calculates the derivative over time of a numeric field using linear regression.',
   }),
-  preview: false,
+  preview: true,
   alias: undefined,
   signatures: [
     {
@@ -1179,7 +1179,7 @@ const derivDefinition: FunctionDefinition = {
   ],
   locationsAvailable: [Location.STATS_TIMESERIES],
   examples: [
-    'TS k8s\n| WHERE pod == "three"\n| STATS max_deriv = MAX(DERIV(network.cost)) BY time_bucket = BUCKET(@timestamp,5minute), pod',
+    'TS datenanos-k8s\n| WHERE pod == "three"\n| STATS max_deriv = MAX(DERIV(network.cost)) BY time_bucket = BUCKET(@timestamp,5minute), pod',
   ],
 };