Expose experimental dynamic modules API through package:dynamic_modules

Change-Id: I14963de5f6face564276955d21d63f4b038cf990
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/378722
Reviewed-by: Leaf Petersen <[email protected]>
Reviewed-by: Bob Nystrom <[email protected]>
Commit-Queue: Alexander Markov <[email protected]>
Reviewed-by: Slava Egorov <[email protected]>
Reviewed-by: Sigmund Cherem <[email protected]>

Author: alexmarkov

pkg/dynamic_modules/OWNERS

@@ -0,0 +1,4 @@
+set noparent
+file:/tools/OWNERS_VM
+file:/tools/OWNERS_WEB
+file:/OWNERS

pkg/dynamic_modules/README.md

@@ -0,0 +1,9 @@
+This package contains experimental dynamic modules API.
+
+## Status: experimental
+
+**NOTE**: This package is currently experimental and not published or
+included in the SDK.
+
+Do not take dependency on this package unless you are prepared for
+breaking changes and possibly removal of this code at any point in time.

pkg/dynamic_modules/analysis_options.yaml

@@ -0,0 +1,9 @@
+# Copyright (c) 2024, the Dart project authors.  Please see the AUTHORS file
+# for details. All rights reserved. Use of this source code is governed by a
+# BSD-style license that can be found in the LICENSE file.
+
+include: package:lints/recommended.yaml
+
+analyzer:
+  errors:
+    import_internal_library: ignore

pkg/dynamic_modules/lib/dynamic_modules.dart

@@ -0,0 +1,30 @@
+// Copyright (c) 2024, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+import 'dart:typed_data' show Uint8List;
+import 'dart:_internal' as internal;
+
+/// Load a dynamic module from [uri] and execute its entry point method.
+///
+/// Entry point method is a no-argument method annotated with
+/// `@pragma('dyn-module:entry-point')`.
+///
+/// This API is experimental, can be changed or removed
+/// without a notice.
+///
+/// Returns a future containing the result of the entry point method.
+Future<Object?> loadModuleFromUri(Uri uri) =>
+    internal.loadDynamicModule(uri: uri);
+
+/// Load a dynamic module from [bytes] and execute its entry point method.
+///
+/// Entry point method is a no-argument method annotated with
+/// `@pragma('dyn-module:entry-point')`.
+///
+/// This API is experimental, can be changed or removed
+/// without a notice.
+///
+/// Returns a future containing the result of the entry point method.
+Future<Object?> loadModuleFromBytes(Uint8List bytes) =>
+    internal.loadDynamicModule(bytes: bytes);

pkg/dynamic_modules/pubspec.yaml

@@ -0,0 +1,6 @@
+name: dynamic_modules
+# This package is not intended for consumption on pub.dev. DO NOT publish.
+publish_to: none
+
+environment:
+  sdk: '>=3.3.0 <4.0.0'

pkg/kernel/lib/target/targets.dart

@@ -347,7 +347,8 @@ abstract class Target {
   bool allowPlatformPrivateLibraryAccess(Uri importer, Uri imported) =>
       importer.isScheme("dart") ||
       (importer.isScheme("package") &&
-          importer.path.startsWith("dart_internal/"));
+          (importer.path.startsWith("dart_internal/") ||
+              importer.path.startsWith("dynamic_modules/")));
 
   /// Whether the `native` language extension is supported within the library
   /// with the given import [uri].