From e69356190dc71f0b72c131ee8a73b14c97ce8b48 Mon Sep 17 00:00:00 2001
From: Anton Dosov <anton.dosov@elastic.co>
Date: Thu, 28 May 2020 18:08:03 +0200
Subject: [PATCH] wip

---
 ...utils-common-state_containers.basestate.md |  2 +-
 ...state_containers.basestatecontainer.get.md |  2 ++
 ...mon-state_containers.basestatecontainer.md |  6 ++--
 ...state_containers.basestatecontainer.set.md |  2 ++
 ...te_containers.basestatecontainer.state_.md |  2 ++
 ...state_containers.createstatecontainer_1.md |  2 +-
 ...state_containers.createstatecontainer_2.md |  6 ++--
 ...ainers.createstatecontainerreacthelpers.md |  2 +-
 ..._utils-common-state_containers.dispatch.md |  1 +
 ...n-state_containers.ensurepuretransition.md | 12 +++++++
 ...ns-kibana_utils-common-state_containers.md | 19 +++++-----
 ...tils-common-state_containers.middleware.md |  1 +
 ...a_utils-common-state_containers.reducer.md |  1 +
 ...tate_containers.reduxlikestatecontainer.md |  2 +-
 ...-common-state_containers.statecontainer.md |  2 +-
 ...e_containers.transitiondescription.args.md | 11 ------
 ...-state_containers.transitiondescription.md | 20 -----------
 ...e_containers.transitiondescription.type.md | 11 ------
 ...tils-common-state_containers.unboxstate.md | 13 +++++++
 ...mmon-state_containers.usecontainerstate.md |  2 +-
 src/dev/run_check_published_api_changes.ts    | 22 ++++++------
 .../common/state_containers/common.api.md     | 36 +++++++++----------
 .../create_state_container.ts                 | 12 +++----
 .../create_state_container_react_helpers.ts   | 14 ++++----
 .../common/state_containers/types.ts          | 34 ++++++++++++++----
 25 files changed, 125 insertions(+), 112 deletions(-)
 create mode 100644 docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.ensurepuretransition.md
 delete mode 100644 docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.args.md
 delete mode 100644 docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.md
 delete mode 100644 docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.type.md
 create mode 100644 docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.unboxstate.md

diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestate.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestate.md
index 84d047b893ec2f..92893afc02beff 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestate.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestate.md
@@ -4,7 +4,7 @@
 
 ## BaseState type
 
-Base state shape valid for state container
+Base [StateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) state shape
 
 <b>Signature:</b>
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.get.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.get.md
index f86872fc3a5513..b939954d92aa6e 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.get.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.get.md
@@ -4,6 +4,8 @@
 
 ## BaseStateContainer.get property
 
+Retrieves current state from the container
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.md
index 82a55f631b99bc..66c25c87f5e37d 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.md
@@ -16,7 +16,7 @@ export interface BaseStateContainer<State extends BaseState>
 
 |  Property | Type | Description |
 |  --- | --- | --- |
-|  [get](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.get.md) | <code>() =&gt; State</code> |  |
-|  [set](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.set.md) | <code>(state: State) =&gt; void</code> |  |
-|  [state$](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.state_.md) | <code>Observable&lt;State&gt;</code> |  |
+|  [get](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.get.md) | <code>() =&gt; State</code> | Retrieves current state from the container |
+|  [set](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.set.md) | <code>(state: State) =&gt; void</code> | Sets state into container |
+|  [state$](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.state_.md) | <code>Observable&lt;State&gt;</code> |  of state |
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.set.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.set.md
index 526471efb46c37..ed4ff365adfb35 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.set.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.set.md
@@ -4,6 +4,8 @@
 
 ## BaseStateContainer.set property
 
+Sets state into container
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.state_.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.state_.md
index 0a9bcb8e77c803..35838fa53d5390 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.state_.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.state_.md
@@ -4,6 +4,8 @@
 
 ## BaseStateContainer.state$ property
 
+ of state
+
 <b>Signature:</b>
 
 ```typescript
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainer_1.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainer_1.md
index 930e6db064c2df..794bf63588312f 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainer_1.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainer_1.md
@@ -17,7 +17,7 @@ export declare function createStateContainer<State extends BaseState, PureTransi
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  defaultState | <code>State</code> | initial state |
-|  pureTransitions | <code>PureTransitions</code> | state transitions configuration object |
+|  pureTransitions | <code>PureTransitions</code> | state transitions configuration object. Map of . |
 
 <b>Returns:</b>
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainer_2.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainer_2.md
index ec76679b5c0a74..1946baae202f1d 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainer_2.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainer_2.md
@@ -17,9 +17,9 @@ export declare function createStateContainer<State extends BaseState, PureTransi
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  defaultState | <code>State</code> | initial state |
-|  pureTransitions | <code>PureTransitions</code> | state transitions configuration object |
-|  pureSelectors | <code>PureSelectors</code> | state selectors configuration object |
-|  options | <code>CreateStateContainerOptions</code> |  |
+|  pureTransitions | <code>PureTransitions</code> | state transitions configuration object. Map of . |
+|  pureSelectors | <code>PureSelectors</code> | state selectors configuration object. Map of . |
+|  options | <code>CreateStateContainerOptions</code> | state container options [CreateStateContainerOptions](./kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontaineroptions.md) |
 
 <b>Returns:</b>
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainerreacthelpers.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainerreacthelpers.md
index 8b0a8aaf9ea83a..43dc4659fd4c6a 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainerreacthelpers.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainerreacthelpers.md
@@ -4,7 +4,7 @@
 
 ## createStateContainerReactHelpers variable
 
-Creates helpers for using [State Containers](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) with react
+Creates helpers for using [State Containers](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) with react Refer to \[guide\](https://github.com/elastic/kibana/blob/master/src/plugins/kibana\_utils/docs/state\_containers/react.md) for details
 
 <b>Signature:</b>
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.dispatch.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.dispatch.md
index f2f0cb0b44a3a2..d4057a549bb0dc 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.dispatch.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.dispatch.md
@@ -4,6 +4,7 @@
 
 ## Dispatch type
 
+Redux like dispatch
 
 <b>Signature:</b>
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.ensurepuretransition.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.ensurepuretransition.md
new file mode 100644
index 00000000000000..0e621e989346b4
--- /dev/null
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.ensurepuretransition.md
@@ -0,0 +1,12 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-plugins-kibana\_utils-common-state\_containers](./kibana-plugin-plugins-kibana_utils-common-state_containers.md) &gt; [EnsurePureTransition](./kibana-plugin-plugins-kibana_utils-common-state_containers.ensurepuretransition.md)
+
+## EnsurePureTransition type
+
+
+<b>Signature:</b>
+
+```typescript
+export declare type EnsurePureTransition<T> = Ensure<T, PureTransition<any, any>>;
+```
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.md
index 477d9e27497f38..00dc65dba636ad 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.md
@@ -20,28 +20,29 @@ State containers are Redux-store-like objects meant to help you manage state in
 |  --- | --- |
 |  [BaseStateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.md) | Base state container shape without transitions or selectors |
 |  [CreateStateContainerOptions](./kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontaineroptions.md) | State container options |
-|  [ReduxLikeStateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.reduxlikestatecontainer.md) | Fully featured state container which matches Redux store interface |
-|  [StateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) | Fully featured state container with selectors and transitions |
-|  [TransitionDescription](./kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.md) |  |
+|  [ReduxLikeStateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.reduxlikestatecontainer.md) | Fully featured state container which matches Redux store interface. Extends [StateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) Allows to use state container with redux libraries |
+|  [StateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) | Fully featured state container with  and . Extends [BaseStateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.md) |
 
 ## Variables
 
 |  Variable | Description |
 |  --- | --- |
-|  [createStateContainerReactHelpers](./kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainerreacthelpers.md) | Creates helpers for using [State Containers](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) with react |
+|  [createStateContainerReactHelpers](./kibana-plugin-plugins-kibana_utils-common-state_containers.createstatecontainerreacthelpers.md) | Creates helpers for using [State Containers](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) with react Refer to \[guide\](https://github.com/elastic/kibana/blob/master/src/plugins/kibana\_utils/docs/state\_containers/react.md) for details |
 |  [useContainerSelector](./kibana-plugin-plugins-kibana_utils-common-state_containers.usecontainerselector.md) | Apply selector to state container to extract only needed information. Will re-render your component only when the section changes. |
-|  [useContainerState](./kibana-plugin-plugins-kibana_utils-common-state_containers.usecontainerstate.md) | Returns the latest state of a state container. |
+|  [useContainerState](./kibana-plugin-plugins-kibana_utils-common-state_containers.usecontainerstate.md) | Returns the latest state of a [StateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md)<!-- -->. |
 
 ## Type Aliases
 
 |  Type Alias | Description |
 |  --- | --- |
-|  [BaseState](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestate.md) | Base state shape valid for state container |
+|  [BaseState](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestate.md) | Base [StateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) state shape |
 |  [Comparator](./kibana-plugin-plugins-kibana_utils-common-state_containers.comparator.md) |  |
 |  [Connect](./kibana-plugin-plugins-kibana_utils-common-state_containers.connect.md) |  |
-|  [Dispatch](./kibana-plugin-plugins-kibana_utils-common-state_containers.dispatch.md) |  |
+|  [Dispatch](./kibana-plugin-plugins-kibana_utils-common-state_containers.dispatch.md) | Redux like dispatch |
+|  [EnsurePureTransition](./kibana-plugin-plugins-kibana_utils-common-state_containers.ensurepuretransition.md) |  |
 |  [MapStateToProps](./kibana-plugin-plugins-kibana_utils-common-state_containers.mapstatetoprops.md) |  |
-|  [Middleware](./kibana-plugin-plugins-kibana_utils-common-state_containers.middleware.md) |  |
+|  [Middleware](./kibana-plugin-plugins-kibana_utils-common-state_containers.middleware.md) | Redux like Middleware |
 |  [PureSelector](./kibana-plugin-plugins-kibana_utils-common-state_containers.pureselector.md) |  |
-|  [Reducer](./kibana-plugin-plugins-kibana_utils-common-state_containers.reducer.md) |  |
+|  [Reducer](./kibana-plugin-plugins-kibana_utils-common-state_containers.reducer.md) | Redux like Reducer |
+|  [UnboxState](./kibana-plugin-plugins-kibana_utils-common-state_containers.unboxstate.md) | Utility type for inferring state shape from [StateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) |
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.middleware.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.middleware.md
index 38c0a8949ab1ef..574b83306dc959 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.middleware.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.middleware.md
@@ -4,6 +4,7 @@
 
 ## Middleware type
 
+Redux like Middleware
 
 <b>Signature:</b>
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.reducer.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.reducer.md
index 8153ea4e544e13..519e6ce7d7cfb3 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.reducer.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.reducer.md
@@ -4,6 +4,7 @@
 
 ## Reducer type
 
+Redux like Reducer
 
 <b>Signature:</b>
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.reduxlikestatecontainer.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.reduxlikestatecontainer.md
index 723e4fecfa6d6b..0e08119c1eae44 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.reduxlikestatecontainer.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.reduxlikestatecontainer.md
@@ -4,7 +4,7 @@
 
 ## ReduxLikeStateContainer interface
 
-Fully featured state container which matches Redux store interface
+Fully featured state container which matches Redux store interface. Extends [StateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md) Allows to use state container with redux libraries
 
 <b>Signature:</b>
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md
index fb4550f319bcb3..ac1fb47e53dba5 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md
@@ -4,7 +4,7 @@
 
 ## StateContainer interface
 
-Fully featured state container with selectors and transitions
+Fully featured state container with  and . Extends [BaseStateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.basestatecontainer.md)
 
 <b>Signature:</b>
 
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.args.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.args.md
deleted file mode 100644
index 78a5708a8b4497..00000000000000
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.args.md
+++ /dev/null
@@ -1,11 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [kibana-plugin-plugins-kibana\_utils-common-state\_containers](./kibana-plugin-plugins-kibana_utils-common-state_containers.md) &gt; [TransitionDescription](./kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.md) &gt; [args](./kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.args.md)
-
-## TransitionDescription.args property
-
-<b>Signature:</b>
-
-```typescript
-args: Args;
-```
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.md
deleted file mode 100644
index b0e7415f4f658f..00000000000000
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.md
+++ /dev/null
@@ -1,20 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [kibana-plugin-plugins-kibana\_utils-common-state\_containers](./kibana-plugin-plugins-kibana_utils-common-state_containers.md) &gt; [TransitionDescription](./kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.md)
-
-## TransitionDescription interface
-
-
-<b>Signature:</b>
-
-```typescript
-export interface TransitionDescription<Type extends string = string, Args extends any[] = any[]> 
-```
-
-## Properties
-
-|  Property | Type | Description |
-|  --- | --- | --- |
-|  [args](./kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.args.md) | <code>Args</code> |  |
-|  [type](./kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.type.md) | <code>Type</code> |  |
-
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.type.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.type.md
deleted file mode 100644
index 274a16f680df75..00000000000000
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.type.md
+++ /dev/null
@@ -1,11 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [kibana-plugin-plugins-kibana\_utils-common-state\_containers](./kibana-plugin-plugins-kibana_utils-common-state_containers.md) &gt; [TransitionDescription](./kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.md) &gt; [type](./kibana-plugin-plugins-kibana_utils-common-state_containers.transitiondescription.type.md)
-
-## TransitionDescription.type property
-
-<b>Signature:</b>
-
-```typescript
-type: Type;
-```
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.unboxstate.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.unboxstate.md
new file mode 100644
index 00000000000000..d4f99841456d74
--- /dev/null
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.unboxstate.md
@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-plugins-kibana\_utils-common-state\_containers](./kibana-plugin-plugins-kibana_utils-common-state_containers.md) &gt; [UnboxState](./kibana-plugin-plugins-kibana_utils-common-state_containers.unboxstate.md)
+
+## UnboxState type
+
+Utility type for inferring state shape from [StateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md)
+
+<b>Signature:</b>
+
+```typescript
+export declare type UnboxState<Container extends StateContainer<any, any>> = Container extends StateContainer<infer T, any> ? T : never;
+```
diff --git a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.usecontainerstate.md b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.usecontainerstate.md
index 0eb4c75c86f3a8..5a8de7a1dd36b5 100644
--- a/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.usecontainerstate.md
+++ b/docs/development/plugins/kibana_utils/common/state_containers/kibana-plugin-plugins-kibana_utils-common-state_containers.usecontainerstate.md
@@ -4,7 +4,7 @@
 
 ## useContainerState variable
 
-Returns the latest state of a state container.
+Returns the latest state of a [StateContainer](./kibana-plugin-plugins-kibana_utils-common-state_containers.statecontainer.md)<!-- -->.
 
 <b>Signature:</b>
 
diff --git a/src/dev/run_check_published_api_changes.ts b/src/dev/run_check_published_api_changes.ts
index ddd4e2e4c6a890..13d774480d458d 100644
--- a/src/dev/run_check_published_api_changes.ts
+++ b/src/dev/run_check_published_api_changes.ts
@@ -142,7 +142,7 @@ const runApiExtractor = (
     messageCallback: (message: ExtractorMessage) => {
       if (message.messageId === 'console-api-report-not-copied') {
         // ConsoleMessageId.ApiReportNotCopied
-        log.warning(`You have changed the signature of the ${folder} Core API`);
+        log.warning(`You have changed the signature of the ${folder} public API`);
         log.warning(
           'To accept these changes run `node scripts/check_published_api_changes.js --accept` and then:\n' +
             "\t 1. Commit the updated documentation and API review file '" +
@@ -153,7 +153,7 @@ const runApiExtractor = (
         message.handled = true;
       } else if (message.messageId === 'console-api-report-copied') {
         // ConsoleMessageId.ApiReportCopied
-        log.warning(`You have changed the signature of the ${folder} Core API`);
+        log.warning(`You have changed the signature of the ${folder} public API`);
         log.warning(
           "Please commit the updated API documentation and the API review file: '" +
             config.reportFilePath
@@ -161,7 +161,7 @@ const runApiExtractor = (
         message.handled = true;
       } else if (message.messageId === 'console-api-report-unchanged') {
         // ConsoleMessageId.ApiReportUnchanged
-        log.info(`Core ${folder} API: no changes detected ✔`);
+        log.info(`${folder} API: no changes detected ✔`);
         message.handled = true;
       }
     },
@@ -181,7 +181,7 @@ async function run(
   folder: string,
   { log, opts }: { log: ToolingLog; opts: Options }
 ): Promise<boolean> {
-  log.info(`Core ${folder} API: checking for changes in API signature...`);
+  log.info(`${folder} API: checking for changes in API signature...`);
 
   const { apiReportChanged, succeeded } = runApiExtractor(log, folder, opts.accept);
 
@@ -199,7 +199,7 @@ async function run(
       log.error(e);
       return false;
     }
-    log.info(`Core ${folder} API: updated documentation ✔`);
+    log.info(`${folder} API: updated documentation ✔`);
   }
 
   // If the api signature changed or any errors or warnings occured, exit with an error
@@ -248,17 +248,17 @@ async function run(
       dedent(chalk`
         {dim usage:} node scripts/check_published_api_changes [...options]
 
-        Checks for any changes to the Kibana Core API
+        Checks for any changes to the Kibana shared API
 
         Examples:
 
-          {dim # Checks for any changes to the Kibana Core API}
+          {dim # Checks for any changes to the Kibana shared API}
           {dim $} node scripts/check_published_api_changes
 
-          {dim # Checks for any changes to the Kibana Core API and updates the documentation}
+          {dim # Checks for any changes to the Kibana shared API and updates the documentation}
           {dim $} node scripts/check_published_api_changes --docs
 
-          {dim # Checks for and automatically accepts and updates documentation for any changes to the Kibana Core API}
+          {dim # Checks for and automatically accepts and updates documentation for any changes to the Kibana shared API}
           {dim $} node scripts/check_published_api_changes --accept
 
           {dim # Only checks the core/public directory}
@@ -266,7 +266,7 @@ async function run(
 
         Options:
           --accept    {dim Accepts all changes by updating the API Review files and documentation}
-          --docs      {dim Updates the Core API documentation}
+          --docs      {dim Updates the API documentation}
           --filter    {dim RegExp that folder names must match, folders: [${folders.join(', ')}]}
           --help      {dim Show this message}
       `)
@@ -276,7 +276,7 @@ async function run(
   }
 
   try {
-    log.info(`Core: Building types...`);
+    log.info(`Building types for api extractor...`);
     await runBuildTypes();
   } catch (e) {
     log.error(e);
diff --git a/src/plugins/kibana_utils/common/state_containers/common.api.md b/src/plugins/kibana_utils/common/state_containers/common.api.md
index a5aaf009657b1e..c3bb08fbf7d764 100644
--- a/src/plugins/kibana_utils/common/state_containers/common.api.md
+++ b/src/plugins/kibana_utils/common/state_containers/common.api.md
@@ -15,11 +15,9 @@ export type BaseState = object;
 
 // @public
 export interface BaseStateContainer<State extends BaseState> {
-    // (undocumented)
     get: () => State;
-    // (undocumented)
     set: (state: State) => void;
-    // (undocumented)
+    // Warning: (ae-unresolved-link) The @link reference could not be resolved: The package "kibana" does not have an export "Observable"
     state$: Observable<State>;
 }
 
@@ -35,6 +33,8 @@ export function createStateContainer<State extends BaseState>(defaultState: Stat
 // @public
 export function createStateContainer<State extends BaseState, PureTransitions extends object>(defaultState: State, pureTransitions: PureTransitions): ReduxLikeStateContainer<State, PureTransitions>;
 
+// Warning: (ae-unresolved-link) The @link reference could not be resolved: The package "kibana" does not have an export "PureSelectors"
+//
 // @public
 export function createStateContainer<State extends BaseState, PureTransitions extends object, PureSelectors extends object>(defaultState: State, pureTransitions: PureTransitions, pureSelectors: PureSelectors, options?: CreateStateContainerOptions): ReduxLikeStateContainer<State, PureTransitions, PureSelectors>;
 
@@ -55,19 +55,23 @@ export const createStateContainerReactHelpers: <Container extends StateContainer
     connect: Connect<UnboxState<Container>>;
 };
 
-// @public (undocumented)
+// @public
 export type Dispatch<T> = (action: T) => void;
 
 // @internal (undocumented)
 export type EnsurePureSelector<T> = Ensure<T, PureSelector<any, any, any>>;
 
-// @internal (undocumented)
+// Warning: (ae-incompatible-release-tags) The symbol "EnsurePureTransition" is marked as @public, but its signature references "PureTransition" which is marked as @internal
+//
+// @public (undocumented)
 export type EnsurePureTransition<T> = Ensure<T, PureTransition<any, any>>;
 
 // @public (undocumented)
 export type MapStateToProps<State extends BaseState, StateProps extends object> = (state: State) => StateProps;
 
-// @public (undocumented)
+// Warning: (ae-incompatible-release-tags) The symbol "Middleware" is marked as @public, but its signature references "TransitionDescription" which is marked as @internal
+//
+// @public
 export type Middleware<State extends BaseState = BaseState> = (store: Pick<ReduxLikeStateContainer<State, any>, 'getState' | 'dispatch'>) => (next: (action: TransitionDescription) => TransitionDescription | any) => Dispatch<TransitionDescription>;
 
 // Warning: (ae-incompatible-release-tags) The symbol "PureSelector" is marked as @public, but its signature references "Selector" which is marked as @internal
@@ -94,13 +98,17 @@ export type PureTransitionsToTransitions<T extends object> = {
 // @internal (undocumented)
 export type PureTransitionToTransition<T extends PureTransition<any, any>> = ReturnType<T>;
 
-// @public (undocumented)
+// Warning: (ae-incompatible-release-tags) The symbol "Reducer" is marked as @public, but its signature references "TransitionDescription" which is marked as @internal
+//
+// @public
 export type Reducer<State extends BaseState> = (state: State, action: TransitionDescription) => State;
 
 // @public
 export interface ReduxLikeStateContainer<State extends BaseState, PureTransitions extends object = {}, PureSelectors extends object = {}> extends StateContainer<State, PureTransitions, PureSelectors> {
     // (undocumented)
     addMiddleware: (middleware: Middleware<State>) => void;
+    // Warning: (ae-incompatible-release-tags) The symbol "dispatch" is marked as @public, but its signature references "TransitionDescription" which is marked as @internal
+    //
     // (undocumented)
     dispatch: (action: TransitionDescription) => void;
     // (undocumented)
@@ -131,7 +139,7 @@ export interface StateContainer<State extends BaseState, PureTransitions extends
 // @internal (undocumented)
 export type Transition<State extends BaseState, Args extends any[]> = (...args: Args) => State;
 
-// @public (undocumented)
+// @internal (undocumented)
 export interface TransitionDescription<Type extends string = string, Args extends any[] = any[]> {
     // (undocumented)
     args: Args;
@@ -139,24 +147,14 @@ export interface TransitionDescription<Type extends string = string, Args extend
     type: Type;
 }
 
-// @internal
+// @public
 export type UnboxState<Container extends StateContainer<any, any>> = Container extends StateContainer<infer T, any> ? T : never;
 
-// Warning: (ae-incompatible-release-tags) The symbol "useContainerSelector" is marked as @public, but its signature references "UnboxState" which is marked as @internal
-//
 // @public
 export const useContainerSelector: <Container extends StateContainer<any, any, {}>, Result>(container: Container, selector: (state: UnboxState<Container>) => Result, comparator?: Comparator<Result>) => Result;
 
-// Warning: (ae-incompatible-release-tags) The symbol "useContainerState" is marked as @public, but its signature references "UnboxState" which is marked as @internal
-//
 // @public
 export const useContainerState: <Container extends StateContainer<any, any, {}>>(container: Container) => UnboxState<Container>;
 
 
-// Warnings were encountered during analysis:
-//
-// src/plugins/kibana_utils/common/state_containers/create_state_container_react_helpers.ts:78:46 - (ae-incompatible-release-tags) The symbol "useState" is marked as @public, but its signature references "UnboxState" which is marked as @internal
-// src/plugins/kibana_utils/common/state_containers/create_state_container_react_helpers.ts:78:46 - (ae-incompatible-release-tags) The symbol "useSelector" is marked as @public, but its signature references "UnboxState" which is marked as @internal
-// src/plugins/kibana_utils/common/state_containers/create_state_container_react_helpers.ts:78:46 - (ae-incompatible-release-tags) The symbol "connect" is marked as @public, but its signature references "UnboxState" which is marked as @internal
-
 ```
diff --git a/src/plugins/kibana_utils/common/state_containers/create_state_container.ts b/src/plugins/kibana_utils/common/state_containers/create_state_container.ts
index 9777a27c005e83..8b526949162360 100644
--- a/src/plugins/kibana_utils/common/state_containers/create_state_container.ts
+++ b/src/plugins/kibana_utils/common/state_containers/create_state_container.ts
@@ -46,7 +46,6 @@ const defaultFreeze: <T>(value: T) => T = isProduction
 
 /**
  * State container options
- *
  * @public
  */
 export interface CreateStateContainerOptions {
@@ -77,7 +76,7 @@ export function createStateContainer<State extends BaseState>(
 /**
  * Creates a state container with transitions, but without selectors
  * @param defaultState - initial state
- * @param pureTransitions - state transitions configuration object
+ * @param pureTransitions - state transitions configuration object. Map of {@link PureTransition}.
  * @typeParam State - shape of state
  * @public
  */
@@ -89,8 +88,9 @@ export function createStateContainer<State extends BaseState, PureTransitions ex
 /**
  * Creates a state container with transitions and selectors
  * @param defaultState - initial state
- * @param pureTransitions - state transitions configuration object
- * @param pureSelectors - state selectors configuration object
+ * @param pureTransitions - state transitions configuration object. Map of {@link PureTransition}.
+ * @param pureSelectors - state selectors configuration object. Map of {@link PureSelectors}.
+ * @param options - state container options {@link CreateStateContainerOptions}
  * @typeParam State - shape of state
  * @public
  */
@@ -113,8 +113,8 @@ export function createStateContainer<
   PureSelectors extends object
 >(
   defaultState: State,
-  pureTransitions: PureTransitions = {} as PureTransitions,
-  pureSelectors: PureSelectors = {} as PureSelectors,
+  pureTransitions: PureTransitions = {} as PureTransitions, // TODO: https://github.com/elastic/kibana/issues/54439
+  pureSelectors: PureSelectors = {} as PureSelectors, // TODO: https://github.com/elastic/kibana/issues/54439
   options: CreateStateContainerOptions = {}
 ): ReduxLikeStateContainer<State, PureTransitions, PureSelectors> {
   const { freeze = defaultFreeze } = options;
diff --git a/src/plugins/kibana_utils/common/state_containers/create_state_container_react_helpers.ts b/src/plugins/kibana_utils/common/state_containers/create_state_container_react_helpers.ts
index f68fff619a91e2..60973f6a34dd7b 100644
--- a/src/plugins/kibana_utils/common/state_containers/create_state_container_react_helpers.ts
+++ b/src/plugins/kibana_utils/common/state_containers/create_state_container_react_helpers.ts
@@ -25,9 +25,10 @@ import { Comparator, Connect, StateContainer, UnboxState } from './types';
 const { useContext, useLayoutEffect, useRef, createElement: h } = React;
 
 /**
- * Returns the latest state of a state container.
+ * Returns the latest state of a {@link StateContainer}.
  *
- * @param container State container which state to track.
+ * @param container - {@link StateContainer} which state to track.
+ * @returns - latest {@link StateContainer} state
  * @public
  */
 export const useContainerState = <Container extends StateContainer<any, any>>(
@@ -38,11 +39,12 @@ export const useContainerState = <Container extends StateContainer<any, any>>(
  * Apply selector to state container to extract only needed information. Will
  * re-render your component only when the section changes.
  *
- * @param container State container which state to track.
- * @param selector Function used to pick parts of state.
- * @param comparator Comparator function used to memoize previous result, to not
+ * @param container - {@link StateContainer} which state to track.
+ * @param selector - Function used to pick parts of state.
+ * @param comparator - {@link Comparator} function used to memoize previous result, to not
  *    re-render React component if state did not change. By default uses
  *    `fast-deep-equal` package.
+ * @returns - result of a selector(state)
  * @public
  */
 export const useContainerSelector = <Container extends StateContainer<any, any>, Result>(
@@ -72,7 +74,7 @@ export const useContainerSelector = <Container extends StateContainer<any, any>,
 
 /**
  * Creates helpers for using {@link StateContainer | State Containers} with react
- *
+ * Refer to [guide](https://github.com/elastic/kibana/blob/master/src/plugins/kibana_utils/docs/state_containers/react.md) for details
  * @public
  */
 export const createStateContainerReactHelpers = <Container extends StateContainer<any, any>>() => {
diff --git a/src/plugins/kibana_utils/common/state_containers/types.ts b/src/plugins/kibana_utils/common/state_containers/types.ts
index 16970b0de23b2c..5f9abbf7c27e39 100644
--- a/src/plugins/kibana_utils/common/state_containers/types.ts
+++ b/src/plugins/kibana_utils/common/state_containers/types.ts
@@ -22,13 +22,13 @@ import { Ensure } from '@kbn/utility-types';
 import { FC, ComponentType } from 'react';
 
 /**
- * Base state shape valid for state container
+ * Base {@link StateContainer} state shape
  * @public
  */
 export type BaseState = object;
 
 /**
- * @public
+ * @internal
  */
 export interface TransitionDescription<Type extends string = string, Args extends any[] = any[]> {
   type: Type;
@@ -45,7 +45,7 @@ export type PureTransition<State extends BaseState, Args extends any[]> = (
   state: State
 ) => Transition<State, Args>;
 /**
- * @internal
+ * @public
  */
 export type EnsurePureTransition<T> = Ensure<T, PureTransition<any, any>>;
 /**
@@ -61,16 +61,32 @@ export type PureTransitionsToTransitions<T extends object> = {
 
 /**
  * Base state container shape without transitions or selectors
+ * @typeParam State - Shape of state in the container. Have to match {@link BaseState} constraint
  * @public
  */
 export interface BaseStateContainer<State extends BaseState> {
+  /**
+   * Retrieves current state from the container
+   * @returns current state
+   * @public
+   */
   get: () => State;
+  /**
+   * Sets state into container
+   * @param state - new state to set
+   */
   set: (state: State) => void;
+  /**
+   * {@link Observable} of state
+   */
   state$: Observable<State>;
 }
 
 /**
- * Fully featured state container with selectors and transitions
+ * Fully featured state container with {@link Selector | Selectors} and {@link Transition | Transitions}. Extends {@link BaseStateContainer}
+ * @typeParam State - Shape of state in the container. Has to match {@link BaseState} constraint
+ * @typeParam PureTransitions - map of {@link PureTransition | transitions} to provide on state container
+ * @typeParam PureSelectors - map of {@link PureSelector | selectors} to provide on state container
  * @public
  */
 export interface StateContainer<
@@ -83,7 +99,8 @@ export interface StateContainer<
 }
 
 /**
- * Fully featured state container which matches Redux store interface
+ * Fully featured state container which matches Redux store interface. Extends {@link StateContainer}
+ * Allows to use state container with redux libraries
  * @public
  */
 export interface ReduxLikeStateContainer<
@@ -100,10 +117,12 @@ export interface ReduxLikeStateContainer<
 }
 
 /**
+ * Redux like dispatch
  * @public
  */
 export type Dispatch<T> = (action: T) => void;
 /**
+ * Redux like Middleware
  * @public
  */
 export type Middleware<State extends BaseState = BaseState> = (
@@ -112,6 +131,7 @@ export type Middleware<State extends BaseState = BaseState> = (
   next: (action: TransitionDescription) => TransitionDescription | any
 ) => Dispatch<TransitionDescription>;
 /**
+ * Redux like Reducer
  * @public
  */
 export type Reducer<State extends BaseState> = (
@@ -121,14 +141,14 @@ export type Reducer<State extends BaseState> = (
 
 /**
  * Utility type for inferring state shape from {@link StateContainer}
- * @internal
+ * @public
  */
 export type UnboxState<
   Container extends StateContainer<any, any>
 > = Container extends StateContainer<infer T, any> ? T : never;
 /**
  * Utility type for inferring transitions type from {@link StateContainer}
- * @internal
+ * @public
  */
 export type UnboxTransitions<
   Container extends StateContainer<any, any>