MAINTAINING.md

Maintaining

(For maintainers)

Updating TypeScript

• change typescript's version in package.json.
• execute npm install .
• execute npm run import-typescript
• adopt new APIs

Shipping a new monaco-editor npm module

• update package.json and bump "version" as necessary
• update package.json and edit "vscode" to point to the vscode repo commit that should be shipped at monaco-editor-core (both monaco-editor-core and monaco-editor will be published under the same version defined in package.json).
• trigger a build using Publish to npm and type false when asked "is nightly?"
• if the publish succeeded, run git tag 0.x.y and git push origin 0.x.y
• edit package.json and update the "monaco-editor-core" dev dependency.
• run npm install
• run npm run release
• write entry in CHANGELOG.md
  • API Changes / Breaking Changes / New and noteworthy
  • Thank you (use this tool)

8. Publish new webpack plugin

• TBD
• https://github.com/microsoft/monaco-editor/tree/main/webpack-plugin
• npm install .
• npm run import-editor
• if there are no changes generated after the script:
  • update the peer dependency in package.json and use the || format e.g. "monaco-editor": "0.27.x || 0.28.x"
  • update the version matrix in the README.md and add the new editor version to the plugin's current major version
  • use npm version minor
  • publish using npm publish
• if there are any changes generated after the script:
  • update the peer dependency in package.json e.g. "monaco-editor": "0.29.x"
  • update the version matrix in the README.md and add a new row with the new major version
  • use npm version major
  • publish using npm publish
• remember to push tags upstream