feat: Model ComplexComputedLists as ComplexLists and ComputedObjects

[ansgarm]

Closes #993

Open Subtasks

• Write upgrade guide (ucloud examples might be helpful to link)
• Add link to upgrade guide to Changelog

[ansgarm]

Quick update on this PR

Today we (@skorfmann, @DanielMSchmidt, @jsteinich and I) had a deeper look into the changes that this PR would introduce.
It models complex computed lists (i.e. "read-only" lists of objects that only have values after a resource has been provisioned) as an array which better reflects the underlying data. But as the length and contents of this array are only known "at runtime", they are modeled as arrays of a single token (similar to how e.g. string arrays are also modeled currently). While this allows accessing the whole list at once (which is currently not possible without self constructed references), it makes accessing a single item for a (at synth time) known index particularly hard. Which is an understatement. It is really bad. See the following two examples for yourselves:

// with ComplexComputedLists (previously)
ImageId: images.Images(jsii.String("0")).Id(),
// with Arrays of ComplexListItems (this PR)
ImageId: cdktf.Token_AsString(cdktf.Fn_Lookup(cdktf.Fn_Element(images.Images, 0), jsii.String("id"), jsii.String("")), &cdktf.EncodingOptions{}),

TypeScript is less bad, but still terrible:

// with ComplexComputedLists (previously)
imageId: images.images("0").id,
// with Arrays of ComplexListItems (now)
imageId: Token.asString(Fn.lookup(Fn.element(images.images, 0), "id", "")),

As this does not makes things simpler (besides allowing to access a whole list directly via e.g. images.Images), we decided to revisit the implementation and make some adjustments to it.

We'd like a solution to still be able to autocomplete the properties on individual items (e.g. .id) via intellisense in editors while still being able to reference to the whole list.

Sidenote: Maps probably share a similar problem and we should also address that (separately).

[vercel]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployment, click below or on the icon next to each commit.

🔍 Inspect: https://vercel.com/hashicorp/terraform-cdk/B1BSvD7YrBKmvQYRfMP2MQhsNmXa
✅ Preview: https://terraform-cdk-git-complex-lists-as-arrays-hashicorp.vercel.app

[Deployment for 3e579d4 canceled]

[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.