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:

1. Fork the repo

2. Run yarn install to get dependencies packages

3. Sync any schema changes with lottie-docs

4. 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

5. Create a PR from feature-branch to main

6. 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

7. the 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 |

License

MIT © lottie-animation-community