bm-core-ui 2.12.0-beta.7 → 2.12.0-beta.8

package/build/@types/index.d.ts

@@ -11771,6 +11771,19 @@ export class BMCollectionViewLayoutInvalidationContext {
  */
 export class BMCollectionViewTransitionLayout extends BMCollectionViewLayout {
 
+	/**
+	 * When set to `YES` this transition layout will no longer perform updates.
+	 *     
+	 */
+	private _transitionStopped: boolean;
+
+	/**
+	 * Stops the current transition in its tracks, instantly setting the final attributes on all cells.
+	 *     
+	 */
+	private _stopTransition(): void;
+
+
 	/**
 	 * Controls how close to completion the transition is.
 	 *  
@@ -14249,6 +14262,14 @@ export class BMCollectionView<T = any> extends BMView implements BMDragDelegate,
 	setLayout(layout: BMCollectionViewLayout, {animated, completionHandler}?: {animated?: boolean | null | undefined, completionHandler?: (() => void) | null | undefined}): void;
 
 
+	/**
+	 * If a layout transition is currently in progress it is stopped, allowing data updates to
+	 * start without affecting the retained cells.
+	 *  
+	 */
+	private _stopLayoutTransition(): void;
+
+
 	/**
 	 * Invoked internally by CoreUI to perform a batched update of layout properties.
 	 * Using this method requires the layout object used by this collection view to support copying.
@@ -14535,6 +14556,14 @@ export class BMCollectionView<T = any> extends BMView implements BMDragDelegate,
 }
 
 
+/**
+ * Cleans up the changes performed by the current transition.
+ * 	 
+ */
+export function cleanupTransition(): void;
+
+
+
 /**
  * @deprecated - Use the static `collectionViewForNode` factory method.
  * 

package/build/BMCollectionView/BMCollectionView.js

@@ -1218,9 +1218,10 @@ BMCollectionView.prototype = BMExtend(BM_COLLECTION_VIEW_USE_BMVIEW_SUBCLASS ? O
 	    for (var i = 0; i < retainedCellsLength; i++) {
 		    // The retained cells array resizes itself when cells are removed
 		    this.retainedCells[0]._unmanage();
-	    }*/
+	    }
 	    
 	    this.retainedCells = [];
+		*/
 	    
 	    // Reload the layout
 		this._reloadLayout();
@@ -5526,8 +5527,66 @@ BMCollectionView.prototype = BMExtend(BM_COLLECTION_VIEW_USE_BMVIEW_SUBCLASS ? O
 		// regardless of where the new or old positions of cells might be
 		let size = layout.contentSize();
 		this._size = BMSizeMake(Math.max(this._size.width, size.width), Math.max(this._size.height, size.height));
+
+		/**
+		 * Cleans up the changes performed by the current transition.
+		 */
+		function cleanupTransition() {
+			if (self.iScroll) self.iScroll.refresh();
+		    
+		    // Unmanage all outgoing supplementary views
+		    for (var i = 0; i < outgoingSupplementaryViewAttributes.length; i++) {
+			    var attribute = outgoingSupplementaryViewAttributes[i];
+			    var cell = self.supplementaryViewWithIdentifier(attribute.identifier, {atIndexPath: attribute.indexPath});
+			    
+			    if (cell && cell.isManaged) {
+				    cell._unmanage();
+			    }
+			}
+
+			self._applyOverflows();
+
+			// Restore collection and invoke the data completion callbacks unless another animation is in progress
+			if (self._dataUpdatePromise == dataUpdatePromise) {
+				self._collectionEnabled = YES;
+				self.isUpdatingData = NO;
+				
+				self._executeDataCompletionCallbacks();
+			}
+
+			// If the delegate animation options contains a complete handler, invoke it here
+			if (delegateOptions.complete) delegateOptions.complete();
+			
+			// Run the completion handler if it was specified
+			if (options && options.completionHandler) options.completionHandler();
+
+			resolveLayoutUpdate();
+		}
 	    
 	    animationOptions.complete = function () {
+			// If the transition was stopped, don't continue with the remaining changes
+			if (self._layout != transitionLayout) {
+				self._size = size.copy();
+
+				if (self.iScroll) {
+					// Apply the new scroll offset internally to iScroll, if it changed
+					if (oldBounds.origin.x != newBounds.origin.x || oldBounds.origin.y != newBounds.origin.y) {
+						var targetOffset = newBounds.origin.copy();
+						
+						targetOffset.x += self._offscreenBufferSize;
+						targetOffset.y += self._offscreenBufferSize;
+						
+						self.iScroll._translate(-targetOffset.x, -targetOffset.y);
+					}
+				}
+				
+				animationCells.forEach(cell => cell.release());
+				retainedCells.forEach(cell => cell.release());
+
+				cleanupTransition();
+				return;
+			}
+
 			// Request the layout page
 			var attributes = transitionLayout.attributesForElementsInRect();
 			
@@ -5562,35 +5621,7 @@ BMCollectionView.prototype = BMExtend(BM_COLLECTION_VIEW_USE_BMVIEW_SUBCLASS ? O
 			self._layout = layout;
 			self._transitionLayout = undefined;
 			
-			if (self.iScroll) self.iScroll.refresh();
-		    
-		    // Unmanage all outgoing supplementary views
-		    for (var i = 0; i < outgoingSupplementaryViewAttributes.length; i++) {
-			    var attribute = outgoingSupplementaryViewAttributes[i];
-			    var cell = self.supplementaryViewWithIdentifier(attribute.identifier, {atIndexPath: attribute.indexPath});
-			    
-			    if (cell && cell.isManaged) {
-				    cell._unmanage();
-			    }
-			}
-
-			self._applyOverflows();
-
-			// Restore collection invoke the data completion callbacks unless another animation is in progress
-			if (self._dataUpdatePromise == dataUpdatePromise) {
-				self._collectionEnabled = YES;
-				self.isUpdatingData = NO;
-				
-				self._executeDataCompletionCallbacks();
-			}
-
-			// If the delegate animation options contains a complete handler, invoke it here
-			if (delegateOptions.complete) delegateOptions.complete();
-			
-			// Run the completion handler if it was specified
-			if (options && options.completionHandler) options.completionHandler();
-
-			resolveLayoutUpdate();
+			cleanupTransition();
 	    };
 	    
 		animationOptions.queue = NO;
@@ -5688,9 +5719,16 @@ BMCollectionView.prototype = BMExtend(BM_COLLECTION_VIEW_USE_BMVIEW_SUBCLASS ? O
 	    
     },
     
-    
-	
-	
+	/**
+	 * If a layout transition is currently in progress it is stopped, allowing data updates to
+	 * start without affecting the retained cells.
+	 */
+    _stopLayoutTransition() {
+		if (this._transitionLayout && this._layout == this._transitionLayout) {
+			this._layout._stopTransition();
+			this._layout = this._layout.targetLayout;
+		}
+	},
 	
 	/************************************* DATA SET UPDATE ************************************/
 
@@ -5860,6 +5898,9 @@ BMCollectionView.prototype = BMExtend(BM_COLLECTION_VIEW_USE_BMVIEW_SUBCLASS ? O
 		let resolveUpdateData;
 		const dataUpdatePromise = new Promise(function (resolve, reject) {resolveUpdateData = resolve});
 		this._dataUpdatePromise = dataUpdatePromise;
+
+		// Stop any in progress layout updates
+		this._stopLayoutTransition();
 		
 		// Update the selection index paths
 		this._updateSelectionIndexPaths();

package/build/BMCollectionView/BMCollectionViewLayout.js

@@ -910,6 +910,19 @@ export var _BMCollectionViewTransitionLayout = function (attributes, initialSize
 };
 
 _BMCollectionViewTransitionLayout.prototype = BMExtend({}, BMCollectionViewLayout.prototype, {
+
+    /**
+     * When set to `YES` this transition layout will no longer perform updates.
+     */
+    _transitionStopped: NO, // <Boolean>
+
+    /**
+     * Stops the current transition in its tracks, instantly setting the final attributes on all cells.
+     */
+    _stopTransition() {
+		this._applyFinalAttributes();
+        this._transitionStopped = YES;
+    },
 	
 	/**
 	 * Controls how close to completion the transition is.
@@ -917,6 +930,12 @@ _BMCollectionViewTransitionLayout.prototype = BMExtend({}, BMCollectionViewLayou
 	_fraction: 0, // <Number>
 	get fraction() { return this._fraction; },
 	set fraction(fraction) {
+        // If this transition was stopped, don't perform any other changes
+        if (this._transitionStopped) {
+            this._fraction = fraction;
+            return;
+        }
+
 		// If this is no longer attached to a collection view, don't perform any changes
 		if (!this.collectionView) return;
 

package/lib/@types/BMCoreUI.min.d.ts

@@ -11771,6 +11771,19 @@ declare class BMCollectionViewLayoutInvalidationContext {
  */
 declare class BMCollectionViewTransitionLayout extends BMCollectionViewLayout {
 
+	/**
+	 * When set to `YES` this transition layout will no longer perform updates.
+	 *     
+	 */
+	private _transitionStopped: boolean;
+
+	/**
+	 * Stops the current transition in its tracks, instantly setting the final attributes on all cells.
+	 *     
+	 */
+	private _stopTransition(): void;
+
+
 	/**
 	 * Controls how close to completion the transition is.
 	 *  
@@ -14249,6 +14262,14 @@ declare class BMCollectionView<T = any> extends BMView implements BMDragDelegate
 	setLayout(layout: BMCollectionViewLayout, {animated, completionHandler}?: {animated?: boolean | null | undefined, completionHandler?: (() => void) | null | undefined}): void;
 
 
+	/**
+	 * If a layout transition is currently in progress it is stopped, allowing data updates to
+	 * start without affecting the retained cells.
+	 *  
+	 */
+	private _stopLayoutTransition(): void;
+
+
 	/**
 	 * Invoked internally by CoreUI to perform a batched update of layout properties.
 	 * Using this method requires the layout object used by this collection view to support copying.
@@ -14535,6 +14556,14 @@ declare class BMCollectionView<T = any> extends BMView implements BMDragDelegate
 }
 
 
+/**
+ * Cleans up the changes performed by the current transition.
+ * 	 
+ */
+declare function cleanupTransition(): void;
+
+
+
 /**
  * @deprecated - Use the static `collectionViewForNode` factory method.
  *