feat: allow partial snippet translation

[DanielMSchmidt]

Required attributes not contained in the original HCL will be passed in as options into the constructor. Instead of failing these examples at synth time (leading to another set of issues with JSII-Rosetta not being able to use the correct structs) we deal with these issues ahead of time by adding the required info.

This is a simple example to illustrate:

resource "docker_config" "service_config" {
        name = "my-config"
        # other required properties are missing:
        # data = base64encode(...)
}

This gets converted to Typescript as

import * as constructs from "constructs";
import * as cdktf from "cdktf";
/*Provider bindings are generated by running cdktf get.
See https://cdk.tf/provider-generation for more details.*/
import * as docker from "./.gen/providers/docker";
interface MyConfig {
  data: any;
}
class MyConvertedCode extends cdktf.TerraformStack {
  constructor(scope: constructs.Construct, name: string, config: MyConfig) {
    super(scope, name);
    new docker.config.Config(this, "service_config", {
      name: "my-config",
      data: config.data,
    });
  }
}

JSII processes it into this Java code:

import software.constructs.*;
import com.hashicorp.cdktf.*;
/*Provider bindings are generated by running cdktf get.
See https://cdk.tf/provider-generation for more details.*/
import gen.providers.docker.config.*;
public class MyConfig {
    private Object data;
    public Object getData() {
        return this.data;
    }
    public MyConfig data(Object data) {
        this.data = data;
        return this;
    }
}
public class MyConvertedCode extends TerraformStack {
    public MyConvertedCode(Construct scope, String name, MyConfig config) {
        super(scope, name);
        new Config(this, "service_config", new ConfigConfig()
                .name("my-config")
                .data(config.getData())
                );
    }
}

And e.g. in Golang its

import constructs "github.com/aws/constructs-go/constructs"
import cdktf "github.com/hashicorp/terraform-cdk-go/cdktf"
/*Provider bindings are generated by running cdktf get.
See https://cdk.tf/provider-generation for more details.*/
import "github.com/aws-samples/dummy/gen/providers/docker/config"
type myConfig struct {
	data interface{}
}
type myConvertedCode struct {
	terraformStack
}

func newMyConvertedCode(scope construct, name *string, config myConfig) *myConvertedCode {
	this := &myConvertedCode{}
	cdktf.NewTerraformStack_Override(this, scope, name)
	config.NewConfig(this, jsii.String("service_config"), &configConfig{
		name: jsii.String("my-config"),
		data: config.data,
	})
	return this
}

TODOs

• We don't share the "isRequired" information with the @cdktf/provider-generator and it could be hard to keep in sync since the information is buried in a parser
• Only resources and data sources use this in the main part of their config
• Only tested with top-level attributes, needs testing with block types and nested attributes as well
• The any type is used instead of (in the example above docker.config.ConfigConfig["data"]), we would need to test if this improves JSIIs capabilities or makes it worse for some reason

fixes: #2822

[team-tf-cdk]

This PR exceeds the recommended size of 1000 lines. Please make sure you are NOT addressing multiple issues with one PR. Note this PR might be rejected due to its size.

[team-tf-cdk]

This PR exceeds the recommended size of 1000 lines. Please make sure you are NOT addressing multiple issues with one PR. Note this PR might be rejected due to its size.

[team-tf-cdk]

This PR exceeds the recommended size of 1000 lines. Please make sure you are NOT addressing multiple issues with one PR. Note this PR might be rejected due to its size.

[team-tf-cdk]

This PR exceeds the recommended size of 1000 lines. Please make sure you are NOT addressing multiple issues with one PR. Note this PR might be rejected due to its size.

[ansgarm]

Looks mostly good to me! Just some comments / questions / leftover todos

[github-actions]

I'm going to lock this pull request because it has been closed for 30 days. This helps our maintainers find and focus on the active issues. If you've found a problem that seems related to this change, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.