@swifttui/web 0.0.14 → 0.0.16

package/dist/src/wasi/WasmSceneRuntime.js

@@ -0,0 +1,119 @@
+import { WebHostSceneRuntime } from "../WebHostSceneRuntime.js";
+import { SharedInputQueueWriter, createSharedInputQueue } from "./SharedInputQueue.js";
+//#region src/wasi/WasmSceneRuntime.ts
+const workerModuleURL = new URL("./wasm-scene-worker.js", import.meta.url);
+function createWasmSceneRuntimeFactory(wasmURL, factoryOptions = {}) {
+	return (options) => {
+		const runtime = new WasmSceneRuntime(options, wasmURL, factoryOptions);
+		factoryOptions.onRuntimeCreated?.(runtime);
+		return runtime;
+	};
+}
+var WasmSceneRuntime = class extends WebHostSceneRuntime {
+	bridge;
+	wasmURL;
+	onSceneResize;
+	workerModuleURL;
+	inputQueue;
+	inputWriter;
+	detachBridgeInputListener;
+	detachResizeListener;
+	worker;
+	didMount = false;
+	constructor(options, wasmURL, factoryOptions) {
+		let inputQueue;
+		let inputWriter;
+		try {
+			inputQueue = createSharedInputQueue();
+			inputWriter = new SharedInputQueueWriter(inputQueue);
+		} catch (error) {
+			console.error("[SwiftTUIWeb] failed to create shared stdin queue", error);
+		}
+		super({
+			...options,
+			onInput: (chunk) => {
+				try {
+					inputWriter?.write(chunk);
+				} catch (error) {
+					console.error("[SwiftTUIWeb] failed to enqueue terminal input", error);
+				}
+			}
+		});
+		this.bridge = options.bridge;
+		this.wasmURL = wasmURL;
+		this.onSceneResize = factoryOptions.onSceneResize;
+		this.workerModuleURL = factoryOptions.workerModuleURL ?? workerModuleURL;
+		this.inputQueue = inputQueue;
+		this.inputWriter = inputWriter;
+	}
+	async mount() {
+		await super.mount();
+		if (this.didMount) return;
+		this.didMount = true;
+		this.detachBridgeInputListener = this.bridge?.stdin.subscribe((chunk) => {
+			this.inputWriter?.write(chunk);
+		});
+		this.detachResizeListener = this.bridge?.subscribeResize((columns, rows, cellWidth, cellHeight) => {
+			this.onSceneResize?.({
+				sceneId: this.descriptor.id,
+				columns,
+				rows,
+				cellWidth,
+				cellHeight
+			});
+		});
+		const initialColumns = Number(this.bridge?.environment.TUIGUI_COLUMNS ?? "0") || 0;
+		const initialRows = Number(this.bridge?.environment.TUIGUI_ROWS ?? "0") || 0;
+		if (!this.bridge && initialColumns > 0 && initialRows > 0) this.onSceneResize?.({
+			sceneId: this.descriptor.id,
+			columns: initialColumns,
+			rows: initialRows
+		});
+		if (!this.inputQueue || !this.inputWriter || !this.bridge) {
+			this.writeOutput("\r\nSwiftTUI WASI browser runtime requires SharedArrayBuffer-backed stdin. Serve the app with COOP/COEP headers.\r\n");
+			return;
+		}
+		this.worker = new Worker(this.workerModuleURL, { type: "module" });
+		this.worker.addEventListener("message", (event) => {
+			this.handleWorkerMessage(event.data);
+		});
+		this.worker.addEventListener("error", (event) => {
+			this.bridge?.stderr.write(`\nSwiftTUI WASI worker failed: ${event.message || "unknown worker error"}\n`);
+		});
+		const environment = { ...this.bridge.environment };
+		const message = {
+			type: "start",
+			wasmURL: this.wasmURL.href,
+			environment,
+			inputQueue: this.inputQueue
+		};
+		this.worker.postMessage(message);
+	}
+	dispose() {
+		this.detachBridgeInputListener?.();
+		this.detachResizeListener?.();
+		this.inputWriter?.close();
+		this.worker?.terminate();
+		super.dispose();
+	}
+	handleWorkerMessage(message) {
+		switch (message.type) {
+			case "stdout":
+				this.bridge?.stdout.write(message.chunk);
+				break;
+			case "stderr":
+				this.bridge?.stderr.write(message.chunk);
+				break;
+			case "exit":
+				if (message.code !== 0) this.bridge?.stderr.write(`\nSwiftTUI WASI app exited with code ${message.code}.\n`);
+				break;
+			case "error":
+				this.bridge?.stderr.write(`\nFailed to start SwiftTUI WASI app: ${message.message}\n`);
+				break;
+		}
+	}
+};
+//#endregion
+export { createWasmSceneRuntimeFactory };
+
+//# sourceMappingURL=WasmSceneRuntime.js.map

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

@@ -0,0 +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 {\n  SharedInputQueueWriter,\n  createSharedInputQueue,\n  type SharedInputQueueBuffers,\n} from \"./SharedInputQueue.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 interface WasmSceneRuntimeFactoryOptions {\n  onSceneResize?(event: WasmSceneResizeEvent): void;\n  onRuntimeCreated?(runtime: WasmSceneRuntimeHandle): void;\n  workerModuleURL?: string | URL;\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 inputQueue?: SharedInputQueueBuffers;\n  private readonly inputWriter?: SharedInputQueueWriter;\n\n  private detachBridgeInputListener?: () => void;\n  private detachResizeListener?: () => void;\n  private worker?: Worker;\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\n    try {\n      inputQueue = createSharedInputQueue();\n      inputWriter = new SharedInputQueueWriter(inputQueue);\n    } catch (error) {\n      console.error(\"[SwiftTUIWeb] failed to create shared stdin queue\", error);\n    }\n\n    super({\n      ...options,\n      onInput: (chunk) => {\n        try {\n          inputWriter?.write(chunk);\n        } catch (error) {\n          console.error(\"[SwiftTUIWeb] failed to enqueue terminal input\", error);\n        }\n      },\n    });\n\n    this.bridge = options.bridge;\n    this.wasmURL = wasmURL;\n    this.onSceneResize = factoryOptions.onSceneResize;\n    this.workerModuleURL = factoryOptions.workerModuleURL ?? workerModuleURL;\n    this.inputQueue = inputQueue;\n    this.inputWriter = inputWriter;\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.inputWriter?.write(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.inputQueue || !this.inputWriter || !this.bridge) {\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    super.dispose();\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

@@ -0,0 +1,27 @@
+import { SharedInputQueueBuffers } from "./SharedInputQueue.js";
+
+//#region src/wasi/WasmSceneWorker.d.ts
+interface StartWasmSceneWorkerMessage {
+  type: "start";
+  wasmURL: string;
+  environment: Record<string, string>;
+  inputQueue: SharedInputQueueBuffers;
+}
+interface OutputWasmSceneWorkerMessage {
+  type: "stdout" | "stderr";
+  chunk: Uint8Array;
+}
+interface ExitWasmSceneWorkerMessage {
+  type: "exit";
+  code: number;
+}
+interface ErrorWasmSceneWorkerMessage {
+  type: "error";
+  message: string;
+}
+type WasmSceneWorkerMessage = StartWasmSceneWorkerMessage;
+type WasmSceneWorkerResponse = OutputWasmSceneWorkerMessage | ExitWasmSceneWorkerMessage | ErrorWasmSceneWorkerMessage;
+declare function startWasmSceneWorker(): void;
+//#endregion
+export { ErrorWasmSceneWorkerMessage, ExitWasmSceneWorkerMessage, OutputWasmSceneWorkerMessage, StartWasmSceneWorkerMessage, WasmSceneWorkerMessage, WasmSceneWorkerResponse, startWasmSceneWorker };
+//# sourceMappingURL=WasmSceneWorker.d.ts.map

package/dist/src/wasi/WasmSceneWorker.js

@@ -0,0 +1,109 @@
+import { SharedInputQueueReader } from "./SharedInputQueue.js";
+import { WasiPollScheduler } from "./WasiPollScheduler.js";
+import { ConsoleStdout, Fd, WASI, wasi } from "@bjorn3/browser_wasi_shim";
+//#region src/wasi/WasmSceneWorker.ts
+function startWasmSceneWorker() {
+	globalThis.addEventListener("message", (event) => {
+		if (event.data.type !== "start") return;
+		startWasmScene(event.data);
+	});
+}
+var BlockingInputFileDescriptor = class extends Fd {
+	reader;
+	fdstat = (() => {
+		const fdstat = new wasi.Fdstat(wasi.FILETYPE_CHARACTER_DEVICE, 0);
+		fdstat.fs_rights_base = BigInt(wasi.RIGHTS_FD_READ);
+		return fdstat;
+	})();
+	constructor(inputQueue) {
+		super();
+		this.reader = new SharedInputQueueReader(inputQueue);
+	}
+	fd_fdstat_get() {
+		return {
+			ret: wasi.ERRNO_SUCCESS,
+			fdstat: this.fdstat
+		};
+	}
+	fd_filestat_get() {
+		return {
+			ret: wasi.ERRNO_SUCCESS,
+			filestat: new wasi.Filestat(0n, wasi.FILETYPE_CHARACTER_DEVICE, 0n)
+		};
+	}
+	fd_read(size) {
+		const chunk = this.reader.readAvailable(size);
+		if (chunk) return {
+			ret: wasi.ERRNO_SUCCESS,
+			data: chunk
+		};
+		if (this.reader.isClosed()) return {
+			ret: wasi.ERRNO_SUCCESS,
+			data: new Uint8Array()
+		};
+		return {
+			ret: wasi.ERRNO_AGAIN,
+			data: new Uint8Array()
+		};
+	}
+	availableBytes() {
+		return this.reader.availableBytes();
+	}
+	waitForReadable(timeoutMilliseconds) {
+		return this.reader.waitForReadable(timeoutMilliseconds);
+	}
+	isClosed() {
+		return this.reader.isClosed();
+	}
+};
+function installWasiPollScheduler(wasiBridge, stdin) {
+	const originalPoll = wasiBridge.wasiImport.poll_oneoff;
+	if (typeof originalPoll !== "function") return;
+	const scheduler = new WasiPollScheduler({
+		memory: () => wasiBridge.inst?.exports.memory,
+		stdin,
+		fallbackPoll: (inPtr, outPtr, nsubscriptions, neventsPtr) => originalPoll(inPtr, outPtr, nsubscriptions, neventsPtr)
+	});
+	wasiBridge.wasiImport.poll_oneoff = (inPtr, outPtr, nsubscriptions, neventsPtr) => scheduler.pollOneOff(inPtr, outPtr, nsubscriptions, neventsPtr);
+}
+async function startWasmScene(message) {
+	try {
+		const stdin = new BlockingInputFileDescriptor(message.inputQueue);
+		const wasiBridge = new WASI(["app.wasm"], Object.entries(message.environment).map(([key, value]) => `${key}=${value}`), [
+			stdin,
+			new ConsoleStdout((chunk) => {
+				postWorkerMessage({
+					type: "stdout",
+					chunk
+				});
+			}),
+			new ConsoleStdout((chunk) => {
+				postWorkerMessage({
+					type: "stderr",
+					chunk
+				});
+			})
+		]);
+		installWasiPollScheduler(wasiBridge, stdin);
+		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());
+		const instance = await WebAssembly.instantiate(module, { wasi_snapshot_preview1: wasiBridge.wasiImport });
+		postWorkerMessage({
+			type: "exit",
+			code: wasiBridge.start(instance)
+		});
+	} catch (error) {
+		postWorkerMessage({
+			type: "error",
+			message: error instanceof Error ? error.message : String(error)
+		});
+	}
+}
+function postWorkerMessage(message) {
+	globalThis.postMessage(message);
+}
+//#endregion
+export { startWasmSceneWorker };
+
+//# sourceMappingURL=WasmSceneWorker.js.map

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

@@ -0,0 +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,MAAM,IAAI,WAAW;EACvB;EAGF,OAAO;GACL,KAAK,KAAK;GACV,MAAM,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"}

package/dist/testing.d.ts

@@ -0,0 +1,2 @@
+import { transportFixture } from "./src/WebHostTestFixtures.js";
+export { transportFixture };

package/dist/testing.js

@@ -0,0 +1,2 @@
+import { transportFixture } from "./src/WebHostTestFixtures.js";
+export { transportFixture };

package/dist/wasi-worker.d.ts

@@ -0,0 +1,2 @@
+import { ErrorWasmSceneWorkerMessage, ExitWasmSceneWorkerMessage, OutputWasmSceneWorkerMessage, StartWasmSceneWorkerMessage, WasmSceneWorkerMessage, WasmSceneWorkerResponse, startWasmSceneWorker } from "./src/wasi/WasmSceneWorker.js";
+export { ErrorWasmSceneWorkerMessage, ExitWasmSceneWorkerMessage, OutputWasmSceneWorkerMessage, StartWasmSceneWorkerMessage, WasmSceneWorkerMessage, WasmSceneWorkerResponse, startWasmSceneWorker };

package/dist/wasi-worker.js

@@ -0,0 +1,2 @@
+import { startWasmSceneWorker } from "./src/wasi/WasmSceneWorker.js";
+export { startWasmSceneWorker };

package/dist/wasi.d.ts

@@ -0,0 +1,6 @@
+import { encodeRenderStyleControlMessage, encodeResizeControlMessage } from "./src/WebHostSurfaceTransport.js";
+import { StdIOPipe } from "./src/wasi/StdIOPipe.js";
+import { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink } from "./src/wasi/BrowserWASIBridge.js";
+import { SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, createSharedInputQueue, hydrateSharedInputQueue, sharedInputQueueDefaultCapacity } from "./src/wasi/SharedInputQueue.js";
+import { WasmSceneResizeEvent, WasmSceneRuntimeFactoryOptions, WasmSceneRuntimeHandle, createWasmSceneRuntimeFactory } from "./src/wasi/WasmSceneRuntime.js";
+export { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink, SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, StdIOPipe, WasmSceneResizeEvent, WasmSceneRuntimeFactoryOptions, WasmSceneRuntimeHandle, createSharedInputQueue, createWasmSceneRuntimeFactory, encodeRenderStyleControlMessage, encodeResizeControlMessage, hydrateSharedInputQueue, sharedInputQueueDefaultCapacity };

package/dist/wasi.js

@@ -0,0 +1,6 @@
+import { StdIOPipe } from "./src/wasi/StdIOPipe.js";
+import { encodeRenderStyleControlMessage, encodeResizeControlMessage } from "./src/WebHostSurfaceTransport.js";
+import { BrowserWASIBridge } from "./src/wasi/BrowserWASIBridge.js";
+import { SharedInputQueueReader, SharedInputQueueWriter, createSharedInputQueue, hydrateSharedInputQueue, sharedInputQueueDefaultCapacity } from "./src/wasi/SharedInputQueue.js";
+import { createWasmSceneRuntimeFactory } from "./src/wasi/WasmSceneRuntime.js";
+export { BrowserWASIBridge, SharedInputQueueReader, SharedInputQueueWriter, StdIOPipe, createSharedInputQueue, createWasmSceneRuntimeFactory, encodeRenderStyleControlMessage, encodeResizeControlMessage, hydrateSharedInputQueue, sharedInputQueueDefaultCapacity };

package/dist/websocket.d.ts

@@ -0,0 +1,2 @@
+import { WebSocketSceneBridge, WebSocketSceneBridgeFactory, WebSocketSceneBridgeOptions, WebSocketSceneSocket, webSocketSceneURL } from "./src/WebSocketSceneBridge.js";
+export { WebSocketSceneBridge, WebSocketSceneBridgeFactory, WebSocketSceneBridgeOptions, WebSocketSceneSocket, webSocketSceneURL };

package/dist/websocket.js

@@ -0,0 +1,2 @@
+import { WebSocketSceneBridge, webSocketSceneURL } from "./src/WebSocketSceneBridge.js";
+export { WebSocketSceneBridge, webSocketSceneURL };

package/package.json

@@ -1,33 +1,64 @@
 {
   "name": "@swifttui/web",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "license": "MIT",
-  "module": "index.ts",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "style.css"
+  ],
   "exports": {
-    ".": "./index.ts",
-    "./manifest": "./manifest.ts",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest.d.ts",
+      "import": "./dist/manifest.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    },
+    "./wasi": {
+      "types": "./dist/wasi.d.ts",
+      "import": "./dist/wasi.js"
+    },
+    "./wasi-worker": {
+      "types": "./dist/wasi-worker.d.ts",
+      "import": "./dist/wasi-worker.js"
+    },
+    "./websocket": {
+      "types": "./dist/websocket.d.ts",
+      "import": "./dist/websocket.js"
+    },
     "./style.css": "./style.css",
-    "./testing": "./testing.ts",
-    "./wasi": "./wasi.ts",
-    "./wasi-worker": "./wasi-worker.ts",
-    "./websocket": "./websocket.ts"
+    "./package.json": "./package.json"
   },
-  "type": "module",
   "scripts": {
-    "build:manifest": "bun run --cwd ../build build:manifest -- --dist ../web/dist",
-    "build:wasm": "bun run --cwd ../build build:wasm -- --dist ../web/dist",
-    "build:web": "bun run cli.ts build:web",
-    "build": "bun run cli.ts build",
-    "dev": "bun run cli.ts dev",
-    "test": "bun test"
+    "build": "tsdown",
+    "build:manifest": "bun run --cwd ../build build:manifest -- --dist ../web/dist-demo",
+    "build:wasm": "bun run --cwd ../build build:wasm -- --dist ../web/dist-demo",
+    "build:web": "bun run cli.ts build:web --dist dist-demo",
+    "build:app": "bun run cli.ts build --dist dist-demo",
+    "dev": "bun run cli.ts dev --dist dist-demo",
+    "test": "bun test",
+    "prepublishOnly": "tsdown"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "dependencies": {
     "@bjorn3/browser_wasi_shim": "^0.4.2"
   },
   "devDependencies": {
     "@types/bun": "1.3.13"
-  },
-  "peerDependencies": {
-    "typescript": "^5"
   }
 }

package/AGENTS.md

@@ -1,52 +0,0 @@
-# AGENTS.md
-
-Guidance for agentic assistants working in **`@swifttui/web`**. Keep this
-concise; [`README.md`](README.md) is the full reference.
-
-## What this package is
-
-The **browser runtime** for SwiftTUI apps. It owns the browser-safe runtime
-APIs: scene-manifest loading, canvas rendering, ARIA mounting, WebSocket scene
-bridges, and WASI scene bridges. Build/packaging tooling lives in the sibling
-[`@swifttui/build`](../build) workspace package — keep that split.
-
-It lives in the repo's Bun workspace (`packages/web` in `swift-tui-web`). Run
-`bun install` from the repo root or any package dir; one root `bun.lock` is
-maintained.
-
-## Toolchains
-
-- **Bun** for dev, bundling, and the test runner.
-- **`swiftly`** Swift 6.3.1 for any Swift the build path triggers
-  (`swiftly run swift --version`). Do not use bare `swift`/`xcrun swift`.
-
-## Commands
-
-```bash
-bun test                      # this package's tests (or `bun run test`)
-bun run build:web             # bundle index.html + browser entrypoint
-bun run build -- --app <Exe>  # full build (manifest + wasm + web)
-bun run dev                   # watch/dev
-```
-
-`build:manifest` and `build:wasm` delegate to `@swifttui/build` and default to
-`--configuration release`. The org-level gate for this repo is `bun run ci`
-(install --frozen-lockfile + test + build:web), run from the `swift-tui-web` root.
-
-## Architecture notes
-
-- Transport is SwiftTUI's **`web-surface` WASI transport**: the Swift runner
-  emits raster-surface records on stdout and the host draws rects/text to a
-  canvas. **No terminal emulator** — does not use `ghostty-web`/`ghostty-vt.wasm`.
-  `BrowserWASIBridge` sets `TUIGUI_TRANSPORT=surface`.
-- Entry points: `createWebHostApp` (`.`), `createWasmSceneRuntimeFactory`
-  (`./wasi`), `startWasmSceneWorker` (`./wasi-worker`). Subpath exports are
-  declared in `package.json` — keep `exports` in sync when adding modules.
-- Scene switching is controller-managed and retains existing scene runtimes.
-- Terminal styling is host-owned via `WebHostTerminalStyle` (one active
-  palette/theme pair); the library ships no built-in mode switcher.
-
-## Conventions
-
-`AGENTS.md` is the real file; `CLAUDE.md` is a symlink to it. Edit `AGENTS.md`.
-Tests are colocated as `*.test.ts` (browser-only specs use `*.browser.ts`).

package/cli.ts

@@ -1,168 +0,0 @@
-#!/usr/bin/env bun
-
-import { mkdir } from "node:fs/promises";
-import { join, resolve } from "node:path";
-import {
-  buildAppWasm,
-  buildSwiftTUIWebApp,
-  generateSceneManifest,
-  type WasmBuildConfiguration,
-} from "../build/index.ts";
-
-void runCli(process.argv.slice(2));
-
-async function runCli(argv: string[]): Promise<void> {
-  const command = argv[0] ?? "build";
-  const flags = parseFlags(argv.slice(1));
-  const packagePath = resolve(flags["package-path"] ?? "../../");
-  const distPath = resolve(flags["dist"] ?? "./dist");
-  const appExecutable = flags.app ?? flags.product ?? flags["app-product"] ?? "";
-  const wasmConfiguration = parseWasmBuildConfiguration(flags.configuration ?? "release");
-
-  switch (command) {
-    case "build:manifest":
-      assertAppExecutable(appExecutable);
-      await generateSceneManifest({
-        packagePath,
-        outputPath: join(distPath, "scene-manifest.json"),
-        appExecutable,
-      });
-      return;
-    case "build:wasm":
-      assertAppExecutable(appExecutable);
-      await buildAppWasm({
-        configuration: wasmConfiguration,
-        packagePath,
-        outputDirectory: distPath,
-        product: appExecutable,
-      });
-      return;
-    case "build:web":
-      await bunBuildWeb({
-        outputDirectory: distPath,
-      });
-      return;
-    case "build":
-      assertAppExecutable(appExecutable);
-      await buildSwiftTUIWebApp({
-        configuration: wasmConfiguration,
-        packagePath,
-        outputDirectory: distPath,
-        product: appExecutable,
-      });
-      await bunBuildWeb({
-        outputDirectory: distPath,
-      });
-      return;
-    case "dev":
-      await bunServe(packagePath, distPath);
-      return;
-    default:
-      throw new Error(`unknown command: ${command}`);
-  }
-}
-
-async function bunBuildWeb(options: {
-  outputDirectory: string;
-}): Promise<void> {
-  await mkdir(options.outputDirectory, { recursive: true });
-  const proc = Bun.spawn({
-    cmd: [
-      "bun",
-      "build",
-      "./index.html",
-      "--outdir",
-      options.outputDirectory,
-    ],
-    stdout: "pipe",
-    stderr: "pipe",
-  });
-  const [stdout, stderr, exitCode] = await Promise.all([
-    new Response(proc.stdout).text(),
-    new Response(proc.stderr).text(),
-    proc.exited,
-  ]);
-
-  if (exitCode !== 0) {
-    throw new Error([stdout, stderr].filter(Boolean).join("\n").trim() || "web build failed");
-  }
-}
-
-async function bunServe(
-  packagePath: string,
-  distPath: string
-): Promise<void> {
-  const server = Bun.serve({
-    port: Number(process.env.PORT ?? "3000"),
-    development: {
-      hmr: true,
-      console: true,
-    },
-    fetch(request) {
-      const url = new URL(request.url);
-      if (url.pathname === "/") {
-        return new Response(Bun.file(join(distPath, "index.html")));
-      }
-      if (url.pathname === "/scene-manifest.json") {
-        return new Response(Bun.file(join(distPath, "scene-manifest.json")));
-      }
-      if (url.pathname.startsWith("/assets/")) {
-        return new Response(Bun.file(join(distPath, url.pathname.slice(1))));
-      }
-      if (url.pathname.startsWith("/src/")) {
-        return new Response(Bun.file(join(packagePath, url.pathname.slice(1))));
-      }
-      return new Response("not found", { status: 404 });
-    },
-  });
-
-  console.log(`WebHost dev server running at ${server.url.href}`);
-  await new Promise<void>(() => {});
-}
-
-function parseFlags(
-  argv: string[]
-): Record<string, string> {
-  const flags: Record<string, string> = {};
-  for (let index = 0; index < argv.length; index += 1) {
-    const value = argv[index];
-    if (!value.startsWith("--")) {
-      continue;
-    }
-    const equalsIndex = value.indexOf("=");
-    if (equalsIndex !== -1) {
-      flags[value.slice(2, equalsIndex)] = value.slice(equalsIndex + 1);
-      continue;
-    }
-    const name = value.slice(2);
-    const next = argv[index + 1];
-    if (next && !next.startsWith("--")) {
-      flags[name] = next;
-      index += 1;
-    } else {
-      flags[name] = "true";
-    }
-  }
-  return flags;
-}
-
-function parseWasmBuildConfiguration(
-  value: string
-): WasmBuildConfiguration {
-  switch (value) {
-    case "debug":
-      return "debug";
-    case "release":
-      return "release";
-    default:
-      throw new Error(`unsupported wasm build configuration: ${value}`);
-  }
-}
-
-function assertAppExecutable(
-  value: string
-): asserts value is string {
-  if (!value) {
-    throw new Error("missing --app or --product flag");
-  }
-}