Tipificaciones de TypeScript en paquetes de organización npm @types

He notado que hay una organización nty @types , que contiene paquetes de mecanografía, pero no puedo encontrar ninguna documentación al respecto. ¿Cómo están destinados a ser utilizados?

¿Está destinado a ser utilizado con la herramienta de tipings ? Si es así, ¿cómo instalarlos? Por ejemplo, hay un @types/openlayerspaquete, pero typings search npm:openlayersno devuelve nada.

¿Está destinado a ser utilizado por separado de la herramienta de tipificación? Por ejemplo, instalado directamente con npm?

A partir de TypeScript 2.0, las tipificaciones ya no son necesarias. La organización npm es una entidad para configurar un equipo de desarrolladores. Creo que Microsoft configuró la organización @types en npm y agregó el equipo de desarrolladores de TypeScript a la organización. Los paquetes en la organización @types se publican automáticamente desde DefinitelyTyped usando la herramienta de publicación de tipos según los documentos .

Además, hay otra forma de agregar typesa sus paquetes:

En tu package.json

Si su paquete tiene un .jsarchivo principal , también deberá indicar el archivo de declaración principal en su package.jsonarchivo. Establezca la typespropiedad para que apunte a su archivo de declaración incluido. Por ejemplo:

{
    "name": "awesome",
    "author": "Vandelay Industries",
    "version": "1.0.0",
    "main": "./lib/main.js",
    "types": "./lib/main.d.ts"
}

Tenga en cuenta que el "typings"campo es sinónimo de "types", y podría usarse también.

También tenga en cuenta que si su archivo de declaración principal se nombra index.d.tsy vive en la raíz del paquete (al lado de index.js) no es necesario que marque la "types"propiedad, aunque es recomendable hacerlo.

En cuanto a los tipos de búsqueda

En su mayor parte, los paquetes de declaración de tipo siempre deben tener el mismo nombre que el nombre del paquete en npm, pero con el prefijo @ types /, pero si lo necesita, puede consultar https://aka.ms/types para encontrar el paquete para tu biblioteca favorita

De: http://www.typescriptlang.org/docs/handbook/declaration-files/consumption.html

Pero cuando lo hice npm search @types/openlayers, no obtuve ningún resultado. Pero hacer la búsqueda desde la interfaz web me devolvió los resultados. Así que supongo npm searchque no busca entre organizaciones.

El anuncio en el blog de TypeScript responde a esto: El futuro de los archivos de declaración

Resumen:

La @typesorganización npm es para obtener definiciones de tipo con npm. El uso de estas definiciones de tipo es una característica que viene en TypeScript 2.0.

Esto reemplazará los proyectos / herramientas actuales, tales como tipings y tsd , aunque estos continuarán siendo apoyados por algún tiempo.

Esta será una característica que se implementa en Typecript 2.0. Esto proporciona compatibilidad de tipo para módulos / bibliotecas UMD y sus respectivas definiciones.

Consulte ( Soporte integrado para las definiciones de módulos UMD ) para obtener una mejor comprensión de los problemas actuales con las tipificaciones ambientales.