@lottie-animation-community/lottie-types
v1.2.0
Published
TypeScript definitions for Lottie animation format
Downloads
1,123
Maintainers
Readme
lottie-types
Installation
npm install --save @lottie-animation-community/lottie-types
Summary
This package contains type definitions for Lottie animation format
Details
The project has been migrated from the lottiefiles organization that has been used internally. The definition types have been built based on lottie-docs/schema with a few differences: firstly, some additional informative type comments have been added through testing the schema types with real Lottie data; secondly, the types constructed in a way to avoid duplications.
Instead of writing the types manually, generating it automatically was considered but wasn't successful, for reason that most of the tools such as quicktype, json-schema-to-typescript and transform don't work well with huge JSON-schema structures with many nested layers and don't support json-schema/draft/2020-12 features such as complicated conditionals, prefixItems, and some def reference scenarios.
The schema definitions have been synced with marcusstenbeck/lottie-types as well.
Plan
- auto-generate types from lottie-docs/schema
- publish the final definition bundle to DefinitelyTyped
Contribution
The following steps will get you setup to contribute changes to this repo:
Fork the repo
Run
yarn install
to get dependencies packagesSync any schema changes with lottie-docs
Add changesets running
yarn changelog
for any reasonable change to your codebase. You must ensure Changesets are included when making a Pull Request to merge to main branches. Please refer to the changeset docsCreate a PR from
feature-branch
tomain
After merging to
main
the Github action will create another PR for only version bumping and changelog, which you have to merge the PR manuallythe package will be released to the NPM and GitHub registry after the merging the Changeset PR
Commands
| Command | Description |
| ------------------------ | -------------------------------------------------------------------- |
| yarn clean
| Deletes index.d.ts
file |
| yarn test
| Run tests (wip) |
| yarn format:prettier
| Format the code using prettier |
| yarn build
| Bundles all declaration type files into the single index.d.ts
file |
| yarn changelog
| Add a changeset changelog entry |
| yarn changelog:check
| Check pending changesets |
| yarn changelog:version
| Update all the workspace projects versions using changesets |
| yarn changelog:publish
| Publish the packages to the package repository |