How to fix The current host does not support the 'watchFile' option with value 'useFsEvents' in TypeScript

{
  "watchOptions": {
    "watchFile": "priorityPollingInterval",
    "watchDirectory": "dynamicPriorityPolling",
    "excludeDirectories": ["**/node_modules", "**/.git"]
  }
}

// tsconfig.base.json - shared settings
{
  "compilerOptions": {
    "target": "es2020",
    "module": "commonjs"
  }
}

// tsconfig.macos.json - macOS-specific
{
  "extends": "./tsconfig.base.json",
  "watchOptions": {
    "watchFile": "useFsEvents",
    "watchDirectory": "useFsEvents"
  }
}

// tsconfig.linux.json - Linux/Windows
{
  "extends": "./tsconfig.base.json",
  "watchOptions": {
    "watchFile": "priorityPollingInterval",
    "watchDirectory": "dynamicPriorityPolling"
  }
}

# On macOS
npx tsc --watch -p tsconfig.macos.json

# On Linux/Windows
npx tsc --watch -p tsconfig.linux.json

// Before (causing error on Linux):
{
  "watchOptions": {
    "watchFile": "useFsEvents"
  }
}

// After (let TypeScript decide):
{
  "watchOptions": {
    // TypeScript will choose appropriate default
  }
}

# Check current Node.js version
node --version

# Update using nvm (Node Version Manager)
nvm install 18  # or 20, 22
nvm use 18

# Or update globally
# On macOS with Homebrew:
brew update
brew upgrade node

# On Ubuntu/Debian:
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# On Windows:
# Download from https://nodejs.org/

npx tsc --version
npx tsc --watch

# Dockerfile
FROM node:18-alpine

# Install dependencies
COPY package*.json ./
RUN npm ci

# Copy TypeScript config (platform-agnostic)
COPY tsconfig.json .

# Use cross-platform watch options
# tsconfig.json should NOT contain useFsEvents

// tsconfig.json for Docker/Linux
{
  "compilerOptions": {
    "target": "es2020",
    "module": "commonjs",
    "outDir": "./dist"
  },
  "watchOptions": {
    "watchFile": "priorityPollingInterval",
    "watchDirectory": "dynamicPriorityPolling",
    "excludeDirectories": ["**/node_modules"]
  }
}

version: '3.8'
services:
  app:
    build: .
    volumes:
      - .:/app
      - /app/node_modules
    command: npx tsc --watch
    environment:
      - NODE_ENV=development

# Shell script to detect platform
#!/bin/bash
detect_platform() {
  case "$(uname -s)" in
    Darwin*) echo "macos" ;;
    Linux*) echo "linux" ;;
    CYGWIN*|MINGW*|MSYS*) echo "windows" ;;
    *) echo "unknown" ;;
  esac
}

PLATFORM=$(detect_platform)
echo "Building for $PLATFORM"

if [ "$PLATFORM" = "macos" ]; then
  npx tsc --watch -p tsconfig.macos.json
else
  npx tsc --watch -p tsconfig.linux.json
fi

# .github/workflows/build.yml (simplified example)
# Use different TypeScript configs based on runner OS
if [ "$RUNNER_OS" == "macOS" ]; then
  npx tsc -p tsconfig.macos.json
else
  npx tsc -p tsconfig.linux.json
fi