chore(release): 1.117.0 (#4957)

See [CHANGELOG](https://github.com/aws/jsii/blob/bump/1.117.0/CHANGELOG.md)

Author: mergify[bot]

.github/workflows/main.yml

@@ -39,7 +39,7 @@ jobs:
           distribution: 'zulu'
           java-version: '8'
       - name: Set up Node LTS
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           cache: yarn
           node-version: 'lts/*'
@@ -121,7 +121,7 @@ jobs:
           distribution: 'zulu'
           java-version: '8'
       - name: Set up Node LTS
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           cache: yarn
           node-version: 'lts/*'
@@ -356,7 +356,7 @@ jobs:
           distribution: 'zulu'
           java-version: ${{ matrix.java }}
       - name: Set up Node ${{ matrix.node }}
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           cache: yarn
           node-version: ${{ matrix.node }}
@@ -450,7 +450,7 @@ jobs:
           distribution: 'corretto'
           java-version: '20'
       - name: Set up Node 20
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           node-version: '20'
       - name: Set up Python 3.11

.github/workflows/yarn-upgrade.yml

@@ -17,7 +17,7 @@ jobs:
         uses: actions/checkout@v5
 
       - name: Set up Node
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v6
         with:
           cache: yarn
           node-version: 'lts/*'

.mergify/config.yml

@@ -4,7 +4,10 @@ merge_queue:
   max_parallel_checks: 1
 queue_rules:
   - name: default-squash
-    conditions:
+    queue_conditions:
+      - status-success=Unit Tests
+      - status-success=Integration test (jsii-pacmak)
+    merge_conditions:
       - status-success=Unit Tests
       - status-success=Integration test (jsii-pacmak)
     commit_message_template: |-
@@ -15,7 +18,10 @@ queue_rules:
     batch_size: 1
 
   - name: default-merge
-    conditions:
+    queue_conditions:
+      - status-success=Unit Tests
+      - status-success=Integration test (jsii-pacmak)
+    merge_conditions:
       - status-success=Unit Tests
       - status-success=Integration test (jsii-pacmak)
     commit_message_template: |-

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [1.117.0](https://github.com/aws/jsii/compare/v1.116.0...v1.117.0) (2025-10-22)
+
+
+### Features
+
+* support class covariant overrides in kernel, tools and docs ([#4925](https://github.com/aws/jsii/issues/4925)) ([cf4a0b6](https://github.com/aws/jsii/commit/cf4a0b6f2789705ea63df9f305a7ea721c84baf0))
+
+
+### Bug Fixes
+
+* **jsii-reflect:** statically guarantee JsiiFeature subset ([#4956](https://github.com/aws/jsii/issues/4956)) ([17bf498](https://github.com/aws/jsii/commit/17bf498bfb744ac080d2f7ee14a308d8cf81f174))
+
 ## [1.116.0](https://github.com/aws/jsii/compare/v1.115.0...v1.116.0) (2025-10-14)
 
 

gh-pages/content/user-guides/lib-author/typescript-restrictions.md

@@ -18,7 +18,7 @@ coexist in the same closure, it is recommended to also declare all such dependen
 
 Occasionally, a dependency on a *non-jsii module* is useful. Since such dependencies do not have generated bindings in
 all the supported languages, they must be bundled with the *jsii module* that depends on them, by adding the library
-into the `bundleDependencies` array in `package.json`. 
+into the `bundleDependencies` array in `package.json`.
 
 The API of the *jsii module* can not expose any type from bundled dependencies, since those types would not be available in other languages.
 TypeScript files that include a non-jsii dependency (e.g. a lambda handler for an AWS CDK Construct) cannot be exported from the `main`/`types` entry point.
@@ -137,40 +137,53 @@ export class Subclass extends Base {
 ### Covariant Overrides & Parameter List Changes
 
 In **TypeScript**, overriding members can have a signature that differs from the overridden member as long as the new
-signature is compatible with the parent. This is however not supported as:
+signature is compatible with the parent. This is only partially supported in jsii as:
 
-- **Java** and **C#** do not support omitting parameters when overriding or implementing a member
-- **C#** does not support overriding or implementing a member using covariant parameter or return types
+- In **C#** when implementing interfaces, you cannot override members or change return types
+- **C#** only supports covariant overrides to `readonly` properties
+- Both **Java** and **C#** do not support omitting parameters when overriding or implementing a method
+- In **C#** you cannot override method parameters
 
-!!! note
-    **C# 9** introduces support for covariant return types, which would allow relaxing this restriction, however `jsii`
-    must build code targetting the `.NET Core 3.1` runtime, which only supports **C# 8**. Once `.NET Core 3.1` becomes
-    end-of-life, this may change.
+As a consequence, changes to member signatures are only allowed in very few cases.
+All overrides must be covariant to the parent type.
+
+- Return type of (non-static) methods
+- `readonly` properties
+
+```ts hl_lines="10-11 13-14 16-17 19-20 22-23"
+export class SuperClass {}
+export class SubClass extends SuperClass {}
 
-```ts hl_lines="6-7 9-10 12-13"
 export class Base {
-  public method(param: any): any { /* ... */ }
+  public readonly prop: SuperClass;
+  public method(param: SuperClass): SuperClass { /* ... */ }
 }
 
 export class Child extends Base {
   // 💥 Parameter signatures do not match
   public method(): any { /* ... */ }
 
   // 💥 Parameter types do not match, even though they are covariant
-  public method(param: string): any { /* ... */ }
+  public method(param: SubClass): any { /* ... */ }
+
+  // 💥 Property types do not match
+  public readonly prop: string;
+
+  // ✅ Return type is covariant
+  public method(param: SuperClass): SubClass { /* ... */ }
 
-  // 💥 Return type does not match, even though it is covariant
-  public method(param: any): string { /* ... */ }
+  // ✅ Property is readonly and override type is covariant
+  public readonly prop: SubClass;
 }
 ```
 
 ## Index Signatures
 
-**TypeScript** allows declaring _additional properties_ through the use of index signatures. These are however not
-supported by the _jsii type system_ and are rejected by the compiler.
+**TypeScript** allows declaring *additional properties* through the use of index signatures. These are however not
+supported by the *jsii type system* and are rejected by the compiler.
 
 !!! info
-    Version `1.x` of the compiler _silently ignores_ index signatures instead of reporting a compilation error. Users
+    Version `1.x` of the compiler *silently ignores* index signatures instead of reporting a compilation error. Users
     with offending APIs migrating from `[email protected]` to `[email protected]` or newer need to either remove those declarations, or
     explicitly ignore them using the [`@jsii ignore` tag](./hints.md#excluding-a-declaration-from-multi-language-support).
 

gh-pages/requirements-dev.txt

@@ -1,4 +1,4 @@
 mkdocs~=1.6.1
 mkdocs-awesome-pages-plugin~=2.10.1
-mkdocs-material~=9.6.20
+mkdocs-material~=9.6.22
 mkdocs-git-revision-date-plugin~=0.3.2

lerna.json

@@ -12,6 +12,6 @@
       "rejectCycles": true
     }
   },
-  "version": "1.116.0",
+  "version": "1.117.0",
   "$schema": "node_modules/lerna/schemas/lerna-schema.json"
 }

packages/@jsii/check-node/package.json

@@ -29,7 +29,7 @@
   "scripts": {
     "build": "tsc --build && yarn lint",
     "watch": "tsc --build -w",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false eslint . --ext .js,.ts --ignore-path=.gitignore",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false NODE_OPTIONS='--disable-warning=ESLintRCWarning' eslint . --ext .js,.ts --ignore-path=.gitignore",
     "lint:fix": "yarn lint --fix",
     "test": "jest",
     "test:update": "jest -u",

packages/@jsii/kernel/package.json

@@ -24,7 +24,7 @@
   "scripts": {
     "build": "tsc --build && yarn lint",
     "watch": "tsc --build -w",
-    "lint": "ESLINT_USE_FLAT_CONFIG=false eslint . --ext .js,.ts --ignore-path=.gitignore",
+    "lint": "ESLINT_USE_FLAT_CONFIG=false NODE_OPTIONS='--disable-warning=ESLintRCWarning' eslint . --ext .js,.ts --ignore-path=.gitignore",
     "lint:fix": "yarn lint --fix",
     "test": "jest",
     "test:update": "jest -u",

packages/@jsii/kernel/src/kernel.ts

@@ -14,6 +14,7 @@ import * as tar from './tar-cache';
 
 export const ASSEMBLY_SUPPORTED_FEATURES: spec.JsiiFeature[] = [
   'intersection-types',
+  'class-covariant-overrides',
 ];
 
 export const enum JsiiErrorType {