feat(cli): Update chokidar to v5 (#122)

This update resolves peer dependency conflicts in repositories that use
both @swc/cli and Angular, as Angular now uses chokidar v5.

BREAKING CHANGE: Minimum Node.js version bumped from 16.14.0 to 20.19.0
to match chokidar v5's requirements.

Changes:
- Update chokidar from ^4.0.1 to ^5.0.0 in devDependencies and
peerDependencies
- Add local type declarations for chokidar to support Node.js 20.19+
  (chokidar v5 types use Node.js 22+ generic EventEmitter)
- Add skipLibCheck to tsconfig.json for type compatibility
- Add explicit FSWatcher return type to watchSources function

---------

Co-authored-by: Donny/강동윤 <kdy.1997.dev@gmail.com>

Author: Coly010

.changeset/stupid-lobsters-film.md

@@ -0,0 +1,5 @@
+---
+"@swc/cli": minor
+---
+
+feat(cli): Update chokidar to v5

.changeset/wise-otters-grow.md

@@ -0,0 +1,5 @@
+---
+"@swc/cli": patch
+---
+
+feat(cli): Update chokidar to v5

packages/cli/package.json

@@ -37,7 +37,7 @@
     },
     "homepage": "https://github.com/swc-project/pkgs",
     "engines": {
-        "node": ">= 16.14.0"
+        "node": ">= 20.19.0"
     },
     "bin": {
         "swc": "./bin/swc.js",
@@ -63,15 +63,15 @@
         "@types/jest": "^29.5.0",
         "@types/node": "^20.11.5",
         "@types/semver": "^7.3.13",
-        "chokidar": "^4.0.1",
+        "chokidar": "^5.0.0",
         "deepmerge": "^4.2.2",
         "jest": "^29.5.0",
         "ts-jest": "^29.0.5",
         "typescript": "~5.8.3"
     },
     "peerDependencies": {
         "@swc/core": "^1.2.66",
-        "chokidar": "^4.0.1"
+        "chokidar": "^5.0.0"
     },
     "peerDependenciesMeta": {
         "chokidar": {

packages/cli/src/swc/chokidar.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Local type declarations for chokidar v5.
+ *
+ * Chokidar v5's FSWatcher extends EventEmitter<T> which requires Node.js 22+ types.
+ * Since we support Node.js 20.19+, we provide a simplified type interface here
+ * that describes the subset of the API we actually use.
+ */
+declare module "chokidar" {
+    import { Stats } from "fs";
+
+    export type AWF = {
+        stabilityThreshold: number;
+        pollInterval: number;
+    };
+
+    export type MatchFunction = (val: string, stats?: Stats) => boolean;
+
+    export interface MatcherObject {
+        path: string;
+        recursive?: boolean;
+    }
+
+    export type Matcher = string | RegExp | MatchFunction | MatcherObject;
+
+    export type ChokidarOptions = {
+        persistent?: boolean;
+        ignoreInitial?: boolean;
+        followSymlinks?: boolean;
+        cwd?: string;
+        usePolling?: boolean;
+        interval?: number;
+        binaryInterval?: number;
+        alwaysStat?: boolean;
+        depth?: number;
+        ignorePermissionErrors?: boolean;
+        atomic?: boolean | number;
+        ignored?: Matcher | Matcher[];
+        awaitWriteFinish?: boolean | Partial<AWF>;
+    };
+
+    export type EmitArgs = [string, Stats?];
+
+    export interface FSWatcher {
+        on(event: "ready", listener: () => void): this;
+        on(event: "add" | "change" | "unlink", listener: (path: string, stats?: Stats) => void): this;
+        on(event: "addDir" | "unlinkDir", listener: (path: string, stats?: Stats) => void): this;
+        on(event: "error", listener: (error: Error) => void): this;
+        on(event: "all", listener: (eventName: string, path: string, stats?: Stats) => void): this;
+        on(event: "raw", listener: (eventName: string, path: string, details: any) => void): this;
+        on(event: string, listener: (...args: any[]) => void): this;
+        add(paths: string | string[]): this;
+        unwatch(paths: string | string[]): this;
+        close(): Promise<void>;
+        getWatched(): Record<string, string[]>;
+    }
+
+    export function watch(paths: string | string[], options?: ChokidarOptions): FSWatcher;
+
+    const _default: {
+        watch: typeof watch;
+        FSWatcher: new (options?: ChokidarOptions) => FSWatcher;
+    };
+
+    export default _default;
+}

packages/cli/src/swc/sources.ts

@@ -4,6 +4,8 @@ import { stat } from "fs";
 import { join, basename, extname } from "path";
 import { minimatch } from "minimatch";
 
+import type { FSWatcher } from "chokidar";
+
 /**
  * Find all input files based on source globs
  */
@@ -112,7 +114,7 @@ export async function watchSources(
     includeDotfiles = false,
     only: string[] = [],
     ignore: string[] = []
-) {
+): Promise<FSWatcher> {
     const chokidar = await requireChokidar();
     return chokidar.watch(sources, {
         ignored: (filename: string) => {

packages/cli/tsconfig.json

@@ -3,6 +3,7 @@
         "target": "es2019",
         "module": "commonjs",
         "strict": true,
+        "skipLibCheck": true,
         "noUnusedLocals": true,
         "noUnusedParameters": true,
         "noImplicitReturns": true,