Deprecate TSD #269

Open
blakeembrey opened this Issue Jan 26, 2016 · 13 comments

Projects

None yet

10 participants

@blakeembrey
Member

The Typings project (https://github.com/typings/typings) has evolved and can currently consume DefinitelyTyped as a subset of the ecosystem. This improvement has effectively make TSD maintenance redundant and over time definitions should be written as external modules with typings.json, or converted inline with libraries for the TypeScript compiler to consume directly.

This issue will be closed when an official website for Typings is created and improved documentation can be linked to. Currently it serves as a notice for new or existing users.

To continuing installing type definitions from DefinitelyTyped, remember to use the --ambient flag (everything in DefinitelyTyped is essentially "global"). If you intend to publish a library using dependencies without type definitions (E.g. you installed typings from DefinitelyTyped/Typings), you will need to make sure those are dependencies (and not ambient). The core issue with global dependencies is maintenance and conflicts.

typings install node --save --ambient

TSD PRs and issues will continue to be responded to, but development is effectively EOL. If another developer would like to pick up maintenance and/or development, you are welcome to contribute. Existing issues should be solved already with Typings, but if you find something that does not work - make an issue in Typings.

Links: #150, typings/discussions#5 and typings/typings#125.

Edit: Typings has implemented an upgrade command for TSD users. Upgrading will only convert the format of tsd.json to typings.json, there may be additional tweaks you need to make (such as correcting now stripped references).

typings init --upgrade
@gdi2290
gdi2290 commented Jan 26, 2016

πŸ‘

for refernces to upgrade from tsd

webpack+typescript
angular/universal-starter@cfb7b52

gulpjs+typescript
https://github.com/angular/answers-app/pull/27/files

gulpjs with typescript
https://gist.github.com/gdi2290/e544407980e261acc172

commands

$ npm uninstall tsd
$ rm -rf typings
$ npm install typings
$ typings init --upgrade
$ rm tsd.json
$ typings install
@goenning

Just a small addition to @gdi2290 migration steps regarding something that just happened to me.
If someone follows it and end up with hundreds of TS2300: duplicate indetifier ... during compiling, the solution is here https://www.npmjs.com/package/typings#maindts-and-browserdts

@amcdnl
amcdnl commented Jan 28, 2016

How do you do tsd link with typings?

@blakeembrey
Member

How do you do tsd link with typings?

You don't. TSD link is flawed and not really a solid long-term solution - as it relies on ambient modules, causes duplicate identifiers and generally forces users to re-install sub-dependencies. Assuming you want the exact same thing, you can do typings install npm:<library>/<path-to-d-ts> --ambient. Most likely, you want a different solution where sub-dependencies are being handled properly. In that case, publish your typings.json file with your library and do typings install npm:<library> --save - the dependencies in <library>/typings.json will resolve.

@SonofNun15

Ran into an issue installing typings from another repository. Created an new issue: typings/typings#133

@avanderhoorn

Just wondering what the vision/intent here is for DefinitelyTyped/tsd vs Typings? I get that Typings is decentralised and that it can talk to DefinitelyTyped, but I also know that Typings has repos for some popular projects as well... hence my question.

@nhhockeyplayer

Wouldn't it make sense to mandate all typedefs be forced centralized in npm package installations instead of replicating half the efrastructure inside our local projects ?

  • no tsd
  • no typings
  • no replication of effort
  • no repeat dependency footprints...

JSPM is alarmingly a case in point

NPM already has the fittings to support and process this.

Is anyone even theorizing the impact of transient dependencies ?

I wouldn't send my kid to a daycare, which subs out the task to another daycare somewhere else... something is eventually going to disconnect... let alone a single transient dependency roaming thru the ecosystem.

@gdi2290
gdi2290 commented Feb 1, 2016

@nhhockeyplayer ideally that would be the case but for this to happen every author would need to include and maintain type definitions.

Related

For Angular 2 we can assume every ng2 module will include type definitions but for the other modules that will likely not be the case. So there will be a community (ng2) who will benefit more by ensuring every module in it's ecosystem includes type definitions (the ideal case).

@benferse benferse pushed a commit to benferse/vscode-docs that referenced this issue Feb 6, 2016
Ben Use typings instead of tsd to grab d.ts files
TSD has been deprecated (see DefinitelyTyped/tsd#269) in favor of further development on typings. Updating the node.js sample to install and use typings instead.
03f92df
@benferse benferse pushed a commit to benferse/vscode-docs that referenced this issue Feb 6, 2016
Ben Use typings instead of tsd to grab d.ts files
TSD has been deprecated (see DefinitelyTyped/tsd#269) in favor of continued development of Typings. Changing the node.js app sample to use Typings to grab d.ts files instead.
e39e366
@tamird tamird added a commit to tamird/cockroach that referenced this issue Feb 8, 2016
@tamird tamird ui: migrate from TSD to Typings e32ff3d
@tamird tamird added a commit to tamird/cockroach that referenced this issue Feb 8, 2016
@tamird tamird ui: migrate from TSD to Typings 9c86780
@tamird tamird added a commit to tamird/cockroach that referenced this issue Feb 8, 2016
@tamird tamird ui: migrate from TSD to Typings 9c25adb
@smith smith added a commit to habitat-sh/habitat that referenced this issue Feb 16, 2016
@smith smith Upgrade to latest angular2 beta; migrate tsd > typings
* Latest angular2 and zone.js
* Migrate from `tsd` to `typings`. Why? See
  DefinitelyTyped/tsd#269 and
  typings/typings#72
* Put all .d.ts references in app/boot.ts
* Make `npm run repl` use
  https://github.com/HerringtonDarkholme/typescript-repl
b6a5553
@sirn sirn added a commit to pxfs/fanboi2 that referenced this issue Feb 21, 2016
@sirn sirn Use Typings instead of TSD.
TSD is now deprecated. See also GitHub issue:
DefinitelyTyped/tsd#269
061a043
@vrv vrv pushed a commit to tensorflow/tensorflow that referenced this issue Feb 23, 2016
@tensorflower-gardener A. Unique TensorFlower + tensorflower-gardener Swap TensorBoard local build from "tsd" to "typings".
Reason: tsd is deprecated (DefinitelyTyped/tsd#269) and typings is the new standard. Also, tsd was behaving badly - running `tsd install` on a clean client was causing it to incorrectly depend on typing files from node_modules, which resulted in a broken build. This issue does not exist with typings.

For convenience, and since typings is really fast when all deps are up-to-date, I made it a part of the standard gulp task. `npm install` so you have all the deps, and running `gulp` will keep the typing files synchronized - there no longer is a separate step for downloading them.

The logical next step is to do the same for bower. I did wire that up, but I will not connect it to the gulp task until after the big bower dependency upgrade CL is through. If I add it right now, it will fail on unresolved dependency conflicts and make everyone sad.
Change: 115370585
fb0a3f2
@dfahlander dfahlander added a commit to dfahlander/Dexie.js that referenced this issue Mar 14, 2016
@dfahlander dfahlander Removed the "typescript/definitions" element of package.json because …
…it is strongly argumented against.


http://angularclass.com/the-state-of-typescript-packages/
"TSD has a concept called tsd link, which references the type definition (typescript.definition in package.json) from the tsd.d.ts file in typings/. That means the TypeScript definition in your module needs to be ambient and can’t just be the output from the TypeScript compiler. This kind of concept resulted in more hacks and tools as dts-generator, which takes the TypeScript compiler .d.ts files and wraps them in your modules name so other tools can use them."

DefinitelyTyped/tsd#269
0eaec3b
@karelhala karelhala added a commit to karelhala/hawkular-ui-components that referenced this issue Apr 12, 2016
@karelhala karelhala Tsd will be depracated so change it to Typings
As mentioned in DefinitelyTyped/tsd#269 the tsd maintanance project will stop developping and move to Typings. Let's change to typings before this happens
10a3e9a
@karelhala karelhala added a commit to karelhala/hawkular-ui-components that referenced this issue Apr 12, 2016
@karelhala karelhala Tsd will be depracated so change it to Typings
As mentioned in DefinitelyTyped/tsd#269 the tsd maintanance project will stop developping and move to Typings. Let's change to typings before this happens

Remove tsd and add typings.json to tsconfig ignore
007f976
@ngbrown ngbrown added a commit to ngbrown/DefinitelyTyped that referenced this issue May 28, 2016
@ngbrown ngbrown Update README.md to point to Typings instead of tsd
Based on the note on the `tsd` page and the issue DefinitelyTyped/tsd#269, it would make sense to point people to Typings instead.
10468a3
@rinogo rinogo added a commit to rinogo/ionic-cross-platform-boilerplate that referenced this issue Jun 8, 2016
@rinogo rinogo Migrating from TSD to typings
TSD has been deprecated
(DefinitelyTyped/tsd#269), with typings
suggested as the replacement.  These changes migrate the code from TSD
to typings.
adc7f78
@timneutkens

@blakeembrey sorry for bumping this issue. Just noticed the deprecation notice added to the readme here on github is not on npm which could lead to people still using it without initial knowledge that the package is deprecated. It's probably because there was no new release since the package got deprecated.

@blakeembrey
Member
blakeembrey commented Jul 2, 2016 edited

If you do NPM install, it says it.

Edit: But I'll check it out and release a new version.

@timneutkens

Cool, then it's fine πŸ‘

@h0ru5
h0ru5 commented Aug 28, 2016

could you add a deprecation notice to the npm page?
Makes it easier for returners to figure out about typings.

@dcbrwn
dcbrwn commented Oct 3, 2016

It would be cool to ship complete and finished version of typings first and then deprecate tsd because right now typings only makes things harder and confusing with this mess with multiple repos IMO. 😠

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment