Add "Generated from" comments to 'declare module' statements in Clutz.

PiperOrigin-RevId: 278417519

Author: nbeloglazov

src/main/java/com/google/javascript/clutz/DeclarationGenerator.java

@@ -523,14 +523,15 @@ String produceDts(Depgraph depgraph) {
       if (symbol == null) {
         // Sometimes goog.provide statements are used as pure markers for dependency management, or
         // the defined provides do not get a symbol because they don't have a proper type.
-        emitGeneratedFromFileComment(provideToFile.get(provide));
+        SourceFile file = provideToFile.get(provide);
+        emitGeneratedFromFileComment(file);
         emitNamespaceBegin(getNamespace(emitName));
         emit("let");
         emit(getUnqualifiedName(emitName));
         emit(": any;");
         emitBreak();
         emitNamespaceEnd();
-        declareModule(provide, true, emitName);
+        declareModule(provide, true, emitName, file);
         continue;
       }
       if (symbol.getType() == null) {
@@ -539,7 +540,7 @@ String produceDts(Depgraph depgraph) {
         JSType moduleType = compiler.getTypeRegistry().getGlobalType(rewritenProvide);
         if (moduleType != null) {
           declareTypedefNamespace(symbol, moduleType, provides);
-          declareModule(provide, /* isDefault */ true, rewritenProvide);
+          declareModule(provide, /* isDefault */ true, rewritenProvide, symbol.getSourceFile());
         } else {
           emitComment("Skipping symbol " + symbol.getName() + " due to missing type information.");
         }
@@ -562,7 +563,7 @@ String produceDts(Depgraph depgraph) {
         namespace = getNamespace(symbol.getName());
       }
       declareNamespace(namespace, symbol, emitName, isDefault, transitiveProvides, false);
-      declareModule(provide, isDefault, emitName);
+      declareModule(provide, isDefault, emitName, symbol.getSourceFile());
     }
     // In order to typecheck in the presence of third-party externs, emit all extern symbols.
     processExternSymbols();
@@ -676,7 +677,7 @@ private void processReservedSymbols(TreeSet<String> provides, TypedScope topScop
         emitNamespaceEnd();
         for (String property : properties) {
           // Assume that all symbols that are siblings of the reserved word are default exports.
-          declareModule(property, true, property, true);
+          declareModule(property, true, property, true, var != null ? var.getSourceFile() : null);
         }
       }
     }
@@ -1401,16 +1402,22 @@ private boolean isConstructor(@Nullable JSDocInfo docInfo) {
     return docInfo != null && docInfo.isConstructor();
   }
 
-  private void declareModule(String name, boolean isDefault, String emitName) {
-    declareModule(name, isDefault, emitName, false);
+  private void declareModule(
+      String name, boolean isDefault, String emitName, StaticSourceFile sourceFile) {
+    declareModule(name, isDefault, emitName, /* inParentNamespace= */ false, sourceFile);
   }
 
   private void declareModule(
-      String name, boolean isDefault, String emitName, boolean inParentNamespace) {
+      String name,
+      boolean isDefault,
+      String emitName,
+      boolean inParentNamespace,
+      StaticSourceFile sourceFile) {
     if (GOOG_BASE_NAMESPACE.equals(name)) {
       // goog:goog cannot be imported.
       return;
     }
+    emitGeneratedFromFileComment(sourceFile);
     emitNoSpace("declare module '");
     emitNoSpace("goog:" + name);
     emitNoSpace("' {");

src/test/java/com/google/javascript/clutz/testdata/abstract_class.d.ts

@@ -6,6 +6,7 @@ declare namespace ಠ_ಠ.clutz {
     abstract myStaticAbstractMethod ( ) : string ;
   }
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/abstract_class.js
 declare module 'goog:foo.AbstractClass' {
   import AbstractClass = ಠ_ಠ.clutz.module$exports$foo$AbstractClass;
   export default AbstractClass;

src/test/java/com/google/javascript/clutz/testdata/abstract_method.d.ts

@@ -5,6 +5,7 @@ declare namespace ಠ_ಠ.clutz.abstract_method {
     bar (a : number ) : string ;
   }
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/abstract_method.js
 declare module 'goog:abstract_method.Child' {
   import Child = ಠ_ಠ.clutz.abstract_method.Child;
   export default Child;
@@ -17,6 +18,7 @@ declare namespace ಠ_ಠ.clutz.abstract_method {
     foo ( ) : string ;
   }
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/abstract_method.js
 declare module 'goog:abstract_method.Clazz' {
   import Clazz = ಠ_ಠ.clutz.abstract_method.Clazz;
   export default Clazz;
@@ -28,6 +30,7 @@ declare namespace ಠ_ಠ.clutz.abstract_method {
     foo ( ) : string ;
   }
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/abstract_method.js
 declare module 'goog:abstract_method.Interface' {
   import Interface = ಠ_ಠ.clutz.abstract_method.Interface;
   export default Interface;

src/test/java/com/google/javascript/clutz/testdata/aliasedInterface/aliasedInterface.d.ts

@@ -2,6 +2,7 @@
 declare namespace ಠ_ಠ.clutz {
   export import module$exports$alias_for_interface = ಠ_ಠ.clutz.module$exports$aliased_interface ;
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/aliasedInterface/alias_for_interface.js
 declare module 'goog:alias_for_interface' {
   import alias_for_interface = ಠ_ಠ.clutz.module$exports$alias_for_interface;
   export default alias_for_interface;
@@ -15,6 +16,7 @@ declare namespace ಠ_ಠ.clutz {
     x : string ;
   }
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/aliasedInterface/aliased_interface_with_static.js
 declare module 'goog:aliased_interface' {
   import aliased_interface = ಠ_ಠ.clutz.module$exports$aliased_interface;
   export default aliased_interface;

src/test/java/com/google/javascript/clutz/testdata/aliased_enums.d.ts

@@ -2,6 +2,7 @@
 declare namespace ಠ_ಠ.clutz.nested.bar {
   export import HahaEnum = nested.baz.Enum ;
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/aliased_enums.js
 declare module 'goog:nested.bar.HahaEnum' {
   import HahaEnum = ಠ_ಠ.clutz.nested.bar.HahaEnum;
   export default HahaEnum;
@@ -12,6 +13,7 @@ declare namespace ಠ_ಠ.clutz.nested.baz {
     A = 5.0 ,
   }
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/aliased_enums.js
 declare module 'goog:nested.baz.Enum' {
   import Enum = ಠ_ಠ.clutz.nested.baz.Enum;
   export default Enum;

src/test/java/com/google/javascript/clutz/testdata/all_optional_type.d.ts

@@ -3,6 +3,7 @@ declare namespace ಠ_ಠ.clutz.module$exports$collapsed$union {
   function fn (arg : { opt_some ? : string } | Function | null ) : void ;
   function fn2 (arg : { opt_some ? : string } | { other : string } ) : void ;
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/all_optional_type.js
 declare module 'goog:collapsed.union' {
   import union = ಠ_ಠ.clutz.module$exports$collapsed$union;
   export = union;

src/test/java/com/google/javascript/clutz/testdata/async_await_with_platform.d.ts

@@ -6,6 +6,7 @@ declare namespace ಠ_ಠ.clutz {
     foo ( ) : Promise < undefined > ;
   }
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/async_await_with_platform.js
 declare module 'goog:asyncawait' {
   import asyncawait = ಠ_ಠ.clutz.module$exports$asyncawait;
   export default asyncawait;

src/test/java/com/google/javascript/clutz/testdata/base.d.ts

@@ -31,6 +31,7 @@ declare namespace ಠ_ಠ.clutz.goog {
     private noStructuralTyping_goog_Uri : any;
   }
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/base.js
 declare module 'goog:goog.Uri' {
   import Uri = ಠ_ಠ.clutz.goog.Uri;
   export default Uri;

src/test/java/com/google/javascript/clutz/testdata/circular_prototype.d.ts

@@ -5,6 +5,7 @@ declare namespace ಠ_ಠ.clutz.module$exports$circular$obj {
   let obj : { a : number , //!! Unsupported circular reference for prop name: constructor
   z : number } ;
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/circular_prototype.js
 declare module 'goog:circular.obj' {
   import obj = ಠ_ಠ.clutz.module$exports$circular$obj;
   export = obj;

src/test/java/com/google/javascript/clutz/testdata/class_alias.d.ts

@@ -2,6 +2,7 @@
 declare namespace ಠ_ಠ.clutz.alias {
   export import A = ಠ_ಠ.clutz.original.A ;
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/class_alias.js
 declare module 'goog:alias.A' {
   import A = ಠ_ಠ.clutz.alias.A;
   export default A;
@@ -18,6 +19,7 @@ declare namespace ಠ_ಠ.clutz.original.A {
     private noStructuralTyping_original_A_InnerC : any;
   }
 }
+// Generated from src/test/java/com/google/javascript/clutz/testdata/class_alias.js
 declare module 'goog:original.A' {
   import A = ಠ_ಠ.clutz.original.A;
   export default A;