ajs-typeAdds TypeScript definitions for AJS used in Atlassian products.
InstallingInstall the npm package
$ npm install --save-dev firstname.lastname@example.org
Important: You probably don't want to install
@latestlight-heartedly. Our versions reflect AJS' versions. When we update a version, we will push it, but we might need to update older versions of AJSType when they have bugs. NPM will consider the last pushed version as
@latest. See Versioning for more info.
tsconfig.jsonto make the new typings known
[...] "types": [ "ajs-type" ], [...]
Note: This will disable automatic @types detection by your compiler. Add it back in if you need it with the
End with an example of getting some data out of the system or using it for a little demo
ContributingWhen contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.
Pull Request Process
- Ensure any install or build dependencies are removed before the end of the layer when doing a build.
- Check out the tag with version number of the appropriate AJS version if you are making a change to typings. If you want to improve tooling, check out the newest version instead.
- You may merge the Pull Request in once you have the sign-off of two other developers, or if you do not have permission to do that, you may request the second reviewer to merge it for you.
- Mergers, make sure to untag any old version that may exist and re-tag the merge commit.
VersioningSince we try to keep parity with AJS, we use SemVer for versioning. For the versions available, see the tags on this repository.
If you need to support a specific version of AJS, you can configure your
package.jsonlike this: ```` "ajs-type": ">=5.7.2-0 <5.7.2", ````
We work with npm prerelease notation to be able to change typings while still keeping the package version equivalent to the version of AJS being typed. That way we circumvent npm's restriction where a version can only be published once without losing the correlation to