numbl 0.4.15 → 0.4.16

package/dist-browser/browser/protocol.d.ts

@@ -23,6 +23,13 @@ export interface BootMessage {
      * page is cross-origin isolated (SharedArrayBuffer available).
      */
     cancelSAB?: SharedArrayBuffer;
+    /**
+     * Shared channel for synchronous `input()` (stdin). The worker blocks on it
+     * (Atomics.wait) after asking the host for a line via a `request-input`
+     * message; the host writes the reply back through it (see syncInputChannel).
+     * Only present when the page is cross-origin isolated.
+     */
+    inputSAB?: SharedArrayBuffer;
 }
 export type ToWorker = BootMessage | {
     type: "writeFile";
@@ -83,6 +90,9 @@ export type FromWorker = {
 } | {
     type: "bootError";
     message: string;
+} | {
+    type: "request-input";
+    prompt: string;
 } | {
     type: "htmlSourceEvent";
     compId: string;

package/dist-browser/browser/session.d.ts

@@ -27,6 +27,13 @@ export interface NumblSessionOptions {
     onOutput?: (text: string) => void;
     /** Boot progress (package downloads, engine start). */
     onProgress?: (message: string) => void;
+    /**
+     * Called when running code reaches `input()` and needs a line of input.
+     * The execution is blocked until the host calls `provideInput(text)` with
+     * the user's response. Requires cross-origin isolation (see `canInput`);
+     * without it, `input()` errors instead of calling this.
+     */
+    onInputRequest?: (prompt: string) => void;
     /** A uihtml component was created/updated (Data JSON-encoded + markup). */
     onUihtml?: (compId: string, dataJson: string, html: string) => void;
     /** Script -> host events (MATLAB `sendEventToHTMLSource`). */
@@ -71,6 +78,19 @@ export interface NumblSession {
      * run can only be stopped by disposing the session.
      */
     readonly canInterrupt: boolean;
+    /**
+     * Supply the line of input that a pending `onInputRequest` is waiting for.
+     * Unblocks the `input()` call in the running code, which resumes with this
+     * text. Call exactly once per `onInputRequest`. No-op when `canInput` is
+     * false or nothing is waiting.
+     */
+    provideInput(text: string): void;
+    /**
+     * Whether `input()` (stdin) works — true only when the page is cross-origin
+     * isolated. When false, `input()` in executed code throws instead of
+     * calling `onInputRequest`.
+     */
+    readonly canInput: boolean;
     /** Terminate the worker. The session is unusable afterwards. */
     dispose(): void;
 }