[7.x] Make generated type docs more explorable (#47069) (#48252)

elastic · Oct 15, 2019 · 82fc260 · 82fc260
1 parent 8d0b8b1
commit 82fc260
Show file tree

Hide file tree

Showing 192 changed files with 1,781 additions and 1,154 deletions.
diff --git a/docs/development/core/public/kibana-plugin-public.contextsetup.md b/docs/development/core/public/kibana-plugin-public.contextsetup.md
@@ -91,18 +91,17 @@ export interface VizRenderContext {
 }
 
 export type VizRenderer = (context: VizRenderContext, domElement: HTMLElement) => () => void;
+// When a renderer is bound via `contextContainer.createHandler` this is the type that will be returned.
+type BoundVizRenderer = (domElement: HTMLElement) => () => void;
 
 class VizRenderingPlugin {
-  private readonly vizRenderers = new Map<string, ((domElement: HTMLElement) => () => void)>();
+  private readonly contextContainer?: IContextContainer<VizRenderer>;
+  private readonly vizRenderers = new Map<string, BoundVizRenderer>();
 
   constructor(private readonly initContext: PluginInitializerContext) {}
 
   setup(core) {
-    this.contextContainer = core.context.createContextContainer<
-      VizRenderContext,
-      ReturnType<VizRenderer>,
-      [HTMLElement]
-    >();
+    this.contextContainer = core.context.createContextContainer();
 
     return {
       registerContext: this.contextContainer.registerContext,

diff --git a/docs/development/core/public/kibana-plugin-public.errortoastoptions.md b/docs/development/core/public/kibana-plugin-public.errortoastoptions.md
@@ -4,6 +4,8 @@
 
 ## ErrorToastOptions interface
 
+Options available for [IToasts](./kibana-plugin-public.itoasts.md) APIs.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/docs/development/core/public/kibana-plugin-public.httperrorresponse.error.md b/docs/development/core/public/kibana-plugin-public.httperrorresponse.error.md
@@ -7,5 +7,5 @@
 <b>Signature:</b>
 
 ```typescript
-error: Error | HttpFetchError;
+error: Error | IHttpFetchError;
 ```
diff --git a/docs/development/core/public/kibana-plugin-public.httperrorresponse.md b/docs/development/core/public/kibana-plugin-public.httperrorresponse.md
@@ -16,7 +16,7 @@ export interface HttpErrorResponse
 |  Property | Type | Description |
 |  --- | --- | --- |
 |  [body](./kibana-plugin-public.httperrorresponse.body.md) | <code>HttpBody</code> |  |
-|  [error](./kibana-plugin-public.httperrorresponse.error.md) | <code>Error &#124; HttpFetchError</code> |  |
+|  [error](./kibana-plugin-public.httperrorresponse.error.md) | <code>Error &#124; IHttpFetchError</code> |  |
 |  [request](./kibana-plugin-public.httperrorresponse.request.md) | <code>Request</code> |  |
 |  [response](./kibana-plugin-public.httperrorresponse.response.md) | <code>Response</code> |  |
 
diff --git a/docs/development/core/public/kibana-plugin-public.httpfetcherror._constructor_.md b/docs/development/core/public/kibana-plugin-public.httpfetcherror._constructor_.md
diff --git a/docs/development/core/public/kibana-plugin-public.httpfetcherror.md b/docs/development/core/public/kibana-plugin-public.httpfetcherror.md
diff --git a/docs/development/core/public/kibana-plugin-public.httpfetcherror.response.md b/docs/development/core/public/kibana-plugin-public.httpfetcherror.response.md
diff --git a/docs/development/core/public/kibana-plugin-public.httpfetchoptions.headers.md b/docs/development/core/public/kibana-plugin-public.httpfetchoptions.headers.md
@@ -4,6 +4,8 @@
 
 ## HttpFetchOptions.headers property
 
+Headers to send with the request. See [HttpHeadersInit](./kibana-plugin-public.httpheadersinit.md)<!-- -->.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/docs/development/core/public/kibana-plugin-public.httpfetchoptions.md b/docs/development/core/public/kibana-plugin-public.httpfetchoptions.md
@@ -4,6 +4,7 @@
 
 ## HttpFetchOptions interface
 
+All options that may be used with a [HttpHandler](./kibana-plugin-public.httphandler.md)<!-- -->.
 
 <b>Signature:</b>
 
@@ -15,7 +16,7 @@ export interface HttpFetchOptions extends HttpRequestInit
 
 |  Property | Type | Description |
 |  --- | --- | --- |
-|  [headers](./kibana-plugin-public.httpfetchoptions.headers.md) | <code>HttpHeadersInit</code> |  |
-|  [prependBasePath](./kibana-plugin-public.httpfetchoptions.prependbasepath.md) | <code>boolean</code> |  |
-|  [query](./kibana-plugin-public.httpfetchoptions.query.md) | <code>HttpFetchQuery</code> |  |
+|  [headers](./kibana-plugin-public.httpfetchoptions.headers.md) | <code>HttpHeadersInit</code> | Headers to send with the request. See [HttpHeadersInit](./kibana-plugin-public.httpheadersinit.md)<!-- -->. |
+|  [prependBasePath](./kibana-plugin-public.httpfetchoptions.prependbasepath.md) | <code>boolean</code> | Whether or not the request should automatically prepend the basePath. Defaults to <code>true</code>. |
+|  [query](./kibana-plugin-public.httpfetchoptions.query.md) | <code>HttpFetchQuery</code> | The query string for an HTTP request. See [HttpFetchQuery](./kibana-plugin-public.httpfetchquery.md)<!-- -->. |
 
diff --git a/...evelopment/core/public/kibana-plugin-public.httpfetchoptions.prependbasepath.md b/...evelopment/core/public/kibana-plugin-public.httpfetchoptions.prependbasepath.md
@@ -4,6 +4,8 @@
 
 ## HttpFetchOptions.prependBasePath property
 
+Whether or not the request should automatically prepend the basePath. Defaults to `true`<!-- -->.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/docs/development/core/public/kibana-plugin-public.httpfetchoptions.query.md b/docs/development/core/public/kibana-plugin-public.httpfetchoptions.query.md
@@ -4,6 +4,8 @@
 
 ## HttpFetchOptions.query property
 
+The query string for an HTTP request. See [HttpFetchQuery](./kibana-plugin-public.httpfetchquery.md)<!-- -->.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/docs/development/core/public/kibana-plugin-public.httphandler.md b/docs/development/core/public/kibana-plugin-public.httphandler.md
@@ -4,6 +4,7 @@
 
 ## HttpHandler type
 
+A function for making an HTTP requests to Kibana's backend. See [HttpFetchOptions](./kibana-plugin-public.httpfetchoptions.md) for options and [HttpBody](./kibana-plugin-public.httpbody.md) for the response.
 
 <b>Signature:</b>
 

diff --git a/docs/development/core/public/kibana-plugin-public.httpinterceptcontroller.halt.md b/docs/development/core/public/kibana-plugin-public.httpinterceptcontroller.halt.md
diff --git a/.../development/core/public/kibana-plugin-public.httpinterceptcontroller.halted.md b/.../development/core/public/kibana-plugin-public.httpinterceptcontroller.halted.md
diff --git a/docs/development/core/public/kibana-plugin-public.httpinterceptcontroller.md b/docs/development/core/public/kibana-plugin-public.httpinterceptcontroller.md
diff --git a/docs/development/core/public/kibana-plugin-public.httpinterceptor.md b/docs/development/core/public/kibana-plugin-public.httpinterceptor.md
@@ -4,6 +4,7 @@
 
 ## HttpInterceptor interface
 
+An object that may define global interceptor functions for different parts of the request and response lifecycle. See [IHttpInterceptController](./kibana-plugin-public.ihttpinterceptcontroller.md)<!-- -->.
 
 <b>Signature:</b>
 
@@ -15,8 +16,8 @@ export interface HttpInterceptor
 
 |  Method | Description |
 |  --- | --- |
-|  [request(request, controller)](./kibana-plugin-public.httpinterceptor.request.md) |  |
-|  [requestError(httpErrorRequest, controller)](./kibana-plugin-public.httpinterceptor.requesterror.md) |  |
-|  [response(httpResponse, controller)](./kibana-plugin-public.httpinterceptor.response.md) |  |
-|  [responseError(httpErrorResponse, controller)](./kibana-plugin-public.httpinterceptor.responseerror.md) |  |
+|  [request(request, controller)](./kibana-plugin-public.httpinterceptor.request.md) | Define an interceptor to be executed before a request is sent. |
+|  [requestError(httpErrorRequest, controller)](./kibana-plugin-public.httpinterceptor.requesterror.md) | Define an interceptor to be executed if a request interceptor throws an error or returns a rejected Promise. |
+|  [response(httpResponse, controller)](./kibana-plugin-public.httpinterceptor.response.md) | Define an interceptor to be executed after a response is received. |
+|  [responseError(httpErrorResponse, controller)](./kibana-plugin-public.httpinterceptor.responseerror.md) | Define an interceptor to be executed if a response interceptor throws an error or returns a rejected Promise. |
 
diff --git a/docs/development/core/public/kibana-plugin-public.httpinterceptor.request.md b/docs/development/core/public/kibana-plugin-public.httpinterceptor.request.md
@@ -4,18 +4,20 @@
 
 ## HttpInterceptor.request() method
 
+Define an interceptor to be executed before a request is sent.
+
 <b>Signature:</b>
 
 ```typescript
-request?(request: Request, controller: HttpInterceptController): Promise<Request> | Request | void;
+request?(request: Request, controller: IHttpInterceptController): Promise<Request> | Request | void;
 ```
 
 ## Parameters
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  request | <code>Request</code> |  |
-|  controller | <code>HttpInterceptController</code> |  |
+|  controller | <code>IHttpInterceptController</code> |  |
 
 <b>Returns:</b>
 

diff --git a/docs/development/core/public/kibana-plugin-public.httpinterceptor.requesterror.md b/docs/development/core/public/kibana-plugin-public.httpinterceptor.requesterror.md
@@ -4,18 +4,20 @@
 
 ## HttpInterceptor.requestError() method
 
+Define an interceptor to be executed if a request interceptor throws an error or returns a rejected Promise.
+
 <b>Signature:</b>
 
 ```typescript
-requestError?(httpErrorRequest: HttpErrorRequest, controller: HttpInterceptController): Promise<Request> | Request | void;
+requestError?(httpErrorRequest: HttpErrorRequest, controller: IHttpInterceptController): Promise<Request> | Request | void;
 ```
 
 ## Parameters
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  httpErrorRequest | <code>HttpErrorRequest</code> |  |
-|  controller | <code>HttpInterceptController</code> |  |
+|  controller | <code>IHttpInterceptController</code> |  |
 
 <b>Returns:</b>
 

diff --git a/docs/development/core/public/kibana-plugin-public.httpinterceptor.response.md b/docs/development/core/public/kibana-plugin-public.httpinterceptor.response.md
@@ -4,18 +4,20 @@
 
 ## HttpInterceptor.response() method
 
+Define an interceptor to be executed after a response is received.
+
 <b>Signature:</b>
 
 ```typescript
-response?(httpResponse: HttpResponse, controller: HttpInterceptController): Promise<HttpResponse> | HttpResponse | void;
+response?(httpResponse: HttpResponse, controller: IHttpInterceptController): Promise<HttpResponse> | HttpResponse | void;
 ```
 
 ## Parameters
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  httpResponse | <code>HttpResponse</code> |  |
-|  controller | <code>HttpInterceptController</code> |  |
+|  controller | <code>IHttpInterceptController</code> |  |
 
 <b>Returns:</b>
 

diff --git a/docs/development/core/public/kibana-plugin-public.httpinterceptor.responseerror.md b/docs/development/core/public/kibana-plugin-public.httpinterceptor.responseerror.md
@@ -4,18 +4,20 @@
 
 ## HttpInterceptor.responseError() method
 
+Define an interceptor to be executed if a response interceptor throws an error or returns a rejected Promise.
+
 <b>Signature:</b>
 
 ```typescript
-responseError?(httpErrorResponse: HttpErrorResponse, controller: HttpInterceptController): Promise<HttpResponse> | HttpResponse | void;
+responseError?(httpErrorResponse: HttpErrorResponse, controller: IHttpInterceptController): Promise<HttpResponse> | HttpResponse | void;
 ```
 
 ## Parameters
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  httpErrorResponse | <code>HttpErrorResponse</code> |  |
-|  controller | <code>HttpInterceptController</code> |  |
+|  controller | <code>IHttpInterceptController</code> |  |
 
 <b>Returns:</b>
 

diff --git a/docs/development/core/public/kibana-plugin-public.httprequestinit.body.md b/docs/development/core/public/kibana-plugin-public.httprequestinit.body.md
@@ -4,6 +4,8 @@
 
 ## HttpRequestInit.body property
 
+A BodyInit object or null to set request's body.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/docs/development/core/public/kibana-plugin-public.httprequestinit.cache.md b/docs/development/core/public/kibana-plugin-public.httprequestinit.cache.md
@@ -4,6 +4,8 @@
 
 ## HttpRequestInit.cache property
 
+The cache mode associated with request, which is a string indicating how the request will interact with the browser's cache when fetching.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/docs/development/core/public/kibana-plugin-public.httprequestinit.credentials.md b/docs/development/core/public/kibana-plugin-public.httprequestinit.credentials.md
@@ -4,6 +4,8 @@
 
 ## HttpRequestInit.credentials property
 
+The credentials mode associated with request, which is a string indicating whether credentials will be sent with the request always, never, or only when sent to a same-origin URL.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/docs/development/core/public/kibana-plugin-public.httprequestinit.headers.md b/docs/development/core/public/kibana-plugin-public.httprequestinit.headers.md
@@ -4,6 +4,8 @@
 
 ## HttpRequestInit.headers property
 
+[HttpHeadersInit](./kibana-plugin-public.httpheadersinit.md)
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/docs/development/core/public/kibana-plugin-public.httprequestinit.integrity.md b/docs/development/core/public/kibana-plugin-public.httprequestinit.integrity.md
@@ -4,6 +4,8 @@
 
 ## HttpRequestInit.integrity property
 
+Subresource integrity metadata, which is a cryptographic hash of the resource being fetched. Its value consists of multiple hashes separated by whitespace.
+
 <b>Signature:</b>
 
 ```typescript

diff --git a/docs/development/core/public/kibana-plugin-public.httprequestinit.keepalive.md b/docs/development/core/public/kibana-plugin-public.httprequestinit.keepalive.md
@@ -4,6 +4,8 @@
 
 ## HttpRequestInit.keepalive property
 
+Whether or not request can outlive the global in which it was created.
+
 <b>Signature:</b>
 
 ```typescript