ts6to7 0.1.1 → 0.2.0

package/README.md

@@ -3,7 +3,7 @@
 [![CI](https://github.com/zi-gae/ts6to7/actions/workflows/ci.yml/badge.svg)](https://github.com/zi-gae/ts6to7/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/ts6to7)](https://www.npmjs.com/package/ts6to7)
 
-Codemod that migrates a **TypeScript 6** project to **TypeScript 7 (tsgo)**.
+Codemod that migrates a **TypeScript 5 or 6** project to **TypeScript 7 (tsgo)**.
 No install needed — try it in 10 seconds:
 
 ```bash
@@ -13,9 +13,11 @@ npx ts6to7 --dry
 ![ts6to7 rewriting a legacy tsconfig for TypeScript 7](https://raw.githubusercontent.com/zi-gae/ts6to7/main/docs/demo.gif)
 
 TypeScript 7 is the native (Go) rewrite of the compiler. It removes every option
-that TypeScript 6 marked as deprecated and flips some defaults. This tool
-rewrites your config files to the TS7 equivalents and prints a checklist of the
-things it cannot safely change for you.
+that TypeScript 5 and 6 marked as deprecated and flips some defaults. Almost all
+of the removed options date back to the TS 5.0 deprecation list, so migrating
+straight from 5.x works the same as from 6.x — this tool rewrites your config
+files to the TS7 equivalents and prints a checklist of the things it cannot
+safely change for you.
 
 ## Usage
 
@@ -41,7 +43,7 @@ npx tsc --noEmit     # fix any remaining errors it reports
 
 ### `tsconfig*.json` (comments and formatting are preserved)
 
-| Before (TS6) | After (TS7) |
+| Before (TS 5/6) | After (TS7) |
 | --- | --- |
 | `"target": "es3"` / `"es5"` | `"ES2015"` — ES5 output was removed |
 | `"module": "amd"` / `"umd"` / `"system"` / `"none"` | `"ESNext"` |
@@ -49,6 +51,8 @@ npx tsc --noEmit     # fix any remaining errors it reports
 | `"importsNotUsedAsValues"`, `"preserveValueImports"` | `"verbatimModuleSyntax": true` |
 | `"baseUrl"` | folded into `"paths"` (mappings become tsconfig-relative) |
 | `charset`, `keyofStringsOnly`, `out`, `noImplicitUseStrict`, `noStrictGenericChecks`, `suppressExcessPropertyErrors`, `suppressImplicitAnyIndexErrors` | removed |
+| `"ignoreDeprecations": "5.0"` (the TS5 escape hatch) | removed — the options it silenced no longer exist |
+| `"prepend": true` in project `references` | removed — output prepending is gone since TS6 |
 | `strict` unset | pinned to `false` to preserve behavior (TS7 defaults to `true`) — delete it when you're ready |
 
 ### `package.json`
@@ -73,6 +77,14 @@ npx tsc --noEmit     # fix any remaining errors it reports
 Everything in this list is also printed as a `Needs manual review` item when
 the codemod runs, scoped to the file that triggered it.
 
+## Coming from TypeScript 5?
+
+You don't need to stop at 6 first — run the codemod directly on a 5.x project.
+The transforms match on option values, not on your current compiler version:
+`typescript: "^5.x"` is bumped straight to `^7.0.0`, TS5-era escape hatches
+like `"ignoreDeprecations": "5.0"` are cleaned up, and `prepend` in project
+references (already gone in TS6) is removed too.
+
 ## Development
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts6to7",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/zi-gae/ts6to7.git"
@@ -9,7 +9,7 @@
   "bugs": {
     "url": "https://github.com/zi-gae/ts6to7/issues"
   },
-  "description": "Codemod that migrates a TypeScript 6 project to TypeScript 7 (tsgo): rewrites tsconfig.json options removed in TS7 and flags changes that need manual review.",
+  "description": "Codemod that migrates a TypeScript 5 or 6 project to TypeScript 7 (tsgo): rewrites tsconfig.json options removed in TS7 and flags changes that need manual review.",
   "type": "module",
   "bin": {
     "ts6to7": "bin/ts6to7.js"
@@ -29,7 +29,9 @@
     "codemod",
     "migration",
     "tsgo",
-    "typescript-7"
+    "typescript-7",
+    "typescript-5",
+    "ts5to7"
   ],
   "dependencies": {
     "jsonc-parser": "^3.3.1"

package/src/cli.js

@@ -10,7 +10,7 @@ const green = (s) => (tty ? `\x1b[32m${s}\x1b[0m` : s);
 const yellow = (s) => (tty ? `\x1b[33m${s}\x1b[0m` : s);
 const dim = (s) => (tty ? `\x1b[2m${s}\x1b[0m` : s);
 
-const HELP = `ts6to7 — migrate a TypeScript 6 project to TypeScript 7 (tsgo)
+const HELP = `ts6to7 — migrate a TypeScript 5 or 6 project to TypeScript 7 (tsgo)
 
 Usage:
   npx ts6to7 [directory] [options]
@@ -26,13 +26,16 @@ What it does:
     - moduleResolution node10/classic -> NodeNext or Bundler
     - importsNotUsedAsValues / preserveValueImports -> verbatimModuleSyntax
     - baseUrl                   -> folded into "paths" (removed in TS7)
-    - removes charset, keyofStringsOnly, out, noImplicitUseStrict, ...
+    - removes charset, keyofStringsOnly, out, ignoreDeprecations, ...
+    - removes "prepend" from project references (gone since TS6)
     - pins strict: false if unset (TS7 defaults strict to true)
   package.json
     - typescript dependency     -> ^7.0.0
     - warns about compiler-API tools (ts-node, ts-patch, ts-jest, ...)
 `;
 
+const KNOWN_FLAGS = new Set(['--dry', '-d', '--help', '-h']);
+
 export async function run(argv) {
   const args = [...argv];
   const dry = args.includes('--dry') || args.includes('-d');
@@ -40,6 +43,13 @@ export async function run(argv) {
     console.log(HELP);
     return 0;
   }
+  // A typo like --dr must not silently run in write mode.
+  const unknown = args.find((a) => a.startsWith('-') && !KNOWN_FLAGS.has(a));
+  if (unknown) {
+    console.error(`Unknown option: ${unknown}\n`);
+    console.log(HELP);
+    return 1;
+  }
   const dirArg = args.find((a) => !a.startsWith('-'));
   const root = resolve(process.cwd(), dirArg ?? '.');
 

package/src/transform-package-json.js

@@ -8,8 +8,9 @@ const API_DEPENDENT = ['ts-patch', 'ttypescript', 'ts-node', 'ts-loader', 'ts-je
 const DEP_FIELDS = ['dependencies', 'devDependencies'];
 
 function majorOf(range) {
-  const m = String(range).match(/(\d+)\./);
-  return m ? Number(m[1]) : null;
+  // First integer in the range: handles "^6.2.0", "~6.0", ">=6", "6", "workspace:^6".
+  const m = String(range).match(/\d+/);
+  return m ? Number(m[0]) : null;
 }
 
 /**
@@ -22,6 +23,7 @@ export function transformPackageJson(text) {
   let result = text;
 
   const json = parse(text) ?? {};
+  const warnedTools = new Set();
 
   for (const field of DEP_FIELDS) {
     const deps = json[field];
@@ -36,7 +38,8 @@ export function transformPackageJson(text) {
     }
 
     for (const name of API_DEPENDENT) {
-      if (deps[name]) {
+      if (deps[name] && !warnedTools.has(name)) {
+        warnedTools.add(name);
         warnings.push(
           `"${name}" uses the TypeScript compiler API, which tsgo does not expose in 7.0 ` +
             '(a new API ships with 7.1). Check that your version supports TS7 or find an alternative.',
@@ -45,5 +48,17 @@ export function transformPackageJson(text) {
     }
   }
 
+  // Peer ranges are a compatibility statement — widen manually, don't auto-bump.
+  const peerTs = json.peerDependencies?.typescript;
+  if (typeof peerTs === 'string') {
+    const major = majorOf(peerTs);
+    if (major !== null && major < 7) {
+      warnings.push(
+        `peerDependencies.typescript ("${peerTs}") does not allow 7.x — widen the range ` +
+          'manually (e.g. "^6.0.0 || ^7.0.0") so consumers on TS7 can install this package.',
+      );
+    }
+  }
+
   return { text: result, changes, warnings };
 }

package/src/transform-tsconfig.js

@@ -14,6 +14,7 @@ const REMOVED_OPTIONS = {
   suppressExcessPropertyErrors: null,
   suppressImplicitAnyIndexErrors: null,
   out: 'use "outFile" instead if you relied on single-file output',
+  ignoreDeprecations: 'the deprecated options it silenced are gone, so the flag has no meaning',
 };
 
 function lower(value) {
@@ -39,6 +40,27 @@ export function transformTsconfig(text) {
   let result = text;
 
   const json = parse(text) ?? {};
+
+  // --- references[].prepend: deprecated in TS 5.5, gone since TS6 ----------
+  // Handled before the compilerOptions guard: solution-style tsconfigs have
+  // references but no compilerOptions.
+  if (Array.isArray(json.references)) {
+    let prepends = 0;
+    json.references.forEach((ref, i) => {
+      if (ref && typeof ref === 'object' && Object.prototype.hasOwnProperty.call(ref, 'prepend')) {
+        result = applyEdits(result, modify(result, ['references', i, 'prepend'], undefined, FORMAT));
+        prepends += 1;
+      }
+    });
+    if (prepends > 0) {
+      changes.push(`removed "prepend" from ${prepends} project reference(s) (option no longer exists in TS7)`);
+      warnings.push(
+        'Project references no longer prepend referenced output. If you relied on prepend to ' +
+          'concatenate outputs, switch to a bundler or explicit outFile ordering.',
+      );
+    }
+  }
+
   const co = json.compilerOptions;
   if (typeof co !== 'object' || co === null) {
     return { text: result, changes, warnings };
@@ -152,12 +174,21 @@ export function transformTsconfig(text) {
 
   // --- strict becomes the default in TS7 -----------------------------------
   if (!Object.prototype.hasOwnProperty.call(co, 'strict')) {
-    edit('strict', false);
-    changes.push('added explicit strict: false (TS7 flips the default to true)');
-    warnings.push(
-      'strict: false was added to preserve current behavior. Consider deleting it and fixing ' +
-        'strict-mode errors instead — TS7 projects are strict by default.',
-    );
+    // An extending config may inherit strict from its base; pinning false here
+    // would override the base and change behavior.
+    if (json.extends !== undefined) {
+      warnings.push(
+        'strict is not set here and this config extends another. TS7 defaults strict to true — ' +
+          'make sure the extended chain sets it explicitly, or add strict yourself.',
+      );
+    } else {
+      edit('strict', false);
+      changes.push('added explicit strict: false (TS7 flips the default to true)');
+      warnings.push(
+        'strict: false was added to preserve current behavior. Consider deleting it and fixing ' +
+          'strict-mode errors instead — TS7 projects are strict by default.',
+      );
+    }
   }
 
   // --- types auto-inclusion behavior change (report only) -------------------