docs: remove --experimental-transform-types reference

[marco-ippolito]

Removed information about the --experimental-transform-types flag and its implications.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
nodejs-learn	Ready	Preview	Jun 3, 2026 1:04pm

[cursor]

PR Summary

Low Risk
Documentation-only edits with no runtime, API, or security impact.

Overview
Updates the Running TypeScript Natively guide to drop all mention of Node’s --experimental-transform-types flag, including the v22.7.0 intro, example command, and opt-in note.

In Constraints → Type stripping, guidance for syntax that needs code generation (e.g. enum, namespaces) no longer points readers at that flag—only at using a runner or separate transpilation.

^{Reviewed by Cursor Bugbot for commit 3a5f06c. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

👋 Codeowner Review Request

The following codeowners have been identified for the changed files:

Team reviewers: @nodejs/typescript

Please review the changes when you have a chance. Thank you! 🙏

[Copilot]

Pull request overview

This PR updates the TypeScript “run natively” documentation to remove mentions of Node.js’s --experimental-transform-types flag and adjust related guidance so the page no longer suggests that flag as an option.

Changes:

• Removed the section describing --experimental-transform-types and its implications.
• Updated the “Type stripping” constraints text to recommend using a runner or separate transpilation instead of the removed flag.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.