Skip to content

A lightweight WebAssembly runtime that is fast, secure, and standards-compliant

Document component model proposal statuses (#14263)

Alex Crichton97c6cc1b8387
diff --git a/docs/stability-wasm-proposals.md b/docs/stability-wasm-proposals.md
index be43b8f5ce..375cb9091c 100644
--- a/docs/stability-wasm-proposals.md
+++ b/docs/stability-wasm-proposals.md
@@ -111,12 +111,52 @@ The emoji legend is:
[`custom-page-sizes`]: https://github.com/WebAssembly/custom-page-sizes
[`compact-import-section`]: https://github.com/WebAssembly/compact-import-section
+## Component-Model Proposals
+
+Changes to the component model aren't currently of the same shape as changes to
+core WebAssembly itself. There are not proposal repositories at this time but
+instead the main specification has "emoji gates" where parts of the
+specification are considered gated when the descriptive text or binary form is
+annotated with a specific emoji. This is the status of the emojis and
+implementations within Wasmtime.
+
+**On-by-default proposals**
+
+| Proposal | Emoji | Phase 4 | Tests | Finished | Fuzzed | API | C API |
+|---------------------------|-------|---------|-------|----------|--------|-----|--------|
+| async | πŸ”€ | βœ… | βœ… | βœ… | βœ… | βœ… | 🚧[^c1]|
+
+**Off-by-default proposals**
+
+| Proposal | Emoji | Phase 4 | Tests | Finished | Fuzzed | API | C API |
+|---------------------------|-------|---------|-------|----------|--------|-----|--------|
+| map | πŸ—ΊοΈ | βœ… | βœ… | βœ… | βœ… | βœ… | βœ… |
+| implements | 🏷️ | βœ… | βœ… | βœ… | ❌ | βœ… | βœ… |
+| more async options [^c2] | 🚝 | ❌ | βœ… | ❌ | ❌ | βœ… | βœ… |
+| stackful async [^c2] | 🚟 | ❌ | βœ… | ❌ | ❌ | βœ… | βœ… |
+| threading | 🧡 | ❌ | βœ… | ❌ | ❌ | βœ… | ❌ |
+| fixed-length-lists | πŸ”§ | ❌ | βœ… | 🚧 | ❌ | βœ… | ❌ |
+| memory64 | 🐘 | ❌ | 🚧 | 🚧 | ❌ | 🚧 | ❌ |
+| error-context [^c2] | πŸ“ | ❌ | ❌ | ❌ | ❌ | 🚧 | ❌ |
+| values | πŸͺ™ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| nested names | πŸͺΊ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| canonical names | πŸ”— | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| shared-everything-threads | πŸ§΅β‘‘ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+
+[^c1]: Tracked in [#13705](https://github.com/bytecodealliance/wasmtime/issues/13705)
+[^c2]: These features were sliced out of the original async proposal for the
+ component model but the implementation remains in Wasmtime.
+
+
+
## Feature requirements
For each column in the above tables, this is a further explanation of its meaning:
* **Phase 4** - The proposal must be in phase 4, or greater, of [the
- WebAssembly standardization process][phases].
+ WebAssembly standardization process][phases]. For component model proposals
+ this means that the WASI subgroup has voted to include this feature in a
+ release of WASI
* **Tests** - All spec tests must be passing in Wasmtime and where appropriate
Wasmtime-specific tests, for example for the API, should be passing. Tests