@myst-theme/jupyter 0.5.7 → 0.5.9

package/dist/cjs/execute/busy.js

@@ -1,259 +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;
-};
-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.useBusyErrors = 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 isErrorPayload(payload) {
-    var _a, _b;
-    return ((typeof payload.pageSlug === 'string' &&
-        typeof payload.notebookSlug === 'string' &&
-        payload.errors === undefined) ||
-        ((_b = (Array.isArray(payload.errors) &&
-            ((_a = payload.errors) === null || _a === void 0 ? void 0 : _a.every((error) => typeof error === 'object')))) !== null && _b !== void 0 ? _b : false));
-}
-function reducer(state, action) {
-    var _a, _b, _c, _d, _e, _f, _g;
-    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 _h = state[kind], _j = pageSlug, renderBusy = _h[_j], otherRenders = __rest(_h, [typeof _j === "symbol" ? _j : _j + ""]);
-            if (!renderBusy)
-                return state;
-            const _k = renderBusy, _l = notebookSlug, notebookBusy = _k[_l], otherNotebooks = __rest(_k, [typeof _l === "symbol" ? _l : _l + ""]);
-            if (!notebookBusy)
-                return state;
-            if (!notebookBusy[cellId])
-                return state;
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            const _m = notebookBusy, _o = cellId, cellBusy = _m[_o], otherCells = __rest(_m, [typeof _o === "symbol" ? _o : _o + ""]);
-            // 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 _p = state[kind][pageSlug], _q = notebookSlug, notebookBusy = _p[_q], otherNotebooks = __rest(_p, [typeof _q === "symbol" ? _q : _q + ""]);
-            if (Object.keys(otherNotebooks).length === 0) {
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-                const _r = state[kind], _s = pageSlug, renderBusy = _r[_s], otherRenders = __rest(_r, [typeof _s === "symbol" ? _s : _s + ""]);
-                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) }) });
-        }
-        case 'SET_ERROR': {
-            if (!isErrorPayload(action.payload)) {
-                console.error('SET_ERROR payload must be an error payload', action.payload);
-                return state;
-            }
-            const { pageSlug, notebookSlug, errors } = action.payload;
-            if (!errors) {
-                console.error('SET_ERROR payload must have errors', action.payload);
-                return state;
-            }
-            if (state.error[pageSlug])
-                return state;
-            if ((_f = state.error[pageSlug]) === null || _f === void 0 ? void 0 : _f[notebookSlug])
-                return state;
-            return Object.assign(Object.assign({}, state), { error: Object.assign(Object.assign({}, state.error), { [pageSlug]: Object.assign(Object.assign({}, state.error[pageSlug]), { [notebookSlug]: errors }) }) });
-        }
-        case 'CLEAR_ERROR': {
-            if (!isErrorPayload(action.payload)) {
-                console.error('CLEAR_ERROR payload must be a error payload', action.payload);
-                return state;
-            }
-            const { pageSlug, notebookSlug } = action.payload;
-            if (!state.error[pageSlug])
-                return state;
-            if (!((_g = state.error[pageSlug]) === null || _g === void 0 ? void 0 : _g[notebookSlug]))
-                return state;
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            const _t = state.error[pageSlug], _u = notebookSlug, notebookErrors = _t[_u], otherNotebooks = __rest(_t, [typeof _u === "symbol" ? _u : _u + ""]);
-            if (Object.keys(otherNotebooks).length > 0) {
-                return Object.assign(Object.assign({}, state), { error: Object.assign(Object.assign({}, state.error), { [pageSlug]: Object.assign({}, otherNotebooks) }) });
-            }
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            const _v = state.error, _w = pageSlug, renderErrors = _v[_w], otherRenders = __rest(_v, [typeof _w === "symbol" ? _w : _w + ""]);
-            return Object.assign(Object.assign({}, state), { error: otherRenders });
-        }
-    }
-    return state;
-}
-exports.reducer = reducer;
-function BusyScopeProvider({ children }) {
-    const [state, dispatch] = (0, react_1.useReducer)(reducer, { execute: {}, reset: {}, error: {} });
-    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]);
-    const setError = (0, react_1.useCallback)((pageSlug, notebookSlug, errors) => dispatch({ type: 'SET_ERROR', payload: { pageSlug, notebookSlug, errors } }), [dispatch]);
-    const clearError = (0, react_1.useCallback)((pageSlug, notebookSlug) => dispatch({ type: 'CLEAR_ERROR', payload: { pageSlug, notebookSlug } }), [dispatch]);
-    return {
-        cell,
-        notebook,
-        page,
-        setCell,
-        clearCell,
-        setNotebook,
-        clearNotebook,
-        setError,
-        clearError,
-    };
-}
-exports.useBusyScope = useBusyScope;
-function useBusyErrors(pageSlug) {
-    const context = react_1.default.useContext(BusyScopeContext);
-    if (context === undefined) {
-        throw new Error('useBusyScope must be used within a BusyScopeProvider');
-    }
-    const { state, dispatch } = context;
-    const clearErrors = () => {
-        Object.keys(state.error[pageSlug]).forEach((notebookSlug) => {
-            dispatch({ type: 'CLEAR_ERROR', payload: { pageSlug, notebookSlug } });
-        });
-    };
-    let items;
-    if (Object.keys(state.error).length > 0 && state.error[pageSlug]) {
-        items = Object.entries(state.error[pageSlug]).map(([notebookSlug, errors]) => ({
-            pageSlug,
-            notebookSlug,
-            errors,
-        }));
-    }
-    return { items, clearErrors };
-}
-exports.useBusyErrors = useBusyErrors;
-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.map

@@ -1 +0,0 @@
-{"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,EAA8C,MAAM,YAAY,CAAC;AAGzF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,wBAAgB,iBAAiB,CAAC,EAChC,qBAA6B,GAC9B,GAAE;IAAE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO;;kBAUR,MAAM;yBAuD1B,MAAM;yBAYN,MAAM;oBAzDI,MAAM;;;;;;EAkF9B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO,EAAE,qBAAqB,UAAQ;;;;;;;;;;;;;;;;EAgH9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,EAAE,qBAAqB,UAAQ;;;;;;;;;;;EAgE1E;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO;;;;EAc/C;AAED,wBAAgB,iBAAiB,YAOhC"}

package/dist/cjs/execute/hooks.js

@@ -1,311 +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;
-};
-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_spec_ext_1 = require("myst-spec-ext");
-const selectors_1 = require("./selectors");
-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.clearError(slug, notebookSlug);
-            busy.setNotebook(slug, notebookSlug, notebook.code.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) => {
-        var _a;
-        Object.entries((_a = state.pages[pageSlug]) === null || _a === void 0 ? void 0 : _a.scopes).forEach(([, { notebook }]) => {
-            notebook.clear();
-        });
-    }, [state]);
-    /**
-     * resetAll resets all cells in all notebooks for a given rendering
-     */
-    const resetAll = (0, react_1.useCallback)((pageSlug) => {
-        var _a;
-        Object.entries((_a = state.pages[pageSlug]) === null || _a === void 0 ? void 0 : _a.scopes).forEach(([notebookSlug, { notebook, session }]) => {
-            busy.clearError(pageSlug, notebookSlug);
-            busy.setNotebook(pageSlug, notebookSlug, notebook.code.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('useNotebookExecution 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 = (0, selectors_1.selectNotebookForPage)(state, pageSlug, notebookSlug);
-        if (notebook)
-            cell = notebook === null || notebook === void 0 ? void 0 : notebook.getCellById(cellId);
-    }
-    const execute = () => {
-        const nb = (0, selectors_1.selectNotebookForPage)(state, pageSlug, notebookSlug);
-        busy.clearError(pageSlug, notebookSlug);
-        // set busy
-        busy.setNotebook(pageSlug, notebookSlug, nb.code.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('an error occurred during notebook execution');
-                busy.setError(pageSlug, notebookSlug, errs);
-                busy.clearNotebook(pageSlug, notebookSlug, 'execute');
-            }
-            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)(() => {
-        const nb = (0, selectors_1.selectNotebookForPage)(state, pageSlug, notebookSlug);
-        nb.clear();
-    }, [state]);
-    /**
-     * resetAll resets all cells in all notebooks for a given rendering
-     */
-    const reset = (0, react_1.useCallback)(() => {
-        const nb = (0, selectors_1.selectNotebookForPage)(state, pageSlug, notebookSlug);
-        busy.clearError(pageSlug, notebookSlug);
-        busy.setNotebook(pageSlug, notebookSlug, nb.code.map((c) => c.id), 'reset');
-        setTimeout(() => {
-            var _a, _b;
-            nb.reset();
-            (_b = (_a = nb.session) === null || _a === void 0 ? void 0 : _a.kernel) === null || _b === void 0 ? void 0 : _b.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, clearOutputsOnExecute = false) {
-    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('useCellExecution 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 = (0, selectors_1.selectNotebookForPage)(state, pageSlug, notebookSlug);
-        if (notebook)
-            cell = notebook === null || notebook === void 0 ? void 0 : notebook.getCellById(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_spec_ext_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');
-        if (clearOutputsOnExecute)
-            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 {
-        canCompute: context.canCompute,
-        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

@@ -1,7 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,22 +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 __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

@@ -1,27 +0,0 @@
-/// <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, location, state, dispatch, }: {
-    pageSlug: string;
-    notebookSlug: string;
-    location: string | undefined;
-    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

@@ -1 +0,0 @@
-{"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;AAW3D,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,QAAQ,EACR,KAAK,EACL,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;CAC9C,QA2EA;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"}