@swifttui/web 0.0.27 → 0.1.1

package/dist/src/InputEventEncoder.js

@@ -0,0 +1,117 @@
+import { encodeKeyInputMessage, encodeMouseInputMessage, encodePasteInputMessage } from "./WebHostSurfaceTransport.js";
+//#region src/InputEventEncoder.ts
+/**
+* Encodes DOM keyboard/pointer/wheel/paste events into the `web-surface` wire
+* messages the SwiftTUI host consumes. This collaborator owns the translation
+* from browser event vocabulary (key names, button indices, wheel deltas,
+* modifier flags) to the transport's message vocabulary; it produces raw byte
+* chunks and holds no DOM or geometry state.
+*
+* Hit-testing (pixel → cell) lives in the host, which passes already-resolved
+* {@link CellLocation}s here so the encoder stays free of layout concerns.
+*/
+var InputEventEncoder = class {
+	/**
+	* Builds the key message for a keyboard event, or `undefined` when the event
+	* does not map to a forwarded key (e.g. a multi-codepoint composed string).
+	* Returning `undefined` lets the host leave the event unhandled.
+	*/
+	encodeKey(event) {
+		const key = keyInputFromKeyboardEvent(event);
+		if (!key) return;
+		return encodeKeyInputMessage({
+			...key,
+			modifiers: modifierMask(event)
+		});
+	}
+	encodePaste(text) {
+		return encodePasteInputMessage(text);
+	}
+	encodePointerDown(location, button, event) {
+		return encodeMouseInputMessage({
+			kind: "down",
+			x: location.x,
+			y: location.y,
+			button,
+			modifiers: modifierMask(event)
+		});
+	}
+	encodePointerUp(location, button, event) {
+		return encodeMouseInputMessage({
+			kind: "up",
+			x: location.x,
+			y: location.y,
+			button,
+			modifiers: modifierMask(event)
+		});
+	}
+	encodePointerMove(location, button, event) {
+		return encodeMouseInputMessage({
+			kind: event.buttons ? "dragged" : "moved",
+			x: location.x,
+			y: location.y,
+			button,
+			modifiers: modifierMask(event)
+		});
+	}
+	encodeWheel(location, event) {
+		return encodeMouseInputMessage({
+			kind: "scrolled",
+			x: location.x,
+			y: location.y,
+			deltaX: normalizedWheelDelta(event.deltaX),
+			deltaY: normalizedWheelDelta(event.deltaY),
+			modifiers: modifierMask(event)
+		});
+	}
+	/** Translates a DOM `MouseEvent.button` index into the wire button identity. */
+	pointerButton(button) {
+		return pointerButton(button);
+	}
+};
+function keyInputFromKeyboardEvent(event) {
+	switch (event.key) {
+		case "Enter": return { key: "return" };
+		case " ": return { key: "space" };
+		case "Tab": return { key: "tab" };
+		case "ArrowLeft": return { key: "arrowLeft" };
+		case "ArrowRight": return { key: "arrowRight" };
+		case "ArrowUp": return { key: "arrowUp" };
+		case "ArrowDown": return { key: "arrowDown" };
+		case "Backspace": return { key: "backspace" };
+		case "Escape": return { key: "escape" };
+		case "Home": return { key: "home" };
+		case "End": return { key: "end" };
+		default: {
+			const characters = Array.from(event.key);
+			if (characters.length !== 1) return;
+			return {
+				key: "character",
+				character: characters[0]
+			};
+		}
+	}
+}
+function pointerButton(button) {
+	switch (button) {
+		case 1: return "middle";
+		case 2: return "secondary";
+		default: return "primary";
+	}
+}
+function modifierMask(event) {
+	let mask = 0;
+	if (event.shiftKey) mask |= 1;
+	if (event.altKey) mask |= 2;
+	if (event.ctrlKey) mask |= 4;
+	return mask;
+}
+function normalizedWheelDelta(delta) {
+	if (delta > 0) return 1;
+	if (delta < 0) return -1;
+	return 0;
+}
+//#endregion
+export { InputEventEncoder };
+
+//# sourceMappingURL=InputEventEncoder.js.map

package/dist/src/InputEventEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputEventEncoder.js","names":[],"sources":["../../src/InputEventEncoder.ts"],"sourcesContent":["import {\n  encodeKeyInputMessage,\n  encodeMouseInputMessage,\n  encodePasteInputMessage,\n  type WebHostKeyInput,\n} from \"./WebHostSurfaceTransport.ts\";\n\n/** A resolved cell-grid location (fractional cell coordinates). */\nexport interface CellLocation {\n  x: number;\n  y: number;\n}\n\n/**\n * Pointer button identity in the wire vocabulary. Mirrors the values the Swift\n * host expects on `mouse:` records.\n */\nexport type PointerButton = \"primary\" | \"middle\" | \"secondary\";\n\n/**\n * Encodes DOM keyboard/pointer/wheel/paste events into the `web-surface` wire\n * messages the SwiftTUI host consumes. This collaborator owns the translation\n * from browser event vocabulary (key names, button indices, wheel deltas,\n * modifier flags) to the transport's message vocabulary; it produces raw byte\n * chunks and holds no DOM or geometry state.\n *\n * Hit-testing (pixel → cell) lives in the host, which passes already-resolved\n * {@link CellLocation}s here so the encoder stays free of layout concerns.\n */\nexport class InputEventEncoder {\n  /**\n   * Builds the key message for a keyboard event, or `undefined` when the event\n   * does not map to a forwarded key (e.g. a multi-codepoint composed string).\n   * Returning `undefined` lets the host leave the event unhandled.\n   */\n  encodeKey(\n    event: KeyboardEvent\n  ): Uint8Array | undefined {\n    const key = keyInputFromKeyboardEvent(event);\n    if (!key) {\n      return undefined;\n    }\n    return encodeKeyInputMessage({\n      ...key,\n      modifiers: modifierMask(event),\n    });\n  }\n\n  encodePaste(\n    text: string\n  ): Uint8Array {\n    return encodePasteInputMessage(text);\n  }\n\n  encodePointerDown(\n    location: CellLocation,\n    button: PointerButton,\n    event: PointerEvent\n  ): Uint8Array {\n    return encodeMouseInputMessage({\n      kind: \"down\",\n      x: location.x,\n      y: location.y,\n      button,\n      modifiers: modifierMask(event),\n    });\n  }\n\n  encodePointerUp(\n    location: CellLocation,\n    button: PointerButton,\n    event: PointerEvent\n  ): Uint8Array {\n    return encodeMouseInputMessage({\n      kind: \"up\",\n      x: location.x,\n      y: location.y,\n      button,\n      modifiers: modifierMask(event),\n    });\n  }\n\n  encodePointerMove(\n    location: CellLocation,\n    button: PointerButton,\n    event: PointerEvent\n  ): Uint8Array {\n    return encodeMouseInputMessage({\n      kind: event.buttons ? \"dragged\" : \"moved\",\n      x: location.x,\n      y: location.y,\n      button,\n      modifiers: modifierMask(event),\n    });\n  }\n\n  encodeWheel(\n    location: CellLocation,\n    event: WheelEvent\n  ): Uint8Array {\n    return encodeMouseInputMessage({\n      kind: \"scrolled\",\n      x: location.x,\n      y: location.y,\n      deltaX: normalizedWheelDelta(event.deltaX),\n      deltaY: normalizedWheelDelta(event.deltaY),\n      modifiers: modifierMask(event),\n    });\n  }\n\n  /** Translates a DOM `MouseEvent.button` index into the wire button identity. */\n  pointerButton(\n    button: number\n  ): PointerButton {\n    return pointerButton(button);\n  }\n}\n\nfunction keyInputFromKeyboardEvent(\n  event: KeyboardEvent\n): Pick<WebHostKeyInput, \"key\" | \"character\"> | undefined {\n  switch (event.key) {\n  case \"Enter\":\n    return { key: \"return\" };\n  case \" \":\n    return { key: \"space\" };\n  case \"Tab\":\n    return { key: \"tab\" };\n  case \"ArrowLeft\":\n    return { key: \"arrowLeft\" };\n  case \"ArrowRight\":\n    return { key: \"arrowRight\" };\n  case \"ArrowUp\":\n    return { key: \"arrowUp\" };\n  case \"ArrowDown\":\n    return { key: \"arrowDown\" };\n  case \"Backspace\":\n    return { key: \"backspace\" };\n  case \"Escape\":\n    return { key: \"escape\" };\n  case \"Home\":\n    return { key: \"home\" };\n  case \"End\":\n    return { key: \"end\" };\n  default:\n    {\n      const characters = Array.from(event.key);\n      if (characters.length !== 1) {\n        return undefined;\n      }\n      return {\n        key: \"character\",\n        character: characters[0],\n      };\n    }\n  }\n}\n\nfunction pointerButton(\n  button: number\n): PointerButton {\n  switch (button) {\n  case 1:\n    return \"middle\";\n  case 2:\n    return \"secondary\";\n  default:\n    return \"primary\";\n  }\n}\n\nfunction modifierMask(\n  event: MouseEvent | KeyboardEvent\n): number {\n  let mask = 0;\n  if (event.shiftKey) {\n    mask |= 1;\n  }\n  if (event.altKey) {\n    mask |= 2;\n  }\n  if (event.ctrlKey) {\n    mask |= 4;\n  }\n  return mask;\n}\n\nfunction normalizedWheelDelta(\n  delta: number\n): number {\n  if (delta > 0) {\n    return 1;\n  }\n  if (delta < 0) {\n    return -1;\n  }\n  return 0;\n}\n"],"mappings":";;;;;;;;;;;;AA6BA,IAAa,oBAAb,MAA+B;;;;;;CAM7B,UACE,OACwB;EACxB,MAAM,MAAM,0BAA0B,KAAK;EAC3C,IAAI,CAAC,KACH;EAEF,OAAO,sBAAsB;GAC3B,GAAG;GACH,WAAW,aAAa,KAAK;EAC/B,CAAC;CACH;CAEA,YACE,MACY;EACZ,OAAO,wBAAwB,IAAI;CACrC;CAEA,kBACE,UACA,QACA,OACY;EACZ,OAAO,wBAAwB;GAC7B,MAAM;GACN,GAAG,SAAS;GACZ,GAAG,SAAS;GACZ;GACA,WAAW,aAAa,KAAK;EAC/B,CAAC;CACH;CAEA,gBACE,UACA,QACA,OACY;EACZ,OAAO,wBAAwB;GAC7B,MAAM;GACN,GAAG,SAAS;GACZ,GAAG,SAAS;GACZ;GACA,WAAW,aAAa,KAAK;EAC/B,CAAC;CACH;CAEA,kBACE,UACA,QACA,OACY;EACZ,OAAO,wBAAwB;GAC7B,MAAM,MAAM,UAAU,YAAY;GAClC,GAAG,SAAS;GACZ,GAAG,SAAS;GACZ;GACA,WAAW,aAAa,KAAK;EAC/B,CAAC;CACH;CAEA,YACE,UACA,OACY;EACZ,OAAO,wBAAwB;GAC7B,MAAM;GACN,GAAG,SAAS;GACZ,GAAG,SAAS;GACZ,QAAQ,qBAAqB,MAAM,MAAM;GACzC,QAAQ,qBAAqB,MAAM,MAAM;GACzC,WAAW,aAAa,KAAK;EAC/B,CAAC;CACH;;CAGA,cACE,QACe;EACf,OAAO,cAAc,MAAM;CAC7B;AACF;AAEA,SAAS,0BACP,OACwD;CACxD,QAAQ,MAAM,KAAd;EACA,KAAK,SACH,OAAO,EAAE,KAAK,SAAS;EACzB,KAAK,KACH,OAAO,EAAE,KAAK,QAAQ;EACxB,KAAK,OACH,OAAO,EAAE,KAAK,MAAM;EACtB,KAAK,aACH,OAAO,EAAE,KAAK,YAAY;EAC5B,KAAK,cACH,OAAO,EAAE,KAAK,aAAa;EAC7B,KAAK,WACH,OAAO,EAAE,KAAK,UAAU;EAC1B,KAAK,aACH,OAAO,EAAE,KAAK,YAAY;EAC5B,KAAK,aACH,OAAO,EAAE,KAAK,YAAY;EAC5B,KAAK,UACH,OAAO,EAAE,KAAK,SAAS;EACzB,KAAK,QACH,OAAO,EAAE,KAAK,OAAO;EACvB,KAAK,OACH,OAAO,EAAE,KAAK,MAAM;EACtB,SACE;GACE,MAAM,aAAa,MAAM,KAAK,MAAM,GAAG;GACvC,IAAI,WAAW,WAAW,GACxB;GAEF,OAAO;IACL,KAAK;IACL,WAAW,WAAW;GACxB;EACF;CACF;AACF;AAEA,SAAS,cACP,QACe;CACf,QAAQ,QAAR;EACA,KAAK,GACH,OAAO;EACT,KAAK,GACH,OAAO;EACT,SACE,OAAO;CACT;AACF;AAEA,SAAS,aACP,OACQ;CACR,IAAI,OAAO;CACX,IAAI,MAAM,UACR,QAAQ;CAEV,IAAI,MAAM,QACR,QAAQ;CAEV,IAAI,MAAM,SACR,QAAQ;CAEV,OAAO;AACT;AAEA,SAAS,qBACP,OACQ;CACR,IAAI,QAAQ,GACV,OAAO;CAET,IAAI,QAAQ,GACV,OAAO;CAET,OAAO;AACT"}

package/dist/src/PointerGeometry.js

@@ -0,0 +1,72 @@
+//#region src/PointerGeometry.ts
+/**
+* Converts a pointer event to fractional cell coordinates, clamped to the
+* grid. Returns `undefined` when the pointer is outside the cell grid (in the
+* sub-cell margin/gutter), so the host can leave the event unhandled.
+*/
+function cellLocationForEvent(event, metrics) {
+	const location = rawCellLocationForEvent(event, metrics);
+	if (!location) return;
+	const cellX = Math.floor(location.x);
+	const cellY = Math.floor(location.y);
+	if (cellX < 0 || cellY < 0 || cellX >= metrics.columns || cellY >= metrics.rows) return;
+	return location;
+}
+/**
+* Converts a pointer event to fractional cell coordinates *without* clamping to
+* the grid. Used while a pointer is captured (drag) so the host keeps tracking
+* the gesture even when it strays outside the surface bounds.
+*/
+function rawCellLocationForEvent(event, metrics) {
+	const rect = metrics.rect;
+	if (!rect) return;
+	return {
+		x: (event.clientX - rect.left) / metrics.cellWidth,
+		y: (event.clientY - rect.top) / metrics.cellHeight
+	};
+}
+/**
+* Whether any scrollable region under `location` can still scroll in the
+* wheel's direction. Mirrors the Swift host's scroll hit-test: a region
+* qualifies when its viewport contains the cell AND it has remaining headroom
+* in the delta's direction. Used by "chain" wheel mode to decide capture vs.
+* fall-through. With no published `scrollRegions`, nothing can scroll, so the
+* wheel chains to the page (a scene with no ScrollView stays fully passive).
+*/
+function wheelTargetCanScroll(regions, location, deltaX, deltaY) {
+	if (!regions || regions.length === 0) return false;
+	const cellX = Math.floor(location.x);
+	const cellY = Math.floor(location.y);
+	for (const region of regions) {
+		const [rx, ry, rw, rh] = region.rect;
+		if (cellX < rx || cellY < ry || cellX >= rx + rw || cellY >= ry + rh) continue;
+		if (regionCanScrollInDirection(region, deltaX, deltaY)) return true;
+	}
+	return false;
+}
+/**
+* Whether a published scroll region has remaining headroom in the wheel's
+* direction, recomputing the per-direction extent from offset/content/viewport.
+* Mirrors SwiftTUI's clamp (`min(max(0, offset), max(0, content - viewport))`)
+* so the host and the app agree on "at edge". Wheel sign convention matches the
+* app: `deltaY > 0` scrolls down (offset grows toward the content bottom).
+* Diagonal wheels qualify if either axis has headroom.
+*/
+function regionCanScrollInDirection(region, deltaX, deltaY) {
+	const [, , viewportWidth, viewportHeight] = region.rect;
+	const [offsetX, offsetY] = region.offset;
+	const [contentWidth, contentHeight] = region.content;
+	const maxX = Math.max(0, contentWidth - viewportWidth);
+	const maxY = Math.max(0, contentHeight - viewportHeight);
+	const clampedX = Math.min(Math.max(0, offsetX), maxX);
+	const clampedY = Math.min(Math.max(0, offsetY), maxY);
+	if (deltaY > 0 && clampedY < maxY) return true;
+	if (deltaY < 0 && clampedY > 0) return true;
+	if (deltaX > 0 && clampedX < maxX) return true;
+	if (deltaX < 0 && clampedX > 0) return true;
+	return false;
+}
+//#endregion
+export { cellLocationForEvent, rawCellLocationForEvent, wheelTargetCanScroll };
+
+//# sourceMappingURL=PointerGeometry.js.map

package/dist/src/PointerGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointerGeometry.js","names":[],"sources":["../../src/PointerGeometry.ts"],"sourcesContent":["import type {\n  WebHostScrollRegion,\n} from \"./WebHostSurfaceTransport.ts\";\nimport type { CellLocation } from \"./InputEventEncoder.ts\";\n\n/**\n * The cell-grid geometry a pointer hit-test needs: the surface's bounding\n * client rect (the canvas's, falling back to the terminal mount's), the cell\n * dimensions, and the grid extent in cells. The host snapshots this per event.\n */\nexport interface PointerGeometryMetrics {\n  rect?: { left: number; top: number } | null;\n  cellWidth: number;\n  cellHeight: number;\n  columns: number;\n  rows: number;\n}\n\n/**\n * Converts a pointer event to fractional cell coordinates, clamped to the\n * grid. Returns `undefined` when the pointer is outside the cell grid (in the\n * sub-cell margin/gutter), so the host can leave the event unhandled.\n */\nexport function cellLocationForEvent(\n  event: MouseEvent,\n  metrics: PointerGeometryMetrics\n): CellLocation | undefined {\n  const location = rawCellLocationForEvent(event, metrics);\n  if (!location) {\n    return undefined;\n  }\n\n  const cellX = Math.floor(location.x);\n  const cellY = Math.floor(location.y);\n  if (cellX < 0 || cellY < 0 || cellX >= metrics.columns || cellY >= metrics.rows) {\n    return undefined;\n  }\n  return location;\n}\n\n/**\n * Converts a pointer event to fractional cell coordinates *without* clamping to\n * the grid. Used while a pointer is captured (drag) so the host keeps tracking\n * the gesture even when it strays outside the surface bounds.\n */\nexport function rawCellLocationForEvent(\n  event: MouseEvent,\n  metrics: PointerGeometryMetrics\n): CellLocation | undefined {\n  const rect = metrics.rect;\n  if (!rect) {\n    return undefined;\n  }\n\n  const x = (event.clientX - rect.left) / metrics.cellWidth;\n  const y = (event.clientY - rect.top) / metrics.cellHeight;\n  return { x, y };\n}\n\n/**\n * Whether any scrollable region under `location` can still scroll in the\n * wheel's direction. Mirrors the Swift host's scroll hit-test: a region\n * qualifies when its viewport contains the cell AND it has remaining headroom\n * in the delta's direction. Used by \"chain\" wheel mode to decide capture vs.\n * fall-through. With no published `scrollRegions`, nothing can scroll, so the\n * wheel chains to the page (a scene with no ScrollView stays fully passive).\n */\nexport function wheelTargetCanScroll(\n  regions: readonly WebHostScrollRegion[] | undefined,\n  location: CellLocation,\n  deltaX: number,\n  deltaY: number\n): boolean {\n  if (!regions || regions.length === 0) {\n    return false;\n  }\n\n  const cellX = Math.floor(location.x);\n  const cellY = Math.floor(location.y);\n  // Any region under the pointer that can move in this direction qualifies —\n  // this is what lets an outer ScrollView take over when an inner one is at\n  // its edge (nested scroll), and chains to the page only when none can.\n  for (const region of regions) {\n    const [rx, ry, rw, rh] = region.rect;\n    if (cellX < rx || cellY < ry || cellX >= rx + rw || cellY >= ry + rh) {\n      continue;\n    }\n    if (regionCanScrollInDirection(region, deltaX, deltaY)) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Whether a published scroll region has remaining headroom in the wheel's\n * direction, recomputing the per-direction extent from offset/content/viewport.\n * Mirrors SwiftTUI's clamp (`min(max(0, offset), max(0, content - viewport))`)\n * so the host and the app agree on \"at edge\". Wheel sign convention matches the\n * app: `deltaY > 0` scrolls down (offset grows toward the content bottom).\n * Diagonal wheels qualify if either axis has headroom.\n */\nfunction regionCanScrollInDirection(\n  region: WebHostScrollRegion,\n  deltaX: number,\n  deltaY: number\n): boolean {\n  const [, , viewportWidth, viewportHeight] = region.rect;\n  const [offsetX, offsetY] = region.offset;\n  const [contentWidth, contentHeight] = region.content;\n  const maxX = Math.max(0, contentWidth - viewportWidth);\n  const maxY = Math.max(0, contentHeight - viewportHeight);\n  const clampedX = Math.min(Math.max(0, offsetX), maxX);\n  const clampedY = Math.min(Math.max(0, offsetY), maxY);\n\n  if (deltaY > 0 && clampedY < maxY) {\n    return true;\n  }\n  if (deltaY < 0 && clampedY > 0) {\n    return true;\n  }\n  if (deltaX > 0 && clampedX < maxX) {\n    return true;\n  }\n  if (deltaX < 0 && clampedX > 0) {\n    return true;\n  }\n  return false;\n}\n"],"mappings":";;;;;;AAuBA,SAAgB,qBACd,OACA,SAC0B;CAC1B,MAAM,WAAW,wBAAwB,OAAO,OAAO;CACvD,IAAI,CAAC,UACH;CAGF,MAAM,QAAQ,KAAK,MAAM,SAAS,CAAC;CACnC,MAAM,QAAQ,KAAK,MAAM,SAAS,CAAC;CACnC,IAAI,QAAQ,KAAK,QAAQ,KAAK,SAAS,QAAQ,WAAW,SAAS,QAAQ,MACzE;CAEF,OAAO;AACT;;;;;;AAOA,SAAgB,wBACd,OACA,SAC0B;CAC1B,MAAM,OAAO,QAAQ;CACrB,IAAI,CAAC,MACH;CAKF,OAAO;EAAE,IAFE,MAAM,UAAU,KAAK,QAAQ,QAAQ;EAEpC,IADD,MAAM,UAAU,KAAK,OAAO,QAAQ;CACjC;AAChB;;;;;;;;;AAUA,SAAgB,qBACd,SACA,UACA,QACA,QACS;CACT,IAAI,CAAC,WAAW,QAAQ,WAAW,GACjC,OAAO;CAGT,MAAM,QAAQ,KAAK,MAAM,SAAS,CAAC;CACnC,MAAM,QAAQ,KAAK,MAAM,SAAS,CAAC;CAInC,KAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,CAAC,IAAI,IAAI,IAAI,MAAM,OAAO;EAChC,IAAI,QAAQ,MAAM,QAAQ,MAAM,SAAS,KAAK,MAAM,SAAS,KAAK,IAChE;EAEF,IAAI,2BAA2B,QAAQ,QAAQ,MAAM,GACnD,OAAO;CAEX;CACA,OAAO;AACT;;;;;;;;;AAUA,SAAS,2BACP,QACA,QACA,QACS;CACT,MAAM,KAAK,eAAe,kBAAkB,OAAO;CACnD,MAAM,CAAC,SAAS,WAAW,OAAO;CAClC,MAAM,CAAC,cAAc,iBAAiB,OAAO;CAC7C,MAAM,OAAO,KAAK,IAAI,GAAG,eAAe,aAAa;CACrD,MAAM,OAAO,KAAK,IAAI,GAAG,gBAAgB,cAAc;CACvD,MAAM,WAAW,KAAK,IAAI,KAAK,IAAI,GAAG,OAAO,GAAG,IAAI;CACpD,MAAM,WAAW,KAAK,IAAI,KAAK,IAAI,GAAG,OAAO,GAAG,IAAI;CAEpD,IAAI,SAAS,KAAK,WAAW,MAC3B,OAAO;CAET,IAAI,SAAS,KAAK,WAAW,GAC3B,OAAO;CAET,IAAI,SAAS,KAAK,WAAW,MAC3B,OAAO;CAET,IAAI,SAAS,KAAK,WAAW,GAC3B,OAAO;CAET,OAAO;AACT"}

package/dist/src/WebHostSceneRuntime.d.ts

@@ -41,6 +41,13 @@ interface WebHostSceneRuntimeOptions {
   captureWheelInput?: boolean;
 }
 type WheelMode = "capture" | "chain" | "passive";
+/**
+ * Coordinates a single SwiftTUI scene's browser presentation: it owns the DOM
+ * mount, canvas, accessibility tree, and bridge wiring, and delegates the heavy
+ * responsibilities to focused collaborators — {@link CanvasSurfacePainter} for
+ * canvas drawing, {@link InputEventEncoder} for wire-message encoding, and the
+ * {@link PointerGeometry} helpers for pixel→cell hit-testing and wheel chaining.
+ */
 declare class WebHostSceneRuntime {
   readonly descriptor: WebHostSceneDescriptor;
   readonly element: HTMLElement;
@@ -50,7 +57,8 @@ declare class WebHostSceneRuntime {
   private readonly onFrameDiagnostic?;
   private readonly synchronizeAccessibilityFocus;
   private readonly wheelMode;
-  private readonly imageCache;
+  private readonly painter;
+  private readonly inputEncoder;
   private currentStyle;
   private canvas?;
   private accessibilityTree?;
@@ -87,26 +95,9 @@ declare class WebHostSceneRuntime {
   private resizeCanvas;
   private measureCells;
   private draw;
-  private drawRows;
-  private drawRow;
   private syncAccessibilityTree;
-  private drawImages;
-  private drawImage;
-  private cachedImage;
-  private drawCell;
-  private dirtyRegionForDamage;
-  private cellRect;
-  private drawTextLine;
-  private fontForStyle;
-  /**
-   * Whether any scrollable region under `location` can still scroll in the
-   * wheel's direction. Mirrors the Swift host's scroll hit-test: a region
-   * qualifies when its viewport contains the cell AND it has remaining headroom
-   * in the delta's direction. Used by "chain" wheel mode to decide capture vs.
-   * fall-through. With no published `scrollRegions`, nothing can scroll, so the
-   * wheel chains to the page (a scene with no ScrollView stays fully passive).
-   */
-  private wheelTargetCanScroll;
+  private surfaceMetrics;
+  private pointerMetrics;
   private cellLocation;
   private rawCellLocation;
 }