@swifttui/web 0.1.12 → 0.1.13

package/dist/index.d.ts

@@ -3,8 +3,8 @@ import { SUPPORTED_SURFACE_VERSION, WebHostAccessibilityAnnouncement, WebHostAcc
 import { WebHostSceneDescriptor, WebHostSceneManifest, WebHostSceneManifestSource, loadWebHostSceneManifest, normalizeWebHostSceneManifest, webTUISceneManifestFromDescriptors, webTUISceneManifestToJSON } from "./src/WebHostSceneManifest.js";
 import { WebHostSceneBridge, WebHostSceneRuntime, WebHostSceneRuntimeOptions, WheelMode } from "./src/WebHostSceneRuntime.js";
 import { WebSocketSceneBridge, WebSocketSceneBridgeFactory, WebSocketSceneBridgeOptions, WebSocketSceneSocket, webSocketSceneURL } from "./src/WebSocketSceneBridge.js";
-import { WebHostAppController, WebHostAppOptions, WebHostBridgeFactory, WebHostBridgeFactoryOptions, WebHostEmbeddedHostConfig, createWebHostApp } from "./src/WebHostApp.js";
+import { WebHostAppController, WebHostAppOptions, WebHostBridgeFactory, WebHostBridgeFactoryOptions, WebHostEmbeddedHostConfig, WebHostVisibilityDocument, createWebHostApp } from "./src/WebHostApp.js";
 import { StdIOPipe } from "./src/wasi/StdIOPipe.js";
 import { JSPIConstructors, WasmEngineCapabilities, WasmEngineFamily, WasmEngineProbeSignals, classifyWasmEngineFamily, collectWasmEngineProbeSignals, jspiConstructors, mainThreadStackProfileEnvironmentDefaults, resolveWasmEngineCapabilities, stackProfileEnvironmentDefaults } from "./src/wasi/WasmEngineCapabilities.js";
 import { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink } from "./src/wasi/BrowserWASIBridge.js";
-export { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink, JSPIConstructors, ResolvedWebHostTerminalPalette, ResolvedWebHostTerminalStyle, SUPPORTED_SURFACE_VERSION, StdIOPipe, WasmEngineCapabilities, WasmEngineFamily, WasmEngineProbeSignals, WebHostANSIColors, WebHostAccessibilityAnnouncement, WebHostAccessibilityLiveRegion, WebHostAccessibilityNode, WebHostAccessibilityPoint, WebHostAppController, WebHostAppOptions, WebHostBridgeFactory, WebHostBridgeFactoryOptions, WebHostEmbeddedHostConfig, WebHostFocusPresentation, WebHostFocusSemantics, WebHostFrameDiagnosticRecord, WebHostKeyInput, WebHostMouseInput, WebHostOutputDecoder, WebHostOutputRecord, WebHostOutputSink, WebHostRuntimeIssue, WebHostSceneBridge, WebHostSceneDescriptor, WebHostSceneManifest, WebHostSceneManifestSource, WebHostSceneRuntime, WebHostSceneRuntimeOptions, WebHostScrollRegion, WebHostSurfaceCell, WebHostSurfaceDamage, WebHostSurfaceDamageRange, WebHostSurfaceDamageTextRow, WebHostSurfaceDeltaFrame, WebHostSurfaceDeltaRow, WebHostSurfaceFrame, WebHostSurfaceImage, WebHostSurfaceImageFormat, WebHostSurfaceLineStyle, WebHostSurfaceLinkRow, WebHostSurfaceLinkRun, WebHostSurfaceRect, WebHostSurfaceSize, WebHostSurfaceStyle, WebHostTerminalAppearance, WebHostTerminalCursorStyle, WebHostTerminalPalette, WebHostTerminalRenderStyle, WebHostTerminalStyle, WebHostTerminalTheme, WebSocketSceneBridge, WebSocketSceneBridgeFactory, WebSocketSceneBridgeOptions, WebSocketSceneSocket, WheelMode, applyWebHostTerminalStyle, classifyWasmEngineFamily, collectWasmEngineProbeSignals, createWebHostApp, decodeWebHostTerminalRenderStyleBase64, encodeKeyInputMessage, encodeMouseInputMessage, encodePasteInputMessage, encodeRenderStyleControlMessage, encodeResizeControlMessage, encodeWebHostTerminalRenderStyleBase64, jspiConstructors, loadWebHostSceneManifest, mainThreadStackProfileEnvironmentDefaults, mergeWebHostTerminalStyle, normalizeWebHostSceneManifest, normalizeWebHostTerminalStyle, resolveWasmEngineCapabilities, resolveWebHostTerminalRenderStyle, stackProfileEnvironmentDefaults, webSocketSceneURL, webTUISceneManifestFromDescriptors, webTUISceneManifestToJSON, webTUITerminalBackgroundColor };
+export { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink, JSPIConstructors, ResolvedWebHostTerminalPalette, ResolvedWebHostTerminalStyle, SUPPORTED_SURFACE_VERSION, StdIOPipe, WasmEngineCapabilities, WasmEngineFamily, WasmEngineProbeSignals, WebHostANSIColors, WebHostAccessibilityAnnouncement, WebHostAccessibilityLiveRegion, WebHostAccessibilityNode, WebHostAccessibilityPoint, WebHostAppController, WebHostAppOptions, WebHostBridgeFactory, WebHostBridgeFactoryOptions, WebHostEmbeddedHostConfig, WebHostFocusPresentation, WebHostFocusSemantics, WebHostFrameDiagnosticRecord, WebHostKeyInput, WebHostMouseInput, WebHostOutputDecoder, WebHostOutputRecord, WebHostOutputSink, WebHostRuntimeIssue, WebHostSceneBridge, WebHostSceneDescriptor, WebHostSceneManifest, WebHostSceneManifestSource, WebHostSceneRuntime, WebHostSceneRuntimeOptions, WebHostScrollRegion, WebHostSurfaceCell, WebHostSurfaceDamage, WebHostSurfaceDamageRange, WebHostSurfaceDamageTextRow, WebHostSurfaceDeltaFrame, WebHostSurfaceDeltaRow, WebHostSurfaceFrame, WebHostSurfaceImage, WebHostSurfaceImageFormat, WebHostSurfaceLineStyle, WebHostSurfaceLinkRow, WebHostSurfaceLinkRun, WebHostSurfaceRect, WebHostSurfaceSize, WebHostSurfaceStyle, WebHostTerminalAppearance, WebHostTerminalCursorStyle, WebHostTerminalPalette, WebHostTerminalRenderStyle, WebHostTerminalStyle, WebHostTerminalTheme, WebHostVisibilityDocument, WebSocketSceneBridge, WebSocketSceneBridgeFactory, WebSocketSceneBridgeOptions, WebSocketSceneSocket, WheelMode, applyWebHostTerminalStyle, classifyWasmEngineFamily, collectWasmEngineProbeSignals, createWebHostApp, decodeWebHostTerminalRenderStyleBase64, encodeKeyInputMessage, encodeMouseInputMessage, encodePasteInputMessage, encodeRenderStyleControlMessage, encodeResizeControlMessage, encodeWebHostTerminalRenderStyleBase64, jspiConstructors, loadWebHostSceneManifest, mainThreadStackProfileEnvironmentDefaults, mergeWebHostTerminalStyle, normalizeWebHostSceneManifest, normalizeWebHostTerminalStyle, resolveWasmEngineCapabilities, resolveWebHostTerminalRenderStyle, stackProfileEnvironmentDefaults, webSocketSceneURL, webTUISceneManifestFromDescriptors, webTUISceneManifestToJSON, webTUITerminalBackgroundColor };

package/dist/src/WebHostApp.d.ts

@@ -15,6 +15,16 @@ interface WebHostBridgeFactoryOptions {
   environment?: Record<string, string>;
 }
 type WebHostBridgeFactory = (options: WebHostBridgeFactoryOptions) => WebHostSceneBridge;
+/**
+ * The slice of `Document` the app controller needs to track page visibility.
+ * Injectable for tests and non-browser hosts; defaults to the global
+ * `document` when one exists.
+ */
+interface WebHostVisibilityDocument {
+  readonly hidden: boolean;
+  addEventListener(type: "visibilitychange", listener: () => void): void;
+  removeEventListener(type: "visibilitychange", listener: () => void): void;
+}
 interface WebHostAppOptions {
   mount: HTMLElement;
   manifest?: WebHostSceneManifestSource;
@@ -26,6 +36,15 @@ interface WebHostAppOptions {
   bridgeFactory?: WebHostBridgeFactory;
   createElement?: (tagName: string) => HTMLElement;
   sceneRuntimeFactory?: (options: WebHostSceneRuntimeOptions) => WebHostSceneRuntime;
+  /**
+   * Whether scenes that cannot be seen — background scenes after a switch,
+   * or every scene while the document is hidden — suspend their apps (run
+   * loop parked, monotonic clock frozen) instead of burning CPU. Forwarded to
+   * each scene runtime as `suspendWhenHidden`. Defaults to `true`.
+   */
+  suspendHiddenScenes?: boolean;
+  /** Visibility source override; defaults to the global `document`. */
+  visibilityDocument?: WebHostVisibilityDocument;
 }
 interface WebHostAppController {
   scenes: WebHostSceneDescriptor[];
@@ -36,5 +55,5 @@ interface WebHostAppController {
 }
 declare function createWebHostApp(options: WebHostAppOptions): Promise<WebHostAppController>;
 //#endregion
-export { WebHostAppController, WebHostAppOptions, WebHostBridgeFactory, WebHostBridgeFactoryOptions, WebHostEmbeddedHostConfig, createWebHostApp };
+export { WebHostAppController, WebHostAppOptions, WebHostBridgeFactory, WebHostBridgeFactoryOptions, WebHostEmbeddedHostConfig, WebHostVisibilityDocument, createWebHostApp };
 //# sourceMappingURL=WebHostApp.d.ts.map

package/dist/src/WebHostApp.js

@@ -15,7 +15,9 @@ async function createWebHostApp(options) {
 		bridgeFactory: options.bridgeFactory,
 		initialSceneId: options.initialSceneId,
 		createElement: options.createElement,
-		sceneRuntimeFactory: options.sceneRuntimeFactory ?? ((runtimeOptions) => new WebHostSceneRuntime(runtimeOptions))
+		sceneRuntimeFactory: options.sceneRuntimeFactory ?? ((runtimeOptions) => new WebHostSceneRuntime(runtimeOptions)),
+		suspendHiddenScenes: options.suspendHiddenScenes,
+		visibilityDocument: options.visibilityDocument ?? defaultVisibilityDocument()
 	});
 	await controller.initialize();
 	return controller;
@@ -32,6 +34,9 @@ var InternalWebHostAppController = class {
 	sceneRuntimeFactory;
 	runtimes = /* @__PURE__ */ new Map();
 	bridges = /* @__PURE__ */ new Map();
+	suspendHiddenScenes;
+	visibilityDocument;
+	detachVisibilityListener;
 	constructor(options) {
 		this.mount = options.mount;
 		this.style = normalizeWebHostTerminalStyle(options.style ?? {});
@@ -39,6 +44,8 @@ var InternalWebHostAppController = class {
 		this.embeddedHost = options.embeddedHost;
 		this.bridgeFactory = options.bridgeFactory;
 		this.sceneRuntimeFactory = options.sceneRuntimeFactory;
+		this.suspendHiddenScenes = options.suspendHiddenScenes;
+		this.visibilityDocument = options.visibilityDocument;
 		this.scenes = options.manifest.scenes;
 		this.selectedSceneId = options.initialSceneId && options.manifest.scenes.some((scene) => scene.id === options.initialSceneId) ? options.initialSceneId : options.manifest.scenes.find((scene) => scene.id === options.manifest.defaultSceneId)?.id ?? options.manifest.defaultSceneId;
 		this.sceneRoot = (options.createElement ?? defaultCreateElement)("div");
@@ -47,6 +54,7 @@ var InternalWebHostAppController = class {
 		this.applyHostFrameStyle();
 	}
 	async initialize() {
+		this.installVisibilityListener();
 		await this.ensureRuntime(this.selectedSceneId);
 		await this.switchScene(this.selectedSceneId);
 	}
@@ -63,12 +71,26 @@ var InternalWebHostAppController = class {
 		this.applyHostFrameStyle();
 	}
 	async dispose() {
+		this.detachVisibilityListener?.();
+		this.detachVisibilityListener = void 0;
 		for (const runtime of this.runtimes.values()) runtime.dispose();
 		for (const bridge of this.bridges.values()) bridge.dispose();
 		this.runtimes.clear();
 		this.bridges.clear();
 		this.mount.replaceChildren();
 	}
+	installVisibilityListener() {
+		const visibilityDocument = this.visibilityDocument;
+		if (!visibilityDocument) return;
+		const listener = () => {
+			const visible = !visibilityDocument.hidden;
+			for (const runtime of this.runtimes.values()) runtime.setDocumentVisible(visible);
+		};
+		visibilityDocument.addEventListener("visibilitychange", listener);
+		this.detachVisibilityListener = () => {
+			visibilityDocument.removeEventListener("visibilitychange", listener);
+		};
+	}
 	async ensureRuntime(id) {
 		const existing = this.runtimes.get(id);
 		if (existing) return existing;
@@ -80,12 +102,14 @@ var InternalWebHostAppController = class {
 			descriptor,
 			style: this.style,
 			bridge,
-			onInput: (chunk) => bridge.sendInput(chunk)
+			onInput: (chunk) => bridge.sendInput(chunk),
+			suspendWhenHidden: this.suspendHiddenScenes
 		});
 		this.bridges.set(id, bridge);
 		this.runtimes.set(id, runtime);
 		await runtime.mount();
 		runtime.setVisible(id === this.selectedSceneId);
+		if (this.visibilityDocument) runtime.setDocumentVisible(!this.visibilityDocument.hidden);
 		return runtime;
 	}
 	makeBridge(sceneId, descriptor) {
@@ -116,6 +140,10 @@ var InternalWebHostAppController = class {
 		this.mount.style.padding = "1rem";
 	}
 };
+function defaultVisibilityDocument() {
+	if (typeof document === "undefined") return;
+	return document;
+}
 function defaultCreateElement(tagName) {
 	if (typeof document === "undefined") throw new Error("document is not available");
 	return document.createElement(tagName);

package/dist/src/WebHostApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebHostApp.js","names":[],"sources":["../../src/WebHostApp.ts"],"sourcesContent":["import { BrowserWASIBridge } from \"./wasi/BrowserWASIBridge.ts\";\nimport {\n  WebSocketSceneBridge,\n  type WebSocketSceneBridgeOptions,\n} from \"./WebSocketSceneBridge.ts\";\nimport {\n  loadWebHostSceneManifest,\n  normalizeWebHostSceneManifest,\n  type WebHostSceneDescriptor,\n  type WebHostSceneManifest,\n  type WebHostSceneManifestSource,\n} from \"./WebHostSceneManifest.ts\";\nimport {\n  mergeWebHostTerminalStyle,\n  normalizeWebHostTerminalStyle,\n  type ResolvedWebHostTerminalStyle,\n  type WebHostTerminalStyle,\n} from \"./WebHostTerminalStyle.ts\";\nimport {\n  WebHostSceneRuntime,\n  type WebHostSceneBridge,\n  type WebHostSceneRuntimeOptions,\n} from \"./WebHostSceneRuntime.ts\";\n\nexport interface WebHostEmbeddedHostConfig {\n  token: string;\n  webSocketBaseURL?: string | URL;\n  webSocketFactory?: WebSocketSceneBridgeOptions[\"webSocketFactory\"];\n}\n\nexport interface WebHostBridgeFactoryOptions {\n  sceneId: string;\n  descriptor: WebHostSceneDescriptor;\n  style: WebHostTerminalStyle;\n  environment?: Record<string, string>;\n}\n\nexport type WebHostBridgeFactory = (options: WebHostBridgeFactoryOptions) => WebHostSceneBridge;\n\nexport interface WebHostAppOptions {\n  mount: HTMLElement;\n  manifest?: WebHostSceneManifestSource;\n  manifestUrl?: string | URL;\n  initialSceneId?: string;\n  style?: WebHostTerminalStyle;\n  environment?: Record<string, string>;\n  embeddedHost?: WebHostEmbeddedHostConfig;\n  bridgeFactory?: WebHostBridgeFactory;\n  createElement?: (tagName: string) => HTMLElement;\n  sceneRuntimeFactory?: (options: WebHostSceneRuntimeOptions) => WebHostSceneRuntime;\n}\n\nexport interface WebHostAppController {\n  scenes: WebHostSceneDescriptor[];\n  selectedSceneId: string;\n  switchScene(id: string): Promise<void>;\n  setStyle(style: WebHostTerminalStyle): void;\n  dispose(): Promise<void>;\n}\n\ntype RuntimeFactory = (options: WebHostSceneRuntimeOptions) => WebHostSceneRuntime;\n\nexport async function createWebHostApp(\n  options: WebHostAppOptions\n): Promise<WebHostAppController> {\n  const manifest = await resolveManifest(options);\n  const controller = new InternalWebHostAppController({\n    mount: options.mount,\n    manifest,\n    style: options.style,\n    environment: options.environment,\n    embeddedHost: options.embeddedHost,\n    bridgeFactory: options.bridgeFactory,\n    initialSceneId: options.initialSceneId,\n    createElement: options.createElement,\n    sceneRuntimeFactory: options.sceneRuntimeFactory ?? ((runtimeOptions) => new WebHostSceneRuntime(runtimeOptions)),\n  });\n  await controller.initialize();\n  return controller;\n}\n\nclass InternalWebHostAppController implements WebHostAppController {\n  readonly scenes: WebHostSceneDescriptor[];\n  selectedSceneId: string;\n\n  private readonly mount: HTMLElement;\n  private readonly sceneRoot: HTMLElement;\n  private style: ResolvedWebHostTerminalStyle;\n  private readonly environment?: Record<string, string>;\n  private readonly embeddedHost?: WebHostEmbeddedHostConfig;\n  private readonly bridgeFactory?: WebHostBridgeFactory;\n  private readonly sceneRuntimeFactory: RuntimeFactory;\n  private readonly runtimes = new Map<string, WebHostSceneRuntime>();\n  private readonly bridges = new Map<string, WebHostSceneBridge>();\n\n  constructor(options: {\n    mount: HTMLElement;\n    manifest: WebHostSceneManifest;\n    style?: WebHostTerminalStyle;\n    environment?: Record<string, string>;\n    embeddedHost?: WebHostEmbeddedHostConfig;\n    bridgeFactory?: WebHostBridgeFactory;\n    initialSceneId?: string;\n    createElement?: (tagName: string) => HTMLElement;\n    sceneRuntimeFactory: RuntimeFactory;\n  }) {\n    this.mount = options.mount;\n    this.style = normalizeWebHostTerminalStyle(options.style ?? {});\n    this.environment = options.environment;\n    this.embeddedHost = options.embeddedHost;\n    this.bridgeFactory = options.bridgeFactory;\n    this.sceneRuntimeFactory = options.sceneRuntimeFactory;\n    this.scenes = options.manifest.scenes;\n    this.selectedSceneId =\n      options.initialSceneId &&\n      options.manifest.scenes.some((scene) => scene.id === options.initialSceneId)\n        ? options.initialSceneId\n        : options.manifest.scenes.find((scene) => scene.id === options.manifest.defaultSceneId)?.id ??\n          options.manifest.defaultSceneId;\n\n    this.sceneRoot = (options.createElement ?? defaultCreateElement)(\"div\");\n    this.sceneRoot.className = \"webhost-scene-root\";\n    this.mount.replaceChildren(this.sceneRoot);\n    this.applyHostFrameStyle();\n  }\n\n  async initialize(): Promise<void> {\n    await this.ensureRuntime(this.selectedSceneId);\n    await this.switchScene(this.selectedSceneId);\n  }\n\n  async switchScene(\n    id: string\n  ): Promise<void> {\n    const descriptor = this.scenes.find((scene) => scene.id === id);\n    if (!descriptor) {\n      throw new Error(`Unknown scene: ${id}`);\n    }\n\n    for (const [sceneId, runtime] of this.runtimes) {\n      runtime.setVisible(sceneId === id);\n    }\n\n    const runtime = await this.ensureRuntime(id);\n    runtime.setVisible(true);\n    this.selectedSceneId = id;\n  }\n\n  setStyle(\n    style: WebHostTerminalStyle\n  ): void {\n    const merged = mergeWebHostTerminalStyle(this.style, style);\n    this.style = merged;\n\n    for (const runtime of this.runtimes.values()) {\n      runtime.setStyle(this.style);\n    }\n    this.applyHostFrameStyle();\n  }\n\n  async dispose(): Promise<void> {\n    for (const runtime of this.runtimes.values()) {\n      runtime.dispose();\n    }\n    for (const bridge of this.bridges.values()) {\n      bridge.dispose();\n    }\n    this.runtimes.clear();\n    this.bridges.clear();\n    this.mount.replaceChildren();\n  }\n\n  private async ensureRuntime(\n    id: string\n  ): Promise<WebHostSceneRuntime> {\n    const existing = this.runtimes.get(id);\n    if (existing) {\n      return existing;\n    }\n\n    const descriptor = this.scenes.find((scene) => scene.id === id);\n    if (!descriptor) {\n      throw new Error(`Unknown scene: ${id}`);\n    }\n\n    const bridge = this.makeBridge(id, descriptor);\n    const runtime = this.sceneRuntimeFactory({\n      mount: this.sceneRoot,\n      descriptor,\n      style: this.style,\n      bridge,\n      onInput: (chunk) => bridge.sendInput(chunk),\n    });\n\n    this.bridges.set(id, bridge);\n    this.runtimes.set(id, runtime);\n    await runtime.mount();\n    runtime.setVisible(id === this.selectedSceneId);\n    return runtime;\n  }\n\n  private makeBridge(\n    sceneId: string,\n    descriptor: WebHostSceneDescriptor\n  ): WebHostSceneBridge {\n    if (this.bridgeFactory) {\n      return this.bridgeFactory({\n        sceneId,\n        descriptor,\n        style: this.style,\n        environment: this.environment,\n      });\n    }\n\n    if (this.embeddedHost) {\n      return new WebSocketSceneBridge({\n        sceneId,\n        token: this.embeddedHost.token,\n        baseURL: this.embeddedHost.webSocketBaseURL,\n        webSocketFactory: this.embeddedHost.webSocketFactory,\n      });\n    }\n\n    return new BrowserWASIBridge({\n      sceneId,\n      columns: 80,\n      rows: 24,\n      environment: this.environment,\n      renderStyle: this.style,\n    });\n  }\n\n  private applyHostFrameStyle(): void {\n    this.mount.style.background = \"linear-gradient(180deg, #0f172a 0%, #111827 100%)\";\n    this.mount.style.minHeight = \"100%\";\n    this.mount.style.display = \"block\";\n    this.mount.style.padding = \"1rem\";\n  }\n}\n\nfunction defaultCreateElement(\n  tagName: string\n): HTMLElement {\n  if (typeof document === \"undefined\") {\n    throw new Error(\"document is not available\");\n  }\n\n  return document.createElement(tagName);\n}\n\nasync function resolveManifest(\n  options: WebHostAppOptions\n): Promise<WebHostSceneManifest> {\n  if (options.manifest) {\n    return loadWebHostSceneManifest(options.manifest);\n  }\n\n  if (options.manifestUrl) {\n    return loadWebHostSceneManifest(options.manifestUrl);\n  }\n\n  return normalizeWebHostSceneManifest([\n    {\n      id: \"main\",\n      title: \"Main\",\n      isDefault: true,\n    },\n  ]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"WebHostApp.js","names":[],"sources":["../../src/WebHostApp.ts"],"sourcesContent":["import { BrowserWASIBridge } from \"./wasi/BrowserWASIBridge.ts\";\nimport {\n  WebSocketSceneBridge,\n  type WebSocketSceneBridgeOptions,\n} from \"./WebSocketSceneBridge.ts\";\nimport {\n  loadWebHostSceneManifest,\n  normalizeWebHostSceneManifest,\n  type WebHostSceneDescriptor,\n  type WebHostSceneManifest,\n  type WebHostSceneManifestSource,\n} from \"./WebHostSceneManifest.ts\";\nimport {\n  mergeWebHostTerminalStyle,\n  normalizeWebHostTerminalStyle,\n  type ResolvedWebHostTerminalStyle,\n  type WebHostTerminalStyle,\n} from \"./WebHostTerminalStyle.ts\";\nimport {\n  WebHostSceneRuntime,\n  type WebHostSceneBridge,\n  type WebHostSceneRuntimeOptions,\n} from \"./WebHostSceneRuntime.ts\";\n\nexport interface WebHostEmbeddedHostConfig {\n  token: string;\n  webSocketBaseURL?: string | URL;\n  webSocketFactory?: WebSocketSceneBridgeOptions[\"webSocketFactory\"];\n}\n\nexport interface WebHostBridgeFactoryOptions {\n  sceneId: string;\n  descriptor: WebHostSceneDescriptor;\n  style: WebHostTerminalStyle;\n  environment?: Record<string, string>;\n}\n\nexport type WebHostBridgeFactory = (options: WebHostBridgeFactoryOptions) => WebHostSceneBridge;\n\n/**\n * The slice of `Document` the app controller needs to track page visibility.\n * Injectable for tests and non-browser hosts; defaults to the global\n * `document` when one exists.\n */\nexport interface WebHostVisibilityDocument {\n  readonly hidden: boolean;\n  addEventListener(type: \"visibilitychange\", listener: () => void): void;\n  removeEventListener(type: \"visibilitychange\", listener: () => void): void;\n}\n\nexport interface WebHostAppOptions {\n  mount: HTMLElement;\n  manifest?: WebHostSceneManifestSource;\n  manifestUrl?: string | URL;\n  initialSceneId?: string;\n  style?: WebHostTerminalStyle;\n  environment?: Record<string, string>;\n  embeddedHost?: WebHostEmbeddedHostConfig;\n  bridgeFactory?: WebHostBridgeFactory;\n  createElement?: (tagName: string) => HTMLElement;\n  sceneRuntimeFactory?: (options: WebHostSceneRuntimeOptions) => WebHostSceneRuntime;\n  /**\n   * Whether scenes that cannot be seen — background scenes after a switch,\n   * or every scene while the document is hidden — suspend their apps (run\n   * loop parked, monotonic clock frozen) instead of burning CPU. Forwarded to\n   * each scene runtime as `suspendWhenHidden`. Defaults to `true`.\n   */\n  suspendHiddenScenes?: boolean;\n  /** Visibility source override; defaults to the global `document`. */\n  visibilityDocument?: WebHostVisibilityDocument;\n}\n\nexport interface WebHostAppController {\n  scenes: WebHostSceneDescriptor[];\n  selectedSceneId: string;\n  switchScene(id: string): Promise<void>;\n  setStyle(style: WebHostTerminalStyle): void;\n  dispose(): Promise<void>;\n}\n\ntype RuntimeFactory = (options: WebHostSceneRuntimeOptions) => WebHostSceneRuntime;\n\nexport async function createWebHostApp(\n  options: WebHostAppOptions\n): Promise<WebHostAppController> {\n  const manifest = await resolveManifest(options);\n  const controller = new InternalWebHostAppController({\n    mount: options.mount,\n    manifest,\n    style: options.style,\n    environment: options.environment,\n    embeddedHost: options.embeddedHost,\n    bridgeFactory: options.bridgeFactory,\n    initialSceneId: options.initialSceneId,\n    createElement: options.createElement,\n    sceneRuntimeFactory: options.sceneRuntimeFactory ?? ((runtimeOptions) => new WebHostSceneRuntime(runtimeOptions)),\n    suspendHiddenScenes: options.suspendHiddenScenes,\n    visibilityDocument: options.visibilityDocument ?? defaultVisibilityDocument(),\n  });\n  await controller.initialize();\n  return controller;\n}\n\nclass InternalWebHostAppController implements WebHostAppController {\n  readonly scenes: WebHostSceneDescriptor[];\n  selectedSceneId: string;\n\n  private readonly mount: HTMLElement;\n  private readonly sceneRoot: HTMLElement;\n  private style: ResolvedWebHostTerminalStyle;\n  private readonly environment?: Record<string, string>;\n  private readonly embeddedHost?: WebHostEmbeddedHostConfig;\n  private readonly bridgeFactory?: WebHostBridgeFactory;\n  private readonly sceneRuntimeFactory: RuntimeFactory;\n  private readonly runtimes = new Map<string, WebHostSceneRuntime>();\n  private readonly bridges = new Map<string, WebHostSceneBridge>();\n  private readonly suspendHiddenScenes?: boolean;\n  private readonly visibilityDocument?: WebHostVisibilityDocument;\n  private detachVisibilityListener?: () => void;\n\n  constructor(options: {\n    mount: HTMLElement;\n    manifest: WebHostSceneManifest;\n    style?: WebHostTerminalStyle;\n    environment?: Record<string, string>;\n    embeddedHost?: WebHostEmbeddedHostConfig;\n    bridgeFactory?: WebHostBridgeFactory;\n    initialSceneId?: string;\n    createElement?: (tagName: string) => HTMLElement;\n    sceneRuntimeFactory: RuntimeFactory;\n    suspendHiddenScenes?: boolean;\n    visibilityDocument?: WebHostVisibilityDocument;\n  }) {\n    this.mount = options.mount;\n    this.style = normalizeWebHostTerminalStyle(options.style ?? {});\n    this.environment = options.environment;\n    this.embeddedHost = options.embeddedHost;\n    this.bridgeFactory = options.bridgeFactory;\n    this.sceneRuntimeFactory = options.sceneRuntimeFactory;\n    this.suspendHiddenScenes = options.suspendHiddenScenes;\n    this.visibilityDocument = options.visibilityDocument;\n    this.scenes = options.manifest.scenes;\n    this.selectedSceneId =\n      options.initialSceneId &&\n      options.manifest.scenes.some((scene) => scene.id === options.initialSceneId)\n        ? options.initialSceneId\n        : options.manifest.scenes.find((scene) => scene.id === options.manifest.defaultSceneId)?.id ??\n          options.manifest.defaultSceneId;\n\n    this.sceneRoot = (options.createElement ?? defaultCreateElement)(\"div\");\n    this.sceneRoot.className = \"webhost-scene-root\";\n    this.mount.replaceChildren(this.sceneRoot);\n    this.applyHostFrameStyle();\n  }\n\n  async initialize(): Promise<void> {\n    this.installVisibilityListener();\n    await this.ensureRuntime(this.selectedSceneId);\n    await this.switchScene(this.selectedSceneId);\n  }\n\n  async switchScene(\n    id: string\n  ): Promise<void> {\n    const descriptor = this.scenes.find((scene) => scene.id === id);\n    if (!descriptor) {\n      throw new Error(`Unknown scene: ${id}`);\n    }\n\n    for (const [sceneId, runtime] of this.runtimes) {\n      runtime.setVisible(sceneId === id);\n    }\n\n    const runtime = await this.ensureRuntime(id);\n    runtime.setVisible(true);\n    this.selectedSceneId = id;\n  }\n\n  setStyle(\n    style: WebHostTerminalStyle\n  ): void {\n    const merged = mergeWebHostTerminalStyle(this.style, style);\n    this.style = merged;\n\n    for (const runtime of this.runtimes.values()) {\n      runtime.setStyle(this.style);\n    }\n    this.applyHostFrameStyle();\n  }\n\n  async dispose(): Promise<void> {\n    this.detachVisibilityListener?.();\n    this.detachVisibilityListener = undefined;\n    for (const runtime of this.runtimes.values()) {\n      runtime.dispose();\n    }\n    for (const bridge of this.bridges.values()) {\n      bridge.dispose();\n    }\n    this.runtimes.clear();\n    this.bridges.clear();\n    this.mount.replaceChildren();\n  }\n\n  private installVisibilityListener(): void {\n    const visibilityDocument = this.visibilityDocument;\n    if (!visibilityDocument) {\n      return;\n    }\n    const listener = (): void => {\n      const visible = !visibilityDocument.hidden;\n      for (const runtime of this.runtimes.values()) {\n        runtime.setDocumentVisible(visible);\n      }\n    };\n    visibilityDocument.addEventListener(\"visibilitychange\", listener);\n    this.detachVisibilityListener = () => {\n      visibilityDocument.removeEventListener(\"visibilitychange\", listener);\n    };\n  }\n\n  private async ensureRuntime(\n    id: string\n  ): Promise<WebHostSceneRuntime> {\n    const existing = this.runtimes.get(id);\n    if (existing) {\n      return existing;\n    }\n\n    const descriptor = this.scenes.find((scene) => scene.id === id);\n    if (!descriptor) {\n      throw new Error(`Unknown scene: ${id}`);\n    }\n\n    const bridge = this.makeBridge(id, descriptor);\n    const runtime = this.sceneRuntimeFactory({\n      mount: this.sceneRoot,\n      descriptor,\n      style: this.style,\n      bridge,\n      onInput: (chunk) => bridge.sendInput(chunk),\n      suspendWhenHidden: this.suspendHiddenScenes,\n    });\n\n    this.bridges.set(id, bridge);\n    this.runtimes.set(id, runtime);\n    await runtime.mount();\n    runtime.setVisible(id === this.selectedSceneId);\n    if (this.visibilityDocument) {\n      runtime.setDocumentVisible(!this.visibilityDocument.hidden);\n    }\n    return runtime;\n  }\n\n  private makeBridge(\n    sceneId: string,\n    descriptor: WebHostSceneDescriptor\n  ): WebHostSceneBridge {\n    if (this.bridgeFactory) {\n      return this.bridgeFactory({\n        sceneId,\n        descriptor,\n        style: this.style,\n        environment: this.environment,\n      });\n    }\n\n    if (this.embeddedHost) {\n      return new WebSocketSceneBridge({\n        sceneId,\n        token: this.embeddedHost.token,\n        baseURL: this.embeddedHost.webSocketBaseURL,\n        webSocketFactory: this.embeddedHost.webSocketFactory,\n      });\n    }\n\n    return new BrowserWASIBridge({\n      sceneId,\n      columns: 80,\n      rows: 24,\n      environment: this.environment,\n      renderStyle: this.style,\n    });\n  }\n\n  private applyHostFrameStyle(): void {\n    this.mount.style.background = \"linear-gradient(180deg, #0f172a 0%, #111827 100%)\";\n    this.mount.style.minHeight = \"100%\";\n    this.mount.style.display = \"block\";\n    this.mount.style.padding = \"1rem\";\n  }\n}\n\nfunction defaultVisibilityDocument(): WebHostVisibilityDocument | undefined {\n  if (typeof document === \"undefined\") {\n    return undefined;\n  }\n  return document;\n}\n\nfunction defaultCreateElement(\n  tagName: string\n): HTMLElement {\n  if (typeof document === \"undefined\") {\n    throw new Error(\"document is not available\");\n  }\n\n  return document.createElement(tagName);\n}\n\nasync function resolveManifest(\n  options: WebHostAppOptions\n): Promise<WebHostSceneManifest> {\n  if (options.manifest) {\n    return loadWebHostSceneManifest(options.manifest);\n  }\n\n  if (options.manifestUrl) {\n    return loadWebHostSceneManifest(options.manifestUrl);\n  }\n\n  return normalizeWebHostSceneManifest([\n    {\n      id: \"main\",\n      title: \"Main\",\n      isDefault: true,\n    },\n  ]);\n}\n"],"mappings":"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"}

package/dist/src/WebHostSceneRuntime.d.ts

@@ -45,6 +45,15 @@ interface WebHostSceneRuntimeOptions {
    * and other schemes are ignored. Mirrors the Android host's tap-to-open.
    */
   onOpenHyperlink?: (url: string) => void;
+  /**
+   * Whether to suspend the scene's app while it cannot be seen — when the
+   * scene is switched to the background (`setVisible(false)`) or the whole
+   * document is hidden (`setDocumentVisible(false)`). Suspension parks the
+   * app's run loop and freezes its monotonic clock, so a hidden scene costs
+   * no CPU and resumes exactly where it left off. Defaults to `true`; set
+   * `false` to let background scenes keep running (pre-suspension behavior).
+   */
+  suspendWhenHidden?: boolean;
 }
 type WheelMode = "capture" | "chain" | "passive";
 /**
@@ -82,9 +91,26 @@ declare class WebHostSceneRuntime {
   private pointerDownLinkTarget?;
   private lastSentResize?;
   private isVisible;
+  private documentVisible;
+  private runtimeSuspended;
+  private readonly suspendWhenHidden;
   constructor(options: WebHostSceneRuntimeOptions);
   mount(): Promise<void>;
   setVisible(visible: boolean): void;
+  /**
+   * Reports whether the surrounding document can be seen at all (browser tab
+   * visible, iframe on-screen, …). Combined with the scene-level
+   * `setVisible`: the app is suspended while either says hidden, unless
+   * `suspendWhenHidden` is `false`.
+   */
+  setDocumentVisible(visible: boolean): void;
+  private updateRuntimeSuspension;
+  /**
+   * Suspension hook for subclasses that own an app execution vehicle (the
+   * WASI worker / JSPI executor). The base runtime only presents frames, so
+   * it has nothing to suspend.
+   */
+  protected onRuntimeSuspensionChange(_suspended: boolean): void;
   setStyle(style: WebHostTerminalStyle): void;
   resize(columns: number, rows: number): void;
   writeOutput(text: string): void;

package/dist/src/WebHostSceneRuntime.js

@@ -49,6 +49,9 @@ var WebHostSceneRuntime = class {
 	pointerDownLinkTarget;
 	lastSentResize;
 	isVisible = false;
+	documentVisible = true;
+	runtimeSuspended = false;
+	suspendWhenHidden;
 	constructor(options) {
 		this.descriptor = options.descriptor;
 		this.currentStyle = normalizeWebHostTerminalStyle(options.style);
@@ -58,6 +61,7 @@ var WebHostSceneRuntime = class {
 		this.synchronizeAccessibilityFocus = options.synchronizeAccessibilityFocus ?? true;
 		this.wheelMode = options.wheelMode ?? legacyWheelMode(options.captureWheelInput);
 		this.onOpenHyperlink = options.onOpenHyperlink;
+		this.suspendWhenHidden = options.suspendWhenHidden ?? true;
 		this.element = document.createElement("section");
 		this.element.className = "webhost-scene";
 		this.element.dataset.sceneId = options.descriptor.id;
@@ -104,7 +108,30 @@ var WebHostSceneRuntime = class {
 			this.resizeToMount();
 			if (this.synchronizeAccessibilityFocus) this.terminalMount.focus?.({ preventScroll: true });
 		}
+		this.updateRuntimeSuspension();
 	}
+	/**
+	* Reports whether the surrounding document can be seen at all (browser tab
+	* visible, iframe on-screen, …). Combined with the scene-level
+	* `setVisible`: the app is suspended while either says hidden, unless
+	* `suspendWhenHidden` is `false`.
+	*/
+	setDocumentVisible(visible) {
+		this.documentVisible = visible;
+		this.updateRuntimeSuspension();
+	}
+	updateRuntimeSuspension() {
+		const suspended = this.suspendWhenHidden && (!this.isVisible || !this.documentVisible);
+		if (suspended === this.runtimeSuspended) return;
+		this.runtimeSuspended = suspended;
+		this.onRuntimeSuspensionChange(suspended);
+	}
+	/**
+	* Suspension hook for subclasses that own an app execution vehicle (the
+	* WASI worker / JSPI executor). The base runtime only presents frames, so
+	* it has nothing to suspend.
+	*/
+	onRuntimeSuspensionChange(_suspended) {}
 	setStyle(style) {
 		this.currentStyle = normalizeWebHostTerminalStyle(style);
 		this.applyStyle(this.currentStyle);

package/dist/src/WebHostSceneRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebHostSceneRuntime.js","names":[],"sources":["../../src/WebHostSceneRuntime.ts"],"sourcesContent":["import {\n  applyWebHostTerminalStyle,\n  normalizeWebHostTerminalStyle,\n  type ResolvedWebHostTerminalStyle,\n  type WebHostTerminalStyle,\n  webTUITerminalBackgroundColor,\n} from \"./WebHostTerminalStyle.ts\";\nimport {\n  CanvasSurfacePainter,\n  fontForStyle,\n  type CanvasSurfaceMetrics,\n} from \"./CanvasSurfacePainter.ts\";\nimport {\n  InputEventEncoder,\n  type CellLocation,\n  type PointerButton,\n} from \"./InputEventEncoder.ts\";\nimport {\n  cellLocationForEvent,\n  linkTargetAt,\n  rawCellLocationForEvent,\n  wheelTargetCanScroll,\n  type PointerGeometryMetrics,\n} from \"./PointerGeometry.ts\";\nimport { AccessibilityTreeMounter } from \"./AccessibilityTree.ts\";\nimport {\n  type WebHostFocusPresentation,\n  type WebHostFrameDiagnosticRecord,\n  type WebHostOutputSink,\n  type WebHostRuntimeIssue,\n  type WebHostSurfaceDamage,\n  type WebHostSurfaceFrame,\n} from \"./WebHostSurfaceTransport.ts\";\nimport type { WebHostSceneDescriptor } from \"./WebHostSceneManifest.ts\";\n\nexport interface WebHostSceneBridge {\n  bindOutput(sink: WebHostOutputSink): void;\n  resize(columns: number, rows: number, cellWidth?: number, cellHeight?: number): void;\n  updateRenderStyle(style: WebHostTerminalStyle): void;\n  sendInput(chunk: Uint8Array): void;\n  dispose(): void;\n}\n\nexport interface WebHostSceneRuntimeOptions {\n  mount: HTMLElement;\n  descriptor: WebHostSceneDescriptor;\n  style: WebHostTerminalStyle;\n  bridge?: WebHostSceneBridge;\n  onInput(chunk: Uint8Array): void;\n  onFrameDiagnostic?: (diagnostic: WebHostFrameDiagnosticRecord) => void;\n  synchronizeAccessibilityFocus?: boolean;\n  /**\n   * How the embedded view treats mouse-wheel input.\n   * - `\"chain\"` (default): forward the wheel only while a scrollable region\n   *   under the pointer can still scroll in that direction; otherwise let it\n   *   fall through so the page (or parent iframe) scrolls — iframe-like nested\n   *   scrolling. A scene with no `ScrollView` never traps the wheel. Uses the\n   *   `scrollRegions` the app publishes in its frames.\n   * - `\"capture\"`: always forward the wheel to the app while the pointer is over\n   *   the surface (and `preventDefault` page scroll). Best for full-screen apps\n   *   where there is no page to scroll past.\n   * - `\"passive\"`: never capture; the page always scrolls.\n   *\n   * Takes precedence over the legacy `captureWheelInput` flag.\n   */\n  wheelMode?: WheelMode;\n  /**\n   * Legacy boolean wheel gate. `true` → `\"capture\"`, `false` → `\"passive\"`.\n   * Prefer `wheelMode`. Ignored when `wheelMode` is set. When neither is set the\n   * mode defaults to `\"chain\"`.\n   */\n  captureWheelInput?: boolean;\n  /**\n   * Called when the user clicks a hyperlink cell (a click is a pointer-down\n   * and pointer-up over the same link target). When unset, `http(s)` targets\n   * open in a new tab via `window.open(url, \"_blank\", \"noopener,noreferrer\")`\n   * and other schemes are ignored. Mirrors the Android host's tap-to-open.\n   */\n  onOpenHyperlink?: (url: string) => void;\n}\n\nexport type WheelMode = \"capture\" | \"chain\" | \"passive\";\n\n/**\n * Resolves the legacy `captureWheelInput` flag to a {@link WheelMode}. When the\n * flag is unset the mode defaults to `\"chain\"`, so embeds never trap a visitor\n * who is merely scrolling past the view; `true` maps to `\"capture\"` and `false`\n * to `\"passive\"` to preserve the old boolean behavior.\n */\nfunction legacyWheelMode(captureWheelInput: boolean | undefined): WheelMode {\n  if (captureWheelInput === undefined) {\n    return \"chain\";\n  }\n  return captureWheelInput ? \"capture\" : \"passive\";\n}\n\n/**\n * Coordinates a single SwiftTUI scene's browser presentation: it owns the DOM\n * mount, canvas, accessibility tree, and bridge wiring, and delegates the heavy\n * responsibilities to focused collaborators — {@link CanvasSurfacePainter} for\n * canvas drawing, {@link InputEventEncoder} for wire-message encoding, and the\n * {@link PointerGeometry} helpers for pixel→cell hit-testing and wheel chaining.\n */\nexport class WebHostSceneRuntime {\n  readonly descriptor: WebHostSceneDescriptor;\n  readonly element: HTMLElement;\n  readonly terminalMount: HTMLElement;\n\n  private readonly bridge?: WebHostSceneBridge;\n  private readonly onInput: (chunk: Uint8Array) => void;\n  private readonly onFrameDiagnostic?: (diagnostic: WebHostFrameDiagnosticRecord) => void;\n  private readonly synchronizeAccessibilityFocus: boolean;\n  private readonly wheelMode: WheelMode;\n  private readonly painter = new CanvasSurfacePainter();\n  private readonly inputEncoder = new InputEventEncoder();\n  private currentStyle: ResolvedWebHostTerminalStyle;\n  private canvas?: HTMLCanvasElement;\n  private accessibilityTree?: AccessibilityTreeMounter;\n  private diagnosticText?: HTMLElement;\n  private resizeObserver?: ResizeObserver;\n  private detachInputHandlers?: () => void;\n  private currentFrame?: WebHostSurfaceFrame;\n  private columns = 80;\n  private rows = 24;\n  private cellWidth = 8;\n  private cellHeight = 18;\n  private activePointerButton: PointerButton = \"primary\";\n  private hasCapturedPointer = false;\n  private readonly onOpenHyperlink?: (url: string) => void;\n  private pointerDownLinkTarget?: string;\n  private lastSentResize?: {\n    columns: number;\n    rows: number;\n    cellWidth: number;\n    cellHeight: number;\n  };\n  private isVisible = false;\n\n  constructor(options: WebHostSceneRuntimeOptions) {\n    this.descriptor = options.descriptor;\n    this.currentStyle = normalizeWebHostTerminalStyle(options.style);\n    this.bridge = options.bridge;\n    this.onInput = options.onInput;\n    this.onFrameDiagnostic = options.onFrameDiagnostic;\n    this.synchronizeAccessibilityFocus = options.synchronizeAccessibilityFocus ?? true;\n    this.wheelMode = options.wheelMode ?? legacyWheelMode(options.captureWheelInput);\n    this.onOpenHyperlink = options.onOpenHyperlink;\n    this.element = document.createElement(\"section\");\n    this.element.className = \"webhost-scene\";\n    this.element.dataset.sceneId = options.descriptor.id;\n    this.element.hidden = true;\n\n    const header = document.createElement(\"div\");\n    header.className = \"webhost-scene__header\";\n    header.textContent = options.descriptor.title ?? options.descriptor.id;\n\n    this.terminalMount = document.createElement(\"div\");\n    this.terminalMount.className = \"webhost-scene__terminal\";\n    this.terminalMount.tabIndex = 0;\n\n    this.element.append(header, this.terminalMount);\n    options.mount.appendChild(this.element);\n    this.applyVisibility();\n  }\n\n  async mount(): Promise<void> {\n    if (this.canvas) {\n      return;\n    }\n\n    const canvas = document.createElement(\"canvas\");\n    canvas.className = \"webhost-scene__surface\";\n    canvas.setAttribute(\"aria-hidden\", \"true\");\n    this.canvas = canvas;\n    this.painter.attach(canvas, () => this.draw());\n    this.accessibilityTree = new AccessibilityTreeMounter();\n    this.terminalMount.replaceChildren(\n      canvas,\n      this.accessibilityTree.element,\n      this.accessibilityTree.announcerElement\n    );\n    this.installInputHandlers();\n    this.installResizeObserver();\n\n    this.bridge?.bindOutput({\n      presentSurface: (frame) => this.presentSurface(frame),\n      writeClipboard: (text) => this.writeClipboard(text),\n      notifyRuntimeIssue: (issue) => this.notifyRuntimeIssue(issue),\n      recordFrameDiagnostic: (diagnostic) => this.recordFrameDiagnostic(diagnostic),\n      writeOutput: (text) => this.writeOutput(text),\n      writeError: (text) => this.writeOutput(text),\n    });\n\n    this.applyStyle(this.currentStyle);\n    this.measureCells();\n    this.resizeToMount();\n    this.draw();\n    this.syncAccessibilityTree();\n  }\n\n  setVisible(\n    visible: boolean\n  ): void {\n    this.isVisible = visible;\n    this.applyVisibility();\n    if (visible) {\n      this.resizeToMount();\n      if (this.synchronizeAccessibilityFocus) {\n        this.terminalMount.focus?.({ preventScroll: true });\n      }\n    }\n  }\n\n  setStyle(\n    style: WebHostTerminalStyle\n  ): void {\n    this.currentStyle = normalizeWebHostTerminalStyle(style);\n    this.applyStyle(this.currentStyle);\n    this.bridge?.updateRenderStyle(this.currentStyle);\n    this.measureCells();\n    this.resizeToMount();\n    this.draw();\n    this.syncAccessibilityTree();\n  }\n\n  resize(\n    columns: number,\n    rows: number\n  ): void {\n    this.columns = Math.max(1, Math.round(columns));\n    this.rows = Math.max(1, Math.round(rows));\n    this.resizeCanvas();\n    this.draw();\n    this.syncAccessibilityTree();\n  }\n\n  writeOutput(\n    text: string\n  ): void {\n    if (!this.diagnosticText) {\n      const diagnosticText = document.createElement(\"pre\");\n      diagnosticText.className = \"webhost-scene__diagnostic\";\n      this.diagnosticText = diagnosticText;\n      this.terminalMount.appendChild(diagnosticText);\n    }\n    this.diagnosticText.textContent = `${this.diagnosticText.textContent ?? \"\"}${text}`;\n  }\n\n  notifyRuntimeIssue(\n    issue: WebHostRuntimeIssue\n  ): void {\n    console.log(issue.description);\n  }\n\n  private recordFrameDiagnostic(\n    diagnostic: WebHostFrameDiagnosticRecord\n  ): void {\n    this.onFrameDiagnostic?.(diagnostic);\n  }\n\n  async writeClipboard(\n    text: string\n  ): Promise<void> {\n    const clipboard = globalThis.navigator?.clipboard;\n    if (!clipboard?.writeText) {\n      return;\n    }\n\n    try {\n      await clipboard.writeText(text);\n    } catch {\n      // Clipboard permissions are browser/user-gesture dependent; hosts treat\n      // rejection as a best-effort no-op rather than surfacing diagnostics.\n    }\n  }\n\n  sendInput(\n    chunk: Uint8Array\n  ): void {\n    this.onInput(chunk);\n  }\n\n  dispose(): void {\n    this.detachInputHandlers?.();\n    this.resizeObserver?.disconnect();\n    this.element.remove();\n  }\n\n  private presentSurface(\n    frame: WebHostSurfaceFrame\n  ): void {\n    const previousFrame = this.currentFrame;\n    this.currentFrame = frame;\n    this.columns = Math.max(1, Math.round(frame.width));\n    this.rows = Math.max(1, Math.round(frame.height));\n    const resized = this.resizeCanvas();\n    this.draw(previousFrame && !resized ? frame.damage : undefined);\n    this.syncAccessibilityTree();\n  }\n\n  /**\n   * The current frame's preferred grid size in cells, when the app published\n   * one — the measured pre-minimum content size, for embedders negotiating\n   * with an outer layout system (the Android host's preferred columns/rows).\n   */\n  get preferredGridSize(): { width: number; height: number } | undefined {\n    const frame = this.currentFrame;\n    if (frame?.preferredGridWidth === undefined || frame.preferredGridHeight === undefined) {\n      return undefined;\n    }\n    return { width: frame.preferredGridWidth, height: frame.preferredGridHeight };\n  }\n\n  /**\n   * The current frame's settled focus presentation, when the app published\n   * one. `prefersTextInput` is what the Android host uses to gate its IME;\n   * embedders can drive virtual-keyboard or focus affordances from it.\n   */\n  get focusPresentation(): WebHostFocusPresentation | undefined {\n    return this.currentFrame?.focusPresentation;\n  }\n\n  private linkTarget(\n    location: CellLocation\n  ): string | undefined {\n    return linkTargetAt(\n      this.currentFrame?.links,\n      this.currentFrame?.linkTargets,\n      location\n    );\n  }\n\n  private openHyperlink(\n    url: string\n  ): void {\n    if (this.onOpenHyperlink) {\n      this.onOpenHyperlink(url);\n      return;\n    }\n    // Defense in depth on top of the app-side OSC-8 destination sanitization:\n    // the default handler only opens web schemes.\n    if (!/^https?:/i.test(url)) {\n      return;\n    }\n    window.open(url, \"_blank\", \"noopener,noreferrer\");\n  }\n\n  private applyStyle(\n    style: WebHostTerminalStyle\n  ): void {\n    applyWebHostTerminalStyle(this.element, style);\n    this.element.style.padding = \"0.75rem\";\n    this.element.style.borderRadius = \"16px\";\n    this.element.style.boxShadow = \"0 20px 50px rgba(0, 0, 0, 0.28)\";\n    this.element.style.overflow = \"hidden\";\n    this.element.style.gap = \"0.5rem\";\n    this.element.style.gridTemplateRows = \"auto 1fr\";\n\n    this.terminalMount.style.position = \"relative\";\n    this.terminalMount.style.overflow = \"hidden\";\n    // Keep a captured wheel from rubber-banding/chaining the page; the wheel\n    // capture vs. fall-through decision lives in handleWheel.\n    this.terminalMount.style.overscrollBehavior = \"contain\";\n    this.terminalMount.style.outline = \"none\";\n    this.terminalMount.style.background = webTUITerminalBackgroundColor(this.currentStyle);\n    this.terminalMount.style.minHeight = `${this.cellHeight * 8}px`;\n\n    if (this.canvas) {\n      this.canvas.style.display = \"block\";\n      this.canvas.style.width = \"100%\";\n      this.canvas.style.height = \"100%\";\n    }\n  }\n\n  private applyVisibility(): void {\n    this.element.hidden = !this.isVisible;\n    this.element.style.setProperty(\n      \"display\",\n      this.isVisible ? \"grid\" : \"none\",\n      \"important\"\n    );\n  }\n\n  private installResizeObserver(): void {\n    if (typeof ResizeObserver === \"undefined\") {\n      return;\n    }\n\n    this.resizeObserver = new ResizeObserver(() => {\n      this.resizeToMount();\n    });\n    this.resizeObserver.observe(this.terminalMount);\n  }\n\n  private installInputHandlers(): void {\n    const handleKeyDown = (event: KeyboardEvent) => {\n      if (event.metaKey || event.isComposing) {\n        return;\n      }\n      const message = this.inputEncoder.encodeKey(event);\n      if (!message) {\n        return;\n      }\n\n      this.onInput(message);\n      event.preventDefault();\n    };\n\n    const handlePaste = (event: ClipboardEvent) => {\n      const text = event.clipboardData?.getData(\"text/plain\") ?? \"\";\n      if (!text) {\n        return;\n      }\n      this.onInput(this.inputEncoder.encodePaste(text));\n      event.preventDefault();\n    };\n\n    const handlePointerDown = (event: PointerEvent) => {\n      const location = this.cellLocation(event);\n      if (!location) {\n        return;\n      }\n\n      const button = this.inputEncoder.pointerButton(event.button);\n      this.activePointerButton = button;\n      this.hasCapturedPointer = true;\n      this.pointerDownLinkTarget = button === \"primary\"\n        ? this.linkTarget(location)\n        : undefined;\n      this.terminalMount.focus?.({ preventScroll: true });\n      this.terminalMount.setPointerCapture?.(event.pointerId);\n      this.onInput(this.inputEncoder.encodePointerDown(location, button, event));\n      event.preventDefault();\n    };\n\n    const handlePointerUp = (event: PointerEvent) => {\n      const location = this.hasCapturedPointer\n        ? this.rawCellLocation(event)\n        : this.cellLocation(event);\n      this.terminalMount.releasePointerCapture?.(event.pointerId);\n      this.hasCapturedPointer = false;\n      const downLinkTarget = this.pointerDownLinkTarget;\n      this.pointerDownLinkTarget = undefined;\n      if (!location) {\n        return;\n      }\n\n      const button = this.inputEncoder.pointerButton(event.button) ?? this.activePointerButton;\n      this.onInput(this.inputEncoder.encodePointerUp(location, button, event));\n      // A click — down and up over the same link target — opens the link,\n      // mirroring the Android host's tap-to-open. The app still receives the\n      // pointer messages above.\n      if (downLinkTarget !== undefined && this.linkTarget(location) === downLinkTarget) {\n        this.openHyperlink(downLinkTarget);\n      }\n      event.preventDefault();\n    };\n\n    const handlePointerMove = (event: PointerEvent) => {\n      const location = event.buttons && this.hasCapturedPointer\n        ? this.rawCellLocation(event)\n        : this.cellLocation(event);\n      if (!location) {\n        return;\n      }\n\n      if (!this.hasCapturedPointer) {\n        this.terminalMount.style.cursor =\n          this.linkTarget(location) !== undefined ? \"pointer\" : \"\";\n      }\n      this.onInput(this.inputEncoder.encodePointerMove(location, this.activePointerButton, event));\n    };\n\n    const handleWheel = (event: WheelEvent) => {\n      if (this.wheelMode === \"passive\") {\n        return;\n      }\n\n      const location = this.cellLocation(event);\n      if (!location) {\n        // Pointer is outside the cell grid (sub-cell margin / gutter). Don't\n        // capture — let the wheel fall through to the page.\n        return;\n      }\n\n      // In \"chain\" mode, capture only while a scrollable region under the\n      // pointer can still move in this direction; otherwise let the wheel fall\n      // through so the page (or parent iframe) scrolls — iframe-like behavior.\n      // \"capture\" mode always forwards while over the surface (legacy).\n      if (this.wheelMode === \"chain\"\n        && !wheelTargetCanScroll(this.currentFrame?.scrollRegions, location, event.deltaX, event.deltaY)) {\n        return;\n      }\n\n      this.onInput(this.inputEncoder.encodeWheel(location, event));\n      event.preventDefault();\n    };\n\n    this.terminalMount.addEventListener(\"keydown\", handleKeyDown);\n    this.terminalMount.addEventListener(\"paste\", handlePaste);\n    this.terminalMount.addEventListener(\"pointerdown\", handlePointerDown);\n    this.terminalMount.addEventListener(\"pointerup\", handlePointerUp);\n    this.terminalMount.addEventListener(\"pointermove\", handlePointerMove);\n    this.terminalMount.addEventListener(\"wheel\", handleWheel, { passive: false });\n\n    this.detachInputHandlers = () => {\n      this.terminalMount.removeEventListener(\"keydown\", handleKeyDown);\n      this.terminalMount.removeEventListener(\"paste\", handlePaste);\n      this.terminalMount.removeEventListener(\"pointerdown\", handlePointerDown);\n      this.terminalMount.removeEventListener(\"pointerup\", handlePointerUp);\n      this.terminalMount.removeEventListener(\"pointermove\", handlePointerMove);\n      this.terminalMount.removeEventListener(\"wheel\", handleWheel);\n    };\n  }\n\n  private resizeToMount(): void {\n    this.measureCells();\n    const rect = this.terminalMount.getBoundingClientRect?.();\n    const width = rect?.width && rect.width > 0 ? rect.width : this.columns * this.cellWidth;\n    const height = rect?.height && rect.height > 0 ? rect.height : this.rows * this.cellHeight;\n    const nextColumns = Math.max(1, Math.floor(width / this.cellWidth));\n    const nextRows = Math.max(1, Math.floor(height / this.cellHeight));\n\n    this.columns = nextColumns;\n    this.rows = nextRows;\n    this.sendResizeIfNeeded();\n    this.resizeCanvas();\n  }\n\n  private sendResizeIfNeeded(): void {\n    const current = {\n      columns: this.columns,\n      rows: this.rows,\n      cellWidth: this.cellWidth,\n      cellHeight: this.cellHeight,\n    };\n    if (this.lastSentResize\n      && this.lastSentResize.columns === current.columns\n      && this.lastSentResize.rows === current.rows\n      && this.lastSentResize.cellWidth === current.cellWidth\n      && this.lastSentResize.cellHeight === current.cellHeight\n    ) {\n      return;\n    }\n\n    this.lastSentResize = current;\n    this.bridge?.resize(current.columns, current.rows, current.cellWidth, current.cellHeight);\n  }\n\n  private resizeCanvas(): boolean {\n    if (!this.canvas) {\n      return false;\n    }\n\n    const cssWidth = Math.max(1, this.columns * this.cellWidth);\n    const cssHeight = Math.max(1, this.rows * this.cellHeight);\n    const scale = globalThis.window?.devicePixelRatio || 1;\n    const width = Math.ceil(cssWidth * scale);\n    const height = Math.ceil(cssHeight * scale);\n    const styleWidth = `${cssWidth}px`;\n    const styleHeight = `${cssHeight}px`;\n    if (this.canvas.width === width\n      && this.canvas.height === height\n      && this.canvas.style.width === styleWidth\n      && this.canvas.style.height === styleHeight\n    ) {\n      return false;\n    }\n\n    this.canvas.width = width;\n    this.canvas.height = height;\n    this.canvas.style.width = styleWidth;\n    this.canvas.style.height = styleHeight;\n    return true;\n  }\n\n  private measureCells(): void {\n    const canvas = this.canvas ?? document.createElement(\"canvas\");\n    const context = canvas.getContext?.(\"2d\");\n    if (!context) {\n      this.cellWidth = Math.max(1, Math.round(this.currentStyle.fontSize * 0.62));\n      this.cellHeight = Math.max(1, Math.round(this.currentStyle.fontSize * 1.35));\n      return;\n    }\n\n    context.font = fontForStyle(this.currentStyle);\n    this.cellWidth = Math.max(1, Math.ceil(context.measureText(\"W\").width));\n    this.cellHeight = Math.max(1, Math.ceil(this.currentStyle.fontSize * 1.35));\n  }\n\n  private draw(\n    damage?: WebHostSurfaceDamage\n  ): void {\n    this.painter.paint(this.surfaceMetrics(), this.currentFrame, damage);\n  }\n\n  private syncAccessibilityTree(): void {\n    const tree = this.accessibilityTree;\n    if (!tree || !this.currentFrame) {\n      return;\n    }\n\n    tree.present(this.currentFrame.accessibilityTree ?? [], {\n      cellWidth: this.cellWidth,\n      cellHeight: this.cellHeight,\n    }, this.currentFrame.accessibilityAnnouncements ?? [], {\n      synchronizeFocus: this.synchronizeAccessibilityFocus,\n    });\n  }\n\n  private surfaceMetrics(): CanvasSurfaceMetrics {\n    return {\n      columns: this.columns,\n      rows: this.rows,\n      cellWidth: this.cellWidth,\n      cellHeight: this.cellHeight,\n      style: this.currentStyle,\n    };\n  }\n\n  private pointerMetrics(): PointerGeometryMetrics {\n    return {\n      rect: this.canvas?.getBoundingClientRect?.() ?? this.terminalMount.getBoundingClientRect?.(),\n      cellWidth: this.cellWidth,\n      cellHeight: this.cellHeight,\n      columns: this.columns,\n      rows: this.rows,\n    };\n  }\n\n  private cellLocation(\n    event: MouseEvent\n  ): CellLocation | undefined {\n    return cellLocationForEvent(event, this.pointerMetrics());\n  }\n\n  private rawCellLocation(\n    event: MouseEvent\n  ): CellLocation | undefined {\n    return rawCellLocationForEvent(event, this.pointerMetrics());\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"WebHostSceneRuntime.js","names":[],"sources":["../../src/WebHostSceneRuntime.ts"],"sourcesContent":["import {\n  applyWebHostTerminalStyle,\n  normalizeWebHostTerminalStyle,\n  type ResolvedWebHostTerminalStyle,\n  type WebHostTerminalStyle,\n  webTUITerminalBackgroundColor,\n} from \"./WebHostTerminalStyle.ts\";\nimport {\n  CanvasSurfacePainter,\n  fontForStyle,\n  type CanvasSurfaceMetrics,\n} from \"./CanvasSurfacePainter.ts\";\nimport {\n  InputEventEncoder,\n  type CellLocation,\n  type PointerButton,\n} from \"./InputEventEncoder.ts\";\nimport {\n  cellLocationForEvent,\n  linkTargetAt,\n  rawCellLocationForEvent,\n  wheelTargetCanScroll,\n  type PointerGeometryMetrics,\n} from \"./PointerGeometry.ts\";\nimport { AccessibilityTreeMounter } from \"./AccessibilityTree.ts\";\nimport {\n  type WebHostFocusPresentation,\n  type WebHostFrameDiagnosticRecord,\n  type WebHostOutputSink,\n  type WebHostRuntimeIssue,\n  type WebHostSurfaceDamage,\n  type WebHostSurfaceFrame,\n} from \"./WebHostSurfaceTransport.ts\";\nimport type { WebHostSceneDescriptor } from \"./WebHostSceneManifest.ts\";\n\nexport interface WebHostSceneBridge {\n  bindOutput(sink: WebHostOutputSink): void;\n  resize(columns: number, rows: number, cellWidth?: number, cellHeight?: number): void;\n  updateRenderStyle(style: WebHostTerminalStyle): void;\n  sendInput(chunk: Uint8Array): void;\n  dispose(): void;\n}\n\nexport interface WebHostSceneRuntimeOptions {\n  mount: HTMLElement;\n  descriptor: WebHostSceneDescriptor;\n  style: WebHostTerminalStyle;\n  bridge?: WebHostSceneBridge;\n  onInput(chunk: Uint8Array): void;\n  onFrameDiagnostic?: (diagnostic: WebHostFrameDiagnosticRecord) => void;\n  synchronizeAccessibilityFocus?: boolean;\n  /**\n   * How the embedded view treats mouse-wheel input.\n   * - `\"chain\"` (default): forward the wheel only while a scrollable region\n   *   under the pointer can still scroll in that direction; otherwise let it\n   *   fall through so the page (or parent iframe) scrolls — iframe-like nested\n   *   scrolling. A scene with no `ScrollView` never traps the wheel. Uses the\n   *   `scrollRegions` the app publishes in its frames.\n   * - `\"capture\"`: always forward the wheel to the app while the pointer is over\n   *   the surface (and `preventDefault` page scroll). Best for full-screen apps\n   *   where there is no page to scroll past.\n   * - `\"passive\"`: never capture; the page always scrolls.\n   *\n   * Takes precedence over the legacy `captureWheelInput` flag.\n   */\n  wheelMode?: WheelMode;\n  /**\n   * Legacy boolean wheel gate. `true` → `\"capture\"`, `false` → `\"passive\"`.\n   * Prefer `wheelMode`. Ignored when `wheelMode` is set. When neither is set the\n   * mode defaults to `\"chain\"`.\n   */\n  captureWheelInput?: boolean;\n  /**\n   * Called when the user clicks a hyperlink cell (a click is a pointer-down\n   * and pointer-up over the same link target). When unset, `http(s)` targets\n   * open in a new tab via `window.open(url, \"_blank\", \"noopener,noreferrer\")`\n   * and other schemes are ignored. Mirrors the Android host's tap-to-open.\n   */\n  onOpenHyperlink?: (url: string) => void;\n  /**\n   * Whether to suspend the scene's app while it cannot be seen — when the\n   * scene is switched to the background (`setVisible(false)`) or the whole\n   * document is hidden (`setDocumentVisible(false)`). Suspension parks the\n   * app's run loop and freezes its monotonic clock, so a hidden scene costs\n   * no CPU and resumes exactly where it left off. Defaults to `true`; set\n   * `false` to let background scenes keep running (pre-suspension behavior).\n   */\n  suspendWhenHidden?: boolean;\n}\n\nexport type WheelMode = \"capture\" | \"chain\" | \"passive\";\n\n/**\n * Resolves the legacy `captureWheelInput` flag to a {@link WheelMode}. When the\n * flag is unset the mode defaults to `\"chain\"`, so embeds never trap a visitor\n * who is merely scrolling past the view; `true` maps to `\"capture\"` and `false`\n * to `\"passive\"` to preserve the old boolean behavior.\n */\nfunction legacyWheelMode(captureWheelInput: boolean | undefined): WheelMode {\n  if (captureWheelInput === undefined) {\n    return \"chain\";\n  }\n  return captureWheelInput ? \"capture\" : \"passive\";\n}\n\n/**\n * Coordinates a single SwiftTUI scene's browser presentation: it owns the DOM\n * mount, canvas, accessibility tree, and bridge wiring, and delegates the heavy\n * responsibilities to focused collaborators — {@link CanvasSurfacePainter} for\n * canvas drawing, {@link InputEventEncoder} for wire-message encoding, and the\n * {@link PointerGeometry} helpers for pixel→cell hit-testing and wheel chaining.\n */\nexport class WebHostSceneRuntime {\n  readonly descriptor: WebHostSceneDescriptor;\n  readonly element: HTMLElement;\n  readonly terminalMount: HTMLElement;\n\n  private readonly bridge?: WebHostSceneBridge;\n  private readonly onInput: (chunk: Uint8Array) => void;\n  private readonly onFrameDiagnostic?: (diagnostic: WebHostFrameDiagnosticRecord) => void;\n  private readonly synchronizeAccessibilityFocus: boolean;\n  private readonly wheelMode: WheelMode;\n  private readonly painter = new CanvasSurfacePainter();\n  private readonly inputEncoder = new InputEventEncoder();\n  private currentStyle: ResolvedWebHostTerminalStyle;\n  private canvas?: HTMLCanvasElement;\n  private accessibilityTree?: AccessibilityTreeMounter;\n  private diagnosticText?: HTMLElement;\n  private resizeObserver?: ResizeObserver;\n  private detachInputHandlers?: () => void;\n  private currentFrame?: WebHostSurfaceFrame;\n  private columns = 80;\n  private rows = 24;\n  private cellWidth = 8;\n  private cellHeight = 18;\n  private activePointerButton: PointerButton = \"primary\";\n  private hasCapturedPointer = false;\n  private readonly onOpenHyperlink?: (url: string) => void;\n  private pointerDownLinkTarget?: string;\n  private lastSentResize?: {\n    columns: number;\n    rows: number;\n    cellWidth: number;\n    cellHeight: number;\n  };\n  private isVisible = false;\n  private documentVisible = true;\n  private runtimeSuspended = false;\n  private readonly suspendWhenHidden: boolean;\n\n  constructor(options: WebHostSceneRuntimeOptions) {\n    this.descriptor = options.descriptor;\n    this.currentStyle = normalizeWebHostTerminalStyle(options.style);\n    this.bridge = options.bridge;\n    this.onInput = options.onInput;\n    this.onFrameDiagnostic = options.onFrameDiagnostic;\n    this.synchronizeAccessibilityFocus = options.synchronizeAccessibilityFocus ?? true;\n    this.wheelMode = options.wheelMode ?? legacyWheelMode(options.captureWheelInput);\n    this.onOpenHyperlink = options.onOpenHyperlink;\n    this.suspendWhenHidden = options.suspendWhenHidden ?? true;\n    this.element = document.createElement(\"section\");\n    this.element.className = \"webhost-scene\";\n    this.element.dataset.sceneId = options.descriptor.id;\n    this.element.hidden = true;\n\n    const header = document.createElement(\"div\");\n    header.className = \"webhost-scene__header\";\n    header.textContent = options.descriptor.title ?? options.descriptor.id;\n\n    this.terminalMount = document.createElement(\"div\");\n    this.terminalMount.className = \"webhost-scene__terminal\";\n    this.terminalMount.tabIndex = 0;\n\n    this.element.append(header, this.terminalMount);\n    options.mount.appendChild(this.element);\n    this.applyVisibility();\n  }\n\n  async mount(): Promise<void> {\n    if (this.canvas) {\n      return;\n    }\n\n    const canvas = document.createElement(\"canvas\");\n    canvas.className = \"webhost-scene__surface\";\n    canvas.setAttribute(\"aria-hidden\", \"true\");\n    this.canvas = canvas;\n    this.painter.attach(canvas, () => this.draw());\n    this.accessibilityTree = new AccessibilityTreeMounter();\n    this.terminalMount.replaceChildren(\n      canvas,\n      this.accessibilityTree.element,\n      this.accessibilityTree.announcerElement\n    );\n    this.installInputHandlers();\n    this.installResizeObserver();\n\n    this.bridge?.bindOutput({\n      presentSurface: (frame) => this.presentSurface(frame),\n      writeClipboard: (text) => this.writeClipboard(text),\n      notifyRuntimeIssue: (issue) => this.notifyRuntimeIssue(issue),\n      recordFrameDiagnostic: (diagnostic) => this.recordFrameDiagnostic(diagnostic),\n      writeOutput: (text) => this.writeOutput(text),\n      writeError: (text) => this.writeOutput(text),\n    });\n\n    this.applyStyle(this.currentStyle);\n    this.measureCells();\n    this.resizeToMount();\n    this.draw();\n    this.syncAccessibilityTree();\n  }\n\n  setVisible(\n    visible: boolean\n  ): void {\n    this.isVisible = visible;\n    this.applyVisibility();\n    if (visible) {\n      this.resizeToMount();\n      if (this.synchronizeAccessibilityFocus) {\n        this.terminalMount.focus?.({ preventScroll: true });\n      }\n    }\n    this.updateRuntimeSuspension();\n  }\n\n  /**\n   * Reports whether the surrounding document can be seen at all (browser tab\n   * visible, iframe on-screen, …). Combined with the scene-level\n   * `setVisible`: the app is suspended while either says hidden, unless\n   * `suspendWhenHidden` is `false`.\n   */\n  setDocumentVisible(\n    visible: boolean\n  ): void {\n    this.documentVisible = visible;\n    this.updateRuntimeSuspension();\n  }\n\n  private updateRuntimeSuspension(): void {\n    const suspended = this.suspendWhenHidden && (!this.isVisible || !this.documentVisible);\n    if (suspended === this.runtimeSuspended) {\n      return;\n    }\n    this.runtimeSuspended = suspended;\n    this.onRuntimeSuspensionChange(suspended);\n  }\n\n  /**\n   * Suspension hook for subclasses that own an app execution vehicle (the\n   * WASI worker / JSPI executor). The base runtime only presents frames, so\n   * it has nothing to suspend.\n   */\n  protected onRuntimeSuspensionChange(\n    _suspended: boolean\n  ): void {}\n\n  setStyle(\n    style: WebHostTerminalStyle\n  ): void {\n    this.currentStyle = normalizeWebHostTerminalStyle(style);\n    this.applyStyle(this.currentStyle);\n    this.bridge?.updateRenderStyle(this.currentStyle);\n    this.measureCells();\n    this.resizeToMount();\n    this.draw();\n    this.syncAccessibilityTree();\n  }\n\n  resize(\n    columns: number,\n    rows: number\n  ): void {\n    this.columns = Math.max(1, Math.round(columns));\n    this.rows = Math.max(1, Math.round(rows));\n    this.resizeCanvas();\n    this.draw();\n    this.syncAccessibilityTree();\n  }\n\n  writeOutput(\n    text: string\n  ): void {\n    if (!this.diagnosticText) {\n      const diagnosticText = document.createElement(\"pre\");\n      diagnosticText.className = \"webhost-scene__diagnostic\";\n      this.diagnosticText = diagnosticText;\n      this.terminalMount.appendChild(diagnosticText);\n    }\n    this.diagnosticText.textContent = `${this.diagnosticText.textContent ?? \"\"}${text}`;\n  }\n\n  notifyRuntimeIssue(\n    issue: WebHostRuntimeIssue\n  ): void {\n    console.log(issue.description);\n  }\n\n  private recordFrameDiagnostic(\n    diagnostic: WebHostFrameDiagnosticRecord\n  ): void {\n    this.onFrameDiagnostic?.(diagnostic);\n  }\n\n  async writeClipboard(\n    text: string\n  ): Promise<void> {\n    const clipboard = globalThis.navigator?.clipboard;\n    if (!clipboard?.writeText) {\n      return;\n    }\n\n    try {\n      await clipboard.writeText(text);\n    } catch {\n      // Clipboard permissions are browser/user-gesture dependent; hosts treat\n      // rejection as a best-effort no-op rather than surfacing diagnostics.\n    }\n  }\n\n  sendInput(\n    chunk: Uint8Array\n  ): void {\n    this.onInput(chunk);\n  }\n\n  dispose(): void {\n    this.detachInputHandlers?.();\n    this.resizeObserver?.disconnect();\n    this.element.remove();\n  }\n\n  private presentSurface(\n    frame: WebHostSurfaceFrame\n  ): void {\n    const previousFrame = this.currentFrame;\n    this.currentFrame = frame;\n    this.columns = Math.max(1, Math.round(frame.width));\n    this.rows = Math.max(1, Math.round(frame.height));\n    const resized = this.resizeCanvas();\n    this.draw(previousFrame && !resized ? frame.damage : undefined);\n    this.syncAccessibilityTree();\n  }\n\n  /**\n   * The current frame's preferred grid size in cells, when the app published\n   * one — the measured pre-minimum content size, for embedders negotiating\n   * with an outer layout system (the Android host's preferred columns/rows).\n   */\n  get preferredGridSize(): { width: number; height: number } | undefined {\n    const frame = this.currentFrame;\n    if (frame?.preferredGridWidth === undefined || frame.preferredGridHeight === undefined) {\n      return undefined;\n    }\n    return { width: frame.preferredGridWidth, height: frame.preferredGridHeight };\n  }\n\n  /**\n   * The current frame's settled focus presentation, when the app published\n   * one. `prefersTextInput` is what the Android host uses to gate its IME;\n   * embedders can drive virtual-keyboard or focus affordances from it.\n   */\n  get focusPresentation(): WebHostFocusPresentation | undefined {\n    return this.currentFrame?.focusPresentation;\n  }\n\n  private linkTarget(\n    location: CellLocation\n  ): string | undefined {\n    return linkTargetAt(\n      this.currentFrame?.links,\n      this.currentFrame?.linkTargets,\n      location\n    );\n  }\n\n  private openHyperlink(\n    url: string\n  ): void {\n    if (this.onOpenHyperlink) {\n      this.onOpenHyperlink(url);\n      return;\n    }\n    // Defense in depth on top of the app-side OSC-8 destination sanitization:\n    // the default handler only opens web schemes.\n    if (!/^https?:/i.test(url)) {\n      return;\n    }\n    window.open(url, \"_blank\", \"noopener,noreferrer\");\n  }\n\n  private applyStyle(\n    style: WebHostTerminalStyle\n  ): void {\n    applyWebHostTerminalStyle(this.element, style);\n    this.element.style.padding = \"0.75rem\";\n    this.element.style.borderRadius = \"16px\";\n    this.element.style.boxShadow = \"0 20px 50px rgba(0, 0, 0, 0.28)\";\n    this.element.style.overflow = \"hidden\";\n    this.element.style.gap = \"0.5rem\";\n    this.element.style.gridTemplateRows = \"auto 1fr\";\n\n    this.terminalMount.style.position = \"relative\";\n    this.terminalMount.style.overflow = \"hidden\";\n    // Keep a captured wheel from rubber-banding/chaining the page; the wheel\n    // capture vs. fall-through decision lives in handleWheel.\n    this.terminalMount.style.overscrollBehavior = \"contain\";\n    this.terminalMount.style.outline = \"none\";\n    this.terminalMount.style.background = webTUITerminalBackgroundColor(this.currentStyle);\n    this.terminalMount.style.minHeight = `${this.cellHeight * 8}px`;\n\n    if (this.canvas) {\n      this.canvas.style.display = \"block\";\n      this.canvas.style.width = \"100%\";\n      this.canvas.style.height = \"100%\";\n    }\n  }\n\n  private applyVisibility(): void {\n    this.element.hidden = !this.isVisible;\n    this.element.style.setProperty(\n      \"display\",\n      this.isVisible ? \"grid\" : \"none\",\n      \"important\"\n    );\n  }\n\n  private installResizeObserver(): void {\n    if (typeof ResizeObserver === \"undefined\") {\n      return;\n    }\n\n    this.resizeObserver = new ResizeObserver(() => {\n      this.resizeToMount();\n    });\n    this.resizeObserver.observe(this.terminalMount);\n  }\n\n  private installInputHandlers(): void {\n    const handleKeyDown = (event: KeyboardEvent) => {\n      if (event.metaKey || event.isComposing) {\n        return;\n      }\n      const message = this.inputEncoder.encodeKey(event);\n      if (!message) {\n        return;\n      }\n\n      this.onInput(message);\n      event.preventDefault();\n    };\n\n    const handlePaste = (event: ClipboardEvent) => {\n      const text = event.clipboardData?.getData(\"text/plain\") ?? \"\";\n      if (!text) {\n        return;\n      }\n      this.onInput(this.inputEncoder.encodePaste(text));\n      event.preventDefault();\n    };\n\n    const handlePointerDown = (event: PointerEvent) => {\n      const location = this.cellLocation(event);\n      if (!location) {\n        return;\n      }\n\n      const button = this.inputEncoder.pointerButton(event.button);\n      this.activePointerButton = button;\n      this.hasCapturedPointer = true;\n      this.pointerDownLinkTarget = button === \"primary\"\n        ? this.linkTarget(location)\n        : undefined;\n      this.terminalMount.focus?.({ preventScroll: true });\n      this.terminalMount.setPointerCapture?.(event.pointerId);\n      this.onInput(this.inputEncoder.encodePointerDown(location, button, event));\n      event.preventDefault();\n    };\n\n    const handlePointerUp = (event: PointerEvent) => {\n      const location = this.hasCapturedPointer\n        ? this.rawCellLocation(event)\n        : this.cellLocation(event);\n      this.terminalMount.releasePointerCapture?.(event.pointerId);\n      this.hasCapturedPointer = false;\n      const downLinkTarget = this.pointerDownLinkTarget;\n      this.pointerDownLinkTarget = undefined;\n      if (!location) {\n        return;\n      }\n\n      const button = this.inputEncoder.pointerButton(event.button) ?? this.activePointerButton;\n      this.onInput(this.inputEncoder.encodePointerUp(location, button, event));\n      // A click — down and up over the same link target — opens the link,\n      // mirroring the Android host's tap-to-open. The app still receives the\n      // pointer messages above.\n      if (downLinkTarget !== undefined && this.linkTarget(location) === downLinkTarget) {\n        this.openHyperlink(downLinkTarget);\n      }\n      event.preventDefault();\n    };\n\n    const handlePointerMove = (event: PointerEvent) => {\n      const location = event.buttons && this.hasCapturedPointer\n        ? this.rawCellLocation(event)\n        : this.cellLocation(event);\n      if (!location) {\n        return;\n      }\n\n      if (!this.hasCapturedPointer) {\n        this.terminalMount.style.cursor =\n          this.linkTarget(location) !== undefined ? \"pointer\" : \"\";\n      }\n      this.onInput(this.inputEncoder.encodePointerMove(location, this.activePointerButton, event));\n    };\n\n    const handleWheel = (event: WheelEvent) => {\n      if (this.wheelMode === \"passive\") {\n        return;\n      }\n\n      const location = this.cellLocation(event);\n      if (!location) {\n        // Pointer is outside the cell grid (sub-cell margin / gutter). Don't\n        // capture — let the wheel fall through to the page.\n        return;\n      }\n\n      // In \"chain\" mode, capture only while a scrollable region under the\n      // pointer can still move in this direction; otherwise let the wheel fall\n      // through so the page (or parent iframe) scrolls — iframe-like behavior.\n      // \"capture\" mode always forwards while over the surface (legacy).\n      if (this.wheelMode === \"chain\"\n        && !wheelTargetCanScroll(this.currentFrame?.scrollRegions, location, event.deltaX, event.deltaY)) {\n        return;\n      }\n\n      this.onInput(this.inputEncoder.encodeWheel(location, event));\n      event.preventDefault();\n    };\n\n    this.terminalMount.addEventListener(\"keydown\", handleKeyDown);\n    this.terminalMount.addEventListener(\"paste\", handlePaste);\n    this.terminalMount.addEventListener(\"pointerdown\", handlePointerDown);\n    this.terminalMount.addEventListener(\"pointerup\", handlePointerUp);\n    this.terminalMount.addEventListener(\"pointermove\", handlePointerMove);\n    this.terminalMount.addEventListener(\"wheel\", handleWheel, { passive: false });\n\n    this.detachInputHandlers = () => {\n      this.terminalMount.removeEventListener(\"keydown\", handleKeyDown);\n      this.terminalMount.removeEventListener(\"paste\", handlePaste);\n      this.terminalMount.removeEventListener(\"pointerdown\", handlePointerDown);\n      this.terminalMount.removeEventListener(\"pointerup\", handlePointerUp);\n      this.terminalMount.removeEventListener(\"pointermove\", handlePointerMove);\n      this.terminalMount.removeEventListener(\"wheel\", handleWheel);\n    };\n  }\n\n  private resizeToMount(): void {\n    this.measureCells();\n    const rect = this.terminalMount.getBoundingClientRect?.();\n    const width = rect?.width && rect.width > 0 ? rect.width : this.columns * this.cellWidth;\n    const height = rect?.height && rect.height > 0 ? rect.height : this.rows * this.cellHeight;\n    const nextColumns = Math.max(1, Math.floor(width / this.cellWidth));\n    const nextRows = Math.max(1, Math.floor(height / this.cellHeight));\n\n    this.columns = nextColumns;\n    this.rows = nextRows;\n    this.sendResizeIfNeeded();\n    this.resizeCanvas();\n  }\n\n  private sendResizeIfNeeded(): void {\n    const current = {\n      columns: this.columns,\n      rows: this.rows,\n      cellWidth: this.cellWidth,\n      cellHeight: this.cellHeight,\n    };\n    if (this.lastSentResize\n      && this.lastSentResize.columns === current.columns\n      && this.lastSentResize.rows === current.rows\n      && this.lastSentResize.cellWidth === current.cellWidth\n      && this.lastSentResize.cellHeight === current.cellHeight\n    ) {\n      return;\n    }\n\n    this.lastSentResize = current;\n    this.bridge?.resize(current.columns, current.rows, current.cellWidth, current.cellHeight);\n  }\n\n  private resizeCanvas(): boolean {\n    if (!this.canvas) {\n      return false;\n    }\n\n    const cssWidth = Math.max(1, this.columns * this.cellWidth);\n    const cssHeight = Math.max(1, this.rows * this.cellHeight);\n    const scale = globalThis.window?.devicePixelRatio || 1;\n    const width = Math.ceil(cssWidth * scale);\n    const height = Math.ceil(cssHeight * scale);\n    const styleWidth = `${cssWidth}px`;\n    const styleHeight = `${cssHeight}px`;\n    if (this.canvas.width === width\n      && this.canvas.height === height\n      && this.canvas.style.width === styleWidth\n      && this.canvas.style.height === styleHeight\n    ) {\n      return false;\n    }\n\n    this.canvas.width = width;\n    this.canvas.height = height;\n    this.canvas.style.width = styleWidth;\n    this.canvas.style.height = styleHeight;\n    return true;\n  }\n\n  private measureCells(): void {\n    const canvas = this.canvas ?? document.createElement(\"canvas\");\n    const context = canvas.getContext?.(\"2d\");\n    if (!context) {\n      this.cellWidth = Math.max(1, Math.round(this.currentStyle.fontSize * 0.62));\n      this.cellHeight = Math.max(1, Math.round(this.currentStyle.fontSize * 1.35));\n      return;\n    }\n\n    context.font = fontForStyle(this.currentStyle);\n    this.cellWidth = Math.max(1, Math.ceil(context.measureText(\"W\").width));\n    this.cellHeight = Math.max(1, Math.ceil(this.currentStyle.fontSize * 1.35));\n  }\n\n  private draw(\n    damage?: WebHostSurfaceDamage\n  ): void {\n    this.painter.paint(this.surfaceMetrics(), this.currentFrame, damage);\n  }\n\n  private syncAccessibilityTree(): void {\n    const tree = this.accessibilityTree;\n    if (!tree || !this.currentFrame) {\n      return;\n    }\n\n    tree.present(this.currentFrame.accessibilityTree ?? [], {\n      cellWidth: this.cellWidth,\n      cellHeight: this.cellHeight,\n    }, this.currentFrame.accessibilityAnnouncements ?? [], {\n      synchronizeFocus: this.synchronizeAccessibilityFocus,\n    });\n  }\n\n  private surfaceMetrics(): CanvasSurfaceMetrics {\n    return {\n      columns: this.columns,\n      rows: this.rows,\n      cellWidth: this.cellWidth,\n      cellHeight: this.cellHeight,\n      style: this.currentStyle,\n    };\n  }\n\n  private pointerMetrics(): PointerGeometryMetrics {\n    return {\n      rect: this.canvas?.getBoundingClientRect?.() ?? this.terminalMount.getBoundingClientRect?.(),\n      cellWidth: this.cellWidth,\n      cellHeight: this.cellHeight,\n      columns: this.columns,\n      rows: this.rows,\n    };\n  }\n\n  private cellLocation(\n    event: MouseEvent\n  ): CellLocation | undefined {\n    return cellLocationForEvent(event, this.pointerMetrics());\n  }\n\n  private rawCellLocation(\n    event: MouseEvent\n  ): CellLocation | undefined {\n    return rawCellLocationForEvent(event, this.pointerMetrics());\n  }\n}\n"],"mappings":"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"}

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

@@ -20,10 +20,18 @@ interface MainThreadWasmExecutorOptions {
 declare class MainThreadWasmExecutor {
   private readonly options;
   private readonly stdin;
+  private readonly pauseClock;
+  private readonly pauseGate;
   private didStart;
   constructor(options: MainThreadWasmExecutorOptions);
   start(): void;
   sendInput(chunk: Uint8Array): void;
+  /**
+   * Suspends or resumes the app: while suspended, the run loop parks between
+   * `poll_oneoff` waits and the app's monotonic clock freezes, so a hidden
+   * scene costs no CPU and resumes without a deadline catch-up burst.
+   */
+  setSuspended(suspended: boolean): void;
   dispose(): void;
   private run;
 }

package/dist/src/wasi/MainThreadWasmExecutor.js

@@ -1,6 +1,7 @@
 import { jspiConstructors } from "./WasmEngineCapabilities.js";
 import { MainThreadInputQueue } from "./MainThreadInputQueue.js";
 import { SuspendingWasiPollScheduler } from "./WasiPollScheduler.js";
+import { MainThreadWasmPauseGate, PausableMonotonicClock, installPausableClockTimeGet } from "./WasmRuntimePause.js";
 import { ConsoleStdout, Fd, WASI, WASIProcExit, wasi } from "@bjorn3/browser_wasi_shim";
 //#region src/wasi/MainThreadWasmExecutor.ts
 /**
@@ -16,6 +17,8 @@ import { ConsoleStdout, Fd, WASI, WASIProcExit, wasi } from "@bjorn3/browser_was
 var MainThreadWasmExecutor = class {
 	options;
 	stdin = new MainThreadInputQueue();
+	pauseClock = new PausableMonotonicClock();
+	pauseGate = new MainThreadWasmPauseGate(this.pauseClock);
 	didStart = false;
 	constructor(options) {
 		this.options = options;
@@ -28,8 +31,17 @@ var MainThreadWasmExecutor = class {
 	sendInput(chunk) {
 		this.stdin.write(chunk);
 	}
+	/**
+	* Suspends or resumes the app: while suspended, the run loop parks between
+	* `poll_oneoff` waits and the app's monotonic clock freezes, so a hidden
+	* scene costs no CPU and resumes without a deadline catch-up burst.
+	*/
+	setSuspended(suspended) {
+		this.pauseGate.setPaused(suspended);
+	}
 	dispose() {
 		this.stdin.close();
+		this.pauseGate.setPaused(false);
 	}
 	async run() {
 		try {
@@ -45,8 +57,11 @@ var MainThreadWasmExecutor = class {
 			const scheduler = new SuspendingWasiPollScheduler({
 				memory: () => instanceExports()?.memory,
 				stdin: this.stdin,
-				fallbackPoll: (inPtr, outPtr, nsubscriptions, neventsPtr) => originalPoll(inPtr, outPtr, nsubscriptions, neventsPtr)
+				fallbackPoll: (inPtr, outPtr, nsubscriptions, neventsPtr) => originalPoll(inPtr, outPtr, nsubscriptions, neventsPtr),
+				nowMilliseconds: () => this.pauseClock.nowMilliseconds(),
+				pauseGate: this.pauseGate
 			});
+			installPausableClockTimeGet(shim.wasiImport, () => instanceExports()?.memory, this.pauseClock);
 			const response = await fetch(this.options.wasmURL);
 			if (!response.ok) throw new Error(`failed to load ${String(this.options.wasmURL)}: ${response.status} ${response.statusText}`);
 			const module = await WebAssembly.compile(await response.arrayBuffer());

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

@@ -1 +1 @@
-{"version":3,"file":"MainThreadWasmExecutor.js","names":[],"sources":["../../../src/wasi/MainThreadWasmExecutor.ts"],"sourcesContent":["import { ConsoleStdout, Fd, WASI, WASIProcExit, wasi } from \"@bjorn3/browser_wasi_shim\";\n\nimport { MainThreadInputQueue } from \"./MainThreadInputQueue.ts\";\nimport { SuspendingWasiPollScheduler } from \"./WasiPollScheduler.ts\";\nimport { jspiConstructors } from \"./WasmEngineCapabilities.ts\";\n\nexport interface MainThreadWasmExecutorOptions {\n  wasmURL: string | URL;\n  environment: Record<string, string>;\n  onStdout(chunk: Uint8Array): void;\n  onStderr(chunk: Uint8Array): void;\n  onExit?(code: number): void;\n  onError?(message: string): void;\n}\n\n/**\n * Runs a SwiftTUI WASI app on the main thread using WebAssembly JSPI: the\n * `poll_oneoff` import is wrapped in `WebAssembly.Suspending`, so the app's\n * run loop suspends to the browser event loop instead of blocking a worker\n * on `Atomics.wait`. Requires JSPI; needs neither a worker nor\n * SharedArrayBuffer (and therefore no COOP/COEP headers).\n *\n * Disposal closes stdin; the SwiftTUI runner exits cooperatively on stdin\n * hangup, which resolves the promised `_start` call.\n */\nexport class MainThreadWasmExecutor {\n  private readonly options: MainThreadWasmExecutorOptions;\n  private readonly stdin = new MainThreadInputQueue();\n  private didStart = false;\n\n  constructor(options: MainThreadWasmExecutorOptions) {\n    this.options = options;\n  }\n\n  start(): void {\n    if (this.didStart) {\n      return;\n    }\n    this.didStart = true;\n    void this.run();\n  }\n\n  sendInput(chunk: Uint8Array): void {\n    this.stdin.write(chunk);\n  }\n\n  dispose(): void {\n    this.stdin.close();\n  }\n\n  private async run(): Promise<void> {\n    try {\n      const jspi = jspiConstructors();\n      if (!jspi) {\n        throw new Error(\n          \"WebAssembly JSPI (Suspending/promising) is unavailable in this engine\"\n        );\n      }\n\n      const shim = new WASI(\n        [\"app.wasm\"],\n        Object.entries(this.options.environment).map(([key, value]) => `${key}=${value}`),\n        [\n          new MainThreadInputFileDescriptor(this.stdin),\n          new ConsoleStdout((chunk) => this.options.onStdout(chunk)),\n          new ConsoleStdout((chunk) => this.options.onStderr(chunk)),\n        ]\n      );\n\n      const instanceExports = (): { memory?: WebAssembly.Memory } | undefined =>\n        (shim as unknown as { inst?: { exports: { memory?: WebAssembly.Memory } } }).inst\n          ?.exports;\n      const originalPoll = shim.wasiImport.poll_oneoff as (\n        inPtr: number,\n        outPtr: number,\n        nsubscriptions: number,\n        neventsPtr?: number\n      ) => number;\n      const scheduler = new SuspendingWasiPollScheduler({\n        memory: () => instanceExports()?.memory,\n        stdin: this.stdin,\n        fallbackPoll: (inPtr, outPtr, nsubscriptions, neventsPtr) =>\n          originalPoll(inPtr, outPtr, nsubscriptions, neventsPtr),\n      });\n\n      const response = await fetch(this.options.wasmURL);\n      if (!response.ok) {\n        throw new Error(\n          `failed to load ${String(this.options.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: {\n          ...shim.wasiImport,\n          poll_oneoff: new jspi.Suspending(\n            (inPtr: number, outPtr: number, nsubscriptions: number, neventsPtr: number) =>\n              scheduler.pollOneOff(inPtr, outPtr, nsubscriptions, neventsPtr)\n          ),\n        },\n      });\n      (shim as unknown as { inst: WebAssembly.Instance }).inst =\n        instance as WebAssembly.Instance;\n\n      const start = jspi.promising(\n        (instance as WebAssembly.Instance).exports._start\n      );\n      try {\n        await start();\n        this.options.onExit?.(0);\n      } catch (error) {\n        if (error instanceof WASIProcExit) {\n          this.options.onExit?.(error.code);\n          return;\n        }\n        throw error;\n      }\n    } catch (error) {\n      this.options.onError?.(error instanceof Error ? error.message : String(error));\n    }\n  }\n}\n\nclass MainThreadInputFileDescriptor extends Fd {\n  private readonly queue: MainThreadInputQueue;\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(queue: MainThreadInputQueue) {\n    super();\n    this.queue = queue;\n  }\n\n  override fd_fdstat_get(): { ret: number; fdstat: wasi.Fdstat } {\n    return { ret: wasi.ERRNO_SUCCESS, fdstat: this.fdstat };\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.queue.readAvailable(size);\n    if (chunk) {\n      return { ret: wasi.ERRNO_SUCCESS, data: chunk };\n    }\n    if (this.queue.isClosed()) {\n      return { ret: wasi.ERRNO_SUCCESS, data: new Uint8Array() };\n    }\n    return { ret: wasi.ERRNO_AGAIN, data: new Uint8Array() };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"MainThreadWasmExecutor.js","names":[],"sources":["../../../src/wasi/MainThreadWasmExecutor.ts"],"sourcesContent":["import { ConsoleStdout, Fd, WASI, WASIProcExit, wasi } from \"@bjorn3/browser_wasi_shim\";\n\nimport { MainThreadInputQueue } from \"./MainThreadInputQueue.ts\";\nimport { SuspendingWasiPollScheduler } from \"./WasiPollScheduler.ts\";\nimport { jspiConstructors } from \"./WasmEngineCapabilities.ts\";\nimport {\n  MainThreadWasmPauseGate,\n  PausableMonotonicClock,\n  installPausableClockTimeGet,\n} from \"./WasmRuntimePause.ts\";\n\nexport interface MainThreadWasmExecutorOptions {\n  wasmURL: string | URL;\n  environment: Record<string, string>;\n  onStdout(chunk: Uint8Array): void;\n  onStderr(chunk: Uint8Array): void;\n  onExit?(code: number): void;\n  onError?(message: string): void;\n}\n\n/**\n * Runs a SwiftTUI WASI app on the main thread using WebAssembly JSPI: the\n * `poll_oneoff` import is wrapped in `WebAssembly.Suspending`, so the app's\n * run loop suspends to the browser event loop instead of blocking a worker\n * on `Atomics.wait`. Requires JSPI; needs neither a worker nor\n * SharedArrayBuffer (and therefore no COOP/COEP headers).\n *\n * Disposal closes stdin; the SwiftTUI runner exits cooperatively on stdin\n * hangup, which resolves the promised `_start` call.\n */\nexport class MainThreadWasmExecutor {\n  private readonly options: MainThreadWasmExecutorOptions;\n  private readonly stdin = new MainThreadInputQueue();\n  private readonly pauseClock = new PausableMonotonicClock();\n  private readonly pauseGate = new MainThreadWasmPauseGate(this.pauseClock);\n  private didStart = false;\n\n  constructor(options: MainThreadWasmExecutorOptions) {\n    this.options = options;\n  }\n\n  start(): void {\n    if (this.didStart) {\n      return;\n    }\n    this.didStart = true;\n    void this.run();\n  }\n\n  sendInput(chunk: Uint8Array): void {\n    this.stdin.write(chunk);\n  }\n\n  /**\n   * Suspends or resumes the app: while suspended, the run loop parks between\n   * `poll_oneoff` waits and the app's monotonic clock freezes, so a hidden\n   * scene costs no CPU and resumes without a deadline catch-up burst.\n   */\n  setSuspended(\n    suspended: boolean\n  ): void {\n    this.pauseGate.setPaused(suspended);\n  }\n\n  dispose(): void {\n    this.stdin.close();\n    // Release a suspended run loop so it can observe the stdin hangup and\n    // exit cooperatively instead of staying parked forever.\n    this.pauseGate.setPaused(false);\n  }\n\n  private async run(): Promise<void> {\n    try {\n      const jspi = jspiConstructors();\n      if (!jspi) {\n        throw new Error(\n          \"WebAssembly JSPI (Suspending/promising) is unavailable in this engine\"\n        );\n      }\n\n      const shim = new WASI(\n        [\"app.wasm\"],\n        Object.entries(this.options.environment).map(([key, value]) => `${key}=${value}`),\n        [\n          new MainThreadInputFileDescriptor(this.stdin),\n          new ConsoleStdout((chunk) => this.options.onStdout(chunk)),\n          new ConsoleStdout((chunk) => this.options.onStderr(chunk)),\n        ]\n      );\n\n      const instanceExports = (): { memory?: WebAssembly.Memory } | undefined =>\n        (shim as unknown as { inst?: { exports: { memory?: WebAssembly.Memory } } }).inst\n          ?.exports;\n      const originalPoll = shim.wasiImport.poll_oneoff as (\n        inPtr: number,\n        outPtr: number,\n        nsubscriptions: number,\n        neventsPtr?: number\n      ) => number;\n      const scheduler = new SuspendingWasiPollScheduler({\n        memory: () => instanceExports()?.memory,\n        stdin: this.stdin,\n        fallbackPoll: (inPtr, outPtr, nsubscriptions, neventsPtr) =>\n          originalPoll(inPtr, outPtr, nsubscriptions, neventsPtr),\n        nowMilliseconds: () => this.pauseClock.nowMilliseconds(),\n        pauseGate: this.pauseGate,\n      });\n      // Must run before `shim.wasiImport` is spread into the instantiate\n      // imports below, or the wasm captures the unpausable clock.\n      installPausableClockTimeGet(\n        shim.wasiImport,\n        () => instanceExports()?.memory,\n        this.pauseClock\n      );\n\n      const response = await fetch(this.options.wasmURL);\n      if (!response.ok) {\n        throw new Error(\n          `failed to load ${String(this.options.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: {\n          ...shim.wasiImport,\n          poll_oneoff: new jspi.Suspending(\n            (inPtr: number, outPtr: number, nsubscriptions: number, neventsPtr: number) =>\n              scheduler.pollOneOff(inPtr, outPtr, nsubscriptions, neventsPtr)\n          ),\n        },\n      });\n      (shim as unknown as { inst: WebAssembly.Instance }).inst =\n        instance as WebAssembly.Instance;\n\n      const start = jspi.promising(\n        (instance as WebAssembly.Instance).exports._start\n      );\n      try {\n        await start();\n        this.options.onExit?.(0);\n      } catch (error) {\n        if (error instanceof WASIProcExit) {\n          this.options.onExit?.(error.code);\n          return;\n        }\n        throw error;\n      }\n    } catch (error) {\n      this.options.onError?.(error instanceof Error ? error.message : String(error));\n    }\n  }\n}\n\nclass MainThreadInputFileDescriptor extends Fd {\n  private readonly queue: MainThreadInputQueue;\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(queue: MainThreadInputQueue) {\n    super();\n    this.queue = queue;\n  }\n\n  override fd_fdstat_get(): { ret: number; fdstat: wasi.Fdstat } {\n    return { ret: wasi.ERRNO_SUCCESS, fdstat: this.fdstat };\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.queue.readAvailable(size);\n    if (chunk) {\n      return { ret: wasi.ERRNO_SUCCESS, data: chunk };\n    }\n    if (this.queue.isClosed()) {\n      return { ret: wasi.ERRNO_SUCCESS, data: new Uint8Array() };\n    }\n    return { ret: wasi.ERRNO_AGAIN, data: new Uint8Array() };\n  }\n}\n"],"mappings":"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"}

package/dist/src/wasi/WasiPollScheduler.js

@@ -8,12 +8,14 @@ var WasiPollScheduler = class {
 	stdin;
 	fallbackPoll;
 	nowMilliseconds;
+	pauseGate;
 	waitBuffer = new Int32Array(new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT));
 	constructor(options) {
 		this.memory = options.memory;
 		this.stdin = options.stdin;
 		this.fallbackPoll = options.fallbackPoll;
 		this.nowMilliseconds = options.nowMilliseconds ?? (() => performance.now());
+		this.pauseGate = options.pauseGate;
 	}
 	pollOneOff(inPtr, outPtr, nsubscriptions, neventsPtr) {
 		const memory = this.memory();
@@ -22,6 +24,7 @@ var WasiPollScheduler = class {
 		const subscriptions = readSubscriptions(view, inPtr, nsubscriptions, this.nowMilliseconds());
 		if (subscriptions === void 0) return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);
 		while (true) {
+			this.pauseGate?.blockWhilePaused();
 			const ready = readySubscriptions(subscriptions, this.stdin, this.nowMilliseconds());
 			if (ready.length > 0) {
 				writeEvents(view, outPtr, ready, this.stdin);
@@ -46,11 +49,13 @@ var SuspendingWasiPollScheduler = class {
 	stdin;
 	fallbackPoll;
 	nowMilliseconds;
+	pauseGate;
 	constructor(options) {
 		this.memory = options.memory;
 		this.stdin = options.stdin;
 		this.fallbackPoll = options.fallbackPoll;
 		this.nowMilliseconds = options.nowMilliseconds ?? (() => performance.now());
+		this.pauseGate = options.pauseGate;
 	}
 	async pollOneOff(inPtr, outPtr, nsubscriptions, neventsPtr) {
 		const memory = this.memory();
@@ -58,6 +63,7 @@ var SuspendingWasiPollScheduler = class {
 		const subscriptions = readSubscriptions(new DataView(memory.buffer), inPtr, nsubscriptions, this.nowMilliseconds());
 		if (subscriptions === void 0) return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);
 		while (true) {
+			await this.pauseGate?.waitWhilePaused();
 			const ready = readySubscriptions(subscriptions, this.stdin, this.nowMilliseconds());
 			if (ready.length > 0) {
 				const view = new DataView(memory.buffer);

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

@@ -1 +1 @@
-{"version":3,"file":"WasiPollScheduler.js","names":[],"sources":["../../../src/wasi/WasiPollScheduler.ts"],"sourcesContent":["import { wasi } from \"@bjorn3/browser_wasi_shim\";\n\nimport type { SharedInputReadiness } from \"./SharedInputQueue.ts\";\n\nconst subscriptionByteLength = 48;\nconst eventByteLength = 32;\nconst maximumAtomicsWaitMilliseconds = 2_147_483_647;\n\ninterface ClockSubscription {\n  readonly type: \"clock\";\n  readonly userdata: bigint;\n  readonly clockid: number;\n  readonly deadlineMilliseconds: number;\n}\n\ninterface FdReadSubscription {\n  readonly type: \"fdRead\";\n  readonly userdata: bigint;\n  readonly fd: number;\n}\n\ntype SupportedSubscription = ClockSubscription | FdReadSubscription;\n\nexport interface WasiPollReadableState {\n  availableBytes(): number;\n  isClosed(): boolean;\n}\n\nexport interface WasiPollReadableSource extends WasiPollReadableState {\n  waitForReadable(timeoutMilliseconds?: number): SharedInputReadiness;\n}\n\nexport interface SuspendingWasiPollReadableSource extends WasiPollReadableState {\n  waitForReadableAsync(timeoutMilliseconds?: number): Promise<SharedInputReadiness>;\n}\n\nexport interface WasiPollSchedulerOptions {\n  memory(): WebAssembly.Memory | undefined;\n  stdin: WasiPollReadableSource;\n  fallbackPoll(\n    inPtr: number,\n    outPtr: number,\n    nsubscriptions: number,\n    neventsPtr?: number\n  ): number;\n  nowMilliseconds?(): number;\n}\n\nexport class WasiPollScheduler {\n  private readonly memory: WasiPollSchedulerOptions[\"memory\"];\n  private readonly stdin: WasiPollReadableSource;\n  private readonly fallbackPoll: WasiPollSchedulerOptions[\"fallbackPoll\"];\n  private readonly nowMilliseconds: () => number;\n  private readonly waitBuffer = new Int32Array(\n    new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT)\n  );\n\n  constructor(options: WasiPollSchedulerOptions) {\n    this.memory = options.memory;\n    this.stdin = options.stdin;\n    this.fallbackPoll = options.fallbackPoll;\n    this.nowMilliseconds = options.nowMilliseconds ?? (() => performance.now());\n  }\n\n  pollOneOff(\n    inPtr: number,\n    outPtr: number,\n    nsubscriptions: number,\n    neventsPtr?: number\n  ): number {\n    const memory = this.memory();\n    if (!memory || nsubscriptions <= 0) {\n      return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n    }\n\n    const view = new DataView(memory.buffer);\n    const subscriptions = readSubscriptions(\n      view,\n      inPtr,\n      nsubscriptions,\n      this.nowMilliseconds()\n    );\n    if (subscriptions === undefined) {\n      return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n    }\n\n    while (true) {\n      const ready = readySubscriptions(subscriptions, this.stdin, this.nowMilliseconds());\n      if (ready.length > 0) {\n        writeEvents(view, outPtr, ready, this.stdin);\n        if (neventsPtr !== undefined) {\n          view.setUint32(neventsPtr, ready.length, true);\n        }\n        return wasi.ERRNO_SUCCESS;\n      }\n\n      const timeoutMilliseconds = shortestClockTimeoutMilliseconds(\n        subscriptions,\n        this.nowMilliseconds()\n      );\n      if (hasFdReadSubscription(subscriptions)) {\n        this.stdin.waitForReadable(timeoutMilliseconds);\n      } else if (timeoutMilliseconds !== undefined) {\n        Atomics.wait(\n          this.waitBuffer,\n          0,\n          0,\n          Math.min(timeoutMilliseconds, maximumAtomicsWaitMilliseconds)\n        );\n      } else {\n        return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n      }\n    }\n  }\n}\n\nexport interface SuspendingWasiPollSchedulerOptions {\n  memory(): WebAssembly.Memory | undefined;\n  stdin: SuspendingWasiPollReadableSource;\n  fallbackPoll(\n    inPtr: number,\n    outPtr: number,\n    nsubscriptions: number,\n    neventsPtr?: number\n  ): number;\n  nowMilliseconds?(): number;\n}\n\n/**\n * The JSPI (main-thread) counterpart of `WasiPollScheduler`: identical\n * subscription semantics, but the blocking waits become awaited promises so\n * the surrounding `poll_oneoff` import can be wrapped in\n * `WebAssembly.Suspending` and run without a worker or SharedArrayBuffer.\n */\nexport class SuspendingWasiPollScheduler {\n  private readonly memory: SuspendingWasiPollSchedulerOptions[\"memory\"];\n  private readonly stdin: SuspendingWasiPollReadableSource;\n  private readonly fallbackPoll: SuspendingWasiPollSchedulerOptions[\"fallbackPoll\"];\n  private readonly nowMilliseconds: () => number;\n\n  constructor(options: SuspendingWasiPollSchedulerOptions) {\n    this.memory = options.memory;\n    this.stdin = options.stdin;\n    this.fallbackPoll = options.fallbackPoll;\n    this.nowMilliseconds = options.nowMilliseconds ?? (() => performance.now());\n  }\n\n  async pollOneOff(\n    inPtr: number,\n    outPtr: number,\n    nsubscriptions: number,\n    neventsPtr?: number\n  ): Promise<number> {\n    const memory = this.memory();\n    if (!memory || nsubscriptions <= 0) {\n      return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n    }\n\n    const subscriptions = readSubscriptions(\n      new DataView(memory.buffer),\n      inPtr,\n      nsubscriptions,\n      this.nowMilliseconds()\n    );\n    if (subscriptions === undefined) {\n      return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n    }\n\n    while (true) {\n      const ready = readySubscriptions(subscriptions, this.stdin, this.nowMilliseconds());\n      if (ready.length > 0) {\n        // Re-derive the view each pass: memory.buffer detaches when the wasm\n        // grows memory while we were suspended.\n        const view = new DataView(memory.buffer);\n        writeEvents(view, outPtr, ready, this.stdin);\n        if (neventsPtr !== undefined) {\n          view.setUint32(neventsPtr, ready.length, true);\n        }\n        return wasi.ERRNO_SUCCESS;\n      }\n\n      const timeoutMilliseconds = shortestClockTimeoutMilliseconds(\n        subscriptions,\n        this.nowMilliseconds()\n      );\n      if (hasFdReadSubscription(subscriptions)) {\n        await this.stdin.waitForReadableAsync(timeoutMilliseconds);\n      } else if (timeoutMilliseconds !== undefined) {\n        await new Promise((resolve) =>\n          setTimeout(resolve, Math.min(timeoutMilliseconds, maximumAtomicsWaitMilliseconds))\n        );\n      } else {\n        return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n      }\n    }\n  }\n}\n\nfunction readSubscriptions(\n  view: DataView,\n  inPtr: number,\n  nsubscriptions: number,\n  nowMilliseconds: number\n): SupportedSubscription[] | undefined {\n  const subscriptions: SupportedSubscription[] = [];\n  for (let index = 0; index < nsubscriptions; index += 1) {\n    const subscription = wasi.Subscription.read_bytes(\n      view,\n      inPtr + index * subscriptionByteLength\n    );\n    switch (subscription.eventtype) {\n    case wasi.EVENTTYPE_CLOCK:\n      if (!isSupportedClockId(subscription.clockid)) {\n        return undefined;\n      }\n      subscriptions.push({\n        type: \"clock\",\n        userdata: subscription.userdata,\n        clockid: subscription.clockid,\n        deadlineMilliseconds: clockDeadlineMilliseconds(subscription, nowMilliseconds),\n      });\n      break;\n    case wasi.EVENTTYPE_FD_READ:\n      if (subscription.clockid !== wasi.FD_STDIN) {\n        return undefined;\n      }\n      subscriptions.push({\n        type: \"fdRead\",\n        userdata: subscription.userdata,\n        fd: subscription.clockid,\n      });\n      break;\n    default:\n      return undefined;\n    }\n  }\n  return subscriptions;\n}\n\nfunction isSupportedClockId(\n  clockid: number\n): boolean {\n  return clockid === wasi.CLOCKID_MONOTONIC || clockid === wasi.CLOCKID_REALTIME;\n}\n\nfunction shortestClockTimeoutMilliseconds(\n  subscriptions: readonly SupportedSubscription[],\n  nowMilliseconds: number\n): number | undefined {\n  let timeoutMilliseconds: number | undefined;\n  for (const subscription of subscriptions) {\n    if (subscription.type !== \"clock\") {\n      continue;\n    }\n    const remaining = clockRemainingMilliseconds(subscription, nowMilliseconds);\n    timeoutMilliseconds = timeoutMilliseconds === undefined\n      ? remaining\n      : Math.min(timeoutMilliseconds, remaining);\n  }\n  return timeoutMilliseconds;\n}\n\nfunction readySubscriptions(\n  subscriptions: readonly SupportedSubscription[],\n  stdin: WasiPollReadableState,\n  nowMilliseconds: number\n): SupportedSubscription[] {\n  return subscriptions.filter((subscription) => {\n    switch (subscription.type) {\n    case \"clock\":\n      return clockRemainingMilliseconds(subscription, nowMilliseconds) <= 0;\n    case \"fdRead\":\n      return stdin.availableBytes() > 0 || stdin.isClosed();\n    }\n  });\n}\n\nfunction hasFdReadSubscription(\n  subscriptions: readonly SupportedSubscription[]\n): boolean {\n  return subscriptions.some((subscription) => subscription.type === \"fdRead\");\n}\n\nfunction clockRemainingMilliseconds(\n  subscription: ClockSubscription,\n  nowMilliseconds: number\n): number {\n  return Math.max(0, subscription.deadlineMilliseconds - nowMillisecondsForClock(\n    subscription.clockid,\n    nowMilliseconds\n  ));\n}\n\nfunction clockDeadlineMilliseconds(\n  subscription: wasi.Subscription,\n  nowMilliseconds: number\n): number {\n  if ((subscription.flags & wasi.SUBCLOCKFLAGS_SUBSCRIPTION_CLOCK_ABSTIME) !== 0) {\n    return Number(subscription.timeout) / 1_000_000;\n  }\n  return nowMillisecondsForClock(subscription.clockid, nowMilliseconds)\n    + Number(subscription.timeout) / 1_000_000;\n}\n\nfunction nowMillisecondsForClock(\n  clockid: number,\n  nowMilliseconds: number\n): number {\n  if (clockid === wasi.CLOCKID_REALTIME) {\n    return Date.now();\n  }\n  return nowMilliseconds;\n}\n\nfunction writeEvents(\n  view: DataView,\n  outPtr: number,\n  subscriptions: readonly SupportedSubscription[],\n  stdin: WasiPollReadableSource\n): void {\n  subscriptions.forEach((subscription, index) => {\n    const eventtype = subscription.type === \"clock\"\n      ? wasi.EVENTTYPE_CLOCK\n      : wasi.EVENTTYPE_FD_READ;\n    const offset = outPtr + index * eventByteLength;\n    new wasi.Event(\n      subscription.userdata,\n      wasi.ERRNO_SUCCESS,\n      eventtype\n    ).write_bytes(view, offset);\n    if (subscription.type === \"fdRead\") {\n      const availableBytes = Math.max(0, stdin.availableBytes());\n      view.setBigUint64(offset + 16, BigInt(availableBytes), true);\n      if (availableBytes === 0 && stdin.isClosed()) {\n        view.setUint16(offset + 24, wasi.EVENTRWFLAGS_FD_READWRITE_HANGUP, true);\n      }\n    }\n  });\n}\n\nexport function writeClockSubscriptionForTesting(\n  view: DataView,\n  offset: number,\n  subscription: {\n    userdata: bigint;\n    timeoutNanoseconds: bigint;\n    clockid?: number;\n    flags?: number;\n  }\n): void {\n  clearRecord(view, offset, subscriptionByteLength);\n  view.setBigUint64(offset, subscription.userdata, true);\n  view.setUint8(offset + 8, wasi.EVENTTYPE_CLOCK);\n  view.setUint32(offset + 16, subscription.clockid ?? wasi.CLOCKID_MONOTONIC, true);\n  view.setBigUint64(offset + 24, subscription.timeoutNanoseconds, true);\n  view.setUint16(offset + 36, subscription.flags ?? 0, true);\n}\n\nexport function writeFdReadSubscriptionForTesting(\n  view: DataView,\n  offset: number,\n  subscription: {\n    userdata: bigint;\n    fd: number;\n  }\n): void {\n  clearRecord(view, offset, subscriptionByteLength);\n  view.setBigUint64(offset, subscription.userdata, true);\n  view.setUint8(offset + 8, wasi.EVENTTYPE_FD_READ);\n  view.setUint32(offset + 16, subscription.fd, true);\n}\n\nexport function readPollEventsForTesting(\n  view: DataView,\n  offset: number,\n  count: number\n): Array<{ userdata: bigint; errno: number; eventtype: number }> {\n  return Array.from({ length: count }, (_, index) => {\n    const eventOffset = offset + index * eventByteLength;\n    return {\n      userdata: view.getBigUint64(eventOffset, true),\n      errno: view.getUint16(eventOffset + 8, true),\n      eventtype: view.getUint8(eventOffset + 10),\n    };\n  });\n}\n\nfunction clearRecord(\n  view: DataView,\n  offset: number,\n  byteLength: number\n): void {\n  new Uint8Array(view.buffer, offset, byteLength).fill(0);\n}\n"],"mappings":"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"}
+{"version":3,"file":"WasiPollScheduler.js","names":[],"sources":["../../../src/wasi/WasiPollScheduler.ts"],"sourcesContent":["import { wasi } from \"@bjorn3/browser_wasi_shim\";\n\nimport type { SharedInputReadiness } from \"./SharedInputQueue.ts\";\n\nconst subscriptionByteLength = 48;\nconst eventByteLength = 32;\nconst maximumAtomicsWaitMilliseconds = 2_147_483_647;\n\ninterface ClockSubscription {\n  readonly type: \"clock\";\n  readonly userdata: bigint;\n  readonly clockid: number;\n  readonly deadlineMilliseconds: number;\n}\n\ninterface FdReadSubscription {\n  readonly type: \"fdRead\";\n  readonly userdata: bigint;\n  readonly fd: number;\n}\n\ntype SupportedSubscription = ClockSubscription | FdReadSubscription;\n\nexport interface WasiPollReadableState {\n  availableBytes(): number;\n  isClosed(): boolean;\n}\n\nexport interface WasiPollReadableSource extends WasiPollReadableState {\n  waitForReadable(timeoutMilliseconds?: number): SharedInputReadiness;\n}\n\nexport interface SuspendingWasiPollReadableSource extends WasiPollReadableState {\n  waitForReadableAsync(timeoutMilliseconds?: number): Promise<SharedInputReadiness>;\n}\n\n/**\n * Host-controlled suspension seam for the blocking (worker) scheduler. The\n * gate is consulted between waits: while the host holds the runtime paused,\n * `blockWhilePaused` parks the worker thread and — via the shared pausable\n * clock — excludes the parked time from every clock deadline, so pending\n * timeouts resume with their remaining time intact.\n */\nexport interface WasiPollPauseGate {\n  blockWhilePaused(): void;\n}\n\n/** The awaited counterpart of {@link WasiPollPauseGate} for the JSPI path. */\nexport interface SuspendingWasiPollPauseGate {\n  waitWhilePaused(): Promise<void>;\n}\n\nexport interface WasiPollSchedulerOptions {\n  memory(): WebAssembly.Memory | undefined;\n  stdin: WasiPollReadableSource;\n  fallbackPoll(\n    inPtr: number,\n    outPtr: number,\n    nsubscriptions: number,\n    neventsPtr?: number\n  ): number;\n  nowMilliseconds?(): number;\n  pauseGate?: WasiPollPauseGate;\n}\n\nexport class WasiPollScheduler {\n  private readonly memory: WasiPollSchedulerOptions[\"memory\"];\n  private readonly stdin: WasiPollReadableSource;\n  private readonly fallbackPoll: WasiPollSchedulerOptions[\"fallbackPoll\"];\n  private readonly nowMilliseconds: () => number;\n  private readonly pauseGate?: WasiPollPauseGate;\n  private readonly waitBuffer = new Int32Array(\n    new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT)\n  );\n\n  constructor(options: WasiPollSchedulerOptions) {\n    this.memory = options.memory;\n    this.stdin = options.stdin;\n    this.fallbackPoll = options.fallbackPoll;\n    this.nowMilliseconds = options.nowMilliseconds ?? (() => performance.now());\n    this.pauseGate = options.pauseGate;\n  }\n\n  pollOneOff(\n    inPtr: number,\n    outPtr: number,\n    nsubscriptions: number,\n    neventsPtr?: number\n  ): number {\n    const memory = this.memory();\n    if (!memory || nsubscriptions <= 0) {\n      return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n    }\n\n    const view = new DataView(memory.buffer);\n    const subscriptions = readSubscriptions(\n      view,\n      inPtr,\n      nsubscriptions,\n      this.nowMilliseconds()\n    );\n    if (subscriptions === undefined) {\n      return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n    }\n\n    while (true) {\n      this.pauseGate?.blockWhilePaused();\n      const ready = readySubscriptions(subscriptions, this.stdin, this.nowMilliseconds());\n      if (ready.length > 0) {\n        writeEvents(view, outPtr, ready, this.stdin);\n        if (neventsPtr !== undefined) {\n          view.setUint32(neventsPtr, ready.length, true);\n        }\n        return wasi.ERRNO_SUCCESS;\n      }\n\n      const timeoutMilliseconds = shortestClockTimeoutMilliseconds(\n        subscriptions,\n        this.nowMilliseconds()\n      );\n      if (hasFdReadSubscription(subscriptions)) {\n        this.stdin.waitForReadable(timeoutMilliseconds);\n      } else if (timeoutMilliseconds !== undefined) {\n        Atomics.wait(\n          this.waitBuffer,\n          0,\n          0,\n          Math.min(timeoutMilliseconds, maximumAtomicsWaitMilliseconds)\n        );\n      } else {\n        return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n      }\n    }\n  }\n}\n\nexport interface SuspendingWasiPollSchedulerOptions {\n  memory(): WebAssembly.Memory | undefined;\n  stdin: SuspendingWasiPollReadableSource;\n  fallbackPoll(\n    inPtr: number,\n    outPtr: number,\n    nsubscriptions: number,\n    neventsPtr?: number\n  ): number;\n  nowMilliseconds?(): number;\n  pauseGate?: SuspendingWasiPollPauseGate;\n}\n\n/**\n * The JSPI (main-thread) counterpart of `WasiPollScheduler`: identical\n * subscription semantics, but the blocking waits become awaited promises so\n * the surrounding `poll_oneoff` import can be wrapped in\n * `WebAssembly.Suspending` and run without a worker or SharedArrayBuffer.\n */\nexport class SuspendingWasiPollScheduler {\n  private readonly memory: SuspendingWasiPollSchedulerOptions[\"memory\"];\n  private readonly stdin: SuspendingWasiPollReadableSource;\n  private readonly fallbackPoll: SuspendingWasiPollSchedulerOptions[\"fallbackPoll\"];\n  private readonly nowMilliseconds: () => number;\n  private readonly pauseGate?: SuspendingWasiPollPauseGate;\n\n  constructor(options: SuspendingWasiPollSchedulerOptions) {\n    this.memory = options.memory;\n    this.stdin = options.stdin;\n    this.fallbackPoll = options.fallbackPoll;\n    this.nowMilliseconds = options.nowMilliseconds ?? (() => performance.now());\n    this.pauseGate = options.pauseGate;\n  }\n\n  async pollOneOff(\n    inPtr: number,\n    outPtr: number,\n    nsubscriptions: number,\n    neventsPtr?: number\n  ): Promise<number> {\n    const memory = this.memory();\n    if (!memory || nsubscriptions <= 0) {\n      return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n    }\n\n    const subscriptions = readSubscriptions(\n      new DataView(memory.buffer),\n      inPtr,\n      nsubscriptions,\n      this.nowMilliseconds()\n    );\n    if (subscriptions === undefined) {\n      return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n    }\n\n    while (true) {\n      await this.pauseGate?.waitWhilePaused();\n      const ready = readySubscriptions(subscriptions, this.stdin, this.nowMilliseconds());\n      if (ready.length > 0) {\n        // Re-derive the view each pass: memory.buffer detaches when the wasm\n        // grows memory while we were suspended.\n        const view = new DataView(memory.buffer);\n        writeEvents(view, outPtr, ready, this.stdin);\n        if (neventsPtr !== undefined) {\n          view.setUint32(neventsPtr, ready.length, true);\n        }\n        return wasi.ERRNO_SUCCESS;\n      }\n\n      const timeoutMilliseconds = shortestClockTimeoutMilliseconds(\n        subscriptions,\n        this.nowMilliseconds()\n      );\n      if (hasFdReadSubscription(subscriptions)) {\n        await this.stdin.waitForReadableAsync(timeoutMilliseconds);\n      } else if (timeoutMilliseconds !== undefined) {\n        await new Promise((resolve) =>\n          setTimeout(resolve, Math.min(timeoutMilliseconds, maximumAtomicsWaitMilliseconds))\n        );\n      } else {\n        return this.fallbackPoll(inPtr, outPtr, nsubscriptions, neventsPtr);\n      }\n    }\n  }\n}\n\nfunction readSubscriptions(\n  view: DataView,\n  inPtr: number,\n  nsubscriptions: number,\n  nowMilliseconds: number\n): SupportedSubscription[] | undefined {\n  const subscriptions: SupportedSubscription[] = [];\n  for (let index = 0; index < nsubscriptions; index += 1) {\n    const subscription = wasi.Subscription.read_bytes(\n      view,\n      inPtr + index * subscriptionByteLength\n    );\n    switch (subscription.eventtype) {\n    case wasi.EVENTTYPE_CLOCK:\n      if (!isSupportedClockId(subscription.clockid)) {\n        return undefined;\n      }\n      subscriptions.push({\n        type: \"clock\",\n        userdata: subscription.userdata,\n        clockid: subscription.clockid,\n        deadlineMilliseconds: clockDeadlineMilliseconds(subscription, nowMilliseconds),\n      });\n      break;\n    case wasi.EVENTTYPE_FD_READ:\n      if (subscription.clockid !== wasi.FD_STDIN) {\n        return undefined;\n      }\n      subscriptions.push({\n        type: \"fdRead\",\n        userdata: subscription.userdata,\n        fd: subscription.clockid,\n      });\n      break;\n    default:\n      return undefined;\n    }\n  }\n  return subscriptions;\n}\n\nfunction isSupportedClockId(\n  clockid: number\n): boolean {\n  return clockid === wasi.CLOCKID_MONOTONIC || clockid === wasi.CLOCKID_REALTIME;\n}\n\nfunction shortestClockTimeoutMilliseconds(\n  subscriptions: readonly SupportedSubscription[],\n  nowMilliseconds: number\n): number | undefined {\n  let timeoutMilliseconds: number | undefined;\n  for (const subscription of subscriptions) {\n    if (subscription.type !== \"clock\") {\n      continue;\n    }\n    const remaining = clockRemainingMilliseconds(subscription, nowMilliseconds);\n    timeoutMilliseconds = timeoutMilliseconds === undefined\n      ? remaining\n      : Math.min(timeoutMilliseconds, remaining);\n  }\n  return timeoutMilliseconds;\n}\n\nfunction readySubscriptions(\n  subscriptions: readonly SupportedSubscription[],\n  stdin: WasiPollReadableState,\n  nowMilliseconds: number\n): SupportedSubscription[] {\n  return subscriptions.filter((subscription) => {\n    switch (subscription.type) {\n    case \"clock\":\n      return clockRemainingMilliseconds(subscription, nowMilliseconds) <= 0;\n    case \"fdRead\":\n      return stdin.availableBytes() > 0 || stdin.isClosed();\n    }\n  });\n}\n\nfunction hasFdReadSubscription(\n  subscriptions: readonly SupportedSubscription[]\n): boolean {\n  return subscriptions.some((subscription) => subscription.type === \"fdRead\");\n}\n\nfunction clockRemainingMilliseconds(\n  subscription: ClockSubscription,\n  nowMilliseconds: number\n): number {\n  return Math.max(0, subscription.deadlineMilliseconds - nowMillisecondsForClock(\n    subscription.clockid,\n    nowMilliseconds\n  ));\n}\n\nfunction clockDeadlineMilliseconds(\n  subscription: wasi.Subscription,\n  nowMilliseconds: number\n): number {\n  if ((subscription.flags & wasi.SUBCLOCKFLAGS_SUBSCRIPTION_CLOCK_ABSTIME) !== 0) {\n    return Number(subscription.timeout) / 1_000_000;\n  }\n  return nowMillisecondsForClock(subscription.clockid, nowMilliseconds)\n    + Number(subscription.timeout) / 1_000_000;\n}\n\nfunction nowMillisecondsForClock(\n  clockid: number,\n  nowMilliseconds: number\n): number {\n  if (clockid === wasi.CLOCKID_REALTIME) {\n    return Date.now();\n  }\n  return nowMilliseconds;\n}\n\nfunction writeEvents(\n  view: DataView,\n  outPtr: number,\n  subscriptions: readonly SupportedSubscription[],\n  stdin: WasiPollReadableSource\n): void {\n  subscriptions.forEach((subscription, index) => {\n    const eventtype = subscription.type === \"clock\"\n      ? wasi.EVENTTYPE_CLOCK\n      : wasi.EVENTTYPE_FD_READ;\n    const offset = outPtr + index * eventByteLength;\n    new wasi.Event(\n      subscription.userdata,\n      wasi.ERRNO_SUCCESS,\n      eventtype\n    ).write_bytes(view, offset);\n    if (subscription.type === \"fdRead\") {\n      const availableBytes = Math.max(0, stdin.availableBytes());\n      view.setBigUint64(offset + 16, BigInt(availableBytes), true);\n      if (availableBytes === 0 && stdin.isClosed()) {\n        view.setUint16(offset + 24, wasi.EVENTRWFLAGS_FD_READWRITE_HANGUP, true);\n      }\n    }\n  });\n}\n\nexport function writeClockSubscriptionForTesting(\n  view: DataView,\n  offset: number,\n  subscription: {\n    userdata: bigint;\n    timeoutNanoseconds: bigint;\n    clockid?: number;\n    flags?: number;\n  }\n): void {\n  clearRecord(view, offset, subscriptionByteLength);\n  view.setBigUint64(offset, subscription.userdata, true);\n  view.setUint8(offset + 8, wasi.EVENTTYPE_CLOCK);\n  view.setUint32(offset + 16, subscription.clockid ?? wasi.CLOCKID_MONOTONIC, true);\n  view.setBigUint64(offset + 24, subscription.timeoutNanoseconds, true);\n  view.setUint16(offset + 36, subscription.flags ?? 0, true);\n}\n\nexport function writeFdReadSubscriptionForTesting(\n  view: DataView,\n  offset: number,\n  subscription: {\n    userdata: bigint;\n    fd: number;\n  }\n): void {\n  clearRecord(view, offset, subscriptionByteLength);\n  view.setBigUint64(offset, subscription.userdata, true);\n  view.setUint8(offset + 8, wasi.EVENTTYPE_FD_READ);\n  view.setUint32(offset + 16, subscription.fd, true);\n}\n\nexport function readPollEventsForTesting(\n  view: DataView,\n  offset: number,\n  count: number\n): Array<{ userdata: bigint; errno: number; eventtype: number }> {\n  return Array.from({ length: count }, (_, index) => {\n    const eventOffset = offset + index * eventByteLength;\n    return {\n      userdata: view.getBigUint64(eventOffset, true),\n      errno: view.getUint16(eventOffset + 8, true),\n      eventtype: view.getUint8(eventOffset + 10),\n    };\n  });\n}\n\nfunction clearRecord(\n  view: DataView,\n  offset: number,\n  byteLength: number\n): void {\n  new Uint8Array(view.buffer, offset, byteLength).fill(0);\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,63 @@
+//#region src/wasi/WasmRuntimePause.d.ts
+/**
+ * A monotonic clock that excludes time spent paused. `nowMilliseconds()`
+ * mirrors `performance.now()` minus every accumulated pause, so WASI clock
+ * reads (`clock_time_get`) and `poll_oneoff` deadline math both observe a
+ * frozen clock across a pause: pending timeouts keep their remaining time,
+ * no expired-deadline catch-up burst fires on resume, and app-side animation
+ * clocks do not jump.
+ */
+declare class PausableMonotonicClock {
+  private readonly rawNowMilliseconds;
+  private accumulatedPauseMilliseconds;
+  constructor(rawNowMilliseconds?: () => number);
+  nowMilliseconds(): number;
+  nowNanoseconds(): bigint;
+  addPausedMilliseconds(milliseconds: number): void;
+  get pausedMilliseconds(): number;
+}
+/**
+ * Creates the shared pause cell the main thread uses to suspend a wasm scene
+ * worker. One Int32 slot: 0 = running, 1 = paused. The worker parks on the
+ * cell between `poll_oneoff` waits, so a paused scene costs zero CPU.
+ */
+declare function createWasmPauseCell(): SharedArrayBuffer;
+declare function setWasmPauseCellPaused(cell: SharedArrayBuffer, paused: boolean): void;
+declare function isWasmPauseCellPaused(cell: SharedArrayBuffer): boolean;
+/**
+ * Worker-side pause gate: blocks the calling (worker) thread while the shared
+ * pause cell is set, then credits the parked wall time to the pausable clock.
+ * Must never run on a browser main thread — `Atomics.wait` is worker-only.
+ */
+declare class WorkerWasmPauseGate {
+  private readonly flags;
+  private readonly clock;
+  private readonly rawNowMilliseconds;
+  constructor(cell: SharedArrayBuffer, clock: PausableMonotonicClock, rawNowMilliseconds?: () => number);
+  blockWhilePaused(): void;
+}
+/**
+ * Main-thread (JSPI) pause gate: the awaited counterpart of
+ * `WorkerWasmPauseGate`. While paused, `waitWhilePaused` suspends on a promise
+ * that `setPaused(false)` resolves, then credits the parked time to the clock.
+ */
+declare class MainThreadWasmPauseGate {
+  private readonly clock;
+  private readonly rawNowMilliseconds;
+  private paused;
+  private resumeWaiters;
+  constructor(clock: PausableMonotonicClock, rawNowMilliseconds?: () => number);
+  get isPaused(): boolean;
+  setPaused(paused: boolean): void;
+  waitWhilePaused(): Promise<void>;
+}
+/**
+ * Redirects the WASI `clock_time_get` import's MONOTONIC reads through the
+ * pausable clock so app-side time agrees with the pause-aware `poll_oneoff`
+ * deadline math. Non-monotonic clocks (REALTIME) keep the shim's behavior —
+ * wall-clock time genuinely advances across a pause.
+ */
+declare function installPausableClockTimeGet(wasiImport: Record<string, unknown>, memory: () => WebAssembly.Memory | undefined, clock: PausableMonotonicClock): void;
+//#endregion
+export { MainThreadWasmPauseGate, PausableMonotonicClock, WorkerWasmPauseGate, createWasmPauseCell, installPausableClockTimeGet, isWasmPauseCellPaused, setWasmPauseCellPaused };
+//# sourceMappingURL=WasmRuntimePause.d.ts.map

package/dist/src/wasi/WasmRuntimePause.js

@@ -0,0 +1,130 @@
+import { wasi } from "@bjorn3/browser_wasi_shim";
+//#region src/wasi/WasmRuntimePause.ts
+const pausedFlagValue = 1;
+/**
+* A monotonic clock that excludes time spent paused. `nowMilliseconds()`
+* mirrors `performance.now()` minus every accumulated pause, so WASI clock
+* reads (`clock_time_get`) and `poll_oneoff` deadline math both observe a
+* frozen clock across a pause: pending timeouts keep their remaining time,
+* no expired-deadline catch-up burst fires on resume, and app-side animation
+* clocks do not jump.
+*/
+var PausableMonotonicClock = class {
+	rawNowMilliseconds;
+	accumulatedPauseMilliseconds = 0;
+	constructor(rawNowMilliseconds = () => performance.now()) {
+		this.rawNowMilliseconds = rawNowMilliseconds;
+	}
+	nowMilliseconds() {
+		return this.rawNowMilliseconds() - this.accumulatedPauseMilliseconds;
+	}
+	nowNanoseconds() {
+		return BigInt(Math.round(this.nowMilliseconds() * 1e6));
+	}
+	addPausedMilliseconds(milliseconds) {
+		if (milliseconds > 0) this.accumulatedPauseMilliseconds += milliseconds;
+	}
+	get pausedMilliseconds() {
+		return this.accumulatedPauseMilliseconds;
+	}
+};
+/**
+* Creates the shared pause cell the main thread uses to suspend a wasm scene
+* worker. One Int32 slot: 0 = running, 1 = paused. The worker parks on the
+* cell between `poll_oneoff` waits, so a paused scene costs zero CPU.
+*/
+function createWasmPauseCell() {
+	if (typeof SharedArrayBuffer === "undefined") throw new Error("SharedArrayBuffer is unavailable. Serve the app with COOP/COEP headers so worker-mode pause can work.");
+	return new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT);
+}
+function setWasmPauseCellPaused(cell, paused) {
+	const flags = new Int32Array(cell);
+	Atomics.store(flags, 0, paused ? pausedFlagValue : 0);
+	if (!paused) Atomics.notify(flags, 0);
+}
+function isWasmPauseCellPaused(cell) {
+	return Atomics.load(new Int32Array(cell), 0) === pausedFlagValue;
+}
+/**
+* Worker-side pause gate: blocks the calling (worker) thread while the shared
+* pause cell is set, then credits the parked wall time to the pausable clock.
+* Must never run on a browser main thread — `Atomics.wait` is worker-only.
+*/
+var WorkerWasmPauseGate = class {
+	flags;
+	clock;
+	rawNowMilliseconds;
+	constructor(cell, clock, rawNowMilliseconds = () => performance.now()) {
+		this.flags = new Int32Array(cell);
+		this.clock = clock;
+		this.rawNowMilliseconds = rawNowMilliseconds;
+	}
+	blockWhilePaused() {
+		let pausedMilliseconds = 0;
+		while (Atomics.load(this.flags, 0) === pausedFlagValue) {
+			const parkStart = this.rawNowMilliseconds();
+			Atomics.wait(this.flags, 0, pausedFlagValue);
+			pausedMilliseconds += this.rawNowMilliseconds() - parkStart;
+		}
+		this.clock.addPausedMilliseconds(pausedMilliseconds);
+	}
+};
+/**
+* Main-thread (JSPI) pause gate: the awaited counterpart of
+* `WorkerWasmPauseGate`. While paused, `waitWhilePaused` suspends on a promise
+* that `setPaused(false)` resolves, then credits the parked time to the clock.
+*/
+var MainThreadWasmPauseGate = class {
+	clock;
+	rawNowMilliseconds;
+	paused = false;
+	resumeWaiters = [];
+	constructor(clock, rawNowMilliseconds = () => performance.now()) {
+		this.clock = clock;
+		this.rawNowMilliseconds = rawNowMilliseconds;
+	}
+	get isPaused() {
+		return this.paused;
+	}
+	setPaused(paused) {
+		if (this.paused === paused) return;
+		this.paused = paused;
+		if (!paused) {
+			const waiters = this.resumeWaiters;
+			this.resumeWaiters = [];
+			for (const resume of waiters) resume();
+		}
+	}
+	async waitWhilePaused() {
+		let pausedMilliseconds = 0;
+		while (this.paused) {
+			const parkStart = this.rawNowMilliseconds();
+			await new Promise((resolve) => {
+				this.resumeWaiters.push(resolve);
+			});
+			pausedMilliseconds += this.rawNowMilliseconds() - parkStart;
+		}
+		this.clock.addPausedMilliseconds(pausedMilliseconds);
+	}
+};
+/**
+* Redirects the WASI `clock_time_get` import's MONOTONIC reads through the
+* pausable clock so app-side time agrees with the pause-aware `poll_oneoff`
+* deadline math. Non-monotonic clocks (REALTIME) keep the shim's behavior —
+* wall-clock time genuinely advances across a pause.
+*/
+function installPausableClockTimeGet(wasiImport, memory, clock) {
+	const original = wasiImport.clock_time_get;
+	if (typeof original !== "function") return;
+	wasiImport.clock_time_get = (clockid, precision, timePtr) => {
+		if (clockid !== wasi.CLOCKID_MONOTONIC) return original(clockid, precision, timePtr);
+		const currentMemory = memory();
+		if (!currentMemory) return original(clockid, precision, timePtr);
+		new DataView(currentMemory.buffer).setBigUint64(timePtr, clock.nowNanoseconds(), true);
+		return wasi.ERRNO_SUCCESS;
+	};
+}
+//#endregion
+export { MainThreadWasmPauseGate, PausableMonotonicClock, WorkerWasmPauseGate, createWasmPauseCell, installPausableClockTimeGet, isWasmPauseCellPaused, setWasmPauseCellPaused };
+
+//# sourceMappingURL=WasmRuntimePause.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WasmRuntimePause.js","names":[],"sources":["../../../src/wasi/WasmRuntimePause.ts"],"sourcesContent":["import { wasi } from \"@bjorn3/browser_wasi_shim\";\n\nconst pausedFlagValue = 1;\n\n/**\n * A monotonic clock that excludes time spent paused. `nowMilliseconds()`\n * mirrors `performance.now()` minus every accumulated pause, so WASI clock\n * reads (`clock_time_get`) and `poll_oneoff` deadline math both observe a\n * frozen clock across a pause: pending timeouts keep their remaining time,\n * no expired-deadline catch-up burst fires on resume, and app-side animation\n * clocks do not jump.\n */\nexport class PausableMonotonicClock {\n  private readonly rawNowMilliseconds: () => number;\n  private accumulatedPauseMilliseconds = 0;\n\n  constructor(rawNowMilliseconds: () => number = () => performance.now()) {\n    this.rawNowMilliseconds = rawNowMilliseconds;\n  }\n\n  nowMilliseconds(): number {\n    return this.rawNowMilliseconds() - this.accumulatedPauseMilliseconds;\n  }\n\n  nowNanoseconds(): bigint {\n    return BigInt(Math.round(this.nowMilliseconds() * 1e6));\n  }\n\n  addPausedMilliseconds(\n    milliseconds: number\n  ): void {\n    if (milliseconds > 0) {\n      this.accumulatedPauseMilliseconds += milliseconds;\n    }\n  }\n\n  get pausedMilliseconds(): number {\n    return this.accumulatedPauseMilliseconds;\n  }\n}\n\n/**\n * Creates the shared pause cell the main thread uses to suspend a wasm scene\n * worker. One Int32 slot: 0 = running, 1 = paused. The worker parks on the\n * cell between `poll_oneoff` waits, so a paused scene costs zero CPU.\n */\nexport function createWasmPauseCell(): SharedArrayBuffer {\n  if (typeof SharedArrayBuffer === \"undefined\") {\n    throw new Error(\n      \"SharedArrayBuffer is unavailable. Serve the app with COOP/COEP headers so worker-mode pause can work.\"\n    );\n  }\n  return new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT);\n}\n\nexport function setWasmPauseCellPaused(\n  cell: SharedArrayBuffer,\n  paused: boolean\n): void {\n  const flags = new Int32Array(cell);\n  Atomics.store(flags, 0, paused ? pausedFlagValue : 0);\n  if (!paused) {\n    Atomics.notify(flags, 0);\n  }\n}\n\nexport function isWasmPauseCellPaused(\n  cell: SharedArrayBuffer\n): boolean {\n  return Atomics.load(new Int32Array(cell), 0) === pausedFlagValue;\n}\n\n/**\n * Worker-side pause gate: blocks the calling (worker) thread while the shared\n * pause cell is set, then credits the parked wall time to the pausable clock.\n * Must never run on a browser main thread — `Atomics.wait` is worker-only.\n */\nexport class WorkerWasmPauseGate {\n  private readonly flags: Int32Array;\n  private readonly clock: PausableMonotonicClock;\n  private readonly rawNowMilliseconds: () => number;\n\n  constructor(\n    cell: SharedArrayBuffer,\n    clock: PausableMonotonicClock,\n    rawNowMilliseconds: () => number = () => performance.now()\n  ) {\n    this.flags = new Int32Array(cell);\n    this.clock = clock;\n    this.rawNowMilliseconds = rawNowMilliseconds;\n  }\n\n  blockWhilePaused(): void {\n    let pausedMilliseconds = 0;\n    while (Atomics.load(this.flags, 0) === pausedFlagValue) {\n      const parkStart = this.rawNowMilliseconds();\n      Atomics.wait(this.flags, 0, pausedFlagValue);\n      pausedMilliseconds += this.rawNowMilliseconds() - parkStart;\n    }\n    this.clock.addPausedMilliseconds(pausedMilliseconds);\n  }\n}\n\n/**\n * Main-thread (JSPI) pause gate: the awaited counterpart of\n * `WorkerWasmPauseGate`. While paused, `waitWhilePaused` suspends on a promise\n * that `setPaused(false)` resolves, then credits the parked time to the clock.\n */\nexport class MainThreadWasmPauseGate {\n  private readonly clock: PausableMonotonicClock;\n  private readonly rawNowMilliseconds: () => number;\n  private paused = false;\n  private resumeWaiters: Array<() => void> = [];\n\n  constructor(\n    clock: PausableMonotonicClock,\n    rawNowMilliseconds: () => number = () => performance.now()\n  ) {\n    this.clock = clock;\n    this.rawNowMilliseconds = rawNowMilliseconds;\n  }\n\n  get isPaused(): boolean {\n    return this.paused;\n  }\n\n  setPaused(\n    paused: boolean\n  ): void {\n    if (this.paused === paused) {\n      return;\n    }\n    this.paused = paused;\n    if (!paused) {\n      const waiters = this.resumeWaiters;\n      this.resumeWaiters = [];\n      for (const resume of waiters) {\n        resume();\n      }\n    }\n  }\n\n  async waitWhilePaused(): Promise<void> {\n    let pausedMilliseconds = 0;\n    while (this.paused) {\n      const parkStart = this.rawNowMilliseconds();\n      await new Promise<void>((resolve) => {\n        this.resumeWaiters.push(resolve);\n      });\n      pausedMilliseconds += this.rawNowMilliseconds() - parkStart;\n    }\n    this.clock.addPausedMilliseconds(pausedMilliseconds);\n  }\n}\n\ntype ClockTimeGet = (clockid: number, precision: bigint, timePtr: number) => number;\n\n/**\n * Redirects the WASI `clock_time_get` import's MONOTONIC reads through the\n * pausable clock so app-side time agrees with the pause-aware `poll_oneoff`\n * deadline math. Non-monotonic clocks (REALTIME) keep the shim's behavior —\n * wall-clock time genuinely advances across a pause.\n */\nexport function installPausableClockTimeGet(\n  wasiImport: Record<string, unknown>,\n  memory: () => WebAssembly.Memory | undefined,\n  clock: PausableMonotonicClock\n): void {\n  const original = wasiImport.clock_time_get as ClockTimeGet | undefined;\n  if (typeof original !== \"function\") {\n    return;\n  }\n  wasiImport.clock_time_get = (\n    clockid: number,\n    precision: bigint,\n    timePtr: number\n  ): number => {\n    if (clockid !== wasi.CLOCKID_MONOTONIC) {\n      return original(clockid, precision, timePtr);\n    }\n    const currentMemory = memory();\n    if (!currentMemory) {\n      return original(clockid, precision, timePtr);\n    }\n    new DataView(currentMemory.buffer).setBigUint64(timePtr, clock.nowNanoseconds(), true);\n    return wasi.ERRNO_SUCCESS;\n  };\n}\n"],"mappings":";;AAEA,MAAM,kBAAkB;;;;;;;;;AAUxB,IAAa,yBAAb,MAAoC;CAClC;CACA,+BAAuC;CAEvC,YAAY,2BAAyC,YAAY,IAAI,GAAG;EACtE,KAAK,qBAAqB;CAC5B;CAEA,kBAA0B;EACxB,OAAO,KAAK,mBAAmB,IAAI,KAAK;CAC1C;CAEA,iBAAyB;EACvB,OAAO,OAAO,KAAK,MAAM,KAAK,gBAAgB,IAAI,GAAG,CAAC;CACxD;CAEA,sBACE,cACM;EACN,IAAI,eAAe,GACjB,KAAK,gCAAgC;CAEzC;CAEA,IAAI,qBAA6B;EAC/B,OAAO,KAAK;CACd;AACF;;;;;;AAOA,SAAgB,sBAAyC;CACvD,IAAI,OAAO,sBAAsB,aAC/B,MAAM,IAAI,MACR,uGACF;CAEF,OAAO,IAAI,kBAAkB,WAAW,iBAAiB;AAC3D;AAEA,SAAgB,uBACd,MACA,QACM;CACN,MAAM,QAAQ,IAAI,WAAW,IAAI;CACjC,QAAQ,MAAM,OAAO,GAAG,SAAS,kBAAkB,CAAC;CACpD,IAAI,CAAC,QACH,QAAQ,OAAO,OAAO,CAAC;AAE3B;AAEA,SAAgB,sBACd,MACS;CACT,OAAO,QAAQ,KAAK,IAAI,WAAW,IAAI,GAAG,CAAC,MAAM;AACnD;;;;;;AAOA,IAAa,sBAAb,MAAiC;CAC/B;CACA;CACA;CAEA,YACE,MACA,OACA,2BAAyC,YAAY,IAAI,GACzD;EACA,KAAK,QAAQ,IAAI,WAAW,IAAI;EAChC,KAAK,QAAQ;EACb,KAAK,qBAAqB;CAC5B;CAEA,mBAAyB;EACvB,IAAI,qBAAqB;EACzB,OAAO,QAAQ,KAAK,KAAK,OAAO,CAAC,MAAM,iBAAiB;GACtD,MAAM,YAAY,KAAK,mBAAmB;GAC1C,QAAQ,KAAK,KAAK,OAAO,GAAG,eAAe;GAC3C,sBAAsB,KAAK,mBAAmB,IAAI;EACpD;EACA,KAAK,MAAM,sBAAsB,kBAAkB;CACrD;AACF;;;;;;AAOA,IAAa,0BAAb,MAAqC;CACnC;CACA;CACA,SAAiB;CACjB,gBAA2C,CAAC;CAE5C,YACE,OACA,2BAAyC,YAAY,IAAI,GACzD;EACA,KAAK,QAAQ;EACb,KAAK,qBAAqB;CAC5B;CAEA,IAAI,WAAoB;EACtB,OAAO,KAAK;CACd;CAEA,UACE,QACM;EACN,IAAI,KAAK,WAAW,QAClB;EAEF,KAAK,SAAS;EACd,IAAI,CAAC,QAAQ;GACX,MAAM,UAAU,KAAK;GACrB,KAAK,gBAAgB,CAAC;GACtB,KAAK,MAAM,UAAU,SACnB,OAAO;EAEX;CACF;CAEA,MAAM,kBAAiC;EACrC,IAAI,qBAAqB;EACzB,OAAO,KAAK,QAAQ;GAClB,MAAM,YAAY,KAAK,mBAAmB;GAC1C,MAAM,IAAI,SAAe,YAAY;IACnC,KAAK,cAAc,KAAK,OAAO;GACjC,CAAC;GACD,sBAAsB,KAAK,mBAAmB,IAAI;EACpD;EACA,KAAK,MAAM,sBAAsB,kBAAkB;CACrD;AACF;;;;;;;AAUA,SAAgB,4BACd,YACA,QACA,OACM;CACN,MAAM,WAAW,WAAW;CAC5B,IAAI,OAAO,aAAa,YACtB;CAEF,WAAW,kBACT,SACA,WACA,YACW;EACX,IAAI,YAAY,KAAK,mBACnB,OAAO,SAAS,SAAS,WAAW,OAAO;EAE7C,MAAM,gBAAgB,OAAO;EAC7B,IAAI,CAAC,eACH,OAAO,SAAS,SAAS,WAAW,OAAO;EAE7C,IAAI,SAAS,cAAc,MAAM,CAAC,CAAC,aAAa,SAAS,MAAM,eAAe,GAAG,IAAI;EACrF,OAAO,KAAK;CACd;AACF"}

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":";;;;;AAqBA,MAAM,kBAAkB,IAAI,IAAI,0BAA0B,OAAO,KAAK,GAAG;AA0DzE,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;CAEA;CACA;CACA;CACA;CACA,WAAmB;CAEnB,YACE,SACA,SACA,gBACA;EACA,IAAI;EACJ,IAAI;EACJ,IAAI;EAEJ,IAAI;GACF,aAAa,uBAAuB;GACpC,cAAc,IAAI,uBAAuB,UAAU;EACrD,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;CAC1B;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;EACnB;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,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"}
+{"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":"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"}

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":";;;;;AA+CA,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,OACA,WACM;CACN,MAAM,eAAe,WAAW,WAAW;CAC3C,IAAI,OAAO,iBAAiB,YAC1B;CAGF,MAAM,eACJ,WAAW,MAAM,QAAQ;CAE3B,MAAM,aAAa,YAAY,IAAI,uBAAuB,IAAI,KAAA;CAC9D,MAAM,YACJ,aAAa,aAAa,IAAI,oBAAoB,WAAW,UAAU,IAAI,KAAA;CAC7E,IAAI,YACF,4BAA4B,WAAW,YAAY,QAAQ,UAAU;CAGvE,MAAM,YAAY,IAAI,kBAAkB;EACtC;EACA;EACA,eAAe,OAAO,QAAQ,gBAAgB,eAC5C,aAAa,OAAO,QAAQ,gBAAgB,UAAU;EACxD,iBAAiB,mBAAmB,WAAW,gBAAgB,IAAI,KAAA;EACnE;CACF,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,OAAO,QAAQ,SAAS;EAE7D,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"}

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.13",
   "license": "MIT",
   "repository": {
     "type": "git",