To start, you'll need NodeJS 14 and pnpm.
The development and release process heavily lean into common package scripts, the only commands you need to care about are;
pnpm run compile
to build.pnpm test
to run tests.
API documentation is derived from source using API Extractor and API Documenter. Entities tagged with @public
will be included in API generated documentation.
Generation occurs automatically when pnpm version
is run.
Generally speaking, all releases should first traverse through alpha
, beta
, and rc
(release candidate) to catch missed bugs and gather feedback as appropriate. Aside from this however, there are a few steps that MUST always be done.
- Make sure
CHANGELOG.md
is up to date. - Update
version
inpackage.json
. pnpm run stamp-version
- Commit changes.
git tag v${version}
pnpm publish
- Create release on GitHub from tag made by
npm version
.