WORKAROUND: avoid emitting synthetic from @javaclass module imports

Author: ktoso

Sources/JExtractSwiftLib/JavaSourceDependencies.swift

@@ -38,7 +38,7 @@ extension SourceDependencies {
       .map { "@JavaClass public class \($0) {}" }
       .joined(separator: "\n")
     let stub = SwiftJavaInputFile(syntax: SwiftParser.Parser.parse(source: text), path: "<javaClassStubs>.swift")
-    swiftModuleInputs["<javaClassStubs>"] = [stub]
+    syntheticStubInputs["<javaClassStubs>"] = [stub]
   }
 
   /// Load Swift sources from a dependency module described by `dependency` and

Sources/JExtractSwiftLib/SwiftKit+Printing.swift

@@ -73,6 +73,13 @@ extension SwiftSymbolTable {
         continue
       }
 
+      // Synthetic stub modules (e.g. <javaClassStubs>) exist purely for
+      // symbol-table resolution; they are not real Swift modules and must
+      // not be emitted as `import` statements.
+      guard !self.syntheticImportedModuleNames.contains(module) else {
+        continue
+      }
+
       guard let alternativeModules = self.importedModules[module]?.alternativeModules else {
         printer.print("import \(module)")
         continue

Sources/SwiftExtract/SourceDependencies.swift

@@ -26,10 +26,23 @@ public struct SourceDependencies {
   /// Parsed Swift inputs from dependency modules, keyed by Swift module name.
   public var swiftModuleInputs: [SwiftModuleName: [SwiftJavaInputFile]] = [:]
 
+  /// Synthetic stub inputs keyed by a synthetic module name (e.g. for
+  /// generated `@JavaClass` placeholders). These are needed for symbol-table
+  /// resolution but must NOT be emitted as `import <module>` statements in
+  /// generated Swift code, because their names are not real Swift modules.
+  public var syntheticStubInputs: [SwiftModuleName: [SwiftJavaInputFile]] = [:]
+
   public init() {}
 
-  /// Names of all dependency modules with associated Swift sources.
-  public var swiftModuleNames: Dictionary<SwiftModuleName, [SwiftJavaInputFile]>.Keys {
-    swiftModuleInputs.keys
+  /// Names of all dependency modules (real + synthetic) with associated Swift
+  /// sources. Used by callers that need to resolve types belonging to either.
+  public var swiftModuleNames: Set<SwiftModuleName> {
+    Set(swiftModuleInputs.keys).union(syntheticStubInputs.keys)
+  }
+
+  /// Names of synthetic stub modules. These should be skipped at Swift import
+  /// printing time.
+  public var syntheticModuleNames: Set<SwiftModuleName> {
+    Set(syntheticStubInputs.keys)
   }
 }

Sources/SwiftExtract/SwiftTypes/SwiftSymbolTable.swift

@@ -59,6 +59,11 @@ public class SwiftSymbolTable {
   public let importedModules: [String: SwiftModuleSymbolTable]
   public let parsedModule: SwiftModuleSymbolTable
 
+  /// Module names within `importedModules` that are synthetic — they exist
+  /// purely to drive type resolution and must NOT be emitted as
+  /// `import <module>` statements in generated Swift code.
+  public let syntheticImportedModuleNames: Set<String>
+
   private var knownTypeToNominal: [SwiftKnownTypeDeclKind: SwiftNominalTypeDeclaration] = [:]
   private var prioritySortedImportedModules: [SwiftModuleSymbolTable] {
     // Ordering with source of symbols preference:
@@ -72,9 +77,14 @@ public class SwiftSymbolTable {
     })
   }
 
-  public init(parsedModule: SwiftModuleSymbolTable, importedModules: [String: SwiftModuleSymbolTable]) {
+  public init(
+    parsedModule: SwiftModuleSymbolTable,
+    importedModules: [String: SwiftModuleSymbolTable],
+    syntheticImportedModuleNames: Set<String> = []
+  ) {
     self.parsedModule = parsedModule
     self.importedModules = importedModules
+    self.syntheticImportedModuleNames = syntheticImportedModuleNames
   }
 
   public func isModuleName(_ name: String) -> Bool {
@@ -123,7 +133,10 @@ extension SwiftSymbolTable {
       guard importedModules[dependencyModuleName] == nil else {
         continue
       }
-      let dependencyInputs = sourceDependencies.swiftModuleInputs[dependencyModuleName] ?? []
+      let dependencyInputs =
+        sourceDependencies.swiftModuleInputs[dependencyModuleName]
+        ?? sourceDependencies.syntheticStubInputs[dependencyModuleName]
+        ?? []
       // TODO: build a `dependencyImportedModules` dict by scanning the dep's
       // own source files with `importingModules(sourceFile:)`, instead of
       // reusing the primary's `importedModules`. The current set is too broad
@@ -185,7 +198,11 @@ extension SwiftSymbolTable {
       builder.handle(sourceFile: sourceFile.syntax, sourceFilePath: sourceFile.path)
     }
     let parsedModule = builder.finalize()
-    return SwiftSymbolTable(parsedModule: parsedModule, importedModules: importedModules)
+    return SwiftSymbolTable(
+      parsedModule: parsedModule,
+      importedModules: importedModules,
+      syntheticImportedModuleNames: sourceDependencies.syntheticModuleNames,
+    )
   }
 }