In the discussion on #328 the consensus seems to be that people like type definitions. This moves toward generating types using jsdoc as suggested by @bollwyvl in that thread.

I don't have much Typescript experience so I would very much appreciate it if people could test them out. The types are available as CircleCI artifacts here:
https://3914-322074228-gh.circle-artifacts.com/0/root/repo/build/pyodide.d.ts

@bollwyvl said that

> types that aren't tested are probably worse than no types at all

If anyone could contribute tests, that would be very helpful (I don't know what they should look like). 

The main limitation I ran into with this approach is that Typescript supports Typescript types in jsdoc annotations but jsdoc does not. This means that if we want to automatically generate docs, we have to stick to the much more limited syntax that jsdoc supports. For example, `isPyProxy` should be typed `obj is PyProxy` but this approach does not allow that as far as I can tell. 
Some basic types. In the discussion on #328 the consensus seems to be that people like type definitions. This moves toward generating types using jsdoc as suggested by @bollwyvl in that thread.

I don't have much Typescript experience so I would very much appreciate it if people could test them out. The types are available as CircleCI artifacts here:
https://3914-322074228-gh.circle-artifacts.com/0/root/repo/build/pyodide.d.ts

@bollwyvl said that

> types that aren't tested are probably worse than no types at all

If anyone could contribute tests, that would be very helpful (I don't know what they should look like). 

The main limitation I ran into with this approach is that Typescript supports Typescript types in jsdoc annotations but jsdoc does not. This means that if we want to automatically generate docs, we have to stick to the much more limited syntax that jsdoc supports. For example, `isPyProxy` should be typed `obj is PyProxy` but this approach does not allow that as far as I can tell. 
# Related Projects

## WebAssembly ecosystem

- [emscripten](https://emscripten.org/) is the compiler toolchain for WebAssembly
  that made Pyodide possible.

## Notebook environments, IDEs, and REPLs

 - [Iodide](https://github.com/iodide-project/iodide) is a notebook-like
   environment for literate scientific computing and communication for the
   web. It is no longer actively maintained. Historically, Pyodide started
   as plugin for iodide.
 - [Starboard notebook](https://github.com/gzuidhof/starboard-notebook) is an
   in-browser literal notebook runtime that uses Pyodide for Python.
 - [Basthon notebook](https://notebook.basthon.fr/) is a static fork of Jupyter
   notebook with a Pyodide kernel (currently in French).
 - [JupyterLite](https://github.com/jtpio/jupyterlite) is a JupyterLab
   distribution that runs entirely in the browser, based on Pyodide.

## Other projects

- [wc-code](https://github.com/vanillawc/wc-code) is a library to run
  Javascript, Python, and Theme in the browser with inline code blocks.
  It uses Pyodide to execute Python code.

# Related Projects

## WebAssembly ecosystem

- [emscripten](https://emscripten.org/) is the compiler toolchain for WebAssembly
  that made Pyodide possible.

## Notebook environments, IDEs, and REPLs

 - [Iodide](https://github.com/iodide-project/iodide) is a notebook-like
   environment for literate scientific computing and communication for the
   web. It is no longer actively maintained. Historically, Pyodide started
   as plugin for iodide.
 - [Starboard notebook](https://github.com/gzuidhof/starboard-notebook) is an
   in-browser literal notebook runtime that uses Pyodide for Python.
 - [Basthon notebook](https://notebook.basthon.fr/) is a static fork of Jupyter
   notebook with a Pyodide kernel (currently in French).
 - [JupyterLite](https://github.com/jtpio/jupyterlite) is a JupyterLab
   distribution that runs entirely in the browser, based on Pyodide.

## Other projects

- [wc-code](https://github.com/vanillawc/wc-code) is a library to run
  Javascript, Python, and Theme in the browser with inline code blocks.
  It uses Pyodide to execute Python code.
