[TrimmableTypeMap] Add JCW Java source generator

Add JcwJavaSourceGenerator that produces Java Callable Wrapper .java
source files from scanned JavaPeerInfo records:

- Package declarations, class declarations with extends/implements
- Static initializer with registerNatives call
- Constructors with super() delegation and activation guards
- Method overrides delegating to native callbacks
- Native method declarations for JNI registration
- Uses raw string literals (C# $$""") for readable Java templates
- Comprehensive test coverage for all generation scenarios

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: simonrozsival

src/Microsoft.Android.Sdk.TrimmableTypeMap/Generator/JcwJavaSourceGenerator.cs

@@ -0,0 +1,284 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+
+namespace Microsoft.Android.Sdk.TrimmableTypeMap;
+
+/// <summary>
+/// Generates JCW (Java Callable Wrapper) .java source files from scanned <see cref="JavaPeerInfo"/> records.
+/// Only processes ACW types (where <see cref="JavaPeerInfo.DoNotGenerateAcw"/> is false).
+/// </summary>
+sealed class JcwJavaSourceGenerator
+{
+	/// <summary>
+	/// Generates .java source files for all ACW types and writes them to the output directory.
+	/// Returns the list of generated file paths.
+	/// </summary>
+	public IReadOnlyList<string> Generate (IReadOnlyList<JavaPeerInfo> types, string outputDirectory)
+	{
+		if (types is null) {
+			throw new ArgumentNullException (nameof (types));
+		}
+		if (outputDirectory is null) {
+			throw new ArgumentNullException (nameof (outputDirectory));
+		}
+
+		var generatedFiles = new List<string> ();
+
+		foreach (var type in types) {
+			if (type.DoNotGenerateAcw) {
+				continue;
+			}
+
+			string filePath = GetOutputFilePath (type, outputDirectory);
+			string? dir = Path.GetDirectoryName (filePath);
+			if (dir != null) {
+				Directory.CreateDirectory (dir);
+			}
+
+			using var writer = new StreamWriter (filePath);
+			Generate (type, writer);
+			generatedFiles.Add (filePath);
+		}
+
+		return generatedFiles;
+	}
+
+	/// <summary>
+	/// Generates a single .java source file for the given type.
+	/// </summary>
+	internal void Generate (JavaPeerInfo type, TextWriter writer)
+	{
+		WritePackageDeclaration (type, writer);
+		WriteClassDeclaration (type, writer);
+		WriteStaticInitializer (type, writer);
+		WriteConstructors (type, writer);
+		WriteMethods (type, writer);
+		WriteClassClose (writer);
+	}
+
+	static string GetOutputFilePath (JavaPeerInfo type, string outputDirectory)
+	{
+		// JNI name uses '/' as separator and '$' for nested types
+		// e.g., "com/example/MainActivity" → "com/example/MainActivity.java"
+		// Nested types: "com/example/Outer$Inner" → "com/example/Outer$Inner.java" (same file convention)
+		string relativePath = type.JavaName + ".java";
+		return Path.Combine (outputDirectory, relativePath);
+	}
+
+	static void WritePackageDeclaration (JavaPeerInfo type, TextWriter writer)
+	{
+		string? package = GetJavaPackageName (type.JavaName);
+		if (package != null) {
+			writer.Write ("package ");
+			writer.Write (package);
+			writer.WriteLine (';');
+			writer.WriteLine ();
+		}
+	}
+
+	static void WriteClassDeclaration (JavaPeerInfo type, TextWriter writer)
+	{
+		string abstractModifier = type.IsAbstract && !type.IsInterface ? "abstract " : "";
+		string className = GetJavaSimpleName (type.JavaName);
+
+		writer.Write ($"public {abstractModifier}class {className}\n");
+
+		// extends clause
+		if (type.BaseJavaName != null) {
+			writer.WriteLine ($"\textends {JniNameToJavaName (type.BaseJavaName)}");
+		}
+
+		// implements clause — always includes IGCUserPeer, plus any implemented interfaces
+		writer.Write ("\timplements\n\t\tmono.android.IGCUserPeer");
+
+		foreach (var iface in type.ImplementedInterfaceJavaNames) {
+			writer.Write ($",\n\t\t{JniNameToJavaName (iface)}");
+		}
+
+		writer.WriteLine ();
+		writer.WriteLine ('{');
+	}
+
+	static void WriteStaticInitializer (JavaPeerInfo type, TextWriter writer)
+	{
+		string className = GetJavaSimpleName (type.JavaName);
+		writer.Write ($$"""
+	static {
+		mono.android.Runtime.registerNatives ({{className}}.class);
+	}
+
+
+""");
+	}
+
+	static void WriteConstructors (JavaPeerInfo type, TextWriter writer)
+	{
+		string simpleClassName = GetJavaSimpleName (type.JavaName);
+
+		foreach (var ctor in type.JavaConstructors) {
+			string parameters = FormatParameterList (ctor.Parameters);
+			string superArgs = ctor.SuperArgumentsString ?? FormatArgumentList (ctor.Parameters);
+			string args = FormatArgumentList (ctor.Parameters);
+
+			writer.Write ($$"""
+	public {{simpleClassName}} ({{parameters}})
+	{
+		super ({{superArgs}});
+		if (getClass () == {{simpleClassName}}.class) nctor_{{ctor.ConstructorIndex}} ({{args}});
+	}
+
+
+""");
+		}
+
+		// Write native constructor declarations
+		foreach (var ctor in type.JavaConstructors) {
+			string parameters = FormatParameterList (ctor.Parameters);
+			writer.WriteLine ($"\tprivate native void nctor_{ctor.ConstructorIndex} ({parameters});");
+		}
+
+		if (type.JavaConstructors.Count > 0) {
+			writer.WriteLine ();
+		}
+	}
+
+	static void WriteMethods (JavaPeerInfo type, TextWriter writer)
+	{
+		foreach (var method in type.MarshalMethods) {
+			if (method.IsConstructor) {
+				continue;
+			}
+
+			string javaReturnType = JniTypeToJava (method.JniReturnType);
+			bool isVoid = method.JniReturnType == "V";
+			string parameters = FormatParameterList (method.Parameters);
+			string args = FormatArgumentList (method.Parameters);
+			string returnPrefix = isVoid ? "" : "return ";
+
+			// throws clause for [Export] methods
+			string throwsClause = "";
+			if (method.ThrownNames != null && method.ThrownNames.Count > 0) {
+				throwsClause = $"\n\t\tthrows {string.Join (", ", method.ThrownNames)}";
+			}
+
+			writer.Write ($$"""
+	@Override
+	public {{javaReturnType}} {{method.JniName}} ({{parameters}}){{throwsClause}}
+	{
+		{{returnPrefix}}{{method.NativeCallbackName}} ({{args}});
+	}
+	public native {{javaReturnType}} {{method.NativeCallbackName}} ({{parameters}});
+
+""");
+		}
+	}
+
+	static void WriteClassClose (TextWriter writer)
+	{
+		writer.WriteLine ('}');
+	}
+
+	static string FormatParameterList (IReadOnlyList<JniParameterInfo> parameters)
+	{
+		if (parameters.Count == 0) {
+			return "";
+		}
+
+		var sb = new System.Text.StringBuilder ();
+		for (int i = 0; i < parameters.Count; i++) {
+			if (i > 0) {
+				sb.Append (", ");
+			}
+			sb.Append (JniTypeToJava (parameters [i].JniType));
+			sb.Append (" p");
+			sb.Append (i);
+		}
+		return sb.ToString ();
+	}
+
+	static string FormatArgumentList (IReadOnlyList<JniParameterInfo> parameters)
+	{
+		if (parameters.Count == 0) {
+			return "";
+		}
+
+		var sb = new System.Text.StringBuilder ();
+		for (int i = 0; i < parameters.Count; i++) {
+			if (i > 0) {
+				sb.Append (", ");
+			}
+			sb.Append ('p');
+			sb.Append (i);
+		}
+		return sb.ToString ();
+	}
+
+	/// <summary>
+	/// Converts a JNI type name to a Java source type name.
+	/// e.g., "android/app/Activity" → "android.app.Activity"
+	/// </summary>
+	internal static string JniNameToJavaName (string jniName)
+	{
+		return jniName.Replace ('/', '.');
+	}
+
+	/// <summary>
+	/// Extracts the Java package name from a JNI type name.
+	/// e.g., "com/example/MainActivity" → "com.example"
+	/// Returns null for types without a package.
+	/// </summary>
+	internal static string? GetJavaPackageName (string jniName)
+	{
+		int lastSlash = jniName.LastIndexOf ('/');
+		if (lastSlash < 0) {
+			return null;
+		}
+		return jniName.Substring (0, lastSlash).Replace ('/', '.');
+	}
+
+	/// <summary>
+	/// Extracts the simple Java class name from a JNI type name.
+	/// e.g., "com/example/MainActivity" → "MainActivity"
+	/// e.g., "com/example/Outer$Inner" → "Outer$Inner" (preserves nesting separator)
+	/// </summary>
+	internal static string GetJavaSimpleName (string jniName)
+	{
+		int lastSlash = jniName.LastIndexOf ('/');
+		return lastSlash >= 0 ? jniName.Substring (lastSlash + 1) : jniName;
+	}
+
+	/// <summary>
+	/// Converts a JNI type descriptor to a Java source type.
+	/// e.g., "V" → "void", "I" → "int", "Landroid/os/Bundle;" → "android.os.Bundle"
+	/// </summary>
+	internal static string JniTypeToJava (string jniType)
+	{
+		if (jniType.Length == 1) {
+			return jniType [0] switch {
+				'V' => "void",
+				'Z' => "boolean",
+				'B' => "byte",
+				'C' => "char",
+				'S' => "short",
+				'I' => "int",
+				'J' => "long",
+				'F' => "float",
+				'D' => "double",
+				_ => throw new ArgumentException ($"Unknown JNI primitive type: {jniType}"),
+			};
+		}
+
+		// Array types: "[I" → "int[]", "[Ljava/lang/String;" → "java.lang.String[]"
+		if (jniType [0] == '[') {
+			return JniTypeToJava (jniType.Substring (1)) + "[]";
+		}
+
+		// Object types: "Landroid/os/Bundle;" → "android.os.Bundle"
+		if (jniType [0] == 'L' && jniType [jniType.Length - 1] == ';') {
+			return JniNameToJavaName (jniType.Substring (1, jniType.Length - 2));
+		}
+
+		throw new ArgumentException ($"Unknown JNI type descriptor: {jniType}");
+	}
+}