EntityCollectionsRepository computed entitiesArray (#623)

* feat: entities array observable in data entity collections

* feat: entities array observable test

* feat: entities array observable doc

* feat: entities array snapshot

* feat: entities array docs

* feat: entities array tests

Author: andrewDyakin

docs/pages/state-repository.md

@@ -82,7 +82,10 @@ class ArticleEntitiesState extends NgxsDataEntityCollectionsRepository<Article>
 | state.snapshot                                      | NgxsEntityCollections&lt;V, K&gt;                   | Memoized state value (getter)                                               |
 | state.reset()                                       | void                                                | Reset state with default state value                                        |
 | state.state\$                                       | Observable&lt;NgxsEntityCollections&lt;V, K&gt;&gt; | State data stream that you can subscribe to changes                         |
-| state.entityArray\$                                 | Observable&lt;V[]&gt;                               | Observable of entities array                                                |
+| state.entities()                                    | EntityDictionary<K, V>                              | Entities dictionary                                                         |
+| state.entitiesArray()                               | V[]                                                 | Entities array                                                              |
+| state.entities$                                     | Observable<EntityDictionary<K, V>>                  | Observable of entities dictionary                                           |
+| state.entitiesArray$                                | Observable<V[]>                                     | Observable of entities array                                                |
 | dispatch(actions: ActionType &verbar; ActionType[]) | void                                                | Standard dispatch method                                                    |
 | state.addOne(entity: V)                             | void                                                | Add one entity to the collection                                            |
 | state.addMany(entities: V[])                        | void                                                | Add multiple entities to the collection                                     |

integration/tests/entity/entity.spec.ts

@@ -691,5 +691,50 @@ describe('[TEST]: Entity', () => {
                 expect(article.getState()).toEqual({ ids: [], entities: {} });
             })
         );
+
+        it(
+            '@article.entities',
+            ngxsTestingPlatform([ArticleEntitiesState], (store, article) => {
+                expect(store.snapshot()).toEqual({ article: { ids: [], entities: {} } });
+                expect(article.entities).toEqual({});
+
+                article.setAll([
+                    { id: 1, title: 'A_W', category: 'A_O' },
+                    { id: 2, title: 'B_W', category: 'B_O' },
+                    { id: 3, title: 'C_W', category: 'C_O' },
+                    { id: 4, title: 'D_W', category: 'D_O' }
+                ]);
+
+                expect(article.entities).toEqual({
+                    '1': { id: 1, title: 'A_W', category: 'A_O' },
+                    '2': { id: 2, title: 'B_W', category: 'B_O' },
+                    '3': { id: 3, title: 'C_W', category: 'C_O' },
+                    '4': { id: 4, title: 'D_W', category: 'D_O' }
+                });
+            })
+        );
+
+        it(
+            '@article.entitiesArray',
+            ngxsTestingPlatform([ArticleEntitiesState], (store, article) => {
+                expect(store.snapshot()).toEqual({ article: { ids: [], entities: {} } });
+                expect(article.entitiesArray).toEqual([]);
+
+                article.setAll([
+                    { id: 1, title: 'A_W', category: 'A_O' },
+                    { id: 2, title: 'B_W', category: 'B_O' },
+                    { id: 3, title: 'C_W', category: 'C_O' },
+                    { id: 4, title: 'D_W', category: 'D_O' }
+                ]);
+
+                expect(article.entitiesArray).toEqual([
+                    { id: 1, title: 'A_W', category: 'A_O' },
+                    { id: 2, title: 'B_W', category: 'B_O' },
+                    { id: 3, title: 'C_W', category: 'C_O' },
+                    { id: 4, title: 'D_W', category: 'D_O' }
+                ]);
+            })
+        );
+
     });
 });

lib/repositories/src/ngxs-data-entity-collections/ngxs-data-entity-collections.repository.ts

@@ -49,6 +49,12 @@ export abstract class AbstractNgxsDataEntityCollectionsRepository<
         return this.snapshot.entities;
     }
 
+    @Computed()
+    public get entitiesArray(): V[] {
+        const snapshot = this.snapshot;
+        return snapshot.ids.map(id => snapshot.entities[id]);
+    }
+
     @Computed()
     public get ids$(): Observable<K[]> {
         return this.state$.pipe(map((value: EntityCollections<V, K, C>): K[] => value.ids));