# @theia/monaco > Theia - Monaco Extension Latest version **1.75.0** (published 2026-08-27) · EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0 license · 0 weekly downloads ## Install ```sh npm install @theia/monaco pnpm add @theia/monaco yarn add @theia/monaco bun add @theia/monaco ``` ## Health **Score 65/100 (B)** — status: active. Positive: no vulnerabilities; has provenance; recently updated; high maintenance score; popular repo. Warnings: low downloads; no types; no esm support. ## Facts | | | |---|---| | Version | 1.75.0 | | Published | 2026-08-27 | | First published | 2017-07-24 | | Weekly downloads | 0 | | License | EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0 | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 13 | | Unpacked size | 1.6 MB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 21693 | | Maintainers | eclipsetheia, vince-fugnitto, bhufmann, marc.dumais, paul-marechal, msujew, tsmaeder, jfaltermeier, jhelming, eclipse-theia-bot, sgraband, ndoschek | | Keywords | theia-extension | ## Links - npm: https://www.npmjs.com/package/@theia/monaco - Repository: https://github.com/eclipse-theia/theia - Issues: https://github.com/eclipse-theia/theia/issues - npm.io page: https://npm.io/package/@theia/monaco ## Dependencies (13) - [idb](https://npm.io/package/idb.md) ^4.0.5 - [tslib](https://npm.io/package/tslib.md) ^2.8.1 - [fast-plist](https://npm.io/package/fast-plist.md) ^0.1.3 - [@theia/core](https://npm.io/package/@theia/core.md) 1.75.0 - [jsonc-parser](https://npm.io/package/jsonc-parser.md) ^3.3.1 - [@theia/editor](https://npm.io/package/@theia/editor.md) 1.75.0 - [@theia/markers](https://npm.io/package/@theia/markers.md) 1.75.0 - [vscode-textmate](https://npm.io/package/vscode-textmate.md) ^9.3.2 - [@theia/workspace](https://npm.io/package/@theia/workspace.md) 1.75.0 - [vscode-oniguruma](https://npm.io/package/vscode-oniguruma.md) 2.0.1 - [@theia/filesystem](https://npm.io/package/@theia/filesystem.md) 1.75.0 - [@theia/outline-view](https://npm.io/package/@theia/outline-view.md) 1.75.0 - [@theia/monaco-editor-core](https://npm.io/package/@theia/monaco-editor-core.md) 1.108.201 ## Recent versions - 1.75.0 (latest) — 2026-08-27 - 1.76.0-next.28 (next) — 2026-09-16 - 1.64.4 (patch) — 2025-10-10 - 0.4.0-testnext.d1b1bc8c (testnext) — 2019-01-22 - 1.76.0-next.23 — 2026-09-15 - 1.76.0-next.18 — 2026-09-14 - 1.76.0-next.16 — 2026-09-11 - 1.76.0-next.14 — 2026-09-10 - 1.76.0-next.10 — 2026-09-09 - 1.76.0-next.7 — 2026-09-08 - 1.76.0-next.6 — 2026-09-04 - 1.76.0-next.4 — 2026-09-03 - 1.76.0-next.0 — 2026-08-28 - 1.75.0-next.46 — 2026-08-27 - 1.75.0-next.43 — 2026-08-26 - … 3599 more at https://npm.io/package/@theia/monaco/versions ## README

theia-ext-logo

ECLIPSE THEIA - MONACO EXTENSION

## Description The `@theia/monaco` extension contributes the integration of the [monaco-editor](https://microsoft.github.io/monaco-editor/).\ This includes: - full-feature code editor - diff-editor - code snippets - textmate grammars (theme registry, service) ## Monaco Uplifts This package is intended to be the interface between the `@theia/monaco-editor-core` package, the project's bundling of the `monaco-editor-core` package published by the VSCode team, and the rest of the application. When we uplift to a new version of `monaco-editor-core`, this package will need to be checked particularly thoroughly. To facilitate that process, the steps for undertaking a Monaco uplift are outlined here. ### Setting up the VSCode side 1. Clone the VSCode repo and make sure you have the following remotes: - - the official VSCode repo. - - the fork used for building `@theia/monaco-editor-core`. 2. Find the latest release tag in the official VSCode repo, and the most recent uplift branch in the fork. > At the time of this writing the latest release tag is `1.108.2`, and the uplift branch is `monaco_uplift_1.108.2` () 3. Check out the release tag, cherry pick the tip of the uplift branch, and resolve any conflicts. > As you resolve conflicts and make changes to the VSCode repo, make sure you end up with a single commit on the uplift branch to make it easier for the next person to rebase. 4. Try to build. At the moment, this means running `npm install` and `npm run gulp editor-distro`. 5. Fix any build errors that arise. 6. Change the version in `build/monaco/package.json` #### Current State - build/gulpfile.editor.js: various changes to modify the treeshaking and output destinations (shakeLevel 0 — file-level only, no class-member shaking). - build/lib/standalone.js/ts: changes to output sourcemaps and declarations (`declaration: true`, `sourceMap: true`, `moduleResolution: Classic`). - src/vs/base/browser/dompurify/dompurify.js: changes for CommonJS rather than ESM (`module.exports` added). - src/vs/base/common/marked/marked.js: changes for CommonJS rather than ESM (`module.exports` added). - src/vs/base/common/platform.ts: guards `setTimeout0` with `$globalThis.addEventListener` check for non-browser environments. - build/monaco/esm.core.js: added `embeddedDiffEditorWidget` import to `editor.all.ts`. ### Setting up the Theia side For initial testing, it's easier to point dependencies to your local VSCode. 1. Having built `monaco-editor-core` using the steps [above](#setting-up-the-vscode-side). 2. Find all references to `@theia/monaco-editor-core` in `package.json`s and replace their version with `"file://vscode/out-monaco-editor-core"`. > Using `file:` means that if you subsequently make changes on the VSCode side, you only need to rebuild VSCode and then rebuild Theia to see the effects. 3. Delete your `node_modules` and `npm install` and build Theia. 4. Fix any build errors. 5. Uncomment the `bindMonacoPreferenceExtractor` function in `examples/api-samples/src/browser/monaco-editor-preferences/monaco-editor-preference-extractor.ts` and run the commands there. Fix the `EditorGeneratedPreferenceSchema` as necessary, and add or remove validations from the `MonacoFrontendApplicationContribution` as appropriate. 6. Look for comments that indicate forced types or other code smells that would prevent a build error from being thrown where it should be thrown and check that the assertion still applies. > If you add these, mark them with @monaco-uplift - that'll make them easier to find in the future. Better: if you can remove them, do! Typically, the cause is mixing imports from private API and public API. Often public API fails to satisfy private declarations. 7. Test the application thoroughly - make sure everything's still working. > It may also be necessary to update our various `vscode` dependencies to match the current state of VSCode. It may not be necessary to upgrade all (or any) of these to successfully adopt a new Monaco version, but if something is misbehaving inexplicably, checking dependencies is a reasonable place to start. Check on: > > - `vscode-languageserver-protocol` > - `vscode-oniguruma` > - `vscode-textmate` > - `vscode-uri` ### Publishing for testing Once you believe that everything is in working order, you'll need to publish the new `@theia/monaco-editor-core` for testing. You can use `npm pack` in the `out-monaco-editor-core/` directory of the VSCode fork to create a tarball, then publish it. Once the package is published, point your `package.json`s at the testing version and make sure everything still works, then make a PR. ## Additional Information - [API documentation for `@theia/monaco`](https://eclipse-theia.github.io/theia/docs/next/modules/_theia_monaco.html) - [Theia - GitHub](https://github.com/eclipse-theia/theia) - [Theia - Website](https://theia-ide.org/) ## License - [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/) - [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp) ## Trademark "Theia" is a trademark of the Eclipse Foundation # Theia - Monaco Extension See [here](https://www.theia-ide.org/doc/index.html) for a detailed documentation. ## License - [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/) - [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp) --- _Source: https://npm.io/package/@theia/monaco · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._