Что нам дает опция declaration если она ничего не меняет в импорте?

Question

[Boris007]

Почитал про декларации типов и показалось, что расширение d.ts нам дает возможность добавить типы в глобальную область видимости
Но у меня получилось так, что их все равно надо импортировать из файлов, причем не важно d.ts или ts, ничего не меняется
И выходит так, что кроме понимания того, что у нас в файлах с расширением d.ts лежат типы, больше ничего
В документации нашел такие настройки, но что с ними, что без, что с флагом false, у меня ничего не изменилось

{
  "compilerOptions": {
    "declaration": true,
    "declarationDir": "./types"
  }
}

Я как-то не так настроил декларирование типов или расширение d.ts не про то, что нам больше не надо писать

import { User } from 'types/user.js
const user: User = ...

Мне казалось это расширение про то, что я просто пишу
const user: User = ...
И не использую import User, а он сам берется из некого хранилища декларированных типов TS из-за того, что этот тип находится в файле d.ts

Answer 1

[Дмитрий Беляев]

Опция declaration влияет на то, будут ли собираться .d.ts файлы при сборке из js в ts.

Если у Вас рядом лежат файлы user.js и user.d.ts то при импорте user.js из user.d.ts будут взяты для него типы, при этом содержимое user.js будет полностью проигнорировано компилятором ts, оно пойдет в сборку как есть.

Глобальные типы можно объявить, если положить .d.ts файл в корень проекта (ну или в ту папку, на которую он должен влиять), при этом не должно быть одного имени с .js файлом, то есть должен быть самостоятельным.
Но правильнее такое делать через опцию types.

Comments

[Boris007]

Спасибо!
Если правильно понял, то файлы d.ts в проекте, где у меня нет файлов js, не нужны?
И типы стоит так же экспортировать, как и раньше, просто храня файлы с типами в папке types или непосредственно в корневом файле сущности с его кодом?

[Дмитрий Беляев]

Если правильно понял, то файлы d.ts в проекте, где у меня нет файлов js, не нужны?

Boris007, и да и нет. Их можно использовать для глобальных типов, как Вы и хотите. Сделайте условный globals.d.ts в корне проекта, главное чтоб рядом globals.js не было.
А так пишите все просто в .ts файлах.