motion-yapper 0.0.3 → 0.1.0

data/vendor/Pods/YapDatabase/YapDatabase/Extensions/Views/Utilities/YapDatabaseViewChange.m

@@ -1,2500 +0,0 @@
-#import "YapDatabaseViewChange.h"
-#import "YapDatabaseViewChangePrivate.h"
-#import "YapDatabaseViewMappingsPrivate.h"
-
-
-@implementation YapDatabaseViewSectionChange {
-
-/* From YapDatabaseViewChangePrivate.h :
-
-@public
-	
-	NSString *group; // immutable
-	BOOL isReset;    // immutable
-	
-	YapDatabaseViewChangeType type; // mutable during consolidation
-	
-	NSUInteger originalSection; // mutable during pre-processing
-	NSUInteger finalSection;    // mutable during pre-processing
-*/
-}
-
-@synthesize type = type;
-@synthesize group = group;
-
-+ (YapDatabaseViewSectionChange *)insertGroup:(NSString *)group
-{
-	YapDatabaseViewSectionChange *op = [[YapDatabaseViewSectionChange alloc] init];
-	op->type = YapDatabaseViewChangeInsert;
-	op->group = group;
-	op->isReset = NO;
-	op->originalSection = op->finalSection = NSNotFound;
-	
-	return op;
-}
-
-+ (YapDatabaseViewSectionChange *)deleteGroup:(NSString *)group
-{
-	YapDatabaseViewSectionChange *op = [[YapDatabaseViewSectionChange alloc] init];
-	op->type = YapDatabaseViewChangeDelete;
-	op->group = group;
-	op->isReset = NO;
-	op->originalSection = op->finalSection = NSNotFound;
-	
-	return op;
-}
-
-+ (YapDatabaseViewSectionChange *)resetGroup:(NSString *)group
-{
-	YapDatabaseViewSectionChange *op = [[YapDatabaseViewSectionChange alloc] init];
-	op->type = YapDatabaseViewChangeDelete;
-	op->group = group;
-	op->isReset = YES;
-	op->originalSection = op->finalSection = NSNotFound;
-	
-	return op;
-}
-
-- (id)copyWithZone:(NSZone *)zone
-{
-	YapDatabaseViewSectionChange *op = [[YapDatabaseViewSectionChange alloc] init];
-	op->type = type;
-	op->group = group;
-	op->isReset = isReset;
-	op->originalSection = originalSection;
-	op->finalSection = finalSection;
-	
-	return op;
-}
-
-- (NSUInteger)index
-{
-	if (type == YapDatabaseViewChangeInsert)
-		return finalSection;
-	else
-		return originalSection;
-}
-
-- (NSString *)description
-{
-	if (type == YapDatabaseViewChangeInsert)
-	{
-		if (finalSection == NSNotFound)
-		{
-			// Internal style (for debugging the processAndConsolidateOperations method)
-			return [NSString stringWithFormat:
-			    @"<YapDatabaseViewSectionChange: Insert group(%@)", group];
-		}
-		else
-		{
-			// External style (for debugging UITableView & UICollectionView updates)
-			return [NSString stringWithFormat:
-			    @"<YapDatabaseViewSectionChange: Insert section(%lu) group(%@)>",
-			        (unsigned long)finalSection, group];
-		}
-	}
-	else // if (type == YapDatabaseViewChangeDelete)
-	{
-		if (originalSection == NSNotFound)
-		{
-			// Internal style (for debugging the processAndConsolidateOperations method)
-			return [NSString stringWithFormat:
-			    @"<YapDatabaseViewSectionChange: Delete group(%@)", group];
-		}
-		else
-		{
-			// External style (for debugging UITableView & UICollectionView updates)
-			return [NSString stringWithFormat:
-			    @"<YapDatabaseViewSectionChange: Delete section(%lu) group(%@)>",
-			        (unsigned long)originalSection, group];
-		}
-	}
-}
-
-@end
-
-////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-#pragma mark -
-////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-
-@implementation YapDatabaseViewRowChange {
-
-/* From YapDatabaseViewChangePrivate.h :
-
-@public
-	
-	id key; // immutable
-	
-	NSString *originalGroup; // immutable
-	NSString *finalGroup;    // mutable during consolidation
-	
-	YapDatabaseViewChangeType type; // mutable during consolidation
-	int columns;                    // mutable during consolidation
-	
-	NSUInteger opOriginalIndex;  // immutable
-	NSUInteger opFinalIndex;     // immutable
-	
-	NSUInteger originalIndex; // mutable during processing
-	NSUInteger finalIndex;    // mutable during processing
-	
-	NSUInteger originalSection; // mutable during pre-processing
-	NSUInteger finalSection;    // mutable during pre-processing
-*/
-}
-
-@synthesize type = type;
-@synthesize changes = changes;
-@synthesize originalGroup = originalGroup;
-@synthesize finalGroup = finalGroup;
-@synthesize originalIndex = originalIndex;
-@synthesize finalIndex = finalIndex;
-@synthesize originalSection = originalSection;
-@synthesize finalSection = finalSection;
-
-- (NSIndexPath *)indexPath
-{
-	if (type == YapDatabaseViewChangeInsert) {
-		return nil; // <-- You should be using newIndexPath
-	}
-	else
-	{
-	  #if TARGET_OS_IPHONE
-		return [NSIndexPath indexPathForRow:originalIndex inSection:originalSection];
-	  #else
-		NSUInteger indexes[] = {originalSection, originalIndex};
-		return [NSIndexPath indexPathWithIndexes:indexes length:2];
-	  #endif
-	}
-}
-
-- (NSIndexPath *)newIndexPath
-{
-	if (type == YapDatabaseViewChangeDelete || type == YapDatabaseViewChangeUpdate) {
-		return nil; // <-- You should be using indexPath
-	}
-	else {
-	#if TARGET_OS_IPHONE
-		return [NSIndexPath indexPathForRow:finalIndex inSection:finalSection];
-	#else
-		NSUInteger indexes[] = {finalSection, finalIndex};
-		return [NSIndexPath indexPathWithIndexes:indexes length:2];
-	#endif
-	}
-}
-
-- (id)copyWithZone:(NSZone *)zone
-{
-	YapDatabaseViewRowChange *op = [[YapDatabaseViewRowChange alloc] init];
-	op->key = key;
-	op->originalGroup = originalGroup;
-	op->finalGroup = finalGroup;
-	op->type = type;
-	op->changes = changes;
-	op->opOriginalIndex = opOriginalIndex;
-	op->opFinalIndex = opFinalIndex;
-	op->originalIndex = originalIndex;
-	op->finalIndex = finalIndex;
-	op->originalSection = originalSection;
-	op->finalSection = finalSection;
-	
-	return op;
-}
-
-+ (YapDatabaseViewRowChange *)insertKey:(id)key inGroup:(NSString *)group atIndex:(NSUInteger)index
-{
-	YapDatabaseViewRowChange *op = [[YapDatabaseViewRowChange alloc] init];
-	op->type = YapDatabaseViewChangeInsert;
-	op->key = key;
-	op->changes = YapDatabaseViewChangedObject | YapDatabaseViewChangedMetadata;
-	
-	op->originalGroup = nil;                              // invalid in insert type
-	op->originalIndex = op->opOriginalIndex = NSNotFound; // invalid in insert type
-	
-	op->finalGroup = group;
-	op->finalIndex = op->opFinalIndex = index;
-	
-	op->originalSection = op->finalSection = NSNotFound;
-	
-	return op;
-}
-
-+ (YapDatabaseViewRowChange *)deleteKey:(id)key inGroup:(NSString *)group atIndex:(NSUInteger)index
-{
-	YapDatabaseViewRowChange *op = [[YapDatabaseViewRowChange alloc] init];
-	op->type = YapDatabaseViewChangeDelete;
-	op->key = key;
-	op->changes = YapDatabaseViewChangedObject | YapDatabaseViewChangedMetadata;
-	
-	op->originalGroup = group;
-	op->originalIndex = op->opOriginalIndex = index;
-	
-	op->finalGroup = nil;                           // invalid in delete type
-	op->finalIndex = op->opFinalIndex = NSNotFound; // invalid in delete type
-	
-	op->originalSection = op->finalSection = NSNotFound;
-	
-	return op;
-}
-
-+ (YapDatabaseViewRowChange *)updateKey:(id)key changes:(int)flags inGroup:(NSString *)group atIndex:(NSUInteger)index
-{
-	YapDatabaseViewRowChange *op = [[YapDatabaseViewRowChange alloc] init];
-	op->type = YapDatabaseViewChangeUpdate;
-	op->key = key;
-	op->changes = flags;
-	
-	op->originalGroup = group;
-	op->originalIndex = op->opOriginalIndex = index;
-	
-	op->finalGroup = group;
-	op->finalIndex = op->opFinalIndex = index;
-	
-	op->originalSection = op->finalSection = NSNotFound;
-	
-	return op;
-}
-
-- (NSString *)description
-{
-	if (type == YapDatabaseViewChangeInsert)
-	{
-		if (finalSection == NSNotFound)
-		{
-			// Internal style (for debugging the processAndConsolidateOperations method)
-			return [NSString stringWithFormat:
-			    @"<YapDatabaseViewRowChange: Insert pre(~ -> %lu) post(~ -> %lu) group(%@) key(%@)",
-			        (unsigned long)opFinalIndex, (unsigned long)finalIndex, finalGroup, key];
-		}
-		else
-		{
-			// External style (for debugging UITableView & UICollectionView updates)
-			return [NSString stringWithFormat:
-			    @"<YapDatabaseViewRowChange: Insert indexPath(nil) newIndexPath(%lu, %lu) group(%@) key(%@)>",
-			        (unsigned long)finalSection, (unsigned long)finalIndex, finalGroup, key];
-		}
-	}
-	else if (type == YapDatabaseViewChangeDelete)
-	{
-		if (originalSection == NSNotFound)
-		{
-			// Internal style (for debugging the processAndConsolidateOperations method)
-			return [NSString stringWithFormat:
-			    @"<YapDatabaseViewRowChange: Delete pre(%lu -> ~) post(%lu -> ~) group(%@) key(%@)",
-			        (unsigned long)opOriginalIndex, (unsigned long)originalIndex, originalGroup, key];
-		}
-		else
-		{
-			// External style (for debugging UITableView & UICollectionView updates)
-			return [NSString stringWithFormat:
-			    @"<YapDatabaseViewRowChange: Delete indexPath(%lu, %lu) newIndexPath(nil) group(%@) key(%@)>",
-			        (unsigned long)originalSection, (unsigned long)originalIndex, originalGroup, key];
-		}
-	}
-	else if (type == YapDatabaseViewChangeMove)
-	{
-		if (originalSection == NSNotFound && finalSection == NSNotFound)
-		{
-			// Internal style (for debugging the processAndConsolidateOperations method)
-			return [NSString stringWithFormat:
-				@"<YapDatabaseViewRowChange: Move pre(%lu -> %lu) post(%lu -> %lu) group(%@ -> %@) key(%@)",
-					(unsigned long)opOriginalIndex, (unsigned long)opFinalIndex,
-					(unsigned long)originalIndex,   (unsigned long)finalIndex,
-					originalGroup, finalGroup, key];
-		}
-		else
-		{
-			// External style (for debugging UITableView & UICollectionView updates)
-			return [NSString stringWithFormat:
-				@"<YapDatabaseViewRowChange: Move indexPath(%lu, %lu) newIndexPath(%lu, %lu) group(%@ -> %@) key(%@)",
-					(unsigned long)originalSection, (unsigned long)originalIndex,
-					(unsigned long)finalSection,    (unsigned long)finalIndex,
-					originalGroup, finalGroup, key];
-		}
-	}
-	else // if (type == YapDatabaseViewChangeUpdate)
-	{
-		if (originalSection == NSNotFound && finalSection == NSNotFound)
-		{
-			// Internal style (for debugging the processAndConsolidateOperations method)
-			return [NSString stringWithFormat:
-				@"<YapDatabaseViewRowChange: Update pre(%lu) post(%lu -> %lu) group(%@) key(%@)",
-					(unsigned long)opOriginalIndex,
-					(unsigned long)originalIndex,   (unsigned long)finalIndex, originalGroup, key];
-		}
-		else
-		{
-			// External style (for debugging UITableView & UICollectionView updates)
-			return [NSString stringWithFormat:
-				@"<YapDatabaseViewRowChange: Update indexPath(%lu, %lu) group(%@) key(%@)",
-					(unsigned long)originalSection, (unsigned long)originalIndex, originalGroup, key];
-		}
-	}
-}
-
-@end
-
-////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-#pragma mark -
-////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
-
-@implementation YapDatabaseViewChange
-
-/**
- * During a read-write transaction, every modification to the view results in one or more
- * YapDatabaseViewSectionChange or YapDatabaseViewRowChange objects being appended to an internal array.
- *
- * At the end of the read-write transaction we have a big list of changes that have occurred.
- *
- * This method takes the original list and pre-processes it:
- *
- * - splits the array in sectionChanges and rowChanges
- * - removes any items from the changes array that don't concern us (group not in mappings)
- * - injects extra changes if there are cell dependencies configured in the mappings
-**/
-+ (void)preProcessChanges:(NSArray *)changes
-     withOriginalMappings:(YapDatabaseViewMappings *)originalMappings
-            finalMappings:(YapDatabaseViewMappings *)finalMappings
-     andGetSectionChanges:(NSMutableArray **)sectionChangesPtr
-               rowChanges:(NSMutableArray **)rowChangesPtr
-{
-	
-	// We remove any items from the changes array that don't concern us.
-	// For example, if mappings only contain groupA & groupB,
-	// then we can ignore changes in groupC.
-	//
-	// We also may need to inject extra changes.
-	// The user may specify, as a configuration option within mappings,
-	// the the drawing of cells has an dependency upon neighboring cells.
-	
-	NSMutableArray *sectionChanges = [NSMutableArray arrayWithCapacity:1];
-	NSMutableArray *rowChanges = [NSMutableArray arrayWithCapacity:[changes count]];
-	
-	NSSet *originalGroups = [NSSet setWithArray:[originalMappings allGroups]];
-	NSSet *finalGroups = [NSSet setWithArray:[finalMappings allGroups]];
-    
-	NSMutableDictionary *counts = [originalMappings counts];
-	NSDictionary *dependencies = [originalMappings dependencies];
-	
-	for (id change in changes)
-	{
-		if ([change isKindOfClass:[YapDatabaseViewSectionChange class]])
-		{
-			__unsafe_unretained YapDatabaseViewSectionChange *immutableSectionChange =
-			    (YapDatabaseViewSectionChange *)change;
-			
-			if (immutableSectionChange->type == YapDatabaseViewChangeDelete)
-			{
-				if ([originalGroups containsObject:immutableSectionChange->group])
-				{
-					YapDatabaseViewSectionChange *sectionChange = [immutableSectionChange copy];
-					[sectionChanges addObject:sectionChange];
-					
-					if (sectionChange->isReset)
-					{
-						// Special case processing.
-						//
-						// Most of the time, groups are deleted because the last key within the group was removed.
-						// Thus a regular section delete is accompanied by all the corresponding row deletes.
-						// But if the user invokes:
-						// - removeAllObjectsInAllCollections
-						//
-						// then we get a section delete that isn't accompanied by the corresponding row deletes.
-						// This operation is flagged via isReset.
-						//
-						// So here's what we do in this situation:
-						// - remove any previous row changes within the group
-						// - manually inject all the proper row deletes
-						
-						__unsafe_unretained YapDatabaseViewRowChange *rowChange;
-						
-						for (NSUInteger i = [rowChanges count]; i > 0; i--)
-						{
-							rowChange = [rowChanges objectAtIndex:(i-1)];
-							
-							if (rowChange->type == YapDatabaseViewChangeDelete)
-							{
-								if ([rowChange->originalGroup isEqualToString:sectionChange->group])
-								{
-									[rowChanges removeObjectAtIndex:(i-1)];
-								}
-							}
-							else // YapDatabaseViewChangeInsert || YapDatabaseViewChangeUpdate
-							{
-								if ([rowChange->finalGroup isEqualToString:sectionChange->group])
-								{
-									[rowChanges removeObjectAtIndex:(i-1)];
-								}
-							}
-						}
-						
-						YapDatabaseViewRangePosition rangePosition =
-						  [originalMappings rangePositionForGroup:sectionChange->group];
-						
-						NSUInteger prevRowOffset = rangePosition.offsetFromBeginning;
-						NSUInteger prevRowCount = rangePosition.length;
-						
-						while (prevRowCount > 0)
-						{
-							YapDatabaseViewRowChange *rowChange =
-							    [YapDatabaseViewRowChange deleteKey:nil
-							                                inGroup:sectionChange->group
-							                                atIndex:(prevRowOffset+prevRowCount-1)];
-							
-							[rowChanges addObject:rowChange];
-							prevRowCount--;
-						}
-						
-						[counts setObject:@(0) forKey:sectionChange->group];
-					}
-				}
-			}
-			else if (immutableSectionChange->type == YapDatabaseViewChangeInsert)
-			{
-				if ([finalGroups containsObject:immutableSectionChange->group])
-				{
-					YapDatabaseViewSectionChange *sectionChange = [immutableSectionChange copy];
-					[sectionChanges addObject:sectionChange];
-				}
-			}
-		}
-		else
-		{
-			__unsafe_unretained YapDatabaseViewRowChange *immutableRowChange = (YapDatabaseViewRowChange *)change;
-			
-			__unsafe_unretained NSString *group = nil;
-			NSUInteger groupCount = 0;
-			NSUInteger groupIndex = 0;
-			BOOL wasDelete = 0;
-
-			if (immutableRowChange->type == YapDatabaseViewChangeDelete)
-			{
-				if ([originalGroups containsObject:immutableRowChange->originalGroup])
-				{
-					YapDatabaseViewRowChange *rowChange = [immutableRowChange copy];
-					[rowChanges addObject:rowChange];
-					
-					group = rowChange->originalGroup;
-					groupIndex = rowChange->originalIndex;
-					
-					groupCount = [[counts objectForKey:group] unsignedIntegerValue];
-					groupCount--;
-					[counts setObject:@(groupCount) forKey:group];
-					
-					wasDelete = YES;
-				}
-			}
-			else if (immutableRowChange->type == YapDatabaseViewChangeInsert)
-			{
-				if ([finalGroups containsObject:immutableRowChange->finalGroup])
-				{
-					YapDatabaseViewRowChange *rowChange = [immutableRowChange copy];
-					[rowChanges addObject:rowChange];
-					
-					group = rowChange->finalGroup;
-					groupIndex = rowChange->finalIndex;
-					
-					groupCount = [[counts objectForKey:group] unsignedIntegerValue];
-					groupCount++;
-					[counts setObject:@(groupCount) forKey:group];
-				}
-			}
-			else if (immutableRowChange->type == YapDatabaseViewChangeUpdate)
-			{
-				if ([finalGroups containsObject:immutableRowChange->originalGroup])
-				{
-					YapDatabaseViewRowChange *rowChange = [immutableRowChange copy];
-					[rowChanges addObject:rowChange];
-					
-					group = rowChange->originalGroup;
-					groupIndex = rowChange->originalIndex;
-					
-					groupCount = [[counts objectForKey:group] unsignedIntegerValue];
-				}
-			}
-			
-			// Handle cell drawing dependencies.
-			
-			NSSet *dependenciesForGroup = [dependencies objectForKey:group];
-			for (NSNumber *offsetNum in dependenciesForGroup)
-			{
-				NSInteger offset = [offsetNum integerValue] * -1;
-				NSUInteger dependencyIndex = groupCount;
-				
-				if (offset > 0)
-				{
-					dependencyIndex = groupIndex + offset;
-					if (wasDelete)
-						dependencyIndex--;
-				}
-				else if ((offset < 0) && (-1*offset <= groupIndex))
-				{
-					dependencyIndex = groupIndex + offset;
-				}
-				
-				if (dependencyIndex < groupCount)
-				{
-					int changes = YapDatabaseViewChangedDependency;
-					
-					YapDatabaseViewRowChange *rowChange =
-					    [YapDatabaseViewRowChange updateKey:nil changes:changes inGroup:group atIndex:dependencyIndex];
-					
-					[rowChanges addObject:rowChange];
-				}
-			}
-			
-		}
-	}
-	
-	if (sectionChangesPtr) *sectionChangesPtr = sectionChanges;
-	if (rowChangesPtr) *rowChangesPtr = rowChanges;
-}
-
-
-/**
- * During a read-write transaction, every modification to the view results in one or more
- * YapDatabaseViewSectionChange or YapDatabaseViewRowChange objects being appended to an internal array.
- *
- * At the end of the read-write transaction we have a big list of changes that have occurred.
- * But each change represents the change state at the moment the change took place.
- * And we ultimately need to get the change state to reflect the original and/or final position of the change.
- *
- * This method takes a list of YapDatabaseViewRowChange objects and processes them to
- * properly calculate and set the original and/or final index of each row change.
-**/
-+ (void)processRowChanges:(NSMutableArray *)changes
-{
-	// Each YapDatabaseViewRowChange object is one of:
-	// 
-	// - Row insert
-	// - Row delete
-	// - Row update
-	//
-	// If a row is moved, then it is represented in the given array as a delete followed by an insert.
-	//
-	// Each YapDatabaseViewRowChange represents the change state AT THE MOMENT THE CHANGE TOOK PLACE.
-	// This is critically important to understand.
-	//
-	// For example, imagine the following array:
-	// @[
-	//   <RowInsert group=fruit index=0 key=apple>
-	//   <RowDelete group=fruit index=7 key=carrot>
-	//   <RowInsert group=fruit index=2 key=blueberry>
-	//   <RowInsert group=fruit index=2 key=banana>
-	// ]
-	//
-	// What was the original index of 'carrot'?
-	// What is the final index of 'blueberry'?
-	//
-	// The original index of 'carrot' was 6, because the earlier insert of 'apple' pushed its index upward.
-	// The final index of 'blueberry' is 3, because a later insert of 'banana' pushed its index upward.
-	//
-	// As you might guess, there are a number of edge cases to watch out for.
-	// Ultimately, the algorithm is fairly straight-forward, but the code gets a little verbose.
-	//
-	// There are are crap ton of unit tests for this code...
-	// 
-	// Please see the UNIT TESTS for a bunch of examples that may shed additional light on the algorithm:
-	// TestViewChangeLogic.m
-	
-	NSUInteger i;
-	NSUInteger j;
-	
-	// First we enumerate the items BACKWARDS,
-	// and update the ORIGINAL values.
-	
-	NSUInteger count = [changes count];
-	
-	for (i = count; i > 0; i--)
-	{
-		YapDatabaseViewRowChange *change = [changes objectAtIndex:(i-1)];
-		
-		if (change->type == YapDatabaseViewChangeDelete)
-		{
-			// A DELETE operation may affect the ORIGINAL index value of operations that occurred AFTER it,
-			//  IF the later operation occurs at a greater or equal index value.  ( +1 )
-			
-			for (j = i; j < count; j++)
-			{
-				YapDatabaseViewRowChange *laterChange = [changes objectAtIndex:j];
-				
-				if (laterChange->type == YapDatabaseViewChangeDelete ||
-					laterChange->type == YapDatabaseViewChangeUpdate)
-				{
-					if (laterChange->originalIndex >= change->opOriginalIndex &&
-					   [laterChange->originalGroup isEqualToString:change->originalGroup])
-					{
-						laterChange->originalIndex += 1;
-					}
-				}
-			}
-		}
-		else if (change->type == YapDatabaseViewChangeInsert)
-		{
-			// An INSERT operation may affect the ORIGINAL index value of operations that occurred AFTER it,
-			//   IF the later operation occurs at a greater or equal index value. ( -1 )
-			
-			for (j = i; j < count; j++)
-			{
-				YapDatabaseViewRowChange *laterChange = [changes objectAtIndex:j];
-				
-				if (laterChange->type == YapDatabaseViewChangeDelete ||
-				    laterChange->type == YapDatabaseViewChangeUpdate)
-				{
-					if (laterChange->originalIndex >= change->opFinalIndex &&
-					   [laterChange->originalGroup isEqualToString:change->finalGroup])
-					{
-						laterChange->originalIndex -= 1;
-					}
-				}
-			}
-		}
-	}
-	
-	// Next we enumerate the items FORWARDS,
-	// and update the FINAL values.
-	
-	for (i = 1; i < count; i++)
-	{
-		YapDatabaseViewRowChange *change = [changes objectAtIndex:i];
-		
-		if (change->type == YapDatabaseViewChangeDelete)
-		{
-			// A DELETE operation may affect the FINAL index value of operations that occurred BEFORE it,
-			//  IF the earlier operation occurs at a greater (but not equal) index value. ( -1 )
-			
-			for (j = i; j > 0; j--)
-			{
-				YapDatabaseViewRowChange *earlierChange = [changes objectAtIndex:(j-1)];
-				
-				if (earlierChange->type == YapDatabaseViewChangeInsert ||
-				    earlierChange->type == YapDatabaseViewChangeUpdate  )
-				{
-					if (earlierChange->finalIndex > change->opOriginalIndex &&
-					   [earlierChange->finalGroup isEqualToString:change->originalGroup])
-					{
-						earlierChange->finalIndex -= 1;
-					}
-				}
-			}
-		}
-		else if (change->type == YapDatabaseViewChangeInsert)
-		{
-			// An INSERT operation may affect the FINAL index value of operations that occurred BEFORE it,
-			//   IF the earlier operation occurs at a greater index value ( +1 )
-			
-			for (j = i; j > 0; j--)
-			{
-				YapDatabaseViewRowChange *earlierChange = [changes objectAtIndex:(j-1)];
-				
-				if (earlierChange->type == YapDatabaseViewChangeInsert ||
-				    earlierChange->type == YapDatabaseViewChangeUpdate)
-				{
-					if (earlierChange->finalIndex >= change->opFinalIndex &&
-					   [earlierChange->finalGroup isEqualToString:change->finalGroup])
-					{
-						earlierChange->finalIndex += 1;
-					}
-				}
-			}
-		}
-	}
-}
-
-/**
- * This method consolidates multiple changes to the same row into a single change that reflects
- * the original and final position of each changed row.
-**/
-+ (void)consolidateRowChanges:(NSMutableArray *)changes
-{
-	NSUInteger i;
-	NSUInteger j;
-	
-	NSMutableIndexSet *indexSet = [NSMutableIndexSet indexSet];
-	
-	i = 0;
-	while (i < [changes count])
-	{
-		YapDatabaseViewRowChange *firstChangeForKey = [changes objectAtIndex:i];
-		YapDatabaseViewRowChange *mostRecentChangeForKey = firstChangeForKey;
-		
-		// Find later operations with the same key
-		
-		for (j = i+1; j < [changes count]; j++)
-		{
-			YapDatabaseViewRowChange *laterChange = [changes objectAtIndex:j];
-			BOOL changesAreForSameKey = NO;
-			
-			if (firstChangeForKey->key && laterChange->key)
-			{
-				// Compare keys
-				
-				if ([laterChange->key isEqual:firstChangeForKey->key])
-					changesAreForSameKey = YES;
-			}
-			else
-			{
-				// Compare indexes & groups
-				//
-				// This technique is used if one of the keys is nil,
-				// and applies to situations where one of the changes is an Update with a nil key,
-				// which was injected during pre-processing due to cell drawing dependencies.
-				
-				if (mostRecentChangeForKey->type == YapDatabaseViewChangeUpdate)
-				{
-					if (laterChange->type == YapDatabaseViewChangeUpdate ||
-					    laterChange->type == YapDatabaseViewChangeDelete)
-					{
-						if (mostRecentChangeForKey->originalIndex == laterChange->originalIndex &&
-						   [mostRecentChangeForKey->originalGroup isEqualToString:laterChange->originalGroup]) {
-							changesAreForSameKey = YES;
-						}
-					}
-				}
-				else if (mostRecentChangeForKey->type == YapDatabaseViewChangeInsert)
-				{
-					if (laterChange->type == YapDatabaseViewChangeUpdate)
-					{
-						if (mostRecentChangeForKey->originalIndex == laterChange->originalIndex &&
-						   [mostRecentChangeForKey->originalGroup isEqualToString:laterChange->originalGroup]) {
-							changesAreForSameKey = YES;
-						}
-					}
-				}
-				
-				if (changesAreForSameKey)
-				{
-					if (mostRecentChangeForKey->key == nil)
-						mostRecentChangeForKey->key = laterChange->key;
-					else
-						laterChange->key = mostRecentChangeForKey->key;
-				}
-			}
-			
-			if (changesAreForSameKey)
-			{
-				firstChangeForKey->changes |= laterChange->changes;
-				[indexSet addIndex:j];
-				
-				mostRecentChangeForKey = laterChange;
-			}
-		}
-		
-		if ([indexSet count] == 0)
-		{
-			i++; // continue;
-		}
-		else
-		{
-			YapDatabaseViewRowChange *lastChangeForKey = [changes objectAtIndex:[indexSet lastIndex]];
-			
-			if (firstChangeForKey->type == YapDatabaseViewChangeDelete)
-			{
-				if (lastChangeForKey->type == YapDatabaseViewChangeDelete)
-				{
-					// Delete + Insert + ... + Delete
-					//
-					// All operations except the first are no-ops
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					i++;
-				}
-				else if (lastChangeForKey->type == YapDatabaseViewChangeInsert)
-				{
-					// Delete + Insert = Move
-					//
-					// This is always a move operation.
-					// Even if the final location hasn't ultimately changed, we still want to treat it as a move.
-					// Only a true update, where the index never budged, can be emitted as an update.
-					//
-					// If we attempt to consolidate this into an update,
-					// then the tableView/collectionView will offset the update's index
-					// based on insertions & deletions at smaller indexes,
-					// and may ultimately update the wrong cell.
-					
-					firstChangeForKey->type = YapDatabaseViewChangeMove;
-					firstChangeForKey->finalIndex = lastChangeForKey->finalIndex;
-					firstChangeForKey->finalGroup = lastChangeForKey->finalGroup;
-					firstChangeForKey->opFinalIndex = lastChangeForKey->opFinalIndex; // for postProcessing
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					i++;
-				}
-				else if (lastChangeForKey->type == YapDatabaseViewChangeUpdate)
-				{
-					// Delete + Insert + ... + Update = Move
-					//
-					// This is always a move operation.
-					// Even if the final location hasn't ultimately changed, we still want to treat it as a move.
-					// Only a true update, where the index never budged, can be emitted as an update.
-					//
-					// If we attempt to consolidate this into an update,
-					// then the tableView/collectionView will offset the update's index
-					// based on insertions & deletions at smaller indexes,
-					// and may ultimately update the wrong cell.
-					
-					firstChangeForKey->type = YapDatabaseViewChangeMove;
-					firstChangeForKey->finalIndex = lastChangeForKey->finalIndex;
-					firstChangeForKey->finalGroup = lastChangeForKey->finalGroup;
-					firstChangeForKey->opFinalIndex = lastChangeForKey->opFinalIndex; // for postProcessing
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					i++;
-				}
-			}
-			else if (firstChangeForKey->type == YapDatabaseViewChangeInsert)
-			{
-				if (lastChangeForKey->type == YapDatabaseViewChangeDelete)
-				{
-					// Insert + Delete
-					//
-					// All operations are no-ops (& i remains the same)
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					[changes removeObjectAtIndex:i];
-				}
-				else if (lastChangeForKey->type == YapDatabaseViewChangeInsert)
-				{
-					// Insert + Delete + ... + Insert
-					//
-					// All operations except the last are no-ops.
-					
-					firstChangeForKey->finalIndex = lastChangeForKey->finalIndex;
-					firstChangeForKey->finalGroup = lastChangeForKey->finalGroup;
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					i++;
-				}
-				else // if (lastChangeForKey->type == YapDatabaseViewChangeUpdate)
-				{
-					// Insert + Update
-					//
-					// This is still an insert, but the final location may have changed.
-					
-					firstChangeForKey->finalIndex = lastChangeForKey->finalIndex;
-					firstChangeForKey->finalGroup = lastChangeForKey->finalGroup;
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					i++;
-				}
-			}
-			else if (firstChangeForKey->type == YapDatabaseViewChangeUpdate)
-			{
-				if (lastChangeForKey->type == YapDatabaseViewChangeDelete)
-				{
-					// Update + Delete
-					//
-					// This is ultimately a Delete.
-					// We need to be sure to use the original original index.
-					
-					firstChangeForKey->type = YapDatabaseViewChangeDelete;
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					i++;
-				}
-				else if (lastChangeForKey->type == YapDatabaseViewChangeInsert)
-				{
-					// Update + Delete + ... + Insert = Move
-					//
-					// This is always a move operation.
-					// Even if the final location hasn't ultimately changed, we still want to treat it as a move.
-					// Only a true update, where the index never budged, can be emitted as an update.
-					//
-					// If we attempt to consolidate this into an update,
-					// then the tableView/collectionView will offset the update's index
-					// based on insertions & deletions at smaller indexes,
-					// and may ultimately update the wrong cell.
-					//
-					// The final location comes from the last update
-					
-					firstChangeForKey->type = YapDatabaseViewChangeMove;
-					firstChangeForKey->finalIndex = lastChangeForKey->finalIndex;
-					firstChangeForKey->finalGroup = lastChangeForKey->finalGroup;
-					firstChangeForKey->opFinalIndex = lastChangeForKey->opFinalIndex; // for postProcessing
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					i++;
-				}
-				else // if (lastChangeForKey->type == YapDatabaseViewChangeUpdate)
-				{
-					// Update + ... + Update
-					//
-					// This is either an Update or a Move.
-					// Only a true update, where the index never budged, can be emitted as an update.
-					//
-					// So we scan all the changes, and if every single one is an update, then we can emit an update.
-					
-					__block BOOL isTrueUpdate = YES;
-					
-					[indexSet enumerateIndexesUsingBlock:^(NSUInteger idx, BOOL *stop) {
-						
-						YapDatabaseViewRowChange *changeForKey = [changes objectAtIndex:idx];
-						
-						if (changeForKey->type != YapDatabaseViewChangeUpdate)
-						{
-							isTrueUpdate = NO;
-							*stop = YES;
-						}
-					}];
-					
-					if (isTrueUpdate)
-					{
-						// = Update
-						
-						[changes removeObjectsAtIndexes:indexSet];
-						i++;
-					}
-					else
-					{
-						// = Move
-						//
-						// The final location comes from the last update
-						
-						firstChangeForKey->type = YapDatabaseViewChangeMove;
-						firstChangeForKey->finalIndex = lastChangeForKey->finalIndex;
-						firstChangeForKey->finalGroup = lastChangeForKey->finalGroup;
-						firstChangeForKey->opFinalIndex = lastChangeForKey->opFinalIndex; // for postProcessing
-						
-						[changes removeObjectsAtIndexes:indexSet];
-						i++;
-					}
-				}
-			}
-			
-			[indexSet removeAllIndexes];
-			
-		} // ([indexSet count] > 0)
-		
-	} // while (i < [changes count])
-}
-
-/**
- * This method consolidates multiple changes to the same section into a single change.
-**/
-+ (void)consolidateSectionChanges:(NSMutableArray *)changes
-{
-	NSMutableIndexSet *indexSet = [NSMutableIndexSet indexSet];
-	
-	NSUInteger i = 0;
-	while (i < [changes count])
-	{
-		YapDatabaseViewSectionChange *firstSectionChangeForGroup = [changes objectAtIndex:i];
-		
-		// Find later operations with the same group
-		
-		for (NSUInteger j = i+1; j < [changes count]; j++)
-		{
-			YapDatabaseViewSectionChange *laterSectionChange = [changes objectAtIndex:j];
-			
-			if ([laterSectionChange->group isEqualToString:firstSectionChangeForGroup->group])
-			{
-				[indexSet addIndex:j];
-			}
-		}
-		
-		if ([indexSet count] == 0)
-		{
-			i++;
-		}
-		else
-		{
-			YapDatabaseViewSectionChange *lastSectionChangeForGroup = [changes objectAtIndex:[indexSet lastIndex]];
-			
-			if (firstSectionChangeForGroup->type == YapDatabaseViewChangeDelete)
-			{
-				if (lastSectionChangeForGroup->type == YapDatabaseViewChangeDelete)
-				{
-					// Delete + Insert + ... + Delete
-					//
-					// All operations except the first are no-ops
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					i++;
-				}
-				else // if (lastSectionChangeForGroup->type == YapDatabaseViewChangeInsert)
-				{
-					// Delete + Insert
-					//
-					// All operations are no-ops (& i remains the same)
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					[changes removeObjectAtIndex:i];
-				}
-			}
-			else if (firstSectionChangeForGroup->type == YapDatabaseViewChangeInsert)
-			{
-				if (lastSectionChangeForGroup->type == YapDatabaseViewChangeDelete)
-				{
-					// Insert + Delete
-					//
-					// All operations are no-ops (& i remains the same)
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					[changes removeObjectAtIndex:i];
-				}
-				else if (lastSectionChangeForGroup->type == YapDatabaseViewChangeInsert)
-				{
-					// Insert + Delete + ... + Insert
-					//
-					// All operations except the first are no-ops.
-					
-					[changes removeObjectsAtIndexes:indexSet];
-					i++;
-				}
-			}
-		}
-	}
-}
-
-/**
- * This method applies the given mappings to the processed list of row changes.
- * Based upon the configuration of the mappings, it will
- * 
- * - filter items that are excluded based on per-group range configurations
- * - alter indexes based on per-group range configurations
- * - reverse indexes based on per-group reversal settings
-**/
-+ (void)postProcessAndFilterRowChanges:(NSMutableArray *)rowChanges
-                  withOriginalMappings:(YapDatabaseViewMappings *)originalMappings
-                         finalMappings:(YapDatabaseViewMappings *)finalMappings
-{
-	
-	// The user may have various range options set for each section/group.
-	// For example:
-	//
-	// The user has a hard range on group "fiction" in the "bookSalesRank" view in order to display the top 20.
-	// So any items outside of that range must be filtered.
-	
-	NSDictionary *rangeOptions = [finalMappings rangeOptions];
-	BOOL rangeOptionsChanged = YES;
-	
-	// Note: The rangeOptions are the same between originalMappings & finalMappings.
-	
-	for (NSString *group in rangeOptions)
-	{
-		YapDatabaseViewRangeOptions *rangeOpts = [rangeOptions objectForKey:group];
-		
-		NSUInteger originalGroupCount = [originalMappings fullCountForGroup:group];
-		NSUInteger finalGroupCount    = [finalMappings fullCountForGroup:group];
-		
-		YapDatabaseViewPin pin = rangeOpts.pin;
-		
-		//
-		// STEP 1 : Calculate the originalRange & finalRange
-		//
-		
-		NSUInteger originalRangeLength = rangeOpts.length;
-		NSUInteger originalRangeOffset = rangeOpts.offset;
-		
-		NSUInteger originalRangeMin;
-		NSUInteger originalRangeMax;
-		
-		if (pin == YapDatabaseViewBeginning)
-		{
-			originalRangeMin = originalRangeOffset;
-			originalRangeMax = originalRangeOffset + originalRangeLength;
-		}
-		else // if (pin == YapDatabaseViewEnd)
-		{
-			if (originalRangeOffset < originalGroupCount) {
-				originalRangeMax = originalGroupCount - originalRangeOffset;
-				originalRangeMin = originalRangeMax - originalRangeLength;
-			}
-			else {
-				originalRangeMax = 0;
-				originalRangeMin = 0;
-			}
-		}
-		
-		NSUInteger finalRangeLength;
-		NSUInteger finalRangeOffset;
-		
-		NSUInteger finalRangeMin;
-		NSUInteger finalRangeMax;
-		
-		NSUInteger flexibleRangeNonPinSideDeleteDiff = 0;
-		NSUInteger flexibleRangePinSideInsertDiff = 0;
-		NSUInteger flexibleRangeNonPinSideInsertDiff = 0;
-		
-		if (rangeOpts.isFixedRange)
-		{
-			// FIXED Range:
-			//
-			// - The length is fixed. It only shrinks if we run out of keys.
-			// - The offset never changes.
-			//
-			// If pinned to the BEGINNING:
-			//   The offset represents how far the beginning of the range is from the beginning of the group.
-			//
-			//   Group : <---------------------------------------->
-			//   Range :                  <--------->
-			//   Offset: <---------------->                          (pin == YapDatabaseViewBeginning)
-			//
-			// If pinned to the END:
-			//   The offset represents how far the end of the range is from the end of the group.
-			//
-			//   Group : <---------------------------------------->
-			//   Range :                  <--------->
-			//   Offset:                            <------------->  (pin == YapDatabaseViewEnd)
-			
-			finalRangeOffset = originalRangeOffset;
-			
-			NSUInteger maxFinalRangeLength;
-			if (finalGroupCount > finalRangeOffset)
-				maxFinalRangeLength = finalGroupCount - finalRangeOffset;
-			else
-				maxFinalRangeLength = 0;
-			
-			finalRangeLength = MIN(rangeOpts.maxLength, maxFinalRangeLength);
-			
-			if (pin == YapDatabaseViewBeginning)
-			{
-				finalRangeMin = finalRangeOffset;
-				finalRangeMax = finalRangeOffset + finalRangeLength;
-			}
-			else // if (pin == YapDatabaseViewEnd)
-			{
-				if (finalRangeOffset < finalGroupCount) {
-					finalRangeMax = finalGroupCount - finalRangeOffset;
-					finalRangeMin = finalRangeMax - finalRangeLength;
-				}
-				else {
-					finalRangeMax = 0;
-					finalRangeMin = 0;
-				}
-			}
-		}
-		else // if (rangeOpts.isFlexibleRange)
-		{
-			// FLEXIBLE Range:
-			// 
-			// The length changes as items are inserted and deleted with the range boundary.
-			// The offset changes as items are inserted and deleted between the range and its pinned end.
-			
-			finalRangeMin = originalRangeMin;
-			finalRangeMax = originalRangeMax;
-			
-			BOOL finalRangeWasEmpty = ((finalRangeMax - finalRangeMin) == 0);
-			
-			YapDatabaseViewGrowOptions growOptions = rangeOpts.growOptions;
-			
-			for (YapDatabaseViewRowChange *rowChange in rowChanges)
-			{
-				if (rowChange->type == YapDatabaseViewChangeDelete || rowChange->type == YapDatabaseViewChangeMove)
-				{
-					if ([rowChange->originalGroup isEqualToString:group])
-					{
-						// A DELETE operation can:
-						// - decrement the location of the final range
-						// - decrease the length of the final range
-					
-						if (rowChange->opOriginalIndex < finalRangeMin)
-						{
-							finalRangeMin -= 1;
-						}
-						if (rowChange->opOriginalIndex < finalRangeMax)
-						{
-							finalRangeMax -= 1;
-						}
-					}
-					
-				}// fi (rowChange->type == YapDatabaseViewChangeDelete || rowChange->type == YapDatabaseViewChangeMove)
-				
-				if (rowChange->type == YapDatabaseViewChangeInsert || rowChange->type == YapDatabaseViewChangeMove)
-				{
-					if ([rowChange->finalGroup isEqualToString:group])
-					{
-						// An INSERT operation can:
-						// - increment the location of the final range
-						// - increase the length of the final range
-						//
-						// How do we know if an inserted item should be included in the range?
-						// This is based upon the growOptions.
-						//
-						// Please see the documentation in the header file for the growOptions property.
-						// It has an extended discussion.
-						
-						if (pin == YapDatabaseViewBeginning)
-						{
-							if ((growOptions & YapDatabaseViewGrowPinSide) || finalRangeWasEmpty)
-							{
-								if (rowChange->opFinalIndex < finalRangeMin)
-									finalRangeMin++;
-							}
-							else
-							{
-								if (rowChange->opFinalIndex <= finalRangeMin)
-									finalRangeMin++;
-							}
-							
-							if ((growOptions & YapDatabaseViewGrowNonPinSide) || finalRangeWasEmpty)
-							{
-								if (rowChange->opFinalIndex <= finalRangeMax)
-									finalRangeMax++;
-							}
-							else
-							{
-								if (rowChange->opFinalIndex < finalRangeMax)
-									finalRangeMax++;
-							}
-						}
-						else // if (pin == YapDatabaseViewEnd)
-						{
-							if ((growOptions & YapDatabaseViewGrowNonPinSide) || finalRangeWasEmpty)
-							{
-								if (rowChange->opFinalIndex < finalRangeMin)
-									finalRangeMin++;
-							}
-							else
-							{
-								if (rowChange->opFinalIndex <= finalRangeMin)
-									finalRangeMin++;
-							}
-							
-							if ((growOptions & YapDatabaseViewGrowPinSide) || finalRangeWasEmpty)
-							{
-								if (rowChange->opFinalIndex <= finalRangeMax)
-									finalRangeMax++;
-							}
-							else
-							{
-								if (rowChange->opFinalIndex < finalRangeMax)
-									finalRangeMax++;
-							}
-						}
-					}
-					
-				}// fi (rowChange->type == YapDatabaseViewChangeInsert || rowChange->type == YapDatabaseViewChangeMove)
-				
-				// If the range ever becomes empty,
-				// then we need to effectively set the growOptions to YapDatabaseViewGrowOnBothSides.
-				//
-				// With an empty range, there is no different between PinSide and NonPinSide.
-				//
-				// Notice that this flag, once set, remains set.
-				
-				finalRangeWasEmpty = finalRangeWasEmpty || ((finalRangeMax - finalRangeMin) == 0);
-				
-			} // end for (YapDatabaseViewRowChange *rowChange in rowChanges)
-			
-			
-			// Adjust if we exceed max length, or drop below min length
-			
-			finalRangeLength = finalRangeMax - finalRangeMin;
-			
-			if (finalRangeLength > rangeOpts.maxLength)
-			{
-				NSUInteger diff = finalRangeLength - rangeOpts.maxLength;
-				flexibleRangeNonPinSideDeleteDiff = diff;
-				
-				if (pin == YapDatabaseViewBeginning)
-				{
-					// Prune from non-pin-side (end)
-					finalRangeMax -= diff;
-				}
-				else // if (pin == YapDatabaseViewEnd)
-				{
-					// Prune from non-pin-side (beginning)
-					finalRangeMin += diff;
-				}
-				
-			}
-			else if ((finalRangeLength < rangeOpts.minLength) && (finalRangeLength < finalGroupCount))
-			{
-				NSUInteger diff = rangeOpts.minLength - finalRangeLength;
-				
-				if (pin == YapDatabaseViewBeginning)
-				{
-					// Append from pin-side first (beginning) (if possible)
-					if (finalRangeMin > 0)
-					{
-						NSUInteger pinSideDiff = MIN(diff, finalRangeMin);
-						flexibleRangePinSideInsertDiff = pinSideDiff;
-						
-						finalRangeMin -= pinSideDiff;
-						diff -= pinSideDiff;
-					}
-					
-					// Append from non-pin-side second (end) (if possible) (if still needed)
-					if ((finalRangeMax < finalGroupCount) && (diff > 0))
-					{
-						NSUInteger nonPinSideDiff = MIN(diff, (finalGroupCount - finalRangeMax));
-						flexibleRangeNonPinSideInsertDiff = nonPinSideDiff;
-						
-						finalRangeMax += nonPinSideDiff;
-						//diff -= nonPinSideDiff;
-					}
-				}
-				else // if (pin == YapDatabaseViewEnd)
-				{
-					// Append from pin-side first (end) (if possible)
-					if (finalRangeMax < finalGroupCount)
-					{
-						NSUInteger pinSideDiff = MIN(diff, (finalGroupCount - finalRangeMax));
-						flexibleRangePinSideInsertDiff = pinSideDiff;
-						
-						finalRangeMax += pinSideDiff;
-						diff -= pinSideDiff;
-					}
-					
-					// Append from non-pin-side second (beginning) (if possible) (if still needed)
-					if ((finalRangeMin > 0) && (diff > 0))
-					{
-						NSUInteger nonPinSideDiff = MIN(diff, finalRangeMin);
-						flexibleRangeNonPinSideInsertDiff = nonPinSideDiff;
-						
-						finalRangeMin -= nonPinSideDiff;
-						//diff -= nonPinSideDiff;
-					}
-				}
-			}
-			
-			// Set finalLength & finalOffset
-		
-			finalRangeLength = finalRangeMax - finalRangeMin;
-			
-			if (pin == YapDatabaseViewBeginning)
-				finalRangeOffset = finalRangeMin;
-			else
-				finalRangeOffset = finalGroupCount - finalRangeMax;
-		
-		} // END if (rangeOpts.isFlexibleRange)
-		
-		//
-		// STEP 2 : Filter items that are outside the range, and "map" items that are inside the range.
-		//
-		// By "map" we mean update the index to match the range, not the entire view.
-		// For example, if there is a hard range to display only the last 20 items in the view,
-		// then the index of the last item should be 20 (range.length), not 436 (group.length).
-		
-		NSUInteger deleteCount = 0;
-		NSUInteger insertCount = 0;
-		
-		NSUInteger i = 0;
-		while (i < [rowChanges count])
-		{
-			YapDatabaseViewRowChange *rowChange = [rowChanges objectAtIndex:i];
-			
-			if (rowChange->type == YapDatabaseViewChangeDelete)
-			{
-				if ([rowChange->originalGroup isEqualToString:group])
-				{
-					if (rowChange->originalIndex >= originalRangeMin &&
-					    rowChange->originalIndex <  originalRangeMax)
-					{
-						// Include in changeset
-						i++;
-						deleteCount++;
-						
-						// Update index to match range
-						rowChange->originalIndex -= originalRangeMin;
-					}
-					else
-					{
-						// Exclude from changeset
-						[rowChanges removeObjectAtIndex:i];
-					}
-				}
-			}
-			else if (rowChange->type == YapDatabaseViewChangeInsert)
-			{
-				if ([rowChange->finalGroup isEqualToString:group])
-				{
-					if (rowChange->finalIndex >= finalRangeMin &&
-					    rowChange->finalIndex <  finalRangeMax)
-					{
-						// Include in changeset
-						i++;
-						insertCount++;
-						
-						// Update index to match range
-						rowChange->finalIndex -= finalRangeMin;
-					}
-					else
-					{
-						// Exclude from changeset
-						[rowChanges removeObjectAtIndex:i];
-					}
-				}
-			}
-			else if (rowChange->type == YapDatabaseViewChangeUpdate)
-			{
-				if ([rowChange->originalGroup isEqualToString:group])
-				{
-					if (rowChange->originalIndex >= originalRangeMin &&
-					    rowChange->originalIndex <  originalRangeMax)
-					{
-						// Include in changeset
-						i++;
-						
-						// Update index to match range
-						rowChange->originalIndex -= originalRangeMin;
-						rowChange->finalIndex    -= finalRangeMin;
-					}
-					else
-					{
-						// Exclude from changeset
-						[rowChanges removeObjectAtIndex:i];
-					}
-				}
-			}
-			else if (rowChange->type == YapDatabaseViewChangeMove)
-			{
-				// A move is both a delete and an insert.
-				// Sometimes both operations apply to this group.
-				// Sometimes only one.
-				// Sometimes neither.
-				
-				BOOL filterDelete = NO;
-				BOOL filterInsert = NO;
-				
-				if ([rowChange->originalGroup isEqualToString:group])
-				{
-					if (rowChange->originalIndex >= originalRangeMin &&
-					    rowChange->originalIndex <  originalRangeMax)
-					{
-						// Include (delete operation) in changeset
-						
-						// Update index to match range
-						rowChange->originalIndex -= originalRangeMin;
-					}
-					else
-					{
-						// Exclude (delete operation) from changeset
-						filterDelete = YES;
-					}
-				}
-				
-				if ([rowChange->finalGroup isEqualToString:group])
-				{
-					if (rowChange->finalIndex >= finalRangeMin &&
-					    rowChange->finalIndex <  finalRangeMax)
-					{
-						// Include (insert operation) in changeset
-						
-						// Update index to match range
-						rowChange->finalIndex -= finalRangeMin;
-					}
-					else
-					{
-						// Exclude (insert operation) from changeset
-						filterInsert = YES;
-					}
-				}
-				
-				if (filterDelete && filterInsert)
-				{
-					// Exclude from changeset
-					[rowChanges removeObjectAtIndex:i];
-				}
-				else if (filterDelete && !filterInsert)
-				{
-					// Move -> Insert
-					rowChange->type = YapDatabaseViewChangeInsert;
-					i++;
-					insertCount++;
-				}
-				else if (!filterDelete && filterInsert)
-				{
-					// Move -> Delete
-					rowChange->type = YapDatabaseViewChangeDelete;
-					i++;
-					deleteCount++;
-				}
-				else
-				{
-					// Move
-					i++;
-					insertCount++;
-					deleteCount++;
-				}
-			}
-		}
-		
-		//
-		// STEP 3: Fix the final counts by manually adding any needed insertions or deletions
-		//
-		
-		NSUInteger numberOfInsertOperationsToManuallyAdd = 0;
-		NSUInteger numberOfDeleteOperationsToManuallyAdd = 0;
-		
-		if (rangeOpts.isFixedRange)
-		{
-			// FIXED Range:
-			//
-			// For fixed ranges, we need to ensure the changeset reflects the proper count.
-			// For example:
-			//
-			// The fixed range has a lenth of 20.
-			// The only changes were 2 insertions.
-			// Thus, we need to add 2 delete changes to balance the length.
-			//
-			// These represent the items that got pushed out of the range.
-			
-			NSUInteger length = originalRangeLength;
-			length += insertCount;
-			length -= deleteCount;
-			
-			if (length > finalRangeLength)
-			{
-				// Need to add DELETE operations.
-				
-				numberOfDeleteOperationsToManuallyAdd = length - finalRangeLength;
-			}
-			else if (length < finalRangeLength)
-			{
-				// Need to add INSERT operations.
-				
-				numberOfInsertOperationsToManuallyAdd = finalRangeLength - length;
-			}
-		}
-		else if (flexibleRangeNonPinSideDeleteDiff != 0)
-		{
-			// FLEXIBLE Range:
-			//
-			// The range naturally expanded to the point where it exceeded the max length.
-			// We may need to manually add DELETE operations.
-			
-			NSInteger expectedDiff = finalRangeLength - originalRangeLength;
-			NSInteger actualDiff = insertCount - deleteCount;
-			
-			// Example 1: typical length going above max
-			//
-			// originalRangeLength = 5, finalRangeLength = 10, max = 10, insertCount = 10, deleteCount = 0
-			// expectedDiff = 5
-			// actualDiff = 10
-			
-			// Example 2: user changed max value on us without changing length
-			//            (not technically supporeted, but not overly difficult to handle)
-			//
-			// originalRangeLength = 10, finalRangeLength = 5, max = 5, insertCount = 1, deleteCount = 0
-			// expectedDiff = -5
-			// actualDiff = 1
-			
-			if (actualDiff > expectedDiff)
-			{
-				numberOfDeleteOperationsToManuallyAdd = actualDiff - expectedDiff;
-			}
-		}
-		else if ((flexibleRangePinSideInsertDiff > 0) || (flexibleRangeNonPinSideInsertDiff > 0))
-		{
-			// FLEXIBLE Range:
-			//
-			// The range naturally shrunk to the point where it was smaller than the min length.
-			// We may need to manually add INSERT operations.
-			//
-			// Note: The originalRangeLength may actually be smaller than the finalRangeLength.
-			
-			NSInteger expectedDiff = finalRangeLength - originalRangeLength;
-			NSInteger actualDiff = insertCount - deleteCount;
-			
-			// Example 1: database near empty to begin with
-			//
-			// originalRangeLength = 1, finalRangeLength = 5, min = 5, insertCount = 5, deleteCount = 1
-			// expectedDiff = 4
-			// actualDiff = 4
-			
-			// Example 2: typical length dropping below min
-			//
-			// originalRangeLength = 5, finalRangeLength = 5, min = 5, insertCount = 0, deleteCount = 2
-			// expectedDiff = 0
-			// actualDiff = -2
-			
-			// Example 3:  typical length dropping below min
-			//
-			// originalRangeLength = 10, finalRangeLength = 5, min = 5, insertCount = 0, deleteCount = 8
-			// expectedDiff = -5
-			// actualDiff = -8
-			
-			// Example 4: user changed min value on us without changing length
-			//            (not technically supported, but not overly difficult to handle)
-			//
-			// originalRangeLength = 2, finalRangeLength = 5, min = 5, insertCount = 2, deleteCount = 0
-			// expectedDiff = 3
-			// actualDiff = 2
-			
-			if (actualDiff < expectedDiff)
-			{
-				numberOfInsertOperationsToManuallyAdd = expectedDiff - actualDiff;
-			}
-		}
-		
-		if (numberOfDeleteOperationsToManuallyAdd > 0)
-		{
-			// Manually add DELETE operations.
-			// 
-			// These operations represent the objects that got pushed out of the final range,
-			// even though the items themselves didn't change.
-			//
-			// They are to go at the end opposite the pin.
-			
-			NSUInteger count = 0;
-			
-			NSUInteger index;
-			if (pin == YapDatabaseViewBeginning)
-				index = originalRangeLength - 1;
-			else
-				index = 0;
-			
-			while (count < numberOfDeleteOperationsToManuallyAdd)
-			{
-				// We need to be careful not to step on existing rowChanges.
-				// If there is an existing delete for this index, we need to continue onto the next index.
-				// If there is an existing move from this index, we need to continue onto the next index.
-				// If there is an existing update for this index, we need to change it to a delete.
-				
-				BOOL found = NO;
-				
-				for (YapDatabaseViewRowChange *rowChange in rowChanges)
-				{
-					if (rowChange->type == YapDatabaseViewChangeDelete ||
-						rowChange->type == YapDatabaseViewChangeMove)
-					{
-						if (rowChange->originalIndex == index && [rowChange->originalGroup isEqualToString:group])
-						{
-							found = YES;
-							break;
-						}
-					}
-					else if (rowChange->type == YapDatabaseViewChangeUpdate)
-					{
-						if (rowChange->originalIndex == index && [rowChange->originalGroup isEqualToString:group])
-						{
-							rowChange->type = YapDatabaseViewChangeDelete;
-							
-							count++;
-							found = YES;
-							break;
-						}
-					}
-				}
-				
-				if (!found)
-				{
-					YapDatabaseViewRowChange *rowChange =
-					    [YapDatabaseViewRowChange deleteKey:nil inGroup:group atIndex:index];
-					
-					[rowChanges addObject:rowChange];
-					count++;
-				}
-				
-				if (pin == YapDatabaseViewBeginning)
-					index--;
-				else
-					index++;
-			}
-		}
-		
-		if ((numberOfInsertOperationsToManuallyAdd > 0) && (flexibleRangePinSideInsertDiff > 0))
-		{
-			// Manually add INSERT operations.
-			//
-			// These operations represent the objects that got pulled into the final range,
-			// even though the items themselves didn't change.
-			//
-			// They are to go pin side.
-			//
-			// Note: This code path is only taken if using a flexibleRange
-			
-			NSUInteger i = 0;
-			NSUInteger count = 0;
-			
-			NSUInteger index;
-			if (pin == YapDatabaseViewBeginning)
-				index = finalRangeMin;
-			else
-				index = finalRangeLength - 1;
-			
-			while ((count < numberOfInsertOperationsToManuallyAdd) && (i < flexibleRangePinSideInsertDiff))
-			{
-				// We need to be careful not to step on existing rowChanges.
-				// If there is an existing insert for this index, we need to continue onto the next index.
-				// If there is an existing move to this index, we need to continue onto the next index.
-				// If there is an existing update for this index, we need to change it to an insert.
-				//
-				// Note: I don't think the update scenario is actually possible.
-				
-				BOOL found = NO;
-				
-				for (YapDatabaseViewRowChange *rowChange in rowChanges)
-				{
-					if (rowChange->type == YapDatabaseViewChangeInsert ||
-						rowChange->type == YapDatabaseViewChangeMove)
-					{
-						if (rowChange->finalIndex == index && [rowChange->finalGroup isEqualToString:group])
-						{
-							found = YES;
-							break;
-						}
-					}
-					else if (rowChange->type == YapDatabaseViewChangeUpdate)
-					{
-						if (rowChange->finalIndex == index && [rowChange->finalGroup isEqualToString:group])
-						{
-							rowChange->type = YapDatabaseViewChangeInsert;
-							
-							count++;
-							found = YES;
-							break;
-						}
-					}
-				}
-				
-				if (!found)
-				{
-					YapDatabaseViewRowChange *rowChange =
-					    [YapDatabaseViewRowChange insertKey:nil inGroup:group atIndex:index];
-					
-					[rowChanges addObject:rowChange];
-					count++;
-				}
-				
-				if (pin == YapDatabaseViewBeginning)
-					index++;
-				else
-					index--;
-				
-				i++;
-			}
-			
-			numberOfInsertOperationsToManuallyAdd -= count;
-		}
-		
-		if (numberOfInsertOperationsToManuallyAdd > 0)
-		{
-			// Manually add INSERT operations.
-			// 
-			// These operations represent the objects that got pulled into the final range,
-			// even though the items themselves didn't change.
-			//
-			// They are to go at the end opposite the pin.
-			
-			NSUInteger count = 0;
-			
-			NSUInteger index;
-			if (pin == YapDatabaseViewBeginning)
-				index = finalRangeLength - 1;
-			else
-				index = 0;
-			
-			while (count < numberOfInsertOperationsToManuallyAdd)
-			{
-				// We need to be careful not to step on existing rowChanges.
-				// If there is an existing insert for this index, we need to continue onto the next index.
-				// If there is an existing move to this index, we need to continue onto the next index.
-				// If there is an existing update for this index, we need to change it to an insert.
-				//
-				// Note: I don't think the update scenario is actually possible.
-				
-				BOOL found = NO;
-				
-				for (YapDatabaseViewRowChange *rowChange in rowChanges)
-				{
-					if (rowChange->type == YapDatabaseViewChangeInsert ||
-						rowChange->type == YapDatabaseViewChangeMove)
-					{
-						if (rowChange->finalIndex == index && [rowChange->finalGroup isEqualToString:group])
-						{
-							found = YES;
-							break;
-						}
-					}
-					else if (rowChange->type == YapDatabaseViewChangeUpdate)
-					{
-						if (rowChange->finalIndex == index && [rowChange->finalGroup isEqualToString:group])
-						{
-							rowChange->type = YapDatabaseViewChangeInsert;
-							
-							count++;
-							found = YES;
-							break;
-						}
-					}
-				}
-				
-				if (!found)
-				{
-					YapDatabaseViewRowChange *rowChange =
-					    [YapDatabaseViewRowChange insertKey:nil inGroup:group atIndex:index];
-					
-					[rowChanges addObject:rowChange];
-					count++;
-				}
-				
-				if (pin == YapDatabaseViewBeginning)
-					index--;
-				else
-					index++;
-			}
-		}
-		
-		//
-		// STEP 4.A : Update finalMappings if needed (by updating rangeOpts.length & rangeOpts.offset)
-		
-		if ((originalRangeLength != finalRangeLength) || (originalRangeOffset != finalRangeOffset))
-		{
-			[finalMappings updateRangeOptionsForGroup:group withNewLength:finalRangeLength newOffset:finalRangeOffset];
-			rangeOptionsChanged = YES;
-		}
-		
-	} // for (NSString *group in rangeOptions)
-
-	// Step 4.B : Update finalMappings if needed (by updating visibleGroups)
-
-	if (rangeOptionsChanged)
-	{
-		[finalMappings updateVisibility];
-	}
-	
-	//
-	// STEP 5 : Set the originalSection & finalSection
-	// STEP 6 : Reverse indexes for reversed groups
-	//
-
-	NSSet *reverse = [originalMappings reverse];
-	
-	for (YapDatabaseViewRowChange *rowChange in rowChanges)
-	{
-		// Set the originalSection & finalSection
-		
-		if (rowChange->type == YapDatabaseViewChangeDelete)
-		{
-			rowChange->originalSection = [originalMappings sectionForGroup:rowChange->originalGroup];
-		}
-		else if (rowChange->type == YapDatabaseViewChangeInsert)
-		{
-			rowChange->finalSection = [finalMappings sectionForGroup:rowChange->finalGroup];
-		}
-		else if (rowChange->type == YapDatabaseViewChangeUpdate)
-		{
-			rowChange->originalSection = [originalMappings sectionForGroup:rowChange->originalGroup];
-			rowChange->finalSection    = [finalMappings sectionForGroup:rowChange->finalGroup];
-			
-			if (rowChange->originalSection != rowChange->finalSection)
-			{
-				// Turn the update into a move.
-				// If we don't do so, UITableView seems to do the wrong thing.
-				
-				rowChange->type = YapDatabaseViewChangeMove;
-			}
-		}
-		else // if (rowChange->type == YapDatabaseViewChangeMove)
-		{
-			rowChange->originalSection = [originalMappings sectionForGroup:rowChange->originalGroup];
-			rowChange->finalSection    = [finalMappings sectionForGroup:rowChange->finalGroup];
-		}
-		
-		// Reverse indexes for reversed groups.
-		//
-		// For example, if the group contains 4 items, the indexes get reversed like so:
-		// 0 -> 3
-		// 1 -> 2
-		// 2 -> 1
-		// 3 -> 0
-		//
-		// Basically, we find the midpoint, and then move each index to the other side of the midpoint,
-		// but we keep its distance from the midpoint the same.
-			
-		if ([reverse containsObject:rowChange->originalGroup])
-		{
-			NSUInteger count = [originalMappings visibleCountForGroup:rowChange->originalGroup];
-			double mid = (count - 1) / 2.0;
-			
-			rowChange->originalIndex = (NSUInteger)(mid - (rowChange->originalIndex - mid));
-		}
-		
-		if ([reverse containsObject:rowChange->finalGroup])
-		{
-			NSUInteger count = [finalMappings visibleCountForGroup:rowChange->finalGroup];
-			double mid = (count - 1) / 2.0;
-			
-			rowChange->finalIndex = (NSUInteger)(mid - (rowChange->finalIndex - mid));
-		}
-	}
-	
-	//
-	// STEP 7 : Handle group consolidation
-	//
-	
-	BOOL oldIsUsingConsolidatedGroup = [originalMappings isUsingConsolidatedGroup];
-	BOOL newIsUsingConsolidatedGroup = [finalMappings isUsingConsolidatedGroup];
-	
-	if (oldIsUsingConsolidatedGroup && newIsUsingConsolidatedGroup)
-	{
-		//
-		// The groups were previously consolidated, and still are.
-		//
-		
-		NSString *consolidatedGroupName = [originalMappings consolidatedGroupName];
-		
-		// Step 1
-		//
-		// - calculate original & final offset for each group
-		
-		NSArray *allGroups = [originalMappings allGroups];
-		
-		NSMutableDictionary *originalOffsets = [NSMutableDictionary dictionaryWithCapacity:[allGroups count]];
-		NSMutableDictionary *finalOffsets = [NSMutableDictionary dictionaryWithCapacity:[allGroups count]];
-		
-		NSUInteger originalOffset = 0;
-		NSUInteger finalOffset = 0;
-		
-		for (NSString *group in allGroups)
-		{
-			[originalOffsets setObject:@(originalOffset) forKey:group];
-			[finalOffsets    setObject:@(finalOffset)    forKey:group];
-			
-			originalOffset += [originalMappings visibleCountForGroup:group];
-			finalOffset    += [finalMappings visibleCountForGroup:group];
-		}
-		
-		// Step 2
-		//
-		// - change section to zero, and group to consolidatedGroupName for each change
-		// - increment original & final row index for each change
-		
-		for (YapDatabaseViewRowChange *rowChange in rowChanges)
-		{
-			if (rowChange->type == YapDatabaseViewChangeDelete)
-			{
-				NSUInteger oOffset = [[originalOffsets objectForKey:rowChange->originalGroup] unsignedIntegerValue];
-				
-				rowChange->originalGroup = consolidatedGroupName;
-				rowChange->originalSection = 0;
-				rowChange->originalIndex += oOffset;
-			}
-			else if (rowChange->type == YapDatabaseViewChangeInsert)
-			{
-				NSUInteger fOffset = [[finalOffsets objectForKey:rowChange->finalGroup] unsignedIntegerValue];
-				
-				rowChange->finalGroup = consolidatedGroupName;
-				rowChange->finalSection = 0;
-				rowChange->finalIndex += fOffset;
-			}
-			else if (rowChange->type == YapDatabaseViewChangeMove)
-			{
-				NSUInteger oOffset = [[originalOffsets objectForKey:rowChange->originalGroup] unsignedIntegerValue];
-				NSUInteger fOffset = [[finalOffsets objectForKey:rowChange->finalGroup] unsignedIntegerValue];
-				
-				rowChange->originalGroup = consolidatedGroupName;
-				rowChange->originalSection = 0;
-				rowChange->originalIndex += oOffset;
-				
-				rowChange->finalGroup = consolidatedGroupName;
-				rowChange->finalSection = 0;
-				rowChange->finalIndex += fOffset;
-			}
-			else // if (rowChange->type == YapDatabaseViewChangeUpdate)
-			{
-				NSUInteger oOffset = [[originalOffsets objectForKey:rowChange->originalGroup] unsignedIntegerValue];
-				NSUInteger fOffset = [[finalOffsets objectForKey:rowChange->finalGroup] unsignedIntegerValue];
-				
-				rowChange->originalGroup = consolidatedGroupName;
-				rowChange->originalSection = 0;
-				rowChange->originalIndex += oOffset;
-				
-				rowChange->finalGroup = consolidatedGroupName;
-				rowChange->finalSection = 0;
-				rowChange->finalIndex += fOffset;
-				
-				if (rowChange->originalIndex != rowChange->finalIndex)
-				{
-					rowChange->type = YapDatabaseViewChangeMove;
-				}
-			}
-		}
-	}
-	else if (!oldIsUsingConsolidatedGroup && newIsUsingConsolidatedGroup)
-	{
-		//
-		// Switching from groups to consolidated group
-		//
-		
-		NSString *consolidatedGroupName = [originalMappings consolidatedGroupName];
-		
-		// Step 1
-		//
-		// - calculate the offsets for each group within the consolidated group
-		
-		NSArray *allGroups = [originalMappings allGroups];
-		
-		NSMutableDictionary *finalOffsets = [NSMutableDictionary dictionaryWithCapacity:[allGroups count]];
-		NSUInteger finalOffset = 0;
-		
-		for (NSString *group in allGroups)
-		{
-			[finalOffsets setObject:@(finalOffset) forKey:group];
-			
-			finalOffset += [finalMappings visibleCountForGroup:group];
-		}
-		
-		// Step 2
-		//
-		// - enumerate over every single row that was visible in the originalMappings
-		// - check to see if its already represented in the existing array of rowChanges
-		// - if not, then inject a move operation for it
-		
-		NSUInteger beginningChangeCount = [rowChanges count];
-		
-		for (NSString *group in [originalMappings visibleGroups])
-		{
-			NSUInteger originalSection = [originalMappings sectionForGroup:group];
-			NSUInteger finalSection = [finalMappings sectionForGroup:group];
-			
-			NSUInteger originalGroupCount = [originalMappings visibleCountForGroup:group];
-			
-			for (NSUInteger originalIndex = 0; originalIndex < originalGroupCount; originalIndex++)
-			{
-				BOOL found = NO;
-				NSUInteger finalIndex = originalIndex;
-				
-				for (NSUInteger i = 0; i < beginningChangeCount; i++)
-				{
-					YapDatabaseViewRowChange *rowChange = [rowChanges objectAtIndex:i];
-					
-					if (rowChange->type != YapDatabaseViewChangeInsert &&
-					    rowChange->originalSection == originalSection &&
-						rowChange->originalIndex == originalIndex)
-					{
-						found = YES;
-						break;
-					}
-					
-					if (rowChange->type == YapDatabaseViewChangeDelete ||
-					    rowChange->type == YapDatabaseViewChangeMove )
-					{
-						if (rowChange->originalSection == originalSection)
-						{
-							if (rowChange->originalIndex < finalIndex)
-							{
-								// A row was deleted below our row.
-								// So its finalIndex gets decremented.
-								finalIndex--;
-							}
-						}
-					}
-					
-					if (rowChange->type == YapDatabaseViewChangeInsert ||
-					    rowChange->type == YapDatabaseViewChangeMove )
-					{
-						if (rowChange->finalSection == finalSection)
-						{
-							if (rowChange->finalIndex <= finalIndex)
-							{
-								// A row was inserted below our row.
-								// So its finalIndex gets incremented.
-								finalIndex++;
-							}
-						}
-					}
-				}
-				
-				if (!found)
-				{
-					YapDatabaseViewRowChange *op = [[YapDatabaseViewRowChange alloc] init];
-					op->type = YapDatabaseViewChangeMove;
-					op->key = nil;
-					op->changes = 0;
-					
-					op->originalGroup = group;
-					op->originalSection = originalSection;
-					op->originalIndex = originalIndex;
-					
-					NSUInteger finalGroupOffset = [[finalOffsets objectForKey:group] unsignedIntegerValue];
-					
-					op->finalGroup = consolidatedGroupName;
-					op->finalSection = 0;
-					op->finalIndex = finalGroupOffset + finalIndex;
-					
-					[rowChanges addObject:op];
-				}
-			}
-		}
-		
-		// Step 3
-		//
-		// - update the finalGroup/finalSection/finalIndex for every rowChange
-		//   (excluding the one's we injected)
-		
-		for (NSUInteger i = 0; i < beginningChangeCount; i++)
-		{
-			YapDatabaseViewRowChange *rowChange = [rowChanges objectAtIndex:i];
-			
-			if (rowChange->type == YapDatabaseViewChangeInsert)
-			{
-				NSUInteger fOffset = [[finalOffsets objectForKey:rowChange->finalGroup] unsignedIntegerValue];
-				
-				rowChange->finalGroup = consolidatedGroupName;
-				rowChange->finalSection = 0;
-				rowChange->finalIndex += fOffset;
-			}
-			else if (rowChange->type == YapDatabaseViewChangeMove)
-			{
-				NSUInteger fOffset = [[finalOffsets objectForKey:rowChange->finalGroup] unsignedIntegerValue];
-				
-				rowChange->finalGroup = consolidatedGroupName;
-				rowChange->finalSection = 0;
-				rowChange->finalIndex += fOffset;
-			}
-			else if (rowChange->type == YapDatabaseViewChangeUpdate)
-			{
-				rowChange->type = YapDatabaseViewChangeMove;
-				
-				NSUInteger fOffset = [[finalOffsets objectForKey:rowChange->finalGroup] unsignedIntegerValue];
-				
-				rowChange->finalGroup = consolidatedGroupName;
-				rowChange->finalSection = 0;
-				rowChange->finalIndex += fOffset;
-			}
-		}
-	}
-	else if (oldIsUsingConsolidatedGroup && !newIsUsingConsolidatedGroup)
-	{
-		//
-		// Switching from consolidated group to groups
-		//
-		
-		NSString *consolidatedGroupName = [originalMappings consolidatedGroupName];
-		
-		// Step 1
-		//
-		// - calculate the offsets for each group within the consolidated group
-		
-		NSArray *allGroups = [originalMappings allGroups];
-		
-		NSMutableDictionary *originalOffsets = [NSMutableDictionary dictionaryWithCapacity:[allGroups count]];
-		
-		NSUInteger originalOffset = 0;
-		
-		for (NSString *group in allGroups)
-		{
-			[originalOffsets setObject:@(originalOffset) forKey:group];
-			
-			originalOffset += [originalMappings visibleCountForGroup:group];
-		}
-		
-		// Step 2
-		//
-		// - enumerate over every single row that was visible in the originalMappings
-		// - check to see if its already represented in the existing array of rowChanges
-		// - if not, then inject a move operation for it
-		
-		NSUInteger beginningChangeCount = [rowChanges count];
-		
-		for (NSString *group in [originalMappings visibleGroups])
-		{
-			NSUInteger originalSection = [originalMappings sectionForGroup:group];
-			NSUInteger finalSection = [finalMappings sectionForGroup:group];
-			
-			NSUInteger originalGroupCount = [originalMappings visibleCountForGroup:group];
-			
-			for (NSUInteger originalIndex = 0; originalIndex < originalGroupCount; originalIndex++)
-			{
-				BOOL found = NO;
-				NSUInteger finalIndex = originalIndex;
-				
-				for (NSUInteger i = 0; i < beginningChangeCount; i++)
-				{
-					YapDatabaseViewRowChange *rowChange = [rowChanges objectAtIndex:i];
-					
-					if (rowChange->type != YapDatabaseViewChangeInsert &&
-					    rowChange->originalSection == originalSection &&
-						rowChange->originalIndex == originalIndex)
-					{
-						found = YES;
-						break;
-					}
-					
-					if (rowChange->type == YapDatabaseViewChangeDelete ||
-					    rowChange->type == YapDatabaseViewChangeMove )
-					{
-						if (rowChange->originalSection == originalSection)
-						{
-							if (rowChange->originalIndex < finalIndex)
-							{
-								// A row was deleted below our row.
-								// So its finalIndex gets decremented.
-								finalIndex--;
-							}
-						}
-					}
-					
-					if (rowChange->type == YapDatabaseViewChangeInsert ||
-					    rowChange->type == YapDatabaseViewChangeMove )
-					{
-						if (rowChange->finalSection == finalSection)
-						{
-							if (rowChange->finalIndex <= finalIndex)
-							{
-								// A row was inserted below our row.
-								// So its finalIndex gets incremented.
-								finalIndex++;
-							}
-						}
-					}
-				}
-				
-				if (!found)
-				{
-					YapDatabaseViewRowChange *op = [[YapDatabaseViewRowChange alloc] init];
-					op->type = YapDatabaseViewChangeMove;
-					op->key = nil;
-					op->changes = 0;
-					
-					NSUInteger originalGroupOffset = [[originalOffsets objectForKey:group] unsignedIntegerValue];
-					
-					op->originalGroup = consolidatedGroupName;
-					op->originalSection = 0;
-					op->originalIndex = originalGroupOffset + originalIndex;
-					
-					op->finalGroup = group;
-					op->finalSection = finalSection;
-					op->finalIndex = finalIndex;
-					
-					[rowChanges addObject:op];
-				}
-			}
-		}
-		
-		// Step 3
-		//
-		// - update the originalGroup/originalSection/originalIndex for every rowChange
-		//   (excluding the one's we injected)
-		
-		for (NSUInteger i = 0; i < beginningChangeCount; i++)
-		{
-			YapDatabaseViewRowChange *rowChange = [rowChanges objectAtIndex:i];
-			
-			if (rowChange->type == YapDatabaseViewChangeDelete)
-			{
-				NSUInteger oOffset = [[originalOffsets objectForKey:rowChange->originalGroup] unsignedIntegerValue];
-				
-				rowChange->originalGroup = consolidatedGroupName;
-				rowChange->originalSection = 0;
-				rowChange->originalIndex += oOffset;
-			}
-			else if (rowChange->type == YapDatabaseViewChangeMove)
-			{
-				NSUInteger oOffset = [[originalOffsets objectForKey:rowChange->originalGroup] unsignedIntegerValue];
-				
-				rowChange->originalGroup = consolidatedGroupName;
-				rowChange->originalSection = 0;
-				rowChange->originalIndex += oOffset;
-			}
-			else if (rowChange->type == YapDatabaseViewChangeUpdate)
-			{
-				rowChange->type = YapDatabaseViewChangeMove;
-				
-				NSUInteger oOffset = [[originalOffsets objectForKey:rowChange->originalGroup] unsignedIntegerValue];
-				
-				rowChange->originalGroup = consolidatedGroupName;
-				rowChange->originalSection = 0;
-				rowChange->originalIndex += oOffset;
-			}
-		}
-	}
-}
-
-/**
- * This method applies the given mappings to the processed list of section changes.
- * It will filter the sectionChanges array to properly represent the configuration of the mappings.
-**/
-+ (void)postProcessAndFilterSectionChanges:(NSMutableArray *)sectionChanges
-                      withOriginalMappings:(YapDatabaseViewMappings *)originalMappings
-                             finalMappings:(YapDatabaseViewMappings *)finalMappings
-{
-	//
-	// STEP 1 : Handle dynamic sections
-	//
-	
-	NSUInteger i = 0;
-	while (i < [sectionChanges count])
-	{
-		YapDatabaseViewSectionChange *sectionChange = [sectionChanges objectAtIndex:i];
-		
-		if (sectionChange->type == YapDatabaseViewChangeDelete)
-		{
-			// Although a group was deleted, the user may be allowing empty sections.
-			// If so, we shouldn't emit a removeSection change.
-			
-			NSUInteger originalSection = [originalMappings sectionForGroup:sectionChange->group];
-			NSUInteger finalSection    = [finalMappings sectionForGroup:sectionChange->group];
-			
-			if ((originalSection != NSNotFound) && (finalSection == NSNotFound))
-			{
-				// Emit
-				sectionChange->originalSection = originalSection;
-				i++;
-			}
-			else
-			{
-				// Don't emit
-				[sectionChanges removeObjectAtIndex:i];
-			}
-		}
-		else // if (sectionChange->type == YapDatabaseViewChangeInsert)
-		{
-			// Although a group was inserted, the user may have been allowing empty sections.
-			// If so, we shouldn't emit an insertSection change.
-			
-			NSUInteger originalSection = [originalMappings sectionForGroup:sectionChange->group];
-			NSUInteger finalSection    = [finalMappings sectionForGroup:sectionChange->group];
-			
-			if ((originalSection == NSNotFound) && (finalSection != NSNotFound))
-			{
-				// Emit
-				sectionChange->finalSection = finalSection;
-				i++;
-			}
-			else
-			{
-				// Don't emit
-				[sectionChanges removeObjectAtIndex:i];
-			}
-		}
-	}
-	
-	//
-	// STEP 2 : Handle group consolidation
-	//
-	
-	BOOL oldIsUsingConsolidatedGroup = [originalMappings isUsingConsolidatedGroup];
-	BOOL newIsUsingConsolidatedGroup = [finalMappings isUsingConsolidatedGroup];
-	
-	if (oldIsUsingConsolidatedGroup && newIsUsingConsolidatedGroup)
-	{
-		//
-		// The groups were previously consolidated, and still are.
-		//
-		
-		// - clear section changes (everything stays within consolidated group)
-		
-		[sectionChanges removeAllObjects];
-	}
-	else if (!oldIsUsingConsolidatedGroup && newIsUsingConsolidatedGroup)
-	{
-		//
-		// Switching from groups to consolidated group
-		//
-		
-		// - clear section changes (so we can set them manually)
-		
-		[sectionChanges removeAllObjects];
-		
-		// - insert section delete for all original sections
-		
-		NSUInteger originalSection = 0;
-		for (NSString *originalGroup in [originalMappings visibleGroups])
-		{
-			YapDatabaseViewSectionChange *deleteOp = [YapDatabaseViewSectionChange deleteGroup:originalGroup];
-			deleteOp->originalSection = originalSection;
-			
-			[sectionChanges addObject:deleteOp];
-			originalSection++;
-		}
-		
-		// - insert section insert for consolidated group
-		
-		NSString *consolidatedGroupName = [originalMappings consolidatedGroupName];
-		
-		YapDatabaseViewSectionChange *insertOp = [YapDatabaseViewSectionChange insertGroup:consolidatedGroupName];
-		insertOp->finalSection = 0;
-		
-		[sectionChanges addObject:insertOp];
-	}
-	else if (oldIsUsingConsolidatedGroup && !newIsUsingConsolidatedGroup)
-	{
-		//
-		// Switching from consolidated group to groups
-		//
-		
-		// - clear section changes (so we can set them manually)
-		
-		[sectionChanges removeAllObjects];
-		
-		// - insert section delete for consolidatedGroup
-		
-		NSString *consolidatedGroupName = [originalMappings consolidatedGroupName];
-		
-		YapDatabaseViewSectionChange *deleteOp = [YapDatabaseViewSectionChange deleteGroup:consolidatedGroupName];
-		deleteOp->originalSection = 0;
-		
-		[sectionChanges addObject:deleteOp];
-		
-		// - insert section insert for all final sections
-		
-		NSUInteger finalSection = 0;
-		for (NSString *finalGroup in [finalMappings visibleGroups])
-		{
-			YapDatabaseViewSectionChange *insertOp = [YapDatabaseViewSectionChange insertGroup:finalGroup];
-			insertOp->finalSection = finalSection;
-			
-			[sectionChanges addObject:insertOp];
-			finalSection++;
-		}
-	}
-}
-
-+ (void)getSectionChanges:(NSArray **)sectionChangesPtr
-               rowChanges:(NSArray **)rowChangesPtr
-	 withOriginalMappings:(YapDatabaseViewMappings *)originalMappings
-			finalMappings:(YapDatabaseViewMappings *)finalMappings
-			  fromChanges:(NSArray *)changes
-{
-	NSMutableArray *sectionChanges = nil;
-	NSMutableArray *rowChanges = nil;
-	
-	[originalMappings setAutoConsolidatingDisabled:YES]; // disable during processing
-	[finalMappings setAutoConsolidatingDisabled:YES];    // disable during processing
-	
-	// PRE-PROCESSING
-	//
-	// Remove any items from the changes array that don't concern us.
-	
-	[self preProcessChanges:changes
-	   withOriginalMappings:originalMappings
-	          finalMappings:finalMappings
-	   andGetSectionChanges:&sectionChanges
-	             rowChanges:&rowChanges];
-	
-	//
-	// PROCESSING
-	//
-	// This is where the magic happens.
-	// Calculates original and final index of every change.
-	
-	[self processRowChanges:rowChanges];
-	
-	// CONSOLIDATION
-	//
-	// Merge multiple changes to same row into a single change.
-	// Merge multiple changes to a group into a zero or one change.
-	
-	[self consolidateRowChanges:rowChanges];
-	
-	[self consolidateSectionChanges:sectionChanges];
-	
-	//
-	// POST-PROCESSING
-	//
-	// This is where we apply the mappings to filter & alter the changeset.
-
-	[self postProcessAndFilterRowChanges:rowChanges
-	                withOriginalMappings:originalMappings
-	                       finalMappings:finalMappings];
-	
-	[self postProcessAndFilterSectionChanges:sectionChanges
-	                    withOriginalMappings:originalMappings
-	                           finalMappings:finalMappings];
-	
-	//
-	// DONE
-	//
-	
-	[originalMappings setAutoConsolidatingDisabled:NO];
-	[finalMappings setAutoConsolidatingDisabled:NO];
-	
-	if (sectionChangesPtr) *sectionChangesPtr = sectionChanges;
-	if (rowChangesPtr) *rowChangesPtr = rowChanges;
-}
-
-@end