progress towards moving Shell to be a function component

Author: lerouxb

packages/browser-repl/README.md

@@ -31,14 +31,20 @@ const runtime = new IframeRuntime(serviceProvider);
 Shell is a React component with the following properties:
 
 - `runtime: Runtime`: The runtime used to evaluate code.
-- `onOutputChanged?: (output: readonly ShellOutputEntry[]) => void`: A function called each time the output changes with an array of `ShellOutputEntryes`.
-- `onHistoryChanged?: (history: readonly string[]) => void`: A function called each time the history changes with an array of history entries ordered from the most recent to the oldest entry.
+- `onOutputChanged?: (output: ShellOutputEntry[]) => void`: A function called each time the output changes with an array of `ShellOutputEntryes`.
+- `onHistoryChanged?: (history: string[]) => void`: A function called each time the history changes with an array of history entries ordered from the most recent to the oldest entry.
+- `onEditorChanged?: (editor: EditorRef | null) => void`: A function called each time the editor ref changes. Can be used to call editor methods.
+- `onOperationStarted: () => void`: A function called when an operation has begun.
+- `onOperationEnd: () => void`: A function called when an operation has completed (both error and success).
 - `redactInfo?: boolean`: If set, the shell will omit or redact entries containing sensitive info from history. Defaults to `false`.
 - `maxOutputLength?: number`: The maxiumum number of lines to keep in the output. Defaults to `1000`.
 - `maxHistoryLength?: number`: The maxiumum number of lines to keep in the history. Defaults to `1000`.
-- `initialOutput?: readonly ShellOutputEntry[]`: An array of entries to be displayed in the output area. Can be used to restore the output between sessions, or to setup a greeting message. **Note**: new entries will not be appended to the array.
-- `initialHistory?: readonly string[]`: An array of history entries to prepopulate the history.
+- `initialEvaluate?: string|string[]`: A set of input strings to evaluate right after shell is mounted.
+- `inputText?: string`: Initial text for the input field.
+- `output?: ShellOutputEntry[]`: An array of entries to be displayed in the output area. Can be used to restore the output between sessions, or to setup a greeting message. **Note**: new entries will not be appended to the array.
+- `history?: readonly string[]`: An array of history entries to prepopulate the history.
   Can be used to restore the history between sessions. Entries must be ordered from the most recent to the oldest. Note: new entries will not be appended to the array.
+- `isOperationInProgress?: boolean`: Can be used to restore the value between sessions.
 
 ### `ShellOutputEntry`
 

packages/browser-repl/scripts/sync-to-compass.js

@@ -25,7 +25,23 @@ console.log({ packageDir, srcDir, libDir, destDir });
 
 const compileAndCopy = debounce(
   function () {
-    child_process.execFileSync('npm', ['run', 'compile'], { cwd: packageDir });
+    try {
+      child_process.execFileSync('npm', ['run', 'compile'], {
+        cwd: packageDir,
+      });
+    } catch (err) {
+      if (err.code) {
+        // Spawning child process failed
+        console.error(err.code);
+      } else {
+        // Child was spawned but exited with non-zero exit code
+        // Error contains any stdout and stderr from the child
+        const { stdout, stderr } = err;
+
+        console.log(stdout.toString());
+        console.error(stderr.toString());
+      }
+    }
     fs.cpSync(libDir, destDir, { recursive: true });
     console.log('done.');
   },