@swifttui/web 0.1.12 → 0.1.14

package/dist/src/wasi/WasmSceneRuntime.js

@@ -1,5 +1,6 @@
 import { mainThreadStackProfileEnvironmentDefaults, resolveWasmEngineCapabilities } from "./WasmEngineCapabilities.js";
 import { WebHostSceneRuntime } from "../WebHostSceneRuntime.js";
+import { createWasmPauseCell, setWasmPauseCellPaused } from "./WasmRuntimePause.js";
 import { MainThreadWasmExecutor } from "./MainThreadWasmExecutor.js";
 import { SharedInputQueueWriter, createSharedInputQueue } from "./SharedInputQueue.js";
 //#region src/wasi/WasmSceneRuntime.ts
@@ -27,18 +28,22 @@ var WasmSceneRuntime = class extends WebHostSceneRuntime {
 	inputWriter;
 	inputRouter;
 	sharedQueueError;
+	pauseCell;
 	detachBridgeInputListener;
 	detachResizeListener;
 	worker;
 	executor;
 	didMount = false;
+	suspended = false;
 	constructor(options, wasmURL, factoryOptions) {
 		let inputQueue;
 		let inputWriter;
 		let sharedQueueError;
+		let pauseCell;
 		try {
 			inputQueue = createSharedInputQueue();
 			inputWriter = new SharedInputQueueWriter(inputQueue);
+			pauseCell = createWasmPauseCell();
 		} catch (error) {
 			sharedQueueError = error;
 		}
@@ -62,6 +67,12 @@ var WasmSceneRuntime = class extends WebHostSceneRuntime {
 		this.inputWriter = inputWriter;
 		this.inputRouter = inputRouter;
 		this.sharedQueueError = sharedQueueError;
+		this.pauseCell = pauseCell;
+	}
+	onRuntimeSuspensionChange(suspended) {
+		this.suspended = suspended;
+		if (this.pauseCell) setWasmPauseCellPaused(this.pauseCell, suspended);
+		this.executor?.setSuspended(suspended);
 	}
 	async mount() {
 		await super.mount();
@@ -111,7 +122,8 @@ var WasmSceneRuntime = class extends WebHostSceneRuntime {
 			type: "start",
 			wasmURL: this.wasmURL.href,
 			environment,
-			inputQueue: this.inputQueue
+			inputQueue: this.inputQueue,
+			pauseCell: this.pauseCell
 		};
 		this.worker.postMessage(message);
 	}
@@ -143,6 +155,7 @@ var WasmSceneRuntime = class extends WebHostSceneRuntime {
 		});
 		this.executor = executor;
 		this.inputRouter.route = (chunk) => executor.sendInput(chunk);
+		executor.setSuspended(this.suspended);
 		executor.start();
 	}
 	handleWorkerMessage(message) {

package/dist/src/wasi/WasmSceneRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"WasmSceneRuntime.js","names":[],"sources":["../../../src/wasi/WasmSceneRuntime.ts"],"sourcesContent":["import {\n  WebHostSceneRuntime,\n  type WebHostSceneRuntimeOptions,\n} from \"../WebHostSceneRuntime.ts\";\nimport {\n  encodeResizeControlMessage,\n  type BrowserWASIBridge,\n} from \"./BrowserWASIBridge.ts\";\n\nimport { MainThreadWasmExecutor } from \"./MainThreadWasmExecutor.ts\";\nimport {\n  SharedInputQueueWriter,\n  createSharedInputQueue,\n  type SharedInputQueueBuffers,\n} from \"./SharedInputQueue.ts\";\nimport {\n  mainThreadStackProfileEnvironmentDefaults,\n  resolveWasmEngineCapabilities,\n  type WasmEngineCapabilities,\n} from \"./WasmEngineCapabilities.ts\";\n\nconst workerModuleURL = new URL(\"./wasm-scene-worker.js\", import.meta.url);\n\ninterface WorkerStartMessage {\n  type: \"start\";\n  wasmURL: string;\n  environment: Record<string, string>;\n  inputQueue: SharedInputQueueBuffers;\n}\n\ninterface WorkerOutputMessage {\n  type: \"stdout\" | \"stderr\";\n  chunk: Uint8Array;\n}\n\ninterface WorkerExitMessage {\n  type: \"exit\";\n  code: number;\n}\n\ninterface WorkerErrorMessage {\n  type: \"error\";\n  message: string;\n}\n\ntype WorkerMessage = WorkerOutputMessage | WorkerExitMessage | WorkerErrorMessage;\n\nexport interface WasmSceneResizeEvent {\n  sceneId: string;\n  columns: number;\n  rows: number;\n  cellWidth?: number;\n  cellHeight?: number;\n}\n\nexport interface WasmSceneRuntimeHandle {\n  readonly descriptor: WebHostSceneRuntime[\"descriptor\"];\n  sendInput(chunk: Uint8Array): void;\n}\n\nexport type WasmExecutionMode = \"worker\" | \"main-thread\";\nexport type WasmExecutionModePreference = WasmExecutionMode | \"auto\";\n\nexport interface WasmSceneRuntimeFactoryOptions {\n  onSceneResize?(event: WasmSceneResizeEvent): void;\n  onRuntimeCreated?(runtime: WasmSceneRuntimeHandle): void;\n  workerModuleURL?: string | URL;\n  /**\n   * How to execute the wasm app. \"worker\" is the classic path\n   * (`Atomics.wait` stdin, needs SharedArrayBuffer/COOP/COEP). \"main-thread\"\n   * runs on the page's thread via WebAssembly JSPI — larger stack budget (no\n   * stack-lean profile on measured engines), no COOP/COEP requirement, at\n   * the cost of sharing the main thread. \"auto\" (default) picks main-thread\n   * only where workers cannot run (SharedArrayBuffer unavailable and JSPI\n   * present); workers everywhere else.\n   */\n  executionMode?: WasmExecutionModePreference;\n}\n\nexport function resolveWasmExecutionMode(\n  preference: WasmExecutionModePreference,\n  capabilities: WasmEngineCapabilities,\n  sharedInputQueueAvailable: boolean\n): WasmExecutionMode {\n  if (preference !== \"auto\") {\n    return preference;\n  }\n  if (!capabilities.supportsJSPI) {\n    return \"worker\";\n  }\n  // Workers stay the auto default even on JSPI-capable engines: main-thread\n  // execution shares the page's thread, and its stack-budget advantage only\n  // pays off once the non-lean profile is production-ready (see\n  // `stackProfileEnvironmentDefaults`). JSPI's auto role today is running\n  // where workers cannot — pages without cross-origin isolation.\n  if (!sharedInputQueueAvailable) {\n    return \"main-thread\";\n  }\n  return \"worker\";\n}\n\nexport function createWasmSceneRuntimeFactory(\n  wasmURL: URL,\n  factoryOptions: WasmSceneRuntimeFactoryOptions = {}\n): (options: WebHostSceneRuntimeOptions) => WebHostSceneRuntime {\n  return (options) => {\n    const runtime = new WasmSceneRuntime(options, wasmURL, factoryOptions);\n    factoryOptions.onRuntimeCreated?.(runtime);\n    return runtime;\n  };\n}\n\nclass WasmSceneRuntime extends WebHostSceneRuntime {\n  private readonly bridge?: BrowserWASIBridge;\n  private readonly wasmURL: URL;\n  private readonly onSceneResize?: (event: WasmSceneResizeEvent) => void;\n  private readonly workerModuleURL: string | URL;\n  private readonly executionModePreference: WasmExecutionModePreference;\n  private readonly inputQueue?: SharedInputQueueBuffers;\n  private readonly inputWriter?: SharedInputQueueWriter;\n  private readonly inputRouter: { route(chunk: Uint8Array): void };\n  private readonly sharedQueueError?: unknown;\n\n  private detachBridgeInputListener?: () => void;\n  private detachResizeListener?: () => void;\n  private worker?: Worker;\n  private executor?: MainThreadWasmExecutor;\n  private didMount = false;\n\n  constructor(\n    options: WebHostSceneRuntimeOptions,\n    wasmURL: URL,\n    factoryOptions: WasmSceneRuntimeFactoryOptions\n  ) {\n    let inputQueue: SharedInputQueueBuffers | undefined;\n    let inputWriter: SharedInputQueueWriter | undefined;\n    let sharedQueueError: unknown;\n\n    try {\n      inputQueue = createSharedInputQueue();\n      inputWriter = new SharedInputQueueWriter(inputQueue);\n    } catch (error) {\n      // Not fatal here: the main-thread (JSPI) mode runs without\n      // SharedArrayBuffer. Surfaced at mount if the worker mode needs it.\n      sharedQueueError = error;\n    }\n\n    const inputRouter = {\n      route: (chunk: Uint8Array): void => {\n        try {\n          inputWriter?.write(chunk);\n        } catch (error) {\n          console.error(\"[SwiftTUIWeb] failed to enqueue terminal input\", error);\n        }\n      },\n    };\n\n    super({\n      ...options,\n      onInput: (chunk) => inputRouter.route(chunk),\n    });\n\n    this.bridge = options.bridge;\n    this.wasmURL = wasmURL;\n    this.onSceneResize = factoryOptions.onSceneResize;\n    this.workerModuleURL = factoryOptions.workerModuleURL ?? workerModuleURL;\n    this.executionModePreference = factoryOptions.executionMode ?? \"auto\";\n    this.inputQueue = inputQueue;\n    this.inputWriter = inputWriter;\n    this.inputRouter = inputRouter;\n    this.sharedQueueError = sharedQueueError;\n  }\n\n  override async mount(): Promise<void> {\n    await super.mount();\n    if (this.didMount) {\n      return;\n    }\n\n    this.didMount = true;\n    this.detachBridgeInputListener = this.bridge?.stdin.subscribe((chunk) => {\n      this.inputRouter.route(chunk);\n    });\n    this.detachResizeListener = this.bridge?.subscribeResize((columns, rows, cellWidth, cellHeight) => {\n      this.onSceneResize?.({\n        sceneId: this.descriptor.id,\n        columns,\n        rows,\n        cellWidth,\n        cellHeight,\n      });\n    });\n\n    const initialColumns = Number(this.bridge?.environment.TUIGUI_COLUMNS ?? \"0\") || 0;\n    const initialRows = Number(this.bridge?.environment.TUIGUI_ROWS ?? \"0\") || 0;\n    if (!this.bridge && initialColumns > 0 && initialRows > 0) {\n      this.onSceneResize?.({\n        sceneId: this.descriptor.id,\n        columns: initialColumns,\n        rows: initialRows,\n      });\n    }\n\n    if (!this.bridge) {\n      this.writeOutput(\n        \"\\r\\nSwiftTUI WASI browser runtime requires a WASI bridge.\\r\\n\"\n      );\n      return;\n    }\n\n    const mode = resolveWasmExecutionMode(\n      this.executionModePreference,\n      resolveWasmEngineCapabilities(),\n      this.inputQueue !== undefined && this.inputWriter !== undefined\n    );\n    if (mode === \"main-thread\") {\n      this.startMainThreadExecutor();\n      return;\n    }\n\n    if (!this.inputQueue || !this.inputWriter) {\n      if (this.sharedQueueError !== undefined) {\n        console.error(\n          \"[SwiftTUIWeb] failed to create shared stdin queue\",\n          this.sharedQueueError\n        );\n      }\n      this.writeOutput(\n        \"\\r\\nSwiftTUI WASI browser runtime requires SharedArrayBuffer-backed stdin. Serve the app with COOP/COEP headers.\\r\\n\"\n      );\n      return;\n    }\n\n    this.worker = new Worker(this.workerModuleURL, { type: \"module\" });\n    this.worker.addEventListener(\"message\", (event: MessageEvent<WorkerMessage>) => {\n      this.handleWorkerMessage(event.data);\n    });\n    this.worker.addEventListener(\"error\", (event) => {\n      this.bridge?.stderr.write(\n        `\\nSwiftTUI WASI worker failed: ${event.message || \"unknown worker error\"}\\n`\n      );\n    });\n\n    const environment = { ...this.bridge.environment };\n\n    const message: WorkerStartMessage = {\n      type: \"start\",\n      wasmURL: this.wasmURL.href,\n      environment,\n      inputQueue: this.inputQueue,\n    };\n    this.worker.postMessage(message);\n  }\n\n  override dispose(): void {\n    this.detachBridgeInputListener?.();\n    this.detachResizeListener?.();\n    this.inputWriter?.close();\n    this.worker?.terminate();\n    this.executor?.dispose();\n    super.dispose();\n  }\n\n  private startMainThreadExecutor(): void {\n    const bridge = this.bridge;\n    if (!bridge) {\n      return;\n    }\n    const executor = new MainThreadWasmExecutor({\n      wasmURL: this.wasmURL.href,\n      environment: {\n        ...mainThreadStackProfileEnvironmentDefaults(resolveWasmEngineCapabilities()),\n        ...bridge.environment,\n      },\n      onStdout: (chunk) => bridge.stdout.write(chunk),\n      onStderr: (chunk) => bridge.stderr.write(chunk),\n      onExit: (code) => {\n        if (code !== 0) {\n          bridge.stderr.write(`\\nSwiftTUI WASI app exited with code ${code}.\\n`);\n        }\n      },\n      onError: (message) => {\n        bridge.stderr.write(`\\nFailed to start SwiftTUI WASI app: ${message}\\n`);\n      },\n    });\n    this.executor = executor;\n    this.inputRouter.route = (chunk) => executor.sendInput(chunk);\n    executor.start();\n  }\n\n  private handleWorkerMessage(\n    message: WorkerMessage\n  ): void {\n    switch (message.type) {\n    case \"stdout\":\n      this.bridge?.stdout.write(message.chunk);\n      break;\n    case \"stderr\":\n      this.bridge?.stderr.write(message.chunk);\n      break;\n    case \"exit\":\n      if (message.code !== 0) {\n        this.bridge?.stderr.write(`\\nSwiftTUI WASI app exited with code ${message.code}.\\n`);\n      }\n      break;\n    case \"error\":\n      this.bridge?.stderr.write(`\\nFailed to start SwiftTUI WASI app: ${message.message}\\n`);\n      break;\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"WasmSceneRuntime.js","names":[],"sources":["../../../src/wasi/WasmSceneRuntime.ts"],"sourcesContent":["import {\n  WebHostSceneRuntime,\n  type WebHostSceneRuntimeOptions,\n} from \"../WebHostSceneRuntime.ts\";\nimport {\n  encodeResizeControlMessage,\n  type BrowserWASIBridge,\n} from \"./BrowserWASIBridge.ts\";\n\nimport { MainThreadWasmExecutor } from \"./MainThreadWasmExecutor.ts\";\nimport {\n  SharedInputQueueWriter,\n  createSharedInputQueue,\n  type SharedInputQueueBuffers,\n} from \"./SharedInputQueue.ts\";\nimport {\n  mainThreadStackProfileEnvironmentDefaults,\n  resolveWasmEngineCapabilities,\n  type WasmEngineCapabilities,\n} from \"./WasmEngineCapabilities.ts\";\nimport { createWasmPauseCell, setWasmPauseCellPaused } from \"./WasmRuntimePause.ts\";\n\nconst workerModuleURL = new URL(\"./wasm-scene-worker.js\", import.meta.url);\n\ninterface WorkerStartMessage {\n  type: \"start\";\n  wasmURL: string;\n  environment: Record<string, string>;\n  inputQueue: SharedInputQueueBuffers;\n  pauseCell?: SharedArrayBuffer;\n}\n\ninterface WorkerOutputMessage {\n  type: \"stdout\" | \"stderr\";\n  chunk: Uint8Array;\n}\n\ninterface WorkerExitMessage {\n  type: \"exit\";\n  code: number;\n}\n\ninterface WorkerErrorMessage {\n  type: \"error\";\n  message: string;\n}\n\ntype WorkerMessage = WorkerOutputMessage | WorkerExitMessage | WorkerErrorMessage;\n\nexport interface WasmSceneResizeEvent {\n  sceneId: string;\n  columns: number;\n  rows: number;\n  cellWidth?: number;\n  cellHeight?: number;\n}\n\nexport interface WasmSceneRuntimeHandle {\n  readonly descriptor: WebHostSceneRuntime[\"descriptor\"];\n  sendInput(chunk: Uint8Array): void;\n}\n\nexport type WasmExecutionMode = \"worker\" | \"main-thread\";\nexport type WasmExecutionModePreference = WasmExecutionMode | \"auto\";\n\nexport interface WasmSceneRuntimeFactoryOptions {\n  onSceneResize?(event: WasmSceneResizeEvent): void;\n  onRuntimeCreated?(runtime: WasmSceneRuntimeHandle): void;\n  workerModuleURL?: string | URL;\n  /**\n   * How to execute the wasm app. \"worker\" is the classic path\n   * (`Atomics.wait` stdin, needs SharedArrayBuffer/COOP/COEP). \"main-thread\"\n   * runs on the page's thread via WebAssembly JSPI — larger stack budget (no\n   * stack-lean profile on measured engines), no COOP/COEP requirement, at\n   * the cost of sharing the main thread. \"auto\" (default) picks main-thread\n   * only where workers cannot run (SharedArrayBuffer unavailable and JSPI\n   * present); workers everywhere else.\n   */\n  executionMode?: WasmExecutionModePreference;\n}\n\nexport function resolveWasmExecutionMode(\n  preference: WasmExecutionModePreference,\n  capabilities: WasmEngineCapabilities,\n  sharedInputQueueAvailable: boolean\n): WasmExecutionMode {\n  if (preference !== \"auto\") {\n    return preference;\n  }\n  if (!capabilities.supportsJSPI) {\n    return \"worker\";\n  }\n  // Workers stay the auto default even on JSPI-capable engines: main-thread\n  // execution shares the page's thread, and its stack-budget advantage only\n  // pays off once the non-lean profile is production-ready (see\n  // `stackProfileEnvironmentDefaults`). JSPI's auto role today is running\n  // where workers cannot — pages without cross-origin isolation.\n  if (!sharedInputQueueAvailable) {\n    return \"main-thread\";\n  }\n  return \"worker\";\n}\n\nexport function createWasmSceneRuntimeFactory(\n  wasmURL: URL,\n  factoryOptions: WasmSceneRuntimeFactoryOptions = {}\n): (options: WebHostSceneRuntimeOptions) => WebHostSceneRuntime {\n  return (options) => {\n    const runtime = new WasmSceneRuntime(options, wasmURL, factoryOptions);\n    factoryOptions.onRuntimeCreated?.(runtime);\n    return runtime;\n  };\n}\n\nclass WasmSceneRuntime extends WebHostSceneRuntime {\n  private readonly bridge?: BrowserWASIBridge;\n  private readonly wasmURL: URL;\n  private readonly onSceneResize?: (event: WasmSceneResizeEvent) => void;\n  private readonly workerModuleURL: string | URL;\n  private readonly executionModePreference: WasmExecutionModePreference;\n  private readonly inputQueue?: SharedInputQueueBuffers;\n  private readonly inputWriter?: SharedInputQueueWriter;\n  private readonly inputRouter: { route(chunk: Uint8Array): void };\n  private readonly sharedQueueError?: unknown;\n  private readonly pauseCell?: SharedArrayBuffer;\n\n  private detachBridgeInputListener?: () => void;\n  private detachResizeListener?: () => void;\n  private worker?: Worker;\n  private executor?: MainThreadWasmExecutor;\n  private didMount = false;\n  private suspended = false;\n\n  constructor(\n    options: WebHostSceneRuntimeOptions,\n    wasmURL: URL,\n    factoryOptions: WasmSceneRuntimeFactoryOptions\n  ) {\n    let inputQueue: SharedInputQueueBuffers | undefined;\n    let inputWriter: SharedInputQueueWriter | undefined;\n    let sharedQueueError: unknown;\n    let pauseCell: SharedArrayBuffer | undefined;\n\n    try {\n      inputQueue = createSharedInputQueue();\n      inputWriter = new SharedInputQueueWriter(inputQueue);\n      pauseCell = createWasmPauseCell();\n    } catch (error) {\n      // Not fatal here: the main-thread (JSPI) mode runs without\n      // SharedArrayBuffer. Surfaced at mount if the worker mode needs it.\n      sharedQueueError = error;\n    }\n\n    const inputRouter = {\n      route: (chunk: Uint8Array): void => {\n        try {\n          inputWriter?.write(chunk);\n        } catch (error) {\n          console.error(\"[SwiftTUIWeb] failed to enqueue terminal input\", error);\n        }\n      },\n    };\n\n    super({\n      ...options,\n      onInput: (chunk) => inputRouter.route(chunk),\n    });\n\n    this.bridge = options.bridge;\n    this.wasmURL = wasmURL;\n    this.onSceneResize = factoryOptions.onSceneResize;\n    this.workerModuleURL = factoryOptions.workerModuleURL ?? workerModuleURL;\n    this.executionModePreference = factoryOptions.executionMode ?? \"auto\";\n    this.inputQueue = inputQueue;\n    this.inputWriter = inputWriter;\n    this.inputRouter = inputRouter;\n    this.sharedQueueError = sharedQueueError;\n    this.pauseCell = pauseCell;\n  }\n\n  protected override onRuntimeSuspensionChange(\n    suspended: boolean\n  ): void {\n    this.suspended = suspended;\n    if (this.pauseCell) {\n      setWasmPauseCellPaused(this.pauseCell, suspended);\n    }\n    this.executor?.setSuspended(suspended);\n  }\n\n  override async mount(): Promise<void> {\n    await super.mount();\n    if (this.didMount) {\n      return;\n    }\n\n    this.didMount = true;\n    this.detachBridgeInputListener = this.bridge?.stdin.subscribe((chunk) => {\n      this.inputRouter.route(chunk);\n    });\n    this.detachResizeListener = this.bridge?.subscribeResize((columns, rows, cellWidth, cellHeight) => {\n      this.onSceneResize?.({\n        sceneId: this.descriptor.id,\n        columns,\n        rows,\n        cellWidth,\n        cellHeight,\n      });\n    });\n\n    const initialColumns = Number(this.bridge?.environment.TUIGUI_COLUMNS ?? \"0\") || 0;\n    const initialRows = Number(this.bridge?.environment.TUIGUI_ROWS ?? \"0\") || 0;\n    if (!this.bridge && initialColumns > 0 && initialRows > 0) {\n      this.onSceneResize?.({\n        sceneId: this.descriptor.id,\n        columns: initialColumns,\n        rows: initialRows,\n      });\n    }\n\n    if (!this.bridge) {\n      this.writeOutput(\n        \"\\r\\nSwiftTUI WASI browser runtime requires a WASI bridge.\\r\\n\"\n      );\n      return;\n    }\n\n    const mode = resolveWasmExecutionMode(\n      this.executionModePreference,\n      resolveWasmEngineCapabilities(),\n      this.inputQueue !== undefined && this.inputWriter !== undefined\n    );\n    if (mode === \"main-thread\") {\n      this.startMainThreadExecutor();\n      return;\n    }\n\n    if (!this.inputQueue || !this.inputWriter) {\n      if (this.sharedQueueError !== undefined) {\n        console.error(\n          \"[SwiftTUIWeb] failed to create shared stdin queue\",\n          this.sharedQueueError\n        );\n      }\n      this.writeOutput(\n        \"\\r\\nSwiftTUI WASI browser runtime requires SharedArrayBuffer-backed stdin. Serve the app with COOP/COEP headers.\\r\\n\"\n      );\n      return;\n    }\n\n    this.worker = new Worker(this.workerModuleURL, { type: \"module\" });\n    this.worker.addEventListener(\"message\", (event: MessageEvent<WorkerMessage>) => {\n      this.handleWorkerMessage(event.data);\n    });\n    this.worker.addEventListener(\"error\", (event) => {\n      this.bridge?.stderr.write(\n        `\\nSwiftTUI WASI worker failed: ${event.message || \"unknown worker error\"}\\n`\n      );\n    });\n\n    const environment = { ...this.bridge.environment };\n\n    const message: WorkerStartMessage = {\n      type: \"start\",\n      wasmURL: this.wasmURL.href,\n      environment,\n      inputQueue: this.inputQueue,\n      pauseCell: this.pauseCell,\n    };\n    this.worker.postMessage(message);\n  }\n\n  override dispose(): void {\n    this.detachBridgeInputListener?.();\n    this.detachResizeListener?.();\n    this.inputWriter?.close();\n    this.worker?.terminate();\n    this.executor?.dispose();\n    super.dispose();\n  }\n\n  private startMainThreadExecutor(): void {\n    const bridge = this.bridge;\n    if (!bridge) {\n      return;\n    }\n    const executor = new MainThreadWasmExecutor({\n      wasmURL: this.wasmURL.href,\n      environment: {\n        ...mainThreadStackProfileEnvironmentDefaults(resolveWasmEngineCapabilities()),\n        ...bridge.environment,\n      },\n      onStdout: (chunk) => bridge.stdout.write(chunk),\n      onStderr: (chunk) => bridge.stderr.write(chunk),\n      onExit: (code) => {\n        if (code !== 0) {\n          bridge.stderr.write(`\\nSwiftTUI WASI app exited with code ${code}.\\n`);\n        }\n      },\n      onError: (message) => {\n        bridge.stderr.write(`\\nFailed to start SwiftTUI WASI app: ${message}\\n`);\n      },\n    });\n    this.executor = executor;\n    this.inputRouter.route = (chunk) => executor.sendInput(chunk);\n    executor.setSuspended(this.suspended);\n    executor.start();\n  }\n\n  private handleWorkerMessage(\n    message: WorkerMessage\n  ): void {\n    switch (message.type) {\n    case \"stdout\":\n      this.bridge?.stdout.write(message.chunk);\n      break;\n    case \"stderr\":\n      this.bridge?.stderr.write(message.chunk);\n      break;\n    case \"exit\":\n      if (message.code !== 0) {\n        this.bridge?.stderr.write(`\\nSwiftTUI WASI app exited with code ${message.code}.\\n`);\n      }\n      break;\n    case \"error\":\n      this.bridge?.stderr.write(`\\nFailed to start SwiftTUI WASI app: ${message.message}\\n`);\n      break;\n    }\n  }\n}\n"],"mappings":";;;;;;AAsBA,MAAM,kBAAkB,IAAI,IAAI,0BAA0B,OAAO,KAAK,GAAG;AA2DzE,SAAgB,yBACd,YACA,cACA,2BACmB;CACnB,IAAI,eAAe,QACjB,OAAO;CAET,IAAI,CAAC,aAAa,cAChB,OAAO;CAOT,IAAI,CAAC,2BACH,OAAO;CAET,OAAO;AACT;AAEA,SAAgB,8BACd,SACA,iBAAiD,CAAC,GACY;CAC9D,QAAQ,YAAY;EAClB,MAAM,UAAU,IAAI,iBAAiB,SAAS,SAAS,cAAc;EACrE,eAAe,mBAAmB,OAAO;EACzC,OAAO;CACT;AACF;AAEA,IAAM,mBAAN,cAA+B,oBAAoB;CACjD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA,WAAmB;CACnB,YAAoB;CAEpB,YACE,SACA,SACA,gBACA;EACA,IAAI;EACJ,IAAI;EACJ,IAAI;EACJ,IAAI;EAEJ,IAAI;GACF,aAAa,uBAAuB;GACpC,cAAc,IAAI,uBAAuB,UAAU;GACnD,YAAY,oBAAoB;EAClC,SAAS,OAAO;GAGd,mBAAmB;EACrB;EAEA,MAAM,cAAc,EAClB,QAAQ,UAA4B;GAClC,IAAI;IACF,aAAa,MAAM,KAAK;GAC1B,SAAS,OAAO;IACd,QAAQ,MAAM,kDAAkD,KAAK;GACvE;EACF,EACF;EAEA,MAAM;GACJ,GAAG;GACH,UAAU,UAAU,YAAY,MAAM,KAAK;EAC7C,CAAC;EAED,KAAK,SAAS,QAAQ;EACtB,KAAK,UAAU;EACf,KAAK,gBAAgB,eAAe;EACpC,KAAK,kBAAkB,eAAe,mBAAmB;EACzD,KAAK,0BAA0B,eAAe,iBAAiB;EAC/D,KAAK,aAAa;EAClB,KAAK,cAAc;EACnB,KAAK,cAAc;EACnB,KAAK,mBAAmB;EACxB,KAAK,YAAY;CACnB;CAEA,0BACE,WACM;EACN,KAAK,YAAY;EACjB,IAAI,KAAK,WACP,uBAAuB,KAAK,WAAW,SAAS;EAElD,KAAK,UAAU,aAAa,SAAS;CACvC;CAEA,MAAe,QAAuB;EACpC,MAAM,MAAM,MAAM;EAClB,IAAI,KAAK,UACP;EAGF,KAAK,WAAW;EAChB,KAAK,4BAA4B,KAAK,QAAQ,MAAM,WAAW,UAAU;GACvE,KAAK,YAAY,MAAM,KAAK;EAC9B,CAAC;EACD,KAAK,uBAAuB,KAAK,QAAQ,iBAAiB,SAAS,MAAM,WAAW,eAAe;GACjG,KAAK,gBAAgB;IACnB,SAAS,KAAK,WAAW;IACzB;IACA;IACA;IACA;GACF,CAAC;EACH,CAAC;EAED,MAAM,iBAAiB,OAAO,KAAK,QAAQ,YAAY,kBAAkB,GAAG,KAAK;EACjF,MAAM,cAAc,OAAO,KAAK,QAAQ,YAAY,eAAe,GAAG,KAAK;EAC3E,IAAI,CAAC,KAAK,UAAU,iBAAiB,KAAK,cAAc,GACtD,KAAK,gBAAgB;GACnB,SAAS,KAAK,WAAW;GACzB,SAAS;GACT,MAAM;EACR,CAAC;EAGH,IAAI,CAAC,KAAK,QAAQ;GAChB,KAAK,YACH,+DACF;GACA;EACF;EAOA,IALa,yBACX,KAAK,yBACL,8BAA8B,GAC9B,KAAK,eAAe,KAAA,KAAa,KAAK,gBAAgB,KAAA,CAEjD,MAAM,eAAe;GAC1B,KAAK,wBAAwB;GAC7B;EACF;EAEA,IAAI,CAAC,KAAK,cAAc,CAAC,KAAK,aAAa;GACzC,IAAI,KAAK,qBAAqB,KAAA,GAC5B,QAAQ,MACN,qDACA,KAAK,gBACP;GAEF,KAAK,YACH,sHACF;GACA;EACF;EAEA,KAAK,SAAS,IAAI,OAAO,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;EACjE,KAAK,OAAO,iBAAiB,YAAY,UAAuC;GAC9E,KAAK,oBAAoB,MAAM,IAAI;EACrC,CAAC;EACD,KAAK,OAAO,iBAAiB,UAAU,UAAU;GAC/C,KAAK,QAAQ,OAAO,MAClB,kCAAkC,MAAM,WAAW,uBAAuB,GAC5E;EACF,CAAC;EAED,MAAM,cAAc,EAAE,GAAG,KAAK,OAAO,YAAY;EAEjD,MAAM,UAA8B;GAClC,MAAM;GACN,SAAS,KAAK,QAAQ;GACtB;GACA,YAAY,KAAK;GACjB,WAAW,KAAK;EAClB;EACA,KAAK,OAAO,YAAY,OAAO;CACjC;CAEA,UAAyB;EACvB,KAAK,4BAA4B;EACjC,KAAK,uBAAuB;EAC5B,KAAK,aAAa,MAAM;EACxB,KAAK,QAAQ,UAAU;EACvB,KAAK,UAAU,QAAQ;EACvB,MAAM,QAAQ;CAChB;CAEA,0BAAwC;EACtC,MAAM,SAAS,KAAK;EACpB,IAAI,CAAC,QACH;EAEF,MAAM,WAAW,IAAI,uBAAuB;GAC1C,SAAS,KAAK,QAAQ;GACtB,aAAa;IACX,GAAG,0CAA0C,8BAA8B,CAAC;IAC5E,GAAG,OAAO;GACZ;GACA,WAAW,UAAU,OAAO,OAAO,MAAM,KAAK;GAC9C,WAAW,UAAU,OAAO,OAAO,MAAM,KAAK;GAC9C,SAAS,SAAS;IAChB,IAAI,SAAS,GACX,OAAO,OAAO,MAAM,wCAAwC,KAAK,IAAI;GAEzE;GACA,UAAU,YAAY;IACpB,OAAO,OAAO,MAAM,wCAAwC,QAAQ,GAAG;GACzE;EACF,CAAC;EACD,KAAK,WAAW;EAChB,KAAK,YAAY,SAAS,UAAU,SAAS,UAAU,KAAK;EAC5D,SAAS,aAAa,KAAK,SAAS;EACpC,SAAS,MAAM;CACjB;CAEA,oBACE,SACM;EACN,QAAQ,QAAQ,MAAhB;GACA,KAAK;IACH,KAAK,QAAQ,OAAO,MAAM,QAAQ,KAAK;IACvC;GACF,KAAK;IACH,KAAK,QAAQ,OAAO,MAAM,QAAQ,KAAK;IACvC;GACF,KAAK;IACH,IAAI,QAAQ,SAAS,GACnB,KAAK,QAAQ,OAAO,MAAM,wCAAwC,QAAQ,KAAK,IAAI;IAErF;GACF,KAAK;IACH,KAAK,QAAQ,OAAO,MAAM,wCAAwC,QAAQ,QAAQ,GAAG;IACrF;EACF;CACF;AACF"}

package/dist/src/wasi/WasmSceneWorker.d.ts

@@ -5,6 +5,13 @@ interface StartWasmSceneWorkerMessage {
   wasmURL: string;
   environment: Record<string, string>;
   inputQueue: SharedInputQueueBuffers;
+  /**
+   * Optional shared pause cell (see `createWasmPauseCell`). When present, the
+   * main thread can suspend this scene: the worker parks between poll waits
+   * and the app's monotonic clock freezes for the paused span. Absent on
+   * messages from older runtimes — the worker then runs unpausable, as before.
+   */
+  pauseCell?: SharedArrayBuffer;
 }
 interface OutputWasmSceneWorkerMessage {
   type: "stdout" | "stderr";

package/dist/src/wasi/WasmSceneWorker.js

@@ -1,4 +1,5 @@
 import { WasiPollScheduler } from "./WasiPollScheduler.js";
+import { PausableMonotonicClock, WorkerWasmPauseGate, installPausableClockTimeGet } from "./WasmRuntimePause.js";
 import { SharedInputQueueReader } from "./SharedInputQueue.js";
 import { ConsoleStdout, Fd, WASI, wasi } from "@bjorn3/browser_wasi_shim";
 //#region src/wasi/WasmSceneWorker.ts
@@ -56,13 +57,19 @@ var BlockingInputFileDescriptor = class extends Fd {
 		return this.reader.isClosed();
 	}
 };
-function installWasiPollScheduler(wasiBridge, stdin) {
+function installWasiPollScheduler(wasiBridge, stdin, pauseCell) {
 	const originalPoll = wasiBridge.wasiImport.poll_oneoff;
 	if (typeof originalPoll !== "function") return;
+	const memory = () => wasiBridge.inst?.exports.memory;
+	const pauseClock = pauseCell ? new PausableMonotonicClock() : void 0;
+	const pauseGate = pauseCell && pauseClock ? new WorkerWasmPauseGate(pauseCell, pauseClock) : void 0;
+	if (pauseClock) installPausableClockTimeGet(wasiBridge.wasiImport, memory, pauseClock);
 	const scheduler = new WasiPollScheduler({
-		memory: () => wasiBridge.inst?.exports.memory,
+		memory,
 		stdin,
-		fallbackPoll: (inPtr, outPtr, nsubscriptions, neventsPtr) => originalPoll(inPtr, outPtr, nsubscriptions, neventsPtr)
+		fallbackPoll: (inPtr, outPtr, nsubscriptions, neventsPtr) => originalPoll(inPtr, outPtr, nsubscriptions, neventsPtr),
+		nowMilliseconds: pauseClock ? () => pauseClock.nowMilliseconds() : void 0,
+		pauseGate
 	});
 	wasiBridge.wasiImport.poll_oneoff = (inPtr, outPtr, nsubscriptions, neventsPtr) => scheduler.pollOneOff(inPtr, outPtr, nsubscriptions, neventsPtr);
 }
@@ -84,7 +91,7 @@ async function startWasmScene(message) {
 				});
 			})
 		]);
-		installWasiPollScheduler(wasiBridge, stdin);
+		installWasiPollScheduler(wasiBridge, stdin, message.pauseCell);
 		const response = await fetch(message.wasmURL);
 		if (!response.ok) throw new Error(`failed to load ${message.wasmURL}: ${response.status} ${response.statusText}`);
 		const module = await WebAssembly.compile(await response.arrayBuffer());

package/dist/src/wasi/WasmSceneWorker.js.map

@@ -1 +1 @@
-{"version":3,"file":"WasmSceneWorker.js","names":[],"sources":["../../../src/wasi/WasmSceneWorker.ts"],"sourcesContent":["import { ConsoleStdout, Fd, WASI, wasi } from \"@bjorn3/browser_wasi_shim\";\nimport {\n  SharedInputQueueReader,\n  type SharedInputQueueBuffers,\n} from \"./SharedInputQueue.ts\";\nimport { WasiPollScheduler } from \"./WasiPollScheduler.ts\";\n\nexport interface StartWasmSceneWorkerMessage {\n  type: \"start\";\n  wasmURL: string;\n  environment: Record<string, string>;\n  inputQueue: SharedInputQueueBuffers;\n}\n\nexport interface OutputWasmSceneWorkerMessage {\n  type: \"stdout\" | \"stderr\";\n  chunk: Uint8Array;\n}\n\nexport interface ExitWasmSceneWorkerMessage {\n  type: \"exit\";\n  code: number;\n}\n\nexport interface ErrorWasmSceneWorkerMessage {\n  type: \"error\";\n  message: string;\n}\n\nexport type WasmSceneWorkerMessage = StartWasmSceneWorkerMessage;\nexport type WasmSceneWorkerResponse =\n  | OutputWasmSceneWorkerMessage\n  | ExitWasmSceneWorkerMessage\n  | ErrorWasmSceneWorkerMessage;\n\nexport function startWasmSceneWorker(): void {\n  globalThis.addEventListener(\"message\", (event: MessageEvent<WasmSceneWorkerMessage>) => {\n    if (event.data.type !== \"start\") {\n      return;\n    }\n\n    void startWasmScene(event.data);\n  });\n}\n\nclass BlockingInputFileDescriptor extends Fd {\n  private readonly reader: SharedInputQueueReader;\n  private readonly fdstat = (() => {\n    const fdstat = new wasi.Fdstat(wasi.FILETYPE_CHARACTER_DEVICE, 0);\n    fdstat.fs_rights_base = BigInt(wasi.RIGHTS_FD_READ);\n    return fdstat;\n  })();\n\n  constructor(inputQueue: SharedInputQueueBuffers) {\n    super();\n    this.reader = new SharedInputQueueReader(inputQueue);\n  }\n\n  override fd_fdstat_get(): { ret: number; fdstat: wasi.Fdstat } {\n    return {\n      ret: wasi.ERRNO_SUCCESS,\n      fdstat: this.fdstat,\n    };\n  }\n\n  override fd_filestat_get(): { ret: number; filestat: wasi.Filestat } {\n    return {\n      ret: wasi.ERRNO_SUCCESS,\n      filestat: new wasi.Filestat(0n, wasi.FILETYPE_CHARACTER_DEVICE, 0n),\n    };\n  }\n\n  override fd_read(size: number): { ret: number; data: Uint8Array } {\n    const chunk = this.reader.readAvailable(size);\n    if (chunk) {\n      return {\n        ret: wasi.ERRNO_SUCCESS,\n        data: chunk,\n      };\n    }\n\n    if (this.reader.isClosed()) {\n      return {\n        ret: wasi.ERRNO_SUCCESS,\n        data: new Uint8Array(),\n      };\n    }\n\n    return {\n      ret: wasi.ERRNO_AGAIN,\n      data: new Uint8Array(),\n    };\n  }\n\n  availableBytes(): number {\n    return this.reader.availableBytes();\n  }\n\n  waitForReadable(\n    timeoutMilliseconds?: number\n  ) {\n    return this.reader.waitForReadable(timeoutMilliseconds);\n  }\n\n  isClosed(): boolean {\n    return this.reader.isClosed();\n  }\n}\n\nfunction installWasiPollScheduler(\n  wasiBridge: WASI,\n  stdin: BlockingInputFileDescriptor\n): void {\n  const originalPoll = wasiBridge.wasiImport.poll_oneoff;\n  if (typeof originalPoll !== \"function\") {\n    return;\n  }\n\n  const scheduler = new WasiPollScheduler({\n    memory: () => wasiBridge.inst?.exports.memory as WebAssembly.Memory | undefined,\n    stdin,\n    fallbackPoll: (inPtr, outPtr, nsubscriptions, neventsPtr) =>\n      originalPoll(inPtr, outPtr, nsubscriptions, neventsPtr),\n  });\n  wasiBridge.wasiImport.poll_oneoff = (inPtr, outPtr, nsubscriptions, neventsPtr) =>\n    scheduler.pollOneOff(inPtr, outPtr, nsubscriptions, neventsPtr);\n}\n\nasync function startWasmScene(\n  message: StartWasmSceneWorkerMessage\n): Promise<void> {\n  try {\n    const stdin = new BlockingInputFileDescriptor(message.inputQueue);\n    const wasiBridge = new WASI(\n      [\"app.wasm\"],\n      Object.entries(message.environment).map(([key, value]) => `${key}=${value}`),\n      [\n        stdin,\n        new ConsoleStdout((chunk) => {\n          postWorkerMessage({\n            type: \"stdout\",\n            chunk,\n          });\n        }),\n        new ConsoleStdout((chunk) => {\n          postWorkerMessage({\n            type: \"stderr\",\n            chunk,\n          });\n        }),\n      ]\n    );\n    installWasiPollScheduler(wasiBridge, stdin);\n\n    const response = await fetch(message.wasmURL);\n    if (!response.ok) {\n      throw new Error(`failed to load ${message.wasmURL}: ${response.status} ${response.statusText}`);\n    }\n\n    const module = await WebAssembly.compile(await response.arrayBuffer());\n    const instance = await WebAssembly.instantiate(module, {\n      wasi_snapshot_preview1: wasiBridge.wasiImport,\n    });\n\n    const exitCode = wasiBridge.start(instance as WebAssembly.Instance);\n    postWorkerMessage({\n      type: \"exit\",\n      code: exitCode,\n    });\n  } catch (error) {\n    postWorkerMessage({\n      type: \"error\",\n      message: error instanceof Error ? error.message : String(error),\n    });\n  }\n}\n\nfunction postWorkerMessage(\n  message: WasmSceneWorkerResponse\n): void {\n  globalThis.postMessage(message);\n}\n"],"mappings":";;;;AAmCA,SAAgB,uBAA6B;CAC3C,WAAW,iBAAiB,YAAY,UAAgD;EACtF,IAAI,MAAM,KAAK,SAAS,SACtB;EAGF,eAAoB,MAAM,IAAI;CAChC,CAAC;AACH;AAEA,IAAM,8BAAN,cAA0C,GAAG;CAC3C;CACA,gBAAiC;EAC/B,MAAM,SAAS,IAAI,KAAK,OAAO,KAAK,2BAA2B,CAAC;EAChE,OAAO,iBAAiB,OAAO,KAAK,cAAc;EAClD,OAAO;CACT,EAAA,CAAG;CAEH,YAAY,YAAqC;EAC/C,MAAM;EACN,KAAK,SAAS,IAAI,uBAAuB,UAAU;CACrD;CAEA,gBAA+D;EAC7D,OAAO;GACL,KAAK,KAAK;GACV,QAAQ,KAAK;EACf;CACF;CAEA,kBAAqE;EACnE,OAAO;GACL,KAAK,KAAK;GACV,UAAU,IAAI,KAAK,SAAS,IAAI,KAAK,2BAA2B,EAAE;EACpE;CACF;CAEA,QAAiB,MAAiD;EAChE,MAAM,QAAQ,KAAK,OAAO,cAAc,IAAI;EAC5C,IAAI,OACF,OAAO;GACL,KAAK,KAAK;GACV,MAAM;EACR;EAGF,IAAI,KAAK,OAAO,SAAS,GACvB,OAAO;GACL,KAAK,KAAK;GACV,sBAAM,IAAI,WAAW;EACvB;EAGF,OAAO;GACL,KAAK,KAAK;GACV,sBAAM,IAAI,WAAW;EACvB;CACF;CAEA,iBAAyB;EACvB,OAAO,KAAK,OAAO,eAAe;CACpC;CAEA,gBACE,qBACA;EACA,OAAO,KAAK,OAAO,gBAAgB,mBAAmB;CACxD;CAEA,WAAoB;EAClB,OAAO,KAAK,OAAO,SAAS;CAC9B;AACF;AAEA,SAAS,yBACP,YACA,OACM;CACN,MAAM,eAAe,WAAW,WAAW;CAC3C,IAAI,OAAO,iBAAiB,YAC1B;CAGF,MAAM,YAAY,IAAI,kBAAkB;EACtC,cAAc,WAAW,MAAM,QAAQ;EACvC;EACA,eAAe,OAAO,QAAQ,gBAAgB,eAC5C,aAAa,OAAO,QAAQ,gBAAgB,UAAU;CAC1D,CAAC;CACD,WAAW,WAAW,eAAe,OAAO,QAAQ,gBAAgB,eAClE,UAAU,WAAW,OAAO,QAAQ,gBAAgB,UAAU;AAClE;AAEA,eAAe,eACb,SACe;CACf,IAAI;EACF,MAAM,QAAQ,IAAI,4BAA4B,QAAQ,UAAU;EAChE,MAAM,aAAa,IAAI,KACrB,CAAC,UAAU,GACX,OAAO,QAAQ,QAAQ,WAAW,CAAC,CAAC,KAAK,CAAC,KAAK,WAAW,GAAG,IAAI,GAAG,OAAO,GAC3E;GACE;GACA,IAAI,eAAe,UAAU;IAC3B,kBAAkB;KAChB,MAAM;KACN;IACF,CAAC;GACH,CAAC;GACD,IAAI,eAAe,UAAU;IAC3B,kBAAkB;KAChB,MAAM;KACN;IACF,CAAC;GACH,CAAC;EACH,CACF;EACA,yBAAyB,YAAY,KAAK;EAE1C,MAAM,WAAW,MAAM,MAAM,QAAQ,OAAO;EAC5C,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MAAM,kBAAkB,QAAQ,QAAQ,IAAI,SAAS,OAAO,GAAG,SAAS,YAAY;EAGhG,MAAM,SAAS,MAAM,YAAY,QAAQ,MAAM,SAAS,YAAY,CAAC;EACrE,MAAM,WAAW,MAAM,YAAY,YAAY,QAAQ,EACrD,wBAAwB,WAAW,WACrC,CAAC;EAGD,kBAAkB;GAChB,MAAM;GACN,MAHe,WAAW,MAAM,QAGnB;EACf,CAAC;CACH,SAAS,OAAO;EACd,kBAAkB;GAChB,MAAM;GACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EAChE,CAAC;CACH;AACF;AAEA,SAAS,kBACP,SACM;CACN,WAAW,YAAY,OAAO;AAChC"}
+{"version":3,"file":"WasmSceneWorker.js","names":[],"sources":["../../../src/wasi/WasmSceneWorker.ts"],"sourcesContent":["import { ConsoleStdout, Fd, WASI, wasi } from \"@bjorn3/browser_wasi_shim\";\nimport {\n  SharedInputQueueReader,\n  type SharedInputQueueBuffers,\n} from \"./SharedInputQueue.ts\";\nimport { WasiPollScheduler } from \"./WasiPollScheduler.ts\";\nimport {\n  PausableMonotonicClock,\n  WorkerWasmPauseGate,\n  installPausableClockTimeGet,\n} from \"./WasmRuntimePause.ts\";\n\nexport interface StartWasmSceneWorkerMessage {\n  type: \"start\";\n  wasmURL: string;\n  environment: Record<string, string>;\n  inputQueue: SharedInputQueueBuffers;\n  /**\n   * Optional shared pause cell (see `createWasmPauseCell`). When present, the\n   * main thread can suspend this scene: the worker parks between poll waits\n   * and the app's monotonic clock freezes for the paused span. Absent on\n   * messages from older runtimes — the worker then runs unpausable, as before.\n   */\n  pauseCell?: SharedArrayBuffer;\n}\n\nexport interface OutputWasmSceneWorkerMessage {\n  type: \"stdout\" | \"stderr\";\n  chunk: Uint8Array;\n}\n\nexport interface ExitWasmSceneWorkerMessage {\n  type: \"exit\";\n  code: number;\n}\n\nexport interface ErrorWasmSceneWorkerMessage {\n  type: \"error\";\n  message: string;\n}\n\nexport type WasmSceneWorkerMessage = StartWasmSceneWorkerMessage;\nexport type WasmSceneWorkerResponse =\n  | OutputWasmSceneWorkerMessage\n  | ExitWasmSceneWorkerMessage\n  | ErrorWasmSceneWorkerMessage;\n\nexport function startWasmSceneWorker(): void {\n  globalThis.addEventListener(\"message\", (event: MessageEvent<WasmSceneWorkerMessage>) => {\n    if (event.data.type !== \"start\") {\n      return;\n    }\n\n    void startWasmScene(event.data);\n  });\n}\n\nclass BlockingInputFileDescriptor extends Fd {\n  private readonly reader: SharedInputQueueReader;\n  private readonly fdstat = (() => {\n    const fdstat = new wasi.Fdstat(wasi.FILETYPE_CHARACTER_DEVICE, 0);\n    fdstat.fs_rights_base = BigInt(wasi.RIGHTS_FD_READ);\n    return fdstat;\n  })();\n\n  constructor(inputQueue: SharedInputQueueBuffers) {\n    super();\n    this.reader = new SharedInputQueueReader(inputQueue);\n  }\n\n  override fd_fdstat_get(): { ret: number; fdstat: wasi.Fdstat } {\n    return {\n      ret: wasi.ERRNO_SUCCESS,\n      fdstat: this.fdstat,\n    };\n  }\n\n  override fd_filestat_get(): { ret: number; filestat: wasi.Filestat } {\n    return {\n      ret: wasi.ERRNO_SUCCESS,\n      filestat: new wasi.Filestat(0n, wasi.FILETYPE_CHARACTER_DEVICE, 0n),\n    };\n  }\n\n  override fd_read(size: number): { ret: number; data: Uint8Array } {\n    const chunk = this.reader.readAvailable(size);\n    if (chunk) {\n      return {\n        ret: wasi.ERRNO_SUCCESS,\n        data: chunk,\n      };\n    }\n\n    if (this.reader.isClosed()) {\n      return {\n        ret: wasi.ERRNO_SUCCESS,\n        data: new Uint8Array(),\n      };\n    }\n\n    return {\n      ret: wasi.ERRNO_AGAIN,\n      data: new Uint8Array(),\n    };\n  }\n\n  availableBytes(): number {\n    return this.reader.availableBytes();\n  }\n\n  waitForReadable(\n    timeoutMilliseconds?: number\n  ) {\n    return this.reader.waitForReadable(timeoutMilliseconds);\n  }\n\n  isClosed(): boolean {\n    return this.reader.isClosed();\n  }\n}\n\nfunction installWasiPollScheduler(\n  wasiBridge: WASI,\n  stdin: BlockingInputFileDescriptor,\n  pauseCell: SharedArrayBuffer | undefined\n): void {\n  const originalPoll = wasiBridge.wasiImport.poll_oneoff;\n  if (typeof originalPoll !== \"function\") {\n    return;\n  }\n\n  const memory = (): WebAssembly.Memory | undefined =>\n    wasiBridge.inst?.exports.memory as WebAssembly.Memory | undefined;\n\n  const pauseClock = pauseCell ? new PausableMonotonicClock() : undefined;\n  const pauseGate =\n    pauseCell && pauseClock ? new WorkerWasmPauseGate(pauseCell, pauseClock) : undefined;\n  if (pauseClock) {\n    installPausableClockTimeGet(wasiBridge.wasiImport, memory, pauseClock);\n  }\n\n  const scheduler = new WasiPollScheduler({\n    memory,\n    stdin,\n    fallbackPoll: (inPtr, outPtr, nsubscriptions, neventsPtr) =>\n      originalPoll(inPtr, outPtr, nsubscriptions, neventsPtr),\n    nowMilliseconds: pauseClock ? () => pauseClock.nowMilliseconds() : undefined,\n    pauseGate,\n  });\n  wasiBridge.wasiImport.poll_oneoff = (inPtr, outPtr, nsubscriptions, neventsPtr) =>\n    scheduler.pollOneOff(inPtr, outPtr, nsubscriptions, neventsPtr);\n}\n\nasync function startWasmScene(\n  message: StartWasmSceneWorkerMessage\n): Promise<void> {\n  try {\n    const stdin = new BlockingInputFileDescriptor(message.inputQueue);\n    const wasiBridge = new WASI(\n      [\"app.wasm\"],\n      Object.entries(message.environment).map(([key, value]) => `${key}=${value}`),\n      [\n        stdin,\n        new ConsoleStdout((chunk) => {\n          postWorkerMessage({\n            type: \"stdout\",\n            chunk,\n          });\n        }),\n        new ConsoleStdout((chunk) => {\n          postWorkerMessage({\n            type: \"stderr\",\n            chunk,\n          });\n        }),\n      ]\n    );\n    installWasiPollScheduler(wasiBridge, stdin, message.pauseCell);\n\n    const response = await fetch(message.wasmURL);\n    if (!response.ok) {\n      throw new Error(`failed to load ${message.wasmURL}: ${response.status} ${response.statusText}`);\n    }\n\n    const module = await WebAssembly.compile(await response.arrayBuffer());\n    const instance = await WebAssembly.instantiate(module, {\n      wasi_snapshot_preview1: wasiBridge.wasiImport,\n    });\n\n    const exitCode = wasiBridge.start(instance as WebAssembly.Instance);\n    postWorkerMessage({\n      type: \"exit\",\n      code: exitCode,\n    });\n  } catch (error) {\n    postWorkerMessage({\n      type: \"error\",\n      message: error instanceof Error ? error.message : String(error),\n    });\n  }\n}\n\nfunction postWorkerMessage(\n  message: WasmSceneWorkerResponse\n): void {\n  globalThis.postMessage(message);\n}\n"],"mappings":"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"}

package/dist/wasi.d.ts

@@ -4,5 +4,6 @@ import { JSPIConstructors, WasmEngineCapabilities, WasmEngineFamily, WasmEngineP
 import { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink } from "./src/wasi/BrowserWASIBridge.js";
 import { SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, createSharedInputQueue, hydrateSharedInputQueue, sharedInputQueueDefaultCapacity } from "./src/wasi/SharedInputQueue.js";
 import { MainThreadWasmExecutor, MainThreadWasmExecutorOptions } from "./src/wasi/MainThreadWasmExecutor.js";
+import { MainThreadWasmPauseGate, PausableMonotonicClock, WorkerWasmPauseGate, createWasmPauseCell, installPausableClockTimeGet, isWasmPauseCellPaused, setWasmPauseCellPaused } from "./src/wasi/WasmRuntimePause.js";
 import { WasmExecutionMode, WasmExecutionModePreference, WasmSceneResizeEvent, WasmSceneRuntimeFactoryOptions, WasmSceneRuntimeHandle, createWasmSceneRuntimeFactory, resolveWasmExecutionMode } from "./src/wasi/WasmSceneRuntime.js";
-export { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink, JSPIConstructors, MainThreadWasmExecutor, MainThreadWasmExecutorOptions, SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, StdIOPipe, WasmEngineCapabilities, WasmEngineFamily, WasmEngineProbeSignals, WasmExecutionMode, WasmExecutionModePreference, WasmSceneResizeEvent, WasmSceneRuntimeFactoryOptions, WasmSceneRuntimeHandle, classifyWasmEngineFamily, collectWasmEngineProbeSignals, createSharedInputQueue, createWasmSceneRuntimeFactory, encodeRenderStyleControlMessage, encodeResizeControlMessage, hydrateSharedInputQueue, jspiConstructors, mainThreadStackProfileEnvironmentDefaults, resolveWasmEngineCapabilities, resolveWasmExecutionMode, sharedInputQueueDefaultCapacity, stackProfileEnvironmentDefaults };
+export { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink, JSPIConstructors, MainThreadWasmExecutor, MainThreadWasmExecutorOptions, MainThreadWasmPauseGate, PausableMonotonicClock, SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, StdIOPipe, WasmEngineCapabilities, WasmEngineFamily, WasmEngineProbeSignals, WasmExecutionMode, WasmExecutionModePreference, WasmSceneResizeEvent, WasmSceneRuntimeFactoryOptions, WasmSceneRuntimeHandle, WorkerWasmPauseGate, classifyWasmEngineFamily, collectWasmEngineProbeSignals, createSharedInputQueue, createWasmPauseCell, createWasmSceneRuntimeFactory, encodeRenderStyleControlMessage, encodeResizeControlMessage, hydrateSharedInputQueue, installPausableClockTimeGet, isWasmPauseCellPaused, jspiConstructors, mainThreadStackProfileEnvironmentDefaults, resolveWasmEngineCapabilities, resolveWasmExecutionMode, setWasmPauseCellPaused, sharedInputQueueDefaultCapacity, stackProfileEnvironmentDefaults };

package/dist/wasi.js

@@ -2,7 +2,8 @@ import { StdIOPipe } from "./src/wasi/StdIOPipe.js";
 import { classifyWasmEngineFamily, collectWasmEngineProbeSignals, jspiConstructors, mainThreadStackProfileEnvironmentDefaults, resolveWasmEngineCapabilities, stackProfileEnvironmentDefaults } from "./src/wasi/WasmEngineCapabilities.js";
 import { encodeRenderStyleControlMessage, encodeResizeControlMessage } from "./src/WebHostSurfaceTransport.js";
 import { BrowserWASIBridge } from "./src/wasi/BrowserWASIBridge.js";
+import { MainThreadWasmPauseGate, PausableMonotonicClock, WorkerWasmPauseGate, createWasmPauseCell, installPausableClockTimeGet, isWasmPauseCellPaused, setWasmPauseCellPaused } from "./src/wasi/WasmRuntimePause.js";
 import { MainThreadWasmExecutor } from "./src/wasi/MainThreadWasmExecutor.js";
 import { SharedInputQueueReader, SharedInputQueueWriter, createSharedInputQueue, hydrateSharedInputQueue, sharedInputQueueDefaultCapacity } from "./src/wasi/SharedInputQueue.js";
 import { createWasmSceneRuntimeFactory, resolveWasmExecutionMode } from "./src/wasi/WasmSceneRuntime.js";
-export { BrowserWASIBridge, MainThreadWasmExecutor, SharedInputQueueReader, SharedInputQueueWriter, StdIOPipe, classifyWasmEngineFamily, collectWasmEngineProbeSignals, createSharedInputQueue, createWasmSceneRuntimeFactory, encodeRenderStyleControlMessage, encodeResizeControlMessage, hydrateSharedInputQueue, jspiConstructors, mainThreadStackProfileEnvironmentDefaults, resolveWasmEngineCapabilities, resolveWasmExecutionMode, sharedInputQueueDefaultCapacity, stackProfileEnvironmentDefaults };
+export { BrowserWASIBridge, MainThreadWasmExecutor, MainThreadWasmPauseGate, PausableMonotonicClock, SharedInputQueueReader, SharedInputQueueWriter, StdIOPipe, WorkerWasmPauseGate, classifyWasmEngineFamily, collectWasmEngineProbeSignals, createSharedInputQueue, createWasmPauseCell, createWasmSceneRuntimeFactory, encodeRenderStyleControlMessage, encodeResizeControlMessage, hydrateSharedInputQueue, installPausableClockTimeGet, isWasmPauseCellPaused, jspiConstructors, mainThreadStackProfileEnvironmentDefaults, resolveWasmEngineCapabilities, resolveWasmExecutionMode, setWasmPauseCellPaused, sharedInputQueueDefaultCapacity, stackProfileEnvironmentDefaults };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swifttui/web",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "license": "MIT",
   "repository": {
     "type": "git",