improve naming

Author: felangel

bricks/dart_frog_prod_server/hooks/lib/src/disable_workspace_resolution.dart

@@ -1,7 +1,7 @@
 import 'dart:io';
 import 'package:dart_frog_prod_server_hooks/dart_frog_prod_server_hooks.dart';
 import 'package:mason/mason.dart';
-import 'package:package_config/package_config.dart' as package_config;
+import 'package:package_config/package_config.dart';
 import 'package:path/path.dart' as path;
 import 'package:yaml/yaml.dart';
 import 'package:yaml_edit/yaml_edit.dart';
@@ -10,7 +10,7 @@ import 'package:yaml_edit/yaml_edit.dart';
 /// https://github.com/dart-lang/pub/issues/4594
 VoidCallback disableWorkspaceResolution(
   HookContext context, {
-  required package_config.PackageConfig packageConfig,
+  required PackageConfig packageConfig,
   required PackageGraph packageGraph,
   required String projectDirectory,
   required String workspaceRoot,
@@ -73,7 +73,7 @@ VoidCallback overrideResolutionInPubspecOverrides(String projectDirectory) {
 /// Add overrides for all path dependencies to `pubspec_overrides.yaml`
 void overridePathDependenciesInPubspecOverrides({
   required String projectDirectory,
-  required package_config.PackageConfig packageConfig,
+  required PackageConfig packageConfig,
   required PackageGraph packageGraph,
 }) {
   final name = getPackageName(projectDirectory: projectDirectory);
@@ -98,7 +98,7 @@ void overridePathDependenciesInPubspecOverrides({
 
 void writePathDependencyOverrides({
   required String projectDirectory,
-  required Iterable<package_config.Package> pathDependencies,
+  required Iterable<Package> pathDependencies,
 }) {
   final pubspecOverridesFile = File(
     path.join(projectDirectory, 'pubspec_overrides.yaml'),

bricks/dart_frog_prod_server/hooks/lib/src/package_graph/package_graph.dart

@@ -6,14 +6,19 @@ import 'package:path/path.dart' as path;
 
 part 'package_graph.g.dart';
 
+/// {@template package_graph}
+/// A Dart object containing the deserialized contents of the package_graph.json
+/// {@endtemplate}
 @JsonSerializable()
 class PackageGraph {
+  /// {@macro package_graph}
   const PackageGraph({
     required this.roots,
     required this.packages,
     required this.configVersion,
   });
 
+  /// Load a [PackageGraph] from the provided [project] root.
   factory PackageGraph.load(String project) {
     final file = File(path.join(project, '.dart_tool', 'package_graph.json'));
     if (!file.existsSync()) throw Exception('${file.path} not found');
@@ -22,32 +27,48 @@ class PackageGraph {
     );
   }
 
+  /// Create a [PackageGraph] from a [Map].
   factory PackageGraph.fromJson(Map<String, dynamic> json) =>
       _$PackageGraphFromJson(json);
 
+  /// The root nodes of the package graph.
   final List<String> roots;
-  final List<Package> packages;
+
+  /// A list of packages for the given package graph.
+  final List<PackageGraphPackage> packages;
+
+  /// The config version of the package graph.
   final int configVersion;
 }
 
+/// {@template package_graph_package}
+/// An individual package in a package graph.
+/// {@endtemplate}
 @JsonSerializable()
-class Package {
-  const Package({
+class PackageGraphPackage {
+  /// {@macro package_graph_package}
+  const PackageGraphPackage({
     required this.name,
     required this.version,
     required this.dependencies,
     required this.devDependencies,
   });
 
-  factory Package.fromJson(Map<String, dynamic> json) =>
-      _$PackageFromJson(json);
+  /// Create a [PackageGraphPackage] from a [Map].
+  factory PackageGraphPackage.fromJson(Map<String, dynamic> json) =>
+      _$PackageGraphPackageFromJson(json);
 
+  /// The name of the package.
   final String name;
+
+  /// The version of the package.
   final String version;
 
+  /// The list of package names that this package depends on in production.
   @JsonKey(defaultValue: <String>[])
   final List<String> dependencies;
 
+  /// The list of package names that this package depends on in development.
   @JsonKey(defaultValue: <String>[])
   final List<String> devDependencies;
 }

bricks/dart_frog_prod_server/hooks/lib/src/package_graph/package_graph.g.dart

@@ -44,7 +44,7 @@ void main() {
       when(() => packageGraph.roots).thenReturn([packageName]);
       when(() => packageGraph.packages).thenReturn(
         [
-          const Package(
+          const PackageGraphPackage(
             name: packageName,
             dependencies: [],
             devDependencies: [],