feat: rosetta go support (#3376)

Adds Go renderer for jsii-rosetta to support translating documentations
snippets to Go.

Fixes #2439

---

By submitting this pull request, I confirm that my contribution is made under the terms of the [Apache 2.0 license].

[Apache 2.0 license]: https://www.apache.org/licenses/LICENSE-2.0

packages/jsii-rosetta/lib/jsii/jsii-types.ts

@@ -7,8 +7,7 @@ import { hasAnyFlag, analyzeStructType, JsiiSymbol } from './jsii-utils';
 export type JsiiType =
   | { kind: 'unknown' }
   | { kind: 'error'; message: string }
-  | { kind: 'map'; elementType: JsiiType }
-  | { kind: 'list'; elementType: JsiiType }
+  | { kind: 'map' | 'list'; elementType: JsiiType; elementTypeSymbol: ts.Symbol | undefined }
   | { kind: 'namedType'; name: string }
   | { kind: 'builtIn'; builtIn: BuiltInType };
 
@@ -28,6 +27,7 @@ export function determineJsiiType(typeChecker: ts.TypeChecker, type: ts.Type): J
       elementType: mapValuesType.elementType
         ? determineJsiiType(typeChecker, mapValuesType.elementType)
         : { kind: 'builtIn', builtIn: 'any' },
+      elementTypeSymbol: mapValuesType.elementType?.symbol,
     };
   }
 
@@ -38,12 +38,14 @@ export function determineJsiiType(typeChecker: ts.TypeChecker, type: ts.Type): J
       return {
         kind: 'list',
         elementType: determineJsiiType(typeChecker, typeRef.typeArguments[0]),
+        elementTypeSymbol: typeRef.typeArguments[0].symbol,
       };
     }
 
     return {
       kind: 'list',
       elementType: { kind: 'builtIn', builtIn: 'any' },
+      elementTypeSymbol: undefined,
     };
   }
 
@@ -66,6 +68,11 @@ export function determineJsiiType(typeChecker: ts.TypeChecker, type: ts.Type): J
       message: `Type unions or intersections are not supported in examples, got: ${typeChecker.typeToString(type)}`,
     };
   }
+
+  if ((type.flags & (ts.TypeFlags.Void | ts.TypeFlags.VoidLike)) !== 0) {
+    return { kind: 'builtIn', builtIn: 'void' };
+  }
+
   return { kind: 'unknown' };
 }
 

packages/jsii-rosetta/lib/languages/csharp.ts

@@ -669,6 +669,8 @@ export class CSharpVisitor extends DefaultVisitor<CSharpLanguageContext> {
               return 'string';
             case 'any':
               return 'object';
+            case 'void':
+              return 'void';
           }
       }
     }

packages/jsii-rosetta/lib/languages/default.ts

@@ -45,6 +45,10 @@ export abstract class DefaultVisitor<C> implements AstHandler<C> {
     return new OTree([JSON.stringify(node.text)]);
   }
 
+  public numericLiteral(node: ts.NumericLiteral, _children: AstRenderer<C>): OTree {
+    return new OTree([node.text]);
+  }
+
   public identifier(node: ts.Identifier, _children: AstRenderer<C>): OTree {
     return new OTree([node.text]);
   }