diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..2901159 --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +index.html +.vercel diff --git a/index.bs b/index.bs new file mode 100644 index 0000000..43e2906 --- /dev/null +++ b/index.bs @@ -0,0 +1,215 @@ +
+Title: Runtime Keys +Shortname: runtime-keys +Level: 1 +Status: w3c/CG-DRAFT +Group: wintercg +URL: http://runtime-keys.proposal.wintercg.org +Editor: Ethan Arrowood, Vercel http://vercel.com, ethan-arrowood@vercel.com +Abstract: A proposal defining standard identifier keys for various runtime environments +Markup Shorthands: markdown yes ++
+spec:url; type:interface; text:URL +spec:html; type:attribute; for:Window; text:navigator +spec:html; type:attribute; for:Window; text:self ++ +Introduction {#intro} +===================== + +This proposal defines a list of keys that represent various runtime environments. + +These keys can be used in a variety of ways, and should be considered a reliable representation of the given runtime. + +For example, they may be used in a project configuration file to indicate the given project supports the specified runtime. + +This specification does not detail how the keys can be used; that is left up to community developed tools. + +The point of this proposal is to only define what the keys are in order to prevent conflicts, and provide users a reliable list of platforms they can build tooling around. + +Inclusion in this registry does not imply that the specified runtime is conformant with the WinterCG [Minimum Common API](https://proposal-common-min-api.deno.dev/). + +Inclusing in this registry does not imply endorsement of any kind. + +## Example Usage ## {#example-usage} + +One example of how these keys may be used (remember, this proposal does not specify how the keys are to be used) is within `package.json` files for projects hosted on npm. + +The following `package.json` file demonstrates a library that exports seperate outputs for Node.js and Deno, as well as specifies which versions of each runtime it supports. + +```json +{ + "name": "the-library", + "version": "1.0.0", + "exports": { + "node": "./dist/node/index.js", + "deno": "./dist/deno/index.js" + }, + "engines": { + "node": ">=16", + "deno": ">=1.10" + } +} +``` + +Keys {#keys} +============ + +## Alibaba Cloud - edge-routine ## {#edge-routine} + +The JavaScript/Webassembly runtime that powers Alibaba Cloud edge-routine. + +Key: `edge-routine` + +Website: [https://www.alibabacloud.com/help/en/dynamic-route-for-cdn/latest/er-overview](https://www.alibabacloud.com/help/en/dynamic-route-for-cdn/latest/er-overview) + +## Cloudflare - workerd ## {#workerd} + +The JavaScript / WebAssembly runtime that powers Cloudflare Workers. + +Key: `workerd` + +Website: [https://workers.cloudflare.com/](https://workers.cloudflare.com/) + +Repository: [https://github.com/cloudflare/workerd](https://github.com/cloudflare/workerd) + +## Deno Land - Deno ## {#deno} + +A modern runtime for JavaScript and TypeScript. + +Key: `deno` + +Website: [https://deno.com](https://deno.com) + +Repository: [https://github.com/denoland/deno](https://github.com/denoland/deno) + +## Lagon - Lagon Runtime ## {#lagon} + +Lagon is an open-source runtime and platform that allows developers to run TypeScript and JavaScript Functions at the Edge. + +Key: `lagon` + +Website: [https://lagon.app](https://lagon.app) + +Repository: [https://github.com/lagonapp/lagon](https://github.com/lagonapp/lagon) + +## Meta - React Native ## {#react-native} + +A framework for building native apps using React. This key represents supported React Native JS runtimes on native platforms (excludes react-native-web). + +Key: `react-native` + +Website: [https://reactnative.dev/](https://reactnative.dev/) + +Repository: [https://github.com/facebook/react-native](https://github.com/facebook/react-native) + +## Netlify - Edge Functions ## {#netlify} + +Edge Functions connect the Netlify platform and workflow with an open runtime standard at the network edge. + +Key: `netlify` + +Website: [https://docs.netlify.com/edge-functions/overview/](https://docs.netlify.com/edge-functions/overview/) + +Repository: [https://github.com/netlify/edge-functions](https://github.com/netlify/edge-functions) + +## OpenJS Foundation - Electron ## {#electron} + +Build cross-platform desktop apps with JavaScript, HTML, and CSS. + +Key: `electron` + +Website: [https://www.electronjs.org/](https://www.electronjs.org/) + +Repository: [https://github.com/electron/electron](https://github.com/electron/electron) + +## OpenJS Foundation - Node.js ## {#node} + +Node.js is an open-source, cross-platform JavaScript runtime environment. + +Key: `node` + +Website: [https://nodejs.org](https://nodejs.org) + +Repository: [https://github.com/nodejs/node](https://github.com/nodejs/node) + +## Oven - Bun ## {#bun} + +Incredibly fast JavaScript runtime, bundler, transpiler and package manager - all in one. + +Key: `bun` + +Website: [https://bun.sh/](https://bun.sh/) + +Repository: [https://github.com/oven-sh/bun](https://github.com/oven-sh/bun) + +## Vercel - Edge Light ## {#edge-light} + +Developing, testing, and defining the runtime Web APIs for Edge infrastructure. + +Key: `edge-light` + +Website: [https://edge-runtime.vercel.app/](https://edge-runtime.vercel.app/) + +Repository: [https://github.com/vercel/edge-runtime](https://github.com/vercel/edge-runtime) + + + +Key Management {#key-management} +================================ + +## Adding a key ## {#adding-a-key} + +All JavaScript runtimes are welcome to create a key and add it to this list. New keys must not conflict with another existing key. Runtime entries on this list are encouraged, but not required, to participate in the community group. + +To propose a new key, create a pull request in [runtime-keys](https://github.com/wintercg/runtime-keys) repository that adds the desired key to the `index.bs` file using the following format: + +```md +##