@swifttui/web 0.4.2 → 0.4.4

package/dist/src/WebHostSceneRuntime.js

@@ -176,7 +176,7 @@ var WebHostSceneRuntime = class {
 		this.diagnosticText.textContent = `${this.diagnosticText.textContent ?? ""}${text}`;
 	}
 	notifyRuntimeIssue(issue) {
-		console.log(issue.description);
+		this.writeOutput(`${issue.description}\n`);
 	}
 	recordFrameDiagnostic(diagnostic) {
 		this.onFrameDiagnostic?.(diagnostic);

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 { DomSurfacePainter } from \"./DomSurfacePainter.ts\";\nimport type { WebHostSurfaceRendererKind } from \"./SurfaceRenderer.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 { normalizeSemantics } from \"./normalizeWireTokens.ts\";\nimport {\n  type WebHostFocusPresentation,\n  type WebHostFrameDiagnosticRecord,\n  type WebHostImagePayloadRequestHandler,\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  /** Optional for compatibility with custom bridges predating image recovery. */\n  requestImagePayloads?: WebHostImagePayloadRequestHandler;\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   * Which surface presenter draws the scene's frames. `\"canvas\"` (default)\n   * paints onto a 2D `<canvas>`; `\"dom\"` renders cells as absolutely\n   * positioned text elements — native font rendering and, uniquely, real\n   * text selection: hold Alt/Option and drag to select instead of sending\n   * pointer input to the app. See {@link WebHostSurfaceRendererKind}.\n   */\n  renderer?: WebHostSurfaceRendererKind;\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 rendererKind: WebHostSurfaceRendererKind;\n  private readonly painter: CanvasSurfacePainter | DomSurfacePainter;\n  private readonly inputEncoder = new InputEventEncoder();\n  private currentStyle: ResolvedWebHostTerminalStyle;\n  private canvas?: HTMLCanvasElement;\n  private domSurfaceRoot?: HTMLElement;\n  private lastDomSurfaceSize?: { width: number; height: number };\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.rendererKind = options.renderer ?? \"canvas\";\n    const onImagePayloadMiss = (\n      ids: readonly string[]\n    ): readonly string[] | void => {\n      return this.bridge?.requestImagePayloads?.(ids);\n    };\n    this.painter = this.rendererKind === \"dom\"\n      ? new DomSurfacePainter({ onImagePayloadMiss })\n      : new CanvasSurfacePainter({ onImagePayloadMiss });\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.surfaceElement) {\n      return;\n    }\n\n    if (this.painter instanceof DomSurfacePainter) {\n      const surfaceRoot = document.createElement(\"div\");\n      surfaceRoot.className = \"webhost-scene__surface webhost-scene__surface--dom\";\n      surfaceRoot.setAttribute(\"aria-hidden\", \"true\");\n      this.domSurfaceRoot = surfaceRoot;\n      this.painter.attach(surfaceRoot);\n    } else {\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    }\n    this.accessibilityTree = new AccessibilityTreeMounter();\n    this.terminalMount.replaceChildren(\n      this.surfaceElement as HTMLElement,\n      this.accessibilityTree.element,\n      this.accessibilityTree.announcerElement\n    );\n    this.installInputHandlers();\n    this.installResizeObserver();\n\n    this.bridge?.bindOutput({\n      presentSurface: (frame, recoveredImagePayloadIds) =>\n        this.presentSurface(frame, recoveredImagePayloadIds),\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.resizeSurface();\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    recoveredImagePayloadIds?: readonly string[]\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.resizeSurface();\n    this.draw(\n      previousFrame && !resized ? frame.damage : undefined,\n      recoveredImagePayloadIds\n    );\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    const presentation = this.currentFrame?.focusPresentation;\n    if (!presentation) {\n      return undefined;\n    }\n    return {\n      ...presentation,\n      semantics: normalizeSemantics(presentation.semantics),\n    };\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    if (this.domSurfaceRoot) {\n      this.domSurfaceRoot.style.display = \"block\";\n      this.domSurfaceRoot.style.position = \"relative\";\n    }\n  }\n\n  /** The element the active painter presents frames into. */\n  private get surfaceElement(): HTMLElement | undefined {\n    return this.canvas ?? this.domSurfaceRoot;\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      if (this.allowsNativeTextSelection(event)) {\n        // DOM renderer + Alt/Option: leave the event to the browser so the\n        // drag becomes a native text selection instead of app pointer input.\n        return;\n      }\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      if (!this.hasCapturedPointer && this.allowsNativeTextSelection(event)) {\n        return;\n      }\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      if (!this.hasCapturedPointer && this.allowsNativeTextSelection(event)) {\n        return;\n      }\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.resizeSurface();\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 resizeSurface(): boolean {\n    const cssWidth = Math.max(1, this.columns * this.cellWidth);\n    const cssHeight = Math.max(1, this.rows * this.cellHeight);\n\n    if (this.domSurfaceRoot) {\n      const last = this.lastDomSurfaceSize;\n      if (last && last.width === cssWidth && last.height === cssHeight) {\n        return false;\n      }\n      this.lastDomSurfaceSize = { width: cssWidth, height: cssHeight };\n      this.domSurfaceRoot.style.width = `${cssWidth}px`;\n      this.domSurfaceRoot.style.height = `${cssHeight}px`;\n      return true;\n    }\n\n    if (!this.canvas) {\n      return false;\n    }\n\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    recoveredImagePayloadIds?: readonly string[]\n  ): void {\n    this.painter.paint(\n      this.surfaceMetrics(),\n      this.currentFrame,\n      damage,\n      recoveredImagePayloadIds\n    );\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.surfaceElement?.getBoundingClientRect?.() ?? this.terminalMount.getBoundingClientRect?.(),\n      cellWidth: this.cellWidth,\n      cellHeight: this.cellHeight,\n      columns: this.columns,\n      rows: this.rows,\n    };\n  }\n\n  /**\n   * Whether this pointer event should be left to the browser for native text\n   * selection instead of being forwarded to the app. Only the DOM renderer\n   * has real text nodes to select, and only while Alt/Option is held — plain\n   * pointer input still belongs to the app.\n   */\n  private allowsNativeTextSelection(\n    event: MouseEvent\n  ): boolean {\n    return this.rendererKind === \"dom\" && event.altKey;\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 { DomSurfacePainter } from \"./DomSurfacePainter.ts\";\nimport type { WebHostSurfaceRendererKind } from \"./SurfaceRenderer.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 { normalizeSemantics } from \"./normalizeWireTokens.ts\";\nimport {\n  type WebHostFocusPresentation,\n  type WebHostFrameDiagnosticRecord,\n  type WebHostImagePayloadRequestHandler,\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  /** Optional for compatibility with custom bridges predating image recovery. */\n  requestImagePayloads?: WebHostImagePayloadRequestHandler;\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   * Which surface presenter draws the scene's frames. `\"canvas\"` (default)\n   * paints onto a 2D `<canvas>`; `\"dom\"` renders cells as absolutely\n   * positioned text elements — native font rendering and, uniquely, real\n   * text selection: hold Alt/Option and drag to select instead of sending\n   * pointer input to the app. See {@link WebHostSurfaceRendererKind}.\n   */\n  renderer?: WebHostSurfaceRendererKind;\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 rendererKind: WebHostSurfaceRendererKind;\n  private readonly painter: CanvasSurfacePainter | DomSurfacePainter;\n  private readonly inputEncoder = new InputEventEncoder();\n  private currentStyle: ResolvedWebHostTerminalStyle;\n  private canvas?: HTMLCanvasElement;\n  private domSurfaceRoot?: HTMLElement;\n  private lastDomSurfaceSize?: { width: number; height: number };\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.rendererKind = options.renderer ?? \"canvas\";\n    const onImagePayloadMiss = (\n      ids: readonly string[]\n    ): readonly string[] | void => {\n      return this.bridge?.requestImagePayloads?.(ids);\n    };\n    this.painter = this.rendererKind === \"dom\"\n      ? new DomSurfacePainter({ onImagePayloadMiss })\n      : new CanvasSurfacePainter({ onImagePayloadMiss });\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.surfaceElement) {\n      return;\n    }\n\n    if (this.painter instanceof DomSurfacePainter) {\n      const surfaceRoot = document.createElement(\"div\");\n      surfaceRoot.className = \"webhost-scene__surface webhost-scene__surface--dom\";\n      surfaceRoot.setAttribute(\"aria-hidden\", \"true\");\n      this.domSurfaceRoot = surfaceRoot;\n      this.painter.attach(surfaceRoot);\n    } else {\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    }\n    this.accessibilityTree = new AccessibilityTreeMounter();\n    this.terminalMount.replaceChildren(\n      this.surfaceElement as HTMLElement,\n      this.accessibilityTree.element,\n      this.accessibilityTree.announcerElement\n    );\n    this.installInputHandlers();\n    this.installResizeObserver();\n\n    this.bridge?.bindOutput({\n      presentSurface: (frame, recoveredImagePayloadIds) =>\n        this.presentSurface(frame, recoveredImagePayloadIds),\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.resizeSurface();\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    // Into the mount, not only the console: a runtime issue is the app telling\n    // the user something went wrong, and a console line is invisible to anyone\n    // who is not already looking at devtools.\n    this.writeOutput(`${issue.description}\\n`);\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    recoveredImagePayloadIds?: readonly string[]\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.resizeSurface();\n    this.draw(\n      previousFrame && !resized ? frame.damage : undefined,\n      recoveredImagePayloadIds\n    );\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    const presentation = this.currentFrame?.focusPresentation;\n    if (!presentation) {\n      return undefined;\n    }\n    return {\n      ...presentation,\n      semantics: normalizeSemantics(presentation.semantics),\n    };\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    if (this.domSurfaceRoot) {\n      this.domSurfaceRoot.style.display = \"block\";\n      this.domSurfaceRoot.style.position = \"relative\";\n    }\n  }\n\n  /** The element the active painter presents frames into. */\n  private get surfaceElement(): HTMLElement | undefined {\n    return this.canvas ?? this.domSurfaceRoot;\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      if (this.allowsNativeTextSelection(event)) {\n        // DOM renderer + Alt/Option: leave the event to the browser so the\n        // drag becomes a native text selection instead of app pointer input.\n        return;\n      }\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      if (!this.hasCapturedPointer && this.allowsNativeTextSelection(event)) {\n        return;\n      }\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      if (!this.hasCapturedPointer && this.allowsNativeTextSelection(event)) {\n        return;\n      }\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.resizeSurface();\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 resizeSurface(): boolean {\n    const cssWidth = Math.max(1, this.columns * this.cellWidth);\n    const cssHeight = Math.max(1, this.rows * this.cellHeight);\n\n    if (this.domSurfaceRoot) {\n      const last = this.lastDomSurfaceSize;\n      if (last && last.width === cssWidth && last.height === cssHeight) {\n        return false;\n      }\n      this.lastDomSurfaceSize = { width: cssWidth, height: cssHeight };\n      this.domSurfaceRoot.style.width = `${cssWidth}px`;\n      this.domSurfaceRoot.style.height = `${cssHeight}px`;\n      return true;\n    }\n\n    if (!this.canvas) {\n      return false;\n    }\n\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    recoveredImagePayloadIds?: readonly string[]\n  ): void {\n    this.painter.paint(\n      this.surfaceMetrics(),\n      this.currentFrame,\n      damage,\n      recoveredImagePayloadIds\n    );\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.surfaceElement?.getBoundingClientRect?.() ?? this.terminalMount.getBoundingClientRect?.(),\n      cellWidth: this.cellWidth,\n      cellHeight: this.cellHeight,\n      columns: this.columns,\n      rows: this.rows,\n    };\n  }\n\n  /**\n   * Whether this pointer event should be left to the browser for native text\n   * selection instead of being forwarded to the app. Only the DOM renderer\n   * has real text nodes to select, and only while Alt/Option is held — plain\n   * pointer input still belongs to the app.\n   */\n  private allowsNativeTextSelection(\n    event: MouseEvent\n  ): boolean {\n    return this.rendererKind === \"dom\" && event.altKey;\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/WebHostSurfaceTransport.d.ts

@@ -124,7 +124,19 @@ interface WebHostSurfaceDeltaFrame {
   sequence?: number;
   width: number;
   height: number;
+  /**
+   * With `stylesBase` present, only the styles this record *added*: index `i`
+   * of this array is table index `stylesBase + i`. Absent `stylesBase`, the
+   * complete accumulated table, as deployed decoders expect.
+   */
   styles: Array<WebHostSurfaceStyle | null>;
+  /**
+   * Where `styles` splices onto the retained table. Present only when the
+   * client declared `styleAppend`, which is why it is negotiated rather than
+   * additive: reading `styles` as a whole table when this is present
+   * mis-indexes every style in the record.
+   */
+  stylesBase?: number;
   deltaRows: WebHostSurfaceDeltaRow[];
   images?: WebHostSurfaceImage[];
   damage?: WebHostSurfaceDamage;
@@ -249,6 +261,16 @@ declare class WebHostOutputDecoder {
   private recoveredImagePayloadIds;
   private sweepImageResyncForPresentedImages;
   private materializeDeltaFrame;
+  /**
+   * The delta's style table: either the record's own complete table, or the
+   * negotiated append spliced onto the baseline's.
+   *
+   * A `stylesBase` that does not name the end of the retained table is a
+   * structural break, not a recoverable one — splicing at the wrong offset
+   * silently repaints cells in the wrong style, which is worse than refusing
+   * the record and asking for a keyframe.
+   */
+  private materializeDeltaStyles;
 }
 declare function encodeResizeControlMessage(columns: number, rows: number, cellWidth?: number, cellHeight?: number): Uint8Array;
 declare function encodeRenderStyleControlMessage(style: WebHostTerminalStyle): Uint8Array;

package/dist/src/WebHostSurfaceTransport.js

@@ -254,6 +254,8 @@ var WebHostOutputDecoder = class {
 	materializeDeltaFrame(frame) {
 		const baseline = this.lastSurfaceFrame;
 		if (!baseline) return;
+		const styles = this.materializeDeltaStyles(frame, baseline);
+		if (!styles) return;
 		const rows = baseline.rows.slice();
 		for (const [row, cells] of frame.deltaRows) {
 			if (!Number.isSafeInteger(row) || row < 0 || row >= frame.height) return;
@@ -266,7 +268,7 @@ var WebHostOutputDecoder = class {
 			sequence: frame.sequence,
 			width: frame.width,
 			height: frame.height,
-			styles: frame.styles,
+			styles,
 			rows,
 			images: frame.images,
 			damage: frame.damage,
@@ -280,6 +282,20 @@ var WebHostOutputDecoder = class {
 			preferredGridHeight: frame.preferredGridHeight
 		};
 	}
+	/**
+	* The delta's style table: either the record's own complete table, or the
+	* negotiated append spliced onto the baseline's.
+	*
+	* A `stylesBase` that does not name the end of the retained table is a
+	* structural break, not a recoverable one — splicing at the wrong offset
+	* silently repaints cells in the wrong style, which is worse than refusing
+	* the record and asking for a keyframe.
+	*/
+	materializeDeltaStyles(frame, baseline) {
+		if (frame.stylesBase === void 0) return frame.styles;
+		if (frame.stylesBase !== baseline.styles.length) return;
+		return baseline.styles.concat(frame.styles);
+	}
 };
 function boundedImageResyncIds(sortedIds, maximumEncodedBytes) {
 	if (maximumEncodedBytes === void 0 || !Number.isFinite(maximumEncodedBytes)) return {
@@ -342,7 +358,7 @@ function encodeRenderStyleControlMessage(style) {
 	return textEncoder.encode(`${recordPrefix}style:${encoded}\n`);
 }
 function encodeCapabilitiesControlMessage() {
-	return textEncoder.encode(`${recordPrefix}caps:{"acceptsDeltaFrames":true}\n`);
+	return textEncoder.encode(`${recordPrefix}caps:{"acceptsDeltaFrames":true,"styleAppend":true}\n`);
 }
 function encodeResyncControlMessage(request) {
 	const payload = request.scope === "keyframe" ? { scope: "keyframe" } : {
@@ -382,7 +398,7 @@ function isWebHostSurfaceFrame(value) {
 function isWebHostSurfaceDeltaFrame(value) {
 	if (!value || typeof value !== "object") return false;
 	const frame = value;
-	return frame.version === 3 && frame.encoding === "delta" && (frame.sequence === void 0 || Number.isSafeInteger(frame.sequence) && frame.sequence >= 0) && typeof frame.width === "number" && typeof frame.height === "number" && Array.isArray(frame.styles) && Array.isArray(frame.deltaRows) && frame.deltaRows.every(isWebHostSurfaceDeltaRow) && isOptionalSafeInteger(frame.baselineGen) && (frame.images === void 0 || isWebHostSurfaceImages(frame.images)) && (frame.damage === void 0 || isWebHostSurfaceDamage(frame.damage)) && (frame.accessibilityTree === void 0 || isWebHostAccessibilityNodes(frame.accessibilityTree)) && (frame.accessibilityAnnouncements === void 0 || isWebHostAccessibilityAnnouncements(frame.accessibilityAnnouncements)) && (frame.scrollRegions === void 0 || isWebHostScrollRegions(frame.scrollRegions)) && hasValidAdditiveFrameFields(frame);
+	return frame.version === 3 && frame.encoding === "delta" && (frame.sequence === void 0 || Number.isSafeInteger(frame.sequence) && frame.sequence >= 0) && typeof frame.width === "number" && typeof frame.height === "number" && Array.isArray(frame.styles) && Array.isArray(frame.deltaRows) && frame.deltaRows.every(isWebHostSurfaceDeltaRow) && isOptionalSafeInteger(frame.baselineGen) && isOptionalSafeInteger(frame.stylesBase) && (frame.images === void 0 || isWebHostSurfaceImages(frame.images)) && (frame.damage === void 0 || isWebHostSurfaceDamage(frame.damage)) && (frame.accessibilityTree === void 0 || isWebHostAccessibilityNodes(frame.accessibilityTree)) && (frame.accessibilityAnnouncements === void 0 || isWebHostAccessibilityAnnouncements(frame.accessibilityAnnouncements)) && (frame.scrollRegions === void 0 || isWebHostScrollRegions(frame.scrollRegions)) && hasValidAdditiveFrameFields(frame);
 }
 /**
 * The F19 additive fields shared by the full and delta record shapes. Absent

package/dist/src/WebHostSurfaceTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebHostSurfaceTransport.js","names":[],"sources":["../../src/WebHostSurfaceTransport.ts"],"sourcesContent":["/**\n * Browser consumer for SwiftTUI's host wire. The normative cross-host\n * contract lives upstream:\n * https://github.com/SwiftTUI/swift-tui/blob/main/docs/HOST-WIRE-CONTRACT.md\n */\nimport {\n  encodeWebHostTerminalRenderStyleBase64,\n  type WebHostTerminalStyle,\n} from \"./WebHostTerminalStyle.ts\";\n\nexport interface WebHostSurfaceStyle {\n  fg?: string;\n  bg?: string;\n  em?: number;\n  underline?: WebHostSurfaceLineStyle;\n  strikethrough?: WebHostSurfaceLineStyle;\n  opacity?: number;\n}\n\nexport interface WebHostSurfaceLineStyle {\n  pattern: \"solid\" | \"dot\" | \"dash\" | \"dashDot\" | \"dashDotDot\" | \"double\" | \"curly\";\n  color?: string;\n}\n\nexport type WebHostSurfaceCell = [\n  x: number,\n  text: string,\n  span: number,\n  styleIndex: number,\n];\n\nexport type WebHostSurfaceRect = [\n  x: number,\n  y: number,\n  width: number,\n  height: number,\n];\n\nexport type WebHostSurfaceSize = [\n  width: number,\n  height: number,\n];\n\nexport type WebHostAccessibilityPoint = [\n  x: number,\n  y: number,\n];\n\nexport type WebHostAccessibilityLiveRegion = string;\n\nexport interface WebHostAccessibilityNode {\n  id: string;\n  parentId?: string;\n  rect: WebHostSurfaceRect;\n  role: string;\n  label?: string;\n  hint?: string;\n  /** omitted when false */\n  hidden?: boolean;\n  liveRegion?: WebHostAccessibilityLiveRegion;\n  cursorAnchor?: WebHostAccessibilityPoint;\n  isFocused?: boolean;\n}\n\n/**\n * One hyperlink run within a row: [x, spanWidth, linkTargetIndex]. The index\n * points into the frame's deduplicated `linkTargets` table.\n */\nexport type WebHostSurfaceLinkRun = [\n  x: number,\n  span: number,\n  targetIndex: number,\n];\n\n/** Hyperlink runs for one row: [rowIndex, runs]. */\nexport type WebHostSurfaceLinkRow = [\n  row: number,\n  runs: WebHostSurfaceLinkRun[],\n];\n\nexport type WebHostFocusSemantics = string;\n\n/**\n * The settled focus presentation for a committed frame — the same derivation\n * the Android host consumes (`prefersTextInput` gates its IME).\n */\nexport interface WebHostFocusPresentation {\n  focusedIdentity?: string;\n  semantics: WebHostFocusSemantics;\n  prefersTextInput: boolean;\n  hasFocusedRegion: boolean;\n}\n\nexport interface WebHostAccessibilityAnnouncement {\n  message: string;\n  politeness: WebHostAccessibilityLiveRegion;\n}\n\nexport type WebHostSurfaceImageFormat = string;\n\n/**\n * Reports locally unresolved image IDs to a recovery-capable host. The first\n * branch lets bounded hosts return the admitted subset; the explicit legacy\n * void branch preserves contextual typing for concise callbacks that return\n * incidental values such as `array.push(...)`.\n */\nexport type WebHostImagePayloadRequestHandler =\n  | ((ids: readonly string[]) => readonly string[])\n  | ((ids: readonly string[]) => void);\n\nexport interface WebHostSurfaceImage {\n  id: string;\n  format: WebHostSurfaceImageFormat;\n  bounds: WebHostSurfaceRect;\n  visibleBounds: WebHostSurfaceRect;\n  scalingMode: string;\n  pixelSize?: WebHostSurfaceSize;\n  dataBase64?: string;\n}\n\nexport type WebHostSurfaceDamageRange = [\n  start: number,\n  end: number,\n];\n\nexport type WebHostSurfaceDamageTextRow = [\n  row: number,\n  ranges: WebHostSurfaceDamageRange[],\n];\n\nexport interface WebHostSurfaceDamage {\n  textRows: WebHostSurfaceDamageTextRow[];\n  requiresFullTextRepaint: boolean;\n  requiresFullGraphicsReplay: boolean;\n}\n\n/**\n * Per-region scroll extent published with each frame so the host can implement\n * scroll-chaining: capture the wheel only while the region under the pointer can\n * still scroll in the wheel's direction, otherwise let it fall through to the\n * page. The host recomputes the per-direction headroom from `offset`/`content`/\n * the viewport `rect`, mirroring SwiftTUI's\n * `min(max(0, offset), max(0, content - viewport))` clamp.\n */\nexport interface WebHostScrollRegion {\n  /** identity path — same key space as accessibility node ids */\n  id: string;\n  /** viewport rect in cells: [x, y, width, height] */\n  rect: WebHostSurfaceRect;\n  /** current clamped scroll offset in cells: [x, y] */\n  offset: WebHostAccessibilityPoint;\n  /** total content size in cells: [width, height] */\n  content: WebHostSurfaceSize;\n}\n\nexport interface WebHostSurfaceFrame {\n  version: 1 | 2;\n  epoch?: number;\n  gen?: number;\n  sequence?: number;\n  width: number;\n  height: number;\n  styles: Array<WebHostSurfaceStyle | null>;\n  rows: WebHostSurfaceCell[][];\n  images?: WebHostSurfaceImage[];\n  damage?: WebHostSurfaceDamage;\n  accessibilityTree?: WebHostAccessibilityNode[];\n  accessibilityAnnouncements?: WebHostAccessibilityAnnouncement[];\n  scrollRegions?: WebHostScrollRegion[];\n  links?: WebHostSurfaceLinkRow[];\n  linkTargets?: string[];\n  focusPresentation?: WebHostFocusPresentation;\n  preferredGridWidth?: number;\n  preferredGridHeight?: number;\n}\n\nexport type WebHostSurfaceDeltaRow = [\n  row: number,\n  cells: WebHostSurfaceCell[],\n];\n\nexport interface WebHostSurfaceDeltaFrame {\n  version: 3;\n  encoding: \"delta\";\n  epoch?: number;\n  gen?: number;\n  baselineGen?: number;\n  sequence?: number;\n  width: number;\n  height: number;\n  styles: Array<WebHostSurfaceStyle | null>;\n  deltaRows: WebHostSurfaceDeltaRow[];\n  images?: WebHostSurfaceImage[];\n  damage?: WebHostSurfaceDamage;\n  accessibilityTree?: WebHostAccessibilityNode[];\n  accessibilityAnnouncements?: WebHostAccessibilityAnnouncement[];\n  scrollRegions?: WebHostScrollRegion[];\n  links?: WebHostSurfaceLinkRow[];\n  linkTargets?: string[];\n  focusPresentation?: WebHostFocusPresentation;\n  preferredGridWidth?: number;\n  preferredGridHeight?: number;\n}\n\nexport interface WebHostRuntimeIssue {\n  severity: \"warning\" | \"error\";\n  code: string;\n  message: string;\n  description: string;\n  identity?: string;\n  source?: string;\n}\n\nexport interface WebHostFrameDiagnosticRecord {\n  format: \"swift-tui-frame-diagnostics-v1\";\n  header: string[];\n  fields: string[];\n}\n\nexport type WebHostOutputRecord =\n  | { type: \"surface\"; frame: WebHostSurfaceFrame }\n  | { type: \"clipboard\"; text: string }\n  | { type: \"runtimeIssue\"; issue: WebHostRuntimeIssue }\n  | { type: \"frameDiagnostic\"; diagnostic: WebHostFrameDiagnosticRecord }\n  | { type: \"surfaceDropped\"; reason: \"noBaseline\" | \"staleBaseline\" }\n  | { type: \"text\"; text: string };\n\nexport type WebHostResyncRequest =\n  | { scope: \"keyframe\" }\n  | { scope: \"images\"; ids?: string[] };\n\nexport interface WebHostOutputSink {\n  presentSurface(\n    frame: WebHostSurfaceFrame,\n    recoveredImagePayloadIds?: readonly string[]\n  ): void;\n  writeClipboard?(text: string): void | Promise<void>;\n  notifyRuntimeIssue?(issue: WebHostRuntimeIssue): void;\n  recordFrameDiagnostic?(diagnostic: WebHostFrameDiagnosticRecord): void;\n  writeOutput?(text: string): void;\n  writeError?(text: string): void;\n}\n\nexport interface WebHostKeyInput {\n  key:\n    | \"return\"\n    | \"space\"\n    | \"tab\"\n    | \"arrowLeft\"\n    | \"arrowRight\"\n    | \"arrowUp\"\n    | \"arrowDown\"\n    | \"backspace\"\n    | \"escape\"\n    | \"home\"\n    | \"end\"\n    | \"character\";\n  character?: string;\n  modifiers?: number;\n}\n\nexport interface WebHostMouseInput {\n  kind: \"down\" | \"up\" | \"moved\" | \"dragged\" | \"scrolled\";\n  x: number;\n  y: number;\n  button?: \"primary\" | \"middle\" | \"secondary\";\n  deltaX?: number;\n  deltaY?: number;\n  modifiers?: number;\n}\n\nconst recordPrefix = \"\\u001E\";\nconst textEncoder = new TextEncoder();\n\n/** Limits wire-derived recovery state and keeps every single-ID WASI request bounded. */\nexport const MAX_IMAGE_RECOVERY_ID_BYTES = 1_024;\nexport const MAX_OUTSTANDING_IMAGE_RECOVERY_IDS = 1_024;\n\nexport function isWebHostImageRecoveryId(\n  id: string\n): boolean {\n  return id.length > 0\n    && id.length <= MAX_IMAGE_RECOVERY_ID_BYTES\n    && textEncoder.encode(id).byteLength <= MAX_IMAGE_RECOVERY_ID_BYTES;\n}\n\n/**\n * The newest `surface` record version this runtime understands. Unknown\n * additive object keys are ignored by design (older runtimes render newer\n * frames), but a frame declaring a NEWER version than this is surfaced as an\n * error-severity runtime issue instead of silently degrading to a text\n * diagnostic — silent version skew is the failure mode this guards against\n * (F57).\n */\nexport const SUPPORTED_SURFACE_VERSION = 3;\n\nexport class WebHostOutputDecoder {\n  private readonly textDecoder = new TextDecoder();\n  private bufferedText = \"\";\n  private lastSurfaceFrame?: WebHostSurfaceFrame;\n  private lastEpoch?: number;\n  private lastGen?: number;\n  private lastPresentedEpoch?: number;\n  private keyframeResyncOutstanding = false;\n  private keyframeResyncPending = false;\n  private readonly imageResyncOutstandingIds = new Set<string>();\n  private readonly imageResyncPendingIds = new Set<string>();\n\n  feed(\n    chunk: Uint8Array\n  ): WebHostOutputRecord[] {\n    this.bufferedText += this.textDecoder.decode(chunk, { stream: true });\n    const records: WebHostOutputRecord[] = [];\n\n    while (true) {\n      const newlineIndex = this.bufferedText.indexOf(\"\\n\");\n      if (newlineIndex < 0) {\n        break;\n      }\n\n      const line = this.bufferedText.slice(0, newlineIndex);\n      this.bufferedText = this.bufferedText.slice(newlineIndex + 1);\n      records.push(this.decodeLine(line));\n    }\n\n    if (this.bufferedText.length > 4096 && !this.bufferedText.startsWith(recordPrefix)) {\n      records.push({ type: \"text\", text: this.bufferedText });\n      this.bufferedText = \"\";\n    }\n\n    return records;\n  }\n\n  flush(): WebHostOutputRecord[] {\n    if (!this.bufferedText) {\n      return [];\n    }\n    const text = this.bufferedText;\n    this.bufferedText = \"\";\n    return [this.decodeLine(text)];\n  }\n\n  takeResyncRequest(\n    maximumEncodedBytes?: number\n  ): WebHostResyncRequest | undefined {\n    if (this.keyframeResyncPending) {\n      this.keyframeResyncPending = false;\n      return { scope: \"keyframe\" };\n    }\n    if (this.imageResyncPendingIds.size === 0) {\n      return undefined;\n    }\n\n    const sortedIds = [...this.imageResyncPendingIds].sort();\n    const { ids, rejectedIds } = boundedImageResyncIds(\n      sortedIds,\n      maximumEncodedBytes\n    );\n    for (const id of rejectedIds) {\n      this.imageResyncPendingIds.delete(id);\n      this.imageResyncOutstandingIds.delete(id);\n    }\n    for (const id of ids) {\n      this.imageResyncPendingIds.delete(id);\n    }\n    if (ids.length === 0) {\n      return undefined;\n    }\n    return { scope: \"images\", ids };\n  }\n\n  /**\n   * Adds locally unresolved image IDs to this epoch's recovery set. IDs remain\n   * outstanding after delivery, so repeat painter misses cannot create storms;\n   * a payload-bearing record or epoch re-anchor releases them. Returns the IDs\n   * now tracked (new or already outstanding); callers should suppress repeats\n   * only for this admitted subset.\n   */\n  requestImagePayloads(\n    ids: Iterable<string>\n  ): readonly string[] {\n    const acceptedIds = new Set<string>();\n    for (const id of ids) {\n      if (!isWebHostImageRecoveryId(id)) {\n        continue;\n      }\n      if (this.imageResyncOutstandingIds.has(id)) {\n        acceptedIds.add(id);\n        continue;\n      }\n      if (\n        this.imageResyncOutstandingIds.size\n        >= MAX_OUTSTANDING_IMAGE_RECOVERY_IDS\n      ) {\n        continue;\n      }\n      this.imageResyncOutstandingIds.add(id);\n      this.imageResyncPendingIds.add(id);\n      acceptedIds.add(id);\n    }\n    return [...acceptedIds];\n  }\n\n  /**\n   * Advances image recovery immediately before one decoded surface reaches its\n   * presenter. Payload arrival and epoch reset therefore follow delivery order\n   * rather than `feed`'s parse-ahead order across a multi-record chunk. The\n   * return value identifies payloads that answer an outstanding image request,\n   * so presenters can open exactly one fresh local decode generation even when\n   * content-addressed retransmission uses identical bytes.\n   */\n  prepareToPresentSurface(\n    frame: WebHostSurfaceFrame\n  ): readonly string[] {\n    const recoveredImagePayloadIds = this.recoveredImagePayloadIds(frame.images);\n    this.resetImageResyncForEpoch(frame.epoch);\n    this.sweepImageResyncForPresentedImages(frame.images);\n    this.clearArrivedImagePayloads(frame.images);\n    if (frame.epoch !== undefined) {\n      this.lastPresentedEpoch = frame.epoch;\n    }\n    return recoveredImagePayloadIds;\n  }\n\n  resyncRequestDeliveryFailed(\n    request: WebHostResyncRequest\n  ): void {\n    if (request.scope === \"keyframe\") {\n      if (this.keyframeResyncOutstanding) {\n        this.keyframeResyncPending = true;\n      }\n      return;\n    }\n\n    for (const id of request.ids ?? []) {\n      if (this.imageResyncOutstandingIds.has(id)) {\n        this.imageResyncPendingIds.add(id);\n      }\n    }\n  }\n\n  private decodeLine(\n    line: string\n  ): WebHostOutputRecord {\n    if (line.startsWith(`${recordPrefix}clipboard:`)) {\n      try {\n        const record = JSON.parse(line.slice(`${recordPrefix}clipboard:`.length));\n        if (isWebHostClipboardRecord(record)) {\n          return { type: \"clipboard\", text: record.text };\n        }\n      } catch {\n        // Fall through to the text path below so malformed output remains visible.\n      }\n\n      return { type: \"text\", text: `${line}\\n` };\n    }\n\n    if (line.startsWith(`${recordPrefix}runtimeIssue:`)) {\n      try {\n        const record = JSON.parse(line.slice(`${recordPrefix}runtimeIssue:`.length));\n        if (isWebHostRuntimeIssue(record)) {\n          return { type: \"runtimeIssue\", issue: record };\n        }\n      } catch {\n        // Fall through to the text path below so malformed output remains visible.\n      }\n\n      return { type: \"text\", text: `${line}\\n` };\n    }\n\n    if (line.startsWith(`${recordPrefix}frameDiagnostic:`)) {\n      try {\n        const record = JSON.parse(line.slice(`${recordPrefix}frameDiagnostic:`.length));\n        if (isWebHostFrameDiagnosticRecord(record)) {\n          return { type: \"frameDiagnostic\", diagnostic: record };\n        }\n      } catch {\n        // Fall through to the text path below so malformed output remains visible.\n      }\n\n      return { type: \"text\", text: `${line}\\n` };\n    }\n\n    if (!line.startsWith(`${recordPrefix}surface:`)) {\n      return { type: \"text\", text: `${line}\\n` };\n    }\n\n    try {\n      const frame = JSON.parse(line.slice(`${recordPrefix}surface:`.length));\n      if (declaresNewerSurfaceVersion(frame)) {\n        return {\n          type: \"runtimeIssue\",\n          issue: {\n            severity: \"error\",\n            code: \"surface.unsupportedVersion\",\n            message: `SwiftTUI surface version ${frame.version} is newer than the supported ${SUPPORTED_SURFACE_VERSION}`,\n            description: \"The app emitted a surface record with version \"\n              + `${frame.version}, but this @swifttui/web runtime understands `\n              + `versions up to ${SUPPORTED_SURFACE_VERSION}. Update @swifttui/web `\n              + \"to render it.\",\n          },\n        };\n      }\n      if (isWebHostSurfaceFrame(frame)) {\n        this.lastSurfaceFrame = frame;\n        this.lastEpoch = frame.epoch;\n        this.lastGen = frame.gen;\n        this.keyframeResyncOutstanding = false;\n        this.keyframeResyncPending = false;\n        return { type: \"surface\", frame };\n      }\n      if (isWebHostSurfaceDeltaFrame(frame)) {\n        const carriesDeliveryStamps = frame.epoch !== undefined\n          || frame.gen !== undefined\n          || frame.baselineGen !== undefined;\n        if (\n          !this.lastSurfaceFrame\n          || this.lastSurfaceFrame.width !== frame.width\n          || this.lastSurfaceFrame.height !== frame.height\n        ) {\n          if (carriesDeliveryStamps) {\n            this.requestKeyframeResync();\n          }\n          return { type: \"surfaceDropped\", reason: \"noBaseline\" };\n        }\n        if (\n          carriesDeliveryStamps\n          && (\n            frame.epoch === undefined\n            || frame.gen === undefined\n            || frame.baselineGen === undefined\n            || frame.epoch !== this.lastEpoch\n            || frame.baselineGen !== this.lastGen\n          )\n        ) {\n          this.requestKeyframeResync();\n          return { type: \"surfaceDropped\", reason: \"staleBaseline\" };\n        }\n        const materialized = this.materializeDeltaFrame(frame);\n        if (materialized) {\n          this.lastSurfaceFrame = materialized;\n          this.lastEpoch = frame.epoch;\n          this.lastGen = frame.gen;\n          return { type: \"surface\", frame: materialized };\n        }\n      }\n    } catch {\n      // Fall through to the text path below so malformed output remains visible.\n    }\n\n    return { type: \"text\", text: `${line}\\n` };\n  }\n\n  private requestKeyframeResync(): void {\n    if (this.keyframeResyncOutstanding) {\n      return;\n    }\n    this.keyframeResyncOutstanding = true;\n    this.keyframeResyncPending = true;\n  }\n\n  private resetImageResyncForEpoch(\n    epoch: number | undefined\n  ): void {\n    if (epoch === undefined || epoch === this.lastPresentedEpoch) {\n      return;\n    }\n    this.imageResyncOutstandingIds.clear();\n    this.imageResyncPendingIds.clear();\n  }\n\n  private clearArrivedImagePayloads(\n    images: WebHostSurfaceImage[] | undefined\n  ): void {\n    for (const image of images ?? []) {\n      if (image.dataBase64 === undefined) {\n        continue;\n      }\n      this.imageResyncOutstandingIds.delete(image.id);\n      this.imageResyncPendingIds.delete(image.id);\n    }\n  }\n\n  private recoveredImagePayloadIds(\n    images: WebHostSurfaceImage[] | undefined\n  ): string[] {\n    const recoveredIds = new Set<string>();\n    for (const image of images ?? []) {\n      if (\n        image.dataBase64 !== undefined\n        && this.imageResyncOutstandingIds.has(image.id)\n      ) {\n        recoveredIds.add(image.id);\n      }\n    }\n    return [...recoveredIds].sort();\n  }\n\n  private sweepImageResyncForPresentedImages(\n    images: WebHostSurfaceImage[] | undefined\n  ): void {\n    const presentedIds = new Set<string>();\n    for (const image of images ?? []) {\n      if (this.imageResyncOutstandingIds.has(image.id)) {\n        presentedIds.add(image.id);\n      }\n    }\n    for (const id of this.imageResyncOutstandingIds) {\n      if (presentedIds.has(id)) {\n        continue;\n      }\n      this.imageResyncOutstandingIds.delete(id);\n      this.imageResyncPendingIds.delete(id);\n    }\n  }\n\n  private materializeDeltaFrame(\n    frame: WebHostSurfaceDeltaFrame\n  ): WebHostSurfaceFrame | undefined {\n    const baseline = this.lastSurfaceFrame;\n    if (!baseline) {\n      return undefined;\n    }\n\n    const rows = baseline.rows.slice();\n    for (const [row, cells] of frame.deltaRows) {\n      if (!Number.isSafeInteger(row) || row < 0 || row >= frame.height) {\n        return undefined;\n      }\n      rows[row] = cells;\n    }\n\n    return {\n      version: baseline.version,\n      epoch: frame.epoch,\n      gen: frame.gen,\n      sequence: frame.sequence,\n      width: frame.width,\n      height: frame.height,\n      styles: frame.styles,\n      rows,\n      images: frame.images,\n      damage: frame.damage,\n      accessibilityTree: frame.accessibilityTree,\n      accessibilityAnnouncements: frame.accessibilityAnnouncements,\n      scrollRegions: frame.scrollRegions,\n      links: frame.links,\n      linkTargets: frame.linkTargets,\n      focusPresentation: frame.focusPresentation,\n      preferredGridWidth: frame.preferredGridWidth,\n      preferredGridHeight: frame.preferredGridHeight,\n    };\n  }\n}\n\nfunction boundedImageResyncIds(\n  sortedIds: string[],\n  maximumEncodedBytes: number | undefined\n): {\n  ids: string[];\n  rejectedIds: string[];\n} {\n  if (\n    maximumEncodedBytes === undefined\n    || !Number.isFinite(maximumEncodedBytes)\n  ) {\n    return { ids: sortedIds, rejectedIds: [] };\n  }\n\n  const emptyRequestBytes = encodeResyncControlMessage({\n    scope: \"images\",\n    ids: [],\n  }).byteLength;\n  const normalizedMaximum = Math.max(0, Math.floor(maximumEncodedBytes));\n  const ids: string[] = [];\n  const rejectedIds: string[] = [];\n  let encodedBytes = emptyRequestBytes;\n  for (const id of sortedIds) {\n    const separatorBytes = ids.length === 0 ? 0 : 1;\n    const idBytes = textEncoder.encode(JSON.stringify(id)).byteLength;\n    if (encodedBytes + separatorBytes + idBytes > normalizedMaximum) {\n      if (ids.length === 0) {\n        rejectedIds.push(id);\n        continue;\n      }\n      break;\n    }\n    ids.push(id);\n    encodedBytes += separatorBytes + idBytes;\n    if (encodedBytes >= normalizedMaximum) {\n      break;\n    }\n  }\n  return { ids, rejectedIds };\n}\n\nfunction declaresNewerSurfaceVersion(\n  value: unknown\n): value is { version: number } {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const version = (value as { version?: unknown }).version;\n  return typeof version === \"number\"\n    && Number.isSafeInteger(version)\n    && version > SUPPORTED_SURFACE_VERSION;\n}\n\nfunction isWebHostClipboardRecord(\n  value: unknown\n): value is { text: string } {\n  return !!value && typeof value === \"object\" && typeof (value as { text?: unknown }).text === \"string\";\n}\n\nfunction isWebHostRuntimeIssue(\n  value: unknown\n): value is WebHostRuntimeIssue {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const record = value as Partial<WebHostRuntimeIssue>;\n  return (record.severity === \"warning\" || record.severity === \"error\")\n    && typeof record.code === \"string\"\n    && typeof record.message === \"string\"\n    && typeof record.description === \"string\"\n    && (record.identity === undefined || typeof record.identity === \"string\")\n    && (record.source === undefined || typeof record.source === \"string\");\n}\n\nfunction isWebHostFrameDiagnosticRecord(\n  value: unknown\n): value is WebHostFrameDiagnosticRecord {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const record = value as Partial<WebHostFrameDiagnosticRecord>;\n  return record.format === \"swift-tui-frame-diagnostics-v1\"\n    && Array.isArray(record.header)\n    && record.header.every((field) => typeof field === \"string\")\n    && Array.isArray(record.fields)\n    && record.fields.every((field) => typeof field === \"string\");\n}\n\nexport function encodeResizeControlMessage(\n  columns: number,\n  rows: number,\n  cellWidth?: number,\n  cellHeight?: number\n): Uint8Array {\n  const normalizedColumns = Math.max(1, Math.round(columns));\n  const normalizedRows = Math.max(1, Math.round(rows));\n  if (cellWidth && cellHeight) {\n    return textEncoder.encode(\n      `${recordPrefix}resize:${normalizedColumns}:${normalizedRows}:${Math.max(1, Math.round(cellWidth))}:${Math.max(1, Math.round(cellHeight))}\\n`\n    );\n  }\n\n  return textEncoder.encode(`${recordPrefix}resize:${normalizedColumns}:${normalizedRows}\\n`);\n}\n\nexport function encodeRenderStyleControlMessage(\n  style: WebHostTerminalStyle\n): Uint8Array {\n  const encoded = encodeWebHostTerminalRenderStyleBase64(style);\n  return textEncoder.encode(`${recordPrefix}style:${encoded}\\n`);\n}\n\nexport function encodeCapabilitiesControlMessage(): Uint8Array {\n  // The client's wire-capability declaration, sent once after the socket\n  // opens. The declaration is truthful today: this decoder materializes v3\n  // delta frames (`materializeDeltaFrame`). Byte shape and key order are\n  // pinned by the cross-repo fixture Fixtures/Transport/web-caps-record.txt\n  // — swift-tui's input parser consumes the identical bytes, and the\n  // coordination root's transport_fixture_sync gate keeps the copies in\n  // lockstep. Servers that predate the record drop it silently, so the\n  // session degrades to today's full-frame defaults.\n  //\n  // Capabilities are named feature bits. The retired `maxWebSurfaceVersion`\n  // key declared a decoder version ceiling, which was only ever read as\n  // \"accepts delta or not\" and duplicated — more weakly — the version check\n  // this decoder already performs on every record (SUPPORTED_SURFACE_VERSION).\n  // Servers still expecting it skip unknown keys, so dropping it is safe in\n  // both directions.\n  return textEncoder.encode(\n    `${recordPrefix}caps:{\"acceptsDeltaFrames\":true}\\n`\n  );\n}\n\nexport function encodeResyncControlMessage(\n  request: WebHostResyncRequest\n): Uint8Array {\n  const payload = request.scope === \"keyframe\"\n    ? { scope: \"keyframe\" }\n    : {\n        scope: \"images\",\n        ...(request.ids === undefined ? {} : { ids: request.ids }),\n      };\n  return textEncoder.encode(\n    `${recordPrefix}resync:${JSON.stringify(payload)}\\n`\n  );\n}\n\nexport function encodeKeyInputMessage(\n  input: WebHostKeyInput\n): Uint8Array {\n  const modifiers = Math.max(0, Math.round(input.modifiers ?? 0));\n  if (input.key === \"character\") {\n    return textEncoder.encode(\n      `${recordPrefix}key:character:${encodeURIComponent(input.character ?? \"\")}:${modifiers}\\n`\n    );\n  }\n  return textEncoder.encode(`${recordPrefix}key:${input.key}:${modifiers}\\n`);\n}\n\nexport function encodePasteInputMessage(\n  text: string\n): Uint8Array {\n  return textEncoder.encode(`${recordPrefix}paste:${encodeURIComponent(text)}\\n`);\n}\n\nexport function encodeMouseInputMessage(\n  input: WebHostMouseInput\n): Uint8Array {\n  return textEncoder.encode(\n    recordPrefix + [\n      \"mouse\",\n      input.kind,\n      formatCellCoordinate(input.x),\n      formatCellCoordinate(input.y),\n      input.button ?? \"none\",\n      Math.round(input.deltaX ?? 0),\n      Math.round(input.deltaY ?? 0),\n      Math.max(0, Math.round(input.modifiers ?? 0)),\n    ].join(\":\") + \"\\n\"\n  );\n}\n\nfunction formatCellCoordinate(\n  value: number\n): string {\n  return Number.isFinite(value) ? String(value) : \"0\";\n}\n\nfunction isWebHostSurfaceFrame(\n  value: unknown\n): value is WebHostSurfaceFrame {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const frame = value as Partial<WebHostSurfaceFrame>;\n  return (frame.version === 1 || frame.version === 2)\n    && (\n      frame.sequence === undefined\n        || (Number.isSafeInteger(frame.sequence) && frame.sequence >= 0)\n    )\n    && typeof frame.width === \"number\"\n    && typeof frame.height === \"number\"\n    && Array.isArray(frame.styles)\n    && Array.isArray(frame.rows)\n    && frame.rows.every(isWebHostSurfaceRow)\n    && (frame.images === undefined || isWebHostSurfaceImages(frame.images))\n    && (frame.damage === undefined || isWebHostSurfaceDamage(frame.damage))\n    && (\n      frame.accessibilityTree === undefined\n        || isWebHostAccessibilityNodes(frame.accessibilityTree)\n    )\n    && (\n      frame.accessibilityAnnouncements === undefined\n        || isWebHostAccessibilityAnnouncements(frame.accessibilityAnnouncements)\n    )\n    && (frame.scrollRegions === undefined || isWebHostScrollRegions(frame.scrollRegions))\n    && hasValidAdditiveFrameFields(frame);\n}\n\nfunction isWebHostSurfaceDeltaFrame(\n  value: unknown\n): value is WebHostSurfaceDeltaFrame {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const frame = value as Partial<WebHostSurfaceDeltaFrame>;\n  return frame.version === 3\n    && frame.encoding === \"delta\"\n    && (\n      frame.sequence === undefined\n        || (Number.isSafeInteger(frame.sequence) && frame.sequence >= 0)\n    )\n    && typeof frame.width === \"number\"\n    && typeof frame.height === \"number\"\n    && Array.isArray(frame.styles)\n    && Array.isArray(frame.deltaRows)\n    && frame.deltaRows.every(isWebHostSurfaceDeltaRow)\n    && isOptionalSafeInteger(frame.baselineGen)\n    && (frame.images === undefined || isWebHostSurfaceImages(frame.images))\n    && (frame.damage === undefined || isWebHostSurfaceDamage(frame.damage))\n    && (\n      frame.accessibilityTree === undefined\n        || isWebHostAccessibilityNodes(frame.accessibilityTree)\n    )\n    && (\n      frame.accessibilityAnnouncements === undefined\n        || isWebHostAccessibilityAnnouncements(frame.accessibilityAnnouncements)\n    )\n    && (frame.scrollRegions === undefined || isWebHostScrollRegions(frame.scrollRegions))\n    && hasValidAdditiveFrameFields(frame);\n}\n\n/**\n * The F19 additive fields shared by the full and delta record shapes. Absent\n * means \"feature not present\" — servers older than the field omit it.\n */\nfunction hasValidAdditiveFrameFields(\n  frame: Partial<WebHostSurfaceFrame> | Partial<WebHostSurfaceDeltaFrame>\n): boolean {\n  return isOptionalSafeInteger(frame.epoch)\n    && isOptionalSafeInteger(frame.gen)\n    && (frame.links === undefined || isWebHostSurfaceLinks(frame.links))\n    && (frame.linkTargets === undefined || isWebHostSurfaceLinkTargets(frame.linkTargets))\n    && (\n      frame.focusPresentation === undefined\n        || isWebHostFocusPresentation(frame.focusPresentation)\n    )\n    && (\n      frame.preferredGridWidth === undefined\n        || (Number.isSafeInteger(frame.preferredGridWidth) && frame.preferredGridWidth >= 0)\n    )\n    && (\n      frame.preferredGridHeight === undefined\n        || (Number.isSafeInteger(frame.preferredGridHeight) && frame.preferredGridHeight >= 0)\n    );\n}\n\nfunction isOptionalSafeInteger(\n  value: unknown\n): boolean {\n  return value === undefined || Number.isSafeInteger(value);\n}\n\nfunction isWebHostSurfaceLinks(\n  value: unknown\n): value is WebHostSurfaceLinkRow[] {\n  return Array.isArray(value) && value.every(isWebHostSurfaceLinkRow);\n}\n\nfunction isWebHostSurfaceLinkRow(\n  value: unknown\n): value is WebHostSurfaceLinkRow {\n  return Array.isArray(value)\n    && value.length === 2\n    && Number.isSafeInteger(value[0])\n    && value[0] >= 0\n    && Array.isArray(value[1])\n    && value[1].every(isWebHostSurfaceLinkRun);\n}\n\nfunction isWebHostSurfaceLinkRun(\n  value: unknown\n): value is WebHostSurfaceLinkRun {\n  if (!Array.isArray(value) || value.length !== 3) {\n    return false;\n  }\n  const [x, span, targetIndex] = value as number[];\n  return Number.isSafeInteger(x)\n    && x >= 0\n    && Number.isSafeInteger(span)\n    && span >= 1\n    && Number.isSafeInteger(targetIndex)\n    && targetIndex >= 0;\n}\n\nfunction isWebHostSurfaceLinkTargets(\n  value: unknown\n): value is string[] {\n  return Array.isArray(value) && value.every((entry) => typeof entry === \"string\");\n}\n\nfunction isWebHostFocusPresentation(\n  value: unknown\n): value is WebHostFocusPresentation {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const presentation = value as Partial<WebHostFocusPresentation>;\n  return (\n    presentation.focusedIdentity === undefined\n      || typeof presentation.focusedIdentity === \"string\"\n  )\n    && typeof presentation.semantics === \"string\"\n    && typeof presentation.prefersTextInput === \"boolean\"\n    && typeof presentation.hasFocusedRegion === \"boolean\";\n}\n\nfunction isWebHostSurfaceDeltaRow(\n  value: unknown\n): value is WebHostSurfaceDeltaRow {\n  return Array.isArray(value)\n    && value.length === 2\n    && Number.isSafeInteger(value[0])\n    && value[0] >= 0\n    && isWebHostSurfaceRow(value[1]);\n}\n\nfunction isWebHostSurfaceRow(\n  value: unknown\n): value is WebHostSurfaceCell[] {\n  return Array.isArray(value) && value.every(isWebHostSurfaceCell);\n}\n\nfunction isWebHostSurfaceCell(\n  value: unknown\n): value is WebHostSurfaceCell {\n  return Array.isArray(value)\n    && value.length === 4\n    && Number.isSafeInteger(value[0])\n    && value[0] >= 0\n    && typeof value[1] === \"string\"\n    && Number.isSafeInteger(value[2])\n    && value[2] >= 1\n    && Number.isSafeInteger(value[3])\n    && value[3] >= 0;\n}\n\nfunction isWebHostAccessibilityNodes(\n  value: unknown\n): value is WebHostAccessibilityNode[] {\n  return Array.isArray(value) && value.every(isWebHostAccessibilityNode);\n}\n\nfunction isWebHostAccessibilityNode(\n  value: unknown\n): value is WebHostAccessibilityNode {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const node = value as Partial<WebHostAccessibilityNode>;\n  return typeof node.id === \"string\"\n    && (node.parentId === undefined || typeof node.parentId === \"string\")\n    && isWebHostSurfaceRect(node.rect)\n    && typeof node.role === \"string\"\n    && (node.label === undefined || typeof node.label === \"string\")\n    && (node.hint === undefined || typeof node.hint === \"string\")\n    && (node.hidden === undefined || typeof node.hidden === \"boolean\")\n    && (node.liveRegion === undefined || typeof node.liveRegion === \"string\")\n    && (node.cursorAnchor === undefined || isWebHostAccessibilityPoint(node.cursorAnchor))\n    && (node.isFocused === undefined || typeof node.isFocused === \"boolean\");\n}\n\nfunction isWebHostAccessibilityPoint(\n  value: unknown\n): value is WebHostAccessibilityPoint {\n  return Array.isArray(value)\n    && value.length === 2\n    && value.every((entry) => typeof entry === \"number\");\n}\n\nfunction isWebHostAccessibilityAnnouncements(\n  value: unknown\n): value is WebHostAccessibilityAnnouncement[] {\n  return Array.isArray(value) && value.every(isWebHostAccessibilityAnnouncement);\n}\n\nfunction isWebHostAccessibilityAnnouncement(\n  value: unknown\n): value is WebHostAccessibilityAnnouncement {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const announcement = value as Partial<WebHostAccessibilityAnnouncement>;\n  return typeof announcement.message === \"string\"\n    && typeof announcement.politeness === \"string\";\n}\n\nfunction isWebHostSurfaceImages(\n  value: unknown\n): value is WebHostSurfaceImage[] {\n  return Array.isArray(value) && value.every(isWebHostSurfaceImage);\n}\n\nfunction isWebHostSurfaceImage(\n  value: unknown\n): value is WebHostSurfaceImage {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const image = value as Partial<WebHostSurfaceImage>;\n  return typeof image.id === \"string\"\n    && isWebHostSurfaceImageFormat(image.format)\n    && isWebHostSurfaceRect(image.bounds)\n    && isWebHostSurfaceRect(image.visibleBounds)\n    && isWebHostSurfaceScalingMode(image.scalingMode)\n    && (image.pixelSize === undefined || isWebHostSurfaceSize(image.pixelSize))\n    && (image.dataBase64 === undefined || typeof image.dataBase64 === \"string\");\n}\n\nfunction isWebHostSurfaceDamage(\n  value: unknown\n): value is WebHostSurfaceDamage {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const damage = value as Partial<WebHostSurfaceDamage>;\n  return Array.isArray(damage.textRows)\n    && damage.textRows.every(isWebHostSurfaceDamageTextRow)\n    && typeof damage.requiresFullTextRepaint === \"boolean\"\n    && typeof damage.requiresFullGraphicsReplay === \"boolean\";\n}\n\nfunction isWebHostSurfaceDamageTextRow(\n  value: unknown\n): value is WebHostSurfaceDamageTextRow {\n  return Array.isArray(value)\n    && value.length === 2\n    && typeof value[0] === \"number\"\n    && Array.isArray(value[1])\n    && value[1].every(isWebHostSurfaceDamageRange);\n}\n\nfunction isWebHostSurfaceDamageRange(\n  value: unknown\n): value is WebHostSurfaceDamageRange {\n  return Array.isArray(value)\n    && value.length === 2\n    && typeof value[0] === \"number\"\n    && typeof value[1] === \"number\";\n}\n\nfunction isWebHostSurfaceImageFormat(\n  value: unknown\n): value is WebHostSurfaceImageFormat {\n  return typeof value === \"string\";\n}\n\nfunction isWebHostScrollRegions(\n  value: unknown\n): value is WebHostScrollRegion[] {\n  return Array.isArray(value) && value.every(isWebHostScrollRegion);\n}\n\nfunction isWebHostScrollRegion(\n  value: unknown\n): value is WebHostScrollRegion {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const region = value as Partial<WebHostScrollRegion>;\n  return typeof region.id === \"string\"\n    && isWebHostSurfaceRect(region.rect)\n    && isWebHostSurfaceSize(region.offset)\n    && isWebHostSurfaceSize(region.content);\n}\n\nfunction isWebHostSurfaceRect(\n  value: unknown\n): value is WebHostSurfaceRect {\n  return Array.isArray(value)\n    && value.length === 4\n    && value.every((entry) => typeof entry === \"number\");\n}\n\nfunction isWebHostSurfaceSize(\n  value: unknown\n): value is WebHostSurfaceSize {\n  return Array.isArray(value)\n    && value.length === 2\n    && value.every((entry) => typeof entry === \"number\");\n}\n\nfunction isWebHostSurfaceScalingMode(\n  value: unknown\n): value is WebHostSurfaceImage[\"scalingMode\"] {\n  return typeof value === \"string\";\n}\n"],"mappings":"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"}
+{"version":3,"file":"WebHostSurfaceTransport.js","names":[],"sources":["../../src/WebHostSurfaceTransport.ts"],"sourcesContent":["/**\n * Browser consumer for SwiftTUI's host wire. The normative cross-host\n * contract lives upstream:\n * https://github.com/SwiftTUI/swift-tui/blob/main/docs/HOST-WIRE-CONTRACT.md\n */\nimport {\n  encodeWebHostTerminalRenderStyleBase64,\n  type WebHostTerminalStyle,\n} from \"./WebHostTerminalStyle.ts\";\n\nexport interface WebHostSurfaceStyle {\n  fg?: string;\n  bg?: string;\n  em?: number;\n  underline?: WebHostSurfaceLineStyle;\n  strikethrough?: WebHostSurfaceLineStyle;\n  opacity?: number;\n}\n\nexport interface WebHostSurfaceLineStyle {\n  pattern: \"solid\" | \"dot\" | \"dash\" | \"dashDot\" | \"dashDotDot\" | \"double\" | \"curly\";\n  color?: string;\n}\n\nexport type WebHostSurfaceCell = [\n  x: number,\n  text: string,\n  span: number,\n  styleIndex: number,\n];\n\nexport type WebHostSurfaceRect = [\n  x: number,\n  y: number,\n  width: number,\n  height: number,\n];\n\nexport type WebHostSurfaceSize = [\n  width: number,\n  height: number,\n];\n\nexport type WebHostAccessibilityPoint = [\n  x: number,\n  y: number,\n];\n\nexport type WebHostAccessibilityLiveRegion = string;\n\nexport interface WebHostAccessibilityNode {\n  id: string;\n  parentId?: string;\n  rect: WebHostSurfaceRect;\n  role: string;\n  label?: string;\n  hint?: string;\n  /** omitted when false */\n  hidden?: boolean;\n  liveRegion?: WebHostAccessibilityLiveRegion;\n  cursorAnchor?: WebHostAccessibilityPoint;\n  isFocused?: boolean;\n}\n\n/**\n * One hyperlink run within a row: [x, spanWidth, linkTargetIndex]. The index\n * points into the frame's deduplicated `linkTargets` table.\n */\nexport type WebHostSurfaceLinkRun = [\n  x: number,\n  span: number,\n  targetIndex: number,\n];\n\n/** Hyperlink runs for one row: [rowIndex, runs]. */\nexport type WebHostSurfaceLinkRow = [\n  row: number,\n  runs: WebHostSurfaceLinkRun[],\n];\n\nexport type WebHostFocusSemantics = string;\n\n/**\n * The settled focus presentation for a committed frame — the same derivation\n * the Android host consumes (`prefersTextInput` gates its IME).\n */\nexport interface WebHostFocusPresentation {\n  focusedIdentity?: string;\n  semantics: WebHostFocusSemantics;\n  prefersTextInput: boolean;\n  hasFocusedRegion: boolean;\n}\n\nexport interface WebHostAccessibilityAnnouncement {\n  message: string;\n  politeness: WebHostAccessibilityLiveRegion;\n}\n\nexport type WebHostSurfaceImageFormat = string;\n\n/**\n * Reports locally unresolved image IDs to a recovery-capable host. The first\n * branch lets bounded hosts return the admitted subset; the explicit legacy\n * void branch preserves contextual typing for concise callbacks that return\n * incidental values such as `array.push(...)`.\n */\nexport type WebHostImagePayloadRequestHandler =\n  | ((ids: readonly string[]) => readonly string[])\n  | ((ids: readonly string[]) => void);\n\nexport interface WebHostSurfaceImage {\n  id: string;\n  format: WebHostSurfaceImageFormat;\n  bounds: WebHostSurfaceRect;\n  visibleBounds: WebHostSurfaceRect;\n  scalingMode: string;\n  pixelSize?: WebHostSurfaceSize;\n  dataBase64?: string;\n}\n\nexport type WebHostSurfaceDamageRange = [\n  start: number,\n  end: number,\n];\n\nexport type WebHostSurfaceDamageTextRow = [\n  row: number,\n  ranges: WebHostSurfaceDamageRange[],\n];\n\nexport interface WebHostSurfaceDamage {\n  textRows: WebHostSurfaceDamageTextRow[];\n  requiresFullTextRepaint: boolean;\n  requiresFullGraphicsReplay: boolean;\n}\n\n/**\n * Per-region scroll extent published with each frame so the host can implement\n * scroll-chaining: capture the wheel only while the region under the pointer can\n * still scroll in the wheel's direction, otherwise let it fall through to the\n * page. The host recomputes the per-direction headroom from `offset`/`content`/\n * the viewport `rect`, mirroring SwiftTUI's\n * `min(max(0, offset), max(0, content - viewport))` clamp.\n */\nexport interface WebHostScrollRegion {\n  /** identity path — same key space as accessibility node ids */\n  id: string;\n  /** viewport rect in cells: [x, y, width, height] */\n  rect: WebHostSurfaceRect;\n  /** current clamped scroll offset in cells: [x, y] */\n  offset: WebHostAccessibilityPoint;\n  /** total content size in cells: [width, height] */\n  content: WebHostSurfaceSize;\n}\n\nexport interface WebHostSurfaceFrame {\n  version: 1 | 2;\n  epoch?: number;\n  gen?: number;\n  sequence?: number;\n  width: number;\n  height: number;\n  styles: Array<WebHostSurfaceStyle | null>;\n  rows: WebHostSurfaceCell[][];\n  images?: WebHostSurfaceImage[];\n  damage?: WebHostSurfaceDamage;\n  accessibilityTree?: WebHostAccessibilityNode[];\n  accessibilityAnnouncements?: WebHostAccessibilityAnnouncement[];\n  scrollRegions?: WebHostScrollRegion[];\n  links?: WebHostSurfaceLinkRow[];\n  linkTargets?: string[];\n  focusPresentation?: WebHostFocusPresentation;\n  preferredGridWidth?: number;\n  preferredGridHeight?: number;\n}\n\nexport type WebHostSurfaceDeltaRow = [\n  row: number,\n  cells: WebHostSurfaceCell[],\n];\n\nexport interface WebHostSurfaceDeltaFrame {\n  version: 3;\n  encoding: \"delta\";\n  epoch?: number;\n  gen?: number;\n  baselineGen?: number;\n  sequence?: number;\n  width: number;\n  height: number;\n  /**\n   * With `stylesBase` present, only the styles this record *added*: index `i`\n   * of this array is table index `stylesBase + i`. Absent `stylesBase`, the\n   * complete accumulated table, as deployed decoders expect.\n   */\n  styles: Array<WebHostSurfaceStyle | null>;\n  /**\n   * Where `styles` splices onto the retained table. Present only when the\n   * client declared `styleAppend`, which is why it is negotiated rather than\n   * additive: reading `styles` as a whole table when this is present\n   * mis-indexes every style in the record.\n   */\n  stylesBase?: number;\n  deltaRows: WebHostSurfaceDeltaRow[];\n  images?: WebHostSurfaceImage[];\n  damage?: WebHostSurfaceDamage;\n  accessibilityTree?: WebHostAccessibilityNode[];\n  accessibilityAnnouncements?: WebHostAccessibilityAnnouncement[];\n  scrollRegions?: WebHostScrollRegion[];\n  links?: WebHostSurfaceLinkRow[];\n  linkTargets?: string[];\n  focusPresentation?: WebHostFocusPresentation;\n  preferredGridWidth?: number;\n  preferredGridHeight?: number;\n}\n\nexport interface WebHostRuntimeIssue {\n  severity: \"warning\" | \"error\";\n  code: string;\n  message: string;\n  description: string;\n  identity?: string;\n  source?: string;\n}\n\nexport interface WebHostFrameDiagnosticRecord {\n  format: \"swift-tui-frame-diagnostics-v1\";\n  header: string[];\n  fields: string[];\n}\n\nexport type WebHostOutputRecord =\n  | { type: \"surface\"; frame: WebHostSurfaceFrame }\n  | { type: \"clipboard\"; text: string }\n  | { type: \"runtimeIssue\"; issue: WebHostRuntimeIssue }\n  | { type: \"frameDiagnostic\"; diagnostic: WebHostFrameDiagnosticRecord }\n  | { type: \"surfaceDropped\"; reason: \"noBaseline\" | \"staleBaseline\" }\n  | { type: \"text\"; text: string };\n\nexport type WebHostResyncRequest =\n  | { scope: \"keyframe\" }\n  | { scope: \"images\"; ids?: string[] };\n\nexport interface WebHostOutputSink {\n  presentSurface(\n    frame: WebHostSurfaceFrame,\n    recoveredImagePayloadIds?: readonly string[]\n  ): void;\n  writeClipboard?(text: string): void | Promise<void>;\n  notifyRuntimeIssue?(issue: WebHostRuntimeIssue): void;\n  recordFrameDiagnostic?(diagnostic: WebHostFrameDiagnosticRecord): void;\n  writeOutput?(text: string): void;\n  writeError?(text: string): void;\n}\n\nexport interface WebHostKeyInput {\n  key:\n    | \"return\"\n    | \"space\"\n    | \"tab\"\n    | \"arrowLeft\"\n    | \"arrowRight\"\n    | \"arrowUp\"\n    | \"arrowDown\"\n    | \"backspace\"\n    | \"escape\"\n    | \"home\"\n    | \"end\"\n    | \"character\";\n  character?: string;\n  modifiers?: number;\n}\n\nexport interface WebHostMouseInput {\n  kind: \"down\" | \"up\" | \"moved\" | \"dragged\" | \"scrolled\";\n  x: number;\n  y: number;\n  button?: \"primary\" | \"middle\" | \"secondary\";\n  deltaX?: number;\n  deltaY?: number;\n  modifiers?: number;\n}\n\nconst recordPrefix = \"\\u001E\";\nconst textEncoder = new TextEncoder();\n\n/** Limits wire-derived recovery state and keeps every single-ID WASI request bounded. */\nexport const MAX_IMAGE_RECOVERY_ID_BYTES = 1_024;\nexport const MAX_OUTSTANDING_IMAGE_RECOVERY_IDS = 1_024;\n\nexport function isWebHostImageRecoveryId(\n  id: string\n): boolean {\n  return id.length > 0\n    && id.length <= MAX_IMAGE_RECOVERY_ID_BYTES\n    && textEncoder.encode(id).byteLength <= MAX_IMAGE_RECOVERY_ID_BYTES;\n}\n\n/**\n * The newest `surface` record version this runtime understands. Unknown\n * additive object keys are ignored by design (older runtimes render newer\n * frames), but a frame declaring a NEWER version than this is surfaced as an\n * error-severity runtime issue instead of silently degrading to a text\n * diagnostic — silent version skew is the failure mode this guards against\n * (F57).\n */\nexport const SUPPORTED_SURFACE_VERSION = 3;\n\nexport class WebHostOutputDecoder {\n  private readonly textDecoder = new TextDecoder();\n  private bufferedText = \"\";\n  private lastSurfaceFrame?: WebHostSurfaceFrame;\n  private lastEpoch?: number;\n  private lastGen?: number;\n  private lastPresentedEpoch?: number;\n  private keyframeResyncOutstanding = false;\n  private keyframeResyncPending = false;\n  private readonly imageResyncOutstandingIds = new Set<string>();\n  private readonly imageResyncPendingIds = new Set<string>();\n\n  feed(\n    chunk: Uint8Array\n  ): WebHostOutputRecord[] {\n    this.bufferedText += this.textDecoder.decode(chunk, { stream: true });\n    const records: WebHostOutputRecord[] = [];\n\n    while (true) {\n      const newlineIndex = this.bufferedText.indexOf(\"\\n\");\n      if (newlineIndex < 0) {\n        break;\n      }\n\n      const line = this.bufferedText.slice(0, newlineIndex);\n      this.bufferedText = this.bufferedText.slice(newlineIndex + 1);\n      records.push(this.decodeLine(line));\n    }\n\n    if (this.bufferedText.length > 4096 && !this.bufferedText.startsWith(recordPrefix)) {\n      records.push({ type: \"text\", text: this.bufferedText });\n      this.bufferedText = \"\";\n    }\n\n    return records;\n  }\n\n  flush(): WebHostOutputRecord[] {\n    if (!this.bufferedText) {\n      return [];\n    }\n    const text = this.bufferedText;\n    this.bufferedText = \"\";\n    return [this.decodeLine(text)];\n  }\n\n  takeResyncRequest(\n    maximumEncodedBytes?: number\n  ): WebHostResyncRequest | undefined {\n    if (this.keyframeResyncPending) {\n      this.keyframeResyncPending = false;\n      return { scope: \"keyframe\" };\n    }\n    if (this.imageResyncPendingIds.size === 0) {\n      return undefined;\n    }\n\n    const sortedIds = [...this.imageResyncPendingIds].sort();\n    const { ids, rejectedIds } = boundedImageResyncIds(\n      sortedIds,\n      maximumEncodedBytes\n    );\n    for (const id of rejectedIds) {\n      this.imageResyncPendingIds.delete(id);\n      this.imageResyncOutstandingIds.delete(id);\n    }\n    for (const id of ids) {\n      this.imageResyncPendingIds.delete(id);\n    }\n    if (ids.length === 0) {\n      return undefined;\n    }\n    return { scope: \"images\", ids };\n  }\n\n  /**\n   * Adds locally unresolved image IDs to this epoch's recovery set. IDs remain\n   * outstanding after delivery, so repeat painter misses cannot create storms;\n   * a payload-bearing record or epoch re-anchor releases them. Returns the IDs\n   * now tracked (new or already outstanding); callers should suppress repeats\n   * only for this admitted subset.\n   */\n  requestImagePayloads(\n    ids: Iterable<string>\n  ): readonly string[] {\n    const acceptedIds = new Set<string>();\n    for (const id of ids) {\n      if (!isWebHostImageRecoveryId(id)) {\n        continue;\n      }\n      if (this.imageResyncOutstandingIds.has(id)) {\n        acceptedIds.add(id);\n        continue;\n      }\n      if (\n        this.imageResyncOutstandingIds.size\n        >= MAX_OUTSTANDING_IMAGE_RECOVERY_IDS\n      ) {\n        continue;\n      }\n      this.imageResyncOutstandingIds.add(id);\n      this.imageResyncPendingIds.add(id);\n      acceptedIds.add(id);\n    }\n    return [...acceptedIds];\n  }\n\n  /**\n   * Advances image recovery immediately before one decoded surface reaches its\n   * presenter. Payload arrival and epoch reset therefore follow delivery order\n   * rather than `feed`'s parse-ahead order across a multi-record chunk. The\n   * return value identifies payloads that answer an outstanding image request,\n   * so presenters can open exactly one fresh local decode generation even when\n   * content-addressed retransmission uses identical bytes.\n   */\n  prepareToPresentSurface(\n    frame: WebHostSurfaceFrame\n  ): readonly string[] {\n    const recoveredImagePayloadIds = this.recoveredImagePayloadIds(frame.images);\n    this.resetImageResyncForEpoch(frame.epoch);\n    this.sweepImageResyncForPresentedImages(frame.images);\n    this.clearArrivedImagePayloads(frame.images);\n    if (frame.epoch !== undefined) {\n      this.lastPresentedEpoch = frame.epoch;\n    }\n    return recoveredImagePayloadIds;\n  }\n\n  resyncRequestDeliveryFailed(\n    request: WebHostResyncRequest\n  ): void {\n    if (request.scope === \"keyframe\") {\n      if (this.keyframeResyncOutstanding) {\n        this.keyframeResyncPending = true;\n      }\n      return;\n    }\n\n    for (const id of request.ids ?? []) {\n      if (this.imageResyncOutstandingIds.has(id)) {\n        this.imageResyncPendingIds.add(id);\n      }\n    }\n  }\n\n  private decodeLine(\n    line: string\n  ): WebHostOutputRecord {\n    if (line.startsWith(`${recordPrefix}clipboard:`)) {\n      try {\n        const record = JSON.parse(line.slice(`${recordPrefix}clipboard:`.length));\n        if (isWebHostClipboardRecord(record)) {\n          return { type: \"clipboard\", text: record.text };\n        }\n      } catch {\n        // Fall through to the text path below so malformed output remains visible.\n      }\n\n      return { type: \"text\", text: `${line}\\n` };\n    }\n\n    if (line.startsWith(`${recordPrefix}runtimeIssue:`)) {\n      try {\n        const record = JSON.parse(line.slice(`${recordPrefix}runtimeIssue:`.length));\n        if (isWebHostRuntimeIssue(record)) {\n          return { type: \"runtimeIssue\", issue: record };\n        }\n      } catch {\n        // Fall through to the text path below so malformed output remains visible.\n      }\n\n      return { type: \"text\", text: `${line}\\n` };\n    }\n\n    if (line.startsWith(`${recordPrefix}frameDiagnostic:`)) {\n      try {\n        const record = JSON.parse(line.slice(`${recordPrefix}frameDiagnostic:`.length));\n        if (isWebHostFrameDiagnosticRecord(record)) {\n          return { type: \"frameDiagnostic\", diagnostic: record };\n        }\n      } catch {\n        // Fall through to the text path below so malformed output remains visible.\n      }\n\n      return { type: \"text\", text: `${line}\\n` };\n    }\n\n    if (!line.startsWith(`${recordPrefix}surface:`)) {\n      return { type: \"text\", text: `${line}\\n` };\n    }\n\n    try {\n      const frame = JSON.parse(line.slice(`${recordPrefix}surface:`.length));\n      if (declaresNewerSurfaceVersion(frame)) {\n        return {\n          type: \"runtimeIssue\",\n          issue: {\n            severity: \"error\",\n            code: \"surface.unsupportedVersion\",\n            message: `SwiftTUI surface version ${frame.version} is newer than the supported ${SUPPORTED_SURFACE_VERSION}`,\n            description: \"The app emitted a surface record with version \"\n              + `${frame.version}, but this @swifttui/web runtime understands `\n              + `versions up to ${SUPPORTED_SURFACE_VERSION}. Update @swifttui/web `\n              + \"to render it.\",\n          },\n        };\n      }\n      if (isWebHostSurfaceFrame(frame)) {\n        this.lastSurfaceFrame = frame;\n        this.lastEpoch = frame.epoch;\n        this.lastGen = frame.gen;\n        this.keyframeResyncOutstanding = false;\n        this.keyframeResyncPending = false;\n        return { type: \"surface\", frame };\n      }\n      if (isWebHostSurfaceDeltaFrame(frame)) {\n        const carriesDeliveryStamps = frame.epoch !== undefined\n          || frame.gen !== undefined\n          || frame.baselineGen !== undefined;\n        if (\n          !this.lastSurfaceFrame\n          || this.lastSurfaceFrame.width !== frame.width\n          || this.lastSurfaceFrame.height !== frame.height\n        ) {\n          if (carriesDeliveryStamps) {\n            this.requestKeyframeResync();\n          }\n          return { type: \"surfaceDropped\", reason: \"noBaseline\" };\n        }\n        if (\n          carriesDeliveryStamps\n          && (\n            frame.epoch === undefined\n            || frame.gen === undefined\n            || frame.baselineGen === undefined\n            || frame.epoch !== this.lastEpoch\n            || frame.baselineGen !== this.lastGen\n          )\n        ) {\n          this.requestKeyframeResync();\n          return { type: \"surfaceDropped\", reason: \"staleBaseline\" };\n        }\n        const materialized = this.materializeDeltaFrame(frame);\n        if (materialized) {\n          this.lastSurfaceFrame = materialized;\n          this.lastEpoch = frame.epoch;\n          this.lastGen = frame.gen;\n          return { type: \"surface\", frame: materialized };\n        }\n      }\n    } catch {\n      // Fall through to the text path below so malformed output remains visible.\n    }\n\n    return { type: \"text\", text: `${line}\\n` };\n  }\n\n  private requestKeyframeResync(): void {\n    if (this.keyframeResyncOutstanding) {\n      return;\n    }\n    this.keyframeResyncOutstanding = true;\n    this.keyframeResyncPending = true;\n  }\n\n  private resetImageResyncForEpoch(\n    epoch: number | undefined\n  ): void {\n    if (epoch === undefined || epoch === this.lastPresentedEpoch) {\n      return;\n    }\n    this.imageResyncOutstandingIds.clear();\n    this.imageResyncPendingIds.clear();\n  }\n\n  private clearArrivedImagePayloads(\n    images: WebHostSurfaceImage[] | undefined\n  ): void {\n    for (const image of images ?? []) {\n      if (image.dataBase64 === undefined) {\n        continue;\n      }\n      this.imageResyncOutstandingIds.delete(image.id);\n      this.imageResyncPendingIds.delete(image.id);\n    }\n  }\n\n  private recoveredImagePayloadIds(\n    images: WebHostSurfaceImage[] | undefined\n  ): string[] {\n    const recoveredIds = new Set<string>();\n    for (const image of images ?? []) {\n      if (\n        image.dataBase64 !== undefined\n        && this.imageResyncOutstandingIds.has(image.id)\n      ) {\n        recoveredIds.add(image.id);\n      }\n    }\n    return [...recoveredIds].sort();\n  }\n\n  private sweepImageResyncForPresentedImages(\n    images: WebHostSurfaceImage[] | undefined\n  ): void {\n    const presentedIds = new Set<string>();\n    for (const image of images ?? []) {\n      if (this.imageResyncOutstandingIds.has(image.id)) {\n        presentedIds.add(image.id);\n      }\n    }\n    for (const id of this.imageResyncOutstandingIds) {\n      if (presentedIds.has(id)) {\n        continue;\n      }\n      this.imageResyncOutstandingIds.delete(id);\n      this.imageResyncPendingIds.delete(id);\n    }\n  }\n\n  private materializeDeltaFrame(\n    frame: WebHostSurfaceDeltaFrame\n  ): WebHostSurfaceFrame | undefined {\n    const baseline = this.lastSurfaceFrame;\n    if (!baseline) {\n      return undefined;\n    }\n\n    const styles = this.materializeDeltaStyles(frame, baseline);\n    if (!styles) {\n      return undefined;\n    }\n\n    const rows = baseline.rows.slice();\n    for (const [row, cells] of frame.deltaRows) {\n      if (!Number.isSafeInteger(row) || row < 0 || row >= frame.height) {\n        return undefined;\n      }\n      rows[row] = cells;\n    }\n\n    return {\n      version: baseline.version,\n      epoch: frame.epoch,\n      gen: frame.gen,\n      sequence: frame.sequence,\n      width: frame.width,\n      height: frame.height,\n      styles,\n      rows,\n      images: frame.images,\n      damage: frame.damage,\n      accessibilityTree: frame.accessibilityTree,\n      accessibilityAnnouncements: frame.accessibilityAnnouncements,\n      scrollRegions: frame.scrollRegions,\n      links: frame.links,\n      linkTargets: frame.linkTargets,\n      focusPresentation: frame.focusPresentation,\n      preferredGridWidth: frame.preferredGridWidth,\n      preferredGridHeight: frame.preferredGridHeight,\n    };\n  }\n\n  /**\n   * The delta's style table: either the record's own complete table, or the\n   * negotiated append spliced onto the baseline's.\n   *\n   * A `stylesBase` that does not name the end of the retained table is a\n   * structural break, not a recoverable one — splicing at the wrong offset\n   * silently repaints cells in the wrong style, which is worse than refusing\n   * the record and asking for a keyframe.\n   */\n  private materializeDeltaStyles(\n    frame: WebHostSurfaceDeltaFrame,\n    baseline: WebHostSurfaceFrame\n  ): Array<WebHostSurfaceStyle | null> | undefined {\n    if (frame.stylesBase === undefined) {\n      return frame.styles;\n    }\n    if (frame.stylesBase !== baseline.styles.length) {\n      return undefined;\n    }\n    return baseline.styles.concat(frame.styles);\n  }\n}\n\nfunction boundedImageResyncIds(\n  sortedIds: string[],\n  maximumEncodedBytes: number | undefined\n): {\n  ids: string[];\n  rejectedIds: string[];\n} {\n  if (\n    maximumEncodedBytes === undefined\n    || !Number.isFinite(maximumEncodedBytes)\n  ) {\n    return { ids: sortedIds, rejectedIds: [] };\n  }\n\n  const emptyRequestBytes = encodeResyncControlMessage({\n    scope: \"images\",\n    ids: [],\n  }).byteLength;\n  const normalizedMaximum = Math.max(0, Math.floor(maximumEncodedBytes));\n  const ids: string[] = [];\n  const rejectedIds: string[] = [];\n  let encodedBytes = emptyRequestBytes;\n  for (const id of sortedIds) {\n    const separatorBytes = ids.length === 0 ? 0 : 1;\n    const idBytes = textEncoder.encode(JSON.stringify(id)).byteLength;\n    if (encodedBytes + separatorBytes + idBytes > normalizedMaximum) {\n      if (ids.length === 0) {\n        rejectedIds.push(id);\n        continue;\n      }\n      break;\n    }\n    ids.push(id);\n    encodedBytes += separatorBytes + idBytes;\n    if (encodedBytes >= normalizedMaximum) {\n      break;\n    }\n  }\n  return { ids, rejectedIds };\n}\n\nfunction declaresNewerSurfaceVersion(\n  value: unknown\n): value is { version: number } {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const version = (value as { version?: unknown }).version;\n  return typeof version === \"number\"\n    && Number.isSafeInteger(version)\n    && version > SUPPORTED_SURFACE_VERSION;\n}\n\nfunction isWebHostClipboardRecord(\n  value: unknown\n): value is { text: string } {\n  return !!value && typeof value === \"object\" && typeof (value as { text?: unknown }).text === \"string\";\n}\n\nfunction isWebHostRuntimeIssue(\n  value: unknown\n): value is WebHostRuntimeIssue {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const record = value as Partial<WebHostRuntimeIssue>;\n  return (record.severity === \"warning\" || record.severity === \"error\")\n    && typeof record.code === \"string\"\n    && typeof record.message === \"string\"\n    && typeof record.description === \"string\"\n    && (record.identity === undefined || typeof record.identity === \"string\")\n    && (record.source === undefined || typeof record.source === \"string\");\n}\n\nfunction isWebHostFrameDiagnosticRecord(\n  value: unknown\n): value is WebHostFrameDiagnosticRecord {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const record = value as Partial<WebHostFrameDiagnosticRecord>;\n  return record.format === \"swift-tui-frame-diagnostics-v1\"\n    && Array.isArray(record.header)\n    && record.header.every((field) => typeof field === \"string\")\n    && Array.isArray(record.fields)\n    && record.fields.every((field) => typeof field === \"string\");\n}\n\nexport function encodeResizeControlMessage(\n  columns: number,\n  rows: number,\n  cellWidth?: number,\n  cellHeight?: number\n): Uint8Array {\n  const normalizedColumns = Math.max(1, Math.round(columns));\n  const normalizedRows = Math.max(1, Math.round(rows));\n  if (cellWidth && cellHeight) {\n    return textEncoder.encode(\n      `${recordPrefix}resize:${normalizedColumns}:${normalizedRows}:${Math.max(1, Math.round(cellWidth))}:${Math.max(1, Math.round(cellHeight))}\\n`\n    );\n  }\n\n  return textEncoder.encode(`${recordPrefix}resize:${normalizedColumns}:${normalizedRows}\\n`);\n}\n\nexport function encodeRenderStyleControlMessage(\n  style: WebHostTerminalStyle\n): Uint8Array {\n  const encoded = encodeWebHostTerminalRenderStyleBase64(style);\n  return textEncoder.encode(`${recordPrefix}style:${encoded}\\n`);\n}\n\nexport function encodeCapabilitiesControlMessage(): Uint8Array {\n  // The client's wire-capability declaration, sent once after the socket\n  // opens. The declaration is truthful today: this decoder materializes v3\n  // delta frames (`materializeDeltaFrame`). Byte shape and key order are\n  // pinned by the cross-repo fixture Fixtures/Transport/web-caps-record.txt\n  // — swift-tui's input parser consumes the identical bytes, and the\n  // coordination root's transport_fixture_sync gate keeps the copies in\n  // lockstep. Servers that predate the record drop it silently, so the\n  // session degrades to today's full-frame defaults.\n  //\n  // Capabilities are named feature bits. The retired `maxWebSurfaceVersion`\n  // key declared a decoder version ceiling, which was only ever read as\n  // \"accepts delta or not\" and duplicated — more weakly — the version check\n  // this decoder already performs on every record (SUPPORTED_SURFACE_VERSION).\n  // Servers still expecting it skip unknown keys, so dropping it is safe in\n  // both directions.\n  //\n  // `styleAppend` is declared here because `materializeDeltaStyles` splices a\n  // delta's `styles` onto the retained table when `stylesBase` is present.\n  // Declaring it is truthful by construction: this decoder and this record are\n  // the same release. Measured at Stage SV, the full retransmit it replaces was\n  // 69.7% of late-record bytes in a style-churning epoch.\n  return textEncoder.encode(\n    `${recordPrefix}caps:{\"acceptsDeltaFrames\":true,\"styleAppend\":true}\\n`\n  );\n}\n\nexport function encodeResyncControlMessage(\n  request: WebHostResyncRequest\n): Uint8Array {\n  const payload = request.scope === \"keyframe\"\n    ? { scope: \"keyframe\" }\n    : {\n        scope: \"images\",\n        ...(request.ids === undefined ? {} : { ids: request.ids }),\n      };\n  return textEncoder.encode(\n    `${recordPrefix}resync:${JSON.stringify(payload)}\\n`\n  );\n}\n\nexport function encodeKeyInputMessage(\n  input: WebHostKeyInput\n): Uint8Array {\n  const modifiers = Math.max(0, Math.round(input.modifiers ?? 0));\n  if (input.key === \"character\") {\n    return textEncoder.encode(\n      `${recordPrefix}key:character:${encodeURIComponent(input.character ?? \"\")}:${modifiers}\\n`\n    );\n  }\n  return textEncoder.encode(`${recordPrefix}key:${input.key}:${modifiers}\\n`);\n}\n\nexport function encodePasteInputMessage(\n  text: string\n): Uint8Array {\n  return textEncoder.encode(`${recordPrefix}paste:${encodeURIComponent(text)}\\n`);\n}\n\nexport function encodeMouseInputMessage(\n  input: WebHostMouseInput\n): Uint8Array {\n  return textEncoder.encode(\n    recordPrefix + [\n      \"mouse\",\n      input.kind,\n      formatCellCoordinate(input.x),\n      formatCellCoordinate(input.y),\n      input.button ?? \"none\",\n      Math.round(input.deltaX ?? 0),\n      Math.round(input.deltaY ?? 0),\n      Math.max(0, Math.round(input.modifiers ?? 0)),\n    ].join(\":\") + \"\\n\"\n  );\n}\n\nfunction formatCellCoordinate(\n  value: number\n): string {\n  return Number.isFinite(value) ? String(value) : \"0\";\n}\n\nfunction isWebHostSurfaceFrame(\n  value: unknown\n): value is WebHostSurfaceFrame {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const frame = value as Partial<WebHostSurfaceFrame>;\n  return (frame.version === 1 || frame.version === 2)\n    && (\n      frame.sequence === undefined\n        || (Number.isSafeInteger(frame.sequence) && frame.sequence >= 0)\n    )\n    && typeof frame.width === \"number\"\n    && typeof frame.height === \"number\"\n    && Array.isArray(frame.styles)\n    && Array.isArray(frame.rows)\n    && frame.rows.every(isWebHostSurfaceRow)\n    && (frame.images === undefined || isWebHostSurfaceImages(frame.images))\n    && (frame.damage === undefined || isWebHostSurfaceDamage(frame.damage))\n    && (\n      frame.accessibilityTree === undefined\n        || isWebHostAccessibilityNodes(frame.accessibilityTree)\n    )\n    && (\n      frame.accessibilityAnnouncements === undefined\n        || isWebHostAccessibilityAnnouncements(frame.accessibilityAnnouncements)\n    )\n    && (frame.scrollRegions === undefined || isWebHostScrollRegions(frame.scrollRegions))\n    && hasValidAdditiveFrameFields(frame);\n}\n\nfunction isWebHostSurfaceDeltaFrame(\n  value: unknown\n): value is WebHostSurfaceDeltaFrame {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const frame = value as Partial<WebHostSurfaceDeltaFrame>;\n  return frame.version === 3\n    && frame.encoding === \"delta\"\n    && (\n      frame.sequence === undefined\n        || (Number.isSafeInteger(frame.sequence) && frame.sequence >= 0)\n    )\n    && typeof frame.width === \"number\"\n    && typeof frame.height === \"number\"\n    && Array.isArray(frame.styles)\n    && Array.isArray(frame.deltaRows)\n    && frame.deltaRows.every(isWebHostSurfaceDeltaRow)\n    && isOptionalSafeInteger(frame.baselineGen)\n    && isOptionalSafeInteger(frame.stylesBase)\n    && (frame.images === undefined || isWebHostSurfaceImages(frame.images))\n    && (frame.damage === undefined || isWebHostSurfaceDamage(frame.damage))\n    && (\n      frame.accessibilityTree === undefined\n        || isWebHostAccessibilityNodes(frame.accessibilityTree)\n    )\n    && (\n      frame.accessibilityAnnouncements === undefined\n        || isWebHostAccessibilityAnnouncements(frame.accessibilityAnnouncements)\n    )\n    && (frame.scrollRegions === undefined || isWebHostScrollRegions(frame.scrollRegions))\n    && hasValidAdditiveFrameFields(frame);\n}\n\n/**\n * The F19 additive fields shared by the full and delta record shapes. Absent\n * means \"feature not present\" — servers older than the field omit it.\n */\nfunction hasValidAdditiveFrameFields(\n  frame: Partial<WebHostSurfaceFrame> | Partial<WebHostSurfaceDeltaFrame>\n): boolean {\n  return isOptionalSafeInteger(frame.epoch)\n    && isOptionalSafeInteger(frame.gen)\n    && (frame.links === undefined || isWebHostSurfaceLinks(frame.links))\n    && (frame.linkTargets === undefined || isWebHostSurfaceLinkTargets(frame.linkTargets))\n    && (\n      frame.focusPresentation === undefined\n        || isWebHostFocusPresentation(frame.focusPresentation)\n    )\n    && (\n      frame.preferredGridWidth === undefined\n        || (Number.isSafeInteger(frame.preferredGridWidth) && frame.preferredGridWidth >= 0)\n    )\n    && (\n      frame.preferredGridHeight === undefined\n        || (Number.isSafeInteger(frame.preferredGridHeight) && frame.preferredGridHeight >= 0)\n    );\n}\n\nfunction isOptionalSafeInteger(\n  value: unknown\n): boolean {\n  return value === undefined || Number.isSafeInteger(value);\n}\n\nfunction isWebHostSurfaceLinks(\n  value: unknown\n): value is WebHostSurfaceLinkRow[] {\n  return Array.isArray(value) && value.every(isWebHostSurfaceLinkRow);\n}\n\nfunction isWebHostSurfaceLinkRow(\n  value: unknown\n): value is WebHostSurfaceLinkRow {\n  return Array.isArray(value)\n    && value.length === 2\n    && Number.isSafeInteger(value[0])\n    && value[0] >= 0\n    && Array.isArray(value[1])\n    && value[1].every(isWebHostSurfaceLinkRun);\n}\n\nfunction isWebHostSurfaceLinkRun(\n  value: unknown\n): value is WebHostSurfaceLinkRun {\n  if (!Array.isArray(value) || value.length !== 3) {\n    return false;\n  }\n  const [x, span, targetIndex] = value as number[];\n  return Number.isSafeInteger(x)\n    && x >= 0\n    && Number.isSafeInteger(span)\n    && span >= 1\n    && Number.isSafeInteger(targetIndex)\n    && targetIndex >= 0;\n}\n\nfunction isWebHostSurfaceLinkTargets(\n  value: unknown\n): value is string[] {\n  return Array.isArray(value) && value.every((entry) => typeof entry === \"string\");\n}\n\nfunction isWebHostFocusPresentation(\n  value: unknown\n): value is WebHostFocusPresentation {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const presentation = value as Partial<WebHostFocusPresentation>;\n  return (\n    presentation.focusedIdentity === undefined\n      || typeof presentation.focusedIdentity === \"string\"\n  )\n    && typeof presentation.semantics === \"string\"\n    && typeof presentation.prefersTextInput === \"boolean\"\n    && typeof presentation.hasFocusedRegion === \"boolean\";\n}\n\nfunction isWebHostSurfaceDeltaRow(\n  value: unknown\n): value is WebHostSurfaceDeltaRow {\n  return Array.isArray(value)\n    && value.length === 2\n    && Number.isSafeInteger(value[0])\n    && value[0] >= 0\n    && isWebHostSurfaceRow(value[1]);\n}\n\nfunction isWebHostSurfaceRow(\n  value: unknown\n): value is WebHostSurfaceCell[] {\n  return Array.isArray(value) && value.every(isWebHostSurfaceCell);\n}\n\nfunction isWebHostSurfaceCell(\n  value: unknown\n): value is WebHostSurfaceCell {\n  return Array.isArray(value)\n    && value.length === 4\n    && Number.isSafeInteger(value[0])\n    && value[0] >= 0\n    && typeof value[1] === \"string\"\n    && Number.isSafeInteger(value[2])\n    && value[2] >= 1\n    && Number.isSafeInteger(value[3])\n    && value[3] >= 0;\n}\n\nfunction isWebHostAccessibilityNodes(\n  value: unknown\n): value is WebHostAccessibilityNode[] {\n  return Array.isArray(value) && value.every(isWebHostAccessibilityNode);\n}\n\nfunction isWebHostAccessibilityNode(\n  value: unknown\n): value is WebHostAccessibilityNode {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const node = value as Partial<WebHostAccessibilityNode>;\n  return typeof node.id === \"string\"\n    && (node.parentId === undefined || typeof node.parentId === \"string\")\n    && isWebHostSurfaceRect(node.rect)\n    && typeof node.role === \"string\"\n    && (node.label === undefined || typeof node.label === \"string\")\n    && (node.hint === undefined || typeof node.hint === \"string\")\n    && (node.hidden === undefined || typeof node.hidden === \"boolean\")\n    && (node.liveRegion === undefined || typeof node.liveRegion === \"string\")\n    && (node.cursorAnchor === undefined || isWebHostAccessibilityPoint(node.cursorAnchor))\n    && (node.isFocused === undefined || typeof node.isFocused === \"boolean\");\n}\n\nfunction isWebHostAccessibilityPoint(\n  value: unknown\n): value is WebHostAccessibilityPoint {\n  return Array.isArray(value)\n    && value.length === 2\n    && value.every((entry) => typeof entry === \"number\");\n}\n\nfunction isWebHostAccessibilityAnnouncements(\n  value: unknown\n): value is WebHostAccessibilityAnnouncement[] {\n  return Array.isArray(value) && value.every(isWebHostAccessibilityAnnouncement);\n}\n\nfunction isWebHostAccessibilityAnnouncement(\n  value: unknown\n): value is WebHostAccessibilityAnnouncement {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const announcement = value as Partial<WebHostAccessibilityAnnouncement>;\n  return typeof announcement.message === \"string\"\n    && typeof announcement.politeness === \"string\";\n}\n\nfunction isWebHostSurfaceImages(\n  value: unknown\n): value is WebHostSurfaceImage[] {\n  return Array.isArray(value) && value.every(isWebHostSurfaceImage);\n}\n\nfunction isWebHostSurfaceImage(\n  value: unknown\n): value is WebHostSurfaceImage {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const image = value as Partial<WebHostSurfaceImage>;\n  return typeof image.id === \"string\"\n    && isWebHostSurfaceImageFormat(image.format)\n    && isWebHostSurfaceRect(image.bounds)\n    && isWebHostSurfaceRect(image.visibleBounds)\n    && isWebHostSurfaceScalingMode(image.scalingMode)\n    && (image.pixelSize === undefined || isWebHostSurfaceSize(image.pixelSize))\n    && (image.dataBase64 === undefined || typeof image.dataBase64 === \"string\");\n}\n\nfunction isWebHostSurfaceDamage(\n  value: unknown\n): value is WebHostSurfaceDamage {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const damage = value as Partial<WebHostSurfaceDamage>;\n  return Array.isArray(damage.textRows)\n    && damage.textRows.every(isWebHostSurfaceDamageTextRow)\n    && typeof damage.requiresFullTextRepaint === \"boolean\"\n    && typeof damage.requiresFullGraphicsReplay === \"boolean\";\n}\n\nfunction isWebHostSurfaceDamageTextRow(\n  value: unknown\n): value is WebHostSurfaceDamageTextRow {\n  return Array.isArray(value)\n    && value.length === 2\n    && typeof value[0] === \"number\"\n    && Array.isArray(value[1])\n    && value[1].every(isWebHostSurfaceDamageRange);\n}\n\nfunction isWebHostSurfaceDamageRange(\n  value: unknown\n): value is WebHostSurfaceDamageRange {\n  return Array.isArray(value)\n    && value.length === 2\n    && typeof value[0] === \"number\"\n    && typeof value[1] === \"number\";\n}\n\nfunction isWebHostSurfaceImageFormat(\n  value: unknown\n): value is WebHostSurfaceImageFormat {\n  return typeof value === \"string\";\n}\n\nfunction isWebHostScrollRegions(\n  value: unknown\n): value is WebHostScrollRegion[] {\n  return Array.isArray(value) && value.every(isWebHostScrollRegion);\n}\n\nfunction isWebHostScrollRegion(\n  value: unknown\n): value is WebHostScrollRegion {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  const region = value as Partial<WebHostScrollRegion>;\n  return typeof region.id === \"string\"\n    && isWebHostSurfaceRect(region.rect)\n    && isWebHostSurfaceSize(region.offset)\n    && isWebHostSurfaceSize(region.content);\n}\n\nfunction isWebHostSurfaceRect(\n  value: unknown\n): value is WebHostSurfaceRect {\n  return Array.isArray(value)\n    && value.length === 4\n    && value.every((entry) => typeof entry === \"number\");\n}\n\nfunction isWebHostSurfaceSize(\n  value: unknown\n): value is WebHostSurfaceSize {\n  return Array.isArray(value)\n    && value.length === 2\n    && value.every((entry) => typeof entry === \"number\");\n}\n\nfunction isWebHostSurfaceScalingMode(\n  value: unknown\n): value is WebHostSurfaceImage[\"scalingMode\"] {\n  return typeof value === \"string\";\n}\n"],"mappings":"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"}

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

@@ -5,6 +5,29 @@ interface SharedInputQueueBuffers {
   readonly dataBuffer: SharedArrayBuffer;
 }
 type SharedInputReadiness = "readable" | "closed" | "timedOut";
+/**
+ * The outcome of one logical `writeAsync`.
+ *
+ * `partial` carries how many bytes reached the ring before the deadline. It is
+ * distinct from `timedOut`-with-nothing-written because a caller reporting a
+ * dropped paste wants to say whether the app saw part of it.
+ */
+type SharedInputWriteOutcome = {
+  readonly status: "written";
+} | {
+  readonly status: "closed";
+  readonly bytesWritten: number;
+} | {
+  readonly status: "partial";
+  readonly bytesWritten: number;
+  readonly bytesRemaining: number;
+};
+interface SharedInputWriteOptions {
+  /** Total budget for the whole logical write. Defaults to 500 ms. */
+  readonly deadlineMilliseconds?: number;
+  /** Injectable clock, so deadline behavior is testable without wall time. */
+  readonly now?: () => number;
+}
 interface SharedInputQueueState {
   readonly control: Int32Array;
   readonly data: Uint8Array;
@@ -13,10 +36,45 @@ declare function createSharedInputQueue(capacity?: number): SharedInputQueueBuff
 declare function hydrateSharedInputQueue(buffers: SharedInputQueueBuffers): SharedInputQueueState;
 declare class SharedInputQueueWriter {
   private readonly queue;
+  /**
+   * Serializes `writeAsync` calls. A chunked write suspends while the reader
+   * drains, so two concurrent logical writes would otherwise interleave their
+   * segments in the ring and corrupt both records.
+   */
+  private writeChain;
+  /**
+   * How many logical writes are queued or in flight. A write must join the
+   * chain whenever one is already pending, or a small later chunk could
+   * overtake an earlier chunked one and land out of order.
+   */
+  private pendingWrites;
   constructor(buffers: SharedInputQueueBuffers);
+  /**
+   * Streams one logical write into the ring, in as many segments as the reader's
+   * drain rate requires.
+   *
+   * A single `write` can only ever enqueue what currently fits, so a paste
+   * larger than the free space failed outright and the whole clipboard was lost.
+   * Here the write takes `min(free, remaining)` bytes at a time and awaits
+   * capacity in between, so a paste larger than the ring streams through it
+   * while the worker drains. No record shape changes: the bytes arrive in
+   * order, so a bracketed paste is still one paste.
+   *
+   * Never blocks: this runs on the main thread, where `Atomics.wait` is
+   * forbidden, so it awaits the reader's notification instead. Each wait is
+   * capped at 50 ms (or whatever is left of the deadline) so a missed
+   * notification costs one bounded recheck rather than a hang, and the whole
+   * write is bounded by a 500 ms deadline.
+   */
+  writeAsync(chunk: Uint8Array | string, options?: SharedInputWriteOptions): Promise<SharedInputWriteOutcome>;
+  private performChunkedWrite;
+  private writeSegment;
   write(chunk: Uint8Array | string): void;
   availableCapacity(): number;
-  waitForCapacity(minimumBytes: number): Promise<boolean>;
+  waitForCapacity(minimumBytes: number, options?: {
+    readonly timeoutMilliseconds?: number;
+    readonly singleWait?: boolean;
+  }): Promise<boolean>;
   close(): void;
 }
 declare class SharedInputQueueReader {
@@ -29,5 +87,5 @@ declare class SharedInputQueueReader {
   isClosed(): boolean;
 }
 //#endregion
-export { SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, createSharedInputQueue, hydrateSharedInputQueue, sharedInputQueueDefaultCapacity };
+export { SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, SharedInputWriteOptions, SharedInputWriteOutcome, createSharedInputQueue, hydrateSharedInputQueue, sharedInputQueueDefaultCapacity };
 //# sourceMappingURL=SharedInputQueue.d.ts.map

package/dist/src/wasi/SharedInputQueue.js

@@ -1,6 +1,7 @@
 //#region src/wasi/SharedInputQueue.ts
 const controlSlots = 3;
 const capacityWaitTimeoutMilliseconds = 50;
+const writeDeadlineMilliseconds = 500;
 const sharedInputQueueDefaultCapacity = 64 * 1024;
 function createSharedInputQueue(capacity = sharedInputQueueDefaultCapacity) {
 	if (typeof SharedArrayBuffer === "undefined") throw new Error("SharedArrayBuffer is unavailable. Serve the app with COOP/COEP headers so browser WASI stdin can stay live.");
@@ -18,9 +19,92 @@ function hydrateSharedInputQueue(buffers) {
 }
 var SharedInputQueueWriter = class {
 	queue;
+	/**
+	* Serializes `writeAsync` calls. A chunked write suspends while the reader
+	* drains, so two concurrent logical writes would otherwise interleave their
+	* segments in the ring and corrupt both records.
+	*/
+	writeChain = Promise.resolve();
+	/**
+	* How many logical writes are queued or in flight. A write must join the
+	* chain whenever one is already pending, or a small later chunk could
+	* overtake an earlier chunked one and land out of order.
+	*/
+	pendingWrites = 0;
 	constructor(buffers) {
 		this.queue = hydrateSharedInputQueue(buffers);
 	}
+	/**
+	* Streams one logical write into the ring, in as many segments as the reader's
+	* drain rate requires.
+	*
+	* A single `write` can only ever enqueue what currently fits, so a paste
+	* larger than the free space failed outright and the whole clipboard was lost.
+	* Here the write takes `min(free, remaining)` bytes at a time and awaits
+	* capacity in between, so a paste larger than the ring streams through it
+	* while the worker drains. No record shape changes: the bytes arrive in
+	* order, so a bracketed paste is still one paste.
+	*
+	* Never blocks: this runs on the main thread, where `Atomics.wait` is
+	* forbidden, so it awaits the reader's notification instead. Each wait is
+	* capped at 50 ms (or whatever is left of the deadline) so a missed
+	* notification costs one bounded recheck rather than a hang, and the whole
+	* write is bounded by a 500 ms deadline.
+	*/
+	writeAsync(chunk, options = {}) {
+		const bytes = normalizeChunk(chunk);
+		if (bytes.length == 0) return Promise.resolve({ status: "written" });
+		if (Atomics.load(this.queue.control, 2) !== 0) return Promise.resolve({
+			status: "closed",
+			bytesWritten: 0
+		});
+		if (this.pendingWrites === 0 && bytes.length <= this.availableCapacity()) {
+			this.writeSegment(bytes);
+			return Promise.resolve({ status: "written" });
+		}
+		this.pendingWrites += 1;
+		const attempt = this.writeChain.then(() => this.performChunkedWrite(bytes, options), () => this.performChunkedWrite(bytes, options));
+		this.writeChain = attempt;
+		return attempt.finally(() => {
+			this.pendingWrites -= 1;
+		});
+	}
+	async performChunkedWrite(bytes, options) {
+		const now = options.now ?? (() => Date.now());
+		const deadline = now() + Math.max(0, options.deadlineMilliseconds ?? writeDeadlineMilliseconds);
+		let written = 0;
+		while (written < bytes.length) {
+			if (Atomics.load(this.queue.control, 2) !== 0) return {
+				status: "closed",
+				bytesWritten: written
+			};
+			const free = this.availableCapacity();
+			if (free > 0) {
+				const segment = Math.min(free, bytes.length - written);
+				this.writeSegment(bytes.subarray(written, written + segment));
+				written += segment;
+				continue;
+			}
+			const remainingBudget = deadline - now();
+			if (remainingBudget <= 0) return {
+				status: "partial",
+				bytesWritten: written,
+				bytesRemaining: bytes.length - written
+			};
+			await this.waitForCapacity(1, {
+				timeoutMilliseconds: Math.min(capacityWaitTimeoutMilliseconds, remainingBudget),
+				singleWait: true
+			});
+		}
+		return { status: "written" };
+	}
+	writeSegment(segment) {
+		const length = this.queue.data.length;
+		const writeIndex = Atomics.load(this.queue.control, 1);
+		writeToRingBuffer(this.queue.data, segment, writeIndex);
+		Atomics.store(this.queue.control, 1, ringAdvance(writeIndex, segment.length, length));
+		Atomics.notify(this.queue.control, 1);
+	}
 	write(chunk) {
 		if (Atomics.load(this.queue.control, 2) !== 0) return;
 		const bytes = normalizeChunk(chunk);
@@ -38,19 +122,21 @@ var SharedInputQueueWriter = class {
 		const length = this.queue.data.length;
 		return length - ringUsed(Atomics.load(this.queue.control, 0), Atomics.load(this.queue.control, 1), length);
 	}
-	async waitForCapacity(minimumBytes) {
+	async waitForCapacity(minimumBytes, options = {}) {
 		const required = Math.max(0, Math.ceil(minimumBytes));
 		if (required > this.queue.data.length) return false;
+		const timeout = options.timeoutMilliseconds ?? capacityWaitTimeoutMilliseconds;
 		while (true) {
 			const readIndex = Atomics.load(this.queue.control, 0);
 			if (Atomics.load(this.queue.control, 2) !== 0) return false;
 			if (this.availableCapacity() >= required) return true;
 			if (typeof Atomics.waitAsync === "function") {
-				const waiting = Atomics.waitAsync(this.queue.control, 0, readIndex, capacityWaitTimeoutMilliseconds);
+				const waiting = Atomics.waitAsync(this.queue.control, 0, readIndex, timeout);
 				if (waiting.async) await waiting.value;
 			} else await new Promise((resolve) => {
 				setTimeout(resolve, 1);
 			});
+			if (options.singleWait) return this.availableCapacity() >= required;
 		}
 	}
 	close() {

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

@@ -1 +1 @@
-{"version":3,"file":"SharedInputQueue.js","names":[],"sources":["../../../src/wasi/SharedInputQueue.ts"],"sourcesContent":["const controlSlots = 3;\nconst capacityWaitTimeoutMilliseconds = 50;\n\nconst enum ControlSlot {\n  readIndex = 0,\n  writeIndex = 1,\n  closed = 2,\n}\n\nexport const sharedInputQueueDefaultCapacity = 64 * 1024;\n\nexport interface SharedInputQueueBuffers {\n  readonly controlBuffer: SharedArrayBuffer;\n  readonly dataBuffer: SharedArrayBuffer;\n}\n\nexport type SharedInputReadiness = \"readable\" | \"closed\" | \"timedOut\";\n\ninterface SharedInputQueueState {\n  readonly control: Int32Array;\n  readonly data: Uint8Array;\n}\n\nexport function createSharedInputQueue(\n  capacity: number = sharedInputQueueDefaultCapacity\n): SharedInputQueueBuffers {\n  if (typeof SharedArrayBuffer === \"undefined\") {\n    throw new Error(\n      \"SharedArrayBuffer is unavailable. Serve the app with COOP/COEP headers so browser WASI stdin can stay live.\"\n    );\n  }\n\n  if (!Number.isInteger(capacity) || capacity <= 0) {\n    throw new Error(`Shared input queue capacity must be a positive integer, received ${capacity}.`);\n  }\n\n  return {\n    controlBuffer: new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT * controlSlots),\n    dataBuffer: new SharedArrayBuffer(capacity),\n  };\n}\n\nexport function hydrateSharedInputQueue(\n  buffers: SharedInputQueueBuffers\n): SharedInputQueueState {\n  return {\n    control: new Int32Array(buffers.controlBuffer),\n    data: new Uint8Array(buffers.dataBuffer),\n  };\n}\n\nexport class SharedInputQueueWriter {\n  private readonly queue: SharedInputQueueState;\n\n  constructor(buffers: SharedInputQueueBuffers) {\n    this.queue = hydrateSharedInputQueue(buffers);\n  }\n\n  write(chunk: Uint8Array | string): void {\n    if (Atomics.load(this.queue.control, ControlSlot.closed) !== 0) {\n      return;\n    }\n\n    const bytes = normalizeChunk(chunk);\n    if (bytes.length == 0) {\n      return;\n    }\n\n    const length = this.queue.data.length;\n    const readIndex = Atomics.load(this.queue.control, ControlSlot.readIndex);\n    const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n    const usedCapacity = ringUsed(readIndex, writeIndex, length);\n    const availableCapacity = length - usedCapacity;\n\n    if (bytes.length > availableCapacity) {\n      throw new Error(\n        `Shared input queue overflow: cannot enqueue ${bytes.length} byte(s) into ${availableCapacity} byte(s) of free space.`\n      );\n    }\n\n    writeToRingBuffer(this.queue.data, bytes, writeIndex);\n    Atomics.store(\n      this.queue.control,\n      ControlSlot.writeIndex,\n      ringAdvance(writeIndex, bytes.length, length)\n    );\n    Atomics.notify(this.queue.control, ControlSlot.writeIndex);\n  }\n\n  availableCapacity(): number {\n    const length = this.queue.data.length;\n    const readIndex = Atomics.load(this.queue.control, ControlSlot.readIndex);\n    const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n    return length - ringUsed(readIndex, writeIndex, length);\n  }\n\n  async waitForCapacity(\n    minimumBytes: number\n  ): Promise<boolean> {\n    const required = Math.max(0, Math.ceil(minimumBytes));\n    if (required > this.queue.data.length) {\n      return false;\n    }\n\n    while (true) {\n      const readIndex = Atomics.load(this.queue.control, ControlSlot.readIndex);\n      if (Atomics.load(this.queue.control, ControlSlot.closed) !== 0) {\n        return false;\n      }\n      if (this.availableCapacity() >= required) {\n        return true;\n      }\n\n      if (typeof Atomics.waitAsync === \"function\") {\n        const waiting = Atomics.waitAsync(\n          this.queue.control,\n          ControlSlot.readIndex,\n          readIndex,\n          capacityWaitTimeoutMilliseconds\n        );\n        if (waiting.async) {\n          await waiting.value;\n        }\n      } else {\n        await new Promise<void>((resolve) => {\n          setTimeout(resolve, 1);\n        });\n      }\n    }\n  }\n\n  close(): void {\n    Atomics.store(this.queue.control, ControlSlot.closed, 1);\n    Atomics.notify(this.queue.control, ControlSlot.writeIndex);\n    Atomics.notify(this.queue.control, ControlSlot.readIndex);\n  }\n}\n\nexport class SharedInputQueueReader {\n  private readonly queue: SharedInputQueueState;\n\n  constructor(buffers: SharedInputQueueBuffers) {\n    this.queue = hydrateSharedInputQueue(buffers);\n  }\n\n  read(maxBytes: number): Uint8Array | undefined {\n    while (true) {\n      const next = this.readAvailable(maxBytes);\n      if (next) {\n        return next;\n      }\n\n      if (this.isClosed()) {\n        return undefined;\n      }\n\n      const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n      Atomics.wait(this.queue.control, ControlSlot.writeIndex, writeIndex);\n    }\n  }\n\n  readAvailable(maxBytes: number): Uint8Array | undefined {\n    if (!Number.isInteger(maxBytes) || maxBytes <= 0) {\n      return new Uint8Array();\n    }\n\n    const length = this.queue.data.length;\n    const readIndex = Atomics.load(this.queue.control, ControlSlot.readIndex);\n    const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n    const availableBytes = ringUsed(readIndex, writeIndex, length);\n\n    if (availableBytes <= 0) {\n      return undefined;\n    }\n\n    const byteCount = Math.min(maxBytes, availableBytes);\n    const chunk = readFromRingBuffer(this.queue.data, readIndex, byteCount);\n    Atomics.store(\n      this.queue.control,\n      ControlSlot.readIndex,\n      ringAdvance(readIndex, byteCount, length)\n    );\n    Atomics.notify(this.queue.control, ControlSlot.readIndex);\n    return chunk;\n  }\n\n  availableBytes(): number {\n    const readIndex = Atomics.load(this.queue.control, ControlSlot.readIndex);\n    const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n    return ringUsed(readIndex, writeIndex, this.queue.data.length);\n  }\n\n  waitForReadable(\n    timeoutMilliseconds?: number\n  ): SharedInputReadiness {\n    while (true) {\n      if (this.availableBytes() > 0) {\n        return \"readable\";\n      }\n      if (this.isClosed()) {\n        return \"closed\";\n      }\n\n      const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n      const result = Atomics.wait(\n        this.queue.control,\n        ControlSlot.writeIndex,\n        writeIndex,\n        timeoutMilliseconds\n      );\n      if (result === \"timed-out\") {\n        return \"timedOut\";\n      }\n    }\n  }\n\n  isClosed(): boolean {\n    return Atomics.load(this.queue.control, ControlSlot.closed) !== 0;\n  }\n}\n\nfunction normalizeChunk(\n  chunk: Uint8Array | string\n): Uint8Array {\n  return typeof chunk == \"string\" ? new TextEncoder().encode(chunk) : new Uint8Array(chunk);\n}\n\n// The read/write cursors are kept in the half-open range [0, 2 * length) — the\n// classic \"two indices mod 2N\" ring buffer. Bounding both cursors keeps them\n// from growing without limit and overflowing Int32 across long sessions, while\n// still distinguishing a full queue (used == length) from an empty one\n// (used == 0). The data-buffer offset for either cursor is cursor % length.\nfunction ringUsed(\n  readIndex: number,\n  writeIndex: number,\n  length: number\n): number {\n  const span = 2 * length;\n  return ((writeIndex - readIndex) % span + span) % span;\n}\n\nfunction ringAdvance(\n  index: number,\n  delta: number,\n  length: number\n): number {\n  return (index + delta) % (2 * length);\n}\n\nfunction writeToRingBuffer(\n  buffer: Uint8Array,\n  chunk: Uint8Array,\n  startIndex: number\n): void {\n  const offset = startIndex % buffer.length;\n  const firstSegmentLength = Math.min(chunk.length, buffer.length - offset);\n  buffer.set(chunk.subarray(0, firstSegmentLength), offset);\n  if (firstSegmentLength < chunk.length) {\n    buffer.set(chunk.subarray(firstSegmentLength), 0);\n  }\n}\n\nfunction readFromRingBuffer(\n  buffer: Uint8Array,\n  startIndex: number,\n  byteCount: number\n): Uint8Array {\n  const chunk = new Uint8Array(byteCount);\n  const offset = startIndex % buffer.length;\n  const firstSegmentLength = Math.min(byteCount, buffer.length - offset);\n  chunk.set(buffer.subarray(offset, offset + firstSegmentLength), 0);\n  if (firstSegmentLength < byteCount) {\n    chunk.set(buffer.subarray(0, byteCount - firstSegmentLength), firstSegmentLength);\n  }\n  return chunk;\n}\n"],"mappings":"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"}
+{"version":3,"file":"SharedInputQueue.js","names":[],"sources":["../../../src/wasi/SharedInputQueue.ts"],"sourcesContent":["const controlSlots = 3;\nconst capacityWaitTimeoutMilliseconds = 50;\nconst writeDeadlineMilliseconds = 500;\n\nconst enum ControlSlot {\n  readIndex = 0,\n  writeIndex = 1,\n  closed = 2,\n}\n\nexport const sharedInputQueueDefaultCapacity = 64 * 1024;\n\nexport interface SharedInputQueueBuffers {\n  readonly controlBuffer: SharedArrayBuffer;\n  readonly dataBuffer: SharedArrayBuffer;\n}\n\nexport type SharedInputReadiness = \"readable\" | \"closed\" | \"timedOut\";\n\n/**\n * The outcome of one logical `writeAsync`.\n *\n * `partial` carries how many bytes reached the ring before the deadline. It is\n * distinct from `timedOut`-with-nothing-written because a caller reporting a\n * dropped paste wants to say whether the app saw part of it.\n */\nexport type SharedInputWriteOutcome =\n  | { readonly status: \"written\" }\n  | { readonly status: \"closed\"; readonly bytesWritten: number }\n  | { readonly status: \"partial\"; readonly bytesWritten: number; readonly bytesRemaining: number };\n\nexport interface SharedInputWriteOptions {\n  /** Total budget for the whole logical write. Defaults to 500 ms. */\n  readonly deadlineMilliseconds?: number;\n  /** Injectable clock, so deadline behavior is testable without wall time. */\n  readonly now?: () => number;\n}\n\ninterface SharedInputQueueState {\n  readonly control: Int32Array;\n  readonly data: Uint8Array;\n}\n\nexport function createSharedInputQueue(\n  capacity: number = sharedInputQueueDefaultCapacity\n): SharedInputQueueBuffers {\n  if (typeof SharedArrayBuffer === \"undefined\") {\n    throw new Error(\n      \"SharedArrayBuffer is unavailable. Serve the app with COOP/COEP headers so browser WASI stdin can stay live.\"\n    );\n  }\n\n  if (!Number.isInteger(capacity) || capacity <= 0) {\n    throw new Error(`Shared input queue capacity must be a positive integer, received ${capacity}.`);\n  }\n\n  return {\n    controlBuffer: new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT * controlSlots),\n    dataBuffer: new SharedArrayBuffer(capacity),\n  };\n}\n\nexport function hydrateSharedInputQueue(\n  buffers: SharedInputQueueBuffers\n): SharedInputQueueState {\n  return {\n    control: new Int32Array(buffers.controlBuffer),\n    data: new Uint8Array(buffers.dataBuffer),\n  };\n}\n\nexport class SharedInputQueueWriter {\n  private readonly queue: SharedInputQueueState;\n  /**\n   * Serializes `writeAsync` calls. A chunked write suspends while the reader\n   * drains, so two concurrent logical writes would otherwise interleave their\n   * segments in the ring and corrupt both records.\n   */\n  private writeChain: Promise<unknown> = Promise.resolve();\n  /**\n   * How many logical writes are queued or in flight. A write must join the\n   * chain whenever one is already pending, or a small later chunk could\n   * overtake an earlier chunked one and land out of order.\n   */\n  private pendingWrites = 0;\n\n  constructor(buffers: SharedInputQueueBuffers) {\n    this.queue = hydrateSharedInputQueue(buffers);\n  }\n\n  /**\n   * Streams one logical write into the ring, in as many segments as the reader's\n   * drain rate requires.\n   *\n   * A single `write` can only ever enqueue what currently fits, so a paste\n   * larger than the free space failed outright and the whole clipboard was lost.\n   * Here the write takes `min(free, remaining)` bytes at a time and awaits\n   * capacity in between, so a paste larger than the ring streams through it\n   * while the worker drains. No record shape changes: the bytes arrive in\n   * order, so a bracketed paste is still one paste.\n   *\n   * Never blocks: this runs on the main thread, where `Atomics.wait` is\n   * forbidden, so it awaits the reader's notification instead. Each wait is\n   * capped at 50 ms (or whatever is left of the deadline) so a missed\n   * notification costs one bounded recheck rather than a hang, and the whole\n   * write is bounded by a 500 ms deadline.\n   */\n  writeAsync(\n    chunk: Uint8Array | string,\n    options: SharedInputWriteOptions = {}\n  ): Promise<SharedInputWriteOutcome> {\n    const bytes = normalizeChunk(chunk);\n    if (bytes.length == 0) {\n      return Promise.resolve({ status: \"written\" });\n    }\n    if (Atomics.load(this.queue.control, ControlSlot.closed) !== 0) {\n      return Promise.resolve({ status: \"closed\", bytesWritten: 0 });\n    }\n\n    // Fast path: with nothing queued ahead of it and room for the whole chunk,\n    // the write lands synchronously. That keeps an ordinary keystroke exactly as\n    // immediate as it was before chunking existed — only a write that cannot fit\n    // pays for suspension.\n    if (this.pendingWrites === 0 && bytes.length <= this.availableCapacity()) {\n      this.writeSegment(bytes);\n      return Promise.resolve({ status: \"written\" });\n    }\n\n    this.pendingWrites += 1;\n    const attempt = this.writeChain.then(\n      () => this.performChunkedWrite(bytes, options),\n      () => this.performChunkedWrite(bytes, options)\n    );\n    this.writeChain = attempt;\n    return attempt.finally(() => {\n      this.pendingWrites -= 1;\n    });\n  }\n\n  private async performChunkedWrite(\n    bytes: Uint8Array,\n    options: SharedInputWriteOptions\n  ): Promise<SharedInputWriteOutcome> {\n    const now = options.now ?? (() => Date.now());\n    const deadline = now()\n      + Math.max(0, options.deadlineMilliseconds ?? writeDeadlineMilliseconds);\n    let written = 0;\n\n    while (written < bytes.length) {\n      if (Atomics.load(this.queue.control, ControlSlot.closed) !== 0) {\n        return { status: \"closed\", bytesWritten: written };\n      }\n\n      const free = this.availableCapacity();\n      if (free > 0) {\n        const segment = Math.min(free, bytes.length - written);\n        this.writeSegment(bytes.subarray(written, written + segment));\n        written += segment;\n        continue;\n      }\n\n      const remainingBudget = deadline - now();\n      if (remainingBudget <= 0) {\n        return {\n          status: \"partial\",\n          bytesWritten: written,\n          bytesRemaining: bytes.length - written,\n        };\n      }\n      // `singleWait` keeps the deadline in this loop: without it the helper\n      // would spin internally until capacity arrived, ignoring the budget.\n      await this.waitForCapacity(1, {\n        timeoutMilliseconds: Math.min(capacityWaitTimeoutMilliseconds, remainingBudget),\n        singleWait: true,\n      });\n    }\n\n    return { status: \"written\" };\n  }\n\n  private writeSegment(\n    segment: Uint8Array\n  ): void {\n    const length = this.queue.data.length;\n    const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n    writeToRingBuffer(this.queue.data, segment, writeIndex);\n    Atomics.store(\n      this.queue.control,\n      ControlSlot.writeIndex,\n      ringAdvance(writeIndex, segment.length, length)\n    );\n    Atomics.notify(this.queue.control, ControlSlot.writeIndex);\n  }\n\n  write(chunk: Uint8Array | string): void {\n    if (Atomics.load(this.queue.control, ControlSlot.closed) !== 0) {\n      return;\n    }\n\n    const bytes = normalizeChunk(chunk);\n    if (bytes.length == 0) {\n      return;\n    }\n\n    const length = this.queue.data.length;\n    const readIndex = Atomics.load(this.queue.control, ControlSlot.readIndex);\n    const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n    const usedCapacity = ringUsed(readIndex, writeIndex, length);\n    const availableCapacity = length - usedCapacity;\n\n    if (bytes.length > availableCapacity) {\n      throw new Error(\n        `Shared input queue overflow: cannot enqueue ${bytes.length} byte(s) into ${availableCapacity} byte(s) of free space.`\n      );\n    }\n\n    writeToRingBuffer(this.queue.data, bytes, writeIndex);\n    Atomics.store(\n      this.queue.control,\n      ControlSlot.writeIndex,\n      ringAdvance(writeIndex, bytes.length, length)\n    );\n    Atomics.notify(this.queue.control, ControlSlot.writeIndex);\n  }\n\n  availableCapacity(): number {\n    const length = this.queue.data.length;\n    const readIndex = Atomics.load(this.queue.control, ControlSlot.readIndex);\n    const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n    return length - ringUsed(readIndex, writeIndex, length);\n  }\n\n  async waitForCapacity(\n    minimumBytes: number,\n    options: { readonly timeoutMilliseconds?: number; readonly singleWait?: boolean } = {}\n  ): Promise<boolean> {\n    const required = Math.max(0, Math.ceil(minimumBytes));\n    if (required > this.queue.data.length) {\n      return false;\n    }\n    const timeout = options.timeoutMilliseconds ?? capacityWaitTimeoutMilliseconds;\n\n    while (true) {\n      const readIndex = Atomics.load(this.queue.control, ControlSlot.readIndex);\n      if (Atomics.load(this.queue.control, ControlSlot.closed) !== 0) {\n        return false;\n      }\n      if (this.availableCapacity() >= required) {\n        return true;\n      }\n\n      if (typeof Atomics.waitAsync === \"function\") {\n        const waiting = Atomics.waitAsync(\n          this.queue.control,\n          ControlSlot.readIndex,\n          readIndex,\n          timeout\n        );\n        if (waiting.async) {\n          await waiting.value;\n        }\n      } else {\n        await new Promise<void>((resolve) => {\n          setTimeout(resolve, 1);\n        });\n      }\n\n      // One bounded recheck and return, for callers that own the retry loop\n      // themselves: a missed notification then costs a single capped wait\n      // rather than spinning inside here.\n      if (options.singleWait) {\n        return this.availableCapacity() >= required;\n      }\n    }\n  }\n\n  close(): void {\n    Atomics.store(this.queue.control, ControlSlot.closed, 1);\n    Atomics.notify(this.queue.control, ControlSlot.writeIndex);\n    Atomics.notify(this.queue.control, ControlSlot.readIndex);\n  }\n}\n\nexport class SharedInputQueueReader {\n  private readonly queue: SharedInputQueueState;\n\n  constructor(buffers: SharedInputQueueBuffers) {\n    this.queue = hydrateSharedInputQueue(buffers);\n  }\n\n  read(maxBytes: number): Uint8Array | undefined {\n    while (true) {\n      const next = this.readAvailable(maxBytes);\n      if (next) {\n        return next;\n      }\n\n      if (this.isClosed()) {\n        return undefined;\n      }\n\n      const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n      Atomics.wait(this.queue.control, ControlSlot.writeIndex, writeIndex);\n    }\n  }\n\n  readAvailable(maxBytes: number): Uint8Array | undefined {\n    if (!Number.isInteger(maxBytes) || maxBytes <= 0) {\n      return new Uint8Array();\n    }\n\n    const length = this.queue.data.length;\n    const readIndex = Atomics.load(this.queue.control, ControlSlot.readIndex);\n    const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n    const availableBytes = ringUsed(readIndex, writeIndex, length);\n\n    if (availableBytes <= 0) {\n      return undefined;\n    }\n\n    const byteCount = Math.min(maxBytes, availableBytes);\n    const chunk = readFromRingBuffer(this.queue.data, readIndex, byteCount);\n    Atomics.store(\n      this.queue.control,\n      ControlSlot.readIndex,\n      ringAdvance(readIndex, byteCount, length)\n    );\n    Atomics.notify(this.queue.control, ControlSlot.readIndex);\n    return chunk;\n  }\n\n  availableBytes(): number {\n    const readIndex = Atomics.load(this.queue.control, ControlSlot.readIndex);\n    const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n    return ringUsed(readIndex, writeIndex, this.queue.data.length);\n  }\n\n  waitForReadable(\n    timeoutMilliseconds?: number\n  ): SharedInputReadiness {\n    while (true) {\n      if (this.availableBytes() > 0) {\n        return \"readable\";\n      }\n      if (this.isClosed()) {\n        return \"closed\";\n      }\n\n      const writeIndex = Atomics.load(this.queue.control, ControlSlot.writeIndex);\n      const result = Atomics.wait(\n        this.queue.control,\n        ControlSlot.writeIndex,\n        writeIndex,\n        timeoutMilliseconds\n      );\n      if (result === \"timed-out\") {\n        return \"timedOut\";\n      }\n    }\n  }\n\n  isClosed(): boolean {\n    return Atomics.load(this.queue.control, ControlSlot.closed) !== 0;\n  }\n}\n\nfunction normalizeChunk(\n  chunk: Uint8Array | string\n): Uint8Array {\n  return typeof chunk == \"string\" ? new TextEncoder().encode(chunk) : new Uint8Array(chunk);\n}\n\n// The read/write cursors are kept in the half-open range [0, 2 * length) — the\n// classic \"two indices mod 2N\" ring buffer. Bounding both cursors keeps them\n// from growing without limit and overflowing Int32 across long sessions, while\n// still distinguishing a full queue (used == length) from an empty one\n// (used == 0). The data-buffer offset for either cursor is cursor % length.\nfunction ringUsed(\n  readIndex: number,\n  writeIndex: number,\n  length: number\n): number {\n  const span = 2 * length;\n  return ((writeIndex - readIndex) % span + span) % span;\n}\n\nfunction ringAdvance(\n  index: number,\n  delta: number,\n  length: number\n): number {\n  return (index + delta) % (2 * length);\n}\n\nfunction writeToRingBuffer(\n  buffer: Uint8Array,\n  chunk: Uint8Array,\n  startIndex: number\n): void {\n  const offset = startIndex % buffer.length;\n  const firstSegmentLength = Math.min(chunk.length, buffer.length - offset);\n  buffer.set(chunk.subarray(0, firstSegmentLength), offset);\n  if (firstSegmentLength < chunk.length) {\n    buffer.set(chunk.subarray(firstSegmentLength), 0);\n  }\n}\n\nfunction readFromRingBuffer(\n  buffer: Uint8Array,\n  startIndex: number,\n  byteCount: number\n): Uint8Array {\n  const chunk = new Uint8Array(byteCount);\n  const offset = startIndex % buffer.length;\n  const firstSegmentLength = Math.min(byteCount, buffer.length - offset);\n  chunk.set(buffer.subarray(offset, offset + firstSegmentLength), 0);\n  if (firstSegmentLength < byteCount) {\n    chunk.set(buffer.subarray(0, byteCount - firstSegmentLength), firstSegmentLength);\n  }\n  return chunk;\n}\n"],"mappings":"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"}

package/dist/src/wasi/WasmSceneRuntime.js

@@ -52,27 +52,33 @@ var WasmSceneRuntime = class extends WebHostSceneRuntime {
 		} catch (error) {
 			sharedQueueError = error;
 		}
+		const overflowReporter = {};
+		const enqueueInput = (writer, chunk) => {
+			writer.writeAsync(chunk).then((outcome) => {
+				if (inputCapacityNotifier.disposed || outcome.status === "written") return;
+				if (outcome.status === "closed") return;
+				overflowReporter.report?.(outcome.bytesWritten, outcome.bytesRemaining);
+			});
+			if (!inputCapacityNotifier.pending) {
+				inputCapacityNotifier.pending = true;
+				writer.waitForCapacity(1).then((available) => {
+					inputCapacityNotifier.pending = false;
+					if (available && !inputCapacityNotifier.disposed) options.bridge?.notifyInputCapacityAvailable();
+				});
+			}
+		};
 		const inputRouter = { route: (chunk) => {
 			if (!inputWriter) return false;
-			try {
-				inputWriter.write(chunk);
-				return true;
-			} catch (error) {
-				console.error("[SwiftTUIWeb] failed to enqueue terminal input", error);
-				if (!inputCapacityNotifier.pending) {
-					inputCapacityNotifier.pending = true;
-					inputWriter.waitForCapacity(chunk.byteLength).then((available) => {
-						inputCapacityNotifier.pending = false;
-						if (available && !inputCapacityNotifier.disposed) options.bridge?.notifyInputCapacityAvailable();
-					});
-				}
-				return false;
-			}
+			enqueueInput(inputWriter, chunk);
+			return true;
 		} };
 		super({
 			...options,
 			onInput: (chunk) => inputRouter.route(chunk)
 		});
+		overflowReporter.report = (bytesWritten, bytesRemaining) => {
+			this.notifyInputOverflow(bytesWritten, bytesRemaining);
+		};
 		this.bridge = options.bridge;
 		this.wasmURL = wasmURL;
 		this.onSceneResize = factoryOptions.onSceneResize;
@@ -85,6 +91,16 @@ var WasmSceneRuntime = class extends WebHostSceneRuntime {
 		this.sharedQueueError = sharedQueueError;
 		this.pauseCell = pauseCell;
 	}
+	notifyInputOverflow(bytesWritten, bytesRemaining) {
+		const message = bytesWritten === 0 ? `Dropped ${bytesRemaining} byte(s) of terminal input: the app did not read from its input queue within 500 ms.` : `Delivered ${bytesWritten} byte(s) of terminal input and dropped ${bytesRemaining}: the app did not drain its input queue within 500 ms.`;
+		this.notifyRuntimeIssue({
+			severity: "warning",
+			code: "web.input.queueDeadlineExceeded",
+			message,
+			description: `SwiftTUI runtime warning [web.input.queueDeadlineExceeded] ${message}`,
+			source: "web-host"
+		});
+	}
 	onRuntimeSuspensionChange(suspended) {
 		this.suspended = suspended;
 		if (this.pauseCell) setWasmPauseCellPaused(this.pauseCell, suspended);

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\";\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): boolean };\n  private readonly inputCapacityNotifier: {\n    disposed: boolean;\n    pending: boolean;\n  };\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    const inputCapacityNotifier = {\n      disposed: false,\n      pending: false,\n    };\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): boolean => {\n        if (!inputWriter) {\n          return false;\n        }\n        try {\n          inputWriter.write(chunk);\n          return true;\n        } catch (error) {\n          console.error(\"[SwiftTUIWeb] failed to enqueue terminal input\", error);\n          if (!inputCapacityNotifier.pending) {\n            inputCapacityNotifier.pending = true;\n            void inputWriter.waitForCapacity(chunk.byteLength).then((available) => {\n              inputCapacityNotifier.pending = false;\n              if (available && !inputCapacityNotifier.disposed) {\n                (options.bridge as BrowserWASIBridge | undefined)\n                  ?.notifyInputCapacityAvailable();\n              }\n            });\n          }\n          return false;\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.inputCapacityNotifier = inputCapacityNotifier;\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      return 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.SWIFTTUI_COLUMNS ?? \"0\") || 0;\n    const initialRows = Number(this.bridge?.environment.SWIFTTUI_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.inputCapacityNotifier.disposed = true;\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) => {\n      executor.sendInput(chunk);\n      return true;\n    };\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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"}
+{"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): boolean };\n  private readonly inputCapacityNotifier: {\n    disposed: boolean;\n    pending: boolean;\n  };\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    const inputCapacityNotifier = {\n      disposed: false,\n      pending: false,\n    };\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    // Input is streamed rather than all-or-nothing. A single ring write can\n    // only enqueue what currently fits, so a paste larger than the free space\n    // used to fail outright and drop the whole clipboard; `writeAsync` takes\n    // `min(free, remaining)` bytes at a time and awaits the reader in between,\n    // bounded by a 500 ms deadline. It never blocks — this is the main thread.\n    // Assigned right after `super()`: `this` is unavailable until then, and the\n    // reporter is only ever invoked from a settled promise afterwards.\n    const overflowReporter: {\n      report?: (bytesWritten: number, bytesRemaining: number) => void;\n    } = {};\n\n    const enqueueInput = (\n      writer: SharedInputQueueWriter,\n      chunk: Uint8Array\n    ): void => {\n      void writer.writeAsync(chunk).then((outcome) => {\n        if (inputCapacityNotifier.disposed || outcome.status === \"written\") {\n          return;\n        }\n        if (outcome.status === \"closed\") {\n          return;\n        }\n        // Only a write that ran out of budget is reportable, and it is\n        // reportable *into the app's mount*: silently losing the tail of a\n        // paste is exactly the failure this stage exists to remove, so it must\n        // not be console-only.\n        overflowReporter.report?.(outcome.bytesWritten, outcome.bytesRemaining);\n      });\n      if (!inputCapacityNotifier.pending) {\n        inputCapacityNotifier.pending = true;\n        void writer.waitForCapacity(1).then((available) => {\n          inputCapacityNotifier.pending = false;\n          if (available && !inputCapacityNotifier.disposed) {\n            (options.bridge as BrowserWASIBridge | undefined)\n              ?.notifyInputCapacityAvailable();\n          }\n        });\n      }\n    };\n\n    const inputRouter = {\n      route: (chunk: Uint8Array): boolean => {\n        if (!inputWriter) {\n          return false;\n        }\n        enqueueInput(inputWriter, chunk);\n        return true;\n      },\n    };\n\n    super({\n      ...options,\n      onInput: (chunk) => inputRouter.route(chunk),\n    });\n    overflowReporter.report = (bytesWritten, bytesRemaining) => {\n      this.notifyInputOverflow(bytesWritten, bytesRemaining);\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.inputCapacityNotifier = inputCapacityNotifier;\n    this.sharedQueueError = sharedQueueError;\n    this.pauseCell = pauseCell;\n  }\n\n  /// Reports a logical input write that ran out of its deadline.\n  ///\n  /// Surfaced as a runtime issue rather than a console message: the tail of a\n  /// paste going missing is a user-visible data loss, and the whole point of\n  /// the chunked writer is that it should not happen silently.\n  private notifyInputOverflow(\n    bytesWritten: number,\n    bytesRemaining: number\n  ): void {\n    const message = bytesWritten === 0\n      ? `Dropped ${bytesRemaining} byte(s) of terminal input: the app did not read from its input queue within 500 ms.`\n      : `Delivered ${bytesWritten} byte(s) of terminal input and dropped ${bytesRemaining}: the app did not drain its input queue within 500 ms.`;\n    this.notifyRuntimeIssue({\n      severity: \"warning\",\n      code: \"web.input.queueDeadlineExceeded\",\n      message,\n      description: `SwiftTUI runtime warning [web.input.queueDeadlineExceeded] ${message}`,\n      source: \"web-host\",\n    });\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      return 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.SWIFTTUI_COLUMNS ?? \"0\") || 0;\n    const initialRows = Number(this.bridge?.environment.SWIFTTUI_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.inputCapacityNotifier.disposed = true;\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) => {\n      executor.sendInput(chunk);\n      return true;\n    };\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/wasi.d.ts

@@ -2,8 +2,8 @@ import { encodeRenderStyleControlMessage, encodeResizeControlMessage } from "./s
 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";
-import { SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, createSharedInputQueue, hydrateSharedInputQueue, sharedInputQueueDefaultCapacity } from "./src/wasi/SharedInputQueue.js";
+import { SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, SharedInputWriteOptions, SharedInputWriteOutcome, 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, 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 };
+export { BrowserWASIBridge, BrowserWASIBridgeOptions, BrowserWASIOutputSink, JSPIConstructors, MainThreadWasmExecutor, MainThreadWasmExecutorOptions, MainThreadWasmPauseGate, PausableMonotonicClock, SharedInputQueueBuffers, SharedInputQueueReader, SharedInputQueueWriter, SharedInputReadiness, SharedInputWriteOptions, SharedInputWriteOutcome, 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/package.json

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