Changelog

Release 0.15.7

Fix matplotlib plotting (regression in 0.15.6).
Fix hard breaks in markdown content.

Release 0.15.6

Date: 2022-05-08

Upgrade Pyodide to v0.20.0

Release 0.15.5

Date: 2022-02-07

Upgrade Pyodide to v0.19.0

Release 0.15.4

Date: 2021-11-29

Fix for NPM install of starboard-notebook package (thank you @bartbroere!).

Release 0.15.3

Date: 2021-11-27

Add workaround for pyodide global not being present.

Release 0.15.2

Date: 2021-11-27

Fix missing build artifacts in starboard-notebook package.

Release 0.15.1

Date: 2021-11-26

Switch from NPM to Yarn.. to fix issues in rich-markdown-editor, which caused 0.15.0 to be broken undeterministically.

Release 0.15.0

Date: 2021-11-26

Update Pyodide to 0.18.1 (from 0.17.0).
Breaking change The previous cell's output is no longer present in the global $_ variable.
The last line of a Python cell is no longer automatically converted to a Javascript equivalent (which would leak a bit of memory every time and lead to confusing outputs sometimes).

Release 0.14.2

Date: 2021-10-19

Fix Python not running in main thread by default in the previous release (0.14.1).
Fixed some Typescript typing issues in starboard-python, it should now build out of the box.
Starboard now includes full source maps (finally!), so errors are much easier to debug.
KaTeX fonts are no longer included twice.

Release 0.14.1

Date: 2021-10-07

Fix version number in the footer of the notebook
Folded starboard-python into the starboard monorepo.
Decreased bundle size a bit by convincing Webpack to only include
- One copy of markdown-it instead of three.
- One copy of prosemirror-view instead of two.
  This saves around 30% in final Javascript bundle size.
Fix an additional \ being added to any \ inside of inline LaTeX blocks (e.g. $\LaTeX$ would become $\\LaTeX$ ).
Fix emoji menu in rich markdown editor when inserting emoji's through colon codes such as :rocket:.

Release 0.14.0

Date: 2021-10-04

There is now a packages folder that contains all packages. This change helps with build times and allow for re-using code from Starboard's core outside of it, such as the parser/serializer for notebooks. We use lerna to manage this multiple-packages-in-one-repo setup.
Added the starboard-rich-editor package, which contains the WYSWIYG editor used for Markdown cells.
Switched to a rich-markdown-editor-based editor for rich content.
Breaking change Removed StarboardContentEditor export. You can now use StarboardRichEditorElement export, which has basically the same interface.
Breaking change Removed hookMarkdownItToKaTeX, hookMarkDownItToEmojiPlugin, hookMarkdownItToCodemirrorHighlighter. They have been deprecated for a while already.
- Deprecated markdown-it exports. In the future you will be able to modify it through some sort of plugin/extension system.

Release 0.13.3

Date: 2021-08-22

Tab and shift tab now indents or un-indents code in the codemirror editor.
When you are at the start of a codemirror text editor, pressing tab will focus the next element.
Updated codemirror packages to 0.19.x (and minor CSS change that was required for custom font to still work).

Release 0.13.2

Date: 2021-08-10

Reverted the Python runtime default, it will now default to main thread Python again while we work on a great Pyodide-in-webworker experience.
Made the message that the service worker is getting injected debug level instead of warning.

Release 0.13.1

Date: 2021-08-5

Fix service worker appending headers instead of setting them in case a partial COOP or COEP header is present.

Release 0.13.0

Date: 2021-08-05

Starboard is now geared to run in cross origin secure environments, which can be a breaking change for some notebooks.

Add COOP/COEP headers support to enable the use of the SharedArrayBuffer and Atomics APIs.
Add optional COOP/COEP enabling service worker. Useful when you cannot change the HTTP headers that the server sends.
Update to starboard-python version 0.7.3, which has many internal changes.
Python cells now default to running out-of-core in a webworker.
~~Inserting cells with textContent now works as expected.~~ Didn't make it into this release by accident.
Added getMarkdownItWithDefaultPlugins, and deprecated hookMarkdownItToKaTeX, hookMarkdownItToEmojiPlugin and hookMarkdownItToCodemirrorHighlighter.
Images in markdown now get the crossorigin="anonymous" attribute added by default, which fixes them not showing in secure contexts.
Fixed issue where sometimes markdown cells would get rendered twice when using sb:run_all_cells.

Build changes:

Starlit is now used for notebook testing in starboard-notebook repo. Use npm run nbtest after building, or npm run nbtest:dev to connect it to the webpack dev server.
ESBuild loader plugin for webpack is now used (cutting build time in half or so).
Added build:nominify option for faster building (and easier debugging).

Release 0.12.3

Date: 2021-07-23

The initial cell run (when the notebook is loaded) now sets isInitialRun: true to true on the event sb:run_all_cells event.

Release 0.12.2

Date: 2021-07-23

Added sb:run_all_cells which gets fired when runtime.controls.runAllCells is called. This allows you to cancel that action or otherwise act on it.
Fixed runtime.exports.libraries.litDirectives not actually containing the lit library directives in the bundle.

Release 0.12.1

Date: 2021-06-18

Fix for cells that have an id starting with a number. I suggest you avoid those IDs, but when converting from Jupyter it would sometimes happen.
Markdown WYSIWYG editor (ProseMirror) now respects the locked property (making it non-editable).

Release 0.12.0

Date: 2012-06-11

This release has breaking changes that will require changes to Starboard plugins, most notebooks should still work.

Cell metadata including properties can no longer be undefined. If you assign undefined to a prop it gets deleted.
Added runtime.controls.setCellProperty as a cancellable way to set properties.
Added runtime.controls.clearCell control and event.
Breaking change: Moving from an event bus architecture to a HTML event-based system to allow for cancelling actions:
- Breaking change: All runtime.controls.* functions that spawn an event now take a single options argument instead of a separate argument for the cell id.
- Breaking change: Renamed argument id to adjacentCellId of runtime.controls.insertCell to prevent confusion.
- Breaking change: Run cell no longer takes focusTarget?: "previous" | "next" and insertNewCell?: boolean arguments. You should insert and focus after running as separate actions.
- The callback function of a ControlsButton now receives the event as its first and only argument.
A focus cell event/controls call without a specific target previous or next will now focus the cell with the given ID itself.
Removed the optional hide field from ControlButton interface and template (it was never used anyway).
The editor will now be focused correctly when switching to a cell whose celltype is unknown.
The option for inserting a cell at the end of the notebook now uses notebookEnd instead of end to remove ambiguity.
Added runtime.dom.getCellById.
There is no longer a content changed message sent when a cell type gets defined and a cell with that type is present.
Fixed HTML export by shimming Buffer.
runtime.controls.sendMessage now has an options argument for targetOrigin.
The Javascript cell type's last expression no longer becomes the cell return type and get displayed when the last expression ends with a semicolon (;), making it the same as Jupyter/Python.
Removed "smart" preset for default editor, it was rather flawed anyway (it depended on touchscreen detection, but there are plenty of laptops with touchscreens anyway).
Breaking change: Removed the iframe-resizer library dependency, opting for more simple ResizeObserver approach afforded by modern browsers (thank you @stefnotch), this means you should use starboard-wrap version 0.4.0 or later now.
Updated to starboard-python version 0.6.7 which is compatible with the changes introduced here.

Mini-update guide for plugins:

runtime.controls.emit({ type: "RUN_CELL", id: cell.id });
// change to
runtime.controls.runCell({ id: cell.id });

Release 0.11.1

Date: 2012-06-03

Fix javascript cell type (Babel expected a stub for Node's process, which Webpack 5 no longer insterted)
The highlight module now has a prefetch hint in Webpack, which should cause it to be fetched earlier even if no highlighting has to be performed yet.

Release 0.11.0

Date: 2012-06-03

Update to Webpack 5.
Update to Codemirror editor 0.18.*.
Removed PrismJS
- We now use Codemirror for syntax highlighting.
- The export runtime.exports.core.hookMarkdownItToPrismHighlighter is no longer present, instead there is runtime.exports.core.hookMarkdownItToCodemirrorHighlighter.
- This change shaves off 1/3rd of the initial bundle size.
Codemirror now supports many languages for syntax highlighting out of the box.
Removed global YAML library, you can use runtime.exports.libraries.YAML instead.
Removed built-in support for Coffeescript syntax highlighting in Monaco editor.

Release 0.10.2

Date: 2021-06-01

Added litDecorators and litDirectives to the exports in runtime.exports.libraries.
Fixes and improvements to cell switching and Monaco editor behavior when using the up and down arrows (thank you @stefnotch!).
Added Export HTML button to the <> Source view.
You can now move cells up and down. In runtime.controls you will now find moveCell and moveCellToIndex.

Release 0.10.1

Date: 2021-05-20

bootstrap-icons css and woff2 file is now vendored, this helps prevent some webpack difficulties in downstream packages.
Update to starboard-python 0.6.6 (nothing substantial has updated aside from some icon changes).

Release 0.10.0

Date: 2021-05-19

Visual overhaul - cell editors and console outputs are round again. Added space in between cell bottom and top, and between cells.
Switch to js-yaml from yaml, which saves 52KB in minified output size. This library has a slightly different interface, notebooks that use this library need to make small changes.
Added the bootstrap-icons font as the main source for icons, removed spectrum-icons.
Deprecated the exported icons on the runtime (you can now just use the bi bi-icon-name classes) - they will keep working but are now aliasing a bootstrap icon instead.
Upgraded to lit from lit-html and lit-element. The litHtml global is now replaced by lit.
- LitHtml and LitElement will remain in the exports for now as an alias for lit. Plugins must upgrade to use lit instead as this is a temporary stopgap for compatibility.
Fixed an issue where the cell insertion menu would disappear when hovering over a previous cell.
Replaced performUpdate with requestUpdate where possible. This means that there will now only be one update if multiple are requested per frame, leading to slightly better performance.

Release 0.9.4

Date: 2021-05-14

Update to starboard-python version 0.6.5 which supports clearing its output.
Support for defining plugins that should be loaded in the notebook metadata. It's a bit experimental at this point, do report any issues.
Switched to dart Sass, which makes building of the project on Windows machines easier.

Release 0.9.3

Date: 2021-05-13

Cell handlers now need to have a clear() method defined which clears the output of the cell (whatever that means for that cell type). Although the Typescript typing is strict about this requirement, it checks for the existence for backwards compatibility purposes.
Added runtime.controls.clearAllCells.
Changed Bootstrap's theme colors to a more modern palette similar to Bulma (e.g. when using bg-success it is now a light green / teal color instead of dark green).
Update KaTeX to version 0.13.10.
Update markdown-it to version 12.0.6.
The <> Source button now creates a modal with a minimum size that resizes the iframe as well (before it would show a 1px high modal when there were no cells).

Release 0.9.2

Date: 2021-05-13

Better support for error handling and error catching when invoking a cell programmatically. This fixes run all cells continuing after a cell throws an error.
Javascript errors are no longer printed twice in a cell's output.

Release 0.9.1

Date: 2021-05-07

Update to starboard-python version 0.6.4, which allows for catching errors during execution by user code or third party plugins.

Release 0.9.0

Date: 2021-05-06

The iframe now resizes to at least be able to show dropdown menus.
Update to Bootstrap version 5.0.0.
Update to Monaco version 0.23.0.
Fix code editor showing loading CodeMirror editor even though it is loading Monaco when the default is set to CodeMirror.
Breaking change for plugin developers using the plugin options parameter: plugins now receive the runtime as the first argument in the register function.
Update ESlint to latest version, all code is now formatted using prettier.

Release 0.8.14

Date: 2021-05-02

Fix for alt+enter not always inserting a new cell (thank you @unhott).
Fix for the cell editor control menu disappearing behavior (thank you @unhott).
Pressing up or down arrow when at the start or end of a cell's code editor now focuses the adjacent cell (thank you @stefnotch).
Update to starboard-python 0.6.3 which fixes Matplotlib output rendering and prevents multiple cells having overlapped execution.
Removed minify-lit-html-loader, which means the build pipeline requires less hacks and we can use ES2019 and ES2020 features such as nullish coalescing and optional chaining (?. and ??). The build target remains ES2018.

Release 0.8.13

Date: 2021-04-30

Update to Starboard Python 0.6.0, which wraps Pyodide version 0.17.0.
Added textToNotebookContent to runtime.exports.core to allow external plugins to more easily parse notebook content.
Added optional generic type parameter to allow plugins to be explicit about its register options object.
Small fix to an import in a typing in types/core.

Release 0.8.12

Date: 2021-04-22

Changed typing of plugin.register to allow for an optional argument to configure the plugin, which you can also pass to runtime.controls.registerPlugin.

Release 0.8.11

Date: 2021-04-22

Added runtime.plugins and runtime.controls.registerPlugin(plugin) to formalize a structure for Starboard plugins. See the type in types/plugins.
The attach callback for Cell Type Handlers now receives the cell element itself too.

Release 0.8.10

Date: 2021-04-21

Consolidated all types into the types path instead of being spread in multiple types.ts files.
Now supports dynamically loaded property types being present on cells prior to where it gets registered.
Added property-<NAME> to the cell property toggle buttons to allow you to hide individually using CSS.
Added NOTEBOOK_SET_METADATA message that can be sent from parent iframe to overwrite the notebook metadata.

Release 0.8.9

Date: 2021-04-18

Removed our own CSS rest: we can rely on Bootstrap for that.
Removed most of the markdown-body class, instead all content now has reasonable styling out of the box. The only thing it changes now is the base font size.
Removed custom cell-controls-button focus, we just rely on Bootstrap now.
Fixed the quick-insert button not being visible if selected but not hovered.
Added "Copy to clipboard" button to source view.
Removed maximum view height for cell-top and cell-bottom.

Release 0.8.8

Date: 2021-04-16

Added Source button in the footer to allow for easy viewing and downloading of the notebook source.
Removed rounded corners of console output (whoops).
Added a quick-insert button for cells next to the + insert button.

Release 0.8.7

Date: 2021-04-15

Fixed width issues that would sometimes occur with wide content in iframe mode.

Release 0.8.6

Date: 2021-04-14

Introduced hide_top and hide_bottom to hide half the cell when not focused. Useful for hiding the code or output when it doesn't add to your narrative.
All cell properties now add a property-<NAME> class to the cell to allow for easy semantic styling.
Fixed the Javascript cell run button tooltip stating "cell is running" when it was not.

Release 0.8.5

Date: 2021-04-13

Fix overflow issue when using Monaco editor.
Removed overflow: auto from cell-top and cell-botom, it makes doing popovers unnecessarily difficult.
Made the text editor outline invisible unless selected.
Removed the rounded edges of editors and console output. It looks pretty, but it can't be styled flush without a bit of Javascript.
Made the collapsed cell indicator line less confusing.
Breaking change (I don't think any plugins were using this, so probably nobody will notice): removed katex and katexLoader globals. You can access it as await runtime.exports.libraries.async.KaTeX() instead.

Release 0.8.4

Date: 2021-04-12

Fix for text editor overflowing when the notebook contains very long lines.

Release 0.8.3

Date: 2021-04-12

Cell type definitions now include a method that allows for a customized cell creation interface.
Some fixes for math behavior in Markdown cells (we now import prosemirror-math where possible).
Fix: Pressing shift-enter in the codemirror editor no longer adds a newline.
Removed the old cell insertion button and added the +-line button above cells too now.
The default editor for Markdown cells is the plaintext one again. In a future version it should probably remember the preferred editor.
Quality of life: When inserting a new cell, press enter to insert the selected cell type immediately.
Lots of style improvements:
- The borders of the text editors and console output are less pronounced and corners are rounded.
- The "cell type color hint" left border was removed.
- All cell bottoms now default to having a little bit of padding underneath.
- Fix the notebook footer not aligning with the cells.
- The top bar of cells is now smaller
- The cell gutter button (in the left margin) is now thinner by default.
- The cell type selector menu selected state looks a lot better now.
- The notebook will now grow a bit if it is too small when the cell type selector is opened.
- Responsivity tweak: On small devices the gutters will be reduced in width.
- CSS fade in animations added to cells.

Release 0.8.2

Date: 2021-04-01

Running the last cell no longer inserts a new cell (like Jupyter would).
Every cell's HTML is now simplified, the intermediate <section class="cell-container"> was removed, this container class is now on the custom cell element itself.
The margin is now variable and larger. For small screens we can resize it responsively through CSS in the future.
A cell insertion line is now visible when hovering or selecting a cell, with a small + button on the left to insert a new cell.
A new menu is now visible when inserting a new cell, in the future this will contain information about the cell type.
Double-clicking the cell-insertion + inserts the same cell type right away.
Updated highlighting package (audit fix).
Removed global letter spacing rule (used to be -0.01em), it now only applies to (Markdown) content.
Font size reduced to 14px, only in content (i.e. Markdown) it still defaults to 16px.

Release 0.8.1

Date: 2021-03-26

Update starboard-python version 0.5.1 which allows user code to catch Python errors.

Release 0.8.0

Date: 2021-03-24

Markdown cells now have their own WYSIWYG editor (as well as a plaintext editor for advanced users).
- Shift-enter and ctrl-enter no longer run the next cell when the WYSIWYG content editor is focused.
- The WYSIWYFG editor has LaTeX inline editing support (based on prosemirror-math package). It's a bit experimental at this stage, remember you can use the fallback plaintext editor.
- Double-clicking a markdown cell triggers this editor.
A newly inserted cell now defaults to Markdown instead of Javascript when no cells are present.
Clicking anywhere outside of a markdown cell stops its edit mode.
Minor style changes
- Slightly reduced the margin below paragraphs and list items (1em to 0.8em).
- Added padding around all markdown content, including inside the WYSIWYG editor.
Codemirror editor
- Updated to codemirror version 0.16.0.
- Codemirror editor now has Markdown syntax highlighting support.
- Removed naive CodeMirror JS autocompletion that would previously only autocomplete stuff present on the Window object.

Release 0.7.21

Date:: 2021-03-19

A small fix for the ProseMirror-based editor: if the prosemirror package hadn't been loaded yet asynchronously a CSS class for the markdown output would not be applied.

Release 0.7.20

Date:: 2021-03-19

Introduce ProseMirror as the default editor for Markdown content. Note that it isn't enabled yet for Markdown editors by default, it still needs some love (in particular it needs KaTeX support)
StarboardContentEditor element is exposed in the exports for plugins to use.
Removed custom text selection styling with CSS.
Made build:stats command require less manual effort (you no longer need to know which line to edit in webpack.config.js to make it work).

Release 0.7.19

Date: 2021-03-17

Update starboard-python to 0.5.0.
Starboard Python is now exported allowing plugins to more easily invoke Python code outside of a Python cell.

Release 0.7.18

Date: 2021-03-17

Starboard Notebook's distribution now includes runtime exports as a convenient ESM package for easier plugin development. These can be found at starboard-notebook/dist/src/runtime/esm and submodules.

Release 0.7.17

Date: 2021-03-16

Starboard now users Bootstrap 5 as the base of its CSS.
Added the popper library to the exports of the runtime.
The right gutter placeholder HTML elements don't get created anymore which saves 3 empty HTML elements per cell.

Release 0.7.16

Date: 2021-03-12

Added RESET_CELL functionality
Cells which persist their IDs now correctly reset when they have a new cell type definition loaded for them.

Release 0.7.15

Date: 2021-03-11

Change the cell's metadata type definition to allow for arbitrary other keys.

Release 0.7.14

Date: 2021-03-08

The cell ID is now also the ID of the cell DOM element automatically.
Randomly generated cell IDs are now prefixed with cell-.
A config object can now be put on the window with the name runtimeConfig.
- This config can be used to customize the runtime, for instance to enable persistent cell IDs (useful for compatibility with Jupyter).
- In the future this is also where you would disable certain cell types.

Release 0.7.13

Date: 2021-03-08

Rename message "NOTEBOOK_REFRESH_PAGE" to "NOTEBOOK_RELOAD_PAGE" as it's a reload instruction, not refresh.
The base URL of the notebook can now be set through the init data message, instead of through a separate message.

Release 0.7.12

Date: 2021-03-08

Fix small styling regression causing the footer to be drawn too far to the left.

Release 0.7.11

Date: 2021-03-07

Simplified the content struct in messages between an iframed notebook and the parent webpage.

Release 0.7.10

Date: 2021-03-07

Changes to the inbound and outbound messages between a notebook iFrame and the parent webpage. They are now defined in a type-safe manner in the /messages folder.
Minor type improvements (non-breaking) for cell change listener callback functions.
The LockClosedIcon is now exported allowing for re-use in plugins / user code.
Added name field to the runtime object, which for this project will always equal "starboard-notebook".

Release 0.7.9

Date: 2021-02-22

Added lock cell property which allows you to make cells edit-only. Thank you @unhott!

Release 0.7.8

Date: 2021-01-06

Update to starboard-python 0.4.1, which now wraps Pyodide 0.16.1, see the Pyodide changelog here. Some notable changes:
- You can now surpress Python output by adding ; to the end of the cell, just like you would in Jupyter.
- Sympy was updated to 1.6.2.
- Python version is now 3.8.X (it was 3.7 before).
Sympy output now gets rendered if returned from a cell. For example a Python cell with this content
```
import sympy
expr = sympy.sympify("x**2 + 3*x - 1/2")
expr
```
displays the expression below the cell rendered through KaTeX.

Release 0.7.7

Date: 2020-12-24

Editor preference is now set in a try-catch, which fixes an issue when localStorage is not available which was sometimes seen in Chromium-based browsers.

Release 0.7.6

Date: 2020-12-09

Hopefully fixed Monaco's sizing issues when collapsing and revealing cells.

Release 0.7.5

Date: 2020-12-03

A small hotfix improvement to 0.7.4: the CSS in css cells is now also applied on load.

Release 0.7.4

Date: 2020-12-03

You can now subscribe to changes to individual cells using runtime.controls.subscribeToCellChanges(id, callback).
The css cell type now applies the CSS automatically without a run button.
The console output now only renders once per frame instead of on every entry added. Running console.log in a loop with hundreds iterations no longer freezes the browser for a while.
Fixed line spacing of console output (how it should have been).
The editor now defaults to Monaco on non-touchscreen devices.

Release 0.7.3

Date: 2020-11-21

Fix some CSS rules (<strong> did not work in Markdown output).

Release 0.7.2

Date: 2020-11-20

Increase responsivity when opening huge notebooks (hundreds of cells) by only loading one editor at a time.
HTML is now enabled in markdown cells.
Minor style upgrades:
- Changed the markdown link color and removed the underline
- The contrast of the cell indicator gutter line (on the left) upon hovering was decreased.
- The Edit on Starboard link's color is a nearly invisible grey again.
- The cell controls on the left are now also less visible unless the cell is focused.
- The selection background is now a ligher color (#3a3a3a to #555).
You can now import Starboard without immediately creating the <starboard-notebook> component by importing starboard-notebook/dist/init.
The <base> element now correctly gets inserted into the head instead of the body.
You can now change the href of the page's base tag by sending a "SET_BASE_URL" message from the parent iframe.

Release 0.7.1

Date: 2020-11-17

Minor opacity tweaks of cell controls button and made the footer harder to see again.

Release 0.7.0

Date: 2020-11-16

This update features a large style rework - the notebook's actual content is now capped in width. There are gutters on either side of that content. The typography was improved and it now has a more distinct style from Github markdown.

The global styles are now more easily changed through CSS custom variables properties.
Fixed the font of codemirror sometimes not being the correct one.
Changed line numbers to a gray color so they distract less.
Added emoji support in Markdown 👋, the hook is exposed for plugins at runtime.exports.core.hookMarkdownItToEmojiPlugin.

Release 0.6.6

Date: 2020-11-15

Hotfix: Re-introduce the Node polyfills - some libraries require them at runtime, including Babel.

Release 0.6.5

Date: 2020-11-15

Intermediate test release.

Release 0.6.4

Date: 2020-11-13

Broken release, fixed in 0.6.6

A big decrease in bundle size that is loaded initially, from 930KB (278KB gzipped) to 520KB (146KB gzipped approximately).

The console output rendering code is now loaded asynchronously, saving ~140KB from the critical path.
KaTeX is now loaded asynchronously, markdown content is now rendered without LaTeX rendering, and then re-rendered once it is loaded. The export of KaTeX is now found under runtime.exports.async.KaTeX. This saves ~244KB from the intiial load.
- This is a breaking change for notebooks that and rely on window.katex, those notebooks should now run await window.lazyKatex first to ensure it is already loaded.
- hookMarkdownItToKaTeX is now an async function.
Node polyfills that automatically get bundled are now excluded, saving around 30KB.

Release 0.6.3

Date: 2020-11-07

Added cell-output-html class that slightly pads the output, it is used when Javascript or ESM cells output HTML elements.

Internal changes (only relevant for plugin developers):

The register function of a MapRegistry (used to register new cell types) now accepts an array of keys to assign to the same definition.
renderIfHtmlOutput added to DRY rendering of HTML output (used for either vanilla HTML elements or lit-html's TemplateResult).
The ConsoleCatcher class now has a getRawConsoleMethods() which can be used to retrieve a pointer to the original console methods so you can log messages without them appearing in any cell's output.

Release 0.6.2

Date: 2020-11-01

Fix regression when setting content from parent frame if notebook is embedded in iframe.

Release 0.6.1

Date: 2020-11-01

This version never went live on Starboard.gg, it has a regression which was fixed in 0.6.2.

Update starboard-python to 0.3.4, in which Pyodide files are now prefetched when a Python cell is first created.
The babel parser (only used when executing Javascript cells) is now loaded asynchronously, shaving more than 450KB from the critical JS path.
CSS is now minified (saving ~11KB), and more strict JS minify options are used (saving ~20KB).
A cell type definitions can now be overwritten and existing cells with that type will reset automatically.
(internal change): Javascript precompile function is now async to allow for dynamic loading of Babel.
(internal change): Refactorings in the internal core, removing core functionality from view code in Notebook HTML element.

Editor updates:

Support word wrap in CodeMirror editor (enabled by default in Markdown cells).
Rich Coffeescript syntax in Monaco editor.
Update to CodeMirror 0.14.0
Fix cell type hint CSS for javascript and python cell types (left border of the editor).
Fix codicons.ttf not loading.
Minor changes to default font in CodeMirror to bring it closer to Monaco's look.

Release 0.6.0

Date: 2020-10-28

In this update starboard-notebook switches to a new format which is more similar to Jupytext's formats.

New format for notebooks, cells are now delimited by # %% [markdown] or // %% [markdown], global notebook metdata is defined in a YAML header, and cell metadata and properties are also defined in YAML. An example:

---
starboard:
  version: 0.6.0
  format_version: 1
---
# %% [markdown]
# A markdown title! Not part of the cell description
Lorem ipsum....

# Another title
Bla

# %%--- [javascript]
# properties:
#   run_on_load: true
# ---%%
class MyClass {
    constructor(a) {
        this.x = a;
    }
}
# %% [javascript]
const instance = new MyClass(3);
instance.x

The old format still works (but will be phased out) - if you open a notebook in the old format it will be saved into the new format.
All metadata keys and cell properties are preferred to be in in snake_case.
- runOnLoad was renamed to run_on_load. runOnLoad still works for backwards compatability but will be removed in a future version.
Breaking change: A cell's properties are now nested under cell.metadata.properties instead of cell.properties.
Breaking change: A legacy cell without a cell type identifier is no longer recognized as a cell (e.g. a line with just %%). This was never possible on the Starboard.gg site anyway.

Other changes:

Fix the cell properties button, before it would open the cell type menu instead.
Fix deleting a property not marking the notebook content as changed (which prompts the user to save).
Fix Monaco editor layouting:
- Fix the editor being empty if initially collapsed.
- Fix the editor sometimes not resizing to full height after being collapsed.
- Fix the editor not taking the scrollbars into account when resizing.
KaTeX .ttf fonts are no longer bundled as Starboard's supported browsers can understand woff2 anyway.
ipython3 cell type identifier now also maps to the Python (Pyodide) cell type.
KaTeX is now available in global scope (window.katex) and under runtime.exports.libraries.KaTeX for plugins to use, as well as its markdown-it integration under runtime.exports.core.hookMarkdownItToKaTeX.
YAML (yaml@next) is now available on global scope (window.YAML) and under runtime.exports.libraries.YAML.

Release 0.5.6

Date: 2020-10-22

A cell type can now have multiple cell type identifiers (e.g. "javascript" and "js" map to the same definition), the longer version is now preferred.
LaTeX math typesetting support through KaTeX is now available in markdown cells.
New latex cell type that renders contents using KaTeX.
Fix out of bounds error when executing last cell using Shift+Enter shortcut.

Release 0.5.5

Date: 2020-10-13

You can now define notebook content in a <script type="application/vnd.starboard.nb"> tag and it will be automatically loaded.

Release 0.5.4

Date: 2020-10-12

Better support for self-hosting: you can now use a CDN build on any webpage and any dynamic imports still work. This makes the minimal standalone notebook example just a HTML file.
You can override the root of the starboard notebook build artifacts by setting window.starboardArtifactsUrl.

Release 0.5.3

Date: 2020-10-08

New ES Module cell type (esm), that executes code using import(), which allows you to use top-level imports without await. Anything you export is put on the window object.
The left border of a focused cell text editor now reflects the cell type as a visual cue.

Release 0.5.2

Date: 2020-10-06

CodeMirror is now the default editor which loads without user input.
The chosen editor is now persisted (in LocalStorage).
Editor improvements:
- Added Copy Text button to cells which copies the text's content to clipboard.
- Installed Python plugin for CodeMirror (this enables functionality like ctrl+/ to comment lines and code folding).
- Codemirror styling overhaul, it is now closer to that of the Prism highlighter and the Monaco editor.
- (internal change): Updated CodeMirror editor to 0.13.0
Popovers now smartly position themselves inside the frame (before they would overflow below the page when selecting a cell type).
Enable Python support in standalone notebooks.
Update to Python plugin starboard-python 0.2.7, which renders HTML elements output by Python code.

Release 0.5.1

Date: 2020-10-01

Update to Python plugin starboard-python 0.2.6, which prints fewer messages to the console when loading packages.

Release 0.5.0

Date: 2020-10-01

No changes from 0.4.16, but solid Python support deserves a minor update.

Release 0.4.16

Date: 2020-10-01

Removed unnecessary empty line that appeared after some types of console output.
Support for printing a dynamically imported module (e.g. console.log(await import("https://example.com/my-library.js"))).
Remove default line-height from CSS on the document body, this makes console output smaller and fixes the height mismatch between printed variables and strings.
(internal change): Update to starboard-python plugin version 0.2.4
(internal change): Simplified console hooking and logging interface in Javascript cells and other plugin-based languages (such as Python).
(internal change): Add GearsIcon to built-in icons (the Python plugin no longer needs to include it now).

Release 0.4.15

Date: 2020-09-30

Remove the (experimental) tag for Python support - it's pretty solid.
The Pyodide URL can now be overried using window.pyodideArtifactsUrl, useful if you want to use Python support entirely on localhost.

Release 0.4.14

Date: 2020-09-30

Less experimental Python support, matplotlib and html output (e.g. from Pandas) now works.
PyProxies now have special support when shown in the console output.
Console output no longer chokes on huge objects (e.g. the pyodide object).

Release 0.4.13

Date: 2020-09-17

Experimental Python support works with the exception of anything with HTML output (e.g. matplotlib figures).

Release 0.4.12

Date: 2020-09-17

Non-production intermediate release.

Minor Python cell debug message improvements when loading external libraries.

Release 0.4.11

Date: 2020-09-17

Non-production intermediate release.

Experimental Python cell support.

Release 0.4.10

Date: 2020-08-25

Fix initial notebook content being a debug value..

Release 0.4.9

Date: 2020-08-17

runOnLoad now correctly runs cells on load that have their cell type loaded in a prior cell.

Release 0.4.8

Date: 2020-08-17

Better support for cell type registration: cells that have an unknown cell type (e.g. py for Python) will now automatically become a fully-fledged cell if that cell type gets registered.

Release 0.4.7

Date: 2020-08-15

Minor changes in type definitions which makes importing starboard-notebook as a library more straightforward.

Release 0.4.6

Date: 2020-08-09

Remove unnecessary scrollbar in CodeMirror editor by fixing wrong CSS rule.

Release 0.4.5

Date: 2020-08-09

Allow specifying starboardEditUrl on window to link to the source notebook on Starboard, this is useful when embedding.

Release 0.4.4

Date: 2020-08-09

The notebook now tries to contact the parent page multiple times, before sometimes the nested iframe would not get the notebook content message.
Made the background of the notebook and cells pure white instead of slightly gray. It doesn't look good when embedding on a pure-white page (such as Notion).

Release 0.4.3

Date: 2020-08-08

Fix close button behavior in cell popovers (e.g. in cell type select menu).

Release 0.4.2

Date: 2020-08-08

Bugfix introduced in 0.4.0 in which cell creation and removal was broken.

Release 0.4.1

Date: 2020-08-07

Bugfix for content not getting transmitted properly through the iframe barrier.

Release 0.4.0

Date: 2020-08-07

A large refactor: Starboard Notebook is now built around a single Runtime that allows for metaprogramming and plugin support. This is a single source of truth for the state and functionality of a notebook. It is exposed as a global variable runtime.
- This centralizes the logic for the notebook and makes plugins possible that change the notebook in meaningful ways, for instance adding new cell types.
- It allows for metaprogramming, you could for instance programmatically change or retrieve a cell's content, or trigger a cell run.
- It exports internal functions and imported libraries so you can use these in notebooks and plugins. This way plugins don't have to bundle these dependencies themselves (and risk using different versions that may break things in subtle ways).
- Try it in a notebook, run console.log(runtime)
class definitions at the top level are now available globally (as they should have been all along, a bug prevented this).
var definitions are only made global if they are in the top level of the cell. Before they were always made global.
Support for custom Cell Properties: they can now be programatically added or removed.
Fix for console output when running multiple cells on notebook load, before all console output would be shown in the last cell's output box instead of the respective cells.

Release 0.3.2

Date: 2020-08-06

Changes to cells (adding cells, removing cells, changing cell types and properties) now correctly are propagated as changes that should be saveable.
Monaco editor now wraps lines in Markdown cells
(internal change): We now use rimraf instead of rm -rf to better support building the project on Windows.

Release 0.3.1

Date: 2020-08-06

Fix for runOnLoad not working in iframe mode in which content comes from outside the iframe.

Release 0.3.0

Date: 2020-08-06

Cell Properties: Properties are 'settings' for a cell. Properties are stored in the notebook file as such:
```
%% js collapsed someOtherProperty
console.log("Hello!");
```
Right now all properties are binary: they are either present or not and have no value. In the future this will likely have to change.
collapsed property added. When enabled this hides the cell code and output unless it is focused. You can click the top patter of the gutter to toggle this property.
runOnLoad property added: if enabled the cell will be executed when the notebook is first loaded. This is especially useful for interactive articles in which you don't want to rely on the user clicking the tiny play button for a cell, or to run a hidden cell that loads dependencies.
A properties button was added to the top right of cells, here you can toggle cell properties.
Reworked gutter (the clickable line on the left of the cell).
Parser improvements:
- %% without a cell type specifier now creates a cell with an empty cell type instead of considering it frontmatter.
- There were some cases in which the input document was altered if immediately saved when the frontmatter only consisted of newlines.
(internal change): Split the CSS of different sub-component into separate files.

Release 0.2.2

Date: 2020-08-01

This is the version when Starboard.gg was first posted on Show HN.

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Changelog

Release 0.15.7

Release 0.15.6

Release 0.15.5

Release 0.15.4

Release 0.15.3

Release 0.15.2

Release 0.15.1

Release 0.15.0

Release 0.14.2

Release 0.14.1

Release 0.14.0

Release 0.13.3

Release 0.13.2

Release 0.13.1

Release 0.13.0

Release 0.12.3

Release 0.12.2

Release 0.12.1

Release 0.12.0

Release 0.11.1

Release 0.11.0

Release 0.10.2

Release 0.10.1

Release 0.10.0

Release 0.9.4

Release 0.9.3

Release 0.9.2

Release 0.9.1

Release 0.9.0

Release 0.8.14

Release 0.8.13

Release 0.8.12

Release 0.8.11

Release 0.8.10

Release 0.8.9

Release 0.8.8

Release 0.8.7

Release 0.8.6

Release 0.8.5

Release 0.8.4

Release 0.8.3

Release 0.8.2

Release 0.8.1

Release 0.8.0

Release 0.7.21

Release 0.7.20

Release 0.7.19

Release 0.7.18

Release 0.7.17

Release 0.7.16

Release 0.7.15

Release 0.7.14

Release 0.7.13

Release 0.7.12

Release 0.7.11

Release 0.7.10

Release 0.7.9

Release 0.7.8

Release 0.7.7

Release 0.7.6

Release 0.7.5

Release 0.7.4

Release 0.7.3

Release 0.7.2

Release 0.7.1

Release 0.7.0

Release 0.6.6

Release 0.6.5

Release 0.6.4

Release 0.6.3

Release 0.6.2

Release 0.6.1

Release 0.6.0