refactor: IdentifierPart and Identifiers documentation.

src/cli_gen/lib/src/types/arg_identifiers.dart

@@ -1,5 +1,6 @@
-import '../utils/identifier_part.dart';
+import 'models/identifier_part.dart';
 
+/// Identifiers for the `args` package.
 class ArgsIdentifiers {
   const ArgsIdentifiers();
 

src/cli_gen/lib/src/types/macro_identifiers.dart → src/cli_gen/lib/src/types/cli_gen_identifiers.dart

@@ -1,13 +1,14 @@
-import '../utils/identifier_part.dart';
+import 'models/identifier_part.dart';
 
-class MacroArgIdentifiers {
-  const MacroArgIdentifiers();
+/// Identifiers for the `cli_annotations` package.
+class CliGenIdentifiers {
+  const CliGenIdentifiers();
 
   Uri get _uri => Uri.parse('package:cli_annotations/cli_annotations.dart');
 
   IdentifierPart get cliCommand => IdentifierPart('CliCommand', _uri);
 
-  IdentifierPart get cliSubCommand => IdentifierPart('CliSubCommand', _uri);
+  IdentifierPart get cliSubCommand => IdentifierPart('CliSubcommand', _uri);
 
   IdentifierPart get cliArgs => IdentifierPart('CliArgs', _uri);
 }

src/cli_gen/lib/src/types/dart_identifiers.dart

@@ -1,5 +1,6 @@
-import '../utils/identifier_part.dart';
+import 'models/identifier_part.dart';
 
+/// Identifiers for the `dart:core` library.
 class DartCoreIdentifiers {
   const DartCoreIdentifiers();
 

src/cli_gen/lib/src/types/identifiers.dart

@@ -1,16 +1,14 @@
 import 'arg_identifiers.dart';
+import 'cli_gen_identifiers.dart';
 import 'dart_identifiers.dart';
-import 'keyword_identifiers.dart';
-import 'macro_identifiers.dart';
 
+/// A collection of common identifiers used for code generation.
 class Identifiers {
   const Identifiers._();
 
   static const args = ArgsIdentifiers();
 
-  static const keywords = KeywordIdentifiers();
-
   static const dart = DartCoreIdentifiers();
 
-  static const macro = MacroArgIdentifiers();
+  static const cliGen = CliGenIdentifiers();
 }

src/cli_gen/lib/src/utils/identifier_part.dart → src/cli_gen/lib/src/types/models/identifier_part.dart

@@ -1,5 +1,10 @@
 import 'package:code_builder/code_builder.dart';
 
+/// A utility class that represents a part of code.
+///
+/// Each instance/part can be either a String or an Identifier. This utility
+/// class was created to make it easier to share code geneation logic between
+/// `macros` and `builders`.
 sealed class EmitterPart {
   const EmitterPart();
 

src/cli_gen/lib/src/types/models/macro_identifier_part.dart

@@ -0,0 +1,38 @@
+// // ignore: implementation_imports, depend_on_referenced_packages
+// import 'package:_fe_analyzer_shared/src/macros/api.dart';
+
+// import 'identifier_part.dart';
+
+// /// A reference to a Macro identifier.
+// class MacroIdentifierPart extends IdentifierPart {
+//   MacroIdentifierPart(
+//     this.identifier,
+//     Uri uri,
+//   ) : super(identifier.name, uri);
+
+//   final Identifier identifier;
+
+//   @override
+//   String get name => identifier.name;
+
+//   @override
+//   String toCodeString() => name;
+
+//   @override
+//   String toString() {
+//     return 'MacroIdentifier{name: $name, uri: $uri}';
+//   }
+
+//   @override
+//   int get hashCode => name.hashCode ^ uri.hashCode ^ identifier.hashCode;
+
+//   @override
+//   bool operator ==(Object other) {
+//     if (identical(this, other)) return true;
+
+//     return other is MacroIdentifierPart &&
+//         other.name == name &&
+//         other.uri == uri &&
+//         other.identifier == identifier;
+//   }
+// }

src/cli_gen/lib/src/types/types.dart

@@ -0,0 +1,4 @@
+export 'arg_identifiers.dart';
+export 'cli_gen_identifiers.dart';
+export 'dart_identifiers.dart';
+export 'identifiers.dart';