npm install --save @lottie-animation-community/lottie-types
This package contains type definitions for Lottie animation format
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.
- auto-generate types from lottie-docs/schema
- publish the final definition bundle to DefinitelyTyped
The following steps will get you setup to contribute changes to this repo:
-
Fork the repo
-
Run
yarn install
to get dependencies packages -
Sync 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 docs -
Create 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 manually -
the package will be released to the NPM and GitHub registry after the merging the Changeset PR
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 |