How to add new typings

[typings]

How to add new typings

[blakeembrey]

Let's say for instance Immutable-js. The project already have the d.ts file, so I don't have to create it. Should I create a repository on github for the typings.json? Or would it be better to add the file to their repository?

Their repo is best, Typings is a good fallback - use your own repo for type definitions. This is described https://github.com/typings/registry#contributing.

Also, in that case, what's the difference between the main and the browser properties for the typings.json?

See https://github.com/typings/typings/blob/master/docs/faq.md#how-do-i-write-typings-definitions, it has a formal definition.

Finally, in the example used in the docs for the debug.json version file, there's a hash there, I could no find a commit related to that hash? From where that hash came?

https://github.com/typings/registry/blob/master/npm/debug.json#L3 is typed-typings/npm-debug@0e398cb.

[thitemple]

OK, I guess I understand a few things better. I still have some questions. If I'm writing the typings for a package that's only intended to be used on the browser, should I still have the config for main and browser? Both will then point to the same file?

Thanks for the help

[blakeembrey]

Still use main and document that's it's made for browsers. It's pretty much the same approach as NPM packages there. Typings 1.0 will try to tidy up this issue/confusion.