feat(jsii): Implement --watch support

Re-wrote JSII using the TypeScript compiler services API, integrating
with the `ts.ProgramBuilder` classes so that incremental build is
possible. Additonally, error messages leverage `TypeScript`'s built-in
diagnostic formatter, and enable the rendering of code excerpts with
error messages.

build.sh

@@ -12,10 +12,10 @@ export PATH=node_modules/.bin:$PATH
 
 echo "============================================================================================="
 echo "building..."
-lerna run build
+lerna run build --stream
 
 echo "============================================================================================="
 echo "testing..."
-lerna run test
+lerna run test --stream
 
 touch $BUILD_INDICATOR

packages/jsii-calc/package.json

@@ -24,6 +24,7 @@
  },
  "scripts": {
  "build": "jsii",
+ "watch": "jsii -w",
  "test": "node test/test.calc.js && diff-test test/assembly.jsii .jsii"
  },
  "bundledDependencies": [

packages/jsii-calc/test/assembly.jsii

@@ -2827,9 +2827,15 @@
  "kind": "enum",
  "members": [
  {
+ "docs": {
+ "comment": "Normal string expression "
+ },
  "name": "Normal"
  },
  {
+ "docs": {
+ "comment": "Decorated string expression "
+ },
  "name": "Decorated"
  }
  ],
@@ -2838,5 +2844,5 @@
  }
  },
  "version": "0.6.4",
- "fingerprint": "J/33pyDX7y9AI1Vizdu+HEO/87ED05WoSxg41CSYHtw="
+ "fingerprint": "A6PSlMkLYrySPqgKflMrn2U4DjO6HO+VAJrO66IcSlo="
 }

packages/jsii-dotnet-runtime-test/test/Amazon.JSII.Runtime.IntegrationTests/ComplianceTests.cs

@@ -178,7 +178,7 @@ public void UnionTypes()
  IDictionary<string, object> map = new Dictionary<string, object>();
  map["Foo"] = new Multiply(new Number(2), new Number(00));
  types.UnionMapProperty = map;
- 
+
 
  // array
  types.UnionArrayProperty = new object[] { "Hello", 123, new Number(3) };
@@ -571,7 +571,7 @@ public void InterfaceBuilder()
  throw new NotImplementedException();
  }
 
- 
+
  [Fact(DisplayName = Prefix + nameof(SyncOverrides_SyncOverrides))]
  public void SyncOverrides_SyncOverrides()
  {

packages/jsii-java-runtime/project/src/main/java/software/amazon/jsii/JsiiEngine.java

@@ -245,11 +245,11 @@ private JsiiObject createNative(final String fqn) {
  } catch (NoSuchMethodException e) {
  throw new JsiiException("Cannot create native object of type "
  + klass.getName()
- + " without a constructor that accepts an InitializationMode argument");
+ + " without a constructor that accepts an InitializationMode argument", e);
 
  } catch (IllegalAccessException | InstantiationException | InvocationTargetException e) {
  throw new JsiiException("Unable to instantiate a new object for FQN " + fqn + ": "
- + e.getMessage());
+ + e.getMessage(), e);
  }
  } catch (ClassNotFoundException e) {
  System.err.println("WARNING: Cannot find the class: " + fqn + ". Defaulting to JsiiObject");

packages/jsii-pacmak/test/.gitattributes

@@ -0,0 +1,2 @@
+# Generated C# code will have CRLF line endings, making git pretty awkward
+.cs eol=crlf

packages/jsii-pacmak/test/expected.jsii-calc/dotnet/Amazon.JSII.Tests.CalculatorPackageId/.jsii

@@ -2827,9 +2827,15 @@
  "kind": "enum",
  "members": [
  {
+ "docs": {
+ "comment": "Normal string expression "
+ },
  "name": "Normal"
  },
  {
+ "docs": {
+ "comment": "Decorated string expression "
+ },
  "name": "Decorated"
  }
  ],
@@ -2838,5 +2844,5 @@
  }
  },
  "version": "0.6.4",
- "fingerprint": "J/33pyDX7y9AI1Vizdu+HEO/87ED05WoSxg41CSYHtw="
+ "fingerprint": "A6PSlMkLYrySPqgKflMrn2U4DjO6HO+VAJrO66IcSlo="
 }

packages/jsii-pacmak/test/expected.jsii-calc/dotnet/Amazon.JSII.Tests.CalculatorPackageId/Amazon/JSII/Tests/CalculatorNamespace/composition/CompositeOperation/CompositionStringStyle.cs

@@ -6,8 +6,10 @@ namespace Amazon.JSII.Tests.CalculatorNamespace.composition.CompositeOperation
  [JsiiEnum(typeof(CompositionStringStyle), "jsii-calc.composition.CompositeOperation.CompositionStringStyle")]
  public enum CompositionStringStyle
  {
+ /// <summary>Normal string expression </summary>
  [JsiiEnumMember("Normal")]
  Normal,
+ /// <summary>Decorated string expression </summary>
  [JsiiEnumMember("Decorated")]
  Decorated
  }

packages/jsii-pacmak/test/expected.jsii-calc/java/src/main/java/software/amazon/jsii/tests/calculator/composition/CompositeOperation.java

@@ -80,7 +80,13 @@ public void setStringStyle(final software.amazon.jsii.tests.calculator.compositi
  */
  @software.amazon.jsii.Jsii(module = software.amazon.jsii.tests.calculator.$Module.class, fqn = "jsii-calc.composition.CompositeOperation.CompositionStringStyle")
  public enum CompositionStringStyle {
+ /**
+ * Normal string expression 
+ */
  Normal,
+ /**
+ * Decorated string expression 
+ */
  Decorated,
  }
 }

packages/jsii-pacmak/test/expected.jsii-calc/sphinx/jsii-calc.rst

@@ -2627,8 +2627,14 @@ CompositeOperation
 
  .. py:data:: Normal
 
+ Normal string expression 
+
+
  .. py:data:: Decorated
 
+ Decorated string expression 
+
+
 
 
 

packages/jsii-spec/lib/spec.ts

@@ -228,8 +228,8 @@ export interface NamedTypeReference extends TypeReferenceBase {
  */
  fqn: string;
 }
-export function isNamedTypeReference(ref: TypeReference): ref is NamedTypeReference {
- return !!(ref as NamedTypeReference).fqn;
+export function isNamedTypeReference(ref: TypeReference | undefined): ref is NamedTypeReference {
+ return ref != null && !!(ref as NamedTypeReference).fqn;
 }
 
 /**
@@ -242,8 +242,8 @@ export interface PrimitiveTypeReference extends TypeReferenceBase {
  */
  primitive: PrimitiveType;
 }
-export function isPrimitiveTypeReference(ref: TypeReference): ref is PrimitiveTypeReference {
- return !!(ref as PrimitiveTypeReference).primitive;
+export function isPrimitiveTypeReference(ref: TypeReference | undefined): ref is PrimitiveTypeReference {
+ return ref != null && !!(ref as PrimitiveTypeReference).primitive;
 }
 
 /**
@@ -262,8 +262,8 @@ export interface CollectionTypeReference extends TypeReferenceBase {
  elementtype: TypeReference;
  };
 }
-export function isCollectionTypeReference(ref: TypeReference): ref is CollectionTypeReference {
- return !!(ref as CollectionTypeReference).collection;
+export function isCollectionTypeReference(ref: TypeReference | undefined): ref is CollectionTypeReference {
+ return ref != null && !!(ref as CollectionTypeReference).collection;
 }
 
 /**
@@ -281,8 +281,8 @@ export interface UnionTypeReference extends TypeReferenceBase {
  types: TypeReference[];
  }
 }
-export function isUnionTypeReference(ref: TypeReference): ref is UnionTypeReference {
- return !!(ref as UnionTypeReference).union;
+export function isUnionTypeReference(ref: TypeReference | undefined): ref is UnionTypeReference {
+ return ref != null && !!(ref as UnionTypeReference).union;
 }
 
 /**
@@ -497,8 +497,8 @@ export interface ClassType extends TypeBase {
  interfaces?: NamedTypeReference[];
 }
 
-export function isClassType(type: Type): type is ClassType {
- return type.kind === TypeKind.Class;
+export function isClassType(type: Type | undefined): type is ClassType {
+ return type != null && type.kind === TypeKind.Class;
 }
 
 export interface InterfaceType extends TypeBase {
@@ -529,8 +529,8 @@ export interface InterfaceType extends TypeBase {
  datatype?: boolean;
 }
 
-export function isInterfaceType(type: Type): type is InterfaceType {
- return type.kind === TypeKind.Interface;
+export function isInterfaceType(type: Type | undefined): type is InterfaceType {
+ return type != null && type.kind === TypeKind.Interface;
 }
 
 /**
@@ -555,14 +555,14 @@ export interface EnumType extends TypeBase {
  members: EnumMember[];
 }
 
-export function isEnumType(type: Type): type is EnumType {
- return type.kind === TypeKind.Enum;
+export function isEnumType(type: Type | undefined): type is EnumType {
+ return type != null && type.kind === TypeKind.Enum;
 }
 
 /**
  * Return whether this type is a class or interface type
  */
-export function isClassOrInterfaceType(type: Type): type is (InterfaceType | ClassType) {
+export function isClassOrInterfaceType(type: Type | undefined): type is (InterfaceType | ClassType) {
  return isClassType(type) || isInterfaceType(type);
 }
 

packages/jsii/.npmignore

@@ -1,3 +1,3 @@
-# Don't include original .ts files when doing `npm pack`
-*.ts
+*
+!*.js
 !*.d.ts