The IDE you know, rebuilt in Rust. IntelliJ IDEA–style keymap, tool windows and search-everywhere in a fast native app: editor, code insight, debugger, Git, terminal, database and HTTP clients for 60+ languages.
TypeScript code-editorcross-platformdapdatabase-clientdebuggerdesktop-appdeveloper-toolsgithttp-clientideintellijlsprusttauriterminal
docs(plugins): describe released plugin API versions as frozen
l0ng-ai7d267ab50edd
diff --git a/plugins/README.md b/plugins/README.mdindex e1050a18d..6fe018090 100644--- a/plugins/README.md+++ b/plugins/README.md@@ -11,9 +11,10 @@ editors, and contribute menus, shortcuts, settings, themes, file icon themesand languages. Plugins that only contribute data (themes, icons, languages,menus, settings) need no code at all.-> **Preview.** The plugin system ships as a preview: until it is declared-> stable the API (`openidea:[email protected]`) may still change, and the official-> plugins are versioned `0.x`. See _Evolving the plugin API_ below.+> **Preview.** The plugin system ships as a preview and the official plugins+> are versioned `0.x`. Released API versions only grow: a plugin built for+> `openidea:[email protected]` keeps loading in later 1.x IDEs. See _Evolving the+> plugin API_ below.```plugins/@@ -919,8 +920,8 @@ the API itself follows _Evolving the plugin API_ below.## 10. Evolving the plugin API-While the plugin system is a preview the API may still change freely. Once it-is declared stable wasmtime decides what stays compatible: it resolves interface names+Released versions are frozen: 1.0.0 shipped with OpenIDEA 0.1.36 and 1.1.0+with 0.1.37. wasmtime decides what stays compatible: it resolves interface namesby semver (a component importing `openidea:plugin/[email protected]` links against ahost defining `@1.1.0`, and the host finds its exports the same way), butfunction types must match exactly — a record with another field count, or a@@ -960,7 +961,7 @@ Checked automatically:- SDK `tests/api_frozen.rs`: `tests/api/<version>/` holds the WIT of eachreleased version; every interface, type, function and world import orexport in it must still exist unchanged in `wit/` (rules 1–3). Copy `wit/`- there when releasing; there is no snapshot before the first release.+ there when a version ships.- `crates/ide-plugin/tests/api_compat.rs`: the versions agree, the SDK's copymatches, the version check (rules 4, 5); a simulated next-minor host (everyimport stubbed at the newer version, plus extra functions and an extra