0Pricing
TypeScript Academy · Aula

Fundamentos de .d.ts; export type versus export

Aprenda os fundamentos dos arquivos de declaração: declarações ambientais versus de módulo, export type versus export e como garantir uma DX correta para os consumidores.

Fundamentos de .d.ts; export type versus export é uma aula grátis de TypeScript Academy no CoddyKit. Esta é a aula 1 de 2. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de TypeScript Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de TypeScript Academy inclui 2 aulas no total.

Introdução

Objetivo: escrever arquivos .d.ts úteis. Você aprenderá sobre declarações ambientais e de módulos, como declarar exportações e quando usar export type em vez de export.

  • Contexto ambiental e de módulo
  • Exportações somente de tipo e de valor
  • Boas práticas

Declarações ambientais

Use declare global para estender o escopo global. Adicione export {} para marcar o arquivo como um módulo e evitar conflitos.

// globals.d.ts
// Ambient declaration: no import/export, augments global scope
declare global {
  interface Window {
    APP_VERSION: string
  }
}

export {} // ensures this file is a module

Declarações de módulo

declare module descreve a estrutura de um pacote externo. Use exportações internamente para reproduzir o que o JS fornece.

// types/index.d.ts
// Declare a module with exports
declare module "mylib" {
  export function greet(name: string): string
  export const version: string
}

Exportação de tipo versus exportação

export type (ou interface) é usado para construções somente de tipo. Use export para funções, constantes e classes — elementos que existem em tempo de execução.

// shapes.d.ts
export type Point = { x: number; y: number }

export interface User {
  id: string
  name: string
}

export function distance(a: Point, b: Point): number
export const VERSION: string

Extensão de módulos

Você pode estender módulos existentes reabrindo-os em outro arquivo de declaração. Isso é útil para corrigir pacotes de terceiros.

// augment.d.ts
import "mylib"
declare module "mylib" {
  export function extra(): void
}

Boas práticas

Boas práticas:

  • Mantenha os arquivos .d.ts mínimos; evite globais desnecessários.
  • Separe claramente as exportações somente de tipo das exportações de valor.
  • Teste os arquivos de declaração com tsc --noEmit e um exemplo de uso.

Verificação de export type

Verificação rápida: quando você deve usar export type?

Recapitulação

Recapitulação: arquivos .d.ts declaram tipos sem implementação. Use declare global ou declare module, separe export type de export e siga as boas práticas.

Perguntas Frequentes

A aula “Fundamentos de .d.ts; export type versus export” é grátis?

Sim — o texto completo de “Fundamentos de .d.ts; export type versus export” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de TypeScript Academy, atualize para CoddyKit PRO. O curso de TypeScript Academy inclui 2 aulas no total.

O que vou aprender em “Fundamentos de .d.ts; export type versus export”?

Aprenda os fundamentos dos arquivos de declaração: declarações ambientais versus de módulo, export type versus export e como garantir uma DX correta para os consumidores. Você pratica TypeScript Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar TypeScript Academy?

Nenhuma experiência prévia é necessária. TypeScript Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 2.

Quanto tempo leva a aula “Fundamentos de .d.ts; export type versus export”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de TypeScript Academy?

Sim. Cada aula de TypeScript Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Fundamentos de .d.ts; export type versus export
  2. Publicação de pacotes com tipos
← Voltar para TypeScript Academy