Publicación de una biblioteca de utilidades de tipos
Empaquete y comparta tipos de utilidad personalizados en npm.
Publicación de una biblioteca de utilidades de tipos es una lección gratuita de TypeScript Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de TypeScript Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de TypeScript Academy incluye 4 lecciones en total.
¿Qué es una biblioteca de utilidades de tipos?
Una biblioteca de utilidades de tipos exporta únicamente tipos de TypeScript; no contiene código de ejecución. Algunos ejemplos populares son type-fest, ts-essentials y utility-types.
// A type utility library exports types like:
export type DeepPartial<T> = T extends object
? { [K in keyof T]?: DeepPartial<T[K]> }
: T;Estructura del proyecto
Manténgala sencilla: un único src/index.ts que vuelva a exportar todas las utilidades, con tsconfig.json configurado para emitir únicamente declaraciones.
// tsconfig.json
{
"compilerOptions": {
"declaration": true,
"emitDeclarationOnly": true,
"outDir": "dist",
"strict": true
}
}package.json para un paquete que solo contiene tipos
Configure los campos main y types para que apunten a sus declaraciones. Establezca sideEffects: false para habilitar el tree-shaking.
{
"name": "@myorg/type-utils",
"version": "1.0.0",
"main": "dist/index.js",
"types": "dist/index.d.ts",
"sideEffects": false,
"files": ["dist"]
}Generar declaraciones
Ejecute tsc para emitir archivos .d.ts. En una biblioteca que solo contiene tipos, la salida de JavaScript está vacía o es mínima.
# Build declarations
npx tsc
# dist/index.d.ts is generatedVersionado y registros de cambios
Siga el versionado semántico: los cambios incompatibles en los tipos son cambios mayores, las nuevas utilidades son cambios menores y las correcciones son cambios de parche.
# Bump version
npm version minor
# Generate changelog with conventional-changelog or changesetsPublicación en npm
Use npm publish o pnpm publish. Para paquetes con ámbito dentro de una organización, asegúrese de haber iniciado sesión y de que el ámbito esté configurado.
npm login
npm publish --access public
# or for private: npm publish --access restrictedCompatibilidad de versiones de TypeScript
Documente la versión mínima de TypeScript que requieren sus utilidades. Los tipos condicionales recursivos requieren TS 4.1 o posterior; Awaited está integrado desde TS 4.5.
// package.json peerDependencies
{
"peerDependencies": {
"typescript": ">=4.5"
}
}Pruebas de tipos con tsd
Use el paquete tsd para escribir pruebas a nivel de tipos que se ejecuten durante la CI y garanticen que sus utilidades funcionan correctamente.
import { expectType } from "tsd";
import type { DeepPartial } from "@myorg/type-utils";
expectType<DeepPartial<{ a: { b: number } }>>({ a: {} });Documentación con TSDoc
Añada comentarios JSDoc /** */ a sus tipos. Herramientas como TypeDoc generan documentación de la API a partir de ellos.
/**
* Makes all properties of T optional at every depth.
* @example type A = DeepPartial<{ x: { y: number } }> // { x?: { y?: number } }
*/
export type DeepPartial<T> = ...Distribución en un monorepo
En un monorepo, publique el paquete de tipos como un paquete del workspace para que otras aplicaciones lo consuman mediante workspace:* en lugar de npm.
// Other package's package.json
{
"dependencies": {
"@myorg/type-utils": "workspace:*"
}
}Resumen: publicación de bibliotecas de tipos
Una biblioteca de utilidades de tipos usa emitDeclarationOnly: true, exporta tipos desde src/index.ts, se versiona con semver, se prueba con tsd, se documenta con TSDoc y se publica en npm o en un registro de workspace.
Comprobación rápida
¿Qué opción de tsconfig genera únicamente archivos .d.ts sin salida de JavaScript?
Lo que ha aprendido
Publicar una biblioteca de utilidades de tipos requiere emitDeclarationOnly, los campos adecuados en package.json, pruebas a nivel de tipos con tsd, comentarios TSDoc y versionado semántico. Comparta sus utilidades con la comunidad o en su monorepo.
Preguntas frecuentes
¿La lección «Publicación de una biblioteca de utilidades de tipos» es gratis?
Sí — el texto completo de «Publicación de una biblioteca de utilidades de tipos» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de TypeScript Academy, actualiza a CoddyKit PRO. El curso de TypeScript Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Publicación de una biblioteca de utilidades de tipos»?
Empaquete y comparta tipos de utilidad personalizados en npm. Practicas TypeScript Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar TypeScript Academy?
No se requiere experiencia previa. TypeScript Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Publicación de una biblioteca de utilidades de tipos»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de TypeScript Academy?
Sí. Cada lección de TypeScript Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- DeepPartial y DeepReadonly
- Utilidades Flatten y UnwrapPromise
- TupleToUnion y UnionToIntersection
- Publicación de una biblioteca de utilidades de tipos