TypeScript 6.0の全貌 — 新機能・破壊的変更・移行ガイド

// tsconfig.json — 6.0で必要になる設定
{
  "compilerOptions": {
    "types": ["node", "jest"]  // 必要な@typesを明示
  }
}

// 5.9まで: rootDirがソースファイルから推論
dist/index.js
dist/utils.js

// 6.0: rootDirがtsconfig.jsonの位置（.）になる
dist/src/index.js    // srcディレクトリが挟まる
dist/src/utils.js

{
  "compilerOptions": {
    "rootDir": "./src"
  }
}

// Temporalで24時間前のInstantを取得
const yesterday = Temporal.Now.instant().subtract({ hours: 24 });

// タイムゾーンを意識した日時操作
const meeting = Temporal.ZonedDateTime.from({
  timeZone: "Asia/Tokyo",
  year: 2026,
  month: 4,
  day: 1,
  hour: 10,
  minute: 0,
});

// 期間の計算
const duration = Temporal.Duration.from({ hours: 1, minutes: 30 });

const cache = new Map<string, number[]>();

// 従来のパターン
if (!cache.has("users")) {
  cache.set("users", []);
}
cache.get("users")!.push(42);

// 6.0: getOrInsertで簡潔に
cache.getOrInsert("users", []).push(42);

// 計算が必要な場合
cache.getOrInsertComputed("stats", (key) => computeExpensiveStats(key));

function searchWholeWord(word: string, text: string): RegExpMatchArray | null {
  const escaped = RegExp.escape(word);  // 特殊文字を自動エスケープ
  const regex = new RegExp(`\\b${escaped}\\b`, "g");
  return text.match(regex);
}

// RegExp.escape("foo.bar") → "foo\.bar"
// RegExp.escape("(1+1)") → "\(1\+1\)"

declare function callIt<T>(obj: {
  produce: (x: number) => T;
  consume: (y: T) => void;
}): void;

// 5.9ではプロパティ順序によってTの推論が変わることがあった
// 6.0ではthisを使わないメソッドは推論で適切に処理される
callIt({
  consume(y) { y.toFixed(); },  // yはnumberと正しく推論
  produce(x) { return x * 2; },
});

// 廃止: assert構文
import data from "./data.json" assert { type: "json" };

// 6.0: with構文に移行
import data from "./data.json" with { type: "json" };

// 廃止: module キーワードによる名前空間
module MyApp {
  export function init() {}
}

// 6.0: namespace キーワードを使用
namespace MyApp {
  export function init() {}
}

// tsconfig.json — まず最低限これを追加
{
  "compilerOptions": {
    "types": ["node"],        // @typesの明示（プロジェクトに応じて追加）
    "rootDir": "./src"        // ソースディレクトリを明示
  }
}

// 移行前
{
  "compilerOptions": {
    "target": "es5",
    "module": "commonjs",
    "moduleResolution": "node",
    "baseUrl": ".",
    "paths": { "@app/*": ["src/app/*"] },
    "esModuleInterop": true,
    "downlevelIteration": true
  }
}

// 移行後
{
  "compilerOptions": {
    "target": "es2020",
    "module": "esnext",
    "moduleResolution": "bundler",
    "paths": { "@app/*": ["./src/app/*"] },
    "types": ["node"]
  }
}

# baseUrlの移行（pathsにインライン化）
npx @andrewbranch/ts5to6 --fixBaseUrl .

# rootDirの修正
npx @andrewbranch/ts5to6 --fixRootDir .

# 7.0ネイティブプレビューのインストール
npm install -D @typescript/native-preview

# 既存プロジェクトで試す
npx tsgo --project tsconfig.json