@myst-theme/jupyter 0.3.3 → 0.3.4

package/dist/cjs/execute/busy.js

@@ -0,0 +1,182 @@
+"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;
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectPageIsBusy = exports.selectNotebookIsBusy = exports.selectCellIsBusy = exports.useBusyScope = exports.BusyScopeProvider = exports.reducer = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+const BusyScopeContext = react_1.default.createContext(undefined);
+function isSlugPayload(payload) {
+    return (typeof payload.pageSlug === 'string' &&
+        typeof payload.notebookSlug === 'string' &&
+        typeof payload.kind === 'string');
+}
+function isCellPayload(payload) {
+    return (isSlugPayload(payload) &&
+        typeof payload.cellId === 'string' &&
+        typeof payload.kind === 'string');
+}
+function isNotebookPayload(payload) {
+    return (isSlugPayload(payload) &&
+        Array.isArray(payload.cellIds) &&
+        payload.cellIds.every((id) => typeof id === 'string') &&
+        typeof payload.kind === 'string');
+}
+function reducer(state, action) {
+    var _a, _b, _c, _d, _e;
+    switch (action.type) {
+        case 'SET_CELL_BUSY': {
+            if (!isCellPayload(action.payload)) {
+                console.error('SET_CELL_BUSY payload must be a cell payload', action.payload);
+                return state;
+            }
+            const { pageSlug, notebookSlug, cellId, kind } = action.payload;
+            if ((_b = (_a = state[kind][pageSlug]) === null || _a === void 0 ? void 0 : _a[notebookSlug]) === null || _b === void 0 ? void 0 : _b[cellId])
+                return state;
+            return Object.assign(Object.assign({}, state), { [kind]: Object.assign(Object.assign({}, state[kind]), { [pageSlug]: Object.assign(Object.assign({}, state[kind][pageSlug]), { [notebookSlug]: Object.assign(Object.assign({}, (_c = state[kind][pageSlug]) === null || _c === void 0 ? void 0 : _c[notebookSlug]), { [cellId]: true }) }) }) });
+        }
+        case 'CLEAR_CELL_BUSY': {
+            if (!isCellPayload(action.payload)) {
+                console.error('CLEAR_CELL_BUSY payload must be a cell payload', action.payload);
+                return state;
+            }
+            const { pageSlug, notebookSlug, cellId, kind } = action.payload;
+            const _f = state[kind], _g = pageSlug, renderBusy = _f[_g], otherRenders = __rest(_f, [typeof _g === "symbol" ? _g : _g + ""]);
+            if (!renderBusy)
+                return state;
+            const _h = renderBusy, _j = notebookSlug, notebookBusy = _h[_j], otherNotebooks = __rest(_h, [typeof _j === "symbol" ? _j : _j + ""]);
+            if (!notebookBusy)
+                return state;
+            if (!notebookBusy[cellId])
+                return state;
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const _k = notebookBusy, _l = cellId, cellBusy = _k[_l], otherCells = __rest(_k, [typeof _l === "symbol" ? _l : _l + ""]);
+            // remove the render if it's empty
+            if (Object.keys(otherCells).length === 0 && Object.keys(otherNotebooks).length === 0) {
+                return Object.assign(Object.assign({}, state), { [kind]: otherRenders });
+            }
+            // remove the notebook if it's empty
+            if (Object.keys(otherCells).length === 0) {
+                return Object.assign(Object.assign({}, state), { [kind]: Object.assign(Object.assign({}, state[kind]), { [pageSlug]: Object.assign({}, otherNotebooks) }) });
+            }
+            return Object.assign(Object.assign({}, state), { [kind]: Object.assign(Object.assign({}, state[kind]), { [action.payload.pageSlug]: Object.assign(Object.assign({}, otherNotebooks), { [notebookSlug]: Object.assign({}, otherCells) }) }) });
+        }
+        case 'SET_NOTEBOOK_BUSY': {
+            if (!isNotebookPayload(action.payload)) {
+                console.error('SET_NOTEBOOK_BUSY payload must be a notebook payload', action.payload);
+                return state;
+            }
+            const { pageSlug, notebookSlug, cellIds, kind } = action.payload;
+            return Object.assign(Object.assign({}, state), { [kind]: Object.assign(Object.assign({}, state[kind]), { [pageSlug]: Object.assign(Object.assign({}, state[kind][pageSlug]), { [notebookSlug]: Object.assign(Object.assign({}, (_d = state[kind][pageSlug]) === null || _d === void 0 ? void 0 : _d[notebookSlug]), cellIds.reduce((acc, cellId) => (Object.assign(Object.assign({}, acc), { [cellId]: true })), {})) }) }) });
+        }
+        case 'CLEAR_NOTEBOOK_BUSY': {
+            if (!isSlugPayload(action.payload)) {
+                console.error('CLEAR_NOTEBOOK_BUSY payload must be a notebook payload', action.payload);
+                return state;
+            }
+            const { pageSlug, notebookSlug, kind } = action.payload;
+            if (!state[kind][pageSlug])
+                return state;
+            if (!((_e = state[kind][pageSlug]) === null || _e === void 0 ? void 0 : _e[notebookSlug]))
+                return state;
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const _m = state[kind][pageSlug], _o = notebookSlug, notebookBusy = _m[_o], otherNotebooks = __rest(_m, [typeof _o === "symbol" ? _o : _o + ""]);
+            if (Object.keys(otherNotebooks).length === 0) {
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                const _p = state[kind], _q = pageSlug, renderBusy = _p[_q], otherRenders = __rest(_p, [typeof _q === "symbol" ? _q : _q + ""]);
+                return Object.assign(Object.assign({}, state), { [kind]: otherRenders });
+            }
+            return Object.assign(Object.assign({}, state), { [kind]: Object.assign(Object.assign({}, state[kind]), { [pageSlug]: Object.assign({}, otherNotebooks) }) });
+        }
+    }
+    return state;
+}
+exports.reducer = reducer;
+function BusyScopeProvider({ children }) {
+    const [state, dispatch] = (0, react_1.useReducer)(reducer, { execute: {}, reset: {} });
+    const memo = react_1.default.useMemo(() => ({ state, dispatch }), [state]);
+    if (typeof window !== 'undefined') {
+        window.busyScopeState = memo.state;
+    }
+    return (0, jsx_runtime_1.jsx)(BusyScopeContext.Provider, { value: memo, children: children });
+}
+exports.BusyScopeProvider = BusyScopeProvider;
+function useBusyScope() {
+    const context = react_1.default.useContext(BusyScopeContext);
+    if (context === undefined) {
+        throw new Error('useBusyScope must be used within a BusyScopeProvider');
+    }
+    const { dispatch, state } = context;
+    const cell = (0, react_1.useCallback)((pageSlug, notebookSlug, cellId, kind) => selectCellIsBusy(state, pageSlug, notebookSlug, cellId, kind), [state]);
+    const notebook = (0, react_1.useCallback)((pageSlug, notebookSlug, kind) => selectNotebookIsBusy(state, pageSlug, notebookSlug, kind), [state]);
+    const page = (0, react_1.useCallback)((pageSlug, kind) => selectPageIsBusy(state, pageSlug, kind), [state]);
+    const setCell = (0, react_1.useCallback)((pageSlug, notebookSlug, cellId, kind) => {
+        dispatch({ type: 'SET_CELL_BUSY', payload: { pageSlug, notebookSlug, cellId, kind } });
+    }, [dispatch]);
+    const clearCell = (0, react_1.useCallback)((pageSlug, notebookSlug, cellId, kind) => dispatch({ type: 'CLEAR_CELL_BUSY', payload: { pageSlug, notebookSlug, cellId, kind } }), [dispatch]);
+    const setNotebook = (0, react_1.useCallback)((pageSlug, notebookSlug, cellIds, kind) => dispatch({ type: 'SET_NOTEBOOK_BUSY', payload: { pageSlug, notebookSlug, cellIds, kind } }), [dispatch]);
+    const clearNotebook = (0, react_1.useCallback)((pageSlug, notebookSlug, kind) => dispatch({ type: 'CLEAR_NOTEBOOK_BUSY', payload: { pageSlug, notebookSlug, kind } }), [dispatch]);
+    return { cell, notebook, page, setCell, clearCell, setNotebook, clearNotebook };
+}
+exports.useBusyScope = useBusyScope;
+function selectCellIsBusy(state, pageSlug, notebookSlug, cellId, kind) {
+    var _a, _b;
+    return !!((_b = (_a = state[kind][pageSlug]) === null || _a === void 0 ? void 0 : _a[notebookSlug]) === null || _b === void 0 ? void 0 : _b[cellId]);
+}
+exports.selectCellIsBusy = selectCellIsBusy;
+/**
+ * a fast selector relying on the fact that if at least one cell is present, the notebook is busy
+ *
+ * @param state
+ * @param pageSlug
+ * @param notebookSlug
+ * @returns
+ */
+function selectNotebookIsBusy(state, pageSlug, notebookSlug, kind) {
+    var _a;
+    return !!((_a = state[kind][pageSlug]) === null || _a === void 0 ? void 0 : _a[notebookSlug]);
+}
+exports.selectNotebookIsBusy = selectNotebookIsBusy;
+/**
+ * a fast selector relying on the fact that if at least one notebook is present, the render is busy
+ *
+ * @param state
+ * @param pageSlug
+ * @returns
+ */
+function selectPageIsBusy(state, pageSlug, kind) {
+    return !!state[kind][pageSlug];
+}
+exports.selectPageIsBusy = selectPageIsBusy;

package/dist/cjs/execute/hooks.d.ts

@@ -0,0 +1,62 @@
+import React from 'react';
+import type { IdOrKey } from './types';
+import type { IThebeCell } from 'thebe-core';
+import { SourceFileKind } from 'myst-common';
+export declare function useExecutionScope({ clearOutputsOnExecute, }?: {
+    clearOutputsOnExecute?: boolean;
+}): {
+    ready: boolean;
+    start: (slug: string) => void;
+    clearAll: (pageSlug: string) => void;
+    resetAll: (pageSlug: string) => void;
+    execute: (slug: string) => void;
+    slug: string;
+    state: import("./types").ExecuteScopeState;
+    dispatch: React.Dispatch<import("./actions").ExecuteScopeAction>;
+    idkmap: import("./types").IdKeyMap;
+};
+/**
+ * useNotebookExecution a hook to govern notebook execution in the context of a single
+ * cell embedded in an article
+ *
+ */
+export declare function useNotebookExecution(id: IdOrKey, clearOutputsOnExecute?: boolean): {
+    ready: boolean;
+    start: () => void;
+    clear: () => void;
+    reset: () => void;
+    execute: () => void;
+    cellIsExecuting: boolean;
+    notebookIsExecuting: boolean;
+    notebookIsResetting: boolean;
+    notebookIsBusy: boolean;
+    executionCount: number | null | undefined;
+    slug: string;
+    state: import("./types").ExecuteScopeState;
+    dispatch: React.Dispatch<import("./actions").ExecuteScopeAction>;
+    idkmap: import("./types").IdKeyMap;
+};
+/**
+ * useCellExecution a hook to govern the execute status and actions for a single cell
+ *
+ * @param id
+ * @returns
+ */
+export declare function useCellExecution(id: IdOrKey): {
+    kind: SourceFileKind;
+    ready: boolean;
+    execute: () => void;
+    clear: () => void;
+    cellIsExecuting: boolean;
+    notebookIsExecuting: boolean;
+    notebookIsResetting: boolean;
+    notebookIsBusy: boolean;
+    cell: IThebeCell | undefined;
+};
+export declare function useIsAComputableCell(id: IdOrKey): {
+    slug: string;
+    computable: boolean;
+    ready: boolean;
+};
+export declare function useReadyToExecute(): boolean;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/cjs/execute/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/execute/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAA0C,MAAM,YAAY,CAAC;AAGrF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,EAChC,qBAA6B,GAC9B,GAAE;IAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO;;kBAUR,MAAM;yBAsD1B,MAAM;yBAYN,MAAM;oBAxDI,MAAM;;;;;EAgF9B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO,EAAE,qBAAqB,UAAQ;;;;;;;;;;;;;;;EA4G9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO;;;;;;;;;;EAiE3C;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO;;;;EAc/C;AAED,wBAAgB,iBAAiB,YAOhC"}

package/dist/cjs/execute/hooks.js

@@ -0,0 +1,308 @@
+"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;
+};
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useReadyToExecute = exports.useIsAComputableCell = exports.useCellExecution = exports.useNotebookExecution = exports.useExecutionScope = void 0;
+const react_1 = __importStar(require("react"));
+const provider_1 = require("./provider");
+const busy_1 = require("./busy");
+const thebe_react_1 = require("thebe-react");
+const myst_common_1 = require("myst-common");
+function useExecutionScope({ clearOutputsOnExecute = false, } = {}) {
+    var _a;
+    const context = react_1.default.useContext(provider_1.ExecuteScopeContext);
+    const { config } = (0, thebe_react_1.useThebeConfig)();
+    const busy = (0, busy_1.useBusyScope)();
+    if (context === undefined) {
+        throw new Error('useExecuteScope must be used within a ExecuteScopeProvider');
+    }
+    const { state, dispatch } = context;
+    const start = (0, react_1.useCallback)((slug) => {
+        console.debug(`Jupyter: Starting ${slug}`);
+        dispatch({
+            type: 'REQUEST_BUILD',
+            payload: {
+                slug,
+            },
+        });
+    }, []);
+    const execute = (slug) => {
+        // set busy
+        Object.entries(state.pages[slug].scopes).forEach(([notebookSlug, { notebook }]) => {
+            busy.setNotebook(slug, notebookSlug, notebook.cells.map((c) => c.id), 'execute');
+        });
+        if (clearOutputsOnExecute) {
+            // clear all notebook cell outputs
+            Object.values(state.pages[slug].scopes).forEach(({ notebook }) => {
+                notebook.clear();
+            });
+        }
+        // let busy state update prior to launching execute
+        setTimeout(() => __awaiter(this, void 0, void 0, function* () {
+            const handler = (_, data) => {
+                var _a, _b;
+                if (data.subject === 'cell' && data.status === 'idle') {
+                    const notebookSlug = (_a = data.object.notebookId) !== null && _a !== void 0 ? _a : 'unknown';
+                    busy.clearCell(slug, notebookSlug, (_b = data.id) !== null && _b !== void 0 ? _b : 'unknown', 'execute');
+                }
+            };
+            config === null || config === void 0 ? void 0 : config.events.on('status', handler);
+            // execute all cells on all notebooks
+            yield Promise.all(Object.entries(state.pages[slug].scopes).map(([, { notebook }]) => __awaiter(this, void 0, void 0, function* () {
+                const execReturns = yield notebook.executeAll(true);
+                const errs = (0, thebe_react_1.findErrors)(execReturns);
+                if (errs != null)
+                    console.error('errors', errs);
+            })));
+            config === null || config === void 0 ? void 0 : config.events.off('status', handler);
+        }), 100);
+    };
+    /**
+     * clearAll clears all cells in all notebooks for a given rendering
+     *
+     */
+    const clearAll = (0, react_1.useCallback)((pageSlug) => {
+        Object.entries(state.pages[pageSlug].scopes).forEach(([, { notebook }]) => {
+            notebook.clear();
+        });
+    }, [state]);
+    /**
+     * resetAll resets all cells in all notebooks for a given rendering
+     */
+    const resetAll = (0, react_1.useCallback)((pageSlug) => {
+        Object.entries(state.pages[pageSlug].scopes).forEach(([notebookSlug, { notebook, session }]) => {
+            busy.setNotebook(pageSlug, notebookSlug, notebook.cells.map((c) => c.id), 'reset');
+            setTimeout(() => {
+                var _a;
+                notebook.reset();
+                (_a = session === null || session === void 0 ? void 0 : session.kernel) === null || _a === void 0 ? void 0 : _a.restart().finally(() => {
+                    busy.clearNotebook(pageSlug, notebookSlug, 'reset');
+                });
+            }, 300);
+        });
+    }, [state]);
+    const ready = (_a = context.state.pages[context.slug]) === null || _a === void 0 ? void 0 : _a.ready;
+    return Object.assign(Object.assign({}, context), { ready, start, clearAll, resetAll, execute });
+}
+exports.useExecutionScope = useExecutionScope;
+/**
+ * useNotebookExecution a hook to govern notebook execution in the context of a single
+ * cell embedded in an article
+ *
+ */
+function useNotebookExecution(id, clearOutputsOnExecute = false) {
+    var _a, _b;
+    const context = react_1.default.useContext(provider_1.ExecuteScopeContext);
+    const { config } = (0, thebe_react_1.useThebeConfig)();
+    const busy = (0, busy_1.useBusyScope)();
+    if (context === undefined) {
+        throw new Error('useExecuteScope must be used within a ExecuteScopeProvider');
+    }
+    const { state, dispatch, idkmap } = context;
+    const target = (_a = idkmap[id]) !== null && _a !== void 0 ? _a : {};
+    const { pageSlug, notebookSlug, cellId } = target;
+    // TODO consider extending this to start only the notebook requested, currently this will
+    // execute all connected notebooks
+    const start = (0, react_1.useCallback)(() => {
+        dispatch({
+            type: 'REQUEST_BUILD',
+            payload: {
+                slug: context.slug,
+            },
+        });
+    }, [target]);
+    let cell;
+    let notebook;
+    if (target && state.pages[pageSlug]) {
+        notebook = state.pages[pageSlug].scopes[notebookSlug].notebook;
+        if (!notebook)
+            console.error('no notebook for', { pageSlug, notebookSlug, cellId });
+        cell = notebook === null || notebook === void 0 ? void 0 : notebook.getCellById(cellId);
+        if (!cell)
+            console.error('no cell found', { pageSlug, notebookSlug, cellId });
+    }
+    const execute = () => {
+        var _a, _b;
+        const nb = (_b = (_a = state.pages[pageSlug]) === null || _a === void 0 ? void 0 : _a.scopes[notebookSlug]) === null || _b === void 0 ? void 0 : _b.notebook;
+        // set busy
+        busy.setNotebook(pageSlug, notebookSlug, nb.cells.map((c) => c.id), 'execute');
+        if (clearOutputsOnExecute)
+            nb.clear();
+        // let busy state update prior to launching execute
+        setTimeout(() => __awaiter(this, void 0, void 0, function* () {
+            const handler = (_, data) => {
+                var _a;
+                if (data.subject === 'cell' && data.status === 'idle') {
+                    busy.clearCell(pageSlug, notebookSlug, (_a = data.id) !== null && _a !== void 0 ? _a : 'unknown', 'execute');
+                }
+            };
+            config === null || config === void 0 ? void 0 : config.events.on('status', handler);
+            // execute all cells on the notebooks
+            const execReturns = yield nb.executeAll(true);
+            const errs = (0, thebe_react_1.findErrors)(execReturns);
+            if (errs != null)
+                console.error('errors', errs); // TODO: handle errors
+            config === null || config === void 0 ? void 0 : config.events.off('status', handler);
+        }), 100);
+    };
+    /**
+     * clearAll clears all cells in all notebooks for a given rendering
+     *
+     */
+    const clear = (0, react_1.useCallback)(() => {
+        var _a, _b;
+        const nb = (_b = (_a = state.pages[pageSlug]) === null || _a === void 0 ? void 0 : _a.scopes[notebookSlug]) === null || _b === void 0 ? void 0 : _b.notebook;
+        nb.clear();
+    }, [state]);
+    /**
+     * resetAll resets all cells in all notebooks for a given rendering
+     */
+    const reset = (0, react_1.useCallback)(() => {
+        var _a, _b;
+        const { notebook: nb, session } = (_b = (_a = state.pages[pageSlug]) === null || _a === void 0 ? void 0 : _a.scopes[notebookSlug]) !== null && _b !== void 0 ? _b : {};
+        busy.setNotebook(pageSlug, notebookSlug, nb.cells.map((c) => c.id), 'reset');
+        setTimeout(() => {
+            var _a;
+            nb.reset();
+            (_a = session === null || session === void 0 ? void 0 : session.kernel) === null || _a === void 0 ? void 0 : _a.restart().finally(() => {
+                busy.clearNotebook(pageSlug, notebookSlug, 'reset');
+            });
+        }, 300);
+    }, [state]);
+    const ready = (_b = context.state.pages[context.slug]) === null || _b === void 0 ? void 0 : _b.ready;
+    const notebookIsExecuting = busy.notebook(pageSlug, notebookSlug, 'execute');
+    const notebookIsResetting = busy.notebook(pageSlug, notebookSlug, 'reset');
+    const notebookIsBusy = notebookIsExecuting || notebookIsResetting;
+    return Object.assign(Object.assign({}, context), { ready,
+        start,
+        clear,
+        reset,
+        execute, cellIsExecuting: cell ? busy.cell(pageSlug, notebookSlug, cell === null || cell === void 0 ? void 0 : cell.id, 'execute') : false, notebookIsExecuting,
+        notebookIsResetting,
+        notebookIsBusy, executionCount: cell === null || cell === void 0 ? void 0 : cell.executionCount });
+}
+exports.useNotebookExecution = useNotebookExecution;
+/**
+ * useCellExecution a hook to govern the execute status and actions for a single cell
+ *
+ * @param id
+ * @returns
+ */
+function useCellExecution(id) {
+    var _a, _b, _c, _d;
+    const busy = (0, busy_1.useBusyScope)();
+    const context = react_1.default.useContext(provider_1.ExecuteScopeContext);
+    if (context === undefined) {
+        throw new Error('useExecuteScope must be used within a ExecuteScopeProvider');
+    }
+    const { state, idkmap } = context;
+    const target = (_a = idkmap[id]) !== null && _a !== void 0 ? _a : {};
+    const { pageSlug, notebookSlug, cellId } = target;
+    let cell;
+    let notebook;
+    if (target && state.pages[pageSlug]) {
+        notebook = state.pages[pageSlug].scopes[notebookSlug].notebook;
+        if (!notebook)
+            console.error('no notebook for', { pageSlug, notebookSlug, cellId });
+        cell = notebook === null || notebook === void 0 ? void 0 : notebook.getCellById(cellId);
+        if (!cell)
+            console.error('no cell found', { pageSlug, notebookSlug, cellId });
+    }
+    const ready = (_b = context.state.pages[context.slug]) === null || _b === void 0 ? void 0 : _b.ready;
+    const kind = (_d = (_c = context.state.pages[context.slug]) === null || _c === void 0 ? void 0 : _c.kind) !== null && _d !== void 0 ? _d : myst_common_1.SourceFileKind.Article;
+    const execute = (0, react_1.useCallback)(() => {
+        if (!cell) {
+            console.error('no cell found on execute', { pageSlug, notebookSlug, cellId });
+            return;
+        }
+        // set busy
+        busy.setCell(pageSlug, notebookSlug, cell.id, 'execute');
+        cell.clear();
+        // let busy state update prior to launching execute
+        setTimeout(() => {
+            if (!cell)
+                throw new Error('no cell found on execute');
+            cell.execute().then(() => {
+                if (!cell)
+                    throw new Error('no cell found after execute');
+                busy.clearCell(pageSlug, notebookSlug, cell === null || cell === void 0 ? void 0 : cell.id, 'execute');
+            });
+        }, 100);
+    }, [state, cell]);
+    const clear = (0, react_1.useCallback)(() => {
+        if (!cell) {
+            console.error('no cell found on clear', { pageSlug, notebookSlug, cellId });
+            return;
+        }
+        cell.clear();
+    }, [state, cell]);
+    const notebookIsExecuting = busy.notebook(pageSlug, notebookSlug, 'execute');
+    const notebookIsResetting = busy.notebook(pageSlug, notebookSlug, 'reset');
+    const notebookIsBusy = notebookIsExecuting || notebookIsResetting;
+    return {
+        kind,
+        ready,
+        execute,
+        clear,
+        cellIsExecuting: cell ? busy.cell(pageSlug, notebookSlug, cell === null || cell === void 0 ? void 0 : cell.id, 'execute') : false,
+        notebookIsExecuting,
+        notebookIsResetting,
+        notebookIsBusy,
+        cell,
+    };
+}
+exports.useCellExecution = useCellExecution;
+function useIsAComputableCell(id) {
+    var _a, _b, _c;
+    const context = react_1.default.useContext(provider_1.ExecuteScopeContext);
+    if (context === undefined) {
+        throw new Error('useExecuteScope must be used within a ExecuteScopeProvider');
+    }
+    const { idkmap } = context;
+    const target = (_a = idkmap[id]) !== null && _a !== void 0 ? _a : {};
+    return {
+        slug: context.slug,
+        computable: !!target,
+        ready: (_c = (_b = context.state.pages[context.slug]) === null || _b === void 0 ? void 0 : _b.ready) !== null && _c !== void 0 ? _c : false,
+    };
+}
+exports.useIsAComputableCell = useIsAComputableCell;
+function useReadyToExecute() {
+    var _a, _b;
+    const context = react_1.default.useContext(provider_1.ExecuteScopeContext);
+    if (context === undefined) {
+        throw new Error('useExecuteScope must be used within a ExecuteScopeProvider');
+    }
+    return (_b = (_a = context.state.pages[context.slug]) === null || _a === void 0 ? void 0 : _a.ready) !== null && _b !== void 0 ? _b : false;
+}
+exports.useReadyToExecute = useReadyToExecute;

package/dist/cjs/execute/index.d.ts

@@ -0,0 +1,7 @@
+export * from './hooks';
+export * from './actions';
+export * from './provider';
+export * from './selectors';
+export * from './types';
+export * from './busy';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/execute/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execute/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}

package/dist/cjs/execute/index.js

@@ -0,0 +1,22 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./hooks"), exports);
+__exportStar(require("./actions"), exports);
+__exportStar(require("./provider"), exports);
+__exportStar(require("./selectors"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./busy"), exports);

package/dist/cjs/execute/leaf.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="react" />
+import type { ExecuteScopeAction } from './actions';
+import type { IdKeyMap, ExecuteScopeState } from './types';
+export declare function MdastFetcher({ slug, url, dispatch, }: {
+    slug: string;
+    url: string;
+    dispatch: React.Dispatch<ExecuteScopeAction>;
+}): import("react/jsx-runtime").JSX.Element | null;
+export declare function NotebookBuilder({ pageSlug, notebookSlug, idkmap, state, dispatch, }: {
+    pageSlug: string;
+    notebookSlug: string;
+    idkmap: IdKeyMap;
+    state: ExecuteScopeState;
+    dispatch: React.Dispatch<ExecuteScopeAction>;
+}): null;
+export declare function SessionStarter({ pageSlug, notebookSlug, state, dispatch, }: {
+    pageSlug: string;
+    notebookSlug: string;
+    state: ExecuteScopeState;
+    dispatch: React.Dispatch<ExecuteScopeAction>;
+}): null;
+export declare function ServerMonitor({ state, dispatch, }: {
+    state: ExecuteScopeState;
+    dispatch: React.Dispatch<ExecuteScopeAction>;
+}): null;
+//# sourceMappingURL=leaf.d.ts.map

package/dist/cjs/execute/leaf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaf.d.ts","sourceRoot":"","sources":["../../../src/execute/leaf.tsx"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAO3D,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,GAAG,EACH,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;CAC9C,kDAkBA;AAED,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,KAAK,EACL,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;CAC9C,QA8CA;AAED,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;CAC9C,QAoEA;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;CAC9C,QA4BA"}