https://github.com/figma/widget-typings

Typings for the Figma Widget API
https://github.com/figma/widget-typings

Last synced: 15 days ago
JSON representation

Typings for the Figma Widget API

• Host: GitHub
• URL: https://github.com/figma/widget-typings
• Owner: figma
• License: mit
• Created: 2021-10-05T21:18:52.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-12-19T19:01:54.000Z (2 months ago)
• Last Synced: 2025-01-29T14:22:04.906Z (21 days ago)
• Language: Shell
• Homepage:
• Size: 96.7 KB
• Stars: 11
• Watchers: 59
• Forks: 6
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Figma Widget API typings

[![npm](https://img.shields.io/npm/v/@figma/widget-typings?logo=npm&cacheSeconds=1800)](https://www.npmjs.com/package/@figma/widget-typings)

This repository contains the typings for the Figma Widget API.

## Usage

1. Installation

   

   Note that the widget api is an extention of the plugin api so you should install both `@figma/plugin-typings` and `@figma/widget-typings`

   ```sh

   npm i --save-dev @figma/plugin-typings @figma/widget-typings

   ```

2. Configure _tsconfig.json_

   ```js

   {

       "compilerOptions": {

           "typeRoots": [

               "./node_modules/@types",

               "./node_modules/@figma"

           ]

       }

   }

   ```

   The configuration above is needed for the TypeScript compiler to use type definitions found in both `./node_modules/@types` and `./node_modules/@figma`. Normally, most external type definitions are from DefinitelyTyped and are installed in `/@types`, which included by TypeScript by default. Since we host the plugin & widget typings separately, they are installed outside in `/@figma` instead.

   Types should become globally available without needing to use import statements. We do it this way because the widget API is part of the host environment, as opposed to being a package that a plugin includes.

## About

Widget API releases have the format "Version X, Update Y". Equivalent tags are created in this repository as `v.`. Note that not all API releases include API changes, some are just bug fixes. Therefore, some typings versions are skipped.