Dart 3.4 requirement, fix lint rules and cleanup comments.

analysis_options.yaml

@@ -17,6 +17,7 @@ linter:
     - comment_references
     - directives_ordering
     - invalid_case_patterns
+    - missing_code_block_language_in_doc_comment
     - no_self_assignments
     - no_wildcard_variable_uses
     - omit_local_variable_types
@@ -33,6 +34,7 @@ linter:
     - unnecessary_await_in_return
     - unnecessary_breaks
     - unnecessary_lambdas
+    - unnecessary_library_name
     - unnecessary_null_aware_operator_on_extension_on_nullable
     - unnecessary_null_checks
     - unnecessary_parenthesis

bin/generate_tuple.dart

@@ -47,7 +47,7 @@ Future<void> generateExport() async {
   generateWarning(out);
 
   out.writeln('/// Tuple extension methods on generic records.');
-  out.writeln('library tuple;');
+  out.writeln('library;');
   out.writeln();
   out.writeln('export \'src/tuple/tuple.dart\';');
   for (var i = 0; i < max; i++) {

bin/generate_types.dart

@@ -14,7 +14,7 @@ Future<void> generateCallback() async {
   generateWarning(out);
 
   out.writeln('/// Function types for generic callbacks.');
-  out.writeln('library callback;');
+  out.writeln('library;');
   out.writeln();
 
   for (var i = 0; i < max; i++) {
@@ -35,7 +35,7 @@ Future<void> generateMapping() async {
   generateWarning(out);
 
   out.writeln('/// Function type for generic mapping functions.');
-  out.writeln('library mapping;');
+  out.writeln('library;');
   out.writeln();
 
   for (var i = 0; i < max; i++) {
@@ -56,7 +56,7 @@ Future<void> generatePredicate() async {
   generateWarning(out);
 
   out.writeln('/// Function type for generic predicate functions.');
-  out.writeln('library predicate;');
+  out.writeln('library;');
   out.writeln();
 
   for (var i = 0; i < max; i++) {
@@ -77,7 +77,7 @@ Future<void> generateEmpty() async {
   generateWarning(out);
 
   out.writeln('/// Generic empty functions returning nothing.');
-  out.writeln('library empty;');
+  out.writeln('library;');
   out.writeln();
 
   for (var i = 0; i < max; i++) {
@@ -98,7 +98,7 @@ Future<void> generateIdentity() async {
   generateWarning(out);
 
   out.writeln('/// Generic identity functions.');
-  out.writeln('library identity;');
+  out.writeln('library;');
   out.writeln();
 
   out.writeln('/// Generic identity function with 1 positional argument.');
@@ -115,7 +115,7 @@ Future<void> generateConstant() async {
   generateWarning(out);
 
   out.writeln('/// The constant functions.');
-  out.writeln('library constant;');
+  out.writeln('library;');
   out.writeln();
 
   out.writeln("import 'mapping.dart';");
@@ -141,7 +141,7 @@ Future<void> generateThrowing() async {
   generateWarning(out);
 
   out.writeln('/// The throwing functions.');
-  out.writeln('library throwing;');
+  out.writeln('library;');
   out.writeln();
 
   out.writeln("import 'mapping.dart';");
@@ -169,7 +169,7 @@ Future<void> generatePartial() async {
 
   out.writeln('/// Binds positional arguments and returns a new function:');
   out.writeln('/// https://en.wikipedia.org/wiki/Partial_application');
-  out.writeln('library partial;');
+  out.writeln('library;');
   out.writeln();
 
   out.writeln("import 'mapping.dart';");
@@ -211,7 +211,7 @@ Future<void> generateCurry() async {
       'sequence of functions ');
   out.writeln('/// taking a single argument: '
       'https://en.wikipedia.org/wiki/Currying');
-  out.writeln('library curry;');
+  out.writeln('library;');
   out.writeln();
 
   out.writeln("import 'mapping.dart';");

lib/async.dart

@@ -1,5 +1,5 @@
 /// Helpers to make async code better.
-library async;
+library;
 
 export 'src/async/buffer.dart' show BufferExtension;
 export 'src/async/flat_map.dart' show FlatMapStreamExtension;

lib/cache.dart

@@ -1,5 +1,5 @@
 /// Collection of different caching strategies and their expiry policy.
-library cache;
+library;
 
 export 'src/cache/cache.dart';
 export 'src/cache/delegate.dart';

lib/char_matcher.dart

@@ -1,6 +1,6 @@
 /// A first-class model of character classes, their composition and operations
 /// on strings.
-library char_matcher;
+library;
 
 export 'src/char_matcher/char_matcher.dart';
 export 'src/char_matcher/unicode/unicode.dart';

lib/collection.dart

@@ -1,6 +1,6 @@
 /// A collection of iterable extensions and new collection types: bi-map,
 /// bit-list, multi-set, set and list multi-map, range, and string.
-library collection;
+library;
 
 export 'src/collection/bimap.dart'
     show BiMap, BiMapOnIterableExtension, BiMapOnMapExtension;

lib/comparator.dart

@@ -1,6 +1,6 @@
 /// Provides default [Comparator] constructors, and various static extension
 /// methods to modify and perform common operations on [Comparator] functions.
-library comparator;
+library;
 
 export 'src/comparator/compare_operators.dart';
 export 'src/comparator/constructors/explicit.dart';

lib/diff.dart

@@ -1,6 +1,6 @@
 /// Port of Python's difflib library to Dart providing tools for comparing
 /// lists.
-library diff;
+library;
 
 export 'src/diff/close_matches.dart';
 export 'src/diff/differ.dart';

lib/feature.dart

@@ -1,5 +1,5 @@
 /// Information about the runtime environment.
-library feature;
+library;
 
 import 'dart:math';
 

lib/functional.dart

@@ -1,5 +1,5 @@
 /// A collection of functional programming structures.
-library functional;
+library;
 
 export 'src/functional/either.dart' show Either;
 export 'src/functional/optional.dart' show Optional;

lib/graph.dart

@@ -1,5 +1,5 @@
 /// Graph-theory objects and algorithms.
-library graph;
+library;
 
 export 'src/graph/algorithms.dart' show AlgorithmsGraphExtension;
 export 'src/graph/algorithms/a_star_search.dart' show AStarSearchIterable;

lib/interval.dart

@@ -1,5 +1,5 @@
 /// Provides a continuous interval.
-library interval;
+library;
 
 export 'src/interval/interval.dart' show Interval;
 export 'src/interval/tree.dart' show IntervalTree;

lib/math.dart

@@ -1,5 +1,5 @@
 /// A collection of common mathematical functions.
-library math;
+library;
 
 export 'src/math/binomial.dart'
     show BinomialBigIntExtension, BinomialIntegerExtension;

lib/more.dart

@@ -1,5 +1,5 @@
 /// More Dart — Literally.
-library more;
+library;
 
 export 'package:more/async.dart';
 export 'package:more/cache.dart';

lib/number.dart

@@ -1,5 +1,5 @@
 /// Support for fractional and complex arithmetic.
-library number;
+library;
 
 export 'src/number/bigint.dart' show BigIntExtension;
 export 'src/number/complex.dart' show Complex;

lib/printer.dart

@@ -1,6 +1,6 @@
 /// Provides a first-class model to convert object to strings using composition
 /// and highly configurable formatting primitives.
-library printer;
+library;
 
 export 'src/printer/builder.dart' show BuilderPrinterExtension;
 export 'src/printer/empty.dart' show EmptyPrinterExtension;

lib/src/char_matcher/char_matcher.dart

@@ -28,16 +28,19 @@ import 'unicode/unicode.dart';
 /// inclusion of a character can be determined by calling the char matcher with
 /// the code-unit as the function argument, for example:
 ///
-///     CharMatcher.whitespace().match(' '.runes.first); // true
-///     CharMatcher.digit().match('a'.runes.first); // false
+/// ```dart
+/// CharMatcher.whitespace().match(' '.runes.first); // true
+/// CharMatcher.digit().match('a'.runes.first); // false
+/// ```
 ///
 /// A large collection of helper methods let you perform string operations on
 /// the occurrences of the specified class of characters: trimming, collapsing,
 /// replacing, removing, retaining, etc. For example:
 ///
-///     String withoutWhitespace = CharMatcher.whitespace().removeFrom(string);
-///     String onlyDigits = CharMatcher.digit().retainFrom(string);
-///
+/// ```dart
+/// String withoutWhitespace = CharMatcher.whitespace().removeFrom(string);
+/// String onlyDigits = CharMatcher.digit().retainFrom(string);
+/// ```
 @immutable
 abstract class CharMatcher with ToStringPrinter implements Pattern {
   /// A matcher that accepts any character.

lib/src/char_matcher/unicode/category.dart

@@ -100,11 +100,11 @@ const data = [
   32, -4, 1, -2, 256, 64, -2, 256, -3, 1, -3, 256, 1, -3, 256, 64, -2, 1, 32,
   -6, 1, 256, -14, 1, -10, 512, -3, 2048, -6, 134217728, 33554432, 134217728,
   -5, 1, 64, -3, 256, 64, -8, 32, 1, -3, 32, 1, -23, 32, 1, -16, 32, -2, 1, 64,
-  32, -3, 64, -4, 256, 1, -3, 64, 1, -4, 64, -7, 1, -2, 64, 1, -3, 32, 1, -2,
+  32, -3, 64, -4, 256, 1, -3, 64, 1, -4, 64, -7, 1, -2, 64, 1, -3, 32, -2, 1,
   32, -2, 1, -2, 32, -2, 64, -2, 1, -10, 512, -7, 1, 8388608, -7, 2048,
   134217728, 32, 64, -2, 256, 8388608, -8, 32, 1, -3, 32, 1, -23, 32, 1, -10,
   32, 1, -5, 32, -2, 1, 64, 32, 256, 64, -5, 256, 1, 64, -2, 256, 1, -2, 256,
-  -2, 64, -7, 1, -2, 256, -5, 1, -3, 32, 1, -2, 32, -2, 64, -2, 1, -10, 512, 1,
+  -2, 64, -7, 1, -2, 256, -6, 1, -2, 32, 1, -2, 32, -2, 64, -2, 1, -10, 512, 1,
   -2, 32, 256, -12, 1, -2, 64, -2, 256, -9, 32, 1, -3, 32, 1, -41, 32, -2, 64,
   32, -3, 256, -4, 64, 1, -3, 256, 1, -3, 256, 64, 32, 134217728, -4, 1, -3, 32,
   256, -7, 2048, -3, 32, -2, 64, -2, 1, -10, 512, -9, 2048, 134217728, -6, 32,