Skip to content

lottie/lottie-types

Repository files navigation

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

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