Support JupyterLab Workspaces in Lab

[bollwyvl]

References

• fixes Support Workspaces #139
• (mistakenly) includes Update demos to ipywidgets 8, use widgetsnbextension shim #793
  • will keep working on this, just to get more eyes on the potential changes, even if we go with Remove widgetsnbextension shim, update demos to ipywidgets 8 #795

Code changes

• normalize more metapackage package.json and tsconfig.json actions in doit repo
• add prettier-package.json
• add doit repo to linting
• refactor settings, contents to use common configurable IForager wrapper
• add /api/workspaces/* handlers
  • localForage
    • drivers and storageName in jupyter-lite.json
  • server-backed in /api/workspaces/all.json?
• allow mode=single-document to be set by URL parameter

  • could be set in metadata, but this should probably become an upstream thing

  • presentationMode would be nice, too

• overloaded some plugins
  • IRouter to add transforming
  • IWindowResolver to handle the lack of real server without overloading all of StateDB
• ???
• support workspaces definitions in
  • jupyter_build_config.json against given files/folders
  • jupyter-lite.json?
    • these are kinda nasty files, i don't see a big win to inlining them
  • in-contents .jupyterlab-workspace files?
• ui tests
  • use goto('lab/index.html?reset') instead of page.reload in some existing tests
  • ~~add tests for various patterns above ~~
    • galata does some hacks on statedb, etc. avoiding for now
• docs
  • document use cases
  • document with other storage options
  • add some workspaces to examples site

User-facing changes

• when reloading /lab/, existing windows should be re-opened
• kernel state/ids are lost, so some things won't work
• when a second browser is opened on the same site, it will try to reuse the workspace (which doesn't work today)
  • a second browser will open with a timestamp-based suffix, e.g ?clone=default-6123123

Backwards-incompatible changes

• ???

[github-actions]

👈 Try it on ReadTheDocs

[psychemedia]

Will a user be able to havr two different workspaces open in different browser tabs for the same jupyterlite environment?

[jtpio]

Maybe we still need to run this in the check release workflow to make sure resolutions have been updated and not leave a git dirty state.

[bollwyvl]

Hm... i guess i though that check-release should be allowed to changes things, while "plain old lint" should just fail hard if a new package gets added, for example (which is what bit me)

[jtpio]

Thanks @bollwyvl for working on this.

I did a quick check on RTD and there seems to be an issue with RetroLab. Here is what it looks like:

workspaces-retro.mp4

[bollwyvl]

Thanks for the thorough review. Need to sit back and take another look at it... maybe a path forward is for me to split up the repo plumbing stuff and then do the workspaces stuff on top of that...

[jtpio]

Bumping to 0.2.0 so we have time to update to Notebook 7 in the meantime (#826) and address issues in https://github.com/jupyter/notebook if needed, since RetroLab is not maintained anymore.

[bollwyvl]

Yeah, would be good to get back to this. Does nb7 use workspace for e.g.

sidebars?

[jtpio]

Notebook 7 does not use workspaces at the moment. I think this was discussed recently. Probably it won't make it for 7.0, but could be considered for 7.x (as long as we don't create another JupyterLab).