Unify <Foo> and <Foo>Impl classes that are effectively enums or simpl…

…e data classes

The API of `package:native_assets_cli` uses currently a
one-size-fits-all approach:

* almost every API class is duplicated between a `<Foo>` and `<Foo>Impl`
* `package:native_assets_cli/native_assets_cli.dart` exposes `<Foo>`
* `package:native_assets_cli/native_assets_cli_internal.dart` exposes `<Foo>Impl`

This has a number of issues

* The `_internal.dart` is actually a public API: It's used e.g. by
  flutter tools and breaking changes to it need major version bumps.

* A user of the `<Foo>` API doesn't know that such objects are for
  example
    * hashable (e.g. go-to-definition to `<Foo>` there's no
      indication of that), e.g. `DynamicLoadingSystem` makes no mention
      of it, no `get hashCode` override, ... only in
      `DynamicLoadingSystemImpl` there is.
    * have a `toString()` that code can rely on the returned string not
      changing
    * ...

* It causes code to have to choose between e.g. `OS` and `OSImpl` -
  which is very confusing as it's just one concept.

* It causes code to have to downcast e.g. `os as OSImpl`.
  => This is a very bad smell, as generally it's an unsafe operation to
  downcast.

* It's code duplication across the api/ and model/ folders, make it
  harder to navigate in codebase (as one may have to constantly switch
  between the files), ...

One original intention for this seperation may have been to hide all traces
of the json protocol in the non-internal version, but I think this is not
needed at all, because the protocol itself will be *more* stable than the APIs
offered by the package itself (much easier to break the dart API and publish and
new version of the package than to break the CLI protocol).

=> So this PR starts to merge some `<Foo>` and `<Foo>Impl` classes into
one `<Foo>`.
=> This simplifies the code, removes `as ...Impl` downcasts, etc

One extra thing this CL does is remove some members from e.g. `OS`. This
is part of disentangling the concepts. The build protocol may always
expose the target operating system, but it may only expose the target
ABI if the building code supports code assets.

=> So one should be able to use `OS` without `OS.dylibFileName` /
`OS.architectures` / ...

=> We may even decide to move code asset related code into it's own
package, making the core build protocol package not need the concept of
`Architecture` at all.

pkgs/native_assets_builder/CHANGELOG.md

@@ -9,6 +9,7 @@
   Dart CI test runner to the `package:native_assets_builder` for testing the
   dart-lang/native repository to make it clear those are not intended to be used
   by end-users.
+- Use unified classes instead of two `{OS,...}` and `{OS,,...}Impl`
 
 ## 0.8.3
 

pkgs/native_assets_builder/lib/src/build_runner/build_runner.dart

@@ -55,12 +55,12 @@ class NativeAssetsBuildRunner {
   /// [api.BuildConfig] and [api.LinkConfig]! For more info see:
   /// https://github.com/dart-lang/native/issues/1319
   Future<BuildResult> build({
-    required LinkModePreferenceImpl linkModePreference,
+    required LinkModePreference linkModePreference,
     required Target target,
     required Uri workingDirectory,
-    required BuildModeImpl buildMode,
+    required BuildMode buildMode,
     CCompilerConfigImpl? cCompilerConfig,
-    IOSSdkImpl? targetIOSSdk,
+    IOSSdk? targetIOSSdk,
     int? targetIOSVersion,
     int? targetMacOSVersion,
     int? targetAndroidNdkApi,
@@ -100,12 +100,12 @@ class NativeAssetsBuildRunner {
   /// [api.BuildConfig] and [api.LinkConfig]! For more info see:
   /// https://github.com/dart-lang/native/issues/1319
   Future<LinkResult> link({
-    required LinkModePreferenceImpl linkModePreference,
+    required LinkModePreference linkModePreference,
     required Target target,
     required Uri workingDirectory,
-    required BuildModeImpl buildMode,
+    required BuildMode buildMode,
     CCompilerConfigImpl? cCompilerConfig,
-    IOSSdkImpl? targetIOSSdk,
+    IOSSdk? targetIOSSdk,
     int? targetIOSVersion,
     int? targetMacOSVersion,
     int? targetAndroidNdkApi,
@@ -138,12 +138,12 @@ class NativeAssetsBuildRunner {
   /// The common method for running building or linking of assets.
   Future<HookResult> _run({
     required Hook hook,
-    required LinkModePreferenceImpl linkModePreference,
+    required LinkModePreference linkModePreference,
     required Target target,
     required Uri workingDirectory,
-    required BuildModeImpl buildMode,
+    required BuildMode buildMode,
     CCompilerConfigImpl? cCompilerConfig,
-    IOSSdkImpl? targetIOSSdk,
+    IOSSdk? targetIOSSdk,
     int? targetIOSVersion,
     int? targetMacOSVersion,
     int? targetAndroidNdkApi,
@@ -269,12 +269,12 @@ class NativeAssetsBuildRunner {
     Package package,
     PackageLayout packageLayout,
     Target target,
-    BuildModeImpl buildMode,
-    LinkModePreferenceImpl linkModePreference,
+    BuildMode buildMode,
+    LinkModePreference linkModePreference,
     DependencyMetadata? dependencyMetadata,
     bool? linkingEnabled,
     CCompilerConfigImpl? cCompilerConfig,
-    IOSSdkImpl? targetIOSSdk,
+    IOSSdk? targetIOSSdk,
     int? targetAndroidNdkApi,
     int? targetIOSVersion,
     int? targetMacOSVersion,
@@ -371,8 +371,8 @@ class NativeAssetsBuildRunner {
   /// If provided, only native assets of all transitive dependencies of
   /// [runPackageName] are built.
   Future<BuildDryRunResult> buildDryRun({
-    required LinkModePreferenceImpl linkModePreference,
-    required OSImpl targetOS,
+    required LinkModePreference linkModePreference,
+    required OS targetOS,
     required Uri workingDirectory,
     required bool includeParentEnvironment,
     required bool linkingEnabled,
@@ -400,8 +400,8 @@ class NativeAssetsBuildRunner {
   /// If provided, only native assets of all transitive dependencies of
   /// [runPackageName] are built.
   Future<LinkDryRunResult> linkDryRun({
-    required LinkModePreferenceImpl linkModePreference,
-    required OSImpl targetOS,
+    required LinkModePreference linkModePreference,
+    required OS targetOS,
     required Uri workingDirectory,
     required bool includeParentEnvironment,
     PackageLayout? packageLayout,
@@ -423,8 +423,8 @@ class NativeAssetsBuildRunner {
       );
 
   Future<HookResult> _runDryRun({
-    required LinkModePreferenceImpl linkModePreference,
-    required OSImpl targetOS,
+    required LinkModePreference linkModePreference,
+    required OS targetOS,
     required Uri workingDirectory,
     required bool includeParentEnvironment,
     PackageLayout? packageLayout,
@@ -817,8 +817,8 @@ ${compileResult.stdout}
     required Package package,
     required String packageName,
     required Uri packageRoot,
-    required OSImpl targetOS,
-    required LinkModePreferenceImpl linkMode,
+    required OS targetOS,
+    required LinkModePreference linkMode,
     required Uri buildParentDir,
     required Hook hook,
     BuildDryRunResult? buildDryRunResult,

pkgs/native_assets_builder/test/build_runner/build_runner_reusability_test.dart

@@ -30,29 +30,29 @@ void main() async {
 
       await buildRunner.buildDryRun(
         targetOS: Target.current.os,
-        linkModePreference: LinkModePreferenceImpl.dynamic,
+        linkModePreference: LinkModePreference.dynamic,
         workingDirectory: packageUri,
         includeParentEnvironment: true,
         linkingEnabled: false,
       );
       await buildRunner.buildDryRun(
         targetOS: Target.current.os,
-        linkModePreference: LinkModePreferenceImpl.dynamic,
+        linkModePreference: LinkModePreference.dynamic,
         workingDirectory: packageUri,
         includeParentEnvironment: true,
         linkingEnabled: false,
       );
       await buildRunner.build(
-        buildMode: BuildModeImpl.release,
-        linkModePreference: LinkModePreferenceImpl.dynamic,
+        buildMode: BuildMode.release,
+        linkModePreference: LinkModePreference.dynamic,
         target: Target.current,
         workingDirectory: packageUri,
         includeParentEnvironment: true,
         linkingEnabled: false,
       );
       await buildRunner.build(
-        buildMode: BuildModeImpl.release,
-        linkModePreference: LinkModePreferenceImpl.dynamic,
+        buildMode: BuildMode.release,
+        linkModePreference: LinkModePreference.dynamic,
         target: Target.current,
         workingDirectory: packageUri,
         includeParentEnvironment: true,

pkgs/native_assets_builder/test/build_runner/concurrency_shared_test_helper.dart

@@ -4,7 +4,6 @@
 
 import 'package:logging/logging.dart';
 import 'package:native_assets_builder/native_assets_builder.dart';
-import 'package:native_assets_cli/native_assets_cli.dart';
 import 'package:native_assets_cli/native_assets_cli_internal.dart';
 
 import '../helpers.dart';
@@ -22,8 +21,8 @@ void main(List<String> args) async {
     logger: logger,
     dartExecutable: dartExecutable,
   ).build(
-    buildMode: BuildModeImpl.release,
-    linkModePreference: LinkModePreferenceImpl.dynamic,
+    buildMode: BuildMode.release,
+    linkModePreference: LinkModePreference.dynamic,
     target: target,
     workingDirectory: packageUri,
     includeParentEnvironment: true,

pkgs/native_assets_builder/test/build_runner/concurrency_test_helper.dart

@@ -25,8 +25,8 @@ void main(List<String> args) async {
     dartExecutable: dartExecutable,
     singleHookTimeout: timeout,
   ).build(
-    buildMode: BuildModeImpl.release,
-    linkModePreference: LinkModePreferenceImpl.dynamic,
+    buildMode: BuildMode.release,
+    linkModePreference: LinkModePreference.dynamic,
     target: Target.current,
     workingDirectory: packageUri,
     includeParentEnvironment: true,

pkgs/native_assets_builder/test/build_runner/fail_on_os_sdk_version_test.dart

@@ -5,7 +5,7 @@
 import 'package:logging/logging.dart';
 import 'package:native_assets_cli/native_assets_cli.dart' show OS;
 import 'package:native_assets_cli/native_assets_cli_internal.dart'
-    show IOSSdkImpl, Target;
+    show IOSSdk, Target;
 import 'package:test/test.dart';
 
 import '../helpers.dart';
@@ -70,7 +70,7 @@ void main() async {
               final (buildResult, linkResult) = await buildAndLink(
                 target: target,
                 targetIOSSdk:
-                    (target.os == OS.iOS) ? IOSSdkImpl.iPhoneOS : null,
+                    (target.os == OS.iOS) ? IOSSdk.iPhoneOS : null,
                 targetIOSVersion: (target.os == OS.iOS) ? version : null,
                 targetMacOSVersion: (target.os == OS.macOS) ? version : null,
                 targetAndroidNdkApi: (target.os == OS.android) ? version : null,

pkgs/native_assets_builder/test/build_runner/helpers.dart

@@ -35,13 +35,13 @@ Future<BuildResult> build(
   Uri packageUri,
   Logger logger,
   Uri dartExecutable, {
-  LinkModePreferenceImpl linkModePreference = LinkModePreferenceImpl.dynamic,
+  LinkModePreference linkModePreference = LinkModePreference.dynamic,
   CCompilerConfigImpl? cCompilerConfig,
   bool includeParentEnvironment = true,
   List<String>? capturedLogs,
   PackageLayout? packageLayout,
   String? runPackageName,
-  IOSSdkImpl? targetIOSSdk,
+  IOSSdk? targetIOSSdk,
   int? targetIOSVersion,
   int? targetMacOSVersion,
   int? targetAndroidNdkApi,
@@ -54,7 +54,7 @@ Future<BuildResult> build(
         logger: logger,
         dartExecutable: dartExecutable,
       ).build(
-        buildMode: BuildModeImpl.release,
+        buildMode: BuildMode.release,
         linkModePreference: linkModePreference,
         target: target ?? Target.current,
         workingDirectory: packageUri,
@@ -84,14 +84,14 @@ Future<LinkResult> link(
   Uri packageUri,
   Logger logger,
   Uri dartExecutable, {
-  LinkModePreferenceImpl linkModePreference = LinkModePreferenceImpl.dynamic,
+  LinkModePreference linkModePreference = LinkModePreference.dynamic,
   CCompilerConfigImpl? cCompilerConfig,
   bool includeParentEnvironment = true,
   List<String>? capturedLogs,
   PackageLayout? packageLayout,
   required BuildResult buildResult,
   Uri? resourceIdentifiers,
-  IOSSdkImpl? targetIOSSdk,
+  IOSSdk? targetIOSSdk,
   int? targetIOSVersion,
   int? targetMacOSVersion,
   int? targetAndroidNdkApi,
@@ -104,7 +104,7 @@ Future<LinkResult> link(
         dartExecutable: dartExecutable,
       ).link(
         linkModePreference: linkModePreference,
-        buildMode: BuildModeImpl.release,
+        buildMode: BuildMode.release,
         target: target ?? Target.current,
         workingDirectory: packageUri,
         cCompilerConfig: cCompilerConfig,
@@ -130,13 +130,13 @@ Future<(BuildResult, LinkResult)> buildAndLink(
   Uri packageUri,
   Logger logger,
   Uri dartExecutable, {
-  LinkModePreferenceImpl linkModePreference = LinkModePreferenceImpl.dynamic,
+  LinkModePreference linkModePreference = LinkModePreference.dynamic,
   CCompilerConfigImpl? cCompilerConfig,
   bool includeParentEnvironment = true,
   List<String>? capturedLogs,
   PackageLayout? packageLayout,
   String? runPackageName,
-  IOSSdkImpl? targetIOSSdk,
+  IOSSdk? targetIOSSdk,
   int? targetIOSVersion,
   int? targetMacOSVersion,
   int? targetAndroidNdkApi,
@@ -150,7 +150,7 @@ Future<(BuildResult, LinkResult)> buildAndLink(
         dartExecutable: dartExecutable,
       );
       final buildResult = await buildRunner.build(
-        buildMode: BuildModeImpl.release,
+        buildMode: BuildMode.release,
         linkModePreference: linkModePreference,
         target: target ?? Target.current,
         workingDirectory: packageUri,
@@ -177,7 +177,7 @@ Future<(BuildResult, LinkResult)> buildAndLink(
 
       final linkResult = await buildRunner.link(
         linkModePreference: linkModePreference,
-        buildMode: BuildModeImpl.release,
+        buildMode: BuildMode.release,
         target: target ?? Target.current,
         workingDirectory: packageUri,
         cCompilerConfig: cCompilerConfig,
@@ -222,7 +222,7 @@ Future<BuildDryRunResult> buildDryRun(
   Uri packageUri,
   Logger logger,
   Uri dartExecutable, {
-  LinkModePreferenceImpl linkModePreference = LinkModePreferenceImpl.dynamic,
+  LinkModePreference linkModePreference = LinkModePreference.dynamic,
   CCompilerConfigImpl? cCompilerConfig,
   bool includeParentEnvironment = true,
   List<String>? capturedLogs,
@@ -250,7 +250,7 @@ Future<LinkDryRunResult> linkDryRun(
   Uri packageUri,
   Logger logger,
   Uri dartExecutable, {
-  LinkModePreferenceImpl linkModePreference = LinkModePreferenceImpl.dynamic,
+  LinkModePreference linkModePreference = LinkModePreference.dynamic,
   CCompilerConfigImpl? cCompilerConfig,
   bool includeParentEnvironment = true,
   List<String>? capturedLogs,

pkgs/native_assets_builder/test/build_runner/packaging_preference_test.dart

@@ -26,46 +26,46 @@ void main() async {
         packageUri,
         logger,
         dartExecutable,
-        linkModePreference: LinkModePreferenceImpl.dynamic,
+        linkModePreference: LinkModePreference.dynamic,
       );
 
       final resultPreferDynamic = await build(
         packageUri,
         logger,
         dartExecutable,
-        linkModePreference: LinkModePreferenceImpl.preferDynamic,
+        linkModePreference: LinkModePreference.preferDynamic,
       );
 
       final resultStatic = await build(
         packageUri,
         logger,
         dartExecutable,
-        linkModePreference: LinkModePreferenceImpl.static,
+        linkModePreference: LinkModePreference.static,
       );
 
       final resultPreferStatic = await build(
         packageUri,
         logger,
         dartExecutable,
-        linkModePreference: LinkModePreferenceImpl.preferStatic,
+        linkModePreference: LinkModePreference.preferStatic,
       );
 
       // This package honors preferences.
       expect(
         (resultDynamic.assets.single as NativeCodeAssetImpl).linkMode,
-        DynamicLoadingBundledImpl(),
+        DynamicLoadingBundled(),
       );
       expect(
         (resultPreferDynamic.assets.single as NativeCodeAssetImpl).linkMode,
-        DynamicLoadingBundledImpl(),
+        DynamicLoadingBundled(),
       );
       expect(
         (resultStatic.assets.single as NativeCodeAssetImpl).linkMode,
-        StaticLinkingImpl(),
+        StaticLinking(),
       );
       expect(
         (resultPreferStatic.assets.single as NativeCodeAssetImpl).linkMode,
-        StaticLinkingImpl(),
+        StaticLinking(),
       );
     });
   });

pkgs/native_assets_builder/test/test_data/native_dynamic_linking_test.dart

@@ -38,13 +38,13 @@ void main() async {
           outputDirectoryShared: outputDirectoryShared,
           packageName: name,
           packageRoot: testPackageUri,
-          targetOS: OSImpl.current,
+          targetOS: OS.current,
           version: HookConfigImpl.latestVersion,
-          linkModePreference: LinkModePreferenceImpl.dynamic,
+          linkModePreference: LinkModePreference.dynamic,
           dryRun: dryRun,
           linkingEnabled: false,
-          targetArchitecture: dryRun ? null : ArchitectureImpl.current,
-          buildMode: dryRun ? null : BuildModeImpl.debug,
+          targetArchitecture: dryRun ? null : Architecture.current,
+          buildMode: dryRun ? null : BuildMode.debug,
           cCompiler: dryRun ? null : cCompiler,
         );