@swifttui/web 0.1.8 → 0.1.9

package/dist/index.d.ts

@@ -5,5 +5,6 @@ import { WebHostSceneBridge, WebHostSceneRuntime, WebHostSceneRuntimeOptions, Wh
 import { WebSocketSceneBridge, WebSocketSceneBridgeFactory, WebSocketSceneBridgeOptions, WebSocketSceneSocket, webSocketSceneURL } from "./src/WebSocketSceneBridge.js";
 import { WebHostAppController, WebHostAppOptions, WebHostBridgeFactory, WebHostBridgeFactoryOptions, WebHostEmbeddedHostConfig, createWebHostApp } from "./src/WebHostApp.js";
 import { StdIOPipe } from "./src/wasi/StdIOPipe.js";
+import { WasmEngineCapabilities, WasmEngineFamily, WasmEngineProbeSignals, classifyWasmEngineFamily, collectWasmEngineProbeSignals, resolveWasmEngineCapabilities, stackProfileEnvironmentDefaults } from "./src/wasi/WasmEngineCapabilities.js";
 import { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink } from "./src/wasi/BrowserWASIBridge.js";
-export { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink, ResolvedWebHostTerminalPalette, ResolvedWebHostTerminalStyle, SUPPORTED_SURFACE_VERSION, StdIOPipe, 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, createWebHostApp, decodeWebHostTerminalRenderStyleBase64, encodeKeyInputMessage, encodeMouseInputMessage, encodePasteInputMessage, encodeRenderStyleControlMessage, encodeResizeControlMessage, encodeWebHostTerminalRenderStyleBase64, loadWebHostSceneManifest, mergeWebHostTerminalStyle, normalizeWebHostSceneManifest, normalizeWebHostTerminalStyle, resolveWebHostTerminalRenderStyle, webSocketSceneURL, webTUISceneManifestFromDescriptors, webTUISceneManifestToJSON, webTUITerminalBackgroundColor };
+export { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink, 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, loadWebHostSceneManifest, mergeWebHostTerminalStyle, normalizeWebHostSceneManifest, normalizeWebHostTerminalStyle, resolveWasmEngineCapabilities, resolveWebHostTerminalRenderStyle, stackProfileEnvironmentDefaults, webSocketSceneURL, webTUISceneManifestFromDescriptors, webTUISceneManifestToJSON, webTUITerminalBackgroundColor };

package/dist/index.js

@@ -1,4 +1,5 @@
 import { StdIOPipe } from "./src/wasi/StdIOPipe.js";
+import { classifyWasmEngineFamily, collectWasmEngineProbeSignals, resolveWasmEngineCapabilities, stackProfileEnvironmentDefaults } from "./src/wasi/WasmEngineCapabilities.js";
 import { applyWebHostTerminalStyle, decodeWebHostTerminalRenderStyleBase64, encodeWebHostTerminalRenderStyleBase64, mergeWebHostTerminalStyle, normalizeWebHostTerminalStyle, resolveWebHostTerminalRenderStyle, webTUITerminalBackgroundColor } from "./src/WebHostTerminalStyle.js";
 import { SUPPORTED_SURFACE_VERSION, WebHostOutputDecoder, encodeKeyInputMessage, encodeMouseInputMessage, encodePasteInputMessage, encodeRenderStyleControlMessage, encodeResizeControlMessage } from "./src/WebHostSurfaceTransport.js";
 import { BrowserWASIBridge } from "./src/wasi/BrowserWASIBridge.js";
@@ -6,4 +7,4 @@ import { WebSocketSceneBridge, webSocketSceneURL } from "./src/WebSocketSceneBri
 import { loadWebHostSceneManifest, normalizeWebHostSceneManifest, webTUISceneManifestFromDescriptors, webTUISceneManifestToJSON } from "./src/WebHostSceneManifest.js";
 import { WebHostSceneRuntime } from "./src/WebHostSceneRuntime.js";
 import { createWebHostApp } from "./src/WebHostApp.js";
-export { BrowserWASIBridge, SUPPORTED_SURFACE_VERSION, StdIOPipe, WebHostOutputDecoder, WebHostSceneRuntime, WebSocketSceneBridge, applyWebHostTerminalStyle, createWebHostApp, decodeWebHostTerminalRenderStyleBase64, encodeKeyInputMessage, encodeMouseInputMessage, encodePasteInputMessage, encodeRenderStyleControlMessage, encodeResizeControlMessage, encodeWebHostTerminalRenderStyleBase64, loadWebHostSceneManifest, mergeWebHostTerminalStyle, normalizeWebHostSceneManifest, normalizeWebHostTerminalStyle, resolveWebHostTerminalRenderStyle, webSocketSceneURL, webTUISceneManifestFromDescriptors, webTUISceneManifestToJSON, webTUITerminalBackgroundColor };
+export { BrowserWASIBridge, SUPPORTED_SURFACE_VERSION, StdIOPipe, WebHostOutputDecoder, WebHostSceneRuntime, WebSocketSceneBridge, applyWebHostTerminalStyle, classifyWasmEngineFamily, collectWasmEngineProbeSignals, createWebHostApp, decodeWebHostTerminalRenderStyleBase64, encodeKeyInputMessage, encodeMouseInputMessage, encodePasteInputMessage, encodeRenderStyleControlMessage, encodeResizeControlMessage, encodeWebHostTerminalRenderStyleBase64, loadWebHostSceneManifest, mergeWebHostTerminalStyle, normalizeWebHostSceneManifest, normalizeWebHostTerminalStyle, resolveWasmEngineCapabilities, resolveWebHostTerminalRenderStyle, stackProfileEnvironmentDefaults, webSocketSceneURL, webTUISceneManifestFromDescriptors, webTUISceneManifestToJSON, webTUITerminalBackgroundColor };

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

@@ -1,6 +1,7 @@
 import { WebHostTerminalStyle } from "../WebHostTerminalStyle.js";
 import { WebHostOutputSink, encodeRenderStyleControlMessage, encodeResizeControlMessage } from "../WebHostSurfaceTransport.js";
 import { StdIOPipe } from "./StdIOPipe.js";
+import { WasmEngineCapabilities } from "./WasmEngineCapabilities.js";
 //#region src/wasi/BrowserWASIBridge.d.ts
 interface BrowserWASIBridgeOptions {
   sceneId: string;
@@ -8,6 +9,13 @@ interface BrowserWASIBridgeOptions {
   rows: number;
   environment?: Record<string, string>;
   renderStyle?: WebHostTerminalStyle;
+  /**
+   * Detected engine capabilities driving engine-conditional environment
+   * defaults (e.g. disabling the stack-lean resolve profile on V8). Defaults
+   * to probing the current engine; injectable for tests and embedders that
+   * want to force a profile.
+   */
+  engineCapabilities?: WasmEngineCapabilities;
 }
 type BrowserWASIOutputSink = WebHostOutputSink;
 declare class BrowserWASIBridge {

package/dist/src/wasi/BrowserWASIBridge.js

@@ -1,4 +1,5 @@
 import { StdIOPipe } from "./StdIOPipe.js";
+import { resolveWasmEngineCapabilities, stackProfileEnvironmentDefaults } from "./WasmEngineCapabilities.js";
 import { encodeWebHostTerminalRenderStyleBase64 } from "../WebHostTerminalStyle.js";
 import { WebHostOutputDecoder, encodeRenderStyleControlMessage, encodeResizeControlMessage } from "../WebHostSurfaceTransport.js";
 //#region src/wasi/BrowserWASIBridge.ts
@@ -19,6 +20,7 @@ var BrowserWASIBridge = class {
 			TUIGUI_SCENE: options.sceneId,
 			TUIGUI_COLUMNS: String(Math.max(1, options.columns)),
 			TUIGUI_ROWS: String(Math.max(1, options.rows)),
+			...stackProfileEnvironmentDefaults(options.engineCapabilities ?? resolveWasmEngineCapabilities()),
 			...options.environment,
 			...options.renderStyle ? { TUIGUI_RENDER_STYLE: encodeWebHostTerminalRenderStyleBase64(options.renderStyle) } : {}
 		};

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

@@ -1 +1 @@
-{"version":3,"file":"BrowserWASIBridge.js","names":[],"sources":["../../../src/wasi/BrowserWASIBridge.ts"],"sourcesContent":["import { StdIOPipe } from \"./StdIOPipe.ts\";\nimport {\n  encodeWebHostTerminalRenderStyleBase64,\n  type WebHostTerminalStyle,\n} from \"../WebHostTerminalStyle.ts\";\nimport {\n  WebHostOutputDecoder,\n  encodeRenderStyleControlMessage,\n  encodeResizeControlMessage,\n  type WebHostOutputSink,\n} from \"../WebHostSurfaceTransport.ts\";\n\nexport interface BrowserWASIBridgeOptions {\n  sceneId: string;\n  columns: number;\n  rows: number;\n  environment?: Record<string, string>;\n  renderStyle?: WebHostTerminalStyle;\n}\n\nexport type BrowserWASIOutputSink = WebHostOutputSink;\n\nexport class BrowserWASIBridge {\n  readonly stdin = new StdIOPipe();\n  readonly stdout = new StdIOPipe();\n  readonly stderr = new StdIOPipe();\n  readonly environment: Record<string, string>;\n\n  private detachStdout?: () => void;\n  private detachStderr?: () => void;\n  private readonly resizeListeners = new Set<(\n    columns: number,\n    rows: number,\n    cellWidth?: number,\n    cellHeight?: number\n  ) => void>();\n  private latestResize: {\n    columns: number;\n    rows: number;\n    cellWidth?: number;\n    cellHeight?: number;\n  };\n\n  constructor(options: BrowserWASIBridgeOptions) {\n    this.environment = {\n      TUIGUI_MODE: \"browser\",\n      TUIGUI_TRANSPORT: \"surface\",\n      TUIGUI_SURFACE_DELTA: \"1\",\n      TUIGUI_SCENE: options.sceneId,\n      TUIGUI_COLUMNS: String(Math.max(1, options.columns)),\n      TUIGUI_ROWS: String(Math.max(1, options.rows)),\n      ...options.environment,\n      ...(options.renderStyle\n        ? {\n            TUIGUI_RENDER_STYLE: encodeWebHostTerminalRenderStyleBase64(\n              options.renderStyle\n            ),\n          }\n        : {}),\n    };\n    this.latestResize = {\n      columns: Math.max(1, options.columns),\n      rows: Math.max(1, options.rows),\n    };\n  }\n\n  bindOutput(\n    sink: BrowserWASIOutputSink\n  ): void {\n    this.detachStdout?.();\n    this.detachStderr?.();\n    const decoder = new WebHostOutputDecoder();\n    this.detachStdout = this.stdout.subscribe((chunk) => {\n      for (const record of decoder.feed(chunk)) {\n        switch (record.type) {\n        case \"surface\":\n          sink.presentSurface(record.frame);\n          break;\n        case \"clipboard\":\n          void sink.writeClipboard?.(record.text);\n          break;\n        case \"runtimeIssue\":\n          sink.notifyRuntimeIssue?.(record.issue);\n          break;\n        case \"frameDiagnostic\":\n          sink.recordFrameDiagnostic?.(record.diagnostic);\n          break;\n        case \"text\":\n          sink.writeOutput?.(record.text);\n          break;\n        }\n      }\n    });\n    this.detachStderr = this.stderr.subscribe((chunk) => {\n      sink.writeError?.(new TextDecoder().decode(chunk));\n    });\n  }\n\n  resize(\n    columns: number,\n    rows: number,\n    cellWidth?: number,\n    cellHeight?: number\n  ): void {\n    const normalizedColumns = Math.max(1, columns);\n    const normalizedRows = Math.max(1, rows);\n    this.environment.TUIGUI_COLUMNS = String(normalizedColumns);\n    this.environment.TUIGUI_ROWS = String(normalizedRows);\n    this.latestResize = {\n      columns: normalizedColumns,\n      rows: normalizedRows,\n      cellWidth,\n      cellHeight,\n    };\n    this.stdin.write(encodeResizeControlMessage(columns, rows, cellWidth, cellHeight));\n    for (const listener of this.resizeListeners) {\n      listener(normalizedColumns, normalizedRows, cellWidth, cellHeight);\n    }\n  }\n\n  updateRenderStyle(\n    style: WebHostTerminalStyle\n  ): void {\n    this.environment.TUIGUI_RENDER_STYLE = encodeWebHostTerminalRenderStyleBase64(style);\n    this.stdin.write(encodeRenderStyleControlMessage(style));\n  }\n\n  sendInput(\n    chunk: Uint8Array\n  ): void {\n    this.stdin.write(chunk);\n  }\n\n  subscribeResize(\n    listener: (\n      columns: number,\n      rows: number,\n      cellWidth?: number,\n      cellHeight?: number\n    ) => void\n  ): () => void {\n    this.resizeListeners.add(listener);\n    listener(\n      this.latestResize.columns,\n      this.latestResize.rows,\n      this.latestResize.cellWidth,\n      this.latestResize.cellHeight\n    );\n    return () => {\n      this.resizeListeners.delete(listener);\n    };\n  }\n\n  dispose(): void {\n    this.detachStdout?.();\n    this.detachStderr?.();\n    this.resizeListeners.clear();\n    this.stdin.close();\n    this.stdout.close();\n    this.stderr.close();\n  }\n}\n\nexport {\n  encodeRenderStyleControlMessage,\n  encodeResizeControlMessage,\n};\n"],"mappings":";;;;AAsBA,IAAa,oBAAb,MAA+B;CAC7B,QAAiB,IAAI,UAAU;CAC/B,SAAkB,IAAI,UAAU;CAChC,SAAkB,IAAI,UAAU;CAChC;CAEA;CACA;CACA,kCAAmC,IAAI,IAK5B;CACX;CAOA,YAAY,SAAmC;EAC7C,KAAK,cAAc;GACjB,aAAa;GACb,kBAAkB;GAClB,sBAAsB;GACtB,cAAc,QAAQ;GACtB,gBAAgB,OAAO,KAAK,IAAI,GAAG,QAAQ,OAAO,CAAC;GACnD,aAAa,OAAO,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;GAC7C,GAAG,QAAQ;GACX,GAAI,QAAQ,cACR,EACE,qBAAqB,uCACnB,QAAQ,WACV,EACF,IACA,CAAC;EACP;EACA,KAAK,eAAe;GAClB,SAAS,KAAK,IAAI,GAAG,QAAQ,OAAO;GACpC,MAAM,KAAK,IAAI,GAAG,QAAQ,IAAI;EAChC;CACF;CAEA,WACE,MACM;EACN,KAAK,eAAe;EACpB,KAAK,eAAe;EACpB,MAAM,UAAU,IAAI,qBAAqB;EACzC,KAAK,eAAe,KAAK,OAAO,WAAW,UAAU;GACnD,KAAK,MAAM,UAAU,QAAQ,KAAK,KAAK,GACrC,QAAQ,OAAO,MAAf;IACA,KAAK;KACH,KAAK,eAAe,OAAO,KAAK;KAChC;IACF,KAAK;KACH,KAAU,iBAAiB,OAAO,IAAI;KACtC;IACF,KAAK;KACH,KAAK,qBAAqB,OAAO,KAAK;KACtC;IACF,KAAK;KACH,KAAK,wBAAwB,OAAO,UAAU;KAC9C;IACF,KAAK;KACH,KAAK,cAAc,OAAO,IAAI;KAC9B;GACF;EAEJ,CAAC;EACD,KAAK,eAAe,KAAK,OAAO,WAAW,UAAU;GACnD,KAAK,aAAa,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK,CAAC;EACnD,CAAC;CACH;CAEA,OACE,SACA,MACA,WACA,YACM;EACN,MAAM,oBAAoB,KAAK,IAAI,GAAG,OAAO;EAC7C,MAAM,iBAAiB,KAAK,IAAI,GAAG,IAAI;EACvC,KAAK,YAAY,iBAAiB,OAAO,iBAAiB;EAC1D,KAAK,YAAY,cAAc,OAAO,cAAc;EACpD,KAAK,eAAe;GAClB,SAAS;GACT,MAAM;GACN;GACA;EACF;EACA,KAAK,MAAM,MAAM,2BAA2B,SAAS,MAAM,WAAW,UAAU,CAAC;EACjF,KAAK,MAAM,YAAY,KAAK,iBAC1B,SAAS,mBAAmB,gBAAgB,WAAW,UAAU;CAErE;CAEA,kBACE,OACM;EACN,KAAK,YAAY,sBAAsB,uCAAuC,KAAK;EACnF,KAAK,MAAM,MAAM,gCAAgC,KAAK,CAAC;CACzD;CAEA,UACE,OACM;EACN,KAAK,MAAM,MAAM,KAAK;CACxB;CAEA,gBACE,UAMY;EACZ,KAAK,gBAAgB,IAAI,QAAQ;EACjC,SACE,KAAK,aAAa,SAClB,KAAK,aAAa,MAClB,KAAK,aAAa,WAClB,KAAK,aAAa,UACpB;EACA,aAAa;GACX,KAAK,gBAAgB,OAAO,QAAQ;EACtC;CACF;CAEA,UAAgB;EACd,KAAK,eAAe;EACpB,KAAK,eAAe;EACpB,KAAK,gBAAgB,MAAM;EAC3B,KAAK,MAAM,MAAM;EACjB,KAAK,OAAO,MAAM;EAClB,KAAK,OAAO,MAAM;CACpB;AACF"}
+{"version":3,"file":"BrowserWASIBridge.js","names":[],"sources":["../../../src/wasi/BrowserWASIBridge.ts"],"sourcesContent":["import { StdIOPipe } from \"./StdIOPipe.ts\";\nimport {\n  resolveWasmEngineCapabilities,\n  stackProfileEnvironmentDefaults,\n  type WasmEngineCapabilities,\n} from \"./WasmEngineCapabilities.ts\";\nimport {\n  encodeWebHostTerminalRenderStyleBase64,\n  type WebHostTerminalStyle,\n} from \"../WebHostTerminalStyle.ts\";\nimport {\n  WebHostOutputDecoder,\n  encodeRenderStyleControlMessage,\n  encodeResizeControlMessage,\n  type WebHostOutputSink,\n} from \"../WebHostSurfaceTransport.ts\";\n\nexport interface BrowserWASIBridgeOptions {\n  sceneId: string;\n  columns: number;\n  rows: number;\n  environment?: Record<string, string>;\n  renderStyle?: WebHostTerminalStyle;\n  /**\n   * Detected engine capabilities driving engine-conditional environment\n   * defaults (e.g. disabling the stack-lean resolve profile on V8). Defaults\n   * to probing the current engine; injectable for tests and embedders that\n   * want to force a profile.\n   */\n  engineCapabilities?: WasmEngineCapabilities;\n}\n\nexport type BrowserWASIOutputSink = WebHostOutputSink;\n\nexport class BrowserWASIBridge {\n  readonly stdin = new StdIOPipe();\n  readonly stdout = new StdIOPipe();\n  readonly stderr = new StdIOPipe();\n  readonly environment: Record<string, string>;\n\n  private detachStdout?: () => void;\n  private detachStderr?: () => void;\n  private readonly resizeListeners = new Set<(\n    columns: number,\n    rows: number,\n    cellWidth?: number,\n    cellHeight?: number\n  ) => void>();\n  private latestResize: {\n    columns: number;\n    rows: number;\n    cellWidth?: number;\n    cellHeight?: number;\n  };\n\n  constructor(options: BrowserWASIBridgeOptions) {\n    this.environment = {\n      TUIGUI_MODE: \"browser\",\n      TUIGUI_TRANSPORT: \"surface\",\n      TUIGUI_SURFACE_DELTA: \"1\",\n      TUIGUI_SCENE: options.sceneId,\n      TUIGUI_COLUMNS: String(Math.max(1, options.columns)),\n      TUIGUI_ROWS: String(Math.max(1, options.rows)),\n      ...stackProfileEnvironmentDefaults(\n        options.engineCapabilities ?? resolveWasmEngineCapabilities()\n      ),\n      ...options.environment,\n      ...(options.renderStyle\n        ? {\n            TUIGUI_RENDER_STYLE: encodeWebHostTerminalRenderStyleBase64(\n              options.renderStyle\n            ),\n          }\n        : {}),\n    };\n    this.latestResize = {\n      columns: Math.max(1, options.columns),\n      rows: Math.max(1, options.rows),\n    };\n  }\n\n  bindOutput(\n    sink: BrowserWASIOutputSink\n  ): void {\n    this.detachStdout?.();\n    this.detachStderr?.();\n    const decoder = new WebHostOutputDecoder();\n    this.detachStdout = this.stdout.subscribe((chunk) => {\n      for (const record of decoder.feed(chunk)) {\n        switch (record.type) {\n        case \"surface\":\n          sink.presentSurface(record.frame);\n          break;\n        case \"clipboard\":\n          void sink.writeClipboard?.(record.text);\n          break;\n        case \"runtimeIssue\":\n          sink.notifyRuntimeIssue?.(record.issue);\n          break;\n        case \"frameDiagnostic\":\n          sink.recordFrameDiagnostic?.(record.diagnostic);\n          break;\n        case \"text\":\n          sink.writeOutput?.(record.text);\n          break;\n        }\n      }\n    });\n    this.detachStderr = this.stderr.subscribe((chunk) => {\n      sink.writeError?.(new TextDecoder().decode(chunk));\n    });\n  }\n\n  resize(\n    columns: number,\n    rows: number,\n    cellWidth?: number,\n    cellHeight?: number\n  ): void {\n    const normalizedColumns = Math.max(1, columns);\n    const normalizedRows = Math.max(1, rows);\n    this.environment.TUIGUI_COLUMNS = String(normalizedColumns);\n    this.environment.TUIGUI_ROWS = String(normalizedRows);\n    this.latestResize = {\n      columns: normalizedColumns,\n      rows: normalizedRows,\n      cellWidth,\n      cellHeight,\n    };\n    this.stdin.write(encodeResizeControlMessage(columns, rows, cellWidth, cellHeight));\n    for (const listener of this.resizeListeners) {\n      listener(normalizedColumns, normalizedRows, cellWidth, cellHeight);\n    }\n  }\n\n  updateRenderStyle(\n    style: WebHostTerminalStyle\n  ): void {\n    this.environment.TUIGUI_RENDER_STYLE = encodeWebHostTerminalRenderStyleBase64(style);\n    this.stdin.write(encodeRenderStyleControlMessage(style));\n  }\n\n  sendInput(\n    chunk: Uint8Array\n  ): void {\n    this.stdin.write(chunk);\n  }\n\n  subscribeResize(\n    listener: (\n      columns: number,\n      rows: number,\n      cellWidth?: number,\n      cellHeight?: number\n    ) => void\n  ): () => void {\n    this.resizeListeners.add(listener);\n    listener(\n      this.latestResize.columns,\n      this.latestResize.rows,\n      this.latestResize.cellWidth,\n      this.latestResize.cellHeight\n    );\n    return () => {\n      this.resizeListeners.delete(listener);\n    };\n  }\n\n  dispose(): void {\n    this.detachStdout?.();\n    this.detachStderr?.();\n    this.resizeListeners.clear();\n    this.stdin.close();\n    this.stdout.close();\n    this.stderr.close();\n  }\n}\n\nexport {\n  encodeRenderStyleControlMessage,\n  encodeResizeControlMessage,\n};\n"],"mappings":";;;;;AAkCA,IAAa,oBAAb,MAA+B;CAC7B,QAAiB,IAAI,UAAU;CAC/B,SAAkB,IAAI,UAAU;CAChC,SAAkB,IAAI,UAAU;CAChC;CAEA;CACA;CACA,kCAAmC,IAAI,IAK5B;CACX;CAOA,YAAY,SAAmC;EAC7C,KAAK,cAAc;GACjB,aAAa;GACb,kBAAkB;GAClB,sBAAsB;GACtB,cAAc,QAAQ;GACtB,gBAAgB,OAAO,KAAK,IAAI,GAAG,QAAQ,OAAO,CAAC;GACnD,aAAa,OAAO,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;GAC7C,GAAG,gCACD,QAAQ,sBAAsB,8BAA8B,CAC9D;GACA,GAAG,QAAQ;GACX,GAAI,QAAQ,cACR,EACE,qBAAqB,uCACnB,QAAQ,WACV,EACF,IACA,CAAC;EACP;EACA,KAAK,eAAe;GAClB,SAAS,KAAK,IAAI,GAAG,QAAQ,OAAO;GACpC,MAAM,KAAK,IAAI,GAAG,QAAQ,IAAI;EAChC;CACF;CAEA,WACE,MACM;EACN,KAAK,eAAe;EACpB,KAAK,eAAe;EACpB,MAAM,UAAU,IAAI,qBAAqB;EACzC,KAAK,eAAe,KAAK,OAAO,WAAW,UAAU;GACnD,KAAK,MAAM,UAAU,QAAQ,KAAK,KAAK,GACrC,QAAQ,OAAO,MAAf;IACA,KAAK;KACH,KAAK,eAAe,OAAO,KAAK;KAChC;IACF,KAAK;KACH,KAAU,iBAAiB,OAAO,IAAI;KACtC;IACF,KAAK;KACH,KAAK,qBAAqB,OAAO,KAAK;KACtC;IACF,KAAK;KACH,KAAK,wBAAwB,OAAO,UAAU;KAC9C;IACF,KAAK;KACH,KAAK,cAAc,OAAO,IAAI;KAC9B;GACF;EAEJ,CAAC;EACD,KAAK,eAAe,KAAK,OAAO,WAAW,UAAU;GACnD,KAAK,aAAa,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK,CAAC;EACnD,CAAC;CACH;CAEA,OACE,SACA,MACA,WACA,YACM;EACN,MAAM,oBAAoB,KAAK,IAAI,GAAG,OAAO;EAC7C,MAAM,iBAAiB,KAAK,IAAI,GAAG,IAAI;EACvC,KAAK,YAAY,iBAAiB,OAAO,iBAAiB;EAC1D,KAAK,YAAY,cAAc,OAAO,cAAc;EACpD,KAAK,eAAe;GAClB,SAAS;GACT,MAAM;GACN;GACA;EACF;EACA,KAAK,MAAM,MAAM,2BAA2B,SAAS,MAAM,WAAW,UAAU,CAAC;EACjF,KAAK,MAAM,YAAY,KAAK,iBAC1B,SAAS,mBAAmB,gBAAgB,WAAW,UAAU;CAErE;CAEA,kBACE,OACM;EACN,KAAK,YAAY,sBAAsB,uCAAuC,KAAK;EACnF,KAAK,MAAM,MAAM,gCAAgC,KAAK,CAAC;CACzD;CAEA,UACE,OACM;EACN,KAAK,MAAM,MAAM,KAAK;CACxB;CAEA,gBACE,UAMY;EACZ,KAAK,gBAAgB,IAAI,QAAQ;EACjC,SACE,KAAK,aAAa,SAClB,KAAK,aAAa,MAClB,KAAK,aAAa,WAClB,KAAK,aAAa,UACpB;EACA,aAAa;GACX,KAAK,gBAAgB,OAAO,QAAQ;EACtC;CACF;CAEA,UAAgB;EACd,KAAK,eAAe;EACpB,KAAK,eAAe;EACpB,KAAK,gBAAgB,MAAM;EAC3B,KAAK,MAAM,MAAM;EACjB,KAAK,OAAO,MAAM;EAClB,KAAK,OAAO,MAAM;CACpB;AACF"}

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

@@ -0,0 +1,35 @@
+//#region src/wasi/WasmEngineCapabilities.d.ts
+type WasmEngineFamily = "v8" | "jsc" | "gecko" | "unknown";
+interface WasmEngineProbeSignals {
+  errorStack: string;
+  errorHasGeckoFileName: boolean;
+  errorHasJSCSourceURL: boolean;
+  wasmSuspendingType: string;
+  wasmPromisingType: string;
+}
+interface WasmEngineCapabilities {
+  engine: WasmEngineFamily;
+  /**
+   * WebAssembly JavaScript Promise Integration (`WebAssembly.Suspending` +
+   * `WebAssembly.promising`). When true, a future main-thread execution path
+   * can suspend on stdin instead of blocking a worker on `Atomics.wait`.
+   */
+  supportsJSPI: boolean;
+  /**
+   * Whether the SwiftTUI WASI build should keep its stack-lean resolve
+   * profile on this engine.
+   */
+  stackLeanRecommended: boolean;
+}
+declare function collectWasmEngineProbeSignals(): WasmEngineProbeSignals;
+declare function classifyWasmEngineFamily(signals: WasmEngineProbeSignals): WasmEngineFamily;
+declare function resolveWasmEngineCapabilities(signals?: WasmEngineProbeSignals): WasmEngineCapabilities;
+/**
+ * WASI environment defaults implied by the engine capabilities. Spread these
+ * *before* caller-provided environment entries so an explicit
+ * `SWIFTTUI_STACK_LEAN_PROFILE` (or a tuning override) always wins.
+ */
+declare function stackProfileEnvironmentDefaults(capabilities: WasmEngineCapabilities): Record<string, string>;
+//#endregion
+export { WasmEngineCapabilities, WasmEngineFamily, WasmEngineProbeSignals, classifyWasmEngineFamily, collectWasmEngineProbeSignals, resolveWasmEngineCapabilities, stackProfileEnvironmentDefaults };
+//# sourceMappingURL=WasmEngineCapabilities.d.ts.map

package/dist/src/wasi/WasmEngineCapabilities.js

@@ -0,0 +1,39 @@
+//#region src/wasi/WasmEngineCapabilities.ts
+function collectWasmEngineProbeSignals() {
+	const probe = /* @__PURE__ */ new Error("wasm-engine-probe");
+	const wasm = globalThis.WebAssembly;
+	return {
+		errorStack: typeof probe.stack === "string" ? probe.stack : "",
+		errorHasGeckoFileName: "fileName" in probe,
+		errorHasJSCSourceURL: "sourceURL" in probe,
+		wasmSuspendingType: typeof wasm?.Suspending,
+		wasmPromisingType: typeof wasm?.promising
+	};
+}
+function classifyWasmEngineFamily(signals) {
+	if (/^\s*at /m.test(signals.errorStack)) return "v8";
+	if (signals.errorHasGeckoFileName) return "gecko";
+	if (signals.errorHasJSCSourceURL || /^[^\n]*@/m.test(signals.errorStack)) return "jsc";
+	return "unknown";
+}
+function resolveWasmEngineCapabilities(signals = collectWasmEngineProbeSignals()) {
+	const engine = classifyWasmEngineFamily(signals);
+	return {
+		engine,
+		supportsJSPI: signals.wasmSuspendingType === "function" && signals.wasmPromisingType === "function",
+		stackLeanRecommended: engine !== "v8"
+	};
+}
+/**
+* WASI environment defaults implied by the engine capabilities. Spread these
+* *before* caller-provided environment entries so an explicit
+* `SWIFTTUI_STACK_LEAN_PROFILE` (or a tuning override) always wins.
+*/
+function stackProfileEnvironmentDefaults(capabilities) {
+	if (capabilities.stackLeanRecommended) return {};
+	return { SWIFTTUI_STACK_LEAN_PROFILE: "0" };
+}
+//#endregion
+export { classifyWasmEngineFamily, collectWasmEngineProbeSignals, resolveWasmEngineCapabilities, stackProfileEnvironmentDefaults };
+
+//# sourceMappingURL=WasmEngineCapabilities.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WasmEngineCapabilities.js","names":[],"sources":["../../../src/wasi/WasmEngineCapabilities.ts"],"sourcesContent":["// Runtime detection of the browser's JS/wasm engine family and the wasm\n// capabilities that decide how the SwiftTUI WASI runtime should execute.\n//\n// JavaScriptCore runs wasm calls on the host thread's native stack, and\n// Darwin worker threads get ~1/16 of the main-thread stack budget, so\n// SwiftTUI's WASI build defaults to its stack-lean resolve profile\n// (`SWIFTTUI_STACK_LEAN_PROFILE`, depth-capped chunked resolve). That profile\n// costs steady-state pipeline time, and engines with roomy worker stacks\n// don't need it. Detection is deliberately asymmetric: a wrongly applied lean\n// profile only costs speed, while wrongly disabling it on JSC overflows the\n// wasm stack and kills the app — so lean stays recommended unless the engine\n// is confidently V8 (the only family with a measured, comfortable worker\n// budget). Gecko is kept on the lean profile until its worker wasm stack\n// budget is measured.\n//\n// Engine classification reads Error mechanics rather than user-agent\n// strings: V8 formats stack frames as `    at fn (url)`, JSC and Gecko as\n// `fn@url`, and the two are split by their engine-specific Error instance\n// properties (Gecko `fileName`, JSC `sourceURL`). Non-browser JSC hosts that\n// emulate V8 stack frames for Node compatibility (e.g. Bun) classify as\n// \"v8\"; the probe targets browser engines, where the formats don't cross.\n\nexport type WasmEngineFamily = \"v8\" | \"jsc\" | \"gecko\" | \"unknown\";\n\nexport interface WasmEngineProbeSignals {\n  errorStack: string;\n  errorHasGeckoFileName: boolean;\n  errorHasJSCSourceURL: boolean;\n  wasmSuspendingType: string;\n  wasmPromisingType: string;\n}\n\nexport interface WasmEngineCapabilities {\n  engine: WasmEngineFamily;\n  /**\n   * WebAssembly JavaScript Promise Integration (`WebAssembly.Suspending` +\n   * `WebAssembly.promising`). When true, a future main-thread execution path\n   * can suspend on stdin instead of blocking a worker on `Atomics.wait`.\n   */\n  supportsJSPI: boolean;\n  /**\n   * Whether the SwiftTUI WASI build should keep its stack-lean resolve\n   * profile on this engine.\n   */\n  stackLeanRecommended: boolean;\n}\n\nexport function collectWasmEngineProbeSignals(): WasmEngineProbeSignals {\n  const probe = new Error(\"wasm-engine-probe\");\n  const wasm = (\n    globalThis as {\n      WebAssembly?: { Suspending?: unknown; promising?: unknown };\n    }\n  ).WebAssembly;\n  return {\n    errorStack: typeof probe.stack === \"string\" ? probe.stack : \"\",\n    errorHasGeckoFileName: \"fileName\" in probe,\n    errorHasJSCSourceURL: \"sourceURL\" in probe,\n    wasmSuspendingType: typeof wasm?.Suspending,\n    wasmPromisingType: typeof wasm?.promising,\n  };\n}\n\nexport function classifyWasmEngineFamily(\n  signals: WasmEngineProbeSignals\n): WasmEngineFamily {\n  if (/^\\s*at /m.test(signals.errorStack)) {\n    return \"v8\";\n  }\n  if (signals.errorHasGeckoFileName) {\n    return \"gecko\";\n  }\n  if (signals.errorHasJSCSourceURL || /^[^\\n]*@/m.test(signals.errorStack)) {\n    return \"jsc\";\n  }\n  return \"unknown\";\n}\n\nexport function resolveWasmEngineCapabilities(\n  signals: WasmEngineProbeSignals = collectWasmEngineProbeSignals()\n): WasmEngineCapabilities {\n  const engine = classifyWasmEngineFamily(signals);\n  return {\n    engine,\n    supportsJSPI:\n      signals.wasmSuspendingType === \"function\" &&\n      signals.wasmPromisingType === \"function\",\n    stackLeanRecommended: engine !== \"v8\",\n  };\n}\n\n/**\n * WASI environment defaults implied by the engine capabilities. Spread these\n * *before* caller-provided environment entries so an explicit\n * `SWIFTTUI_STACK_LEAN_PROFILE` (or a tuning override) always wins.\n */\nexport function stackProfileEnvironmentDefaults(\n  capabilities: WasmEngineCapabilities\n): Record<string, string> {\n  if (capabilities.stackLeanRecommended) {\n    return {};\n  }\n  return { SWIFTTUI_STACK_LEAN_PROFILE: \"0\" };\n}\n"],"mappings":";AA+CA,SAAgB,gCAAwD;CACtE,MAAM,wBAAQ,IAAI,MAAM,mBAAmB;CAC3C,MAAM,OACJ,WAGA;CACF,OAAO;EACL,YAAY,OAAO,MAAM,UAAU,WAAW,MAAM,QAAQ;EAC5D,uBAAuB,cAAc;EACrC,sBAAsB,eAAe;EACrC,oBAAoB,OAAO,MAAM;EACjC,mBAAmB,OAAO,MAAM;CAClC;AACF;AAEA,SAAgB,yBACd,SACkB;CAClB,IAAI,WAAW,KAAK,QAAQ,UAAU,GACpC,OAAO;CAET,IAAI,QAAQ,uBACV,OAAO;CAET,IAAI,QAAQ,wBAAwB,YAAY,KAAK,QAAQ,UAAU,GACrE,OAAO;CAET,OAAO;AACT;AAEA,SAAgB,8BACd,UAAkC,8BAA8B,GACxC;CACxB,MAAM,SAAS,yBAAyB,OAAO;CAC/C,OAAO;EACL;EACA,cACE,QAAQ,uBAAuB,cAC/B,QAAQ,sBAAsB;EAChC,sBAAsB,WAAW;CACnC;AACF;;;;;;AAOA,SAAgB,gCACd,cACwB;CACxB,IAAI,aAAa,sBACf,OAAO,CAAC;CAEV,OAAO,EAAE,6BAA6B,IAAI;AAC5C"}

package/dist/wasi.d.ts

@@ -1,6 +1,7 @@
 import { encodeRenderStyleControlMessage, encodeResizeControlMessage } from "./src/WebHostSurfaceTransport.js";
 import { StdIOPipe } from "./src/wasi/StdIOPipe.js";
+import { WasmEngineCapabilities, WasmEngineFamily, WasmEngineProbeSignals, classifyWasmEngineFamily, collectWasmEngineProbeSignals, resolveWasmEngineCapabilities, stackProfileEnvironmentDefaults } from "./src/wasi/WasmEngineCapabilities.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 };
+export { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink, SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, StdIOPipe, WasmEngineCapabilities, WasmEngineFamily, WasmEngineProbeSignals, WasmSceneResizeEvent, WasmSceneRuntimeFactoryOptions, WasmSceneRuntimeHandle, classifyWasmEngineFamily, collectWasmEngineProbeSignals, createSharedInputQueue, createWasmSceneRuntimeFactory, encodeRenderStyleControlMessage, encodeResizeControlMessage, hydrateSharedInputQueue, resolveWasmEngineCapabilities, sharedInputQueueDefaultCapacity, stackProfileEnvironmentDefaults };

package/dist/wasi.js

@@ -1,6 +1,7 @@
 import { StdIOPipe } from "./src/wasi/StdIOPipe.js";
+import { classifyWasmEngineFamily, collectWasmEngineProbeSignals, resolveWasmEngineCapabilities, stackProfileEnvironmentDefaults } from "./src/wasi/WasmEngineCapabilities.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 };
+export { BrowserWASIBridge, SharedInputQueueReader, SharedInputQueueWriter, StdIOPipe, classifyWasmEngineFamily, collectWasmEngineProbeSignals, createSharedInputQueue, createWasmSceneRuntimeFactory, encodeRenderStyleControlMessage, encodeResizeControlMessage, hydrateSharedInputQueue, resolveWasmEngineCapabilities, sharedInputQueueDefaultCapacity, stackProfileEnvironmentDefaults };

package/package.json

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