openidea/wit/plugin.wit

/// OpenIDEA plugin API, version 1.0. Once released, 1.x only adds (new
/// interfaces, new optional exports; plugins/README.md, "Evolving the plugin
/// API"); a 2.0 keeps 1.0 running through an adapter in the host.
///
/// A plugin is a WebAssembly component targeting the `plugin` world (or
/// `plugin-syntax`). It runs sandboxed: no filesystem, network, environment
/// or processes beyond WASI's clocks and randomness; everything else goes
/// through the imports below, gated by the capabilities granted in
/// `plugin.toml` (a missing one returns `error::denied`).
package openidea:[email protected];

world plugin {
    import log;
    import ui;
    import storage;
    import workspace;
    import editor;
    import invocation;
    import vcs;
    import commit;
    import events;
    import tasks;
    import diagnostics;
    import net;
    import secrets;
    import process;
    import views;
    import settings;

    export lifecycle;
    export commands;
    export event-handler;
}

/// A plugin that also provides syntax for its languages.
world plugin-syntax {
    include plugin;
    export syntax-provider;
}

/// A plugin with editor providers (`[[contributes.providers]]`).
world plugin-providers {
    include plugin;
    export providers;
}

/// A plugin with views or custom editors (`[[contributes.views]]`,
/// `[[contributes.custom-editors]]`).
world plugin-views {
    include plugin;
    export view-provider;
}

/// A plugin with a document indexer (`[[contributes.documentIndexers]]`).
world plugin-indexing {
    include plugin;
    export document-indexer;
}

world plugin-semantic-tokens {
    include plugin;
    export semantic-tokens-provider;
}

world plugin-hover {
    include plugin;
    export hover-provider;
}

/// A plugin with inlay hints (`inlay-hints` under `[[contributes.providers]]`).
world plugin-inlay-hints {
    include plugin;
    export inlay-hints-provider;
}

/// A plugin whose views show in the Services tool window
/// (`location = "services"`): their nodes' detail pane.
world plugin-details {
    include plugin;
    export detail-provider;
}

/// A plugin with before-commit checks (`[[contributes.commitChecks]]`).
world plugin-commit-checks {
    include plugin;
    export commit-checker;
}

/// Only the `syntax-provider` export: guests generate it next to `plugin`
/// (the component tools merge both into one component).
world syntax {
    export syntax-provider;
}

/// Only the `providers` export, generated next to `plugin` like `syntax`.
world editor-providers {
    export providers;
}

/// Only the `view-provider` export, generated next to `plugin` like `syntax`.
world views-provider {
    export view-provider;
}

/// Only the `document-indexer` export, generated next to `plugin` like `syntax`.
world indexing {
    export document-indexer;
}

world semantic-tokens {
    export semantic-tokens-provider;
}

world hover {
    export hover-provider;
}

/// Only the `inlay-hints-provider` export, generated next to `plugin` like `syntax`.
world inlay-hints {
    export inlay-hints-provider;
}

/// Only the `detail-provider` export, generated next to `plugin` like `syntax`.
world details {
    export detail-provider;
}

/// Only the `commit-checker` export, generated next to `plugin` like `syntax`.
world commit-checks {
    export commit-checker;
}