[interop] Add support for importing and exporting declarations, as well as multi-file output (#418)

* added support for exporting declarations

* wip: transform manager

* added support for multi-projects

- added import support
- added gen of code inside file in the case of non multi-import
- added support for multiple file generation
- using `TransformManager` for managing transformation of code

* formatting and analysis fix

* added TODO and comment

* refactoring transformation and docs

* minor changes

* fixed symbol code

* fixed tests

* updated test suite and completed `typeof` integration

* completed integration test setup

* minor comment change

* Implemented new, faster transformation process

* completed config update

* removed comment

* fallback to each child due to @types/web bug

* formatting and fixes

* resolved some comments and nits

Author: nikeokoronkwo

web_generator/lib/src/ast/base.dart

@@ -26,8 +26,9 @@ class DeclarationOptions extends Options {
 
 class TypeOptions extends Options {
   bool nullable;
+  String? url;
 
-  TypeOptions({this.nullable = false});
+  TypeOptions({this.nullable = false, this.url});
 }
 
 class ASTOptions {
@@ -42,7 +43,7 @@ class ASTOptions {
 }
 
 sealed class Node {
-  abstract final String? name;
+  String? get name;
   abstract final ID id;
   String? get dartName;
 
@@ -53,20 +54,30 @@ sealed class Node {
 
 abstract class Declaration extends Node {
   @override
-  abstract final String name;
+  String get name;
 
   @override
   Spec emit([covariant DeclarationOptions? options]);
 }
 
 abstract class NamedDeclaration extends Declaration {
-  ReferredType asReferredType([List<Type>? typeArgs]) =>
-      ReferredType(name: name, declaration: this, typeParams: typeArgs ?? []);
+  @override
+  abstract String name;
+
+  ReferredType asReferredType([List<Type>? typeArgs, String? url]) =>
+      ReferredType(
+          name: name, declaration: this, typeParams: typeArgs ?? [], url: url);
 }
 
 abstract interface class ExportableDeclaration extends Declaration {
   /// Whether this declaration is exported.
   bool get exported;
+
+  @override
+  abstract String? dartName;
+
+  @override
+  abstract String name;
 }
 
 abstract class Type extends Node {

web_generator/lib/src/ast/declarations.dart

@@ -17,10 +17,10 @@ import 'types.dart';
 sealed class TypeDeclaration extends NamedDeclaration
     implements ExportableDeclaration {
   @override
-  final String name;
+  String name;
 
   @override
-  final String? dartName;
+  String? dartName;
 
   @override
   final bool exported;
@@ -139,6 +139,9 @@ class VariableDeclaration extends FieldDeclaration
   @override
   ID get id => ID(type: 'var', name: name);
 
+  @override
+  String? dartName;
+
   @override
   Spec emit([DeclarationOptions? options]) {
     if (modifier == VariableModifier.$const) {
@@ -159,12 +162,10 @@ class VariableDeclaration extends FieldDeclaration
   }
 
   @override
-  String? get dartName => null;
-
-  @override
-  ReferredType<VariableDeclaration> asReferredType([List<Type>? typeArgs]) {
+  ReferredType<VariableDeclaration> asReferredType(
+      [List<Type>? typeArgs, String? url]) {
     return ReferredType<VariableDeclaration>.fromType(type, this,
-        typeParams: typeArgs ?? []);
+        typeParams: typeArgs ?? [], url: url);
   }
 }
 
@@ -173,10 +174,10 @@ enum VariableModifier { let, $const, $var }
 class FunctionDeclaration extends CallableDeclaration
     implements ExportableDeclaration {
   @override
-  final String name;
+  String name;
 
   @override
-  final String? dartName;
+  String? dartName;
 
   @override
   final List<ParameterDeclaration> parameters;
@@ -234,18 +235,19 @@ class FunctionDeclaration extends CallableDeclaration
   }
 
   @override
-  ReferredType<FunctionDeclaration> asReferredType([List<Type>? typeArgs]) {
+  ReferredType<FunctionDeclaration> asReferredType(
+      [List<Type>? typeArgs, String? url]) {
     // TODO: We could do better here and make the function type typed
     return ReferredType<FunctionDeclaration>.fromType(
         BuiltinType.referred('Function', typeParams: typeArgs ?? [])!, this,
-        typeParams: typeArgs ?? []);
+        typeParams: typeArgs ?? [], url: url);
   }
 }
 
 class EnumDeclaration extends NamedDeclaration
     implements ExportableDeclaration {
   @override
-  final String name;
+  String name;
 
   @override
   final bool exported;
@@ -339,14 +341,14 @@ class EnumMember {
 class TypeAliasDeclaration extends NamedDeclaration
     implements ExportableDeclaration {
   @override
-  final String name;
+  String name;
 
   final List<GenericType> typeParameters;
 
   final Type type;
 
   @override
-  final String? dartName;
+  String? dartName;
 
   @override
   bool exported;
@@ -447,13 +449,13 @@ class InterfaceDeclaration extends TypeDeclaration {
 class PropertyDeclaration extends FieldDeclaration
     implements MemberDeclaration {
   @override
-  final String name;
+  String name;
 
   @override
   final ID id;
 
   @override
-  final String? dartName;
+  String? dartName;
 
   @override
   late final TypeDeclaration parent;
@@ -696,6 +698,9 @@ class OperatorDeclaration extends CallableDeclaration
   @override
   String get name => kind.expression;
 
+  @override
+  set name(String? name) {}
+
   OperatorKind kind;
 
   @override

web_generator/lib/src/ast/types.dart

@@ -20,21 +20,24 @@ class ReferredType<T extends Declaration> extends Type {
 
   List<Type> typeParams;
 
+  String? url;
+
   ReferredType(
       {required this.name,
       required this.declaration,
-      this.typeParams = const []});
+      this.typeParams = const [],
+      this.url});
 
   factory ReferredType.fromType(Type type, T declaration,
-      {List<Type> typeParams}) = ReferredDeclarationType;
+      {List<Type> typeParams, String? url}) = ReferredDeclarationType;
 
   @override
   Reference emit([TypeOptions? options]) {
-    // TODO: Support referred types imported from URL
     return TypeReference((t) => t
-      ..symbol = declaration.name
+      ..symbol = declaration.dartName ?? declaration.name
       ..types.addAll(typeParams.map((t) => t.emit(options)))
-      ..isNullable = options?.nullable);
+      ..isNullable = options?.nullable
+      ..url = options?.url ?? url);
   }
 }
 
@@ -44,11 +47,15 @@ class ReferredDeclarationType<T extends Declaration> extends ReferredType<T> {
   @override
   String get name => type.name ?? declaration.name;
 
-  ReferredDeclarationType(this.type, T declaration, {super.typeParams})
+  ReferredDeclarationType(this.type, T declaration,
+      {super.typeParams, super.url})
       : super(name: declaration.name, declaration: declaration);
 
   @override
   Reference emit([covariant TypeOptions? options]) {
+    options ??= TypeOptions();
+    options.url = super.url;
+
     return type.emit(options);
   }
 }

web_generator/lib/src/dart_main.dart

@@ -70,7 +70,10 @@ Future<void> generateJSInteropBindings(Config config) async {
   final jsDeclarations = parseDeclarationFiles(config.input);
 
   // transform declarations
-  final dartDeclarations = transform(jsDeclarations, config: config);
+  final manager =
+      TransformerManager.fromParsedResults(jsDeclarations, config: config);
+
+  final dartDeclarations = manager.transform();
 
   // generate
   final generatedCodeMap = dartDeclarations.generate(config);