Объявления, карты исходников и экспорт типов
Генерируйте файлы объявлений, включайте карты исходников для отладки и изучайте способы экспорта типов.
«Объявления, карты исходников и экспорт типов» — бесплатный урок TypeScript Academy на CoddyKit. Это урок 3 из 3. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения TypeScript Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс TypeScript Academy содержит 3 уроков всего.
Введение
Цель: научиться создавать файлы объявлений, включать карты исходного кода и понятно экспортировать типы.
Объявления
Включите declaration: true, чтобы создавать файлы .d.ts вместе с выходными файлами JS.
// tsconfig.json
{
"compilerOptions": {
"declaration": true,
"outDir": "dist"
}
}emitDeclarationOnly
Используйте emitDeclarationOnly, чтобы для библиотек создавать только объявления типов, без JS.
// tsconfig.json
{
"compilerOptions": {
"emitDeclarationOnly": true,
"outDir": "types"
}
}Карты исходного кода
Карты исходного кода позволяют отлаживать TS в браузерах или Node, сопоставляя JS с исходным кодом на TS.
// tsconfig.json
{
"compilerOptions": {
"sourceMap": true
}
}Типы в package.json
Используйте поле types или typings в package.json, чтобы указать путь к основным объявлениям.
// package.json
{
"types": "dist/index.d.ts"
}Повторный экспорт
Повторно экспортируйте типы, чтобы сделать публичный API понятнее. Сочетайте этот подход с declaration для пользователей библиотеки.
// src/index.ts
export type { User, Config } from "./models";
export { createClient } from "./client";Вопрос
Быстрая проверка: какая опция компилятора включает создание .d.ts?
Повторение
Повторение: declaration создаёт .d.ts, emitDeclarationOnly выводит только типы, sourceMap помогает при отладке, а повторный экспорт формирует Ваш публичный API.
Часто задаваемые вопросы
Урок «Объявления, карты исходников и экспорт типов» бесплатный?
Да — полный текст урока «Объявления, карты исходников и экспорт типов» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс TypeScript Academy, подпишись на CoddyKit PRO. Курс TypeScript Academy содержит 3 уроков всего.
Чему я научусь в уроке «Объявления, карты исходников и экспорт типов»?
Генерируйте файлы объявлений, включайте карты исходников для отладки и изучайте способы экспорта типов. Ты практикуешь TypeScript Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать TypeScript Academy?
Предыдущий опыт не требуется. TypeScript Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 3.
Сколько времени занимает урок «Объявления, карты исходников и экспорт типов»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке TypeScript Academy?
Да. Каждый урок TypeScript Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Вывод tsc и noEmit в сравнении со сборщиками
- Основы Vite, esbuild, SWC и Rollup
- Объявления, карты исходников и экспорт типов