collection

• CanonicalizedMap:
  • Added methods:
    • copy: copies an instance without recalculating the canonical values of the keys.
    • toMap: creates a Map<K,V> (with the original key values).
    • toMapOfCanonicalKeys: creates a Map<C,V> (with the canonicalized keys).
• Fixes bugs in ListSlice.slice and ListExtensions.slice.
• Update to package:lints 2.0.1.

• Accept Dart SDK versions above 3.0.

• Require Dart 2.18.
• Improve docs for splitAfter and splitBefore.

• Add Iterable.elementAtOrNull and List.elementAtOrNull extension methods.
• Add a top-level lastBy() function that converts an Iterable to a Map by grouping its elements using a function, keeping the last element for each computed key. Also available as an extension method on Iterable.

• Add an Iterable.slices extension method.
• Add BoolList class for space-efficient lists of boolean values.
• Use a stable sort algorithm in the IterableExtension.sortedBy method.
• Add min, max, minOrNull and maxOrNull getters to IterableDoubleExtension, IterableNumberExtension and IterableIntegerExtension
• Change UnorderedIterableEquality and SetEquality to implement Equality with a non-nullable generic to allows assignment to variables with that type. Assignment to Equality with a nullable type is still allowed because of covariance. The equals and hash methods continue to accept nullable arguments.
• Enable the avoid_dynamic_calls lint.

• Stable release for null safety.

• Fix typo in extension method expandIndexed.
• Update sdk constraints to >=2.12.0-0 <3.0.0 based on beta release guidelines.

• Allow prerelease versions of the 2.12.x sdk.

• Remove the unusable setter UnionSetController.set=. This was mistakenly added to the public API but could never be called.

• Add extra optional Random argument to shuffle.

• Add a large number of extension methods on Iterable and List types, and on a few other types. These either provide easy access to the operations from algorithms.dart, or provide convenience variants of existing Iterable and List methods like singleWhereOrNull or forEachIndexed.

• Allow 2.10 stable and 2.11.0 dev SDK versions.
• Add toUnorderedList method on PriorityQueue.
• Make HeapPriorityQueue's remove and contains methods use == for equality checks. Previously used comparison(a, b) == 0 as criteria, but it's possible to have multiple elements with the same priority in a queue, so that could remove the wrong element. Still requires that objects that are == also have the same priority.

Update for the 2.10 dev sdk.

• Allow the <=2.9.10 stable sdks.

Pre-release for the null safety migration of this package.

Note that 1.15.0 may not be the final stable null safety release version, we reserve the right to release it as a 2.0.0 breaking change.

This release will be pinned to only allow pre-release sdk versions starting from 2.9.0-dev.18.0, which is the first version where this package will appear in the null safety allow list.

• Deprecate mapMap. The Map interface has a map call and map literals can use for-loop elements which supersede this method.

• Fix CombinedMapView.keys, CombinedMapView.length, CombinedMapView.forEach, and CombinedMapView.values to work as specified and not repeat duplicate items from the maps.
  • As a result of this fix the length getter now must iterate all maps in order to remove duplicates and return an accurate length, so it is no longer O(maps).

• Set max SDK version to <3.0.0.

• Fix the parameter names in overridden methods to match the source.
• Make tests Dart 2 type-safe.
• Stop depending on SDK retype and deprecate methods.

• Fixed bugs where QueueList, MapKeySet, and MapValueSet did not adhere to the contract laid out by List.cast, Set.cast and Map.cast respectively. The returned instances of these methods now correctly forward to the existing instance instead of always creating a new copy.

• Only the Dart 2 dev SDK (>=2.0.0-dev.22.0) is now supported.
• Added support for all Dart 2 SDK methods that threw UnimplementedError.

• Make DefaultEquality's equals() and hash() methods take any Object rather than objects of type E. This makes const DefaultEquality<Null>() usable as Equality<E> for any E, which means it can be used in a const context which expects Equality<E>.

  This makes the default arguments of various other const equality constructors work in strong mode.

• Fix issue with EmptyUnmodifiableSet's stubs that were introduced in 1.14.4.

• Add implementation stubs of upcoming Dart 2.0 core library methods, namely new methods for classes that implement Iterable, List, Map, Queue, and Set.

• Fix MapKeySet.lookup to be a valid override in strong mode.

• Add type arguments to SyntheticInvocation.

• Make Equality implementations accept null as argument to hash.

• Add CombinedListView, a view of several lists concatenated together.
• Add CombinedIterableView, a view of several iterables concatenated together.
• Add CombinedMapView, a view of several maps concatenated together.

• Add EqualityBy

• Add CaseInsensitiveEquality.

• Fix bug in equalsIgnoreAsciiCase.

• Add EqualityMap and EqualitySet classes which use Equality objects for key and element equality, respectively.

• Set.difference now takes a Set<Object> as argument.

• Fix some documentation bugs.

• Add a top-level stronglyConnectedComponents() function that returns the strongly connected components in a directed graph.

• Add a top-level mapMap() function that works like Iterable.map() on a Map.

• Add a top-level mergeMaps() function that creates a new map with the combined contents of two existing maps.

• Add a top-level groupBy() function that converts an Iterable to a Map by grouping its elements using a function.

• Add top-level minBy() and maxBy() functions that return the minimum and maximum values in an Iterable, respectively, ordered by a derived value.

• Add a top-level transitiveClosure() function that returns the transitive closure of a directed graph.

• Add a const UnmodifiableSetView.empty() constructor.

• Add a UnionSet class that provides a view of the union of a set of sets.

• Add a UnionSetController class that provides a convenient way to manage the contents of a UnionSet.

• Fix another incorrectly-declared generic type.

• Fix an incorrectly-declared generic type.

• Add DelegatingIterable.typed(), DelegatingList.typed(), DelegatingSet.typed(), DelegatingMap.typed(), and DelegatingQueue.typed() static methods. These wrap untyped instances of these classes with the correct type parameter, and assert the types of values as they're accessed.

• Fix the types for binarySearch() and lowerBound() so they no longer require all arguments to be comparable.

• Add generic annotations to insertionSort() and mergeSort().

• Run dart format with the new style.
• Performance improvement for non-BMP characters.

• Add a new PriorityQueue() constructor that forwards to new HeapPriorityQueue().

• Deprecate top-level libraries other than package:collection/collection.dart, which exports these libraries' interfaces.

• Add lowerBound to binary search for values that might not be present.

• Verify that the is valid for CanonicalMap.[].

• Add string comparators that ignore ASCII case and sort numbers numerically.

• Fix type inconsistencies with Map and Set.

• Export UnmodifiableMapView from the Dart core libraries.

• Bug-fix for signatures of isValidKey arguments of CanonicalizedMap.

• Add a QueueList class that implements both Queue and List.

• Add a CanonicalizedMap class that canonicalizes its keys to provide a custom equality relation.

• Fix all analyzer hints.