[Data] Align deprecation messages (#107175) (#107562)

* Move more utils to package and cleanup API

* docs and imports

* better imports

* change comment

* Better docs

* typos

* typo

* Align deprecation messages

* fixes

* casting

* Code review

* Update meta_filter.ts

* Update types.ts

* Deprecate by 8.1

Co-authored-by: Kibana Machine <[email protected]>
# Conflicts:
#	docs/development/plugins/data/server/kibana-plugin-plugins-data-server.buildqueryfromfilters.md
#	docs/development/plugins/data/server/kibana-plugin-plugins-data-server.esqueryconfig.md
#	docs/development/plugins/data/server/kibana-plugin-plugins-data-server.filter.md
#	docs/development/plugins/data/server/kibana-plugin-plugins-data-server.ifieldsubtype.md
#	docs/development/plugins/data/server/kibana-plugin-plugins-data-server.kuerynode.md
#	src/plugins/data/server/server.api.md

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.aggconfig.tojson.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> - Use serialize() instead.
+> Use serialize() instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.customfilter.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.esfilters.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import helpers from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import helpers from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 Filter helpers namespace:

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.eskuery.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import helpers from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import helpers from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.esquery.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import helpers from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import helpers from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.esqueryconfig.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.existsfilter.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.filter.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.ifieldsubtype.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.ifieldtype.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Use IndexPatternField or FieldSpec instead
+> Use [IndexPatternField](./kibana-plugin-plugins-data-public.indexpatternfield.md)  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpattern.addscriptedfield.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> use runtime field instead
+> use runtime field instead  8.0
 > 
 
 Add scripted field to field list

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpattern.getnonscriptedfields.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> use runtime field instead
+> use runtime field instead  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpattern.getscriptedfields.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> use runtime field instead
+> use runtime field instead  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpattern.intervalname.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Deprecated. used by time range index patterns
+> Used by time range index patterns  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpattern.removescriptedfield.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> use runtime field instead
+> use runtime field instead  8.0
 > 
 
 Remove scripted field from field list

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfield.md

@@ -4,6 +4,7 @@
 
 ## IndexPatternField class
 
+
 <b>Signature:</b>
 
 ```typescript

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.isfilter.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.isfilters.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.kuerynode.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.matchallfilter.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.phrasefilter.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.phrasesfilter.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.rangefilter.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.rangefiltermeta.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.rangefilterparams.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be removed in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.searchsource.fetch.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Use fetch$ instead
+> Use the `fetch$` method instead  8.0
 > 
 
 Fetch this source and reject the returned Promise on error

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.buildqueryfromfilters.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be deprecated in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.1
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.esqueryconfig.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be deprecated in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.1
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.filter.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be deprecated in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.1
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.ifieldsubtype.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Please import from the package kbn/es-query directly. This import will be deprecated in v8.0.0.
+> Import from the "<!-- -->@<!-- -->kbn/es-query" package directly instead.  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.ifieldtype.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Use IndexPatternField or FieldSpec instead
+> Use [IndexPatternField](./kibana-plugin-plugins-data-server.indexpatternfield.md)  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.indexpattern.addscriptedfield.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> use runtime field instead
+> use runtime field instead  8.0
 > 
 
 Add scripted field to field list

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.indexpattern.getnonscriptedfields.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> use runtime field instead
+> use runtime field instead  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.indexpattern.getscriptedfields.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> use runtime field instead
+> use runtime field instead  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.indexpattern.intervalname.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> Deprecated. used by time range index patterns
+> Used by time range index patterns  8.0
 > 
 
 <b>Signature:</b>

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.indexpattern.removescriptedfield.md

@@ -6,7 +6,7 @@
 
 > Warning: This API is now obsolete.
 > 
-> use runtime field instead
+> use runtime field instead  8.0
 > 
 
 Remove scripted field from field list

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.indexpatternfield._constructor_.md

@@ -0,0 +1,20 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-plugins-data-server](./kibana-plugin-plugins-data-server.md) &gt; [IndexPatternField](./kibana-plugin-plugins-data-server.indexpatternfield.md) &gt; [(constructor)](./kibana-plugin-plugins-data-server.indexpatternfield._constructor_.md)
+
+## IndexPatternField.(constructor)
+
+Constructs a new instance of the `IndexPatternField` class
+
+<b>Signature:</b>
+
+```typescript
+constructor(spec: FieldSpec);
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  spec | <code>FieldSpec</code> |  |
+

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.indexpatternfield.aggregatable.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-plugins-data-server](./kibana-plugin-plugins-data-server.md) &gt; [IndexPatternField](./kibana-plugin-plugins-data-server.indexpatternfield.md) &gt; [aggregatable](./kibana-plugin-plugins-data-server.indexpatternfield.aggregatable.md)
+
+## IndexPatternField.aggregatable property
+
+<b>Signature:</b>
+
+```typescript
+get aggregatable(): boolean;
+```

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.indexpatternfield.conflictdescriptions.md

@@ -0,0 +1,15 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-plugins-data-server](./kibana-plugin-plugins-data-server.md) &gt; [IndexPatternField](./kibana-plugin-plugins-data-server.indexpatternfield.md) &gt; [conflictDescriptions](./kibana-plugin-plugins-data-server.indexpatternfield.conflictdescriptions.md)
+
+## IndexPatternField.conflictDescriptions property
+
+Description of field type conflicts across different indices in the same index pattern
+
+<b>Signature:</b>
+
+```typescript
+get conflictDescriptions(): Record<string, string[]> | undefined;
+
+set conflictDescriptions(conflictDescriptions: Record<string, string[]> | undefined);
+```

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.indexpatternfield.count.md

@@ -0,0 +1,15 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-plugins-data-server](./kibana-plugin-plugins-data-server.md) &gt; [IndexPatternField](./kibana-plugin-plugins-data-server.indexpatternfield.md) &gt; [count](./kibana-plugin-plugins-data-server.indexpatternfield.count.md)
+
+## IndexPatternField.count property
+
+Count is used for field popularity
+
+<b>Signature:</b>
+
+```typescript
+get count(): number;
+
+set count(count: number);
+```