Add DartDoc categories to various classes

Author: nex3

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 1.14.1
+
+### Dart API
+
+* Add DartDoc categories to various classes to help organize the documentation.
+
 ## 1.14.0
 
 ### BREAKING CHANGE

lib/src/importer.dart

@@ -24,6 +24,8 @@ export 'importer/result.dart';
 /// [AsyncImporter] if possible.
 ///
 /// Subclasses should extend [Importer], not implement it.
+///
+/// {@category Importers}
 abstract class Importer extends AsyncImporter {
   /// An importer that never imports any stylesheets.
   ///

lib/src/importer/async.dart

@@ -19,6 +19,8 @@ import 'result.dart';
 /// instead.
 ///
 /// Subclasses should extend [AsyncImporter], not implement it.
+///
+/// {@category Importers}
 abstract class AsyncImporter {
   /// If [url] is recognized by this importer, returns its canonical format.
   ///

lib/src/importer/filesystem.dart

@@ -11,6 +11,8 @@ import 'result.dart';
 import 'utils.dart';
 
 /// An importer that loads files from a load path on the filesystem.
+///
+/// {@category Importers}
 class FilesystemImporter extends Importer {
   /// The path relative to which this importer looks for files.
   final String _loadPath;

lib/src/importer/package.dart

@@ -14,6 +14,8 @@ import 'result.dart';
 final _filesystemImporter = new FilesystemImporter('.');
 
 /// An importer that loads stylesheets from `package:` imports.
+///
+/// {@category Importers}
 class PackageImporter extends Importer {
   /// The resolver that converts `package:` imports to `file:`.
   final SyncPackageResolver _packageResolver;

lib/src/importer/result.dart

@@ -8,6 +8,8 @@ import '../importer.dart';
 import '../syntax.dart';
 
 /// The result of importing a Sass stylesheet, as returned by [Importer.load].
+///
+/// {@category Importers}
 class ImporterResult {
   /// The contents of the stylesheet.
   final String contents;

lib/src/value/external/argument_list.dart

@@ -11,6 +11,8 @@ import 'value.dart';
 /// An argument list comes from a rest argument. It's distinct from a normal
 /// [SassList] in that it may contain a keyword map as well as the positional
 /// arguments.
+///
+/// {@category Values}
 abstract class SassArgumentList extends SassList {
   /// The keyword arguments attached to this argument list.
   ///

lib/src/value/external/boolean.dart

@@ -6,12 +6,18 @@ import '../../value.dart' as internal;
 import 'value.dart';
 
 /// The SassScript `true` value.
+///
+/// {@category Values}
 SassBoolean get sassTrue => internal.sassTrue;
 
 /// The SassScript `false` value.
+///
+/// {@category Values}
 SassBoolean get sassFalse => internal.sassFalse;
 
 /// A SassScript boolean value.
+///
+/// {@category Values}
 abstract class SassBoolean extends Value {
   /// Whether this value is `true` or `false`.
   bool get value;

lib/src/value/external/color.dart

@@ -6,6 +6,8 @@ import '../../value.dart' as internal;
 import 'value.dart';
 
 /// A SassScript color.
+///
+/// {@category Values}
 abstract class SassColor extends Value {
   /// This color's red channel, between `0` and `255`.
   int get red;

lib/src/value/external/function.dart

@@ -10,6 +10,8 @@ import 'value.dart';
 ///
 /// A function reference captures a function from the local environment so that
 /// it may be passed between modules.
+///
+/// {@category Values}
 abstract class SassFunction extends Value {
   /// The callable that this function invokes.
   ///

lib/src/value/external/list.dart

@@ -7,6 +7,8 @@ import '../../value.dart' show ListSeparator;
 import 'value.dart';
 
 /// A SassScript list.
+///
+/// {@category Values}
 abstract class SassList extends Value {
   ListSeparator get separator;
 

lib/src/value/external/map.dart

@@ -6,6 +6,8 @@ import '../../value.dart' as internal;
 import 'value.dart';
 
 /// A SassScript map.
+///
+/// {@category Values}
 abstract class SassMap extends Value {
   // TODO(nweiz): Use persistent data structures rather than copying here. We
   // need to preserve the order, which can be done by tracking an RRB vector of

lib/src/value/external/number.dart

@@ -11,6 +11,8 @@ import 'value.dart';
 /// support scientific-style numerator and denominator units (for example,
 /// `miles/hour`). These are expected to be resolved before being emitted to
 /// CSS.
+///
+/// {@category Values}
 abstract class SassNumber extends Value {
   /// The number of distinct digits that are emitted when converting a number to
   /// CSS.

lib/src/value/external/string.dart

@@ -9,6 +9,8 @@ import 'value.dart';
 ///
 /// Strings can either be quoted or unquoted. Unquoted strings are usually CSS
 /// identifiers, but they may contain any text.
+///
+/// {@category Values}
 abstract class SassString extends Value {
   /// The contents of the string.
   ///

lib/src/value/external/value.dart

@@ -21,6 +21,8 @@ export 'number.dart';
 export 'string.dart';
 
 /// The SassScript `null` value.
+///
+/// {@category Values}
 Value get sassNull => internal.sassNull;
 
 // TODO(nweiz): Just mark members as @internal when sdk#28066 is fixed.
@@ -35,6 +37,8 @@ Value get sassNull => internal.sassNull;
 /// subclass constructors like [new SassString]. Untyped values can be cast to
 /// particular types using `assert*()` functions like [assertString], which
 /// throw user-friendly error messages if they fail.
+///
+/// {@category Values}
 abstract class Value {
   /// Whether the value counts as `true` in an `@if` statement and other
   /// contexts.

lib/src/value/list.dart

@@ -55,6 +55,8 @@ class SassList extends Value implements ext.SassList {
 }
 
 /// An enum of list separator types.
+///
+/// {@category Values}
 class ListSeparator {
   /// A space-separated list.
   static const space = const ListSeparator._("space", " ");

pubspec.yaml

@@ -1,5 +1,5 @@
 name: sass
-version: 1.14.0
+version: 1.14.1
 description: A Sass implementation in Dart.
 author: Dart Team <[email protected]>
 homepage: https://github.com/sass/dart-sass