@jupyterlab/notebook 4.1.0-alpha.2 → 4.1.0-alpha.4

package/lib/actions.d.ts

@@ -56,6 +56,13 @@ export declare class NotebookActions {
         notebook: Notebook;
         lastCell: Cell;
     }>;
+    /**
+     * A signal that emits when a cell's output is cleared.
+     */
+    static get outputCleared(): ISignal<any, {
+        notebook: Notebook;
+        cell: Cell;
+    }>;
     /**
      * A private constructor for the `NotebookActions` class.
      *
@@ -184,6 +191,22 @@ export declare namespace NotebookActions {
      * All markdown cells will be rendered.
      */
     function run(notebook: Notebook, sessionContext?: ISessionContext, sessionDialogs?: ISessionContextDialogs, translator?: ITranslator): Promise<boolean>;
+    /**
+     * Run specified cells.
+     *
+     * @param notebook - The target notebook widget.
+     * @param cells - The cells to run.
+     * @param sessionContext - The client session object.
+     * @param sessionDialogs - The session dialogs.
+     * @param translator - The application translator.
+     *
+     * #### Notes
+     * The existing selection will be preserved.
+     * The mode will be changed to command.
+     * An execution error will prevent the remaining code cells from executing.
+     * All markdown cells will be rendered.
+     */
+    function runCells(notebook: Notebook, cells: readonly Cell[], sessionContext?: ISessionContext, sessionDialogs?: ISessionContextDialogs, translator?: ITranslator): Promise<boolean>;
     /**
      * Run the selected cell(s) and advance to the next cell.
      *
@@ -625,4 +648,30 @@ export declare namespace NotebookActions {
      * No dialog will be presented if the notebook is already trusted.
      */
     function trust(notebook: Notebook, translator?: ITranslator): Promise<void>;
+    /**
+     * If the notebook has an active cell, focus it.
+     *
+     * @param notebook The target notebook widget
+     * @param options Optional options to change the behavior of this function
+     * @param options.waitUntilReady If true, do not call focus until activeCell.ready is resolved
+     * @param options.preventScroll If true, do not scroll the active cell into view
+     *
+     * @returns a promise that resolves when focus has been called on the active
+     * cell's node.
+     *
+     * #### Notes
+     * By default, waits until after the active cell has been attached unless
+     * called with { waitUntilReady: false }
+     */
+    function focusActiveCell(notebook: Notebook, options?: {
+        waitUntilReady?: boolean;
+        preventScroll?: boolean;
+    }): Promise<void>;
+    function accessPreviousHistory(notebook: Notebook): Promise<void>;
+    /**
+     * Access next notebook history.
+     *
+     * @param notebook - The target notebook widget.
+     */
+    function accessNextHistory(notebook: Notebook): Promise<void>;
 }