npm install --save-dev typescript

Работу самого компилятора TypeScript можно настроить, для этого нам потребуется конфигурационный файл с настройками.
В этом нам поможет утилита tsc:

./node_modules/.bin/tsc --init

После выполнения команды в корне проекта должен появиться файл tsconfig.json:

Расширения файлов следующее .ts.

Далее я предоставлю структуру простого проекта. Все файлы исходного кода находятся в папке src и написаны на TypeScript.

Файлы сборки находиться в папке dist.

Проект
  |--dist
  |   |--index.js
  |   |--index.html
  |   |--user
  |   |   |--name.js
  |   |   |--photo.jpg
  |--src
  |   |--index.ts
  |   |--index.html
  |   |--user
  |   |   |--name.ts
  |   |   |--photo.jpg
  |--package.json 

Обратим теперь свое внимание на файл package.json, разберем нюанс.

Внутри есть параметр main — это точка входа нашего приложения. Если мы используем TypeScript, то в этом параметре требуется указать путь к скомпилированному файлу.

Пример конфигурации:

{
  "name": "my-project",
  "version": "1.0.0",
  "main": "dist/index.js",  // путь к скомпилированному файлу
  "scripts": {
    "build": "tsc",         // команда для компиляции TypeScript
    "start": "node dist/index.js"
  },
  "devDependencies": {
    "typescript": "^5.9.2"
  }
}

Запускаем TypeScript

Далее для запуска серверного TypeScript в режиме разработки может быть полезен инструмент ts-node. Этот пакет объединяет сборку через tsc и запуск с помощью Node.JS.

Так можно миновать компиляцию проекта в dist и запустить его напрямую.

Для запуска серверного TypeScript в режиме разработки можем использовать инструмент ts-node, данный пакет объединяет сборку через tsc и запускается при помощи node.js.

Давайте установим ts-node:

npm install --save-dev ts-node 

Создадим для примера TypeScript файл - script.ts:

// script.ts

const user: string = 'User';

console.log(user);

Не забудем добавить команду для запуска в package.json:

{
  "scripts": {
    "start": "ts-node ./script.ts",
  },
} 

Все готово, можно запускать!

> npm start
User

Для примера также приложу полный файл package.json:

{
  "scripts": {
    "start": "ts-node ./script.ts",
  },
  "devDependencies": {
    "ts-node": "^10.9.2",
    "typescript": "^5.9.2"
  }
}

На этом все! Теперь мы можем использовать полноценно TypeScript в своих проектах.