Document Jupyter related types in @vscode/python-extension npm package

[karrtikr]

We now have a npm package which carries the Python extension api types.

See microsoft/vscode-python#21690 (comment). If you would like these types to be present in the @vscode/python-extension API, these should likely be documented. Otherwise let us know and we'll remove these types from the package.

Types for package are defined here: https://github.com/microsoft/vscode-python/blob/main/src/client/api/types.ts

[DonJayamanne]

If you would like these types to be present in the @vscode/python-extension API, these should

I don't think there's a need to expose this api in the public npm as they are useful only to thr Jupyter extension.

In a way it's private for Jupyter extension, and cannot be used by any other extension, if called by others then it's a noop. As the result of calling that API is that python extension will call back into Jupyter extension

[karrtikr]

Actually there're other types as well: https://github.com/microsoft/vscode-python/blob/8b9bca1fd5a684d454e0d97583642cb46553241e/src/client/api/types.ts#L128-L167, which seem to be Jupyter specific, which I think you would like to include in the package. I think these are specific for dataviewer: https://github.com/microsoft/vscode-python/blob/8b9bca1fd5a684d454e0d97583642cb46553241e/src/client/api/types.ts#L38-L49

[DonJayamanne]

No, we don't need those either.
I do not think we should publish anything that very specific & private for Jupyter extenssion.
Please feel free to remove them from the npm package

In a way it's private for Jupyter extension, and cannot be used by any other extension, if called by others then it's a noop. As the result of calling that API is that python extension will call back into Jupyter extension

Its pointless, tomorrow if we remove them , then its not a breaking change in the API.
I.e. we should only document stuff in the API thats publish and shoudl never be removed.

However private items such as those used by Jupyter can be removed as its technically not public (not a public API)