[Umbrella] ASCollectionView -> ASCollectionNode Migration, Separate Index Spaces (#2372)

* Separate dataSource & UIKit index spaces

Beef up our supplementary node support

Make the API way better

Go nuts

Add a unit test for UICollectionView's handling of reloadData inside batch updates

Wrap indexPathForNode: in a cache

Convert index paths in delegate methods

Go back on table view

Put collection view back

Switch up the API

Move most ASCollectionView API to ASCollectionNode

Move most table logic over to ASTableNode

Do the things

More conversion work

Keep on keepin' on

Get table view delegate API done

More porting

Simplify

Clear the delegate

More cleanup

Move more stuff around

Remove pointless file

Re-add some API

Put back more API

Use the right flag

* Some cleanup

* Remove incorrect comment

* Tweak the API

* Put back a couple methods

* update example projects (note: ASCollectionView deprecation warnings expected)

* change reloadDataWithCompletion:nil --> reloadData

* Clean up rebase

* Make deprecated numberOfItemsInSection methods optional

* Use the right flag

* Address nits

* update ASDKTube, ASDKgram & ASViewController examples

AsyncDisplayKit/Details/ASCollectionDataController.mm

@@ -53,6 +53,7 @@
 
 - (void)prepareForReloadDataWithSectionCount:(NSInteger)newSectionCount
 {
+  ASDisplayNodeAssertMainThread();
   NSIndexSet *sections = [NSIndexSet indexSetWithIndexesInRange:NSMakeRange(0, newSectionCount)];
   
   [_sections removeAllObjects];
@@ -97,6 +98,7 @@
 
 - (void)prepareForInsertSections:(NSIndexSet *)sections
 {
+  ASDisplayNodeAssertMainThread();
   [self _populatePendingSectionsFromDataSource:sections];
   
   for (NSString *kind in [self supplementaryKinds]) {
@@ -163,6 +165,7 @@
 
 - (void)prepareForInsertRowsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths
 {
+  ASDisplayNodeAssertMainThread();
   for (NSString *kind in [self supplementaryKinds]) {
     LOG(@"Populating elements of kind: %@, for index paths: %@", kind, indexPaths);
     NSMutableArray<ASIndexedNodeContext *> *contexts = [NSMutableArray array];
@@ -184,6 +187,7 @@
 
 - (void)prepareForDeleteRowsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths
 {
+  ASDisplayNodeAssertMainThread();
   for (NSString *kind in [self supplementaryKinds]) {
     NSMutableArray<ASIndexedNodeContext *> *contexts = [NSMutableArray array];
     [self _populateSupplementaryNodesOfKind:kind atIndexPaths:indexPaths mutableContexts:contexts];
@@ -277,7 +281,8 @@
   ASSizeRange constrainedSize = [self constrainedSizeForNodeOfKind:kind atIndexPath:indexPath];
   ASIndexedNodeContext *context = [[ASIndexedNodeContext alloc] initWithNodeBlock:supplementaryCellBlock
                                                                         indexPath:indexPath
-                                                                    constrainedSize:constrainedSize
+                                                         supplementaryElementKind:kind
+                                                                  constrainedSize:constrainedSize
                                                        environmentTraitCollection:environmentTraitCollection];
   [contexts addObject:context];
 }
@@ -289,6 +294,7 @@
   if ([kind isEqualToString:ASDataControllerRowNodeKind]) {
     return [super constrainedSizeForNodeOfKind:kind atIndexPath:indexPath];
   } else {
+    ASDisplayNodeAssertMainThread();
     return [self.collectionDataSource dataController:self constrainedSizeForSupplementaryNodeOfKind:kind atIndexPath:indexPath];
   }
 }