diff --git a/.azure-pipelines/publish-nightly.yml b/.azure-pipelines/publish-nightly.yml
new file mode 100644
index 00000000..1569a2ef
--- /dev/null
+++ b/.azure-pipelines/publish-nightly.yml
@@ -0,0 +1,106 @@
+###############################################################################################
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+###############################################################################################
+name: $(Date:yyyyMMdd)$(Rev:.r)
+
+trigger: none
+pr: none
+
+schedules:
+ - cron: '0 7 * * *'
+ displayName: Daily release
+ branches:
+ include:
+ - main
+ always: true
+
+resources:
+ repositories:
+ - repository: templates
+ type: github
+ name: microsoft/vscode-engineering
+ ref: main
+ endpoint: Monaco
+
+parameters:
+ - name: publishMonacoEditorCore
+ displayName: 🚀 Publish Monaco Editor Core
+ type: boolean
+ default: true
+ - name: publishMonacoEditor
+ displayName: 🚀 Publish Monaco Editor
+ type: boolean
+ default: true
+ - name: vscodeRef
+ displayName: The VS Code commit id.
+ type: string
+ default: 'main'
+ - name: prereleaseVersion
+ displayName: The prerelease version.
+ type: string
+ default: 'dev-${today}'
+
+extends:
+ template: azure-pipelines/npm-package/pipeline.yml@templates
+ parameters:
+ cgIgnoreDirectories: $(Build.SourcesDirectory)/dependencies/vscode
+ npmPackages:
+ - name: monaco-editor-core
+ workingDirectory: $(Build.SourcesDirectory)/dependencies/vscode/out-monaco-editor-core
+ testPlatforms: []
+ skipAPIScan: true # package build requires Linux
+ buildSteps:
+ - task: NodeTool@0
+ inputs:
+ versionSource: fromFile
+ versionFilePath: .nvmrc
+
+ - script: sudo apt install -y libkrb5-dev
+ displayName: Install libkrb5-dev
+
+ - script: npm ci
+ displayName: Install NPM dependencies
+
+ - script: npx playwright install --with-deps
+ displayName: Install Playwright Dependencies
+
+ - script: yarn ts-node ./scripts/ci/build-monaco-editor-core-pkg nightly
+ env:
+ VSCODE_REF: ${{ parameters.vscodeRef }}
+ PRERELEASE_VERSION: ${{ parameters.prereleaseVersion }}
+ retryCountOnTaskFailure: 5
+ displayName: Setup, Build & Test monaco-editor-core
+
+ tag: next
+ ghCreateTag: false
+ publishPackage: ${{ parameters.publishMonacoEditorCore }}
+ publishRequiresApproval: false
+
+ - name: monaco-editor
+ dependsOn: monaco-editor-core
+ workingDirectory: $(Build.SourcesDirectory)/out/monaco-editor
+ testPlatforms: []
+ skipAPIScan: true # package build requires Linux
+ buildSteps:
+ - task: NodeTool@0
+ inputs:
+ versionSource: fromFile
+ versionFilePath: .nvmrc
+
+ - script: npm ci
+ displayName: Install NPM dependencies
+
+ - script: npx playwright install --with-deps
+ displayName: Install Playwright Dependencies
+
+ - script: yarn ts-node ./scripts/ci/build-monaco-editor-pkg nightly
+ env:
+ VSCODE_REF: ${{ parameters.vscodeRef }}
+ PRERELEASE_VERSION: ${{ parameters.prereleaseVersion }}
+ retryCountOnTaskFailure: 5
+ displayName: Setup, Build & Test monaco-editor
+
+ tag: next
+ publishPackage: ${{ parameters.publishMonacoEditor }}
+ publishRequiresApproval: false
diff --git a/.azure-pipelines/publish-stable.yml b/.azure-pipelines/publish-stable.yml
new file mode 100644
index 00000000..1d4290ed
--- /dev/null
+++ b/.azure-pipelines/publish-stable.yml
@@ -0,0 +1,105 @@
+###############################################################################################
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+###############################################################################################
+name: $(Date:yyyyMMdd)$(Rev:.r)
+
+trigger: none
+pr: none
+
+resources:
+ repositories:
+ - repository: templates
+ type: github
+ name: microsoft/vscode-engineering
+ ref: main
+ endpoint: Monaco
+
+parameters:
+ - name: publishMonacoEditorCore
+ displayName: 🚀 Publish Monaco Editor Core
+ type: boolean
+ default: false
+ - name: publishMonacoEditor
+ displayName: 🚀 Publish Monaco Editor
+ type: boolean
+ default: false
+ - name: publishWebpackPlugin
+ displayName: 🚀 Publish Webpack Plugin
+ type: boolean
+ default: false
+
+extends:
+ template: azure-pipelines/npm-package/pipeline.yml@templates
+ parameters:
+ cgIgnoreDirectories: $(Build.SourcesDirectory)/dependencies/vscode
+ npmPackages:
+ - name: monaco-editor-core
+ workingDirectory: $(Build.SourcesDirectory)/dependencies/vscode/out-monaco-editor-core
+ testPlatforms: []
+ skipAPIScan: true # package build requires Linux
+ buildSteps:
+ - task: NodeTool@0
+ inputs:
+ versionSource: fromFile
+ versionFilePath: .nvmrc
+
+ - script: sudo apt install -y libkrb5-dev
+ displayName: Install libkrb5-dev
+
+ - script: npm ci
+ displayName: Install NPM dependencies
+
+ - script: npx playwright install --with-deps
+ displayName: Install Playwright Dependencies
+
+ - script: yarn ts-node ./scripts/ci/build-monaco-editor-core-pkg stable
+ displayName: Setup, Build & Test monaco-editor-core
+
+ tag: latest
+ ghCreateTag: false
+ publishPackage: ${{ parameters.publishMonacoEditorCore }}
+ publishRequiresApproval: false
+
+ - name: monaco-editor
+ dependsOn: monaco-editor-core
+ workingDirectory: $(Build.SourcesDirectory)/out/monaco-editor
+ testPlatforms: []
+ skipAPIScan: true # package build requires Linux
+ buildSteps:
+ - task: NodeTool@0
+ inputs:
+ versionSource: fromFile
+ versionFilePath: .nvmrc
+
+ - script: npm ci
+ displayName: Install NPM dependencies
+
+ - script: npx playwright install --with-deps
+ displayName: Install Playwright Dependencies
+
+ - script: yarn ts-node ./scripts/ci/build-monaco-editor-pkg stable
+ displayName: Setup, Build & Test monaco-editor
+
+ tag: latest
+ publishPackage: ${{ parameters.publishMonacoEditor }}
+ publishRequiresApproval: false
+
+ - name: monaco-editor-webpack-plugin
+ dependsOn: monaco-editor
+ workingDirectory: $(Build.SourcesDirectory)/webpack-plugin
+ testPlatforms: []
+ packagePlatform: Windows
+ buildSteps:
+ - script: npm ci
+ displayName: Install NPM dependencies
+ workingDirectory: $(Build.SourcesDirectory)/webpack-plugin
+
+ - script: npm run compile
+ displayName: Build plugin
+ workingDirectory: $(Build.SourcesDirectory)/webpack-plugin
+
+ tag: latest
+ ghCreateTag: false
+ publishPackage: ${{ parameters.publishWebpackPlugin }}
+ publishRequiresApproval: false
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 00000000..fe946b2a
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,8 @@
+{
+ "image": "mcr.microsoft.com/devcontainers/typescript-node",
+ "customizations": {
+ "vscode": {
+ "extensions": ["ms-vscode.js-debug-nightly"]
+ }
+ }
+}
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 00000000..176a458f
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+* text=auto
diff --git a/.github/ISSUE_TEMPLATE/1_bug_report.yaml b/.github/ISSUE_TEMPLATE/1_bug_report.yaml
new file mode 100644
index 00000000..fbd09bf3
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/1_bug_report.yaml
@@ -0,0 +1,57 @@
+name: Bug Report
+description: File a bug report
+title: '[Bug] '
+body:
+ - type: markdown
+ attributes:
+ value: |
+ To help us processing your bug report, please fill out this form.
+ - type: checkboxes
+ id: reproducible-in-vscode
+ attributes:
+ label: Reproducible in vscode.dev or in VS Code Desktop?
+ description: Can you reproduce the bug in [vscode.dev](https://vscode.dev) or in VS Code Desktop? If so, please create [an issue in the VS Code repository](https://github.com/microsoft/vscode/issues). **VS Code issues are usually looked at within a couple of days.**
+ options:
+ - label: Not reproducible in [vscode.dev](https://vscode.dev) or VS Code Desktop
+ required: true
+ - type: checkboxes
+ id: reproducible-in-monaco-playground
+ attributes:
+ label: Reproducible in the monaco editor playground?
+ description: Can you reproduce the bug in [the monaco editor playground](https://microsoft.github.io/monaco-editor/playground.html)? A minimal reproducible example will make it significantly easier for us to get this bug fixed.
+ options:
+ - label: Not reproducible in [the monaco editor playground](https://microsoft.github.io/monaco-editor/playground.html)
+ - type: textarea
+ id: playgroundLink
+ attributes:
+ label: Monaco Editor Playground Link
+ description: Please share the link to the [monaco editor playground](https://microsoft.github.io/monaco-editor/playground.html) after you entered your example. In case of regressions, please also provide the first broken version.
+
+ - type: textarea
+ id: playgroundSourceCode
+ attributes:
+ label: Monaco Editor Playground Code
+ description: Please provide the code from the monaco editor playground example.
+ render: typescript
+ - type: textarea
+ id: steps
+ attributes:
+ label: Reproduction Steps
+ description: Please describe the steps (in the playground) that lead to the problematic behavior
+ - type: textarea
+ id: actual-behavior
+ attributes:
+ label: Actual (Problematic) Behavior
+ description: Please describe the actual (problematic) behavior, as observed in the playground.
+
+ - type: textarea
+ id: expected-behavior
+ attributes:
+ label: Expected Behavior
+ description: Please describe the expected behavior.
+
+ - type: textarea
+ id: additional-context
+ attributes:
+ label: Additional Context
+ description: Please provide additional context.
diff --git a/.github/ISSUE_TEMPLATE/2_feature_request.yaml b/.github/ISSUE_TEMPLATE/2_feature_request.yaml
new file mode 100644
index 00000000..09d8eccf
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/2_feature_request.yaml
@@ -0,0 +1,38 @@
+name: Feature Request
+description: Suggest an idea for this project
+title: '[Feature Request] '
+labels:
+ - 'feature-request'
+body:
+ - type: markdown
+ attributes:
+ value: |
+ To help us efficiently reviewing your feature request, please fill out this form.
+ - type: checkboxes
+ id: not
+ attributes:
+ label: Context
+ options:
+ - label: This issue is not a bug report. *(please use a different template for reporting a bug)*
+ required: true
+ - label: This issue is not a duplicate of an existing issue. *(please use the [search](https://github.com/microsoft/monaco-editor/issues) to find existing issues)*
+ required: true
+
+ - type: textarea
+ id: description
+ attributes:
+ label: Description
+ description: Please describe your feature request.
+
+ - type: textarea
+ id: relevantCodePlaygroundLink
+ attributes:
+ label: Monaco Editor Playground Link
+ description: If applicable, please share the link to a relevant [monaco editor playground sample](https://microsoft.github.io/monaco-editor/playground.html)
+
+ - type: textarea
+ id: releveantCode
+ attributes:
+ label: Monaco Editor Playground Code
+ description: If applicable, please share the code from the monaco editor playground sample.
+ render: typescript
diff --git a/.github/ISSUE_TEMPLATE/3_other.md b/.github/ISSUE_TEMPLATE/3_other.md
new file mode 100644
index 00000000..4d915072
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/3_other.md
@@ -0,0 +1,4 @@
+---
+name: Other Request (For Maintainers Only)
+about: This issue template should only be used by maintainers.
+---
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 00000000..d530fcea
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+ - name: Question
+ url: https://stackoverflow.com/questions/tagged/monaco-editor
+ about: Please ask and answer questions here.
diff --git a/.github/commands.json b/.github/commands.json
new file mode 100644
index 00000000..23c91d03
--- /dev/null
+++ b/.github/commands.json
@@ -0,0 +1,150 @@
+[
+ {
+ "type": "comment",
+ "name": "question",
+ "allowUsers": [],
+ "action": "updateLabels",
+ "addLabel": "*question"
+ },
+ {
+ "type": "label",
+ "name": "*question",
+ "action": "close",
+ "reason": "not_planned",
+ "comment": "We closed this issue because it is a question about using Monaco Editor rather than an issue or feature request. Please search for help on [StackOverflow](https://stackoverflow.com/questions/tagged/monaco-editor), where the community has already answered many similar questions. See also our [issue reporting guidelines](https://github.com/microsoft/monaco-editor#contributing).\n\nHappy Coding!"
+ },
+ {
+ "type": "label",
+ "name": "*out-of-scope",
+ "action": "close",
+ "reason": "not_planned",
+ "comment": "We closed this issue because we don't plan to address it in the foreseeable future. If you disagree and feel that this issue is crucial: we are happy to listen and to reconsider.\n\nThanks for your understanding, and happy coding!"
+ },
+ {
+ "type": "label",
+ "name": "wont-fix",
+ "action": "close",
+ "reason": "not_planned",
+ "comment": "We closed this issue because we don't plan to address it.\n\nThanks for your understanding, and happy coding!"
+ },
+ {
+ "type": "comment",
+ "name": "duplicate",
+ "allowUsers": [],
+ "action": "updateLabels",
+ "addLabel": "*duplicate"
+ },
+ {
+ "type": "label",
+ "name": "*duplicate",
+ "action": "close",
+ "reason": "not_planned",
+ "comment": "Thanks for creating this issue! We figured it's covering the same as another one we already have. Thus, we closed this one as a duplicate. You can search for [existing issues](https://github.com/microsoft/monaco-editor/issues).\n\nHappy Coding!"
+ },
+ {
+ "type": "comment",
+ "name": "verified",
+ "allowUsers": [
+ "@author"
+ ],
+ "action": "updateLabels",
+ "addLabel": "verified",
+ "removeLabel": "author-verification-requested",
+ "requireLabel": "author-verification-requested",
+ "disallowLabel": "unreleased"
+ },
+ {
+ "type": "comment",
+ "name": "confirm",
+ "allowUsers": [],
+ "action": "updateLabels",
+ "addLabel": "confirmed",
+ "removeLabel": "confirmation-pending"
+ },
+ {
+ "type": "comment",
+ "name": "confirmationPending",
+ "allowUsers": [],
+ "action": "updateLabels",
+ "addLabel": "confirmation-pending",
+ "removeLabel": "confirmed"
+ },
+ {
+ "type": "comment",
+ "name": "needsMoreInfo",
+ "allowUsers": [],
+ "action": "updateLabels",
+ "addLabel": "~info-needed"
+ },
+ {
+ "type": "comment",
+ "name": "closedWith",
+ "allowUsers": [],
+ "action": "close",
+ "reason": "completed",
+ "addLabel": "unreleased"
+ },
+ {
+ "type": "comment",
+ "name": "spam",
+ "allowUsers": [],
+ "action": "close",
+ "reason": "not_planned",
+ "addLabel": "invalid"
+ },
+ {
+ "__comment__": "Allows folks on the team to label issues by commenting: `\\label My-Label` ",
+ "type": "comment",
+ "name": "label",
+ "allowUsers": []
+ },
+ {
+ "type": "label",
+ "name": "~verification-steps-needed",
+ "action": "updateLabels",
+ "addLabel": "verification-steps-needed",
+ "removeLabel": "~verification-steps-needed",
+ "comment": "Friendly ping! Looks like this issue requires some further steps to be verified. Please provide us with the steps necessary to verify this issue."
+ },
+ {
+ "type": "label",
+ "name": "~info-needed",
+ "action": "updateLabels",
+ "addLabel": "info-needed",
+ "removeLabel": "~info-needed",
+ "comment": "Thanks for creating this issue! We figured it's missing some basic information or doesn't follow our issue reporting guidelines. Please take the time to review these and update the issue.\n\nHappy Coding!"
+ },
+ {
+ "type": "label",
+ "name": "~version-info-needed",
+ "action": "updateLabels",
+ "addLabel": "info-needed",
+ "removeLabel": "~version-info-needed",
+ "comment": "Thanks for creating this issue! We figured it's missing some basic information, such as a version number. Please take the time to update the issue with the Monaco Editor version you're using.\n\nHappy Coding!"
+ },
+ {
+ "type": "label",
+ "name": "~confirmation-needed",
+ "action": "updateLabels",
+ "addLabel": "info-needed",
+ "removeLabel": "~confirmation-needed",
+ "comment": "Please try to reproduce this issue with the latest version of Monaco Editor. If the issue persists, please update the issue with confirmation.\n\nHappy Coding!"
+ },
+ {
+ "type": "comment",
+ "name": "gifPlease",
+ "allowUsers": [],
+ "action": "comment",
+ "addLabel": "info-needed",
+ "comment": "Thanks for reporting this issue! Unfortunately, it's hard for us to understand what issue you're seeing. Please help us out by providing a screen recording showing exactly what isn't working as expected. While we can work with most standard formats, `.gif` files are preferred as they are displayed inline on GitHub. You may find https://gifcap.dev helpful as a browser-based gif recording tool.\n\nHappy coding!"
+ },
+ {
+ "type": "comment",
+ "name": "upstream",
+ "allowUsers": [],
+ "action": "close",
+ "reason": "not_planned",
+ "addLabel": "upstream",
+ "comment": "This issue is caused by an upstream dependency (VS Code editor core). The fix needs to happen in the [VS Code repository](https://github.com/microsoft/vscode). Please check if there's already an issue filed there, or create one if not.\n\nHappy Coding!"
+ }
+]
diff --git a/.github/publish-failure-issue-template.md b/.github/publish-failure-issue-template.md
new file mode 100644
index 00000000..2b9ead2d
--- /dev/null
+++ b/.github/publish-failure-issue-template.md
@@ -0,0 +1,7 @@
+---
+title: NPM Publishing Failed
+assignees: []
+labels: bug
+---
+
+NPM publishing failed. Check the last GitHub Action log.
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 00000000..1abda5f1
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,100 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+ build:
+ name: CI
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ with:
+ persist-credentials: false
+
+ - uses: actions/setup-node@v4
+ with:
+ node-version-file: .nvmrc
+
+ - name: Cache node modules
+ id: cacheNodeModules
+ uses: actions/cache@v4
+ with:
+ path: '**/node_modules'
+ key: ${{ runner.os }}-cacheNodeModules2-${{ hashFiles('**/package-lock.json', '**/package.json') }}
+ restore-keys: ${{ runner.os }}-cacheNodeModules2-
+
+ - name: Install build tools
+ if: steps.cache-node-modules.outputs.cache-hit != 'true'
+ run: |
+ sudo apt update -y
+ sudo apt install -y build-essential pkg-config libx11-dev libx11-xcb-dev libxkbfile-dev libnotify-bin libkrb5-dev
+
+ - name: execute `npm ci` (1)
+ if: ${{ steps.cacheNodeModules.outputs.cache-hit != 'true' }}
+ env:
+ PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: 1
+ ELECTRON_SKIP_BINARY_DOWNLOAD: 1
+ run: |
+ npm ci
+
+ - name: Download Playwright
+ run: npx playwright install --with-deps
+
+ - name: execute `npm ci` (2)
+ if: ${{ steps.cacheNodeModules.outputs.cache-hit != 'true' }}
+ run: npm ci --prefix webpack-plugin
+
+ # CI steps temporarily disabled (enable by end of august 2025)
+ # #
+ # - name: Setup, Build & Test monaco-editor-core
+ # run: yarn ts-node ./scripts/ci/build-monaco-editor-core-pkg nightly
+ # env:
+ # VSCODE_REF: 'main'
+ # PRERELEASE_VERSION: 'dev-${today}'
+
+ # - name: Link monaco-editor-core
+ # run: npm link
+ # working-directory: ./dependencies/vscode/out-monaco-editor-core
+
+ # - name: Link monaco-editor-core
+ # run: npm link monaco-editor-core
+ # #
+
+ # TODO: prettier formatting
+ # - name: Check prettier
+ # run: npm run prettier-check
+
+ - name: Build
+ run: npm run build
+
+ - name: Run unit tests
+ run: npm test
+
+ - name: Compile webpack plugin
+ run: npm run compile --prefix webpack-plugin
+
+ - name: Package using webpack plugin
+ run: npm run package-for-smoketest
+
+ # - name: Package using parcel
+ # run: npm run package-for-smoketest-parcel --prefix test/smoke/parcel
+ # Disabled for now, as the parcel bundler cannot deal with VS Code process variable
+
+ - name: Run smoke test
+ run: npm run smoketest
+
+ - name: Install website node modules
+ working-directory: website
+ run: npm ci
+
+ - name: Install most recent version of monaco-editor
+ working-directory: website
+ run: npm install monaco-editor
+
+ - name: Build website
+ working-directory: website
+ run: npm run build
+
+ - name: Test website
+ working-directory: website
+ run: npm run test
diff --git a/.github/workflows/website.yml b/.github/workflows/website.yml
new file mode 100644
index 00000000..c6446d5c
--- /dev/null
+++ b/.github/workflows/website.yml
@@ -0,0 +1,72 @@
+name: Publish Website
+
+on:
+ schedule:
+ - cron: 0 23 * * *
+ workflow_dispatch: {}
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+ group: 'pages'
+ cancel-in-progress: false
+
+jobs:
+ deploy:
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+ - uses: actions/setup-node@v4
+ with:
+ node-version-file: .nvmrc
+ - name: Cache node modules
+ id: cacheNodeModules
+ uses: actions/cache@v4
+ with:
+ path: '**/node_modules'
+ key: ${{ runner.os }}-cacheNodeModules2-${{ hashFiles('**/package-lock.json') }}
+ restore-keys: ${{ runner.os }}-cacheNodeModules2-
+ - name: execute `npm ci` (1)
+ if: ${{ steps.cacheNodeModules.outputs.cache-hit != 'true' }}
+ run: npm ci
+
+ # For TypeDoc
+ - name: Build
+ run: npm run build
+
+ - name: Install website node modules
+ working-directory: website
+ run: npm ci
+
+ - name: Install most recent version of monaco-editor
+ working-directory: website
+ run: npm install monaco-editor
+
+ - name: Build website
+ working-directory: website
+ run: npm run build
+
+ - name: Test website
+ working-directory: website
+ run: npm run test
+
+ - name: Setup Pages
+ uses: actions/configure-pages@v5
+ - name: Upload artifact
+ uses: actions/upload-pages-artifact@v3
+ with:
+ # Upload entire repository
+ path: './website/dist'
+ - name: Deploy to GitHub Pages
+ id: deployment
+ uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
index 79b9535b..678fdef0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,8 @@
-/node_modules/
-/release/
+**/node_modules/
+**/dependencies/
+/test/manual/generated/**
+/test/smoke/vite/dist/**
+/test/smoke/parcel/dist/**
+/test/smoke/parcel/.cache/**
+**/dist/
+**/out/
diff --git a/.husky/pre-commit b/.husky/pre-commit
new file mode 100755
index 00000000..6700f512
--- /dev/null
+++ b/.husky/pre-commit
@@ -0,0 +1,2 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
diff --git a/.mocharc.json b/.mocharc.json
new file mode 100644
index 00000000..9b323195
--- /dev/null
+++ b/.mocharc.json
@@ -0,0 +1,4 @@
+{
+ "delay": true,
+ "ui": "tdd"
+}
diff --git a/.nvmrc b/.nvmrc
new file mode 100644
index 00000000..5767036a
--- /dev/null
+++ b/.nvmrc
@@ -0,0 +1 @@
+22.21.1
diff --git a/.prettierignore b/.prettierignore
new file mode 100644
index 00000000..19e9315c
--- /dev/null
+++ b/.prettierignore
@@ -0,0 +1,17 @@
+**/node_modules/
+**/dist/
+**/out/
+/samples/browser-esm-parcel/.parcel-cache/
+/samples/browser-esm-parcel/dist/
+/samples/browser-esm-vite-react/dist/**/*.js
+/samples/browser-esm-webpack/dist/*.js
+/samples/browser-esm-webpack-monaco-plugin/dist/*.js
+/samples/browser-esm-webpack-small/dist/*.js
+/samples/browser-esm-webpack-typescript/dist/*.js
+/samples/browser-esm-webpack-typescript-react/dist/*.js
+/src/language/typescript/lib/
+/test/manual/generated/
+/website/lib/
+/website/typedoc/monaco.d.ts
+/test/smoke/vite/dist
+/test/smoke/parcel/dist
diff --git a/.prettierrc b/.prettierrc
new file mode 100644
index 00000000..c12f08c5
--- /dev/null
+++ b/.prettierrc
@@ -0,0 +1,8 @@
+{
+ "arrowParens": "always",
+ "singleQuote": true,
+ "trailingComma": "none",
+ "semi": true,
+ "useTabs": true,
+ "printWidth": 100
+}
diff --git a/.vscode/launch.json b/.vscode/launch.json
new file mode 100644
index 00000000..fe948a34
--- /dev/null
+++ b/.vscode/launch.json
@@ -0,0 +1,68 @@
+{
+ // Use IntelliSense to learn about possible attributes.
+ // Hover to view descriptions of existing attributes.
+ // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+ "version": "0.2.0",
+ "configurations": [
+ {
+ "name": "Monaco Editor Playground (Languages from source, needs 'npm run watch', no JSON/CSS/... workers!)",
+ "type": "chrome",
+ "request": "launch",
+ "url": "https://microsoft.github.io/monaco-editor/playground.html?sourceLanguages=http%3A%2F%2Flocalhost%3A5002%2Fout%2Flanguages%2Famd-tsc",
+ "preLaunchTask": "Launch Http Server",
+ "presentation": {
+ "group": "monaco",
+ "order": 1
+ }
+ },
+ {
+ "name": "Monaco Editor Playground (Languages locally bundled, needs 'npm run build')",
+ "type": "chrome",
+ "request": "launch",
+ "url": "https://microsoft.github.io/monaco-editor/playground.html?sourceLanguages=http%3A%2F%2Flocalhost%3A5002%2Fout%2Flanguages%2Fbundled%2Famd-dev%2Fvs",
+ "preLaunchTask": "Launch Http Server",
+ "presentation": {
+ "group": "monaco",
+ "order": 1
+ }
+ },
+ {
+ "name": "Website",
+ "type": "chrome",
+ "request": "launch",
+ "url": "http://localhost:8080/"
+ },
+ {
+ // Clone VS Code and make sure the task "Launch Http Server" runs.
+ // Then the editor is build from sources.
+ // We recommend to use the workspace feature for this.
+ "name": "Monaco Editor Playground (Load From VS Code Http Server)",
+ "type": "chrome",
+ "request": "launch",
+ "url": "https://microsoft.github.io/monaco-editor/playground.html?sourceLanguages=http%3A%2F%2Flocalhost%3A5002%2Fout%2Flanguages%2Famd-tsc&source=http%3A%2F%2Flocalhost%3A5001%2Fout%2Fvs",
+ "preLaunchTask": "Launch Http Server",
+ "presentation": {
+ "group": "monaco",
+ "order": 1
+ }
+ },
+ {
+ "type": "node",
+ "request": "launch",
+ "name": "Monaco Languages Unit Tests",
+ "skipFiles": ["/**"],
+ "program": "${workspaceRoot}/node_modules/mocha/bin/_mocha",
+ "args": ["-r", "test/unit/all.js"],
+ "outFiles": ["${workspaceFolder}/**/*.js"]
+ },
+ {
+ "type": "node",
+ "request": "launch",
+ "name": "webpack plugin test",
+ "skipFiles": ["/**"],
+ "program": "${workspaceFolder}/webpack-plugin/node_modules/.bin/webpack",
+ "args": ["--config", "test/webpack.config.js"],
+ "cwd": "${workspaceFolder}/webpack-plugin/"
+ }
+ ]
+}
diff --git a/.vscode/settings.json b/.vscode/settings.json
index 39e1c49c..6d444479 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -1,10 +1,17 @@
// Place your settings in this file to overwrite default and user settings.
{
+ "editor.tabSize": 4,
+ "editor.insertSpaces": false,
+ "files.insertFinalNewline": true,
"files.trimTrailingWhitespace": true,
"search.exclude": {
"**/node_modules": true,
- "**/bower_components": true,
- "**/release": true
+ "**/dist": true,
+ "**/out": true
},
- "typescript.tsdk": "./node_modules/typescript/lib"
-}
\ No newline at end of file
+ "typescript.tsdk": "./node_modules/typescript/lib",
+ "git.branchProtection": ["main", "release/*"],
+ "git.branchProtectionPrompt": "alwaysCommitToNewBranch",
+ "git.branchRandomName.enable": true,
+ "editor.formatOnSave": true
+}
diff --git a/.vscode/tasks.json b/.vscode/tasks.json
new file mode 100644
index 00000000..53a9eea0
--- /dev/null
+++ b/.vscode/tasks.json
@@ -0,0 +1,30 @@
+{
+ "version": "2.0.0",
+ "tasks": [
+ {
+ "label": "Launch Http Server",
+ "type": "shell",
+ "command": "node_modules/.bin/http-server --cors --port 5002 -a 127.0.0.1 -c-1",
+ "isBackground": true,
+ "problemMatcher": {
+ "pattern": {
+ "regexp": "does not support problems"
+ },
+ "background": {
+ "activeOnStart": true,
+ "beginsPattern": "Shutting down http-server (will never match)",
+ "endsPattern": "Starting up http-server"
+ }
+ },
+ "dependsOn": ["npm: watch"]
+ },
+ {
+ "type": "npm",
+ "script": "watch",
+ "group": "build",
+ "problemMatcher": ["$tsc-watch"],
+ "isBackground": true,
+ "label": "npm: watch"
+ }
+ ]
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 76e1bb0e..1e0175b1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,218 +1,1585 @@
-# Monaco Editor Change log
+# Monaco Editor Changelog
+
+## [0.55.1]
+
+- Fixes missing language exports (monaco.json/typescript/...) due to wrong "types" path - [#5123](https://github.com/microsoft/monaco-editor/issues/5123)
+
+## [0.55.0]
+
+### Breaking Changes
+- Moves nested namespaces (`languages.css`, `languages.html`, `languages.json`, `languages.typescript`) to top level namespaces (`css`, `html`, `json`, `typescript`) to simplify the build process and align with typescript recommendations.
+
+### New Features
+- Adds native LSP support (see new `lsp` namespace).
+
+### Bug Fixes
+- Updates dompurify to 3.2.7
+
+## [0.54.0]
+
+- Adds option `editor.mouseMiddleClickAction`
+- Various bug fixes
+
+## [0.53.0]
+
+- :warning: This release deprecates the AMD build and ships with significant changes of the AMD build. The AMD build will still be shipped for a while, but we don't offer support for it anymore. Please migrate to the ESM build.
+
+### New Features
+
+- Next Edit Suggestion support.
+- Scroll On Middle Click
+- Edit Context Support
+
+### Breaking Changes
+
+- Internal AMD modules are no longer accessible. Accessing internal AMD modules was never supported. While this is still possible in the ESM build, we don't encourage this usage pattern.
+- The [browser-script-editor scenario](https://github.com/microsoft/monaco-editor/blob/a4d7907bd439b06b24e334bdf2ab597bcae658b5/samples/browser-script-editor/index.html) for unbundled synchronous script import and editor creation no longer works. Instead, a the ESM build should be used with a bundler, such as vite or webpack.
+- Custom AMD workers don't work anymore out of the box.
+
+## [0.52.0]
+
+- Comment added inside of `IModelContentChangedEvent`
+
+## [0.51.0]
+
+- New fields `IEditorOptions.placeholder` and `IEditorOptions.compactMode`
+- New fields `IGotoLocationOptions.multipleTests` and `IGotoLocationOptions.alternativeTestsCommand`
+- New field `IInlineEditOptions.backgroundColoring`
+- New experimental field `IEditorOptions.experimental.useTrueInlineView`
+- New options `CommentThreadRevealOptions` for comments
+
+Contributions to `monaco-editor`:
+
+- [@ScottCarda-MS (Scott Carda)](https://github.com/ScottCarda-MS): Update Q# Keywords [PR #4586](https://github.com/microsoft/monaco-editor/pull/4586)
+
+## [0.50.0]
+
+- New field `IEditorMinimapOptions.sectionHeaderLetterSpacing`
+- New field `IOverlayWidgetPosition.stackOridinal`
+- New field `EmitOutput.diagnostics`
+- New event `IOverlayWidget.onDidLayout`
+- New events `ICodeEditor.onBeginUpdate` and `ICodeEditor.onEndUpdate`
+- `HoverVerbosityRequest.action` -> `HoverVerbosityRequest.verbosityDelta`
+- `MultiDocumentHighlightProvider.selector` changed from `LanguageFilter` to `LanguageSelector`
+- New optional parameters in `getEmitOutput`: `emitOnlyDtsFiles` and `forceDtsEmit`
+
+Contributions to `monaco-editor`:
+
+- [@htcfreek (Heiko)](https://github.com/htcfreek): Add extension to `csp.contribution.ts` [PR #4504](https://github.com/microsoft/monaco-editor/pull/4504)
+- [@jakebailey (Jake Bailey)](https://github.com/jakebailey): Call clearFiles on internal EmitOutput diagnostics, pass args down [PR #4482](https://github.com/microsoft/monaco-editor/pull/4482)
+- [@johnyanarella (John Yanarella)](https://github.com/johnyanarella): Update TypeScript to TS 5.4.5 in all projects, vendored files [PR #4305](https://github.com/microsoft/monaco-editor/pull/4305)
+- [@samstrohkorbatt](https://github.com/samstrohkorbatt): Adding Python f-string syntax support [PR #4401](https://github.com/microsoft/monaco-editor/pull/4401)
+
+## [0.49.0]
+
+- New proposed `editorHoverVerbosityLevel` API
+- New proposed `newSymbolNamesProvider` API
+
+Contributions to `monaco-editor`:
+
+- [@timotheeguerin (Timothee Guerin)](https://github.com/timotheeguerin): Add support for TypeSpec language [PR #4450](https://github.com/microsoft/monaco-editor/pull/4450)
+
+## [0.48.0]
+
+### Additions
+
+- Various bug fixes
+- Minimap Section Headers (see config option `showRegionSectionHeaders`)
+- Diff Editor Gutter Menu (see config option `renderGutterMenu`)
+- `InlineCompletionsProvider.handlePartialAccept` has `PartialAcceptInfo`
+
+Contributions to `monaco-editor`:
+
+- [@jeremy-rifkin (Jeremy Rifkin)](https://github.com/jeremy-rifkin): Fix bug with highlighting of C++ raw string literals [PR #4436](https://github.com/microsoft/monaco-editor/pull/4436)
+
+## [0.47.0]
+
+### Additions
+
+- Bug fixes
+- `registerNewSymbolNameProvider`
+- Experimental `registerInlineEditProvider`
+
+## [0.46.0]
+
+- Bug fixes
+
+## [0.45.0]
+
+### Breaking Changes
+
+- `wordBasedSuggestions: boolean` -> `'off' | 'currentDocument' | 'matchingDocuments' | 'allDocuments'`
+- `occurrencesHighlight: boolean` -> `'off' | 'singleFile' | 'multiFile'`
+
+### Additions
+
+- Many bug fixes
+- `IEditorScrollbarOptions.ignoreHorizontalScrollbarInContentHeight`
+- `IDiffEditor.goToDiff`
+- `IDiffEditor.revealFirstDiff`
+
+## [0.44.0]
+
+- Removes old diff editor implementation.
+- Custom diff algorithms no longer can be passed via diff editor options, instead a service should be used ([see #3558 for more details](https://github.com/microsoft/monaco-editor/issues/3558)).
+
+## [0.42.0]
+
+- Uses new diff editor widget by default. Use `experimental.useVersion2: false` to use the old widget. The old widget will be replaced in the next update.
+- Diff editor uses inline mode by default when width is too small. Use the config option `useInlineViewWhenSpaceIsLimited` to control this behavior.
+- Fixes broken language features when a model is created before the editor.
+
+## [0.41.0]
+
+- `IDiffEditor.diffReviewNext` was renamed to `IDiffEditor.accessibleDiffViewerNext`.
+- `IDiffEditor.diffReviewPrev` was renamed to `IDiffEditor.accessibleDiffViewerPrev`.
+- Introduces `InlineCompletionsProvider.yieldsToGroupIds` to allows inline completion providers to yield to other providers.
+- Bugfixes
+
+Contributions to `monaco-editor`:
+
+- [@claylibrarymarket](https://github.com/claylibrarymarket): Fix Twig's plain text class expression [PR #4063](https://github.com/microsoft/monaco-editor/pull/4063)
+- [@FossPrime (Ray Foss)](https://github.com/FossPrime): Use new GitHub pages workflow [PR #4000](https://github.com/microsoft/monaco-editor/pull/4000)
+- [@leandrocp (Leandro Pereira)](https://github.com/leandrocp): Elixir - Add support for multi-letter uppercase sigils [PR #4041](https://github.com/microsoft/monaco-editor/pull/4041)
+- [@philippleidig (PhilippLe)](https://github.com/philippleidig): Add TwinCAT file support for structured text (st) language [PR #3315](https://github.com/microsoft/monaco-editor/pull/3315)
+- [@remcohaszing (Remco Haszing)](https://github.com/remcohaszing)
+ - Add mdx language [PR #3096](https://github.com/microsoft/monaco-editor/pull/3096)
+ - Export custom TypeScript worker variables [PR #3488](https://github.com/microsoft/monaco-editor/pull/3488)
+ - Document some basic concepts [PR #4087](https://github.com/microsoft/monaco-editor/pull/4087)
+
+## [0.40.0]
+
+- Support for Glyph Margin Widgets
+- Removes `getDiffLineInformationForOriginal` and `getDiffLineInformationForModified` from `IDiffEditor`
+- `createTrustedTypesPolicy` is optional now
+- New option `IModelDecorationOptions.shouldFillLineOnLineBreak`
+- New option `EditorOptions.readOnlyMessage`
+
+## [0.39.0]
+
+- New method `Environment.createTrustedTypesPolicy` to override trusted types handling.
+- Bugfixes
+
+Contributions to `monaco-editor`:
+
+- [@dlitsman (Dmitry Litsman)](https://github.com/dlitsman): Extend the "Rendering Glyphs In The Margin" example to include a transparent color note. [PR #3945](https://github.com/microsoft/monaco-editor/pull/3945)
+- [@dneto0 (David Neto)](https://github.com/dneto0): Avoid a hack in the WGSL lexer [PR #3887](https://github.com/microsoft/monaco-editor/pull/3887)
+- [@spahnke (Sebastian Pahnke)](https://github.com/spahnke)
+ - [JS, TS] Add Monarch support for private identifiers [PR #3919](https://github.com/microsoft/monaco-editor/pull/3919)
+ - [JS] Add static keyword [PR #3922](https://github.com/microsoft/monaco-editor/pull/3922)
+- [@titouanmathis (Titouan Mathis)](https://github.com/titouanmathis): [Webpack Plugin] Fix CJS being injected in ESM files [PR #3933](https://github.com/microsoft/monaco-editor/pull/3933)
+
+## [0.38.0]
+
+- `diffAlgorithm` values changed: `smart` -> `legacy`, `experimental` -> `advanced`
+- New `registerEditorOpener` API
+- New property `IViewZone.showInHiddenAreas` to show view zones in hidden areas
+- New properties `InlineCompletions.suppressSuggestions` and `InlineCompletions.enableForwardStability`
+- Bugfixes
+
+Contributions to `monaco-editor`:
+
+- [@dneto0 (David Neto)](https://github.com/dneto0): Add WebGPU Shading Language tokenizer, with tests [PR #3884](https://github.com/microsoft/monaco-editor/pull/3884)
+- [@kisstkondoros (Tamas Kiss)](https://github.com/kisstkondoros): Fix reference error in convert method of OutlineAdapter [PR #3924](https://github.com/microsoft/monaco-editor/pull/3924)
+- [@tamayika](https://github.com/tamayika): Change moduleResolution to node16 and adopt TS 5.0 [PR #3860](https://github.com/microsoft/monaco-editor/pull/3860)
+
+## [0.37.1]
+
+- Fixes Inline Completions feature
+
+## [0.37.0]
+
+- New `registerLinkOpener` API
+- New `onLanguageEncountered` event for when a language is encountered during tokenization.
+- Updated TypeScript to 5.0
+- New required field `canFormatMultipleRanges` on `DocumentRangeFormattingEditProvider`
+- Bugfixes
+
+Contributions to `monaco-editor`:
+
+- [@danboo (Dan Boorstein)](https://github.com/danboo): add perl module (.pm) extension [PR #3258](https://github.com/microsoft/monaco-editor/pull/3258)
+- [@miloush (Jan Kučera)](https://github.com/miloush): Include .xsd and .xslt as an XML extension [PR #3866](https://github.com/microsoft/monaco-editor/pull/3866)
+- [@nnnnoel (Noel Kim (김민혁))](https://github.com/nnnnoel): Add CommonJS, ESM extension for TS [PR #3264](https://github.com/microsoft/monaco-editor/pull/3264)
+- [@PmcFizz (Fizz)](https://github.com/PmcFizz): opt example [PR #3726](https://github.com/microsoft/monaco-editor/pull/3726)
+- [@tamayika](https://github.com/tamayika)
+ - Fix playground samples type errors and add CI test [PR #3722](https://github.com/microsoft/monaco-editor/pull/3722)
+ - Add custom keybinding example [PR #3848](https://github.com/microsoft/monaco-editor/pull/3848)
+- [@yuri1969 (yuri)](https://github.com/yuri1969): Various YAML improvements [PR #3864](https://github.com/microsoft/monaco-editor/pull/3864)
+
+## [0.36.1]
+
+- Marks unneeded dependencies as dev dependencies.
+
+## [0.36.0]
+
+- Maintenance release
+
+## [0.35.0]
+
+- Adds sticky scrolling
+- Support for custom diff algorithms
+
+### Breaking Changes
+
+- Renamed the option `enableDropIntoEditor` to `dropIntoEditor`
+- Changed `IContentWidgetPosition.range: Range` to `IContentWidgetPosition.secondaryPosition: Position`
+- `renderFinalNewline` config: is now of type `'on' | 'off' | 'dimmed'` (was `boolean`).
+- `cursorSmoothCaretAnimation` config: is now of type `'off' | 'explicit' | 'on'` (was `boolean`)
+
+Contributions to `monaco-editor`:
+
+- [@andrewimcclement](https://github.com/andrewimcclement): Add .props & .targets as XML extensions [PR #3510](https://github.com/microsoft/monaco-editor/pull/3510)
+- [@DetachHead](https://github.com/DetachHead): add `satisfies` keyword to typescript [PR #3337](https://github.com/microsoft/monaco-editor/pull/3337)
+- [@jeremy-rifkin (Jeremy Rifkin)](https://github.com/jeremy-rifkin): Add AVX 512 types to C++ syntax highlighting [PR #3286](https://github.com/microsoft/monaco-editor/pull/3286)
+- [@joecarl (José Carlos)](https://github.com/joecarl): Add setModeConfiguration for monaco.languages.typescript.[typescript|javascript]Defaults [PR #3489](https://github.com/microsoft/monaco-editor/pull/3489)
+- [@jonatanklosko (Jonatan Kłosko)](https://github.com/jonatanklosko): Update Elixir tokenizer [PR #3453](https://github.com/microsoft/monaco-editor/pull/3453)
+- [@JoyceZhu (Joyce Zhu)](https://github.com/JoyceZhu): Update import path for `browser-esm-webpack-small` [PR #3402](https://github.com/microsoft/monaco-editor/pull/3402)
+- [@Jozebel11 (Joseph Hardwicke)](https://github.com/Jozebel11): Add position styling to playground container to equal 'relative' [PR #3446](https://github.com/microsoft/monaco-editor/pull/3446)
+- [@kirjs (Kirill Cherkashin)](https://github.com/kirjs): Fix broken link in the changelog [PR #3382](https://github.com/microsoft/monaco-editor/pull/3382)
+- [@LeoDog896 (Tristan F.)](https://github.com/LeoDog896)
+ - Ignore dist from vite/parcel in prettier [PR #3466](https://github.com/microsoft/monaco-editor/pull/3466)
+ - Add .kts as a file extension [PR #3467](https://github.com/microsoft/monaco-editor/pull/3467)
+- [@MasterOdin (Matthew Peveler)](https://github.com/MasterOdin): Add new pgsql 15 functions [PR #3363](https://github.com/microsoft/monaco-editor/pull/3363)
+- [@mofux (Thomas Zilz)](https://github.com/mofux): Resolve URIs with special characters correctly [PR #3392](https://github.com/microsoft/monaco-editor/pull/3392)
+- [@nnnnoel (Noel Kim (김민혁))](https://github.com/nnnnoel): fix(mysql/tokenizer): Fix single quoted string escape [PR #3232](https://github.com/microsoft/monaco-editor/pull/3232)
+- [@rcjsuen (Remy Suen)](https://github.com/rcjsuen): Fix the color provider's columns [PR #3348](https://github.com/microsoft/monaco-editor/pull/3348)
+- [@RubenRBS (Rubén Rincón Blanco)](https://github.com/RubenRBS): Recognize \0 as an escape sequence [PR #3443](https://github.com/microsoft/monaco-editor/pull/3443)
+- [@sekedus (Sekedus)](https://github.com/sekedus): add homepage url [PR #3497](https://github.com/microsoft/monaco-editor/pull/3497)
+- [@tr3ysmith (Trey Smith)](https://github.com/tr3ysmith): Fix possible duplicate of editors in vite sample [PR #3390](https://github.com/microsoft/monaco-editor/pull/3390)
+
+## [0.34.1]
+
+- Adds API to register global actions, commands, or keybinding rules
+
+## [0.34.0]
+
+- Introduction of `IEditor.createDecorationsCollection` API
+- New function `removeAllMarkers` to remove all markers
+- Support for light high contrast theme
+- Introduction of `BracketPairColorizationOptions.independentColorPoolPerBracketType`
+- Introduction of `PositionAffinity.LeftOfInjectedText` and `PositionAffinity.RightOfInjectedText`
+- Introduction of `IEditorOptions.showFoldingControls: 'never'`
+- Introduction of `IDiffEditorBaseOptions.renderMarginRevertIcon: boolean`
+- Inline Quick Suggestions
+- Introduction of `IContentWidgetPosition.positionAffinity`
+- Provider can now be registered for a `LanguageSelector`
+
+### Breaking Changes
+
+- `IEditorInlayHintsOptions` tweaks
+- Iteration on `InlineCompletion` API
+- `WorkspaceFileEdit` -> `IWorkspaceFileEdit`
+ - `oldUri` -> `oldResource`
+ - `newUri` -> `newResource`
+- `WorkspaceTextEdit` -> `IWorkspaceTextEdit`
+ - `edit` -> `textEdit` (now supports `insertAsSnippet`)
+ - `modelVersionId?: number` -> `versionId: number | undefined`
+- `InlayHint` API tweaks
+- Soft deprecation of `ICodeEditor.deltaDecorations`, no adoption required. `IEditor.createDecorationsCollection` API should be used instead.
+
+Contributions to `monaco-editor`:
+
+- [@alexander-zw (Alexander Wu)](https://github.com/alexander-zw): [webpack readme] Add how to get languages/features [PR #3171](https://github.com/microsoft/monaco-editor/pull/3171)
+- [@anjbur (Angela Burton)](https://github.com/anjbur): Update Q# keywords [PR #3222](https://github.com/microsoft/monaco-editor/pull/3222)
+- [@bsorrentino (bsorrentino)](https://github.com/bsorrentino): Fix issue #2295 - Models with "@" in their name do not resolve as dependencies [PR #3057](https://github.com/microsoft/monaco-editor/pull/3057)
+- [@MasterOdin (Matthew Peveler)](https://github.com/MasterOdin): Remove duplicate testcases for mysql [PR #3138](https://github.com/microsoft/monaco-editor/pull/3138)
+- [@mhsdesign (Marc Henry Schultz)](https://github.com/mhsdesign): [DOCS] IEditorOptions.automaticLayout uses ResizeObserver 3051 [PR #3052](https://github.com/microsoft/monaco-editor/pull/3052)
+- [@supersonictw (SuperSonic)](https://github.com/supersonictw): Fix menu link in integrate-esm.md [PR #3214](https://github.com/microsoft/monaco-editor/pull/3214)
+- [@tonilastre (Toni)](https://github.com/tonilastre): Add config and tokenizer for query language Cypher [PR #3102](https://github.com/microsoft/monaco-editor/pull/3102)
+
+## [0.33.0]
+
+- The first parameter of all `monaco.languages.register*Provider` functions has changed to take a `DocumentSelector` instead of a single `languageId`
+- The `Environment.getWorker` function can now return a `Promise`
+
+### Breaking Changes
+
+- `InlayHintKind.Other` is removed.
+
+### Thank you
+
+Contributions to `monaco-editor`:
+
+- [@Dan1ve (Daniel Veihelmann)](https://github.com/Dan1ve): Make Vite sample code Firefox compatible [PR #2991](https://github.com/microsoft/monaco-editor/pull/2991)
+- [@philipturner (Philip Turner)](https://github.com/philipturner): Add `@noDerivative` modifier to Swift [PR #2957](https://github.com/microsoft/monaco-editor/pull/2957)
+
+## [0.32.1] (04.02.2022)
+
+- fixes [an issue with service initialization](https://github.com/microsoft/monaco-editor/issues/2941).
+
+## [0.32.0] (03.02.2022)
+
+### Breaking Changes
+
+- The binary format for `IEncodedLineTokens` has changed to support strikethrough text.
+- `IDiffEditor.getDomNode()` has been renamed to `IDiffEditor.getContainerDomNode()`.
+- `InlayHint.text` has been replaced by `InlayHint.label` and `InlayHintsProvider.provideInlayHints` now returns an `InlayHintList`.
+
+### Thank you
+
+Contributions to `monaco-editor`:
+
+- [@blutorange (Andre Wachsmuth)](https://github.com/blutorange): Implements #2383 Add syntax modes for FreeMarker template language [PR #2847](https://github.com/microsoft/monaco-editor/pull/2847)
+- [@forensicmike (forensicmike1)](https://github.com/forensicmike): Add "cd monaco-editor" to the step by step commandline instructions for cloning and running the samples [PR #2894](https://github.com/microsoft/monaco-editor/pull/2894)
+- [@juan-carlos-diaz](https://github.com/juan-carlos-diaz): Fix #2851 Highlight correctly the attributes and identifiers (with dashes) for Shell language [PR #2871](https://github.com/microsoft/monaco-editor/pull/2871)
+- [@MasterOdin (Matthew Peveler)](https://github.com/MasterOdin): Only run publish workflow on main monaco-editor repo [PR #2926](https://github.com/microsoft/monaco-editor/pull/2926)
+- [@philipturner (Philip Turner)](https://github.com/philipturner)
+ - Update Swift language specification to version 5.5 [PR #2855](https://github.com/microsoft/monaco-editor/pull/2855)
+ - Add @preconcurrency to Swift declaration attributes [PR #2924](https://github.com/microsoft/monaco-editor/pull/2924)
+- [@rcjsuen (Remy Suen)](https://github.com/rcjsuen): Support hyphenated HTML tags in Markdown syntax [PR #2864](https://github.com/microsoft/monaco-editor/pull/2864)
+- [@resistdesign (Ryan Graff)](https://github.com/resistdesign): doc: (samples) Simplify Browser ESM Parcel build [PR #2832](https://github.com/microsoft/monaco-editor/pull/2832)
+- [@ValeraS (Valeriy)](https://github.com/ValeraS)
+ - fix(monaco-editor-webpack-plugin): load monaco-editor with webpack 4 [PR #2818](https://github.com/microsoft/monaco-editor/pull/2818)
+ - tune(monaco-editor-webpack-plugin): expose plugin options type [PR #2853](https://github.com/microsoft/monaco-editor/pull/2853)
+- [@ZusorCode (Tobias Messner)](https://github.com/ZusorCode): Add .cjs extension for javascript files [PR #2929](https://github.com/microsoft/monaco-editor/pull/2929)
+
+## [0.31.1] (14.12.2021)
+
+- Fixes [a problem with missing colors](https://github.com/microsoft/monaco-editor/issues/2822)
+- Fixes [a problem with scheduling background tokenization](https://github.com/microsoft/vscode/issues/138887)
+- Improves TypeScript's ESM worker.
+
+## [0.31.0] (10.12.2021)
+
+- adds support for [highlighting non basic ASCII, invisible or ambiguous unicode characters](https://code.visualstudio.com/updates/v1_63#_unicode-highlighting).
+- adds support for setting an editor banner
+- streaming hover results in case of multiple hover providers
+- fixes multiple IME issues
+
+### Breaking Changes
+
+- the generated code is now bundled with ESBuild and the generated code makes use of newer browser features, e.g. [optional chaining](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Optional_chaining). These features should be available in all browsers, but they might not be parsed correctly by older JS parsers, specifically parcel v1 might have problems parsing the JS.
+
+### Thank you
+
+- [@activeguild (j1ngzoue)](https://github.com/activeguild): Add 'browser-ems-vite-react' sample [PR #2767](https://github.com/microsoft/monaco-editor/pull/2767)
+- [@emojiiii (C.Y.Kun)](https://github.com/emojiiii): Fix some errors on the website playground [PR #2779](https://github.com/microsoft/monaco-editor/pull/2779)
+- [@gitpaladin (Chen Minglong)](https://github.com/gitpaladin): Fix token while missing `syntax=` directive [PR #2809](https://github.com/microsoft/monaco-editor/pull/2809)
+- [@jonatanklosko (Jonatan Kłosko)](https://github.com/jonatanklosko): Update Elixir tokenization of sigil modifiers [PR #2806](https://github.com/microsoft/monaco-editor/pull/2806)
+- [@MasterOdin (Matthew Peveler)](https://github.com/MasterOdin)
+ - Update builtin functions for mysql [PR #2749](https://github.com/microsoft/monaco-editor/pull/2749)
+ - Update list of keywords for redshift [PR #2757](https://github.com/microsoft/monaco-editor/pull/2757)
+ - Remove return from example addAction [PR #2772](https://github.com/microsoft/monaco-editor/pull/2772)
+- [@milahu](https://github.com/milahu): fix link to monaco.d.ts [PR #2769](https://github.com/microsoft/monaco-editor/pull/2769)
+- [@Pranomvignesh (Pranom Vignesh)](https://github.com/Pranomvignesh): Semantic Tokens Provider Sample is broken in docs [PR #2764](https://github.com/microsoft/monaco-editor/pull/2764)
+- [@rramo012 (Rafael Ramos)](https://github.com/rramo012): Fixing the documentation links [PR #2748](https://github.com/microsoft/monaco-editor/pull/2748)
+
+## [0.30.1] (09.11.2021)
+
+- Fixes [a performance regression where all languages would be loaded when loading the first language](https://github.com/microsoft/monaco-editor/issues/2750).
+
+## [0.30.0] (04.11.2021)
+
+- adds support for rendering horizontal guides between bracket pairs and improves the vertical rendering to account for content in between brackets.
+- adds new `hover.above` option to control the hover position.
+- adds `ICodeEditor.onDidChangeHiddenAreas` which is fired when folding/unfolding.
+- to address [CVE-2021-42574](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-42574), the editor now renders Unicode directional formatting characters by default. The special rendering can be turned off using `renderControlCharacters`. See https://code.visualstudio.com/updates/v1_62#_unicode-directional-formatting-characters for an explanation.
+
+### Breaking Changes
+
+- renamed enum members of `monaco.KeyCode` to align with the names given for browser codes.
+- renamed `ITextModel.getModeId()` to `ITextModel.getLanguageId()`
+- renamed `IPasteEvent.mode` to `IPasteEvent.languageId`
+
+### Thank you
+
+Contributions to `monaco-editor-webpack-plugin`:
+
+- [@silverwind](https://github.com/silverwind): Fix letter case in repo URL [PR #165](https://github.com/microsoft/monaco-editor-webpack-plugin/pull/165)
+
+Contributions to `monaco-languages`:
+
+- [@arlosi (Arlo Siemsen)](https://github.com/arlosi): Rust: highlighting raw strings and fix chars with escapes [PR #167](https://github.com/microsoft/monaco-languages/pull/167)
+- [@MasterOdin (Matthew Peveler)](https://github.com/MasterOdin)
+ - Add new functions in postgresql 14 [PR #168](https://github.com/microsoft/monaco-languages/pull/168)
+ - Update json functions for postgresql [PR #169](https://github.com/microsoft/monaco-languages/pull/169)
+ - Add missing postgresql functions [PR #170](https://github.com/microsoft/monaco-languages/pull/170)
+
+## [0.29.1] (11.10.2021)
+
+- fixes [an issue with the ESM version in DOMPurify](https://github.com/microsoft/monaco-editor/issues/2691).
+
+### Thank you
+
+Contributions to `monaco-languages`:
+
+- [@sw23 (Spencer Williams)](https://github.com/sw23)
+ - Adding syntax highlighting support for .pla files (Programmable Logic Array) [PR #163](https://github.com/microsoft/monaco-languages/pull/163)
+ - SystemVerilog: Adding better syntax highlighting for primitive table definitions [PR #165](https://github.com/microsoft/monaco-languages/pull/165)
+- [@tochicool (Tochi Obudulu)](https://github.com/tochicool): Add support for Protocol Buffers language [PR #164](https://github.com/microsoft/monaco-languages/pull/164)
+
+## [0.29.0] (08.10.2021)
+
+- adds an `ariaContainerElement` option for editors
+- adds `guides.bracketPairs` to enable guides driven by bracket pairs
+- adds `maxFileSize` to control the maximum file size for which to compute diffs
+- adds `CodeActionProvider.resolveCodeAction`
+
+### Breaking Change
+
+- consolidated the options `renderIndentGuides`, `highlightActiveIndentGuide` to `guides`
+
+### Thank you
+
+Contributions to `monaco-editor`:
+
+- [@crackalak (Dan Hughes)](https://github.com/crackalak): Added `ariaContainerElement` to shadow dom test [PR #2644](https://github.com/microsoft/monaco-editor/pull/2644)
+- [@HKalbasi](https://github.com/HKalbasi): Add example for inlay hints [PR #2640](https://github.com/microsoft/monaco-editor/pull/2640)
+- [@silverwind](https://github.com/silverwind): Fix letter case in repo URL [PR #2674](https://github.com/microsoft/monaco-editor/pull/2674)
+- [@Un-index](https://github.com/Un-index): chore: Align run button text in playground.css [PR #2658](https://github.com/microsoft/monaco-editor/pull/2658)
+
+Contributions to `monaco-editor-samples`:
+
+- [@koto (Krzysztof Kotowicz)](https://github.com/koto): Added an example of loading Monaco with Trusted Types [PR #92](https://github.com/microsoft/monaco-editor-samples/pull/92)
+
+Contributions to `monaco-editor-webpack-plugin`:
+
+- [@six-ponies (马騳骉)](https://github.com/six-ponies): fix: Failed to execute 'importScripts' on 'WorkerGlobalScope': The URL xxx is invalid. [PR #160](https://github.com/microsoft/monaco-editor-webpack-plugin/pull/160)
+
+Contributions to `monaco-languages`:
+
+- [@aaaaaa2493 (Vladimir Turov)](https://github.com/aaaaaa2493): Support Java 12-17 syntax [PR #159](https://github.com/microsoft/monaco-languages/pull/159)
+- [@mbtools (Marc Bernard)](https://github.com/mbtools): Update ABAP syntax [PR #160](https://github.com/microsoft/monaco-languages/pull/160)
+- [@scarolan (Sean Carolan)](https://github.com/scarolan): Replace // with # for line comments [PR #158](https://github.com/microsoft/monaco-languages/pull/158)
+- [@valeriia-melnychuk (Valeriia Melnychuk)](https://github.com/valeriia-melnychuk): Implement syntax highlighting for Flow9 [PR #154](https://github.com/microsoft/monaco-languages/pull/154)
+
+Contributions to `monaco-typescript`:
+
+- [@paranoidjk (paranoidjk)](https://github.com/paranoidjk): feat: support find reference to extraLib [PR #84](https://github.com/microsoft/monaco-typescript/pull/84)
+- [@troy351](https://github.com/troy351): Add type definition of `setInlayHintsOptions` [PR #83](https://github.com/microsoft/monaco-typescript/pull/83)
+
+## [0.28.0] (22.09.2021)
+
+- adds [support for typescript inlay hints](https://github.com/microsoft/monaco-typescript/pull/82). Inlay hints can be enabled like this:
+
+```ts
+monaco.languages.typescript.typescriptDefaults.setInlayHintsOptions({
+ includeInlayParameterNameHints: 'all',
+ includeInlayParameterNameHintsWhenArgumentMatchesName: true,
+ includeInlayFunctionParameterTypeHints: true,
+ includeInlayVariableTypeHints: true,
+ includeInlayPropertyDeclarationTypeHints: true,
+ includeInlayFunctionLikeReturnTypeHints: true,
+ includeInlayEnumMemberValueHints: true
+});
+```
+
+- adds support for bracket pair highlighting, which can be enabled by configuring `bracketPairColorization.enabled` when creating a new editor:
+
+```ts
+var editor = monaco.editor.create(document.getElementById('container'), {
+ model: model,
+ language: 'javascript',
+ 'bracketPairColorization.enabled': true
+});
+```
+
+- `registerCodeActionProvider` now accepts metadata to specify provided code action kinds (e.g. `quickfix`, `refactor` or `source`).
+
+### Thank you
+
+Contributions to `monaco-editor`:
+
+- [@SpaceComet](https://github.com/SpaceComet): Small update on the website playground [PR #2616](https://github.com/microsoft/monaco-editor/pull/2616)
+- [@thien-do (Thien Do)](https://github.com/thien-do): Add usage with Vite to ESM Integrate doc [PR #2632](https://github.com/microsoft/monaco-editor/pull/2632)
+
+Contributions to `monaco-html`:
+
+- [@Pranomvignesh (Pranom Vignesh)](https://github.com/Pranomvignesh): fix(workerManager.js) : Added a check for the existence of the worker [PR #15](https://github.com/microsoft/monaco-html/pull/15)
+
+Contributions to `monaco-languages`:
+
+- [@ladyrick (LadyRick)](https://github.com/ladyrick): fix(cpp): fix cpp language integer suffix [PR #156](https://github.com/microsoft/monaco-languages/pull/156)
+
+Contributions to `monaco-typescript`:
+
+- [@Kingwl (Wenlu Wang)](https://github.com/Kingwl): Add inlay hints support [PR #82](https://github.com/microsoft/monaco-typescript/pull/82)
+
+## [0.27.0] (16.08.2021)
+
+- added property `inlineClassName` to style injected text
+- added option `foldingImportsByDefault`
+- added more JSON diagnostic options.
+
+### Breaking Change
+
+- changed `seedSearchStringFromSelection` from boolean to `'never' | 'always' 'selection'`
+- changed suggestion preview mode `subwordDiff` to `subwordSmart`, introduced `subword`
+
+### Thank you
+
+Contributions to `monaco-editor`:
+
+- [@Surm4 (Marcin)](https://github.com/Surm4): Exposed colors sample update in the playground. [PR #2561](https://github.com/microsoft/monaco-editor/pull/2561)
+
+Contributions to `monaco-languages`:
+
+- [@alefragnani (Alessandro Fragnani)](https://github.com/alefragnani): Adds `strict` keyword to Pascal language [PR #153](https://github.com/microsoft/monaco-languages/pull/153)
+- [@jonatanklosko (Jonatan Kłosko)](https://github.com/jonatanklosko): Properly tokenize fence closing in GitHub style code blocks [PR #149](https://github.com/microsoft/monaco-languages/pull/149)
+- [@kupiakos (Alyssa Haroldsen)](https://github.com/kupiakos): Remove ' as an auto-closing pair for Rust [PR #151](https://github.com/microsoft/monaco-languages/pull/151)
+- [@lofcz (Matěj Štágl)](https://github.com/lofcz): Fix razor + liquid render of tags with a dash symbol [PR #150](https://github.com/microsoft/monaco-languages/pull/150)
+
+## [0.26.1] (15.07.2021)
+
+- fixes [minimatch dependency issue](https://github.com/microsoft/monaco-editor/issues/2578) by downgrading the monaco-json dependency.
+
+## [0.26.0] (15.07.2021)
+
+- added support for injected text. Use `IModelDecorationOptions.before`/`after`.
+- added support for inlay hints provider.
+
+### Breaking Changes
+
+- CompletionItemLabel now has the property `label`, `detail` and `description` (instead of `name`, `parameters`, `qualifier` and `type`).
+
+### Thank you
+
+Contributions to `monaco-editor`:
+
+- [@anthony-c-martin (Anthony Martin)](https://github.com/anthony-c-martin): Add Bicep sample [PR #2541](https://github.com/microsoft/monaco-editor/pull/2541)
+
+Contributions to `monaco-languages`:
+
+- [@anjbur (Angela Burton)](https://github.com/anjbur): Add support for Q# [PR #142](https://github.com/microsoft/monaco-languages/pull/142)
+- [@maxwrlr](https://github.com/maxwrlr): Implement Syntax-Highlighting for SPARQL [PR #145](https://github.com/microsoft/monaco-languages/pull/145)
+- [@nathanrreed (Nathan Reed)](https://github.com/nathanrreed)
+ - fix c++ comment continuation highlighting #2497 [PR #143](https://github.com/microsoft/monaco-languages/pull/143)
+ - fix rust raw string highlighting #2552 [PR #146](https://github.com/microsoft/monaco-languages/pull/146)
+ - fix char literal highlighting #2481 [PR #147](https://github.com/microsoft/monaco-languages/pull/147)
+ - fix rust raw string highlighting #2086 [PR #148](https://github.com/microsoft/monaco-languages/pull/148)
+- [@qwefgh90 (Changwon Choe)](https://github.com/qwefgh90): improve a rule which freeze a page in restructuredText [PR #141](https://github.com/microsoft/monaco-languages/pull/141)
+- [@RubenRBS (Rubén Rincón Blanco)](https://github.com/RubenRBS): Add Swift fileprivate access modifier [PR #144](https://github.com/microsoft/monaco-languages/pull/144)
+
+Contributions to `monaco-typescript`:
+
+- [@spahnke (Sebastian Pahnke)](https://github.com/spahnke): Build tag text correctly for all tags [PR #81](https://github.com/microsoft/monaco-typescript/pull/81)
+
+## [0.25.2] (17.06.2021)
+
+- fixes a problem that [certain characters could not be typed on non-US keyboards](https://github.com/microsoft/monaco-editor/issues/2533).
+
+## [0.25.1] (15.06.2021)
+
+- fixes that [`registerHTMLLanguageService` is not available in the AMD version of the monaco-html contribution](https://github.com/microsoft/monaco-editor/issues/2525).
+
+## [0.25.0] (11.06.2021)
+
+- added a new feature `inlineSuggest` that features a provider api and new settings.
+- added `suggest.preview` to toggle previewing the selected suggest item.
+- added `suggest.showDeprecated`
+- CSS/HTML: added support for [custom data format](https://code.visualstudio.com/blogs/2020/02/24/custom-data-format)
+- HTML: added `registerHTMLLanguageService`
+
+### Breaking changes
+
+- renamed `inlineHints` to `inlayHints`.
+
+### Thank you
+
+Contributions to `monaco-editor`:
+
+- [@JeanPerriault (El Jùanch0)](https://github.com/JeanPerriault): Fix error message in Safari - Semantic token play [PR #2486](https://github.com/microsoft/monaco-editor/pull/2486)
+- [@jonatanklosko (Jonatan Kłosko)](https://github.com/jonatanklosko): Add Elixir sample [PR #2491](https://github.com/microsoft/monaco-editor/pull/2491)
+
+Contributions to `monaco-languages`:
+
+- [@akonatala (apoorva konatala)](https://github.com/akonatala): Update cameligo language support [PR #137](https://github.com/microsoft/monaco-languages/pull/137)
+- [@anark](https://github.com/anark): Add aliases and mimetypes to liquid language [PR #136](https://github.com/microsoft/monaco-languages/pull/136)
+- [@mattvague (Matt Vague)](https://github.com/mattvague): Fix incorrect filenames for liquid [PR #135](https://github.com/microsoft/monaco-languages/pull/135)
+- [@spahnke (Sebastian Pahnke)](https://github.com/spahnke)
+ - [JS/TS] Add support for the RegExp Match Indices flag [PR #139](https://github.com/microsoft/monaco-languages/pull/139)
+ - [TS] Add override keyword [PR #140](https://github.com/microsoft/monaco-languages/pull/140)
+
+Contributions to `monaco-typescript`:
+
+- [@paranoidjk (paranoidjk)](https://github.com/paranoidjk): fix: support go to definition for extraLib file [PR #79](https://github.com/microsoft/monaco-typescript/pull/79)
+
+## [0.24.0] (12.05.2021)
+
+- added a setting `domReadOnly` which controls if the `