This is the place for the stable API and for API proposals.
- find a proposal you are interested in
- add its name to your extensions
package.json#enabledApiProposals
property - run
npx vscode-dts dev
to download thed.ts
files into your project - don't forget that extension using proposed API cannot be published
- learn more here: https://code.visualstudio.com/api/advanced-topics/using-proposed-api
- create a new file in this directory, its name must follow this pattern
vscode.proposed.[a-zA-Z]+.d.ts
- creating the proposal-file will automatically update
src/vs/workbench/services/extensions/common/extensionsApiProposals.ts
(make sure to runyarn watch
) - declare and implement your proposal
- make sure to use the
checkProposedApiEnabled
and/orisProposedApiEnabled
-utils to enforce the API being proposed. Make sure to invoke them with your proposal's name which got generated intoextensionsApiProposals.ts
- Most likely will need to add your proposed api to vscode-api-tests as well