@@ -33,9 +33,34 @@ gap. Two ways to fix it:
3333 delivery. Cons: more moving parts; depends on the notebook being
3434 ** trusted** for a reopened (not re-run) notebook to re-render.
3535
36- ** Current choice:** Option 2 (keeps the live-notebook extras). Revisit
37- Option 1 if the loader proves fragile across notebook frontends or the
38- maintenance cost outweighs the three behaviours.
36+ - ** Colab transport β versioned frame-local assets.** Colab isolates
37+ every cell output in its own iframe, so the once-per-kernel browser
38+ state assumed by Option 2 cannot cross cells. In Colab only, every
39+ figure output loads the version-matched Plotly bundle and
40+ ` ed-figures.js ` from the published documentation assets in parallel
41+ (the loader only needs Plotly once it renders), then calls the same
42+ ` renderSpec ` entry point. ` google.colab.output.pauseOutputUntil ` holds
43+ the output frame until the figure β or a visible error message β is on
44+ screen. Concurrent outputs in one cell share frame-global loading
45+ promises, so each asset is fetched and parsed only once. An immutable,
46+ exact-release-tag jsDelivr URL is the fallback while a new
47+ documentation version is deploying or if that deployment fails. Dev
48+ builds intentionally use only ` /dev/ ` to avoid mixing arbitrary local
49+ code with the loader from another revision. The browser cache avoids
50+ embedding or repeatedly transferring the runtime, while all
51+ loader-owned theme, resize, and legend behaviour remains intact.
52+ Documentation ` SHARED ` mode is selected first and is unaffected.
53+
54+ Saved Colab outputs still depend on the host restoring their dynamic
55+ scripts. Until that behaviour is confirmed manually, reopen-and-view
56+ without re-running is not guaranteed; re-run a cell if its restored
57+ output remains at the loading placeholder. An end-to-end test of a dev
58+ build likewise requires its matching loader to have reached ` /dev/ ` .
59+
60+ ** Current choice:** Option 2 for JupyterLab, with the frame-local asset
61+ transport for Colab. Revisit Option 1 if the loader proves fragile
62+ across notebook frontends or the maintenance cost outweighs the three
63+ behaviours.
3964
4065** Depends on:** nothing.
4166
0 commit comments