8fc4ae51fb
* No longer depends on a custom CircleCI docker image that comes with Bazel pre-installed. Since Bazel is now available through NPM, we should be able to use the version from `@bazel/bazel` in order to enforce a consistent environment on CI and locally. * This also reduces the amount of packages that need to be published (ngcontainer is removed) PR Close #26691
37 lines
941 B
Markdown
37 lines
941 B
Markdown
# Typescript API Guardian
|
|
|
|
Keeps track of public API surface of a typescript library.
|
|
|
|
Examples:
|
|
|
|
```sh
|
|
# Generate one declaration file
|
|
ts-api-guardian --out api_guard.d.ts index.d.ts
|
|
# Generate multiple declaration files
|
|
# (output location like typescript)
|
|
ts-api-guardian --outDir api_guard [--rootDir .] core/index.d.ts core/testing.d.ts
|
|
# Print usage
|
|
ts-api-guardian --help
|
|
# Check against one declaration file
|
|
ts-api-guardian --verify api_guard.d.ts index.d.ts
|
|
# Check against multiple declaration files
|
|
ts-api-guardian --verifyDir api_guard [--rootDir .] core/index.d.ts core/testing.d.ts
|
|
```
|
|
|
|
# For developers
|
|
|
|
Build and test this library:
|
|
|
|
```sh
|
|
$ yarn bazel run //:install
|
|
$ yarn bazel test //tools/ts-api-guardian:all
|
|
```
|
|
|
|
Publish to NPM:
|
|
|
|
```sh
|
|
$ npm whoami # should be logged in as angular
|
|
$ grep version tools/ts-api-guardian/package.json # advance as needed
|
|
$ yarn bazel run //tools/ts-api-guardian:ts-api-guardian.publish
|
|
```
|