@myst-theme/jupyter 0.1.36 → 0.1.37

package/dist/esm/jupyter.js

@@ -1,28 +1,54 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import React, { useEffect, useRef, useState } from 'react';
 import { useFetchAnyTruncatedContent } from './hooks';
 import { convertToIOutputs } from 'nbtx';
 import { fetchAndEncodeOutputImages } from './convertImages';
-import { useThebeCore } from './thebe-provider';
-function OutputRenderer({ id, data, core }) {
-    const [cell] = useState(new core.PassiveCellRenderer(id));
+import { useThebeCore } from 'thebe-react';
+import { useCellRef, useCellRefRegistry, useNotebookCellExecution } from './providers';
+import { SourceFileKind } from 'myst-common';
+function ActiveOutputRenderer({ id, data }) {
+    const ref = useCellRef(id);
+    const exec = useNotebookCellExecution(id);
+    useEffect(() => {
+        if (!(ref === null || ref === void 0 ? void 0 : ref.el) || !(exec === null || exec === void 0 ? void 0 : exec.cell))
+            return;
+        console.debug(`Attaching cell ${exec.cell.id} to DOM at:`, {
+            el: ref.el,
+            connected: ref.el.isConnected,
+            data,
+        });
+        exec.cell.attachToDOM(ref.el);
+        exec.cell.render(data);
+    }, [ref === null || ref === void 0 ? void 0 : ref.el, exec === null || exec === void 0 ? void 0 : exec.cell]);
+    return null;
+}
+function PassiveOutputRenderer({ id, data, core, kind, }) {
+    const [cell] = useState(new core.PassiveCellRenderer(id, undefined, undefined));
     const ref = useRef(null);
     useEffect(() => {
-        cell.render(data);
+        cell.render(data, kind === SourceFileKind.Article);
     }, [data, cell]);
     useEffect(() => {
         if (!ref.current)
             return;
-        cell.attachToDOM(ref.current);
+        cell.attachToDOM(ref.current, true);
     }, [ref]);
-    return _jsx("div", { ref: ref });
+    return _jsx("div", { ref: ref, "data-thebe-passive-ref": "true" });
 }
-const MemoOutputRenderer = React.memo(OutputRenderer);
-export const NativeJupyterOutputs = ({ id, outputs, }) => {
-    const { core } = useThebeCore();
+const MemoPassiveOutputRenderer = React.memo(PassiveOutputRenderer);
+export const JupyterOutputs = ({ id, outputs }) => {
+    var _a;
+    const { core, load } = useThebeCore();
     const { data, error } = useFetchAnyTruncatedContent(outputs);
     const [loaded, setLoaded] = useState(false);
     const [fullOutputs, setFullOutputs] = useState(null);
+    const registry = useCellRefRegistry();
+    const exec = useNotebookCellExecution(id);
+    useEffect(() => {
+        if (core)
+            return;
+        load();
+    }, [core, load]);
     useEffect(() => {
         if (!data || loaded)
             return;
@@ -35,5 +61,8 @@ export const NativeJupyterOutputs = ({ id, outputs, }) => {
     if (error) {
         return _jsxs("div", Object.assign({ className: "text-red-500" }, { children: ["Error rendering output: ", error.message] }));
     }
-    return (_jsxs("div", { children: [!fullOutputs && _jsx("div", Object.assign({ className: "p-2.5" }, { children: "Loading..." })), fullOutputs && core && _jsx(MemoOutputRenderer, { id: id, core: core, data: fullOutputs })] }));
+    if (registry && (exec === null || exec === void 0 ? void 0 : exec.cell)) {
+        return (_jsxs("div", Object.assign({ ref: registry === null || registry === void 0 ? void 0 : registry.register(id), "data-thebe-active-ref": "true" }, { children: [!fullOutputs && _jsx("div", Object.assign({ className: "p-2.5" }, { children: "Loading..." })), fullOutputs && _jsx(ActiveOutputRenderer, { id: id, data: fullOutputs })] })));
+    }
+    return (_jsxs(_Fragment, { children: [!fullOutputs && _jsx("div", Object.assign({ className: "p-2.5" }, { children: "Loading..." })), fullOutputs && core && (_jsx(MemoPassiveOutputRenderer, { id: id, data: fullOutputs, core: core, kind: (_a = exec === null || exec === void 0 ? void 0 : exec.kind) !== null && _a !== void 0 ? _a : SourceFileKind.Notebook }))] }));
 };

package/dist/esm/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/output.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,MAAM,CAAC;AAO/D,eAAO,MAAM,mBAAmB,aAA+B,CAAC;AAEhE,eAAO,MAAM,iBAAiB,aAMb,CAAC;AAElB,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EAAE,EACzB,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,WAY7B;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,eA+BvC"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/output.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,MAAM,CAAC;AAM/D,eAAO,MAAM,mBAAmB,aAA+B,CAAC;AAEhE,eAAO,MAAM,iBAAiB,aAMb,CAAC;AAElB,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EAAE,EACzB,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,WAY7B;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,eA2BvC"}

package/dist/esm/output.js

@@ -2,9 +2,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { KnownCellOutputMimeTypes } from 'nbtx';
 import classNames from 'classnames';
 import { SafeOutputs } from './safe';
-import { NativeJupyterOutputs as JupyterOutputs } from './jupyter';
-import ClientOnly from './ClientOnly';
-import { ThebeCoreProvider } from './thebe-provider';
+import { JupyterOutputs } from './jupyter';
+import { useNotebookCellExecution } from './providers';
 export const DIRECT_OUTPUT_TYPES = new Set(['stream', 'error']);
 export const DIRECT_MIME_TYPES = new Set([
     KnownCellOutputMimeTypes.TextPlain,
@@ -26,17 +25,17 @@ export function allOutputsAreSafe(outputs, directOutputTypes, directMimeTypes) {
     }, true);
 }
 export function Output(node) {
+    const exec = useNotebookCellExecution(node.key);
     const outputs = node.data;
     const allSafe = allOutputsAreSafe(outputs, DIRECT_OUTPUT_TYPES, DIRECT_MIME_TYPES);
     let component;
-    if (allSafe) {
+    if (allSafe && !(exec === null || exec === void 0 ? void 0 : exec.ready)) {
         component = _jsx(SafeOutputs, { keyStub: node.key, outputs: outputs });
     }
     else {
-        // Hide the iframe if rendering on the server
-        component = (_jsx(ClientOnly, { children: _jsx(ThebeCoreProvider, { children: _jsx(JupyterOutputs, { id: node.key, outputs: outputs }) }) }));
+        component = _jsx(JupyterOutputs, { id: node.key, outputs: outputs });
     }
-    return (_jsx("figure", Object.assign({ id: node.identifier || undefined, className: classNames('max-w-full overflow-auto m-0 group not-prose relative', {
+    return (_jsx("figure", Object.assign({ id: node.identifier || undefined, "data-mdast-node-type": node.type, "data-mdast-node-id": node.key, className: classNames('max-w-full overflow-auto m-0 group not-prose relative', {
             'text-left': !node.align || node.align === 'left',
             'text-center': node.align === 'center',
             'text-right': node.align === 'right',

package/dist/esm/providers.d.ts

@@ -0,0 +1,67 @@
+import type { GenericParent } from 'myst-common';
+import { SourceFileKind } from 'myst-common';
+import React from 'react';
+import type { Config, IThebeCell, IThebeCellExecuteReturn, ThebeCore, ThebeNotebook } from 'thebe-core';
+import type { IThebeNotebookError, NotebookExecuteOptions } from 'thebe-react';
+import type { Root } from 'mdast';
+export declare function ConfiguredThebeServerProvider({ children }: React.PropsWithChildren): JSX.Element;
+export type PartialPage = {
+    kind: SourceFileKind;
+    file: string;
+    sha256: string;
+    slug: string;
+    mdast: Root;
+};
+export declare function notebookFromMdast(core: ThebeCore, config: Config, mdast: GenericParent, idkMap: Record<string, string>): ThebeNotebook;
+type CellRefRegistry = Record<string, HTMLDivElement>;
+type IdKeyMap = Record<string, string>;
+interface NotebookContextType {
+    kind: SourceFileKind;
+    ready: boolean;
+    attached: boolean;
+    executing: boolean;
+    executed: boolean;
+    errors: IThebeNotebookError[] | null;
+    executeAll: (options?: NotebookExecuteOptions | undefined) => Promise<(IThebeCellExecuteReturn | null)[]>;
+    executeSome: (predicate: (cell: IThebeCell) => boolean, options?: NotebookExecuteOptions | undefined) => Promise<(IThebeCellExecuteReturn | null)[]>;
+    notebook: ThebeNotebook | undefined;
+    registry: CellRefRegistry;
+    idkMap: IdKeyMap;
+    register: (id: string) => (el: HTMLDivElement) => void;
+    restart: () => Promise<void>;
+    clear: () => void;
+}
+export declare function NotebookProvider({ siteConfig, page, children, }: React.PropsWithChildren<{
+    siteConfig: boolean;
+    page: PartialPage;
+}>): JSX.Element;
+export declare function useHasNotebookProvider(): boolean;
+export declare function useCellRefRegistry(): {
+    register: (id: string) => (el: HTMLDivElement) => void;
+} | undefined;
+export declare function useCellRef(id: string): {
+    el: HTMLDivElement | null;
+} | undefined;
+export declare function useMDASTNotebook(): NotebookContextType | undefined;
+export declare function useNotebookExecution(): {
+    ready: boolean;
+    attached: boolean;
+    executing: boolean;
+    executed: boolean;
+    errors: IThebeNotebookError[] | null;
+    execute: (options?: NotebookExecuteOptions | undefined) => Promise<(IThebeCellExecuteReturn | null)[]>;
+    notebook: ThebeNotebook | undefined;
+    clear: () => void;
+} | undefined;
+export declare function useNotebookCellExecution(id: string): {
+    kind: SourceFileKind;
+    ready: boolean;
+    cell: IThebeCell | undefined;
+    executing: boolean;
+    notebookIsExecuting: boolean;
+    execute: (options?: NotebookExecuteOptions) => Promise<(IThebeCellExecuteReturn | null)[]>;
+    clear: () => void | undefined;
+    notebook: ThebeNotebook | undefined;
+} | undefined;
+export {};
+//# sourceMappingURL=providers.d.ts.map

package/dist/esm/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/providers.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAkD,MAAM,OAAO,CAAC;AACvE,OAAO,KAAK,EACV,MAAM,EAEN,UAAU,EACV,uBAAuB,EAEvB,SAAS,EACT,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAoDlC,wBAAgB,6BAA6B,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,iBAAiB,eAOlF;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAwC/B;AAGD,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACtD,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvC,UAAU,mBAAmB;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,CACV,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS,KACzC,OAAO,CAAC,CAAC,uBAAuB,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,WAAW,EAAE,CACX,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,EACxC,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS,KACzC,OAAO,CAAC,CAAC,uBAAuB,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,CAAC;IACvD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAID,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,IAAI,EACJ,QAAQ,GACT,EAAE,KAAK,CAAC,iBAAiB,CAAC;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,eAwErE;AAED,wBAAgB,sBAAsB,YAGrC;AAED,wBAAgB,kBAAkB;;cAIjC;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM;;cAQpC;AAED,wBAAgB,gBAAgB,oCAG/B;AAED,wBAAgB,oBAAoB;;;;;;;;;cAQnC;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM;;;;;;wBAiBhB,sBAAsB;;;cAiBxD"}

package/dist/esm/providers.js

@@ -0,0 +1,197 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { SourceFileKind } from 'myst-common';
+import React, { useContext, useEffect, useRef, useState } from 'react';
+import { useNotebookBase, useThebeConfig, useThebeCore, ThebeServerProvider } from 'thebe-react';
+import { useComputeOptions } from '@myst-theme/providers';
+function getThebeOptions() {
+    var _a, _b, _c;
+    const { thebe, binderUrl } = useComputeOptions();
+    const { mathjaxUrl, mathjaxConfig, binder, server, kernelName, sessionName, disableSessionSaving, local, } = (_a = thebe) !== null && _a !== void 0 ? _a : {};
+    const output = { mathjaxUrl, mathjaxConfig };
+    if (binder) {
+        const useBinder = binder === true ? {} : binder;
+        output.binderOptions = {
+            binderUrl: (_b = useBinder.url) !== null && _b !== void 0 ? _b : binderUrl,
+            ref: useBinder.ref,
+            repo: useBinder.repo,
+            repoProvider: useBinder.provider,
+        };
+    }
+    const useServer = (local !== null && local !== void 0 ? local : server);
+    if (server) {
+        const splitUrl = (_c = useServer.url) === null || _c === void 0 ? void 0 : _c.split('://');
+        const wsUrl = (splitUrl === null || splitUrl === void 0 ? void 0 : splitUrl.length) === 2 ? `ws://${splitUrl[1]}` : undefined;
+        output.serverSettings = {
+            baseUrl: useServer.url,
+            token: useServer.token,
+            wsUrl,
+            appendToken: true,
+        };
+    }
+    output.kernelOptions = {
+        kernelName: kernelName,
+        name: kernelName,
+        path: sessionName,
+    };
+    if (!disableSessionSaving) {
+        output.savedSessionOptions = {
+            enabled: true,
+            maxAge: 38300,
+            storagePrefix: 'thebe',
+        };
+    }
+    return output;
+}
+export function ConfiguredThebeServerProvider({ children }) {
+    const thebe = getThebeOptions();
+    return (_jsx(ThebeServerProvider, Object.assign({ connect: false, options: thebe }, { children: children })));
+}
+export function notebookFromMdast(core, config, mdast, idkMap) {
+    const rendermime = undefined; // share rendermime beyond notebook scope?
+    const notebook = new core.ThebeNotebook(mdast.key, config, rendermime);
+    // no metadata included in mdast yet
+    //Object.assign(notebook.metadata, ipynb.metadata);
+    notebook.cells = mdast.children.map((block) => {
+        var _a, _b, _c;
+        if (block.type !== 'block')
+            console.warn(`Unexpected block type ${block.type}`);
+        if (block.children.length == 2 && block.children[0].type === 'code') {
+            const [codeCell, output] = block.children;
+            // use the block.key to identify the cell but maintain a mapping
+            // to allow code or output keys to look up cells and refs
+            idkMap[block.key] = block.key;
+            idkMap[codeCell.key] = block.key;
+            idkMap[output.key] = block.key;
+            return new core.ThebeCell(block.key, notebook.id, (_a = codeCell.value) !== null && _a !== void 0 ? _a : '', config, (_b = block.data) !== null && _b !== void 0 ? _b : {}, notebook.rendermime);
+        }
+        else {
+            // assume content - concatenate it
+            // TODO inject cell metadata
+            const cell = new core.ThebeNonExecutableCell(block.key, notebook.id, block.children.reduce((acc, child) => { var _a; return acc + '\n' + ((_a = child.value) !== null && _a !== void 0 ? _a : ''); }, ''), (_c = block.data) !== null && _c !== void 0 ? _c : {}, notebook.rendermime);
+            return cell;
+        }
+    });
+    return notebook;
+}
+const NotebookContext = React.createContext(undefined);
+export function NotebookProvider({ siteConfig, page, children, }) {
+    // so at some point this gets the whole site config and can
+    // be use to lookup notebooks and recover ThebeNotebooks that
+    // can be used to execute notebook pages or blocks in articles
+    const { core } = useThebeCore();
+    const { config } = useThebeConfig();
+    const { ready, attached, executing, executed, errors, executeAll, executeSome, clear, session, notebook, setNotebook, } = useNotebookBase();
+    const registry = useRef({});
+    const idkMap = useRef({});
+    useEffect(() => {
+        if (!core || !config)
+            return;
+        registry.current = {};
+        idkMap.current = {};
+        if (page.kind === SourceFileKind.Notebook) {
+            const nb = notebookFromMdast(core, config, page.mdast, idkMap.current);
+            setNotebook(nb);
+        }
+        else {
+            // TODO will need do article relative notebook loading as appropriate once that is supported
+            setNotebook(undefined);
+        }
+    }, [core, config, page]);
+    function register(id) {
+        return (el) => {
+            if (el != null && registry.current[idkMap.current[id]] !== el) {
+                if (!el.isConnected) {
+                    console.debug(`skipping ref for cell ${id} as host is not connected`);
+                }
+                else {
+                    console.debug(`new ref for cell ${id} registered`);
+                    registry.current[idkMap.current[id]] = el;
+                }
+            }
+        };
+    }
+    return (_jsx(NotebookContext.Provider, Object.assign({ value: {
+            kind: page.kind,
+            ready,
+            attached,
+            executing,
+            executed,
+            errors,
+            executeAll,
+            executeSome,
+            notebook,
+            registry: registry.current,
+            idkMap: idkMap.current,
+            register,
+            restart: () => { var _a; return (_a = session === null || session === void 0 ? void 0 : session.restart()) !== null && _a !== void 0 ? _a : Promise.resolve(); },
+            clear,
+        } }, { children: children })));
+}
+export function useHasNotebookProvider() {
+    const notebookState = useContext(NotebookContext);
+    return notebookState !== undefined;
+}
+export function useCellRefRegistry() {
+    const notebookState = useContext(NotebookContext);
+    if (notebookState === undefined)
+        return undefined;
+    return { register: notebookState.register };
+}
+export function useCellRef(id) {
+    var _a;
+    const notebookState = useContext(NotebookContext);
+    if (notebookState === undefined)
+        return undefined;
+    const { registry, idkMap } = notebookState;
+    const entry = Object.entries(notebookState.registry).find(([cellId]) => cellId === idkMap[id]);
+    console.debug('useCellRef', { id, registry, idkMap, entry });
+    return { el: (_a = entry === null || entry === void 0 ? void 0 : entry[1]) !== null && _a !== void 0 ? _a : null };
+}
+export function useMDASTNotebook() {
+    const notebookState = useContext(NotebookContext);
+    return notebookState;
+}
+export function useNotebookExecution() {
+    const notebookState = useContext(NotebookContext);
+    if (!notebookState)
+        return undefined;
+    const { ready, attached, executing, executed, errors, executeAll, notebook, clear } = notebookState;
+    return { ready, attached, executing, executed, errors, execute: executeAll, notebook, clear };
+}
+export function useNotebookCellExecution(id) {
+    // setup a cell only executing state
+    const [executing, setExecuting] = useState(false);
+    const notebookState = useContext(NotebookContext);
+    if (!notebookState)
+        return undefined;
+    const { kind, ready, notebook, executing: notebookIsExecuting, executeSome, idkMap, } = notebookState;
+    const cellId = idkMap[id];
+    function execute(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            setExecuting(true);
+            const execReturn = yield executeSome((cell) => cell.id === cellId, options);
+            setExecuting(false);
+            return execReturn;
+        });
+    }
+    const cell = notebook === null || notebook === void 0 ? void 0 : notebook.getCellById(cellId);
+    return {
+        kind,
+        ready,
+        cell,
+        executing,
+        notebookIsExecuting,
+        execute,
+        clear: () => cell === null || cell === void 0 ? void 0 : cell.clear(),
+        notebook,
+    };
+}

package/dist/types/BinderBadge.d.ts

@@ -0,0 +1,4 @@
+export declare function BinderBadge({ binder }: {
+    binder?: string;
+}): JSX.Element | null;
+//# sourceMappingURL=BinderBadge.d.ts.map

package/dist/types/BinderBadge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinderBadge.d.ts","sourceRoot":"","sources":["../../src/BinderBadge.tsx"],"names":[],"mappings":"AA2DA,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,sBAe1D"}

package/dist/types/ClientOnly.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-export default function ClientOnly({ children }: {
+export declare function ClientOnly({ children }: {
     children: ReactNode;
 }): JSX.Element | null;
 //# sourceMappingURL=ClientOnly.d.ts.map

package/dist/types/ClientOnly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClientOnly.d.ts","sourceRoot":"","sources":["../../src/ClientOnly.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,sBAMvE"}
+{"version":3,"file":"ClientOnly.d.ts","sourceRoot":"","sources":["../../src/ClientOnly.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,sBAM/D"}

package/dist/types/index.d.ts

@@ -2,5 +2,7 @@ import { Output } from './output';
 declare const OUTPUT_RENDERERS: {
     output: typeof Output;
 };
+export * from './BinderBadge';
+export * from './providers';
 export default OUTPUT_RENDERERS;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,QAAA,MAAM,gBAAgB;;CAErB,CAAC;AAEF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,QAAA,MAAM,gBAAgB;;CAErB,CAAC;AAEF,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAE5B,eAAe,gBAAgB,CAAC"}

package/dist/types/jupyter.d.ts

@@ -1,5 +1,5 @@
 import type { MinifiedOutput } from 'nbtx';
-export declare const NativeJupyterOutputs: ({ id, outputs, }: {
+export declare const JupyterOutputs: ({ id, outputs }: {
     id: string;
     outputs: MinifiedOutput[];
 }) => JSX.Element;

package/dist/types/jupyter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jupyter.d.ts","sourceRoot":"","sources":["../../src/jupyter.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAqB3C,eAAO,MAAM,oBAAoB;QAI3B,MAAM;aACD,cAAc,EAAE;iBA0B1B,CAAC"}
+{"version":3,"file":"jupyter.d.ts","sourceRoot":"","sources":["../../src/jupyter.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAmD3C,eAAO,MAAM,cAAc;QAA2B,MAAM;aAAW,cAAc,EAAE;iBAgDtF,CAAC"}

package/dist/types/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/output.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,MAAM,CAAC;AAO/D,eAAO,MAAM,mBAAmB,aAA+B,CAAC;AAEhE,eAAO,MAAM,iBAAiB,aAMb,CAAC;AAElB,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EAAE,EACzB,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,WAY7B;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,eA+BvC"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/output.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,MAAM,CAAC;AAM/D,eAAO,MAAM,mBAAmB,aAA+B,CAAC;AAEhE,eAAO,MAAM,iBAAiB,aAMb,CAAC;AAElB,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EAAE,EACzB,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,WAY7B;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,eA2BvC"}

package/dist/types/providers.d.ts

@@ -0,0 +1,67 @@
+import type { GenericParent } from 'myst-common';
+import { SourceFileKind } from 'myst-common';
+import React from 'react';
+import type { Config, IThebeCell, IThebeCellExecuteReturn, ThebeCore, ThebeNotebook } from 'thebe-core';
+import type { IThebeNotebookError, NotebookExecuteOptions } from 'thebe-react';
+import type { Root } from 'mdast';
+export declare function ConfiguredThebeServerProvider({ children }: React.PropsWithChildren): JSX.Element;
+export type PartialPage = {
+    kind: SourceFileKind;
+    file: string;
+    sha256: string;
+    slug: string;
+    mdast: Root;
+};
+export declare function notebookFromMdast(core: ThebeCore, config: Config, mdast: GenericParent, idkMap: Record<string, string>): ThebeNotebook;
+type CellRefRegistry = Record<string, HTMLDivElement>;
+type IdKeyMap = Record<string, string>;
+interface NotebookContextType {
+    kind: SourceFileKind;
+    ready: boolean;
+    attached: boolean;
+    executing: boolean;
+    executed: boolean;
+    errors: IThebeNotebookError[] | null;
+    executeAll: (options?: NotebookExecuteOptions | undefined) => Promise<(IThebeCellExecuteReturn | null)[]>;
+    executeSome: (predicate: (cell: IThebeCell) => boolean, options?: NotebookExecuteOptions | undefined) => Promise<(IThebeCellExecuteReturn | null)[]>;
+    notebook: ThebeNotebook | undefined;
+    registry: CellRefRegistry;
+    idkMap: IdKeyMap;
+    register: (id: string) => (el: HTMLDivElement) => void;
+    restart: () => Promise<void>;
+    clear: () => void;
+}
+export declare function NotebookProvider({ siteConfig, page, children, }: React.PropsWithChildren<{
+    siteConfig: boolean;
+    page: PartialPage;
+}>): JSX.Element;
+export declare function useHasNotebookProvider(): boolean;
+export declare function useCellRefRegistry(): {
+    register: (id: string) => (el: HTMLDivElement) => void;
+} | undefined;
+export declare function useCellRef(id: string): {
+    el: HTMLDivElement | null;
+} | undefined;
+export declare function useMDASTNotebook(): NotebookContextType | undefined;
+export declare function useNotebookExecution(): {
+    ready: boolean;
+    attached: boolean;
+    executing: boolean;
+    executed: boolean;
+    errors: IThebeNotebookError[] | null;
+    execute: (options?: NotebookExecuteOptions | undefined) => Promise<(IThebeCellExecuteReturn | null)[]>;
+    notebook: ThebeNotebook | undefined;
+    clear: () => void;
+} | undefined;
+export declare function useNotebookCellExecution(id: string): {
+    kind: SourceFileKind;
+    ready: boolean;
+    cell: IThebeCell | undefined;
+    executing: boolean;
+    notebookIsExecuting: boolean;
+    execute: (options?: NotebookExecuteOptions) => Promise<(IThebeCellExecuteReturn | null)[]>;
+    clear: () => void | undefined;
+    notebook: ThebeNotebook | undefined;
+} | undefined;
+export {};
+//# sourceMappingURL=providers.d.ts.map

package/dist/types/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/providers.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAkD,MAAM,OAAO,CAAC;AACvE,OAAO,KAAK,EACV,MAAM,EAEN,UAAU,EACV,uBAAuB,EAEvB,SAAS,EACT,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAoDlC,wBAAgB,6BAA6B,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,iBAAiB,eAOlF;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAwC/B;AAGD,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACtD,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvC,UAAU,mBAAmB;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,CACV,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS,KACzC,OAAO,CAAC,CAAC,uBAAuB,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,WAAW,EAAE,CACX,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,EACxC,OAAO,CAAC,EAAE,sBAAsB,GAAG,SAAS,KACzC,OAAO,CAAC,CAAC,uBAAuB,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,CAAC;IACvD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAID,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,IAAI,EACJ,QAAQ,GACT,EAAE,KAAK,CAAC,iBAAiB,CAAC;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,eAwErE;AAED,wBAAgB,sBAAsB,YAGrC;AAED,wBAAgB,kBAAkB;;cAIjC;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM;;cAQpC;AAED,wBAAgB,gBAAgB,oCAG/B;AAED,wBAAgB,oBAAoB;;;;;;;;;cAQnC;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM;;;;;;wBAiBhB,sBAAsB;;;cAiBxD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myst-theme/jupyter",
-  "version": "0.1.36",
+  "version": "0.1.37",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -16,26 +16,27 @@
     "build:cjs": "tsc --module commonjs --outDir dist/cjs",
     "build:esm": "tsc --module es2020 --outDir dist/esm",
     "build:types": "tsc --declaration --emitDeclarationOnly --declarationMap --outDir dist/types",
-    "build": "npm-run-all -l clean -p build:cjs build:esm build:types",
-    "test": "jest"
+    "build": "npm-run-all -l clean -p build:cjs build:esm build:types"
   },
   "dependencies": {
     "@headlessui/react": "^1.7.13",
     "@heroicons/react": "^2.0.13",
-    "@myst-theme/providers": "^0.1.36",
+    "@myst-theme/providers": "^0.1.37",
     "@popperjs/core": "^2.11.6",
     "ansi-to-react": "^6.1.6",
     "buffer": "^6.0.3",
     "classnames": "^2.3.2",
     "myst-common": "^0.0.16",
-    "myst-config": "^0.0.12",
+    "myst-config": "^0.0.14",
+    "myst-frontmatter": "^0.0.13",
     "myst-spec": "^0.0.4",
     "nanoid": "^4.0.0",
     "nbtx": "^0.2.3",
     "react-popper": "^2.3.0",
     "react-syntax-highlighter": "^15.5.0",
     "swr": "^1.3.0",
-    "thebe-core": "^0.1.1",
+    "thebe-core": "^0.1.6",
+    "thebe-react": "^0.0.7",
     "unist-util-select": "^4.0.1"
   },
   "peerDependencies": {

package/dist/cjs/thebe-provider.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-export type ThebeCore = typeof import('thebe-core');
-export declare function ThebeCoreProvider({ children }: React.PropsWithChildren): JSX.Element;
-export declare function useThebeCore(): {
-    core?: typeof import("thebe-core") | undefined;
-};
-//# sourceMappingURL=thebe-provider.d.ts.map

package/dist/cjs/thebe-provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"thebe-provider.d.ts","sourceRoot":"","sources":["../../src/thebe-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAGnD,MAAM,MAAM,SAAS,GAAG,cAAc,YAAY,CAAC,CAAC;AAKpD,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,iBAAiB,eAoBtE;AAED,wBAAgB,YAAY;;EAM3B"}

package/dist/cjs/thebe-provider.js

@@ -1,53 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useThebeCore = exports.ThebeCoreProvider = void 0;
-const jsx_runtime_1 = require("react/jsx-runtime");
-const react_1 = __importStar(require("react"));
-// Don't know how to get rid of the undefined here in the case of an async provider
-const ThebeCoreContext = react_1.default.createContext(undefined);
-function ThebeCoreProvider({ children }) {
-    const [core, setCore] = (0, react_1.useState)();
-    (0, react_1.useEffect)(() => {
-        console.debug('importing thebe-core...');
-        Promise.resolve().then(() => __importStar(require('thebe-core'))).then((thebeCore) => {
-            console.debug('thebe-core loaded');
-            setCore(thebeCore);
-        })
-            .catch(({ reason }) => {
-            console.error(`thebe-core load failed ${reason}`);
-        });
-    }, []);
-    return ((0, jsx_runtime_1.jsx)(ThebeCoreContext.Provider, Object.assign({ value: { core } }, { children: (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children }) })));
-}
-exports.ThebeCoreProvider = ThebeCoreProvider;
-function useThebeCore() {
-    const context = react_1.default.useContext(ThebeCoreContext);
-    if (context === undefined) {
-        throw new Error('useThebeCore must be used inside a ThebeCoreProvider');
-    }
-    return context;
-}
-exports.useThebeCore = useThebeCore;

package/dist/esm/thebe-provider.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-export type ThebeCore = typeof import('thebe-core');
-export declare function ThebeCoreProvider({ children }: React.PropsWithChildren): JSX.Element;
-export declare function useThebeCore(): {
-    core?: typeof import("thebe-core") | undefined;
-};
-//# sourceMappingURL=thebe-provider.d.ts.map

package/dist/esm/thebe-provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"thebe-provider.d.ts","sourceRoot":"","sources":["../../src/thebe-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAGnD,MAAM,MAAM,SAAS,GAAG,cAAc,YAAY,CAAC,CAAC;AAKpD,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,iBAAiB,eAoBtE;AAED,wBAAgB,YAAY;;EAM3B"}