[vscode] proposed API evolutions between 1.77.0 and 1.78.0

[rschnekenbu]

Sources

• commit ref for tags
  • 1.77.0: 7f329fe
  • 1.78.0: 252e546
• command used
  • git difftool -d 7f329fe..252e546 -- src/vscode-dts/
  • git diff 7f329fe..252e546 -- src/vscode-dts/ > diff_1.77.0_to_1.78.0.txt
  • git log --oneline 7f329fe..252e546 -- src/vscode-dts/ > gitlog_1.77.0_to_1.78.0.txt

Evaluation

• new APIs:
  • commentsDraftState.d.ts (Add a notion of pending / draft state to code review comments microsoft/vscode#171166)
  • debugFocus.d.ts (Add debug API for call stack selection changes (63943) microsoft/vscode#179132)
  • dropMetadata.d.ts (Update drop metadata proposal microsoft/vscode#179918)
  • envCollectionWorkspace.d.ts (Allow specifying workspace-specific EnvironmentVariableCollection mutators microsoft/vscode#171173)
  • fileComments.d.ts (Add file level commenting microsoft/vscode#178478)
  • formatMultipleRanges.d.ts (update format ranges API proposal based on feedback microsoft/vscode#179166)
  • handleIssueUri.d.ts (Issue Reporter: Support configuring data sent to extensions microsoft/vscode#46726)
  • inlineCompletionsAdditions.d.ts (Fixes #153754. microsoft/vscode#180490 & Fixes #179134. Adds flag suppressSuggestions to inline completion result. microsoft/vscode#180129) - note: added optional API on InlineCompletionList and added a required parameter on handleDidShowCompletionItem()
  • interactive.d.ts (Make the InteractiveSession type a generic parameter microsoft/vscode#179071) - note: some other updates there, but will likely disapear in next version (some code updated in 1.78 and then more code was deleted on main)
  • notebookExecution.d.ts (Support for arbitrary notebook kernel execution microsoft/vscode#179258)
  • saveEditor.d.ts (Have workspace.save and workspace.saveAs methods that return the URI microsoft/vscode#178713)
  • scmTextDocument.d.ts (SCM - Create an event for when the value of a SourceControlInputBox changes microsoft/vscode#166615)
  • semanticSimilarity.d.ts (introduce a SemanticSimilarity provider model microsoft/vscode#179640)
• removed proposed APIs:
  • vscode.proposed.contribEditorLineNumberMenu.d.ts (Finalize editor/lineNumber/context menu microsoft/vscode#179168) - now a public placeholder
  • notebookDocumentWillSave.d.ts (Finalize onWillSaveNotebookDocument microsoft/vscode#179188) - now a public API
• ignored changes:
  • documentPaste.d.ts (only comment changes)
  • quickPickItemTooltip.d.ts (comments update)
  • resolvers.d.ts (comments changed)

[rschnekenbu]

According to command line report for proposed API usage on 1.78.0 version of the builtins

• the removed proposed APIs (that are now public APIs) are impacting builtins, so the public API shall be updated according to these APIs.
• 2 extensions (markdown-language-features & ipynb) rely on proposed APIs that were modified (dropMetadata - added API and documentPaste - only comments)

[msujew]

Given that we're now way further along in the API version, I think this can be closed.