doc: update decorator documentation to reflect actual policy

salman-aziz-4425 · aduh95 · commit 3a64383b8a5c · 2025-10-31T22:26:18.000+01:00
- Remove misleading 'soon' language - Remove 'temporary limitation' claim - Clarify that Node.js will not provide polyfills - Wait for native JavaScript engine support Refs: #60282 PR-URL: #60288 Reviewed-By: Marco Ippolito <marcoippolito54@gmail.com> Reviewed-By: Jacob Smith <jacob@frende.me> Reviewed-By: Richard Lau <richard.lau@ibm.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Geoffrey Booth <webadmin@geoffreybooth.com>
diff --git a/doc/api/typescript.md b/doc/api/typescript.md
@@ -154,10 +154,10 @@ namespace A {
 }
 ```
 
-Since Decorators are currently a [TC39 Stage 3 proposal](https://github.com/tc39/proposal-decorators)
-and will soon be supported by the JavaScript engine,
+Since Decorators are currently a [TC39 Stage 3 proposal](https://github.com/tc39/proposal-decorators),
 they are not transformed and will result in a parser error.
-This is a temporary limitation and will be resolved in the future.
+Node.js does not provide polyfills and thus will not support decorators until
+they are supported natively in JavaScript.
 
 In addition, Node.js does not read `tsconfig.json` files and does not support
 features that depend on settings within `tsconfig.json`, such as paths or
