Migrate dartdoc_options.dart (#2749)

* Switch to using CompilationUnitElement.classes (#2743)

* Prepare dartdoc_options for migration (#2745)

* more specific imports in options

* do not allow autoinitialization

* dartfmt

* parameterize the valueWithContext type

* Use alternative constructors instead of externalizing, didn't realize the autodetect was so widely used

* more subclasses

* flatten

* Disable the unstable template checks and prepare for 2.14 stable. (#2752)

* Disable one of the template checks?  and add beta branch for testing

* beta is the new stable

* empty commit - force check reset

* Add a blurb to the README about requiring analysis (#2753)

* Allow comment references on generic typedefs (#2756)

Co-authored-by: Janice Collins <[email protected]>

* Prepare for dartdoc 2.0.0 (#2754)

* Prepare for dartdoc 2.0.0

* Update changelog for additional bugfix

* review comments

Co-authored-by: Simon Binder <[email protected]>

Author: jcollins-g

lib/options.dart

@@ -10,8 +10,8 @@ import 'package:dartdoc/src/package_meta.dart';
 
 /// Helper class that consolidates option contexts for instantiating generators.
 class DartdocGeneratorOptionContext extends DartdocOptionContext {
-  DartdocGeneratorOptionContext(DartdocOptionSet optionSet, Folder? dir,
-      ResourceProvider resourceProvider)
+  DartdocGeneratorOptionContext(
+      DartdocOptionSet optionSet, Folder dir, ResourceProvider resourceProvider)
       : super(optionSet, dir, resourceProvider);
   DartdocGeneratorOptionContext.fromDefaultContextLocation(
       DartdocOptionSet optionSet, ResourceProvider resourceProvider)
@@ -51,8 +51,8 @@ class DartdocGeneratorOptionContext extends DartdocOptionContext {
 
 class DartdocProgramOptionContext extends DartdocGeneratorOptionContext
     with LoggingContext {
-  DartdocProgramOptionContext(DartdocOptionSet optionSet, Folder? dir,
-      ResourceProvider resourceProvider)
+  DartdocProgramOptionContext(
+      DartdocOptionSet optionSet, Folder dir, ResourceProvider resourceProvider)
       : super(optionSet, dir, resourceProvider);
   DartdocProgramOptionContext.fromDefaultContextLocation(
       DartdocOptionSet optionSet, ResourceProvider resourceProvider)
@@ -84,7 +84,7 @@ Future<DartdocProgramOptionContext?> parseOptions(
   List<String> arguments, {
   OptionGenerator? additionalOptions,
 }) async {
-  var optionSet = await DartdocOptionSet.fromOptionGenerators(
+  var optionRoot = await DartdocOptionRoot.fromOptionGenerators(
       'dartdoc',
       [
         createDartdocOptions,
@@ -96,35 +96,35 @@ Future<DartdocProgramOptionContext?> parseOptions(
       packageMetaProvider);
 
   try {
-    optionSet.parseArguments(arguments);
+    optionRoot.parseArguments(arguments);
   } on FormatException catch (e) {
     stderr.writeln(' fatal error: ${e.message}');
     stderr.writeln('');
-    _printUsage(optionSet.argParser);
+    _printUsage(optionRoot.argParser);
     // Do not use exit() as this bypasses --pause-isolates-on-exit
     exitCode = 64;
     return null;
   }
-  if (optionSet['help'].valueAtCurrent()) {
-    _printHelp(optionSet.argParser);
+  if (optionRoot['help'].valueAtCurrent()) {
+    _printHelp(optionRoot.argParser);
     exitCode = 0;
     return null;
   }
-  if (optionSet['version'].valueAtCurrent()) {
-    _printVersion(optionSet.argParser);
+  if (optionRoot['version'].valueAtCurrent()) {
+    _printVersion(optionRoot.argParser);
     exitCode = 0;
     return null;
   }
 
   DartdocProgramOptionContext config;
   try {
     config = DartdocProgramOptionContext.fromDefaultContextLocation(
-        optionSet, packageMetaProvider.resourceProvider);
+        optionRoot, packageMetaProvider.resourceProvider);
   } on DartdocOptionError catch (e) {
     stderr.writeln(' fatal error: ${e.message}');
     stderr.writeln('');
     await stderr.flush();
-    _printUsage(optionSet.argParser);
+    _printUsage(optionRoot.argParser);
     exitCode = 64;
     return null;
   }