Ember Language Server

The Ember Language Server (ELS) implements the Language Server Protocol for Ember.js projects. ELS enables editors to provide features like auto complete, goto definition and diagnostics. To get these features, you have to install the plugin for your editor.

Features

All features currently only work in Ember CLI application that use the default classic structure, and are a rough first draft with a lot of room for improvements. Pods and addons are not supported yet.

Autocompletion
- *.{js/ts}: services, models, routes, transforms
- *.hbs: components, route names, helpers, modifiers, local paths, arguments
- Namespaces support (batman syntax)
Template linting
- works only if ember-template-lint dependency added into project.
- ember-template-lint (v2, v3, v4) integration, including documentation links and auto fixes
- template linting inside .js and .ts files (with hbs literal)
- experimental linting inside .gjs and .gts files (with <template> tag)
Definition providers for (enable features like "Go To Definition" or "Peek Definition"):
- Components (in Templates)
- Helpers (in Templates)
- Modifiers (in Templates)
- Models
- Transforms
- Component imports (from addons)
- Namespace components (batman syntax)
Route autocompletion in link-to and <LinkTo> components.
Outlet jumping
Workspaces support
Supports Ignoring of LS initialization on unneeded projects by using ignoredProjects config option, if you need "exclude except" functionality, specify project name as !my-project.

Editor Plugins

VSCode: Unstable Ember Language Server
Neo (Vim): coc-ember, native LSP integration
Emacs using lsp-mode
GitPod, Onivim, Coder, VSCodium, and Theia using Open VSX

Addons available for install

els-addon-glint - Glint integration addon.
els-a11y-addon - Ember Language Server a11y addon.
els-addon-typed-templates - Typed Templates for Ember.
els-addon-docs - Ember Language Server Addon Docs Completion Provider.
ember-fast-cli - Addon for Ember-cli commands execution.
els-component-extraction-addon - Component extraction addon.
els-intl-addon - Ember-Intl, Ember-i18n autocomplete.

Addon notes:

all addons could be added as dev-dependency for a project
dev-dependency installation allow us to have independent versions of addons for different projects
for global addon installation check LS settings in your editor (you have to specify path to addon root in LS config)
you could build your project-specific addon

Integration details

Server entrypoints

lib/start-server.js - nodejs

lib/start-worker-server.js - worker

Server options

new Server({fs, type})

fs - available options:

sync - LS should use nodejs.fs logic
async - LS should use client's fs provider

type - available options:

node - supported addons & require logic
worker - addons and require logic not supported

Debugging

Changelog

License

MIT

ember-tooling/ember-language-server