chore(release): 1.92.0 (#4336)

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

Author: mergify[bot]

.github/workflows/docker-images.yml

@@ -22,16 +22,15 @@ jobs:
       fail-fast: false
       matrix:
         debian:
-          - 'buster'   # 10
-        node: ['16', '18', '20']
+          - 'buster' # 10
+          - 'bullseye' # 11
+        node: ['18', '20']
         include:
-          - debian: 'bullseye' # 11
-            node: '20'
           - debian: 'bookworm' #12
             node: '20'
     env:
       # Node version whose images will be aliased without the -nodeXX segment
-      DEFAULT_NODE_MAJOR_VERSION: 16
+      DEFAULT_NODE_MAJOR_VERSION: 18
     steps:
       - name: Check out
         uses: actions/checkout@v4

.github/workflows/main.yml

@@ -42,15 +42,15 @@ jobs:
         with:
           distribution: 'zulu'
           java-version: '8'
-      - name: Set up Node 16
+      - name: Set up Node 18
         uses: actions/setup-node@v4
         with:
           cache: yarn
-          node-version: '16'
-      - name: Set up Python 3.7
+          node-version: '18'
+      - name: Set up Python 3.8
         uses: actions/setup-python@v4
         with:
-          python-version: '3.7'
+          python-version: '3.8'
           cache: pip
       - name: Install python3-venv
         run: sudo apt install -y python3-venv
@@ -125,15 +125,15 @@ jobs:
         with:
           distribution: 'zulu'
           java-version: '8'
-      - name: Set up Node 16
+      - name: Set up Node 18
         uses: actions/setup-node@v4
         with:
           cache: yarn
-          node-version: '16'
-      - name: Set up Python 3.7
+          node-version: '18'
+      - name: Set up Python 3.8
         uses: actions/setup-python@v4
         with:
-          python-version: '3.7'
+          python-version: '3.8'
           cache: pip
       - name: Install python3-venv
         run: sudo apt install -y python3-venv
@@ -195,101 +195,94 @@ jobs:
         dotnet: ['6.0.x']
         go: ['1.18']
         java: ['8']
-        node: ['16'] # EOL 2023-09-11
+        node: ['18'] # EOL 2025-04-30
         os: [ubuntu-latest]
-        python: ['3.7']
-        # Add specific combinations to be tested against "node 14" (to restrict cardinality)
+        python: ['3.8']
+        # Add specific combinations to be tested against (to restrict cardinality)
         include:
           # Test using Windows
           - title: 'Windows'
             os: windows-latest
             dotnet: '6.0.x'
             go: '1.18'
             java: '8'
-            node: '16'
-            python: '3.7'
+            node: '18'
+            python: '3.8'
           # Test using macOS
           - title: 'macOS'
             os: macos-latest
             dotnet: '6.0.x'
             go: '1.18'
             java: '8'
-            node: '16'
-            python: '3.7'
+            node: '18'
+            python: '3.8'
           # Test alternate Nodes
-          - title: 'Node 16'
-            java: '8'
-            dotnet: '6.0.x'
-            go: '1.18'
-            node: '16' # EOL 2023-09-11
-            os: ubuntu-latest
-            python: '3.7'
           - title: 'Node 18'
             java: '8'
             dotnet: '6.0.x'
             go: '1.18'
             node: '18' # EOL 2025-04-30
             os: ubuntu-latest
-            python: '3.7'
+            python: '3.8'
           - title: 'Node 20'
             java: '8'
             dotnet: '6.0.x'
             go: '1.18'
             node: '20' # EOL 2026-04-30
             os: ubuntu-latest
-            python: '3.7'
+            python: '3.8'
           # Test alternate .NETs
           - title: '.NET 7.0'
             java: '8'
             dotnet: '7.0.x'
             go: '1.18'
-            node: '16'
+            node: '18'
             os: ubuntu-latest
-            python: '3.7'
+            python: '3.8'
           # Test alternate Gos
           - title: 'Go 1.19'
             java: '8'
             dotnet: '6.0.x'
             go: '1.19'
-            node: '16'
+            node: '18'
             os: ubuntu-latest
-            python: '3.7'
+            python: '3.8'
           # Test alternate Javas
           - title: 'Java 11'
             java: '11'
             dotnet: '6.0.x'
             go: '1.18'
-            node: '16'
+            node: '18'
             os: ubuntu-latest
-            python: '3.7'
+            python: '3.8'
           # Test alternate Pythons
           - title: 'Python 3.8'
             python: '3.8'
             dotnet: '6.0.x'
             go: '1.18'
             java: '8'
-            node: '16'
+            node: '18'
             os: ubuntu-latest
           - title: 'Python 3.9'
             python: '3.9'
             dotnet: '6.0.x'
             go: '1.18'
             java: '8'
-            node: '16'
+            node: '18'
             os: ubuntu-latest
           - title: 'Python 3.10'
             python: '3.10'
             dotnet: '6.0.x'
             go: '1.18'
             java: '8'
-            node: '16'
+            node: '18'
             os: ubuntu-latest
           - title: 'Python 3.11'
             python: '3.11'
             dotnet: '6.0.x'
             go: '1.18'
             java: '8'
-            node: '16'
+            node: '18'
             os: ubuntu-latest
 
     runs-on: ${{ matrix.os }}
@@ -479,4 +472,3 @@ jobs:
         with:
           name: integtest_aws-cdk-lib
           path: ./node_modules/aws-cdk-lib/dist/
-

CHANGELOG.md

@@ -2,6 +2,28 @@
 
 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.92.0](https://github.com/aws/jsii/compare/v1.91.0...v1.92.0) (2023-11-16)
+
+
+### ⚠ BREAKING CHANGES
+
+* jsii-pacmak and the libraries it generates for Python targets now require a minimum Python version of 3.8, instead of 3.7 previously. We recommend users upgrade to the latest supported Python release (Python 3.11).
+* all libraries and tools now require a minimum version of Node.js 18, instead of 16 previously. We recommend users upgrade to the latest supported Node.js release (Node.js 20).
+
+### Features
+
+* **jsii-reflect:** TypeSystem can be locked to improve reflection performance ([#4318](https://github.com/aws/jsii/issues/4318)) ([c87da43](https://github.com/aws/jsii/commit/c87da436671d677d1fee276d0932ea7edd431f78))
+* make node 18 the default ([#4325](https://github.com/aws/jsii/issues/4325)) ([8784725](https://github.com/aws/jsii/commit/87847254c8a39f6e99383bfa3a375ae6c8d9a8a5))
+* **superchain:** publish a bullseye image with node18 & python 3.9 ([#4326](https://github.com/aws/jsii/issues/4326)) ([7197b4f](https://github.com/aws/jsii/commit/7197b4f21e7f6776fbbfe5bac7f03a308cd9f7c0))
+* switch to python 3.8 ([#4327](https://github.com/aws/jsii/issues/4327)) ([416e2b5](https://github.com/aws/jsii/commit/416e2b504895800281a3598b3139b141330aa906))
+
+
+### Bug Fixes
+
+* **kernel:** invokeBinScript fails when using symlinked cache ([#4324](https://github.com/aws/jsii/issues/4324)) ([a2ab316](https://github.com/aws/jsii/commit/a2ab31609d361ac5ceca6c928584ec59f2d705d3))
+* **pacmak:** *.tsbuildinfo not in auto-generated .npmignore file ([#4236](https://github.com/aws/jsii/issues/4236)) ([d55b8d5](https://github.com/aws/jsii/commit/d55b8d57ce43dc9fd3d5132d7ba3ad0aa9ead3b9)), closes [#3978](https://github.com/aws/jsii/issues/3978)
+* **superchain:** installed setuptools is an unsupported version ([#4333](https://github.com/aws/jsii/issues/4333)) ([c0a4140](https://github.com/aws/jsii/commit/c0a41409568bc71b086fd1c56e2c5a08f708c3ad))
+
 ## [1.91.0](https://github.com/aws/jsii/compare/v1.90.0...v1.91.0) (2023-10-24)
 
 ## [1.90.0](https://github.com/aws/jsii/compare/v1.89.0...v1.90.0) (2023-10-06)

CONTRIBUTING.md

@@ -45,7 +45,7 @@ in your development environment.
   + [`maven >= 3.0.5`](https://maven.apache.org)
 - [.NET `6.0`] or later
   + *Recommended:* [`mono >= 6`](https://www.mono-project.com)
-- [Python `3.7.3`] or later
+- [Python `3.8.10`] or later
   + [`pip`](https://pip.pypa.io/en/stable/installing/)
   + [`setuptools >= 38.6.0`](https://pypi.org/project/setuptools/)
   + [`wheel`](https://pypi.org/project/wheel/)
@@ -57,7 +57,7 @@ in your development environment.
 [Oracle's OpenJDK8]: http://openjdk.java.net/install/
 [Amazon Corretto 8]: https://aws.amazon.com/corretto/
 [.NET `6.0`]: https://www.microsoft.com/net/download
-[Python `3.7.3`]: https://www.python.org/downloads/release/python-373/
+[Python `3.8.10`]: https://www.python.org/downloads/release/python-3810/
 [Go]: https://go.dev/dl/
 
 ## Getting Started
@@ -228,13 +228,14 @@ The [Python](./packages/jsii-pacmak/lib/targets/python.ts) target is a good
 example to work from.
 
 ## Releasing
+
 ### The `public.ecr.aws/jsii/superchain` Docker image
 
-Upon merging new changes to the `main` branch, the `public.ecr.aws/jsii/superchain:1-buster-slim-nightly`
+Upon merging new changes to the `main` branch, the `public.ecr.aws/jsii/superchain:1-bullseye-slim-nightly`
 image will be released after a last validation build.
 
 Upon making a new `jsii` release (when the GitHub release entry - and its
-corresponding git tag - is created), the `public.ecr.aws/jsii/superchain:1-buster-slim` image will
+corresponding git tag - is created), the `public.ecr.aws/jsii/superchain:1-bullseye-slim` image will
 be released after a last validation build.
 
 The latest release information (for both of the Docker image tags) can be seen

gh-pages/content/user-guides/language-support/index.md

@@ -69,7 +69,7 @@ in significant re-engineering effort:
   - How are dependencies modeled? If [semantic versioning] is not the norm, what is the strategy to correctly represent
     semantic version ranges?
 - What are the toolchain and platform requirements?
-  - For example, **Java** requires an OpenJDK 8 distribution and `maven`, **Python** requires `python` 3.7 or above,
+  - For example, **Java** requires an OpenJDK 8 distribution and `maven`, **Python** requires `python` 3.8 or above,
     etc...
 
 ## Code Generation

gh-pages/content/user-guides/lib-author/configuration/targets/python.md

@@ -16,7 +16,6 @@ The `python` target requires two configuration entries:
   - Additionally, the following `Programming Language ::` classifiers are already set (more could be added by the user
     if relevant):
     - `Programming Language :: Python :: 3 :: Only`
-    - `Programming Language :: Python :: 3.7`
     - `Programming Language :: Python :: 3.8`
     - `Programming Language :: Python :: 3.9`
     - `Programming Language :: Python :: 3.10`

gh-pages/content/user-guides/lib-author/index.md

@@ -19,7 +19,7 @@ to produce releasable artifacts.
 | .NET              | .NET ≥ 6.0                   |
 | Go                | Go ≥ 1.18                    |
 | Java              | JDK ≥ 8 *and* Maven ≥ 3.6    |
-| Python            | Python ≥ 3.7                 |
+| Python            | Python ≥ 3.8                 |
 
 
 ## :octicons-desktop-download-24: Download Locations

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

@@ -14,10 +14,14 @@ A *jsii module* can declare dependencies on any other *jsii module* by adding en
 `package.json` file. Since most other platforms do not support multiple different versions of the same library to
 coexist in the same closure, it is recommended to also declare all such dependencies as `peerDependencies`.
 
+### non-jsii dependencies
+
 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`. The API of the *jsii module* can not expose any type from bundled
-dependencies, since those types would not be available in other languages.
+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.
 
 !!! info
     For more information on `package.json` file contents, refer to the [npm documentation][package-json].

gh-pages/mkdocs.yml

@@ -58,8 +58,8 @@ markdown_extensions:
   - pymdownx.superfences
   - pymdownx.tabbed
   - pymdownx.emoji:
-      emoji_index: !!python/name:materialx.emoji.twemoji
-      emoji_generator: !!python/name:materialx.emoji.to_svg
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
 
 plugins:
   - awesome-pages:

gh-pages/requirements-dev.txt

@@ -1,4 +1,4 @@
 mkdocs~=1.5.3
 mkdocs-awesome-pages-plugin~=2.9.2
-mkdocs-material~=9.4.6
+mkdocs-material~=9.4.8
 mkdocs-git-revision-date-plugin~=0.3.2