PR #1000 on GitHub! Provide a Beta API to enable the new, high efficiency render-ahead mechanism.

AsyncDisplayKit/ASCollectionView.mm

@@ -527,7 +527,7 @@ - (void)collectionView:(UICollectionView *)collectionView willDisplayCell:(UICol
 
   ASCellNode *cellNode = [self nodeForItemAtIndexPath:indexPath];
   if (cellNode.neverShowPlaceholders) {
-    [cellNode recursivelyEnsureDisplay];
+    [cellNode recursivelyEnsureDisplaySynchronously:YES];
   }
 }
 

AsyncDisplayKit/ASDisplayNode+Beta.h

@@ -16,7 +16,8 @@
 
 /**
  * @abstract Recursively ensures node and all subnodes are displayed.
+ * @see Full documentation in ASDisplayNode+FrameworkPrivate.h
  */
-- (void)recursivelyEnsureDisplay;
+- (void)recursivelyEnsureDisplaySynchronously:(BOOL)synchronously;
 
 @end

AsyncDisplayKit/ASDisplayNode.mm

@@ -1543,9 +1543,9 @@ - (void)__recursivelyTriggerDisplayAndBlock:(BOOL)shouldBlock
   recursivelyTriggerDisplayForLayer(layer, shouldBlock);
 }
 
-- (void)recursivelyEnsureDisplay
+- (void)recursivelyEnsureDisplaySynchronously:(BOOL)synchronously
 {
-  [self __recursivelyTriggerDisplayAndBlock:YES];
+  [self __recursivelyTriggerDisplayAndBlock:synchronously];
 }
 
 - (void)setShouldBypassEnsureDisplay:(BOOL)shouldBypassEnsureDisplay

AsyncDisplayKit/ASTableView.mm

@@ -558,7 +558,7 @@ - (void)tableView:(UITableView *)tableView willDisplayCell:(UITableViewCell *)ce
 
   ASCellNode *cellNode = [self nodeForRowAtIndexPath:indexPath];
   if (cellNode.neverShowPlaceholders) {
-    [cellNode recursivelyEnsureDisplay];
+    [cellNode recursivelyEnsureDisplaySynchronously:YES];
   }
 }
 

AsyncDisplayKit/ASViewController.m

@@ -57,7 +57,7 @@ - (void)viewDidLayoutSubviews
 {
   if (_ensureDisplayed && self.neverShowPlaceholders) {
     _ensureDisplayed = NO;
-    [self.node recursivelyEnsureDisplay];
+    [self.node recursivelyEnsureDisplaySynchronously:YES];
   }
   [super viewDidLayoutSubviews];
 }

AsyncDisplayKit/Details/ASRangeHandlerRender.mm

@@ -65,7 +65,7 @@ - (void)node:(ASDisplayNode *)node enteredRangeOfType:(ASLayoutRangeType)rangeTy
 
 
   if (![ASDisplayNode shouldUseNewRenderingRange]) {
-    [node recursivelyEnsureDisplay];  // Need to do this without waiting
+    [node recursivelyEnsureDisplaySynchronously:NO];
   } else {
     // Add the node's layer to an off-screen window to trigger display and mark its contents as non-volatile.
     // Use the layer directly to avoid the substantial overhead of UIView heirarchy manipulations.

AsyncDisplayKit/Private/ASDisplayNode+FrameworkPrivate.h

@@ -90,7 +90,7 @@ typedef NS_OPTIONS(NSUInteger, ASHierarchyState)
  * In order to guarantee against deadlocks, this method should only be called on the main thread.
  * It may block on the private queue, [_ASDisplayLayer displayQueue]
  */
-- (void)recursivelyEnsureDisplay;
+- (void)recursivelyEnsureDisplaySynchronously:(BOOL)synchronously;
 
 /**
  * @abstract Allows a node to bypass all ensureDisplay passes.  Defaults to NO.