Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

tsd-jsdoc

Package Overview
Dependencies
Maintainers
1
Versions
23
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

tsd-jsdoc - npm Package Compare versions

Comparing version 2.0.0-beta.1 to 2.0.0-beta.2

Emitter.js

11

package.json
{
"name": "tsd-jsdoc",
"version": "v2.0.0-beta.1",
"version": "v2.0.0-beta.2",
"description": "Compiles JSDoc annotated javascript into a Typescript Declaration File (.d.ts).",

@@ -13,8 +13,13 @@ "main": "lib/publish.js",

"scripts": {
"clean": "rm -rf *.js *.js.map",
"lint": "eslint --rulesdir node_modules/@englercj/code-style *.js",
"build": "tsc -p tsconfig.json",
"build": "tsc -p tsconfig.json && mv src/*.js . && mv src/*.js.map .",
"prepublish": "npm run build",
"test": "jsdoc -c test/config.json -d out"
},
"files":[
"lib"
"*.js",
"*.js.map",
"README.md",
"LICENSE"
],

@@ -21,0 +26,0 @@ "devDependencies": {

@@ -43,6 +43,6 @@ # jsdoc2tsd

This library provides almost no validation beyond what jsdoc provides. Meaning if you
This library provides very little validation beyond what jsdoc provides. Meaning if you
have invalid jsodc comments, this will likely output an invalid TypeScript Definition File.
Additionally there are things that jsdoc things are fine, that TypeScript does not.
Additionally there are things that jsdoc allows, that TypeScript does not.
One example would be a member variable marked with `@constant`. While that is valid

@@ -93,3 +93,4 @@ jsdoc, it is not valid TS:

Any method or member that has the same name as one in the parent of a child class
will be ignored.
will be ignored in the Child class, unless it is a method with different parameters
that *is not* marked with the `@override` tag.

@@ -111,2 +112,10 @@ For example, this JavaScript:

}
/**
*/
amethod() {}
/**
*/
bmethod() {}
}

@@ -127,2 +136,13 @@

}
/**
* @override
* @param {object} opt - Does stuff.
*/
amethod(opt) {}
/**
* @param {object} opt - Does stuff.
*/
bmethod(opt) {}
}

@@ -136,5 +156,8 @@ ```

someprop: boolean;
amethod(): void;
}
class Child extends Parent {
bmethod(opt): void;
}

@@ -150,3 +173,3 @@ ```

- [`@event`](http://usejsdoc.org/tags-event.html) - No TS equivalent
- [`@exports`](http://usejsdoc.org/tags-exports.html) - **Not Yet Implemented**
- [`@exports`](http://usejsdoc.org/tags-exports.html) - Everything is exported since it is a definition file.
- [`@external`](http://usejsdoc.org/tags-external.html) - **Not Yet Implemented**

@@ -156,4 +179,3 @@ - [`@fires`](http://usejsdoc.org/tags-fires.html) - No TS equivalent

- [`@override`](http://usejsdoc.org/tags-override.html) - No TS equivalent ([issue](https://github.com/Microsoft/TypeScript/issues/2000))
- [`@readonly`](http://usejsdoc.org/tags-readonly.html) - No TS equivalent in v1 ([implemented in v2](https://github.com/Microsoft/TypeScript/issues/229))
- [`@this`](http://usejsdoc.org/tags-this.html) - No TS equivalent in v1 ([implemented in v2](https://github.com/Microsoft/TypeScript/issues/12))
- [`@this`](http://usejsdoc.org/tags-this.html) - **Not Yet Implemented**
- [`@throws`](http://usejsdoc.org/tags-throws.html) - No TS equivalent

@@ -179,3 +201,3 @@

All other tags *should* work...
All other jsdoc tags should work fine.

@@ -182,0 +204,0 @@ ## Supported ClosureCompiler Tags

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc