feat(sdk)!: std.Node

[Chriscbr]

As part of the effort to fix #3717, I'm trying to refactor some parts of the SDK so that we do not need to rely on the std.Resource class. The issue this PR addresses is that the Resource class has an extra property named display which is not available if you extend cdk8s.Chart:

bring cdk8s;

class Bar {
  init() {
    this.display.title = "hi"; // OK
  }
}

class MyChart extends cdk8s.Chart {
  init() {
    this.display.title = "hello"; // error: Unknown symbol "display"
  }
}

The solution implemented by this PR is to standardize display property access through std.Node:

bring cdk8s;

class Bar {
  init() {
    std.Node.of(this).title = "hi"; // OK
  }
}

// once #3717 is fixed
class MyChart extends cdk8s.Chart {
  init() {
    std.Node.of(this).title = "hello"; // OK
  }
}

std.Node.of(this) also allows you toaccess all other fields and methods normally available through the constructs.Node class.

Other changes:

• I've replaced the _addInflightOps method from std.Resource with an API contract where a class can (optionally) implement a method named _getInflightOps(). This removes one more of the places where the compiler assumes behavior that only exists on std.Resource and not on constructs.Construct.
• I've removed the Code class from the SDK. I looked through our codebase and 100% of the usages have just been to access its text field, so the class isn't really doing anything important. Just using plain string's seems like a nice simplification.

BREAKING CHANGE: .display property is no longer available in Wing classes. To change how classes are displayed in the Wing Console, use std.Node.of(this) and modify fields like .title and .description.

Checklist

• Title matches Winglang's style guide
• Description explains motivation and solution
• Tests added (always)
• Docs updated (only required for features)
• Added pr/e2e-full label if this feature requires end-to-end testing

By submitting this pull request, I confirm that my contribution is made under the terms of the Wing Cloud Contribution License.

[Chriscbr]

@eladb Updated the API. Leaving nodeof for a separate PR since it requires some refactoring (#2027)

[eladb]

I am wondering if we need to add a doc topic about nodes?

Maybe even just an initial thing with a reference to the construct documentation?

[mergify]

Thanks for contributing, @Chriscbr! This PR will now be added to the merge queue, or immediately merged if rybickic/refactor-display is up-to-date with main and the queue is empty.

[mergify]

Thanks for contributing, @Chriscbr! This PR will now be added to the merge queue, or immediately merged if rybickic/refactor-display is up-to-date with main and the queue is empty.

[monadabot]

Congrats! 🚀 This was released in Wing 0.26.0.