jsii 5.9.29-dev.0 → 5.9.29

package/README.md

@@ -65,8 +65,59 @@ The current status of `jsii` compiler releases is:
 | Release | Status      | EOS        | Comment                                                                                 |
 | ------- | ----------- | ---------- | --------------------------------------------------------------------------------------- |
 | `5.9.x` | Current     | TBD        | ![npm](https://img.shields.io/npm/v/jsii/v5.9-latest?label=jsii%40v5.9-latest&logo=npm) |
-| `5.8.x` | Maintenance | 2026-02-15 | ![npm](https://img.shields.io/npm/v/jsii/v5.8-latest?label=jsii%40v5.8-latest&logo=npm) |
-| `5.7.x` | Maintenance | 2025-09-15 | ![npm](https://img.shields.io/npm/v/jsii/v5.7-latest?label=jsii%40v5.7-latest&logo=npm) |
+| `5.8.x` | Unsupported | 2026-02-15 | ![npm](https://img.shields.io/npm/v/jsii/v5.8-latest?label=jsii%40v5.8-latest&logo=npm) |
+
+## :mute: Silencing Warnings
+
+The `--silence-warnings` option allows you to suppress specific warnings from the compiler output. Silenced warnings
+are still emitted internally (e.g. they are still part of the assembly), but are not printed to the console. When
+`--fail-on-warnings` (`--Werr`) is set, silenced warnings are not treated as errors.
+
+Warnings can be identified by JSII code, number, or diagnostic name:
+
+```sh
+# By full JSII code
+jsii --silence-warnings JSII5018
+
+# By number only
+jsii --silence-warnings 5018
+
+# By specific diagnostic name (the part after the slash)
+jsii --silence-warnings reserved-word
+
+# By full diagnostic name
+jsii --silence-warnings language-compatibility/reserved-word
+
+# By category (silences ALL warnings in that category)
+jsii --silence-warnings language-compatibility
+
+# Multiple warnings
+jsii --silence-warnings reserved-word JSII5019
+```
+
+### Inline Suppression
+
+Individual warnings can be suppressed directly in source code using the `@jsii suppress` directive. This is useful
+when you want `--fail-on-warnings` enabled globally but need to allow specific instances of a warning.
+
+Each directive accepts a single warning identifier using the same formats as `--silence-warnings`. An optional text after
+the identifier is treated as an explanation comment. Use multiple directives to suppress multiple warnings:
+
+```ts
+export class MyClass {
+  /**
+   * @jsii suppress JSII5019 this name is intentional
+   * @jsii suppress reserved-word
+   */
+  public myClass(): void { }
+}
+```
+
+The suppression applies to the annotated declaration and all of its members. For example, a `@jsii suppress`
+directive on a class will suppress matching warnings on all methods and properties within that class.
+
+Only warnings that reference a source code location can be suppressed inline. Warnings not tied to a specific node
+(e.g. `JSII0003` for a missing README) are not affected.
 
 ## :balance_scale: License
 

package/lib/assembler.js

@@ -30,7 +30,6 @@ const type_visitor_1 = require("./type-visitor");
 const utils_2 = require("./utils");
 const validator_1 = require("./validator");
 const version_1 = require("./version");
-const warnings_1 = require("./warnings");
 // eslint-disable-next-line @typescript-eslint/no-var-requires, @typescript-eslint/no-require-imports
 const sortJson = require('sort-json');
 const LOG = log4js.getLogger('jsii/assembler');
@@ -1488,9 +1487,6 @@ class Assembler {
         type.methods.push(method);
     }
     _warnAboutReservedWords(symbol) {
-        if (!warnings_1.enabledWarnings['reserved-word']) {
-            return;
-        }
         const reservingLanguages = (0, reserved_words_1.isReservedName)(symbol.name);
         if (reservingLanguages) {
             this._diagnostics.push(jsii_diagnostic_1.JsiiDiagnostic.JSII_5018_RESERVED_WORD.create(_nameOrDeclarationNode(symbol), symbol.name, reservingLanguages));