Skip to content

Latest commit

 

History

History
66 lines (39 loc) · 2.97 KB

CONTRIBUTING.md

File metadata and controls

66 lines (39 loc) · 2.97 KB

Contributing to a TypeScript Playground Plugin

Contributing

You can use yarn start to set up both a copy of Rollup to generate the JS, and Serve to host it.

yarn start

Then set up the TypeScript playground to connect to a dev plugin at http://localhost:5000/.

Plugin API

The plugin API is documented in the interface PlaygroundPlugin in ./src/index.ts.

Roughly:

  • There are a set of mounting and un-mounting functions which you can use to handle your UI in the sidebar
  • There are modelChanged methods, which are shortcuts to knowing when the code in monaco editor has changed

Sandbox

The plugins are passed copies of the TypeScript sandbox, which is a high level API wrapper to the monaco-editor. You can learn more about the sandbox on the TypeScript website.

Rollup

Rollup is a JavaScript bundler, that will take all of the TypeScript + JavaScript code you reference and then create an AMD bundle for it all. AMD bundles are used in Monaco, TypeScript Sandbox and the Playground - so, this is used for consistency with the rest of the ecosystem.

Adding a dependency

Because most node_modules expect to be running in node, you might have to do some work to get the dependency working on the web.

The route to handle this is via rollup:

  • add a new dependency via yarn add xyz
  • import it into your index.ts
  • run yarn build - did it provide some error messages?

Serve

Serve is used to make a web-server for the dist folder.

Deployment

This module should be deployed to npm when you would like the world to see it, this may mean making your code handle a staging vs production environment (because the URLs will be different.)

For example, this is how you can handle getting the URL for a CSS file which is included in your dist folder:

const isDev = document.location.host.includes("localhost")
const unpkgURL = "https://unpkg.com/typescript-playground-presentation-mode@latest/dist/slideshow.css"
const cssHref = isDev ? "http://localhost:5000/slideshow.css" : unpkgURL

Post-Deploy

Once this is deployed, you can test it on the TypeScript playground by passing in the name of your plugin on npm to the custom plugin box. This is effectively your staging environment.

Once you're happy and it's polished, you can apply to have it in the default plugin list.

Support

Ask questions either on the TypeScript Website issues](https://github.com/microsoft/TypeScript-Website/issues), or in the TypeScript Community Discord - in the TypeScript Website channel.