👀 Extension Architecture / API

[jasonplatts]

Overview

Support for JS/TS extensions is planned for the initial release of CodeEdit. The extension system will provide similar capabilities to that of other editors, such as VS Code.

Contributing

If you wish to contribute to building the CodeEdit extension architecture, please see the tasks below and review the relevant parts of the API documentation repository. This documentation should be used as the guide for development.

PLEASE NOTE THE DOCUMENTATION IS STILL WORK IN PROGRESS. TASKS AND THEIR RELATED GITHUB ISSUES WILL BE UPDATED AS THE RELEVANT DOCUMENTATION IS COMPLETED.

Each API feature functionality first needs to be built into CodeEdit so that it can be used internally by the application and then later exposed to extensions through the API.

Tasks

• 💬 Determine Extension Architecture #180
• ✄1�7 Extension Store #183
• ✄1�7 Snippets #167
• ✄1�7 Code Completion Provider CodeEditTextView#32
• ✄1�7 Hover Provider Extension API #391
• ✄1�7 Commands #222
• ✄1�7 Tree Data Provider (Sidebar Tree View Content) #220
• ✄1�7 Language Server Protocol CodeEditTextView#40
• ✄1�7 Keybindings #224
• ✄1�7 Tasks (Run scripts in the shell) #262
• ✄1�7 Debugger Extension API #392
• Data Storage
• Display Notifications
• Themes
• Custom UI support with React Components
• Extension Debug Console
• ✄1�7 Help Documentation #107

References

• Atom Extension API
• VS Code Extension API
• VS Code Extension Examples
• Raycast Extension API
• Nova Extension API
• Sketch Extension API

[jaydenseric]

If extensions have a JS API, it would be great if they can be standard ESM instead of CJS like Nova requires for its extensions:

https://docs.nova.app/extensions/#javascript-modules

CJS makes it tricky (but not impossible) to author extensions using Deno or other standards-aligned tooling without introducing a build step.

[jaydenseric]

Related: CodeEditApp/CodeEditTextView#40 .

[jasonplatts]

Hi @jaydenseric.

Thanks for joining the discussion. @austincondiff and I talked about this and it has been brought up in our Discord too.

Since it is early in the development, no decisions have been made in relation to the extension architecture. JavaScript Core (https://developer.apple.com/documentation/javascriptcore) has been mentioned as a possible option for implementing extensions. Unfortunately, as far as I am aware, it does not support ESM.

Having developed some extensions for Nova, I know this has been a frustration shared by other devs too. And, hopefully we can find a final solution that supports ESM. We also have an extensions channel in our Discord if you would like to get involved in the conversation.